@rdlabo/workers-hono-kit 0.1.0

package/dist/middleware/validation.d.ts

@@ -0,0 +1,77 @@
+import type { Context } from 'hono';
+import type { ZodType } from 'zod';
+/** zod v3(ZodError) / v4(core $ZodError) どちらの error でも受けられる最小形 */
+export interface ZodErrorLike {
+    issues: readonly {
+        path: PropertyKey[];
+        message: string;
+    }[];
+}
+export type ValidationTarget = 'json' | 'query' | 'param' | 'header' | 'cookie' | 'form';
+export interface ValidateOptions {
+    /**
+     * 検証失敗時のフック（Sentry 通報など）。**検証の挙動は変えない** — レスポンスは常に
+     * NestJS ValidationPipe 同形の 400 を返す。例外を投げても握り潰す。
+     * 既定は no-op（receptray 互換 = 4xx を通報しない）。foodlabel は Sentry 実通報を差し込む。
+     */
+    onValidationError?: (error: ZodErrorLike, c: Context) => void;
+}
+export declare function validate<T>(target: ValidationTarget, schema: ZodType<T>, options?: ValidateOptions): import("hono").MiddlewareHandler<import("hono").Env, string, {
+    in: {
+        json?: unknown;
+        query?: {} | undefined;
+        param?: {} | undefined;
+        header?: {} | undefined;
+        cookie?: {} | undefined;
+        form?: {} | undefined;
+    };
+    out: {
+        json: T;
+        query: T;
+        param: T;
+        header: T;
+        cookie: T;
+        form: T;
+    };
+}, Response & import("hono").TypedResponse<{
+    statusCode: number;
+    message: string[];
+    error: string;
+}, 400, "json">>;
+/** Sentry の最小形（`@sentry/cloudflare` 等への直接依存を避けるための構造型）。 */
+export interface SentryScopeLike {
+    setTag(key: string, value: string): void;
+    setContext(key: string, context: Record<string, unknown> | null): void;
+}
+export interface SentryLike {
+    withScope(callback: (scope: SentryScopeLike) => void): void;
+    captureException(error: unknown): void;
+}
+/**
+ * DTO 検証 400 を Sentry に通報する `validate` を返すファクトリ（foodlabel/tipsys/winecode で重複していた
+ * reportValidationToSentry を集約）。kit は `@sentry/cloudflare` に依存せず、Sentry モジュールを注入する。
+ * 通報は `tag error.type=dto_validation` ＋ `context validation={errorCount, errors}`（各 /api の
+ * sentry-validation.pipe.ts 準拠）。検証の挙動・レスポンスは `validate` と同一（通報は副作用のみ）。
+ */
+export declare function createSentryValidate(sentry: SentryLike): <T>(target: ValidationTarget, schema: ZodType<T>) => import("hono").MiddlewareHandler<import("hono").Env, string, {
+    in: {
+        json?: unknown;
+        query?: {} | undefined;
+        param?: {} | undefined;
+        header?: {} | undefined;
+        cookie?: {} | undefined;
+        form?: {} | undefined;
+    };
+    out: {
+        json: T;
+        query: T;
+        param: T;
+        header: T;
+        cookie: T;
+        form: T;
+    };
+}, Response & import("hono").TypedResponse<{
+    statusCode: number;
+    message: string[];
+    error: string;
+}, 400, "json">>;

package/dist/middleware/validation.js

@@ -0,0 +1,53 @@
+import { zValidator } from '@hono/zod-validator';
+/**
+ * Zod 検証ミドルウェア（フリート共通 = receptray/winecode hono と同一仕様）。
+ * 失敗時は NestJS の ValidationPipe と同形の body を返す:
+ *   { statusCode: 400, message: string[], error: 'Bad Request' }
+ *
+ * NOTE(parity): message の文字列内容は class-validator と Zod で異なる。各 repo の固定 app の
+ * 正常系では DTO 検証 400 は発生しない前提（ビジネス 400 は各エンドポイントで HttpError 忠実再現）。
+ */
+function zodToMessages(error) {
+    return error.issues.map((issue) => {
+        const path = issue.path.map(String).join('.');
+        return path ? `${path}: ${issue.message}` : issue.message;
+    });
+}
+export function validate(target, schema, options) {
+    return zValidator(target, schema, (result, c) => {
+        if (!result.success) {
+            const messages = zodToMessages(result.error);
+            // Surface the failing fields in the runtime log. Without this the 400 is
+            // invisible in `wrangler dev`/Workers logs (Sentry is the only sink, and
+            // it is not visible locally), so a field-level type mismatch — e.g. a
+            // string sent to `z.number()` — dies silently and is painful to diagnose.
+            // Paths + zod messages only; no request values are logged.
+            console.warn(`[validation] ${c.req.method} ${c.req.path} (${target}) → 400: ${messages.join('; ')}`);
+            try {
+                options?.onValidationError?.(result.error, c);
+            }
+            catch {
+                // Reporting must never change validation error behavior.
+            }
+            return c.json({ statusCode: 400, message: messages, error: 'Bad Request' }, 400);
+        }
+        return undefined;
+    });
+}
+/**
+ * DTO 検証 400 を Sentry に通報する `validate` を返すファクトリ（foodlabel/tipsys/winecode で重複していた
+ * reportValidationToSentry を集約）。kit は `@sentry/cloudflare` に依存せず、Sentry モジュールを注入する。
+ * 通報は `tag error.type=dto_validation` ＋ `context validation={errorCount, errors}`（各 /api の
+ * sentry-validation.pipe.ts 準拠）。検証の挙動・レスポンスは `validate` と同一（通報は副作用のみ）。
+ */
+export function createSentryValidate(sentry) {
+    const onValidationError = (error) => {
+        const messages = zodToMessages(error);
+        sentry.withScope((scope) => {
+            scope.setTag('error.type', 'dto_validation');
+            scope.setContext('validation', { errorCount: messages.length, errors: messages });
+            sentry.captureException(error);
+        });
+    };
+    return (target, schema) => validate(target, schema, { onValidationError });
+}

package/dist/middleware/zod-coerce.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+/**
+ * 数値強制スキーマ。`inner` に `z.number().int()` 等を渡して制約を足せる（既定は z.number()）。
+ * 例: zNum(z.number().int()) で整数必須。
+ */
+export declare const zNum: (inner?: z.ZodNumber) => z.ZodType<number>;
+export declare const zNumWithDefault: (defaultValue: number, inner?: z.ZodNumber) => z.ZodType<number>;
+export declare const zNumOptional: (inner?: z.ZodNumber) => z.ZodType<number | undefined>;
+export declare const zNumNullable: (inner?: z.ZodNumber) => z.ZodType<number | null | undefined>;

package/dist/middleware/zod-coerce.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+/**
+ * `/api` の class-transformer @Transform（number-transform.util.ts）を Zod preprocess で忠実再現する。
+ * path/query は常に文字列で来るため数値強制が必要。空白のみ文字列は NaN にして後段の数値スキーマで弾く
+ * （class-validator の @IsInt/@IsNumber が NaN を拒否する挙動と一致。zod v4 は z.number() が NaN を既定拒否）。
+ */
+const isBlankString = (value) => typeof value === 'string' && value.trim() === '';
+// toNumber: 空白文字列 → NaN、それ以外 → Number(value)
+const rawToNumber = (value) => (isBlankString(value) ? Number(undefined) : Number(value));
+// toNumberWithDefault: undefined/'' → default、空白 → NaN、else Number
+const rawToNumberWithDefault = (defaultValue) => (value) => {
+    if (value === undefined || value === '') {
+        return defaultValue;
+    }
+    if (isBlankString(value)) {
+        return Number(undefined);
+    }
+    return Number(value);
+};
+// toOptionalNumber: undefined/null/'' → undefined、空白 → NaN、else Number
+const rawToOptionalNumber = (value) => {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (isBlankString(value)) {
+        return Number(undefined);
+    }
+    return Number(value);
+};
+// toNullableNumber: null/undefined → passthrough、'' → undefined、空白 → NaN、else Number
+const rawToNullableNumber = (value) => {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (value === '') {
+        return undefined;
+    }
+    if (isBlankString(value)) {
+        return Number(undefined);
+    }
+    return Number(value);
+};
+/**
+ * 数値強制スキーマ。`inner` に `z.number().int()` 等を渡して制約を足せる（既定は z.number()）。
+ * 例: zNum(z.number().int()) で整数必須。
+ */
+export const zNum = (inner = z.number()) => z.preprocess(rawToNumber, inner);
+export const zNumWithDefault = (defaultValue, inner = z.number()) => z.preprocess(rawToNumberWithDefault(defaultValue), inner);
+export const zNumOptional = (inner = z.number()) => z.preprocess(rawToOptionalNumber, inner.optional());
+export const zNumNullable = (inner = z.number()) => z.preprocess(rawToNullableNumber, inner.nullish());

package/dist/stripe/client.d.ts

@@ -0,0 +1,19 @@
+import Stripe from 'stripe';
+/**
+ * Stripe クライアント生成（フリート共通 = receptray/tipsys hono）。Cloudflare Workers には Node の
+ * http スタックが無いため、Stripe SDK の fetch ベース HttpClient を使う。
+ *
+ * `apiVersion` は **任意**: 各 repo の `/api`（NestJS）と挙動を一致させるため、固定したい repo は
+ * 渡し（例 tipsys は `'2024-04-10'`）、SDK 既定で良い repo は省く（例 receptray）。
+ */
+export interface CreateStripeClientOptions {
+    /** 固定する Stripe API バージョン。省略すると SDK 既定。 */
+    apiVersion?: string;
+}
+export declare function createStripeClient(secret: string, options?: CreateStripeClientOptions): Stripe;
+/**
+ * Webhook 署名の検証。Workers では同期版 `constructEvent` が使えない（SubtleCrypto が非同期）ため
+ * `constructEventAsync` + `SubtleCryptoProvider` を使う。`secret` は署名検証には無関係だが、検証用の
+ * クライアント生成に必要（API コールはしない）。
+ */
+export declare function verifyStripeWebhook(secret: string, webhookSecret: string, payload: string | ArrayBuffer, signature: string): Promise<Stripe.Event>;

package/dist/stripe/client.js

@@ -0,0 +1,23 @@
+import Stripe from 'stripe';
+export function createStripeClient(secret, options = {}) {
+    if (!secret) {
+        throw new Error('Stripe secret is not set');
+    }
+    const config = { httpClient: Stripe.createFetchHttpClient() };
+    if (options.apiVersion) {
+        config.apiVersion = options.apiVersion;
+    }
+    return new Stripe(secret, config);
+}
+/**
+ * Webhook 署名の検証。Workers では同期版 `constructEvent` が使えない（SubtleCrypto が非同期）ため
+ * `constructEventAsync` + `SubtleCryptoProvider` を使う。`secret` は署名検証には無関係だが、検証用の
+ * クライアント生成に必要（API コールはしない）。
+ */
+export function verifyStripeWebhook(secret, webhookSecret, payload, signature) {
+    if (!webhookSecret) {
+        throw new Error('Stripe webhook secret is not set');
+    }
+    const stripe = createStripeClient(secret);
+    return stripe.webhooks.constructEventAsync(payload, signature, webhookSecret, undefined, Stripe.createSubtleCryptoProvider());
+}

package/dist/testing/auth.d.ts

@@ -0,0 +1,36 @@
+import type { Pool } from 'mysql2/promise';
+import type { DecodedIdToken } from '../firebase/firebase-verifier';
+import type { FakeFirebaseVerifier } from './fakes';
+/**
+ * app interceptor 互換の認証ヘッダ（`x-amz-security-token` + `x-amz-meta-*`）を組む。
+ * fleet 全 hono repo の route spec で同形に重複していたものを集約。
+ *
+ * - `version` は `app_version`(varchar(10)) に入るため 10 文字以内。
+ * - `contentType: null` を渡すと content-type を付けない（GET 等）。
+ */
+export declare function authHeaders(token: string, opts?: {
+    version?: string;
+    uuid?: string;
+    contentType?: string | null;
+}): Record<string, string>;
+/**
+ * fake firebase にトークンを登録するだけの薄いヘルパ（DB を触らない）。戻り値はトークン。
+ * `users` テーブル形が repo 固有（例: airlec は email 主）で provisionUser が合わない場合に使う。
+ */
+export declare function registerFirebaseToken(firebase: FakeFirebaseVerifier, uid: string, record?: Partial<DecodedIdToken>, token?: string): string;
+/**
+ * fake firebase にトークンを登録し、`users(firebase_uid)` 行を用意して userId を返す。
+ * `users(id, firebase_uid, agree)` の fleet 共通形を前提（foodlabel/receptray など）。同 uid の
+ * 既存行があれば再利用する（冪等）。users テーブル形が異なる repo は registerFirebaseToken + 独自
+ * provision を使う。
+ */
+export declare function provisionUser(pool: Pool, firebase: FakeFirebaseVerifier, opts: {
+    uid: string;
+    token?: string;
+    agree?: number;
+    email?: string;
+}): Promise<{
+    userId: number;
+    uid: string;
+    token: string;
+}>;

package/dist/testing/auth.js

@@ -0,0 +1,42 @@
+/**
+ * app interceptor 互換の認証ヘッダ（`x-amz-security-token` + `x-amz-meta-*`）を組む。
+ * fleet 全 hono repo の route spec で同形に重複していたものを集約。
+ *
+ * - `version` は `app_version`(varchar(10)) に入るため 10 文字以内。
+ * - `contentType: null` を渡すと content-type を付けない（GET 等）。
+ */
+export function authHeaders(token, opts = {}) {
+    const headers = {
+        'x-amz-security-token': token,
+        'x-amz-meta-version': opts.version ?? '1.0.0',
+        'x-amz-meta-uuid': opts.uuid ?? 'test-uuid',
+    };
+    if (opts.contentType !== null) {
+        headers['content-type'] = opts.contentType ?? 'application/json';
+    }
+    return headers;
+}
+/**
+ * fake firebase にトークンを登録するだけの薄いヘルパ（DB を触らない）。戻り値はトークン。
+ * `users` テーブル形が repo 固有（例: airlec は email 主）で provisionUser が合わない場合に使う。
+ */
+export function registerFirebaseToken(firebase, uid, record = {}, token = `tok-${uid}`) {
+    firebase.register(token, { uid, ...record });
+    return token;
+}
+/**
+ * fake firebase にトークンを登録し、`users(firebase_uid)` 行を用意して userId を返す。
+ * `users(id, firebase_uid, agree)` の fleet 共通形を前提（foodlabel/receptray など）。同 uid の
+ * 既存行があれば再利用する（冪等）。users テーブル形が異なる repo は registerFirebaseToken + 独自
+ * provision を使う。
+ */
+export async function provisionUser(pool, firebase, opts) {
+    const token = registerFirebaseToken(firebase, opts.uid, opts.email ? { email: opts.email } : {}, opts.token);
+    const [existing] = await pool.query('SELECT id FROM users WHERE firebase_uid = ?', [opts.uid]);
+    const rows = existing;
+    if (rows.length > 0) {
+        return { userId: rows[0].id, uid: opts.uid, token };
+    }
+    const [res] = await pool.query('INSERT INTO users (agree, firebase_uid) VALUES (?, ?)', [opts.agree ?? 1, opts.uid]);
+    return { userId: res.insertId, uid: opts.uid, token };
+}

package/dist/testing/configurable-fake.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 部分実装から test double を作る。設定済みメソッドはそのまま、未設定メソッドを呼ぶと
+ * `${name}.${method} not configured` で明示的に失敗する。
+ *
+ * 各 repo の Fake*Gateway に散っていた「`Partial<impl>` を受け取り、未設定なら throw する手書き
+ * クラス」の定型を一本化する。interface がドメインごとに異なる gateway（Stripe 等）でも、これで
+ * 1 行で必要メソッドだけ差した fake を作れる:
+ *
+ *   const stripe = configurableFake<StripeGateway>(
+ *     { listPaymentIntents: async () => fakeApiList([fakePaymentIntent()]) },
+ *     'FakeStripeGateway',
+ *   );
+ */
+export declare function configurableFake<T extends object>(impl: Partial<T>, name?: string): T;

package/dist/testing/configurable-fake.js

@@ -0,0 +1,33 @@
+/**
+ * 部分実装から test double を作る。設定済みメソッドはそのまま、未設定メソッドを呼ぶと
+ * `${name}.${method} not configured` で明示的に失敗する。
+ *
+ * 各 repo の Fake*Gateway に散っていた「`Partial<impl>` を受け取り、未設定なら throw する手書き
+ * クラス」の定型を一本化する。interface がドメインごとに異なる gateway（Stripe 等）でも、これで
+ * 1 行で必要メソッドだけ差した fake を作れる:
+ *
+ *   const stripe = configurableFake<StripeGateway>(
+ *     { listPaymentIntents: async () => fakeApiList([fakePaymentIntent()]) },
+ *     'FakeStripeGateway',
+ *   );
+ */
+export function configurableFake(impl, name = 'fake') {
+    return new Proxy(impl, {
+        get(target, prop) {
+            if (prop in target) {
+                return target[prop];
+            }
+            // Promise インターロップ用プロパティには「未設定メソッド」関数を返さない。返すと fake 自身が
+            // thenable 扱いされ、誤って await / Promise.resolve した瞬間に then() が呼ばれて throw する罠になる。
+            if (prop === 'then' || prop === 'catch' || prop === 'finally') {
+                return undefined;
+            }
+            if (typeof prop === 'string') {
+                return () => {
+                    throw new Error(`${name}.${prop} not configured`);
+                };
+            }
+            return undefined;
+        },
+    });
+}

package/dist/testing/db.d.ts

@@ -0,0 +1,37 @@
+import type { Pool } from 'mysql2/promise';
+/**
+ * フリート共通のテスト DB ヘルパ（各 repo の testing/db.ts を集約）。
+ * テストスキーマは「コミット済み Drizzle マイグレーション」を単一ソースとして構築する
+ * （手書き schema.sql ではなく `db:generate` 由来の ./drizzle）。
+ *
+ * Node 専用（vitest 下で実行）。実行時 parity には無関係なテスト基盤。
+ */
+export interface TestDbConnection {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+}
+export interface CreateTestDbOptions {
+    /** テスト DB 名（例 'tipsys_test'）。並列実行で feature 毎に分けたい場合は呼び出し側で TEST_DB を解決して渡す。 */
+    dbName: string;
+    /** Drizzle マイグレーションフォルダの絶対パス（呼び出し側で `join(here, '..', 'drizzle')` を解決して渡す）。 */
+    migrationsFolder: string;
+    /** 接続情報。未指定は env（DB_HOST/DB_PORT/DB_USER/DB_PASSWORD）→ 127.0.0.1/3306/root/root。 */
+    connection?: Partial<TestDbConnection>;
+}
+export interface TestDb {
+    readonly dbName: string;
+    readonly connection: TestDbConnection;
+    /** DROP/CREATE して Drizzle マイグレーションを適用しスキーマを構築。 */
+    resetSchema(): Promise<void>;
+    /** テスト DB に繋いだ mysql2 プールを返す（afterAll で pool.end()）。 */
+    createTestPool(): Pool;
+    /** 全テーブルを TRUNCATE（information_schema から動的取得。__drizzle_migrations は除外）。 */
+    truncateAll(pool: Pool): Promise<void>;
+    /** 1 行 insert する汎用 seed（列名→値）。route spec の fixture 用。 */
+    seed(pool: Pool, table: string, row: Record<string, unknown>): Promise<void>;
+    /** ローカル MySQL が到達可能か（`describe.skipIf(!(await mysqlReachable()))` のガード用）。 */
+    mysqlReachable(): Promise<boolean>;
+}
+export declare function createTestDb(options: CreateTestDbOptions): TestDb;

package/dist/testing/db.js

@@ -0,0 +1,74 @@
+import { drizzle } from 'drizzle-orm/mysql2';
+import { migrate } from 'drizzle-orm/mysql2/migrator';
+import { createConnection, createPool } from 'mysql2/promise';
+function resolveConnection(override) {
+    const env = globalThis.process?.env ?? {};
+    return {
+        host: override?.host ?? env.DB_HOST ?? '127.0.0.1',
+        port: override?.port ?? Number(env.DB_PORT ?? '3306'),
+        user: override?.user ?? env.DB_USER ?? 'root',
+        password: override?.password ?? env.DB_PASSWORD ?? 'root',
+    };
+}
+export function createTestDb(options) {
+    const { dbName, migrationsFolder } = options;
+    const connection = resolveConnection(options.connection);
+    return {
+        dbName,
+        connection,
+        async resetSchema() {
+            const admin = await createConnection({ ...connection, multipleStatements: true });
+            await admin.query(`DROP DATABASE IF EXISTS \`${dbName}\`; CREATE DATABASE \`${dbName}\` DEFAULT CHARACTER SET utf8mb4;`);
+            await admin.changeUser({ database: dbName });
+            await migrate(drizzle(admin), { migrationsFolder });
+            await admin.end();
+        },
+        createTestPool() {
+            // decimalNumbers / timezone mirror the runtime hyperdriveConnectionOptions so specs read
+            // DECIMAL columns as numbers and handle datetime in +09:00 (JST), matching production.
+            const pool = createPool({
+                ...connection,
+                database: dbName,
+                connectionLimit: 5,
+                decimalNumbers: true,
+                timezone: '+09:00',
+            });
+            // Pin ONLY_FULL_GROUP_BY on every pooled connection so GROUP BY violations surface in specs
+            // regardless of the server's my.cnf (fleet policy centralized here, not per-repo). CONCAT keeps
+            // the server's other sql_mode flags and is harmless if ONLY_FULL_GROUP_BY is already present.
+            // mysql2 queues this SET ahead of the consumer's first query on each new physical connection.
+            pool.on('connection', (conn) => {
+                void conn.query("SET SESSION sql_mode = CONCAT(@@SESSION.sql_mode, ',ONLY_FULL_GROUP_BY')");
+            });
+            return pool;
+        },
+        async truncateAll(pool) {
+            const [rows] = await pool.query("SELECT table_name AS t FROM information_schema.tables WHERE table_schema = ? AND table_type='BASE TABLE' AND table_name <> '__drizzle_migrations'", [dbName]);
+            const tables = rows.map((r) => r.t);
+            await pool.query('SET FOREIGN_KEY_CHECKS=0');
+            for (const t of tables) {
+                await pool.query(`TRUNCATE TABLE \`${t}\``);
+            }
+            await pool.query('SET FOREIGN_KEY_CHECKS=1');
+        },
+        async seed(pool, table, row) {
+            const cols = Object.keys(row);
+            if (cols.length === 0) {
+                return;
+            }
+            const placeholders = cols.map(() => '?').join(', ');
+            const columnList = cols.map((c) => `\`${c}\``).join(', ');
+            await pool.query(`INSERT INTO \`${table}\` (${columnList}) VALUES (${placeholders})`, Object.values(row));
+        },
+        async mysqlReachable() {
+            try {
+                const c = await createConnection({ ...connection });
+                await c.end();
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}

package/dist/testing/fakes.d.ts

@@ -0,0 +1,35 @@
+import type { Pool } from 'mysql2/promise';
+import type { DisposableDatabase } from '../db/database';
+import type { DecodedIdToken, FirebaseVerifier } from '../firebase/firebase-verifier';
+/**
+ * オフライン route テスト用の in-memory FirebaseVerifier（4 repo 同一実装を集約）。
+ * `register(token, { uid })` で偽 ID を仕込む。
+ */
+export declare class FakeFirebaseVerifier implements FirebaseVerifier {
+    private readonly tokens;
+    readonly deleted: string[];
+    register(token: string, record: DecodedIdToken): void;
+    verifyIdToken(idToken: string): Promise<DecodedIdToken>;
+    getUser(uid: string): Promise<{
+        uid: string;
+        email?: string;
+    } | null>;
+    deleteUser(uid: string): Promise<void>;
+}
+export interface CreatePoolDatabaseOptions<TDrizzle> {
+    /** テスト用プール（primary/replica 兼用）。 */
+    pool: Pool;
+    /** 消費側の drizzle-orm で `drizzle(pool, { schema, ... })` を作って渡す。 */
+    orm: TDrizzle;
+}
+/**
+ * テスト用にプール 1 本を primary/replica 兼用にした Database（foodlabel の PoolDatabase 相当）。
+ * `dispose()` はプールを閉じる。orm は消費側が自分の drizzle-orm で作って渡す（型同一性の分離）。
+ */
+export declare function createPoolDatabase<TDrizzle>(options: CreatePoolDatabaseOptions<TDrizzle>): DisposableDatabase<TDrizzle>;
+/**
+ * DB に触れない route（GET / 等）用の Database スタブ。write/transaction は誤用検知のため throw。
+ * dispose は no-op（Hyperdrive/Pool 背面の DisposableDatabase を期待する repo でもそのまま使える）。
+ * orm 型は呼び出し側が指定（既定 unknown）。
+ */
+export declare function createNoopDatabase<TDrizzle = unknown>(): DisposableDatabase<TDrizzle>;

package/dist/testing/fakes.js

@@ -0,0 +1,56 @@
+import { databaseFrom } from '../db/database';
+/**
+ * オフライン route テスト用の in-memory FirebaseVerifier（4 repo 同一実装を集約）。
+ * `register(token, { uid })` で偽 ID を仕込む。
+ */
+export class FakeFirebaseVerifier {
+    tokens = new Map();
+    deleted = [];
+    register(token, record) {
+        this.tokens.set(token, record);
+    }
+    async verifyIdToken(idToken) {
+        const record = this.tokens.get(idToken);
+        if (!record) {
+            throw new Error('invalid firebase id token');
+        }
+        return record;
+    }
+    async getUser(uid) {
+        return { uid };
+    }
+    async deleteUser(uid) {
+        this.deleted.push(uid);
+    }
+}
+/**
+ * テスト用にプール 1 本を primary/replica 兼用にした Database（foodlabel の PoolDatabase 相当）。
+ * `dispose()` はプールを閉じる。orm は消費側が自分の drizzle-orm で作って渡す（型同一性の分離）。
+ */
+export function createPoolDatabase(options) {
+    const { pool, orm } = options;
+    const base = databaseFrom(orm, pool);
+    return {
+        ...base,
+        async dispose() {
+            await pool.end();
+        },
+    };
+}
+/**
+ * DB に触れない route（GET / 等）用の Database スタブ。write/transaction は誤用検知のため throw。
+ * dispose は no-op（Hyperdrive/Pool 背面の DisposableDatabase を期待する repo でもそのまま使える）。
+ * orm 型は呼び出し側が指定（既定 unknown）。
+ */
+export function createNoopDatabase() {
+    return {
+        read: async () => [],
+        write: () => {
+            throw new Error('noopDatabase.write accessed unexpectedly');
+        },
+        transaction: () => {
+            throw new Error('noopDatabase.transaction accessed unexpectedly');
+        },
+        dispose: async () => { },
+    };
+}

package/dist/testing/index.d.ts

@@ -0,0 +1,8 @@
+export { createTestDb } from './db';
+export type { TestDb, CreateTestDbOptions, TestDbConnection } from './db';
+export { FakeFirebaseVerifier, createPoolDatabase, createNoopDatabase } from './fakes';
+export type { CreatePoolDatabaseOptions } from './fakes';
+export type { Database, DisposableDatabase, QueryRunner, TxOf } from '../db/database';
+export { authHeaders, registerFirebaseToken, provisionUser } from './auth';
+export { configurableFake } from './configurable-fake';
+export { fakeApiList, fakePaymentIntent, fakeStripeEvent, fakeCheckoutSession, fakeCustomer, fakePrice, fakeSubscription, } from './stripe-fixtures';

package/dist/testing/index.js

@@ -0,0 +1,10 @@
+// @rdlabo/workers-hono-kit/testing — フリート共通のテスト基盤（mysql2/drizzle 依存）。
+// 実行時には読み込まれないテスト専用ヘルパ。各 repo の testing/db.ts・fakes.ts を集約。
+export { createTestDb } from './db';
+export { FakeFirebaseVerifier, createPoolDatabase, createNoopDatabase } from './fakes';
+// 認証テストヘルパ（route spec のヘッダ生成・ユーザ provision を集約）。
+export { authHeaders, registerFirebaseToken, provisionUser } from './auth';
+// test double ヘルパ（未設定メソッドで明示 throw する部分実装 fake）。
+export { configurableFake } from './configurable-fake';
+// Stripe オブジェクトの test fixture factory。
+export { fakeApiList, fakePaymentIntent, fakeStripeEvent, fakeCheckoutSession, fakeCustomer, fakePrice, fakeSubscription, } from './stripe-fixtures';

package/dist/testing/stripe-fixtures.d.ts

@@ -0,0 +1,13 @@
+import type Stripe from 'stripe';
+/**
+ * Stripe オブジェクトの test fixture factory。実 SDK 型は巨大なので、テストが参照する範囲だけを
+ * 妥当な既定値で組み、`over` で上書きする（最後に 1 度だけ Stripe 型へキャスト）。fleet 各 repo の
+ * 課金テストで同じダミー PaymentIntent/Event/... を手組みしていた重複を集約する。
+ */
+export declare function fakeApiList<T>(data: T[], over?: Partial<Stripe.ApiList<T>>): Stripe.ApiList<T>;
+export declare function fakePaymentIntent(over?: Partial<Stripe.PaymentIntent>): Stripe.PaymentIntent;
+export declare function fakeStripeEvent(type: string, dataObject: unknown, over?: Partial<Stripe.Event>): Stripe.Event;
+export declare function fakeCheckoutSession(over?: Partial<Stripe.Checkout.Session>): Stripe.Checkout.Session;
+export declare function fakeCustomer(over?: Partial<Stripe.Customer>): Stripe.Customer;
+export declare function fakePrice(over?: Partial<Stripe.Price>): Stripe.Price;
+export declare function fakeSubscription(over?: Partial<Stripe.Subscription>): Stripe.Subscription;