@contentful/experiences-client 0.9.1 → 0.9.3

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## 0.9.3 (2026-10-12)
+
+### 🚀 Features
+
+- [NT-4312] keep a raw payload's source map and let callers override it ([#222](https://github.com/contentful/experiences/pull/222))
+
+### 🧱 Updated Dependencies
+
+- Updated core to 0.12.2
+
+## 0.9.2 (2026-10-09)
+
+### 🚀 Features
+
+- **runtime:** extract shared runtime from client ([#228](https://github.com/contentful/experiences/pull/228))
+
+### 🧱 Updated Dependencies
+
+- Updated core to 0.12.1
+
 ## 0.9.1 (2026-10-08)
 
 ### 🚀 Features

package/README.md

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

@@ -10,20 +10,6 @@ type CreateClientOptions = {
      */
     host?: string;
 } & Omit<ContentfulViewDeliveryClient.Options, 'token' | 'baseUrl'>;
-type RuntimeDeliveryClientBaseOptions = Omit<ContentfulViewDeliveryClient.Options, 'token' | 'baseUrl'>;
-/** Configuration for a Delivery or Preview client owned by a runtime. */
-type RuntimeDeliveryClientOptions = RuntimeDeliveryClientBaseOptions & ({
-    /** Bearer token or token supplier used for direct Delivery/Preview API access. */
-    accessToken: ContentfulViewDeliveryClient.Options['token'];
-    /** Optional endpoint override or endpoint supplier. */
-    host?: ContentfulViewDeliveryClient.Options['baseUrl'];
-} | {
-    accessToken?: never;
-    /** Explicit proxy endpoint that owns upstream authentication. */
-    host: NonNullable<ContentfulViewDeliveryClient.Options['baseUrl']>;
-});
 declare function createClient(options: CreateClientOptions): ContentfulViewDeliveryClient;
-/** Constructs a runtime-owned client, disabling generated auth for a tokenless proxy. */
-declare function createRuntimeDeliveryClient(options: RuntimeDeliveryClientOptions, defaultHost?: NonNullable<ContentfulViewDeliveryClient.Options['baseUrl']>): ContentfulViewDeliveryClient;
 
-export { type CreateClientOptions, type RuntimeDeliveryClientOptions, createClient, createRuntimeDeliveryClient };
+export { type CreateClientOptions, createClient };

package/dist/create-delivery-client.js

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

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

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

package/dist/fetch-experience.js

@@ -4,7 +4,6 @@ import { assertDestinationPreviewSupported } from "./destination-guards.js";
 import { resolveDeliveryClient } from "./client-resolution.js";
 import { ExperienceFetchError } from "./errors.js";
 import {
-  readSourceMap,
   toExperiencePayload,
   toExperiencePayloadFromDestination
 } from "./to-experience-payload.js";
@@ -51,13 +50,8 @@ async function fetchExperience(experienceOptions, clientOptions, resolveOptions)
   });
   const response = await fetchByExperienceId(client, experienceOptions);
   const payload = toExperiencePayload(response);
-  const sourceMap = extensions?.sourceMap !== void 0 ? readSourceMap(response) : void 0;
   log.lazy("received raw payload", () => payload);
-  return resolveExperience(payload, config, {
-    metadata,
-    debug,
-    sourceMap
-  });
+  return resolveExperience(payload, config, { metadata, debug });
 }
 async function fetchByExperienceId(client, options) {
   const { spaceId, environmentId, experienceId, locale, personalization, extensions } = options;

package/dist/fetch-experience.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/fetch-experience.ts"],"sourcesContent":["import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { createDebugLogger, resolveExperience } from '@contentful/experiences-sdk-core';\nimport type { PortableRenderPlan, ResolverConfig } from '@contentful/experiences-sdk-core';\nimport { assertDestinationPreviewSupported } from './destination-guards.js';\nimport { resolveDeliveryClient, type ClientOptions } from './client-resolution.js';\nimport { ExperienceFetchError } from './errors.js';\nimport {\n  readSourceMap,\n  toExperiencePayload,\n  toExperiencePayloadFromDestination,\n  type ExperienceResponse,\n} from './to-experience-payload.js';\n\nexport type { ClientOptions };\n\ntype DeliveryExperienceRequestExtensions =\n  ContentfulViewDelivery.GetWithOverridesExperienceRequestExtensions;\n\nexport type PersonalizationOptions = NonNullable<\n  DeliveryExperienceRequestExtensions['personalization']\n>;\n\nexport type ExperienceRequestExtensions = Omit<\n  DeliveryExperienceRequestExtensions,\n  'personalization'\n>;\n\nexport type ByIdExperienceOptions = {\n  spaceId: string;\n  environmentId: string;\n  experienceId: string;\n  locale?: string;\n  /**\n   * Profile and events used by XDA to personalize the resolved Experience.\n   */\n  personalization?: PersonalizationOptions;\n  /**\n   * Additional XDA request extensions such as source maps. Supplying a defined\n   * extension switches the request to POST.\n   */\n  extensions?: ExperienceRequestExtensions;\n};\n\n/**\n * Resolve an Experience by the Destination Node instead of `experienceId`\n * The destinations delivery endpoints are space-scoped only and have no locale\n * param, unlike the by-id path.\n */\nexport type ByDestinationNodeIdExperienceOptions = {\n  spaceId: string;\n  destinationId: string;\n  nodeId: string;\n};\n\n/**\n * Resolve an Experience by the absolute path wired up to a\n * Destination Node, instead of a node id directly. Same scoping as\n * `ByDestinationNodeIdExperienceOptions` — no `environmentId` or `locale`.\n */\nexport type ByDestinationPathExperienceOptions = {\n  spaceId: string;\n  destinationId: string;\n  /** Absolute path to resolve. Must start with `/`. */\n  path: string;\n};\n\nexport type ExperienceOptions =\n  ByIdExperienceOptions | ByDestinationNodeIdExperienceOptions | ByDestinationPathExperienceOptions;\n\n/**\n * A Destination resolution that the app must act on as control flow — honor\n * it by navigating or re-resolving at the new path — rather than a hydrated\n * Experience to render. Modeled as a normal return value, not a thrown error,\n * per the Destinations delivery API's own framing of a redirect response.\n */\nexport interface DestinationRedirectResult {\n  redirect: { path: string };\n}\n\nexport type ResolveOptions = {\n  config: ResolverConfig;\n  /**\n   * Arbitrary per-render metadata exposed to every resolver as\n   * `ctx.experience.metadata` and readable at render time via the framework\n   * adapter's `useExperience()` / `getExperience()`.\n   */\n  metadata?: Record<string, unknown>;\n  /**\n   * Observability switch. When on: logs the fetch (host, ids) and the raw\n   * payload here, and threads through to `resolveExperience` (resolution steps\n   * + `resolveData` timings) and the renderer (visible missing-component box,\n   * debug fallback). A single boolean across fetch + resolve + render.\n   */\n  debug?: boolean;\n};\n\n// TS overload signatures, not real redeclarations — base ESLint's no-redeclare doesn't know the\n// overload form (@typescript-eslint's own version does), so each repeated signature needs a\n// disable comment.\nexport async function fetchExperience(\n  experienceOptions: ByIdExperienceOptions,\n  clientOptions: ClientOptions,\n  resolveOptions: ResolveOptions\n): Promise<PortableRenderPlan>;\n// eslint-disable-next-line no-redeclare -- see above\nexport async function fetchExperience(\n  experienceOptions: ByDestinationNodeIdExperienceOptions,\n  clientOptions: ClientOptions,\n  resolveOptions: ResolveOptions\n): Promise<PortableRenderPlan | DestinationRedirectResult>;\n// eslint-disable-next-line no-redeclare -- see above\nexport async function fetchExperience(\n  experienceOptions: ByDestinationPathExperienceOptions,\n  clientOptions: ClientOptions,\n  resolveOptions: ResolveOptions\n): Promise<PortableRenderPlan | DestinationRedirectResult>;\n// eslint-disable-next-line no-redeclare -- see above\nexport async function fetchExperience(\n  experienceOptions: ExperienceOptions,\n  clientOptions: ClientOptions,\n  resolveOptions: ResolveOptions\n): Promise<PortableRenderPlan | DestinationRedirectResult> {\n  const { config, metadata, debug } = resolveOptions;\n  const log = createDebugLogger(debug, 'client');\n\n  if (!('client' in clientOptions) && 'destinationId' in experienceOptions) {\n    const { spaceId, destinationId } = experienceOptions;\n    const locator =\n      'nodeId' in experienceOptions\n        ? { nodeId: experienceOptions.nodeId }\n        : { path: experienceOptions.path };\n    assertDestinationPreviewSupported(clientOptions.preview, {\n      spaceId,\n      destinationId,\n      ...locator,\n    });\n  }\n\n  const client = resolveDeliveryClient(clientOptions, log, 'fetchExperience');\n\n  if ('nodeId' in experienceOptions) {\n    const { spaceId, destinationId, nodeId } = experienceOptions;\n    return fetchByDestination(\n      { spaceId, destinationId, locator: nodeId },\n      () => client.destination.resolveByNodeId(spaceId, destinationId, nodeId),\n      log,\n      { config, metadata, debug }\n    );\n  }\n\n  if ('path' in experienceOptions) {\n    const { spaceId, destinationId, path } = experienceOptions;\n    return fetchByDestination(\n      { spaceId, destinationId, locator: path },\n      () => client.destination.resolveByPath(spaceId, destinationId, { path }),\n      log,\n      { config, metadata, debug }\n    );\n  }\n\n  const { spaceId, environmentId, experienceId, locale, personalization, extensions } =\n    experienceOptions;\n\n  log.log('fetching experience', {\n    spaceId,\n    environmentId,\n    experienceId,\n    locale,\n    // avoiding log any personalization sensitive data\n    personalization: personalization !== undefined,\n    extensions,\n  });\n\n  const response = await fetchByExperienceId(client, experienceOptions);\n\n  const payload = toExperiencePayload(response);\n  const sourceMap = extensions?.sourceMap !== undefined ? readSourceMap(response) : undefined;\n\n  log.lazy('received raw payload', () => payload);\n\n  return resolveExperience(payload, config, {\n    metadata,\n    debug,\n    sourceMap,\n  });\n}\n\nasync function fetchByExperienceId(\n  client: ContentfulViewDeliveryClient,\n  options: ByIdExperienceOptions\n): Promise<ExperienceResponse> {\n  const { spaceId, environmentId, experienceId, locale, personalization, extensions } = options;\n  const requestExtensions: DeliveryExperienceRequestExtensions = {\n    ...extensions,\n    ...(personalization === undefined ? {} : { personalization }),\n  };\n\n  try {\n    // Both methods hit the same endpoint, but only the POST operation accepts\n    // extensions in its request body. Keep the cacheable GET when there are no\n    // extensions to evaluate.\n    // The generated delivery client owns the alpha-feature header on both\n    // paths, including when the caller supplied the client instance.\n    //\n    // Await inside the try so rejected requests are normalized below.\n    if (hasRequestExtensions(requestExtensions)) {\n      return await client.experience.getWithOverrides(spaceId, environmentId, experienceId, {\n        locale,\n        extensions: requestExtensions,\n      });\n    }\n\n    return await client.experience.get(spaceId, environmentId, experienceId, { locale });\n  } catch (err) {\n    // Preserve expected 404 control flow for framework routers. Other failures\n    // are wrapped with stable SDK context instead of exposing transport-specific\n    // error shapes.\n    if (err instanceof ContentfulViewDelivery.NotFoundError) {\n      throw err;\n    }\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new ExperienceFetchError(\n      `Failed to fetch Experience \"${experienceId}\" (space \"${spaceId}\", environment ` +\n        `\"${environmentId}\"): ${reason}. Check network connectivity, the access token, and ` +\n        `that the space/environment/experience ids are correct.`,\n      { spaceId, environmentId, experienceId, cause: err }\n    );\n  }\n}\n\n/**\n * Shared response-handling for both destination-shaped `fetchExperience`\n * branches (by node id, by path).\n */\nasync function fetchByDestination(\n  identity: { spaceId: string; destinationId: string; locator: string },\n  resolve: () => Promise<ContentfulViewDelivery.DestinationExperienceResolutionResponse>,\n  log: ReturnType<typeof createDebugLogger>,\n  resolveOptions: {\n    config: ResolverConfig;\n    metadata: Record<string, unknown> | undefined;\n    debug: boolean | undefined;\n  }\n): Promise<PortableRenderPlan | DestinationRedirectResult> {\n  const { spaceId, destinationId, locator } = identity;\n  const { config, metadata, debug } = resolveOptions;\n\n  log.log('resolving destination experience', { spaceId, destinationId, locator });\n\n  let response: ContentfulViewDelivery.DestinationExperienceResolutionResponse;\n  try {\n    response = await resolve();\n  } catch (err) {\n    if (err instanceof ContentfulViewDelivery.NotFoundError) {\n      throw err;\n    }\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new ExperienceFetchError(\n      `Failed to resolve Destination \"${destinationId}\" at \"${locator}\" (space \"${spaceId}\"): ` +\n        `${reason}. Check network connectivity, the access token, and that the space/` +\n        `destination/node-or-path values are correct.`,\n      { spaceId, experienceId: locator, cause: err }\n    );\n  }\n\n  if ('redirect' in response) {\n    log.log('destination resolved to a redirect', response.redirect);\n    return { redirect: response.redirect };\n  }\n\n  const [firstExperience] = response.experiences;\n  if (!firstExperience) {\n    throw new ExperienceFetchError(\n      `Destination \"${destinationId}\" resolved \"${locator}\" to zero Experiences ` +\n        `(space \"${spaceId}\"). Expected exactly one hydrated Experience or a redirect.`,\n      { spaceId, experienceId: locator }\n    );\n  }\n\n  const payload = toExperiencePayloadFromDestination(firstExperience.experience);\n  log.lazy('received raw payload', () => payload);\n\n  return resolveExperience(payload, config, {\n    metadata,\n    debug,\n  });\n}\n\nfunction hasRequestExtensions(\n  extensions: DeliveryExperienceRequestExtensions | undefined\n): extensions is DeliveryExperienceRequestExtensions {\n  return (\n    extensions !== undefined &&\n    Object.values(extensions).some((extension) => extension !== undefined)\n  );\n}\n"],"mappings":"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","names":["spaceId"]}
+{"version":3,"sources":["../src/fetch-experience.ts"],"sourcesContent":["import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { createDebugLogger, resolveExperience } from '@contentful/experiences-sdk-core';\nimport type { PortableRenderPlan, ResolverConfig } from '@contentful/experiences-sdk-core';\nimport { assertDestinationPreviewSupported } from './destination-guards.js';\nimport { resolveDeliveryClient, type ClientOptions } from './client-resolution.js';\nimport { ExperienceFetchError } from './errors.js';\nimport {\n  toExperiencePayload,\n  toExperiencePayloadFromDestination,\n  type ExperienceResponse,\n} from './to-experience-payload.js';\n\nexport type { ClientOptions };\n\ntype DeliveryExperienceRequestExtensions =\n  ContentfulViewDelivery.GetWithOverridesExperienceRequestExtensions;\n\nexport type PersonalizationOptions = NonNullable<\n  DeliveryExperienceRequestExtensions['personalization']\n>;\n\nexport type ExperienceRequestExtensions = Omit<\n  DeliveryExperienceRequestExtensions,\n  'personalization'\n>;\n\nexport type ByIdExperienceOptions = {\n  spaceId: string;\n  environmentId: string;\n  experienceId: string;\n  locale?: string;\n  /**\n   * Profile and events used by XDA to personalize the resolved Experience.\n   */\n  personalization?: PersonalizationOptions;\n  /**\n   * Additional XDA request extensions such as source maps. Supplying a defined\n   * extension switches the request to POST.\n   */\n  extensions?: ExperienceRequestExtensions;\n};\n\n/**\n * Resolve an Experience by the Destination Node instead of `experienceId`\n * The destinations delivery endpoints are space-scoped only and have no locale\n * param, unlike the by-id path.\n */\nexport type ByDestinationNodeIdExperienceOptions = {\n  spaceId: string;\n  destinationId: string;\n  nodeId: string;\n};\n\n/**\n * Resolve an Experience by the absolute path wired up to a\n * Destination Node, instead of a node id directly. Same scoping as\n * `ByDestinationNodeIdExperienceOptions` — no `environmentId` or `locale`.\n */\nexport type ByDestinationPathExperienceOptions = {\n  spaceId: string;\n  destinationId: string;\n  /** Absolute path to resolve. Must start with `/`. */\n  path: string;\n};\n\nexport type ExperienceOptions =\n  ByIdExperienceOptions | ByDestinationNodeIdExperienceOptions | ByDestinationPathExperienceOptions;\n\n/**\n * A Destination resolution that the app must act on as control flow — honor\n * it by navigating or re-resolving at the new path — rather than a hydrated\n * Experience to render. Modeled as a normal return value, not a thrown error,\n * per the Destinations delivery API's own framing of a redirect response.\n */\nexport interface DestinationRedirectResult {\n  redirect: { path: string };\n}\n\nexport type ResolveOptions = {\n  config: ResolverConfig;\n  /**\n   * Arbitrary per-render metadata exposed to every resolver as\n   * `ctx.experience.metadata` and readable at render time via the framework\n   * adapter's `useExperience()` / `getExperience()`.\n   */\n  metadata?: Record<string, unknown>;\n  /**\n   * Observability switch. When on: logs the fetch (host, ids) and the raw\n   * payload here, and threads through to `resolveExperience` (resolution steps\n   * + `resolveData` timings) and the renderer (visible missing-component box,\n   * debug fallback). A single boolean across fetch + resolve + render.\n   */\n  debug?: boolean;\n};\n\n// TS overload signatures, not real redeclarations — base ESLint's no-redeclare doesn't know the\n// overload form (@typescript-eslint's own version does), so each repeated signature needs a\n// disable comment.\nexport async function fetchExperience(\n  experienceOptions: ByIdExperienceOptions,\n  clientOptions: ClientOptions,\n  resolveOptions: ResolveOptions\n): Promise<PortableRenderPlan>;\n// eslint-disable-next-line no-redeclare -- see above\nexport async function fetchExperience(\n  experienceOptions: ByDestinationNodeIdExperienceOptions,\n  clientOptions: ClientOptions,\n  resolveOptions: ResolveOptions\n): Promise<PortableRenderPlan | DestinationRedirectResult>;\n// eslint-disable-next-line no-redeclare -- see above\nexport async function fetchExperience(\n  experienceOptions: ByDestinationPathExperienceOptions,\n  clientOptions: ClientOptions,\n  resolveOptions: ResolveOptions\n): Promise<PortableRenderPlan | DestinationRedirectResult>;\n// eslint-disable-next-line no-redeclare -- see above\nexport async function fetchExperience(\n  experienceOptions: ExperienceOptions,\n  clientOptions: ClientOptions,\n  resolveOptions: ResolveOptions\n): Promise<PortableRenderPlan | DestinationRedirectResult> {\n  const { config, metadata, debug } = resolveOptions;\n  const log = createDebugLogger(debug, 'client');\n\n  if (!('client' in clientOptions) && 'destinationId' in experienceOptions) {\n    const { spaceId, destinationId } = experienceOptions;\n    const locator =\n      'nodeId' in experienceOptions\n        ? { nodeId: experienceOptions.nodeId }\n        : { path: experienceOptions.path };\n    assertDestinationPreviewSupported(clientOptions.preview, {\n      spaceId,\n      destinationId,\n      ...locator,\n    });\n  }\n\n  const client = resolveDeliveryClient(clientOptions, log, 'fetchExperience');\n\n  if ('nodeId' in experienceOptions) {\n    const { spaceId, destinationId, nodeId } = experienceOptions;\n    return fetchByDestination(\n      { spaceId, destinationId, locator: nodeId },\n      () => client.destination.resolveByNodeId(spaceId, destinationId, nodeId),\n      log,\n      { config, metadata, debug }\n    );\n  }\n\n  if ('path' in experienceOptions) {\n    const { spaceId, destinationId, path } = experienceOptions;\n    return fetchByDestination(\n      { spaceId, destinationId, locator: path },\n      () => client.destination.resolveByPath(spaceId, destinationId, { path }),\n      log,\n      { config, metadata, debug }\n    );\n  }\n\n  const { spaceId, environmentId, experienceId, locale, personalization, extensions } =\n    experienceOptions;\n\n  log.log('fetching experience', {\n    spaceId,\n    environmentId,\n    experienceId,\n    locale,\n    // avoiding log any personalization sensitive data\n    personalization: personalization !== undefined,\n    extensions,\n  });\n\n  const response = await fetchByExperienceId(client, experienceOptions);\n\n  const payload = toExperiencePayload(response);\n  log.lazy('received raw payload', () => payload);\n\n  return resolveExperience(payload, config, { metadata, debug });\n}\n\nasync function fetchByExperienceId(\n  client: ContentfulViewDeliveryClient,\n  options: ByIdExperienceOptions\n): Promise<ExperienceResponse> {\n  const { spaceId, environmentId, experienceId, locale, personalization, extensions } = options;\n  const requestExtensions: DeliveryExperienceRequestExtensions = {\n    ...extensions,\n    ...(personalization === undefined ? {} : { personalization }),\n  };\n\n  try {\n    // Both methods hit the same endpoint, but only the POST operation accepts\n    // extensions in its request body. Keep the cacheable GET when there are no\n    // extensions to evaluate.\n    // The generated delivery client owns the alpha-feature header on both\n    // paths, including when the caller supplied the client instance.\n    //\n    // Await inside the try so rejected requests are normalized below.\n    if (hasRequestExtensions(requestExtensions)) {\n      return await client.experience.getWithOverrides(spaceId, environmentId, experienceId, {\n        locale,\n        extensions: requestExtensions,\n      });\n    }\n\n    return await client.experience.get(spaceId, environmentId, experienceId, { locale });\n  } catch (err) {\n    // Preserve expected 404 control flow for framework routers. Other failures\n    // are wrapped with stable SDK context instead of exposing transport-specific\n    // error shapes.\n    if (err instanceof ContentfulViewDelivery.NotFoundError) {\n      throw err;\n    }\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new ExperienceFetchError(\n      `Failed to fetch Experience \"${experienceId}\" (space \"${spaceId}\", environment ` +\n        `\"${environmentId}\"): ${reason}. Check network connectivity, the access token, and ` +\n        `that the space/environment/experience ids are correct.`,\n      { spaceId, environmentId, experienceId, cause: err }\n    );\n  }\n}\n\n/**\n * Shared response-handling for both destination-shaped `fetchExperience`\n * branches (by node id, by path).\n */\nasync function fetchByDestination(\n  identity: { spaceId: string; destinationId: string; locator: string },\n  resolve: () => Promise<ContentfulViewDelivery.DestinationExperienceResolutionResponse>,\n  log: ReturnType<typeof createDebugLogger>,\n  resolveOptions: {\n    config: ResolverConfig;\n    metadata: Record<string, unknown> | undefined;\n    debug: boolean | undefined;\n  }\n): Promise<PortableRenderPlan | DestinationRedirectResult> {\n  const { spaceId, destinationId, locator } = identity;\n  const { config, metadata, debug } = resolveOptions;\n\n  log.log('resolving destination experience', { spaceId, destinationId, locator });\n\n  let response: ContentfulViewDelivery.DestinationExperienceResolutionResponse;\n  try {\n    response = await resolve();\n  } catch (err) {\n    if (err instanceof ContentfulViewDelivery.NotFoundError) {\n      throw err;\n    }\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new ExperienceFetchError(\n      `Failed to resolve Destination \"${destinationId}\" at \"${locator}\" (space \"${spaceId}\"): ` +\n        `${reason}. Check network connectivity, the access token, and that the space/` +\n        `destination/node-or-path values are correct.`,\n      { spaceId, experienceId: locator, cause: err }\n    );\n  }\n\n  if ('redirect' in response) {\n    log.log('destination resolved to a redirect', response.redirect);\n    return { redirect: response.redirect };\n  }\n\n  const [firstExperience] = response.experiences;\n  if (!firstExperience) {\n    throw new ExperienceFetchError(\n      `Destination \"${destinationId}\" resolved \"${locator}\" to zero Experiences ` +\n        `(space \"${spaceId}\"). Expected exactly one hydrated Experience or a redirect.`,\n      { spaceId, experienceId: locator }\n    );\n  }\n\n  const payload = toExperiencePayloadFromDestination(firstExperience.experience);\n  log.lazy('received raw payload', () => payload);\n\n  return resolveExperience(payload, config, {\n    metadata,\n    debug,\n  });\n}\n\nfunction hasRequestExtensions(\n  extensions: DeliveryExperienceRequestExtensions | undefined\n): extensions is DeliveryExperienceRequestExtensions {\n  return (\n    extensions !== undefined &&\n    Object.values(extensions).some((extension) => extension !== undefined)\n  );\n}\n"],"mappings":"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","names":["spaceId"]}

package/dist/index.d.ts

@@ -1,21 +1,12 @@
 import { ContentfulViewDelivery } from '@contentful/experience-delivery';
 export { ContentfulViewDelivery, ContentfulViewDeliveryClient } from '@contentful/experience-delivery';
 export { DestinationPreviewNotSupportedError, ExperienceFetchError } from './errors.js';
-export { ANONYMOUS_ID_COOKIE, PROFILE_CACHE_KEY } from './constants.js';
-export { CreateClientOptions, RuntimeDeliveryClientOptions, createClient } from './create-delivery-client.js';
-export { RuntimeOptimizationConfig } from './create-optimization-client.js';
-export { ClickBuilderArgs, DEFAULT_PAGE_PROPERTIES, default as EventBuilder, EventBuilderConfig, FlagViewBuilderArgs, HoverBuilderArgs, IdentifyBuilderArgs, InteractionBuilderArgsBase, PageViewBuilderArgs, TrackBuilderArgs, UniversalEventBuilderArgs, ViewBuilderArgs } from './event-builder.js';
+export { CreateClientOptions, createClient } from './create-delivery-client.js';
 export { ByDestinationNodeIdExperienceOptions, ByDestinationPathExperienceOptions, ByIdExperienceOptions, DestinationRedirectResult, ExperienceOptions, ExperienceRequestExtensions, PersonalizationOptions, ResolveOptions, fetchExperience } from './fetch-experience.js';
 export { DestinationSitemapResult, FetchDestinationSitemapOptions, FetchDestinationSitemapPaginationOptions, SitemapPathItem, fetchDestinationSitemap } from './fetch-destination-sitemap.js';
-export { ContentfulExperiences, ContentfulExperiencesConfig, ExperienceRuntime, RuntimeEventBuilderConfig, RuntimeFetchByDestinationNodeOptions, RuntimeFetchByDestinationPathOptions, RuntimeFetchExperienceOptions, RuntimeResolveOptions } from './contentful-experiences.js';
-export { AnalyticsEventMethod, EventProfileRequiredError, PersonalizationEventMethod, RuntimeEventBindings, RuntimeEventMethods } from './runtime-event-methods.js';
-export { RUNTIME_EVENT_HANDOFF_VERSION, RuntimeEventHandoff, RuntimeEventHandoffEvent, RuntimeEventHandoffReceipt, RuntimeServerEventDelivery, assertRuntimeEventHandoffSize, parseRuntimeEventHandoff } from './runtime-event-handoff.js';
 export { ExperienceResponse, readSourceMap, toExperiencePayload, toExperiencePayloadFromDestination } from './to-experience-payload.js';
 export { DELIVERY_HOST, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST } from './hosts.js';
 export { ClientOptions } from './client-resolution.js';
-export { OptimizationData as EventOptimizationData, PartialProfile as EventProfile, PartialProfile as EventProfileSchema } from '@contentful/optimization-api-client/api-schemas';
-import '@contentful/optimization-api-client';
-import 'zod/mini';
 import '@contentful/experiences-sdk-core';
 
 declare const NotFoundError: typeof ContentfulViewDelivery.NotFoundError;

package/dist/index.js

@@ -5,19 +5,9 @@ import {
 } from "@contentful/experience-delivery";
 const NotFoundError = ContentfulViewDelivery.NotFoundError;
 import { ExperienceFetchError, DestinationPreviewNotSupportedError } from "./errors.js";
-import { ANONYMOUS_ID_COOKIE, PROFILE_CACHE_KEY } from "./constants.js";
 import { createClient } from "./create-delivery-client.js";
-import { default as default2 } from "./event-builder.js";
-export * from "./event-builder.js";
 import { fetchExperience } from "./fetch-experience.js";
 import { fetchDestinationSitemap } from "./fetch-destination-sitemap.js";
-import { ContentfulExperiences } from "./contentful-experiences.js";
-import { EventProfileRequiredError, EventProfileSchema } from "./runtime-event-methods.js";
-import {
-  assertRuntimeEventHandoffSize,
-  parseRuntimeEventHandoff,
-  RUNTIME_EVENT_HANDOFF_VERSION
-} from "./runtime-event-handoff.js";
 import {
   readSourceMap,
   toExperiencePayload,
@@ -25,26 +15,17 @@ import {
 } from "./to-experience-payload.js";
 import { DELIVERY_HOST, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST } from "./hosts.js";
 export {
-  ANONYMOUS_ID_COOKIE,
-  ContentfulExperiences,
   ContentfulViewDelivery2 as ContentfulViewDelivery,
   ContentfulViewDeliveryClient,
   DELIVERY_HOST,
   DestinationPreviewNotSupportedError,
-  default2 as EventBuilder,
-  EventProfileRequiredError,
-  EventProfileSchema,
   ExperienceFetchError,
   NotFoundError,
   PREVIEW_HOST,
   PREVIEW_WEBSOCKET_HOST,
-  PROFILE_CACHE_KEY,
-  RUNTIME_EVENT_HANDOFF_VERSION,
-  assertRuntimeEventHandoffSize,
   createClient,
   fetchDestinationSitemap,
   fetchExperience,
-  parseRuntimeEventHandoff,
   readSourceMap,
   toExperiencePayload,
   toExperiencePayloadFromDestination

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 { ANONYMOUS_ID_COOKIE, PROFILE_CACHE_KEY } from './constants.js';\nexport { createClient } from './create-delivery-client.js';\nexport type {\n  CreateClientOptions,\n  RuntimeDeliveryClientOptions,\n} from './create-delivery-client.js';\nexport type { RuntimeOptimizationConfig } from './create-optimization-client.js';\nexport { default as EventBuilder } from './event-builder.js';\nexport * from './event-builder.js';\nexport { fetchExperience } from './fetch-experience.js';\nexport { fetchDestinationSitemap } from './fetch-destination-sitemap.js';\nexport type {\n  FetchDestinationSitemapOptions,\n  FetchDestinationSitemapPaginationOptions,\n  SitemapPathItem,\n  DestinationSitemapResult,\n} from './fetch-destination-sitemap.js';\nexport { ContentfulExperiences } from './contentful-experiences.js';\nexport type {\n  ContentfulExperiencesConfig,\n  ExperienceRuntime,\n  RuntimeFetchExperienceOptions,\n  RuntimeFetchByDestinationNodeOptions,\n  RuntimeFetchByDestinationPathOptions,\n  RuntimeEventBuilderConfig,\n  RuntimeResolveOptions,\n} from './contentful-experiences.js';\nexport { EventProfileRequiredError, EventProfileSchema } from './runtime-event-methods.js';\nexport type {\n  EventOptimizationData,\n  EventProfile,\n  AnalyticsEventMethod,\n  PersonalizationEventMethod,\n  RuntimeEventBindings,\n  RuntimeEventMethods,\n} from './runtime-event-methods.js';\nexport {\n  assertRuntimeEventHandoffSize,\n  parseRuntimeEventHandoff,\n  RUNTIME_EVENT_HANDOFF_VERSION,\n} from './runtime-event-handoff.js';\nexport type {\n  RuntimeEventHandoff,\n  RuntimeEventHandoffEvent,\n  RuntimeEventHandoffReceipt,\n  RuntimeServerEventDelivery,\n} from './runtime-event-handoff.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  ExperienceRequestExtensions,\n  PersonalizationOptions,\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,qBAAqB,yBAAyB;AACvD,SAAS,oBAAoB;AAM7B,SAAoB,WAAXC,gBAA+B;AACxC,cAAc;AACd,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AAOxC,SAAS,6BAA6B;AAUtC,SAAS,2BAA2B,0BAA0B;AAS9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAaP,SAAS,eAAe,cAAc,8BAA8B;","names":["ContentfulViewDelivery","default"]}
+{"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-delivery-client.js';\nexport type { CreateClientOptions } from './create-delivery-client.js';\nexport { fetchExperience } from './fetch-experience.js';\nexport { fetchDestinationSitemap } from './fetch-destination-sitemap.js';\nexport type {\n  FetchDestinationSitemapOptions,\n  FetchDestinationSitemapPaginationOptions,\n  SitemapPathItem,\n  DestinationSitemapResult,\n} from './fetch-destination-sitemap.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  ExperienceRequestExtensions,\n  PersonalizationOptions,\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,SAAS,+BAA+B;AAOxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAaP,SAAS,eAAe,cAAc,8BAA8B;","names":["ContentfulViewDelivery"]}

package/package.json

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

package/dist/constants.d.ts

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

package/dist/constants.js

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

package/dist/constants.js.map

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

package/dist/contentful-experiences.d.ts

@@ -1,76 +0,0 @@
-import { ExperiencePayload, PortableRenderPlan, ResolverConfig } from '@contentful/experiences-sdk-core';
-import EventBuilder, { EventBuilderConfig } from './event-builder.js';
-import { RuntimeDeliveryClientOptions } from './create-delivery-client.js';
-import { PersonalizationOptions, ExperienceRequestExtensions, DestinationRedirectResult } from './fetch-experience.js';
-import { RuntimeOptimizationConfig } from './create-optimization-client.js';
-import { RuntimeOptimizationApiClient, RuntimeEventBindings, RuntimeEventDispatch, RuntimeEventMethods } from './runtime-event-methods.js';
-import '@contentful/optimization-api-client/api-schemas';
-import 'zod/mini';
-import '@contentful/experience-delivery';
-import './client-resolution.js';
-import '@contentful/optimization-api-client';
-
-type RuntimeResolveOptions = {
-    metadata?: Record<string, unknown>;
-    debug?: boolean;
-};
-type RuntimeEventBuilderConfig = Omit<EventBuilderConfig, 'channel' | 'library'> & {
-    channel: EventBuilderConfig['channel'];
-    library?: Partial<EventBuilderConfig['library']>;
-};
-type RuntimeFetchExperienceOptions = {
-    experienceId: string;
-    locale?: string;
-    personalization?: PersonalizationOptions;
-    extensions?: ExperienceRequestExtensions;
-    preview?: 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;
-    /** Configuration for the runtime-owned Content Delivery API client. */
-    delivery: RuntimeDeliveryClientOptions;
-    /** Optional configuration for the runtime-owned Content Preview API client. */
-    preview?: RuntimeDeliveryClientOptions;
-    /** Overrides for the runtime-owned Personalization and Analytics event transport. */
-    optimization?: RuntimeOptimizationConfig;
-    resolveDefaults?: Pick<RuntimeResolveOptions, 'metadata' | 'debug'>;
-    eventBuilder: RuntimeEventBuilderConfig;
-};
-declare class ContentfulExperiences implements ExperienceRuntime {
-    #private;
-    readonly spaceId: string;
-    readonly environmentId: string;
-    readonly eventBuilder: EventBuilder;
-    protected readonly optimizationApi: RuntimeOptimizationApiClient;
-    constructor(config: ContentfulExperiencesConfig);
-    get locale(): string | undefined;
-    protected createEventMethods(bindings: RuntimeEventBindings, dispatch?: RuntimeEventDispatch): RuntimeEventMethods;
-    resolveExperience(payload: ExperiencePayload, resolveOptions?: RuntimeResolveOptions): Promise<PortableRenderPlan>;
-    fetchExperience(options: RuntimeFetchExperienceOptions, resolveOptions?: RuntimeResolveOptions): Promise<PortableRenderPlan>;
-    fetchByDestinationNode(options: RuntimeFetchByDestinationNodeOptions, resolveOptions?: RuntimeResolveOptions): Promise<PortableRenderPlan | DestinationRedirectResult>;
-    fetchByDestinationPath(options: RuntimeFetchByDestinationPathOptions, resolveOptions?: RuntimeResolveOptions): Promise<PortableRenderPlan | DestinationRedirectResult>;
-}
-
-export { ContentfulExperiences, type ContentfulExperiencesConfig, type ExperienceRuntime, type RuntimeEventBuilderConfig, type RuntimeFetchByDestinationNodeOptions, type RuntimeFetchByDestinationPathOptions, type RuntimeFetchExperienceOptions, type RuntimeResolveOptions };

package/dist/contentful-experiences.js

@@ -1,104 +0,0 @@
-import { resolveExperience as resolveCoreExperience } from "@contentful/experiences-sdk-core";
-import EventBuilder from "./event-builder.js";
-import {
-  createRuntimeDeliveryClient
-} from "./create-delivery-client.js";
-import {
-  fetchExperience
-} from "./fetch-experience.js";
-import {
-  createRuntimeOptimizationClient
-} from "./create-optimization-client.js";
-import { PREVIEW_HOST } from "./hosts.js";
-import { DEFAULT_EVENT_CONTEXT_LIBRARY } from "./sdk-info.js";
-import {
-  createRuntimeEventMethods
-} from "./runtime-event-methods.js";
-class ContentfulExperiences {
-  spaceId;
-  environmentId;
-  eventBuilder;
-  #locale;
-  #resolverConfig;
-  #deliveryClient;
-  #previewClient;
-  optimizationApi;
-  #resolveDefaults;
-  constructor(config) {
-    this.spaceId = config.spaceId;
-    this.environmentId = config.environmentId;
-    this.#locale = config.locale;
-    this.#resolverConfig = config.resolverConfig;
-    this.#deliveryClient = createRuntimeDeliveryClient(config.delivery);
-    this.#previewClient = config.preview === void 0 ? void 0 : createRuntimeDeliveryClient(config.preview, PREVIEW_HOST);
-    this.optimizationApi = createRuntimeOptimizationClient({
-      spaceId: config.spaceId,
-      environmentId: config.environmentId,
-      ...config.optimization
-    });
-    this.#resolveDefaults = config.resolveDefaults ?? {};
-    this.eventBuilder = new EventBuilder({
-      ...config.eventBuilder,
-      library: { ...DEFAULT_EVENT_CONTEXT_LIBRARY, ...config.eventBuilder.library },
-      getLocale: config.eventBuilder.getLocale ?? (() => this.locale)
-    });
-  }
-  get locale() {
-    return this.#locale;
-  }
-  createEventMethods(bindings, dispatch) {
-    return createRuntimeEventMethods(this.optimizationApi, this.eventBuilder, bindings, dispatch);
-  }
-  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,
-        personalization: options.personalization,
-        extensions: options.extensions
-      },
-      {
-        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
-    };
-  }
-}
-export {
-  ContentfulExperiences
-};
-//# sourceMappingURL=contentful-experiences.js.map

package/dist/contentful-experiences.js.map

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