astroway/sdk-laravel

Laravel ServiceProvider + facade for astroway/sdk — astroway() helper, config publishing, env-driven setup.

v0.1.0-alpha.1 2026-05-10 22:51 UTC

Requires

• php: ^8.1
• astroway/sdk: >=0.1.0-alpha.0
• illuminate/contracts: ^10.0 || ^11.0 || ^12.0
• illuminate/support: ^10.0 || ^11.0 || ^12.0

Requires (Dev)

• guzzlehttp/guzzle: ^7.8
• nyholm/psr7: ^1.8
• orchestra/testbench: ^8.0 || ^9.0 || ^10.0
• phpstan/phpstan: ^1.11
• phpunit/phpunit: ^10.5

MIT

• AstroWay

• api
• sdk
• laravel
• facade
• astrology
• astroway

README

Official Laravel ServiceProvider + facade for astroway/sdk — auto-discovered, env-driven, container singleton.

Install

composer require astroway/sdk-laravel
php artisan vendor:publish --tag=astroway-config

ServiceProvider + facade auto-register via composer.json's extra.laravel.providers — no edit to config/app.php needed.

Configure

.env:

ASTROWAY_API_KEY=aw_live_…
ASTROWAY_BASE_URL=https://api.astroway.info/v1   # optional
ASTROWAY_TIMEOUT=30                                # optional, seconds
ASTROWAY_AUTH_SCHEME=header                        # optional, header|bearer

config/astroway.php (published from the package) pulls these from env().

Use

Via dependency injection

use Astroway\Astroway;

class ChartController extends Controller
{
    public function __construct(private readonly Astroway $astroway) {}

    public function store(Request $request)
    {
        return response()->json(
            $this->astroway->chart()->compute($request->all()),
        );
    }
}

Via facade

use Astroway\Laravel\Facades\Astroway;

return Astroway::chart()->compute(['date' => '1990-01-15', ...]);

Via container alias

$aw = app('astroway');
$chart = $aw->chart()->compute([...]);

Roadmap

• 0.1.0-alpha.x — ServiceProvider + facade + config publish (current).
• 0.1.0-beta.1 — Telescope integration (every Astroway call visible in Telescope HTTP tab).
• 0.1.0-rc.1 — Artisan commands (php artisan astroway:health, astroway:credits).
• 0.1.0 — stable surface freeze.

Links

• 📦 Packagist: https://packagist.org/packages/astroway/sdk-laravel
• 📦 Core SDK: astroway/sdk
• 📘 API docs: https://api.astroway.info/docs/

License

MIT — see LICENSE.