@downcity/services 0.1.6

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

@@ -0,0 +1,378 @@
+/**
+ * Stripe 一次性充值服务数据库 schema。
+ *
+ * 关键说明（中文）
+ * - 本服务只管理 Stripe 支付侧事实，不直接维护余额账本
+ * - 真正的钱包账户、充值单与流水仍然由 balance 服务负责
+ * - 这里的表只负责记录 Stripe 支付映射与 webhook 事件
+ */
+/**
+ * Stripe 支付记录表。
+ *
+ * 关键说明（中文）
+ * - 一条记录对应一次 topup 的 Stripe 支付尝试
+ * - `topup_id` 连接 balance 服务里的充值单
+ * - `checkout_url` 允许前端重试取回已创建的 Checkout 链接
+ */
+export declare const stripePayments: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "service_stripe_payments";
+    schema: undefined;
+    columns: {
+        payment_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "payment_id";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        topup_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "topup_id";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "user_id";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        stripe_checkout_session_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "stripe_checkout_session_id";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        stripe_payment_intent_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "stripe_payment_intent_id";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        amount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "amount";
+            tableName: "service_stripe_payments";
+            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;
+        }, {}, {}>;
+        currency: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "currency";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        checkout_url: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "checkout_url";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        metadata_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "metadata_json";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        updated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "service_stripe_payments";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;
+/**
+ * Stripe webhook 事件表。
+ *
+ * 关键说明（中文）
+ * - `event_id` 作为 webhook 幂等键
+ * - `sync_status` 用于区分已应用、忽略和失败的事件
+ */
+export declare const stripeEvents: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "service_stripe_events";
+    schema: undefined;
+    columns: {
+        event_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "event_id";
+            tableName: "service_stripe_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        type: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "type";
+            tableName: "service_stripe_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        payload_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "payload_json";
+            tableName: "service_stripe_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        sync_status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "sync_status";
+            tableName: "service_stripe_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        sync_error: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "sync_error";
+            tableName: "service_stripe_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "service_stripe_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/payment-stripe/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAazB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOvB,CAAC"}

package/bin/payment-stripe/schema.js

@@ -0,0 +1,47 @@
+/**
+ * Stripe 一次性充值服务数据库 schema。
+ *
+ * 关键说明（中文）
+ * - 本服务只管理 Stripe 支付侧事实，不直接维护余额账本
+ * - 真正的钱包账户、充值单与流水仍然由 balance 服务负责
+ * - 这里的表只负责记录 Stripe 支付映射与 webhook 事件
+ */
+import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+/**
+ * Stripe 支付记录表。
+ *
+ * 关键说明（中文）
+ * - 一条记录对应一次 topup 的 Stripe 支付尝试
+ * - `topup_id` 连接 balance 服务里的充值单
+ * - `checkout_url` 允许前端重试取回已创建的 Checkout 链接
+ */
+export const stripePayments = sqliteTable("service_stripe_payments", {
+    payment_id: text("payment_id").primaryKey(),
+    topup_id: text("topup_id").notNull(),
+    user_id: text("user_id").notNull(),
+    stripe_checkout_session_id: text("stripe_checkout_session_id").notNull(),
+    stripe_payment_intent_id: text("stripe_payment_intent_id").notNull(),
+    amount: integer("amount").notNull(),
+    currency: text("currency").notNull(),
+    status: text("status").notNull(),
+    checkout_url: text("checkout_url").notNull(),
+    metadata_json: text("metadata_json").notNull(),
+    created_at: text("created_at").notNull(),
+    updated_at: text("updated_at").notNull(),
+});
+/**
+ * Stripe webhook 事件表。
+ *
+ * 关键说明（中文）
+ * - `event_id` 作为 webhook 幂等键
+ * - `sync_status` 用于区分已应用、忽略和失败的事件
+ */
+export const stripeEvents = sqliteTable("service_stripe_events", {
+    event_id: text("event_id").primaryKey(),
+    type: text("type").notNull(),
+    payload_json: text("payload_json").notNull(),
+    sync_status: text("sync_status").notNull(),
+    sync_error: text("sync_error").notNull(),
+    created_at: text("created_at").notNull(),
+});
+//# sourceMappingURL=schema.js.map

package/bin/payment-stripe/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/payment-stripe/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC,yBAAyB,EAAE;IACnE,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE;IAC3C,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACpC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,0BAA0B,EAAE,IAAI,CAAC,4BAA4B,CAAC,CAAC,OAAO,EAAE;IACxE,wBAAwB,EAAE,IAAI,CAAC,0BAA0B,CAAC,CAAC,OAAO,EAAE;IACpE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IACnC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACpC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC5C,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE;IAC9C,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACxC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CACzC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC,uBAAuB,EAAE;IAC/D,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE;IACvC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC5C,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IAC1C,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACxC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CACzC,CAAC,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * Stripe HTTP / webhook 工具函数。
+ *
+ * 关键说明（中文）
+ * - 不直接依赖 Stripe SDK，统一走官方 HTTP API
+ * - 创建 Checkout 使用 form-urlencoded，兼容 Node 与 Worker
+ * - webhook 验签继续使用 Web Crypto API
+ */
+import type { StripeCheckoutSessionResult, StripeCreateCheckoutSessionInput, StripeWebhookEvent } from "./types.js";
+/**
+ * 规范化 Stripe API 基础地址。
+ */
+export declare function normalizeStripeApiBaseURL(value: string | undefined): string;
+/**
+ * 创建 Stripe Checkout Session。
+ */
+export declare function createStripeCheckoutSession(secretKey: string, apiBaseURL: string, input: StripeCreateCheckoutSessionInput): Promise<StripeCheckoutSessionResult>;
+/**
+ * 解析 Stripe webhook 事件。
+ */
+export declare function parseStripeWebhookEvent(raw: string): StripeWebhookEvent;
+/**
+ * 验证 Stripe webhook 签名。
+ */
+export declare function verifyStripeSignature(raw: string, header: string | null, secret: string): Promise<boolean>;
+/**
+ * 规范化非空字符串。
+ */
+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>;
+//# sourceMappingURL=stripe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../src/payment-stripe/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAC3B,gCAAgC,EAChC,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3E;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,2BAA2B,CAAC,CA2CtC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAGvE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BhH;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"}

package/bin/payment-stripe/stripe.js

@@ -0,0 +1,129 @@
+/**
+ * Stripe HTTP / webhook 工具函数。
+ *
+ * 关键说明（中文）
+ * - 不直接依赖 Stripe SDK，统一走官方 HTTP API
+ * - 创建 Checkout 使用 form-urlencoded，兼容 Node 与 Worker
+ * - webhook 验签继续使用 Web Crypto API
+ */
+/**
+ * 规范化 Stripe API 基础地址。
+ */
+export function normalizeStripeApiBaseURL(value) {
+    const normalized = String(value ?? "https://api.stripe.com/v1").trim();
+    if (!normalized)
+        throw new TypeError("Stripe API server URL is required");
+    return normalized.replace(/\/+$/, "");
+}
+/**
+ * 创建 Stripe Checkout Session。
+ */
+export async function createStripeCheckoutSession(secretKey, apiBaseURL, input) {
+    const body = new URLSearchParams();
+    body.set("mode", "payment");
+    body.set("success_url", input.success_url);
+    body.set("cancel_url", input.cancel_url);
+    body.set("client_reference_id", input.topup.topup_id);
+    body.set("metadata[payment_id]", input.payment_id);
+    body.set("metadata[topup_id]", input.topup.topup_id);
+    body.set("metadata[user_id]", input.topup.user_id);
+    body.set("line_items[0][price_data][currency]", input.currency);
+    body.set("line_items[0][price_data][product_data][name]", input.item_name);
+    body.set("line_items[0][price_data][unit_amount]", String(input.topup.amount));
+    body.set("line_items[0][quantity]", "1");
+    body.set("payment_intent_data[metadata][payment_id]", input.payment_id);
+    body.set("payment_intent_data[metadata][topup_id]", input.topup.topup_id);
+    body.set("payment_intent_data[metadata][user_id]", input.topup.user_id);
+    const response = await fetch(`${normalizeStripeApiBaseURL(apiBaseURL)}/checkout/sessions`, {
+        method: "POST",
+        headers: {
+            authorization: `Bearer ${normalizeRequired(secretKey, "Stripe secret key")}`,
+            "content-type": "application/x-www-form-urlencoded",
+        },
+        body,
+    });
+    const payload = await readJSONRecord(response);
+    if (!response.ok) {
+        const message = String((payload.error && typeof payload.error === "object" ? payload.error.message : "") ||
+            payload.message ||
+            "Stripe checkout session creation failed").trim();
+        throw new Error(message || "Stripe checkout session creation failed");
+    }
+    const sessionId = normalizeRequired(payload.id, "Stripe checkout session id");
+    const checkoutURL = normalizeRequired(payload.url, "Stripe checkout session url");
+    return {
+        session_id: sessionId,
+        checkout_url: checkoutURL,
+        payment_intent_id: normalizeOptionalText(payload.payment_intent),
+    };
+}
+/**
+ * 解析 Stripe webhook 事件。
+ */
+export function parseStripeWebhookEvent(raw) {
+    const parsed = JSON.parse(raw || "{}");
+    return parsed && typeof parsed === "object" ? parsed : {};
+}
+/**
+ * 验证 Stripe webhook 签名。
+ */
+export async function verifyStripeSignature(raw, header, secret) {
+    const parts = Object.fromEntries(String(header ?? "").split(",").map((part) => {
+        const [key, value] = part.split("=");
+        return [key, value];
+    }));
+    const timestamp = parts.t;
+    const signature = parts.v1;
+    if (!timestamp || !signature)
+        return false;
+    const encoder = new TextEncoder();
+    const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const signed = await crypto.subtle.sign("HMAC", key, encoder.encode(`${timestamp}.${raw}`));
+    const expected = Array.from(new Uint8Array(signed))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+    if (signature.length !== expected.length)
+        return false;
+    let result = 0;
+    for (let index = 0; index < signature.length; index++) {
+        result |= signature.charCodeAt(index) ^ expected.charCodeAt(index);
+    }
+    return result === 0;
+}
+/**
+ * 规范化非空字符串。
+ */
+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
+        : {};
+}
+/**
+ * 读取 JSON 响应并兜底为空对象。
+ */
+async function readJSONRecord(response) {
+    const text = await response.text();
+    try {
+        const parsed = JSON.parse(text || "{}");
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return { message: text };
+    }
+}
+//# sourceMappingURL=stripe.js.map

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

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