@rebask/core 0.3.0 → 0.4.0

package/dist/handlers/rsc/render-with-retries.js

@@ -1,154 +0,0 @@
-import { proxyPatterns } from "virtual:rebask/proxy-router";
-import { ResumeMode } from "../../lib/ppr/types.js";
-import { prerenderPaths } from "../../lib/prerender-paths.js";
-import {} from "../../lib/render-context.js";
-import { renderPageSegment, renderRouteSegments } from "../../lib/route-renderer.js";
-import { discardRscCacheWrite, renderRsc, runRscRequest } from "../../lib/rsc-request.js";
-import { ActionErrorCode } from "../../lib/types.js";
-import { getBoundaryError, markNotFound, markNotFoundThrown, OutgoingResponseHeaders, setBoundaryError, } from "../../request-context.js";
-import { CacheLookupKind } from "./cache-lookup.js";
-import { FallbackRouteError, onNotFound, RetryWithBoundaryError, RetryWithNotFoundBoundaryError, } from "./errors.js";
-import { handlePageRoute } from "./index.js";
-import { renderToResponse } from "./render-to-response.js";
-export async function renderWithRetries(state, cacheContext) {
-    const { returnValue, formState, temporaryReferences, actionError, actionThrownError } = state.postBody;
-    const match = { route: state.route, params: state.params };
-    const shouldRenderRscSegment = state.isRscRequest && !state.isActionRscRequest;
-    // We're in PPR mode if we should prerender, this is not a resume request, we don't have a
-    // cached HTML entry already, and the route hasn't been flagged as having no shell
-    // (except at build time).
-    const isPpr = state.shouldPrerender &&
-        !state.isResumeRequest &&
-        cacheContext.kind !== CacheLookupKind.PprHit &&
-        (!state.isNoShellRoute || state.isBuildPrerender);
-    // Resuming a cached shell serves HTML that was rendered earlier, so this render must not
-    // regenerate the cached data that HTML already contains.
-    const isGeneratingCacheEntry = state.isStaticGen && cacheContext.kind !== CacheLookupKind.PprHit;
-    let attempt = {};
-    let response;
-    while (true) {
-        const abortOnDynamic = isPpr && attempt.activeErrorIndex === undefined;
-        const renderContext = {
-            errorBoundary: {
-                activeIndex: attempt.activeErrorIndex,
-            },
-            notFoundBoundary: {
-                activeIndex: attempt.activeNotFoundIndex,
-            },
-            ...(isPpr && {
-                ppr: {
-                    controller: new AbortController(),
-                    abortOnDynamic,
-                    // This render fills a cache rather than streaming to a user, so it waits for a hanging
-                    // dynamic read instead of aborting as soon as the shell is ready.
-                    isCachePrerender: state.isBuildPrerender || state.isPrerenderUpgrade,
-                    resolvedParams: state.resolvedParams,
-                    paramNames: state.fullParamsSet,
-                    pendingShellWork: new Set(),
-                    usedUnresolvedParams: new Set(),
-                },
-            }),
-        };
-        try {
-            response = await runRscRequest({
-                input: {
-                    request: state.request,
-                    params: match.params,
-                    isStaticGeneration: isGeneratingCacheEntry,
-                    resumeData: state.resumeState?.type === ResumeMode.HTML
-                        ? state.resumeState.resumeData
-                        : undefined,
-                },
-                response: { headers: new OutgoingResponseHeaders() },
-            }, renderContext, async () => {
-                if (attempt.boundaryError)
-                    setBoundaryError(attempt.boundaryError);
-                if (attempt.notFound)
-                    markNotFound();
-                if (!state.isBuildPrerender &&
-                    state.isDynamicRoute &&
-                    state.isPageRoute &&
-                    (await prerenderPaths.isStaticPathMiss(state.route.filePath, state.url.pathname))) {
-                    markNotFoundThrown();
-                }
-                // No-JS native forms cannot consume RSC streams, so they recurse to render the full HTML
-                // page. We bridge the action's 404 state here to ensure the subsequent page render knows
-                // to activate the not-found boundaries.
-                if (actionError === ActionErrorCode.NotFound && !state.isRscRequest) {
-                    markNotFound();
-                }
-                // Build seedData inside the request scope so `renderPage` can read `isNotFound()`.
-                // For non-PPR routes this only needs to run once, but rebuilding is cheap because
-                // module loaders are cached.
-                state.seedData = shouldRenderRscSegment
-                    ? await renderPageSegment(match, attempt.boundaryError)
-                    : state.isRscRequest
-                        ? undefined
-                        : await renderRouteSegments(match, state.routeTree, 
-                        // Native no-JS form submissions execute the action before the main render starts.
-                        // Re-inject unexpected action errors to activate the nearest error boundary
-                        !attempt.boundaryError ? actionThrownError : undefined);
-                const boundaryError = getBoundaryError();
-                let payload;
-                if (state.isActionRscRequest) {
-                    if (returnValue !== undefined) {
-                        payload = { returnValue };
-                    }
-                    else if (formState !== undefined) {
-                        payload = { formState };
-                    }
-                    else if (actionError !== undefined) {
-                        payload = { actionError };
-                    }
-                    else {
-                        throw new Error("Expected an action result, form state, or action error for action RSC response.");
-                    }
-                }
-                else {
-                    if (!state.seedData) {
-                        throw new Error("Expected route seed data for route RSC response.");
-                    }
-                    payload = {
-                        seedData: state.seedData,
-                        routeTree: state.routeTree,
-                        ...(state.routePrediction && { routePrediction: state.routePrediction }),
-                        ...(proxyPatterns && { proxyPatterns }),
-                        ...(formState !== undefined && { formState }),
-                        ...(boundaryError && { error: boundaryError }),
-                    };
-                }
-                const pprSignal = renderContext.ppr?.controller.signal;
-                // Renders that only fill a cache skip the resume phase, so pass them the PPR abort
-                // signal to stop the RSC stream hanging on data that will never arrive. A render that
-                // serves a user must not get it, because its RSC stream feeds the resume.
-                const rscOptions = state.isBuildPrerender || state.isPrerenderUpgrade
-                    ? { temporaryReferences, ...(pprSignal && { signal: pprSignal }) }
-                    : { temporaryReferences };
-                const stream = state.isActionRscRequest
-                    ? renderRsc(payload, rscOptions)
-                    : renderRsc(payload, rscOptions, onNotFound);
-                return await renderToResponse(state, cacheContext, stream);
-            });
-            break;
-        }
-        catch (error) {
-            if (error instanceof RetryWithBoundaryError) {
-                attempt.activeErrorIndex = error.boundaryIndex;
-                attempt.boundaryError = error.originalError;
-                continue;
-            }
-            if (error instanceof RetryWithNotFoundBoundaryError) {
-                attempt.activeNotFoundIndex = error.boundaryIndex;
-                attempt.notFound = true;
-                continue;
-            }
-            if (state.rscCacheWrite)
-                discardRscCacheWrite(state.rscCacheWrite);
-            if (error instanceof FallbackRouteError) {
-                return handlePageRoute(state.request, error.fallbackRoute, state.params, state.handleOptions);
-            }
-            throw error;
-        }
-    }
-    return response;
-}

package/dist/handlers/rsc/retry-loop.d.ts

@@ -1,3 +0,0 @@
-import type { CacheLookupOutcome, RenderRequestState } from "./types.js";
-export declare function renderWithRetries(state: RenderRequestState, cacheContext: CacheLookupOutcome): Promise<Response>;
-//# sourceMappingURL=retry-loop.d.ts.map

package/dist/handlers/rsc/retry-loop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"retry-loop.d.ts","sourceRoot":"","sources":["../../../src/handlers/rsc/retry-loop.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAgB,MAAM,YAAY,CAAA;AAEtF,wBAAsB,iBAAiB,CACtC,KAAK,EAAE,kBAAkB,EACzB,YAAY,EAAE,kBAAkB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAyJnB"}

package/dist/handlers/rsc/retry-loop.js

@@ -1,145 +0,0 @@
-import { proxyPatterns } from "virtual:rebask/proxy-router";
-import { prerenderPaths } from "../../lib/prerender-paths.js";
-import {} from "../../lib/render-context.js";
-import { renderPageSegment, renderRouteSegments } from "../../lib/route-renderer.js";
-import { renderRsc, runRscRequest } from "../../lib/rsc-request.js";
-import { ActionErrorCode } from "../../lib/types.js";
-import { getBoundaryError, markNotFound, markNotFoundThrown, OutgoingResponseHeaders, setBoundaryError, } from "../../request-context.js";
-import { createResponse } from "./create-response.js";
-import { FallbackRouteError, onNotFound, RetryWithBoundaryError, RetryWithNotFoundBoundaryError, } from "./errors.js";
-import { handlePageRoute } from "./index.js";
-import { CacheLookupKind } from "./types.js";
-export async function renderWithRetries(state, cacheContext) {
-    const { returnValue, formState, temporaryReferences, actionError, actionThrownError } = state.postBody;
-    const match = { route: state.route, params: state.params };
-    const shouldRenderRscSegment = state.isRscRequest && !state.isActionRscRequest;
-    // We're in PPR mode if we should prerender, this is not a resume request, we don't have a
-    // cached HTML entry already, and the route hasn't been flagged as having no shell
-    // (except at build time).
-    const isPpr = state.shouldPrerender &&
-        !state.isResumeRequest &&
-        cacheContext.kind !== CacheLookupKind.PprHit &&
-        (!state.isNoShellRoute || state.isBuildPrerender);
-    // In upgrade mode, we still want the PPR render path (so cacheLife/postponed handling stays
-    // consistent) but we must NOT abort on dynamic access, as the goal is a fully-resolved render.
-    const shouldAbortOnDynamic = isPpr && !state.isPrerenderUpgrade;
-    let attempt = {};
-    let response;
-    while (true) {
-        const abortOnDynamic = shouldAbortOnDynamic && attempt.activeErrorIndex === undefined;
-        const renderContext = {
-            errorBoundary: {
-                isErrorPage: state.isErrorRoute,
-                activeIndex: attempt.activeErrorIndex,
-            },
-            notFoundBoundary: {
-                activeIndex: attempt.activeNotFoundIndex,
-                pathnameMode: state.route.type === "not-found" ? "client" : "request",
-            },
-            ...(isPpr && {
-                ppr: {
-                    controller: new AbortController(),
-                    abortOnDynamic,
-                    resolvedParams: state.resolvedParams,
-                },
-            }),
-        };
-        try {
-            response = await runRscRequest({
-                input: {
-                    request: state.request,
-                    params: match.params,
-                    isStaticGeneration: state.isStaticGen,
-                },
-                response: { headers: new OutgoingResponseHeaders() },
-            }, renderContext, async () => {
-                if (attempt.boundaryError)
-                    setBoundaryError(attempt.boundaryError);
-                if (attempt.notFound)
-                    markNotFound();
-                if (!state.isBuildPrerender &&
-                    state.isDynamicRoute &&
-                    state.isPageRoute &&
-                    (await prerenderPaths.isStaticPathMiss(state.route.filePath, state.url.pathname))) {
-                    markNotFoundThrown();
-                }
-                // No-JS native forms cannot consume RSC streams, so they recurse to render the full HTML
-                // page. We bridge the action's 404 state here to ensure the subsequent page render knows
-                // to activate the not-found boundaries.
-                if (actionError === ActionErrorCode.NotFound && !state.isRscRequest) {
-                    markNotFound();
-                }
-                // Build seedData inside the request scope so `renderPage` can read `isNotFound()`.
-                // For non-PPR routes this only needs to run once, but rebuilding is cheap because
-                // module loaders are cached.
-                state.seedData = shouldRenderRscSegment
-                    ? await renderPageSegment(match, attempt.boundaryError)
-                    : state.isRscRequest
-                        ? undefined
-                        : await renderRouteSegments(match, state.routeTree, 
-                        // Native no-JS form submissions execute the action before the main render starts.
-                        // Re-inject unexpected action errors to activate the nearest error boundary
-                        !attempt.boundaryError ? actionThrownError : undefined);
-                const boundaryError = getBoundaryError();
-                let payload;
-                if (state.isActionRscRequest) {
-                    if (returnValue !== undefined) {
-                        payload = { returnValue };
-                    }
-                    else if (formState !== undefined) {
-                        payload = { formState };
-                    }
-                    else if (actionError !== undefined) {
-                        payload = { actionError };
-                    }
-                    else {
-                        throw new Error("Expected an action result, form state, or action error for action RSC response.");
-                    }
-                }
-                else {
-                    if (!state.seedData) {
-                        throw new Error("Expected route seed data for route RSC response.");
-                    }
-                    payload = {
-                        seedData: state.seedData,
-                        routeTree: state.routeTree,
-                        ...(state.routePrediction && { routePrediction: state.routePrediction }),
-                        ...(proxyPatterns && { proxyPatterns }),
-                        ...(formState !== undefined && { formState }),
-                        ...(boundaryError && { error: boundaryError }),
-                    };
-                }
-                const pprSignal = renderContext.ppr?.controller.signal;
-                // During build-time prerendering, pass the PPR abort signal to the RSC stream so it gets
-                // aborted once the shell is captured. The resume phase is skipped at build time, so
-                // without this the RSC stream would hang on unresolved dynamic data. At runtime the
-                // RSC stream must continue to feed the resume phase.
-                const rscOptions = state.isBuildPrerender
-                    ? { temporaryReferences, ...(pprSignal && { signal: pprSignal }) }
-                    : { temporaryReferences };
-                const stream = state.isActionRscRequest
-                    ? renderRsc(payload, rscOptions)
-                    : renderRsc(payload, rscOptions, onNotFound);
-                return await createResponse(state, cacheContext, stream);
-            });
-            break;
-        }
-        catch (error) {
-            if (error instanceof RetryWithBoundaryError) {
-                attempt.activeErrorIndex = error.boundaryIndex;
-                attempt.boundaryError = error.originalError;
-                continue;
-            }
-            if (error instanceof RetryWithNotFoundBoundaryError) {
-                attempt.activeNotFoundIndex = error.boundaryIndex;
-                attempt.notFound = true;
-                continue;
-            }
-            if (error instanceof FallbackRouteError) {
-                return handlePageRoute(state.request, error.fallbackRoute, state.params, state.handleOptions);
-            }
-            throw error;
-        }
-    }
-    return response;
-}

package/dist/handlers/rsc/stream-rsc-payload.d.ts

@@ -1,9 +0,0 @@
-/**
- * Stream RSC payload for ResumeMode.RSC.
- *
- * The client already has the full HTML shell, so we bypass React's HTML renderer and send only
- * RSC data. The closing tags provide a minimal valid HTML document for `injectRSCPayload` to
- * insert the RSC script tags into.
- */
-export declare function streamRSCPayload(rscStream: ReadableStream<Uint8Array>): ReadableStream<Uint8Array>;
-//# sourceMappingURL=stream-rsc-payload.d.ts.map

package/dist/handlers/rsc/stream-rsc-payload.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-rsc-payload.d.ts","sourceRoot":"","sources":["../../../src/handlers/rsc/stream-rsc-payload.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,cAAc,CAAC,UAAU,CAAC,CAW5B"}

package/dist/handlers/rsc/stream-rsc-payload.js

@@ -1,20 +0,0 @@
-import { injectRSCPayload } from "rsc-html-stream/server";
-const closingTagsBytes = new TextEncoder().encode("</body></html>");
-/**
- * Stream RSC payload for ResumeMode.RSC.
- *
- * The client already has the full HTML shell, so we bypass React's HTML renderer and send only
- * RSC data. The closing tags provide a minimal valid HTML document for `injectRSCPayload` to
- * insert the RSC script tags into.
- */
-export function streamRSCPayload(rscStream) {
-    const closingStream = new ReadableStream({
-        start(controller) {
-            controller.enqueue(closingTagsBytes);
-            controller.close();
-        },
-    });
-    // The transform reads the closing tags, waits for RSC data, and emits the RSC payload as script
-    // tags followed by the closing tags.
-    return closingStream.pipeThrough(injectRSCPayload(rscStream));
-}

package/dist/handlers/rsc/types.d.ts

@@ -1,26 +0,0 @@
-import type { HTMLCacheEntry } from "../../lib/cache-storage.js";
-export interface Revalidation {
-    key: string;
-    resolvedParams: Set<string> | null;
-}
-export declare enum CacheLookupKind {
-    NoCache = 0,
-    StaticHit = 1,
-    PprHit = 2,
-    Miss = 3
-}
-export type CacheLookupOutcome = {
-    kind: CacheLookupKind.NoCache;
-} | {
-    kind: CacheLookupKind.StaticHit;
-    response: Response;
-} | {
-    kind: CacheLookupKind.PprHit;
-    entry: HTMLCacheEntry;
-    promotionResolvedParams: Set<string> | null;
-    revalidations: Revalidation[];
-} | {
-    kind: CacheLookupKind.Miss;
-    revalidations: Revalidation[];
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/handlers/rsc/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/handlers/rsc/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEhE,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;CAClC;AAED,oBAAY,eAAe;IAC1B,OAAO,IAAA;IACP,SAAS,IAAA;IACT,MAAM,IAAA;IACN,IAAI,IAAA;CACJ;AAED,MAAM,MAAM,kBAAkB,GAC3B;IAAE,IAAI,EAAE,eAAe,CAAC,OAAO,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACvD;IACA,IAAI,EAAE,eAAe,CAAC,MAAM,CAAA;IAC5B,KAAK,EAAE,cAAc,CAAA;IACrB,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAC3C,aAAa,EAAE,YAAY,EAAE,CAAA;CAC5B,GACD;IACA,IAAI,EAAE,eAAe,CAAC,IAAI,CAAA;IAC1B,aAAa,EAAE,YAAY,EAAE,CAAA;CAC5B,CAAA"}

package/dist/handlers/rsc/types.js

@@ -1,7 +0,0 @@
-export var CacheLookupKind;
-(function (CacheLookupKind) {
-    CacheLookupKind[CacheLookupKind["NoCache"] = 0] = "NoCache";
-    CacheLookupKind[CacheLookupKind["StaticHit"] = 1] = "StaticHit";
-    CacheLookupKind[CacheLookupKind["PprHit"] = 2] = "PprHit";
-    CacheLookupKind[CacheLookupKind["Miss"] = 3] = "Miss";
-})(CacheLookupKind || (CacheLookupKind = {}));

package/dist/handlers/rsc.d.ts

@@ -1,20 +0,0 @@
-import { type CacheLife } from "../lib/cache-context.js";
-import { type Route } from "../lib/route-matcher.js";
-interface HandlePageRouteOptions {
-    /** Whether this is a build-time prerendering call (affects error handling) */
-    isBuildPrerender?: boolean;
-    /** Build-time metadata emitted after prerender behavior is known */
-    onBuildPrerenderMeta?: (meta: BuildPrerenderMeta) => void;
-}
-export type BuildPrerenderMeta = {
-    hasShell: boolean;
-    postponedState?: string;
-    cacheLife?: Omit<CacheLife, "tags">;
-};
-/**
- * Page route handler for RSC rendering.
- * Called by the router after a page route is matched, and during prerendering.
- */
-export declare function handlePageRoute(request: Request, route: Route, params: Record<string, string | string[]>, handleOptions?: HandlePageRouteOptions): Promise<Response>;
-export {};
-//# sourceMappingURL=rsc.d.ts.map

package/dist/handlers/rsc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rsc.d.ts","sourceRoot":"","sources":["../../src/handlers/rsc.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAgCxD,OAAO,EAAmB,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAA;AA2GrE,UAAU,sBAAsB;IAC/B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAA;CACzD;AAED,MAAM,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAuKD;;;GAGG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EACzC,aAAa,CAAC,EAAE,sBAAsB,GACpC,OAAO,CAAC,QAAQ,CAAC,CA6tBnB"}