fix!: Allow ConfigCat provider to be used in server applications (#796)

Signed-off-by: Adam Simon <adam@configcat.com>
Co-authored-by: Adam Simon <adam@configcat.com>

Author: adams85

libs/providers/config-cat/README.md

@@ -14,20 +14,21 @@ The OpenFeature SDK is required as peer dependency.
 
 The minimum required version of `@openfeature/server-sdk` currently is `1.6.0`.
 
-The minimum required version of `configcat-js` currently is `8.0.0`.
+The minimum required version of `configcat-js-ssr` currently is `7.1.2`.
 
 ```
-$ npm install @openfeature/server-sdk configcat-js
+$ npm install @openfeature/server-sdk configcat-js-ssr
 ```
 
 ## Usage
 
-The ConfigCat provider uses the [ConfigCat Javascript SDK](https://configcat.com/docs/sdk-reference/js/).
+The ConfigCat provider uses the [ConfigCat JavaScript (SSR) SDK](https://configcat.com/docs/sdk-reference/js-ssr/).
+This means that the provider can be used in both server (e.g. Node.js) and client (browser) applications.
 
 It can either be created by passing the ConfigCat SDK options to ```ConfigCatProvider.create``` or
 the ```ConfigCatProvider``` constructor.
 
-The available options can be found in the [ConfigCat Javascript SDK docs](https://configcat.com/docs/sdk-reference/js/).
+The available options can be found in the [ConfigCat JavaScript (SSR) SDK](https://configcat.com/docs/sdk-reference/js-ssr/).
 
 ### Example using the default configuration
 
@@ -53,7 +54,7 @@ OpenFeature.setProvider(provider);
 ## Evaluation Context
 
 ConfigCat only supports string values in its "evaluation
-context", [there known as user](https://configcat.com/docs/advanced/user-object/).
+context", [there known as User Object](https://configcat.com/docs/advanced/user-object/).
 
 This means that every value is converted to a string. This is trivial for numbers and booleans. Objects and arrays are
 converted to JSON strings that can be interpreted in ConfigCat.

libs/providers/config-cat/package.json

@@ -7,6 +7,6 @@
   },
   "peerDependencies": {
     "@openfeature/server-sdk": "^1.8.0",
-    "configcat-js": "^8.0.0 || ^9.0.0"
+    "configcat-js-ssr": ">=7.1.2"
   }
 }

libs/providers/config-cat/src/lib/config-cat-provider.spec.ts

@@ -9,7 +9,7 @@ import {
   LogLevel,
   OverrideBehaviour,
   PollingMode,
-} from 'configcat-js';
+} from 'configcat-js-ssr';
 
 import { IEventEmitter } from 'configcat-common/lib/EventEmitter';
 

libs/providers/config-cat/src/lib/config-cat-provider.ts

@@ -12,7 +12,7 @@ import {
   StandardResolutionReasons,
   TypeMismatchError,
 } from '@openfeature/server-sdk';
-import { getClient, IConfig, IConfigCatClient, IEvaluationDetails, SettingValue } from 'configcat-js';
+import { getClient, IConfig, IConfigCatClient, IEvaluationDetails, SettingValue } from 'configcat-js-ssr';
 import { transformContext } from './context-transformer';
 
 export class ConfigCatProvider implements Provider {
@@ -99,7 +99,7 @@ export class ConfigCatProvider implements Provider {
     const { value, ...evaluationData } = await this._client.getValueDetailsAsync<SettingValue>(
       flagKey,
       undefined,
-      transformContext(context),
+      context.targetingKey != null ? transformContext(context) : undefined,
     );
 
     const validatedValue = validateFlagType('boolean', value);
@@ -121,7 +121,7 @@ export class ConfigCatProvider implements Provider {
     const { value, ...evaluationData } = await this._client.getValueDetailsAsync<SettingValue>(
       flagKey,
       undefined,
-      transformContext(context),
+      context.targetingKey != null ? transformContext(context) : undefined,
     );
 
     const validatedValue = validateFlagType('string', value);
@@ -143,7 +143,7 @@ export class ConfigCatProvider implements Provider {
     const { value, ...evaluationData } = await this._client.getValueDetailsAsync<SettingValue>(
       flagKey,
       undefined,
-      transformContext(context),
+      context.targetingKey != null ? transformContext(context) : undefined,
     );
 
     const validatedValue = validateFlagType('number', value);
@@ -165,7 +165,7 @@ export class ConfigCatProvider implements Provider {
     const { value, ...evaluationData } = await this._client.getValueDetailsAsync(
       flagKey,
       undefined,
-      transformContext(context),
+      context.targetingKey != null ? transformContext(context) : undefined,
     );
 
     if (typeof value === 'undefined') {

libs/providers/config-cat/src/lib/context-transformer.ts

@@ -1,5 +1,5 @@
 import { EvaluationContext, EvaluationContextValue, TargetingKeyMissingError } from '@openfeature/server-sdk';
-import { User as ConfigCatUser } from 'configcat-js';
+import { User as ConfigCatUser } from 'configcat-js-ssr';
 
 function contextValueToString(contextValue: EvaluationContextValue): string | undefined {
   if (typeof contextValue === 'string') {

package-lock.json

@@ -24,7 +24,7 @@
     "@swc/helpers": "0.5.3",
     "ajv": "^8.12.0",
     "axios": "1.6.7",
-    "configcat-js": "^9.0.0",
+    "configcat-js-ssr": "^8.3.0",
     "copy-anything": "^3.0.5",
     "imurmurhash": "^0.1.4",
     "json-logic-engine": "1.3.1",