vwo-fme-node-sdk 1.40.0 → 1.41.0

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.41.0] - 2026-03-18
+
+### Added
+
+- Added support for custom bucketing seed via `bucketingSeed` in the context. This allows users to bucket by a shared identifier instead of the individual user ID, ensuring all users within the same group receive the same variation.
+
+  Example usage:
+
+  ```javascript
+  const vwoClient = await init({
+    accountId: '123456',
+    sdkKey: '32-alpha-numeric-sdk-key',
+  });
+
+  // All employees of company-abc will get the same variation
+  const context = {
+    id: 'employee-123',
+    bucketingSeed: 'company-abc',
+  };
+  const flag = await vwoClient.getFlag('feature-key', context);
+  ```
+
+## [1.40.1] - 2026-03-02
+
+### Changed
+
+- Introduced `SDKMetaUtil` and `sdkMeta` config to allow overriding the default SDK name and version used in events. VWO FE React SDK will consume via it.
+
 ## [1.40.0] - 2026-02-26
 
 ### Added

package/README.md

@@ -116,6 +116,7 @@ The following table explains all the parameters in the `context` object:
 | `customVariables` | Custom attributes for targeting.                                           | No           | Object   | `{ age: 25, location: 'US' }`     |
 | `userAgent`       | User agent string for identifying the user's browser and operating system. | No           | String   | `'Mozilla/5.0 ... Safari/537.36'` |
 | `ipAddress`       | IP address of the user.                                                    | No           | String   | `'1.1.1.1'`                       |
+| `bucketingSeed`   | Custom string used for bucketing instead of user `id`. See [Custom Bucketing Seed](#custom-bucketing-seed). | No | String | `'company-abc'` |
 
 #### Example
 
@@ -316,6 +317,25 @@ Behavior and validations:
 - For context usage, `context.id` must be a non-empty string (not an array); it is trimmed before use
 - `userId` and `aliasId` cannot be the same
 
+### Custom Bucketing Seed
+
+By default, the SDK uses the user `id` to determine which variation a user receives. The `bucketingSeed` option in the context lets you override this with a shared identifier (e.g., a company ID), so all users sharing the same seed are bucketed into the same variation.
+
+| **Parameter**   | **Description**                                         | **Required** | **Type** | **Example**     |
+| --------------- | ------------------------------------------------------- | ------------ | -------- | --------------- |
+| `bucketingSeed` | A custom string used for bucketing instead of user `id` | No           | String   | `'company-abc'` |
+
+#### Example Usage
+
+```javascript
+// All employees of company-abc will get the same variation
+const context = {
+  id: 'employee-123',
+  bucketingSeed: 'company-abc',
+};
+const flag = await vwoClient.getFlag('feature-key', context);
+```
+
 ### Storage
 
 The SDK operates in a stateless mode by default, meaning each `getFlag` call triggers a fresh evaluation of the flag against the current user context.

package/dist/VERSION.js

@@ -1 +1 @@
-module.exports = { version: "1.40.0" };
+module.exports = { version: "1.41.0" };