@downcity/services 0.1.50 → 0.1.55

package/README.md

@@ -2,7 +2,7 @@
 
 Downcity 官方服务聚合包。
 
-这个包统一提供账号、余额、usage、Stripe 支付与 Creem 支付等官方服务，避免业务侧分别安装多个 `service-*` 包。
+这个包统一提供账号、余额、usage、统一 Payment 与多支付 provider 等官方服务，避免业务侧分别安装多个 `service-*` 包。
 
 ## 安装
 
@@ -16,14 +16,12 @@ pnpm add @downcity/services
 import {
   accountsService,
   balanceService,
-  creemPaymentMethod,
-  creemPaymentService,
+  creemPaymentProvider,
+  dodoPaymentProvider,
   paymentService,
-  stripePaymentMethod,
-  stripePaymentService,
+  stripePaymentProvider,
   usageService,
-  type CreemPaymentServiceBalanceBridge,
-  type StripePaymentServiceBalanceBridge,
+  waffoPaymentProvider,
 } from "@downcity/services";
 ```
 
@@ -36,7 +34,8 @@ const methods = await guest.service("payment").get("methods");
 再根据返回结果调用具体支付方式，例如：
 
 ```ts
-const checkout = await user.service("payment.stripe").action("checkout/create").invoke({
+const checkout = await user.service("payment").action("checkout/create").invoke({
+  method_id: "stripe",
   topup_id: "topup_demo",
 });
 ```
@@ -44,7 +43,8 @@ const checkout = await user.service("payment.stripe").action("checkout/create").
 Creem 支付方式使用同样的调用形态：
 
 ```ts
-const checkout = await user.service("payment.creem").action("checkout/create").invoke({
+const checkout = await user.service("payment").action("checkout/create").invoke({
+  method_id: "creem",
   topup_id: "topup_demo",
 });
 ```
@@ -53,7 +53,6 @@ const checkout = await user.service("payment.creem").action("checkout/create").i
 
 - `accountsService()`：注册、登录、邮箱验证、GitHub/Google OAuth 与 `user_token` 签发
 - `balanceService()`：全局余额账户、流水、充值单与兑换码
-- `paymentService()`：统一暴露当前 City 可用的支付方式列表
+- `paymentService()`：统一暴露支付方式、checkout、webhook、payments 与入账同步
 - `usageService()`：记录真实用户侧 service 调用事件
-- `stripePaymentService()`：把 Stripe 一次性支付同步成 balance topup 到账
-- `creemPaymentService()`：把 Creem 一次性支付同步成 balance topup 到账
+- `stripePaymentProvider()` / `creemPaymentProvider()` / `dodoPaymentProvider()` / `waffoPaymentProvider()`：作为 provider 挂到统一 `paymentService()`

package/bin/index.d.ts

@@ -3,7 +3,8 @@
  *
  * 关键说明（中文）
  * - 对外统一暴露 Downcity 官方服务
- * - 保留 accounts / balance / payment / payment-stripe / usage 五个清晰子模块
+ * - 保留 accounts / balance / payment / usage 四个清晰服务边界
+ * - Stripe / Creem / Dodo / Waffo 统一作为 payment provider 暴露
  * - 业务侧只需要从一个包完成导入
  */
 export { accountsOAuthStates, userProfiles } from "./accounts/schema.js";
@@ -12,13 +13,9 @@ export type { AccountsServiceOptions } from "./accounts/index.js";
 export { balanceAccounts, balanceLedger, balanceRedeemCodes, balanceTopups } from "./balance/schema.js";
 export { BalanceService, balanceService } from "./balance/service.js";
 export type { BalanceAccount, BalanceCreateRedeemCodeInput, BalanceExtra, BalanceHistoryQuery, BalanceLedgerEntry, BalanceLedgerKind, BalanceRedeemCode, BalanceRedeemCodeIssueResult, BalanceRedeemCodeQuery, BalanceRedeemCodeRedeemResult, BalanceRedeemCodeStatus, BalanceServiceOptions, BalanceTopup, BalanceTopupQuery, BalanceTopupStatus, } from "./balance/types.js";
-export { creemPaymentMethod, paymentService, stripePaymentMethod } from "./payment/index.js";
-export type { PaymentMethodDefinition, PaymentMethodItem, PaymentMethodType, PaymentServiceOptions, } from "./payment/types.js";
-export type { CreemPaymentMethodOptions, StripePaymentMethodOptions } from "./payment/types.js";
-export { stripeEvents, stripePayments, stripePaymentService } from "./payment-stripe/index.js";
-export type { StripeCheckoutCreateResult, StripeCreateCheckoutInput, StripeEventRecord, StripeEventSyncStatus, StripePaymentRecord, StripePaymentServiceBalanceBridge, StripePaymentServiceOptions, StripePaymentStatus, StripePaymentTopupRecord, StripeWebhookEvent, } from "./payment-stripe/types.js";
-export { creemEvents, creemPayments, creemPaymentService } from "./payment-creem/index.js";
-export type { CreemCheckoutCreateResult, CreemCreateCheckoutInput, CreemEventRecord, CreemEventSyncStatus, CreemPaymentRecord, CreemPaymentServiceBalanceBridge, CreemPaymentServiceOptions, CreemPaymentStatus, CreemPaymentTopupRecord, CreemWebhookEvent, } from "./payment-creem/types.js";
+export { creemPaymentProvider, dodoPaymentProvider, paymentService, stripePaymentProvider, waffoPaymentProvider, } from "./payment/index.js";
+export type { PaymentCheckoutCreateResult, PaymentCreateCheckoutInput, PaymentEventRecord, PaymentEventSyncStatus, PaymentMethodItem, PaymentMethodReason, PaymentMethodType, PaymentProvider, PaymentProviderCheckoutInput, PaymentProviderCheckoutResult, PaymentProviderContext, PaymentProviderWebhookEvent, PaymentProviderWebhookInput, PaymentRecord, PaymentServiceBalanceBridge, PaymentServiceOptions, PaymentStatus, PaymentTopupRecord, } from "./payment/types.js";
+export type { CreemPaymentProviderOptions, DodoPaymentProviderOptions, StripePaymentProviderOptions, WaffoPaymentProviderOptions, } from "./payment/types.js";
 export { usageEvents, usageService } from "./usage/index.js";
 export type { UsageServiceOptions } from "./usage/index.js";
 //# sourceMappingURL=index.d.ts.map

package/bin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EACV,cAAc,EACd,4BAA4B,EAC5B,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhG,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,iCAAiC,EACjC,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gCAAgC,EAChC,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EACV,cAAc,EACd,4BAA4B,EAC5B,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,aAAa,EACb,2BAA2B,EAC3B,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/index.js

@@ -3,15 +3,14 @@
  *
  * 关键说明（中文）
  * - 对外统一暴露 Downcity 官方服务
- * - 保留 accounts / balance / payment / payment-stripe / usage 五个清晰子模块
+ * - 保留 accounts / balance / payment / usage 四个清晰服务边界
+ * - Stripe / Creem / Dodo / Waffo 统一作为 payment provider 暴露
  * - 业务侧只需要从一个包完成导入
  */
 export { accountsOAuthStates, userProfiles } from "./accounts/schema.js";
 export { AccountsService, accountsService } from "./accounts/index.js";
 export { balanceAccounts, balanceLedger, balanceRedeemCodes, balanceTopups } from "./balance/schema.js";
 export { BalanceService, balanceService } from "./balance/service.js";
-export { creemPaymentMethod, paymentService, stripePaymentMethod } from "./payment/index.js";
-export { stripeEvents, stripePayments, stripePaymentService } from "./payment-stripe/index.js";
-export { creemEvents, creemPayments, creemPaymentService } from "./payment-creem/index.js";
+export { creemPaymentProvider, dodoPaymentProvider, paymentService, stripePaymentProvider, waffoPaymentProvider, } from "./payment/index.js";
 export { usageEvents, usageService } from "./usage/index.js";
 //# sourceMappingURL=index.js.map

package/bin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmBtE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAS7F,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAc/F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAc3F,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmBtE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AA4B5B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/payment/index.d.ts

@@ -1,23 +1,31 @@
 /**
- * Downcity 官方 Payment 服务。
+ * Downcity 官方 Payment 统一服务。
  *
  * 关键说明（中文）
- * - 这是统一的支付入口服务
- * - 当前只负责暴露 methods，让前端知道有哪些支付方式可用
- * - 具体支付链路仍由 `payment.stripe` 之类的具体服务承接
+ * - payment 是唯一支付服务，Stripe / Creem / Dodo / Waffo 都只是 provider。
+ * - 统一负责 checkout、本地支付记录、webhook 幂等、状态同步和 balance 入账。
+ * - 所有 provider 共用 `/v1/payment/*` 路由和统一 payments/events 表。
  */
 import type { ServiceDefinition } from "@downcity/city";
-import type { PaymentMethodDefinition, PaymentServiceOptions, CreemPaymentMethodOptions, StripePaymentMethodOptions } from "./types.js";
+import type { CreemPaymentProviderOptions, DodoPaymentProviderOptions, PaymentProvider, PaymentServiceOptions, StripePaymentProviderOptions, WaffoPaymentProviderOptions } from "./types.js";
 /**
  * 创建统一 Payment 服务。
  */
 export declare function paymentService(options: PaymentServiceOptions): ServiceDefinition;
 /**
- * 生成 Stripe 支付方式定义。
+ * 创建 Stripe payment provider。
  */
-export declare function stripePaymentMethod(options?: StripePaymentMethodOptions): PaymentMethodDefinition;
+export declare function stripePaymentProvider(options?: StripePaymentProviderOptions): PaymentProvider;
 /**
- * 生成 Creem 支付方式定义。
+ * 创建 Creem payment provider。
  */
-export declare function creemPaymentMethod(options?: CreemPaymentMethodOptions): PaymentMethodDefinition;
+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=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EACV,uBAAuB,EAEvB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAuBhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,uBAAuB,CAiBrG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,uBAAuB,CAmBnG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAOxE,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAM1B,eAAe,EAMf,qBAAqB,EAErB,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AA+BpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAwOhF;AAED;;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"}