@rsc-kit/core 0.1.0

package/dist/redirect.js

@@ -0,0 +1,108 @@
+// Redirecting from inside a render.
+//
+//   import { redirect } from '@rsc-kit/core/redirect'
+//
+//   export default async function ProductPage({ slug }) {
+//     const product = await findProduct(slug)
+//     if (!product) redirect('/products')
+//     ...
+//   }
+//
+// The hard part is not throwing — it is that a redirect decided during a
+// render may be decided after the response has already begun. Headers flush
+// early on purpose (see the stream-start invariant), so by the time a
+// component deep in a Suspense boundary changes its mind, the 200 is gone.
+//
+// So there are two windows, and which one a redirect lands in is decided by
+// where it was thrown rather than by anything the caller does:
+//
+//   Before the shell resolves — nothing has been written. The host answers
+//   with a real 3xx, or for a navigation with X-RSC-Redirect, and the browser
+//   never sees the page. This is the window every guard lands in, because a
+//   guard runs above the boundaries.
+//
+//   After the shell resolves — the shell is already on the wire. It holds
+//   layouts and Suspense fallbacks, so no data from the redirecting subtree
+//   has been shown. The location travels to the client instead, which
+//   performs it as an ordinary SPA navigation.
+//
+// Neither window costs a buffered byte. The first exists because the host
+// already awaits the shell before writing anything; the second because React
+// already carries an error digest to the client.
+import { assertSafeRedirect } from './safeUrl.js';
+import { resolveScope } from './revalidate.js';
+import { RedirectSignal } from './redirectDigest.js';
+export { RedirectSignal, isRedirectSignal, redirectDigest, parseRedirectDigest } from './redirectDigest.js';
+/**
+ * One scope, however many copies of this module exist.
+ *
+ * The app's components are bundled into the server bundle and the host is
+ * not, so this module is loaded twice. Two scopes would mean the component
+ * records in one and the host reads the other: the redirect is simply never
+ * honoured, and nothing on either side reports a problem.
+ */
+const SCOPE = Symbol.for('@rsc-kit/core.redirect-scope');
+const globals = globalThis;
+let ready = null;
+function scope() {
+    return globals[SCOPE] ?? null;
+}
+/**
+ * Leave this page for another one.
+ *
+ * Never returns: it throws, which stops the component that called it. Do not
+ * wrap a call in `try`/`catch` without rethrowing what you do not recognise —
+ * swallowing this turns a redirect into a blank region.
+ *
+ * `location` is typed to the routes the build found, so a redirect to a page
+ * that no longer exists stops compiling. Cast with `as Href` when the
+ * destination is computed — remembering where someone was going and sending
+ * them back to it is the usual case.
+ *
+ * Where it is called decides how it is delivered, and the difference matters
+ * for anything that must not be seen. A call above every Suspense boundary is
+ * answered with a status code before a byte is written. A call inside one is
+ * answered after the shell — which holds no data from inside the boundary,
+ * but does hold whatever the layouts above it rendered.
+ */
+export function redirect(location, status = 307) {
+    // Refused here, at the one place every delivery path leads back to. The
+    // destination reaches location.href on the client and an inline script in a
+    // document, and a javascript: url runs in all of them.
+    assertSafeRedirect(location);
+    // A redirect is a 3xx. Anything else produces a response carrying Location
+    // that no browser acts on — the page renders, the redirect silently does not
+    // happen, and nothing says why.
+    if (status < 300 || status > 399) {
+        throw new Error('Not a redirect status: ' + status + '. A redirect is 3xx; 307 preserves the method.');
+    }
+    const store = scope()?.getStore();
+    // First wins. A layout that redirects and a page that also redirects should
+    // land where the outer one said, not wherever finished last.
+    if (store && !store.redirect) {
+        store.redirect = { location, status };
+    }
+    throw new RedirectSignal(location, status);
+}
+/** The redirect asked for during the current render, if any. */
+export function currentRedirect() {
+    return scope()?.getStore()?.redirect ?? null;
+}
+/**
+ * Run a render with somewhere for a redirect to be recorded, and report one.
+ *
+ * `taken()` is read twice by a streaming host: once when the shell resolves,
+ * to answer with a status code, and again when the stream ends, for a
+ * redirect that arrived too late for one.
+ */
+export async function withRedirect(run) {
+    if (!globals[SCOPE]) {
+        ready ??= resolveScope().then((resolved) => {
+            globals[SCOPE] ??= resolved;
+        });
+        await ready;
+    }
+    const slot = { redirect: null };
+    return await scope().run(slot, () => run(() => slot.redirect));
+}
+//# sourceMappingURL=redirect.js.map

package/dist/redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.js","sourceRoot":"","sources":["../src/redirect.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,sDAAsD;AACtD,EAAE;AACF,0DAA0D;AAC1D,8CAA8C;AAC9C,0CAA0C;AAC1C,UAAU;AACV,MAAM;AACN,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,sEAAsE;AACtE,2EAA2E;AAC3E,EAAE;AACF,4EAA4E;AAC5E,+DAA+D;AAC/D,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,qCAAqC;AACrC,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,sEAAsE;AACtE,+CAA+C;AAC/C,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,iDAAiD;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGpD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAa3G;;;;;;;GAOG;AACH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAA;AAExD,MAAM,OAAO,GAAG,UAA8C,CAAA;AAE9D,IAAI,KAAK,GAAyB,IAAI,CAAA;AAEtC,SAAS,KAAK;IACZ,OAAQ,OAAO,CAAC,KAAK,CAAuB,IAAI,IAAI,CAAA;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAc,EAAE,MAAM,GAAG,GAAG;IACnD,wEAAwE;IACxE,4EAA4E;IAC5E,uDAAuD;IACvD,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IAE5B,2EAA2E;IAC3E,6EAA6E;IAC7E,gCAAgC;IAChC,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,MAAM,GAAG,gDAAgD,CACtF,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAA;IAEjC,4EAA4E;IAC5E,6DAA6D;IAC7D,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,KAAK,CAAC,QAAQ,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;IACvC,CAAC;IAED,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;AAC5C,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,QAAQ,IAAI,IAAI,CAAA;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAoD;IAEpD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,KAAK,KAAK,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACzC,OAAO,CAAC,KAAK,CAAC,KAAK,QAA4B,CAAA;QACjD,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,CAAA;IACb,CAAC;IAED,MAAM,IAAI,GAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAErC,OAAO,MAAM,KAAK,EAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;AACjE,CAAC"}

package/dist/redirectDigest.d.ts

@@ -0,0 +1,20 @@
+export interface Redirection {
+    location: string;
+    /**
+     * 307 by default rather than 302: it preserves the method, so a redirect out
+     * of a POST does not silently become a GET of the target.
+     */
+    status: number;
+}
+/** Thrown to stop rendering the subtree that redirected. */
+export declare class RedirectSignal extends Error {
+    readonly location: string;
+    readonly status: number;
+    constructor(location: string, status: number);
+}
+export declare function isRedirectSignal(error: unknown): error is RedirectSignal;
+/** The digest for a redirect, or null for any other error. */
+export declare function redirectDigest(error: unknown): string | null;
+/** The redirect a digest describes, or null if it describes something else. */
+export declare function parseRedirectDigest(digest: unknown): Redirection | null;
+//# sourceMappingURL=redirectDigest.d.ts.map

package/dist/redirectDigest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirectDigest.d.ts","sourceRoot":"","sources":["../src/redirectDigest.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;CACf;AAgBD,4DAA4D;AAC5D,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,QAAQ,EAAE,MAAM,CAAA;IAChC,SAAgB,MAAM,EAAE,MAAM,CAAA;IAE9B,YAAY,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAM3C;CACF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAMxE;AAYD,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAcvE"}

package/dist/redirectDigest.js

@@ -0,0 +1,66 @@
+// What a redirect is, and how it survives every boundary it has to cross.
+//
+// Its own module because three graphs need it and none of them can import the
+// others' halves: the app bundle (where a component calls redirect()), the
+// engine (which turns it into a digest), and the browser (which performs it).
+// Nothing here imports anything, so all three can have it.
+/**
+ * The mark that says an error is a redirect.
+ *
+ * A property rather than `instanceof`, for the reason this project keeps
+ * running into: the app's components are bundled separately from the engine
+ * that renders them, so each gets its own copy of this module and its own copy
+ * of the class. `instanceof` compares identity across that seam and is simply
+ * false — the redirect renders as an unhandled error, and the only clue is
+ * that the page went blank instead of moving.
+ *
+ * Symbol.for, so the two copies agree on the key as well as the value.
+ */
+const MARK = Symbol.for('@rsc-kit/core.redirect-signal');
+/** Thrown to stop rendering the subtree that redirected. */
+export class RedirectSignal extends Error {
+    location;
+    status;
+    constructor(location, status) {
+        super(`Redirect to ${location}`);
+        this.name = 'RedirectSignal';
+        this.location = location;
+        this.status = status;
+        this[MARK] = true;
+    }
+}
+export function isRedirectSignal(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        error[MARK] === true);
+}
+/**
+ * The prefix that carries a redirect inside React's error digest.
+ *
+ * React replaces a server error's message with an opaque digest in production,
+ * and the digest is the one part it is guaranteed to transmit. A redirect
+ * decided after the shell has no header left to travel in — the status line is
+ * already sent — so it travels here.
+ */
+const PREFIX = 'RSC_REDIRECT;';
+/** The digest for a redirect, or null for any other error. */
+export function redirectDigest(error) {
+    if (!isRedirectSignal(error))
+        return null;
+    return `${PREFIX}${error.status};${error.location}`;
+}
+/** The redirect a digest describes, or null if it describes something else. */
+export function parseRedirectDigest(digest) {
+    if (typeof digest !== 'string' || !digest.startsWith(PREFIX))
+        return null;
+    const rest = digest.slice(PREFIX.length);
+    const separator = rest.indexOf(';');
+    if (separator === -1)
+        return null;
+    const status = Number(rest.slice(0, separator));
+    const location = rest.slice(separator + 1);
+    if (!location)
+        return null;
+    return { location, status: Number.isFinite(status) ? status : 307 };
+}
+//# sourceMappingURL=redirectDigest.js.map

package/dist/redirectDigest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirectDigest.js","sourceRoot":"","sources":["../src/redirectDigest.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,2DAA2D;AAW3D;;;;;;;;;;;GAWG;AACH,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAA;AAExD,4DAA4D;AAC5D,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvB,QAAQ,CAAQ;IAChB,MAAM,CAAQ;IAE9B,YAAY,QAAgB,EAAE,MAAc;QAC1C,KAAK,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CACnB;QAAC,IAA2C,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC5D,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,IAAI,CAAC,KAAK,IAAI,CAClD,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,eAAe,CAAA;AAE9B,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEzC,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAA;AACrD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IAEzE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAEnC,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAEjC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAA;IAE1C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;AACrE,CAAC"}

package/dist/request.d.ts

@@ -0,0 +1,93 @@
+/** What a host can supply: a real Request, or the parts of one. */
+export type RequestLike = Request | {
+    url: string;
+    headers: Record<string, string>;
+} | null;
+/**
+ * The request's headers.
+ *
+ * Empty during a build, where there is no request: the page is marked as
+ * needing one instead, and rendered on demand rather than frozen.
+ */
+export declare function headers(): Promise<Headers>;
+/** How a cookie should be written. The names browsers use. */
+export interface CookieOptions {
+    path?: string;
+    domain?: string;
+    maxAge?: number;
+    expires?: Date;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+    partitioned?: boolean;
+}
+export interface Cookies {
+    get(name: string): string | undefined;
+    has(name: string): boolean;
+    getAll(): Record<string, string>;
+    /**
+     * Write one on the response.
+     *
+     * Only from a server action, which has a response of its own that has not
+     * been sent. A render has already flushed its headers by the time a
+     * component runs — that is what makes the first paint fast — so this throws
+     * there rather than appearing to work.
+     */
+    set(name: string, value: string, options?: CookieOptions): void;
+    /** Write one that expires immediately. Same rule about where. */
+    delete(name: string, options?: CookieOptions): void;
+}
+/** Kept for the name it had when it could only read. */
+export type ReadonlyCookies = Cookies;
+export declare function responseHeaders(): Headers;
+/**
+ * Run a request with a response that can still be changed, and take what was
+ * put on it.
+ *
+ * `seal()` is called by the host the moment it builds the Response, so
+ * anything set afterwards is refused instead of silently going nowhere.
+ */
+export declare function withResponseDraft<T>(run: (draft: {
+    taken: () => Headers;
+    seal: () => void;
+}) => Promise<T>): Promise<T>;
+/** `name=value; Path=/; HttpOnly` — the header a browser expects. */
+export declare function serializeCookie(cookie: {
+    name: string;
+    value: string;
+    options: CookieOptions;
+}): string;
+export declare function cookies(): Promise<Cookies>;
+/**
+ * The whole request, for a host-specific need the accessors do not cover.
+ *
+ * Null on a host that forwards only the parts — the worker behind Laravel has
+ * a socket, not a request. Use headers() and cookies(), which work everywhere.
+ */
+export declare function request(): Promise<Request | null>;
+/** The url this request was made to, whichever way the host supplied it. */
+export declare function url(): Promise<string | null>;
+/**
+ * Run one request with its headers readable.
+ *
+ * `null` is the build: a scope with nothing in it, so a page that reads is
+ * caught rather than silently frozen holding whatever the machine that built
+ * it happened to send.
+ */
+export declare function withRequest<T>(from: RequestLike, run: () => Promise<T>): Promise<T>;
+/**
+ * Whether anything read the request during the scope that is open.
+ *
+ * For the prerenderer, which opens one with no request and asks afterwards.
+ */
+export declare function requestWasRead(): boolean;
+/**
+ * The query string, as a page receives it.
+ *
+ * Derived from the request rather than passed down the render, so no host has
+ * to forward it separately — and so it suspends during a build for the same
+ * reason every other read does. A frozen page cannot know the query it will be
+ * asked for.
+ */
+export declare function searchParams(): Promise<URLSearchParams>;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAiCA,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAAA;AAsD3F;;;;;GAKG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAIhD;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;IACpC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;;;;;OAOG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC/D,iEAAiE;IACjE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CACpD;AAED,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAA;AAoGrC,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,GAAG,EAAE,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,KAAK,OAAO,CAAC,CAAC,CAAC,GACrE,OAAO,CAAC,CAAC,CAAC,CAmBZ;AAgBD,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAAG,MAAM,CAkDvG;AAED,wBAAsB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAqBhD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAIvD;AAED,4EAA4E;AAC5E,wBAAsB,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIlD;AA4BD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAmBzF;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAI7D"}

package/dist/request.js

@@ -0,0 +1,308 @@
+// Reading the request from inside a render.
+//
+//   import { headers, cookies } from '@rsc-kit/core/request'
+//
+//   export default async function middleware() {
+//     const locale = cookies().get('locale') ?? negotiate(headers().get('accept-language'))
+//     if (!locale) redirect('/en')
+//   }
+//
+// Server components have no arguments beyond their props, and middleware has
+// none at all, so without this an app on a JavaScript host cannot see a header
+// — no locale negotiation, no subdomain, no cookie. The Laravel host escaped
+// that through rpc(), because PHP has the request; this is the same thing for
+// everyone else.
+//
+// Read-only on purpose. Setting a cookie means writing a response header, and
+// by the time a component renders the shell may already have been flushed — an
+// API that appears to set one and silently does not is worse than not having
+// it. Set them in the host, which owns the response.
+//
+// Asynchronous on purpose too, and not for ergonomics. A build has no request,
+// so a read there suspends and never settles — which is the same thing the
+// prerender probe does to a host call. Anything still waiting when the probe's
+// budget expires becomes a fallback in the frozen shell, so a read inside a
+// Suspense boundary leaves the shell frozen and makes only that boundary
+// dynamic. Reading synchronously could only mark the whole route dynamic,
+// because there would be nothing to suspend on.
+//
+// Scoped to the request, on the same store cache() uses. Two requests in
+// flight cannot see each other's headers.
+import { resolveScope } from './revalidate.js';
+const SCOPE = Symbol.for('@rsc-kit/core.request-scope');
+const globals = globalThis;
+let ready = null;
+function scope() {
+    return globals[SCOPE] ?? null;
+}
+function slot() {
+    const store = scope()?.getStore();
+    if (!store) {
+        throw new Error('No request in scope. headers() and cookies() are for a render — middleware, a layout, ' +
+            'a page — and there is nothing to read outside one.');
+    }
+    store.read = true;
+    return store;
+}
+/**
+ * The request's headers.
+ *
+ * Empty during a build, where there is no request: the page is marked as
+ * needing one instead, and rendered on demand rather than frozen.
+ */
+export async function headers() {
+    const store = slot();
+    return store.request ? store.headers : never();
+}
+const DRAFT = Symbol.for('@rsc-kit/core.response-draft');
+let draftReady = null;
+function draft() {
+    return globals[DRAFT] ?? null;
+}
+/** The open draft, or an explanation of why there is not one. */
+function writable(what) {
+    const open = draft()?.getStore();
+    if (!open) {
+        throw new Error(`${what} needs a response that has not been sent. Middleware and server actions have one; ` +
+            'a script outside a request does not.');
+    }
+    if (open.sealed) {
+        throw new Error(`${what} was called after the response had been sent. Headers go out before the render ` +
+            'starts — that is what makes the first paint fast — so set them in middleware, which ' +
+            'runs before it.');
+    }
+    return open;
+}
+/**
+ * Headers to put on the answer.
+ *
+ * Mutate it as you would any Headers. `append` is the one to reach for when a
+ * header may legitimately appear twice; `set` replaces.
+ */
+/**
+ * The draft's headers, refusing writes once the response has gone.
+ *
+ * A proxy rather than the Headers itself: returning the live object means code
+ * that captured it before the response was built can go on mutating a thing
+ * nobody will read. Nothing in this package does that — the host copies the
+ * headers onto the response the instant it seals — but "safe because of the
+ * order two other functions happen to run in" is not a property, and an app
+ * holding the object across an await would find writes silently doing nothing.
+ */
+function sealable(draft) {
+    const guard = (method) => (...args) => {
+        writable('responseHeaders()');
+        return draft.headers[method](...args);
+    };
+    const proxy = new Proxy(draft.headers, {
+        get(target, property, receiver) {
+            if (property === 'set' || property === 'append' || property === 'delete') {
+                return guard(property);
+            }
+            // A maplike forEach passes the object it was called on as the third
+            // callback argument, and binding to the target makes that the raw
+            // Headers — a live, unguarded reference handed out by the very method
+            // meant to be read-only. Substituted for the proxy so there is no way
+            // through.
+            if (property === 'forEach') {
+                return (fn, thisArg) => target.forEach((value, key) => fn.call(thisArg, value, key, proxy));
+            }
+            const value = Reflect.get(target, property, receiver);
+            return typeof value === 'function' ? value.bind(target) : value;
+        },
+    });
+    return proxy;
+}
+export function responseHeaders() {
+    return sealable(writable('responseHeaders()'));
+}
+/**
+ * Run a request with a response that can still be changed, and take what was
+ * put on it.
+ *
+ * `seal()` is called by the host the moment it builds the Response, so
+ * anything set afterwards is refused instead of silently going nowhere.
+ */
+export async function withResponseDraft(run) {
+    if (!globals[DRAFT]) {
+        draftReady ??= resolveScope().then((resolved) => {
+            globals[DRAFT] ??= resolved;
+        });
+        await draftReady;
+    }
+    const open = { headers: new Headers(), sealed: false };
+    return await draft().run(open, () => run({
+        taken: () => open.headers,
+        seal: () => {
+            open.sealed = true;
+        },
+    }));
+}
+/**
+ * A cookie name, as RFC 6265 defines one: a token, so no separators at all.
+ *
+ * Checked rather than escaped because there is no escaping — a name is not a
+ * quoted string. An app that derives one from user input (`pref_${key}`) would
+ * otherwise let that input close the pair and open another: a name of
+ * `session=attacker; Path=/; HttpOnly; x` serializes to a header whose *first*
+ * pair is a session cookie the caller chose, and the browser reads the first.
+ */
+const COOKIE_NAME = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+/** No separator may appear in an attribute either, for the same reason. */
+const COOKIE_ATTRIBUTE = /[;,\r\n]/;
+/** `name=value; Path=/; HttpOnly` — the header a browser expects. */
+export function serializeCookie(cookie) {
+    if (!COOKIE_NAME.test(cookie.name)) {
+        throw new Error(`Not a usable cookie name: ${JSON.stringify(cookie.name)}. ` +
+            'A name is a token — letters, digits and !#$%&\'*+-.^_`|~ — with no spaces, ' +
+            'semicolons or equals signs. Nothing escapes them, so one cannot be encoded around.');
+    }
+    if (cookie.options.sameSite !== undefined) {
+        const value = String(cookie.options.sameSite).toLowerCase();
+        if (value !== 'strict' && value !== 'lax' && value !== 'none') {
+            throw new Error(`Not a SameSite value: ${JSON.stringify(cookie.options.sameSite)}. ` +
+                'It is written into the header as given, so anything else becomes further attributes.');
+        }
+    }
+    for (const [attribute, value] of [
+        ['path', cookie.options.path],
+        ['domain', cookie.options.domain],
+        // Trusted because it is typed as a Date — but a cast reaches this, and the
+        // result lands in the header verbatim like the others.
+        ['expires', cookie.options.expires?.toUTCString()],
+    ]) {
+        if (typeof value === 'string' && COOKIE_ATTRIBUTE.test(value)) {
+            throw new Error(`The cookie ${attribute} ${JSON.stringify(value)} contains a separator. ` +
+                'It would be read as further attributes rather than as part of this one.');
+        }
+    }
+    const parts = [`${cookie.name}=${encodeURIComponent(cookie.value)}`];
+    const o = cookie.options;
+    if (o.maxAge !== undefined)
+        parts.push(`Max-Age=${Math.floor(o.maxAge)}`);
+    if (o.expires)
+        parts.push(`Expires=${o.expires.toUTCString()}`);
+    // Defaulted, because a cookie without one is scoped to the path that set it
+    // — a session written by POST /_rsc/action would not be sent for any page.
+    parts.push(`Path=${o.path ?? '/'}`);
+    if (o.domain)
+        parts.push(`Domain=${o.domain}`);
+    if (o.sameSite)
+        parts.push(`SameSite=${o.sameSite[0].toUpperCase()}${o.sameSite.slice(1)}`);
+    if (o.secure)
+        parts.push('Secure');
+    if (o.httpOnly)
+        parts.push('HttpOnly');
+    if (o.partitioned)
+        parts.push('Partitioned');
+    return parts.join('; ');
+}
+export async function cookies() {
+    const parsed = parseCookies((await headers()).get('cookie') ?? '');
+    const write = (name, value, options = {}) => {
+        // Appended, never set: several cookies on one response are several
+        // Set-Cookie headers, and replacing would leave only the last.
+        writable('cookies().set()').headers.append('Set-Cookie', serializeCookie({ name, value, options }));
+    };
+    return {
+        get: (name) => parsed[name],
+        has: (name) => name in parsed,
+        getAll: () => ({ ...parsed }),
+        set: write,
+        // Expired rather than removed: a browser drops a cookie when it is told
+        // one has already passed, and there is no other way to say it.
+        delete: (name, options = {}) => write(name, '', { ...options, maxAge: 0 }),
+    };
+}
+/**
+ * The whole request, for a host-specific need the accessors do not cover.
+ *
+ * Null on a host that forwards only the parts — the worker behind Laravel has
+ * a socket, not a request. Use headers() and cookies(), which work everywhere.
+ */
+export async function request() {
+    const store = slot();
+    return store.request ? store.original : never();
+}
+/** The url this request was made to, whichever way the host supplied it. */
+export async function url() {
+    const store = slot();
+    return store.request ? store.url : never();
+}
+function parseCookies(header) {
+    const out = {};
+    for (const part of header.split(';')) {
+        const eq = part.indexOf('=');
+        if (eq === -1)
+            continue;
+        const name = part.slice(0, eq).trim();
+        if (!name)
+            continue;
+        // Decoded because that is how they were written. A malformed escape is
+        // left as it arrived rather than throwing the render away.
+        const raw = part.slice(eq + 1).trim();
+        try {
+            out[name] = decodeURIComponent(raw);
+        }
+        catch {
+            out[name] = raw;
+        }
+    }
+    return out;
+}
+/**
+ * Run one request with its headers readable.
+ *
+ * `null` is the build: a scope with nothing in it, so a page that reads is
+ * caught rather than silently frozen holding whatever the machine that built
+ * it happened to send.
+ */
+export async function withRequest(from, run) {
+    if (!globals[SCOPE]) {
+        ready ??= resolveScope().then((resolved) => {
+            globals[SCOPE] ??= resolved;
+        });
+        await ready;
+    }
+    const isRequest = from instanceof Request;
+    const store = {
+        request: from !== null,
+        url: from ? (isRequest ? from.url : from.url) : null,
+        headers: from ? (isRequest ? from.headers : new Headers(from.headers)) : new Headers(),
+        original: isRequest ? from : null,
+        read: false,
+    };
+    return await scope().run(store, run);
+}
+/**
+ * A promise that never settles, so the caller suspends.
+ *
+ * What a read does during a build. React treats it exactly as it treats a host
+ * call that never answers: the component suspends, its Suspense fallback goes
+ * into the shell, and the probe's budget decides the rest.
+ */
+function never() {
+    slot().read = true;
+    return new Promise(() => { });
+}
+/**
+ * Whether anything read the request during the scope that is open.
+ *
+ * For the prerenderer, which opens one with no request and asks afterwards.
+ */
+export function requestWasRead() {
+    return scope()?.getStore()?.read ?? false;
+}
+/**
+ * The query string, as a page receives it.
+ *
+ * Derived from the request rather than passed down the render, so no host has
+ * to forward it separately — and so it suspends during a build for the same
+ * reason every other read does. A frozen page cannot know the query it will be
+ * asked for.
+ */
+export async function searchParams() {
+    const from = await url();
+    return from ? new URL(from).searchParams : new URLSearchParams();
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

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