Changelog

v2.0.0 — 2026-04-23

plan_subscriptions.slug is no longer globally unique. It is now unique per subscriber: (subscriber_type, subscriber_id, slug). This unblocks polymorphic use — two different subscriber types (e.g. User and Team) can now both hold a main subscription. Existing consumers must rebuild the unique index. See UPGRADING.md.
Dropped unused prorate_day, prorate_period, prorate_extend_due columns from the plans table. These were never read or written by any code path.
SubscriptionCreated, SubscriptionCanceled, SubscriptionRenewed, and SubscriptionPlanChanged no longer implement ShouldBroadcast. broadcastOn() was returning [] so nothing was ever broadcast. The subscriptions.broadcast_events config key has been removed. Consumers who want broadcasting should extend these events in their own application.
PlanSubscription::setNewPeriod() signature changed from (Interval|string $invoiceInterval = '', int $invoicePeriod = 0, Carbon|string $start = '') to (?Interval $invoiceInterval = null, ?int $invoicePeriod = null, ?Carbon $start = null). Only relevant if you were subclassing PlanSubscription.
PlanSubscription::recordFeatureUsage() now throws Crumbls\Subscriptions\Exceptions\UnknownFeatureException instead of Illuminate\Database\Eloquent\ModelNotFoundException when called with a feature slug that isn't on the subscription's plan.

PlanSubscription::active() no longer contained an unreachable branch. Behavior is unchanged for all documented states.
Feature usage increments are now wrapped in a DB::transaction() with lockForUpdate(). Two concurrent writers can no longer lose a usage increment.
newPlanSubscription() now locks the plan row during subscriber-limit enforcement. Two concurrent subscribers to a plan with active_subscribers_limit = N can no longer both squeeze past the check.
PlanSubscriptionUsage::scopeByFeatureSlug now filters via a single subquery instead of fetching the feature row first.
subscriptions:prune now prunes naturally-expired subscriptions too (previously only canceled + expired were pruned), matching the command description.

Composite index on (subscriber_type, subscriber_id, slug) and plain index on ends_at in the plan_subscriptions table.
Feature::scopeBySlug() and Feature::hasReset() helpers.
HasPlanSubscriptions::subscribe() — friendly alias for newPlanSubscription().
Model factories (PlanFactory, FeatureFactory, PlanSubscriptionFactory, PlanSubscriptionUsageFactory) with useful state methods (free(), paid(), withTrial(), withGrace(), limitedTo(), ended(), canceled(), onTrial(), resettableMonthly(), resettableDaily()).
GitHub Actions workflows for tests (PHP 8.3/8.4 × Laravel 11/12/13) and static analysis (Pint, PHPStan, Rector).
Dependabot config, Pint config, CONTRIBUTING.md, SECURITY.md, issue and PR templates.

Add Laravel 13 support (illuminate/*: ^13.0, orchestra/testbench: ^11.0)
Bump minimum PHP to 8.3 (required by Laravel 13)
Widen spatie constraints: eloquent-sortable ^4.4 || ^5.0, laravel-sluggable ^3.8, laravel-translatable ^6.13
Widen dev constraints: Pest 3|4, pest-plugin-laravel 3|4, PHPUnit 11|12
Bump driftingly/rector-laravel to ^2.3 and add Laravel 12/13 Rector sets; switch Rector PHP set to 8.3

Namespace changed from Rinvex\Subscriptions to Crumbls\Subscriptions
Config key changed from rinvex.subscriptions to subscriptions
Removed rinvex/laravel-support dependency entirely
Removed custom artisan commands (rinvex:migrate, rinvex:publish, rinvex:rollback) — use standard migrate / vendor:publish
Removed model-level validation (ValidatingTrait) — use form requests instead

Interval backed enum (hour, day, week, month, year) with addToDate() helper
Grace period support — onGracePeriod() method and active check
Lifecycle events: SubscriptionCreated, SubscriptionCanceled, SubscriptionRenewed, SubscriptionPlanChanged
subscriptions:prune artisan command for cleaning up expired subscriptions
@property docblocks on all models for IDE and static analysis support
PHPStan (level 5) + Larastan — clean
Pest test suite — 48 tests, 105 assertions (SQLite in-memory)