nstantpage-agent 0.5.26 → 0.5.28

package/dist/agentSync.d.ts

@@ -81,5 +81,15 @@ export declare class AgentSync {
     private snapshotBaseline;
     /** Read a single file from disk (for diff view) */
     readDiskFile(filePath: string): Promise<string | null>;
+    /**
+     * Pull files from the backend DB and write them to disk.
+     * This fetches ALL project files and overwrites local versions.
+     * Files that exist only on disk (not in DB) are left untouched.
+     */
+    pullFromBackend(): Promise<{
+        success: boolean;
+        filesWritten: number;
+        versionId?: string;
+    }>;
     destroy(): void;
 }

package/dist/agentSync.js

@@ -410,12 +410,14 @@ export class AgentSync {
         const backendResult = await this.fetchBackendChecksums();
         if (!backendResult)
             return [];
+        // Use filtered backend checksums (same skip rules as disk scan) for consistency with getSyncStatus
+        const filteredBackend = this.filterBackendChecksums(backendResult.checksums);
         const baseline = this.syncedBaselineChecksums;
         const result = [];
         if (baseline) {
             for (const [filePath, baselineSha] of baseline) {
                 const currentDiskSha = diskComputed.checksums.get(filePath);
-                const backendSha = backendResult.checksums.get(filePath);
+                const backendSha = filteredBackend.get(filePath);
                 if (!currentDiskSha) {
                     if (backendSha) {
                         result.push({ path: filePath, status: 'modified', backendSha });
@@ -431,7 +433,7 @@ export class AgentSync {
                 }
             }
             if (this.lastSyncTimestamp && this.lastSyncTimestamp.versionId !== backendResult.versionId) {
-                for (const [filePath, backendSha] of backendResult.checksums) {
+                for (const [filePath, backendSha] of filteredBackend) {
                     if (!baseline.has(filePath) && !diskComputed.checksums.has(filePath)) {
                         result.push({ path: filePath, status: 'backend-only', backendSha });
                     }
@@ -439,7 +441,7 @@ export class AgentSync {
             }
         }
         else {
-            const sortedBackend = [...backendResult.checksums.entries()].sort((a, b) => a[0].localeCompare(b[0]));
+            const sortedBackend = [...filteredBackend.entries()].sort((a, b) => a[0].localeCompare(b[0]));
             for (const [filePath, backendSha] of sortedBackend) {
                 const diskSha = diskComputed.checksums.get(filePath);
                 if (diskSha) {
@@ -456,7 +458,7 @@ export class AgentSync {
             }
             const sortedDisk = [...diskComputed.checksums.entries()].sort((a, b) => a[0].localeCompare(b[0]));
             for (const [filePath, diskSha] of sortedDisk) {
-                if (!backendResult.checksums.has(filePath) && isUserCreatedFile(filePath)) {
+                if (!filteredBackend.has(filePath) && isUserCreatedFile(filePath)) {
                     result.push({ path: filePath, status: 'disk-only', diskSha });
                 }
             }
@@ -578,6 +580,49 @@ export class AgentSync {
             return null;
         }
     }
+    /**
+     * Pull files from the backend DB and write them to disk.
+     * This fetches ALL project files and overwrites local versions.
+     * Files that exist only on disk (not in DB) are left untouched.
+     */
+    async pullFromBackend() {
+        const url = `${this.backendUrl}/api/sandbox/files?projectId=${this.projectId}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch files from backend: ${response.status}`);
+        }
+        const data = await response.json();
+        if (!data.files || data.files.length === 0) {
+            return { success: true, filesWritten: 0 };
+        }
+        // Ensure directories exist
+        const dirsToCreate = new Set();
+        for (const file of data.files) {
+            const filePath = path.join(this.projectDir, file.path);
+            dirsToCreate.add(path.dirname(filePath));
+        }
+        for (const dir of dirsToCreate) {
+            await fs.mkdir(dir, { recursive: true }).catch(() => { });
+        }
+        // Write files in parallel batches
+        const BATCH_SIZE = 50;
+        let written = 0;
+        for (let i = 0; i < data.files.length; i += BATCH_SIZE) {
+            const batch = data.files.slice(i, i + BATCH_SIZE);
+            await Promise.all(batch.map(async (file) => {
+                const filePath = path.join(this.projectDir, file.path);
+                await fs.writeFile(filePath, file.content, 'utf-8');
+            }));
+            written += batch.length;
+        }
+        // Invalidate caches and re-establish baseline
+        this.diskChecksumCache = null;
+        this.backendChecksumCache = null;
+        const versionId = String(data.versionId);
+        this.markSynced(versionId);
+        console.log(`  [AgentSync] Pulled ${written} files from backend (version ${versionId})`);
+        return { success: true, filesWritten: written, versionId };
+    }
     // ─── Cleanup ──────────────────────────────────────────────
     destroy() {
         this.stopFileWatcher();

package/dist/cli.js

@@ -25,7 +25,7 @@ const program = new Command();
 program
     .name('nstantpage')
     .description('Local development agent for nstantpage.com — run projects on your machine, preview in the cloud')
-    .version('0.5.26');
+    .version('0.5.28');
 program
     .command('login')
     .description('Authenticate with nstantpage.com')

package/dist/commands/start.js

@@ -26,7 +26,7 @@ import { LocalServer } from '../localServer.js';
 import { PackageInstaller } from '../packageInstaller.js';
 import { probeLocalPostgres, ensureLocalProjectDb, closeAdminPool, writeDatabaseUrlToEnv } from '../projectDb.js';
 import { StatusServer } from '../statusServer.js';
-const VERSION = '0.5.26';
+const VERSION = '0.5.28';
 /**
  * Resolve the backend API base URL.
  * - If --backend is passed, use it
@@ -685,12 +685,21 @@ async function startAdditionalProject(projectId, opts) {
         const serverEnv = {};
         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).
+        let tunnel;
         const localServer = new LocalServer({
             projectDir, projectId,
             apiPort: allocated.apiPort, devPort: allocated.devPort,
             env: serverEnv,
+            backendUrl: opts.backendUrl,
+            onSyncDirty: (pid) => {
+                if (tunnel) {
+                    tunnel.sendSyncDirty(pid);
+                }
+            },
         });
-        const tunnel = new TunnelClient({
+        tunnel = new TunnelClient({
             gatewayUrl: opts.gatewayUrl,
             token: opts.token,
             projectId,
@@ -714,8 +723,10 @@ async function startAdditionalProject(projectId, opts) {
             }
         })();
         const fileStart = Date.now();
+        let fetchedVersionId;
         try {
-            await fetchProjectFiles(opts.backendUrl, projectId, projectDir, opts.token);
+            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)`);
         }
@@ -730,6 +741,10 @@ async function startAdditionalProject(projectId, opts) {
         // Wait for API server before proceeding (tunnel can keep connecting in background)
         await apiServerPromise;
         progress('starting-server', `API server ready`);
+        // Set sync baseline so file watcher knows what "clean" looks like
+        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'));

package/dist/localServer.d.ts

@@ -127,6 +127,7 @@ export declare class LocalServer {
     private handleSyncStatus;
     private handleSyncDiff;
     private handlePushToBackend;
+    private handlePullFromBackend;
     private handleDiskFile;
     private handleHealth;
     /**

package/dist/localServer.js

@@ -282,6 +282,7 @@ export class LocalServer {
             '/live/sync-status': this.handleSyncStatus,
             '/live/sync-diff': this.handleSyncDiff,
             '/live/push-to-backend': this.handlePushToBackend,
+            '/live/pull-from-backend': this.handlePullFromBackend,
             '/live/disk-file': this.handleDiskFile,
             '/health': this.handleHealth,
         };
@@ -1102,6 +1103,21 @@ export class LocalServer {
             this.json(res, { success: false, error: error.message }, 500);
         }
     }
+    // ─── /live/pull-from-backend ──────────────────────────────────
+    async handlePullFromBackend(_req, res) {
+        if (!this.agentSync) {
+            this.json(res, { success: false, error: 'Sync not available (no backendUrl configured)' }, 503);
+            return;
+        }
+        try {
+            const result = await this.agentSync.pullFromBackend();
+            this.json(res, result);
+        }
+        catch (error) {
+            console.error(`  [LocalServer] pull-from-backend error:`, error.message);
+            this.json(res, { success: false, error: error.message }, 500);
+        }
+    }
     // ─── /live/disk-file ─────────────────────────────────────────
     async handleDiskFile(_req, res, _body, url) {
         const filePath = url.searchParams.get('path');

package/package.json

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