@payloadcms/tanstack-start 4.0.0-internal.183b315

package/dist/utilities/handleServerFunctions.js

@@ -0,0 +1,60 @@
+import { renderTabHandler } from '@payloadcms/ui/elements/Nav/SidebarTabs/renderTabServerFn';
+import { _internal_renderFieldHandler } from '@payloadcms/ui/rsc';
+import { sharedServerFunctions } from '@payloadcms/ui/utilities/serverFunctionRegistry';
+import { getDefaultLayoutHandler } from '@payloadcms/ui/views/Dashboard/Default/ModularDashboard/renderWidget/getDefaultLayoutServerFn';
+import { renderWidgetHandler } from '@payloadcms/ui/views/Dashboard/Default/ModularDashboard/renderWidget/renderWidgetServerFn';
+import { renderDocumentSlotsHandler } from '@payloadcms/ui/views/Document/renderDocumentSlots';
+import { RenderRSCComponent } from '../rsc/renderPayloadRSC.js';
+import { initReq } from './initReq.server.js';
+import { serializeForRsc } from './serializeForRsc.js';
+import { switchLanguageHandler } from './serverFunctionHandlers.js';
+const baseServerFunctions = {
+    ...sharedServerFunctions,
+    'get-default-layout': getDefaultLayoutHandler,
+    'render-document-slots': renderDocumentSlotsHandler,
+    'render-field': _internal_renderFieldHandler,
+    'render-tab': renderTabHandler,
+    'render-widget': renderWidgetHandler,
+    'switch-language': switchLanguageHandler
+};
+/**
+ * Server function dispatcher for TanStack Start.
+ *
+ * Mirrors `packages/next/src/utilities/handleServerFunctions.ts` and uses the
+ * exact same set of handlers — both adapters share `sharedServerFunctions`
+ * plus the small set of RSC-only handlers re-exported by `@payloadcms/ui`.
+ *
+ * Pipes the result through `serializeForRsc`, which converts any React
+ * elements left in the response (e.g. `state[path].customComponents.Field`
+ * produced by `buildFormState`, the `List` / `Document` nodes returned by
+ * `render-list` / `render-document`) into RSC "renderable handles" via
+ * `renderServerComponent` from `@tanstack/react-start/rsc`. TanStack Start's
+ * `$RSC` serialization adapter then ships those handles to the client as
+ * Flight payloads — so this dispatcher must be invoked from a context that
+ * uses TanStack's wire format (e.g. `createServerFn`), not raw
+ * `JSON.stringify`.
+ */ export const handleServerFunctions = async (args)=>{
+    const { name: fnKey, args: fnArgs, config: configPromise, importMap, serverFunctions: extraServerFunctions } = args;
+    const { cookies, locale, permissions, req } = await initReq({
+        configPromise,
+        importMap
+    });
+    const augmentedArgs = {
+        ...fnArgs,
+        cookies,
+        importMap,
+        locale,
+        mode: 'rsc',
+        permissions,
+        renderComponent: RenderRSCComponent,
+        req
+    };
+    const fn = extraServerFunctions?.[fnKey] || baseServerFunctions[fnKey];
+    if (!fn) {
+        throw new Error(`Unknown Server Function: ${fnKey}`);
+    }
+    const result = await fn(augmentedArgs);
+    return await serializeForRsc(result);
+};
+
+//# sourceMappingURL=handleServerFunctions.js.map

package/dist/utilities/handleServerFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/handleServerFunctions.ts"],"sourcesContent":["import type { DefaultServerFunctionArgs, ServerFunction, ServerFunctionHandler } from 'payload'\n\nimport { renderTabHandler } from '@payloadcms/ui/elements/Nav/SidebarTabs/renderTabServerFn'\nimport { _internal_renderFieldHandler } from '@payloadcms/ui/rsc'\nimport { sharedServerFunctions } from '@payloadcms/ui/utilities/serverFunctionRegistry'\nimport { getDefaultLayoutHandler } from '@payloadcms/ui/views/Dashboard/Default/ModularDashboard/renderWidget/getDefaultLayoutServerFn'\nimport { renderWidgetHandler } from '@payloadcms/ui/views/Dashboard/Default/ModularDashboard/renderWidget/renderWidgetServerFn'\nimport { renderDocumentSlotsHandler } from '@payloadcms/ui/views/Document/renderDocumentSlots'\n\nimport { RenderRSCComponent } from '../rsc/renderPayloadRSC.js'\nimport { initReq } from './initReq.server.js'\nimport { serializeForRsc } from './serializeForRsc.js'\nimport { switchLanguageHandler } from './serverFunctionHandlers.js'\n\nconst baseServerFunctions: Record<string, ServerFunction<any, any>> = {\n  ...sharedServerFunctions,\n  'get-default-layout': getDefaultLayoutHandler,\n  'render-document-slots': renderDocumentSlotsHandler,\n  'render-field': _internal_renderFieldHandler,\n  'render-tab': renderTabHandler,\n  'render-widget': renderWidgetHandler,\n  'switch-language': switchLanguageHandler,\n}\n\n/**\n * Server function dispatcher for TanStack Start.\n *\n * Mirrors `packages/next/src/utilities/handleServerFunctions.ts` and uses the\n * exact same set of handlers — both adapters share `sharedServerFunctions`\n * plus the small set of RSC-only handlers re-exported by `@payloadcms/ui`.\n *\n * Pipes the result through `serializeForRsc`, which converts any React\n * elements left in the response (e.g. `state[path].customComponents.Field`\n * produced by `buildFormState`, the `List` / `Document` nodes returned by\n * `render-list` / `render-document`) into RSC \"renderable handles\" via\n * `renderServerComponent` from `@tanstack/react-start/rsc`. TanStack Start's\n * `$RSC` serialization adapter then ships those handles to the client as\n * Flight payloads — so this dispatcher must be invoked from a context that\n * uses TanStack's wire format (e.g. `createServerFn`), not raw\n * `JSON.stringify`.\n */\nexport const handleServerFunctions: ServerFunctionHandler = async (args) => {\n  const {\n    name: fnKey,\n    args: fnArgs,\n    config: configPromise,\n    importMap,\n    serverFunctions: extraServerFunctions,\n  } = args\n\n  const { cookies, locale, permissions, req } = await initReq({\n    configPromise,\n    importMap,\n  })\n\n  const augmentedArgs: DefaultServerFunctionArgs = {\n    ...fnArgs,\n    cookies,\n    importMap,\n    locale,\n    mode: 'rsc',\n    permissions,\n    renderComponent: RenderRSCComponent,\n    req,\n  }\n\n  const fn = extraServerFunctions?.[fnKey] || baseServerFunctions[fnKey]\n\n  if (!fn) {\n    throw new Error(`Unknown Server Function: ${fnKey}`)\n  }\n\n  const result = await fn(augmentedArgs)\n\n  return await serializeForRsc(result)\n}\n"],"names":["renderTabHandler","_internal_renderFieldHandler","sharedServerFunctions","getDefaultLayoutHandler","renderWidgetHandler","renderDocumentSlotsHandler","RenderRSCComponent","initReq","serializeForRsc","switchLanguageHandler","baseServerFunctions","handleServerFunctions","args","name","fnKey","fnArgs","config","configPromise","importMap","serverFunctions","extraServerFunctions","cookies","locale","permissions","req","augmentedArgs","mode","renderComponent","fn","Error","result"],"mappings":"AAEA,SAASA,gBAAgB,QAAQ,4DAA2D;AAC5F,SAASC,4BAA4B,QAAQ,qBAAoB;AACjE,SAASC,qBAAqB,QAAQ,kDAAiD;AACvF,SAASC,uBAAuB,QAAQ,gGAA+F;AACvI,SAASC,mBAAmB,QAAQ,4FAA2F;AAC/H,SAASC,0BAA0B,QAAQ,oDAAmD;AAE9F,SAASC,kBAAkB,QAAQ,6BAA4B;AAC/D,SAASC,OAAO,QAAQ,sBAAqB;AAC7C,SAASC,eAAe,QAAQ,uBAAsB;AACtD,SAASC,qBAAqB,QAAQ,8BAA6B;AAEnE,MAAMC,sBAAgE;IACpE,GAAGR,qBAAqB;IACxB,sBAAsBC;IACtB,yBAAyBE;IACzB,gBAAgBJ;IAChB,cAAcD;IACd,iBAAiBI;IACjB,mBAAmBK;AACrB;AAEA;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,MAAME,wBAA+C,OAAOC;IACjE,MAAM,EACJC,MAAMC,KAAK,EACXF,MAAMG,MAAM,EACZC,QAAQC,aAAa,EACrBC,SAAS,EACTC,iBAAiBC,oBAAoB,EACtC,GAAGR;IAEJ,MAAM,EAAES,OAAO,EAAEC,MAAM,EAAEC,WAAW,EAAEC,GAAG,EAAE,GAAG,MAAMjB,QAAQ;QAC1DU;QACAC;IACF;IAEA,MAAMO,gBAA2C;QAC/C,GAAGV,MAAM;QACTM;QACAH;QACAI;QACAI,MAAM;QACNH;QACAI,iBAAiBrB;QACjBkB;IACF;IAEA,MAAMI,KAAKR,sBAAsB,CAACN,MAAM,IAAIJ,mBAAmB,CAACI,MAAM;IAEtE,IAAI,CAACc,IAAI;QACP,MAAM,IAAIC,MAAM,CAAC,yBAAyB,EAAEf,OAAO;IACrD;IAEA,MAAMgB,SAAS,MAAMF,GAAGH;IAExB,OAAO,MAAMjB,gBAAgBsB;AAC/B,EAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Returns the default output path for the generated import map file
+ * in a TanStack Start project.
+ *
+ * TanStack Start projects typically use `src/` as the source root,
+ * so the import map is placed there.
+ */
+export declare function getImportMapOutputPath(rootDir?: string): string;
+//# sourceMappingURL=importMap.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"importMap.server.d.ts","sourceRoot":"","sources":["../../src/utilities/importMap.server.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/utilities/importMap.server.js

@@ -0,0 +1,12 @@
+import path from 'node:path';
+/**
+ * Returns the default output path for the generated import map file
+ * in a TanStack Start project.
+ *
+ * TanStack Start projects typically use `src/` as the source root,
+ * so the import map is placed there.
+ */ export function getImportMapOutputPath(rootDir) {
+    return path.resolve(rootDir || process.cwd(), 'src', 'payload-import-map.ts');
+}
+
+//# sourceMappingURL=importMap.server.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/importMap.server.ts"],"sourcesContent":["import path from 'node:path'\n\n/**\n * Returns the default output path for the generated import map file\n * in a TanStack Start project.\n *\n * TanStack Start projects typically use `src/` as the source root,\n * so the import map is placed there.\n */\nexport function getImportMapOutputPath(rootDir?: string): string {\n  return path.resolve(rootDir || process.cwd(), 'src', 'payload-import-map.ts')\n}\n"],"names":["path","getImportMapOutputPath","rootDir","resolve","process","cwd"],"mappings":"AAAA,OAAOA,UAAU,YAAW;AAE5B;;;;;;CAMC,GACD,OAAO,SAASC,uBAAuBC,OAAgB;IACrD,OAAOF,KAAKG,OAAO,CAACD,WAAWE,QAAQC,GAAG,IAAI,OAAO;AACvD"}

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

@@ -0,0 +1,19 @@
+import type { ImportMap, InitReqResult, SanitizedConfig, ServerAdapter } from 'payload';
+import { createLocalReq } from 'payload';
+/**
+ * Initializes a Payload request object from the current TanStack Start server context.
+ * Uses `getRequest()` from `@tanstack/react-start/server` to access the incoming request.
+ */
+export declare function initReq({ configPromise, importMap, overrides, serverAdapter, }: {
+    configPromise: Promise<SanitizedConfig> | SanitizedConfig;
+    importMap: ImportMap;
+    overrides?: Parameters<typeof createLocalReq>[0];
+    /**
+     * `ServerAdapter` attached to `req.server`. Defaults to the native
+     * `tanstackServerAdapter` (throws TanStack `redirect`/`notFound`). The admin
+     * page render passes an error-contract adapter so navigation thrown mid-render
+     * is caught at the loader boundary and re-thrown as native TanStack nav.
+     */
+    serverAdapter?: ServerAdapter;
+}): Promise<InitReqResult>;
+//# sourceMappingURL=initReq.server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initReq.server.d.ts","sourceRoot":"","sources":["../../src/utilities/initReq.server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAIvF,OAAO,EACL,cAAc,EAMf,MAAM,SAAS,CAAA;AAMhB;;;GAGG;AACH,wBAAsB,OAAO,CAAC,EAC5B,aAAa,EACb,SAAS,EACT,SAAS,EACT,aAAqC,GACtC,EAAE;IACD,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;IACzD,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B,GAAG,OAAO,CAAC,aAAa,CAAC,CAkFzB"}

package/dist/utilities/initReq.server.js

@@ -0,0 +1,87 @@
+import { initI18n } from '@payloadcms/translations';
+import { getRequest } from '@tanstack/react-start/server';
+import { createLocalReq, executeAuthStrategies, getAccessResults, getPayload, getRequestLanguage, parseCookies } from 'payload';
+import * as qs from 'qs-esm';
+import { getRequestLocale } from './getRequestLocale.js';
+import { tanstackServerAdapter } from './serverAdapter.server.js';
+/**
+ * Initializes a Payload request object from the current TanStack Start server context.
+ * Uses `getRequest()` from `@tanstack/react-start/server` to access the incoming request.
+ */ export async function initReq({ configPromise, importMap, overrides, serverAdapter = tanstackServerAdapter }) {
+    const webRequest = getRequest();
+    const headers = new Headers(webRequest.headers);
+    const cookies = parseCookies(headers);
+    const config = await configPromise;
+    const payload = await getPayload({
+        config,
+        importMap
+    });
+    const languageCode = getRequestLanguage({
+        config,
+        cookies,
+        headers
+    });
+    const i18n = await initI18n({
+        config: config.i18n,
+        context: 'client',
+        language: languageCode
+    });
+    const { responseHeaders, user } = await executeAuthStrategies({
+        headers,
+        payload
+    });
+    const { req: reqOverrides, ...optionsOverrides } = overrides || {};
+    // Parse the active URL's query string so that `req.query` (and thus
+    // `getRequestLocale`, access checks, etc.) reflect things like `?locale=es`
+    // even when the caller (e.g. the root layout loader) hasn't explicitly
+    // forwarded `searchParams` via overrides. `createLocalReq` only defaults
+    // `req.query` to `{}` and never reads the request URL itself.
+    let queryFromUrl;
+    try {
+        const urlObject = new URL(webRequest.url);
+        if (urlObject.search) {
+            queryFromUrl = qs.parse(urlObject.search, {
+                depth: 10,
+                ignoreQueryPrefix: true
+            });
+        }
+    } catch  {
+        queryFromUrl = undefined;
+    }
+    const req = await createLocalReq({
+        req: {
+            headers,
+            host: headers.get('host') ?? undefined,
+            i18n: i18n,
+            query: queryFromUrl,
+            responseHeaders,
+            // Expose the `ServerAdapter` so framework-agnostic server functions can
+            // set cookies / redirect via `req.server` (mirrors the Next.js adapter,
+            // which passes `nextServerAdapter`). Required by handlers like
+            // `switch-language`. Defaults to the native adapter; the page render
+            // overrides it with the error-contract adapter.
+            server: serverAdapter,
+            url: webRequest.url,
+            user,
+            ...reqOverrides || {}
+        },
+        ...optionsOverrides || {}
+    }, payload);
+    const locale = await getRequestLocale({
+        req
+    });
+    req.locale = locale?.code;
+    const permissions = await getAccessResults({
+        req
+    });
+    return {
+        cookies,
+        headers,
+        languageCode,
+        locale,
+        permissions,
+        req
+    };
+}
+
+//# sourceMappingURL=initReq.server.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/initReq.server.ts"],"sourcesContent":["import type { I18n, I18nClient } from '@payloadcms/translations'\nimport type { ImportMap, InitReqResult, SanitizedConfig, ServerAdapter } from 'payload'\n\nimport { initI18n } from '@payloadcms/translations'\nimport { getRequest } from '@tanstack/react-start/server'\nimport {\n  createLocalReq,\n  executeAuthStrategies,\n  getAccessResults,\n  getPayload,\n  getRequestLanguage,\n  parseCookies,\n} from 'payload'\nimport * as qs from 'qs-esm'\n\nimport { getRequestLocale } from './getRequestLocale.js'\nimport { tanstackServerAdapter } from './serverAdapter.server.js'\n\n/**\n * Initializes a Payload request object from the current TanStack Start server context.\n * Uses `getRequest()` from `@tanstack/react-start/server` to access the incoming request.\n */\nexport async function initReq({\n  configPromise,\n  importMap,\n  overrides,\n  serverAdapter = tanstackServerAdapter,\n}: {\n  configPromise: Promise<SanitizedConfig> | SanitizedConfig\n  importMap: ImportMap\n  overrides?: Parameters<typeof createLocalReq>[0]\n  /**\n   * `ServerAdapter` attached to `req.server`. Defaults to the native\n   * `tanstackServerAdapter` (throws TanStack `redirect`/`notFound`). The admin\n   * page render passes an error-contract adapter so navigation thrown mid-render\n   * is caught at the loader boundary and re-thrown as native TanStack nav.\n   */\n  serverAdapter?: ServerAdapter\n}): Promise<InitReqResult> {\n  const webRequest = getRequest()\n  const headers = new Headers(webRequest.headers)\n  const cookies = parseCookies(headers)\n\n  const config = await configPromise\n  const payload = await getPayload({ config, importMap })\n\n  const languageCode = getRequestLanguage({\n    config,\n    cookies,\n    headers,\n  })\n\n  const i18n: I18nClient = await initI18n({\n    config: config.i18n,\n    context: 'client',\n    language: languageCode,\n  })\n\n  const { responseHeaders, user } = await executeAuthStrategies({\n    headers,\n    payload,\n  })\n\n  const { req: reqOverrides, ...optionsOverrides } = overrides || {}\n\n  // Parse the active URL's query string so that `req.query` (and thus\n  // `getRequestLocale`, access checks, etc.) reflect things like `?locale=es`\n  // even when the caller (e.g. the root layout loader) hasn't explicitly\n  // forwarded `searchParams` via overrides. `createLocalReq` only defaults\n  // `req.query` to `{}` and never reads the request URL itself.\n  let queryFromUrl: Record<string, unknown> | undefined\n  try {\n    const urlObject = new URL(webRequest.url)\n    if (urlObject.search) {\n      queryFromUrl = qs.parse(urlObject.search, {\n        depth: 10,\n        ignoreQueryPrefix: true,\n      }) as Record<string, unknown>\n    }\n  } catch {\n    queryFromUrl = undefined\n  }\n\n  const req = await createLocalReq(\n    {\n      req: {\n        headers,\n        host: headers.get('host') ?? undefined,\n        i18n: i18n as I18n,\n        query: queryFromUrl,\n        responseHeaders,\n        // Expose the `ServerAdapter` so framework-agnostic server functions can\n        // set cookies / redirect via `req.server` (mirrors the Next.js adapter,\n        // which passes `nextServerAdapter`). Required by handlers like\n        // `switch-language`. Defaults to the native adapter; the page render\n        // overrides it with the error-contract adapter.\n        server: serverAdapter,\n        url: webRequest.url,\n        user,\n        ...(reqOverrides || {}),\n      },\n      ...(optionsOverrides || {}),\n    },\n    payload,\n  )\n\n  const locale = await getRequestLocale({ req })\n\n  req.locale = locale?.code\n\n  const permissions = await getAccessResults({ req })\n\n  return {\n    cookies,\n    headers,\n    languageCode,\n    locale,\n    permissions,\n    req,\n  }\n}\n"],"names":["initI18n","getRequest","createLocalReq","executeAuthStrategies","getAccessResults","getPayload","getRequestLanguage","parseCookies","qs","getRequestLocale","tanstackServerAdapter","initReq","configPromise","importMap","overrides","serverAdapter","webRequest","headers","Headers","cookies","config","payload","languageCode","i18n","context","language","responseHeaders","user","req","reqOverrides","optionsOverrides","queryFromUrl","urlObject","URL","url","search","parse","depth","ignoreQueryPrefix","undefined","host","get","query","server","locale","code","permissions"],"mappings":"AAGA,SAASA,QAAQ,QAAQ,2BAA0B;AACnD,SAASC,UAAU,QAAQ,+BAA8B;AACzD,SACEC,cAAc,EACdC,qBAAqB,EACrBC,gBAAgB,EAChBC,UAAU,EACVC,kBAAkB,EAClBC,YAAY,QACP,UAAS;AAChB,YAAYC,QAAQ,SAAQ;AAE5B,SAASC,gBAAgB,QAAQ,wBAAuB;AACxD,SAASC,qBAAqB,QAAQ,4BAA2B;AAEjE;;;CAGC,GACD,OAAO,eAAeC,QAAQ,EAC5BC,aAAa,EACbC,SAAS,EACTC,SAAS,EACTC,gBAAgBL,qBAAqB,EAYtC;IACC,MAAMM,aAAaf;IACnB,MAAMgB,UAAU,IAAIC,QAAQF,WAAWC,OAAO;IAC9C,MAAME,UAAUZ,aAAaU;IAE7B,MAAMG,SAAS,MAAMR;IACrB,MAAMS,UAAU,MAAMhB,WAAW;QAAEe;QAAQP;IAAU;IAErD,MAAMS,eAAehB,mBAAmB;QACtCc;QACAD;QACAF;IACF;IAEA,MAAMM,OAAmB,MAAMvB,SAAS;QACtCoB,QAAQA,OAAOG,IAAI;QACnBC,SAAS;QACTC,UAAUH;IACZ;IAEA,MAAM,EAAEI,eAAe,EAAEC,IAAI,EAAE,GAAG,MAAMxB,sBAAsB;QAC5Dc;QACAI;IACF;IAEA,MAAM,EAAEO,KAAKC,YAAY,EAAE,GAAGC,kBAAkB,GAAGhB,aAAa,CAAC;IAEjE,oEAAoE;IACpE,4EAA4E;IAC5E,uEAAuE;IACvE,yEAAyE;IACzE,8DAA8D;IAC9D,IAAIiB;IACJ,IAAI;QACF,MAAMC,YAAY,IAAIC,IAAIjB,WAAWkB,GAAG;QACxC,IAAIF,UAAUG,MAAM,EAAE;YACpBJ,eAAevB,GAAG4B,KAAK,CAACJ,UAAUG,MAAM,EAAE;gBACxCE,OAAO;gBACPC,mBAAmB;YACrB;QACF;IACF,EAAE,OAAM;QACNP,eAAeQ;IACjB;IAEA,MAAMX,MAAM,MAAM1B,eAChB;QACE0B,KAAK;YACHX;YACAuB,MAAMvB,QAAQwB,GAAG,CAAC,WAAWF;YAC7BhB,MAAMA;YACNmB,OAAOX;YACPL;YACA,wEAAwE;YACxE,wEAAwE;YACxE,+DAA+D;YAC/D,qEAAqE;YACrE,gDAAgD;YAChDiB,QAAQ5B;YACRmB,KAAKlB,WAAWkB,GAAG;YACnBP;YACA,GAAIE,gBAAgB,CAAC,CAAC;QACxB;QACA,GAAIC,oBAAoB,CAAC,CAAC;IAC5B,GACAT;IAGF,MAAMuB,SAAS,MAAMnC,iBAAiB;QAAEmB;IAAI;IAE5CA,IAAIgB,MAAM,GAAGA,QAAQC;IAErB,MAAMC,cAAc,MAAM1C,iBAAiB;QAAEwB;IAAI;IAEjD,OAAO;QACLT;QACAF;QACAK;QACAsB;QACAE;QACAlB;IACF;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":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7D"}

package/dist/utilities/serializeForRsc.js

@@ -0,0 +1,105 @@
+import { renderServerComponent } from '@tanstack/react-start/rsc';
+/**
+ * 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)) {
+        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'\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    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","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","arr","item","push","ArrayBuffer","isView","result","key","Object","keys"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,4BAA2B;AAEjE;;;;;;;;;;;;;;;;;;;;;;;CAuBC,GACD,OAAO,eAAeC,gBAAmBC,KAAQ;IAC/C,OAAQ,MAAMC,KAAKD,OAAO,IAAIE,WAA4B,IAAIC;AAChE;AAEA,eAAeF,KACbD,KAAc,EACdI,KAA+B,EAC/BC,SAA0B;IAE1B,IAAIL,UAAU,QAAQA,UAAUM,WAAW;QACzC,OAAON;IACT;IAEA,MAAMO,IAAI,OAAOP;IACjB,IAAIO,MAAM,cAAcA,MAAM,UAAU;QACtC,OAAOD;IACT;IACA,IAAIC,MAAM,UAAU;QAClB,OAAOP;IACT;IAEA,MAAMQ,MAAMR;IAEZ,IAAI,OAAOQ,IAAIC,QAAQ,KAAK,UAAU;QACpC,OAAO,MAAMX,sBAAsBE;IACrC;IAEA,IAAIK,UAAUK,GAAG,CAACF,MAAM;QACtB,OAAOF;IACT;IAEA,IAAIF,MAAMM,GAAG,CAACF,MAAM;QAClB,OAAOJ,MAAMO,GAAG,CAACH;IACnB;IAEA,IAAIA,eAAeI,MAAM;QACvB,OAAOJ;IACT;IAEA,IAAIA,eAAeK,QAAQ;QACzB,OAAOP;IACT;IAEAD,UAAUS,GAAG,CAACN;IAEd,IAAIA,eAAeO,KAAK;QACtB,MAAMC,UAAU,IAAID;QACpBX,MAAMa,GAAG,CAACT,KAAKQ;QACf,KAAK,MAAM,CAACE,GAAGC,EAAE,IAAIX,IAAK;YACxB,MAAMY,KAAK,MAAMnB,KAAKkB,GAAGf,OAAOC;YAChC,IAAIe,OAAOd,WAAW;gBACpBU,QAAQC,GAAG,CAACC,GAAGE;YACjB;QACF;QACAf,UAAUgB,MAAM,CAACb;QACjB,OAAOQ;IACT;IAEA,IAAIR,eAAec,KAAK;QACtB,MAAMN,UAAU,IAAIM;QACpBlB,MAAMa,GAAG,CAACT,KAAKQ;QACf,KAAK,MAAMG,KAAKX,IAAK;YACnB,MAAMY,KAAK,MAAMnB,KAAKkB,GAAGf,OAAOC;YAChC,IAAIe,OAAOd,WAAW;gBACpBU,QAAQF,GAAG,CAACM;YACd;QACF;QACAf,UAAUgB,MAAM,CAACb;QACjB,OAAOQ;IACT;IAEA,IAAIO,MAAMC,OAAO,CAAChB,MAAM;QACtB,MAAMiB,MAAiB,EAAE;QACzBrB,MAAMa,GAAG,CAACT,KAAKiB;QACf,KAAK,MAAMC,QAAQlB,IAAK;YACtBiB,IAAIE,IAAI,CAAC,MAAM1B,KAAKyB,MAAMtB,OAAOC;QACnC;QACAA,UAAUgB,MAAM,CAACb;QACjB,OAAOiB;IACT;IAEA,IAAIG,YAAYC,MAAM,CAACrB,MAAM;QAC3BH,UAAUgB,MAAM,CAACb;QACjB,OAAOA;IACT;IAEA,MAAMsB,SAAkC,CAAC;IACzC1B,MAAMa,GAAG,CAACT,KAAKsB;IACf,KAAK,MAAMC,OAAOC,OAAOC,IAAI,CAACzB,KAAM;QAClC,MAAMW,IAAI,MAAMlB,KAAKO,GAAG,CAACuB,IAAI,EAAE3B,OAAOC;QACtC,IAAIc,MAAMb,WAAW;YACnBwB,MAAM,CAACC,IAAI,GAAGZ;QAChB;IACF;IACAd,UAAUgB,MAAM,CAACb;IACjB,OAAOsB;AACT"}

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