@downcity/services 0.1.67 → 0.1.71

package/bin/index.d.ts

@@ -3,23 +3,21 @@
  *
  * 关键说明（中文）
  * - 对外统一暴露 Downcity 官方服务
- * - 保留 accounts / balance / billing / payment / 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 { 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, BalanceCreditsConversion, BalanceCreateRedeemCodeInput, BalanceExtra, BalanceHistoryQuery, BalanceLedgerEntry, BalanceLedgerKind, BalanceRedeemCode, BalanceRedeemCodeIssueResult, BalanceRedeemCodeQuery, BalanceRedeemCodeRedeemResult, BalanceRedeemCodeStatus, BalanceServiceOptions, BalanceTopup, BalanceTopupQuery, BalanceTopupStatus, BalanceUserBalance, } from "./balance/types.js";
+export { balanceAccounts, balanceCharges, balanceLedger, balanceRedeemCodes, balanceTopups } from "./balance/schema.js";
+export { BalanceService } from "./balance/service.js";
+export type { BalanceAccount, BalanceCharge, BalanceChargeInput, BalanceChargeQuery, BalanceChargeStatus, BalanceCreditsConversion, BalanceCreateRedeemCodeInput, BalanceExtra, BalanceHistoryQuery, BalanceLedgerEntry, BalanceLedgerKind, BalanceRedeemCode, BalanceRedeemCodeIssueResult, BalanceRedeemCodeQuery, BalanceRedeemCodeRedeemResult, BalanceRedeemCodeStatus, BalanceServiceOptions, BalanceTopup, BalanceTopupQuery, BalanceTopupStatus, BalanceUserBalance, } from "./balance/types.js";
 export { CREDIT_DECIMAL_PLACES, MICROCREDITS_PER_CREDIT, } from "./types/Amount.js";
 export type { Credits, Microcredits, } from "./types/Amount.js";
-export { billingCharges, billingPricingRules, billingService, BillingService } from "./billing/index.js";
-export type { BillingBalanceBridge, BillingChargeInput, BillingCharge, BillingChargeQuery, BillingChargeStatus, BillingPricingRule, BillingPricingRuleInput, BillingPricingRuleQuery, BillingPricingRuleStatus, BillingServiceOptions, } from "./billing/index.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 { 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, PaymentServiceOptions, PaymentTopupRecord, PaymentStatus, } from "./payment/types.js";
 export type { CreemPaymentProviderOptions, DodoPaymentProviderOptions, StripePaymentProviderOptions, WaffoPaymentProviderOptions, } from "./payment/types.js";
-export { usageEvents, usageService } from "./usage/index.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;;;;;;;;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,wBAAwB,EACxB,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,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzG,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,GACtB,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"}
+{"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,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,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,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,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,EACd,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,GACb,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,16 +3,15 @@
  *
  * 关键说明（中文）
  * - 对外统一暴露 Downcity 官方服务
- * - 保留 accounts / balance / billing / payment / 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 { AccountsService } from "./accounts/index.js";
+export { balanceAccounts, balanceCharges, balanceLedger, balanceRedeemCodes, balanceTopups } from "./balance/schema.js";
+export { BalanceService } from "./balance/service.js";
 export { CREDIT_DECIMAL_PLACES, MICROCREDITS_PER_CREDIT, } from "./types/Amount.js";
-export { billingCharges, billingPricingRules, billingService, BillingService } from "./billing/index.js";
-export { creemPaymentProvider, dodoPaymentProvider, paymentService, stripePaymentProvider, waffoPaymentProvider, } from "./payment/index.js";
-export { usageEvents, usageService } from "./usage/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;;;;;;;;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;AAoBtE,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAczG,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"}
+{"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,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAwBtD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AA2B5B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/bin/payment/helpers.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Payment 子模块通用工具函数。
+ *
+ * 关键点（中文）
+ * - 被 service、routes、providers 共享的纯工具函数集中在这里。
+ * - 不包含任何路由或 provider 特定逻辑。
+ */
+import type { EnvRequirement } from "@downcity/city";
+import type { PaymentMethodItem, PaymentProvider } from "./types.js";
+/**
+ * 校验并去重 provider 列表。
+ */
+export declare function normalizeProviders(providers: PaymentProvider[]): PaymentProvider[];
+/**
+ * 合并 env 配置，按 key 去重。
+ */
+export declare function mergeEnvRequirements(items: EnvRequirement[]): EnvRequirement[];
+/**
+ * 生成标准支付方式返回项。
+ */
+export declare function paymentMethodItem(input: {
+    id: string;
+    enabled: boolean;
+    label: string;
+    currency: string;
+}): PaymentMethodItem;
+/**
+ * 读取对象 ID。
+ */
+export declare function readObjectId(object: Record<string, unknown>): string;
+/**
+ * 读取必填字符串。
+ */
+export declare function normalizeRequired(value: unknown, label: string): string;
+/**
+ * 读取可选字符串。
+ */
+export declare function normalizeOptionalText(value: unknown): string;
+/**
+ * 读取币种字符串。
+ */
+export declare function normalizeCurrency(value: unknown): string;
+/**
+ * 读取错误消息。
+ */
+export declare function errorMessage(error: unknown): string;
+/**
+ * 返回 HTML Response。
+ */
+export declare function htmlResponse(html: string): Response;
+/**
+ * 渲染 payment 重定向结果页。
+ */
+export declare function renderRedirectPage(input: {
+    title: string;
+    heading: string;
+    description: string;
+    request: Request;
+}): string;
+/**
+ * 转义 HTML。
+ */
+export declare function escapeHTML(value: string): string;
+/**
+ * 生成随机 ID（兼容 Node 和 Workers）。
+ */
+export declare function randomId(): string;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/payment/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAUlF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAO9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,iBAAiB,CAYpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEpE;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,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAKnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CA8BT;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAOjC"}

package/bin/payment/helpers.js

@@ -0,0 +1,148 @@
+/**
+ * Payment 子模块通用工具函数。
+ *
+ * 关键点（中文）
+ * - 被 service、routes、providers 共享的纯工具函数集中在这里。
+ * - 不包含任何路由或 provider 特定逻辑。
+ */
+/**
+ * 校验并去重 provider 列表。
+ */
+export function normalizeProviders(providers) {
+    const normalized = [];
+    for (const provider of providers) {
+        if (!provider?.id?.trim())
+            throw new TypeError("payment provider id is required");
+        if (normalized.find((item) => item.id === provider.id)) {
+            throw new TypeError(`Duplicate payment provider: ${provider.id}`);
+        }
+        normalized.push(provider);
+    }
+    return normalized;
+}
+/**
+ * 合并 env 配置，按 key 去重。
+ */
+export function mergeEnvRequirements(items) {
+    const result = [];
+    for (const item of items) {
+        if (result.find((existing) => existing.key === item.key))
+            continue;
+        result.push(item);
+    }
+    return result;
+}
+/**
+ * 生成标准支付方式返回项。
+ */
+export function paymentMethodItem(input) {
+    return {
+        id: input.id,
+        type: "checkout",
+        enabled: input.enabled,
+        label: input.label,
+        service: "payment",
+        action: "checkout/create",
+        requires_user: true,
+        currency: input.currency,
+        reason: input.enabled ? undefined : "not_configured",
+    };
+}
+/**
+ * 读取对象 ID。
+ */
+export function readObjectId(object) {
+    return normalizeOptionalText(object.id);
+}
+/**
+ * 读取必填字符串。
+ */
+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() : "";
+}
+/**
+ * 读取币种字符串。
+ */
+export function normalizeCurrency(value) {
+    return normalizeOptionalText(value).toLowerCase();
+}
+/**
+ * 读取错误消息。
+ */
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * 返回 HTML Response。
+ */
+export function htmlResponse(html) {
+    return new Response(html, {
+        status: 200,
+        headers: { "content-type": "text/html; charset=utf-8" },
+    });
+}
+/**
+ * 渲染 payment 重定向结果页。
+ */
+export function renderRedirectPage(input) {
+    const homeURL = escapeHTML(new URL("/", input.request.url).toString());
+    const title = escapeHTML(input.title);
+    const heading = escapeHTML(input.heading);
+    const description = escapeHTML(input.description);
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${title}</title>
+    <style>
+      :root { color-scheme: light; --bg: #f5f7fb; --card: #fff; --text: #142033; --muted: #5a6a85; --border: #d9e2f1; --accent: #1f6feb; }
+      * { box-sizing: border-box; }
+      body { margin: 0; min-height: 100vh; display: grid; place-items: center; padding: 24px; background: linear-gradient(180deg, #f8fbff 0%, var(--bg) 100%); color: var(--text); font: 16px/1.5 -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
+      main { width: min(100%, 560px); padding: 32px; border: 1px solid var(--border); border-radius: 20px; background: var(--card); box-shadow: 0 18px 60px rgba(16, 24, 40, 0.08); }
+      h1 { margin: 0 0 12px; font-size: 28px; line-height: 1.2; }
+      p { margin: 0; color: var(--muted); }
+      a { display: inline-block; margin-top: 24px; color: #fff; background: var(--accent); text-decoration: none; padding: 12px 16px; border-radius: 999px; font-weight: 600; }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>${heading}</h1>
+      <p>${description}</p>
+      <a href="${homeURL}">Return to Downcity</a>
+    </main>
+  </body>
+</html>`;
+}
+/**
+ * 转义 HTML。
+ */
+export function escapeHTML(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+/**
+ * 生成随机 ID（兼容 Node 和 Workers）。
+ */
+export function randomId() {
+    const buffer = new Uint8Array(12);
+    crypto.getRandomValues(buffer);
+    return btoa(String.fromCharCode(...buffer))
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=+$/u, "");
+}
+//# sourceMappingURL=helpers.js.map

package/bin/payment/helpers.js.map

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

package/bin/payment/index.d.ts

@@ -1,31 +1,13 @@
 /**
- * Downcity 官方 Payment 统一服务。
+ * Payment 子模块公共入口。
  *
- * 关键说明（中文）
- * - payment 是唯一支付服务，Stripe / Creem / Dodo / Waffo 都只是 provider。
- * - 统一负责 checkout、本地支付记录、webhook 幂等、状态同步和 balance 入账。
- * - 所有 provider 共用 `/v1/payment/*` 路由和统一 payments/events 表。
- */
-import type { ServiceDefinition } from "@downcity/city";
-import type { CreemPaymentProviderOptions, DodoPaymentProviderOptions, PaymentProvider, PaymentServiceOptions, StripePaymentProviderOptions, WaffoPaymentProviderOptions } from "./types.js";
-/**
- * 创建统一 Payment 服务。
- */
-export declare function paymentService(options: PaymentServiceOptions): ServiceDefinition;
-/**
- * 创建 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;
+ * 关键点（中文）
+ * - PaymentService class 在 service.ts
+ * - 路由注册逻辑在 routes.ts
+ * - provider 工厂函数在 providers.ts
+ */
+export { PaymentService } from "./service.js";
+export type { PaymentServiceOptions } from "./types.js";
+export { paymentPayments, paymentEvents } from "./schema.js";
+export { creemPaymentProvider, dodoPaymentProvider, stripePaymentProvider, waffoPaymentProvider, } from "./providers.js";
 //# 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,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,CAuOhF;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/payment/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}