Sunrise Sunset

Description

Sunrise Sunset integrates the sunrisesunset.io service into Laravel Enso.

The package wraps the external API behind an Enso Action, logs outbound calls through laravel-enso/api, exposes a protected application route, and stores the Enso structure required for access control.

It is intended for applications that need sunrise and sunset times for a configured location without implementing the remote call flow manually.

Installation

Install the package:

composer require laravel-enso/sunrise-sunset

Run the package migration:

php artisan migrate

Optional publish:

php artisan vendor:publish --tag=sunrise-sunset-config

Configure the target coordinates:

// config/enso/sunriseSunset.php
return [
    'latitude' => env('SUNRISE_SUNSET_LATITUDE'),
    'longitude' => env('SUNRISE_SUNSET_LONGITUDE'),
];

Features

wraps the sunrisesunset.io JSON endpoint through laravel-enso/api
exposes an Enso route for authenticated callers
logs outbound requests and responses through the API package
registers a package permission for route-level access control
keeps latitude and longitude configurable through Enso config

Usage

The package exposes an internal action that can be called directly:

use Carbon\Carbon;
use LaravelEnso\SunriseSunset\Actions\Get;

$response = (new Get(
    Carbon::parse('2026-05-01'),
    Carbon::parse('2026-05-07'),
))->handle();

$payload = $response->json();