@solidjs/web 2.0.0-rc.4 → 2.0.0-rc.6

package/types/server-functions/shared.d.ts

@@ -8,19 +8,22 @@ import { JSONCodecOptions } from "../serializer-decode.js";
  * HTTP handler. Integrations decoding passthrough responses themselves (no
  * registered consumer) see this shape from `decodeResponse`. The top level
  * is reserved for the protocol — integration payload lives entirely under
- * `data`, which can be any codec-serializable value.
+ * `data`, the envelope keyed by source id (the unnamed registration's
+ * slice rides under the reserved id "true"); each slice can be any
+ * codec-serializable value.
  */
 export interface SingleFlightPayload<T = unknown, D = unknown> {
     /** The server function's return (or thrown) value. */
     value: T;
-    /** The integration-produced data payload. */
+    /** The integration-produced data payload, keyed by source id. */
     data: D;
 }
 /**
  * Envelope context delivered alongside single-flight data: the transport
- * response, whose headers carry the integration metadata (`Location` for
- * redirect-with-data, `X-Revalidate` keys) and status. The body is already
- * consumed — read `data` and `value` from the delivery, not from here.
+ * response, whose headers carry the integration metadata (the redirect
+ * carrier for redirect-with-data, `X-Revalidate` keys) and status. The
+ * body is already consumed — read `data` and `value` from the delivery,
+ * not from here.
  */
 export interface FlightDataContext {
     /** The HTTP response the data arrived on (metadata only). */
@@ -131,11 +134,27 @@ export interface ServerFunctionRPC {
 export type BodyFormatValue = (typeof BodyFormat)[keyof typeof BodyFormat];
 export declare function configureServerFunctionsCodec(codec: JSONCodecOptions | undefined): void;
 export declare function getServerFunctionsCodec(): JSONCodecOptions | undefined;
+/**
+ * Validates a flight data source id (both registration halves share the
+ * rule): ids travel the `SINGLE_FLIGHT_HEADER` as a comma-separated list,
+ * so they cannot be empty or contain commas, and "true" is reserved for
+ * the unnamed registration.
+ *
+ * Transport building block; not meant for hand-written code.
+ * @internal
+ */
+export declare function assertFlightSource(source: string): void;
 export declare function subscribeFlightData<D = unknown>(consumer: FlightDataConsumer<D>): () => void;
-export declare function getFlightDataConsumer(): FlightDataConsumer | undefined;
+export declare function subscribeFlightData<D = unknown>(source: string, consumer: FlightDataConsumer<D>): () => void;
+export declare function getFlightDataConsumer(source?: string): FlightDataConsumer | undefined;
+export declare function getFlightDataSourceIds(): string[];
 export declare function frameAddress(id: string, args?: readonly unknown[]): string;
 export declare function serverFunctionAddress(endpoint: string, id: string): string;
-export declare function parseServerFunctionAddress(pathname: string, endpoint: string): string | null;
+export declare function serverFunctionDataAddress(endpoint: string, id: string): string;
+export declare function parseServerFunctionAddress(pathname: string, endpoint: string): {
+    id: string;
+    data: boolean;
+} | null;
 /**
  * Response header marking a thrown server-function error. The value is the
  * error's message (the structured error itself travels in the body); `"true"`
@@ -151,6 +170,51 @@ export declare function decodeErrorHeaderValue(value: string): string;
 export declare const INSTANCE_HEADER = "X-Server-Function-Instance";
 /** Header carrying the body format tag (a `BodyFormat` value). */
 export declare const BODY_FORMAT_HEADER = "X-Server-Function-Format";
+/**
+ * Header labelling the unknown-id 404: the address was well-formed but its
+ * id is not registered in the deployment that answered (#3110). This is the
+ * ordinary shape of version skew — a tab holding the previous build's ids
+ * across a deploy — and the label is what lets an integration recover
+ * (e.g. reload the document) instead of surfacing a generic failed call.
+ * Nothing distinguishes it otherwise: a CDN 404 and a skew 404 look alike.
+ */
+export declare const UNKNOWN_HEADER = "X-Server-Function-Unknown";
+/**
+ * Header carrying a redirect to scripted callers. fetch FOLLOWS redirect
+ * statuses before the transport can read them, so a scripted answer masks
+ * the 3xx to 200 and this header carries what the mask erases: the author's
+ * status and the target RESOLVED against the request url — exactly the
+ * meaning HTTP assigns the `Location` a form post would have received.
+ * Value: `<status> <absolute-url>`, decode with `decodeRedirectHeaderValue`.
+ *
+ * Carrying the resolved absolute form is the point (#3102, #3107): the
+ * reader never guesses navigation strategy from how the author spelled the
+ * target — `redirect("/")` and `redirect(new URL("/", url).href)` arrive
+ * identical by construction, and same-origin vs cross-origin is a real URL
+ * comparison, not a `startsWith("http")` coin toss. `Location` itself never
+ * rides a masked answer: on a 200 it has no HTTP meaning, and it collided
+ * with authored Locations on statuses that forward (a 201's created-at is
+ * data, not navigation).
+ */
+export declare const REDIRECT_HEADER = "X-Server-Function-Redirect";
+/**
+ * Decodes a `REDIRECT_HEADER` value into the author's status and the
+ * resolved absolute target. Integration plumbing for readers of the header
+ * (routers); the wire format is the runtime's own, not a contract to parse
+ * by hand.
+ *
+ * The documented output — a resolved ABSOLUTE http(s) target and a redirect
+ * status — is enforced, not assumed (#3175): the absoluteness used to be a
+ * property of the server having resolved it, and a hostile or buggy peer
+ * could ride a `javascript:` target straight into the `location.href =
+ * decoded.url` an integration reasonably writes. A value that does not
+ * parse as an absolute http(s) url, or whose status is not one the runtime
+ * masks, decodes to `undefined` — the same answer a missing header gives.
+ */
+export declare function decodeRedirectHeaderValue(value: string | null | undefined): {
+    status: number;
+    url: string;
+} | undefined;
 /**
  * Header driving the single-flight protocol on both legs: on the request it
  * opts the call into flight-data collection (the integration sends it on
@@ -200,15 +264,14 @@ export declare class ChunkReader {
         value: string;
     }>;
     drain(interpret: any): Promise<void>;
-} /**
- * Serializes a value as a stream of length-prefixed SerovalNode chunks.
- * Async values (promises, streams) keep the stream open until they settle,
- * so one connection carries incremental results. Codec options must match
- * the deserializing peer.
- *
- * Transport building block; not meant for hand-written code.
+}
+/**
+ * Encodes a terminal error-trailer frame payload. The value is expected to
+ * be already sanitized by the caller; only `name` and `message` travel.
+ * Transport wire detail; not meant for hand-written code.
  * @internal
  */
+export declare function encodeErrorTrailer(error: unknown): string;
 export declare function serializeStream(value: unknown, codecOptions?: JSONCodecOptions): ReadableStream<Uint8Array>;
 export declare function serializeString(value: unknown, codecOptions?: JSONCodecOptions): Promise<string>;
 export declare function deserializeStream<T = unknown>(source: Request | Response, codecOptions?: JSONCodecOptions): Promise<T>;

package/types/server-mock.d.ts

@@ -1,10 +1,23 @@
 import type { RequestEvent, RequestEventLocals, ResponseStub } from "./client.js";
+import type { JSX } from "./jsx.js";
+/** An explicit `<link rel="preload">` emitted by the SSR asset pipeline. */
+export type PreloadLink = {
+    href: string;
+    as: JSX.HTMLPreloadAs;
+    type?: string;
+    crossorigin?: JSX.HTMLCrossorigin;
+    integrity?: string;
+    referrerpolicy?: JSX.HTMLReferrerPolicy;
+    fetchpriority?: JSX.HTMLFetchPriority;
+    media?: string;
+};
 /** Static asset manifest produced by a build (e.g. parsed Vite manifest.json). */
 export type AssetManifest = Record<string, {
     file: string;
     css?: string[];
     isEntry?: boolean;
     imports?: string[];
+    preloads?: PreloadLink[];
 }> & {
     _base?: string;
 };
@@ -17,6 +30,7 @@ export type InlineStyleAsset = {
 export type ResolvedAssets = {
     js: string[];
     css: (string | InlineStyleAsset)[];
+    preloads?: PreloadLink[];
 };
 /**
  * Resolver form of the manifest option — the primitive a dev server
@@ -24,8 +38,9 @@ export type ResolvedAssets = {
  * normalized into a sync resolver internally). `resolve` may return a
  * promise (async resolvers require streaming rendering); CSS entries may be
  * URL strings (emitted as load-gated `<link>` tags) or inline-style
- * descriptors (emitted as `<style>` tags). A bare `resolve`-shaped function
- * is accepted as shorthand for `{ resolve }`.
+ * descriptors (emitted as `<style>` tags), and `preloads` carries explicit
+ * preload links selected by the integration. A bare `resolve`-shaped
+ * function is accepted as shorthand for `{ resolve }`.
  */
 export type AssetResolver = {
     resolve(key: string): ResolvedAssets | null | undefined | Promise<ResolvedAssets | null | undefined>;

package/types/server.d.ts

@@ -5,12 +5,24 @@ export { clearFlashCookie, hasFlashCookie } from "./cookies.js";
 export { getServerFunctionMetadata, getServerFunctionRPC, isServerFunction } from "./server-functions/registry.js";
 import { JSX } from "./jsx.js";
 import { SerializerPlugin } from "./serializer-decode.js";
+/** An explicit `<link rel="preload">` emitted by the SSR asset pipeline. */
+export type PreloadLink = {
+    href: string;
+    as: JSX.HTMLPreloadAs;
+    type?: string;
+    crossorigin?: JSX.HTMLCrossorigin;
+    integrity?: string;
+    referrerpolicy?: JSX.HTMLReferrerPolicy;
+    fetchpriority?: JSX.HTMLFetchPriority;
+    media?: string;
+};
 /** Static asset manifest produced by a build (e.g. parsed Vite manifest.json). */
 export type AssetManifest = Record<string, {
     file: string;
     css?: string[];
     isEntry?: boolean;
     imports?: string[];
+    preloads?: PreloadLink[];
 }> & {
     _base?: string;
 };
@@ -23,6 +35,7 @@ export type InlineStyleAsset = {
 export type ResolvedAssets = {
     js: string[];
     css: (string | InlineStyleAsset)[];
+    preloads?: PreloadLink[];
 };
 /**
  * Resolver form of the manifest option — the primitive a dev server
@@ -30,8 +43,9 @@ export type ResolvedAssets = {
  * normalized into a sync resolver internally). `resolve` may return a
  * promise (async resolvers require streaming rendering); CSS entries may be
  * URL strings (emitted as load-gated `<link>` tags) or inline-style
- * descriptors (emitted as `<style>` tags). A bare `resolve`-shaped function
- * is accepted as shorthand for `{ resolve }`.
+ * descriptors (emitted as `<style>` tags), and `preloads` carries explicit
+ * preload links selected by the integration. A bare `resolve`-shaped
+ * function is accepted as shorthand for `{ resolve }`.
  */
 export type AssetResolver = {
     resolve(key: string): ResolvedAssets | null | undefined | Promise<ResolvedAssets | null | undefined>;

package/types-cjs/client.d.cts

@@ -136,7 +136,7 @@ export declare function claimElement<T extends Element>(node: T): T;
 export declare function setAttribute(node: Element, name: string, value: string): void;
 export declare function setAttributeNS(node: Element, namespace: string, name: string, value: string): void;
 export declare function className(node: Element, value: JSX.ClassValue, prev?: JSX.ClassValue): void;
-export declare function addEvent(node: Element, name: string, handler: EventListener | EventListenerObject | (EventListenerObject & AddEventListenerOptions), delegate: boolean): void;
+export declare function addEvent(node: Element, name: string, handler: EventListener | EventListenerObject | (EventListenerObject & AddEventListenerOptions), delegate: boolean): EventListener | EventListenerObject | void;
 export declare function style(node: Element, value: {
     [k: string]: string;
 }, prev?: {
@@ -149,6 +149,7 @@ export declare function applyRef<T extends Element = Element>(r: ((element: NoIn
 export declare function ref(fn: () => ((element: Element) => void) | ((element: Element) => void)[], element: Element): void;
 /** Compiler-emitted primitive; not for hand-written code. @internal */
 export declare function scope<T extends () => any>(fn: T): T;
+export declare function getInsertionParent(): Node | undefined;
 export declare function installHydrationRuntime(): void;
 /**
  * Compiler-emitted primitive; not for hand-written code.

package/types-cjs/constants.d.cts

@@ -15,4 +15,6 @@ declare const Namespaces: Record<string, string>;
 declare const VoidElements: Set<string>;
 declare const RawTextElements: Set<string>;
 declare const DOMElements: Set<string>;
-export { DOMWithState, ChildProperties, DelegatedEvents, SVGElements, MathMLElements, VoidElements, RawTextElements, Namespaces, DOMElements, $$SLOT, $$HOST };
+declare const COMPOSED_BODY_FRAMING: ReadonlySet<string>;
+declare function isHttpNavigationTarget(target: string): boolean;
+export { DOMWithState, ChildProperties, DelegatedEvents, SVGElements, MathMLElements, VoidElements, RawTextElements, Namespaces, DOMElements, $$SLOT, $$HOST, COMPOSED_BODY_FRAMING, isHttpNavigationTarget };

package/types-cjs/cookies.d.cts

@@ -13,6 +13,12 @@ export interface CookieOptions {
     secure?: boolean;
     /** Cookie `SameSite` attribute, any case. */
     sameSite?: "lax" | "strict" | "none" | "Lax" | "Strict" | "None";
+    /**
+     * Emit the `Partitioned` attribute (CHIPS): a third-party cookie keyed to
+     * the top-level site it was set under — the only third-party cookie that
+     * keeps working as browsers finish removing the rest. Requires `secure`.
+     */
+    partitioned?: boolean;
 }
 /**
  * Parses a `Cookie` request header into a name → value map. Names and
@@ -25,20 +31,6 @@ export interface CookieOptions {
  * `parseCookieHeader(event.request.headers.get("cookie"))`.
  */
 export declare function parseCookieHeader(header: string | null | undefined): Record<string, string>;
-/**
- * Serializes a cookie to a `Set-Cookie` header value. The name and value
- * are `encodeURIComponent`-encoded (the parser decodes symmetrically);
- * `path` defaults to `/` — the only defaulted attribute — and every other
- * attribute is emitted exactly when the caller asked for it: `domain`,
- * `maxAge` (seconds, truncated to an integer), `expires` (a `Date`),
- * `httpOnly`, `secure`, `sameSite` (`"lax" | "strict" | "none"`, any
- * case).
- *
- * The write half of the platform gap — the blessed response-cookie write
- * is `event.response.headers.append("set-cookie", serializeCookie(name,
- * value, options))`, which every head materialization path carries to the
- * wire entry-by-entry.
- */
 export declare function serializeCookie(name: string, value: string, options?: CookieOptions): string;
 export declare const FLASH_COOKIE = "flash";
 /** Whether a Cookie header carries a flash cookie (readable or not). */

package/types-cjs/frames/frame-client.d.cts

@@ -59,6 +59,10 @@ export type FrameChunk = {
         content?: string;
         attrs?: Record<string, string>;
     }[];
+    preloads?: {
+        href: string;
+        attrs: Record<string, string>;
+    }[];
 } | {
     type: "slot";
     id: string;

package/types-cjs/frames/serializer-decode.d.cts

@@ -105,6 +105,18 @@ export interface JSONCodecOptions {
     disabledFeatures?: number;
     /** Maximum parse/deserialize depth. Defaults to 64. Must match on both peers. */
     depthLimit?: number;
+    /**
+     * Whether serialized `Error`s carry their `.stack` — server file paths,
+     * internal function names, the shape of the deployment — to the peer.
+     * Defaults to `NODE_ENV === "development"`, but that signal describes the
+     * PROCESS, not the artifact: a production build running with
+     * `NODE_ENV=development` (a base image, a stray dotenv) ships stacks to
+     * the wire — including for errors marked safe with `markSafeError`, whose
+     * stacks traverse application code (#3152). Set `false` to pin production
+     * disclosure regardless of the ambient variable. Encode-side only; the
+     * decode side is always permissive, so it need not match peers.
+     */
+    serializeErrorStacks?: boolean;
 }
 /**
  * A resident, response-scoped decode table over the keyed JSON codec: apply
@@ -142,10 +154,11 @@ export declare const DEFAULT_WEB_PLUGINS: any; /**
  * Integration-facing; may change (see the entry banner).
  */
 export declare function resolveSerializerPlugins(customPlugins?: SerializerPlugin[]): SerializerPlugin[];
-export declare function resolveCodecOptions({ plugins, disabledFeatures, depthLimit }?: JSONCodecOptions): {
+export declare function resolveCodecOptions({ plugins, disabledFeatures, depthLimit, serializeErrorStacks }?: JSONCodecOptions): {
     plugins: SerializerPlugin<any, any>[];
     disabledFeatures: any;
     depthLimit: number;
+    serializeErrorStacks: boolean;
 }; /**
  * Creates the decoding counterpart of `serializeJSON`. Cross-references
  * between chunks resolve through state shared across calls, so all chunks

package/types-cjs/frames/serializer.d.cts

@@ -19,6 +19,13 @@ export interface WebSerializerOptions {
      * any override — serialized stacks leak server paths to the client.
      */
     disabledFeatures?: number;
+    /**
+     * Whether serialized `Error`s carry their `.stack`. Defaults to
+     * `NODE_ENV === "development"`; set `false` to pin production disclosure
+     * to the deployment rather than the ambient variable (#3152 — see
+     * `JSONCodecOptions.serializeErrorStacks`).
+     */
+    serializeErrorStacks?: boolean;
     /** Extra plugins, composed ahead of `DEFAULT_WEB_PLUGINS`. */
     plugins?: SerializerPlugin[];
     /** Receives each emitted script chunk. */

package/types-cjs/jsx.d.cts

@@ -1080,6 +1080,7 @@ export namespace JSX {
   type HTMLFormEncType = "application/x-www-form-urlencoded" | "multipart/form-data" | "text/plain";
   type HTMLFormMethod = "post" | "get" | "dialog";
   type HTMLCrossorigin = "anonymous" | "use-credentials" | EnumeratedAcceptsEmpty;
+  type HTMLFetchPriority = "high" | "low" | "auto";
   type HTMLReferrerPolicy =
     | "no-referrer"
     | "no-referrer-when-downgrade"
@@ -1105,19 +1106,8 @@ export namespace JSX {
     | "allow-top-navigation"
     | "allow-top-navigation-by-user-activation"
     | "allow-top-navigation-to-custom-protocols";
-  type HTMLLinkAs =
-    | "audio"
-    | "document"
-    | "embed"
-    | "fetch"
-    | "font"
-    | "image"
-    | "object"
-    | "script"
-    | "style"
-    | "track"
-    | "video"
-    | "worker";
+  type HTMLPreloadAs = "fetch" | "font" | "image" | "script" | "style" | "track";
+  type HTMLLinkAs = HTMLPreloadAs | "audio" | "document" | "embed" | "object" | "video" | "worker";
 
   interface AnchorHTMLAttributes<T> extends HTMLAttributes<T> {
     download?: string | EnumeratedAcceptsEmpty | RemoveAttribute;
@@ -1367,7 +1357,7 @@ export namespace JSX {
     browsingtopics?: string | RemoveAttribute;
     crossorigin?: HTMLCrossorigin | RemoveAttribute;
     decoding?: "sync" | "async" | "auto" | RemoveAttribute;
-    fetchpriority?: "high" | "low" | "auto" | RemoveAttribute;
+    fetchpriority?: HTMLFetchPriority | RemoveAttribute;
     height?: number | string | RemoveAttribute;
     ismap?: BooleanAttribute | RemoveAttribute;
     loading?: "eager" | "lazy" | RemoveAttribute;
@@ -1522,7 +1512,7 @@ export namespace JSX {
     color?: string | RemoveAttribute;
     crossorigin?: HTMLCrossorigin | RemoveAttribute;
     disabled?: BooleanAttribute | RemoveAttribute;
-    fetchpriority?: "high" | "low" | "auto" | RemoveAttribute;
+    fetchpriority?: HTMLFetchPriority | RemoveAttribute;
     href?: string | RemoveAttribute;
     hreflang?: string | RemoveAttribute;
     imagesizes?: string | RemoveAttribute;
@@ -1713,7 +1703,7 @@ export namespace JSX {
     blocking?: "render" | RemoveAttribute;
     crossorigin?: HTMLCrossorigin | RemoveAttribute;
     defer?: BooleanAttribute | RemoveAttribute;
-    fetchpriority?: "high" | "low" | "auto" | RemoveAttribute;
+    fetchpriority?: HTMLFetchPriority | RemoveAttribute;
     for?: string | RemoveAttribute;
     integrity?: string | RemoveAttribute;
     nomodule?: BooleanAttribute | RemoveAttribute;
@@ -3500,6 +3490,11 @@ export namespace JSX {
      * @url https://developer.mozilla.org/en-US/docs/Web/API/HTMLSelectElement
      */
     select: SelectHTMLAttributes<HTMLSelectElement> & Properties<HTMLSelectElement>;
+    /**
+     * @url https://developer.mozilla.org/en-US/docs/Web/HTML/Element/selectedcontent
+     * @url https://developer.mozilla.org/en-US/docs/Web/API/HTMLSelectedContentElement
+     */
+    selectedcontent: HTMLAttributes<HTMLElement> & Properties<HTMLElement>;
     /**
      * @url https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot
      * @url https://developer.mozilla.org/en-US/docs/Web/API/HTMLSlotElement

package/types-cjs/response.d.cts

@@ -50,6 +50,8 @@ export declare const REVALIDATE_HEADER = "X-Revalidate";
 export interface ResponseHelperInit extends ResponseInit {
     revalidate?: string | string[];
 }
+/** @internal */
+export declare const RESPONSE_HEADER_VALUE_LIMIT = 4096;
 /**
  * Response redirecting to `url` (default 302). `revalidate` names the
  * cache keys the mutation invalidated.
@@ -60,6 +62,15 @@ export declare function redirect(url: string | Href, init?: number | ResponseHel
  * them when omitted).
  */
 export declare function reload(init?: ResponseHelperInit): Response;
+/**
+ * Statuses HTTP forbids a body on — the `Response` constructor enforces it
+ * by throwing on ANY body, `JSON.stringify(undefined)`'s `"undefined"`
+ * included. Shared with the server-function encoder, which answers void
+ * results on these statuses with a real null-body response and reports
+ * value-carrying ones as authoring errors (#3095).
+ * @internal
+ */
+export declare const NULL_BODY_STATUSES: ReadonlySet<number>;
 /**
  * A value paired with response metadata (status, headers, `revalidate`) —
  * for the things a naked return can't express. Progressive enhancement

package/types-cjs/serializer-decode.d.cts

@@ -105,6 +105,18 @@ export interface JSONCodecOptions {
     disabledFeatures?: number;
     /** Maximum parse/deserialize depth. Defaults to 64. Must match on both peers. */
     depthLimit?: number;
+    /**
+     * Whether serialized `Error`s carry their `.stack` — server file paths,
+     * internal function names, the shape of the deployment — to the peer.
+     * Defaults to `NODE_ENV === "development"`, but that signal describes the
+     * PROCESS, not the artifact: a production build running with
+     * `NODE_ENV=development` (a base image, a stray dotenv) ships stacks to
+     * the wire — including for errors marked safe with `markSafeError`, whose
+     * stacks traverse application code (#3152). Set `false` to pin production
+     * disclosure regardless of the ambient variable. Encode-side only; the
+     * decode side is always permissive, so it need not match peers.
+     */
+    serializeErrorStacks?: boolean;
 }
 /**
  * A resident, response-scoped decode table over the keyed JSON codec: apply
@@ -142,10 +154,11 @@ export declare const DEFAULT_WEB_PLUGINS: any; /**
  * Integration-facing; may change (see the entry banner).
  */
 export declare function resolveSerializerPlugins(customPlugins?: SerializerPlugin[]): SerializerPlugin[];
-export declare function resolveCodecOptions({ plugins, disabledFeatures, depthLimit }?: JSONCodecOptions): {
+export declare function resolveCodecOptions({ plugins, disabledFeatures, depthLimit, serializeErrorStacks }?: JSONCodecOptions): {
     plugins: SerializerPlugin<any, any>[];
     disabledFeatures: any;
     depthLimit: number;
+    serializeErrorStacks: boolean;
 }; /**
  * Creates the decoding counterpart of `serializeJSON`. Cross-references
  * between chunks resolve through state shared across calls, so all chunks

package/types-cjs/serializer.d.cts

@@ -19,6 +19,13 @@ export interface WebSerializerOptions {
      * any override — serialized stacks leak server paths to the client.
      */
     disabledFeatures?: number;
+    /**
+     * Whether serialized `Error`s carry their `.stack`. Defaults to
+     * `NODE_ENV === "development"`; set `false` to pin production disclosure
+     * to the deployment rather than the ambient variable (#3152 — see
+     * `JSONCodecOptions.serializeErrorStacks`).
+     */
+    serializeErrorStacks?: boolean;
     /** Extra plugins, composed ahead of `DEFAULT_WEB_PLUGINS`. */
     plugins?: SerializerPlugin[];
     /** Receives each emitted script chunk. */

package/types-cjs/server-functions/client.d.cts

@@ -1,4 +1,5 @@
-export { ChunkReader, ERROR_HEADER, FLASH_COOKIE, INSTANCE_HEADER, SERVER_FUNCTION_INVOKE, SINGLE_FLIGHT_HEADER, clearFlashCookie, createChunk, decodeErrorHeaderValue, decodeResponse, decodeResponsePayload, deserializeStream, encodeErrorHeaderValue, frameAddress, getFlightDataConsumer, getServerFunctionMetadata, getServerFunctionsCodec, hasFlashCookie, invoke, isServerFunction, serializeString, subscribeFlightData, withMeta } from "./shared.cjs";
+import type { ServerFunction, ServerFunctionMetadata } from "./shared.cjs";
+export { ChunkReader, ERROR_HEADER, FLASH_COOKIE, INSTANCE_HEADER, REDIRECT_HEADER, SERVER_FUNCTION_INVOKE, SINGLE_FLIGHT_HEADER, UNKNOWN_HEADER, clearFlashCookie, createChunk, decodeErrorHeaderValue, decodeRedirectHeaderValue, decodeResponse, decodeResponsePayload, deserializeStream, encodeErrorHeaderValue, frameAddress, getFlightDataConsumer, getFlightDataSourceIds, getServerFunctionMetadata, getServerFunctionsCodec, hasFlashCookie, invoke, isServerFunction, serializeString, subscribeFlightData, withMeta } from "./shared.cjs";
 export { REVALIDATE_HEADER } from "../response.cjs";
 import { JSONCodecOptions } from "../serializer-decode.cjs";
 export type { FlightDataConsumer, FlightDataContext, InvokeOptions, ServerFunction, ServerFunctionInvoker, ServerFunctionMetadata, SingleFlightPayload } from "./shared.cjs";
@@ -159,6 +160,25 @@ export declare function parseServerFunctionUrl(url: string): string | null;
 export declare function configureServerFunctionsClient(config?: ServerFunctionsClientConfig): void;
 export declare function createServerReference(id: string, name?: string, base?: string): ServerFunction;
 export declare function GET<A extends readonly any[], R>(fn: (...args: A) => R): ServerFunction<A, Awaited<R>>;
-export declare function live<A extends readonly any[], R>(fn: (...args: A) => R): ServerFunction<A, LiveSource<Awaited<R>>>;
+export interface LiveServerFunction<A extends readonly any[] = any[], R = any> {
+    (...args: A): LiveSource<R>;
+    /** The build-stable function id (stable across the client and server builds). */
+    readonly id: string;
+    /** URL invoking this function directly over HTTP. */
+    readonly url: string;
+}
+/**
+ * Declares a value-shaped live source: a server function returning an async
+ * iterable whose yields are successive VALUES of one logical query, with the
+ * contract that the source re-yields current state on every invocation.
+ * Calls to the returned reference produce an iterable that survives the
+ * connection — post-connect deaths re-invoke with exponential backoff
+ * (reset per healthy value, woken early by connectivity returning),
+ * first-connect failures reject like a normal call, and `break` aborts the
+ * in-flight request. Live calls are reads and never opt into single-flight
+ * enveloping. Wire state, if wanted, rides the returned iterable's
+ * `onstatus` hook. Compose with `GET` inside-out: `live(GET(fn))`.
+ */
+export declare function live<A extends readonly any[], R>(fn: (...args: A) => R): LiveServerFunction<A, Awaited<R>>;
 export declare function registerServerReference(): never;
 export declare function getServerFunctionInvocation(): ServerFunctionInvocation | undefined;

package/types-cjs/server-functions/flash.d.cts

@@ -13,6 +13,15 @@ export interface FlashSubmission {
     result?: any;
     /** The thrown value, when the call threw. */
     error?: any;
+    /**
+     * Set when the outcome was too large for the cookie's 4 KB ceiling and
+     * was degraded to fit (#3137): the input echo is dropped, and `result` /
+     * `error` may carry a bounded prefix — or the bare outcome flag `true` —
+     * rather than the full value. The submission still says what happened
+     * and where; integrations should render it as "succeeded (result too
+     * large to display)" rather than replaying the value.
+     */
+    truncated?: boolean;
 }
 export declare function encodeFlashCookie(url: string, result: any, input: any[], thrown?: boolean): string;
 export declare function decodeFlashCookie(cookieHeader: string | null): FlashSubmission | undefined;