veryfront 0.1.18 → 0.1.19

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.18",
+    "version": "0.1.19",
     "nodeModulesDir": "auto",
     "exclude": [
         "npm/",

package/esm/src/modules/react-loader/ssr-module-loader/cache/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../../src/src/modules/react-loader/ssr-module-loader/cache/memory.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAO5D,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOnE,eAAO,MAAM,iBAAiB,oCAE5B,CAAC;AAEH,eAAO,MAAM,uBAAuB,oCAElC,CAAC;AAEH,eAAO,MAAM,gBAAgB,4BAAmC,CAAC;AAEjE,eAAO,MAAM,aAAa,0BAExB,CAAC;AAEH,eAAO,MAAM,gBAAgB,4BAAmC,CAAC;AAGjE,wBAAgB,qBAAqB,IAAI,SAAS,CAKjD;AAsBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAW/D;AAKD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAU5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAOA;AAiDD,wBAAgB,mBAAmB,IAAI,IAAI,CAqB1C;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAiDrE"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../../src/src/modules/react-loader/ssr-module-loader/cache/memory.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAO5D,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOnE,eAAO,MAAM,iBAAiB,oCAE5B,CAAC;AAEH,eAAO,MAAM,uBAAuB,oCAElC,CAAC;AAEH,eAAO,MAAM,gBAAgB,4BAAmC,CAAC;AAEjE,eAAO,MAAM,aAAa,0BAExB,CAAC;AAEH,eAAO,MAAM,gBAAgB,4BAAmC,CAAC;AAGjE,wBAAgB,qBAAqB,IAAI,SAAS,CAKjD;AAsBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAW/D;AAKD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAU5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAOA;AAiDD,wBAAgB,mBAAmB,IAAI,IAAI,CAqB1C;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAiDrE"}

package/esm/src/modules/react-loader/ssr-module-loader/cache/memory.js

@@ -15,6 +15,7 @@
 import * as dntShim from "../../../../../_dnt.shims.js";
 import { registerCache } from "../../../../utils/memory/index.js";
 import { isKeyForProject, registerMapCache } from "../../../../cache/keys.js";
+import { hashCodeHex } from "../../../../utils/hash-utils.js";
 import { rendererLogger } from "../../../../utils/index.js";
 import { LRUCache } from "../../../../utils/lru-wrapper.js";
 import { getMaxConcurrentTransforms, getTransformPerProjectLimit, resetCachedTransformLimits, SSR_TMP_DIRS_MAX_ENTRIES, } from "../constants.js";
@@ -179,7 +180,7 @@ export function clearSSRModuleCache() {
 }
 export function clearSSRModuleCacheForProject(projectId) {
     let cleared = 0;
-    const encodedProjectId = encodeURIComponent(projectId);
+    const encodedProjectId = hashCodeHex(projectId);
     for (const key of globalModuleCache.keys()) {
         if (!isKeyForProject(key, projectId))
             continue;

package/esm/src/modules/react-loader/ssr-module-loader/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAgCpC,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAwB3E;;;;;GAKG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,YAAY,CAAyB;gBAEzB,OAAO,EAAE,sBAAsB;IAWnD,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,4BAA4B;YAetB,qBAAqB;YAuCrB,0BAA0B;IA2FxC,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YA+C1C,2BAA2B;IAYzC,OAAO,CAAC,yBAAyB;YAiBnB,2BAA2B;CAqU1C"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAiCpC,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAwB3E;;;;;GAKG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,YAAY,CAAyB;gBAEzB,OAAO,EAAE,sBAAsB;IAWnD,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,4BAA4B;YAetB,qBAAqB;YAuCrB,0BAA0B;IA2FxC,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YA+C1C,2BAA2B;IAYzC,OAAO,CAAC,yBAAyB;YAiBnB,2BAA2B;CAqU1C"}

package/esm/src/modules/react-loader/ssr-module-loader/loader.js

@@ -11,6 +11,7 @@ import { parseLocalImports, } from "../../../transforms/esm/import-parser.js";
 import { createFileSystem } from "../../../platform/compat/fs.js";
 import { verifyCacheFileExists, writeCacheFile } from "../../../utils/cache-file-ops.js";
 import { createError, toError } from "../../../errors/veryfront-error.js";
+import { hashCodeHex } from "../../../utils/hash-utils.js";
 import { rendererLogger } from "../../../utils/index.js";
 import { withSpan } from "../../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../../observability/tracing/span-names.js";
@@ -253,7 +254,7 @@ export class SSRModuleLoader {
         }
         if (this.options.projectId && this.options.contentSourceId) {
             const baseCacheDir = getMdxEsmCacheDir();
-            const projectKey = encodeURIComponent(this.options.projectId);
+            const projectKey = hashCodeHex(this.options.projectId);
             const sourceKey = this.options.contentSourceId;
             const mdxCacheDir = join(baseCacheDir, projectKey, sourceKey);
             const mdxCacheResult = await lookupMdxEsmCache(filePath, mdxCacheDir, this.options.projectDir, contentHash);

package/esm/src/modules/react-loader/ssr-module-loader/tmp-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tmp-paths.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/tmp-paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,MAAM,CAGR;AAED,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,MAAM,CAGR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAYR"}
+{"version":3,"file":"tmp-paths.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/tmp-paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,MAAM,CAGR;AAED,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,MAAM,CAGR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAYR"}

package/esm/src/modules/react-loader/ssr-module-loader/tmp-paths.js

@@ -2,12 +2,13 @@
  * Temp directory and temp file path helpers for SSR module loader cache.
  */
 import { join } from "../../../platform/compat/path/index.js";
+import { hashCodeHex } from "../../../utils/hash-utils.js";
 export function getTmpDirCacheKey(baseCacheDir, projectId, contentSourceId) {
-    const projectKey = encodeURIComponent(projectId);
+    const projectKey = hashCodeHex(projectId);
     return `${baseCacheDir}|${projectKey}|${contentSourceId}`;
 }
 export function buildTmpDirPath(baseCacheDir, projectId, contentSourceId) {
-    const projectKey = encodeURIComponent(projectId);
+    const projectKey = hashCodeHex(projectId);
     return join(baseCacheDir, projectKey, contentSourceId);
 }
 export function buildTempModulePath(tmpDir, filePath, projectDir, version, contentHash) {

package/esm/src/modules/react-loader/ssr-module-loader/vf-module-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vf-module-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/vf-module-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAWzE,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,6BAA6B;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAelE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CA8CjB"}
+{"version":3,"file":"vf-module-resolver.d.ts","sourceRoot":"","sources":["../../../../../src/src/modules/react-loader/ssr-module-loader/vf-module-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAWzE,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,6BAA6B;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAelE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CA8CjB"}

package/esm/src/modules/react-loader/ssr-module-loader/vf-module-resolver.js

@@ -4,6 +4,7 @@
  * Extracts and resolves /_vf_modules/* imports into file:// cache paths.
  */
 import { join } from "../../../platform/compat/path/index.js";
+import { hashCodeHex } from "../../../utils/hash-utils.js";
 import { rendererLogger } from "../../../utils/index.js";
 import { getMdxEsmCacheDir } from "../../../utils/cache-dir.js";
 import { createModuleFetcherContext, fetchAndCacheModule, } from "../../../transforms/mdx/esm-module-loader/module-fetcher/index.js";
@@ -40,7 +41,7 @@ export async function resolveVfModuleImports(code, options) {
         paths: imports.map((i) => i.path).slice(0, 5),
     });
     const baseCacheDir = getMdxEsmCacheDir();
-    const projectKey = encodeURIComponent(options.projectId);
+    const projectKey = hashCodeHex(options.projectId);
     const esmCacheDir = join(baseCacheDir, projectKey, options.contentSourceId);
     const fetcherContext = createModuleFetcherContext(esmCacheDir, options.adapter, options.projectDir, options.projectId, {
         reactVersion: options.reactVersion,

package/esm/src/platform/adapters/fs/veryfront/file-list-index.d.ts

@@ -6,6 +6,7 @@ export declare class FileListIndex {
     private readonly getFileListCache?;
     private index;
     private indexKey;
+    private indexBuiltAt;
     private readyPromise;
     constructor(getFileListCache?: (() => Promise<Array<FileListCacheEntry> | undefined>) | undefined);
     setReadyPromise(promise: Promise<void>): void;

package/esm/src/platform/adapters/fs/veryfront/file-list-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-list-index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/file-list-index.ts"],"names":[],"mappings":"AAIA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IALpC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAA8B;gBAG/B,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC,aAAA;IAG1F,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7C,KAAK,IAAI,IAAI;IASP,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAkCnD,UAAU;CAiDzB"}
+{"version":3,"file":"file-list-index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/file-list-index.ts"],"names":[],"mappings":"AAIA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IANpC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAA8B;gBAG/B,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC,aAAA;IAG1F,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7C,KAAK,IAAI,IAAI;IAUP,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAkCnD,UAAU;CA0EzB"}

package/esm/src/platform/adapters/fs/veryfront/file-list-index.js

@@ -9,10 +9,12 @@ function hashPreview(content) {
 function previewText(content, max = 80) {
     return content.length > max ? `${content.slice(0, max)}...` : content;
 }
+const INDEX_STALENESS_LIMIT_MS = 5 * 60 * 1000; // 5 minutes
 export class FileListIndex {
     getFileListCache;
     index = null;
     indexKey = null;
+    indexBuiltAt = 0;
     readyPromise = null;
     constructor(getFileListCache) {
         this.getFileListCache = getFileListCache;
@@ -26,6 +28,7 @@ export class FileListIndex {
         const size = this.index.size;
         this.index = null;
         this.indexKey = null;
+        this.indexBuiltAt = 0;
         logger.debug("Cleared file list index", { entriesCleared: size });
     }
     async lookup(normalizedPath) {
@@ -65,6 +68,27 @@ export class FileListIndex {
         }
         const fileList = await this.getFileListCache();
         if (!fileList) {
+            // Cache entry expired or unavailable. If we already have a built index from a
+            // previous successful cache read, keep using it rather than forcing network fetches.
+            // The index stays valid until explicitly cleared via clear() (triggered by WebSocket pokes)
+            // or until INDEX_STALENESS_LIMIT_MS elapses (safety net for missed pokes).
+            if (this.index) {
+                const age = Date.now() - this.indexBuiltAt;
+                if (age < INDEX_STALENESS_LIMIT_MS) {
+                    logger.debug("getOrBuildFileListIndex: cache expired, using existing in-memory index", {
+                        indexSize: this.index.size,
+                        indexAgeMs: age,
+                    });
+                    return this.index;
+                }
+                logger.debug("getOrBuildFileListIndex: in-memory index too stale, discarding", {
+                    indexSize: this.index.size,
+                    indexAgeMs: age,
+                    staleLimitMs: INDEX_STALENESS_LIMIT_MS,
+                });
+                this.index = null;
+                this.indexKey = null;
+            }
             logger.debug("[ReadOperations] getOrBuildFileListIndex: getFileListCache returned null/undefined");
             return null;
         }
@@ -77,8 +101,10 @@ export class FileListIndex {
             sampleContentPreview: cacheCheckSample?.content?.slice(0, 200)?.replace(/\n/g, "\\n"),
         });
         const indexKey = `${fileList.length}:${fileList[0]?.path ?? ""}:${fileList[fileList.length - 1]?.path ?? ""}`;
-        if (this.index && this.indexKey === indexKey)
+        if (this.index && this.indexKey === indexKey) {
+            this.indexBuiltAt = Date.now();
             return this.index;
+        }
         const index = new Map();
         for (const file of fileList) {
             if (file.content)
@@ -86,6 +112,7 @@ export class FileListIndex {
         }
         this.index = index;
         this.indexKey = indexKey;
+        this.indexBuiltAt = Date.now();
         const sampleFile = fileList.find((f) => /welcome/i.test(f.path));
         const sampleContent = sampleFile?.content;
         logger.debug("Built file list index", {

package/esm/src/platform/adapters/fs/veryfront/websocket-manager.d.ts

@@ -28,6 +28,7 @@ export declare class WebSocketManager {
     private selectiveInvalidationTimer;
     private pendingChangedPaths;
     private wsConnectionId;
+    private wsConsecutiveFailures;
     private pokeMetrics;
     constructor(deps: WebSocketDeps);
     getPokeMetrics(): {
@@ -37,6 +38,7 @@ export declare class WebSocketManager {
         connectionId: string | null;
     };
     connect(projectId: string): void;
+    private getReconnectDelay;
     dispose(): void;
     private handlePokeMessage;
     private clearPersistentCacheForPublish;

package/esm/src/platform/adapters/fs/veryfront/websocket-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/websocket-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAoB/F,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qBAAqB,EAAE,qBAAqB,CAAC;IAE7C,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACvD,gBAAgB,EAAE,MAAM,aAAa,CAAC;IACtC,aAAa,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACxC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,gBAAgB,EAAE,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KAC7C,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAgBf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfjC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,gBAAgB,CAAuD;IAC/E,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,iBAAiB,CAAsD;IAC/E,OAAO,CAAC,0BAA0B,CAAsD;IACxF,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAIjB;gBAE2B,IAAI,EAAE,aAAa;IAEhD,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAID,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAsDhC,OAAO,IAAI,IAAI;IAwBf,OAAO,CAAC,iBAAiB;IAkJzB,OAAO,CAAC,8BAA8B;IA0GtC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,6BAA6B;YAiBvB,4BAA4B;YA2H5B,mBAAmB;IAmIjC,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CAyBpB"}
+{"version":3,"file":"websocket-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/websocket-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAsB/F,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qBAAqB,EAAE,qBAAqB,CAAC;IAE7C,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACvD,gBAAgB,EAAE,MAAM,aAAa,CAAC;IACtC,aAAa,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACxC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,gBAAgB,EAAE,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KAC7C,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAiBf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAhBjC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,gBAAgB,CAAuD;IAC/E,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,iBAAiB,CAAsD;IAC/E,OAAO,CAAC,0BAA0B,CAAsD;IACxF,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,WAAW,CAIjB;gBAE2B,IAAI,EAAE,aAAa;IAEhD,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAID,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA0EhC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,IAAI,IAAI;IAwBf,OAAO,CAAC,iBAAiB;IAkJzB,OAAO,CAAC,8BAA8B;IA0GtC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,6BAA6B;YAiBvB,4BAA4B;YA2H5B,mBAAmB;IAmIjC,OAAO,CAAC,cAAc;IA4BtB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CAyBpB"}

package/esm/src/platform/adapters/fs/veryfront/websocket-manager.js

@@ -5,6 +5,8 @@ import { addPendingInvalidation, getPendingInvalidationsCount, removePendingInva
 const logger = baseLogger.component("web-socket-manager");
 const INVALIDATION_DEBOUNCE_MS = 100;
 const WS_RECONNECT_DELAY_MS = 5000;
+const WS_RECONNECT_MAX_DELAY_MS = 120000;
+const WS_RECONNECT_MAX_FAILURES = 10;
 const WS_HEARTBEAT_INTERVAL_MS = 60000;
 const WS_HEARTBEAT_TIMEOUT_MS = 300000;
 export class WebSocketManager {
@@ -17,6 +19,7 @@ export class WebSocketManager {
     selectiveInvalidationTimer = null;
     pendingChangedPaths = new Set();
     wsConnectionId = null;
+    wsConsecutiveFailures = 0;
     pokeMetrics = {
         received: 0,
         invalidationsTriggered: 0,
@@ -30,6 +33,15 @@ export class WebSocketManager {
     }
     connect(projectId) {
         this.cleanupTimers();
+        if (this.wsConsecutiveFailures >= WS_RECONNECT_MAX_FAILURES) {
+            logger.warn("WebSocket reconnect failure cap reached, resetting failure counter", {
+                consecutiveFailures: this.wsConsecutiveFailures,
+                maxFailures: WS_RECONNECT_MAX_FAILURES,
+                cappedDelayMs: WS_RECONNECT_MAX_DELAY_MS,
+                projectId,
+            });
+            this.wsConsecutiveFailures = 0;
+        }
         const wsUrl = this.deps.apiBaseUrl
             .replace(/^http:/, "ws:")
             .replace(/^https:/, "wss:")
@@ -37,11 +49,13 @@ export class WebSocketManager {
         const url = `${wsUrl}/ws/${projectId}/events?token=${this.deps.apiToken}`;
         logger.debug("Connecting to WebSocket", {
             url: url.replace(this.deps.apiToken, "***"),
+            consecutiveFailures: this.wsConsecutiveFailures,
         });
         try {
             this.ws = new WebSocket(url);
             this.wsConnectionId = dntShim.crypto.randomUUID().slice(0, 8);
             this.ws.onopen = () => {
+                this.wsConsecutiveFailures = 0;
                 logger.debug("WebSocket connected to events channel", {
                     projectId,
                     connectionId: this.wsConnectionId,
@@ -57,24 +71,37 @@ export class WebSocketManager {
                 this.handlePokeMessage(event);
             };
             this.ws.onclose = () => {
+                this.wsConsecutiveFailures++;
+                const delay = this.getReconnectDelay();
                 logger.debug("WebSocket closed, reconnecting", {
-                    delayMs: WS_RECONNECT_DELAY_MS,
+                    delayMs: delay,
                     connectionId: this.wsConnectionId,
                     totalPokesReceived: this.pokeMetrics.received,
+                    consecutiveFailures: this.wsConsecutiveFailures,
                 });
                 this.wsConnectionId = null;
                 this.cleanupTimers();
-                this.wsReconnectTimer = dntShim.setTimeout(() => this.connect(projectId), WS_RECONNECT_DELAY_MS);
+                this.wsReconnectTimer = dntShim.setTimeout(() => this.connect(projectId), delay);
             };
             this.ws.onerror = (error) => {
                 logger.warn("WebSocket error", { error });
             };
         }
         catch (error) {
-            logger.warn("Failed to connect WebSocket", { error });
-            this.wsReconnectTimer = dntShim.setTimeout(() => this.connect(projectId), WS_RECONNECT_DELAY_MS);
+            this.wsConsecutiveFailures++;
+            const delay = this.getReconnectDelay();
+            logger.warn("Failed to connect WebSocket", {
+                error,
+                consecutiveFailures: this.wsConsecutiveFailures,
+            });
+            this.wsReconnectTimer = dntShim.setTimeout(() => this.connect(projectId), delay);
         }
     }
+    getReconnectDelay() {
+        // Exponential backoff: 5s, 10s, 20s, 40s, 80s, capped at 120s
+        const delay = WS_RECONNECT_DELAY_MS * Math.pow(2, this.wsConsecutiveFailures - 1);
+        return Math.min(delay, WS_RECONNECT_MAX_DELAY_MS);
+    }
     dispose() {
         this.cleanupTimers();
         if (this.invalidationTimer) {
@@ -529,13 +556,19 @@ export class WebSocketManager {
             logger.warn("WebSocket heartbeat timeout, reconnecting", {
                 timeSinceLastPong,
             });
-            try {
-                this.ws?.close();
-            }
-            catch (error) {
-                logger.error("WebSocket close failed during heartbeat timeout", {
-                    error: error instanceof Error ? error.message : String(error),
-                });
+            // Detach onclose before closing to prevent double-reconnect:
+            // ws.close() triggers onclose asynchronously, which would increment
+            // the failure counter and schedule a separate reconnect timer.
+            if (this.ws) {
+                this.ws.onclose = null;
+                try {
+                    this.ws.close();
+                }
+                catch (error) {
+                    logger.error("WebSocket close failed during heartbeat timeout", {
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
             }
             this.cleanupTimers();
             this.connect(projectId);

package/esm/src/routing/api/route-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-executor.d.ts","sourceRoot":"","sources":["../../../../src/src/routing/api/route-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EACV,QAAQ,EAKT,MAAM,0BAA0B,CAAC;AA4ElC,wBAAgB,eAAe,CAC7B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CA6B3B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAwB3B"}
+{"version":3,"file":"route-executor.d.ts","sourceRoot":"","sources":["../../../../src/src/routing/api/route-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EACV,QAAQ,EAKT,MAAM,0BAA0B,CAAC;AA0GlC,wBAAgB,eAAe,CAC7B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CA4B3B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAsB3B"}

package/esm/src/routing/api/route-executor.js

@@ -44,9 +44,34 @@ function createProjectScopedFs(fs, projectDir) {
         resolveFile: fs.resolveFile ? (path) => fs.resolveFile(resolvePath(path)) : undefined,
     };
 }
+/**
+ * Check if an object is a cross-context Response (e.g. Deno native Response
+ * when this code runs in the npm package context with a different constructor).
+ */
+function isCrossContextResponse(value) {
+    if (value == null || typeof value !== "object")
+        return false;
+    const r = value;
+    return (typeof r.status === "number" &&
+        typeof r.headers === "object" &&
+        r.headers !== null &&
+        typeof r.headers.get === "function" &&
+        typeof r.text === "function" &&
+        typeof r.arrayBuffer === "function");
+}
 function validateResponse(response) {
     if (response instanceof dntShim.Response)
-        return;
+        return response;
+    // Normalize cross-context Response objects into a real Response so downstream
+    // code (toHeadResponse, applyCORSHeaders, withHeaders) always receives a
+    // genuine instance with correct body, headers, and status.
+    if (isCrossContextResponse(response)) {
+        return new dntShim.Response(response.body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers,
+        });
+    }
     throw toError(createError({
         type: "api",
         message: "API handler must return a Response",
@@ -69,8 +94,7 @@ export function executeAppRoute(handler, request, match, pathname, adapter) {
             return createAppRouteMethodNotAllowed(handlerModule);
         try {
             const appContext = { params: normalizeParams(match.params) };
-            const response = await resolvedFn(request, appContext);
-            validateResponse(response);
+            const response = validateResponse(await resolvedFn(request, appContext));
             return method === "HEAD" ? toHeadResponse(response) : response;
         }
         catch (error) {
@@ -88,9 +112,7 @@ export function executePagesRoute(handler, request, match, pathname, adapter, pr
         try {
             const fs = projectDir ? createProjectScopedFs(adapter.fs, projectDir) : adapter.fs;
             const ctx = createContext(request, match, fs);
-            const response = await methodHandler(ctx);
-            validateResponse(response);
-            return response;
+            return validateResponse(await methodHandler(ctx));
         }
         catch (error) {
             return handleAPIError(error, pathname, adapter);

package/esm/src/server/context/request-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../../../src/src/server/context/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,cAAc,CAuBzE;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,cAAc,CAAC,EAAE,OAAO,GACvB,MAAM,GAAG,YAAY,GAAG,WAAW,CAIrC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAExF;AAED,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAG/F"}
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../../../src/src/server/context/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,cAAc,CAwBzE;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,cAAc,CAAC,EAAE,OAAO,GACvB,MAAM,GAAG,YAAY,GAAG,WAAW,CAIrC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAExF;AAED,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAG/F"}

package/esm/src/server/context/request-context.js

@@ -9,7 +9,8 @@ export function createRequestContext(req) {
     const effectiveHost = forwardedHost ?? hostHeader ?? hostname;
     const parsed = parseProjectDomain(effectiveHost);
     const xEnvironment = req.headers.get("x-environment");
-    const mode = effectiveHost.includes(".preview.") ||
+    const mode = parsed.environment === "preview" ||
+        effectiveHost.includes(".preview.") ||
         xEnvironment === "preview"
         ? "preview"
         : "production";

package/esm/src/server/dev-server/server.d.ts

@@ -17,6 +17,7 @@ export declare class DevServer {
     private _isReady;
     private reloadUnsubscribe?;
     private invalidateUnsubscribe?;
+    private releaseExternalBroadcastSource?;
     constructor(options: DevServerOptions);
     private isDebug;
     private logRSCStatus;

package/esm/src/server/dev-server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAYlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAkCvD,qBAAa,SAAS;IAgBR,OAAO,CAAC,OAAO;IAf3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAsD;IACvE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,qBAAqB,CAAC,CAAa;gBAEvB,OAAO,EAAE,gBAAgB;IAQ7C,OAAO,CAAC,OAAO;YAID,YAAY;IAWpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8J5B,sEAAsE;IACtE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAGjE;IAED,OAAO,CAAC,oBAAoB;YAcd,cAAc;YAiBd,yBAAyB;YAoBzB,uBAAuB;YA4BvB,wBAAwB;IAkBtC,OAAO,CAAC,kBAAkB;IAuBpB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAarB,iBAAiB;IAoC/B,qBAAqB,IAAI,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI;IAIlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA4B5B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAclD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAkCvD,qBAAa,SAAS;IAiBR,OAAO,CAAC,OAAO;IAhB3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAsD;IACvE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,8BAA8B,CAAC,CAAa;gBAEhC,OAAO,EAAE,gBAAgB;IAQ7C,OAAO,CAAC,OAAO;YAID,YAAY;IAWpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqL5B,sEAAsE;IACtE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAGjE;IAED,OAAO,CAAC,oBAAoB;YAcd,cAAc;YAiBd,yBAAyB;YAoBzB,uBAAuB;YA4BvB,wBAAwB;IAkBtC,OAAO,CAAC,kBAAkB;IAuBpB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAarB,iBAAiB;IAoC/B,qBAAqB,IAAI,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI;IAIlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B5B"}

package/esm/src/server/dev-server/server.js

@@ -7,6 +7,8 @@ import { ComponentRegistry } from "../../modules/component-registry/index.js";
 import { MiddlewarePipeline } from "../../middleware/core/pipeline/index.js";
 import { bootstrapDev } from "../bootstrap.js";
 import { ReloadNotifier } from "../reload-notifier.js";
+import { broadcastUpdate } from "../handlers/preview/hmr-message-router.js";
+import { HMRHandler } from "../handlers/preview/hmr.handler.js";
 import { RequestHandler } from "./request-handler.js";
 import { setupMiddleware } from "./middleware.js";
 import { RouteDiscovery } from "./route-discovery.js";
@@ -50,6 +52,7 @@ export class DevServer {
     _isReady = false;
     reloadUnsubscribe;
     invalidateUnsubscribe;
+    releaseExternalBroadcastSource;
     constructor(options) {
         this.options = options;
         this.ready = new Promise((resolve) => {
@@ -98,6 +101,9 @@ export class DevServer {
             hmr: this.options.enableHMR,
             fastRefresh: this.options.enableFastRefresh,
         });
+        if (this.options.hmrPort !== undefined) {
+            devServerLog.warn("`hmrPort` is deprecated and ignored. HMR now uses /_ws on the main dev server port.", { hmrPort: this.options.hmrPort, serverPort: this.options.port });
+        }
         // Set VERYFRONT_DEV_PORT for ESM module loader HTTP fallback
         // This ensures the correct port is used when fetching modules via localhost
         setEnv("VERYFRONT_DEV_PORT", String(this.options.port));
@@ -125,7 +131,22 @@ export class DevServer {
                 devServerLog.debug("INVALIDATE callback triggered - clearing runtime handler");
                 this.requestHandler?.invalidateRuntimeHandler();
             });
-            devServerLog.debug("ReloadNotifier invalidation subscription registered");
+            // Subscribe to debounced reload for broadcasting updates to connected HMR clients.
+            // This subscription must be eagerly registered here rather than lazily inside
+            // HMRHandler.initialize(), because HMRHandler.initialize() only runs when the
+            // first /_ws WebSocket request arrives. If that connection fails or hasn't
+            // happened yet, file changes are silently lost.
+            this.releaseExternalBroadcastSource = HMRHandler.registerExternalBroadcastSource();
+            this.reloadUnsubscribe = ReloadNotifier.subscribe((changedPaths, project) => {
+                hmrLog.debug("RELOAD callback triggered - broadcasting to HMR clients", {
+                    changedPaths,
+                    projectSlug: project?.projectSlug,
+                });
+                // Broadcast without projectSlug filter so that connectHMR() clients
+                // (which are registered without a projectSlug) also receive updates.
+                broadcastUpdate(changedPaths);
+            });
+            hmrLog.debug("ReloadNotifier subscriptions registered (invalidate + reload broadcast)");
         }
         const moduleServerUrl = buildLocalhostUrl(this.options.port);
         const vendorBundleHash = "dev-vendor-bundle";
@@ -334,6 +355,7 @@ export class DevServer {
         logger.info("Shutting down dev server...");
         this.reloadUnsubscribe?.();
         this.invalidateUnsubscribe?.();
+        this.releaseExternalBroadcastSource?.();
         if (this.fileWatchSetup) {
             const metrics = this.fileWatchSetup.getMetrics();
             if (metrics) {

package/esm/src/server/dev-server/types.d.ts

@@ -6,6 +6,7 @@ export interface DevServerOptions {
     handlerOnly?: boolean;
     /** 0.0.0.0 = all interfaces, 127.0.0.1 = localhost only */
     bindAddress?: string;
+    /** @deprecated Ignored: HMR now uses /_ws on the main dev server port. */
     hmrPort?: number;
     moduleServerPort?: number;
     enableHMR?: boolean;

package/esm/src/server/dev-server/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/esm/src/server/handlers/preview/hmr.handler.d.ts

@@ -5,6 +5,7 @@ export type { HMRClientInfo } from "./hmr-client-manager.js";
 export declare class HMRHandler extends BaseHandler {
     private static rateLimiter;
     private static reloadUnsubscribe;
+    private static externalBroadcastSourceCount;
     private static initialized;
     metadata: HandlerMetadata;
     private static initialize;
@@ -23,6 +24,7 @@ export declare class HMRHandler extends BaseHandler {
         messagesForwarded: number;
         lastBroadcastTime: number;
     };
+    static registerExternalBroadcastSource(): () => void;
     static shutdown(): void;
     private static getMessageSize;
 }

package/esm/src/server/handlers/preview/hmr.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hmr.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/preview/hmr.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AASrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EAEpB,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAkBrB,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK7D,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAgD;IAC1E,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA6B;IAC7D,OAAO,CAAC,MAAM,CAAC,WAAW,CAAS;IAEnC,QAAQ,EAAE,eAAe,CAKvB;IAEF,OAAO,CAAC,MAAM,CAAC,UAAU;IA6BzB,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuJzE;;;;;OAKG;YACW,wBAAwB;IAuCtC,MAAM,CAAC,cAAc,IAAI,MAAM;IAI/B,MAAM,CAAC,UAAU,IAAI;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;KAC3B;IAID,MAAM,CAAC,QAAQ,IAAI,IAAI;IAavB,OAAO,CAAC,MAAM,CAAC,cAAc;CAO9B"}
+{"version":3,"file":"hmr.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/preview/hmr.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AASrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EAEpB,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAmBrB,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK7D,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAgD;IAC1E,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA6B;IAC7D,OAAO,CAAC,MAAM,CAAC,4BAA4B,CAAK;IAChD,OAAO,CAAC,MAAM,CAAC,WAAW,CAAS;IAEnC,QAAQ,EAAE,eAAe,CAKvB;IAEF,OAAO,CAAC,MAAM,CAAC,UAAU;IAsCzB,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA0JzE;;;;;OAKG;YACW,wBAAwB;IAuCtC,MAAM,CAAC,cAAc,IAAI,MAAM;IAI/B,MAAM,CAAC,UAAU,IAAI;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;KAC3B;IAID,MAAM,CAAC,+BAA+B,IAAI,MAAM,IAAI;IAWpD,MAAM,CAAC,QAAQ,IAAI,IAAI;IAcvB,OAAO,CAAC,MAAM,CAAC,cAAc;CAO9B"}

package/esm/src/server/handlers/preview/hmr.handler.js

@@ -6,6 +6,7 @@ import { HandlerPriority, } from "../types.js";
 import { ReloadNotifier } from "../../reload-notifier.js";
 import { invalidateProjectCaches } from "../../context/cache-invalidation.js";
 import { isExtendedFSAdapter } from "../../../platform/adapters/fs/wrapper.js";
+import { isLocalDevHost } from "../../utils/domain-parser.js";
 import { addClient, clearAll, getClient, getClientCount, getClientDetails, removeClient, } from "./hmr-client-manager.js";
 import { getPingIntervalMs, startPingInterval, stopPingInterval } from "./hmr-ping-keepalive.js";
 import { broadcastUpdate, getMetrics } from "./hmr-message-router.js";
@@ -15,6 +16,7 @@ const PRIORITY_HMR = HandlerPriority.EARLY;
 export class HMRHandler extends BaseHandler {
     static rateLimiter = new RateLimiter(HMR_MAX_MESSAGES_PER_MINUTE);
     static reloadUnsubscribe = null;
+    static externalBroadcastSourceCount = 0;
     static initialized = false;
     metadata = {
         name: "HMRHandler",
@@ -39,6 +41,13 @@ export class HMRHandler extends BaseHandler {
                 environment: project?.environment,
                 branchId: project?.branch ?? undefined,
             });
+            if (HMRHandler.externalBroadcastSourceCount > 0) {
+                logger.debug("Skipping handler broadcast - external source active", {
+                    projectSlug: project?.projectSlug,
+                    externalBroadcastSourceCount: HMRHandler.externalBroadcastSourceCount,
+                });
+                return;
+            }
             broadcastUpdate(changedPaths, project?.projectSlug);
         });
         startPingInterval();
@@ -54,13 +63,16 @@ export class HMRHandler extends BaseHandler {
         const isPreviewMode = ctx.requestContext?.mode === "preview" || queryEnv === "preview";
         const isLocal = !!ctx.isLocalProject;
         const host = req.headers.get("host") ?? "";
-        const isLocalhost = host.startsWith("localhost") || host.startsWith("127.0.0.1");
+        const isLocalhost = isLocalDevHost(host);
         if (!isPreviewMode && !isLocal && !isLocalhost) {
-            logger.debug("Skipping - not preview or local dev", {
+            logger.warn("Skipping /_ws - not preview, local dev, or localhost", {
                 mode: ctx.requestContext?.mode,
                 queryEnv,
                 isLocalProject: ctx.isLocalProject,
                 host,
+                isPreviewMode,
+                isLocal,
+                isLocalhost,
             });
             return Promise.resolve(this.continue());
         }
@@ -218,12 +230,19 @@ export class HMRHandler extends BaseHandler {
     static getMetrics() {
         return getMetrics();
     }
+    static registerExternalBroadcastSource() {
+        HMRHandler.externalBroadcastSourceCount++;
+        return () => {
+            HMRHandler.externalBroadcastSourceCount = Math.max(0, HMRHandler.externalBroadcastSourceCount - 1);
+        };
+    }
     static shutdown() {
         HMRHandler.reloadUnsubscribe?.();
         HMRHandler.reloadUnsubscribe = null;
         stopPingInterval();
         clearAll();
         HMRHandler.rateLimiter = new RateLimiter(HMR_MAX_MESSAGES_PER_MINUTE);
+        HMRHandler.externalBroadcastSourceCount = 0;
         HMRHandler.initialized = false;
         logger.debug("Shutdown complete");
     }

package/esm/src/server/index.d.ts

@@ -14,7 +14,8 @@ import { DevServer, type DevServerOptions, type FileWatcherMetrics, type RouteDi
 import { type DiscoveryOptions, type ServerHandle, startProductionServer, type StartProductionServerOptions } from "./production-server.js";
 export { DevServer, startDevServer, startProductionServer };
 export type { DevServerOptions, DiscoveryOptions, FileWatcherMetrics, RouteDirectory, ServerHandle, StartProductionServerOptions, };
-export { ReloadNotifier } from "./reload-notifier.js";
+import { ReloadNotifier } from "./reload-notifier.js";
+export { ReloadNotifier };
 export type { BuildOptions, BuildStats } from "./build-types.js";
 /** Shared options for both development and production server modes. */
 interface BaseServerOptions {
@@ -36,6 +37,7 @@ interface BaseServerOptions {
 }
 export interface StartDevModeOptions extends BaseServerOptions {
     mode?: "development";
+    /** @deprecated Ignored: HMR now uses /_ws on the main server port. */
     hmrPort?: number;
     moduleServerPort?: number;
     enableHMR?: boolean;