pgpm 5.7.0 → 5.8.0

package/commands/sync-versions.d.ts

@@ -0,0 +1,3 @@
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, any>>, _prompter: Inquirerer, _options: CLIOptions) => Promise<Partial<Record<string, any>>>;
+export default _default;

package/commands/sync-versions.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@pgpmjs/core");
+const syncVersionsUsageText = `
+Sync Versions Command:
+
+  pgpm sync-versions [OPTIONS]
+
+  Sync extension metadata (.control default_version, Makefile sql filename,
+  and the sql/<name>--<version>.sql bundle) to each module's package.json
+  version. Inside a module, syncs just that module; at a workspace root,
+  syncs every workspace module.
+
+Options:
+  --help, -h                      Show this help message
+  --check                         Report version skew without writing; exits non-zero if skewed
+  --cwd <directory>               Working directory (default: current directory)
+
+Examples:
+  pgpm sync-versions               Sync all out-of-sync modules
+  pgpm sync-versions --check       Fail if any module's metadata is out of sync (for CI)
+`;
+exports.default = async (argv, _prompter, _options) => {
+    // Show usage if explicitly requested
+    if (argv.help || argv.h) {
+        console.log(syncVersionsUsageText);
+        process.exit(0);
+    }
+    const cwd = argv.cwd ?? process.cwd();
+    const check = Boolean(argv.check);
+    const project = new core_1.PgpmPackage(cwd);
+    const result = await project.syncVersions({ check });
+    if (check) {
+        if (result.skewed.length > 0) {
+            console.log(`${result.skewed.length} module(s) out of sync:`);
+            for (const status of result.skewed) {
+                console.log(`  ${status.name}: package.json ${status.packageVersion} != control ${status.controlVersion}` +
+                    (status.sqlFileExists ? '' : ` (missing sql/${status.name}--${status.packageVersion}.sql)`));
+            }
+            process.exit(1);
+        }
+        console.log(`All ${result.ok.length} module(s) in sync.`);
+        return argv;
+    }
+    if (result.synced.length === 0) {
+        console.log(`All ${result.ok.length} module(s) already in sync.`);
+    }
+    else {
+        console.log(`Synced ${result.synced.length} module(s); ${result.ok.length} already in sync.`);
+    }
+    return argv;
+};

package/commands.js

@@ -29,6 +29,7 @@ const remove_1 = __importDefault(require("./commands/remove"));
 const rename_1 = __importDefault(require("./commands/rename"));
 const revert_1 = __importDefault(require("./commands/revert"));
 const slice_1 = __importDefault(require("./commands/slice"));
+const sync_versions_1 = __importDefault(require("./commands/sync-versions"));
 const tag_1 = __importDefault(require("./commands/tag"));
 const test_packages_1 = __importDefault(require("./commands/test-packages"));
 const tune_1 = __importDefault(require("./commands/tune"));
@@ -72,6 +73,7 @@ const createPgpmCommandMap = (skipPgTeardown = false) => {
         analyze: pgt(analyze_1.default),
         rename: pgt(rename_1.default),
         slice: slice_1.default,
+        'sync-versions': sync_versions_1.default,
         'test-packages': pgt(test_packages_1.default),
         tune: pgt(tune_1.default),
         upgrade: pgt(upgrade_1.default),

package/esm/commands/sync-versions.js

@@ -0,0 +1,50 @@
+import { PgpmPackage } from '@pgpmjs/core';
+const syncVersionsUsageText = `
+Sync Versions Command:
+
+  pgpm sync-versions [OPTIONS]
+
+  Sync extension metadata (.control default_version, Makefile sql filename,
+  and the sql/<name>--<version>.sql bundle) to each module's package.json
+  version. Inside a module, syncs just that module; at a workspace root,
+  syncs every workspace module.
+
+Options:
+  --help, -h                      Show this help message
+  --check                         Report version skew without writing; exits non-zero if skewed
+  --cwd <directory>               Working directory (default: current directory)
+
+Examples:
+  pgpm sync-versions               Sync all out-of-sync modules
+  pgpm sync-versions --check       Fail if any module's metadata is out of sync (for CI)
+`;
+export default async (argv, _prompter, _options) => {
+    // Show usage if explicitly requested
+    if (argv.help || argv.h) {
+        console.log(syncVersionsUsageText);
+        process.exit(0);
+    }
+    const cwd = argv.cwd ?? process.cwd();
+    const check = Boolean(argv.check);
+    const project = new PgpmPackage(cwd);
+    const result = await project.syncVersions({ check });
+    if (check) {
+        if (result.skewed.length > 0) {
+            console.log(`${result.skewed.length} module(s) out of sync:`);
+            for (const status of result.skewed) {
+                console.log(`  ${status.name}: package.json ${status.packageVersion} != control ${status.controlVersion}` +
+                    (status.sqlFileExists ? '' : ` (missing sql/${status.name}--${status.packageVersion}.sql)`));
+            }
+            process.exit(1);
+        }
+        console.log(`All ${result.ok.length} module(s) in sync.`);
+        return argv;
+    }
+    if (result.synced.length === 0) {
+        console.log(`All ${result.ok.length} module(s) already in sync.`);
+    }
+    else {
+        console.log(`Synced ${result.synced.length} module(s); ${result.ok.length} already in sync.`);
+    }
+    return argv;
+};

package/esm/commands.js

@@ -23,6 +23,7 @@ import remove from './commands/remove';
 import renameCmd from './commands/rename';
 import revert from './commands/revert';
 import slice from './commands/slice';
+import syncVersions from './commands/sync-versions';
 import tag from './commands/tag';
 import testPackages from './commands/test-packages';
 import tune from './commands/tune';
@@ -66,6 +67,7 @@ export const createPgpmCommandMap = (skipPgTeardown = false) => {
         analyze: pgt(analyze),
         rename: pgt(renameCmd),
         slice,
+        'sync-versions': syncVersions,
         'test-packages': pgt(testPackages),
         tune: pgt(tune),
         upgrade: pgt(upgrade),

package/esm/utils/display.js

@@ -12,6 +12,7 @@ export const usageText = `
     extension          Manage module dependencies
     plan               Generate module deployment plans
     package            Package module for distribution
+    sync-versions      Sync .control/Makefile/sql metadata to package.json versions
     export             Export database migrations from existing databases
     update             Update pgpm to the latest version
     cache              Manage cached templates (clean)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "5.7.0",
+  "version": "5.8.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -46,9 +46,9 @@
   },
   "dependencies": {
     "@inquirerer/utils": "^3.3.9",
-    "@pgpmjs/core": "^7.8.0",
+    "@pgpmjs/core": "^7.9.0",
     "@pgpmjs/env": "^2.33.0",
-    "@pgpmjs/export": "^1.8.0",
+    "@pgpmjs/export": "^1.8.1",
     "@pgpmjs/logger": "^2.18.0",
     "@pgpmjs/slice": "^0.5.0",
     "@pgpmjs/types": "^2.40.0",
@@ -77,5 +77,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "73f55ad24d9a92e7ef1e268526b31bfb7bb12b28"
+  "gitHead": "f36bcdd2b5dada626955e9e05b19c80ca9f92ed5"
 }

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    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    tune               Tune PostgreSQL for throwaway environments (CI/test)\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 Docker containers (start/stop/ls, --minio)\n    doctor             Check local dependencies (node, docker, psql) with install guidance\n    env                Manage environment variables (--supabase, --minio)\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    sync-versions      Sync .control/Makefile/sql metadata to package.json versions\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    tune               Tune PostgreSQL for throwaway environments (CI/test)\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 Docker containers (start/stop/ls, --minio)\n    doctor             Check local dependencies (node, docker, psql) with install guidance\n    env                Manage environment variables (--supabase, --minio)\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

@@ -15,6 +15,7 @@ exports.usageText = `
     extension          Manage module dependencies
     plan               Generate module deployment plans
     package            Package module for distribution
+    sync-versions      Sync .control/Makefile/sql metadata to package.json versions
     export             Export database migrations from existing databases
     update             Update pgpm to the latest version
     cache              Manage cached templates (clean)