@rawsql-ts/ztd-cli 0.13.0

package/dist/commands/options.js.map

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

package/dist/commands/pull.d.ts

@@ -0,0 +1,10 @@
+import type { DbConnectionContext } from '../utils/dbConnection';
+export interface PullSchemaOptions {
+    url: string;
+    out: string;
+    pgDumpPath?: string;
+    schemas?: string[];
+    tables?: string[];
+    connectionContext?: DbConnectionContext;
+}
+export declare function runPullSchema(options: PullSchemaOptions): void;

package/dist/commands/pull.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPullSchema = runPullSchema;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const pgDump_1 = require("../utils/pgDump");
+const fs_1 = require("../utils/fs");
+const normalizePulledSchema_1 = require("../utils/normalizePulledSchema");
+function runPullSchema(options) {
+    var _a, _b;
+    // Canonicalize CLI filters before invoking pg_dump so later steps can rely on consistent casing.
+    const schemaFilters = ((_a = options.schemas) !== null && _a !== void 0 ? _a : []).map((value) => normalizeSchemaName(value));
+    const tableFilters = ((_b = options.tables) !== null && _b !== void 0 ? _b : []).map((value) => parseTableSpecifier(value));
+    // Build the schema set that should survive the normalization pass.
+    const allowedSchemas = buildAllowedSchemas(schemaFilters, tableFilters);
+    // Invoke pg_dump once with the normalized filters so only the desired objects are exported.
+    const ddlSql = (0, pgDump_1.runPgDump)({
+        url: options.url,
+        pgDumpPath: options.pgDumpPath,
+        extraArgs: buildPgDumpArguments(schemaFilters, tableFilters),
+        connectionContext: options.connectionContext
+    });
+    // Normalize and bucket the pg_dump output while respecting the requested schema set.
+    const normalizedMap = (0, normalizePulledSchema_1.normalizePulledSchema)(ddlSql, {
+        allowedSchemas: allowedSchemas.size ? allowedSchemas : undefined
+    });
+    if (normalizedMap.size === 0) {
+        // Help callers realize their filters may have excluded everything from the dump.
+        const filterHints = [];
+        if (schemaFilters.length) {
+            filterHints.push(`--schema ${schemaFilters.join(', ')}`);
+        }
+        if (tableFilters.length) {
+            filterHints.push(`--table ${tableFilters.map((table) => table.original).join(', ')}`);
+        }
+        const hint = filterHints.length ? ` Filters applied: ${filterHints.join('; ')}.` : '';
+        throw new Error(`The dump did not contain any supported DDL statements.${hint} Verify the schema/table filters match your database.`);
+    }
+    const outDir = node_path_1.default.resolve(options.out);
+    (0, fs_1.ensureDirectory)(outDir);
+    // Remove the legacy schema.sql snapshot only when it is still present.
+    const legacySchemaFile = node_path_1.default.join(outDir, 'schema.sql');
+    if ((0, node_fs_1.existsSync)(legacySchemaFile)) {
+        (0, node_fs_1.rmSync)(legacySchemaFile, { force: true });
+    }
+    const schemasDir = node_path_1.default.join(outDir, 'schemas');
+    if ((0, node_fs_1.existsSync)(schemasDir)) {
+        (0, node_fs_1.rmSync)(schemasDir, { recursive: true, force: true });
+    }
+    // Persist each schema snapshot directly under the DDL directory for easier discovery.
+    for (const [schema, statements] of normalizedMap) {
+        const filePath = node_path_1.default.join(outDir, `${sanitizeSchemaFileName(schema)}.sql`);
+        (0, node_fs_1.writeFileSync)(filePath, buildSchemaFile(statements), 'utf8');
+        console.log(`Wrote normalized schema for ${schema} at ${filePath}`);
+    }
+}
+function buildPgDumpArguments(schemaFilters, tableFilters) {
+    // Allow callers to target specific schemas or tables when invoking pg_dump.
+    const args = [];
+    for (const schema of schemaFilters) {
+        args.push('--schema', schema);
+    }
+    for (const table of tableFilters) {
+        args.push('--table', table.original);
+    }
+    return args;
+}
+function buildAllowedSchemas(schemaFilters, tableFilters) {
+    // Combine the schemas referenced via filters so the normalizer can limit output.
+    const combined = new Set(schemaFilters);
+    for (const table of tableFilters) {
+        combined.add(table.schema);
+    }
+    return combined;
+}
+function buildSchemaFile(statements) {
+    // Join the sorted statements with blank lines so the file stays readable.
+    const body = statements.map((statement) => statement.sql).join('\n\n');
+    return `${body}\n`;
+}
+function sanitizeSchemaFileName(schema) {
+    const sanitized = schema.replace(/[^a-z0-9_-]/g, '_').replace(/^_+|_+$/g, '');
+    // Fall back to a safe default when all characters were stripped away.
+    return sanitized || 'schema';
+}
+function normalizeSchemaName(value) {
+    // Trim, unquote, and lowercase schema names to keep filter comparison predictable.
+    return value.trim().replace(/^"|"$/g, '').toLowerCase();
+}
+function parseTableSpecifier(value) {
+    var _a, _b;
+    const trimmed = value.trim();
+    const qualifiedPattern = /^\s*(?:"([^"]+)"|([^".\s]+))\.(?:"([^"]+)"|([^".\s]+))\s*$/;
+    const match = trimmed.match(qualifiedPattern);
+    // Resolve the schema portion, falling back to public when the specifier is unqualified.
+    const schema = match ? (_b = (_a = match[1]) !== null && _a !== void 0 ? _a : match[2]) !== null && _b !== void 0 ? _b : 'public' : 'public';
+    return {
+        schema: normalizeSchemaName(schema),
+        original: trimmed
+    };
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

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

package/dist/commands/ztdConfig.d.ts

@@ -0,0 +1,22 @@
+import { TableNameResolver } from '@rawsql-ts/testkit-core';
+import { SqlSource } from '../utils/collectSqlFiles';
+export interface ZtdConfigGenerationOptions {
+    directories: string[];
+    extensions: string[];
+    out: string;
+    defaultSchema?: string;
+    searchPath?: string[];
+}
+export interface ColumnMetadata {
+    name: string;
+    typeName?: string;
+    isNullable: boolean;
+}
+export interface TableMetadata {
+    name: string;
+    testRowInterfaceName: string;
+    columns: ColumnMetadata[];
+}
+export declare function runGenerateZtdConfig(options: ZtdConfigGenerationOptions): void;
+export declare function snapshotTableMetadata(sources: SqlSource[], resolver?: TableNameResolver): TableMetadata[];
+export declare function renderZtdConfigFile(tables: TableMetadata[]): string;

package/dist/commands/ztdConfig.js

@@ -0,0 +1,190 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenerateZtdConfig = runGenerateZtdConfig;
+exports.snapshotTableMetadata = snapshotTableMetadata;
+exports.renderZtdConfigFile = renderZtdConfigFile;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const rawsql_ts_1 = require("rawsql-ts");
+const testkit_core_1 = require("@rawsql-ts/testkit-core");
+const collectSqlFiles_1 = require("../utils/collectSqlFiles");
+const typeMapper_1 = require("../utils/typeMapper");
+const fs_1 = require("../utils/fs");
+function runGenerateZtdConfig(options) {
+    const sources = (0, collectSqlFiles_1.collectSqlFiles)(options.directories, options.extensions);
+    if (sources.length === 0) {
+        throw new Error(`No SQL files were discovered under ${options.directories.join(', ')}`);
+    }
+    // Build a resolver that honors the configured schema/search path so the generated rows stay canonical.
+    const resolver = new testkit_core_1.TableNameResolver({
+        defaultSchema: options.defaultSchema,
+        searchPath: options.searchPath
+    });
+    const tables = snapshotTableMetadata(sources, resolver);
+    if (tables.length === 0) {
+        throw new Error('The provided DDL sources did not contain any CREATE TABLE statements.');
+    }
+    const output = renderZtdConfigFile(tables);
+    (0, fs_1.ensureDirectory)(node_path_1.default.dirname(options.out));
+    (0, node_fs_1.writeFileSync)(options.out, output, 'utf8');
+    console.log(`Generated ${tables.length} ZTD test rows at ${options.out}`);
+}
+function snapshotTableMetadata(sources, resolver) {
+    var _a;
+    const registry = new Map();
+    // Track tables by their SQL name so each definition is emitted only once.
+    for (const source of sources) {
+        // Split multi-statement files so each CREATE TABLE can be processed independently.
+        const batch = rawsql_ts_1.MultiQuerySplitter.split(source.sql);
+        for (const query of batch.queries) {
+            if (query.isEmpty) {
+                continue;
+            }
+            let ast;
+            try {
+                const parsed = rawsql_ts_1.SqlParser.parse(query.sql);
+                if (parsed instanceof rawsql_ts_1.CreateTableQuery) {
+                    ast = parsed;
+                }
+            }
+            catch (_error) {
+                continue;
+            }
+            if (!ast) {
+                continue;
+            }
+            const definition = (0, rawsql_ts_1.createTableDefinitionFromCreateTableQuery)(ast);
+            // Normalize table names so the generated config mirrors resolver expectations.
+            const canonicalName = (_a = resolver === null || resolver === void 0 ? void 0 : resolver.resolve(definition.name)) !== null && _a !== void 0 ? _a : definition.name;
+            if (registry.has(canonicalName)) {
+                continue;
+            }
+            // Match column metadata by name so AST-driven nullability honors both DDL and constraints.
+            const columns = ast.columns.map((column) => {
+                const columnMeta = definition.columns.find((candidate) => candidate.name === column.name.name);
+                if (!columnMeta) {
+                    throw new Error(`Missing metadata for ${column.name.name} in ${definition.name}`);
+                }
+                const constraintKinds = new Set(column.constraints.map((constraint) => constraint.kind));
+                const hasNotNull = constraintKinds.has('not-null') || constraintKinds.has('primary-key');
+                return {
+                    name: column.name.name,
+                    typeName: columnMeta.typeName,
+                    isNullable: !hasNotNull
+                };
+            });
+            registry.set(canonicalName, {
+                name: canonicalName,
+                testRowInterfaceName: buildTestRowInterfaceName(canonicalName),
+                columns
+            });
+        }
+    }
+    return Array.from(registry.values()).sort((a, b) => a.name.localeCompare(b.name));
+}
+function buildTestRowInterfaceName(tableName) {
+    var _a;
+    // Preserve schema and table segments when Pascal-casing to keep names unique.
+    const namespaceParts = tableName.split('.');
+    const pascalize = (segment) => segment
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map((token) => {
+        const lower = token.toLowerCase();
+        return lower.charAt(0).toUpperCase() + lower.slice(1);
+    })
+        .join('');
+    const pascalSegments = namespaceParts.map((segment) => pascalize(segment)).filter(Boolean);
+    const combined = pascalSegments.join('');
+    const normalized = combined.replace(/^[0-9]+/, '');
+    // Guarantee the interface name starts with a letter or underscore.
+    const prefix = /^[A-Za-z_]/.test((_a = normalized.charAt(0)) !== null && _a !== void 0 ? _a : '') ? normalized : `_${normalized}`;
+    return `${prefix || 'Table'}TestRow`;
+}
+function renderZtdConfigFile(tables) {
+    const header = [
+        '// GENERATED FILE. DO NOT EDIT.',
+        '// ZTD TEST ROW MAP',
+        '// This file is synchronized with DDL using ztd-config.',
+        '',
+        "import type { FixtureRow, TableFixture, TableSchemaDefinition } from '@rawsql-ts/testkit-core';",
+        ''
+    ].join('\n');
+    const entries = tables
+        .map((table) => `  '${table.name}': ${table.testRowInterfaceName};`)
+        .join('\n');
+    // Build each table interface while preserving the column order from the DDL.
+    const definitions = tables
+        .map((table) => {
+        const fields = table.columns
+            .map((column) => {
+            const baseType = (0, typeMapper_1.mapSqlTypeToTs)(column.typeName, `${table.name}.${column.name}`);
+            const tsType = column.isNullable ? `${baseType} | null` : baseType;
+            return `  ${column.name}: ${tsType};`;
+        })
+            .join('\n');
+        return `export interface ${table.testRowInterfaceName} extends FixtureRow {\n${fields}\n}`;
+    })
+        .join('\n\n');
+    // Assemble a schema map that mirrors TestRowMap so tests can reuse canonical affinity metadata.
+    const schemaEntries = tables
+        .map((table) => {
+        const columnDefinitions = table.columns
+            .map((column) => {
+            var _a;
+            const typeLiteral = JSON.stringify((_a = column.typeName) !== null && _a !== void 0 ? _a : '');
+            return `      ${column.name}: ${typeLiteral},`;
+        })
+            .join('\n');
+        return `  '${table.name}': {\n    columns: {\n${columnDefinitions}\n    }\n  },`;
+    })
+        .join('\n');
+    const footer = [
+        '',
+        'export type TestRow<K extends keyof TestRowMap> = TestRowMap[K];',
+        'export type ZtdRowShapes = TestRowMap;',
+        'export type ZtdTableName = keyof TestRowMap;',
+        '',
+        'export type ZtdTableSchemas = Record<ZtdTableName, TableSchemaDefinition>;',
+        '',
+        'export const tableSchemas: ZtdTableSchemas = {',
+        `${schemaEntries}`,
+        '};',
+        '',
+        'export function tableSchema<K extends ZtdTableName>(tableName: K): TableSchemaDefinition {',
+        '  return tableSchemas[tableName];',
+        '}',
+        '',
+        'export type ZtdTableFixture<K extends ZtdTableName> = TableFixture & {',
+        '  tableName: K;',
+        '  rows: ZtdRowShapes[K][];',
+        '  schema: TableSchemaDefinition;',
+        '};',
+        '',
+        'export interface ZtdConfig {',
+        '  tables: ZtdTableName[];',
+        '}',
+        '',
+        'export function tableFixture<K extends ZtdTableName>(',
+        '  tableName: K,',
+        '  rows: ZtdRowShapes[K][],',
+        '  schema?: TableSchemaDefinition',
+        '): TableFixture {',
+        '  return { tableName, rows, schema };',
+        '}',
+        '',
+        'export function tableFixtureWithSchema<K extends ZtdTableName>(',
+        '  tableName: K,',
+        '  rows: ZtdRowShapes[K][]',
+        '): ZtdTableFixture<K> {',
+        '  // Always pair fixture rows with the canonical schema generated from DDL.',
+        '  return { tableName, rows, schema: tableSchemas[tableName] };',
+        '}',
+        ''
+    ].join('\n');
+    return `${header}export interface TestRowMap {\n${entries}\n}\n\n${definitions}\n${footer}`;
+}
+//# sourceMappingURL=ztdConfig.js.map

package/dist/commands/ztdConfig.js.map

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

package/dist/commands/ztdConfigCommand.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+/**
+ * Registers the `ztd-config` CLI command, which generates the canonical ZTD TestRowMap from DDL sources.
+ */
+export declare function registerZtdConfigCommand(program: Command): void;

package/dist/commands/ztdConfigCommand.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerZtdConfigCommand = registerZtdConfigCommand;
+const chokidar_1 = __importDefault(require("chokidar"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const options_1 = require("./options");
+const ztdProjectConfig_1 = require("../utils/ztdProjectConfig");
+const ztdConfig_1 = require("./ztdConfig");
+const fs_1 = require("../utils/fs");
+const WATCH_DEBOUNCE_MS = 150;
+function renderZtdLayoutGeneratedFile(config) {
+    // Derive the canonical ztd root directory from the configured DDL path.
+    const ddlDir = config.ddlDir.replace(/\\/g, '/');
+    const ztdRootDir = node_path_1.default.posix.dirname(ddlDir);
+    // Keep default sibling directories deterministic for downstream tooling.
+    const enumsDir = node_path_1.default.posix.join(ztdRootDir, 'enums');
+    const domainSpecsDir = node_path_1.default.posix.join(ztdRootDir, 'domain-specs');
+    return [
+        '// GENERATED FILE. DO NOT EDIT.',
+        '',
+        'export default {',
+        `  ztdRootDir: ${JSON.stringify(ztdRootDir)},`,
+        `  ddlDir: ${JSON.stringify(ddlDir)},`,
+        `  enumsDir: ${JSON.stringify(enumsDir)},`,
+        `  domainSpecsDir: ${JSON.stringify(domainSpecsDir)},`,
+        '};',
+        ''
+    ].join('\n');
+}
+function writeZtdLayoutFile(layoutFilePath, config) {
+    // Ensure the generated folder exists before emitting the layout snapshot.
+    (0, fs_1.ensureDirectory)(node_path_1.default.dirname(layoutFilePath));
+    (0, node_fs_1.writeFileSync)(layoutFilePath, renderZtdLayoutGeneratedFile(config), 'utf8');
+}
+/**
+ * Registers the `ztd-config` CLI command, which generates the canonical ZTD TestRowMap from DDL sources.
+ */
+function registerZtdConfigCommand(program) {
+    program
+        .command('ztd-config')
+        .description('Generate the canonical ZTD TestRowMap from DDL sources')
+        .option('--ddl-dir <directory>', 'DDL directory to scan (repeatable)', options_1.collectDirectories, [])
+        .option('--extensions <list>', 'Comma-separated extensions to include', options_1.parseExtensions, options_1.DEFAULT_EXTENSIONS)
+        .option('--out <file>', 'Destination TypeScript file for generated config')
+        .option('--default-schema <schema>', 'Override ddl.defaultSchema stored in ztd.config.json')
+        .option('--search-path <list>', 'Comma-separated schema search path entries', options_1.parseCsvList)
+        .option('--watch', 'Watch DDL files and regenerate when schema changes', false)
+        .action(async (options) => {
+        var _a, _b, _c;
+        const projectConfig = (0, ztdProjectConfig_1.loadZtdProjectConfig)();
+        const directories = (0, options_1.normalizeDirectoryList)(options.ddlDir, (_a = projectConfig.ddlDir) !== null && _a !== void 0 ? _a : options_1.DEFAULT_DDL_DIRECTORY);
+        const extensions = (0, options_1.resolveExtensions)(options.extensions, options_1.DEFAULT_EXTENSIONS);
+        const defaultOut = node_path_1.default.join((_b = projectConfig.testsDir) !== null && _b !== void 0 ? _b : options_1.DEFAULT_TESTS_DIRECTORY, 'generated', 'ztd-row-map.generated.ts');
+        const output = (_c = options.out) !== null && _c !== void 0 ? _c : defaultOut;
+        const layoutOut = node_path_1.default.join(node_path_1.default.dirname(output), 'ztd-layout.generated.ts');
+        const ddlOverrides = { ...projectConfig.ddl };
+        let shouldUpdateConfig = false;
+        if (options.defaultSchema) {
+            ddlOverrides.defaultSchema = options.defaultSchema;
+            shouldUpdateConfig = true;
+        }
+        if (options.searchPath && options.searchPath.length > 0) {
+            ddlOverrides.searchPath = options.searchPath;
+            shouldUpdateConfig = true;
+        }
+        if (shouldUpdateConfig) {
+            (0, ztdProjectConfig_1.writeZtdProjectConfig)(process.cwd(), { ddl: ddlOverrides });
+            console.log('[notice] ztd.config.json ddl schema settings updated.');
+        }
+        const generationOptions = {
+            directories,
+            extensions,
+            out: output,
+            defaultSchema: ddlOverrides.defaultSchema,
+            searchPath: ddlOverrides.searchPath
+        };
+        await (0, ztdConfig_1.runGenerateZtdConfig)(generationOptions);
+        const layoutConfig = { ...projectConfig, ddl: ddlOverrides };
+        writeZtdLayoutFile(layoutOut, layoutConfig);
+        if (options.watch) {
+            console.log(`[watch] Initial generation complete: ${generationOptions.out}`);
+            await watchZtdConfig(generationOptions, layoutOut, layoutConfig);
+        }
+    });
+}
+async function watchZtdConfig(options, layoutOut, layoutConfig) {
+    const cwd = process.cwd();
+    const patterns = options.directories.flatMap((dir) => options.extensions.map((extension) => node_path_1.default.join(dir, '**', `*${extension}`)));
+    // Only the configured output file (`options.out`) is overwritten while watching DDL changes.
+    const watcher = chokidar_1.default.watch(patterns, {
+        ignoreInitial: true,
+        awaitWriteFinish: { stabilityThreshold: 80, pollInterval: 20 }
+    });
+    console.log('[watch] Watching DDL files for changes (Ctrl+C to stop)...');
+    let debounceTimer = null;
+    let scheduledPath = null;
+    const scheduleReload = (changedPath) => {
+        scheduledPath = changedPath;
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            void executeReload(scheduledPath);
+            scheduledPath = null;
+        }, WATCH_DEBOUNCE_MS);
+    };
+    const executeReload = async (changedPath) => {
+        const relativePath = changedPath ? node_path_1.default.relative(cwd, changedPath) : 'unknown';
+        console.log(`[watch] DDL changed: ${relativePath}`);
+        try {
+            await (0, ztdConfig_1.runGenerateZtdConfig)(options);
+            writeZtdLayoutFile(layoutOut, layoutConfig);
+            console.log(`[watch] Updated: ${options.out}`);
+        }
+        catch (error) {
+            console.error(`[watch] Failed to regenerate ${options.out}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
+    watcher.on('add', scheduleReload);
+    watcher.on('change', scheduleReload);
+    watcher.on('unlink', scheduleReload);
+    await new Promise((resolve) => {
+        const stop = async () => {
+            console.log('[watch] Shutting down ztd-config watcher...');
+            watcher.off('add', scheduleReload);
+            watcher.off('change', scheduleReload);
+            watcher.off('unlink', scheduleReload);
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+                debounceTimer = null;
+            }
+            await watcher.close();
+            process.off('SIGINT', stop);
+            resolve();
+        };
+        process.once('SIGINT', () => {
+            void stop();
+        });
+    });
+}
+//# sourceMappingURL=ztdConfigCommand.js.map

package/dist/commands/ztdConfigCommand.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const ddl_1 = require("./commands/ddl");
+const init_1 = require("./commands/init");
+const ztdConfigCommand_1 = require("./commands/ztdConfigCommand");
+async function main() {
+    const program = new commander_1.Command();
+    program.name('ztd').description('Zero Table Dependency scaffolding and DDL helpers');
+    (0, init_1.registerInitCommand)(program);
+    (0, ztdConfigCommand_1.registerZtdConfigCommand)(program);
+    (0, ddl_1.registerDdlCommands)(program);
+    await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,wCAAqD;AACrD,0CAAsD;AACtD,kEAAuE;AAEvE,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,mDAAmD,CAAC,CAAC;IAErF,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,2CAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,yBAAmB,EAAC,OAAO,CAAC,CAAC;IAE7B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/utils/agents.d.ts

@@ -0,0 +1 @@
+export declare function copyAgentsTemplate(projectRoot: string): string | null;

package/dist/utils/agents.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyAgentsTemplate = copyAgentsTemplate;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const fs_1 = require("./fs");
+const TEMPLATE_NAME = 'AGENTS.md';
+const TARGET_FILES = ['AGENTS.md', 'AGENTS_ztd.md'];
+function copyAgentsTemplate(projectRoot) {
+    // Use the shared template bundle so generated AGENTS.md matches the distributable templates directory.
+    const templatePath = node_path_1.default.resolve(__dirname, '..', '..', 'templates', TEMPLATE_NAME);
+    if (!(0, node_fs_1.existsSync)(templatePath)) {
+        return null;
+    }
+    const contents = (0, node_fs_1.readFileSync)(templatePath, 'utf8');
+    // Try to materialize the template without overwriting any pre-existing AGENTS guidance.
+    for (const fileName of TARGET_FILES) {
+        const targetPath = node_path_1.default.join(projectRoot, fileName);
+        if ((0, node_fs_1.existsSync)(targetPath)) {
+            continue;
+        }
+        (0, fs_1.ensureDirectory)(node_path_1.default.dirname(targetPath));
+        (0, node_fs_1.writeFileSync)(targetPath, contents, 'utf8');
+        return targetPath;
+    }
+    return null;
+}
+//# sourceMappingURL=agents.js.map

package/dist/utils/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/utils/agents.ts"],"names":[],"mappings":";;;;;AAOA,gDAsBC;AA7BD,qCAAkE;AAClE,0DAA6B;AAC7B,6BAAuC;AAEvC,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;AAEpD,SAAgB,kBAAkB,CAAC,WAAmB;IACpD,uGAAuG;IACvG,MAAM,YAAY,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IACrF,IAAI,CAAC,IAAA,oBAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,sBAAY,EAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAEpD,wFAAwF;IACxF,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACpD,IAAI,IAAA,oBAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,IAAA,oBAAe,EAAC,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1C,IAAA,uBAAa,EAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/collectSqlFiles.d.ts

@@ -0,0 +1,9 @@
+export interface SqlSource {
+    path: string;
+    sql: string;
+}
+/**
+ * Scans the supplied directories (recursively) for SQL files matching the configured extensions and aggregates their contents.
+ * @returns Sorted list of `SqlSource` records containing workspace-relative paths and SQL text for each discovered file.
+ */
+export declare function collectSqlFiles(directories: string[], extensions: string[]): SqlSource[];