@downcity/services 0.1.94 → 0.1.101

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/payment/providers/waffo/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAC/B,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,YAAY,CAOf;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,0BAA0B,CAAC,CAmBrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,wBAAwB;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY;IACZ,WAAW,EAAE,uBAAuB,CAAC;CACtC,GAAG,iBAAiB,CAKpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIpE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAIjF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CA8BhD"}

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

@@ -4,9 +4,9 @@
  * 关键说明（中文）
  * - 创建 Checkout 使用官方 `@waffo/pancake-ts` SDK
  * - webhook 验签使用 SDK 自带 RSA-SHA256 verify
- * - 这里集中处理 SDK client、事件解析和字符串归一化
  */
 import { WaffoPancake } from "@waffo/pancake-ts";
+import { normalizeOptionalText, normalizeRequired } from "../../helpers.js";
 /**
  * 创建 Waffo SDK client。
  */
@@ -40,19 +40,6 @@ export async function createWaffoCheckoutSession(client, input) {
         checkout_url: normalizeRequired(response.checkoutUrl, "Waffo checkout url"),
     };
 }
-/**
- * 读取支付 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;
-}
 /**
  * 解析并校验 Waffo webhook。
  */
@@ -63,22 +50,7 @@ export function parseWaffoWebhookEvent(input) {
     return event && typeof event === "object" ? event : {};
 }
 /**
- * 规范化非空字符串。
- */
-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)
@@ -94,4 +66,55 @@ export function normalizeWaffoEnvironment(value) {
         return "prod";
     return "test";
 }
-//# sourceMappingURL=waffo.js.map
+/**
+ * Waffo webhook-only fallback 私钥。
+ *
+ * 关键说明（中文）
+ * - 仅用于 webhook-only 场景，让 SDK 能完成签名验证流程
+ * - 不会用于任何真实请求，真实请求必须配置 WAFFO_PRIVATE_KEY
+ */
+export function fallbackWaffoPrivateKey() {
+    return [
+        "-----BEGIN RSA PRIVATE KEY-----",
+        "MIIEpAIBAAKCAQEAtAqPA17F1sr9kylJy8LbcaHrim/UocR/ur3z5Vu7QQTUhuPO",
+        "pbsYnu1oFGwCsCjFhBBapI8/Huy9ARP3/Oxsp4kna9gEPLRSTMfUK5a0nPUnkHXv",
+        "DFgzIFYn1Yac/3FiA4zIA5BH+0ZUBu8cFZ1MvaPu7YFQvr165hOmwLnoJsypcY5V",
+        "Kjb8p+HjMXyiCy3gUId2DCJuUhjbtUo84gI3v4YAI6YD07pNUSm5wFDFKsYeymdV",
+        "QdtBhgPUx0RJDyhOKU1Vq8mge2b03ZiQK3O3gUmQgP0sAUpyyUrHaMjs/nAw9dqy",
+        "Wl0VyglAIcl79sRVUXTHgEHGf+j0pNcyVjIF2QIDAQABAoIBAAM1bPcSaVQ6qepF",
+        "ghsvjdmomRoOhCud5OjfGcmsqNmvzFnbFYO+oeGzOXejtSiOkXaZFAR6yRU0AupS",
+        "AMlxLT6PIzS41NqAHDdiGFXuiamCdQIOGASQTdj1sCAOFh43VxfZGnd1ytKfnj/B",
+        "Yy6/bu6yTT/OXjIIDnirQP2OUqTeWTHdf1xgQGkb+y20Oo3JgJ637j67HuLPrpzs",
+        "jIluqhRszKwVWhGlyTYJdK8nOv2sn+Kn8cEFybmbcytWk9Sxf128+IjTgsEFgEcy",
+        "RS6/UofjKfh9WY+4DK/L7mQgdYwawiRX4y4MkExCusmQxT72mDVGXnSbTYNp2qZl",
+        "WEgFeQECgYEA8cgKGrySiDFxJb900I5O/CL+1pIYXy6K4gDLk70luwjRSWU+ufZo",
+        "g/IRntgk0b0eC4vzP6539hQsh8rrO2swv0vBDG/cvyjP7ljHTx0pFtAjb/yJ9PXN",
+        "ca08G8qx6BX5mqdD46T56V4g5PtLT6cwn5Hth2/H+4MZ/5osP3CbU0UCgYEAvqEJ",
+        "OEOlKMRhxdfb7RnKMwiXUN2vZ0NuGgK0slqEC9FAv1E/XV8azcs40uINrDdieRmr",
+        "Oi+LBXC08FHiAKZOVuxg1DzKx8gDc/R6YGT5sKVhVhKgWsF9ysmCyyqdqnuvFMAd",
+        "7PgS4Nf01rO9jo+cqKBHTzFny0TWZTTAR6NzZ4UCgYEAzqcKs+V/XPbdXcUxg9xO",
+        "eEU1CZLfT+NJA3hoiAMAD8eukgv+PBX3KOeq1diqR7ZbysS4iTKHCAYgNYRj4Gpy",
+        "xN5rx0SJKb4pUvAAkoc7CmumDl6MT5oUGdhWau6pdtPpfpz+csEcdbFlbjG3IgKl",
+        "lY21tq/8/uUEQKq2rRaDO/0CgYAUgC0FqACzCauaI0S7kvJz2pCrWavrZw0ILxJP",
+        "u/xHaRGVgZ9W40t2pkxOIZFm2+3zKBeKAmLpCt3qmmO7vibeoj0nlgIYyiHU7o3a",
+        "oAFaRe7Z2tbz66sji9hNESAznWmOybpuKZ+eHptuG5ZfJoKqf9IrahzHd3e3Gp0z",
+        "FxjqIQKBgQDbHuXgZL8A7pQe+YFUVbXYjhzb+sTlVQD7C4KF0sdiKNKXcXhvcCxL",
+        "AfJu59vnIlhD4MUcxt5lWDBLX08dmcJOX2AryDMmNVC7knNu92IehJeboSaM1+t3",
+        "1V/8pTMTtzg5ANHzZICj6vn46UXCL78XUC3sqZdAm/+9kS+oAnWaIw==",
+        "-----END RSA PRIVATE KEY-----",
+    ].join("\n");
+}
+/**
+ * 读取支付 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;
+}
+//# sourceMappingURL=client.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/payment/providers/waffo/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAUnF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,eAAe,CA0F/F"}

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

@@ -0,0 +1,105 @@
+/**
+ * Waffo Pancake payment provider 工厂。
+ *
+ * 关键说明（中文）
+ * - Waffo 只是 PaymentService 的一个 provider
+ * - 负责声明 env、生成支付方式、创建 Checkout、解析 webhook
+ */
+import { normalizeCurrency, normalizeOptionalText, normalizeRequired, paymentMethodItem, randomId, } from "../../helpers.js";
+import { createWaffoCheckoutSession, createWaffoClient, fallbackWaffoPrivateKey, normalizeWaffoEnvironment, parseWaffoWebhookEvent, readMetadata, } from "./client.js";
+/**
+ * 创建 Waffo Pancake provider。
+ */
+export function waffoPaymentProvider(options = {}) {
+    const label = options.label?.trim() || "Waffo Pancake";
+    return {
+        id: "waffo",
+        label,
+        env: [
+            { key: "WAFFO_MERCHANT_ID", description: "Waffo Merchant ID，例如 MER_xxx", required: true },
+            { key: "WAFFO_PRIVATE_KEY", description: "Waffo API private key，用于 SDK 请求签名", required: true },
+            { key: "WAFFO_PRODUCT_ID", description: "Waffo product_id，用于创建 Checkout Session", required: true },
+            { key: "WAFFO_WEBHOOK_PUBLIC_KEY", description: "Waffo webhook public key，用于校验 x-waffo-signature", required: false },
+            { key: "WAFFO_ENVIRONMENT", description: "Waffo 环境：test 或 prod；默认 test", required: false },
+            { key: "WAFFO_CURRENCY", description: "默认结算币种，例如 usd", required: false },
+            { key: "WAFFO_API_BASE_URL", description: "可选的 Waffo API 基础地址覆写，通常只用于测试环境", required: false },
+        ],
+        method(ctx) {
+            const enabled = Boolean((options.merchant_id || ctx.env("WAFFO_MERCHANT_ID"))
+                && (options.private_key || ctx.env("WAFFO_PRIVATE_KEY"))
+                && (options.product_id || ctx.env("WAFFO_PRODUCT_ID")));
+            return paymentMethodItem({
+                id: "waffo",
+                enabled,
+                label,
+                currency: normalizeCurrency(ctx.env("WAFFO_CURRENCY")) || normalizeCurrency(options.currency) || "usd",
+            });
+        },
+        async createCheckout(input) {
+            const merchant_id = options.merchant_id ?? input.ctx.env("WAFFO_MERCHANT_ID");
+            const private_key = options.private_key ?? input.ctx.env("WAFFO_PRIVATE_KEY");
+            const product_id = options.product_id ?? input.ctx.env("WAFFO_PRODUCT_ID");
+            if (!merchant_id)
+                throw new Error("Waffo merchant id is not configured");
+            if (!private_key)
+                throw new Error("Waffo private key is not configured");
+            if (!product_id)
+                throw new Error("Waffo product id is not configured");
+            const client = createWaffoClient({
+                merchant_id,
+                private_key,
+                webhook_public_key: options.webhook_public_key ?? input.ctx.env("WAFFO_WEBHOOK_PUBLIC_KEY"),
+                api_base_url: options.api_base_url ?? input.ctx.env("WAFFO_API_BASE_URL"),
+            });
+            const created = await createWaffoCheckoutSession(client, {
+                payment_id: input.payment_id,
+                topup: input.topup,
+                product_id,
+                currency: normalizeCurrency(input.ctx.env("WAFFO_CURRENCY")) || normalizeCurrency(options.currency) || "usd",
+                success_url: input.success_url,
+            });
+            return {
+                provider_session_id: created.session_id,
+                checkout_url: created.checkout_url,
+                metadata: { product_id },
+            };
+        },
+        async parseWebhook(input) {
+            const client = createWaffoClient({
+                merchant_id: options.merchant_id ?? input.ctx.env("WAFFO_MERCHANT_ID") ?? "MER_webhook",
+                private_key: options.private_key ?? input.ctx.env("WAFFO_PRIVATE_KEY") ?? fallbackWaffoPrivateKey(),
+                webhook_public_key: options.webhook_public_key ?? input.ctx.env("WAFFO_WEBHOOK_PUBLIC_KEY"),
+                api_base_url: options.api_base_url ?? input.ctx.env("WAFFO_API_BASE_URL"),
+            });
+            const event = parseWaffoWebhookEvent({
+                client,
+                raw: input.raw,
+                signature: input.request.headers.get("x-waffo-signature"),
+                environment: normalizeWaffoEnvironment(input.ctx.env("WAFFO_ENVIRONMENT") || options.environment),
+            });
+            const data = readMetadata(event.data);
+            const metadata = readMetadata(data.orderMetadata);
+            const order_id = normalizeOptionalText(data.orderId);
+            const payment_id = normalizeOptionalText(data.paymentId) || normalizeOptionalText(event.eventId);
+            const type = normalizeOptionalText(event.eventType) || "unknown";
+            return {
+                event_id: normalizeRequired(event.id || event.eventId || `evt_${randomId()}`, "waffo event id"),
+                type,
+                payload: event,
+                status: type === "order.completed" ? "paid" : "ignored",
+                payment_id: normalizeOptionalText(data.orderMerchantExternalId),
+                topup_id: normalizeOptionalText(metadata.topup_id),
+                provider_payment_id: payment_id,
+                provider_order_id: order_id,
+                ref: payment_id || order_id,
+                meta: {
+                    provider: "waffo",
+                    waffo_event_id: normalizeOptionalText(event.id || event.eventId),
+                    waffo_order_id: order_id,
+                    waffo_payment_id: payment_id,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,63 @@
+/**
+ * Waffo provider 内部类型。
+ *
+ * 关键说明（中文）
+ * - 仅供 waffo provider 内部使用
+ * - 对外可见类型（如 WaffoPaymentProviderOptions）放在 payment/types.ts
+ */
+import type { PaymentTopupRecord } from "../../types.js";
+/**
+ * Waffo 运行环境。
+ */
+export type WaffoPaymentEnvironment = "test" | "prod";
+/**
+ * Waffo Checkout API 创建参数。
+ */
+export interface WaffoCreateCheckoutSessionInput {
+    /** 服务内部支付记录 ID。 */
+    payment_id: string;
+    /** 充值单信息。 */
+    topup: PaymentTopupRecord;
+    /** Waffo product_id。 */
+    product_id: string;
+    /** 结算币种。 */
+    currency: string;
+    /** 支付成功跳转地址。 */
+    success_url: string;
+}
+/**
+ * Waffo Checkout API 创建结果。
+ */
+export interface WaffoCheckoutSessionResult {
+    /** Waffo Checkout Session ID。 */
+    session_id: string;
+    /** Waffo Checkout 托管页面 URL。 */
+    checkout_url: string;
+}
+/**
+ * Waffo webhook 事件数据部分。
+ */
+export interface WaffoWebhookEventData extends Record<string, unknown> {
+    /** Waffo 订单 ID。 */
+    orderId?: unknown;
+    /** Waffo 支付 ID。 */
+    paymentId?: unknown;
+    /** 商户提交的订单外部 ID（即 payment_id）。 */
+    orderMerchantExternalId?: unknown;
+    /** 订单 metadata，用于回带 topup_id 等业务字段。 */
+    orderMetadata?: unknown;
+}
+/**
+ * Waffo webhook 事件。
+ */
+export interface WaffoWebhookEvent extends Record<string, unknown> {
+    /** Waffo 事件 ID。 */
+    id?: unknown;
+    /** Waffo 事件 ID 备用字段。 */
+    eventId?: unknown;
+    /** Waffo 事件类型。 */
+    eventType?: unknown;
+    /** Waffo 事件数据。 */
+    data?: WaffoWebhookEventData;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/payment/providers/waffo/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,KAAK,EAAE,kBAAkB,CAAC;IAC1B,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,mBAAmB;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,mBAAmB;IACnB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,wBAAwB;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB;IAClB,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B"}

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/services",
-  "version": "0.1.94",
+  "version": "0.1.101",
   "description": "Downcity public services package for accounts, balance, usage, Stripe, Creem, Dodo, and Waffo payment flows.",
   "type": "module",
   "main": "./bin/index.js",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@waffo/pancake-ts": "^0.11.0",
-    "@downcity/city": "0.2.103",
+    "@downcity/city": "0.2.110",
     "better-auth": "^1.6.12",
     "dodopayments": "^2.36.0",
     "drizzle-orm": "^0.45.2"
@@ -59,7 +59,7 @@
     "build": "rm -rf bin tsconfig.tsbuildinfo && tsc",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
-    "test": "tsc && tsc -p tsconfig.test.json && node --test test/**/*.test.mjs",
+    "test": "tsc && tsc -p tsconfig.test.json && node --test $(find test -name \"*.test.mjs\")",
     "version:patch": "node ../../scripts/bump-package-version.mjs ./package.json"
   }
 }

package/bin/payment/providers.d.ts

@@ -1,25 +0,0 @@
-/**
- * Payment provider 工厂函数。
- *
- * 关键点（中文）
- * - Stripe / Creem / Dodo / Waffo 只是 provider，不是 service。
- * - 每个 provider 实现统一的 PaymentProvider 接口即可被 PaymentService 挂载。
- */
-import type { CreemPaymentProviderOptions, DodoPaymentProviderOptions, PaymentProvider, StripePaymentProviderOptions, WaffoPaymentProviderOptions } from "./types.js";
-/**
- * 创建 Stripe payment provider。
- */
-export declare function stripePaymentProvider(options?: StripePaymentProviderOptions): PaymentProvider;
-/**
- * 创建 Creem payment provider。
- */
-export declare function creemPaymentProvider(options?: CreemPaymentProviderOptions): PaymentProvider;
-/**
- * 创建 Dodo Payments provider。
- */
-export declare function dodoPaymentProvider(options?: DodoPaymentProviderOptions): PaymentProvider;
-/**
- * 创建 Waffo Pancake provider。
- */
-export declare function waffoPaymentProvider(options?: WaffoPaymentProviderOptions): PaymentProvider;
-//# sourceMappingURL=providers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/payment/providers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsCH,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,eAAe,EACf,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,eAAe,CAgFjG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,eAAe,CA+E/F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,eAAe,CA2F7F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,eAAe,CAyF/F"}