@constructive-io/cli 5.1.13 → 5.1.15

package/README.md

@@ -98,6 +98,9 @@ cnc server
 
 # Custom port and options
 cnc server --port 8080 --no-postgis
+
+# With custom CORS origin
+cnc server --origin http://localhost:3000
 ```
 
 #### `cnc explorer`
@@ -112,6 +115,33 @@ cnc explorer
 cnc explorer --origin http://localhost:3000
 ```
 
+#### `cnc docker`
+
+Manage PostgreSQL Docker containers for local development.
+
+```bash
+# Start PostgreSQL container
+cnc docker start
+
+# Stop PostgreSQL container
+cnc docker stop
+```
+
+#### `cnc env`
+
+Display environment configuration for PostgreSQL connection.
+
+```bash
+# Print environment variables for shell export
+cnc env
+
+# Use with eval to set environment
+eval "$(cnc env)"
+
+# Print Supabase local development environment
+cnc env --supabase
+```
+
 ## 🔄 Updates
 
 The CLI performs a lightweight npm version check at most once per week (skipped in CI or when `PGPM_SKIP_UPDATE_CHECK` is set). Use `cnc update` to install the latest release (installs `pgpm` by default; pass `--package @constructive-io/cli` to target the CLI package).
@@ -202,6 +232,35 @@ Interactively manage module dependencies.
 cnc extension
 ```
 
+#### `cnc upgrade-modules`
+
+Upgrade installed pgpm modules to their latest versions from npm.
+
+```bash
+# Interactive selection of modules to upgrade
+cnc upgrade-modules
+
+# Upgrade all installed modules without prompting
+cnc upgrade-modules --all
+
+# Preview available upgrades without making changes
+cnc upgrade-modules --dry-run
+
+# Upgrade specific modules
+cnc upgrade-modules --modules @pgpm/base32,@pgpm/faker
+
+# Upgrade modules across all packages in the workspace
+cnc upgrade-modules --workspace --all
+```
+
+**Options:**
+
+- `--all` - Upgrade all modules without prompting
+- `--dry-run` - Show what would be upgraded without making changes
+- `--modules <names>` - Comma-separated list of specific modules to upgrade
+- `--workspace` - Upgrade modules across all packages in the workspace
+- `--cwd <directory>` - Working directory (default: current directory)
+
 #### `cnc tag`
 
 Version your changes with tags.
@@ -241,6 +300,18 @@ cnc package --no-plan
 
 ### Utilities
 
+#### `cnc add`
+
+Add a new database change to your module.
+
+```bash
+# Add a new change
+cnc add my_change
+
+# Add with specific type
+cnc add my_function --type function
+```
+
 #### `cnc export`
 
 Export migrations from existing databases.
@@ -261,6 +332,53 @@ cnc kill
 cnc kill --no-drop
 ```
 
+#### `cnc clear`
+
+Clear database state.
+
+```bash
+cnc clear
+```
+
+#### `cnc remove`
+
+Remove database changes.
+
+```bash
+cnc remove my_change
+```
+
+#### `cnc analyze`
+
+Analyze database structure.
+
+```bash
+cnc analyze
+```
+
+#### `cnc rename`
+
+Rename database changes.
+
+```bash
+cnc rename old_name new_name
+```
+
+#### `cnc admin-users`
+
+Manage admin users for your database.
+
+```bash
+# Bootstrap admin users
+cnc admin-users bootstrap
+
+# Add an admin user
+cnc admin-users add
+
+# Remove an admin user
+cnc admin-users remove
+```
+
 ### Testing
 
 #### `cnc test-packages`
@@ -274,20 +392,20 @@ cnc test-packages
 # Run full deploy/verify/revert/deploy cycle
 cnc test-packages --full-cycle
 
-# Stop on first failure
-cnc test-packages --stop-on-fail
+# Continue testing all packages even after failures
+cnc test-packages --continue-on-fail
 
 # Exclude specific modules
 cnc test-packages --exclude my-module,another-module
 
 # Combine options
-cnc test-packages --full-cycle --stop-on-fail --exclude legacy-module
+cnc test-packages --full-cycle --continue-on-fail --exclude legacy-module
 ```
 
 **Options:**
 
 - `--full-cycle` - Run full deploy/verify/revert/deploy cycle (default: deploy only)
-- `--stop-on-fail` - Stop testing immediately when a module fails
+- `--continue-on-fail` - Continue testing all packages even after failures (default: stop on first failure)
 - `--exclude <modules>` - Comma-separated module names to exclude
 - `--cwd <directory>` - Working directory (default: current directory)
 
@@ -545,7 +663,6 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 * [@pgsql/enums](https://www.npmjs.com/package/@pgsql/enums): **🏷️ TypeScript enums** for PostgreSQL AST for safe and ergonomic parsing logic.
 * [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
 * [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
-* [pg-ast](https://www.npmjs.com/package/pg-ast): **🔍 Low-level AST tools** and transformations for Postgres query structures.
 
 ### 🚀 API & Dev Tools
 

package/commands/server.js

@@ -15,6 +15,7 @@ Constructive GraphQL Server:
 Options:
   --help, -h              Show this help message
   --port <number>         Server port (default: 5555)
+  --origin <url>          CORS origin URL (exact URL or * for wildcard)
   --simpleInflection      Use simple inflection (default: true)
   --oppositeBaseNames     Use opposite base names (default: false)
   --postgis               Enable PostGIS extension (default: true)
@@ -25,6 +26,7 @@ Examples:
   cnc server                    Start server with defaults
   cnc server --port 8080        Start server on custom port
   cnc server --no-postgis       Start server without PostGIS
+  cnc server --origin http://localhost:3000  Set CORS origin
 `;
 const questions = [
     {

package/esm/commands/server.js

@@ -13,6 +13,7 @@ Constructive GraphQL Server:
 Options:
   --help, -h              Show this help message
   --port <number>         Server port (default: 5555)
+  --origin <url>          CORS origin URL (exact URL or * for wildcard)
   --simpleInflection      Use simple inflection (default: true)
   --oppositeBaseNames     Use opposite base names (default: false)
   --postgis               Enable PostGIS extension (default: true)
@@ -23,6 +24,7 @@ Examples:
   cnc server                    Start server with defaults
   cnc server --port 8080        Start server on custom port
   cnc server --no-postgis       Start server without PostGIS
+  cnc server --origin http://localhost:3000  Set CORS origin
 `;
 const questions = [
     {

package/esm/index.js

@@ -1,11 +1,9 @@
 #!/usr/bin/env node
-import { readFileSync } from 'fs';
+import { findAndRequirePackageJson } from 'find-and-require-package-json';
 import { CLI } from 'inquirerer';
-import { join } from 'path';
 import { commands } from './commands';
 if (process.argv.includes('--version') || process.argv.includes('-v')) {
-    const pkgPath = join(__dirname, 'package.json');
-    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    const pkg = findAndRequirePackageJson(__dirname);
     console.log(pkg.version);
     process.exit(0);
 }

package/esm/utils/display.js

@@ -1,21 +1,13 @@
-import { findAndRequirePackageJson } from 'find-and-require-package-json';
-import yanse from 'yanse';
-// Function to display the version information
-export function displayVersion() {
-    const pkg = findAndRequirePackageJson(__dirname);
-    console.log(yanse.green(`Name: ${pkg.name}`));
-    console.log(yanse.blue(`Version: ${pkg.version}`));
-}
 export const usageText = `
   Usage: cnc <command> [options]
          constructive <command> [options]
-  
+
   Core Database Operations:
     add                Add database changes to plans and create SQL files
     deploy             Deploy database changes and migrations
     verify             Verify database state and migrations
     revert             Revert database changes and migrations
-  
+
   Project Management:
     init               Initialize pgpm workspace or module
     extension          Manage module dependencies
@@ -23,39 +15,50 @@ export const usageText = `
     package            Package module for distribution
     update             Update CLI/pgpm (installs pgpm by default)
     cache              Manage cached templates (clean)
-  
+    upgrade-modules    Upgrade installed pgpm modules to latest versions
+
   Development Tools:
     server             Start a GraphQL server
     explorer           Launch GraphiQL explorer interface
     docker             Manage PostgreSQL Docker containers (start/stop)
     export             Export database migrations from existing databases
-  
+    env                Display environment configuration
+
+  Code Generation:
+    codegen            Generate TypeScript types and SDK from GraphQL schema
+    get-graphql-schema Fetch or build GraphQL schema SDL
+
   Database Administration:
     kill               Terminate database connections and optionally drop databases
     install            Install pgpm modules
     tag                Add tags to changes for versioning
-  
+    clear              Clear database state
+    remove             Remove database changes
+    analyze            Analyze database structure
+    rename             Rename database changes
+    admin-users        Manage admin users
+
+  Testing:
+    test-packages      Run integration tests on all workspace packages
+
   Migration Tools:
     migrate            Migration management subcommands
       init             Initialize migration tracking
       status           Show migration status
       list             List all changes
       deps             Show change dependencies
-  
+
   Global Options:
     -h, --help         Display this help information
     -v, --version      Display version information
     --cwd <directory>  Working directory (default: current directory)
-  
+
   Individual Command Help:
     constructive <command> --help    Display detailed help for specific command
     constructive <command> -h        Display detailed help for specific command
-  
+
   Examples:
     cnc deploy --help       Show deploy command options
     cnc server --port 8080  Start server on port 8080
     cnc init workspace      Initialize new workspace
   `;
-export function displayUsage() {
-    console.log(usageText);
-}

package/index.js

@@ -2,13 +2,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.options = void 0;
-const fs_1 = require("fs");
+const find_and_require_package_json_1 = require("find-and-require-package-json");
 const inquirerer_1 = require("inquirerer");
-const path_1 = require("path");
 const commands_1 = require("./commands");
 if (process.argv.includes('--version') || process.argv.includes('-v')) {
-    const pkgPath = (0, path_1.join)(__dirname, 'package.json');
-    const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf8'));
+    const pkg = (0, find_and_require_package_json_1.findAndRequirePackageJson)(__dirname);
     console.log(pkg.version);
     process.exit(0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/cli",
-  "version": "5.1.13",
+  "version": "5.1.15",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive CLI",
   "main": "index.js",
@@ -46,21 +46,21 @@
     "ts-node": "^10.9.2"
   },
   "dependencies": {
-    "@constructive-io/graphql-codegen": "^2.17.22",
+    "@constructive-io/graphql-codegen": "^2.17.23",
     "@constructive-io/graphql-env": "^2.8.8",
-    "@constructive-io/graphql-explorer": "^2.10.16",
-    "@constructive-io/graphql-server": "^2.10.16",
-    "@pgpmjs/core": "^3.2.0",
+    "@constructive-io/graphql-explorer": "^2.10.17",
+    "@constructive-io/graphql-server": "^2.10.17",
+    "@pgpmjs/core": "^3.2.1",
     "@pgpmjs/logger": "^1.3.5",
-    "@pgpmjs/server-utils": "^2.8.8",
+    "@pgpmjs/server-utils": "^2.8.9",
     "@pgpmjs/types": "^2.12.6",
     "find-and-require-package-json": "^0.8.2",
-    "inquirerer": "^2.2.0",
+    "inquirerer": "^2.3.0",
     "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
     "pg-cache": "^1.6.9",
     "pg-env": "^1.2.4",
-    "pgpm": "^1.2.2",
+    "pgpm": "^1.4.0",
     "shelljs": "^0.10.0",
     "yanse": "^0.1.8"
   },
@@ -75,5 +75,5 @@
     "postgres",
     "graphile"
   ],
-  "gitHead": "8eaef530cad9cfa4f905ad085d5f0475563cf856"
+  "gitHead": "976cc9e0e09201c7df40518a1797f4178fc21c2c"
 }

package/utils/display.d.ts

@@ -1,3 +1 @@
-export declare function displayVersion(): void;
-export declare const usageText = "\n  Usage: cnc <command> [options]\n         constructive <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 pgpm workspace or module\n    extension          Manage module dependencies\n    plan               Generate module deployment plans\n    package            Package module for distribution\n    update             Update CLI/pgpm (installs pgpm by default)\n    cache              Manage cached templates (clean)\n  \n  Development Tools:\n    server             Start a GraphQL server\n    explorer           Launch GraphiQL explorer interface\n    docker             Manage PostgreSQL Docker containers (start/stop)\n    export             Export database migrations from existing databases\n  \n  Database Administration:\n    kill               Terminate database connections and optionally drop databases\n    install            Install pgpm modules\n    tag                Add tags to changes for versioning\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  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    constructive <command> --help    Display detailed help for specific command\n    constructive <command> -h        Display detailed help for specific command\n  \n  Examples:\n    cnc deploy --help       Show deploy command options\n    cnc server --port 8080  Start server on port 8080\n    cnc init workspace      Initialize new workspace\n  ";
-export declare function displayUsage(): void;
+export declare const usageText = "\n  Usage: cnc <command> [options]\n         constructive <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 pgpm workspace or module\n    extension          Manage module dependencies\n    plan               Generate module deployment plans\n    package            Package module for distribution\n    update             Update CLI/pgpm (installs pgpm by default)\n    cache              Manage cached templates (clean)\n    upgrade-modules    Upgrade installed pgpm modules to latest versions\n\n  Development Tools:\n    server             Start a GraphQL server\n    explorer           Launch GraphiQL explorer interface\n    docker             Manage PostgreSQL Docker containers (start/stop)\n    export             Export database migrations from existing databases\n    env                Display environment configuration\n\n  Code Generation:\n    codegen            Generate TypeScript types and SDK from GraphQL schema\n    get-graphql-schema Fetch or build GraphQL schema SDL\n\n  Database Administration:\n    kill               Terminate database connections and optionally drop databases\n    install            Install pgpm 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  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    constructive <command> --help    Display detailed help for specific command\n    constructive <command> -h        Display detailed help for specific command\n\n  Examples:\n    cnc deploy --help       Show deploy command options\n    cnc server --port 8080  Start server on port 8080\n    cnc init workspace      Initialize new workspace\n  ";

package/utils/display.js

@@ -1,29 +1,16 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.usageText = void 0;
-exports.displayVersion = displayVersion;
-exports.displayUsage = displayUsage;
-const find_and_require_package_json_1 = require("find-and-require-package-json");
-const yanse_1 = __importDefault(require("yanse"));
-// Function to display the version information
-function displayVersion() {
-    const pkg = (0, find_and_require_package_json_1.findAndRequirePackageJson)(__dirname);
-    console.log(yanse_1.default.green(`Name: ${pkg.name}`));
-    console.log(yanse_1.default.blue(`Version: ${pkg.version}`));
-}
 exports.usageText = `
   Usage: cnc <command> [options]
          constructive <command> [options]
-  
+
   Core Database Operations:
     add                Add database changes to plans and create SQL files
     deploy             Deploy database changes and migrations
     verify             Verify database state and migrations
     revert             Revert database changes and migrations
-  
+
   Project Management:
     init               Initialize pgpm workspace or module
     extension          Manage module dependencies
@@ -31,39 +18,50 @@ exports.usageText = `
     package            Package module for distribution
     update             Update CLI/pgpm (installs pgpm by default)
     cache              Manage cached templates (clean)
-  
+    upgrade-modules    Upgrade installed pgpm modules to latest versions
+
   Development Tools:
     server             Start a GraphQL server
     explorer           Launch GraphiQL explorer interface
     docker             Manage PostgreSQL Docker containers (start/stop)
     export             Export database migrations from existing databases
-  
+    env                Display environment configuration
+
+  Code Generation:
+    codegen            Generate TypeScript types and SDK from GraphQL schema
+    get-graphql-schema Fetch or build GraphQL schema SDL
+
   Database Administration:
     kill               Terminate database connections and optionally drop databases
     install            Install pgpm modules
     tag                Add tags to changes for versioning
-  
+    clear              Clear database state
+    remove             Remove database changes
+    analyze            Analyze database structure
+    rename             Rename database changes
+    admin-users        Manage admin users
+
+  Testing:
+    test-packages      Run integration tests on all workspace packages
+
   Migration Tools:
     migrate            Migration management subcommands
       init             Initialize migration tracking
       status           Show migration status
       list             List all changes
       deps             Show change dependencies
-  
+
   Global Options:
     -h, --help         Display this help information
     -v, --version      Display version information
     --cwd <directory>  Working directory (default: current directory)
-  
+
   Individual Command Help:
     constructive <command> --help    Display detailed help for specific command
     constructive <command> -h        Display detailed help for specific command
-  
+
   Examples:
     cnc deploy --help       Show deploy command options
     cnc server --port 8080  Start server on port 8080
     cnc init workspace      Initialize new workspace
   `;
-function displayUsage() {
-    console.log(exports.usageText);
-}