@downcity/services 0.1.94 → 0.1.101

package/bin/payment/providers/dodo/index.js

@@ -0,0 +1,109 @@
+/**
+ * Dodo Payments payment provider 工厂。
+ *
+ * 关键说明（中文）
+ * - Dodo 只是 PaymentService 的一个 provider
+ * - 负责声明 env、生成支付方式、创建 Checkout、解析 webhook
+ */
+import { normalizeCurrency, normalizeOptionalText, normalizeRequired, paymentMethodItem, randomId, } from "../../helpers.js";
+import { createDodoCheckoutSession, createDodoClient, normalizeDodoEnvironment, parseDodoWebhookEvent, readMetadata, } from "./client.js";
+/**
+ * 创建 Dodo Payments provider。
+ */
+export function dodoPaymentProvider(options = {}) {
+    const label = options.label?.trim() || "Dodo Payments";
+    return {
+        id: "dodo",
+        label,
+        env: [
+            { key: "DODO_PAYMENTS_API_KEY", description: "Dodo Payments API key，用于创建 Checkout Session", required: true },
+            { key: "DODO_PRODUCT_ID", description: "Dodo product_id，用于创建 Checkout Session", required: true },
+            { key: "DODO_WEBHOOK_KEY", description: "Dodo webhook signing key，用于校验 webhook", required: false },
+            { key: "DODO_ENVIRONMENT", description: "Dodo SDK 环境：test_mode 或 live_mode；默认 test_mode", required: false },
+            { key: "DODO_CURRENCY", description: "默认结算币种，例如 usd", required: false },
+            { key: "DODO_API_BASE_URL", description: "可选的 Dodo API 基础地址覆写，通常只用于测试环境", required: false },
+        ],
+        method(ctx) {
+            const enabled = Boolean((options.api_key || ctx.env("DODO_PAYMENTS_API_KEY"))
+                && (options.product_id || ctx.env("DODO_PRODUCT_ID")));
+            return paymentMethodItem({
+                id: "dodo",
+                enabled,
+                label,
+                currency: normalizeCurrency(ctx.env("DODO_CURRENCY")) || normalizeCurrency(options.currency) || "usd",
+            });
+        },
+        async createCheckout(input) {
+            const api_key = options.api_key ?? input.ctx.env("DODO_PAYMENTS_API_KEY");
+            const product_id = options.product_id ?? input.ctx.env("DODO_PRODUCT_ID");
+            if (!api_key)
+                throw new Error("Dodo API key is not configured");
+            if (!product_id)
+                throw new Error("Dodo product id is not configured");
+            const client = createDodoClient({
+                api_key,
+                webhook_key: options.webhook_key ?? input.ctx.env("DODO_WEBHOOK_KEY"),
+                environment: normalizeDodoEnvironment(input.ctx.env("DODO_ENVIRONMENT") || options.environment),
+                api_base_url: options.api_base_url ?? input.ctx.env("DODO_API_BASE_URL"),
+            });
+            const created = await createDodoCheckoutSession(client, {
+                payment_id: input.payment_id,
+                topup: input.topup,
+                product_id,
+                currency: normalizeCurrency(input.ctx.env("DODO_CURRENCY")) || normalizeCurrency(options.currency) || "usd",
+                return_url: input.success_url,
+                cancel_url: input.cancel_url,
+            });
+            return {
+                provider_session_id: created.checkout_session_id,
+                provider_payment_id: created.dodo_payment_id,
+                checkout_url: created.checkout_url,
+                metadata: { product_id },
+            };
+        },
+        async parseWebhook(input) {
+            const webhook_key = options.webhook_key ?? input.ctx.env("DODO_WEBHOOK_KEY");
+            const client = createDodoClient({
+                api_key: options.api_key ?? input.ctx.env("DODO_PAYMENTS_API_KEY") ?? "webhook_only",
+                webhook_key,
+                environment: normalizeDodoEnvironment(input.ctx.env("DODO_ENVIRONMENT") || options.environment),
+                api_base_url: options.api_base_url ?? input.ctx.env("DODO_API_BASE_URL"),
+            });
+            const event = parseDodoWebhookEvent({
+                client,
+                raw: input.raw,
+                headers: input.request.headers,
+                verify: Boolean(webhook_key),
+            });
+            const object = readMetadata(event.data || event.object);
+            const metadata = readMetadata(object.metadata);
+            const type = normalizeOptionalText(event.type) || normalizeOptionalText(event.eventType) || "unknown";
+            const provider_payment_id = normalizeOptionalText(object.payment_id) || normalizeOptionalText(object.id);
+            const checkout_session_id = normalizeOptionalText(object.checkout_session_id);
+            return {
+                event_id: normalizeRequired(event.id || event.event_id || provider_payment_id || `evt_${randomId()}`, "dodo event id"),
+                type,
+                payload: event,
+                status: type === "payment.succeeded"
+                    ? "paid"
+                    : type === "payment.failed"
+                        ? "failed"
+                        : type === "payment.cancelled" || type === "payment.canceled"
+                            ? "canceled"
+                            : "ignored",
+                payment_id: normalizeOptionalText(metadata.payment_id),
+                topup_id: normalizeOptionalText(metadata.topup_id),
+                provider_session_id: checkout_session_id,
+                provider_payment_id,
+                ref: provider_payment_id || checkout_session_id,
+                meta: {
+                    provider: "dodo",
+                    dodo_event_id: normalizeOptionalText(event.id || event.event_id),
+                    dodo_checkout_session_id: checkout_session_id,
+                    dodo_payment_id: provider_payment_id,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/bin/payment/providers/dodo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/payment/providers/dodo/index.ts"],"names":[],"mappings":"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"}

package/bin/payment/providers/dodo/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Dodo provider 内部类型。
+ *
+ * 关键说明（中文）
+ * - 仅供 dodo provider 内部使用
+ * - 对外可见类型（如 DodoPaymentProviderOptions）放在 payment/types.ts
+ */
+import type { PaymentTopupRecord } from "../../types.js";
+/**
+ * Dodo SDK 运行环境。
+ */
+export type DodoPaymentEnvironment = "test_mode" | "live_mode";
+/**
+ * Dodo Checkout API 创建参数。
+ */
+export interface DodoCreateCheckoutSessionInput {
+    /** 服务内部支付记录 ID。 */
+    payment_id: string;
+    /** 充值单信息。 */
+    topup: PaymentTopupRecord;
+    /** Dodo product_id。 */
+    product_id: string;
+    /** 结算币种。 */
+    currency: string;
+    /** 支付完成跳转地址。 */
+    return_url: string;
+    /** 支付取消跳转地址。 */
+    cancel_url: string;
+}
+/**
+ * Dodo Checkout API 创建结果。
+ */
+export interface DodoCheckoutSessionResult {
+    /** Dodo Checkout Session ID。 */
+    checkout_session_id: string;
+    /** Dodo Payment ID。 */
+    dodo_payment_id: string;
+    /** Dodo Checkout 托管页面 URL。 */
+    checkout_url: string;
+}
+/**
+ * Dodo webhook 事件。
+ */
+export interface DodoWebhookEvent extends Record<string, unknown> {
+    /** Dodo 事件 ID。 */
+    id?: unknown;
+    /** Dodo 事件 ID 备用字段。 */
+    event_id?: unknown;
+    /** Dodo 事件类型。 */
+    type?: unknown;
+    /** Dodo 事件类型备用字段。 */
+    eventType?: unknown;
+    /** Dodo 事件数据。 */
+    data?: unknown;
+    /** Dodo 事件主体备用字段。 */
+    object?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/bin/payment/providers/dodo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/payment/providers/dodo/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,WAAW,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,KAAK,EAAE,kBAAkB,CAAC;IAC1B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,kBAAkB;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qBAAqB;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qBAAqB;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/bin/payment/providers/dodo/types.js

@@ -0,0 +1,9 @@
+/**
+ * Dodo provider 内部类型。
+ *
+ * 关键说明（中文）
+ * - 仅供 dodo provider 内部使用
+ * - 对外可见类型（如 DodoPaymentProviderOptions）放在 payment/types.ts
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/payment/providers/dodo/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/payment/providers/dodo/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/payment/providers/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Payment provider 工厂统一入口。
+ *
+ * 关键说明（中文）
+ * - Stripe / Creem / Dodo / Waffo 都只是 PaymentService 的 provider
+ * - 每个 provider 单独放在自己的子目录里，便于扩展和维护
+ */
+export { creemPaymentProvider } from "./creem/index.js";
+export { dodoPaymentProvider } from "./dodo/index.js";
+export { stripePaymentProvider } from "./stripe/index.js";
+export { waffoPaymentProvider } from "./waffo/index.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/payment/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/payment/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/payment/providers/index.js

@@ -0,0 +1,12 @@
+/**
+ * Payment provider 工厂统一入口。
+ *
+ * 关键说明（中文）
+ * - Stripe / Creem / Dodo / Waffo 都只是 PaymentService 的 provider
+ * - 每个 provider 单独放在自己的子目录里，便于扩展和维护
+ */
+export { creemPaymentProvider } from "./creem/index.js";
+export { dodoPaymentProvider } from "./dodo/index.js";
+export { stripePaymentProvider } from "./stripe/index.js";
+export { waffoPaymentProvider } from "./waffo/index.js";
+//# sourceMappingURL=index.js.map

package/bin/payment/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/payment/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/{payment-stripe/stripe.d.ts → payment/providers/stripe/client.d.ts}

@@ -4,7 +4,7 @@
  * 关键说明（中文）
  * - 不直接依赖 Stripe SDK，统一走官方 HTTP API
  * - 创建 Checkout 使用 form-urlencoded，兼容 Node 与 Worker
- * - webhook 验签继续使用 Web Crypto API
+ * - webhook 验签使用 Web Crypto API，支持 Cloudflare Workers
  */
 import type { StripeCheckoutSessionResult, StripeCreateCheckoutSessionInput, StripeWebhookEvent } from "./types.js";
 /**
@@ -14,7 +14,7 @@ export declare function normalizeStripeApiBaseURL(value: string | undefined): st
 /**
  * 创建 Stripe Checkout Session。
  */
-export declare function createStripeCheckoutSession(secretKey: string, apiBaseURL: string, input: StripeCreateCheckoutSessionInput): Promise<StripeCheckoutSessionResult>;
+export declare function createStripeCheckoutSession(secret_key: string, api_base_url: string, input: StripeCreateCheckoutSessionInput): Promise<StripeCheckoutSessionResult>;
 /**
  * 解析 Stripe webhook 事件。
  */
@@ -24,15 +24,7 @@ export declare function parseStripeWebhookEvent(raw: string): StripeWebhookEvent
  */
 export declare function verifyStripeSignature(raw: string, header: string | null, secret: string): Promise<boolean>;
 /**
- * 规范化非空字符串。
- */
-export declare function normalizeRequired(value: unknown, label: string): string;
-/**
- * 规范化可选字符串。
- */
-export declare function normalizeOptionalText(value: unknown): string;
-/**
- * 规范化 metadata 对象。
+ * 读取 metadata 对象。
  */
 export declare function readMetadata(value: unknown): Record<string, unknown>;
-//# sourceMappingURL=stripe.d.ts.map
+//# sourceMappingURL=client.d.ts.map

package/bin/payment/providers/stripe/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/payment/providers/stripe/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,2BAA2B,EAC3B,gCAAgC,EAChC,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3E;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,2BAA2B,CAAC,CAyCtC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAGvE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIpE"}

package/bin/{payment-stripe/stripe.js → payment/providers/stripe/client.js}

@@ -4,8 +4,9 @@
  * 关键说明（中文）
  * - 不直接依赖 Stripe SDK，统一走官方 HTTP API
  * - 创建 Checkout 使用 form-urlencoded，兼容 Node 与 Worker
- * - webhook 验签继续使用 Web Crypto API
+ * - webhook 验签使用 Web Crypto API，支持 Cloudflare Workers
  */
+import { normalizeOptionalText, normalizeRequired } from "../../helpers.js";
 /**
  * 规范化 Stripe API 基础地址。
  */
@@ -18,7 +19,7 @@ export function normalizeStripeApiBaseURL(value) {
 /**
  * 创建 Stripe Checkout Session。
  */
-export async function createStripeCheckoutSession(secretKey, apiBaseURL, input) {
+export async function createStripeCheckoutSession(secret_key, api_base_url, input) {
     const body = new URLSearchParams();
     body.set("mode", "payment");
     body.set("success_url", input.success_url);
@@ -34,10 +35,10 @@ export async function createStripeCheckoutSession(secretKey, apiBaseURL, input)
     body.set("payment_intent_data[metadata][payment_id]", input.payment_id);
     body.set("payment_intent_data[metadata][topup_id]", input.topup.topup_id);
     body.set("payment_intent_data[metadata][user_id]", input.topup.user_id);
-    const response = await fetch(`${normalizeStripeApiBaseURL(apiBaseURL)}/checkout/sessions`, {
+    const response = await fetch(`${normalizeStripeApiBaseURL(api_base_url)}/checkout/sessions`, {
         method: "POST",
         headers: {
-            authorization: `Bearer ${normalizeRequired(secretKey, "Stripe secret key")}`,
+            authorization: `Bearer ${normalizeRequired(secret_key, "Stripe secret key")}`,
             "content-type": "application/x-www-form-urlencoded",
         },
         body,
@@ -49,27 +50,12 @@ export async function createStripeCheckoutSession(secretKey, apiBaseURL, input)
             "Stripe checkout session creation failed").trim();
         throw new Error(message || "Stripe checkout session creation failed");
     }
-    const sessionId = normalizeRequired(payload.id, "Stripe checkout session id");
-    const checkoutURL = normalizeRequired(payload.url, "Stripe checkout session url");
     return {
-        session_id: sessionId,
-        checkout_url: checkoutURL,
+        session_id: normalizeRequired(payload.id, "Stripe checkout session id"),
+        checkout_url: normalizeRequired(payload.url, "Stripe checkout session url"),
         payment_intent_id: normalizeOptionalText(payload.payment_intent),
     };
 }
-/**
- * 读取支付 provider 需要的 USD cents 金额。
- */
-function readTopupAmountUsdCents(topup) {
-    const direct = Number(topup.amount_usd_cents);
-    if (Number.isSafeInteger(direct) && direct > 0)
-        return direct;
-    const fallback = Math.round(Number(topup.amount) / 10_000);
-    if (!Number.isSafeInteger(fallback) || fallback <= 0) {
-        throw new TypeError("topup amount_usd_cents must be a positive integer");
-    }
-    return fallback;
-}
 /**
  * 解析 Stripe webhook 事件。
  */
@@ -104,28 +90,26 @@ export async function verifyStripeSignature(raw, header, secret) {
     return result === 0;
 }
 /**
- * 规范化非空字符串。
- */
-export function normalizeRequired(value, label) {
-    const normalized = String(value ?? "").trim();
-    if (!normalized)
-        throw new TypeError(`${label} is required`);
-    return normalized;
-}
-/**
- * 规范化可选字符串。
- */
-export function normalizeOptionalText(value) {
-    return typeof value === "string" ? value.trim() : "";
-}
-/**
- * 规范化 metadata 对象。
+ * 读取 metadata 对象。
  */
 export function readMetadata(value) {
     return value && typeof value === "object" && !Array.isArray(value)
         ? value
         : {};
 }
+/**
+ * 读取支付 provider 需要的 USD cents 金额。
+ */
+function readTopupAmountUsdCents(topup) {
+    const direct = Number(topup.amount_usd_cents);
+    if (Number.isSafeInteger(direct) && direct > 0)
+        return direct;
+    const fallback = Math.round(Number(topup.amount) / 10_000);
+    if (!Number.isSafeInteger(fallback) || fallback <= 0) {
+        throw new TypeError("topup amount_usd_cents must be a positive integer");
+    }
+    return fallback;
+}
 /**
  * 读取 JSON 响应并兜底为空对象。
  */
@@ -139,4 +123,4 @@ async function readJSONRecord(response) {
         return { message: text };
     }
 }
-//# sourceMappingURL=stripe.js.map
+//# sourceMappingURL=client.js.map

package/bin/payment/providers/stripe/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/payment/providers/stripe/client.ts"],"names":[],"mappings":"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"}

package/bin/payment/providers/stripe/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Stripe payment provider 工厂。
+ *
+ * 关键说明（中文）
+ * - Stripe 只是 PaymentService 的一个 provider
+ * - 负责声明 env、生成支付方式、创建 Checkout、解析 webhook
+ */
+import type { PaymentProvider, StripePaymentProviderOptions } from "../../types.js";
+/**
+ * 创建 Stripe payment provider。
+ */
+export declare function stripePaymentProvider(options?: StripePaymentProviderOptions): PaymentProvider;
+//# sourceMappingURL=index.d.ts.map

package/bin/payment/providers/stripe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/payment/providers/stripe/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AASpF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,eAAe,CAyFjG"}

package/bin/payment/providers/stripe/index.js

@@ -0,0 +1,97 @@
+/**
+ * Stripe payment provider 工厂。
+ *
+ * 关键说明（中文）
+ * - Stripe 只是 PaymentService 的一个 provider
+ * - 负责声明 env、生成支付方式、创建 Checkout、解析 webhook
+ */
+import { normalizeCurrency, normalizeOptionalText, normalizeRequired, paymentMethodItem, } from "../../helpers.js";
+import { createStripeCheckoutSession, normalizeStripeApiBaseURL, parseStripeWebhookEvent, readMetadata, verifyStripeSignature, } from "./client.js";
+/**
+ * 创建 Stripe payment provider。
+ */
+export function stripePaymentProvider(options = {}) {
+    const label = options.label?.trim() || "Stripe";
+    return {
+        id: "stripe",
+        label,
+        env: [
+            { key: "STRIPE_SECRET_KEY", description: "Stripe secret key，用于创建 Checkout Session", required: true },
+            { key: "STRIPE_WEBHOOK_SECRET", description: "Stripe webhook signing secret，用于校验 stripe-signature", required: false },
+            { key: "STRIPE_CURRENCY", description: "默认结算币种，例如 usd", required: false },
+            { key: "STRIPE_ITEM_NAME", description: "Stripe Checkout 展示的默认商品名", required: false },
+            { key: "STRIPE_API_BASE_URL", description: "可选的 Stripe API 基础地址覆写，通常只用于测试环境", required: false },
+        ],
+        method(ctx) {
+            const enabled = Boolean(options.secret_key || ctx.env("STRIPE_SECRET_KEY"));
+            return paymentMethodItem({
+                id: "stripe",
+                enabled,
+                label,
+                currency: normalizeCurrency(ctx.env("STRIPE_CURRENCY")) || normalizeCurrency(options.currency) || "usd",
+            });
+        },
+        async createCheckout(input) {
+            const secret_key = options.secret_key ?? input.ctx.env("STRIPE_SECRET_KEY");
+            if (!secret_key)
+                throw new Error("Stripe secret key is not configured");
+            const created = await createStripeCheckoutSession(secret_key, normalizeStripeApiBaseURL(input.ctx.env("STRIPE_API_BASE_URL") || options.api_base_url), {
+                payment_id: input.payment_id,
+                topup: input.topup,
+                currency: normalizeCurrency(input.ctx.env("STRIPE_CURRENCY")) || normalizeCurrency(options.currency) || "usd",
+                success_url: input.success_url,
+                cancel_url: input.cancel_url,
+                item_name: normalizeOptionalText(input.ctx.env("STRIPE_ITEM_NAME"))
+                    || normalizeOptionalText(options.item_name)
+                    || "Downcity Topup",
+            });
+            return {
+                provider_session_id: created.session_id,
+                provider_payment_id: created.payment_intent_id,
+                checkout_url: created.checkout_url,
+            };
+        },
+        async parseWebhook(input) {
+            const webhook_secret = options.webhook_secret ?? input.ctx.env("STRIPE_WEBHOOK_SECRET");
+            if (webhook_secret) {
+                const valid = await verifyStripeSignature(input.raw, input.request.headers.get("stripe-signature"), webhook_secret);
+                if (!valid)
+                    throw new Error("Invalid Stripe signature");
+            }
+            const event = parseStripeWebhookEvent(input.raw);
+            const object = readMetadata(event.data?.object);
+            const metadata = readMetadata(object.metadata);
+            const type = normalizeOptionalText(event.type) || "unknown";
+            const status = type === "checkout.session.completed"
+                ? "paid"
+                : type === "checkout.session.expired"
+                    ? "expired"
+                    : type === "payment_intent.payment_failed"
+                        ? "failed"
+                        : "ignored";
+            const is_payment_intent = type === "payment_intent.payment_failed";
+            return {
+                event_id: normalizeRequired(event.id, "stripe event id"),
+                type,
+                payload: event,
+                status,
+                payment_id: normalizeOptionalText(metadata.payment_id),
+                topup_id: normalizeOptionalText(metadata.topup_id) || normalizeOptionalText(object.client_reference_id),
+                provider_session_id: is_payment_intent ? undefined : normalizeOptionalText(object.id),
+                provider_payment_id: is_payment_intent
+                    ? normalizeOptionalText(object.id)
+                    : normalizeOptionalText(object.payment_intent),
+                ref: normalizeOptionalText(object.id),
+                meta: {
+                    provider: "stripe",
+                    stripe_event_id: normalizeOptionalText(event.id),
+                    stripe_checkout_session_id: is_payment_intent ? undefined : normalizeOptionalText(object.id),
+                    stripe_payment_intent_id: is_payment_intent
+                        ? normalizeOptionalText(object.id)
+                        : normalizeOptionalText(object.payment_intent),
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/bin/payment/providers/stripe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/payment/providers/stripe/index.ts"],"names":[],"mappings":"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"}

package/bin/payment/providers/stripe/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Stripe provider 内部类型。
+ *
+ * 关键说明（中文）
+ * - 仅供 stripe provider 内部使用
+ * - 对外可见类型（如 StripePaymentProviderOptions）放在 payment/types.ts
+ */
+import type { PaymentTopupRecord } from "../../types.js";
+/**
+ * Stripe Checkout API 创建参数。
+ */
+export interface StripeCreateCheckoutSessionInput {
+    /** 服务内部支付记录 ID。 */
+    payment_id: string;
+    /** 充值单信息。 */
+    topup: PaymentTopupRecord;
+    /** 结算币种。 */
+    currency: string;
+    /** 支付成功跳转地址。 */
+    success_url: string;
+    /** 支付取消跳转地址。 */
+    cancel_url: string;
+    /** Stripe Checkout 展示的商品名称。 */
+    item_name: string;
+}
+/**
+ * Stripe Checkout API 创建结果。
+ */
+export interface StripeCheckoutSessionResult {
+    /** Stripe Checkout Session ID。 */
+    session_id: string;
+    /** Stripe Checkout 托管页面 URL。 */
+    checkout_url: string;
+    /** 关联的 Payment Intent ID（创建时可能为空）。 */
+    payment_intent_id: string;
+}
+/**
+ * Stripe webhook 事件。
+ */
+export interface StripeWebhookEvent extends Record<string, unknown> {
+    /** Stripe 事件 ID。 */
+    id?: unknown;
+    /** Stripe 事件类型。 */
+    type?: unknown;
+    /** Stripe 事件 data。 */
+    data?: {
+        /** 事件主体对象。 */
+        object?: unknown;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/bin/payment/providers/stripe/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/payment/providers/stripe/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,KAAK,EAAE,kBAAkB,CAAC;IAC1B,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,oBAAoB;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,mBAAmB;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,IAAI,CAAC,EAAE;QACL,cAAc;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH"}

package/bin/payment/providers/stripe/types.js

@@ -0,0 +1,9 @@
+/**
+ * Stripe provider 内部类型。
+ *
+ * 关键说明（中文）
+ * - 仅供 stripe provider 内部使用
+ * - 对外可见类型（如 StripePaymentProviderOptions）放在 payment/types.ts
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/payment/providers/stripe/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/payment/providers/stripe/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/payment/providers/waffo/client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Waffo Pancake SDK 工具函数。
+ *
+ * 关键说明（中文）
+ * - 创建 Checkout 使用官方 `@waffo/pancake-ts` SDK
+ * - webhook 验签使用 SDK 自带 RSA-SHA256 verify
+ */
+import { WaffoPancake } from "@waffo/pancake-ts";
+import type { WaffoCheckoutSessionResult, WaffoCreateCheckoutSessionInput, WaffoPaymentEnvironment, WaffoWebhookEvent } from "./types.js";
+/**
+ * 创建 Waffo SDK client。
+ */
+export declare function createWaffoClient(input: {
+    /** Waffo Merchant ID。 */
+    merchant_id: string;
+    /** Waffo private key。 */
+    private_key: string;
+    /** 可选 webhook public key。 */
+    webhook_public_key?: string;
+    /** 可选 API 基础地址。 */
+    api_base_url?: string;
+}): WaffoPancake;
+/**
+ * 创建 Waffo Checkout Session。
+ */
+export declare function createWaffoCheckoutSession(client: WaffoPancake, input: WaffoCreateCheckoutSessionInput): Promise<WaffoCheckoutSessionResult>;
+/**
+ * 解析并校验 Waffo webhook。
+ */
+export declare function parseWaffoWebhookEvent(input: {
+    /** Waffo SDK client。 */
+    client: WaffoPancake;
+    /** 原始请求 body。 */
+    raw: string;
+    /** 签名请求头。 */
+    signature: string | null;
+    /** 事件环境。 */
+    environment: WaffoPaymentEnvironment;
+}): WaffoWebhookEvent;
+/**
+ * 读取 metadata 对象。
+ */
+export declare function readMetadata(value: unknown): Record<string, unknown>;
+/**
+ * 规范化 Waffo 运行环境。
+ */
+export declare function normalizeWaffoEnvironment(value: unknown): WaffoPaymentEnvironment;
+/**
+ * Waffo webhook-only fallback 私钥。
+ *
+ * 关键说明（中文）
+ * - 仅用于 webhook-only 场景，让 SDK 能完成签名验证流程
+ * - 不会用于任何真实请求，真实请求必须配置 WAFFO_PRIVATE_KEY
+ */
+export declare function fallbackWaffoPrivateKey(): string;
+//# sourceMappingURL=client.d.ts.map