@downcity/services 0.1.6

package/bin/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @downcity/services 统一公共入口。
+ *
+ * 关键说明（中文）
+ * - 对外统一暴露 Downcity 官方服务
+ * - 保留 accounts / balance / payment / payment-stripe / usage 五个清晰子模块
+ * - 业务侧只需要从一个包完成导入
+ */
+export { accountsOAuthStates, userProfiles } from "./accounts/schema.js";
+export { AccountsService, accountsService } from "./accounts/index.js";
+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 { paymentService, stripePaymentMethod } from "./payment/index.js";
+export type { PaymentMethodDefinition, PaymentMethodItem, PaymentMethodType, PaymentServiceOptions, } from "./payment/types.js";
+export type { 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 { usageEvents, usageService } from "./usage/index.js";
+export type { UsageServiceOptions } from "./usage/index.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/index.d.ts.map

@@ -0,0 +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,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAErE,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,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/index.js

@@ -0,0 +1,16 @@
+/**
+ * @downcity/services 统一公共入口。
+ *
+ * 关键说明（中文）
+ * - 对外统一暴露 Downcity 官方服务
+ * - 保留 accounts / balance / payment / payment-stripe / usage 五个清晰子模块
+ * - 业务侧只需要从一个包完成导入
+ */
+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 { paymentService, stripePaymentMethod } from "./payment/index.js";
+export { stripeEvents, stripePayments, stripePaymentService } from "./payment-stripe/index.js";
+export { usageEvents, usageService } from "./usage/index.js";
+//# sourceMappingURL=index.js.map

package/bin/index.js.map

@@ -0,0 +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,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AASzE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAc/F,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/payment/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Downcity 官方 Payment 服务。
+ *
+ * 关键说明（中文）
+ * - 这是统一的支付入口服务
+ * - 当前只负责暴露 methods，让前端知道有哪些支付方式可用
+ * - 具体支付链路仍由 `payment.stripe` 之类的具体服务承接
+ */
+import type { ServiceDefinition } from "@downcity/infra";
+import type { PaymentMethodDefinition, PaymentServiceOptions, StripePaymentMethodOptions } from "./types.js";
+/**
+ * 创建统一 Payment 服务。
+ */
+export declare function paymentService(options: PaymentServiceOptions): ServiceDefinition;
+/**
+ * 生成 Stripe 支付方式定义。
+ */
+export declare function stripePaymentMethod(options?: StripePaymentMethodOptions): PaymentMethodDefinition;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EACV,uBAAuB,EAEvB,qBAAqB,EACrB,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"}

package/bin/payment/index.js

@@ -0,0 +1,63 @@
+/**
+ * Downcity 官方 Payment 服务。
+ *
+ * 关键说明（中文）
+ * - 这是统一的支付入口服务
+ * - 当前只负责暴露 methods，让前端知道有哪些支付方式可用
+ * - 具体支付链路仍由 `payment.stripe` 之类的具体服务承接
+ */
+/**
+ * 创建统一 Payment 服务。
+ */
+export function paymentService(options) {
+    return {
+        id: "payment",
+        name: "Payment",
+        version: "0.1.0",
+        instruction: [
+            "统一暴露当前 InfraRuntime 可用的支付方式列表。",
+            "前端应该先读取 methods，再决定展示哪种支付入口。",
+            "具体支付动作仍然由具体服务处理，例如 payment.stripe。",
+        ].join("\n"),
+        install(ctx) {
+            ctx.route({
+                method: "GET",
+                path: "/methods",
+                auth: [],
+                async handler(requestCtx) {
+                    return requestCtx.jsonResponse({
+                        items: options.methods.map((method) => method.resolve(ctx)),
+                    });
+                },
+            });
+        },
+    };
+}
+/**
+ * 生成 Stripe 支付方式定义。
+ */
+export function stripePaymentMethod(options = {}) {
+    return {
+        resolve(ctx) {
+            const enabled = Boolean(options.secret_key || ctx.env("STRIPE_SECRET_KEY"));
+            return {
+                id: "stripe",
+                type: "checkout",
+                enabled,
+                label: options.label?.trim() || "Stripe",
+                service: "payment.stripe",
+                action: "checkout/create",
+                requires_user: true,
+                currency: normalizeCurrency(ctx.env("STRIPE_CURRENCY")) || normalizeCurrency(options.currency) || "usd",
+                reason: enabled ? undefined : "not_configured",
+            };
+        },
+    };
+}
+/**
+ * 统一规范化币种。
+ */
+function normalizeCurrency(value) {
+    return String(value ?? "").trim().toLowerCase();
+}
+//# sourceMappingURL=index.js.map

package/bin/payment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,OAAO;QACL,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE;YACX,gCAAgC;YAChC,8BAA8B;YAC9B,oCAAoC;SACrC,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,OAAO,CAAC,GAAG;YACT,GAAG,CAAC,KAAK,CAAC;gBACR,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,EAAE;gBACR,KAAK,CAAC,OAAO,CAAC,UAAU;oBACtB,OAAO,UAAU,CAAC,YAAY,CAAC;wBAC7B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;qBAC5D,CAAC,CAAC;gBACL,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAsC,EAAE;IAC1E,OAAO;QACL,OAAO,CAAC,GAAG;YACT,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAC5E,OAAO;gBACL,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,UAAU;gBAChB,OAAO;gBACP,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,QAAQ;gBACxC,OAAO,EAAE,gBAAgB;gBACzB,MAAM,EAAE,iBAAiB;gBACzB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK;gBACvG,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB;aAC/C,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClD,CAAC"}

package/bin/payment/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Payment 服务对外类型定义。
+ *
+ * 关键说明（中文）
+ * - `payment` 是统一支付入口，只负责暴露“当前有哪些支付方式”
+ * - 具体执行动作仍然由具体服务承接，例如 `payment.stripe`
+ * - 前端可以先读 methods，再决定展示哪种充值/支付入口
+ */
+/**
+ * 支付方式展示模式。
+ */
+export type PaymentMethodType = "checkout";
+/**
+ * 单个支付方式返回项。
+ */
+export interface PaymentMethodItem {
+    /**
+     * 支付方式唯一标识。
+     *
+     * 例如：`stripe`
+     */
+    id: string;
+    /**
+     * 支付方式模式。
+     *
+     * 当前版本统一使用 `checkout`，表示需要创建支付会话再跳转。
+     */
+    type: PaymentMethodType;
+    /**
+     * 当前 InfraRuntime 是否实际开放该支付方式。
+     */
+    enabled: boolean;
+    /**
+     * 展示给前端的支付方式名称。
+     */
+    label: string;
+    /**
+     * 发起支付时应调用的 service id。
+     *
+     * 例如：`payment.stripe`
+     */
+    service: string;
+    /**
+     * 发起支付时应调用的 action id。
+     *
+     * 例如：`checkout/create`
+     */
+    action: string;
+    /**
+     * 是否要求用户先登录再发起支付。
+     */
+    requires_user: boolean;
+    /**
+     * 当前默认结算币种。
+     */
+    currency: string;
+    /**
+     * 未启用原因。
+     */
+    reason?: "not_configured" | "not_supported";
+}
+/**
+ * 单个支付方式定义。
+ *
+ * 关键说明（中文）
+ * - `payment` 服务内部会在请求时解析这些定义
+ * - 这样每种 method 可以根据 runtime env 动态决定是否启用
+ */
+export interface PaymentMethodDefinition {
+    /**
+     * 生成当前支付方式的展示结果。
+     */
+    resolve(ctx: {
+        env(key: string): string | undefined;
+    }): PaymentMethodItem;
+}
+/**
+ * Payment 服务配置。
+ */
+export interface PaymentServiceOptions {
+    /**
+     * 当前 InfraRuntime 挂载的支付方式列表。
+     */
+    methods: PaymentMethodDefinition[];
+}
+/**
+ * Stripe 支付方式配置。
+ */
+export interface StripePaymentMethodOptions {
+    /**
+     * 显式注入的 Stripe Secret Key。
+     *
+     * 未传入时会回退读取 runtime env 中的 `STRIPE_SECRET_KEY`。
+     */
+    secret_key?: string;
+    /**
+     * 默认结算币种。
+     *
+     * 未传入时会回退读取 runtime env 中的 `STRIPE_CURRENCY`，最终默认 `usd`。
+     */
+    currency?: string;
+    /**
+     * 可选展示名称。
+     */
+    label?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/payment/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,iBAAiB,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/bin/payment/types.js

@@ -0,0 +1,10 @@
+/**
+ * Payment 服务对外类型定义。
+ *
+ * 关键说明（中文）
+ * - `payment` 是统一支付入口，只负责暴露“当前有哪些支付方式”
+ * - 具体执行动作仍然由具体服务承接，例如 `payment.stripe`
+ * - 前端可以先读 methods，再决定展示哪种充值/支付入口
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/payment/types.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * Downcity Stripe 一次性充值服务。
+ *
+ * 关键说明（中文）
+ * - 当前版本只处理 Stripe 一次性充值
+ * - 不处理 entitlement，也不处理 subscription
+ * - 支付成功后统一调用 balance.finishTopup() 完成到账
+ */
+import type { ServiceDefinition } from "@downcity/infra";
+import type { StripePaymentServiceOptions } from "./types.js";
+export { stripeEvents, stripePayments } from "./schema.js";
+export type { StripeCheckoutCreateResult, StripePaymentServiceBalanceBridge, StripeCreateCheckoutInput, StripeEventRecord, StripeEventSyncStatus, StripePaymentServiceOptions, StripePaymentRecord, StripePaymentStatus, } from "./types.js";
+/**
+ * 创建 Stripe 一次性充值服务。
+ */
+export declare function stripePaymentService(options: StripePaymentServiceOptions): ServiceDefinition;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment-stripe/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,iBAAiB,CAAC;AAWzE,OAAO,KAAK,EAKV,2BAA2B,EAI5B,MAAM,YAAY,CAAC;AAkFpB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EACV,0BAA0B,EAC1B,iCAAiC,EACjC,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,iBAAiB,CA2N5F"}