nstantpage-agent 0.5.15 → 0.5.17

package/dist/commands/start.js

@@ -25,7 +25,7 @@ import { TunnelClient } from '../tunnel.js';
 import { LocalServer } from '../localServer.js';
 import { PackageInstaller } from '../packageInstaller.js';
 import { probeLocalPostgres, ensureLocalProjectDb, closeAdminPool, writeDatabaseUrlToEnv } from '../projectDb.js';
-const VERSION = '0.5.15';
+const VERSION = '0.5.17';
 /**
  * Resolve the backend API base URL.
  * - If --backend is passed, use it
@@ -499,8 +499,23 @@ async function startStandbyMode(token, options, backendUrl, deviceId) {
         projectId: '_standby_',
         apiPort: 0,
         devPort: 0,
-        onStartProject: async (pid) => {
-            if (activeProjects.has(pid)) {
+        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 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 });
+                }
+            }
+            else if (activeProjects.has(pid)) {
                 console.log(chalk.yellow(`  Project ${pid} is already running`));
                 return;
             }
@@ -616,7 +631,6 @@ async function startAdditionalProject(projectId, opts) {
                 databaseUrl = await ensureLocalProjectDb(projectId);
                 if (databaseUrl) {
                     console.log(chalk.green(`  ✓ Database ready: project_${projectId}`));
-                    writeDatabaseUrlToEnv(projectDir, databaseUrl);
                 }
             }
         }
@@ -662,6 +676,10 @@ async function startAdditionalProject(projectId, opts) {
             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) {
+            writeDatabaseUrlToEnv(projectDir, databaseUrl);
+        }
         // Wait for API server before proceeding (tunnel can keep connecting in background)
         await apiServerPromise;
         progress('starting-server', `API server ready`);

package/dist/devServer.js

@@ -9,6 +9,32 @@ import path from 'path';
 import fs from 'fs';
 import http from 'http';
 import os from 'os';
+/**
+ * Parse a .env file into a key-value map.
+ * Handles KEY=VALUE, KEY="VALUE", KEY='VALUE', comments (#), and empty lines.
+ */
+function parseDotenv(filePath) {
+    if (!fs.existsSync(filePath))
+        return {};
+    const result = {};
+    const lines = fs.readFileSync(filePath, 'utf-8').split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        let val = trimmed.slice(eqIdx + 1).trim();
+        // Strip surrounding quotes
+        if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+            val = val.slice(1, -1);
+        }
+        result[key] = val;
+    }
+    return result;
+}
 export class DevServer {
     options;
     process = null;
@@ -39,6 +65,8 @@ export class DevServer {
         }
         const { projectDir, port } = this.options;
         const extraEnv = this.options.env || {};
+        // Load .env file from project root (lower priority than explicit env vars)
+        const dotenvVars = parseDotenv(path.join(projectDir, '.env'));
         // Detect project type
         const pkgPath = path.join(projectDir, 'package.json');
         if (!fs.existsSync(pkgPath)) {
@@ -63,6 +91,7 @@ export class DevServer {
                 cwd: projectDir,
                 env: {
                     ...process.env,
+                    ...dotenvVars,
                     ...extraEnv,
                     PORT: String(backendPort),
                     SERVER_PORT: String(backendPort),
@@ -97,6 +126,7 @@ export class DevServer {
         }
         const frontendEnv = {
             ...process.env,
+            ...dotenvVars,
             ...extraEnv,
             PORT: String(port),
         };

package/dist/tunnel.d.ts

@@ -24,7 +24,9 @@ interface TunnelClientOptions {
     /** Port where the dev server (Vite/Next.js) runs */
     devPort: number;
     /** Callback when gateway requests starting a new project on this device */
-    onStartProject?: (projectId: string) => Promise<void>;
+    onStartProject?: (projectId: string, options?: {
+        clean?: boolean;
+    }) => 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

@@ -246,8 +246,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) {
-        console.log(`  [Tunnel] Received start-project command for ${projectId}`);
+    async handleStartProject(projectId, clean) {
+        console.log(`  [Tunnel] Received start-project command for ${projectId}${clean ? ' (clean)' : ''}`);
         if (!projectId) {
             this.send({ type: 'start-project-result', success: false, error: 'Missing projectId' });
             return;
@@ -256,7 +256,7 @@ export class TunnelClient {
             try {
                 // Send initial progress
                 this.sendSetupProgress(projectId, 'starting', 'Starting project setup...');
-                await this.options.onStartProject(projectId);
+                await this.options.onStartProject(projectId, clean ? { clean: true } : undefined);
                 this.sendSetupProgress(projectId, 'ready', 'Project is live!');
                 this.send({ type: 'start-project-result', projectId, success: true });
             }
@@ -300,7 +300,7 @@ export class TunnelClient {
                 this.handleWsClose(msg.wsId);
                 break;
             case 'start-project':
-                this.handleStartProject(msg.projectId);
+                this.handleStartProject(msg.projectId, msg.clean);
                 break;
             default:
                 console.warn(`  [Tunnel] Unknown message type: ${msg.type}`);

package/package.json

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