blarx/dodois-api

Laravel 9 Dodois SDK

1.1.1 2023-04-13 13:11 UTC

Requires

• php: ^8.0
• illuminate/support: ^8.0|^9.0|^10.0

MIT

• Alexandr

README

In EventServiceProvider:

use Dodois\Events\Connected;
use Dodois\Events\CallbackRedirected;
...
protected $listen = [
    Connected::class => [
        YourTokenListener::class,
    ],
    CallbackRedirected::class => [
        YourRedirectListener::class,
    ],
];

YourTokenListener.php Example:

use App\Models\DodoisAccount;
use Dodois\Events\Connected;

class YourTokenListener
{
    public function handle(Connected $event)
    {
        $idToken = $this->parseJwt($event->response['id_token']);

        DodoisAccount::updateOrCreate([
            'sub' => $idToken['sub'],
        ], [
            'user_id' => optional(auth()->user())->id,
            'access_token' => $event->response['access_token'],
            'refresh_token' => $event->response['refresh_token'],
            'expires_in' => $event->response['expires_in'],
            'scope' => $event->response['scope'],
            'properties' => [
                ...$event->response,
                'id_token' => $idToken,
            ],
        ]);
    }

    protected function parseJwt(string $token)
    {
        return json_decode(base64_decode(
            str_replace('_', '/', str_replace('-', '+', explode('.', $token)[1]))
        ), true);
    }
}

YourRedirectListener.php Example:

use Dodois\Events\CallbackRedirected;

class YourTokenListener
{
    public function handle(CallbackRedirected $event)
    {
        $event->response->with([
            'message' => $event->errorMessage ?: __('Account was added'),
        ]);
    }
}

How it use? In Controller:

use Dodois\Contracts\ClientContract;
use Dodois\Contracts\PublicApiContract;

...

class PageController {
    public function page(ClientContract $dodois, ...) {
        
        ...
        // Query to auth/ resource
        $units = $dodois->withToken('access_token')
            ->auth()->units()->list();
        
        $roles = $dodois->withToken('access_token')
            ->auth()->roles()->list();
        
        // Prefix config
        $products = $dodois->withToken('access_token')
            ->accounting('dodopizza', 'ru') // Default
            ->products()
            ->where('isProducible', true)
            ->list();
        
        // Where Variant One
        $sales = $dodois->withToken('access_token')
            ->accounting()->sales()
            ->whereBetween(
                now()->subDay(), // From
                now(), // To
            )
            ->where('units', $units->pluck('id'))
            ->where('salesChannel', 'Delivery')
            ->list();
        
        // Where Variant Two
        $products = $dodois->withToken('access_token')
            ->accounting()->semiFinishedProductsProduction()
            ->list([
                'from' => now()->subDay(),
                'to' => now(),
                'units' => $units->pluck('id'),
            ]);
    }
    
    public function other(PublicApiContract $dodois, ...)
    {
        $units = $dodois->units();
        $unitsKz = $dodois->units('kz');
    }
}

Installation

You can install the package via composer:

composer require blarx/dodois-sdk

The package will automatically register itself.

You can publish the config with:

php artisan vendor:publish --provider="Dodois\DodoisServiceProvider"

Add in you .env file:

DODOIS_CLIENTID=
DODOIS_SECRET=
DODOIS_REDIRECTURL=http://localhost/dodois/callback