@downcity/services 0.1.50 → 0.1.55

package/bin/payment-creem/types.d.ts

@@ -90,14 +90,6 @@ export interface CreemPaymentServiceOptions {
      * 未传入时会读取 City env 中的 `CREEM_WEBHOOK_SECRET`。
      */
     webhook_secret?: string;
-    /**
-     * 默认支付成功跳转地址。
-     *
-     * 当 `checkout/create` 未显式传入 `success_url` 时使用。
-     * 如果这里也未配置，服务会继续尝试基于 `DOWNCITY_CITY_BASE_URL`
-     * 自动生成默认结果页地址。
-     */
-    success_url?: string;
     /**
      * 默认结算币种。
      *
@@ -120,17 +112,6 @@ export interface CreemCreateCheckoutInput extends Record<string, unknown> {
      * 对应的 balance topup ID。
      */
     topup_id: string;
-    /**
-     * 可选支付成功跳转地址。
-     */
-    success_url?: string;
-    /**
-     * 可选支付取消跳转地址。
-     *
-     * 当前 Creem Checkout API 不消费该字段；这里保留是为了前端在多支付方式
-     * checkout 入参里可以复用同一结构。
-     */
-    cancel_url?: string;
 }
 /**
  * Creem Checkout 创建结果。

package/bin/payment-creem/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/payment-creem/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/payment-creem/types.ts"],"names":[],"mappings":"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"}

package/bin/payment-dodo/dodo.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Dodo Payments SDK 工具函数。
+ *
+ * 关键说明（中文）
+ * - 创建 Checkout 使用官方 `dodopayments` SDK
+ * - webhook 验签使用 SDK 自带 standardwebhooks unwrap
+ * - 这里集中做字符串归一化和 SDK 响应裁剪
+ */
+import DodoPayments from "dodopayments";
+import type { DodoPaymentEnvironment, DodoPaymentTopupRecord, DodoWebhookEvent } from "./types.js";
+/**
+ * Dodo Checkout API 创建参数。
+ */
+export interface DodoCreateCheckoutSessionInput {
+    /**
+     * 服务内部支付记录 ID。
+     */
+    payment_id: string;
+    /**
+     * 充值单信息。
+     */
+    topup: DodoPaymentTopupRecord;
+    /**
+     * 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 SDK client。
+ */
+export declare function createDodoClient(input: {
+    /**
+     * Dodo API key。
+     */
+    api_key: string;
+    /**
+     * webhook signing key。
+     */
+    webhook_key?: string;
+    /**
+     * SDK 运行环境。
+     */
+    environment: DodoPaymentEnvironment;
+    /**
+     * 可选 API 基础地址。
+     */
+    api_base_url?: string;
+}): DodoPayments;
+/**
+ * 创建 Dodo Checkout Session。
+ */
+export declare function createDodoCheckoutSession(client: DodoPayments, input: DodoCreateCheckoutSessionInput): Promise<DodoCheckoutSessionResult>;
+/**
+ * 解析并可选校验 Dodo webhook。
+ */
+export declare function parseDodoWebhookEvent(input: {
+    /**
+     * Dodo SDK client。
+     */
+    client: DodoPayments;
+    /**
+     * 原始请求 body。
+     */
+    raw: string;
+    /**
+     * 请求头。
+     */
+    headers: Headers;
+    /**
+     * 是否执行验签。
+     */
+    verify: boolean;
+}): DodoWebhookEvent;
+/**
+ * 规范化非空字符串。
+ */
+export declare function normalizeRequired(value: unknown, label: string): string;
+/**
+ * 规范化可选字符串。
+ */
+export declare function normalizeOptionalText(value: unknown): string;
+/**
+ * 规范化 metadata 对象。
+ */
+export declare function readMetadata(value: unknown): Record<string, unknown>;
+/**
+ * 规范化 Dodo 运行环境。
+ */
+export declare function normalizeDodoEnvironment(value: unknown): DodoPaymentEnvironment;
+//# sourceMappingURL=dodo.d.ts.map

package/bin/payment-dodo/dodo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dodo.d.ts","sourceRoot":"","sources":["../../src/payment-dodo/dodo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,YAAY,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,EAAE,sBAAsB,CAAC;IAE9B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,sBAAsB,CAAC;IAEpC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,YAAY,CAOf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,yBAAyB,CAAC,CAwBpC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,gBAAgB,CAKnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAM/E"}

package/bin/payment-dodo/dodo.js

@@ -0,0 +1,93 @@
+/**
+ * Dodo Payments SDK 工具函数。
+ *
+ * 关键说明（中文）
+ * - 创建 Checkout 使用官方 `dodopayments` SDK
+ * - webhook 验签使用 SDK 自带 standardwebhooks unwrap
+ * - 这里集中做字符串归一化和 SDK 响应裁剪
+ */
+import DodoPayments from "dodopayments";
+/**
+ * 创建 Dodo SDK client。
+ */
+export function createDodoClient(input) {
+    const apiBaseURL = normalizeOptionalText(input.api_base_url);
+    return new DodoPayments({
+        bearerToken: normalizeRequired(input.api_key, "Dodo API key"),
+        webhookKey: normalizeOptionalText(input.webhook_key) || null,
+        ...(apiBaseURL ? { baseURL: apiBaseURL } : { environment: input.environment }),
+    });
+}
+/**
+ * 创建 Dodo Checkout Session。
+ */
+export async function createDodoCheckoutSession(client, input) {
+    const response = await client.checkoutSessions.create({
+        product_cart: [{
+                product_id: input.product_id,
+                quantity: 1,
+                amount: input.topup.amount,
+            }],
+        billing_currency: input.currency.toUpperCase(),
+        return_url: input.return_url,
+        cancel_url: input.cancel_url,
+        metadata: {
+            payment_id: input.payment_id,
+            topup_id: input.topup.topup_id,
+            user_id: input.topup.user_id,
+            amount: String(input.topup.amount),
+            unit: input.topup.unit,
+        },
+    });
+    return {
+        checkout_session_id: normalizeRequired(response.session_id, "Dodo checkout session id"),
+        dodo_payment_id: normalizeOptionalText(response.payment_id),
+        checkout_url: normalizeRequired(response.checkout_url, "Dodo checkout url"),
+    };
+}
+/**
+ * 解析并可选校验 Dodo webhook。
+ */
+export function parseDodoWebhookEvent(input) {
+    const event = input.verify
+        ? input.client.webhooks.unwrap(input.raw, { headers: Object.fromEntries(input.headers.entries()) })
+        : input.client.webhooks.unsafeUnwrap(input.raw);
+    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 对象。
+ */
+export function readMetadata(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+/**
+ * 规范化 Dodo 运行环境。
+ */
+export function normalizeDodoEnvironment(value) {
+    const normalized = normalizeOptionalText(value);
+    if (normalized === "live_mode" || normalized === "test_mode")
+        return normalized;
+    if (normalized === "live")
+        return "live_mode";
+    if (normalized === "test")
+        return "test_mode";
+    return "test_mode";
+}
+//# sourceMappingURL=dodo.js.map

package/bin/payment-dodo/dodo.js.map

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

package/bin/payment-dodo/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Downcity Dodo Payments 一次性充值服务。
+ *
+ * 关键说明（中文）
+ * - 当前版本只处理 Dodo Checkout 一次性充值
+ * - 不处理 entitlement，也不处理 subscription
+ * - 支付成功后统一调用 balance.finishTopup() 完成到账
+ */
+import type { ServiceDefinition } from "@downcity/city";
+import type { DodoPaymentServiceOptions } from "./types.js";
+export { dodoEvents, dodoPayments } from "./schema.js";
+export type { DodoCheckoutCreateResult, DodoCreateCheckoutInput, DodoEventRecord, DodoEventSyncStatus, DodoPaymentEnvironment, DodoPaymentRecord, DodoPaymentServiceBalanceBridge, DodoPaymentServiceOptions, DodoPaymentStatus, DodoPaymentTopupRecord, DodoWebhookEvent, } from "./types.js";
+/**
+ * 创建 Dodo Payments 一次性充值服务。
+ */
+export declare function dodoPaymentService(options: DodoPaymentServiceOptions): ServiceDefinition;
+//# sourceMappingURL=index.d.ts.map

package/bin/payment-dodo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment-dodo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAYxE,OAAO,KAAK,EAMV,yBAAyB,EAG1B,MAAM,YAAY,CAAC;AAuEpB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,+BAA+B,EAC/B,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,iBAAiB,CA8NxF"}