@kameleoon/react-sdk 10.5.0 → 10.6.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Change Log
 
+## 10.6.1 (2025-03-05)
+
+### Patch Changes
+
+- Resolved all circular dependencies to improve stability.
+- Updated dependencies
+  - @kameleoon/javascript-sdk@4.6.1
+
+## 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

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.5.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.1",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.5.0",
+  "version": "10.6.1",
   "description": "Kameleoon React SDK",
   "files": [
     "dist"
@@ -24,7 +24,8 @@
     "test:dev": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "lint": "eslint -c ../../eslint.config.js 'dist/**/*.js'"
+    "lint": "eslint -c ../../eslint.config.js 'dist/**/*.js'",
+    "madge": "madge -c ./dist"
   },
   "homepage": "https://developers.kameleoon.com/react-js-sdk.html",
   "publishConfig": {
@@ -39,7 +40,7 @@
   ],
   "license": "ISC",
   "dependencies": {
-    "@kameleoon/javascript-sdk": "4.5.0"
+    "@kameleoon/javascript-sdk": "4.6.1"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0"