@constructive-io/cli 0.0.2 → 5.1.0

package/utils/argv.js

@@ -1,100 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractFirst = void 0;
-exports.validateCommonArgs = validateCommonArgs;
-exports.validateFlagDependencies = validateFlagDependencies;
-exports.logEffectiveArgs = logEffectiveArgs;
-exports.constructTarget = constructTarget;
-const logger_1 = require("@launchql/logger");
-const log = new logger_1.Logger('argv-utils');
-const extractFirst = (argv) => {
-    const first = argv._?.[0];
-    const newArgv = {
-        ...argv,
-        _: argv._?.slice(1) ?? []
-    };
-    return { first, newArgv };
-};
-exports.extractFirst = extractFirst;
-/**
- * Validates and normalizes common CLI arguments
- */
-function validateCommonArgs(argv) {
-    const validated = {
-        ...argv,
-        cwd: argv.cwd || process.cwd(),
-        _: argv._ || []
-    };
-    const booleanFlags = ['recursive', 'yes', 'tx', 'fast', 'logOnly', 'createdb', 'usePlan', 'cache', 'drop', 'all', 'summary', 'help', 'h'];
-    for (const flag of booleanFlags) {
-        if (argv[flag] !== undefined && typeof argv[flag] !== 'boolean') {
-            log.warn(`--${flag} flag should be boolean, converting to true`);
-            validated[flag] = true;
-        }
-    }
-    const stringFlags = ['package', 'to', 'database'];
-    for (const flag of stringFlags) {
-        if (argv[flag] !== undefined && typeof argv[flag] !== 'string') {
-            log.warn(`--${flag} should be a string, converting`);
-            validated[flag] = String(argv[flag]);
-        }
-    }
-    return validated;
-}
-/**
- * Checks if required flags are provided when certain conditions are met
- */
-function validateFlagDependencies(argv) {
-    if (argv.to && !argv.package && !argv.recursive) {
-        log.warn('--to flag provided without --package or --recursive. Target may not work as expected.');
-    }
-    if (argv.package && argv.recursive) {
-        if (argv.package.includes(':')) {
-            log.warn('--package should not contain ":" when using --recursive. Use --to for target specification.');
-        }
-    }
-}
-/**
- * Logs the effective CLI arguments for debugging
- */
-function logEffectiveArgs(argv, commandName) {
-    const relevantArgs = {
-        cwd: argv.cwd,
-        database: argv.database,
-        package: argv.package,
-        to: argv.to,
-        recursive: argv.recursive,
-        yes: argv.yes,
-        tx: argv.tx,
-        fast: argv.fast,
-        logOnly: argv.logOnly,
-        createdb: argv.createdb,
-        usePlan: argv.usePlan,
-        cache: argv.cache,
-        drop: argv.drop,
-        all: argv.all,
-        summary: argv.summary
-    };
-    const definedArgs = Object.fromEntries(Object.entries(relevantArgs).filter(([_, value]) => value !== undefined));
-    if (Object.keys(definedArgs).length > 1) { // More than just cwd
-        log.debug(`${commandName} effective arguments:`, definedArgs);
-    }
-}
-/**
- * Constructs a deployment target string from package and to arguments
- */
-function constructTarget(argv, packageName) {
-    if (packageName && argv.to) {
-        return `${packageName}:${argv.to}`;
-    }
-    else if (packageName) {
-        return packageName;
-    }
-    else if (argv.package && argv.to) {
-        return `${argv.package}:${argv.to}`;
-    }
-    else if (argv.package) {
-        return argv.package;
-    }
-    return undefined;
-}

package/utils/cli-error.d.ts

@@ -1,8 +0,0 @@
-import { LaunchQLError } from '@launchql/types';
-/**
- * CLI error utility that logs error information and exits with code 1.
- * Provides consistent error handling and user experience across all CLI commands.
- *
- * IMPORTANT: This function properly cleans up PostgreSQL connections before exiting.
- */
-export declare const cliExitWithError: (error: LaunchQLError | Error | string, context?: Record<string, any>) => Promise<never>;

package/utils/cli-error.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cliExitWithError = void 0;
-const logger_1 = require("@launchql/logger");
-const types_1 = require("@launchql/types");
-const pg_cache_1 = require("pg-cache");
-const log = new logger_1.Logger('cli');
-/**
- * CLI error utility that logs error information and exits with code 1.
- * Provides consistent error handling and user experience across all CLI commands.
- *
- * IMPORTANT: This function properly cleans up PostgreSQL connections before exiting.
- */
-const cliExitWithError = async (error, context) => {
-    if (error instanceof types_1.LaunchQLError) {
-        // For LaunchQLError instances, use structured logging
-        log.error(`Error: ${error.message}`);
-        // Log additional context if available
-        if (error.context && Object.keys(error.context).length > 0) {
-            log.debug('Error context:', error.context);
-        }
-        // Log any additional context provided
-        if (context) {
-            log.debug('Additional context:', context);
-        }
-    }
-    else if (error instanceof Error) {
-        // For generic Error instances
-        log.error(`Error: ${error.message}`);
-        if (context) {
-            log.debug('Context:', context);
-        }
-    }
-    else if (typeof error === 'string') {
-        // For simple string messages
-        log.error(`Error: ${error}`);
-        if (context) {
-            log.debug('Context:', context);
-        }
-    }
-    // Perform cleanup before exiting
-    try {
-        await (0, pg_cache_1.teardownPgPools)();
-        log.debug('Database connections cleaned up');
-    }
-    catch (cleanupError) {
-        log.warn('Failed to cleanup database connections:', cleanupError);
-        // Don't let cleanup errors prevent the exit
-    }
-    process.exit(1);
-};
-exports.cliExitWithError = cliExitWithError;

package/utils/database.d.ts

@@ -1,21 +0,0 @@
-import { Inquirerer } from 'inquirerer';
-import { ParsedArgs } from 'minimist';
-export interface DatabaseSelectionOptions {
-    message?: string;
-    excludeTemplates?: boolean;
-    excludePostgres?: boolean;
-    excludeSystemDbs?: boolean;
-    multiple?: boolean;
-}
-/**
- * Get list of available databases from PostgreSQL
- */
-export declare function getAvailableDatabases(options?: DatabaseSelectionOptions): Promise<string[]>;
-/**
- * Prompt user to select a database
- */
-export declare function selectDatabase(argv: Partial<ParsedArgs>, prompter: Inquirerer, options?: DatabaseSelectionOptions): Promise<string>;
-/**
- * Get target database with fallback to environment
- */
-export declare function getTargetDatabase(argv: Partial<ParsedArgs>, prompter: Inquirerer, options?: DatabaseSelectionOptions): Promise<string>;

package/utils/database.js

@@ -1,83 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAvailableDatabases = getAvailableDatabases;
-exports.selectDatabase = selectDatabase;
-exports.getTargetDatabase = getTargetDatabase;
-const pg_cache_1 = require("pg-cache");
-const pg_env_1 = require("pg-env");
-/**
- * Get list of available databases from PostgreSQL
- */
-async function getAvailableDatabases(options = {}) {
-    const { excludeTemplates = true, excludePostgres = true, excludeSystemDbs = true } = options;
-    const db = await (0, pg_cache_1.getPgPool)({
-        database: 'postgres'
-    });
-    let query = `
-    SELECT datname FROM pg_catalog.pg_database
-    WHERE 1=1
-  `;
-    if (excludeTemplates) {
-        query += ` AND datistemplate = FALSE`;
-    }
-    if (excludePostgres) {
-        query += ` AND datname NOT IN ('postgres')`;
-    }
-    if (excludeSystemDbs) {
-        query += ` AND datname !~ '^pg_'`;
-    }
-    query += ` ORDER BY datname`;
-    const result = await db.query(query);
-    return result.rows.map((row) => row.datname);
-}
-/**
- * Prompt user to select a database
- */
-async function selectDatabase(argv, prompter, options = {}) {
-    const { message = 'Select target database', multiple = false } = options;
-    // Check if database is already specified
-    if (!multiple && (argv.db || argv.database)) {
-        return argv.db || argv.database;
-    }
-    // Get available databases
-    const databases = await getAvailableDatabases(options);
-    if (databases.length === 0) {
-        throw new Error('No databases found');
-    }
-    // If only one database and not forcing selection, use it
-    if (!multiple && databases.length === 1 && !argv.interactive) {
-        return databases[0];
-    }
-    // Prompt for selection
-    const answer = await prompter.prompt(argv, [
-        {
-            type: multiple ? 'checkbox' : 'autocomplete',
-            name: 'database',
-            message,
-            options: databases,
-            required: true
-        }
-    ]);
-    return answer.database;
-}
-/**
- * Get target database with fallback to environment
- */
-async function getTargetDatabase(argv, prompter, options = {}) {
-    // If database is specified in args, use it
-    if (argv.db || argv.database) {
-        return argv.db || argv.database;
-    }
-    // Try to select from available databases
-    try {
-        return await selectDatabase(argv, prompter, options);
-    }
-    catch (error) {
-        // Fall back to environment database
-        const pgEnv = (0, pg_env_1.getPgEnvOptions)();
-        if (pgEnv.database) {
-            return pgEnv.database;
-        }
-        throw new Error('No database specified and no default database found');
-    }
-}

package/utils/deployed-changes.d.ts

@@ -1,4 +0,0 @@
-import { Logger } from '@launchql/logger';
-import { Inquirerer } from 'inquirerer';
-export declare function selectDeployedChange(database: string, argv: Partial<Record<string, any>>, prompter: Inquirerer, log: Logger, action?: 'revert' | 'verify'): Promise<string | undefined>;
-export declare function selectDeployedPackage(database: string, argv: Partial<Record<string, any>>, prompter: Inquirerer, log: Logger, action?: 'revert' | 'verify'): Promise<string | undefined>;

package/utils/deployed-changes.js

@@ -1,72 +0,0 @@
-"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/module-utils.d.ts

@@ -1,8 +0,0 @@
-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

@@ -1,54 +0,0 @@
-"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;
-}