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

package/dist/middleware/cache.js

@@ -0,0 +1,140 @@
+/** Global cache instance */
+let globalTestsCache = null;
+/**
+ * Pre-compute weights and lookups for a test.
+ */
+export function computeCachedTest(test) {
+    const readyWeights = {};
+    const variantLabelLookup = {};
+    const reportingEventLookup = {};
+    const urlParamsLookup = {};
+    const reportingParamsLookup = {};
+    const config = test.configuration;
+    if (config && config.length > 0) {
+        // Control bucket (index 0)
+        readyWeights['control'] = config[0]?.weight ?? 0;
+        variantLabelLookup['control'] = config[0]?.variant_label;
+        reportingEventLookup['control'] = config[0]?.reporting_event;
+        urlParamsLookup['control'] = config[0]?.url_params;
+        reportingParamsLookup['control'] = config[0]?.reporting_params;
+        // Variant buckets (index 1+)
+        for (let i = 0; i < test.variants.length; i++) {
+            const variantConfig = config[i + 1];
+            const variant = test.variants[i];
+            if (variant) {
+                readyWeights[variant.id] = variantConfig?.weight ?? 0;
+                variantLabelLookup[variant.id] = variantConfig?.variant_label;
+                reportingEventLookup[variant.id] = variantConfig?.reporting_event;
+                urlParamsLookup[variant.id] = variantConfig?.url_params;
+                reportingParamsLookup[variant.id] = variantConfig?.reporting_params;
+            }
+        }
+    }
+    else {
+        // Fallback: equal weights if no configuration
+        const totalOptions = test.variants.length + 1;
+        const equalWeight = 1 / totalOptions;
+        readyWeights['control'] = equalWeight;
+        for (const variant of test.variants) {
+            readyWeights[variant.id] = equalWeight;
+        }
+    }
+    // Pre-compute variant lookup (ID -> Slug)
+    const variantLookup = { control: 'control' };
+    for (const variant of test.variants) {
+        variantLookup[variant.id] = variant.slug;
+    }
+    return {
+        ...test,
+        readyWeights,
+        variantLookup,
+        variantLabelLookup,
+        reportingEventLookup,
+        urlParamsLookup,
+        reportingParamsLookup,
+    };
+}
+/**
+ * Normalize a URL path for consistent matching.
+ * - Removes trailing slashes (except for root)
+ * - Ensures leading slash
+ */
+export function normalizePath(path) {
+    // Handle "index" as root
+    if (path === 'index') {
+        return '/';
+    }
+    // Ensure leading slash
+    let normalized = path.startsWith('/') ? path : `/${path}`;
+    // Remove trailing slash (except for root)
+    if (normalized.endsWith('/') && normalized.length > 1) {
+        normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+}
+/**
+ * Build cached tests map from raw tests.
+ */
+function buildTestsByPath(tests) {
+    const testsByPath = new Map();
+    for (const test of tests) {
+        if (!test.enabled)
+            continue;
+        const normalizedControlPath = normalizePath(test.controlSlug);
+        const cachedTest = computeCachedTest(test);
+        const existing = testsByPath.get(normalizedControlPath) || [];
+        existing.push(cachedTest);
+        testsByPath.set(normalizedControlPath, existing);
+    }
+    return testsByPath;
+}
+/**
+ * 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 async function getCachedTests(store, cacheTtlMs, devTestData) {
+    const now = Date.now();
+    // Return cached data if still valid
+    if (globalTestsCache && now - globalTestsCache.timestamp < cacheTtlMs) {
+        return globalTestsCache.testsByPath;
+    }
+    try {
+        let tests;
+        // Use dev test data if provided
+        if (devTestData && process.env.NODE_ENV === 'development') {
+            tests = devTestData;
+        }
+        else {
+            tests = await store.values();
+        }
+        const testsByPath = buildTestsByPath(tests);
+        globalTestsCache = {
+            timestamp: now,
+            testsByPath,
+        };
+        return testsByPath;
+    }
+    catch (error) {
+        // biome-ignore lint/suspicious/noConsole: Error logging in middleware
+        console.error('Error fetching A/B tests:', error);
+        // Return stale cache if available, otherwise empty map
+        return globalTestsCache?.testsByPath || new Map();
+    }
+}
+/**
+ * Clear the test cache. Useful for testing or forcing a refresh.
+ */
+export function clearTestCache() {
+    globalTestsCache = null;
+}
+/**
+ * Get the current cache state. Useful for debugging.
+ */
+export function getTestCacheState() {
+    return globalTestsCache;
+}
+//# sourceMappingURL=cache.js.map

package/dist/middleware/cache.js.map

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

package/dist/middleware/cookies.d.ts

@@ -0,0 +1,44 @@
+import type { AbTestAssignment, AbTestCookie } from '../types';
+/** Default cookie name for A/B test assignments */
+export declare const DEFAULT_COOKIE_NAME = "ab-test-info";
+/** Default cookie max age: 30 days in seconds */
+export declare const DEFAULT_COOKIE_MAX_AGE: number;
+/**
+ * Parse the A/B test cookie value into an assignment map.
+ *
+ * @param cookieValue - The raw cookie value string
+ * @returns Parsed assignment map, or empty object if invalid
+ */
+export declare function parseCookie(cookieValue: string | undefined): AbTestCookie;
+/**
+ * Serialize an assignment map to a cookie value string.
+ *
+ * @param assignments - The assignment map to serialize
+ * @returns Serialized cookie value
+ */
+export declare function serializeCookie(assignments: AbTestCookie): string;
+/**
+ * Get a specific test assignment from the cookie.
+ *
+ * @param cookie - Parsed cookie object
+ * @param testId - The test ID to look up
+ * @returns The assignment for this test, or undefined
+ */
+export declare function getAssignment(cookie: AbTestCookie, testId: string): AbTestAssignment | undefined;
+/**
+ * Set a test assignment in the cookie object.
+ *
+ * @param cookie - Parsed cookie object (will be mutated)
+ * @param testId - The test ID
+ * @param assignment - The assignment to store
+ */
+export declare function setAssignment(cookie: AbTestCookie, testId: string, assignment: AbTestAssignment): void;
+/**
+ * Read an A/B test cookie from a document.cookie string (client-side).
+ *
+ * @param documentCookie - The document.cookie string
+ * @param cookieName - The cookie name to look for
+ * @returns Parsed assignment map, or empty object if not found
+ */
+export declare function readCookieFromDocument(documentCookie: string, cookieName?: string): AbTestCookie;
+//# sourceMappingURL=cookies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/middleware/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE/D,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,iDAAiD;AACjD,eAAO,MAAM,sBAAsB,QAAoB,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAWzE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,YAAY,GAAG,MAAM,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,UAAU,GAAE,MAA4B,GACvC,YAAY,CAMd"}

package/dist/middleware/cookies.js

@@ -0,0 +1,66 @@
+/** Default cookie name for A/B test assignments */
+export const DEFAULT_COOKIE_NAME = 'ab-test-info';
+/** Default cookie max age: 30 days in seconds */
+export const DEFAULT_COOKIE_MAX_AGE = 60 * 60 * 24 * 30;
+/**
+ * Parse the A/B test cookie value into an assignment map.
+ *
+ * @param cookieValue - The raw cookie value string
+ * @returns Parsed assignment map, or empty object if invalid
+ */
+export function parseCookie(cookieValue) {
+    if (!cookieValue) {
+        return {};
+    }
+    try {
+        const decoded = decodeURIComponent(cookieValue);
+        return JSON.parse(decoded);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Serialize an assignment map to a cookie value string.
+ *
+ * @param assignments - The assignment map to serialize
+ * @returns Serialized cookie value
+ */
+export function serializeCookie(assignments) {
+    return JSON.stringify(assignments);
+}
+/**
+ * Get a specific test assignment from the cookie.
+ *
+ * @param cookie - Parsed cookie object
+ * @param testId - The test ID to look up
+ * @returns The assignment for this test, or undefined
+ */
+export function getAssignment(cookie, testId) {
+    return cookie[testId];
+}
+/**
+ * Set a test assignment in the cookie object.
+ *
+ * @param cookie - Parsed cookie object (will be mutated)
+ * @param testId - The test ID
+ * @param assignment - The assignment to store
+ */
+export function setAssignment(cookie, testId, assignment) {
+    cookie[testId] = assignment;
+}
+/**
+ * Read an A/B test cookie from a document.cookie string (client-side).
+ *
+ * @param documentCookie - The document.cookie string
+ * @param cookieName - The cookie name to look for
+ * @returns Parsed assignment map, or empty object if not found
+ */
+export function readCookieFromDocument(documentCookie, cookieName = DEFAULT_COOKIE_NAME) {
+    const match = documentCookie.match(new RegExp(`(^| )${cookieName}=([^;]+)`));
+    if (!match?.[2]) {
+        return {};
+    }
+    return parseCookie(match[2]);
+}
+//# sourceMappingURL=cookies.js.map

package/dist/middleware/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/middleware/cookies.ts"],"names":[],"mappings":"AAEA,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAElD,iDAAiD;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,WAA+B;IACzD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,WAAyB;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoB,EAAE,MAAc;IAChE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,MAAc,EACd,UAA4B;IAE5B,MAAM,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAsB,EACtB,aAAqB,mBAAmB;IAExC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,UAAU,UAAU,CAAC,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/middleware/handler.d.ts

@@ -0,0 +1,53 @@
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
+import type { AbTestAssignment } from '../types';
+import type { AbTestMiddlewareConfig, AbTestResult, CachedAbTest } from './types';
+/**
+ * Create an A/B test middleware handler.
+ *
+ * This factory function returns a middleware handler that can be called
+ * from your Next.js middleware to process A/B test assignments.
+ *
+ * @param config - Middleware configuration
+ * @returns Async function that processes requests and returns NextResponse or null
+ */
+export declare function createAbTestMiddleware(config: AbTestMiddlewareConfig): (request: NextRequest) => Promise<NextResponse | null>;
+/**
+ * Low-level function to process an A/B test request.
+ * Use this if you need more control over the response handling.
+ */
+export declare function processAbTestRequest(pathname: string, searchParams: URLSearchParams, cookieValue: string | undefined, store: ReturnType<AbTestMiddlewareConfig['getStore']>, cacheTtlMs: number, devTestData?: AbTestMiddlewareConfig['devTestData'], options?: Pick<AbTestMiddlewareConfig, 'pruneStaleAssignments' | 'respectExistingUrlParams' | 'onValidationFailure'>): Promise<AbTestResult>;
+/**
+ * Options for the static A/B test middleware.
+ */
+export interface StaticAbTestMiddlewareOptions {
+    /** Name of the cookie used to store A/B test assignments. @default "ab-test-info" */
+    cookieName?: string;
+    /** Cookie max age in seconds. @default 2592000 (30 days) */
+    cookieMaxAge?: number;
+    /**
+     * Path prefix to prepend when rewriting to a variant.
+     * e.g. "/page-test" → rewrites to "/page-test/slug" instead of "/slug".
+     * @default "" (no prefix)
+     */
+    variantPathPrefix?: string;
+    /** Optional function to skip processing for certain pathnames. */
+    shouldProcess?: (pathname: string) => boolean;
+    /** Optional callback when a cookie assignment fails validation. */
+    onValidationFailure?: (testId: string, assignment: AbTestAssignment) => void;
+    /**
+     * Remove cookie entries for tests no longer in the active config.
+     * @default true
+     */
+    pruneStaleAssignments?: boolean;
+    /**
+     * When injecting url_params, skip keys already present on the request URL.
+     * @default true
+     */
+    respectExistingUrlParams?: boolean;
+}
+/**
+ * Create a synchronous A/B test middleware from a pre-generated static testsByPath map.
+ */
+export declare function createStaticAbTestMiddleware(staticTestsByPath: Record<string, CachedAbTest[]>, options?: StaticAbTestMiddlewareOptions): (request: NextRequest) => NextResponse | null;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/middleware/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,UAAU,CAAC;AAY/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAkFlF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,IAc5B,SAAS,WAAW,KAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgE3F;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,eAAe,EAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,KAAK,EAAE,UAAU,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,EACrD,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,sBAAsB,CAAC,aAAa,CAAC,EACnD,OAAO,GAAE,IAAI,CACX,sBAAsB,EACtB,uBAAuB,GAAG,0BAA0B,GAAG,qBAAqB,CACxE,GACL,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC7E;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,EACjD,OAAO,GAAE,6BAAkC,IAeJ,SAAS,WAAW,KAAG,YAAY,GAAG,IAAI,CAiDlF"}

package/dist/middleware/handler.js

@@ -0,0 +1,201 @@
+import { NextResponse } from 'next/server';
+import { createAssignment, isValidAssignment, selectVariant } from './assignment';
+import { getCachedTests, normalizePath } from './cache';
+import { DEFAULT_COOKIE_MAX_AGE, DEFAULT_COOKIE_NAME, getAssignment, parseCookie, serializeCookie, setAssignment, } from './cookies';
+import { getActiveTestIds, pruneStaleAssignments } from './prune';
+import { applyUrlParams } from './urlParams';
+function searchParamsMatch(test, searchParams) {
+    if (!test.searchParameters) {
+        return true;
+    }
+    const testSearchParams = new URLSearchParams(test.searchParameters);
+    for (const [key, value] of testSearchParams.entries()) {
+        if (searchParams.get(key) !== value) {
+            return false;
+        }
+    }
+    return true;
+}
+function resolveAssignment(test, cookie, normalizedPathname, onValidationFailure) {
+    let assignmentData = getAssignment(cookie, test.id);
+    if (assignmentData && !isValidAssignment(test, assignmentData)) {
+        onValidationFailure?.(test.id, assignmentData);
+        assignmentData = undefined;
+    }
+    if (!assignmentData) {
+        const { selectedKey, variantSlug } = selectVariant(test);
+        assignmentData = createAssignment(test, selectedKey, variantSlug, normalizedPathname);
+        setAssignment(cookie, test.id, assignmentData);
+    }
+    return assignmentData;
+}
+function buildRewriteUrl(assignment, variantPathPrefix) {
+    const variantSlug = assignment.variant_slug;
+    if (!variantSlug || variantSlug === 'control') {
+        return undefined;
+    }
+    const cleanSlug = variantSlug.startsWith('/') ? variantSlug.slice(1) : variantSlug;
+    return `${variantPathPrefix}/${cleanSlug}`;
+}
+function applyTestUrlParams(url, test, assignment, respectExistingUrlParams) {
+    if (!test.injectUrlParams) {
+        return false;
+    }
+    return applyUrlParams(url, assignment.url_params, respectExistingUrlParams);
+}
+function setCookieHeader(response, cookie, cookieName, cookieMaxAge) {
+    const cookieValue = serializeCookie(cookie);
+    if (cookieValue) {
+        response.cookies.set(cookieName, cookieValue, {
+            path: '/',
+            maxAge: cookieMaxAge,
+            sameSite: 'lax',
+        });
+    }
+}
+/**
+ * Create an A/B test middleware handler.
+ *
+ * This factory function returns a middleware handler that can be called
+ * from your Next.js middleware to process A/B test assignments.
+ *
+ * @param config - Middleware configuration
+ * @returns Async function that processes requests and returns NextResponse or null
+ */
+export function createAbTestMiddleware(config) {
+    const { getStore, cacheTtlMs = 60000, cookieName = DEFAULT_COOKIE_NAME, cookieMaxAge = DEFAULT_COOKIE_MAX_AGE, shouldProcess, devTestData, onValidationFailure, variantPathPrefix = '', pruneStaleAssignments: pruneStale = true, respectExistingUrlParams = true, } = config;
+    return async function abTestMiddleware(request) {
+        const pathname = request.nextUrl.pathname;
+        if (shouldProcess && !shouldProcess(pathname)) {
+            return null;
+        }
+        try {
+            const normalizedPathname = normalizePath(pathname);
+            const store = await Promise.resolve(getStore());
+            const testsByPath = await getCachedTests(store, cacheTtlMs, devTestData);
+            const activeTestIds = pruneStale ? getActiveTestIds(testsByPath) : null;
+            const cookieValue = request.cookies.get(cookieName)?.value;
+            const cookie = parseCookie(cookieValue);
+            const prunedStale = activeTestIds ? pruneStaleAssignments(cookie, activeTestIds) : false;
+            const tests = testsByPath.get(normalizedPathname);
+            if (tests && tests.length > 0) {
+                for (const test of tests) {
+                    if (!searchParamsMatch(test, request.nextUrl.searchParams)) {
+                        continue;
+                    }
+                    const assignment = resolveAssignment(test, cookie, normalizedPathname, onValidationFailure);
+                    const rewriteUrl = buildRewriteUrl(assignment, variantPathPrefix);
+                    const url = request.nextUrl.clone();
+                    if (rewriteUrl) {
+                        url.pathname = rewriteUrl;
+                    }
+                    const paramsChanged = applyTestUrlParams(url, test, assignment, respectExistingUrlParams);
+                    const urlChanged = url.pathname !== request.nextUrl.pathname || url.search !== request.nextUrl.search;
+                    const response = rewriteUrl || paramsChanged || urlChanged
+                        ? NextResponse.rewrite(url)
+                        : NextResponse.next();
+                    setCookieHeader(response, cookie, cookieName, cookieMaxAge);
+                    return response;
+                }
+            }
+            if (prunedStale) {
+                const response = NextResponse.next();
+                setCookieHeader(response, cookie, cookieName, cookieMaxAge);
+                return response;
+            }
+            return null;
+        }
+        catch (error) {
+            // biome-ignore lint/suspicious/noConsole: Error logging in middleware
+            console.error('Middleware A/B test error:', error);
+            return null;
+        }
+    };
+}
+/**
+ * Low-level function to process an A/B test request.
+ * Use this if you need more control over the response handling.
+ */
+export async function processAbTestRequest(pathname, searchParams, cookieValue, store, cacheTtlMs, devTestData, options = {}) {
+    const { pruneStaleAssignments: pruneStale = true, onValidationFailure } = options;
+    const normalizedPathname = normalizePath(pathname);
+    const resolvedStore = await Promise.resolve(store);
+    const testsByPath = await getCachedTests(resolvedStore, cacheTtlMs, devTestData);
+    const activeTestIds = pruneStale ? getActiveTestIds(testsByPath) : null;
+    const cookie = parseCookie(cookieValue);
+    const prunedStale = activeTestIds ? pruneStaleAssignments(cookie, activeTestIds) : false;
+    const tests = testsByPath.get(normalizedPathname);
+    if (!tests || tests.length === 0) {
+        return {
+            matched: false,
+            prunedStale,
+            cookieValue: prunedStale ? serializeCookie(cookie) : undefined,
+        };
+    }
+    for (const test of tests) {
+        if (!searchParamsMatch(test, searchParams)) {
+            continue;
+        }
+        const assignment = resolveAssignment(test, cookie, normalizedPathname, onValidationFailure);
+        const rewriteUrl = buildRewriteUrl(assignment, '');
+        return {
+            matched: true,
+            test,
+            assignment,
+            rewriteUrl,
+            cookieValue: serializeCookie(cookie),
+            prunedStale,
+        };
+    }
+    return {
+        matched: false,
+        prunedStale,
+        cookieValue: prunedStale ? serializeCookie(cookie) : undefined,
+    };
+}
+/**
+ * Create a synchronous A/B test middleware from a pre-generated static testsByPath map.
+ */
+export function createStaticAbTestMiddleware(staticTestsByPath, options = {}) {
+    const { cookieName = DEFAULT_COOKIE_NAME, cookieMaxAge = DEFAULT_COOKIE_MAX_AGE, variantPathPrefix = '', shouldProcess, onValidationFailure, pruneStaleAssignments: pruneStale = true, respectExistingUrlParams = true, } = options;
+    const testsByPathMap = new Map(Object.entries(staticTestsByPath));
+    const activeTestIds = pruneStale ? getActiveTestIds(testsByPathMap) : null;
+    return function staticAbTestMiddleware(request) {
+        const pathname = request.nextUrl.pathname;
+        if (shouldProcess && !shouldProcess(pathname)) {
+            return null;
+        }
+        const normalizedPathname = normalizePath(pathname);
+        const cookieValue = request.cookies.get(cookieName)?.value;
+        const cookie = parseCookie(cookieValue);
+        const prunedStale = activeTestIds ? pruneStaleAssignments(cookie, activeTestIds) : false;
+        const tests = testsByPathMap.get(normalizedPathname);
+        if (tests && tests.length > 0) {
+            for (const test of tests) {
+                if (!searchParamsMatch(test, request.nextUrl.searchParams)) {
+                    continue;
+                }
+                const assignment = resolveAssignment(test, cookie, normalizedPathname, onValidationFailure);
+                const rewriteUrl = buildRewriteUrl(assignment, variantPathPrefix);
+                const url = request.nextUrl.clone();
+                if (rewriteUrl) {
+                    url.pathname = rewriteUrl;
+                }
+                const paramsChanged = applyTestUrlParams(url, test, assignment, respectExistingUrlParams);
+                const urlChanged = url.pathname !== request.nextUrl.pathname || url.search !== request.nextUrl.search;
+                const response = rewriteUrl || paramsChanged || urlChanged
+                    ? NextResponse.rewrite(url)
+                    : NextResponse.next();
+                setCookieHeader(response, cookie, cookieName, cookieMaxAge);
+                return response;
+            }
+        }
+        if (prunedStale) {
+            const response = NextResponse.next();
+            setCookieHeader(response, cookie, cookieName, cookieMaxAge);
+            return response;
+        }
+        return null;
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/middleware/handler.js.map

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

package/dist/middleware/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A/B Testing Middleware
+ *
+ * Helpers for implementing server-side A/B testing in Next.js middleware.
+ */
+export { createAssignment, isValidAssignment, selectVariant } from './assignment';
+export { clearTestCache, computeCachedTest, getCachedTests, getTestCacheState, normalizePath, } from './cache';
+export { DEFAULT_COOKIE_MAX_AGE, DEFAULT_COOKIE_NAME, getAssignment, parseCookie, readCookieFromDocument, serializeCookie, setAssignment, } from './cookies';
+export type { StaticAbTestMiddlewareOptions } from './handler';
+export { createAbTestMiddleware, createStaticAbTestMiddleware, processAbTestRequest, } from './handler';
+export { getActiveTestIds, pruneStaleAssignments } from './prune';
+export type { AbTestMiddlewareConfig, AbTestResult, CachedAbTest, TestsCache, } from './types';
+export { applyUrlParams } from './urlParams';
+export { buildVariantId } from './variantId';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAClE,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,13 @@
+/**
+ * A/B Testing Middleware
+ *
+ * Helpers for implementing server-side A/B testing in Next.js middleware.
+ */
+export { createAssignment, isValidAssignment, selectVariant } from './assignment';
+export { clearTestCache, computeCachedTest, getCachedTests, getTestCacheState, normalizePath, } from './cache';
+export { DEFAULT_COOKIE_MAX_AGE, DEFAULT_COOKIE_NAME, getAssignment, parseCookie, readCookieFromDocument, serializeCookie, setAssignment, } from './cookies';
+export { createAbTestMiddleware, createStaticAbTestMiddleware, processAbTestRequest, } from './handler';
+export { getActiveTestIds, pruneStaleAssignments } from './prune';
+export { applyUrlParams } from './urlParams';
+export { buildVariantId } from './variantId';
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAOlE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/middleware/prune.d.ts

@@ -0,0 +1,13 @@
+import type { AbTestCookie } from '../types';
+import type { CachedAbTest } from './types';
+/**
+ * Collect all active test IDs from a testsByPath map.
+ */
+export declare function getActiveTestIds(testsByPath: Record<string, CachedAbTest[]> | Map<string, CachedAbTest[]>): Set<string>;
+/**
+ * Remove cookie entries for tests no longer in the active config.
+ *
+ * @returns true if any keys were removed
+ */
+export declare function pruneStaleAssignments(cookie: AbTestCookie, activeTestIds: Set<string>): boolean;
+//# sourceMappingURL=prune.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../src/middleware/prune.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GACxE,GAAG,CAAC,MAAM,CAAC,CAWb;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAW/F"}

package/dist/middleware/prune.js

@@ -0,0 +1,29 @@
+/**
+ * Collect all active test IDs from a testsByPath map.
+ */
+export function getActiveTestIds(testsByPath) {
+    const ids = new Set();
+    const testLists = testsByPath instanceof Map ? testsByPath.values() : Object.values(testsByPath);
+    for (const tests of testLists) {
+        for (const test of tests) {
+            ids.add(test.id);
+        }
+    }
+    return ids;
+}
+/**
+ * Remove cookie entries for tests no longer in the active config.
+ *
+ * @returns true if any keys were removed
+ */
+export function pruneStaleAssignments(cookie, activeTestIds) {
+    let pruned = false;
+    for (const testId of Object.keys(cookie)) {
+        if (!activeTestIds.has(testId)) {
+            delete cookie[testId];
+            pruned = true;
+        }
+    }
+    return pruned;
+}
+//# sourceMappingURL=prune.js.map

package/dist/middleware/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../../src/middleware/prune.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAyE;IAEzE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,SAAS,GAAG,WAAW,YAAY,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEjG,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB,EAAE,aAA0B;IACpF,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}