Merge branch 'main' into feat-goff-inprocess

Signed-off-by: Thomas Poignant <[email protected]>

Author: thomaspoignant

.github/workflows/ci.yml

@@ -31,9 +31,9 @@ jobs:
       - run: git branch --track main origin/main || true
 
       - run: if ! npx nx format:check ; then echo "Format check failed. Please run 'npx nx format:write'."; fi
-      - run: npx nx affected --target=lint --parallel=3 --exclude=js-sdk-contrib
-      - run: npx nx affected --target=test --parallel=3 --ci --code-coverage --exclude=js-sdk-contrib
-      - run: npx nx affected --target=build --parallel=3 --exclude=js-sdk-contrib
+      - run: npx nx affected --base=origin/main --target=lint --parallel=3 --exclude=js-sdk-contrib
+      - run: npx nx affected --base=origin/main --target=test --parallel=3 --ci --code-coverage --exclude=js-sdk-contrib
+      - run: npx nx affected --base=origin/main --target=build --parallel=3 --exclude=js-sdk-contrib
 
   e2e:
       runs-on: ubuntu-latest
@@ -45,7 +45,7 @@ jobs:
             submodules: recursive
         - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
           with:
-            node-version: 20
+            node-version-file: '.nvmrc'
             cache: 'npm'
 
         - name: Install

.github/workflows/release-please.yml

@@ -32,7 +32,7 @@ jobs:
         uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
         if: ${{ steps.release.outputs.releases_created }}
         with:
-          node-version: 20
+          node-version-file: '.nvmrc'
           registry-url: "https://registry.npmjs.org"
       - name: Build Packages
         if: ${{ steps.release.outputs.releases_created }}

.nvmrc

@@ -1 +1 @@
-20
+24

.release-please-manifest.json

@@ -1,25 +1,27 @@
 {
-  "libs/hooks/open-telemetry": "0.4.0",
-  "libs/providers/go-feature-flag": "0.7.8",
+  "libs/hooks/open-telemetry": "1.0.0",
+  "libs/providers/go-feature-flag": "0.7.9",
   "libs/providers/flagd": "0.13.3",
   "libs/providers/flagd-web": "0.7.3",
   "libs/providers/env-var": "0.3.1",
-  "libs/providers/config-cat": "0.7.6",
-  "libs/providers/launchdarkly-client": "0.3.2",
+  "libs/providers/config-cat": "0.8.0",
+  "libs/providers/launchdarkly-client": "0.3.3",
   "libs/providers/go-feature-flag-web": "0.2.6",
   "libs/shared/flagd-core": "1.1.0",
-  "libs/shared/ofrep-core": "1.0.1",
+  "libs/shared/ofrep-core": "1.1.0",
   "libs/providers/ofrep": "0.2.1",
   "libs/providers/ofrep-web": "0.3.3",
   "libs/providers/flipt": "0.1.3",
   "libs/providers/flagsmith-client": "0.1.3",
   "libs/providers/flipt-web": "0.1.5",
-  "libs/providers/multi-provider": "0.1.2",
-  "libs/providers/multi-provider-web": "0.0.3",
+  "libs/providers/multi-provider": "0.1.3",
+  "libs/providers/multi-provider-web": "0.0.4",
   "libs/providers/growthbook-client": "0.1.2",
-  "libs/providers/config-cat-web": "0.1.6",
-  "libs/shared/config-cat-core": "0.1.1",
+  "libs/providers/config-cat-web": "0.2.0",
+  "libs/shared/config-cat-core": "0.2.2",
   "libs/providers/unleash-web": "0.1.1",
   "libs/providers/growthbook": "0.1.2",
-  "libs/providers/aws-ssm": "0.1.3"
+  "libs/providers/aws-ssm": "0.1.3",
+  "libs/providers/flagsmith": "0.1.2",
+  "libs/hooks/debounce": "0.1.1"
 }

CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 ## System Requirements
 
-node 16+, npm 8+ are recommended.
+node 24+, npm 8+ are recommended.
 
 ## Compilation target(s)
 

libs/hooks/debounce/.eslintrc.json

@@ -0,0 +1,30 @@
+{
+  "extends": "../../../.eslintrc.json",
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.json"],
+      "parser": "jsonc-eslint-parser",
+      "rules": {
+        "@nx/dependency-checks": [
+          "error",
+          {
+            "ignoredFiles": ["{projectRoot}/eslint.config.{js,cjs,mjs}"]
+          }
+        ]
+      }
+    }
+  ]
+}

libs/hooks/debounce/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## [0.1.1](https://github.com/open-feature/js-sdk-contrib/compare/debounce-hook-v0.1.0...debounce-hook-v0.1.1) (2025-10-13)
+
+
+### ✨ New Features
+
+* add debounce hook ([#1389](https://github.com/open-feature/js-sdk-contrib/issues/1389)) ([c3c18be](https://github.com/open-feature/js-sdk-contrib/commit/c3c18bec7c7c0e767da7bda63b0356eafcf3d676))

libs/hooks/debounce/README.md

@@ -0,0 +1,58 @@
+# Debounce Hook
+
+This is a utility "meta" hook, which can be used to effectively debounce or rate limit other hooks based on various parameters.
+This can be especially useful for certain UI frameworks and SDKs that frequently re-render and re-evaluate flags (React, Angular, etc).
+
+## Installation
+
+```
+$ npm install @openfeature/debounce-hook
+```
+
+### Peer dependencies
+
+This package only requires the `@openfeature/core` dependency, which is installed automatically no matter which OpenFeature JavaScript SDK you are using.
+
+## Usage
+
+Simply wrap your hook with the debounce hook by passing it as a constructor arg, and then configure the remaining options.
+In the example below, we wrap a logging hook.
+This debounces all its stages, so it only logs a maximum of once a minute for each flag key, no matter how many times that flag is evaluated.
+
+```ts
+const debounceHook = new DebounceHook(loggingHook, {
+  debounceTime: 60_000,             // how long to wait before the hook can fire again
+  maxCacheItems: 100,               // max amount of items to keep in the cache; if exceeded, the oldest item is dropped
+});
+
+// add the hook globally
+OpenFeature.addHooks(debounceHook);
+
+// or at a specific client
+client.addHooks(debounceHook);
+```
+
+The hook maintains a simple expiring cache with a fixed max size and keeps a record of recent evaluations based on an optional key-generation function (cacheKeySupplier).
+Be default, the key-generation function is purely based on the flag key.
+Particularly in server use-cases, you may want to take the targetingKey or other contextual information into account in your debouncing.
+Below we see an example using this, as well as other advanced options:
+
+```ts
+const debounceHook = new DebounceHook<string>(loggingHook, {
+  cacheKeySupplier: (flagKey, context) => flagKey + context.targetingKey, // cache on a combination of user and flag key
+  debounceTime: 60_000, // debounce for 60 seconds (per user due to our cacheKeySupplier above)
+  maxCacheItems: 1000,  // cache a maximum of 1000 records
+  cacheErrors: false,   // don't debounce errors; always re-run if the last run threw 
+  logger: console,      // optional logger
+});
+```
+
+## Development
+
+### Building
+
+Run `nx package hooks-debounce` to build the library.
+
+### Running unit tests
+
+Run `nx test hooks-debounce` to execute the unit tests via [Jest](https://jestjs.io).

libs/hooks/debounce/babel.config.json

@@ -0,0 +1,3 @@
+{
+  "presets": [["minify", { "builtIns": false }]]
+}

libs/hooks/debounce/jest.config.ts

@@ -0,0 +1,9 @@
+export default {
+  displayName: 'debounce',
+  preset: '../../../jest.preset.js',
+  transform: {
+    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.spec.json' }],
+  },
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  coverageDirectory: '../coverage/hooks',
+};