nstantpage-agent 0.8.14 → 0.8.16

package/dist/commands/start.js

@@ -776,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,
@@ -788,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
@@ -349,9 +360,9 @@ export class TunnelClient {
      * Vite dev server and relay data bidirectionally through the tunnel.
      * This enables Vite HMR to work through the cloud preview URL.
      */
-    handleWsOpenDevServer(wsId, url, protocol) {
-        const devPort = this.options.devPort;
-        const wsUrl = `ws://127.0.0.1:${devPort}${url}`;
+    handleWsOpenDevServer(wsId, url, protocol, targetPort) {
+        const port = (targetPort && targetPort > 0) ? targetPort : this.devPort;
+        const wsUrl = `ws://127.0.0.1:${port}${url}`;
         console.log(`  [Tunnel] Opening HMR WS relay: ${wsId} → ${wsUrl}`);
         const wsOptions = {};
         const protocols = protocol ? protocol.split(',').map(p => p.trim()) : undefined;
@@ -461,7 +472,7 @@ export class TunnelClient {
                 break;
             case 'ws-open':
                 if (msg.target === 'dev-server') {
-                    this.handleWsOpenDevServer(msg.wsId, msg.url || '/', msg.protocol);
+                    this.handleWsOpenDevServer(msg.wsId, msg.url || '/', msg.protocol, msg.targetPort);
                 }
                 else {
                     this.handleWsOpen(msg.wsId, msg.sessionId, msg.projectId);
@@ -491,9 +502,14 @@ export class TunnelClient {
      * - Everything else → Dev server (Vite HMR, page loads, etc.)
      */
     handleHttpRequest(request) {
-        const { url } = request;
+        const { url, headers } = request;
         const isApiRequest = url.startsWith('/live/') || url === '/health';
-        const targetPort = isApiRequest ? this.options.apiPort : this.options.devPort;
+        // Use x-target-port header if present (multi-port tunneling), else fall back to default
+        const portHeader = headers?.['x-target-port'];
+        const overridePort = portHeader ? parseInt(String(portHeader), 10) : NaN;
+        const targetPort = isApiRequest
+            ? this.options.apiPort
+            : (overridePort > 0 ? overridePort : this.devPort);
         this.forwardToLocal(request, targetPort);
         this.requestsForwarded++;
     }

package/package.json

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