@kameleoon/react-sdk 10.4.0 → 10.6.0

package/CHANGELOG.md

@@ -1,6 +1,35 @@
 # Change Log
 
-## 10.4.0 (2025-01-17)
+## 10.6.0 (2025-02-26)
+
+### Features
+
+- Added new parameter `stubMode` to `SDKParameters` for create `KameleoonClient`. This parameter enables a no-operation mode for the client, which is particularly useful for disabling external interactions in controlled environments.
+- Added SDK support for **Mutually Exclusive Groups**. When feature flags are grouped into a **Mutually Exclusive Group**, only one flag in the group will be evaluated at a time. All other flags in the group will automatically return their default variation.
+
+### Patch Changes
+
+- Fixed validation for the [`networkDomain`][configurationParameters] parameter.
+- Updated dependencies
+  - @kameleoon/javascript-sdk@4.6.0
+
+## 10.5.0 (2025-02-10)
+
+### Features
+
+- Added SDK support for **holdout experiments**. Visitors assigned to a holdout experiment are excluded from all other rollouts and experiments, and consistently receive the default variation. For visitors not in a holdout experiment, the standard evaluation process applies, allowing them to be evaluated for all feature flags as usual. Platform-wide release expected in February 2025.
+- Introduced a new `personalization` parameter to [`RemoteVisitorDataFilter`][getRemoteVisitorData]. Default value of the parameter is `false`.
+- The following targeting conditions are now supported:
+  - Exclusive Campaign
+  - Experiment
+  - Personalization
+
+### Patch Changes
+
+- Updated dependencies
+  - @kameleoon/javascript-sdk@4.5.0
+
+## 10.4.0 (2025-01-20)
 
 ### Features
 

package/README.md

@@ -39,6 +39,24 @@ function MyComponentWrapper(): JSX.Element {
 }
 ```
 
+If used in Next.js for server-side rendering, you can set stubMode to disable SDK client initialization on the server.
+
+```tsx
+import { KameleoonProvider, createClient } from '@kameleoon/react-sdk';
+
+const isServer = typeof window === 'undefined';
+
+const client = createClient({ siteCode: 'my_site_code', stubMode: isServer });
+
+function MyComponentWrapper(): JSX.Element {
+  return (
+    <KameleoonProvider client={client}>
+      <MyComponent />
+    </KameleoonProvider>
+  );
+}
+```
+
 ## Usage Example
 
 ```tsx

package/dist/createClient.d.ts

@@ -4,4 +4,4 @@ import { SDKParameters } from './types';
  * Creates an instance of KameleoonClient
  * @param parameters {SDKParameters} - parameters of an SDK
  */
-export declare function createClient({ siteCode, configuration, externals, }: SDKParameters): KameleoonClient;
+export declare function createClient({ siteCode, configuration, externals, stubMode, }: SDKParameters): KameleoonClient;

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}=a;const e=new _javascriptSdk.KameleoonClient({siteCode:b,configuration:c,externals:d,_internals:{packageInfo:{type:_javascriptSdk.SdkLanguageType.REACT,version:"10.4.0",isServer:!1},prng:null===d||void 0===d?void 0:d.prng}});return e}
+"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.6.0",isServer:!1},prng:null===d||void 0===d?void 0:d.prng},stubMode:e});return f}

package/dist/types.d.ts

@@ -9,7 +9,9 @@ export type ExternalsType = CoreExternalsType & {
  * @param {IExternalRequester | undefined} requester - external requester implementation
  * @param {IExternalPRNG | undefined} prng - external PRNG implementation
  * @param {IExternalLogger | undefined} logger - external logger implementation
+ * @param {boolean | undefined} stubMode - When set to true, the client will operate in stub mode and perform no operations. In this mode, all method calls become no-ops, ensuring that no external actions or side effects occur.
  * */
 export type SDKParameters = Omit<CoreSDKParameters, '_internals'> & {
     externals?: ExternalsType;
+    stubMode?: boolean;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kameleoon/react-sdk",
-  "version": "10.4.0",
+  "version": "10.6.0",
   "description": "Kameleoon React SDK",
   "files": [
     "dist"
@@ -39,7 +39,7 @@
   ],
   "license": "ISC",
   "dependencies": {
-    "@kameleoon/javascript-sdk": "4.4.0"
+    "@kameleoon/javascript-sdk": "4.6.0"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0"