@mathrunet/masamune_cloudflare_purchase_stripe 3.2.0

package/dist/lib/meter/interface.d.ts

@@ -0,0 +1,109 @@
+/**
+ * A usage event to be recorded as the source of truth for metered billing.
+ *
+ * 従量課金の正本として記録される使用量イベント。
+ */
+export interface StripeUsageEvent {
+    /**
+     * Unique id of the event.
+     *
+     * イベントの一意なID。
+     */
+    id: string;
+    /**
+     * Key identifying the customer on your side (e.g. API key id).
+     *
+     * 自側で顧客を識別するキー（例: APIキーID）。
+     */
+    customerKey: string;
+    /**
+     * The endpoint or feature that consumed the units.
+     *
+     * ユニットを消費したエンドポイントや機能。
+     */
+    endpoint: string;
+    /**
+     * Number of units consumed.
+     *
+     * 消費ユニット数。
+     */
+    units: number;
+    /**
+     * Optional source label of the event.
+     *
+     * イベントのソースラベル（任意）。
+     */
+    source: string | null;
+    /**
+     * Creation time in milliseconds since epoch.
+     *
+     * 作成時刻（エポックからのミリ秒）。
+     */
+    createdAt: number;
+}
+/**
+ * Storage for usage events. The store is the source of truth for billing.
+ *
+ * 使用量イベントのストレージ。課金の正本となる。
+ */
+export interface StripeUsageEventStore {
+    /**
+     * Persist a usage event with `flushed = false`.
+     *
+     * 使用量イベントを未送信状態で永続化します。
+     */
+    insert(event: StripeUsageEvent): Promise<void>;
+    /**
+     * List events not yet flushed to Stripe for the given customer key.
+     *
+     * 指定した顧客キーのStripe未送信イベントを一覧します。
+     */
+    listPending(customerKey: string): Promise<{
+        id: string;
+        units: number;
+    }[]>;
+    /**
+     * Mark the given events as flushed to Stripe.
+     *
+     * 指定したイベントをStripe送信済みとして記録します。
+     */
+    markFlushed(ids: string[]): Promise<void>;
+}
+/**
+ * State of the flush-trigger buffer for a customer.
+ *
+ * 顧客ごとのフラッシュトリガー用バッファの状態。
+ */
+export interface StripeUsageBufferState {
+    /**
+     * Accumulated units since the last flush.
+     *
+     * 前回フラッシュ以降に積み上がったユニット数。
+     */
+    units: number;
+    /**
+     * Time in milliseconds when the buffer window started.
+     *
+     * バッファ窓が開始した時刻（ミリ秒）。
+     */
+    since: number;
+}
+/**
+ * Buffer used only to decide when to flush. Billing accuracy does not depend on it.
+ *
+ * フラッシュタイミングの判定のみに使うバッファ。課金精度はこれに依存しない。
+ */
+export interface StripeUsageBuffer {
+    /**
+     * Get the buffer state for the customer key. Returns `null` if absent or corrupt.
+     *
+     * 顧客キーのバッファ状態を取得します。存在しない・壊れている場合は`null`。
+     */
+    get(customerKey: string): Promise<StripeUsageBufferState | null>;
+    /**
+     * Store the buffer state for the customer key.
+     *
+     * 顧客キーのバッファ状態を保存します。
+     */
+    put(customerKey: string, value: StripeUsageBufferState, ttlSeconds: number): Promise<void>;
+}

package/dist/lib/meter/interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interface.js.map

package/dist/lib/meter/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/lib/meter/interface.ts"],"names":[],"mappings":""}

package/dist/lib/meter/kv_usage_buffer.d.ts

@@ -0,0 +1,56 @@
+import { StripeUsageBuffer, StripeUsageBufferState } from "./interface";
+/**
+ * Minimal structural interface for a KV-like namespace.
+ *
+ * Cloudflare's `KVNamespace` satisfies this without depending on
+ * `@cloudflare/workers-types`.
+ *
+ * KV相当のネームスペースの最小の構造的インターフェース。
+ *
+ * `@cloudflare/workers-types`に依存せずCloudflareの`KVNamespace`が適合します。
+ */
+export interface KVNamespaceLike {
+    /**
+     * Get a JSON value for the key.
+     *
+     * キーに対応するJSON値を取得します。
+     */
+    get(key: string, type: "json"): Promise<unknown | null>;
+    /**
+     * Store a string value for the key.
+     *
+     * キーに対応する文字列値を保存します。
+     */
+    put(key: string, value: string, options?: {
+        expirationTtl?: number | undefined;
+    }): Promise<void>;
+}
+/**
+ * [StripeUsageBuffer] backed by Cloudflare KV.
+ *
+ * Cloudflare KVを用いた[StripeUsageBuffer]。
+ */
+export declare class KVUsageBuffer implements StripeUsageBuffer {
+    /**
+     * [StripeUsageBuffer] backed by Cloudflare KV.
+     *
+     * Cloudflare KVを用いた[StripeUsageBuffer]。
+     */
+    constructor(kv: KVNamespaceLike, options?: {
+        prefix?: string | undefined;
+    });
+    private readonly _kv;
+    private readonly _prefix;
+    /**
+     * Get the buffer state for the customer key. Returns `null` if absent or corrupt.
+     *
+     * 顧客キーのバッファ状態を取得します。存在しない・壊れている場合は`null`。
+     */
+    get(customerKey: string): Promise<StripeUsageBufferState | null>;
+    /**
+     * Store the buffer state for the customer key.
+     *
+     * 顧客キーのバッファ状態を保存します。
+     */
+    put(customerKey: string, value: StripeUsageBufferState, ttlSeconds: number): Promise<void>;
+}

package/dist/lib/meter/kv_usage_buffer.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KVUsageBuffer = void 0;
+/**
+ * [StripeUsageBuffer] backed by Cloudflare KV.
+ *
+ * Cloudflare KVを用いた[StripeUsageBuffer]。
+ */
+class KVUsageBuffer {
+    /**
+     * [StripeUsageBuffer] backed by Cloudflare KV.
+     *
+     * Cloudflare KVを用いた[StripeUsageBuffer]。
+     */
+    constructor(kv, options = {}) {
+        this._kv = kv;
+        this._prefix = options.prefix ?? "usage:";
+    }
+    _kv;
+    _prefix;
+    /**
+     * Get the buffer state for the customer key. Returns `null` if absent or corrupt.
+     *
+     * 顧客キーのバッファ状態を取得します。存在しない・壊れている場合は`null`。
+     */
+    async get(customerKey) {
+        try {
+            const stored = await this._kv.get(`${this._prefix}${customerKey}`, "json");
+            if (stored && typeof stored === "object") {
+                return stored;
+            }
+        }
+        catch {
+            // ignore corrupt buffer
+        }
+        return null;
+    }
+    /**
+     * Store the buffer state for the customer key.
+     *
+     * 顧客キーのバッファ状態を保存します。
+     */
+    async put(customerKey, value, ttlSeconds) {
+        await this._kv.put(`${this._prefix}${customerKey}`, JSON.stringify(value), {
+            expirationTtl: ttlSeconds,
+        });
+    }
+}
+exports.KVUsageBuffer = KVUsageBuffer;
+//# sourceMappingURL=kv_usage_buffer.js.map

package/dist/lib/meter/kv_usage_buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv_usage_buffer.js","sourceRoot":"","sources":["../../../src/lib/meter/kv_usage_buffer.ts"],"names":[],"mappings":";;;AAgCA;;;;GAIG;AACH,MAAa,aAAa;IACtB;;;;OAIG;IACH,YAAY,EAAmB,EAAE,UAA2C,EAAE;QAC1E,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;IAC9C,CAAC;IAEgB,GAAG,CAAkB;IACrB,OAAO,CAAS;IAEjC;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,WAAmB;QACzB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;YAC3E,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACvC,OAAO,MAAgC,CAAC;YAC5C,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,wBAAwB;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,WAAmB,EAAE,KAA6B,EAAE,UAAkB;QAC5E,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,WAAW,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;YACvE,aAAa,EAAE,UAAU;SAC5B,CAAC,CAAC;IACP,CAAC;CACJ;AAzCD,sCAyCC"}

package/dist/lib/meter/record_usage.d.ts

@@ -0,0 +1,29 @@
+import { StripeUsageBuffer, StripeUsageEventStore } from "./interface";
+import { StripeMeterClient } from "./stripe_meter_client";
+/**
+ * Record a usage event and flush to Stripe when the buffer is full or aged.
+ *
+ * The store (e.g. D1) is the source of truth. The buffer (e.g. KV) only decides
+ * flush timing — eventual-consistency races there never affect billing.
+ * When a flush fails the buffer is kept so the next request retries immediately;
+ * unsent units remain pending in the store and are sent together next time.
+ *
+ * 使用量イベントを記録し、バッファが満杯または時間経過でStripeへフラッシュします。
+ *
+ * 正本はストア（例: D1）。バッファ（例: KV）はフラッシュタイミングの判定のみで、
+ * 結果整合の競合があっても課金には影響しません。フラッシュ失敗時はバッファを残して
+ * 次のリクエストで即再送させます。未送信分はストアに残り、次回まとめて送られます。
+ */
+export declare function recordUsage(options: {
+    store: StripeUsageEventStore;
+    buffer: StripeUsageBuffer;
+    client: StripeMeterClient;
+    customerKey: string;
+    stripeCustomerId: string | null | undefined;
+    endpoint: string;
+    units?: number | undefined;
+    source?: string | undefined;
+    flushUnits?: number | undefined;
+    flushMs?: number | undefined;
+    bufferTtlSeconds?: number | undefined;
+}): Promise<void>;

package/dist/lib/meter/record_usage.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordUsage = recordUsage;
+const flush_meter_1 = require("./flush_meter");
+/**
+ * Record a usage event and flush to Stripe when the buffer is full or aged.
+ *
+ * The store (e.g. D1) is the source of truth. The buffer (e.g. KV) only decides
+ * flush timing — eventual-consistency races there never affect billing.
+ * When a flush fails the buffer is kept so the next request retries immediately;
+ * unsent units remain pending in the store and are sent together next time.
+ *
+ * 使用量イベントを記録し、バッファが満杯または時間経過でStripeへフラッシュします。
+ *
+ * 正本はストア（例: D1）。バッファ（例: KV）はフラッシュタイミングの判定のみで、
+ * 結果整合の競合があっても課金には影響しません。フラッシュ失敗時はバッファを残して
+ * 次のリクエストで即再送させます。未送信分はストアに残り、次回まとめて送られます。
+ */
+async function recordUsage(options) {
+    const units = options.units ?? 1;
+    const flushUnits = options.flushUnits ?? 10;
+    const flushMs = options.flushMs ?? 60_000;
+    const bufferTtlSeconds = options.bufferTtlSeconds ?? 3600;
+    try {
+        await options.store.insert({
+            id: crypto.randomUUID(),
+            customerKey: options.customerKey,
+            endpoint: options.endpoint,
+            units: units,
+            source: options.source ?? null,
+            createdAt: Date.now(),
+        });
+    }
+    catch (error) {
+        console.warn("usage insert failed", error);
+        return;
+    }
+    let buffer = { units: 0, since: Date.now() };
+    try {
+        const stored = await options.buffer.get(options.customerKey);
+        if (stored && typeof stored === "object") {
+            buffer = stored;
+        }
+    }
+    catch {
+        // ignore corrupt buffer
+    }
+    buffer.units += units;
+    const aged = Date.now() - buffer.since >= flushMs;
+    const full = buffer.units >= flushUnits;
+    await options.buffer.put(options.customerKey, buffer, bufferTtlSeconds);
+    if (!full && !aged) {
+        return;
+    }
+    let flushed = false;
+    try {
+        flushed = await (0, flush_meter_1.flushStripeMeter)({
+            store: options.store,
+            client: options.client,
+            customerKey: options.customerKey,
+            stripeCustomerId: options.stripeCustomerId,
+        });
+    }
+    catch (error) {
+        console.warn("stripe meter flush error", error);
+    }
+    if (!flushed) {
+        return;
+    }
+    await options.buffer.put(options.customerKey, { units: 0, since: Date.now() }, bufferTtlSeconds);
+}
+//# sourceMappingURL=record_usage.js.map

package/dist/lib/meter/record_usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record_usage.js","sourceRoot":"","sources":["../../../src/lib/meter/record_usage.ts"],"names":[],"mappings":";;AAkBA,kCAoEC;AArFD,+CAAiD;AAGjD;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,WAAW,CAAC,OAYjC;IACG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC;IAC1C,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAE1D,IAAI,CAAC;QACD,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;YACvB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO;IACX,CAAC;IAED,IAAI,MAAM,GAA2B,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACrE,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,GAAG,MAAM,CAAC;QACpB,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,wBAAwB;IAC5B,CAAC;IACD,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC;IACxC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAExE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO;IACX,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,CAAC;QACD,OAAO,GAAG,MAAM,IAAA,8BAAgB,EAAC;YAC7B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC7C,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO;IACX,CAAC;IACD,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CACpB,OAAO,CAAC,WAAW,EACnB,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAC/B,gBAAgB,CACnB,CAAC;AACN,CAAC"}

package/dist/lib/meter/stripe_meter_client.d.ts

@@ -0,0 +1,76 @@
+import Stripe from "stripe";
+/**
+ * Options for [StripeMeterClient].
+ *
+ * [StripeMeterClient]のオプション。
+ */
+export interface StripeMeterClientOptions {
+    /**
+     * Stripe secret key. When empty the client is disabled and sends nothing.
+     *
+     * Stripeのシークレットキー。空の場合クライアントは無効となり何も送信しません。
+     */
+    secretKey?: string | undefined;
+    /**
+     * Meter event name registered on Stripe (billing meters, basil or later).
+     *
+     * Stripeに登録したMeterイベント名（billing meters、basil以降）。
+     */
+    eventName: string;
+    /**
+     * Fetch implementation used by the Stripe SDK's fetch HTTP client.
+     * Defaults to the global `fetch`. Inject for tests.
+     *
+     * Stripe SDKのfetch HTTPクライアントが使用するfetch実装。
+     * デフォルトはグローバル`fetch`。テスト時に注入します。
+     */
+    fetch?: typeof fetch | undefined;
+    /**
+     * Stripe SDK client instance. When specified, `secretKey` / `fetch` are not
+     * used to construct a client.
+     *
+     * Stripe SDKのクライアントインスタンス。指定した場合`secretKey` / `fetch`は
+     * クライアント生成に使用されません。
+     */
+    stripeClient?: Stripe | undefined;
+}
+/**
+ * Client for the Stripe Meter Event API (`/v1/billing/meter_events`).
+ *
+ * Uses the Stripe SDK with the fetch HTTP client so it works on Cloudflare
+ * Workers.
+ *
+ * Stripe Meter Event API（`/v1/billing/meter_events`）用のクライアント。
+ *
+ * Cloudflare Workersで動作するようfetch HTTPクライアント付きのStripe SDKを
+ * 使用します。
+ */
+export declare class StripeMeterClient {
+    /**
+     * Client for the Stripe Meter Event API (`/v1/billing/meter_events`).
+     *
+     * Stripe Meter Event API（`/v1/billing/meter_events`）用のクライアント。
+     */
+    constructor(options: StripeMeterClientOptions);
+    private readonly _secretKey;
+    private readonly _eventName;
+    private readonly _fetch;
+    private _client;
+    /**
+     * Whether the client can send meter events.
+     *
+     * Meterイベントを送信できる状態かどうか。
+     */
+    get enabled(): boolean;
+    private get client();
+    /**
+     * Send one meter event. Returns `false` when Stripe responds with an error.
+     *
+     * Meterイベントを1件送信します。Stripeがエラーを返した場合は`false`を返します。
+     */
+    sendMeterEvent(options: {
+        stripeCustomerId: string;
+        value: number;
+        identifier: string;
+    }): Promise<boolean>;
+}

package/dist/lib/meter/stripe_meter_client.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripeMeterClient = void 0;
+const stripe_client_1 = require("../stripe_client");
+/**
+ * Client for the Stripe Meter Event API (`/v1/billing/meter_events`).
+ *
+ * Uses the Stripe SDK with the fetch HTTP client so it works on Cloudflare
+ * Workers.
+ *
+ * Stripe Meter Event API（`/v1/billing/meter_events`）用のクライアント。
+ *
+ * Cloudflare Workersで動作するようfetch HTTPクライアント付きのStripe SDKを
+ * 使用します。
+ */
+class StripeMeterClient {
+    /**
+     * Client for the Stripe Meter Event API (`/v1/billing/meter_events`).
+     *
+     * Stripe Meter Event API（`/v1/billing/meter_events`）用のクライアント。
+     */
+    constructor(options) {
+        this._secretKey = options.secretKey ?? "";
+        this._eventName = options.eventName;
+        this._fetch = options.fetch;
+        this._client = options.stripeClient;
+    }
+    _secretKey;
+    _eventName;
+    _fetch;
+    _client;
+    /**
+     * Whether the client can send meter events.
+     *
+     * Meterイベントを送信できる状態かどうか。
+     */
+    get enabled() {
+        return (this._client !== undefined || this._secretKey.length > 0) && this._eventName.length > 0;
+    }
+    get client() {
+        if (!this._client) {
+            this._client = (0, stripe_client_1.createStripeClient)({
+                secretKey: this._secretKey,
+                fetch: this._fetch,
+            });
+        }
+        return this._client;
+    }
+    /**
+     * Send one meter event. Returns `false` when Stripe responds with an error.
+     *
+     * Meterイベントを1件送信します。Stripeがエラーを返した場合は`false`を返します。
+     */
+    async sendMeterEvent(options) {
+        try {
+            await this.client.billing.meterEvents.create({
+                event_name: this._eventName,
+                identifier: options.identifier,
+                payload: {
+                    stripe_customer_id: options.stripeCustomerId,
+                    value: String(options.value),
+                },
+            });
+            return true;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.warn("stripe meter flush failed", message.slice(0, 240));
+            return false;
+        }
+    }
+}
+exports.StripeMeterClient = StripeMeterClient;
+//# sourceMappingURL=stripe_meter_client.js.map

package/dist/lib/meter/stripe_meter_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe_meter_client.js","sourceRoot":"","sources":["../../../src/lib/meter/stripe_meter_client.ts"],"names":[],"mappings":";;;AACA,oDAAsD;AAyCtD;;;;;;;;;;GAUG;AACH,MAAa,iBAAiB;IAC1B;;;;OAIG;IACH,YAAY,OAAiC;QACzC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IACxC,CAAC;IAEgB,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,MAAM,CAA2B;IAC1C,OAAO,CAAqB;IAEpC;;;;OAIG;IACH,IAAI,OAAO;QACP,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACpG,CAAC;IAED,IAAY,MAAM;QACd,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,GAAG,IAAA,kCAAkB,EAAC;gBAC9B,SAAS,EAAE,IAAI,CAAC,UAAU;gBAC1B,KAAK,EAAE,IAAI,CAAC,MAAM;aACrB,CAAC,CAAC;QACP,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,OAIpB;QACG,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;gBACzC,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,OAAO,EAAE;oBACL,kBAAkB,EAAE,OAAO,CAAC,gBAAgB;oBAC5C,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;iBAC/B;aACJ,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACjE,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;CACJ;AA/DD,8CA+DC"}

package/dist/lib/options.d.ts

@@ -0,0 +1,179 @@
+import Stripe from "stripe";
+import { Context } from "hono";
+import { WorkersOptions } from "@mathrunet/masamune_cloudflare/dist/lib/src/workers_base";
+import { D1StripePurchaseStoreOptions } from "./purchase/d1_purchase_store";
+import { StripePurchaseStore } from "./purchase/interface";
+/**
+ * Email content sent for 3D Secure authentication.
+ *
+ * 3Dセキュア認証用に送信するメールの内容。
+ */
+export interface StripePurchaseEmail {
+    /**
+     * Sender's email address.
+     *
+     * 送信元メールアドレス。
+     */
+    from: string;
+    /**
+     * Email address to be sent to.
+     *
+     * 送信先メールアドレス。
+     */
+    to: string;
+    /**
+     * Email title.
+     *
+     * メールタイトル。
+     */
+    subject: string;
+    /**
+     * Email content.
+     *
+     * メール本文。
+     */
+    text: string;
+}
+/**
+ * Options for the Stripe purchase workers.
+ *
+ * Stripe課金ワーカーのオプション。
+ */
+export interface StripePurchaseWorkersOptions extends WorkersOptions {
+    /**
+     * Stripe secret key.
+     *
+     * If not specified, it is resolved from the `PURCHASE_STRIPE_SECRETKEY` environment variable (Workers secret).
+     *
+     * Stripeのシークレットキー。
+     *
+     * 指定されていない場合は`PURCHASE_STRIPE_SECRETKEY`環境変数（Workersシークレット）から解決されます。
+     */
+    secretKey?: string | undefined;
+    /**
+     * Meter event name registered on Stripe (billing meters, basil or later).
+     *
+     * If not specified, it is resolved from the `PURCHASE_STRIPE_METER_EVENT_NAME` environment variable.
+     *
+     * Stripeに登録したMeterイベント名（billing meters、basil以降）。
+     *
+     * 指定されていない場合は`PURCHASE_STRIPE_METER_EVENT_NAME`環境変数から解決されます。
+     */
+    meterEventName?: string | undefined;
+    /**
+     * Signing secret for the main Stripe webhook.
+     *
+     * If not specified, it is resolved from the `PURCHASE_STRIPE_WEBHOOKSECRET` environment variable (Workers secret).
+     *
+     * StripeメインWebhookの署名シークレット。
+     *
+     * 指定されていない場合は`PURCHASE_STRIPE_WEBHOOKSECRET`環境変数（Workersシークレット）から解決されます。
+     */
+    webhookSecret?: string | undefined;
+    /**
+     * Signing secret for the Stripe Connect webhook.
+     *
+     * If not specified, it is resolved from the `PURCHASE_STRIPE_WEBHOOKCONNECTSECRET` environment variable (Workers secret).
+     *
+     * Stripe Connect用Webhookの署名シークレット。
+     *
+     * 指定されていない場合は`PURCHASE_STRIPE_WEBHOOKCONNECTSECRET`環境変数（Workersシークレット）から解決されます。
+     */
+    webhookConnectSecret?: string | undefined;
+    /**
+     * Purchase data store factory. Defaults to [D1StripePurchaseStore] on the D1
+     * binding named by [d1Binding] (default `DB`).
+     *
+     * 購入データストアのファクトリ。デフォルトは[d1Binding]（既定`DB`）で指定した
+     * D1バインディング上の[D1StripePurchaseStore]。
+     */
+    store?: ((context: Context) => StripePurchaseStore) | undefined;
+    /**
+     * Name of the D1 binding used by the default store. Defaults to `DB`.
+     *
+     * デフォルトストアが使用するD1バインディング名。デフォルトは`DB`。
+     */
+    d1Binding?: string | undefined;
+    /**
+     * Table name options for the default [D1StripePurchaseStore].
+     *
+     * デフォルトの[D1StripePurchaseStore]のテーブル名オプション。
+     */
+    tables?: D1StripePurchaseStoreOptions | undefined;
+    /**
+     * Resolve the email address of an application user (parity with
+     * `admin.auth().getUser()` in the Firebase implementation). When not
+     * specified, the `email` field of the stored user document and the billing
+     * details of the default payment method are used as fallbacks.
+     *
+     * アプリケーションユーザーのメールアドレスを解決します（Firebase実装の
+     * `admin.auth().getUser()`相当）。未指定の場合は保存済みユーザードキュメントの
+     * `email`フィールドとデフォルト支払い方法のbilling detailsをフォールバックとして
+     * 使用します。
+     */
+    resolveUserEmail?: ((context: Context, userId: string) => Promise<string | null | undefined>) | undefined;
+    /**
+     * Send an email for 3D Secure authentication. When not specified, the
+     * provider resolved from `PURCHASE_STRIPE_EMAILPROVIDER` (default
+     * `sendgrid`, using the `MAIL_SENDGRID_APIKEY` Workers secret) is used.
+     *
+     * 3Dセキュア認証用のメールを送信します。未指定の場合は
+     * `PURCHASE_STRIPE_EMAILPROVIDER`（既定`sendgrid`、`MAIL_SENDGRID_APIKEY`の
+     * Workersシークレットを使用）から解決したプロバイダーを使用します。
+     */
+    sendEmail?: ((context: Context, email: StripePurchaseEmail) => Promise<void>) | undefined;
+    /**
+     * Stripe SDK client factory. Defaults to [createStripeClient] with the
+     * resolved secret key. Inject for tests.
+     *
+     * Stripe SDKクライアントのファクトリ。デフォルトは解決したシークレットキー
+     * を用いた[createStripeClient]。テスト時に注入します。
+     */
+    stripeClient?: ((context: Context, secretKey: string) => Stripe) | undefined;
+}
+/**
+ * Resolve the Stripe SDK client from options and the resolved secret key.
+ *
+ * オプションと解決済みシークレットキーからStripe SDKクライアントを解決します。
+ */
+export declare function resolveStripeClient(context: Context, options: StripePurchaseWorkersOptions, secretKey: string): Stripe;
+/**
+ * Resolve the Stripe secret key from options and `context.env`.
+ *
+ * オプションと`context.env`からStripeのシークレットキーを解決します。
+ */
+export declare function resolveStripeSecretKey(context: Context, options: StripePurchaseWorkersOptions): string;
+/**
+ * Resolve the Stripe meter event name from options and `context.env`.
+ *
+ * オプションと`context.env`からStripeのMeterイベント名を解決します。
+ */
+export declare function resolveStripeMeterEventName(context: Context, options: StripePurchaseWorkersOptions): string | undefined;
+/**
+ * Resolve the main webhook signing secret from options and `context.env`.
+ *
+ * オプションと`context.env`からメインWebhookの署名シークレットを解決します。
+ */
+export declare function resolveStripeWebhookSecret(context: Context, options: StripePurchaseWorkersOptions): string;
+/**
+ * Resolve the Connect webhook signing secret from options and `context.env`.
+ *
+ * オプションと`context.env`からConnect用Webhookの署名シークレットを解決します。
+ */
+export declare function resolveStripeWebhookConnectSecret(context: Context, options: StripePurchaseWorkersOptions): string;
+/**
+ * Resolve the purchase data store from options and `context.env`.
+ *
+ * オプションと`context.env`から購入データストアを解決します。
+ */
+export declare function resolveStripePurchaseStore(context: Context, options: StripePurchaseWorkersOptions): StripePurchaseStore;
+/**
+ * Resolve the email sender from options and `context.env`.
+ *
+ * Returns `null` when no provider is configured.
+ *
+ * オプションと`context.env`からメール送信手段を解決します。
+ *
+ * プロバイダーが未設定の場合は`null`を返します。
+ */
+export declare function resolveStripeEmailSender(context: Context, options: StripePurchaseWorkersOptions): ((email: StripePurchaseEmail) => Promise<void>) | null;