@contentful/experiences-client 0.6.0 → 0.7.1

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## 0.7.1 (2026-10-01)
+
+### 🚀 Features
+
+- persist web personalization profile ID ([#213](https://github.com/contentful/experiences/pull/213))
+
+### 🧱 Updated Dependencies
+
+- Updated core to 0.10.1
+
+## 0.7.0 (2026-09-30)
+
+### 🚀 Features
+
+- ⚠️  add event-triggering methods to runtimes ([#209](https://github.com/contentful/experiences/pull/209))
+
+### ⚠️  Breaking Changes
+
+- add event-triggering methods to runtimes  ([#209](https://github.com/contentful/experiences/pull/209))
+
 ## 0.6.0 (2026-09-30)
 
 ### 🚀 Features

package/README.md

@@ -16,35 +16,81 @@ remain supported for adapter and application integration.
 
 `ContentfulExperiences` is an internal shared runtime contract for the public
 Node/Web SDKs. Construct it with a space, environment, resolver configuration,
-a delivery client source, and an `eventBuilder` config with an explicit
-`channel`; optionally provide a preview client source. It retains those clients,
-merges configured resolve defaults with per-call options, and exposes
-`resolveExperience` and by-id/destination `fetchExperience` methods. Calling
-`fetchExperience` with `preview: true` requires the optional preview client.
-
-The Client transport configuration is trusted: its bearer token is sent to the
-selected endpoint. `environmentId` is the Contentful environment identifier
-passed to by-ID Experience requests; it is not the generated delivery client's
-optional `environment` endpoint setting. For a Client-created transport,
-Experiences' `host` is passed through as the generated client's `baseUrl`.
-Callers that construct a raw `ContentfulViewDeliveryClient` may configure
-`baseUrl` directly. This is how both public leaves can use trusted custom
-endpoints (for example, a proxy, staging service, or regional endpoint).
-Endpoint precedence is explicit `host`/raw-client `baseUrl`, then the generated
-client's `environment`, then the delivery or preview default.
+a delivery configuration, and an `eventBuilder` config with an explicit
+`channel`; optionally provide a preview configuration. It constructs and retains
+those clients, merges configured resolve defaults with per-call options, and
+exposes `resolveExperience` and by-id/destination `fetchExperience` methods.
+Calling `fetchExperience` with `preview: true` requires preview configuration.
+
+The runtime-owned Delivery and Preview clients support two security models. For
+direct API access, provide an `accessToken`; it may be a supplier and is sent to
+the selected endpoint. For a trusted application proxy that adds the upstream
+token itself, omit `accessToken` and provide an explicit `host`; the runtime
+disables generated bearer authentication. `environmentId` is the Contentful
+environment identifier passed to by-ID requests, not the generated delivery
+client's optional endpoint-valued `environment`. Endpoint precedence is
+explicit `host`, then generated-client `environment`, then the delivery or
+preview default.
+
+Direct browser tokens are credentials but are intentionally browser-visible
+when an application's scope and CORS policy permit that model. Proxy mode keeps
+the upstream token server-side. In either mode, treat custom endpoints as
+trusted configuration.
 
 The optional preview client enables direct CPA fetches by Experience ID through
 the same shared runtime. It is separate from `@contentful/experiences-live-preview`,
 which owns Preview Session HTTP loading, WebSocket subscription, and update state.
 Destination operations continue to use the delivery client.
 
-The runtime constructs and owns one `EventBuilder`. The caller supplies its
-channel, while the runtime retains this SDK's default library identity and the
-runtime locale unless overridden. This is the owner of event construction for
-the lower layer, rather than Core.
+The runtime constructs and owns one `EventBuilder` and one Optimization API
+client. The caller supplies the event channel, while the runtime retains this
+SDK's default library identity and the runtime locale unless overridden. This
+package owns event construction and direct transport for the lower layer,
+rather than Core. It exposes a protected binding point used by the public Node
+and Web leaves; Client itself does not retain a mutable event profile.
+
+By default the Optimization client uses the runtime's `spaceId` and maps its
+Contentful `environmentId` to the Optimization client's `environment` option.
+This is the same Contentful environment identifier passed to by-ID delivery
+requests, not the generated delivery client's endpoint-valued `environment`
+setting. The optional `optimization` configuration can provide API-specific
+endpoint, feature, and fetch overrides; the runtime always constructs and owns
+the Optimization client. Custom Optimization base URLs receive complete event
+and profile payloads, so treat them as sensitive-data destinations and use only
+trusted HTTPS origins outside explicit local development.
+
+The bound event methods normally send immediately: `identify`, `page`, and
+`track` upsert a profile through the Personalization API; view, click, hover,
+and flag-view events send a one-event batch through Analytics. Queues, durable
+profile persistence, consent gating, lifecycle/beacon delivery, automatic
+interaction tracking, and Live Preview integration are intentionally absent.
+The Node leaf additionally has a request-scoped, one-shot handoff journal for
+paired browser replay; it is not an SDK queue or persistence mechanism. Because
+calls are not serialized, callers must await profile-producing calls before
+starting another profile-producing or Analytics call on the same bound runtime.
+
+### Server-to-browser event handoff contract
+
+`RuntimeEventHandoff` is the internal replay payload between Node and Web. Node
+alone chooses direct `commit` or paired-browser `handoff` delivery per request.
+The handoff holds a version, Contentful scope, optional initial profile, ordered
+Personalization/Analytics event bodies, and an optional initial-page route key. Its
+internal serialized-payload cap is 64 KiB. Node can preflight the initial
+Personalization sequence as one batch; individual Personalization methods remain
+cumulative and Analytics methods stage without transport. Web validates the
+payload, admits page-bearing journals only for a matching browser route,
+batches compatible adjacent Personalization entries, preserves locale and Analytics
+ordering boundaries, and chains each resulting profile.
+
+The payload is browser-visible sensitive data. Application integration must use
+escaped serialization in a private, no-store response and exclude secrets and
+server-only traits. Do not cache, log, or persist it. Replay may partially
+commit, has no automatic retry or distributed exactly-once guarantee, and is
+independent from Live Preview. A failed replay rejects its receipt but releases
+later direct Web calls. See the root [paired replay guide](../../README.md#paired-server-to-browser-replay).
 
 This package's direct dependencies are the generated delivery client,
-`@contentful/optimization-api-client` (event schemas and logger), `es-toolkit`
+`@contentful/optimization-api-client` (event schemas, logger, and transport), `es-toolkit`
 (event-property merging), and `zod` (event argument schemas), in addition to
 Core. None of those dependencies are introduced into Core.
 
@@ -201,7 +247,7 @@ const client = new ContentfulViewDeliveryClient({
 - Do not import `@contentful/experience-delivery` from anywhere except this package.
 - Re-export only what framework adapters need to surface to their users.
 - Keep `fetchExperience` thin — fetch + cast + resolve. Business logic belongs in `packages/core`.
-- Name mappings between SDK options and delivery-client options live in `create-client.ts` — one place to change.
+- Name mappings between SDK options and delivery-client options live in `create-delivery-client.ts` — one place to change.
 
 ## License
 

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cookie name used to carry an anonymous/profile id between browser and server
+ * runtimes. The value matches the Contentful Optimization SDK.
+ *
+ * @public
+ */
+declare const ANONYMOUS_ID_COOKIE = "ctfl-opt-aid";
+/** @internal LocalStorage key for the persisted profile. */
+declare const PROFILE_CACHE_KEY = "__ctfl_opt_profile__";
+
+export { ANONYMOUS_ID_COOKIE, PROFILE_CACHE_KEY };

package/dist/constants.js

@@ -0,0 +1,7 @@
+const ANONYMOUS_ID_COOKIE = "ctfl-opt-aid";
+const PROFILE_CACHE_KEY = "__ctfl_opt_profile__";
+export {
+  ANONYMOUS_ID_COOKIE,
+  PROFILE_CACHE_KEY
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Cookie name used to carry an anonymous/profile id between browser and server\n * runtimes. The value matches the Contentful Optimization SDK.\n *\n * @public\n */\nexport const ANONYMOUS_ID_COOKIE = 'ctfl-opt-aid';\n\n/** @internal LocalStorage key for the persisted profile. */\nexport const PROFILE_CACHE_KEY = '__ctfl_opt_profile__';\n"],"mappings":"AAMO,MAAM,sBAAsB;AAG5B,MAAM,oBAAoB;","names":[]}

package/dist/contentful-experiences.d.ts

@@ -1,14 +1,14 @@
-import { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';
 import { ExperiencePayload, PortableRenderPlan, ResolverConfig } from '@contentful/experiences-sdk-core';
 import EventBuilder, { EventBuilderConfig } from './event-builder.js';
+import { RuntimeDeliveryClientOptions } from './create-delivery-client.js';
 import { PersonalizationOptions, ExperienceRequestExtensions, DestinationRedirectResult } from './fetch-experience.js';
-import { CreateClientOptions } from './create-client.js';
+import { RuntimeOptimizationConfig } from './create-optimization-client.js';
+import { RuntimeOptimizationApiClient, RuntimeEventBindings, RuntimeEventDispatch, RuntimeEventMethods } from './runtime-event-methods.js';
 import '@contentful/optimization-api-client/api-schemas';
 import 'zod/mini';
+import '@contentful/experience-delivery';
+import '@contentful/optimization-api-client';
 
-type RuntimeClientSource = CreateClientOptions | {
-    client: ContentfulViewDeliveryClient;
-};
 type RuntimeResolveOptions = {
     metadata?: Record<string, unknown>;
     debug?: boolean;
@@ -49,8 +49,12 @@ type ContentfulExperiencesConfig = {
     environmentId: string;
     locale?: string;
     resolverConfig: ResolverConfig;
-    delivery: RuntimeClientSource;
-    preview?: RuntimeClientSource;
+    /** Configuration for the runtime-owned Content Delivery API client. */
+    delivery: RuntimeDeliveryClientOptions;
+    /** Optional configuration for the runtime-owned Content Preview API client. */
+    preview?: RuntimeDeliveryClientOptions;
+    /** Overrides for the runtime-owned Personalization and Analytics event transport. */
+    optimization?: RuntimeOptimizationConfig;
     resolveDefaults?: Pick<RuntimeResolveOptions, 'metadata' | 'debug'>;
     eventBuilder: RuntimeEventBuilderConfig;
 };
@@ -59,12 +63,14 @@ declare class ContentfulExperiences implements ExperienceRuntime {
     readonly spaceId: string;
     readonly environmentId: string;
     readonly eventBuilder: EventBuilder;
+    protected readonly optimizationApi: RuntimeOptimizationApiClient;
     constructor(config: ContentfulExperiencesConfig);
     get locale(): string | undefined;
+    protected createEventMethods(bindings: RuntimeEventBindings, dispatch?: RuntimeEventDispatch): RuntimeEventMethods;
     resolveExperience(payload: ExperiencePayload, resolveOptions?: RuntimeResolveOptions): Promise<PortableRenderPlan>;
     fetchExperience(options: RuntimeFetchExperienceOptions, resolveOptions?: RuntimeResolveOptions): Promise<PortableRenderPlan>;
     fetchByDestinationNode(options: RuntimeFetchByDestinationNodeOptions, resolveOptions?: RuntimeResolveOptions): Promise<PortableRenderPlan | DestinationRedirectResult>;
     fetchByDestinationPath(options: RuntimeFetchByDestinationPathOptions, resolveOptions?: RuntimeResolveOptions): Promise<PortableRenderPlan | DestinationRedirectResult>;
 }
 
-export { ContentfulExperiences, type ContentfulExperiencesConfig, type ExperienceRuntime, type RuntimeClientSource, type RuntimeEventBuilderConfig, type RuntimeFetchByDestinationNodeOptions, type RuntimeFetchByDestinationPathOptions, type RuntimeFetchExperienceOptions, type RuntimeResolveOptions };
+export { ContentfulExperiences, type ContentfulExperiencesConfig, type ExperienceRuntime, type RuntimeEventBuilderConfig, type RuntimeFetchByDestinationNodeOptions, type RuntimeFetchByDestinationPathOptions, type RuntimeFetchExperienceOptions, type RuntimeResolveOptions };

package/dist/contentful-experiences.js

@@ -1,11 +1,19 @@
 import { resolveExperience as resolveCoreExperience } from "@contentful/experiences-sdk-core";
 import EventBuilder from "./event-builder.js";
-import { createClient } from "./create-client.js";
+import {
+  createRuntimeDeliveryClient
+} from "./create-delivery-client.js";
 import {
   fetchExperience
 } from "./fetch-experience.js";
+import {
+  createRuntimeOptimizationClient
+} from "./create-optimization-client.js";
 import { PREVIEW_HOST } from "./hosts.js";
 import { DEFAULT_EVENT_CONTEXT_LIBRARY } from "./sdk-info.js";
+import {
+  createRuntimeEventMethods
+} from "./runtime-event-methods.js";
 class ContentfulExperiences {
   spaceId;
   environmentId;
@@ -14,14 +22,20 @@ class ContentfulExperiences {
   #resolverConfig;
   #deliveryClient;
   #previewClient;
+  optimizationApi;
   #resolveDefaults;
   constructor(config) {
     this.spaceId = config.spaceId;
     this.environmentId = config.environmentId;
     this.#locale = config.locale;
     this.#resolverConfig = config.resolverConfig;
-    this.#deliveryClient = resolveClient(config.delivery);
-    this.#previewClient = config.preview === void 0 ? void 0 : resolveClient(config.preview, PREVIEW_HOST);
+    this.#deliveryClient = createRuntimeDeliveryClient(config.delivery);
+    this.#previewClient = config.preview === void 0 ? void 0 : createRuntimeDeliveryClient(config.preview, PREVIEW_HOST);
+    this.optimizationApi = createRuntimeOptimizationClient({
+      spaceId: config.spaceId,
+      environmentId: config.environmentId,
+      ...config.optimization
+    });
     this.#resolveDefaults = config.resolveDefaults ?? {};
     this.eventBuilder = new EventBuilder({
       ...config.eventBuilder,
@@ -32,6 +46,9 @@ class ContentfulExperiences {
   get locale() {
     return this.#locale;
   }
+  createEventMethods(bindings, dispatch) {
+    return createRuntimeEventMethods(this.optimizationApi, this.eventBuilder, bindings, dispatch);
+  }
   resolveExperience(payload, resolveOptions) {
     return resolveCoreExperience(
       payload,
@@ -82,13 +99,6 @@ class ContentfulExperiences {
     };
   }
 }
-function resolveClient(source, defaultHost) {
-  if ("client" in source) return source.client;
-  return createClient({
-    ...source,
-    host: source.host ?? (source.environment === void 0 ? defaultHost : void 0)
-  });
-}
 export {
   ContentfulExperiences
 };

package/dist/contentful-experiences.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/contentful-experiences.ts"],"sourcesContent":["import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { resolveExperience as resolveCoreExperience } from '@contentful/experiences-sdk-core';\nimport type {\n  ExperiencePayload,\n  PortableRenderPlan,\n  ResolverConfig,\n} from '@contentful/experiences-sdk-core';\nimport EventBuilder from './event-builder.js';\nimport type { EventBuilderConfig } from './event-builder.js';\nimport { createClient } from './create-client.js';\nimport {\n  fetchExperience,\n  type DestinationRedirectResult,\n  type ExperienceRequestExtensions,\n  type PersonalizationOptions,\n} from './fetch-experience.js';\nimport type { CreateClientOptions } from './create-client.js';\nimport { PREVIEW_HOST } from './hosts.js';\nimport { DEFAULT_EVENT_CONTEXT_LIBRARY } from './sdk-info.js';\n\nexport type RuntimeClientSource = CreateClientOptions | { client: ContentfulViewDeliveryClient };\n\nexport type RuntimeResolveOptions = {\n  metadata?: Record<string, unknown>;\n  debug?: boolean;\n  initialViewportId?: string;\n};\n\nexport type RuntimeEventBuilderConfig = Omit<EventBuilderConfig, 'channel' | 'library'> & {\n  channel: EventBuilderConfig['channel'];\n  library?: Partial<EventBuilderConfig['library']>;\n};\n\nexport type RuntimeFetchExperienceOptions = {\n  experienceId: string;\n  locale?: string;\n  personalization?: PersonalizationOptions;\n  extensions?: ExperienceRequestExtensions;\n  preview?: boolean;\n};\n\nexport type RuntimeFetchByDestinationNodeOptions = {\n  destinationId: string;\n  nodeId: string;\n};\n\nexport type RuntimeFetchByDestinationPathOptions = {\n  destinationId: string;\n  path: string;\n};\n\n/** Structural contract implemented by the Client runtime. */\nexport interface ExperienceRuntime {\n  readonly spaceId: string;\n  readonly environmentId: string;\n  readonly locale: string | undefined;\n  readonly eventBuilder: EventBuilder;\n  resolveExperience(\n    payload: ExperiencePayload,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan>;\n  fetchExperience(\n    options: RuntimeFetchExperienceOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan>;\n  fetchByDestinationNode(\n    options: RuntimeFetchByDestinationNodeOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan | DestinationRedirectResult>;\n  fetchByDestinationPath(\n    options: RuntimeFetchByDestinationPathOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan | DestinationRedirectResult>;\n}\n\nexport type ContentfulExperiencesConfig = {\n  spaceId: string;\n  environmentId: string;\n  locale?: string;\n  resolverConfig: ResolverConfig;\n  delivery: RuntimeClientSource;\n  preview?: RuntimeClientSource;\n  resolveDefaults?: Pick<RuntimeResolveOptions, 'metadata' | 'debug'>;\n  eventBuilder: RuntimeEventBuilderConfig;\n};\n\nexport class ContentfulExperiences implements ExperienceRuntime {\n  readonly spaceId: string;\n  readonly environmentId: string;\n  readonly eventBuilder: EventBuilder;\n\n  readonly #locale: string | undefined;\n  readonly #resolverConfig: ResolverConfig;\n  readonly #deliveryClient: ContentfulViewDeliveryClient;\n  readonly #previewClient: ContentfulViewDeliveryClient | undefined;\n  readonly #resolveDefaults: Pick<RuntimeResolveOptions, 'metadata' | 'debug'>;\n\n  constructor(config: ContentfulExperiencesConfig) {\n    this.spaceId = config.spaceId;\n    this.environmentId = config.environmentId;\n    this.#locale = config.locale;\n    this.#resolverConfig = config.resolverConfig;\n    this.#deliveryClient = resolveClient(config.delivery);\n    this.#previewClient =\n      config.preview === undefined ? undefined : resolveClient(config.preview, PREVIEW_HOST);\n    this.#resolveDefaults = config.resolveDefaults ?? {};\n\n    this.eventBuilder = new EventBuilder({\n      ...config.eventBuilder,\n      library: { ...DEFAULT_EVENT_CONTEXT_LIBRARY, ...config.eventBuilder.library },\n      getLocale: config.eventBuilder.getLocale ?? (() => this.locale),\n    });\n  }\n\n  get locale(): string | undefined {\n    return this.#locale;\n  }\n\n  resolveExperience(\n    payload: ExperiencePayload,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan> {\n    return resolveCoreExperience(\n      payload,\n      this.#resolverConfig,\n      this.#mergeResolveOptions(resolveOptions)\n    );\n  }\n\n  fetchExperience(\n    options: RuntimeFetchExperienceOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan> {\n    if (options.preview === true && this.#previewClient === undefined) {\n      throw new Error(\n        'fetchExperience() called with preview: true but this runtime has no preview client'\n      );\n    }\n    return fetchExperience(\n      {\n        spaceId: this.spaceId,\n        environmentId: this.environmentId,\n        experienceId: options.experienceId,\n        locale: options.locale ?? this.locale,\n        personalization: options.personalization,\n        extensions: options.extensions,\n      },\n      {\n        client: options.preview\n          ? (this.#previewClient as ContentfulViewDeliveryClient)\n          : this.#deliveryClient,\n      },\n      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }\n    );\n  }\n\n  fetchByDestinationNode(\n    options: RuntimeFetchByDestinationNodeOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan | DestinationRedirectResult> {\n    return fetchExperience(\n      { spaceId: this.spaceId, destinationId: options.destinationId, nodeId: options.nodeId },\n      { client: this.#deliveryClient },\n      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }\n    );\n  }\n\n  fetchByDestinationPath(\n    options: RuntimeFetchByDestinationPathOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan | DestinationRedirectResult> {\n    return fetchExperience(\n      { spaceId: this.spaceId, destinationId: options.destinationId, path: options.path },\n      { client: this.#deliveryClient },\n      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }\n    );\n  }\n\n  #mergeResolveOptions(options: RuntimeResolveOptions | undefined): RuntimeResolveOptions {\n    return {\n      metadata: { ...this.#resolveDefaults.metadata, ...options?.metadata },\n      debug: options?.debug ?? this.#resolveDefaults.debug,\n      initialViewportId: options?.initialViewportId,\n    };\n  }\n}\n\nfunction resolveClient(\n  source: RuntimeClientSource,\n  defaultHost?: string\n): ContentfulViewDeliveryClient {\n  if ('client' in source) return source.client;\n\n  return createClient({\n    ...source,\n    host: source.host ?? (source.environment === undefined ? defaultHost : undefined),\n  });\n}\n"],"mappings":"AACA,SAAS,qBAAqB,6BAA6B;AAM3D,OAAO,kBAAkB;AAEzB,SAAS,oBAAoB;AAC7B;AAAA,EACE;AAAA,OAIK;AAEP,SAAS,oBAAoB;AAC7B,SAAS,qCAAqC;AAoEvC,MAAM,sBAAmD;AAAA,EACrD;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAqC;AAC/C,SAAK,UAAU,OAAO;AACtB,SAAK,gBAAgB,OAAO;AAC5B,SAAK,UAAU,OAAO;AACtB,SAAK,kBAAkB,OAAO;AAC9B,SAAK,kBAAkB,cAAc,OAAO,QAAQ;AACpD,SAAK,iBACH,OAAO,YAAY,SAAY,SAAY,cAAc,OAAO,SAAS,YAAY;AACvF,SAAK,mBAAmB,OAAO,mBAAmB,CAAC;AAEnD,SAAK,eAAe,IAAI,aAAa;AAAA,MACnC,GAAG,OAAO;AAAA,MACV,SAAS,EAAE,GAAG,+BAA+B,GAAG,OAAO,aAAa,QAAQ;AAAA,MAC5E,WAAW,OAAO,aAAa,cAAc,MAAM,KAAK;AAAA,IAC1D,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,SAA6B;AAC/B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,kBACE,SACA,gBAC6B;AAC7B,WAAO;AAAA,MACL;AAAA,MACA,KAAK;AAAA,MACL,KAAK,qBAAqB,cAAc;AAAA,IAC1C;AAAA,EACF;AAAA,EAEA,gBACE,SACA,gBAC6B;AAC7B,QAAI,QAAQ,YAAY,QAAQ,KAAK,mBAAmB,QAAW;AACjE,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,MACL;AAAA,QACE,SAAS,KAAK;AAAA,QACd,eAAe,KAAK;AAAA,QACpB,cAAc,QAAQ;AAAA,QACtB,QAAQ,QAAQ,UAAU,KAAK;AAAA,QAC/B,iBAAiB,QAAQ;AAAA,QACzB,YAAY,QAAQ;AAAA,MACtB;AAAA,MACA;AAAA,QACE,QAAQ,QAAQ,UACX,KAAK,iBACN,KAAK;AAAA,MACX;AAAA,MACA,EAAE,QAAQ,KAAK,iBAAiB,GAAG,KAAK,qBAAqB,cAAc,EAAE;AAAA,IAC/E;AAAA,EACF;AAAA,EAEA,uBACE,SACA,gBACyD;AACzD,WAAO;AAAA,MACL,EAAE,SAAS,KAAK,SAAS,eAAe,QAAQ,eAAe,QAAQ,QAAQ,OAAO;AAAA,MACtF,EAAE,QAAQ,KAAK,gBAAgB;AAAA,MAC/B,EAAE,QAAQ,KAAK,iBAAiB,GAAG,KAAK,qBAAqB,cAAc,EAAE;AAAA,IAC/E;AAAA,EACF;AAAA,EAEA,uBACE,SACA,gBACyD;AACzD,WAAO;AAAA,MACL,EAAE,SAAS,KAAK,SAAS,eAAe,QAAQ,eAAe,MAAM,QAAQ,KAAK;AAAA,MAClF,EAAE,QAAQ,KAAK,gBAAgB;AAAA,MAC/B,EAAE,QAAQ,KAAK,iBAAiB,GAAG,KAAK,qBAAqB,cAAc,EAAE;AAAA,IAC/E;AAAA,EACF;AAAA,EAEA,qBAAqB,SAAmE;AACtF,WAAO;AAAA,MACL,UAAU,EAAE,GAAG,KAAK,iBAAiB,UAAU,GAAG,SAAS,SAAS;AAAA,MACpE,OAAO,SAAS,SAAS,KAAK,iBAAiB;AAAA,MAC/C,mBAAmB,SAAS;AAAA,IAC9B;AAAA,EACF;AACF;AAEA,SAAS,cACP,QACA,aAC8B;AAC9B,MAAI,YAAY,OAAQ,QAAO,OAAO;AAEtC,SAAO,aAAa;AAAA,IAClB,GAAG;AAAA,IACH,MAAM,OAAO,SAAS,OAAO,gBAAgB,SAAY,cAAc;AAAA,EACzE,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/contentful-experiences.ts"],"sourcesContent":["import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { resolveExperience as resolveCoreExperience } from '@contentful/experiences-sdk-core';\nimport type {\n  ExperiencePayload,\n  PortableRenderPlan,\n  ResolverConfig,\n} from '@contentful/experiences-sdk-core';\nimport EventBuilder from './event-builder.js';\nimport type { EventBuilderConfig } from './event-builder.js';\nimport {\n  createRuntimeDeliveryClient,\n  type RuntimeDeliveryClientOptions,\n} from './create-delivery-client.js';\nimport {\n  fetchExperience,\n  type DestinationRedirectResult,\n  type ExperienceRequestExtensions,\n  type PersonalizationOptions,\n} from './fetch-experience.js';\nimport {\n  createRuntimeOptimizationClient,\n  type RuntimeOptimizationConfig,\n} from './create-optimization-client.js';\nimport { PREVIEW_HOST } from './hosts.js';\nimport { DEFAULT_EVENT_CONTEXT_LIBRARY } from './sdk-info.js';\nimport {\n  createRuntimeEventMethods,\n  type RuntimeEventBindings,\n  type RuntimeEventDispatch,\n  type RuntimeEventMethods,\n  type RuntimeOptimizationApiClient,\n} from './runtime-event-methods.js';\n\nexport type RuntimeResolveOptions = {\n  metadata?: Record<string, unknown>;\n  debug?: boolean;\n  initialViewportId?: string;\n};\n\nexport type RuntimeEventBuilderConfig = Omit<EventBuilderConfig, 'channel' | 'library'> & {\n  channel: EventBuilderConfig['channel'];\n  library?: Partial<EventBuilderConfig['library']>;\n};\n\nexport type RuntimeFetchExperienceOptions = {\n  experienceId: string;\n  locale?: string;\n  personalization?: PersonalizationOptions;\n  extensions?: ExperienceRequestExtensions;\n  preview?: boolean;\n};\n\nexport type RuntimeFetchByDestinationNodeOptions = {\n  destinationId: string;\n  nodeId: string;\n};\n\nexport type RuntimeFetchByDestinationPathOptions = {\n  destinationId: string;\n  path: string;\n};\n\n/** Structural contract implemented by the Client runtime. */\nexport interface ExperienceRuntime {\n  readonly spaceId: string;\n  readonly environmentId: string;\n  readonly locale: string | undefined;\n  readonly eventBuilder: EventBuilder;\n  resolveExperience(\n    payload: ExperiencePayload,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan>;\n  fetchExperience(\n    options: RuntimeFetchExperienceOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan>;\n  fetchByDestinationNode(\n    options: RuntimeFetchByDestinationNodeOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan | DestinationRedirectResult>;\n  fetchByDestinationPath(\n    options: RuntimeFetchByDestinationPathOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan | DestinationRedirectResult>;\n}\n\nexport type ContentfulExperiencesConfig = {\n  spaceId: string;\n  environmentId: string;\n  locale?: string;\n  resolverConfig: ResolverConfig;\n  /** Configuration for the runtime-owned Content Delivery API client. */\n  delivery: RuntimeDeliveryClientOptions;\n  /** Optional configuration for the runtime-owned Content Preview API client. */\n  preview?: RuntimeDeliveryClientOptions;\n  /** Overrides for the runtime-owned Personalization and Analytics event transport. */\n  optimization?: RuntimeOptimizationConfig;\n  resolveDefaults?: Pick<RuntimeResolveOptions, 'metadata' | 'debug'>;\n  eventBuilder: RuntimeEventBuilderConfig;\n};\n\nexport class ContentfulExperiences implements ExperienceRuntime {\n  readonly spaceId: string;\n  readonly environmentId: string;\n  readonly eventBuilder: EventBuilder;\n\n  readonly #locale: string | undefined;\n  readonly #resolverConfig: ResolverConfig;\n  readonly #deliveryClient: ContentfulViewDeliveryClient;\n  readonly #previewClient: ContentfulViewDeliveryClient | undefined;\n  protected readonly optimizationApi: RuntimeOptimizationApiClient;\n  readonly #resolveDefaults: Pick<RuntimeResolveOptions, 'metadata' | 'debug'>;\n\n  constructor(config: ContentfulExperiencesConfig) {\n    this.spaceId = config.spaceId;\n    this.environmentId = config.environmentId;\n    this.#locale = config.locale;\n    this.#resolverConfig = config.resolverConfig;\n    this.#deliveryClient = createRuntimeDeliveryClient(config.delivery);\n    this.#previewClient =\n      config.preview === undefined\n        ? undefined\n        : createRuntimeDeliveryClient(config.preview, PREVIEW_HOST);\n    this.optimizationApi = createRuntimeOptimizationClient({\n      spaceId: config.spaceId,\n      environmentId: config.environmentId,\n      ...config.optimization,\n    });\n    this.#resolveDefaults = config.resolveDefaults ?? {};\n\n    this.eventBuilder = new EventBuilder({\n      ...config.eventBuilder,\n      library: { ...DEFAULT_EVENT_CONTEXT_LIBRARY, ...config.eventBuilder.library },\n      getLocale: config.eventBuilder.getLocale ?? (() => this.locale),\n    });\n  }\n\n  get locale(): string | undefined {\n    return this.#locale;\n  }\n\n  protected createEventMethods(\n    bindings: RuntimeEventBindings,\n    dispatch?: RuntimeEventDispatch\n  ): RuntimeEventMethods {\n    return createRuntimeEventMethods(this.optimizationApi, this.eventBuilder, bindings, dispatch);\n  }\n\n  resolveExperience(\n    payload: ExperiencePayload,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan> {\n    return resolveCoreExperience(\n      payload,\n      this.#resolverConfig,\n      this.#mergeResolveOptions(resolveOptions)\n    );\n  }\n\n  fetchExperience(\n    options: RuntimeFetchExperienceOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan> {\n    if (options.preview === true && this.#previewClient === undefined) {\n      throw new Error(\n        'fetchExperience() called with preview: true but this runtime has no preview client'\n      );\n    }\n    return fetchExperience(\n      {\n        spaceId: this.spaceId,\n        environmentId: this.environmentId,\n        experienceId: options.experienceId,\n        locale: options.locale ?? this.locale,\n        personalization: options.personalization,\n        extensions: options.extensions,\n      },\n      {\n        client: options.preview\n          ? (this.#previewClient as ContentfulViewDeliveryClient)\n          : this.#deliveryClient,\n      },\n      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }\n    );\n  }\n\n  fetchByDestinationNode(\n    options: RuntimeFetchByDestinationNodeOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan | DestinationRedirectResult> {\n    return fetchExperience(\n      { spaceId: this.spaceId, destinationId: options.destinationId, nodeId: options.nodeId },\n      { client: this.#deliveryClient },\n      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }\n    );\n  }\n\n  fetchByDestinationPath(\n    options: RuntimeFetchByDestinationPathOptions,\n    resolveOptions?: RuntimeResolveOptions\n  ): Promise<PortableRenderPlan | DestinationRedirectResult> {\n    return fetchExperience(\n      { spaceId: this.spaceId, destinationId: options.destinationId, path: options.path },\n      { client: this.#deliveryClient },\n      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }\n    );\n  }\n\n  #mergeResolveOptions(options: RuntimeResolveOptions | undefined): RuntimeResolveOptions {\n    return {\n      metadata: { ...this.#resolveDefaults.metadata, ...options?.metadata },\n      debug: options?.debug ?? this.#resolveDefaults.debug,\n      initialViewportId: options?.initialViewportId,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/create-delivery-client.d.ts

@@ -0,0 +1,29 @@
+import { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';
+
+/** Options for the legacy functional Delivery client constructor. */
+type CreateClientOptions = {
+    accessToken: string;
+    /**
+     * Base URL for the delivery client. Defaults to `DELIVERY_HOST` when omitted.
+     * Pass `PREVIEW_HOST` for preview mode, or any custom URL (staging, proxy,
+     * per-region). Both constants are exported from this package.
+     */
+    host?: string;
+} & Omit<ContentfulViewDeliveryClient.Options, 'token' | 'baseUrl'>;
+type RuntimeDeliveryClientBaseOptions = Omit<ContentfulViewDeliveryClient.Options, 'token' | 'baseUrl'>;
+/** Configuration for a Delivery or Preview client owned by a runtime. */
+type RuntimeDeliveryClientOptions = RuntimeDeliveryClientBaseOptions & ({
+    /** Bearer token or token supplier used for direct Delivery/Preview API access. */
+    accessToken: ContentfulViewDeliveryClient.Options['token'];
+    /** Optional endpoint override or endpoint supplier. */
+    host?: ContentfulViewDeliveryClient.Options['baseUrl'];
+} | {
+    accessToken?: never;
+    /** Explicit proxy endpoint that owns upstream authentication. */
+    host: NonNullable<ContentfulViewDeliveryClient.Options['baseUrl']>;
+});
+declare function createClient(options: CreateClientOptions): ContentfulViewDeliveryClient;
+/** Constructs a runtime-owned client, disabling generated auth for a tokenless proxy. */
+declare function createRuntimeDeliveryClient(options: RuntimeDeliveryClientOptions, defaultHost?: NonNullable<ContentfulViewDeliveryClient.Options['baseUrl']>): ContentfulViewDeliveryClient;
+
+export { type CreateClientOptions, type RuntimeDeliveryClientOptions, createClient, createRuntimeDeliveryClient };

package/dist/create-delivery-client.js

@@ -0,0 +1,27 @@
+import { ContentfulViewDeliveryClient } from "@contentful/experience-delivery";
+function createClient(options) {
+  const { accessToken, host, ...rest } = options;
+  return new ContentfulViewDeliveryClient({
+    ...rest,
+    token: accessToken,
+    baseUrl: host
+  });
+}
+function createRuntimeDeliveryClient(options, defaultHost) {
+  const { accessToken, host, ...rest } = options;
+  if (accessToken === void 0 && host === void 0) {
+    throw new Error(
+      "Runtime delivery configuration requires accessToken unless an explicit proxy host is provided"
+    );
+  }
+  const baseUrl = host ?? (rest.environment === void 0 ? defaultHost : void 0);
+  const clientOptions = accessToken === void 0 ? { ...rest, auth: rest.auth ?? false, baseUrl } : { ...rest, token: accessToken, baseUrl };
+  return new ContentfulViewDeliveryClient(
+    clientOptions
+  );
+}
+export {
+  createClient,
+  createRuntimeDeliveryClient
+};
+//# sourceMappingURL=create-delivery-client.js.map

package/dist/create-delivery-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/create-delivery-client.ts"],"sourcesContent":["import { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\n\n/** Options for the legacy functional Delivery client constructor. */\nexport type CreateClientOptions = {\n  accessToken: string;\n  /**\n   * Base URL for the delivery client. Defaults to `DELIVERY_HOST` when omitted.\n   * Pass `PREVIEW_HOST` for preview mode, or any custom URL (staging, proxy,\n   * per-region). Both constants are exported from this package.\n   */\n  host?: string;\n} & Omit<ContentfulViewDeliveryClient.Options, 'token' | 'baseUrl'>;\n\ntype RuntimeDeliveryClientBaseOptions = Omit<\n  ContentfulViewDeliveryClient.Options,\n  'token' | 'baseUrl'\n>;\n\n/** Configuration for a Delivery or Preview client owned by a runtime. */\nexport type RuntimeDeliveryClientOptions = RuntimeDeliveryClientBaseOptions &\n  (\n    | {\n        /** Bearer token or token supplier used for direct Delivery/Preview API access. */\n        accessToken: ContentfulViewDeliveryClient.Options['token'];\n        /** Optional endpoint override or endpoint supplier. */\n        host?: ContentfulViewDeliveryClient.Options['baseUrl'];\n      }\n    | {\n        accessToken?: never;\n        /** Explicit proxy endpoint that owns upstream authentication. */\n        host: NonNullable<ContentfulViewDeliveryClient.Options['baseUrl']>;\n      }\n  );\n\nexport function createClient(options: CreateClientOptions): ContentfulViewDeliveryClient {\n  const { accessToken, host, ...rest } = options;\n  return new ContentfulViewDeliveryClient({\n    ...rest,\n    token: accessToken,\n    baseUrl: host,\n  });\n}\n\n/** Constructs a runtime-owned client, disabling generated auth for a tokenless proxy. */\nexport function createRuntimeDeliveryClient(\n  options: RuntimeDeliveryClientOptions,\n  defaultHost?: NonNullable<ContentfulViewDeliveryClient.Options['baseUrl']>\n): ContentfulViewDeliveryClient {\n  const { accessToken, host, ...rest } = options;\n  if (accessToken === undefined && host === undefined) {\n    throw new Error(\n      'Runtime delivery configuration requires accessToken unless an explicit proxy host is provided'\n    );\n  }\n\n  const baseUrl = host ?? (rest.environment === undefined ? defaultHost : undefined);\n  const clientOptions =\n    accessToken === undefined\n      ? { ...rest, auth: rest.auth ?? false, baseUrl }\n      : { ...rest, token: accessToken, baseUrl };\n\n  return new ContentfulViewDeliveryClient(\n    clientOptions as unknown as ContentfulViewDeliveryClient.Options\n  );\n}\n"],"mappings":"AAAA,SAAS,oCAAoC;AAkCtC,SAAS,aAAa,SAA4D;AACvF,QAAM,EAAE,aAAa,MAAM,GAAG,KAAK,IAAI;AACvC,SAAO,IAAI,6BAA6B;AAAA,IACtC,GAAG;AAAA,IACH,OAAO;AAAA,IACP,SAAS;AAAA,EACX,CAAC;AACH;AAGO,SAAS,4BACd,SACA,aAC8B;AAC9B,QAAM,EAAE,aAAa,MAAM,GAAG,KAAK,IAAI;AACvC,MAAI,gBAAgB,UAAa,SAAS,QAAW;AACnD,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,UAAU,SAAS,KAAK,gBAAgB,SAAY,cAAc;AACxE,QAAM,gBACJ,gBAAgB,SACZ,EAAE,GAAG,MAAM,MAAM,KAAK,QAAQ,OAAO,QAAQ,IAC7C,EAAE,GAAG,MAAM,OAAO,aAAa,QAAQ;AAE7C,SAAO,IAAI;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/create-optimization-client.d.ts

@@ -0,0 +1,20 @@
+import { ExperienceApiClientConfig, InsightsApiClientConfig, ApiClientConfig } from '@contentful/optimization-api-client';
+import { RuntimeOptimizationApiClient } from './runtime-event-methods.js';
+import '@contentful/optimization-api-client/api-schemas';
+import './event-builder.js';
+import 'zod/mini';
+
+/** Stable configuration for the runtime-owned Optimization API client. */
+type RuntimeOptimizationConfig = {
+    personalizationBaseUrl?: ExperienceApiClientConfig['baseUrl'];
+    analyticsBaseUrl?: InsightsApiClientConfig['baseUrl'];
+    personalizationEnabledFeatures?: ExperienceApiClientConfig['enabledFeatures'];
+    fetchOptions?: ApiClientConfig['fetchOptions'];
+};
+type CreateRuntimeOptimizationClientOptions = RuntimeOptimizationConfig & {
+    spaceId: string;
+    environmentId: string;
+};
+declare function createRuntimeOptimizationClient({ spaceId, environmentId, personalizationBaseUrl, analyticsBaseUrl, personalizationEnabledFeatures, fetchOptions, }: CreateRuntimeOptimizationClientOptions): RuntimeOptimizationApiClient;
+
+export { type RuntimeOptimizationConfig, createRuntimeOptimizationClient };

package/dist/create-optimization-client.js

@@ -0,0 +1,30 @@
+import {
+  ApiClient as OptimizationApiClient
+} from "@contentful/optimization-api-client";
+function createRuntimeOptimizationClient({
+  spaceId,
+  environmentId,
+  personalizationBaseUrl,
+  analyticsBaseUrl,
+  personalizationEnabledFeatures,
+  fetchOptions
+}) {
+  const client = new OptimizationApiClient({
+    spaceId,
+    environment: environmentId,
+    fetchOptions,
+    experience: {
+      baseUrl: personalizationBaseUrl,
+      enabledFeatures: personalizationEnabledFeatures
+    },
+    insights: { baseUrl: analyticsBaseUrl }
+  });
+  return {
+    personalization: client.experience,
+    analytics: client.insights
+  };
+}
+export {
+  createRuntimeOptimizationClient
+};
+//# sourceMappingURL=create-optimization-client.js.map

package/dist/create-optimization-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/create-optimization-client.ts"],"sourcesContent":["import {\n  ApiClient as OptimizationApiClient,\n  type ApiClientConfig as OptimizationApiClientConfig,\n  type ExperienceApiClientConfig as PersonalizationApiClientConfig,\n  type InsightsApiClientConfig as AnalyticsApiClientConfig,\n} from '@contentful/optimization-api-client';\nimport type { RuntimeOptimizationApiClient } from './runtime-event-methods.js';\n\n/** Stable configuration for the runtime-owned Optimization API client. */\nexport type RuntimeOptimizationConfig = {\n  personalizationBaseUrl?: PersonalizationApiClientConfig['baseUrl'];\n  analyticsBaseUrl?: AnalyticsApiClientConfig['baseUrl'];\n  personalizationEnabledFeatures?: PersonalizationApiClientConfig['enabledFeatures'];\n  fetchOptions?: OptimizationApiClientConfig['fetchOptions'];\n};\n\ntype CreateRuntimeOptimizationClientOptions = RuntimeOptimizationConfig & {\n  spaceId: string;\n  environmentId: string;\n};\n\nexport function createRuntimeOptimizationClient({\n  spaceId,\n  environmentId,\n  personalizationBaseUrl,\n  analyticsBaseUrl,\n  personalizationEnabledFeatures,\n  fetchOptions,\n}: CreateRuntimeOptimizationClientOptions): RuntimeOptimizationApiClient {\n  const client = new OptimizationApiClient({\n    spaceId,\n    environment: environmentId,\n    fetchOptions,\n    experience: {\n      baseUrl: personalizationBaseUrl,\n      enabledFeatures: personalizationEnabledFeatures,\n    },\n    insights: { baseUrl: analyticsBaseUrl },\n  });\n\n  return {\n    personalization: client.experience,\n    analytics: client.insights,\n  };\n}\n"],"mappings":"AAAA;AAAA,EACE,aAAa;AAAA,OAIR;AAgBA,SAAS,gCAAgC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyE;AACvE,QAAM,SAAS,IAAI,sBAAsB;AAAA,IACvC;AAAA,IACA,aAAa;AAAA,IACb;AAAA,IACA,YAAY;AAAA,MACV,SAAS;AAAA,MACT,iBAAiB;AAAA,IACnB;AAAA,IACA,UAAU,EAAE,SAAS,iBAAiB;AAAA,EACxC,CAAC;AAED,SAAO;AAAA,IACL,iBAAiB,OAAO;AAAA,IACxB,WAAW,OAAO;AAAA,EACpB;AACF;","names":[]}

package/dist/event-builder.js

@@ -1,18 +1,18 @@
 import {
-  Campaign,
-  ExoEntityKind,
-  GeoLocation,
-  Page,
-  PageEventContext,
-  parseWithFriendlyError,
-  Properties,
-  Screen,
-  Traits
+  Campaign as OptimizationCampaign,
+  ExoEntityKind as OptimizationExoEntityKind,
+  GeoLocation as OptimizationGeoLocation,
+  Page as OptimizationPage,
+  PageEventContext as OptimizationPageEventContext,
+  parseWithFriendlyError as parseOptimizationSchema,
+  Properties as OptimizationProperties,
+  Screen as OptimizationScreen,
+  Traits as OptimizationTraits
 } from "@contentful/optimization-api-client/api-schemas";
-import { createScopedLogger } from "@contentful/optimization-api-client/logger";
+import { createScopedLogger as createOptimizationScopedLogger } from "@contentful/optimization-api-client/logger";
 import { merge } from "es-toolkit/object";
 import * as z from "zod/mini";
-const eventBuilderLogger = createScopedLogger("Experiences:EventBuilder");
+const eventBuilderLogger = createOptimizationScopedLogger("Experiences:EventBuilder");
 const UTM_CAMPAIGN_PARAMETERS = [
   ["utm_campaign", "name"],
   ["utm_source", "source"],
@@ -37,16 +37,16 @@ function extractCampaignFromUrl(url) {
   }
 }
 const UniversalEventBuilderArgs = z.object({
-  campaign: z.optional(Campaign),
+  campaign: z.optional(OptimizationCampaign),
   locale: z.optional(z.string()),
-  location: z.optional(GeoLocation),
-  page: z.optional(Page),
-  screen: z.optional(Screen),
+  location: z.optional(OptimizationGeoLocation),
+  page: z.optional(OptimizationPage),
+  screen: z.optional(OptimizationScreen),
   userAgent: z.optional(z.string())
 });
 const InteractionBuilderArgsBase = z.extend(UniversalEventBuilderArgs, {
   entityId: z.string(),
-  entityKind: ExoEntityKind,
+  entityKind: OptimizationExoEntityKind,
   entityKindId: z.optional(z.string()),
   entryIds: z.optional(z.array(z.string())),
   optimizationId: z.optional(z.string()),
@@ -74,15 +74,15 @@ const FlagViewBuilderArgs = z.extend(FlagInteractionBuilderArgsBase, {
   viewDurationMs: z.optional(z.number())
 });
 const IdentifyBuilderArgs = z.extend(UniversalEventBuilderArgs, {
-  traits: z.optional(Traits),
+  traits: z.optional(OptimizationTraits),
   userId: z.string()
 });
 const PageViewBuilderArgs = z.extend(UniversalEventBuilderArgs, {
-  properties: z.optional(z.partial(Page))
+  properties: z.optional(z.partial(OptimizationPage))
 });
 const TrackBuilderArgs = z.extend(UniversalEventBuilderArgs, {
   event: z.string(),
-  properties: z.optional(z.prefault(Properties, {}))
+  properties: z.optional(z.prefault(OptimizationProperties, {}))
 });
 const PAGE_CONTEXT_CONFLICT_KEYS = ["path", "query", "search", "url"];
 function warnIfPageContextConflicts(explicitPage, properties) {
@@ -167,7 +167,7 @@ class EventBuilder {
     };
   }
   buildView(args) {
-    const { viewId, viewDurationMs, ...interaction } = parseWithFriendlyError(
+    const { viewId, viewDurationMs, ...interaction } = parseOptimizationSchema(
       ViewBuilderArgs,
       args
     );
@@ -179,14 +179,14 @@ class EventBuilder {
     };
   }
   buildClick(args) {
-    const interaction = parseWithFriendlyError(ClickBuilderArgs, args);
+    const interaction = parseOptimizationSchema(ClickBuilderArgs, args);
     return {
       ...this.buildInteractionBase(interaction),
       type: "exo_node_click"
     };
   }
   buildHover(args) {
-    const { hoverId, hoverDurationMs, ...interaction } = parseWithFriendlyError(
+    const { hoverId, hoverDurationMs, ...interaction } = parseOptimizationSchema(
       HoverBuilderArgs,
       args
     );
@@ -198,7 +198,7 @@ class EventBuilder {
     };
   }
   buildFlagView(args) {
-    const { componentId, experienceId, variantIndex, viewId, viewDurationMs, ...universal } = parseWithFriendlyError(FlagViewBuilderArgs, args);
+    const { componentId, experienceId, variantIndex, viewId, viewDurationMs, ...universal } = parseOptimizationSchema(FlagViewBuilderArgs, args);
     return {
       ...this.buildUniversalEventProperties(universal),
       ...viewDurationMs === void 0 ? {} : { viewDurationMs },
@@ -211,7 +211,11 @@ class EventBuilder {
     };
   }
   buildIdentify(args) {
-    const { traits = {}, userId, ...universal } = parseWithFriendlyError(IdentifyBuilderArgs, args);
+    const {
+      traits = {},
+      userId,
+      ...universal
+    } = parseOptimizationSchema(IdentifyBuilderArgs, args);
     return {
       ...this.buildUniversalEventProperties(universal),
       type: "identify",
@@ -220,7 +224,7 @@ class EventBuilder {
     };
   }
   buildPageView(args = {}) {
-    const { properties = {}, ...universal } = parseWithFriendlyError(PageViewBuilderArgs, args);
+    const { properties = {}, ...universal } = parseOptimizationSchema(PageViewBuilderArgs, args);
     const propertiesCampaign = extractCampaignFromUrl(properties.url);
     const pageProperties = this.getPageProperties();
     const merged = merge(
@@ -239,7 +243,7 @@ class EventBuilder {
       campaign: universal.campaign ?? propertiesCampaign,
       page: universal.page ?? merged
     });
-    const context = parseWithFriendlyError(PageEventContext, universalContext);
+    const context = parseOptimizationSchema(OptimizationPageEventContext, universalContext);
     return {
       ...universalProperties,
       context,
@@ -248,7 +252,11 @@ class EventBuilder {
     };
   }
   buildTrack(args) {
-    const { event, properties = {}, ...universal } = parseWithFriendlyError(TrackBuilderArgs, args);
+    const {
+      event,
+      properties = {},
+      ...universal
+    } = parseOptimizationSchema(TrackBuilderArgs, args);
     return {
       ...this.buildUniversalEventProperties(universal),
       type: "track",