@kameleoon/react-sdk 10.17.1 → 10.18.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Change Log
 
+## 10.18.0 (2025-10-22)
+
+> [!WARNING]
+> If you're upgrading from a version earlier than 10.15.0 and run into any unexpected build or SDK-related issues, please reach out to the Kameleoon Support Team. We're here to ensure your transition is smooth and will promptly address any concerns.
+
+### 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).
+- Updated dependencies
+  - @kameleoon/javascript-sdk@4.16.0
+
+[getDataFile]: https://developers.kameleoon.com/feature-management-and-experimentation/web-sdks/react-js-sdk#getdatafile
+[setLegalConsent]: https://developers.kameleoon.com/feature-management-and-experimentation/web-sdks/react-js-sdk#setLegalConsent
+
 ## 10.17.1 (2025-09-03)
 
 > [!WARNING]

package/dist/interfaces/useFeatureFlag.d.ts

@@ -1,4 +1,4 @@
-import { FeatureFlagType, KameleoonVariationType, FeatureFlagVariableType, FeatureVariableResultType, GetFeatureFlagVariableParamsType, GetVariationsParamsType, VariationType, GetVariationParamsType, IsFeatureFlagActiveParamsType, SetForcedVariationParametersType } from '@kameleoon/javascript-sdk';
+import { DataFile, FeatureFlagType, KameleoonVariationType, FeatureFlagVariableType, FeatureVariableResultType, GetFeatureFlagVariableParamsType, GetVariationsParamsType, GetVariationParamsType, IsFeatureFlagActiveParamsType, SetForcedVariationParametersType, Variation } from '@kameleoon/javascript-sdk';
 export default interface IUseFeatureFlag {
     /**
      * Returns a variation for the visitor under `visitorCode` for the specified `featureKye`, this method includes targeting check, finding the according variation exposed to the visitor and saving it to storage
@@ -17,7 +17,7 @@ export default interface IUseFeatureFlag {
      * - `KameleoonException.FeatureFlagConfigurationNotFound` - No feature flag was found for provided `featureKey`
      * - `KameleoonException.FeatureFlagEnvironmentDisabled` - The feature flag is disabled for the current environment
      * */
-    getVariation: ({ visitorCode, featureKey, track, }: GetVariationParamsType) => VariationType;
+    getVariation: ({ visitorCode, featureKey, track, }: GetVariationParamsType) => Variation;
     /**
      * Returns all variations for the visitor under `visitorCode` for all the feature flags, this method includes targeting check, finding the according variations exposed to the visitor and saving them to storage. By default the method obtains all the variations, but if `onlyActive` is set to `true`, only active variations will be returned (those that are not `off`)
      *
@@ -33,7 +33,7 @@ export default interface IUseFeatureFlag {
      * - `KameleoonException.VisitorCodeEmpty` The visitor code is empty
      * - `KameleoonException.Initialization` - Method was executed before the `kameleoonClient` completed it's `initialize` call
      */
-    getVariations: ({ visitorCode, onlyActive, track, }: GetVariationsParamsType) => Map<string, VariationType>;
+    getVariations: ({ visitorCode, onlyActive, track, }: GetVariationsParamsType) => Map<string, Variation>;
     /**
      * @deprecated this method overload is deprecated and will be removed in the next major release. Please use `isFeatureFlagActive` overload with an object parameters instead.
      * Indicates whether the visitor with `visitorCode` has `featureKey` active for him, this method includes targeting check, finding the according variation exposed to the visitor and saving it to storage along with sending tracking request
@@ -226,4 +226,10 @@ export default interface IUseFeatureFlag {
      * - `KameleoonException.Initialization` - Method was executed before the `kameleoonClient` completed its `initialize` call
      */
     evaluateAudiences(visitorCode: string): void;
+    /**
+     * @method getDataFile - retrieves the current SDK configuration (also known as the data file),
+     * containing all feature flags and their variations.
+     * @returns {DataFile} - The data file object containing the configuration details.
+     */
+    getDataFile(): DataFile;
 }