@decocms/nextjs 8.5.1 → 8.6.0

package/src/server/slot.ts

@@ -1,14 +1,27 @@
 /**
- * The draft a request renders, held for the request's Server Components.
- * React's `cache()` gives one slot per request in the React Server
+ * 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 { cache } from "react";
+import type { PathAssignments } from "../assignments.ts";
 
-export const draftSlot = cache((): { pointer: string | null } => ({ pointer: null }));
+interface DraftSlot {
+  version: RequestVersion | null;
+  visitor: Visitor | null;
+  assignments: PathAssignments | null;
+}
+
+export const draftSlot = cache(
+  (): DraftSlot => ({ version: null, visitor: null, assignments: null }),
+);
 
-/** The draft pointer bound to this request (`bindDraft`), or `null` when it renders the release. */
+/** The version bound to this request (`bindDraft`), or `null` when it renders the current release. */
 export function activeDraftPointer(): string | null {
-  return draftSlot().pointer;
+  return draftSlot().version?.version ?? null;
 }

package/src/visitor.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 const VISITOR_HEADER = "x-deco-visitor";