@rawsql-ts/ztd-cli 0.13.0

package/dist/utils/pgDump.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPgDump = runPgDump;
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = __importDefault(require("node:os"));
+const connectionSummary_1 = require("./connectionSummary");
+/**
+ * Wraps `pg_dump` in schema-only mode for the given connection URL and returns the captured DDL output.
+ */
+function runPgDump(options) {
+    var _a, _b, _c, _d, _e, _f;
+    const executable = (_b = (_a = options.pgDumpPath) !== null && _a !== void 0 ? _a : process.env.PG_DUMP_PATH) !== null && _b !== void 0 ? _b : 'pg_dump';
+    const args = [
+        '--schema-only',
+        '--no-owner',
+        '--no-privileges',
+        ...((_c = options.extraArgs) !== null && _c !== void 0 ? _c : []),
+        '--dbname',
+        options.url
+    ];
+    const result = (0, node_child_process_1.spawnSync)(executable, args, {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe']
+    });
+    const connectionNote = (0, connectionSummary_1.describeConnectionContext)(options.connectionContext);
+    const extraArgsNote = ((_d = options.extraArgs) === null || _d === void 0 ? void 0 : _d.length) ? ` (extra args: ${options.extraArgs.join(' ')})` : '';
+    if (result.error) {
+        const windowsHint = node_os_1.default.platform() === 'win32'
+            ? ' On Windows, ensure "C:\\Program Files\\PostgreSQL\\<version>\\bin" is on PATH or use a shell where pg_dump is available.'
+            : '';
+        if (isExecutableMissing(result.error, (_e = result.stderr) === null || _e === void 0 ? void 0 : _e.toString())) {
+            throw new Error(`pg_dump executable not found (${executable}). Install PostgreSQL or pass --pg-dump-path to point at the binary.${windowsHint}`);
+        }
+        throw new Error(`Failed to launch pg_dump (${executable})${connectionNote}: ${(_f = result.error.message) !== null && _f !== void 0 ? _f : 'Unknown error'}${extraArgsNote}`);
+    }
+    if (result.status !== 0 || !result.stdout) {
+        const stderr = result.stderr ? result.stderr.toString().trim() : 'Unknown error';
+        throw new Error(`pg_dump reported an error${connectionNote}: ${stderr}${extraArgsNote}`);
+    }
+    return result.stdout;
+}
+function isExecutableMissing(error, stderr) {
+    if (error.code === 'ENOENT') {
+        return true;
+    }
+    if (!stderr) {
+        return false;
+    }
+    const normalized = stderr.toLowerCase();
+    return normalized.includes('not recognized') || normalized.includes('command not found');
+}
+//# sourceMappingURL=pgDump.js.map

package/dist/utils/pgDump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgDump.js","sourceRoot":"","sources":["../../src/utils/pgDump.ts"],"names":[],"mappings":";;;;;AAeA,8BA0CC;AAzDD,2DAA+C;AAC/C,sDAAyB;AAEzB,2DAAgE;AAShE;;GAEG;AACH,SAAgB,SAAS,CAAC,OAAsB;;IAC9C,MAAM,UAAU,GAAG,MAAA,MAAA,OAAO,CAAC,UAAU,mCAAI,OAAO,CAAC,GAAG,CAAC,YAAY,mCAAI,SAAS,CAAC;IAC/E,MAAM,IAAI,GAAG;QACX,eAAe;QACf,YAAY;QACZ,iBAAiB;QACjB,GAAG,CAAC,MAAA,OAAO,CAAC,SAAS,mCAAI,EAAE,CAAC;QAC5B,UAAU;QACV,OAAO,CAAC,GAAG;KACZ,CAAC;IAEF,MAAM,MAAM,GAAG,IAAA,8BAAS,EAAC,UAAU,EAAE,IAAI,EAAE;QACzC,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,IAAA,6CAAyB,EAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,CAAA,MAAA,OAAO,CAAC,SAAS,0CAAE,MAAM,EAAC,CAAC,CAAC,iBAAiB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,WAAW,GACf,iBAAE,CAAC,QAAQ,EAAE,KAAK,OAAO;YACvB,CAAC,CAAC,2HAA2H;YAC7H,CAAC,CAAC,EAAE,CAAC;QAET,IAAI,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAA,MAAM,CAAC,MAAM,0CAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CACb,iCAAiC,UAAU,uEAAuE,WAAW,EAAE,CAChI,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CACb,6BAA6B,UAAU,IAAI,cAAc,KAAK,MAAA,MAAM,CAAC,KAAK,CAAC,OAAO,mCAAI,eAAe,GAAG,aAAa,EAAE,CACxH,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,4BAA4B,cAAc,KAAK,MAAM,GAAG,aAAa,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAA4B,EAAE,MAAe;IACxE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAC3F,CAAC"}

package/dist/utils/sqliteAffinity.d.ts

@@ -0,0 +1,5 @@
+import type { SqliteAffinity } from '@rawsql-ts/testkit-core';
+/**
+ * Maps PostgreSQL column types to SQLite affinities to keep fixtures compatible with sqlite-testkit.
+ */
+export declare function mapSqlTypeToAffinity(typeName?: string, context?: string): SqliteAffinity;

package/dist/utils/sqliteAffinity.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapSqlTypeToAffinity = mapSqlTypeToAffinity;
+const shouldLogUnknownSqlTypes = process.env.RAWSQL_DDL_SILENT !== '1';
+function warnUnknownSqlType(typeName, context) {
+    if (!shouldLogUnknownSqlTypes) {
+        return;
+    }
+    const subject = context !== null && context !== void 0 ? context : 'column';
+    console.warn(`[ztd ddl] Unknown SQL type for ${subject}: ${typeName !== null && typeName !== void 0 ? typeName : 'undefined'}. Defaulting to NUMERIC.`);
+}
+/**
+ * Maps PostgreSQL column types to SQLite affinities to keep fixtures compatible with sqlite-testkit.
+ */
+function mapSqlTypeToAffinity(typeName, context) {
+    if (!typeName) {
+        warnUnknownSqlType(typeName, context);
+        return 'NUMERIC';
+    }
+    const normalized = typeName.split('(')[0].trim().toUpperCase();
+    if (normalized === '' || normalized.includes('BLOB')) {
+        return 'BLOB';
+    }
+    if (normalized.includes('INT')) {
+        return 'INTEGER';
+    }
+    // Treat temporal types as TEXT so fixtures align with how pg-testkit exposes timestamps/dates.
+    if (normalized.includes('TIME') || normalized.includes('DATE')) {
+        return 'TEXT';
+    }
+    if (normalized.includes('CHAR') || normalized.includes('CLOB') || normalized.includes('TEXT')) {
+        return 'TEXT';
+    }
+    if (normalized.includes('REAL') || normalized.includes('DOUB') || normalized.includes('FLOA')) {
+        return 'REAL';
+    }
+    return 'NUMERIC';
+}
+//# sourceMappingURL=sqliteAffinity.js.map

package/dist/utils/sqliteAffinity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteAffinity.js","sourceRoot":"","sources":["../../src/utils/sqliteAffinity.ts"],"names":[],"mappings":";;AAgBA,oDA8BC;AA5CD,MAAM,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;AAEvE,SAAS,kBAAkB,CAAC,QAA4B,EAAE,OAAgB;IACxE,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,QAAQ,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,kCAAkC,OAAO,KAAK,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,WAAW,0BAA0B,CAAC,CAAC;AAChH,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,QAAiB,EAAE,OAAgB;IACtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE/D,IAAI,UAAU,KAAK,EAAE,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+FAA+F;IAC/F,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9F,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9F,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/typeMapper.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Maps PostgreSQL data types (basic numeric, string, temporal, JSON/binary types) to serializable TypeScript types, falling back to `unknown` when unmatched.
+ */
+export declare function mapSqlTypeToTs(typeName?: string, context?: string): string;

package/dist/utils/typeMapper.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapSqlTypeToTs = mapSqlTypeToTs;
+const numericTypes = new Set([
+    'int',
+    'integer',
+    'smallint',
+    'bigint',
+    'real',
+    'double precision',
+    'float',
+    'serial',
+    'bigserial',
+    'smallserial'
+]);
+const arbitraryPrecisionTypes = new Set(['decimal', 'numeric']);
+const stringTypes = new Set(['text', 'varchar', 'char', 'character varying', 'character', 'uuid', 'citext']);
+const dateTypes = new Set(['date', 'timestamp', 'timestamp without time zone', 'timestamp with time zone', 'time', 'time without time zone', 'time with time zone', 'timestamptz']);
+const shouldLogUnknownSqlTypes = process.env.RAWSQL_DDL_SILENT !== '1';
+function warnUnknownSqlType(typeName, context) {
+    // Do nothing when logging is explicitly silenced in CI or tooling.
+    if (!shouldLogUnknownSqlTypes) {
+        return;
+    }
+    // Keep developers aware when the generator sees an unmapped SQL type.
+    const subject = context !== null && context !== void 0 ? context : 'column';
+    console.warn(`[ztd ddl] Unknown SQL type for ${subject}: ${typeName !== null && typeName !== void 0 ? typeName : 'undefined'}. Defaulting to unknown.`);
+}
+/**
+ * Maps PostgreSQL data types (basic numeric, string, temporal, JSON/binary types) to serializable TypeScript types, falling back to `unknown` when unmatched.
+ */
+function mapSqlTypeToTs(typeName, context) {
+    // Log when the AST omitted a type so callers can track down why type inference failed.
+    if (!typeName) {
+        warnUnknownSqlType(typeName, context);
+        return 'unknown';
+    }
+    // Drop trailing precision/length metadata (varchar(255), numeric(10,2), etc.) because TS cannot capture it.
+    const normalized = typeName.split('(')[0].trim().toLowerCase();
+    if (numericTypes.has(normalized)) {
+        return 'number';
+    }
+    if (arbitraryPrecisionTypes.has(normalized)) {
+        // Postgres decimal/numeric are arbitrary precision, so string preserves exactness when floating-point would lose it.
+        return 'string';
+    }
+    // Treat all date/time families as strings to keep the generated rows serializable.
+    if (normalized.includes('time') || dateTypes.has(normalized)) {
+        return 'string';
+    }
+    if (stringTypes.has(normalized) || normalized.includes('text')) {
+        return 'string';
+    }
+    if (normalized === 'boolean' || normalized === 'bool') {
+        return 'boolean';
+    }
+    if (normalized === 'json' || normalized === 'jsonb') {
+        // Use any so generated APIs stay friendly for JSON-heavy applications; narrowing can still be applied later.
+        return 'any';
+    }
+    if (normalized === 'bytea') {
+        // Prefer Uint8Array to avoid Node.js-only Buffer while still representing binary payloads.
+        return 'Uint8Array';
+    }
+    if (normalized === 'inet' || normalized === 'cidr' || normalized === 'macaddr') {
+        return 'string';
+    }
+    if (normalized.startsWith('interval')) {
+        // Interval strings cover day/hour/second variants, so keep them as text.
+        return 'string';
+    }
+    // Alert when an unfamiliar SQL type flows through so we can extend the mapper later.
+    warnUnknownSqlType(typeName, context);
+    return 'unknown';
+}
+//# sourceMappingURL=typeMapper.js.map

package/dist/utils/typeMapper.js.map

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

package/dist/utils/ztdProjectConfig.d.ts

@@ -0,0 +1,37 @@
+export interface ZtdConnectionConfig {
+    url?: string;
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+    database?: string;
+}
+export interface ZtdProjectConfig {
+    dialect: string;
+    ddlDir: string;
+    testsDir: string;
+    ddl: {
+        defaultSchema: string;
+        searchPath: string[];
+    };
+    connection?: ZtdConnectionConfig;
+}
+export declare const DEFAULT_ZTD_CONFIG: ZtdProjectConfig;
+/**
+ * Resolves the path to the project's ztd.config.json from a provided root.
+ * @param rootDir - Directory to start searching from (defaults to current working directory).
+ * @returns Absolute path to ztd.config.json.
+ */
+export declare function resolveZtdConfigPath(rootDir?: string): string;
+/**
+ * Loads the project configuration, merging against defaults when the file is missing or partially provided.
+ * @param rootDir - Directory containing the ztd.config.json file.
+ * @returns A fully-resolved ZtdProjectConfig instance.
+ */
+export declare function loadZtdProjectConfig(rootDir?: string): ZtdProjectConfig;
+/**
+ * Persists the provided overrides on top of the existing project configuration.
+ * @param rootDir - Directory that hosts ztd.config.json.
+ * @param overrides - Partial configuration values to merge.
+ */
+export declare function writeZtdProjectConfig(rootDir: string, overrides?: Partial<ZtdProjectConfig>): void;

package/dist/utils/ztdProjectConfig.js

@@ -0,0 +1,161 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ZTD_CONFIG = void 0;
+exports.resolveZtdConfigPath = resolveZtdConfigPath;
+exports.loadZtdProjectConfig = loadZtdProjectConfig;
+exports.writeZtdProjectConfig = writeZtdProjectConfig;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const CONFIG_NAME = 'ztd.config.json';
+const DEFAULT_DDL_PROPERTIES = {
+    defaultSchema: 'public',
+    searchPath: ['public']
+};
+exports.DEFAULT_ZTD_CONFIG = {
+    dialect: 'postgres',
+    ddlDir: 'ztd/ddl',
+    testsDir: 'tests',
+    ddl: { ...DEFAULT_DDL_PROPERTIES }
+};
+/**
+ * Resolves the path to the project's ztd.config.json from a provided root.
+ * @param rootDir - Directory to start searching from (defaults to current working directory).
+ * @returns Absolute path to ztd.config.json.
+ */
+function resolveZtdConfigPath(rootDir = process.cwd()) {
+    return node_path_1.default.join(rootDir, CONFIG_NAME);
+}
+/**
+ * Loads the project configuration, merging against defaults when the file is missing or partially provided.
+ * @param rootDir - Directory containing the ztd.config.json file.
+ * @returns A fully-resolved ZtdProjectConfig instance.
+ */
+function loadZtdProjectConfig(rootDir = process.cwd()) {
+    const filePath = resolveZtdConfigPath(rootDir);
+    if (!(0, node_fs_1.existsSync)(filePath)) {
+        return exports.DEFAULT_ZTD_CONFIG;
+    }
+    try {
+        // Merge on top of defaults so partial configs remain valid.
+        const raw = JSON.parse((0, node_fs_1.readFileSync)(filePath, 'utf8'));
+        const rawDdl = typeof raw.ddl === 'object' && raw.ddl !== null ? raw.ddl : undefined;
+        const rawConnection = typeof raw.connection === 'object' && raw.connection !== null ? raw.connection : undefined;
+        // Treat only non-empty ddl.searchPath arrays as explicit overrides.
+        const rawSearchPath = Array.isArray(rawDdl === null || rawDdl === void 0 ? void 0 : rawDdl.searchPath) ? rawDdl.searchPath : undefined;
+        // Detect override intent only when a non-empty searchPath array is provided.
+        let hasSearchPathOverrides = false;
+        if (rawSearchPath && rawSearchPath.length > 0) {
+            hasSearchPathOverrides = true;
+        }
+        let resolvedSearchPath = [...exports.DEFAULT_ZTD_CONFIG.ddl.searchPath];
+        if (hasSearchPathOverrides && rawSearchPath) {
+            resolvedSearchPath = rawSearchPath.filter((schema) => typeof schema === 'string' && schema.length > 0);
+        }
+        return {
+            dialect: typeof raw.dialect === 'string' ? raw.dialect : exports.DEFAULT_ZTD_CONFIG.dialect,
+            ddlDir: typeof raw.ddlDir === 'string' && raw.ddlDir.length ? raw.ddlDir : exports.DEFAULT_ZTD_CONFIG.ddlDir,
+            testsDir: typeof raw.testsDir === 'string' && raw.testsDir.length ? raw.testsDir : exports.DEFAULT_ZTD_CONFIG.testsDir,
+            ddl: {
+                defaultSchema: typeof (rawDdl === null || rawDdl === void 0 ? void 0 : rawDdl.defaultSchema) === 'string' && rawDdl.defaultSchema.length
+                    ? rawDdl.defaultSchema
+                    : exports.DEFAULT_ZTD_CONFIG.ddl.defaultSchema,
+                searchPath: resolvedSearchPath
+            },
+            connection: normalizeConnectionConfig(rawConnection)
+        };
+    }
+    catch (error) {
+        throw new Error(`${CONFIG_NAME} is malformed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Persists the provided overrides on top of the existing project configuration.
+ * @param rootDir - Directory that hosts ztd.config.json.
+ * @param overrides - Partial configuration values to merge.
+ */
+function writeZtdProjectConfig(rootDir, overrides = {}) {
+    var _a;
+    const baseConfig = loadZtdProjectConfig(rootDir);
+    const finalConfig = {
+        ...baseConfig,
+        ...overrides,
+        ddl: {
+            ...baseConfig.ddl,
+            ...((_a = overrides.ddl) !== null && _a !== void 0 ? _a : {})
+        }
+    };
+    const resolvedConnection = mergeConnectionConfig(baseConfig.connection, overrides.connection);
+    if (resolvedConnection) {
+        finalConfig.connection = resolvedConnection;
+    }
+    else {
+        delete finalConfig.connection;
+    }
+    const serialized = `${JSON.stringify(finalConfig, null, 2)}\n`;
+    (0, node_fs_1.writeFileSync)(resolveZtdConfigPath(rootDir), serialized, 'utf8');
+}
+/**
+ * Normalizes a raw connection object into the typed connection configuration.
+ * @param rawConnection - Value read from ztd.config.json that may describe a connection.
+ * @returns A typed connection config or undefined when the input is invalid.
+ */
+function normalizeConnectionConfig(rawConnection) {
+    if (typeof rawConnection !== 'object' || rawConnection === null) {
+        return undefined;
+    }
+    const rawRecord = rawConnection;
+    const connection = {};
+    const url = typeof rawRecord.url === 'string' ? rawRecord.url.trim() : undefined;
+    if (url) {
+        connection.url = url;
+    }
+    const host = typeof rawRecord.host === 'string' ? rawRecord.host.trim() : undefined;
+    if (host) {
+        connection.host = host;
+    }
+    const user = typeof rawRecord.user === 'string' ? rawRecord.user.trim() : undefined;
+    if (user) {
+        connection.user = user;
+    }
+    const password = typeof rawRecord.password === 'string' && rawRecord.password.length > 0 ? rawRecord.password : undefined;
+    if (password) {
+        connection.password = password;
+    }
+    const database = typeof rawRecord.database === 'string' ? rawRecord.database.trim() : undefined;
+    if (database) {
+        connection.database = database;
+    }
+    const portValue = rawRecord.port;
+    const port = typeof portValue === 'number'
+        ? portValue
+        : typeof portValue === 'string'
+            ? Number(portValue)
+            : undefined;
+    if (port && Number.isInteger(port) && port > 0) {
+        connection.port = port;
+    }
+    if (Object.keys(connection).length === 0) {
+        return undefined;
+    }
+    return connection;
+}
+/**
+ * Merges two connection config objects, preferring values from the overrides.
+ * @param base - Existing connection configuration.
+ * @param overrides - Incoming override values from CLI or other sources.
+ * @returns Combined configuration or undefined when nothing is specified.
+ */
+function mergeConnectionConfig(base, overrides) {
+    const merged = {
+        ...(base !== null && base !== void 0 ? base : {}),
+        ...(overrides !== null && overrides !== void 0 ? overrides : {})
+    };
+    if (Object.keys(merged).length === 0) {
+        return undefined;
+    }
+    return merged;
+}
+//# sourceMappingURL=ztdProjectConfig.js.map

package/dist/utils/ztdProjectConfig.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@rawsql-ts/ztd-cli",
+  "version": "0.13.0",
+  "description": "DB-agnostic scaffolding and DDL helpers for Zero Table Dependency projects",
+  "main": "dist/index.js",
+  "bin": {
+    "ztd": "dist/index.js"
+  },
+  "keywords": [
+    "rawsql-ts",
+    "ztd",
+    "cli",
+    "ddl",
+    "fixtures"
+  ],
+  "author": "msugiura",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "chokidar": "^5.0.0",
+    "commander": "^12.0.0",
+    "diff": "^5.1.0",
+    "@rawsql-ts/testkit-core": "0.13.0",
+    "rawsql-ts": "0.13.0"
+  },
+  "devDependencies": {
+    "@types/diff": "^5.0.1",
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2",
+    "vitest": "^4.0.7"
+  },
+  "files": [
+    "dist",
+    "AGENTS.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint src --ext .ts",
+    "release": "npm run lint && npm run test && npm run build && npm pack --dry-run && npm publish --access public"
+  }
+}