payload-live-preview 1.8.0 → 2.0.0-beta.0

package/dist/options-CEzzfHJu.d.ts

@@ -0,0 +1,197 @@
+/**
+ * The two defaults profiles, row by row. 2.0 ships `v2`; `defaults: 'v1'` opts
+ * back into the 1.x table for a staged migration. Each row belongs to exactly
+ * one side — the adapter's request decision or the browser runtime — and a
+ * test asserts the profile assigns every readiness row that has an option, so
+ * a row added later cannot be forgotten. See ADR 0007.
+ */
+/** `'v2'` is the 2.0 default; `'v1'` is the 1.x table. */
+type DefaultsProfile = 'v1' | 'v2';
+/** How the runtime decides which windows may post updates. */
+type EventSourcePolicy = 'any' | 'parent-or-opener';
+
+/**
+ * The authorized preview context's shape and brand, in the leaf `types` domain
+ * so producer and consumers recognise the same context. See ADR 0006.
+ */
+/**
+ * The brand key, in the type and on the object.
+ *
+ * This was a `unique symbol` until 2026-08-30. A `unique symbol` is nominal per
+ * *declaration*, and the published entries each carry their own declaration
+ * file — so `AuthorizedPreviewContext` from the root barrel was a different
+ * type from the one in `./server` or in an adapter, and the documented flow
+ * (authorize once, hand the context to the adapter hook and to the draft read)
+ * did not type-check in any combination a consumer can write.
+ *
+ * That is the same trap the runtime brand below already avoids by using
+ * `Symbol.for` rather than `Symbol()`; the lesson simply had not reached the
+ * type. A shared string literal is identical in every bundle for the same
+ * reason a registry symbol is.
+ *
+ * It is not what makes a context trustworthy. `isAuthorizedPreviewContext`
+ * decides that, on the registry symbol and on `Object.isFrozen`, and every
+ * consumption point calls it — the adapter policy, the draft read and the
+ * binding emitter. Writing this key by hand buys nothing.
+ */
+declare const AUTHORIZED_PREVIEW_BRAND_KEY = "payload-live-preview.authorized-preview-context";
+type PreviewAuthorizationStrategyName = 'payload-session' | 'signed-token' | 'verifier';
+/** What a context is bound to; every field is optional because every strategy binds differently. */
+interface AuthorizedPreviewScope {
+    /** The site origin the credential was issued for. */
+    readonly audience?: string;
+    /** The request pathname the credential is valid for. */
+    readonly path?: string;
+    readonly locale?: string;
+}
+/** The verdict of a successful `authorizePreviewRequest()`: frozen, branded, produced only there. Carry it, do not rebuild it. */
+interface AuthorizedPreviewContext {
+    readonly [AUTHORIZED_PREVIEW_BRAND_KEY]: true;
+    readonly strategy: PreviewAuthorizationStrategyName;
+    /** The user id, token subject, or whatever the verifier named. */
+    readonly subject: string | undefined;
+    /** Unix milliseconds. */
+    readonly authorizedAt: number;
+    /** Unix milliseconds, or `undefined` when the strategy does not know. */
+    readonly expiresAt: number | undefined;
+    readonly scope: AuthorizedPreviewScope;
+    /** The minimal request material a draft read forwards to Payload — one verified cookie, never the whole `Cookie` header. */
+    readonly payloadHeaders: Readonly<Record<string, string>>;
+}
+
+/**
+ * The verdict shape every authorization strategy produces, and the one error
+ * class that is allowed to escape it. Kept apart from the strategies so the
+ * adapters can import the error without pulling in HMAC or session code.
+ */
+
+/** Why a request was refused. `'authorized'` is the one non-refusal. */
+type PreviewAuthorizationOutcome = 'authorized' | 'missing-credential' | 'invalid' | 'expired' | 'wrong-audience' | 'wrong-path' | 'wrong-locale' | 'wrong-purpose' | 'replayed' | 'unavailable';
+/** The result of `authorizePreviewRequest()`: a verdict, never an exception. */
+type PreviewAuthorization = {
+    readonly authorized: true;
+    readonly outcome: 'authorized';
+    readonly context: AuthorizedPreviewContext;
+} | {
+    readonly authorized: false;
+    readonly outcome: Exclude<PreviewAuthorizationOutcome, 'authorized'>;
+    readonly context: null;
+};
+/** The request shape every strategy reads: a URL and a header getter. */
+interface PreviewAuthorizationRequest {
+    readonly url: string;
+    readonly headers: {
+        get(name: string): string | null;
+    };
+}
+
+/**
+ * Server-side preview-intent detection. Every signal here is client-controlled:
+ * a positive result is a delivery hint, never proof of identity or permission.
+ * Verify with `authorizePreviewRequest()` before anything privileged.
+ */
+/** `query`: `?preview=true`; `fetch-dest`: `Sec-Fetch-Dest: iframe`; `referer`: an admin-origin Referer. */
+type PreviewSignal = 'query' | 'fetch-dest' | 'referer';
+interface PreviewRequestOptions {
+    /** Which signals count. Default: all three. `['query']` is the adapters' 2.0 default. */
+    readonly signals?: readonly PreviewSignal[];
+    /** Query parameters (value `true` or `1`) that signal intent. Default `['preview', 'draft', 'livePreview']`. */
+    readonly queryParams?: readonly string[];
+    /** Admin origins whose Referer signals intent, e.g. `['https://cms.example.com']`. */
+    readonly adminOrigins?: readonly string[];
+}
+/** The request surface the predicate reads; `Request` satisfies it, Nitro/H3 events need a shim. */
+interface PreviewRequestLike {
+    readonly url: string;
+    readonly headers: {
+        get(name: string): string | null;
+    };
+}
+/** Whether `request` carries live-preview intent. Intent, not authorization. */
+declare function hasPreviewIntent(request: PreviewRequestLike, options?: PreviewRequestOptions): boolean;
+
+/**
+ * The options every framework adapter shares. Each adapter's public interface
+ * extends this with its request type, so the JSDoc lives here once. Defaults
+ * are the 2.0 table; `defaults: 'v1'` values are noted where they differ.
+ */
+
+/**
+ * What `authorizePreview` may resolve to; anything that is not a context
+ * produced by `authorizePreviewRequest()` is a refusal, a
+ * `{ authorized: true }` literal included.
+ */
+type PreviewAuthorizationHookResult = PreviewAuthorization | AuthorizedPreviewContext | null | undefined;
+interface PreviewAdapterOptions<Req = Request> {
+    /**
+     * Payload admin origins allowed to post updates into the page and, with the
+     * `referer` signal, to count as intent. Required and `https:` under
+     * `strict`. Not HTTP authorization.
+     */
+    readonly allowedOrigins?: readonly string[];
+    /** Payload server origin; updates are then re-fetched through its REST API, which needs an explicit `mergeDepth`. */
+    readonly serverURL?: string;
+    /** REST API route prefix used with `serverURL`. Default `/api`. */
+    readonly apiRoute?: string;
+    /** Population depth for `serverURL` re-fetches, required with it (`0` for none); `defaults: 'v1'` falls back to `1`. */
+    readonly mergeDepth?: number;
+    /** Inject the runtime into preview responses. Default `true`; with `false`, CSP is still managed. */
+    readonly autoInject?: boolean;
+    /** `'preview-only'` (default) gates on an intent signal; `'always'` treats every request as intent, so the hook runs on each. */
+    readonly inject?: 'preview-only' | 'always';
+    /** Query parameters (value `true` or `1`) that signal intent. Default `['preview', 'draft', 'livePreview']`. */
+    readonly previewQueryParams?: readonly string[];
+    /** Client-controlled signals that count as intent. Default `['query']`; `defaults: 'v1'` restores all three, `strict` refuses `'referer'`. */
+    readonly previewSignals?: readonly PreviewSignal[];
+    /**
+     * Route or content filter for script injection only. Not authorization,
+     * and it never suppresses CSP handling.
+     */
+    readonly shouldInject?: (request: Req) => boolean;
+    /** `'frame-ancestors'` (default; `true` is an alias) widens that directive, `'full'` also manages a nonce'd `script-src`, `false` never touches CSP. */
+    readonly manageCsp?: boolean | 'frame-ancestors' | 'full';
+    /**
+     * Add `'strict-dynamic'` to the managed `script-src`. Default `false`:
+     * CSP 3 then ignores `'self'` and host sources, so every script on the
+     * page — framework hydration included — must carry the nonce.
+     */
+    readonly strictDynamic?: boolean;
+    /** Extra `frame-ancestors` sources beyond `'self'` and `allowedOrigins`. */
+    readonly frameAncestorsExtra?: readonly string[];
+    /** Extra `script-src` sources appended after the nonce (`manageCsp: 'full'`). */
+    readonly scriptSrcExtra?: readonly string[];
+    /** Verbose runtime logging. Default `false`. */
+    readonly debug?: boolean;
+    /** Debounce window for incoming updates. Default 50 ms. */
+    readonly debounceMs?: number;
+    /** Heartbeat timeout in ms. Default `0` (off): the Payload admin sends no keepalive. */
+    readonly heartbeatMs?: number;
+    /** Skip bindings whose value did not change. Default `true`; `defaults: 'v1'` restores `false`. */
+    readonly skipUnchanged?: boolean;
+    /** Scroll the preview to the field being edited. Default `false`. */
+    readonly revealEditedField?: boolean;
+    /** Patch only the bindings of the document an update names (`data-payload-owner`). Default `false`. */
+    readonly scopeBindingsByOwner?: boolean;
+    /** Sanitizer for rich text and HTML writes. Default `'strict'`; `defaults: 'v1'` restores `'compat'`. */
+    readonly sanitizerPolicy?: 'compat' | 'strict';
+    /** Which windows may post updates. Default `'parent-or-opener'`; `defaults: 'v1'` restores `'any'`. */
+    readonly eventSourcePolicy?: EventSourcePolicy;
+    /** Ignore `document.referrer` for origin detection. Default `true`; `defaults: 'v1'` restores `false`. */
+    readonly disableReferrerDetection?: boolean;
+    /** Turn off the dev-mode `localhost` origin matcher. Default `false`. */
+    readonly disableLocalhostMatching?: boolean;
+    /**
+     * Verify an intent-bearing request before anything privileged is decided:
+     * return the result of `authorizePreviewRequest()` (or its context), and
+     * anything else refuses injection, CSP changes and nonce exposure
+     * regardless of `autoInject` and `shouldInject`. Required under `strict`.
+     * See ADR 0006.
+     */
+    readonly authorizePreview?: (request: Req) => PreviewAuthorizationHookResult | Promise<PreviewAuthorizationHookResult>;
+    /** Refuse insecure configuration at startup: `authorizePreview`, https `allowedOrigins`, no referrer trust. Default `true`; `defaults: 'v1'` restores `false`. */
+    readonly strict?: boolean;
+    /** `'v2'` (default) is the 2.0 table, `'v1'` stages a migration on the 1.x one; explicit options win. See ADR 0007. */
+    readonly defaults?: DefaultsProfile;
+}
+
+export { type AuthorizedPreviewScope as A, type PreviewAuthorizationRequest as P, type AuthorizedPreviewContext as a, type PreviewAdapterOptions as b, type PreviewRequestLike as c, type PreviewRequestOptions as d, hasPreviewIntent as h };

package/dist/payload.cjs

@@ -1,2 +1,2 @@
-"use strict";var g=Object.defineProperty,o=(e,l)=>g(e,"name",{value:l,configurable:!0});function b(e){let l=e.baseUrl.replace(/\/+$/,""),o=void 0===e.fallback?"/":e.fallback,i=void 0===e.previewParam?"preview":e.previewParam;return t=>{let n=f(t.locale),r={data:t.data,locale:n},a=v(e,t),c=o;if(void 0!==a){let e="function"==typeof a?a(r):a;if(null===e)return null;e.length>0&&(c=e)}if(null===c)return null;if(c.startsWith("/")||(c=`/${c}`),null===i)return`${l}${c}`;let u=c.includes("?")?"&":"?";return`${l}${c}${u}${i}=true`}}function v(e,l){let o=l.collectionConfig?.slug;if(void 0!==o&&void 0!==e.collections&&Object.hasOwn(e.collections,o))return e.collections[o];let i=l.globalConfig?.slug;return void 0!==i&&void 0!==e.globals&&Object.hasOwn(e.globals,i)?e.globals[i]:void 0}function f(e){if(void 0!==e)return"string"==typeof e?e.length>0?e:void 0:e.code.length>0?e.code:void 0}o(b,"buildLivePreviewUrl"),o(v,"findResolver"),o(f,"normaliseLocale"),exports.buildLivePreviewUrl=b;
+"use strict";exports.buildLivePreviewUrl=function(e){const l=e.baseUrl.replace(/\/+$/,""),n=void 0===e.fallback?"/":e.fallback,t=void 0===e.previewParam?"preview":e.previewParam;return o=>{const i=function(e){return void 0===e?void 0:"string"==typeof e?e.length>0?e:void 0:e.code.length>0?e.code:void 0}(o.locale),c={data:o.data,locale:i},r=function(e,l){const n=l.collectionConfig?.slug;if(void 0!==n&&void 0!==e.collections&&Object.hasOwn(e.collections,n))return e.collections[n];const t=l.globalConfig?.slug;return void 0!==t&&void 0!==e.globals&&Object.hasOwn(e.globals,t)?e.globals[t]:void 0}(e,o);let s=n;if(void 0!==r){const e="function"==typeof r?r(c):r;if(null===e)return null;e.length>0&&(s=e)}return null===s?null:(s.startsWith("/")||(s=`/${s}`),`${l}${null===t?s:function(e,l){const n=e.indexOf("#"),t=-1===n?"":e.slice(n),o=-1===n?e:e.slice(0,n),i=o.indexOf("?"),c=-1===i?"":o.slice(i+1);if("true"===new URLSearchParams(c).get(l))return e;return`${o}${-1===i?"?":0===c.length||c.endsWith("&")?"":"&"}${l}=true${t}`}(s,t)}`)}};
 //# sourceMappingURL=payload.cjs.map

package/dist/payload.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"payload.cjs","names":["buildLivePreviewUrl","options","base","baseUrl","replace","fallback","previewParam","args","locale","normaliseLocale","context","data","entry","findResolver","path","resolved","length","startsWith","separator","includes","collectionSlug","collectionConfig","slug","collections","Object","hasOwn","globalSlug","globalConfig","globals","code","__name","exports","b"],"sources":["../src/payload/index.ts"],"sourcesContent":["/**\n * Backend-side helpers for `payload.config.ts`.\n *\n * Payload's `admin.livePreview.url` callback maps the document being\n * edited to the frontend URL that should be shown in the preview\n * iframe. In practice every project hand-writes the same lookup-table\n * boilerplate (global → path, collection → localized route, fallback\n * when a new draft has no slug yet). `buildLivePreviewUrl` packages\n * that pattern.\n *\n * This module is dependency-free and framework-agnostic — it does not\n * import `payload`, it just produces a function with the documented\n * callback shape.\n *\n * ```ts\n * // payload.config.ts\n * import { buildLivePreviewUrl } from 'payload-live-preview/payload';\n *\n * admin: {\n *   livePreview: {\n *     url: buildLivePreviewUrl({\n *       baseUrl: process.env.FRONTEND_URL ?? 'http://localhost:4321',\n *       collections: {\n *         services: ({ data, locale }) => `/${locale}/services/${String(data.slug ?? '')}`,\n *         posts: ({ data }) => `/blog/${String(data.slug ?? '')}`,\n *       },\n *       globals: {\n *         homepage: '/',\n *         contact: ({ locale }) => `/${locale}/contact`,\n *       },\n *       fallback: '/',\n *     }),\n *     collections: ['services', 'posts'],\n *     globals: ['homepage', 'contact'],\n *   },\n * }\n * ```\n *\n * @module @payload\n */\n\n/** Arguments Payload passes to `admin.livePreview.url`. */\nexport interface LivePreviewUrlArgs {\n  readonly data: Record<string, unknown>;\n  readonly locale?: string | { readonly code: string };\n  readonly collectionConfig?: { readonly slug: string };\n  readonly globalConfig?: { readonly slug: string };\n  readonly [extra: string]: unknown;\n}\n\n/** Context handed to per-slug path resolvers. */\nexport interface PathResolverContext {\n  readonly data: Record<string, unknown>;\n  /** Normalised locale code (string), or `undefined`. */\n  readonly locale: string | undefined;\n}\n\nexport type PathResolver = string | ((context: PathResolverContext) => string);\n\n/**\n * Path resolver that may decline a document entirely.\n *\n * `null` means \"this document has no preview target\" — Payload then shows no\n * preview iframe. An empty string keeps its 1.x meaning and falls back.\n */\nexport type NullablePathResolver =\n  string | null | ((context: PathResolverContext) => string | null);\n\nexport interface BuildLivePreviewUrlOptions {\n  /** Frontend origin, e.g. `https://site.example` (no trailing slash needed). */\n  readonly baseUrl: string;\n  /** Per-collection path resolvers keyed by collection slug. */\n  readonly collections?: Readonly<Record<string, PathResolver>>;\n  /** Per-global path resolvers keyed by global slug. */\n  readonly globals?: Readonly<Record<string, PathResolver>>;\n  /**\n   * Path used when no resolver matches, or when a resolver returns an\n   * empty string (e.g. a brand-new draft without a slug). Default `/`.\n   */\n  readonly fallback?: string;\n  /**\n   * Query parameter appended so the frontend can detect preview intent\n   * (`isPreviewRequest` checks it). This client-controlled signal does\n   * not authenticate or authorize draft access or response changes.\n   * Set `null` to disable. Default `'preview'` → `?preview=true`.\n   */\n  readonly previewParam?: string | null;\n}\n\n/**\n * Options that let a document have no preview target at all.\n *\n * Identical to {@link BuildLivePreviewUrlOptions} except that resolvers and\n * `fallback` accept `null`. Using any of them widens the built callback's\n * return type to `string | null`, which is what Payload's own `url` callback\n * accepts — a document without a reachable route should show no iframe rather\n * than silently point at a public page.\n */\nexport interface BuildLivePreviewUrlNullableOptions {\n  /** Frontend origin, e.g. `https://site.example` (no trailing slash needed). */\n  readonly baseUrl: string;\n  /** Per-collection path resolvers keyed by collection slug. */\n  readonly collections?: Readonly<Record<string, NullablePathResolver>>;\n  /** Per-global path resolvers keyed by global slug. */\n  readonly globals?: Readonly<Record<string, NullablePathResolver>>;\n  /**\n   * Path used when no resolver matches, or when a resolver returns an empty\n   * string. `null` declines every unmapped document instead of sending it to\n   * a default route. Default `/`.\n   */\n  readonly fallback?: string | null;\n  /** See {@link BuildLivePreviewUrlOptions.previewParam}. */\n  readonly previewParam?: string | null;\n}\n\n/**\n * Build an `admin.livePreview.url` callback from declarative slug →\n * path mappings.\n *\n * With string-only resolvers the callback always produces a URL, exactly as\n * in 1.0. Let a resolver or `fallback` return `null` and the callback becomes\n * nullable, so a document with no reachable route resolves to no preview\n * instead of to a default public page.\n */\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlOptions,\n): (args: LivePreviewUrlArgs) => string;\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlNullableOptions,\n): (args: LivePreviewUrlArgs) => string | null;\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlNullableOptions,\n): (args: LivePreviewUrlArgs) => string | null {\n  const base = options.baseUrl.replace(/\\/+$/, '');\n  // `??` would swallow an explicit `null`, which is the whole point of the\n  // nullable form: only an absent option falls back to the default path.\n  const fallback = options.fallback === undefined ? '/' : options.fallback;\n  const previewParam = options.previewParam === undefined ? 'preview' : options.previewParam;\n\n  return (args) => {\n    const locale = normaliseLocale(args.locale);\n    const context: PathResolverContext = { data: args.data, locale };\n\n    // A registered resolver whose value is `null` must not be mistaken for an\n    // absent one, so presence is tested rather than coalesced.\n    const entry = findResolver(options, args);\n\n    let path: string | null = fallback;\n    if (entry !== undefined) {\n      const resolved = typeof entry === 'function' ? entry(context) : entry;\n      // `null` is the resolver declining the document; an empty string keeps\n      // its 1.x meaning and falls back.\n      if (resolved === null) return null;\n      if (resolved.length > 0) path = resolved;\n    }\n    if (path === null) return null;\n    if (!path.startsWith('/')) path = `/${path}`;\n\n    if (previewParam === null) return `${base}${path}`;\n    const separator = path.includes('?') ? '&' : '?';\n    return `${base}${path}${separator}${previewParam}=true`;\n  };\n}\n\n/**\n * Registered resolver for this document, or `undefined` when the slug is not\n * mapped at all. A mapped-but-`null` entry returns `null`, which is a resolver\n * value in its own right.\n */\nfunction findResolver(\n  options: BuildLivePreviewUrlNullableOptions,\n  args: LivePreviewUrlArgs,\n): NullablePathResolver | undefined {\n  const collectionSlug = args.collectionConfig?.slug;\n  if (\n    collectionSlug !== undefined &&\n    options.collections !== undefined &&\n    Object.hasOwn(options.collections, collectionSlug)\n  ) {\n    return options.collections[collectionSlug];\n  }\n  const globalSlug = args.globalConfig?.slug;\n  if (\n    globalSlug !== undefined &&\n    options.globals !== undefined &&\n    Object.hasOwn(options.globals, globalSlug)\n  ) {\n    return options.globals[globalSlug];\n  }\n  return undefined;\n}\n\nfunction normaliseLocale(locale: LivePreviewUrlArgs['locale']): string | undefined {\n  if (locale === undefined) return undefined;\n  if (typeof locale === 'string') return locale.length > 0 ? locale : undefined;\n  return locale.code.length > 0 ? locale.code : undefined;\n}\n"],"mappings":"wFAkIO,SAASA,EACdC,GAEA,IAAMC,EAAOD,EAAQE,QAAQC,QAAQ,OAAQ,IAGvCC,OAAgC,IAArBJ,EAAQI,SAAyB,IAAMJ,EAAQI,SAC1DC,OAAwC,IAAzBL,EAAQK,aAA6B,UAAYL,EAAQK,aAE9E,OAAQC,IACN,IAAMC,EAASC,EAAgBF,EAAKC,QAC9BE,EAA+B,CAAEC,KAAMJ,EAAKI,KAAMH,UAIlDI,EAAQC,EAAaZ,EAASM,GAEhCO,EAAsBT,EAC1B,QAAc,IAAVO,EAAqB,CACvB,IAAMG,EAA4B,mBAAVH,EAAuBA,EAAMF,GAAWE,EAGhE,GAAiB,OAAbG,EAAmB,OAAO,KAC1BA,EAASC,OAAS,IAAGF,EAAOC,EAClC,CACA,GAAa,OAATD,EAAe,OAAO,KAG1B,GAFKA,EAAKG,WAAW,OAAMH,EAAO,IAAIA,KAEjB,OAAjBR,EAAuB,MAAO,GAAGJ,IAAOY,IAC5C,IAAMI,EAAYJ,EAAKK,SAAS,KAAO,IAAM,IAC7C,MAAO,GAAGjB,IAAOY,IAAOI,IAAYZ,SAExC,CAOA,SAASO,EACPZ,EACAM,GAEA,IAAMa,EAAiBb,EAAKc,kBAAkBC,KAC9C,QACqB,IAAnBF,QACwB,IAAxBnB,EAAQsB,aACRC,OAAOC,OAAOxB,EAAQsB,YAAaH,GAEnC,OAAOnB,EAAQsB,YAAYH,GAE7B,IAAMM,EAAanB,EAAKoB,cAAcL,KACtC,YACiB,IAAfI,QACoB,IAApBzB,EAAQ2B,SACRJ,OAAOC,OAAOxB,EAAQ2B,QAASF,GAExBzB,EAAQ2B,QAAQF,QALzB,CAQF,CAEA,SAASjB,EAAgBD,GACvB,QAAe,IAAXA,EACJ,MAAsB,iBAAXA,EAA4BA,EAAOQ,OAAS,EAAIR,OAAS,EAC7DA,EAAOqB,KAAKb,OAAS,EAAIR,EAAOqB,UAAO,CAChD,CAlEgBC,EAAA9B,EAAA,uBAuCP8B,EAAAjB,EAAA,gBAuBAiB,EAAArB,EAAA,mBAAAsB,QAAA/B,oBAAAgC","ignoreList":[]}
+{"version":3,"file":"payload.cjs","names":["options","base","baseUrl","replace","fallback","previewParam","args","locale","length","code","normaliseLocale","context","data","entry","collectionSlug","collectionConfig","slug","collections","Object","hasOwn","globalSlug","globalConfig","globals","findResolver","path","resolved","startsWith","name","hashAt","indexOf","hash","slice","beforeHash","queryAt","query","URLSearchParams","get","endsWith","withPreviewParam"],"sources":["../src/payload/index.ts"],"sourcesContent":["/**\n * `payload-live-preview/payload` — helpers for `payload.config.ts`. It never\n * imports `payload`, only produces the callback `admin.livePreview.url` expects.\n */\n\n/** Arguments Payload passes to `admin.livePreview.url`. */\nexport interface LivePreviewUrlArgs {\n  readonly data: Record<string, unknown>;\n  readonly locale?: string | { readonly code: string };\n  readonly collectionConfig?: { readonly slug: string };\n  readonly globalConfig?: { readonly slug: string };\n  readonly [extra: string]: unknown;\n}\n\n/** Context handed to per-slug path resolvers. */\nexport interface PathResolverContext {\n  readonly data: Record<string, unknown>;\n  /** Normalised locale code, or `undefined`. */\n  readonly locale: string | undefined;\n}\n\nexport type PathResolver = string | ((context: PathResolverContext) => string);\n\n/** A resolver that may decline a document: `null` means no preview target; `''` falls back. */\nexport type NullablePathResolver =\n  string | null | ((context: PathResolverContext) => string | null);\n\nexport interface BuildLivePreviewUrlOptions {\n  /** Frontend origin, e.g. `https://site.example`. */\n  readonly baseUrl: string;\n  /** Per-collection path resolvers keyed by collection slug. */\n  readonly collections?: Readonly<Record<string, PathResolver>>;\n  /** Per-global path resolvers keyed by global slug. */\n  readonly globals?: Readonly<Record<string, PathResolver>>;\n  /** Path when no resolver matches or one returns `''` (a draft without a slug). Default `/`. */\n  readonly fallback?: string;\n  /** Query parameter signalling preview intent; client-controlled, so it authorizes nothing. Default `'preview'`, `null` disables it. */\n  readonly previewParam?: string | null;\n}\n\n/**\n * Like {@link BuildLivePreviewUrlOptions} with nullable resolvers: the callback\n * may return `null`, and no iframe beats one pointing at a public page.\n */\nexport interface BuildLivePreviewUrlNullableOptions {\n  readonly baseUrl: string;\n  readonly collections?: Readonly<Record<string, NullablePathResolver>>;\n  readonly globals?: Readonly<Record<string, NullablePathResolver>>;\n  /** `null` declines every unmapped document. Default `/`. */\n  readonly fallback?: string | null;\n  /** See {@link BuildLivePreviewUrlOptions.previewParam}. */\n  readonly previewParam?: string | null;\n}\n\n/** Build an `admin.livePreview.url` callback from slug → path mappings. */\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlOptions,\n): (args: LivePreviewUrlArgs) => string;\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlNullableOptions,\n): (args: LivePreviewUrlArgs) => string | null;\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlNullableOptions,\n): (args: LivePreviewUrlArgs) => string | null {\n  const base = options.baseUrl.replace(/\\/+$/, '');\n  // `??` would swallow an explicit `null`, which is the whole point of the nullable form.\n  const fallback = options.fallback === undefined ? '/' : options.fallback;\n  const previewParam = options.previewParam === undefined ? 'preview' : options.previewParam;\n\n  return (args) => {\n    const locale = normaliseLocale(args.locale);\n    const context: PathResolverContext = { data: args.data, locale };\n    const entry = findResolver(options, args);\n\n    let path: string | null = fallback;\n    if (entry !== undefined) {\n      const resolved = typeof entry === 'function' ? entry(context) : entry;\n      if (resolved === null) return null;\n      if (resolved.length > 0) path = resolved;\n    }\n    if (path === null) return null;\n    if (!path.startsWith('/')) path = `/${path}`;\n    return `${base}${previewParam === null ? path : withPreviewParam(path, previewParam)}`;\n  };\n}\n\n/** `path` with `<name>=true` in its query — ahead of any `#fragment`, and not twice. */\nfunction withPreviewParam(path: string, name: string): string {\n  const hashAt = path.indexOf('#');\n  const hash = hashAt === -1 ? '' : path.slice(hashAt);\n  const beforeHash = hashAt === -1 ? path : path.slice(0, hashAt);\n  const queryAt = beforeHash.indexOf('?');\n  const query = queryAt === -1 ? '' : beforeHash.slice(queryAt + 1);\n  if (new URLSearchParams(query).get(name) === 'true') return path;\n  const separator = queryAt === -1 ? '?' : query.length === 0 || query.endsWith('&') ? '' : '&';\n  return `${beforeHash}${separator}${name}=true${hash}`;\n}\n\n/** The mapped resolver, or `undefined` when the slug is not mapped; a mapped `null` is a resolver in its own right. */\nfunction findResolver(\n  options: BuildLivePreviewUrlNullableOptions,\n  args: LivePreviewUrlArgs,\n): NullablePathResolver | undefined {\n  const collectionSlug = args.collectionConfig?.slug;\n  if (\n    collectionSlug !== undefined &&\n    options.collections !== undefined &&\n    Object.hasOwn(options.collections, collectionSlug)\n  ) {\n    return options.collections[collectionSlug];\n  }\n  const globalSlug = args.globalConfig?.slug;\n  if (\n    globalSlug !== undefined &&\n    options.globals !== undefined &&\n    Object.hasOwn(options.globals, globalSlug)\n  ) {\n    return options.globals[globalSlug];\n  }\n  return undefined;\n}\n\nfunction normaliseLocale(locale: LivePreviewUrlArgs['locale']): string | undefined {\n  if (locale === undefined) return undefined;\n  if (typeof locale === 'string') return locale.length > 0 ? locale : undefined;\n  return locale.code.length > 0 ? locale.code : undefined;\n}\n"],"mappings":"yCA6DO,SACLA,GAEA,MAAMC,EAAOD,EAAQE,QAAQC,QAAQ,OAAQ,IAEvCC,OAAgC,IAArBJ,EAAQI,SAAyB,IAAMJ,EAAQI,SAC1DC,OAAwC,IAAzBL,EAAQK,aAA6B,UAAYL,EAAQK,aAE9E,OAAQC,IACN,MAAMC,EAoDV,SAAyBA,GACvB,YAAe,IAAXA,OAAsB,EACJ,iBAAXA,EAA4BA,EAAOC,OAAS,EAAID,OAAS,EAC7DA,EAAOE,KAAKD,OAAS,EAAID,EAAOE,UAAO,CAChD,CAxDmBC,CAAgBJ,EAAKC,QAC9BI,EAA+B,CAAEC,KAAMN,EAAKM,KAAML,UAClDM,EA2BV,SACEb,EACAM,GAEA,MAAMQ,EAAiBR,EAAKS,kBAAkBC,KAC9C,QACqB,IAAnBF,QACwB,IAAxBd,EAAQiB,aACRC,OAAOC,OAAOnB,EAAQiB,YAAaH,GAEnC,OAAOd,EAAQiB,YAAYH,GAE7B,MAAMM,EAAad,EAAKe,cAAcL,KACtC,YACiB,IAAfI,QACoB,IAApBpB,EAAQsB,SACRJ,OAAOC,OAAOnB,EAAQsB,QAASF,GAExBpB,EAAQsB,QAAQF,QALzB,CAQF,CAhDkBG,CAAavB,EAASM,GAEpC,IAAIkB,EAAsBpB,EAC1B,QAAc,IAAVS,EAAqB,CACvB,MAAMY,EAA4B,mBAAVZ,EAAuBA,EAAMF,GAAWE,EAChE,GAAiB,OAAbY,EAAmB,OAAO,KAC1BA,EAASjB,OAAS,IAAGgB,EAAOC,EAClC,CACA,OAAa,OAATD,EAAsB,MACrBA,EAAKE,WAAW,OAAMF,EAAO,IAAIA,KAC/B,GAAGvB,IAAwB,OAAjBI,EAAwBmB,EAK7C,SAA0BA,EAAcG,GACtC,MAAMC,EAASJ,EAAKK,QAAQ,KACtBC,GAAkB,IAAXF,EAAgB,GAAKJ,EAAKO,MAAMH,GACvCI,GAAwB,IAAXJ,EAAgBJ,EAAOA,EAAKO,MAAM,EAAGH,GAClDK,EAAUD,EAAWH,QAAQ,KAC7BK,GAAoB,IAAZD,EAAiB,GAAKD,EAAWD,MAAME,EAAU,GAC/D,GAA6C,SAAzC,IAAIE,gBAAgBD,GAAOE,IAAIT,GAAkB,OAAOH,EAE5D,MAAO,GAAGQ,KADoB,IAAZC,EAAiB,IAAuB,IAAjBC,EAAM1B,QAAgB0B,EAAMG,SAAS,KAAO,GAAK,MACvDV,SAAYG,GACjD,CAdoDQ,CAAiBd,EAAMnB,MAE3E","ignoreList":[]}

package/dist/payload.d.cts

@@ -1,42 +1,6 @@
 /**
- * Backend-side helpers for `payload.config.ts`.
- *
- * Payload's `admin.livePreview.url` callback maps the document being
- * edited to the frontend URL that should be shown in the preview
- * iframe. In practice every project hand-writes the same lookup-table
- * boilerplate (global → path, collection → localized route, fallback
- * when a new draft has no slug yet). `buildLivePreviewUrl` packages
- * that pattern.
- *
- * This module is dependency-free and framework-agnostic — it does not
- * import `payload`, it just produces a function with the documented
- * callback shape.
- *
- * ```ts
- * // payload.config.ts
- * import { buildLivePreviewUrl } from 'payload-live-preview/payload';
- *
- * admin: {
- *   livePreview: {
- *     url: buildLivePreviewUrl({
- *       baseUrl: process.env.FRONTEND_URL ?? 'http://localhost:4321',
- *       collections: {
- *         services: ({ data, locale }) => `/${locale}/services/${String(data.slug ?? '')}`,
- *         posts: ({ data }) => `/blog/${String(data.slug ?? '')}`,
- *       },
- *       globals: {
- *         homepage: '/',
- *         contact: ({ locale }) => `/${locale}/contact`,
- *       },
- *       fallback: '/',
- *     }),
- *     collections: ['services', 'posts'],
- *     globals: ['homepage', 'contact'],
- *   },
- * }
- * ```
- *
- * @module @payload
+ * `payload-live-preview/payload` — helpers for `payload.config.ts`. It never
+ * imports `payload`, only produces the callback `admin.livePreview.url` expects.
  */
 /** Arguments Payload passes to `admin.livePreview.url`. */
 interface LivePreviewUrlArgs {
@@ -55,71 +19,38 @@ interface LivePreviewUrlArgs {
 /** Context handed to per-slug path resolvers. */
 interface PathResolverContext {
     readonly data: Record<string, unknown>;
-    /** Normalised locale code (string), or `undefined`. */
+    /** Normalised locale code, or `undefined`. */
     readonly locale: string | undefined;
 }
 type PathResolver = string | ((context: PathResolverContext) => string);
-/**
- * Path resolver that may decline a document entirely.
- *
- * `null` means "this document has no preview target" — Payload then shows no
- * preview iframe. An empty string keeps its 1.x meaning and falls back.
- */
+/** A resolver that may decline a document: `null` means no preview target; `''` falls back. */
 type NullablePathResolver = string | null | ((context: PathResolverContext) => string | null);
 interface BuildLivePreviewUrlOptions {
-    /** Frontend origin, e.g. `https://site.example` (no trailing slash needed). */
+    /** Frontend origin, e.g. `https://site.example`. */
     readonly baseUrl: string;
     /** Per-collection path resolvers keyed by collection slug. */
     readonly collections?: Readonly<Record<string, PathResolver>>;
     /** Per-global path resolvers keyed by global slug. */
     readonly globals?: Readonly<Record<string, PathResolver>>;
-    /**
-     * Path used when no resolver matches, or when a resolver returns an
-     * empty string (e.g. a brand-new draft without a slug). Default `/`.
-     */
+    /** Path when no resolver matches or one returns `''` (a draft without a slug). Default `/`. */
     readonly fallback?: string;
-    /**
-     * Query parameter appended so the frontend can detect preview intent
-     * (`isPreviewRequest` checks it). This client-controlled signal does
-     * not authenticate or authorize draft access or response changes.
-     * Set `null` to disable. Default `'preview'` → `?preview=true`.
-     */
+    /** Query parameter signalling preview intent; client-controlled, so it authorizes nothing. Default `'preview'`, `null` disables it. */
     readonly previewParam?: string | null;
 }
 /**
- * Options that let a document have no preview target at all.
- *
- * Identical to {@link BuildLivePreviewUrlOptions} except that resolvers and
- * `fallback` accept `null`. Using any of them widens the built callback's
- * return type to `string | null`, which is what Payload's own `url` callback
- * accepts — a document without a reachable route should show no iframe rather
- * than silently point at a public page.
+ * Like {@link BuildLivePreviewUrlOptions} with nullable resolvers: the callback
+ * may return `null`, and no iframe beats one pointing at a public page.
  */
 interface BuildLivePreviewUrlNullableOptions {
-    /** Frontend origin, e.g. `https://site.example` (no trailing slash needed). */
     readonly baseUrl: string;
-    /** Per-collection path resolvers keyed by collection slug. */
     readonly collections?: Readonly<Record<string, NullablePathResolver>>;
-    /** Per-global path resolvers keyed by global slug. */
     readonly globals?: Readonly<Record<string, NullablePathResolver>>;
-    /**
-     * Path used when no resolver matches, or when a resolver returns an empty
-     * string. `null` declines every unmapped document instead of sending it to
-     * a default route. Default `/`.
-     */
+    /** `null` declines every unmapped document. Default `/`. */
     readonly fallback?: string | null;
     /** See {@link BuildLivePreviewUrlOptions.previewParam}. */
     readonly previewParam?: string | null;
 }
-/**
- * Build an `admin.livePreview.url` callback from declarative slug →
- * path mappings.
- *
- * With string-only resolvers the callback always produces a URL, exactly as
- * in 1.0. Let a resolver or `fallback` return `null` and the callback becomes
- * nullable, so a document with no reachable route resolves to no preview
- * instead of to a default public page.
- */
+/** Build an `admin.livePreview.url` callback from slug → path mappings. */
 declare function buildLivePreviewUrl(options: BuildLivePreviewUrlOptions): (args: LivePreviewUrlArgs) => string;
 declare function buildLivePreviewUrl(options: BuildLivePreviewUrlNullableOptions): (args: LivePreviewUrlArgs) => string | null;
 

package/dist/payload.d.ts

@@ -1,42 +1,6 @@
 /**
- * Backend-side helpers for `payload.config.ts`.
- *
- * Payload's `admin.livePreview.url` callback maps the document being
- * edited to the frontend URL that should be shown in the preview
- * iframe. In practice every project hand-writes the same lookup-table
- * boilerplate (global → path, collection → localized route, fallback
- * when a new draft has no slug yet). `buildLivePreviewUrl` packages
- * that pattern.
- *
- * This module is dependency-free and framework-agnostic — it does not
- * import `payload`, it just produces a function with the documented
- * callback shape.
- *
- * ```ts
- * // payload.config.ts
- * import { buildLivePreviewUrl } from 'payload-live-preview/payload';
- *
- * admin: {
- *   livePreview: {
- *     url: buildLivePreviewUrl({
- *       baseUrl: process.env.FRONTEND_URL ?? 'http://localhost:4321',
- *       collections: {
- *         services: ({ data, locale }) => `/${locale}/services/${String(data.slug ?? '')}`,
- *         posts: ({ data }) => `/blog/${String(data.slug ?? '')}`,
- *       },
- *       globals: {
- *         homepage: '/',
- *         contact: ({ locale }) => `/${locale}/contact`,
- *       },
- *       fallback: '/',
- *     }),
- *     collections: ['services', 'posts'],
- *     globals: ['homepage', 'contact'],
- *   },
- * }
- * ```
- *
- * @module @payload
+ * `payload-live-preview/payload` — helpers for `payload.config.ts`. It never
+ * imports `payload`, only produces the callback `admin.livePreview.url` expects.
  */
 /** Arguments Payload passes to `admin.livePreview.url`. */
 interface LivePreviewUrlArgs {
@@ -55,71 +19,38 @@ interface LivePreviewUrlArgs {
 /** Context handed to per-slug path resolvers. */
 interface PathResolverContext {
     readonly data: Record<string, unknown>;
-    /** Normalised locale code (string), or `undefined`. */
+    /** Normalised locale code, or `undefined`. */
     readonly locale: string | undefined;
 }
 type PathResolver = string | ((context: PathResolverContext) => string);
-/**
- * Path resolver that may decline a document entirely.
- *
- * `null` means "this document has no preview target" — Payload then shows no
- * preview iframe. An empty string keeps its 1.x meaning and falls back.
- */
+/** A resolver that may decline a document: `null` means no preview target; `''` falls back. */
 type NullablePathResolver = string | null | ((context: PathResolverContext) => string | null);
 interface BuildLivePreviewUrlOptions {
-    /** Frontend origin, e.g. `https://site.example` (no trailing slash needed). */
+    /** Frontend origin, e.g. `https://site.example`. */
     readonly baseUrl: string;
     /** Per-collection path resolvers keyed by collection slug. */
     readonly collections?: Readonly<Record<string, PathResolver>>;
     /** Per-global path resolvers keyed by global slug. */
     readonly globals?: Readonly<Record<string, PathResolver>>;
-    /**
-     * Path used when no resolver matches, or when a resolver returns an
-     * empty string (e.g. a brand-new draft without a slug). Default `/`.
-     */
+    /** Path when no resolver matches or one returns `''` (a draft without a slug). Default `/`. */
     readonly fallback?: string;
-    /**
-     * Query parameter appended so the frontend can detect preview intent
-     * (`isPreviewRequest` checks it). This client-controlled signal does
-     * not authenticate or authorize draft access or response changes.
-     * Set `null` to disable. Default `'preview'` → `?preview=true`.
-     */
+    /** Query parameter signalling preview intent; client-controlled, so it authorizes nothing. Default `'preview'`, `null` disables it. */
     readonly previewParam?: string | null;
 }
 /**
- * Options that let a document have no preview target at all.
- *
- * Identical to {@link BuildLivePreviewUrlOptions} except that resolvers and
- * `fallback` accept `null`. Using any of them widens the built callback's
- * return type to `string | null`, which is what Payload's own `url` callback
- * accepts — a document without a reachable route should show no iframe rather
- * than silently point at a public page.
+ * Like {@link BuildLivePreviewUrlOptions} with nullable resolvers: the callback
+ * may return `null`, and no iframe beats one pointing at a public page.
  */
 interface BuildLivePreviewUrlNullableOptions {
-    /** Frontend origin, e.g. `https://site.example` (no trailing slash needed). */
     readonly baseUrl: string;
-    /** Per-collection path resolvers keyed by collection slug. */
     readonly collections?: Readonly<Record<string, NullablePathResolver>>;
-    /** Per-global path resolvers keyed by global slug. */
     readonly globals?: Readonly<Record<string, NullablePathResolver>>;
-    /**
-     * Path used when no resolver matches, or when a resolver returns an empty
-     * string. `null` declines every unmapped document instead of sending it to
-     * a default route. Default `/`.
-     */
+    /** `null` declines every unmapped document. Default `/`. */
     readonly fallback?: string | null;
     /** See {@link BuildLivePreviewUrlOptions.previewParam}. */
     readonly previewParam?: string | null;
 }
-/**
- * Build an `admin.livePreview.url` callback from declarative slug →
- * path mappings.
- *
- * With string-only resolvers the callback always produces a URL, exactly as
- * in 1.0. Let a resolver or `fallback` return `null` and the callback becomes
- * nullable, so a document with no reachable route resolves to no preview
- * instead of to a default public page.
- */
+/** Build an `admin.livePreview.url` callback from slug → path mappings. */
 declare function buildLivePreviewUrl(options: BuildLivePreviewUrlOptions): (args: LivePreviewUrlArgs) => string;
 declare function buildLivePreviewUrl(options: BuildLivePreviewUrlNullableOptions): (args: LivePreviewUrlArgs) => string | null;
 

package/dist/payload.js

@@ -1,2 +1,2 @@
-var e=Object.defineProperty,l=(l,i)=>e(l,"name",{value:i,configurable:!0});function i(e){let l=e.baseUrl.replace(/\/+$/,""),i=void 0===e.fallback?"/":e.fallback,t=void 0===e.previewParam?"preview":e.previewParam;return r=>{let a=n(r.locale),c={data:r.data,locale:a},u=o(e,r),v=i;if(void 0!==u){let e="function"==typeof u?u(c):u;if(null===e)return null;e.length>0&&(v=e)}if(null===v)return null;if(v.startsWith("/")||(v=`/${v}`),null===t)return`${l}${v}`;let d=v.includes("?")?"&":"?";return`${l}${v}${d}${t}=true`}}function o(e,l){let i=l.collectionConfig?.slug;if(void 0!==i&&void 0!==e.collections&&Object.hasOwn(e.collections,i))return e.collections[i];let o=l.globalConfig?.slug;return void 0!==o&&void 0!==e.globals&&Object.hasOwn(e.globals,o)?e.globals[o]:void 0}function n(e){if(void 0!==e)return"string"==typeof e?e.length>0?e:void 0:e.code.length>0?e.code:void 0}l(i,"buildLivePreviewUrl"),l(o,"findResolver"),l(n,"normaliseLocale");export{i as buildLivePreviewUrl};
+function e(e){const l=e.baseUrl.replace(/\/+$/,""),n=void 0===e.fallback?"/":e.fallback,o=void 0===e.previewParam?"preview":e.previewParam;return t=>{const i=function(e){return void 0===e?void 0:"string"==typeof e?e.length>0?e:void 0:e.code.length>0?e.code:void 0}(t.locale),c={data:t.data,locale:i},r=function(e,l){const n=l.collectionConfig?.slug;if(void 0!==n&&void 0!==e.collections&&Object.hasOwn(e.collections,n))return e.collections[n];const o=l.globalConfig?.slug;return void 0!==o&&void 0!==e.globals&&Object.hasOwn(e.globals,o)?e.globals[o]:void 0}(e,t);let a=n;if(void 0!==r){const e="function"==typeof r?r(c):r;if(null===e)return null;e.length>0&&(a=e)}return null===a?null:(a.startsWith("/")||(a=`/${a}`),`${l}${null===o?a:function(e,l){const n=e.indexOf("#"),o=-1===n?"":e.slice(n),t=-1===n?e:e.slice(0,n),i=t.indexOf("?"),c=-1===i?"":t.slice(i+1);if("true"===new URLSearchParams(c).get(l))return e;return`${t}${-1===i?"?":0===c.length||c.endsWith("&")?"":"&"}${l}=true${o}`}(a,o)}`)}}export{e as buildLivePreviewUrl};
 //# sourceMappingURL=payload.js.map

package/dist/payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"payload.js","names":["buildLivePreviewUrl","options","base","baseUrl","replace","fallback","previewParam","args","locale","normaliseLocale","context","data","entry","findResolver","path","resolved","length","startsWith","separator","includes","collectionSlug","collectionConfig","slug","collections","Object","hasOwn","globalSlug","globalConfig","globals","code","__name","b"],"sources":["../src/payload/index.ts"],"sourcesContent":["/**\n * Backend-side helpers for `payload.config.ts`.\n *\n * Payload's `admin.livePreview.url` callback maps the document being\n * edited to the frontend URL that should be shown in the preview\n * iframe. In practice every project hand-writes the same lookup-table\n * boilerplate (global → path, collection → localized route, fallback\n * when a new draft has no slug yet). `buildLivePreviewUrl` packages\n * that pattern.\n *\n * This module is dependency-free and framework-agnostic — it does not\n * import `payload`, it just produces a function with the documented\n * callback shape.\n *\n * ```ts\n * // payload.config.ts\n * import { buildLivePreviewUrl } from 'payload-live-preview/payload';\n *\n * admin: {\n *   livePreview: {\n *     url: buildLivePreviewUrl({\n *       baseUrl: process.env.FRONTEND_URL ?? 'http://localhost:4321',\n *       collections: {\n *         services: ({ data, locale }) => `/${locale}/services/${String(data.slug ?? '')}`,\n *         posts: ({ data }) => `/blog/${String(data.slug ?? '')}`,\n *       },\n *       globals: {\n *         homepage: '/',\n *         contact: ({ locale }) => `/${locale}/contact`,\n *       },\n *       fallback: '/',\n *     }),\n *     collections: ['services', 'posts'],\n *     globals: ['homepage', 'contact'],\n *   },\n * }\n * ```\n *\n * @module @payload\n */\n\n/** Arguments Payload passes to `admin.livePreview.url`. */\nexport interface LivePreviewUrlArgs {\n  readonly data: Record<string, unknown>;\n  readonly locale?: string | { readonly code: string };\n  readonly collectionConfig?: { readonly slug: string };\n  readonly globalConfig?: { readonly slug: string };\n  readonly [extra: string]: unknown;\n}\n\n/** Context handed to per-slug path resolvers. */\nexport interface PathResolverContext {\n  readonly data: Record<string, unknown>;\n  /** Normalised locale code (string), or `undefined`. */\n  readonly locale: string | undefined;\n}\n\nexport type PathResolver = string | ((context: PathResolverContext) => string);\n\n/**\n * Path resolver that may decline a document entirely.\n *\n * `null` means \"this document has no preview target\" — Payload then shows no\n * preview iframe. An empty string keeps its 1.x meaning and falls back.\n */\nexport type NullablePathResolver =\n  string | null | ((context: PathResolverContext) => string | null);\n\nexport interface BuildLivePreviewUrlOptions {\n  /** Frontend origin, e.g. `https://site.example` (no trailing slash needed). */\n  readonly baseUrl: string;\n  /** Per-collection path resolvers keyed by collection slug. */\n  readonly collections?: Readonly<Record<string, PathResolver>>;\n  /** Per-global path resolvers keyed by global slug. */\n  readonly globals?: Readonly<Record<string, PathResolver>>;\n  /**\n   * Path used when no resolver matches, or when a resolver returns an\n   * empty string (e.g. a brand-new draft without a slug). Default `/`.\n   */\n  readonly fallback?: string;\n  /**\n   * Query parameter appended so the frontend can detect preview intent\n   * (`isPreviewRequest` checks it). This client-controlled signal does\n   * not authenticate or authorize draft access or response changes.\n   * Set `null` to disable. Default `'preview'` → `?preview=true`.\n   */\n  readonly previewParam?: string | null;\n}\n\n/**\n * Options that let a document have no preview target at all.\n *\n * Identical to {@link BuildLivePreviewUrlOptions} except that resolvers and\n * `fallback` accept `null`. Using any of them widens the built callback's\n * return type to `string | null`, which is what Payload's own `url` callback\n * accepts — a document without a reachable route should show no iframe rather\n * than silently point at a public page.\n */\nexport interface BuildLivePreviewUrlNullableOptions {\n  /** Frontend origin, e.g. `https://site.example` (no trailing slash needed). */\n  readonly baseUrl: string;\n  /** Per-collection path resolvers keyed by collection slug. */\n  readonly collections?: Readonly<Record<string, NullablePathResolver>>;\n  /** Per-global path resolvers keyed by global slug. */\n  readonly globals?: Readonly<Record<string, NullablePathResolver>>;\n  /**\n   * Path used when no resolver matches, or when a resolver returns an empty\n   * string. `null` declines every unmapped document instead of sending it to\n   * a default route. Default `/`.\n   */\n  readonly fallback?: string | null;\n  /** See {@link BuildLivePreviewUrlOptions.previewParam}. */\n  readonly previewParam?: string | null;\n}\n\n/**\n * Build an `admin.livePreview.url` callback from declarative slug →\n * path mappings.\n *\n * With string-only resolvers the callback always produces a URL, exactly as\n * in 1.0. Let a resolver or `fallback` return `null` and the callback becomes\n * nullable, so a document with no reachable route resolves to no preview\n * instead of to a default public page.\n */\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlOptions,\n): (args: LivePreviewUrlArgs) => string;\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlNullableOptions,\n): (args: LivePreviewUrlArgs) => string | null;\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlNullableOptions,\n): (args: LivePreviewUrlArgs) => string | null {\n  const base = options.baseUrl.replace(/\\/+$/, '');\n  // `??` would swallow an explicit `null`, which is the whole point of the\n  // nullable form: only an absent option falls back to the default path.\n  const fallback = options.fallback === undefined ? '/' : options.fallback;\n  const previewParam = options.previewParam === undefined ? 'preview' : options.previewParam;\n\n  return (args) => {\n    const locale = normaliseLocale(args.locale);\n    const context: PathResolverContext = { data: args.data, locale };\n\n    // A registered resolver whose value is `null` must not be mistaken for an\n    // absent one, so presence is tested rather than coalesced.\n    const entry = findResolver(options, args);\n\n    let path: string | null = fallback;\n    if (entry !== undefined) {\n      const resolved = typeof entry === 'function' ? entry(context) : entry;\n      // `null` is the resolver declining the document; an empty string keeps\n      // its 1.x meaning and falls back.\n      if (resolved === null) return null;\n      if (resolved.length > 0) path = resolved;\n    }\n    if (path === null) return null;\n    if (!path.startsWith('/')) path = `/${path}`;\n\n    if (previewParam === null) return `${base}${path}`;\n    const separator = path.includes('?') ? '&' : '?';\n    return `${base}${path}${separator}${previewParam}=true`;\n  };\n}\n\n/**\n * Registered resolver for this document, or `undefined` when the slug is not\n * mapped at all. A mapped-but-`null` entry returns `null`, which is a resolver\n * value in its own right.\n */\nfunction findResolver(\n  options: BuildLivePreviewUrlNullableOptions,\n  args: LivePreviewUrlArgs,\n): NullablePathResolver | undefined {\n  const collectionSlug = args.collectionConfig?.slug;\n  if (\n    collectionSlug !== undefined &&\n    options.collections !== undefined &&\n    Object.hasOwn(options.collections, collectionSlug)\n  ) {\n    return options.collections[collectionSlug];\n  }\n  const globalSlug = args.globalConfig?.slug;\n  if (\n    globalSlug !== undefined &&\n    options.globals !== undefined &&\n    Object.hasOwn(options.globals, globalSlug)\n  ) {\n    return options.globals[globalSlug];\n  }\n  return undefined;\n}\n\nfunction normaliseLocale(locale: LivePreviewUrlArgs['locale']): string | undefined {\n  if (locale === undefined) return undefined;\n  if (typeof locale === 'string') return locale.length > 0 ? locale : undefined;\n  return locale.code.length > 0 ? locale.code : undefined;\n}\n"],"mappings":"2EAkIO,SAASA,EACdC,GAEA,IAAMC,EAAOD,EAAQE,QAAQC,QAAQ,OAAQ,IAGvCC,OAAgC,IAArBJ,EAAQI,SAAyB,IAAMJ,EAAQI,SAC1DC,OAAwC,IAAzBL,EAAQK,aAA6B,UAAYL,EAAQK,aAE9E,OAAQC,IACN,IAAMC,EAASC,EAAgBF,EAAKC,QAC9BE,EAA+B,CAAEC,KAAMJ,EAAKI,KAAMH,UAIlDI,EAAQC,EAAaZ,EAASM,GAEhCO,EAAsBT,EAC1B,QAAc,IAAVO,EAAqB,CACvB,IAAMG,EAA4B,mBAAVH,EAAuBA,EAAMF,GAAWE,EAGhE,GAAiB,OAAbG,EAAmB,OAAO,KAC1BA,EAASC,OAAS,IAAGF,EAAOC,EAClC,CACA,GAAa,OAATD,EAAe,OAAO,KAG1B,GAFKA,EAAKG,WAAW,OAAMH,EAAO,IAAIA,KAEjB,OAAjBR,EAAuB,MAAO,GAAGJ,IAAOY,IAC5C,IAAMI,EAAYJ,EAAKK,SAAS,KAAO,IAAM,IAC7C,MAAO,GAAGjB,IAAOY,IAAOI,IAAYZ,SAExC,CAOA,SAASO,EACPZ,EACAM,GAEA,IAAMa,EAAiBb,EAAKc,kBAAkBC,KAC9C,QACqB,IAAnBF,QACwB,IAAxBnB,EAAQsB,aACRC,OAAOC,OAAOxB,EAAQsB,YAAaH,GAEnC,OAAOnB,EAAQsB,YAAYH,GAE7B,IAAMM,EAAanB,EAAKoB,cAAcL,KACtC,YACiB,IAAfI,QACoB,IAApBzB,EAAQ2B,SACRJ,OAAOC,OAAOxB,EAAQ2B,QAASF,GAExBzB,EAAQ2B,QAAQF,QALzB,CAQF,CAEA,SAASjB,EAAgBD,GACvB,QAAe,IAAXA,EACJ,MAAsB,iBAAXA,EAA4BA,EAAOQ,OAAS,EAAIR,OAAS,EAC7DA,EAAOqB,KAAKb,OAAS,EAAIR,EAAOqB,UAAO,CAChD,CAlEgBC,EAAA9B,EAAA,uBAuCP8B,EAAAjB,EAAA,gBAuBAiB,EAAArB,EAAA,0BAAAsB","ignoreList":[]}
+{"version":3,"file":"payload.js","names":["buildLivePreviewUrl","options","base","baseUrl","replace","fallback","previewParam","args","locale","length","code","normaliseLocale","context","data","entry","collectionSlug","collectionConfig","slug","collections","Object","hasOwn","globalSlug","globalConfig","globals","findResolver","path","resolved","startsWith","name","hashAt","indexOf","hash","slice","beforeHash","queryAt","query","URLSearchParams","get","endsWith","withPreviewParam"],"sources":["../src/payload/index.ts"],"sourcesContent":["/**\n * `payload-live-preview/payload` — helpers for `payload.config.ts`. It never\n * imports `payload`, only produces the callback `admin.livePreview.url` expects.\n */\n\n/** Arguments Payload passes to `admin.livePreview.url`. */\nexport interface LivePreviewUrlArgs {\n  readonly data: Record<string, unknown>;\n  readonly locale?: string | { readonly code: string };\n  readonly collectionConfig?: { readonly slug: string };\n  readonly globalConfig?: { readonly slug: string };\n  readonly [extra: string]: unknown;\n}\n\n/** Context handed to per-slug path resolvers. */\nexport interface PathResolverContext {\n  readonly data: Record<string, unknown>;\n  /** Normalised locale code, or `undefined`. */\n  readonly locale: string | undefined;\n}\n\nexport type PathResolver = string | ((context: PathResolverContext) => string);\n\n/** A resolver that may decline a document: `null` means no preview target; `''` falls back. */\nexport type NullablePathResolver =\n  string | null | ((context: PathResolverContext) => string | null);\n\nexport interface BuildLivePreviewUrlOptions {\n  /** Frontend origin, e.g. `https://site.example`. */\n  readonly baseUrl: string;\n  /** Per-collection path resolvers keyed by collection slug. */\n  readonly collections?: Readonly<Record<string, PathResolver>>;\n  /** Per-global path resolvers keyed by global slug. */\n  readonly globals?: Readonly<Record<string, PathResolver>>;\n  /** Path when no resolver matches or one returns `''` (a draft without a slug). Default `/`. */\n  readonly fallback?: string;\n  /** Query parameter signalling preview intent; client-controlled, so it authorizes nothing. Default `'preview'`, `null` disables it. */\n  readonly previewParam?: string | null;\n}\n\n/**\n * Like {@link BuildLivePreviewUrlOptions} with nullable resolvers: the callback\n * may return `null`, and no iframe beats one pointing at a public page.\n */\nexport interface BuildLivePreviewUrlNullableOptions {\n  readonly baseUrl: string;\n  readonly collections?: Readonly<Record<string, NullablePathResolver>>;\n  readonly globals?: Readonly<Record<string, NullablePathResolver>>;\n  /** `null` declines every unmapped document. Default `/`. */\n  readonly fallback?: string | null;\n  /** See {@link BuildLivePreviewUrlOptions.previewParam}. */\n  readonly previewParam?: string | null;\n}\n\n/** Build an `admin.livePreview.url` callback from slug → path mappings. */\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlOptions,\n): (args: LivePreviewUrlArgs) => string;\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlNullableOptions,\n): (args: LivePreviewUrlArgs) => string | null;\nexport function buildLivePreviewUrl(\n  options: BuildLivePreviewUrlNullableOptions,\n): (args: LivePreviewUrlArgs) => string | null {\n  const base = options.baseUrl.replace(/\\/+$/, '');\n  // `??` would swallow an explicit `null`, which is the whole point of the nullable form.\n  const fallback = options.fallback === undefined ? '/' : options.fallback;\n  const previewParam = options.previewParam === undefined ? 'preview' : options.previewParam;\n\n  return (args) => {\n    const locale = normaliseLocale(args.locale);\n    const context: PathResolverContext = { data: args.data, locale };\n    const entry = findResolver(options, args);\n\n    let path: string | null = fallback;\n    if (entry !== undefined) {\n      const resolved = typeof entry === 'function' ? entry(context) : entry;\n      if (resolved === null) return null;\n      if (resolved.length > 0) path = resolved;\n    }\n    if (path === null) return null;\n    if (!path.startsWith('/')) path = `/${path}`;\n    return `${base}${previewParam === null ? path : withPreviewParam(path, previewParam)}`;\n  };\n}\n\n/** `path` with `<name>=true` in its query — ahead of any `#fragment`, and not twice. */\nfunction withPreviewParam(path: string, name: string): string {\n  const hashAt = path.indexOf('#');\n  const hash = hashAt === -1 ? '' : path.slice(hashAt);\n  const beforeHash = hashAt === -1 ? path : path.slice(0, hashAt);\n  const queryAt = beforeHash.indexOf('?');\n  const query = queryAt === -1 ? '' : beforeHash.slice(queryAt + 1);\n  if (new URLSearchParams(query).get(name) === 'true') return path;\n  const separator = queryAt === -1 ? '?' : query.length === 0 || query.endsWith('&') ? '' : '&';\n  return `${beforeHash}${separator}${name}=true${hash}`;\n}\n\n/** The mapped resolver, or `undefined` when the slug is not mapped; a mapped `null` is a resolver in its own right. */\nfunction findResolver(\n  options: BuildLivePreviewUrlNullableOptions,\n  args: LivePreviewUrlArgs,\n): NullablePathResolver | undefined {\n  const collectionSlug = args.collectionConfig?.slug;\n  if (\n    collectionSlug !== undefined &&\n    options.collections !== undefined &&\n    Object.hasOwn(options.collections, collectionSlug)\n  ) {\n    return options.collections[collectionSlug];\n  }\n  const globalSlug = args.globalConfig?.slug;\n  if (\n    globalSlug !== undefined &&\n    options.globals !== undefined &&\n    Object.hasOwn(options.globals, globalSlug)\n  ) {\n    return options.globals[globalSlug];\n  }\n  return undefined;\n}\n\nfunction normaliseLocale(locale: LivePreviewUrlArgs['locale']): string | undefined {\n  if (locale === undefined) return undefined;\n  if (typeof locale === 'string') return locale.length > 0 ? locale : undefined;\n  return locale.code.length > 0 ? locale.code : undefined;\n}\n"],"mappings":"AA6DO,SAASA,EACdC,GAEA,MAAMC,EAAOD,EAAQE,QAAQC,QAAQ,OAAQ,IAEvCC,OAAgC,IAArBJ,EAAQI,SAAyB,IAAMJ,EAAQI,SAC1DC,OAAwC,IAAzBL,EAAQK,aAA6B,UAAYL,EAAQK,aAE9E,OAAQC,IACN,MAAMC,EAoDV,SAAyBA,GACvB,YAAe,IAAXA,OAAsB,EACJ,iBAAXA,EAA4BA,EAAOC,OAAS,EAAID,OAAS,EAC7DA,EAAOE,KAAKD,OAAS,EAAID,EAAOE,UAAO,CAChD,CAxDmBC,CAAgBJ,EAAKC,QAC9BI,EAA+B,CAAEC,KAAMN,EAAKM,KAAML,UAClDM,EA2BV,SACEb,EACAM,GAEA,MAAMQ,EAAiBR,EAAKS,kBAAkBC,KAC9C,QACqB,IAAnBF,QACwB,IAAxBd,EAAQiB,aACRC,OAAOC,OAAOnB,EAAQiB,YAAaH,GAEnC,OAAOd,EAAQiB,YAAYH,GAE7B,MAAMM,EAAad,EAAKe,cAAcL,KACtC,YACiB,IAAfI,QACoB,IAApBpB,EAAQsB,SACRJ,OAAOC,OAAOnB,EAAQsB,QAASF,GAExBpB,EAAQsB,QAAQF,QALzB,CAQF,CAhDkBG,CAAavB,EAASM,GAEpC,IAAIkB,EAAsBpB,EAC1B,QAAc,IAAVS,EAAqB,CACvB,MAAMY,EAA4B,mBAAVZ,EAAuBA,EAAMF,GAAWE,EAChE,GAAiB,OAAbY,EAAmB,OAAO,KAC1BA,EAASjB,OAAS,IAAGgB,EAAOC,EAClC,CACA,OAAa,OAATD,EAAsB,MACrBA,EAAKE,WAAW,OAAMF,EAAO,IAAIA,KAC/B,GAAGvB,IAAwB,OAAjBI,EAAwBmB,EAK7C,SAA0BA,EAAcG,GACtC,MAAMC,EAASJ,EAAKK,QAAQ,KACtBC,GAAkB,IAAXF,EAAgB,GAAKJ,EAAKO,MAAMH,GACvCI,GAAwB,IAAXJ,EAAgBJ,EAAOA,EAAKO,MAAM,EAAGH,GAClDK,EAAUD,EAAWH,QAAQ,KAC7BK,GAAoB,IAAZD,EAAiB,GAAKD,EAAWD,MAAME,EAAU,GAC/D,GAA6C,SAAzC,IAAIE,gBAAgBD,GAAOE,IAAIT,GAAkB,OAAOH,EAE5D,MAAO,GAAGQ,KADoB,IAAZC,EAAiB,IAAuB,IAAjBC,EAAM1B,QAAgB0B,EAAMG,SAAS,KAAO,GAAK,MACvDV,SAAYG,GACjD,CAdoDQ,CAAiBd,EAAMnB,MAE3E,Q","ignoreList":[]}

package/dist/plugins.cjs

@@ -0,0 +1,2 @@
+"use strict";function e(e){return("object"==typeof e&&null!==e||"function"==typeof e)&&"function"==typeof e.then&&(Promise.resolve(e).catch(()=>{}),!0)}function t(t){return(...n)=>{try{e(t(...n))}catch{}}}var n=t((...e)=>console.error(...e)),i=()=>{},s=class{#e;#t;#n=/* @__PURE__ */new Set;#i="staging";constructor(e,t){this.#e=e,this.#t=t}assertOpen(){if("closed"===this.#i)throw new Error(`Plugin context for "${this.#e}" is no longer active`)}get active(){return"active"===this.#i}eligible(){return"closed"!==this.#i}own(e){return this.assertOpen(),this.#s({kind:"cleanup",acquire:void 0,finalize:void 0,cleanup:e,disposed:!1})}stage(e,t,n){this.assertOpen();const i={kind:e,acquire:t,finalize:n,cleanup:void 0,disposed:!1},s=this.#s(i);if("active"===this.#i)try{this.#r(i)}catch(e){throw this.#o(i),e}return s}counts(){const e={transform:0,renderer:0,subscription:0,cleanup:0};for(const t of this.#n)e[t.kind]+=1;return e}commit(){if("staging"!==this.#i)throw new Error(`Plugin context for "${this.#e}" cannot be committed`);this.#i="committing";try{for(const e of this.#n)this.#r(e);this.#i="active"}catch(e){throw this.close(),e}}close(){if("closed"!==this.#i){this.#i="closed";for(const e of[...this.#n].reverse())this.#o(e);this.#n.clear()}}#s(e){return this.#n.add(e),()=>{this.#o(e)}}#r(e){if(e.disposed||void 0!==e.cleanup||void 0===e.acquire)return;const t=e.acquire();e.cleanup=t??i}#o(t){if(t.disposed)return;t.disposed=!0,this.#n.delete(t);const n=t.cleanup;if(t.cleanup=void 0,void 0!==n)try{e(n())&&this.#t(`plugin "${this.#e}" cleanup returned a Promise/thenable; cleanups must be synchronous`)}catch(e){this.#t(`plugin "${this.#e}" cleanup failed:`,e)}try{t.finalize?.()}catch(e){this.#t(`plugin "${this.#e}" cleanup failed:`,e)}}},r=class{#a;#l;#c=/* @__PURE__ */new Set;constructor(e,t){this.#a=e,this.#l=t}on(e,t){return this.#u("on",e,t)}once(e,t){return this.#u("once",e,t)}off(e,t){const n=t;for(const t of[...this.#c])t.event===e&&t.handler===n&&t.dispose()}emit(e,t){return this.#l.assertOpen(),this.#a.emit(e,t)}emitWhile(e,t,n){return this.#l.assertOpen(),this.#a.emitWhile(e,t,()=>{if(!this.#l.eligible())return!1;const e=n();return!!this.#l.eligible()&&e})}listenerCount(e){let t=0;for(const n of this.#c)n.event===e&&(t+=1);return t}removeAllListeners(e){for(const t of[...this.#c])void 0!==e&&t.event!==e||t.dispose()}eventNames(){const e=/* @__PURE__ */new Set;for(const t of this.#c)e.add(t.event);return[...e]}#u(e,t,n){this.#l.assertOpen();const s=n,r=[...this.#c].find(n=>n.kind===e&&n.event===t&&n.handler===s);if(void 0!==r)return r.dispose;let o=i,a=!0;const l=async t=>{this.#l.active&&a&&("once"===e&&o(),await n(t))},c={kind:e,event:t,handler:s,dispose:i};return o=this.#l.stage("subscription",()=>this.#a[e](t,l),()=>{a=!1,this.#c.delete(c)}),c.dispose=o,this.#c.add(c),o}},o="payload-live-preview-highlight",a=/* @__PURE__ */new WeakMap,l=/* @__PURE__ */new WeakMap,c={name:"highlight",version:"1.0.0",init:e=>{if("undefined"==typeof document||"undefined"==typeof window)return;const t="function"==typeof window.matchMedia&&window.matchMedia("(prefers-reduced-motion: reduce)").matches,n=function(e,t){let n=a.get(e);void 0===n||n.connected()||(a.delete(e),n=void 0),void 0===n&&(n=function(e,t){const n=e.getElementById(o);if(n instanceof HTMLStyleElement)return{pluginOwned:!1,connected:()=>n.isConnected,remove:()=>{},owners:0};const i=function(e,t){try{if(!Array.isArray(e.adoptedStyleSheets)||"function"!=typeof CSSStyleSheet)return;const n=new CSSStyleSheet;if("function"!=typeof n.replaceSync)return;return n.replaceSync(t),e.adoptedStyleSheets=[...e.adoptedStyleSheets,n],n}catch{return}}(e,t);if(void 0!==i)return{pluginOwned:!0,connected:()=>e.adoptedStyleSheets.includes(i),remove:()=>{e.adoptedStyleSheets=e.adoptedStyleSheets.filter(e=>e!==i)},owners:0};const s=e.createElement("style");return s.id=o,s.textContent=t,e.head.appendChild(s),{pluginOwned:!0,connected:()=>s.isConnected,remove:()=>{s.remove()},owners:0}}(e,t?".lp-highlight{outline:2px solid rgba(0,102,204,0.85);outline-offset:2px;}":"@keyframes lp-highlight{0%{outline:2px solid rgba(0,102,204,0.85);outline-offset:2px}100%{outline:2px solid transparent;outline-offset:2px}}.lp-highlight{animation:lp-highlight 0.6s ease-out;}"),a.set(e,n));const i=n;i.owners+=1;let s=!0;return()=>{s&&(s=!1,i.owners-=1,i.owners>0||(a.get(e)===i&&a.delete(e),i.pluginOwned&&i.remove()))}}(document,t),i=t?1e3:600,s=/* @__PURE__ */new WeakMap,r=/* @__PURE__ */new Set;e.registerCleanup?.(()=>{for(const e of[...r])e();n()}),e.events.on("elementUpdate",e=>{const t=e.element;s.get(t)?.();const n=function(e){let t=l.get(e);void 0===t&&(t={owners:0,pluginAdded:!e.classList.contains("lp-highlight")},l.set(e,t));const n=t;n.owners+=1,e.classList.add("lp-highlight");let i=!0;return()=>{i&&(i=!1,n.owners-=1,n.owners>0||(l.delete(e),n.pluginAdded&&e.classList.remove("lp-highlight")))}}(t);let o=!1;const a=()=>{o||(o=!0,window.clearTimeout(c),s.get(t)===a&&s.delete(t),r.delete(a),n())},c=window.setTimeout(a,i);r.add(a),s.set(t,a)})}},u={name:"debug",version:"1.0.0",init:e=>{e.events.on("init",()=>{e.log("init")}),e.events.on("connect",t=>{e.log("connect ←",t.origin)}),e.events.on("disconnect",t=>{e.log("disconnect (",t.reason,")")}),e.events.on("cacheRefresh",t=>{e.log("cacheRefresh",t.elementCount,"elements,",t.fieldCount,"fields")}),e.events.on("beforeUpdate",t=>{e.log("beforeUpdate",Object.keys(t.data.fields).length,"fields")}),e.events.on("afterUpdate",t=>{e.log("afterUpdate",t.updatedCount,"in",t.durationMs.toFixed(2),"ms")}),e.events.on("error",t=>{e.log("error in",t.context,":",t.error.message)})}},d="payload-live-preview:scroll";function h(){"undefined"!=typeof window&&(function(){if("undefined"!=typeof window)try{sessionStorage.setItem(d,JSON.stringify({href:window.location.href,x:window.scrollX,y:window.scrollY}))}catch{}}(),window.location.reload())}var f=Object.freeze({NoTrustedOrigin:"LP0101",ReferrerOnlyTrust:"LP0102",PluginIncompatible:"LP0103",OrphanField:"LP0201",UnattributableUpdate:"LP0202",VisibilityGateDeferred:"LP0301",UnsafeAttributeWrite:"LP0401",TextTargetHasChildren:"LP0402",MissingArrayTemplate:"LP0403",StructuralItemUnkeyed:"LP0404",StructuralDuplicateKey:"LP0405",StructuralUnstableKeys:"LP0406",UnsupportedStrategy:"LP0407",MessageRejected:"LP0501",TokenRejected:"LP0502",HandlerThrew:"LP0601",TransformThrew:"LP0602",RendererThrew:"LP0603",StartupFailed:"LP0605",ReadyFailed:"LP0606",AuditRuntimeMissing:"LP0701",AuditNoFrameAncestors:"LP0702",AuditFrameOptionsBlocks:"LP0703",AuditBindingsExposed:"LP0704",AuditGateThresholdExceeded:"LP0705",AuditUnownedBindings:"LP0706",AuditNoBindings:"LP0707",AuditNotAPage:"LP0708",FragmentRequestFailed:"LP0801",FragmentResponseInvalid:"LP0802",FragmentUnauthorized:"LP0803",FragmentSuperseded:"LP0804",RouteRefreshLoop:"LP0805",FragmentStrategyUnavailable:"LP0806",V2ReadinessGap:"LP0709",RuntimeOnPublicPage:"LP0710"});exports.DIAGNOSTIC_CODES=f,exports.EventEmitter=class{#d=/* @__PURE__ */new Map;#h=/* @__PURE__ */new Map;on(e,t){return this.#f(this.#d,e,t)}once(e,t){return this.#f(this.#h,e,t)}off(e,t){this.#g(this.#d,e,t),this.#g(this.#h,e,t)}async emit(e,t){await this.#p(e,t)}async emitWhile(e,t,n){return this.#p(e,t,n)}async#p(e,t,n){const i=()=>n?.()??!0;if(!i())return!1;const s=this.#d.get(e);if(s)for(const n of[...s]){if(!i())return!1;if(await this.#m(n,t,e),!i())return!1}if(!i())return!1;const r=this.#h.get(e);if(r&&r.size>0){const n=[...r];this.#h.delete(e);for(const s of n){if(!i())return!1;if(await this.#m(s,t,e),!i())return!1}}return i()}listenerCount(e){return(this.#d.get(e)?.size??0)+(this.#h.get(e)?.size??0)}removeAllListeners(e){if(void 0===e)return this.#d.clear(),void this.#h.clear();this.#d.delete(e),this.#h.delete(e)}eventNames(){const e=/* @__PURE__ */new Set;for(const t of this.#d.keys())e.add(t);for(const t of this.#h.keys())e.add(t);return[...e]}#f(e,t,n){let i=e.get(t);return i||(i=/* @__PURE__ */new Set,e.set(t,i)),i.add(n),()=>{this.#g(e,t,n)}}#g(e,t,n){const i=e.get(t);void 0!==i&&(i.delete(n),0===i.size&&e.delete(t))}async#m(e,t,i){try{await e(t)}catch(e){const t="string"==typeof i||"number"==typeof i?String(i):"<event>";n(`[live-preview] LP0601: handler for "${t}" threw:`,e)}}},exports.PluginManager=class{#a;#v;#w;#y;#t;#b=/* @__PURE__ */new Map;#P=/* @__PURE__ */new Map;#S=/* @__PURE__ */new Map;#L=/* @__PURE__ */new Set;#k=/* @__PURE__ */new Map;#N=Promise.resolve();#x=0;constructor(e){this.#a=e.events,this.#v=e.config,this.#w=e.registerFieldRenderer,this.#t=t(e.log);const n=e.onTransformError;this.#y=void 0===n?void 0:t((...e)=>{const t=e[0];try{return n(t)}catch(e){return void this.#t("transform error reporter failed:",e)}})}register(e){return this.#x>0?this.#T(e,!1):this.#A(()=>this.#T(e,!0))}unregister(e){return this.#x>0?this.#C(e,!1):this.#A(async()=>{await this.#C(e,!0)})}destroyAll(){return this.#x>0?this.#O(!1):this.#A(async()=>{await this.#O(!0)})}applyTransforms(t,n,i,s){const r=this.#k.get(t);if(void 0===r||0===r.length)return n;let o=n;for(const a of[...r]){if(!a.active)continue;const{transform:r}=a;if(!1===s?.())return n;try{o=r(o,{fieldName:t,element:i.element,allFields:i.allFields});const a=e(o);if(!1===s?.())return n;if(a)throw new TypeError(`Transform for "${t}" returned a Promise/thenable; transforms must be synchronous`)}catch(e){if(!1===s?.())return n;const i=e instanceof Error?e:new Error(String(e));return this.#t(`transform for "${t}" failed:`,i),this.#y?.(i),n}}return o}list(){return[...this.#b.keys()]}snapshot(){const e=[],t=(e,t,n,i)=>{const s=i.counts();return{name:e,version:t,state:n,registrations:{transforms:s.transform,renderers:s.renderer,subscriptions:s.subscription,cleanups:s.cleanup}}};for(const[n,i]of this.#P)e.push(t(n,void 0,"initializing",i.scope));for(const[n,i]of this.#b)e.push(t(n,i.plugin.version,"active",i.scope));for(const t of this.#S.keys())e.push({name:t,version:void 0,state:"tearing-down",registrations:{transforms:0,renderers:0,subscriptions:0,cleanups:0}});return e}get size(){return this.#b.size}async#T(e,t){if(this.#b.has(e.name)||this.#P.has(e.name)||this.#S.has(e.name))return void this.#t(`plugin "${e.name}" already registered`);const n=function(e,t){if(void 0!==e){if(void 0!==e.runtime&&!function(e,t){const n=function(e){const t=/^v?(\d+)\.(\d+)\.(\d+)/.exec(e.trim());if(null!==t)return[Number(t[1]),Number(t[2]),Number(t[3])]}(e);return void 0!==n&&t.split("||").some(e=>{const i=e.trim().split(/\s+/).filter(e=>e.length>0);return 0===i.length?""===e.trim()&&""===t.trim():i.every(e=>function(e,t){const n=t.trim();if(""===n||"*"===n)return!0;const i=/^(\^|~|>=|<=|>|<|=)?\s*v?(\d+)\.(\d+)\.(\d+)/.exec(n);if(null===i)return!1;const s=i[1]??"=",r=[Number(i[2]),Number(i[3]),Number(i[4])],o=function(e,t){for(let n=0;n<3;n+=1){const i=(e[n]??0)-(t[n]??0);if(0!==i)return i}return 0}(e,r);switch(s){case"=":return 0===o;case">":return o>0;case">=":return o>=0;case"<":return o<0;case"<=":return o<=0;case"~":return o>=0&&e[0]===r[0]&&e[1]===r[1];case"^":return!(o<0)&&(r[0]>0?e[0]===r[0]:r[1]>0?0===e[0]&&e[1]===r[1]:0===e[0]&&0===e[1]&&e[2]===r[2]);default:return!1}}(n,e))})}(t,e.runtime))return`declares runtime ${e.runtime}, this runtime is ${t}`;if(void 0!==e.protocol){if(!Number.isInteger(e.protocol)||e.protocol<1)return`declares an invalid protocol version ${String(e.protocol)}`;if(e.protocol<4)return`declares protocol ${String(e.protocol)}, this runtime speaks ${String(4)}`}}}(e.compat,"2.0.0-beta.0");if(void 0!==n)return void this.#z(e.name,n);const i=new s(e.name,this.#t),r=this.#M(e.name,i),o={scope:i,cancelled:!1};this.#P.set(e.name,o);try{if(await this.#R(()=>e.init(r),t),o.cancelled)return;i.commit()}catch(t){return i.close(),void(o.cancelled||this.#t(`plugin "${e.name}" init failed:`,t))}finally{this.#P.get(e.name)===o&&this.#P.delete(e.name)}this.#b.set(e.name,{plugin:e,scope:i}),this.#t(`plugin "${e.name}" registered`)}#z(e,t){const n=`plugin "${e}" refused: ${t}`;this.#t(n),this.#a.emit("error",{error:new Error(n),context:"plugin",code:"LP0103"})}#M(e,t){return{events:new r(this.#a,t),registerFieldRenderer:e=>{t.stage("renderer",()=>{const t=this.#w(e);return"function"==typeof t?t:void 0})},registerTransform:(e,n)=>{const i={transform:n,active:!1};t.stage("transform",()=>{i.active=!0;const t=this.#k.get(e);return void 0===t?this.#k.set(e,[i]):t.push(i),()=>{i.active=!1;const t=this.#k.get(e);if(void 0===t)return;const n=t.indexOf(i);n>=0&&t.splice(n,1),0===t.length&&this.#k.delete(e)}})},registerCleanup:e=>{t.own(e)},getConfig:()=>this.#v,log:(...t)=>{this.#t(`[${e}]`,...t)}}}#C(e,t){const n=this.#P.get(e);if(void 0!==n)return n.cancelled=!0,n.scope.close(),Promise.resolve();const i=this.#S.get(e);if(void 0!==i)return this.#L.has(e)?Promise.resolve():t?this.#$(i):i;const s=this.#b.get(e);if(void 0===s)return Promise.resolve();this.#b.delete(e),s.scope.close();const r=Promise.resolve().then(()=>this.#E(e,s.plugin,t));return this.#S.set(e,r),r.then(()=>{this.#S.get(e)===r&&this.#S.delete(e)}),r}async#E(e,t,n){if(void 0!==t.destroy){this.#L.add(e);try{await this.#R(()=>t.destroy?.(),n)}catch(t){this.#t(`plugin "${e}" destroy failed:`,t)}finally{this.#L.delete(e)}}}async#O(e){for(const e of this.#P.values())e.cancelled=!0,e.scope.close();const t=[...this.#b.keys()];for(const n of t)await this.#C(n,e)}async#R(e,t){t?await this.#$(Promise.resolve().then(e)):await e()}async#$(e){this.#x+=1;try{await e}finally{this.#x-=1}}#A(e){const t=this.#N.then(e);return this.#N=t.catch(e=>{this.#t("plugin manager mutation failed:",e)}),t}},exports.createAnalyticsPlugin=function(){let e=0,t=0,n=0;return{name:"analytics",version:"1.0.0",init:i=>{i.events.on("afterUpdate",i=>{e+=1,t+=i.updatedCount,n+=i.durationMs})},getStats:()=>({updateCount:e,totalElements:t,totalDurationMs:n,averageDurationMs:0===e?0:n/e})}},exports.debugPlugin=u,exports.documentSavePlugin=function(e={}){const t=e.strategy??"silent";return{name:"document-save",version:"1.1.0",init:n=>{let i=!0;const s=/* @__PURE__ */new Set;n.registerCleanup?.(()=>{i=!1;for(const e of s)e.abort();s.clear()}),function(){if("undefined"!=typeof window)try{const e=sessionStorage.getItem(d);if(null===e)return;sessionStorage.removeItem(d);const t=JSON.parse(e);if(t.href!==window.location.href)return;window.scrollTo(t.x??0,t.y??0)}catch{}}(),n.events.on("documentSave",()=>{if(!i)return;if("silent"===t)return;if("reload"===t)return void h();const r=new AbortController;s.add(r);const o="fetch"===t?async function(e,t,n){if(e.handler)try{await e.handler(n)}catch(e){if(!i||n.aborted)return;t("document-save handler threw:",e)}else t("document-save: fetch strategy selected but no handler supplied")}(e,n.log,r.signal):async function(e,t,n,i){if("undefined"==typeof fetch)return void t("document-save: revalidate strategy needs fetch — not available");const s=e.revalidateUrl??"/api/revalidate";let r=!1;try{const o=await fetch(s,{method:"POST",signal:n,headers:{"Content-Type":"application/json",...e.revalidateHeaders??{}},body:JSON.stringify({source:"payload-live-preview"})});if(!i()||n.aborted)return;r=o.ok,r||t("document-save revalidate non-2xx:",o.status)}catch(e){if(!i()||n.aborted)return;t("document-save revalidate failed:",e)}r||"reload"!==e.onRevalidateFailure||h()}(e,n.log,r.signal,()=>i);o.finally(()=>{s.delete(r)})})}}},exports.highlightPlugin=c;
+//# sourceMappingURL=plugins.cjs.map