Feat: Payment Restructuring to be fully event-driven

src/Payment/Drivers/OfflinePaymentDriver.php

@@ -2,27 +2,27 @@
 
 namespace Modules\Core\Payment\Drivers;
 
-use Lunar\Models\Cart;
-use Modules\Core\Checkout\Events\OrderPlaced;
-use Modules\Core\Checkout\Events\PaymentConfirmed;
-use Modules\Core\Payment\Contracts\PaymentDriver;
+use Illuminate\Support\Str;
+use Lunar\DataTypes\Price;
+use Modules\Core\Payment\Contracts\Configurable;
+use Modules\Core\Payment\Contracts\SupportsPay;
+use Modules\Core\Payment\DTOs\PaymentResult;
+use Modules\Core\Payment\Enums\PaymentResultStatus;
+use Modules\Core\Payment\Events\PaymentCaptured;
 
 /**
  * Shared by every payment type with no real gateway to confirm against —
  * cash-in-hand, cash-on-delivery — where the shopper pays at pickup/on
- * delivery, not at checkout. confirm() has nothing to wait on, so it
- * dispatches PaymentConfirmed immediately, same moment Lunar's own
- * OfflinePayment would place the order — but the actual placement now
- * happens in CheckoutService::onPaymentConfirmed(), not here. $data is
- * unused: nothing about this confirmation depends on gateway-specific
- * payload.
+ * delivery, not at checkout. There is no separate hold-then-settle model
+ * (SupportsAuthorization/SupportsCaptures/SupportsVoids) and no async
+ * resolution (HandlesPaymentCallback) — pay() decides success immediately
+ * and dispatches PaymentCaptured before returning.
  *
- * The status-mapping step this driver used to do inline right after
- * placeOrder() returned now happens in onOrderPlaced() below instead —
- * see PaymentDriver's docblock for why a driver can no longer rely on
- * placeOrder()'s return value.
+ * $reference is generated here (not supplied by a gateway, since there is
+ * none) purely so PaymentCaptured, and anything downstream keying on it,
+ * have something to identify this attempt by.
  */
-class OfflinePaymentDriver implements PaymentDriver
+class OfflinePaymentDriver implements Configurable, SupportsPay
 {
     /**
      * Always true — no external dependency to be missing.
@@ -32,30 +32,18 @@ class OfflinePaymentDriver implements PaymentDriver
         return true;
     }
 
-    public function confirm(Cart $cart, string $type, string $fingerprint, array $data): void
+    public function pay(string $type, Price $amount, array $data = [], array $context = []): PaymentResult
     {
-        PaymentConfirmed::dispatch($cart, $type, $fingerprint, $data);
+        $reference = 'offline-'.Str::uuid();
+
+        $result = new PaymentResult(
+            status: PaymentResultStatus::Succeeded,
+            reference: $reference,
+            amount: $amount,
+        );
+
+        PaymentCaptured::dispatch($type, $result, $context);
+
+        return $result;
     }
-
-    /**
-     * Registered in PaymentServiceProvider. Every offline-style type
-     * shares this one driver, so $order->meta['payment_method'] is checked
-     * against config('lunar.payments.types') to confirm the placed order
-     * actually belongs to one of them, rather than assuming every
-     * OrderPlaced is this driver's to act on — a Stripe order placed via
-     * StripePaymentDriver fires the same event.
-     */
-    public function onOrderPlaced(OrderPlaced $event): void
-    {
-        $order = $event->order;
-        $type = $order->meta['payment_method'] ?? null;
-
-        if (! $type || config("lunar.payments.types.{$type}.payment_driver") !== self::class) {
-            return;
-        }
-
-        $order->update([
-            'status' => config("lunar.payments.types.{$type}.authorized", $order->status),
-        ]);
-    }
-}
+}