@payload-onpage/next 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jellologic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @payload-onpage/next
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+payload-onpage for the Next.js App Router: the session adapter (draft mode, editor binding, sealed preview grants), `<OnPage />`, `onpageContext()`, `isDraftEnabled()`, the `router.refresh()` renderer and the proxy for share links.
+
+```tsx
+// layout
+import { OnPage } from '@payload-onpage/next'
+;<Suspense fallback={null}>
+  <OnPage />
+</Suspense>
+
+// proxy.ts
+import { createOnPageProxy } from '@payload-onpage/next/proxy'
+export const proxy = createOnPageProxy({ secret: process.env.PAYLOAD_SECRET })
+```
+
+Entries: `.` (server: `OnPage`, session helpers), `./client` (`OnPageMount`, `OnPageClient`, `useNextRefresh`), `./session` (no client code; for payload.config), `./proxy` (edge).
+
+Part of [**payload-onpage**](https://github.com/jellologic/payload-onpage): on-page editing and draft previews for Payload CMS + Next.js. Start with the [getting started guide](https://github.com/jellologic/payload-onpage/blob/main/docs/getting-started.md).
+
+MIT licensed.

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+import type { DataSource, Locator, MediaLibrary } from '@payload-onpage/core';
+import type { FieldEditorDef, Messages } from '@payload-onpage/react';
+export interface OnPageMountProps {
+    mode: 'edit' | 'view';
+    /** Opened from a shared preview link (no editing). */
+    shared?: boolean;
+    /** Payload API route. Default "/api". */
+    apiRoute?: string;
+    /** Plugin endpoint prefix. Default "/onpage". */
+    prefix?: string;
+    /** Payload admin route. Default "/admin". */
+    adminRoute?: string;
+    /** Locale to edit. Default: <html lang>. */
+    locale?: string;
+    editors?: Record<string, FieldEditorDef | null>;
+    locator?: Locator;
+    media?: MediaLibrary;
+    dataSource?: DataSource;
+    /** Override editor UI strings (see `defaultMessages` in @payload-onpage/react). */
+    messages?: Messages;
+}
+export declare function OnPageMount(props: OnPageMountProps): import("react").JSX.Element;
+export { OnPageClient } from '@payload-onpage/react/client';
+export { useNextRefresh } from './refresh.ts';
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC,CAAA;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BAElD;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/client.js

@@ -0,0 +1,15 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Client side of the Next adapter. `OnPageMount` is tiny: the editor itself
+ * is loaded only when someone is editing or previewing.
+ */
+import dynamic from 'next/dynamic.js';
+const Editor = dynamic(() => import("./editor.js").then((m) => m.NextEditor), { ssr: false });
+const Preview = dynamic(() => import("./editor.js").then((m) => m.NextPreview), { ssr: false });
+export function OnPageMount(props) {
+    return props.mode === 'edit' ? _jsx(Editor, { ...props }) : _jsx(Preview, { ...props });
+}
+export { OnPageClient } from '@payload-onpage/react/client';
+export { useNextRefresh } from "./refresh.js";
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;GAGG;AACH,OAAO,OAAO,MAAM,iBAAiB,CAAA;AAyBrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;AAC9F,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;AAEhG,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAC,MAAM,OAAK,KAAK,GAAI,CAAC,CAAC,CAAC,KAAC,OAAO,OAAK,KAAK,GAAI,CAAA;AAC/E,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/editor.d.ts

@@ -0,0 +1,6 @@
+/** The lazily loaded part of the Next adapter: the editor and the preview toolbar, wired to Next and Payload. */
+import React from 'react';
+import type { OnPageMountProps } from './client.tsx';
+export declare function NextEditor(props: OnPageMountProps): React.JSX.Element | null;
+export declare function NextPreview(props: OnPageMountProps): React.JSX.Element;
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.tsx"],"names":[],"mappings":"AAEA,iHAAiH;AACjH,OAAO,KAAkB,MAAM,OAAO,CAAA;AAMtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AA+BpD,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,4BAwBjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,qBAUlD"}

package/dist/editor.js

@@ -0,0 +1,47 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/** The lazily loaded part of the Next adapter: the editor and the preview toolbar, wired to Next and Payload. */
+import { useMemo } from 'react';
+import { usePathname, useSearchParams } from 'next/navigation.js';
+import { DEFAULTS } from '@payload-onpage/core';
+import { payloadRest, payloadUploads } from '@payload-onpage/core/payload';
+import { OnPageEditor, PreviewToolbar, inPreviewFrame } from '@payload-onpage/react';
+import { lexicalEditors } from '@payload-onpage/lexical';
+import { useNextRefresh } from "./refresh.js";
+function useHere() {
+    const pathname = usePathname();
+    const search = useSearchParams();
+    const qs = search?.toString();
+    return `${pathname}${qs ? `?${qs}` : ''}`;
+}
+function useLinks(props) {
+    const here = useHere();
+    const api = props.apiRoute ?? DEFAULTS.apiRoute;
+    const base = `${api}${props.prefix ?? DEFAULTS.routePrefix}`;
+    const admin = props.adminRoute ?? DEFAULTS.adminRoute;
+    return useMemo(() => ({
+        exit: `${base}/exit?path=${encodeURIComponent(here)}`,
+        mode: (mode) => `${base}/mode?mode=${mode}&path=${encodeURIComponent(here)}`,
+        admin: (ref) => ref.kind === 'global'
+            ? `${admin}/globals/${ref.slug}`
+            : `${admin}/collections/${ref.slug}/${ref.id}`,
+    }), [base, admin, here]);
+}
+const htmlLang = () => (typeof document !== 'undefined' && document.documentElement.lang) || undefined;
+export function NextEditor(props) {
+    const locale = props.locale ?? htmlLang();
+    const links = useLinks(props);
+    const renderer = useNextRefresh();
+    const api = props.apiRoute ?? DEFAULTS.apiRoute;
+    const dataSource = useMemo(() => props.dataSource ?? payloadRest({ apiBase: api, prefix: props.prefix }), [props.dataSource, api, props.prefix]);
+    const media = useMemo(() => props.media ?? payloadUploads({ apiBase: api }), [props.media, api]);
+    const editors = useMemo(() => ({ ...lexicalEditors, ...props.editors }), [props.editors]);
+    if (inPreviewFrame())
+        return null;
+    return (_jsx(OnPageEditor, { dataSource: dataSource, media: media, locator: props.locator, renderer: renderer, editors: editors, links: links, locale: locale, messages: props.messages }));
+}
+export function NextPreview(props) {
+    const links = useLinks(props);
+    return (_jsx(PreviewToolbar, { exitHref: links.exit, editHref: props.shared ? undefined : links.mode?.('edit'), shared: props.shared, messages: props.messages }));
+}
+//# sourceMappingURL=editor.js.map

package/dist/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../src/editor.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @payload-onpage/next — payload-onpage for the Next.js App Router.
+ *
+ *   // payload.config.ts (import from /session: it has no client code)
+ *   import { nextSession } from '@payload-onpage/next/session'
+ *   plugins: [onpage({ collections: ['pages'], session: nextSession() })]
+ *
+ *   // app/(frontend)/layout.tsx — renders nothing for visitors
+ *   <Suspense><OnPage /></Suspense>
+ *
+ *   // where the page reads Payload in draft mode
+ *   payload.find({ collection: 'pages', draft, ...(await onpageContext()) })
+ */
+import type { ComponentType } from 'react';
+import { type OnPageMountProps } from './client.tsx';
+export * from './session.ts';
+/** Client-only options can't cross the server/client boundary; pass them from your own `mount`. */
+type ClientOnly = 'mode' | 'shared' | 'editors' | 'locator' | 'media' | 'dataSource';
+export interface OnPageProps extends Omit<OnPageMountProps, ClientOnly> {
+    /**
+     * Your own client mount, to pass client-only options (custom field
+     * editors, locator, media library…):
+     *
+     *   'use client'
+     *   export const Mount = (p: OnPageMountProps) => <OnPageMount {...p} editors={{ json: myJsonEditor }} />
+     */
+    mount?: ComponentType<OnPageMountProps>;
+}
+/**
+ * Mounts the editor (edit mode) or the preview toolbar (preview mode) and
+ * renders nothing otherwise. Static-safe: it reads cookies only in draft mode.
+ */
+export declare function OnPage({ mount: Mount, ...props }: OnPageProps): Promise<import("react").JSX.Element | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGjE,cAAc,cAAc,CAAA;AAE5B,mGAAmG;AACnG,KAAK,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAA;AAEpF,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IACrE;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAA;CACxC;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,EAAE,KAAK,EAAE,KAAmB,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,+CAIjF"}

package/dist/index.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { OnPageMount } from "./client.js";
+import { getOnPageMode, isSharedPreview } from "./session.js";
+export * from "./session.js";
+/**
+ * Mounts the editor (edit mode) or the preview toolbar (preview mode) and
+ * renders nothing otherwise. Static-safe: it reads cookies only in draft mode.
+ */
+export async function OnPage({ mount: Mount = OnPageMount, ...props }) {
+    const mode = await getOnPageMode();
+    if (!mode)
+        return null;
+    return _jsx(Mount, { ...props, mode: mode, shared: await isSharedPreview() });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":";AAcA,OAAO,EAAE,WAAW,EAAyB,MAAM,aAAc,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE7D,cAAc,cAAc,CAAA;AAgB5B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,WAAW,EAAE,GAAG,KAAK,EAAe;IAChF,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,OAAO,KAAC,KAAK,OAAK,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,eAAe,EAAE,GAAI,CAAA;AAC1E,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,9 @@
+import { NextResponse, type NextRequest } from 'next/server.js';
+export interface OnPageProxyOptions {
+    /** Same secret as the plugin (default: Payload's `secret`, i.e. PAYLOAD_SECRET). */
+    secret: string | undefined;
+}
+/** Request headers for the rest of the pipeline, with draft mode injected for a valid grant. */
+export declare function withOnPage(request: NextRequest, opts: OnPageProxyOptions, headers?: Headers): Promise<Headers>;
+export declare function createOnPageProxy(opts: OnPageProxyOptions): (request: NextRequest) => Promise<NextResponse<unknown>>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE/D,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAeD,gGAAgG;AAChG,wBAAsB,UAAU,CAC9B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,OAAsC,GAC9C,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,IAK5B,SAAS,WAAW,oCAGjD"}

package/dist/proxy.js

@@ -0,0 +1,50 @@
+/**
+ * The payload-onpage proxy (Next.js middleware). Required for preview links:
+ * it unseals the `onpage_preview` grant and, only on the shared page and
+ * before the grant expires, injects Next's draft-mode cookie into the request.
+ * Static pages then render the draft for the viewer, while the browser never
+ * holds a usable draft credential. It also passes the request path to server
+ * components.
+ *
+ *   // proxy.ts (Next 16; middleware.ts on Next 15)
+ *   import { createOnPageProxy } from '@payload-onpage/next/proxy'
+ *   export const proxy = createOnPageProxy({ secret: process.env.PAYLOAD_SECRET })
+ *   export const config = { matcher: ['/((?!_next|.*\\..*).*)'] }
+ *
+ * Already have one? `NextResponse.next({ request: { headers: await withOnPage(request, { secret }) } })`
+ */
+import { COOKIE, HEADER, SEAL_PURPOSE, samePath, unseal } from '@payload-onpage/core';
+import { NextResponse } from 'next/server.js';
+const withoutCookies = (header, names) => (header ?? '')
+    .split(';')
+    .map((c) => c.trim())
+    .filter((c) => c && !names.some((n) => c.startsWith(`${n}=`)));
+/** Request headers for the rest of the pipeline, with draft mode injected for a valid grant. */
+export async function withOnPage(request, opts, headers = new Headers(request.headers)) {
+    const path = request.nextUrl.pathname;
+    headers.delete(HEADER.shared); // never trust it from the client
+    headers.set(HEADER.path, path);
+    const sealed = request.cookies.get(COOKIE.preview)?.value;
+    if (!sealed || !opts.secret)
+        return headers;
+    const grant = await unseal(sealed, opts.secret, SEAL_PURPOSE.previewCookie);
+    if (!grant ||
+        typeof grant.draft !== 'string' ||
+        grant.exp * 1000 <= Date.now() ||
+        !samePath(path, grant.path)) {
+        return headers;
+    }
+    const cookie = withoutCookies(headers.get('cookie'), [COOKIE.nextDraft, COOKIE.mode]);
+    cookie.push(`${COOKIE.nextDraft}=${grant.draft}`, `${COOKIE.mode}=view`);
+    headers.set('cookie', cookie.join('; '));
+    headers.set(HEADER.shared, '1');
+    return headers;
+}
+export function createOnPageProxy(opts) {
+    if (!opts.secret)
+        console.warn('payload-onpage: createOnPageProxy() has no secret; preview links will show published content.');
+    return async function proxy(request) {
+        return NextResponse.next({ request: { headers: await withOnPage(request, opts) } });
+    };
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AACrF,OAAO,EAAE,YAAY,EAAoB,MAAM,gBAAgB,CAAA;AAc/D,MAAM,cAAc,GAAG,CAAC,MAAqB,EAAE,KAAe,EAAE,EAAE,CAChE,CAAC,MAAM,IAAI,EAAE,CAAC;KACX,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;KACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAElE,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAoB,EACpB,IAAwB,EACxB,UAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;IAE/C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAA;IACrC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA,CAAC,iCAAiC;IAC/D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,CAAA;IACzD,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAA;IAC3C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAe,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,aAAa,CAAC,CAAA;IACzF,IACE,CAAC,KAAK;QACN,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,KAAK,CAAC,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE;QAC9B,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAC3B,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACrF,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,OAAO,CAAC,CAAA;IACxE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACxC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC/B,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,IAAI,CAAC,IAAI,CAAC,MAAM;QACd,OAAO,CAAC,IAAI,CACV,+FAA+F,CAChG,CAAA;IACH,OAAO,KAAK,UAAU,KAAK,CAAC,OAAoB;QAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IACrF,CAAC,CAAA;AACH,CAAC"}

package/dist/refresh.d.ts

@@ -0,0 +1,3 @@
+import type { Renderer } from '@payload-onpage/core';
+export declare function useNextRefresh(): Renderer;
+//# sourceMappingURL=refresh.d.ts.map

package/dist/refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../src/refresh.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAKpD,wBAAgB,cAAc,IAAI,QAAQ,CAgCzC"}

package/dist/refresh.js

@@ -0,0 +1,40 @@
+'use client';
+/**
+ * The Next.js Renderer: after a save, re-render the current route on the
+ * server (router.refresh) inside a transition. `afterSave` resolves once the
+ * new render is on screen, so the editor knows when to drop its stand-ins.
+ * Saves landing close together share one refresh.
+ */
+import { useEffect, useMemo, useRef, useTransition } from 'react';
+import { useRouter } from 'next/navigation.js';
+const DEBOUNCE = 60;
+const FALLBACK = 10_000;
+export function useNextRefresh() {
+    const router = useRouter();
+    const [pending, startTransition] = useTransition();
+    const queued = useRef([]);
+    const inFlight = useRef([]);
+    const timer = useRef(undefined);
+    useEffect(() => {
+        if (pending || !inFlight.current.length)
+            return;
+        const done = inFlight.current;
+        inFlight.current = [];
+        done.forEach((f) => f());
+    }, [pending]);
+    return useMemo(() => ({
+        name: 'next-refresh',
+        live: false,
+        afterSave: () => new Promise((resolve) => {
+            queued.current.push(resolve);
+            setTimeout(resolve, FALLBACK); // never hang the editor on a refresh that didn't report back
+            clearTimeout(timer.current);
+            timer.current = setTimeout(() => {
+                inFlight.current.push(...queued.current);
+                queued.current = [];
+                startTransition(() => router.refresh());
+            }, DEBOUNCE);
+        }),
+    }), [router]);
+}
+//# sourceMappingURL=refresh.js.map

package/dist/refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../src/refresh.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAG9C,MAAM,QAAQ,GAAG,EAAE,CAAA;AACnB,MAAM,QAAQ,GAAG,MAAM,CAAA;AAEvB,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,GAAG,aAAa,EAAE,CAAA;IAClD,MAAM,MAAM,GAAG,MAAM,CAAoB,EAAE,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAoB,EAAE,CAAC,CAAA;IAC9C,MAAM,KAAK,GAAG,MAAM,CAA4C,SAAS,CAAC,CAAA;IAE1E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM;YAAE,OAAM;QAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAA;QAC7B,QAAQ,CAAC,OAAO,GAAG,EAAE,CAAA;QACrB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,GAAG,EAAE,CACd,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAC5B,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA,CAAC,6DAA6D;YAC3F,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAC3B,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;gBACxC,MAAM,CAAC,OAAO,GAAG,EAAE,CAAA;gBACnB,eAAe,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;YACzC,CAAC,EAAE,QAAQ,CAAC,CAAA;QACd,CAAC,CAAC;KACL,CAAC,EACF,CAAC,MAAM,CAAC,CACT,CAAA;AACH,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Next.js App Router session adapter and helpers.
+ *
+ * Editors: Next draft mode plus an `onpage` cookie saying which mode, bound to
+ * a hash of their auth cookie, so signing out (or in as someone else) ends it.
+ *
+ * Preview links: the browser gets only a sealed grant (`onpage_preview`). The
+ * proxy (./proxy) unseals it and injects draft mode into the request for the
+ * shared page only. The raw Next.js draft secret never reaches the browser.
+ *
+ * All helpers read `draftMode().isEnabled` first and touch cookies only when
+ * draft mode is on. Next exempts that read from prerender bailout, so pages
+ * stay static for visitors.
+ */
+import { type OnPageMode, type SessionAdapter } from '@payload-onpage/core';
+export interface NextSessionOptions {
+    /** How long an editor's edit/preview mode lasts, in seconds. Default 12 hours. */
+    maxAge?: number;
+}
+export declare function nextSession(opts?: NextSessionOptions): SessionAdapter;
+/** "edit", "view" or null for this request. Safe to call anywhere (returns null outside a request). */
+export declare function getOnPageMode(): Promise<OnPageMode | null>;
+/**
+ * Should this request render drafts? `draftMode().isEnabled`, except that an
+ * editor whose session ended (signed out) no longer sees drafts. Draft mode
+ * turned on by something else (your own preview route) is respected.
+ */
+export declare function isDraftEnabled(): Promise<boolean>;
+/** Is this request a preview-link view (set by the proxy)? */
+export declare function isSharedPreview(): Promise<boolean>;
+/**
+ * Spread into Payload reads that feed the page: in edit mode it turns on
+ * auto-mapping markers, otherwise it is empty.
+ *
+ *   payload.find({ collection: 'pages', where, draft, ...(await onpageContext()) })
+ */
+export declare function onpageContext(): Promise<{
+    context?: {
+        onpage: true;
+    };
+}>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA0B,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGnG,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAyBD,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,cAAc,CAuCzE;AAED,uGAAuG;AACvG,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQhE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CASvD;AAED,8DAA8D;AAC9D,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAOxD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAAE,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAA;CAAE,CAAC,CAE7E"}

package/dist/session.js

@@ -0,0 +1,131 @@
+/**
+ * Next.js App Router session adapter and helpers.
+ *
+ * Editors: Next draft mode plus an `onpage` cookie saying which mode, bound to
+ * a hash of their auth cookie, so signing out (or in as someone else) ends it.
+ *
+ * Preview links: the browser gets only a sealed grant (`onpage_preview`). The
+ * proxy (./proxy) unseals it and injects draft mode into the request for the
+ * shared page only. The raw Next.js draft secret never reaches the browser.
+ *
+ * All helpers read `draftMode().isEnabled` first and touch cookies only when
+ * draft mode is on. Next exempts that read from prerender bailout, so pages
+ * stay static for visitors.
+ */
+import { COOKIE, HEADER, sha256 } from '@payload-onpage/core';
+import { cookies, draftMode, headers } from 'next/headers.js';
+const HASH_LENGTH = 32;
+const fingerprint = async (token) => (await sha256(token)).slice(0, HASH_LENGTH);
+/** `edit` | `view`, or `<mode>:<authCookie>:<hash>` when bound to a session. */
+async function modeValue(mode, jar, bindTo) {
+    const token = bindTo ? jar.get(bindTo)?.value : undefined;
+    return token && bindTo ? `${mode}:${bindTo}:${await fingerprint(token)}` : mode;
+}
+/** The mode a cookie value grants in this request, or null (unknown, or the bound session is gone). */
+async function readMode(raw, jar) {
+    if (!raw)
+        return null;
+    const [mode, bound, hash] = raw.split(':');
+    if (mode !== 'edit' && mode !== 'view')
+        return null;
+    if (bound) {
+        const token = jar.get(bound)?.value;
+        if (!token || (await fingerprint(token)) !== hash)
+            return null;
+    }
+    return mode;
+}
+export function nextSession(opts = {}) {
+    const maxAge = opts.maxAge ?? 12 * 3600;
+    return {
+        async enable(mode, { secure, bindTo }) {
+            ;
+            (await draftMode()).enable();
+            const jar = await cookies();
+            jar.set(COOKIE.mode, await modeValue(mode, jar, bindTo), {
+                httpOnly: true,
+                sameSite: 'lax',
+                secure,
+                path: '/',
+                maxAge,
+            });
+            jar.delete(COOKIE.preview);
+        },
+        async enableLink({ secure, path: _path, expiresAt, seal }) {
+            ;
+            (await draftMode()).enable();
+            const jar = await cookies();
+            const draft = jar.get(COOKIE.nextDraft)?.value;
+            if (!draft)
+                throw new Error('payload-onpage: Next.js did not set its draft-mode cookie');
+            // Keep the draft secret server-side: the browser only gets the sealed grant.
+            jar.delete(COOKIE.nextDraft);
+            jar.delete(COOKIE.mode);
+            jar.set(COOKIE.preview, await seal(draft), {
+                httpOnly: true,
+                sameSite: 'lax',
+                secure,
+                path: '/',
+                expires: expiresAt,
+            });
+        },
+        async disable() {
+            ;
+            (await draftMode()).disable();
+            const jar = await cookies();
+            jar.delete(COOKIE.mode);
+            jar.delete(COOKIE.preview);
+        },
+        getMode: getOnPageMode,
+    };
+}
+/** "edit", "view" or null for this request. Safe to call anywhere (returns null outside a request). */
+export async function getOnPageMode() {
+    try {
+        if (!(await draftMode()).isEnabled)
+            return null;
+        const jar = await cookies();
+        return await readMode(jar.get(COOKIE.mode)?.value, jar);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Should this request render drafts? `draftMode().isEnabled`, except that an
+ * editor whose session ended (signed out) no longer sees drafts. Draft mode
+ * turned on by something else (your own preview route) is respected.
+ */
+export async function isDraftEnabled() {
+    try {
+        if (!(await draftMode()).isEnabled)
+            return false;
+        const jar = await cookies();
+        const raw = jar.get(COOKIE.mode)?.value;
+        return raw === undefined || (await readMode(raw, jar)) !== null;
+    }
+    catch {
+        return false;
+    }
+}
+/** Is this request a preview-link view (set by the proxy)? */
+export async function isSharedPreview() {
+    try {
+        if (!(await draftMode()).isEnabled)
+            return false;
+        return (await headers()).get(HEADER.shared) === '1';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Spread into Payload reads that feed the page: in edit mode it turns on
+ * auto-mapping markers, otherwise it is empty.
+ *
+ *   payload.find({ collection: 'pages', where, draft, ...(await onpageContext()) })
+ */
+export async function onpageContext() {
+    return (await getOnPageMode()) === 'edit' ? { context: { onpage: true } } : {};
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,76 @@
 {
   "name": "@payload-onpage/next",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "payload-onpage for Next.js App Router: draft-mode session adapter, <OnPage />, onpageContext() and refresh rendering.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jellologic/payload-onpage.git",
+    "directory": "packages/next"
+  },
+  "homepage": "https://github.com/jellologic/payload-onpage#readme",
+  "bugs": "https://github.com/jellologic/payload-onpage/issues",
+  "keywords": [
+    "payload",
+    "payloadcms",
+    "payload-plugin",
+    "nextjs",
+    "visual-editing",
+    "live-preview",
+    "inline-editing",
+    "cms"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./session": {
+      "types": "./dist/session.d.ts",
+      "default": "./dist/session.js"
+    },
+    "./proxy": {
+      "types": "./dist/proxy.d.ts",
+      "default": "./dist/proxy.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo",
+    "src",
+    "!src/**/__tests__",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "test": "bun test src",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@payload-onpage/core": "0.1.0",
+    "@payload-onpage/react": "0.1.0",
+    "@payload-onpage/lexical": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": "^15.4.11 || ^16.3.8",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  }
+}

package/src/client.tsx

@@ -0,0 +1,40 @@
+'use client'
+
+/**
+ * Client side of the Next adapter. `OnPageMount` is tiny: the editor itself
+ * is loaded only when someone is editing or previewing.
+ */
+import dynamic from 'next/dynamic.js'
+import type { DataSource, Locator, MediaLibrary } from '@payload-onpage/core'
+import type { FieldEditorDef, Messages } from '@payload-onpage/react'
+
+export interface OnPageMountProps {
+  mode: 'edit' | 'view'
+  /** Opened from a shared preview link (no editing). */
+  shared?: boolean
+  /** Payload API route. Default "/api". */
+  apiRoute?: string
+  /** Plugin endpoint prefix. Default "/onpage". */
+  prefix?: string
+  /** Payload admin route. Default "/admin". */
+  adminRoute?: string
+  /** Locale to edit. Default: <html lang>. */
+  locale?: string
+  // Client-only options (pass them from your own 'use client' mount):
+  editors?: Record<string, FieldEditorDef | null>
+  locator?: Locator
+  media?: MediaLibrary
+  dataSource?: DataSource
+  /** Override editor UI strings (see `defaultMessages` in @payload-onpage/react). */
+  messages?: Messages
+}
+
+const Editor = dynamic(() => import('./editor.tsx').then((m) => m.NextEditor), { ssr: false })
+const Preview = dynamic(() => import('./editor.tsx').then((m) => m.NextPreview), { ssr: false })
+
+export function OnPageMount(props: OnPageMountProps) {
+  return props.mode === 'edit' ? <Editor {...props} /> : <Preview {...props} />
+}
+
+export { OnPageClient } from '@payload-onpage/react/client'
+export { useNextRefresh } from './refresh.ts'

package/src/editor.tsx

@@ -0,0 +1,77 @@
+'use client'
+
+/** The lazily loaded part of the Next adapter: the editor and the preview toolbar, wired to Next and Payload. */
+import React, { useMemo } from 'react'
+import { usePathname, useSearchParams } from 'next/navigation.js'
+import { DEFAULTS, type DocRef } from '@payload-onpage/core'
+import { payloadRest, payloadUploads } from '@payload-onpage/core/payload'
+import { OnPageEditor, PreviewToolbar, inPreviewFrame, type Links } from '@payload-onpage/react'
+import { lexicalEditors } from '@payload-onpage/lexical'
+import type { OnPageMountProps } from './client.tsx'
+import { useNextRefresh } from './refresh.ts'
+
+function useHere(): string {
+  const pathname = usePathname()
+  const search = useSearchParams()
+  const qs = search?.toString()
+  return `${pathname}${qs ? `?${qs}` : ''}`
+}
+
+function useLinks(props: OnPageMountProps): Links {
+  const here = useHere()
+  const api = props.apiRoute ?? DEFAULTS.apiRoute
+  const base = `${api}${props.prefix ?? DEFAULTS.routePrefix}`
+  const admin = props.adminRoute ?? DEFAULTS.adminRoute
+  return useMemo<Links>(
+    () => ({
+      exit: `${base}/exit?path=${encodeURIComponent(here)}`,
+      mode: (mode) => `${base}/mode?mode=${mode}&path=${encodeURIComponent(here)}`,
+      admin: (ref: DocRef) =>
+        ref.kind === 'global'
+          ? `${admin}/globals/${ref.slug}`
+          : `${admin}/collections/${ref.slug}/${ref.id}`,
+    }),
+    [base, admin, here],
+  )
+}
+
+const htmlLang = () =>
+  (typeof document !== 'undefined' && document.documentElement.lang) || undefined
+
+export function NextEditor(props: OnPageMountProps) {
+  const locale = props.locale ?? htmlLang()
+  const links = useLinks(props)
+  const renderer = useNextRefresh()
+  const api = props.apiRoute ?? DEFAULTS.apiRoute
+  const dataSource = useMemo(
+    () => props.dataSource ?? payloadRest({ apiBase: api, prefix: props.prefix }),
+    [props.dataSource, api, props.prefix],
+  )
+  const media = useMemo(() => props.media ?? payloadUploads({ apiBase: api }), [props.media, api])
+  const editors = useMemo(() => ({ ...lexicalEditors, ...props.editors }), [props.editors])
+  if (inPreviewFrame()) return null
+  return (
+    <OnPageEditor
+      dataSource={dataSource}
+      media={media}
+      locator={props.locator}
+      renderer={renderer}
+      editors={editors}
+      links={links}
+      locale={locale}
+      messages={props.messages}
+    />
+  )
+}
+
+export function NextPreview(props: OnPageMountProps) {
+  const links = useLinks(props)
+  return (
+    <PreviewToolbar
+      exitHref={links.exit}
+      editHref={props.shared ? undefined : links.mode?.('edit')}
+      shared={props.shared}
+      messages={props.messages}
+    />
+  )
+}

package/src/index.tsx

@@ -0,0 +1,42 @@
+/**
+ * @payload-onpage/next — payload-onpage for the Next.js App Router.
+ *
+ *   // payload.config.ts (import from /session: it has no client code)
+ *   import { nextSession } from '@payload-onpage/next/session'
+ *   plugins: [onpage({ collections: ['pages'], session: nextSession() })]
+ *
+ *   // app/(frontend)/layout.tsx — renders nothing for visitors
+ *   <Suspense><OnPage /></Suspense>
+ *
+ *   // where the page reads Payload in draft mode
+ *   payload.find({ collection: 'pages', draft, ...(await onpageContext()) })
+ */
+import type { ComponentType } from 'react'
+import { OnPageMount, type OnPageMountProps } from './client.tsx'
+import { getOnPageMode, isSharedPreview } from './session.ts'
+
+export * from './session.ts'
+
+/** Client-only options can't cross the server/client boundary; pass them from your own `mount`. */
+type ClientOnly = 'mode' | 'shared' | 'editors' | 'locator' | 'media' | 'dataSource'
+
+export interface OnPageProps extends Omit<OnPageMountProps, ClientOnly> {
+  /**
+   * Your own client mount, to pass client-only options (custom field
+   * editors, locator, media library…):
+   *
+   *   'use client'
+   *   export const Mount = (p: OnPageMountProps) => <OnPageMount {...p} editors={{ json: myJsonEditor }} />
+   */
+  mount?: ComponentType<OnPageMountProps>
+}
+
+/**
+ * Mounts the editor (edit mode) or the preview toolbar (preview mode) and
+ * renders nothing otherwise. Static-safe: it reads cookies only in draft mode.
+ */
+export async function OnPage({ mount: Mount = OnPageMount, ...props }: OnPageProps) {
+  const mode = await getOnPageMode()
+  if (!mode) return null
+  return <Mount {...props} mode={mode} shared={await isSharedPreview()} />
+}

package/src/proxy.ts

@@ -0,0 +1,72 @@
+/**
+ * The payload-onpage proxy (Next.js middleware). Required for preview links:
+ * it unseals the `onpage_preview` grant and, only on the shared page and
+ * before the grant expires, injects Next's draft-mode cookie into the request.
+ * Static pages then render the draft for the viewer, while the browser never
+ * holds a usable draft credential. It also passes the request path to server
+ * components.
+ *
+ *   // proxy.ts (Next 16; middleware.ts on Next 15)
+ *   import { createOnPageProxy } from '@payload-onpage/next/proxy'
+ *   export const proxy = createOnPageProxy({ secret: process.env.PAYLOAD_SECRET })
+ *   export const config = { matcher: ['/((?!_next|.*\\..*).*)'] }
+ *
+ * Already have one? `NextResponse.next({ request: { headers: await withOnPage(request, { secret }) } })`
+ */
+import { COOKIE, HEADER, SEAL_PURPOSE, samePath, unseal } from '@payload-onpage/core'
+import { NextResponse, type NextRequest } from 'next/server.js'
+
+export interface OnPageProxyOptions {
+  /** Same secret as the plugin (default: Payload's `secret`, i.e. PAYLOAD_SECRET). */
+  secret: string | undefined
+}
+
+interface PreviewGrant {
+  path: string
+  ref: string
+  exp: number
+  draft: string
+}
+
+const withoutCookies = (header: string | null, names: string[]) =>
+  (header ?? '')
+    .split(';')
+    .map((c) => c.trim())
+    .filter((c) => c && !names.some((n) => c.startsWith(`${n}=`)))
+
+/** Request headers for the rest of the pipeline, with draft mode injected for a valid grant. */
+export async function withOnPage(
+  request: NextRequest,
+  opts: OnPageProxyOptions,
+  headers: Headers = new Headers(request.headers),
+): Promise<Headers> {
+  const path = request.nextUrl.pathname
+  headers.delete(HEADER.shared) // never trust it from the client
+  headers.set(HEADER.path, path)
+  const sealed = request.cookies.get(COOKIE.preview)?.value
+  if (!sealed || !opts.secret) return headers
+  const grant = await unseal<PreviewGrant>(sealed, opts.secret, SEAL_PURPOSE.previewCookie)
+  if (
+    !grant ||
+    typeof grant.draft !== 'string' ||
+    grant.exp * 1000 <= Date.now() ||
+    !samePath(path, grant.path)
+  ) {
+    return headers
+  }
+  const cookie = withoutCookies(headers.get('cookie'), [COOKIE.nextDraft, COOKIE.mode])
+  cookie.push(`${COOKIE.nextDraft}=${grant.draft}`, `${COOKIE.mode}=view`)
+  headers.set('cookie', cookie.join('; '))
+  headers.set(HEADER.shared, '1')
+  return headers
+}
+
+export function createOnPageProxy(opts: OnPageProxyOptions) {
+  if (!opts.secret)
+    console.warn(
+      'payload-onpage: createOnPageProxy() has no secret; preview links will show published content.',
+    )
+  return async function proxy(request: NextRequest) {
+    return NextResponse.next({ request: { headers: await withOnPage(request, opts) } })
+  }
+}

package/src/refresh.ts

@@ -0,0 +1,48 @@
+'use client'
+
+/**
+ * The Next.js Renderer: after a save, re-render the current route on the
+ * server (router.refresh) inside a transition. `afterSave` resolves once the
+ * new render is on screen, so the editor knows when to drop its stand-ins.
+ * Saves landing close together share one refresh.
+ */
+import { useEffect, useMemo, useRef, useTransition } from 'react'
+import { useRouter } from 'next/navigation.js'
+import type { Renderer } from '@payload-onpage/core'
+
+const DEBOUNCE = 60
+const FALLBACK = 10_000
+
+export function useNextRefresh(): Renderer {
+  const router = useRouter()
+  const [pending, startTransition] = useTransition()
+  const queued = useRef<Array<() => void>>([])
+  const inFlight = useRef<Array<() => void>>([])
+  const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined)
+
+  useEffect(() => {
+    if (pending || !inFlight.current.length) return
+    const done = inFlight.current
+    inFlight.current = []
+    done.forEach((f) => f())
+  }, [pending])
+
+  return useMemo<Renderer>(
+    () => ({
+      name: 'next-refresh',
+      live: false,
+      afterSave: () =>
+        new Promise<void>((resolve) => {
+          queued.current.push(resolve)
+          setTimeout(resolve, FALLBACK) // never hang the editor on a refresh that didn't report back
+          clearTimeout(timer.current)
+          timer.current = setTimeout(() => {
+            inFlight.current.push(...queued.current)
+            queued.current = []
+            startTransition(() => router.refresh())
+          }, DEBOUNCE)
+        }),
+    }),
+    [router],
+  )
+}

package/src/session.ts

@@ -0,0 +1,132 @@
+/**
+ * Next.js App Router session adapter and helpers.
+ *
+ * Editors: Next draft mode plus an `onpage` cookie saying which mode, bound to
+ * a hash of their auth cookie, so signing out (or in as someone else) ends it.
+ *
+ * Preview links: the browser gets only a sealed grant (`onpage_preview`). The
+ * proxy (./proxy) unseals it and injects draft mode into the request for the
+ * shared page only. The raw Next.js draft secret never reaches the browser.
+ *
+ * All helpers read `draftMode().isEnabled` first and touch cookies only when
+ * draft mode is on. Next exempts that read from prerender bailout, so pages
+ * stay static for visitors.
+ */
+import { COOKIE, HEADER, sha256, type OnPageMode, type SessionAdapter } from '@payload-onpage/core'
+import { cookies, draftMode, headers } from 'next/headers.js'
+
+export interface NextSessionOptions {
+  /** How long an editor's edit/preview mode lasts, in seconds. Default 12 hours. */
+  maxAge?: number
+}
+
+type Jar = Awaited<ReturnType<typeof cookies>>
+
+const HASH_LENGTH = 32
+const fingerprint = async (token: string) => (await sha256(token)).slice(0, HASH_LENGTH)
+
+/** `edit` | `view`, or `<mode>:<authCookie>:<hash>` when bound to a session. */
+async function modeValue(mode: OnPageMode, jar: Jar, bindTo?: string): Promise<string> {
+  const token = bindTo ? jar.get(bindTo)?.value : undefined
+  return token && bindTo ? `${mode}:${bindTo}:${await fingerprint(token)}` : mode
+}
+
+/** The mode a cookie value grants in this request, or null (unknown, or the bound session is gone). */
+async function readMode(raw: string | undefined, jar: Jar): Promise<OnPageMode | null> {
+  if (!raw) return null
+  const [mode, bound, hash] = raw.split(':')
+  if (mode !== 'edit' && mode !== 'view') return null
+  if (bound) {
+    const token = jar.get(bound)?.value
+    if (!token || (await fingerprint(token)) !== hash) return null
+  }
+  return mode
+}
+
+export function nextSession(opts: NextSessionOptions = {}): SessionAdapter {
+  const maxAge = opts.maxAge ?? 12 * 3600
+  return {
+    async enable(mode, { secure, bindTo }) {
+      ;(await draftMode()).enable()
+      const jar = await cookies()
+      jar.set(COOKIE.mode, await modeValue(mode, jar, bindTo), {
+        httpOnly: true,
+        sameSite: 'lax',
+        secure,
+        path: '/',
+        maxAge,
+      })
+      jar.delete(COOKIE.preview)
+    },
+    async enableLink({ secure, path: _path, expiresAt, seal }) {
+      ;(await draftMode()).enable()
+      const jar = await cookies()
+      const draft = jar.get(COOKIE.nextDraft)?.value
+      if (!draft) throw new Error('payload-onpage: Next.js did not set its draft-mode cookie')
+      // Keep the draft secret server-side: the browser only gets the sealed grant.
+      jar.delete(COOKIE.nextDraft)
+      jar.delete(COOKIE.mode)
+      jar.set(COOKIE.preview, await seal(draft), {
+        httpOnly: true,
+        sameSite: 'lax',
+        secure,
+        path: '/',
+        expires: expiresAt,
+      })
+    },
+    async disable() {
+      ;(await draftMode()).disable()
+      const jar = await cookies()
+      jar.delete(COOKIE.mode)
+      jar.delete(COOKIE.preview)
+    },
+    getMode: getOnPageMode,
+  }
+}
+
+/** "edit", "view" or null for this request. Safe to call anywhere (returns null outside a request). */
+export async function getOnPageMode(): Promise<OnPageMode | null> {
+  try {
+    if (!(await draftMode()).isEnabled) return null
+    const jar = await cookies()
+    return await readMode(jar.get(COOKIE.mode)?.value, jar)
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Should this request render drafts? `draftMode().isEnabled`, except that an
+ * editor whose session ended (signed out) no longer sees drafts. Draft mode
+ * turned on by something else (your own preview route) is respected.
+ */
+export async function isDraftEnabled(): Promise<boolean> {
+  try {
+    if (!(await draftMode()).isEnabled) return false
+    const jar = await cookies()
+    const raw = jar.get(COOKIE.mode)?.value
+    return raw === undefined || (await readMode(raw, jar)) !== null
+  } catch {
+    return false
+  }
+}
+
+/** Is this request a preview-link view (set by the proxy)? */
+export async function isSharedPreview(): Promise<boolean> {
+  try {
+    if (!(await draftMode()).isEnabled) return false
+    return (await headers()).get(HEADER.shared) === '1'
+  } catch {
+    return false
+  }
+}
+
+/**
+ * Spread into Payload reads that feed the page: in edit mode it turns on
+ * auto-mapping markers, otherwise it is empty.
+ *
+ *   payload.find({ collection: 'pages', where, draft, ...(await onpageContext()) })
+ */
+export async function onpageContext(): Promise<{ context?: { onpage: true } }> {
+  return (await getOnPageMode()) === 'edit' ? { context: { onpage: true } } : {}
+}