@delmaredigital/payload-experiments 0.3.0-rc.4 → 0.4.0-rc.2

package/dist/types/endpoints.d.ts

@@ -7,7 +7,7 @@ import type { Snapshot, VerdictCode } from './snapshot.js';
 export type ArmIssueCode = 'weights-total' | 'control-count' | 'control-first' | 'holdout-last' | 'holdout-count' | 'variant-count' | 'duplicate-key' | 'duplicate-slot' | 'slot-required' | 'invalid-key';
 /** Content-report dismiss/restore refusals (CORE-44). */
 export type ContentEntryRefusal = 'not-decided' | 'entry-not-found' | 'entry-ok' | 'entry-dismissed' | 'entry-not-dismissed';
-export type RefusalCode = ArmIssueCode | 'not-found' | ContentEntryRefusal | 'no-planned-duration' | 'no-primary-metric' | 'no-placements' | 'empty-slot' | 'page-in-use' | 'page-no-targets' | 'page-target-unpublished' | 'page-user-unit' | 'version-page-unavailable' | 'version-page-unchecked' | 'flag-no-point' | 'flag-params-invalid' | 'flag-point-busy' | 'flag-placement-missing' | 'layer-full' | 'layer-unit-mismatch' | 'unknown-metric-source' | 'unit-source-mismatch' | 'no-reach-per-day' | 'invalid-status' | 'stale-draft' | 'stale-edit' | 'commit-unverified' | 'allocation-lower' | 'confirmation-required' | 'invalid-winner' | 'slices-taken' | 'locked-placement' | 'not-implemented' | 'forbidden' | 'unauthenticated' | 'body-too-large' | 'invalid-body' | 'too-many-ids' | 'invalid-phase' | 'invalid-ids' | 'recompute-failed' | 'analysis-failed' | 'undeclared-targeting-key' | 'invalid-targeting-rule' | 'block-path-rule' | 'duplicate-metric';
+export type RefusalCode = ArmIssueCode | 'goal-in-some-versions' | 'placement-unchecked' | 'placement-unpublished' | 'duplicate-version-row' | 'interacting-tests' | 'placements-changed' | 'page-busy' | 'wrap-target-missing' | 'version-identical' | 'version-same-address' | 'unknown-collection' | 'not-found' | ContentEntryRefusal | 'no-planned-duration' | 'no-primary-metric' | 'no-placements' | 'placement-removed' | 'empty-slot' | 'page-in-use' | 'page-no-targets' | 'page-target-unpublished' | 'page-user-unit' | 'version-page-unavailable' | 'version-page-unchecked' | 'flag-no-point' | 'flag-params-invalid' | 'flag-point-busy' | 'flag-placement-missing' | 'layer-full' | 'layer-unit-mismatch' | 'unknown-metric-source' | 'unit-source-mismatch' | 'no-reach-per-day' | 'invalid-status' | 'stale-draft' | 'stale-edit' | 'commit-unverified' | 'allocation-lower' | 'confirmation-required' | 'invalid-winner' | 'slices-taken' | 'locked-placement' | 'not-implemented' | 'forbidden' | 'unauthenticated' | 'body-too-large' | 'invalid-body' | 'too-many-ids' | 'invalid-phase' | 'invalid-ids' | 'recompute-failed' | 'analysis-failed' | 'undeclared-targeting-key' | 'invalid-targeting-rule' | 'block-path-rule' | 'duplicate-metric';
 export type ErrorEnvelope = {
     errors: Array<{
         code: RefusalCode;
@@ -22,6 +22,13 @@ export type TransitionSuccess = {
 export type AllocateBody = {
     allocation: number;
 };
+export type AddMetricWarning = {
+    code: 'goal-in-some-versions' | 'goal-added-mid-test' | 'placement-unchecked';
+    detail?: unknown;
+};
+export type AddMetricResult = TransitionSuccess & {
+    warnings: AddMetricWarning[];
+};
 export type AddMetricBody = {
     metric: DocId;
     role: 'secondary' | 'guardrail';
@@ -57,12 +64,27 @@ export type MakeContentResult = TransitionSuccess & {
     }>;
 };
 export type PreflightResult = {
+    goalNotes?: Array<{
+        metricId: DocId;
+        message: string;
+    }>;
     checks: Array<{
         code: ReadinessCode;
         ok: boolean;
         detail?: unknown;
         warning?: boolean;
     }>;
+    pagePlacements?: Array<{
+        arm: string;
+        path: string;
+        collection?: string;
+        id?: DocId | null;
+        title?: string;
+        published: boolean;
+        slug?: string;
+        url?: string;
+        editorUrl?: string;
+    }>;
     placements: Array<{
         collection: string;
         id: DocId;
@@ -104,6 +126,7 @@ export interface PhaseSummary {
         name: string;
         kind: MetricSource['kind'];
         role: 'primary' | 'secondary' | 'guardrail';
+        clickGoal?: true;
         resolvedCap?: number | null;
         historyUnits?: number;
         capNotice?: 'no-history';
@@ -137,10 +160,7 @@ export type SummaryResponse = Record<DocId, {
         code: ReadinessCode;
         detail?: unknown;
     };
-    health?: Array<{
-        code: 'version-page-unavailable' | 'version-page-unchecked';
-        path: string;
-    }>;
+    health?: import('./snapshot.js').SnapshotHealth[];
     exposures: number;
     days: number;
     verdict: {
@@ -174,3 +194,70 @@ export type EndpointContext<TUser extends {
         visitorId: string;
     };
 };
+export type ClickKeysResult = {
+    keys: Array<{
+        key: string;
+        arms: string[];
+        label: string;
+    }>;
+};
+export type PagesResult = {
+    docs: Array<{
+        id: DocId;
+        title: string;
+        path: string | null;
+        pathKey: string | null;
+        published: boolean;
+    }>;
+    hasNextPage: boolean;
+};
+export type PlacementStatusBody = {
+    docs?: Array<{
+        collection: string;
+        id: DocId;
+    }>;
+    slugs?: string[];
+};
+export type PageTestStatus = {
+    slug: string;
+    name: string;
+    status: Status;
+    role: 'original' | 'version';
+    winner: boolean;
+    armLabel: string;
+    winnerLabel?: string;
+    winnerTitle?: string;
+    winnerPath?: string;
+    originalPath?: string;
+    rollout: boolean;
+    pagesReleased: boolean;
+};
+export type PlacementStatusResult = {
+    docs: Record<string, {
+        path: string | null;
+        tests: PageTestStatus[];
+    }>;
+    slugs: Record<string, {
+        missing: true;
+    } | {
+        deleted: true;
+    } | {
+        name: string;
+        status: Status;
+        kind: ExperimentKind;
+        arms: Array<{
+            key: string;
+            label: string;
+            slot?: string;
+        }>;
+        winnerArm?: string;
+        rollout: boolean;
+    }>;
+};
+export type WrapBlockBody = {
+    collection: string;
+    id: DocId;
+    field: string;
+    blockId: string;
+    experiment: string;
+};

package/dist/types/index.d.ts

@@ -7,3 +7,6 @@ export * from './admin.js';
 export * from './endpoints.js';
 export * from './snapshot.js';
 export * from './reasons.js';
+export type { HostBlock, ExperimentBlock, ExperimentBlockGroup, ResolvedHostBlock, ResolvedExperimentBlocks } from '../blocks/model.js';
+export type { WrapBlockBody } from './endpoints.js';
+export type { SnapshotHealth } from './snapshot.js';

package/dist/types/puck.d.ts

@@ -1,5 +1,5 @@
 import type { DocId } from './contracts.js';
-import type { Slot } from '@puckeditor/core';
+import type { ComponentConfig, Config, Plugin, Slot } from '@puckeditor/core';
 export type { Slot } from '@puckeditor/core';
 export type ArmSlot = 'control' | 'variantA' | 'variantB' | 'variantC';
 export type ExperimentRef = {
@@ -21,3 +21,9 @@ export type ExperimentSlotProps = {
     };
 };
 export declare const EXPERIMENT_SLOT_TYPE: "ExperimentSlot";
+export interface ExperimentsPuckIntegration {
+    name: string;
+    components: Record<string, ComponentConfig<ExperimentSlotProps>>;
+    categories: Config['categories'];
+    plugins?: readonly Plugin[];
+}

package/dist/types/snapshot.d.ts

@@ -1,3 +1,18 @@
+export type SnapshotHealth = {
+    code: 'version-page-unavailable' | 'version-page-unchecked';
+    path: string;
+} | {
+    code: 'goal-in-some-versions';
+    metricId: string | number;
+    name: string;
+} | {
+    code: 'placement-unchecked';
+    detail: {
+        collection?: string;
+        id?: string | number;
+        path?: string;
+    };
+};
 import type { GaussianPrior } from '@delmaredigital/experiments-stats';
 import type { DocId, MetricSource } from './contracts.js';
 import type { MetricUnavailableReason } from './reasons.js';
@@ -108,10 +123,8 @@ export interface Snapshot {
         guardrailLine?: string;
         worstArm?: string;
     };
-    health?: Array<{
-        code: 'version-page-unavailable' | 'version-page-unchecked';
-        path: string;
-    }>;
+    goalFairnessNotice?: string;
+    health?: SnapshotHealth[];
     contentChanges: Array<{
         at: string;
         doc: {

package/dist/types/surface.d.ts

@@ -7,6 +7,9 @@ export interface TestsSurfaceProps {
     returnToTest?: string;
     adminRoute: string;
     apiRoute: string;
+    collectionTitles?: Record<string, string>;
+    userId?: string | number;
+    userCollection?: string;
     isAdmin: boolean;
     pages?: Array<{
         collection: string;
@@ -14,6 +17,15 @@ export interface TestsSurfaceProps {
         id: DocId;
         title: string;
         editorUrl: string;
+        editor: 'puck' | 'blocks';
+    }>;
+    pageCollections?: Array<{
+        slug: string;
+        label: string;
+        contentChecks: boolean;
+        copyHint?: string;
+        copyUrl?: string;
+        copyLabel?: string;
     }>;
     canManage: boolean;
     canReadResults: boolean;
@@ -22,6 +34,7 @@ export interface TestsSurfaceProps {
     metricSources: SerializedMetricSource[];
     admin?: {
         descriptions?: {
+            page?: string;
             block?: string;
             document?: string;
             setting?: string;

package/dist/ui/ui.css

@@ -74,6 +74,10 @@
 .xp-ui-chips p:not(.xp-ui-error) { margin: 0; color: var(--xp-text-muted); font-size: var(--xp-font-size-small); }
 /* Quiet actions and breadcrumb links stay neutral; only the selected tab takes the text accent. */
 .xp-ui-button-group { display: flex; flex-wrap: wrap; gap: 8px; min-width: 0; max-width: 100%; }
+.xp-ui-inline-row { display: flex; flex-wrap: wrap; align-items: end; gap: var(--xp-space-3); min-width: 0; }
+.xp-ui-inline-row > .xp-ui-field { flex: 1 1 auto; min-width: 0; }
+.xp-ui-inline-row > .xp-ui-button { flex: 0 0 auto; }
+.xp-ui-subpanel { display: grid; gap: var(--xp-space-3); border: 1px solid var(--xp-border); border-radius: var(--xp-radius-card); padding: var(--xp-space-4); }
 @media (prefers-reduced-motion: reduce) {
   .xp-ui-button, .xp-ui-input, .xp-ui-toggle, .xp-ui-toggle::before, .xp-ui-chips-control { transition: none; }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delmaredigital/payload-experiments",
-  "version": "0.3.0-rc.4",
+  "version": "0.4.0-rc.2",
   "description": "No-code A/B testing for Payload CMS and Next.js: block, page and flag experiments with holdouts, layers, exposure logging and honest statistics inside the admin — no vendor",
   "type": "module",
   "license": "MIT",
@@ -37,6 +37,12 @@
       "import": "./dist/exports/rsc.js",
       "default": "./dist/exports/rsc.js"
     },
+    "./blocks": {
+      "@delmaredigital/source": "./src/exports/blocks.ts",
+      "types": "./dist/exports/blocks.d.ts",
+      "import": "./dist/exports/blocks.js",
+      "default": "./dist/exports/blocks.js"
+    },
     "./client": {
       "@delmaredigital/source": "./src/exports/client.ts",
       "types": "./dist/exports/client.d.ts",
@@ -120,6 +126,7 @@
   },
   "homepage": "https://delmaredigital.com/developers",
   "devDependencies": {
+    "@delmaredigital/payload-puck": "0.10.3",
     "payload": "^3.90.2",
     "@payloadcms/db-postgres": "^3.90.2",
     "@payloadcms/ui": "^3.90.2",