@contentful/optimization-node 2.1.1 → 2.2.0

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://www.contentful.com/developers/docs/personalization/">
-    <img alt="Contentful Logo" title="Contentful" src="https://raw.githubusercontent.com/contentful/optimization/optimization-node-v2.1.1/contentful-icon.png" width="150">
+    <img alt="Contentful Logo" title="Contentful" src="https://raw.githubusercontent.com/contentful/optimization/optimization-node-v2.2.0/contentful-icon.png" width="150">
   </a>
 </p>
 
@@ -11,12 +11,12 @@
 <div align="center">
 
 [Guides](https://contentful.github.io/optimization/documents/Documentation.Guides.html) ·
-[Reference](https://contentful.github.io/optimization) · [Contributing](https://github.com/contentful/optimization/blob/optimization-node-v2.1.1/CONTRIBUTING.md)
+[Reference](https://contentful.github.io/optimization) · [Contributing](https://github.com/contentful/optimization/blob/optimization-node-v2.2.0/CONTRIBUTING.md)
 
 </div>
 
 The Optimization Node SDK implements stateless server-side optimization behavior on top of the
-[Optimization Core SDK](https://github.com/contentful/optimization/blob/optimization-node-v2.1.1/packages/universal/core-sdk/README.md). Use it for server rendering, server
+[Optimization Core SDK](https://github.com/contentful/optimization/blob/optimization-node-v2.2.0/packages/universal/core-sdk/README.md). Use it for server rendering, server
 functions, and Node services that need request-scoped profile evaluation or event emission.
 
 If you are integrating a Node application, start with [Getting Started](#getting-started), then use
@@ -110,7 +110,7 @@ are part of the same application.
 
 The Node SDK is stateless. It does not maintain consent, profile, or browser persistence state
 between requests. For cross-SDK consent guidance, see
-[Consent management in the Optimization SDK Suite](https://github.com/contentful/optimization/blob/optimization-node-v2.1.1/documentation/concepts/consent-management-in-the-optimization-sdk-suite.md).
+[Consent management in the Optimization SDK Suite](https://github.com/contentful/optimization/blob/optimization-node-v2.2.0/documentation/concepts/consent-management-in-the-optimization-sdk-suite.md).
 
 | Option              | Required? | Default                | Description                                                                     |
 | ------------------- | --------- | ---------------------- | ------------------------------------------------------------------------------- |
@@ -250,6 +250,27 @@ In stateless runtimes, Insights-backed methods require a request-bound profile f
 Non-sticky `trackView`, `trackClick`, `trackHover`, and `trackFlagView` require a profile ID passed
 to `forRequest()`.
 
+For custom integrations that need an event payload before submission, use the request client's
+`eventBuilder`. It exposes `buildIdentify`, `buildPageView`, `buildScreenView`, and `buildTrack`
+with request event context and locale defaults. In this example, `appConsent`, `appLocale`,
+`appUserAgent`, and `appUserId` come from your application's request and identity handling:
+
+```ts
+const requestOptimization = optimization.forRequest({
+  consent: appConsent,
+  locale: appLocale,
+  eventContext: { userAgent: appUserAgent },
+})
+const identifyEvent = requestOptimization.eventBuilder.buildIdentify({ userId: appUserId })
+```
+
+Construction does not send the event, check request consent, invoke interceptors, or update the
+request profile or selections. Built events use the shared builder's `context.gdpr.isConsentGiven`,
+which is `false` in the Node SDK, even when request consent is granted. Sending `identifyEvent` through a
+low-level API does not automatically apply request consent or SDK submission processing. For normal
+submission, use request-bound `identify()`, `page()`, `screen()`, or `track()`. The singleton's
+`optimization.eventBuilder` remains unbound to any request.
+
 ### Content resolution
 
 When a `contentful.js` client is available, prefer SDK-managed fetching by entry ID or content type
@@ -345,9 +366,9 @@ package directory.
   step-by-step server-side integration guide
 - [Node SDK generated reference](https://contentful.github.io/optimization/modules/_contentful_optimization-node.html) -
   exported API reference
-- [Node reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v2.1.1/implementations/node-sdk/README.md) - server-rendered
+- [Node reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v2.2.0/implementations/node-sdk/README.md) - server-rendered
   implementation using request-scoped SDK calls
-- [Node + Web reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v2.1.1/implementations/node-sdk+web-sdk/README.md) -
+- [Node + Web reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v2.2.0/implementations/node-sdk+web-sdk/README.md) -
   hybrid SSR and browser implementation
-- [Optimization Web SDK](https://github.com/contentful/optimization/blob/optimization-node-v2.1.1/packages/web/web-sdk/README.md) - browser SDK used when the same application
+- [Optimization Web SDK](https://github.com/contentful/optimization/blob/optimization-node-v2.2.0/packages/web/web-sdk/README.md) - browser SDK used when the same application
   also needs client-side consent, persistence, tracking, or live updates

package/THIRD_PARTY_NOTICES.txt

@@ -625,16 +625,57 @@ SOFTWARE.
 
 ---
 
-The following software may be included in this product: es-toolkit (1.46.0)
+The following software may be included in this product: es-toolkit (1.53.0)
 This software contains the following license and notice below:
 
-MIT License
+NOTICE:
+
+es-toolkit
+
+Parts of the test suite and compatibility layer in es-toolkit/compat are
+derived from Lodash (https://github.com/lodash/lodash).
+
+Lodash copyright notice and MIT permission notice:
+
+Copyright OpenJS Foundation and other contributors <https://openjsf.org/>
+
+Based on Underscore.js, copyright Jeremy Ashkenas,
+DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/lodash/lodash
+
+The following license applies to all parts of this software except as
+documented below:
 
-Copyright (c) 2024 Viva Republica, Inc
+====
 
-Copyright OpenJS Foundation and other contributors
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+LICENSE:
+
+
+MIT License
 
-Parts of the test suite and compatibility layer in `es-toolkit/compat` are derived from Lodash (https://github.com/lodash/lodash) by the OpenJS Foundation (https://openjsf.org/) and Underscore.js by Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors (http://underscorejs.org/)
+Copyright (c) 2024 Viva Republica, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -1424,7 +1465,7 @@ SOFTWARE.
 
 ---
 
-The following software may be included in this product: zod (4.3.6)
+The following software may be included in this product: zod (4.6.7)
 This software contains the following license and notice below:
 
 MIT License

package/dist/constants.cjs

@@ -34,7 +34,7 @@ __webpack_require__.d(__webpack_exports__, {
     OPTIMIZATION_NODE_SDK_VERSION: ()=>OPTIMIZATION_NODE_SDK_VERSION
 });
 const constants_namespaceObject = require("@contentful/optimization-core/constants");
-const OPTIMIZATION_NODE_SDK_VERSION = "2.1.1";
+const OPTIMIZATION_NODE_SDK_VERSION = "2.2.0";
 const OPTIMIZATION_NODE_SDK_NAME = "@contentful/optimization-node";
 exports.ANONYMOUS_ID_COOKIE = __webpack_exports__.ANONYMOUS_ID_COOKIE;
 exports.ANONYMOUS_ID_KEY = __webpack_exports__.ANONYMOUS_ID_KEY;

package/dist/constants.mjs

@@ -1,4 +1,4 @@
-const OPTIMIZATION_NODE_SDK_VERSION = "2.1.1";
+const OPTIMIZATION_NODE_SDK_VERSION = "2.2.0";
 const OPTIMIZATION_NODE_SDK_NAME = "@contentful/optimization-node";
 export { ANONYMOUS_ID_COOKIE, ANONYMOUS_ID_KEY } from "@contentful/optimization-core/constants";
 export { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION };

package/dist/index.cjs

@@ -6,7 +6,7 @@ var __webpack_modules__ = {
             OPTIMIZATION_NODE_SDK_VERSION: ()=>OPTIMIZATION_NODE_SDK_VERSION
         });
         require("@contentful/optimization-core/constants");
-        const OPTIMIZATION_NODE_SDK_VERSION = "2.1.1";
+        const OPTIMIZATION_NODE_SDK_VERSION = "2.2.0";
         const OPTIMIZATION_NODE_SDK_NAME = "@contentful/optimization-node";
     }
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contentful/optimization-node",
   "description": "Node.js SDK for Contentful Optimization",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -88,7 +88,7 @@
     }
   },
   "dependencies": {
-    "@contentful/optimization-core": "2.1.1"
+    "@contentful/optimization-core": "2.2.0"
   },
   "devDependencies": {
     "@contentful/rich-text-html-renderer": "^17.1.6",