@contentful/optimization-node 0.1.0-alpha7 → 0.1.0-alpha8

package/dist/index.cjs

@@ -36,7 +36,7 @@ var __webpack_modules__ = {
             TF: ()=>_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-alpha7";
+        const OPTIMIZATION_NODE_SDK_VERSION = "0.1.0-alpha8";
         const OPTIMIZATION_NODE_SDK_NAME = "@contentful/optimization-node";
     },
     "@contentful/optimization-core" (module) {
@@ -90,27 +90,25 @@ var __webpack_exports__ = {};
         ANONYMOUS_ID_COOKIE: ()=>_global_constants__rspack_import_2.TF,
         OPTIMIZATION_NODE_SDK_NAME: ()=>_global_constants__rspack_import_2.EH,
         OPTIMIZATION_NODE_SDK_VERSION: ()=>_global_constants__rspack_import_2.RS,
-        Optimization: ()=>_Optimization__rspack_import_0.A
+        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 ([
-        "Optimization",
-        "default"
-    ].indexOf(__rspack_import_key) < 0) __rspack_reexport[__rspack_import_key] = ()=>_contentful_optimization_core__rspack_import_1[__rspack_import_key];
+    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_NAME = __webpack_exports__.OPTIMIZATION_NODE_SDK_NAME;
 exports.OPTIMIZATION_NODE_SDK_VERSION = __webpack_exports__.OPTIMIZATION_NODE_SDK_VERSION;
-exports.Optimization = __webpack_exports__.Optimization;
+exports["default"] = __webpack_exports__["default"];
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "ANONYMOUS_ID_COOKIE",
     "OPTIMIZATION_NODE_SDK_NAME",
     "OPTIMIZATION_NODE_SDK_VERSION",
-    "Optimization"
+    "default"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/index.cjs.map

@@ -1 +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"],"sourcesContent":["import { type App, type CoreStatelessConfig, CoreStateless } from '@contentful/optimization-core'\nimport { merge } from 'es-toolkit'\nimport { OPTIMIZATION_NODE_SDK_NAME, 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_SDK_NAME, 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// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_PACKAGE_NAME__: string | undefined\n\nexport const OPTIMIZATION_NODE_SDK_VERSION =\n  typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0'\nexport const OPTIMIZATION_NODE_SDK_NAME =\n  typeof __OPTIMIZATION_PACKAGE_NAME__ === 'string'\n    ? __OPTIMIZATION_PACKAGE_NAME__\n    : '@contentful/optimization-node'\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};"],"names":["mergeConfig","config","app","restConfig","defaultConfig","OPTIMIZATION_NODE_SDK_NAME","OPTIMIZATION_NODE_SDK_VERSION","merge","Optimization","CoreStateless","mergedConfig","__OPTIMIZATION_VERSION__","__OPTIMIZATION_PACKAGE_NAME__","__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,MAAMG,iBAAAA,EAA0BA;wBAAE,SAASC,iBAAAA,EAA6BA;oBAAC;gBACtF;YACF;YACA,OAAOC,AAAAA,IAAAA,oCAAAA,KAAAA,AAAAA,EAAMH,eAAeD;QAC9B;QAyBA,MAAMK,qBAAqBC,mBAAAA,aAAaA;YAOtC,YAAYR,MAA8B,CAAE;gBAC1C,MAAMS,eAAoCV,YAAYC;gBAEtD,KAAK,CAACS;YACR;QACF;QAEA,yBAAeF;;;;;;;;;QC1FR,MAAMF,gCACoCK;QAC1C,MAAMN,6BAEPO;;;;;;;;;;;;;;;;;ICRNC,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"}
+{"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_NAME, 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_SDK_NAME, 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// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_PACKAGE_NAME__: string | undefined\n\nexport const OPTIMIZATION_NODE_SDK_VERSION =\n  typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0'\nexport const OPTIMIZATION_NODE_SDK_NAME =\n  typeof __OPTIMIZATION_PACKAGE_NAME__ === 'string'\n    ? __OPTIMIZATION_PACKAGE_NAME__\n    : '@contentful/optimization-node'\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_NAME","OPTIMIZATION_NODE_SDK_VERSION","merge","Optimization","CoreStateless","mergedConfig","__OPTIMIZATION_VERSION__","__OPTIMIZATION_PACKAGE_NAME__","__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,MAAMG,iBAAAA,EAA0BA;wBAAE,SAASC,iBAAAA,EAA6BA;oBAAC;gBACtF;YACF;YACA,OAAOC,AAAAA,IAAAA,oCAAAA,KAAAA,AAAAA,EAAMH,eAAeD;QAC9B;QAyBA,MAAMK,qBAAqBC,mBAAAA,aAAaA;YAOtC,YAAYR,MAA8B,CAAE;gBAC1C,MAAMS,eAAoCV,YAAYC;gBAEtD,KAAK,CAACS;YACR;QACF;QAEA,yBAAeF;;;;;;;;;QC1FR,MAAMF,gCACoCK;QAC1C,MAAMN,6BAEPO;;;;;;;;;;;;;;;;;ICRNC,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,gCAAeV,+BAAAA,CAAYA"}

package/dist/index.d.cts

@@ -0,0 +1,77 @@
+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_NAME: string;
+
+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.d.mts

@@ -0,0 +1,77 @@
+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_NAME: string;
+
+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.d.ts

@@ -28,7 +28,7 @@ export { ANONYMOUS_ID_COOKIE }
  * await sdk.track({ event: 'server_event', properties: { id: 1 } })
  * ```
  */
-export declare class Optimization extends CoreStateless {
+declare class Optimization extends CoreStateless {
     /**
      * Create an instance of the Node SDK with merged defaults.
      *
@@ -37,6 +37,7 @@ export declare class Optimization extends CoreStateless {
      */
     constructor(config: OptimizationNodeConfig);
 }
+export default Optimization;
 
 export declare const OPTIMIZATION_NODE_SDK_NAME: string;
 

package/dist/index.mjs

@@ -1,6 +1,6 @@
 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-alpha7";
+const OPTIMIZATION_NODE_SDK_VERSION = "0.1.0-alpha8";
 const OPTIMIZATION_NODE_SDK_NAME = "@contentful/optimization-node";
 function mergeConfig(config) {
     const { app, ...restConfig } = config;
@@ -23,8 +23,10 @@ class Optimization extends __rspack_external__contentful_optimization_core_7d475
     }
 }
 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 { ANONYMOUS_ID_COOKIE, OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION, src_Optimization as Optimization };
+export default src;
+export { ANONYMOUS_ID_COOKIE, OPTIMIZATION_NODE_SDK_NAME, OPTIMIZATION_NODE_SDK_VERSION };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/global-constants.ts","../src/Optimization.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\nexport const OPTIMIZATION_NODE_SDK_VERSION =\n  typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0'\nexport const OPTIMIZATION_NODE_SDK_NAME =\n  typeof __OPTIMIZATION_PACKAGE_NAME__ === 'string'\n    ? __OPTIMIZATION_PACKAGE_NAME__\n    : '@contentful/optimization-node'\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_NAME, 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_SDK_NAME, 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"],"names":["OPTIMIZATION_NODE_SDK_VERSION","__OPTIMIZATION_VERSION__","OPTIMIZATION_NODE_SDK_NAME","__OPTIMIZATION_PACKAGE_NAME__","mergeConfig","config","app","restConfig","defaultConfig","merge","Optimization","CoreStateless","mergedConfig"],"mappings":";;AAKO,MAAMA,gCACoCC;AAC1C,MAAMC,6BAEPC;ACoCN,SAASC,YAAYC,MAA8B;IACjD,MAAM,EAAEC,GAAG,EAAE,GAAGC,YAAY,GAAGF;IAE/B,MAAMG,gBAA8C;QAClD,cAAc;YACZF;YACA,SAAS;YACT,SAAS;gBAAE,MAAMJ;gBAA4B,SAASF;YAA8B;QACtF;IACF;IACA,OAAOS,MAAMD,eAAeD;AAC9B;AAyBA,MAAMG,qBAAqBC,yDAAAA,aAAaA;IAOtC,YAAYN,MAA8B,CAAE;QAC1C,MAAMO,eAAoCR,YAAYC;QAEtD,KAAK,CAACO;IACR;AACF;AAEA,yBAAeF"}
+{"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// eslint-disable-next-line @typescript-eslint/naming-convention -- Replaced at build-time\ndeclare const __OPTIMIZATION_PACKAGE_NAME__: string | undefined\n\nexport const OPTIMIZATION_NODE_SDK_VERSION =\n  typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0'\nexport const OPTIMIZATION_NODE_SDK_NAME =\n  typeof __OPTIMIZATION_PACKAGE_NAME__ === 'string'\n    ? __OPTIMIZATION_PACKAGE_NAME__\n    : '@contentful/optimization-node'\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_NAME, 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_SDK_NAME, 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__","OPTIMIZATION_NODE_SDK_NAME","__OPTIMIZATION_PACKAGE_NAME__","mergeConfig","config","app","restConfig","defaultConfig","merge","Optimization","CoreStateless","mergedConfig"],"mappings":";;AAKO,MAAMA,gCACoCC;AAC1C,MAAMC,6BAEPC;ACoCN,SAASC,YAAYC,MAA8B;IACjD,MAAM,EAAEC,GAAG,EAAE,GAAGC,YAAY,GAAGF;IAE/B,MAAMG,gBAA8C;QAClD,cAAc;YACZF;YACA,SAAS;YACT,SAAS;gBAAE,MAAMJ;gBAA4B,SAASF;YAA8B;QACtF;IACF;IACA,OAAOS,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

@@ -1,16 +1,21 @@
 {
   "name": "@contentful/optimization-node",
-  "version": "0.1.0-alpha7",
+  "version": "0.1.0-alpha8",
   "license": "MIT",
-  "type": "commonjs",
+  "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.cjs",
-      "import": "./dist/index.mjs"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./package.json": "./package.json"
   },
@@ -19,6 +24,6 @@
   ],
   "dependencies": {
     "es-toolkit": "^1.39.10",
-    "@contentful/optimization-core": "0.1.0-alpha7"
+    "@contentful/optimization-core": "0.1.0-alpha8"
   }
 }