@coframe/sdk 1.1.46 → 1.1.48

package/dist/pkg/cf.esm.mjs

@@ -300,9 +300,11 @@ const generateUUID = () => {
     const cryptoObject = (_a = getGlobalScope()) === null || _a === void 0 ? void 0 : _a.crypto;
     if (cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.randomUUID)
         return cryptoObject.randomUUID();
+    const randomByte = (cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.getRandomValues)
+        ? () => cryptoObject.getRandomValues(new Uint8Array(1))[0]
+        : () => Math.floor(Math.random() * 256);
     return `${1e7}${ -1e3}${ -4e3}${ -8e3}${ -1e11}`.replace(/[018]/g, (c) => {
-        var _a, _b;
-        const randomValue = (_b = (_a = cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.getRandomValues) === null || _a === void 0 ? void 0 : _a.call(cryptoObject, new Uint8Array(1))[0]) !== null && _b !== void 0 ? _b : 0;
+        const randomValue = randomByte();
         return (c ^
             (randomValue & (15 >> (c / 4)))).toString(16);
     });
@@ -369,16 +371,30 @@ const getOrGenerateUserToken = () => {
 const setUserTokenCookie = (uuid, logger) => {
     setCookie(USER_TOKEN_COOKIE_KEY, uuid, logger);
 };
+const VISIT_BOUNDARY_MS = 2 * 60 * 60 * 1000;
+function startsNewVisit(lastVisitTime, now) {
+    return !lastVisitTime || now - lastVisitTime > VISIT_BOUNDARY_MS;
+}
+function nextVisitCount(existing, lastVisitTime, now) {
+    return startsNewVisit(lastVisitTime, now) ? existing + 1 : existing;
+}
+function parseNonNegativeInt(raw) {
+    if (!raw || !/^\d+$/.test(raw))
+        return undefined;
+    const parsed = Number(raw);
+    return parsed <= 9007199254740991 ? parsed : undefined;
+}
+function parseVisitCount(raw) {
+    var _a;
+    return (_a = parseNonNegativeInt(raw)) !== null && _a !== void 0 ? _a : 0;
+}
 const trackVisitCookie = (logger) => {
-    const visitCountString = getCookie(VISIT_COUNT_COOKIE_KEY);
-    const lastVisitTime = Number.parseInt(getCookie(LAST_VISIT_TIME_KEY), 10);
+    const existing = parseVisitCount(getCookie(VISIT_COUNT_COOKIE_KEY));
+    const lastVisitTime = parseVisitCount(getCookie(LAST_VISIT_TIME_KEY));
     const currentTime = Date.now();
-    const twoHours = 2 * 60 * 60 * 1000;
-    if (!lastVisitTime || currentTime - lastVisitTime > twoHours) {
-        const visitCount = visitCountString
-            ? Number.parseInt(visitCountString, 10) + 1
-            : 1;
-        setCookie(VISIT_COUNT_COOKIE_KEY, visitCount.toString(), logger);
+    const next = nextVisitCount(existing, lastVisitTime, currentTime);
+    if (next !== existing) {
+        setCookie(VISIT_COUNT_COOKIE_KEY, next.toString(), logger);
         setCookie(LAST_VISIT_TIME_KEY, currentTime.toString(), logger);
     }
 };
@@ -2067,6 +2083,7 @@ const applyVariantChanges = (variantElements, currentUrl, logger, nonce, lifecyc
         ? lifecycleContext.runtime.createVariantSession({
             batchId: lifecycleContext.batchId,
             variantId: variant.id,
+            experimentId: variant.experiment_id,
         })
         : null;
     if (!variant.modifications ||
@@ -2104,7 +2121,7 @@ const applyVariantChanges = (variantElements, currentUrl, logger, nonce, lifecyc
             });
         }
         else if (selectedElement instanceof HTMLElement) {
-            selectedElement.setAttribute('coframe-exp-id', variant.id);
+            selectedElement.setAttribute('coframe-exp-id', variant.experiment_id);
         }
     }
     return true;
@@ -2290,6 +2307,16 @@ function murmurHash3_x86_32(key, seed) {
     return h1 >>> 0;
 }
 
+function parseLaneCookie(raw) {
+    if (!raw)
+        return {};
+    try {
+        return parseClaims(decodeURIComponent(raw));
+    }
+    catch (_a) {
+        return parseClaims(raw);
+    }
+}
 function parseClaims(raw) {
     if (!raw)
         return {};
@@ -2723,7 +2750,7 @@ function checkAllAudiences(metadata, ctx) {
         const audience = ctx.project.audiences[audienceId];
         if (!audience)
             continue;
-        const activated = checkActivationCondition(audience.selector, ctx.personalizationHeaders, ctx.currentPageUrl, ctx.languages, ctx.browserPlatform, ctx.userToken, ctx.userVisitCount, (js, args) => executeJs(js, args, { isExpression: true, nonce: ctx.nonce }), ctx.logger);
+        const activated = checkActivationCondition(audience.selector, ctx.personalizationHeaders, ctx.currentPageUrl, ctx.languages, ctx.browserPlatform, ctx.userToken, ctx.userVisitCount, ctx.runJsFunction, ctx.logger);
         if (activated === false)
             return false;
         if (activated !== true)
@@ -2731,8 +2758,12 @@ function checkAllAudiences(metadata, ctx) {
     }
     return result;
 }
-async function getVariantsAndElements(personalizationHeaders, project, previewVariantId, userToken, currentPageUrl, languages, browserPlatform, logger, nonce, laneClaims = {}, silentFallback = false, chooseCmabVariants) {
-    var _a;
+function audiencesPass(metadata, ctx) {
+    const result = checkAllAudiences(metadata, ctx);
+    return ctx.unknownIsInactive ? result === true : result !== false;
+}
+async function getVariantsAndElements(personalizationHeaders, project, previewVariantId, userToken, currentPageUrl, languages, browserPlatform, logger, nonce, laneClaims = {}, silentFallback = false, chooseCmabVariants, userVisitCountOverride, runtime = {}) {
+    var _a, _b;
     const experimentsInfo = [];
     const cloakBot = !!((_a = project.settings) === null || _a === void 0 ? void 0 : _a.bot_cloaking_enabled) &&
         personalizationHeaders['x-is-bot'] === 'true';
@@ -2744,7 +2775,11 @@ async function getVariantsAndElements(personalizationHeaders, project, previewVa
             laneClaims: meClaims,
         };
     };
-    const userVisitCount = Number.parseInt(getCookie(VISIT_COUNT_COOKIE_KEY) || '0', 10);
+    const userVisitCount = userVisitCountOverride !== null && userVisitCountOverride !== void 0 ? userVisitCountOverride : parseVisitCount(getCookie(VISIT_COUNT_COOKIE_KEY));
+    const evaluateJsFunctions = (_b = runtime.evaluateJsFunctions) !== null && _b !== void 0 ? _b : true;
+    const runJsFunction = evaluateJsFunctions
+        ? (js, args) => executeJs(js, args, { isExpression: true, nonce })
+        : undefined;
     const ctx = {
         project,
         personalizationHeaders,
@@ -2753,8 +2788,9 @@ async function getVariantsAndElements(personalizationHeaders, project, previewVa
         languages,
         browserPlatform,
         userVisitCount,
-        nonce,
         logger,
+        runJsFunction,
+        unknownIsInactive: !evaluateJsFunctions,
     };
     const validatedClaims = validateClaims(laneClaims, project.lanes);
     const previewVariantIds = splitPreviewVariantIds(previewVariantId);
@@ -2809,27 +2845,24 @@ function activateFrames(ctx) {
     return ctx.project.frames.filter((frame) => {
         if (!frame.experiments)
             return false;
-        const frameActivated = checkActivationCondition(frame.activation_condition, ctx.personalizationHeaders, ctx.currentPageUrl, ctx.languages, ctx.browserPlatform, ctx.userToken, ctx.userVisitCount, (js, args) => executeJs(js, args, { isExpression: true, nonce: ctx.nonce }), ctx.logger);
-        if (!frameActivated)
-            return false;
-        return true;
+        const frameActivated = checkActivationCondition(frame.activation_condition, ctx.personalizationHeaders, ctx.currentPageUrl, ctx.languages, ctx.browserPlatform, ctx.userToken, ctx.userVisitCount, ctx.runJsFunction, ctx.logger);
+        return ctx.unknownIsInactive ? frameActivated === true : !!frameActivated;
     });
 }
 async function assignFrames(activeFrames, validatedClaims, ctx, chooseCmabVariants) {
-    var _a;
+    var _a, _b, _c;
     const { project, userToken, logger } = ctx;
     const experimentsInfo = [];
     const variantsAndElements = [];
-    const evalAudiences = (metadata) => checkAllAudiences(metadata, ctx) !== false;
     const audiencePass = new Map();
     const reachableByLane = {};
     for (const frame of activeFrames) {
-        for (const experiment of frame.experiments) {
+        for (const experiment of (_a = frame.experiments) !== null && _a !== void 0 ? _a : []) {
             const metadata = experiment.metadata;
             const laneIds = experimentLaneIds(metadata);
             if (laneIds.length === 0)
                 continue;
-            const passes = evalAudiences(metadata);
+            const passes = audiencesPass(metadata, ctx);
             audiencePass.set(metadata.experiment_id, passes);
             if (passes) {
                 for (const laneId of laneIds) {
@@ -2846,7 +2879,7 @@ async function assignFrames(activeFrames, validatedClaims, ctx, chooseCmabVarian
     let hasActivatedFrames = false;
     for (const frame of activeFrames) {
         let atLeastOneExperimentWasActivated = false;
-        for (const experiment of frame.experiments) {
+        for (const experiment of (_b = frame.experiments) !== null && _b !== void 0 ? _b : []) {
             if (atLeastOneExperimentWasActivated)
                 break;
             const metadata = experiment.metadata;
@@ -2856,7 +2889,7 @@ async function assignFrames(activeFrames, validatedClaims, ctx, chooseCmabVarian
                 continue;
             let activated = audiencePass.get(metadata.experiment_id);
             if (activated === undefined) {
-                activated = evalAudiences(metadata);
+                activated = audiencesPass(metadata, ctx);
             }
             if (!activated)
                 continue;
@@ -2912,7 +2945,7 @@ async function assignFrames(activeFrames, validatedClaims, ctx, chooseCmabVarian
         try {
             mlVariantIds = await chooseCmabVariants(Array.from(cmabMetadataById.values()), userToken);
         }
-        catch (_b) {
+        catch (_d) {
             mlVariantIds = new Map();
         }
     }
@@ -2923,7 +2956,7 @@ async function assignFrames(activeFrames, validatedClaims, ctx, chooseCmabVarian
         }
         const { metadata, variants, elements } = entry;
         let mlVariantId = metadata.type === 'CMAB'
-            ? ((_a = mlVariantIds.get(metadata.experiment_id)) !== null && _a !== void 0 ? _a : null)
+            ? ((_c = mlVariantIds.get(metadata.experiment_id)) !== null && _c !== void 0 ? _c : null)
             : null;
         if (mlVariantId && !variants.some((v) => v.id === mlVariantId)) {
             logger.warn(`CMAB variant ${mlVariantId} not in experiment ${metadata.experiment_id}`, 'cmab_variant_not_found', { experiment_id: metadata.experiment_id });
@@ -2976,9 +3009,12 @@ async function previewVariants(previewVariantIds, validatedClaims, ctx, silentFa
     return uniqueByVariantId([...rolledOutVariants, ...requestedVariants]);
 }
 function findVariants(frames, variantIds) {
-    return frames.flatMap((frame) => frame.experiments.flatMap((experiment) => experiment.variants
-        .filter((variant) => variantIds.includes(variant.id))
-        .map((variant) => ({ variant, elements: frame.elements }))));
+    return frames.flatMap((frame) => {
+        var _a;
+        return ((_a = frame.experiments) !== null && _a !== void 0 ? _a : []).flatMap((experiment) => experiment.variants
+            .filter((variant) => variantIds.includes(variant.id))
+            .map((variant) => ({ variant, elements: frame.elements })));
+    });
 }
 function uniqueByVariantId(items) {
     const seen = {};
@@ -2990,10 +3026,13 @@ function uniqueByVariantId(items) {
     });
 }
 function keepRolledOutExperiments(frames) {
-    return frames.map((frame) => ({
-        ...frame,
-        experiments: frame.experiments.filter((experiment) => experiment.metadata.serving_mode === 'winner'),
-    }));
+    return frames.map((frame) => {
+        var _a;
+        return ({
+            ...frame,
+            experiments: ((_a = frame.experiments) !== null && _a !== void 0 ? _a : []).filter((experiment) => experiment.metadata.serving_mode === 'winner'),
+        });
+    });
 }
 
 function buildSessionContext(isInitialApply) {
@@ -3664,6 +3703,7 @@ async function resolveProject(Coframe, previewVariantId, isSessionVariant, confi
     const queuedHeaders = getQueuedPersonalizationHeaders();
     let personalizationHeaders = queuedHeaders;
     let project = isSessionVariant ? undefined : projectData === null || projectData === void 0 ? void 0 : projectData.project;
+    const assignmentContext = project ? projectData === null || projectData === void 0 ? void 0 : projectData.assignmentContext : undefined;
     if (!project) {
         const edgeResult = await fetchProject(config.projectUrl, Coframe.projectId, config.currentUrl || getCurrentPageUrl(), undefined, config.userContext, previewVariantId || undefined, undefined, (_b = config.referrer) !== null && _b !== void 0 ? _b : getBrowserReferrer());
         personalizationHeaders = mergeClientHeaders(queuedHeaders, edgeResult === null || edgeResult === void 0 ? void 0 : edgeResult.personalizationHeaders);
@@ -3680,6 +3720,7 @@ async function resolveProject(Coframe, previewVariantId, isSessionVariant, confi
     return {
         project,
         personalizationHeaders: personalizationHeaders,
+        ...(assignmentContext ? { assignmentContext } : {}),
     };
 }
 
@@ -4157,7 +4198,7 @@ function setupListeners(Coframe, executionStartTime) {
         for (const variantElement of Coframe.variantsAndElements || []) {
             const variant = variantElement.variant;
             if (!experiencedCoframeIds.has(variant.id)) {
-                const elements = document.querySelectorAll(`[coframe-exp-id="${variant.id}"]`);
+                const elements = document.querySelectorAll(`[coframe-exp-id="${variant.experiment_id}"]`);
                 for (const el of Array.from(elements)) {
                     if (isElementVisible(el)) {
                         el.setAttribute('coframe-experienced', 'true');
@@ -4451,18 +4492,12 @@ function setupSPANavigation(Coframe, project, config, previewVariantId, isSessio
 }
 function readLaneClaims() {
     const cookie = getCookie(LANE_COOKIE_KEY);
-    if (cookie) {
-        try {
-            return parseClaims(decodeURIComponent(cookie));
-        }
-        catch (_a) {
-            return parseClaims(cookie);
-        }
-    }
+    if (cookie)
+        return parseLaneCookie(cookie);
     try {
         return parseClaims(localStorage.getItem(LANE_COOKIE_KEY));
     }
-    catch (_b) {
+    catch (_a) {
         return {};
     }
 }
@@ -4477,14 +4512,17 @@ function persistLaneClaims(claims, logger) {
         setCookie(LANE_COOKIE_KEY, encodeURIComponent(serialized), logger);
     }
 }
-function createApplyVariants(Coframe, config, previewVariantId, isSessionVariant, executionStartTime, analytics, laneStore, runtime) {
+function createApplyVariants(Coframe, config, previewVariantId, isSessionVariant, executionStartTime, analytics, laneStore, runtime, initialAssignmentContext) {
     let isFirstApply = true;
+    let snapshotContext = initialAssignmentContext;
     let applicationId = 0;
     const apply = async (pageUrl, pageProject, personalizationHeaders, signal, deadline) => {
-        var _a, _b;
+        var _a, _b, _c, _d;
         const currentApplication = ++applicationId;
         if (signal === null || signal === void 0 ? void 0 : signal.aborted)
             return 'skipped';
+        const assignmentContext = snapshotContext;
+        snapshotContext = undefined;
         const preview = resolvePreview(pageUrl, previewVariantId, isSessionVariant);
         const chooseCmabVariants = createCmabVariantBatchChooser({
             projectId: Coframe.projectId,
@@ -4495,7 +4533,7 @@ function createApplyVariants(Coframe, config, previewVariantId, isSessionVariant
             disableRemoteAssignment: Boolean(config.projectUrl || config.ingestUrl),
             userContext: config.userContext,
         });
-        const { variantsAndElements, experimentsInfo, hasActivatedFrames, laneClaims, } = await getVariantsAndElements(personalizationHeaders, pageProject, preview.previewVariantId, Coframe.userToken, pageUrl, getBrowserLanguages(), getBrowserPlatform(), Coframe.logger, config.nonce, laneStore.claims, preview.isSessionVariant, chooseCmabVariants);
+        const { variantsAndElements, experimentsInfo, hasActivatedFrames, laneClaims, } = await getVariantsAndElements(personalizationHeaders, pageProject, preview.previewVariantId, Coframe.userToken, pageUrl, (_b = assignmentContext === null || assignmentContext === void 0 ? void 0 : assignmentContext.languages) !== null && _b !== void 0 ? _b : getBrowserLanguages(), (_c = assignmentContext === null || assignmentContext === void 0 ? void 0 : assignmentContext.browserPlatform) !== null && _c !== void 0 ? _c : getBrowserPlatform(), Coframe.logger, config.nonce, laneStore.claims, preview.isSessionVariant, chooseCmabVariants, assignmentContext === null || assignmentContext === void 0 ? void 0 : assignmentContext.userVisitCount);
         if ((signal === null || signal === void 0 ? void 0 : signal.aborted) ||
             currentApplication !== applicationId ||
             (runtime === null || runtime === void 0 ? void 0 : runtime.isDestroyed()) ||
@@ -4503,7 +4541,7 @@ function createApplyVariants(Coframe, config, previewVariantId, isSessionVariant
             return 'skipped';
         if (!signal &&
             runtime &&
-            ((_b = pageProject === null || pageProject === void 0 ? void 0 : pageProject.settings) === null || _b === void 0 ? void 0 : _b.mutation_observer_active) &&
+            ((_d = pageProject === null || pageProject === void 0 ? void 0 : pageProject.settings) === null || _d === void 0 ? void 0 : _d.mutation_observer_active) &&
             !urlsMatch(pageUrl, getCurrentPageUrl(), true))
             return 'stale-route';
         if (!signal && runtime) {
@@ -4549,7 +4587,7 @@ function createApplyVariants(Coframe, config, previewVariantId, isSessionVariant
 async function modifyPage(Coframe, configResult, projectResult, analytics, lifecycle) {
     var _a;
     const { config, timeoutMs, previewVariantId, isSessionVariant, integrationStartTime, executionStartTime, } = configResult;
-    const { project: cdnProject, personalizationHeaders } = projectResult;
+    const { project: cdnProject, personalizationHeaders, assignmentContext, } = projectResult;
     const revealCoordinator = (_a = lifecycle === null || lifecycle === void 0 ? void 0 : lifecycle.revealCoordinator) !== null && _a !== void 0 ? _a : createRevealCoordinator(revealPage, logRevealListenerError(() => Coframe.logger));
     const runtime = lifecycle === null || lifecycle === void 0 ? void 0 : lifecycle.runtime;
     if (runtime && config.waitForHydration) {
@@ -4575,7 +4613,7 @@ async function modifyPage(Coframe, configResult, projectResult, analytics, lifec
     if (!(await ensureBody(Coframe, cdnProject, timeoutMs, config.nonce, revealCoordinator, () => !(runtime === null || runtime === void 0 ? void 0 : runtime.isDestroyed()))))
         return;
     const laneStore = { claims: readLaneClaims() };
-    const applier = createApplyVariants(Coframe, config, previewVariantId, isSessionVariant, executionStartTime, analytics, laneStore, runtime);
+    const applier = createApplyVariants(Coframe, config, previewVariantId, isSessionVariant, executionStartTime, analytics, laneStore, runtime, assignmentContext);
     const initialUrl = getCurrentPageUrl();
     if (runtime) {
         const runtimeUrl = runtime.getState().currentUrl;
@@ -5178,6 +5216,9 @@ function injectOptions(options) {
             projectData: {
                 project: options.projectData.project,
                 personalizationHeaders: (_a = options.projectData.personalizationHeaders) !== null && _a !== void 0 ? _a : {},
+                ...(options.projectData.assignmentContext
+                    ? { assignmentContext: options.projectData.assignmentContext }
+                    : {}),
             },
         });
     }
@@ -5387,6 +5428,7 @@ function createVariantSession(options) {
         getPageState: () => ({ ...options.getPageState() }),
         getState: () => ({ ...state }),
         getVariantId: () => state.variantId,
+        getExperimentId: () => options.experimentId,
         onPage: (event, handler) => subscribe(event, handler, false),
         oncePage: (event, handler) => subscribe(event, handler, true),
         ready() {
@@ -5746,6 +5788,7 @@ function createPageRuntime(options) {
             const session = createVariantSession({
                 sessionId: createId(),
                 variantId: input.variantId,
+                experimentId: input.experimentId,
                 batchId: batch.batchId,
                 routeVersion: batch.routeVersion,
                 getPageState: () => ({ ...state }),

package/dist/pkg/feature-flags.cjs.js

@@ -34,9 +34,11 @@ const generateUUID = () => {
     const cryptoObject = (_a = getGlobalScope()) === null || _a === void 0 ? void 0 : _a.crypto;
     if (cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.randomUUID)
         return cryptoObject.randomUUID();
+    const randomByte = (cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.getRandomValues)
+        ? () => cryptoObject.getRandomValues(new Uint8Array(1))[0]
+        : () => Math.floor(Math.random() * 256);
     return `${1e7}${ -1e3}${ -4e3}${ -8e3}${ -1e11}`.replace(/[018]/g, (c) => {
-        var _a, _b;
-        const randomValue = (_b = (_a = cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.getRandomValues) === null || _a === void 0 ? void 0 : _a.call(cryptoObject, new Uint8Array(1))[0]) !== null && _b !== void 0 ? _b : 0;
+        const randomValue = randomByte();
         return (c ^
             (randomValue & (15 >> (c / 4)))).toString(16);
     });

package/dist/pkg/feature-flags.esm.mjs

@@ -32,9 +32,11 @@ const generateUUID = () => {
     const cryptoObject = (_a = getGlobalScope()) === null || _a === void 0 ? void 0 : _a.crypto;
     if (cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.randomUUID)
         return cryptoObject.randomUUID();
+    const randomByte = (cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.getRandomValues)
+        ? () => cryptoObject.getRandomValues(new Uint8Array(1))[0]
+        : () => Math.floor(Math.random() * 256);
     return `${1e7}${ -1e3}${ -4e3}${ -8e3}${ -1e11}`.replace(/[018]/g, (c) => {
-        var _a, _b;
-        const randomValue = (_b = (_a = cryptoObject === null || cryptoObject === void 0 ? void 0 : cryptoObject.getRandomValues) === null || _a === void 0 ? void 0 : _a.call(cryptoObject, new Uint8Array(1))[0]) !== null && _b !== void 0 ? _b : 0;
+        const randomValue = randomByte();
         return (c ^
             (randomValue & (15 >> (c / 4)))).toString(16);
     });