veryfront 0.1.215 → 0.1.217

package/esm/src/platform/adapters/fs/veryfront/read-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAapE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAY9B,qBAAa,cAAc;IAWvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAfpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI9B;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;gBAGnD,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA,EACxC,kBAAkB,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,aAAA,EAC7C,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAC/C,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CACtD,aAAA;IAKH,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,mBAAmB;YAsBb,+BAA+B;YA0C/B,mBAAmB;IA0CjC,OAAO,CAAC,kBAAkB;YAoFZ,2BAA2B;YAmD3B,uCAAuC;IAiCrD,OAAO,CAAC,yBAAyB;IAmCjC,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,qBAAqB;YAYf,YAAY;YA6JZ,qBAAqB;YAwDrB,qBAAqB;YA8CrB,+BAA+B;YAwD/B,iBAAiB;CAuBhC"}
+{"version":3,"file":"read-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAcpE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAQ9B,qBAAa,cAAc;IAWvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAfpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI9B;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;gBAGnD,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA,EACxC,kBAAkB,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,aAAA,EAC7C,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAC/C,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CACtD,aAAA;IAKH,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,mBAAmB;YAsBb,+BAA+B;YA0C/B,mBAAmB;IA0CjC,OAAO,CAAC,kBAAkB;YAoFZ,2BAA2B;YAmD3B,uCAAuC;IAiCrD,OAAO,CAAC,yBAAyB;IAmCjC,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,qBAAqB;YAYf,YAAY;YA6JZ,qBAAqB;YAwDrB,qBAAqB;YA8CrB,+BAA+B;YAwD/B,iBAAiB;CAuBhC"}

package/esm/src/platform/adapters/fs/veryfront/read-operations.js

@@ -4,15 +4,12 @@ import { logContentMetric } from "./content-metrics.js";
 import { FileListIndex } from "./file-list-index.js";
 import { InFlightRequestDeduper } from "./in-flight-dedupe.js";
 import { getRequestScopedFile, setRequestScopedFile } from "./multi-project-adapter.js";
-import { assertProjectSourcePath, buildExtensionCandidatePaths, buildReadFetchState, createNotFoundLikeError, getResolvedCacheKey, isNotFoundLikeError, READ_OPERATION_EXTENSION_PRIORITY as EXTENSION_PRIORITY, splitKnownFileExtension, } from "./read-operations-helpers.js";
+import { assertProjectSourcePath, buildContentPreview, buildExtensionCandidatePaths, buildReadFetchState, createNotFoundLikeError, getResolvedCacheKey, isNotFoundLikeError, READ_OPERATION_EXTENSION_PRIORITY as EXTENSION_PRIORITY, splitKnownFileExtension, } from "./read-operations-helpers.js";
 export { endRequestMetrics, getContentMetricsSnapshot, resetContentMetrics, startRequestMetrics, } from "./content-metrics.js";
 const logger = baseLogger.component("read-operations");
 const IN_FLIGHT_REQUEST_TIMEOUT_MS = 15_000;
 const MAX_IN_FLIGHT_REQUESTS = 100;
 const IN_FLIGHT_CLEANUP_INTERVAL_MS = 1_000;
-function previewText(content, max = 80) {
-    return content.length > max ? `${content.slice(0, max)}...` : content;
-}
 export class ReadOperations {
     client;
     cache;
@@ -71,7 +68,7 @@ export class ReadOperations {
             path: normalizedPath,
             cacheKey,
             contentLength: requestCached.length,
-            preview: previewText(requestCached).replace(/\n/g, "\\n"),
+            preview: buildContentPreview(requestCached).replace(/\n/g, "\\n"),
         });
         return requestCached;
     }
@@ -101,7 +98,7 @@ export class ReadOperations {
             path: normalizedPath,
             cacheKey,
             contentLength: cached.length,
-            preview: previewText(cached).replace(/\n/g, "\\n"),
+            preview: buildContentPreview(cached).replace(/\n/g, "\\n"),
         });
         setRequestScopedFile(cacheKey, cached);
         return cached;
@@ -481,7 +478,7 @@ export class ReadOperations {
         logger.debug("API_FETCH_DONE - got content from API", {
             path: normalizedPath,
             contentLength: content.length,
-            preview: previewText(content).replace(/\n/g, "\\n"),
+            preview: buildContentPreview(content).replace(/\n/g, "\\n"),
             willCache: shouldCache,
         });
         return this.storeFetchedContent(cacheKey, content, shouldCache);

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

@@ -0,0 +1,28 @@
+import type { ContentSource, ResolvedContentContext } from "./types.js";
+export declare const INVALIDATION_DEBOUNCE_MS = 100;
+export declare const WS_RECONNECT_DELAY_MS = 5000;
+export declare const WS_RECONNECT_MAX_DELAY_MS = 120000;
+export declare const WS_RECONNECT_MAX_FAILURES = 10;
+export declare const WS_HEARTBEAT_INTERVAL_MS = 60000;
+export declare const WS_HEARTBEAT_TIMEOUT_MS = 300000;
+export interface PreviewStyleArtifactInfo {
+    hash: string;
+    assetPath: string;
+}
+export declare function getConnectionLogContext(projectSlug: string | undefined, context?: Record<string, unknown>): Record<string, unknown>;
+export declare function getPreviewInvalidationPrefixes(contentContext: ResolvedContentContext | null): string[];
+export declare function getReconnectDelay(consecutiveFailures: number): number;
+export declare function buildReloadProjectContext(contentContext: ResolvedContentContext | null, projectSlug: string, projectId: string, preparedStyleArtifact?: PreviewStyleArtifactInfo): {
+    projectSlug: string;
+    projectId: string;
+    environment: "preview" | "production";
+    branch: string | null;
+    releaseId: string | null;
+    styleArtifactHash: string | undefined;
+    styleAssetPath: string | undefined;
+};
+export declare function buildContentSourceLabel(getContentSource: () => ContentSource, getContentContext: () => ResolvedContentContext | null): {
+    contentSource: ContentSource;
+    branch: string | null;
+};
+//# sourceMappingURL=websocket-manager-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-manager-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/websocket-manager-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGxE,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAC9C,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAE9C,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,sBAAsB,GAAG,IAAI,GAC5C,MAAM,EAAE,CAGV;AAED,wBAAgB,iBAAiB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,sBAAsB,GAAG,IAAI,EAC7C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,qBAAqB,CAAC,EAAE,wBAAwB,GAC/C;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,SAAS,GAAG,YAAY,CAAC;IACtC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAcA;AAED,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,aAAa,EACrC,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,GACrD;IAAE,aAAa,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAKzD"}

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

@@ -0,0 +1,41 @@
+import { buildFileCacheKeyPrefix } from "./cache-keys.js";
+export const INVALIDATION_DEBOUNCE_MS = 100;
+export const WS_RECONNECT_DELAY_MS = 5000;
+export const WS_RECONNECT_MAX_DELAY_MS = 120000;
+export const WS_RECONNECT_MAX_FAILURES = 10;
+export const WS_HEARTBEAT_INTERVAL_MS = 60000;
+export const WS_HEARTBEAT_TIMEOUT_MS = 300000;
+export function getConnectionLogContext(projectSlug, context = {}) {
+    if (!projectSlug)
+        return context;
+    return { projectSlug, ...context };
+}
+export function getPreviewInvalidationPrefixes(contentContext) {
+    if (contentContext?.sourceType !== "branch")
+        return [];
+    return [buildFileCacheKeyPrefix(contentContext)];
+}
+export function getReconnectDelay(consecutiveFailures) {
+    const delay = WS_RECONNECT_DELAY_MS * Math.pow(2, consecutiveFailures - 1);
+    return Math.min(delay, WS_RECONNECT_MAX_DELAY_MS);
+}
+export function buildReloadProjectContext(contentContext, projectSlug, projectId, preparedStyleArtifact) {
+    const environment = contentContext?.sourceType === "branch"
+        ? "preview"
+        : "production";
+    return {
+        projectSlug,
+        projectId,
+        environment,
+        branch: contentContext?.branch ?? null,
+        releaseId: contentContext?.releaseId ?? null,
+        styleArtifactHash: preparedStyleArtifact?.hash,
+        styleAssetPath: preparedStyleArtifact?.assetPath,
+    };
+}
+export function buildContentSourceLabel(getContentSource, getContentContext) {
+    return {
+        contentSource: getContentSource(),
+        branch: getContentContext()?.branch ?? null,
+    };
+}

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

@@ -1,10 +1,7 @@
 import type { FileCache } from "../cache/file-cache.js";
 import type { VeryfrontApiClient } from "../../veryfront-api-client/index.js";
 import type { ContentSource, InvalidationCallbacks, ResolvedContentContext } from "./types.js";
-interface PreviewStyleArtifactInfo {
-    hash: string;
-    assetPath: string;
-}
+import { type PreviewStyleArtifactInfo } from "./websocket-manager-helpers.js";
 interface WebSocketDeps {
     apiBaseUrl: string;
     apiToken: string;

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;AAwB/F,UAAU,wBAAwB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,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;IACnB,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KAC7C,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAC;CACpD;AAED,qBAAa,gBAAgB;IAqBf,OAAO,CAAC,QAAQ,CAAC,IAAI;IApBjC,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,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,0BAA0B,CAAK;IACvC,OAAO,CAAC,iCAAiC,CAAqB;IAC9D,OAAO,CAAC,WAAW,CAIjB;gBAE2B,IAAI,EAAE,aAAa;IAEhD,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,2BAA2B;IAUnC,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;IA+GhC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,IAAI,IAAI;IA8Bf,OAAO,CAAC,iBAAiB;IAyJzB,OAAO,CAAC,8BAA8B;IA0GtC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,6BAA6B;YAiBvB,4BAA4B;YA8I5B,mBAAmB;IAiJjC,OAAO,CAAC,cAAc;IA+BtB,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;AAY/F,OAAO,EAOL,KAAK,wBAAwB,EAK9B,MAAM,gCAAgC,CAAC;AAMxC,UAAU,aAAa;IACrB,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;IACnB,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KAC7C,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAAC;CACpD;AAED,qBAAa,gBAAgB;IAqBf,OAAO,CAAC,QAAQ,CAAC,IAAI;IApBjC,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,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,0BAA0B,CAAK;IACvC,OAAO,CAAC,iCAAiC,CAAqB;IAC9D,OAAO,CAAC,WAAW,CAIjB;gBAE2B,IAAI,EAAE,aAAa;IAEhD,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,8BAA8B;IAMtC,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,2BAA2B;IAUnC,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;IA8GhC,OAAO,CAAC,iBAAiB;IAKzB,OAAO,IAAI,IAAI;IA8Bf,OAAO,CAAC,iBAAiB;IAyJzB,OAAO,CAAC,8BAA8B;IA0GtC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,6BAA6B;YAiBvB,4BAA4B;YAwI5B,mBAAmB;IA2IjC,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CAyBpB"}

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

@@ -2,13 +2,8 @@ import * as dntShim from "../../../../../_dnt.shims.js";
 import { getBaseLogger } from "../../../../utils/logger/logger.js";
 import { buildDirCacheKeyPrefix, buildFileCacheKeyPrefix, buildFileListCacheKey, buildStatCacheKeyPrefix, } from "./cache-keys.js";
 import { addPendingInvalidation, getPendingInvalidationsCount, removePendingInvalidation, } from "./invalidation-state.js";
+import { buildContentSourceLabel, buildReloadProjectContext, getConnectionLogContext as getConnectionLogContextHelper, getPreviewInvalidationPrefixes as getPreviewInvalidationPrefixesHelper, getReconnectDelay as getReconnectDelayHelper, INVALIDATION_DEBOUNCE_MS, WS_HEARTBEAT_INTERVAL_MS, WS_HEARTBEAT_TIMEOUT_MS, WS_RECONNECT_MAX_DELAY_MS, WS_RECONNECT_MAX_FAILURES, } from "./websocket-manager-helpers.js";
 const logger = getBaseLogger("SERVER", { injectTraceContext: false }).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 {
     deps;
     ws = null;
@@ -33,14 +28,10 @@ export class WebSocketManager {
         this.deps = deps;
     }
     getConnectionLogContext(context = {}) {
-        if (!this.deps.projectSlug)
-            return context;
-        return { projectSlug: this.deps.projectSlug, ...context };
+        return getConnectionLogContextHelper(this.deps.projectSlug, context);
     }
     getPreviewInvalidationPrefixes(contentContext) {
-        if (contentContext?.sourceType !== "branch")
-            return [];
-        return [buildFileCacheKeyPrefix(contentContext)];
+        return getPreviewInvalidationPrefixesHelper(contentContext);
     }
     beginPreviewInvalidation(contentContext) {
         const prefixes = this.getPreviewInvalidationPrefixes(contentContext);
@@ -105,8 +96,7 @@ export class WebSocketManager {
                 logger.debug("WebSocket connected to events channel", this.getConnectionLogContext({
                     projectId,
                     connectionId: this.wsConnectionId,
-                    contentSource: this.deps.getContentSource(),
-                    branch: this.deps.getContentContext()?.branch,
+                    ...buildContentSourceLabel(this.deps.getContentSource, this.deps.getContentContext),
                 }));
                 this.wsLastPong = Date.now();
                 this.startHeartbeat(projectId);
@@ -155,8 +145,7 @@ export class WebSocketManager {
     }
     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);
+        return getReconnectDelayHelper(this.wsConsecutiveFailures);
     }
     dispose() {
         this.disposed = true;
@@ -502,18 +491,7 @@ export class WebSocketManager {
                 projectId: this.deps.client.getProjectId(),
                 hasTriggerReloadCallback: !!this.deps.invalidationCallbacks.triggerReload,
             });
-            const environment = contentContext?.sourceType === "branch"
-                ? "preview"
-                : "production";
-            const projectContext = {
-                projectSlug: this.deps.projectSlug,
-                projectId: this.deps.client.getProjectId(),
-                environment,
-                branch: contentContext?.branch ?? null,
-                releaseId: contentContext?.releaseId ?? null,
-                styleArtifactHash: preparedStyleArtifact?.hash,
-                styleAssetPath: preparedStyleArtifact?.assetPath,
-            };
+            const projectContext = buildReloadProjectContext(contentContext, this.deps.projectSlug, this.deps.client.getProjectId(), preparedStyleArtifact);
             this.deps.invalidationCallbacks.triggerReload?.(changedPaths, projectContext);
             logger.info("Selective invalidation complete - HMR triggered", {
                 changedPaths,
@@ -610,18 +588,7 @@ export class WebSocketManager {
                 projectId: this.deps.client.getProjectId(),
                 hasTriggerReloadCallback: !!this.deps.invalidationCallbacks.triggerReload,
             });
-            const environment = contentContext?.sourceType === "branch"
-                ? "preview"
-                : "production";
-            const projectContext = {
-                projectSlug: this.deps.projectSlug,
-                projectId: this.deps.client.getProjectId(),
-                environment,
-                branch: contentContext?.branch ?? null,
-                releaseId: contentContext?.releaseId ?? null,
-                styleArtifactHash: preparedStyleArtifact?.hash,
-                styleAssetPath: preparedStyleArtifact?.assetPath,
-            };
+            const projectContext = buildReloadProjectContext(contentContext, this.deps.projectSlug, this.deps.client.getProjectId(), preparedStyleArtifact);
             this.deps.invalidationCallbacks.triggerReload?.(undefined, projectContext);
             logger.debug("CACHE INVALIDATION COMPLETE", {
                 fileCacheCleared: totalFileCount,

package/esm/src/platform/compat/process/command.d.ts

@@ -0,0 +1,31 @@
+export interface CommandResult {
+    success: boolean;
+    code: number;
+    stdout?: string;
+    stderr?: string;
+}
+export interface CommandOptions {
+    args?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    /** Capture stdout/stderr to return in result */
+    capture?: boolean;
+    /** Inherit stdio from parent process (shows output in terminal) */
+    inherit?: boolean;
+    /** Use shell to run the command (needed for .cmd files on Windows) */
+    shell?: boolean;
+    /** Kill the command if it exceeds this duration (milliseconds) */
+    timeoutMs?: number;
+}
+/**
+ * Run a command and return the result.
+ * Works across Deno, Node.js, and Bun.
+ *
+ * @param cmd - Command to run
+ * @param options - Command options
+ * @param options.capture - Capture stdout/stderr to return in result
+ * @param options.inherit - Inherit stdio from parent (shows output in terminal)
+ * @param options.shell - Use shell to run command (needed for .cmd on Windows)
+ */
+export declare function runCommand(cmd: string, options?: CommandOptions): Promise<CommandResult>;
+//# sourceMappingURL=command.d.ts.map

package/esm/src/platform/compat/process/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/process/command.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6ED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAsLxB"}

package/esm/src/platform/compat/process/command.js

@@ -0,0 +1,193 @@
+import * as dntShim from "../../../../_dnt.shims.js";
+import { dynamicImport } from "../dynamic-import.js";
+import { isBun as IS_BUN, isDeno as IS_DENO } from "../runtime.js";
+import { isWindowsPlatform, runtimeProcess } from "./runtime-process.js";
+const COMMAND_TIMEOUT_EXIT_CODE = 124;
+const FORCE_KILL_GRACE_MS = 250;
+function createTimeoutResult(timeoutMs, stdout, stderr) {
+    return {
+        success: false,
+        code: COMMAND_TIMEOUT_EXIT_CODE,
+        stdout,
+        stderr: `${stderr ?? ""}\nCommand timed out after ${timeoutMs}ms`.trim(),
+    };
+}
+function createProcessTimeout(timeoutMs, terminate, forceTerminate) {
+    let timedOut = false;
+    let timeoutId;
+    let forceKillId;
+    if (timeoutMs && timeoutMs > 0) {
+        timeoutId = dntShim.setTimeout(() => {
+            timedOut = true;
+            try {
+                terminate();
+            }
+            catch (_) {
+                /* expected: best-effort terminate may fail if process already exited */
+            }
+            forceKillId = dntShim.setTimeout(() => {
+                try {
+                    forceTerminate();
+                }
+                catch (_) {
+                    /* expected: best-effort force terminate may fail if process already exited */
+                }
+            }, FORCE_KILL_GRACE_MS);
+        }, timeoutMs);
+    }
+    return {
+        hasTimedOut: () => timedOut,
+        clear: () => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (forceKillId)
+                clearTimeout(forceKillId);
+        },
+    };
+}
+async function readStreamToString(stream) {
+    const reader = stream.getReader();
+    const chunks = [];
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        if (value)
+            chunks.push(value);
+    }
+    const total = chunks.reduce((acc, c) => acc + c.length, 0);
+    const merged = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        merged.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return new TextDecoder().decode(merged);
+}
+/**
+ * Run a command and return the result.
+ * Works across Deno, Node.js, and Bun.
+ *
+ * @param cmd - Command to run
+ * @param options - Command options
+ * @param options.capture - Capture stdout/stderr to return in result
+ * @param options.inherit - Inherit stdio from parent (shows output in terminal)
+ * @param options.shell - Use shell to run command (needed for .cmd on Windows)
+ */
+export async function runCommand(cmd, options = {}) {
+    const { args = [], cwd: cmdCwd, env: cmdEnv, capture = false, inherit = false, shell = false, timeoutMs, } = options;
+    const effectiveTimeoutMs = timeoutMs && timeoutMs > 0 ? Math.floor(timeoutMs) : undefined;
+    // Determine stdio mode: inherit > capture > null
+    const stdioMode = inherit ? "inherit" : capture ? "piped" : "null";
+    if (IS_DENO) {
+        const command = new dntShim.Deno.Command(cmd, {
+            args,
+            cwd: cmdCwd,
+            env: cmdEnv,
+            stdin: inherit ? "inherit" : "null",
+            stdout: stdioMode,
+            stderr: stdioMode,
+        });
+        const child = command.spawn();
+        const timeout = createProcessTimeout(effectiveTimeoutMs, () => child.kill("SIGTERM"), () => child.kill("SIGKILL"));
+        try {
+            const [status, stdout, stderr] = await Promise.all([
+                child.status,
+                capture && child.stdout ? readStreamToString(child.stdout) : Promise.resolve(undefined),
+                capture && child.stderr ? readStreamToString(child.stderr) : Promise.resolve(undefined),
+            ]);
+            if (timeout.hasTimedOut()) {
+                return createTimeoutResult(effectiveTimeoutMs ?? 0, stdout, stderr);
+            }
+            return {
+                success: status.success,
+                code: status.code,
+                stdout,
+                stderr,
+            };
+        }
+        finally {
+            timeout.clear();
+        }
+    }
+    if (IS_BUN) {
+        const bunGlobal = dntShim.dntGlobalThis;
+        const bunStdio = inherit ? "inherit" : capture ? "pipe" : "ignore";
+        const isWindows = isWindowsPlatform();
+        const bunCmd = shell
+            ? args.length === 0
+                ? isWindows ? ["cmd", "/c", cmd] : ["sh", "-c", cmd]
+                : isWindows
+                    ? ["cmd", "/c", cmd, ...args]
+                    : ["sh", "-c", 'exec "$@"', "sh", cmd, ...args]
+            : [cmd, ...args];
+        const proc = bunGlobal.Bun.spawn({
+            cmd: bunCmd,
+            cwd: cmdCwd,
+            env: cmdEnv,
+            stdout: bunStdio,
+            stderr: bunStdio,
+        });
+        const timeout = createProcessTimeout(effectiveTimeoutMs, () => proc.kill?.("SIGTERM"), () => proc.kill?.("SIGKILL"));
+        try {
+            const [code, stdout, stderr] = await Promise.all([
+                proc.exited,
+                capture && proc.stdout ? readStreamToString(proc.stdout) : Promise.resolve(undefined),
+                capture && proc.stderr ? readStreamToString(proc.stderr) : Promise.resolve(undefined),
+            ]);
+            if (timeout.hasTimedOut()) {
+                return createTimeoutResult(effectiveTimeoutMs ?? 0, stdout, stderr);
+            }
+            return { success: code === 0, code, stdout, stderr };
+        }
+        finally {
+            timeout.clear();
+        }
+    }
+    if (!runtimeProcess)
+        return { success: false, code: 1 };
+    const process = runtimeProcess;
+    const { spawn } = await dynamicImport("node:child_process");
+    const nodeStdio = inherit
+        ? ["inherit", "inherit", "inherit"]
+        : capture
+            ? ["ignore", "pipe", "pipe"]
+            : ["ignore", "ignore", "ignore"];
+    return await new Promise((resolve) => {
+        const child = spawn(cmd, args, {
+            cwd: cmdCwd,
+            env: cmdEnv ? { ...process.env, ...cmdEnv } : undefined,
+            stdio: nodeStdio,
+            shell,
+        });
+        let stdout = "";
+        let stderr = "";
+        const decoder = new TextDecoder();
+        const timeout = createProcessTimeout(effectiveTimeoutMs, () => child.kill("SIGTERM"), () => child.kill("SIGKILL"));
+        if (capture) {
+            child.stdout?.on("data", (data) => {
+                stdout += decoder.decode(data);
+            });
+            child.stderr?.on("data", (data) => {
+                stderr += decoder.decode(data);
+            });
+        }
+        child.on("close", (code) => {
+            timeout.clear();
+            if (timeout.hasTimedOut()) {
+                resolve(createTimeoutResult(effectiveTimeoutMs ?? 0, capture ? stdout : undefined, capture ? stderr : undefined));
+                return;
+            }
+            resolve({
+                success: code === 0,
+                code: code ?? 1,
+                stdout: capture ? stdout : undefined,
+                stderr: capture ? stderr : undefined,
+            });
+        });
+        child.on("error", () => {
+            timeout.clear();
+            resolve({ success: false, code: 1 });
+        });
+    });
+}

package/esm/src/platform/compat/process/env.d.ts

@@ -0,0 +1,31 @@
+export type EnvOverlayStorage = {
+    getStore: () => unknown;
+    run?: <T>(store: unknown, fn: () => T) => T;
+    enterWith?: (store: unknown) => void;
+};
+export declare function env(): Record<string, string>;
+/**
+ * Read a host-level environment variable without consulting any project env overlay.
+ * Use this for framework-owned runtime configuration that should not be shadowed by tenant env.
+ */
+export declare function getHostEnv(key: string): string | undefined;
+export declare function getEnv(key: string): string | undefined;
+export interface EnvBooleanOptions {
+    trueValues?: readonly string[];
+    falseValues?: readonly string[];
+    trim?: boolean;
+    caseSensitive?: boolean;
+}
+export declare function getEnvString(key: string): string | undefined;
+export declare function getEnvString(key: string, fallback: string): string;
+export declare function getEnvNumber(key: string): number | undefined;
+export declare function getEnvNumber(key: string, fallback: number): number;
+export declare function getEnvBoolean(key: string, fallback?: boolean, options?: EnvBooleanOptions): boolean;
+export declare function setEnv(key: string, value: string): void;
+export declare function deleteEnv(key: string): void;
+/**
+ * Get an AsyncLocalStorage-based env overlay storage if installed.
+ * This enables per-async-context env isolation (e.g., in tests).
+ */
+export declare function getEnvOverlayStorage(): EnvOverlayStorage | null;
+//# sourceMappingURL=env.d.ts.map

package/esm/src/platform/compat/process/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/process/env.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC,CAAC;AAoBF,wBAAgB,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmB5C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS1D;AAqCD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtD;AAKD,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAUD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAC9D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAOpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAC9D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAUpE,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,QAAQ,UAAQ,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAmBT;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAgBvD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAgB3C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAS/D"}