@contentful/optimization-node 0.1.0-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2026 Contentful Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,289 @@
+<p align="center">
+  <a href="https://www.contentful.com/developers/docs/personalization/">
+    <img alt="Contentful Logo" title="Contentful" src="../../../contentful-icon.png" width="150">
+  </a>
+</p>
+
+<h1 align="center">Contentful Personalization & Analytics</h1>
+
+<h3 align="center">Optimization Node SDK</h3>
+
+<div align="center">
+
+[Readme](./README.md) · [Reference](https://contentful.github.io/optimization) ·
+[Contributing](/CONTRIBUTING.md)
+
+</div>
+
+> [!WARNING]
+>
+> The Optimization SDK Suite is currently ALPHA! Breaking changes may be published at any time.
+
+The Optimization Node SDK implements functionality specific to Node environments, based on the
+[Optimization Core Library](/universal/core/README.md). This SDK is part of the
+[Contentful Optimization SDK Suite](/README.md).
+
+<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)
+  - [Analytics Options](#analytics-options)
+  - [Event Builder Options](#event-builder-options)
+  - [Fetch Options](#fetch-options)
+  - [Personalization Options](#personalization-options)
+- [Optimization Methods](#optimization-methods)
+  - [Personalization Data Resolution Methods](#personalization-data-resolution-methods)
+    - [`getCustomFlag`](#getcustomflag)
+    - [`personalizeEntry`](#personalizeentry)
+    - [`getMergeTagValue`](#getmergetagvalue)
+  - [Personalization and Analytics Event Methods](#personalization-and-analytics-event-methods)
+    - [`identify`](#identify)
+    - [`page`](#page)
+    - [`track`](#track)
+    - [`trackComponentView`](#trackcomponentview)
+    - [`trackFlagView`](#trackflagview)
+- [Interceptors](#interceptors)
+  - [Life-cycle Interceptors](#life-cycle-interceptors)
+
+<!-- mtoc-end -->
+</details>
+
+## Getting Started
+
+Install using an NPM-compatible package manager, pnpm for example:
+
+```sh
+pnpm install @contentful/optimization-node
+```
+
+Import the Optimization class; both CJS and ESM module systems are supported, ESM preferred:
+
+```ts
+import Optimization from '@contentful/optimization-node'
+```
+
+Configure and initialize the Optimization Node SDK:
+
+```ts
+const optimization = new Optimization({ clientId: 'abc123' })
+```
+
+## 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](/implementations/node-ssr-only/README.md): Example application that uses the Node
+  SDK to render a personalized Web page
+- [Node SSR + Web Vanilla](/implementations/node-ssr-web-vanilla/README.md): Example application
+  demonstrating simple profile synchronization between the Node and [Web](../web/README.md) SDKs via
+  cookie
+
+## Configuration
+
+### Top-level Configuration Options
+
+| Option            | Required? | Default                       | Description                                                                    |
+| ----------------- | --------- | ----------------------------- | ------------------------------------------------------------------------------ |
+| `analytics`       | No        | See "Analytics Options"       | Configuration specific to the Analytics/Insights API                           |
+| `app`             | No        | `undefined`                   | The application definition used to attribute events to a specific consumer app |
+| `clientId`        | Yes       | N/A                           | The Ninetailed API Key which can be found in the Ninetailed Admin app          |
+| `environment`     | No        | `'main'`                      | The Ninetailed environment configured in the Ninetailed Admin app              |
+| `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 sin                                  |
+| `personalization` | No        | See "Personalization Options" | Configuration specific to the Personalization/Experience API                   |
+
+### Analytics Options
+
+| Option    | Required? | Default                                    | Description                   |
+| --------- | --------- | ------------------------------------------ | ----------------------------- |
+| `baseUrl` | No        | `'https://ingest.insights.ninetailed.co/'` | Base URL for the Insights API |
+
+### 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: 'Optimization Node API', 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 Optimization API Client. 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`
+
+### Personalization Options
+
+| Option            | Required? | Default                               | Description                                                         |
+| ----------------- | --------- | ------------------------------------- | ------------------------------------------------------------------- |
+| `baseUrl`         | No        | `'https://experience.ninetailed.co/'` | Base URL for the Experience API                                     |
+| `enabledFeatures` | No        | `['ip-enrichment', 'location']`       | Enabled features which the API may use for each request             |
+| `ip`              | No        | `undefined`                           | IP address to override the API behavior for IP analysis             |
+| `locale`          | No        | `'en-US'` (in API)                    | Locale used to translate `location.city` and `location.country`     |
+| `plainText`       | No        | `false`                               | Sends performance-critical endpoints in plain text                  |
+| `preflight`       | No        | `false`                               | Instructs the API to aggregate a new profile state but not store it |
+
+## Optimization Methods
+
+Arguments marked with an asterisk (\*) are always required.
+
+### Personalization Data Resolution Methods
+
+#### `getCustomFlag`
+
+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.
+
+> [!NOTE]
+>
+> If the `changes` argument is omitted, the method will return `undefined`.
+
+#### `personalizeEntry`
+
+Resolve a baseline Contentful entry to a personalized variant using the provided selected
+personalizations.
+
+Type arguments:
+
+- `S`: Entry skeleton type
+- `M`: Chain modifiers
+- `L`: Locale code
+
+Arguments:
+
+- `entry`\*: The entry to personalize
+- `personalizations`: Selected personalizations
+
+Returns:
+
+- The resolved personalized entry variant, or the supplied baseline entry if baseline is the
+  selected variant or a variant cannot be found.
+
+> [!NOTE]
+>
+> If the `personalizations` 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.
+
+### Personalization and Analytics Event Methods
+
+Each method except `trackFlagView` may return an `OptimizationData` object containing:
+
+- `changes`: Currently used for Custom Flags
+- `personalizations`: Selected personalizations for the profile
+- `profile`: Profile associated with the evaluated events
+
+#### `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`
+
+#### `page`
+
+Record a personalization page view.
+
+Arguments:
+
+- `payload`\*: Page view event builder arguments object, including an optional `profile` property
+  with a `PartialProfile` value that requires only an `id`
+
+#### `track`
+
+Record a personalization custom track event.
+
+Arguments:
+
+- `payload`\*: Track event builder arguments object, including an optional `profile` property with a
+  `PartialProfile` value that requires only an `id`
+
+#### `trackComponentView`
+
+Record an analytics component view event. When the payload marks the component as "sticky", an
+additional personalization component view is recorded. This method only returns `OptimizationData`
+when the component is marked as "sticky".
+
+Arguments:
+
+- `payload`\*: Component view event builder arguments object, including an optional `profile`
+  property with a `PartialProfile` value that requires only an `id`
+
+#### `trackFlagView`
+
+Track a feature flag view via analytics. This is functionally the same as a non-sticky component
+view event.
+
+Arguments:
+
+- `payload`\*: Component view event builder arguments object, including an optional `profile`
+  property with a `PartialProfile` value that requires only an `id`
+
+## Interceptors
+
+Interceptors may be used to read and/or modify data flowing through the Core SDK.
+
+### Life-cycle Interceptors
+
+- `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
+
+Example interceptor usage:
+
+```ts
+optimization.interceptors.event((event) => {
+  event.properties.timestamp = new Date().toISOString()
+})
+```
+
+> [!WARNING]
+>
+> Interceptors are intended to enable low-level interoperability; to simply read and react to
+> Optimization SDK events, use the `states` observables.

package/dist/index.cjs

@@ -0,0 +1,112 @@
+"use strict";
+var __webpack_modules__ = {
+    "./src/Optimization.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            A: ()=>src_Optimization
+        });
+        var optimization_core_ = __webpack_require__("@contentful/optimization-core");
+        const external_es_toolkit_namespaceObject = require("es-toolkit");
+        var global_constants = __webpack_require__("./src/global-constants.ts");
+        function mergeConfig(config) {
+            const { app, ...restConfig } = config;
+            const defaultConfig = {
+                eventBuilder: {
+                    app,
+                    channel: 'server',
+                    library: {
+                        name: 'Optimization Node API',
+                        version: global_constants.R
+                    }
+                }
+            };
+            return (0, external_es_toolkit_namespaceObject.merge)(defaultConfig, restConfig);
+        }
+        class Optimization extends optimization_core_.CoreStateless {
+            constructor(config){
+                const mergedConfig = mergeConfig(config);
+                super(mergedConfig);
+            }
+        }
+        const src_Optimization = Optimization;
+    },
+    "./src/global-constants.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            R: ()=>OPTIMIZATION_NODE_SDK_VERSION,
+            T: ()=>_contentful_optimization_core__rspack_import_0.ANONYMOUS_ID_COOKIE
+        });
+        var _contentful_optimization_core__rspack_import_0 = __webpack_require__("@contentful/optimization-core");
+        const OPTIMIZATION_NODE_SDK_VERSION = "0.1.0-alpha";
+    },
+    "@contentful/optimization-core" (module) {
+        module.exports = require("@contentful/optimization-core");
+    }
+};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+(()=>{
+    __webpack_require__.r(__webpack_exports__);
+    __webpack_require__.d(__webpack_exports__, {
+        ANONYMOUS_ID_COOKIE: ()=>_global_constants__rspack_import_2.T,
+        OPTIMIZATION_NODE_SDK_VERSION: ()=>_global_constants__rspack_import_2.R,
+        default: ()=>__rspack_default_export
+    });
+    var _Optimization__rspack_import_0 = __webpack_require__("./src/Optimization.ts");
+    var _contentful_optimization_core__rspack_import_1 = __webpack_require__("@contentful/optimization-core");
+    var __rspack_reexport = {};
+    for(const __rspack_import_key in _contentful_optimization_core__rspack_import_1)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_contentful_optimization_core__rspack_import_1[__rspack_import_key];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+    var _global_constants__rspack_import_2 = __webpack_require__("./src/global-constants.ts");
+    const __rspack_default_export = _Optimization__rspack_import_0.A;
+})();
+exports.ANONYMOUS_ID_COOKIE = __webpack_exports__.ANONYMOUS_ID_COOKIE;
+exports.OPTIMIZATION_NODE_SDK_VERSION = __webpack_exports__.OPTIMIZATION_NODE_SDK_VERSION;
+exports["default"] = __webpack_exports__["default"];
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "ANONYMOUS_ID_COOKIE",
+    "OPTIMIZATION_NODE_SDK_VERSION",
+    "default"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/Optimization.ts","../src/global-constants.ts","webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../src/index.ts"],"sourcesContent":["import { type App, type CoreStatelessConfig, CoreStateless } from '@contentful/optimization-core'\nimport { merge } from 'es-toolkit'\nimport { OPTIMIZATION_NODE_SDK_VERSION } from './global-constants'\n\n/**\n * Configuration for the Node-specific Optimization SDK.\n *\n * @public\n * @remarks\n * This configuration extends {@link CoreConfig} but allows partial overrides\n * of the event-builder configuration. SDKs commonly inject their own library\n * metadata or channel definitions.\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 CoreConfig.eventBuilder}, which expects a\n   * 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 CoreConfig} object suitable for\n *          constructing the core runtime.\n *\n * @internal\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 */\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 API', version: OPTIMIZATION_NODE_SDK_VERSION },\n    },\n  }\n  return merge(defaultConfig, restConfig)\n}\n\n/**\n * Node-specific Optimization SDK built on {@link CoreStateless}.\n *\n * @public\n * @remarks\n * This class adapts the stateless Optimization Core for Node runtimes by\n * applying environment-appropriate defaults (e.g., server channel, Node SDK\n * library metadata). No analytics or personalization behavior is modified—\n * only configuration defaults differ.\n *\n * @example\n * ```ts\n * import Optimization from '@contentful/optimization-node'\n *\n * const sdk = new Optimization({\n *   clientId: 'abc-123',\n *   environment: 'main',\n *   logLevel: 'info',\n * })\n *\n * await sdk.track({ event: 'server_event', properties: { id: 1 } })\n * ```\n */\nclass Optimization 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  constructor(config: OptimizationNodeConfig) {\n    const mergedConfig: CoreStatelessConfig = mergeConfig(config)\n\n    super(mergedConfig)\n  }\n}\n\nexport default Optimization\n","// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_VERSION__: string | undefined\n\nexport const OPTIMIZATION_NODE_SDK_VERSION =\n  typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0'\n\n/**\n * Re-export of the anonymous-ID cookie name used by the Optimization Core.\n *\n * @public\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 personalization and analytics\n * events when no explicit profile is known.\n *\n * @see {@link ANONYMOUS_ID_COOKIE} in `@contentful/optimization-core` for the\n * authoritative definition and documentation.\n *\n * @example\n * ```ts\n * import { ANONYMOUS_ID_COOKIE } from '@contentful/optimization-node'\n * const id = request.cookies[ANONYMOUS_ID_COOKIE]\n * ```\n */\nexport { ANONYMOUS_ID_COOKIE } from '@contentful/optimization-core'\n","// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\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 Optimization from './Optimization'\n\nexport * from '@contentful/optimization-core'\n\nexport * from './global-constants'\nexport * from './Optimization'\n\nexport default Optimization\n"],"names":["mergeConfig","config","app","restConfig","defaultConfig","OPTIMIZATION_NODE_SDK_VERSION","merge","Optimization","CoreStateless","mergedConfig","__OPTIMIZATION_VERSION__","__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol"],"mappings":";;;;;;;;;QA6CA,SAASA,YAAYC,MAA8B;YACjD,MAAM,EAAEC,GAAG,EAAE,GAAGC,YAAY,GAAGF;YAE/B,MAAMG,gBAA8C;gBAClD,cAAc;oBACZF;oBACA,SAAS;oBACT,SAAS;wBAAE,MAAM;wBAAyB,SAASG,iBAAAA,CAA6BA;oBAAC;gBACnF;YACF;YACA,OAAOC,AAAAA,IAAAA,oCAAAA,KAAAA,AAAAA,EAAMF,eAAeD;QAC9B;QAyBA,MAAMI,qBAAqBC,mBAAAA,aAAaA;YAOtC,YAAYP,MAA8B,CAAE;gBAC1C,MAAMQ,eAAoCT,YAAYC;gBAEtD,KAAK,CAACQ;YACR;QACF;QAEA,yBAAeF;;;;;;;;QC5FR,MAAMF,gCACoCK;;;;;;;;;;;;;;;;;ICHjDC,oBAAoB,CAAC,GAAG,CAACC;QACxB,IAAIC,SAASD,UAAUA,OAAO,UAAU,GACvC,IAAOA,MAAM,CAAC,UAAU,GACxB,IAAOA;QACRD,oBAAoB,CAAC,CAACE,QAAQ;YAAE,GAAGA;QAAO;QAC1C,OAAOA;IACR;;;ICPAF,oBAAoB,CAAC,GAAG,CAAC,UAASG;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGH,oBAAoB,CAAC,CAACG,YAAYC,QAAQ,CAACJ,oBAAoB,CAAC,CAAC,UAASI,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAJ,oBAAoB,CAAC,GAAG,CAACM,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFP,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,MAAlB,OAAOQ,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;;;;;;;ICCA,gCAAeT,+BAAAA,CAAYA"}

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+import { ANONYMOUS_ID_COOKIE } from '@contentful/optimization-core';
+import { App } from '@contentful/optimization-core';
+import { CoreStateless } from '@contentful/optimization-core';
+import { CoreStatelessConfig } from '@contentful/optimization-core';
+
+export { ANONYMOUS_ID_COOKIE }
+
+/**
+ * Node-specific Optimization SDK built on {@link CoreStateless}.
+ *
+ * @public
+ * @remarks
+ * This class adapts the stateless Optimization Core for Node runtimes by
+ * applying environment-appropriate defaults (e.g., server channel, Node SDK
+ * library metadata). No analytics or personalization behavior is modified—
+ * only configuration defaults differ.
+ *
+ * @example
+ * ```ts
+ * import Optimization from '@contentful/optimization-node'
+ *
+ * const sdk = new Optimization({
+ *   clientId: 'abc-123',
+ *   environment: 'main',
+ *   logLevel: 'info',
+ * })
+ *
+ * await sdk.track({ event: 'server_event', properties: { id: 1 } })
+ * ```
+ */
+declare class Optimization extends CoreStateless {
+    /**
+     * Create an instance of the Node SDK with merged defaults.
+     *
+     * @param config - Partial Node-specific configuration. Any eventBuilder
+     *                 fields provided are merged with Node's defaults.
+     */
+    constructor(config: OptimizationNodeConfig);
+}
+export default Optimization;
+
+export declare const OPTIMIZATION_NODE_SDK_VERSION: string;
+
+/**
+ * Configuration for the Node-specific Optimization SDK.
+ *
+ * @public
+ * @remarks
+ * This configuration extends {@link CoreConfig} but allows partial overrides
+ * of the event-builder configuration. SDKs commonly inject their own library
+ * metadata or channel definitions.
+ */
+export declare interface OptimizationNodeConfig extends Omit<CoreStatelessConfig, 'eventBuilder'> {
+    /**
+     * The application definition used to attribute events to a specific consumer app.
+     *
+     * @remarks
+     * When not provided, events will not contain app metadata in their context.
+     */
+    app?: App;
+    /**
+     * Partial overrides for the event builder configuration.
+     *
+     * @remarks
+     * Any provided fields are merged with the default Node SDK metadata.
+     * This differs from {@link CoreConfig.eventBuilder}, which expects a
+     * full configuration object.
+     */
+    eventBuilder?: Partial<Omit<CoreStatelessConfig['eventBuilder'], 'app'>>;
+}
+
+
+export * from "@contentful/optimization-core";
+
+export { }

package/dist/index.mjs

@@ -0,0 +1,31 @@
+import * as __rspack_external__contentful_optimization_core_7d4758c6 from "@contentful/optimization-core";
+import { merge } from "es-toolkit";
+const OPTIMIZATION_NODE_SDK_VERSION = "0.1.0-alpha";
+function mergeConfig(config) {
+    const { app, ...restConfig } = config;
+    const defaultConfig = {
+        eventBuilder: {
+            app,
+            channel: 'server',
+            library: {
+                name: 'Optimization Node API',
+                version: OPTIMIZATION_NODE_SDK_VERSION
+            }
+        }
+    };
+    return merge(defaultConfig, restConfig);
+}
+class Optimization extends __rspack_external__contentful_optimization_core_7d4758c6.CoreStateless {
+    constructor(config){
+        const mergedConfig = mergeConfig(config);
+        super(mergedConfig);
+    }
+}
+const src_Optimization = Optimization;
+const src = src_Optimization;
+var ANONYMOUS_ID_COOKIE = __rspack_external__contentful_optimization_core_7d4758c6.ANONYMOUS_ID_COOKIE;
+export * from "@contentful/optimization-core";
+export default src;
+export { ANONYMOUS_ID_COOKIE, OPTIMIZATION_NODE_SDK_VERSION };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/global-constants.ts","../src/Optimization.ts","../src/index.ts"],"sourcesContent":["// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_VERSION__: string | undefined\n\nexport const OPTIMIZATION_NODE_SDK_VERSION =\n  typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0'\n\n/**\n * Re-export of the anonymous-ID cookie name used by the Optimization Core.\n *\n * @public\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 personalization and analytics\n * events when no explicit profile is known.\n *\n * @see {@link ANONYMOUS_ID_COOKIE} in `@contentful/optimization-core` for the\n * authoritative definition and documentation.\n *\n * @example\n * ```ts\n * import { ANONYMOUS_ID_COOKIE } from '@contentful/optimization-node'\n * const id = request.cookies[ANONYMOUS_ID_COOKIE]\n * ```\n */\nexport { ANONYMOUS_ID_COOKIE } from '@contentful/optimization-core'\n","import { type App, type CoreStatelessConfig, CoreStateless } from '@contentful/optimization-core'\nimport { merge } from 'es-toolkit'\nimport { OPTIMIZATION_NODE_SDK_VERSION } from './global-constants'\n\n/**\n * Configuration for the Node-specific Optimization SDK.\n *\n * @public\n * @remarks\n * This configuration extends {@link CoreConfig} but allows partial overrides\n * of the event-builder configuration. SDKs commonly inject their own library\n * metadata or channel definitions.\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 CoreConfig.eventBuilder}, which expects a\n   * 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 CoreConfig} object suitable for\n *          constructing the core runtime.\n *\n * @internal\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 */\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 API', version: OPTIMIZATION_NODE_SDK_VERSION },\n    },\n  }\n  return merge(defaultConfig, restConfig)\n}\n\n/**\n * Node-specific Optimization SDK built on {@link CoreStateless}.\n *\n * @public\n * @remarks\n * This class adapts the stateless Optimization Core for Node runtimes by\n * applying environment-appropriate defaults (e.g., server channel, Node SDK\n * library metadata). No analytics or personalization behavior is modified—\n * only configuration defaults differ.\n *\n * @example\n * ```ts\n * import Optimization from '@contentful/optimization-node'\n *\n * const sdk = new Optimization({\n *   clientId: 'abc-123',\n *   environment: 'main',\n *   logLevel: 'info',\n * })\n *\n * await sdk.track({ event: 'server_event', properties: { id: 1 } })\n * ```\n */\nclass Optimization 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  constructor(config: OptimizationNodeConfig) {\n    const mergedConfig: CoreStatelessConfig = mergeConfig(config)\n\n    super(mergedConfig)\n  }\n}\n\nexport default Optimization\n","import Optimization from './Optimization'\n\nexport * from '@contentful/optimization-core'\n\nexport * from './global-constants'\nexport * from './Optimization'\n\nexport default Optimization\n"],"names":["OPTIMIZATION_NODE_SDK_VERSION","__OPTIMIZATION_VERSION__","mergeConfig","config","app","restConfig","defaultConfig","merge","Optimization","CoreStateless","mergedConfig"],"mappings":";;AAGO,MAAMA,gCACoCC;ACyCjD,SAASC,YAAYC,MAA8B;IACjD,MAAM,EAAEC,GAAG,EAAE,GAAGC,YAAY,GAAGF;IAE/B,MAAMG,gBAA8C;QAClD,cAAc;YACZF;YACA,SAAS;YACT,SAAS;gBAAE,MAAM;gBAAyB,SAASJ;YAA8B;QACnF;IACF;IACA,OAAOO,MAAMD,eAAeD;AAC9B;AAyBA,MAAMG,qBAAqBC,yDAAAA,aAAaA;IAOtC,YAAYN,MAA8B,CAAE;QAC1C,MAAMO,eAAoCR,YAAYC;QAEtD,KAAK,CAACO;IACR;AACF;AAEA,yBAAeF;ACxFf,YAAeA"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@contentful/optimization-node",
+  "version": "0.1.0-alpha",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "dependencies": {
+    "es-toolkit": "^1.39.10",
+    "@contentful/optimization-core": "0.1.0-alpha"
+  }
+}