@easypayment/medusa-paypal 0.4.7 → 0.4.8

package/src/jobs/paypal-reconcile.ts

@@ -1,113 +1,113 @@
-import type { MedusaContainer } from "@medusajs/framework/types"
-import { Modules } from "@medusajs/framework/utils"
-import type PayPalModuleService from "../modules/paypal/service"
-import { PAYPAL_MODULE } from "../modules/paypal"
-import { PAYPAL_PROVIDER_IDS } from "../modules/paypal/utils/provider-ids"
-
-const STATUS_MAP: Record<string, "pending" | "authorized" | "captured" | "canceled"> = {
-  CREATED: "pending",
-  APPROVED: "authorized",
-  COMPLETED: "captured",
-  VOIDED: "canceled",
-  CANCELLED: "canceled",
-}
-
-export default async function paypalReconcile(container: MedusaContainer) {
-  // FIX 3a: was container.resolve("payment_session") as any
-  // Modules.PAYMENT is the official typed constant for the Medusa payment module.
-  // listPaymentSessions and updatePaymentSession are methods on the payment module service.
-  const paymentModule = container.resolve(Modules.PAYMENT) as any
-
-  // FIX 3b: was container.resolve<PayPalModuleService>("paypal_onboarding")
-  // PAYPAL_MODULE is the exported constant from modules/paypal/index.ts
-  const paypal = container.resolve<PayPalModuleService>(PAYPAL_MODULE)
-
-  // FIX 3c: was ["pp_paypal_paypal", "pp_paypal_card_paypal_card"]
-  // PAYPAL_PROVIDER_IDS is the exported array from modules/paypal/utils/provider-ids.ts
-  // If the provider IDs ever change in one place, this file updates automatically.
-  const sessions = await paymentModule.listPaymentSessions({
-    provider_id: [...PAYPAL_PROVIDER_IDS],
-    status: ["pending", "authorized"],
-  })
-
-
-  for (const session of sessions || []) {
-    const data = (session?.data || {}) as Record<string, any>
-    const paypalData = (data.paypal || {}) as Record<string, any>
-    const orderId = String(paypalData.order_id || data.order_id || "")
-    if (!orderId) {
-      continue
-    }
-
-    try {
-      const order = await paypal.getOrderDetails(orderId)
-      const status = STATUS_MAP[String(order?.status || "").toUpperCase()]
-      if (!status) {
-        continue
-      }
-
-      const previousStatus = session?.status
-      if (previousStatus && previousStatus !== status) {
-        await paypal.recordPaymentLog("reconcile_drift", {
-          session_id: session.id,
-          order_id: orderId,
-          previous_status: previousStatus,
-          next_status: status,
-        })
-        await paypal.recordMetric("reconcile_drift")
-        await paypal.sendAlert({
-          type: "reconcile_drift",
-          message: `PayPal reconciliation drift detected for order ${orderId}.`,
-          metadata: {
-            session_id: session.id,
-            previous_status: previousStatus,
-            next_status: status,
-          },
-        })
-      }
-
-      // FIX 3d: was paymentSessionService.update(session.id, { ... })
-      // updatePaymentSession is the correct method name on the payment module service.
-      await paymentModule.updatePaymentSession(session.id, {
-        status,
-        amount: session.amount,
-        data: {
-          ...(session.data || {}),
-          paypal: {
-            ...((session.data || {}).paypal || {}),
-            order,
-            reconciliation: {
-              last_reconciled_at: new Date().toISOString(),
-              last_status: status,
-              order_status: order?.status,
-            },
-          },
-        },
-      })
-      try {
-        await paypal.recordMetric("reconcile_success")
-      } catch {
-        // ignore metrics failures
-      }
-    } catch (error) {
-      try {
-        await paypal.recordMetric("reconcile_failed")
-      } catch {
-        // ignore metrics failures
-      }
-      await paypal.sendAlert({
-        type: "reconcile_failed",
-        message: `PayPal reconciliation failed for order ${orderId}.`,
-        metadata: {
-          session_id: session.id,
-        },
-      })
-      console.error("[PayPal] reconcile error", error)
-    }
-  }
-}
-
-export const config = {
-  name: "paypal-reconcile",
-  schedule: "*/15 * * * *",
+import type { MedusaContainer } from "@medusajs/framework/types"
+import { Modules } from "@medusajs/framework/utils"
+import type PayPalModuleService from "../modules/paypal/service"
+import { PAYPAL_MODULE } from "../modules/paypal"
+import { PAYPAL_PROVIDER_IDS } from "../modules/paypal/utils/provider-ids"
+
+const STATUS_MAP: Record<string, "pending" | "authorized" | "captured" | "canceled"> = {
+  CREATED: "pending",
+  APPROVED: "authorized",
+  COMPLETED: "captured",
+  VOIDED: "canceled",
+  CANCELLED: "canceled",
+}
+
+export default async function paypalReconcile(container: MedusaContainer) {
+  // FIX 3a: was container.resolve("payment_session") as any
+  // Modules.PAYMENT is the official typed constant for the Medusa payment module.
+  // listPaymentSessions and updatePaymentSession are methods on the payment module service.
+  const paymentModule = container.resolve(Modules.PAYMENT) as any
+
+  // FIX 3b: was container.resolve<PayPalModuleService>("paypal_onboarding")
+  // PAYPAL_MODULE is the exported constant from modules/paypal/index.ts
+  const paypal = container.resolve<PayPalModuleService>(PAYPAL_MODULE)
+
+  // FIX 3c: was ["pp_paypal_paypal", "pp_paypal_card_paypal_card"]
+  // PAYPAL_PROVIDER_IDS is the exported array from modules/paypal/utils/provider-ids.ts
+  // If the provider IDs ever change in one place, this file updates automatically.
+  const sessions = await paymentModule.listPaymentSessions({
+    provider_id: [...PAYPAL_PROVIDER_IDS],
+    status: ["pending", "authorized"],
+  })
+
+
+  for (const session of sessions || []) {
+    const data = (session?.data || {}) as Record<string, any>
+    const paypalData = (data.paypal || {}) as Record<string, any>
+    const orderId = String(paypalData.order_id || data.order_id || "")
+    if (!orderId) {
+      continue
+    }
+
+    try {
+      const order = await paypal.getOrderDetails(orderId)
+      const status = STATUS_MAP[String(order?.status || "").toUpperCase()]
+      if (!status) {
+        continue
+      }
+
+      const previousStatus = session?.status
+      if (previousStatus && previousStatus !== status) {
+        await paypal.recordPaymentLog("reconcile_drift", {
+          session_id: session.id,
+          order_id: orderId,
+          previous_status: previousStatus,
+          next_status: status,
+        })
+        await paypal.recordMetric("reconcile_drift")
+        await paypal.sendAlert({
+          type: "reconcile_drift",
+          message: `PayPal reconciliation drift detected for order ${orderId}.`,
+          metadata: {
+            session_id: session.id,
+            previous_status: previousStatus,
+            next_status: status,
+          },
+        })
+      }
+
+      // FIX 3d: was paymentSessionService.update(session.id, { ... })
+      // updatePaymentSession is the correct method name on the payment module service.
+      await paymentModule.updatePaymentSession(session.id, {
+        status,
+        amount: session.amount,
+        data: {
+          ...(session.data || {}),
+          paypal: {
+            ...((session.data || {}).paypal || {}),
+            order,
+            reconciliation: {
+              last_reconciled_at: new Date().toISOString(),
+              last_status: status,
+              order_status: order?.status,
+            },
+          },
+        },
+      })
+      try {
+        await paypal.recordMetric("reconcile_success")
+      } catch {
+        // ignore metrics failures
+      }
+    } catch (error) {
+      try {
+        await paypal.recordMetric("reconcile_failed")
+      } catch {
+        // ignore metrics failures
+      }
+      await paypal.sendAlert({
+        type: "reconcile_failed",
+        message: `PayPal reconciliation failed for order ${orderId}.`,
+        metadata: {
+          session_id: session.id,
+        },
+      })
+      console.error("[PayPal] reconcile error", error)
+    }
+  }
+}
+
+export const config = {
+  name: "paypal-reconcile",
+  schedule: "*/15 * * * *",
 }

package/src/jobs/paypal-webhook-retry.ts

@@ -1,85 +1,85 @@
-import type { MedusaContainer } from "@medusajs/framework/types"
-import type PayPalModuleService from "../modules/paypal/service"
-import {
-  computeNextRetryAt,
-  isAllowedEventType,
-  processPayPalWebhookEvent,
-} from "../modules/paypal/webhook-processor"
-
-const MAX_WEBHOOK_ATTEMPTS = 5
-
-export default async function paypalWebhookRetry(container: MedusaContainer) {
-  const paypal = container.resolve<PayPalModuleService>("paypal_onboarding")
-  const now = Date.now()
-  const candidates = await paypal.listPayPalWebhookEvents({ status: "failed" })
-
-  for (const event of candidates || []) {
-    const nextRetryAt = event?.next_retry_at ? new Date(event.next_retry_at).getTime() : null
-    if (!nextRetryAt || nextRetryAt > now) {
-      continue
-    }
-
-    const attemptCount = Number(event.attempt_count || 0) + 1
-    if (attemptCount > MAX_WEBHOOK_ATTEMPTS) {
-      continue
-    }
-
-    await paypal.updateWebhookEventRecord({
-      id: event.id,
-      status: "processing",
-      attempt_count: attemptCount,
-      next_retry_at: null,
-      last_error: null,
-    })
-
-    try {
-      const eventType = String(event.event_type || "")
-      if (!isAllowedEventType(eventType)) {
-        await paypal.updateWebhookEventRecord({
-          id: event.id,
-          status: "ignored",
-          processed_at: new Date(),
-        })
-        continue
-      }
-
-      const payload = (event.payload || {}) as Record<string, any>
-      const processed = await processPayPalWebhookEvent(container, {
-        eventType,
-        payload,
-      })
-
-      await paypal.updateWebhookEventRecord({
-        id: event.id,
-        status: "processed",
-        processed_at: new Date(),
-        resource_id: processed.refundId || processed.captureId || processed.orderId || null,
-      })
-      try {
-        await paypal.recordMetric("webhook_retry_success")
-      } catch {
-        // ignore metrics failures
-      }
-    } catch (error: any) {
-      const nextRetry = attemptCount >= MAX_WEBHOOK_ATTEMPTS ? null : computeNextRetryAt(attemptCount)
-      await paypal.updateWebhookEventRecord({
-        id: event.id,
-        status: "failed",
-        attempt_count: attemptCount,
-        next_retry_at: nextRetry,
-        last_error: error?.message || String(error),
-      })
-      try {
-        await paypal.recordMetric("webhook_retry_failed")
-      } catch {
-        // ignore metrics failures
-      }
-      console.error("[PayPal] webhook retry error", error)
-    }
-  }
-}
-
-export const config = {
-  name: "paypal-webhook-retry",
-  schedule: "*/10 * * * *",
-}
+import type { MedusaContainer } from "@medusajs/framework/types"
+import type PayPalModuleService from "../modules/paypal/service"
+import {
+  computeNextRetryAt,
+  isAllowedEventType,
+  processPayPalWebhookEvent,
+} from "../modules/paypal/webhook-processor"
+
+const MAX_WEBHOOK_ATTEMPTS = 5
+
+export default async function paypalWebhookRetry(container: MedusaContainer) {
+  const paypal = container.resolve<PayPalModuleService>("paypal_onboarding")
+  const now = Date.now()
+  const candidates = await paypal.listPayPalWebhookEvents({ status: "failed" })
+
+  for (const event of candidates || []) {
+    const nextRetryAt = event?.next_retry_at ? new Date(event.next_retry_at).getTime() : null
+    if (!nextRetryAt || nextRetryAt > now) {
+      continue
+    }
+
+    const attemptCount = Number(event.attempt_count || 0) + 1
+    if (attemptCount > MAX_WEBHOOK_ATTEMPTS) {
+      continue
+    }
+
+    await paypal.updateWebhookEventRecord({
+      id: event.id,
+      status: "processing",
+      attempt_count: attemptCount,
+      next_retry_at: null,
+      last_error: null,
+    })
+
+    try {
+      const eventType = String(event.event_type || "")
+      if (!isAllowedEventType(eventType)) {
+        await paypal.updateWebhookEventRecord({
+          id: event.id,
+          status: "ignored",
+          processed_at: new Date(),
+        })
+        continue
+      }
+
+      const payload = (event.payload || {}) as Record<string, any>
+      const processed = await processPayPalWebhookEvent(container, {
+        eventType,
+        payload,
+      })
+
+      await paypal.updateWebhookEventRecord({
+        id: event.id,
+        status: "processed",
+        processed_at: new Date(),
+        resource_id: processed.refundId || processed.captureId || processed.orderId || null,
+      })
+      try {
+        await paypal.recordMetric("webhook_retry_success")
+      } catch {
+        // ignore metrics failures
+      }
+    } catch (error: any) {
+      const nextRetry = attemptCount >= MAX_WEBHOOK_ATTEMPTS ? null : computeNextRetryAt(attemptCount)
+      await paypal.updateWebhookEventRecord({
+        id: event.id,
+        status: "failed",
+        attempt_count: attemptCount,
+        next_retry_at: nextRetry,
+        last_error: error?.message || String(error),
+      })
+      try {
+        await paypal.recordMetric("webhook_retry_failed")
+      } catch {
+        // ignore metrics failures
+      }
+      console.error("[PayPal] webhook retry error", error)
+    }
+  }
+}
+
+export const config = {
+  name: "paypal-webhook-retry",
+  schedule: "*/10 * * * *",
+}

package/src/modules/paypal/clients/paypal-seller.client.ts

@@ -1,59 +1,59 @@
-export class PayPalSellerClient {
-  constructor(private opts: { environment: "sandbox" | "live"; accessToken: string }) {}
-
-  private baseUrl() {
-    return this.opts.environment === "live"
-      ? "https://api-m.paypal.com"
-      : "https://api-m.sandbox.paypal.com"
-  }
-
-  private headers(extra?: Record<string, string>) {
-    return {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${this.opts.accessToken}`,
-      ...(extra ?? {}),
-    }
-  }
-
-  async createOrder(body: any) {
-    const res = await fetch(`${this.baseUrl()}/v2/checkout/orders`, {
-      method: "POST",
-      headers: this.headers(),
-      body: JSON.stringify(body),
-    })
-    const json = await res.json().catch(() => ({}))
-    if (!res.ok) throw new Error(`PayPal createOrder failed (${res.status}): ${JSON.stringify(json)}`)
-    return json
-  }
-
-  async getOrder(orderId: string) {
-    const res = await fetch(`${this.baseUrl()}/v2/checkout/orders/${orderId}`, {
-      method: "GET",
-      headers: this.headers(),
-    })
-    const json = await res.json().catch(() => ({}))
-    if (!res.ok) throw new Error(`PayPal getOrder failed (${res.status}): ${JSON.stringify(json)}`)
-    return json
-  }
-
-  async captureOrder(orderId: string) {
-    const res = await fetch(`${this.baseUrl()}/v2/checkout/orders/${orderId}/capture`, {
-      method: "POST",
-      headers: this.headers(),
-    })
-    const json = await res.json().catch(() => ({}))
-    if (!res.ok) throw new Error(`PayPal captureOrder failed (${res.status}): ${JSON.stringify(json)}`)
-    return json
-  }
-
-  async refundCapture(captureId: string, body?: any) {
-    const res = await fetch(`${this.baseUrl()}/v2/payments/captures/${captureId}/refund`, {
-      method: "POST",
-      headers: this.headers(),
-      body: body ? JSON.stringify(body) : "{}",
-    })
-    const json = await res.json().catch(() => ({}))
-    if (!res.ok) throw new Error(`PayPal refund failed (${res.status}): ${JSON.stringify(json)}`)
-    return json
-  }
-}
+export class PayPalSellerClient {
+  constructor(private opts: { environment: "sandbox" | "live"; accessToken: string }) {}
+
+  private baseUrl() {
+    return this.opts.environment === "live"
+      ? "https://api-m.paypal.com"
+      : "https://api-m.sandbox.paypal.com"
+  }
+
+  private headers(extra?: Record<string, string>) {
+    return {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.opts.accessToken}`,
+      ...(extra ?? {}),
+    }
+  }
+
+  async createOrder(body: any) {
+    const res = await fetch(`${this.baseUrl()}/v2/checkout/orders`, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(body),
+    })
+    const json = await res.json().catch(() => ({}))
+    if (!res.ok) throw new Error(`PayPal createOrder failed (${res.status}): ${JSON.stringify(json)}`)
+    return json
+  }
+
+  async getOrder(orderId: string) {
+    const res = await fetch(`${this.baseUrl()}/v2/checkout/orders/${orderId}`, {
+      method: "GET",
+      headers: this.headers(),
+    })
+    const json = await res.json().catch(() => ({}))
+    if (!res.ok) throw new Error(`PayPal getOrder failed (${res.status}): ${JSON.stringify(json)}`)
+    return json
+  }
+
+  async captureOrder(orderId: string) {
+    const res = await fetch(`${this.baseUrl()}/v2/checkout/orders/${orderId}/capture`, {
+      method: "POST",
+      headers: this.headers(),
+    })
+    const json = await res.json().catch(() => ({}))
+    if (!res.ok) throw new Error(`PayPal captureOrder failed (${res.status}): ${JSON.stringify(json)}`)
+    return json
+  }
+
+  async refundCapture(captureId: string, body?: any) {
+    const res = await fetch(`${this.baseUrl()}/v2/payments/captures/${captureId}/refund`, {
+      method: "POST",
+      headers: this.headers(),
+      body: body ? JSON.stringify(body) : "{}",
+    })
+    const json = await res.json().catch(() => ({}))
+    if (!res.ok) throw new Error(`PayPal refund failed (${res.status}): ${JSON.stringify(json)}`)
+    return json
+  }
+}

package/src/modules/paypal/index.ts

@@ -1,8 +1,8 @@
-import { Module } from "@medusajs/framework/utils"
-import PayPalModuleService from "./service"
-
-export const PAYPAL_MODULE = "paypal_onboarding"
-
-export default Module(PAYPAL_MODULE, {
-  service: PayPalModuleService,
-})
+import { Module } from "@medusajs/framework/utils"
+import PayPalModuleService from "./service"
+
+export const PAYPAL_MODULE = "paypal_onboarding"
+
+export default Module(PAYPAL_MODULE, {
+  service: PayPalModuleService,
+})

package/src/modules/paypal/migrations/20260115120000_create_paypal_connection.ts

@@ -1,33 +1,33 @@
-import { Migration } from "@medusajs/framework/mikro-orm/migrations"
-
-export class Migration20260115120000 extends Migration {
-  async up(): Promise<void> {
-    this.addSql(`
-      CREATE TABLE IF NOT EXISTS "paypal_connection" (
-        "id" text NOT NULL,
-        "environment" text NOT NULL DEFAULT 'sandbox',
-        "status" text NOT NULL DEFAULT 'disconnected',
-        "shared_id" text NULL,
-        "auth_code" text NULL,
-        "seller_client_id" text NULL,
-        "seller_client_secret" text NULL,
-        "app_access_token" text NULL,
-        "app_access_token_expires_at" timestamptz NULL,
-        "metadata" jsonb NOT NULL DEFAULT '{}'::jsonb,
-        "created_at" timestamptz NOT NULL DEFAULT now(),
-        "updated_at" timestamptz NOT NULL DEFAULT now(),
-        "deleted_at" timestamptz NULL,
-        CONSTRAINT "paypal_connection_pkey" PRIMARY KEY ("id")
-      );
-
-      CREATE INDEX IF NOT EXISTS "idx_paypal_connection_deleted_at"
-        ON "paypal_connection" ("deleted_at");
-    `)
-  }
-
-  async down(): Promise<void> {
-    this.addSql(`
-      DROP TABLE IF EXISTS "paypal_connection" CASCADE;
-    `)
-  }
-}
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20260115120000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      CREATE TABLE IF NOT EXISTS "paypal_connection" (
+        "id" text NOT NULL,
+        "environment" text NOT NULL DEFAULT 'sandbox',
+        "status" text NOT NULL DEFAULT 'disconnected',
+        "shared_id" text NULL,
+        "auth_code" text NULL,
+        "seller_client_id" text NULL,
+        "seller_client_secret" text NULL,
+        "app_access_token" text NULL,
+        "app_access_token_expires_at" timestamptz NULL,
+        "metadata" jsonb NOT NULL DEFAULT '{}'::jsonb,
+        "created_at" timestamptz NOT NULL DEFAULT now(),
+        "updated_at" timestamptz NOT NULL DEFAULT now(),
+        "deleted_at" timestamptz NULL,
+        CONSTRAINT "paypal_connection_pkey" PRIMARY KEY ("id")
+      );
+
+      CREATE INDEX IF NOT EXISTS "idx_paypal_connection_deleted_at"
+        ON "paypal_connection" ("deleted_at");
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`
+      DROP TABLE IF EXISTS "paypal_connection" CASCADE;
+    `)
+  }
+}

package/src/modules/paypal/migrations/20260123090000_create_paypal_settings.ts

@@ -1,22 +1,22 @@
-import { Migration } from "@medusajs/framework/mikro-orm/migrations"
-
-export class Migration20260123090000 extends Migration {
-  async up(): Promise<void> {
-    this.addSql(`
-      CREATE TABLE IF NOT EXISTS "paypal_settings" (
-        "id" text NOT NULL,
-        "data" jsonb NULL,
-        "created_at" timestamptz NOT NULL DEFAULT now(),
-        "updated_at" timestamptz NOT NULL DEFAULT now(),
-        "deleted_at" timestamptz NULL,
-        CONSTRAINT "paypal_settings_pkey" PRIMARY KEY ("id")
-      );
-      CREATE INDEX IF NOT EXISTS "idx_paypal_settings_deleted_at"
-        ON "paypal_settings" ("deleted_at");
-    `)
-  }
-
-  async down(): Promise<void> {
-    this.addSql(`DROP TABLE IF EXISTS "paypal_settings" CASCADE;`)
-  }
-}
+import { Migration } from "@medusajs/framework/mikro-orm/migrations"
+
+export class Migration20260123090000 extends Migration {
+  async up(): Promise<void> {
+    this.addSql(`
+      CREATE TABLE IF NOT EXISTS "paypal_settings" (
+        "id" text NOT NULL,
+        "data" jsonb NULL,
+        "created_at" timestamptz NOT NULL DEFAULT now(),
+        "updated_at" timestamptz NOT NULL DEFAULT now(),
+        "deleted_at" timestamptz NULL,
+        CONSTRAINT "paypal_settings_pkey" PRIMARY KEY ("id")
+      );
+      CREATE INDEX IF NOT EXISTS "idx_paypal_settings_deleted_at"
+        ON "paypal_settings" ("deleted_at");
+    `)
+  }
+
+  async down(): Promise<void> {
+    this.addSql(`DROP TABLE IF EXISTS "paypal_settings" CASCADE;`)
+  }
+}