@constructive-io/cli 0.0.3 → 5.1.0

package/esm/commands/export.js

@@ -1,127 +0,0 @@
-import { exportMigrations, LaunchQLPackage } from '@launchql/core';
-import { getEnvOptions } from '@launchql/env';
-import { getGitConfigInfo } from '@launchql/types';
-import { resolve } from 'path';
-import { getPgPool } from 'pg-cache';
-const exportUsageText = `
-Export Command:
-
-  constructive export [OPTIONS]
-
-  Export database migrations from existing databases.
-
-Options:
-  --help, -h              Show this help message
-  --author <name>         Project author (default: from git config)
-  --extensionName <name>  Extension name
-  --metaExtensionName <name>  Meta extension name (default: svc)
-  --cwd <directory>       Working directory (default: current directory)
-
-Examples:
-  constructive export              Export migrations from selected database
-`;
-export default async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(exportUsageText);
-        process.exit(0);
-    }
-    const { email, username } = getGitConfigInfo();
-    const cwd = argv.cwd ?? process.cwd();
-    const project = new LaunchQLPackage(cwd);
-    project.ensureWorkspace();
-    project.resetCwd(project.workspacePath);
-    const options = getEnvOptions();
-    const db = await getPgPool({
-        database: 'postgres'
-    });
-    const databasesResult = await db.query(`
-    SELECT datname FROM pg_catalog.pg_database
-    WHERE datistemplate = FALSE AND datname NOT IN ('postgres')
-      AND datname !~ '^pg_';
-  `);
-    let databases;
-    ({ databases } = await prompter.prompt(argv, [
-        {
-            type: 'checkbox',
-            name: 'databases',
-            message: 'Select a database',
-            options: databasesResult.rows.map(row => row.datname),
-            required: true
-        }
-    ]));
-    const dbname = databases.filter(d => d.selected).map(d => d.value)[0];
-    const selectedDb = await getPgPool({
-        database: dbname
-    });
-    const dbsResult = await selectedDb.query(`
-    SELECT id, name FROM collections_public.database;
-  `);
-    let database_ids;
-    ({ database_ids } = await prompter.prompt({}, [
-        {
-            type: 'checkbox',
-            name: 'database_ids',
-            message: 'Select database_id(s)',
-            options: dbsResult.rows.map(db => db.name),
-            required: true
-        }
-    ]));
-    const dbInfo = {
-        dbname,
-        database_ids: database_ids.map(did => dbsResult.rows.find(db => db.name === did.name).id)
-    };
-    const { author, extensionName, metaExtensionName } = await prompter.prompt(argv, [
-        {
-            type: 'text',
-            name: 'author',
-            message: 'Project author',
-            default: `${username} <${email}>`,
-            required: true
-        },
-        {
-            type: 'text',
-            name: 'extensionName',
-            message: 'Extension name',
-            default: dbInfo.database_ids[0],
-            required: true
-        },
-        {
-            type: 'text',
-            name: 'metaExtensionName',
-            message: 'Meta extension name',
-            default: 'svc',
-            required: true
-        }
-    ]);
-    const schemasResult = await selectedDb.query(`SELECT * FROM collections_public.schema WHERE database_id = $1`, [dbInfo.database_ids[0]]);
-    const { schema_names } = await prompter.prompt({}, [
-        {
-            type: 'checkbox',
-            name: 'schema_names',
-            message: 'Select schema_name(s)',
-            options: schemasResult.rows.map(s => s.schema_name),
-            default: schemasResult.rows.map(s => s.schema_name),
-            required: true
-        }
-    ]);
-    const outdir = resolve(project.workspacePath, 'packages/');
-    await exportMigrations({
-        project,
-        options,
-        dbInfo,
-        author,
-        schema_names,
-        outdir,
-        extensionName,
-        metaExtensionName
-    });
-    console.log(`
-
-        |||
-       (o o)
-   ooO--(_)--Ooo-
-
-✨ finished!
-`);
-};

package/esm/commands/extension.js

@@ -1,46 +0,0 @@
-import { LaunchQLPackage } from '@launchql/core';
-const extensionUsageText = `
-Extension Command:
-
-  constructive extension [OPTIONS]
-
-  Manage module dependencies.
-
-Options:
-  --help, -h              Show this help message
-  --cwd <directory>       Working directory (default: current directory)
-
-Examples:
-  constructive extension           Manage dependencies for current module
-`;
-export default async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(extensionUsageText);
-        process.exit(0);
-    }
-    const { cwd = process.cwd() } = argv;
-    const project = new LaunchQLPackage(cwd);
-    if (!project.isInModule()) {
-        throw new Error('You must run this command inside a LaunchQL module.');
-    }
-    const info = project.getModuleInfo();
-    const installed = project.getRequiredModules();
-    const available = project.getAvailableModules();
-    const filtered = available.filter(name => name !== info.extname);
-    const questions = [
-        {
-            name: 'extensions',
-            message: 'Which modules does this one depend on?',
-            type: 'checkbox',
-            allowCustomOptions: true,
-            options: filtered,
-            default: installed
-        }
-    ];
-    const answers = await prompter.prompt(argv, questions);
-    const selected = answers.extensions
-        .filter(opt => opt.selected)
-        .map(opt => opt.name);
-    project.setModuleDependencies(selected);
-};

package/esm/commands/init/index.js

@@ -1,42 +0,0 @@
-import runModuleSetup from './module';
-import runWorkspaceSetup from './workspace';
-const initUsageText = `
-Init Command:
-
-  constructive init [OPTIONS]
-
-  Initialize constructive workspace or module.
-
-Options:
-  --help, -h              Show this help message
-  --workspace             Initialize workspace instead of module
-  --cwd <directory>       Working directory (default: current directory)
-  --repo <repo>           Use templates from GitHub repository (e.g., owner/repo)
-  --template-path <path>   Use templates from local path
-  --from-branch <branch>   Specify branch when using --repo (default: main)
-
-Examples:
-  constructive init                                  Initialize new module in existing workspace
-  constructive init --workspace                       Initialize new workspace
-  constructive init --repo owner/repo                Use templates from GitHub repository
-  constructive init --template-path ./custom-templates Use templates from local path
-  constructive init --repo owner/repo --from-branch develop  Use specific branch
-`;
-export default async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(initUsageText);
-        process.exit(0);
-    }
-    return handlePromptFlow(argv, prompter);
-};
-async function handlePromptFlow(argv, prompter) {
-    const { workspace } = argv;
-    switch (workspace) {
-        case true:
-            return runWorkspaceSetup(argv, prompter);
-        case false:
-        default:
-            return runModuleSetup(argv, prompter);
-    }
-}

package/esm/commands/init/module.js

@@ -1,68 +0,0 @@
-import { LaunchQLPackage, sluggify } from '@launchql/core';
-import { Logger } from '@launchql/logger';
-import { errors, getGitConfigInfo } from '@launchql/types';
-const log = new Logger('module-init');
-export default async function runModuleSetup(argv, prompter) {
-    const { email, username } = getGitConfigInfo();
-    const { cwd = process.cwd() } = argv;
-    const project = new LaunchQLPackage(cwd);
-    if (!project.workspacePath) {
-        log.error('Not inside a LaunchQL workspace.');
-        throw errors.NOT_IN_WORKSPACE({});
-    }
-    if (!project.isInsideAllowedDirs(cwd) && !project.isInWorkspace() && !project.isParentOfAllowedDirs(cwd)) {
-        log.error('You must be inside the workspace root or a parent directory of modules (like packages/).');
-        throw errors.NOT_IN_WORKSPACE_MODULE({});
-    }
-    const availExtensions = project.getAvailableModules();
-    const moduleQuestions = [
-        {
-            name: 'MODULENAME',
-            message: 'Enter the module name',
-            required: true,
-            type: 'text',
-        },
-        {
-            name: 'extensions',
-            message: 'Which extensions?',
-            options: availExtensions,
-            type: 'checkbox',
-            allowCustomOptions: true,
-            required: true,
-        },
-    ];
-    const answers = await prompter.prompt(argv, moduleQuestions);
-    const modName = sluggify(answers.MODULENAME);
-    const extensions = answers.extensions
-        .filter((opt) => opt.selected)
-        .map((opt) => opt.name);
-    // Determine template source
-    let templateSource;
-    if (argv.repo) {
-        templateSource = {
-            type: 'github',
-            path: argv.repo,
-            branch: argv.fromBranch
-        };
-        log.info(`Loading templates from GitHub repository: ${argv.repo}`);
-    }
-    else if (argv.templatePath) {
-        templateSource = {
-            type: 'local',
-            path: argv.templatePath
-        };
-        log.info(`Loading templates from local path: ${argv.templatePath}`);
-    }
-    project.initModule({
-        ...argv,
-        ...answers,
-        name: modName,
-        // @ts-ignore
-        USERFULLNAME: username,
-        USEREMAIL: email,
-        extensions,
-        templateSource
-    });
-    log.success(`Initialized module: ${modName}`);
-    return { ...argv, ...answers };
-}

package/esm/commands/init/workspace.js

@@ -1,46 +0,0 @@
-import { sluggify } from '@launchql/core';
-import { Logger } from '@launchql/logger';
-// @ts-ignore - TypeScript module resolution issue with @launchql/templatizer
-import { loadTemplates, workspaceTemplate, writeRenderedTemplates } from '@launchql/templatizer';
-import { mkdirSync } from 'fs';
-import path from 'path';
-const log = new Logger('workspace-init');
-export default async function runWorkspaceSetup(argv, prompter) {
-    const workspaceQuestions = [
-        {
-            name: 'name',
-            message: 'Enter workspace name',
-            required: true,
-            type: 'text',
-        }
-    ];
-    const answers = await prompter.prompt(argv, workspaceQuestions);
-    const { cwd } = argv;
-    const targetPath = path.join(cwd, sluggify(answers.name));
-    mkdirSync(targetPath, { recursive: true });
-    log.success(`Created workspace directory: ${targetPath}`);
-    // Determine template source
-    let templates = workspaceTemplate;
-    if (argv.repo) {
-        const source = {
-            type: 'github',
-            path: argv.repo,
-            branch: argv.fromBranch
-        };
-        log.info(`Loading templates from GitHub repository: ${argv.repo}`);
-        const compiledTemplates = loadTemplates(source, 'workspace');
-        templates = compiledTemplates.map((t) => t.render);
-    }
-    else if (argv.templatePath) {
-        const source = {
-            type: 'local',
-            path: argv.templatePath
-        };
-        log.info(`Loading templates from local path: ${argv.templatePath}`);
-        const compiledTemplates = loadTemplates(source, 'workspace');
-        templates = compiledTemplates.map((t) => t.render);
-    }
-    writeRenderedTemplates(templates, targetPath, { ...argv, ...answers });
-    log.success('Workspace templates rendered.');
-    return { ...argv, ...answers, cwd: targetPath };
-}

package/esm/commands/install.js

@@ -1,35 +0,0 @@
-import { LaunchQLPackage } from '@launchql/core';
-const installUsageText = `
-Install Command:
-
-  constructive install <package>...
-
-  Install database modules into current module.
-
-Arguments:
-  package                 One or more package names to install
-
-Options:
-  --help, -h              Show this help message
-  --cwd <directory>       Working directory (default: current directory)
-
-Examples:
-  constructive install @pgpm/base32                    Install single package
-  constructive install @pgpm/base32 @pgpm/utils   Install multiple packages
-`;
-export default async (argv, prompter, _options) => {
-    // Show usage if explicitly requested
-    if (argv.help || argv.h) {
-        console.log(installUsageText);
-        process.exit(0);
-    }
-    const { cwd = process.cwd() } = argv;
-    const project = new LaunchQLPackage(cwd);
-    if (!project.isInModule()) {
-        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. `@pgpm/base32`');
-    }
-    await project.installModules(...argv._);
-};

package/esm/commands/kill.js

@@ -1,105 +0,0 @@
-import { Logger } from '@launchql/logger';
-import { getPgPool } from 'pg-cache';
-const log = new Logger('db-kill');
-const killUsageText = `
-Kill Command:
-
-  constructive kill [OPTIONS]
-
-  Terminate database connections and optionally drop databases.
-
-Options:
-  --help, -h              Show this help message
-  --drop                  Drop databases after killing connections (default: true)
-  --no-drop               Only kill connections, don't drop databases
-  --pattern <pattern>     Pattern to match database names (supports SQL LIKE syntax)
-  --cwd <directory>       Working directory (default: current directory)
-
-Examples:
-  constructive kill                Kill connections and drop selected databases (interactive)
-  constructive kill --no-drop      Only kill connections, preserve databases (interactive)
-  constructive kill --pattern test_%   Kill connections to databases matching 'test_%' pattern
-  constructive 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
-    if (argv.help || argv.h) {
-        console.log(killUsageText);
-        process.exit(0);
-    }
-    const db = await getPgPool({
-        database: 'postgres'
-    });
-    let selectedDbNames;
-    if (argv.pattern) {
-        // Pattern mode: automatically find databases matching the pattern
-        const databasesResult = await db.query(`
-      SELECT datname FROM pg_catalog.pg_database
-      WHERE datistemplate = FALSE AND datname NOT IN ('postgres')
-        AND datname !~ '^pg_' AND datname LIKE $1;
-    `, [argv.pattern]);
-        if (!databasesResult.rows.length) {
-            log.info(`ℹ️  No databases found matching pattern "${argv.pattern}". Exiting.`);
-            return;
-        }
-        selectedDbNames = databasesResult.rows.map(row => row.datname);
-        log.info(`🎯 Found ${selectedDbNames.length} database(s) matching pattern "${argv.pattern}": ${selectedDbNames.join(', ')}`);
-    }
-    else {
-        // Interactive mode: prompt user to select databases
-        const databasesResult = await db.query(`
-      SELECT datname FROM pg_catalog.pg_database
-      WHERE datistemplate = FALSE AND datname NOT IN ('postgres')
-        AND datname !~ '^pg_';
-    `);
-        if (!databasesResult.rows.length) {
-            log.info('ℹ️  No databases found to process. Exiting.');
-            return;
-        }
-        let databases;
-        ({ databases } = await prompter.prompt(argv, [
-            {
-                type: 'checkbox',
-                name: 'databases',
-                message: 'Select database(s) to terminate connections and optionally drop',
-                options: databasesResult.rows.map(row => row.datname),
-                required: true
-            }
-        ]));
-        selectedDbNames = databases.filter(d => d.selected).map(d => d.value);
-    }
-    const actionText = argv.drop === false ? 'kill connections to' : 'kill connections and DROP';
-    const patternText = argv.pattern ? ` (matched by pattern "${argv.pattern}")` : '';
-    const { yes } = await prompter.prompt(argv, [
-        {
-            type: 'confirm',
-            name: 'yes',
-            message: `Are you sure you want to ${actionText}: ${selectedDbNames.join(', ')}${patternText}?`,
-            default: false
-        }
-    ]);
-    if (!yes) {
-        log.info('❌ Aborted. No actions were taken.');
-        return;
-    }
-    for (const dbname of selectedDbNames) {
-        const killResult = await db.query(`
-      SELECT pg_terminate_backend(pid)
-      FROM pg_stat_activity
-      WHERE datname = $1 AND pid <> pg_backend_pid();
-      `, [dbname]);
-        log.warn(`💀 Terminated ${killResult.rowCount} connection(s) to "${dbname}".`);
-        if (argv.drop === false) {
-            log.info(`⚠️  Skipping DROP for "${dbname}" due to --no-drop flag.`);
-            continue;
-        }
-        try {
-            await db.query(`DROP DATABASE "${dbname}";`);
-            log.success(`🗑️  Dropped database "${dbname}" successfully.`);
-        }
-        catch (err) {
-            log.error(`❌ Failed to drop "${dbname}": ${err.message}`);
-        }
-    }
-    log.success('✅ Done processing databases.');
-};

package/esm/commands/migrate/deps.js

@@ -1,184 +0,0 @@
-import { LaunchQLMigrate } from '@launchql/core';
-import { parsePlanFile } from '@launchql/core';
-import { Logger } from '@launchql/logger';
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { getPgEnvOptions } from 'pg-env';
-import { getTargetDatabase } from '../../utils/database';
-const log = new Logger('migrate-deps');
-export default async (argv, prompter, options) => {
-    const cwd = argv.cwd || process.cwd();
-    const planPath = join(cwd, 'pgpm.plan');
-    if (!existsSync(planPath)) {
-        log.error(`No pgpm.plan found in ${cwd}`);
-        process.exit(1);
-    }
-    // Get specific change to analyze
-    let changeName = argv._?.[0] || argv.change;
-    const planResult = parsePlanFile(planPath);
-    if (!planResult.data || planResult.errors.length > 0) {
-        log.error('Failed to parse plan file:', planResult.errors);
-        process.exit(1);
-    }
-    const plan = planResult.data;
-    const allChanges = plan.changes;
-    // If no change specified, prompt
-    if (!changeName && !argv.all) {
-        const answer = await prompter.prompt(argv, [
-            {
-                type: 'autocomplete',
-                name: 'change',
-                message: 'Which change do you want to analyze?',
-                options: allChanges.map(c => ({
-                    name: c.name,
-                    value: c.name,
-                    description: c.dependencies.length > 0 ? `Depends on: ${c.dependencies.join(', ')}` : 'No dependencies'
-                }))
-            }
-        ]);
-        changeName = answer.change;
-    }
-    try {
-        if (argv.all) {
-            // Show dependency graph for all changes
-            console.log('\n🔗 Dependency Graph\n');
-            console.log(`Package: ${plan.package}`);
-            console.log(`Total Changes: ${allChanges.length}\n`);
-            // Build dependency tree
-            const dependencyTree = buildDependencyTree(allChanges);
-            // Show changes with no dependencies first (roots)
-            const roots = allChanges.filter(c => c.dependencies.length === 0);
-            console.log('📌 Root Changes (no dependencies):\n');
-            roots.forEach(change => {
-                console.log(`  • ${change.name}`);
-                showDependents(change.name, dependencyTree, '    ');
-            });
-            // Show orphaned changes (have dependencies but aren't depended on)
-            const orphans = allChanges.filter(c => c.dependencies.length > 0 &&
-                !allChanges.some(other => other.dependencies.includes(c.name)));
-            if (orphans.length > 0) {
-                console.log('\n🔸 Leaf Changes (not depended on by others):\n');
-                orphans.forEach(change => {
-                    console.log(`  • ${change.name} → [${change.dependencies.join(', ')}]`);
-                });
-            }
-        }
-        else {
-            // Show dependencies for specific change
-            const change = allChanges.find(c => c.name === changeName);
-            if (!change) {
-                log.error(`Change '${changeName}' not found in plan file`);
-                process.exit(1);
-            }
-            console.log(`\n🔍 Dependency Analysis: ${changeName}\n`);
-            // Direct dependencies
-            if (change.dependencies.length > 0) {
-                console.log('📥 Direct Dependencies:');
-                change.dependencies.forEach(dep => {
-                    console.log(`  • ${dep}`);
-                });
-            }
-            else {
-                console.log('📥 Direct Dependencies: None');
-            }
-            // All dependencies (recursive)
-            const allDeps = getAllDependencies(change.name, allChanges);
-            if (allDeps.size > 0) {
-                console.log(`\n📦 All Dependencies (${allDeps.size} total):`);
-                Array.from(allDeps).forEach(dep => {
-                    console.log(`  • ${dep}`);
-                });
-            }
-            // Dependents (what depends on this)
-            const dependents = allChanges.filter(c => c.dependencies.includes(changeName));
-            if (dependents.length > 0) {
-                console.log(`\n📤 Depended on by (${dependents.length} changes):`);
-                dependents.forEach(dep => {
-                    console.log(`  • ${dep.name}`);
-                });
-            }
-            else {
-                console.log('\n📤 Depended on by: None');
-            }
-            // Check deployment status if connected to database
-            const pgEnv = getPgEnvOptions();
-            const targetDatabase = await getTargetDatabase(argv, prompter, {
-                message: 'Select database to check deployment status'
-            });
-            const client = new LaunchQLMigrate({
-                host: pgEnv.host,
-                port: pgEnv.port,
-                user: pgEnv.user,
-                password: pgEnv.password,
-                database: pgEnv.database
-            });
-            try {
-                const deployedChanges = await client.getDeployedChanges(targetDatabase, plan.package);
-                const deployedMap = new Map(deployedChanges.map(c => [c.change_name, c]));
-                console.log('\n📊 Deployment Status:');
-                // Check if this change is deployed
-                const isDeployed = deployedMap.has(changeName);
-                console.log(`  This change: ${isDeployed ? '✅ Deployed' : '⏳ Not deployed'}`);
-                // Check dependencies
-                const undeployedDeps = Array.from(allDeps).filter(dep => !deployedMap.has(dep));
-                if (undeployedDeps.length > 0) {
-                    console.log(`  ⚠️  Undeployed dependencies: ${undeployedDeps.join(', ')}`);
-                }
-                else if (allDeps.size > 0) {
-                    console.log('  ✅ All dependencies deployed');
-                }
-                // Check dependents
-                const deployedDependents = dependents.filter(d => deployedMap.has(d.name));
-                if (deployedDependents.length > 0) {
-                    console.log(`  ⚠️  Deployed dependents: ${deployedDependents.map(d => d.name).join(', ')}`);
-                }
-            }
-            catch (dbError) {
-                // Database connection optional for dependency analysis
-                log.debug('Could not connect to database for deployment status');
-            }
-        }
-    }
-    catch (error) {
-        log.error('Failed to analyze dependencies:', error);
-        process.exit(1);
-    }
-};
-function buildDependencyTree(changes) {
-    const tree = new Map();
-    changes.forEach(change => {
-        change.dependencies.forEach((dep) => {
-            if (!tree.has(dep)) {
-                tree.set(dep, []);
-            }
-            tree.get(dep).push(change.name);
-        });
-    });
-    return tree;
-}
-function showDependents(changeName, tree, indent) {
-    const dependents = tree.get(changeName) || [];
-    dependents.forEach(dep => {
-        console.log(`${indent}└─ ${dep}`);
-        showDependents(dep, tree, indent + '   ');
-    });
-}
-function getAllDependencies(changeName, changes) {
-    const deps = new Set();
-    const change = changes.find(c => c.name === changeName);
-    if (!change)
-        return deps;
-    function addDeps(change) {
-        change.dependencies.forEach((dep) => {
-            if (!deps.has(dep)) {
-                deps.add(dep);
-                const depChange = changes.find(c => c.name === dep);
-                if (depChange) {
-                    addDeps(depChange);
-                }
-            }
-        });
-    }
-    addDeps(change);
-    return deps;
-}