@magentrix-corp/magentrix-cli 1.3.2 → 1.3.4

package/README.md

@@ -480,7 +480,7 @@ magentrix iris-link
 - `--cleanup` - Remove invalid (non-existent) linked projects
 
 **Menu options:**
-- Link a new Vue project
+- Link a Vue project
 - View all linked projects
 - Unlink a project
 - Cleanup invalid projects
@@ -503,17 +503,19 @@ magentrix vue-build-stage
 
 #### Vue Development Server
 ```bash
-magentrix iris-dev
+magentrix run-dev
 ```
 **What it does**: Starts the Vue development server with platform assets (CSS, fonts) automatically injected from your Magentrix instance.
 
+**Authentication**: Uses `VITE_REFRESH_TOKEN` from `.env.development` (no CLI authentication required). This command can be run inside the Vue project directory.
+
 **Options:**
 - `--path <dir>` - Specify Vue project path
 - `--no-inject` - Skip asset injection, just run dev server
 - `--restore` - Restore `.env.development` from backup without running
 
 **Process:**
-1. Fetch platform assets from Magentrix
+1. Fetch platform assets from Magentrix using `.env.development` credentials
 2. Backup `.env.development` and inject assets
 3. Run `npm run dev`
 4. Restore `.env.development` on exit (Ctrl+C)
@@ -577,7 +579,7 @@ export const config = {
 ```bash
 VITE_SITE_URL = https://yourinstance.magentrix.com
 VITE_REFRESH_TOKEN = your-api-key
-VITE_ASSETS = '[]'  # Injected automatically by iris-dev
+VITE_ASSETS = '[]'  # Injected automatically by run-dev
 ```
 
 **Accepted field names in config.ts:**
@@ -586,6 +588,19 @@ VITE_ASSETS = '[]'  # Injected automatically by iris-dev
 - Description: `appDescription` or `app_description`
 - Icon: `appIconId` or `app_icon_id`
 
+### Command Availability
+
+**In Vue project directories** (detected by presence of `config.ts`):
+- ✓ `magentrix iris-link` - Link project to CLI
+- ✓ `magentrix run-dev` - Start dev server (uses `.env.development` credentials)
+- ✓ `magentrix vue-build-stage` - Build and stage
+
+**In Magentrix workspace directories** (has `.magentrix/` folder):
+- ✓ All standard commands (`setup`, `pull`, `publish`, etc.)
+- ✓ All Iris commands (`iris-delete`, `iris-recover`, etc.)
+
+**Note**: Commands like `pull`, `publish`, `autopublish` require a Magentrix workspace and will show an error if run inside a Vue project directory.
+
 ### Typical Development Workflow
 
 ```bash
@@ -593,7 +608,7 @@ VITE_ASSETS = '[]'  # Injected automatically by iris-dev
 magentrix iris-link           # Link your Vue project
 
 # Development
-magentrix iris-dev            # Start dev server with platform assets
+magentrix run-dev             # Start dev server with platform assets
 # Make changes, test locally
 # Press Ctrl+C to stop
 
@@ -1058,7 +1073,7 @@ magentrix status        # Shows sync status
 - `magentrix update` - Update to latest version
 - `magentrix iris-link` - Link Vue.js projects for deployment
 - `magentrix vue-build-stage` - Build and stage Vue.js apps
-- `magentrix iris-dev` - Start Vue dev server with platform assets
+- `magentrix run-dev` - Start Vue dev server with platform assets
 - `magentrix iris-delete` - Delete an Iris app with recovery backup
 - `magentrix iris-recover` - Recover a deleted Iris app
 
@@ -1072,6 +1087,6 @@ Once you're comfortable with basic usage:
 2. **Learn the autopublish workflow** for faster development
 3. **Explore conflict resolution** if you work in a team
 4. **Check out templates** created by the `create` command to understand best practices
-5. **Deploy Vue.js apps** using `iris-link`, `vue-build-stage`, and `iris-dev` commands
+5. **Deploy Vue.js apps** using `iris-link`, `vue-build-stage`, and `run-dev` commands
 
 Happy coding with MagentrixCLI! 🚀

package/actions/iris/dev.js

@@ -13,22 +13,23 @@ import {
     getInjectionTarget
 } from '../../utils/iris/config-reader.js';
 import { getIrisAssets } from '../../utils/magentrix/api/iris.js';
+import { getAccessToken } from '../../utils/magentrix/api/auth.js';
 import {
     getLinkedProjectsWithStatus,
     buildProjectChoices
 } from '../../utils/iris/linker.js';
-import { ensureValidCredentials } from '../../utils/cli/helpers/ensureCredentials.js';
 
 /**
- * iris-dev command - Start Vue dev server with platform assets injected.
+ * run-dev command - Start Vue dev server with platform assets injected.
  *
- * Assets are injected into .env.development (if exists) or config.ts.
- * The modified file is backed up and restored when the dev server exits.
+ * Uses credentials from .env.development (VITE_REFRESH_TOKEN, VITE_SITE_URL).
+ * Assets are injected into .env.development only.
+ * The .env.development file is backed up and restored when the dev server exits.
  *
  * Options:
  *   --path <dir>      Specify Vue project path
  *   --no-inject       Skip asset injection, just run dev server
- *   --restore         Restore .env.development or config.ts from backup
+ *   --restore         Restore .env.development from backup
  */
 export const irisDev = async (options = {}) => {
     process.stdout.write('\x1Bc'); // Clear console
@@ -100,55 +101,57 @@ export const irisDev = async (options = {}) => {
 
     // Inject assets if enabled
     if (inject && siteUrl) {
-        console.log(chalk.blue('Fetching platform assets...'));
-
-        try {
-            // Get credentials for API call
-            const { instanceUrl, token } = await ensureValidCredentials();
-
-            // Use siteUrl from config if different from instanceUrl
-            const targetUrl = siteUrl || instanceUrl;
-
-            const assetsResult = await getIrisAssets(targetUrl, token.value);
-
-            if (assetsResult.success && assetsResult.assets?.length > 0) {
-                console.log(chalk.green(`\u2713 Found ${assetsResult.assets.length} platform assets`));
-
-                // Determine which file will be modified
-                const { targetFile, targetName } = getInjectionTarget(projectPath);
+        // Check if we have the refresh token for authentication
+        if (!vueConfig.refreshToken) {
+            console.log(chalk.yellow('Warning: VITE_REFRESH_TOKEN not set in .env.development'));
+            console.log(chalk.gray('Asset injection requires authentication. Continuing without assets.'));
+        } else {
+            console.log(chalk.blue('Fetching platform assets...'));
 
-                if (!targetFile) {
-                    console.log(chalk.yellow('Warning: No .env.development file found. Cannot inject assets.'));
-                    console.log(chalk.gray('Create a .env.development file to enable asset injection.'));
-                } else {
-                    modifiedFilePath = targetFile;
-                    modifiedFileName = targetName;
+            try {
+                // Get access token using the refresh token from .env.development
+                const tokenData = await getAccessToken(vueConfig.refreshToken, siteUrl);
+                const assetsResult = await getIrisAssets(siteUrl, tokenData.token);
 
-                    // Backup before modifying
-                    console.log(chalk.blue(`Backing up ${modifiedFileName}...`));
-                    backupPath = backupFile(modifiedFilePath);
-                    console.log(chalk.green(`\u2713 Backup created`));
+                if (assetsResult.success && assetsResult.assets?.length > 0) {
+                    console.log(chalk.green(`\u2713 Found ${assetsResult.assets.length} platform assets`));
 
-                    // Inject assets
-                    console.log(chalk.blue('Injecting assets...'));
-                    const injectResult = injectAssets(projectPath, assetsResult.assets);
+                    // Determine which file will be modified
+                    const { targetFile, targetName } = getInjectionTarget(projectPath);
 
-                    if (injectResult.success) {
-                        assetsInjected = true;
-                        console.log(chalk.green(`\u2713 Assets injected into ${injectResult.targetName}`));
+                    if (!targetFile) {
+                        console.log(chalk.yellow('Warning: No .env.development file found. Cannot inject assets.'));
+                        console.log(chalk.gray('Create a .env.development file to enable asset injection.'));
                     } else {
-                        console.log(chalk.yellow('Warning: Could not inject assets. Continuing without injection.'));
+                        modifiedFilePath = targetFile;
+                        modifiedFileName = targetName;
+
+                        // Backup before modifying
+                        console.log(chalk.blue(`Backing up ${modifiedFileName}...`));
+                        backupPath = backupFile(modifiedFilePath);
+                        console.log(chalk.green(`\u2713 Backup created`));
+
+                        // Inject assets
+                        console.log(chalk.blue('Injecting assets...'));
+                        const injectResult = injectAssets(projectPath, assetsResult.assets);
+
+                        if (injectResult.success) {
+                            assetsInjected = true;
+                            console.log(chalk.green(`\u2713 Assets injected into ${injectResult.targetName}`));
+                        } else {
+                            console.log(chalk.yellow('Warning: Could not inject assets. Continuing without injection.'));
+                        }
                     }
+                } else if (assetsResult.error) {
+                    console.log(chalk.yellow(`Warning: Could not fetch assets: ${assetsResult.error}`));
+                    console.log(chalk.gray('Continuing without asset injection.'));
+                } else {
+                    console.log(chalk.yellow('No platform assets found.'));
                 }
-            } else if (assetsResult.error) {
-                console.log(chalk.yellow(`Warning: Could not fetch assets: ${assetsResult.error}`));
+            } catch (err) {
+                console.log(chalk.yellow(`Warning: Error fetching assets: ${err.message}`));
                 console.log(chalk.gray('Continuing without asset injection.'));
-            } else {
-                console.log(chalk.yellow('No platform assets found.'));
             }
-        } catch (err) {
-            console.log(chalk.yellow(`Warning: Error fetching assets: ${err.message}`));
-            console.log(chalk.gray('Continuing without asset injection.'));
         }
     } else if (!inject) {
         console.log(chalk.gray('Skipping asset injection (--no-inject)'));
@@ -171,12 +174,13 @@ export const irisDev = async (options = {}) => {
  */
 async function runDevServer(projectPath, modifiedFilePath, modifiedFileName, backupPath, assetsInjected) {
     return new Promise((resolvePromise) => {
-        const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+        const isWindows = process.platform === 'win32';
+        const npmCmd = isWindows ? 'npm.cmd' : 'npm';
 
         const child = spawn(npmCmd, ['run', 'dev'], {
             cwd: projectPath,
             stdio: 'inherit',
-            shell: false
+            shell: isWindows  // Windows requires shell: true for .cmd files
         });
 
         // Handle cleanup on exit
@@ -314,7 +318,7 @@ async function selectProject() {
         console.log();
         console.log(chalk.gray('To get started:'));
         console.log(chalk.white(`  1. Link a Vue project: ${chalk.cyan('magentrix iris-link')}`));
-        console.log(chalk.white(`  2. Or specify path: ${chalk.cyan('magentrix iris-dev --path /path/to/vue-project')}`));
+        console.log(chalk.white(`  2. Or specify path: ${chalk.cyan('magentrix run-dev --path /path/to/vue-project')}`));
         console.log();
     }
 

package/actions/iris/link.js

@@ -77,9 +77,9 @@ async function showMainMenu() {
 
     const choices = [
         {
-            name: 'Link a new Vue project',
+            name: 'Link a Vue project',
             value: 'link',
-            description: 'Add a Vue project to the CLI'
+            description: chalk.dim('→ Add a Vue project to the CLI')
         }
     ];
 
@@ -87,12 +87,12 @@ async function showMainMenu() {
         choices.push({
             name: 'View linked projects',
             value: 'list',
-            description: 'Show all linked Vue projects with status'
+            description: chalk.dim('→ Show all linked Vue projects with status')
         });
         choices.push({
             name: 'Unlink a project',
             value: 'unlink',
-            description: 'Remove a Vue project from the CLI'
+            description: chalk.dim('→ Remove a Vue project from the CLI')
         });
     }
 
@@ -100,7 +100,7 @@ async function showMainMenu() {
         choices.push({
             name: `Clean up invalid projects (${invalidCount})`,
             value: 'cleanup',
-            description: 'Remove projects with missing paths'
+            description: chalk.dim('→ Remove projects with missing paths')
         });
     }
 
@@ -152,33 +152,31 @@ async function handleLink(pathOption) {
         if (cwdConfig.found && cwdConfig.errors.length === 0) {
             // Valid Vue project
             choices.push({
-                name: `Current directory - ${cwdConfig.appName} (${cwdConfig.slug})`,
+                name: `Current directory (${cwdPath})`,
                 value: cwdPath,
-                description: cwdPath
+                description: chalk.dim(`→ App: "${cwdConfig.appName}" (${cwdConfig.slug})`)
             });
         } else if (cwdConfig.found && cwdConfig.errors.length > 0) {
             // Has config.ts but with errors
             const errorMsg = cwdConfig.errors[0] || 'Invalid config';
             choices.push({
-                name: `Current directory`,
+                name: `Current directory (${cwdPath})`,
                 value: '__disabled__',
-                disabled: `Config error: ${errorMsg}`,
-                description: cwdPath
+                disabled: `Config error: ${errorMsg}`
             });
         } else {
             // No config.ts found
             choices.push({
-                name: `Current directory`,
+                name: `Current directory (${cwdPath})`,
                 value: '__disabled__',
-                disabled: 'No config.ts found',
-                description: cwdPath
+                disabled: 'No config.ts found'
             });
         }
 
         choices.push({
             name: 'Enter path manually',
             value: '__manual__',
-            description: 'Specify the full path to a Vue project'
+            description: chalk.dim('→ Specify the full path to a Vue project')
         });
 
         choices.push({
@@ -303,7 +301,7 @@ async function handleUnlink(pathOption) {
             return {
                 name: `${prefix}${displayName} (${displaySlug})`,
                 value: p.slug,
-                description: p.path
+                description: chalk.dim(`→ Path: ${p.path}`)
             };
         });
 

package/bin/magentrix.js

@@ -3,6 +3,8 @@
 // Imports
 import { Command } from 'commander';
 import chalk from 'chalk';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 import { VERSION } from '../vars/config.js';
 import { setup } from '../actions/setup.js';
 import { main } from '../actions/main.js';
@@ -17,6 +19,40 @@ import { update } from '../actions/update.js';
 import { configWizard } from '../actions/config.js';
 import { irisLink, irisDev, irisDelete, irisRecover, vueBuildStage } from '../actions/iris/index.js';
 
+// ── Vue Project Detection ────────────────────────────────
+/**
+ * Check if current directory is a Vue project (has config.ts)
+ */
+function isInVueProject() {
+    const configLocations = [
+        'src/config.ts',
+        'config.ts',
+        'src/iris-config.ts',
+        'iris-config.ts'
+    ];
+    return configLocations.some(loc => existsSync(join(process.cwd(), loc)));
+}
+
+/**
+ * Block non-iris commands when in a Vue project
+ */
+function requireMagentrixWorkspace(fn) {
+    return async (...args) => {
+        if (isInVueProject()) {
+            console.error(`\n${chalk.bgRed.white.bold(' ERROR ')} ${chalk.redBright('This command must be run in a Magentrix workspace')}\n`);
+            console.error(chalk.yellow('It looks like you\'re in a Vue project directory.'));
+            console.error(chalk.gray('This command requires a Magentrix workspace with global API key and instance URL.\n'));
+            console.error(chalk.cyan('Available commands in Vue projects:'));
+            console.error(chalk.gray('  • magentrix iris-link'));
+            console.error(chalk.gray('  • magentrix run-dev'));
+            console.error(chalk.gray('  • magentrix vue-build-stage\n'));
+            process.exit(1);
+        }
+        // Execute the command
+        await fn(...args);
+    };
+}
+
 // ── Middleware ────────────────────────────────
 async function preMiddleware() {
     await recacheFileIdIndex(EXPORT_ROOT);
@@ -32,6 +68,11 @@ const withMiddleware = ({ pre, post }) => (fn) => async (...args) => {
     if (post) await post(...args);
 };
 
+const withDefault = withMiddleware({ pre: preMiddleware, post: postMiddleware });
+
+// Combined wrapper: check for Vue project + run middleware
+const withWorkspaceCheck = (fn) => requireMagentrixWorkspace(withDefault(fn));
+
 // ── CLI Setup ────────────────────────────────
 const program = new Command();
 program
@@ -64,7 +105,7 @@ program
                 { name: 'update', desc: 'Update MagentrixCLI to the latest version', icon: '⬆️  ' },
                 { name: 'iris-link', desc: 'Link a Vue project to the CLI', icon: '🔗 ' },
                 { name: 'vue-build-stage', desc: 'Build Vue project and stage for publish', icon: '🏗️  ' },
-                { name: 'iris-dev', desc: 'Start Vue dev server with platform assets', icon: '🌐 ' },
+                { name: 'run-dev', desc: 'Start Vue dev server with platform assets', icon: '🌐 ' },
                 { name: 'iris-delete', desc: 'Delete an Iris app with backup', icon: '🗑️  ' },
                 { name: 'iris-recover', desc: 'Recover a deleted Iris app from backup', icon: '♻️  ' }
             ];
@@ -93,8 +134,6 @@ program
         }
     });
 
-const withDefault = withMiddleware({ pre: preMiddleware, post: postMiddleware });
-
 // ── Error Handlers ───────────────────────────
 program.showHelpAfterError(false);
 program.configureOutput({
@@ -128,8 +167,8 @@ program
     .description('Configure your Magentrix API key')
     .option('--api-key <apiKey>', 'Magentrix API key')
     .option('--instance-url <instanceUrl>', 'Magentrix instance URL (e.g., https://example.magentrixcloud.com)')
-    .action(withDefault(setup));
-program.command('pull').description('Pull files from the remote server').action(withDefault(pull));
+    .action(withWorkspaceCheck(setup));
+program.command('pull').description('Pull files from the remote server').action(withWorkspaceCheck(pull));
 const createCommand = program
     .command('create')
     .description('Create files locally')
@@ -138,7 +177,7 @@ const createCommand = program
     .option('--name <name>', 'Name of the file to create')
     .option('--description <description>', 'Optional description')
     .option('--entity-id <entityId>', 'Entity ID (required for triggers)')
-    .action(withDefault(create));
+    .action(withWorkspaceCheck(create));
 
 // Override help for create command to show options
 createCommand.configureHelp({
@@ -185,17 +224,17 @@ createCommand.configureHelp({
         return help;
     }
 });
-program.command('status').description('Show file conflicts').action(withDefault(status));
-program.command('autopublish').description('Watch & sync changes in real time').action(withDefault(autoPublish));
+program.command('status').description('Show file conflicts').action(withWorkspaceCheck(status));
+program.command('autopublish').description('Watch & sync changes in real time').action(withWorkspaceCheck(autoPublish));
 // Publish does its own comprehensive file scanning, so skip the pre-cache middleware
-program.command('publish').description('Publish pending changes to the remote server').action(withDefault(publish));
-program.command('update').description('Update MagentrixCLI to the latest version').action(update);
+program.command('publish').description('Publish pending changes to the remote server').action(withWorkspaceCheck(publish));
+program.command('update').description('Update MagentrixCLI to the latest version').action(requireMagentrixWorkspace(update));
 
 // Config command - interactive wizard
 program
     .command('config')
     .description('Configure CLI settings')
-    .action(configWizard);
+    .action(requireMagentrixWorkspace(configWizard));
 
 // Iris commands for Vue.js app management
 program
@@ -215,7 +254,7 @@ program
     .action(vueBuildStage);
 
 program
-    .command('iris-dev')
+    .command('run-dev')
     .description('Start Vue dev server with platform assets injected')
     .option('--path <path>', 'Path to the Vue project')
     .option('--no-inject', 'Skip asset injection')
@@ -236,6 +275,18 @@ program
 // ── Unknown Command Handler ──────────────────
 program.argument('[command]', 'command to run').action((cmd) => {
     const runMain = async () => {
+        // Check if in Vue project
+        if (isInVueProject()) {
+            console.error(`\n${chalk.bgRed.white.bold(' ERROR ')} ${chalk.redBright('This command must be run in a Magentrix workspace')}\n`);
+            console.error(chalk.yellow('It looks like you\'re in a Vue project directory.'));
+            console.error(chalk.gray('This command requires a Magentrix workspace with global API key and instance URL.\n'));
+            console.error(chalk.cyan('Available commands in Vue projects:'));
+            console.error(chalk.gray('  • magentrix iris-link'));
+            console.error(chalk.gray('  • magentrix run-dev'));
+            console.error(chalk.gray('  • magentrix vue-build-stage\n'));
+            process.exit(1);
+        }
+
         await preMiddleware();
         await main();
         await postMiddleware();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magentrix-corp/magentrix-cli",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "CLI tool for synchronizing local files with Magentrix cloud platform",
   "main": "index.js",
   "type": "module",