ZaberDev Laravel Ecosystem (Productivity Toolkit)

Welcome to the ZaberDev Laravel Ecosystem (also known as the Laravel Productivity Toolkit).

We build high-level, expressive application primitives designed to solve complex concurrency, state management, usage budgeting, and mutual exclusion challenges across enterprise Laravel architectures. Rather than low-level infrastructure calls (Cache::lock(), RateLimiter::attempt(), manual cache flags), every package elevates these patterns into first-class, entity-scoped Eloquent abstractions with owner tracking, middleware, immutable DTOs, and persistent database cleanup.

---

The Suite at a Glance

Package	Purpose	Key Differentiators
Laravel Cooldown	Time-based action cooldowns	Polymorphic target cooldowns ($user->cooldown('smite')), cache/database drivers, strict CooldownInfo DTOs, route middleware.

Explore the full directory with detailed use cases and installation notes in PACKAGES.md.

---

Architectural Philosophy

Every package across the toolkit adheres to five core design principles:

1. First-Class Eloquent Integration: Attach lightweight traits (HasCooldowns) directly to your models to manage state cleanly ($user->lock('billing_charge')->acquire()).
2. Interchangeable Storage Backends: Seamlessly swap between fast in-memory cache stores (Redis, Memcached, Array) for high-throughput API endpoints and persistent database storage (SELECT ... FOR UPDATE or transactional tables) for durable business records without changing a single line of business logic.
3. Automatic Owner & Token Verification: Never worry about background worker collisions or race conditions where one process accidentally releases another process's state token.
4. Declarative Route Middleware: Protect routes effortlessly (cooldown:api_export,60) with automatic HTTP 429 Too Many Requests enforcement and safe finally block releases.
5. Zero Dependency Bloat: Engineered exclusively with clean illuminate/* contracts (^11.0|^12.0|^13.0) and PHP 8.2+ strict type features (readonly, union types, CarbonImmutable).

---

Quick Installation

You can install any tool individually via Composer:

# Time-based cooldowns
composer require zaber-dev/laravel-cooldown

---

Contributing & Support

Each package in the ecosystem is fully covered by an exhaustive PHPUnit test suite (100% test passing across all drivers). When submitting bug fixes or feature requests to individual repositories, please ensure any pull requests include corresponding integration and unit tests.

---

License

All packages in the ZaberDev Laravel Ecosystem are open-sourced software licensed under the MIT license.

---

Built with ❤️ as part of the ZaberDev Laravel Ecosystem.