@rawsql-ts/ztd-cli 0.15.0 → 0.17.0

package/templates/dist/testkit-core/src/errors/index.d.ts

@@ -0,0 +1,49 @@
+import type { MissingFixtureStrategy } from '../types';
+import type { DdlLintDiagnostic } from '../fixtures/ddlLint';
+export interface MissingFixtureColumnDetail {
+    name: string;
+    typeName: string;
+}
+export interface MissingFixtureDiagnostics {
+    tableName: string;
+    sql?: string;
+    strategy: MissingFixtureStrategy;
+    schemaColumns?: MissingFixtureColumnDetail[];
+    schemaSource?: 'fixture' | 'schema';
+}
+/**
+ * Raised when the rewriter cannot locate fixture data for a referenced table.
+ */
+export declare class MissingFixtureError extends Error {
+    readonly diagnostics: MissingFixtureDiagnostics;
+    constructor(diagnostics: MissingFixtureDiagnostics);
+    private static buildMessage;
+    /**
+     * Produces a compact preview of the provided SQL snippet for diagnostics.
+     */
+    private static formatSqlSnippet;
+    /**
+     * Builds a human-readable template that mirrors the missing fixture schema.
+     */
+    private static buildFixtureTemplate;
+}
+/**
+ * Signals that a fixture schema definition lacks required metadata or is inconsistent.
+ */
+export declare class SchemaValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Wraps unexpected failures encountered during select statement rewriting.
+ */
+export declare class QueryRewriteError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * Raised when DDL linting detects integrity issues.
+ */
+export declare class DdlLintError extends Error {
+    readonly diagnostics: DdlLintDiagnostic[];
+    constructor(diagnostics: DdlLintDiagnostic[]);
+}

package/templates/dist/testkit-core/src/errors/index.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DdlLintError = exports.QueryRewriteError = exports.SchemaValidationError = exports.MissingFixtureError = void 0;
+const ddlLint_1 = require("../fixtures/ddlLint");
+/**
+ * Raised when the rewriter cannot locate fixture data for a referenced table.
+ */
+class MissingFixtureError extends Error {
+    constructor(diagnostics) {
+        super(MissingFixtureError.buildMessage(diagnostics));
+        this.diagnostics = diagnostics;
+        this.name = 'MissingFixtureError';
+    }
+    static buildMessage(diagnostics) {
+        const lines = [];
+        lines.push(`Fixture for table "${diagnostics.tableName}" was not provided.`);
+        lines.push('');
+        lines.push('Diagnostics:');
+        lines.push(`  - Strategy: ${diagnostics.strategy}`);
+        lines.push(`  - Table: ${diagnostics.tableName}`);
+        if (diagnostics.sql) {
+            lines.push(`  - SQL snippet: ${MissingFixtureError.formatSqlSnippet(diagnostics.sql)}`);
+        }
+        if (diagnostics.schemaColumns && diagnostics.schemaColumns.length > 0) {
+            const sourceLabel = diagnostics.schemaSource === 'schema' ? 'schema registry' : 'fixture metadata';
+            lines.push(`  - Required columns (${sourceLabel}):`);
+            diagnostics.schemaColumns.forEach((column) => {
+                lines.push(`      • ${column.name} (${column.typeName})`);
+            });
+            lines.push('  - Suggested fixture template:');
+            lines.push(...MissingFixtureError.buildFixtureTemplate(diagnostics.tableName, diagnostics.schemaColumns));
+        }
+        else {
+            lines.push('  - Column definitions: unavailable. Register schema via options.schema or include schema per fixture.');
+        }
+        lines.push('');
+        lines.push('Next steps:');
+        lines.push('  1. Declare a fixture for the table with the columns listed above.');
+        lines.push('  2. Provide at least one row so rewritten SELECT statements shadow the physical table.');
+        lines.push('  3. Pass fixtures via SelectRewriterOptions.fixtures or rewrite context overrides.');
+        return lines.join('\n');
+    }
+    /**
+     * Produces a compact preview of the provided SQL snippet for diagnostics.
+     */
+    static formatSqlSnippet(sql) {
+        const compact = sql.replace(/\s+/g, ' ').trim();
+        const limit = 280;
+        if (compact.length <= limit) {
+            return compact;
+        }
+        return `${compact.slice(0, limit)}…`;
+    }
+    /**
+     * Builds a human-readable template that mirrors the missing fixture schema.
+     */
+    static buildFixtureTemplate(tableName, columns) {
+        const indent = (level) => ' '.repeat(level * 2);
+        const template = [];
+        template.push(`${indent(3)}{`);
+        template.push(`${indent(4)}tableName: '${tableName}',`);
+        template.push(`${indent(4)}schema: {`);
+        template.push(`${indent(5)}columns: {`);
+        columns.forEach((column, index) => {
+            const suffix = index === columns.length - 1 ? '' : ',';
+            template.push(`${indent(6)}${column.name}: '${column.typeName}'${suffix}`);
+        });
+        template.push(`${indent(5)}}`);
+        template.push(`${indent(4)}},`);
+        template.push(`${indent(4)}rows: [`);
+        const rowExample = columns.map((column) => `${column.name}: /* ${column.typeName} */`).join(', ');
+        template.push(`${indent(5)}{ ${rowExample} }`);
+        template.push(`${indent(4)}],`);
+        template.push(`${indent(3)}}`);
+        return template;
+    }
+}
+exports.MissingFixtureError = MissingFixtureError;
+/**
+ * Signals that a fixture schema definition lacks required metadata or is inconsistent.
+ */
+class SchemaValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SchemaValidationError';
+    }
+}
+exports.SchemaValidationError = SchemaValidationError;
+/**
+ * Wraps unexpected failures encountered during select statement rewriting.
+ */
+class QueryRewriteError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'QueryRewriteError';
+    }
+}
+exports.QueryRewriteError = QueryRewriteError;
+/**
+ * Raised when DDL linting detects integrity issues.
+ */
+class DdlLintError extends Error {
+    constructor(diagnostics) {
+        super((0, ddlLint_1.formatDdlLintDiagnostics)(diagnostics));
+        this.diagnostics = diagnostics;
+        this.name = 'DdlLintError';
+    }
+}
+exports.DdlLintError = DdlLintError;
+//# sourceMappingURL=index.js.map

package/templates/dist/testkit-core/src/errors/index.js.map

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

package/templates/dist/testkit-core/src/fixtures/ColumnAffinity.d.ts

@@ -0,0 +1,5 @@
+export type ColumnAffinity = 'TEXT' | 'INTEGER' | 'REAL' | 'NUMERIC' | 'BLOB';
+/**
+ * Guesses the SQLite affinity category from the declared type name using SQLite's affinity rules.
+ */
+export declare function guessAffinity(typeName?: string): ColumnAffinity;

package/templates/dist/testkit-core/src/fixtures/ColumnAffinity.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guessAffinity = guessAffinity;
+const DEFAULT_AFFINITY = 'TEXT';
+const affinityPatterns = [
+    { pattern: /(int|serial|numeric|decimal|money)/i, affinity: 'INTEGER' },
+    { pattern: /(real|double|float)/i, affinity: 'REAL' },
+    { pattern: /(blob|bytea|binary|varbinary|raw)/i, affinity: 'BLOB' },
+    { pattern: /(bool|boolean)/i, affinity: 'INTEGER' },
+    { pattern: /(text|char|string|clob|json)/i, affinity: 'TEXT' },
+];
+/**
+ * Guesses the SQLite affinity category from the declared type name using SQLite's affinity rules.
+ */
+function guessAffinity(typeName) {
+    if (!typeName) {
+        // Fall back to TEXT when the column lacks an explicit type hint.
+        return DEFAULT_AFFINITY;
+    }
+    const normalized = typeName.toLowerCase().trim();
+    // Try to match against the ordered heuristics; later entries act as catch-alls.
+    for (const entry of affinityPatterns) {
+        if (entry.pattern.test(normalized)) {
+            return entry.affinity;
+        }
+    }
+    return DEFAULT_AFFINITY;
+}
+//# sourceMappingURL=ColumnAffinity.js.map

package/templates/dist/testkit-core/src/fixtures/ColumnAffinity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnAffinity.js","sourceRoot":"","sources":["../../../../../../testkit-core/src/fixtures/ColumnAffinity.ts"],"names":[],"mappings":";;AAeA,sCAgBC;AA7BD,MAAM,gBAAgB,GAAmB,MAAM,CAAC;AAEhD,MAAM,gBAAgB,GAAyD;IAC7E,EAAE,OAAO,EAAE,qCAAqC,EAAE,QAAQ,EAAE,SAAS,EAAE;IACvE,EAAE,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,EAAE;IACrD,EAAE,OAAO,EAAE,oCAAoC,EAAE,QAAQ,EAAE,MAAM,EAAE;IACnE,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE;IACnD,EAAE,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,MAAM,EAAE;CAC/D,CAAC;AAEF;;GAEG;AACH,SAAgB,aAAa,CAAC,QAAiB;IAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,iEAAiE;QACjE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAEjD,gFAAgF;IAChF,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/templates/dist/testkit-core/src/fixtures/DdlFixtureLoader.d.ts

@@ -0,0 +1,37 @@
+import type { TableDefinitionModel } from 'rawsql-ts';
+import type { FixtureRow } from '../types';
+import { TableNameResolver } from './TableNameResolver';
+import { type DdlLintMode } from './ddlLint';
+export interface DdlFixtureLoaderOptions {
+    directories: string[];
+    extensions?: string[];
+    tableNameResolver?: TableNameResolver;
+    ddlLint?: DdlLintMode;
+}
+export interface DdlProcessedFixture {
+    tableDefinition: TableDefinitionModel;
+    rows?: FixtureRow[];
+}
+export declare class DdlFixtureLoader {
+    private readonly options;
+    private static readonly cache;
+    private readonly resolvedDirectories;
+    private readonly extensions;
+    private readonly cacheKey;
+    private fixtures;
+    private fixturesByName;
+    private loaded;
+    private readonly tableNameResolver?;
+    private readonly ddlLintMode;
+    constructor(options: DdlFixtureLoaderOptions);
+    getFixtures(): DdlProcessedFixture[];
+    getFixture(tableName: string): DdlProcessedFixture | undefined;
+    private ensureLoaded;
+    private registerFixtures;
+    private loadFromDirectories;
+    private collectSqlFiles;
+    private loadFile;
+    private static buildCacheKey;
+    private runDdlLint;
+    private resolveTableKey;
+}

package/templates/dist/testkit-core/src/fixtures/DdlFixtureLoader.js

@@ -0,0 +1,182 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DdlFixtureLoader = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const rawsql_ts_1 = require("rawsql-ts");
+const ddlLint_1 = require("./ddlLint");
+const errors_1 = require("../errors");
+class DdlFixtureLoader {
+    constructor(options) {
+        var _a;
+        this.options = options;
+        this.fixtures = [];
+        this.fixturesByName = new Map();
+        this.loaded = false;
+        // Resolve directories up front so cache keys stay consistent across calls.
+        this.resolvedDirectories = options.directories.map((directory) => node_path_1.default.resolve(directory));
+        this.extensions = ((_a = options.extensions) !== null && _a !== void 0 ? _a : ['.sql']).map((ext) => ext.toLowerCase());
+        // Include resolver settings in the cache key to avoid mixing schema snapshots.
+        this.cacheKey = DdlFixtureLoader.buildCacheKey(this.resolvedDirectories, this.extensions, options.tableNameResolver, (0, ddlLint_1.normalizeDdlLintMode)(options.ddlLint));
+        this.tableNameResolver = options.tableNameResolver;
+        this.ddlLintMode = (0, ddlLint_1.normalizeDdlLintMode)(options.ddlLint);
+    }
+    getFixtures() {
+        this.ensureLoaded();
+        return [...this.fixtures];
+    }
+    getFixture(tableName) {
+        this.ensureLoaded();
+        const normalized = (0, rawsql_ts_1.normalizeTableName)(tableName);
+        return this.fixturesByName.get(normalized);
+    }
+    ensureLoaded() {
+        if (this.loaded) {
+            return;
+        }
+        // Reuse previously parsed fixtures when the same directories were processed before.
+        const cached = DdlFixtureLoader.cache.get(this.cacheKey);
+        if (cached) {
+            this.registerFixtures(cached);
+            this.loaded = true;
+            return;
+        }
+        // Load fixtures from disk and store them in the shared cache key.
+        const collected = this.loadFromDirectories();
+        DdlFixtureLoader.cache.set(this.cacheKey, collected);
+        this.registerFixtures(collected);
+        this.loaded = true;
+    }
+    registerFixtures(fixtures) {
+        this.fixtures = fixtures;
+        this.fixturesByName = new Map();
+        for (const fixture of fixtures) {
+            const normalized = this.resolveTableKey(fixture.tableDefinition.name);
+            this.fixturesByName.set(normalized, fixture);
+        }
+    }
+    loadFromDirectories() {
+        // Verify every configured directory exists before scanning to provide fail-fast diagnostics.
+        const missingDirectories = this.resolvedDirectories.filter((directory) => !(0, node_fs_1.existsSync)(directory));
+        if (missingDirectories.length) {
+            throw new Error(`DDL directories were not found: ${missingDirectories.join(', ')}. Please review the configured ddl.directories paths.`);
+        }
+        const fixtures = [];
+        const diagnostics = { sqlFileCount: 0 };
+        const sources = [];
+        // Walk each directory recursively to collect SQL files and keep track of what was discovered.
+        for (const directory of this.resolvedDirectories) {
+            this.collectSqlFiles(directory, fixtures, diagnostics, sources);
+        }
+        if (diagnostics.sqlFileCount === 0) {
+            throw new Error(`No SQL files (${this.extensions.join(', ')}) were discovered under ${this.resolvedDirectories.join(', ')}. Please place valid SQL fixtures in the configured directories.`);
+        }
+        // Run lint checks before enforcing CREATE TABLE presence so actionable diagnostics surface first.
+        this.runDdlLint(sources);
+        if (fixtures.length === 0) {
+            throw new Error(`SQL files were found under ${this.resolvedDirectories.join(', ')}, but no CREATE TABLE statements produced fixtures. Please verify the files contain valid DDL.`);
+        }
+        return fixtures;
+    }
+    collectSqlFiles(directory, fixtures, diagnostics, sources) {
+        // Skip directories that are missing so optional paths are acceptable.
+        if (!(0, node_fs_1.existsSync)(directory)) {
+            return;
+        }
+        const entries = (0, node_fs_1.readdirSync)(directory, { withFileTypes: true });
+        for (const entry of entries) {
+            const resolved = node_path_1.default.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                this.collectSqlFiles(resolved, fixtures, diagnostics, sources);
+                continue;
+            }
+            const extension = node_path_1.default.extname(entry.name).toLowerCase();
+            if (!entry.isFile() || !this.extensions.includes(extension)) {
+                continue;
+            }
+            // Record that a SQL file was encountered regardless of whether it contained definitions.
+            diagnostics.sqlFileCount += 1;
+            this.loadFile(resolved, fixtures, sources);
+        }
+    }
+    loadFile(filePath, fixtures, sources) {
+        var _a, _b;
+        const sql = (0, node_fs_1.readFileSync)(filePath, 'utf8');
+        if (!sql.trim()) {
+            return;
+        }
+        // Preserve a workspace-relative path so diagnostics remain portable.
+        const sourcePath = node_path_1.default
+            .relative(process.cwd(), filePath)
+            .replace(/\\/g, '/');
+        sources.push({ path: sourcePath, sql });
+        // Convert every CREATE TABLE/INSERT block into a table definition bundle.
+        const fixtureJson = rawsql_ts_1.DDLToFixtureConverter.convert(sql);
+        for (const [tableName, definition] of Object.entries(fixtureJson)) {
+            const rawDefinition = definition;
+            const columns = (_b = (_a = rawDefinition.columns) === null || _a === void 0 ? void 0 : _a.map((column) => {
+                var _a;
+                return ({
+                    name: column.name,
+                    typeName: column.type,
+                    required: false,
+                    defaultValue: (_a = column.default) !== null && _a !== void 0 ? _a : null,
+                });
+            })) !== null && _b !== void 0 ? _b : [];
+            const rows = Array.isArray(rawDefinition.rows) && rawDefinition.rows.length > 0 ? rawDefinition.rows : undefined;
+            // Avoid duplicate fixtures for the same canonical table key.
+            const canonicalKey = this.resolveTableKey(tableName);
+            if (fixtures.some((fixture) => this.resolveTableKey(fixture.tableDefinition.name) === canonicalKey)) {
+                continue;
+            }
+            fixtures.push({
+                tableDefinition: {
+                    name: tableName,
+                    columns,
+                },
+                rows,
+            });
+        }
+    }
+    static buildCacheKey(directories, extensions, resolver, ddlLintMode = ddlLint_1.DEFAULT_DDL_LINT_MODE) {
+        var _a;
+        // Normalize directories and extensions so the cache key stays deterministic regardless of iteration order.
+        const normalizedDirectories = [...directories].sort();
+        const normalizedExtensions = [...extensions]
+            .map((ext) => ext.toLowerCase())
+            .sort();
+        // Include resolver configuration in the key so different schema search paths do not share the same cache.
+        const resolverSegment = `|resolver:${(_a = resolver === null || resolver === void 0 ? void 0 : resolver.toCacheKey()) !== null && _a !== void 0 ? _a : 'none'}`;
+        return `${normalizedDirectories.join('|')}|${normalizedExtensions.join('|')}${resolverSegment}|ddlLint:${ddlLintMode}`;
+    }
+    runDdlLint(sources) {
+        if (this.ddlLintMode === 'off' || sources.length === 0) {
+            return;
+        }
+        // Always lint with resolver context so unqualified references resolve deterministically.
+        const diagnostics = (0, ddlLint_1.lintDdlSources)(sources, {
+            tableNameResolver: this.tableNameResolver,
+        });
+        if (diagnostics.length === 0) {
+            return;
+        }
+        const adjusted = (0, ddlLint_1.applyDdlLintMode)(diagnostics, this.ddlLintMode);
+        if (this.ddlLintMode === 'strict') {
+            throw new errors_1.DdlLintError(adjusted);
+        }
+        console.warn((0, ddlLint_1.formatDdlLintDiagnostics)(adjusted));
+    }
+    // Map raw table names into their canonical schema-qualified keys for deduplication.
+    resolveTableKey(tableName) {
+        if (!this.tableNameResolver) {
+            return (0, rawsql_ts_1.normalizeTableName)(tableName);
+        }
+        return this.tableNameResolver.resolve(tableName);
+    }
+}
+exports.DdlFixtureLoader = DdlFixtureLoader;
+DdlFixtureLoader.cache = new Map();
+//# sourceMappingURL=DdlFixtureLoader.js.map

package/templates/dist/testkit-core/src/fixtures/DdlFixtureLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DdlFixtureLoader.js","sourceRoot":"","sources":["../../../../../../testkit-core/src/fixtures/DdlFixtureLoader.ts"],"names":[],"mappings":";;;;;;AAAA,qCAAgE;AAChE,0DAA6B;AAC7B,yCAAsE;AAItE,uCAQmB;AACnB,sCAAyC;AAuBzC,MAAa,gBAAgB;IAW3B,YAA6B,OAAgC;;QAAhC,YAAO,GAAP,OAAO,CAAyB;QANrD,aAAQ,GAA0B,EAAE,CAAC;QACrC,mBAAc,GAAG,IAAI,GAAG,EAA+B,CAAC;QACxD,WAAM,GAAG,KAAK,CAAC;QAKrB,2EAA2E;QAC3E,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,mBAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,UAAU,GAAG,CAAC,MAAA,OAAO,CAAC,UAAU,mCAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACnF,+EAA+E;QAC/E,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,aAAa,CAC5C,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,UAAU,EACf,OAAO,CAAC,iBAAiB,EACzB,IAAA,8BAAoB,EAAC,OAAO,CAAC,OAAO,CAAC,CACtC,CAAC;QACF,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,IAAA,8BAAoB,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAEM,WAAW;QAChB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAEM,UAAU,CAAC,SAAiB;QACjC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,IAAA,8BAAkB,EAAC,SAAS,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,oFAAoF;QACpF,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO;QACT,CAAC;QAED,kEAAkE;QAClE,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7C,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,gBAAgB,CAAC,QAA+B;QACtD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;QAEhC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACtE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,mBAAmB;QACzB,6FAA6F;QAC7F,MAAM,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAA,oBAAU,EAAC,SAAS,CAAC,CAAC,CAAC;QAClG,IAAI,kBAAkB,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,mCAAmC,kBAAkB,CAAC,IAAI,CACxD,IAAI,CACL,uDAAuD,CACzD,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAA0B,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAmB,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAoB,EAAE,CAAC;QAEpC,8FAA8F;QAC9F,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACjD,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,WAAW,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CACjG,IAAI,CACL,kEAAkE,CACpE,CAAC;QACJ,CAAC;QAED,kGAAkG;QAClG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEzB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CACzD,IAAI,CACL,gGAAgG,CAClG,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,eAAe,CACrB,SAAiB,EACjB,QAA+B,EAC/B,WAA2B,EAC3B,OAAwB;QAExB,sEAAsE;QACtE,IAAI,CAAC,IAAA,oBAAU,EAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,qBAAW,EAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACzD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5D,SAAS;YACX,CAAC;YAED,yFAAyF;YACzF,WAAW,CAAC,YAAY,IAAI,CAAC,CAAC;YAE9B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,QAAQ,CACd,QAAgB,EAChB,QAA+B,EAC/B,OAAwB;;QAExB,MAAM,GAAG,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,qEAAqE;QACrE,MAAM,UAAU,GAAG,mBAAI;aACpB,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC;aACjC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAExC,0EAA0E;QAC1E,MAAM,WAAW,GAAG,iCAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvD,KAAK,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAClE,MAAM,aAAa,GAAG,UAAkC,CAAC;YAEzD,MAAM,OAAO,GACX,MAAA,MAAA,aAAa,CAAC,OAAO,0CAAE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;;gBAAC,OAAA,CAAC;oBACtC,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,QAAQ,EAAE,MAAM,CAAC,IAAI;oBACrB,QAAQ,EAAE,KAAK;oBACf,YAAY,EAAE,MAAA,MAAM,CAAC,OAAO,mCAAI,IAAI;iBACrC,CAAC,CAAA;aAAA,CAAC,mCAAI,EAAE,CAAC;YAEZ,MAAM,IAAI,GACR,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAEtG,6DAA6D;YAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,EAAE,CAAC;gBACpG,SAAS;YACX,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC;gBACZ,eAAe,EAAE;oBACf,IAAI,EAAE,SAAS;oBACf,OAAO;iBACR;gBACD,IAAI;aACL,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,aAAa,CAC1B,WAAqB,EACrB,UAAoB,EACpB,QAA4B,EAC5B,cAA2B,+BAAqB;;QAEhD,2GAA2G;QAC3G,MAAM,qBAAqB,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,MAAM,oBAAoB,GAAG,CAAC,GAAG,UAAU,CAAC;aACzC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;aAC/B,IAAI,EAAE,CAAC;QAEV,0GAA0G;QAC1G,MAAM,eAAe,GAAG,aAAa,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,UAAU,EAAE,mCAAI,MAAM,EAAE,CAAC;QACxE,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,YAAY,WAAW,EAAE,CAAC;IACzH,CAAC;IAEO,UAAU,CAAC,OAAwB;QACzC,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,yFAAyF;QACzF,MAAM,WAAW,GAAG,IAAA,wBAAc,EAAC,OAAO,EAAE;YAC1C,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;SAC1C,CAAC,CAAC;QACH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,0BAAgB,EAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,qBAAY,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,IAAA,kCAAwB,EAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,oFAAoF;IAC5E,eAAe,CAAC,SAAiB;QACvC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,OAAO,IAAA,8BAAkB,EAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;;AAxOH,4CAyOC;AAxOyB,sBAAK,GAAG,IAAI,GAAG,EAAiC,AAA3C,CAA4C"}

package/templates/dist/testkit-core/src/fixtures/FixtureProvider.d.ts

@@ -0,0 +1,20 @@
+import type { TableDefinitionModel } from 'rawsql-ts';
+import type { TableRowsFixture } from '../types';
+import type { FixtureResolver, FixtureSnapshot } from '../types';
+import { TableNameResolver } from './TableNameResolver';
+/** Resolves fixtures while unifying table metadata coming from DDL or explicit configuration. */
+export declare class DefaultFixtureProvider implements FixtureResolver {
+    private readonly baseRows;
+    private readonly tableNameResolver?;
+    private readonly definitionMap;
+    constructor(tableDefinitions?: TableDefinitionModel[], baseRows?: TableRowsFixture[], tableNameResolver?: TableNameResolver | undefined);
+    resolve(overrides?: TableRowsFixture[]): FixtureSnapshot;
+    private registerDefinitions;
+    private mergeRows;
+    private buildFixtureTables;
+    private buildDefinitionRegistry;
+    private findDefinition;
+    private resolveDefinitionKey;
+    private buildRow;
+    private coerceValue;
+}

package/templates/dist/testkit-core/src/fixtures/FixtureProvider.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultFixtureProvider = void 0;
+const rawsql_ts_1 = require("rawsql-ts");
+/** Resolves fixtures while unifying table metadata coming from DDL or explicit configuration. */
+class DefaultFixtureProvider {
+    constructor(tableDefinitions = [], baseRows = [], tableNameResolver) {
+        this.baseRows = baseRows;
+        this.tableNameResolver = tableNameResolver;
+        this.definitionMap = new Map();
+        this.registerDefinitions(tableDefinitions);
+    }
+    resolve(overrides) {
+        const mergedRows = this.mergeRows(overrides);
+        const snapshot = {
+            fixtureTables: this.buildFixtureTables(mergedRows),
+            tableDefinitions: this.buildDefinitionRegistry(),
+            fixturesApplied: mergedRows.map((fixture) => fixture.tableName),
+        };
+        return snapshot;
+    }
+    registerDefinitions(definitions) {
+        for (const definition of definitions) {
+            const key = this.resolveDefinitionKey(definition.name);
+            this.definitionMap.set(key, definition);
+        }
+    }
+    mergeRows(overrides) {
+        const merged = new Map();
+        // Start with the baseline rows so overrides only need to supply deltas.
+        for (const fixture of this.baseRows) {
+            const lookupKey = this.resolveDefinitionKey(fixture.tableName, (candidate) => this.definitionMap.has(candidate));
+            merged.set(lookupKey, fixture);
+        }
+        // Apply overrides so callers can shadow specific tables per scope.
+        for (const fixture of overrides !== null && overrides !== void 0 ? overrides : []) {
+            const lookupKey = this.resolveDefinitionKey(fixture.tableName, (candidate) => this.definitionMap.has(candidate));
+            merged.set(lookupKey, fixture);
+        }
+        return [...merged.values()];
+    }
+    buildFixtureTables(fixtures) {
+        const result = [];
+        for (const fixture of fixtures) {
+            const definition = this.findDefinition(fixture.tableName);
+            if (!definition) {
+                throw new Error(`Missing table definition for fixture "${fixture.tableName}".`);
+            }
+            const columns = definition.columns.map((column) => ({
+                name: column.name,
+                typeName: column.typeName,
+                defaultValue: typeof column.defaultValue === 'string' ? column.defaultValue : undefined,
+            }));
+            const rows = fixture.rows.map((row, rowIndex) => this.buildRow(row, columns, fixture.tableName, rowIndex, definition));
+            result.push({ tableName: fixture.tableName, columns, rows });
+        }
+        return result;
+    }
+    buildDefinitionRegistry() {
+        const registry = {};
+        const seen = new Set();
+        for (const definition of this.definitionMap.values()) {
+            const key = this.resolveDefinitionKey(definition.name);
+            if (seen.has(key)) {
+                continue;
+            }
+            registry[key] = definition;
+            seen.add(key);
+        }
+        return registry;
+    }
+    findDefinition(tableName) {
+        const key = this.resolveDefinitionKey(tableName, (candidate) => this.definitionMap.has(candidate));
+        return this.definitionMap.get(key);
+    }
+    // Resolve the canonical key for a table name, optionally preferring any registered schema entry.
+    resolveDefinitionKey(tableName, lookup) {
+        if (!this.tableNameResolver) {
+            return (0, rawsql_ts_1.normalizeTableName)(tableName);
+        }
+        return this.tableNameResolver.resolve(tableName, lookup);
+    }
+    buildRow(row, columns, tableName, rowIndex, definition) {
+        const normalizedKeys = new Set(Object.keys(row));
+        const columnLookup = new Map(definition.columns.map((column) => [column.name, column]));
+        // Ensure required columns without defaults are explicitly provided.
+        for (const column of columns) {
+            const definitionColumn = columnLookup.get(column.name);
+            const hasValue = normalizedKeys.has(column.name);
+            if (!hasValue &&
+                (definitionColumn === null || definitionColumn === void 0 ? void 0 : definitionColumn.required) &&
+                !definitionColumn.defaultValue) {
+                throw new Error(`Row ${rowIndex} for table "${tableName}" misses required column "${column.name}".`);
+            }
+        }
+        return columns.map((column) => {
+            const value = row[column.name];
+            if (value === undefined || value === null) {
+                return null;
+            }
+            return this.coerceValue(value);
+        });
+    }
+    coerceValue(value) {
+        if (value === null || value === undefined) {
+            return null;
+        }
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'bigint') {
+            return value;
+        }
+        if (typeof Buffer !== 'undefined' && value instanceof Buffer) {
+            return value;
+        }
+        if (typeof value === 'boolean') {
+            return value ? 1 : 0;
+        }
+        return JSON.stringify(value);
+    }
+}
+exports.DefaultFixtureProvider = DefaultFixtureProvider;
+//# sourceMappingURL=FixtureProvider.js.map

package/templates/dist/testkit-core/src/fixtures/FixtureProvider.js.map

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

package/templates/dist/testkit-core/src/fixtures/FixtureStore.d.ts

@@ -0,0 +1,51 @@
+import type { TableFixture, SchemaRegistry } from '../types';
+import type { ColumnAffinity } from './ColumnAffinity';
+import { TableNameResolver } from './TableNameResolver';
+export interface ColumnDefinition {
+    name: string;
+    typeName: string;
+    affinity: ColumnAffinity;
+}
+export interface NormalizedFixture {
+    name: string;
+    columns: ColumnDefinition[];
+    rows: (string | number | bigint | Buffer | null)[][];
+}
+export type FixtureColumnSource = 'fixture' | 'schema';
+export interface FixtureColumnDescription {
+    columns: ColumnDefinition[];
+    source: FixtureColumnSource;
+}
+/**
+ * Normalizes and indexes fixture metadata so rewrites can resolve tables and columns deterministically.
+ */
+export declare class FixtureStore {
+    private readonly schemaRegistry?;
+    private readonly tableNameResolver?;
+    private readonly baseMap;
+    constructor(fixtures?: TableFixture[], schema?: SchemaRegistry, tableNameResolver?: TableNameResolver);
+    /**
+     * Builds a fixture lookup map that layers per-call overrides on top of the base fixtures.
+     * @param overrides - Additional fixtures to merge with the base set.
+     * @returns A map keyed by normalized table names.
+     */
+    withOverrides(overrides?: TableFixture[]): Map<string, NormalizedFixture>;
+    /**
+     * Retrieves column metadata for the requested table from fixtures or registered schema information.
+     * @param tableName - The table identifier potentially qualified by schema.
+     * @returns Column details assembled from fixtures or schema registry entries.
+     */
+    describeColumns(tableName: string): FixtureColumnDescription | undefined;
+    private buildMap;
+    private getRegisteredSchema;
+    private normalizeFixture;
+    private resolveTableKey;
+    private resolveLookupCandidates;
+    private buildColumns;
+    private buildColumnsFromSchema;
+    private buildColumnsFromDefinition;
+    private buildColumnDefinition;
+    private isTableDefinitionModel;
+    private normalizeRow;
+    private normalizeValue;
+}