pgpm 0.0.1 → 0.1.0

package/esm/commands/admin-users.js

@@ -8,11 +8,11 @@ const subcommandMap = {
     remove
 };
 const adminUsersUsageText = `
-LaunchQL Admin Users Commands:
+Admin Users Commands:
 
-  lql admin-users bootstrap    Initialize LaunchQL roles and permissions (must be run first)
-  lql admin-users add          Add database users with roles
-  lql admin-users remove       Remove database users and revoke roles
+  pgpm admin-users bootstrap    Initialize postgres roles and permissions (must be run first)
+  pgpm admin-users add          Add database users with roles
+  pgpm admin-users remove       Remove database users and revoke roles
 
 Options:
   --help, -h     Show this help message
@@ -55,7 +55,7 @@ export default async (argv, prompter, options) => {
 };
 function getSubcommandDescription(cmd) {
     const descriptions = {
-        bootstrap: 'Initialize LaunchQL roles and permissions (must be run first)',
+        bootstrap: 'Initialize postgres roles and permissions (must be run first)',
         add: 'Add database users with roles',
         remove: 'Remove database users and revoke roles'
     };

package/esm/commands/analyze.js

@@ -1,5 +1,5 @@
-import path from 'path';
 import { LaunchQLPackage } from '@launchql/core';
+import path from 'path';
 export default async (argv, _prompter) => {
     const cwd = argv.cwd || process.cwd();
     const proj = new LaunchQLPackage(path.resolve(cwd));

package/esm/commands/clear.js

@@ -1,10 +1,10 @@
 import { LaunchQLPackage } from '@launchql/core';
-import { Logger } from '@launchql/logger';
-import { getEnvOptions } from '@launchql/env';
-import { getPgEnvOptions } from 'pg-env';
 import { parsePlanFile } from '@launchql/core';
+import { getEnvOptions } from '@launchql/env';
+import { Logger } from '@launchql/logger';
 import { errors } from '@launchql/types';
 import path from 'path';
+import { getPgEnvOptions } from 'pg-env';
 import { getTargetDatabase } from '../utils';
 const log = new Logger('clear');
 export default async (argv, prompter, _options) => {

package/esm/commands/deploy.js

@@ -1,14 +1,14 @@
 import { LaunchQLPackage } from '@launchql/core';
-import { Logger } from '@launchql/logger';
 import { getEnvOptions } from '@launchql/env';
+import { Logger } from '@launchql/logger';
 import { execSync } from 'child_process';
 import { getPgEnvOptions, getSpawnEnvWithPg, } from 'pg-env';
 import { getTargetDatabase } from '../utils';
 import { selectPackage } from '../utils/module-utils';
 const deployUsageText = `
-LaunchQL Deploy Command:
+Deploy Command:
 
-  lql deploy [OPTIONS]
+  pgpm deploy [OPTIONS]
 
   Deploy database changes and migrations to target database.
 
@@ -26,10 +26,10 @@ Options:
   --cwd <directory>  Working directory (default: current directory)
 
 Examples:
-  lql deploy                              Deploy to selected database
-  lql deploy --createdb                   Deploy with database creation
-  lql deploy --package mypackage --to @v1.0.0  Deploy specific package to tag
-  lql deploy --fast --no-tx              Fast deployment without transactions
+  pgpm deploy                              Deploy to selected database
+  pgpm deploy --createdb                   Deploy with database creation
+  pgpm deploy --package mypackage --to @v1.0.0  Deploy specific package to tag
+  pgpm deploy --fast --no-tx              Fast deployment without transactions
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/export.js

@@ -1,12 +1,12 @@
 import { exportMigrations, LaunchQLPackage } from '@launchql/core';
-import { getGitConfigInfo } from '@launchql/types';
 import { getEnvOptions } from '@launchql/env';
+import { getGitConfigInfo } from '@launchql/types';
 import { resolve } from 'path';
 import { getPgPool } from 'pg-cache';
 const exportUsageText = `
-LaunchQL Export Command:
+Export Command:
 
-  lql export [OPTIONS]
+  pgpm export [OPTIONS]
 
   Export database migrations from existing databases.
 
@@ -18,7 +18,7 @@ Options:
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql export              Export migrations from selected database
+  pgpm export              Export migrations from selected database
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/extension.js

@@ -1,8 +1,8 @@
 import { LaunchQLPackage } from '@launchql/core';
 const extensionUsageText = `
-LaunchQL Extension Command:
+Extension Command:
 
-  lql extension [OPTIONS]
+  pgpm extension [OPTIONS]
 
   Manage module dependencies.
 
@@ -11,7 +11,7 @@ Options:
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql extension           Manage dependencies for current module
+  pgpm extension           Manage dependencies for current module
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/init/index.js

@@ -1,11 +1,11 @@
 import runModuleSetup from './module';
 import runWorkspaceSetup from './workspace';
 const initUsageText = `
-LaunchQL Init Command:
+Init Command:
 
-  lql init [OPTIONS]
+  pgpm init [OPTIONS]
 
-  Initialize LaunchQL workspace or module.
+  Initialize pgpm workspace or module.
 
 Options:
   --help, -h              Show this help message
@@ -16,11 +16,11 @@ Options:
   --from-branch <branch>   Specify branch when using --repo (default: main)
 
 Examples:
-  lql init                                  Initialize new module in existing workspace
-  lql init --workspace                       Initialize new workspace
-  lql init --repo owner/repo                Use templates from GitHub repository
-  lql init --template-path ./custom-templates Use templates from local path
-  lql init --repo owner/repo --from-branch develop  Use specific branch
+  pgpm init                                  Initialize new module in existing workspace
+  pgpm init --workspace                       Initialize new workspace
+  pgpm init --repo owner/repo                Use templates from GitHub repository
+  pgpm init --template-path ./custom-templates Use templates from local path
+  pgpm init --repo owner/repo --from-branch develop  Use specific branch
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/init/workspace.js

@@ -1,7 +1,7 @@
 import { sluggify } from '@launchql/core';
 import { Logger } from '@launchql/logger';
 // @ts-ignore - TypeScript module resolution issue with @launchql/templatizer
-import { workspaceTemplate, writeRenderedTemplates, loadTemplates } from '@launchql/templatizer';
+import { loadTemplates, workspaceTemplate, writeRenderedTemplates } from '@launchql/templatizer';
 import { mkdirSync } from 'fs';
 import path from 'path';
 const log = new Logger('workspace-init');

package/esm/commands/install.js

@@ -1,10 +1,10 @@
 import { LaunchQLPackage } from '@launchql/core';
 const installUsageText = `
-LaunchQL Install Command:
+Install Command:
 
-  lql install <package>...
+  pgpm install <package>...
 
-  Install LaunchQL modules into current module.
+  Install pgpm modules into current module.
 
 Arguments:
   package                 One or more package names to install
@@ -14,8 +14,8 @@ Options:
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql install @launchql/base32                    Install single package
-  lql install @launchql/base32 @launchql/utils   Install multiple packages
+  pgpm install @pgpm/base32                    Install single package
+  pgpm install @pgpm/base32 @pgpm/utils   Install multiple packages
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested
@@ -29,7 +29,7 @@ export default async (argv, prompter, _options) => {
         throw new Error('You must run this command inside a LaunchQL module.');
     }
     if (argv._.length === 0) {
-        throw new Error('You must provide a package name to install, e.g. `@launchql/base32`');
+        throw new Error('You must provide a package name to install, e.g. `@pgpm/base32`');
     }
     await project.installModules(...argv._);
 };

package/esm/commands/kill.js

@@ -2,9 +2,9 @@ import { Logger } from '@launchql/logger';
 import { getPgPool } from 'pg-cache';
 const log = new Logger('db-kill');
 const killUsageText = `
-LaunchQL Kill Command:
+Kill Command:
 
-  lql kill [OPTIONS]
+  pgpm kill [OPTIONS]
 
   Terminate database connections and optionally drop databases.
 
@@ -16,10 +16,10 @@ Options:
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql kill                Kill connections and drop selected databases (interactive)
-  lql kill --no-drop      Only kill connections, preserve databases (interactive)
-  lql kill --pattern test_%   Kill connections to databases matching 'test_%' pattern
-  lql kill --pattern %dev --no-drop  Kill connections to databases ending with 'dev' but don't drop
+  pgpm kill                Kill connections and drop selected databases (interactive)
+  pgpm kill --no-drop      Only kill connections, preserve databases (interactive)
+  pgpm kill --pattern test_%   Kill connections to databases matching 'test_%' pattern
+  pgpm kill --pattern %dev --no-drop  Kill connections to databases ending with 'dev' but don't drop
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/migrate/init.js

@@ -13,7 +13,7 @@ export default async (argv, prompter, _options) => {
         {
             name: 'yes',
             type: 'confirm',
-            message: `Initialize LaunchQL migration schema in database "${database}"?`,
+            message: `Initialize pgpm migration schema in database "${database}"?`,
             required: true
         }
     ];

package/esm/commands/migrate.js

@@ -11,7 +11,7 @@ const subcommandMap = {
     deps
 };
 const migrateUsageText = `
-LaunchQL Migrate Commands:
+Migrate Commands:
 
   launchql migrate init      Initialize migration tracking in database
   launchql migrate status    Show current migration status

package/esm/commands/package.js

@@ -1,8 +1,8 @@
 import { LaunchQLPackage, writePackage } from '@launchql/core';
 const packageUsageText = `
-LaunchQL Package Command:
+Package Command:
 
-  lql package [OPTIONS]
+  pgpm package [OPTIONS]
 
   Package module for distribution.
 
@@ -14,8 +14,8 @@ Options:
   --cwd <directory>               Working directory (default: current directory)
 
 Examples:
-  lql package                     Package with defaults
-  lql package --no-plan           Package without plan
+  pgpm package                     Package with defaults
+  pgpm package --no-plan           Package without plan
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/plan.js

@@ -2,9 +2,9 @@ import { LaunchQLPackage } from '@launchql/core';
 import { Logger } from '@launchql/logger';
 const log = new Logger('plan');
 const planUsageText = `
-LaunchQL Plan Command:
+Plan Command:
 
-  lql plan [OPTIONS]
+  pgpm plan [OPTIONS]
 
   Generate module deployment plans.
 
@@ -15,9 +15,9 @@ Options:
   --cwd <directory>              Working directory (default: current directory)
 
 Examples:
-  lql plan                                 Generate deployment plan for current module with defaults
-  lql plan --includePackages false         Disable including external packages
-  lql plan --includeTags false              Do not prefer tags for external packages
+  pgpm plan                                 Generate deployment plan for current module with defaults
+  pgpm plan --includePackages false         Disable including external packages
+  pgpm plan --includeTags false              Do not prefer tags for external packages
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/remove.js

@@ -1,13 +1,13 @@
 import { LaunchQLPackage } from '@launchql/core';
-import { Logger } from '@launchql/logger';
 import { getEnvOptions } from '@launchql/env';
+import { Logger } from '@launchql/logger';
 import { getPgEnvOptions } from 'pg-env';
 import { getTargetDatabase } from '../utils';
 import { cliExitWithError } from '../utils/cli-error';
 const log = new Logger('remove');
 export default async (argv, prompter, _options) => {
     if (!argv.to) {
-        await cliExitWithError('No change specified. Usage: lql remove --to <change>');
+        await cliExitWithError('No change specified. Usage: pgpm remove --to <change>');
     }
     const database = await getTargetDatabase(argv, prompter, {
         message: 'Select database'

package/esm/commands/rename.js

@@ -1,5 +1,5 @@
-import path from 'path';
 import { LaunchQLPackage } from '@launchql/core';
+import path from 'path';
 import { cliExitWithError } from '../utils/cli-error';
 export default async (argv, _prompter) => {
     const cwd = argv.cwd || process.cwd();

package/esm/commands/revert.js

@@ -1,15 +1,15 @@
 import { LaunchQLPackage } from '@launchql/core';
-import { Logger } from '@launchql/logger';
 import { getEnvOptions } from '@launchql/env';
+import { Logger } from '@launchql/logger';
 import { getPgEnvOptions } from 'pg-env';
 import { getTargetDatabase } from '../utils';
-import { selectDeployedChange, selectDeployedPackage } from '../utils/deployed-changes';
 import { cliExitWithError } from '../utils/cli-error';
+import { selectDeployedChange, selectDeployedPackage } from '../utils/deployed-changes';
 const log = new Logger('revert');
 const revertUsageText = `
-LaunchQL Revert Command:
+Revert Command:
 
-  lql revert [OPTIONS]
+  pgpm revert [OPTIONS]
 
   Revert database changes and migrations.
 
@@ -23,9 +23,9 @@ Options:
   --cwd <directory>  Working directory (default: current directory)
 
 Examples:
-  lql revert                    Revert latest changes
-  lql revert --to @v1.0.0      Revert to specific tag
-  lql revert --to              Interactive selection from deployed changes
+  pgpm revert                    Revert latest changes
+  pgpm revert --to @v1.0.0      Revert to specific tag
+  pgpm revert --to              Interactive selection from deployed changes
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/tag.js

@@ -1,14 +1,14 @@
 import { LaunchQLPackage } from '@launchql/core';
 import { Logger } from '@launchql/logger';
 import { errors } from '@launchql/types';
+import * as path from 'path';
 import { extractFirst } from '../utils/argv';
 import { selectPackage } from '../utils/module-utils';
-import * as path from 'path';
 const log = new Logger('tag');
 const tagUsageText = `
-LaunchQL Tag Command:
+Tag Command:
 
-  lql tag [tag_name] [OPTIONS]
+  pgpm tag [tag_name] [OPTIONS]
 
   Add tags to changes for versioning.
 
@@ -23,9 +23,9 @@ Options:
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql tag v1.0.0                                    Add tag to latest change
-  lql tag v1.0.0 --comment "Initial release"       Add tag with comment
-  lql tag v1.1.0 --package mypackage --changeName my-change  Tag specific change in package
+  pgpm tag v1.0.0                                    Add tag to latest change
+  pgpm tag v1.0.0 --comment "Initial release"       Add tag with comment
+  pgpm tag v1.1.0 --package mypackage --changeName my-change  Tag specific change in package
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands/verify.js

@@ -1,15 +1,15 @@
 import { LaunchQLPackage } from '@launchql/core';
-import { Logger } from '@launchql/logger';
 import { getEnvOptions } from '@launchql/env';
+import { Logger } from '@launchql/logger';
 import { getPgEnvOptions } from 'pg-env';
 import { getTargetDatabase } from '../utils';
-import { selectDeployedChange, selectDeployedPackage } from '../utils/deployed-changes';
 import { cliExitWithError } from '../utils/cli-error';
+import { selectDeployedChange, selectDeployedPackage } from '../utils/deployed-changes';
 const log = new Logger('verify');
 const verifyUsageText = `
-LaunchQL Verify Command:
+Verify Command:
 
-  lql verify [OPTIONS]
+  pgpm verify [OPTIONS]
 
   Verify database state matches expected migrations.
 
@@ -22,9 +22,9 @@ Options:
   --cwd <directory>  Working directory (default: current directory)
 
 Examples:
-  lql verify                    Verify current database state
-  lql verify --package mypackage  Verify specific package
-  lql verify --to              Interactive selection from deployed changes
+  pgpm verify                    Verify current database state
+  pgpm verify --package mypackage  Verify specific package
+  pgpm verify --to              Interactive selection from deployed changes
 `;
 export default async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/esm/commands.js

@@ -1,10 +1,9 @@
 import { teardownPgPools } from 'pg-cache';
-// Commands
 import add from './commands/add';
 import adminUsers from './commands/admin-users';
+import analyze from './commands/analyze';
 import clear from './commands/clear';
 import deploy from './commands/deploy';
-import explorer from './commands/explorer';
 import _export from './commands/export';
 import extension from './commands/extension';
 import init from './commands/init';
@@ -14,12 +13,10 @@ import migrate from './commands/migrate';
 import _package from './commands/package';
 import plan from './commands/plan';
 import remove from './commands/remove';
+import renameCmd from './commands/rename';
 import revert from './commands/revert';
-import server from './commands/server';
 import tag from './commands/tag';
 import verify from './commands/verify';
-import analyze from './commands/analyze';
-import renameCmd from './commands/rename';
 import { readAndParsePackageJson } from './package';
 import { extractFirst, usageText } from './utils';
 import { cliExitWithError } from './utils/cli-error';
@@ -33,7 +30,7 @@ const withPgTeardown = (fn, skipTeardown = false) => async (...args) => {
         }
     }
 };
-const createCommandMap = (skipPgTeardown = false) => {
+export const createPgpmCommandMap = (skipPgTeardown = false) => {
     const pgt = (fn) => withPgTeardown(fn, skipPgTeardown);
     return {
         add,
@@ -53,10 +50,7 @@ const createCommandMap = (skipPgTeardown = false) => {
         install: pgt(install),
         migrate: pgt(migrate),
         analyze: pgt(analyze),
-        rename: pgt(renameCmd),
-        // These manage their own connection lifecycles
-        server,
-        explorer
+        rename: pgt(renameCmd)
     };
 };
 export const commands = async (argv, prompter, options) => {
@@ -66,18 +60,15 @@ export const commands = async (argv, prompter, options) => {
         process.exit(0);
     }
     let { first: command, newArgv } = extractFirst(argv);
-    // Show usage if explicitly requested but no command specified
     if ((argv.help || argv.h || command === 'help') && !command) {
         console.log(usageText);
         process.exit(0);
     }
-    // Show usage for help command specifically
     if (command === 'help') {
         console.log(usageText);
         process.exit(0);
     }
-    const commandMap = createCommandMap(options?.skipPgTeardown);
-    // Prompt if no command provided
+    const commandMap = createPgpmCommandMap(options?.skipPgTeardown);
     if (!command) {
         const answer = await prompter.prompt(argv, [
             {
@@ -89,7 +80,6 @@ export const commands = async (argv, prompter, options) => {
         ]);
         command = answer.command;
     }
-    // Prompt for working directory
     newArgv = await prompter.prompt(newArgv, [
         {
             type: 'text',

package/esm/index.js

@@ -1,6 +1,27 @@
 #!/usr/bin/env node
+import { readFileSync } from 'fs';
 import { CLI } from 'inquirerer';
-import { commands } from './commands';
+import { join } from 'path';
+import { commands, createPgpmCommandMap } from './commands';
+export { createPgpmCommandMap };
+export { default as add } from './commands/add';
+export { default as adminUsers } from './commands/admin-users';
+export { default as analyze } from './commands/analyze';
+export { default as clear } from './commands/clear';
+export { default as deploy } from './commands/deploy';
+export { default as _export } from './commands/export';
+export { default as extension } from './commands/extension';
+export { default as install } from './commands/install';
+export { default as kill } from './commands/kill';
+export { default as migrate } from './commands/migrate';
+export { default as _package } from './commands/package';
+export { default as plan } from './commands/plan';
+export { default as remove } from './commands/remove';
+export { default as renameCmd } from './commands/rename';
+export { default as revert } from './commands/revert';
+export { default as tag } from './commands/tag';
+export { default as verify } from './commands/verify';
+export * from './utils';
 export const options = {
     minimistOpts: {
         alias: {
@@ -9,12 +30,17 @@ export const options = {
         }
     }
 };
-const app = new CLI(commands, options);
-app.run().then(() => {
-    // all done!
-}).catch(error => {
-    // Should not reach here with the new CLI error handling pattern
-    // But keep as fallback for unexpected errors
-    console.error('Unexpected error:', error);
-    process.exit(1);
-});
+if (require.main === module) {
+    if (process.argv.includes('--version') || process.argv.includes('-v')) {
+        const pkgPath = join(__dirname, 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        console.log(pkg.version);
+        process.exit(0);
+    }
+    const app = new CLI(commands, options);
+    app.run().then(() => {
+    }).catch(error => {
+        console.error('Unexpected error:', error);
+        process.exit(1);
+    });
+}

package/esm/utils/cli-error.js

@@ -1,5 +1,5 @@
-import { LaunchQLError } from '@launchql/types';
 import { Logger } from '@launchql/logger';
+import { LaunchQLError } from '@launchql/types';
 import { teardownPgPools } from 'pg-cache';
 const log = new Logger('cli');
 /**

package/esm/utils/display.js

@@ -7,8 +7,7 @@ export function displayVersion() {
     console.log(chalk.blue(`Version: ${pkg.version}`));
 }
 export const usageText = `
-  Usage: lql <command> [options]
-         launchql <command> [options]
+  Usage: pgpm <command> [options]
   
   Core Database Operations:
     add                Add database changes to plans and create SQL files
@@ -17,20 +16,21 @@ export const usageText = `
     revert             Revert database changes and migrations
   
   Project Management:
-    init               Initialize LaunchQL workspace or module
+    init               Initialize workspace or module
     extension          Manage module dependencies
     plan               Generate module deployment plans
     package            Package module for distribution
-  
-  Development Tools:
-    server             Start LaunchQL GraphQL server
-    explorer           Launch GraphiQL explorer interface
     export             Export database migrations from existing databases
   
   Database Administration:
     kill               Terminate database connections and optionally drop databases
-    install            Install LaunchQL modules
+    install            Install database 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
   
   Migration Tools:
     migrate            Migration management subcommands
@@ -45,13 +45,13 @@ export const usageText = `
     --cwd <directory>  Working directory (default: current directory)
   
   Individual Command Help:
-    lql <command> --help    Display detailed help for specific command
-    lql <command> -h        Display detailed help for specific command
+    pgpm <command> --help    Display detailed help for specific command
+    pgpm <command> -h        Display detailed help for specific command
   
   Examples:
-    lql deploy --help       Show deploy command options
-    lql server --port 8080  Start server on port 8080
-    lql init --workspace    Initialize new workspace
+    pgpm deploy --help       Show deploy command options
+    pgpm init --workspace    Initialize new workspace
+    pgpm install @pgpm/base32  Install a database module
   `;
 export function displayUsage() {
     console.log(usageText);

package/esm/utils/index.js

@@ -1,3 +1,6 @@
 export * from './argv';
 export * from './database';
 export * from './display';
+export * from './cli-error';
+export * from './deployed-changes';
+export * from './module-utils';

package/index.d.ts

@@ -1,3 +1,23 @@
 #!/usr/bin/env node
 import { CLIOptions } from 'inquirerer';
+import { createPgpmCommandMap } from './commands';
+export { createPgpmCommandMap };
+export { default as add } from './commands/add';
+export { default as adminUsers } from './commands/admin-users';
+export { default as analyze } from './commands/analyze';
+export { default as clear } from './commands/clear';
+export { default as deploy } from './commands/deploy';
+export { default as _export } from './commands/export';
+export { default as extension } from './commands/extension';
+export { default as install } from './commands/install';
+export { default as kill } from './commands/kill';
+export { default as migrate } from './commands/migrate';
+export { default as _package } from './commands/package';
+export { default as plan } from './commands/plan';
+export { default as remove } from './commands/remove';
+export { default as renameCmd } from './commands/rename';
+export { default as revert } from './commands/revert';
+export { default as tag } from './commands/tag';
+export { default as verify } from './commands/verify';
+export * from './utils';
 export declare const options: Partial<CLIOptions>;