nstantpage-agent 0.5.0 → 0.5.2

package/dist/cli.js

@@ -17,20 +17,25 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
 import { loginCommand } from './commands/login.js';
+import { logoutCommand } from './commands/logout.js';
 import { startCommand } from './commands/start.js';
 import { statusCommand } from './commands/status.js';
-import { serviceInstallCommand, serviceUninstallCommand, serviceStatusCommand } from './commands/service.js';
+import { serviceInstallCommand, serviceUninstallCommand, serviceStatusCommand, serviceStartCommand, serviceStopCommand } from './commands/service.js';
 const program = new Command();
 program
     .name('nstantpage')
     .description('Local development agent for nstantpage.com — run projects on your machine, preview in the cloud')
-    .version('0.5.0');
+    .version('0.5.2');
 program
     .command('login')
     .description('Authenticate with nstantpage.com')
     .option('--gateway <url>', 'Gateway URL (auto-detects local vs production)')
     .option('--force', 'Re-authenticate even if already logged in')
     .action(loginCommand);
+program
+    .command('logout')
+    .description('Sign out and clear stored credentials')
+    .action(logoutCommand);
 program
     .command('start')
     .description('Start the agent for a project (replaces cloud containers)')
@@ -38,7 +43,7 @@ program
     .option('-p, --port <port>', 'Local dev server port', '3000')
     .option('-a, --api-port <port>', 'Local API server port (internal)', '18924')
     .option('--project-id <id>', 'Link to a specific project ID')
-    .option('--gateway <url>', 'Gateway URL', 'wss://webprev.live')
+    .option('--gateway <url>', 'Gateway URL (default: from login)')
     .option('--backend <url>', 'Backend API URL (auto-detected from gateway)')
     .option('--token <token>', 'Auth token (skip login flow)')
     .option('--dir <path>', 'Project directory override')
@@ -75,9 +80,18 @@ program
 const service = program
     .command('service')
     .description('Manage the background service (keeps your machine connected to nstantpage.com)');
+service
+    .command('start')
+    .description('Start the agent in standby mode (foreground — keeps your machine online)')
+    .option('--gateway <url>', 'Gateway URL', 'wss://webprev.live')
+    .action(serviceStartCommand);
+service
+    .command('stop')
+    .description('Stop the running agent')
+    .action(serviceStopCommand);
 service
     .command('install')
-    .description('Install & start the agent as a background service (starts on boot)')
+    .description('Install as a background service (auto-starts on boot)')
     .option('--gateway <url>', 'Gateway URL', 'wss://webprev.live')
     .action(serviceInstallCommand);
 service

package/dist/commands/login.js

@@ -16,13 +16,48 @@ function resolveFrontendUrl(gateway) {
     }
     return 'https://nstantpage.com';
 }
+/**
+ * Decode a JWT token payload (without verification — just reading claims).
+ */
+function decodeJwtPayload(token) {
+    try {
+        const parts = token.split('.');
+        if (parts.length !== 3)
+            return null;
+        const payload = Buffer.from(parts[1], 'base64').toString('utf-8');
+        return JSON.parse(payload);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract email from JWT claims.
+ * .NET uses long claim type URIs by default.
+ */
+function getEmailFromToken(token) {
+    const payload = decodeJwtPayload(token);
+    if (!payload)
+        return null;
+    return payload['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress']
+        || payload['email']
+        || payload['sub']
+        || null;
+}
 export async function loginCommand(options = {}) {
     const conf = getConfig();
     // Check if already logged in (unless --force)
     const existingToken = conf.get('token');
     if (existingToken && !options.force) {
+        const email = conf.get('email') || getEmailFromToken(existingToken);
+        const storedGateway = conf.get('gatewayUrl') || 'wss://webprev.live';
+        const isStoredLocal = /^wss?:\/\/(localhost|127\.0\.0\.1)/.test(storedGateway);
         console.log(chalk.green('✓ Already authenticated'));
+        if (email)
+            console.log(chalk.gray(`  Account: ${email}`));
+        console.log(chalk.gray(`  Server:  ${isStoredLocal ? 'localhost (dev)' : 'nstantpage.com'}`));
         console.log(chalk.gray('  Run "nstantpage login --force" to re-authenticate'));
+        console.log(chalk.gray('  Run "nstantpage logout" to sign out.'));
         return;
     }
     const frontendUrl = resolveFrontendUrl(options.gateway);
@@ -78,7 +113,21 @@ export async function loginCommand(options = {}) {
         }, 5 * 60 * 1000);
     });
     conf.set('token', token);
+    const email = getEmailFromToken(token);
+    if (email)
+        conf.set('email', email);
+    // Store the gateway URL used for this login so other commands use the matching server
+    if (options.gateway) {
+        // Convert ws:// to wss:// format for storage (login receives gateway URL)
+        conf.set('gatewayUrl', options.gateway);
+    }
+    else {
+        conf.set('gatewayUrl', 'wss://webprev.live');
+    }
     console.log(chalk.green('\n✓ Successfully authenticated!'));
-    console.log(chalk.gray('  Run "nstantpage start" to connect a project'));
+    if (email)
+        console.log(chalk.gray(`  Account: ${email}`));
+    console.log(chalk.gray(`  Server:  ${isLocal ? 'localhost (dev)' : 'nstantpage.com'}`));
+    console.log(chalk.gray('  Run "nstantpage start" to connect your machine'));
 }
 //# sourceMappingURL=login.js.map

package/dist/commands/logout.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Logout command — clear stored credentials
+ */
+export declare function logoutCommand(): Promise<void>;

package/dist/commands/logout.js

@@ -0,0 +1,21 @@
+/**
+ * Logout command — clear stored credentials
+ */
+import chalk from 'chalk';
+import { getConfig } from '../config.js';
+export async function logoutCommand() {
+    const conf = getConfig();
+    const email = conf.get('email');
+    conf.delete('token');
+    conf.delete('email');
+    conf.delete('projectId');
+    conf.delete('gatewayUrl');
+    if (email) {
+        console.log(chalk.green(`✓ Logged out (was: ${email})`));
+    }
+    else {
+        console.log(chalk.green('✓ Logged out'));
+    }
+    console.log(chalk.gray('  Run "nstantpage login" to authenticate again.'));
+}
+//# sourceMappingURL=logout.js.map

package/dist/commands/service.d.ts

@@ -18,6 +18,19 @@
 interface ServiceInstallOptions {
     gateway?: string;
 }
+interface ServiceStartOptions {
+    gateway?: string;
+}
+/**
+ * `nstantpage service start` — run agent in standby mode (foreground).
+ * This keeps your machine online and visible from the web UI.
+ * Projects are started via the web when you click "Connect".
+ */
+export declare function serviceStartCommand(options?: ServiceStartOptions): Promise<void>;
+/**
+ * `nstantpage service stop` — stop any running agent (PID-based or OS service).
+ */
+export declare function serviceStopCommand(): Promise<void>;
 export declare function serviceInstallCommand(options?: ServiceInstallOptions): Promise<void>;
 export declare function serviceUninstallCommand(): Promise<void>;
 export declare function serviceStatusCommand(): Promise<void>;

package/dist/commands/service.js

@@ -21,8 +21,79 @@ import path from 'path';
 import os from 'os';
 import { execSync } from 'child_process';
 import { getConfig } from '../config.js';
+import { startCommand } from './start.js';
 const PLIST_LABEL = 'com.nstantpage.agent';
 const SYSTEMD_SERVICE = 'nstantpage-agent';
+/**
+ * `nstantpage service start` — run agent in standby mode (foreground).
+ * This keeps your machine online and visible from the web UI.
+ * Projects are started via the web when you click "Connect".
+ */
+export async function serviceStartCommand(options = {}) {
+    const conf = getConfig();
+    const token = conf.get('token');
+    if (!token) {
+        console.log(chalk.red('✗ Not authenticated. Run "nstantpage login" first.'));
+        process.exit(1);
+    }
+    const email = conf.get('email');
+    if (email) {
+        console.log(chalk.gray(`  Account: ${email}`));
+    }
+    // Delegate to start command with no project-id → enters standby mode
+    // Use stored gateway from login, or explicit --gateway, or default
+    const gateway = options.gateway || conf.get('gatewayUrl') || 'wss://webprev.live';
+    await startCommand('.', {
+        port: '3000',
+        apiPort: '18924',
+        gateway,
+        token,
+    });
+}
+/**
+ * `nstantpage service stop` — stop any running agent (PID-based or OS service).
+ */
+export async function serviceStopCommand() {
+    const platform = os.platform();
+    let stopped = false;
+    // Try stopping OS service first
+    if (platform === 'darwin') {
+        const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${PLIST_LABEL}.plist`);
+        if (fs.existsSync(plistPath)) {
+            try {
+                execSync(`launchctl unload "${plistPath}" 2>/dev/null`, { encoding: 'utf-8' });
+                console.log(chalk.green('  ✓ Background service stopped'));
+                stopped = true;
+            }
+            catch { }
+        }
+    }
+    else if (platform === 'linux') {
+        try {
+            execSync(`systemctl --user stop ${SYSTEMD_SERVICE} 2>/dev/null`, { encoding: 'utf-8' });
+            console.log(chalk.green('  ✓ Background service stopped'));
+            stopped = true;
+        }
+        catch { }
+    }
+    // Also try PID-based stop from global config
+    const conf = getConfig();
+    const pid = conf.get('agentPid');
+    if (pid) {
+        try {
+            process.kill(pid, 'SIGTERM');
+            conf.delete('agentPid');
+            console.log(chalk.green('  ✓ Agent process stopped'));
+            stopped = true;
+        }
+        catch {
+            conf.delete('agentPid');
+        }
+    }
+    if (!stopped) {
+        console.log(chalk.yellow('  No running agent found.'));
+    }
+}
 export async function serviceInstallCommand(options = {}) {
     const conf = getConfig();
     const token = conf.get('token');

package/dist/commands/start.js

@@ -24,7 +24,7 @@ import { getConfig, getProjectConfig, setProjectConfig, clearProjectConfig, getD
 import { TunnelClient } from '../tunnel.js';
 import { LocalServer } from '../localServer.js';
 import { PackageInstaller } from '../packageInstaller.js';
-const VERSION = '0.5.0';
+const VERSION = '0.5.2';
 /**
  * Resolve the backend API base URL.
  * - If --backend is passed, use it
@@ -164,6 +164,10 @@ export async function startCommand(directory, options) {
     if (options.token) {
         conf.set('token', options.token);
     }
+    // Resolve gateway URL: explicit flag > stored from login > default
+    if (!options.gateway) {
+        options.gateway = conf.get('gatewayUrl') || 'wss://webprev.live';
+    }
     // Check authentication
     const isLocalGateway = /^wss?:\/\/(localhost|127\.0\.0\.1)/.test(options.gateway);
     let token = conf.get('token');
@@ -176,7 +180,8 @@ export async function startCommand(directory, options) {
         token = 'local-dev';
     }
     // Determine project ID (optional — without it, agent enters standby mode)
-    let projectId = options.projectId || conf.get('projectId');
+    // Only use explicitly passed --project-id, never fall back to stored value
+    let projectId = options.projectId;
     const backendUrl = resolveBackendUrl(options);
     const deviceId = getDeviceId();
     if (!projectId) {

package/dist/config.js

@@ -20,6 +20,7 @@ export function getConfig() {
             projectName: 'nstantpage-agent',
             schema: {
                 token: { type: 'string', default: '' },
+                email: { type: 'string', default: '' },
                 gatewayUrl: { type: 'string', default: 'wss://webprev.live' },
                 projectId: { type: 'string', default: '' },
                 // Legacy fields (kept for backward compat, but per-project config is preferred)

package/dist/localServer.js

@@ -502,7 +502,7 @@ export class LocalServer {
             connected: true,
             projectId: this.options.projectId,
             agent: {
-                version: '0.5.0',
+                version: '0.5.2',
                 hostname: os.hostname(),
                 platform: `${os.platform()} ${os.arch()}`,
             },

package/dist/tunnel.js

@@ -18,6 +18,7 @@
 import WebSocket from 'ws';
 import http from 'http';
 import os from 'os';
+import chalk from 'chalk';
 import { getDeviceId } from './config.js';
 import { getTerminalSession, attachTerminalClient } from './localServer.js';
 export class TunnelClient {
@@ -62,7 +63,7 @@ export class TunnelClient {
                 // Send enhanced agent info with capabilities and deviceId
                 this.send({
                     type: 'agent-info',
-                    version: '0.5.0',
+                    version: '0.5.2',
                     hostname: os.hostname(),
                     platform: `${os.platform()} ${os.arch()}`,
                     deviceId: getDeviceId(),
@@ -101,10 +102,23 @@ export class TunnelClient {
             });
             this.ws.on('error', (err) => {
                 clearTimeout(connectTimeout);
+                const msg = err.message || '';
+                // Detect 401 — token is invalid/expired/wrong-server. Stop retrying.
+                if (msg.includes('401')) {
+                    this.shouldReconnect = false;
+                    console.error(`  [Tunnel] Authentication failed (401)`);
+                    console.error(chalk.red(`  ✗ Your token was rejected by the gateway.`));
+                    console.error(chalk.gray(`    This usually means you need to re-login:`));
+                    console.error(chalk.gray(`      nstantpage logout && nstantpage login`));
+                    if (this.reconnectAttempts === 0) {
+                        reject(err);
+                    }
+                    return;
+                }
                 if (this.reconnectAttempts === 0) {
                     reject(err);
                 }
-                console.error(`  [Tunnel] Error: ${err.message}`);
+                console.error(`  [Tunnel] Error: ${msg}`);
             });
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nstantpage-agent",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Local development agent for nstantpage.com — run your projects locally, preview in the cloud. Replaces cloud containers for faster builds.",
   "type": "module",
   "bin": {