@kameleoon/javascript-sdk-core 5.15.0 → 5.16.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Change Log
 
+## 5.16.0 (2025-10-22)
+
+### Minor Changes
+
+- Introduced a new [`getDataFile`](getDataFile) method. This method returns the current SDK configuration (also known as the **data file**) used for evaluation and targeting. It is **not** intended for production use to fetch variations for every feature flag in the returned list, as it is not optimized for performance. For that purpose, use [`getVariations`](getVariations) instead. `getDataFile` is mainly useful for debugging or QA, for example to let internal users manually select a variant for a specific feature flag in production.
+
+### Patch Changes
+
+- Addressed an issue where tracking data was sent for visitors who had not provided [consent](setLegalConsent).
+
+[setLegalConsent]: https://developers.kameleoon.com/feature-management-and-experimentation/web-sdks/js-sdk#setLegalConsent
+[getDataFile]: https://developers.kameleoon.com/feature-management-and-experimentation/web-sdks/js-sdk#getdatafile
+
 ## 5.15.0 (2025-09-01)
 
 > [!WARNING]

package/dist/browser.d.ts

@@ -23,3 +23,4 @@ export { MappingIdentifierType } from './storage/types';
 export { CustomDataConfigurationType, CustomDataScope, } from './clientConfiguration';
 export { ListUtilities, Utilities } from './utilities';
 export { BrowserDataType, CustomDataType, DataFilterType, DataManagerParametersType, DeviceDataType, GeolocationDataType, KameleoonVisitorDataType, MutUpdateTargetingDataParametersType, OperatingSystemDataType, PageViewDataType, ProcessCustomDataManagerParametersType, VisitDataType, VisitorsDataType, } from './kameleoonData/types';
+export { FeatureFlag, Rule, DataFile, Variable, Variation } from './types';

package/dist/clientConfiguration/types.d.ts

@@ -70,6 +70,7 @@ export type ExperimentType = {
     variationByExposition: VariationByExpositionType[];
 };
 export type FeatureVariationType = {
+    name?: string;
     key: string;
     variables: FeatureVariableType[];
 };

package/dist/index.d.ts

@@ -23,3 +23,4 @@ export { MappingIdentifierType } from './storage/types';
 export { CustomDataConfigurationType, CustomDataScope, } from './clientConfiguration';
 export { ListUtilities, Utilities } from './utilities';
 export { BrowserDataType, CustomDataType, DataFilterType, DataManagerParametersType, DeviceDataType, GeolocationDataType, KameleoonVisitorDataType, MutUpdateTargetingDataParametersType, OperatingSystemDataType, PageViewDataType, ProcessCustomDataManagerParametersType, VisitDataType, VisitorsDataType, } from './kameleoonData/types';
+export { FeatureFlag, Rule, DataFile, Variable, Variation } from './types';

package/dist/javascript-sdk-core-browser.cjs.js

@@ -5149,7 +5149,7 @@ class ConditionFactory {
             case TargetingType.HEAT_SLICE:
                 return buildExports.Ok(new ConversionLikelihood(data));
             default:
-                KameleoonLogger.error `Unsupported targeted condition type found: ${targetingType}`;
+                KameleoonLogger.info `Unsupported targeted condition type found: ${targetingType}`;
                 return buildExports.Err(new KameleoonError(exports.KameleoonException.TargetingCondition, targetingType));
         }
     }
@@ -7807,7 +7807,7 @@ class BodyProvider {
         const identifier = isMappingIdentifier
             ? UrlParameter.MappingValue
             : UrlParameter.VisitorCode;
-        return identifier + visitorCode;
+        return identifier + encodeURIComponent(visitorCode);
     }
 }
 
@@ -8391,6 +8391,7 @@ class KameleoonClient {
             }
             const resultVariables = variables.map((variable) => Parser.parseFeatureVariable(variable).throw());
             resultFeatureList.set(variation.featureKey, {
+                name: '',
                 key: variationKey,
                 id: variationId,
                 experimentId,
@@ -8611,6 +8612,62 @@ class KameleoonClient {
         this.flush(visitorCode);
         KameleoonLogger.info `RETURN: KameleoonClient.evaluateAudiences(visitorCode: ${visitorCode})`;
     }
+    getDataFile() {
+        const dataFile = {
+            featureFlags: new Map(),
+        };
+        if (this.stubMode) {
+            return dataFile;
+        }
+        KameleoonLogger.debug `CALL: KameleoonClient.getDataFile()`;
+        this.clientConfiguration.featureFlags.forEach((featureFlag, key) => {
+            const variationsMap = new Map();
+            featureFlag.variations.forEach((sourceVariation) => {
+                var _a;
+                const variablesMap = new Map();
+                sourceVariation.variables.forEach((variable) => {
+                    try {
+                        const parsedVariable = Parser.parseFeatureVariable(variable).throw();
+                        variablesMap.set(variable.key, parsedVariable);
+                    }
+                    catch (err) {
+                        KameleoonLogger.error `Error parsing variable ${variable.key} of feature flag ${featureFlag.featureKey}: ${err}`;
+                    }
+                });
+                variationsMap.set(sourceVariation.key, {
+                    name: (_a = sourceVariation.name) !== null && _a !== void 0 ? _a : '',
+                    key: sourceVariation.key,
+                    id: null,
+                    experimentId: null,
+                    variables: variablesMap,
+                });
+            });
+            const rules = featureFlag.rules.map((rule) => {
+                const ruleVariations = new Map();
+                rule.variationByExposition.forEach((varByExp) => {
+                    const baseVariation = variationsMap.get(varByExp.variationKey);
+                    if (!baseVariation)
+                        return;
+                    ruleVariations.set(baseVariation.key, {
+                        name: baseVariation.name,
+                        key: baseVariation.key,
+                        id: varByExp.variationId,
+                        experimentId: rule.experimentId,
+                        variables: baseVariation.variables,
+                    });
+                });
+                return { variations: ruleVariations };
+            });
+            dataFile.featureFlags.set(key, {
+                variations: variationsMap,
+                environmentEnabled: featureFlag.environmentEnabled,
+                rules,
+                defaultVariationKey: featureFlag.defaultVariationKey,
+            });
+        });
+        KameleoonLogger.debug `RETURN: KameleoonClient.getDataFile() -> (dataFile: ${dataFile})`;
+        return dataFile;
+    }
     setUserConsent({ visitorCode, consent, setData, }) {
         if (this.stubMode) {
             return;
@@ -8797,6 +8854,7 @@ class KameleoonClient {
         return selected;
     }
     _getFeatureVariation({ visitorCode, featureKey, track, }) {
+        var _a, _b;
         KameleoonLogger.debug `CALL: KameleoonClient._getFeatureVariation(visitorCode: ${visitorCode}, featureKey: ${featureKey}, track: ${track})`;
         if (!this.initialized) {
             return buildExports.Err(new KameleoonError(exports.KameleoonException.Initialization));
@@ -8847,7 +8905,9 @@ class KameleoonClient {
         if (track && !isSimulated) {
             this.tracker.scheduleVisitor(visitorCode, this._isConsentProvided(visitorCode));
         }
+        const variationName = (_b = (_a = featureFlag.variations.find((item) => item.key === variationKey)) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : '';
         const resultData = {
+            name: variationName,
             key: variationKey,
             id: variationId,
             experimentId,