Merge pull request #491 from splitio/sdk-configs-baseline

[SDK Configs] Baseline

Author: EmilianoSanchez

.eslintrc

@@ -1,4 +1,5 @@
 {
+  "root": true,
   "extends": [
     "eslint:recommended"
   ],
@@ -46,7 +47,7 @@
   "overrides": [
     {
       "env": {
-        // platform-agnostic code must not reference Node or Browser globals
+        // platform-agnostic code must not reference Node or Browser globals without feature detection
         "node": false,
         "browser": false,
         "es6": true

CHANGES.txt

@@ -1,3 +1,17 @@
+3.0.0 (June 26, 2026)
+ - Extracted SDK lifecycle methods (`init`, `flush`, and `destroy`) into a reusable `sdkLifecycle` module.
+ - Extracted the `track` method into a standalone `trackMethod` factory for reuse across SDKs.
+ - Added a bloom filter utility and platform-specific modules (`src/platform/`) for reuse across SDKs.
+ - Added support for the Configs SDK:
+   - new type declarations,
+   - fallback calculator with sanitizer,
+   - default treatment evaluation (without a target),
+   - new `CONFIGS_UPDATE` metadata type for `SDK_UPDATE` event,
+   - optional `entityType` field in the `/testImpressions/bulk` payload,
+   - input validation for the target object.
+ - Removed the misleading warning log 'No listeners for SDK_READY event detected', since users can use the `whenReady` method to wait for the SDK to be ready.
+ - BREAKING CHANGES: Renamed some types and modules, and updated the signatures of others for clarity and reusability.
+
 2.12.1 (June 25, 2026)
  - Updated internal modules to handle `null` values from `/splitChanges` response.
  - Updated some dependencies for vulnerability fixes.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-commons",
-  "version": "2.12.1",
+  "version": "3.0.0",
   "description": "Split JavaScript SDK common components",
   "main": "cjs/index.js",
   "module": "esm/index.js",
@@ -49,11 +49,19 @@
     "tslib": "^2.3.1"
   },
   "peerDependencies": {
-    "ioredis": "^4.28.0 || ^5.0.0"
+    "bloom-filters": "^3.0.0",
+    "ioredis": "^4.28.0 || ^5.0.0",
+    "node-fetch": "^2.7.0"
   },
   "peerDependenciesMeta": {
+    "bloom-filters": {
+      "optional": true
+    },
     "ioredis": {
       "optional": true
+    },
+    "node-fetch": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -62,6 +70,7 @@
     "@types/lodash": "^4.14.162",
     "@typescript-eslint/eslint-plugin": "^7.18.0",
     "@typescript-eslint/parser": "^7.18.0",
+    "bloom-filters": "^3.0.4",
     "cross-env": "^7.0.2",
     "eslint": "^8.56.0",
     "eslint-plugin-compat": "^6.0.1",

package.json

@@ -0,0 +1,24 @@
+import { IJwtCredentialV3 } from '../../sync/streaming/AuthClient/types';
+
+function toBase64Url(str: string) {
+  return Buffer.from(str).toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '');
+}
+
+export function makeJwtCredential(expInSeconds = 3600): IJwtCredentialV3 {
+  const now = Math.floor(Date.now() / 1000);
+  const header = toBase64Url(JSON.stringify({ alg: 'HS256' }));
+  const decodedToken = { iat: now, exp: now + expInSeconds, 'x-ably-capability': '{"ch":["subscribe"]}' };
+  const payload = toBase64Url(JSON.stringify(decodedToken));
+
+  return {
+    token: `${header}.${payload}.sig`,
+    decodedToken,
+    channels: { ch: ['subscribe'] },
+    config: {
+      streaming: {
+        enabled: true,
+        delay: 60,
+      }
+    }
+  };
+}