dbctx 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+export type TSSLMode = "disable" | "allow" | "prefer" | "require" | "verify-ca" | "verify-full";
+export interface ConnectionOptions {
+    hostname?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    sslmode?: TSSLMode;
+    sslcert?: string;
+    sslkey?: string;
+    sslrootcert?: string;
+    sshHost?: string;
+    sshPort?: number;
+    sshUsername?: string;
+    sshPrivateKey?: string;
+}
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"./src/","sources":["index.mts"],"names":[],"mappings":";AAOA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;AAEhG,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/index.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { render } from "ink";
+import { Error } from "./components/Error.js";
+import { App } from "./App.js";
+import { validatePathOptions } from "./validatePaths.mjs";
+const program = new Command();
+program
+    .name("dbctx")
+    .description("AI generated docs from your application database")
+    .version("1.0.0")
+    .argument("[connection-string]", "PostgreSQL connection string (env: DATABASE_URL)")
+    .option("-h, --hostname <host>", "database hostname (env: PGHOST, default: localhost)")
+    .option("-p, --port <port>", "database port (env: PGPORT, default: 5432)", parseInt)
+    .option("-d, --database <name>", "database name (env: PGDATABASE, default: postgres)")
+    .option("-U, --username <user>", "database username (env: PGUSER, default: postgres)")
+    .option("--sslmode <mode>", "SSL mode: disable|allow|prefer|require|verify-ca|verify-full (env: PGSSLMODE, default: prefer)")
+    .option("--sslcert <path>", "path to client certificate (env: PGSSLCERT)")
+    .option("--sslkey <path>", "path to client private key (env: PGSSLKEY)")
+    .option("--sslrootcert <path>", "path to root CA certificate (env: PGSSLROOTCERT)")
+    .option("--ssh-host <host>", "SSH tunnel host (bastion/jump server)")
+    .option("--ssh-port <port>", "SSH tunnel port (default: 22)", parseInt)
+    .option("--ssh-username <user>", "SSH tunnel username (default: $USER)")
+    .option("--ssh-private-key <path>", "path to SSH private key (default: ~/.ssh/id_rsa)")
+    .action((connectionString, options) => {
+    const hasConnectionString = Boolean(connectionString);
+    const hasIndividualOptions = Boolean(options.hostname || options.port || options.database || options.username);
+    if (hasConnectionString && hasIndividualOptions) {
+        render(Error({
+            message: "Cannot use both connection string and individual options (-h, -p, -d, -U). Use one or the other.",
+        }));
+        process.exit(1);
+    }
+    // Validate path options exist on filesystem
+    const { errors: pathErrors, expandedPaths } = validatePathOptions(options);
+    if (pathErrors.length > 0) {
+        const errorMessages = pathErrors
+            .map(({ option, path }) => `  ${option}: ${path}`)
+            .join("\n");
+        render(Error({
+            message: `The following paths do not exist:\n${errorMessages}`,
+        }));
+        process.exit(1);
+    }
+    // Replace original paths with expanded paths (~ resolved to home directory)
+    const validatedOptions = {
+        ...options,
+        ...expandedPaths,
+    };
+    if (hasIndividualOptions) {
+        const requiredOptions = [
+            { key: "hostname", flag: "-h/--hostname" },
+            { key: "port", flag: "-p/--port" },
+            { key: "database", flag: "-d/--database" },
+            { key: "username", flag: "-U/--username" },
+        ];
+        const missing = requiredOptions
+            .filter(({ key }) => !validatedOptions[key])
+            .map(({ flag }) => flag);
+        if (missing.length > 0) {
+            render(Error({
+                message: `Missing required options: ${missing.join(", ")}`,
+            }));
+            process.exit(1);
+        }
+    }
+    // All validations passed - build config and render the app
+    const config = {
+        connectionString,
+        ...validatedOptions,
+    };
+    render(App({ config }));
+});
+program.parse();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXgubWpzIiwic291cmNlUm9vdCI6Ii4vc3JjLyIsInNvdXJjZXMiOlsiaW5kZXgubXRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFDQSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBQ3BDLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFDN0IsT0FBTyxFQUFFLEtBQUssRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQzlDLE9BQU8sRUFBRSxHQUFHLEVBQTBCLE1BQU0sVUFBVSxDQUFDO0FBQ3ZELE9BQU8sRUFBRSxtQkFBbUIsRUFBNkIsTUFBTSxxQkFBcUIsQ0FBQztBQW1CckYsTUFBTSxPQUFPLEdBQUcsSUFBSSxPQUFPLEVBQUUsQ0FBQztBQUU5QixPQUFPO0tBQ0YsSUFBSSxDQUFDLE9BQU8sQ0FBQztLQUNiLFdBQVcsQ0FBQyxrREFBa0QsQ0FBQztLQUMvRCxPQUFPLENBQUMsT0FBTyxDQUFDO0tBQ2hCLFFBQVEsQ0FBQyxxQkFBcUIsRUFBRSxrREFBa0QsQ0FBQztLQUNuRixNQUFNLENBQUMsdUJBQXVCLEVBQUUscURBQXFELENBQUM7S0FDdEYsTUFBTSxDQUFDLG1CQUFtQixFQUFFLDRDQUE0QyxFQUFFLFFBQVEsQ0FBQztLQUNuRixNQUFNLENBQUMsdUJBQXVCLEVBQUUsb0RBQW9ELENBQUM7S0FDckYsTUFBTSxDQUFDLHVCQUF1QixFQUFFLG9EQUFvRCxDQUFDO0tBQ3JGLE1BQU0sQ0FBQyxrQkFBa0IsRUFBRSxnR0FBZ0csQ0FBQztLQUM1SCxNQUFNLENBQUMsa0JBQWtCLEVBQUUsNkNBQTZDLENBQUM7S0FDekUsTUFBTSxDQUFDLGlCQUFpQixFQUFFLDRDQUE0QyxDQUFDO0tBQ3ZFLE1BQU0sQ0FBQyxzQkFBc0IsRUFBRSxrREFBa0QsQ0FBQztLQUNsRixNQUFNLENBQUMsbUJBQW1CLEVBQUUsdUNBQXVDLENBQUM7S0FDcEUsTUFBTSxDQUFDLG1CQUFtQixFQUFFLCtCQUErQixFQUFFLFFBQVEs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ZW50IjpbIiMhL3Vzci9iaW4vZW52IG5vZGVcbmltcG9ydCB7IENvbW1hbmQgfSBmcm9tIFwiY29tbWFuZGVyXCI7XG5pbXBvcnQgeyByZW5kZXIgfSBmcm9tIFwiaW5rXCI7XG5pbXBvcnQgeyBFcnJvciB9IGZyb20gXCIuL2NvbXBvbmVudHMvRXJyb3IuanNcIjtcbmltcG9ydCB7IEFwcCwgdHlwZSBUQ29ubmVjdGlvbkNvbmZpZyB9IGZyb20gXCIuL0FwcC5qc1wiO1xuaW1wb3J0IHsgdmFsaWRhdGVQYXRoT3B0aW9ucywgdHlwZSBUUGF0aFZhbGlkYXRpb25FcnJvciB9IGZyb20gXCIuL3ZhbGlkYXRlUGF0aHMubWpzXCI7XG5cbmV4cG9ydCB0eXBlIFRTU0xNb2RlID0gXCJkaXNhYmxlXCIgfCBcImFsbG93XCIgfCBcInByZWZlclwiIHwgXCJyZXF1aXJlXCIgfCBcInZlcmlmeS1jYVwiIHwgXCJ2ZXJpZnktZnVsbFwiO1xuXG5leHBvcnQgaW50ZXJmYWNlIENvbm5lY3Rpb25PcHRpb25zIHtcbiAgICBob3N0bmFtZT86IHN0cmluZztcbiAgICBwb3J0PzogbnVtYmVyO1xuICAgIGRhdGFiYXNlPzogc3RyaW5nO1xuICAgIHVzZXJuYW1lPzogc3RyaW5nO1xuICAgIHNzbG1vZGU/OiBUU1NMTW9kZTtcbiAgICBzc2xjZXJ0Pzogc3RyaW5nO1xuICAgIHNzbGtleT86IHN0cmluZztcbiAgICBzc2xyb290Y2VydD86IHN0cmluZztcbiAgICBzc2hIb3N0Pzogc3RyaW5nO1xuICAgIHNzaFBvcnQ/OiBudW1iZXI7XG4gICAgc3NoVXNlcm5hbWU/OiBzdHJpbmc7XG4gICAgc3NoUHJpdmF0ZUtleT86IHN0cmluZztcbn1cblxuY29uc3QgcHJvZ3JhbSA9IG5ldyBDb21tYW5kKCk7XG5cbnByb2dyYW1cbiAgICAubmFtZShcImRiY3R4XCIpXG4gICAgLmRlc2NyaXB0aW9uKFwiQUkgZ2VuZXJhdGVkIGRvY3MgZnJvbSB5b3VyIGFwcGxpY2F0aW9uIGRhdGFiYXNlXCIpXG4gICAgLnZlcnNpb24oXCIxLjAuMFwiKVxuICAgIC5hcmd1bWVudChcIltjb25uZWN0aW9uLXN0cmluZ11cIiwgXCJQb3N0Z3JlU1FMIGNvbm5lY3Rpb24gc3RyaW5nIChlbnY6IERBVEFCQVNFX1VSTClcIilcbiAgICAub3B0aW9uKFwiLWgsIC0taG9zdG5hbWUgPGhvc3Q+XCIsIFwiZGF0YWJhc2UgaG9zdG5hbWUgKGVudjogUEdIT1NULCBkZWZhdWx0OiBsb2NhbGhvc3QpXCIpXG4gICAgLm9wdGlvbihcIi1wLCAtLXBvcnQgPHBvcnQ+XCIsIFwiZGF0YWJhc2UgcG9ydCAoZW52OiBQR1BPUlQsIGRlZmF1bHQ6IDU0MzIpXCIsIHBhcnNlSW50KVxuICAgIC5vcHRpb24oXCItZCwgLS1kYXRhYmFzZSA8bmFtZT5cIiwgXCJkYXRhYmFzZSBuYW1lIChlbnY6IFBHREFUQUJBU0UsIGRlZmF1bHQ6IHBvc3RncmVzKVwiKVxuICAgIC5vcHRpb24oXCItVSwgLS11c2VybmFtZSA8dXNlcj5cIiwgXCJkYXRhYmFzZSB1c2VybmFtZSAoZW52OiBQR1VTRVIsIGRlZmF1bHQ6IHBvc3RncmVzKVwiKVxuICAgIC5vcHRpb24oXCItLXNzbG1vZGUgPG1vZGU+XCIsIFwiU1NMIG1vZGU6IGRpc2FibGV8YWxsb3d8cHJlZmVyfHJlcXVpcmV8dmVyaWZ5LWNhfHZlcmlmeS1mdWxsIChlbnY6IFBHU1NMTU9ERSwgZGVmYXVsdDogcHJlZmVyKVwiKVxuICAgIC5vcHRpb24oXCItLXNzbGNlcnQgPHBhdGg+XCIsIFwicGF0aCB0byBjbGllbnQgY2VydGlmaWNhdGUgKGVudjogUEdTU0xDRVJUKVwiKVxuICAgIC5vcHRpb24oXCItLXNzbGtleSA8cGF0aD5cIiwgXCJwYXRoIHRvIGNsaWVudCBwcml2YXRlIGtleSAoZW52OiBQR1NTTEtFWSlcIilcbiAgICAub3B0aW9uKFwiLS1zc2xyb290Y2VydCA8cGF0aD5cIiwgXCJwYXRoIHRvIHJvb3QgQ0EgY2VydGlmaWNhdGUgKGVudjogUEdTU0xST09UQ0VSVClcIilcbiAgICAub3B0aW9uKFwiLS1zc2gtaG9zdCA8aG9zdD5cIiwgXCJTU0ggdHVubmVsIGhvc3QgKGJhc3Rpb24vanVtcCBzZXJ2ZXIpXCIpXG4gICAgLm9wdGlvbihcIi0tc3NoLXBvcnQgPHBvcnQ+XCIsIFwiU1NIIHR1bm5lbCBwb3J0IChkZWZhdWx0OiAyMilcIiwgcGFyc2VJbnQpXG4gICAgLm9wdGlvbihcIi0tc3NoLXVzZXJuYW1lIDx1c2VyPlwiLCBcIlNTSCB0dW5uZWwgdXNlcm5hbWUgKGRlZmF1bHQ6ICRVU0VSKVwiKVxuICAgIC5vcHRpb24oXCItLXNzaC1wcml2YXRlLWtleSA8cGF0aD5cIiwgXCJwYXRoIHRvIFNTSCBwcml2YXRlIGtleSAoZGVmYXVsdDogfi8uc3NoL2lkX3JzYSlcIilcbiAgICAuYWN0aW9uKChjb25uZWN0aW9uU3RyaW5nOiBzdHJpbmcgfCB1bmRlZmluZWQsIG9wdGlvbnM6IENvbm5lY3Rpb25PcHRpb25zKSA9PiB7XG4gICAgICAgIGNvbnN0IGhhc0Nvbm5lY3Rpb25TdHJpbmcgPSBCb29sZWFuKGNvbm5lY3Rpb25TdHJpbmcpO1xuICAgICAgICBjb25zdCBoYXNJbmRpdmlkdWFsT3B0aW9ucyA9IEJvb2xlYW4oXG4gICAgICAgICAgICBvcHRpb25zLmhvc3RuYW1lIHx8IG9wdGlvbnMucG9ydCB8fCBvcHRpb25zLmRhdGFiYXNlIHx8IG9wdGlvbnMudXNlcm5hbWVcbiAgICAgICAgKTtcblxuICAgICAgICBpZiAoaGFzQ29ubmVjdGlvblN0cmluZyAmJiBoYXNJbmRpdmlkdWFsT3B0aW9ucykge1xuICAgICAgICAgICAgcmVuZGVyKFxuICAgICAgICAgICAgICAgIEVycm9yKHtcbiAgICAgICAgICAgICAgICAgICAgbWVzc2FnZTpcbiAgICAgICAgICAgICAgICAgICAgICAgIFwiQ2Fubm90IHVzZSBib3RoIGNvbm5lY3Rpb24gc3RyaW5nIGFuZCBpbmRpdmlkdWFsIG9wdGlvbnMgKC1oLCAtcCwgLWQsIC1VKS4gVXNlIG9uZSBvciB0aGUgb3RoZXIuXCIsXG4gICAgICAgICAgICAgICAgfSlcbiAgICAgICAgICAgICk7XG5cbiAgICAgICAgICAgIHByb2Nlc3MuZXhpdCgxKTtcbiAgICAgICAgfVxuXG4gICAgICAgIC8vIFZhbGlkYXRlIHBhdGggb3B0aW9ucyBleGlzdCBvbiBmaWxlc3lzdGVtXG4gICAgICAgIGNvbnN0IHsgZXJyb3JzOiBwYXRoRXJyb3JzLCBleHBhbmRlZFBhdGhzIH0gPSB2YWxpZGF0ZVBhdGhPcHRpb25zKG9wdGlvbnMpO1xuXG4gICAgICAgIGlmIChwYXRoRXJyb3JzLmxlbmd0aCA+IDApIHtcbiAgICAgICAgICAgIGNvbnN0IGVycm9yTWVzc2FnZXMgPSBwYXRoRXJyb3JzXG4gICAgICAgICAgICAgICAgLm1hcCgoeyBvcHRpb24sIHBhdGggfTogVFBhdGhWYWxpZGF0aW9uRXJyb3IpID0+IGAgICR7b3B0aW9ufTogJHtwYXRofWApXG4gICAgICAgICAgICAgICAgLmpvaW4oXCJcXG5cIik7XG5cbiAgICAgICAgICAgIHJlbmRlcihcbiAgICAgICAgICAgICAgICBFcnJvcih7XG4gICAgICAgICAgICAgICAgICAgIG1lc3NhZ2U6IGBUaGUgZm9sbG93aW5nIHBhdGhzIGRvIG5vdCBleGlzdDpcXG4ke2Vycm9yTWVzc2FnZXN9YCxcbiAgICAgICAgICAgICAgICB9KVxuICAgICAgICAgICAgKTtcblxuICAgICAgICAgICAgcHJvY2Vzcy5leGl0KDEpO1xuICAgICAgICB9XG5cbiAgICAgICAgLy8gUmVwbGFjZSBvcmlnaW5hbCBwYXRocyB3aXRoIGV4cGFuZGVkIHBhdGhzICh+IHJlc29sdmVkIHRvIGhvbWUgZGlyZWN0b3J5KVxuICAgICAgICBjb25zdCB2YWxpZGF0ZWRPcHRpb25zOiBDb25uZWN0aW9uT3B0aW9ucyA9IHtcbiAgICAgICAgICAgIC4uLm9wdGlvbnMsXG4gICAgICAgICAgICAuLi5leHBhbmRlZFBhdGhzLFxuICAgICAgICB9O1xuXG4gICAgICAgIGlmIChoYXNJbmRpdmlkdWFsT3B0aW9ucykge1xuICAgICAgICAgICAgY29uc3QgcmVxdWlyZWRPcHRpb25zID0gW1xuICAgICAgICAgICAgICAgIHsga2V5OiBcImhvc3RuYW1lXCIsIGZsYWc6IFwiLWgvLS1ob3N0bmFtZVwiIH0sXG4gICAgICAgICAgICAgICAgeyBrZXk6IFwicG9ydFwiLCBmbGFnOiBcIi1wLy0tcG9ydFwiIH0sXG4gICAgICAgICAgICAgICAgeyBrZXk6IFwiZGF0YWJhc2VcIiwgZmxhZzogXCItZC8tLWRhdGFiYXNlXCIgfSxcbiAgICAgICAgICAgICAgICB7IGtleTogXCJ1c2VybmFtZVwiLCBmbGFnOiBcIi1VLy0tdXNlcm5hbWVcIiB9LFxuICAgICAgICAgICAgXSBhcyBjb25zdDtcblxuICAgICAgICAgICAgY29uc3QgbWlzc2luZyA9IHJlcXVpcmVkT3B0aW9uc1xuICAgICAgICAgICAgICAgIC5maWx0ZXIoKHsga2V5IH0pID0+ICF2YWxpZGF0ZWRPcHRpb25zW2tleV0pXG4gICAgICAgICAgICAgICAgLm1hcCgoeyBmbGFnIH0pID0+IGZsYWcpO1xuXG4gICAgICAgICAgICBpZiAobWlzc2luZy5sZW5ndGggPiAwKSB7XG4gICAgICAgICAgICAgICAgcmVuZGVyKFxuICAgICAgICAgICAgICAgICAgICBFcnJvcih7XG4gICAgICAgICAgICAgICAgICAgICAgICBtZXNzYWdlOiBgTWlzc2luZyByZXF1aXJlZCBvcHRpb25zOiAke21pc3Npbmcuam9pbihcIiwgXCIpfWAsXG4gICAgICAgICAgICAgICAgICAgIH0pXG4gICAgICAgICAgICAgICAgKTtcblxuICAgICAgICAgICAgICAgIHByb2Nlc3MuZXhpdCgxKTtcbiAgICAgICAgICAgIH1cbiAgICAgICAgfVxuXG4gICAgICAgIC8vIEFsbCB2YWxpZGF0aW9ucyBwYXNzZWQgLSBidWlsZCBjb25maWcgYW5kIHJlbmRlciB0aGUgYXBwXG4gICAgICAgIGNvbnN0IGNvbmZpZzogVENvbm5lY3Rpb25Db25maWcgPSB7XG4gICAgICAgICAgICBjb25uZWN0aW9uU3RyaW5nLFxuICAgICAgICAgICAgLi4udmFsaWRhdGVkT3B0aW9ucyxcbiAgICAgICAgfTtcblxuICAgICAgICByZW5kZXIoQXBwKHsgY29uZmlnIH0pKTtcbiAgICB9KTtcblxucHJvZ3JhbS5wYXJzZSgpO1xuIl19

package/dist/logger.d.mts

@@ -0,0 +1,3 @@
+import winston from 'winston';
+export declare const logger: winston.Logger;
+//# sourceMappingURL=logger.d.mts.map

package/dist/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","sourceRoot":"./src/","sources":["logger.mts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,eAAO,MAAM,MAAM,gBAOjB,CAAC"}

package/dist/logger.mjs

@@ -0,0 +1,7 @@
+import winston from 'winston';
+export const logger = winston.createLogger({
+    level: process.env.NODE_ENV === 'development' ? 'debug' : 'info',
+    format: winston.format.combine(winston.format.timestamp(), winston.format.json()),
+    transports: [new winston.transports.Console()],
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nZ2VyLm1qcyIsInNvdXJjZVJvb3QiOiIuL3NyYy8iLCJzb3VyY2VzIjpbImxvZ2dlci5tdHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxPQUFPLE1BQU0sU0FBUyxDQUFDO0FBRTlCLE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxPQUFPLENBQUMsWUFBWSxDQUFDO0lBQ3ZDLEtBQUssRUFBRSxPQUFPLENBQUMsR0FBRyxDQUFDLFFBQVEsS0FBSyxhQUFhLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTTtJQUNoRSxNQUFNLEVBQUUsT0FBTyxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQzFCLE9BQU8sQ0FBQyxNQUFNLENBQUMsU0FBUyxFQUFFLEVBQzFCLE9BQU8sQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLENBQ3hCO0lBQ0QsVUFBVSxFQUFFLENBQUMsSUFBSSxPQUFPLENBQUMsVUFBVSxDQUFDLE9BQU8sRUFBRSxDQUFDO0NBQ2pELENBQUMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB3aW5zdG9uIGZyb20gJ3dpbnN0b24nO1xuXG5leHBvcnQgY29uc3QgbG9nZ2VyID0gd2luc3Rvbi5jcmVhdGVMb2dnZXIoe1xuICAgIGxldmVsOiBwcm9jZXNzLmVudi5OT0RFX0VOViA9PT0gJ2RldmVsb3BtZW50JyA/ICdkZWJ1ZycgOiAnaW5mbycsXG4gICAgZm9ybWF0OiB3aW5zdG9uLmZvcm1hdC5jb21iaW5lKFxuICAgICAgICB3aW5zdG9uLmZvcm1hdC50aW1lc3RhbXAoKSxcbiAgICAgICAgd2luc3Rvbi5mb3JtYXQuanNvbigpLFxuICAgICksXG4gICAgdHJhbnNwb3J0czogW25ldyB3aW5zdG9uLnRyYW5zcG9ydHMuQ29uc29sZSgpXSxcbn0pO1xuIl19

package/dist/schemas/index.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.mts.map

package/dist/schemas/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"./src/","sources":["schemas/index.mts"],"names":[],"mappings":""}

package/dist/schemas/index.mjs

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+const relationAttribute = z
+    .object({
+    name: z.string(),
+    data_type: z.string(),
+    is_nullable: z.boolean(),
+    comment: z.string().nullable(),
+})
+    .and(z.discriminatedUnion('kind', [
+    z.discriminatedUnion('has_default', [
+        z.object({
+            kind: z.literal('regular'),
+            has_default: z.literal(false),
+        }),
+        z.object({
+            kind: z.literal('regular'),
+            has_default: z.literal(true),
+            default_expression: z.string(),
+        }),
+    ]),
+    z.object({
+        kind: z.literal('generated'),
+        generated_storage: z.enum(['stored', 'virtual']),
+        generated_expression: z.string(),
+    }),
+]));
+const indexInfo = z
+    .object({
+    index_name: z.string(),
+    relation_name: z.string(),
+    attributes: z.array(z.string()),
+    definition: z.string(),
+    comment: z.string().nullable(),
+})
+    .and(z.discriminatedUnion('index_kind', [
+    z.object({ index_kind: z.literal('primary') }),
+    z.object({ index_kind: z.literal('unique') }),
+    z.object({
+        index_kind: z.literal('exclusion'),
+        exclusion_operators: z.array(z.string()),
+    }),
+    z.object({ index_kind: z.literal('plain') }),
+]))
+    .and(z.discriminatedUnion('is_partial', [
+    z.object({ is_partial: z.literal(false) }),
+    z.object({
+        is_partial: z.literal(true),
+        partial_predicate: z.string(),
+    }),
+]));
+const reference = z.object({
+    constraint_name: z.string(),
+    attributes: z.array(z.string()),
+    referenced_relation: z.string(),
+    referenced_attributes: z.array(z.string()),
+    on_update: z.enum([
+        'NO ACTION',
+        'RESTRICT',
+        'CASCADE',
+        'SET NULL',
+        'SET DEFAULT',
+    ]),
+    on_delete: z.enum([
+        'NO ACTION',
+        'RESTRICT',
+        'CASCADE',
+        'SET NULL',
+        'SET DEFAULT',
+    ]),
+    comment: z.string().nullable(),
+});
+const relation = z.object({
+    name: z.string(),
+    comment: z.string().nullable(),
+    kind: z.enum(['partitioned_table', 'table', 'view', 'materialized_view']),
+    summary: z.string().optional(),
+    details: z.string().optional(),
+    attributes: z.record(z.string(), relationAttribute),
+    references: z.record(z.string(), reference),
+    indexes: z.record(z.string(), indexInfo),
+});
+const relations = z.record(z.string(), relation);
+const database = z.object({
+    type: z.enum(['postgresql']),
+    name: z.string(),
+    comment: z.string().nullable(),
+    summary: z.string().optional(),
+    details: z.string().optional(),
+    relations: relations,
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXgubWpzIiwic291cmNlUm9vdCI6Ii4vc3JjLyIsInNvdXJjZXMiOlsic2NoZW1hcy9pbmRleC5tdHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFDLENBQUMsRUFBQyxNQUFNLEtBQUssQ0FBQztBQUV0QixNQUFNLGlCQUFpQixHQUFHLENBQUM7S0FDdEIsTUFBTSxDQUFDO0lBQ0osSUFBSSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7SUFDaEIsU0FBUyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7SUFDckIsV0FBVyxFQUFFLENBQUMsQ0FBQyxPQUFPLEVBQUU7SUFDeEIsT0FBTyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUU7Q0FDakMsQ0FBQztLQUNELEdBQUcsQ0FDQSxDQUFDLENBQUMsa0JBQWtCLENBQUMsTUFBTSxFQUFFO0lBQ3pCLENBQUMsQ0FBQyxrQkFBa0IsQ0FBQyxhQUFhLEVBQUU7UUFDaEMsQ0FBQyxDQUFDLE1BQU0sQ0FBQztZQUNMLElBQUksRUFBRSxDQUFDLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQztZQUMxQixXQUFXLEVBQUUsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUM7U0FDaEMsQ0FBQztRQUNGLENBQUMsQ0FBQyxNQUFNLENBQUM7WUFDTCxJQUFJLEVBQUUsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUM7WUFDMUIsV0FBVyxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDO1lBQzVCLGtCQUFrQixFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7U0FDakMsQ0FBQztLQUNMLENBQUM7SUFDRixDQUFDLENBQUMsTUFBTSxDQUFDO1FBQ0wsSUFBSSxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsV0FBVyxDQUFDO1FBQzVCLGlCQUFpQixFQUFFLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxRQUFRLEVBQUUsU0FBUyxDQUFDLENBQUM7UUFDaEQsb0JBQW9C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UUFBUSxFQUFFO0lBQzlCLE9BQU8sRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFO0lBQzlCLFVBQVUsRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsRUFBRSxpQkFBaUIsQ0FBQztJQUNuRCxVQUFVLEVBQUUsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsU0FBUyxDQUFDO0lBQzNDLE9BQU8sRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsRUFBRSxTQUFTLENBQUM7Q0FDM0MsQ0FBQyxDQUFDO0FBRUgsTUFBTSxTQUFTLEdBQUcsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsUUFBUSxDQUFDLENBQUM7QUFFakQsTUFBTSxRQUFRLEdBQUcsQ0FBQyxDQUFDLE1BQU0sQ0FBQztJQUN0QixJQUFJLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLFlBQVksQ0FBQyxDQUFDO0lBQzVCLElBQUksRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO0lBQ2hCLE9BQU8sRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFO0lBQzlCLE9BQU8sRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFO0lBQzlCLE9BQU8sRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFO0lBQzlCLFNBQVMsRUFBRSxTQUFTO0NBQ3ZCLENBQUMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7en0gZnJvbSAnem9kJztcblxuY29uc3QgcmVsYXRpb25BdHRyaWJ1dGUgPSB6XG4gICAgLm9iamVjdCh7XG4gICAgICAgIG5hbWU6IHouc3RyaW5nKCksXG4gICAgICAgIGRhdGFfdHlwZTogei5zdHJpbmcoKSxcbiAgICAgICAgaXNfbnVsbGFibGU6IHouYm9vbGVhbigpLFxuICAgICAgICBjb21tZW50OiB6LnN0cmluZygpLm51bGxhYmxlKCksXG4gICAgfSlcbiAgICAuYW5kKFxuICAgICAgICB6LmRpc2NyaW1pbmF0ZWRVbmlvbigna2luZCcsIFtcbiAgICAgICAgICAgIHouZGlzY3JpbWluYXRlZFVuaW9uKCdoYXNfZGVmYXVsdCcsIFtcbiAgICAgICAgICAgICAgICB6Lm9iamVjdCh7XG4gICAgICAgICAgICAgICAgICAgIGtpbmQ6IHoubGl0ZXJhbCgncmVndWxhcicpLFxuICAgICAgICAgICAgICAgICAgICBoYXNfZGVmYXVsdDogei5saXRlcmFsKGZhbHNlKSxcbiAgICAgICAgICAgICAgICB9KSxcbiAgICAgICAgICAgICAgICB6Lm9iamVjdCh7XG4gICAgICAgICAgICAgICAgICAgIGtpbmQ6IHoubGl0ZXJhbCgncmVndWxhcicpLFxuICAgICAgICAgICAgICAgICAgICBoYXNfZGVmYXVsdDogei5saXRlcmFsKHRydWUpLFxuICAgICAgICAgICAgICAgICAgICBkZWZhdWx0X2V4cHJlc3Npb246IHouc3RyaW5nKCksXG4gICAgICAgICAgICAgICAgfSksXG4gICAgICAgICAgICBdKSxcbiAgICAgICAgICAgIHoub2JqZWN0KHtcbiAgICAgICAgICAgICAgICBraW5kOiB6LmxpdGVyYWwoJ2dlbmVyYXRlZCcpLFxuICAgICAgICAgICAgICAgIGdlbmVyYXRlZF9zdG9yYWdlOiB6LmVudW0oWydzdG9yZWQnLCAndmlydHVhbCddKSxcbiAgICAgICAgICAgICAgICBnZW5lcmF0ZWRfZXhwcmVzc2lvbjogei5zdHJpbmcoKSxcbiAgICAgICAgICAgIH0pLFxuICAgICAgICBdKSxcbiAgICApO1xuXG5jb25zdCBpbmRleEluZm8gPSB6XG4gICAgLm9iamVjdCh7XG4gICAgICAgIGluZGV4X25hbWU6IHouc3RyaW5nKCksXG4gICAgICAgIHJlbGF0aW9uX25hbWU6IHouc3RyaW5nKCksXG4gICAgICAgIGF0dHJpYnV0ZXM6IHouYXJyYXkoei5zdHJpbmcoKSksXG4gICAgICAgIGRlZmluaXRpb246IHouc3RyaW5nKCksXG4gICAgICAgIGNvbW1lbnQ6IHouc3RyaW5nKCkubnVsbGFibGUoKSxcbiAgICB9KVxuICAgIC5hbmQoXG4gICAgICAgIHouZGlzY3JpbWluYXRlZFVuaW9uKCdpbmRleF9raW5kJywgW1xuICAgICAgICAgICAgei5vYmplY3QoeyBpbmRleF9raW5kOiB6LmxpdGVyYWwoJ3ByaW1hcnknKSB9KSxcbiAgICAgICAgICAgIHoub2JqZWN0KHsgaW5kZXhfa2luZDogei5saXRlcmFsKCd1bmlxdWUnKSB9KSxcbiAgICAgICAgICAgIHoub2JqZWN0KHtcbiAgICAgICAgICAgICAgICBpbmRleF9raW5kOiB6LmxpdGVyYWwoJ2V4Y2x1c2lvbicpLFxuICAgICAgICAgICAgICAgIGV4Y2x1c2lvbl9vcGVyYXRvcnM6IHouYXJyYXkoei5zdHJpbmcoKSksXG4gICAgICAgICAgICB9KSxcbiAgICAgICAgICAgIHoub2JqZWN0KHsgaW5kZXhfa2luZDogei5saXRlcmFsKCdwbGFpbicpIH0pLFxuICAgICAgICBdKSxcbiAgICApXG4gICAgLmFuZChcbiAgICAgICAgei5kaXNjcmltaW5hdGVkVW5pb24oJ2lzX3BhcnRpYWwnLCBbXG4gICAgICAgICAgICB6Lm9iamVjdCh7IGlzX3BhcnRpYWw6IHoubGl0ZXJhbChmYWxzZSkgfSksXG4gICAgICAgICAgICB6Lm9iamVjdCh7XG4gICAgICAgICAgICAgICAgaXNfcGFydGlhbDogei5saXRlcmFsKHRydWUpLFxuICAgICAgICAgICAgICAgIHBhcnRpYWxfcHJlZGljYXRlOiB6LnN0cmluZygpLFxuICAgICAgICAgICAgfSksXG4gICAgICAgIF0pLFxuICAgICk7XG5cbmNvbnN0IHJlZmVyZW5jZSA9IHoub2JqZWN0KHtcbiAgICBjb25zdHJhaW50X25hbWU6IHouc3RyaW5nKCksXG4gICAgYXR0cmlidXRlczogei5hcnJheSh6LnN0cmluZygpKSxcbiAgICByZWZlcmVuY2VkX3JlbGF0aW9uOiB6LnN0cmluZygpLFxuICAgIHJlZmVyZW5jZWRfYXR0cmlidXRlczogei5hcnJheSh6LnN0cmluZygpKSxcbiAgICBvbl91cGRhdGU6IHouZW51bShbXG4gICAgICAgICdOTyBBQ1RJT04nLFxuICAgICAgICAnUkVTVFJJQ1QnLFxuICAgICAgICAnQ0FTQ0FERScsXG4gICAgICAgICdTRVQgTlVMTCcsXG4gICAgICAgICdTRVQgREVGQVVMVCcsXG4gICAgXSksXG4gICAgb25fZGVsZXRlOiB6LmVudW0oW1xuICAgICAgICAnTk8gQUNUSU9OJyxcbiAgICAgICAgJ1JFU1RSSUNUJyxcbiAgICAgICAgJ0NBU0NBREUnLFxuICAgICAgICAnU0VUIE5VTEwnLFxuICAgICAgICAnU0VUIERFRkFVTFQnLFxuICAgIF0pLFxuICAgIGNvbW1lbnQ6IHouc3RyaW5nKCkubnVsbGFibGUoKSxcbn0pO1xuXG5jb25zdCByZWxhdGlvbiA9IHoub2JqZWN0KHtcbiAgICBuYW1lOiB6LnN0cmluZygpLFxuICAgIGNvbW1lbnQ6IHouc3RyaW5nKCkubnVsbGFibGUoKSxcbiAgICBraW5kOiB6LmVudW0oWydwYXJ0aXRpb25lZF90YWJsZScsICd0YWJsZScsICd2aWV3JywgJ21hdGVyaWFsaXplZF92aWV3J10pLFxuICAgIHN1bW1hcnk6IHouc3RyaW5nKCkub3B0aW9uYWwoKSxcbiAgICBkZXRhaWxzOiB6LnN0cmluZygpLm9wdGlvbmFsKCksXG4gICAgYXR0cmlidXRlczogei5yZWNvcmQoei5zdHJpbmcoKSwgcmVsYXRpb25BdHRyaWJ1dGUpLFxuICAgIHJlZmVyZW5jZXM6IHoucmVjb3JkKHouc3RyaW5nKCksIHJlZmVyZW5jZSksXG4gICAgaW5kZXhlczogei5yZWNvcmQoei5zdHJpbmcoKSwgaW5kZXhJbmZvKSxcbn0pO1xuXG5jb25zdCByZWxhdGlvbnMgPSB6LnJlY29yZCh6LnN0cmluZygpLCByZWxhdGlvbik7XG5cbmNvbnN0IGRhdGFiYXNlID0gei5vYmplY3Qoe1xuICAgIHR5cGU6IHouZW51bShbJ3Bvc3RncmVzcWwnXSksXG4gICAgbmFtZTogei5zdHJpbmcoKSxcbiAgICBjb21tZW50OiB6LnN0cmluZygpLm51bGxhYmxlKCksXG4gICAgc3VtbWFyeTogei5zdHJpbmcoKS5vcHRpb25hbCgpLFxuICAgIGRldGFpbHM6IHouc3RyaW5nKCkub3B0aW9uYWwoKSxcbiAgICByZWxhdGlvbnM6IHJlbGF0aW9ucyxcbn0pO1xuIl19

package/dist/validatePaths.d.mts

@@ -0,0 +1,12 @@
+type TPathOptionKey = "sslcert" | "sslkey" | "sslrootcert" | "sshPrivateKey";
+export type TPathValidationError = {
+    option: string;
+    path: string;
+    error: string;
+};
+export declare const validatePathOptions: <T extends Partial<Record<TPathOptionKey, string>>>(options: T) => {
+    errors: TPathValidationError[];
+    expandedPaths: Partial<Record<TPathOptionKey, string>>;
+};
+export {};
+//# sourceMappingURL=validatePaths.d.mts.map

package/dist/validatePaths.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatePaths.d.mts","sourceRoot":"./src/","sources":["validatePaths.mts"],"names":[],"mappings":"AAQA,KAAK,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAyBF,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,EACjF,SAAS,CAAC,KACX;IAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAA;CAmC1F,CAAC"}

package/dist/validatePaths.mjs

@@ -0,0 +1,48 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+const expandTilde = (path) => path.startsWith("~/") || path === "~"
+    ? path.replace(/^~/, homedir())
+    : path;
+const normalizePath = (path) => resolve(expandTilde(path));
+const validatePathExists = (path) => {
+    const expandedPath = normalizePath(path);
+    return existsSync(expandedPath)
+        ? { valid: true, expandedPath }
+        : { valid: false, error: `Path does not exist: ${path}` };
+};
+const PATH_OPTION_LABELS = {
+    sslcert: "--sslcert",
+    sslkey: "--sslkey",
+    sslrootcert: "--sslrootcert",
+    sshPrivateKey: "--ssh-private-key",
+};
+export const validatePathOptions = (options) => {
+    const pathKeys = ["sslcert", "sslkey", "sslrootcert", "sshPrivateKey"];
+    const results = pathKeys
+        .filter((key) => options[key] !== undefined)
+        .map((key) => {
+        const path = options[key];
+        const result = validatePathExists(path);
+        return {
+            key,
+            path,
+            result,
+        };
+    });
+    const errors = results
+        .filter((r) => !r.result.valid)
+        .map((r) => ({
+        option: PATH_OPTION_LABELS[r.key],
+        path: r.path,
+        error: r.result.error,
+    }));
+    const expandedPaths = results
+        .filter((r) => r.result.valid)
+        .reduce((acc, r) => ({
+        ...acc,
+        [r.key]: r.result.expandedPath,
+    }), {});
+    return { errors, expandedPaths };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGVQYXRocy5tanMiLCJzb3VyY2VSb290IjoiLi9zcmMvIiwic291cmNlcyI6WyJ2YWxpZGF0ZVBhdGhzLm10cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ3JDLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDbEMsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLFdBQVcsQ0FBQztBQWNwQyxNQUFNLFdBQVcsR0FBRyxDQUFDLElBQVksRUFBVSxFQUFFLENBQ3pDLElBQUksQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLElBQUksSUFBSSxLQUFLLEdBQUc7SUFDakMsQ0FBQyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLE9BQU8sRUFBRSxDQUFDO0lBQy9CLENBQUMsQ0FBQyxJQUFJLENBQUM7QUFFZixNQUFNLGFBQWEsR0FBRyxDQUFDLElBQVksRUFBVSxFQUFFLENBQzNDLE9BQU8sQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQztBQUUvQixNQUFNLGtCQUFrQixHQUFHLENBQUMsSUFBWSxFQUF5QixFQUFFO0lBQy9ELE1BQU0sWUFBWSxHQUFHLGFBQWEsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUV6QyxPQUFPLFVBQVUsQ0FBQyxZQUFZLENBQUM7UUFDM0IsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLElBQUksRUFBRSxZQUFZLEVBQUU7UUFDL0IsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsd0JBQXdCLElBQUksRUFBRSxFQUFFLENBQUM7QUFDbEUsQ0FBQyxDQUFDO0FBRUYsTUFBTSxrQkFBa0IsR0FBbUM7SUFDdkQsT0FBTyxFQUFFLFdBQVc7SUFDcEIsTUFBTSxFQUFFLFVBQVU7SUFDbEIsV0FBVyxFQUFFLGVBQWU7SUFDNUIsYUFBYSxFQUFFLG1CQUFtQjtDQUNyQyxDQUFDO0FBRUYsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQUcsQ0FDL0IsT0FBVSxFQUNnRixFQUFFO0lBQzVGLE1BQU0sUUFBUSxHQUFxQixDQUFDLFNBQVMsRUFBRSxRQUFRLEVBQUUsYUFBYSxFQUFFLGVBQWUsQ0FBQyxDQUFDO0lBRXpGLE1BQU0sT0FBTyxHQUFHLFFBQVE7U0FDbkIsTUFBTSxDQUFDLENBQUMsR0FBRyxFQUFFLEVBQUUsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLEtBQUssU0FBUyxDQUFDO1NBQzNDLEdBQUcsQ0FBQyxDQUFDLEdBQUcsRUFBRSxFQUFFO1FBQ1QsTUFBTSxJQUFJLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBVyxDQUFDO1FBQ3BDLE1BQU0sTUFBTSxHQUFHLGtCQUFrQixDQUFDLElBQUksQ0FBQyxDQUFDO1FBRXhDLE9BQU87WUFDSCxHQUFHO1lBQ0gsSUFBSTtZQUNKLE1BQU07U0FDVCxDQUFDO0lBQ04sQ0FBQyxDQUFDLENBQUM7SUFFUCxNQUFNLE1BQU0sR0FBRyxPQUFPO1NBQ2pCLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQztTQUM5QixHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUM7UUFDVCxNQUFNLEVBQUUsa0JBQWtCLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQztRQUNqQyxJQUFJLEVBQUUsQ0FBQyxDQUFDLElBQUk7UUFDWixLQUFLLEVBQUcsQ0FBQyxDQUFDLE1BQTBDLENBQUMsS0FBSztLQUM3RCxDQUFDLENBQUMsQ0FBQztJQUVSLE1BQU0sYUFBYSxHQUFHLE9BQU87U0FDeEIsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQztTQUM3QixNQUFNLENBQ0gsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQ1QsR0FBRyxHQUFHO1FBQ04sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEVBQUcsQ0FBQyxDQUFDLE1BQWdELENBQUMsWUFBWTtLQUM1RSxDQUFDLEVBQ0YsRUFBNkMsQ0FDaEQsQ0FBQztJQUVOLE9BQU8sRUFBRSxNQUFNLEVBQUUsYUFBYSxFQUFFLENBQUM7QUFDckMsQ0FBQyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgZXhpc3RzU3luYyB9IGZyb20gXCJub2RlOmZzXCI7XG5pbXBvcnQgeyBob21lZGlyIH0gZnJvbSBcIm5vZGU6b3NcIjtcbmltcG9ydCB7IHJlc29sdmUgfSBmcm9tIFwibm9kZTpwYXRoXCI7XG5cbnR5cGUgVFBhdGhWYWxpZGF0aW9uUmVzdWx0ID1cbiAgICB8IHsgdmFsaWQ6IHRydWU7IGV4cGFuZGVkUGF0aDogc3RyaW5nIH1cbiAgICB8IHsgdmFsaWQ6IGZhbHNlOyBlcnJvcjogc3RyaW5nIH07XG5cbnR5cGUgVFBhdGhPcHRpb25LZXkgPSBcInNzbGNlcnRcIiB8IFwic3Nsa2V5XCIgfCBcInNzbHJvb3RjZXJ0XCIgfCBcInNzaFByaXZhdGVLZXlcIjtcblxuZXhwb3J0IHR5cGUgVFBhdGhWYWxpZGF0aW9uRXJyb3IgPSB7XG4gICAgb3B0aW9uOiBzdHJpbmc7XG4gICAgcGF0aDogc3RyaW5nO1xuICAgIGVycm9yOiBzdHJpbmc7XG59O1xuXG5jb25zdCBleHBhbmRUaWxkZSA9IChwYXRoOiBzdHJpbmcpOiBzdHJpbmcgPT5cbiAgICBwYXRoLnN0YXJ0c1dpdGgoXCJ+L1wiKSB8fCBwYXRoID09PSBcIn5cIlxuICAgICAgICA/IHBhdGgucmVwbGFjZSgvXn4vLCBob21lZGlyKCkpXG4gICAgICAgIDogcGF0aDtcblxuY29uc3Qgbm9ybWFsaXplUGF0aCA9IChwYXRoOiBzdHJpbmcpOiBzdHJpbmcgPT5cbiAgICByZXNvbHZlKGV4cGFuZFRpbGRlKHBhdGgpKTtcblxuY29uc3QgdmFsaWRhdGVQYXRoRXhpc3RzID0gKHBhdGg6IHN0cmluZyk6IFRQYXRoVmFsaWRhdGlvblJlc3VsdCA9PiB7XG4gICAgY29uc3QgZXhwYW5kZWRQYXRoID0gbm9ybWFsaXplUGF0aChwYXRoKTtcblxuICAgIHJldHVybiBleGlzdHNTeW5jKGV4cGFuZGVkUGF0aClcbiAgICAgICAgPyB7IHZhbGlkOiB0cnVlLCBleHBhbmRlZFBhdGggfVxuICAgICAgICA6IHsgdmFsaWQ6IGZhbHNlLCBlcnJvcjogYFBhdGggZG9lcyBub3QgZXhpc3Q6ICR7cGF0aH1gIH07XG59O1xuXG5jb25zdCBQQVRIX09QVElPTl9MQUJFTFM6IFJlY29yZDxUUGF0aE9wdGlvbktleSwgc3RyaW5nPiA9IHtcbiAgICBzc2xjZXJ0OiBcIi0tc3NsY2VydFwiLFxuICAgIHNzbGtleTogXCItLXNzbGtleVwiLFxuICAgIHNzbHJvb3RjZXJ0OiBcIi0tc3Nscm9vdGNlcnRcIixcbiAgICBzc2hQcml2YXRlS2V5OiBcIi0tc3NoLXByaXZhdGUta2V5XCIsXG59O1xuXG5leHBvcnQgY29uc3QgdmFsaWRhdGVQYXRoT3B0aW9ucyA9IDxUIGV4dGVuZHMgUGFydGlhbDxSZWNvcmQ8VFBhdGhPcHRpb25LZXksIHN0cmluZz4+PihcbiAgICBvcHRpb25zOiBUXG4pOiB7IGVycm9yczogVFBhdGhWYWxpZGF0aW9uRXJyb3JbXTsgZXhwYW5kZWRQYXRoczogUGFydGlhbDxSZWNvcmQ8VFBhdGhPcHRpb25LZXksIHN0cmluZz4+IH0gPT4ge1xuICAgIGNvbnN0IHBhdGhLZXlzOiBUUGF0aE9wdGlvbktleVtdID0gW1wic3NsY2VydFwiLCBcInNzbGtleVwiLCBcInNzbHJvb3RjZXJ0XCIsIFwic3NoUHJpdmF0ZUtleVwiXTtcblxuICAgIGNvbnN0IHJlc3VsdHMgPSBwYXRoS2V5c1xuICAgICAgICAuZmlsdGVyKChrZXkpID0+IG9wdGlvbnNba2V5XSAhPT0gdW5kZWZpbmVkKVxuICAgICAgICAubWFwKChrZXkpID0+IHtcbiAgICAgICAgICAgIGNvbnN0IHBhdGggPSBvcHRpb25zW2tleV0gYXMgc3RyaW5nO1xuICAgICAgICAgICAgY29uc3QgcmVzdWx0ID0gdmFsaWRhdGVQYXRoRXhpc3RzKHBhdGgpO1xuXG4gICAgICAgICAgICByZXR1cm4ge1xuICAgICAgICAgICAgICAgIGtleSxcbiAgICAgICAgICAgICAgICBwYXRoLFxuICAgICAgICAgICAgICAgIHJlc3VsdCxcbiAgICAgICAgICAgIH07XG4gICAgICAgIH0pO1xuXG4gICAgY29uc3QgZXJyb3JzID0gcmVzdWx0c1xuICAgICAgICAuZmlsdGVyKChyKSA9PiAhci5yZXN1bHQudmFsaWQpXG4gICAgICAgIC5tYXAoKHIpID0+ICh7XG4gICAgICAgICAgICBvcHRpb246IFBBVEhfT1BUSU9OX0xBQkVMU1tyLmtleV0sXG4gICAgICAgICAgICBwYXRoOiByLnBhdGgsXG4gICAgICAgICAgICBlcnJvcjogKHIucmVzdWx0IGFzIHsgdmFsaWQ6IGZhbHNlOyBlcnJvcjogc3RyaW5nIH0pLmVycm9yLFxuICAgICAgICB9KSk7XG5cbiAgICBjb25zdCBleHBhbmRlZFBhdGhzID0gcmVzdWx0c1xuICAgICAgICAuZmlsdGVyKChyKSA9PiByLnJlc3VsdC52YWxpZClcbiAgICAgICAgLnJlZHVjZShcbiAgICAgICAgICAgIChhY2MsIHIpID0+ICh7XG4gICAgICAgICAgICAgICAgLi4uYWNjLFxuICAgICAgICAgICAgICAgIFtyLmtleV06IChyLnJlc3VsdCBhcyB7IHZhbGlkOiB0cnVlOyBleHBhbmRlZFBhdGg6IHN0cmluZyB9KS5leHBhbmRlZFBhdGgsXG4gICAgICAgICAgICB9KSxcbiAgICAgICAgICAgIHt9IGFzIFBhcnRpYWw8UmVjb3JkPFRQYXRoT3B0aW9uS2V5LCBzdHJpbmc+PlxuICAgICAgICApO1xuXG4gICAgcmV0dXJuIHsgZXJyb3JzLCBleHBhbmRlZFBhdGhzIH07XG59O1xuIl19

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "dbctx",
+    "version": "1.0.0",
+    "description": "dbctx CLI",
+    "type": "module",
+    "main": "dist/index.mjs",
+    "bin": {
+        "dbctx": "./dist/index.mjs"
+    },
+    "scripts": {
+        "start": "tsc && node ./dist/index.mjs",
+        "dev": "tsc --watch --preserveWatchOutput",
+        "build": "tsc",
+        "build:ts:watch": "tsc --watch --preserveWatchOutput"
+    },
+    "keywords": [],
+    "author": {
+        "name": "AirState",
+        "email": "hello@airstate.dev",
+        "url": "https://airstate.dev"
+    },
+    "license": "UNLICENSED",
+    "dependencies": {
+        "commander": "14.0.3",
+        "es-toolkit": "1.44.0",
+        "ink": "6.6.0",
+        "pg": "8.18.0",
+        "react": "19.2.4",
+        "winston": "3.19.0",
+        "zod": "4.3.6"
+    },
+    "devDependencies": {
+        "@types/node": "24.0.0",
+        "@types/pg": "8.16.0",
+        "@types/react": "19.2.10",
+        "concurrently": "9.2.1",
+        "cross-env": "7.0.3",
+        "typescript": "5.9.3"
+    },
+    "volta": {
+        "node": "24.0.0"
+    }
+}

package/src/App.tsx

@@ -0,0 +1,44 @@
+import { Text, Box } from "ink";
+import type { ReactNode } from "react";
+import type { TSSLMode } from "./index.mjs";
+
+export type TConnectionConfig = {
+    connectionString?: string;
+    hostname?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    sslmode?: TSSLMode;
+    sslcert?: string;
+    sslkey?: string;
+    sslrootcert?: string;
+    sshHost?: string;
+    sshPort?: number;
+    sshUsername?: string;
+    sshPrivateKey?: string;
+};
+
+type TAppProps = {
+    config: TConnectionConfig;
+};
+
+export function App({ config }: TAppProps): ReactNode {
+    const connectionTarget = config.connectionString
+        ? config.connectionString.replace(/:[^:@]+@/, ":***@") // mask password
+        : `${config.hostname}:${config.port}/${config.database}`;
+
+    return (
+        <Box flexDirection="column" padding={1}>
+            <Box marginBottom={1}>
+                <Text color="cyan" bold>
+                    dbctx
+                </Text>
+                <Text dimColor> - AI generated docs from your application database</Text>
+            </Box>
+            <Box>
+                <Text dimColor>Connecting to: </Text>
+                <Text color="yellow">{connectionTarget}</Text>
+            </Box>
+        </Box>
+    );
+}

package/src/components/Error.tsx

@@ -0,0 +1,16 @@
+import { Text, Box } from "ink";
+import type { ReactNode } from "react";
+
+interface ErrorProps {
+    message: string;
+}
+
+export function Error({ message }: ErrorProps): ReactNode {
+    return (
+        <Box>
+            <Text color="red" bold>
+                Error: {message}
+            </Text>
+        </Box>
+    );
+}

package/src/db/analyze.mts

@@ -0,0 +1,22 @@
+import type { Pool } from "pg";
+
+export const analyzeRelation = async (pool: Pool, relationName: string): Promise<void> => {
+    // Validate relation exists and get properly quoted name to prevent SQL injection
+    const validation = await pool.query<{ quoted_name: string }>(
+        `
+        SELECT format('%I', c.relname) AS quoted_name
+        FROM pg_catalog.pg_class c
+        JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
+        WHERE n.nspname = 'public'
+            AND c.relname = $1
+            AND c.relkind IN ('r', 'p', 'm')
+        `,
+        [relationName]
+    );
+
+    if (validation.rows.length === 0) {
+        throw new Error(`Relation "${relationName}" not found in public schema`);
+    }
+
+    await pool.query(`ANALYZE public.${validation.rows[0].quoted_name}`);
+};

package/src/db/attributes.mts

@@ -0,0 +1,58 @@
+import type { Pool } from "pg";
+
+export type TAttributeKind = "regular" | "generated";
+
+export type TGeneratedStorage = "stored" | "virtual";
+
+export type TAttributeInfo = {
+    attribute_name: string;
+    data_type: string;
+    is_nullable: boolean;
+    has_default: boolean;
+    default_expression: string | null;
+    kind: TAttributeKind;
+    generated_storage: TGeneratedStorage | null;
+    generated_expression: string | null;
+    comment: string | null;
+};
+
+export const fetchRelationAttributes = async (pool: Pool, relationName: string): Promise<TAttributeInfo[]> => {
+    const result = await pool.query<TAttributeInfo>(
+        `
+        SELECT
+            a.attname AS attribute_name,
+            format_type(a.atttypid, a.atttypemod) AS data_type,
+            NOT a.attnotnull AS is_nullable,
+            ad.adbin IS NOT NULL AS has_default,
+            CASE
+                WHEN a.attgenerated = '' AND ad.adbin IS NOT NULL THEN pg_get_expr(ad.adbin, ad.adrelid)
+                ELSE NULL
+            END AS default_expression,
+            CASE a.attgenerated
+                WHEN '' THEN 'regular'
+                ELSE 'generated'
+            END AS kind,
+            CASE a.attgenerated
+                WHEN 's' THEN 'stored'
+                WHEN 'v' THEN 'virtual'
+                ELSE NULL
+            END AS generated_storage,
+            CASE
+                WHEN a.attgenerated != '' THEN pg_get_expr(ad.adbin, ad.adrelid)
+                ELSE NULL
+            END AS generated_expression,
+            col_description(c.oid, a.attnum) AS comment
+        FROM pg_catalog.pg_class c
+        JOIN pg_catalog.pg_attribute a ON a.attrelid = c.oid
+        LEFT JOIN pg_catalog.pg_attrdef ad ON ad.adrelid = a.attrelid AND ad.adnum = a.attnum
+        WHERE c.relname = $1
+            AND c.relnamespace = (SELECT oid FROM pg_namespace WHERE nspname = 'public')
+            AND a.attnum > 0
+            AND NOT a.attisdropped
+        ORDER BY a.attnum
+        `,
+        [relationName]
+    );
+
+    return result.rows;
+};

package/src/db/enums.mts

@@ -0,0 +1,43 @@
+import type { Pool } from "pg";
+import { groupBy } from "es-toolkit";
+
+type TEnumValueRow = {
+    enum_name: string;
+    value: string;
+    sort_order: number;
+    comment: string | null;
+};
+
+export type TEnumInfo = {
+    values: string[];
+    comment: string | null;
+};
+
+export type TGroupedEnums = Record<string, TEnumInfo>;
+
+export const fetchPublicEnums = async (pool: Pool): Promise<TGroupedEnums> => {
+    const result = await pool.query<TEnumValueRow>(`
+        SELECT
+            t.typname AS enum_name,
+            e.enumlabel AS value,
+            e.enumsortorder AS sort_order,
+            obj_description(t.oid, 'pg_type') AS comment
+        FROM pg_catalog.pg_type t
+        JOIN pg_catalog.pg_enum e ON t.oid = e.enumtypid
+        JOIN pg_catalog.pg_namespace n ON t.typnamespace = n.oid
+        WHERE n.nspname = 'public'
+        ORDER BY enum_name, sort_order
+    `);
+
+    const grouped = groupBy(result.rows, (row) => row.enum_name);
+
+    return Object.fromEntries(
+        Object.entries(grouped).map(([name, rows]) => [
+            name,
+            {
+                values: rows.map((r) => r.value),
+                comment: rows[0]?.comment ?? null,
+            },
+        ])
+    );
+};

package/src/db/file-stats.mts

@@ -0,0 +1,57 @@
+import type { Pool } from "pg";
+
+export type TRelationFileStats = {
+    relation_name: string;
+    file_path: string | null;
+    modification_time: Date;
+    size_bytes: number;
+    is_partitioned: boolean;
+    partition_count: number | null;
+};
+
+export const fetchRelationFileStats = async (pool: Pool, relationName: string): Promise<TRelationFileStats> => {
+    const result = await pool.query<TRelationFileStats>(
+        `
+        WITH target AS (
+            SELECT c.oid, c.relname, c.relkind
+            FROM pg_catalog.pg_class c
+            JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
+            WHERE n.nspname = 'public'
+                AND c.relname = $1
+                AND c.relkind IN ('r', 'p', 'm')
+        ),
+        partition_stats AS (
+            SELECT
+                (pg_stat_file(pg_relation_filepath(child.oid))).modification AS modification_time,
+                (pg_stat_file(pg_relation_filepath(child.oid))).size AS size_bytes
+            FROM target t
+            JOIN pg_catalog.pg_inherits i ON i.inhparent = t.oid
+            JOIN pg_catalog.pg_class child ON child.oid = i.inhrelid
+            WHERE t.relkind = 'p'
+        )
+        SELECT
+            t.relname AS relation_name,
+            CASE
+                WHEN t.relkind = 'p' THEN NULL
+                ELSE pg_relation_filepath(t.oid)
+            END AS file_path,
+            CASE
+                WHEN t.relkind = 'p' THEN (SELECT MAX(modification_time) FROM partition_stats)
+                ELSE (pg_stat_file(pg_relation_filepath(t.oid))).modification
+            END AS modification_time,
+            CASE
+                WHEN t.relkind = 'p' THEN (SELECT COALESCE(SUM(size_bytes), 0) FROM partition_stats)
+                ELSE (pg_stat_file(pg_relation_filepath(t.oid))).size
+            END AS size_bytes,
+            t.relkind = 'p' AS is_partitioned,
+            CASE
+                WHEN t.relkind = 'p' THEN (SELECT COUNT(*) FROM partition_stats)
+                ELSE NULL
+            END AS partition_count
+        FROM target t
+        `,
+        [relationName]
+    );
+
+    return result.rows[0];
+};