@ishibashi0112/webview2-bridge-test 0.5.0

package/dist/db/diff.d.ts

@@ -0,0 +1,29 @@
+/**
+ * テーブル行の「前後差分」を取る純粋関数。DB を知らない(Knex から取った行配列だけを扱う)。
+ * キー列で行を同定し、inserted / updated / deleted に分ける。updated は変わった列だけを before / after で返す。
+ */
+export type Row = Record<string, unknown>;
+export interface UpdatedRow {
+    key: Row;
+    before: Row;
+    after: Row;
+    /** 変わった列だけ */
+    changed: Record<string, {
+        before: unknown;
+        after: unknown;
+    }>;
+}
+export interface TableDiff {
+    inserted: Row[];
+    updated: UpdatedRow[];
+    deleted: Row[];
+}
+/** 値を比較可能な形に正規化する(Date → ISO 文字列、Buffer → base64、bigint → 文字列) */
+export declare function normalizeValue(value: unknown): unknown;
+/** キー列の値を連結した文字列(Map のキーに使う) */
+export declare function keyOf(row: Row, key: readonly string[]): string;
+export declare function pickKey(row: Row, key: readonly string[]): Row;
+export declare function diffRows(before: readonly Row[], after: readonly Row[], key: readonly string[]): TableDiff;
+/** レポート向けの 1 行要約 */
+export declare function summarizeDiff(diff: TableDiff): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/db/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/db/diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC;IACX,cAAc;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,GAAG,EAAE,CAAC;CAChB;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOtD;AAED,gCAAgC;AAChC,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE9D;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAI7D;AAYD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAyBzG;AAED,oBAAoB;AACpB,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAErD"}

package/dist/db/diff.js

@@ -0,0 +1,76 @@
+/**
+ * テーブル行の「前後差分」を取る純粋関数。DB を知らない(Knex から取った行配列だけを扱う)。
+ * キー列で行を同定し、inserted / updated / deleted に分ける。updated は変わった列だけを before / after で返す。
+ */
+/** 値を比較可能な形に正規化する(Date → ISO 文字列、Buffer → base64、bigint → 文字列) */
+export function normalizeValue(value) {
+    if (value === undefined)
+        return null;
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? "Invalid Date" : value.toISOString();
+    if (typeof value === "bigint")
+        return value.toString();
+    if (typeof Buffer !== "undefined" && Buffer.isBuffer(value))
+        return `base64:${value.toString("base64")}`;
+    if (value instanceof Uint8Array)
+        return `base64:${Buffer.from(value).toString("base64")}`;
+    return value;
+}
+/** キー列の値を連結した文字列(Map のキーに使う) */
+export function keyOf(row, key) {
+    return JSON.stringify(key.map((k) => normalizeValue(row[k])));
+}
+export function pickKey(row, key) {
+    const out = {};
+    for (const k of key)
+        out[k] = row[k];
+    return out;
+}
+function sameValue(a, b) {
+    const na = normalizeValue(a);
+    const nb = normalizeValue(b);
+    if (na === nb)
+        return true;
+    // 数値と数値文字列(Oracle の NUMBER など)は同じとみなす
+    if (typeof na === "number" && typeof nb === "string" && nb.trim() !== "" && Number(nb) === na)
+        return true;
+    if (typeof nb === "number" && typeof na === "string" && na.trim() !== "" && Number(na) === nb)
+        return true;
+    return JSON.stringify(na) === JSON.stringify(nb);
+}
+export function diffRows(before, after, key) {
+    if (key.length === 0)
+        throw new Error("diffRows: key columns are required");
+    const beforeMap = new Map();
+    for (const row of before)
+        beforeMap.set(keyOf(row, key), row);
+    const result = { inserted: [], updated: [], deleted: [] };
+    const seen = new Set();
+    for (const row of after) {
+        const k = keyOf(row, key);
+        seen.add(k);
+        const prev = beforeMap.get(k);
+        if (prev === undefined) {
+            result.inserted.push(row);
+            continue;
+        }
+        const changed = {};
+        const columns = new Set([...Object.keys(prev), ...Object.keys(row)]);
+        for (const col of columns) {
+            if (!sameValue(prev[col], row[col]))
+                changed[col] = { before: prev[col], after: row[col] };
+        }
+        if (Object.keys(changed).length > 0)
+            result.updated.push({ key: pickKey(row, key), before: prev, after: row, changed });
+    }
+    for (const [k, row] of beforeMap) {
+        if (!seen.has(k))
+            result.deleted.push(row);
+    }
+    return result;
+}
+/** レポート向けの 1 行要約 */
+export function summarizeDiff(diff) {
+    return `inserted ${diff.inserted.length} / updated ${diff.updated.length} / deleted ${diff.deleted.length}`;
+}
+//# sourceMappingURL=diff.js.map

package/dist/db/diff.js.map

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

package/dist/db/env.d.ts

@@ -0,0 +1,19 @@
+import { type DbClient } from "./guard.js";
+export interface KnexLikeConfig {
+    client: DbClient;
+    connection: Record<string, unknown>;
+    useNullAsDefault?: boolean;
+    pool?: {
+        min: number;
+        max: number;
+    };
+}
+export declare const DEFAULT_ENV_FILES: readonly [".env.e2e.local", ".env.e2e"];
+/** env ファイルを読み、未設定の変数だけ target に入れる。読んだファイルのパスを返す */
+export declare function loadEnvFiles(baseDir: string, files?: readonly string[], target?: NodeJS.ProcessEnv): string[];
+export declare class DbEnvError extends Error {
+    name: string;
+}
+/** 環境変数から Knex の設定を作る。E2E_DB_CLIENT が無ければ undefined(DB なしで動く) */
+export declare function knexConfigFromEnv(env?: NodeJS.ProcessEnv): KnexLikeConfig | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/db/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/db/env.ts"],"names":[],"mappings":"AAaA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC;AAED,eAAO,MAAM,iBAAiB,yCAA0C,CAAC;AAEzE,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,MAAM,EAAsB,EAAE,MAAM,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAY7I;AAeD,qBAAa,UAAW,SAAQ,KAAK;IAC1B,IAAI,SAAgB;CAC9B;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,cAAc,GAAG,SAAS,CAmElG"}

package/dist/db/env.js

@@ -0,0 +1,119 @@
+/**
+ * `.env.e2e.local` / `.env.e2e` と環境変数から Knex の接続設定を組み立てる。
+ * 依存を増やさないため Node 標準の util.parseEnv を使う。既にある環境変数は上書きしない(dotenv と同じ)。
+ *
+ *   E2E_DB_CLIENT          mssql | oracledb | pg | mysql2 | better-sqlite3
+ *   E2E_DB_HOST / E2E_DB_PORT / E2E_DB_USER / E2E_DB_PASSWORD / E2E_DB_DATABASE
+ *   E2E_DB_CONNECT_STRING  Oracle 用(省略時は host:port/database から組み立てる)
+ *   E2E_DB_FILENAME        sqlite 用
+ *   E2E_DB_OPTIONS         JSON。接続オブジェクトに深くマージする(例: {"options":{"encrypt":false}})
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { parseEnv } from "node:util";
+import { isDbClient } from "./guard.js";
+export const DEFAULT_ENV_FILES = [".env.e2e.local", ".env.e2e"];
+/** env ファイルを読み、未設定の変数だけ target に入れる。読んだファイルのパスを返す */
+export function loadEnvFiles(baseDir, files = DEFAULT_ENV_FILES, target = process.env) {
+    const loaded = [];
+    for (const file of files) {
+        const full = path.resolve(baseDir, file);
+        if (!existsSync(full))
+            continue;
+        const parsed = parseEnv(readFileSync(full, "utf8"));
+        for (const [k, v] of Object.entries(parsed)) {
+            if (target[k] === undefined)
+                target[k] = v;
+        }
+        loaded.push(full);
+    }
+    return loaded;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function deepMerge(base, extra) {
+    const out = { ...base };
+    for (const [k, v] of Object.entries(extra)) {
+        const cur = out[k];
+        out[k] = isRecord(cur) && isRecord(v) ? deepMerge(cur, v) : v;
+    }
+    return out;
+}
+export class DbEnvError extends Error {
+    name = "DbEnvError";
+}
+/** 環境変数から Knex の設定を作る。E2E_DB_CLIENT が無ければ undefined(DB なしで動く) */
+export function knexConfigFromEnv(env = process.env) {
+    const client = env["E2E_DB_CLIENT"]?.trim();
+    if (client === undefined || client === "")
+        return undefined;
+    if (!isDbClient(client)) {
+        throw new DbEnvError(`E2E_DB_CLIENT=${client} は未対応です(mssql | oracledb | pg | mysql2 | better-sqlite3)`);
+    }
+    const host = env["E2E_DB_HOST"];
+    const port = env["E2E_DB_PORT"] !== undefined && env["E2E_DB_PORT"] !== "" ? Number(env["E2E_DB_PORT"]) : undefined;
+    if (port !== undefined && !Number.isInteger(port))
+        throw new DbEnvError(`E2E_DB_PORT=${env["E2E_DB_PORT"]} は整数ではありません`);
+    const user = env["E2E_DB_USER"];
+    const password = env["E2E_DB_PASSWORD"];
+    const database = env["E2E_DB_DATABASE"];
+    let options = {};
+    if (env["E2E_DB_OPTIONS"] !== undefined && env["E2E_DB_OPTIONS"].trim() !== "") {
+        let parsed;
+        try {
+            parsed = JSON.parse(env["E2E_DB_OPTIONS"]);
+        }
+        catch (e) {
+            throw new DbEnvError(`E2E_DB_OPTIONS が JSON として読めません: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        if (!isRecord(parsed))
+            throw new DbEnvError("E2E_DB_OPTIONS は JSON オブジェクトで指定してください");
+        options = parsed;
+    }
+    const required = (name, value) => {
+        if (value === undefined || value === "")
+            throw new DbEnvError(`${name} が設定されていません(.env.e2e.local を確認してください)`);
+        return value;
+    };
+    let connection;
+    const config = { client, connection: {}, pool: { min: 0, max: 2 } };
+    switch (client) {
+        case "mssql":
+            connection = {
+                server: required("E2E_DB_HOST", host),
+                ...(port !== undefined && { port }),
+                user: required("E2E_DB_USER", user),
+                password: password ?? "",
+                database: required("E2E_DB_DATABASE", database),
+                // 社内の SQL Server は自己署名証明書が多い。encrypt は E2E_DB_OPTIONS で明示できる
+                options: { trustServerCertificate: true },
+            };
+            break;
+        case "oracledb": {
+            const connectString = env["E2E_DB_CONNECT_STRING"] !== undefined && env["E2E_DB_CONNECT_STRING"] !== ""
+                ? env["E2E_DB_CONNECT_STRING"]
+                : `${required("E2E_DB_HOST", host)}:${port ?? 1521}/${required("E2E_DB_DATABASE", database)}`;
+            connection = { user: required("E2E_DB_USER", user), password: password ?? "", connectString };
+            break;
+        }
+        case "pg":
+        case "mysql2":
+            connection = {
+                host: required("E2E_DB_HOST", host),
+                ...(port !== undefined && { port }),
+                user: required("E2E_DB_USER", user),
+                password: password ?? "",
+                database: required("E2E_DB_DATABASE", database),
+            };
+            break;
+        case "better-sqlite3":
+            connection = { filename: required("E2E_DB_FILENAME", env["E2E_DB_FILENAME"]) };
+            config.useNullAsDefault = true;
+            delete config.pool;
+            break;
+    }
+    config.connection = deepMerge(connection, options);
+    return config;
+}
+//# sourceMappingURL=env.js.map

package/dist/db/env.js.map

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

package/dist/db/guard.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 本番 DB に向けてテストが走らないためのガード。
+ * 接続設定から「どの DB か」を 1 つの文字列に要約し、許可リスト(allowedDatabases)と照合する。
+ * 許可リストの各項目は、DB 名(大文字小文字を区別しない)か `host/DB名` のどちらかに一致すればよい。
+ */
+export type DbClient = "mssql" | "oracledb" | "pg" | "mysql2" | "better-sqlite3";
+export interface ConnectionDescription {
+    client: DbClient;
+    /** DB 名(sqlite はファイル名、Oracle はサービス名) */
+    database: string;
+    host?: string | undefined;
+    /** 人が読む用: client host/database */
+    label: string;
+}
+export declare function isDbClient(value: unknown): value is DbClient;
+/** Oracle の connectString(`host:port/service` や `host/service`、tnsnames の別名)からサービス名を取り出す */
+export declare function oracleServiceName(connectString: string): {
+    host?: string | undefined;
+    service: string;
+};
+export declare function describeConnection(client: DbClient, connection: Record<string, unknown>): ConnectionDescription;
+export interface GuardResult {
+    ok: boolean;
+    description: ConnectionDescription;
+    reason?: string;
+}
+export declare function checkAllowed(description: ConnectionDescription, allowedDatabases: readonly string[]): GuardResult;
+//# sourceMappingURL=guard.d.ts.map

package/dist/db/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/db/guard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAEjF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,QAAQ,CAAC;IACjB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAMD,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMvG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,CAuB/G;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,qBAAqB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAoBjH"}

package/dist/db/guard.js

@@ -0,0 +1,68 @@
+/**
+ * 本番 DB に向けてテストが走らないためのガード。
+ * 接続設定から「どの DB か」を 1 つの文字列に要約し、許可リスト(allowedDatabases)と照合する。
+ * 許可リストの各項目は、DB 名(大文字小文字を区別しない)か `host/DB名` のどちらかに一致すればよい。
+ */
+export function isDbClient(value) {
+    return value === "mssql" || value === "oracledb" || value === "pg" || value === "mysql2" || value === "better-sqlite3";
+}
+function str(value) {
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+/** Oracle の connectString(`host:port/service` や `host/service`、tnsnames の別名)からサービス名を取り出す */
+export function oracleServiceName(connectString) {
+    const slash = connectString.lastIndexOf("/");
+    if (slash < 0)
+        return { service: connectString };
+    const hostPort = connectString.slice(0, slash);
+    const colon = hostPort.indexOf(":");
+    return { host: colon >= 0 ? hostPort.slice(0, colon) : hostPort, service: connectString.slice(slash + 1) };
+}
+export function describeConnection(client, connection) {
+    switch (client) {
+        case "mssql": {
+            const host = str(connection["server"]) ?? str(connection["host"]);
+            const database = str(connection["database"]) ?? "";
+            return { client, database, host, label: `${client} ${host ?? "?"}/${database || "?"}` };
+        }
+        case "oracledb": {
+            const cs = str(connection["connectString"]) ?? "";
+            const { host, service } = oracleServiceName(cs);
+            return { client, database: service, host, label: `${client} ${cs || "?"}` };
+        }
+        case "pg":
+        case "mysql2": {
+            const host = str(connection["host"]);
+            const database = str(connection["database"]) ?? "";
+            return { client, database, host, label: `${client} ${host ?? "?"}/${database || "?"}` };
+        }
+        case "better-sqlite3": {
+            const database = str(connection["filename"]) ?? "";
+            return { client, database, label: `${client} ${database || "?"}` };
+        }
+    }
+}
+export function checkAllowed(description, allowedDatabases) {
+    if (allowedDatabases.length === 0) {
+        return { ok: false, description, reason: "allowedDatabases が空です。テスト DB の名前を e2e.config.ts の db.allowedDatabases に書いてください(本番 DB に向けて走らせないためのガードです)" };
+    }
+    const db = description.database.toLowerCase();
+    const hostDb = description.host !== undefined ? `${description.host.toLowerCase()}/${db}` : undefined;
+    for (const entry of allowedDatabases) {
+        const e = entry.trim().toLowerCase();
+        if (e === "")
+            continue;
+        if (e === db || (hostDb !== undefined && e === hostDb))
+            return { ok: true, description };
+        // sqlite はファイル名の末尾一致も許す(相対 / 絶対の差を吸収)
+        if (description.client === "better-sqlite3" && (db.endsWith(e) || db.endsWith(`/${e}`) || db.endsWith(`\\${e}`))) {
+            return { ok: true, description };
+        }
+    }
+    return {
+        ok: false,
+        description,
+        reason: `接続先 ${description.label} は allowedDatabases [${allowedDatabases.join(", ")}] に含まれていません。テスト DB ではない可能性があるため停止します`,
+    };
+}
+//# sourceMappingURL=guard.js.map

package/dist/db/guard.js.map

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

package/dist/db/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * テスト本文に `db` として渡る DB ヘルパ。Knex を薄く包み、方言は Knex に任せる。
+ * - insert で入れた行と、diff で「増えた」と判定した行を記録し、cleanup() で逆順に削除する(後片付け)
+ * - snapshot / diff はテーブル行の前後比較(db/diff.ts の純粋関数)
+ */
+import type { Knex } from "knex";
+import { diffRows, summarizeDiff, type Row, type TableDiff } from "./diff.js";
+export interface SnapshotSpec {
+    table: string;
+    /** 行を同定するキー列 */
+    key: string[];
+    /** 絞り込み(通常は testId 接頭辞)。省略すると全行(maxRows で打ち切り) */
+    where?: Row | ((qb: Knex.QueryBuilder) => Knex.QueryBuilder) | undefined;
+}
+export interface TableSnapshot {
+    spec: SnapshotSpec;
+    rows: Row[];
+    /** maxRows を超えて打ち切った(diff は信頼できない) */
+    truncated: boolean;
+}
+export interface DbSnapshot {
+    takenAt: string;
+    tables: Record<string, TableSnapshot>;
+}
+export type DbDiff = Record<string, TableDiff>;
+export interface CleanupEntry {
+    table: string;
+    where: Row;
+    /** 何によって記録されたか */
+    source: "insert" | "diff";
+}
+export interface CleanupFailure extends CleanupEntry {
+    error: string;
+}
+export interface CleanupResult {
+    deleted: number;
+    failures: CleanupFailure[];
+}
+export interface DbOptions {
+    /** snapshot で where を省略したときに読む最大行数(既定 5000) */
+    maxRows?: number | undefined;
+    /** diff を取ったときに呼ばれる(レポート添付用) */
+    onDiff?: ((diff: DbDiff, snapshot: DbSnapshot) => void | Promise<void>) | undefined;
+    /** snapshot の where 省略など、注意事項を受け取る */
+    onWarning?: ((message: string) => void) | undefined;
+}
+export interface Db {
+    /** 生の Knex。ヘルパに無いことをするとき用 */
+    readonly knex: Knex;
+    /** 生 SQL(読み取り用)。バインドは `?` */
+    query<T extends Row = Row>(sql: string, params?: readonly unknown[]): Promise<T[]>;
+    /** 前提行を入れる。後片付けの対象に記録する(行の全列を where にして削除する) */
+    insert(table: string, row: Row): Promise<void>;
+    insertMany(table: string, rows: readonly Row[]): Promise<void>;
+    /** 条件に合う行を取る */
+    rows<T extends Row = Row>(table: string, where?: Row): Promise<T[]>;
+    /** 現在の行を控える */
+    snapshot(specs: readonly SnapshotSpec[]): Promise<DbSnapshot>;
+    /** 控えと現在を比べる。増えた行は後片付けの対象に記録する */
+    diff(snapshot: DbSnapshot): Promise<DbDiff>;
+    /** 1 行取って部分一致を確かめる。無い / 複数 / 不一致は例外 */
+    expectRow(table: string, where: Row, expected: Row): Promise<Row>;
+    /** 記録した行を逆順に削除する(フィクスチャが自動で呼ぶ) */
+    cleanup(): Promise<CleanupResult>;
+    /** 後片付けの対象を手で足す(アプリが作った行を diff 以外で知っているとき) */
+    trackForCleanup(table: string, where: Row): void;
+}
+export declare function createDb(knex: Knex, options?: DbOptions): Db;
+/** knex.raw の戻り値は方言ごとに形が違う。行配列に揃える */
+export declare function normalizeRawResult(knex: Knex, result: unknown): Row[];
+export { diffRows, summarizeDiff, type Row, type TableDiff };
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

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

package/dist/db/index.js

@@ -0,0 +1,120 @@
+import { diffRows, pickKey, summarizeDiff } from "./diff.js";
+function fmt(value) {
+    return typeof value === "string" ? JSON.stringify(value) : String(value);
+}
+export function createDb(knex, options = {}) {
+    const maxRows = options.maxRows ?? 5000;
+    const cleanupEntries = [];
+    const applyWhere = (qb, where) => {
+        if (where === undefined)
+            return qb;
+        if (typeof where === "function")
+            return where(qb);
+        return qb.where(where);
+    };
+    const db = {
+        knex,
+        async query(sql, params = []) {
+            const result = await knex.raw(sql, [...params]);
+            return normalizeRawResult(knex, result);
+        },
+        async insert(table, row) {
+            await knex(table).insert(row);
+            cleanupEntries.push({ table, where: { ...row }, source: "insert" });
+        },
+        async insertMany(table, rows) {
+            for (const row of rows)
+                await db.insert(table, row);
+        },
+        async rows(table, where = {}) {
+            return (await knex(table).where(where).select("*"));
+        },
+        async snapshot(specs) {
+            const tables = {};
+            for (const spec of specs) {
+                if (spec.key.length === 0)
+                    throw new Error(`snapshot: ${spec.table} の key が空です`);
+                if (spec.where === undefined) {
+                    options.onWarning?.(`snapshot(${spec.table}): where が無いので全行(最大 ${maxRows} 行)を読みます。testId で絞ることを勧めます`);
+                }
+                const rows = (await applyWhere(knex(spec.table), spec.where).select("*").limit(maxRows + 1));
+                const truncated = rows.length > maxRows;
+                if (truncated) {
+                    rows.length = maxRows;
+                    options.onWarning?.(`snapshot(${spec.table}): ${maxRows} 行を超えたため打ち切りました。diff は信頼できません`);
+                }
+                tables[spec.table] = { spec, rows, truncated };
+            }
+            return { takenAt: new Date().toISOString(), tables };
+        },
+        async diff(snapshot) {
+            const result = {};
+            for (const [table, snap] of Object.entries(snapshot.tables)) {
+                const rows = (await applyWhere(knex(table), snap.spec.where).select("*").limit(maxRows + 1));
+                if (rows.length > maxRows)
+                    rows.length = maxRows;
+                const d = diffRows(snap.rows, rows, snap.spec.key);
+                result[table] = d;
+                for (const inserted of d.inserted) {
+                    cleanupEntries.push({ table, where: pickKey(inserted, snap.spec.key), source: "diff" });
+                }
+            }
+            await options.onDiff?.(result, snapshot);
+            return result;
+        },
+        async expectRow(table, where, expected) {
+            const rows = await db.rows(table, where);
+            if (rows.length !== 1) {
+                throw new Error(`expectRow(${table} where ${JSON.stringify(where)}): ${rows.length} 行でした(1 行を期待)`);
+            }
+            const row = rows[0];
+            const mismatches = [];
+            const d = diffRows([{ ...row, ...expected }], [row], Object.keys(where).length > 0 ? Object.keys(where) : Object.keys(row));
+            for (const u of d.updated) {
+                for (const [col, c] of Object.entries(u.changed))
+                    mismatches.push(`${col}: 期待 ${fmt(c.before)} / 実際 ${fmt(c.after)}`);
+            }
+            if (mismatches.length > 0)
+                throw new Error(`expectRow(${table}): 不一致\n  ${mismatches.join("\n  ")}`);
+            return row;
+        },
+        trackForCleanup(table, where) {
+            cleanupEntries.push({ table, where: { ...where }, source: "diff" });
+        },
+        async cleanup() {
+            const failures = [];
+            let deleted = 0;
+            // 逆順(外部キー: 子 → 親)。同じ行を二重に記録していても 2 回目は 0 件削除で済む
+            for (const entry of [...cleanupEntries].reverse()) {
+                try {
+                    deleted += await knex(entry.table).where(entry.where).delete();
+                }
+                catch (e) {
+                    failures.push({ ...entry, error: e instanceof Error ? e.message : String(e) });
+                }
+            }
+            cleanupEntries.length = 0;
+            return { deleted, failures };
+        },
+    };
+    return db;
+}
+/** knex.raw の戻り値は方言ごとに形が違う。行配列に揃える */
+export function normalizeRawResult(knex, result) {
+    const client = knex.client.config?.client;
+    if (client === "pg") {
+        const r = result;
+        return r.rows ?? [];
+    }
+    if (client === "mysql2") {
+        const r = result;
+        return Array.isArray(r) && Array.isArray(r[0]) ? r[0] : [];
+    }
+    if (client === "oracledb") {
+        return Array.isArray(result) ? result : [];
+    }
+    // mssql / better-sqlite3 は行配列
+    return Array.isArray(result) ? result : [];
+}
+export { diffRows, summarizeDiff };
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

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

package/dist/fixtures.d.ts

@@ -0,0 +1,25 @@
+import { expect } from "@playwright/test";
+import type { Knex } from "knex";
+import { type Bridge } from "./bridge.js";
+import type { E2EWorkerOptions, TrackWhere } from "./config.js";
+import { type Db, type SnapshotSpec } from "./db/index.js";
+import { type HostApp } from "./host.js";
+export interface E2ETestFixtures {
+    testId: string;
+    db: Db;
+    bridge: Bridge;
+}
+export interface E2EWorkerFixtures extends E2EWorkerOptions {
+    /** api / host で起動したホスト exe(screen では null) */
+    hostApp: HostApp | null;
+    /** DB 接続(設定が無ければ null) */
+    dbConnection: Knex | null;
+    /** playwright.config.ts のあるディレクトリ(パスの基準) */
+    appRoot: string;
+}
+export declare function makeTestId(now?: Date, random?: string): string;
+/** TrackSpec の where を snapshot 用に解決する("{testId}" の置換 / 関数への testId 注入) */
+export declare function resolveTrackWhere(where: TrackWhere | undefined, testId: string): SnapshotSpec["where"];
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & E2ETestFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & E2EWorkerFixtures>;
+export { expect };
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAWA,OAAO,EAAgB,MAAM,EAAa,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAuC,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAa,gBAAgB,EAAoB,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAY,KAAK,EAAE,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAGrE,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,EAAE,CAAC;IACP,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,8CAA8C;IAC9C,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,0BAA0B;IAC1B,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,GAAG,GAAE,IAAiB,EAAE,MAAM,GAAE,MAA+C,GAAG,MAAM,CAGlH;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAMtG;AAmBD,eAAO,MAAM,IAAI,mRA0Hf,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC"}