@inertiajs/core 2.3.17 → 3.0.0-beta.1

package/dist/server.js

@@ -1,42 +1,236 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+// src/server.ts
+import { originalPositionFor, TraceMap } from "@jridgewell/trace-mapping";
+import { createServer } from "http";
+import cluster from "node:cluster";
+import { existsSync, readFileSync } from "node:fs";
+import { availableParallelism } from "node:os";
+import path from "node:path";
+import * as process2 from "process";
+
+// src/ssrErrors.ts
+var sourceMapResolver = null;
+function setSourceMapResolver(resolver) {
+  sourceMapResolver = resolver;
+}
+var BROWSER_APIS = {
+  // Global objects
+  window: "The global window object",
+  document: "The DOM document object",
+  navigator: "The navigator object",
+  location: "The location object",
+  history: "The browser history API",
+  screen: "The screen object",
+  localStorage: "Browser local storage",
+  sessionStorage: "Browser session storage",
+  // Viewport properties (accessed via window.X)
+  innerWidth: "Browser viewport width",
+  innerHeight: "Browser viewport height",
+  outerWidth: "Browser window width",
+  outerHeight: "Browser window height",
+  scrollX: "Horizontal scroll position",
+  scrollY: "Vertical scroll position",
+  devicePixelRatio: "The device pixel ratio",
+  matchMedia: "The matchMedia function",
+  // Observers (commonly instantiated at module level)
+  IntersectionObserver: "The IntersectionObserver API",
+  ResizeObserver: "The ResizeObserver API",
+  MutationObserver: "The MutationObserver API",
+  // Timing functions (commonly called at module level)
+  requestAnimationFrame: "The requestAnimationFrame function",
+  requestIdleCallback: "The requestIdleCallback function",
+  // Constructors that might be used at module level
+  Image: "The Image constructor",
+  Audio: "The Audio constructor",
+  Worker: "The Worker constructor",
+  BroadcastChannel: "The BroadcastChannel constructor",
+  // Network (older Node.js versions)
+  fetch: "The fetch API",
+  XMLHttpRequest: "The XMLHttpRequest API"
 };
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+function detectBrowserApi(error) {
+  const message = error.message.toLowerCase();
+  for (const api of Object.keys(BROWSER_APIS)) {
+    const patterns = [
+      `${api.toLowerCase()} is not defined`,
+      `'${api.toLowerCase()}' is not defined`,
+      `"${api.toLowerCase()}" is not defined`,
+      `cannot read properties of undefined (reading '${api.toLowerCase()}')`,
+      `cannot read property '${api.toLowerCase()}'`
+    ];
+    if (patterns.some((pattern) => message.includes(pattern))) {
+      return api;
+    }
+  }
+  return null;
+}
+function isComponentResolutionError(error) {
+  const message = error.message.toLowerCase();
+  return message.includes("cannot find module") || message.includes("failed to resolve") || message.includes("module not found") || message.includes("could not resolve");
+}
+var LIFECYCLE_HOOKS = "onMounted/useEffect/onMount";
+function getBrowserApiHint(api) {
+  const apiDescription = BROWSER_APIS[api] || `The "${api}" object`;
+  if (["localStorage", "sessionStorage"].includes(api)) {
+    return `${apiDescription} doesn't exist in Node.js. Check "typeof ${api} !== 'undefined'" before using it, or move the code to a ${LIFECYCLE_HOOKS} lifecycle hook.`;
+  }
+  if (["window", "document"].includes(api)) {
+    return `${apiDescription} doesn't exist in Node.js. Wrap browser-specific code in a ${LIFECYCLE_HOOKS} lifecycle hook, or check "typeof ${api} !== 'undefined'" before using it.`;
+  }
+  if (["IntersectionObserver", "ResizeObserver", "MutationObserver"].includes(api)) {
+    return `${apiDescription} doesn't exist in Node.js. Create observers inside a ${LIFECYCLE_HOOKS} lifecycle hook, not at the module level.`;
   }
-  return to;
+  if (["fetch", "XMLHttpRequest"].includes(api)) {
+    return `${apiDescription} may not be available in all Node.js versions. For SSR, ensure data fetching happens on the server (in your controller) and is passed as props, or use a ${LIFECYCLE_HOOKS} hook for client-side fetching.`;
+  }
+  return `${apiDescription} doesn't exist in Node.js. Move this code to a ${LIFECYCLE_HOOKS} lifecycle hook, or guard it with "typeof ${api} !== 'undefined'".`;
+}
+function getComponentResolutionHint(component) {
+  const componentPart = component ? ` "${component}"` : "";
+  return `Could not resolve component${componentPart}. Check that the file exists and the path is correct. Ensure the component name matches the file name exactly (case-sensitive).`;
+}
+function getRenderErrorHint() {
+  return "An error occurred while rendering the component. Check the component for browser-specific code that runs during initialization. Move any code that accesses browser APIs to a lifecycle hook.";
+}
+function extractSourceLocation(stack) {
+  if (!stack) {
+    return void 0;
+  }
+  for (const line of stack.split("\n")) {
+    if (!line.includes("at ")) {
+      continue;
+    }
+    if (line.includes("node_modules") || line.includes("node:")) {
+      continue;
+    }
+    let match = line.match(/\(([^)]+):(\d+):(\d+)\)/);
+    if (!match) {
+      match = line.match(/at\s+(?:file:\/\/)?(.+):(\d+):(\d+)\s*$/);
+    }
+    if (match) {
+      const file = match[1].replace(/^file:\/\//, "");
+      const lineNum = parseInt(match[2], 10);
+      const colNum = parseInt(match[3], 10);
+      if (sourceMapResolver) {
+        const resolved = sourceMapResolver(file, lineNum, colNum);
+        if (resolved) {
+          return `${resolved.file}:${resolved.line}:${resolved.column}`;
+        }
+      }
+      return `${file}:${lineNum}:${colNum}`;
+    }
+  }
+  return void 0;
+}
+function classifySSRError(error, component, url) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const base = {
+    error: error.message,
+    component,
+    url,
+    stack: error.stack,
+    sourceLocation: extractSourceLocation(error.stack),
+    timestamp
+  };
+  const browserApi = detectBrowserApi(error);
+  if (browserApi) {
+    return {
+      ...base,
+      type: "browser-api",
+      browserApi,
+      hint: getBrowserApiHint(browserApi)
+    };
+  }
+  if (isComponentResolutionError(error)) {
+    return {
+      ...base,
+      type: "component-resolution",
+      hint: getComponentResolutionHint(component)
+    };
+  }
+  return {
+    ...base,
+    type: "render",
+    hint: getRenderErrorHint()
+  };
+}
+var colors = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  yellow: "\x1B[33m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m",
+  bold: "\x1B[1m",
+  bgRed: "\x1B[41m",
+  white: "\x1B[37m"
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+function makeRelative(path2, root) {
+  const base = root ?? process.cwd();
+  if (path2.startsWith(base + "/")) {
+    return path2.slice(base.length + 1);
+  }
+  return path2;
+}
+function formatConsoleError(classified, root, handleErrors = true, suppressedWarnings = []) {
+  if (!handleErrors) {
+    const component = classified.component ? `[${classified.component}]` : "";
+    return `SSR Error ${component}: ${classified.error}`;
+  }
+  const componentPart = classified.component ? `  ${colors.cyan}${classified.component}${colors.reset}` : "";
+  const lines = [
+    "",
+    `  ${colors.bgRed}${colors.white}${colors.bold} SSR ERROR ${colors.reset}${componentPart}`,
+    "",
+    `  ${classified.error}`
+  ];
+  if (classified.sourceLocation) {
+    const relativePath = makeRelative(classified.sourceLocation, root);
+    lines.push(`  ${colors.dim}Source: ${relativePath}${colors.reset}`);
+  }
+  if (classified.url) {
+    lines.push(`  ${colors.dim}URL: ${classified.url}${colors.reset}`);
+  }
+  lines.push("", `  ${colors.yellow}Hint${colors.reset}  ${classified.hint}`, "");
+  if (classified.stack) {
+    lines.push(`  ${colors.dim}${classified.stack.split("\n").join("\n  ")}${colors.reset}`, "");
+  }
+  if (suppressedWarnings.length > 0) {
+    lines.push(`  ${colors.dim}Suppressed ${suppressedWarnings.length} framework warning(s).${colors.reset}`, "");
+  }
+  return lines.join("\n");
+}
 
 // src/server.ts
-var server_exports = {};
-__export(server_exports, {
-  default: () => server_default
+var sourceMaps = /* @__PURE__ */ new Map();
+setSourceMapResolver((file, line, column) => {
+  if (!file.includes("/ssr/") || !file.endsWith(".js")) {
+    return null;
+  }
+  const mapFile = file + ".map";
+  if (!existsSync(mapFile)) {
+    return null;
+  }
+  let traceMap = sourceMaps.get(mapFile);
+  if (!traceMap) {
+    try {
+      const mapContent = readFileSync(mapFile, "utf-8");
+      traceMap = new TraceMap(mapContent);
+      sourceMaps.set(mapFile, traceMap);
+    } catch {
+      return null;
+    }
+  }
+  const original = originalPositionFor(traceMap, { line, column });
+  if (original.source) {
+    const mapDir = path.dirname(mapFile);
+    const resolvedPath = path.resolve(mapDir, original.source);
+    return {
+      file: resolvedPath,
+      line: original.line ?? line,
+      column: original.column ?? column
+    };
+  }
+  return null;
 });
-module.exports = __toCommonJS(server_exports);
-var import_http = require("http");
-var import_node_cluster = __toESM(require("node:cluster"), 1);
-var import_node_os = require("node:os");
-var process = __toESM(require("process"), 1);
 var readableToString = (readable) => new Promise((resolve, reject) => {
   let data = "";
   readable.on("data", (chunk) => data += chunk);
@@ -44,49 +238,76 @@ var readableToString = (readable) => new Promise((resolve, reject) => {
   readable.on("error", (err) => reject(err));
 });
 var server_default = (render, options) => {
-  const _port = typeof options === "number" ? options : options?.port ?? 13714;
-  const _useCluster = typeof options === "object" && options?.cluster !== void 0 ? options.cluster : false;
+  const opts = typeof options === "number" ? { port: options } : options;
+  const { port = 13714, cluster: useCluster = false, handleErrors = true } = opts ?? {};
   const log = (message) => {
     console.log(
-      _useCluster && !import_node_cluster.default.isPrimary ? `[${import_node_cluster.default.worker?.id ?? "N/A"} / ${import_node_cluster.default.worker?.process?.pid ?? "N/A"}] ${message}` : message
+      useCluster && !cluster.isPrimary ? `[${cluster.worker?.id ?? "N/A"} / ${cluster.worker?.process?.pid ?? "N/A"}] ${message}` : message
     );
   };
-  if (_useCluster && import_node_cluster.default.isPrimary) {
+  if (useCluster && cluster.isPrimary) {
     log("Primary Inertia SSR server process started...");
-    for (let i = 0; i < (0, import_node_os.availableParallelism)(); i++) {
-      import_node_cluster.default.fork();
+    for (let i = 0; i < availableParallelism(); i++) {
+      cluster.fork();
     }
-    import_node_cluster.default.on("message", (_worker, message) => {
+    cluster.on("message", (_worker, message) => {
       if (message === "shutdown") {
-        for (const id in import_node_cluster.default.workers) {
-          import_node_cluster.default.workers[id]?.kill();
+        for (const id in cluster.workers) {
+          cluster.workers[id]?.kill();
         }
-        process.exit();
+        process2.exit();
       }
     });
-    return;
+    return render;
   }
+  const handleRender = async (request, response) => {
+    const page = JSON.parse(await readableToString(request));
+    const originalWarn = console.warn;
+    if (handleErrors) {
+      console.warn = () => {
+      };
+    }
+    try {
+      const result = await render(page);
+      response.writeHead(200, { "Content-Type": "application/json", Server: "Inertia.js SSR" });
+      response.write(JSON.stringify(result));
+    } catch (e) {
+      const error = e;
+      if (!handleErrors) {
+        throw error;
+      }
+      const classified = classifySSRError(error, page.component, page.url);
+      console.error(formatConsoleError(classified));
+      response.writeHead(500, { "Content-Type": "application/json", Server: "Inertia.js SSR" });
+      response.write(JSON.stringify(classified));
+    } finally {
+      console.warn = originalWarn;
+    }
+  };
   const routes = {
     "/health": async () => ({ status: "OK", timestamp: Date.now() }),
     "/shutdown": async () => {
-      if (import_node_cluster.default.isWorker) {
-        process.send?.("shutdown");
+      if (cluster.isWorker) {
+        process2.send?.("shutdown");
       }
-      process.exit();
+      process2.exit();
     },
-    "/render": async (request) => render(JSON.parse(await readableToString(request))),
+    "/render": handleRender,
     "/404": async () => ({ status: "NOT_FOUND", timestamp: Date.now() })
   };
-  (0, import_http.createServer)(async (request, response) => {
-    const dispatchRoute = routes[request.url] || routes["/404"];
-    try {
+  createServer(async (request, response) => {
+    const dispatchRoute = routes[request.url] ?? routes["/404"];
+    const result = await dispatchRoute(request, response);
+    if (!response.headersSent) {
       response.writeHead(200, { "Content-Type": "application/json", Server: "Inertia.js SSR" });
-      response.write(JSON.stringify(await dispatchRoute(request)));
-    } catch (e) {
-      console.error(e);
+      response.write(JSON.stringify(result));
     }
     response.end();
-  }).listen(_port, () => log("Inertia SSR server started."));
-  log(`Starting SSR server on port ${_port}...`);
+  }).listen(port, () => log("Inertia SSR server started."));
+  log(`Starting SSR server on port ${port}...`);
+  return render;
+};
+export {
+  server_default as default
 };
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/server.ts"],
-  "sourcesContent": ["import { createServer, IncomingMessage } from 'http'\nimport cluster from 'node:cluster'\nimport { availableParallelism } from 'node:os'\nimport * as process from 'process'\nimport { InertiaAppResponse, Page } from './types'\n\ntype AppCallback = (page: Page) => InertiaAppResponse\ntype RouteHandler = (request: IncomingMessage) => Promise<unknown>\ntype ServerOptions = {\n  port?: number\n  cluster?: boolean\n}\ntype Port = number\n\nconst readableToString: (readable: IncomingMessage) => Promise<string> = (readable) =>\n  new Promise((resolve, reject) => {\n    let data = ''\n    readable.on('data', (chunk) => (data += chunk))\n    readable.on('end', () => resolve(data))\n    readable.on('error', (err) => reject(err))\n  })\n\nexport default (render: AppCallback, options?: Port | ServerOptions): void => {\n  const _port = typeof options === 'number' ? options : (options?.port ?? 13714)\n  const _useCluster = typeof options === 'object' && options?.cluster !== undefined ? options.cluster : false\n\n  const log = (message: string) => {\n    console.log(\n      _useCluster && !cluster.isPrimary\n        ? `[${cluster.worker?.id ?? 'N/A'} / ${cluster.worker?.process?.pid ?? 'N/A'}] ${message}`\n        : message,\n    )\n  }\n\n  if (_useCluster && cluster.isPrimary) {\n    log('Primary Inertia SSR server process started...')\n\n    for (let i = 0; i < availableParallelism(); i++) {\n      cluster.fork()\n    }\n\n    cluster.on('message', (_worker, message) => {\n      if (message === 'shutdown') {\n        for (const id in cluster.workers) {\n          cluster.workers[id]?.kill()\n        }\n\n        process.exit()\n      }\n    })\n\n    return\n  }\n\n  const routes: Record<string, RouteHandler> = {\n    '/health': async () => ({ status: 'OK', timestamp: Date.now() }),\n    '/shutdown': async () => {\n      if (cluster.isWorker) {\n        process.send?.('shutdown')\n      }\n\n      process.exit()\n    },\n    '/render': async (request) => render(JSON.parse(await readableToString(request))),\n    '/404': async () => ({ status: 'NOT_FOUND', timestamp: Date.now() }),\n  }\n\n  createServer(async (request, response) => {\n    const dispatchRoute = routes[<string>request.url] || routes['/404']\n\n    try {\n      response.writeHead(200, { 'Content-Type': 'application/json', Server: 'Inertia.js SSR' })\n      response.write(JSON.stringify(await dispatchRoute(request)))\n    } catch (e) {\n      console.error(e)\n    }\n\n    response.end()\n  }).listen(_port, () => log('Inertia SSR server started.'))\n\n  log(`Starting SSR server on port ${_port}...`)\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAA8C;AAC9C,0BAAoB;AACpB,qBAAqC;AACrC,cAAyB;AAWzB,IAAM,mBAAmE,CAAC,aACxE,IAAI,QAAQ,CAAC,SAAS,WAAW;AAC/B,MAAI,OAAO;AACX,WAAS,GAAG,QAAQ,CAAC,UAAW,QAAQ,KAAM;AAC9C,WAAS,GAAG,OAAO,MAAM,QAAQ,IAAI,CAAC;AACtC,WAAS,GAAG,SAAS,CAAC,QAAQ,OAAO,GAAG,CAAC;AAC3C,CAAC;AAEH,IAAO,iBAAQ,CAAC,QAAqB,YAAyC;AAC5E,QAAM,QAAQ,OAAO,YAAY,WAAW,UAAW,SAAS,QAAQ;AACxE,QAAM,cAAc,OAAO,YAAY,YAAY,SAAS,YAAY,SAAY,QAAQ,UAAU;AAEtG,QAAM,MAAM,CAAC,YAAoB;AAC/B,YAAQ;AAAA,MACN,eAAe,CAAC,oBAAAA,QAAQ,YACpB,IAAI,oBAAAA,QAAQ,QAAQ,MAAM,KAAK,MAAM,oBAAAA,QAAQ,QAAQ,SAAS,OAAO,KAAK,KAAK,OAAO,KACtF;AAAA,IACN;AAAA,EACF;AAEA,MAAI,eAAe,oBAAAA,QAAQ,WAAW;AACpC,QAAI,+CAA+C;AAEnD,aAAS,IAAI,GAAG,QAAI,qCAAqB,GAAG,KAAK;AAC/C,0BAAAA,QAAQ,KAAK;AAAA,IACf;AAEA,wBAAAA,QAAQ,GAAG,WAAW,CAAC,SAAS,YAAY;AAC1C,UAAI,YAAY,YAAY;AAC1B,mBAAW,MAAM,oBAAAA,QAAQ,SAAS;AAChC,8BAAAA,QAAQ,QAAQ,EAAE,GAAG,KAAK;AAAA,QAC5B;AAEA,QAAQ,aAAK;AAAA,MACf;AAAA,IACF,CAAC;AAED;AAAA,EACF;AAEA,QAAM,SAAuC;AAAA,IAC3C,WAAW,aAAa,EAAE,QAAQ,MAAM,WAAW,KAAK,IAAI,EAAE;AAAA,IAC9D,aAAa,YAAY;AACvB,UAAI,oBAAAA,QAAQ,UAAU;AACpB,QAAQ,eAAO,UAAU;AAAA,MAC3B;AAEA,MAAQ,aAAK;AAAA,IACf;AAAA,IACA,WAAW,OAAO,YAAY,OAAO,KAAK,MAAM,MAAM,iBAAiB,OAAO,CAAC,CAAC;AAAA,IAChF,QAAQ,aAAa,EAAE,QAAQ,aAAa,WAAW,KAAK,IAAI,EAAE;AAAA,EACpE;AAEA,gCAAa,OAAO,SAAS,aAAa;AACxC,UAAM,gBAAgB,OAAe,QAAQ,GAAG,KAAK,OAAO,MAAM;AAElE,QAAI;AACF,eAAS,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,QAAQ,iBAAiB,CAAC;AACxF,eAAS,MAAM,KAAK,UAAU,MAAM,cAAc,OAAO,CAAC,CAAC;AAAA,IAC7D,SAAS,GAAG;AACV,cAAQ,MAAM,CAAC;AAAA,IACjB;AAEA,aAAS,IAAI;AAAA,EACf,CAAC,EAAE,OAAO,OAAO,MAAM,IAAI,6BAA6B,CAAC;AAEzD,MAAI,+BAA+B,KAAK,KAAK;AAC/C;",
-  "names": ["cluster"]
+  "sources": ["../src/server.ts", "../src/ssrErrors.ts"],
+  "sourcesContent": ["import { originalPositionFor, TraceMap } from '@jridgewell/trace-mapping'\nimport { createServer, IncomingMessage, ServerResponse } from 'http'\nimport cluster from 'node:cluster'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { availableParallelism } from 'node:os'\nimport path from 'node:path'\nimport * as process from 'process'\nimport { classifySSRError, formatConsoleError, setSourceMapResolver } from './ssrErrors'\nimport { InertiaAppResponse, Page } from './types'\n\n// Cache parsed sourcemaps for performance\nconst sourceMaps = new Map<string, TraceMap>()\n\nsetSourceMapResolver((file: string, line: number, column: number) => {\n  // Only resolve for bundled SSR files\n  if (!file.includes('/ssr/') || !file.endsWith('.js')) {\n    return null\n  }\n\n  const mapFile = file + '.map'\n\n  if (!existsSync(mapFile)) {\n    return null\n  }\n\n  let traceMap = sourceMaps.get(mapFile)\n\n  if (!traceMap) {\n    try {\n      const mapContent = readFileSync(mapFile, 'utf-8')\n      traceMap = new TraceMap(mapContent)\n      sourceMaps.set(mapFile, traceMap)\n    } catch {\n      return null\n    }\n  }\n\n  const original = originalPositionFor(traceMap, { line, column })\n\n  if (original.source) {\n    // Resolve the source path relative to the sourcemap location\n    const mapDir = path.dirname(mapFile)\n    const resolvedPath = path.resolve(mapDir, original.source)\n\n    return {\n      file: resolvedPath,\n      line: original.line ?? line,\n      column: original.column ?? column,\n    }\n  }\n\n  return null\n})\n\ntype AppCallback = (page: Page) => InertiaAppResponse\ntype RouteHandler = (request: IncomingMessage, response: ServerResponse) => Promise<unknown>\ntype ServerOptions = {\n  port?: number\n  cluster?: boolean\n  handleErrors?: boolean\n}\ntype Port = number\n\nconst readableToString: (readable: IncomingMessage) => Promise<string> = (readable) =>\n  new Promise((resolve, reject) => {\n    let data = ''\n    readable.on('data', (chunk) => (data += chunk))\n    readable.on('end', () => resolve(data))\n    readable.on('error', (err) => reject(err))\n  })\n\nexport default (render: AppCallback, options?: Port | ServerOptions): AppCallback => {\n  const opts = typeof options === 'number' ? { port: options } : options\n  const { port = 13714, cluster: useCluster = false, handleErrors = true } = opts ?? {}\n\n  const log = (message: string) => {\n    console.log(\n      useCluster && !cluster.isPrimary\n        ? `[${cluster.worker?.id ?? 'N/A'} / ${cluster.worker?.process?.pid ?? 'N/A'}] ${message}`\n        : message,\n    )\n  }\n\n  if (useCluster && cluster.isPrimary) {\n    log('Primary Inertia SSR server process started...')\n\n    for (let i = 0; i < availableParallelism(); i++) {\n      cluster.fork()\n    }\n\n    cluster.on('message', (_worker, message) => {\n      if (message === 'shutdown') {\n        for (const id in cluster.workers) {\n          cluster.workers[id]?.kill()\n        }\n\n        process.exit()\n      }\n    })\n\n    return render\n  }\n\n  const handleRender = async (request: IncomingMessage, response: ServerResponse) => {\n    const page: Page = JSON.parse(await readableToString(request))\n\n    // Suppress framework warnings during render (they clutter the output)\n    const originalWarn = console.warn\n\n    if (handleErrors) {\n      console.warn = () => {}\n    }\n\n    try {\n      const result = await render(page)\n\n      response.writeHead(200, { 'Content-Type': 'application/json', Server: 'Inertia.js SSR' })\n      response.write(JSON.stringify(result))\n    } catch (e) {\n      const error = e as Error\n\n      if (!handleErrors) {\n        throw error\n      }\n\n      const classified = classifySSRError(error, page.component, page.url)\n      console.error(formatConsoleError(classified))\n\n      response.writeHead(500, { 'Content-Type': 'application/json', Server: 'Inertia.js SSR' })\n      response.write(JSON.stringify(classified))\n    } finally {\n      console.warn = originalWarn\n    }\n  }\n\n  const routes: Record<string, RouteHandler> = {\n    '/health': async () => ({ status: 'OK', timestamp: Date.now() }),\n    '/shutdown': async () => {\n      if (cluster.isWorker) {\n        process.send?.('shutdown')\n      }\n\n      process.exit()\n    },\n    '/render': handleRender,\n    '/404': async () => ({ status: 'NOT_FOUND', timestamp: Date.now() }),\n  }\n\n  createServer(async (request, response) => {\n    const dispatchRoute = routes[request.url as string] ?? routes['/404']\n    const result = await dispatchRoute(request, response)\n\n    if (!response.headersSent) {\n      response.writeHead(200, { 'Content-Type': 'application/json', Server: 'Inertia.js SSR' })\n      response.write(JSON.stringify(result))\n    }\n\n    response.end()\n  }).listen(port, () => log('Inertia SSR server started.'))\n\n  log(`Starting SSR server on port ${port}...`)\n\n  // Return the render callback so it can be exported for Vite SSR dev mode\n  return render\n}\n", "/**\n * SSR Error Classification\n *\n * This module detects common SSR errors and provides helpful hints\n * to developers on how to fix them. The most common issue is using\n * browser-specific APIs (like window, document) that don't exist\n * in the Node.js server environment.\n */\n\nexport type SSRErrorType = 'browser-api' | 'component-resolution' | 'render' | 'unknown'\n\ntype SourceMapResolver = (\n  file: string,\n  line: number,\n  column: number,\n) => { file: string; line: number; column: number } | null\n\nlet sourceMapResolver: SourceMapResolver | null = null\n\nexport function setSourceMapResolver(resolver: SourceMapResolver | null): void {\n  sourceMapResolver = resolver\n}\n\nexport interface ClassifiedSSRError {\n  error: string\n  type: SSRErrorType\n  component?: string\n  url?: string\n  browserApi?: string\n  hint: string\n  stack?: string\n  sourceLocation?: string\n  timestamp: string\n}\n\nconst BROWSER_APIS: Record<string, string> = {\n  // Global objects\n  window: 'The global window object',\n  document: 'The DOM document object',\n  navigator: 'The navigator object',\n  location: 'The location object',\n  history: 'The browser history API',\n  screen: 'The screen object',\n  localStorage: 'Browser local storage',\n  sessionStorage: 'Browser session storage',\n\n  // Viewport properties (accessed via window.X)\n  innerWidth: 'Browser viewport width',\n  innerHeight: 'Browser viewport height',\n  outerWidth: 'Browser window width',\n  outerHeight: 'Browser window height',\n  scrollX: 'Horizontal scroll position',\n  scrollY: 'Vertical scroll position',\n  devicePixelRatio: 'The device pixel ratio',\n  matchMedia: 'The matchMedia function',\n\n  // Observers (commonly instantiated at module level)\n  IntersectionObserver: 'The IntersectionObserver API',\n  ResizeObserver: 'The ResizeObserver API',\n  MutationObserver: 'The MutationObserver API',\n\n  // Timing functions (commonly called at module level)\n  requestAnimationFrame: 'The requestAnimationFrame function',\n  requestIdleCallback: 'The requestIdleCallback function',\n\n  // Constructors that might be used at module level\n  Image: 'The Image constructor',\n  Audio: 'The Audio constructor',\n  Worker: 'The Worker constructor',\n  BroadcastChannel: 'The BroadcastChannel constructor',\n\n  // Network (older Node.js versions)\n  fetch: 'The fetch API',\n  XMLHttpRequest: 'The XMLHttpRequest API',\n}\n\nfunction detectBrowserApi(error: Error): string | null {\n  const message = error.message.toLowerCase()\n\n  for (const api of Object.keys(BROWSER_APIS)) {\n    const patterns = [\n      `${api.toLowerCase()} is not defined`,\n      `'${api.toLowerCase()}' is not defined`,\n      `\"${api.toLowerCase()}\" is not defined`,\n      `cannot read properties of undefined (reading '${api.toLowerCase()}')`,\n      `cannot read property '${api.toLowerCase()}'`,\n    ]\n\n    if (patterns.some((pattern) => message.includes(pattern))) {\n      return api\n    }\n  }\n\n  return null\n}\n\nfunction isComponentResolutionError(error: Error): boolean {\n  const message = error.message.toLowerCase()\n\n  return (\n    message.includes('cannot find module') ||\n    message.includes('failed to resolve') ||\n    message.includes('module not found') ||\n    message.includes('could not resolve')\n  )\n}\n\nconst LIFECYCLE_HOOKS = 'onMounted/useEffect/onMount'\n\nfunction getBrowserApiHint(api: string): string {\n  const apiDescription = BROWSER_APIS[api] || `The \"${api}\" object`\n\n  if (['localStorage', 'sessionStorage'].includes(api)) {\n    return (\n      `${apiDescription} doesn't exist in Node.js. ` +\n      `Check \"typeof ${api} !== 'undefined'\" before using it, ` +\n      `or move the code to a ${LIFECYCLE_HOOKS} lifecycle hook.`\n    )\n  }\n\n  if (['window', 'document'].includes(api)) {\n    return (\n      `${apiDescription} doesn't exist in Node.js. ` +\n      `Wrap browser-specific code in a ${LIFECYCLE_HOOKS} lifecycle hook, ` +\n      `or check \"typeof ${api} !== 'undefined'\" before using it.`\n    )\n  }\n\n  if (['IntersectionObserver', 'ResizeObserver', 'MutationObserver'].includes(api)) {\n    return (\n      `${apiDescription} doesn't exist in Node.js. ` +\n      `Create observers inside a ${LIFECYCLE_HOOKS} lifecycle hook, not at the module level.`\n    )\n  }\n\n  if (['fetch', 'XMLHttpRequest'].includes(api)) {\n    return (\n      `${apiDescription} may not be available in all Node.js versions. ` +\n      `For SSR, ensure data fetching happens on the server (in your controller) ` +\n      `and is passed as props, or use a ${LIFECYCLE_HOOKS} hook for client-side fetching.`\n    )\n  }\n\n  return (\n    `${apiDescription} doesn't exist in Node.js. ` +\n    `Move this code to a ${LIFECYCLE_HOOKS} lifecycle hook, or guard it with ` +\n    `\"typeof ${api} !== 'undefined'\".`\n  )\n}\n\nfunction getComponentResolutionHint(component?: string): string {\n  const componentPart = component ? ` \"${component}\"` : ''\n\n  return (\n    `Could not resolve component${componentPart}. ` +\n    `Check that the file exists and the path is correct. ` +\n    `Ensure the component name matches the file name exactly (case-sensitive).`\n  )\n}\n\nfunction getRenderErrorHint(): string {\n  return (\n    'An error occurred while rendering the component. ' +\n    'Check the component for browser-specific code that runs during initialization. ' +\n    'Move any code that accesses browser APIs to a lifecycle hook.'\n  )\n}\n\nfunction extractSourceLocation(stack?: string): string | undefined {\n  if (!stack) {\n    return undefined\n  }\n\n  for (const line of stack.split('\\n')) {\n    if (!line.includes('at ')) {\n      continue\n    }\n\n    if (line.includes('node_modules') || line.includes('node:')) {\n      continue\n    }\n\n    let match = line.match(/\\(([^)]+):(\\d+):(\\d+)\\)/)\n\n    if (!match) {\n      match = line.match(/at\\s+(?:file:\\/\\/)?(.+):(\\d+):(\\d+)\\s*$/)\n    }\n\n    if (match) {\n      const file = match[1].replace(/^file:\\/\\//, '')\n      const lineNum = parseInt(match[2], 10)\n      const colNum = parseInt(match[3], 10)\n\n      if (sourceMapResolver) {\n        const resolved = sourceMapResolver(file, lineNum, colNum)\n\n        if (resolved) {\n          return `${resolved.file}:${resolved.line}:${resolved.column}`\n        }\n      }\n\n      return `${file}:${lineNum}:${colNum}`\n    }\n  }\n\n  return undefined\n}\n\nexport function classifySSRError(error: Error, component?: string, url?: string): ClassifiedSSRError {\n  const timestamp = new Date().toISOString()\n  const base = {\n    error: error.message,\n    component,\n    url,\n    stack: error.stack,\n    sourceLocation: extractSourceLocation(error.stack),\n    timestamp,\n  }\n\n  const browserApi = detectBrowserApi(error)\n\n  if (browserApi) {\n    return {\n      ...base,\n      type: 'browser-api',\n      browserApi,\n      hint: getBrowserApiHint(browserApi),\n    }\n  }\n\n  if (isComponentResolutionError(error)) {\n    return {\n      ...base,\n      type: 'component-resolution',\n      hint: getComponentResolutionHint(component),\n    }\n  }\n\n  return {\n    ...base,\n    type: 'render',\n    hint: getRenderErrorHint(),\n  }\n}\n\nconst colors = {\n  reset: '\\x1b[0m',\n  red: '\\x1b[31m',\n  yellow: '\\x1b[33m',\n  cyan: '\\x1b[36m',\n  dim: '\\x1b[2m',\n  bold: '\\x1b[1m',\n  bgRed: '\\x1b[41m',\n  white: '\\x1b[37m',\n}\n\nfunction makeRelative(path: string, root?: string): string {\n  const base = root ?? process.cwd()\n\n  if (path.startsWith(base + '/')) {\n    return path.slice(base.length + 1)\n  }\n\n  return path\n}\n\nexport function formatConsoleError(\n  classified: ClassifiedSSRError,\n  root?: string,\n  handleErrors: boolean = true,\n  suppressedWarnings: string[] = [],\n): string {\n  if (!handleErrors) {\n    const component = classified.component ? `[${classified.component}]` : ''\n    return `SSR Error ${component}: ${classified.error}`\n  }\n\n  const componentPart = classified.component ? `  ${colors.cyan}${classified.component}${colors.reset}` : ''\n\n  const lines = [\n    '',\n    `  ${colors.bgRed}${colors.white}${colors.bold} SSR ERROR ${colors.reset}${componentPart}`,\n    '',\n    `  ${classified.error}`,\n  ]\n\n  if (classified.sourceLocation) {\n    const relativePath = makeRelative(classified.sourceLocation, root)\n    lines.push(`  ${colors.dim}Source: ${relativePath}${colors.reset}`)\n  }\n\n  if (classified.url) {\n    lines.push(`  ${colors.dim}URL: ${classified.url}${colors.reset}`)\n  }\n\n  lines.push('', `  ${colors.yellow}Hint${colors.reset}  ${classified.hint}`, '')\n\n  if (classified.stack) {\n    lines.push(`  ${colors.dim}${classified.stack.split('\\n').join('\\n  ')}${colors.reset}`, '')\n  }\n\n  if (suppressedWarnings.length > 0) {\n    lines.push(`  ${colors.dim}Suppressed ${suppressedWarnings.length} framework warning(s).${colors.reset}`, '')\n  }\n\n  return lines.join('\\n')\n}\n"],
+  "mappings": "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",
+  "names": ["process", "path"]
 }

package/dist/ssrErrors.js

@@ -0,0 +1,197 @@
+// src/ssrErrors.ts
+var sourceMapResolver = null;
+function setSourceMapResolver(resolver) {
+  sourceMapResolver = resolver;
+}
+var BROWSER_APIS = {
+  // Global objects
+  window: "The global window object",
+  document: "The DOM document object",
+  navigator: "The navigator object",
+  location: "The location object",
+  history: "The browser history API",
+  screen: "The screen object",
+  localStorage: "Browser local storage",
+  sessionStorage: "Browser session storage",
+  // Viewport properties (accessed via window.X)
+  innerWidth: "Browser viewport width",
+  innerHeight: "Browser viewport height",
+  outerWidth: "Browser window width",
+  outerHeight: "Browser window height",
+  scrollX: "Horizontal scroll position",
+  scrollY: "Vertical scroll position",
+  devicePixelRatio: "The device pixel ratio",
+  matchMedia: "The matchMedia function",
+  // Observers (commonly instantiated at module level)
+  IntersectionObserver: "The IntersectionObserver API",
+  ResizeObserver: "The ResizeObserver API",
+  MutationObserver: "The MutationObserver API",
+  // Timing functions (commonly called at module level)
+  requestAnimationFrame: "The requestAnimationFrame function",
+  requestIdleCallback: "The requestIdleCallback function",
+  // Constructors that might be used at module level
+  Image: "The Image constructor",
+  Audio: "The Audio constructor",
+  Worker: "The Worker constructor",
+  BroadcastChannel: "The BroadcastChannel constructor",
+  // Network (older Node.js versions)
+  fetch: "The fetch API",
+  XMLHttpRequest: "The XMLHttpRequest API"
+};
+function detectBrowserApi(error) {
+  const message = error.message.toLowerCase();
+  for (const api of Object.keys(BROWSER_APIS)) {
+    const patterns = [
+      `${api.toLowerCase()} is not defined`,
+      `'${api.toLowerCase()}' is not defined`,
+      `"${api.toLowerCase()}" is not defined`,
+      `cannot read properties of undefined (reading '${api.toLowerCase()}')`,
+      `cannot read property '${api.toLowerCase()}'`
+    ];
+    if (patterns.some((pattern) => message.includes(pattern))) {
+      return api;
+    }
+  }
+  return null;
+}
+function isComponentResolutionError(error) {
+  const message = error.message.toLowerCase();
+  return message.includes("cannot find module") || message.includes("failed to resolve") || message.includes("module not found") || message.includes("could not resolve");
+}
+var LIFECYCLE_HOOKS = "onMounted/useEffect/onMount";
+function getBrowserApiHint(api) {
+  const apiDescription = BROWSER_APIS[api] || `The "${api}" object`;
+  if (["localStorage", "sessionStorage"].includes(api)) {
+    return `${apiDescription} doesn't exist in Node.js. Check "typeof ${api} !== 'undefined'" before using it, or move the code to a ${LIFECYCLE_HOOKS} lifecycle hook.`;
+  }
+  if (["window", "document"].includes(api)) {
+    return `${apiDescription} doesn't exist in Node.js. Wrap browser-specific code in a ${LIFECYCLE_HOOKS} lifecycle hook, or check "typeof ${api} !== 'undefined'" before using it.`;
+  }
+  if (["IntersectionObserver", "ResizeObserver", "MutationObserver"].includes(api)) {
+    return `${apiDescription} doesn't exist in Node.js. Create observers inside a ${LIFECYCLE_HOOKS} lifecycle hook, not at the module level.`;
+  }
+  if (["fetch", "XMLHttpRequest"].includes(api)) {
+    return `${apiDescription} may not be available in all Node.js versions. For SSR, ensure data fetching happens on the server (in your controller) and is passed as props, or use a ${LIFECYCLE_HOOKS} hook for client-side fetching.`;
+  }
+  return `${apiDescription} doesn't exist in Node.js. Move this code to a ${LIFECYCLE_HOOKS} lifecycle hook, or guard it with "typeof ${api} !== 'undefined'".`;
+}
+function getComponentResolutionHint(component) {
+  const componentPart = component ? ` "${component}"` : "";
+  return `Could not resolve component${componentPart}. Check that the file exists and the path is correct. Ensure the component name matches the file name exactly (case-sensitive).`;
+}
+function getRenderErrorHint() {
+  return "An error occurred while rendering the component. Check the component for browser-specific code that runs during initialization. Move any code that accesses browser APIs to a lifecycle hook.";
+}
+function extractSourceLocation(stack) {
+  if (!stack) {
+    return void 0;
+  }
+  for (const line of stack.split("\n")) {
+    if (!line.includes("at ")) {
+      continue;
+    }
+    if (line.includes("node_modules") || line.includes("node:")) {
+      continue;
+    }
+    let match = line.match(/\(([^)]+):(\d+):(\d+)\)/);
+    if (!match) {
+      match = line.match(/at\s+(?:file:\/\/)?(.+):(\d+):(\d+)\s*$/);
+    }
+    if (match) {
+      const file = match[1].replace(/^file:\/\//, "");
+      const lineNum = parseInt(match[2], 10);
+      const colNum = parseInt(match[3], 10);
+      if (sourceMapResolver) {
+        const resolved = sourceMapResolver(file, lineNum, colNum);
+        if (resolved) {
+          return `${resolved.file}:${resolved.line}:${resolved.column}`;
+        }
+      }
+      return `${file}:${lineNum}:${colNum}`;
+    }
+  }
+  return void 0;
+}
+function classifySSRError(error, component, url) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const base = {
+    error: error.message,
+    component,
+    url,
+    stack: error.stack,
+    sourceLocation: extractSourceLocation(error.stack),
+    timestamp
+  };
+  const browserApi = detectBrowserApi(error);
+  if (browserApi) {
+    return {
+      ...base,
+      type: "browser-api",
+      browserApi,
+      hint: getBrowserApiHint(browserApi)
+    };
+  }
+  if (isComponentResolutionError(error)) {
+    return {
+      ...base,
+      type: "component-resolution",
+      hint: getComponentResolutionHint(component)
+    };
+  }
+  return {
+    ...base,
+    type: "render",
+    hint: getRenderErrorHint()
+  };
+}
+var colors = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  yellow: "\x1B[33m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m",
+  bold: "\x1B[1m",
+  bgRed: "\x1B[41m",
+  white: "\x1B[37m"
+};
+function makeRelative(path, root) {
+  const base = root ?? process.cwd();
+  if (path.startsWith(base + "/")) {
+    return path.slice(base.length + 1);
+  }
+  return path;
+}
+function formatConsoleError(classified, root, handleErrors = true, suppressedWarnings = []) {
+  if (!handleErrors) {
+    const component = classified.component ? `[${classified.component}]` : "";
+    return `SSR Error ${component}: ${classified.error}`;
+  }
+  const componentPart = classified.component ? `  ${colors.cyan}${classified.component}${colors.reset}` : "";
+  const lines = [
+    "",
+    `  ${colors.bgRed}${colors.white}${colors.bold} SSR ERROR ${colors.reset}${componentPart}`,
+    "",
+    `  ${classified.error}`
+  ];
+  if (classified.sourceLocation) {
+    const relativePath = makeRelative(classified.sourceLocation, root);
+    lines.push(`  ${colors.dim}Source: ${relativePath}${colors.reset}`);
+  }
+  if (classified.url) {
+    lines.push(`  ${colors.dim}URL: ${classified.url}${colors.reset}`);
+  }
+  lines.push("", `  ${colors.yellow}Hint${colors.reset}  ${classified.hint}`, "");
+  if (classified.stack) {
+    lines.push(`  ${colors.dim}${classified.stack.split("\n").join("\n  ")}${colors.reset}`, "");
+  }
+  if (suppressedWarnings.length > 0) {
+    lines.push(`  ${colors.dim}Suppressed ${suppressedWarnings.length} framework warning(s).${colors.reset}`, "");
+  }
+  return lines.join("\n");
+}
+export {
+  classifySSRError,
+  formatConsoleError,
+  setSourceMapResolver
+};
+//# sourceMappingURL=ssrErrors.js.map