Update minimum Node.js version to 20.x

.gitattributes

@@ -1 +1,2 @@
 *.json  linguist-language=JSON-with-Comments
+docs/*.md text eol=lf

.github/workflows/lint-test-sdk.yml

@@ -25,7 +25,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [ '18', '20', '22', '23' ]
+        node-version: [ '20', '22', '24' ]
     steps:
       - uses: actions/checkout@v3
         with:
@@ -62,7 +62,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [ '18', '20', '22', '23' ]
+        node-version: [ '20', '22', '24' ]
     steps:
       - uses: actions/checkout@v3
         with:

.github/workflows/publish.yml

@@ -10,7 +10,7 @@ jobs:
       fail-fast: false
       matrix:
         platform: ['linux']
-        node-version: [ '18', '20', '22', '23' ]
+        node-version: [ '20', '22', '24' ]
     steps:
       - uses: actions/checkout@v3
 

README.md

@@ -8,10 +8,17 @@
 
 - Feature gates
 - Kill switches
+- Dynamic configuration
 - Progressive rollouts
 - A/B/n experiments
+- Holdouts
 - Mutually exclusive experiments (Layers)
-- Dynamic configuration
+- Switchback experiments
+- Contextual Multi-armed bandits
+
+## Requirements
+
+- Node.js version 20.x or later
 
 ## Installation
 

api-extractor.json

@@ -266,7 +266,7 @@
    *
    * DEFAULT VALUE: "crlf"
    */
-  // "newlineKind": "crlf",
+  "newlineKind": "lf",
 
   /**
    * Configures how API Extractor reports error and warning messages produced during analysis.

docs/index.md

@@ -1,30 +1,30 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md)
-
-## API Reference
-
-## Packages
-
-<table><thead><tr><th>
-
-Package
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[@eppo/node-server-sdk](./node-server-sdk.md)
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md)
+
+## API Reference
+
+## Packages
+
+<table><thead><tr><th>
+
+Package
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[@eppo/node-server-sdk](./node-server-sdk.md)
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+

docs/node-server-sdk.getbanditsconfiguration.md

@@ -0,0 +1,19 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [getBanditsConfiguration](./node-server-sdk.getbanditsconfiguration.md)
+
+## getBanditsConfiguration() function
+
+Returns the current bandits configuration as a JSON string. This can be used together with getFlagsConfiguration() to bootstrap another SDK instance using offlineInit().
+
+**Signature:**
+
+```typescript
+export declare function getBanditsConfiguration(): string;
+```
+**Returns:**
+
+string
+
+JSON string containing the bandits configuration
+

docs/node-server-sdk.getflagsconfiguration.md

@@ -0,0 +1,19 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [getFlagsConfiguration](./node-server-sdk.getflagsconfiguration.md)
+
+## getFlagsConfiguration() function
+
+Reconstructs the current flags configuration as a JSON string. This can be used to bootstrap another SDK instance using offlineInit().
+
+**Signature:**
+
+```typescript
+export declare function getFlagsConfiguration(): string | null;
+```
+**Returns:**
+
+string \| null
+
+JSON string containing the flags configuration, or null if not initialized
+

docs/node-server-sdk.getinstance.md

@@ -1,19 +1,19 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [getInstance](./node-server-sdk.getinstance.md)
-
-## getInstance() function
-
-Used to access a singleton SDK client instance. Use the method after calling init() to initialize the client.
-
-**Signature:**
-
-```typescript
-export declare function getInstance(): EppoClient;
-```
-**Returns:**
-
-EppoClient
-
-a singleton client instance or throws an Error if init() has not been called
-
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [getInstance](./node-server-sdk.getinstance.md)
+
+## getInstance() function
+
+Used to access a singleton SDK client instance. Use the method after calling init() to initialize the client.
+
+**Signature:**
+
+```typescript
+export declare function getInstance(): EppoClient;
+```
+**Returns:**
+
+EppoClient
+
+a singleton client instance or throws an Error if init() has not been called
+

docs/node-server-sdk.iclientconfig.apikey.md

@@ -1,13 +1,13 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [apiKey](./node-server-sdk.iclientconfig.apikey.md)
-
-## IClientConfig.apiKey property
-
-Eppo SDK key
-
-**Signature:**
-
-```typescript
-apiKey: string;
-```
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [apiKey](./node-server-sdk.iclientconfig.apikey.md)
+
+## IClientConfig.apiKey property
+
+Eppo SDK key
+
+**Signature:**
+
+```typescript
+apiKey: string;
+```

docs/node-server-sdk.iclientconfig.assignmentlogger.md

@@ -1,13 +1,13 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [assignmentLogger](./node-server-sdk.iclientconfig.assignmentlogger.md)
-
-## IClientConfig.assignmentLogger property
-
-Provide a logging implementation to send variation assignments to your data warehouse.
-
-**Signature:**
-
-```typescript
-assignmentLogger: IAssignmentLogger;
-```
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [assignmentLogger](./node-server-sdk.iclientconfig.assignmentlogger.md)
+
+## IClientConfig.assignmentLogger property
+
+Provide a logging implementation to send variation assignments to your data warehouse.
+
+**Signature:**
+
+```typescript
+assignmentLogger: IAssignmentLogger;
+```

docs/node-server-sdk.iclientconfig.banditlogger.md

@@ -1,13 +1,13 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [banditLogger](./node-server-sdk.iclientconfig.banditlogger.md)
-
-## IClientConfig.banditLogger property
-
-Logging implementation to send bandit actions to your data warehouse
-
-**Signature:**
-
-```typescript
-banditLogger?: IBanditLogger;
-```
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [banditLogger](./node-server-sdk.iclientconfig.banditlogger.md)
+
+## IClientConfig.banditLogger property
+
+Logging implementation to send bandit actions to your data warehouse
+
+**Signature:**
+
+```typescript
+banditLogger?: IBanditLogger;
+```

docs/node-server-sdk.iclientconfig.baseurl.md

@@ -1,13 +1,13 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [baseUrl](./node-server-sdk.iclientconfig.baseurl.md)
-
-## IClientConfig.baseUrl property
-
-Base URL of the Eppo API. Clients should use the default setting in most cases.
-
-**Signature:**
-
-```typescript
-baseUrl?: string;
-```
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [baseUrl](./node-server-sdk.iclientconfig.baseurl.md)
+
+## IClientConfig.baseUrl property
+
+Base URL of the Eppo API. Clients should use the default setting in most cases.
+
+**Signature:**
+
+```typescript
+baseUrl?: string;
+```

docs/node-server-sdk.iclientconfig.eventtracking.md

@@ -1,21 +1,26 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [eventTracking](./node-server-sdk.iclientconfig.eventtracking.md)
-
-## IClientConfig.eventTracking property
-
-Configuration settings for the event dispatcher
-
-**Signature:**
-
-```typescript
-eventTracking?: {
-        batchSize?: number;
-        deliveryIntervalMs?: number;
-        enabled?: boolean;
-        maxQueueSize?: number;
-        maxRetries?: number;
-        maxRetryDelayMs?: number;
-        retryIntervalMs?: number;
-    };
-```
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@eppo/node-server-sdk](./node-server-sdk.md) &gt; [IClientConfig](./node-server-sdk.iclientconfig.md) &gt; [eventTracking](./node-server-sdk.iclientconfig.eventtracking.md)
+
+## IClientConfig.eventTracking property
+
+> Warning: This API is now obsolete.
+> 
+> Eppo has discontinued eventing support. Event tracking will be handled by Datadog SDKs.
+> 
+
+Configuration settings for the event dispatcher.
+
+**Signature:**
+
+```typescript
+eventTracking?: {
+        batchSize?: number;
+        deliveryIntervalMs?: number;
+        enabled?: boolean;
+        maxQueueSize?: number;
+        maxRetries?: number;
+        maxRetryDelayMs?: number;
+        retryIntervalMs?: number;
+    };
+```