nstantpage-agent 0.8.12 → 0.8.14

package/dist/commands/start.js

@@ -572,18 +572,21 @@ 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
-                const projectDir = resolveProjectDir('.', pid);
-                if (fs.existsSync(projectDir)) {
-                    console.log(chalk.gray(`  Wiping project directory: ${projectDir}`));
-                    fs.rmSync(projectDir, { recursive: true, force: true });
+                // 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}`));
+                        fs.rmSync(projectDir, { recursive: true, force: true });
+                    }
                 }
             }
             else if (activeProjects.has(pid)) {
@@ -592,6 +595,7 @@ async function startStandbyMode(token, options, backendUrl, deviceId) {
             }
             const result = await startAdditionalProject(pid, {
                 token, backendUrl, gatewayUrl: options.gateway, deviceId, noDev: options.noDev,
+                localFolderPath: opts?.localFolderPath,
                 onProgress: (phase, message) => {
                     standbyTunnel.sendSetupProgress(pid, phase, message);
                 },
@@ -678,6 +682,7 @@ async function startStandbyMode(token, options, backendUrl, deviceId) {
         }
         const result = await startAdditionalProject(projectId, {
             token, backendUrl, gatewayUrl: options.gateway, deviceId, noDev: options.noDev,
+            localFolderPath: opts?.localFolderPath,
             onProgress: (phase, message) => {
                 standbyTunnel.sendSetupProgress(projectId, phase, message);
             },
@@ -736,29 +741,37 @@ async function startAdditionalProject(projectId, opts) {
     const progress = opts.onProgress || (() => { });
     const timings = {};
     const t0 = Date.now();
-    console.log(chalk.blue(`\n  📦 Starting project ${projectId}...`));
+    const isLocalRepo = !!opts.localFolderPath;
+    console.log(chalk.blue(`\n  📦 Starting project ${projectId}${isLocalRepo ? ' (LocalRepo)' : ''}...`));
     try {
         const allocated = allocatePortsForProject(projectId);
-        const projectDir = resolveProjectDir('.', projectId);
+        const projectDir = isLocalRepo ? opts.localFolderPath : resolveProjectDir('.', projectId);
         if (!fs.existsSync(projectDir))
             fs.mkdirSync(projectDir, { recursive: true });
         // Ensure ports are clear for this project before starting
         cleanupPreviousAgent(projectId, allocated.apiPort, allocated.devPort);
         await new Promise(r => setTimeout(r, 50));
         // ── Phase 1: API server + file fetch + tunnel connect (all parallel) ──
-        progress('fetching-files', 'Fetching project files...');
-        // Provision database if PostgreSQL is available
+        if (!isLocalRepo) {
+            progress('fetching-files', 'Fetching project files...');
+        }
+        else {
+            progress('starting-server', 'Starting local server...');
+        }
+        // Provision database if PostgreSQL is available (skip for LocalRepo)
         let databaseUrl = null;
-        try {
-            const hasPg = await probeLocalPostgres();
-            if (hasPg) {
-                databaseUrl = await ensureLocalProjectDb(projectId);
-                if (databaseUrl) {
-                    console.log(chalk.green(`  ✓ Database ready: project_${projectId}`));
+        if (!isLocalRepo) {
+            try {
+                const hasPg = await probeLocalPostgres();
+                if (hasPg) {
+                    databaseUrl = await ensureLocalProjectDb(projectId);
+                    if (databaseUrl) {
+                        console.log(chalk.green(`  ✓ Database ready: project_${projectId}`));
+                    }
                 }
             }
+            catch { }
         }
-        catch { }
         const serverEnv = {};
         if (databaseUrl)
             serverEnv['DATABASE_URL'] = databaseUrl;
@@ -799,17 +812,20 @@ async function startAdditionalProject(projectId, opts) {
                 tunnel.startBackgroundReconnect();
             }
         })();
+        // Fetch project files from backend (skip for LocalRepo — files are on disk)
         const fileStart = Date.now();
         let fetchedVersionId;
-        try {
-            const { versionId } = await fetchProjectFiles(opts.backendUrl, projectId, projectDir, opts.token);
-            fetchedVersionId = versionId;
-            timings['fetch-files'] = Date.now() - fileStart;
-            progress('fetching-files', `Files downloaded (${timings['fetch-files']}ms)`);
-        }
-        catch (err) {
-            console.log(chalk.yellow(`  ⚠ Could not fetch files: ${err.message}`));
-            progress('fetching-files', `Warning: ${err.message}`);
+        if (!isLocalRepo) {
+            try {
+                const { versionId } = await fetchProjectFiles(opts.backendUrl, projectId, projectDir, opts.token);
+                fetchedVersionId = versionId;
+                timings['fetch-files'] = Date.now() - fileStart;
+                progress('fetching-files', `Files downloaded (${timings['fetch-files']}ms)`);
+            }
+            catch (err) {
+                console.log(chalk.yellow(`  ⚠ Could not fetch files: ${err.message}`));
+                progress('fetching-files', `Warning: ${err.message}`);
+            }
         }
         // Write DATABASE_URL to .env AFTER file fetch (so it doesn't get overwritten)
         if (databaseUrl) {
@@ -822,49 +838,51 @@ async function startAdditionalProject(projectId, opts) {
         if (fetchedVersionId) {
             localServer.markSynced(fetchedVersionId);
         }
-        // ── Phase 2: Install deps (if needed) ────────────────────────────
-        const installer = new PackageInstaller({ projectDir });
-        const needsInstall = !installer.areDependenciesInstalled() && fs.existsSync(path.join(projectDir, 'package.json'));
-        if (needsInstall) {
-            const installStart = Date.now();
-            console.log(chalk.gray(`  Installing dependencies...`));
-            progress('installing-deps', 'Installing npm dependencies...');
-            try {
-                await installer.ensureDependencies();
-                timings['install'] = Date.now() - installStart;
-                console.log(chalk.green(`  ✓ Dependencies installed (${timings['install']}ms)`));
-                progress('installing-deps', `Dependencies installed (${timings['install']}ms)`);
-            }
-            catch (err) {
-                timings['install'] = Date.now() - installStart;
-                console.log(chalk.red(`  ✗ Install failed: ${err.message}`));
-                console.log(chalk.yellow(`  ⚠ Dev server may fail — retrying install on first request`));
-                progress('installing-deps', `Install failed: ${err.message}`);
-            }
-        }
-        else {
-            progress('installing-deps', 'Dependencies already installed (cached)');
-        }
-        // ── Phase 3: Start dev server ────────────────────────────────────
-        if (!opts.noDev) {
-            if (installer.areDependenciesInstalled()) {
-                progress('starting-dev', 'Starting dev server...');
+        // ── Phase 2: Install deps (if needed) — skip for LocalRepo ──
+        if (!isLocalRepo) {
+            const installer = new PackageInstaller({ projectDir });
+            const needsInstall = !installer.areDependenciesInstalled() && fs.existsSync(path.join(projectDir, 'package.json'));
+            if (needsInstall) {
+                const installStart = Date.now();
+                console.log(chalk.gray(`  Installing dependencies...`));
+                progress('installing-deps', 'Installing npm dependencies...');
                 try {
-                    const devStart = Date.now();
-                    await localServer.getDevServer().start();
-                    timings['dev-server'] = Date.now() - devStart;
-                    console.log(chalk.green(`  ✓ Dev server on port ${allocated.devPort} (${timings['dev-server']}ms)`));
-                    progress('starting-dev', `Dev server on port ${allocated.devPort}`);
+                    await installer.ensureDependencies();
+                    timings['install'] = Date.now() - installStart;
+                    console.log(chalk.green(`  ✓ Dependencies installed (${timings['install']}ms)`));
+                    progress('installing-deps', `Dependencies installed (${timings['install']}ms)`);
                 }
                 catch (err) {
-                    console.log(chalk.yellow(`  ⚠ Dev server: ${err.message}`));
-                    progress('starting-dev', `Warning: ${err.message}`);
+                    timings['install'] = Date.now() - installStart;
+                    console.log(chalk.red(`  ✗ Install failed: ${err.message}`));
+                    console.log(chalk.yellow(`  ⚠ Dev server may fail — retrying install on first request`));
+                    progress('installing-deps', `Install failed: ${err.message}`);
                 }
             }
             else {
-                console.log(chalk.yellow(`  ⚠ Skipping dev server — dependencies not installed`));
-                console.log(chalk.gray(`    Dev server will start when browser opens the project`));
-                progress('starting-dev', 'Skipped — dependencies not installed');
+                progress('installing-deps', 'Dependencies already installed (cached)');
+            }
+            // ── Phase 3: Start dev server — skip for LocalRepo ──
+            if (!opts.noDev) {
+                if (installer.areDependenciesInstalled()) {
+                    progress('starting-dev', 'Starting dev server...');
+                    try {
+                        const devStart = Date.now();
+                        await localServer.getDevServer().start();
+                        timings['dev-server'] = Date.now() - devStart;
+                        console.log(chalk.green(`  ✓ Dev server on port ${allocated.devPort} (${timings['dev-server']}ms)`));
+                        progress('starting-dev', `Dev server on port ${allocated.devPort}`);
+                    }
+                    catch (err) {
+                        console.log(chalk.yellow(`  ⚠ Dev server: ${err.message}`));
+                        progress('starting-dev', `Warning: ${err.message}`);
+                    }
+                }
+                else {
+                    console.log(chalk.yellow(`  ⚠ Skipping dev server — dependencies not installed`));
+                    console.log(chalk.gray(`    Dev server will start when browser opens the project`));
+                    progress('starting-dev', 'Skipped — dependencies not installed');
+                }
             }
         }
         // Ensure tunnel is connected before declaring ready

package/dist/tunnel.d.ts

@@ -27,6 +27,7 @@ interface TunnelClientOptions {
     /** Callback when gateway requests starting a new project on this device */
     onStartProject?: (projectId: string, options?: {
         clean?: boolean;
+        localFolderPath?: string;
     }) => Promise<void>;
     /** Callback for setup progress — lets the standby tunnel relay phases to gateway */
     onSetupProgress?: (projectId: string, phase: string, message: string) => void;

package/dist/tunnel.js

@@ -403,8 +403,8 @@ export class TunnelClient {
      * Handle start-project: gateway wants this agent to start serving a new project.
      * Called when user clicks "Connect" in the web editor's Cloud panel.
      */
-    async handleStartProject(projectId, clean) {
-        console.log(`  [Tunnel] Received start-project command for ${projectId}${clean ? ' (clean)' : ''}`);
+    async handleStartProject(projectId, clean, localFolderPath) {
+        console.log(`  [Tunnel] Received start-project command for ${projectId}${clean ? ' (clean)' : ''}${localFolderPath ? ` (local: ${localFolderPath})` : ''}`);
         if (!projectId) {
             this.send({ type: 'start-project-result', success: false, error: 'Missing projectId' });
             return;
@@ -413,7 +413,7 @@ export class TunnelClient {
             try {
                 // Send initial progress
                 this.sendSetupProgress(projectId, 'starting', 'Starting project setup...');
-                await this.options.onStartProject(projectId, clean ? { clean: true } : undefined);
+                await this.options.onStartProject(projectId, { ...(clean ? { clean: true } : {}), ...(localFolderPath ? { localFolderPath } : {}) });
                 this.sendSetupProgress(projectId, 'ready', 'Project is live!');
                 this.send({ type: 'start-project-result', projectId, success: true });
             }
@@ -474,7 +474,7 @@ export class TunnelClient {
                 this.handleWsClose(msg.wsId);
                 break;
             case 'start-project':
-                this.handleStartProject(msg.projectId, msg.clean);
+                this.handleStartProject(msg.projectId, msg.clean, msg.localFolderPath);
                 break;
             case 'force-disconnect':
                 console.log('  [Tunnel] Received force-disconnect — will not reconnect');

package/package.json

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