nstantpage-agent 0.7.1 → 0.8.0

package/dist/cli.js

@@ -22,7 +22,6 @@ 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();
@@ -53,17 +52,13 @@ program
     .option('--dir <path>', 'Project directory override')
     .option('--no-dev', 'Skip starting the dev server (start manually later)')
     .action(startCommand);
-program
-    .command('run')
-    .description('Open the nstantpage desktop app')
-    .option('--local [port]', 'Connect to local backend (default: 5001)')
-    .action(runCommand);
 program
     .command('sync')
     .description('Sync local directory to nstantpage and start agent')
     .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)')
@@ -124,9 +119,7 @@ service
     .action(serviceStatusCommand);
 program
     .command('update')
-    .description('Update CLI and desktop app to the latest version')
-    .option('--cli', 'Update only the CLI package')
-    .option('--desktop', 'Update only the desktop app')
+    .description('Update CLI to the latest version')
     .action(updateCommand);
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/commands/service.js

@@ -20,11 +20,8 @@ import fs from 'fs';
 import path from 'path';
 import os from 'os';
 import { execSync } from 'child_process';
-import { fileURLToPath } from 'url';
 import { getConfig } from '../config.js';
 import { startCommand } from './start.js';
-const __filename_esm = fileURLToPath(import.meta.url);
-const __dirname_esm = path.dirname(__filename_esm);
 const PLIST_LABEL = 'com.nstantpage.agent';
 const SYSTEMD_SERVICE = 'nstantpage-agent';
 const WIN_TASK_NAME = 'NstantpageAgent';
@@ -115,23 +112,6 @@ export async function serviceInstallCommand(options = {}) {
     }
     const gateway = options.gateway || 'wss://webprev.live';
     const platform = os.platform();
-    // On desktop platforms, prefer the Electron tray app (agent + tray icon in one)
-    const electronAppPath = findElectronApp();
-    if (electronAppPath && (platform === 'darwin' || platform === 'win32')) {
-        console.log(chalk.blue(`\n  Found nstantpage desktop app: ${electronAppPath}`));
-        console.log(chalk.blue('  Installing with system tray icon...\n'));
-        if (platform === 'darwin') {
-            await installElectronLaunchd(electronAppPath);
-        }
-        else if (platform === 'win32') {
-            await installElectronWindowsTask(electronAppPath);
-        }
-        return;
-    }
-    // Fallback: headless service (no tray icon)
-    if (electronAppPath === null) {
-        console.log(chalk.gray('  Tip: Run "nstantpage update --desktop" to download the desktop app with tray icon.'));
-    }
     if (platform === 'darwin') {
         await installLaunchd(gateway, token);
     }
@@ -228,118 +208,6 @@ export async function serviceStatusCommand() {
     }
 }
 // ─── Helper Functions ─────────────────────────────────
-// ─── Electron App Detection ──────────────────────────────
-function findElectronApp() {
-    const platform = os.platform();
-    if (platform === 'darwin') {
-        // Check common macOS install paths
-        const candidates = [
-            // Downloaded by postinstall (npm i -g nstantpage-agent)
-            path.join(os.homedir(), '.nstantpage', 'desktop', 'nstantpage.app'),
-            '/Applications/nstantpage.app',
-            path.join(os.homedir(), 'Applications', 'nstantpage.app'),
-            // Dev build location (from electron-builder --dir)
-            path.join(__dirname_esm, '..', '..', 'tray', 'dist', 'mac-arm64', 'nstantpage.app'),
-            path.join(__dirname_esm, '..', '..', 'tray', 'dist', 'mac', 'nstantpage.app'),
-        ];
-        for (const p of candidates) {
-            if (fs.existsSync(p))
-                return p;
-        }
-    }
-    else if (platform === 'win32') {
-        const candidates = [
-            // Downloaded by postinstall (npm i -g nstantpage-agent)
-            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;
-}
-async function installElectronLaunchd(appPath) {
-    const plistDir = path.join(os.homedir(), 'Library', 'LaunchAgents');
-    const plistPath = path.join(plistDir, `${PLIST_LABEL}.plist`);
-    const logPath = path.join(os.homedir(), '.nstantpage', 'agent.log');
-    const errPath = path.join(os.homedir(), '.nstantpage', 'agent.err.log');
-    fs.mkdirSync(plistDir, { recursive: true });
-    fs.mkdirSync(path.dirname(logPath), { recursive: true });
-    const plist = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-    <key>Label</key>
-    <string>${PLIST_LABEL}</string>
-    <key>ProgramArguments</key>
-    <array>
-        <string>/usr/bin/open</string>
-        <string>-a</string>
-        <string>${appPath}</string>
-    </array>
-    <key>RunAtLoad</key>
-    <true/>
-    <key>KeepAlive</key>
-    <dict>
-        <key>Crashed</key>
-        <true/>
-    </dict>
-    <key>ProcessType</key>
-    <string>Interactive</string>
-    <key>StandardOutPath</key>
-    <string>${logPath}</string>
-    <key>StandardErrorPath</key>
-    <string>${errPath}</string>
-    <key>EnvironmentVariables</key>
-    <dict>
-        <key>NSAppSleepDisabled</key>
-        <string>YES</string>
-    </dict>
-    <key>ThrottleInterval</key>
-    <integer>10</integer>
-</dict>
-</plist>`;
-    fs.writeFileSync(plistPath, plist, 'utf-8');
-    try {
-        execSync(`launchctl unload "${plistPath}" 2>/dev/null`, { encoding: 'utf-8' });
-    }
-    catch { }
-    execSync(`launchctl load "${plistPath}"`, { encoding: 'utf-8' });
-    console.log(chalk.green('\n  ✓ nstantpage installed as desktop app with tray icon\n'));
-    console.log(chalk.gray(`  App:     ${appPath}`));
-    console.log(chalk.gray(`  Plist:   ${plistPath}`));
-    console.log(chalk.gray(`  Log:     ${logPath}`));
-    console.log(chalk.gray(`  Status:  nstantpage service status`));
-    console.log(chalk.gray(`  Remove:  nstantpage service uninstall\n`));
-    console.log(chalk.blue('  The app will start on login with a tray icon showing connection status.'));
-    console.log(chalk.blue('  Right-click the tray icon for options. Open nstantpage.com to connect projects.\n'));
-}
-async function installElectronWindowsTask(appPath) {
-    const logPath = path.join(os.homedir(), '.nstantpage', 'agent.log');
-    fs.mkdirSync(path.dirname(logPath), { recursive: true });
-    try {
-        execSync(`schtasks /delete /tn "${WIN_TASK_NAME}" /f 2>nul`, { encoding: 'utf-8' });
-    }
-    catch { }
-    try {
-        execSync(`schtasks /create /tn "${WIN_TASK_NAME}" /tr "\\"${appPath}\\"" /sc onlogon /rl highest /delay 0000:10 /f`, { encoding: 'utf-8' });
-        // Start immediately
-        execSync(`start "" "${appPath}"`, { encoding: 'utf-8' });
-    }
-    catch (err) {
-        console.log(chalk.yellow(`  ⚠ Task Scheduler error: ${err.message}`));
-        return;
-    }
-    console.log(chalk.green('\n  ✓ nstantpage installed as desktop app with tray icon\n'));
-    console.log(chalk.gray(`  App:     ${appPath}`));
-    console.log(chalk.gray(`  Task:    ${WIN_TASK_NAME}`));
-    console.log(chalk.gray(`  Status:  nstantpage service status`));
-    console.log(chalk.gray(`  Remove:  nstantpage service uninstall\n`));
-    console.log(chalk.blue('  The app will start on login with a tray icon.\n'));
-}
 function getAgentBinPath() {
     try {
         const resolved = execSync('which nstantpage 2>/dev/null || which nstantpage-agent 2>/dev/null', { encoding: 'utf-8' }).trim();

package/dist/commands/start.js

@@ -623,6 +623,7 @@ async function startStandbyMode(token, options, backendUrl, deviceId) {
             devPort: allocatePortsForProject(pid).devPort,
             apiPort: allocatePortsForProject(pid).apiPort,
             tunnelStatus: proj.tunnel.status,
+            projectDir: resolveProjectDir('.', pid),
         })),
         requestsForwarded: standbyTunnel.stats.requestsForwarded +
             Array.from(activeProjects.values()).reduce((sum, p) => sum + p.tunnel.stats.requestsForwarded, 0),

package/dist/commands/sync.d.ts

@@ -14,6 +14,7 @@
 interface SyncOptions {
     port: string;
     apiPort: string;
+    local?: boolean | string;
     gateway?: string;
     backend?: string;
     token?: string;

package/dist/commands/sync.js

@@ -98,6 +98,12 @@ export async function syncCommand(directory, options) {
         console.log(chalk.red(`  ✗ Directory not found: ${projectDir}`));
         process.exit(1);
     }
+    // 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`;
+    }
     // Check authentication
     const gateway = options.gateway || conf.get('gatewayUrl') || 'wss://webprev.live';
     const isLocalGateway = /^wss?:\/\/(localhost|127\.0\.0\.1)/.test(gateway);

package/dist/commands/update.d.ts

@@ -1,14 +1,7 @@
 /**
- * Update command — update both CLI (npm) and desktop app (GitHub releases).
+ * Update command — update the CLI via npm.
  *
  * Usage:
- *   nstantpage update          — Update both CLI and desktop
- *   nstantpage update --cli    — Update CLI only (npm)
- *   nstantpage update --desktop — Update desktop only (GitHub releases)
+ *   nstantpage update — Update CLI to latest version
  */
-interface UpdateOptions {
-    cli?: boolean;
-    desktop?: boolean;
-}
-export declare function updateCommand(options?: UpdateOptions): Promise<void>;
-export {};
+export declare function updateCommand(): Promise<void>;

package/dist/commands/update.js

@@ -1,29 +1,16 @@
 /**
- * Update command — update both CLI (npm) and desktop app (GitHub releases).
+ * Update command — update the CLI via npm.
  *
  * Usage:
- *   nstantpage update          — Update both CLI and desktop
- *   nstantpage update --cli    — Update CLI only (npm)
- *   nstantpage update --desktop — Update desktop only (GitHub releases)
+ *   nstantpage update — Update CLI to latest version
  */
 import chalk from 'chalk';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
 import { execSync } from 'child_process';
 import { getPackageVersion } from '../version.js';
-const DESKTOP_DIR = path.join(os.homedir(), '.nstantpage', 'desktop');
-const VERSION_FILE = path.join(DESKTOP_DIR, '.version');
-export async function updateCommand(options = {}) {
-    const updateBoth = !options.cli && !options.desktop;
+export async function updateCommand() {
     const currentVersion = getPackageVersion();
     console.log(chalk.blue(`\n  nstantpage v${currentVersion}\n`));
-    if (updateBoth || options.cli) {
-        await updateCli(currentVersion);
-    }
-    if (updateBoth || options.desktop) {
-        await updateDesktop();
-    }
+    await updateCli(currentVersion);
     console.log('');
 }
 async function updateCli(currentVersion) {
@@ -47,27 +34,4 @@ async function updateCli(currentVersion) {
         console.log(chalk.gray('  Try manually: npm install -g nstantpage-agent@latest'));
     }
 }
-async function updateDesktop() {
-    console.log(chalk.gray('  Checking GitHub for desktop updates...'));
-    try {
-        // Re-run the postinstall script which handles download + version check
-        const scriptPath = path.join(path.dirname(new URL(import.meta.url).pathname), '..', '..', 'scripts', 'postinstall.mjs');
-        if (fs.existsSync(scriptPath)) {
-            execSync(`node "${scriptPath}"`, { stdio: 'inherit' });
-        }
-        else {
-            // If installed globally, the script is in the package root
-            const altPath = path.join(path.dirname(new URL(import.meta.url).pathname), '..', 'scripts', 'postinstall.mjs');
-            if (fs.existsSync(altPath)) {
-                execSync(`node "${altPath}"`, { stdio: 'inherit' });
-            }
-            else {
-                console.log(chalk.yellow('  ⚠ Desktop updater script not found. Reinstall to fix: npm i -g nstantpage-agent'));
-            }
-        }
-    }
-    catch (err) {
-        console.log(chalk.red(`  ✗ Desktop update failed: ${err.message}`));
-    }
-}
 //# sourceMappingURL=update.js.map

package/dist/localServer.js

@@ -657,7 +657,9 @@ export class LocalServer {
         let shell = null;
         let ptyProcess = null;
         // Ensure project directory exists (posix_spawnp fails if cwd is missing)
-        const spawnCwd = fs.existsSync(this.options.projectDir) ? this.options.projectDir : process.cwd();
+        // Use cwd from request if provided (e.g. LocalRepo projects use the actual disk folder path)
+        const requestedCwd = parsed.cwd && fs.existsSync(parsed.cwd) ? parsed.cwd : null;
+        const spawnCwd = requestedCwd || (fs.existsSync(this.options.projectDir) ? this.options.projectDir : process.cwd());
         // Prefer node-pty for real PTY (interactive shell, echo, prompt, resize)
         if (ptyModule) {
             try {

package/dist/statusServer.d.ts

@@ -37,6 +37,7 @@ export interface ActiveProjectInfo {
     apiPort: number;
     tunnelStatus: string;
     startedAt?: string;
+    projectDir?: string;
 }
 type StatusProvider = () => AgentStatusInfo;
 type ShutdownHandler = () => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nstantpage-agent",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Local development agent for nstantpage.com — run your projects locally, preview in the cloud. Replaces cloud containers for faster builds.",
   "type": "module",
   "bin": {
@@ -11,14 +11,12 @@
   "files": [
     "dist/**/*.js",
     "dist/**/*.d.ts",
-    "scripts/postinstall.mjs",
     "README.md"
   ],
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/cli.ts",
     "start": "node dist/cli.js",
-    "postinstall": "node scripts/postinstall.mjs",
     "prepublishOnly": "npm run build"
   },
   "engines": {

package/dist/gitSetup.d.ts

@@ -1,10 +0,0 @@
-/**
- * Git Setup — ensures git is installed on the user's machine.
- * Called during agent startup so GitSnapshotService (backend) can use it for undo.
- */
-/**
- * Check if git is available, and try to install it if not.
- * Returns true if git is available after this call.
- * Non-blocking: agent continues even if git can't be installed (undo just won't work).
- */
-export declare function ensureGit(): Promise<boolean>;

package/dist/gitSetup.js

@@ -1,162 +0,0 @@
-/**
- * Git Setup — ensures git is installed on the user's machine.
- * Called during agent startup so GitSnapshotService (backend) can use it for undo.
- */
-import { execSync } from 'child_process';
-import os from 'os';
-import chalk from 'chalk';
-/**
- * Check if git is available, and try to install it if not.
- * Returns true if git is available after this call.
- * Non-blocking: agent continues even if git can't be installed (undo just won't work).
- */
-export async function ensureGit() {
-    if (isGitAvailable()) {
-        return true;
-    }
-    console.log(chalk.yellow('  ⚠ Git not found — installing (needed for undo/version control)'));
-    const platform = os.platform();
-    try {
-        if (platform === 'darwin') {
-            return await installGitMacOS();
-        }
-        else if (platform === 'win32') {
-            return await installGitWindows();
-        }
-        else {
-            return installGitLinux();
-        }
-    }
-    catch (err) {
-        console.log(chalk.red(`  ✗ Could not install git: ${err.message}`));
-        printManualInstructions();
-        return false;
-    }
-}
-function isGitAvailable() {
-    try {
-        execSync('git --version', { stdio: 'pipe', encoding: 'utf-8' });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function installGitMacOS() {
-    // Check if Xcode CLT is installed (it includes git)
-    try {
-        execSync('xcode-select -p', { stdio: 'pipe' });
-        // CLT installed but git not in PATH — unusual, may need PATH fix
-        console.log(chalk.yellow('  Xcode CLT installed but git not in PATH'));
-        printManualInstructions();
-        return false;
-    }
-    catch {
-        // CLT not installed — trigger installation
-    }
-    // Try Homebrew first (non-interactive, faster)
-    try {
-        execSync('brew --version', { stdio: 'pipe' });
-        console.log(chalk.gray('  Installing git via Homebrew...'));
-        execSync('brew install git', { stdio: 'inherit' });
-        if (isGitAvailable()) {
-            const ver = execSync('git --version', { encoding: 'utf-8' }).trim();
-            console.log(chalk.green(`  ✓ ${ver}`));
-            return true;
-        }
-    }
-    catch {
-        // Homebrew not available — fall through to xcode-select
-    }
-    // Trigger Xcode CLT install dialog
-    console.log(chalk.gray('  Installing Xcode Command Line Tools (includes git)...'));
-    console.log(chalk.gray('  Please click "Install" in the dialog if prompted.'));
-    try {
-        execSync('xcode-select --install 2>/dev/null', { stdio: 'inherit' });
-    }
-    catch {
-        // xcode-select --install returns non-zero if dialog was shown
-    }
-    // Poll for git availability (max 5 minutes — the Xcode dialog is async)
-    const maxWaitMs = 300_000;
-    const pollMs = 5_000;
-    const start = Date.now();
-    while (Date.now() - start < maxWaitMs) {
-        await new Promise(r => setTimeout(r, pollMs));
-        if (isGitAvailable()) {
-            const ver = execSync('git --version', { encoding: 'utf-8' }).trim();
-            console.log(chalk.green(`  ✓ ${ver}`));
-            return true;
-        }
-    }
-    console.log(chalk.yellow('  ⚠ Timed out waiting for install. Restart after Xcode Tools finishes.'));
-    return false;
-}
-async function installGitWindows() {
-    // Try winget (available on Windows 10 1709+)
-    try {
-        execSync('winget --version', { stdio: 'pipe' });
-        console.log(chalk.gray('  Installing git via winget...'));
-        execSync('winget install --id Git.Git -e --source winget --accept-package-agreements --accept-source-agreements', { stdio: 'inherit' });
-        if (isGitAvailable()) {
-            const ver = execSync('git --version', { encoding: 'utf-8' }).trim();
-            console.log(chalk.green(`  ✓ ${ver}`));
-            return true;
-        }
-        // winget installs may need a new shell for PATH update
-        console.log(chalk.yellow('  Git installed — restart your terminal for PATH to update.'));
-        return false;
-    }
-    catch {
-        // winget not available
-    }
-    console.log(chalk.yellow('  Install Git for Windows:'));
-    console.log(chalk.gray('    https://git-scm.com/download/win'));
-    console.log(chalk.gray('    or: winget install --id Git.Git'));
-    return false;
-}
-function installGitLinux() {
-    // Try common package managers (non-interactive)
-    const managers = [
-        { check: 'apt-get --version', install: 'sudo apt-get install -y git' },
-        { check: 'dnf --version', install: 'sudo dnf install -y git' },
-        { check: 'yum --version', install: 'sudo yum install -y git' },
-        { check: 'pacman --version', install: 'sudo pacman -S --noconfirm git' },
-        { check: 'apk --version', install: 'sudo apk add git' },
-    ];
-    for (const { check, install } of managers) {
-        try {
-            execSync(check, { stdio: 'pipe' });
-            console.log(chalk.gray(`  Installing git: ${install}`));
-            execSync(install, { stdio: 'inherit' });
-            if (isGitAvailable()) {
-                const ver = execSync('git --version', { encoding: 'utf-8' }).trim();
-                console.log(chalk.green(`  ✓ ${ver}`));
-                return true;
-            }
-        }
-        catch {
-            continue;
-        }
-    }
-    console.log(chalk.yellow('  Please install git:'));
-    console.log(chalk.gray('    Ubuntu/Debian: sudo apt-get install git'));
-    console.log(chalk.gray('    Fedora:        sudo dnf install git'));
-    console.log(chalk.gray('    Arch:          sudo pacman -S git'));
-    return false;
-}
-function printManualInstructions() {
-    const platform = os.platform();
-    console.log(chalk.yellow('  Install git manually:'));
-    if (platform === 'darwin') {
-        console.log(chalk.gray('    xcode-select --install'));
-        console.log(chalk.gray('    or: brew install git'));
-    }
-    else if (platform === 'win32') {
-        console.log(chalk.gray('    https://git-scm.com/download/win'));
-    }
-    else {
-        console.log(chalk.gray('    sudo apt-get install git'));
-    }
-}
-//# sourceMappingURL=gitSetup.js.map

package/scripts/postinstall.mjs

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-/**
- * postinstall script for nstantpage-agent npm package.
- * Downloads the platform-specific Electron desktop app from GitHub releases
- * to ~/.nstantpage/desktop/ so that `nstantpage service install` can use it.
- *
- * Runs automatically after `npm i -g nstantpage-agent`.
- * Skips silently if:
- *   - Already downloaded and up-to-date
- *   - Network is unavailable
- *   - Running in CI (CI=true)
- *   - Platform has no desktop build (e.g., Linux currently)
- */
-
-import https from 'https';
-import http from 'http';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import { execSync } from 'child_process';
-import { createRequire } from 'module';
-
-const require_ = createRequire(import.meta.url);
-
-// Skip in CI environments
-if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) {
-  process.exit(0);
-}
-
-const GITHUB_OWNER = 'nightwishh';
-const GITHUB_REPO = 'nstantpage-desktop';
-const DESKTOP_DIR = path.join(os.homedir(), '.nstantpage', 'desktop');
-const VERSION_FILE = path.join(DESKTOP_DIR, '.version');
-
-/**
- * Fetch JSON from a URL, following redirects.
- */
-function fetchJson(url) {
-  return new Promise((resolve, reject) => {
-    const get = url.startsWith('https') ? https.get : http.get;
-    get(url, { headers: { 'User-Agent': 'nstantpage-agent-postinstall' } }, (res) => {
-      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-        return fetchJson(res.headers.location).then(resolve, reject);
-      }
-      if (res.statusCode !== 200) {
-        return reject(new Error(`HTTP ${res.statusCode}`));
-      }
-      let data = '';
-      res.on('data', (chunk) => (data += chunk));
-      res.on('end', () => {
-        try { resolve(JSON.parse(data)); }
-        catch (e) { reject(e); }
-      });
-    }).on('error', reject);
-  });
-}
-
-/**
- * Download a file from URL (following redirects) to dest path.
- * Shows progress on stdout.
- */
-function downloadFile(url, dest) {
-  return new Promise((resolve, reject) => {
-    const get = url.startsWith('https') ? https.get : http.get;
-    get(url, { headers: { 'User-Agent': 'nstantpage-agent-postinstall' } }, (res) => {
-      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-        return downloadFile(res.headers.location, dest).then(resolve, reject);
-      }
-      if (res.statusCode !== 200) {
-        return reject(new Error(`HTTP ${res.statusCode}`));
-      }
-      const total = parseInt(res.headers['content-length'] || '0', 10);
-      let downloaded = 0;
-      const file = fs.createWriteStream(dest);
-      res.on('data', (chunk) => {
-        downloaded += chunk.length;
-        file.write(chunk);
-        if (total > 0) {
-          const pct = Math.round((downloaded / total) * 100);
-          process.stdout.write(`\r  Downloading nstantpage desktop... ${pct}%`);
-        }
-      });
-      res.on('end', () => {
-        file.end();
-        if (total > 0) process.stdout.write('\n');
-        resolve(undefined);
-      });
-      res.on('error', (err) => { file.close(); reject(err); });
-    }).on('error', reject);
-  });
-}
-
-/**
- * Determine the release asset name for this platform/arch.
- * Returns null if no desktop build is available.
- */
-function getAssetPattern() {
-  const platform = os.platform();
-  const arch = os.arch();
-
-  if (platform === 'darwin') {
-    // macOS: zip contains the .app
-    if (arch === 'arm64') return /-arm64-mac\.zip$/;
-    return /-mac\.zip$/; // x64
-  }
-  if (platform === 'win32') {
-    // Windows: portable exe or nsis
-    return /\.exe$/;
-  }
-  // Linux: skip for now (AppImage support could be added later)
-  return null;
-}
-
-async function main() {
-  try {
-    const assetPattern = getAssetPattern();
-    if (!assetPattern) {
-      // No desktop build for this platform — skip silently
-      process.exit(0);
-    }
-
-    // Check latest release
-    const release = await fetchJson(
-      `https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/releases/latest`
-    );
-    const version = release.tag_name; // e.g., "v0.5.44"
-
-    // Check if already downloaded and up-to-date
-    if (fs.existsSync(VERSION_FILE)) {
-      const installed = fs.readFileSync(VERSION_FILE, 'utf-8').trim();
-      if (installed === version) {
-        console.log(`  nstantpage desktop ${version} already installed.`);
-        process.exit(0);
-      }
-    }
-
-    // Find the matching asset
-    const asset = release.assets.find((a) => assetPattern.test(a.name));
-    if (!asset) {
-      // No matching asset — skip silently
-      process.exit(0);
-    }
-
-    console.log(`  Installing nstantpage desktop ${version}...`);
-
-    // Prepare directories
-    fs.mkdirSync(DESKTOP_DIR, { recursive: true });
-
-    const platform = os.platform();
-
-    if (platform === 'darwin') {
-      // Download zip, extract .app
-      const zipPath = path.join(DESKTOP_DIR, 'download.zip');
-      await downloadFile(asset.browser_download_url, zipPath);
-
-      // Remove old app if exists
-      const appPath = path.join(DESKTOP_DIR, 'nstantpage.app');
-      if (fs.existsSync(appPath)) {
-        fs.rmSync(appPath, { recursive: true, force: true });
-      }
-
-      // Extract using ditto (macOS native, preserves permissions and code signing)
-      execSync(`ditto -xk "${zipPath}" "${DESKTOP_DIR}"`, { stdio: 'pipe' });
-      fs.unlinkSync(zipPath);
-
-      if (fs.existsSync(appPath)) {
-        // Remove quarantine attribute so macOS doesn't block it
-        try { execSync(`xattr -rd com.apple.quarantine "${appPath}" 2>/dev/null`); } catch {}
-        console.log(`  ✓ nstantpage desktop ${version} installed to ${appPath}`);
-      } else {
-        console.log('  ⚠ Extraction succeeded but app not found at expected path.');
-      }
-    } else if (platform === 'win32') {
-      // Download exe
-      const exePath = path.join(DESKTOP_DIR, 'nstantpage.exe');
-      await downloadFile(asset.browser_download_url, exePath);
-      console.log(`  ✓ nstantpage desktop ${version} installed to ${exePath}`);
-    }
-
-    // Record version
-    fs.writeFileSync(VERSION_FILE, version, 'utf-8');
-  } catch (err) {
-    // Non-fatal: network errors, rate limits, etc. User can still use CLI-only mode.
-    // Only show a brief note, don't fail the npm install.
-    console.log(`  Note: Could not download desktop app (${err.message}). CLI mode will work fine.`);
-    console.log('  Run "nstantpage update" later to retry.');
-  }
-}
-
-main();