Download the PHP package yarunoka/laravel without Composer

yarunoka/laravel

Laravel integration for the Yarunoka schedule definition DSL.

What is this?

Yarunoka is a small JSON DSL — Yrnk — that states calendar rules like "payday is the 25th, moved up to the previous business day" as data, plus a pure engine that answers questions about them. The DSL and the engine live in yarunoka/core; the language-independent specification lives in the spec repository.

This package binds that engine into Laravel:

• A service provider builds the evaluation environment (timezone, calendar, resolvers) from config/yarunoka.php and binds YrnkEvaluator / YrnkParser into the container — scoped per request, and yielding to any binding the application makes itself.
• Eloquent casts store schedules in JSON columns with validation on both paths: a schedule column comes back as a Schedule wrapper with the firing decision (isDue), a schedules-part column as Schedules (a list of Schedule composed with any), and a whole-document column as a bare Yrnk.
• Validation rules (ValidYrnk, ValidYrnkSchedule, ValidYrnkSchedules) reject a bad request with the engine's own message on the validation error.
• Container-made resolvers: a name in the config maps to a class the Laravel container instantiates on first use, so constructor injection works; binding one of the core's layer interfaces wins over the config.

Installation

Requires PHP 8.4 or newer and Laravel 13. The service provider is registered by package auto-discovery. To publish the config:

Quick example

Name the wall-clock timezone and the calendar once, in the config:

The bindings are scoped — resolved once per request or queue job — and the config is read at first use within a scope. Where one scope lives long (tinker, a test), a config change made after that first use waits for the next scope; app()->forgetScopedInstances() renews within the current one, though it resets every scoped service, not only Yarunoka's.

Cast a JSON column to one schedule by naming the wrapper in casts() (Schedules::class casts a column of many the same way):

A column can also hold a whole Yrnk document — its own timezone and calendar per row. Yrnk is the core's class, so there is no wrapper to name: a whole-document column names the cast class itself, in the model's casts():

Validate a request and store the schedule as it was spelled — an invalid schedule never reaches the database:

Ask the firing question from a poller — was there a scheduled point since the last run?

Documentation

• yarunoka/core — the DSL and the engine this package wraps, with guides on reading, writing, and evaluating documents
• The spec repository — the DSL specification

License

MIT