Upgrade Guide

composer update lunarphp/lunar

php artisan migrate

php artisan optimize:clear

- "stephenjude/filament-two-factor-authentication": "^2.0",
+ "lunarphp/filament3-2fa": "^2.1.0",

\Lunar\Facades\Telemetry::optOut();

// Old (assuming order #250 in April 2025)
2025-04-00250

// New (assuming order ID is 1965)
00001965

'reference_format' => [
    /**
     * Optional prefix for the order reference
     */
    'prefix' => null,

    /**
     * STR_PAD_LEFT: 00001965
     * STR_PAD_RIGHT: 19650000
     * STR_PAD_BOTH: 00196500
     */
    'padding_direction' => STR_PAD_LEFT,

    /**
     * 00001965
     * AAAA1965
     */
    'padding_character' => '0',

    /**
     * If the length specified below is smaller than the length
     * of the Order ID, then no padding will take place.
     */
    'length' => 8,
],

public function register()
{
    \Lunar\Admin\Support\Facades\LunarPanel::enforceTwoFactorAuth()->register();
}

public function register()
{
    \Lunar\Admin\Support\Facades\LunarPanel::disableTwoFactorAuth()->register();
}

// Old
ModelManifest::register(collect([
    Product::class => \App\Models\Product::class,
    // ...
]));

// New
ModelManifest::replace(
    \Lunar\Models\Contracts\Product::class,
    \App\Models\Product::class
);

'morph_prefix' => null,

- STRIPE_WEBHOOK_PAYMENT_INTENT=...
+ LUNAR_STRIPE_WEBHOOK_SECRET=...

'stripe' => [
    'key' => env('STRIPE_SECRET'),
    'public_key' => env('STRIPE_PK'),
    'webhooks' => [
        'lunar' => env('LUNAR_STRIPE_WEBHOOK_SECRET'),
    ],
],

// ...
class User extends Authenticatable implements \Lunar\Base\LunarUser
{
    use \Lunar\Base\Traits\LunarUser;
}

// Move to config/cart_session.php
'session_key' => 'lunar_cart',
'auto_create' => false,

public function handle(\Lunar\Models\Cart $cart, \Closure $next)
{
    // ...

    return $next($cart);
}

public function canBeFulfilledAtQuantity(int $quantity): bool;
public function getTotalInventory(): int;

// Old
$variant->purchasable == 'backorder';

// New
$variant->purchasable == 'in_stock_or_on_backorder';

\Lunar\Facades\CartSession::forget(delete: false);

// Old
\Lunar\Stripe\Facades\StripeFacade;

// New
\Lunar\Stripe\Facades\Stripe;

// Old
$priceModel->tier
// New
$priceModel->min_quantity

// Old
$priceModel->tiers
// New
$priceModel->priceBreaks

// Old
public Collection $tiered,
// New
public Collection $priceBreaks,

public ?int $orderId = null,
public ?string $paymentType = null