Artisan commands

# Immediately expire coupons (admin kill-switch) — Coupons::expireAll(). --code limits it to
# one coupon. Each one is revoked like Coupons::revoke(): CouponRevoked fires per coupon.
php artisan coupons:expire
php artisan coupons:expire --code=SAVE20

# Prune coupons expired more than N days ago — Coupons::prune(). Soft deletes (the code is free
# to issue again, the history stays); --force deletes permanently, including coupons an earlier
# prune soft-deleted. A --days that is negative or not a whole number (thirty, 1.5) is refused.
php artisan coupons:prune --days=30
php artisan coupons:prune --days=30 --force

use RoundlyConsulting\Coupons\Facades\Coupons;

Coupons::expireAll();                    // what coupons:expire runs; returns the count
Coupons::expireAll(code: 'SAVE20');      // coupons:expire --code=SAVE20
Coupons::prune(days: 30);                // coupons:prune --days=30
Coupons::prune(days: 30, force: true);   // coupons:prune --days=30 --force

// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('coupons:prune --days=90')->weekly();