@mathrunet/masamune_cloudflare_purchase_stripe 3.2.0

package/src/lib/stripe_client.ts

@@ -0,0 +1,76 @@
+import Stripe from "stripe";
+
+/**
+ * Stripe API version used across this package (parity with
+ * `@mathrunet/masamune_firebase_purchase_stripe`).
+ *
+ * このパッケージ全体で使用するStripe APIバージョン
+ * （`@mathrunet/masamune_firebase_purchase_stripe`と同一）。
+ */
+export const STRIPE_API_VERSION = "2025-02-24.acacia";
+
+/**
+ * Options for [createStripeClient].
+ *
+ * [createStripeClient]のオプション。
+ */
+export interface CreateStripeClientOptions {
+    /**
+     * Stripe secret key.
+     *
+     * Stripeのシークレットキー。
+     */
+    secretKey: string;
+
+    /**
+     * Fetch implementation. Defaults to the global `fetch`. Inject for tests.
+     *
+     * fetch実装。デフォルトはグローバル`fetch`。テスト時に注入します。
+     */
+    fetch?: typeof fetch | undefined;
+}
+
+/**
+ * Create a Stripe SDK client configured for Cloudflare Workers.
+ *
+ * Uses the fetch-based HTTP client so the SDK works without Node.js APIs.
+ *
+ * Cloudflare Workers用に構成したStripe SDKクライアントを作成します。
+ *
+ * fetchベースのHTTPクライアントを使うためNode.js APIなしで動作します。
+ */
+export function createStripeClient(options: CreateStripeClientOptions): Stripe {
+    // 空キーだとSDKコンストラクタが例外を投げ、Webhook署名検証のような
+    // APIキー不要の処理まで実行できなくなるためプレースホルダを渡す。
+    // 実際のAPI呼び出しはStripe側の認証エラーとして返る。
+    return new Stripe(options.secretKey || "sk_not_configured", {
+        apiVersion: STRIPE_API_VERSION,
+        httpClient: Stripe.createFetchHttpClient(options.fetch),
+    });
+}
+
+/**
+ * Verify a Stripe webhook signature and construct the event.
+ *
+ * Uses `constructEventAsync` with the SubtleCrypto provider because the
+ * synchronous variant is not available on Cloudflare Workers.
+ *
+ * StripeのWebhook署名を検証しイベントを構築します。
+ *
+ * 同期版はCloudflare Workersで使用できないため、SubtleCryptoプロバイダ付きの
+ * `constructEventAsync`を使用します。
+ */
+export async function constructStripeEvent(options: {
+    client: Stripe,
+    payload: string,
+    signature: string,
+    secret: string,
+}): Promise<Stripe.Event> {
+    return options.client.webhooks.constructEventAsync(
+        options.payload,
+        options.signature,
+        options.secret,
+        undefined,
+        Stripe.createSubtleCryptoProvider(),
+    );
+}

package/src/meter.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2026 mathru. All rights reserved.
+ *
+ * Standalone entry point exposing only the Stripe Meter (metered billing)
+ * library. Import from `@mathrunet/masamune_cloudflare_purchase_stripe/dist/meter`
+ * to keep Workers bundles free of the full Masamune re-exports.
+ *
+ * Stripe Meter（従量課金）ライブラリのみを公開する単独エントリポイント。
+ * Masamune全体の再エクスポートをWorkersバンドルに含めたくない場合は
+ * `@mathrunet/masamune_cloudflare_purchase_stripe/dist/meter`からインポートしてください。
+ *
+ * [mathru.net]: https://mathru.net
+ * [YouTube]: https://www.youtube.com/c/mathrunetchannel
+ */
+export * from "./lib/stripe_client";
+export * from "./lib/meter/interface";
+export * from "./lib/meter/stripe_meter_client";
+export * from "./lib/meter/flush_meter";
+export * from "./lib/meter/record_usage";
+export * from "./lib/meter/d1_usage_event_store";
+export * from "./lib/meter/kv_usage_buffer";

package/src/purchase.ts

@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) 2026 mathru. All rights reserved.
+ *
+ * Standalone entry point exposing the Stripe purchase library (mode actions,
+ * webhooks, stores) without the full Masamune re-exports. Import from
+ * `@mathrunet/masamune_cloudflare_purchase_stripe/dist/purchase` to keep
+ * Workers bundles small.
+ *
+ * Stripe購入ライブラリ（modeアクション、Webhook、ストア）のみを公開する単独
+ * エントリポイント。Masamune全体の再エクスポートをWorkersバンドルに含めたく
+ * ない場合は`@mathrunet/masamune_cloudflare_purchase_stripe/dist/purchase`から
+ * インポートしてください。
+ *
+ * [mathru.net]: https://mathru.net
+ * [YouTube]: https://www.youtube.com/c/mathrunetchannel
+ */
+import { Hono } from "hono";
+import { StripePurchaseWorkersOptions } from "./lib/options";
+
+export * from "./lib/options";
+export * from "./lib/stripe_client";
+export * from "./lib/purchase/interface";
+export * from "./lib/purchase/d1_purchase_store";
+export * from "./lib/purchase/helpers";
+export * from "./lib/purchase/sync_payment";
+
+/**
+ * Builder signature of the purchase workers (`stripe` / `stripeWebhook` /
+ * `stripeWebhookConnect` / `stripeWebhookSecure`).
+ *
+ * 購入ワーカー（`stripe` / `stripeWebhook` / `stripeWebhookConnect` /
+ * `stripeWebhookSecure`）のビルダーシグネチャ。
+ */
+export type StripeWorkerBuilder = (
+    hono: Hono,
+    options: StripePurchaseWorkersOptions,
+    data: { [key: string]: any },
+) => Hono;
+
+/**
+ * Build the mode-based Stripe action handler onto a Hono app.
+ *
+ * mode分岐のStripeアクションハンドラをHonoアプリへ構築します。
+ */
+export const buildStripe: StripeWorkerBuilder = require("./workers/stripe");
+
+/**
+ * Build the main Stripe webhook handler onto a Hono app.
+ *
+ * StripeメインWebhookハンドラをHonoアプリへ構築します。
+ */
+export const buildStripeWebhook: StripeWorkerBuilder = require("./workers/stripe_webhook");
+
+/**
+ * Build the Stripe Connect webhook handler onto a Hono app.
+ *
+ * Stripe Connect用WebhookハンドラをHonoアプリへ構築します。
+ */
+export const buildStripeWebhookConnect: StripeWorkerBuilder = require("./workers/stripe_webhook_connect");
+
+/**
+ * Build the 3D Secure redirect webhook handler onto a Hono app.
+ *
+ * 3DセキュアリダイレクトWebhookハンドラをHonoアプリへ構築します。
+ */
+export const buildStripeWebhookSecure: StripeWorkerBuilder = require("./workers/stripe_webhook_secure");