@memberjunction/cli 1.0.11

package/README.md

@@ -0,0 +1,87 @@
+MemberJunction CLI
+==================
+
+<!-- toc -->
+* [Usage](#usage)
+* [Commands](#commands)
+<!-- tocstop -->
+# Usage
+<!-- usage -->
+```sh-session
+$ npm install -g @memberjunction/cli
+$ mj COMMAND
+running command...
+$ mj (--version)
+@memberjunction/cli/1.0.11 darwin-arm64 node-v20.12.2
+$ mj --help [COMMAND]
+USAGE
+  $ mj COMMAND
+...
+```
+<!-- usagestop -->
+# Commands
+<!-- commands -->
+* [`mj help [COMMAND]`](#mj-help-command)
+* [`mj install`](#mj-install)
+* [`mj version`](#mj-version)
+
+## `mj help [COMMAND]`
+
+Display help for mj.
+
+```
+USAGE
+  $ mj help [COMMAND...] [-n]
+
+ARGUMENTS
+  COMMAND...  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
+
+DESCRIPTION
+  Display help for mj.
+```
+
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.0.21/src/commands/help.ts)_
+
+## `mj install`
+
+Install MemberJunction
+
+```
+USAGE
+  $ mj install [-v]
+
+FLAGS
+  -v, --verbose  Enable additional logging
+
+DESCRIPTION
+  Install MemberJunction
+
+EXAMPLES
+  $ mj install
+```
+
+_See code: [src/commands/install/index.ts](https://github.com/MemberJunction/MJ/blob/v1.0.11/src/commands/install/index.ts)_
+
+## `mj version`
+
+```
+USAGE
+  $ mj version [--json] [--verbose]
+
+FLAGS
+  --verbose  Show additional information about the CLI.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+FLAG DESCRIPTIONS
+  --verbose  Show additional information about the CLI.
+
+    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.
+```
+
+_See code: [@oclif/plugin-version](https://github.com/oclif/plugin-version/blob/v2.0.17/src/commands/version.ts)_
+<!-- commandsstop -->

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node_modules/.bin/ts-node
+;(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({ development: true, dir: __dirname })
+})()

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+;(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({development: false, dir: __dirname})
+})()

package/dist/commands/install/index.d.ts

@@ -0,0 +1,144 @@
+import { Command } from '@oclif/core';
+import { ParserOutput } from '@oclif/core/lib/interfaces/parser';
+import { z } from 'zod';
+type Config = z.infer<typeof configSchema>;
+declare const configSchema: z.ZodObject<{
+    dbUrl: z.ZodString;
+    dbInstance: z.ZodString;
+    dbTrustServerCertificate: z.ZodEnum<["Y", "N"]>;
+    dbDatabase: z.ZodString;
+    dbPort: z.ZodNumber;
+    codeGenLogin: z.ZodString;
+    codeGenPwD: z.ZodString;
+    mjAPILogin: z.ZodString;
+    mjAPIPwD: z.ZodString;
+    graphQLPort: z.ZodOptional<z.ZodNumber>;
+    authType: z.ZodEnum<["MSAL", "AUTH0", "BOTH"]>;
+    msalWebClientId: z.ZodOptional<z.ZodString>;
+    msalTenantId: z.ZodOptional<z.ZodString>;
+    auth0ClientId: z.ZodOptional<z.ZodString>;
+    auth0ClientSecret: z.ZodOptional<z.ZodString>;
+    auth0Domain: z.ZodOptional<z.ZodString>;
+    createNewUser: z.ZodOptional<z.ZodEnum<["Y", "N"]>>;
+    userEmail: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>>;
+    userFirstName: z.ZodOptional<z.ZodString>;
+    userLastName: z.ZodOptional<z.ZodString>;
+    userName: z.ZodOptional<z.ZodString>;
+    openAIAPIKey: z.ZodOptional<z.ZodString>;
+    anthropicAPIKey: z.ZodOptional<z.ZodString>;
+    mistralAPIKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    dbUrl: string;
+    dbInstance: string;
+    dbTrustServerCertificate: "N" | "Y";
+    dbDatabase: string;
+    dbPort: number;
+    codeGenLogin: string;
+    codeGenPwD: string;
+    mjAPILogin: string;
+    mjAPIPwD: string;
+    authType: "MSAL" | "AUTH0" | "BOTH";
+    userEmail: string;
+    graphQLPort?: number | undefined;
+    msalWebClientId?: string | undefined;
+    msalTenantId?: string | undefined;
+    auth0ClientId?: string | undefined;
+    auth0ClientSecret?: string | undefined;
+    auth0Domain?: string | undefined;
+    createNewUser?: "N" | "Y" | undefined;
+    userFirstName?: string | undefined;
+    userLastName?: string | undefined;
+    userName?: string | undefined;
+    openAIAPIKey?: string | undefined;
+    anthropicAPIKey?: string | undefined;
+    mistralAPIKey?: string | undefined;
+}, {
+    dbUrl: string;
+    dbInstance: string;
+    dbTrustServerCertificate: "N" | "Y";
+    dbDatabase: string;
+    dbPort: number;
+    codeGenLogin: string;
+    codeGenPwD: string;
+    mjAPILogin: string;
+    mjAPIPwD: string;
+    authType: "MSAL" | "AUTH0" | "BOTH";
+    graphQLPort?: number | undefined;
+    msalWebClientId?: string | undefined;
+    msalTenantId?: string | undefined;
+    auth0ClientId?: string | undefined;
+    auth0ClientSecret?: string | undefined;
+    auth0Domain?: string | undefined;
+    createNewUser?: "N" | "Y" | undefined;
+    userEmail?: string | undefined;
+    userFirstName?: string | undefined;
+    userLastName?: string | undefined;
+    userName?: string | undefined;
+    openAIAPIKey?: string | undefined;
+    anthropicAPIKey?: string | undefined;
+    mistralAPIKey?: string | undefined;
+}>;
+export default class Install extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        verbose: import("@oclif/core/lib/interfaces/parser").BooleanFlag<boolean>;
+    };
+    flags: ParserOutput<Install>['flags'];
+    userConfig: Config;
+    run(): Promise<void>;
+    getUserConfiguration(): Promise<{
+        dbUrl: string;
+        dbInstance: string;
+        dbTrustServerCertificate: "N" | "Y";
+        dbDatabase: string;
+        dbPort: number;
+        codeGenLogin: string;
+        codeGenPwD: string;
+        mjAPILogin: string;
+        mjAPIPwD: string;
+        authType: "MSAL" | "AUTH0" | "BOTH";
+        userEmail: string;
+        graphQLPort?: number | undefined;
+        msalWebClientId?: string | undefined;
+        msalTenantId?: string | undefined;
+        auth0ClientId?: string | undefined;
+        auth0ClientSecret?: string | undefined;
+        auth0Domain?: string | undefined;
+        createNewUser?: "N" | "Y" | undefined;
+        userFirstName?: string | undefined;
+        userLastName?: string | undefined;
+        userName?: string | undefined;
+        openAIAPIKey?: string | undefined;
+        anthropicAPIKey?: string | undefined;
+        mistralAPIKey?: string | undefined;
+    }>;
+    /**
+     * Verifies that the specified directories exist.
+     * @param {...string} dirs - The directories to check.
+     */
+    verifyDirs(...dirs: string[]): void;
+    /**
+     * Checks if there is at least `numGB` GB of free disk space.
+     * @param {number} numGB - The number of GB to check for.
+     * @returns {boolean} True if there is enough free disk space, false otherwise.
+     */
+    checkAvailableDiskSpace(numGB?: number): boolean;
+    /**
+     * Updates environment files in a given directory.
+     * @param {string} dirPath - The path to the directory containing environment files.
+     * @param {object} config - The configuration object with values to update.
+     */
+    updateEnvironmentFiles(dirPath: string, config: Record<string, unknown>): Promise<void>;
+    renameFolderToMJ_BASE(dbDatabase: string): void;
+    /**
+     * Updates newUserSetup in the config.json file.
+     * @param {string} dirPath - The path to the directory containing the config.json file.
+     * @param {string} userName - The new UserName to set.
+     * @param {string} firstName - The new FirstName to set.
+     * @param {string} lastName - The new LastName to set.
+     * @param {string} email - The new Email to set.
+     */
+    updateConfigNewUserSetup(dirPath: string, userName?: string, firstName?: string, lastName?: string, email?: string): Promise<void>;
+}
+export {};

package/dist/commands/install/index.js

@@ -0,0 +1,438 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const prompts_1 = require("@inquirer/prompts");
+const core_1 = require("@oclif/core");
+const fs = __importStar(require("fs-extra"));
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const zod_1 = require("zod");
+// Directories are relative to execution cwd
+const GENERATED_ENTITIES_DIR = 'GeneratedEntities';
+const CODEGEN_DIR = 'CodeGen';
+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 = zod_1.z.object({
+    dbUrl: zod_1.z.string().url(),
+    dbInstance: zod_1.z.string(),
+    dbTrustServerCertificate: zod_1.z.enum(['Y', 'N']),
+    dbDatabase: zod_1.z.string(),
+    dbPort: zod_1.z.number({ coerce: true }).int().positive(),
+    codeGenLogin: zod_1.z.string(),
+    codeGenPwD: zod_1.z.string(),
+    mjAPILogin: zod_1.z.string(),
+    mjAPIPwD: zod_1.z.string(),
+    graphQLPort: zod_1.z.number({ coerce: true }).int().positive().optional(),
+    authType: zod_1.z.enum(['MSAL', 'AUTH0', 'BOTH']),
+    msalWebClientId: zod_1.z.string().optional(),
+    msalTenantId: zod_1.z.string().optional(),
+    auth0ClientId: zod_1.z.string().optional(),
+    auth0ClientSecret: zod_1.z.string().optional(),
+    auth0Domain: zod_1.z.string().optional(),
+    createNewUser: zod_1.z.enum(['Y', 'N']).optional(),
+    userEmail: zod_1.z.string().email().or(zod_1.z.literal('')).optional().default(''),
+    userFirstName: zod_1.z.string().optional(),
+    userLastName: zod_1.z.string().optional(),
+    userName: zod_1.z.string().optional(),
+    openAIAPIKey: zod_1.z.string().optional(),
+    anthropicAPIKey: zod_1.z.string().optional(),
+    mistralAPIKey: zod_1.z.string().optional(),
+});
+class Install extends core_1.Command {
+    static description = 'Install MemberJunction';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>
+`,
+    ];
+    static flags = {
+        verbose: core_1.Flags.boolean({ char: 'v', description: 'Enable additional logging' }),
+    };
+    flags;
+    userConfig;
+    async run() {
+        const parsed = await this.parse(Install);
+        this.flags = parsed.flags;
+        this.checkAvailableDiskSpace(2);
+        this.verifyDirs(CODEGEN_DIR, GENERATED_ENTITIES_DIR, SQL_SCRIPTS_DIR, MJAPI_DIR, MJEXPLORER_DIR);
+        this.userConfig = await this.getUserConfiguration();
+        this.log('Setting up MemberJunction Distribution...');
+        if (this.flags.verbose) {
+            this.logJson({ userConfig: this.userConfig, flags: this.flags });
+        }
+        // if the user asked for a new user via our config file, need to push that info down to the CodeGen config.json file
+        if (this.userConfig.createNewUser === 'Y') {
+            this.log('   Setting up config.json...');
+            await this.updateConfigNewUserSetup(CODEGEN_DIR, this.userConfig.userName, this.userConfig.userFirstName, this.userConfig.userLastName, this.userConfig.userEmail);
+        }
+        //*******************************************************************
+        // Process GeneratedEntities
+        //*******************************************************************
+        this.log('\nBootstrapping GeneratedEntities...');
+        this.log('Running npm install...');
+        (0, node_child_process_1.execSync)('npm install', { stdio: 'inherit', cwd: GENERATED_ENTITIES_DIR });
+        //*******************************************************************
+        // Process CodeGen
+        //*******************************************************************
+        this.log('\nProcessing CodeGen...');
+        this.log('   Updating ');
+        this.log('   Setting up .env and config.json...');
+        const codeGenENV = `#Database Setup
+DB_HOST='${this.userConfig.dbUrl}'
+DB_PORT=${this.userConfig.dbPort}
+DB_USERNAME='${this.userConfig.codeGenLogin}'
+DB_PASSWORD='${this.userConfig.codeGenPwD}'
+DB_DATABASE='${this.userConfig.dbDatabase}'
+${this.userConfig.dbInstance ? "DB_INSTANCE_NAME='" + this.userConfig.dbInstance + "'" : ''}
+${this.userConfig.dbTrustServerCertificate === 'Y' ? 'DB_TRUST_SERVER_CERTIFICATE=1' : ''}
+
+#OUTPUT CODE is used for output directories like SQL Scripts
+OUTPUT_CODE='${this.userConfig.dbDatabase}'
+
+# Name of the schema that MJ has been setup in. This defaults to __mj
+MJ_CORE_SCHEMA='__mj'
+
+# If using Advanced Generation, populate this with the API key for the AI vendor you are using
+# Also, you need to configure the settings under advancedGeneration in the config.json file, including choosing the vendor.
+AI_VENDOR_API_KEY__OpenAILLM='${this.userConfig.openAIAPIKey}'  
+AI_VENDOR_API_KEY__MistralLLM='${this.userConfig.mistralAPIKey}'  
+AI_VENDOR_API_KEY__AnthropicLLM='${this.userConfig.anthropicAPIKey}'  
+
+#CONFIG_FILE is the name of the file that has the configuration parameters for CodeGen
+CONFIG_FILE='config.json'
+`;
+        fs.writeFileSync(node_path_1.default.join(CODEGEN_DIR, '.env'), codeGenENV);
+        this.log('   Running npm install...');
+        (0, node_child_process_1.execSync)('npm install', { stdio: 'inherit', cwd: CODEGEN_DIR });
+        this.log('   Running npm link for GeneratedEntities...');
+        (0, node_child_process_1.execSync)('npm link ../GeneratedEntities', { stdio: 'inherit', cwd: CODEGEN_DIR });
+        //*******************************************************************
+        // Process MJAPI
+        //*******************************************************************
+        this.log('\n\nBootstrapping MJAPI...');
+        this.log('   Running npm install...');
+        (0, node_child_process_1.execSync)('npm install', { stdio: 'inherit', cwd: MJAPI_DIR });
+        this.log('   Setting up MJAPI .env file...');
+        const mjAPIENV = `#Database Setup
+DB_HOST='${this.userConfig.dbUrl}'
+DB_PORT=${this.userConfig.dbPort}
+DB_USERNAME='${this.userConfig.mjAPILogin}'
+DB_PASSWORD='${this.userConfig.mjAPIPwD}'
+DB_DATABASE='${this.userConfig.dbDatabase}'
+${this.userConfig.dbInstance ? "DB_INSTANCE_NAME='" + this.userConfig.dbInstance + "'" : ''}
+${this.userConfig.dbTrustServerCertificate === 'Y' ? 'DB_TRUST_SERVER_CERTIFICATE=1' : ''}
+
+PORT=${this.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=${this.userConfig.msalWebClientId}
+TENANT_ID=${this.userConfig.msalTenantId}
+
+# Auth0 Section
+AUTH0_CLIENT_ID=${this.userConfig.auth0ClientId}
+AUTH0_CLIENT_SECRET=${this.userConfig.auth0ClientSecret}
+AUTH0_DOMAIN=${this.userConfig.auth0Domain}
+
+# Name of the schema that MJ has been setup in. This defaults to __mj
+MJ_CORE_SCHEMA='__mj'
+
+# If you are using MJAI library, provide your API KEYS here for the various services
+# Format is AI_VENDOR_API_KEY__<DriverClass> Where DriverClass is the DriverClass field from the AI Models Entity in MemberJunction
+AI_VENDOR_API_KEY__OpenAILLM = '${this.userConfig.openAIAPIKey}'
+AI_VENDOR_API_KEY__AnthropicLLM = '${this.userConfig.anthropicAPIKey}'
+AI_VENDOR_API_KEY__MistralLLM = '${this.userConfig.mistralAPIKey}'
+
+# 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
+
+CONFIG_FILE='config.json'
+`;
+        fs.writeFileSync(node_path_1.default.join(MJAPI_DIR, '.env'), mjAPIENV);
+        this.log('   Running npm link for GeneratedEntities...');
+        (0, node_child_process_1.execSync)('npm link ../GeneratedEntities', { stdio: 'inherit', cwd: MJAPI_DIR });
+        this.log('Running CodeGen...');
+        this.renameFolderToMJ_BASE(this.userConfig.dbDatabase);
+        // next, run CodeGen
+        // We do not manually run the compilation for GeneratedEntities because CodeGen handles that, but notice above that we did npm install for GeneratedEntities otherwise when CodeGen attempts to compile it, it will fail.
+        (0, node_child_process_1.execSync)('npx tsx src/index.ts', { stdio: 'inherit', cwd: CODEGEN_DIR });
+        // Process MJExplorer
+        this.log('\nProcessing MJExplorer...');
+        this.log('\n   Updating environment files...');
+        const config = {
+            CLIENT_ID: this.userConfig.msalWebClientId,
+            TENANT_ID: this.userConfig.msalTenantId,
+            CLIENT_AUTHORITY: this.userConfig.msalTenantId ? `https://login.microsoftonline.com/${this.userConfig.msalTenantId}` : '',
+            AUTH0_DOMAIN: this.userConfig.auth0Domain,
+            AUTH0_CLIENTID: this.userConfig.auth0ClientId,
+        };
+        await this.updateEnvironmentFiles(MJEXPLORER_DIR, config);
+        // keep on going with MJ Explorer - do the rest of the stuff
+        this.log('   Running npm install...');
+        (0, node_child_process_1.execSync)('npm install', { stdio: 'inherit', cwd: MJEXPLORER_DIR });
+        this.log('   Running npm link for GeneratedEntities...');
+        (0, node_child_process_1.execSync)('npm link ../GeneratedEntities', { stdio: 'inherit', cwd: MJEXPLORER_DIR });
+        this.log('Installation complete!');
+    }
+    async getUserConfiguration() {
+        let userConfig;
+        try {
+            const configObject = await fs.readJSON('install.config.json');
+            userConfig = configSchema.parse(configObject);
+        }
+        catch (e) {
+            if (e instanceof zod_1.ZodError) {
+                this.log(`Invalid config file found at '${node_path_1.default.join(fs.realpathSync('.'), 'install.config.json')}'${this.flags.verbose ? '' : ', retry with --verbose for details'}`);
+                if (this.flags.verbose) {
+                    console.table(e.issues);
+                }
+            }
+            else {
+                this.log(`No config file found at '${node_path_1.default.join(fs.realpathSync('.'), 'install.config.json')}'`);
+            }
+        }
+        if (!userConfig) {
+            this.log('\n>>> Please answer the following questions to setup the .env files for CodeGen. After this process you can manually edit the .env file in CodeGen as desired.');
+            const dbUrl = await (0, prompts_1.input)({ message: 'Enter the database server URL:' });
+            const dbInstance = await (0, prompts_1.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 (0, prompts_1.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 (0, prompts_1.input)({ message: 'Enter the database name on that server:' });
+            const dbPort = await (0, prompts_1.input)({
+                message: 'Enter the port the database server listens on',
+                validate: (v) => configSchema.shape.dbPort.safeParse(v).success,
+                default: '1433',
+            });
+            const codeGenLogin = await (0, prompts_1.input)({ message: 'Enter the database login for CodeGen:' });
+            const codeGenPwD = await (0, prompts_1.input)({ message: 'Enter the database password for CodeGen:' });
+            this.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 (0, prompts_1.input)({ message: 'Enter the database login for MJAPI:' });
+            const mjAPIPwD = await (0, prompts_1.input)({ message: 'Enter the database password for MJAPI:' });
+            const graphQLPort = await (0, prompts_1.input)({
+                message: 'Enter the port to use for the GraphQL API',
+                validate: (v) => configSchema.shape.graphQLPort.safeParse(v).success,
+                default: '4000',
+            });
+            const authType = await (0, prompts_1.select)({
+                message: 'Will you be using Microsoft Entra (formerly Azure AD), Auth0, or both for authentication services for MJAPI:',
+                choices: [
+                    { name: 'Microsoft Entra', value: 'MSAL' },
+                    { name: 'Auth0', value: 'AUTH0' },
+                    { name: 'Both', value: 'BOTH' },
+                ],
+            });
+            const msalTenantId = ['BOTH', 'MSAL'].includes(authType) ? await (0, prompts_1.input)({ message: 'Enter the web client ID for Entra:' }) : '';
+            const msalWebClientId = ['BOTH', 'MSAL'].includes(authType) ? await (0, prompts_1.input)({ message: 'Enter the tenant ID for Entra:' }) : '';
+            const auth0ClientId = ['BOTH', 'AUTH0'].includes(authType) ? await (0, prompts_1.input)({ message: 'Enter the client ID for Auth0:' }) : '';
+            const auth0ClientSecret = ['BOTH', 'AUTH0'].includes(authType) ? await (0, prompts_1.input)({ message: 'Enter the client secret for Auth0:' }) : '';
+            const auth0Domain = ['BOTH', 'AUTH0'].includes(authType) ? await (0, prompts_1.input)({ message: 'Enter the domain for Auth0:' }) : '';
+            const createNewUser = await (0, prompts_1.confirm)({ message: 'Do you want to create a new user in the database? (Y/N):' });
+            const userEmail = createNewUser
+                ? await (0, prompts_1.input)({
+                    message: 'Enter the new user email',
+                    validate: (v) => configSchema.shape.userEmail.safeParse(v).success,
+                })
+                : '';
+            const userFirstName = createNewUser ? await (0, prompts_1.input)({ message: 'Enter the new user first name:' }) : '';
+            const userLastName = createNewUser ? await (0, prompts_1.input)({ message: 'Enter the new user last name::' }) : '';
+            const userName = createNewUser
+                ? await (0, prompts_1.input)({ message: 'Enter the new user name (leave blank to use email):', default: userEmail })
+                : '';
+            const openAIAPIKey = await (0, prompts_1.input)({ message: 'Enter the OpenAI API Key (leave blank if not using):' });
+            const anthropicAPIKey = await (0, prompts_1.input)({ message: 'Enter the Anthropic API Key (leave blank if not using):' });
+            const mistralAPIKey = await (0, prompts_1.input)({ message: 'Enter the Mistral API Key (leave blank if not using):' });
+            userConfig = configSchema.parse({
+                dbUrl,
+                dbInstance,
+                dbTrustServerCertificate,
+                dbDatabase,
+                dbPort,
+                codeGenLogin,
+                codeGenPwD,
+                mjAPILogin,
+                mjAPIPwD,
+                graphQLPort,
+                authType,
+                msalWebClientId,
+                msalTenantId,
+                auth0ClientId,
+                auth0ClientSecret,
+                auth0Domain,
+                createNewUser: createNewUser ? 'Y' : 'N',
+                userEmail,
+                userFirstName,
+                userLastName,
+                userName,
+                openAIAPIKey,
+                anthropicAPIKey,
+                mistralAPIKey,
+            });
+        }
+        return userConfig;
+    }
+    /**
+     * Verifies that the specified directories exist.
+     * @param {...string} dirs - The directories to check.
+     */
+    verifyDirs(...dirs) {
+        dirs.forEach((dir) => {
+            if (!fs.existsSync(dir)) {
+                this.error(`Unable to locate required package at '${node_path_1.default.join(fs.realpathSync('.'), dir)}'`, {
+                    exit: 1,
+                    suggestions: ['Run the install from the same directory as the extracted MemberJunction distribution'],
+                });
+            }
+        });
+    }
+    /**
+     * Checks if there is at least `numGB` GB of free disk space.
+     * @param {number} numGB - The number of GB to check for.
+     * @returns {boolean} True if there is enough free disk space, false otherwise.
+     */
+    checkAvailableDiskSpace(numGB = 2) {
+        try {
+            this.log(`Checking for at least ${numGB}GB of free disk space...`);
+            // Define numGB GB in bytes
+            const GBToBytes = 1024 * 1024 * 1024;
+            const requiredSpace = numGB * GBToBytes;
+            let freeSpace;
+            if (node_os_1.default.platform() === 'win32') {
+                // For Windows, check the C: drive
+                const command = `wmic LogicalDisk where DeviceID="C:" get FreeSpace`;
+                const output = (0, node_child_process_1.execSync)(command).toString();
+                const lines = output.trim().split('\n');
+                freeSpace = parseInt(lines[1].trim());
+            }
+            else {
+                // For POSIX systems, check the root directory
+                const command = `df -k / | tail -1 | awk '{ print $4; }'`;
+                freeSpace = parseInt((0, node_child_process_1.execSync)(command).toString().trim()) * 1024;
+            }
+            if (freeSpace >= requiredSpace) {
+                this.log(`   Sufficient disk space available: ${Math.round(freeSpace / GBToBytes)} GB`);
+                return true;
+            }
+            else {
+                this.error(`Insufficient disk space. Required: ${requiredSpace} bytes, Available: ${Math.round(freeSpace / GBToBytes)} GB`, {
+                    exit: 1,
+                });
+            }
+        }
+        catch (error) {
+            this.logToStderr(this.toErrorJson(error));
+            this.error('Error checking disk space', { exit: 1 });
+        }
+    }
+    /**
+     * Updates environment files in a given directory.
+     * @param {string} dirPath - The path to the directory containing environment files.
+     * @param {object} config - The configuration object with values to update.
+     */
+    async updateEnvironmentFiles(dirPath, config) {
+        try {
+            // Define the pattern for environment files.
+            const envFilePattern = /environment.*\.ts$/;
+            // Read all files in the directory.
+            const files = await fs.readdir(dirPath);
+            // Filter for environment files.
+            const envFiles = files.filter((file) => envFilePattern.test(file));
+            // Update each environment file.
+            for (const file of envFiles) {
+                const filePath = node_path_1.default.join(dirPath, file);
+                const data = await fs.readFile(filePath, 'utf8');
+                // Replace the values in the file.
+                let updatedData = data;
+                Object.keys(config).forEach((key) => {
+                    const regex = new RegExp(`${key}:\\s*'.*?'`, 'g');
+                    updatedData = updatedData.replace(regex, `${key}: '${config[key]}'`);
+                });
+                // Write the updated data back to the file.
+                await fs.writeFile(filePath, updatedData, 'utf8');
+                this.log(`Updated ${file}`);
+            }
+        }
+        catch (err) {
+            console.error('Error:', err);
+        }
+    }
+    renameFolderToMJ_BASE(dbDatabase) {
+        // rename the MJ_BASE set of SQL Scripts to our new dbname
+        const oldFolderPath = node_path_1.default.join(SQL_SCRIPTS_DIR, GENERATED_DIR, MJ_BASE_DIR);
+        const newFolderPath = node_path_1.default.join(SQL_SCRIPTS_DIR, GENERATED_DIR, dbDatabase); // Assuming dbDatabase holds the new name
+        try {
+            fs.moveSync(oldFolderPath, newFolderPath);
+            this.log(`Renamed ${oldFolderPath} to ${newFolderPath} successfully.`);
+        }
+        catch (err) {
+            this.logToStderr(`An error occurred while renaming the '${oldFolderPath}' folder:`, err);
+        }
+    }
+    /**
+     * Updates newUserSetup in the config.json file.
+     * @param {string} dirPath - The path to the directory containing the config.json file.
+     * @param {string} userName - The new UserName to set.
+     * @param {string} firstName - The new FirstName to set.
+     * @param {string} lastName - The new LastName to set.
+     * @param {string} email - The new Email to set.
+     */
+    async updateConfigNewUserSetup(dirPath, userName, firstName, lastName, email) {
+        try {
+            const configFilePath = node_path_1.default.join(dirPath, 'config.json');
+            // Read the config.json file
+            const data = await fs.readFile(configFilePath, 'utf8');
+            const config = JSON.parse(data);
+            // Update the newUserSetup object
+            if (!config.newUserSetup)
+                config.newUserSetup = {};
+            config.newUserSetup.UserName = userName;
+            config.newUserSetup.FirstName = firstName;
+            config.newUserSetup.LastName = lastName;
+            config.newUserSetup.Email = email;
+            // Write the updated configuration back to config.json
+            await fs.writeFile(configFilePath, JSON.stringify(config, null, 2), 'utf8');
+            this.log(`      Updated config.json in ${dirPath}`);
+        }
+        catch (err) {
+            this.logToStderr('Error:', err);
+        }
+    }
+}
+exports.default = Install;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = void 0;
+var core_1 = require("@oclif/core");
+Object.defineProperty(exports, "run", { enumerable: true, get: function () { return core_1.run; } });

package/oclif.manifest.json

@@ -0,0 +1,37 @@
+{
+  "commands": {
+    "install": {
+      "aliases": [],
+      "args": {},
+      "description": "Install MemberJunction",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>\n"
+      ],
+      "flags": {
+        "verbose": {
+          "char": "v",
+          "description": "Enable additional logging",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "install",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "install",
+        "index.js"
+      ]
+    }
+  },
+  "version": "1.0.11"
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@memberjunction/cli",
+  "version": "1.0.11",
+  "description": "MemberJunction command line tools",
+  "keywords": [
+    "oclif"
+  ],
+  "homepage": "https://github.com/MemberJunction/MJ",
+  "bugs": {
+    "url": "https://github.com/MemberJunction/MJ/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MemberJunction/MJ.git"
+  },
+  "license": "ISC",
+  "author": "MemberJunction",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mj": "bin/run.js"
+  },
+  "files": [
+    "/bin",
+    "/dist",
+    "/oclif.manifest.json"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsc -b",
+    "prepack": "npm run build && oclif manifest && oclif readme",
+    "postpack": "rimraf oclif.manifest.json",
+    "version": "oclif readme && git add README.md"
+  },
+  "oclif": {
+    "bin": "mj",
+    "commands": "./dist/commands",
+    "dirname": "mj",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-warn-if-update-available",
+      "@oclif/plugin-version"
+    ],
+    "warn-if-update-available": {
+      "timeoutInDays": 1
+    }
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^5.0.1",
+    "@oclif/core": "^3",
+    "@oclif/plugin-help": "^6",
+    "@oclif/plugin-version": "^2.0.17",
+    "@oclif/plugin-warn-if-update-available": "^3.0.16",
+    "fs-extra": "^11.2.0",
+    "zod": "^3.23.4"
+  },
+  "devDependencies": {
+    "@oclif/prettier-config": "^0.2.1",
+    "@types/fs-extra": "^11.0.4",
+    "oclif": "^4",
+    "rimraf": "^5.0.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}