@timber-js/app 0.2.0-alpha.137 → 0.2.0-alpha.139

package/dist/_chunks/stale-reload-DIIIVGh_.js

@@ -1,84 +0,0 @@
-import { t as __exportAll } from "../index.js";
-//#region src/client/stale-reload.ts
-var stale_reload_exports = /* @__PURE__ */ __exportAll({
-	isStaleClientReference: () => isStaleClientReference,
-	triggerStaleReload: () => triggerStaleReload
-});
-/**
-* Stale Client Reference Reload
-*
-* When a new deployment ships updated bundles, clients running stale
-* JavaScript may encounter "Could not find the module" errors during
-* RSC Flight stream decoding. This happens because the RSC payload
-* references module IDs from the new bundle that don't exist in the
-* old client bundle.
-*
-* This module detects these specific errors and triggers a full page
-* reload so the browser fetches the new bundle. A sessionStorage flag
-* guards against infinite reload loops.
-*
-* See: LOCAL-332
-*/
-var RELOAD_FLAG_KEY = "__timber_stale_reload";
-/**
-* In-memory fallback counter for environments where sessionStorage is
-* unavailable (private browsing, storage full, extension interference).
-* Incremented each time triggerStaleReload() falls into the catch path.
-* If the counter exceeds 0 on a subsequent call, the reload is suppressed
-* to prevent an infinite loop. Resets naturally on page load (module
-* re-evaluates) and can be manually reset via clearStaleReloadFlag().
-*/
-var memoryReloadCount = 0;
-/**
-* Check if an error is a stale client reference error from React's
-* Flight client. These errors have the message pattern:
-*   "Could not find the module \"<id>\""
-*
-* This is thrown by react-server-dom-webpack's client when the RSC
-* payload references a module ID that doesn't exist in the client's
-* module map — typically because the server has been redeployed with
-* new bundle hashes while the client is still running old JavaScript.
-*/
-function isStaleClientReference(error) {
-	if (!(error instanceof Error)) return false;
-	const msg = error.message;
-	return msg.includes("Could not find the module") || msg.includes("client reference not found");
-}
-/**
-* Trigger a full page reload to pick up new bundles.
-*
-* Sets a sessionStorage flag before reloading. If the flag is already
-* set (meaning we already reloaded once for this reason), we don't
-* reload again — this prevents infinite reload loops if the error
-* persists after reload (e.g., a genuine bug rather than a stale bundle).
-*
-* @returns true if a reload was triggered, false if suppressed (loop guard)
-*/
-function triggerStaleReload() {
-	try {
-		if (sessionStorage.getItem(RELOAD_FLAG_KEY)) {
-			console.warn("[timber] Stale client reference detected again after reload. Not reloading to prevent infinite loop. This may indicate a deployment issue — try a hard refresh.");
-			return false;
-		}
-		sessionStorage.setItem(RELOAD_FLAG_KEY, "1");
-		console.warn("[timber] Stale client reference detected — the server has been redeployed with new bundles. Reloading to pick up the new version.");
-		window.location.reload();
-		return true;
-	} catch {
-		if (document.cookie.includes(RELOAD_FLAG_KEY + "=1") || memoryReloadCount > 0) {
-			console.warn("[timber] Stale client reference detected again after reload. Not reloading to prevent infinite loop. This may indicate a deployment issue — try a hard refresh.");
-			return false;
-		}
-		memoryReloadCount++;
-		try {
-			document.cookie = `${RELOAD_FLAG_KEY}=1; max-age=60; path=/; SameSite=Lax`;
-		} catch {}
-		console.warn("[timber] Stale client reference detected — the server has been redeployed with new bundles. Reloading to pick up the new version.");
-		window.location.reload();
-		return true;
-	}
-}
-//#endregion
-export { stale_reload_exports as n, triggerStaleReload as r, isStaleClientReference as t };
-
-//# sourceMappingURL=stale-reload-DIIIVGh_.js.map

package/dist/_chunks/stale-reload-DIIIVGh_.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stale-reload-DIIIVGh_.js","names":[],"sources":["../../src/client/stale-reload.ts"],"sourcesContent":["/**\n * Stale Client Reference Reload\n *\n * When a new deployment ships updated bundles, clients running stale\n * JavaScript may encounter \"Could not find the module\" errors during\n * RSC Flight stream decoding. This happens because the RSC payload\n * references module IDs from the new bundle that don't exist in the\n * old client bundle.\n *\n * This module detects these specific errors and triggers a full page\n * reload so the browser fetches the new bundle. A sessionStorage flag\n * guards against infinite reload loops.\n *\n * See: LOCAL-332\n */\n\nconst RELOAD_FLAG_KEY = '__timber_stale_reload';\n\n/**\n * In-memory fallback counter for environments where sessionStorage is\n * unavailable (private browsing, storage full, extension interference).\n * Incremented each time triggerStaleReload() falls into the catch path.\n * If the counter exceeds 0 on a subsequent call, the reload is suppressed\n * to prevent an infinite loop. Resets naturally on page load (module\n * re-evaluates) and can be manually reset via clearStaleReloadFlag().\n */\nlet memoryReloadCount = 0;\n\n/**\n * Check if an error is a stale client reference error from React's\n * Flight client. These errors have the message pattern:\n *   \"Could not find the module \\\"<id>\\\"\"\n *\n * This is thrown by react-server-dom-webpack's client when the RSC\n * payload references a module ID that doesn't exist in the client's\n * module map — typically because the server has been redeployed with\n * new bundle hashes while the client is still running old JavaScript.\n */\nexport function isStaleClientReference(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  const msg = error.message;\n  return msg.includes('Could not find the module') || msg.includes('client reference not found');\n}\n\n/**\n * Check if an error is a chunk load failure from a dynamic import.\n *\n * After a deployment, old chunk filenames no longer exist. When the client\n * tries to dynamically import a chunk that's been replaced, the browser\n * throws one of these errors:\n *\n * - Chromium: \"Failed to fetch dynamically imported module: <url>\"\n * - Firefox: \"error loading dynamically imported module: <url>\"\n * - Safari: \"Importing a module script failed.\"\n * - Vite/Rollup: \"Unable to preload CSS for <url>\"\n *\n * See TIM-446\n */\nexport function isChunkLoadError(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n  const msg = error.message.toLowerCase();\n  return (\n    msg.includes('failed to fetch dynamically imported module') ||\n    msg.includes('error loading dynamically imported module') ||\n    msg.includes('importing a module script failed') ||\n    msg.includes('unable to preload css') ||\n    // Webpack-style chunk load errors (unlikely in Vite but defensive)\n    msg.includes('loading chunk') ||\n    msg.includes('loading css chunk')\n  );\n}\n\n/**\n * Trigger a full page reload to pick up new bundles.\n *\n * Sets a sessionStorage flag before reloading. If the flag is already\n * set (meaning we already reloaded once for this reason), we don't\n * reload again — this prevents infinite reload loops if the error\n * persists after reload (e.g., a genuine bug rather than a stale bundle).\n *\n * @returns true if a reload was triggered, false if suppressed (loop guard)\n */\nexport function triggerStaleReload(): boolean {\n  try {\n    // Check if we already reloaded — prevent infinite loop\n    if (sessionStorage.getItem(RELOAD_FLAG_KEY)) {\n      console.warn(\n        '[timber] Stale client reference detected again after reload. ' +\n          'Not reloading to prevent infinite loop. ' +\n          'This may indicate a deployment issue — try a hard refresh.'\n      );\n      return false;\n    }\n\n    // Set the flag before reloading\n    sessionStorage.setItem(RELOAD_FLAG_KEY, '1');\n\n    console.warn(\n      '[timber] Stale client reference detected — the server has been ' +\n        'redeployed with new bundles. Reloading to pick up the new version.'\n    );\n\n    window.location.reload();\n    return true;\n  } catch {\n    // sessionStorage unavailable (private browsing, storage full, etc.)\n    // Use document.cookie as a reload-persistent fallback loop guard.\n    // Module-level memoryReloadCount resets on every reload, so it can't\n    // detect cross-reload loops. Cookies persist across reloads and are\n    // available even when sessionStorage is blocked (TIM-576).\n    const cookieFlag = document.cookie.includes(RELOAD_FLAG_KEY + '=1');\n    if (cookieFlag || memoryReloadCount > 0) {\n      console.warn(\n        '[timber] Stale client reference detected again after reload. ' +\n          'Not reloading to prevent infinite loop. ' +\n          'This may indicate a deployment issue — try a hard refresh.'\n      );\n      return false;\n    }\n\n    memoryReloadCount++;\n    // Set a short-lived cookie (60s) as the persistent loop guard.\n    // It auto-expires so it won't block future legitimate reloads.\n    try {\n      document.cookie = `${RELOAD_FLAG_KEY}=1; max-age=60; path=/; SameSite=Lax`;\n    } catch {\n      // Cookie API unavailable — proceed anyway, memoryReloadCount guards same-page loops\n    }\n    console.warn(\n      '[timber] Stale client reference detected — the server has been ' +\n        'redeployed with new bundles. Reloading to pick up the new version.'\n    );\n    window.location.reload();\n    return true;\n  }\n}\n\n/**\n * Clear the stale reload flag. Called on successful bootstrap to reset\n * the loop guard — if the page loaded successfully, the next stale\n * reference error should trigger a fresh reload attempt.\n */\nexport function clearStaleReloadFlag(): void {\n  memoryReloadCount = 0;\n  try {\n    sessionStorage.removeItem(RELOAD_FLAG_KEY);\n  } catch {\n    // sessionStorage unavailable — nothing to clear\n  }\n  // Also clear the cookie fallback\n  try {\n    document.cookie = `${RELOAD_FLAG_KEY}=; max-age=0; path=/; SameSite=Lax`;\n  } catch {\n    // Cookie API unavailable\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAgBA,IAAM,kBAAkB;;;;;;;;;AAUxB,IAAI,oBAAoB;;;;;;;;;;;AAYxB,SAAgB,uBAAuB,OAAyB;CAC9D,IAAI,EAAE,iBAAiB,QAAQ,OAAO;CACtC,MAAM,MAAM,MAAM;CAClB,OAAO,IAAI,SAAS,4BAA4B,IAAI,IAAI,SAAS,6BAA6B;;;;;;;;;;;;AAyChG,SAAgB,qBAA8B;CAC5C,IAAI;EAEF,IAAI,eAAe,QAAQ,gBAAgB,EAAE;GAC3C,QAAQ,KACN,kKAGD;GACD,OAAO;;EAIT,eAAe,QAAQ,iBAAiB,IAAI;EAE5C,QAAQ,KACN,oIAED;EAED,OAAO,SAAS,QAAQ;EACxB,OAAO;SACD;EAON,IADmB,SAAS,OAAO,SAAS,kBAAkB,KAC1D,IAAc,oBAAoB,GAAG;GACvC,QAAQ,KACN,kKAGD;GACD,OAAO;;EAGT;EAGA,IAAI;GACF,SAAS,SAAS,GAAG,gBAAgB;UAC/B;EAGR,QAAQ,KACN,oIAED;EACD,OAAO,SAAS,QAAQ;EACxB,OAAO"}