@downcity/services 0.1.67 → 0.1.71

package/bin/{billing → payment}/service.d.ts

@@ -1,28 +1,28 @@
 /**
- * Downcity 官方 Billing 服务实现。
+ * Downcity 官方 Payment 统一服务。
  *
- * 设计边界：
- * - usage 负责记录事实，billing 负责把事实换算成 charge
- * - balance 负责真正的钱包扣减与流水
- * - pricing rule 使用 microcredits，1 credit = 1 USD = 1_000_000 microcredits
+ * 关键点（中文）
+ * - payment 是唯一支付服务，Stripe / Creem / Dodo / Waffo 都只是 provider。
+ * - 统一负责 checkout、本地支付记录、webhook 幂等、状态同步和 balance 入账。
+ * - 所有 provider 共用 `/v1/payment/*` 路由和统一 payments/events 表。
  */
-import { InstallableService, type Context, type ServiceInstallContext } from "@downcity/city";
-import type { BillingCharge, BillingChargeInput, BillingChargeQuery, BillingPricingRule, BillingPricingRuleInput, BillingPricingRuleQuery, BillingServiceOptions } from "./types.js";
+import { InstallableService, type ServiceInstallContext } from "@downcity/city";
+import type { PaymentProvider, PaymentServiceOptions } from "./types.js";
 /**
- * Billing 服务实例。
+ * 统一 Payment 服务。
  */
-export declare class BillingService extends InstallableService {
-    readonly id = "billing";
-    readonly name = "Billing";
-    readonly version = "0.1.0";
+export declare class PaymentService extends InstallableService {
+    readonly id = "payment";
+    readonly name = "Payment";
+    readonly version = "0.2.0";
     readonly schema: {
-        pricing_rules: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
-            name: "service_billing_pricing_rules";
+        payments: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+            name: "service_payment_payments";
             schema: undefined;
             columns: {
-                rule_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "rule_id";
-                    tableName: "service_billing_pricing_rules";
+                payment_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "payment_id";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -39,9 +39,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                service_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "service_id";
-                    tableName: "service_billing_pricing_rules";
+                provider: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "provider";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -58,9 +58,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                action_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "action_id";
-                    tableName: "service_billing_pricing_rules";
+                topup_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "topup_id";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -77,9 +77,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                model_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "model_id";
-                    tableName: "service_billing_pricing_rules";
+                user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "user_id";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -96,9 +96,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                provider_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "provider_id";
-                    tableName: "service_billing_pricing_rules";
+                provider_session_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "provider_session_id";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -115,145 +115,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                request_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "request_microcredits";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                input_token_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "input_token_microcredits";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                input_mtoken_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "input_mtoken_microcredits";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                output_token_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "output_token_microcredits";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                output_mtoken_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "output_mtoken_microcredits";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                cached_token_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "cached_token_microcredits";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                cached_mtoken_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "cached_mtoken_microcredits";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                image_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "image_microcredits";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "status";
-                    tableName: "service_billing_pricing_rules";
+                provider_payment_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "provider_payment_id";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -270,9 +134,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                note: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "note";
-                    tableName: "service_billing_pricing_rules";
+                provider_order_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "provider_order_id";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -289,28 +153,26 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "created_at";
-                    tableName: "service_billing_pricing_rules";
-                    dataType: "string";
-                    columnType: "SQLiteText";
-                    data: string;
-                    driverParam: string;
+                amount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "amount";
+                    tableName: "service_payment_payments";
+                    dataType: "number";
+                    columnType: "SQLiteInteger";
+                    data: number;
+                    driverParam: number;
                     notNull: true;
                     hasDefault: false;
                     isPrimaryKey: false;
                     isAutoincrement: false;
                     hasRuntimeDefault: false;
-                    enumValues: [string, ...string[]];
+                    enumValues: undefined;
                     baseColumn: never;
                     identity: undefined;
                     generated: undefined;
-                }, {}, {
-                    length: number | undefined;
-                }>;
-                updated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "updated_at";
-                    tableName: "service_billing_pricing_rules";
+                }, {}, {}>;
+                currency: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "currency";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -327,23 +189,16 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-            };
-            dialect: "sqlite";
-        }>;
-        charges: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
-            name: "service_billing_charges";
-            schema: undefined;
-            columns: {
-                charge_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "charge_id";
-                    tableName: "service_billing_charges";
+                status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "status";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
                     driverParam: string;
                     notNull: true;
                     hasDefault: false;
-                    isPrimaryKey: true;
+                    isPrimaryKey: false;
                     isAutoincrement: false;
                     hasRuntimeDefault: false;
                     enumValues: [string, ...string[]];
@@ -353,9 +208,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "user_id";
-                    tableName: "service_billing_charges";
+                checkout_url: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "checkout_url";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -372,9 +227,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                town_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "town_id";
-                    tableName: "service_billing_charges";
+                metadata_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "metadata_json";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -391,9 +246,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                service_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "service_id";
-                    tableName: "service_billing_charges";
+                created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "created_at";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -410,9 +265,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                action_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "action_id";
-                    tableName: "service_billing_charges";
+                updated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "updated_at";
+                    tableName: "service_payment_payments";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -429,16 +284,23 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                model_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "model_id";
-                    tableName: "service_billing_charges";
+            };
+            dialect: "sqlite";
+        }>;
+        events: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+            name: "service_payment_events";
+            schema: undefined;
+            columns: {
+                event_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "event_id";
+                    tableName: "service_payment_events";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
                     driverParam: string;
                     notNull: true;
                     hasDefault: false;
-                    isPrimaryKey: false;
+                    isPrimaryKey: true;
                     isAutoincrement: false;
                     hasRuntimeDefault: false;
                     enumValues: [string, ...string[]];
@@ -448,9 +310,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                provider_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "provider_id";
-                    tableName: "service_billing_charges";
+                provider: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "provider";
+                    tableName: "service_payment_events";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -467,9 +329,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                rule_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "rule_id";
-                    tableName: "service_billing_charges";
+                type: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "type";
+                    tableName: "service_payment_events";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -486,26 +348,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                amount_microcredits: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "amount_microcredits";
-                    tableName: "service_billing_charges";
-                    dataType: "number";
-                    columnType: "SQLiteInteger";
-                    data: number;
-                    driverParam: number;
-                    notNull: true;
-                    hasDefault: false;
-                    isPrimaryKey: false;
-                    isAutoincrement: false;
-                    hasRuntimeDefault: false;
-                    enumValues: undefined;
-                    baseColumn: never;
-                    identity: undefined;
-                    generated: undefined;
-                }, {}, {}>;
-                status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "status";
-                    tableName: "service_billing_charges";
+                payload_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "payload_json";
+                    tableName: "service_payment_events";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -522,9 +367,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                note: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "note";
-                    tableName: "service_billing_charges";
+                sync_status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "sync_status";
+                    tableName: "service_payment_events";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -541,9 +386,9 @@ export declare class BillingService extends InstallableService {
                 }, {}, {
                     length: number | undefined;
                 }>;
-                metadata_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
-                    name: "metadata_json";
-                    tableName: "service_billing_charges";
+                sync_error: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+                    name: "sync_error";
+                    tableName: "service_payment_events";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -562,7 +407,7 @@ export declare class BillingService extends InstallableService {
                 }>;
                 created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
                     name: "created_at";
-                    tableName: "service_billing_charges";
+                    tableName: "service_payment_events";
                     dataType: "string";
                     columnType: "SQLiteText";
                     data: string;
@@ -583,45 +428,21 @@ export declare class BillingService extends InstallableService {
             dialect: "sqlite";
         }>;
     };
-    private readonly balance;
-    private readonly initialRules;
-    private readonly requireBeforeCall;
-    constructor(options: BillingServiceOptions);
-    _onInit(): Promise<void>;
+    private readonly options;
+    private readonly providers;
+    constructor(options: PaymentServiceOptions);
     install(ctx: ServiceInstallContext): void;
     /**
-     * 新增或更新 pricing rule。
+     * 读取充值单。
      */
-    upsertPricingRule(input: BillingPricingRuleInput): Promise<BillingPricingRule>;
+    readTopup(topup_id: string): Promise<import("./types.js").PaymentTopupRecord>;
     /**
-     * 列出 pricing rules。
+     * 完成充值并入账。
      */
-    listPricingRules(query?: BillingPricingRuleQuery): Promise<BillingPricingRule[]>;
+    finishTopup(topup_id: string, extra?: Record<string, unknown>): Promise<import("./types.js").PaymentTopupRecord>;
     /**
-     * 列出 charge。
+     * 获取已挂载的 provider 列表。
      */
-    listCharges(query?: BillingChargeQuery): Promise<BillingCharge[]>;
-    /**
-     * 对当前 service 调用执行结算。
-     */
-    settle(ctx: Context): Promise<BillingCharge | undefined>;
-    /**
-     * 显式扣费。
-     *
-     * 关键说明（中文）
-     * - AI Provider 可以自行完成 usage 与价格换算，然后通过 AIService 调用这里。
-     * - Billing 只负责扣余额和记录账单，不理解 provider 内部 usage 结构。
-     */
-    charge(input: BillingChargeInput): Promise<BillingCharge | undefined>;
-    private createCharge;
-    private resolvePricingRule;
-    private readPricingRule;
-    private readPricingRuleRequired;
-    private ensurePricingRuleColumns;
-    private resolveRaw;
+    getProviders(): PaymentProvider[];
 }
-/**
- * 创建 Billing 服务实例。
- */
-export declare function billingService(options: BillingServiceOptions): BillingService;
 //# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/payment/service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAuB,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAIrG,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAazE;;GAEG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAGb;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAElC,OAAO,EAAE,qBAAqB;IAe1C,OAAO,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI;IAIzC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM;IAI1B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI7D;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;CAGlC"}

package/bin/payment/service.js

@@ -0,0 +1,72 @@
+/**
+ * Downcity 官方 Payment 统一服务。
+ *
+ * 关键点（中文）
+ * - payment 是唯一支付服务，Stripe / Creem / Dodo / Waffo 都只是 provider。
+ * - 统一负责 checkout、本地支付记录、webhook 幂等、状态同步和 balance 入账。
+ * - 所有 provider 共用 `/v1/payment/*` 路由和统一 payments/events 表。
+ */
+import { InstallableService } from "@downcity/city";
+import { paymentEvents, paymentPayments } from "./schema.js";
+import { mergeEnvRequirements, normalizeProviders } from "./helpers.js";
+import { installPaymentRoutes } from "./routes.js";
+/**
+ * Payment 服务自身 env。
+ */
+const paymentEnv = [
+    {
+        key: "DOWNCITY_CITY_BASE_URL",
+        description: "City 对外访问地址；用于自动生成统一 payment 结果页地址",
+        required: false,
+    },
+];
+/**
+ * 统一 Payment 服务。
+ */
+export class PaymentService extends InstallableService {
+    id = "payment";
+    name = "Payment";
+    version = "0.2.0";
+    schema = {
+        payments: paymentPayments,
+        events: paymentEvents,
+    };
+    options;
+    providers;
+    constructor(options) {
+        const providers = normalizeProviders(options.providers);
+        super(mergeEnvRequirements([
+            ...paymentEnv,
+            ...providers.flatMap((provider) => provider.env),
+        ]));
+        this.options = options;
+        this.providers = providers;
+        this.instruction = [
+            "统一支付服务。Stripe、Creem、Dodo、Waffo 都作为 provider 挂载。",
+            "前端先读取 /methods，再通过 /checkout/create 创建对应 provider 的 checkout。",
+            "所有 provider 共用 /webhook、/payments、/events 和统一 payment 表。",
+        ].join("\n");
+    }
+    install(ctx) {
+        installPaymentRoutes(this, ctx);
+    }
+    /**
+     * 读取充值单。
+     */
+    readTopup(topup_id) {
+        return this.options.readTopup(topup_id);
+    }
+    /**
+     * 完成充值并入账。
+     */
+    finishTopup(topup_id, extra) {
+        return this.options.finishTopup(topup_id, extra);
+    }
+    /**
+     * 获取已挂载的 provider 列表。
+     */
+    getProviders() {
+        return this.providers;
+    }
+}
+//# sourceMappingURL=service.js.map

package/bin/payment/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/payment/service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAmD,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD;;GAEG;AACH,MAAM,UAAU,GAAqB;IACnC;QACE,GAAG,EAAE,wBAAwB;QAC7B,WAAW,EAAE,oCAAoC;QACjD,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,kBAAkB;IAC3C,EAAE,GAAG,SAAS,CAAC;IACf,IAAI,GAAG,SAAS,CAAC;IACjB,OAAO,GAAG,OAAO,CAAC;IAClB,MAAM,GAAG;QAChB,QAAQ,EAAE,eAAe;QACzB,MAAM,EAAE,aAAa;KACtB,CAAC;IAEe,OAAO,CAAwB;IAC/B,SAAS,CAAoB;IAE9C,YAAY,OAA8B;QACxC,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxD,KAAK,CAAC,oBAAoB,CAAC;YACzB,GAAG,UAAU;YACb,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;SACjD,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG;YACjB,iDAAiD;YACjD,+DAA+D;YAC/D,0DAA0D;SAC3D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO,CAAC,GAA0B;QAChC,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAgB,EAAE,KAA+B;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}