nstantpage-agent 0.8.8 → 0.8.10

package/dist/agentSync.d.ts

@@ -1,80 +1,26 @@
 /**
- * agentSync.ts — Simplified file sync for the local agent.
+ * agentSync.ts — File watcher for HMR notifications.
  *
- * CORE PRINCIPLE: Disk is ALWAYS the source of truth. ONE-WAY only.
- *
- * When files change on disk → do a FULL SYNC (same as `nstantpage sync`):
- *   1. POST /api/projects/{id}/sync — new version + clear ALL FullFiles
- *   2. Collect ALL disk files
- *   3. POST /api/sandbox/push-files — push ALL files in batches
- *
- * No checksums, no comparisons, no diffs. Disk wins. Always.
+ * Watches disk for file changes and fires onSyncDirty callback
+ * so the gateway can trigger HMR reload in the browser preview.
+ * That's it. No sync, no push, no pull, no status, no diffs.
  */
-export type SyncDirection = 'in-sync' | 'backend-ahead' | 'disk-ahead' | 'diverged';
-export interface SyncStatusResult {
-    inSync: boolean;
-    direction: SyncDirection;
-    diskChecksum: string | null;
-    backendChecksum: string | null;
-    diskFileCount: number;
-    backendFileCount: number;
-    modifiedFiles: string[];
-    diskOnlyFiles: string[];
-    backendOnlyFiles: string[];
-    lastSyncedVersionId: string | null;
-    lastSyncedAt: number | null;
-    diskDirty: boolean;
-    computedAt: number;
-}
-export interface PerFileStatus {
-    path: string;
-    status: 'same' | 'modified' | 'disk-only' | 'backend-only';
-    diskSha?: string;
-    backendSha?: string;
-}
 export interface AgentSyncOptions {
     projectDir: string;
     projectId: string;
     backendUrl: string;
-    /** Called when file watcher detects changes — should send sync-dirty via tunnel */
+    /** Called when file watcher detects changes — triggers HMR via tunnel */
     onSyncDirty?: (projectId: string) => void;
 }
 export declare class AgentSync {
     private projectDir;
     private projectId;
-    private backendUrl;
     private onSyncDirty?;
     private fileWatcher;
     private debounceTimer;
-    private syncing;
-    private lastVersionId;
-    private lastSyncAt;
     constructor(options: AgentSyncOptions);
     startFileWatcher(): void;
     stopFileWatcher(): void;
-    getSyncStatus(): Promise<SyncStatusResult>;
-    getPerFileStatus(): Promise<PerFileStatus[]>;
-    pushToBackend(): Promise<{
-        success: boolean;
-        filesPushed: number;
-        filesDeleted: number;
-        modifiedFiles: string[];
-        addedFiles: string[];
-        deletedFiles: string[];
-        versionId?: string;
-        message?: string;
-    }>;
-    markSynced(versionId: string): void;
-    /** 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.
-     * After writing, clears pending changes (the writes would trigger the watcher).
-     */
-    pullFromBackend(): Promise<{
-        success: boolean;
-        filesWritten: number;
-        versionId?: string;
-    }>;
+    markSynced(_versionId: string): void;
     destroy(): void;
 }

package/dist/agentSync.js

@@ -1,17 +1,11 @@
 /**
- * agentSync.ts — Simplified file sync for the local agent.
+ * agentSync.ts — File watcher for HMR notifications.
  *
- * CORE PRINCIPLE: Disk is ALWAYS the source of truth. ONE-WAY only.
- *
- * When files change on disk → do a FULL SYNC (same as `nstantpage sync`):
- *   1. POST /api/projects/{id}/sync — new version + clear ALL FullFiles
- *   2. Collect ALL disk files
- *   3. POST /api/sandbox/push-files — push ALL files in batches
- *
- * No checksums, no comparisons, no diffs. Disk wins. Always.
+ * Watches disk for file changes and fires onSyncDirty callback
+ * so the gateway can trigger HMR reload in the browser preview.
+ * That's it. No sync, no push, no pull, no status, no diffs.
  */
 import path from 'path';
-import fs from 'fs/promises';
 import { watch, existsSync } from 'fs';
 // ─── Skip Patterns ────────────────────────────────────────────
 const SKIP_DIRS = new Set([
@@ -33,8 +27,6 @@ const SKIP_EXTENSIONS = new Set([
     '.sqlite', '.db',
     '.svg',
 ]);
-/** Max file size to sync (1MB) */
-const MAX_FILE_SIZE = 1_048_576;
 function shouldSkip(name, isDir) {
     if (isDir)
         return SKIP_DIRS.has(name) || name.startsWith('.');
@@ -45,7 +37,6 @@ function shouldSkip(name, isDir) {
     const ext = path.extname(name).toLowerCase();
     return SKIP_EXTENSIONS.has(ext);
 }
-/** Check if a relative path should be skipped (checks every path component) */
 function shouldSkipPath(relPath) {
     const parts = relPath.split(/[\/\\]/);
     for (let i = 0; i < parts.length - 1; i++) {
@@ -54,60 +45,17 @@ function shouldSkipPath(relPath) {
     }
     return shouldSkip(parts[parts.length - 1], false);
 }
-// ─── Collect All Files (same as sync.ts) ──────────────────────
-async function collectAllFiles(baseDir, currentDir) {
-    const files = [];
-    let entries;
-    try {
-        entries = await fs.readdir(currentDir, { withFileTypes: true });
-    }
-    catch {
-        return files;
-    }
-    for (const entry of entries) {
-        const fullPath = path.join(currentDir, entry.name);
-        if (entry.isDirectory()) {
-            if (shouldSkip(entry.name, true))
-                continue;
-            const sub = await collectAllFiles(baseDir, fullPath);
-            files.push(...sub);
-        }
-        else if (entry.isFile()) {
-            if (shouldSkip(entry.name, false))
-                continue;
-            try {
-                const stat = await fs.stat(fullPath);
-                if (stat.size > MAX_FILE_SIZE)
-                    continue;
-                const content = await fs.readFile(fullPath, 'utf-8');
-                if (content.includes('\0'))
-                    continue; // binary
-                const relativePath = path.relative(baseDir, fullPath).replace(/\\/g, '/');
-                files.push({ relativePath, content });
-            }
-            catch { /* unreadable — skip */ }
-        }
-    }
-    return files;
-}
 export class AgentSync {
     projectDir;
     projectId;
-    backendUrl;
     onSyncDirty;
-    // State
     fileWatcher = null;
     debounceTimer = null;
-    syncing = false;
-    lastVersionId = null;
-    lastSyncAt = null;
     constructor(options) {
         this.projectDir = options.projectDir;
         this.projectId = options.projectId;
-        this.backendUrl = options.backendUrl;
         this.onSyncDirty = options.onSyncDirty;
     }
-    // ─── File Watcher ─────────────────────────────────────────
     startFileWatcher() {
         if (this.fileWatcher)
             return;
@@ -119,7 +67,6 @@ export class AgentSync {
                     return;
                 if (shouldSkipPath(filename))
                     return;
-                // Debounce — just fire HMR notification, no file tracking
                 if (this.debounceTimer)
                     clearTimeout(this.debounceTimer);
                 this.debounceTimer = setTimeout(() => {
@@ -149,160 +96,8 @@ export class AgentSync {
             this.debounceTimer = null;
         }
     }
-    // ─── Sync Status ─────────────────────────────────────────
-    async getSyncStatus() {
-        return {
-            inSync: true,
-            direction: 'in-sync',
-            diskChecksum: null,
-            backendChecksum: null,
-            diskFileCount: 0,
-            backendFileCount: 0,
-            modifiedFiles: [],
-            diskOnlyFiles: [],
-            backendOnlyFiles: [],
-            lastSyncedVersionId: this.lastVersionId,
-            lastSyncedAt: this.lastSyncAt,
-            diskDirty: false,
-            computedAt: Date.now(),
-        };
-    }
-    // ─── Per-File Status ──────────────────────────────────────
-    async getPerFileStatus() {
-        return [];
-    }
-    // ─── Push to Backend (Full Sync) ──────────────────────────
-    //
-    // Does EXACTLY what `nstantpage sync` does:
-    //   1. POST /api/projects/{id}/sync — new version + clear ALL FullFiles
-    //   2. Collect ALL files from disk
-    //   3. POST /api/sandbox/push-files — push ALL files in batches of 100
-    async pushToBackend() {
-        if (this.syncing) {
-            return {
-                success: true, filesPushed: 0, filesDeleted: 0,
-                modifiedFiles: [], addedFiles: [], deletedFiles: [],
-                message: 'Sync already in progress',
-            };
-        }
-        this.syncing = true;
-        try {
-            // Step 1: Create new version + clear all FullFiles
-            const syncRes = await fetch(`${this.backendUrl}/api/projects/${this.projectId}/sync`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-            });
-            if (!syncRes.ok) {
-                const text = await syncRes.text().catch(() => '');
-                throw new Error(`Sync init failed (${syncRes.status}): ${text}`);
-            }
-            const syncData = await syncRes.json();
-            console.log(`  [AgentSync] New version ${syncData.versionNumber} created (old files cleared)`);
-            // Step 2: Collect ALL files from disk
-            const allFiles = await collectAllFiles(this.projectDir, this.projectDir);
-            // Step 3: Push in batches of 100
-            const BATCH_SIZE = 100;
-            let totalPushed = 0;
-            for (let i = 0; i < allFiles.length; i += BATCH_SIZE) {
-                const batch = allFiles.slice(i, i + BATCH_SIZE);
-                const filesMap = {};
-                for (const f of batch) {
-                    filesMap[f.relativePath] = f.content;
-                }
-                const pushRes = await fetch(`${this.backendUrl}/api/sandbox/push-files`, {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({
-                        projectId: parseInt(this.projectId, 10),
-                        files: filesMap,
-                    }),
-                });
-                if (!pushRes.ok) {
-                    const text = await pushRes.text().catch(() => '');
-                    throw new Error(`Push batch failed (${pushRes.status}): ${text}`);
-                }
-                totalPushed += batch.length;
-            }
-            // Done
-            this.lastVersionId = String(syncData.versionId);
-            this.lastSyncAt = Date.now();
-            const fileNames = allFiles.map(f => f.relativePath);
-            console.log(`  [AgentSync] Full sync complete: ${totalPushed} files pushed (version ${syncData.versionNumber})`);
-            return {
-                success: true,
-                filesPushed: totalPushed,
-                filesDeleted: 0,
-                modifiedFiles: fileNames,
-                addedFiles: [],
-                deletedFiles: [],
-                versionId: String(syncData.versionId),
-            };
-        }
-        catch (err) {
-            console.error(`  [AgentSync] Sync failed:`, err.message);
-            throw err;
-        }
-        finally {
-            this.syncing = false;
-        }
-    }
-    // ─── Sync Markers (for compatibility with start.ts) ───────
-    markSynced(versionId) {
-        this.lastVersionId = versionId;
-        this.lastSyncAt = Date.now();
-        console.log(`  [AgentSync] Marked synced at version ${versionId}`);
-    }
-    /** Read a single file from disk (for diff view) */
-    async readDiskFile(filePath) {
-        try {
-            const normalized = path.normalize(filePath).replace(/\.\.\//g, '');
-            const fullPath = path.join(this.projectDir, normalized);
-            if (!fullPath.startsWith(this.projectDir))
-                return null;
-            return await fs.readFile(fullPath, 'utf-8');
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Pull files from the backend DB and write them to disk.
-     * After writing, clears pending changes (the writes would trigger the watcher).
-     */
-    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 };
-        }
-        const dirsToCreate = new Set();
-        for (const file of data.files) {
-            const fp = path.join(this.projectDir, file.path);
-            dirsToCreate.add(path.dirname(fp));
-        }
-        for (const dir of dirsToCreate) {
-            await fs.mkdir(dir, { recursive: true }).catch(() => { });
-        }
-        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 fp = path.join(this.projectDir, file.path);
-                await fs.writeFile(fp, file.content, 'utf-8');
-            }));
-            written += batch.length;
-        }
-        this.lastVersionId = String(data.versionId);
-        this.lastSyncAt = Date.now();
-        console.log(`  [AgentSync] Pulled ${written} files from backend (version ${data.versionId})`);
-        return { success: true, filesWritten: written, versionId: String(data.versionId) };
-    }
-    // ─── Cleanup ──────────────────────────────────────────────
+    // Stubs kept for API compat so localServer.ts doesn't break
+    markSynced(_versionId) { }
     destroy() {
         this.stopFileWatcher();
     }

package/dist/localServer.d.ts

@@ -124,11 +124,6 @@ export declare class LocalServer {
     private handleStats;
     private handleUsage;
     private handleBuild;
-    private handleSyncStatus;
-    private handleSyncDiff;
-    private handlePushToBackend;
-    private handlePullFromBackend;
-    private handleDiskFile;
     private handleTree;
     private handleFileContent;
     private handleSaveFile;

package/dist/localServer.js

@@ -401,11 +401,6 @@ export class LocalServer {
             '/live/db/query': this.handleDbQuery,
             '/live/db/create': this.handleDbCreate,
             '/live/build': this.handleBuild,
-            '/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,
             '/live/tree': this.handleTree,
             '/live/file-content': this.handleFileContent,
             '/live/save-file': this.handleSaveFile,
@@ -1186,98 +1181,6 @@ export class LocalServer {
             this.json(res, { success: false, error: err.message });
         }
     }
-    // ─── /live/sync-status ────────────────────────────────────────
-    async handleSyncStatus(_req, res, _body, url) {
-        if (!this.agentSync) {
-            this.json(res, { success: false, error: 'Sync not available (no backendUrl configured)' }, 503);
-            return;
-        }
-        try {
-            const status = await this.agentSync.getSyncStatus();
-            this.json(res, { success: true, ...status });
-        }
-        catch (error) {
-            console.error(`  [LocalServer] sync-status error:`, error.message);
-            this.json(res, { success: false, error: error.message }, 500);
-        }
-    }
-    // ─── /live/sync-diff ─────────────────────────────────────────
-    async handleSyncDiff(_req, res, _body, url) {
-        if (!this.agentSync) {
-            this.json(res, { success: false, error: 'Sync not available (no backendUrl configured)' }, 503);
-            return;
-        }
-        try {
-            const files = await this.agentSync.getPerFileStatus();
-            const changed = files.filter(f => f.status !== 'same');
-            this.json(res, {
-                success: true,
-                totalFiles: files.length,
-                changedCount: changed.length,
-                files: changed,
-            });
-        }
-        catch (error) {
-            console.error(`  [LocalServer] sync-diff error:`, error.message);
-            this.json(res, { success: false, error: error.message }, 500);
-        }
-    }
-    // ─── /live/push-to-backend ───────────────────────────────────
-    async handlePushToBackend(_req, res, _body) {
-        if (!this.agentSync) {
-            this.json(res, { success: false, error: 'Sync not available (no backendUrl configured)' }, 503);
-            return;
-        }
-        try {
-            const result = await this.agentSync.pushToBackend();
-            this.json(res, result);
-        }
-        catch (error) {
-            console.error(`  [LocalServer] push-to-backend error:`, error.message);
-            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');
-        if (!filePath) {
-            this.json(res, { error: 'Missing path parameter' }, 400);
-            return;
-        }
-        if (!this.agentSync) {
-            this.json(res, { success: false, error: 'Sync not available' }, 503);
-            return;
-        }
-        try {
-            const content = await this.agentSync.readDiskFile(filePath);
-            if (content === null) {
-                this.json(res, { error: 'File not found' }, 404);
-                return;
-            }
-            res.statusCode = 200;
-            res.setHeader('Content-Type', 'text/plain; charset=utf-8');
-            res.setHeader('Access-Control-Allow-Origin', '*');
-            res.end(content);
-        }
-        catch (error) {
-            this.json(res, { success: false, error: error.message }, 500);
-        }
-    }
     // ─── /live/tree ──────────────────────────────────────────────
     async handleTree(_req, res) {
         try {

package/package.json

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