@payloadcms/tanstack-start 4.0.0-canary.8

package/dist/utilities/handleAPIRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/handleAPIRoute.ts"],"sourcesContent":["import type { SanitizedConfig } from 'payload'\n\nimport { handleEndpoints } from 'payload'\n\n/**\n * Routes a TanStack Start API request (`/api/*`) to Payload's REST/GraphQL\n * endpoint handler. The framework adapter wires this into the `/api/$` route's\n * server handlers, supplying the app's resolved `config`.\n */\nexport async function handleAPIRoute({\n  config,\n  request,\n}: {\n  config: SanitizedConfig\n  request: Request\n}): Promise<Response> {\n  const url = new URL(request.url)\n  const slugParts = url.pathname\n    .replace(/^\\/api\\/?/, '')\n    .split('/')\n    .filter(Boolean)\n  const path = slugParts.length ? `/api/${slugParts.join('/')}` : '/api'\n\n  return handleEndpoints({\n    config,\n    path,\n    request,\n  })\n}\n"],"names":["handleEndpoints","handleAPIRoute","config","request","url","URL","slugParts","pathname","replace","split","filter","Boolean","path","length","join"],"mappings":"AAEA,SAASA,eAAe,QAAQ,UAAS;AAEzC;;;;CAIC,GACD,OAAO,eAAeC,eAAe,EACnCC,MAAM,EACNC,OAAO,EAIR;IACC,MAAMC,MAAM,IAAIC,IAAIF,QAAQC,GAAG;IAC/B,MAAME,YAAYF,IAAIG,QAAQ,CAC3BC,OAAO,CAAC,aAAa,IACrBC,KAAK,CAAC,KACNC,MAAM,CAACC;IACV,MAAMC,OAAON,UAAUO,MAAM,GAAG,CAAC,KAAK,EAAEP,UAAUQ,IAAI,CAAC,MAAM,GAAG;IAEhE,OAAOd,gBAAgB;QACrBE;QACAU;QACAT;IACF;AACF"}

package/dist/utilities/handleServerFunctions.d.ts

@@ -0,0 +1,20 @@
+import type { ServerFunctionHandler } from 'payload';
+/**
+ * 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 declare const handleServerFunctions: ServerFunctionHandler;
+//# sourceMappingURL=handleServerFunctions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handleServerFunctions.d.ts","sourceRoot":"","sources":["../../src/utilities/handleServerFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6C,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAwB/F;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAkCnC,CAAA"}

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,8 @@
+/**
+ * Returns the default output path for the generated import map file in a
+ * TanStack Start project. Matches the `app/_payload/` convention that Payload's
+ * import map auto-discovery probes, so the file is found without a custom
+ * `admin.importMap.importMapFile` override.
+ */
+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;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/utilities/importMap.server.js

@@ -0,0 +1,11 @@
+import path from 'node:path';
+/**
+ * Returns the default output path for the generated import map file in a
+ * TanStack Start project. Matches the `app/_payload/` convention that Payload's
+ * import map auto-discovery probes, so the file is found without a custom
+ * `admin.importMap.importMapFile` override.
+ */ export function getImportMapOutputPath(rootDir) {
+    return path.resolve(rootDir || process.cwd(), 'app', '_payload', 'importMap.js');
+}
+
+//# 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 in a\n * TanStack Start project. Matches the `app/_payload/` convention that Payload's\n * import map auto-discovery probes, so the file is found without a custom\n * `admin.importMap.importMapFile` override.\n */\nexport function getImportMapOutputPath(rootDir?: string): string {\n  return path.resolve(rootDir || process.cwd(), 'app', '_payload', 'importMap.js')\n}\n"],"names":["path","getImportMapOutputPath","rootDir","resolve","process","cwd"],"mappings":"AAAA,OAAOA,UAAU,YAAW;AAE5B;;;;;CAKC,GACD,OAAO,SAASC,uBAAuBC,OAAgB;IACrD,OAAOF,KAAKG,OAAO,CAACD,WAAWE,QAAQC,GAAG,IAAI,OAAO,YAAY;AACnE"}

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/loadAdminPage.d.ts

@@ -0,0 +1,54 @@
+import type { ImportMap, SanitizedConfig } from 'payload';
+import type { AdminPageMetadata } from './meta.js';
+export type LoadAdminPageArgs = {
+    config: SanitizedConfig;
+    importMap: ImportMap;
+    search?: Record<string, string | string[]>;
+    splat?: string;
+};
+export type LoadAdminPageResult = {
+    _notFound: true;
+    routeKey?: string;
+    rscPayload?: React.ReactNode;
+} | {
+    _redirect: string;
+} | {
+    metadata: AdminPageMetadata;
+    /**
+     * Stable identity for this rendered route (the splat, i.e. the path
+     * after `/admin/`). The client keys the rendered subtree by this so the
+     * view remounts exactly when a new payload arrives. Keying by
+     * `location.pathname` instead races: the pathname updates before
+     * `useLoaderData()` during a transition, so the subtree would remount
+     * with the *previous* payload and then reconcile the fresh payload in
+     * place — leaving client providers (DocumentInfo, etc.) holding stale
+     * `useState` values from the prior document. Search params are excluded
+     * so search-only changes (e.g. list-view filtering) reconcile in place.
+     */
+    routeKey: string;
+    rscPayload: React.ReactNode;
+};
+/**
+ * Renders an admin page for TanStack Start and returns a serializable loader
+ * result. The framework adapter wraps this in a `createServerFn` that supplies
+ * the app's `config` and generated `importMap`.
+ *
+ *   1. Initializes the Payload request via the shared `renderRoot` orchestrator
+ *      from `@payloadcms/ui`, passing a TanStack-bound `initReq`. The injected
+ *      page-render `ServerAdapter` records navigation intent and throws the
+ *      framework-agnostic error contract.
+ *   2. Pipes the resulting React server tree through `renderServerComponent`
+ *      to produce a Flight payload the client consumes directly.
+ *   3. Resolves page metadata via the same shared `generatePageMetadata`
+ *      Next.js uses, returning plain serializable strings for `head()`.
+ *
+ * Navigation surfaces two ways and both become a `_notFound` / `_redirect`
+ * sentinel the route loader re-throws as native TanStack nav:
+ * - thrown during `renderRoot` orchestration (e.g. the login redirect) → caught
+ *   by the try/catch below;
+ * - thrown deep inside a streamed view component (e.g. `DocumentView` access
+ *   denied, `LoginView` already-authenticated) → swallowed into the RSC stream,
+ *   so it's read from the `nav` holder after `renderServerComponent` resolves.
+ */
+export declare function loadAdminPage({ config, importMap, search, splat, }: LoadAdminPageArgs): Promise<LoadAdminPageResult>;
+//# sourceMappingURL=loadAdminPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadAdminPage.d.ts","sourceRoot":"","sources":["../../src/utilities/loadAdminPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,eAAe,EAAE,MAAM,SAAS,CAAA;AAIrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAMlD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,GACpE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACrB;IACE,QAAQ,EAAE,iBAAiB,CAAA;IAC3B;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B,CAAA;AA0FL;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CAAC,EAClC,MAAM,EACN,SAAS,EACT,MAAM,EACN,KAAK,GACN,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoJlD"}

package/dist/utilities/loadAdminPage.js

@@ -0,0 +1,230 @@
+import { renderServerComponent } from '@tanstack/react-start/rsc';
+import { getRequestI18n } from './getRequestI18n.server.js';
+import { initReq } from './initReq.server.js';
+import { createPageRenderServerAdapter } from './serverAdapter.server.js';
+const resolveTitle = (title)=>{
+    if (!title) {
+        return undefined;
+    }
+    if (typeof title === 'string') {
+        return title;
+    }
+    if ('absolute' in title) {
+        return title.absolute;
+    }
+    return title.default;
+};
+/**
+ * Flattens the framework-agnostic `MetaConfig` (Next.js `Metadata` shape) into
+ * the plain, serializable `AdminPageMetadata` the route loader ships to the
+ * client. The full `MetaConfig` carries a `URL` `metadataBase`, functions and
+ * other non-serializable values that seroval cannot cross the wire, so only the
+ * fields `getAdminMeta` renders are extracted.
+ */ const toAdminPageMetadata = (meta)=>{
+    const og = meta.openGraph;
+    const rawImages = og?.images;
+    const imagesArray = rawImages ? Array.isArray(rawImages) ? rawImages : [
+        rawImages
+    ] : [];
+    const images = imagesArray.map((image)=>typeof image === 'string' ? {
+            url: image
+        } : image?.url ? {
+            alt: image.alt,
+            height: image.height,
+            url: String(image.url),
+            width: image.width
+        } : undefined).filter(Boolean);
+    const rawIcons = meta.icons;
+    const iconList = Array.isArray(rawIcons) ? rawIcons : rawIcons && typeof rawIcons === 'object' && Array.isArray(rawIcons.icon) ? rawIcons.icon : [];
+    const icons = iconList.map((icon)=>typeof icon === 'string' ? {
+            rel: 'icon',
+            url: icon
+        } : icon?.url ? {
+            type: icon.type,
+            media: icon.media,
+            rel: icon.rel ?? 'icon',
+            sizes: icon.sizes,
+            url: String(icon.url)
+        } : undefined).filter(Boolean);
+    const keywords = meta.keywords;
+    return {
+        description: typeof meta.description === 'string' ? meta.description : undefined,
+        icons: icons?.length ? icons : undefined,
+        keywords: typeof keywords === 'string' ? keywords : Array.isArray(keywords) ? keywords.join(', ') : undefined,
+        openGraph: og ? {
+            description: typeof og.description === 'string' ? og.description : undefined,
+            images: images?.length ? images : undefined,
+            siteName: typeof og.siteName === 'string' ? og.siteName : undefined,
+            title: typeof og.title === 'string' ? og.title : undefined
+        } : undefined,
+        robots: typeof meta.robots === 'string' ? meta.robots : undefined,
+        title: resolveTitle(meta.title)
+    };
+};
+/**
+ * Renders an admin page for TanStack Start and returns a serializable loader
+ * result. The framework adapter wraps this in a `createServerFn` that supplies
+ * the app's `config` and generated `importMap`.
+ *
+ *   1. Initializes the Payload request via the shared `renderRoot` orchestrator
+ *      from `@payloadcms/ui`, passing a TanStack-bound `initReq`. The injected
+ *      page-render `ServerAdapter` records navigation intent and throws the
+ *      framework-agnostic error contract.
+ *   2. Pipes the resulting React server tree through `renderServerComponent`
+ *      to produce a Flight payload the client consumes directly.
+ *   3. Resolves page metadata via the same shared `generatePageMetadata`
+ *      Next.js uses, returning plain serializable strings for `head()`.
+ *
+ * Navigation surfaces two ways and both become a `_notFound` / `_redirect`
+ * sentinel the route loader re-throws as native TanStack nav:
+ * - thrown during `renderRoot` orchestration (e.g. the login redirect) → caught
+ *   by the try/catch below;
+ * - thrown deep inside a streamed view component (e.g. `DocumentView` access
+ *   denied, `LoginView` already-authenticated) → swallowed into the RSC stream,
+ *   so it's read from the `nav` holder after `renderServerComponent` resolves.
+ */ export async function loadAdminPage({ config, importMap, search, splat }) {
+    const { renderRoot } = await import('@payloadcms/ui/views/Root');
+    const { defaultAdminViews } = await import('@payloadcms/ui/views/Root/adminViews');
+    const { generatePageMetadata } = await import('@payloadcms/ui/views/Root/generatePageMetadata');
+    const splatSegments = splat ? splat.split('/').filter(Boolean) : [];
+    // Match Next's optional-catch-all behavior: the admin root (`/admin`) has no
+    // segments. Passing an empty array makes the shared `renderRoot` build
+    // `currentRoute` as `/admin/` (trailing slash), which no longer equals
+    // `adminRoute` and causes `handleAuthRedirect` to append `?redirect=/admin/`.
+    // Passing `undefined` yields `currentRoute = /admin`, so the unauthenticated
+    // redirect lands on a clean `/admin/login`.
+    const segments = splatSegments.length > 0 ? splatSegments : undefined;
+    const searchParams = search ?? {};
+    // Records navigation requested via `req.server.*` (including throws swallowed
+    // by RSC streaming deep inside view components). Read after the render.
+    const nav = {};
+    const pageServerAdapter = createPageRenderServerAdapter(nav);
+    // `renderRoot` calls `initReq` itself with its own overrides (query
+    // re-nesting, `urlSuffix`, `fallbackLocale`). Forward them, injecting the
+    // page-render `ServerAdapter` so `req.server.redirect()` / `.notFound()`
+    // is recorded + thrown rather than escaping as raw TanStack nav.
+    const boundInitReq = (args)=>initReq({
+            configPromise: args.configPromise,
+            importMap: args.importMap,
+            overrides: args.overrides,
+            serverAdapter: pageServerAdapter
+        });
+    const notFound = ()=>{
+        nav.type = 'notFound';
+        throw new Error('not-found');
+    };
+    const redirect = (url)=>{
+        nav.type = 'redirect';
+        nav.url = url;
+        throw new Error(`redirect:${url}`);
+    };
+    // Build the 404 result the route loader re-throws as TanStack `notFound()`.
+    //
+    // Throwing `notFound()` is the only way to set the SSR document status to 404
+    // (it's read from `router.stores.statusCode`, set by a not-found match — NOT
+    // from `setResponseStatus`, which only affects the RSC RPC response). But the
+    // matching `notFoundComponent` is a client component with no access to the
+    // Payload `req`, so it can't build the admin chrome on its own. To match Next
+    // (whose not-found route renders the full admin layout — nav sidebar, etc. —
+    // around the NotFound body, see `renderNotFoundPage`), we render that same
+    // shared `renderNotFoundPage` tree here, server-side, and ship its Flight
+    // payload through the `notFound()` error so the client renders it verbatim.
+    // For users without admin access `renderNotFoundPage` returns the bare
+    // `NotFoundClient`, preserving the access-denied behavior.
+    const renderNotFound = async ()=>{
+        const { renderNotFoundPage } = await import('@payloadcms/ui/views/NotFound/page');
+        const notFoundNode = await renderNotFoundPage({
+            config: Promise.resolve(config),
+            importMap,
+            initReq: (args)=>initReq({
+                    configPromise: args.configPromise,
+                    importMap: args.importMap,
+                    overrides: args.overrides
+                }),
+            params: Promise.resolve({
+                segments: splatSegments
+            }),
+            searchParams: Promise.resolve(searchParams)
+        });
+        const rscPayload = await renderServerComponent(notFoundNode);
+        return {
+            _notFound: true,
+            routeKey: splat ?? '',
+            rscPayload
+        };
+    };
+    try {
+        const node = await renderRoot({
+            adminViews: defaultAdminViews,
+            config: Promise.resolve(config),
+            importMap,
+            initReq: boundInitReq,
+            notFound,
+            // `segments` is intentionally `undefined` for the admin root (`/admin`),
+            // matching Next's optional catch-all; `renderRoot` handles it at runtime.
+            params: Promise.resolve({
+                segments
+            }),
+            redirect,
+            searchParams: Promise.resolve(searchParams)
+        });
+        const rscPayload = await renderServerComponent(node);
+        // The server-function (client-nav RPC) path returns the flight stream unread —
+        // unlike the router/SSR path, which awaits a decode that drives the render to
+        // completion. So streamed side effects (e.g. DocumentView's autosave-create
+        // `server.redirect()`) haven't run yet and `nav` is empty. Buffer the stream to
+        // completion to force the render (populating `nav`), then hand the client a fresh
+        // replayable stream from that buffer.
+        if (!nav.type) {
+            const wrapper = rscPayload[Symbol.for('tanstack.rsc.stream')];
+            if (typeof wrapper?.createReplayStream === 'function') {
+                const buffer = await new Response(wrapper.createReplayStream()).arrayBuffer();
+                wrapper.createReplayStream = ()=>new Response(buffer).body;
+            }
+        }
+        // Navigation thrown deep inside a streamed view component (e.g. access
+        // denied → notFound, already-authenticated → redirect) is swallowed into
+        // the RSC stream and never rejects the render. Honor it from the holder,
+        // discarding the (broken) payload from the aborted render.
+        if (nav.type === 'redirect' && nav.url) {
+            return {
+                _redirect: nav.url
+            };
+        }
+        if (nav.type === 'notFound') {
+            return await renderNotFound();
+        }
+        // Resolve metadata through the same shared generator Next.js uses. Only
+        // plain strings cross the wire (the full `MetaConfig` carries a `URL`
+        // `metadataBase` and icons that seroval cannot serialize).
+        const i18n = await getRequestI18n({
+            config
+        });
+        const meta = await generatePageMetadata({
+            adminViews: defaultAdminViews,
+            config,
+            i18n,
+            params: {
+                segments
+            }
+        });
+        return {
+            metadata: toAdminPageMetadata(meta),
+            routeKey: splat ?? '',
+            rscPayload
+        };
+    } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (nav.type === 'notFound' || message === 'not-found') {
+            return await renderNotFound();
+        }
+        if (nav.type === 'redirect' || message.startsWith('redirect:')) {
+            return {
+                _redirect: nav.url ?? message.slice('redirect:'.length)
+            };
+        }
+        throw err;
+    }
+}
+
+//# sourceMappingURL=loadAdminPage.js.map

package/dist/utilities/loadAdminPage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/loadAdminPage.tsx"],"sourcesContent":["import type { ImportMap, MetaConfig, SanitizedConfig } from 'payload'\n\nimport { renderServerComponent } from '@tanstack/react-start/rsc'\n\nimport type { AdminPageMetadata } from './meta.js'\n\nimport { getRequestI18n } from './getRequestI18n.server.js'\nimport { initReq } from './initReq.server.js'\nimport { createPageRenderServerAdapter } from './serverAdapter.server.js'\n\nexport type LoadAdminPageArgs = {\n  config: SanitizedConfig\n  importMap: ImportMap\n  search?: Record<string, string | string[]>\n  splat?: string\n}\n\nexport type LoadAdminPageResult =\n  | { _notFound: true; routeKey?: string; rscPayload?: React.ReactNode }\n  | { _redirect: string }\n  | {\n      metadata: AdminPageMetadata\n      /**\n       * Stable identity for this rendered route (the splat, i.e. the path\n       * after `/admin/`). The client keys the rendered subtree by this so the\n       * view remounts exactly when a new payload arrives. Keying by\n       * `location.pathname` instead races: the pathname updates before\n       * `useLoaderData()` during a transition, so the subtree would remount\n       * with the *previous* payload and then reconcile the fresh payload in\n       * place — leaving client providers (DocumentInfo, etc.) holding stale\n       * `useState` values from the prior document. Search params are excluded\n       * so search-only changes (e.g. list-view filtering) reconcile in place.\n       */\n      routeKey: string\n      rscPayload: React.ReactNode\n    }\n\nconst resolveTitle = (title: MetaConfig['title']): string | undefined => {\n  if (!title) {\n    return undefined\n  }\n  if (typeof title === 'string') {\n    return title\n  }\n  if ('absolute' in title) {\n    return title.absolute\n  }\n  return title.default\n}\n\n/**\n * Flattens the framework-agnostic `MetaConfig` (Next.js `Metadata` shape) into\n * the plain, serializable `AdminPageMetadata` the route loader ships to the\n * client. The full `MetaConfig` carries a `URL` `metadataBase`, functions and\n * other non-serializable values that seroval cannot cross the wire, so only the\n * fields `getAdminMeta` renders are extracted.\n */\nconst toAdminPageMetadata = (meta: MetaConfig): AdminPageMetadata => {\n  const og = meta.openGraph as\n    | {\n        description?: unknown\n        images?: unknown\n        siteName?: unknown\n        title?: unknown\n      }\n    | undefined\n\n  const rawImages = og?.images\n  const imagesArray = rawImages ? (Array.isArray(rawImages) ? rawImages : [rawImages]) : []\n  const images = imagesArray\n    .map((image: any) =>\n      typeof image === 'string'\n        ? { url: image }\n        : image?.url\n          ? { alt: image.alt, height: image.height, url: String(image.url), width: image.width }\n          : undefined,\n    )\n    .filter(Boolean) as NonNullable<AdminPageMetadata['openGraph']>['images']\n\n  const rawIcons = meta.icons as any\n  const iconList = Array.isArray(rawIcons)\n    ? rawIcons\n    : rawIcons && typeof rawIcons === 'object' && Array.isArray(rawIcons.icon)\n      ? rawIcons.icon\n      : []\n  const icons = iconList\n    .map((icon: any) =>\n      typeof icon === 'string'\n        ? { rel: 'icon', url: icon }\n        : icon?.url\n          ? {\n              type: icon.type,\n              media: icon.media,\n              rel: icon.rel ?? 'icon',\n              sizes: icon.sizes,\n              url: String(icon.url),\n            }\n          : undefined,\n    )\n    .filter(Boolean) as AdminPageMetadata['icons']\n\n  const keywords = meta.keywords\n\n  return {\n    description: typeof meta.description === 'string' ? meta.description : undefined,\n    icons: icons?.length ? icons : undefined,\n    keywords:\n      typeof keywords === 'string'\n        ? keywords\n        : Array.isArray(keywords)\n          ? keywords.join(', ')\n          : undefined,\n    openGraph: og\n      ? {\n          description: typeof og.description === 'string' ? og.description : undefined,\n          images: images?.length ? images : undefined,\n          siteName: typeof og.siteName === 'string' ? og.siteName : undefined,\n          title: typeof og.title === 'string' ? og.title : undefined,\n        }\n      : undefined,\n    robots: typeof meta.robots === 'string' ? meta.robots : undefined,\n    title: resolveTitle(meta.title),\n  }\n}\n\n/**\n * Renders an admin page for TanStack Start and returns a serializable loader\n * result. The framework adapter wraps this in a `createServerFn` that supplies\n * the app's `config` and generated `importMap`.\n *\n *   1. Initializes the Payload request via the shared `renderRoot` orchestrator\n *      from `@payloadcms/ui`, passing a TanStack-bound `initReq`. The injected\n *      page-render `ServerAdapter` records navigation intent and throws the\n *      framework-agnostic error contract.\n *   2. Pipes the resulting React server tree through `renderServerComponent`\n *      to produce a Flight payload the client consumes directly.\n *   3. Resolves page metadata via the same shared `generatePageMetadata`\n *      Next.js uses, returning plain serializable strings for `head()`.\n *\n * Navigation surfaces two ways and both become a `_notFound` / `_redirect`\n * sentinel the route loader re-throws as native TanStack nav:\n * - thrown during `renderRoot` orchestration (e.g. the login redirect) → caught\n *   by the try/catch below;\n * - thrown deep inside a streamed view component (e.g. `DocumentView` access\n *   denied, `LoginView` already-authenticated) → swallowed into the RSC stream,\n *   so it's read from the `nav` holder after `renderServerComponent` resolves.\n */\nexport async function loadAdminPage({\n  config,\n  importMap,\n  search,\n  splat,\n}: LoadAdminPageArgs): Promise<LoadAdminPageResult> {\n  const { renderRoot } = await import('@payloadcms/ui/views/Root')\n  const { defaultAdminViews } = await import('@payloadcms/ui/views/Root/adminViews')\n  const { generatePageMetadata } = await import('@payloadcms/ui/views/Root/generatePageMetadata')\n\n  const splatSegments = splat ? splat.split('/').filter(Boolean) : []\n  // Match Next's optional-catch-all behavior: the admin root (`/admin`) has no\n  // segments. Passing an empty array makes the shared `renderRoot` build\n  // `currentRoute` as `/admin/` (trailing slash), which no longer equals\n  // `adminRoute` and causes `handleAuthRedirect` to append `?redirect=/admin/`.\n  // Passing `undefined` yields `currentRoute = /admin`, so the unauthenticated\n  // redirect lands on a clean `/admin/login`.\n  const segments = splatSegments.length > 0 ? splatSegments : undefined\n  const searchParams = search ?? {}\n\n  // Records navigation requested via `req.server.*` (including throws swallowed\n  // by RSC streaming deep inside view components). Read after the render.\n  const nav: { type?: 'notFound' | 'redirect'; url?: string } = {}\n  const pageServerAdapter = createPageRenderServerAdapter(nav)\n\n  // `renderRoot` calls `initReq` itself with its own overrides (query\n  // re-nesting, `urlSuffix`, `fallbackLocale`). Forward them, injecting the\n  // page-render `ServerAdapter` so `req.server.redirect()` / `.notFound()`\n  // is recorded + thrown rather than escaping as raw TanStack nav.\n  const boundInitReq: Parameters<typeof renderRoot>[0]['initReq'] = (args) =>\n    initReq({\n      configPromise: args.configPromise,\n      importMap: args.importMap,\n      overrides: args.overrides,\n      serverAdapter: pageServerAdapter,\n    })\n\n  const notFound = (): never => {\n    nav.type = 'notFound'\n    throw new Error('not-found')\n  }\n  const redirect = (url: string): never => {\n    nav.type = 'redirect'\n    nav.url = url\n    throw new Error(`redirect:${url}`)\n  }\n\n  // Build the 404 result the route loader re-throws as TanStack `notFound()`.\n  //\n  // Throwing `notFound()` is the only way to set the SSR document status to 404\n  // (it's read from `router.stores.statusCode`, set by a not-found match — NOT\n  // from `setResponseStatus`, which only affects the RSC RPC response). But the\n  // matching `notFoundComponent` is a client component with no access to the\n  // Payload `req`, so it can't build the admin chrome on its own. To match Next\n  // (whose not-found route renders the full admin layout — nav sidebar, etc. —\n  // around the NotFound body, see `renderNotFoundPage`), we render that same\n  // shared `renderNotFoundPage` tree here, server-side, and ship its Flight\n  // payload through the `notFound()` error so the client renders it verbatim.\n  // For users without admin access `renderNotFoundPage` returns the bare\n  // `NotFoundClient`, preserving the access-denied behavior.\n  const renderNotFound = async (): Promise<LoadAdminPageResult> => {\n    const { renderNotFoundPage } = await import('@payloadcms/ui/views/NotFound/page')\n\n    const notFoundNode = await renderNotFoundPage({\n      config: Promise.resolve(config),\n      importMap,\n      initReq: (args) =>\n        initReq({\n          configPromise: args.configPromise,\n          importMap: args.importMap,\n          overrides: args.overrides,\n        }),\n      params: Promise.resolve({ segments: splatSegments }),\n      searchParams: Promise.resolve(searchParams),\n    })\n\n    const rscPayload = await renderServerComponent(notFoundNode as React.ReactElement)\n\n    return { _notFound: true, routeKey: splat ?? '', rscPayload }\n  }\n\n  try {\n    const node = await renderRoot({\n      adminViews: defaultAdminViews,\n      config: Promise.resolve(config),\n      importMap,\n      initReq: boundInitReq,\n      notFound,\n      // `segments` is intentionally `undefined` for the admin root (`/admin`),\n      // matching Next's optional catch-all; `renderRoot` handles it at runtime.\n      params: Promise.resolve({ segments }) as Parameters<typeof renderRoot>[0]['params'],\n      redirect,\n      searchParams: Promise.resolve(searchParams),\n    })\n\n    const rscPayload = await renderServerComponent(node as React.ReactElement)\n\n    // The server-function (client-nav RPC) path returns the flight stream unread —\n    // unlike the router/SSR path, which awaits a decode that drives the render to\n    // completion. So streamed side effects (e.g. DocumentView's autosave-create\n    // `server.redirect()`) haven't run yet and `nav` is empty. Buffer the stream to\n    // completion to force the render (populating `nav`), then hand the client a fresh\n    // replayable stream from that buffer.\n    if (!nav.type) {\n      const wrapper = (\n        rscPayload as unknown as Record<\n          symbol,\n          { createReplayStream?: () => ReadableStream<Uint8Array> } | undefined\n        >\n      )[Symbol.for('tanstack.rsc.stream')]\n      if (typeof wrapper?.createReplayStream === 'function') {\n        const buffer = await new Response(wrapper.createReplayStream()).arrayBuffer()\n        wrapper.createReplayStream = () => new Response(buffer).body as ReadableStream<Uint8Array>\n      }\n    }\n\n    // Navigation thrown deep inside a streamed view component (e.g. access\n    // denied → notFound, already-authenticated → redirect) is swallowed into\n    // the RSC stream and never rejects the render. Honor it from the holder,\n    // discarding the (broken) payload from the aborted render.\n    if (nav.type === 'redirect' && nav.url) {\n      return { _redirect: nav.url }\n    }\n    if (nav.type === 'notFound') {\n      return await renderNotFound()\n    }\n\n    // Resolve metadata through the same shared generator Next.js uses. Only\n    // plain strings cross the wire (the full `MetaConfig` carries a `URL`\n    // `metadataBase` and icons that seroval cannot serialize).\n    const i18n = await getRequestI18n({ config })\n    const meta = await generatePageMetadata({\n      adminViews: defaultAdminViews as Parameters<typeof generatePageMetadata>[0]['adminViews'],\n      config,\n      i18n,\n      params: { segments },\n    })\n\n    return {\n      metadata: toAdminPageMetadata(meta),\n      routeKey: splat ?? '',\n      rscPayload,\n    }\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    if (nav.type === 'notFound' || message === 'not-found') {\n      return await renderNotFound()\n    }\n    if (nav.type === 'redirect' || message.startsWith('redirect:')) {\n      return { _redirect: nav.url ?? message.slice('redirect:'.length) }\n    }\n    throw err\n  }\n}\n"],"names":["renderServerComponent","getRequestI18n","initReq","createPageRenderServerAdapter","resolveTitle","title","undefined","absolute","default","toAdminPageMetadata","meta","og","openGraph","rawImages","images","imagesArray","Array","isArray","map","image","url","alt","height","String","width","filter","Boolean","rawIcons","icons","iconList","icon","rel","type","media","sizes","keywords","description","length","join","siteName","robots","loadAdminPage","config","importMap","search","splat","renderRoot","defaultAdminViews","generatePageMetadata","splatSegments","split","segments","searchParams","nav","pageServerAdapter","boundInitReq","args","configPromise","overrides","serverAdapter","notFound","Error","redirect","renderNotFound","renderNotFoundPage","notFoundNode","Promise","resolve","params","rscPayload","_notFound","routeKey","node","adminViews","wrapper","Symbol","for","createReplayStream","buffer","Response","arrayBuffer","body","_redirect","i18n","metadata","err","message","startsWith","slice"],"mappings":"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"}

package/dist/utilities/loadLayoutData.d.ts

@@ -0,0 +1,15 @@
+import type { ImportMap, SanitizedConfig } from 'payload';
+/**
+ * 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 declare function loadLayoutData({ config, importMap, }: {
+    config: SanitizedConfig;
+    importMap: ImportMap;
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=loadLayoutData.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadLayoutData.d.ts","sourceRoot":"","sources":["../../src/utilities/loadLayoutData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAOzD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EACN,SAAS,GACV,EAAE;IACD,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,SAAS,CAAA;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOnC"}