pgpm 5.17.4 → 5.18.0

package/commands/export.js

@@ -25,11 +25,17 @@ Options:
   --metaExtensionName <name>  Meta extension name (default: svc)
   --exclude-categories <list>  Comma-separated sql_actions categories to omit
                           (e.g. security,permissions,auth,memberships). Works in SQL and GraphQL modes.
+  --granularity <level>   Restructure the exported database module through the
+                          dials pipeline: atomic | object | consolidated.
+                          Change paths are derived from the naming spec and
+                          requires from the statement graph. When omitted,
+                          sql_actions rows are exported unchanged.
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
   pgpm export              Export migrations from selected database (SQL mode)
   pgpm export --exclude-categories security,permissions,auth,memberships
+  pgpm export --granularity consolidated
   pgpm export --graphql-endpoint 'http://[::1]:3002/graphql' --migrate-endpoint 'http://[::1]:3000/graphql' --migrate-host db_migrate.localhost:3000
 `;
 exports.default = async (argv, prompter, _options) => {
@@ -54,6 +60,13 @@ exports.default = async (argv, prompter, _options) => {
         : Array.isArray(excludeCategoriesRaw)
             ? excludeCategoriesRaw
             : undefined;
+    const granularityRaw = argv.granularity;
+    if (granularityRaw !== undefined && !(0, export_1.isExportGranularity)(granularityRaw)) {
+        console.error(`Invalid --granularity "${granularityRaw}". Expected one of: ${export_1.EXPORT_GRANULARITIES.join(', ')}.`);
+        prompter.close();
+        return;
+    }
+    const granularity = granularityRaw;
     if (graphqlEndpoint) {
         // =========================================================================
         // GraphQL export mode
@@ -150,7 +163,8 @@ exports.default = async (argv, prompter, _options) => {
             prompter,
             argv,
             username,
-            excludeCategories
+            excludeCategories,
+            granularity
         });
     }
     else {
@@ -270,7 +284,8 @@ exports.default = async (argv, prompter, _options) => {
             prompter,
             argv,
             username,
-            excludeCategories
+            excludeCategories,
+            granularity
         });
     }
     prompter.close();

package/commands/package.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@pgpmjs/core");
+const logger_1 = require("@pgpmjs/logger");
+const log = new logger_1.Logger('package');
 const packageUsageText = `
 Package Command:
 
@@ -17,11 +19,23 @@ Options:
   --bundle                        Also emit sql/<name>--<version>.bundle.tar.gz (default: true)
   --cwd <directory>               Working directory (default: current directory)
 
+Check mode (no writes — verify committed artifacts are in sync with deploy/):
+  --check                         Verify committed sql/<name>--<version>.bundle.tar.gz
+                                  matches deploy/ for changed modules; exit 1 on drift
+  --since <ref>                   Git branch/ref/tag to diff HEAD against for change
+                                  detection (default: PR base in CI, else working tree)
+  --all                           Check every workspace module (skip change detection)
+  --dependents                    Also re-check modules that require a changed module
+  --no-fail-fast                  Report all drifted modules instead of stopping at the first
+
 Examples:
   pgpm package                     Package with defaults
   pgpm package --no-plan           Package without plan
   pgpm package --outputDiff        Package and export AST diff files if mismatch detected
   pgpm package --no-bundle         Package without emitting the bundle artifact
+  pgpm package --check             Verify changed modules' bundles are in sync
+  pgpm package --check --since origin/main   Verify modules changed vs origin/main
+  pgpm package --check --all       Verify every module in the workspace
 `;
 exports.default = async (argv, prompter, _options) => {
     // Show usage if explicitly requested
@@ -29,6 +43,40 @@ exports.default = async (argv, prompter, _options) => {
         console.log(packageUsageText);
         process.exit(0);
     }
+    // Check mode: verify committed artifacts, never write.
+    if (argv.check) {
+        const result = await (0, core_1.checkPackages)({
+            cwd: argv.cwd,
+            since: typeof argv.since === 'string' ? argv.since : undefined,
+            all: argv.all === true,
+            dependents: argv.dependents === true,
+            failFast: argv.failFast !== false,
+        });
+        if (argv.all) {
+            log.info(`Checking all ${result.targeted.length} workspace module(s)`);
+        }
+        else {
+            log.info(`Change detection${result.base ? ` vs ${result.base}` : ' (working tree)'}: ` +
+                `${result.changedModules.length} changed module(s)` +
+                (result.targeted.length !== result.changedModules.length
+                    ? ` (${result.targeted.length} incl. dependents)`
+                    : ''));
+        }
+        if (result.drifted.length) {
+            for (const drift of result.drifted) {
+                log.error(`✖ ${drift.name}: ${drift.detail}`);
+            }
+            log.error(`${result.drifted.length} module(s) out of sync. Run \`pgpm package\` in each and commit the artifacts.`);
+            process.exit(1);
+        }
+        if (result.checked.length === 0) {
+            log.success('No changed modules to check.');
+        }
+        else {
+            log.success(`${result.checked.length} module(s) in sync.`);
+        }
+        return argv;
+    }
     const questions = [
         {
             type: 'confirm',

package/esm/commands/export.js

@@ -1,5 +1,5 @@
 import { PgpmPackage } from '@pgpmjs/core';
-import { exportMigrations, exportGraphQL, GraphQLClient, graphqlRowToPostgresRow } from '@pgpmjs/export';
+import { exportMigrations, exportGraphQL, GraphQLClient, graphqlRowToPostgresRow, isExportGranularity, EXPORT_GRANULARITIES } from '@pgpmjs/export';
 import { getEnvOptions } from '@pgpmjs/env';
 import { getGitConfigInfo } from '@pgpmjs/types';
 import { resolve } from 'path';
@@ -23,11 +23,17 @@ Options:
   --metaExtensionName <name>  Meta extension name (default: svc)
   --exclude-categories <list>  Comma-separated sql_actions categories to omit
                           (e.g. security,permissions,auth,memberships). Works in SQL and GraphQL modes.
+  --granularity <level>   Restructure the exported database module through the
+                          dials pipeline: atomic | object | consolidated.
+                          Change paths are derived from the naming spec and
+                          requires from the statement graph. When omitted,
+                          sql_actions rows are exported unchanged.
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
   pgpm export              Export migrations from selected database (SQL mode)
   pgpm export --exclude-categories security,permissions,auth,memberships
+  pgpm export --granularity consolidated
   pgpm export --graphql-endpoint 'http://[::1]:3002/graphql' --migrate-endpoint 'http://[::1]:3000/graphql' --migrate-host db_migrate.localhost:3000
 `;
 export default async (argv, prompter, _options) => {
@@ -52,6 +58,13 @@ export default async (argv, prompter, _options) => {
         : Array.isArray(excludeCategoriesRaw)
             ? excludeCategoriesRaw
             : undefined;
+    const granularityRaw = argv.granularity;
+    if (granularityRaw !== undefined && !isExportGranularity(granularityRaw)) {
+        console.error(`Invalid --granularity "${granularityRaw}". Expected one of: ${EXPORT_GRANULARITIES.join(', ')}.`);
+        prompter.close();
+        return;
+    }
+    const granularity = granularityRaw;
     if (graphqlEndpoint) {
         // =========================================================================
         // GraphQL export mode
@@ -148,7 +161,8 @@ export default async (argv, prompter, _options) => {
             prompter,
             argv,
             username,
-            excludeCategories
+            excludeCategories,
+            granularity
         });
     }
     else {
@@ -268,7 +282,8 @@ export default async (argv, prompter, _options) => {
             prompter,
             argv,
             username,
-            excludeCategories
+            excludeCategories,
+            granularity
         });
     }
     prompter.close();

package/esm/commands/package.js

@@ -1,4 +1,6 @@
-import { PgpmPackage, writePackage } from '@pgpmjs/core';
+import { checkPackages, PgpmPackage, writePackage } from '@pgpmjs/core';
+import { Logger } from '@pgpmjs/logger';
+const log = new Logger('package');
 const packageUsageText = `
 Package Command:
 
@@ -15,11 +17,23 @@ Options:
   --bundle                        Also emit sql/<name>--<version>.bundle.tar.gz (default: true)
   --cwd <directory>               Working directory (default: current directory)
 
+Check mode (no writes — verify committed artifacts are in sync with deploy/):
+  --check                         Verify committed sql/<name>--<version>.bundle.tar.gz
+                                  matches deploy/ for changed modules; exit 1 on drift
+  --since <ref>                   Git branch/ref/tag to diff HEAD against for change
+                                  detection (default: PR base in CI, else working tree)
+  --all                           Check every workspace module (skip change detection)
+  --dependents                    Also re-check modules that require a changed module
+  --no-fail-fast                  Report all drifted modules instead of stopping at the first
+
 Examples:
   pgpm package                     Package with defaults
   pgpm package --no-plan           Package without plan
   pgpm package --outputDiff        Package and export AST diff files if mismatch detected
   pgpm package --no-bundle         Package without emitting the bundle artifact
+  pgpm package --check             Verify changed modules' bundles are in sync
+  pgpm package --check --since origin/main   Verify modules changed vs origin/main
+  pgpm package --check --all       Verify every module in the workspace
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested
@@ -27,6 +41,40 @@ export default async (argv, prompter, _options) => {
         console.log(packageUsageText);
         process.exit(0);
     }
+    // Check mode: verify committed artifacts, never write.
+    if (argv.check) {
+        const result = await checkPackages({
+            cwd: argv.cwd,
+            since: typeof argv.since === 'string' ? argv.since : undefined,
+            all: argv.all === true,
+            dependents: argv.dependents === true,
+            failFast: argv.failFast !== false,
+        });
+        if (argv.all) {
+            log.info(`Checking all ${result.targeted.length} workspace module(s)`);
+        }
+        else {
+            log.info(`Change detection${result.base ? ` vs ${result.base}` : ' (working tree)'}: ` +
+                `${result.changedModules.length} changed module(s)` +
+                (result.targeted.length !== result.changedModules.length
+                    ? ` (${result.targeted.length} incl. dependents)`
+                    : ''));
+        }
+        if (result.drifted.length) {
+            for (const drift of result.drifted) {
+                log.error(`✖ ${drift.name}: ${drift.detail}`);
+            }
+            log.error(`${result.drifted.length} module(s) out of sync. Run \`pgpm package\` in each and commit the artifacts.`);
+            process.exit(1);
+        }
+        if (result.checked.length === 0) {
+            log.success('No changed modules to check.');
+        }
+        else {
+            log.success(`${result.checked.length} module(s) in sync.`);
+        }
+        return argv;
+    }
     const questions = [
         {
             type: 'confirm',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "5.17.4",
+  "version": "5.18.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -46,11 +46,11 @@
   },
   "dependencies": {
     "@inquirerer/utils": "^3.3.9",
-    "@pgpmjs/core": "^7.20.4",
+    "@pgpmjs/core": "^7.21.0",
     "@pgpmjs/env": "^2.40.2",
-    "@pgpmjs/export": "^1.13.4",
+    "@pgpmjs/export": "^1.14.0",
     "@pgpmjs/logger": "^2.23.2",
-    "@pgpmjs/slice": "^0.13.4",
+    "@pgpmjs/slice": "^0.13.5",
     "@pgpmjs/types": "^2.49.2",
     "@pgsql/quotes": "^18.1.0",
     "appstash": "^0.7.0",
@@ -77,5 +77,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "90f447482b056a4949134565db2665f21d11aca3"
+  "gitHead": "7a37da1f5655c36813343f09c6efa62ca0d7a855"
 }