npm - @contentful/optimization-node - Versions diffs - 0.1.0-alpha12 → 0.1.0-alpha14 - Mend

@contentful/optimization-node 0.1.0-alpha12 → 0.1.0-alpha14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/README.md CHANGED Viewed

@@ -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/v0.1.0-alpha12/contentful-icon.png" width="150">
+    <img alt="Contentful Logo" title="Contentful" src="https://raw.githubusercontent.com/contentful/optimization/v0.1.0-alpha14/contentful-icon.png" width="150">
   </a>
 </p>
@@ -10,51 +10,43 @@
 <div align="center">
-[Guides](https://contentful.github.io/optimization/documents/Guides.html) ·
-[Reference](https://contentful.github.io/optimization) · [Contributing](https://github.com/contentful/optimization/blob/v0.1.0-alpha12/CONTRIBUTING.md)
+[Guides](https://contentful.github.io/optimization/documents/Documentation.Guides.html) ·
+[Reference](https://contentful.github.io/optimization) · [Contributing](https://github.com/contentful/optimization/blob/v0.1.0-alpha14/CONTRIBUTING.md)
 </div>
 > [!WARNING]
 >
-> The Optimization SDK Suite is pre-release (alpha). Breaking changes may be published at any time.
+> The Optimization SDK Suite is pre-release (alpha). Breaking changes can be published at any time.
-The Optimization Node SDK implements functionality specific to Node environments, based on the
-[Optimization Core Library](https://github.com/contentful/optimization/blob/v0.1.0-alpha12/packages/universal/core-sdk/README.md). This SDK is part of the
-[Contentful Optimization SDK Suite](https://github.com/contentful/optimization/blob/v0.1.0-alpha12/README.md).
+The Optimization Node SDK implements stateless server-side optimization behavior on top of the
+[Optimization Core SDK](https://github.com/contentful/optimization/blob/v0.1.0-alpha14/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
+[Integrating the Optimization Node SDK in a Node app](https://contentful.github.io/optimization/documents/Documentation.Guides.integrating-the-node-sdk-in-a-node-app.html)
+for the step-by-step flow. This README keeps the package orientation and common setup options close
+at hand; generated [reference documentation](https://contentful.github.io/optimization) remains the
+source of truth for exported API signatures.
 <details>
   <summary>Table of Contents</summary>
 <!-- mtoc-start -->
-- [Getting Started](#getting-started)
-- [Reference Implementations](#reference-implementations)
-- [Configuration](#configuration)
-  - [Top-level Configuration Options](#top-level-configuration-options)
-  - [API Options](#api-options)
-  - [Event Builder Options](#event-builder-options)
-  - [Fetch Options](#fetch-options)
-- [Optimization Methods](#optimization-methods)
-  - [Optimization Data Resolution Methods](#optimization-data-resolution-methods)
-    - [`getFlag`](#getflag)
-    - [`resolveOptimizedEntry`](#resolveoptimizedentry)
-    - [`getMergeTagValue`](#getmergetagvalue)
-  - [Experience API and Insights API Event Methods](#experience-api-and-insights-api-event-methods)
-    - [`identify`](#identify)
-    - [`page`](#page)
-    - [`screen`](#screen)
-    - [`track`](#track)
-    - [`trackView`](#trackview)
-    - [`trackClick`](#trackclick)
-    - [`trackHover`](#trackhover)
-    - [`trackFlagView`](#trackflagview)
-- [Interceptors](#interceptors)
-  - [Life-cycle Interceptors](#life-cycle-interceptors)
+- [Getting started](#getting-started)
+- [When to use this package](#when-to-use-this-package)
+- [Common configuration](#common-configuration)
+- [Core workflows](#core-workflows)
+  - [Request-scoped events](#request-scoped-events)
+  - [Content resolution](#content-resolution)
+  - [Caching guidance](#caching-guidance)
+- [Development harness](#development-harness)
+- [Related](#related)
 <!-- mtoc-end -->
 </details>
-## Getting Started
+## Getting started
 Install using an NPM-compatible package manager, pnpm for example:
@@ -68,343 +60,237 @@ Import the Optimization class; both CJS and ESM module systems are supported, ES
 import ContentfulOptimization from '@contentful/optimization-node'
 ```
-Configure and initialize the Optimization Node SDK:
+Create the SDK once per module or process, then bind consent and request context in each route:
 ```ts
-const optimization = new ContentfulOptimization({ clientId: 'abc123' })
-const requestOptions = { locale: 'en-US' }
-await optimization.page({}, requestOptions)
-```
-Create `optimization` once per module or process, then pass request-scoped Experience options as the
-final argument to stateless event methods inside each incoming request.
-## Caching Guidance
-The Node SDK is stateless, but that does not mean all request work is cacheable.
-- Cache raw Contentful delivery payloads in your application layer.
-- Treat cached Contentful entries as immutable.
-- Use `resolveOptimizedEntry()` and `getMergeTagValue()` as request-local helpers when rendering.
-- Do not memoize `page()`, `identify()`, `screen()`, `track()`, `trackView()`, `trackClick()`,
-  `trackHover()`, or `trackFlagView()`. Those methods emit outbound events and/or return profile
-  state for the current request.
-For a step-by-step Express-style walkthrough that covers request context, profile persistence,
-Contentful entry resolution, and hybrid Node + browser setups, see
-[Integrating the Optimization Node SDK in a Node App](https://github.com/contentful/optimization/blob/v0.1.0-alpha12/documentation/integrating-the-node-sdk-in-a-node-app.md).
-## Development Harness
-The package-local dev harness runs from `packages/node/node-sdk/dev/` and reads `.env` from this
-package directory.
-1. Start from `.env.example` and create or update `packages/node/node-sdk/.env`.
-2. Prefer the repo-standard `PUBLIC_...` variable names shown in `.env.example`.
-3. Start the harness from the repo root:
-   ```sh
-   pnpm --filter @contentful/optimization-node dev
-   ```
-## Reference Implementations
-Reference implementations illustrate how the SDK may be used under common scenarios, as well as
-select less-common scenarios, with the most basic example solution possible.
-- [Node SSR Only](https://github.com/contentful/optimization/blob/v0.1.0-alpha12/implementations/node-sdk/README.md): Example application that uses the
-  Node SDK to render an optimized Web page
-- [Node SSR + Web Vanilla](https://github.com/contentful/optimization/blob/v0.1.0-alpha12/implementations/node-sdk+web-sdk/README.md): Example application
-  demonstrating simple profile synchronization between the Node and
-  [Web](https://github.com/contentful/optimization/blob/v0.1.0-alpha12/packages/web/web-sdk/README.md) SDKs via cookie
-## Configuration
-### Top-level Configuration Options
-| Option         | Required? | Default                     | Description                                                                    |
-| -------------- | --------- | --------------------------- | ------------------------------------------------------------------------------ |
-| `api`          | No        | See "API Options"           | Unified configuration for the Experience API and Insights API endpoints        |
-| `app`          | No        | `undefined`                 | The application definition used to attribute events to a specific consumer app |
-| `clientId`     | Yes       | N/A                         | Shared API key for Experience API and Insights API requests                    |
-| `environment`  | No        | `'main'`                    | The environment identifier                                                     |
-| `eventBuilder` | No        | See "Event Builder Options" | Event builder configuration (channel/library metadata, etc.)                   |
-| `fetchOptions` | No        | See "Fetch Options"         | Configuration for Fetch timeout and retry functionality                        |
-| `logLevel`     | No        | `'error'`                   | Minimum log level for the default console sink                                 |
-### 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']`            | Enabled features the Experience API may use for each request |
-Request-scoped Experience API options are passed to stateless event methods as their final argument
-instead of the SDK constructor:
-| Option      | Required? | Default     | Description                                                                    |
-| ----------- | --------- | ----------- | ------------------------------------------------------------------------------ |
-| `ip`        | No        | `undefined` | IP address override used by the Experience API for location analysis           |
-| `locale`    | No        | `undefined` | Locale used to translate `location.city` and `location.country`                |
-| `plainText` | No        | `undefined` | Sends performance-critical Experience API endpoints in plain text              |
-| `preflight` | No        | `undefined` | Instructs the Experience API to aggregate a new profile state but not store it |
-### Event Builder Options
-Event builder options should only be supplied when building an SDK on top of the Optimization Node
-SDK or any of its descendent SDKs.
-| Option    | Required? | Default                                                       | Description                                                                        |
-| --------- | --------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
-| `channel` | No        | `'server'`                                                    | The channel that identifies where events originate from (e.g. `'web'`, `'mobile'`) |
-| `library` | No        | `{ name: '@contentful/optimization-node', version: '0.0.0' }` | The client library metadata that is attached to all events                         |
-### Fetch Options
-Fetch options allow for configuration of a Fetch API-compatible fetch method and the retry/timeout
-logic integrated into the SDK's bundled API clients. Specify the `fetchMethod` when the host
-application environment does not offer a `fetch` method that is compatible with the standard Fetch
-API in its global scope.
-| Option             | Required? | Default     | Description                                                           |
-| ------------------ | --------- | ----------- | --------------------------------------------------------------------- |
-| `fetchMethod`      | No        | `undefined` | Signature of a fetch method used by the API clients                   |
-| `intervalTimeout`  | No        | `0`         | Delay (in milliseconds) between retry attempts                        |
-| `onFailedAttempt`  | No        | `undefined` | Callback invoked whenever a retry attempt fails                       |
-| `onRequestTimeout` | No        | `undefined` | Callback invoked when a request exceeds the configured timeout        |
-| `requestTimeout`   | No        | `3000`      | Maximum time (in milliseconds) to wait for a response before aborting |
-| `retries`          | No        | `1`         | Maximum number of retry attempts                                      |
-Configuration method signatures:
-- `fetchMethod`: `(url: string | URL, init: RequestInit) => Promise<Response>`
-- `onFailedAttempt` and `onRequestTimeout`: `(options: FetchMethodCallbackOptions) => void`
-## Optimization Methods
-Arguments marked with an asterisk (\*) are always required.
-### Optimization Data Resolution Methods
-#### `getFlag`
-Get the specified Custom Flag's value from the provided changes array.
-Arguments:
-- `name`\*: The name/key of the Custom Flag
-- `changes`: Changes array
-Returns:
-- The resolved value for the specified Custom Flag, or `undefined` if it cannot be found.
-Behavior notes:
-- Node SDK is stateless; `getFlag(...)` does not auto-emit `trackFlagView`.
-- If full map resolution is needed for advanced use cases, use
-  `optimization.flagsResolver.resolve(changes)`.
-> [!NOTE]
->
-> If the `changes` argument is omitted, the method will return `undefined`.
-#### `resolveOptimizedEntry`
-Resolve a baseline Contentful entry to an optimized variant using the provided selected
-optimizations.
-Type arguments:
-- `S`: Entry skeleton type
-- `M`: Chain modifiers
-- `L`: Locale code
-Arguments:
-- `entry`\*: The baseline entry to resolve
-- `selectedOptimizations`: Selected optimizations
-Returns:
-- The resolved optimized entry variant, or the supplied baseline entry if baseline is the selected
-  variant or a variant cannot be found.
-> [!NOTE]
->
-> If the `selectedOptimizations` argument is omitted, the method will return the baseline entry.
-#### `getMergeTagValue`
-Resolve a "Merge Tag" to a value based on the provided profile. A "Merge Tag" is a special Rich Text
-fragment supported by Contentful that specifies a profile data member to be injected into the Rich
-Text when rendered.
-Arguments:
-- `embeddedNodeEntryTarget`\*: The merge tag entry node to resolve
-- `profile`: The user profile
-> [!NOTE]
->
-> If the `profile` argument is omitted, the method will return the merge tag's fallback value.
-### Experience API and Insights API Event Methods
-Pass request-scoped Experience options as the final argument to stateless event methods:
+const optimization = new ContentfulOptimization({
+  clientId: 'your-client-id',
+  environment: 'main',
+  contentfulLocales: {
+    default: 'en-US',
+  },
+})
-```ts
-const requestOptions = {
-  locale: req.acceptsLanguages()[0] ?? 'en-US',
+function appPolicyAllowsOptimizationEvent(req: { cookies?: Record<string, string> }): boolean {
+  return req.cookies?.['app-personalization-consent'] === 'granted'
 }
-await optimization.page({ ...requestContext, profile }, requestOptions)
+async function renderRequest(
+  req: { cookies?: Record<string, string>; headers: { 'accept-language'?: string } },
+  profileId: string,
+) {
+  const { contentfulLocale, eventLocale } = optimization.resolveRequestLocale(req)
+  const requestOptimization = optimization.forRequest({
+    consent: {
+      events: appPolicyAllowsOptimizationEvent(req),
+      persistence: appPolicyAllowsOptimizationEvent(req),
+    },
+    eventContext: { locale: eventLocale },
+    experienceOptions: contentfulLocale ? { locale: contentfulLocale } : undefined,
+    profile: { id: profileId },
+  })
+  return await requestOptimization.page()
+}
 ```
-Request-scoped Experience options stay separate from the event payload. Event context such as page
-data, locale metadata on the event, and user agent belong in `payload`, while `ip`, `locale`,
-`plainText`, and `preflight` belong in `requestOptions`.
-Only the following methods may return an `OptimizationData` object:
-- `identify`
-- `page`
-- `screen`
-- `track`
-- `trackView` (when `payload.sticky` is `true`)
-`trackClick`, `trackHover`, and `trackFlagView` return no data. When returned, `OptimizationData`
-contains:
-- `changes`: Currently used for Custom Flags
-- `selectedOptimizations`: Selected optimizations for the profile
-- `profile`: Profile associated with the evaluated events
-In stateless runtimes, Insights-backed methods require a profile for delivery. Non-sticky
-`trackView`, `trackClick`, `trackHover`, and `trackFlagView` require `payload.profile.id`. Sticky
-`trackView` may omit `profile`, because the returned Experience profile is reused for the paired
-Insights event.
-#### `identify`
-Identify the current profile/visitor to associate traits with a profile.
-Arguments:
-- `payload`\*: Identify event builder arguments object, including an optional `profile` property
-  with a `PartialProfile` value that requires only an `id`
-- `requestOptions`: Optional request-scoped Experience API options passed as the final argument
-#### `page`
-Record an Experience API page view.
-Arguments:
-- `payload`\*: Page view event builder arguments object, including an optional `profile` property
-  with a `PartialProfile` value that requires only an `id`
-- `requestOptions`: Optional request-scoped Experience API options passed as the final argument
-#### `screen`
-Record an Experience API screen view.
-Arguments:
-- `payload`\*: Screen view event builder arguments object, including an optional `profile` property
-  with a `PartialProfile` value that requires only an `id`
-- `requestOptions`: Optional request-scoped Experience API options passed as the final argument
-#### `track`
-Record an Experience API custom track event.
-Arguments:
-- `payload`\*: Track event builder arguments object, including an optional `profile` property with a
-  `PartialProfile` value that requires only an `id`
-- `requestOptions`: Optional request-scoped Experience API options passed as the final argument
-#### `trackView`
-Record an Insights API entry view event. When the payload marks the entry as "sticky", an additional
-Experience API entry view is recorded. This method only returns `OptimizationData` when the entry is
-marked as "sticky".
-Arguments:
+## When to use this package
+Use `@contentful/optimization-node` for server-side rendering, server functions, and Node services
+that need stateless profile evaluation or event emission. Use the Web or React Web SDK alongside it
+when browser-side consent, anonymous ID persistence, automatic interaction tracking, or live updates
+are part of the same application.
+## Common configuration
+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/v0.1.0-alpha14/documentation/concepts/consent-management-in-the-optimization-sdk-suite.md).
+| Option              | Required? | Default                | Description                                                 |
+| ------------------- | --------- | ---------------------- | ----------------------------------------------------------- |
+| `clientId`          | Yes       | N/A                    | Shared API key for Experience API and Insights API requests |
+| `environment`       | No        | `'main'`               | Contentful environment identifier                           |
+| `api`               | No        | See API options below  | Experience API and Insights API endpoint options            |
+| `app`               | No        | `undefined`            | Application metadata attached to outgoing event context     |
+| `contentfulLocales` | No        | `undefined`            | Contentful locale codes used by `resolveRequestLocale()`    |
+| `fetchOptions`      | No        | SDK defaults           | Fetch timeout and retry behavior                            |
+| `allowedEventTypes` | No        | `['identify', 'page']` | Event types allowed before request event consent is granted |
+| `eventBuilder`      | No        | Node SDK defaults      | Event metadata overrides for SDK-layer authors              |
+| `logLevel`          | No        | `'error'`              | Minimum log level for the default console sink              |
+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 |
+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             |
+Common `fetchOptions` are `fetchMethod`, `requestTimeout`, `retries`, `intervalTimeout`,
+`onFailedAttempt`, and `onRequestTimeout`. Default retries intentionally apply only to HTTP `503`
+responses.
+Use `contentfulLocales.default` for single-locale apps. For apps that match request locale input to
+multiple Contentful locales, keep `default` as the fallback and list the supported Contentful locale
+codes:
-- `payload`\*: Entry view event builder arguments object. When `payload.sticky` is `true`, `profile`
-  is optional and the returned Experience profile is reused for Insights delivery. Otherwise,
-  `profile` is required and must contain at least an `id`
-- `requestOptions`: Optional request-scoped Experience API options passed as the final argument.
-  Only used when `payload.sticky` is `true`
-#### `trackClick`
-Record an Insights API entry click event.
-Returns:
-- `void`
-Arguments:
-- `payload`\*: Entry click event builder arguments object, including a required `profile` property
-  with a `PartialProfile` value that requires only an `id`
-- `requestOptions`: Optional request-scoped Experience API options accepted for signature
-  consistency; currently unused
-#### `trackHover`
+```ts
+const optimization = new ContentfulOptimization({
+  clientId: 'your-client-id',
+  contentfulLocales: {
+    default: 'en-US',
+    supported: ['en-US', 'de-DE', 'fr-FR'],
+  },
+})
+```
-Record an Insights API entry hover event.
+Copy `contentfulLocales.default` and optional `contentfulLocales.supported` from Contentful locale
+settings or the CMA locale list. The returned `contentfulLocale`, when present, is the configured
+Contentful locale code to use for CDA fetches and the Experience API request option. Use
+`eventLocale` separately in event context. Merge tags that reference localized profile fields such
+as `location.city` and `location.country` then resolve in a language consistent with the rendered
+content. See
+[Locale handling in the Optimization SDK Suite](https://contentful.github.io/optimization/documents/Documentation.Concepts.Locale_handling_in_the_Optimization_SDK_Suite.html)
+for the full locale model.
-Returns:
+For every option, callback payload, and exported type, use the generated
+[Node SDK reference](https://contentful.github.io/optimization/modules/_contentful_optimization-node.html).
-- `void`
+## Core workflows
-Arguments:
+### Request-scoped events
-- `payload`\*: Entry hover event builder arguments object, including a required `profile` property
-  with a `PartialProfile` value that requires only an `id`
-- `requestOptions`: Optional request-scoped Experience API options accepted for signature
-  consistency; currently unused
+Build event context from the incoming request, bind application-owned consent state with
+`forRequest()`, then call `page()`, `identify()`, `screen()`, `track()`, or sticky `trackView()` on
+the returned request object:
-#### `trackFlagView`
+```ts
+import type { Request } from 'express'
+app.get('/products/:slug', async (req, res) => {
+  const { contentfulLocale, eventLocale } = optimization.resolveRequestLocale(req)
+  const requestOptimization = optimization.forRequest({
+    consent: {
+      events: appPolicyAllowsOptimizationEvent(req),
+      persistence: appPolicyAllowsOptimizationEvent(req),
+    },
+    eventContext: {
+      locale: eventLocale,
+    },
+    experienceOptions: contentfulLocale ? { locale: contentfulLocale } : undefined,
+    profile: { id: req.cookies.profileId },
+  })
+  const optimizationData = await requestOptimization.page({
+    properties: { path: req.path },
+  })
+  if (requestOptimization.canPersistProfile && optimizationData?.profile.id) {
+    persistProfileId(res, optimizationData.profile.id)
+  }
+  res.render('product', { optimizationData })
+})
+```
-Track a feature flag view via the Insights API. This is functionally the same as a non-sticky flag
-view event.
+For default-on application policies that do not render an end-user consent UI, replace the
+request-specific consent lookup with accepted consent:
-Returns:
+```ts
+const requestOptimization = optimization.forRequest({
+  consent: { events: true, persistence: true },
+  eventContext: { locale: eventLocale },
+  profile,
+})
+```
-- `void`
+Node SDK event calls fail closed except for the default pre-consent allowlist, `identify` and
+`page`. Those allowlisted events are sent with `context.gdpr.isConsentGiven: false` when request
+event consent is not granted. Pass `allowedEventTypes: []` to require strict opt-in for all
+stateless event methods.
-Arguments:
+In stateless runtimes, Insights-backed methods require a request-bound profile for delivery.
+Non-sticky `trackView`, `trackClick`, `trackHover`, and `trackFlagView` require a profile ID passed
+to `forRequest()`.
-- `payload`\*: Flag view event builder arguments object, including a required `profile` property
-  with a `PartialProfile` value that requires only an `id`
-- `requestOptions`: Optional request-scoped Experience API options accepted for signature
-  consistency; currently unused
+### Content resolution
-## Interceptors
+Fetch Contentful entries in your application layer, then resolve variants with returned optimization
+data:
-Interceptors may be used to read and/or modify data flowing through the Core SDK.
+```ts
+const resolvedEntry = optimization.resolveOptimizedEntry(
+  baselineEntry,
+  optimizationData?.selectedOptimizations,
+)
+```
-### Life-cycle Interceptors
+Fetch entries with one CDA locale in the app layer. For localized apps, configure
+`contentfulLocales`, then use the `contentfulLocale` returned by `resolveRequestLocale()` for CDA
+fetches and the per-call `{ locale }` request option so MergeTags that read localized profile fields
+match the entry language. When `contentfulLocale` is absent because no `contentfulLocales` config is
+present, omit the CDA and Experience API locale options intentionally. Do not pass all-locale CDA
+responses from `withAllLocales` or `locale=*` into `resolveOptimizedEntry()`; the resolver expects
+direct single-locale field values. See
+[Entry personalization and variant resolution](https://contentful.github.io/optimization/documents/Documentation.Concepts.Entry_personalization_and_variant_resolution.html#single-locale-cda-entry-contract)
+for the entry contract and
+[Locale handling in the Optimization SDK Suite](https://contentful.github.io/optimization/documents/Documentation.Concepts.Locale_handling_in_the_Optimization_SDK_Suite.html)
+for request locale behavior.
+Use `getMergeTagValue()` for Contentful Rich Text merge tags and `getFlag()` for Custom Flags. If a
+merge tag references localized profile fields such as `location.city` or `location.country`, its
+resolved value follows the localized profile data returned by the Experience API. The Node SDK is
+stateless, so `getFlag()` does not automatically emit flag-view tracking.
+### Caching guidance
+Cache raw Contentful delivery payloads in your application layer, not profile-evaluated SDK event
+results.
+| Data or call                                                                | Cache across requests? | Reason                                                               |
+| --------------------------------------------------------------------------- | ---------------------- | -------------------------------------------------------------------- |
+| Raw Contentful entries fetched from CDA                                     | Yes                    | They are content snapshots and can be resolved per request           |
+| `resolveOptimizedEntry()` and `getMergeTagValue()` results                  | Request-local only     | Results depend on the current profile and optimization data          |
+| `page()`, `identify()`, `screen()`, `track()`, and sticky `trackView()`     | No                     | These calls perform side effects and return request-specific profile |
+| Non-sticky `trackView()`, `trackClick()`, `trackHover()`, `trackFlagView()` | No                     | These calls emit Insights API events                                 |
+The
+[Node SDK integration guide](https://contentful.github.io/optimization/documents/Documentation.Guides.integrating-the-node-sdk-in-a-node-app.html)
+covers request context, profile persistence, Contentful entry resolution, and hybrid Node + browser
+setups in detail.
+## Development harness
-- `event`: Intercepts an event's data _before_ it is queued and/or emitted
-- `state`: Intercepts state data retrieved from an Experience API call _before_ updating the SDK's
-  internal state
+The package-local dev harness runs from `packages/node/node-sdk/dev/` and reads `.env` from this
+package directory.
-Example interceptor usage:
+1. Start from `.env.example` and create or update `packages/node/node-sdk/.env`.
+2. Prefer the repo-standard `PUBLIC_...` variable names shown in `.env.example`.
+3. Start the harness from the repo root:
-```ts
-optimization.interceptors.event((event) => {
-  event.properties.timestamp = new Date().toISOString()
-})
-```
+   ```sh
+   pnpm --filter @contentful/optimization-node dev
+   ```
-> [!WARNING]
->
-> Interceptors are intended to enable low-level interoperability and should be used with care.
+## Related
+- [Integrating the Optimization Node SDK in a Node app](https://contentful.github.io/optimization/documents/Documentation.Guides.integrating-the-node-sdk-in-a-node-app.html) -
+  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/v0.1.0-alpha14/implementations/node-sdk/README.md) - server-rendered
+  implementation using request-scoped SDK calls
+- [Node + Web reference implementation](https://github.com/contentful/optimization/blob/v0.1.0-alpha14/implementations/node-sdk+web-sdk/README.md) -
+  hybrid SSR and browser implementation
+- [Optimization Web SDK](https://github.com/contentful/optimization/blob/v0.1.0-alpha14/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/260.mjs CHANGED Viewed

@@ -1,4 +1,4 @@
-const OPTIMIZATION_NODE_SDK_VERSION = "0.1.0-alpha12";
+const OPTIMIZATION_NODE_SDK_VERSION = "0.1.0-alpha14";
 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/constants.cjs CHANGED Viewed

@@ -30,7 +30,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 = "0.1.0-alpha12";
+const OPTIMIZATION_NODE_SDK_VERSION = "0.1.0-alpha14";
 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/index.cjs CHANGED Viewed

@@ -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 = "0.1.0-alpha12";
+        const OPTIMIZATION_NODE_SDK_VERSION = "0.1.0-alpha14";
         const OPTIMIZATION_NODE_SDK_NAME = "@contentful/optimization-node";
     }
 };
@@ -50,26 +50,85 @@ var __webpack_exports__ = {};
         default: ()=>src
     });
     const optimization_core_namespaceObject = require("@contentful/optimization-core");
-    const external_es_toolkit_namespaceObject = require("es-toolkit");
     var constants = __webpack_require__("./src/constants.ts");
-    function mergeConfig(config) {
-        const { app, ...restConfig } = config;
-        const defaultConfig = {
-            eventBuilder: {
-                app,
-                channel: 'server',
-                library: {
-                    name: constants.OPTIMIZATION_NODE_SDK_NAME,
-                    version: constants.OPTIMIZATION_NODE_SDK_VERSION
-                }
-            }
-        };
-        return (0, external_es_toolkit_namespaceObject.merge)(defaultConfig, restConfig);
+    const DEFAULT_RUNTIME_LOCALE = 'en-US';
+    const DEFAULT_ACCEPT_LANGUAGE_QUALITY = 1;
+    const QUALITY_PARAM_PATTERN = /;\s*q=/;
+    const DEFAULT_NODE_ALLOWED_EVENT_TYPES = [
+        'identify',
+        'page'
+    ];
+    function normalizeHeaderValue(header) {
+        if ('string' == typeof header) return header;
+        return Array.isArray(header) ? header.filter((item)=>'string' == typeof item).join(',') : void 0;
+    }
+    function getAcceptLanguageHeader(input) {
+        if ('string' == typeof input) return input;
+        if ('object' != typeof input || null === input) return;
+        const headerFromGetter = input.get?.('accept-language');
+        if ('string' == typeof headerFromGetter) return headerFromGetter;
+        const { headers } = input;
+        if ('object' != typeof headers || null === headers) return;
+        const get = Reflect.get(headers, 'get');
+        const header = 'function' == typeof get ? Reflect.apply(get, headers, [
+            'accept-language'
+        ]) : Reflect.get(headers, 'accept-language') ?? Reflect.get(headers, 'Accept-Language');
+        return normalizeHeaderValue(header);
+    }
+    function parseAcceptLanguage(acceptLanguage) {
+        const candidates = [];
+        for (const [index, value] of (acceptLanguage ?? '').split(',').entries()){
+            const [rawLocale, rawQuality] = value.split(QUALITY_PARAM_PATTERN);
+            const locale = (0, optimization_core_namespaceObject.normalizeLocale)(rawLocale);
+            if (void 0 === locale) continue;
+            const parsedQuality = void 0 === rawQuality ? DEFAULT_ACCEPT_LANGUAGE_QUALITY : Number(rawQuality);
+            const quality = Number.isFinite(parsedQuality) ? parsedQuality : DEFAULT_ACCEPT_LANGUAGE_QUALITY;
+            if (quality > 0) candidates.push({
+                index,
+                locale,
+                quality
+            });
+        }
+        return candidates.sort((left, right)=>right.quality - left.quality || left.index - right.index).map((candidate)=>candidate.locale);
+    }
+    function getRequestLocaleCandidates(input) {
+        const parsedHeaderLocales = parseAcceptLanguage(getAcceptLanguageHeader(input));
+        if (parsedHeaderLocales.length > 0) return parsedHeaderLocales;
+        if ('object' != typeof input || null === input) return [];
+        return input.acceptsLanguages?.().map(optimization_core_namespaceObject.normalizeLocale).filter((locale)=>void 0 !== locale) ?? [];
     }
     class ContentfulOptimization extends optimization_core_namespaceObject.CoreStateless {
-        constructor(config){
-            const mergedConfig = mergeConfig(config);
-            super(mergedConfig);
+        constructor({ app, allowedEventTypes, eventBuilder, ...config }){
+            const { library, getConsent: _getConsent, ...eventBuilderConfig } = eventBuilder ?? {};
+            super({
+                ...config,
+                allowedEventTypes: allowedEventTypes ?? DEFAULT_NODE_ALLOWED_EVENT_TYPES,
+                eventBuilder: {
+                    app,
+                    channel: 'server',
+                    library: {
+                        name: constants.OPTIMIZATION_NODE_SDK_NAME,
+                        version: constants.OPTIMIZATION_NODE_SDK_VERSION,
+                        ...library
+                    },
+                    getConsent: ()=>false,
+                    ...eventBuilderConfig
+                }
+            });
+        }
+        resolveRequestLocale(input) {
+            const candidates = getRequestLocaleCandidates(input);
+            const eventLocale = candidates[0] ?? DEFAULT_RUNTIME_LOCALE;
+            const contentfulLocale = (0, optimization_core_namespaceObject.resolveContentfulLocale)({
+                candidates,
+                contentfulLocales: this.config.contentfulLocales
+            }) ?? this.locale;
+            return void 0 === contentfulLocale ? {
+                eventLocale
+            } : {
+                eventLocale,
+                contentfulLocale
+            };
         }
     }
     const src_ContentfulOptimization = ContentfulOptimization;

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.cjs","sources":["../src/constants.ts","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../src/ContentfulOptimization.ts","../src/index.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_VERSION__: string \| undefined\n// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_PACKAGE_NAME__: string \| undefined\n\n/*\n The current version of the Optimization Node SDK, injected at build-time.\n \n @defaultValue `'0.0.0'` when the build-time replacement is unavailable.\n \n @public\n /\nexport const OPTIMIZATION_NODE_SDK_VERSION =\n typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0'\n\n/\n The package name of the Optimization Node SDK, injected at build-time.\n \n @defaultValue `'@contentful/optimization-node'` when the build-time replacement is unavailable.\n \n @public\n /\nexport const OPTIMIZATION_NODE_SDK_NAME =\n typeof __OPTIMIZATION_PACKAGE_NAME__ === 'string'\n ? __OPTIMIZATION_PACKAGE_NAME__\n : '@contentful/optimization-node'\n\n/\n Re-exports of anonymous identifier constants used by the Optimization Core.\n \n @remarks\n * This constant is surfaced here to provide a stable import path for Node SDK\n * consumers. It represents the cookie key used by the Optimization Framework\n * to persist an anonymous identifier for tracking optimization and insights\n * events when no explicit profile is known.\n \n @example\n * ```ts\n * import { ANONYMOUS_ID_COOKIE, ANONYMOUS_ID_KEY } from '@contentful/optimization-node/constants'\n * const cookieId = request.cookies[ANONYMOUS_ID_COOKIE]\n * const storageId = localStorage.getItem(ANONYMOUS_ID_KEY)\n * ```\n \n @see {@link ANONYMOUS_ID_COOKIE} and {@link ANONYMOUS_ID_KEY} in\n * `@contentful/optimization-core` for the\n * authoritative definition and documentation.\n \n @public\n /\nexport { ANONYMOUS_ID_COOKIE, ANONYMOUS_ID_KEY } from '@contentful/optimization-core/constants'\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n }\n }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import { CoreStateless } from '@contentful/optimization-core'\nimport type { App } from '@contentful/optimization-core/api-schemas'\nimport { merge } from 'es-toolkit'\nimport { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from './constants'\n\ntype CoreStatelessConfig = ConstructorParameters<typeof CoreStateless>[0]\n\n/\n Configuration for the Node-specific ContentfulOptimization SDK.\n \n @remarks\n * This configuration extends {@link CoreStatelessConfig} but allows partial\n * overrides of the event-builder configuration. SDKs commonly inject their own\n * library metadata or channel definitions.\n \n @see {@link CoreStatelessConfig}\n \n @public\n /\nexport interface OptimizationNodeConfig extends Omit<CoreStatelessConfig, 'eventBuilder'> {\n /\n The application definition used to attribute events to a specific consumer app.\n \n @remarks\n * When not provided, events will not contain app metadata in their context.\n /\n app?: App\n\n /\n Partial overrides for the event builder configuration.\n \n @remarks\n * Any provided fields are merged with the default Node SDK metadata.\n * This differs from {@link CoreStatelessConfig} eventBuilder, which expects\n * a full configuration object.\n /\n eventBuilder?: Partial<Omit<CoreStatelessConfig['eventBuilder'], 'app'>>\n}\n\n/\n Merge user-supplied configuration with defaults for the Node SDK.\n \n @param config - The input configuration supplied by the caller.\n * @returns A fully composed {@link CoreStatelessConfig} object suitable for\n * constructing the core runtime.\n \n @remarks\n * Ensures that the Node SDK always identifies itself via a `server` channel\n * and a `library` metadata block unless explicitly overridden.\n \n @internal\n /\nfunction mergeConfig(config: OptimizationNodeConfig): CoreStatelessConfig {\n const { app, ...restConfig } = config\n\n const defaultConfig: Partial<CoreStatelessConfig> = {\n eventBuilder: {\n app,\n channel: 'server',\n library: { name: OPTIMIZATION_NODE_SDK_NAME, version: OPTIMIZATION_NODE_SDK_VERSION },\n },\n }\n return merge(defaultConfig, restConfig)\n}\n\n/\n Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.\n \n @remarks\n * This class adapts the stateless ContentfulOptimization Core for Node runtimes by\n * applying environment-appropriate defaults (e.g., server channel, Node SDK\n * library metadata). No core runtime behavior is modified; only configuration\n * defaults differ.\n \n @example\n * ```ts\n * import ContentfulOptimization from '@contentful/optimization-node'\n \n const sdk = new ContentfulOptimization({\n * clientId: 'abc-123',\n * environment: 'main',\n * logLevel: 'info',\n * })\n \n const requestOptions = { locale: 'en-US' }\n \n await sdk.track({ event: 'server_event', properties: { id: 1 } }, requestOptions)\n * ```\n \n @see {@link CoreStateless}\n \n @public\n /\nclass ContentfulOptimization extends CoreStateless {\n /\n Create an instance of the Node SDK with merged defaults.\n \n @param config - Partial Node-specific configuration. Any eventBuilder\n * fields provided are merged with Node's defaults.\n \n @example\n * ```ts\n * import ContentfulOptimization from '@contentful/optimization-node'\n \n const optimization = new ContentfulOptimization({ clientId: 'my-client-id' })\n * ```\n /\n constructor(config: OptimizationNodeConfig) {\n const mergedConfig: CoreStatelessConfig = mergeConfig(config)\n\n super(mergedConfig)\n }\n}\n\nexport default ContentfulOptimization\n","/\n Contentful ContentfulOptimization Node SDK.\n \n @remarks\n * Adds Node-specific defaults via the {@link ContentfulOptimization} class.\n * Core and transitive API exports are available from dedicated entrypoints:\n * `@contentful/optimization-node/core-sdk`,\n * `@contentful/optimization-node/api-client`,\n * and `@contentful/optimization-node/api-schemas`.\n \n @packageDocumentation\n /\n\nimport ContentfulOptimization from './ContentfulOptimization'\n\nexport { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from './constants'\nexport from './ContentfulOptimization'\n\nexport default ContentfulOptimization\n"],"names":["OPTIMIZATION_NODE_SDK_VERSION","__OPTIMIZATION_VERSION__","OPTIMIZATION_NODE_SDK_NAME","__OPTIMIZATION_PACKAGE_NAME__","__webpack_require__","definition","key","Object","obj","prop","Symbol","mergeConfig","config","app","restConfig","defaultConfig","merge","ContentfulOptimization","CoreStateless","mergedConfig"],"mappings":";;;;;;;;QAYO,MAAMA,gCACoCC;QAS1C,MAAMC,6BAEPC;;;;;;;;;;;;;;ICxBNC,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,MAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;;;;IC8CA,SAASI,YAAYC,MAA8B;QACjD,MAAM,EAAEC,GAAG,EAAE,GAAGC,YAAY,GAAGF;QAE/B,MAAMG,gBAA8C;YAClD,cAAc;gBACZF;gBACA,SAAS;gBACT,SAAS;oBAAE,MAAMX,UAAAA,0BAA0BA;oBAAE,SAASF,UAAAA,6BAA6BA;gBAAC;YACtF;QACF;QACA,OAAOgB,AAAAA,IAAAA,oCAAAA,KAAAA,AAAAA,EAAMD,eAAeD;IAC9B;IA8BA,MAAMG,+BAA+BC,kCAAAA,aAAaA;QAchD,YAAYN,MAA8B,CAAE;YAC1C,MAAMO,eAAoCR,YAAYC;YAEtD,KAAK,CAACO;QACR;IACF;IAEA,mCAAeF;IChGf,YAAeA"}
1	+ {"version":3,"file":"index.cjs","sources":["../src/constants.ts","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../src/ContentfulOptimization.ts","../src/index.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_VERSION__: string \| undefined\n// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_PACKAGE_NAME__: string \| undefined\n\n/*\n The current version of the Optimization Node SDK, injected at build-time.\n \n @defaultValue `'0.0.0'` when the build-time replacement is unavailable.\n \n @public\n /\nexport const OPTIMIZATION_NODE_SDK_VERSION =\n typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0'\n\n/\n The package name of the Optimization Node SDK, injected at build-time.\n \n @defaultValue `'@contentful/optimization-node'` when the build-time replacement is unavailable.\n \n @public\n /\nexport const OPTIMIZATION_NODE_SDK_NAME =\n typeof __OPTIMIZATION_PACKAGE_NAME__ === 'string'\n ? __OPTIMIZATION_PACKAGE_NAME__\n : '@contentful/optimization-node'\n\n/\n Re-exports of anonymous identifier constants used by the Optimization Core.\n \n @remarks\n * This constant is surfaced here to provide a stable import path for Node SDK\n * consumers. It represents the cookie key used by the Optimization Framework\n * to persist an anonymous identifier for tracking optimization and insights\n * events when no explicit profile is known.\n \n @example\n * ```ts\n * import { ANONYMOUS_ID_COOKIE, ANONYMOUS_ID_KEY } from '@contentful/optimization-node/constants'\n * const cookieId = request.cookies[ANONYMOUS_ID_COOKIE]\n * const storageId = localStorage.getItem(ANONYMOUS_ID_KEY)\n * ```\n \n @see {@link ANONYMOUS_ID_COOKIE} and {@link ANONYMOUS_ID_KEY} in\n * `@contentful/optimization-core` for the\n * authoritative definition and documentation.\n \n @public\n /\nexport { ANONYMOUS_ID_COOKIE, ANONYMOUS_ID_KEY } from '@contentful/optimization-core/constants'\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n }\n }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import {\n CoreStateless,\n normalizeLocale,\n resolveContentfulLocale,\n type CoreStatelessConfig,\n type EventType,\n} from '@contentful/optimization-core'\nimport type { App } from '@contentful/optimization-core/api-schemas'\nimport { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from './constants'\n\nconst DEFAULT_RUNTIME_LOCALE = 'en-US'\nconst DEFAULT_ACCEPT_LANGUAGE_QUALITY = 1\nconst QUALITY_PARAM_PATTERN = /;\\sq=/\nconst DEFAULT_NODE_ALLOWED_EVENT_TYPES: EventType[] = ['identify', 'page']\n\ntype NodeEventBuilderConfig = Partial<Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app'>>\ntype PublicNodeEventBuilderConfig = Omit<NodeEventBuilderConfig, 'getConsent'>\n\ninterface HeaderRequestLike {\n acceptsLanguages?: () => string[]\n get?: (name: string) => string \| null \| undefined\n headers?: unknown\n}\n\n/*\n Locale pair resolved from an incoming server request.\n \n @public\n /\nexport interface ResolvedRequestLocale {\n /* Locale to place on SDK event context. /\n readonly eventLocale: string\n /* Contentful locale to use for CDA fetches and Experience API request options, when configured. /\n readonly contentfulLocale?: string\n}\n\n/\n Accepted inputs for {@link ContentfulOptimization.resolveRequestLocale}.\n \n @public\n /\nexport type RequestLocaleInput = string \| null \| undefined \| HeaderRequestLike\n\n/\n Configuration for the Node-specific ContentfulOptimization SDK.\n \n @remarks\n * This configuration extends {@link CoreStatelessConfig} but allows partial\n * overrides of the event-builder configuration. SDKs commonly inject their own\n * library metadata or channel definitions.\n \n @see {@link CoreStatelessConfig}\n \n @public\n /\nexport interface OptimizationNodeConfig extends Omit<CoreStatelessConfig, 'eventBuilder'> {\n /\n The application definition used to attribute events to a specific consumer app.\n \n @remarks\n * When not provided, events will not contain app metadata in their context.\n /\n app?: App\n\n /\n Partial overrides for the event builder configuration.\n \n @remarks\n * Any provided fields are merged with the default Node SDK metadata.\n * Request-scoped consent should be bound with `forRequest()`, not configured\n * on the SDK singleton.\n \n This differs from {@link CoreStatelessConfig} eventBuilder, which expects\n * a full configuration object.\n /\n eventBuilder?: PublicNodeEventBuilderConfig\n}\n\nfunction normalizeHeaderValue(header: unknown): string \| undefined {\n if (typeof header === 'string') {\n return header\n }\n\n return Array.isArray(header)\n ? header.filter((item): item is string => typeof item === 'string').join(',')\n : undefined\n}\n\nfunction getAcceptLanguageHeader(input: RequestLocaleInput): string \| undefined {\n if (typeof input === 'string') {\n return input\n }\n\n if (typeof input !== 'object' \|\| input === null) {\n return undefined\n }\n\n const headerFromGetter = input.get?.('accept-language')\n\n if (typeof headerFromGetter === 'string') {\n return headerFromGetter\n }\n\n const { headers } = input\n\n if (typeof headers !== 'object' \|\| headers === null) {\n return undefined\n }\n\n const get: unknown = Reflect.get(headers, 'get')\n const header: unknown =\n typeof get === 'function'\n ? Reflect.apply(get, headers, ['accept-language'])\n : (Reflect.get(headers, 'accept-language') ?? Reflect.get(headers, 'Accept-Language'))\n\n return normalizeHeaderValue(header)\n}\n\nfunction parseAcceptLanguage(acceptLanguage: string \| undefined): string[] {\n const candidates: Array<{ index: number; locale: string; quality: number }> = []\n\n for (const [index, value] of (acceptLanguage ?? '').split(',').entries()) {\n const [rawLocale, rawQuality] = value.split(QUALITY_PARAM_PATTERN)\n const locale = normalizeLocale(rawLocale)\n\n if (locale === undefined) {\n continue\n }\n\n const parsedQuality =\n rawQuality === undefined ? DEFAULT_ACCEPT_LANGUAGE_QUALITY : Number(rawQuality)\n const quality = Number.isFinite(parsedQuality) ? parsedQuality : DEFAULT_ACCEPT_LANGUAGE_QUALITY\n\n if (quality > 0) {\n candidates.push({ index, locale, quality })\n }\n }\n\n return candidates\n .sort((left, right) => right.quality - left.quality \|\| left.index - right.index)\n .map((candidate) => candidate.locale)\n}\n\nfunction getRequestLocaleCandidates(input: RequestLocaleInput): string[] {\n const parsedHeaderLocales = parseAcceptLanguage(getAcceptLanguageHeader(input))\n\n if (parsedHeaderLocales.length > 0) {\n return parsedHeaderLocales\n }\n\n if (typeof input !== 'object' \|\| input === null) {\n return []\n }\n\n return (\n input\n .acceptsLanguages?.()\n .map(normalizeLocale)\n .filter((locale): locale is string => locale !== undefined) ?? []\n )\n}\n\n/\n Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.\n \n @remarks\n * This class adapts the stateless ContentfulOptimization Core for Node runtimes by\n * applying environment-appropriate defaults (e.g., server channel, Node SDK\n * library metadata). No core runtime behavior is modified; only configuration\n * defaults differ.\n \n @example\n * ```ts\n * import ContentfulOptimization from '@contentful/optimization-node'\n \n const sdk = new ContentfulOptimization({\n * clientId: 'abc-123',\n * environment: 'main',\n * logLevel: 'info',\n * })\n \n const requestOptimization = sdk.forRequest({\n * consent: true,\n * experienceOptions: { locale: 'fr-CA' },\n * profile: { id: 'profile-id' },\n * })\n \n await requestOptimization.page()\n * ```\n \n @see {@link CoreStateless}\n \n @public\n /\nclass ContentfulOptimization extends CoreStateless {\n /\n Create an instance of the Node SDK with merged defaults.\n \n @param config - Partial Node-specific configuration. Any eventBuilder\n * fields provided are merged with Node's defaults.\n \n @example\n * ```ts\n * import ContentfulOptimization from '@contentful/optimization-node'\n \n const optimization = new ContentfulOptimization({ clientId: 'my-client-id' })\n * ```\n /\n constructor({ app, allowedEventTypes, eventBuilder, ...config }: OptimizationNodeConfig) {\n const {\n library,\n getConsent: _getConsent,\n ...eventBuilderConfig\n } = (eventBuilder ?? {}) as NodeEventBuilderConfig\n\n super({\n ...config,\n allowedEventTypes: allowedEventTypes ?? DEFAULT_NODE_ALLOWED_EVENT_TYPES,\n eventBuilder: {\n app,\n channel: 'server',\n library: {\n name: OPTIMIZATION_NODE_SDK_NAME,\n version: OPTIMIZATION_NODE_SDK_VERSION,\n ...library,\n },\n getConsent: () => false,\n ...eventBuilderConfig,\n },\n })\n }\n\n /\n Resolve request and Contentful locales from `Accept-Language`.\n \n @param input - Raw `Accept-Language` header or a request-like object.\n * @returns Event-context locale and Contentful CDA locale.\n \n @example\n * ```ts\n * const { eventLocale, contentfulLocale } = optimization.resolveRequestLocale(req)\n * ```\n /\n resolveRequestLocale(input: RequestLocaleInput): ResolvedRequestLocale {\n const candidates = getRequestLocaleCandidates(input)\n const eventLocale = candidates[0] ?? DEFAULT_RUNTIME_LOCALE\n const contentfulLocale =\n resolveContentfulLocale({\n candidates,\n contentfulLocales: this.config.contentfulLocales,\n }) ?? this.locale\n\n return contentfulLocale === undefined ? { eventLocale } : { eventLocale, contentfulLocale }\n }\n}\n\nexport default ContentfulOptimization\n","/\n Contentful ContentfulOptimization Node SDK.\n \n @remarks\n * Adds Node-specific defaults via the {@link ContentfulOptimization} class.\n * Core and transitive API exports are available from dedicated entrypoints:\n * `@contentful/optimization-node/core-sdk`,\n * `@contentful/optimization-node/api-client`,\n * and `@contentful/optimization-node/api-schemas`.\n \n @packageDocumentation\n /\n\nimport ContentfulOptimization from './ContentfulOptimization'\n\nexport { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from './constants'\nexport from './ContentfulOptimization'\n\nexport default ContentfulOptimization\n"],"names":["OPTIMIZATION_NODE_SDK_VERSION","__OPTIMIZATION_VERSION__","OPTIMIZATION_NODE_SDK_NAME","__OPTIMIZATION_PACKAGE_NAME__","__webpack_require__","definition","key","Object","obj","prop","Symbol","DEFAULT_RUNTIME_LOCALE","DEFAULT_ACCEPT_LANGUAGE_QUALITY","QUALITY_PARAM_PATTERN","DEFAULT_NODE_ALLOWED_EVENT_TYPES","normalizeHeaderValue","header","Array","item","undefined","getAcceptLanguageHeader","input","headerFromGetter","headers","get","Reflect","parseAcceptLanguage","acceptLanguage","candidates","index","value","rawLocale","rawQuality","locale","normalizeLocale","parsedQuality","Number","quality","left","right","candidate","getRequestLocaleCandidates","parsedHeaderLocales","ContentfulOptimization","CoreStateless","app","allowedEventTypes","eventBuilder","config","library","_getConsent","eventBuilderConfig","eventLocale","contentfulLocale","resolveContentfulLocale"],"mappings":"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"}

package/dist/index.d.cts CHANGED Viewed

@@ -13,6 +13,7 @@
 import type { App } from '@contentful/optimization-core/api-schemas';
 import { CoreStateless } from '@contentful/optimization-core';
+import { CoreStatelessConfig } from '@contentful/optimization-core';
 /**
  * Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.
@@ -33,9 +34,13 @@ import { CoreStateless } from '@contentful/optimization-core';
  *   logLevel: 'info',
  * })
  *
- * const requestOptions = { locale: 'en-US' }
+ * const requestOptimization = sdk.forRequest({
+ *   consent: true,
+ *   experienceOptions: { locale: 'fr-CA' },
+ *   profile: { id: 'profile-id' },
+ * })
  *
- * await sdk.track({ event: 'server_event', properties: { id: 1 } }, requestOptions)
+ * await requestOptimization.page()
  * ```
  *
  * @see {@link CoreStateless}
@@ -56,11 +61,29 @@ declare class ContentfulOptimization extends CoreStateless {
      * const optimization = new ContentfulOptimization({ clientId: 'my-client-id' })
      * ```
      */
-    constructor(config: OptimizationNodeConfig);
+    constructor({ app, allowedEventTypes, eventBuilder, ...config }: OptimizationNodeConfig);
+    /**
+     * Resolve request and Contentful locales from `Accept-Language`.
+     *
+     * @param input - Raw `Accept-Language` header or a request-like object.
+     * @returns Event-context locale and Contentful CDA locale.
+     *
+     * @example
+     * ```ts
+     * const { eventLocale, contentfulLocale } = optimization.resolveRequestLocale(req)
+     * ```
+     */
+    resolveRequestLocale(input: RequestLocaleInput): ResolvedRequestLocale;
 }
 export default ContentfulOptimization;
-declare type CoreStatelessConfig = ConstructorParameters<typeof CoreStateless>[0];
+declare interface HeaderRequestLike {
+    acceptsLanguages?: () => string[];
+    get?: (name: string) => string | null | undefined;
+    headers?: unknown;
+}
+declare type NodeEventBuilderConfig = Partial<Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app'>>;
 /**
  * The package name of the Optimization Node SDK, injected at build-time.
@@ -105,10 +128,34 @@ export declare interface OptimizationNodeConfig extends Omit<CoreStatelessConfig
      *
      * @remarks
      * Any provided fields are merged with the default Node SDK metadata.
+     * Request-scoped consent should be bound with `forRequest()`, not configured
+     * on the SDK singleton.
+     *
      * This differs from {@link CoreStatelessConfig} eventBuilder, which expects
      * a full configuration object.
      */
-    eventBuilder?: Partial<Omit<CoreStatelessConfig['eventBuilder'], 'app'>>;
+    eventBuilder?: PublicNodeEventBuilderConfig;
+}
+declare type PublicNodeEventBuilderConfig = Omit<NodeEventBuilderConfig, 'getConsent'>;
+/**
+ * Accepted inputs for {@link ContentfulOptimization.resolveRequestLocale}.
+ *
+ * @public
+ */
+export declare type RequestLocaleInput = string | null | undefined | HeaderRequestLike;
+/**
+ * Locale pair resolved from an incoming server request.
+ *
+ * @public
+ */
+export declare interface ResolvedRequestLocale {
+    /** Locale to place on SDK event context. */
+    readonly eventLocale: string;
+    /** Contentful locale to use for CDA fetches and Experience API request options, when configured. */
+    readonly contentfulLocale?: string;
 }
 export { }

package/dist/index.d.mts CHANGED Viewed

@@ -13,6 +13,7 @@
 import type { App } from '@contentful/optimization-core/api-schemas';
 import { CoreStateless } from '@contentful/optimization-core';
+import { CoreStatelessConfig } from '@contentful/optimization-core';
 /**
  * Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.
@@ -33,9 +34,13 @@ import { CoreStateless } from '@contentful/optimization-core';
  *   logLevel: 'info',
  * })
  *
- * const requestOptions = { locale: 'en-US' }
+ * const requestOptimization = sdk.forRequest({
+ *   consent: true,
+ *   experienceOptions: { locale: 'fr-CA' },
+ *   profile: { id: 'profile-id' },
+ * })
  *
- * await sdk.track({ event: 'server_event', properties: { id: 1 } }, requestOptions)
+ * await requestOptimization.page()
  * ```
  *
  * @see {@link CoreStateless}
@@ -56,11 +61,29 @@ declare class ContentfulOptimization extends CoreStateless {
      * const optimization = new ContentfulOptimization({ clientId: 'my-client-id' })
      * ```
      */
-    constructor(config: OptimizationNodeConfig);
+    constructor({ app, allowedEventTypes, eventBuilder, ...config }: OptimizationNodeConfig);
+    /**
+     * Resolve request and Contentful locales from `Accept-Language`.
+     *
+     * @param input - Raw `Accept-Language` header or a request-like object.
+     * @returns Event-context locale and Contentful CDA locale.
+     *
+     * @example
+     * ```ts
+     * const { eventLocale, contentfulLocale } = optimization.resolveRequestLocale(req)
+     * ```
+     */
+    resolveRequestLocale(input: RequestLocaleInput): ResolvedRequestLocale;
 }
 export default ContentfulOptimization;
-declare type CoreStatelessConfig = ConstructorParameters<typeof CoreStateless>[0];
+declare interface HeaderRequestLike {
+    acceptsLanguages?: () => string[];
+    get?: (name: string) => string | null | undefined;
+    headers?: unknown;
+}
+declare type NodeEventBuilderConfig = Partial<Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app'>>;
 /**
  * The package name of the Optimization Node SDK, injected at build-time.
@@ -105,10 +128,34 @@ export declare interface OptimizationNodeConfig extends Omit<CoreStatelessConfig
      *
      * @remarks
      * Any provided fields are merged with the default Node SDK metadata.
+     * Request-scoped consent should be bound with `forRequest()`, not configured
+     * on the SDK singleton.
+     *
      * This differs from {@link CoreStatelessConfig} eventBuilder, which expects
      * a full configuration object.
      */
-    eventBuilder?: Partial<Omit<CoreStatelessConfig['eventBuilder'], 'app'>>;
+    eventBuilder?: PublicNodeEventBuilderConfig;
+}
+declare type PublicNodeEventBuilderConfig = Omit<NodeEventBuilderConfig, 'getConsent'>;
+/**
+ * Accepted inputs for {@link ContentfulOptimization.resolveRequestLocale}.
+ *
+ * @public
+ */
+export declare type RequestLocaleInput = string | null | undefined | HeaderRequestLike;
+/**
+ * Locale pair resolved from an incoming server request.
+ *
+ * @public
+ */
+export declare interface ResolvedRequestLocale {
+    /** Locale to place on SDK event context. */
+    readonly eventLocale: string;
+    /** Contentful locale to use for CDA fetches and Experience API request options, when configured. */
+    readonly contentfulLocale?: string;
 }
 export { }

package/dist/index.d.ts CHANGED Viewed

@@ -13,6 +13,7 @@
 import type { App } from '@contentful/optimization-core/api-schemas';
 import { CoreStateless } from '@contentful/optimization-core';
+import { CoreStatelessConfig } from '@contentful/optimization-core';
 /**
  * Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.
@@ -33,9 +34,13 @@ import { CoreStateless } from '@contentful/optimization-core';
  *   logLevel: 'info',
  * })
  *
- * const requestOptions = { locale: 'en-US' }
+ * const requestOptimization = sdk.forRequest({
+ *   consent: true,
+ *   experienceOptions: { locale: 'fr-CA' },
+ *   profile: { id: 'profile-id' },
+ * })
  *
- * await sdk.track({ event: 'server_event', properties: { id: 1 } }, requestOptions)
+ * await requestOptimization.page()
  * ```
  *
  * @see {@link CoreStateless}
@@ -56,11 +61,29 @@ declare class ContentfulOptimization extends CoreStateless {
      * const optimization = new ContentfulOptimization({ clientId: 'my-client-id' })
      * ```
      */
-    constructor(config: OptimizationNodeConfig);
+    constructor({ app, allowedEventTypes, eventBuilder, ...config }: OptimizationNodeConfig);
+    /**
+     * Resolve request and Contentful locales from `Accept-Language`.
+     *
+     * @param input - Raw `Accept-Language` header or a request-like object.
+     * @returns Event-context locale and Contentful CDA locale.
+     *
+     * @example
+     * ```ts
+     * const { eventLocale, contentfulLocale } = optimization.resolveRequestLocale(req)
+     * ```
+     */
+    resolveRequestLocale(input: RequestLocaleInput): ResolvedRequestLocale;
 }
 export default ContentfulOptimization;
-declare type CoreStatelessConfig = ConstructorParameters<typeof CoreStateless>[0];
+declare interface HeaderRequestLike {
+    acceptsLanguages?: () => string[];
+    get?: (name: string) => string | null | undefined;
+    headers?: unknown;
+}
+declare type NodeEventBuilderConfig = Partial<Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app'>>;
 /**
  * The package name of the Optimization Node SDK, injected at build-time.
@@ -105,10 +128,34 @@ export declare interface OptimizationNodeConfig extends Omit<CoreStatelessConfig
      *
      * @remarks
      * Any provided fields are merged with the default Node SDK metadata.
+     * Request-scoped consent should be bound with `forRequest()`, not configured
+     * on the SDK singleton.
+     *
      * This differs from {@link CoreStatelessConfig} eventBuilder, which expects
      * a full configuration object.
      */
-    eventBuilder?: Partial<Omit<CoreStatelessConfig['eventBuilder'], 'app'>>;
+    eventBuilder?: PublicNodeEventBuilderConfig;
+}
+declare type PublicNodeEventBuilderConfig = Omit<NodeEventBuilderConfig, 'getConsent'>;
+/**
+ * Accepted inputs for {@link ContentfulOptimization.resolveRequestLocale}.
+ *
+ * @public
+ */
+export declare type RequestLocaleInput = string | null | undefined | HeaderRequestLike;
+/**
+ * Locale pair resolved from an incoming server request.
+ *
+ * @public
+ */
+export declare interface ResolvedRequestLocale {
+    /** Locale to place on SDK event context. */
+    readonly eventLocale: string;
+    /** Contentful locale to use for CDA fetches and Experience API request options, when configured. */
+    readonly contentfulLocale?: string;
 }
 export { }

package/dist/index.mjs CHANGED Viewed

@@ -1,24 +1,83 @@
-import { merge } from "es-toolkit";
 import { __rspack_external__contentful_optimization_core_7d4758c6 } from "./987.mjs";
 import { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from "./260.mjs";
-function mergeConfig(config) {
-    const { app, ...restConfig } = config;
-    const defaultConfig = {
-        eventBuilder: {
-            app,
-            channel: 'server',
-            library: {
-                name: OPTIMIZATION_NODE_SDK_NAME,
-                version: OPTIMIZATION_NODE_SDK_VERSION
-            }
-        }
-    };
-    return merge(defaultConfig, restConfig);
+const DEFAULT_RUNTIME_LOCALE = 'en-US';
+const DEFAULT_ACCEPT_LANGUAGE_QUALITY = 1;
+const QUALITY_PARAM_PATTERN = /;\s*q=/;
+const DEFAULT_NODE_ALLOWED_EVENT_TYPES = [
+    'identify',
+    'page'
+];
+function normalizeHeaderValue(header) {
+    if ('string' == typeof header) return header;
+    return Array.isArray(header) ? header.filter((item)=>'string' == typeof item).join(',') : void 0;
+}
+function getAcceptLanguageHeader(input) {
+    if ('string' == typeof input) return input;
+    if ('object' != typeof input || null === input) return;
+    const headerFromGetter = input.get?.('accept-language');
+    if ('string' == typeof headerFromGetter) return headerFromGetter;
+    const { headers } = input;
+    if ('object' != typeof headers || null === headers) return;
+    const get = Reflect.get(headers, 'get');
+    const header = 'function' == typeof get ? Reflect.apply(get, headers, [
+        'accept-language'
+    ]) : Reflect.get(headers, 'accept-language') ?? Reflect.get(headers, 'Accept-Language');
+    return normalizeHeaderValue(header);
+}
+function parseAcceptLanguage(acceptLanguage) {
+    const candidates = [];
+    for (const [index, value] of (acceptLanguage ?? '').split(',').entries()){
+        const [rawLocale, rawQuality] = value.split(QUALITY_PARAM_PATTERN);
+        const locale = (0, __rspack_external__contentful_optimization_core_7d4758c6.normalizeLocale)(rawLocale);
+        if (void 0 === locale) continue;
+        const parsedQuality = void 0 === rawQuality ? DEFAULT_ACCEPT_LANGUAGE_QUALITY : Number(rawQuality);
+        const quality = Number.isFinite(parsedQuality) ? parsedQuality : DEFAULT_ACCEPT_LANGUAGE_QUALITY;
+        if (quality > 0) candidates.push({
+            index,
+            locale,
+            quality
+        });
+    }
+    return candidates.sort((left, right)=>right.quality - left.quality || left.index - right.index).map((candidate)=>candidate.locale);
+}
+function getRequestLocaleCandidates(input) {
+    const parsedHeaderLocales = parseAcceptLanguage(getAcceptLanguageHeader(input));
+    if (parsedHeaderLocales.length > 0) return parsedHeaderLocales;
+    if ('object' != typeof input || null === input) return [];
+    return input.acceptsLanguages?.().map(__rspack_external__contentful_optimization_core_7d4758c6.normalizeLocale).filter((locale)=>void 0 !== locale) ?? [];
 }
 class ContentfulOptimization extends __rspack_external__contentful_optimization_core_7d4758c6.CoreStateless {
-    constructor(config){
-        const mergedConfig = mergeConfig(config);
-        super(mergedConfig);
+    constructor({ app, allowedEventTypes, eventBuilder, ...config }){
+        const { library, getConsent: _getConsent, ...eventBuilderConfig } = eventBuilder ?? {};
+        super({
+            ...config,
+            allowedEventTypes: allowedEventTypes ?? DEFAULT_NODE_ALLOWED_EVENT_TYPES,
+            eventBuilder: {
+                app,
+                channel: 'server',
+                library: {
+                    name: OPTIMIZATION_NODE_SDK_NAME,
+                    version: OPTIMIZATION_NODE_SDK_VERSION,
+                    ...library
+                },
+                getConsent: ()=>false,
+                ...eventBuilderConfig
+            }
+        });
+    }
+    resolveRequestLocale(input) {
+        const candidates = getRequestLocaleCandidates(input);
+        const eventLocale = candidates[0] ?? DEFAULT_RUNTIME_LOCALE;
+        const contentfulLocale = (0, __rspack_external__contentful_optimization_core_7d4758c6.resolveContentfulLocale)({
+            candidates,
+            contentfulLocales: this.config.contentfulLocales
+        }) ?? this.locale;
+        return void 0 === contentfulLocale ? {
+            eventLocale
+        } : {
+            eventLocale,
+            contentfulLocale
+        };
     }
 }
 const src_ContentfulOptimization = ContentfulOptimization;

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.mjs","sources":["../src/ContentfulOptimization.ts","../src/index.ts"],"sourcesContent":["import { CoreStateless } from '@contentful/optimization-core'\nimport type { App } from '@contentful/optimization-core/api-schemas'\nimport { merge } from 'es-toolkit'\nimport { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from './constants'\n\ntype CoreStatelessConfig = ConstructorParameters<typeof CoreStateless>[0]\n\n/*\n Configuration for the Node-specific ContentfulOptimization SDK.\n \n @remarks\n * This configuration extends {@link CoreStatelessConfig} but allows partial\n * overrides of the event-builder configuration. SDKs commonly inject their own\n * library metadata or channel definitions.\n \n @see {@link CoreStatelessConfig}\n \n @public\n /\nexport interface OptimizationNodeConfig extends Omit<CoreStatelessConfig, 'eventBuilder'> {\n /\n The application definition used to attribute events to a specific consumer app.\n \n @remarks\n * When not provided, events will not contain app metadata in their context.\n /\n app?: App\n\n /\n Partial overrides for the event builder configuration.\n \n @remarks\n * Any provided fields are merged with the default Node SDK metadata.\n * This differs from {@link CoreStatelessConfig} eventBuilder, which expects\n * a full configuration object.\n /\n eventBuilder?: Partial<Omit<CoreStatelessConfig['eventBuilder'], 'app'>>\n}\n\n/\n Merge user-supplied configuration with defaults for the Node SDK.\n \n @param config - The input configuration supplied by the caller.\n * @returns A fully composed {@link CoreStatelessConfig} object suitable for\n * constructing the core runtime.\n \n @remarks\n * Ensures that the Node SDK always identifies itself via a `server` channel\n * and a `library` metadata block unless explicitly overridden.\n \n @internal\n /\nfunction mergeConfig(config: OptimizationNodeConfig): CoreStatelessConfig {\n const { app, ...restConfig } = config\n\n const defaultConfig: Partial<CoreStatelessConfig> = {\n eventBuilder: {\n app,\n channel: 'server',\n library: { name: OPTIMIZATION_NODE_SDK_NAME, version: OPTIMIZATION_NODE_SDK_VERSION },\n },\n }\n return merge(defaultConfig, restConfig)\n}\n\n/\n Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.\n \n @remarks\n * This class adapts the stateless ContentfulOptimization Core for Node runtimes by\n * applying environment-appropriate defaults (e.g., server channel, Node SDK\n * library metadata). No core runtime behavior is modified; only configuration\n * defaults differ.\n \n @example\n * ```ts\n * import ContentfulOptimization from '@contentful/optimization-node'\n \n const sdk = new ContentfulOptimization({\n * clientId: 'abc-123',\n * environment: 'main',\n * logLevel: 'info',\n * })\n \n const requestOptions = { locale: 'en-US' }\n \n await sdk.track({ event: 'server_event', properties: { id: 1 } }, requestOptions)\n * ```\n \n @see {@link CoreStateless}\n \n @public\n /\nclass ContentfulOptimization extends CoreStateless {\n /\n Create an instance of the Node SDK with merged defaults.\n \n @param config - Partial Node-specific configuration. Any eventBuilder\n * fields provided are merged with Node's defaults.\n \n @example\n * ```ts\n * import ContentfulOptimization from '@contentful/optimization-node'\n \n const optimization = new ContentfulOptimization({ clientId: 'my-client-id' })\n * ```\n /\n constructor(config: OptimizationNodeConfig) {\n const mergedConfig: CoreStatelessConfig = mergeConfig(config)\n\n super(mergedConfig)\n }\n}\n\nexport default ContentfulOptimization\n","/\n Contentful ContentfulOptimization Node SDK.\n \n @remarks\n * Adds Node-specific defaults via the {@link ContentfulOptimization} class.\n * Core and transitive API exports are available from dedicated entrypoints:\n * `@contentful/optimization-node/core-sdk`,\n * `@contentful/optimization-node/api-client`,\n * and `@contentful/optimization-node/api-schemas`.\n \n @packageDocumentation\n /\n\nimport ContentfulOptimization from './ContentfulOptimization'\n\nexport { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from './constants'\nexport from './ContentfulOptimization'\n\nexport default ContentfulOptimization\n"],"names":["mergeConfig","config","app","restConfig","defaultConfig","OPTIMIZATION_NODE_SDK_NAME","OPTIMIZATION_NODE_SDK_VERSION","merge","ContentfulOptimization","CoreStateless","mergedConfig"],"mappings":";;;AAoDA,SAASA,YAAYC,MAA8B;IACjD,MAAM,EAAEC,GAAG,EAAE,GAAGC,YAAY,GAAGF;IAE/B,MAAMG,gBAA8C;QAClD,cAAc;YACZF;YACA,SAAS;YACT,SAAS;gBAAE,MAAMG;gBAA4B,SAASC;YAA8B;QACtF;IACF;IACA,OAAOC,MAAMH,eAAeD;AAC9B;AA8BA,MAAMK,+BAA+BC,yDAAAA,aAAaA;IAchD,YAAYR,MAA8B,CAAE;QAC1C,MAAMS,eAAoCV,YAAYC;QAEtD,KAAK,CAACS;IACR;AACF;AAEA,mCAAeF;AChGf,YAAeA"}
1	+ {"version":3,"file":"index.mjs","sources":["../src/ContentfulOptimization.ts","../src/index.ts"],"sourcesContent":["import {\n CoreStateless,\n normalizeLocale,\n resolveContentfulLocale,\n type CoreStatelessConfig,\n type EventType,\n} from '@contentful/optimization-core'\nimport type { App } from '@contentful/optimization-core/api-schemas'\nimport { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from './constants'\n\nconst DEFAULT_RUNTIME_LOCALE = 'en-US'\nconst DEFAULT_ACCEPT_LANGUAGE_QUALITY = 1\nconst QUALITY_PARAM_PATTERN = /;\\sq=/\nconst DEFAULT_NODE_ALLOWED_EVENT_TYPES: EventType[] = ['identify', 'page']\n\ntype NodeEventBuilderConfig = Partial<Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app'>>\ntype PublicNodeEventBuilderConfig = Omit<NodeEventBuilderConfig, 'getConsent'>\n\ninterface HeaderRequestLike {\n acceptsLanguages?: () => string[]\n get?: (name: string) => string \| null \| undefined\n headers?: unknown\n}\n\n/\n Locale pair resolved from an incoming server request.\n \n @public\n /\nexport interface ResolvedRequestLocale {\n /* Locale to place on SDK event context. /\n readonly eventLocale: string\n /* Contentful locale to use for CDA fetches and Experience API request options, when configured. /\n readonly contentfulLocale?: string\n}\n\n/\n Accepted inputs for {@link ContentfulOptimization.resolveRequestLocale}.\n \n @public\n /\nexport type RequestLocaleInput = string \| null \| undefined \| HeaderRequestLike\n\n/\n Configuration for the Node-specific ContentfulOptimization SDK.\n \n @remarks\n * This configuration extends {@link CoreStatelessConfig} but allows partial\n * overrides of the event-builder configuration. SDKs commonly inject their own\n * library metadata or channel definitions.\n \n @see {@link CoreStatelessConfig}\n \n @public\n /\nexport interface OptimizationNodeConfig extends Omit<CoreStatelessConfig, 'eventBuilder'> {\n /\n The application definition used to attribute events to a specific consumer app.\n \n @remarks\n * When not provided, events will not contain app metadata in their context.\n /\n app?: App\n\n /\n Partial overrides for the event builder configuration.\n \n @remarks\n * Any provided fields are merged with the default Node SDK metadata.\n * Request-scoped consent should be bound with `forRequest()`, not configured\n * on the SDK singleton.\n \n This differs from {@link CoreStatelessConfig} eventBuilder, which expects\n * a full configuration object.\n /\n eventBuilder?: PublicNodeEventBuilderConfig\n}\n\nfunction normalizeHeaderValue(header: unknown): string \| undefined {\n if (typeof header === 'string') {\n return header\n }\n\n return Array.isArray(header)\n ? header.filter((item): item is string => typeof item === 'string').join(',')\n : undefined\n}\n\nfunction getAcceptLanguageHeader(input: RequestLocaleInput): string \| undefined {\n if (typeof input === 'string') {\n return input\n }\n\n if (typeof input !== 'object' \|\| input === null) {\n return undefined\n }\n\n const headerFromGetter = input.get?.('accept-language')\n\n if (typeof headerFromGetter === 'string') {\n return headerFromGetter\n }\n\n const { headers } = input\n\n if (typeof headers !== 'object' \|\| headers === null) {\n return undefined\n }\n\n const get: unknown = Reflect.get(headers, 'get')\n const header: unknown =\n typeof get === 'function'\n ? Reflect.apply(get, headers, ['accept-language'])\n : (Reflect.get(headers, 'accept-language') ?? Reflect.get(headers, 'Accept-Language'))\n\n return normalizeHeaderValue(header)\n}\n\nfunction parseAcceptLanguage(acceptLanguage: string \| undefined): string[] {\n const candidates: Array<{ index: number; locale: string; quality: number }> = []\n\n for (const [index, value] of (acceptLanguage ?? '').split(',').entries()) {\n const [rawLocale, rawQuality] = value.split(QUALITY_PARAM_PATTERN)\n const locale = normalizeLocale(rawLocale)\n\n if (locale === undefined) {\n continue\n }\n\n const parsedQuality =\n rawQuality === undefined ? DEFAULT_ACCEPT_LANGUAGE_QUALITY : Number(rawQuality)\n const quality = Number.isFinite(parsedQuality) ? parsedQuality : DEFAULT_ACCEPT_LANGUAGE_QUALITY\n\n if (quality > 0) {\n candidates.push({ index, locale, quality })\n }\n }\n\n return candidates\n .sort((left, right) => right.quality - left.quality \|\| left.index - right.index)\n .map((candidate) => candidate.locale)\n}\n\nfunction getRequestLocaleCandidates(input: RequestLocaleInput): string[] {\n const parsedHeaderLocales = parseAcceptLanguage(getAcceptLanguageHeader(input))\n\n if (parsedHeaderLocales.length > 0) {\n return parsedHeaderLocales\n }\n\n if (typeof input !== 'object' \|\| input === null) {\n return []\n }\n\n return (\n input\n .acceptsLanguages?.()\n .map(normalizeLocale)\n .filter((locale): locale is string => locale !== undefined) ?? []\n )\n}\n\n/\n Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.\n \n @remarks\n * This class adapts the stateless ContentfulOptimization Core for Node runtimes by\n * applying environment-appropriate defaults (e.g., server channel, Node SDK\n * library metadata). No core runtime behavior is modified; only configuration\n * defaults differ.\n \n @example\n * ```ts\n * import ContentfulOptimization from '@contentful/optimization-node'\n \n const sdk = new ContentfulOptimization({\n * clientId: 'abc-123',\n * environment: 'main',\n * logLevel: 'info',\n * })\n \n const requestOptimization = sdk.forRequest({\n * consent: true,\n * experienceOptions: { locale: 'fr-CA' },\n * profile: { id: 'profile-id' },\n * })\n \n await requestOptimization.page()\n * ```\n \n @see {@link CoreStateless}\n \n @public\n /\nclass ContentfulOptimization extends CoreStateless {\n /\n Create an instance of the Node SDK with merged defaults.\n \n @param config - Partial Node-specific configuration. Any eventBuilder\n * fields provided are merged with Node's defaults.\n \n @example\n * ```ts\n * import ContentfulOptimization from '@contentful/optimization-node'\n \n const optimization = new ContentfulOptimization({ clientId: 'my-client-id' })\n * ```\n /\n constructor({ app, allowedEventTypes, eventBuilder, ...config }: OptimizationNodeConfig) {\n const {\n library,\n getConsent: _getConsent,\n ...eventBuilderConfig\n } = (eventBuilder ?? {}) as NodeEventBuilderConfig\n\n super({\n ...config,\n allowedEventTypes: allowedEventTypes ?? DEFAULT_NODE_ALLOWED_EVENT_TYPES,\n eventBuilder: {\n app,\n channel: 'server',\n library: {\n name: OPTIMIZATION_NODE_SDK_NAME,\n version: OPTIMIZATION_NODE_SDK_VERSION,\n ...library,\n },\n getConsent: () => false,\n ...eventBuilderConfig,\n },\n })\n }\n\n /\n Resolve request and Contentful locales from `Accept-Language`.\n \n @param input - Raw `Accept-Language` header or a request-like object.\n * @returns Event-context locale and Contentful CDA locale.\n \n @example\n * ```ts\n * const { eventLocale, contentfulLocale } = optimization.resolveRequestLocale(req)\n * ```\n /\n resolveRequestLocale(input: RequestLocaleInput): ResolvedRequestLocale {\n const candidates = getRequestLocaleCandidates(input)\n const eventLocale = candidates[0] ?? DEFAULT_RUNTIME_LOCALE\n const contentfulLocale =\n resolveContentfulLocale({\n candidates,\n contentfulLocales: this.config.contentfulLocales,\n }) ?? this.locale\n\n return contentfulLocale === undefined ? { eventLocale } : { eventLocale, contentfulLocale }\n }\n}\n\nexport default ContentfulOptimization\n","/\n Contentful ContentfulOptimization Node SDK.\n \n @remarks\n * Adds Node-specific defaults via the {@link ContentfulOptimization} class.\n * Core and transitive API exports are available from dedicated entrypoints:\n * `@contentful/optimization-node/core-sdk`,\n * `@contentful/optimization-node/api-client`,\n * and `@contentful/optimization-node/api-schemas`.\n \n @packageDocumentation\n /\n\nimport ContentfulOptimization from './ContentfulOptimization'\n\nexport { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from './constants'\nexport from './ContentfulOptimization'\n\nexport default ContentfulOptimization\n"],"names":["DEFAULT_RUNTIME_LOCALE","DEFAULT_ACCEPT_LANGUAGE_QUALITY","QUALITY_PARAM_PATTERN","DEFAULT_NODE_ALLOWED_EVENT_TYPES","normalizeHeaderValue","header","Array","item","undefined","getAcceptLanguageHeader","input","headerFromGetter","headers","get","Reflect","parseAcceptLanguage","acceptLanguage","candidates","index","value","rawLocale","rawQuality","locale","normalizeLocale","parsedQuality","Number","quality","left","right","candidate","getRequestLocaleCandidates","parsedHeaderLocales","ContentfulOptimization","CoreStateless","app","allowedEventTypes","eventBuilder","config","library","_getConsent","eventBuilderConfig","OPTIMIZATION_NODE_SDK_NAME","OPTIMIZATION_NODE_SDK_VERSION","eventLocale","contentfulLocale","resolveContentfulLocale"],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/optimization-node",
-  "version": "0.1.0-alpha12",
+  "version": "0.1.0-alpha14",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -80,13 +80,13 @@
   "buildTools": {
     "bundleSize": {
       "gzipBudgets": {
-        "index.cjs": 1200,
-        "index.mjs": 500
+        "index.cjs": 2000,
+        "index.mjs": 1500
       }
     }
   },
   "dependencies": {
-    "es-toolkit": "^1.44.0",
-    "@contentful/optimization-core": "0.1.0-alpha12"
+    "es-toolkit": "^1.45.1",
+    "@contentful/optimization-core": "0.1.0-alpha14"
   }
 }