@payloadcms/tanstack-start 4.0.0-beta.0

package/dist/adapters/metadata.js

@@ -0,0 +1,202 @@
+import { getViewportContent } from '@payloadcms/ui/shared';
+/**
+ * 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: metadata?.viewport ?? getViewportContent()
+        }
+    ];
+    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
+    };
+}
+/**
+ * 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.
+ */ export 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)
+    };
+};
+const resolveTitle = (title)=>{
+    if (!title) {
+        return undefined;
+    }
+    if (typeof title === 'string') {
+        return title;
+    }
+    if ('absolute' in title) {
+        return title.absolute;
+    }
+    return title.default;
+};
+
+//# sourceMappingURL=metadata.js.map

package/dist/adapters/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/metadata.ts"],"sourcesContent":["import type { MetaConfig } from 'payload'\n\nimport { getViewportContent } from '@payloadcms/ui/shared'\n\ntype 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  viewport?: 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: metadata?.viewport ?? getViewportContent() },\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\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 */\nexport const 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\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"],"names":["getViewportContent","getAdminMeta","metadata","meta","charSet","name","content","viewport","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","toAdminPageMetadata","rawImages","imagesArray","Array","isArray","map","undefined","filter","Boolean","rawIcons","iconList","length","join","resolveTitle","absolute","default"],"mappings":"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"}

package/dist/adapters/router.d.ts

@@ -0,0 +1,3 @@
+import type { RouterAdapterComponent } from 'payload';
+export declare const TanStackRouterAdapter: RouterAdapterComponent;
+//# sourceMappingURL=router.d.ts.map

package/dist/adapters/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/adapters/router.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,sBAAsB,EAAE,MAAM,SAAS,CAAA;AA0EvE,eAAO,MAAM,qBAAqB,EAAE,sBAqHnC,CAAA"}

package/dist/adapters/router.js

@@ -0,0 +1,179 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { RouterAdapterContext, useRouteTransition } from '@payloadcms/ui';
+import { createLink, useLocation, useParams, useRouter, useRouterState } from '@tanstack/react-router';
+import * as qs from 'qs-esm';
+import React, { useCallback, useEffect, useMemo } from 'react';
+const TanStackLink = createLink(function Link({ ariaCurrent, children, ...props }) {
+    return /*#__PURE__*/ _jsx("a", {
+        ...props,
+        "aria-current": ariaCurrent ?? props['aria-current'],
+        children: children
+    });
+});
+const normalizeNavigationTarget = ({ path, pathname, search })=>{
+    if (path.startsWith('http')) {
+        const url = new URL(path);
+        return `${url.pathname}${url.search}${url.hash}`;
+    }
+    if (path.startsWith('?')) {
+        return `${pathname}${path}`;
+    }
+    if (path.startsWith('#')) {
+        return `${pathname}${search}${path}`;
+    }
+    return path;
+};
+const TanStackLinkAdapter = ({ children, href, prefetch, ref, replace, scroll, ...rest })=>{
+    return /*#__PURE__*/ _jsx(TanStackLink, {
+        ariaCurrent: rest['aria-current'],
+        preload: prefetch === false ? false : 'intent',
+        ref: ref,
+        replace: replace,
+        resetScroll: scroll,
+        to: href,
+        ...rest,
+        children: children
+    });
+};
+export const TanStackRouterAdapter = ({ children })=>{
+    const router = useRouter();
+    const location = useLocation();
+    const params = useParams({
+        strict: false
+    });
+    const isRouterLoading = useRouterState({
+        select: (state)=>state.isLoading
+    });
+    const { holdRouteTransition } = useRouteTransition();
+    useEffect(()=>{
+        if (!isRouterLoading) {
+            return;
+        }
+        const releaseRouteTransition = holdRouteTransition();
+        return ()=>releaseRouteTransition();
+    }, [
+        holdRouteTransition,
+        isRouterLoading
+    ]);
+    const adaptedParams = useMemo(()=>{
+        const adapted = {
+            ...params
+        };
+        if ('_splat' in params && typeof params._splat === 'string') {
+            adapted.segments = params._splat.split('/').filter(Boolean);
+        }
+        return adapted;
+    }, [
+        params
+    ]);
+    // Split a target into `to` (pathname) + a parsed `search` object, so the
+    // router serializes the query via its `stringifySearch` (qs, bracket-encoded)
+    // rather than embedding the raw string in `to`. Navigating with a string `to`
+    // leaves the search *unencoded* in `window.location.search`
+    // (e.g. `where[or][0]…`), which then never matches Payload's `qs.stringify`
+    // output (`where%5Bor%5D…`) — breaking the list-view `syncPropsToURL` guard,
+    // which compares the two and would otherwise clobber optimistic query state
+    // (e.g. an in-progress filter condition) on every navigation.
+    const toNavOptions = useCallback((path)=>{
+        const relativePath = normalizeNavigationTarget({
+            path,
+            pathname: window.location.pathname,
+            search: window.location.search
+        });
+        const queryIndex = relativePath.indexOf('?');
+        if (queryIndex === -1) {
+            return {
+                to: relativePath
+            };
+        }
+        const searchObject = qs.parse(relativePath.slice(queryIndex + 1), {
+            depth: 10,
+            ignoreQueryPrefix: true
+        });
+        // Function form replaces the search entirely (no merge with current search).
+        return {
+            search: ()=>searchObject,
+            to: relativePath.slice(0, queryIndex)
+        };
+    }, []);
+    const back = useCallback(()=>router.history.back(), [
+        router
+    ]);
+    const push = useCallback((path, options)=>{
+        void router.navigate({
+            ...toNavOptions(path),
+            resetScroll: options?.scroll
+        });
+    }, [
+        router,
+        toNavOptions
+    ]);
+    const refresh = useCallback(()=>{
+        void router.invalidate();
+    }, [
+        router
+    ]);
+    const replace = useCallback((path, options)=>{
+        void router.navigate({
+            ...toNavOptions(path),
+            replace: true,
+            resetScroll: options?.scroll
+        });
+    }, [
+        router,
+        toNavOptions
+    ]);
+    // Mirror Next.js' router behavior to allow syncing client state to the URL without triggering a second server load.
+    // TanStack's browser history monkeypatches `window.history.replaceState` and notifies `router.load` on every call.
+    // Use `_ignoreSubscribers` to suppresses that notification — the same flag TanStack uses internally when flushing history.
+    const replaceState = useCallback((url)=>{
+        const { history } = router;
+        history._ignoreSubscribers = true;
+        try {
+            window.history.replaceState(null, '', url);
+        } finally{
+            history._ignoreSubscribers = false;
+        }
+    }, [
+        router
+    ]);
+    const adaptedRouter = useMemo(()=>({
+            back,
+            push,
+            refresh,
+            replace,
+            replaceState
+        }), [
+        back,
+        push,
+        refresh,
+        replace,
+        replaceState
+    ]);
+    // `location.searchStr` is the serialized query string; `location.search` is
+    // the parsed object (a nested structure once the router uses `qs` for search
+    // serialization), which `URLSearchParams` cannot consume. Build from the
+    // string so Payload's `parseSearchParams` re-parses the bracket notation.
+    const searchParams = useMemo(()=>new URLSearchParams(location.searchStr), [
+        location.searchStr
+    ]);
+    const value = useMemo(()=>({
+            Link: TanStackLinkAdapter,
+            params: adaptedParams,
+            pathname: location.pathname,
+            router: adaptedRouter,
+            searchParams
+        }), [
+        adaptedParams,
+        location.pathname,
+        adaptedRouter,
+        searchParams
+    ]);
+    return /*#__PURE__*/ _jsx(RouterAdapterContext, {
+        value: value,
+        children: children
+    });
+};
+
+//# sourceMappingURL=router.js.map

package/dist/adapters/router.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/router.tsx"],"sourcesContent":["'use client'\n\nimport type { RouterAdapterContextValue } from '@payloadcms/ui/providers/RouterAdapter'\nimport type { LinkAdapterProps, RouterAdapterComponent } from 'payload'\n\nimport { RouterAdapterContext, useRouteTransition } from '@payloadcms/ui'\nimport {\n  createLink,\n  useLocation,\n  useParams,\n  useRouter,\n  useRouterState,\n} from '@tanstack/react-router'\nimport * as qs from 'qs-esm'\nimport React, { useCallback, useEffect, useMemo } from 'react'\n\ntype LinkProps = {\n  ariaCurrent?: React.AriaAttributes['aria-current']\n} & React.ComponentPropsWithRef<'a'>\n\nconst TanStackLink = createLink(function Link({ ariaCurrent, children, ...props }: LinkProps) {\n  return (\n    <a {...props} aria-current={ariaCurrent ?? props['aria-current']}>\n      {children}\n    </a>\n  )\n})\n\nconst normalizeNavigationTarget = ({\n  path,\n  pathname,\n  search,\n}: {\n  path: string\n  pathname: string\n  search: string\n}) => {\n  if (path.startsWith('http')) {\n    const url = new URL(path)\n    return `${url.pathname}${url.search}${url.hash}`\n  }\n\n  if (path.startsWith('?')) {\n    return `${pathname}${path}`\n  }\n\n  if (path.startsWith('#')) {\n    return `${pathname}${search}${path}`\n  }\n\n  return path\n}\n\nconst TanStackLinkAdapter: React.FC<LinkAdapterProps> = ({\n  children,\n  href,\n  prefetch,\n  ref,\n  replace,\n  scroll,\n  ...rest\n}) => {\n  return (\n    <TanStackLink\n      ariaCurrent={rest['aria-current']}\n      preload={prefetch === false ? false : 'intent'}\n      ref={ref}\n      replace={replace}\n      resetScroll={scroll}\n      to={href}\n      {...rest}\n    >\n      {children}\n    </TanStackLink>\n  )\n}\n\nexport const TanStackRouterAdapter: RouterAdapterComponent = ({ children }) => {\n  const router = useRouter()\n  const location = useLocation()\n  const params = useParams({ strict: false })\n  const isRouterLoading = useRouterState({ select: (state) => state.isLoading })\n  const { holdRouteTransition } = useRouteTransition()\n\n  useEffect(() => {\n    if (!isRouterLoading) {\n      return\n    }\n\n    const releaseRouteTransition = holdRouteTransition()\n\n    return () => releaseRouteTransition()\n  }, [holdRouteTransition, isRouterLoading])\n\n  const adaptedParams = useMemo(() => {\n    const adapted: Record<string, string | string[]> = { ...params }\n\n    if ('_splat' in params && typeof params._splat === 'string') {\n      adapted.segments = params._splat.split('/').filter(Boolean)\n    }\n\n    return adapted\n  }, [params])\n\n  // Split a target into `to` (pathname) + a parsed `search` object, so the\n  // router serializes the query via its `stringifySearch` (qs, bracket-encoded)\n  // rather than embedding the raw string in `to`. Navigating with a string `to`\n  // leaves the search *unencoded* in `window.location.search`\n  // (e.g. `where[or][0]…`), which then never matches Payload's `qs.stringify`\n  // output (`where%5Bor%5D…`) — breaking the list-view `syncPropsToURL` guard,\n  // which compares the two and would otherwise clobber optimistic query state\n  // (e.g. an in-progress filter condition) on every navigation.\n  const toNavOptions = useCallback((path: string) => {\n    const relativePath = normalizeNavigationTarget({\n      path,\n      pathname: window.location.pathname,\n      search: window.location.search,\n    })\n\n    const queryIndex = relativePath.indexOf('?')\n\n    if (queryIndex === -1) {\n      return { to: relativePath }\n    }\n\n    const searchObject = qs.parse(relativePath.slice(queryIndex + 1), {\n      depth: 10,\n      ignoreQueryPrefix: true,\n    })\n\n    // Function form replaces the search entirely (no merge with current search).\n    return { search: () => searchObject, to: relativePath.slice(0, queryIndex) }\n  }, [])\n\n  const back = useCallback(() => router.history.back(), [router])\n\n  const push = useCallback(\n    (path: string, options?: { scroll?: boolean }) => {\n      void router.navigate({ ...toNavOptions(path), resetScroll: options?.scroll })\n    },\n    [router, toNavOptions],\n  )\n\n  const refresh = useCallback(() => {\n    void router.invalidate()\n  }, [router])\n\n  const replace = useCallback(\n    (path: string, options?: { scroll?: boolean }) => {\n      void router.navigate({ ...toNavOptions(path), replace: true, resetScroll: options?.scroll })\n    },\n    [router, toNavOptions],\n  )\n\n  // Mirror Next.js' router behavior to allow syncing client state to the URL without triggering a second server load.\n  // TanStack's browser history monkeypatches `window.history.replaceState` and notifies `router.load` on every call.\n  // Use `_ignoreSubscribers` to suppresses that notification — the same flag TanStack uses internally when flushing history.\n  const replaceState = useCallback(\n    (url: string) => {\n      const { history } = router\n      history._ignoreSubscribers = true\n\n      try {\n        window.history.replaceState(null, '', url)\n      } finally {\n        history._ignoreSubscribers = false\n      }\n    },\n    [router],\n  )\n\n  const adaptedRouter = useMemo(\n    () => ({ back, push, refresh, replace, replaceState }),\n    [back, push, refresh, replace, replaceState],\n  )\n\n  // `location.searchStr` is the serialized query string; `location.search` is\n  // the parsed object (a nested structure once the router uses `qs` for search\n  // serialization), which `URLSearchParams` cannot consume. Build from the\n  // string so Payload's `parseSearchParams` re-parses the bracket notation.\n  const searchParams = useMemo(() => new URLSearchParams(location.searchStr), [location.searchStr])\n\n  const value: RouterAdapterContextValue = useMemo(\n    () => ({\n      Link: TanStackLinkAdapter,\n      params: adaptedParams,\n      pathname: location.pathname,\n      router: adaptedRouter,\n      searchParams,\n    }),\n    [adaptedParams, location.pathname, adaptedRouter, searchParams],\n  )\n\n  return <RouterAdapterContext value={value}>{children}</RouterAdapterContext>\n}\n"],"names":["RouterAdapterContext","useRouteTransition","createLink","useLocation","useParams","useRouter","useRouterState","qs","React","useCallback","useEffect","useMemo","TanStackLink","Link","ariaCurrent","children","props","a","aria-current","normalizeNavigationTarget","path","pathname","search","startsWith","url","URL","hash","TanStackLinkAdapter","href","prefetch","ref","replace","scroll","rest","preload","resetScroll","to","TanStackRouterAdapter","router","location","params","strict","isRouterLoading","select","state","isLoading","holdRouteTransition","releaseRouteTransition","adaptedParams","adapted","_splat","segments","split","filter","Boolean","toNavOptions","relativePath","window","queryIndex","indexOf","searchObject","parse","slice","depth","ignoreQueryPrefix","back","history","push","options","navigate","refresh","invalidate","replaceState","_ignoreSubscribers","adaptedRouter","searchParams","URLSearchParams","searchStr","value"],"mappings":"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"}

package/dist/adapters/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=server.d.ts.map

package/dist/adapters/server.d.ts.map

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

package/dist/adapters/server.js

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

package/dist/adapters/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/server.ts"],"sourcesContent":["import type { CookieOptions, CookieStore, ServerAdapter } from 'payload'\n\nimport { notFound, redirect } from '@tanstack/react-router'\nimport { getRequest, getResponseHeaders } from '@tanstack/react-start/server'\nimport { parseCookies } from 'payload'\n\nfunction buildCookieStore(headers: Headers): CookieStore {\n  const cookies = parseCookies(headers)\n\n  return {\n    get: (name: string) => {\n      const value = cookies.get(name)\n      return value !== undefined ? { name, value } : undefined\n    },\n    getAll: () => {\n      return Array.from(cookies.entries()).map(([name, value]) => ({ name, value }))\n    },\n  }\n}\n\nfunction serializeCookie(name: string, value: string, options?: CookieOptions): string {\n  let cookie = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`\n\n  if (options?.path) {\n    cookie += `; Path=${options.path}`\n  }\n\n  if (options?.domain) {\n    cookie += `; Domain=${options.domain}`\n  }\n\n  if (options?.maxAge !== undefined) {\n    cookie += `; Max-Age=${options.maxAge}`\n  }\n\n  if (options?.expires) {\n    cookie += `; Expires=${options.expires.toUTCString()}`\n  }\n\n  if (options?.httpOnly) {\n    cookie += '; HttpOnly'\n  }\n\n  if (options?.secure) {\n    cookie += '; Secure'\n  }\n\n  if (options?.sameSite) {\n    cookie += `; SameSite=${options.sameSite.charAt(0).toUpperCase() + options.sameSite.slice(1)}`\n  }\n\n  return cookie\n}\n\n/**\n * Server-side adapter for TanStack Start.\n * Uses `@tanstack/react-start/server` utilities for request/response handling.\n */\nexport const tanstackServerAdapter: ServerAdapter = {\n  getCookies: () => {\n    const request = getRequest()\n    const headers = new Headers(request.headers)\n    return buildCookieStore(headers)\n  },\n\n  getHeaders: () => {\n    const request = getRequest()\n    return new Headers(request.headers)\n  },\n\n  notFound: () => {\n    // TanStack Router requires throwing the notFound() result directly\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw notFound()\n  },\n\n  redirect: (path: string) => {\n    // TanStack Router requires throwing the redirect() result directly\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw redirect({ to: path })\n  },\n\n  permanentRedirect: (path: string) => {\n    // TanStack Router does not have a separate permanent redirect primitive;\n    // fall back to a regular redirect so existing behavior is preserved.\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    throw redirect({ to: path })\n  },\n\n  forbidden: () => {\n    // TanStack Router does not have a dedicated forbidden() helper; surface\n    // a generic error so the request boundary still terminates the request.\n    throw new Error('Forbidden')\n  },\n\n  unauthorized: () => {\n    // TanStack Router does not have a dedicated unauthorized() helper; surface\n    // a generic error so the request boundary still terminates the request.\n    throw new Error('Unauthorized')\n  },\n\n  setCookie: (name: string, value: string, options?: CookieOptions) => {\n    getResponseHeaders().append('Set-Cookie', serializeCookie(name, value, options))\n  },\n}\n\n/**\n * Navigation requested during an admin page render, recorded by\n * `createPageRenderServerAdapter`. The admin-page server function reads this\n * after `renderServerComponent` resolves.\n */\nexport type PageNavIntent = {\n  type?: 'notFound' | 'redirect'\n  url?: string\n}\n\n/**\n * Builds the `ServerAdapter` for the admin page render (`renderRoot`). Like\n * `tanstackServerAdapter` for cookies/headers, but navigation **records the\n * intent on `nav` and throws** the framework-agnostic string error-contract\n * (`Error('not-found')` / `Error('redirect:<url>')`) instead of TanStack's\n * native `notFound`/`redirect`.\n *\n * `renderRoot` navigates via `req.server.*` in two places:\n * - during orchestration (e.g. the unauthenticated login redirect) — the throw\n *   propagates out of `renderRoot` and is caught by the loader's try/catch;\n * - deep inside streamed view components (e.g. `DocumentView` access checks,\n *   `LoginView` already-authenticated) — here the throw happens during\n *   `renderServerComponent` and is swallowed into the RSC stream, so it never\n *   rejects the render promise.\n *\n * Recording the intent on `nav` lets the loader honor the second case by\n * inspecting `nav` after the render resolves, then re-throwing native TanStack\n * nav at the loader boundary.\n */\nexport const createPageRenderServerAdapter = (nav: PageNavIntent): ServerAdapter => ({\n  ...tanstackServerAdapter,\n  notFound: () => {\n    nav.type = 'notFound'\n    throw new Error('not-found')\n  },\n  permanentRedirect: (path: string) => {\n    nav.type = 'redirect'\n    nav.url = path\n    throw new Error(`redirect:${path}`)\n  },\n  redirect: (path: string) => {\n    nav.type = 'redirect'\n    nav.url = path\n    throw new Error(`redirect:${path}`)\n  },\n})\n"],"names":["notFound","redirect","getRequest","getResponseHeaders","parseCookies","buildCookieStore","headers","cookies","get","name","value","undefined","getAll","Array","from","entries","map","serializeCookie","options","cookie","encodeURIComponent","path","domain","maxAge","expires","toUTCString","httpOnly","secure","sameSite","charAt","toUpperCase","slice","tanstackServerAdapter","getCookies","request","Headers","getHeaders","to","permanentRedirect","forbidden","Error","unauthorized","setCookie","append","createPageRenderServerAdapter","nav","type","url"],"mappings":"AAEA,SAASA,QAAQ,EAAEC,QAAQ,QAAQ,yBAAwB;AAC3D,SAASC,UAAU,EAAEC,kBAAkB,QAAQ,+BAA8B;AAC7E,SAASC,YAAY,QAAQ,UAAS;AAEtC,SAASC,iBAAiBC,OAAgB;IACxC,MAAMC,UAAUH,aAAaE;IAE7B,OAAO;QACLE,KAAK,CAACC;YACJ,MAAMC,QAAQH,QAAQC,GAAG,CAACC;YAC1B,OAAOC,UAAUC,YAAY;gBAAEF;gBAAMC;YAAM,IAAIC;QACjD;QACAC,QAAQ;YACN,OAAOC,MAAMC,IAAI,CAACP,QAAQQ,OAAO,IAAIC,GAAG,CAAC,CAAC,CAACP,MAAMC,MAAM,GAAM,CAAA;oBAAED;oBAAMC;gBAAM,CAAA;QAC7E;IACF;AACF;AAEA,SAASO,gBAAgBR,IAAY,EAAEC,KAAa,EAAEQ,OAAuB;IAC3E,IAAIC,SAAS,GAAGC,mBAAmBX,MAAM,CAAC,EAAEW,mBAAmBV,QAAQ;IAEvE,IAAIQ,SAASG,MAAM;QACjBF,UAAU,CAAC,OAAO,EAAED,QAAQG,IAAI,EAAE;IACpC;IAEA,IAAIH,SAASI,QAAQ;QACnBH,UAAU,CAAC,SAAS,EAAED,QAAQI,MAAM,EAAE;IACxC;IAEA,IAAIJ,SAASK,WAAWZ,WAAW;QACjCQ,UAAU,CAAC,UAAU,EAAED,QAAQK,MAAM,EAAE;IACzC;IAEA,IAAIL,SAASM,SAAS;QACpBL,UAAU,CAAC,UAAU,EAAED,QAAQM,OAAO,CAACC,WAAW,IAAI;IACxD;IAEA,IAAIP,SAASQ,UAAU;QACrBP,UAAU;IACZ;IAEA,IAAID,SAASS,QAAQ;QACnBR,UAAU;IACZ;IAEA,IAAID,SAASU,UAAU;QACrBT,UAAU,CAAC,WAAW,EAAED,QAAQU,QAAQ,CAACC,MAAM,CAAC,GAAGC,WAAW,KAAKZ,QAAQU,QAAQ,CAACG,KAAK,CAAC,IAAI;IAChG;IAEA,OAAOZ;AACT;AAEA;;;CAGC,GACD,OAAO,MAAMa,wBAAuC;IAClDC,YAAY;QACV,MAAMC,UAAUhC;QAChB,MAAMI,UAAU,IAAI6B,QAAQD,QAAQ5B,OAAO;QAC3C,OAAOD,iBAAiBC;IAC1B;IAEA8B,YAAY;QACV,MAAMF,UAAUhC;QAChB,OAAO,IAAIiC,QAAQD,QAAQ5B,OAAO;IACpC;IAEAN,UAAU;QACR,mEAAmE;QACnE,+DAA+D;QAC/D,MAAMA;IACR;IAEAC,UAAU,CAACoB;QACT,mEAAmE;QACnE,+DAA+D;QAC/D,MAAMpB,SAAS;YAAEoC,IAAIhB;QAAK;IAC5B;IAEAiB,mBAAmB,CAACjB;QAClB,yEAAyE;QACzE,qEAAqE;QACrE,+DAA+D;QAC/D,MAAMpB,SAAS;YAAEoC,IAAIhB;QAAK;IAC5B;IAEAkB,WAAW;QACT,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,IAAIC,MAAM;IAClB;IAEAC,cAAc;QACZ,2EAA2E;QAC3E,wEAAwE;QACxE,MAAM,IAAID,MAAM;IAClB;IAEAE,WAAW,CAACjC,MAAcC,OAAeQ;QACvCf,qBAAqBwC,MAAM,CAAC,cAAc1B,gBAAgBR,MAAMC,OAAOQ;IACzE;AACF,EAAC;AAYD;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,MAAM0B,gCAAgC,CAACC,MAAuC,CAAA;QACnF,GAAGb,qBAAqB;QACxBhC,UAAU;YACR6C,IAAIC,IAAI,GAAG;YACX,MAAM,IAAIN,MAAM;QAClB;QACAF,mBAAmB,CAACjB;YAClBwB,IAAIC,IAAI,GAAG;YACXD,IAAIE,GAAG,GAAG1B;YACV,MAAM,IAAImB,MAAM,CAAC,SAAS,EAAEnB,MAAM;QACpC;QACApB,UAAU,CAACoB;YACTwB,IAAIC,IAAI,GAAG;YACXD,IAAIE,GAAG,GAAG1B;YACV,MAAM,IAAImB,MAAM,CAAC,SAAS,EAAEnB,MAAM;QACpC;IACF,CAAA,EAAE"}