@rangojs/router 0.0.0-experimental.0b82333f

package/dist/server/request-context.js

@@ -0,0 +1,290 @@
+/**
+ * Request Context - AsyncLocalStorage for passing request-scoped data throughout rendering
+ *
+ * This is the unified context used everywhere:
+ * - Middleware execution
+ * - Route handlers and loaders
+ * - Server components during rendering
+ * - Error boundaries and streaming
+ *
+ * Available via getRequestContext() anywhere in the request lifecycle.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createHandleStore } from "./handle-store.js";
+import { isHandle } from "../handle.js";
+import { track } from "./context.js";
+import { getFetchableLoader } from "./fetchable-loader-store.js";
+import { THEME_COOKIE } from "../theme/constants.js";
+// AsyncLocalStorage instance for request context
+const requestContextStorage = new AsyncLocalStorage();
+/**
+ * Run a function within a request context
+ * Used by the RSC handler to provide context to server actions
+ */
+export function runWithRequestContext(context, fn) {
+    return requestContextStorage.run(context, fn);
+}
+/**
+ * Get the current request context
+ * Returns undefined if not running within a request context
+ */
+export function getRequestContext() {
+    return requestContextStorage.getStore();
+}
+/**
+ * Update params on the current request context
+ * Called after route matching to populate route params
+ */
+export function setRequestContextParams(params) {
+    const ctx = requestContextStorage.getStore();
+    if (ctx) {
+        ctx.params = params;
+    }
+}
+/**
+ * Get the current request context, throwing if not available
+ * Use this when context is required (e.g., in loader actions)
+ */
+export function requireRequestContext() {
+    const ctx = getRequestContext();
+    if (!ctx) {
+        throw new Error("Request context not available. This function must be called from within a server action " +
+            "executed through the RSC handler.");
+    }
+    return ctx;
+}
+/**
+ * Create a full request context with all methods implemented
+ *
+ * This is used by the RSC handler to create the unified context that's:
+ * - Available via getRequestContext() throughout the request
+ * - Passed to middleware as ctx
+ * - Passed to handlers as ctx
+ */
+export function createRequestContext(options) {
+    const { env, request, url, variables, cacheStore, executionContext, themeConfig } = options;
+    const cookieHeader = request.headers.get("Cookie");
+    let parsedCookies = null;
+    // Create stub response for collecting headers/cookies
+    const stubResponse = new Response(null, { status: 200 });
+    // Create handle store and loader memoization for this request
+    const handleStore = createHandleStore();
+    const loaderPromises = new Map();
+    // Lazy parse cookies
+    const getParsedCookies = () => {
+        if (!parsedCookies) {
+            parsedCookies = parseCookiesFromHeader(cookieHeader);
+        }
+        return parsedCookies;
+    };
+    // Theme helpers (only used when themeConfig is provided)
+    const getTheme = () => {
+        if (!themeConfig)
+            return undefined;
+        const stored = getParsedCookies()[themeConfig.storageKey];
+        if (stored) {
+            // Validate stored value
+            if (stored === "system" && themeConfig.enableSystem) {
+                return "system";
+            }
+            if (themeConfig.themes.includes(stored)) {
+                return stored;
+            }
+        }
+        return themeConfig.defaultTheme;
+    };
+    const setTheme = (theme) => {
+        if (!themeConfig)
+            return;
+        // Validate theme value
+        if (theme !== "system" && !themeConfig.themes.includes(theme)) {
+            console.warn(`[Theme] Invalid theme value: "${theme}". Valid values: system, ${themeConfig.themes.join(", ")}`);
+            return;
+        }
+        // Set cookie
+        stubResponse.headers.append("Set-Cookie", serializeCookieValue(themeConfig.storageKey, theme, {
+            path: THEME_COOKIE.path,
+            maxAge: THEME_COOKIE.maxAge,
+            sameSite: THEME_COOKIE.sameSite,
+        }));
+    };
+    // Build the context object first (without use), then add use
+    const ctx = {
+        env,
+        request,
+        url,
+        pathname: url.pathname,
+        searchParams: url.searchParams,
+        var: variables,
+        get: (key) => variables[key],
+        set: (key, value) => {
+            variables[key] = value;
+        },
+        params: {},
+        res: stubResponse,
+        cookie(name) {
+            return getParsedCookies()[name];
+        },
+        cookies() {
+            return { ...getParsedCookies() };
+        },
+        setCookie(name, value, options) {
+            stubResponse.headers.append("Set-Cookie", serializeCookieValue(name, value, options));
+        },
+        deleteCookie(name, options) {
+            stubResponse.headers.append("Set-Cookie", serializeCookieValue(name, "", { ...options, maxAge: 0 }));
+        },
+        header(name, value) {
+            stubResponse.headers.set(name, value);
+        },
+        // Placeholder - will be replaced below
+        use: null,
+        method: request.method,
+        _handleStore: handleStore,
+        _cacheStore: cacheStore,
+        waitUntil(fn) {
+            if (executionContext?.waitUntil) {
+                // Cloudflare Workers: use native waitUntil
+                executionContext.waitUntil(fn());
+            }
+            else {
+                // Node.js / dev: fire-and-forget with error logging
+                fn().catch((err) => console.error("[waitUntil] Background task failed:", err));
+            }
+        },
+        _onResponseCallbacks: [],
+        onResponse(callback) {
+            this._onResponseCallbacks.push(callback);
+        },
+        // Theme properties (only set when themeConfig is provided)
+        theme: themeConfig ? getTheme() : undefined,
+        setTheme: themeConfig ? setTheme : undefined,
+        _themeConfig: themeConfig,
+    };
+    // Now create use() with access to ctx
+    ctx.use = createUseFunction({
+        handleStore,
+        loaderPromises,
+        getContext: () => ctx,
+    });
+    return ctx;
+}
+/**
+ * Parse cookies from Cookie header
+ */
+function parseCookiesFromHeader(cookieHeader) {
+    if (!cookieHeader)
+        return {};
+    const cookies = {};
+    const pairs = cookieHeader.split(";");
+    for (const pair of pairs) {
+        const [name, ...rest] = pair.trim().split("=");
+        if (name) {
+            const raw = rest.join("=");
+            try {
+                cookies[name] = decodeURIComponent(raw);
+            }
+            catch {
+                // Malformed percent-encoded value (e.g. %zz, %2) - fall back to raw value
+                cookies[name] = raw;
+            }
+        }
+    }
+    return cookies;
+}
+/**
+ * Serialize a cookie for Set-Cookie header
+ */
+function serializeCookieValue(name, value, options = {}) {
+    let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
+    if (options.domain)
+        cookie += `; Domain=${options.domain}`;
+    if (options.path)
+        cookie += `; Path=${options.path}`;
+    if (options.maxAge !== undefined)
+        cookie += `; Max-Age=${options.maxAge}`;
+    if (options.expires)
+        cookie += `; Expires=${options.expires.toUTCString()}`;
+    if (options.httpOnly)
+        cookie += "; HttpOnly";
+    if (options.secure)
+        cookie += "; Secure";
+    if (options.sameSite)
+        cookie += `; SameSite=${options.sameSite}`;
+    return cookie;
+}
+/**
+ * Create the use() function for loader and handle composition.
+ *
+ * This is the unified implementation used by both RequestContext and HandlerContext.
+ * - For loaders: executes and memoizes loader functions
+ * - For handles: returns a push function to add handle data
+ */
+export function createUseFunction(options) {
+    const { handleStore, loaderPromises, getContext } = options;
+    return ((item) => {
+        // Handle case: return a push function
+        if (isHandle(item)) {
+            const handle = item;
+            const ctx = getContext();
+            const segmentId = ctx._currentSegmentId;
+            if (!segmentId) {
+                throw new Error(`Handle "${handle.$$id}" used outside of handler context. ` +
+                    `Handles must be used within route/layout handlers.`);
+            }
+            // Return a push function bound to this handle and segment
+            return (dataOrFn) => {
+                // If it's a function, call it immediately to get the promise
+                const valueOrPromise = typeof dataOrFn === "function"
+                    ? dataOrFn()
+                    : dataOrFn;
+                // Push directly - promises will be serialized by RSC and streamed
+                handleStore.push(handle.$$id, segmentId, valueOrPromise);
+            };
+        }
+        // Loader case
+        const loader = item;
+        // Return cached promise if already started
+        if (loaderPromises.has(loader.$$id)) {
+            return loaderPromises.get(loader.$$id);
+        }
+        // Get loader function - either from loader object or fetchable registry
+        let loaderFn = loader.fn;
+        if (!loaderFn) {
+            const fetchable = getFetchableLoader(loader.$$id);
+            if (fetchable) {
+                loaderFn = fetchable.fn;
+            }
+        }
+        if (!loaderFn) {
+            throw new Error(`Loader "${loader.$$id}" has no function. This usually means the loader was defined without "use server" and the function was not included in the build.`);
+        }
+        const ctx = getContext();
+        // Create loader context with recursive use() support
+        const loaderCtx = {
+            params: ctx.params,
+            request: ctx.request,
+            searchParams: ctx.searchParams,
+            pathname: ctx.pathname,
+            url: ctx.url,
+            env: ctx.env,
+            var: ctx.var,
+            get: ctx.get,
+            use: (dep) => {
+                // Recursive call - will start dep loader if not already started
+                return ctx.use(dep);
+            },
+            method: "GET",
+            body: undefined,
+        };
+        // Start loader execution with tracking
+        const doneLoader = track(`loader:${loader.$$id}`);
+        const promise = Promise.resolve(loaderFn(loaderCtx)).finally(() => {
+            doneLoader();
+        });
+        // Memoize for subsequent calls
+        loaderPromises.set(loader.$$id, promise);
+        return promise;
+    });
+}
+//# sourceMappingURL=request-context.js.map

package/dist/server/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/server/request-context.ts"],"names":[],"mappings":"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"}

package/dist/server/root-layout.d.ts

@@ -0,0 +1,4 @@
+import type { ReactNode } from "react";
+declare const MapRootLayout: ReactNode;
+export default MapRootLayout;
+//# sourceMappingURL=root-layout.d.ts.map

package/dist/server/root-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-layout.d.ts","sourceRoot":"","sources":["../../src/server/root-layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,QAAA,MAAM,aAAa,EAId,SAAS,CAAC;AAEf,eAAe,aAAa,CAAC"}

package/dist/server/root-layout.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Outlet } from "../client.js";
+const MapRootLayout = (_jsx(_Fragment, { children: _jsx(Outlet, {}) }));
+export default MapRootLayout;
+//# sourceMappingURL=root-layout.js.map

package/dist/server/root-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-layout.js","sourceRoot":"","sources":["../../src/server/root-layout.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,aAAa,GAAG,CACpB,4BACE,KAAC,MAAM,KAAG,GACT,CACS,CAAC;AAEf,eAAe,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @rangojs/router/server — Internal subpath
+ *
+ * This module is NOT user-facing. Import from "@rangojs/router" instead.
+ *
+ * Exports here are consumed by the Vite plugin (discovery, manifest injection,
+ * virtual modules) and the RSC handler internals. They are not part of the
+ * public API and may change without notice.
+ */
+export { RSC_ROUTER_BRAND, RouterRegistry, } from "./router.js";
+export { registerRouteMap, setCachedManifest, setPrecomputedEntries, setRouteTrie, setManifestReadyPromise, setRouterManifest, setRouterTrie, setRouterPrecomputedEntries, registerRouterManifestLoader, ensureRouterManifest, } from "./route-map-builder.js";
+export { registerLoaderById, setLoaderImports } from "./server/loader-registry.js";
+export { createRequestContext, type CreateRequestContextOptions, } from "./server/request-context.js";
+export { isClientComponent, assertClientComponent, } from "./component-utils.js";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,2BAA2B,EAC3B,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGnF,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/server.js

@@ -0,0 +1,20 @@
+/**
+ * @rangojs/router/server — Internal subpath
+ *
+ * This module is NOT user-facing. Import from "@rangojs/router" instead.
+ *
+ * Exports here are consumed by the Vite plugin (discovery, manifest injection,
+ * virtual modules) and the RSC handler internals. They are not part of the
+ * public API and may change without notice.
+ */
+// Router registry (used by Vite plugin for build-time discovery)
+export { RSC_ROUTER_BRAND, RouterRegistry, } from "./router.js";
+// Route map builder (Vite plugin injects these via virtual modules)
+export { registerRouteMap, setCachedManifest, setPrecomputedEntries, setRouteTrie, setManifestReadyPromise, setRouterManifest, setRouterTrie, setRouterPrecomputedEntries, registerRouterManifestLoader, ensureRouterManifest, } from "./route-map-builder.js";
+// Loader registry (Vite plugin registers lazy loader imports)
+export { registerLoaderById, setLoaderImports } from "./server/loader-registry.js";
+// Request context creation (used by RSC handler, not user-facing)
+export { createRequestContext, } from "./server/request-context.js";
+// Component utilities (used internally for server/client boundary checks)
+export { isClientComponent, assertClientComponent, } from "./component-utils.js";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,OAAO,EACL,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,oEAAoE;AACpE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,2BAA2B,EAC3B,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEnF,kEAAkE;AAClE,OAAO,EACL,oBAAoB,GAErB,MAAM,6BAA6B,CAAC;AAErC,0EAA0E;AAC1E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/ssr/__tests__/ssr-handler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ssr-handler.test.d.ts.map

package/dist/ssr/__tests__/ssr-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-handler.test.d.ts","sourceRoot":"","sources":["../../../src/ssr/__tests__/ssr-handler.test.tsx"],"names":[],"mappings":""}

package/dist/ssr/__tests__/ssr-handler.test.js

@@ -0,0 +1,132 @@
+import { describe, it, expect, vi } from "vitest";
+import React from "react";
+import { createSSRHandler } from "../index";
+describe("createSSRHandler", () => {
+    // Mock dependencies
+    const createMockDeps = (overrides = {}) => ({
+        createFromReadableStream: vi.fn().mockResolvedValue({
+            root: React.createElement("div", null, "Test"),
+            metadata: { matched: ["/"], pathname: "/" },
+        }),
+        renderToReadableStream: vi.fn().mockResolvedValue(new ReadableStream({
+            start(controller) {
+                controller.enqueue(new TextEncoder().encode("<html><body>Test</body></html>"));
+                controller.close();
+            },
+        })),
+        injectRSCPayload: vi.fn().mockReturnValue(new TransformStream({
+            transform(chunk, controller) {
+                controller.enqueue(chunk);
+            },
+        })),
+        loadBootstrapScriptContent: vi.fn().mockResolvedValue("console.log('bootstrap')"),
+        ...overrides,
+    });
+    const createMockRscStream = () => new ReadableStream({
+        start(controller) {
+            controller.enqueue(new TextEncoder().encode("mock rsc payload"));
+            controller.close();
+        },
+    });
+    describe("onError callback", () => {
+        it("should call onError when rendering fails", async () => {
+            const onError = vi.fn();
+            const renderError = new Error("Rendering failed");
+            const deps = createMockDeps({
+                renderToReadableStream: vi.fn().mockRejectedValue(renderError),
+                onError,
+            });
+            const renderHTML = createSSRHandler(deps);
+            await expect(renderHTML(createMockRscStream())).rejects.toThrow("Rendering failed");
+            expect(onError).toHaveBeenCalledTimes(1);
+            expect(onError).toHaveBeenCalledWith(renderError, { phase: "rendering" });
+        });
+        it("should call onError with phase: rendering", async () => {
+            const onError = vi.fn();
+            const deps = createMockDeps({
+                // Use loadBootstrapScriptContent error since it happens before React.use()
+                loadBootstrapScriptContent: vi.fn().mockRejectedValue(new Error("Bootstrap failed")),
+                onError,
+            });
+            const renderHTML = createSSRHandler(deps);
+            await expect(renderHTML(createMockRscStream())).rejects.toThrow("Bootstrap failed");
+            expect(onError).toHaveBeenCalledWith(expect.any(Error), { phase: "rendering" });
+        });
+        it("should convert non-Error objects to Error", async () => {
+            const onError = vi.fn();
+            const deps = createMockDeps({
+                renderToReadableStream: vi.fn().mockRejectedValue("string error"),
+                onError,
+            });
+            const renderHTML = createSSRHandler(deps);
+            await expect(renderHTML(createMockRscStream())).rejects.toThrow();
+            expect(onError).toHaveBeenCalledWith(expect.objectContaining({
+                message: "string error",
+            }), { phase: "rendering" });
+        });
+        it("should still throw original error after calling onError", async () => {
+            const onError = vi.fn();
+            const originalError = new Error("Original error");
+            const deps = createMockDeps({
+                loadBootstrapScriptContent: vi.fn().mockRejectedValue(originalError),
+                onError,
+            });
+            const renderHTML = createSSRHandler(deps);
+            await expect(renderHTML(createMockRscStream())).rejects.toThrow("Original error");
+            // Verify onError was called before error was thrown
+            expect(onError).toHaveBeenCalled();
+        });
+        it("should catch errors in onError callback and not break the flow", async () => {
+            const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+            const callbackError = new Error("Callback exploded");
+            const onError = vi.fn().mockImplementation(() => {
+                throw callbackError;
+            });
+            const originalError = new Error("Original rendering error");
+            const deps = createMockDeps({
+                renderToReadableStream: vi.fn().mockRejectedValue(originalError),
+                onError,
+            });
+            const renderHTML = createSSRHandler(deps);
+            // Should throw original error, not callback error
+            await expect(renderHTML(createMockRscStream())).rejects.toThrow("Original rendering error");
+            expect(onError).toHaveBeenCalled();
+            expect(consoleErrorSpy).toHaveBeenCalledWith("[SSRHandler.onError] Callback error:", callbackError);
+            consoleErrorSpy.mockRestore();
+        });
+        it("should not call onError when rendering succeeds", async () => {
+            const onError = vi.fn();
+            const deps = createMockDeps({ onError });
+            const renderHTML = createSSRHandler(deps);
+            const result = await renderHTML(createMockRscStream());
+            expect(result).toBeInstanceOf(ReadableStream);
+            expect(onError).not.toHaveBeenCalled();
+        });
+        it("should work without onError callback", async () => {
+            const deps = createMockDeps({
+                renderToReadableStream: vi.fn().mockRejectedValue(new Error("No callback test")),
+                onError: undefined,
+            });
+            const renderHTML = createSSRHandler(deps);
+            // Should not throw because of missing onError
+            await expect(renderHTML(createMockRscStream())).rejects.toThrow("No callback test");
+        });
+    });
+    describe("successful rendering", () => {
+        it("should return a ReadableStream on success", async () => {
+            const deps = createMockDeps();
+            const renderHTML = createSSRHandler(deps);
+            const result = await renderHTML(createMockRscStream());
+            expect(result).toBeInstanceOf(ReadableStream);
+        });
+        it("should call all dependencies in correct order", async () => {
+            const deps = createMockDeps();
+            const renderHTML = createSSRHandler(deps);
+            await renderHTML(createMockRscStream());
+            expect(deps.loadBootstrapScriptContent).toHaveBeenCalled();
+            expect(deps.renderToReadableStream).toHaveBeenCalled();
+            expect(deps.injectRSCPayload).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=ssr-handler.test.js.map

package/dist/ssr/__tests__/ssr-handler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-handler.test.js","sourceRoot":"","sources":["../../../src/ssr/__tests__/ssr-handler.test.tsx"],"names":[],"mappings":"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"}

package/dist/ssr/index.d.ts

@@ -0,0 +1,98 @@
+import React from "react";
+import type { ErrorPhase } from "../types.js";
+/**
+ * Options for injectRSCPayload
+ */
+export interface InjectRSCPayloadOptions {
+    /**
+     * Nonce for Content Security Policy (CSP)
+     */
+    nonce?: string;
+}
+/**
+ * Options for renderToReadableStream from react-dom/server
+ */
+interface RenderToReadableStreamOptions {
+    bootstrapScriptContent?: string;
+    nonce?: string;
+    formState?: unknown;
+}
+/**
+ * Options for the renderHTML function
+ */
+export interface SSRRenderOptions {
+    /**
+     * Form state for useActionState progressive enhancement.
+     * This is the result of decodeFormState() and should be passed to
+     * react-dom's renderToReadableStream to enable useActionState to
+     * receive the action result during SSR.
+     */
+    formState?: unknown;
+    /**
+     * Nonce for Content Security Policy (CSP)
+     */
+    nonce?: string;
+}
+/**
+ * SSR dependencies from external packages
+ */
+export interface SSRDependencies<TEnv = unknown> {
+    /**
+     * createFromReadableStream from @vitejs/plugin-rsc/ssr
+     */
+    createFromReadableStream: <T>(stream: ReadableStream<Uint8Array>) => Promise<T>;
+    /**
+     * renderToReadableStream from react-dom/server.edge
+     */
+    renderToReadableStream: (element: React.ReactNode, options?: RenderToReadableStreamOptions) => Promise<ReadableStream<Uint8Array>>;
+    /**
+     * injectRSCPayload from rsc-html-stream/server
+     */
+    injectRSCPayload: (rscStream: ReadableStream<Uint8Array>, options?: InjectRSCPayloadOptions) => TransformStream<Uint8Array, Uint8Array>;
+    /**
+     * Function to load bootstrap script content
+     * Typically: () => import.meta.viteRsc.loadBootstrapScriptContent("index")
+     */
+    loadBootstrapScriptContent: () => Promise<string>;
+    /**
+     * Optional callback invoked when an error occurs during SSR rendering.
+     *
+     * This callback is for notification/logging purposes.
+     *
+     * @example
+     * ```typescript
+     * export const renderHTML = createSSRHandler({
+     *   // ... other deps
+     *   onError: (error, context) => {
+     *     console.error('[SSR] Rendering error:', error);
+     *     Sentry.captureException(error);
+     *   },
+     * });
+     * ```
+     */
+    onError?: (error: Error, context: {
+        phase: ErrorPhase;
+    }) => void;
+}
+/**
+ * Create an SSR handler that converts RSC streams to HTML.
+ *
+ * @example
+ * ```tsx
+ * import { createSSRHandler } from "rsc-router/ssr";
+ * import { createFromReadableStream } from "@vitejs/plugin-rsc/ssr";
+ * import { renderToReadableStream } from "react-dom/server.edge";
+ * import { injectRSCPayload } from "rsc-html-stream/server";
+ *
+ * export const renderHTML = createSSRHandler({
+ *   createFromReadableStream,
+ *   renderToReadableStream,
+ *   injectRSCPayload,
+ *   loadBootstrapScriptContent: () =>
+ *     import.meta.viteRsc.loadBootstrapScriptContent("index"),
+ * });
+ * ```
+ */
+export declare function createSSRHandler<TEnv = unknown>(deps: SSRDependencies<TEnv>): (rscStream: ReadableStream<Uint8Array>, options?: SSRRenderOptions) => Promise<ReadableStream<Uint8Array>>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/ssr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssr/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,6BAA6B;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,IAAI,GAAG,OAAO;IAC7C;;OAEG;IACH,wBAAwB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhF;;OAEG;IACH,sBAAsB,EAAE,CACtB,OAAO,EAAE,KAAK,CAAC,SAAS,EACxB,OAAO,CAAC,EAAE,6BAA6B,KACpC,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IAEzC;;OAEG;IACH,gBAAgB,EAAE,CAChB,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,OAAO,CAAC,EAAE,uBAAuB,KAC9B,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAE7C;;;OAGG;IACH,0BAA0B,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAElD;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE;AAwED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,IAgBxE,WAAW,cAAc,CAAC,UAAU,CAAC,EACrC,UAAU,gBAAgB,KACzB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAyFvC"}