rwsdk 1.0.0-alpha.2 → 1.0.0-alpha.20-test.20250929144616

package/dist/runtime/lib/router.test.js

@@ -1,5 +1,6 @@
-import { describe, it, expect } from "vitest";
-import { matchPath } from "./router";
+import React from "react";
+import { describe, expect, it } from "vitest";
+import { defineRoutes, layout, matchPath, prefix, render, route, } from "./router";
 describe("matchPath", () => {
     // Test case 1: Static paths
     it("should match static paths", () => {
@@ -22,7 +23,7 @@ describe("matchPath", () => {
         expect(matchPath("/files/*/", "/files/document.pdf/")).toEqual({
             $0: "document.pdf",
         });
-        expect(matchPath("/data/*\/content/", "/data/archive/content/")).toEqual({
+        expect(matchPath("/data/*/content/", "/data/archive/content/")).toEqual({
             $0: "archive",
         });
         expect(matchPath("/assets/*/*/", "/assets/images/pic.png/")).toEqual({
@@ -56,3 +57,590 @@ describe("matchPath", () => {
         expect(() => matchPath("/type/**", "/type/a-thumb-drive")).toThrow();
     });
 });
+describe("defineRoutes - Request Handling Behavior", () => {
+    // Helper to create mock dependencies using dependency injection
+    const createMockDependencies = () => {
+        const mockRequestInfo = {
+            request: new Request("http://localhost:3000/"),
+            params: {},
+            ctx: {},
+            rw: {
+                nonce: "test-nonce",
+                Document: () => React.createElement("html"),
+                rscPayload: true,
+                ssr: true,
+                databases: new Map(),
+                scriptsToBeLoaded: new Set(),
+                pageRouteResolved: undefined,
+            },
+            cf: {},
+            response: { headers: new Headers() },
+            isAction: false,
+        };
+        const mockRenderPage = async (requestInfo, Page, onError) => {
+            return new Response(`Rendered: ${Page.name || "Component"}`, {
+                headers: { "content-type": "text/html" },
+            });
+        };
+        const mockRscActionHandler = async (request) => {
+            return { actionResult: "test-action-result" };
+        };
+        const mockRunWithRequestInfoOverrides = async (overrides, fn) => {
+            // Merge overrides into the mock request info
+            Object.assign(mockRequestInfo, overrides);
+            return await fn();
+        };
+        return {
+            mockRequestInfo,
+            mockRenderPage,
+            mockRscActionHandler,
+            mockRunWithRequestInfoOverrides,
+            getRequestInfo: () => mockRequestInfo,
+            onError: (error) => {
+                throw error;
+            },
+        };
+    };
+    describe("Sequential Route Evaluation", () => {
+        it("should process routes in the exact order they are defined", async () => {
+            const executionOrder = [];
+            const middleware1 = (requestInfo) => {
+                executionOrder.push("middleware1");
+            };
+            const middleware2 = (requestInfo) => {
+                executionOrder.push("middleware2");
+            };
+            const PageComponent = () => {
+                executionOrder.push("PageComponent");
+                return React.createElement("div", {}, "Page");
+            };
+            const router = defineRoutes([
+                middleware1,
+                middleware2,
+                route("/test/", PageComponent),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual([
+                "middleware1",
+                "middleware2",
+                "PageComponent",
+            ]);
+        });
+    });
+    describe("Middleware Short-Circuiting", () => {
+        it("should stop processing when middleware returns a Response", async () => {
+            const executionOrder = [];
+            const middleware1 = (requestInfo) => {
+                executionOrder.push("middleware1");
+            };
+            const middleware2 = (requestInfo) => {
+                executionOrder.push("middleware2");
+                return new Response("Middleware2 Response", { status: 200 });
+            };
+            const middleware3 = (requestInfo) => {
+                executionOrder.push("middleware3");
+            };
+            const PageComponent = () => {
+                executionOrder.push("PageComponent");
+                return React.createElement("div", {}, "Page");
+            };
+            const router = defineRoutes([
+                middleware1,
+                middleware2,
+                middleware3,
+                route("/test/", PageComponent),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            const response = await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["middleware1", "middleware2"]);
+            expect(await response.text()).toBe("Middleware2 Response");
+            expect(response.status).toBe(200);
+        });
+        it("should stop processing when middleware returns a JSX element", async () => {
+            const executionOrder = [];
+            const middleware1 = (requestInfo) => {
+                executionOrder.push("middleware1");
+            };
+            const middleware2 = (requestInfo) => {
+                executionOrder.push("middleware2");
+                return React.createElement("div", {}, "Middleware JSX");
+            };
+            const PageComponent = () => {
+                executionOrder.push("PageComponent");
+                return React.createElement("div", {}, "Page");
+            };
+            const router = defineRoutes([
+                middleware1,
+                middleware2,
+                route("/test/", PageComponent),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            const response = await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["middleware1", "middleware2"]);
+            expect(await response.text()).toBe("Rendered: Element");
+        });
+    });
+    describe("Prefix Handling", () => {
+        it("should only run middleware within the specified prefix", async () => {
+            const executionOrder = [];
+            const prefixedMiddleware = () => {
+                executionOrder.push("prefixedMiddleware");
+            };
+            const PageComponent = () => {
+                executionOrder.push("PageComponent");
+                return React.createElement("div", {}, "Page");
+            };
+            const AdminPageComponent = () => {
+                executionOrder.push("AdminPageComponent");
+                return React.createElement("div", {}, "Admin Page");
+            };
+            const router = defineRoutes([
+                ...prefix("/admin", [
+                    prefixedMiddleware,
+                    route("/", AdminPageComponent),
+                ]),
+                route("/", PageComponent),
+            ]);
+            const deps = createMockDependencies();
+            // Test 1: Request to a path outside the prefix
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/");
+            const request1 = new Request("http://localhost:3000/");
+            await router.handle({
+                request: request1,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["PageComponent"]);
+            // Reset execution order
+            executionOrder.length = 0;
+            // Test 2: Request to a path inside the prefix
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/admin/");
+            const request2 = new Request("http://localhost:3000/admin/");
+            await router.handle({
+                request: request2,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual([
+                "prefixedMiddleware",
+                "AdminPageComponent",
+            ]);
+        });
+        it("should short-circuit from a prefixed middleware", async () => {
+            const executionOrder = [];
+            const prefixedMiddleware = () => {
+                executionOrder.push("prefixedMiddleware");
+                return new Response("From prefixed middleware");
+            };
+            const AdminPageComponent = () => {
+                executionOrder.push("AdminPageComponent");
+                return React.createElement("div", {}, "Admin Page");
+            };
+            const router = defineRoutes([
+                ...prefix("/admin", [
+                    prefixedMiddleware,
+                    route("/", AdminPageComponent),
+                ]),
+            ]);
+            const deps = createMockDependencies();
+            // Request to a path inside the prefix
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/admin/");
+            const request = new Request("http://localhost:3000/admin/");
+            const response = await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["prefixedMiddleware"]);
+            expect(await response.text()).toBe("From prefixed middleware");
+        });
+    });
+    describe("RSC Action Handling", () => {
+        it("should handle RSC actions before the first route definition", async () => {
+            const executionOrder = [];
+            const middleware1 = (requestInfo) => {
+                executionOrder.push("middleware1");
+            };
+            const PageComponent = () => {
+                executionOrder.push("PageComponent");
+                return React.createElement("div", {}, "Page");
+            };
+            const router = defineRoutes([
+                middleware1,
+                route("/test/", PageComponent),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/?__rsc_action_id=test");
+            deps.mockRscActionHandler = async (request) => {
+                executionOrder.push("rscActionHandler");
+                return { actionResult: "test-result" };
+            };
+            const request = new Request("http://localhost:3000/test/?__rsc_action_id=test");
+            await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual([
+                "middleware1",
+                "rscActionHandler",
+                "PageComponent",
+            ]);
+            expect(deps.mockRequestInfo.rw.actionResult).toEqual({
+                actionResult: "test-result",
+            });
+        });
+        it("should not handle RSC actions multiple times for multiple routes", async () => {
+            const executionOrder = [];
+            const PageComponent1 = () => {
+                executionOrder.push("PageComponent1");
+                return React.createElement("div", {}, "Page1");
+            };
+            const PageComponent2 = () => {
+                executionOrder.push("PageComponent2");
+                return React.createElement("div", {}, "Page2");
+            };
+            const router = defineRoutes([
+                route("/other/", PageComponent1),
+                route("/test/", PageComponent2),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/?__rsc_action_id=test");
+            deps.mockRscActionHandler = async (request) => {
+                executionOrder.push("rscActionHandler");
+                return { actionResult: "test-result" };
+            };
+            const request = new Request("http://localhost:3000/test/?__rsc_action_id=test");
+            await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["rscActionHandler", "PageComponent2"]);
+            // Should only call action handler once, even though there are multiple routes
+        });
+    });
+    describe("Page Route Matching and Rendering", () => {
+        it("should match the first route that matches the path", async () => {
+            const executionOrder = [];
+            const PageComponent1 = () => {
+                executionOrder.push("PageComponent1");
+                return React.createElement("div", {}, "Page1");
+            };
+            const PageComponent2 = () => {
+                executionOrder.push("PageComponent2");
+                return React.createElement("div", {}, "Page2");
+            };
+            const router = defineRoutes([
+                route("/test/", PageComponent1),
+                route("/test/", PageComponent2), // This should never be reached
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["PageComponent1"]);
+        });
+        it("should continue to next route if path does not match", async () => {
+            const executionOrder = [];
+            const PageComponent1 = () => {
+                executionOrder.push("PageComponent1");
+                return React.createElement("div", {}, "Page1");
+            };
+            const PageComponent2 = () => {
+                executionOrder.push("PageComponent2");
+                return React.createElement("div", {}, "Page2");
+            };
+            const router = defineRoutes([
+                route("/other/", PageComponent1),
+                route("/test/", PageComponent2),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["PageComponent2"]);
+        });
+        it("should return 404 when no routes match", async () => {
+            const PageComponent = () => React.createElement("div", {}, "Page");
+            const router = defineRoutes([route("/other/", PageComponent)]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            const response = await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(response.status).toBe(404);
+            expect(await response.text()).toBe("Not Found");
+        });
+    });
+    describe("Multiple Render Blocks with SSR Configuration", () => {
+        it("should short-circuit on first matching render block and not apply later configurations", async () => {
+            const executionOrder = [];
+            const ssrSettings = [];
+            const Document1 = () => React.createElement("html", {}, "Doc1");
+            const Document2 = () => React.createElement("html", {}, "Doc2");
+            const PageComponent1 = (requestInfo) => {
+                executionOrder.push("PageComponent1");
+                ssrSettings.push(requestInfo.rw.ssr);
+                return React.createElement("div", {}, "Page1");
+            };
+            const PageComponent2 = (requestInfo) => {
+                executionOrder.push("PageComponent2");
+                ssrSettings.push(requestInfo.rw.ssr);
+                return React.createElement("div", {}, "Page2");
+            };
+            const router = defineRoutes([
+                ...render(Document1, [route("/test/", PageComponent1)], { ssr: true }),
+                ...render(Document2, [route("/other/", PageComponent2)], {
+                    ssr: false,
+                }),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["PageComponent1"]);
+            expect(ssrSettings).toEqual([true]);
+            // The second render block's ssr: false should not have been applied
+            expect(deps.mockRequestInfo.rw.Document).toBe(Document1);
+        });
+    });
+    describe("Route-Specific Middleware", () => {
+        it("should execute route-specific middleware before the component", async () => {
+            const executionOrder = [];
+            const globalMiddleware = (requestInfo) => {
+                executionOrder.push("globalMiddleware");
+            };
+            const routeMiddleware = (requestInfo) => {
+                executionOrder.push("routeMiddleware");
+            };
+            const PageComponent = () => {
+                executionOrder.push("PageComponent");
+                return React.createElement("div", {}, "Page");
+            };
+            const router = defineRoutes([
+                globalMiddleware,
+                route("/test/", [routeMiddleware, PageComponent]),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual([
+                "globalMiddleware",
+                "routeMiddleware",
+                "PageComponent",
+            ]);
+        });
+        it("should short-circuit if route-specific middleware returns a Response", async () => {
+            const executionOrder = [];
+            const routeMiddleware = (requestInfo) => {
+                executionOrder.push("routeMiddleware");
+                return new Response("Route Middleware Response");
+            };
+            const PageComponent = () => {
+                executionOrder.push("PageComponent");
+                return React.createElement("div", {}, "Page");
+            };
+            const router = defineRoutes([
+                route("/test/", [routeMiddleware, PageComponent]),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            const request = new Request("http://localhost:3000/test/");
+            const response = await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(executionOrder).toEqual(["routeMiddleware"]);
+            expect(await response.text()).toBe("Route Middleware Response");
+        });
+    });
+    describe("Layout Handling", () => {
+        it("should wrap components with layouts", async () => {
+            const executionOrder = [];
+            const TestLayout = ({ children }) => {
+                executionOrder.push("TestLayout");
+                return React.createElement("div", { className: "layout" }, children);
+            };
+            const PageComponent = () => {
+                executionOrder.push("PageComponent");
+                return React.createElement("div", {}, "Page Content");
+            };
+            const router = defineRoutes([
+                ...layout(TestLayout, [route("/test/", PageComponent)]),
+            ]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/");
+            // Mock renderPage to track layout wrapping
+            deps.mockRenderPage = async (requestInfo, WrappedComponent, onError) => {
+                // The component should be wrapped with layouts
+                const element = React.createElement(WrappedComponent);
+                return new Response(`Rendered with layouts`);
+            };
+            const request = new Request("http://localhost:3000/test/");
+            const response = await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(await response.text()).toBe("Rendered with layouts");
+        });
+    });
+    describe("Parameter Extraction", () => {
+        it("should extract path parameters and make them available in request info", async () => {
+            let extractedParams = null;
+            const PageComponent = (requestInfo) => {
+                extractedParams = requestInfo.params;
+                return React.createElement("div", {}, `User: ${requestInfo.params.id}`);
+            };
+            const router = defineRoutes([route("/users/:id/", PageComponent)]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/users/123/");
+            const request = new Request("http://localhost:3000/users/123/");
+            await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(extractedParams).toEqual({ id: "123" });
+        });
+    });
+    describe("Edge Cases", () => {
+        it("should handle middleware-only apps with RSC actions", async () => {
+            const executionOrder = [];
+            const middleware1 = (requestInfo) => {
+                executionOrder.push("middleware1");
+            };
+            const middleware2 = (requestInfo) => {
+                executionOrder.push("middleware2");
+                return new Response("Middleware Response");
+            };
+            // No route definitions, only middleware
+            const router = defineRoutes([middleware1, middleware2]);
+            const deps = createMockDependencies();
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test/?__rsc_action_id=test");
+            deps.mockRscActionHandler = async (request) => {
+                executionOrder.push("rscActionHandler");
+                return { actionResult: "test-result" };
+            };
+            const request = new Request("http://localhost:3000/test/?__rsc_action_id=test");
+            const response = await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            // Action should still be handled even with no route definitions
+            expect(executionOrder).toEqual(["middleware1", "middleware2"]);
+            expect(await response.text()).toBe("Middleware Response");
+        });
+        it("should handle trailing slash normalization", async () => {
+            const PageComponent = () => React.createElement("div", {}, "Page");
+            const router = defineRoutes([route("/test/", PageComponent)]);
+            const deps = createMockDependencies();
+            // Request without trailing slash should be normalized
+            deps.mockRequestInfo.request = new Request("http://localhost:3000/test");
+            const request = new Request("http://localhost:3000/test");
+            const response = await router.handle({
+                request,
+                renderPage: deps.mockRenderPage,
+                getRequestInfo: deps.getRequestInfo,
+                onError: deps.onError,
+                runWithRequestInfoOverrides: deps.mockRunWithRequestInfoOverrides,
+                rscActionHandler: deps.mockRscActionHandler,
+            });
+            expect(response.status).not.toBe(404);
+            expect(await response.text()).toBe("Rendered: Element");
+        });
+    });
+});

package/dist/runtime/lib/rwContext.d.ts

@@ -0,0 +1,22 @@
+import { type Kysely } from "kysely";
+import { type RequestInfo } from "../requestInfo/types.js";
+export type RwContext = {
+    nonce: string;
+    Document: React.FC<DocumentProps<any>>;
+    rscPayload: boolean;
+    ssr: boolean;
+    layouts?: React.FC<LayoutProps<any>>[];
+    databases: Map<string, Kysely<any>>;
+    scriptsToBeLoaded: Set<string>;
+    entryScripts: Set<string>;
+    inlineScripts: Set<string>;
+    pageRouteResolved: PromiseWithResolvers<void> | undefined;
+    actionResult?: unknown;
+};
+export type DocumentProps<T extends RequestInfo = RequestInfo> = T & {
+    children: React.ReactNode;
+};
+export type LayoutProps<T extends RequestInfo = RequestInfo> = {
+    children?: React.ReactNode;
+    requestInfo?: T;
+};

package/dist/runtime/lib/rwContext.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/lib/stitchDocumentAndAppStreams.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A utility to orchestrate and interleave two ReadableStreams (a document shell and an app shell)
+ * based on a set of markers within their content. This is designed to solve a specific
+ * race condition in streaming Server-Side Rendering (SSR) with Suspense.
+ *
+ * The logic is as follows:
+ * 1. Stream the document until a start marker is found.
+ * 2. Switch to the app stream and stream it until an end marker is found. This is the non-suspended shell.
+ * 3. Switch back to the document stream and stream it until the closing body tag. This sends the client script.
+ * 4. Switch back to the app stream and stream the remainder (the suspended content).
+ * 5. Switch back to the document stream and stream the remainder (closing body and html tags).
+ *
+ * @param outerHtml The stream for the document shell (`<Document>`).
+ * @param innerHtml The stream for the application's content.
+ * @param startMarker The marker in the document to start injecting the app.
+ * @param endMarker The marker in the app stream that signals the end of the initial, non-suspended render.
+ */
+export declare function stitchDocumentAndAppStreams(outerHtml: ReadableStream<Uint8Array>, innerHtml: ReadableStream<Uint8Array>, startMarker: string, endMarker: string): ReadableStream<Uint8Array>;