API client replacement

[mmenozzi]

This PR will replace the API client using the official Akeneo PIM PHP SDK. This PR contains BC breaks!

[mmenozzi]

This PR makes #10 outdated and probably not needed.

[aleho]

I'd very much like to see something like that!

I've come up with the only solution of extending the API client with additional filters to getIdentifiersModifiedSince, so I can handle completeness.

$products = $this->apiClient->findProductsModifiedSince($sinceDate, [
    'enabled' => [
        ['operator' => '=', 'value' => true],
    ],
    'completeness' => [
        ['operator' => '>=', 'value' => 100, 'scope' => 'e4o'],
    ],
]);

The API client for this proof of concept was changed like this:

public function findProductsModifiedSince(\DateTime $date, array $filters = []): array
{
    $search = [
        'updated' => [
            ['operator' => '>', 'value' => $date->format('Y-m-d H:i:s')]
        ],
    ] + $filters;

    $endpoint = sprintf(
        '/api/rest/v1/products?search=%s&limit=20&page=1',
        json_encode($search)
    );

    return $this->traversePagination($this->authenticatedRequest($endpoint, 'GET', []));
}

I think this PR wouldn't change much, except for changing the signature to public function getIdentifiersModifiedSince(\DateTime $sinceDate, callable $queryExtension): array and passing the $searchBuilder to $queryExtension, if it exists.

For my use case that would be enough as a first step and I wouldn't even need to decorate the API client, as decorating the Importer and passing the extender callback would be enough.

What do you think?

Edit: Oh, and btw, can I help you with anything?

[mmenozzi]

Hi @aleho,
decorating/replacing the API client is the only way for now. Changing public method signature with a new, required, argument is a BC break so we cannot release in 1.x.
Anyway if you look at a way to customize the way items are enqueued the right issue to work on is #5.
This PR regards the entire API client replacement which is a great improvement but will also introduce BC breaks so we cannot release in 1.x as well.

If you want to help with anything you can start by looking at the list of "help wanted" issues. Those with the "RFC" label require further discussion.

[aleho]

Yes, of course, I saw this PR as a BC break anyways.

I just wanted to let you know that a query extension point for the importer (for the time being) would be a nice addition to this PR.

[lruozzi9]

Replaced by #125