@delmaredigital/payload-experiments 0.3.0-rc.1 → 0.4.0-rc.1

package/README.md

@@ -1,5 +1,7 @@
 # @delmaredigital/payload-experiments
 
+> ⚠️ Upgrading to 0.4? Run `payload migrate:create` for four nullable plugin columns (`xp_experiments.page_collection` and its `_xp_experiments_v` counterpart, `xp_phases.placement_docs`, `xp_state.retired_slugs`), plus the Experiment block and `xpGoal` columns if you adopt them, then `payload generate:importmap`. Saves on pages, blocks and Puck collections can now be refused while a test runs on them (`page-busy`, `interacting-tests`); Puck tests whose slot is only on a draft can't start until the page is published; host `metricSources` ids may not start with `click:`. See the CHANGELOG's BREAKING section.
+
 > ⚠️ Upgrading to 0.3? For 0.3.0-rc.1, every `linkIdentity` call must supply `verified`; it now returns an outcome. Run `payload migrate:create` for the nullable `xp_identities.verified_at` column and `user_id` index, plus the release-pages columns listed in the CHANGELOG (`decision_pages_released_at` / `decision_pages_released_by` on `xp_experiments` and their `version_` counterparts on `_xp_experiments_v`). Existing identity links become unverified; see the CHANGELOG for optional backfill.
 
 > ⚠️ Upgrading to 0.2? After upgrading, run `payload generate:importmap`: the Tests surface is registered through admin.dependencies, and without it the Tests routes show a 'not installed' message instead of the Tests screen. In 0.2.0-rc.2, the Tests server views moved from `/rsc` to `/admin/rsc`, so the import map must be regenerated when upgrading from rc.1 too. The old experiments edit-form components are gone from `/admin/client`, and the `xp-experiments` admin list and edit views now redirect to the Tests surface.
@@ -271,7 +273,10 @@ Other server integrations:
 - `recordContentChange({ doc, previousDoc, req, collection })` can be called
   from a host collection's `afterChange` for content tagged with the arm-select
   field; for a collection with drafts, also add `captureContentBaseline` to its
-  `beforeChange` hooks so the previously published content can be compared. Supply that hook's transaction request. Puck collections get the hook
+  `beforeChange` hooks so the previously published content can be compared.
+  Collections without drafts can also add `captureContentBaseline` for an exact
+  raw comparison; without it, the helper normalises relationships to ids. No host
+  change is required for collections without drafts. Supply that hook's transaction request. Puck collections get the hook
   automatically when enabled. Markers compare published content; drafts and
   autosaves do not add markers (collections without drafts record on save).
   Neither the helper nor the installed hooks ever throw into your save: a
@@ -281,7 +286,10 @@ Other server integrations:
   canonical; archived losing paths point canonically to the winner. It reads
   the signed request context via `headers()`, so it decides from the URL the
   visitor requested, not the rewritten route, and the Original's URL is never
-  noindex. Call it only from a dynamic `generateMetadata`, never inside
+  noindex. While a test is live the Original's URL also gets a canonical to
+  itself, even when it is served with a variant's route: merge this result after
+  your own metadata so its `alternates.canonical` wins over one derived from the
+  rendered route. Call it only from a dynamic `generateMetadata`, never inside
   `'use cache'`; `path` is the fallback when the proxy did not run.
   `experimentSitemapFilter(path, manifest)` is a synchronous build-time filter:
   pass a privately server-loaded manifest and keep paths for which it returns
@@ -420,6 +428,7 @@ schema. Optional callbacks integrate host-owned content:
 
 A `MetricSource`, registered in `metricSources`, has `id`, `label`,
 `kind: 'binomial' | 'count' | 'revenue'`, and `keyedBy: 'visitor' | 'user'`.
+Source ids starting with `click:` are reserved for click goals and refused at boot.
 `clientWritable` optionally permits client conversions (revenue is always
 server-only). `query({ from, to, unitIds? })` returns a promise of
 `[{ unitId, value, ts }]`, **one row per event**, with `ts` a `Date`; use the
@@ -450,6 +459,21 @@ are recorded with `trackConversion`. Beacon conversions for a non-writable name
 are dropped silently. Only listed names become `events:<name>` sources. They
 support visitor and user units and do not represent counts or revenue in v1.
 
+### Testing page SEO in the host
+
+`pageKindSeoContract({ secret, original, versions, state, winner? })` from `/rsc`
+returns `{ manifest, rows }`. States are `running`, `decided` and `archived`;
+provide a winner path for the latter two. Build the host's test runtime with
+`loadManifest: async () => manifest` and the same secret. For each row, set
+`next/headers` to its signed `headers`, render metadata for `servedPath`, and
+assert `expect.robots`, `expect.canonical` and `expect.inSitemap` against the
+host's metadata and sitemap functions. This includes the Original served as
+each version, including the homepage.
+
+A host-level test mocks four boundaries: `next/headers`, the page loader,
+the runtime and the site URL. Set `metadataBase` so relative canonical paths
+resolve to your site URL.
+
 ### Whole-page options
 
 | Option | Purpose |
@@ -483,18 +507,39 @@ pages: {
 Adapt both callbacks for the site's homepage path. These checks run before Start;
 they do not protect pages from later deletion, unpublishing or renaming. Keep an
 archived winner published at the same address: archived test URLs still point to it.
-No migration is needed.
+Whole-page registrations also install the sidebar test status and content-change hooks.
+For 0.4.0, run `payload migrate:create` for `xp_state.retired_slugs`,
+`xp_experiments.page_collection` and its version column, then
+`payload generate:importmap`.
+
+`contentOf(doc)` optionally selects the content your site renders (for example,
+`doc.layout`). Published copies are compared with nested `id` and `blockName`
+keys removed. Without it, content checks and page content-change comparisons
+are skipped. `copyHint` (up to 200 characters), `copyUrl` (a root-relative path)
+and `copyLabel` (up to 40 characters, requires `copyUrl`) customize the guidance
+for making version pages. The default copy link opens the registered collection's
+list under the configured admin route.
 
 ### `admin` options
 
 Host links and kind descriptions are optional. For a host using payload-puck's
-editor route and a `puck-templates` collection, pass:
+editor route, public pages and a `puck-templates` collection:
+
+| Option | Signature and behavior |
+| --- | --- |
+| `admin.previewUrl` | `(placement: PreviewPlacement) => string \| null \| undefined \| Promise<string \| null \| undefined>`. Receives `collection`, `id`, `title`, `published`, and optional `slug`. May be async; return `null` to hide preview for that placement. Each call has a 2 s limit, with at most 8 lookups awaited concurrently. |
+
+For example, pass:
 
 ```ts
 admin: {
-  editorUrl: ({ collection, id, draft }) =>
+  editorUrl: ({ collection, id, draft, editor, doc }) =>
     `/admin/puck-editor/${encodeURIComponent(collection)}/${encodeURIComponent(String(id))}`,
-  previewUrl: ({ id }) => `/preview/template/${encodeURIComponent(String(id))}`,
+  previewUrl: async ({ collection, slug }) => {
+    if (collection !== 'pages' || slug === undefined) return null
+    // Match the site's public page routing, including its homepage convention.
+    return slug === 'home' ? '/' : `/${slug}`
+  },
   descriptions: {
     block: 'Try different content on a landing page.',
     document: 'Try different versions of a donation ask.',
@@ -503,11 +548,21 @@ admin: {
 }
 ```
 
-Use your host's preview route for `previewUrl`. Preflight resolves both URL
-callbacks on the server for block placements; it passes only URL strings to the
-client. Missing or failed callbacks leave the URL unset, and the client uses the
-admin collection route when no editor URL is supplied. Kind descriptions are
-available to the server views through `config.custom.xp`.
+`PreviewPlacement` is exported from the package root and `/rsc`. Its `slug` is
+the published main row's string slug, including for a placement found in a newer
+draft with a different slug. It is absent for unpublished documents. `published`
+describes the placement's version; the callback receives no other document fields.
+An async callback can also look up the public path by `collection` and `id` using
+the host's own data access. The old `({ collection, id }) => string` form still works.
+
+Preflight resolves the URL callbacks on the server for block placements and sends
+only URL strings to the client. A null/undefined result, a non-string, an exception,
+a rejected promise or a timeout leaves preview hidden for that placement. When an
+editor URL exists, the admin offers "Edit on page"; when neither URL exists, it
+omits the row. Timed-out host work cannot be cancelled and keeps its concurrency
+slot until it settles; if all 8 slots remain occupied, further preview lookups
+are skipped for that preflight. Kind descriptions are available to the server views through
+`config.custom.xp`.
 
 A flag point can also declare `description?: string` to explain the setting below its label.
 
@@ -544,7 +599,10 @@ separately. Only manual, viewport and pageview exposure policies are accepted.
 Conversions require a client-writable source, never revenue; client values are
 stored as `1`, attributes are allow-listed, and the host's `events.rateLimit`
 adapter runs when supplied. Accepted and dropped events both return `202 {}`;
-malformed requests can return errors.
+malformed requests can return errors. `click:<key>` conversions are also accepted
+for defined click-goal keys matching `[a-z0-9][a-z0-9_-]{0,63}`; undefined or
+invalid keys are dropped with `202`. Clicks carry no attributes, and defined
+keys may be cached for up to 30 seconds.
 
 **The real bound on slow or method-override bodies is the host firewall/platform
 timeout.** A stream under the byte limit can remain open, and Payload can read
@@ -567,7 +625,8 @@ dashboard also includes **Tests** and **Goals** cards above its widgets. Goals
 appears only for users who can manage tests. Both additions follow the host's
 admin route and keep host-provided navigation and dashboard entries first.
 After upgrading, run `payload generate:importmap` to register the dashboard card
-component.
+component and the server nav wrapper.
+A host nav group also labelled "Tests" shares Payload's NavGroup DOM id and open-state preference with the plugin's group, so pick another label.
 
 ### Client assignments and exposure
 
@@ -620,19 +679,70 @@ configured to allow client writes; record revenue on the server.
 
 ### Puck render and editor configs
 
-Register `ExperimentSlot` from `@delmaredigital/payload-experiments/puck` in
-your render config and `ExperimentSlotEditor` from
-`@delmaredigital/payload-experiments/puck/editor` in your editor config, using
-the same `ExperimentSlot` component name:
+Works with: payload-puck ≥0.10.3 (experiments ≥0.4.0).
+
+For payload-puck hosts, add one integration object on each side. In the render
+config, pass `integrations` to `extendConfig`:
 
 ```ts
-// Render config
-components: { ExperimentSlot }
+import { extendConfig } from '@delmaredigital/payload-puck/config'
+import { experimentsPuck } from '@delmaredigital/payload-experiments/puck'
+import { baseConfig } from './baseConfig'
+
+export const renderConfig = extendConfig({
+  base: baseConfig,
+  integrations: [experimentsPuck()],
+})
+```
+
+Call `experimentsPuckEditor()` once at module scope in a `'use client'` module,
+then pass that array to `PuckConfigProvider`. A new object per render rebuilds
+Puck's config and plugin list.
+
+```tsx
+'use client'
 
-// Editor config
-components: { ExperimentSlot: ExperimentSlotEditor }
+import { PuckConfigProvider } from '@delmaredigital/payload-puck/client'
+import { experimentsPuckEditor } from '@delmaredigital/payload-experiments/puck/editor'
+import { editorConfig } from './editorConfig'
+
+const integrations = [experimentsPuckEditor()]
+
+export function PuckProvider({ children }: { children: React.ReactNode }) {
+  return <PuckConfigProvider config={editorConfig} integrations={integrations}>
+    {children}
+  </PuckConfigProvider>
+}
 ```
 
+Each object includes the test block and its **A/B tests** sidebar category. The
+editor object also includes the outline plugin: it hides empty version slots
+that the block's test doesn't use, while content in unused slots stays visible
+with a warning. Both helpers accept `{ routes }`; the editor also accepts
+`accent`. Use the host's Payload routes and the plugin's `theme.accent`.
+
+#### Wiring Puck by hand
+
+The separate pieces stay exported:
+
+- `/puck`: `ExperimentSlot`, `createExperimentSlot({ routes })`,
+  `EXPERIMENT_SLOT_TYPE` and `createExperimentSlotField({ routes })`.
+- `/puck/editor`: `ExperimentSlotEditor`,
+  `createExperimentSlotEditor({ routes, accent })` and `experimentOutlinePlugin()`.
+
+Register the render and editor blocks under the same `EXPERIMENT_SLOT_TYPE` key (import it from `/puck`),
+add a sidebar category listing it, and add `experimentOutlinePlugin()` to Puck's
+`plugins`. It composes with the host's outline override.
+
+Routes default to Payload's `/admin` and `/api` when omitted. The existing
+`ExperimentSlot` and `ExperimentSlotEditor` exports remain available with these
+defaults. Hosts on non-default routes switch to the factories. The standalone
+`createExperimentSlotField({ routes })` also accepts the host's routes.
+
+Pass the same accent as the plugin's `theme.accent`: the editor cannot read
+Payload config. Both use the same validator and report the same error for an
+invalid colour. Without an accent the editor uses the neutral palette.
+
 Load the editor stylesheet inside the Puck iframe. With Tailwind v4, add the
 package import **after** Tailwind in the CSS that builds your editor iframe
 stylesheet (the stylesheet listed in payload-puck's `editorStylesheets`):
@@ -648,6 +758,15 @@ The editor CSS includes its own light and dark palette, selected by
 `data-theme="dark"` or the `dark` class on the iframe's `<html>`. The client component's CSS import alone
 does not reach an iframe configured with `syncHostStyles: false`.
 
+If Puck runs outside Payload's admin, the page needs Payload's admin styles (the plugin's tokens map onto them) and the plugin's admin styles, plus `data-theme="light"` or `data-theme="dark"` on `<html>`. Inside the admin all of this is already in place:
+
+```css
+@import "@payloadcms/next/css";
+@import "@payloadcms/ui/styles.css";
+@import "@delmaredigital/payload-experiments/admin/theme.css";
+@import "@delmaredigital/payload-experiments/admin/ui.css";
+```
+
 Resolve the Puck data on the server with `resolveExperimentData` before
 rendering it. The render component shows only the selected group's slot. The
 editor lets you select a block experiment, edit each group's content, copy the
@@ -757,3 +876,35 @@ The WCAG 2.x gate requires at least 4.5:1 **foreground text on the accent fill**
 in each theme (the accent is used as a fill, not as page text). A failing
 colour is refused with its ratio. Status chips retain Payload semantic colours.
 `deriveAccent` is also exported from `/puck/editor` for editor integrations.
+
+## Click goals
+
+Click goals use a goal's short name as their key (`click:<short-name>`). Add
+`xpGoalField()` from the root entry to a host block or array row. Its manager
+picker includes inline creation with "+ New click goal"; run
+`payload generate:importmap` to register the picker. For Puck's `xpGoal` prop,
+use `xpGoalPuckEditorField()` from `/puck/editor` in your editor config and
+`xpGoalPuckField()` from `/puck` in your render config. Run the
+host's `payload migrate:create`: each table using the Payload field (and its
+version table) gains a nullable text column. Render the value on the actual
+interactive element as `data-xp-goal={xpGoal}`; code can also set
+`data-xp-goal="join"` directly. Define a click goal with that short name first.
+For managers, an undefined key blocks the save through the Payload field's
+server validation, refreshing a cached miss immediately.
+Draft saves are also refused when the collection validates drafts
+(`versions.drafts.validate`). Editors without goal-management access see a
+plain text input. Goals in
+related documents and keys placed only in code are invisible to the content
+fairness check.
+
+`ExperimentsProvider` records native clicks when its server assignments arm
+click goals. Nested providers share one document listener; the deepest armed
+provider supplies the route and pageview id. Enter on links/buttons and Space
+on buttons count through the browser's native click. A focusable `div` needs
+`role="button"` and the host's own keyboard handler. Beacons use `sendBeacon`
+(with a keepalive fallback) so navigation/unload does not discard the click.
+Click and exposure beacons share `events.rateLimit`; size the adapter for both.
+New click goals are accepted within 30 seconds. A click goal may be primary;
+primary and guardrail goals must appear in every tested version or outside all
+of them. Secondary asymmetry warns, and results health checks published rows
+again on every run.

package/dist/admin/MetricSourceSelect.js

@@ -1,14 +1,14 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { SelectInput, useField } from '@payloadcms/ui';
-import { metricSourceHint, metricSourceOptions } from './metricSource.model.js';
+import { metricSourceHint, metricSourceOptions, sourceFor } from './metricSource.model.js';
 import { METRICS_COPY } from './copy/metrics.js';
 export function MetricSourceSelect({ path, field, readOnly }) {
     const { value, setValue } = useField({
         path
     });
     const sources = field.admin?.custom?.sources ?? [];
-    const hint = metricSourceHint(sources.find((source)=>source.id === value));
+    const hint = metricSourceHint(sourceFor(value, sources));
     const locked = Boolean(readOnly || field.admin?.readOnly);
     return /*#__PURE__*/ _jsxs("div", {
         children: [
@@ -19,7 +19,7 @@ export function MetricSourceSelect({ path, field, readOnly }) {
                 description: field.admin?.description,
                 required: field.required,
                 options: metricSourceOptions(sources),
-                value: value ?? '',
+                value: sourceFor(value, sources)?.id ?? value ?? '',
                 readOnly: locked,
                 onChange: (option)=>{
                     if (!locked) setValue(option && !Array.isArray(option) ? option.value : null);

package/dist/admin/PlacementStatus.d.ts

@@ -0,0 +1,3 @@
+import type { UIFieldClientProps } from 'payload';
+/** Manage-only endpoint: access-filtered editors see no status or error text. */
+export declare function PlacementStatus(_props: UIFieldClientProps): import("react").JSX.Element;

package/dist/admin/PlacementStatus.js

@@ -0,0 +1,54 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useConfig, useDocumentInfo } from '@payloadcms/ui';
+import { useEffect, useMemo, useState } from 'react';
+import { formatAdminURL } from 'payload/shared';
+import { createApi } from './api.js';
+import { pageStatusCopy } from './placementStatus.model.js';
+/** Manage-only endpoint: access-filtered editors see no status or error text. */ export function PlacementStatus(_props) {
+    const { id, collectionSlug } = useDocumentInfo();
+    const { config } = useConfig();
+    const api = useMemo(()=>createApi(config.routes.api), [
+        config.routes.api
+    ]);
+    const [tests, setTests] = useState([]);
+    useEffect(()=>{
+        let active = true;
+        setTests([]);
+        if (id != null && collectionSlug) void api.placementStatus({
+            docs: [
+                {
+                    collection: collectionSlug,
+                    id
+                }
+            ]
+        }).then((result)=>{
+            if (active && result.ok) setTests(result.data?.docs[`${collectionSlug}:${id}`]?.tests ?? []);
+        });
+        return ()=>{
+            active = false;
+        };
+    }, [
+        api,
+        collectionSlug,
+        id
+    ]);
+    return /*#__PURE__*/ _jsx(_Fragment, {
+        children: tests.map((test)=>{
+            const copy = pageStatusCopy(test);
+            return copy ? /*#__PURE__*/ _jsxs("p", {
+                children: [
+                    copy,
+                    ' ',
+                    /*#__PURE__*/ _jsx("a", {
+                        href: formatAdminURL({
+                            adminRoute: config.routes.admin,
+                            path: `/experiments/by-slug/${encodeURIComponent(test.slug)}`
+                        }),
+                        children: "Back to the test"
+                    })
+                ]
+            }, test.slug) : null;
+        })
+    });
+}

package/dist/admin/PreviewLinks.d.ts

@@ -1,6 +1,7 @@
 import type { DocId } from '../types/contracts.js';
 import type { PreflightResult } from '../types/endpoints.js';
-export declare function PreviewLinks({ experimentId, placements, arms, flagPoint }: {
+export declare function PreviewLinks({ experimentId, placements, arms, flagPoint, apiRoute }: {
+    apiRoute: string;
     flagPoint?: string;
     experimentId: DocId;
     placements: PreflightResult['placements'];

package/dist/admin/PreviewLinks.js

@@ -5,10 +5,11 @@ import { Button } from '../ui/Button.js';
 import { armLabel } from './labels.js';
 import { useApi } from './useApi.js';
 import { REVIEW_COPY as C } from './copy/review.js';
-import { API_MESSAGES } from './copy/common.js';
-import { previewPages } from './previewLinks.model.js';
-export function PreviewLinks({ experimentId, placements, arms, flagPoint }) {
-    const api = useApi();
+import { TEST_PAGE } from './copy/testPage.js';
+import { API_MESSAGES, refusalMessage } from './copy/common.js';
+import { actionablePreviewPages } from './previewLinks.model.js';
+export function PreviewLinks({ experimentId, placements, arms, flagPoint, apiRoute }) {
+    const api = useApi(apiRoute);
     const inFlight = useRef(false);
     const [busy, setBusy] = useState(false);
     const [error, setError] = useState(null);
@@ -17,20 +18,37 @@ export function PreviewLinks({ experimentId, placements, arms, flagPoint }) {
         inFlight.current = true;
         setBusy(true);
         setError(null);
+        let win = null;
         try {
+            win = window.open('', '_blank');
+            if (!win) {
+                setError(C.previewBlocked);
+                return;
+            }
+            // Clearing opener immediately gives the same opener protection as noopener: the
+            // previewed page cannot reach window.opener. The admin URL may be sent as
+            // referrer to the host's own site (resolved against location.origin); accepted.
+            try {
+                win.opener = null;
+            } catch  {}
             const result = await api.previewToken(experimentId, arm);
+            // The person closed the blank tab while the token loaded: nothing to show or report.
+            if (win.closed) return;
             if (!result.ok) {
-                setError(result.message);
+                win.close();
+                setError(result.status === 0 ? API_MESSAGES.network : refusalMessage(result.code, result.status));
                 return;
             }
-            if (!result.data?.token) {
+            if (typeof result.data?.token !== 'string' || !result.data.token) {
+                win.close();
                 setError(API_MESSAGES.unreadable);
                 return;
             }
             const target = new URL(url, window.location.origin);
             target.searchParams.set('xp_preview', result.data.token);
-            window.open(target.href, '_blank', 'noopener,noreferrer');
+            win.location.replace(target.href);
         } catch  {
+            win?.close();
             setError(API_MESSAGES.failed);
         } finally{
             inFlight.current = false;
@@ -40,7 +58,7 @@ export function PreviewLinks({ experimentId, placements, arms, flagPoint }) {
     return /*#__PURE__*/ _jsxs("div", {
         className: "xp-preview-links",
         children: [
-            previewPages(placements, flagPoint).map((placement)=>/*#__PURE__*/ _jsxs("div", {
+            actionablePreviewPages(placements, flagPoint).map((placement)=>/*#__PURE__*/ _jsxs("div", {
                     className: "xp-preview-row",
                     children: [
                         /*#__PURE__*/ _jsxs("p", {
@@ -49,26 +67,29 @@ export function PreviewLinks({ experimentId, placements, arms, flagPoint }) {
                                 placement.slotCount > 1 ? ` ${C.placedTimes(placement.slotCount)}` : null
                             ]
                         }),
-                        /*#__PURE__*/ _jsx("div", {
+                        /*#__PURE__*/ _jsxs("div", {
                             className: "xp-ui-button-group",
-                            children: placement.url ? arms.filter((arm)=>arm.kind !== 'holdout' && arm.key !== 'holdout').map((arm)=>/*#__PURE__*/ _jsxs(Button, {
-                                    variant: "secondary",
+                            children: [
+                                placement.url ? arms.filter((arm)=>arm.kind !== 'holdout' && arm.key !== 'holdout').map((arm)=>/*#__PURE__*/ _jsxs(Button, {
+                                        variant: "secondary",
+                                        size: "sm",
+                                        disabled: busy,
+                                        onClick: ()=>{
+                                            void preview(placement.url, arm.key);
+                                        },
+                                        children: [
+                                            C.preview,
+                                            " ",
+                                            arm.label?.trim() || armLabel(arm.key)
+                                        ]
+                                    }, arm.key)) : null,
+                                placement.editorUrl ? /*#__PURE__*/ _jsx(Button, {
+                                    variant: "link",
                                     size: "sm",
-                                    disabled: busy,
-                                    onClick: ()=>{
-                                        void preview(placement.url, arm.key);
-                                    },
-                                    children: [
-                                        C.preview,
-                                        " ",
-                                        arm.label?.trim() || armLabel(arm.key)
-                                    ]
-                                }, arm.key)) : /*#__PURE__*/ _jsx(Button, {
-                                variant: "secondary",
-                                size: "sm",
-                                disabled: true,
-                                children: C.noPreview
-                            })
+                                    href: placement.editorUrl,
+                                    children: TEST_PAGE.editOnPage
+                                }) : null
+                            ]
                         })
                     ]
                 }, placement.key)),

package/dist/admin/TestsNavLink.d.ts

@@ -1,3 +1,5 @@
 import './theme.css';
-declare function TestsNav(): import("react").JSX.Element | null;
+declare function TestsNav({ isOpen }: {
+    isOpen?: boolean;
+}): import("react").JSX.Element | null;
 export { TestsNav as TestsNavLink };

package/dist/admin/TestsNavLink.js

@@ -5,7 +5,7 @@ import { Link, NavGroup, useAuth, useConfig } from '@payloadcms/ui';
 import { formatAdminURL } from 'payload/shared';
 import { usePathname } from 'next/navigation.js';
 import { SURFACE_COPY } from './copy/surface.js';
-function TestsNav() {
+function TestsNav({ isOpen = true }) {
     const { config } = useConfig();
     const { permissions } = useAuth();
     const pathname = usePathname();
@@ -38,9 +38,9 @@ function TestsNav() {
             active: goalsActive
         }
     ];
-    // getPreference is async and can fetch; let NavGroup default to open.
     return /*#__PURE__*/ _jsx(NavGroup, {
         label: SURFACE_COPY.title,
+        isOpen: isOpen,
         children: entries.map((entry)=>{
             const props = {
                 className: 'nav__link',

package/dist/admin/actions/ConfirmDialog.d.ts

@@ -8,7 +8,8 @@ export declare function DialogFrame({ title, onClose, children, initialFocus, di
     onClose: () => void;
     children: ReactNode;
 }): import("react").JSX.Element;
-export declare function ConfirmDialog({ id, action, winnerLabel, onClose, canManage, isDecided }: {
+export declare function ConfirmDialog({ id, action, winnerLabel, onClose, canManage, isDecided, apiRoute }: {
+    apiRoute: string;
     canManage?: boolean;
     isDecided?: boolean;
     id: DocId;

package/dist/admin/actions/ConfirmDialog.js

@@ -20,8 +20,8 @@ export function DialogFrame({ title, onClose, children, initialFocus, dismissibl
         children: children
     });
 }
-export function ConfirmDialog({ id, action, winnerLabel, onClose, canManage = false, isDecided = false }) {
-    const api = useApi();
+export function ConfirmDialog({ id, action, winnerLabel, onClose, canManage = false, isDecided = false, apiRoute }) {
+    const api = useApi(apiRoute);
     const [typed, setTyped] = useState('');
     const [busy, setBusy] = useState(false);
     const [reportBusy, setReportBusy] = useState(false);

package/dist/admin/actions/DecideDialog.d.ts

@@ -1,7 +1,8 @@
 import type { DocId } from '../../types/contracts.js';
 import type { PreflightResult } from '../../types/endpoints.js';
 import type { ActionGroup } from './actions.model.js';
-export declare function DecideDialog({ id, arms, checks, onClose }: {
+export declare function DecideDialog({ id, arms, checks, onClose, apiRoute }: {
+    apiRoute: string;
     id: DocId;
     arms: readonly ActionGroup[];
     checks?: PreflightResult['checks'];

package/dist/admin/actions/DecideDialog.js

@@ -10,8 +10,8 @@ import { RESULTS_COPY } from '../copy/results.js';
 import { ACTIONS_COPY as C, decideCopy } from '../copy/actions.js';
 import { decideState } from './decide.model.js';
 import { DialogFrame } from './ConfirmDialog.js';
-export function DecideDialog({ id, arms, checks = [], onClose }) {
-    const api = useApi();
+export function DecideDialog({ id, arms, checks = [], onClose, apiRoute }) {
+    const api = useApi(apiRoute);
     const [snapshot, setSnapshot] = useState(null);
     const [chosenArm, setChosenArm] = useState(null);
     const [note, setNote] = useState('');

package/dist/admin/api.d.ts

@@ -1,5 +1,5 @@
 import type { DocId } from '../types/contracts.js';
-import type { RestoreContentEntryBody, RestoreContentEntryResult, DismissContentEntryBody, DismissContentEntryResult, AddMetricBody, AllocateBody, ArchiveBody, DecideBody, MakeContentResult, PreflightResult, PreviewTokenResult, RefusalCode, ResultsResponse, SummaryResponse, TransitionSuccess } from '../types/endpoints.js';
+import type { WrapBlockBody, PagesResult, PlacementStatusBody, PlacementStatusResult, RestoreContentEntryBody, RestoreContentEntryResult, DismissContentEntryBody, DismissContentEntryResult, AddMetricBody, AllocateBody, ArchiveBody, DecideBody, MakeContentResult, AddMetricResult, ClickKeysResult, PreflightResult, PreviewTokenResult, RefusalCode, ResultsResponse, SummaryResponse, TransitionSuccess } from '../types/endpoints.js';
 import { refusalMessage } from './copy/common.js';
 export type ApiResult<T> = {
     ok: true;
@@ -13,9 +13,17 @@ export type ApiResult<T> = {
 };
 type RequestOptions = NonNullable<Parameters<typeof refusalMessage>[3]>;
 export declare function createApi(apiBase: string): {
+    wrapBlock: (body: WrapBlockBody) => Promise<ApiResult<Record<string, unknown>>>;
+    pages: (query: {
+        collection: string;
+        q?: string;
+        path?: string;
+        page?: number;
+    }, signal?: AbortSignal) => Promise<ApiResult<PagesResult>>;
+    placementStatus: (body: PlacementStatusBody) => Promise<ApiResult<PlacementStatusResult>>;
     start: (id: DocId) => Promise<ApiResult<TransitionSuccess>>;
     allocate: (id: DocId, body: AllocateBody, options?: RequestOptions) => Promise<ApiResult<TransitionSuccess>>;
-    addMetric: (id: DocId, body: AddMetricBody, options?: RequestOptions) => Promise<ApiResult<TransitionSuccess>>;
+    addMetric: (id: DocId, body: AddMetricBody, options?: RequestOptions) => Promise<ApiResult<AddMetricResult>>;
     stop: (id: DocId) => Promise<ApiResult<TransitionSuccess>>;
     decide: (id: DocId, body: DecideBody) => Promise<ApiResult<TransitionSuccess>>;
     releaseHoldout: (id: DocId) => Promise<ApiResult<TransitionSuccess>>;
@@ -24,6 +32,7 @@ export declare function createApi(apiBase: string): {
     dismissContentEntry: (id: DocId, body: DismissContentEntryBody) => Promise<ApiResult<DismissContentEntryResult>>;
     restoreContentEntry: (id: DocId, body: RestoreContentEntryBody) => Promise<ApiResult<RestoreContentEntryResult>>;
     archive: (id: DocId, body: ArchiveBody) => Promise<ApiResult<TransitionSuccess>>;
+    clickKeys: (id: DocId) => Promise<ApiResult<ClickKeysResult>>;
     preflight: (id: DocId) => Promise<ApiResult<PreflightResult>>;
     previewToken: (id: DocId, arm: string) => Promise<ApiResult<PreviewTokenResult>>;
     results: (id: DocId, options?: {