@contentful/experiences-client 0.9.1 → 0.9.2

package/dist/event-builder.js

@@ -1,282 +0,0 @@
-import {
-  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 as createOptimizationScopedLogger } from "@contentful/optimization-api-client/logger";
-import { merge } from "es-toolkit/object";
-import * as z from "zod/mini";
-const eventBuilderLogger = createOptimizationScopedLogger("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(OptimizationCampaign),
-  locale: z.optional(z.string()),
-  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: OptimizationExoEntityKind,
-  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(OptimizationTraits),
-  userId: z.string()
-});
-const PageViewBuilderArgs = z.extend(UniversalEventBuilderArgs, {
-  properties: z.optional(z.partial(OptimizationPage))
-});
-const TrackBuilderArgs = z.extend(UniversalEventBuilderArgs, {
-  event: z.string(),
-  properties: z.optional(z.prefault(OptimizationProperties, {}))
-});
-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 } = parseOptimizationSchema(
-      ViewBuilderArgs,
-      args
-    );
-    return {
-      ...this.buildInteractionBase(interaction),
-      type: "exo_node_view",
-      viewId,
-      viewDurationMs
-    };
-  }
-  buildClick(args) {
-    const interaction = parseOptimizationSchema(ClickBuilderArgs, args);
-    return {
-      ...this.buildInteractionBase(interaction),
-      type: "exo_node_click"
-    };
-  }
-  buildHover(args) {
-    const { hoverId, hoverDurationMs, ...interaction } = parseOptimizationSchema(
-      HoverBuilderArgs,
-      args
-    );
-    return {
-      ...this.buildInteractionBase(interaction),
-      type: "exo_node_hover",
-      hoverId,
-      hoverDurationMs
-    };
-  }
-  buildFlagView(args) {
-    const { componentId, experienceId, variantIndex, viewId, viewDurationMs, ...universal } = parseOptimizationSchema(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
-    } = parseOptimizationSchema(IdentifyBuilderArgs, args);
-    return {
-      ...this.buildUniversalEventProperties(universal),
-      type: "identify",
-      traits,
-      userId
-    };
-  }
-  buildPageView(args = {}) {
-    const { properties = {}, ...universal } = parseOptimizationSchema(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 = parseOptimizationSchema(OptimizationPageEventContext, universalContext);
-    return {
-      ...universalProperties,
-      context,
-      type: "page",
-      properties: merged
-    };
-  }
-  buildTrack(args) {
-    const {
-      event,
-      properties = {},
-      ...universal
-    } = parseOptimizationSchema(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

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/event-builder.ts"],"sourcesContent":["/* eslint-disable no-redeclare */\n\nimport {\n  type App as OptimizationApp,\n  Campaign as OptimizationCampaign,\n  type Channel as OptimizationChannel,\n  type ExoClickEvent as OptimizationExoClickEvent,\n  ExoEntityKind as OptimizationExoEntityKind,\n  type ExoHoverEvent as OptimizationExoHoverEvent,\n  type ExoViewEvent as OptimizationExoViewEvent,\n  GeoLocation as OptimizationGeoLocation,\n  type IdentifyEvent as OptimizationIdentifyEvent,\n  type Library as OptimizationLibrary,\n  Page as OptimizationPage,\n  PageEventContext as OptimizationPageEventContext,\n  type PageViewEvent as OptimizationPageViewEvent,\n  parseWithFriendlyError as parseOptimizationSchema,\n  Properties as OptimizationProperties,\n  Screen as OptimizationScreen,\n  type TrackEvent as OptimizationTrackEvent,\n  Traits as OptimizationTraits,\n  UniversalEventProperties as OptimizationUniversalEventProperties,\n  type ViewEvent as OptimizationViewEvent,\n} from '@contentful/optimization-api-client/api-schemas';\nimport { createScopedLogger as createOptimizationScopedLogger } from '@contentful/optimization-api-client/logger';\nimport { merge } from 'es-toolkit/object';\nimport * as z from 'zod/mini';\n\nconst eventBuilderLogger = createOptimizationScopedLogger('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): OptimizationCampaign | undefined {\n  if (url === undefined) return undefined;\n\n  try {\n    const { searchParams } = new URL(url);\n    const campaign: OptimizationCampaign = {};\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?: OptimizationApp;\n  channel: OptimizationChannel;\n  library: OptimizationLibrary;\n  getLocale?: () => string | undefined;\n  getPageProperties?: () => OptimizationPage;\n  getUserAgent?: () => string | undefined;\n  getConsent?: () => boolean | undefined;\n}\n\nexport const UniversalEventBuilderArgs = z.object({\n  campaign: z.optional(OptimizationCampaign),\n  locale: z.optional(z.string()),\n  location: z.optional(OptimizationGeoLocation),\n  page: z.optional(OptimizationPage),\n  screen: z.optional(OptimizationScreen),\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: OptimizationExoEntityKind,\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(OptimizationTraits),\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(OptimizationPage)),\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(OptimizationProperties, {})),\n});\n\nexport type TrackBuilderArgs = z.infer<typeof TrackBuilderArgs>;\n\nconst PAGE_CONTEXT_CONFLICT_KEYS = ['path', 'query', 'search', 'url'] as const;\n\nfunction warnIfPageContextConflicts(\n  explicitPage: OptimizationPage | undefined,\n  properties: OptimizationPage\n): 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: OptimizationPage = {\n  path: '',\n  query: {},\n  referrer: '',\n  search: '',\n  title: '',\n  url: '',\n};\n\nclass EventBuilder {\n  app?: OptimizationApp;\n  channel: OptimizationChannel;\n  library: OptimizationLibrary;\n  getLocale: () => string | undefined;\n  getPageProperties: () => OptimizationPage;\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): OptimizationUniversalEventProperties {\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  ): OptimizationUniversalEventProperties & 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): OptimizationExoViewEvent {\n    const { viewId, viewDurationMs, ...interaction } = parseOptimizationSchema(\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): OptimizationExoClickEvent {\n    const interaction = parseOptimizationSchema(ClickBuilderArgs, args);\n\n    return {\n      ...this.buildInteractionBase(interaction),\n      type: 'exo_node_click',\n    };\n  }\n\n  buildHover(args: HoverBuilderArgs): OptimizationExoHoverEvent {\n    const { hoverId, hoverDurationMs, ...interaction } = parseOptimizationSchema(\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): OptimizationViewEvent {\n    const { componentId, experienceId, variantIndex, viewId, viewDurationMs, ...universal } =\n      parseOptimizationSchema(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): OptimizationIdentifyEvent {\n    const {\n      traits = {},\n      userId,\n      ...universal\n    } = parseOptimizationSchema(IdentifyBuilderArgs, args);\n\n    return {\n      ...this.buildUniversalEventProperties(universal),\n      type: 'identify',\n      traits,\n      userId,\n    };\n  }\n\n  buildPageView(args: PageViewBuilderArgs = {}): OptimizationPageViewEvent {\n    const { properties = {}, ...universal } = parseOptimizationSchema(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 = parseOptimizationSchema(OptimizationPageEventContext, universalContext);\n\n    return {\n      ...universalProperties,\n      context,\n      type: 'page',\n      properties: merged,\n    };\n  }\n\n  buildTrack(args: TrackBuilderArgs): OptimizationTrackEvent {\n    const {\n      event,\n      properties = {},\n      ...universal\n    } = parseOptimizationSchema(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":"AAEA;AAAA,EAEE,YAAY;AAAA,EAGZ,iBAAiB;AAAA,EAGjB,eAAe;AAAA,EAGf,QAAQ;AAAA,EACR,oBAAoB;AAAA,EAEpB,0BAA0B;AAAA,EAC1B,cAAc;AAAA,EACd,UAAU;AAAA,EAEV,UAAU;AAAA,OAGL;AACP,SAAS,sBAAsB,sCAAsC;AACrE,SAAS,aAAa;AACtB,YAAY,OAAO;AAEnB,MAAM,qBAAqB,+BAA+B,0BAA0B;AAEpF,MAAM,0BAA0B;AAAA,EAC9B,CAAC,gBAAgB,MAAM;AAAA,EACvB,CAAC,cAAc,QAAQ;AAAA,EACvB,CAAC,cAAc,QAAQ;AAAA,EACvB,CAAC,YAAY,MAAM;AAAA,EACnB,CAAC,eAAe,SAAS;AAC3B;AAEA,SAAS,uBAAuB,KAA2D;AACzF,MAAI,QAAQ,OAAW,QAAO;AAE9B,MAAI;AACF,UAAM,EAAE,aAAa,IAAI,IAAI,IAAI,GAAG;AACpC,UAAM,WAAiC,CAAC;AACxC,QAAI,uBAAuB;AAE3B,eAAW,CAAC,WAAW,QAAQ,KAAK,yBAAyB;AAC3D,UAAI,CAAC,aAAa,IAAI,SAAS,EAAG;AAElC,eAAS,QAAQ,IAAI,aAAa,IAAI,SAAS,KAAK;AACpD,6BAAuB;AAAA,IACzB;AAEA,WAAO,uBAAuB,WAAW;AAAA,EAC3C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAYO,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,UAAU,EAAE,SAAS,oBAAoB;AAAA,EACzC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EAC7B,UAAU,EAAE,SAAS,uBAAuB;AAAA,EAC5C,MAAM,EAAE,SAAS,gBAAgB;AAAA,EACjC,QAAQ,EAAE,SAAS,kBAAkB;AAAA,EACrC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;AAClC,CAAC;AAIM,MAAM,6BAA6B,EAAE,OAAO,2BAA2B;AAAA,EAC5E,UAAU,EAAE,OAAO;AAAA,EACnB,YAAY;AAAA,EACZ,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EACnC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAAA,EACxC,gBAAgB,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EACrC,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;AAAA,EACrD,oBAAoB,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EACzC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EAChC,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC;AACrC,CAAC;AAIM,MAAM,kBAAkB,EAAE,OAAO,4BAA4B;AAAA,EAClE,QAAQ,EAAE,OAAO;AAAA,EACjB,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAIM,MAAM,mBAAmB;AAIzB,MAAM,mBAAmB,EAAE,OAAO,4BAA4B;AAAA,EACnE,SAAS,EAAE,OAAO;AAAA,EAClB,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAID,MAAM,iCAAiC,EAAE,OAAO,2BAA2B;AAAA,EACzE,aAAa,EAAE,OAAO;AAAA,EACtB,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EACnC,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC;AACrC,CAAC;AAEM,MAAM,sBAAsB,EAAE,OAAO,gCAAgC;AAAA,EAC1E,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EAC7B,gBAAgB,EAAE,SAAS,EAAE,OAAO,CAAC;AACvC,CAAC;AAIM,MAAM,sBAAsB,EAAE,OAAO,2BAA2B;AAAA,EACrE,QAAQ,EAAE,SAAS,kBAAkB;AAAA,EACrC,QAAQ,EAAE,OAAO;AACnB,CAAC;AAIM,MAAM,sBAAsB,EAAE,OAAO,2BAA2B;AAAA,EACrE,YAAY,EAAE,SAAS,EAAE,QAAQ,gBAAgB,CAAC;AACpD,CAAC;AAIM,MAAM,mBAAmB,EAAE,OAAO,2BAA2B;AAAA,EAClE,OAAO,EAAE,OAAO;AAAA,EAChB,YAAY,EAAE,SAAS,EAAE,SAAS,wBAAwB,CAAC,CAAC,CAAC;AAC/D,CAAC;AAID,MAAM,6BAA6B,CAAC,QAAQ,SAAS,UAAU,KAAK;AAEpE,SAAS,2BACP,cACA,YACM;AACN,MAAI,CAAC,aAAc;AAEnB,QAAM,kBAAkB,2BAA2B,OAAO,CAAC,QAAQ;AACjE,UAAM,EAAE,CAAC,GAAG,GAAG,cAAc,IAAI;AACjC,UAAM,EAAE,CAAC,GAAG,GAAG,cAAc,IAAI;AACjC,WAAO,KAAK,UAAU,aAAa,MAAM,KAAK,UAAU,aAAa;AAAA,EACvE,CAAC;AAED,MAAI,gBAAgB,WAAW,EAAG;AAElC,qBAAmB;AAAA,IACjB,iEAAiE,gBAAgB,KAAK,IAAI,CAAC;AAAA,EAC7F;AACF;AAEO,MAAM,0BAA4C;AAAA,EACvD,MAAM;AAAA,EACN,OAAO,CAAC;AAAA,EACR,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AACP;AAEA,MAAM,aAAa;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,QAA4B;AACtC,UAAM,EAAE,KAAK,SAAS,SAAS,WAAW,mBAAmB,cAAc,WAAW,IACpF;AACF,SAAK,MAAM;AACX,SAAK,UAAU;AACf,SAAK,UAAU;AACf,SAAK,YAAY,cAAc,MAAM;AACrC,SAAK,oBAAoB,sBAAsB,MAAM;AACrD,SAAK,eAAe,iBAAiB,MAAM;AAC3C,SAAK,aAAa,eAAe,MAAM;AAAA,EACzC;AAAA,EAEU,8BAA8B;AAAA,IACtC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAAoE;AAClE,UAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,UAAM,eAAe,QAAQ,KAAK,kBAAkB;AAEpD,WAAO;AAAA,MACL,SAAS,KAAK;AAAA,MACd,SAAS;AAAA,QACP,KAAK,KAAK;AAAA,QACV,UAAU,YAAY,uBAAuB,aAAa,GAAG,KAAK,CAAC;AAAA,QACnE,MAAM,EAAE,gBAAgB,KAAK,WAAW,MAAM,KAAK;AAAA,QACnD,SAAS,KAAK;AAAA,QACd,QAAQ,UAAU,KAAK,UAAU,KAAK;AAAA,QACtC;AAAA,QACA,MAAM;AAAA,QACN;AAAA,QACA,WAAW,aAAa,KAAK,aAAa;AAAA,MAC5C;AAAA,MACA,WAAW,OAAO,WAAW;AAAA,MAC7B,mBAAmB;AAAA,MACnB,QAAQ;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,qBACN,MACmE;AACnE,UAAM,EAAE,UAAU,QAAQ,UAAU,MAAM,QAAQ,WAAW,GAAG,sBAAsB,IAAI;AAE1F,WAAO;AAAA,MACL,GAAG,KAAK,8BAA8B;AAAA,QACpC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,MACD,GAAG;AAAA,IACL;AAAA,EACF;AAAA,EAEA,UAAU,MAAiD;AACzD,UAAM,EAAE,QAAQ,gBAAgB,GAAG,YAAY,IAAI;AAAA,MACjD;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL,GAAG,KAAK,qBAAqB,WAAW;AAAA,MACxC,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,WAAW,MAAmD;AAC5D,UAAM,cAAc,wBAAwB,kBAAkB,IAAI;AAElE,WAAO;AAAA,MACL,GAAG,KAAK,qBAAqB,WAAW;AAAA,MACxC,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,WAAW,MAAmD;AAC5D,UAAM,EAAE,SAAS,iBAAiB,GAAG,YAAY,IAAI;AAAA,MACnD;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL,GAAG,KAAK,qBAAqB,WAAW;AAAA,MACxC,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,cAAc,MAAkD;AAC9D,UAAM,EAAE,aAAa,cAAc,cAAc,QAAQ,gBAAgB,GAAG,UAAU,IACpF,wBAAwB,qBAAqB,IAAI;AAEnD,WAAO;AAAA,MACL,GAAG,KAAK,8BAA8B,SAAS;AAAA,MAC/C,GAAI,mBAAmB,SAAY,CAAC,IAAI,EAAE,eAAe;AAAA,MACzD,GAAI,WAAW,SAAY,CAAC,IAAI,EAAE,OAAO;AAAA,MACzC,MAAM;AAAA,MACN,eAAe;AAAA,MACf;AAAA,MACA;AAAA,MACA,cAAc,gBAAgB;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,cAAc,MAAsD;AAClE,UAAM;AAAA,MACJ,SAAS,CAAC;AAAA,MACV;AAAA,MACA,GAAG;AAAA,IACL,IAAI,wBAAwB,qBAAqB,IAAI;AAErD,WAAO;AAAA,MACL,GAAG,KAAK,8BAA8B,SAAS;AAAA,MAC/C,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,cAAc,OAA4B,CAAC,GAA8B;AACvE,UAAM,EAAE,aAAa,CAAC,GAAG,GAAG,UAAU,IAAI,wBAAwB,qBAAqB,IAAI;AAC3F,UAAM,qBAAqB,uBAAuB,WAAW,GAAG;AAChE,UAAM,iBAAiB,KAAK,kBAAkB;AAC9C,UAAM,SAAS;AAAA,MACb;AAAA,QACE,GAAG;AAAA,QACH,OAAO,eAAe,SAAS,wBAAwB;AAAA,MACzD;AAAA,MACA;AAAA,IACF;AAEA,+BAA2B,UAAU,MAAM,MAAM;AAEjD,UAAM;AAAA,MACJ,SAAS,EAAE,QAAQ,GAAG,GAAG,iBAAiB;AAAA,MAC1C,GAAG;AAAA,IACL,IAAI,KAAK,8BAA8B;AAAA,MACrC,GAAG;AAAA,MACH,UAAU,UAAU,YAAY;AAAA,MAChC,MAAM,UAAU,QAAQ;AAAA,IAC1B,CAAC;AAED,UAAM,UAAU,wBAAwB,8BAA8B,gBAAgB;AAEtF,WAAO;AAAA,MACL,GAAG;AAAA,MACH;AAAA,MACA,MAAM;AAAA,MACN,YAAY;AAAA,IACd;AAAA,EACF;AAAA,EAEA,WAAW,MAAgD;AACzD,UAAM;AAAA,MACJ;AAAA,MACA,aAAa,CAAC;AAAA,MACd,GAAG;AAAA,IACL,IAAI,wBAAwB,kBAAkB,IAAI;AAElD,WAAO;AAAA,MACL,GAAG,KAAK,8BAA8B,SAAS;AAAA,MAC/C,MAAM;AAAA,MACN;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,wBAAQ;","names":[]}

package/dist/runtime-event-handoff.d.ts

@@ -1,33 +0,0 @@
-import { ExperienceEvent, InsightsEvent } from '@contentful/optimization-api-client/api-schemas';
-
-declare const RUNTIME_EVENT_HANDOFF_VERSION: 1;
-/** Server-only delivery choice. Browser runtimes always commit received handoffs. */
-type RuntimeServerEventDelivery = 'commit' | 'handoff';
-type RuntimeEventHandoffEvent = {
-    readonly transport: 'personalization';
-    readonly event: ExperienceEvent;
-} | {
-    readonly transport: 'analytics';
-    readonly event: InsightsEvent;
-};
-/** Plain JSON passed from one Node request to its paired Web runtime. */
-interface RuntimeEventHandoff {
-    readonly version: typeof RUNTIME_EVENT_HANDOFF_VERSION;
-    readonly spaceId: string;
-    readonly environmentId: string;
-    /** Profile known before any preflight event was evaluated. */
-    readonly initialProfileId?: string;
-    readonly events: readonly RuntimeEventHandoffEvent[];
-    /** App-defined route identity for a successfully staged initial page event. */
-    readonly initialPageRouteKey?: string;
-}
-/** Returned only after the complete Web replay succeeds. */
-interface RuntimeEventHandoffReceipt {
-    readonly initialPageRouteKey?: string;
-}
-/** Enforces the private response payload cap without parsing trusted Node data. */
-declare function assertRuntimeEventHandoffSize(input: unknown): void;
-/** Validates an untrusted serialized handoff before Web starts any transport. */
-declare function parseRuntimeEventHandoff(input: unknown): RuntimeEventHandoff;
-
-export { RUNTIME_EVENT_HANDOFF_VERSION, type RuntimeEventHandoff, type RuntimeEventHandoffEvent, type RuntimeEventHandoffReceipt, type RuntimeServerEventDelivery, assertRuntimeEventHandoffSize, parseRuntimeEventHandoff };

package/dist/runtime-event-handoff.js

@@ -1,68 +0,0 @@
-import {
-  ExperienceEvent as PersonalizationEventSchema,
-  InsightsEvent as AnalyticsEventSchema,
-  parseWithFriendlyError as parseOptimizationSchema
-} from "@contentful/optimization-api-client/api-schemas";
-import * as z from "zod/mini";
-const RUNTIME_EVENT_HANDOFF_VERSION = 1;
-const RUNTIME_EVENT_HANDOFF_MAX_BYTES = 64 * 1024;
-const encoder = new globalThis.TextEncoder();
-const RuntimeEventHandoffSchema = z.object({
-  version: z.literal(RUNTIME_EVENT_HANDOFF_VERSION),
-  spaceId: z.string(),
-  environmentId: z.string(),
-  initialProfileId: z.optional(z.string()),
-  events: z.array(
-    z.discriminatedUnion("transport", [
-      z.object({
-        transport: z.literal("personalization"),
-        event: PersonalizationEventSchema
-      }),
-      z.object({
-        transport: z.literal("analytics"),
-        event: AnalyticsEventSchema
-      })
-    ])
-  ),
-  initialPageRouteKey: z.optional(z.string())
-});
-function assertRuntimeEventHandoffSize(input) {
-  let serialized;
-  try {
-    serialized = JSON.stringify(input);
-  } catch (error) {
-    throw new TypeError("Runtime event handoff must be JSON serializable", { cause: error });
-  }
-  if (serialized === void 0) throw new TypeError("Runtime event handoff is not serializable");
-  if (encoder.encode(serialized).byteLength > RUNTIME_EVENT_HANDOFF_MAX_BYTES) {
-    throw new TypeError(
-      `Runtime event handoff exceeds ${RUNTIME_EVENT_HANDOFF_MAX_BYTES} serialized bytes`
-    );
-  }
-}
-function parseRuntimeEventHandoff(input) {
-  assertRuntimeEventHandoffSize(input);
-  const handoff = parseOptimizationSchema(RuntimeEventHandoffSchema, input);
-  if (handoff.initialPageRouteKey !== void 0 && !handoff.events.some(
-    (entry) => entry.transport === "personalization" && entry.event.type === "page"
-  )) {
-    throw new TypeError("Runtime event handoff initial page requires a staged page event");
-  }
-  let hasProfile = handoff.initialProfileId !== void 0;
-  for (const entry of handoff.events) {
-    if (entry.transport === "personalization") {
-      hasProfile = true;
-    } else if (!hasProfile) {
-      throw new TypeError(
-        "Runtime event handoff Analytics events require an initial or preceding Personalization profile"
-      );
-    }
-  }
-  return handoff;
-}
-export {
-  RUNTIME_EVENT_HANDOFF_VERSION,
-  assertRuntimeEventHandoffSize,
-  parseRuntimeEventHandoff
-};
-//# sourceMappingURL=runtime-event-handoff.js.map

package/dist/runtime-event-handoff.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/runtime-event-handoff.ts"],"sourcesContent":["import {\n  ExperienceEvent as PersonalizationEventSchema,\n  InsightsEvent as AnalyticsEventSchema,\n  parseWithFriendlyError as parseOptimizationSchema,\n  type ExperienceEvent as PersonalizationEvent,\n  type InsightsEvent as AnalyticsEvent,\n} from '@contentful/optimization-api-client/api-schemas';\nimport * as z from 'zod/mini';\n\nexport const RUNTIME_EVENT_HANDOFF_VERSION = 1 as const;\n\nconst RUNTIME_EVENT_HANDOFF_MAX_BYTES = 64 * 1024;\nconst encoder = new globalThis.TextEncoder();\nconst RuntimeEventHandoffSchema = z.object({\n  version: z.literal(RUNTIME_EVENT_HANDOFF_VERSION),\n  spaceId: z.string(),\n  environmentId: z.string(),\n  initialProfileId: z.optional(z.string()),\n  events: z.array(\n    z.discriminatedUnion('transport', [\n      z.object({\n        transport: z.literal('personalization'),\n        event: PersonalizationEventSchema,\n      }),\n      z.object({\n        transport: z.literal('analytics'),\n        event: AnalyticsEventSchema,\n      }),\n    ])\n  ),\n  initialPageRouteKey: z.optional(z.string()),\n});\n\n/** Server-only delivery choice. Browser runtimes always commit received handoffs. */\nexport type RuntimeServerEventDelivery = 'commit' | 'handoff';\n\nexport type RuntimeEventHandoffEvent =\n  | { readonly transport: 'personalization'; readonly event: PersonalizationEvent }\n  | { readonly transport: 'analytics'; readonly event: AnalyticsEvent };\n\n/** Plain JSON passed from one Node request to its paired Web runtime. */\nexport interface RuntimeEventHandoff {\n  readonly version: typeof RUNTIME_EVENT_HANDOFF_VERSION;\n  readonly spaceId: string;\n  readonly environmentId: string;\n  /** Profile known before any preflight event was evaluated. */\n  readonly initialProfileId?: string;\n  readonly events: readonly RuntimeEventHandoffEvent[];\n  /** App-defined route identity for a successfully staged initial page event. */\n  readonly initialPageRouteKey?: string;\n}\n\n/** Returned only after the complete Web replay succeeds. */\nexport interface RuntimeEventHandoffReceipt {\n  readonly initialPageRouteKey?: string;\n}\n\n/** Enforces the private response payload cap without parsing trusted Node data. */\nexport function assertRuntimeEventHandoffSize(input: unknown): void {\n  let serialized: string | undefined;\n  try {\n    serialized = JSON.stringify(input);\n  } catch (error) {\n    throw new TypeError('Runtime event handoff must be JSON serializable', { cause: error });\n  }\n  if (serialized === undefined) throw new TypeError('Runtime event handoff is not serializable');\n  if (encoder.encode(serialized).byteLength > RUNTIME_EVENT_HANDOFF_MAX_BYTES) {\n    throw new TypeError(\n      `Runtime event handoff exceeds ${RUNTIME_EVENT_HANDOFF_MAX_BYTES} serialized bytes`\n    );\n  }\n}\n\n/** Validates an untrusted serialized handoff before Web starts any transport. */\nexport function parseRuntimeEventHandoff(input: unknown): RuntimeEventHandoff {\n  assertRuntimeEventHandoffSize(input);\n  const handoff = parseOptimizationSchema(RuntimeEventHandoffSchema, input);\n\n  if (\n    handoff.initialPageRouteKey !== undefined &&\n    !handoff.events.some(\n      (entry) => entry.transport === 'personalization' && entry.event.type === 'page'\n    )\n  ) {\n    throw new TypeError('Runtime event handoff initial page requires a staged page event');\n  }\n\n  let hasProfile = handoff.initialProfileId !== undefined;\n  for (const entry of handoff.events) {\n    if (entry.transport === 'personalization') {\n      hasProfile = true;\n    } else if (!hasProfile) {\n      throw new TypeError(\n        'Runtime event handoff Analytics events require an initial or preceding Personalization profile'\n      );\n    }\n  }\n\n  return handoff;\n}\n"],"mappings":"AAAA;AAAA,EACE,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,0BAA0B;AAAA,OAGrB;AACP,YAAY,OAAO;AAEZ,MAAM,gCAAgC;AAE7C,MAAM,kCAAkC,KAAK;AAC7C,MAAM,UAAU,IAAI,WAAW,YAAY;AAC3C,MAAM,4BAA4B,EAAE,OAAO;AAAA,EACzC,SAAS,EAAE,QAAQ,6BAA6B;AAAA,EAChD,SAAS,EAAE,OAAO;AAAA,EAClB,eAAe,EAAE,OAAO;AAAA,EACxB,kBAAkB,EAAE,SAAS,EAAE,OAAO,CAAC;AAAA,EACvC,QAAQ,EAAE;AAAA,IACR,EAAE,mBAAmB,aAAa;AAAA,MAChC,EAAE,OAAO;AAAA,QACP,WAAW,EAAE,QAAQ,iBAAiB;AAAA,QACtC,OAAO;AAAA,MACT,CAAC;AAAA,MACD,EAAE,OAAO;AAAA,QACP,WAAW,EAAE,QAAQ,WAAW;AAAA,QAChC,OAAO;AAAA,MACT,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EACA,qBAAqB,EAAE,SAAS,EAAE,OAAO,CAAC;AAC5C,CAAC;AA2BM,SAAS,8BAA8B,OAAsB;AAClE,MAAI;AACJ,MAAI;AACF,iBAAa,KAAK,UAAU,KAAK;AAAA,EACnC,SAAS,OAAO;AACd,UAAM,IAAI,UAAU,mDAAmD,EAAE,OAAO,MAAM,CAAC;AAAA,EACzF;AACA,MAAI,eAAe,OAAW,OAAM,IAAI,UAAU,2CAA2C;AAC7F,MAAI,QAAQ,OAAO,UAAU,EAAE,aAAa,iCAAiC;AAC3E,UAAM,IAAI;AAAA,MACR,iCAAiC,+BAA+B;AAAA,IAClE;AAAA,EACF;AACF;AAGO,SAAS,yBAAyB,OAAqC;AAC5E,gCAA8B,KAAK;AACnC,QAAM,UAAU,wBAAwB,2BAA2B,KAAK;AAExE,MACE,QAAQ,wBAAwB,UAChC,CAAC,QAAQ,OAAO;AAAA,IACd,CAAC,UAAU,MAAM,cAAc,qBAAqB,MAAM,MAAM,SAAS;AAAA,EAC3E,GACA;AACA,UAAM,IAAI,UAAU,iEAAiE;AAAA,EACvF;AAEA,MAAI,aAAa,QAAQ,qBAAqB;AAC9C,aAAW,SAAS,QAAQ,QAAQ;AAClC,QAAI,MAAM,cAAc,mBAAmB;AACzC,mBAAa;AAAA,IACf,WAAW,CAAC,YAAY;AACtB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/runtime-event-methods.d.ts

@@ -1,52 +0,0 @@
-import { ExperienceApiClient, InsightsApiClient } from '@contentful/optimization-api-client';
-import { PartialProfile, ExperienceEvent, OptimizationData, InsightsEvent } from '@contentful/optimization-api-client/api-schemas';
-export { OptimizationData as EventOptimizationData, PartialProfile as EventProfile, PartialProfile as EventProfileSchema } from '@contentful/optimization-api-client/api-schemas';
-import EventBuilder, { UniversalEventBuilderArgs, IdentifyBuilderArgs, PageViewBuilderArgs, TrackBuilderArgs, ViewBuilderArgs, ClickBuilderArgs, HoverBuilderArgs, FlagViewBuilderArgs } from './event-builder.js';
-import 'zod/mini';
-
-type PersonalizationEventMethod = 'identify' | 'page' | 'track';
-type AnalyticsEventMethod = 'trackView' | 'trackClick' | 'trackHover' | 'trackFlagView';
-/** The Optimization API surface used by the shared runtime. */
-interface RuntimeOptimizationApiClient {
-    readonly personalization: Pick<ExperienceApiClient, 'upsertProfile'>;
-    readonly analytics: Pick<InsightsApiClient, 'sendBatchEvents'>;
-}
-/** Internal strategy used by a runtime to commit or stage built events. */
-interface RuntimeEventDispatch {
-    personalization(event: ExperienceEvent, profile: PartialProfile | undefined): Promise<OptimizationData>;
-    analytics(event: InsightsEvent, profile: PartialProfile): Promise<boolean>;
-}
-/** Runtime-owned state and context used to bind otherwise stateless event methods. */
-interface RuntimeEventBindings {
-    getProfile: () => PartialProfile | undefined;
-    setProfile: (profile: PartialProfile) => void;
-    /** Changes when an external session boundary must invalidate an in-flight profile response. */
-    getProfileRevision?: () => number;
-    getEventContext?: () => UniversalEventBuilderArgs;
-    getConsent?: () => boolean | undefined;
-}
-/**
- * Event-triggering surface shared by the public Node and Web runtimes.
- * Profile-producing calls are not serialized; await them before another
- * profile-producing or Analytics call on the same bound runtime. In Node
- * handoff mode an Analytics `true` means accepted into the handoff journal,
- * not delivered to the Analytics transport.
- */
-interface RuntimeEventMethods {
-    readonly profile: PartialProfile | undefined;
-    identify(args: IdentifyBuilderArgs): Promise<OptimizationData>;
-    page(args?: PageViewBuilderArgs): Promise<OptimizationData>;
-    track(args: TrackBuilderArgs): Promise<OptimizationData>;
-    trackView(args: ViewBuilderArgs): Promise<boolean>;
-    trackClick(args: ClickBuilderArgs): Promise<boolean>;
-    trackHover(args: HoverBuilderArgs): Promise<boolean>;
-    trackFlagView(args: FlagViewBuilderArgs): Promise<boolean>;
-}
-/** Thrown when an Analytics event is triggered before a profile is available. */
-declare class EventProfileRequiredError extends Error {
-    readonly method: AnalyticsEventMethod;
-    constructor(method: AnalyticsEventMethod);
-}
-declare function createRuntimeEventMethods(api: RuntimeOptimizationApiClient, eventBuilder: EventBuilder, bindings: RuntimeEventBindings, dispatch?: RuntimeEventDispatch): RuntimeEventMethods;
-
-export { type AnalyticsEventMethod, EventProfileRequiredError, type PersonalizationEventMethod, type RuntimeEventBindings, type RuntimeEventDispatch, type RuntimeEventMethods, type RuntimeOptimizationApiClient, createRuntimeEventMethods };

package/dist/runtime-event-methods.js

@@ -1,109 +0,0 @@
-import {
-  PartialProfile as EventProfileSchema
-} from "@contentful/optimization-api-client/api-schemas";
-class EventProfileRequiredError extends Error {
-  method;
-  constructor(method) {
-    super(
-      `${method}() requires a current event profile. Supply an initial profile or await identify(), page(), or track() first.`
-    );
-    this.name = "EventProfileRequiredError";
-    this.method = method;
-  }
-}
-class BoundRuntimeEventMethods {
-  constructor(eventBuilder, bindings, dispatch) {
-    this.eventBuilder = eventBuilder;
-    this.bindings = bindings;
-    this.dispatch = dispatch;
-  }
-  eventBuilder;
-  bindings;
-  dispatch;
-  get profile() {
-    return this.bindings.getProfile();
-  }
-  async identify(args) {
-    return this.sendPersonalizationEvent(
-      this.eventBuilder.buildIdentify(this.withEventContext(args))
-    );
-  }
-  async page(args = {}) {
-    return this.sendPersonalizationEvent(
-      this.eventBuilder.buildPageView(this.withEventContext(args))
-    );
-  }
-  async track(args) {
-    return this.sendPersonalizationEvent(this.eventBuilder.buildTrack(this.withEventContext(args)));
-  }
-  async trackView(args) {
-    return this.sendAnalyticsEvent(
-      "trackView",
-      this.eventBuilder.buildView(this.withEventContext(args))
-    );
-  }
-  async trackClick(args) {
-    return this.sendAnalyticsEvent(
-      "trackClick",
-      this.eventBuilder.buildClick(this.withEventContext(args))
-    );
-  }
-  async trackHover(args) {
-    return this.sendAnalyticsEvent(
-      "trackHover",
-      this.eventBuilder.buildHover(this.withEventContext(args))
-    );
-  }
-  async trackFlagView(args) {
-    return this.sendAnalyticsEvent(
-      "trackFlagView",
-      this.eventBuilder.buildFlagView(this.withEventContext(args))
-    );
-  }
-  withEventContext(args) {
-    return { ...this.bindings.getEventContext?.(), ...args };
-  }
-  withConsent(event) {
-    const consent = this.bindings.getConsent?.();
-    if (consent === void 0) return event;
-    return {
-      ...event,
-      context: {
-        ...event.context,
-        gdpr: { ...event.context.gdpr, isConsentGiven: consent }
-      }
-    };
-  }
-  async sendPersonalizationEvent(event) {
-    const eventWithConsent = this.withConsent(event);
-    const profileRevision = this.bindings.getProfileRevision?.();
-    const data = await this.dispatch.personalization(eventWithConsent, this.profile);
-    if (profileRevision === void 0 || this.bindings.getProfileRevision?.() === profileRevision) {
-      this.bindings.setProfile(data.profile);
-    }
-    return data;
-  }
-  async sendAnalyticsEvent(method, event) {
-    const profile = this.profile;
-    if (profile === void 0) throw new EventProfileRequiredError(method);
-    return this.dispatch.analytics(this.withConsent(event), profile);
-  }
-}
-function createDirectEventDispatch(api) {
-  return {
-    personalization: (event, profile) => api.personalization.upsertProfile(
-      { profileId: profile?.id, events: [event] },
-      { locale: event.context.locale }
-    ),
-    analytics: (event, profile) => api.analytics.sendBatchEvents([{ profile, events: [event] }])
-  };
-}
-function createRuntimeEventMethods(api, eventBuilder, bindings, dispatch = createDirectEventDispatch(api)) {
-  return new BoundRuntimeEventMethods(eventBuilder, bindings, dispatch);
-}
-export {
-  EventProfileRequiredError,
-  EventProfileSchema,
-  createRuntimeEventMethods
-};
-//# sourceMappingURL=runtime-event-methods.js.map

package/dist/runtime-event-methods.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/runtime-event-methods.ts"],"sourcesContent":["import type {\n  ExperienceApiClient as PersonalizationApiClient,\n  InsightsApiClient as AnalyticsApiClient,\n} from '@contentful/optimization-api-client';\nimport {\n  PartialProfile as EventProfileSchema,\n  type ExperienceEvent as PersonalizationEvent,\n  type InsightsEvent as AnalyticsEvent,\n  type OptimizationData as EventOptimizationData,\n  type PartialProfile as EventProfile,\n} from '@contentful/optimization-api-client/api-schemas';\nimport type EventBuilder from './event-builder.js';\nimport type {\n  ClickBuilderArgs,\n  FlagViewBuilderArgs,\n  HoverBuilderArgs,\n  IdentifyBuilderArgs,\n  PageViewBuilderArgs,\n  TrackBuilderArgs,\n  UniversalEventBuilderArgs,\n  ViewBuilderArgs,\n} from './event-builder.js';\n\n/** Runtime schema for profiles retained by public runtime leaves. */\nexport { EventProfileSchema };\nexport type { EventOptimizationData, EventProfile };\n\nexport type PersonalizationEventMethod = 'identify' | 'page' | 'track';\nexport type AnalyticsEventMethod = 'trackView' | 'trackClick' | 'trackHover' | 'trackFlagView';\n\n/** The Optimization API surface used by the shared runtime. */\nexport interface RuntimeOptimizationApiClient {\n  readonly personalization: Pick<PersonalizationApiClient, 'upsertProfile'>;\n  readonly analytics: Pick<AnalyticsApiClient, 'sendBatchEvents'>;\n}\n\n/** Internal strategy used by a runtime to commit or stage built events. */\nexport interface RuntimeEventDispatch {\n  personalization(\n    event: PersonalizationEvent,\n    profile: EventProfile | undefined\n  ): Promise<EventOptimizationData>;\n  analytics(event: AnalyticsEvent, profile: EventProfile): Promise<boolean>;\n}\n\n/** Runtime-owned state and context used to bind otherwise stateless event methods. */\nexport interface RuntimeEventBindings {\n  getProfile: () => EventProfile | undefined;\n  setProfile: (profile: EventProfile) => void;\n  /** Changes when an external session boundary must invalidate an in-flight profile response. */\n  getProfileRevision?: () => number;\n  getEventContext?: () => UniversalEventBuilderArgs;\n  getConsent?: () => boolean | undefined;\n}\n\n/**\n * Event-triggering surface shared by the public Node and Web runtimes.\n * Profile-producing calls are not serialized; await them before another\n * profile-producing or Analytics call on the same bound runtime. In Node\n * handoff mode an Analytics `true` means accepted into the handoff journal,\n * not delivered to the Analytics transport.\n */\nexport interface RuntimeEventMethods {\n  readonly profile: EventProfile | undefined;\n  identify(args: IdentifyBuilderArgs): Promise<EventOptimizationData>;\n  page(args?: PageViewBuilderArgs): Promise<EventOptimizationData>;\n  track(args: TrackBuilderArgs): Promise<EventOptimizationData>;\n  trackView(args: ViewBuilderArgs): Promise<boolean>;\n  trackClick(args: ClickBuilderArgs): Promise<boolean>;\n  trackHover(args: HoverBuilderArgs): Promise<boolean>;\n  trackFlagView(args: FlagViewBuilderArgs): Promise<boolean>;\n}\n\n/** Thrown when an Analytics event is triggered before a profile is available. */\nexport class EventProfileRequiredError extends Error {\n  readonly method: AnalyticsEventMethod;\n\n  constructor(method: AnalyticsEventMethod) {\n    super(\n      `${method}() requires a current event profile. Supply an initial profile or await identify(), page(), or track() first.`\n    );\n    this.name = 'EventProfileRequiredError';\n    this.method = method;\n  }\n}\n\nclass BoundRuntimeEventMethods implements RuntimeEventMethods {\n  constructor(\n    private readonly eventBuilder: EventBuilder,\n    private readonly bindings: RuntimeEventBindings,\n    private readonly dispatch: RuntimeEventDispatch\n  ) {}\n\n  get profile(): EventProfile | undefined {\n    return this.bindings.getProfile();\n  }\n\n  async identify(args: IdentifyBuilderArgs): Promise<EventOptimizationData> {\n    return this.sendPersonalizationEvent(\n      this.eventBuilder.buildIdentify(this.withEventContext(args))\n    );\n  }\n\n  async page(args: PageViewBuilderArgs = {}): Promise<EventOptimizationData> {\n    return this.sendPersonalizationEvent(\n      this.eventBuilder.buildPageView(this.withEventContext(args))\n    );\n  }\n\n  async track(args: TrackBuilderArgs): Promise<EventOptimizationData> {\n    return this.sendPersonalizationEvent(this.eventBuilder.buildTrack(this.withEventContext(args)));\n  }\n\n  async trackView(args: ViewBuilderArgs): Promise<boolean> {\n    return this.sendAnalyticsEvent(\n      'trackView',\n      this.eventBuilder.buildView(this.withEventContext(args))\n    );\n  }\n\n  async trackClick(args: ClickBuilderArgs): Promise<boolean> {\n    return this.sendAnalyticsEvent(\n      'trackClick',\n      this.eventBuilder.buildClick(this.withEventContext(args))\n    );\n  }\n\n  async trackHover(args: HoverBuilderArgs): Promise<boolean> {\n    return this.sendAnalyticsEvent(\n      'trackHover',\n      this.eventBuilder.buildHover(this.withEventContext(args))\n    );\n  }\n\n  async trackFlagView(args: FlagViewBuilderArgs): Promise<boolean> {\n    return this.sendAnalyticsEvent(\n      'trackFlagView',\n      this.eventBuilder.buildFlagView(this.withEventContext(args))\n    );\n  }\n\n  private withEventContext<TArgs extends UniversalEventBuilderArgs>(args: TArgs): TArgs {\n    return { ...this.bindings.getEventContext?.(), ...args } as TArgs;\n  }\n\n  private withConsent<TEvent extends PersonalizationEvent | AnalyticsEvent>(event: TEvent): TEvent {\n    const consent = this.bindings.getConsent?.();\n    if (consent === undefined) return event;\n\n    return {\n      ...event,\n      context: {\n        ...event.context,\n        gdpr: { ...event.context.gdpr, isConsentGiven: consent },\n      },\n    } as TEvent;\n  }\n\n  private async sendPersonalizationEvent(\n    event: PersonalizationEvent\n  ): Promise<EventOptimizationData> {\n    const eventWithConsent = this.withConsent(event);\n    const profileRevision = this.bindings.getProfileRevision?.();\n    const data = await this.dispatch.personalization(eventWithConsent, this.profile);\n    if (profileRevision === undefined || this.bindings.getProfileRevision?.() === profileRevision) {\n      this.bindings.setProfile(data.profile);\n    }\n    return data;\n  }\n\n  private async sendAnalyticsEvent(\n    method: AnalyticsEventMethod,\n    event: AnalyticsEvent\n  ): Promise<boolean> {\n    const profile = this.profile;\n    if (profile === undefined) throw new EventProfileRequiredError(method);\n    return this.dispatch.analytics(this.withConsent(event), profile);\n  }\n}\n\nfunction createDirectEventDispatch(api: RuntimeOptimizationApiClient): RuntimeEventDispatch {\n  return {\n    personalization: (event, profile) =>\n      api.personalization.upsertProfile(\n        { profileId: profile?.id, events: [event] },\n        { locale: event.context.locale }\n      ),\n    analytics: (event, profile) => api.analytics.sendBatchEvents([{ profile, events: [event] }]),\n  };\n}\n\nexport function createRuntimeEventMethods(\n  api: RuntimeOptimizationApiClient,\n  eventBuilder: EventBuilder,\n  bindings: RuntimeEventBindings,\n  dispatch: RuntimeEventDispatch = createDirectEventDispatch(api)\n): RuntimeEventMethods {\n  return new BoundRuntimeEventMethods(eventBuilder, bindings, dispatch);\n}\n"],"mappings":"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","names":[]}

package/dist/sdk-info.d.ts

@@ -1,12 +0,0 @@
-/**
- * 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

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

package/dist/sdk-info.js.map

@@ -1 +0,0 @@
-{"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":[]}