@contentful/optimization-node 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://www.contentful.com/developers/docs/personalization/">
-    <img alt="Contentful Logo" title="Contentful" src="https://raw.githubusercontent.com/contentful/optimization/optimization-node-v1.0.0/contentful-icon.png" width="150">
+    <img alt="Contentful Logo" title="Contentful" src="https://raw.githubusercontent.com/contentful/optimization/optimization-node-v1.1.0/contentful-icon.png" width="150">
   </a>
 </p>
 
@@ -11,16 +11,12 @@
 <div align="center">
 
 [Guides](https://contentful.github.io/optimization/documents/Documentation.Guides.html) ·
-[Reference](https://contentful.github.io/optimization) · [Contributing](https://github.com/contentful/optimization/blob/optimization-node-v1.0.0/CONTRIBUTING.md)
+[Reference](https://contentful.github.io/optimization) · [Contributing](https://github.com/contentful/optimization/blob/optimization-node-v1.1.0/CONTRIBUTING.md)
 
 </div>
 
-> [!WARNING]
->
-> The Optimization SDK Suite is pre-release (alpha). Breaking changes can be published at any time.
-
 The Optimization Node SDK implements stateless server-side optimization behavior on top of the
-[Optimization Core SDK](https://github.com/contentful/optimization/blob/optimization-node-v1.0.0/packages/universal/core-sdk/README.md). Use it for server rendering, server
+[Optimization Core SDK](https://github.com/contentful/optimization/blob/optimization-node-v1.1.0/packages/universal/core-sdk/README.md). Use it for server rendering, server
 functions, and Node services that need request-scoped profile evaluation or event emission.
 
 If you are integrating a Node application, start with [Getting Started](#getting-started), then use
@@ -108,7 +104,7 @@ are part of the same application.
 
 The Node SDK is stateless. It does not maintain consent, profile, or browser persistence state
 between requests. For cross-SDK consent guidance, see
-[Consent management in the Optimization SDK Suite](https://github.com/contentful/optimization/blob/optimization-node-v1.0.0/documentation/concepts/consent-management-in-the-optimization-sdk-suite.md).
+[Consent management in the Optimization SDK Suite](https://github.com/contentful/optimization/blob/optimization-node-v1.1.0/documentation/concepts/consent-management-in-the-optimization-sdk-suite.md).
 
 | Option              | Required? | Default                | Description                                                 |
 | ------------------- | --------- | ---------------------- | ----------------------------------------------------------- |
@@ -312,9 +308,9 @@ package directory.
   step-by-step server-side integration guide
 - [Node SDK generated reference](https://contentful.github.io/optimization/modules/_contentful_optimization-node.html) -
   exported API reference
-- [Node reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v1.0.0/implementations/node-sdk/README.md) - server-rendered
+- [Node reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v1.1.0/implementations/node-sdk/README.md) - server-rendered
   implementation using request-scoped SDK calls
-- [Node + Web reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v1.0.0/implementations/node-sdk+web-sdk/README.md) -
+- [Node + Web reference implementation](https://github.com/contentful/optimization/blob/optimization-node-v1.1.0/implementations/node-sdk+web-sdk/README.md) -
   hybrid SSR and browser implementation
-- [Optimization Web SDK](https://github.com/contentful/optimization/blob/optimization-node-v1.0.0/packages/web/web-sdk/README.md) - browser SDK used when the same application
+- [Optimization Web SDK](https://github.com/contentful/optimization/blob/optimization-node-v1.1.0/packages/web/web-sdk/README.md) - browser SDK used when the same application
   also needs client-side consent, persistence, tracking, or live updates

package/THIRD_PARTY_NOTICES.txt

@@ -464,31 +464,6 @@ SOFTWARE.
 
 ---
 
-The following software may be included in this product: debug (4.3.7)
-This software contains the following license and notice below:
-
-(The MIT License)
-
-Copyright (c) 2014-2017 TJ Holowaychuk <tj@vision-media.ca>
-Copyright (c) 2018-2021 Josh Junon
-
-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.
-
----
-
 The following software may be included in this product: debug (4.4.3)
 This software contains the following license and notice below:
 
@@ -917,6 +892,21 @@ SOFTWARE.
 
 ---
 
+The following software may be included in this product: has-flag (4.0.0)
+This software contains the following license and notice below:
+
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+
+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.
+
+---
+
 The following software may be included in this product: has-symbols (1.1.0)
 This software contains the following license and notice below:
 
@@ -1446,6 +1436,21 @@ SOFTWARE.
 
 ---
 
+The following software may be included in this product: supports-color (8.1.1)
+This software contains the following license and notice below:
+
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+
+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.
+
+---
+
 The following software may be included in this product: zod (4.3.6)
 This software contains the following license and notice below:
 

package/dist/260.mjs

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

package/dist/constants.cjs

@@ -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 = "1.0.0";
+const OPTIMIZATION_NODE_SDK_VERSION = "1.1.0";
 const OPTIMIZATION_NODE_SDK_NAME = "@contentful/optimization-node";
 exports.ANONYMOUS_ID_COOKIE = __webpack_exports__.ANONYMOUS_ID_COOKIE;
 exports.ANONYMOUS_ID_KEY = __webpack_exports__.ANONYMOUS_ID_KEY;

package/dist/index.cjs

@@ -6,7 +6,7 @@ var __webpack_modules__ = {
             OPTIMIZATION_NODE_SDK_VERSION: ()=>OPTIMIZATION_NODE_SDK_VERSION
         });
         require("@contentful/optimization-core/constants");
-        const OPTIMIZATION_NODE_SDK_VERSION = "1.0.0";
+        const OPTIMIZATION_NODE_SDK_VERSION = "1.1.0";
         const OPTIMIZATION_NODE_SDK_NAME = "@contentful/optimization-node";
     }
 };
@@ -46,8 +46,9 @@ var __webpack_exports__ = {};
     __webpack_require__.r(__webpack_exports__);
     __webpack_require__.d(__webpack_exports__, {
         OPTIMIZATION_NODE_SDK_NAME: ()=>constants.OPTIMIZATION_NODE_SDK_NAME,
+        default: ()=>src,
         OPTIMIZATION_NODE_SDK_VERSION: ()=>constants.OPTIMIZATION_NODE_SDK_VERSION,
-        default: ()=>src
+        createRequestHandoffFromData: ()=>createRequestHandoffFromData
     });
     const optimization_core_namespaceObject = require("@contentful/optimization-core");
     var constants = __webpack_require__("./src/constants.ts");
@@ -76,14 +77,41 @@ var __webpack_exports__ = {};
         }
     }
     const src_ContentfulOptimization = ContentfulOptimization;
+    function assertRequestHandoffCacheMetadata(cache) {
+        if ('private-request' === cache.scope) return;
+        throw new TypeError('Request handoffs must use private-request cache scope. Use public permutation handoffs for public cache scopes, or a non-request handoff for static output.');
+    }
+    function createRequestHandoffFromData(input) {
+        const cache = input.cache ?? {
+            scope: 'private-request'
+        };
+        assertRequestHandoffCacheMetadata(cache);
+        const handoff = {
+            cache,
+            ...void 0 === input.entries ? {} : {
+                entries: input.entries
+            },
+            ...void 0 === input.data ? {} : {
+                state: {
+                    selectedOptimizations: input.data.selectedOptimizations,
+                    changes: input.data.changes,
+                    profile: input.data.profile
+                }
+            }
+        };
+        (0, optimization_core_namespaceObject.assertOptimizationCacheSafety)(handoff);
+        return handoff;
+    }
     const src = src_ContentfulOptimization;
 })();
 exports.OPTIMIZATION_NODE_SDK_NAME = __webpack_exports__.OPTIMIZATION_NODE_SDK_NAME;
 exports.OPTIMIZATION_NODE_SDK_VERSION = __webpack_exports__.OPTIMIZATION_NODE_SDK_VERSION;
+exports.createRequestHandoffFromData = __webpack_exports__.createRequestHandoffFromData;
 exports["default"] = __webpack_exports__["default"];
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "OPTIMIZATION_NODE_SDK_NAME",
     "OPTIMIZATION_NODE_SDK_VERSION",
+    "createRequestHandoffFromData",
     "default"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/index.cjs.map

@@ -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 {\n  CoreStateless,\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_NODE_ALLOWED_EVENT_TYPES: EventType[] = ['identify', 'page']\n\n/**\n * Public Node event-builder overrides accepted by {@link OptimizationNodeConfig.eventBuilder}.\n *\n * @remarks\n * Request-scoped consent is bound with {@link ContentfulOptimization.forRequest}, so `getConsent`\n * is intentionally omitted from singleton SDK configuration.\n *\n * @public\n */\nexport type PublicNodeEventBuilderConfig = Partial<\n  Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app' | 'getConsent'>\n>\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\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 *   locale: 'fr-CA',\n *   profile: { id: 'profile-id' },\n * })\n *\n * const { accepted, data } = 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 { library, ...eventBuilderConfig } = eventBuilder ?? {}\n\n    super({\n      ...config,\n      allowedEventTypes: allowedEventTypes ?? DEFAULT_NODE_ALLOWED_EVENT_TYPES,\n      eventBuilder: {\n        app,\n        channel: 'server',\n        ...eventBuilderConfig,\n        library: {\n          name: OPTIMIZATION_NODE_SDK_NAME,\n          version: OPTIMIZATION_NODE_SDK_VERSION,\n          ...library,\n        },\n        getConsent: () => false,\n      },\n    })\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_NODE_ALLOWED_EVENT_TYPES","ContentfulOptimization","CoreStateless","app","allowedEventTypes","eventBuilder","config","library","eventBuilderConfig"],"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;;;;;;;;;;;;ICEA,MAAMI,mCAAgD;QAAC;QAAY;KAAO;IAkF1E,MAAMC,+BAA+BC,kCAAAA,aAAaA;QAchD,YAAY,EAAEC,GAAG,EAAEC,iBAAiB,EAAEC,YAAY,EAAE,GAAGC,QAAgC,CAAE;YACvF,MAAM,EAAEC,OAAO,EAAE,GAAGC,oBAAoB,GAAGH,gBAAgB,CAAC;YAE5D,KAAK,CAAC;gBACJ,GAAGC,MAAM;gBACT,mBAAmBF,qBAAqBJ;gBACxC,cAAc;oBACZG;oBACA,SAAS;oBACT,GAAGK,kBAAkB;oBACrB,SAAS;wBACP,MAAMjB,UAAAA,0BAA0BA;wBAChC,SAASF,UAAAA,6BAA6BA;wBACtC,GAAGkB,OAAO;oBACZ;oBACA,YAAY,IAAM;gBACpB;YACF;QACF;IACF;IAEA,mCAAeN;IC3Gf,YAAeA"}
+{"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/handoff.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  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_NODE_ALLOWED_EVENT_TYPES: EventType[] = ['identify', 'page']\n\n/**\n * Public Node event-builder overrides accepted by {@link OptimizationNodeConfig.eventBuilder}.\n *\n * @remarks\n * Request-scoped consent is bound with {@link ContentfulOptimization.forRequest}, so `getConsent`\n * is intentionally omitted from singleton SDK configuration.\n *\n * @public\n */\nexport type PublicNodeEventBuilderConfig = Partial<\n  Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app' | 'getConsent'>\n>\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\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 *   locale: 'fr-CA',\n *   profile: { id: 'profile-id' },\n * })\n *\n * const { accepted, data } = 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 { library, ...eventBuilderConfig } = eventBuilder ?? {}\n\n    super({\n      ...config,\n      allowedEventTypes: allowedEventTypes ?? DEFAULT_NODE_ALLOWED_EVENT_TYPES,\n      eventBuilder: {\n        app,\n        channel: 'server',\n        ...eventBuilderConfig,\n        library: {\n          name: OPTIMIZATION_NODE_SDK_NAME,\n          version: OPTIMIZATION_NODE_SDK_VERSION,\n          ...library,\n        },\n        getConsent: () => false,\n      },\n    })\n  }\n}\n\nexport default ContentfulOptimization\n","import {\n  assertOptimizationCacheSafety,\n  type ManagedEntryHandoff,\n  type OptimizationCacheMetadata,\n  type OptimizationData,\n  type OptimizationHandoff,\n  type PrivateRequestOptimizationCacheMetadata,\n} from '@contentful/optimization-core'\n\nfunction assertRequestHandoffCacheMetadata(\n  cache: OptimizationCacheMetadata,\n): asserts cache is PrivateRequestOptimizationCacheMetadata {\n  if (cache.scope === 'private-request') return\n\n  throw new TypeError(\n    'Request handoffs must use private-request cache scope. Use public permutation handoffs for public cache scopes, or a non-request handoff for static output.',\n  )\n}\n\n/**\n * Create a framework-neutral handoff from completed Node request optimization data.\n *\n * @remarks\n * This helper serializes data that a caller already received from a request-bound Experience call.\n * It does not emit page or analytics events.\n *\n * @public\n */\nexport function createRequestHandoffFromData(input: {\n  readonly data?: OptimizationData\n  readonly entries?: readonly ManagedEntryHandoff[]\n  readonly cache?: PrivateRequestOptimizationCacheMetadata\n}): OptimizationHandoff {\n  const cache: PrivateRequestOptimizationCacheMetadata = input.cache ?? { scope: 'private-request' }\n  assertRequestHandoffCacheMetadata(cache)\n\n  const handoff: OptimizationHandoff = {\n    cache,\n    ...(input.entries === undefined ? {} : { entries: input.entries }),\n    ...(input.data === undefined\n      ? {}\n      : {\n          state: {\n            selectedOptimizations: input.data.selectedOptimizations,\n            changes: input.data.changes,\n            profile: input.data.profile,\n          },\n        }),\n  }\n\n  assertOptimizationCacheSafety(handoff)\n\n  return handoff\n}\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'\nexport * from './handoff'\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_NODE_ALLOWED_EVENT_TYPES","ContentfulOptimization","CoreStateless","app","allowedEventTypes","eventBuilder","config","library","eventBuilderConfig","assertRequestHandoffCacheMetadata","cache","TypeError","createRequestHandoffFromData","input","handoff","undefined","assertOptimizationCacheSafety"],"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;;;;;;;;;;;;;ICEA,MAAMI,mCAAgD;QAAC;QAAY;KAAO;IAkF1E,MAAMC,+BAA+BC,kCAAAA,aAAaA;QAchD,YAAY,EAAEC,GAAG,EAAEC,iBAAiB,EAAEC,YAAY,EAAE,GAAGC,QAAgC,CAAE;YACvF,MAAM,EAAEC,OAAO,EAAE,GAAGC,oBAAoB,GAAGH,gBAAgB,CAAC;YAE5D,KAAK,CAAC;gBACJ,GAAGC,MAAM;gBACT,mBAAmBF,qBAAqBJ;gBACxC,cAAc;oBACZG;oBACA,SAAS;oBACT,GAAGK,kBAAkB;oBACrB,SAAS;wBACP,MAAMjB,UAAAA,0BAA0BA;wBAChC,SAASF,UAAAA,6BAA6BA;wBACtC,GAAGkB,OAAO;oBACZ;oBACA,YAAY,IAAM;gBACpB;YACF;QACF;IACF;IAEA,mCAAeN;ICpHf,SAASQ,kCACPC,KAAgC;QAEhC,IAAIA,AAAgB,sBAAhBA,MAAM,KAAK,EAAwB;QAEvC,MAAM,IAAIC,UACR;IAEJ;IAWO,SAASC,6BAA6BC,KAI5C;QACC,MAAMH,QAAiDG,MAAM,KAAK,IAAI;YAAE,OAAO;QAAkB;QACjGJ,kCAAkCC;QAElC,MAAMI,UAA+B;YACnCJ;YACA,GAAIG,AAAkBE,WAAlBF,MAAM,OAAO,GAAiB,CAAC,IAAI;gBAAE,SAASA,MAAM,OAAO;YAAC,CAAC;YACjE,GAAIA,AAAeE,WAAfF,MAAM,IAAI,GACV,CAAC,IACD;gBACE,OAAO;oBACL,uBAAuBA,MAAM,IAAI,CAAC,qBAAqB;oBACvD,SAASA,MAAM,IAAI,CAAC,OAAO;oBAC3B,SAASA,MAAM,IAAI,CAAC,OAAO;gBAC7B;YACF,CAAC;QACP;QAEAG,IAAAA,kCAAAA,6BAAAA,AAAAA,EAA8BF;QAE9B,OAAOA;IACT;IClCA,YAAeb"}

package/dist/index.d.cts

@@ -14,6 +14,10 @@
 import type { App } from '@contentful/optimization-core/api-schemas';
 import { CoreStateless } from '@contentful/optimization-core';
 import { CoreStatelessConfig } from '@contentful/optimization-core';
+import { ManagedEntryHandoff } from '@contentful/optimization-core';
+import { OptimizationData } from '@contentful/optimization-core';
+import { OptimizationHandoff } from '@contentful/optimization-core';
+import { PrivateRequestOptimizationCacheMetadata } from '@contentful/optimization-core';
 
 /**
  * Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.
@@ -65,6 +69,21 @@ declare class ContentfulOptimization extends CoreStateless {
 }
 export default ContentfulOptimization;
 
+/**
+ * Create a framework-neutral handoff from completed Node request optimization data.
+ *
+ * @remarks
+ * This helper serializes data that a caller already received from a request-bound Experience call.
+ * It does not emit page or analytics events.
+ *
+ * @public
+ */
+export declare function createRequestHandoffFromData(input: {
+    readonly data?: OptimizationData;
+    readonly entries?: readonly ManagedEntryHandoff[];
+    readonly cache?: PrivateRequestOptimizationCacheMetadata;
+}): OptimizationHandoff;
+
 /**
  * The package name of the Optimization Node SDK, injected at build-time.
  *

package/dist/index.d.mts

@@ -14,6 +14,10 @@
 import type { App } from '@contentful/optimization-core/api-schemas';
 import { CoreStateless } from '@contentful/optimization-core';
 import { CoreStatelessConfig } from '@contentful/optimization-core';
+import { ManagedEntryHandoff } from '@contentful/optimization-core';
+import { OptimizationData } from '@contentful/optimization-core';
+import { OptimizationHandoff } from '@contentful/optimization-core';
+import { PrivateRequestOptimizationCacheMetadata } from '@contentful/optimization-core';
 
 /**
  * Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.
@@ -65,6 +69,21 @@ declare class ContentfulOptimization extends CoreStateless {
 }
 export default ContentfulOptimization;
 
+/**
+ * Create a framework-neutral handoff from completed Node request optimization data.
+ *
+ * @remarks
+ * This helper serializes data that a caller already received from a request-bound Experience call.
+ * It does not emit page or analytics events.
+ *
+ * @public
+ */
+export declare function createRequestHandoffFromData(input: {
+    readonly data?: OptimizationData;
+    readonly entries?: readonly ManagedEntryHandoff[];
+    readonly cache?: PrivateRequestOptimizationCacheMetadata;
+}): OptimizationHandoff;
+
 /**
  * The package name of the Optimization Node SDK, injected at build-time.
  *

package/dist/index.d.ts

@@ -14,6 +14,10 @@
 import type { App } from '@contentful/optimization-core/api-schemas';
 import { CoreStateless } from '@contentful/optimization-core';
 import { CoreStatelessConfig } from '@contentful/optimization-core';
+import { ManagedEntryHandoff } from '@contentful/optimization-core';
+import { OptimizationData } from '@contentful/optimization-core';
+import { OptimizationHandoff } from '@contentful/optimization-core';
+import { PrivateRequestOptimizationCacheMetadata } from '@contentful/optimization-core';
 
 /**
  * Node-specific ContentfulOptimization SDK built on {@link CoreStateless}.
@@ -65,6 +69,21 @@ declare class ContentfulOptimization extends CoreStateless {
 }
 export default ContentfulOptimization;
 
+/**
+ * Create a framework-neutral handoff from completed Node request optimization data.
+ *
+ * @remarks
+ * This helper serializes data that a caller already received from a request-bound Experience call.
+ * It does not emit page or analytics events.
+ *
+ * @public
+ */
+export declare function createRequestHandoffFromData(input: {
+    readonly data?: OptimizationData;
+    readonly entries?: readonly ManagedEntryHandoff[];
+    readonly cache?: PrivateRequestOptimizationCacheMetadata;
+}): OptimizationHandoff;
+
 /**
  * The package name of the Optimization Node SDK, injected at build-time.
  *

package/dist/index.mjs

@@ -25,8 +25,34 @@ class ContentfulOptimization extends __rspack_external__contentful_optimization_
     }
 }
 const src_ContentfulOptimization = ContentfulOptimization;
+function assertRequestHandoffCacheMetadata(cache) {
+    if ('private-request' === cache.scope) return;
+    throw new TypeError('Request handoffs must use private-request cache scope. Use public permutation handoffs for public cache scopes, or a non-request handoff for static output.');
+}
+function createRequestHandoffFromData(input) {
+    const cache = input.cache ?? {
+        scope: 'private-request'
+    };
+    assertRequestHandoffCacheMetadata(cache);
+    const handoff = {
+        cache,
+        ...void 0 === input.entries ? {} : {
+            entries: input.entries
+        },
+        ...void 0 === input.data ? {} : {
+            state: {
+                selectedOptimizations: input.data.selectedOptimizations,
+                changes: input.data.changes,
+                profile: input.data.profile
+            }
+        }
+    };
+    (0, __rspack_external__contentful_optimization_core_7d4758c6.assertOptimizationCacheSafety)(handoff);
+    return handoff;
+}
 const src = src_ContentfulOptimization;
 export { OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION } from "./260.mjs";
 export default src;
+export { createRequestHandoffFromData };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/ContentfulOptimization.ts","../src/index.ts"],"sourcesContent":["import {\n  CoreStateless,\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_NODE_ALLOWED_EVENT_TYPES: EventType[] = ['identify', 'page']\n\n/**\n * Public Node event-builder overrides accepted by {@link OptimizationNodeConfig.eventBuilder}.\n *\n * @remarks\n * Request-scoped consent is bound with {@link ContentfulOptimization.forRequest}, so `getConsent`\n * is intentionally omitted from singleton SDK configuration.\n *\n * @public\n */\nexport type PublicNodeEventBuilderConfig = Partial<\n  Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app' | 'getConsent'>\n>\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\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 *   locale: 'fr-CA',\n *   profile: { id: 'profile-id' },\n * })\n *\n * const { accepted, data } = 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 { library, ...eventBuilderConfig } = eventBuilder ?? {}\n\n    super({\n      ...config,\n      allowedEventTypes: allowedEventTypes ?? DEFAULT_NODE_ALLOWED_EVENT_TYPES,\n      eventBuilder: {\n        app,\n        channel: 'server',\n        ...eventBuilderConfig,\n        library: {\n          name: OPTIMIZATION_NODE_SDK_NAME,\n          version: OPTIMIZATION_NODE_SDK_VERSION,\n          ...library,\n        },\n        getConsent: () => false,\n      },\n    })\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_NODE_ALLOWED_EVENT_TYPES","ContentfulOptimization","CoreStateless","app","allowedEventTypes","eventBuilder","config","library","eventBuilderConfig","OPTIMIZATION_NODE_SDK_NAME","OPTIMIZATION_NODE_SDK_VERSION"],"mappings":";;AAQA,MAAMA,mCAAgD;IAAC;IAAY;CAAO;AAkF1E,MAAMC,+BAA+BC,yDAAAA,aAAaA;IAchD,YAAY,EAAEC,GAAG,EAAEC,iBAAiB,EAAEC,YAAY,EAAE,GAAGC,QAAgC,CAAE;QACvF,MAAM,EAAEC,OAAO,EAAE,GAAGC,oBAAoB,GAAGH,gBAAgB,CAAC;QAE5D,KAAK,CAAC;YACJ,GAAGC,MAAM;YACT,mBAAmBF,qBAAqBJ;YACxC,cAAc;gBACZG;gBACA,SAAS;gBACT,GAAGK,kBAAkB;gBACrB,SAAS;oBACP,MAAMC;oBACN,SAASC;oBACT,GAAGH,OAAO;gBACZ;gBACA,YAAY,IAAM;YACpB;QACF;IACF;AACF;AAEA,mCAAeN;AC3Gf,YAAeA"}
+{"version":3,"file":"index.mjs","sources":["../src/ContentfulOptimization.ts","../src/handoff.ts","../src/index.ts"],"sourcesContent":["import {\n  CoreStateless,\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_NODE_ALLOWED_EVENT_TYPES: EventType[] = ['identify', 'page']\n\n/**\n * Public Node event-builder overrides accepted by {@link OptimizationNodeConfig.eventBuilder}.\n *\n * @remarks\n * Request-scoped consent is bound with {@link ContentfulOptimization.forRequest}, so `getConsent`\n * is intentionally omitted from singleton SDK configuration.\n *\n * @public\n */\nexport type PublicNodeEventBuilderConfig = Partial<\n  Omit<NonNullable<CoreStatelessConfig['eventBuilder']>, 'app' | 'getConsent'>\n>\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\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 *   locale: 'fr-CA',\n *   profile: { id: 'profile-id' },\n * })\n *\n * const { accepted, data } = 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 { library, ...eventBuilderConfig } = eventBuilder ?? {}\n\n    super({\n      ...config,\n      allowedEventTypes: allowedEventTypes ?? DEFAULT_NODE_ALLOWED_EVENT_TYPES,\n      eventBuilder: {\n        app,\n        channel: 'server',\n        ...eventBuilderConfig,\n        library: {\n          name: OPTIMIZATION_NODE_SDK_NAME,\n          version: OPTIMIZATION_NODE_SDK_VERSION,\n          ...library,\n        },\n        getConsent: () => false,\n      },\n    })\n  }\n}\n\nexport default ContentfulOptimization\n","import {\n  assertOptimizationCacheSafety,\n  type ManagedEntryHandoff,\n  type OptimizationCacheMetadata,\n  type OptimizationData,\n  type OptimizationHandoff,\n  type PrivateRequestOptimizationCacheMetadata,\n} from '@contentful/optimization-core'\n\nfunction assertRequestHandoffCacheMetadata(\n  cache: OptimizationCacheMetadata,\n): asserts cache is PrivateRequestOptimizationCacheMetadata {\n  if (cache.scope === 'private-request') return\n\n  throw new TypeError(\n    'Request handoffs must use private-request cache scope. Use public permutation handoffs for public cache scopes, or a non-request handoff for static output.',\n  )\n}\n\n/**\n * Create a framework-neutral handoff from completed Node request optimization data.\n *\n * @remarks\n * This helper serializes data that a caller already received from a request-bound Experience call.\n * It does not emit page or analytics events.\n *\n * @public\n */\nexport function createRequestHandoffFromData(input: {\n  readonly data?: OptimizationData\n  readonly entries?: readonly ManagedEntryHandoff[]\n  readonly cache?: PrivateRequestOptimizationCacheMetadata\n}): OptimizationHandoff {\n  const cache: PrivateRequestOptimizationCacheMetadata = input.cache ?? { scope: 'private-request' }\n  assertRequestHandoffCacheMetadata(cache)\n\n  const handoff: OptimizationHandoff = {\n    cache,\n    ...(input.entries === undefined ? {} : { entries: input.entries }),\n    ...(input.data === undefined\n      ? {}\n      : {\n          state: {\n            selectedOptimizations: input.data.selectedOptimizations,\n            changes: input.data.changes,\n            profile: input.data.profile,\n          },\n        }),\n  }\n\n  assertOptimizationCacheSafety(handoff)\n\n  return handoff\n}\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'\nexport * from './handoff'\n\nexport default ContentfulOptimization\n"],"names":["DEFAULT_NODE_ALLOWED_EVENT_TYPES","ContentfulOptimization","CoreStateless","app","allowedEventTypes","eventBuilder","config","library","eventBuilderConfig","OPTIMIZATION_NODE_SDK_NAME","OPTIMIZATION_NODE_SDK_VERSION","assertRequestHandoffCacheMetadata","cache","TypeError","createRequestHandoffFromData","input","handoff","undefined","assertOptimizationCacheSafety"],"mappings":";;AAQA,MAAMA,mCAAgD;IAAC;IAAY;CAAO;AAkF1E,MAAMC,+BAA+BC,yDAAAA,aAAaA;IAchD,YAAY,EAAEC,GAAG,EAAEC,iBAAiB,EAAEC,YAAY,EAAE,GAAGC,QAAgC,CAAE;QACvF,MAAM,EAAEC,OAAO,EAAE,GAAGC,oBAAoB,GAAGH,gBAAgB,CAAC;QAE5D,KAAK,CAAC;YACJ,GAAGC,MAAM;YACT,mBAAmBF,qBAAqBJ;YACxC,cAAc;gBACZG;gBACA,SAAS;gBACT,GAAGK,kBAAkB;gBACrB,SAAS;oBACP,MAAMC;oBACN,SAASC;oBACT,GAAGH,OAAO;gBACZ;gBACA,YAAY,IAAM;YACpB;QACF;IACF;AACF;AAEA,mCAAeN;ACpHf,SAASU,kCACPC,KAAgC;IAEhC,IAAIA,AAAgB,sBAAhBA,MAAM,KAAK,EAAwB;IAEvC,MAAM,IAAIC,UACR;AAEJ;AAWO,SAASC,6BAA6BC,KAI5C;IACC,MAAMH,QAAiDG,MAAM,KAAK,IAAI;QAAE,OAAO;IAAkB;IACjGJ,kCAAkCC;IAElC,MAAMI,UAA+B;QACnCJ;QACA,GAAIG,AAAkBE,WAAlBF,MAAM,OAAO,GAAiB,CAAC,IAAI;YAAE,SAASA,MAAM,OAAO;QAAC,CAAC;QACjE,GAAIA,AAAeE,WAAfF,MAAM,IAAI,GACV,CAAC,IACD;YACE,OAAO;gBACL,uBAAuBA,MAAM,IAAI,CAAC,qBAAqB;gBACvD,SAASA,MAAM,IAAI,CAAC,OAAO;gBAC3B,SAASA,MAAM,IAAI,CAAC,OAAO;YAC7B;QACF,CAAC;IACP;IAEAG,IAAAA,yDAAAA,6BAAAA,AAAAA,EAA8BF;IAE9B,OAAOA;AACT;AClCA,YAAef"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@contentful/optimization-node",
-  "version": "1.0.0",
+  "description": "Node.js SDK for Contentful Optimization",
+  "version": "1.1.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -81,12 +82,12 @@
   "buildTools": {
     "bundleSize": {
       "gzipBudgets": {
-        "index.cjs": 2000,
-        "index.mjs": 1500
+        "index.cjs": 1500,
+        "index.mjs": 1300
       }
     }
   },
   "dependencies": {
-    "@contentful/optimization-core": "1.0.0"
+    "@contentful/optimization-core": "1.1.0"
   }
 }