@kiryl.pekarski/payload-plugin-ab 1.0.0

package/README.md

@@ -0,0 +1,583 @@
+# payload-plugin-ab
+
+A/B testing plugin for [Payload CMS](https://payloadcms.com/) v3. Automatically maintains a **variant manifest** — a path-keyed map of A/B variant data — by hooking into Payload collection events. The manifest is designed to be read by Next.js middleware at the edge to route users to the correct variant without an additional database round-trip.
+
+## Table of Contents
+
+- [How It Works](#how-it-works)
+- [Key Features](#key-features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Configuration Reference](#configuration-reference)
+  - [Plugin Options](#plugin-options)
+  - [CollectionABConfig](#collectionabconfig)
+  - [Storage Adapters](#storage-adapters)
+- [Storage Adapters In Depth](#storage-adapters-in-depth)
+  - [payloadGlobalAdapter](#payloadglobaladapter)
+  - [vercelEdgeAdapter](#verceledgeadapter)
+- [Using the Manifest in Next.js Middleware](#using-the-manifest-in-nextjs-middleware)
+- [Localization Support](#localization-support)
+- [TypeScript Generics](#typescript-generics)
+
+---
+
+## How It Works
+
+The plugin follows a **write-on-change, read-at-edge** pattern:
+
+```
+Payload Admin
+     │
+     │  Editor saves/deletes a variant document
+     ▼
+afterChange / afterDelete hooks (injected by plugin)
+     │
+     │  Recompute all variants for the affected page path(s)
+     ▼
+Storage Adapter (write)
+  ├─ payloadGlobalAdapter  →  Payload Global (JSON field, read via REST)
+  └─ vercelEdgeAdapter     →  Vercel Edge Config (read via @vercel/edge-config)
+     │
+     ▼
+Manifest: { "/about": [variantA, variantB], "/pricing": [...] }
+     │
+     ▼
+Next.js Middleware (edge-compatible read)
+     │
+     │  storage.read(pathname) → VariantData[] | null
+     │
+     └─ Route user to original page or variant
+```
+
+The **manifest** is a plain JSON object:
+
+```ts
+type Manifest<TVariantData> = Record<string, TVariantData[]>
+// e.g. { "/en/about": [{ bucket: "b", rewritePath: "/en/variants/b/about" }] }
+```
+
+A path with no variants is absent from the manifest (no-op for middleware). Only paths that have at least one active variant are written.
+
+---
+
+## Key Features
+
+- **Zero-config hooks** — registers `afterChange` and `afterDelete` hooks on your variant collection automatically; no manual hook wiring required.
+- **Locale-aware** — iterates over every configured Payload locale and writes a separate manifest entry per locale so multilingual A/B tests work out of the box.
+- **Pluggable storage** — swap between the built-in adapters or implement your own `StorageAdapter`.
+- **Edge-compatible reads** — both built-in adapters expose a `read()` method that can run inside Next.js middleware (no Node.js runtime required).
+- **Fully typed** — the `TVariantData` generic flows through the entire plugin so your variant data is typed end-to-end.
+- **Debug mode** — optionally expose the manifest Global in the Payload admin panel for inspection.
+
+---
+
+## Installation
+
+```bash
+# pnpm (recommended)
+pnpm add payload-plugin-ab
+
+# npm
+npm install payload-plugin-ab
+
+# yarn
+yarn add payload-plugin-ab
+```
+
+**If you plan to use the Vercel Edge adapter**, also install its peer dependency:
+
+```bash
+pnpm add @vercel/edge-config
+```
+
+**Peer dependency**: `payload ^3.0.0` must already be installed in your project.
+
+---
+
+## Quick Start
+
+This example wires up A/B testing for a `page` collection where variants live in a `page-variants` collection.
+
+### Step 1 — Create a variant collection
+
+The variant collection requires a relationship back to the parent page and a bucket identifier that distinguishes the variant in the URL and cookie:
+
+```ts
+// collections/PageVariants.ts
+import type { CollectionConfig } from 'payload'
+
+export const PageVariants: CollectionConfig = {
+  slug: 'page-variants',
+  fields: [
+    {
+      name: 'page',
+      type: 'relationship',
+      relationTo: 'page',
+      required: true,
+      index: true,
+      label: { en: 'Original Page', es: 'Página Original' },
+      admin: {
+        description: {
+          en: 'The page this variant belongs to.',
+          es: 'La página a la que pertenece esta variante.',
+        },
+      },
+    },
+    {
+      name: 'bucketID',
+      type: 'select',
+      required: true,
+      index: true,
+      options: [
+        { label: 'A', value: 'a' },
+        { label: 'B', value: 'b' },
+        { label: 'C', value: 'c' },
+      ],
+      label: { en: 'Bucket ID', es: 'ID de Variante' },
+      admin: {
+        description: {
+          en: 'Variant identifier used in the URL and cookie. Each page can have at most one variant per bucket.',
+          es: 'Identificador de variante usado en la URL y cookie. Cada página puede tener como máximo una variante por bucket.',
+        },
+      },
+    },
+  ],
+}
+```
+
+Each page can have at most one variant per bucket (`a`, `b`, `c`). Middleware uses the bucket ID to assign users and rewrite their request to the correct variant path.
+
+### Step 2 — Register the plugin
+
+```ts
+// payload.config.ts
+import { buildConfig } from 'payload'
+import { abTestingPlugin } from 'payload-plugin-ab'
+import { payloadGlobalAdapter } from 'payload-plugin-ab/adapters/payload-global'
+import { Page } from './collections/Page'
+import { PageVariants } from './collections/PageVariants'
+
+// Shape of data stored per variant in the manifest.
+// Your middleware reads this to decide where to rewrite the request.
+type ABVariantData = {
+  bucket: string       // 'a' | 'b' | 'c'
+  rewritePath: string  // the URL this bucket should render
+}
+
+const abAdapter = payloadGlobalAdapter<ABVariantData>({
+  serverURL: process.env.NEXT_PUBLIC_SERVER_URL ?? '',
+})
+
+export default buildConfig({
+  collections: [Page, PageVariants],
+
+  plugins: [
+    abTestingPlugin<ABVariantData>({
+      debug: true, // set false in production to hide the manifest Global in admin
+      storage: abAdapter,
+      collections: {
+        // Key = parent collection slug
+        page: {
+          variantCollectionSlug: 'page-variants',
+
+          // Return the URL path used as the manifest key.
+          // Return null to skip this document (e.g. pages without a slug).
+          generatePath: ({ doc, locale }) => {
+            const slug = doc.slug as string | undefined
+            if (!slug) return null
+
+            return `/${locale}/${slug}`
+          },
+
+          // Return the data stored per variant in the manifest.
+          generateVariantData: ({ doc, variantDoc, locale }): ABVariantData => {
+            const slug = doc.slug as string
+
+            return {
+              bucket: variantDoc.bucketID as string,
+              rewritePath: `/${locale}/variants/${variantDoc.bucketID}/${slug}`,
+            }
+          },
+        },
+      },
+    }),
+  ],
+})
+```
+
+### Step 3 — Read the manifest in middleware
+
+```ts
+// middleware.ts  (Next.js)
+import { NextResponse } from 'next/server'
+import type { NextRequest } from 'next/server'
+import { payloadGlobalAdapter } from 'payload-plugin-ab/adapters/payload-global'
+
+type ABVariantData = { bucket: string; rewritePath: string }
+
+const storage = payloadGlobalAdapter<ABVariantData>({
+  serverURL: process.env.NEXT_PUBLIC_SERVER_URL ?? '',
+})
+
+const AB_BUCKET_COOKIE = 'ab-bucket'
+
+/**
+ * Determines whether the current request should be rewritten to a variant path.
+ *
+ * - visiblePathname  — the URL the user sees (used as the per-path cookie key)
+ * - manifestKey      — the key to look up in the manifest (may differ from the
+ *                      visible path when locale prefixes or rewrites are involved)
+ * - originalRewritePath — internal path to rewrite to when the user is assigned
+ *                         the 'original' bucket on their first visit
+ *
+ * Returns a NextResponse with a rewrite (and sets a cookie on first visit),
+ * or null if no rewrite is needed (caller should fall through to NextResponse.next()).
+ */
+async function resolveAbRewrite(
+  request: NextRequest,
+  visiblePathname: string,
+  manifestKey: string,
+  originalRewritePath: string,
+): Promise<NextResponse | null> {
+  let variants: ABVariantData[] | null = null
+
+  try {
+    variants = await storage.read(manifestKey)
+  } catch {
+    return null
+  }
+
+  if (!variants?.length) return null
+
+  const cookieName = `${AB_BUCKET_COOKIE}_${encodeURIComponent(visiblePathname)}`
+  const existingBucket = request.cookies.get(cookieName)?.value
+
+  let bucket = existingBucket
+  if (!bucket) {
+    // Include the original as one of the possible outcomes so not every user
+    // is sent to a variant — e.g. with 2 variants there is a 1-in-3 chance
+    // of seeing the original page.
+    const idx = Math.floor(Math.random() * (variants.length + 1))
+    bucket = idx === variants.length ? 'original' : variants[idx]!.bucket
+  }
+
+  if (bucket === 'original') {
+    if (!existingBucket) {
+      // First visit: persist the assignment, then rewrite to the original path
+      const url = request.nextUrl.clone()
+      url.pathname = originalRewritePath
+      const res = NextResponse.rewrite(url)
+      res.cookies.set(cookieName, 'original', { path: '/', sameSite: 'lax' })
+      return res
+    }
+    // Returning user assigned to original — no rewrite needed
+    return null
+  }
+
+  const match = variants.find((v) => v.bucket === bucket)
+  if (!match) return null
+
+  const url = request.nextUrl.clone()
+  url.pathname = match.rewritePath
+  const res = NextResponse.rewrite(url)
+  if (!existingBucket) {
+    res.cookies.set(cookieName, bucket, { path: '/', sameSite: 'lax' })
+  }
+  return res
+}
+
+export async function middleware(request: NextRequest) {
+  const { pathname } = request.nextUrl
+
+  const result = await resolveAbRewrite(
+    request,
+    pathname, // visible pathname — used as the per-path cookie key
+    pathname, // manifest key — adjust if you prepend a locale or other prefix
+    pathname, // original rewrite path — where to send the 'original' bucket
+  )
+
+  return result ?? NextResponse.next()
+}
+
+export const config = {
+  matcher: ['/((?!_next|api|favicon.ico).*)'],
+}
+```
+
+---
+
+## Configuration Reference
+
+### Plugin Options
+
+```ts
+interface AbTestingPluginConfig<TVariantData extends object> {
+  /** Enable or disable the plugin entirely. Default: true */
+  enabled?: boolean
+
+  /**
+   * When true, the manifest Global is visible in the Payload admin panel
+   * under the "System" group. Useful for debugging.
+   * Default: false
+   */
+  debug?: boolean
+
+  /**
+   * Map of parent collection slug → A/B config for that collection.
+   * You can configure multiple parent collections simultaneously.
+   */
+  collections: Record<string, CollectionABConfig<TVariantData>>
+
+  /** Storage adapter — payloadGlobalAdapter or vercelEdgeAdapter. */
+  storage: StorageAdapter<TVariantData>
+}
+```
+
+### CollectionABConfig
+
+```ts
+interface CollectionABConfig<TVariantData extends object> {
+  /**
+   * Slug of the variant collection (e.g. 'page-variants').
+   * Must be registered in your Payload config.
+   * Hooks are automatically added to this collection.
+   */
+  variantCollectionSlug: string
+
+  /**
+   * Maps a parent document to the URL path used as the manifest key.
+   *
+   * Return null to skip writing the manifest for that document
+   * (e.g. for drafts, documents without slugs, etc.).
+   *
+   * Called once per locale when localization is enabled.
+   */
+  generatePath: (args: { doc: Record<string, unknown>; locale: string }) => string | null
+
+  /**
+   * Builds the data object stored per variant in the manifest array.
+   * This is what your middleware reads — include everything it needs
+   * to make a routing decision (slug, weight, experiment ID, etc.).
+   *
+   * Called once per variant document, per locale.
+   */
+  generateVariantData: (args: {
+    doc: Record<string, unknown>       // parent document
+    variantDoc: Record<string, unknown> // variant document
+    locale: string
+  }) => TVariantData
+}
+```
+
+### Storage Adapters
+
+Both adapters implement the same `StorageAdapter` interface:
+
+```ts
+interface StorageAdapter<TVariantData extends object> {
+  /** Write variant data for a path. Called from afterChange hooks. */
+  write(path: string, variants: TVariantData[], payload: Payload): Promise<void>
+
+  /**
+   * Read variant data for a path.
+   * Must be Edge-compatible (no Node.js-only APIs).
+   * Returns null if the path has no variants.
+   */
+  read(path: string): Promise<TVariantData[] | null>
+
+  /** Remove all variant data for a path. Called from afterDelete hooks. */
+  clear(path: string, payload: Payload): Promise<void>
+
+  /**
+   * Optional: return a GlobalConfig to register in Payload.
+   * Used by payloadGlobalAdapter to store the manifest.
+   * Not needed for vercelEdgeAdapter.
+   */
+  createGlobal?(debug: boolean): GlobalConfig
+}
+```
+
+You can implement this interface yourself if neither built-in adapter fits your stack (e.g. Redis, Upstash, KV, etc.).
+
+---
+
+## Storage Adapters In Depth
+
+### payloadGlobalAdapter
+
+Stores the manifest in a **Payload Global** as a JSON field. The manifest is then fetched from middleware via the Payload REST API.
+
+**Import:**
+```ts
+import { payloadGlobalAdapter } from 'payload-plugin-ab/adapters/payload-global'
+```
+
+**Options:**
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `globalSlug` | `string` | `'_abManifest'` | Slug for the auto-created Payload Global |
+| `serverURL` | `string` | `''` | Full origin of your Payload server (e.g. `https://cms.example.com`). Used by `read()` in middleware. |
+| `apiRoute` | `string` | `'/api'` | Payload REST API prefix |
+
+**Usage:**
+```ts
+import { payloadGlobalAdapter } from 'payload-plugin-ab/adapters/payload-global'
+
+const storage = payloadGlobalAdapter({
+  globalSlug: '_abManifest',        // optional, this is the default
+  serverURL: 'https://cms.example.com',
+  apiRoute: '/api',                 // optional, this is the default
+})
+```
+
+**How it reads:** The `read()` method fetches `GET {serverURL}{apiRoute}/globals/{globalSlug}` with `cache: 'no-store'` and returns `data.manifest[path]`. This REST endpoint is public (the Global has `access.read: () => true`).
+
+**When the Global is hidden:** By default the Global is not shown in the Payload admin. Set `debug: true` in the plugin config to make it visible under the **System** group.
+
+---
+
+### vercelEdgeAdapter
+
+Stores the manifest in **Vercel Edge Config** — Vercel's ultra-low-latency global key-value store. Reads are served from the edge with sub-millisecond latency, making this the best option for Vercel-hosted projects.
+
+**Import:**
+```ts
+import { vercelEdgeAdapter } from 'payload-plugin-ab/adapters/vercel-edge'
+```
+
+**Prerequisites:**
+
+1. Install the Edge Config client:
+   ```bash
+   pnpm add @vercel/edge-config
+   ```
+
+2. Create an Edge Config store in your Vercel project dashboard.
+
+3. Set the following environment variables:
+
+| Variable | Description |
+|---|---|
+| `EDGE_CONFIG` | Connection string (from Vercel dashboard, e.g. `https://edge-config.vercel.com/ecfg_xxx?token=yyy`) |
+| `EDGE_CONFIG_ID` | Edge Config store ID (e.g. `ecfg_xxx`) — passed as `configID` |
+| `VERCEL_REST_API_ACCESS_TOKEN` | Vercel REST API token with read/write access — passed as `vercelRestAPIAccessToken` |
+
+**Options:**
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `configID` | `string` | required | Edge Config store ID |
+| `configURL` | `string` | required | Full Edge Config URL (same as `EDGE_CONFIG` env var) |
+| `vercelRestAPIAccessToken` | `string` | required | Vercel REST API access token |
+| `teamID` | `string` | — | Vercel team ID (for team-scoped projects) |
+| `manifestKey` | `string` | `'ab-testing'` | Top-level key in Edge Config that holds the manifest object |
+
+**Usage:**
+```ts
+import { vercelEdgeAdapter } from 'payload-plugin-ab/adapters/vercel-edge'
+
+const storage = vercelEdgeAdapter({
+  configID: process.env.EDGE_CONFIG_ID!,
+  configURL: process.env.EDGE_CONFIG!,
+  vercelRestAPIAccessToken: process.env.VERCEL_REST_API_ACCESS_TOKEN!,
+  teamID: process.env.VERCEL_TEAM_ID,   // optional
+  manifestKey: 'ab-testing',            // optional, this is the default
+})
+```
+
+**How it writes:** Updates are made via the Vercel REST API (`PATCH /v1/edge-config/{configID}/items`) using an `upsert` operation. The adapter maintains a local in-memory cache of the manifest to avoid re-reading Edge Config on every write within the same server process.
+
+**How it reads:** Uses `@vercel/edge-config`'s `get(manifestKey)` — this is edge-compatible and extremely fast.
+
+---
+
+## Using the Manifest in Next.js Middleware
+
+The `storage.read(path)` method is the only adapter method called from middleware. It returns:
+
+- `TVariantData[]` — an array of variant objects for that path (at least one element)
+- `null` — no variants configured for this path (pass through)
+
+### resolveAbRewrite pattern
+
+The recommended approach is a dedicated `resolveAbRewrite` helper (shown in the Quick Start above) that handles bucket assignment, sticky sessions, and rewrites in one place. Key behaviours:
+
+| Behaviour | Detail |
+|---|---|
+| **Sticky sessions** | Bucket is stored in a per-path cookie (`ab-bucket_<encoded-pathname>`) so the same user always sees the same variant. |
+| **Original bucket** | The original page is included as an outcome alongside the configured variants. With _n_ variants there is a 1-in-(_n_+1) chance of landing on the original. |
+| **First visit** | Cookie is written and the request is rewritten in a single response — no extra redirect. |
+| **Returning user (original)** | The function returns `null` so the caller falls through to `NextResponse.next()` — no unnecessary rewrite. |
+| **Error safety** | `storage.read()` is wrapped in try/catch; any adapter error results in `null` (pass through). |
+
+The three path arguments let you decouple the URL the user sees, the manifest lookup key, and the internal rewrite target — useful when locale prefixes or custom rewrite rules are involved:
+
+```ts
+await resolveAbRewrite(
+  request,
+  visiblePathname,      // used as the per-path cookie key
+  manifestKey,          // key to look up in the manifest
+  originalRewritePath,  // internal path for the 'original' bucket
+)
+```
+
+---
+
+## Localization Support
+
+If your Payload config has `localization` enabled, the plugin automatically handles it. For every locale defined in `payload.config.localization.locales`, the hooks:
+
+1. Fetch the parent document in that locale.
+2. Call `generatePath({ doc, locale })` to determine the manifest key.
+3. Call `generateVariantData({ doc, variantDoc, locale })` for each variant.
+4. Write a separate manifest entry per locale.
+
+This means you can generate locale-prefixed paths from any field on the document:
+
+```ts
+generatePath: ({ doc, locale }) => {
+  const slug = doc.slug as string | undefined
+  if (!slug) return null
+
+  return `/${locale}/${slug}` // e.g. '/en/about', '/fr/about'
+},
+```
+
+No additional configuration is needed — locale support is automatic when `payload.config.localization` is set.
+
+---
+
+## TypeScript Generics
+
+The plugin is fully generic over `TVariantData extends object`. This type represents the shape of each variant entry in the manifest. Define it once and it flows through everywhere:
+
+```ts
+// Define your variant shape — include everything middleware needs to route the request
+type ABVariantData = {
+  bucket: string       // which bucket this variant belongs to ('a' | 'b' | 'c')
+  rewritePath: string  // the internal URL path middleware should rewrite to
+}
+
+// Pass the type to the adapter
+const storage = payloadGlobalAdapter<ABVariantData>({ serverURL: '...' })
+
+// Pass the same type to the plugin
+abTestingPlugin<ABVariantData>({
+  collections: {
+    page: {
+      variantCollectionSlug: 'page-variants',
+      generatePath: ({ doc, locale }) => { /* ... */ },
+
+      // variantDoc is Record<string, unknown> — cast fields as needed
+      generateVariantData: ({ variantDoc, locale }): ABVariantData => ({
+        bucket: variantDoc.bucketID as string,
+        rewritePath: `/${locale}/variants/${variantDoc.bucketID}`,
+      }),
+    },
+  },
+  storage,
+})
+```
+
+In middleware, `storage.read(path)` returns `ABVariantData[] | null` — fully typed.

package/dist/adapters/payloadGlobal/index.d.ts

@@ -0,0 +1,15 @@
+import { S as StorageAdapter } from '../../config-CRUREAW_.js';
+import 'payload';
+
+interface PayloadGlobalAdapterConfig {
+    /** Slug for the Payload Global that stores the manifest. Default: '_abManifest' */
+    globalSlug?: string;
+    /** Server URL used to fetch the global via REST in middleware. Example: 'https://example.com' */
+    serverURL?: string;
+    /** Payload API route prefix. Default: '/api' */
+    apiRoute?: string;
+}
+
+declare function payloadGlobalAdapter<TVariantData extends object>(config?: PayloadGlobalAdapterConfig): StorageAdapter<TVariantData>;
+
+export { payloadGlobalAdapter };

package/dist/adapters/payloadGlobal/index.js

@@ -0,0 +1,82 @@
+// src/adapters/payloadGlobal/api/fetchManifest.ts
+async function fetchManifest(serverURL, apiRoute, slug, path) {
+  try {
+    const res = await fetch(`${serverURL}${apiRoute}/globals/${slug}`, {
+      cache: "no-store"
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data?.manifest?.[path] ?? null;
+  } catch {
+    return null;
+  }
+}
+
+// src/adapters/payloadGlobal/api/readManifest.ts
+async function readManifest(payload, slug) {
+  try {
+    const doc = await payload.findGlobal({ slug, overrideAccess: true });
+    return doc?.manifest ?? {};
+  } catch {
+    return {};
+  }
+}
+
+// src/adapters/payloadGlobal/utils/createGlobal.ts
+function createGlobal(slug, debug) {
+  return {
+    slug,
+    access: {
+      read: () => true
+    },
+    admin: {
+      hidden: !debug,
+      group: "System"
+    },
+    fields: [
+      {
+        name: "manifest",
+        type: "json",
+        admin: {
+          description: "A/B testing manifest. Managed automatically \u2014 do not edit manually."
+        }
+      }
+    ]
+  };
+}
+
+// src/adapters/payloadGlobal/index.ts
+function payloadGlobalAdapter(config) {
+  const slug = config?.globalSlug ?? "_abManifest";
+  return {
+    async write(path, variants, payload) {
+      const currentManifest = await readManifest(payload, slug);
+      await payload.updateGlobal({
+        slug,
+        data: { manifest: { ...currentManifest, [path]: variants } },
+        overrideAccess: true
+      });
+    },
+    async read(path) {
+      const serverURL = config?.serverURL ?? "";
+      const apiRoute = config?.apiRoute ?? "/api";
+      return fetchManifest(serverURL, apiRoute, slug, path);
+    },
+    async clear(path, payload) {
+      const currentManifest = await readManifest(payload, slug);
+      delete currentManifest[path];
+      await payload.updateGlobal({
+        slug,
+        data: { manifest: currentManifest },
+        overrideAccess: true
+      });
+    },
+    createGlobal(debug = false) {
+      return createGlobal(slug, debug);
+    }
+  };
+}
+export {
+  payloadGlobalAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/adapters/payloadGlobal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/payloadGlobal/api/fetchManifest.ts","../../../src/adapters/payloadGlobal/api/readManifest.ts","../../../src/adapters/payloadGlobal/utils/createGlobal.ts","../../../src/adapters/payloadGlobal/index.ts"],"sourcesContent":["export async function fetchManifest<TVariantData extends object>(\n  serverURL: string,\n  apiRoute: string,\n  slug: string,\n  path: string,\n): Promise<TVariantData[] | null> {\n  try {\n    const res = await fetch(`${serverURL}${apiRoute}/globals/${slug}`, {\n      cache: \"no-store\",\n    });\n\n    if (!res.ok) return null;\n\n    const data = await res.json();\n\n    return (data?.manifest?.[path] as TVariantData[]) ?? null;\n  } catch {\n    return null;\n  }\n}\n","import type { GlobalSlug, Payload } from \"payload\";\nimport type { Manifest } from \"../../../types/manifest\";\n\nexport async function readManifest(payload: Payload, slug: string): Promise<Manifest> {\n  try {\n    const doc = await payload.findGlobal({ slug: slug as GlobalSlug, overrideAccess: true });\n\n    return (doc?.manifest as Manifest) ?? {};\n  } catch {\n    return {};\n  }\n}\n","import type { GlobalConfig } from \"payload\";\n\nexport function createGlobal(slug: string, debug: boolean): GlobalConfig {\n  return {\n    slug,\n    access: {\n      read: () => true,\n    },\n    admin: {\n      hidden: !debug,\n      group: \"System\",\n    },\n    fields: [\n      {\n        name: \"manifest\",\n        type: \"json\",\n        admin: {\n          description: \"A/B testing manifest. Managed automatically — do not edit manually.\",\n        },\n      },\n    ],\n  };\n}\n","import type { GlobalSlug } from \"payload\";\nimport type { StorageAdapter } from \"../../types/config\";\nimport type { PayloadGlobalAdapterConfig } from \"./config\";\nimport { fetchManifest } from \"./api/fetchManifest\";\nimport { readManifest } from \"./api/readManifest\";\nimport { createGlobal } from \"./utils/createGlobal\";\n\nexport function payloadGlobalAdapter<TVariantData extends object>(\n  config?: PayloadGlobalAdapterConfig,\n): StorageAdapter<TVariantData> {\n  const slug = config?.globalSlug ?? \"_abManifest\";\n\n  return {\n    async write(path, variants, payload) {\n      const currentManifest = await readManifest(payload, slug);\n\n      await payload.updateGlobal({\n        slug: slug as GlobalSlug,\n        data: { manifest: { ...currentManifest, [path]: variants } },\n        overrideAccess: true,\n      });\n    },\n\n    async read(path) {\n      const serverURL = config?.serverURL ?? \"\";\n      const apiRoute = config?.apiRoute ?? \"/api\";\n\n      return fetchManifest<TVariantData>(serverURL, apiRoute, slug, path);\n    },\n\n    async clear(path, payload) {\n      const currentManifest = await readManifest(payload, slug);\n\n      delete currentManifest[path];\n\n      await payload.updateGlobal({\n        slug: slug as GlobalSlug,\n        data: { manifest: currentManifest },\n        overrideAccess: true,\n      });\n    },\n\n    createGlobal(debug = false) {\n      return createGlobal(slug, debug);\n    },\n  };\n}\n"],"mappings":";AAAA,eAAsB,cACpB,WACA,UACA,MACA,MACgC;AAChC,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,QAAQ,YAAY,IAAI,IAAI;AAAA,MACjE,OAAO;AAAA,IACT,CAAC;AAED,QAAI,CAAC,IAAI,GAAI,QAAO;AAEpB,UAAM,OAAO,MAAM,IAAI,KAAK;AAE5B,WAAQ,MAAM,WAAW,IAAI,KAAwB;AAAA,EACvD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;AChBA,eAAsB,aAAa,SAAkB,MAAiC;AACpF,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,WAAW,EAAE,MAA0B,gBAAgB,KAAK,CAAC;AAEvF,WAAQ,KAAK,YAAyB,CAAC;AAAA,EACzC,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;;;ACTO,SAAS,aAAa,MAAc,OAA8B;AACvE,SAAO;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,MACN,MAAM,MAAM;AAAA,IACd;AAAA,IACA,OAAO;AAAA,MACL,QAAQ,CAAC;AAAA,MACT,OAAO;AAAA,IACT;AAAA,IACA,QAAQ;AAAA,MACN;AAAA,QACE,MAAM;AAAA,QACN,MAAM;AAAA,QACN,OAAO;AAAA,UACL,aAAa;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;;;ACfO,SAAS,qBACd,QAC8B;AAC9B,QAAM,OAAO,QAAQ,cAAc;AAEnC,SAAO;AAAA,IACL,MAAM,MAAM,MAAM,UAAU,SAAS;AACnC,YAAM,kBAAkB,MAAM,aAAa,SAAS,IAAI;AAExD,YAAM,QAAQ,aAAa;AAAA,QACzB;AAAA,QACA,MAAM,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAAC,IAAI,GAAG,SAAS,EAAE;AAAA,QAC3D,gBAAgB;AAAA,MAClB,CAAC;AAAA,IACH;AAAA,IAEA,MAAM,KAAK,MAAM;AACf,YAAM,YAAY,QAAQ,aAAa;AACvC,YAAM,WAAW,QAAQ,YAAY;AAErC,aAAO,cAA4B,WAAW,UAAU,MAAM,IAAI;AAAA,IACpE;AAAA,IAEA,MAAM,MAAM,MAAM,SAAS;AACzB,YAAM,kBAAkB,MAAM,aAAa,SAAS,IAAI;AAExD,aAAO,gBAAgB,IAAI;AAE3B,YAAM,QAAQ,aAAa;AAAA,QACzB;AAAA,QACA,MAAM,EAAE,UAAU,gBAAgB;AAAA,QAClC,gBAAgB;AAAA,MAClB,CAAC;AAAA,IACH;AAAA,IAEA,aAAa,QAAQ,OAAO;AAC1B,aAAO,aAAa,MAAM,KAAK;AAAA,IACjC;AAAA,EACF;AACF;","names":[]}

package/dist/adapters/vercelEdge/index.d.ts

@@ -0,0 +1,20 @@
+import { S as StorageAdapter } from '../../config-CRUREAW_.js';
+import 'payload';
+
+interface VercelEdgeAdapterConfig {
+    configID: string;
+    configURL: string;
+    vercelRestAPIAccessToken: string;
+    teamID?: string;
+    /** Top-level key in Edge Config that holds the manifest. Default: 'ab-testing' */
+    manifestKey?: string;
+}
+
+/**
+ * Vercel Edge Config adapter.
+ * Requires "pnpm add \@vercel/edge-config" and the following env vars:
+ *   EDGE_CONFIG, EDGE_CONFIG_ID, VERCEL_REST_API_ACCESS_TOKEN
+ */
+declare function vercelEdgeAdapter<TVariantData extends object>(config: VercelEdgeAdapterConfig): StorageAdapter<TVariantData>;
+
+export { vercelEdgeAdapter };

package/dist/adapters/vercelEdge/index.js

@@ -0,0 +1,66 @@
+// src/adapters/vercelEdge/api/readManifest.ts
+async function readManifest(manifestKey) {
+  try {
+    const { get } = await import("@vercel/edge-config");
+    const manifest = await get(manifestKey);
+    return manifest ?? {};
+  } catch {
+    return {};
+  }
+}
+
+// src/adapters/vercelEdge/utils/buildHeaders.ts
+function buildHeaders(config) {
+  return {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${config.vercelRestAPIAccessToken}`
+  };
+}
+
+// src/adapters/vercelEdge/api/updateEdgeConfig.ts
+async function updateEdgeConfig(config, manifestKey, value) {
+  const teamQuery = config.teamID ? `?teamId=${config.teamID}` : "";
+  await fetch(`https://api.vercel.com/v1/edge-config/${config.configID}/items${teamQuery}`, {
+    method: "PATCH",
+    headers: buildHeaders(config),
+    body: JSON.stringify({ items: [{ operation: "upsert", key: manifestKey, value }] })
+  });
+}
+
+// src/adapters/vercelEdge/index.ts
+function vercelEdgeAdapter(config) {
+  const manifestKey = config.manifestKey ?? "ab-testing";
+  let localCache = null;
+  async function getManifest() {
+    if (localCache === null) {
+      localCache = await readManifest(manifestKey);
+    }
+    return localCache;
+  }
+  return {
+    async write(path, variants) {
+      const currentManifest = await getManifest();
+      localCache = { ...currentManifest, [path]: variants };
+      await updateEdgeConfig(config, manifestKey, localCache);
+    },
+    async read(path) {
+      try {
+        const manifest = await readManifest(manifestKey);
+        return manifest?.[path] ?? null;
+      } catch {
+        return null;
+      }
+    },
+    async clear(path) {
+      const currentManifest = await getManifest();
+      const updated = { ...currentManifest };
+      delete updated[path];
+      localCache = updated;
+      await updateEdgeConfig(config, manifestKey, localCache);
+    }
+  };
+}
+export {
+  vercelEdgeAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/adapters/vercelEdge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/vercelEdge/api/readManifest.ts","../../../src/adapters/vercelEdge/utils/buildHeaders.ts","../../../src/adapters/vercelEdge/api/updateEdgeConfig.ts","../../../src/adapters/vercelEdge/index.ts"],"sourcesContent":["import type { Manifest } from \"../../../types/manifest\";\n\nexport async function readManifest<TVariantData extends object = object>(\n  manifestKey: string,\n): Promise<Manifest<TVariantData>> {\n  try {\n    const { get } = await import(\"@vercel/edge-config\");\n\n    const manifest = await get<Manifest<TVariantData>>(manifestKey);\n\n    return manifest ?? {};\n  } catch {\n    return {};\n  }\n}\n","import type { VercelEdgeAdapterConfig } from \"../config\";\n\nexport function buildHeaders(config: VercelEdgeAdapterConfig): Record<string, string> {\n  return {\n    \"Content-Type\": \"application/json\",\n    Authorization: `Bearer ${config.vercelRestAPIAccessToken}`,\n  };\n}\n","import type { VercelEdgeAdapterConfig } from \"../config\";\nimport { buildHeaders } from \"../utils/buildHeaders\";\n\nexport async function updateEdgeConfig(config: VercelEdgeAdapterConfig, manifestKey: string, value: unknown) {\n  const teamQuery = config.teamID ? `?teamId=${config.teamID}` : \"\";\n\n  await fetch(`https://api.vercel.com/v1/edge-config/${config.configID}/items${teamQuery}`, {\n    method: \"PATCH\",\n    headers: buildHeaders(config),\n    body: JSON.stringify({ items: [{ operation: \"upsert\", key: manifestKey, value }] }),\n  });\n}\n","import type { StorageAdapter } from \"../../types/config\";\nimport type { Manifest } from \"../../types/manifest\";\nimport { readManifest } from \"./api/readManifest\";\nimport { updateEdgeConfig } from \"./api/updateEdgeConfig\";\nimport type { VercelEdgeAdapterConfig } from \"./config\";\n\n/**\n * Vercel Edge Config adapter.\n * Requires \"pnpm add \\@vercel/edge-config\" and the following env vars:\n *   EDGE_CONFIG, EDGE_CONFIG_ID, VERCEL_REST_API_ACCESS_TOKEN\n */\nexport function vercelEdgeAdapter<TVariantData extends object>(\n  config: VercelEdgeAdapterConfig,\n): StorageAdapter<TVariantData> {\n  const manifestKey = config.manifestKey ?? \"ab-testing\";\n  let localCache: Manifest<TVariantData> | null = null;\n\n  async function getManifest() {\n    if (localCache === null) {\n      localCache = await readManifest<TVariantData>(manifestKey);\n    }\n\n    return localCache;\n  }\n\n  return {\n    async write(path, variants) {\n      const currentManifest = await getManifest();\n\n      localCache = { ...currentManifest, [path]: variants };\n\n      await updateEdgeConfig(config, manifestKey, localCache);\n    },\n\n    async read(path) {\n      try {\n        const manifest = await readManifest<TVariantData>(manifestKey);\n\n        return manifest?.[path] ?? null;\n      } catch {\n        return null;\n      }\n    },\n\n    async clear(path) {\n      const currentManifest = await getManifest();\n      const updated = { ...currentManifest };\n\n      delete updated[path];\n\n      localCache = updated;\n\n      await updateEdgeConfig(config, manifestKey, localCache);\n    },\n  };\n}\n"],"mappings":";AAEA,eAAsB,aACpB,aACiC;AACjC,MAAI;AACF,UAAM,EAAE,IAAI,IAAI,MAAM,OAAO,qBAAqB;AAElD,UAAM,WAAW,MAAM,IAA4B,WAAW;AAE9D,WAAO,YAAY,CAAC;AAAA,EACtB,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;;;ACZO,SAAS,aAAa,QAAyD;AACpF,SAAO;AAAA,IACL,gBAAgB;AAAA,IAChB,eAAe,UAAU,OAAO,wBAAwB;AAAA,EAC1D;AACF;;;ACJA,eAAsB,iBAAiB,QAAiC,aAAqB,OAAgB;AAC3G,QAAM,YAAY,OAAO,SAAS,WAAW,OAAO,MAAM,KAAK;AAE/D,QAAM,MAAM,yCAAyC,OAAO,QAAQ,SAAS,SAAS,IAAI;AAAA,IACxF,QAAQ;AAAA,IACR,SAAS,aAAa,MAAM;AAAA,IAC5B,MAAM,KAAK,UAAU,EAAE,OAAO,CAAC,EAAE,WAAW,UAAU,KAAK,aAAa,MAAM,CAAC,EAAE,CAAC;AAAA,EACpF,CAAC;AACH;;;ACAO,SAAS,kBACd,QAC8B;AAC9B,QAAM,cAAc,OAAO,eAAe;AAC1C,MAAI,aAA4C;AAEhD,iBAAe,cAAc;AAC3B,QAAI,eAAe,MAAM;AACvB,mBAAa,MAAM,aAA2B,WAAW;AAAA,IAC3D;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM,MAAM,MAAM,UAAU;AAC1B,YAAM,kBAAkB,MAAM,YAAY;AAE1C,mBAAa,EAAE,GAAG,iBAAiB,CAAC,IAAI,GAAG,SAAS;AAEpD,YAAM,iBAAiB,QAAQ,aAAa,UAAU;AAAA,IACxD;AAAA,IAEA,MAAM,KAAK,MAAM;AACf,UAAI;AACF,cAAM,WAAW,MAAM,aAA2B,WAAW;AAE7D,eAAO,WAAW,IAAI,KAAK;AAAA,MAC7B,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,MAAM,MAAM,MAAM;AAChB,YAAM,kBAAkB,MAAM,YAAY;AAC1C,YAAM,UAAU,EAAE,GAAG,gBAAgB;AAErC,aAAO,QAAQ,IAAI;AAEnB,mBAAa;AAEb,YAAM,iBAAiB,QAAQ,aAAa,UAAU;AAAA,IACxD;AAAA,EACF;AACF;","names":[]}

package/dist/config-CRUREAW_.d.ts

@@ -0,0 +1,37 @@
+import { Payload, GlobalConfig } from 'payload';
+
+interface StorageAdapter<TVariantData extends object = object> {
+    /** Write variant data for a path. Called from Payload afterChange hooks. */
+    write(path: string, variants: TVariantData[], payload: Payload): Promise<void>;
+    /** Read variant data for a path. Called from Next.js middleware — must be Edge-compatible. */
+    read(path: string): Promise<TVariantData[] | null>;
+    /** Remove all variant data for a path. Called from Payload afterDelete hooks. */
+    clear(path: string, payload: Payload): Promise<void>;
+    /** Optional: return a Global config to register in Payload (used by payloadGlobalAdapter). */
+    createGlobal?(debug: boolean): GlobalConfig;
+}
+interface CollectionABConfig<TVariantData extends object = object> {
+    variantCollectionSlug: string;
+    generatePath: (args: {
+        doc: Record<string, unknown>;
+        locale: string;
+    }) => string | null;
+    /** Generate the data stored per variant in the manifest. */
+    generateVariantData: (args: {
+        doc: Record<string, unknown>;
+        variantDoc: Record<string, unknown>;
+        locale: string;
+    }) => TVariantData;
+}
+interface AbTestingPluginConfig<TVariantData extends object = object> {
+    /** Default: true */
+    enabled?: boolean;
+    /** If true, the manifest global is visible in the Payload admin panel. Default: false */
+    debug?: boolean;
+    /** Map of parent collection slug => A/B config for that collection. */
+    collections: Record<string, CollectionABConfig<TVariantData>>;
+    /** Storage adapter instance (payloadGlobalAdapter or vercelEdgeAdapter). */
+    storage: StorageAdapter<TVariantData>;
+}
+
+export type { AbTestingPluginConfig as A, CollectionABConfig as C, StorageAdapter as S };

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { Plugin } from 'payload';
+import { A as AbTestingPluginConfig } from './config-CRUREAW_.js';
+export { C as CollectionABConfig, S as StorageAdapter } from './config-CRUREAW_.js';
+export { payloadGlobalAdapter } from './adapters/payloadGlobal/index.js';
+export { vercelEdgeAdapter } from './adapters/vercelEdge/index.js';
+
+declare const abTestingPlugin: <TVariantData extends object>(pluginConfig: AbTestingPluginConfig<TVariantData>) => Plugin;
+
+export { AbTestingPluginConfig, abTestingPlugin };

package/dist/index.js

@@ -0,0 +1,334 @@
+// src/utils/buildVariantToParentCollectionSlugsMap.ts
+function buildVariantToParentCollectionSlugsMap(collections) {
+  const variantToParent = /* @__PURE__ */ new Map();
+  for (const [parentSlug, abConfig] of Object.entries(collections)) {
+    if (abConfig) variantToParent.set(abConfig.variantCollectionSlug, parentSlug);
+  }
+  return variantToParent;
+}
+
+// src/utils/resolveId.ts
+var isValueIsBaseDocument = (value) => {
+  return "id" in value;
+};
+function resolveId(value) {
+  if (!value) return null;
+  if (typeof value === "number" || typeof value === "string") return value;
+  if (typeof value === "object" && isValueIsBaseDocument(value)) {
+    return value.id;
+  }
+  return null;
+}
+
+// src/utils/getLocales.ts
+function getLocales(payload) {
+  const localization = payload.config.localization;
+  const locales = localization ? localization.locales ?? [] : [];
+  return locales.map((l) => typeof l === "string" ? l : l.code ?? String(l));
+}
+
+// src/hooks/buildAfterChangeHook.ts
+function buildAfterChangeHook(parentCollectionSlug, abConfig, pluginConfig) {
+  return async ({ doc, req, previousDoc }) => {
+    const { payload } = req;
+    if (!payload) return;
+    const pageId = resolveId(doc.page);
+    if (!pageId) return;
+    const locales = getLocales(payload);
+    const previousPageId = previousDoc ? resolveId(previousDoc.page) : null;
+    if (previousPageId && previousPageId !== pageId) {
+      for (const locale of locales) {
+        const oldPageDoc = await payload.findByID({
+          collection: parentCollectionSlug,
+          id: previousPageId,
+          depth: 2,
+          locale,
+          overrideAccess: true,
+          req
+        });
+        if (!oldPageDoc) continue;
+        const oldManifestKey = abConfig.generatePath({ doc: oldPageDoc, locale });
+        if (!oldManifestKey) continue;
+        const remainingOldVariants = await payload.find({
+          collection: abConfig.variantCollectionSlug,
+          where: {
+            and: [{ page: { equals: previousPageId } }, { id: { not_equals: doc.id } }]
+          },
+          depth: 2,
+          locale,
+          overrideAccess: true,
+          limit: 100,
+          req
+        });
+        if (remainingOldVariants.docs.length === 0) {
+          await pluginConfig.storage.clear(oldManifestKey, payload);
+        } else {
+          const oldVariantData = remainingOldVariants.docs.map(
+            (variantDoc) => abConfig.generateVariantData({ doc: oldPageDoc, variantDoc, locale })
+          );
+          await pluginConfig.storage.write(oldManifestKey, oldVariantData, payload);
+        }
+      }
+    }
+    for (const locale of locales) {
+      const pageDoc = await payload.findByID({
+        collection: parentCollectionSlug,
+        id: pageId,
+        depth: 2,
+        locale,
+        overrideAccess: true,
+        req
+      });
+      if (!pageDoc) continue;
+      const manifestKey = abConfig.generatePath({ doc: pageDoc, locale });
+      if (!manifestKey) continue;
+      const allVariants = await payload.find({
+        collection: abConfig.variantCollectionSlug,
+        where: { page: { equals: pageId } },
+        depth: 2,
+        locale,
+        overrideAccess: true,
+        limit: 100,
+        req
+      });
+      const variantData = allVariants.docs.map(
+        (variantDoc) => abConfig.generateVariantData({ doc: pageDoc, variantDoc, locale })
+      );
+      await pluginConfig.storage.write(manifestKey, variantData, payload);
+    }
+  };
+}
+
+// src/hooks/buildAfterDeleteHook.ts
+function buildAfterDeleteHook(parentCollectionSlug, abConfig, pluginConfig) {
+  return async ({ doc, req, id }) => {
+    const { payload } = req;
+    if (!payload) return;
+    const pageId = resolveId(doc.page);
+    if (!pageId) return;
+    const locales = getLocales(payload);
+    for (const locale of locales) {
+      const pageDoc = await payload.findByID({
+        collection: parentCollectionSlug,
+        id: pageId,
+        depth: 2,
+        locale,
+        overrideAccess: true,
+        req
+      });
+      if (!pageDoc) continue;
+      const manifestKey = abConfig.generatePath({ doc: pageDoc, locale });
+      if (!manifestKey) continue;
+      const remainingVariants = await payload.find({
+        collection: abConfig.variantCollectionSlug,
+        where: {
+          and: [{ page: { equals: pageId } }, { id: { not_equals: id } }]
+        },
+        depth: 2,
+        locale,
+        overrideAccess: true,
+        limit: 100,
+        req
+      });
+      if (remainingVariants.docs.length === 0) {
+        await pluginConfig.storage.clear(manifestKey, payload);
+      } else {
+        const variantData = remainingVariants.docs.map(
+          (variantDoc) => abConfig.generateVariantData({ doc: pageDoc, variantDoc, locale })
+        );
+        await pluginConfig.storage.write(manifestKey, variantData, payload);
+      }
+    }
+  };
+}
+
+// src/utils/addHooksToVariantCollections.ts
+function addHooksToVariantCollections(config, pluginConfig, variantToParent) {
+  const patchedCollections = (config.collections ?? []).map((collection) => {
+    const parentSlug = variantToParent.get(collection.slug);
+    if (!parentSlug) return collection;
+    const abConfig = pluginConfig.collections[parentSlug];
+    if (!abConfig) return collection;
+    return {
+      ...collection,
+      hooks: {
+        ...collection.hooks,
+        afterChange: [
+          ...collection.hooks?.afterChange ?? [],
+          buildAfterChangeHook(parentSlug, abConfig, pluginConfig)
+        ],
+        afterDelete: [
+          ...collection.hooks?.afterDelete ?? [],
+          buildAfterDeleteHook(parentSlug, abConfig, pluginConfig)
+        ]
+      }
+    };
+  });
+  return patchedCollections;
+}
+
+// src/plugin.ts
+var abTestingPlugin = (pluginConfig) => (incomingConfig) => {
+  const { enabled = true, debug = false, collections, storage } = pluginConfig;
+  if (!enabled) return incomingConfig;
+  const extraGlobals = storage.createGlobal ? [storage.createGlobal(debug)] : [];
+  const variantToParent = buildVariantToParentCollectionSlugsMap(collections);
+  const patchedCollections = addHooksToVariantCollections(
+    incomingConfig,
+    pluginConfig,
+    variantToParent
+  );
+  return {
+    ...incomingConfig,
+    collections: patchedCollections,
+    globals: [...incomingConfig.globals ?? [], ...extraGlobals]
+  };
+};
+
+// src/adapters/payloadGlobal/api/fetchManifest.ts
+async function fetchManifest(serverURL, apiRoute, slug, path) {
+  try {
+    const res = await fetch(`${serverURL}${apiRoute}/globals/${slug}`, {
+      cache: "no-store"
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data?.manifest?.[path] ?? null;
+  } catch {
+    return null;
+  }
+}
+
+// src/adapters/payloadGlobal/api/readManifest.ts
+async function readManifest(payload, slug) {
+  try {
+    const doc = await payload.findGlobal({ slug, overrideAccess: true });
+    return doc?.manifest ?? {};
+  } catch {
+    return {};
+  }
+}
+
+// src/adapters/payloadGlobal/utils/createGlobal.ts
+function createGlobal(slug, debug) {
+  return {
+    slug,
+    access: {
+      read: () => true
+    },
+    admin: {
+      hidden: !debug,
+      group: "System"
+    },
+    fields: [
+      {
+        name: "manifest",
+        type: "json",
+        admin: {
+          description: "A/B testing manifest. Managed automatically \u2014 do not edit manually."
+        }
+      }
+    ]
+  };
+}
+
+// src/adapters/payloadGlobal/index.ts
+function payloadGlobalAdapter(config) {
+  const slug = config?.globalSlug ?? "_abManifest";
+  return {
+    async write(path, variants, payload) {
+      const currentManifest = await readManifest(payload, slug);
+      await payload.updateGlobal({
+        slug,
+        data: { manifest: { ...currentManifest, [path]: variants } },
+        overrideAccess: true
+      });
+    },
+    async read(path) {
+      const serverURL = config?.serverURL ?? "";
+      const apiRoute = config?.apiRoute ?? "/api";
+      return fetchManifest(serverURL, apiRoute, slug, path);
+    },
+    async clear(path, payload) {
+      const currentManifest = await readManifest(payload, slug);
+      delete currentManifest[path];
+      await payload.updateGlobal({
+        slug,
+        data: { manifest: currentManifest },
+        overrideAccess: true
+      });
+    },
+    createGlobal(debug = false) {
+      return createGlobal(slug, debug);
+    }
+  };
+}
+
+// src/adapters/vercelEdge/api/readManifest.ts
+async function readManifest2(manifestKey) {
+  try {
+    const { get } = await import("@vercel/edge-config");
+    const manifest = await get(manifestKey);
+    return manifest ?? {};
+  } catch {
+    return {};
+  }
+}
+
+// src/adapters/vercelEdge/utils/buildHeaders.ts
+function buildHeaders(config) {
+  return {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${config.vercelRestAPIAccessToken}`
+  };
+}
+
+// src/adapters/vercelEdge/api/updateEdgeConfig.ts
+async function updateEdgeConfig(config, manifestKey, value) {
+  const teamQuery = config.teamID ? `?teamId=${config.teamID}` : "";
+  await fetch(`https://api.vercel.com/v1/edge-config/${config.configID}/items${teamQuery}`, {
+    method: "PATCH",
+    headers: buildHeaders(config),
+    body: JSON.stringify({ items: [{ operation: "upsert", key: manifestKey, value }] })
+  });
+}
+
+// src/adapters/vercelEdge/index.ts
+function vercelEdgeAdapter(config) {
+  const manifestKey = config.manifestKey ?? "ab-testing";
+  let localCache = null;
+  async function getManifest() {
+    if (localCache === null) {
+      localCache = await readManifest2(manifestKey);
+    }
+    return localCache;
+  }
+  return {
+    async write(path, variants) {
+      const currentManifest = await getManifest();
+      localCache = { ...currentManifest, [path]: variants };
+      await updateEdgeConfig(config, manifestKey, localCache);
+    },
+    async read(path) {
+      try {
+        const manifest = await readManifest2(manifestKey);
+        return manifest?.[path] ?? null;
+      } catch {
+        return null;
+      }
+    },
+    async clear(path) {
+      const currentManifest = await getManifest();
+      const updated = { ...currentManifest };
+      delete updated[path];
+      localCache = updated;
+      await updateEdgeConfig(config, manifestKey, localCache);
+    }
+  };
+}
+export {
+  abTestingPlugin,
+  payloadGlobalAdapter,
+  vercelEdgeAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/buildVariantToParentCollectionSlugsMap.ts","../src/utils/resolveId.ts","../src/utils/getLocales.ts","../src/hooks/buildAfterChangeHook.ts","../src/hooks/buildAfterDeleteHook.ts","../src/utils/addHooksToVariantCollections.ts","../src/plugin.ts","../src/adapters/payloadGlobal/api/fetchManifest.ts","../src/adapters/payloadGlobal/api/readManifest.ts","../src/adapters/payloadGlobal/utils/createGlobal.ts","../src/adapters/payloadGlobal/index.ts","../src/adapters/vercelEdge/api/readManifest.ts","../src/adapters/vercelEdge/utils/buildHeaders.ts","../src/adapters/vercelEdge/api/updateEdgeConfig.ts","../src/adapters/vercelEdge/index.ts"],"sourcesContent":["import type { CollectionABConfig } from \"../types/config\";\n\nexport function buildVariantToParentCollectionSlugsMap<TVariantData extends object>(\n  collections: Record<string, CollectionABConfig<TVariantData>>,\n) {\n  const variantToParent = new Map<string, string>();\n\n  for (const [parentSlug, abConfig] of Object.entries(collections)) {\n    if (abConfig) variantToParent.set(abConfig.variantCollectionSlug, parentSlug);\n  }\n\n  return variantToParent;\n}\n","interface BaseDocument {\n  id: number | string;\n}\n\nconst isValueIsBaseDocument = (value: object): value is BaseDocument => {\n  return \"id\" in value;\n};\n\nexport function resolveId(value: unknown) {\n  if (!value) return null;\n\n  if (typeof value === \"number\" || typeof value === \"string\") return value;\n\n  if (typeof value === \"object\" && isValueIsBaseDocument(value)) {\n    return value.id;\n  }\n\n  return null;\n}\n","import type { Payload } from \"payload\";\n\nexport function getLocales(payload: Payload): string[] {\n  const localization = payload.config.localization;\n\n  const locales = localization ? (localization.locales ?? []) : [];\n\n  return locales.map((l) => (typeof l === \"string\" ? l : (l.code ?? String(l))));\n}\n","import type { CollectionAfterChangeHook, CollectionSlug, TypedLocale } from \"payload\";\nimport type { AbTestingPluginConfig, CollectionABConfig } from \"../types/config\";\nimport { resolveId } from \"../utils/resolveId\";\nimport { getLocales } from \"../utils/getLocales\";\n\nexport function buildAfterChangeHook<TVariantData extends object>(\n  parentCollectionSlug: string,\n  abConfig: CollectionABConfig<TVariantData>,\n  pluginConfig: AbTestingPluginConfig<TVariantData>,\n): CollectionAfterChangeHook {\n  return async ({ doc, req, previousDoc }) => {\n    const { payload } = req;\n    if (!payload) return;\n\n    const pageId = resolveId(doc.page);\n    if (!pageId) return;\n\n    const locales = getLocales(payload);\n\n    const previousPageId = previousDoc ? resolveId(previousDoc.page) : null;\n    if (previousPageId && previousPageId !== pageId) {\n      for (const locale of locales) {\n        const oldPageDoc = await payload.findByID({\n          collection: parentCollectionSlug as CollectionSlug,\n          id: previousPageId,\n          depth: 2,\n          locale: locale as TypedLocale,\n          overrideAccess: true,\n          req,\n        });\n        if (!oldPageDoc) continue;\n\n        const oldManifestKey = abConfig.generatePath({ doc: oldPageDoc, locale });\n        if (!oldManifestKey) continue;\n\n        const remainingOldVariants = await payload.find({\n          collection: abConfig.variantCollectionSlug as CollectionSlug,\n          where: {\n            and: [{ page: { equals: previousPageId } }, { id: { not_equals: doc.id } }],\n          },\n          depth: 2,\n          locale: locale as TypedLocale,\n          overrideAccess: true,\n          limit: 100,\n          req,\n        });\n\n        if (remainingOldVariants.docs.length === 0) {\n          await pluginConfig.storage.clear(oldManifestKey, payload);\n        } else {\n          const oldVariantData = remainingOldVariants.docs.map((variantDoc) =>\n            abConfig.generateVariantData({ doc: oldPageDoc, variantDoc, locale }),\n          );\n          await pluginConfig.storage.write(oldManifestKey, oldVariantData, payload);\n        }\n      }\n    }\n\n    for (const locale of locales) {\n      const pageDoc = await payload.findByID({\n        collection: parentCollectionSlug as CollectionSlug,\n        id: pageId,\n        depth: 2,\n        locale: locale as TypedLocale,\n        overrideAccess: true,\n        req,\n      });\n      if (!pageDoc) continue;\n\n      const manifestKey = abConfig.generatePath({ doc: pageDoc, locale });\n      if (!manifestKey) continue;\n\n      const allVariants = await payload.find({\n        collection: abConfig.variantCollectionSlug as CollectionSlug,\n        where: { page: { equals: pageId } },\n        depth: 2,\n        locale: locale as TypedLocale,\n        overrideAccess: true,\n        limit: 100,\n        req,\n      });\n\n      const variantData = allVariants.docs.map((variantDoc) =>\n        abConfig.generateVariantData({ doc: pageDoc, variantDoc, locale }),\n      );\n\n      await pluginConfig.storage.write(manifestKey, variantData, payload);\n    }\n  };\n}\n","import type { CollectionAfterDeleteHook, CollectionSlug, TypedLocale } from \"payload\";\nimport type { AbTestingPluginConfig, CollectionABConfig } from \"../types/config\";\nimport { resolveId } from \"../utils/resolveId\";\nimport { getLocales } from \"../utils/getLocales\";\n\nexport function buildAfterDeleteHook<TVariantData extends object>(\n  parentCollectionSlug: string,\n  abConfig: CollectionABConfig<TVariantData>,\n  pluginConfig: AbTestingPluginConfig<TVariantData>,\n): CollectionAfterDeleteHook {\n  return async ({ doc, req, id }) => {\n    const { payload } = req;\n    if (!payload) return;\n\n    const pageId = resolveId(doc.page);\n    if (!pageId) return;\n\n    const locales = getLocales(payload);\n\n    for (const locale of locales) {\n      const pageDoc = await payload.findByID({\n        collection: parentCollectionSlug as CollectionSlug,\n        id: pageId,\n        depth: 2,\n        locale: locale as TypedLocale,\n        overrideAccess: true,\n        req,\n      });\n      if (!pageDoc) continue;\n\n      const manifestKey = abConfig.generatePath({ doc: pageDoc, locale });\n      if (!manifestKey) continue;\n\n      const remainingVariants = await payload.find({\n        collection: abConfig.variantCollectionSlug as CollectionSlug,\n        where: {\n          and: [{ page: { equals: pageId } }, { id: { not_equals: id } }],\n        },\n        depth: 2,\n        locale: locale as TypedLocale,\n        overrideAccess: true,\n        limit: 100,\n        req,\n      });\n\n      if (remainingVariants.docs.length === 0) {\n        await pluginConfig.storage.clear(manifestKey, payload);\n      } else {\n        const variantData = remainingVariants.docs.map((variantDoc) =>\n          abConfig.generateVariantData({ doc: pageDoc, variantDoc, locale }),\n        );\n\n        await pluginConfig.storage.write(manifestKey, variantData, payload);\n      }\n    }\n  };\n}\n","import type { CollectionConfig, Config } from \"payload\";\nimport type { AbTestingPluginConfig } from \"../types/config\";\nimport { buildAfterChangeHook } from \"../hooks/buildAfterChangeHook\";\nimport { buildAfterDeleteHook } from \"../hooks/buildAfterDeleteHook\";\n\nexport function addHooksToVariantCollections<TVariantData extends object>(\n  config: Config,\n  pluginConfig: AbTestingPluginConfig<TVariantData>,\n  variantToParent: Map<string, string>,\n) {\n  const patchedCollections = (config.collections ?? []).map((collection) => {\n    const parentSlug = variantToParent.get(collection.slug);\n    if (!parentSlug) return collection;\n\n    const abConfig = pluginConfig.collections[parentSlug];\n    if (!abConfig) return collection;\n\n    return {\n      ...collection,\n      hooks: {\n        ...collection.hooks,\n        afterChange: [\n          ...(collection.hooks?.afterChange ?? []),\n          buildAfterChangeHook(parentSlug, abConfig, pluginConfig),\n        ],\n        afterDelete: [\n          ...(collection.hooks?.afterDelete ?? []),\n          buildAfterDeleteHook(parentSlug, abConfig, pluginConfig),\n        ],\n      },\n    } as CollectionConfig;\n  });\n\n  return patchedCollections;\n}\n","import type { Config, Plugin } from \"payload\";\nimport type { AbTestingPluginConfig } from \"./types/config\";\nimport { buildVariantToParentCollectionSlugsMap } from \"./utils/buildVariantToParentCollectionSlugsMap\";\nimport { addHooksToVariantCollections } from \"./utils/addHooksToVariantCollections\";\n\nexport const abTestingPlugin =\n  <TVariantData extends object>(pluginConfig: AbTestingPluginConfig<TVariantData>): Plugin =>\n  (incomingConfig: Config): Config => {\n    const { enabled = true, debug = false, collections, storage } = pluginConfig;\n\n    if (!enabled) return incomingConfig;\n\n    const extraGlobals = storage.createGlobal ? [storage.createGlobal(debug)] : [];\n\n    const variantToParent = buildVariantToParentCollectionSlugsMap<TVariantData>(collections);\n\n    const patchedCollections = addHooksToVariantCollections<TVariantData>(\n      incomingConfig,\n      pluginConfig,\n      variantToParent,\n    );\n\n    return {\n      ...incomingConfig,\n      collections: patchedCollections,\n      globals: [...(incomingConfig.globals ?? []), ...extraGlobals],\n    };\n  };\n","export async function fetchManifest<TVariantData extends object>(\n  serverURL: string,\n  apiRoute: string,\n  slug: string,\n  path: string,\n): Promise<TVariantData[] | null> {\n  try {\n    const res = await fetch(`${serverURL}${apiRoute}/globals/${slug}`, {\n      cache: \"no-store\",\n    });\n\n    if (!res.ok) return null;\n\n    const data = await res.json();\n\n    return (data?.manifest?.[path] as TVariantData[]) ?? null;\n  } catch {\n    return null;\n  }\n}\n","import type { GlobalSlug, Payload } from \"payload\";\nimport type { Manifest } from \"../../../types/manifest\";\n\nexport async function readManifest(payload: Payload, slug: string): Promise<Manifest> {\n  try {\n    const doc = await payload.findGlobal({ slug: slug as GlobalSlug, overrideAccess: true });\n\n    return (doc?.manifest as Manifest) ?? {};\n  } catch {\n    return {};\n  }\n}\n","import type { GlobalConfig } from \"payload\";\n\nexport function createGlobal(slug: string, debug: boolean): GlobalConfig {\n  return {\n    slug,\n    access: {\n      read: () => true,\n    },\n    admin: {\n      hidden: !debug,\n      group: \"System\",\n    },\n    fields: [\n      {\n        name: \"manifest\",\n        type: \"json\",\n        admin: {\n          description: \"A/B testing manifest. Managed automatically — do not edit manually.\",\n        },\n      },\n    ],\n  };\n}\n","import type { GlobalSlug } from \"payload\";\nimport type { StorageAdapter } from \"../../types/config\";\nimport type { PayloadGlobalAdapterConfig } from \"./config\";\nimport { fetchManifest } from \"./api/fetchManifest\";\nimport { readManifest } from \"./api/readManifest\";\nimport { createGlobal } from \"./utils/createGlobal\";\n\nexport function payloadGlobalAdapter<TVariantData extends object>(\n  config?: PayloadGlobalAdapterConfig,\n): StorageAdapter<TVariantData> {\n  const slug = config?.globalSlug ?? \"_abManifest\";\n\n  return {\n    async write(path, variants, payload) {\n      const currentManifest = await readManifest(payload, slug);\n\n      await payload.updateGlobal({\n        slug: slug as GlobalSlug,\n        data: { manifest: { ...currentManifest, [path]: variants } },\n        overrideAccess: true,\n      });\n    },\n\n    async read(path) {\n      const serverURL = config?.serverURL ?? \"\";\n      const apiRoute = config?.apiRoute ?? \"/api\";\n\n      return fetchManifest<TVariantData>(serverURL, apiRoute, slug, path);\n    },\n\n    async clear(path, payload) {\n      const currentManifest = await readManifest(payload, slug);\n\n      delete currentManifest[path];\n\n      await payload.updateGlobal({\n        slug: slug as GlobalSlug,\n        data: { manifest: currentManifest },\n        overrideAccess: true,\n      });\n    },\n\n    createGlobal(debug = false) {\n      return createGlobal(slug, debug);\n    },\n  };\n}\n","import type { Manifest } from \"../../../types/manifest\";\n\nexport async function readManifest<TVariantData extends object = object>(\n  manifestKey: string,\n): Promise<Manifest<TVariantData>> {\n  try {\n    const { get } = await import(\"@vercel/edge-config\");\n\n    const manifest = await get<Manifest<TVariantData>>(manifestKey);\n\n    return manifest ?? {};\n  } catch {\n    return {};\n  }\n}\n","import type { VercelEdgeAdapterConfig } from \"../config\";\n\nexport function buildHeaders(config: VercelEdgeAdapterConfig): Record<string, string> {\n  return {\n    \"Content-Type\": \"application/json\",\n    Authorization: `Bearer ${config.vercelRestAPIAccessToken}`,\n  };\n}\n","import type { VercelEdgeAdapterConfig } from \"../config\";\nimport { buildHeaders } from \"../utils/buildHeaders\";\n\nexport async function updateEdgeConfig(config: VercelEdgeAdapterConfig, manifestKey: string, value: unknown) {\n  const teamQuery = config.teamID ? `?teamId=${config.teamID}` : \"\";\n\n  await fetch(`https://api.vercel.com/v1/edge-config/${config.configID}/items${teamQuery}`, {\n    method: \"PATCH\",\n    headers: buildHeaders(config),\n    body: JSON.stringify({ items: [{ operation: \"upsert\", key: manifestKey, value }] }),\n  });\n}\n","import type { StorageAdapter } from \"../../types/config\";\nimport type { Manifest } from \"../../types/manifest\";\nimport { readManifest } from \"./api/readManifest\";\nimport { updateEdgeConfig } from \"./api/updateEdgeConfig\";\nimport type { VercelEdgeAdapterConfig } from \"./config\";\n\n/**\n * Vercel Edge Config adapter.\n * Requires \"pnpm add \\@vercel/edge-config\" and the following env vars:\n *   EDGE_CONFIG, EDGE_CONFIG_ID, VERCEL_REST_API_ACCESS_TOKEN\n */\nexport function vercelEdgeAdapter<TVariantData extends object>(\n  config: VercelEdgeAdapterConfig,\n): StorageAdapter<TVariantData> {\n  const manifestKey = config.manifestKey ?? \"ab-testing\";\n  let localCache: Manifest<TVariantData> | null = null;\n\n  async function getManifest() {\n    if (localCache === null) {\n      localCache = await readManifest<TVariantData>(manifestKey);\n    }\n\n    return localCache;\n  }\n\n  return {\n    async write(path, variants) {\n      const currentManifest = await getManifest();\n\n      localCache = { ...currentManifest, [path]: variants };\n\n      await updateEdgeConfig(config, manifestKey, localCache);\n    },\n\n    async read(path) {\n      try {\n        const manifest = await readManifest<TVariantData>(manifestKey);\n\n        return manifest?.[path] ?? null;\n      } catch {\n        return null;\n      }\n    },\n\n    async clear(path) {\n      const currentManifest = await getManifest();\n      const updated = { ...currentManifest };\n\n      delete updated[path];\n\n      localCache = updated;\n\n      await updateEdgeConfig(config, manifestKey, localCache);\n    },\n  };\n}\n"],"mappings":"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","names":["readManifest","readManifest"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@kiryl.pekarski/payload-plugin-ab",
+  "version": "1.0.0",
+  "description": "A/B testing plugin for Payload CMS",
+  "keywords": [
+    "payload-cms",
+    "payload-plugin",
+    "ab-testing",
+    "split-testing",
+    "a-b-testing",
+    "page-variants",
+    "next.js",
+    "vercel-edge",
+    "edge-config",
+    "middleware",
+    "typescript",
+    "cms",
+    "conversion-optimization"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/focusreactive/payload-plugin-ab"
+  },
+  "author": "Kiryl Pekarski <kiryl.pekarski@fr.team>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./adapters/payload-global": {
+      "import": "./dist/adapters/payloadGlobal/index.js",
+      "types": "./dist/adapters/payloadGlobal/index.d.ts"
+    },
+    "./adapters/vercel-edge": {
+      "import": "./dist/adapters/vercelEdge/index.js",
+      "types": "./dist/adapters/vercelEdge/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/"
+  },
+  "peerDependencies": {
+    "payload": "^3.0.0"
+  },
+  "optionalDependencies": {
+    "@vercel/edge-config": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "payload": "^3.73.0",
+    "prettier": "^3.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.0.0"
+  }
+}