@magentrix-corp/magentrix-cli 1.3.16 → 1.3.17

package/actions/create.js

@@ -1,466 +1,466 @@
-import { ensureValidCredentials } from "../utils/cli/helpers/ensureCredentials.js";
-import { createEntity } from "../utils/magentrix/api/createEntity.js";
-import { search, select, input } from "@inquirer/prompts";
-import { listEntities } from "../utils/magentrix/api/retrieveEntity.js";
-import { getClassTemplate, getControllerTemplate, getPageTemplate, getTriggerTemplate } from "../utils/template.js";
-import { withSpinner } from "../utils/spinner.js";
-import { EXPORT_ROOT, TYPE_DIR_MAP } from "../vars/global.js";
-import path from "path";
-import fs from 'fs';
-import chalk from 'chalk';
-import { setFileTag } from "../utils/filetag.js";
-import { updateBase } from "../utils/updateFileBase.js";
-import { sha256 } from "../utils/hash.js";
-
-// Credentials and entity cache (module-scope for re-use during prompt session)
-let credentials = {};
-let triggerEntities = [];
-
-/**
- * Loads all entities from the Magentrix API and prepares them
- * for searchable selection in the CLI.
- * Populates the `triggerEntities` array.
- * 
- * @async
- * @returns {Promise<void>}
- */
-const loadEntities = async () => {
-    const entities = await listEntities(credentials.instanceUrl, credentials.token.value);
-    // Map to inquirer-friendly objects: { name, value }
-    triggerEntities = entities.map(entity => ({
-        label: entity.Label,
-        value: entity.Id,
-        name: entity.Name
-    }));
-};
-
-/**
- * Search function for entity selection using @inquirer/prompts.
- * Filters `triggerEntities` array based on the user's input term.
- * 
- * @async
- * @param {string} term - User's search input.
- * @returns {Promise<Array>} Filtered entity choices for prompt.
- */
-const searchEntities = async (term = '') => {
-    // Case-insensitive substring match against entity names
-    const filteredEntities = triggerEntities.filter(entity =>
-        entity.name.toLowerCase().includes(term.toLowerCase())
-    );
-
-    // Format for inquirer searchable prompt
-    return filteredEntities.map(entity => ({
-        name: `${entity.label} (${entity.value})`,
-        value: entity.value,
-        // Optionally: description: `Entity ID ${entity.value}`
-    }));
-};
-
-/**
- * CLI prompt flow for creating an ActiveClass record.
- *
- * - Prompts for type (Controller, Utility, or Trigger)
- * - For Trigger, also prompts for target entity selection (searchable)
- * - Prompts for class name and optional description
- *
- * @async
- * @param {Object} options - CLI options to bypass prompts
- * @returns {Promise<Object>} The creation payload for ActiveClass.
- */
-const createActiveClass = async (options = {}) => {
-    let classType = options.classType;
-
-    // Normalize class type from CLI format to internal format
-    if (classType) {
-        const typeMap = {
-            'controller': 'Controller',
-            'utility': 'Utility',
-            'class': 'Utility',
-            'trigger': 'Trigger'
-        };
-        classType = typeMap[classType.toLowerCase()] || classType;
-    }
-
-    if (!classType) {
-        classType = await select({
-            message: "Select ActiveClass type:",
-            choices: [
-                { name: "Controller", value: "Controller" },
-                { name: "Class", value: "Utility" },
-                { name: "Trigger", value: "Trigger" }
-            ]
-        });
-    }
-
-    if (classType === "Trigger") {
-        let entityId = options.entityId;
-
-        if (!entityId) {
-            // Ensure entity list is loaded for search prompt
-            await loadEntities();
-
-            entityId = await search({
-                message: "Search and select entity for this Trigger:",
-                source: searchEntities,
-                pageSize: 8
-            });
-        }
-
-        let className = options.name;
-        if (!className) {
-            className = await input({
-                message: "Trigger class name:",
-                validate: (input) => input.length > 0 || "Please enter a class name"
-            });
-        }
-
-        let description = options.description;
-        if (description === undefined) {
-            description = await input({
-                message: "Description (optional):"
-            });
-        }
-
-        return {
-            type: "ActiveClass",
-            classType,
-            triggerEntityId: entityId,
-            className,
-            description,
-        };
-    }
-
-    const hint = classType === "Controller" ? "(without controller keyword)" : ""
-
-    // Flow for Controller or Utility
-    let className = options.name;
-    if (!className) {
-        className = await input({
-            message: `${classType} class name ${hint}:`,
-            validate: (input) => input.length > 0 || "Please enter a class name"
-        });
-    }
-
-    let description = options.description;
-    if (description === undefined) {
-        description = await input({
-            message: "Description (optional):"
-        });
-    }
-
-    return {
-        type: "ActiveClass",
-        classType,
-        className,
-        description,
-    };
-};
-
-/**
- * CLI prompt flow for creating an ActivePage record.
- *
- * - Prompts for page name and optional description.
- *
- * @async
- * @param {Object} options - CLI options to bypass prompts
- * @param {string} options.pageType - Pre-determined page type (Page or Template)
- * @returns {Promise<Object>} The creation payload for ActivePage.
- */
-const createActivePage = async (options = {}) => {
-    let pageType = options.pageType;
-
-    // Normalize page type from CLI format to internal format
-    if (pageType) {
-        const typeMap = {
-            'page': 'Page',
-            'template': 'Template'
-        };
-        pageType = typeMap[pageType.toLowerCase()] || pageType;
-    }
-
-    if (!pageType) {
-        pageType = await select({
-            message: "Select ActivePage type:",
-            choices: [
-                { name: "Page", value: "Page" },
-                { name: "Template", value: "Template" }
-            ]
-        });
-    }
-
-    let pageName = options.name;
-    if (!pageName) {
-        pageName = await input({
-            message: `${pageType} name:`,
-            validate: (input) => input.length > 0 || `Please enter a ${pageType.toLowerCase()} name`
-        });
-    }
-
-    let description = options.description;
-    if (description === undefined) {
-        description = await input({
-            message: "Description (optional):"
-        });
-    }
-
-    return {
-        type: pageType,
-        pageName,
-        description,
-    };
-};
-
-/**
- * Saves the generated file content to the appropriate local folder.
- * @param {string} entityType
- * @param {object} formattedData
- * @param {string} recordId
- * @returns {Promise<string>} Full path of created file.
- */
-const saveToFile = async (entityType, formattedData, recordId) => {
-    let fileDir, fileExt, fileName, fileContent;
-
-    let mapKey; // fallback to Page
-    if (entityType === "ActivePage") {
-        mapKey = formattedData.Type || "Active Page";
-        fileDir = TYPE_DIR_MAP[mapKey].directory;
-        fileExt = TYPE_DIR_MAP[mapKey].extension;
-        fileName = `${formattedData.Name}.${fileExt}`;
-        fileContent = formattedData.Content || "";
-    } else {
-        mapKey = formattedData.Type || "Class"; // fallback to Class
-        fileDir = TYPE_DIR_MAP[mapKey].directory;
-        fileExt = TYPE_DIR_MAP[mapKey].extension;
-        fileName = `${formattedData.Name}.${fileExt}`;
-        fileContent = formattedData.Body || "";
-    }
-
-    // Ensure directory exists
-    const outputDir = path.join(process.cwd(), EXPORT_ROOT, fileDir);
-    fs.mkdirSync(outputDir, { recursive: true });
-
-    // Full file path
-    const filePath = path.join(outputDir, fileName);
-
-    // Write file
-    fs.writeFileSync(filePath, fileContent);
-
-    // Add a file tag so we can keep track of file changes
-    await setFileTag(filePath, recordId);
-
-    // Update base with content snapshot to ensure cache is in sync
-    const contentHash = sha256(fileContent);
-    updateBase(
-        filePath,
-        { Id: recordId, Type: mapKey },
-        '',
-        { content: fileContent, hash: contentHash }
-    );
-
-    return filePath;
-};
-
-/**
- * Main CLI handler for `magentrix create`.
- *
- * - Ensures valid Magentrix credentials.
- * - Prompts user to choose entity type (ActiveClass or ActivePage).
- * - Runs the appropriate prompt flow to gather data.
- * - Logs (or sends) the resulting payload.
- *
- * @async
- * @function create
- * @param {Object} cliOptions - Options passed from CLI flags
- * @returns {Promise<void>}
- */
-export const create = async (cliOptions = {}) => {
-    // Validate CLI options
-    if (cliOptions.type) {
-        const validTypes = ['class', 'page', 'template'];
-        if (!validTypes.includes(cliOptions.type.toLowerCase())) {
-            throw new Error(`Invalid --type: "${cliOptions.type}". Valid options are: ${validTypes.join(', ')}`);
-        }
-    }
-
-    if (cliOptions.classType) {
-        const validClassTypes = ['controller', 'utility', 'class', 'trigger'];
-        if (!validClassTypes.includes(cliOptions.classType.toLowerCase())) {
-            throw new Error(`Invalid --class-type: "${cliOptions.classType}". Valid options are: ${validClassTypes.join(', ')}`);
-        }
-
-        // Ensure --class-type is only used with --type class
-        if (cliOptions.type && cliOptions.type.toLowerCase() !== 'class') {
-            throw new Error('--class-type can only be used with --type class');
-        }
-    }
-
-    if (cliOptions.entityId) {
-        // Ensure --entity-id is only used with triggers
-        if (cliOptions.classType && cliOptions.classType.toLowerCase() !== 'trigger') {
-            throw new Error('--entity-id can only be used with --class-type trigger');
-        }
-        if (!cliOptions.classType) {
-            console.log(chalk.yellow('⚠️  Warning: --entity-id provided without --class-type trigger. It will be ignored unless you select Trigger interactively.'));
-        }
-    }
-
-    // Clear the terminal
-    process.stdout.write('\x1Bc');
-
-    // 1. Prompt for and validate Magentrix credentials
-    credentials = await withSpinner('Authenticating...', async () => {
-        return await ensureValidCredentials();
-    });
-
-    // 2. Determine entity type (from CLI or prompt)
-    let entityType;
-    let pageType;
-
-    if (cliOptions.type) {
-        const typeMap = {
-            'class': 'ActiveClass',
-            'page': 'ActivePage',
-            'template': 'ActivePage'
-        };
-        entityType = typeMap[cliOptions.type.toLowerCase()];
-
-        // If template was specified, set the pageType
-        if (cliOptions.type.toLowerCase() === 'template') {
-            pageType = 'Template';
-        } else if (cliOptions.type.toLowerCase() === 'page') {
-            pageType = 'Page';
-        }
-
-        if (!entityType) {
-            throw new Error(`Invalid type: ${cliOptions.type}. Valid types are: class, page, template`);
-        }
-    } else {
-        entityType = await select({
-            message: "What would you like to create?",
-            choices: [
-                { name: "ActiveClass (Controller, Class, Trigger)", value: "ActiveClass" },
-                { name: "ActivePage (ASPX Page)", value: "ActivePage" },
-            ]
-        });
-    }
-
-    // 3. Build payload via relevant prompt flow
-    let result;
-    if (entityType === 'ActiveClass') {
-        result = await createActiveClass(cliOptions);
-    } else if (entityType === 'ActivePage') {
-        result = await createActivePage({ ...cliOptions, pageType });
-    } else {
-        // Unknown
-        throw new Error("Unknown type selected.");
-    }
-
-    // 4. Display or send payload to Magentrix API
-    let formattedData;
-
-    if (entityType === "ActivePage") {
-        formattedData = {
-            Label: result.pageName,
-            Name: result.pageName,
-            Description: result.description || "",
-            Type: `Active ${result.type}`,
-            Content: getPageTemplate(result.pageName, result.pageName)
-        };
-    } else if (entityType === "ActiveClass") {
-        let name = result.className;
-
-        if (result.classType === "Controller") {
-            if (!name.endsWith("Controller")) name += "Controller";
-            formattedData = {
-                Name: name,
-                Body: getControllerTemplate(name),
-                Description: result.description || "",
-                Type: "Controller"
-            };
-        } else if (result.classType === "Utility" || result.classType === "Class") {
-            formattedData = {
-                Name: name,
-                Body: getClassTemplate(name),
-                Description: result.description || "",
-                Type: "Class"
-            };
-        } else if (result.classType === "Trigger") {
-            const selectedTriggerEntity = triggerEntities.find(entity => entity.value === result.triggerEntityId);
-
-            formattedData = {
-                Name: name,
-                Body: getTriggerTemplate(name, selectedTriggerEntity.name),
-                Description: result.description || "",
-                Type: "Trigger",
-                EntityId: result.triggerEntityId
-            };
-        }
-    }
-
-    console.log();
-
-    // Uncomment to perform creation via API:
-    const creationResponse = await withSpinner('Creating file...', async () => {
-        return await createEntity(
-            credentials.instanceUrl,
-            credentials.token.value,
-            entityType,
-            formattedData
-        ).catch(err => {
-            // The error object structure from fetchMagentrix:
-            // - err.type: 'network' | 'http' | 'api'
-            // - err.message: formatted error message
-            // - err.response: the API response data (if available)
-            // - err.status: HTTP status code (for http errors)
-            return {
-                hasErrors: true,
-                errorType: err.type,
-                errorMessage: err.message,
-                status: err.status,
-                statusText: err.statusText,
-                errors: err.response?.errors || err.response?.Errors || [],
-                rawResponse: err.response
-            };
-        });
-    });
-
-    if (creationResponse?.hasErrors) {
-        console.log();
-        console.log(chalk.bgRed.bold.white('  ✖ Creation Failed  '));
-        console.log(chalk.redBright('─'.repeat(48)));
-
-        // Display HTTP status if available
-        if (creationResponse.status) {
-            console.log(chalk.yellow(`  Status: ${creationResponse.status} ${creationResponse.statusText || ''}`));
-        }
-
-        const errors = creationResponse.errors || [];
-
-        if (errors.length > 0) {
-            errors.forEach((err) => {
-                const code = err.code ? chalk.gray(`[${err.code}] `) : '';
-                const msg = chalk.whiteBright(err.message || err);
-                console.log(`${chalk.redBright('  •')} ${code}${msg}`);
-            });
-        } else if (creationResponse.errorMessage) {
-            // Show the formatted error message from fetchMagentrix
-            console.log(chalk.red(creationResponse.errorMessage));
-        } else {
-            console.log(chalk.red('An unknown error occurred during creation.'));
-        }
-
-        return;
-    }
-
-    console.log(`✅ File successfully created on Magentrix server.`);
-
-    try {
-        const filePath = await saveToFile(entityType, formattedData, creationResponse.id);
-        console.log(`📄 Local copy saved at: ${filePath}`);
-        console.log('✨ You can now edit this file locally. Don\'t forget to push changes when ready!');
-    } catch (err) {
-        console.error(`🚨 Error: Unable to save file locally (${err.message}).`);
-        console.error('You may need to check directory permissions or disk space.');
-    }
-
-};
+import { ensureValidCredentials } from "../utils/cli/helpers/ensureCredentials.js";
+import { createEntity } from "../utils/magentrix/api/createEntity.js";
+import { search, select, input } from "@inquirer/prompts";
+import { listEntities } from "../utils/magentrix/api/retrieveEntity.js";
+import { getClassTemplate, getControllerTemplate, getPageTemplate, getTriggerTemplate } from "../utils/template.js";
+import { withSpinner } from "../utils/spinner.js";
+import { EXPORT_ROOT, TYPE_DIR_MAP } from "../vars/global.js";
+import path from "path";
+import fs from 'fs';
+import chalk from 'chalk';
+import { setFileTag } from "../utils/filetag.js";
+import { updateBase } from "../utils/updateFileBase.js";
+import { sha256 } from "../utils/hash.js";
+
+// Credentials and entity cache (module-scope for re-use during prompt session)
+let credentials = {};
+let triggerEntities = [];
+
+/**
+ * Loads all entities from the Magentrix API and prepares them
+ * for searchable selection in the CLI.
+ * Populates the `triggerEntities` array.
+ * 
+ * @async
+ * @returns {Promise<void>}
+ */
+const loadEntities = async () => {
+    const entities = await listEntities(credentials.instanceUrl, credentials.token.value);
+    // Map to inquirer-friendly objects: { name, value }
+    triggerEntities = entities.map(entity => ({
+        label: entity.Label,
+        value: entity.Id,
+        name: entity.Name
+    }));
+};
+
+/**
+ * Search function for entity selection using @inquirer/prompts.
+ * Filters `triggerEntities` array based on the user's input term.
+ * 
+ * @async
+ * @param {string} term - User's search input.
+ * @returns {Promise<Array>} Filtered entity choices for prompt.
+ */
+const searchEntities = async (term = '') => {
+    // Case-insensitive substring match against entity names
+    const filteredEntities = triggerEntities.filter(entity =>
+        entity.name.toLowerCase().includes(term.toLowerCase())
+    );
+
+    // Format for inquirer searchable prompt
+    return filteredEntities.map(entity => ({
+        name: `${entity.label} (${entity.value})`,
+        value: entity.value,
+        // Optionally: description: `Entity ID ${entity.value}`
+    }));
+};
+
+/**
+ * CLI prompt flow for creating an ActiveClass record.
+ *
+ * - Prompts for type (Controller, Utility, or Trigger)
+ * - For Trigger, also prompts for target entity selection (searchable)
+ * - Prompts for class name and optional description
+ *
+ * @async
+ * @param {Object} options - CLI options to bypass prompts
+ * @returns {Promise<Object>} The creation payload for ActiveClass.
+ */
+const createActiveClass = async (options = {}) => {
+    let classType = options.classType;
+
+    // Normalize class type from CLI format to internal format
+    if (classType) {
+        const typeMap = {
+            'controller': 'Controller',
+            'utility': 'Utility',
+            'class': 'Utility',
+            'trigger': 'Trigger'
+        };
+        classType = typeMap[classType.toLowerCase()] || classType;
+    }
+
+    if (!classType) {
+        classType = await select({
+            message: "Select ActiveClass type:",
+            choices: [
+                { name: "Controller", value: "Controller" },
+                { name: "Class", value: "Utility" },
+                { name: "Trigger", value: "Trigger" }
+            ]
+        });
+    }
+
+    if (classType === "Trigger") {
+        let entityId = options.entityId;
+
+        if (!entityId) {
+            // Ensure entity list is loaded for search prompt
+            await loadEntities();
+
+            entityId = await search({
+                message: "Search and select entity for this Trigger:",
+                source: searchEntities,
+                pageSize: 8
+            });
+        }
+
+        let className = options.name;
+        if (!className) {
+            className = await input({
+                message: "Trigger class name:",
+                validate: (input) => input.length > 0 || "Please enter a class name"
+            });
+        }
+
+        let description = options.description;
+        if (description === undefined) {
+            description = await input({
+                message: "Description (optional):"
+            });
+        }
+
+        return {
+            type: "ActiveClass",
+            classType,
+            triggerEntityId: entityId,
+            className,
+            description,
+        };
+    }
+
+    const hint = classType === "Controller" ? "(without controller keyword)" : ""
+
+    // Flow for Controller or Utility
+    let className = options.name;
+    if (!className) {
+        className = await input({
+            message: `${classType} class name ${hint}:`,
+            validate: (input) => input.length > 0 || "Please enter a class name"
+        });
+    }
+
+    let description = options.description;
+    if (description === undefined) {
+        description = await input({
+            message: "Description (optional):"
+        });
+    }
+
+    return {
+        type: "ActiveClass",
+        classType,
+        className,
+        description,
+    };
+};
+
+/**
+ * CLI prompt flow for creating an ActivePage record.
+ *
+ * - Prompts for page name and optional description.
+ *
+ * @async
+ * @param {Object} options - CLI options to bypass prompts
+ * @param {string} options.pageType - Pre-determined page type (Page or Template)
+ * @returns {Promise<Object>} The creation payload for ActivePage.
+ */
+const createActivePage = async (options = {}) => {
+    let pageType = options.pageType;
+
+    // Normalize page type from CLI format to internal format
+    if (pageType) {
+        const typeMap = {
+            'page': 'Page',
+            'template': 'Template'
+        };
+        pageType = typeMap[pageType.toLowerCase()] || pageType;
+    }
+
+    if (!pageType) {
+        pageType = await select({
+            message: "Select ActivePage type:",
+            choices: [
+                { name: "Page", value: "Page" },
+                { name: "Template", value: "Template" }
+            ]
+        });
+    }
+
+    let pageName = options.name;
+    if (!pageName) {
+        pageName = await input({
+            message: `${pageType} name:`,
+            validate: (input) => input.length > 0 || `Please enter a ${pageType.toLowerCase()} name`
+        });
+    }
+
+    let description = options.description;
+    if (description === undefined) {
+        description = await input({
+            message: "Description (optional):"
+        });
+    }
+
+    return {
+        type: pageType,
+        pageName,
+        description,
+    };
+};
+
+/**
+ * Saves the generated file content to the appropriate local folder.
+ * @param {string} entityType
+ * @param {object} formattedData
+ * @param {string} recordId
+ * @returns {Promise<string>} Full path of created file.
+ */
+const saveToFile = async (entityType, formattedData, recordId) => {
+    let fileDir, fileExt, fileName, fileContent;
+
+    let mapKey; // fallback to Page
+    if (entityType === "ActivePage") {
+        mapKey = formattedData.Type || "Active Page";
+        fileDir = TYPE_DIR_MAP[mapKey].directory;
+        fileExt = TYPE_DIR_MAP[mapKey].extension;
+        fileName = `${formattedData.Name}.${fileExt}`;
+        fileContent = formattedData.Content || "";
+    } else {
+        mapKey = formattedData.Type || "Class"; // fallback to Class
+        fileDir = TYPE_DIR_MAP[mapKey].directory;
+        fileExt = TYPE_DIR_MAP[mapKey].extension;
+        fileName = `${formattedData.Name}.${fileExt}`;
+        fileContent = formattedData.Body || "";
+    }
+
+    // Ensure directory exists
+    const outputDir = path.join(process.cwd(), EXPORT_ROOT, fileDir);
+    fs.mkdirSync(outputDir, { recursive: true });
+
+    // Full file path
+    const filePath = path.join(outputDir, fileName);
+
+    // Write file
+    fs.writeFileSync(filePath, fileContent);
+
+    // Add a file tag so we can keep track of file changes
+    await setFileTag(filePath, recordId);
+
+    // Update base with content snapshot to ensure cache is in sync
+    const contentHash = sha256(fileContent);
+    updateBase(
+        filePath,
+        { Id: recordId, Type: mapKey },
+        '',
+        { content: fileContent, hash: contentHash }
+    );
+
+    return filePath;
+};
+
+/**
+ * Main CLI handler for `magentrix create`.
+ *
+ * - Ensures valid Magentrix credentials.
+ * - Prompts user to choose entity type (ActiveClass or ActivePage).
+ * - Runs the appropriate prompt flow to gather data.
+ * - Logs (or sends) the resulting payload.
+ *
+ * @async
+ * @function create
+ * @param {Object} cliOptions - Options passed from CLI flags
+ * @returns {Promise<void>}
+ */
+export const create = async (cliOptions = {}) => {
+    // Validate CLI options
+    if (cliOptions.type) {
+        const validTypes = ['class', 'page', 'template'];
+        if (!validTypes.includes(cliOptions.type.toLowerCase())) {
+            throw new Error(`Invalid --type: "${cliOptions.type}". Valid options are: ${validTypes.join(', ')}`);
+        }
+    }
+
+    if (cliOptions.classType) {
+        const validClassTypes = ['controller', 'utility', 'class', 'trigger'];
+        if (!validClassTypes.includes(cliOptions.classType.toLowerCase())) {
+            throw new Error(`Invalid --class-type: "${cliOptions.classType}". Valid options are: ${validClassTypes.join(', ')}`);
+        }
+
+        // Ensure --class-type is only used with --type class
+        if (cliOptions.type && cliOptions.type.toLowerCase() !== 'class') {
+            throw new Error('--class-type can only be used with --type class');
+        }
+    }
+
+    if (cliOptions.entityId) {
+        // Ensure --entity-id is only used with triggers
+        if (cliOptions.classType && cliOptions.classType.toLowerCase() !== 'trigger') {
+            throw new Error('--entity-id can only be used with --class-type trigger');
+        }
+        if (!cliOptions.classType) {
+            console.log(chalk.yellow('⚠️  Warning: --entity-id provided without --class-type trigger. It will be ignored unless you select Trigger interactively.'));
+        }
+    }
+
+    // Clear the terminal
+    process.stdout.write('\x1Bc');
+
+    // 1. Prompt for and validate Magentrix credentials
+    credentials = await withSpinner('Authenticating...', async () => {
+        return await ensureValidCredentials();
+    });
+
+    // 2. Determine entity type (from CLI or prompt)
+    let entityType;
+    let pageType;
+
+    if (cliOptions.type) {
+        const typeMap = {
+            'class': 'ActiveClass',
+            'page': 'ActivePage',
+            'template': 'ActivePage'
+        };
+        entityType = typeMap[cliOptions.type.toLowerCase()];
+
+        // If template was specified, set the pageType
+        if (cliOptions.type.toLowerCase() === 'template') {
+            pageType = 'Template';
+        } else if (cliOptions.type.toLowerCase() === 'page') {
+            pageType = 'Page';
+        }
+
+        if (!entityType) {
+            throw new Error(`Invalid type: ${cliOptions.type}. Valid types are: class, page, template`);
+        }
+    } else {
+        entityType = await select({
+            message: "What would you like to create?",
+            choices: [
+                { name: "ActiveClass (Controller, Class, Trigger)", value: "ActiveClass" },
+                { name: "ActivePage (ASPX Page)", value: "ActivePage" },
+            ]
+        });
+    }
+
+    // 3. Build payload via relevant prompt flow
+    let result;
+    if (entityType === 'ActiveClass') {
+        result = await createActiveClass(cliOptions);
+    } else if (entityType === 'ActivePage') {
+        result = await createActivePage({ ...cliOptions, pageType });
+    } else {
+        // Unknown
+        throw new Error("Unknown type selected.");
+    }
+
+    // 4. Display or send payload to Magentrix API
+    let formattedData;
+
+    if (entityType === "ActivePage") {
+        formattedData = {
+            Label: result.pageName,
+            Name: result.pageName,
+            Description: result.description || "",
+            Type: `Active ${result.type}`,
+            Content: getPageTemplate(result.pageName, result.pageName)
+        };
+    } else if (entityType === "ActiveClass") {
+        let name = result.className;
+
+        if (result.classType === "Controller") {
+            if (!name.endsWith("Controller")) name += "Controller";
+            formattedData = {
+                Name: name,
+                Body: getControllerTemplate(name),
+                Description: result.description || "",
+                Type: "Controller"
+            };
+        } else if (result.classType === "Utility" || result.classType === "Class") {
+            formattedData = {
+                Name: name,
+                Body: getClassTemplate(name),
+                Description: result.description || "",
+                Type: "Class"
+            };
+        } else if (result.classType === "Trigger") {
+            const selectedTriggerEntity = triggerEntities.find(entity => entity.value === result.triggerEntityId);
+
+            formattedData = {
+                Name: name,
+                Body: getTriggerTemplate(name, selectedTriggerEntity.name),
+                Description: result.description || "",
+                Type: "Trigger",
+                EntityId: result.triggerEntityId
+            };
+        }
+    }
+
+    console.log();
+
+    // Uncomment to perform creation via API:
+    const creationResponse = await withSpinner('Creating file...', async () => {
+        return await createEntity(
+            credentials.instanceUrl,
+            credentials.token.value,
+            entityType,
+            formattedData
+        ).catch(err => {
+            // The error object structure from fetchMagentrix:
+            // - err.type: 'network' | 'http' | 'api'
+            // - err.message: formatted error message
+            // - err.response: the API response data (if available)
+            // - err.status: HTTP status code (for http errors)
+            return {
+                hasErrors: true,
+                errorType: err.type,
+                errorMessage: err.message,
+                status: err.status,
+                statusText: err.statusText,
+                errors: err.response?.errors || err.response?.Errors || [],
+                rawResponse: err.response
+            };
+        });
+    });
+
+    if (creationResponse?.hasErrors) {
+        console.log();
+        console.log(chalk.bgRed.bold.white('  ✖ Creation Failed  '));
+        console.log(chalk.redBright('─'.repeat(48)));
+
+        // Display HTTP status if available
+        if (creationResponse.status) {
+            console.log(chalk.yellow(`  Status: ${creationResponse.status} ${creationResponse.statusText || ''}`));
+        }
+
+        const errors = creationResponse.errors || [];
+
+        if (errors.length > 0) {
+            errors.forEach((err) => {
+                const code = err.code ? chalk.gray(`[${err.code}] `) : '';
+                const msg = chalk.whiteBright(err.message || err);
+                console.log(`${chalk.redBright('  •')} ${code}${msg}`);
+            });
+        } else if (creationResponse.errorMessage) {
+            // Show the formatted error message from fetchMagentrix
+            console.log(chalk.red(creationResponse.errorMessage));
+        } else {
+            console.log(chalk.red('An unknown error occurred during creation.'));
+        }
+
+        return;
+    }
+
+    console.log(`✅ File successfully created on Magentrix server.`);
+
+    try {
+        const filePath = await saveToFile(entityType, formattedData, creationResponse.id);
+        console.log(`📄 Local copy saved at: ${filePath}`);
+        console.log('✨ You can now edit this file locally. Don\'t forget to push changes when ready!');
+    } catch (err) {
+        console.error(`🚨 Error: Unable to save file locally (${err.message}).`);
+        console.error('You may need to check directory permissions or disk space.');
+    }
+
+};