@coframe/sdk 1.1.47 → 1.1.49

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);
     }
 };
@@ -2105,7 +2121,13 @@ const applyVariantChanges = (variantElements, currentUrl, logger, nonce, lifecyc
             });
         }
         else if (selectedElement instanceof HTMLElement) {
-            selectedElement.setAttribute('coframe-exp-id', variant.experiment_id);
+            const listAttribute = 'coframe-experiment-ids';
+            const listed = selectedElement.getAttribute(listAttribute);
+            const experimentIds = listed ? listed.split(',') : [];
+            if (experimentIds.indexOf(variant.experiment_id) === -1) {
+                experimentIds.push(variant.experiment_id);
+                selectedElement.setAttribute(listAttribute, experimentIds.join(','));
+            }
         }
     }
     return true;
@@ -2291,6 +2313,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 {};
@@ -2724,7 +2756,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)
@@ -2732,8 +2764,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';
@@ -2745,7 +2781,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,
@@ -2754,8 +2794,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);
@@ -2810,27 +2851,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) {
@@ -2847,7 +2885,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;
@@ -2857,7 +2895,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;
@@ -2913,7 +2951,7 @@ async function assignFrames(activeFrames, validatedClaims, ctx, chooseCmabVarian
         try {
             mlVariantIds = await chooseCmabVariants(Array.from(cmabMetadataById.values()), userToken);
         }
-        catch (_b) {
+        catch (_d) {
             mlVariantIds = new Map();
         }
     }
@@ -2924,7 +2962,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 });
@@ -2977,9 +3015,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 = {};
@@ -2991,10 +3032,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) {
@@ -3665,6 +3709,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);
@@ -3681,6 +3726,7 @@ async function resolveProject(Coframe, previewVariantId, isSessionVariant, confi
     return {
         project,
         personalizationHeaders: personalizationHeaders,
+        ...(assignmentContext ? { assignmentContext } : {}),
     };
 }
 
@@ -4158,8 +4204,11 @@ 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.experiment_id}"]`);
+                const elements = document.querySelectorAll('[coframe-experiment-ids]');
                 for (const el of Array.from(elements)) {
+                    const experimentIds = (el.getAttribute('coframe-experiment-ids') || '').split(',');
+                    if (experimentIds.indexOf(variant.experiment_id) === -1)
+                        continue;
                     if (isElementVisible(el)) {
                         el.setAttribute('coframe-experienced', 'true');
                         experiencedCoframeIds.add(variant.id);
@@ -4452,18 +4501,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 {};
     }
 }
@@ -4478,14 +4521,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,
@@ -4496,7 +4542,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()) ||
@@ -4504,7 +4550,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) {
@@ -4550,7 +4596,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) {
@@ -4576,7 +4622,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;
@@ -5179,6 +5225,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 }
+                    : {}),
             },
         });
     }

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);
     });