@constructive-io/cli 0.0.2

package/utils/deployed-changes.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectDeployedChange = selectDeployedChange;
+exports.selectDeployedPackage = selectDeployedPackage;
+const core_1 = require("@launchql/core");
+const pg_env_1 = require("pg-env");
+async function selectDeployedChange(database, argv, prompter, log, action = 'revert') {
+    const pgEnv = (0, pg_env_1.getPgEnvOptions)({ database });
+    const client = new core_1.LaunchQLMigrate(pgEnv);
+    let selectedPackage;
+    if (argv.package) {
+        selectedPackage = argv.package;
+    }
+    else {
+        const packageStatuses = await client.status();
+        if (packageStatuses.length === 0) {
+            log.warn('No deployed packages found in database');
+            return undefined;
+        }
+        const packageAnswer = await prompter.prompt(argv, [{
+                type: 'autocomplete',
+                name: 'package',
+                message: `Select package to ${action} from:`,
+                options: packageStatuses.map(status => ({
+                    name: status.package,
+                    value: status.package,
+                    description: `${status.totalDeployed} changes, last: ${status.lastChange}`
+                }))
+            }]);
+        selectedPackage = packageAnswer.package;
+    }
+    const deployedChanges = await client.getDeployedChanges(database, selectedPackage);
+    if (deployedChanges.length === 0) {
+        log.warn(`No deployed changes found for package ${selectedPackage}`);
+        return undefined;
+    }
+    const changeAnswer = await prompter.prompt(argv, [{
+            type: 'autocomplete',
+            name: 'change',
+            message: `Select change to ${action} to in ${selectedPackage}:`,
+            options: deployedChanges.map(change => ({
+                name: change.change_name,
+                value: change.change_name,
+                description: `Deployed: ${new Date(change.deployed_at).toLocaleString()}`
+            }))
+        }]);
+    const selectedChange = changeAnswer.change;
+    return `${selectedPackage}:${selectedChange}`;
+}
+async function selectDeployedPackage(database, argv, prompter, log, action = 'revert') {
+    if (argv.package) {
+        return argv.package;
+    }
+    const pgEnv = (0, pg_env_1.getPgEnvOptions)({ database });
+    const client = new core_1.LaunchQLMigrate(pgEnv);
+    const packageStatuses = await client.status();
+    if (packageStatuses.length === 0) {
+        log.warn('No deployed packages found in database');
+        return undefined;
+    }
+    const packageAnswer = await prompter.prompt(argv, [{
+            type: 'autocomplete',
+            name: 'package',
+            message: `Select package to ${action}:`,
+            options: packageStatuses.map(status => ({
+                name: status.package,
+                value: status.package,
+                description: `${status.totalDeployed} changes, last: ${status.lastChange}`
+            }))
+        }]);
+    return packageAnswer.package;
+}

package/utils/display.d.ts

@@ -0,0 +1,3 @@
+export declare function displayVersion(): void;
+export declare const usageText = "\n  Usage: 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 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\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  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    constructive deploy --help       Show deploy command options\n    constructive init --workspace    Initialize new workspace\n    constructive install @pgpm/base32  Install a database module\n  ";
+export declare function displayUsage(): void;

package/utils/display.js

@@ -0,0 +1,66 @@
+"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 chalk_1 = __importDefault(require("chalk"));
+const package_1 = require("../package");
+// Function to display the version information
+function displayVersion() {
+    const pkg = (0, package_1.readAndParsePackageJson)();
+    console.log(chalk_1.default.green(`Name: ${pkg.name}`));
+    console.log(chalk_1.default.blue(`Version: ${pkg.version}`));
+}
+exports.usageText = `
+  Usage: 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 workspace or module
+    extension          Manage module dependencies
+    plan               Generate module deployment plans
+    package            Package module for distribution
+    export             Export database migrations from existing databases
+
+  Database Administration:
+    kill               Terminate database connections and optionally drop databases
+    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
+      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:
+    constructive deploy --help       Show deploy command options
+    constructive init --workspace    Initialize new workspace
+    constructive install @pgpm/base32  Install a database module
+  `;
+function displayUsage() {
+    console.log(exports.usageText);
+}

package/utils/index.d.ts

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

package/utils/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./argv"), exports);
+__exportStar(require("./database"), exports);
+__exportStar(require("./display"), exports);
+__exportStar(require("./cli-error"), exports);
+__exportStar(require("./deployed-changes"), exports);
+__exportStar(require("./module-utils"), exports);

package/utils/module-utils.d.ts

@@ -0,0 +1,8 @@
+import { Logger } from '@launchql/logger';
+import { Inquirerer } from 'inquirerer';
+import { ParsedArgs } from 'minimist';
+/**
+ * Handle package selection for operations that need a specific package
+ * Returns the selected package name, or undefined if validation fails or no packages exist
+ */
+export declare function selectPackage(argv: Partial<ParsedArgs>, prompter: Inquirerer, cwd: string, operationName: string, log?: Logger): Promise<string | undefined>;

package/utils/module-utils.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectPackage = selectPackage;
+const core_1 = require("@launchql/core");
+const types_1 = require("@launchql/types");
+/**
+ * Handle package selection for operations that need a specific package
+ * Returns the selected package name, or undefined if validation fails or no packages exist
+ */
+async function selectPackage(argv, prompter, cwd, operationName, log) {
+    const pkg = new core_1.LaunchQLPackage(cwd);
+    const modules = await pkg.getModules();
+    const moduleNames = modules.map(mod => mod.getModuleName());
+    // Check if any modules exist
+    if (!moduleNames.length) {
+        const errorMsg = 'No modules found in the specified directory.';
+        if (log) {
+            log.error(errorMsg);
+            return undefined;
+        }
+        else {
+            prompter.close();
+            throw types_1.errors.NOT_FOUND({}, errorMsg);
+        }
+    }
+    // If a specific package was provided, validate it
+    if (argv.package) {
+        const packageName = argv.package;
+        if (log)
+            log.info(`Using specified package: ${packageName}`);
+        if (!moduleNames.includes(packageName)) {
+            const errorMsg = `Package '${packageName}' not found. Available packages: ${moduleNames.join(', ')}`;
+            if (log) {
+                log.error(errorMsg);
+                return undefined;
+            }
+            else {
+                throw types_1.errors.NOT_FOUND({}, errorMsg);
+            }
+        }
+        return packageName;
+    }
+    // Interactive selection
+    const { package: selectedPackage } = await prompter.prompt(argv, [{
+            type: 'autocomplete',
+            name: 'package',
+            message: `Choose a package to ${operationName}`,
+            options: moduleNames,
+            required: true
+        }]);
+    if (log)
+        log.info(`Selected package: ${selectedPackage}`);
+    return selectedPackage;
+}