@contentful/optimization-node 2.0.2 → 2.1.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.0.2/contentful-icon.png" width="150">
+    <img alt="Contentful Logo" title="Contentful" src="https://raw.githubusercontent.com/contentful/optimization/optimization-node-v2.1.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.0.2/CONTRIBUTING.md)
+[Reference](https://contentful.github.io/optimization) · [Contributing](https://github.com/contentful/optimization/blob/optimization-node-v2.1.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.0.2/packages/universal/core-sdk/README.md). Use it for server rendering, server
+[Optimization Core SDK](https://github.com/contentful/optimization/blob/optimization-node-v2.1.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.0.2/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.1.0/documentation/concepts/consent-management-in-the-optimization-sdk-suite.md).
 
 | Option              | Required? | Default                | Description                                                                     |
 | ------------------- | --------- | ---------------------- | ------------------------------------------------------------------------------- |
@@ -127,21 +127,45 @@ between requests. For cross-SDK consent guidance, see
 
 Common `api` options:
 
-| Option              | Required? | Default                                    | Description                                      |
-| ------------------- | --------- | ------------------------------------------ | ------------------------------------------------ |
-| `experienceBaseUrl` | No        | `'https://experience.ninetailed.co/'`      | Base URL for the Experience API                  |
-| `insightsBaseUrl`   | No        | `'https://ingest.insights.ninetailed.co/'` | Base URL for the Insights API                    |
-| `enabledFeatures`   | No        | `['ip-enrichment', 'location']`            | Experience API features to apply to each request |
+| Option              | Required? | Default                                    | Description                                                  |
+| ------------------- | --------- | ------------------------------------------ | ------------------------------------------------------------ |
+| `experienceBaseUrl` | No        | `'https://experience.ninetailed.co/'`      | Base URL for the Experience API                              |
+| `insightsBaseUrl`   | No        | `'https://ingest.insights.ninetailed.co/'` | Base URL for the Insights API                                |
+| `enabledFeatures`   | No        | `['ip-enrichment', 'location']`            | Experience API features to apply to each request             |
+| `location`          | No        | API fallback                               | Default location for single-profile Experience API mutations |
 
 Request-scoped Experience options belong in `experienceOptions` when creating the request-bound
 client:
 
-| Option      | Description                                                   |
-| ----------- | ------------------------------------------------------------- |
-| `ip`        | IP address override used by the Experience API                |
-| `locale`    | Locale query parameter for localized Experience API responses |
-| `plainText` | Sends performance-critical Experience API endpoints as text   |
-| `preflight` | Aggregates a new profile state without storing it             |
+| Option      | Description                                                    |
+| ----------- | -------------------------------------------------------------- |
+| `ip`        | IP address override used by the Experience API                 |
+| `location`  | Request location replacing the complete `api.location` default |
+| `locale`    | Locale query parameter for localized Experience API responses  |
+| `plainText` | Sends performance-critical Experience API endpoints as text    |
+| `preflight` | Aggregates a new profile state without storing it              |
+
+Configure a shared default with `api.location`, then override it per incoming request with
+`experienceOptions.location`:
+
+```ts
+const optimization = new ContentfulOptimization({
+  spaceId: 'your-space-id',
+  api: { location: { countryCode: 'DE', city: 'Berlin' } },
+})
+const requestOptimization = optimization.forRequest({
+  consent: true,
+  experienceOptions: { location: { countryCode: 'FR', city: 'Paris' } },
+})
+await requestOptimization.page()
+```
+
+The request value replaces the whole default object; it does not merge fields. Pass
+`experienceOptions: { location: {} }` to replace the configured default with an explicit empty
+location instead of API geolocation. Event `context.location` takes precedence over matching
+request fields. An empty location does not clear an existing profile location, and request location
+does not lock location across later requests. See
+[Location inputs and profile updates](https://contentful.github.io/optimization/documents/Documentation.Concepts.Profile_synchronization_between_client_and_server.html#location-inputs-and-profile-updates).
 
 Request-scoped Insights options belong in `insightsOptions`:
 
@@ -321,9 +345,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.0.2/implementations/node-sdk/README.md) - server-rendered
+- [Node reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v2.1.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.0.2/implementations/node-sdk+web-sdk/README.md) -
+- [Node + Web reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v2.1.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.0.2/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.1.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/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.0.2";
+const OPTIMIZATION_NODE_SDK_VERSION = "2.1.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.0.2";
+const OPTIMIZATION_NODE_SDK_VERSION = "2.1.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.0.2";
+        const OPTIMIZATION_NODE_SDK_VERSION = "2.1.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.0.2",
+  "version": "2.1.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -88,7 +88,7 @@
     }
   },
   "dependencies": {
-    "@contentful/optimization-core": "2.0.2"
+    "@contentful/optimization-core": "2.1.0"
   },
   "devDependencies": {
     "@contentful/rich-text-html-renderer": "^17.1.6",