@se-studio/ab-testing 0.0.0-next16-20260822103555

package/dist/codegen/index.js

@@ -0,0 +1,8 @@
+/**
+ * @se-studio/ab-testing/codegen
+ *
+ * Build-time utilities for generating a static A/B test configuration file.
+ * Import these in a Node.js management script, not in edge/browser code.
+ */
+export { buildStaticTestsByPath, generateAbTestsFileContent, } from './generator';
+//# sourceMappingURL=index.js.map

package/dist/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/dist/components/AbTestReporter.d.ts

@@ -0,0 +1,2 @@
+export declare function AbTestReporter(): null;
+//# sourceMappingURL=AbTestReporter.d.ts.map

package/dist/components/AbTestReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbTestReporter.d.ts","sourceRoot":"","sources":["../../src/components/AbTestReporter.tsx"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,SAe7B"}

package/dist/components/AbTestReporter.js

@@ -0,0 +1,19 @@
+'use client';
+import { useAnalytics } from '@se-studio/core-ui';
+import { useEffect } from 'react';
+import { useAbTestAssignments } from '../hooks/useAbTestAssignments';
+import { buildExperimentImpression } from '../reporting/buildExperimentImpression';
+export function AbTestReporter() {
+    const assignments = useAbTestAssignments();
+    const { trackEvent } = useAnalytics();
+    useEffect(() => {
+        if (assignments === null || assignments.length === 0) {
+            return;
+        }
+        for (const assignment of assignments) {
+            trackEvent('experiment_impression', buildExperimentImpression(assignment.testId, assignment));
+        }
+    }, [assignments, trackEvent]);
+    return null;
+}
+//# sourceMappingURL=AbTestReporter.js.map

package/dist/components/AbTestReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbTestReporter.js","sourceRoot":"","sources":["../../src/components/AbTestReporter.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,MAAM,UAAU,cAAc;IAC5B,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAC3C,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,EAAE,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,OAAO;QACT,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,UAAU,CAAC,uBAAuB,EAAE,yBAAyB,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QAChG,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;IAE9B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/components/AbTestUtmScript.d.ts

@@ -0,0 +1,17 @@
+interface AbTestUtmScriptProps {
+    cookieName?: string;
+}
+/**
+ * Inline script that applies url_params from the A/B test cookie to the browser URL
+ * as early as possible (before React hydration) so GTM scripts can read them on load.
+ *
+ * Only runs when the assignment has **injectUrlParams === true** (aligned with middleware).
+ * Legacy cookies without the flag do not inject. Also requires original_path match and
+ * non-empty url_params. Skips query keys already present on the URL.
+ *
+ * Must be rendered in the root layout only — Next.js requires
+ * `strategy="beforeInteractive"` scripts to live in the root layout.
+ */
+export declare function AbTestUtmScript({ cookieName }: AbTestUtmScriptProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=AbTestUtmScript.d.ts.map

package/dist/components/AbTestUtmScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbTestUtmScript.d.ts","sourceRoot":"","sources":["../../src/components/AbTestUtmScript.tsx"],"names":[],"mappings":"AAEA,UAAU,oBAAoB;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAAE,UAA2B,EAAE,EAAE,oBAAoB,+BA8BpF"}

package/dist/components/AbTestUtmScript.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import Script from 'next/script';
+/**
+ * Inline script that applies url_params from the A/B test cookie to the browser URL
+ * as early as possible (before React hydration) so GTM scripts can read them on load.
+ *
+ * Only runs when the assignment has **injectUrlParams === true** (aligned with middleware).
+ * Legacy cookies without the flag do not inject. Also requires original_path match and
+ * non-empty url_params. Skips query keys already present on the URL.
+ *
+ * Must be rendered in the root layout only — Next.js requires
+ * `strategy="beforeInteractive"` scripts to live in the root layout.
+ */
+export function AbTestUtmScript({ cookieName = 'ab-test-info' }) {
+    return (_jsx(Script, { id: "ab-test-utm", strategy: "beforeInteractive", children: `
+(function() {
+  try {
+    var m = document.cookie.match(new RegExp('(^| )${cookieName}=([^;]+)'));
+    if (!m) return;
+    var a = JSON.parse(decodeURIComponent(m[2]));
+    var p = window.location.pathname.replace(/\\/$/, '') || '/';
+    var url = new URL(window.location.href);
+    var changed = false;
+    for (var id in a) {
+      var t = a[id];
+      if (t.injectUrlParams !== true) continue;
+      if (!t.url_params) continue;
+      var op = (t.original_path || '').replace(/\\/$/, '') || '/';
+      if (op !== p) continue;
+      for (var key in t.url_params) {
+        if (url.searchParams.has(key)) continue;
+        url.searchParams.set(key, t.url_params[key]);
+        changed = true;
+      }
+    }
+    if (changed) {
+      window.history.replaceState(window.history.state, '', url.toString());
+    }
+  } catch(e) {}
+})();
+    ` }));
+}
+//# sourceMappingURL=AbTestUtmScript.js.map

package/dist/components/AbTestUtmScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbTestUtmScript.js","sourceRoot":"","sources":["../../src/components/AbTestUtmScript.tsx"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAMjC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,EAAE,UAAU,GAAG,cAAc,EAAwB;IACnF,OAAO,CACL,KAAC,MAAM,IAAC,EAAE,EAAC,aAAa,EAAC,QAAQ,EAAC,mBAAmB,YAAE;;;qDAGN,UAAU;;;;;;;;;;;;;;;;;;;;;;;KAuB1D,GAAU,CACZ,CAAC;AACJ,CAAC"}

package/dist/components/index.d.ts

@@ -0,0 +1,3 @@
+export { AbTestReporter } from './AbTestReporter';
+export { AbTestUtmScript } from './AbTestUtmScript';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,3 @@
+export { AbTestReporter } from './AbTestReporter';
+export { AbTestUtmScript } from './AbTestUtmScript';
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A/B Testing Hooks
+ *
+ * React hooks for client-side A/B test reporting.
+ */
+export type { ActiveAbTestAssignment, UseAbTestAssignmentsOptions } from './useAbTestAssignments';
+export { useAbTestAssignments } from './useAbTestAssignments';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,7 @@
+/**
+ * A/B Testing Hooks
+ *
+ * React hooks for client-side A/B test reporting.
+ */
+export { useAbTestAssignments } from './useAbTestAssignments';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/useAbTestAssignments.d.ts

@@ -0,0 +1,56 @@
+import type { AbTestAssignment } from '../types';
+/**
+ * An A/B test assignment with its test ID included.
+ */
+export interface ActiveAbTestAssignment extends AbTestAssignment {
+    /** Contentful entry ID of the PageTest */
+    testId: string;
+}
+/**
+ * Options for the useAbTestAssignments hook.
+ */
+export interface UseAbTestAssignmentsOptions {
+    /**
+     * Cookie name to read assignments from.
+     * @default "ab-test-info"
+     */
+    cookieName?: string;
+}
+/**
+ * Hook that returns A/B test assignments for the current page.
+ *
+ * This hook reads the A/B test cookie and returns only the assignments
+ * that match the current page path. Projects can use this to build
+ * their own analytics reporting with project-specific integrations.
+ *
+ * @param options - Hook configuration options
+ * @returns Array of active test assignments for the current page
+ *
+ * @example Basic usage
+ * ```tsx
+ * 'use client';
+ *
+ * import { useEffect } from 'react';
+ * import { useAbTestAssignments } from '@se-studio/ab-testing';
+ *
+ * export function AbTestReporter() {
+ *   const assignments = useAbTestAssignments();
+ *
+ *   useEffect(() => {
+ *     for (const assignment of assignments) {
+ *       // Send to your analytics
+ *       sendEvent('experiment_impression', {
+ *         experiment_id: assignment.testId,
+ *         experiment_name: assignment.experiment_name,
+ *         variant_id: assignment.variant_id,
+ *         variant_slug: assignment.variant_slug,
+ *       });
+ *     }
+ *   }, [assignments]);
+ *
+ *   return null;
+ * }
+ * ```
+ */
+export declare function useAbTestAssignments(options?: UseAbTestAssignmentsOptions): ActiveAbTestAssignment[] | null;
+//# sourceMappingURL=useAbTestAssignments.d.ts.map

package/dist/hooks/useAbTestAssignments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAbTestAssignments.d.ts","sourceRoot":"","sources":["../../src/hooks/useAbTestAssignments.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,2BAA2B,GACpC,sBAAsB,EAAE,GAAG,IAAI,CA6CjC"}

package/dist/hooks/useAbTestAssignments.js

@@ -0,0 +1,87 @@
+'use client';
+import { useEffect, useState } from 'react';
+import { DEFAULT_COOKIE_NAME, readCookieFromDocument } from '../middleware/cookies';
+/**
+ * Normalize a path for comparison (remove trailing slash except for root).
+ */
+function normalizePath(path) {
+    if (path.endsWith('/') && path.length > 1) {
+        return path.slice(0, -1);
+    }
+    return path;
+}
+/**
+ * Hook that returns A/B test assignments for the current page.
+ *
+ * This hook reads the A/B test cookie and returns only the assignments
+ * that match the current page path. Projects can use this to build
+ * their own analytics reporting with project-specific integrations.
+ *
+ * @param options - Hook configuration options
+ * @returns Array of active test assignments for the current page
+ *
+ * @example Basic usage
+ * ```tsx
+ * 'use client';
+ *
+ * import { useEffect } from 'react';
+ * import { useAbTestAssignments } from '@se-studio/ab-testing';
+ *
+ * export function AbTestReporter() {
+ *   const assignments = useAbTestAssignments();
+ *
+ *   useEffect(() => {
+ *     for (const assignment of assignments) {
+ *       // Send to your analytics
+ *       sendEvent('experiment_impression', {
+ *         experiment_id: assignment.testId,
+ *         experiment_name: assignment.experiment_name,
+ *         variant_id: assignment.variant_id,
+ *         variant_slug: assignment.variant_slug,
+ *       });
+ *     }
+ *   }, [assignments]);
+ *
+ *   return null;
+ * }
+ * ```
+ */
+export function useAbTestAssignments(options) {
+    const cookieName = options?.cookieName ?? DEFAULT_COOKIE_NAME;
+    const [assignments, setAssignments] = useState(null);
+    useEffect(() => {
+        try {
+            const allAssignments = readCookieFromDocument(document.cookie, cookieName);
+            if (Object.keys(allAssignments).length === 0) {
+                setAssignments([]);
+                return;
+            }
+            // Get and normalize current browser path
+            const currentPath = window.location.pathname;
+            const normalizedCurrentPath = normalizePath(currentPath);
+            // Filter to only assignments for the current page
+            const activeAssignments = [];
+            for (const [testId, assignment] of Object.entries(allAssignments)) {
+                // Skip if original_path is not present
+                if (!assignment.original_path) {
+                    continue;
+                }
+                // Skip if not on the original path where the test was assigned
+                if (assignment.original_path !== normalizedCurrentPath) {
+                    continue;
+                }
+                activeAssignments.push({
+                    ...assignment,
+                    testId,
+                });
+            }
+            setAssignments(activeAssignments);
+        }
+        catch (e) {
+            // biome-ignore lint/suspicious/noConsole: Error logging
+            console.error('[useAbTestAssignments] Error reading A/B test cookie', e);
+        }
+    }, [cookieName]);
+    return assignments;
+}
+//# sourceMappingURL=useAbTestAssignments.js.map

package/dist/hooks/useAbTestAssignments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAbTestAssignments.js","sourceRoot":"","sources":["../../src/hooks/useAbTestAssignments.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAsBpF;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAqC;IAErC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC9D,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAkC,IAAI,CAAC,CAAC;IAEtF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,sBAAsB,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAE3E,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7C,cAAc,CAAC,EAAE,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,yCAAyC;YACzC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC7C,MAAM,qBAAqB,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;YAEzD,kDAAkD;YAClD,MAAM,iBAAiB,GAA6B,EAAE,CAAC;YAEvD,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAClE,uCAAuC;gBACvC,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;oBAC9B,SAAS;gBACX,CAAC;gBAED,+DAA+D;gBAC/D,IAAI,UAAU,CAAC,aAAa,KAAK,qBAAqB,EAAE,CAAC;oBACvD,SAAS;gBACX,CAAC;gBAED,iBAAiB,CAAC,IAAI,CAAC;oBACrB,GAAG,UAAU;oBACb,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;YAED,cAAc,CAAC,iBAAiB,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,wDAAwD;YACxD,OAAO,CAAC,KAAK,CAAC,sDAAsD,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @se-studio/ab-testing
+ *
+ * Server-side A/B testing framework for Next.js applications with Contentful CMS.
+ *
+ * @packageDocumentation
+ */
+export type { ActiveAbTestAssignment, UseAbTestAssignmentsOptions } from './hooks/index.js';
+export { useAbTestAssignments } from './hooks/index.js';
+export type { AbTestMiddlewareConfig, AbTestResult, CachedAbTest, StaticAbTestMiddlewareOptions, TestsCache, } from './middleware/index.js';
+export { applyUrlParams, buildVariantId, clearTestCache, computeCachedTest, createAbTestMiddleware, createAssignment, createStaticAbTestMiddleware, DEFAULT_COOKIE_MAX_AGE, DEFAULT_COOKIE_NAME, getActiveTestIds, getAssignment, getCachedTests, getTestCacheState, isValidAssignment, normalizePath, parseCookie, processAbTestRequest, pruneStaleAssignments, readCookieFromDocument, selectVariant, serializeCookie, setAssignment, } from './middleware/index.js';
+export { buildExperimentImpression } from './reporting/buildExperimentImpression.js';
+export type { AbTest, AbTestAssignment, AbTestCookie, AbTestVariant, AbTestVariantConfig, IBlobStore, } from './types.js';
+export { findCanonicalPath } from './utils.js';
+export type { RawPageTest, WebhookHandlerConfig, WebhookResult, } from './webhook/index.js';
+export { createWebhookHandler, normalizeVariantConfig, processAbTestWebhook, transformPageTest, } from './webhook/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,6BAA6B,EAC7B,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAErF,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @se-studio/ab-testing
+ *
+ * Server-side A/B testing framework for Next.js applications with Contentful CMS.
+ *
+ * @packageDocumentation
+ */
+// Re-export hooks
+export { useAbTestAssignments } from './hooks/index.js';
+// Re-export middleware utilities
+export { applyUrlParams, buildVariantId, clearTestCache, computeCachedTest, createAbTestMiddleware, createAssignment, createStaticAbTestMiddleware, DEFAULT_COOKIE_MAX_AGE, DEFAULT_COOKIE_NAME, getActiveTestIds, getAssignment, getCachedTests, getTestCacheState, isValidAssignment, normalizePath, parseCookie, processAbTestRequest, pruneStaleAssignments, readCookieFromDocument, selectVariant, serializeCookie, setAssignment, } from './middleware/index.js';
+export { buildExperimentImpression } from './reporting/buildExperimentImpression.js';
+// Utilities
+export { findCanonicalPath } from './utils.js';
+// Re-export webhook utilities
+export { createWebhookHandler, normalizeVariantConfig, processAbTestWebhook, transformPageTest, } from './webhook/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAQxD,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAUrF,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAM/C,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/middleware/assignment.d.ts

@@ -0,0 +1,31 @@
+import type { AbTestAssignment } from '../types';
+import type { CachedAbTest } from './types';
+/**
+ * Perform weighted random selection to assign a variant.
+ *
+ * @param test - The cached test with pre-computed weights
+ * @returns Object with selectedKey (variant ID or "control") and variant slug
+ */
+export declare function selectVariant(test: CachedAbTest): {
+    selectedKey: string;
+    variantSlug: string;
+};
+/**
+ * Create an assignment object for a newly selected variant.
+ *
+ * @param test - The cached test
+ * @param selectedKey - The selected variant ID or "control"
+ * @param variantSlug - The slug of the selected variant
+ * @param originalPath - The original URL path where the test was assigned
+ * @returns Assignment object to store in cookie
+ */
+export declare function createAssignment(test: CachedAbTest, selectedKey: string, variantSlug: string, originalPath: string): AbTestAssignment;
+/**
+ * Validate an existing cookie assignment against current CMS config.
+ *
+ * @param test - The cached test with current config
+ * @param assignment - The assignment from the cookie
+ * @returns true if assignment is still valid, false if it should be re-assigned
+ */
+export declare function isValidAssignment(test: CachedAbTest, assignment: AbTestAssignment): boolean;
+//# sourceMappingURL=assignment.d.ts.map

package/dist/middleware/assignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment.d.ts","sourceRoot":"","sources":["../../src/middleware/assignment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAe5C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAe9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CA2BlB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAyE3F"}

package/dist/middleware/assignment.js

@@ -0,0 +1,125 @@
+import { buildVariantId } from './variantId';
+function recordsEqual(a, b) {
+    if (!a && !b)
+        return true;
+    if (!a || !b)
+        return false;
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    return aKeys.every((key) => a[key] === b[key]);
+}
+/**
+ * Perform weighted random selection to assign a variant.
+ *
+ * @param test - The cached test with pre-computed weights
+ * @returns Object with selectedKey (variant ID or "control") and variant slug
+ */
+export function selectVariant(test) {
+    const rand = Math.random();
+    let sum = 0;
+    let selectedKey = 'control';
+    for (const [key, weight] of Object.entries(test.readyWeights)) {
+        sum += weight;
+        if (rand < sum) {
+            selectedKey = key;
+            break;
+        }
+    }
+    const variantSlug = test.variantLookup[selectedKey] || 'control';
+    return { selectedKey, variantSlug };
+}
+/**
+ * Create an assignment object for a newly selected variant.
+ *
+ * @param test - The cached test
+ * @param selectedKey - The selected variant ID or "control"
+ * @param variantSlug - The slug of the selected variant
+ * @param originalPath - The original URL path where the test was assigned
+ * @returns Assignment object to store in cookie
+ */
+export function createAssignment(test, selectedKey, variantSlug, originalPath) {
+    const isControl = selectedKey === 'control';
+    const slug = variantSlug === 'control' ? 'control' : variantSlug;
+    const variantLabel = test.variantLabelLookup[selectedKey];
+    const fallbackLabel = isControl ? 'control' : slug;
+    const assignment = {
+        experiment_name: test.trackingLabel || test.cmsLabel,
+        variant_id: buildVariantId(isControl, variantLabel, fallbackLabel),
+        variant_slug: slug,
+        original_path: originalPath,
+        reporting_event: test.reportingEventLookup[selectedKey],
+        // Strict true only — missing/false means AbTestUtmScript must not inject
+        injectUrlParams: test.injectUrlParams === true,
+    };
+    const urlParams = test.urlParamsLookup[selectedKey];
+    if (urlParams && Object.keys(urlParams).length > 0) {
+        assignment.url_params = urlParams;
+    }
+    const reportingParams = test.reportingParamsLookup[selectedKey];
+    if (reportingParams && Object.keys(reportingParams).length > 0) {
+        assignment.reporting_params = reportingParams;
+    }
+    return assignment;
+}
+/**
+ * Validate an existing cookie assignment against current CMS config.
+ *
+ * @param test - The cached test with current config
+ * @param assignment - The assignment from the cookie
+ * @returns true if assignment is still valid, false if it should be re-assigned
+ */
+export function isValidAssignment(test, assignment) {
+    const { experiment_name, variant_id, variant_slug, reporting_event, original_path, injectUrlParams, url_params, reporting_params, } = assignment;
+    if (!original_path) {
+        return false;
+    }
+    const expectedName = test.trackingLabel || test.cmsLabel;
+    if (experiment_name !== expectedName) {
+        return false;
+    }
+    // Reassign when CMS toggles injectUrlParams (legacy cookies lack the field → refresh)
+    const expectedInject = test.injectUrlParams === true;
+    if ((injectUrlParams === true) !== expectedInject) {
+        return false;
+    }
+    let variantKey;
+    if (variant_slug === 'control') {
+        if ((test.readyWeights['control'] ?? 0) <= 0) {
+            return false;
+        }
+        variantKey = 'control';
+    }
+    else {
+        for (const [id, slug] of Object.entries(test.variantLookup)) {
+            if (slug === variant_slug && id !== 'control') {
+                if ((test.readyWeights[id] ?? 0) <= 0) {
+                    return false;
+                }
+                variantKey = id;
+                break;
+            }
+        }
+        if (!variantKey) {
+            return false;
+        }
+    }
+    const isControl = variantKey === 'control';
+    const expectedVariantId = buildVariantId(isControl, test.variantLabelLookup[variantKey], isControl ? 'control' : variant_slug);
+    if (variant_id !== expectedVariantId) {
+        return false;
+    }
+    const expectedReportingEvent = test.reportingEventLookup[variantKey];
+    if (reporting_event !== expectedReportingEvent) {
+        return false;
+    }
+    if (!recordsEqual(url_params, test.urlParamsLookup[variantKey])) {
+        return false;
+    }
+    if (!recordsEqual(reporting_params, test.reportingParamsLookup[variantKey])) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=assignment.js.map

package/dist/middleware/assignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment.js","sourceRoot":"","sources":["../../src/middleware/assignment.ts"],"names":[],"mappings":"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"}

package/dist/middleware/cache.d.ts

@@ -0,0 +1,30 @@
+import type { AbTest, IBlobStore } from '../types';
+import type { CachedAbTest, TestsCache } from './types';
+/**
+ * Pre-compute weights and lookups for a test.
+ */
+export declare function computeCachedTest(test: AbTest): CachedAbTest;
+/**
+ * Normalize a URL path for consistent matching.
+ * - Removes trailing slashes (except for root)
+ * - Ensures leading slash
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Get cached tests, refreshing from store if needed.
+ *
+ * @param store - The blob store to fetch tests from
+ * @param cacheTtlMs - Cache time-to-live in milliseconds
+ * @param devTestData - Optional test data for development mode
+ * @returns Map of tests indexed by normalized control path
+ */
+export declare function getCachedTests(store: IBlobStore<AbTest>, cacheTtlMs: number, devTestData?: AbTest[]): Promise<Map<string, CachedAbTest[]>>;
+/**
+ * Clear the test cache. Useful for testing or forcing a refresh.
+ */
+export declare function clearTestCache(): void;
+/**
+ * Get the current cache state. Useful for debugging.
+ */
+export declare function getTestCacheState(): TestsCache | null;
+//# sourceMappingURL=cache.d.ts.map

package/dist/middleware/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/middleware/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKxD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAqD5D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAelD;AAsBD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,EACzB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAgCtC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,GAAG,IAAI,CAErD"}