@kameleoon/react-sdk 10.13.0 → 10.14.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Change Log
 
+## 10.14.0 (2025-07-23)
+
+### Features
+
+- Added the [`evaluateAudiences`][evaluateAudiences] method. This method iterates over all Audiences Explorer segments, evaluates each one, and tracks the segments for which the visitor is targeted using the [`TARGETINGSEGMENT`](https://developers.kameleoon.com/apis/data-api-rest/all-endpoints/post-visit-events/) event.
+
+### Patch Changes
+
+- Fixed an issue where `defaultDataFile` loaded configuration incorrectly when using the new [v3 data file format](sdk-config.kameleoon.eu/v3/<sitecode>).
+- Updated dependencies
+  - @kameleoon/javascript-sdk@4.13.0
+
+[evaluateAudiences]: https://developers.kameleoon.com/feature-management-and-experimentation/web-sdks/react-js-sdk#evaluateaudiences
+
+## 10.13.1 (2025-07-11)
+
+### Patch Changes
+
+- Stability and performance improvements
+- Updated dependencies
+  - @kameleoon/javascript-sdk@4.12.1
+
 ## 10.13.0 (2025-07-10)
 
 ### Features

package/dist/createClient.js

@@ -1 +1 @@
-"use strict";var _javascriptSdk=require("@kameleoon/javascript-sdk");Object.defineProperty(exports,"__esModule",{value:!0}),exports.createClient=createClient;function createClient(a){let{siteCode:b,configuration:c,externals:d,stubMode:e}=a;const f=new _javascriptSdk.KameleoonClient({siteCode:b,configuration:c,externals:d,_internals:{packageInfo:{type:_javascriptSdk.SdkLanguageType.REACT,version:"10.13.0",isServer:!1},prng:null===d||void 0===d?void 0:d.prng},stubMode:e});return f}
+"use strict";var _javascriptSdk=require("@kameleoon/javascript-sdk");Object.defineProperty(exports,"__esModule",{value:!0}),exports.createClient=createClient;function createClient(a){let{siteCode:b,configuration:c,externals:d,stubMode:e}=a;const f=new _javascriptSdk.KameleoonClient({siteCode:b,configuration:c,externals:d,_internals:{packageInfo:{type:_javascriptSdk.SdkLanguageType.REACT,version:"10.14.0",isServer:!1},prng:null===d||void 0===d?void 0:d.prng},stubMode:e});return f}

package/dist/interfaces/useFeatureFlag.d.ts

@@ -216,4 +216,14 @@ export default interface IUseFeatureFlag {
      * - `KameleoonException.StorageWrite` - Couldn't update storage data
      */
     setForcedVariation: ({ visitorCode, experimentId, variationKey, forceTargeting, }: SetForcedVariationParametersType) => void;
+    /**
+     * @method evaluateAudiences - evaluates the visitor against all available Audiences Explorer segments and tracks those that match.
+     * A detailed analysis of segment performance can then be performed directly in Audiences Explorer.
+     * @param visitorCode {string} - The unique visitor code identifying the visitor.
+     * @throws `KameleoonError` with one of the following `type` s:
+     * - `KameleoonException.VisitorCodeMaxLength` - The visitor code length was exceeded
+     * - `KameleoonException.VisitorCodeEmpty` The visitor code is empty
+     * - `KameleoonException.Initialization` - Method was executed before the `kameleoonClient` completed its `initialize` call
+     */
+    evaluateAudiences(visitorCode: string): void;
 }

package/dist/useFeatureFlag.d.ts

@@ -14,6 +14,7 @@ import IUseFeatureFlag from './interfaces/useFeatureFlag';
  * - `getFeatureFlags`,
  * - `getFeatureFlagVariables`,
  * - `getEngineTrackingCode`,
- * - `setForcedVariation`
+ * - `setForcedVariation`,
+ * - `evaluateAudiences`
  */
 export declare function useFeatureFlag(): IUseFeatureFlag;

package/dist/useFeatureFlag.js

@@ -1 +1 @@
-"use strict";"use client";Object.defineProperty(exports,"__esModule",{value:!0}),exports.useFeatureFlag=useFeatureFlag;var _react=require("react"),_useKameleoonContext=require("./useKameleoonContext");function useFeatureFlag(){const a=(0,_useKameleoonContext.useKameleoonContext)();let b=a?a.kameleoonClient:null;const c=(0,_react.useCallback)((c,d)=>{if(b=(0,_useKameleoonContext.fetchClientFromContext)(a),"string"==typeof c){if(!d)throw new Error("[Kameleoon React SDK Error]: Overload is not used correctly. The second parameter must be provided when the first parameter is a string");return b.isFeatureFlagActive(c,d)}return b.isFeatureFlagActive(c)},[a]),d=(0,_react.useCallback)(c=>{let{visitorCode:d,featureKey:e,track:f}=c;return b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getVariation({visitorCode:d,featureKey:e,track:f})},[a]),e=(0,_react.useCallback)(c=>{let{visitorCode:d,onlyActive:e,track:f}=c;return b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getVariations({visitorCode:d,onlyActive:e,track:f})},[a]),f=(0,_react.useCallback)((c,d)=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getFeatureFlagVariationKey(c,d)),[a]),g=(0,_react.useCallback)(c=>{let{visitorCode:d,featureKey:e,variableKey:f}=c;return b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getFeatureFlagVariable({visitorCode:d,featureKey:e,variableKey:f})},[a]),h=(0,_react.useCallback)(c=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getVisitorFeatureFlags(c)),[a]),i=(0,_react.useCallback)(c=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getActiveFeatureFlags(c)),[a]),j=(0,_react.useCallback)(()=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getFeatureFlags()),[a]),k=(0,_react.useCallback)((c,d)=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getFeatureFlagVariables(c,d)),[a]),l=(0,_react.useCallback)(c=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getEngineTrackingCode(c)),[a]),m=(0,_react.useCallback)(c=>{let{visitorCode:d,experimentId:e,variationKey:f,forceTargeting:g}=c;return b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.setForcedVariation({visitorCode:d,experimentId:e,variationKey:f,forceTargeting:g})},[a]);return{getActiveFeatureFlags:i,getVariation:d,getVariations:e,getFeatureFlags:j,isFeatureFlagActive:c,getEngineTrackingCode:l,getVisitorFeatureFlags:h,getFeatureFlagVariable:g,getFeatureFlagVariables:k,getFeatureFlagVariationKey:f,setForcedVariation:m}}
+"use strict";"use client";Object.defineProperty(exports,"__esModule",{value:!0}),exports.useFeatureFlag=useFeatureFlag;var _react=require("react"),_useKameleoonContext=require("./useKameleoonContext");function useFeatureFlag(){const a=(0,_useKameleoonContext.useKameleoonContext)();let b=a?a.kameleoonClient:null;const c=(0,_react.useCallback)((c,d)=>{if(b=(0,_useKameleoonContext.fetchClientFromContext)(a),"string"==typeof c){if(!d)throw new Error("[Kameleoon React SDK Error]: Overload is not used correctly. The second parameter must be provided when the first parameter is a string");return b.isFeatureFlagActive(c,d)}return b.isFeatureFlagActive(c)},[a]),d=(0,_react.useCallback)(c=>{let{visitorCode:d,featureKey:e,track:f}=c;return b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getVariation({visitorCode:d,featureKey:e,track:f})},[a]),e=(0,_react.useCallback)(c=>{let{visitorCode:d,onlyActive:e,track:f}=c;return b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getVariations({visitorCode:d,onlyActive:e,track:f})},[a]),f=(0,_react.useCallback)((c,d)=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getFeatureFlagVariationKey(c,d)),[a]),g=(0,_react.useCallback)(c=>{let{visitorCode:d,featureKey:e,variableKey:f}=c;return b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getFeatureFlagVariable({visitorCode:d,featureKey:e,variableKey:f})},[a]),h=(0,_react.useCallback)(c=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getVisitorFeatureFlags(c)),[a]),i=(0,_react.useCallback)(c=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getActiveFeatureFlags(c)),[a]),j=(0,_react.useCallback)(()=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getFeatureFlags()),[a]),k=(0,_react.useCallback)((c,d)=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getFeatureFlagVariables(c,d)),[a]),l=(0,_react.useCallback)(c=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.getEngineTrackingCode(c)),[a]),m=(0,_react.useCallback)(c=>{let{visitorCode:d,experimentId:e,variationKey:f,forceTargeting:g}=c;return b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.setForcedVariation({visitorCode:d,experimentId:e,variationKey:f,forceTargeting:g})},[a]),n=(0,_react.useCallback)(c=>(b=(0,_useKameleoonContext.fetchClientFromContext)(a),b.evaluateAudiences(c)),[a]);return{getActiveFeatureFlags:i,getVariation:d,getVariations:e,getFeatureFlags:j,isFeatureFlagActive:c,getEngineTrackingCode:l,getVisitorFeatureFlags:h,getFeatureFlagVariable:g,getFeatureFlagVariables:k,getFeatureFlagVariationKey:f,setForcedVariation:m,evaluateAudiences:n}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kameleoon/react-sdk",
-  "version": "10.13.0",
+  "version": "10.14.0",
   "description": "Kameleoon React SDK",
   "files": [
     "dist"
@@ -40,7 +40,7 @@
   ],
   "license": "ISC",
   "dependencies": {
-    "@kameleoon/javascript-sdk": "4.12.0"
+    "@kameleoon/javascript-sdk": "4.13.0"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0"