pgpm 2.10.0 → 2.10.2

package/README.md

@@ -328,6 +328,28 @@ pgpm package --no-plan
 
 ### Utilities
 
+#### `pgpm dump`
+
+Dump a postgres database to a sql file.
+
+```bash
+# dump to default timestamped file
+pgpm dump --database mydb
+
+# interactive mode (prompts for database)
+pgpm dump
+
+# dump to specific file
+pgpm dump --database mydb --out ./backup.sql
+
+# dump from a specific working directory
+pgpm dump --database mydb --cwd ./packages/my-module
+
+# dump with pruning 
+# useful for creating test fixtures or development snapshots
+pgpm dump --database mydb --database-id <uuid>
+```
+
 #### `pgpm export`
 
 Export migrations from existing databases.

package/commands/dump.d.ts

@@ -0,0 +1,4 @@
+import { CLIOptions, Inquirerer } from 'inquirerer';
+import { ParsedArgs } from 'minimist';
+declare const _default: (argv: Partial<ParsedArgs>, prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<ParsedArgs>>;
+export default _default;

package/commands/dump.js

@@ -0,0 +1,166 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const logger_1 = require("@pgpmjs/logger");
+const pg_env_1 = require("pg-env");
+const pg_cache_1 = require("pg-cache");
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const quote_utils_1 = require("pgsql-deparser/utils/quote-utils");
+const utils_1 = require("../utils");
+const log = new logger_1.Logger('dump');
+const dumpUsageText = `
+Dump Command:
+
+  pgpm dump [options]
+
+  Dump a postgres database to a sql file.
+
+Options:
+  --help, -h                 Show this help message
+  --db, --database <name>    Target postgres database name
+  --out <path>               Output file path
+  --database-id <id>         When set, the dump will include a prune step that keeps only this database_id after restore
+  --cwd <directory>          Working directory (default: current directory)
+
+Examples:
+  pgpm dump
+  pgpm dump --database mydb
+  pgpm dump --database mydb --out ./mydb.sql
+  pgpm dump --database mydb --database-id 00000000-0000-0000-0000-000000000000
+`;
+function nowStamp() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
+}
+async function runPgDump(args, env) {
+    await new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)('pg_dump', args, {
+            env,
+            stdio: 'inherit',
+            shell: false
+        });
+        child.on('error', (err) => {
+            if (err.code === 'ENOENT') {
+                log.error('pg_dump not found; ensure PostgreSQL client tools are installed and in PATH');
+            }
+            reject(err);
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`pg_dump exited with code ${code ?? 1}`));
+        });
+    });
+}
+async function resolveDatabaseId(dbname, databaseIdRaw) {
+    const pool = (0, pg_cache_1.getPgPool)((0, pg_env_1.getPgEnvOptions)({ database: dbname }));
+    const res = await pool.query(`select id, name from metaschema_public.database order by name`);
+    const byId = res.rows.find((r) => String(r.id) === databaseIdRaw);
+    if (byId)
+        return { id: String(byId.id), name: String(byId.name) };
+    const byName = res.rows.find((r) => String(r.name) === databaseIdRaw);
+    if (byName)
+        return { id: String(byName.id), name: String(byName.name) };
+    return null;
+}
+async function buildPruneSql(dbname, databaseId) {
+    const pool = (0, pg_cache_1.getPgPool)((0, pg_env_1.getPgEnvOptions)({ database: dbname }));
+    const tables = await pool.query(`
+    select c.table_schema, c.table_name
+    from information_schema.columns c
+    join information_schema.tables t
+      on t.table_schema = c.table_schema
+      and t.table_name = c.table_name
+    where c.column_name = 'database_id'
+      and t.table_type = 'BASE TABLE'
+      and c.table_schema not in ('pg_catalog', 'information_schema')
+    order by c.table_schema, c.table_name
+  `);
+    const lines = [];
+    lines.push('');
+    lines.push('-- pgpm dump prune');
+    lines.push('-- this section keeps only one database_id after restore');
+    lines.push('do $$ begin');
+    lines.push(`  raise notice 'pruning data to database_id ${databaseId}';`);
+    lines.push('end $$;');
+    lines.push('set session_replication_role = replica;');
+    for (const row of tables.rows) {
+        const schema = String(row.table_schema);
+        const table = String(row.table_name);
+        // Use QuoteUtils for robust identifier quoting
+        const qualified = quote_utils_1.QuoteUtils.quoteQualifiedIdentifier(schema, table);
+        // Use formatEString to safely escape the UUID/string literal
+        const dbIdLiteral = quote_utils_1.QuoteUtils.formatEString(databaseId);
+        lines.push(`delete from ${qualified} where database_id <> ${dbIdLiteral};`);
+    }
+    // Handle metaschema_public.database deletion
+    const metaschemaDb = quote_utils_1.QuoteUtils.quoteQualifiedIdentifier('metaschema_public', 'database');
+    const dbIdLiteral = quote_utils_1.QuoteUtils.formatEString(databaseId);
+    lines.push(`delete from ${metaschemaDb} where id <> ${dbIdLiteral};`);
+    lines.push('set session_replication_role = origin;');
+    lines.push('do $$ begin');
+    lines.push(`  raise notice 'prune done';`);
+    lines.push('end $$;');
+    lines.push('');
+    return lines.join('\n');
+}
+// Helper to retrieve argument from parsed argv or positional _ array
+function getArg(argv, key) {
+    if (argv[key])
+        return argv[key];
+    const args = argv._ || [];
+    const idx = args.indexOf(`--${key}`);
+    if (idx > -1 && args.length > idx + 1) {
+        return args[idx + 1];
+    }
+    return undefined;
+}
+exports.default = async (argv, prompter, _options) => {
+    if (argv.help || argv.h) {
+        console.log(dumpUsageText);
+        process.exit(0);
+    }
+    const cwd = argv.cwd || process.cwd();
+    const dbname = await (0, utils_1.getTargetDatabase)(argv, prompter, { message: 'Select database' });
+    const outPath = path_1.default.resolve(cwd, argv.out || `pgpm-dump-${dbname}-${nowStamp()}.sql`);
+    fs_1.default.mkdirSync(path_1.default.dirname(outPath), { recursive: true });
+    let databaseIdInfo = null;
+    const databaseIdRaw = getArg(argv, 'database-id');
+    if (databaseIdRaw) {
+        databaseIdInfo = await resolveDatabaseId(dbname, databaseIdRaw);
+        if (!databaseIdInfo) {
+            throw new Error(`unknown database-id ${databaseIdRaw}`);
+        }
+    }
+    log.info(`dumping database ${dbname}`);
+    log.info(`writing to ${outPath}`);
+    if (databaseIdInfo) {
+        log.info(`database id ${databaseIdInfo.id}`);
+    }
+    const pgEnv = (0, pg_env_1.getPgEnvOptions)({ database: dbname });
+    const spawnEnv = (0, pg_env_1.getSpawnEnvWithPg)(pgEnv);
+    const args = [
+        '--format=plain',
+        '--no-owner',
+        '--no-privileges',
+        '--file',
+        outPath,
+        dbname
+    ];
+    await runPgDump(args, spawnEnv);
+    if (databaseIdInfo) {
+        const pruneSql = await buildPruneSql(dbname, databaseIdInfo.id);
+        // Use writeFileSync with 'a' flag for explicit append as requested
+        fs_1.default.writeFileSync(outPath, pruneSql, { encoding: 'utf8', flag: 'a' });
+        log.info('added prune section to dump file');
+    }
+    log.success('dump complete');
+    return argv;
+};

package/commands.js

@@ -14,6 +14,7 @@ const cache_1 = __importDefault(require("./commands/cache"));
 const clear_1 = __importDefault(require("./commands/clear"));
 const deploy_1 = __importDefault(require("./commands/deploy"));
 const docker_1 = __importDefault(require("./commands/docker"));
+const dump_1 = __importDefault(require("./commands/dump"));
 const env_1 = __importDefault(require("./commands/env"));
 const export_1 = __importDefault(require("./commands/export"));
 const extension_1 = __importDefault(require("./commands/extension"));
@@ -50,6 +51,7 @@ const createPgpmCommandMap = (skipPgTeardown = false) => {
         clear: pgt(clear_1.default),
         deploy: pgt(deploy_1.default),
         docker: docker_1.default,
+        dump: pgt(dump_1.default),
         env: env_1.default,
         verify: pgt(verify_1.default),
         revert: pgt(revert_1.default),

package/esm/commands/dump.js

@@ -0,0 +1,161 @@
+import { Logger } from '@pgpmjs/logger';
+import { getPgEnvOptions, getSpawnEnvWithPg } from 'pg-env';
+import { getPgPool } from 'pg-cache';
+import { spawn } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { QuoteUtils } from 'pgsql-deparser/utils/quote-utils';
+import { getTargetDatabase } from '../utils';
+const log = new Logger('dump');
+const dumpUsageText = `
+Dump Command:
+
+  pgpm dump [options]
+
+  Dump a postgres database to a sql file.
+
+Options:
+  --help, -h                 Show this help message
+  --db, --database <name>    Target postgres database name
+  --out <path>               Output file path
+  --database-id <id>         When set, the dump will include a prune step that keeps only this database_id after restore
+  --cwd <directory>          Working directory (default: current directory)
+
+Examples:
+  pgpm dump
+  pgpm dump --database mydb
+  pgpm dump --database mydb --out ./mydb.sql
+  pgpm dump --database mydb --database-id 00000000-0000-0000-0000-000000000000
+`;
+function nowStamp() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
+}
+async function runPgDump(args, env) {
+    await new Promise((resolve, reject) => {
+        const child = spawn('pg_dump', args, {
+            env,
+            stdio: 'inherit',
+            shell: false
+        });
+        child.on('error', (err) => {
+            if (err.code === 'ENOENT') {
+                log.error('pg_dump not found; ensure PostgreSQL client tools are installed and in PATH');
+            }
+            reject(err);
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`pg_dump exited with code ${code ?? 1}`));
+        });
+    });
+}
+async function resolveDatabaseId(dbname, databaseIdRaw) {
+    const pool = getPgPool(getPgEnvOptions({ database: dbname }));
+    const res = await pool.query(`select id, name from metaschema_public.database order by name`);
+    const byId = res.rows.find((r) => String(r.id) === databaseIdRaw);
+    if (byId)
+        return { id: String(byId.id), name: String(byId.name) };
+    const byName = res.rows.find((r) => String(r.name) === databaseIdRaw);
+    if (byName)
+        return { id: String(byName.id), name: String(byName.name) };
+    return null;
+}
+async function buildPruneSql(dbname, databaseId) {
+    const pool = getPgPool(getPgEnvOptions({ database: dbname }));
+    const tables = await pool.query(`
+    select c.table_schema, c.table_name
+    from information_schema.columns c
+    join information_schema.tables t
+      on t.table_schema = c.table_schema
+      and t.table_name = c.table_name
+    where c.column_name = 'database_id'
+      and t.table_type = 'BASE TABLE'
+      and c.table_schema not in ('pg_catalog', 'information_schema')
+    order by c.table_schema, c.table_name
+  `);
+    const lines = [];
+    lines.push('');
+    lines.push('-- pgpm dump prune');
+    lines.push('-- this section keeps only one database_id after restore');
+    lines.push('do $$ begin');
+    lines.push(`  raise notice 'pruning data to database_id ${databaseId}';`);
+    lines.push('end $$;');
+    lines.push('set session_replication_role = replica;');
+    for (const row of tables.rows) {
+        const schema = String(row.table_schema);
+        const table = String(row.table_name);
+        // Use QuoteUtils for robust identifier quoting
+        const qualified = QuoteUtils.quoteQualifiedIdentifier(schema, table);
+        // Use formatEString to safely escape the UUID/string literal
+        const dbIdLiteral = QuoteUtils.formatEString(databaseId);
+        lines.push(`delete from ${qualified} where database_id <> ${dbIdLiteral};`);
+    }
+    // Handle metaschema_public.database deletion
+    const metaschemaDb = QuoteUtils.quoteQualifiedIdentifier('metaschema_public', 'database');
+    const dbIdLiteral = QuoteUtils.formatEString(databaseId);
+    lines.push(`delete from ${metaschemaDb} where id <> ${dbIdLiteral};`);
+    lines.push('set session_replication_role = origin;');
+    lines.push('do $$ begin');
+    lines.push(`  raise notice 'prune done';`);
+    lines.push('end $$;');
+    lines.push('');
+    return lines.join('\n');
+}
+// Helper to retrieve argument from parsed argv or positional _ array
+function getArg(argv, key) {
+    if (argv[key])
+        return argv[key];
+    const args = argv._ || [];
+    const idx = args.indexOf(`--${key}`);
+    if (idx > -1 && args.length > idx + 1) {
+        return args[idx + 1];
+    }
+    return undefined;
+}
+export default async (argv, prompter, _options) => {
+    if (argv.help || argv.h) {
+        console.log(dumpUsageText);
+        process.exit(0);
+    }
+    const cwd = argv.cwd || process.cwd();
+    const dbname = await getTargetDatabase(argv, prompter, { message: 'Select database' });
+    const outPath = path.resolve(cwd, argv.out || `pgpm-dump-${dbname}-${nowStamp()}.sql`);
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    let databaseIdInfo = null;
+    const databaseIdRaw = getArg(argv, 'database-id');
+    if (databaseIdRaw) {
+        databaseIdInfo = await resolveDatabaseId(dbname, databaseIdRaw);
+        if (!databaseIdInfo) {
+            throw new Error(`unknown database-id ${databaseIdRaw}`);
+        }
+    }
+    log.info(`dumping database ${dbname}`);
+    log.info(`writing to ${outPath}`);
+    if (databaseIdInfo) {
+        log.info(`database id ${databaseIdInfo.id}`);
+    }
+    const pgEnv = getPgEnvOptions({ database: dbname });
+    const spawnEnv = getSpawnEnvWithPg(pgEnv);
+    const args = [
+        '--format=plain',
+        '--no-owner',
+        '--no-privileges',
+        '--file',
+        outPath,
+        dbname
+    ];
+    await runPgDump(args, spawnEnv);
+    if (databaseIdInfo) {
+        const pruneSql = await buildPruneSql(dbname, databaseIdInfo.id);
+        // Use writeFileSync with 'a' flag for explicit append as requested
+        fs.writeFileSync(outPath, pruneSql, { encoding: 'utf8', flag: 'a' });
+        log.info('added prune section to dump file');
+    }
+    log.success('dump complete');
+    return argv;
+};

package/esm/commands.js

@@ -8,6 +8,7 @@ import cache from './commands/cache';
 import clear from './commands/clear';
 import deploy from './commands/deploy';
 import docker from './commands/docker';
+import dump from './commands/dump';
 import env from './commands/env';
 import _export from './commands/export';
 import extension from './commands/extension';
@@ -44,6 +45,7 @@ export const createPgpmCommandMap = (skipPgTeardown = false) => {
         clear: pgt(clear),
         deploy: pgt(deploy),
         docker,
+        dump: pgt(dump),
         env,
         verify: pgt(verify),
         revert: pgt(revert),

package/esm/index.js

@@ -10,6 +10,7 @@ export { default as analyze } from './commands/analyze';
 export { default as clear } from './commands/clear';
 export { default as deploy } from './commands/deploy';
 export { default as docker } from './commands/docker';
+export { default as dump } from './commands/dump';
 export { default as env } from './commands/env';
 export { default as _export } from './commands/export';
 export { default as extension } from './commands/extension';

package/esm/utils/display.js

@@ -18,6 +18,7 @@ export const usageText = `
     upgrade            Upgrade installed pgpm modules to latest versions (alias: up)
 
   Database Administration:
+    dump               Dump a database to a sql file
     kill               Terminate database connections and optionally drop databases
     install            Install database modules
     tag                Add tags to changes for versioning

package/index.d.ts

@@ -9,6 +9,7 @@ export { default as analyze } from './commands/analyze';
 export { default as clear } from './commands/clear';
 export { default as deploy } from './commands/deploy';
 export { default as docker } from './commands/docker';
+export { default as dump } from './commands/dump';
 export { default as env } from './commands/env';
 export { default as _export } from './commands/export';
 export { default as extension } from './commands/extension';

package/index.js

@@ -18,7 +18,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.options = exports.verify = exports.testPackages = exports.tag = exports.revert = exports.renameCmd = exports.remove = exports.plan = exports._package = exports.migrate = exports.kill = exports.install = exports.extension = exports._export = exports.env = exports.docker = exports.deploy = exports.clear = exports.analyze = exports.adminUsers = exports.add = exports.createPgpmCommandMap = exports.createInitUsageText = void 0;
+exports.options = exports.verify = exports.testPackages = exports.tag = exports.revert = exports.renameCmd = exports.remove = exports.plan = exports._package = exports.migrate = exports.kill = exports.install = exports.extension = exports._export = exports.env = exports.dump = exports.docker = exports.deploy = exports.clear = exports.analyze = exports.adminUsers = exports.add = exports.createPgpmCommandMap = exports.createInitUsageText = void 0;
 const find_and_require_package_json_1 = require("find-and-require-package-json");
 const inquirerer_1 = require("inquirerer");
 const commands_1 = require("./commands");
@@ -37,6 +37,8 @@ var deploy_1 = require("./commands/deploy");
 Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return __importDefault(deploy_1).default; } });
 var docker_1 = require("./commands/docker");
 Object.defineProperty(exports, "docker", { enumerable: true, get: function () { return __importDefault(docker_1).default; } });
+var dump_1 = require("./commands/dump");
+Object.defineProperty(exports, "dump", { enumerable: true, get: function () { return __importDefault(dump_1).default; } });
 var env_1 = require("./commands/env");
 Object.defineProperty(exports, "env", { enumerable: true, get: function () { return __importDefault(env_1).default; } });
 var export_1 = require("./commands/export");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "2.10.0",
+  "version": "2.10.2",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -33,7 +33,7 @@
     "test:watch": "jest --watch"
   },
   "devDependencies": {
-    "@inquirerer/test": "^1.2.3",
+    "@inquirerer/test": "^1.2.5",
     "@types/js-yaml": "^4.0.9",
     "@types/minimist": "^1.2.5",
     "@types/node": "^20.12.7",
@@ -46,19 +46,20 @@
     "ts-node": "^10.9.2"
   },
   "dependencies": {
-    "@inquirerer/utils": "^3.1.2",
-    "@pgpmjs/core": "^4.10.0",
+    "@inquirerer/utils": "^3.1.3",
+    "@pgpmjs/core": "^4.11.0",
     "@pgpmjs/env": "^2.9.3",
     "@pgpmjs/logger": "^1.3.7",
     "@pgpmjs/types": "^2.14.0",
-    "appstash": "^0.2.7",
-    "find-and-require-package-json": "^0.8.5",
-    "genomic": "^5.2.0",
-    "inquirerer": "^4.2.0",
+    "appstash": "^0.2.8",
+    "find-and-require-package-json": "^0.8.6",
+    "genomic": "^5.2.3",
+    "inquirerer": "^4.3.1",
     "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
     "pg-cache": "^1.6.14",
     "pg-env": "^1.2.5",
+    "pgsql-deparser": "^17.17.2",
     "semver": "^7.6.2",
     "shelljs": "^0.10.0",
     "yanse": "^0.1.11"
@@ -75,5 +76,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "ba5bbacf7ccc1980cba10bf3f45ebb0ca639fb79"
+  "gitHead": "7c9b2f2b7a2a56a941aafe62cc7f2b4a90afa1bc"
 }

package/utils/display.d.ts

@@ -1 +1 @@
-export declare const usageText = "\n  Usage: pgpm <command> [options]\n\n  Core Database Operations:\n    add                Add database changes to plans and create SQL files\n    deploy             Deploy database changes and migrations\n    verify             Verify database state and migrations\n    revert             Revert database changes and migrations\n\n  Project Management:\n    init               Initialize workspace or module\n    extension          Manage module dependencies\n    plan               Generate module deployment plans\n    package            Package module for distribution\n    export             Export database migrations from existing databases\n    update             Update pgpm to the latest version\n    cache              Manage cached templates (clean)\n    upgrade            Upgrade installed pgpm modules to latest versions (alias: up)\n\n  Database Administration:\n    kill               Terminate database connections and optionally drop databases\n    install            Install database modules\n    tag                Add tags to changes for versioning\n    clear              Clear database state\n    remove             Remove database changes\n    analyze            Analyze database structure\n    rename             Rename database changes\n    admin-users        Manage admin users\n\n  Testing:\n    test-packages      Run integration tests on all workspace packages\n\n  Migration Tools:\n    migrate            Migration management subcommands\n      init             Initialize migration tracking\n      status           Show migration status\n      list             List all changes\n      deps             Show change dependencies\n  \n  Development Tools:\n    docker             Manage PostgreSQL Docker containers (start/stop)\n    env                Manage PostgreSQL environment variables\n    test-packages      Run integration tests on workspace packages\n  \n  Global Options:\n    -h, --help         Display this help information\n    -v, --version      Display version information\n    --cwd <directory>  Working directory (default: current directory)\n\n  Individual Command Help:\n    pgpm <command> --help    Display detailed help for specific command\n    pgpm <command> -h        Display detailed help for specific command\n\n  Examples:\n    pgpm deploy --help       Show deploy command options\n    pgpm init workspace      Initialize new workspace\n    pgpm install @pgpm/base32  Install a database module\n  ";
+export declare const usageText = "\n  Usage: pgpm <command> [options]\n\n  Core Database Operations:\n    add                Add database changes to plans and create SQL files\n    deploy             Deploy database changes and migrations\n    verify             Verify database state and migrations\n    revert             Revert database changes and migrations\n\n  Project Management:\n    init               Initialize workspace or module\n    extension          Manage module dependencies\n    plan               Generate module deployment plans\n    package            Package module for distribution\n    export             Export database migrations from existing databases\n    update             Update pgpm to the latest version\n    cache              Manage cached templates (clean)\n    upgrade            Upgrade installed pgpm modules to latest versions (alias: up)\n\n  Database Administration:\n    dump               Dump a database to a sql file\n    kill               Terminate database connections and optionally drop databases\n    install            Install database modules\n    tag                Add tags to changes for versioning\n    clear              Clear database state\n    remove             Remove database changes\n    analyze            Analyze database structure\n    rename             Rename database changes\n    admin-users        Manage admin users\n\n  Testing:\n    test-packages      Run integration tests on all workspace packages\n\n  Migration Tools:\n    migrate            Migration management subcommands\n      init             Initialize migration tracking\n      status           Show migration status\n      list             List all changes\n      deps             Show change dependencies\n  \n  Development Tools:\n    docker             Manage PostgreSQL Docker containers (start/stop)\n    env                Manage PostgreSQL environment variables\n    test-packages      Run integration tests on workspace packages\n  \n  Global Options:\n    -h, --help         Display this help information\n    -v, --version      Display version information\n    --cwd <directory>  Working directory (default: current directory)\n\n  Individual Command Help:\n    pgpm <command> --help    Display detailed help for specific command\n    pgpm <command> -h        Display detailed help for specific command\n\n  Examples:\n    pgpm deploy --help       Show deploy command options\n    pgpm init workspace      Initialize new workspace\n    pgpm install @pgpm/base32  Install a database module\n  ";

package/utils/display.js

@@ -21,6 +21,7 @@ exports.usageText = `
     upgrade            Upgrade installed pgpm modules to latest versions (alias: up)
 
   Database Administration:
+    dump               Dump a database to a sql file
     kill               Terminate database connections and optionally drop databases
     install            Install database modules
     tag                Add tags to changes for versioning