@contentful/experiences-client 0.4.8 → 0.5.0

package/CHANGELOG.md

@@ -1,3 +1,47 @@
+## 0.5.0 (2026-09-28)
+
+### 🚀 Features
+
+- ⚠️  add request-scoped Node SDK ([#207](https://github.com/contentful/experiences/pull/207))
+
+### ⚠️  Breaking Changes
+
+- add request-scoped Node SDK  ([#207](https://github.com/contentful/experiences/pull/207))
+  ContentfulExperiencesConfig now requires eventBuilder.channel."
+  M	.husky/pre-commit
+  M	AGENTS.md
+  M	ARCHITECTURE.md
+  M	README.md
+  M	package-lock.json
+  M	packages/client/README.md
+  M	packages/client/src/contentful-experiences.test.ts
+  M	packages/client/src/contentful-experiences.ts
+  A	packages/node/README.md
+  A	packages/node/package.json
+  A	packages/node/project.json
+  A	packages/node/src/contentful-experiences.test.ts
+  A	packages/node/src/contentful-experiences.ts
+  A	packages/node/src/index.ts
+  A	packages/node/src/sdk-info.ts
+  A	packages/node/tsconfig.json
+  A	packages/node/tsconfig.lib.json
+  A	packages/node/tsup.config.ts
+  A	packages/node/vitest.config.ts
+
+### 🧱 Updated Dependencies
+
+- Updated core to 0.9.0
+
+## 0.4.9 (2026-09-28)
+
+### 🚀 Features
+
+- add shared Experiences client runtime ([#206](https://github.com/contentful/experiences/pull/206))
+
+### 🧱 Updated Dependencies
+
+- Updated core to 0.8.7
+
 ## 0.4.8 (2026-09-22)
 
 ### 🚀 Features

package/README.md

@@ -2,12 +2,36 @@
 
 > **Internal package.** Published to npm so framework adapters can resolve it at install time, but you're not meant to import it directly. It comes in transitively via the framework adapter (`@contentful/experiences-react`, `@contentful/experiences-svelte`, etc.).
 
-Isolates `@contentful/experience-delivery` — the generated experience delivery client — so that `@contentful/experiences-sdk-core` stays zero-dep and framework adapters that don't need network access don't pull it in transitively.
+Isolates `@contentful/experience-delivery` — the generated experience delivery client — so that `@contentful/experiences-sdk-core` stays dependency-free and framework adapters that don't need network access don't pull it in transitively. It also owns the lower-layer shared `ContentfulExperiences` runtime for future Node/Web SDKs and event construction.
+
+`ContentfulExperiences` is intentionally not re-exported by framework adapters
+and is not a new application-facing adapter API. The existing free functions
+remain supported for adapter and application integration.
 
 ---
 
 ## What's in here
 
+### Shared lower-layer runtime
+
+`ContentfulExperiences` is an internal shared runtime contract for future
+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 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.
+
+This package's direct dependencies are the generated delivery client,
+`@contentful/optimization-api-client` (event schemas and logger), `es-toolkit`
+(event-property merging), and `zod` (event argument schemas), in addition to
+Core. None of those dependencies are introduced into Core.
+
 ### `fetchExperience(experienceOptions, clientOptions, resolveOptions)`
 
 The primary fetch + resolve entry point. Fetches an Experience payload from the Experience Delivery API and resolves it into a `PortableRenderPlan` in one call.

package/dist/contentful-experiences.d.ts

@@ -0,0 +1,69 @@
+import { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';
+import { ExperiencePayload, PortableRenderPlan, ResolverConfig } from '@contentful/experiences-sdk-core';
+import EventBuilder, { EventBuilderConfig } from './event-builder.js';
+import { DestinationRedirectResult } from './fetch-experience.js';
+import { CreateClientOptions } from './create-client.js';
+import '@contentful/optimization-api-client/api-schemas';
+import 'zod/mini';
+
+type RuntimeClientSource = CreateClientOptions | {
+    client: ContentfulViewDeliveryClient;
+};
+type RuntimeResolveOptions = {
+    metadata?: Record<string, unknown>;
+    debug?: boolean;
+    initialViewportId?: string;
+};
+type RuntimeEventBuilderConfig = Omit<EventBuilderConfig, 'channel' | 'library'> & {
+    channel: EventBuilderConfig['channel'];
+    library?: Partial<EventBuilderConfig['library']>;
+};
+type RuntimeFetchExperienceOptions = {
+    experienceId: string;
+    locale?: string;
+    preview?: boolean;
+    withSourceMap?: boolean;
+};
+type RuntimeFetchByDestinationNodeOptions = {
+    destinationId: string;
+    nodeId: string;
+};
+type RuntimeFetchByDestinationPathOptions = {
+    destinationId: string;
+    path: string;
+};
+/** Structural contract implemented by the Client runtime. */
+interface ExperienceRuntime {
+    readonly spaceId: string;
+    readonly environmentId: string;
+    readonly locale: string | undefined;
+    readonly eventBuilder: EventBuilder;
+    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>;
+}
+type ContentfulExperiencesConfig = {
+    spaceId: string;
+    environmentId: string;
+    locale?: string;
+    resolverConfig: ResolverConfig;
+    delivery: RuntimeClientSource;
+    preview?: RuntimeClientSource;
+    resolveDefaults?: Pick<RuntimeResolveOptions, 'metadata' | 'debug'>;
+    eventBuilder: RuntimeEventBuilderConfig;
+};
+declare class ContentfulExperiences implements ExperienceRuntime {
+    #private;
+    readonly spaceId: string;
+    readonly environmentId: string;
+    readonly locale: string | undefined;
+    readonly eventBuilder: EventBuilder;
+    constructor(config: ContentfulExperiencesConfig);
+    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 };

package/dist/contentful-experiences.js

@@ -0,0 +1,85 @@
+import { resolveExperience as resolveCoreExperience } from "@contentful/experiences-sdk-core";
+import EventBuilder from "./event-builder.js";
+import { createClient } from "./create-client.js";
+import { fetchExperience } from "./fetch-experience.js";
+import { PREVIEW_HOST } from "./hosts.js";
+import { DEFAULT_EVENT_CONTEXT_LIBRARY } from "./sdk-info.js";
+class ContentfulExperiences {
+  spaceId;
+  environmentId;
+  locale;
+  eventBuilder;
+  #resolverConfig;
+  #deliveryClient;
+  #previewClient;
+  #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.#resolveDefaults = config.resolveDefaults ?? {};
+    this.eventBuilder = new EventBuilder({
+      ...config.eventBuilder,
+      library: { ...DEFAULT_EVENT_CONTEXT_LIBRARY, ...config.eventBuilder.library },
+      getLocale: config.eventBuilder.getLocale ?? (() => this.locale)
+    });
+  }
+  resolveExperience(payload, resolveOptions) {
+    return resolveCoreExperience(
+      payload,
+      this.#resolverConfig,
+      this.#mergeResolveOptions(resolveOptions)
+    );
+  }
+  fetchExperience(options, resolveOptions) {
+    if (options.preview === true && this.#previewClient === void 0) {
+      throw new Error(
+        "fetchExperience() called with preview: true but this runtime has no preview client"
+      );
+    }
+    return fetchExperience(
+      {
+        spaceId: this.spaceId,
+        environmentId: this.environmentId,
+        experienceId: options.experienceId,
+        locale: options.locale ?? this.locale,
+        withSourceMap: options.withSourceMap
+      },
+      {
+        client: options.preview ? this.#previewClient : this.#deliveryClient
+      },
+      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }
+    );
+  }
+  fetchByDestinationNode(options, resolveOptions) {
+    return fetchExperience(
+      { spaceId: this.spaceId, destinationId: options.destinationId, nodeId: options.nodeId },
+      { client: this.#deliveryClient },
+      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }
+    );
+  }
+  fetchByDestinationPath(options, resolveOptions) {
+    return fetchExperience(
+      { spaceId: this.spaceId, destinationId: options.destinationId, path: options.path },
+      { client: this.#deliveryClient },
+      { config: this.#resolverConfig, ...this.#mergeResolveOptions(resolveOptions) }
+    );
+  }
+  #mergeResolveOptions(options) {
+    return {
+      metadata: { ...this.#resolveDefaults.metadata, ...options?.metadata },
+      debug: options?.debug ?? this.#resolveDefaults.debug,
+      initialViewportId: options?.initialViewportId
+    };
+  }
+}
+function resolveClient(source, defaultHost) {
+  return "client" in source ? source.client : createClient({ ...source, host: source.host ?? defaultHost });
+}
+export {
+  ContentfulExperiences
+};
+//# sourceMappingURL=contentful-experiences.js.map

package/dist/contentful-experiences.js.map

@@ -0,0 +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 { fetchExperience, type DestinationRedirectResult } 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  preview?: boolean;\n  withSourceMap?: 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 locale: string | undefined;\n  readonly eventBuilder: EventBuilder;\n\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  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        withSourceMap: options.withSourceMap,\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  return 'client' in source\n    ? source.client\n    : createClient({ ...source, host: source.host ?? defaultHost });\n}\n"],"mappings":"AACA,SAAS,qBAAqB,6BAA6B;AAM3D,OAAO,kBAAkB;AAEzB,SAAS,oBAAoB;AAC7B,SAAS,uBAAuD;AAEhE,SAAS,oBAAoB;AAC7B,SAAS,qCAAqC;AAmEvC,MAAM,sBAAmD;AAAA,EACrD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,QAAqC;AAC/C,SAAK,UAAU,OAAO;AACtB,SAAK,gBAAgB,OAAO;AAC5B,SAAK,SAAS,OAAO;AACrB,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,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,eAAe,QAAQ;AAAA,MACzB;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,SAAO,YAAY,SACf,OAAO,SACP,aAAa,EAAE,GAAG,QAAQ,MAAM,OAAO,QAAQ,YAAY,CAAC;AAClE;","names":[]}

package/dist/event-builder.d.ts

@@ -0,0 +1,444 @@
+import { App, Channel, Library, Page, UniversalEventProperties, ExoViewEvent, ExoClickEvent, ExoHoverEvent, ViewEvent, IdentifyEvent, PageViewEvent, TrackEvent } from '@contentful/optimization-api-client/api-schemas';
+import * as z from 'zod/mini';
+
+interface EventBuilderConfig {
+    app?: App;
+    channel: Channel;
+    library: Library;
+    getLocale?: () => string | undefined;
+    getPageProperties?: () => Page;
+    getUserAgent?: () => string | undefined;
+    getConsent?: () => boolean | undefined;
+}
+declare const UniversalEventBuilderArgs: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+}, z.core.$strip>;
+type UniversalEventBuilderArgs = z.infer<typeof UniversalEventBuilderArgs>;
+declare const InteractionBuilderArgsBase: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    entityId: z.ZodMiniString<string>;
+    entityKind: z.ZodMiniEnum<{
+        Experience: "Experience";
+        Fragment: "Fragment";
+        InlineFragment: "InlineFragment";
+        InlineComponent: "InlineComponent";
+    }>;
+    entityKindId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    entryIds: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    optimizationId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    parameters: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniJSONSchema>>;
+    parentExperienceId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantIndex: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+}, z.core.$strip>;
+type InteractionBuilderArgsBase = z.infer<typeof InteractionBuilderArgsBase>;
+declare const ViewBuilderArgs: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    entityId: z.ZodMiniString<string>;
+    entityKind: z.ZodMiniEnum<{
+        Experience: "Experience";
+        Fragment: "Fragment";
+        InlineFragment: "InlineFragment";
+        InlineComponent: "InlineComponent";
+    }>;
+    entityKindId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    entryIds: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    optimizationId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    parameters: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniJSONSchema>>;
+    parentExperienceId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantIndex: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    viewId: z.ZodMiniString<string>;
+    viewDurationMs: z.ZodMiniInt;
+}, z.core.$strip>;
+type ViewBuilderArgs = z.infer<typeof ViewBuilderArgs>;
+declare const ClickBuilderArgs: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    entityId: z.ZodMiniString<string>;
+    entityKind: z.ZodMiniEnum<{
+        Experience: "Experience";
+        Fragment: "Fragment";
+        InlineFragment: "InlineFragment";
+        InlineComponent: "InlineComponent";
+    }>;
+    entityKindId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    entryIds: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    optimizationId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    parameters: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniJSONSchema>>;
+    parentExperienceId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantIndex: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+}, z.core.$strip>;
+type ClickBuilderArgs = z.infer<typeof ClickBuilderArgs>;
+declare const HoverBuilderArgs: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    entityId: z.ZodMiniString<string>;
+    entityKind: z.ZodMiniEnum<{
+        Experience: "Experience";
+        Fragment: "Fragment";
+        InlineFragment: "InlineFragment";
+        InlineComponent: "InlineComponent";
+    }>;
+    entityKindId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    entryIds: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    optimizationId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    parameters: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniJSONSchema>>;
+    parentExperienceId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantIndex: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    hoverId: z.ZodMiniString<string>;
+    hoverDurationMs: z.ZodMiniInt;
+}, z.core.$strip>;
+type HoverBuilderArgs = z.infer<typeof HoverBuilderArgs>;
+declare const FlagViewBuilderArgs: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    componentId: z.ZodMiniString<string>;
+    experienceId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    variantIndex: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    viewId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    viewDurationMs: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+}, z.core.$strip>;
+type FlagViewBuilderArgs = z.infer<typeof FlagViewBuilderArgs>;
+declare const IdentifyBuilderArgs: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    traits: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniJSONSchema>>;
+    userId: z.ZodMiniString<string>;
+}, z.core.$strip>;
+type IdentifyBuilderArgs = z.infer<typeof IdentifyBuilderArgs>;
+declare const PageViewBuilderArgs: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    properties: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        query: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+        referrer: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        search: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        title: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniString<string>>>;
+        url: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+}, z.core.$strip>;
+type PageViewBuilderArgs = z.infer<typeof PageViewBuilderArgs>;
+declare const TrackBuilderArgs: z.ZodMiniObject<{
+    campaign: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        source: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        medium: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        term: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        content: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    locale: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    location: z.ZodMiniOptional<z.ZodMiniObject<{
+        coordinates: z.ZodMiniOptional<z.ZodMiniObject<{
+            latitude: z.ZodMiniNumber<number>;
+            longitude: z.ZodMiniNumber<number>;
+        }, z.core.$strip>>;
+        city: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        region: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        regionCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        countryCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        continent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        timezone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strip>>;
+    page: z.ZodMiniOptional<z.ZodMiniObject<{
+        path: z.ZodMiniString<string>;
+        query: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+        referrer: z.ZodMiniString<string>;
+        search: z.ZodMiniString<string>;
+        title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    screen: z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$catchall<z.ZodMiniJSONSchema>>>;
+    userAgent: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    event: z.ZodMiniString<string>;
+    properties: z.ZodMiniOptional<z.ZodMiniPrefault<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniJSONSchema>>>;
+}, z.core.$strip>;
+type TrackBuilderArgs = z.infer<typeof TrackBuilderArgs>;
+declare const DEFAULT_PAGE_PROPERTIES: Page;
+declare class EventBuilder {
+    app?: App;
+    channel: Channel;
+    library: Library;
+    getLocale: () => string | undefined;
+    getPageProperties: () => Page;
+    getUserAgent: () => string | undefined;
+    getConsent: () => boolean | undefined;
+    constructor(config: EventBuilderConfig);
+    protected buildUniversalEventProperties({ campaign, locale, location, page, screen, userAgent, }: UniversalEventBuilderArgs): UniversalEventProperties;
+    private buildInteractionBase;
+    buildView(args: ViewBuilderArgs): ExoViewEvent;
+    buildClick(args: ClickBuilderArgs): ExoClickEvent;
+    buildHover(args: HoverBuilderArgs): ExoHoverEvent;
+    buildFlagView(args: FlagViewBuilderArgs): ViewEvent;
+    buildIdentify(args: IdentifyBuilderArgs): IdentifyEvent;
+    buildPageView(args?: PageViewBuilderArgs): PageViewEvent;
+    buildTrack(args: TrackBuilderArgs): TrackEvent;
+}
+
+export { ClickBuilderArgs, DEFAULT_PAGE_PROPERTIES, type EventBuilderConfig, FlagViewBuilderArgs, HoverBuilderArgs, IdentifyBuilderArgs, InteractionBuilderArgsBase, PageViewBuilderArgs, TrackBuilderArgs, UniversalEventBuilderArgs, ViewBuilderArgs, EventBuilder as default };

package/dist/event-builder.js

@@ -0,0 +1,274 @@
+import {
+  Campaign,
+  ExoEntityKind,
+  GeoLocation,
+  Page,
+  PageEventContext,
+  parseWithFriendlyError,
+  Properties,
+  Screen,
+  Traits
+} from "@contentful/optimization-api-client/api-schemas";
+import { createScopedLogger } from "@contentful/optimization-api-client/logger";
+import { merge } from "es-toolkit/object";
+import * as z from "zod/mini";
+const eventBuilderLogger = createScopedLogger("Experiences:EventBuilder");
+const UTM_CAMPAIGN_PARAMETERS = [
+  ["utm_campaign", "name"],
+  ["utm_source", "source"],
+  ["utm_medium", "medium"],
+  ["utm_term", "term"],
+  ["utm_content", "content"]
+];
+function extractCampaignFromUrl(url) {
+  if (url === void 0) return void 0;
+  try {
+    const { searchParams } = new URL(url);
+    const campaign = {};
+    let hasCampaignParameter = false;
+    for (const [parameter, property] of UTM_CAMPAIGN_PARAMETERS) {
+      if (!searchParams.has(parameter)) continue;
+      campaign[property] = searchParams.get(parameter) ?? "";
+      hasCampaignParameter = true;
+    }
+    return hasCampaignParameter ? campaign : void 0;
+  } catch {
+    return void 0;
+  }
+}
+const UniversalEventBuilderArgs = z.object({
+  campaign: z.optional(Campaign),
+  locale: z.optional(z.string()),
+  location: z.optional(GeoLocation),
+  page: z.optional(Page),
+  screen: z.optional(Screen),
+  userAgent: z.optional(z.string())
+});
+const InteractionBuilderArgsBase = z.extend(UniversalEventBuilderArgs, {
+  entityId: z.string(),
+  entityKind: ExoEntityKind,
+  entityKindId: z.optional(z.string()),
+  entryIds: z.optional(z.array(z.string())),
+  optimizationId: z.optional(z.string()),
+  parameters: z.optional(z.record(z.string(), z.json())),
+  parentExperienceId: z.optional(z.string()),
+  variantId: z.optional(z.string()),
+  variantIndex: z.optional(z.number())
+});
+const ViewBuilderArgs = z.extend(InteractionBuilderArgsBase, {
+  viewId: z.string(),
+  viewDurationMs: z.int().check(z.minimum(0))
+});
+const ClickBuilderArgs = InteractionBuilderArgsBase;
+const HoverBuilderArgs = z.extend(InteractionBuilderArgsBase, {
+  hoverId: z.string(),
+  hoverDurationMs: z.int().check(z.minimum(0))
+});
+const FlagInteractionBuilderArgsBase = z.extend(UniversalEventBuilderArgs, {
+  componentId: z.string(),
+  experienceId: z.optional(z.string()),
+  variantIndex: z.optional(z.number())
+});
+const FlagViewBuilderArgs = z.extend(FlagInteractionBuilderArgsBase, {
+  viewId: z.optional(z.string()),
+  viewDurationMs: z.optional(z.number())
+});
+const IdentifyBuilderArgs = z.extend(UniversalEventBuilderArgs, {
+  traits: z.optional(Traits),
+  userId: z.string()
+});
+const PageViewBuilderArgs = z.extend(UniversalEventBuilderArgs, {
+  properties: z.optional(z.partial(Page))
+});
+const TrackBuilderArgs = z.extend(UniversalEventBuilderArgs, {
+  event: z.string(),
+  properties: z.optional(z.prefault(Properties, {}))
+});
+const PAGE_CONTEXT_CONFLICT_KEYS = ["path", "query", "search", "url"];
+function warnIfPageContextConflicts(explicitPage, properties) {
+  if (!explicitPage) return;
+  const conflictingKeys = PAGE_CONTEXT_CONFLICT_KEYS.filter((key) => {
+    const { [key]: explicitValue } = explicitPage;
+    const { [key]: propertyValue } = properties;
+    return JSON.stringify(explicitValue) !== JSON.stringify(propertyValue);
+  });
+  if (conflictingKeys.length === 0) return;
+  eventBuilderLogger.warn(
+    `Explicit page context differs from page event properties for: ${conflictingKeys.join(", ")}`
+  );
+}
+const DEFAULT_PAGE_PROPERTIES = {
+  path: "",
+  query: {},
+  referrer: "",
+  search: "",
+  title: "",
+  url: ""
+};
+class EventBuilder {
+  app;
+  channel;
+  library;
+  getLocale;
+  getPageProperties;
+  getUserAgent;
+  getConsent;
+  constructor(config) {
+    const { app, channel, library, getLocale, getPageProperties, getUserAgent, getConsent } = config;
+    this.app = app;
+    this.channel = channel;
+    this.library = library;
+    this.getLocale = getLocale ?? (() => "en-US");
+    this.getPageProperties = getPageProperties ?? (() => DEFAULT_PAGE_PROPERTIES);
+    this.getUserAgent = getUserAgent ?? (() => void 0);
+    this.getConsent = getConsent ?? (() => void 0);
+  }
+  buildUniversalEventProperties({
+    campaign,
+    locale,
+    location,
+    page,
+    screen,
+    userAgent
+  }) {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const resolvedPage = page ?? this.getPageProperties();
+    return {
+      channel: this.channel,
+      context: {
+        app: this.app,
+        campaign: campaign ?? extractCampaignFromUrl(resolvedPage.url) ?? {},
+        gdpr: { isConsentGiven: this.getConsent() === true },
+        library: this.library,
+        locale: locale ?? this.getLocale() ?? "en-US",
+        location,
+        page: resolvedPage,
+        screen,
+        userAgent: userAgent ?? this.getUserAgent()
+      },
+      messageId: crypto.randomUUID(),
+      originalTimestamp: timestamp,
+      sentAt: timestamp,
+      timestamp
+    };
+  }
+  buildInteractionBase(args) {
+    const { campaign, locale, location, page, screen, userAgent, ...interactionProperties } = args;
+    return {
+      ...this.buildUniversalEventProperties({
+        campaign,
+        locale,
+        location,
+        page,
+        screen,
+        userAgent
+      }),
+      ...interactionProperties
+    };
+  }
+  buildView(args) {
+    const { viewId, viewDurationMs, ...interaction } = parseWithFriendlyError(
+      ViewBuilderArgs,
+      args
+    );
+    return {
+      ...this.buildInteractionBase(interaction),
+      type: "exo_node_view",
+      viewId,
+      viewDurationMs
+    };
+  }
+  buildClick(args) {
+    const interaction = parseWithFriendlyError(ClickBuilderArgs, args);
+    return {
+      ...this.buildInteractionBase(interaction),
+      type: "exo_node_click"
+    };
+  }
+  buildHover(args) {
+    const { hoverId, hoverDurationMs, ...interaction } = parseWithFriendlyError(
+      HoverBuilderArgs,
+      args
+    );
+    return {
+      ...this.buildInteractionBase(interaction),
+      type: "exo_node_hover",
+      hoverId,
+      hoverDurationMs
+    };
+  }
+  buildFlagView(args) {
+    const { componentId, experienceId, variantIndex, viewId, viewDurationMs, ...universal } = parseWithFriendlyError(FlagViewBuilderArgs, args);
+    return {
+      ...this.buildUniversalEventProperties(universal),
+      ...viewDurationMs === void 0 ? {} : { viewDurationMs },
+      ...viewId === void 0 ? {} : { viewId },
+      type: "component",
+      componentType: "Variable",
+      componentId,
+      experienceId,
+      variantIndex: variantIndex ?? 0
+    };
+  }
+  buildIdentify(args) {
+    const { traits = {}, userId, ...universal } = parseWithFriendlyError(IdentifyBuilderArgs, args);
+    return {
+      ...this.buildUniversalEventProperties(universal),
+      type: "identify",
+      traits,
+      userId
+    };
+  }
+  buildPageView(args = {}) {
+    const { properties = {}, ...universal } = parseWithFriendlyError(PageViewBuilderArgs, args);
+    const propertiesCampaign = extractCampaignFromUrl(properties.url);
+    const pageProperties = this.getPageProperties();
+    const merged = merge(
+      {
+        ...pageProperties,
+        title: pageProperties.title ?? DEFAULT_PAGE_PROPERTIES.title
+      },
+      properties
+    );
+    warnIfPageContextConflicts(universal.page, merged);
+    const {
+      context: { screen: _, ...universalContext },
+      ...universalProperties
+    } = this.buildUniversalEventProperties({
+      ...universal,
+      campaign: universal.campaign ?? propertiesCampaign,
+      page: universal.page ?? merged
+    });
+    const context = parseWithFriendlyError(PageEventContext, universalContext);
+    return {
+      ...universalProperties,
+      context,
+      type: "page",
+      properties: merged
+    };
+  }
+  buildTrack(args) {
+    const { event, properties = {}, ...universal } = parseWithFriendlyError(TrackBuilderArgs, args);
+    return {
+      ...this.buildUniversalEventProperties(universal),
+      type: "track",
+      event,
+      properties
+    };
+  }
+}
+var event_builder_default = EventBuilder;
+export {
+  ClickBuilderArgs,
+  DEFAULT_PAGE_PROPERTIES,
+  FlagViewBuilderArgs,
+  HoverBuilderArgs,
+  IdentifyBuilderArgs,
+  InteractionBuilderArgsBase,
+  PageViewBuilderArgs,
+  TrackBuilderArgs,
+  UniversalEventBuilderArgs,
+  ViewBuilderArgs,
+  event_builder_default as default
+};
+//# sourceMappingURL=event-builder.js.map

package/dist/event-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/event-builder.ts"],"sourcesContent":["/* eslint-disable no-redeclare */\n\nimport {\n  type App,\n  Campaign,\n  type Channel,\n  type ExoClickEvent,\n  ExoEntityKind,\n  type ExoHoverEvent,\n  type ExoViewEvent,\n  GeoLocation,\n  type IdentifyEvent,\n  type Library,\n  Page,\n  PageEventContext,\n  type PageViewEvent,\n  parseWithFriendlyError,\n  Properties,\n  Screen,\n  type TrackEvent,\n  Traits,\n  UniversalEventProperties,\n  type ViewEvent,\n} from '@contentful/optimization-api-client/api-schemas';\nimport { createScopedLogger } from '@contentful/optimization-api-client/logger';\nimport { merge } from 'es-toolkit/object';\nimport * as z from 'zod/mini';\n\nconst eventBuilderLogger = createScopedLogger('Experiences:EventBuilder');\n\nconst UTM_CAMPAIGN_PARAMETERS = [\n  ['utm_campaign', 'name'],\n  ['utm_source', 'source'],\n  ['utm_medium', 'medium'],\n  ['utm_term', 'term'],\n  ['utm_content', 'content'],\n] as const;\n\nfunction extractCampaignFromUrl(url: string | undefined): Campaign | undefined {\n  if (url === undefined) return undefined;\n\n  try {\n    const { searchParams } = new URL(url);\n    const campaign: Campaign = {};\n    let hasCampaignParameter = false;\n\n    for (const [parameter, property] of UTM_CAMPAIGN_PARAMETERS) {\n      if (!searchParams.has(parameter)) continue;\n\n      campaign[property] = searchParams.get(parameter) ?? '';\n      hasCampaignParameter = true;\n    }\n\n    return hasCampaignParameter ? campaign : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport interface EventBuilderConfig {\n  app?: App;\n  channel: Channel;\n  library: Library;\n  getLocale?: () => string | undefined;\n  getPageProperties?: () => Page;\n  getUserAgent?: () => string | undefined;\n  getConsent?: () => boolean | undefined;\n}\n\nexport const UniversalEventBuilderArgs = z.object({\n  campaign: z.optional(Campaign),\n  locale: z.optional(z.string()),\n  location: z.optional(GeoLocation),\n  page: z.optional(Page),\n  screen: z.optional(Screen),\n  userAgent: z.optional(z.string()),\n});\n\nexport type UniversalEventBuilderArgs = z.infer<typeof UniversalEventBuilderArgs>;\n\nexport const InteractionBuilderArgsBase = z.extend(UniversalEventBuilderArgs, {\n  entityId: z.string(),\n  entityKind: ExoEntityKind,\n  entityKindId: z.optional(z.string()),\n  entryIds: z.optional(z.array(z.string())),\n  optimizationId: z.optional(z.string()),\n  parameters: z.optional(z.record(z.string(), z.json())),\n  parentExperienceId: z.optional(z.string()),\n  variantId: z.optional(z.string()),\n  variantIndex: z.optional(z.number()),\n});\n\nexport type InteractionBuilderArgsBase = z.infer<typeof InteractionBuilderArgsBase>;\n\nexport const ViewBuilderArgs = z.extend(InteractionBuilderArgsBase, {\n  viewId: z.string(),\n  viewDurationMs: z.int().check(z.minimum(0)),\n});\n\nexport type ViewBuilderArgs = z.infer<typeof ViewBuilderArgs>;\n\nexport const ClickBuilderArgs = InteractionBuilderArgsBase;\n\nexport type ClickBuilderArgs = z.infer<typeof ClickBuilderArgs>;\n\nexport const HoverBuilderArgs = z.extend(InteractionBuilderArgsBase, {\n  hoverId: z.string(),\n  hoverDurationMs: z.int().check(z.minimum(0)),\n});\n\nexport type HoverBuilderArgs = z.infer<typeof HoverBuilderArgs>;\n\nconst FlagInteractionBuilderArgsBase = z.extend(UniversalEventBuilderArgs, {\n  componentId: z.string(),\n  experienceId: z.optional(z.string()),\n  variantIndex: z.optional(z.number()),\n});\n\nexport const FlagViewBuilderArgs = z.extend(FlagInteractionBuilderArgsBase, {\n  viewId: z.optional(z.string()),\n  viewDurationMs: z.optional(z.number()),\n});\n\nexport type FlagViewBuilderArgs = z.infer<typeof FlagViewBuilderArgs>;\n\nexport const IdentifyBuilderArgs = z.extend(UniversalEventBuilderArgs, {\n  traits: z.optional(Traits),\n  userId: z.string(),\n});\n\nexport type IdentifyBuilderArgs = z.infer<typeof IdentifyBuilderArgs>;\n\nexport const PageViewBuilderArgs = z.extend(UniversalEventBuilderArgs, {\n  properties: z.optional(z.partial(Page)),\n});\n\nexport type PageViewBuilderArgs = z.infer<typeof PageViewBuilderArgs>;\n\nexport const TrackBuilderArgs = z.extend(UniversalEventBuilderArgs, {\n  event: z.string(),\n  properties: z.optional(z.prefault(Properties, {})),\n});\n\nexport type TrackBuilderArgs = z.infer<typeof TrackBuilderArgs>;\n\nconst PAGE_CONTEXT_CONFLICT_KEYS = ['path', 'query', 'search', 'url'] as const;\n\nfunction warnIfPageContextConflicts(explicitPage: Page | undefined, properties: Page): void {\n  if (!explicitPage) return;\n\n  const conflictingKeys = PAGE_CONTEXT_CONFLICT_KEYS.filter((key) => {\n    const { [key]: explicitValue } = explicitPage;\n    const { [key]: propertyValue } = properties;\n    return JSON.stringify(explicitValue) !== JSON.stringify(propertyValue);\n  });\n\n  if (conflictingKeys.length === 0) return;\n\n  eventBuilderLogger.warn(\n    `Explicit page context differs from page event properties for: ${conflictingKeys.join(', ')}`\n  );\n}\n\nexport const DEFAULT_PAGE_PROPERTIES: Page = {\n  path: '',\n  query: {},\n  referrer: '',\n  search: '',\n  title: '',\n  url: '',\n};\n\nclass EventBuilder {\n  app?: App;\n  channel: Channel;\n  library: Library;\n  getLocale: () => string | undefined;\n  getPageProperties: () => Page;\n  getUserAgent: () => string | undefined;\n  getConsent: () => boolean | undefined;\n\n  constructor(config: EventBuilderConfig) {\n    const { app, channel, library, getLocale, getPageProperties, getUserAgent, getConsent } =\n      config;\n    this.app = app;\n    this.channel = channel;\n    this.library = library;\n    this.getLocale = getLocale ?? (() => 'en-US');\n    this.getPageProperties = getPageProperties ?? (() => DEFAULT_PAGE_PROPERTIES);\n    this.getUserAgent = getUserAgent ?? (() => undefined);\n    this.getConsent = getConsent ?? (() => undefined);\n  }\n\n  protected buildUniversalEventProperties({\n    campaign,\n    locale,\n    location,\n    page,\n    screen,\n    userAgent,\n  }: UniversalEventBuilderArgs): UniversalEventProperties {\n    const timestamp = new Date().toISOString();\n    const resolvedPage = page ?? this.getPageProperties();\n\n    return {\n      channel: this.channel,\n      context: {\n        app: this.app,\n        campaign: campaign ?? extractCampaignFromUrl(resolvedPage.url) ?? {},\n        gdpr: { isConsentGiven: this.getConsent() === true },\n        library: this.library,\n        locale: locale ?? this.getLocale() ?? 'en-US',\n        location,\n        page: resolvedPage,\n        screen,\n        userAgent: userAgent ?? this.getUserAgent(),\n      },\n      messageId: crypto.randomUUID(),\n      originalTimestamp: timestamp,\n      sentAt: timestamp,\n      timestamp,\n    };\n  }\n\n  private buildInteractionBase(\n    args: InteractionBuilderArgsBase\n  ): UniversalEventProperties & InteractionBuilderArgsBase {\n    const { campaign, locale, location, page, screen, userAgent, ...interactionProperties } = args;\n\n    return {\n      ...this.buildUniversalEventProperties({\n        campaign,\n        locale,\n        location,\n        page,\n        screen,\n        userAgent,\n      }),\n      ...interactionProperties,\n    };\n  }\n\n  buildView(args: ViewBuilderArgs): ExoViewEvent {\n    const { viewId, viewDurationMs, ...interaction } = parseWithFriendlyError(\n      ViewBuilderArgs,\n      args\n    );\n\n    return {\n      ...this.buildInteractionBase(interaction),\n      type: 'exo_node_view',\n      viewId,\n      viewDurationMs,\n    };\n  }\n\n  buildClick(args: ClickBuilderArgs): ExoClickEvent {\n    const interaction = parseWithFriendlyError(ClickBuilderArgs, args);\n\n    return {\n      ...this.buildInteractionBase(interaction),\n      type: 'exo_node_click',\n    };\n  }\n\n  buildHover(args: HoverBuilderArgs): ExoHoverEvent {\n    const { hoverId, hoverDurationMs, ...interaction } = parseWithFriendlyError(\n      HoverBuilderArgs,\n      args\n    );\n\n    return {\n      ...this.buildInteractionBase(interaction),\n      type: 'exo_node_hover',\n      hoverId,\n      hoverDurationMs,\n    };\n  }\n\n  buildFlagView(args: FlagViewBuilderArgs): ViewEvent {\n    const { componentId, experienceId, variantIndex, viewId, viewDurationMs, ...universal } =\n      parseWithFriendlyError(FlagViewBuilderArgs, args);\n\n    return {\n      ...this.buildUniversalEventProperties(universal),\n      ...(viewDurationMs === undefined ? {} : { viewDurationMs }),\n      ...(viewId === undefined ? {} : { viewId }),\n      type: 'component',\n      componentType: 'Variable',\n      componentId,\n      experienceId,\n      variantIndex: variantIndex ?? 0,\n    };\n  }\n\n  buildIdentify(args: IdentifyBuilderArgs): IdentifyEvent {\n    const { traits = {}, userId, ...universal } = parseWithFriendlyError(IdentifyBuilderArgs, args);\n\n    return {\n      ...this.buildUniversalEventProperties(universal),\n      type: 'identify',\n      traits,\n      userId,\n    };\n  }\n\n  buildPageView(args: PageViewBuilderArgs = {}): PageViewEvent {\n    const { properties = {}, ...universal } = parseWithFriendlyError(PageViewBuilderArgs, args);\n    const propertiesCampaign = extractCampaignFromUrl(properties.url);\n    const pageProperties = this.getPageProperties();\n    const merged = merge(\n      {\n        ...pageProperties,\n        title: pageProperties.title ?? DEFAULT_PAGE_PROPERTIES.title,\n      },\n      properties\n    );\n\n    warnIfPageContextConflicts(universal.page, merged);\n\n    const {\n      context: { screen: _, ...universalContext },\n      ...universalProperties\n    } = this.buildUniversalEventProperties({\n      ...universal,\n      campaign: universal.campaign ?? propertiesCampaign,\n      page: universal.page ?? merged,\n    });\n\n    const context = parseWithFriendlyError(PageEventContext, universalContext);\n\n    return {\n      ...universalProperties,\n      context,\n      type: 'page',\n      properties: merged,\n    };\n  }\n\n  buildTrack(args: TrackBuilderArgs): TrackEvent {\n    const { event, properties = {}, ...universal } = parseWithFriendlyError(TrackBuilderArgs, args);\n\n    return {\n      ...this.buildUniversalEventProperties(universal),\n      type: 'track',\n      event,\n      properties,\n    };\n  }\n}\n\nexport default EventBuilder;\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -2,9 +2,13 @@ import { ContentfulViewDelivery } from '@contentful/experience-delivery';
 export { ContentfulViewDelivery, ContentfulViewDeliveryClient } from '@contentful/experience-delivery';
 export { DestinationPreviewNotSupportedError, ExperienceFetchError } from './errors.js';
 export { CreateClientOptions, createClient } from './create-client.js';
+export { ClickBuilderArgs, DEFAULT_PAGE_PROPERTIES, default as EventBuilder, EventBuilderConfig, FlagViewBuilderArgs, HoverBuilderArgs, IdentifyBuilderArgs, InteractionBuilderArgsBase, PageViewBuilderArgs, TrackBuilderArgs, UniversalEventBuilderArgs, ViewBuilderArgs } from './event-builder.js';
 export { ByDestinationNodeIdExperienceOptions, ByDestinationPathExperienceOptions, ByIdExperienceOptions, ClientOptions, DestinationRedirectResult, ExperienceOptions, ResolveOptions, fetchExperience } from './fetch-experience.js';
+export { ContentfulExperiences, ContentfulExperiencesConfig, ExperienceRuntime, RuntimeClientSource, RuntimeEventBuilderConfig, RuntimeFetchByDestinationNodeOptions, RuntimeFetchByDestinationPathOptions, RuntimeFetchExperienceOptions, RuntimeResolveOptions } from './contentful-experiences.js';
 export { ExperienceResponse, readSourceMap, toExperiencePayload, toExperiencePayloadFromDestination } from './to-experience-payload.js';
 export { DELIVERY_HOST, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST } from './hosts.js';
+import '@contentful/optimization-api-client/api-schemas';
+import 'zod/mini';
 import '@contentful/experiences-sdk-core';
 
 declare const NotFoundError: typeof ContentfulViewDelivery.NotFoundError;

package/dist/index.js

@@ -6,7 +6,10 @@ import {
 const NotFoundError = ContentfulViewDelivery.NotFoundError;
 import { ExperienceFetchError, DestinationPreviewNotSupportedError } from "./errors.js";
 import { createClient } from "./create-client.js";
+import { default as default2 } from "./event-builder.js";
+export * from "./event-builder.js";
 import { fetchExperience } from "./fetch-experience.js";
+import { ContentfulExperiences } from "./contentful-experiences.js";
 import {
   readSourceMap,
   toExperiencePayload,
@@ -14,10 +17,12 @@ import {
 } from "./to-experience-payload.js";
 import { DELIVERY_HOST, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST } from "./hosts.js";
 export {
+  ContentfulExperiences,
   ContentfulViewDelivery2 as ContentfulViewDelivery,
   ContentfulViewDeliveryClient,
   DELIVERY_HOST,
   DestinationPreviewNotSupportedError,
+  default2 as EventBuilder,
   ExperienceFetchError,
   NotFoundError,
   PREVIEW_HOST,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { ContentfulViewDelivery } from '@contentful/experience-delivery';\n\nexport {\n  ContentfulViewDelivery,\n  ContentfulViewDeliveryClient,\n} from '@contentful/experience-delivery';\nexport const NotFoundError = ContentfulViewDelivery.NotFoundError;\n// eslint-disable-next-line no-redeclare -- value + type share a name across separate TS namespaces, not a real redeclaration\nexport type NotFoundError = InstanceType<typeof ContentfulViewDelivery.NotFoundError>;\nexport { ExperienceFetchError, DestinationPreviewNotSupportedError } from './errors.js';\nexport { createClient } from './create-client.js';\nexport type { CreateClientOptions } from './create-client.js';\nexport { fetchExperience } from './fetch-experience.js';\nexport {\n  readSourceMap,\n  toExperiencePayload,\n  toExperiencePayloadFromDestination,\n} from './to-experience-payload.js';\nexport type { ExperienceResponse } from './to-experience-payload.js';\nexport type {\n  ExperienceOptions,\n  ByIdExperienceOptions,\n  ByDestinationNodeIdExperienceOptions,\n  ByDestinationPathExperienceOptions,\n  ClientOptions,\n  ResolveOptions,\n  DestinationRedirectResult,\n} from './fetch-experience.js';\nexport { DELIVERY_HOST, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST } from './hosts.js';\n"],"mappings":"AAAA,SAAS,8BAA8B;AAEvC;AAAA,EACE,0BAAAA;AAAA,EACA;AAAA,OACK;AACA,MAAM,gBAAgB,uBAAuB;AAGpD,SAAS,sBAAsB,2CAA2C;AAC1E,SAAS,oBAAoB;AAE7B,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWP,SAAS,eAAe,cAAc,8BAA8B;","names":["ContentfulViewDelivery"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { ContentfulViewDelivery } from '@contentful/experience-delivery';\n\nexport {\n  ContentfulViewDelivery,\n  ContentfulViewDeliveryClient,\n} from '@contentful/experience-delivery';\nexport const NotFoundError = ContentfulViewDelivery.NotFoundError;\n// eslint-disable-next-line no-redeclare -- value + type share a name across separate TS namespaces, not a real redeclaration\nexport type NotFoundError = InstanceType<typeof ContentfulViewDelivery.NotFoundError>;\nexport { ExperienceFetchError, DestinationPreviewNotSupportedError } from './errors.js';\nexport { createClient } from './create-client.js';\nexport type { CreateClientOptions } from './create-client.js';\nexport { default as EventBuilder } from './event-builder.js';\nexport * from './event-builder.js';\nexport { fetchExperience } from './fetch-experience.js';\nexport { ContentfulExperiences } from './contentful-experiences.js';\nexport type {\n  ContentfulExperiencesConfig,\n  ExperienceRuntime,\n  RuntimeFetchExperienceOptions,\n  RuntimeFetchByDestinationNodeOptions,\n  RuntimeFetchByDestinationPathOptions,\n  RuntimeClientSource,\n  RuntimeEventBuilderConfig,\n  RuntimeResolveOptions,\n} from './contentful-experiences.js';\nexport {\n  readSourceMap,\n  toExperiencePayload,\n  toExperiencePayloadFromDestination,\n} from './to-experience-payload.js';\nexport type { ExperienceResponse } from './to-experience-payload.js';\nexport type {\n  ExperienceOptions,\n  ByIdExperienceOptions,\n  ByDestinationNodeIdExperienceOptions,\n  ByDestinationPathExperienceOptions,\n  ClientOptions,\n  ResolveOptions,\n  DestinationRedirectResult,\n} from './fetch-experience.js';\nexport { DELIVERY_HOST, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST } from './hosts.js';\n"],"mappings":"AAAA,SAAS,8BAA8B;AAEvC;AAAA,EACE,0BAAAA;AAAA,EACA;AAAA,OACK;AACA,MAAM,gBAAgB,uBAAuB;AAGpD,SAAS,sBAAsB,2CAA2C;AAC1E,SAAS,oBAAoB;AAE7B,SAAoB,WAAXC,gBAA+B;AACxC,cAAc;AACd,SAAS,uBAAuB;AAChC,SAAS,6BAA6B;AAWtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWP,SAAS,eAAe,cAAc,8BAA8B;","names":["ContentfulViewDelivery","default"]}

package/dist/sdk-info.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Default library metadata attached to the context of built Events.
+ *
+ * Build artifacts receive their package metadata through tsup defines. Source
+ * execution (including tests) uses stable fallback values instead.
+ */
+declare const DEFAULT_EVENT_CONTEXT_LIBRARY: {
+    name: string;
+    version: string;
+};
+
+export { DEFAULT_EVENT_CONTEXT_LIBRARY };

package/dist/sdk-info.js

@@ -0,0 +1,8 @@
+const DEFAULT_EVENT_CONTEXT_LIBRARY = {
+  name: true ? "@contentful/experiences-client" : "@contentful/experiences-client",
+  version: true ? "0.4.9" : "0.0.0"
+};
+export {
+  DEFAULT_EVENT_CONTEXT_LIBRARY
+};
+//# sourceMappingURL=sdk-info.js.map

package/dist/sdk-info.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sdk-info.ts"],"sourcesContent":["declare const __DEFAULT_EVENT_CONTEXT_LIBRARY_NAME__: string | undefined;\ndeclare const __DEFAULT_EVENT_CONTEXT_LIBRARY_VERSION__: string | undefined;\n\n/**\n * Default library metadata attached to the context of built Events.\n *\n * Build artifacts receive their package metadata through tsup defines. Source\n * execution (including tests) uses stable fallback values instead.\n */\nexport const DEFAULT_EVENT_CONTEXT_LIBRARY = {\n  name:\n    typeof __DEFAULT_EVENT_CONTEXT_LIBRARY_NAME__ === 'string'\n      ? __DEFAULT_EVENT_CONTEXT_LIBRARY_NAME__\n      : '@contentful/experiences-client',\n  version:\n    typeof __DEFAULT_EVENT_CONTEXT_LIBRARY_VERSION__ === 'string'\n      ? __DEFAULT_EVENT_CONTEXT_LIBRARY_VERSION__\n      : '0.0.0',\n};\n"],"mappings":"AASO,MAAM,gCAAgC;AAAA,EAC3C,MACE,OACI,mCACA;AAAA,EACN,SACE,OACI,UACA;AACR;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-client",
-  "version": "0.4.8",
+  "version": "0.5.0",
   "description": "Delivery client + fetchExperience for Contentful Experiences",
   "license": "MIT",
   "type": "module",
@@ -31,6 +31,9 @@
   },
   "dependencies": {
     "@contentful/experience-delivery": "1.0.0-dev.8",
-    "@contentful/experiences-sdk-core": "0.8.6"
+    "@contentful/experiences-sdk-core": "0.9.0",
+    "@contentful/optimization-api-client": "^2.0.1",
+    "es-toolkit": "^1.46.0",
+    "zod": "^4.3.6"
   }
 }