rasengan 1.2.1 → 1.2.2

package/lib/esm/server/dev/handlers.js

@@ -4,6 +4,7 @@ import { logRedirection as log } from '../../core/utils/log.js';
 import createRasenganRequest, { createRasenganHeaders, sendRasenganResponse, } from '../node/utils.js';
 import { join } from 'path';
 import { isStaticRedirectFromConfig, isRedirectResponse, extractMetaFromRRContext, extractHeadersFromRRContext, } from './utils.js';
+import { renderErrorPage } from '../../entries/server/error-template.js';
 import { renderToString } from '../node/rendering.js';
 import { TemplateLayout } from '../../entries/server/index.js';
 /**
@@ -73,21 +74,24 @@ export async function handleDocumentRequest(req, res, runner, options) {
             //     ...Object.fromEntries(headers),
             //   });
             // }
-            // Set headers
-            res.writeHead(context.statusCode, {
-                ...Object.fromEntries(headers),
-            });
             const Router = (_jsx(StaticRouterProvider, { router: router, context: context, hydrate: true }));
             // If stream mode enabled, render the page as a plain text
             return await render(Router, res, {
                 metadata,
+                statusCode: context.statusCode,
+                responseHeaders: Object.fromEntries(headers),
             });
         }
         return context;
     }
     catch (error) {
-        // Just log the error for now
         console.error(error);
+        if (!res.headersSent) {
+            const html = renderErrorPage(error);
+            res.status(500);
+            res.setHeader('Content-Type', 'text/html');
+            return res.send(html);
+        }
     }
 }
 export async function handleDataRequest(request, handler) {

package/lib/esm/server/dev/server.js

@@ -12,6 +12,7 @@ import { ServerMode } from '../runtime/mode.js';
 import { handleDataRequest, handleDocumentRequest, handleSpaModeRequest, } from './handlers.js';
 import { createStaticHandler } from 'react-router';
 import { generateRoutes, preloadMatches, } from '../../routing/utils/generate-routes.js';
+import { renderErrorPage } from '../../entries/server/error-template.js';
 /**
  * Handle the request for the development environment
  * @param req
@@ -66,8 +67,13 @@ async function devRequestHandler(req, res, viteDevServer, options) {
         return res.status(404).send('Not found');
     }
     catch (error) {
-        // Just log the error for now
         console.error(error);
+        if (res.headersSent)
+            return;
+        const html = renderErrorPage(error);
+        res.status(500);
+        res.setHeader('Content-Type', 'text/html');
+        return res.send(html);
     }
 }
 /**
@@ -133,6 +139,7 @@ async function createDevNodeServer({ port, base = '/', enableSearchingPort = fal
             hmr: {
                 // TODO: Find a way to use a random port
                 port: generateRandomPort(),
+                overlay: false,
             },
         },
         base,

package/lib/esm/server/node/index.js

@@ -70,16 +70,14 @@ export function createRequestHandler(options) {
                 // Create static router
                 let router = createStaticRouter(handler.dataRoutes, context);
                 const headers = extractHeadersFromRRContext(context);
-                // Set headers
-                res.writeHead(context.statusCode, {
-                    ...Object.fromEntries(headers),
-                });
                 const Router = (_jsx(StaticRouterProvider, { router: router, context: context }));
                 // If stream mode enabled, render the page as a plain text
                 return await render(Router, res, {
                     metadata,
                     assets,
                     buildOptions,
+                    statusCode: context.statusCode,
+                    responseHeaders: Object.fromEntries(headers),
                 });
             }
             return context;

package/lib/esm/server/node/rendering.js

@@ -5,9 +5,10 @@ import { isServerMode, ServerMode } from '../runtime/mode.js';
  * Render a React component to a stream.
  * @param Component
  * @param res
+ * @param options
  * @returns
  */
-export const renderToStream = async (Component, res) => {
+export const renderToStream = async (Component, res, options) => {
     const ABORT_DELAY = 10_000;
     let bootstrap = [];
     if (isServerMode(process.env.NODE_ENV) &&
@@ -20,6 +21,9 @@ export const renderToStream = async (Component, res) => {
             bootstrapModules: bootstrap,
             onShellReady() {
                 shellRendered = true;
+                if (!res.headersSent && options?.responseHeaders) {
+                    res.writeHead(options.statusCode ?? 200, options.responseHeaders);
+                }
                 resolve(res);
                 pipe(res);
             },
@@ -27,11 +31,9 @@ export const renderToStream = async (Component, res) => {
                 reject(error);
             },
             onError(error) {
-                // Log streaming rendering errors from inside the shell.  Don't log
-                // errors encountered during initial shell rendering since they'll
-                // reject and get logged in handleDocumentRequest.
                 if (shellRendered) {
                     console.error(error);
+                    abort();
                 }
             },
         });

package/lib/tsconfig.esm.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/client.ts","../src/index.ts","../src/plugin.ts","../src/server.ts","../src/cli/index.ts","../src/core/index.ts","../src/core/types.ts","../src/core/config/index.ts","../src/core/config/type.ts","../src/core/config/utils/define-config.ts","../src/core/config/utils/load-modules.ts","../src/core/config/utils/path.ts","../src/core/config/vite/defaults.ts","../src/core/dynamic/index.tsx","../src/core/middlewares/index.ts","../src/core/middlewares/logger.ts","../src/core/plugins/index.ts","../src/core/utils/log.ts","../src/entries/client/render.tsx","../src/entries/server/entry.server.tsx","../src/entries/server/index.tsx","../src/routing/index.ts","../src/routing/interfaces.tsx","../src/routing/types.ts","../src/routing/components/fallback.tsx","../src/routing/components/index.tsx","../src/routing/components/template.tsx","../src/routing/providers/metadata.tsx","../src/routing/utils/define-router.tsx","../src/routing/utils/define-routes-group.tsx","../src/routing/utils/define-static-paths.tsx","../src/routing/utils/flat-routes.tsx","../src/routing/utils/generate-metadata.tsx","../src/routing/utils/generate-routes.tsx","../src/routing/utils/index.tsx","../src/scripts/build-command.js","../src/scripts/generate-package-json.js","../src/scripts/utils/check-os.js","../src/scripts/utils/copy.js","../src/server/build/index.ts","../src/server/build/manifest.tsx","../src/server/build/rendering.tsx","../src/server/dev/handlers.tsx","../src/server/dev/server.ts","../src/server/dev/utils.ts","../src/server/node/index.tsx","../src/server/node/rendering.ts","../src/server/node/stream.ts","../src/server/node/utils.ts","../src/server/runtime/detect-runtime.ts","../src/server/runtime/mode.ts","../src/server/runtime/utils.ts","../src/server/virtual/index.ts","../types/client.d.ts"],"version":"5.9.3"}
+{"root":["../src/client.ts","../src/index.ts","../src/plugin.ts","../src/server.ts","../src/cli/index.ts","../src/core/index.ts","../src/core/types.ts","../src/core/config/index.ts","../src/core/config/type.ts","../src/core/config/utils/define-config.ts","../src/core/config/utils/load-modules.ts","../src/core/config/utils/path.ts","../src/core/config/vite/defaults.ts","../src/core/dynamic/index.tsx","../src/core/middlewares/index.ts","../src/core/middlewares/logger.ts","../src/core/plugins/index.ts","../src/core/utils/log.ts","../src/entries/client/render.tsx","../src/entries/server/entry.server.tsx","../src/entries/server/error-template.tsx","../src/entries/server/index.tsx","../src/routing/index.ts","../src/routing/interfaces.tsx","../src/routing/types.ts","../src/routing/components/fallback.tsx","../src/routing/components/index.tsx","../src/routing/components/template.tsx","../src/routing/error-overlay/ErrorBoundaryFallback.tsx","../src/routing/error-overlay/ErrorOverlay.tsx","../src/routing/error-overlay/ErrorOverlayProvider.tsx","../src/routing/error-overlay/error-store.ts","../src/routing/error-overlay/index.ts","../src/routing/error-overlay/stack-utils.ts","../src/routing/providers/metadata.tsx","../src/routing/utils/define-router.tsx","../src/routing/utils/define-routes-group.tsx","../src/routing/utils/define-static-paths.tsx","../src/routing/utils/flat-routes.tsx","../src/routing/utils/generate-metadata.tsx","../src/routing/utils/generate-routes.tsx","../src/routing/utils/index.tsx","../src/scripts/build-command.js","../src/scripts/generate-package-json.js","../src/scripts/utils/check-os.js","../src/scripts/utils/copy.js","../src/server/build/index.ts","../src/server/build/manifest.tsx","../src/server/build/rendering.tsx","../src/server/dev/handlers.tsx","../src/server/dev/server.ts","../src/server/dev/utils.ts","../src/server/node/index.tsx","../src/server/node/rendering.ts","../src/server/node/stream.ts","../src/server/node/utils.ts","../src/server/runtime/detect-runtime.ts","../src/server/runtime/mode.ts","../src/server/runtime/utils.ts","../src/server/virtual/index.ts","../types/client.d.ts"],"version":"5.9.3"}

package/lib/tsconfig.types.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/client.ts","../src/index.ts","../src/plugin.ts","../src/server.ts","../src/cli/index.ts","../src/core/index.ts","../src/core/types.ts","../src/core/config/index.ts","../src/core/config/type.ts","../src/core/config/utils/define-config.ts","../src/core/config/utils/load-modules.ts","../src/core/config/utils/path.ts","../src/core/config/vite/defaults.ts","../src/core/dynamic/index.tsx","../src/core/middlewares/index.ts","../src/core/middlewares/logger.ts","../src/core/plugins/index.ts","../src/core/utils/log.ts","../src/entries/client/render.tsx","../src/entries/server/entry.server.tsx","../src/entries/server/index.tsx","../src/routing/index.ts","../src/routing/interfaces.tsx","../src/routing/types.ts","../src/routing/components/fallback.tsx","../src/routing/components/index.tsx","../src/routing/components/template.tsx","../src/routing/providers/metadata.tsx","../src/routing/utils/define-router.tsx","../src/routing/utils/define-routes-group.tsx","../src/routing/utils/define-static-paths.tsx","../src/routing/utils/flat-routes.tsx","../src/routing/utils/generate-metadata.tsx","../src/routing/utils/generate-routes.tsx","../src/routing/utils/index.tsx","../src/scripts/build-command.js","../src/scripts/generate-package-json.js","../src/scripts/utils/check-os.js","../src/scripts/utils/copy.js","../src/server/build/index.ts","../src/server/build/manifest.tsx","../src/server/build/rendering.tsx","../src/server/dev/handlers.tsx","../src/server/dev/server.ts","../src/server/dev/utils.ts","../src/server/node/index.tsx","../src/server/node/rendering.ts","../src/server/node/stream.ts","../src/server/node/utils.ts","../src/server/runtime/detect-runtime.ts","../src/server/runtime/mode.ts","../src/server/runtime/utils.ts","../src/server/virtual/index.ts","../types/client.d.ts"],"version":"5.9.3"}
+{"root":["../src/client.ts","../src/index.ts","../src/plugin.ts","../src/server.ts","../src/cli/index.ts","../src/core/index.ts","../src/core/types.ts","../src/core/config/index.ts","../src/core/config/type.ts","../src/core/config/utils/define-config.ts","../src/core/config/utils/load-modules.ts","../src/core/config/utils/path.ts","../src/core/config/vite/defaults.ts","../src/core/dynamic/index.tsx","../src/core/middlewares/index.ts","../src/core/middlewares/logger.ts","../src/core/plugins/index.ts","../src/core/utils/log.ts","../src/entries/client/render.tsx","../src/entries/server/entry.server.tsx","../src/entries/server/error-template.tsx","../src/entries/server/index.tsx","../src/routing/index.ts","../src/routing/interfaces.tsx","../src/routing/types.ts","../src/routing/components/fallback.tsx","../src/routing/components/index.tsx","../src/routing/components/template.tsx","../src/routing/error-overlay/ErrorBoundaryFallback.tsx","../src/routing/error-overlay/ErrorOverlay.tsx","../src/routing/error-overlay/ErrorOverlayProvider.tsx","../src/routing/error-overlay/error-store.ts","../src/routing/error-overlay/index.ts","../src/routing/error-overlay/stack-utils.ts","../src/routing/providers/metadata.tsx","../src/routing/utils/define-router.tsx","../src/routing/utils/define-routes-group.tsx","../src/routing/utils/define-static-paths.tsx","../src/routing/utils/flat-routes.tsx","../src/routing/utils/generate-metadata.tsx","../src/routing/utils/generate-routes.tsx","../src/routing/utils/index.tsx","../src/scripts/build-command.js","../src/scripts/generate-package-json.js","../src/scripts/utils/check-os.js","../src/scripts/utils/copy.js","../src/server/build/index.ts","../src/server/build/manifest.tsx","../src/server/build/rendering.tsx","../src/server/dev/handlers.tsx","../src/server/dev/server.ts","../src/server/dev/utils.ts","../src/server/node/index.tsx","../src/server/node/rendering.ts","../src/server/node/stream.ts","../src/server/node/utils.ts","../src/server/runtime/detect-runtime.ts","../src/server/runtime/mode.ts","../src/server/runtime/utils.ts","../src/server/virtual/index.ts","../types/client.d.ts"],"version":"5.9.3"}

package/lib/types/entries/server/entry.server.d.ts

@@ -9,6 +9,8 @@ export type RenderStreamFunction = (StaticRouterComponent: React.ReactNode, res:
     };
     assets?: JSX.Element[];
     buildOptions?: BuildOptions;
+    statusCode?: number;
+    responseHeaders?: Record<string, string>;
 }, stream?: boolean) => Promise<void | string>;
 /**
  * Render the app to a stream

package/lib/types/entries/server/error-template.d.ts

@@ -0,0 +1 @@
+export declare function renderErrorPage(error: unknown): string;

package/lib/types/routing/error-overlay/ErrorBoundaryFallback.d.ts

@@ -0,0 +1,14 @@
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+interface Props {
+    children: ReactNode;
+}
+interface State {
+    hasError: boolean;
+}
+export declare class ErrorBoundaryFallback extends Component<Props, State> {
+    constructor(props: Props);
+    static getDerivedStateFromError(): State;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};

package/lib/types/routing/error-overlay/ErrorOverlay.d.ts

@@ -0,0 +1,2 @@
+import './error-overlay.css';
+export declare function ErrorOverlay(): import("react").ReactPortal;

package/lib/types/routing/error-overlay/ErrorOverlayProvider.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from 'react';
+interface Props {
+    children: ReactNode;
+    devMode: boolean;
+}
+export declare function ErrorOverlayProvider({ children, devMode }: Props): import("react/jsx-runtime.js").JSX.Element;
+export {};

package/lib/types/routing/error-overlay/error-store.d.ts

@@ -0,0 +1,24 @@
+type ErrorSource = 'route' | 'react' | 'vite' | 'global';
+type ErrorEntry = {
+    id: number;
+    error: Error;
+    source: ErrorSource;
+    timestamp: number;
+    componentStack?: string;
+};
+type Listener = () => void;
+declare class ErrorStore {
+    private errors;
+    private listeners;
+    private nextId;
+    private minimized;
+    addError(error: Error, source?: ErrorSource, componentStack?: string): void;
+    clearAll(): void;
+    toggleMinimize(): void;
+    getErrors(): ErrorEntry[];
+    isMinimized(): boolean;
+    subscribe(listener: Listener): () => void;
+    private notify;
+}
+export declare const errorStore: ErrorStore;
+export type { ErrorEntry, ErrorSource };

package/lib/types/routing/error-overlay/index.d.ts

@@ -0,0 +1,3 @@
+export { ErrorOverlayProvider } from './ErrorOverlayProvider.js';
+export { errorStore } from './error-store.js';
+export type { ErrorEntry, ErrorSource } from './error-store.js';

package/lib/types/routing/error-overlay/stack-utils.d.ts

@@ -0,0 +1,31 @@
+type StackFrame = {
+    file: string;
+    line: number;
+    column: number;
+};
+/**
+ * Parse an error stack trace and extract the first meaningful user frame.
+ * Handles Chrome/V8 and Firefox stack trace formats.
+ * Skips the "Error:" header line.
+ *
+ * @param stack - The full error.stack string
+ * @returns The first parsed StackFrame, or null if none found
+ */
+export declare function parseStackFrame(stack: string): StackFrame | null;
+/**
+ * Fetch the source file from the Vite dev server (using ?raw to get original
+ * source) and return a snippet of lines surrounding the error line.
+ *
+ * @param file         - File path (absolute, e.g. /src/app/page.tsx)
+ * @param errorLine    - 1-indexed line number where the error occurred
+ * @param contextLines - Number of lines to show above and below the error
+ * @returns An object with the snippet string, the 0-indexed error line
+ *          position within the snippet, and the total file line count,
+ *          or null on failure
+ */
+export declare function fetchSourceSnippet(file: string, errorLine: number, contextLines?: number): Promise<{
+    snippet: string;
+    errorLineIndex: number;
+    totalLines: number;
+} | null>;
+export {};

package/lib/types/server/node/rendering.d.ts

@@ -1,9 +1,15 @@
 import type * as Express from 'express';
+type StreamOptions = {
+    statusCode?: number;
+    responseHeaders?: Record<string, string>;
+};
 /**
  * Render a React component to a stream.
  * @param Component
  * @param res
+ * @param options
  * @returns
  */
-export declare const renderToStream: (Component: React.ReactNode, res: Express.Response) => Promise<unknown>;
+export declare const renderToStream: (Component: React.ReactNode, res: Express.Response, options?: StreamOptions) => Promise<unknown>;
 export declare const renderToString: (Component: React.ReactNode) => string;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rasengan",
   "private": false,
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "The modern React Framework",
   "type": "module",
   "main": "lib/esm/index.js",
@@ -59,6 +59,15 @@
     "issues": "https://github.com/rasengan-dev/rasenganjs/issues"
   },
   "homepage": "https://rasengan.dev",
+  "scripts": {
+    "build:compile": "tsc -b ./tsconfig.esm.json ./tsconfig.types.json",
+    "build:clean": "rimraf ./lib",
+    "build:copy-assets": "mkdir -p lib/esm/routing/error-overlay && cp src/routing/error-overlay/error-overlay.css lib/esm/routing/error-overlay/",
+    "build": "pnpm run build:clean & pnpm run build:compile && pnpm run build:copy-assets",
+    "deploy": "pnpm publish --access public",
+    "deploy:beta": "pnpm run deploy --tag beta",
+    "pack": "pnpm pack --pack-destination ./release/"
+  },
   "dependencies": {
     "@vitejs/plugin-react": "^5.0.0",
     "chalk": "^5.3.0",
@@ -131,13 +140,5 @@
     "ssr",
     "ssg",
     "spa"
-  ],
-  "scripts": {
-    "build:compile": "tsc -b ./tsconfig.esm.json ./tsconfig.types.json",
-    "build:clean": "rimraf ./lib",
-    "build": "pnpm run build:clean & pnpm run build:compile",
-    "deploy": "pnpm publish --access public",
-    "deploy:beta": "pnpm run deploy --tag beta",
-    "pack": "pnpm pack --pack-destination ./release/"
-  }
-}
+  ]
+}

package/types/client.d.ts

@@ -50,4 +50,5 @@ declare module 'virtual:rasengan/router' {
 interface Window {
   __staticRouterHydrationData: any;
   __RASENGAN_SPA_MODE__: boolean;
+  __RASENGAN_SSR_ERROR__?: { message: string; stack?: string; name: string };
 }