@focus-reactive/payload-plugin-ab 1.0.0

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

@@ -0,0 +1,15 @@
+import { S as StorageAdapter } from '../../config-Bq-Mi7k_.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-Bq-Mi7k_.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/analytics/adapters/googleAnalytics/index.d.ts

@@ -0,0 +1,30 @@
+import { A as AnalyticsAdapter } from '../../../types-OJFBnrUD.js';
+
+interface GoogleAnalyticsAdapterConfig {
+    /** GA4 Measurement ID, e.g. "G-XXXXXXXXXX" */
+    measurementId: string;
+    /** GA4 Measurement Protocol API secret — enables trackImpressionServer() */
+    apiSecret?: string;
+    /**
+     * GA4 Property resource name for the Data API — enables getStats().
+     * Format: "properties/XXXXXXXXX"
+     */
+    propertyId?: string;
+    /**
+     * Returns a valid OAuth2 access token for the GA4 Data API.
+     * Required for getStats(). Scopes needed: analytics.readonly.
+     * @example
+     *   import { GoogleAuth } from 'google-auth-library'
+     *   const auth = new GoogleAuth({ scopes: ['https://www.googleapis.com/auth/analytics.readonly'] })
+     *   getAccessToken: () => auth.getAccessToken()
+     */
+    getAccessToken?: () => Promise<string>;
+    /** Custom event name for impressions. Default: 'ab_impression' */
+    impressionEventName?: string;
+    /** Custom event name for conversions. Default: 'ab_conversion' */
+    conversionEventName?: string;
+}
+
+declare function googleAnalyticsAdapter(config: GoogleAnalyticsAdapterConfig): AnalyticsAdapter;
+
+export { type GoogleAnalyticsAdapterConfig, googleAnalyticsAdapter };

package/dist/analytics/adapters/googleAnalytics/index.js

@@ -0,0 +1,188 @@
+// src/analytics/adapters/googleAnalytics/constants.ts
+var DEFAULT_IMPRESSION_EVENT_NAME = "ab_impression";
+var DEFAULT_CONVERSION_EVENT_NAME = "ab_conversion";
+var MEASUREMENT_PROTOCOL_URL = "https://www.google-analytics.com/mp/collect";
+var DATA_API_BASE = "https://analyticsdata.googleapis.com/v1beta";
+
+// src/analytics/adapters/googleAnalytics/utils/canUseGtag.ts
+var canUseGtag = (window2) => {
+  return typeof window2 !== "undefined" && typeof window2.gtag === "function";
+};
+
+// src/analytics/adapters/googleAnalytics/utils/waitForGtag.ts
+function waitForGtag(callback, options = {}) {
+  const { interval = 50, timeout = 5e3 } = options;
+  if (canUseGtag(window)) {
+    callback(window.gtag);
+    return;
+  }
+  const start = Date.now();
+  const id = setInterval(() => {
+    if (canUseGtag(window)) {
+      clearInterval(id);
+      callback(window.gtag);
+    } else if (Date.now() - start >= timeout) {
+      clearInterval(id);
+    }
+  }, interval);
+}
+
+// src/analytics/adapters/googleAnalytics/client.ts
+function trackImpressionClient(config, { experimentId, variantBucket, visitorId, locale, metadata }) {
+  waitForGtag((gtag) => {
+    gtag("event", config.impressionEventName ?? DEFAULT_IMPRESSION_EVENT_NAME, {
+      experiment_id: experimentId,
+      variant_bucket: variantBucket,
+      visitor_id: visitorId,
+      ...locale !== void 0 && { locale },
+      ...metadata
+    });
+  });
+}
+function trackConversionClient(config, { experimentId, goalId, variantBucket, visitorId, goalValue, locale, metadata }) {
+  if (!canUseGtag(window)) {
+    return;
+  }
+  window.gtag("event", config.conversionEventName ?? DEFAULT_CONVERSION_EVENT_NAME, {
+    experiment_id: experimentId,
+    variant_bucket: variantBucket,
+    visitor_id: visitorId,
+    goal_id: goalId,
+    ...goalValue !== void 0 && { value: goalValue },
+    ...locale !== void 0 && { locale },
+    ...metadata
+  });
+}
+
+// src/analytics/adapters/googleAnalytics/server.ts
+async function trackImpressionServer(config, { experimentId, variantBucket, visitorId, locale, metadata }) {
+  if (!config.apiSecret) return;
+  const url = `${MEASUREMENT_PROTOCOL_URL}?measurement_id=${config.measurementId}&api_secret=${config.apiSecret}`;
+  await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      client_id: visitorId,
+      events: [
+        {
+          name: config.impressionEventName ?? DEFAULT_IMPRESSION_EVENT_NAME,
+          params: {
+            experiment_id: experimentId,
+            variant_bucket: variantBucket,
+            visitor_id: visitorId,
+            engagement_time_msec: 1,
+            ...locale !== void 0 && { locale },
+            ...metadata
+          }
+        }
+      ]
+    })
+  });
+}
+
+// src/analytics/adapters/googleAnalytics/stats.ts
+function parseReport(report) {
+  const result = /* @__PURE__ */ new Map();
+  if (!report) return result;
+  for (const row of report.rows ?? []) {
+    const bucket = row.dimensionValues[0]?.value;
+    const raw = row.metricValues[0]?.value;
+    if (bucket != null && raw != null) {
+      result.set(bucket, parseInt(raw, 10));
+    }
+  }
+  return result;
+}
+async function getExperimentStats(config, experimentId, dateRange = { startDate: "30daysAgo", endDate: "today" }) {
+  if (!config.propertyId || !config.getAccessToken) {
+    throw new Error(
+      "payload-plugin-ab: getStats() requires propertyId and getAccessToken to be set in GoogleAnalyticsAdapterConfig."
+    );
+  }
+  const accessToken = await config.getAccessToken();
+  const url = `${DATA_API_BASE}/${config.propertyId}:batchRunReports`;
+  const makeReport = (eventName) => ({
+    dimensions: [{ name: "customEvent:variant_bucket" }],
+    metrics: [{ name: "eventCount" }],
+    dimensionFilter: {
+      andGroup: {
+        expressions: [
+          {
+            filter: {
+              fieldName: "eventName",
+              stringFilter: { matchType: "EXACT", value: eventName }
+            }
+          },
+          {
+            filter: {
+              fieldName: "customEvent:experiment_id",
+              stringFilter: { matchType: "EXACT", value: experimentId }
+            }
+          }
+        ]
+      }
+    },
+    dateRanges: [dateRange]
+  });
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${accessToken}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      requests: [
+        makeReport(config.impressionEventName ?? DEFAULT_IMPRESSION_EVENT_NAME),
+        makeReport(config.conversionEventName ?? DEFAULT_CONVERSION_EVENT_NAME)
+      ]
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`payload-plugin-ab: GA4 Data API responded with ${res.status}: ${body}`);
+  }
+  const data = await res.json();
+  const impressionMap = parseReport(data.reports[0]);
+  const conversionMap = parseReport(data.reports[1]);
+  const allBuckets = /* @__PURE__ */ new Set([...impressionMap.keys(), ...conversionMap.keys()]);
+  const totalImpressions = [...impressionMap.values()].reduce((acc, n) => acc + n, 0);
+  const totalConversions = [...conversionMap.values()].reduce((acc, n) => acc + n, 0);
+  const variants = [...allBuckets].map((bucket) => {
+    const impressions = impressionMap.get(bucket) ?? 0;
+    const conversions = conversionMap.get(bucket) ?? 0;
+    return {
+      bucket,
+      impressions,
+      impressionShare: totalImpressions > 0 ? impressions / totalImpressions : 0,
+      conversions,
+      conversionRate: impressions > 0 ? conversions / impressions : 0
+    };
+  });
+  return {
+    experimentId,
+    dateRange,
+    variants,
+    totals: {
+      impressions: totalImpressions,
+      conversions: totalConversions
+    }
+  };
+}
+
+// src/analytics/adapters/googleAnalytics/index.ts
+function googleAnalyticsAdapter(config) {
+  return {
+    trackImpression: (args) => trackImpressionClient(config, args),
+    trackConversion: (args) => trackConversionClient(config, args),
+    ...config.apiSecret != null && {
+      trackImpressionServer: (args) => trackImpressionServer(config, args)
+    },
+    ...config.propertyId != null && config.getAccessToken != null && {
+      getStats: (experimentId, dateRange) => getExperimentStats(config, experimentId, dateRange)
+    }
+  };
+}
+export {
+  googleAnalyticsAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/analytics/adapters/googleAnalytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/analytics/adapters/googleAnalytics/constants.ts","../../../../src/analytics/adapters/googleAnalytics/utils/canUseGtag.ts","../../../../src/analytics/adapters/googleAnalytics/utils/waitForGtag.ts","../../../../src/analytics/adapters/googleAnalytics/client.ts","../../../../src/analytics/adapters/googleAnalytics/server.ts","../../../../src/analytics/adapters/googleAnalytics/stats.ts","../../../../src/analytics/adapters/googleAnalytics/index.ts"],"sourcesContent":["export const DEFAULT_IMPRESSION_EVENT_NAME = \"ab_impression\";\n\nexport const DEFAULT_CONVERSION_EVENT_NAME = \"ab_conversion\";\n\nexport const MEASUREMENT_PROTOCOL_URL = \"https://www.google-analytics.com/mp/collect\";\n\nexport const DATA_API_BASE = \"https://analyticsdata.googleapis.com/v1beta\";\n","export type WindowWithGtag = Window & { gtag: NonNullable<Window[\"gtag\"]> };\n\nexport const canUseGtag = (window: Window): window is WindowWithGtag => {\n  return typeof window !== \"undefined\" && typeof window.gtag === \"function\";\n};\n","import { canUseGtag, type WindowWithGtag } from \"./canUseGtag\";\n\ntype GtagFn = WindowWithGtag[\"gtag\"];\n\ninterface WaitForGtagOptions {\n  interval?: number;\n  timeout?: number;\n}\n\nexport function waitForGtag(callback: (gtag: GtagFn) => void, options: WaitForGtagOptions = {}) {\n  const { interval = 50, timeout = 5000 } = options;\n\n  if (canUseGtag(window)) {\n    callback(window.gtag);\n\n    return;\n  }\n\n  const start = Date.now();\n  const id = setInterval(() => {\n    if (canUseGtag(window)) {\n      clearInterval(id);\n\n      callback(window.gtag);\n    } else if (Date.now() - start >= timeout) {\n      clearInterval(id);\n    }\n  }, interval);\n}\n","import type { TrackConversionArgs, TrackImpressionArgs } from \"../../types\";\nimport type { GoogleAnalyticsAdapterConfig } from \"./types\";\nimport { DEFAULT_CONVERSION_EVENT_NAME, DEFAULT_IMPRESSION_EVENT_NAME } from \"./constants\";\nimport { canUseGtag } from \"./utils/canUseGtag\";\nimport { waitForGtag } from \"./utils/waitForGtag\";\n\ndeclare global {\n  interface Window {\n    gtag?: (command: \"event\", eventName: string, params: Record<string, unknown>) => void;\n  }\n}\n\nexport function trackImpressionClient(\n  config: GoogleAnalyticsAdapterConfig,\n  { experimentId, variantBucket, visitorId, locale, metadata }: TrackImpressionArgs,\n) {\n  waitForGtag((gtag) => {\n    gtag(\"event\", config.impressionEventName ?? DEFAULT_IMPRESSION_EVENT_NAME, {\n      experiment_id: experimentId,\n      variant_bucket: variantBucket,\n      visitor_id: visitorId,\n      ...(locale !== undefined && { locale }),\n      ...metadata,\n    });\n  });\n}\n\nexport function trackConversionClient(\n  config: GoogleAnalyticsAdapterConfig,\n  { experimentId, goalId, variantBucket, visitorId, goalValue, locale, metadata }: TrackConversionArgs,\n) {\n  if (!canUseGtag(window)) {\n    return;\n  }\n\n  window.gtag(\"event\", config.conversionEventName ?? DEFAULT_CONVERSION_EVENT_NAME, {\n    experiment_id: experimentId,\n    variant_bucket: variantBucket,\n    visitor_id: visitorId,\n    goal_id: goalId,\n    ...(goalValue !== undefined && { value: goalValue }),\n    ...(locale !== undefined && { locale }),\n    ...metadata,\n  });\n}\n","import type { TrackImpressionArgs } from \"../../types\";\nimport { DEFAULT_IMPRESSION_EVENT_NAME, MEASUREMENT_PROTOCOL_URL } from \"./constants\";\nimport type { GoogleAnalyticsAdapterConfig } from \"./types\";\n\nexport async function trackImpressionServer(\n  config: GoogleAnalyticsAdapterConfig,\n  { experimentId, variantBucket, visitorId, locale, metadata }: TrackImpressionArgs,\n) {\n  if (!config.apiSecret) return;\n\n  const url = `${MEASUREMENT_PROTOCOL_URL}?measurement_id=${config.measurementId}&api_secret=${config.apiSecret}`;\n\n  await fetch(url, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({\n      client_id: visitorId,\n      events: [\n        {\n          name: config.impressionEventName ?? DEFAULT_IMPRESSION_EVENT_NAME,\n          params: {\n            experiment_id: experimentId,\n            variant_bucket: variantBucket,\n            visitor_id: visitorId,\n            engagement_time_msec: 1,\n            ...(locale !== undefined && { locale }),\n            ...metadata,\n          },\n        },\n      ],\n    }),\n  });\n}\n","import type { DateRange, ExperimentStats, VariantStats } from \"../../types\";\nimport { DATA_API_BASE, DEFAULT_CONVERSION_EVENT_NAME, DEFAULT_IMPRESSION_EVENT_NAME } from \"./constants\";\nimport type { GoogleAnalyticsAdapterConfig } from \"./types\";\n\ninterface GA4ReportRow {\n  dimensionValues: Array<{ value: string }>;\n  metricValues: Array<{ value: string }>;\n}\n\ninterface GA4Report {\n  rows?: GA4ReportRow[];\n}\n\ninterface GA4BatchResponse {\n  reports: GA4Report[];\n}\n\nfunction parseReport(report: GA4Report | undefined): Map<string, number> {\n  const result = new Map<string, number>();\n\n  if (!report) return result;\n\n  for (const row of report.rows ?? []) {\n    const bucket = row.dimensionValues[0]?.value;\n    const raw = row.metricValues[0]?.value;\n\n    if (bucket != null && raw != null) {\n      result.set(bucket, parseInt(raw, 10));\n    }\n  }\n\n  return result;\n}\n\nexport async function getExperimentStats(\n  config: GoogleAnalyticsAdapterConfig,\n  experimentId: string,\n  dateRange: DateRange = { startDate: \"30daysAgo\", endDate: \"today\" },\n): Promise<ExperimentStats> {\n  if (!config.propertyId || !config.getAccessToken) {\n    throw new Error(\n      \"payload-plugin-ab: getStats() requires propertyId and getAccessToken \"\n        + \"to be set in GoogleAnalyticsAdapterConfig.\",\n    );\n  }\n\n  const accessToken = await config.getAccessToken();\n  const url = `${DATA_API_BASE}/${config.propertyId}:batchRunReports`;\n\n  const makeReport = (eventName: string) => ({\n    dimensions: [{ name: \"customEvent:variant_bucket\" }],\n    metrics: [{ name: \"eventCount\" }],\n    dimensionFilter: {\n      andGroup: {\n        expressions: [\n          {\n            filter: {\n              fieldName: \"eventName\",\n              stringFilter: { matchType: \"EXACT\", value: eventName },\n            },\n          },\n          {\n            filter: {\n              fieldName: \"customEvent:experiment_id\",\n              stringFilter: { matchType: \"EXACT\", value: experimentId },\n            },\n          },\n        ],\n      },\n    },\n    dateRanges: [dateRange],\n  });\n\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      Authorization: `Bearer ${accessToken}`,\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({\n      requests: [\n        makeReport(config.impressionEventName ?? DEFAULT_IMPRESSION_EVENT_NAME),\n        makeReport(config.conversionEventName ?? DEFAULT_CONVERSION_EVENT_NAME),\n      ],\n    }),\n  });\n\n  if (!res.ok) {\n    const body = await res.text();\n    throw new Error(`payload-plugin-ab: GA4 Data API responded with ${res.status}: ${body}`);\n  }\n\n  const data: GA4BatchResponse = await res.json();\n\n  const impressionMap = parseReport(data.reports[0]);\n  const conversionMap = parseReport(data.reports[1]);\n\n  const allBuckets = new Set([...impressionMap.keys(), ...conversionMap.keys()]);\n\n  const totalImpressions = [...impressionMap.values()].reduce((acc, n) => acc + n, 0);\n  const totalConversions = [...conversionMap.values()].reduce((acc, n) => acc + n, 0);\n\n  const variants: VariantStats[] = [...allBuckets].map((bucket) => {\n    const impressions = impressionMap.get(bucket) ?? 0;\n    const conversions = conversionMap.get(bucket) ?? 0;\n    return {\n      bucket,\n      impressions,\n      impressionShare: totalImpressions > 0 ? impressions / totalImpressions : 0,\n      conversions,\n      conversionRate: impressions > 0 ? conversions / impressions : 0,\n    };\n  });\n\n  return {\n    experimentId,\n    dateRange,\n    variants,\n    totals: {\n      impressions: totalImpressions,\n      conversions: totalConversions,\n    },\n  };\n}\n","import type { AnalyticsAdapter } from \"../../types\";\nimport { trackConversionClient, trackImpressionClient } from \"./client\";\nimport { trackImpressionServer } from \"./server\";\nimport { getExperimentStats } from \"./stats\";\nimport type { GoogleAnalyticsAdapterConfig } from \"./types\";\n\nexport type { GoogleAnalyticsAdapterConfig };\n\nexport function googleAnalyticsAdapter(config: GoogleAnalyticsAdapterConfig): AnalyticsAdapter {\n  return {\n    trackImpression: (args) => trackImpressionClient(config, args),\n    trackConversion: (args) => trackConversionClient(config, args),\n    ...(config.apiSecret != null && {\n      trackImpressionServer: (args) => trackImpressionServer(config, args),\n    }),\n    ...(config.propertyId != null\n      && config.getAccessToken != null && {\n        getStats: (experimentId, dateRange) => getExperimentStats(config, experimentId, dateRange),\n      }),\n  };\n}\n"],"mappings":"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","names":["window"]}

package/dist/analytics/client.d.ts

@@ -0,0 +1,48 @@
+export { A as AbCookieConfig, R as ResolvedAbCookieNames, r as resolveAbCookieNames } from '../resolveAbCookieNames-DH8evjWm.js';
+import { A as AnalyticsAdapter } from '../types-OJFBnrUD.js';
+
+interface ExperimentTrackerProps {
+    experimentId: string;
+    /**
+     * Name of the cookie that holds the assigned variant bucket.
+     * Use `resolveAbCookieNames(abCookies, experimentId).variantCookieName` to derive
+     * this from a shared `AbCookieConfig`. Default: `exp_${experimentId}`.
+     */
+    variantCookieName?: string;
+    /**
+     * Name of the visitor ID cookie.
+     * Use `resolveAbCookieNames(abCookies, experimentId).visitorCookieName` to derive
+     * this from a shared `AbCookieConfig`. Default: 'ab_visitor_id'.
+     */
+    visitorCookieName?: string;
+}
+declare function ExperimentTracker({ experimentId, variantCookieName, visitorCookieName, }: ExperimentTrackerProps): null;
+
+interface UseABConversionOptions {
+    experimentId: string;
+    /**
+     * Name of the cookie that holds the assigned variant bucket.
+     * Use `resolveAbCookieNames(abCookies, experimentId).variantCookieName` to derive
+     * this from a shared `AbCookieConfig`. Default: `exp_${experimentId}`.
+     */
+    variantCookieName?: string;
+    /**
+     * Name of the visitor ID cookie.
+     * Use `resolveAbCookieNames(abCookies, experimentId).visitorCookieName` to derive
+     * this from a shared `AbCookieConfig`. Default: 'ab_visitor_id'.
+     */
+    visitorCookieName?: string;
+}
+type TrackConversionFn = (args: {
+    goalId: string;
+    goalValue?: number;
+}) => void;
+declare function useABConversion({ experimentId, variantCookieName, visitorCookieName, }: UseABConversionOptions): TrackConversionFn;
+
+declare function useABAnalytics(): AnalyticsAdapter | null;
+declare function ABAnalyticsProvider({ adapter, children, }: {
+    adapter: AnalyticsAdapter;
+    children: React.ReactNode;
+}): React.ReactNode;
+
+export { ABAnalyticsProvider, ExperimentTracker, type ExperimentTrackerProps, type TrackConversionFn, type UseABConversionOptions, useABAnalytics, useABConversion };

package/dist/analytics/client.js

@@ -0,0 +1,102 @@
+"use client";
+
+// src/cookie/utils/defaultGetExpCookieName.ts
+function defaultGetExpCookieName(key) {
+  return `exp_${encodeURIComponent(key)}`;
+}
+
+// src/cookie/constants.ts
+var DEFAULT_VISITOR_ID_COOKIE_NAME = "ab_visitor_id";
+
+// src/cookie/utils/resolveAbCookieNames.ts
+function resolveAbCookieNames(config, experimentId) {
+  return {
+    variantCookieName: (config?.getExpCookieName ?? defaultGetExpCookieName)(experimentId),
+    visitorCookieName: config?.visitorIdCookieName ?? DEFAULT_VISITOR_ID_COOKIE_NAME
+  };
+}
+
+// src/analytics/components/ABAnalyticsProvider.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var ABAnalyticsContext = createContext(null);
+function useABAnalytics() {
+  return useContext(ABAnalyticsContext);
+}
+function ABAnalyticsProvider({
+  adapter,
+  children
+}) {
+  return /* @__PURE__ */ jsx(ABAnalyticsContext.Provider, { value: adapter, children });
+}
+
+// src/analytics/components/ExperimentTracker.tsx
+import { useEffect } from "react";
+
+// src/analytics/utils/getCookie.ts
+function getCookie(name) {
+  if (typeof document === "undefined") return null;
+  const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const match = document.cookie.match(new RegExp(`(?:^|; )${escaped}=([^;]*)`));
+  if (!match) return null;
+  const value = match[1];
+  return value != null ? decodeURIComponent(value) : null;
+}
+
+// src/analytics/components/ExperimentTracker.tsx
+function ExperimentTracker({
+  experimentId,
+  variantCookieName,
+  visitorCookieName = DEFAULT_VISITOR_ID_COOKIE_NAME
+}) {
+  const adapter = useABAnalytics();
+  useEffect(() => {
+    if (!adapter) return;
+    const sessionKey = `ab_tracked_${experimentId}`;
+    if (typeof sessionStorage !== "undefined" && sessionStorage.getItem(sessionKey)) {
+      return;
+    }
+    const resolvedVariantCookie = variantCookieName ?? defaultGetExpCookieName(experimentId);
+    const variantBucket = getCookie(resolvedVariantCookie);
+    const visitorId = getCookie(visitorCookieName);
+    if (!variantBucket || !visitorId) return;
+    adapter.trackImpression({ experimentId, variantBucket, visitorId });
+    sessionStorage.setItem(sessionKey, "1");
+  }, [adapter, experimentId, variantCookieName, visitorCookieName]);
+  return null;
+}
+
+// src/analytics/hooks/useABConversion.ts
+import { useCallback } from "react";
+function useABConversion({
+  experimentId,
+  variantCookieName,
+  visitorCookieName = DEFAULT_VISITOR_ID_COOKIE_NAME
+}) {
+  const adapter = useABAnalytics();
+  return useCallback(
+    ({ goalId, goalValue }) => {
+      if (!adapter) return;
+      const resolvedVariantCookie = variantCookieName ?? defaultGetExpCookieName(experimentId);
+      const variantBucket = getCookie(resolvedVariantCookie);
+      const visitorId = getCookie(visitorCookieName);
+      if (!variantBucket || !visitorId) return;
+      adapter.trackConversion({
+        experimentId,
+        variantBucket,
+        visitorId,
+        goalId,
+        goalValue
+      });
+    },
+    [adapter, experimentId, variantCookieName, visitorCookieName]
+  );
+}
+export {
+  ABAnalyticsProvider,
+  ExperimentTracker,
+  resolveAbCookieNames,
+  useABAnalytics,
+  useABConversion
+};
+//# sourceMappingURL=client.js.map

package/dist/analytics/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cookie/utils/defaultGetExpCookieName.ts","../../src/cookie/constants.ts","../../src/cookie/utils/resolveAbCookieNames.ts","../../src/analytics/components/ABAnalyticsProvider.tsx","../../src/analytics/components/ExperimentTracker.tsx","../../src/analytics/utils/getCookie.ts","../../src/analytics/hooks/useABConversion.ts"],"sourcesContent":["export function defaultGetExpCookieName(key: string) {\n  return `exp_${encodeURIComponent(key)}`;\n}\n","export const DEFAULT_VISITOR_ID_COOKIE_NAME = \"ab_visitor_id\";\n","import type { AbCookieConfig } from \"../types\";\nimport { defaultGetExpCookieName } from \"./defaultGetExpCookieName\";\nimport { DEFAULT_VISITOR_ID_COOKIE_NAME } from \"../constants\";\n\nexport interface ResolvedAbCookieNames {\n  /** Resolved variant cookie name for the given experiment. */\n  variantCookieName: string;\n  /** Resolved visitor ID cookie name. */\n  visitorCookieName: string;\n}\n\n/**\n * Resolves an `AbCookieConfig` + experiment ID into plain serializable strings.\n * Use this in Server Components to derive props for Client Components.\n */\nexport function resolveAbCookieNames(config: AbCookieConfig | undefined, experimentId: string): ResolvedAbCookieNames {\n  return {\n    variantCookieName: (config?.getExpCookieName ?? defaultGetExpCookieName)(experimentId),\n    visitorCookieName: config?.visitorIdCookieName ?? DEFAULT_VISITOR_ID_COOKIE_NAME,\n  };\n}\n","\"use client\";\n\nimport { createContext, useContext } from \"react\";\nimport type { AnalyticsAdapter } from \"../types\";\n\nexport const ABAnalyticsContext = createContext<AnalyticsAdapter | null>(null);\n\nexport function useABAnalytics() {\n  return useContext(ABAnalyticsContext);\n}\n\nexport function ABAnalyticsProvider({\n  adapter,\n  children,\n}: {\n  adapter: AnalyticsAdapter;\n  children: React.ReactNode;\n}): React.ReactNode {\n  return <ABAnalyticsContext.Provider value={adapter}>{children}</ABAnalyticsContext.Provider>;\n}\n","\"use client\";\n\nimport { useEffect } from \"react\";\nimport { getCookie } from \"../utils/getCookie\";\nimport { useABAnalytics } from \"./ABAnalyticsProvider\";\nimport { defaultGetExpCookieName } from \"../../cookie/utils/defaultGetExpCookieName\";\nimport { DEFAULT_VISITOR_ID_COOKIE_NAME } from \"../../cookie/constants\";\n\nexport interface ExperimentTrackerProps {\n  experimentId: string;\n  /**\n   * Name of the cookie that holds the assigned variant bucket.\n   * Use `resolveAbCookieNames(abCookies, experimentId).variantCookieName` to derive\n   * this from a shared `AbCookieConfig`. Default: `exp_${experimentId}`.\n   */\n  variantCookieName?: string;\n  /**\n   * Name of the visitor ID cookie.\n   * Use `resolveAbCookieNames(abCookies, experimentId).visitorCookieName` to derive\n   * this from a shared `AbCookieConfig`. Default: 'ab_visitor_id'.\n   */\n  visitorCookieName?: string;\n}\n\nexport function ExperimentTracker({\n  experimentId,\n  variantCookieName,\n  visitorCookieName = DEFAULT_VISITOR_ID_COOKIE_NAME,\n}: ExperimentTrackerProps) {\n  const adapter = useABAnalytics();\n\n  useEffect(() => {\n    if (!adapter) return;\n\n    const sessionKey = `ab_tracked_${experimentId}`;\n    if (typeof sessionStorage !== \"undefined\" && sessionStorage.getItem(sessionKey)) {\n      return;\n    }\n\n    const resolvedVariantCookie = variantCookieName ?? defaultGetExpCookieName(experimentId);\n    const variantBucket = getCookie(resolvedVariantCookie);\n    const visitorId = getCookie(visitorCookieName);\n\n    if (!variantBucket || !visitorId) return;\n\n    adapter.trackImpression({ experimentId, variantBucket, visitorId });\n\n    sessionStorage.setItem(sessionKey, \"1\");\n  }, [adapter, experimentId, variantCookieName, visitorCookieName]);\n\n  return null;\n}\n","export function getCookie(name: string) {\n  if (typeof document === \"undefined\") return null;\n\n  const escaped = name.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  const match = document.cookie.match(new RegExp(`(?:^|; )${escaped}=([^;]*)`));\n\n  if (!match) return null;\n\n  const value = match[1];\n\n  return value != null ? decodeURIComponent(value) : null;\n}\n","\"use client\";\n\nimport { useCallback } from \"react\";\nimport { useABAnalytics } from \"../components/ABAnalyticsProvider\";\nimport { getCookie } from \"../utils/getCookie\";\nimport { defaultGetExpCookieName } from \"../../cookie/utils/defaultGetExpCookieName\";\nimport { DEFAULT_VISITOR_ID_COOKIE_NAME } from \"../../cookie/constants\";\n\nexport interface UseABConversionOptions {\n  experimentId: string;\n  /**\n   * Name of the cookie that holds the assigned variant bucket.\n   * Use `resolveAbCookieNames(abCookies, experimentId).variantCookieName` to derive\n   * this from a shared `AbCookieConfig`. Default: `exp_${experimentId}`.\n   */\n  variantCookieName?: string;\n  /**\n   * Name of the visitor ID cookie.\n   * Use `resolveAbCookieNames(abCookies, experimentId).visitorCookieName` to derive\n   * this from a shared `AbCookieConfig`. Default: 'ab_visitor_id'.\n   */\n  visitorCookieName?: string;\n}\n\nexport type TrackConversionFn = (args: { goalId: string; goalValue?: number }) => void;\n\nexport function useABConversion({\n  experimentId,\n  variantCookieName,\n  visitorCookieName = DEFAULT_VISITOR_ID_COOKIE_NAME,\n}: UseABConversionOptions): TrackConversionFn {\n  const adapter = useABAnalytics();\n\n  return useCallback(\n    ({ goalId, goalValue }: { goalId: string; goalValue?: number }) => {\n      if (!adapter) return;\n\n      const resolvedVariantCookie = variantCookieName ?? defaultGetExpCookieName(experimentId);\n      const variantBucket = getCookie(resolvedVariantCookie);\n      const visitorId = getCookie(visitorCookieName);\n\n      if (!variantBucket || !visitorId) return;\n\n      adapter.trackConversion({\n        experimentId,\n        variantBucket,\n        visitorId,\n        goalId,\n        goalValue,\n      });\n    },\n    [adapter, experimentId, variantCookieName, visitorCookieName],\n  );\n}\n"],"mappings":";;;AAAO,SAAS,wBAAwB,KAAa;AACnD,SAAO,OAAO,mBAAmB,GAAG,CAAC;AACvC;;;ACFO,IAAM,iCAAiC;;;ACevC,SAAS,qBAAqB,QAAoC,cAA6C;AACpH,SAAO;AAAA,IACL,oBAAoB,QAAQ,oBAAoB,yBAAyB,YAAY;AAAA,IACrF,mBAAmB,QAAQ,uBAAuB;AAAA,EACpD;AACF;;;AClBA,SAAS,eAAe,kBAAkB;AAgBjC;AAbF,IAAM,qBAAqB,cAAuC,IAAI;AAEtE,SAAS,iBAAiB;AAC/B,SAAO,WAAW,kBAAkB;AACtC;AAEO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGoB;AAClB,SAAO,oBAAC,mBAAmB,UAAnB,EAA4B,OAAO,SAAU,UAAS;AAChE;;;ACjBA,SAAS,iBAAiB;;;ACFnB,SAAS,UAAU,MAAc;AACtC,MAAI,OAAO,aAAa,YAAa,QAAO;AAE5C,QAAM,UAAU,KAAK,QAAQ,uBAAuB,MAAM;AAC1D,QAAM,QAAQ,SAAS,OAAO,MAAM,IAAI,OAAO,WAAW,OAAO,UAAU,CAAC;AAE5E,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,QAAQ,MAAM,CAAC;AAErB,SAAO,SAAS,OAAO,mBAAmB,KAAK,IAAI;AACrD;;;ADaO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA,oBAAoB;AACtB,GAA2B;AACzB,QAAM,UAAU,eAAe;AAE/B,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AAEd,UAAM,aAAa,cAAc,YAAY;AAC7C,QAAI,OAAO,mBAAmB,eAAe,eAAe,QAAQ,UAAU,GAAG;AAC/E;AAAA,IACF;AAEA,UAAM,wBAAwB,qBAAqB,wBAAwB,YAAY;AACvF,UAAM,gBAAgB,UAAU,qBAAqB;AACrD,UAAM,YAAY,UAAU,iBAAiB;AAE7C,QAAI,CAAC,iBAAiB,CAAC,UAAW;AAElC,YAAQ,gBAAgB,EAAE,cAAc,eAAe,UAAU,CAAC;AAElE,mBAAe,QAAQ,YAAY,GAAG;AAAA,EACxC,GAAG,CAAC,SAAS,cAAc,mBAAmB,iBAAiB,CAAC;AAEhE,SAAO;AACT;;;AEjDA,SAAS,mBAAmB;AAwBrB,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA,oBAAoB;AACtB,GAA8C;AAC5C,QAAM,UAAU,eAAe;AAE/B,SAAO;AAAA,IACL,CAAC,EAAE,QAAQ,UAAU,MAA8C;AACjE,UAAI,CAAC,QAAS;AAEd,YAAM,wBAAwB,qBAAqB,wBAAwB,YAAY;AACvF,YAAM,gBAAgB,UAAU,qBAAqB;AACrD,YAAM,YAAY,UAAU,iBAAiB;AAE7C,UAAI,CAAC,iBAAiB,CAAC,UAAW;AAElC,cAAQ,gBAAgB;AAAA,QACtB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,CAAC,SAAS,cAAc,mBAAmB,iBAAiB;AAAA,EAC9D;AACF;","names":[]}

package/dist/analytics/index.d.ts

@@ -0,0 +1,2 @@
+export { A as AnalyticsAdapter, D as DateRange, E as ExperimentStats, T as TrackConversionArgs, a as TrackImpressionArgs, V as VariantStats } from '../types-OJFBnrUD.js';
+export { A as AbCookieConfig, R as ResolvedAbCookieNames, r as resolveAbCookieNames } from '../resolveAbCookieNames-DH8evjWm.js';

package/dist/analytics/index.js

@@ -0,0 +1,19 @@
+// src/cookie/utils/defaultGetExpCookieName.ts
+function defaultGetExpCookieName(key) {
+  return `exp_${encodeURIComponent(key)}`;
+}
+
+// src/cookie/constants.ts
+var DEFAULT_VISITOR_ID_COOKIE_NAME = "ab_visitor_id";
+
+// src/cookie/utils/resolveAbCookieNames.ts
+function resolveAbCookieNames(config, experimentId) {
+  return {
+    variantCookieName: (config?.getExpCookieName ?? defaultGetExpCookieName)(experimentId),
+    visitorCookieName: config?.visitorIdCookieName ?? DEFAULT_VISITOR_ID_COOKIE_NAME
+  };
+}
+export {
+  resolveAbCookieNames
+};
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cookie/utils/defaultGetExpCookieName.ts","../../src/cookie/constants.ts","../../src/cookie/utils/resolveAbCookieNames.ts"],"sourcesContent":["export function defaultGetExpCookieName(key: string) {\n  return `exp_${encodeURIComponent(key)}`;\n}\n","export const DEFAULT_VISITOR_ID_COOKIE_NAME = \"ab_visitor_id\";\n","import type { AbCookieConfig } from \"../types\";\nimport { defaultGetExpCookieName } from \"./defaultGetExpCookieName\";\nimport { DEFAULT_VISITOR_ID_COOKIE_NAME } from \"../constants\";\n\nexport interface ResolvedAbCookieNames {\n  /** Resolved variant cookie name for the given experiment. */\n  variantCookieName: string;\n  /** Resolved visitor ID cookie name. */\n  visitorCookieName: string;\n}\n\n/**\n * Resolves an `AbCookieConfig` + experiment ID into plain serializable strings.\n * Use this in Server Components to derive props for Client Components.\n */\nexport function resolveAbCookieNames(config: AbCookieConfig | undefined, experimentId: string): ResolvedAbCookieNames {\n  return {\n    variantCookieName: (config?.getExpCookieName ?? defaultGetExpCookieName)(experimentId),\n    visitorCookieName: config?.visitorIdCookieName ?? DEFAULT_VISITOR_ID_COOKIE_NAME,\n  };\n}\n"],"mappings":";AAAO,SAAS,wBAAwB,KAAa;AACnD,SAAO,OAAO,mBAAmB,GAAG,CAAC;AACvC;;;ACFO,IAAM,iCAAiC;;;ACevC,SAAS,qBAAqB,QAAoC,cAA6C;AACpH,SAAO;AAAA,IACL,oBAAoB,QAAQ,oBAAoB,yBAAyB,YAAY;AAAA,IACrF,mBAAmB,QAAQ,uBAAuB;AAAA,EACpD;AACF;","names":[]}