nstantpage-agent 0.5.0 → 0.5.1

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.1');
 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)')
@@ -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,45 @@ 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);
         console.log(chalk.green('✓ Already authenticated'));
+        if (email)
+            console.log(chalk.gray(`  Account: ${email}`));
         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 +110,12 @@ export async function loginCommand(options = {}) {
         }, 5 * 60 * 1000);
     });
     conf.set('token', token);
+    const email = getEmailFromToken(token);
+    if (email)
+        conf.set('email', email);
     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('  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,20 @@
+/**
+ * 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');
+    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,78 @@ 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
+    const gateway = options.gateway || '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.1';
 /**
  * Resolve the backend API base URL.
  * - If --backend is passed, use it
@@ -176,7 +176,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.1',
                 hostname: os.hostname(),
                 platform: `${os.platform()} ${os.arch()}`,
             },

package/dist/tunnel.js

@@ -62,7 +62,7 @@ export class TunnelClient {
                 // Send enhanced agent info with capabilities and deviceId
                 this.send({
                     type: 'agent-info',
-                    version: '0.5.0',
+                    version: '0.5.1',
                     hostname: os.hostname(),
                     platform: `${os.platform()} ${os.arch()}`,
                     deviceId: getDeviceId(),

package/package.json

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