nstantpage-agent 0.8.0 → 0.8.2

package/dist/cli.js

@@ -22,6 +22,7 @@ import { startCommand } from './commands/start.js';
 import { statusCommand } from './commands/status.js';
 import { serviceInstallCommand, serviceUninstallCommand, serviceStatusCommand, serviceStartCommand, serviceStopCommand } from './commands/service.js';
 import { updateCommand } from './commands/update.js';
+import { runCommand } from './commands/run.js';
 import { syncCommand } from './commands/sync.js';
 import { getPackageVersion } from './version.js';
 const program = new Command();
@@ -32,6 +33,7 @@ program
 program
     .command('login')
     .description('Authenticate with nstantpage.com')
+    .option('--local [port]', 'Authenticate with local backend (default: 5001)')
     .option('--gateway <url>', 'Gateway URL (auto-detects local vs production)')
     .option('--force', 'Re-authenticate even if already logged in')
     .action(loginCommand);
@@ -45,6 +47,7 @@ program
     .argument('[directory]', 'Project directory (defaults to ~/.nstantpage/projects/<id>)', '.')
     .option('-p, --port <port>', 'Local dev server port', '3000')
     .option('-a, --api-port <port>', 'Local API server port (internal)', '18924')
+    .option('--local [port]', 'Connect to local backend (default: 5001)')
     .option('--project-id <id>', 'Link to a specific project ID')
     .option('--gateway <url>', 'Gateway URL (default: from login)')
     .option('--backend <url>', 'Backend API URL (auto-detected from gateway)')
@@ -52,17 +55,19 @@ program
     .option('--dir <path>', 'Project directory override')
     .option('--no-dev', 'Skip starting the dev server (start manually later)')
     .action(startCommand);
+program
+    .command('run')
+    .description('Install background service and start the agent')
+    .option('--local [port]', 'Connect to local backend (default: 5001)')
+    .action(runCommand);
 program
     .command('sync')
-    .description('Sync local directory to nstantpage and start agent')
+    .description('Sync local directory files to nstantpage database')
     .argument('[directory]', 'Project directory to sync (defaults to current directory)', '.')
-    .option('-p, --port <port>', 'Local dev server port', '3000')
-    .option('-a, --api-port <port>', 'Local API server port', '18924')
     .option('--local [port]', 'Sync to local backend (default: localhost:5001)')
     .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('--no-start', 'Only sync files, do not start the agent')
     .action(syncCommand);
 program
     .command('stop')
@@ -121,5 +126,14 @@ program
     .command('update')
     .description('Update CLI to the latest version')
     .action(updateCommand);
+program
+    .command('logs')
+    .description('Show agent log output')
+    .option('-f, --follow', 'Follow log output (like tail -f)')
+    .option('-n, --lines <count>', 'Number of lines to show', '50')
+    .action(async (options) => {
+    const { logsCommand } = await import('./commands/logs.js');
+    await logsCommand(options);
+});
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/commands/login.d.ts

@@ -2,6 +2,7 @@
  * Login command — authenticate with nstantpage.com
  */
 interface LoginOptions {
+    local?: string | boolean;
     gateway?: string;
     force?: boolean;
 }

package/dist/commands/login.js

@@ -46,6 +46,13 @@ function getEmailFromToken(token) {
 }
 export async function loginCommand(options = {}) {
     const conf = getConfig();
+    // Handle --local flag: set gateway to point at local server
+    if (options.local !== undefined && options.local !== false) {
+        const port = (typeof options.local === 'string') ? options.local : '5001';
+        options.gateway = `ws://localhost:4000`;
+        // Also store the backend URL for other commands
+        conf.set('localBackendUrl', `http://localhost:${port}`);
+    }
     // Check if already logged in (unless --force)
     const existingToken = conf.get('token');
     if (existingToken && !options.force) {

package/dist/commands/logs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logs command — show agent log output.
+ *
+ * Usage:
+ *   nstantpage logs            — Show last 50 lines
+ *   nstantpage logs -f         — Follow log output (tail -f)
+ *   nstantpage logs -n 100     — Show last 100 lines
+ */
+interface LogsOptions {
+    follow?: boolean;
+    lines: string;
+}
+export declare function logsCommand(options: LogsOptions): Promise<void>;
+export {};

package/dist/commands/logs.js

@@ -0,0 +1,42 @@
+/**
+ * Logs command — show agent log output.
+ *
+ * Usage:
+ *   nstantpage logs            — Show last 50 lines
+ *   nstantpage logs -f         — Follow log output (tail -f)
+ *   nstantpage logs -n 100     — Show last 100 lines
+ */
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+export async function logsCommand(options) {
+    const logPath = path.join(os.homedir(), '.nstantpage', 'agent.log');
+    if (!fs.existsSync(logPath)) {
+        console.log(chalk.yellow('  No log file found.'));
+        console.log(chalk.gray(`  Expected: ${logPath}`));
+        console.log(chalk.gray('  Run "nstantpage run" to start the agent service first.'));
+        return;
+    }
+    const lines = parseInt(options.lines, 10) || 50;
+    if (options.follow) {
+        console.log(chalk.gray(`  Following ${logPath} (Ctrl+C to stop)\n`));
+        try {
+            execSync(`tail -n ${lines} -f "${logPath}"`, { stdio: 'inherit' });
+        }
+        catch {
+            // User pressed Ctrl+C
+        }
+    }
+    else {
+        try {
+            const output = execSync(`tail -n ${lines} "${logPath}"`, { encoding: 'utf-8' });
+            console.log(output);
+        }
+        catch {
+            console.log(chalk.red('  Failed to read log file.'));
+        }
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/run.d.ts

@@ -1,10 +1,10 @@
 /**
- * Run command — open the nstantpage desktop app.
+ * Run command — install the background service so the agent starts on boot.
  *
  * Usage:
- *   nstantpage run              — Open desktop app (loads nstantpage.com)
- *   nstantpage run --local      — Open desktop app pointing at localhost:5001
- *   nstantpage run --local 3000 — Open desktop app pointing at localhost:3000
+ *   nstantpage run              — Install service (connects to nstantpage.com)
+ *   nstantpage run --local      — Install service targeting localhost:5001
+ *   nstantpage run --local 3000 — Install service targeting localhost:3000
  */
 interface RunOptions {
     local?: string | boolean;

package/dist/commands/run.js

@@ -1,82 +1,44 @@
 /**
- * Run command — open the nstantpage desktop app.
+ * Run command — install the background service so the agent starts on boot.
  *
  * Usage:
- *   nstantpage run              — Open desktop app (loads nstantpage.com)
- *   nstantpage run --local      — Open desktop app pointing at localhost:5001
- *   nstantpage run --local 3000 — Open desktop app pointing at localhost:3000
+ *   nstantpage run              — Install service (connects to nstantpage.com)
+ *   nstantpage run --local      — Install service targeting localhost:5001
+ *   nstantpage run --local 3000 — Install service targeting localhost:3000
  */
 import chalk from 'chalk';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import { execSync } from 'child_process';
-/**
- * Find the Electron desktop app on disk.
- * Same logic as service.ts findElectronApp() — check postinstall location first.
- */
-function findElectronApp() {
-    const platform = os.platform();
-    if (platform === 'darwin') {
-        const candidates = [
-            path.join(os.homedir(), '.nstantpage', 'desktop', 'nstantpage.app'),
-            '/Applications/nstantpage.app',
-            path.join(os.homedir(), 'Applications', 'nstantpage.app'),
-        ];
-        for (const p of candidates) {
-            if (fs.existsSync(p))
-                return p;
-        }
-    }
-    else if (platform === 'win32') {
-        const candidates = [
-            path.join(os.homedir(), '.nstantpage', 'desktop', 'nstantpage.exe'),
-            path.join(os.homedir(), 'AppData', 'Local', 'Programs', 'nstantpage', 'nstantpage.exe'),
-            path.join('C:\\Program Files', 'nstantpage', 'nstantpage.exe'),
-        ];
-        for (const p of candidates) {
-            if (fs.existsSync(p))
-                return p;
-        }
-    }
-    return null;
-}
+import { getConfig } from '../config.js';
+import { serviceInstallCommand } from './service.js';
 export async function runCommand(options = {}) {
-    const appPath = findElectronApp();
-    if (!appPath) {
-        console.log(chalk.red('  ✗ Desktop app not found.'));
-        console.log(chalk.gray('  Run "nstantpage update --desktop" to download it.'));
-        process.exit(1);
-    }
-    const platform = os.platform();
-    // Build args to pass to the Electron app
-    const extraArgs = [];
+    const conf = getConfig();
+    // Resolve gateway based on --local flag
+    let gateway;
     if (options.local !== undefined && options.local !== false) {
         const port = (typeof options.local === 'string') ? options.local : '5001';
-        extraArgs.push(`--local-url=http://localhost:${port}`);
+        gateway = `ws://localhost:4000`;
+        conf.set('localBackendUrl', `http://localhost:${port}`);
     }
-    console.log(chalk.blue(`\n  Opening nstantpage desktop app...`));
-    if (extraArgs.length) {
-        console.log(chalk.gray(`  Args: ${extraArgs.join(' ')}`));
+    else {
+        gateway = conf.get('gatewayUrl') || 'wss://webprev.live';
+    }
+    const token = conf.get('token');
+    const isLocal = /^wss?:\/\/(localhost|127\.0\.0\.1)/.test(gateway);
+    if (!token && !isLocal) {
+        console.log(chalk.red('  ✗ Not authenticated. Run "nstantpage login" first.'));
+        process.exit(1);
     }
+    console.log(chalk.blue(`\n  🚀 nstantpage run\n`));
+    console.log(chalk.gray(`  Server: ${isLocal ? 'localhost (dev)' : 'nstantpage.com'}`));
+    // Install background service (auto-start on boot + starts immediately)
     try {
-        if (platform === 'darwin') {
-            const argsStr = extraArgs.length ? ` --args ${extraArgs.join(' ')}` : '';
-            execSync(`open -a "${appPath}"${argsStr}`, { stdio: 'inherit' });
-        }
-        else if (platform === 'win32') {
-            const argsStr = extraArgs.join(' ');
-            execSync(`"${appPath}" ${argsStr}`, { stdio: 'inherit' });
-        }
-        else {
-            console.log(chalk.yellow('  ⚠ Desktop app not supported on this platform yet.'));
-            process.exit(1);
-        }
-        console.log(chalk.green('  ✓ App launched\n'));
+        await serviceInstallCommand({ gateway });
     }
     catch (err) {
-        console.log(chalk.red(`  ✗ Failed to launch: ${err.message}`));
+        console.log(chalk.red(`  ✗ Service install failed: ${err.message}`));
         process.exit(1);
     }
+    console.log(chalk.green('\n  ✓ Agent is running as a background service.'));
+    console.log(chalk.gray('  Use "nstantpage logs" to view agent output.'));
+    console.log(chalk.gray('  Use "nstantpage service stop" to stop.\n'));
 }
 //# sourceMappingURL=run.js.map

package/dist/commands/start.d.ts

@@ -18,6 +18,7 @@
 interface StartOptions {
     port: string;
     apiPort: string;
+    local?: string | boolean;
     projectId?: string;
     gateway: string;
     backend?: string;

package/dist/commands/start.js

@@ -182,6 +182,12 @@ function cleanupPreviousAgent(projectId, apiPort, devPort) {
 }
 export async function startCommand(directory, options) {
     const conf = getConfig();
+    // Handle --local flag: override backend & gateway to point at localhost
+    if (options.local !== undefined && options.local !== false) {
+        const localPort = (typeof options.local === 'string') ? options.local : '5001';
+        options.backend = `http://localhost:${localPort}`;
+        options.gateway = `ws://localhost:4000`;
+    }
     // If --token was passed, persist it
     if (options.token) {
         conf.set('token', options.token);

package/dist/commands/sync.d.ts

@@ -12,13 +12,10 @@
  * 4. Starts the agent (equivalent to `nstantpage start`)
  */
 interface SyncOptions {
-    port: string;
-    apiPort: string;
     local?: boolean | string;
     gateway?: string;
     backend?: string;
     token?: string;
-    noStart?: boolean;
 }
 export declare function syncCommand(directory: string, options: SyncOptions): Promise<void>;
 export {};

package/dist/commands/sync.js

@@ -15,7 +15,6 @@ import chalk from 'chalk';
 import path from 'path';
 import fs from 'fs';
 import { getConfig, getDeviceId } from '../config.js';
-import { startCommand } from './start.js';
 const SKIP_DIRS = new Set([
     'node_modules', 'dist', '.git', '.vite-cache', '.next',
     '__pycache__', '.turbo', '.cache', 'build', 'out',
@@ -136,7 +135,10 @@ export async function syncCommand(directory, options) {
             const parts = token.split('.');
             if (parts.length === 3) {
                 const payload = JSON.parse(Buffer.from(parts[1], 'base64').toString('utf-8'));
-                userId = payload.sub;
+                // .NET uses full claim type URIs; also check standard 'sub' claim
+                userId = payload['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier']
+                    || payload['sub']
+                    || payload['nameid'];
             }
         }
         catch { }
@@ -211,21 +213,8 @@ export async function syncCommand(directory, options) {
     if (files.length > BATCH_SIZE)
         process.stdout.write('\n');
     console.log(chalk.green(`  ✓ ${totalPushed} files synced to database`));
-    // 5. Start the agent unless --no-start
-    if (options.noStart) {
-        console.log(chalk.blue(`\n  ✓ Sync complete! Project ID: ${projectId}\n`));
-        console.log(chalk.gray(`  To start the agent: nstantpage start --project-id ${projectId} --dir "${projectDir}"`));
-        return;
-    }
-    console.log(chalk.gray('\n  Starting agent...\n'));
-    await startCommand(projectDir, {
-        port: options.port,
-        apiPort: options.apiPort,
-        projectId,
-        gateway,
-        backend: options.backend,
-        token,
-        dir: projectDir,
-    });
+    console.log(chalk.blue(`\n  ✓ Sync complete! Project ID: ${projectId}`));
+    console.log(chalk.gray(`\n  View on web:  https://nstantpage.com/project/${projectId}`));
+    console.log(chalk.gray(`  Start agent:  nstantpage start --project-id ${projectId} --dir "${projectDir}"\n`));
 }
 //# sourceMappingURL=sync.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nstantpage-agent",
-  "version": "0.8.0",
+  "version": "0.8.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": {