nstantpage-agent 0.8.13 → 0.8.15

package/dist/commands/start.js

@@ -572,15 +572,16 @@ async function startStandbyMode(token, options, backendUrl, deviceId) {
         devPort: 0,
         onStartProject: async (pid, opts) => {
             const isClean = opts?.clean === true;
-            // If clean reset requested and project is already running, stop it first
-            if (isClean && activeProjects.has(pid)) {
-                console.log(chalk.yellow(`  Stopping existing project ${pid} for clean reset...`));
+            const isLocalRepo = !!opts?.localFolderPath;
+            // If clean reset or LocalRepo re-start requested and project is already running, stop it first
+            if ((isClean || isLocalRepo) && activeProjects.has(pid)) {
+                console.log(chalk.yellow(`  Stopping existing project ${pid} for ${isClean ? 'clean reset' : 'LocalRepo restart'}...`));
                 const existing = activeProjects.get(pid);
                 existing.tunnel.disconnect();
                 await existing.localServer.stop();
                 activeProjects.delete(pid);
-                // Wipe the project directory (only for non-LocalRepo)
-                if (!opts?.localFolderPath) {
+                // Wipe the project directory (only for clean non-LocalRepo)
+                if (isClean && !isLocalRepo) {
                     const projectDir = resolveProjectDir('.', pid);
                     if (fs.existsSync(projectDir)) {
                         console.log(chalk.gray(`  Wiping project directory: ${projectDir}`));
@@ -775,7 +776,7 @@ async function startAdditionalProject(projectId, opts) {
         if (databaseUrl)
             serverEnv['DATABASE_URL'] = databaseUrl;
         // Note: tunnel is created after localServer but before start(),
-        // so the onSyncDirty callback captures it via closure (late-binding).
+        // so the onSyncDirty/onSetDevPort callbacks capture it via closure (late-binding).
         let tunnel;
         const localServer = new LocalServer({
             projectDir, projectId,
@@ -787,6 +788,11 @@ async function startAdditionalProject(projectId, opts) {
                     tunnel.sendSyncDirty(pid);
                 }
             },
+            onSetDevPort: (port) => {
+                if (tunnel) {
+                    tunnel.setDevPort(port);
+                }
+            },
         });
         tunnel = new TunnelClient({
             gatewayUrl: opts.gatewayUrl,

package/dist/localServer.d.ts

@@ -62,6 +62,8 @@ export interface LocalServerOptions {
     backendUrl?: string;
     /** Called when file watcher detects changes — should send sync-dirty via tunnel */
     onSyncDirty?: (projectId: string) => void;
+    /** Called when dev port is updated via /live/set-dev-port */
+    onSetDevPort?: (port: number) => void;
 }
 export declare class LocalServer {
     private server;
@@ -127,6 +129,7 @@ export declare class LocalServer {
     private handleTree;
     private handleFileContent;
     private handleSaveFile;
+    private handleSetDevPort;
     private handleHealth;
     /**
      * Get a pg Pool connected to this project's local database.

package/dist/localServer.js

@@ -404,6 +404,7 @@ export class LocalServer {
             '/live/tree': this.handleTree,
             '/live/file-content': this.handleFileContent,
             '/live/save-file': this.handleSaveFile,
+            '/live/set-dev-port': this.handleSetDevPort,
             '/health': this.handleHealth,
         };
         if (handlers[path])
@@ -1225,6 +1226,23 @@ export class LocalServer {
             this.json(res, { error: error.message }, 500);
         }
     }
+    // ─── /live/set-dev-port ─────────────────────────────────────
+    async handleSetDevPort(_req, res, body) {
+        try {
+            const { port } = JSON.parse(body);
+            if (!port || typeof port !== 'number' || port < 1 || port > 65535) {
+                this.json(res, { error: 'Invalid port number' }, 400);
+                return;
+            }
+            if (this.options.onSetDevPort) {
+                this.options.onSetDevPort(port);
+            }
+            this.json(res, { success: true, port });
+        }
+        catch (error) {
+            this.json(res, { error: error.message }, 500);
+        }
+    }
     // ─── /health ─────────────────────────────────────────────────
     async handleHealth(_req, res) {
         this.json(res, {

package/dist/tunnel.d.ts

@@ -48,7 +48,13 @@ export declare class TunnelClient {
     private wsChannels;
     /** Listeners for status changes (used by tray app) */
     private statusListeners;
+    /** Override dev port (set dynamically for LocalRepo when user starts dev server) */
+    private _devPortOverride;
     constructor(options: TunnelClientOptions);
+    /** Get the effective dev server port (override or default) */
+    get devPort(): number;
+    /** Dynamically set dev port (e.g., when user starts dev server on a specific port) */
+    setDevPort(port: number): void;
     /**
      * Handle OS sleep/wake events.
      * When the machine wakes from sleep (or screen unlock), immediately attempt

package/dist/tunnel.js

@@ -38,10 +38,21 @@ export class TunnelClient {
     wsChannels = new Map();
     /** Listeners for status changes (used by tray app) */
     statusListeners = new Set();
+    /** Override dev port (set dynamically for LocalRepo when user starts dev server) */
+    _devPortOverride = null;
     constructor(options) {
         this.options = options;
         this.setupSleepWakeHandlers();
     }
+    /** Get the effective dev server port (override or default) */
+    get devPort() {
+        return this._devPortOverride ?? this.options.devPort;
+    }
+    /** Dynamically set dev port (e.g., when user starts dev server on a specific port) */
+    setDevPort(port) {
+        console.log(`  [Tunnel] Dev port set to ${port} (was ${this._devPortOverride ?? this.options.devPort})`);
+        this._devPortOverride = port;
+    }
     /**
      * Handle OS sleep/wake events.
      * When the machine wakes from sleep (or screen unlock), immediately attempt
@@ -350,7 +361,7 @@ export class TunnelClient {
      * This enables Vite HMR to work through the cloud preview URL.
      */
     handleWsOpenDevServer(wsId, url, protocol) {
-        const devPort = this.options.devPort;
+        const devPort = this.devPort;
         const wsUrl = `ws://127.0.0.1:${devPort}${url}`;
         console.log(`  [Tunnel] Opening HMR WS relay: ${wsId} → ${wsUrl}`);
         const wsOptions = {};
@@ -493,7 +504,7 @@ export class TunnelClient {
     handleHttpRequest(request) {
         const { url } = request;
         const isApiRequest = url.startsWith('/live/') || url === '/health';
-        const targetPort = isApiRequest ? this.options.apiPort : this.options.devPort;
+        const targetPort = isApiRequest ? this.options.apiPort : this.devPort;
         this.forwardToLocal(request, targetPort);
         this.requestsForwarded++;
     }

package/package.json

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