@memberjunction/cli 5.4.0 → 5.5.0

package/dist/commands/translate-sql/index.js

@@ -0,0 +1,229 @@
+import { Command, Flags } from '@oclif/core';
+import { ClassifySQLBatch, RuleBasedTranslate, GenerateTranslationReport, BuildGroundTruthPromptSection, } from '../../translate-sql/index.js';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * CLI command for translating SQL between database dialects.
+ * Scans metadata (Queries, UserViews, RLS filters) or explicit SQL fragments,
+ * classifies them, applies rule-based or LLM translation, and generates a report.
+ *
+ * Usage:
+ *   mj translate-sql --from sqlserver --to postgresql --scope queries
+ *   mj translate-sql --from sqlserver --to postgresql --scope all --dry-run
+ *   mj translate-sql --from sqlserver --to postgresql --sql "SELECT TOP 10 [Name] FROM [Users]"
+ */
+export default class TranslateSQL extends Command {
+    static { this.description = 'Translate SQL fragments between database dialects (SQL Server ↔ PostgreSQL)'; }
+    static { this.examples = [
+        '<%= config.bin %> translate-sql --from sqlserver --to postgresql --dry-run',
+        '<%= config.bin %> translate-sql --from sqlserver --to postgresql --scope queries',
+        '<%= config.bin %> translate-sql --from sqlserver --to postgresql --sql "SELECT TOP 10 [Name] FROM [Users]"',
+        '<%= config.bin %> translate-sql --from sqlserver --to postgresql --scope all --output ./reports',
+    ]; }
+    static { this.flags = {
+        from: Flags.string({
+            description: 'Source SQL dialect',
+            required: true,
+            options: ['sqlserver', 'postgresql'],
+        }),
+        to: Flags.string({
+            description: 'Target SQL dialect',
+            required: true,
+            options: ['sqlserver', 'postgresql'],
+        }),
+        scope: Flags.string({
+            description: 'What to scan for translation',
+            options: ['queries', 'views', 'filters', 'all'],
+            default: 'all',
+        }),
+        sql: Flags.string({
+            description: 'Translate a single SQL fragment (inline mode)',
+        }),
+        'dry-run': Flags.boolean({
+            description: 'Show what would be translated without making changes',
+            default: false,
+        }),
+        review: Flags.boolean({
+            description: 'Generate review report only (no writes to database)',
+            default: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Output directory for the translation report',
+        }),
+        force: Flags.boolean({
+            description: 'Re-translate even if platform variants already exist',
+            default: false,
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(TranslateSQL);
+        const from = flags.from;
+        const to = flags.to;
+        if (from === to) {
+            this.error('Source and target dialects must be different');
+        }
+        // Inline single-SQL mode
+        if (flags.sql) {
+            await this.translateInline(flags.sql, from, to);
+            return;
+        }
+        // Batch mode: scan metadata
+        await this.translateBatch(from, to, flags);
+    }
+    /**
+     * Translates a single SQL fragment provided via --sql flag.
+     */
+    async translateInline(sql, from, to) {
+        const [result] = ClassifySQLBatch([sql], from);
+        this.log(`\nClassification: ${result.classification}`);
+        if (result.markers.length > 0) {
+            this.log(`Dialect markers: ${result.markers.join(', ')}`);
+        }
+        if (result.classification === 'standard') {
+            this.log(`\nSQL is standard — no translation needed.`);
+            this.log(sql);
+            return;
+        }
+        if (result.classification === 'rule-based') {
+            const translated = RuleBasedTranslate(sql, from, to);
+            this.log(`\nRule-based translation (${translated.appliedRules.join(', ')}):`);
+            this.log(translated.translatedSQL);
+            return;
+        }
+        // LLM-needed
+        this.log(`\nThis SQL requires LLM translation.`);
+        this.log(`Markers: ${result.markers.join(', ')}`);
+        this.log(`\nGround truth examples for LLM prompt:`);
+        this.log(BuildGroundTruthPromptSection(from, to));
+        this.log(`\nOriginal SQL:`);
+        this.log(sql);
+        this.log(`\nNote: LLM integration requires AI provider configuration.`);
+        this.log(`Use the review report to see all fragments needing LLM translation.`);
+    }
+    /**
+     * Scans metadata for SQL fragments and generates a translation report.
+     */
+    async translateBatch(from, to, flags) {
+        this.log(`\nScanning for SQL fragments to translate (${from} → ${to})...`);
+        this.log(`Scope: ${flags.scope}`);
+        // For now, we work with metadata loaded via the MJ bootstrap.
+        // The prerun hook loads the bootstrap for heavy commands.
+        const items = await this.collectSQLFragments(from, flags.scope);
+        if (items.length === 0) {
+            this.log('\nNo SQL fragments found to translate.');
+            return;
+        }
+        // Classify all fragments
+        const classified = ClassifySQLBatch(items.map(i => i.sql), from);
+        // Translate
+        const reportItems = [];
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const classResult = classified[i];
+            if (classResult.classification === 'standard') {
+                reportItems.push({
+                    source: item.label,
+                    originalSQL: item.sql,
+                    classification: 'standard',
+                    translatedSQL: null,
+                    method: 'skipped',
+                    markers: classResult.markers,
+                });
+                continue;
+            }
+            if (classResult.classification === 'rule-based') {
+                const translated = RuleBasedTranslate(item.sql, from, to);
+                reportItems.push({
+                    source: item.label,
+                    originalSQL: item.sql,
+                    classification: 'rule-based',
+                    translatedSQL: translated.translatedSQL,
+                    method: 'rule-based',
+                    markers: classResult.markers,
+                    note: `Rules: ${translated.appliedRules.join(', ')}`,
+                });
+                continue;
+            }
+            // LLM-needed — flag for review
+            reportItems.push({
+                source: item.label,
+                originalSQL: item.sql,
+                classification: 'llm-needed',
+                translatedSQL: null,
+                method: 'flagged',
+                markers: classResult.markers,
+                note: 'Requires LLM translation — configure AI provider and re-run.',
+            });
+        }
+        // Print summary
+        const standard = reportItems.filter(i => i.classification === 'standard').length;
+        const ruleBased = reportItems.filter(i => i.method === 'rule-based').length;
+        const flagged = reportItems.filter(i => i.method === 'flagged').length;
+        this.log(`\nResults:`);
+        this.log(`  Total fragments: ${reportItems.length}`);
+        this.log(`  Standard SQL (no translation): ${standard}`);
+        this.log(`  Rule-based translations: ${ruleBased}`);
+        this.log(`  Flagged for LLM/review: ${flagged}`);
+        // Generate report
+        const report = GenerateTranslationReport(reportItems, from, to);
+        if (flags.output) {
+            const outputDir = flags.output;
+            if (!fs.existsSync(outputDir)) {
+                fs.mkdirSync(outputDir, { recursive: true });
+            }
+            const reportPath = path.join(outputDir, `translation-report-${from}-to-${to}.md`);
+            fs.writeFileSync(reportPath, report, 'utf-8');
+            this.log(`\nReport written to: ${reportPath}`);
+        }
+        if (flags['dry-run'] || flags.review) {
+            this.log(`\nDry run / review mode — no changes written to database.`);
+        }
+    }
+    /**
+     * Collects SQL fragments from loaded metadata.
+     */
+    async collectSQLFragments(from, scope) {
+        const fragments = [];
+        try {
+            const { Metadata } = await import('@memberjunction/core');
+            const md = new Metadata();
+            // Queries
+            if (scope === 'all' || scope === 'queries') {
+                for (const query of md.Queries) {
+                    if (query.SQL) {
+                        fragments.push({ label: `Query: ${query.Name}`, sql: query.SQL });
+                    }
+                    if (query.CacheValidationSQL) {
+                        fragments.push({
+                            label: `Query CacheValidation: ${query.Name}`,
+                            sql: query.CacheValidationSQL
+                        });
+                    }
+                }
+            }
+            // Row Level Security Filters (accessed via Provider, not exposed on Metadata directly)
+            if (scope === 'all' || scope === 'filters') {
+                for (const filter of Metadata.Provider.RowLevelSecurityFilters) {
+                    if (filter.FilterText) {
+                        fragments.push({
+                            label: `RLS Filter: ${filter.Name}`,
+                            sql: filter.FilterText
+                        });
+                    }
+                }
+            }
+            // UserViews - accessed through RunView since they're entity data
+            // In a full implementation, we'd query the UserView entity
+            // For now, we note that view SQL is mainly handled through ExtraFilter/OrderBy
+            // which already support PlatformSQL
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            this.warn(`Could not load metadata: ${message}`);
+            this.warn('Run this command in a configured MemberJunction environment.');
+        }
+        return fragments;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/translate-sql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/translate-sql/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/legacy-install.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Legacy interactive installer (pre-engine).
+ *
+ * Preserves the original `mj install` behavior from v3.x for the
+ * ZIP-only distribution workflow.  Access via `mj install --legacy`.
+ */
+import type { Command } from '@oclif/core';
+export declare class LegacyInstaller {
+    private cmd;
+    private verbose;
+    constructor(cmd: Command, verbose: boolean);
+    Run(): Promise<void>;
+    private bootstrapGeneratedEntities;
+    private bootstrapMjapi;
+    private processMjExplorer;
+    private checkNodeVersion;
+    private checkAvailableDiskSpace;
+    private verifyDirs;
+    private getUserConfiguration;
+    private promptForConfiguration;
+    private promptForAuthConfiguration;
+    private promptForUserSetup;
+    private promptForAiKeys;
+    private writeEnvFile;
+    private renameFolderToMjBase;
+    private updateEnvironmentFiles;
+    UpdateConfigNewUserSetup(userName?: string, firstName?: string, lastName?: string, email?: string): Promise<void>;
+}
+//# sourceMappingURL=legacy-install.d.ts.map

package/dist/lib/legacy-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-install.d.ts","sourceRoot":"","sources":["../../src/lib/legacy-install.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAiD3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,OAAO,CAAU;gBAEb,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IAKpC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB1B,OAAO,CAAC,0BAA0B;IAMlC,OAAO,CAAC,cAAc;YAYR,iBAAiB;IAwB/B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,uBAAuB;IA8B/B,OAAO,CAAC,UAAU;YAeJ,oBAAoB;YA0BpB,sBAAsB;YA4DtB,0BAA0B;YAkB1B,kBAAkB;YAkBlB,eAAe;IAY7B,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,oBAAoB;YAgBd,sBAAsB;IA4B9B,wBAAwB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAuCxH"}

package/dist/lib/legacy-install.js

@@ -0,0 +1,391 @@
+/**
+ * Legacy interactive installer (pre-engine).
+ *
+ * Preserves the original `mj install` behavior from v3.x for the
+ * ZIP-only distribution workflow.  Access via `mj install --legacy`.
+ */
+import { confirm, input, select } from '@inquirer/prompts';
+import dotenv from 'dotenv';
+import recast from 'recast';
+import fs from 'fs-extra';
+import { execSync } from 'node:child_process';
+import os from 'node:os';
+import path from 'node:path';
+import { ZodError, z } from 'zod';
+// Directories are relative to execution cwd
+const GENERATED_ENTITIES_DIR = 'GeneratedEntities';
+const SQL_SCRIPTS_DIR = 'SQL Scripts';
+const GENERATED_DIR = 'generated';
+const MJ_BASE_DIR = 'MJ_BASE';
+const MJAPI_DIR = 'MJAPI';
+const MJEXPLORER_DIR = 'MJExplorer';
+const configSchema = z.object({
+    dbUrl: z.string().min(1),
+    dbInstance: z.string(),
+    dbTrustServerCertificate: z.coerce
+        .boolean()
+        .default(false)
+        .transform((v) => (v ? 'Y' : 'N')),
+    dbDatabase: z.string().min(1),
+    dbPort: z.number({ coerce: true }).int().positive(),
+    codeGenLogin: z.string(),
+    codeGenPwD: z.string(),
+    mjAPILogin: z.string(),
+    mjAPIPwD: z.string(),
+    graphQLPort: z.number({ coerce: true }).int().positive().optional(),
+    authType: z.enum(['MSAL', 'AUTH0', 'BOTH']),
+    msalWebClientId: z.string().optional(),
+    msalTenantId: z.string().optional(),
+    auth0ClientId: z.string().optional(),
+    auth0ClientSecret: z.string().optional(),
+    auth0Domain: z.string().optional(),
+    createNewUser: z.coerce.boolean().optional(),
+    userEmail: z.string().email().or(z.literal('')).optional().default(''),
+    userFirstName: z.string().optional(),
+    userLastName: z.string().optional(),
+    userName: z.string().optional(),
+    openAIAPIKey: z.string().optional(),
+    anthropicAPIKey: z.string().optional(),
+    mistralAPIKey: z.string().optional(),
+});
+export class LegacyInstaller {
+    constructor(cmd, verbose) {
+        this.cmd = cmd;
+        this.verbose = verbose;
+    }
+    async Run() {
+        this.checkNodeVersion();
+        this.checkAvailableDiskSpace(2);
+        this.verifyDirs(GENERATED_ENTITIES_DIR, SQL_SCRIPTS_DIR, MJAPI_DIR, MJEXPLORER_DIR);
+        const userConfig = await this.getUserConfiguration();
+        this.cmd.log('Setting up MemberJunction Distribution...');
+        if (this.verbose) {
+            this.cmd.log(JSON.stringify(userConfig, null, 2));
+        }
+        this.bootstrapGeneratedEntities();
+        this.writeEnvFile(userConfig);
+        this.bootstrapMjapi(userConfig);
+        await this.processMjExplorer(userConfig);
+        this.cmd.log('Installation complete!');
+    }
+    // ---------------------------------------------------------------------------
+    // Top-level steps
+    // ---------------------------------------------------------------------------
+    bootstrapGeneratedEntities() {
+        this.cmd.log('\nBootstrapping GeneratedEntities...');
+        this.cmd.log('Running npm install...');
+        execSync('npm install', { stdio: 'inherit', cwd: GENERATED_ENTITIES_DIR });
+    }
+    bootstrapMjapi(userConfig) {
+        this.cmd.log('\n\nBootstrapping MJAPI...');
+        this.cmd.log('   Running npm link for generated code...');
+        execSync('npm link ../GeneratedEntities ../GeneratedActions', { stdio: 'inherit', cwd: MJAPI_DIR });
+        this.cmd.log('Running CodeGen...');
+        this.renameFolderToMjBase(userConfig.dbDatabase);
+        dotenv.config();
+        this.cmd.config.runCommand('codegen');
+    }
+    async processMjExplorer(userConfig) {
+        this.cmd.log('\nProcessing MJExplorer...');
+        this.cmd.log('\n   Updating environment files...');
+        const config = {
+            CLIENT_ID: userConfig.msalWebClientId,
+            TENANT_ID: userConfig.msalTenantId,
+            CLIENT_AUTHORITY: userConfig.msalTenantId
+                ? `https://login.microsoftonline.com/${userConfig.msalTenantId}`
+                : '',
+            AUTH_TYPE: userConfig.authType === 'AUTH0' ? 'auth0' : userConfig.authType.toLowerCase(),
+            AUTH0_DOMAIN: userConfig.auth0Domain,
+            AUTH0_CLIENTID: userConfig.auth0ClientId,
+        };
+        await this.updateEnvironmentFiles(path.join(MJEXPLORER_DIR, 'src', 'environments'), config);
+        this.cmd.log('   Running npm link for GeneratedEntities...');
+        execSync('npm link ../GeneratedEntities', { stdio: 'inherit', cwd: MJEXPLORER_DIR });
+    }
+    // ---------------------------------------------------------------------------
+    // Preflight checks
+    // ---------------------------------------------------------------------------
+    checkNodeVersion() {
+        const validNodeVersion = Number(process.version.replace(/^v(\d+).*/, '$1')) >= 20;
+        if (!validNodeVersion) {
+            this.cmd.error('MemberJunction requires Node.js version 20 or higher.', { exit: 1 });
+        }
+    }
+    checkAvailableDiskSpace(numGB = 2) {
+        try {
+            this.cmd.log(`Checking for at least ${numGB}GB of free disk space...`);
+            const GBToBytes = 1024 * 1024 * 1024;
+            const requiredSpace = numGB * GBToBytes;
+            let freeSpace;
+            if (os.platform() === 'win32') {
+                const command = `wmic LogicalDisk where DeviceID="C:" get FreeSpace`;
+                const output = execSync(command).toString();
+                const lines = output.trim().split('\n');
+                freeSpace = parseInt(lines[1].trim());
+            }
+            else {
+                const command = `df -k / | tail -1 | awk '{ print $4; }'`;
+                freeSpace = parseInt(execSync(command).toString().trim()) * 1024;
+            }
+            if (freeSpace >= requiredSpace) {
+                this.cmd.log(`   Sufficient disk space available: ${Math.round(freeSpace / GBToBytes)} GB`);
+            }
+            else {
+                this.cmd.error(`Insufficient disk space. Required: ${requiredSpace} bytes, Available: ${Math.round(freeSpace / GBToBytes)} GB`, { exit: 1 });
+            }
+        }
+        catch {
+            this.cmd.error('Error checking disk space', { exit: 1 });
+        }
+    }
+    verifyDirs(...dirs) {
+        dirs.forEach((dir) => {
+            if (!fs.existsSync(dir)) {
+                this.cmd.error(`Unable to locate required package at '${path.join(fs.realpathSync('.'), dir)}'`, {
+                    exit: 1,
+                    suggestions: ['Run the install from the same directory as the extracted MemberJunction distribution'],
+                });
+            }
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Configuration
+    // ---------------------------------------------------------------------------
+    async getUserConfiguration() {
+        let userConfig;
+        try {
+            const configObject = await fs.readJSON('install.config.json');
+            userConfig = configSchema.parse(configObject);
+        }
+        catch (e) {
+            if (e instanceof ZodError) {
+                this.cmd.log(`Invalid config file found at '${path.join(fs.realpathSync('.'), 'install.config.json')}'${this.verbose ? '' : ', retry with --verbose for details'}`);
+                if (this.verbose) {
+                    console.table(e.issues);
+                }
+            }
+            else {
+                this.cmd.log(`No config file found at '${path.join(fs.realpathSync('.'), 'install.config.json')}'`);
+            }
+        }
+        if (!userConfig) {
+            userConfig = await this.promptForConfiguration();
+        }
+        return userConfig;
+    }
+    async promptForConfiguration() {
+        this.cmd.log('\n>>> Please answer the following questions to setup the .env files for CodeGen. After this process you can manually edit the .env file as desired.');
+        const dbUrl = await input({
+            message: 'Enter the database server hostname:',
+            validate: (v) => configSchema.shape.dbDatabase.safeParse(v).success,
+        });
+        const dbInstance = await input({
+            message: 'If you are using a named instance on that server, if so, enter the name here, if not leave blank:',
+        });
+        const dbTrustServerCertificate = (await confirm({
+            message: 'Does the database server use a self-signed certificate? If you are using a local instance, enter Y:',
+        }))
+            ? 'Y'
+            : 'N';
+        const dbDatabase = await input({
+            message: 'Enter the database name on that server:',
+            validate: (v) => configSchema.shape.dbDatabase.safeParse(v).success,
+        });
+        const dbPort = await input({
+            message: 'Enter the port the database server listens on',
+            validate: (v) => configSchema.shape.dbPort.safeParse(v).success,
+            default: '1433',
+        });
+        const codeGenLogin = await input({ message: 'Enter the database login for CodeGen:' });
+        const codeGenPwD = await input({ message: 'Enter the database password for CodeGen:' });
+        this.cmd.log('\n>>> Please answer the following questions to setup the .env files for MJAPI. After this process you can manually edit the .env file in CodeGen as desired.');
+        const mjAPILogin = await input({ message: 'Enter the database login for MJAPI:' });
+        const mjAPIPwD = await input({ message: 'Enter the database password for MJAPI:' });
+        const graphQLPort = await input({
+            message: 'Enter the port to use for the GraphQL API',
+            validate: (v) => configSchema.shape.graphQLPort.safeParse(v).success,
+            default: '4000',
+        });
+        const authConfig = await this.promptForAuthConfiguration();
+        const userSetup = await this.promptForUserSetup();
+        const aiKeys = await this.promptForAiKeys();
+        return configSchema.parse({
+            dbUrl,
+            dbInstance,
+            dbTrustServerCertificate,
+            dbDatabase,
+            dbPort,
+            codeGenLogin,
+            codeGenPwD,
+            mjAPILogin,
+            mjAPIPwD,
+            graphQLPort,
+            ...authConfig,
+            ...userSetup,
+            ...aiKeys,
+        });
+    }
+    async promptForAuthConfiguration() {
+        const authType = await select({
+            message: 'Will you be using Microsoft Entra (formerly Azure AD), Auth0, or both for authentication services for MJAPI:',
+            choices: [
+                { name: 'Microsoft Entra (MSAL)', value: 'MSAL' },
+                { name: 'Auth0', value: 'AUTH0' },
+                { name: 'Both', value: 'BOTH' },
+            ],
+        });
+        const msalTenantId = ['BOTH', 'MSAL'].includes(authType) ? await input({ message: 'Enter the web client ID for Entra:' }) : '';
+        const msalWebClientId = ['BOTH', 'MSAL'].includes(authType) ? await input({ message: 'Enter the tenant ID for Entra:' }) : '';
+        const auth0ClientId = ['BOTH', 'AUTH0'].includes(authType) ? await input({ message: 'Enter the client ID for Auth0:' }) : '';
+        const auth0ClientSecret = ['BOTH', 'AUTH0'].includes(authType) ? await input({ message: 'Enter the client secret for Auth0:' }) : '';
+        const auth0Domain = ['BOTH', 'AUTH0'].includes(authType) ? await input({ message: 'Enter the domain for Auth0:' }) : '';
+        return { authType, msalTenantId, msalWebClientId, auth0ClientId, auth0ClientSecret, auth0Domain };
+    }
+    async promptForUserSetup() {
+        const createNewUser = await confirm({ message: 'Do you want to create a new user in the database? (Y/N):' });
+        const userEmail = createNewUser
+            ? await input({
+                message: 'Enter the new user email',
+                validate: (v) => configSchema.shape.userEmail.safeParse(v).success,
+            })
+            : '';
+        const userFirstName = createNewUser ? await input({ message: 'Enter the new user first name:' }) : '';
+        const userLastName = createNewUser ? await input({ message: 'Enter the new user last name::' }) : '';
+        const userName = createNewUser
+            ? await input({ message: 'Enter the new user name (leave blank to use email):', default: userEmail })
+            : '';
+        return { createNewUser: createNewUser ? 'Y' : 'N', userEmail, userFirstName, userLastName, userName };
+    }
+    async promptForAiKeys() {
+        const openAIAPIKey = await input({ message: 'Enter the OpenAI API Key (leave blank if not using):' });
+        const anthropicAPIKey = await input({ message: 'Enter the Anthropic API Key (leave blank if not using):' });
+        const mistralAPIKey = await input({ message: 'Enter the Mistral API Key (leave blank if not using):' });
+        return { openAIAPIKey, anthropicAPIKey, mistralAPIKey };
+    }
+    // ---------------------------------------------------------------------------
+    // File generation
+    // ---------------------------------------------------------------------------
+    writeEnvFile(userConfig) {
+        this.cmd.log('\nProcessing Config...');
+        this.cmd.log('   Updating ');
+        this.cmd.log('   Setting up .env and mj.config.cjs...');
+        const dotenvContent = `#Database Setup
+DB_HOST='${userConfig.dbUrl}'
+DB_PORT=${userConfig.dbPort}
+CODEGEN_DB_USERNAME='${userConfig.codeGenLogin}'
+CODEGEN_DB_PASSWORD='${userConfig.codeGenPwD}'
+DB_USERNAME='${userConfig.mjAPILogin}'
+DB_PASSWORD='${userConfig.mjAPIPwD}'
+DB_DATABASE='${userConfig.dbDatabase}'
+${userConfig.dbInstance ? "DB_INSTANCE_NAME='" + userConfig.dbInstance + "'" : ''}
+${userConfig.dbTrustServerCertificate === 'Y' ? 'DB_TRUST_SERVER_CERTIFICATE=1' : ''}
+
+#OUTPUT CODE is used for output directories like SQL Scripts
+OUTPUT_CODE='${userConfig.dbDatabase}'
+
+# Name of the schema that MJ has been setup in. This defaults to __mj
+MJ_CORE_SCHEMA='__mj'
+
+# If using Advanced Generation or the MJAI library, populate this with the API key for the AI vendor you are using
+# Also, you need to configure the settings under advancedGeneration in the mj.config.cjs file, including choosing the vendor.
+AI_VENDOR_API_KEY__OpenAILLM='${userConfig.openAIAPIKey}'
+AI_VENDOR_API_KEY__MistralLLM='${userConfig.mistralAPIKey}'
+AI_VENDOR_API_KEY__AnthropicLLM='${userConfig.anthropicAPIKey}'
+
+PORT=${userConfig.graphQLPort}
+
+UPDATE_USER_CACHE_WHEN_NOT_FOUND=1
+UPDATE_USER_CACHE_WHEN_NOT_FOUND_DELAY=5000
+
+# AUTHENTICATION SECTION - you can use MSAL or Auth0 or both for authentication services for MJAPI
+# MSAL Section
+WEB_CLIENT_ID=${userConfig.msalWebClientId}
+TENANT_ID=${userConfig.msalTenantId}
+
+# Auth0 Section
+AUTH0_CLIENT_ID=${userConfig.auth0ClientId}
+AUTH0_CLIENT_SECRET=${userConfig.auth0ClientSecret}
+AUTH0_DOMAIN=${userConfig.auth0Domain}
+
+# Skip API URL, KEY and Org ID
+# YOU MUST ENTER IN THE CORRECT URL and ORG ID for your Skip API USE BELOW
+ASK_SKIP_API_URL = 'http://localhost:8000'
+ASK_SKIP_ORGANIZATION_ID = 1
+`;
+        fs.writeFileSync('.env', dotenvContent);
+    }
+    renameFolderToMjBase(dbDatabase) {
+        const oldFolderPath = path.join(SQL_SCRIPTS_DIR, GENERATED_DIR, MJ_BASE_DIR);
+        const newFolderPath = path.join(SQL_SCRIPTS_DIR, GENERATED_DIR, dbDatabase);
+        if (!fs.existsSync(oldFolderPath)) {
+            this.cmd.warn(`SQL scripts not found at '${oldFolderPath}', skipping rename`);
+            return;
+        }
+        try {
+            fs.moveSync(oldFolderPath, newFolderPath);
+            this.cmd.log(`Renamed ${oldFolderPath} to ${newFolderPath} successfully.`);
+        }
+        catch (err) {
+            this.cmd.logToStderr(`An error occurred while renaming the '${oldFolderPath}' folder: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    async updateEnvironmentFiles(dirPath, config) {
+        try {
+            const envFilePattern = /environment.*\.ts$/;
+            const files = await fs.readdir(dirPath);
+            const envFiles = files.filter((file) => envFilePattern.test(file));
+            for (const file of envFiles) {
+                if (this.verbose) {
+                    this.cmd.log(`Updating ${file}`);
+                }
+                const filePath = path.join(dirPath, file);
+                const data = await fs.readFile(filePath, 'utf8');
+                let updatedData = data;
+                Object.entries(config).forEach(([key, value = '']) => {
+                    const regex = new RegExp(`(["\']?${key}["\']?:\\s*["\'])([^"\']*)(["\'])`, 'g');
+                    const escapedValue = value.replaceAll('$', () => '$$');
+                    updatedData = updatedData.replace(regex, `$1${escapedValue}$3`);
+                });
+                await fs.writeFile(filePath, updatedData, 'utf8');
+                this.cmd.log(`Updated ${file}`);
+            }
+        }
+        catch (err) {
+            console.error('Error:', err);
+        }
+    }
+    async UpdateConfigNewUserSetup(userName, firstName, lastName, email) {
+        try {
+            const configFileContent = await fs.readFile('mj.config.cjs', 'utf8');
+            const ast = recast.parse(configFileContent);
+            const n = recast.types.namedTypes;
+            const b = recast.types.builders;
+            recast.types.visit(ast, {
+                visitObjectExpression(visitPath) {
+                    const properties = visitPath.node.properties;
+                    const newUserSetupProperty = properties.find((prop) => n.Property.check(prop) && n.Identifier.check(prop.key) && prop.key.name === 'newUserSetup');
+                    const newUserSetupValue = b.objectExpression([
+                        b.property('init', b.identifier('userName'), b.literal(userName || '')),
+                        b.property('init', b.identifier('firstName'), b.literal(firstName || '')),
+                        b.property('init', b.identifier('lastName'), b.literal(lastName || '')),
+                        b.property('init', b.identifier('email'), b.literal(email || '')),
+                    ]);
+                    if (newUserSetupProperty && newUserSetupProperty.type === 'Property') {
+                        newUserSetupProperty.value = newUserSetupValue;
+                    }
+                    else {
+                        properties.push(b.property('init', b.identifier('newUserSetup'), newUserSetupValue));
+                    }
+                    return false;
+                },
+            });
+            const updatedConfigFileContent = recast.prettyPrint(ast).code;
+            await fs.writeFile('mj.config.cjs', updatedConfigFileContent);
+            this.cmd.log(`      Updated mj.config.cjs`);
+        }
+        catch (err) {
+            this.cmd.logToStderr(`Error updating mj.config.cjs: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=legacy-install.js.map