@rawsql-ts/ztd-cli 0.20.0 → 0.20.2

package/dist/utils/modelProbe.d.ts

@@ -0,0 +1,14 @@
+interface PgMetadataQueryClientLike {
+    query<T = unknown>(statement: string, values?: unknown[] | Record<string, unknown>): Promise<{
+        rows?: T[];
+        fields?: unknown[];
+    }>;
+}
+export interface ProbedColumn {
+    columnName: string;
+    typeName: string;
+    tsType: string;
+}
+export declare function probeQueryColumns(client: PgMetadataQueryClientLike, boundSql: string, params: unknown[]): Promise<ProbedColumn[]>;
+export declare function buildProbeSql(boundSql: string): string;
+export {};

package/dist/utils/modelProbe.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.probeQueryColumns = probeQueryColumns;
+exports.buildProbeSql = buildProbeSql;
+const directTypeMap = new Map([
+    ['int2', 'number'],
+    ['int4', 'number'],
+    ['int8', 'string'],
+    ['float4', 'number'],
+    ['float8', 'number'],
+    ['numeric', 'string'],
+    ['decimal', 'string'],
+    ['bool', 'boolean'],
+    ['text', 'string'],
+    ['varchar', 'string'],
+    ['bpchar', 'string'],
+    ['char', 'string'],
+    ['uuid', 'string'],
+    ['citext', 'string'],
+    ['name', 'string'],
+    ['date', 'string'],
+    ['timestamp', 'string'],
+    ['timestamptz', 'string'],
+    ['time', 'string'],
+    ['timetz', 'string'],
+    ['json', 'any'],
+    ['jsonb', 'any'],
+    ['bytea', 'Uint8Array']
+]);
+async function probeQueryColumns(client, boundSql, params) {
+    const probeSql = buildProbeSql(boundSql);
+    const result = await client.query(probeSql, params);
+    const fields = normalizeFields(result.fields);
+    if (fields.length === 0) {
+        throw new Error('The probe query returned no column metadata.');
+    }
+    const typeRows = await loadPgTypes(client, fields.map((field) => field.dataTypeID));
+    return fields.map((field) => {
+        const typeName = resolvePgTypeName(field.dataTypeID, typeRows);
+        return {
+            columnName: field.name,
+            typeName,
+            tsType: mapPgTypeToTs(field.dataTypeID, typeRows)
+        };
+    });
+}
+function buildProbeSql(boundSql) {
+    const normalizedSql = boundSql.trim().replace(/(?:;\s*)+$/u, '');
+    if (!normalizedSql) {
+        throw new Error('The SQL probe source is empty.');
+    }
+    return `SELECT * FROM (${normalizedSql}) AS _ztd_type_probe LIMIT 0`;
+}
+function normalizeFields(fields) {
+    if (!Array.isArray(fields)) {
+        return [];
+    }
+    return fields
+        .filter((field) => typeof field === 'object' &&
+        field !== null &&
+        typeof field.name === 'string' &&
+        typeof field.dataTypeID === 'number');
+}
+async function loadPgTypes(client, initialOids) {
+    var _a;
+    const rows = new Map();
+    const pending = new Set(initialOids.filter((oid) => oid > 0));
+    while (pending.size > 0) {
+        const batch = Array.from(pending);
+        pending.clear();
+        const result = await client.query(`
+        SELECT oid, typname, typtype, typelem, typbasetype
+        FROM pg_type
+        WHERE oid = ANY($1::oid[])
+      `, [batch]);
+        for (const row of (_a = result.rows) !== null && _a !== void 0 ? _a : []) {
+            rows.set(row.oid, row);
+            if (row.typelem && row.typelem > 0 && !rows.has(row.typelem)) {
+                pending.add(row.typelem);
+            }
+            if (row.typbasetype && row.typbasetype > 0 && !rows.has(row.typbasetype)) {
+                pending.add(row.typbasetype);
+            }
+        }
+    }
+    return rows;
+}
+function resolvePgTypeName(oid, rows) {
+    const row = rows.get(oid);
+    if (!row) {
+        return 'unknown';
+    }
+    if (row.typtype === 'd' && row.typbasetype > 0) {
+        return resolvePgTypeName(row.typbasetype, rows);
+    }
+    if (row.typelem > 0 && row.typname.startsWith('_')) {
+        return `${resolvePgTypeName(row.typelem, rows)}[]`;
+    }
+    if (row.typtype === 'e') {
+        return row.typname;
+    }
+    return row.typname;
+}
+function mapPgTypeToTs(oid, rows) {
+    var _a;
+    const row = rows.get(oid);
+    if (!row) {
+        return 'unknown';
+    }
+    if (row.typtype === 'd' && row.typbasetype > 0) {
+        return mapPgTypeToTs(row.typbasetype, rows);
+    }
+    if (row.typelem > 0 && row.typname.startsWith('_')) {
+        return `${mapPgTypeToTs(row.typelem, rows)}[]`;
+    }
+    if (row.typtype === 'e') {
+        return 'string';
+    }
+    return (_a = directTypeMap.get(row.typname)) !== null && _a !== void 0 ? _a : 'unknown';
+}
+//# sourceMappingURL=modelProbe.js.map

package/dist/utils/modelProbe.js.map

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

package/dist/utils/normalizePulledSchema.d.ts

@@ -0,0 +1,12 @@
+export type StatementGroup = 'createSchema' | 'createTable' | 'view' | 'alterTable' | 'sequence' | 'index';
+export interface NormalizedStatement {
+    schema: string;
+    objectName: string;
+    group: StatementGroup;
+    sql: string;
+}
+interface NormalizationOptions {
+    allowedSchemas?: Set<string>;
+}
+export declare function normalizePulledSchema(rawSql: string, options?: NormalizationOptions): Map<string, NormalizedStatement[]>;
+export {};

package/dist/utils/normalizePulledSchema.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePulledSchema = normalizePulledSchema;
+const rawsql_ts_1 = require("rawsql-ts");
+const SqlFormatterOptions = {
+    keywordCase: 'lower',
+    indentSize: 2,
+    indentChar: ' ',
+    newline: '\n',
+    commaBreak: 'after',
+    exportComment: 'none'
+};
+const ddlFormatter = new rawsql_ts_1.SqlFormatter(SqlFormatterOptions);
+const groupOrder = {
+    createSchema: 0,
+    createTable: 1,
+    view: 2,
+    alterTable: 3,
+    sequence: 4,
+    index: 5
+};
+function normalizePulledSchema(rawSql, options = {}) {
+    var _a;
+    const cleanedSql = stripPgDumpNoise(rawSql);
+    const queries = rawsql_ts_1.MultiQuerySplitter.split(cleanedSql).queries;
+    const schemaMap = new Map();
+    // Iterate over each statement to normalize, bucket by schema, and honor any active filters.
+    for (const query of queries) {
+        const statementText = query.sql.trim();
+        if (!statementText || shouldSkipStatement(statementText)) {
+            continue;
+        }
+        const normalized = processStatement(statementText);
+        if (!normalized) {
+            continue;
+        }
+        if (options.allowedSchemas && options.allowedSchemas.size > 0 && !options.allowedSchemas.has(normalized.schema)) {
+            continue;
+        }
+        const bucket = (_a = schemaMap.get(normalized.schema)) !== null && _a !== void 0 ? _a : [];
+        bucket.push(normalized);
+        schemaMap.set(normalized.schema, bucket);
+    }
+    // Ensure every included schema has a CREATE SCHEMA statement even if pg_dump omitted it.
+    for (const [schema, statements] of schemaMap) {
+        if (statements.some((entry) => entry.group === 'createSchema')) {
+            continue;
+        }
+        statements.push({
+            schema,
+            objectName: schema,
+            group: 'createSchema',
+            sql: finalizeRawStatement(`create schema ${schema}`)
+        });
+    }
+    // Ensure the statements for each schema are returned in a deterministic order.
+    for (const statements of schemaMap.values()) {
+        statements.sort((a, b) => {
+            const primary = groupOrder[a.group] - groupOrder[b.group];
+            if (primary !== 0) {
+                return primary;
+            }
+            return a.objectName.localeCompare(b.objectName);
+        });
+    }
+    return schemaMap;
+}
+function stripPgDumpNoise(rawSql) {
+    // Remove pg_dump meta commands and standalone comments so the parser only sees SQL statements.
+    const normalizedNewlines = rawSql.replace(/\r\n/g, '\n');
+    return normalizedNewlines
+        .split('\n')
+        .filter((line) => {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            return true;
+        }
+        if (trimmed.startsWith('\\') || trimmed.startsWith('--')) {
+            return false;
+        }
+        return true;
+    })
+        .join('\n');
+}
+function shouldSkipStatement(statement) {
+    // Strip handles comments and meta commands earlier, so skip only runtime statements we still want to ignore.
+    const lower = statement.toLowerCase();
+    if (lower.startsWith('set ') || lower.startsWith('select ')) {
+        return true;
+    }
+    if (lower.startsWith('comment ') || lower.startsWith('drop ')) {
+        return true;
+    }
+    if (lower.startsWith('create extension') || lower.startsWith('create type')) {
+        return true;
+    }
+    return false;
+}
+function processStatement(statement) {
+    const lower = statement.toLowerCase();
+    // Route statements by their leading keywords to dedicated handlers.
+    if (lower.startsWith('create schema')) {
+        return buildCreateSchemaStatement(statement);
+    }
+    if (lower.startsWith('create view') || lower.startsWith('create or replace view')) {
+        return buildViewStatement(statement);
+    }
+    if (lower.startsWith('create table') || lower.startsWith('create temporary table')) {
+        return buildAstStatement(statement, 'createTable', (ast) => ast.tableName);
+    }
+    if (lower.startsWith('alter table')) {
+        return buildAstStatement(statement, 'alterTable', (ast) => ast.table);
+    }
+    if (lower.startsWith('create index') || lower.startsWith('create unique index')) {
+        return buildAstStatement(statement, 'index', (ast) => ast.tableName);
+    }
+    if (lower.startsWith('create sequence')) {
+        return buildAstStatement(statement, 'sequence', (ast) => ast.sequenceName);
+    }
+    if (lower.startsWith('alter sequence')) {
+        return buildAstStatement(statement, 'sequence', (ast) => ast.sequenceName);
+    }
+    return null;
+}
+function buildCreateSchemaStatement(statement) {
+    // SqlParser does not yet support CREATE SCHEMA statements, so fall back to regex parsing.
+    const match = statement.match(/create\s+schema\s+(?:if\s+not\s+exists\s+)?(.+?)(?:\s|;|$)/i);
+    if (!match) {
+        return null;
+    }
+    const schemaName = normalizeIdentifier(match[1].trim());
+    return {
+        schema: schemaName,
+        objectName: schemaName,
+        group: 'createSchema',
+        sql: finalizeRawStatement(statement)
+    };
+}
+function buildViewStatement(statement) {
+    // SqlParser is not able to parse CREATE VIEW statements yet, so use a regex fallback.
+    const match = statement.match(/create\s+(?:or\s+replace\s+)?view\s+(.+?)\s+as\b/i);
+    if (!match) {
+        return null;
+    }
+    const namePart = match[1].trim().split(/\s*\(/)[0].trim();
+    const { schema, object } = splitQualifiedIdentifier(namePart);
+    return {
+        schema,
+        objectName: object,
+        group: 'view',
+        sql: finalizeRawStatement(statement)
+    };
+}
+function buildAstStatement(statement, group, qualifier) {
+    try {
+        // Parse the statement with rawsql-ts and convert it back to formatted SQL.
+        const ast = rawsql_ts_1.SqlParser.parse(statement);
+        const qualifierName = qualifier(ast);
+        const { schema, object } = extractQualifiedInfo(qualifierName);
+        return {
+            group,
+            schema,
+            objectName: object,
+            sql: formatAstStatement(ast)
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function formatAstStatement(component) {
+    const { formattedSql } = ddlFormatter.format(component);
+    const trimmed = formattedSql.trim();
+    return trimmed.endsWith(';') ? trimmed : `${trimmed};`;
+}
+function finalizeRawStatement(statement) {
+    const trimmed = statement.trim();
+    return trimmed.endsWith(';') ? trimmed : `${trimmed};`;
+}
+function extractQualifiedInfo(name) {
+    // Convert the qualified components into lowercase, unquoted tokens for deterministic grouping.
+    const schemaValue = name.namespaces && name.namespaces.length > 0 ? name.namespaces[name.namespaces.length - 1] : null;
+    const schema = schemaValue ? normalizeIdentifier(schemaValue) : 'public';
+    const object = normalizeIdentifier(name.name);
+    return { schema, object };
+}
+function normalizeIdentifier(value) {
+    const raw = typeof value === 'string' ? value : value instanceof rawsql_ts_1.RawString ? value.value : value.name;
+    return raw.replace(/^"|"$/g, '').toLowerCase();
+}
+function splitQualifiedIdentifier(input) {
+    var _a, _b;
+    const pattern = /^\s*(?:"([^"]+)"|([^".\s]+))(?:\.(?:"([^"]+)"|([^".\s]+)))?\s*$/;
+    const match = input.match(pattern);
+    let schema = 'public';
+    let object = input;
+    if (match) {
+        const firstPart = (_a = match[1]) !== null && _a !== void 0 ? _a : match[2];
+        const secondPart = (_b = match[3]) !== null && _b !== void 0 ? _b : match[4];
+        if (secondPart) {
+            schema = firstPart !== null && firstPart !== void 0 ? firstPart : 'public';
+            object = secondPart;
+        }
+        else if (firstPart) {
+            object = firstPart;
+        }
+    }
+    return {
+        schema: normalizeIdentifier(schema),
+        object: normalizeIdentifier(object)
+    };
+}
+//# sourceMappingURL=normalizePulledSchema.js.map

package/dist/utils/normalizePulledSchema.js.map

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

package/dist/utils/optionalDependencies.d.ts

@@ -0,0 +1,43 @@
+export type TestkitCoreModule = typeof import('@rawsql-ts/testkit-core');
+export interface PgTestkitClientLike {
+    query<T = unknown>(statement: string, values?: unknown[] | Record<string, unknown>): Promise<{
+        rows?: T[];
+        fields?: unknown[];
+    }>;
+    close(): Promise<unknown>;
+}
+export interface AdapterNodePgModule {
+    createPgTestkitClient(options: Record<string, unknown>): PgTestkitClientLike;
+}
+export interface PgClientLike {
+    connect(): Promise<unknown>;
+    query<T = unknown>(statement: string, values?: unknown[]): Promise<{
+        rows?: T[];
+        fields?: unknown[];
+    }>;
+    end(): Promise<unknown>;
+}
+export interface PgModule {
+    Client: new (options: {
+        connectionString: string;
+        connectionTimeoutMillis?: number;
+    }) => PgClientLike;
+}
+export interface PostgresContainerLike {
+    getConnectionUri(): string;
+    stop(): Promise<unknown>;
+}
+export interface PostgresContainerBuilderLike {
+    withDatabase(database: string): PostgresContainerBuilderLike;
+    withUsername(username: string): PostgresContainerBuilderLike;
+    withPassword(password: string): PostgresContainerBuilderLike;
+    start(): Promise<PostgresContainerLike>;
+}
+export interface PostgresContainerModule {
+    PostgreSqlContainer: new (image?: string) => PostgresContainerBuilderLike;
+}
+export declare function clearOptionalDependencyCache(): void;
+export declare function ensureTestkitCoreModule(): Promise<TestkitCoreModule>;
+export declare function ensureAdapterNodePgModule(): Promise<AdapterNodePgModule>;
+export declare function ensurePgModule(): Promise<PgModule>;
+export declare function ensurePostgresContainerModule(): Promise<PostgresContainerModule>;

package/dist/utils/optionalDependencies.js

@@ -0,0 +1,134 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearOptionalDependencyCache = clearOptionalDependencyCache;
+exports.ensureTestkitCoreModule = ensureTestkitCoreModule;
+exports.ensureAdapterNodePgModule = ensureAdapterNodePgModule;
+exports.ensurePgModule = ensurePgModule;
+exports.ensurePostgresContainerModule = ensurePostgresContainerModule;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+const node_module_1 = require("node:module");
+const node_url_1 = require("node:url");
+const moduleCache = new Map();
+const currentDirPath = resolveCurrentDirPath();
+const repositoryRoot = findRepositoryRoot(currentDirPath);
+async function loadOptionalModule(cacheKey, loader, description, installHint) {
+    if (moduleCache.has(cacheKey)) {
+        return moduleCache.get(cacheKey);
+    }
+    const moduleLoader = loader()
+        .catch((error) => {
+        moduleCache.delete(cacheKey);
+        const installNote = installHint ? ` Install it via \`${installHint}\`.` : '';
+        const original = error instanceof Error ? ` (${error.message})` : '';
+        throw new Error(`${description}${installNote}${original}`);
+    });
+    moduleCache.set(cacheKey, moduleLoader);
+    return moduleLoader;
+}
+function clearOptionalDependencyCache() {
+    moduleCache.clear();
+}
+function resolveCurrentDirPath() {
+    // Evaluate import.meta.url at runtime so this module can still be compiled in CJS-oriented ts-node flows.
+    const importMetaUrl = tryGetImportMetaUrl();
+    if (importMetaUrl) {
+        return node_path_1.default.dirname((0, node_url_1.fileURLToPath)(importMetaUrl));
+    }
+    if (typeof __dirname === 'string') {
+        return __dirname;
+    }
+    throw new Error('Failed to resolve current module directory for optional dependency loading.');
+}
+function tryGetImportMetaUrl() {
+    try {
+        return Function('return import.meta.url')();
+    }
+    catch {
+        return undefined;
+    }
+}
+function findRepositoryRoot(startDir) {
+    let cursor = startDir;
+    while (true) {
+        // Treat the monorepo root as the first directory containing both workspace marker files.
+        const hasWorkspaceFile = (0, node_fs_1.existsSync)(node_path_1.default.join(cursor, 'pnpm-workspace.yaml'));
+        const hasPackageJson = (0, node_fs_1.existsSync)(node_path_1.default.join(cursor, 'package.json'));
+        if (hasWorkspaceFile && hasPackageJson) {
+            return cursor;
+        }
+        const parentDir = node_path_1.default.dirname(cursor);
+        if (parentDir === cursor) {
+            throw new Error('Failed to locate repository root while resolving optional dependencies.');
+        }
+        cursor = parentDir;
+    }
+}
+function requireFromWorkspace(specifier) {
+    const require = (0, node_module_1.createRequire)(node_path_1.default.join(repositoryRoot, 'package.json'));
+    return require(specifier);
+}
+async function loadAdapterNodePgModule() {
+    try {
+        return requireFromWorkspace('@rawsql-ts/adapter-node-pg');
+    }
+    catch (error) {
+        // Workspace tests can run before adapter build output exists, so use source entrypoint.
+        const workspaceAdapterSrc = node_path_1.default.join(repositoryRoot, 'packages/adapters/adapter-node-pg/src/index.ts');
+        try {
+            return (await Promise.resolve(`${(0, node_url_1.pathToFileURL)(workspaceAdapterSrc).href}`).then(s => __importStar(require(s))));
+        }
+        catch {
+            throw error;
+        }
+    }
+}
+async function ensureTestkitCoreModule() {
+    return loadOptionalModule('@rawsql-ts/testkit-core', () => Promise.resolve().then(() => __importStar(require('@rawsql-ts/testkit-core'))), 'This command requires @rawsql-ts/testkit-core so fixtures and schema metadata are available.', 'pnpm add -D @rawsql-ts/testkit-core');
+}
+async function ensureAdapterNodePgModule() {
+    return loadOptionalModule('@rawsql-ts/adapter-node-pg', loadAdapterNodePgModule, 'A database adapter (for example @rawsql-ts/adapter-node-pg) is required to execute the rewritten SQL.', 'pnpm add -D @rawsql-ts/adapter-node-pg');
+}
+async function ensurePgModule() {
+    return loadOptionalModule('pg', () => Promise.resolve().then(() => __importStar(require('pg'))), 'The SQL lint command needs a PostgreSQL driver such as pg.', 'pnpm add -D pg');
+}
+async function ensurePostgresContainerModule() {
+    return loadOptionalModule('@testcontainers/postgresql', () => Promise.resolve().then(() => __importStar(require('@testcontainers/postgresql'))), 'ztd lint wants to spin up a disposable Postgres container via @testcontainers/postgresql.', 'pnpm add -D @testcontainers/postgresql');
+}
+//# sourceMappingURL=optionalDependencies.js.map

package/dist/utils/optionalDependencies.js.map

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

package/dist/utils/pgDump.d.ts

@@ -0,0 +1,12 @@
+import type { DbConnectionContext } from './dbConnection';
+export interface PgDumpOptions {
+    url: string;
+    pgDumpPath?: string;
+    pgDumpShell?: boolean;
+    extraArgs?: string[];
+    connectionContext?: DbConnectionContext;
+}
+/**
+ * Wraps `pg_dump` in schema-only mode for the given connection URL and returns the captured DDL output.
+ */
+export declare function runPgDump(options: PgDumpOptions): string;

package/dist/utils/pgDump.js

@@ -0,0 +1,58 @@
+"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 useShell = Boolean(options.pgDumpShell);
+    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'],
+        // Allow wrapper scripts or compound commands such as "docker exec <container> pg_dump".
+        shell: useShell
+    });
+    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 pass --pg-dump-shell with a wrapper command such as "docker exec <container> pg_dump".'
+            : '';
+        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}${useShell ? ' (shell mode enabled)' : ''}`);
+    }
+    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":";;;;;AAgBA,8BA6CC;AA7DD,2DAA+C;AAC/C,sDAAyB;AAEzB,2DAAgE;AAUhE;;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,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,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;QACjC,wFAAwF;QACxF,KAAK,EAAE,QAAQ;KAChB,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,2KAA2K;YAC7K,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,GAAG,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,EAAE,CAClK,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"}