@st-h/vite-ember-ssr 0.2.0-alpha.1

package/dist/worker.js

@@ -0,0 +1,186 @@
+import { Window } from "happy-dom";
+//#region src/worker.ts
+/**
+* SSR worker — long-lived Window per thread.
+*
+* One Window is created at worker startup and lives for the worker's lifetime.
+* One EmberApplication is created eagerly (top-level await) and reused for
+* every render. Renders are serialised by tinypool (concurrentTasksPerWorker:1),
+* so there is no concurrency concern within a single worker.
+*
+* app.visit() fully owns document.head/body between calls, so DOM state does
+* not bleed across renders. A fresh ApplicationInstance is created per visit
+* and destroyed after the DOM is read, keeping container singletons clean.
+*
+* The shoebox fetch interceptor is installed once at startup. Each render
+* assigns a fresh entries Map before visiting, so entries never bleed between
+* requests. When shoebox is disabled, the Map is set to null and the
+* interceptor is a no-op passthrough.
+*/
+const BROWSER_GLOBALS = [
+	"window",
+	"document",
+	"navigator",
+	"location",
+	"history",
+	"HTMLElement",
+	"Element",
+	"Node",
+	"Event",
+	"CustomEvent",
+	"MutationObserver",
+	"requestAnimationFrame",
+	"cancelAnimationFrame",
+	"self",
+	"localStorage",
+	"sessionStorage",
+	"InputEvent",
+	"KeyboardEvent",
+	"MouseEvent",
+	"FocusEvent",
+	"PointerEvent",
+	"IntersectionObserver",
+	"ResizeObserver",
+	"CSSStyleSheet"
+];
+function installGlobals(win) {
+	for (const name of BROWSER_GLOBALS) try {
+		Object.defineProperty(globalThis, name, {
+			value: win[name],
+			writable: true,
+			configurable: true,
+			enumerable: true
+		});
+	} catch {}
+}
+const win = new Window({
+	url: "http://localhost/",
+	width: 1024,
+	height: 768,
+	settings: {
+		disableJavaScriptFileLoading: true,
+		disableJavaScriptEvaluation: true,
+		disableCSSFileLoading: true,
+		navigator: { userAgent: "vite-ember-ssr" }
+	}
+});
+installGlobals(win);
+const { ssrBundlePath: startupBundlePath } = process.__tinypool_state__.workerData;
+const startupMod = await import(startupBundlePath);
+if (typeof startupMod.createSsrApp !== "function") throw new Error(`SSR bundle '${startupBundlePath}' does not export a 'createSsrApp' function. Found exports: ${Object.keys(startupMod).join(", ")}`);
+const app = startupMod.createSsrApp();
+const SHOEBOX_SCRIPT_ID = "vite-ember-ssr-shoebox";
+const realFetch = globalThis.fetch;
+let shoeboxEntries = null;
+let requestHeaders = null;
+const interceptedFetch = async (input, init) => {
+	const request = new Request(input, init);
+	if (requestHeaders) {
+		const mergedInit = { ...init };
+		const existingHeaders = new Headers(mergedInit.headers);
+		for (const [key, value] of Object.entries(requestHeaders)) if (!existingHeaders.has(key)) existingHeaders.set(key, value);
+		mergedInit.headers = existingHeaders;
+		const mergedRequest = new Request(input, mergedInit);
+		if (mergedRequest.method.toUpperCase() !== "GET") return realFetch(mergedRequest);
+		const response = await realFetch(mergedRequest);
+		if (shoeboxEntries) captureShoeboxEntry(mergedRequest, response);
+		return response;
+	}
+	if (request.method.toUpperCase() !== "GET") return realFetch(input, init);
+	const response = await realFetch(input, init);
+	if (shoeboxEntries) captureShoeboxEntry(request, response);
+	return response;
+};
+async function captureShoeboxEntry(request, response) {
+	try {
+		const clone = response.clone();
+		const body = await clone.text();
+		const headers = {};
+		clone.headers.forEach((v, k) => {
+			headers[k] = v;
+		});
+		shoeboxEntries?.set(request.url, {
+			url: request.url,
+			status: clone.status,
+			statusText: clone.statusText,
+			headers,
+			body
+		});
+	} catch {}
+}
+globalThis.fetch = interceptedFetch;
+function serializeShoebox(entries) {
+	if (entries.length === 0) return "";
+	return `<script type="application/json" id="${SHOEBOX_SCRIPT_ID}">${JSON.stringify(entries).replace(/<\/(script)/gi, "<\\/$1")}<\/script>`;
+}
+function getActiveRouteName(instance) {
+	if (!instance.lookup) return void 0;
+	try {
+		return instance.lookup("service:router")?.currentRouteName ?? void 0;
+	} catch {
+		return;
+	}
+}
+function buildRouteCssLinks(manifest, instance) {
+	if (!manifest) return "";
+	const routeName = getActiveRouteName(instance);
+	if (!routeName) return "";
+	const segments = routeName.split(".");
+	const seen = /* @__PURE__ */ new Set();
+	const links = [];
+	for (let i = 1; i <= segments.length; i++) {
+		const cssFiles = manifest[segments.slice(0, i).join(".")];
+		if (!cssFiles) continue;
+		for (const href of cssFiles) {
+			if (seen.has(href)) continue;
+			seen.add(href);
+			links.push(`<link rel="stylesheet" href="${href}">`);
+		}
+	}
+	return links.join("");
+}
+async function render(options) {
+	const { url, shoebox, rehydrate, cssManifest, headers } = options;
+	const document = win.document;
+	shoeboxEntries = shoebox ? /* @__PURE__ */ new Map() : null;
+	requestHeaders = headers;
+	let head = "";
+	let body = "";
+	let bodyAttrs = {};
+	let cssLinks = "";
+	let error;
+	try {
+		const bootOptions = {
+			isBrowser: true,
+			isInteractive: true,
+			document,
+			rootElement: document.body,
+			shouldRender: true,
+			...rehydrate ? { _renderMode: "serialize" } : {}
+		};
+		const instance = await app.visit(url, bootOptions);
+		await new Promise((resolve) => setTimeout(resolve, 0));
+		if (cssManifest) cssLinks = buildRouteCssLinks(cssManifest, instance);
+		head = document.head?.innerHTML ?? "";
+		body = document.body?.innerHTML ?? "";
+		if (document.body) for (const attr of Array.from(document.body.attributes)) bodyAttrs[attr.name] = attr.value;
+		instance.destroy();
+		if (rehydrate) document.body.innerHTML = "";
+		if (document.body) for (const attr of Array.from(document.body.attributes)) document.body.removeAttribute(attr.name);
+	} catch (e) {
+		error = e instanceof Error ? e : new Error(String(e));
+	}
+	requestHeaders = null;
+	const shoeboxHTML = shoeboxEntries && shoeboxEntries.size > 0 ? serializeShoebox(Array.from(shoeboxEntries.values())) : "";
+	return {
+		head: cssLinks + (rehydrate ? "<script>window.__vite_ember_ssr_rehydrate__=true<\/script>" : "") + shoeboxHTML + head,
+		body: rehydrate ? body : `<script type="x/boundary" id="ssr-body-start"><\/script>${body}<script type="x/boundary" id="ssr-body-end"><\/script>`,
+		bodyAttrs,
+		statusCode: error ? 500 : 200,
+		...error ? { error: error.message + (error.stack ? "\n" + error.stack : "") } : {}
+	};
+}
+//#endregion
+export { render as default };
+
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","names":[],"sources":["../src/worker.ts"],"sourcesContent":["/**\n * SSR worker — long-lived Window per thread.\n *\n * One Window is created at worker startup and lives for the worker's lifetime.\n * One EmberApplication is created eagerly (top-level await) and reused for\n * every render. Renders are serialised by tinypool (concurrentTasksPerWorker:1),\n * so there is no concurrency concern within a single worker.\n *\n * app.visit() fully owns document.head/body between calls, so DOM state does\n * not bleed across renders. A fresh ApplicationInstance is created per visit\n * and destroyed after the DOM is read, keeping container singletons clean.\n *\n * The shoebox fetch interceptor is installed once at startup. Each render\n * assigns a fresh entries Map before visiting, so entries never bleed between\n * requests. When shoebox is disabled, the Map is set to null and the\n * interceptor is a no-op passthrough.\n */\n\nimport { Window } from 'happy-dom';\nimport type { CssManifest } from './vite-plugin.js';\nimport type {\n  EmberApplication,\n  EmberApplicationInstance,\n  BootOptions,\n  ShoeboxEntry,\n} from './server.js';\n\n// ─── Types ────────────────────────────────────────────────────────────\n\nexport interface WorkerRenderOptions {\n  ssrBundlePath: string;\n  url: string;\n  shoebox: boolean;\n  rehydrate: boolean;\n  cssManifest: CssManifest | null;\n  headers: Record<string, string> | null;\n}\n\nexport interface WorkerRenderResult {\n  head: string;\n  body: string;\n  bodyAttrs: Record<string, string>;\n  statusCode: number;\n  error?: string;\n}\n\n// ─── Browser globals ──────────────────────────────────────────────────\n\nconst BROWSER_GLOBALS = [\n  'window',\n  'document',\n  'navigator',\n  'location',\n  'history',\n  'HTMLElement',\n  'Element',\n  'Node',\n  'Event',\n  'CustomEvent',\n  'MutationObserver',\n  'requestAnimationFrame',\n  'cancelAnimationFrame',\n  'self',\n  'localStorage',\n  'sessionStorage',\n  'InputEvent',\n  'KeyboardEvent',\n  'MouseEvent',\n  'FocusEvent',\n  'PointerEvent',\n  'IntersectionObserver',\n  'ResizeObserver',\n  'CSSStyleSheet',\n] as const;\n\nfunction installGlobals(win: Window): void {\n  for (const name of BROWSER_GLOBALS) {\n    try {\n      Object.defineProperty(globalThis, name, {\n        value: (win as unknown as Record<string, unknown>)[name],\n        writable: true,\n        configurable: true,\n        enumerable: true,\n      });\n    } catch {\n      /* skip non-overridable globals */\n    }\n  }\n}\n\n// ─── Eager startup: single long-lived Window + app ────────────────────\n\nconst win = new Window({\n  url: 'http://localhost/',\n  width: 1024,\n  height: 768,\n  settings: {\n    disableJavaScriptFileLoading: true,\n    disableJavaScriptEvaluation: true,\n    disableCSSFileLoading: true,\n    navigator: { userAgent: 'vite-ember-ssr' },\n  },\n});\n\n// Install browser globals once for this worker's lifetime.\ninstallGlobals(win);\n\nconst { ssrBundlePath: startupBundlePath } = (\n  process as unknown as {\n    __tinypool_state__: { workerData: { ssrBundlePath: string } };\n  }\n).__tinypool_state__.workerData;\n\nconst startupMod = (await import(startupBundlePath)) as {\n  createSsrApp?: () => EmberApplication;\n};\nif (typeof startupMod.createSsrApp !== 'function') {\n  throw new Error(\n    `SSR bundle '${startupBundlePath}' does not export a 'createSsrApp' function. ` +\n      `Found exports: ${Object.keys(startupMod).join(', ')}`,\n  );\n}\n\nconst app: EmberApplication = startupMod.createSsrApp();\n\n// ─── Shoebox ──────────────────────────────────────────────────────────\n\nconst SHOEBOX_SCRIPT_ID = 'vite-ember-ssr-shoebox';\n\n// The fetch interceptor is installed once at startup. globalThis.fetch\n// never changes. Each render passes fresh per-render state so there is\n// no bleed between requests.\nconst realFetch = globalThis.fetch;\nlet shoeboxEntries: Map<string, ShoeboxEntry> | null = null;\nlet requestHeaders: Record<string, string> | null = null;\n\nconst interceptedFetch: typeof fetch = async (input, init) => {\n  const request = new Request(input, init);\n\n  // Inject forwarded request headers (e.g., cookies) into outgoing fetches.\n  // Only applies to requests without an existing cookie/authorization header,\n  // so explicit headers in app code are not overwritten.\n  if (requestHeaders) {\n    const mergedInit = { ...init };\n    const existingHeaders = new Headers(mergedInit.headers);\n    for (const [key, value] of Object.entries(requestHeaders)) {\n      if (!existingHeaders.has(key)) {\n        existingHeaders.set(key, value);\n      }\n    }\n    mergedInit.headers = existingHeaders;\n    const mergedRequest = new Request(input, mergedInit);\n\n    if (mergedRequest.method.toUpperCase() !== 'GET') return realFetch(mergedRequest);\n    const response = await realFetch(mergedRequest);\n    if (shoeboxEntries) {\n      captureShoeboxEntry(mergedRequest, response);\n    }\n    return response;\n  }\n\n  if (request.method.toUpperCase() !== 'GET') return realFetch(input, init);\n  const response = await realFetch(input, init);\n  if (shoeboxEntries) {\n    captureShoeboxEntry(request, response);\n  }\n  return response;\n};\n\nasync function captureShoeboxEntry(\n  request: Request,\n  response: Response,\n): Promise<void> {\n  try {\n    const clone = response.clone();\n    const body = await clone.text();\n    const headers: Record<string, string> = {};\n    clone.headers.forEach((v, k) => {\n      headers[k] = v;\n    });\n    shoeboxEntries?.set(request.url, {\n      url: request.url,\n      status: clone.status,\n      statusText: clone.statusText,\n      headers,\n      body,\n    });\n  } catch {\n    /* skip */\n  }\n}\n\n// Install once — never needs to be restored.\nglobalThis.fetch = interceptedFetch;\n\nfunction serializeShoebox(entries: ShoeboxEntry[]): string {\n  if (entries.length === 0) return '';\n  const safeJson = JSON.stringify(entries).replace(/<\\/(script)/gi, '<\\\\/$1');\n  return `<script type=\"application/json\" id=\"${SHOEBOX_SCRIPT_ID}\">${safeJson}</script>`;\n}\n\n// ─── CSS manifest helpers ─────────────────────────────────────────────\n\nfunction getActiveRouteName(\n  instance: EmberApplicationInstance,\n): string | undefined {\n  if (!instance.lookup) return undefined;\n  try {\n    const router = instance.lookup('service:router') as\n      | { currentRouteName?: string }\n      | undefined;\n    return router?.currentRouteName ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction buildRouteCssLinks(\n  manifest: CssManifest | null,\n  instance: EmberApplicationInstance,\n): string {\n  if (!manifest) return '';\n  const routeName = getActiveRouteName(instance);\n  if (!routeName) return '';\n  const segments = routeName.split('.');\n  const seen = new Set<string>();\n  const links: string[] = [];\n  for (let i = 1; i <= segments.length; i++) {\n    const cssFiles = manifest[segments.slice(0, i).join('.')];\n    if (!cssFiles) continue;\n    for (const href of cssFiles) {\n      if (seen.has(href)) continue;\n      seen.add(href);\n      links.push(`<link rel=\"stylesheet\" href=\"${href}\">`);\n    }\n  }\n  return links.join('');\n}\n\nexport default async function render(\n  options: WorkerRenderOptions,\n): Promise<WorkerRenderResult> {\n  const { url, shoebox, rehydrate, cssManifest, headers } = options;\n\n  // Use the long-lived document directly — no new Window, no globalThis swap.\n  const document = win.document;\n\n  // Give the interceptor a fresh Map for this render, or null if shoebox\n  // is disabled, so entries never bleed between requests.\n  shoeboxEntries = shoebox ? new Map() : null;\n\n  // Forward request headers (e.g., cookies) to outgoing fetch calls\n  // for this render only. Cleared after the render completes.\n  requestHeaders = headers;\n\n  let head = '';\n  let body = '';\n  let bodyAttrs: Record<string, string> = {};\n  let cssLinks = '';\n  let error: Error | undefined;\n\n  try {\n    const bootOptions: BootOptions = {\n      isBrowser: true,\n      isInteractive: true,\n      document: document as unknown as Document,\n      rootElement: document.body as unknown as Element,\n      shouldRender: true,\n      ...(rehydrate ? { _renderMode: 'serialize' as const } : {}),\n    };\n\n    const instance = await app.visit(url, bootOptions);\n\n    // Drain Backburner's autorun microtask before reading the DOM.\n    await new Promise<void>((resolve) => setTimeout(resolve, 0));\n\n    if (cssManifest) cssLinks = buildRouteCssLinks(cssManifest, instance);\n    head = document.head?.innerHTML ?? '';\n    body = document.body?.innerHTML ?? '';\n\n    // Extract attributes set on <body> during rendering (e.g., data-theme, class).\n    if (document.body) {\n      for (const attr of Array.from(document.body.attributes)) {\n        bodyAttrs[attr.name] = attr.value;\n      }\n    }\n\n    // Destroy the instance so its container is torn down cleanly.\n    // app.visit() creates a fresh ApplicationInstance per call; without\n    // destroying it the container's singletons (including location:none)\n    // remain live and can corrupt the next visit.\n    instance.destroy();\n\n    // rehydrate mode causes left over rehydration markers to remain in the DOM, so\n    // we clear the body to ensure a clean slate for the next render.\n    if (rehydrate) {\n      document.body.innerHTML = '';\n    }\n\n    // Clear body attributes so they don't bleed into the next render.\n    if (document.body) {\n      for (const attr of Array.from(document.body.attributes)) {\n        document.body.removeAttribute(attr.name);\n      }\n    }\n  } catch (e) {\n    error = e instanceof Error ? e : new Error(String(e));\n  }\n\n  // Clear per-render state to prevent bleed between requests.\n  requestHeaders = null;\n\n  const shoeboxHTML =\n    shoeboxEntries && shoeboxEntries.size > 0\n      ? serializeShoebox(Array.from(shoeboxEntries.values()))\n      : '';\n  const rehydrateHTML = rehydrate\n    ? '<script>window.__vite_ember_ssr_rehydrate__=true</script>'\n    : '';\n  const fullHead = cssLinks + rehydrateHTML + shoeboxHTML + head;\n  const wrappedBody = rehydrate\n    ? body\n    : `<script type=\"x/boundary\" id=\"ssr-body-start\"></script>${body}<script type=\"x/boundary\" id=\"ssr-body-end\"></script>`;\n\n  return {\n    head: fullHead,\n    body: wrappedBody,\n    bodyAttrs,\n    statusCode: error ? 500 : 200,\n    ...(error\n      ? { error: error.message + (error.stack ? '\\n' + error.stack : '') }\n      : {}),\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@st-h/vite-ember-ssr",
+  "version": "0.2.0-alpha.1",
+  "description": "Vite plugin and SSR runtime for Ember.js applications using HappyDOM",
+  "type": "module",
+  "license": "MIT",
+  "author": "Liam Potter",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evoactivity/vite-ember-ssr.git",
+    "directory": "packages/vite-ember-ssr"
+  },
+  "homepage": "https://github.com/evoactivity/vite-ember-ssr/tree/main/packages/vite-ember-ssr#readme",
+  "bugs": "https://github.com/evoactivity/vite-ember-ssr/issues",
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "ember",
+    "emberjs",
+    "ssr",
+    "server-side-rendering",
+    "happydom",
+    "embroider"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "exports": {
+    "./vite-plugin": {
+      "types": "./dist/vite-plugin.d.ts",
+      "import": "./dist/vite-plugin.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "prepublishOnly": "pnpm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:browser": "playwright test",
+    "test:all": "vitest run && playwright test"
+  },
+  "dependencies": {
+    "happy-dom": "^20.8.9",
+    "tinypool": "^2.1.0"
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0 || ^7.0.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@types/node": "^25.5.0",
+    "playwright": "^1.58.2",
+    "tsdown": "^0.21.7",
+    "typescript": "^6.0.2",
+    "vite": "^7.3.1",
+    "vitest": "^4.1.2"
+  }
+}

package/src/client.ts

@@ -0,0 +1,242 @@
+/**
+ * Client-side utilities for vite-ember-ssr.
+ *
+ * Currently the client Ember app boots normally and replaces the
+ * SSR-rendered content. True DOM hydration is planned for a future
+ * phase.
+ *
+ * For now, the SSR content provides the initial visual while client
+ * JavaScript loads, parses, and Ember boots.
+ */
+
+// ─── Shoebox Types ───────────────────────────────────────────────────
+
+/**
+ * A captured fetch response transferred from the server.
+ * Must match the ShoeboxEntry interface in server.ts.
+ */
+interface ShoeboxEntry {
+  url: string;
+  status: number;
+  statusText: string;
+  headers: Record<string, string>;
+  body: string;
+}
+
+const SHOEBOX_SCRIPT_ID = 'vite-ember-ssr-shoebox';
+
+// ─── Shoebox: Client-Side Fetch Replay ───────────────────────────────
+
+/** Original fetch function, saved before monkey-patching */
+let _originalFetch: typeof fetch | null = null;
+
+/** Map of URL → { entry, refCount } for reference-counted consumption */
+let _shoeboxMap: Map<string, { entry: ShoeboxEntry; refCount: number }> | null =
+  null;
+
+/**
+ * Installs the shoebox fetch interceptor on the client.
+ *
+ * Reads the shoebox data from the server-injected <script> tag,
+ * removes the tag from the DOM, and monkey-patches globalThis.fetch
+ * to serve cached responses for URLs that match shoebox entries.
+ *
+ * Each entry is reference-counted: concurrent fetch calls to the same
+ * URL all receive the shoebox response. The entry is removed only when
+ * the last concurrent consumer has been served.
+ *
+ * Call this BEFORE creating the Ember application, typically as the
+ * first thing in your client entry point.
+ *
+ * @returns true if shoebox data was found and installed, false otherwise
+ */
+export function installShoebox(): boolean {
+  const scriptEl = document.getElementById(SHOEBOX_SCRIPT_ID);
+  if (!scriptEl) {
+    return false;
+  }
+
+  // Parse the shoebox data
+  let entries: ShoeboxEntry[];
+  try {
+    entries = JSON.parse(scriptEl.textContent ?? '[]');
+  } catch {
+    // Malformed shoebox data — skip
+    scriptEl.remove();
+    return false;
+  }
+
+  // Remove the script tag from the DOM
+  scriptEl.remove();
+
+  if (entries.length === 0) {
+    return false;
+  }
+
+  // Build the lookup map with ref counts
+  _shoeboxMap = new Map();
+  for (const entry of entries) {
+    _shoeboxMap.set(entry.url, { entry, refCount: 1 });
+  }
+
+  // Save the original fetch and install our interceptor
+  _originalFetch = globalThis.fetch;
+
+  globalThis.fetch = function shoeboxFetch(
+    input: RequestInfo | URL,
+    init?: RequestInit,
+  ): Promise<Response> {
+    // Only intercept GET requests (or requests with no method, which default to GET)
+    const method = init?.method?.toUpperCase() ?? 'GET';
+    if (method !== 'GET' || !_shoeboxMap || _shoeboxMap.size === 0) {
+      return _originalFetch!(input, init);
+    }
+
+    // Resolve the URL string for matching
+    let url: string;
+    try {
+      if (typeof input === 'string') {
+        url = new URL(input, globalThis.location?.href).href;
+      } else if (input instanceof URL) {
+        url = input.href;
+      } else if (input instanceof Request) {
+        url = input.url;
+      } else {
+        return _originalFetch!(input, init);
+      }
+    } catch {
+      return _originalFetch!(input, init);
+    }
+
+    const cached = _shoeboxMap.get(url);
+    if (!cached) {
+      return _originalFetch!(input, init);
+    }
+
+    // Decrement ref count and remove if exhausted
+    cached.refCount--;
+    if (cached.refCount <= 0) {
+      _shoeboxMap.delete(url);
+    }
+
+    // Construct a Response from the cached data
+    const { entry } = cached;
+    const response = new Response(entry.body, {
+      status: entry.status,
+      statusText: entry.statusText,
+      headers: new Headers(entry.headers),
+    });
+
+    // Auto-cleanup when the map is empty
+    if (_shoeboxMap.size === 0) {
+      cleanupShoebox();
+    }
+
+    return Promise.resolve(response);
+  };
+
+  return true;
+}
+
+/**
+ * Restores the original fetch function and cleans up shoebox state.
+ *
+ * Called automatically when all shoebox entries have been consumed,
+ * or can be called manually to force cleanup.
+ */
+export function cleanupShoebox(): void {
+  if (_originalFetch) {
+    globalThis.fetch = _originalFetch;
+    _originalFetch = null;
+  }
+  _shoeboxMap = null;
+}
+
+// ─── SSR Content Cleanup ─────────────────────────────────────────────
+
+/**
+ * Removes the SSR-rendered content from the DOM so the client Ember
+ * app can render into a clean `<body>`. This prevents the "double
+ * render" where both server-rendered HTML and client-rendered HTML
+ * are visible simultaneously.
+ *
+ * Removes everything between (and including) the SSR boundary markers:
+ *   <script type="x/boundary" id="ssr-body-start">
+ *   ...server rendered content...
+ *   <script type="x/boundary" id="ssr-body-end">
+ *
+ * **Call this from your application template** rather than from
+ * `entry.ts` — this ensures removal happens at the moment Ember
+ * renders, avoiding a flash of no content:
+ *
+ * ```gts
+ * import { cleanupSSRContent } from '@st-h/vite-ember-ssr/client';
+ *
+ * <template>
+ *   {{cleanupSSRContent}}
+ *   {{outlet}}
+ * </template>
+ * ```
+ *
+ * Only used in cleanup mode (default). Not needed when using
+ * `rehydrate: true` — in that mode Glimmer reuses the existing DOM.
+ */
+export function cleanupSSRContent(): void {
+  const start = document.getElementById('ssr-body-start');
+  const end = document.getElementById('ssr-body-end');
+
+  if (!start || !end) {
+    return; // Not an SSR-rendered page
+  }
+
+  // Remove all nodes between start and end markers (inclusive)
+  const parent = start.parentNode;
+  if (!parent) return;
+
+  let node: ChildNode | null = start;
+  while (node) {
+    const next: ChildNode | null = node.nextSibling;
+    parent.removeChild(node);
+    if (node === end) break;
+    node = next;
+  }
+}
+
+/**
+ * Checks if the current page was server-side rendered by looking
+ * for SSR boundary markers in the DOM.
+ */
+export function isSSRRendered(): boolean {
+  return document.getElementById('ssr-body-start') !== null;
+}
+
+/**
+ * Checks whether the current page was rendered with rehydration mode.
+ *
+ * Returns `true` when the server (or SSG build) injected the
+ * `window.__vite_ember_ssr_rehydrate__` flag. Use this in your client
+ * entry point to decide whether to boot Ember in rehydrate mode or
+ * with a normal boot:
+ *
+ * ```ts
+ * import { shouldRehydrate, installShoebox } from '@st-h/vite-ember-ssr/client';
+ *
+ * installShoebox();
+ *
+ * const app = Application.create({ ...config.APP, autoboot: false });
+ *
+ * app.visit(window.location.pathname + window.location.search, {
+ *   ...(shouldRehydrate() ? { _renderMode: 'rehydrate' } : {}),
+ * });
+ * ```
+ *
+ * This is especially important for SSG apps where only prerendered
+ * routes carry the flag — non-SSG routes will boot normally without
+ * attempting rehydration (which would fail with no serialized DOM).
+ */
+export function shouldRehydrate(): boolean {
+  return (
+    (window as unknown as Record<string, unknown>)
+      .__vite_ember_ssr_rehydrate__ === true
+  );
+}