@rdlabo/workers-hono-kit 0.1.0

package/src/testing/db.ts

@@ -0,0 +1,125 @@
+import { drizzle } from 'drizzle-orm/mysql2';
+import { migrate } from 'drizzle-orm/mysql2/migrator';
+import { createConnection, createPool } from 'mysql2/promise';
+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>;
+}
+
+function resolveConnection(override?: Partial<TestDbConnection>): TestDbConnection {
+  const env = (globalThis as { process?: { env?: Record<string, string | undefined> } }).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: CreateTestDbOptions): TestDb {
+  const { dbName, migrationsFolder } = options;
+  const connection = resolveConnection(options.connection);
+
+  return {
+    dbName,
+    connection,
+
+    async resetSchema(): Promise<void> {
+      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(): Pool {
+      // 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: Pool): Promise<void> {
+      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 as { t: string }[]).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: Pool, table: string, row: Record<string, unknown>): Promise<void> {
+      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(): Promise<boolean> {
+      try {
+        const c = await createConnection({ ...connection });
+        await c.end();
+        return true;
+      } catch {
+        return false;
+      }
+    },
+  };
+}

package/src/testing/fakes.ts

@@ -0,0 +1,75 @@
+import type { Pool } from 'mysql2/promise';
+import { databaseFrom } from '../db/database';
+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 class FakeFirebaseVerifier implements FirebaseVerifier {
+  private readonly tokens = new Map<string, DecodedIdToken>();
+  readonly deleted: string[] = [];
+
+  register(token: string, record: DecodedIdToken): void {
+    this.tokens.set(token, record);
+  }
+
+  async verifyIdToken(idToken: string): Promise<DecodedIdToken> {
+    const record = this.tokens.get(idToken);
+    if (!record) {
+      throw new Error('invalid firebase id token');
+    }
+    return record;
+  }
+
+  async getUser(uid: string): Promise<{ uid: string; email?: string } | null> {
+    return { uid };
+  }
+
+  async deleteUser(uid: string): Promise<void> {
+    this.deleted.push(uid);
+  }
+}
+
+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 function createPoolDatabase<TDrizzle>(
+  options: CreatePoolDatabaseOptions<TDrizzle>,
+): DisposableDatabase<TDrizzle> {
+  const { pool, orm } = options;
+  const base = databaseFrom(orm, pool);
+  return {
+    ...base,
+    async dispose(): Promise<void> {
+      await pool.end();
+    },
+  };
+}
+
+/**
+ * DB に触れない route（GET / 等）用の Database スタブ。write/transaction は誤用検知のため throw。
+ * dispose は no-op（Hyperdrive/Pool 背面の DisposableDatabase を期待する repo でもそのまま使える）。
+ * orm 型は呼び出し側が指定（既定 unknown）。
+ */
+export function createNoopDatabase<TDrizzle = unknown>(): DisposableDatabase<TDrizzle> {
+  return {
+    read: async () => [],
+    write: () => {
+      throw new Error('noopDatabase.write accessed unexpectedly');
+    },
+    transaction: () => {
+      throw new Error('noopDatabase.transaction accessed unexpectedly');
+    },
+    dispose: async () => {},
+  };
+}

package/src/testing/index.ts

@@ -0,0 +1,26 @@
+// @rdlabo/workers-hono-kit/testing — フリート共通のテスト基盤（mysql2/drizzle 依存）。
+// 実行時には読み込まれないテスト専用ヘルパ。各 repo の testing/db.ts・fakes.ts を集約。
+
+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';
+
+// 認証テストヘルパ（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/src/testing/stripe-fixtures.ts

@@ -0,0 +1,85 @@
+import type Stripe from 'stripe';
+
+/**
+ * Stripe オブジェクトの test fixture factory。実 SDK 型は巨大なので、テストが参照する範囲だけを
+ * 妥当な既定値で組み、`over` で上書きする（最後に 1 度だけ Stripe 型へキャスト）。fleet 各 repo の
+ * 課金テストで同じダミー PaymentIntent/Event/... を手組みしていた重複を集約する。
+ */
+
+export function fakeApiList<T>(data: T[], over: Partial<Stripe.ApiList<T>> = {}): Stripe.ApiList<T> {
+  return {
+    object: 'list',
+    data,
+    has_more: false,
+    url: '/v1/_test',
+    ...over,
+  };
+}
+
+export function fakePaymentIntent(over: Partial<Stripe.PaymentIntent> = {}): Stripe.PaymentIntent {
+  return {
+    id: 'pi_test_1',
+    object: 'payment_intent',
+    amount: 1000,
+    currency: 'jpy',
+    status: 'succeeded',
+    created: 1_700_000_000,
+    ...over,
+  } as Stripe.PaymentIntent;
+}
+
+export function fakeStripeEvent(type: string, dataObject: unknown, over: Partial<Stripe.Event> = {}): Stripe.Event {
+  return {
+    id: 'evt_test_1',
+    object: 'event',
+    api_version: '2024-06-20',
+    created: 1_700_000_000,
+    livemode: false,
+    type,
+    data: { object: dataObject },
+    ...over,
+  } as Stripe.Event;
+}
+
+export function fakeCheckoutSession(over: Partial<Stripe.Checkout.Session> = {}): Stripe.Checkout.Session {
+  return {
+    id: 'cs_test_1',
+    object: 'checkout.session',
+    url: 'https://checkout.stripe.test/cs_test_1',
+    mode: 'subscription',
+    status: 'open',
+    ...over,
+  } as Stripe.Checkout.Session;
+}
+
+export function fakeCustomer(over: Partial<Stripe.Customer> = {}): Stripe.Customer {
+  return {
+    id: 'cus_test_1',
+    object: 'customer',
+    created: 1_700_000_000,
+    livemode: false,
+    ...over,
+  } as Stripe.Customer;
+}
+
+export function fakePrice(over: Partial<Stripe.Price> = {}): Stripe.Price {
+  return {
+    id: 'price_test_1',
+    object: 'price',
+    active: true,
+    currency: 'jpy',
+    unit_amount: 1000,
+    ...over,
+  } as Stripe.Price;
+}
+
+export function fakeSubscription(over: Partial<Stripe.Subscription> = {}): Stripe.Subscription {
+  return {
+    id: 'sub_test_1',
+    object: 'subscription',
+    status: 'active',
+    customer: 'cus_test_1',
+    created: 1_700_000_000,
+    ...over,
+  } as Stripe.Subscription;
+}