README

OAuth and third-party integrations package for Laravel applications. Easily manage and store API credentials, tokens, and integration settings for various third-party services.

Overview

Eloquent Integrations provides a robust framework for handling OAuth and API integrations in your Laravel applications. It simplifies the process of connecting to external services, securely storing credentials, and scoping integrations to specific entities like users or workspaces.

Key Features

• OAuth Support: Seamlessly integrates with Laravel Socialite for managing OAuth flows.
• Credential Storage: Securely store and manage API keys, access tokens, and refresh tokens.
• Workspace Scoping: Built-in support for scoping integrations to specific workspaces using whilesmart/eloquent-workspaces.
• Reusable Credentials: Leverage whilesmart/eloquent-client-credentials for local credential and secret storage.

Installation

You can install the package via composer:

composer require whilesmart/eloquent-integrations

You can optionally publish the configuration file to customize the default behavior:

php artisan vendor:publish --provider="Whilesmart\Integrations\IntegrationsServiceProvider"

Suggested Dependencies

To unlock additional features, you may want to install the suggested packages:

• whilesmart/eloquent-client-credentials: For reusable local credential and secret storage.
• whilesmart/eloquent-workspaces: For workspace-scoped integrations.
• laravel/socialite: For OAuth provider support.

Testing

You can run the included test suite to verify the package functions correctly in your environment:

composer test

For style and static analysis, you can use:

composer lint
composer phpstan

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.