@rawsql-ts/testkit-sqlite 1.0.1

package/README.md

@@ -0,0 +1,67 @@
+# @rawsql-ts/testkit-sqlite
+
+![npm version](https://img.shields.io/npm/v/@rawsql-ts/testkit-sqlite)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+
+SQLite driver adapter for running repository tests entirely in-memory by shadowing tables with fixture-backed CTEs. Built on `@rawsql-ts/testkit-core` for schema validation and SQL rewrites.
+
+## Features
+
+- In-memory testing with `better-sqlite3`
+- Transparent query interception via `wrapSqliteDriver`
+- Scenario-specific fixture overrides with `withFixtures`
+- Schema registry support for consistent large test suites
+
+## Installation
+
+```bash
+npm install @rawsql-ts/testkit-sqlite
+```
+
+## Quick Start
+
+```ts
+import Database from 'better-sqlite3';
+import { createSqliteSelectTestDriver } from '@rawsql-ts/testkit-sqlite';
+
+const driver = createSqliteSelectTestDriver({
+  connectionFactory: () => new Database(':memory:'),
+  fixtures: [
+    {
+      tableName: 'users',
+      rows: [{ id: 1, name: 'Alice', role: 'admin' }],
+      schema: { columns: { id: 'INTEGER', name: 'TEXT', role: 'TEXT' } },
+    },
+  ],
+  missingFixtureStrategy: 'error',
+});
+
+const rows = await driver.query('SELECT * FROM users');
+```
+
+Use `driver.withFixtures([...])` to derive a scoped driver with scenario-specific overrides, and `driver.close()` to dispose the connection when done.
+
+## Wrapping an Existing Connection
+
+`wrapSqliteDriver` turns any `better-sqlite3` connection into a transparent proxy that intercepts `prepare`, `exec`, `all`, `get`, and `run` — rewriting SELECT statements into fixture-backed CTEs while passing through everything else.
+
+```ts
+import Database from 'better-sqlite3';
+import { wrapSqliteDriver } from '@rawsql-ts/testkit-sqlite';
+
+const raw = new Database(':memory:');
+const intercepted = wrapSqliteDriver(raw, {
+  fixtures: [
+    { tableName: 'orders', rows: [{ id: 1 }], schema: { columns: { id: 'INTEGER' } } },
+  ],
+  missingFixtureStrategy: 'warn',
+  recordQueries: true,
+});
+
+intercepted.prepare('SELECT * FROM orders').all();
+console.log(intercepted.queries); // inspect emitted SQL
+```
+
+## License
+
+MIT

package/dist/cli/generateSchema.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/generateSchema.js

@@ -0,0 +1,244 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const rawsql_ts_1 = require("rawsql-ts");
+const DEFAULT_OUTPUT = 'schema.json';
+/**
+ * Entry point that parses CLI arguments, builds the SQLite schema map, and writes the output.
+ */
+async function main() {
+    var _a, _b;
+    // Normalize CLI paths to keep behavior consistent regardless of the caller's location.
+    const options = parseArgs(process.argv.slice(2));
+    const resolvedDatabase = (0, node_path_1.resolve)(process.cwd(), options.database);
+    const schema = await buildSchema(resolvedDatabase, options.tables);
+    if (options.perTable) {
+        const outputDir = (0, node_path_1.resolve)(process.cwd(), (_a = options.output) !== null && _a !== void 0 ? _a : 'schema');
+        writeSchemaPerTable(outputDir, schema);
+        console.log(`Saved ${Object.keys(schema).length} tables as individual JSON files in ${outputDir}`);
+        return;
+    }
+    const resolvedOutput = (0, node_path_1.resolve)(process.cwd(), (_b = options.output) !== null && _b !== void 0 ? _b : DEFAULT_OUTPUT);
+    writeSchema(resolvedOutput, schema);
+    console.log(`Saved schema for ${Object.keys(schema).length} tables to ${resolvedOutput}`);
+}
+/**
+ * Parses the CLI arguments consumed by `pnpm schema:generate`.
+ * @param rawArgs - Raw argument tokens provided by the caller.
+ * @returns The normalized CLI options object.
+ */
+function parseArgs(rawArgs) {
+    const options = {};
+    // Walk through the raw arguments and stash values for recognized flags.
+    for (let i = 0; i < rawArgs.length; i += 1) {
+        const arg = rawArgs[i];
+        if (arg === '--help' || arg === '-h') {
+            printUsage();
+            process.exit(0);
+        }
+        if (arg === '--database' || arg === '-d') {
+            options.database = rawArgs[++i];
+            continue;
+        }
+        if (arg === '--per-table') {
+            options.perTable = true;
+            continue;
+        }
+        if (arg === '--output' || arg === '-o') {
+            options.output = rawArgs[++i];
+            continue;
+        }
+        if (arg === '--tables' || arg === '-t') {
+            const value = rawArgs[++i];
+            options.tables = value
+                .split(',')
+                .map((segment) => segment.trim())
+                .filter((segment) => segment.length > 0);
+            continue;
+        }
+        throw new Error(`Unknown option "${arg}". Run with --help for usage.`);
+    }
+    if (!options.database) {
+        throw new Error('Missing --database argument.');
+    }
+    return {
+        database: options.database,
+        output: options.output,
+        tables: options.tables,
+        perTable: options.perTable,
+    };
+}
+/**
+ * Reads CREATE TABLE definitions from the SQLite master table and accumulates parsed column metadata.
+ * @param databasePath - Absolute path to the SQLite database file.
+ * @param filters - Optional list of lower-cased table names to include.
+ * @returns A mapping from normalized table names to schema definitions.
+ */
+async function buildSchema(databasePath, filters) {
+    var _a;
+    // Dynamically import better-sqlite3 so we can surface a clear error when it is missing.
+    const betterSqliteModule = await Promise.resolve().then(() => __importStar(require('better-sqlite3')));
+    const BetterSqlite = ((_a = betterSqliteModule.default) !== null && _a !== void 0 ? _a : betterSqliteModule);
+    const connection = new BetterSqlite(databasePath, { readonly: true, fileMustExist: true });
+    const whitelist = filters ? new Set(filters.map((name) => name.toLowerCase())) : null;
+    const schema = {};
+    try {
+        const rows = connection
+            .prepare("SELECT name, sql FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%' ORDER BY name")
+            .all();
+        // Iterate through every table definition exposed by sqlite_master.
+        for (const row of rows) {
+            const normalizedName = row.name.toLowerCase();
+            if (whitelist && !whitelist.has(normalizedName)) {
+                continue;
+            }
+            if (!row.sql) {
+                // SQLite may omit the CREATE text for virtual or internal structures, so skip those entries.
+                console.warn(`Skipping table "${row.name}" because no CREATE statement could be read.`);
+                continue;
+            }
+            try {
+                const parsed = rawsql_ts_1.SqlParser.parse(row.sql);
+                // Guard against other statements so the schema generator stays focused on CREATE TABLE definitions.
+                if (!isCreateTableStatement(parsed)) {
+                    console.warn(`Skipping "${row.name}" because the parser emitted a non-CREATE TABLE statement.`);
+                    continue;
+                }
+                const createTable = parsed;
+                if (createTable.columns.length === 0) {
+                    console.warn(`Skipping "${row.name}" because the CREATE TABLE statement does not expose columns.`);
+                    continue;
+                }
+                schema[normalizedName] = {
+                    columns: Object.fromEntries(createTable.columns.map((column) => [
+                        column.name.name,
+                        getDeclaredType(column.dataType),
+                    ])),
+                };
+            }
+            catch (error) {
+                console.warn(`Failed to parse table "${row.name}": ${error.message}`);
+            }
+        }
+    }
+    finally {
+        connection.close();
+    }
+    if (Object.keys(schema).length === 0) {
+        throw new Error('No tables were included in the generated schema.');
+    }
+    return schema;
+}
+/**
+ * Serializes the schema map to the specified JSON file, sorting the tables for deterministic output.
+ * @param outputPath - Destination path for the schema JSON document.
+ * @param schema - Table schema definitions to persist.
+ */
+function writeSchema(outputPath, schema) {
+    // Sort table entries to keep the generated JSON deterministic.
+    const ordered = {};
+    Object.keys(schema)
+        .sort()
+        .forEach((name) => {
+        ordered[name] = schema[name];
+    });
+    const directory = (0, node_path_1.dirname)(outputPath);
+    // Ensure the destination folder exists before writing.
+    (0, node_fs_1.mkdirSync)(directory, { recursive: true });
+    (0, node_fs_1.writeFileSync)(outputPath, `${JSON.stringify(ordered, null, 2)}\n`, 'utf8');
+}
+/**
+ * Emits one JSON file per table schema so downstream diffs can focus on individual tables.
+ * @param directory - Directory to persist the per-table JSON artifacts.
+ * @param schema - Table schema definitions to emit individually.
+ */
+function writeSchemaPerTable(directory, schema) {
+    (0, node_fs_1.mkdirSync)(directory, { recursive: true });
+    // Persist each table schema inside its own JSON file for easier diffs.
+    for (const [tableName, definition] of Object.entries(schema)) {
+        const fileName = `${encodeURIComponent(tableName)}.json`;
+        const filePath = (0, node_path_1.resolve)(directory, fileName);
+        (0, node_fs_1.writeFileSync)(filePath, `${JSON.stringify({ [tableName]: definition }, null, 2)}\n`, 'utf8');
+    }
+}
+/**
+ * Guards on CREATE TABLE statements and filters out any other parsed SQL nodes.
+ * @param statement - The AST node emitted by the parser.
+ */
+function isCreateTableStatement(statement) {
+    return statement.getKind() === rawsql_ts_1.CreateTableQuery.kind;
+}
+/**
+ * Retrieves the declared type name from the parser metadata, falling back to literal tokens when necessary.
+ * @param dataType - AST node describing the column's declared type.
+ * @returns The original type text or an empty string when unavailable.
+ */
+function getDeclaredType(dataType) {
+    if (!dataType) {
+        return '';
+    }
+    // Prefer the parser's helper when it exposes the declarative type text.
+    if ('getTypeName' in dataType && typeof dataType.getTypeName === 'function') {
+        return dataType.getTypeName().trim();
+    }
+    // Fall back to direct literal values for simple AST nodes.
+    if ('value' in dataType && typeof dataType.value === 'string') {
+        return dataType.value.trim();
+    }
+    return '';
+}
+/**
+ * Prints the human-friendly CLI usage instructions and exits the process.
+ */
+function printUsage() {
+    console.log(`
+Usage:
+  pnpm --filter @rawsql-ts/testkit-sqlite run schema:generate -- --database <path> [--output <path>] [--tables <names>]
+
+Options:
+  --per-table                Emit per-table JSON files instead of a single schema.json (output path becomes a directory).
+    --database, -d <path>      SQLite database file that hosts the CREATE TABLE statements.
+    --output, -o <path>        Path to write schema.json (defaults to schema.json in the current directory).
+    --tables, -t <names>       Comma-separated list of table names to include (case-insensitive).
+    --help, -h                 Show this message.
+  `);
+}
+void main().catch((error) => {
+    console.error('Schema generation failed:', error.message);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=generateSchema.js.map

package/dist/cli/generateSchema.js.map

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

package/dist/driver/SqliteSelectTestDriver.d.ts

@@ -0,0 +1,46 @@
+import type { TableFixture } from '@rawsql-ts/testkit-core';
+import type { CreateSqliteSelectTestDriverOptions, SqliteConnectionLike, SqliteSelectTestDriver } from '../types';
+export type QueryParams = unknown[] | Record<string, unknown> | undefined;
+/**
+ * Concrete {@link SqliteSelectTestDriver} implementation that rewrites fixtures
+ * before delegating to the underlying SQLite connection.
+ */
+export declare class SqliteSelectTestDriverImpl implements SqliteSelectTestDriver {
+    private readonly options;
+    private readonly scopedFixtures?;
+    private connection?;
+    private readonly rewriter;
+    constructor(options: CreateSqliteSelectTestDriverOptions, scopedFixtures?: TableFixture[] | undefined, seedConnection?: SqliteConnectionLike);
+    query<T = unknown>(sql: string, params?: QueryParams): Promise<T[]>;
+    withFixtures(fixtures: TableFixture[]): SqliteSelectTestDriver;
+    close(): void;
+    private getConnection;
+    private execute;
+    private runStatement;
+    private invokeConnectionMethod;
+    private normalizeParams;
+}
+/**
+ * Creates a lightweight SQLite test driver that injects fixture-backed CTEs before delegating to the real driver.
+ * @param options Driver options that provide the connection factory plus rewrite behavior inherited from testkit-core.
+ * @returns An implementation that exposes `query`, `withFixtures`, and `close` helpers for SELECT-first tests.
+ * @example
+ * ```ts
+ * import Database from 'better-sqlite3';
+ * import { createSqliteSelectTestDriver } from '@rawsql-ts/testkit-sqlite';
+ *
+ * const driver = createSqliteSelectTestDriver({
+ *   connectionFactory: () => new Database(':memory:'),
+ *   fixtures: [
+ *     {
+ *       tableName: 'users',
+ *       rows: [{ id: 1, email: 'demo@example.com' }],
+ *     },
+ *   ],
+ * });
+ *
+ * const rows = await driver.query('SELECT id, email FROM users');
+ * console.log(rows);
+ * ```
+ */
+export declare const createSqliteSelectTestDriver: (options: CreateSqliteSelectTestDriverOptions) => SqliteSelectTestDriver;

package/dist/driver/SqliteSelectTestDriver.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSqliteSelectTestDriver = exports.SqliteSelectTestDriverImpl = void 0;
+const testkit_core_1 = require("@rawsql-ts/testkit-core");
+/**
+ * Concrete {@link SqliteSelectTestDriver} implementation that rewrites fixtures
+ * before delegating to the underlying SQLite connection.
+ */
+class SqliteSelectTestDriverImpl {
+    constructor(options, scopedFixtures, seedConnection) {
+        this.options = options;
+        this.scopedFixtures = scopedFixtures;
+        this.rewriter = new testkit_core_1.SelectFixtureRewriter(options);
+        this.connection = seedConnection;
+    }
+    async query(sql, params) {
+        // Rewrite the incoming SQL so fixture-backed CTEs shadow physical tables.
+        const context = this.scopedFixtures ? { fixtures: this.scopedFixtures } : undefined;
+        const rewritten = this.rewriter.rewrite(sql, context);
+        // Execute the rewritten SQL via the configured driver surface.
+        const rows = this.execute(rewritten.sql, params);
+        return Promise.resolve(rows);
+    }
+    withFixtures(fixtures) {
+        // Pass along the current connection so scoped drivers reuse the same DB handle.
+        const next = new SqliteSelectTestDriverImpl(this.options, fixtures, this.connection);
+        return next;
+    }
+    close() {
+        if (this.connection && typeof this.connection.close === 'function') {
+            // Allow upstream driver to dispose any native handles.
+            this.connection.close();
+            this.connection = undefined;
+        }
+    }
+    getConnection() {
+        if (!this.connection) {
+            // Lazily hydrate the driver so tests can swap factories per suite.
+            this.connection = this.options.connectionFactory();
+        }
+        return this.connection;
+    }
+    execute(sql, params) {
+        const connection = this.getConnection();
+        // Prefer prepared statements when the driver exposes them.
+        if (typeof connection.prepare === 'function') {
+            const statement = connection.prepare(sql);
+            if (statement) {
+                return this.runStatement(statement, params);
+            }
+        }
+        // Fall back to high-level helpers such as db.all(sql, params).
+        if (typeof connection.all === 'function') {
+            const rows = this.invokeConnectionMethod(connection.all, connection, sql, params);
+            return rows !== null && rows !== void 0 ? rows : [];
+        }
+        if (typeof connection.get === 'function') {
+            const record = this.invokeConnectionMethod(connection.get, connection, sql, params);
+            return record ? [record] : [];
+        }
+        if (typeof connection.run === 'function') {
+            this.invokeConnectionMethod(connection.run, connection, sql, params);
+            return [];
+        }
+        throw new Error('SQLite connection does not expose prepare/all/get/run methods.');
+    }
+    runStatement(statement, params) {
+        const args = this.normalizeParams(params);
+        // Leverage the strongest method the statement exposes.
+        if (typeof statement.all === 'function') {
+            const rows = statement.all(...args);
+            return rows !== null && rows !== void 0 ? rows : [];
+        }
+        if (typeof statement.get === 'function') {
+            const record = statement.get(...args);
+            return record ? [record] : [];
+        }
+        if (typeof statement.run === 'function') {
+            statement.run(...args);
+            return [];
+        }
+        throw new Error('Prepared statement does not expose all/get/run helpers.');
+    }
+    invokeConnectionMethod(method, connection, sql, params) {
+        // Normalize params once so every driver helper sees the same calling convention.
+        const args = this.normalizeParams(params);
+        if (args.length === 0) {
+            return method.call(connection, sql);
+        }
+        return method.call(connection, sql, ...args);
+    }
+    normalizeParams(params) {
+        if (!params) {
+            return [];
+        }
+        if (Array.isArray(params)) {
+            return params;
+        }
+        return [params];
+    }
+}
+exports.SqliteSelectTestDriverImpl = SqliteSelectTestDriverImpl;
+/**
+ * Creates a lightweight SQLite test driver that injects fixture-backed CTEs before delegating to the real driver.
+ * @param options Driver options that provide the connection factory plus rewrite behavior inherited from testkit-core.
+ * @returns An implementation that exposes `query`, `withFixtures`, and `close` helpers for SELECT-first tests.
+ * @example
+ * ```ts
+ * import Database from 'better-sqlite3';
+ * import { createSqliteSelectTestDriver } from '@rawsql-ts/testkit-sqlite';
+ *
+ * const driver = createSqliteSelectTestDriver({
+ *   connectionFactory: () => new Database(':memory:'),
+ *   fixtures: [
+ *     {
+ *       tableName: 'users',
+ *       rows: [{ id: 1, email: 'demo@example.com' }],
+ *     },
+ *   ],
+ * });
+ *
+ * const rows = await driver.query('SELECT id, email FROM users');
+ * console.log(rows);
+ * ```
+ */
+const createSqliteSelectTestDriver = (options) => {
+    return new SqliteSelectTestDriverImpl(options);
+};
+exports.createSqliteSelectTestDriver = createSqliteSelectTestDriver;
+//# sourceMappingURL=SqliteSelectTestDriver.js.map

package/dist/driver/SqliteSelectTestDriver.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export { createSqliteSelectTestDriver } from './driver/SqliteSelectTestDriver';
+export { wrapSqliteDriver } from './proxy/wrapSqliteDriver';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapSqliteDriver = exports.createSqliteSelectTestDriver = void 0;
+__exportStar(require("./types"), exports);
+var SqliteSelectTestDriver_1 = require("./driver/SqliteSelectTestDriver");
+Object.defineProperty(exports, "createSqliteSelectTestDriver", { enumerable: true, get: function () { return SqliteSelectTestDriver_1.createSqliteSelectTestDriver; } });
+var wrapSqliteDriver_1 = require("./proxy/wrapSqliteDriver");
+Object.defineProperty(exports, "wrapSqliteDriver", { enumerable: true, get: function () { return wrapSqliteDriver_1.wrapSqliteDriver; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,0EAA+E;AAAtE,sIAAA,4BAA4B,OAAA;AACrC,6DAA4D;AAAnD,oHAAA,gBAAgB,OAAA"}

package/dist/proxy/wrapSqliteDriver.d.ts

@@ -0,0 +1,23 @@
+import type { SqliteConnectionLike, WrapSqliteDriverOptions, WrappedSqliteDriver } from '../types';
+/**
+ * Wraps a SQLite connection so every SELECT/CTE statement is rewritten with fixture-backed CTEs before execution.
+ * @param driver Native connection (e.g. better-sqlite3, sqlite3) whose SELECT queries should honor rewrites.
+ * @param options Configuration that controls fixtures, rewrite strategy, execution hooks, and optional query logging.
+ * @returns A proxied driver that transparently rewrites queries, surfaces an optional `queries` log, and supports `withFixtures`.
+ * @example
+ * ```ts
+ * import Database from 'better-sqlite3';
+ * import { wrapSqliteDriver } from '@rawsql-ts/testkit-sqlite';
+ *
+ * const db = wrapSqliteDriver(new Database(':memory:'), {
+ *   fixtures: [
+ *     { tableName: 'accounts', rows: [{ id: 42, tier: 'pro' }] },
+ *   ],
+ *   recordQueries: true,
+ * });
+ *
+ * const rows = db.all('SELECT id, tier FROM accounts');
+ * console.log(rows, db.queries);
+ * ```
+ */
+export declare const wrapSqliteDriver: <T extends SqliteConnectionLike>(driver: T, options: WrapSqliteDriverOptions) => WrappedSqliteDriver<T>;

package/dist/proxy/wrapSqliteDriver.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapSqliteDriver = void 0;
+const testkit_core_1 = require("@rawsql-ts/testkit-core");
+const normalizeParams = (args) => {
+    if (args.length === 0) {
+        return undefined;
+    }
+    if (args.length === 1) {
+        return args[0];
+    }
+    return args;
+};
+const isSelectableQuery = (sql) => {
+    const trimmed = sql.trimStart();
+    if (trimmed.length === 0) {
+        return false;
+    }
+    const upper = trimmed.toUpperCase();
+    if (upper.startsWith('SELECT') || upper.startsWith('WITH')) {
+        return true;
+    }
+    if (upper.startsWith('EXPLAIN')) {
+        return /\bSELECT\b/i.test(upper);
+    }
+    return false;
+};
+/**
+ * Wraps a SQLite connection so every SELECT/CTE statement is rewritten with fixture-backed CTEs before execution.
+ * @param driver Native connection (e.g. better-sqlite3, sqlite3) whose SELECT queries should honor rewrites.
+ * @param options Configuration that controls fixtures, rewrite strategy, execution hooks, and optional query logging.
+ * @returns A proxied driver that transparently rewrites queries, surfaces an optional `queries` log, and supports `withFixtures`.
+ * @example
+ * ```ts
+ * import Database from 'better-sqlite3';
+ * import { wrapSqliteDriver } from '@rawsql-ts/testkit-sqlite';
+ *
+ * const db = wrapSqliteDriver(new Database(':memory:'), {
+ *   fixtures: [
+ *     { tableName: 'accounts', rows: [{ id: 42, tier: 'pro' }] },
+ *   ],
+ *   recordQueries: true,
+ * });
+ *
+ * const rows = db.all('SELECT id, tier FROM accounts');
+ * console.log(rows, db.queries);
+ * ```
+ */
+const wrapSqliteDriver = (driver, options) => {
+    const rewriter = new testkit_core_1.SelectFixtureRewriter(options);
+    const buildProxy = (scopedFixtures) => {
+        const queryLog = options.recordQueries ? [] : undefined;
+        const shouldObserve = Boolean(options.onExecute || queryLog);
+        // Fan out execution details to the configured hook and optional in-memory log.
+        const handleExecution = (method, sql, args, fixtures) => {
+            var _a;
+            if (!shouldObserve) {
+                return;
+            }
+            const params = normalizeParams(args);
+            (_a = options.onExecute) === null || _a === void 0 ? void 0 : _a.call(options, sql, params);
+            queryLog === null || queryLog === void 0 ? void 0 : queryLog.push({
+                method: typeof method === 'string' ? method : String(method),
+                sql,
+                params,
+                fixtures,
+            });
+        };
+        const wrapStatement = (statement, sql, fixtures) => {
+            if (!shouldObserve || !statement) {
+                return statement;
+            }
+            return new Proxy(statement, {
+                get(stmtTarget, stmtProp, stmtReceiver) {
+                    const stmtValue = Reflect.get(stmtTarget, stmtProp, stmtReceiver);
+                    if (typeof stmtValue !== 'function') {
+                        return stmtValue;
+                    }
+                    if (stmtProp === 'all' || stmtProp === 'get' || stmtProp === 'run') {
+                        return (...stmtArgs) => {
+                            handleExecution(stmtProp, sql, stmtArgs, fixtures);
+                            return stmtValue.apply(stmtTarget, stmtArgs);
+                        };
+                    }
+                    return stmtValue.bind(stmtTarget);
+                },
+            });
+        };
+        return new Proxy(driver, {
+            get(target, prop, receiver) {
+                if (prop === 'withFixtures') {
+                    return (fixtures) => buildProxy(fixtures);
+                }
+                if (prop === 'queries') {
+                    return queryLog;
+                }
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value !== 'function') {
+                    return value;
+                }
+                if (prop === 'prepare') {
+                    return (sql, ...rest) => {
+                        if (typeof sql !== 'string' || !isSelectableQuery(sql)) {
+                            return value.apply(target, [sql, ...rest]);
+                        }
+                        const context = scopedFixtures ? { fixtures: scopedFixtures } : undefined;
+                        const rewritten = rewriter.rewrite(sql, context);
+                        const statement = value.apply(target, [rewritten.sql, ...rest]);
+                        return wrapStatement(statement, rewritten.sql, rewritten.fixturesApplied);
+                    };
+                }
+                if (prop === 'exec') {
+                    return (sql, ...rest) => {
+                        if (typeof sql !== 'string' || !isSelectableQuery(sql)) {
+                            return value.apply(target, [sql, ...rest]);
+                        }
+                        const context = scopedFixtures ? { fixtures: scopedFixtures } : undefined;
+                        const rewritten = rewriter.rewrite(sql, context);
+                        handleExecution(prop, rewritten.sql, rest, rewritten.fixturesApplied);
+                        return value.apply(target, [rewritten.sql, ...rest]);
+                    };
+                }
+                if (prop === 'all' || prop === 'get' || prop === 'run') {
+                    return (sql, ...rest) => {
+                        if (typeof sql !== 'string' || !isSelectableQuery(sql)) {
+                            return value.apply(target, [sql, ...rest]);
+                        }
+                        const context = scopedFixtures ? { fixtures: scopedFixtures } : undefined;
+                        const rewritten = rewriter.rewrite(sql, context);
+                        handleExecution(prop, rewritten.sql, rest, rewritten.fixturesApplied);
+                        return value.apply(target, [rewritten.sql, ...rest]);
+                    };
+                }
+                return value.bind(target);
+            },
+        });
+    };
+    return buildProxy();
+};
+exports.wrapSqliteDriver = wrapSqliteDriver;
+//# sourceMappingURL=wrapSqliteDriver.js.map

package/dist/proxy/wrapSqliteDriver.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,40 @@
+import type { SelectRewriterOptions } from '@rawsql-ts/testkit-core';
+import type { TableFixture } from '@rawsql-ts/testkit-core';
+export interface SqliteStatementLike {
+    all?(...params: unknown[]): unknown[] | undefined;
+    get?(...params: unknown[]): unknown;
+    run?(...params: unknown[]): unknown;
+}
+export interface SqliteConnectionLike {
+    prepare?(sql: string, ...params: unknown[]): SqliteStatementLike;
+    all?(sql: string, ...params: unknown[]): unknown[] | undefined;
+    get?(sql: string, ...params: unknown[]): unknown;
+    run?(sql: string, ...params: unknown[]): unknown;
+    exec?(sql: string, ...params: unknown[]): unknown;
+    pragma?(statement: string, ...params: unknown[]): unknown;
+    close?(): void;
+}
+export interface SelectDriver<T = unknown> {
+    query<U = T>(sql: string, params?: unknown[]): Promise<U[]>;
+}
+export interface CreateSqliteSelectTestDriverOptions extends SelectRewriterOptions {
+    connectionFactory: () => SqliteConnectionLike;
+}
+export interface SqliteSelectTestDriver extends SelectDriver {
+    withFixtures(fixtures: TableFixture[]): SqliteSelectTestDriver;
+    close(): void;
+}
+export interface WrappedSqlQueryLogEntry {
+    method: string;
+    sql: string;
+    params?: unknown;
+    fixtures?: string[];
+}
+export interface WrapSqliteDriverOptions extends SelectRewriterOptions {
+    onExecute?(sql: string, params?: unknown): void;
+    recordQueries?: boolean;
+}
+export type WrappedSqliteDriver<T> = T & {
+    withFixtures(fixtures: TableFixture[]): WrappedSqliteDriver<T>;
+    queries?: WrappedSqlQueryLogEntry[];
+};

package/dist/types/index.js

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

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@rawsql-ts/testkit-sqlite",
+  "version": "1.0.1",
+  "description": "SQLite driver adapters for the rawsql-ts select query test harness.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "prepack": "node -e \"const fs=require('fs');const cp=require('child_process');const npm=process.platform==='win32'?'npm.cmd':'npm';if(!fs.existsSync('dist/index.js')){process.exit(cp.spawnSync(npm,['run','build'],{stdio:'inherit'}).status??1)}\"",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src tests --ext .ts",
+    "schema:generate": "ts-node --project tsconfig.json src/cli/generateSchema.ts",
+    "postinstall": "node ./scripts/install-better-sqlite3.cjs",
+    "release": "npm run lint && npm run test && npm run build && node -e \"require('fs').mkdirSync('../../tmp', { recursive: true })\" && pnpm pack --out ../../tmp/rawsql-ts-testkit-sqlite.tgz && pnpm publish --access public"
+  },
+  "keywords": [
+    "sqlite",
+    "testing",
+    "fixtures",
+    "rawsql"
+  ],
+  "license": "MIT",
+  "author": "msugiura",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mk3008/rawsql-ts.git",
+    "directory": "packages/testkit-sqlite"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@rawsql-ts/testkit-core": "workspace:^",
+    "rawsql-ts": "workspace:^"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.4.1",
+    "dotenv": "^16.4.7",
+    "typescript": "^5.8.2",
+    "vitest": "^4.0.7",
+    "ts-node": "^10.9.2"
+  },
+  "files": [
+    "dist"
+  ]
+}