@delmaredigital/payload-experiments 0.1.0-rc.7 → 0.2.0-rc.2

package/dist/admin/FlagPointSelect.js

@@ -1,54 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { SelectInput, useField, useForm, useFormFields } from '@payloadcms/ui';
-import { EDITABLE_BY_STATUS, isEditable } from '../collections/experiments/editability.js';
-import { lockedReason } from './lockedNotice.model.js';
-import { ARMS_COPY } from './copy/arms.js';
-import { readArms } from './arms/arms.model.js';
-export function FlagPointSelect({ field, path, readOnly }) {
-    const { value, setValue } = useField({
-        path
-    });
-    const form = useForm();
-    const status = useFormFields(([fields])=>fields.status?.value ?? 'draft');
-    const rowKinds = useFormFields(([fields])=>readArms(fields).map((arm)=>arm.kind).join(','));
-    const points = field.admin?.custom?.flagPoints ?? [];
-    const editable = isEditable(status, 'flagPoint') && !readOnly && !form.disabled;
-    const reason = lockedReason(status, 'flagPoint', EDITABLE_BY_STATUS);
-    return /*#__PURE__*/ _jsxs("div", {
-        className: "xp-flag-point",
-        children: [
-            /*#__PURE__*/ _jsx(SelectInput, {
-                path: path,
-                name: path,
-                label: ARMS_COPY.flagPoint,
-                options: points.map((point)=>({
-                        label: point.label,
-                        value: point.id
-                    })),
-                value: value ?? '',
-                readOnly: !editable,
-                onChange: (option)=>{
-                    if (!editable || Array.isArray(option)) return;
-                    const point = points.find((candidate)=>candidate.id === option?.value);
-                    if ((point?.id ?? '') === (value ?? '')) return;
-                    setValue(point?.id ?? '');
-                    rowKinds.split(',').forEach((kind, index)=>{
-                        if (kind === 'control' || kind === 'variant') form.dispatchFields({
-                            type: 'UPDATE',
-                            path: `arms.${index}.params`,
-                            value: kind === 'control' && point ? {
-                                ...point.effectiveDefaults
-                            } : {}
-                        });
-                    });
-                    form.setModified(true);
-                }
-            }),
-            reason ? /*#__PURE__*/ _jsx("p", {
-                className: "xp-locked-notice",
-                children: reason
-            }) : null
-        ]
-    });
-}

package/dist/admin/LockedFieldNotice.d.ts

@@ -1,2 +0,0 @@
-import type { FieldDescriptionClientProps } from 'payload';
-export declare function LockedFieldNotice(props: FieldDescriptionClientProps): import("react").JSX.Element;

package/dist/admin/LockedFieldNotice.js

@@ -1,26 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { FieldDescription, useDocumentInfo, useFormFields } from '@payloadcms/ui';
-import { EDITABLE_BY_STATUS } from '../collections/experiments/editability.js';
-import { lockedReason } from './lockedNotice.model.js';
-export function LockedFieldNotice(props) {
-    const status = useFormFields(([fields])=>fields.status?.value);
-    const { id } = useDocumentInfo();
-    const admin = props.field.admin;
-    const description = admin && 'description' in admin ? admin.description : undefined;
-    const customField = admin?.custom?.field;
-    const field = typeof customField === 'string' ? customField : props.path.split('.')[0];
-    const reason = id != null && status ? lockedReason(status, field, EDITABLE_BY_STATUS) : null;
-    return /*#__PURE__*/ _jsxs(_Fragment, {
-        children: [
-            /*#__PURE__*/ _jsx(FieldDescription, {
-                description: description,
-                path: props.path
-            }),
-            reason ? /*#__PURE__*/ _jsx("p", {
-                className: "xp-locked-notice",
-                children: reason
-            }) : null
-        ]
-    });
-}

package/dist/admin/PhaseHistory.d.ts

@@ -1,2 +0,0 @@
-import type { UIFieldClientProps } from 'payload';
-export declare function PhaseHistory(_props: UIFieldClientProps): import("react").JSX.Element | null;

package/dist/admin/PhaseHistory.js

@@ -1,76 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useConfig, useDocumentInfo, useFormFields } from '@payloadcms/ui';
-import { useEffect, useState } from 'react';
-import { phaseHistory } from './phaseHistory.model.js';
-import { HISTORY_COPY } from './copy/history.js';
-export function PhaseHistory(_props) {
-    const { id, data } = useDocumentInfo();
-    const { config } = useConfig();
-    const api = config.routes.api;
-    const decidedBy = useFormFields(([fields])=>{
-        const decision = fields.decision?.value;
-        return fields['decision.decidedBy']?.value ?? (decision && typeof decision === 'object' && 'decidedBy' in decision ? decision.decidedBy : undefined);
-    }) ?? data?.decision?.decidedBy;
-    const [state, setState] = useState(null);
-    const key = `${api}:${id}`;
-    useEffect(()=>{
-        setState(null);
-        if (id == null) return;
-        const controller = new AbortController();
-        async function load() {
-            const docs = [];
-            let page = 1;
-            while(!controller.signal.aborted){
-                const query = new URLSearchParams({
-                    depth: '0',
-                    sort: 'phase,startedAt',
-                    limit: '100',
-                    page: String(page),
-                    'where[experiment][equals]': String(id)
-                });
-                const response = await fetch(`${api}/xp-phases?${query}`, {
-                    credentials: 'include',
-                    signal: controller.signal
-                });
-                if (!response.ok) {
-                    if (!controller.signal.aborted) setState(null);
-                    return;
-                }
-                const result = await response.json();
-                docs.push(...result.docs);
-                if (!result.hasNextPage) break;
-                page++;
-            }
-            if (!controller.signal.aborted) setState({
-                key,
-                docs
-            });
-        }
-        void load().catch(()=>{
-            if (!controller.signal.aborted) setState(null);
-        });
-        return ()=>controller.abort();
-    }, [
-        api,
-        id,
-        key
-    ]);
-    if (id == null || state?.key !== key) return null;
-    const history = phaseHistory(state.docs, {
-        decidedBy
-    });
-    return /*#__PURE__*/ _jsxs("section", {
-        "aria-label": HISTORY_COPY.rounds,
-        children: [
-            /*#__PURE__*/ _jsx("ul", {
-                children: history.rows.map((row)=>/*#__PURE__*/ _jsx("li", {
-                        children: row.text
-                    }, `${row.phase}-${row.phaseKind}`))
-            }),
-            history.decision ? /*#__PURE__*/ _jsx("p", {
-                children: history.decision
-            }) : null
-        ]
-    });
-}

package/dist/admin/StatusCell.d.ts

@@ -1,3 +0,0 @@
-import './styles.js';
-import type { DefaultCellComponentProps } from 'payload';
-export declare function StatusCell({ cellData, rowData }: DefaultCellComponentProps): import("react").JSX.Element;

package/dist/admin/StatusCell.js

@@ -1,19 +0,0 @@
-'use client';
-import { jsx as _jsx } from "react/jsx-runtime";
-import './styles.js';
-import { Pill } from '@payloadcms/ui';
-import { statusPill } from './status.model.js';
-export function StatusCell({ cellData, rowData }) {
-    const pill = statusPill({
-        status: cellData,
-        arms: rowData.arms,
-        decision: rowData.decision
-    });
-    return /*#__PURE__*/ _jsx("span", {
-        title: pill.tooltip,
-        children: /*#__PURE__*/ _jsx(Pill, {
-            className: `xp-status-pill xp-status-pill--${pill.tone}`,
-            children: pill.label
-        })
-    });
-}

package/dist/admin/SummaryCell.d.ts

@@ -1,2 +0,0 @@
-import type { DefaultCellComponentProps } from 'payload';
-export declare function SummaryCell({ rowData }: DefaultCellComponentProps): import("react").JSX.Element;

package/dist/admin/SummaryCell.js

@@ -1,32 +0,0 @@
-'use client';
-import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useState } from 'react';
-import { useApi } from './useApi.js';
-import { verdictCodeLabel } from './labels.js';
-import { summaryLine } from './copy/results.js';
-import { formatCount, formatNumber } from './results/format.js';
-import { requestSummary } from './summaryBatcher.js';
-export function SummaryCell({ rowData }) {
-    const api = useApi();
-    const id = rowData.id;
-    const [state, setState] = useState(null);
-    useEffect(()=>{
-        let active = true;
-        if (id !== undefined && id !== null) void requestSummary(api, id).then((entry)=>{
-            if (active) setState({
-                id,
-                entry
-            });
-        });
-        return ()=>{
-            active = false;
-        };
-    }, [
-        api,
-        id
-    ]);
-    const entry = state?.id === id ? state?.entry : null;
-    return /*#__PURE__*/ _jsx("span", {
-        children: entry ? summaryLine(formatCount(entry.exposures), formatNumber(entry.days), entry.verdict ? verdictCodeLabel(entry.verdict.code) : '—') : '—'
-    });
-}

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

@@ -1,6 +0,0 @@
-import type { DocId } from '../../types/contracts.js';
-export declare function AddMetricDialog({ id, attachedMetrics, onClose }: {
-    id: DocId;
-    attachedMetrics: readonly DocId[];
-    onClose: () => void;
-}): import("react").JSX.Element;

package/dist/admin/actions/AddMetricDialog.js

@@ -1,138 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useRef, useState } from 'react';
-import { Button, useConfig } from '@payloadcms/ui';
-import { DialogFrame } from './ConfirmDialog.js';
-import { useApi } from '../useApi.js';
-import { reloadPage } from '../reload.js';
-import { REVIEW_COPY as C } from '../copy/review.js';
-import { ACTIONS_COPY } from '../copy/actions.js';
-import { API_MESSAGES, refusalMessage } from '../copy/common.js';
-export function AddMetricDialog({ id, attachedMetrics, onClose }) {
-    const api = useApi();
-    const { config } = useConfig();
-    const [metrics, setMetrics] = useState([]);
-    const [loading, setLoading] = useState(true);
-    const [metric, setMetric] = useState('');
-    const [role, setRole] = useState('secondary');
-    const [busy, setBusy] = useState(false);
-    const inFlight = useRef(false);
-    const [error, setError] = useState(null);
-    useEffect(()=>{
-        const controller = new AbortController();
-        async function load() {
-            try {
-                const response = await fetch(`${config.routes.api.replace(/\/$/, '')}/xp-metrics?depth=0&limit=100`, {
-                    credentials: 'include',
-                    signal: controller.signal
-                });
-                if (!response.ok) throw new Error(refusalMessage(undefined, response.status));
-                const data = await response.json();
-                if (!Array.isArray(data.docs)) throw new Error(API_MESSAGES.unreadable);
-                if (!controller.signal.aborted) setMetrics(data.docs);
-            } catch (cause) {
-                if (!controller.signal.aborted) setError(cause instanceof Error ? cause.message : API_MESSAGES.network);
-            } finally{
-                if (!controller.signal.aborted) setLoading(false);
-            }
-        }
-        void load();
-        return ()=>controller.abort();
-    }, [
-        config.routes.api
-    ]);
-    const attached = new Set(attachedMetrics.map(String));
-    const available = metrics.filter((item)=>!attached.has(String(item.id)));
-    const selected = available.find((item)=>String(item.id) === metric);
-    async function submit() {
-        if (inFlight.current || loading || !selected) return;
-        inFlight.current = true;
-        setBusy(true);
-        setError(null);
-        const body = {
-            metric: selected.id,
-            role
-        };
-        const result = await api.addMetric(id, body);
-        if (result.ok) {
-            reloadPage();
-            return;
-        }
-        setError(result.message);
-        inFlight.current = false;
-        setBusy(false);
-    }
-    return /*#__PURE__*/ _jsxs(DialogFrame, {
-        title: C.addMetric,
-        onClose: ()=>{
-            if (!inFlight.current) onClose();
-        },
-        children: [
-            loading ? /*#__PURE__*/ _jsx("p", {
-                role: "status",
-                children: C.loadingMetrics
-            }) : null,
-            /*#__PURE__*/ _jsxs("label", {
-                children: [
-                    C.role,
-                    /*#__PURE__*/ _jsxs("select", {
-                        value: role,
-                        disabled: busy,
-                        onChange: (event)=>setRole(event.target.value),
-                        children: [
-                            /*#__PURE__*/ _jsx("option", {
-                                value: "secondary",
-                                children: C.supporting
-                            }),
-                            /*#__PURE__*/ _jsx("option", {
-                                value: "guardrail",
-                                children: C.guardrail
-                            })
-                        ]
-                    })
-                ]
-            }),
-            /*#__PURE__*/ _jsxs("label", {
-                children: [
-                    C.metric,
-                    /*#__PURE__*/ _jsxs("select", {
-                        value: metric,
-                        disabled: busy || loading,
-                        onChange: (event)=>setMetric(event.target.value),
-                        children: [
-                            /*#__PURE__*/ _jsx("option", {
-                                value: "",
-                                children: C.chooseMetric
-                            }),
-                            available.map((item)=>/*#__PURE__*/ _jsx("option", {
-                                    value: String(item.id),
-                                    children: item.name
-                                }, item.id))
-                        ]
-                    })
-                ]
-            }),
-            !loading && !error && !available.length ? /*#__PURE__*/ _jsx("p", {
-                children: C.noMetrics
-            }) : null,
-            error ? /*#__PURE__*/ _jsx("p", {
-                role: "alert",
-                children: error
-            }) : null,
-            /*#__PURE__*/ _jsx(Button, {
-                disabled: busy || loading || !selected,
-                onClick: ()=>{
-                    void submit();
-                },
-                children: C.addMetric
-            }),
-            /*#__PURE__*/ _jsx(Button, {
-                disabled: busy,
-                onClick: ()=>{
-                    if (!inFlight.current) onClose();
-                },
-                children: ACTIONS_COPY.cancel
-            })
-        ]
-    });
-}

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

@@ -1,6 +0,0 @@
-import type { DocId } from '../../types/contracts.js';
-export declare function AllocateDialog({ id, allocation: current, onClose }: {
-    id: DocId;
-    allocation: number;
-    onClose: () => void;
-}): import("react").JSX.Element;

package/dist/admin/actions/AllocateDialog.js

@@ -1,81 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useRef, useState } from 'react';
-import { Button } from '@payloadcms/ui';
-import { DialogFrame } from './ConfirmDialog.js';
-import { useApi } from '../useApi.js';
-import { reloadPage } from '../reload.js';
-import { REVIEW_COPY as C, REVIEW_HINTS } from '../copy/review.js';
-import { ACTIONS_COPY } from '../copy/actions.js';
-export function AllocateDialog({ id, allocation: current, onClose }) {
-    const api = useApi();
-    const [value, setValue] = useState(String(Math.min(100, current + 1)));
-    const [busy, setBusy] = useState(false);
-    const [error, setError] = useState(null);
-    const inFlight = useRef(false);
-    const allocation = Number(value);
-    const valid = value.trim() !== '' && Number.isInteger(allocation) && allocation > current && allocation <= 100;
-    async function submit() {
-        if (inFlight.current || !valid) return;
-        inFlight.current = true;
-        setBusy(true);
-        setError(null);
-        const body = {
-            allocation
-        };
-        const result = await api.allocate(id, body);
-        if (result.ok) {
-            reloadPage();
-            return;
-        }
-        setError(result.code === 'allocation-lower' ? REVIEW_HINTS['allocation-lower'] : result.message);
-        inFlight.current = false;
-        setBusy(false);
-    }
-    return /*#__PURE__*/ _jsxs(DialogFrame, {
-        title: C.raise,
-        onClose: ()=>{
-            if (!inFlight.current) onClose();
-        },
-        children: [
-            /*#__PURE__*/ _jsx("p", {
-                children: C.allocationBody
-            }),
-            /*#__PURE__*/ _jsxs("label", {
-                children: [
-                    C.allocation,
-                    /*#__PURE__*/ _jsx("input", {
-                        type: "number",
-                        min: current + 1,
-                        max: 100,
-                        step: 1,
-                        value: value,
-                        disabled: busy,
-                        onChange: (event)=>setValue(event.target.value)
-                    })
-                ]
-            }),
-            !valid ? /*#__PURE__*/ _jsx("p", {
-                children: C.allocationInvalid
-            }) : null,
-            error ? /*#__PURE__*/ _jsx("p", {
-                role: "alert",
-                children: error
-            }) : null,
-            /*#__PURE__*/ _jsx(Button, {
-                disabled: busy || !valid,
-                onClick: ()=>{
-                    void submit();
-                },
-                children: C.raise
-            }),
-            /*#__PURE__*/ _jsx(Button, {
-                disabled: busy,
-                onClick: ()=>{
-                    if (!inFlight.current) onClose();
-                },
-                children: ACTIONS_COPY.cancel
-            })
-        ]
-    });
-}

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

@@ -1,3 +0,0 @@
-import '../styles.js';
-import type { UIFieldClientProps } from 'payload';
-export declare function ExperimentActions(_props: UIFieldClientProps): import("react").JSX.Element | null;

package/dist/admin/actions/ExperimentActions.js

@@ -1,110 +0,0 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import '../styles.js';
-import { useState } from 'react';
-import { Button, useAuth, useDocumentInfo, useFormFields, useFormModified } from '@payloadcms/ui';
-import { canManage } from '../permissions.model.js';
-import { actionGroupLabel, availableActions } from './actions.model.js';
-import { ConfirmDialog } from './ConfirmDialog.js';
-import { DecideDialog } from './DecideDialog.js';
-import { ACTIONS_COPY } from '../copy/actions.js';
-import { AllocateDialog } from './AllocateDialog.js';
-import { AddMetricDialog } from './AddMetricDialog.js';
-const SAVE_FIRST = 'Save your changes first; these actions use the saved experiment.';
-export function ExperimentActions(_props) {
-    const { id } = useDocumentInfo();
-    const { permissions } = useAuth();
-    const status = useFormFields(([fields])=>fields.status?.value ?? 'draft');
-    const kind = useFormFields(([fields])=>fields.kind?.value ?? 'block');
-    // A primitive slice keeps unrelated form edits from rerendering this panel.
-    const groups = useFormFields(([fields])=>JSON.stringify(Object.keys(fields).filter((path)=>/^arms\.\d+\.(key|label|kind)$/.test(path)).sort().map((path)=>[
-                path,
-                fields[path]?.value
-            ])));
-    const armsByIndex = {};
-    for (const [path, value] of JSON.parse(groups)){
-        const [, index, field] = path.split('.');
-        const group = armsByIndex[index] ??= {
-            key: ''
-        };
-        group[field] = value;
-    }
-    const arms = Object.entries(armsByIndex).sort(([a], [b])=>Number(a) - Number(b)).map(([, group])=>group);
-    const winnerArm = useFormFields(([fields])=>fields['decision.winnerArm']?.value);
-    const holdoutReleasedAt = useFormFields(([fields])=>fields['decision.holdoutReleasedAt']?.value);
-    const contentReport = useFormFields(([fields])=>fields['decision.contentReport']?.value);
-    const allocation = useFormFields(([fields])=>fields.allocation?.value ?? 100);
-    const attachedMetricsJson = useFormFields(([fields])=>{
-        const relationId = (value)=>{
-            if (Array.isArray(value)) return value.flatMap(relationId);
-            if (typeof value === 'string' || typeof value === 'number') return [
-                value
-            ];
-            if (value && typeof value === 'object' && 'id' in value) return relationId(value.id);
-            return [];
-        };
-        return JSON.stringify([
-            'metrics.primary',
-            'metrics.secondary',
-            'metrics.guardrails'
-        ].flatMap((path)=>relationId(fields[path]?.value)));
-    });
-    const attachedMetrics = JSON.parse(attachedMetricsJson);
-    const [selected, setSelected] = useState(null);
-    // Transitions act on the saved document (and the typed phrase uses the saved group label), so unsaved edits block them.
-    const modified = useFormModified();
-    const actions = availableActions({
-        status,
-        kind,
-        arms,
-        decision: {
-            winnerArm,
-            holdoutReleasedAt,
-            contentReport
-        },
-        canManage: canManage(permissions)
-    });
-    const action = actions.find((candidate)=>candidate.id === selected);
-    if (id == null) return null;
-    const label = actionGroupLabel(winnerArm ?? 'control', arms.find((group)=>group.key === winnerArm)?.label);
-    return /*#__PURE__*/ _jsxs("div", {
-        className: "xp-actions",
-        children: [
-            modified && actions.length ? /*#__PURE__*/ _jsx("p", {
-                className: "xp-actions__note",
-                children: SAVE_FIRST
-            }) : null,
-            status === 'archived' || status === 'draft' ? /*#__PURE__*/ _jsx("p", {
-                className: "xp-actions__note",
-                children: status === 'archived' ? ACTIONS_COPY.deleteNoteArchived : ACTIONS_COPY.deleteNoteDraft
-            }) : null,
-            actions.map((item)=>/*#__PURE__*/ _jsx(Button, {
-                    buttonStyle: item.tone === 'primary' ? 'primary' : 'secondary',
-                    disabled: modified,
-                    className: `xp-action xp-action--${item.tone}`,
-                    onClick: ()=>{
-                        if (!modified) setSelected(item.id);
-                    },
-                    children: item.label
-                }, item.id)),
-            action?.id === 'allocate' ? /*#__PURE__*/ _jsx(AllocateDialog, {
-                id: id,
-                allocation: allocation,
-                onClose: ()=>setSelected(null)
-            }, `${id}/allocate`) : action?.id === 'add-metric' ? /*#__PURE__*/ _jsx(AddMetricDialog, {
-                id: id,
-                attachedMetrics: attachedMetrics,
-                onClose: ()=>setSelected(null)
-            }, `${id}/add-metric`) : action?.id === 'decide' ? /*#__PURE__*/ _jsx(DecideDialog, {
-                id: id,
-                arms: arms,
-                onClose: ()=>setSelected(null)
-            }, `${id}/decide`) : action ? /*#__PURE__*/ _jsx(ConfirmDialog, {
-                id: id,
-                action: action,
-                winnerLabel: label,
-                onClose: ()=>setSelected(null)
-            }, `${id}/${action.id}`) : null
-        ]
-    });
-}

package/dist/admin/arms/ArmsField.d.ts

@@ -1,2 +0,0 @@
-import type { ArrayFieldClientProps } from 'payload';
-export declare function ArmsField({ field, path, readOnly }: ArrayFieldClientProps): import("react").JSX.Element;