@decocms/nextjs 8.5.1 → 8.6.0

package/dist/proxy/index.d.ts

@@ -1,5 +1,6 @@
 /**
- * `@decocms/nextjs/proxy`: draft previews in a Next.js proxy (`proxy.ts`, or
+ * `@decocms/nextjs/proxy`: draft previews, the visitor and what a request's
+ * content gives it, decided once, in a Next.js proxy (`proxy.ts`, or
  * `middleware.ts` before Next 16). No React and no block map: pass the proxy
  * a CMS handle made with an empty block map and the app's options, which
  * shares the app's instance (one per process) without pulling the site's
@@ -10,73 +11,176 @@
  * export const proxyCms = createCMS({ blocks: {}, ...cmsConfig });
  * ```
  *
- * A site with a proxy of its own calls the pieces (`decideDraft`, then
- * `draftRequestHeaders` on the request it forwards, then `applyDraft` on the
- * response); a site without one exports `draftProxy(...)`.
+ * A site with a proxy of its own calls the pieces (`decideDraft`,
+ * `decideVisitor` and `decideAssignments`, then `draftRequestHeaders`,
+ * `visitorRequestHeaders` and `assignmentsRequestHeaders` on the request it
+ * forwards, then `applyDraft` and `applyVisitor` on the response); a site
+ * without one exports `draftProxy(...)`.
  *
- * Statically rendered pages can't read a draft, so a drafted request to one
- * is rewritten onto a dynamic draft route (`/_draft/<path>`, mounted as
+ * The proxy decides: the version (`decideDraft`: a Studio link's draft or old
+ * release, after the host allowlist, with the preview's moment and switched
+ * tests and campaigns), the visitor (`decideVisitor`: `readVisitor` from
+ * `@decocms/blocks/experiments`, the `deco_segment` cookie or a new visitor)
+ * and, from both, each test and campaign on or off (`decideAssignments`:
+ * `cms.client({ version, visitor, date, experiments, campaigns })` resolving
+ * the saved `experiments` and `campaigns` blocks). It forwards them on
+ * `x-deco-version`, `x-deco-visitor` and `x-deco-assignments` (copies from
+ * outside are always removed), and the page builds
+ * `cms.client({ version, experiments, campaigns })` from them
+ * (`contentClient`), deciding nothing again. It sends the visitor's cookie on
+ * a first visit only, never from a preview.
+ *
+ * Cached (ISR) pages can't read a request, so a drafted request to one is
+ * rewritten onto a dynamic draft route (`/_draft/<path>`, mounted as
  * `app/%5Fdraft/...`: a literal `_draft` folder is private in Next and never
- * routes).
+ * routes), and a published one onto the assignments route
+ * (`/_assignments/<assignments>/<path>`, `rewriteToAssignmentsRoute`), where
+ * `assignedClient` from `@decocms/nextjs/server` builds the client from the
+ * path.
+ *
+ * The binding caches nothing. A site that caches in front of its pages (a
+ * CDN keyed on a request header) keys on the request's assignments, never on
+ * the visitor: `assignmentsKey(await decideAssignments(proxyCms, draft,
+ * visitor))`, `""` when there are none.
  *
  * The proxy measures no requests: it runs before Next routes and renders the
  * page. `http.server.request.duration` comes from Next's own request span
  * (`register` from `@decocms/nextjs/instrumentation`).
  */
-import type { CMS } from "@decocms/blocks";
+import type { CMS, RequestVersion } from "@decocms/blocks";
+import { type Visitor } from "@decocms/blocks/experiments";
 import { type NextRequest, NextResponse } from "next/server.js";
-import { type PreviewPolicy } from "../drafts.ts";
-export { inferredPreviewHosts, type PreviewPolicy, previewHostDecision, requestLike, } from "../drafts.ts";
-/** What the proxy needs from the CMS: the site's declared preview hosts and their check. */
-export type CMSHandle = Pick<CMS, "draftPointer" | "settings" | "forRelease">;
+import { type RequestAssignments } from "../assignments.ts";
+export { requestLike } from "../drafts.ts";
+/** What the draft decision needs from the CMS: its preview host check, and the release. */
+export type CMSHandle = Pick<CMS, "readVersion" | "forRelease">;
 /** What the proxy does with a request's draft state. */
 export interface DraftDecision {
-    /** The draft this request renders, after the host check; `null` for the release. */
-    pointer: string | null;
-    /** The `Set-Cookie` the response carries: storing a draft link's pointer, or ending a preview. */
+    /**
+     * What this request's Studio link asks for, after the host check: the
+     * version (a draft pointer, or a release's commit SHA) and the preview's
+     * moment and switched tests and campaigns, in the shape of
+     * `cms.client()`'s options; `null` for the current release.
+     */
+    version: RequestVersion | null;
+    /** The `Set-Cookie` the response carries: storing a link's version, or ending a preview. */
     setCookie: string | null;
 }
-export { DRAFT_ROUTE_PREFIX } from "../draft.ts";
+export { ASSIGNMENTS_HEADER, ASSIGNMENTS_ROUTE_PREFIX, assignmentsKey, assignmentsRoutePath, assignmentsSegment, isAssignmentsRoutePath, type PathAssignments, parseAssignmentsSegment, type RequestAssignments, readAssignments, } from "../assignments.ts";
+export { DRAFT_ROUTE_PREFIX, VERSION_HEADER } from "../draft.ts";
 /**
- * The draft a request renders and the cookie its response sets, under
- * `policy` (the same options the pages pass to `bindDraft`). A request with
+ * The version a request renders and the cookie its response sets, on a host
+ * the CMS allows (as the pages' `bindDraft` checks again). A request with
  * no `?__draft=` and no draft cookie never reaches the CMS.
  */
-export declare function decideDraft(cms: CMSHandle, request: NextRequest | Request, policy?: PreviewPolicy): Promise<DraftDecision>;
+export declare function decideDraft(cms: CMSHandle, request: NextRequest | Request): Promise<DraftDecision>;
 /**
- * The request headers to forward: the accepted pointer on `x-deco-draft`, so
- * the root layout can bind the draft on the same request (a layout gets no
+ * The request headers to forward: the accepted version on `x-deco-version`,
+ * so the root layout can bind the draft on the same request (a layout gets no
  * `searchParams`, and on a draft link the cookie is only on the response).
- * A copy that arrives from outside is always removed.
+ * A copy that arrives from outside is always removed, and so are any
+ * `x-deco-visitor` and `x-deco-assignments` (`visitorRequestHeaders` and
+ * `assignmentsRequestHeaders` set the proxy's own).
  */
 export declare function draftRequestHeaders(request: NextRequest | Request, decision: DraftDecision): Headers;
+/** The visitor of one request. */
+export interface VisitorDecision {
+    /** Who is visiting: the `deco_segment` cookie's visitor, or a new one. */
+    visitor: Visitor;
+    /** The `deco_segment` `Set-Cookie`, on a first visit to the live site; `null` otherwise. */
+    setCookie: string | null;
+}
+/**
+ * The visitor of a request (`readVisitor`: the `deco_segment` cookie, or a
+ * new visitor when it had no id) and the cookie to send back, only on a first
+ * visit and never from a preview (`draft` holds a version): Studio is not a
+ * visitor. Reads no content.
+ */
+export declare function decideVisitor(request: NextRequest | Request, draft: DraftDecision): VisitorDecision;
+/**
+ * The forwarded headers with the visitor on `x-deco-visitor`. Pass it the
+ * headers `draftRequestHeaders` gave, which already removed a copy from
+ * outside.
+ */
+export declare function visitorRequestHeaders(headers: Headers, decision: VisitorDecision): Headers;
+/** The `deco_segment` cookie on the response, on a first visit. */
+export declare function applyVisitor<R extends Response>(response: R, decision: VisitorDecision): R;
+/**
+ * Each test and campaign on or off for this request, decided once:
+ * `cms.client({ visitor, ...version })` (the visitor, and the Studio link's
+ * version, moment and switched tests and campaigns) resolving the saved
+ * `experiments` and `campaigns` blocks. Missing blocks, or content that
+ * doesn't load, give none, never an error.
+ */
+export declare function decideAssignments(cms: Pick<CMS, "client">, draft: DraftDecision, visitor: VisitorDecision): Promise<RequestAssignments>;
+/**
+ * The forwarded headers with the decided tests and campaigns on
+ * `x-deco-assignments` (`assignmentsSegment`), for `bindDraft` and
+ * `contentClient`. Pass it the headers `draftRequestHeaders` gave.
+ */
+export declare function assignmentsRequestHeaders(headers: Headers, assignments: RequestAssignments): Headers;
 /** Whether `pathname` is on the draft route: a site answers a direct hit there with its 404. */
 export declare function isDraftRoutePath(pathname: string): boolean;
 /**
  * The rewrite of a drafted request onto the draft route, keeping its path and
- * forwarding the pointer; `null` when the request isn't drafted or is already
- * on the draft route.
+ * forwarding the version and, when given, the visitor (`decideVisitor`) and
+ * the assignments (`decideAssignments`); `null` when the request isn't
+ * drafted or is already on the draft route.
  */
-export declare function rewriteToDraftRoute(request: NextRequest, decision: DraftDecision): NextResponse | null;
+export declare function rewriteToDraftRoute(request: NextRequest, decision: DraftDecision, visitor?: VisitorDecision, assignments?: RequestAssignments): NextResponse | null;
+/**
+ * The rewrite of a published request onto the assignments route,
+ * `/_assignments/<assignments>/<path>`: each test on or off for the visitor
+ * and each campaign running or not now (`readAssignments` on the current
+ * release), as one path segment, so Next's own path-keyed cache (ISR, the
+ * full route cache) keeps one entry per set of assignments. Visitors on the
+ * same side of every test share a path; the visitor id is never in it, and
+ * the page reads neither the visitor nor the version (the proxy's headers are
+ * removed from the request it forwards), so Next can cache it. The page
+ * builds its client with `assignedClient` from `@decocms/nextjs/server`,
+ * `cms.client({ experiments, campaigns })` from the path: the proxy decides,
+ * the page renders that. A cached page (ISR, `revalidate = 600`) is about 10
+ * minutes stale (the first request after that still gets it while Next
+ * renders it again), a banner switching on late, which is accepted.
+ *
+ * `null` for a drafted request (it renders on the draft route, never cached)
+ * and for a path already on the draft or assignments route. When the content
+ * saves tests or campaigns, the response is marked `Cache-Control: private,
+ * no-cache`: Next keeps one cached page per set of assignments, but the URL
+ * the visitor asked for answers by their cookie and the moment, so a CDN in
+ * front must not share it. Call it only for the paths the assignments route
+ * renders (the CMS's pages), and answer a direct hit on the route with a 404
+ * (`isAssignmentsRoutePath`).
+ */
+export declare function rewriteToAssignmentsRoute(cms: Pick<CMS, "client">, request: NextRequest, draft: DraftDecision, visitor: VisitorDecision): Promise<NextResponse | null>;
 /**
  * The cookie and the response headers of a draft: `Set-Cookie`, and for a
  * drafted response `Cache-Control: no-store, private`, `Vary: Cookie` and
  * `X-Robots-Tag: noindex, nofollow` (`draftResponseHeaders`). With the
- * pointer in a cookie a draft shares its URL with the published page, so a
+ * version in a cookie a draft shares its URL with the published page, so a
  * cache keyed on the URL alone would serve it to visitors.
  */
 export declare function applyDraft<R extends Response>(response: R, decision: DraftDecision): R;
-export interface DraftProxyOptions extends PreviewPolicy {
+export interface DraftProxyOptions {
     /**
      * Which drafted requests go to the draft route (a statically rendered
      * page's). Default: every drafted request outside the draft route. Return
      * `false` for a route that is already dynamic and binds the draft itself.
      */
     rewrite?: (request: NextRequest) => boolean;
+    /**
+     * Which published requests render on the assignments route
+     * (`rewriteToAssignmentsRoute`): the CMS's pages, when the site mounts
+     * `app/%5Fassignments/[assignments]/[[...path]]`. Default: none. A direct
+     * hit on the route gets a 404 once this is set.
+     */
+    assignments?: (request: NextRequest) => boolean;
 }
 /**
- * The whole draft flow for a site with no proxy of its own:
- * `export const proxy = draftProxy(proxyCms, { site: "my-store" })`.
+ * The whole flow for a site with no proxy of its own:
+ * `export const proxy = draftProxy(proxyCms)`. Every
+ * request it forwards carries the version, the visitor and the assignments
+ * it decided.
  */
-export declare function draftProxy(cms: CMSHandle, options?: DraftProxyOptions): (request: NextRequest) => Promise<NextResponse>;
+export declare function draftProxy(cms: CMSHandle & Pick<CMS, "client">, options?: DraftProxyOptions): (request: NextRequest) => Promise<NextResponse>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAML,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,mBAAmB,EACnB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC,CAAC;AAE9E,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kGAAkG;IAClG,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAKT;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,GACtB,YAAY,GAAG,IAAI,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,GAAG,CAAC,CAMtF;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,iBAAsB,GAC9B,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAUjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAKL,KAAK,kBAAkB,EAExB,MAAM,mBAAmB,CAAC;AAY3B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,2FAA2F;AAC3F,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC;AAEhE,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,4FAA4F;IAC5F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,eAAe,EACpB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIjE;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,WAAW,GAAG,OAAO,GAC7B,OAAO,CAAC,aAAa,CAAC,CAUxB;AAKD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAKT;AAED,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB,4FAA4F;IAC5F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AASD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,KAAK,EAAE,aAAa,GACnB,eAAe,CAOjB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAI1F;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,GAAG,CAAC,CAG1F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EACxB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAIT;AAeD,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,eAAe,EACzB,WAAW,CAAC,EAAE,kBAAkB,GAC/B,YAAY,GAAG,IAAI,CAQrB;AAKD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EACxB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAa9B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,GAAG,CAAC,CAMtF;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC;IAC5C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EACpC,OAAO,GAAE,iBAAsB,GAC9B,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAuBjD"}

package/dist/proxy/index.js

@@ -1,42 +1,114 @@
+import { readVisitor, serializeVisitor } from "@decocms/blocks/experiments";
 import { NextResponse } from "next/server.js";
-import { DRAFT_HEADER, DRAFT_ROUTE_PREFIX, draftResponseHeaders } from "../draft.js";
-import { allowedDraft, draftCookie, endsPreview, fromDraftLink, hasDraftSignal, requestLike, } from "../drafts.js";
-export { inferredPreviewHosts, previewHostDecision, requestLike, } from "../drafts.js";
-export { DRAFT_ROUTE_PREFIX } from "../draft.js";
-const INERT = Object.freeze({ pointer: null, setCookie: null });
+import { ASSIGNMENTS_HEADER, assignmentsRoutePath, assignmentsSegment, isAssignmentsRoutePath, readAssignmentsAndScope, } from "../assignments.js";
+import { DRAFT_ROUTE_PREFIX, draftResponseHeaders, VERSION_HEADER } from "../draft.js";
+import { allowedDraft, draftCookie, draftLinkValue, endsPreview, hasDraftSignal, requestLike, } from "../drafts.js";
+import { VISITOR_HEADER } from "../visitor.js";
+export { requestLike } from "../drafts.js";
+export { ASSIGNMENTS_HEADER, ASSIGNMENTS_ROUTE_PREFIX, assignmentsKey, assignmentsRoutePath, assignmentsSegment, isAssignmentsRoutePath, parseAssignmentsSegment, readAssignments, } from "../assignments.js";
+export { DRAFT_ROUTE_PREFIX, VERSION_HEADER } from "../draft.js";
+const INERT = Object.freeze({ version: null, setCookie: null });
 /**
- * The draft a request renders and the cookie its response sets, under
- * `policy` (the same options the pages pass to `bindDraft`). A request with
+ * The version a request renders and the cookie its response sets, on a host
+ * the CMS allows (as the pages' `bindDraft` checks again). A request with
  * no `?__draft=` and no draft cookie never reaches the CMS.
  */
-export async function decideDraft(cms, request, policy = {}) {
+export async function decideDraft(cms, request) {
     const url = new URL(request.url);
     const like = requestLike(request.headers, url.pathname + url.search, url.host);
     if (like === null || !hasDraftSignal(like))
         return INERT;
     // Ending a preview is allowed on any host, so a cookie set earlier always goes.
     if (endsPreview(like))
-        return { pointer: null, setCookie: draftCookie("", ["Max-Age=0"]) };
-    const pointer = await allowedDraft(cms, like, policy);
-    if (pointer === null)
+        return { version: null, setCookie: draftCookie("", ["Max-Age=0"]) };
+    const version = await allowedDraft(cms, like);
+    if (version === null)
         return INERT;
-    return {
-        pointer,
-        setCookie: fromDraftLink(like, pointer) ? draftCookie(encodeURIComponent(pointer)) : null,
-    };
+    const link = draftLinkValue(like);
+    return { version, setCookie: link ? draftCookie(encodeURIComponent(link)) : null };
 }
+/** The headers the proxy writes for the pages: never taken from outside. */
+const OWN_HEADERS = [VERSION_HEADER, VISITOR_HEADER, ASSIGNMENTS_HEADER];
 /**
- * The request headers to forward: the accepted pointer on `x-deco-draft`, so
- * the root layout can bind the draft on the same request (a layout gets no
+ * The request headers to forward: the accepted version on `x-deco-version`,
+ * so the root layout can bind the draft on the same request (a layout gets no
  * `searchParams`, and on a draft link the cookie is only on the response).
- * A copy that arrives from outside is always removed.
+ * A copy that arrives from outside is always removed, and so are any
+ * `x-deco-visitor` and `x-deco-assignments` (`visitorRequestHeaders` and
+ * `assignmentsRequestHeaders` set the proxy's own).
  */
 export function draftRequestHeaders(request, decision) {
     const headers = new Headers(request.headers);
-    if (decision.pointer)
-        headers.set(DRAFT_HEADER, decision.pointer);
-    else
-        headers.delete(DRAFT_HEADER);
+    for (const name of OWN_HEADERS)
+        headers.delete(name);
+    if (decision.version)
+        headers.set(VERSION_HEADER, decision.version.version);
+    return headers;
+}
+/** Whether the visitor asked over https (`x-forwarded-proto` first, as a host in front reports it). */
+function isHttps(request) {
+    const forwarded = request.headers.get("x-forwarded-proto")?.split(",")[0]?.trim();
+    if (forwarded)
+        return forwarded === "https";
+    return new URL(request.url).protocol === "https:";
+}
+/**
+ * The visitor of a request (`readVisitor`: the `deco_segment` cookie, or a
+ * new visitor when it had no id) and the cookie to send back, only on a first
+ * visit and never from a preview (`draft` holds a version): Studio is not a
+ * visitor. Reads no content.
+ */
+export function decideVisitor(request, draft) {
+    // `readVisitor` makes the cookie `Secure` unless the request came over plain http.
+    const { visitor, cookie } = readVisitor({
+        url: isHttps(request) ? "https://localhost/" : "http://localhost/",
+        headers: request.headers,
+    });
+    return { visitor, setCookie: draft.version === null ? cookie : null };
+}
+/**
+ * The forwarded headers with the visitor on `x-deco-visitor`. Pass it the
+ * headers `draftRequestHeaders` gave, which already removed a copy from
+ * outside.
+ */
+export function visitorRequestHeaders(headers, decision) {
+    const out = new Headers(headers);
+    out.set(VISITOR_HEADER, serializeVisitor(decision.visitor));
+    return out;
+}
+/** The `deco_segment` cookie on the response, on a first visit. */
+export function applyVisitor(response, decision) {
+    if (decision.setCookie)
+        response.headers.append("set-cookie", decision.setCookie);
+    return response;
+}
+/**
+ * Each test and campaign on or off for this request, decided once:
+ * `cms.client({ visitor, ...version })` (the visitor, and the Studio link's
+ * version, moment and switched tests and campaigns) resolving the saved
+ * `experiments` and `campaigns` blocks. Missing blocks, or content that
+ * doesn't load, give none, never an error.
+ */
+export function decideAssignments(cms, draft, visitor) {
+    return readAssignmentsAndScope(cms, { visitor: visitor.visitor, ...draft.version }).then((read) => read.assignments);
+}
+/**
+ * The forwarded headers with the decided tests and campaigns on
+ * `x-deco-assignments` (`assignmentsSegment`), for `bindDraft` and
+ * `contentClient`. Pass it the headers `draftRequestHeaders` gave.
+ */
+export function assignmentsRequestHeaders(headers, assignments) {
+    const out = new Headers(headers);
+    out.set(ASSIGNMENTS_HEADER, assignmentsSegment(assignments));
+    return out;
+}
+/** The request headers to forward: the version's and, when given, the visitor's and the assignments. */
+function forwardedHeaders(request, draft, visitor, assignments) {
+    let headers = draftRequestHeaders(request, draft);
+    if (visitor !== undefined)
+        headers = visitorRequestHeaders(headers, visitor);
+    if (assignments !== undefined)
+        headers = assignmentsRequestHeaders(headers, assignments);
     return headers;
 }
 /** Whether `pathname` is on the draft route: a site answers a direct hit there with its 404. */
@@ -45,47 +117,107 @@ export function isDraftRoutePath(pathname) {
 }
 /**
  * The rewrite of a drafted request onto the draft route, keeping its path and
- * forwarding the pointer; `null` when the request isn't drafted or is already
- * on the draft route.
+ * forwarding the version and, when given, the visitor (`decideVisitor`) and
+ * the assignments (`decideAssignments`); `null` when the request isn't
+ * drafted or is already on the draft route.
  */
-export function rewriteToDraftRoute(request, decision) {
-    if (!decision.pointer)
+export function rewriteToDraftRoute(request, decision, visitor, assignments) {
+    if (!decision.version)
         return null;
     const url = request.nextUrl.clone();
     if (isDraftRoutePath(url.pathname))
         return null;
     url.pathname = `${DRAFT_ROUTE_PREFIX}${url.pathname}`;
     return NextResponse.rewrite(url, {
-        request: { headers: draftRequestHeaders(request, decision) },
+        request: { headers: forwardedHeaders(request, decision, visitor, assignments) },
+    });
+}
+/** An assignments-route response's `Cache-Control` when its content has tests or campaigns. */
+const ASSIGNED_CACHE_CONTROL = "private, no-cache";
+/**
+ * The rewrite of a published request onto the assignments route,
+ * `/_assignments/<assignments>/<path>`: each test on or off for the visitor
+ * and each campaign running or not now (`readAssignments` on the current
+ * release), as one path segment, so Next's own path-keyed cache (ISR, the
+ * full route cache) keeps one entry per set of assignments. Visitors on the
+ * same side of every test share a path; the visitor id is never in it, and
+ * the page reads neither the visitor nor the version (the proxy's headers are
+ * removed from the request it forwards), so Next can cache it. The page
+ * builds its client with `assignedClient` from `@decocms/nextjs/server`,
+ * `cms.client({ experiments, campaigns })` from the path: the proxy decides,
+ * the page renders that. A cached page (ISR, `revalidate = 600`) is about 10
+ * minutes stale (the first request after that still gets it while Next
+ * renders it again), a banner switching on late, which is accepted.
+ *
+ * `null` for a drafted request (it renders on the draft route, never cached)
+ * and for a path already on the draft or assignments route. When the content
+ * saves tests or campaigns, the response is marked `Cache-Control: private,
+ * no-cache`: Next keeps one cached page per set of assignments, but the URL
+ * the visitor asked for answers by their cookie and the moment, so a CDN in
+ * front must not share it. Call it only for the paths the assignments route
+ * renders (the CMS's pages), and answer a direct hit on the route with a 404
+ * (`isAssignmentsRoutePath`).
+ */
+export async function rewriteToAssignmentsRoute(cms, request, draft, visitor) {
+    if (draft.version)
+        return null;
+    const url = request.nextUrl.clone();
+    if (isDraftRoutePath(url.pathname) || isAssignmentsRoutePath(url.pathname))
+        return null;
+    const { assignments, varies } = await readAssignmentsAndScope(cms, { visitor: visitor.visitor });
+    url.pathname = assignmentsRoutePath(url.pathname, assignments);
+    const response = NextResponse.rewrite(url, {
+        request: { headers: draftRequestHeaders(request, INERT) },
     });
+    // The URL the visitor asked for answers differently by their cookie and the moment: a
+    // shared cache in front (a CDN) must not keep Next's ISR `s-maxage` under it.
+    if (varies)
+        response.headers.set("Cache-Control", ASSIGNED_CACHE_CONTROL);
+    return response;
 }
 /**
  * The cookie and the response headers of a draft: `Set-Cookie`, and for a
  * drafted response `Cache-Control: no-store, private`, `Vary: Cookie` and
  * `X-Robots-Tag: noindex, nofollow` (`draftResponseHeaders`). With the
- * pointer in a cookie a draft shares its URL with the published page, so a
+ * version in a cookie a draft shares its URL with the published page, so a
  * cache keyed on the URL alone would serve it to visitors.
  */
 export function applyDraft(response, decision) {
     if (decision.setCookie)
         response.headers.append("set-cookie", decision.setCookie);
-    for (const [name, value] of Object.entries(draftResponseHeaders(decision.pointer))) {
+    for (const [name, value] of Object.entries(draftResponseHeaders(decision.version?.version))) {
         response.headers.set(name, value);
     }
     return response;
 }
 /**
- * The whole draft flow for a site with no proxy of its own:
- * `export const proxy = draftProxy(proxyCms, { site: "my-store" })`.
+ * The whole flow for a site with no proxy of its own:
+ * `export const proxy = draftProxy(proxyCms)`. Every
+ * request it forwards carries the version, the visitor and the assignments
+ * it decided.
  */
 export function draftProxy(cms, options = {}) {
-    const { rewrite = () => true, ...policy } = options;
+    const { rewrite = () => true, assignments } = options;
     return async (request) => {
-        const decision = await decideDraft(cms, request, policy);
-        const rewritten = rewrite(request) ? rewriteToDraftRoute(request, decision) : null;
-        const response = rewritten ??
-            NextResponse.next({ request: { headers: draftRequestHeaders(request, decision) } });
-        return applyDraft(response, decision);
+        if (assignments && isAssignmentsRoutePath(request.nextUrl.pathname)) {
+            return new NextResponse(null, { status: 404 });
+        }
+        const decision = await decideDraft(cms, request);
+        const visitor = decideVisitor(request, decision);
+        const onAssignmentsRoute = decision.version === null && assignments?.(request) === true;
+        const rewritten = onAssignmentsRoute
+            ? await rewriteToAssignmentsRoute(cms, request, decision, visitor)
+            : null;
+        let response = rewritten;
+        if (response === null) {
+            const decided = await decideAssignments(cms, decision, visitor);
+            response =
+                (rewrite(request) ? rewriteToDraftRoute(request, decision, visitor, decided) : null) ??
+                    NextResponse.next({
+                        request: { headers: forwardedHeaders(request, decision, visitor, decided) },
+                    });
+        }
+        return applyVisitor(applyDraft(response, decision), visitor);
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/proxy/index.js.map

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

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">;
 /**
- * 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;AAYlE,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,CAAC,CAAC;AAOvD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9F;AAmDD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,MAAM,CAS9D;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"}