@swell/cli 2.1.0 → 2.2.1

package/dist/commands/app/dev.js

@@ -1,16 +1,17 @@
 import { Flags } from '@oclif/core';
-import ora from 'ora';
 import getPort, { portNumbers } from 'get-port';
+import { spawn } from 'node:child_process';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
 import * as http from 'node:http';
-import { spawn } from 'node:child_process';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import ora from 'ora';
 import { ConfigType, allConfigFilesInDir, appConfigFromFile, } from '../../lib/apps/index.js';
 import { bundleFunction } from '../../lib/bundle.js';
 import style from '../../lib/style.js';
 import { PushAppCommand } from '../../push-app-command.js';
 export default class AppDev extends PushAppCommand {
+    static delayOrientation = true;
     static examples = [
         'swell app dev',
         'swell app dev --storefront-id <id>',
@@ -36,16 +37,15 @@ export default class AppDev extends PushAppCommand {
             description: 'for storefront apps, prompt to select a storefront to preview',
         }),
     };
-    static summary = `Run an app in dev mode from your local machine.`;
-    static delayOrientation = true;
     static orientation = {
         env: 'test',
     };
-    // Directory for compiled function files and wrangler context
-    tmpDir = '';
+    static summary = `Run an app in dev mode from your local machine.`;
+    functionErrors = new Map();
     // All available functions
     functionPorts = new Map();
-    functionErrors = new Map();
+    // Directory for compiled function files and wrangler context
+    tmpDir = '';
     async run() {
         const { flags } = await this.parse(AppDev);
         const { port, 'frontend-port': frontendPort } = flags;
@@ -63,28 +63,6 @@ export default class AppDev extends PushAppCommand {
         await this.startAppFunctionServer(spinner, serverPort);
         await this.runAppFrontendDevIfApplicable(frontendPort);
     }
-    async startAppFunctionServer(spinner, serverPort) {
-        // Get all functions in this app
-        const functions = await this.getAppFunctions();
-        if (functions.length === 0) {
-            spinner.stop();
-            return;
-        }
-        // Create TMP directory for wrangler configs and bundled functions
-        await this.createTmpDirectory();
-        // Bundle functions and start wrangler dev servers for each
-        await this.startFunctionServers(functions);
-        // Start watching for function file changes
-        this.watchForChanges({
-            onChange: this.onChangeFunctionWatcher.bind(this),
-        });
-        // Create a routing server that proxies requests to function servers
-        await this.createFunctionRouter(serverPort);
-        spinner.succeed(`App function server running on port ${serverPort}\n`);
-        this.log(`${style.appConfigName(`Functions:`)}`);
-        await this.logAllFunctions(functions);
-        this.log(`${style.success('→')} Call functions at: http://localhost:${serverPort}/<function-name>\n`);
-    }
     async runAppFrontendDevIfApplicable(frontendPort) {
         const projectType = this.getFrontendProjectType(false);
         if (projectType) {
@@ -97,6 +75,72 @@ export default class AppDev extends PushAppCommand {
             return proxyPort;
         }
     }
+    async createFunctionRouter(serverPort) {
+        const server = http.createServer((req, res) => {
+            const url = new URL(req.url, `http://localhost:${serverPort}`);
+            const functionName = url.pathname.slice(1); // Remove leading slash
+            if (this.functionPorts.has(functionName)) {
+                const targetPort = this.functionPorts.get(functionName);
+                // Proxy the request to the function server
+                const proxyReq = http.request({
+                    hostname: 'localhost',
+                    port: targetPort,
+                    path: req.url,
+                    method: req.method,
+                    headers: {
+                        ...req.headers,
+                        'Swell-Local-Dev': 'true',
+                    },
+                }, (proxyRes) => {
+                    res.writeHead(proxyRes.statusCode, proxyRes.headers);
+                    proxyRes.pipe(res);
+                });
+                proxyReq.on('error', (error) => {
+                    res.writeHead(500);
+                    res.end(`Error proxying to function ${functionName}: ${error.message}`);
+                });
+                // Log when response is finished, method, status, and time to execute by proxy
+                const startTime = Date.now();
+                res.on('finish', async () => {
+                    const duration = Date.now() - startTime;
+                    // Log after a short delay to ensure output order
+                    await new Promise((r) => {
+                        setTimeout(r, 100);
+                    });
+                    this.log(`\n${style.appConfigValue(`→ ${functionName}`)} ${this.timestampStyled()} [${res.statusCode}] ${req.method} ${req.url} (${duration}ms)\n`);
+                });
+                req.pipe(proxyReq);
+            }
+            else {
+                res.writeHead(404);
+                const functionError = this.functionErrors.get(functionName);
+                const functionsAvailable = [...this.functionPorts.keys()];
+                res.end(functionError
+                    ? `Function Error: ${functionError}`
+                    : `Function '${functionName}' not found. ${functionsAvailable.length > 0
+                        ? `Available functions: ${[...this.functionPorts.keys()].join(', ')}`
+                        : ''}`);
+            }
+        });
+        server.listen(serverPort);
+    }
+    async createTmpDirectory() {
+        const tmpBase = path.join(os.tmpdir(), 'swell-cli');
+        const appTmpDir = path.join(tmpBase, this.app.id || 'unknown-app', 'functions');
+        // Create the directory structure
+        await fs.promises.mkdir(appTmpDir, { recursive: true });
+        this.tmpDir = appTmpDir;
+    }
+    generateWranglerConfig(functionName, bundledPath) {
+        return `
+name = "${functionName}"
+main = "${bundledPath}"
+compatibility_date = "2023-05-18"
+
+[vars]
+ENVIRONMENT = "development"
+`.trim();
+    }
     async getAppFunctions() {
         const functions = [];
         // Get all function files from the functions directory
@@ -109,13 +153,14 @@ export default class AppDev extends PushAppCommand {
                 functions.push(config);
             }
         }
-        catch (error) {
+        catch {
             // functions directory doesn't exist
         }
         return functions;
     }
     async logAllFunctions(functions) {
         for (const func of functions) {
+            // eslint-disable-next-line no-await-in-loop
             await this.logFunction(func);
         }
         this.log();
@@ -144,13 +189,16 @@ export default class AppDev extends PushAppCommand {
             }
             else if (config?.route) {
                 this.log(`    Trigger: Route`);
-                this.log(`    Methods: ${style.dim(config.route.methods
-                    .map((m) => String(m).toUpperCase())
-                    .join(', '))}`);
+                if (config.route.methods?.length) {
+                    this.log(`    Methods: ${style.dim(config.route.methods
+                        .map((m) => String(m).toUpperCase())
+                        .join(', '))}`);
+                }
                 if (config.route.headers) {
                     const headers = Object.entries(config.route.headers).map(([key, value]) => `${key}: ${value}`);
                     this.log(`    Headers:`);
-                    headers.forEach((header) => this.log(`      ${style.dim(header)}`));
+                    for (const header of headers)
+                        this.log(`      ${style.dim(header)}`);
                 }
                 if (config.route.cache?.timeout) {
                     this.log(`    Cache timeout: ${style.dim(config.route.cache.timeout)}`);
@@ -159,6 +207,9 @@ export default class AppDev extends PushAppCommand {
                     this.log(`    Public: ${style.dim('true')}`);
                 }
             }
+            if (config?.extension) {
+                this.log(`    Extension: ${style.dim(config.extension)}`);
+            }
             if (config?.description) {
                 this.log(`    Description: ${style.dim(config.description)}`);
             }
@@ -167,15 +218,68 @@ export default class AppDev extends PushAppCommand {
             this.log(`    ${style.error('Error loading config:', error.message)}`);
         }
     }
-    async createTmpDirectory() {
-        const tmpBase = path.join(os.tmpdir(), 'swell-cli');
-        const appTmpDir = path.join(tmpBase, this.app.id || 'unknown-app', 'functions');
-        // Create the directory structure
-        await fs.promises.mkdir(appTmpDir, { recursive: true });
-        this.tmpDir = appTmpDir;
+    async onChangeFunctionWatcher(appConfig, action, result) {
+        // If no result, skip
+        if (!result) {
+            return;
+        }
+        // If deleted result, skip and remove port
+        if (action === 'remove' || !result) {
+            this.functionPorts.delete(appConfig?.name);
+            this.log();
+            return;
+        }
+        // Skip everything except functions
+        if (appConfig?.type !== ConfigType.FUNCTION) {
+            return;
+        }
+        try {
+            const fullPath = path.join(this.appPath, appConfig.filePath);
+            // Re-bundle the function
+            const { code } = await bundleFunction(fullPath);
+            // Update the bundled file (wrangler dev will auto-reload)
+            const bundledPath = path.join(this.tmpDir, `${appConfig.name}.js`);
+            await fs.promises.writeFile(bundledPath, code);
+            if (this.functionPorts.has(appConfig.name)) {
+                this.log(`\nUpdating function ${appConfig.name}...`);
+            }
+            else {
+                this.log(`\nStarting function ${appConfig.name}...`);
+                await this.startFunctionServers([appConfig]);
+            }
+            await this.logFunction(appConfig);
+        }
+        catch (error) {
+            this.log(`${style.error('Error re-bundling function')} ${appConfig.name}: ${error.message}`);
+        }
+        this.log();
+    }
+    async startAppFunctionServer(spinner, serverPort) {
+        // Get all functions in this app
+        const functions = await this.getAppFunctions();
+        if (functions.length === 0) {
+            spinner.stop();
+            return;
+        }
+        // Create TMP directory for wrangler configs and bundled functions
+        await this.createTmpDirectory();
+        // Bundle functions and start wrangler dev servers for each
+        await this.startFunctionServers(functions);
+        // Start watching for function file changes
+        this.watchForChanges({
+            onChange: this.onChangeFunctionWatcher.bind(this),
+        });
+        // Create a routing server that proxies requests to function servers
+        await this.createFunctionRouter(serverPort);
+        spinner.succeed(`App function server running on port ${serverPort}\n`);
+        this.log(`${style.appConfigName(`Functions:`)}`);
+        await this.logAllFunctions(functions);
+        this.log(`${style.success('→')} Call functions at: http://localhost:${serverPort}/<function-name>\n`);
     }
     async startFunctionServers(functions) {
         const functionStatus = new Map();
+        const allocatedInspectorPorts = new Set();
+        /* eslint-disable no-await-in-loop */
         for (const func of functions) {
             const functionName = func.name;
             if (this.functionPorts.has(functionName)) {
@@ -183,6 +287,11 @@ export default class AppDev extends PushAppCommand {
                 continue;
             }
             const functionPort = await getPort({ port: portNumbers(9000, 9100) });
+            const inspectorPort = await getPort({
+                port: portNumbers(9229, 9329),
+                exclude: [...allocatedInspectorPorts],
+            });
+            allocatedInspectorPorts.add(inspectorPort);
             try {
                 // Bundle the function
                 const fullPath = path.join(this.appPath, func.filePath);
@@ -201,15 +310,16 @@ export default class AppDev extends PushAppCommand {
                     'dev',
                     `--config=${configPath}`,
                     `--port=${functionPort}`,
+                    `--inspector-port=${inspectorPort}`,
                 ], {
                     cwd: this.tmpDir,
-                    //stdio: 'pipe', // Capture output for debugging
+                    // stdio: 'pipe', // Capture output for debugging
                     detached: false,
                 });
                 const handleFunctionOutput = (data) => {
                     const output = data.toString();
                     // Remove ANSI escape sequences that cause line clearing
-                    const cleanOutput = output.replace('\u001b[2K\u001b[1A\u001b[2K\u001b[G', '');
+                    const cleanOutput = output.replace('\u001B[2K\u001B[1A\u001B[2K\u001B[G', '');
                     const lines = cleanOutput
                         .split('\n')
                         .filter((line) => line.trim());
@@ -262,6 +372,12 @@ export default class AppDev extends PushAppCommand {
                     functionStatus.set(functionName, 'error');
                     this.functionErrors.set(functionName, error.message);
                 });
+                wranglerProcess.on('exit', (code, _signal) => {
+                    if (functionStatus.get(functionName) === 'starting') {
+                        functionStatus.set(functionName, 'error');
+                        this.functionErrors.set(functionName, `Process exited with code ${code}`);
+                    }
+                });
                 // Store the port for routing
                 this.functionPorts.set(functionName, functionPort);
             }
@@ -270,13 +386,14 @@ export default class AppDev extends PushAppCommand {
                 this.functionErrors.set(functionName, error.message);
             }
         }
+        /* eslint-enable no-await-in-loop */
         await new Promise((resolve) => {
-            if (!functions.length) {
+            if (functions.length === 0) {
                 resolve();
                 return;
             }
             const checkAllRunning = () => {
-                const allRunning = Array.from(functionStatus.values()).every((status) => status !== 'starting');
+                const allRunning = [...functionStatus.values()].every((status) => status !== 'starting');
                 if (allRunning) {
                     resolve();
                 }
@@ -288,97 +405,4 @@ export default class AppDev extends PushAppCommand {
         });
         return { functionStatus };
     }
-    generateWranglerConfig(functionName, bundledPath) {
-        return `
-name = "${functionName}"
-main = "${bundledPath}"
-compatibility_date = "2023-05-18"
-
-[vars]
-ENVIRONMENT = "development"
-`.trim();
-    }
-    async createFunctionRouter(serverPort) {
-        const server = http.createServer((req, res) => {
-            const url = new URL(req.url, `http://localhost:${serverPort}`);
-            const functionName = url.pathname.slice(1); // Remove leading slash
-            if (this.functionPorts.has(functionName)) {
-                const targetPort = this.functionPorts.get(functionName);
-                // Proxy the request to the function server
-                const proxyReq = http.request({
-                    hostname: 'localhost',
-                    port: targetPort,
-                    path: req.url,
-                    method: req.method,
-                    headers: {
-                        ...req.headers,
-                        'Swell-Local-Dev': 'true',
-                    },
-                }, (proxyRes) => {
-                    res.writeHead(proxyRes.statusCode, proxyRes.headers);
-                    proxyRes.pipe(res);
-                });
-                proxyReq.on('error', (error) => {
-                    res.writeHead(500);
-                    res.end(`Error proxying to function ${functionName}: ${error.message}`);
-                });
-                // Log when response is finished, method, status, and time to execute by proxy
-                const startTime = Date.now();
-                res.on('finish', async () => {
-                    const duration = Date.now() - startTime;
-                    // Log after a short delay to ensure output order
-                    await new Promise((r) => setTimeout(r, 100));
-                    this.log(`\n${style.appConfigValue(`→ ${functionName}`)} ${this.timestampStyled()} [${res.statusCode}] ${req.method} ${req.url} (${duration}ms)\n`);
-                });
-                req.pipe(proxyReq);
-            }
-            else {
-                res.writeHead(404);
-                const functionError = this.functionErrors.get(functionName);
-                const functionsAvailable = Array.from(this.functionPorts.keys());
-                res.end(functionError
-                    ? `Function Error: ${functionError}`
-                    : `Function '${functionName}' not found. ${functionsAvailable.length > 0
-                        ? `Available functions: ${Array.from(this.functionPorts.keys()).join(', ')}`
-                        : ''}`);
-            }
-        });
-        server.listen(serverPort);
-    }
-    async onChangeFunctionWatcher(appConfig, action, result) {
-        // If no result, skip
-        if (!result) {
-            return;
-        }
-        // If deleted result, skip and remove port
-        if (action === 'remove' || !result) {
-            this.functionPorts.delete(appConfig?.name);
-            this.log();
-            return;
-        }
-        // Skip everything except functions
-        if (appConfig?.type !== ConfigType.FUNCTION) {
-            return;
-        }
-        try {
-            const fullPath = path.join(this.appPath, appConfig.filePath);
-            // Re-bundle the function
-            const { code } = await bundleFunction(fullPath);
-            // Update the bundled file (wrangler dev will auto-reload)
-            const bundledPath = path.join(this.tmpDir, `${appConfig.name}.js`);
-            await fs.promises.writeFile(bundledPath, code);
-            if (!this.functionPorts.has(appConfig.name)) {
-                this.log(`\nStarting function ${appConfig.name}...`);
-                await this.startFunctionServers([appConfig]);
-            }
-            else {
-                this.log(`\nUpdating function ${appConfig.name}...`);
-            }
-            await this.logFunction(appConfig);
-        }
-        catch (error) {
-            this.log(`${style.error('Error re-bundling function')} ${appConfig.name}: ${error.message}`);
-        }
-        this.log();
-    }
 }

package/dist/commands/app/frontend/dev.d.ts

@@ -14,7 +14,7 @@ export default class AppFrontendDev extends PushAppCommand {
         env: string;
     };
     static summary: string;
+    logAppLocalUrl(storeId: string, sessionId: string): void;
     run(): Promise<void>;
     private execFrontendProject;
-    logAppLocalUrl(storeId: string, sessionId: string): void;
 }

package/dist/commands/app/frontend/dev.js

@@ -33,6 +33,12 @@ export default class AppFrontendDev extends PushAppCommand {
         env: 'test',
     };
     static summary = `Run a frontend app in dev mode from your local machine.`;
+    logAppLocalUrl(storeId, sessionId) {
+        const frontendAppRoute = this.app.type === 'storefront' && this.app.storefront?.external
+            ? `/${this.app.private_id}`
+            : '';
+        this.log(`View it at ${style.link(`${this.localFrontendUrl(storeId, sessionId)}${frontendAppRoute}`)}\n`);
+    }
     async run() {
         const { flags } = await this.parse(AppFrontendDev);
         const { port, 'proxy-port': proxyPort, 'app-dev': isAppDev } = flags;
@@ -63,21 +69,21 @@ export default class AppFrontendDev extends PushAppCommand {
         let serverReadyDetected = false;
         await this.execFrontend(projectType.devCommand.replace('${PORT}', String(serverPort)), (string) => {
             // Framework-specific output handling and ready detection
-            if (projectType.slug === 'nextjs') {
-                // 1. NOISE FILTER: Hide unwanted output
-                if (string.includes('Using vars defined in .dev.vars')) {
-                    return false;
-                }
-                // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
-                if (/- Local:\s+http:\/\//i.test(string) ||
-                    /- Network:\s+http:\/\//i.test(string) ||
-                    /Ready on http:\/\/localhost/i.test(string)) {
-                    return false;
-                }
-                // 3. READY DETECTION: Detect server ready, show our message
-                if (!serverReadyDetected) {
-                    if (/✓ Ready in \d+/i.test(string) ||
-                        /✓ Starting/i.test(string)) {
+            switch (projectType.slug) {
+                case 'nextjs': {
+                    // 1. NOISE FILTER: Hide unwanted output
+                    if (string.includes('Using vars defined in .dev.vars')) {
+                        return false;
+                    }
+                    // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
+                    if (/- local:\s+http:\/\//i.test(string) ||
+                        /- network:\s+http:\/\//i.test(string) ||
+                        /ready on http:\/\/localhost/i.test(string)) {
+                        return false;
+                    }
+                    // 3. READY DETECTION: Detect server ready, show our message
+                    if (!serverReadyDetected &&
+                        (/✓ ready in \d+/.test(string) || /✓ starting/.test(string))) {
                         serverReadyDetected = true;
                         this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
                         const sessionId = localConfig.getSessionId(currentStore);
@@ -86,38 +92,16 @@ export default class AppFrontendDev extends PushAppCommand {
                             this.watchForChanges();
                         }
                     }
+                    break;
                 }
-            }
-            else if (projectType.slug === 'astro') {
-                // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
-                if (string.includes('┃ Local') ||
-                    string.includes('┃ Network')) {
-                    return false;
-                }
-                // 3. READY DETECTION: Detect server ready, show our message
-                if (!serverReadyDetected && /watching for file changes/i.test(string)) {
-                    serverReadyDetected = true;
-                    this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
-                    const sessionId = localConfig.getSessionId(currentStore);
-                    setTimeout(() => this.logAppLocalUrl(currentStore, sessionId), 100);
-                    if (!isAppDev) {
-                        this.watchForChanges();
+                case 'astro': {
+                    // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
+                    if (string.includes('┃ Local') || string.includes('┃ Network')) {
+                        return false;
                     }
-                }
-            }
-            else if (projectType.slug === 'angular') {
-                // 1. NOISE FILTER: Hide unwanted output
-                if (string.includes('press h + enter to show help')) {
-                    return false;
-                }
-                // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
-                if (/➜\s+Local:\s+http:\/\//i.test(string)) {
-                    return false;
-                }
-                // 3. READY DETECTION: Detect server ready, show our message
-                if (!serverReadyDetected) {
-                    if (/Application bundle generation complete/i.test(string) ||
-                        /Watch mode enabled/i.test(string)) {
+                    // 3. READY DETECTION: Detect server ready, show our message
+                    if (!serverReadyDetected &&
+                        /watching for file changes/i.test(string)) {
                         serverReadyDetected = true;
                         this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
                         const sessionId = localConfig.getSessionId(currentStore);
@@ -126,46 +110,68 @@ export default class AppFrontendDev extends PushAppCommand {
                             this.watchForChanges();
                         }
                     }
+                    break;
                 }
-            }
-            else if (projectType.slug === 'hono') {
-                // 2. URL FILTER: Hide localhost URLs (confusing - users should use Swell tunnel)
-                // Note: For Hono, the ready signal IS the URL line, so we handle both in section 3
-                // 3. READY DETECTION: Detect server ready, show our message, hide the URL
-                if (!serverReadyDetected && /Ready on http:\/\/localhost:\d+/i.test(string)) {
-                    serverReadyDetected = true;
-                    this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
-                    const sessionId = localConfig.getSessionId(currentStore);
-                    setTimeout(() => this.logAppLocalUrl(currentStore, sessionId), 100);
-                    if (!isAppDev) {
-                        this.watchForChanges();
+                case 'angular': {
+                    // 1. NOISE FILTER: Hide unwanted output
+                    if (string.includes('press h + enter to show help')) {
+                        return false;
+                    }
+                    // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
+                    if (/➜\s+local:\s+http:\/\//i.test(string)) {
+                        return false;
                     }
-                    return false; // Hide the "Ready on localhost" line
+                    // 3. READY DETECTION: Detect server ready, show our message
+                    if (!serverReadyDetected &&
+                        (/application bundle generation complete/.test(string) ||
+                            /watch mode enabled/.test(string))) {
+                        serverReadyDetected = true;
+                        this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
+                        const sessionId = localConfig.getSessionId(currentStore);
+                        setTimeout(() => this.logAppLocalUrl(currentStore, sessionId), 100);
+                        if (!isAppDev) {
+                            this.watchForChanges();
+                        }
+                    }
+                    break;
                 }
-            }
-            else if (projectType.slug === 'nuxt') {
-                // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
-                if (/➜ Local:\s+http:\/\//i.test(string) ||
-                    /➜ Network:/i.test(string)) {
-                    return false;
+                case 'hono': {
+                    // 2. URL FILTER: Hide localhost URLs (confusing - users should use Swell tunnel)
+                    // Note: For Hono, the ready signal IS the URL line, so we handle both in section 3
+                    // 3. READY DETECTION: Detect server ready, show our message, hide the URL
+                    if (!serverReadyDetected &&
+                        /ready on http:\/\/localhost:\d+/i.test(string)) {
+                        serverReadyDetected = true;
+                        this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
+                        const sessionId = localConfig.getSessionId(currentStore);
+                        setTimeout(() => this.logAppLocalUrl(currentStore, sessionId), 100);
+                        if (!isAppDev) {
+                            this.watchForChanges();
+                        }
+                        return false; // Hide the "Ready on localhost" line
+                    }
+                    break;
                 }
-                // 3. READY DETECTION: Detect server ready, show our message
-                if (!serverReadyDetected && /Nuxt \d+\.\d+\.\d+/i.test(string)) {
-                    serverReadyDetected = true;
-                    this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
-                    const sessionId = localConfig.getSessionId(currentStore);
-                    setTimeout(() => this.logAppLocalUrl(currentStore, sessionId), 100);
-                    if (!isAppDev) {
-                        this.watchForChanges();
+                case 'nuxt': {
+                    // 2. URL FILTER: Hide localhost/network URLs (confusing - users should use Swell tunnel)
+                    if (/➜ local:\s+http:\/\//i.test(string) ||
+                        /➜ network:/i.test(string)) {
+                        return false;
+                    }
+                    // 3. READY DETECTION: Detect server ready, show our message
+                    if (!serverReadyDetected && /nuxt \d+\.\d+\.\d+/i.test(string)) {
+                        serverReadyDetected = true;
+                        this.log(`Started ${projectType.name} dev server on port ${serverPort}.\n`);
+                        const sessionId = localConfig.getSessionId(currentStore);
+                        setTimeout(() => this.logAppLocalUrl(currentStore, sessionId), 100);
+                        if (!isAppDev) {
+                            this.watchForChanges();
+                        }
                     }
+                    break;
                 }
+                // No default
             }
         });
     }
-    logAppLocalUrl(storeId, sessionId) {
-        const frontendAppRoute = this.app.type === 'storefront' && this.app.storefront?.external
-            ? `/${this.app.private_id}`
-            : '';
-        this.log(`View it at ${style.link(`${this.localFrontendUrl(storeId, sessionId)}${frontendAppRoute}`)}\n`);
-    }
 }

package/dist/commands/app/install.js

@@ -2,8 +2,8 @@ import { confirm } from '@inquirer/prompts';
 import { Flags } from '@oclif/core';
 import ora from 'ora';
 import * as semver from 'semver';
-import config from '../../lib/config.js';
 import { readRcFile } from '../../lib/app-config.js';
+import config from '../../lib/config.js';
 import { selectEnvironmentId, selectLoggedInStoreId, } from '../../lib/stores.js';
 import style from '../../lib/style.js';
 import { RemoteAppCommand } from '../../remote-app-command.js';
@@ -48,7 +48,7 @@ Without a store specified, install the app in the Live environment of the curren
         if (versions.length === 0) {
             this.error(`${version ? `Version ${version} not found` : 'No versions found'} for ${style.appConfigValue(this.app.name)} app. ${version
                 ? ''
-                : `Create a version with the ${style.command('swell version')} command first.`}`);
+                : `Create a version with the ${style.command('swell app version')} command first.`}`);
         }
         const versionToInstall = version
             ? versions.find((ver) => ver.version === version)?.version
@@ -129,7 +129,7 @@ Without a store specified, install the app in the Live environment of the curren
             const sourceApp = await readRcFile(this.swellRcPath());
             sourceAppId = sourceApp?.id;
         }
-        catch (error) {
+        catch {
             // noop
         }
         const existingSourcedApps = sourceAppId