@payloadcms/tanstack-start 4.0.0-canary.8

package/dist/utilities/loadLayoutData.js

@@ -0,0 +1,23 @@
+import { renderServerComponent } from '@tanstack/react-start/rsc';
+import { getLayoutData } from '../layouts/Root/getLayoutData.js';
+import { toSerializable } from './toSerializable.js';
+/**
+ * Resolves the admin layout data for TanStack Start and returns a serializable
+ * payload for the `/_payload` route loader. The framework adapter wraps this in
+ * a `createServerFn` that supplies the app's `config` and generated `importMap`.
+ *
+ * `toSerializable` strips React elements, so the custom-providers element tree
+ * (`config.admin.components.providers`) is rendered to an RSC payload separately
+ * and re-attached.
+ */ export async function loadLayoutData({ config, importMap }) {
+    const { providers, ...data } = await getLayoutData({
+        configPromise: config,
+        importMap
+    });
+    return {
+        ...toSerializable(data),
+        providers: providers ? await renderServerComponent(providers) : undefined
+    };
+}
+
+//# sourceMappingURL=loadLayoutData.js.map

package/dist/utilities/loadLayoutData.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/loadLayoutData.ts"],"sourcesContent":["import type { ImportMap, SanitizedConfig } from 'payload'\n\nimport { renderServerComponent } from '@tanstack/react-start/rsc'\n\nimport { getLayoutData } from '../layouts/Root/getLayoutData.js'\nimport { toSerializable } from './toSerializable.js'\n\n/**\n * Resolves the admin layout data for TanStack Start and returns a serializable\n * payload for the `/_payload` route loader. The framework adapter wraps this in\n * a `createServerFn` that supplies the app's `config` and generated `importMap`.\n *\n * `toSerializable` strips React elements, so the custom-providers element tree\n * (`config.admin.components.providers`) is rendered to an RSC payload separately\n * and re-attached.\n */\nexport async function loadLayoutData({\n  config,\n  importMap,\n}: {\n  config: SanitizedConfig\n  importMap: ImportMap\n}): Promise<Record<string, unknown>> {\n  const { providers, ...data } = await getLayoutData({ configPromise: config, importMap })\n\n  return {\n    ...(toSerializable(data) as Record<string, unknown>),\n    providers: providers ? await renderServerComponent(providers as any) : undefined,\n  }\n}\n"],"names":["renderServerComponent","getLayoutData","toSerializable","loadLayoutData","config","importMap","providers","data","configPromise","undefined"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,4BAA2B;AAEjE,SAASC,aAAa,QAAQ,mCAAkC;AAChE,SAASC,cAAc,QAAQ,sBAAqB;AAEpD;;;;;;;;CAQC,GACD,OAAO,eAAeC,eAAe,EACnCC,MAAM,EACNC,SAAS,EAIV;IACC,MAAM,EAAEC,SAAS,EAAE,GAAGC,MAAM,GAAG,MAAMN,cAAc;QAAEO,eAAeJ;QAAQC;IAAU;IAEtF,OAAO;QACL,GAAIH,eAAeK,KAAK;QACxBD,WAAWA,YAAY,MAAMN,sBAAsBM,aAAoBG;IACzE;AACF"}

package/dist/utilities/meta.d.ts

@@ -0,0 +1,70 @@
+type MetaEntry = {
+    charSet: string;
+} | {
+    content: string;
+    name: string;
+} | {
+    content: string;
+    property: string;
+} | {
+    title: string;
+};
+type LinkEntry = {
+    href: string;
+    media?: string;
+    rel: string;
+    sizes?: string;
+    type?: string;
+};
+type AdminPageIcon = {
+    media?: string;
+    rel?: string;
+    sizes?: string;
+    type?: string;
+    url: string;
+};
+type AdminPageOGImage = {
+    alt?: string;
+    height?: number;
+    url: string;
+    width?: number;
+};
+/**
+ * Resolved admin-page metadata produced by the admin-page server function.
+ *
+ * The server function resolves the framework-agnostic `MetaConfig` (via the
+ * shared `generatePageMetadata` in `@payloadcms/ui`) down to plain serializable
+ * values, so the route loader can ship it across the wire and feed it to
+ * `getAdminMeta` in `head()`.
+ */
+export type AdminPageMetadata = {
+    description?: string;
+    icons?: AdminPageIcon[];
+    keywords?: string;
+    openGraph?: {
+        description?: string;
+        images?: AdminPageOGImage[];
+        siteName?: string;
+        title?: string;
+    };
+    robots?: string;
+    title?: string;
+};
+/**
+ * Builds TanStack Router `head()` `meta` + `links` entries for an admin page
+ * from the resolved `AdminPageMetadata`, mirroring the tags Next.js renders
+ * natively from the same `MetaConfig` (title, description, robots, keywords,
+ * OpenGraph, Twitter — derived from OpenGraph — and icon links).
+ *
+ * ```ts
+ * export const Route = createFileRoute('/admin/$')({
+ *   head: ({ loaderData }) => getAdminMeta(loaderData?.metadata),
+ * })
+ * ```
+ */
+export declare function getAdminMeta(metadata?: AdminPageMetadata): {
+    links: LinkEntry[];
+    meta: MetaEntry[];
+};
+export {};
+//# sourceMappingURL=meta.d.ts.map

package/dist/utilities/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/utilities/meta.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GACV;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAErB,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG;IAC1D,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,IAAI,EAAE,SAAS,EAAE,CAAA;CAClB,CA0EA"}

package/dist/utilities/meta.js

@@ -0,0 +1,142 @@
+/**
+ * Builds TanStack Router `head()` `meta` + `links` entries for an admin page
+ * from the resolved `AdminPageMetadata`, mirroring the tags Next.js renders
+ * natively from the same `MetaConfig` (title, description, robots, keywords,
+ * OpenGraph, Twitter — derived from OpenGraph — and icon links).
+ *
+ * ```ts
+ * export const Route = createFileRoute('/admin/$')({
+ *   head: ({ loaderData }) => getAdminMeta(loaderData?.metadata),
+ * })
+ * ```
+ */ export function getAdminMeta(metadata) {
+    const meta = [
+        {
+            charSet: 'utf-8'
+        },
+        {
+            name: 'viewport',
+            content: 'width=device-width, initial-scale=1'
+        }
+    ];
+    const links = [];
+    if (!metadata) {
+        return {
+            links,
+            meta
+        };
+    }
+    if (metadata.title) {
+        meta.push({
+            title: metadata.title
+        });
+    }
+    if (metadata.description) {
+        meta.push({
+            name: 'description',
+            content: metadata.description
+        });
+    }
+    if (metadata.keywords) {
+        meta.push({
+            name: 'keywords',
+            content: metadata.keywords
+        });
+    }
+    if (metadata.robots) {
+        meta.push({
+            name: 'robots',
+            content: metadata.robots
+        });
+    }
+    const og = metadata.openGraph;
+    if (og) {
+        if (og.title) {
+            meta.push({
+                content: og.title,
+                property: 'og:title'
+            });
+        }
+        if (og.description) {
+            meta.push({
+                content: og.description,
+                property: 'og:description'
+            });
+        }
+        if (og.siteName) {
+            meta.push({
+                content: og.siteName,
+                property: 'og:site_name'
+            });
+        }
+        for (const image of og.images ?? []){
+            meta.push({
+                content: image.url,
+                property: 'og:image'
+            });
+            if (image.width) {
+                meta.push({
+                    content: String(image.width),
+                    property: 'og:image:width'
+                });
+            }
+            if (image.height) {
+                meta.push({
+                    content: String(image.height),
+                    property: 'og:image:height'
+                });
+            }
+            if (image.alt) {
+                meta.push({
+                    content: image.alt,
+                    property: 'og:image:alt'
+                });
+            }
+        }
+        // Twitter card is inherited from OpenGraph (matches Next.js metadata resolution).
+        const firstImage = og.images?.[0];
+        if (firstImage) {
+            meta.push({
+                name: 'twitter:card',
+                content: 'summary_large_image'
+            });
+            meta.push({
+                name: 'twitter:image',
+                content: firstImage.url
+            });
+        }
+        if (og.title) {
+            meta.push({
+                name: 'twitter:title',
+                content: og.title
+            });
+        }
+        if (og.description) {
+            meta.push({
+                name: 'twitter:description',
+                content: og.description
+            });
+        }
+    }
+    for (const icon of metadata.icons ?? []){
+        links.push({
+            href: icon.url,
+            rel: icon.rel ?? 'icon',
+            ...icon.media ? {
+                media: icon.media
+            } : {},
+            ...icon.sizes ? {
+                sizes: icon.sizes
+            } : {},
+            ...icon.type ? {
+                type: icon.type
+            } : {}
+        });
+    }
+    return {
+        links,
+        meta
+    };
+}
+
+//# sourceMappingURL=meta.js.map

package/dist/utilities/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/meta.ts"],"sourcesContent":["type MetaEntry =\n  | { charSet: string }\n  | { content: string; name: string }\n  | { content: string; property: string }\n  | { title: string }\n\ntype LinkEntry = {\n  href: string\n  media?: string\n  rel: string\n  sizes?: string\n  type?: string\n}\n\ntype AdminPageIcon = {\n  media?: string\n  rel?: string\n  sizes?: string\n  type?: string\n  url: string\n}\n\ntype AdminPageOGImage = {\n  alt?: string\n  height?: number\n  url: string\n  width?: number\n}\n\n/**\n * Resolved admin-page metadata produced by the admin-page server function.\n *\n * The server function resolves the framework-agnostic `MetaConfig` (via the\n * shared `generatePageMetadata` in `@payloadcms/ui`) down to plain serializable\n * values, so the route loader can ship it across the wire and feed it to\n * `getAdminMeta` in `head()`.\n */\nexport type AdminPageMetadata = {\n  description?: string\n  icons?: AdminPageIcon[]\n  keywords?: string\n  openGraph?: {\n    description?: string\n    images?: AdminPageOGImage[]\n    siteName?: string\n    title?: string\n  }\n  robots?: string\n  title?: string\n}\n\n/**\n * Builds TanStack Router `head()` `meta` + `links` entries for an admin page\n * from the resolved `AdminPageMetadata`, mirroring the tags Next.js renders\n * natively from the same `MetaConfig` (title, description, robots, keywords,\n * OpenGraph, Twitter — derived from OpenGraph — and icon links).\n *\n * ```ts\n * export const Route = createFileRoute('/admin/$')({\n *   head: ({ loaderData }) => getAdminMeta(loaderData?.metadata),\n * })\n * ```\n */\nexport function getAdminMeta(metadata?: AdminPageMetadata): {\n  links: LinkEntry[]\n  meta: MetaEntry[]\n} {\n  const meta: MetaEntry[] = [\n    { charSet: 'utf-8' },\n    { name: 'viewport', content: 'width=device-width, initial-scale=1' },\n  ]\n  const links: LinkEntry[] = []\n\n  if (!metadata) {\n    return { links, meta }\n  }\n\n  if (metadata.title) {\n    meta.push({ title: metadata.title })\n  }\n  if (metadata.description) {\n    meta.push({ name: 'description', content: metadata.description })\n  }\n  if (metadata.keywords) {\n    meta.push({ name: 'keywords', content: metadata.keywords })\n  }\n  if (metadata.robots) {\n    meta.push({ name: 'robots', content: metadata.robots })\n  }\n\n  const og = metadata.openGraph\n  if (og) {\n    if (og.title) {\n      meta.push({ content: og.title, property: 'og:title' })\n    }\n    if (og.description) {\n      meta.push({ content: og.description, property: 'og:description' })\n    }\n    if (og.siteName) {\n      meta.push({ content: og.siteName, property: 'og:site_name' })\n    }\n\n    for (const image of og.images ?? []) {\n      meta.push({ content: image.url, property: 'og:image' })\n      if (image.width) {\n        meta.push({ content: String(image.width), property: 'og:image:width' })\n      }\n      if (image.height) {\n        meta.push({ content: String(image.height), property: 'og:image:height' })\n      }\n      if (image.alt) {\n        meta.push({ content: image.alt, property: 'og:image:alt' })\n      }\n    }\n\n    // Twitter card is inherited from OpenGraph (matches Next.js metadata resolution).\n    const firstImage = og.images?.[0]\n    if (firstImage) {\n      meta.push({ name: 'twitter:card', content: 'summary_large_image' })\n      meta.push({ name: 'twitter:image', content: firstImage.url })\n    }\n    if (og.title) {\n      meta.push({ name: 'twitter:title', content: og.title })\n    }\n    if (og.description) {\n      meta.push({ name: 'twitter:description', content: og.description })\n    }\n  }\n\n  for (const icon of metadata.icons ?? []) {\n    links.push({\n      href: icon.url,\n      rel: icon.rel ?? 'icon',\n      ...(icon.media ? { media: icon.media } : {}),\n      ...(icon.sizes ? { sizes: icon.sizes } : {}),\n      ...(icon.type ? { type: icon.type } : {}),\n    })\n  }\n\n  return { links, meta }\n}\n"],"names":["getAdminMeta","metadata","meta","charSet","name","content","links","title","push","description","keywords","robots","og","openGraph","property","siteName","image","images","url","width","String","height","alt","firstImage","icon","icons","href","rel","media","sizes","type"],"mappings":"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"}

package/dist/utilities/serializeForRsc.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Recursively walk a server-function return value and prepare it for transit
+ * to the client as an RSC payload.
+ *
+ * Mirrors `toSerializable`'s walk (Maps, Sets, Dates, typed arrays, circular
+ * refs) with two key differences:
+ *
+ * 1. React elements are NOT stripped. They are passed through
+ *    `renderServerComponent` from `@tanstack/react-start/rsc` to produce a
+ *    "renderable RSC handle". TanStack Start's `$RSC` serialization adapter
+ *    streams the underlying Flight payload to the client, where it is
+ *    decoded back into a renderable React node. This matches the way
+ *    Next.js's RSC payload format ships React elements over server actions
+ *    and lets server-rendered custom field components (e.g. those returned
+ *    by `buildFormState` / `RenderServerComponent`) survive a `form-state`
+ *    round trip.
+ *
+ * 2. Functions, Symbols, and RegExps are still stripped — TanStack's seroval
+ *    transport cannot handle them, and Payload doesn't intentionally include
+ *    them in server-function return values.
+ *
+ * Use this in `createServerFn` handlers that return Payload form/view state
+ * containing React elements (e.g. `state[path].customComponents.Field`).
+ */
+export declare function serializeForRsc<T>(value: T): Promise<T>;
+//# sourceMappingURL=serializeForRsc.d.ts.map

package/dist/utilities/serializeForRsc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeForRsc.d.ts","sourceRoot":"","sources":["../../src/utilities/serializeForRsc.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7D"}

package/dist/utilities/serializeForRsc.js

@@ -0,0 +1,122 @@
+import { renderServerComponent } from '@tanstack/react-start/rsc';
+import { createElement, Fragment } from 'react';
+/**
+ * Recursively walk a server-function return value and prepare it for transit
+ * to the client as an RSC payload.
+ *
+ * Mirrors `toSerializable`'s walk (Maps, Sets, Dates, typed arrays, circular
+ * refs) with two key differences:
+ *
+ * 1. React elements are NOT stripped. They are passed through
+ *    `renderServerComponent` from `@tanstack/react-start/rsc` to produce a
+ *    "renderable RSC handle". TanStack Start's `$RSC` serialization adapter
+ *    streams the underlying Flight payload to the client, where it is
+ *    decoded back into a renderable React node. This matches the way
+ *    Next.js's RSC payload format ships React elements over server actions
+ *    and lets server-rendered custom field components (e.g. those returned
+ *    by `buildFormState` / `RenderServerComponent`) survive a `form-state`
+ *    round trip.
+ *
+ * 2. Functions, Symbols, and RegExps are still stripped — TanStack's seroval
+ *    transport cannot handle them, and Payload doesn't intentionally include
+ *    them in server-function return values.
+ *
+ * Use this in `createServerFn` handlers that return Payload form/view state
+ * containing React elements (e.g. `state[path].customComponents.Field`).
+ */ export async function serializeForRsc(value) {
+    return await walk(value, new WeakMap(), new WeakSet());
+}
+async function walk(value, cache, ancestors) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    const t = typeof value;
+    if (t === 'function' || t === 'symbol') {
+        return undefined;
+    }
+    if (t !== 'object') {
+        return value;
+    }
+    const obj = value;
+    if (typeof obj.$$typeof === 'symbol') {
+        return await renderServerComponent(value);
+    }
+    if (ancestors.has(obj)) {
+        return undefined;
+    }
+    if (cache.has(obj)) {
+        return cache.get(obj);
+    }
+    if (obj instanceof Date) {
+        return obj;
+    }
+    if (obj instanceof RegExp) {
+        return undefined;
+    }
+    ancestors.add(obj);
+    if (obj instanceof Map) {
+        const cleaned = new Map();
+        cache.set(obj, cleaned);
+        for (const [k, v] of obj){
+            const cv = await walk(v, cache, ancestors);
+            if (cv !== undefined) {
+                cleaned.set(k, cv);
+            }
+        }
+        ancestors.delete(obj);
+        return cleaned;
+    }
+    if (obj instanceof Set) {
+        const cleaned = new Set();
+        cache.set(obj, cleaned);
+        for (const v of obj){
+            const cv = await walk(v, cache, ancestors);
+            if (cv !== undefined) {
+                cleaned.add(cv);
+            }
+        }
+        ancestors.delete(obj);
+        return cleaned;
+    }
+    if (Array.isArray(obj)) {
+        // An array consisting entirely of React elements (e.g. a field's
+        // `beforeInput` / `afterInput` component list, produced by
+        // `RenderServerComponent`) must be rendered as a SINGLE RSC handle.
+        // Converting each element individually below turns every item into its own
+        // `renderServerComponent` handle, which drops the element's React `key` —
+        // the client then renders `{[handle, handle]}` as unkeyed array children
+        // and React warns "Each child in a list should have a unique key prop".
+        // Payload always renders these component arrays wholesale (`{BeforeInput}`),
+        // so collapsing them into one Fragment-rendered handle is render-equivalent
+        // and keeps the per-element keys intact inside the single Flight payload.
+        const items = obj.filter((item)=>item !== null && item !== undefined);
+        const isReactElementArray = items.length > 0 && items.every((item)=>typeof item === 'object' && typeof item.$$typeof === 'symbol');
+        if (isReactElementArray) {
+            ancestors.delete(obj);
+            return await renderServerComponent(createElement(Fragment, null, ...obj));
+        }
+        const arr = [];
+        cache.set(obj, arr);
+        for (const item of obj){
+            arr.push(await walk(item, cache, ancestors));
+        }
+        ancestors.delete(obj);
+        return arr;
+    }
+    if (ArrayBuffer.isView(obj)) {
+        ancestors.delete(obj);
+        return obj;
+    }
+    const result = {};
+    cache.set(obj, result);
+    for (const key of Object.keys(obj)){
+        const v = await walk(obj[key], cache, ancestors);
+        if (v !== undefined) {
+            result[key] = v;
+        }
+    }
+    ancestors.delete(obj);
+    return result;
+}
+
+//# sourceMappingURL=serializeForRsc.js.map

package/dist/utilities/serializeForRsc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/serializeForRsc.ts"],"sourcesContent":["import type React from 'react'\n\nimport { renderServerComponent } from '@tanstack/react-start/rsc'\nimport { createElement, Fragment } from 'react'\n\n/**\n * Recursively walk a server-function return value and prepare it for transit\n * to the client as an RSC payload.\n *\n * Mirrors `toSerializable`'s walk (Maps, Sets, Dates, typed arrays, circular\n * refs) with two key differences:\n *\n * 1. React elements are NOT stripped. They are passed through\n *    `renderServerComponent` from `@tanstack/react-start/rsc` to produce a\n *    \"renderable RSC handle\". TanStack Start's `$RSC` serialization adapter\n *    streams the underlying Flight payload to the client, where it is\n *    decoded back into a renderable React node. This matches the way\n *    Next.js's RSC payload format ships React elements over server actions\n *    and lets server-rendered custom field components (e.g. those returned\n *    by `buildFormState` / `RenderServerComponent`) survive a `form-state`\n *    round trip.\n *\n * 2. Functions, Symbols, and RegExps are still stripped — TanStack's seroval\n *    transport cannot handle them, and Payload doesn't intentionally include\n *    them in server-function return values.\n *\n * Use this in `createServerFn` handlers that return Payload form/view state\n * containing React elements (e.g. `state[path].customComponents.Field`).\n */\nexport async function serializeForRsc<T>(value: T): Promise<T> {\n  return (await walk(value, new WeakMap<object, unknown>(), new WeakSet<object>())) as T\n}\n\nasync function walk(\n  value: unknown,\n  cache: WeakMap<object, unknown>,\n  ancestors: WeakSet<object>,\n): Promise<unknown> {\n  if (value === null || value === undefined) {\n    return value\n  }\n\n  const t = typeof value\n  if (t === 'function' || t === 'symbol') {\n    return undefined\n  }\n  if (t !== 'object') {\n    return value\n  }\n\n  const obj = value as Record<string, unknown>\n\n  if (typeof obj.$$typeof === 'symbol') {\n    return await renderServerComponent(value as React.ReactElement)\n  }\n\n  if (ancestors.has(obj)) {\n    return undefined\n  }\n\n  if (cache.has(obj)) {\n    return cache.get(obj)\n  }\n\n  if (obj instanceof Date) {\n    return obj\n  }\n\n  if (obj instanceof RegExp) {\n    return undefined\n  }\n\n  ancestors.add(obj)\n\n  if (obj instanceof Map) {\n    const cleaned = new Map()\n    cache.set(obj, cleaned)\n    for (const [k, v] of obj) {\n      const cv = await walk(v, cache, ancestors)\n      if (cv !== undefined) {\n        cleaned.set(k, cv)\n      }\n    }\n    ancestors.delete(obj)\n    return cleaned\n  }\n\n  if (obj instanceof Set) {\n    const cleaned = new Set()\n    cache.set(obj, cleaned)\n    for (const v of obj) {\n      const cv = await walk(v, cache, ancestors)\n      if (cv !== undefined) {\n        cleaned.add(cv)\n      }\n    }\n    ancestors.delete(obj)\n    return cleaned\n  }\n\n  if (Array.isArray(obj)) {\n    // An array consisting entirely of React elements (e.g. a field's\n    // `beforeInput` / `afterInput` component list, produced by\n    // `RenderServerComponent`) must be rendered as a SINGLE RSC handle.\n    // Converting each element individually below turns every item into its own\n    // `renderServerComponent` handle, which drops the element's React `key` —\n    // the client then renders `{[handle, handle]}` as unkeyed array children\n    // and React warns \"Each child in a list should have a unique key prop\".\n    // Payload always renders these component arrays wholesale (`{BeforeInput}`),\n    // so collapsing them into one Fragment-rendered handle is render-equivalent\n    // and keeps the per-element keys intact inside the single Flight payload.\n    const items = obj.filter((item) => item !== null && item !== undefined)\n    const isReactElementArray =\n      items.length > 0 &&\n      items.every(\n        (item) => typeof item === 'object' && typeof (item as { $$typeof?: unknown }).$$typeof === 'symbol',\n      )\n    if (isReactElementArray) {\n      ancestors.delete(obj)\n      return await renderServerComponent(createElement(Fragment, null, ...(obj as React.ReactNode[])))\n    }\n\n    const arr: unknown[] = []\n    cache.set(obj, arr)\n    for (const item of obj) {\n      arr.push(await walk(item, cache, ancestors))\n    }\n    ancestors.delete(obj)\n    return arr\n  }\n\n  if (ArrayBuffer.isView(obj)) {\n    ancestors.delete(obj)\n    return obj\n  }\n\n  const result: Record<string, unknown> = {}\n  cache.set(obj, result)\n  for (const key of Object.keys(obj)) {\n    const v = await walk(obj[key], cache, ancestors)\n    if (v !== undefined) {\n      result[key] = v\n    }\n  }\n  ancestors.delete(obj)\n  return result\n}\n"],"names":["renderServerComponent","createElement","Fragment","serializeForRsc","value","walk","WeakMap","WeakSet","cache","ancestors","undefined","t","obj","$$typeof","has","get","Date","RegExp","add","Map","cleaned","set","k","v","cv","delete","Set","Array","isArray","items","filter","item","isReactElementArray","length","every","arr","push","ArrayBuffer","isView","result","key","Object","keys"],"mappings":"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"}

package/dist/utilities/serverAdapter.server.d.ts

@@ -0,0 +1,36 @@
+import type { ServerAdapter } from 'payload';
+/**
+ * Server-side adapter for TanStack Start.
+ * Uses `@tanstack/react-start/server` utilities for request/response handling.
+ */
+export declare const tanstackServerAdapter: ServerAdapter;
+/**
+ * Navigation requested during an admin page render, recorded by
+ * `createPageRenderServerAdapter`. The admin-page server function reads this
+ * after `renderServerComponent` resolves.
+ */
+export type PageNavIntent = {
+    type?: 'notFound' | 'redirect';
+    url?: string;
+};
+/**
+ * Builds the `ServerAdapter` for the admin page render (`renderRoot`). Like
+ * `tanstackServerAdapter` for cookies/headers, but navigation **records the
+ * intent on `nav` and throws** the framework-agnostic string error-contract
+ * (`Error('not-found')` / `Error('redirect:<url>')`) instead of TanStack's
+ * native `notFound`/`redirect`.
+ *
+ * `renderRoot` navigates via `req.server.*` in two places:
+ * - during orchestration (e.g. the unauthenticated login redirect) — the throw
+ *   propagates out of `renderRoot` and is caught by the loader's try/catch;
+ * - deep inside streamed view components (e.g. `DocumentView` access checks,
+ *   `LoginView` already-authenticated) — here the throw happens during
+ *   `renderServerComponent` and is swallowed into the RSC stream, so it never
+ *   rejects the render promise.
+ *
+ * Recording the intent on `nav` lets the loader honor the second case by
+ * inspecting `nav` after the render resolves, then re-throwing native TanStack
+ * nav at the loader boundary.
+ */
+export declare const createPageRenderServerAdapter: (nav: PageNavIntent) => ServerAdapter;
+//# sourceMappingURL=serverAdapter.server.d.ts.map

package/dist/utilities/serverAdapter.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverAdapter.server.d.ts","sourceRoot":"","sources":["../../src/utilities/serverAdapter.server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,aAAa,EAAE,MAAM,SAAS,CAAA;AAsDxE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aA8CnC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,GAAI,KAAK,aAAa,KAAG,aAgBjE,CAAA"}

package/dist/utilities/serverAdapter.server.js

@@ -0,0 +1,130 @@
+import { notFound, redirect } from '@tanstack/react-router';
+import { getRequest, setResponseHeader } from '@tanstack/react-start/server';
+import { parseCookies } from 'payload';
+function buildCookieStore(headers) {
+    const cookies = parseCookies(headers);
+    return {
+        get: (name)=>{
+            const value = cookies.get(name);
+            return value !== undefined ? {
+                name,
+                value
+            } : undefined;
+        },
+        getAll: ()=>{
+            return Array.from(cookies.entries()).map(([name, value])=>({
+                    name,
+                    value
+                }));
+        }
+    };
+}
+function serializeCookie(name, value, options) {
+    let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
+    if (options?.path) {
+        cookie += `; Path=${options.path}`;
+    }
+    if (options?.domain) {
+        cookie += `; Domain=${options.domain}`;
+    }
+    if (options?.maxAge !== undefined) {
+        cookie += `; Max-Age=${options.maxAge}`;
+    }
+    if (options?.expires) {
+        cookie += `; Expires=${options.expires.toUTCString()}`;
+    }
+    if (options?.httpOnly) {
+        cookie += '; HttpOnly';
+    }
+    if (options?.secure) {
+        cookie += '; Secure';
+    }
+    if (options?.sameSite) {
+        cookie += `; SameSite=${options.sameSite.charAt(0).toUpperCase() + options.sameSite.slice(1)}`;
+    }
+    return cookie;
+}
+/**
+ * Server-side adapter for TanStack Start.
+ * Uses `@tanstack/react-start/server` utilities for request/response handling.
+ */ export const tanstackServerAdapter = {
+    getCookies: ()=>{
+        const request = getRequest();
+        const headers = new Headers(request.headers);
+        return buildCookieStore(headers);
+    },
+    getHeaders: ()=>{
+        const request = getRequest();
+        return new Headers(request.headers);
+    },
+    notFound: ()=>{
+        // TanStack Router requires throwing the notFound() result directly
+        // eslint-disable-next-line @typescript-eslint/only-throw-error
+        throw notFound();
+    },
+    redirect: (path)=>{
+        // TanStack Router requires throwing the redirect() result directly
+        // eslint-disable-next-line @typescript-eslint/only-throw-error
+        throw redirect({
+            to: path
+        });
+    },
+    permanentRedirect: (path)=>{
+        // TanStack Router does not have a separate permanent redirect primitive;
+        // fall back to a regular redirect so existing behavior is preserved.
+        // eslint-disable-next-line @typescript-eslint/only-throw-error
+        throw redirect({
+            to: path
+        });
+    },
+    forbidden: ()=>{
+        // TanStack Router does not have a dedicated forbidden() helper; surface
+        // a generic error so the request boundary still terminates the request.
+        throw new Error('Forbidden');
+    },
+    unauthorized: ()=>{
+        // TanStack Router does not have a dedicated unauthorized() helper; surface
+        // a generic error so the request boundary still terminates the request.
+        throw new Error('Unauthorized');
+    },
+    setCookie: (name, value, options)=>{
+        setResponseHeader('Set-Cookie', serializeCookie(name, value, options));
+    }
+};
+/**
+ * Builds the `ServerAdapter` for the admin page render (`renderRoot`). Like
+ * `tanstackServerAdapter` for cookies/headers, but navigation **records the
+ * intent on `nav` and throws** the framework-agnostic string error-contract
+ * (`Error('not-found')` / `Error('redirect:<url>')`) instead of TanStack's
+ * native `notFound`/`redirect`.
+ *
+ * `renderRoot` navigates via `req.server.*` in two places:
+ * - during orchestration (e.g. the unauthenticated login redirect) — the throw
+ *   propagates out of `renderRoot` and is caught by the loader's try/catch;
+ * - deep inside streamed view components (e.g. `DocumentView` access checks,
+ *   `LoginView` already-authenticated) — here the throw happens during
+ *   `renderServerComponent` and is swallowed into the RSC stream, so it never
+ *   rejects the render promise.
+ *
+ * Recording the intent on `nav` lets the loader honor the second case by
+ * inspecting `nav` after the render resolves, then re-throwing native TanStack
+ * nav at the loader boundary.
+ */ export const createPageRenderServerAdapter = (nav)=>({
+        ...tanstackServerAdapter,
+        notFound: ()=>{
+            nav.type = 'notFound';
+            throw new Error('not-found');
+        },
+        permanentRedirect: (path)=>{
+            nav.type = 'redirect';
+            nav.url = path;
+            throw new Error(`redirect:${path}`);
+        },
+        redirect: (path)=>{
+            nav.type = 'redirect';
+            nav.url = path;
+            throw new Error(`redirect:${path}`);
+        }
+    });
+
+//# sourceMappingURL=serverAdapter.server.js.map

package/dist/utilities/serverAdapter.server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/serverAdapter.server.ts"],"sourcesContent":["import type { CookieOptions, CookieStore, ServerAdapter } from 'payload'\n\nimport { notFound, redirect } from '@tanstack/react-router'\nimport { getRequest, setResponseHeader } from '@tanstack/react-start/server'\nimport { parseCookies } from 'payload'\n\nfunction buildCookieStore(headers: Headers): CookieStore {\n  const cookies = parseCookies(headers)\n\n  return {\n    get: (name: string) => {\n      const value = cookies.get(name)\n      return value !== undefined ? { name, value } : undefined\n    },\n    getAll: () => {\n      return Array.from(cookies.entries()).map(([name, value]) => ({ name, value }))\n    },\n  }\n}\n\nfunction serializeCookie(name: string, value: string, options?: CookieOptions): string {\n  let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`\n\n  if (options?.path) {\n    cookie += `; Path=${options.path}`\n  }\n\n  if (options?.domain) {\n    cookie += `; Domain=${options.domain}`\n  }\n\n  if (options?.maxAge !== undefined) {\n    cookie += `; Max-Age=${options.maxAge}`\n  }\n\n  if (options?.expires) {\n    cookie += `; Expires=${options.expires.toUTCString()}`\n  }\n\n  if (options?.httpOnly) {\n    cookie += '; HttpOnly'\n  }\n\n  if (options?.secure) {\n    cookie += '; Secure'\n  }\n\n  if (options?.sameSite) {\n    cookie += `; SameSite=${options.sameSite.charAt(0).toUpperCase() + options.sameSite.slice(1)}`\n  }\n\n  return cookie\n}\n\n/**\n * Server-side adapter for TanStack Start.\n * Uses `@tanstack/react-start/server` utilities for request/response handling.\n */\nexport const tanstackServerAdapter: ServerAdapter = {\n  getCookies: () => {\n    const request = getRequest()\n    const headers = new Headers(request.headers)\n    return buildCookieStore(headers)\n  },\n\n  getHeaders: () => {\n    const request = getRequest()\n    return new Headers(request.headers)\n  },\n\n  notFound: () => {\n    // TanStack Router requires throwing the notFound() result directly\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw notFound()\n  },\n\n  redirect: (path: string) => {\n    // TanStack Router requires throwing the redirect() result directly\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw redirect({ to: path })\n  },\n\n  permanentRedirect: (path: string) => {\n    // TanStack Router does not have a separate permanent redirect primitive;\n    // fall back to a regular redirect so existing behavior is preserved.\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw redirect({ to: path })\n  },\n\n  forbidden: () => {\n    // TanStack Router does not have a dedicated forbidden() helper; surface\n    // a generic error so the request boundary still terminates the request.\n    throw new Error('Forbidden')\n  },\n\n  unauthorized: () => {\n    // TanStack Router does not have a dedicated unauthorized() helper; surface\n    // a generic error so the request boundary still terminates the request.\n    throw new Error('Unauthorized')\n  },\n\n  setCookie: (name: string, value: string, options?: CookieOptions) => {\n    setResponseHeader('Set-Cookie', serializeCookie(name, value, options))\n  },\n}\n\n/**\n * Navigation requested during an admin page render, recorded by\n * `createPageRenderServerAdapter`. The admin-page server function reads this\n * after `renderServerComponent` resolves.\n */\nexport type PageNavIntent = {\n  type?: 'notFound' | 'redirect'\n  url?: string\n}\n\n/**\n * Builds the `ServerAdapter` for the admin page render (`renderRoot`). Like\n * `tanstackServerAdapter` for cookies/headers, but navigation **records the\n * intent on `nav` and throws** the framework-agnostic string error-contract\n * (`Error('not-found')` / `Error('redirect:<url>')`) instead of TanStack's\n * native `notFound`/`redirect`.\n *\n * `renderRoot` navigates via `req.server.*` in two places:\n * - during orchestration (e.g. the unauthenticated login redirect) — the throw\n *   propagates out of `renderRoot` and is caught by the loader's try/catch;\n * - deep inside streamed view components (e.g. `DocumentView` access checks,\n *   `LoginView` already-authenticated) — here the throw happens during\n *   `renderServerComponent` and is swallowed into the RSC stream, so it never\n *   rejects the render promise.\n *\n * Recording the intent on `nav` lets the loader honor the second case by\n * inspecting `nav` after the render resolves, then re-throwing native TanStack\n * nav at the loader boundary.\n */\nexport const createPageRenderServerAdapter = (nav: PageNavIntent): ServerAdapter => ({\n  ...tanstackServerAdapter,\n  notFound: () => {\n    nav.type = 'notFound'\n    throw new Error('not-found')\n  },\n  permanentRedirect: (path: string) => {\n    nav.type = 'redirect'\n    nav.url = path\n    throw new Error(`redirect:${path}`)\n  },\n  redirect: (path: string) => {\n    nav.type = 'redirect'\n    nav.url = path\n    throw new Error(`redirect:${path}`)\n  },\n})\n"],"names":["notFound","redirect","getRequest","setResponseHeader","parseCookies","buildCookieStore","headers","cookies","get","name","value","undefined","getAll","Array","from","entries","map","serializeCookie","options","cookie","encodeURIComponent","path","domain","maxAge","expires","toUTCString","httpOnly","secure","sameSite","charAt","toUpperCase","slice","tanstackServerAdapter","getCookies","request","Headers","getHeaders","to","permanentRedirect","forbidden","Error","unauthorized","setCookie","createPageRenderServerAdapter","nav","type","url"],"mappings":"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"}

package/dist/utilities/serverFunctionClient.d.ts

@@ -0,0 +1,29 @@
+import type { ServerFunctionClient, ServerFunctionClientArgs } from 'payload';
+/**
+ * Builds the client-side `ServerFunctionClient` wired into
+ * `RootProvider.serverFunction`, given the app's `createServerFn`-based
+ * dispatcher (`runServerFn`).
+ *
+ * Strips functions / symbols / RegExps / React elements from the args before
+ * dispatching: the previous `fetch + JSON.stringify` pipeline silently dropped
+ * those, but TanStack Start's seroval-based wire format errors instead. We
+ * mirror the relaxed behaviour so existing callers (e.g. `getFormState` in
+ * `ServerFunctionsProvider`) that may pass the live form state — which can
+ * carry stray functions — keep working without each call site sanitising.
+ *
+ * Delegates to `runServerFn`, so the response (including any RSC handles for
+ * server-rendered custom components) is decoded by TanStack Start back into
+ * renderable React nodes on the client.
+ */
+export declare function createServerFunctionClient({ runServerFn, }: {
+    runServerFn: (input: {
+        data: ServerFunctionClientArgs;
+    }) => Promise<unknown>;
+}): ServerFunctionClient;
+/**
+ * Recursively removes values TanStack Start's seroval wire format cannot
+ * serialize (functions, symbols, RegExps, React elements, cyclic refs) and
+ * normalizes `Date` subclasses to plain `Date`.
+ */
+export declare function stripUnserializable(value: unknown, cache?: WeakMap<object, unknown>, ancestors?: WeakSet<object>): unknown;
+//# sourceMappingURL=serverFunctionClient.d.ts.map

package/dist/utilities/serverFunctionClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverFunctionClient.d.ts","sourceRoot":"","sources":["../../src/utilities/serverFunctionClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,WAAW,GACZ,EAAE;IACD,WAAW,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,wBAAwB,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7E,GAAG,oBAAoB,CAKvB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,KAAK,GAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAiB,EAC/C,SAAS,GAAE,OAAO,CAAC,MAAM,CAAiB,GACzC,OAAO,CA4FT"}