@decocms/nextjs 8.5.2 → 8.7.0

package/dist/server/index.d.ts

@@ -2,45 +2,84 @@
  * `@decocms/nextjs/server`: draft previews in Server Components (pages,
  * layouts, route handlers). Server only: it reads `next/headers`.
  *
- * A page (and, through the `x-deco-draft` header the proxy forwards, the root
- * layout) binds the request's draft before it reads content, then reads
- * through `contentClient(cms)`:
+ * The proxy decides what a request reads (`@decocms/nextjs/proxy`): the
+ * version, the visitor, and each test and campaign on or off, forwarded on
+ * `x-deco-version`, `x-deco-visitor` and `x-deco-assignments`. A page (and,
+ * through those headers, the root layout) binds them before it reads
+ * content, then reads through `contentClient(cms)`, which builds
+ * `cms.client({ version, experiments, campaigns })` and decides nothing
+ * again:
  *
  * ```tsx
  * export default async function Page({ searchParams }) {
- *   await bindDraft(cms, { searchParams: await searchParams, site: "my-store" });
+ *   await bindDraft(cms, { searchParams: await searchParams });
  *   const client = contentClient(cms);
  *   …
  *   return <>{sections}<DraftPreviewIndicator /></>;
  * }
  * ```
  *
- * The host check is the proxy's (`decideDraft`), repeated here with the same
- * options, so a route the proxy doesn't match, or a forged `x-deco-draft`,
- * still gets the release on a host that may not preview.
+ * The host check is the proxy's (`decideDraft`), repeated here against the
+ * same CMS, so a route the proxy doesn't match, or a forged `x-deco-version`,
+ * still gets the release on a host that may not preview. On the release, a
+ * test at 0% stays off whatever `x-deco-assignments` says.
  */
 import type { Client, CMS } from "@decocms/blocks";
-import { type PreviewPolicy } from "../drafts.ts";
 import { activeDraftPointer } from "./slot.ts";
-export { type PreviewPolicy, requestLike } from "../drafts.ts";
+export { ASSIGNMENTS_ROUTE_PREFIX, assignmentsSegment, type PathAssignments, parseAssignmentsSegment, } from "../assignments.ts";
+export { requestLike } from "../drafts.ts";
 export { activeDraftPointer };
 /** A page's `searchParams` prop, awaited. */
 export type SearchParams = Record<string, string | string[] | undefined>;
-export interface BindDraftOptions extends PreviewPolicy {
-    /** The page's own `searchParams` (a layout has none: it reads the proxy's `x-deco-draft`). */
+export interface BindDraftOptions {
+    /** The page's own `searchParams` (a layout has none: it reads the proxy's `x-deco-version`). */
     searchParams?: SearchParams;
 }
+type BindCMS = Pick<CMS, "readVersion" | "forRelease" | "checkRelease">;
 /**
- * Binds the request's draft, if any: the page's own `?__draft=` first (`off`
- * leaves preview), then the pointer the proxy forwarded on `x-deco-draft`,
- * then the draft cookie, each on a host the options allow. Returns whether a
- * draft was bound. With previews off on every host it returns `false`
- * without reading the request, so a static page stays static.
+ * Binds what the request reads: the version, if any (the page's own
+ * `?__draft=` first, `off` leaving preview, then the version the proxy
+ * forwarded on `x-deco-version`, then the draft cookie, each on a host the
+ * CMS allows), and what the proxy decided (`x-deco-assignments`) and the
+ * visitor it read (`x-deco-visitor`). Returns whether a version was bound:
+ * a draft, or a published release's commit SHA (Studio's "Preview this
+ * version"). It reads the request's headers, so it belongs on the draft
+ * route; a cached (ISR) page reads what its path names (`assignedClient`).
  */
-export declare function bindDraft(cms: Pick<CMS, "draftPointer" | "settings" | "forRelease">, options?: BindDraftOptions): Promise<boolean>;
+export declare function bindDraft(cms: BindCMS, options?: BindDraftOptions): Promise<boolean>;
 /**
- * The content client for this request: the draft `bindDraft` bound, or the
- * release.
+ * The content client for this request, from what `bindDraft` bound:
+ * `cms.client({ version, experiments, campaigns })` with the tests and
+ * campaigns the proxy decided, deciding nothing again. On a route the proxy
+ * didn't decide for, the visitor and the preview's moment and switched tests
+ * and campaigns decide instead. Create one per request.
  */
-export declare function contentClient(cms: Pick<CMS, "forDraft" | "forRelease">): Client;
+export declare function contentClient(cms: Pick<CMS, "client">): Client;
+/**
+ * The content client of a page on the assignments route
+ * (`app/%5Fassignments/[assignments]/[[...path]]`, which the proxy's
+ * `rewriteToAssignmentsRoute` rewrites the CMS's pages to): the current
+ * release, read as `cms.client({ experiments, campaigns })` with every test
+ * and campaign the path's segment names on or off as the proxy decided, and
+ * no visitor. The proxy decides, the page renders that, reading no request,
+ * so Next can cache it (ISR, `revalidate = 600`). A test at 0% stays off
+ * whatever the path names, and a test or a campaign the content doesn't have
+ * stays out, never an error: a 404 here would be cached under the path by
+ * Next. `null` only when the segment isn't one the proxy writes: the page
+ * answers with `notFound()`.
+ *
+ * ```tsx
+ * export const revalidate = 600;
+ * export async function generateStaticParams() {
+ *   return [];
+ * }
+ * export default async function Page({ params }) {
+ *   const { assignments, path } = await params;
+ *   const client = await assignedClient(cms, assignments);
+ *   if (!client) notFound();
+ *   …
+ * }
+ * ```
+ */
+export declare function assignedClient(cms: Pick<CMS, "client" | "forRelease">, segment: string): Promise<Client | null>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAuC,KAAK,aAAa,EAAe,MAAM,cAAc,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAa,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,KAAK,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,6CAA6C;AAC7C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEzE,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,8FAA8F;IAC9F,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAOD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC,EAC1D,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,MAAM,CAG/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAiBlE,OAAO,EAAE,kBAAkB,EAAa,MAAM,WAAW,CAAC;AAE1D,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,KAAK,eAAe,EACpB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,6CAA6C;AAC7C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,KAAK,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,cAAc,CAAC,CAAC;AAOxE;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9F;AAkED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,MAAM,CAU9D;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKxB"}

package/dist/server/index.js

@@ -2,27 +2,36 @@
  * `@decocms/nextjs/server`: draft previews in Server Components (pages,
  * layouts, route handlers). Server only: it reads `next/headers`.
  *
- * A page (and, through the `x-deco-draft` header the proxy forwards, the root
- * layout) binds the request's draft before it reads content, then reads
- * through `contentClient(cms)`:
+ * The proxy decides what a request reads (`@decocms/nextjs/proxy`): the
+ * version, the visitor, and each test and campaign on or off, forwarded on
+ * `x-deco-version`, `x-deco-visitor` and `x-deco-assignments`. A page (and,
+ * through those headers, the root layout) binds them before it reads
+ * content, then reads through `contentClient(cms)`, which builds
+ * `cms.client({ version, experiments, campaigns })` and decides nothing
+ * again:
  *
  * ```tsx
  * export default async function Page({ searchParams }) {
- *   await bindDraft(cms, { searchParams: await searchParams, site: "my-store" });
+ *   await bindDraft(cms, { searchParams: await searchParams });
  *   const client = contentClient(cms);
  *   …
  *   return <>{sections}<DraftPreviewIndicator /></>;
  * }
  * ```
  *
- * The host check is the proxy's (`decideDraft`), repeated here with the same
- * options, so a route the proxy doesn't match, or a forged `x-deco-draft`,
- * still gets the release on a host that may not preview.
+ * The host check is the proxy's (`decideDraft`), repeated here against the
+ * same CMS, so a route the proxy doesn't match, or a forged `x-deco-version`,
+ * still gets the release on a host that may not preview. On the release, a
+ * test at 0% stays off whatever `x-deco-assignments` says.
  */
+import { parseVisitor } from "@decocms/blocks/experiments";
 import { headers } from "next/headers.js";
-import { DRAFT_HEADER, DRAFT_PARAM } from "../draft.js";
-import { allowedDraft, isDraftPreviewEnabled, requestLike } from "../drafts.js";
+import { ASSIGNMENTS_HEADER, parseAssignmentsSegment, withoutDarkTests, } from "../assignments.js";
+import { DRAFT_PARAM, DRAFT_UNAVAILABLE_HEADER, RELEASE_CHECK_HEADER, VERSION_HEADER, } from "../draft.js";
+import { allowedDraft, draftReleaseCheck, requestLike } from "../drafts.js";
+import { VISITOR_HEADER } from "../visitor.js";
 import { activeDraftPointer, draftSlot } from "./slot.js";
+export { ASSIGNMENTS_ROUTE_PREFIX, assignmentsSegment, parseAssignmentsSegment, } from "../assignments.js";
 export { requestLike } from "../drafts.js";
 export { activeDraftPointer };
 function firstParam(searchParams, key) {
@@ -30,35 +39,144 @@ function firstParam(searchParams, key) {
     return (Array.isArray(raw) ? raw[0] : raw) ?? null;
 }
 /**
- * Binds the request's draft, if any: the page's own `?__draft=` first (`off`
- * leaves preview), then the pointer the proxy forwarded on `x-deco-draft`,
- * then the draft cookie, each on a host the options allow. Returns whether a
- * draft was bound. With previews off on every host it returns `false`
- * without reading the request, so a static page stays static.
+ * Binds what the request reads: the version, if any (the page's own
+ * `?__draft=` first, `off` leaving preview, then the version the proxy
+ * forwarded on `x-deco-version`, then the draft cookie, each on a host the
+ * CMS allows), and what the proxy decided (`x-deco-assignments`) and the
+ * visitor it read (`x-deco-visitor`). Returns whether a version was bound:
+ * a draft, or a published release's commit SHA (Studio's "Preview this
+ * version"). It reads the request's headers, so it belongs on the draft
+ * route; a cached (ISR) page reads what its path names (`assignedClient`).
  */
 export async function bindDraft(cms, options = {}) {
-    const { searchParams, ...policy } = options;
-    if (!(await isDraftPreviewEnabled(cms, policy)))
-        return false;
+    if (await bindVersion(cms, options)) {
+        // A preview renders per request anyway, and may switch on a test at 0%.
+        await bindForwarded(cms, false);
+        return true;
+    }
+    if (await variesByVisitor(cms))
+        await bindForwarded(cms, true);
+    return false;
+}
+/** The visitor and the assignments the proxy forwarded, if any. */
+async function bindForwarded(cms, release) {
+    const requestHeaders = await headers();
+    const slot = draftSlot();
+    slot.visitor = parseVisitor(requestHeaders.get(VISITOR_HEADER));
+    const decided = parseAssignmentsSegment(requestHeaders.get(ASSIGNMENTS_HEADER) ?? "");
+    slot.assignments = decided && release ? await withoutDarkTests(cms, decided) : decided;
+}
+/**
+ * Whether the release saves an `experiments` block (the built-in
+ * `split-traffic`) or a `campaigns` block (the built-in `calendar`) with a
+ * name in it: only then does a page vary by what the proxy decided. Read from
+ * memory, unresolved; `false` when both are missing.
+ */
+async function variesByVisitor(cms) {
+    const saves = async (name, type) => {
+        try {
+            const [block] = await cms.forRelease().resolve(name, { run: false });
+            if (typeof block !== "object" || block === null)
+                return false;
+            const record = block;
+            return (record.__resolveType === type && Object.keys(record).some((key) => key !== "__resolveType"));
+        }
+        catch {
+            return false;
+        }
+    };
+    const [tests, campaigns] = await Promise.all([
+        saves("experiments", "split-traffic"),
+        saves("campaigns", "calendar"),
+    ]);
+    return tests || campaigns;
+}
+async function bindVersion(cms, options) {
+    const { searchParams } = options;
     const param = firstParam(searchParams, DRAFT_PARAM);
     if (param === "off")
         return false;
     const requestHeaders = await headers();
-    const forwarded = param ?? requestHeaders.get(DRAFT_HEADER);
+    // The proxy read the link's draft and it's gone: the release, with the notice.
+    if (requestHeaders.get(DRAFT_UNAVAILABLE_HEADER) === "1") {
+        draftSlot().unavailable = true;
+        return false;
+    }
+    const forwarded = param ?? requestHeaders.get(VERSION_HEADER);
     const query = forwarded ? `?${DRAFT_PARAM}=${encodeURIComponent(forwarded)}` : "";
     const request = requestLike(requestHeaders, `/${query}`);
-    const pointer = request ? await allowedDraft(cms, request, policy) : null;
-    if (pointer === null)
+    if (request === null)
         return false;
-    draftSlot().pointer = pointer;
+    // The proxy's release check for this request (`x-deco-release-check`), or one of its own:
+    // the host check here and the page's draft reads share it.
+    const releaseCheck = await draftReleaseCheck(cms, request, requestHeaders.get(RELEASE_CHECK_HEADER));
+    const version = await allowedDraft(cms, request, releaseCheck);
+    if (version === null)
+        return false;
+    const slot = draftSlot();
+    slot.version = version;
+    slot.releaseCheck = releaseCheck ?? null;
     return true;
 }
 /**
- * The content client for this request: the draft `bindDraft` bound, or the
- * release.
+ * The content client for this request, from what `bindDraft` bound:
+ * `cms.client({ version, experiments, campaigns })` with the tests and
+ * campaigns the proxy decided, deciding nothing again. On a route the proxy
+ * didn't decide for, the visitor and the preview's moment and switched tests
+ * and campaigns decide instead. Create one per request.
  */
 export function contentClient(cms) {
-    const pointer = activeDraftPointer();
-    return pointer ? cms.forDraft(pointer) : cms.forRelease();
+    const { version, visitor, assignments, releaseCheck } = draftSlot();
+    const options = { visitor, version: version?.version ?? null };
+    if (version !== null && releaseCheck !== null)
+        options.releaseCheck = releaseCheck;
+    if (version?.date !== undefined)
+        options.date = version.date;
+    const experiments = over(version?.experiments, assignments?.experiments);
+    const campaigns = over(version?.campaigns, assignments?.campaigns);
+    if (experiments !== undefined)
+        options.experiments = experiments;
+    if (campaigns !== undefined)
+        options.campaigns = campaigns;
+    return cms.client(options);
+}
+/** `decided` over `preview`, name by name; `undefined` when neither has any. */
+function over(preview, decided) {
+    if (preview === undefined && decided === undefined)
+        return undefined;
+    return { ...preview, ...decided };
+}
+/**
+ * The content client of a page on the assignments route
+ * (`app/%5Fassignments/[assignments]/[[...path]]`, which the proxy's
+ * `rewriteToAssignmentsRoute` rewrites the CMS's pages to): the current
+ * release, read as `cms.client({ experiments, campaigns })` with every test
+ * and campaign the path's segment names on or off as the proxy decided, and
+ * no visitor. The proxy decides, the page renders that, reading no request,
+ * so Next can cache it (ISR, `revalidate = 600`). A test at 0% stays off
+ * whatever the path names, and a test or a campaign the content doesn't have
+ * stays out, never an error: a 404 here would be cached under the path by
+ * Next. `null` only when the segment isn't one the proxy writes: the page
+ * answers with `notFound()`.
+ *
+ * ```tsx
+ * export const revalidate = 600;
+ * export async function generateStaticParams() {
+ *   return [];
+ * }
+ * export default async function Page({ params }) {
+ *   const { assignments, path } = await params;
+ *   const client = await assignedClient(cms, assignments);
+ *   if (!client) notFound();
+ *   …
+ * }
+ * ```
+ */
+export async function assignedClient(cms, segment) {
+    const parsed = parseAssignmentsSegment(segment);
+    if (parsed === null)
+        return null;
+    const assignments = await withoutDarkTests(cms, parsed);
+    return cms.client({ experiments: assignments.experiments, campaigns: assignments.campaigns });
 }
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAsB,WAAW,EAAE,MAAM,cAAc,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAsB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAU9B,SAAS,UAAU,CAAC,YAAsC,EAAE,GAAW;IACrE,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAA0D,EAC1D,OAAO,GAAqB,EAAE;IAE9B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAC5C,IAAI,CAAC,CAAC,MAAM,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,cAAc,GAAG,MAAM,OAAO,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,KAAK,IAAI,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,WAAW,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,MAAM,OAAO,GAAG,WAAW,CAAC,cAAyB,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACnC,SAAS,EAAE,CAAC,OAAO,GAAG,OAAO,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAyC;IACrE,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;AAC5D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAElB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAElB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAY9B,SAAS,UAAU,CAAC,YAAsC,EAAE,GAAW;IACrE,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACrD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAY,EAAE,OAAO,GAAqB,EAAE;IAC1E,IAAI,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;QACpC,wEAAwE;QACxE,MAAM,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,eAAe,CAAC,GAAG,CAAC;QAAE,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mEAAmE;AACnE,KAAK,UAAU,aAAa,CAAC,GAAY,EAAE,OAAgB;IACzD,MAAM,cAAc,GAAG,MAAM,OAAO,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,uBAAuB,CAAC,cAAc,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,IAAI,CAAC,WAAW,GAAG,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACzF,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAAC,GAA4B;IACzD,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAE,IAAY,EAAoB,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,OAAO,CAAU,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAC9D,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,OAAO,CACL,MAAM,CAAC,aAAa,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,eAAe,CAAC,CAC5F,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3C,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC;QACrC,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC;KAC/B,CAAC,CAAC;IACH,OAAO,KAAK,IAAI,SAAS,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,GAAY,EAAE,OAAyB;IAChE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,cAAc,GAAG,MAAM,OAAO,EAAE,CAAC;IACvC,+EAA+E;IAC/E,IAAI,cAAc,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,GAAG,EAAE,CAAC;QACzD,SAAS,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,IAAI,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,WAAW,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,MAAM,OAAO,GAAG,WAAW,CAAC,cAAyB,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACnC,0FAA0F;IAC1F,2DAA2D;IAC3D,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAC1C,GAAG,EACH,OAAO,EACP,cAAc,CAAC,GAAG,CAAC,oBAAoB,CAAC,CACzC,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAC/D,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAwB;IACpD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAAC;IACpE,MAAM,OAAO,GAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;IAC9E,IAAI,OAAO,KAAK,IAAI,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IACnF,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACnE,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;IACjE,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAC3D,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,SAAS,IAAI,CACX,OAAsD,EACtD,OAAsD;IAEtD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACrE,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAuC,EACvC,OAAe;IAEf,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,WAAW,GAAoB,MAAM,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;AAChG,CAAC"}

package/dist/server/slot.d.ts

@@ -1,6 +1,27 @@
-export declare const draftSlot: () => {
-    pointer: string | null;
-};
-/** The draft pointer bound to this request (`bindDraft`), or `null` when it renders the release. */
+/**
+ * What a request renders, held for the request's Server Components: the
+ * version (a draft, or an old release, with its preview's moment and switched
+ * tests and campaigns), the visitor and the tests and campaigns the proxy
+ * decided. React's `cache()` gives one slot per request in the React Server
+ * Components graph, the scope a draft needs; no `next/headers` here, so the
+ * root components can read it without binding anything.
+ */
+import type { RequestVersion } from "@decocms/blocks";
+import type { Visitor } from "@decocms/blocks/experiments";
+import type { PathAssignments } from "../assignments.ts";
+interface DraftSlot {
+    version: RequestVersion | null;
+    visitor: Visitor | null;
+    assignments: PathAssignments | null;
+    /** The link named a draft that can't be read anymore: the page renders the release. */
+    unavailable: boolean;
+    /** The request's release check (`cms.checkRelease()`), which its draft reads wait for. */
+    releaseCheck: string | null;
+}
+export declare const draftSlot: () => DraftSlot;
+/** The version bound to this request (`bindDraft`), or `null` when it renders the current release. */
 export declare function activeDraftPointer(): string | null;
+/** Whether the request's link named a draft that can't be read anymore (`bindDraft`). */
+export declare function draftUnavailable(): boolean;
+export {};
 //# sourceMappingURL=slot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../src/server/slot.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,SAAS,QAAa;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAA0B,CAAC;AAEtF,oGAAoG;AACpG,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD"}
+{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../src/server/slot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,UAAU,SAAS;IACjB,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IACrB,0FAA0F;IAC1F,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,SAAS,QAChB,SAOL,CAAC;AAEF,sGAAsG;AACtG,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}

package/dist/server/slot.js

@@ -1,13 +1,17 @@
-/**
- * The draft a request renders, held for the request's Server Components.
- * React's `cache()` gives one slot per request in the React Server
- * Components graph, the scope a draft needs; no `next/headers` here, so the
- * root components can read it without binding anything.
- */
 import { cache } from "react";
-export const draftSlot = cache(() => ({ pointer: null }));
-/** The draft pointer bound to this request (`bindDraft`), or `null` when it renders the release. */
+export const draftSlot = cache(() => ({
+    version: null,
+    visitor: null,
+    assignments: null,
+    unavailable: false,
+    releaseCheck: null,
+}));
+/** The version bound to this request (`bindDraft`), or `null` when it renders the current release. */
 export function activeDraftPointer() {
-    return draftSlot().pointer;
+    return draftSlot().version?.version ?? null;
+}
+/** Whether the request's link named a draft that can't be read anymore (`bindDraft`). */
+export function draftUnavailable() {
+    return draftSlot().unavailable;
 }
 //# sourceMappingURL=slot.js.map

package/dist/server/slot.js.map

@@ -1 +1 @@
-{"version":3,"file":"slot.js","sourceRoot":"","sources":["../../src/server/slot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC,GAA+B,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEtF,oGAAoG;AACpG,MAAM,UAAU,kBAAkB;IAChC,OAAO,SAAS,EAAE,CAAC,OAAO,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"slot.js","sourceRoot":"","sources":["../../src/server/slot.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAa9B,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAC5B,GAAc,EAAE,CAAC,CAAC;IAChB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,IAAI;CACnB,CAAC,CACH,CAAC;AAEF,sGAAsG;AACtG,MAAM,UAAU,kBAAkB;IAChC,OAAO,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,EAAE,CAAC,WAAW,CAAC;AACjC,CAAC"}

package/dist/visitor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * How the proxy hands the pages the visitor: the request header it forwards
+ * once it read the visitor (`readVisitor` from `@decocms/blocks/experiments`,
+ * a new one on a first visit). The proxy writes it (`visitorRequestHeaders`
+ * from `@decocms/nextjs/proxy`); the pages read it (`bindDraft`, then
+ * `contentClient`, from `@decocms/nextjs/server`). The package's own copy: it
+ * never imports `@decocms/tanstack`. No imports, no state: safe in every
+ * bundle.
+ */
+/**
+ * The request header carrying the visitor, in its stored form (the
+ * `deco_segment` cookie's value, `serializeVisitor`). The proxy removes any
+ * copy that arrives from outside (`draftRequestHeaders`).
+ */
+export declare const VISITOR_HEADER = "x-deco-visitor";
+//# sourceMappingURL=visitor.d.ts.map

package/dist/visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.d.ts","sourceRoot":"","sources":["../src/visitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,mBAAmB,CAAC"}

package/dist/visitor.js

@@ -0,0 +1,16 @@
+/**
+ * How the proxy hands the pages the visitor: the request header it forwards
+ * once it read the visitor (`readVisitor` from `@decocms/blocks/experiments`,
+ * a new one on a first visit). The proxy writes it (`visitorRequestHeaders`
+ * from `@decocms/nextjs/proxy`); the pages read it (`bindDraft`, then
+ * `contentClient`, from `@decocms/nextjs/server`). The package's own copy: it
+ * never imports `@decocms/tanstack`. No imports, no state: safe in every
+ * bundle.
+ */
+/**
+ * The request header carrying the visitor, in its stored form (the
+ * `deco_segment` cookie's value, `serializeVisitor`). The proxy removes any
+ * copy that arrives from outside (`draftRequestHeaders`).
+ */
+export const VISITOR_HEADER = "x-deco-visitor";
+//# sourceMappingURL=visitor.js.map

package/dist/visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.js","sourceRoot":"","sources":["../src/visitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/nextjs",
-  "version": "8.5.2",
+  "version": "8.7.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -56,7 +56,7 @@
     "typecheck": "node ../../scripts/tsc.mjs -p tsconfig.json"
   },
   "peerDependencies": {
-    "@decocms/blocks": "^8.5.0",
+    "@decocms/blocks": "^8.6.0",
     "@opentelemetry/api": "^1.0.0",
     "next": "^16.0.0",
     "react": "^19.0.0"
@@ -67,7 +67,7 @@
     }
   },
   "devDependencies": {
-    "@decocms/blocks": "8.5.2",
+    "@decocms/blocks": "8.7.0",
     "@opentelemetry/api": "^1.9.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",

package/src/DraftPreviewIndicator.tsx

@@ -1,7 +1,8 @@
 /**
  * The "Preview mode" badge for the request's draft: a Server Component that
  * renders `DraftBadge` (`@decocms/blocks/preview`) only when `bindDraft`
- * bound a draft, so a published page emits nothing.
+ * bound a draft, so a published page emits nothing; when the link named a
+ * draft that can't be read anymore, the badge's calm notice instead.
  *
  * Render it inside the page, after `bindDraft` was awaited, never from a
  * layout: a layout renders alongside the page that fills it, so it may run
@@ -9,7 +10,7 @@
  */
 import { DraftBadge } from "@decocms/blocks/preview";
 import type { ReactNode } from "react";
-import { activeDraftPointer } from "./server/slot.ts";
+import { activeDraftPointer, draftUnavailable } from "./server/slot.ts";
 
 export interface DraftPreviewIndicatorProps {
   /** Where "Exit preview" goes; default: the current URL with `?__draft=off`. */
@@ -18,6 +19,6 @@ export interface DraftPreviewIndicatorProps {
 
 export function DraftPreviewIndicator({ exitHref }: DraftPreviewIndicatorProps = {}): ReactNode {
   const pointer = activeDraftPointer();
-  if (!pointer) return null;
+  if (!pointer) return draftUnavailable() ? <DraftBadge pointer={null} unavailable /> : null;
   return <DraftBadge pointer={pointer} exitHref={exitHref} />;
 }