@contentful/experiences-client 0.10.1 → 0.10.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.10.2 (2026-10-22)
+
+### 🚀 Features
+
+- add runtime Experience parameters [ARC-2668] ([#235](https://github.com/contentful/experiences/pull/235))
+
 ## 0.10.1 (2026-10-22)
 
 ### 🚀 Features

package/README.md

@@ -14,13 +14,27 @@ The primary fetch + resolve entry point. Fetches an Experience payload from the
 
 By-ID options accept a first-class `personalization` object containing a profile id and events. Additional Experience Delivery options remain under `extensions`; use `extensions: { sourceMap: {} }` to request a content source map. Client merges both into the XDA request body and uses the POST operation whenever either capability is present.
 
+By-ID `parameters` accepts strings, numbers, and one-level Records of strings/numbers:
+`{ featuredPosts: { limit: 6, order: '-fields.title' } }`. IDs are declared in
+`Experience.parameters` and referenced by `$parameters/<id>`. Delivery validates
+names, requiredness, fallbacks and values. Collection order is one signed
+`fields.<apiName>` or `sys.<id>` path, never `OrderTerm[]`.
+
+GET uses `parameter.<id>` and `parameter.<id>.<field>` in the generated client's
+`queryParams`, separate from `locale`. Empty Records or defined extensions select
+POST, with structured, unprefixed `parameters` in the body. dev.10 supports that
+body through serializer passthrough, although its generated type omits the key;
+the SDK uses a local typed request extension. Authentication and rename headers
+remain owned by the generated client. Refetch with changed values and replace
+the renderer's plan; see the [runtime parameters example](../../README.md#runtime-experience-parameters).
+
 Three positional args group by concern:
 
-| Arg                 | Type                                                                  | Purpose                                                                                |
-| ------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| `experienceOptions` | `{ spaceId, environmentId, experienceId, locale? }`                   | Which Experience to fetch.                                                             |
-| `clientOptions`     | `{ accessToken, previewToken?, preview?, host? }` **or** `{ client }` | How to fetch — inline credentials (with optional preview toggle) or a pre-made client. |
-| `resolveOptions`    | `{ config, metadata?, debug? }`                                       | How to resolve — component registry, per-render `metadata`, and a `debug` switch.      |
+| Arg                 | Type                                                                                            | Purpose                                                                                |
+| ------------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| `experienceOptions` | `{ spaceId, environmentId, experienceId, locale?, parameters?, personalization?, extensions? }` | Which Experience to fetch.                                                             |
+| `clientOptions`     | `{ accessToken, previewToken?, preview?, host? }` **or** `{ client }`                           | How to fetch — inline credentials (with optional preview toggle) or a pre-made client. |
+| `resolveOptions`    | `{ config, metadata?, debug? }`                                                                 | How to resolve — component registry, per-render `metadata`, and a `debug` switch.      |
 
 ```ts
 import { fetchExperience } from '@contentful/experiences-react'; // or experiences-svelte

package/dist/index.cjs

@@ -97,6 +97,27 @@ function resolveDeliveryClient(clientOptions, log, callerName) {
   return client;
 }
 
+// src/experience-parameters.ts
+function parameterQuery(parameters) {
+  const entries = [];
+  for (const [id, value] of Object.entries(_nullishCoalesce(parameters, () => ( {})))) {
+    if (id.includes(".")) return void 0;
+    if (typeof value === "string" || typeof value === "number") {
+      entries.push([`parameter.${id}`, value]);
+    } else {
+      if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+      const leaves = Object.entries(value);
+      if (leaves.length === 0) return void 0;
+      for (const [field, leaf] of leaves) {
+        if (field.includes(".")) return void 0;
+        if (typeof leaf !== "string" && typeof leaf !== "number") return void 0;
+        entries.push([`parameter.${id}.${field}`, leaf]);
+      }
+    }
+  }
+  return Object.fromEntries(entries);
+}
+
 // src/to-experience-payload.ts
 function toExperiencePayload(response) {
   return response;
@@ -157,17 +178,36 @@ async function fetchExperience(experienceOptions, clientOptions, resolveOptions)
   return _experiencessdkcore.resolveExperience.call(void 0, payload, config, { metadata, debug });
 }
 async function fetchByExperienceId(client, options) {
-  const { spaceId, environmentId, experienceId, locale, personalization, extensions } = options;
+  const { spaceId, environmentId, experienceId, locale, parameters, personalization, extensions } = options;
   const requestExtensions = { ...extensions };
   if (personalization !== void 0) {
     requestExtensions.personalization = serializePersonalization(personalization);
   }
   try {
-    if (hasRequestExtensions(requestExtensions)) {
-      return await client.experience.getWithOverrides(spaceId, environmentId, experienceId, {
+    const queryParams = parameterQuery(parameters);
+    if (hasRequestExtensions(requestExtensions) || queryParams === void 0) {
+      const request = {
         locale,
-        extensions: requestExtensions
-      });
+        extensions: requestExtensions,
+        ...parameters === void 0 ? {} : { parameters }
+      };
+      return await client.experience.getWithOverrides(
+        spaceId,
+        environmentId,
+        experienceId,
+        request
+      );
+    }
+    if (Object.keys(queryParams).length > 0) {
+      return await client.experience.get(
+        spaceId,
+        environmentId,
+        experienceId,
+        { locale },
+        {
+          queryParams
+        }
+      );
     }
     return await client.experience.get(spaceId, environmentId, experienceId, { locale });
   } catch (err) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/experiences/experiences/packages/client/dist/index.cjs","../src/index.ts","../src/errors.ts","../src/create-delivery-client.ts","../src/fetch-experience.ts","../src/personalization.ts","../src/destination-guards.ts","../src/hosts.ts","../src/client-resolution.ts","../src/to-experience-payload.ts","../src/fetch-destination-sitemap.ts"],"names":["spaceId","createDebugLogger","ContentfulViewDelivery"],"mappings":"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","file":"/home/runner/work/experiences/experiences/packages/client/dist/index.cjs","sourcesContent":[null,"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';\nexport { serializePersonalization } from './personalization.js';\n","/**\n * Thrown by `fetchExperience` for a fetch failure that is not \"experience not\n * found\" — network failure, an invalid/expired token, a 5xx from the\n * delivery API, etc. This failure mode is \"surface clearly to the host app,\"\n * unlike the diagnostics `resolveExperience` collects for resolve/render-time\n * issues — there's no partial payload to render around a fetch that never\n * returned one, so a real thrown class is the right shape.\n *\n * `NotFoundError` (the delivery client's class, re-exported from this\n * package) is the one exception: it passes through undisturbed so callers\n * can route it to their framework's 404 idiom, per the existing\n * distinguishable-404 contract.\n *\n * `environmentId` is `undefined` for the destination-shaped `fetchExperience`\n * branches — the destinations delivery endpoints are space-scoped only, with\n * no environment segment, unlike the by-id path.\n */\nexport class ExperienceFetchError extends Error {\n  readonly spaceId: string;\n  readonly environmentId: string | undefined;\n  readonly experienceId: string;\n\n  constructor(\n    message: string,\n    options: {\n      spaceId: string;\n      environmentId?: string;\n      experienceId: string;\n      cause?: unknown;\n    }\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = 'ExperienceFetchError';\n    this.spaceId = options.spaceId;\n    this.environmentId = options.environmentId;\n    this.experienceId = options.experienceId;\n  }\n}\n\n/**\n * Thrown by `fetchExperience` and `fetchDestinationSitemap` when\n * `clientOptions.preview` is `true` for a destination-shaped call\n * (`destinationId` + `nodeId`/`path`, or a sitemap fetch). The Destinations\n * Delivery API has no preview host or preview-token support yet, so this\n * guards against silently hitting the production host with a preview token\n * it doesn't accept.\n *\n * This is a bridge, not a permanent design: revisit once the platform ships\n * preview support for destinations.\n *\n * Only fires for the inline-credentials branch of `ClientOptions`. A\n * caller-supplied `{ client }` already ignores `preview` entirely, per that\n * branch's existing contract.\n */\nexport class DestinationPreviewNotSupportedError extends Error {\n  readonly spaceId: string;\n  readonly destinationId: string;\n  readonly nodeId: string | undefined;\n  readonly path: string | undefined;\n\n  constructor(\n    message: string,\n    options: { spaceId: string; destinationId: string; nodeId?: string; path?: string }\n  ) {\n    super(message);\n    this.name = 'DestinationPreviewNotSupportedError';\n    this.spaceId = options.spaceId;\n    this.destinationId = options.destinationId;\n    this.nodeId = options.nodeId;\n    this.path = options.path;\n  }\n}\n","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","import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { serializePersonalization } from './personalization.js';\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 = { ...extensions };\n  if (personalization !== undefined) {\n    requestExtensions.personalization = serializePersonalization(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","import { GetWithOverridesExperienceRequestExtensionsPersonalization as personalizationSchema } from '@contentful/experience-delivery/serialization';\nimport type { PersonalizationOptions } from './fetch-experience.js';\n\n/** Validate and serialize events to the generated XDA request contract. */\nexport function serializePersonalization(personalization: unknown): PersonalizationOptions {\n  try {\n    // XDA rejects EventBuilder's context.gdpr with HTTP 422. Keep caller-built\n    // events intact and serialize to its generated schema, which omits consent.\n    return personalizationSchema.parseOrThrow(personalization, {\n      unrecognizedObjectKeys: 'strip',\n    });\n  } catch (cause) {\n    throw new TypeError('Invalid Experience personalization options', { cause });\n  }\n}\n","import { DestinationPreviewNotSupportedError } from './errors.js';\n\n/**\n * Throws `DestinationPreviewNotSupportedError` when `clientOptions.preview` is\n * `true` and `experienceOptions` is destination-shaped (a caller-supplied\n * `{ client }` already ignores `preview` entirely, so this only fires for the\n * inline-credentials branch). Shared by `fetchExperience` and\n * `fetchDestinationSitemap` — both call into the same preview-less\n * Destinations Delivery API.\n */\nexport function assertDestinationPreviewSupported(\n  isPreview: boolean | undefined,\n  destination: { spaceId: string; destinationId: string; nodeId?: string; path?: string }\n): void {\n  if (!isPreview) return;\n\n  const { spaceId, destinationId, nodeId, path } = destination;\n  const locator = nodeId !== undefined ? `nodeId \"${nodeId}\"` : `path \"${path}\"`;\n  throw new DestinationPreviewNotSupportedError(\n    `preview: true was combined with a destination-shaped call (destinationId ` +\n      `\"${destinationId}\", ${locator}). The Destinations Delivery API does not support ` +\n      `preview mode yet — pass preview: false (or omit it) for destination-based fetches.`,\n    { spaceId, destinationId, nodeId, path }\n  );\n}\n","export const DELIVERY_HOST = 'https://xdn.contentful.com';\nexport const PREVIEW_HOST = 'https://preview.xdn.contentful.com';\nexport const PREVIEW_WEBSOCKET_HOST = 'wss://preview.xdn.contentful.com';\n","import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { createClient } from './create-delivery-client.js';\nimport { createDebugLogger } from '@contentful/experiences-sdk-core';\nimport { PREVIEW_HOST } from './hosts.js';\n\nexport type ClientOptions =\n  | {\n      accessToken: string;\n      /**\n       * Preview access token. Required when calling with `preview: true`.\n       */\n      previewToken?: string;\n      /**\n       * Flip between delivery (default) and preview at request time. When\n       * `true`, uses `previewToken` and the preview host; when `false` or\n       * unset, uses `accessToken` and the delivery host. Ignored when a\n       * pre-made `client` is passed instead of inline creds.\n       */\n      preview?: boolean;\n      /**\n       * Custom base URL for the delivery client (staging, proxy, per-region).\n       * Wins over the `preview`-derived default host — combine `host` with\n       * `preview: true` to point preview mode at a non-prod endpoint.\n       * Omit for the standard delivery / preview hosts.\n       */\n      host?: string;\n    }\n  | { client: ContentfulViewDeliveryClient };\n\n/**\n * Resolve a `ClientOptions` union into a real delivery client. Shared by\n * `fetchExperience` and `fetchDestinationSitemap` — both accept the same\n * inline-creds-or-pre-made-client shape.\n */\nexport function resolveDeliveryClient(\n  clientOptions: ClientOptions,\n  log: ReturnType<typeof createDebugLogger>,\n  callerName: string\n): ContentfulViewDeliveryClient {\n  if ('client' in clientOptions) {\n    log.log('using caller-supplied delivery client');\n    return clientOptions.client;\n  }\n\n  const { accessToken, previewToken, preview, host } = clientOptions;\n  if (preview && !previewToken) {\n    throw new Error(`${callerName}() called with preview: true but no previewToken was provided`);\n  }\n  const resolvedHost = host ?? (preview ? PREVIEW_HOST : undefined);\n  const client = createClient({\n    accessToken: preview ? (previewToken as string) : accessToken,\n    host: resolvedHost,\n  });\n  log.log('created delivery client', { preview: Boolean(preview), host: resolvedHost });\n  return client;\n}\n","/*\n * Typed narrowing from a delivery-client response to the payload shape the\n * renderer consumes.\n */\n\nimport type { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport type { ExperiencePayload, ExperienceSourceMap } from '@contentful/experiences-sdk-core';\n\n/** Either shape the experience endpoint can return — `get()` and `getWithOverrides()` share it. */\nexport type ExperienceResponse =\n  | ContentfulViewDelivery.GetExperienceResponse\n  | ContentfulViewDelivery.GetWithOverridesExperienceResponse;\n\n/**\n * Narrow a delivery response to `ExperiencePayload`.\n *\n * The endpoint types its response as `HydratedView | HydratedExperienceView`.\n * The alpha-feature header the delivery client always sends guarantees the\n * latter, but TypeScript cannot know that, so callers were left casting by hand.\n *\n * `fetchExperience` uses this internally; it is exported for anyone driving the\n * delivery client directly. Type-level only — no validation, no copying.\n *\n * A legacy-shaped response carries `componentType` / `template` links instead;\n * `resolveExperience` reports those through `warnUnrenderableNode`.\n */\nexport function toExperiencePayload(response: ExperienceResponse): ExperiencePayload {\n  return response as ContentfulViewDelivery.HydratedExperienceView as ExperiencePayload;\n}\n\n/** Read `extensions.sourceMap` off a response. `undefined` when the request did not opt in. */\nexport function readSourceMap(response: ExperienceResponse): ExperienceSourceMap | undefined {\n  const extensions = (response as ContentfulViewDelivery.HydratedExperienceView).extensions;\n  return extensions?.sourceMap as ExperienceSourceMap | undefined;\n}\n\n/**\n * Narrow a `ResolvedDestinationExperience.experience` to `ExperiencePayload`.\n *\n * Same cast rationale as `toExperiencePayload` above, for the destination\n * resolution endpoints' `HydratedExperience` shape instead of the by-id\n * endpoints' `HydratedExperienceView`.\n */\nexport function toExperiencePayloadFromDestination(\n  experience: ContentfulViewDelivery.HydratedExperience\n): ExperiencePayload {\n  return experience as unknown as ExperiencePayload;\n}\n","import { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { createDebugLogger } from '@contentful/experiences-sdk-core';\nimport { assertDestinationPreviewSupported } from './destination-guards.js';\nimport { resolveDeliveryClient, type ClientOptions } from './client-resolution.js';\nimport { ExperienceFetchError } from './errors.js';\n\nexport type FetchDestinationSitemapOptions = {\n  spaceId: string;\n  destinationId: string;\n};\n\nexport type FetchDestinationSitemapPaginationOptions = {\n  /** Maximum number of paths to return. Defaults to `100`, maximum `1000`. */\n  limit?: number;\n  /** Cursor from a previous call's `pages.next`. Treat as opaque; don't combine with `pagePrev`. */\n  pageNext?: string;\n  /** Cursor from a previous call's `pages.prev`. Treat as opaque; don't combine with `pageNext`. */\n  pagePrev?: string;\n};\n\nexport type SitemapPathItem = {\n  /** Path this entry routes. */\n  path: string;\n  /** Flat id extracted from the entry's `experienceUrn`. */\n  experienceId: string;\n  /** Type of the Destination Node that claims this path, e.g. `\"DestinationExperienceNode\"`. */\n  type: string;\n};\n\nexport type DestinationSitemapResult = {\n  items: SitemapPathItem[];\n  limit: number;\n  pages: { next?: string; prev?: string };\n};\n\n/**\n * List every routable path in a published Destination. Bulk enumeration —\n * pairs with `fetchExperience`'s `destinationId` + `nodeId`/`path` branches,\n * which resolve one path at a time. Does not hydrate any Experience itself\n * and does not call `fetchExperience` internally.\n */\nexport async function fetchDestinationSitemap(\n  destinationOptions: FetchDestinationSitemapOptions,\n  clientOptions: ClientOptions,\n  paginationOptions: FetchDestinationSitemapPaginationOptions = {}\n): Promise<DestinationSitemapResult> {\n  const { spaceId, destinationId } = destinationOptions;\n  const log = createDebugLogger(false, 'client');\n\n  if (!('client' in clientOptions)) {\n    assertDestinationPreviewSupported(clientOptions.preview, { spaceId, destinationId });\n  }\n\n  const client = resolveDeliveryClient(clientOptions, log, 'fetchDestinationSitemap');\n\n  const { limit, pageNext, pagePrev } = paginationOptions;\n\n  let response: ContentfulViewDelivery.DestinationSitemap;\n  try {\n    response = await client.destination.sitemap(spaceId, destinationId, {\n      limit,\n      pageNext,\n      pagePrev,\n    });\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 fetch sitemap for Destination \"${destinationId}\" (space \"${spaceId}\"): ` +\n        `${reason}. Check network connectivity, the access token, and that the space/` +\n        `destination ids are correct.`,\n      { spaceId, experienceId: destinationId, cause: err }\n    );\n  }\n\n  const result = {\n    items: response.paths.items.map((item) => ({\n      path: item.path,\n      experienceId: extractIdFromUrn(item.experienceUrn),\n      type: item.sys.type,\n    })),\n    limit: response.paths.limit,\n    pages: response.paths.pages,\n  };\n\n  log.lazy('received sitemap page', () => result);\n\n  return result;\n}\n\n/**\n * Extract the flat id from an `experienceUrn`. Real shape:\n *   crn:contentful:::experience:spaces/$self/environments/$self/experiences/<id>\n *\n * Same one-line logic as the private `extractIdFromUrn` in\n * `packages/core/src/resolve-experience.ts` — not shared across the\n * `core`/`client` package boundary (core stays zero-dep) for one line.\n */\nfunction extractIdFromUrn(urn: string): string {\n  const segments = urn.split('/').filter((s) => s.length > 0);\n  return segments[segments.length - 1] ?? urn;\n}\n"]}
+{"version":3,"sources":["/home/runner/work/experiences/experiences/packages/client/dist/index.cjs","../src/index.ts","../src/errors.ts","../src/create-delivery-client.ts","../src/fetch-experience.ts","../src/personalization.ts","../src/destination-guards.ts","../src/hosts.ts","../src/client-resolution.ts","../src/experience-parameters.ts","../src/to-experience-payload.ts","../src/fetch-destination-sitemap.ts"],"names":["spaceId","createDebugLogger","ContentfulViewDelivery"],"mappings":"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","file":"/home/runner/work/experiences/experiences/packages/client/dist/index.cjs","sourcesContent":[null,"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';\nexport type {\n  ExperienceParameters,\n  ExperienceParameterValue,\n  ExperienceParameterRecord,\n  ExperienceParameterOrder,\n} from './experience-parameters.js';\nexport { serializePersonalization } from './personalization.js';\n","/**\n * Thrown by `fetchExperience` for a fetch failure that is not \"experience not\n * found\" — network failure, an invalid/expired token, a 5xx from the\n * delivery API, etc. This failure mode is \"surface clearly to the host app,\"\n * unlike the diagnostics `resolveExperience` collects for resolve/render-time\n * issues — there's no partial payload to render around a fetch that never\n * returned one, so a real thrown class is the right shape.\n *\n * `NotFoundError` (the delivery client's class, re-exported from this\n * package) is the one exception: it passes through undisturbed so callers\n * can route it to their framework's 404 idiom, per the existing\n * distinguishable-404 contract.\n *\n * `environmentId` is `undefined` for the destination-shaped `fetchExperience`\n * branches — the destinations delivery endpoints are space-scoped only, with\n * no environment segment, unlike the by-id path.\n */\nexport class ExperienceFetchError extends Error {\n  readonly spaceId: string;\n  readonly environmentId: string | undefined;\n  readonly experienceId: string;\n\n  constructor(\n    message: string,\n    options: {\n      spaceId: string;\n      environmentId?: string;\n      experienceId: string;\n      cause?: unknown;\n    }\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = 'ExperienceFetchError';\n    this.spaceId = options.spaceId;\n    this.environmentId = options.environmentId;\n    this.experienceId = options.experienceId;\n  }\n}\n\n/**\n * Thrown by `fetchExperience` and `fetchDestinationSitemap` when\n * `clientOptions.preview` is `true` for a destination-shaped call\n * (`destinationId` + `nodeId`/`path`, or a sitemap fetch). The Destinations\n * Delivery API has no preview host or preview-token support yet, so this\n * guards against silently hitting the production host with a preview token\n * it doesn't accept.\n *\n * This is a bridge, not a permanent design: revisit once the platform ships\n * preview support for destinations.\n *\n * Only fires for the inline-credentials branch of `ClientOptions`. A\n * caller-supplied `{ client }` already ignores `preview` entirely, per that\n * branch's existing contract.\n */\nexport class DestinationPreviewNotSupportedError extends Error {\n  readonly spaceId: string;\n  readonly destinationId: string;\n  readonly nodeId: string | undefined;\n  readonly path: string | undefined;\n\n  constructor(\n    message: string,\n    options: { spaceId: string; destinationId: string; nodeId?: string; path?: string }\n  ) {\n    super(message);\n    this.name = 'DestinationPreviewNotSupportedError';\n    this.spaceId = options.spaceId;\n    this.destinationId = options.destinationId;\n    this.nodeId = options.nodeId;\n    this.path = options.path;\n  }\n}\n","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","import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { serializePersonalization } from './personalization.js';\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 { parameterQuery, type ExperienceParameters } from './experience-parameters.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  /** Values for declared Experience parameters. Refetch with new values to swap content. */\n  parameters?: ExperienceParameters;\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, parameters, personalization, extensions } =\n    options;\n  const requestExtensions: DeliveryExperienceRequestExtensions = { ...extensions };\n  if (personalization !== undefined) {\n    requestExtensions.personalization = serializePersonalization(personalization);\n  }\n\n  try {\n    // GET uses namespaced query leaves. POST preserves values that cannot be\n    // represented by leaves and carries existing request extensions.\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    const queryParams = parameterQuery(parameters);\n    if (hasRequestExtensions(requestExtensions) || queryParams === undefined) {\n      // dev.10's POST serializer passes through extra body keys. Its generated\n      // request type omits parameters, so retain our typed extension locally.\n      // TODO: Remove this intersection once contentful-experience-delivery.js\n      // generates parameters on GetWithOverridesExperienceRequest and we upgrade.\n      const request: ContentfulViewDelivery.GetWithOverridesExperienceRequest & {\n        parameters?: ExperienceParameters;\n      } = {\n        locale,\n        extensions: requestExtensions,\n        ...(parameters === undefined ? {} : { parameters }),\n      };\n      return await client.experience.getWithOverrides(\n        spaceId,\n        environmentId,\n        experienceId,\n        request\n      );\n    }\n\n    if (Object.keys(queryParams).length > 0) {\n      return await client.experience.get(\n        spaceId,\n        environmentId,\n        experienceId,\n        { locale },\n        {\n          queryParams,\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","import { GetWithOverridesExperienceRequestExtensionsPersonalization as personalizationSchema } from '@contentful/experience-delivery/serialization';\nimport type { PersonalizationOptions } from './fetch-experience.js';\n\n/** Validate and serialize events to the generated XDA request contract. */\nexport function serializePersonalization(personalization: unknown): PersonalizationOptions {\n  try {\n    // XDA rejects EventBuilder's context.gdpr with HTTP 422. Keep caller-built\n    // events intact and serialize to its generated schema, which omits consent.\n    return personalizationSchema.parseOrThrow(personalization, {\n      unrecognizedObjectKeys: 'strip',\n    });\n  } catch (cause) {\n    throw new TypeError('Invalid Experience personalization options', { cause });\n  }\n}\n","import { DestinationPreviewNotSupportedError } from './errors.js';\n\n/**\n * Throws `DestinationPreviewNotSupportedError` when `clientOptions.preview` is\n * `true` and `experienceOptions` is destination-shaped (a caller-supplied\n * `{ client }` already ignores `preview` entirely, so this only fires for the\n * inline-credentials branch). Shared by `fetchExperience` and\n * `fetchDestinationSitemap` — both call into the same preview-less\n * Destinations Delivery API.\n */\nexport function assertDestinationPreviewSupported(\n  isPreview: boolean | undefined,\n  destination: { spaceId: string; destinationId: string; nodeId?: string; path?: string }\n): void {\n  if (!isPreview) return;\n\n  const { spaceId, destinationId, nodeId, path } = destination;\n  const locator = nodeId !== undefined ? `nodeId \"${nodeId}\"` : `path \"${path}\"`;\n  throw new DestinationPreviewNotSupportedError(\n    `preview: true was combined with a destination-shaped call (destinationId ` +\n      `\"${destinationId}\", ${locator}). The Destinations Delivery API does not support ` +\n      `preview mode yet — pass preview: false (or omit it) for destination-based fetches.`,\n    { spaceId, destinationId, nodeId, path }\n  );\n}\n","export const DELIVERY_HOST = 'https://xdn.contentful.com';\nexport const PREVIEW_HOST = 'https://preview.xdn.contentful.com';\nexport const PREVIEW_WEBSOCKET_HOST = 'wss://preview.xdn.contentful.com';\n","import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { createClient } from './create-delivery-client.js';\nimport { createDebugLogger } from '@contentful/experiences-sdk-core';\nimport { PREVIEW_HOST } from './hosts.js';\n\nexport type ClientOptions =\n  | {\n      accessToken: string;\n      /**\n       * Preview access token. Required when calling with `preview: true`.\n       */\n      previewToken?: string;\n      /**\n       * Flip between delivery (default) and preview at request time. When\n       * `true`, uses `previewToken` and the preview host; when `false` or\n       * unset, uses `accessToken` and the delivery host. Ignored when a\n       * pre-made `client` is passed instead of inline creds.\n       */\n      preview?: boolean;\n      /**\n       * Custom base URL for the delivery client (staging, proxy, per-region).\n       * Wins over the `preview`-derived default host — combine `host` with\n       * `preview: true` to point preview mode at a non-prod endpoint.\n       * Omit for the standard delivery / preview hosts.\n       */\n      host?: string;\n    }\n  | { client: ContentfulViewDeliveryClient };\n\n/**\n * Resolve a `ClientOptions` union into a real delivery client. Shared by\n * `fetchExperience` and `fetchDestinationSitemap` — both accept the same\n * inline-creds-or-pre-made-client shape.\n */\nexport function resolveDeliveryClient(\n  clientOptions: ClientOptions,\n  log: ReturnType<typeof createDebugLogger>,\n  callerName: string\n): ContentfulViewDeliveryClient {\n  if ('client' in clientOptions) {\n    log.log('using caller-supplied delivery client');\n    return clientOptions.client;\n  }\n\n  const { accessToken, previewToken, preview, host } = clientOptions;\n  if (preview && !previewToken) {\n    throw new Error(`${callerName}() called with preview: true but no previewToken was provided`);\n  }\n  const resolvedHost = host ?? (preview ? PREVIEW_HOST : undefined);\n  const client = createClient({\n    accessToken: preview ? (previewToken as string) : accessToken,\n    host: resolvedHost,\n  });\n  log.log('created delivery client', { preview: Boolean(preview), host: resolvedHost });\n  return client;\n}\n","/** One collection order path; `-` selects descending order. Delivery validates the path. */\nexport type ExperienceParameterOrder =\n  `fields.${string}` | `sys.${string}` | `-fields.${string}` | `-sys.${string}`;\n\n/** Runtime values for one Record parameter. Nested records and arrays are not supported. */\nexport type ExperienceParameterRecord = Record<string, string | number>;\n\nexport type ExperienceParameterValue = string | number | ExperienceParameterRecord;\n\n/** Unprefixed IDs declared in Experience.parameters and referenced as `$parameters/<id>`. */\nexport type ExperienceParameters = Record<string, ExperienceParameterValue>;\n\n/**\n * Flatten values for the generated client's GET queryParams escape hatch.\n * An empty Record cannot be represented by query leaves: preserve it via POST.\n * Delivery owns name, requiredness, fallback and value validation.\n */\nexport function parameterQuery(\n  parameters: ExperienceParameters | undefined\n): Record<string, string | number> | undefined {\n  const entries: [string, string | number][] = [];\n  for (const [id, value] of Object.entries(parameters ?? {})) {\n    // A dotted ID could masquerade as another parameter's Record leaf on GET.\n    // Preserve the original name on POST and let delivery validate it.\n    if (id.includes('.')) return undefined;\n    if (typeof value === 'string' || typeof value === 'number') {\n      entries.push([`parameter.${id}`, value]);\n    } else {\n      // Untyped callers can supply other JSON shapes. Use POST so delivery\n      // sees their original value rather than a lossy query string coercion.\n      if (value === null || typeof value !== 'object' || Array.isArray(value)) return undefined;\n      const leaves = Object.entries(value);\n      if (leaves.length === 0) return undefined;\n      for (const [field, leaf] of leaves) {\n        if (field.includes('.')) return undefined;\n        if (typeof leaf !== 'string' && typeof leaf !== 'number') return undefined;\n        entries.push([`parameter.${id}.${field}`, leaf]);\n      }\n    }\n  }\n  return Object.fromEntries(entries);\n}\n","/*\n * Typed narrowing from a delivery-client response to the payload shape the\n * renderer consumes.\n */\n\nimport type { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport type { ExperiencePayload, ExperienceSourceMap } from '@contentful/experiences-sdk-core';\n\n/** Either shape the experience endpoint can return — `get()` and `getWithOverrides()` share it. */\nexport type ExperienceResponse =\n  | ContentfulViewDelivery.GetExperienceResponse\n  | ContentfulViewDelivery.GetWithOverridesExperienceResponse;\n\n/**\n * Narrow a delivery response to `ExperiencePayload`.\n *\n * The endpoint types its response as `HydratedView | HydratedExperienceView`.\n * The alpha-feature header the delivery client always sends guarantees the\n * latter, but TypeScript cannot know that, so callers were left casting by hand.\n *\n * `fetchExperience` uses this internally; it is exported for anyone driving the\n * delivery client directly. Type-level only — no validation, no copying.\n *\n * A legacy-shaped response carries `componentType` / `template` links instead;\n * `resolveExperience` reports those through `warnUnrenderableNode`.\n */\nexport function toExperiencePayload(response: ExperienceResponse): ExperiencePayload {\n  return response as ContentfulViewDelivery.HydratedExperienceView as ExperiencePayload;\n}\n\n/** Read `extensions.sourceMap` off a response. `undefined` when the request did not opt in. */\nexport function readSourceMap(response: ExperienceResponse): ExperienceSourceMap | undefined {\n  const extensions = (response as ContentfulViewDelivery.HydratedExperienceView).extensions;\n  return extensions?.sourceMap as ExperienceSourceMap | undefined;\n}\n\n/**\n * Narrow a `ResolvedDestinationExperience.experience` to `ExperiencePayload`.\n *\n * Same cast rationale as `toExperiencePayload` above, for the destination\n * resolution endpoints' `HydratedExperience` shape instead of the by-id\n * endpoints' `HydratedExperienceView`.\n */\nexport function toExperiencePayloadFromDestination(\n  experience: ContentfulViewDelivery.HydratedExperience\n): ExperiencePayload {\n  return experience as unknown as ExperiencePayload;\n}\n","import { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { createDebugLogger } from '@contentful/experiences-sdk-core';\nimport { assertDestinationPreviewSupported } from './destination-guards.js';\nimport { resolveDeliveryClient, type ClientOptions } from './client-resolution.js';\nimport { ExperienceFetchError } from './errors.js';\n\nexport type FetchDestinationSitemapOptions = {\n  spaceId: string;\n  destinationId: string;\n};\n\nexport type FetchDestinationSitemapPaginationOptions = {\n  /** Maximum number of paths to return. Defaults to `100`, maximum `1000`. */\n  limit?: number;\n  /** Cursor from a previous call's `pages.next`. Treat as opaque; don't combine with `pagePrev`. */\n  pageNext?: string;\n  /** Cursor from a previous call's `pages.prev`. Treat as opaque; don't combine with `pageNext`. */\n  pagePrev?: string;\n};\n\nexport type SitemapPathItem = {\n  /** Path this entry routes. */\n  path: string;\n  /** Flat id extracted from the entry's `experienceUrn`. */\n  experienceId: string;\n  /** Type of the Destination Node that claims this path, e.g. `\"DestinationExperienceNode\"`. */\n  type: string;\n};\n\nexport type DestinationSitemapResult = {\n  items: SitemapPathItem[];\n  limit: number;\n  pages: { next?: string; prev?: string };\n};\n\n/**\n * List every routable path in a published Destination. Bulk enumeration —\n * pairs with `fetchExperience`'s `destinationId` + `nodeId`/`path` branches,\n * which resolve one path at a time. Does not hydrate any Experience itself\n * and does not call `fetchExperience` internally.\n */\nexport async function fetchDestinationSitemap(\n  destinationOptions: FetchDestinationSitemapOptions,\n  clientOptions: ClientOptions,\n  paginationOptions: FetchDestinationSitemapPaginationOptions = {}\n): Promise<DestinationSitemapResult> {\n  const { spaceId, destinationId } = destinationOptions;\n  const log = createDebugLogger(false, 'client');\n\n  if (!('client' in clientOptions)) {\n    assertDestinationPreviewSupported(clientOptions.preview, { spaceId, destinationId });\n  }\n\n  const client = resolveDeliveryClient(clientOptions, log, 'fetchDestinationSitemap');\n\n  const { limit, pageNext, pagePrev } = paginationOptions;\n\n  let response: ContentfulViewDelivery.DestinationSitemap;\n  try {\n    response = await client.destination.sitemap(spaceId, destinationId, {\n      limit,\n      pageNext,\n      pagePrev,\n    });\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 fetch sitemap for Destination \"${destinationId}\" (space \"${spaceId}\"): ` +\n        `${reason}. Check network connectivity, the access token, and that the space/` +\n        `destination ids are correct.`,\n      { spaceId, experienceId: destinationId, cause: err }\n    );\n  }\n\n  const result = {\n    items: response.paths.items.map((item) => ({\n      path: item.path,\n      experienceId: extractIdFromUrn(item.experienceUrn),\n      type: item.sys.type,\n    })),\n    limit: response.paths.limit,\n    pages: response.paths.pages,\n  };\n\n  log.lazy('received sitemap page', () => result);\n\n  return result;\n}\n\n/**\n * Extract the flat id from an `experienceUrn`. Real shape:\n *   crn:contentful:::experience:spaces/$self/environments/$self/experiences/<id>\n *\n * Same one-line logic as the private `extractIdFromUrn` in\n * `packages/core/src/resolve-experience.ts` — not shared across the\n * `core`/`client` package boundary (core stays zero-dep) for one line.\n */\nfunction extractIdFromUrn(urn: string): string {\n  const segments = urn.split('/').filter((s) => s.length > 0);\n  return segments[segments.length - 1] ?? urn;\n}\n"]}

package/dist/index.d.cts

@@ -94,6 +94,14 @@ type ClientOptions = {
     client: ContentfulViewDeliveryClient;
 };
 
+/** One collection order path; `-` selects descending order. Delivery validates the path. */
+type ExperienceParameterOrder = `fields.${string}` | `sys.${string}` | `-fields.${string}` | `-sys.${string}`;
+/** Runtime values for one Record parameter. Nested records and arrays are not supported. */
+type ExperienceParameterRecord = Record<string, string | number>;
+type ExperienceParameterValue = string | number | ExperienceParameterRecord;
+/** Unprefixed IDs declared in Experience.parameters and referenced as `$parameters/<id>`. */
+type ExperienceParameters = Record<string, ExperienceParameterValue>;
+
 type DeliveryExperienceRequestExtensions = ContentfulViewDelivery.GetWithOverridesExperienceRequestExtensions;
 type PersonalizationOptions = NonNullable<DeliveryExperienceRequestExtensions['personalization']>;
 type ExperienceRequestExtensions = Omit<DeliveryExperienceRequestExtensions, 'personalization'>;
@@ -102,6 +110,8 @@ type ByIdExperienceOptions = {
     environmentId: string;
     experienceId: string;
     locale?: string;
+    /** Values for declared Experience parameters. Refetch with new values to swap content. */
+    parameters?: ExperienceParameters;
     /**
      * Profile and events used by XDA to personalize the resolved Experience.
      */
@@ -238,4 +248,4 @@ declare function serializePersonalization(personalization: unknown): Personaliza
 declare const NotFoundError: typeof ContentfulViewDelivery.NotFoundError;
 type NotFoundError = InstanceType<typeof ContentfulViewDelivery.NotFoundError>;
 
-export { type ByDestinationNodeIdExperienceOptions, type ByDestinationPathExperienceOptions, type ByIdExperienceOptions, type ClientOptions, type CreateClientOptions, DELIVERY_HOST, DestinationPreviewNotSupportedError, type DestinationRedirectResult, type DestinationSitemapResult, ExperienceFetchError, type ExperienceOptions, type ExperienceRequestExtensions, type ExperienceResponse, type FetchDestinationSitemapOptions, type FetchDestinationSitemapPaginationOptions, NotFoundError, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST, type PersonalizationOptions, type ResolveOptions, type SitemapPathItem, createClient, fetchDestinationSitemap, fetchExperience, readSourceMap, serializePersonalization, toExperiencePayload, toExperiencePayloadFromDestination };
+export { type ByDestinationNodeIdExperienceOptions, type ByDestinationPathExperienceOptions, type ByIdExperienceOptions, type ClientOptions, type CreateClientOptions, DELIVERY_HOST, DestinationPreviewNotSupportedError, type DestinationRedirectResult, type DestinationSitemapResult, ExperienceFetchError, type ExperienceOptions, type ExperienceParameterOrder, type ExperienceParameterRecord, type ExperienceParameterValue, type ExperienceParameters, type ExperienceRequestExtensions, type ExperienceResponse, type FetchDestinationSitemapOptions, type FetchDestinationSitemapPaginationOptions, NotFoundError, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST, type PersonalizationOptions, type ResolveOptions, type SitemapPathItem, createClient, fetchDestinationSitemap, fetchExperience, readSourceMap, serializePersonalization, toExperiencePayload, toExperiencePayloadFromDestination };

package/dist/index.d.mts

@@ -94,6 +94,14 @@ type ClientOptions = {
     client: ContentfulViewDeliveryClient;
 };
 
+/** One collection order path; `-` selects descending order. Delivery validates the path. */
+type ExperienceParameterOrder = `fields.${string}` | `sys.${string}` | `-fields.${string}` | `-sys.${string}`;
+/** Runtime values for one Record parameter. Nested records and arrays are not supported. */
+type ExperienceParameterRecord = Record<string, string | number>;
+type ExperienceParameterValue = string | number | ExperienceParameterRecord;
+/** Unprefixed IDs declared in Experience.parameters and referenced as `$parameters/<id>`. */
+type ExperienceParameters = Record<string, ExperienceParameterValue>;
+
 type DeliveryExperienceRequestExtensions = ContentfulViewDelivery.GetWithOverridesExperienceRequestExtensions;
 type PersonalizationOptions = NonNullable<DeliveryExperienceRequestExtensions['personalization']>;
 type ExperienceRequestExtensions = Omit<DeliveryExperienceRequestExtensions, 'personalization'>;
@@ -102,6 +110,8 @@ type ByIdExperienceOptions = {
     environmentId: string;
     experienceId: string;
     locale?: string;
+    /** Values for declared Experience parameters. Refetch with new values to swap content. */
+    parameters?: ExperienceParameters;
     /**
      * Profile and events used by XDA to personalize the resolved Experience.
      */
@@ -238,4 +248,4 @@ declare function serializePersonalization(personalization: unknown): Personaliza
 declare const NotFoundError: typeof ContentfulViewDelivery.NotFoundError;
 type NotFoundError = InstanceType<typeof ContentfulViewDelivery.NotFoundError>;
 
-export { type ByDestinationNodeIdExperienceOptions, type ByDestinationPathExperienceOptions, type ByIdExperienceOptions, type ClientOptions, type CreateClientOptions, DELIVERY_HOST, DestinationPreviewNotSupportedError, type DestinationRedirectResult, type DestinationSitemapResult, ExperienceFetchError, type ExperienceOptions, type ExperienceRequestExtensions, type ExperienceResponse, type FetchDestinationSitemapOptions, type FetchDestinationSitemapPaginationOptions, NotFoundError, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST, type PersonalizationOptions, type ResolveOptions, type SitemapPathItem, createClient, fetchDestinationSitemap, fetchExperience, readSourceMap, serializePersonalization, toExperiencePayload, toExperiencePayloadFromDestination };
+export { type ByDestinationNodeIdExperienceOptions, type ByDestinationPathExperienceOptions, type ByIdExperienceOptions, type ClientOptions, type CreateClientOptions, DELIVERY_HOST, DestinationPreviewNotSupportedError, type DestinationRedirectResult, type DestinationSitemapResult, ExperienceFetchError, type ExperienceOptions, type ExperienceParameterOrder, type ExperienceParameterRecord, type ExperienceParameterValue, type ExperienceParameters, type ExperienceRequestExtensions, type ExperienceResponse, type FetchDestinationSitemapOptions, type FetchDestinationSitemapPaginationOptions, NotFoundError, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST, type PersonalizationOptions, type ResolveOptions, type SitemapPathItem, createClient, fetchDestinationSitemap, fetchExperience, readSourceMap, serializePersonalization, toExperiencePayload, toExperiencePayloadFromDestination };

package/dist/index.d.ts

@@ -94,6 +94,14 @@ type ClientOptions = {
     client: ContentfulViewDeliveryClient;
 };
 
+/** One collection order path; `-` selects descending order. Delivery validates the path. */
+type ExperienceParameterOrder = `fields.${string}` | `sys.${string}` | `-fields.${string}` | `-sys.${string}`;
+/** Runtime values for one Record parameter. Nested records and arrays are not supported. */
+type ExperienceParameterRecord = Record<string, string | number>;
+type ExperienceParameterValue = string | number | ExperienceParameterRecord;
+/** Unprefixed IDs declared in Experience.parameters and referenced as `$parameters/<id>`. */
+type ExperienceParameters = Record<string, ExperienceParameterValue>;
+
 type DeliveryExperienceRequestExtensions = ContentfulViewDelivery.GetWithOverridesExperienceRequestExtensions;
 type PersonalizationOptions = NonNullable<DeliveryExperienceRequestExtensions['personalization']>;
 type ExperienceRequestExtensions = Omit<DeliveryExperienceRequestExtensions, 'personalization'>;
@@ -102,6 +110,8 @@ type ByIdExperienceOptions = {
     environmentId: string;
     experienceId: string;
     locale?: string;
+    /** Values for declared Experience parameters. Refetch with new values to swap content. */
+    parameters?: ExperienceParameters;
     /**
      * Profile and events used by XDA to personalize the resolved Experience.
      */
@@ -238,4 +248,4 @@ declare function serializePersonalization(personalization: unknown): Personaliza
 declare const NotFoundError: typeof ContentfulViewDelivery.NotFoundError;
 type NotFoundError = InstanceType<typeof ContentfulViewDelivery.NotFoundError>;
 
-export { type ByDestinationNodeIdExperienceOptions, type ByDestinationPathExperienceOptions, type ByIdExperienceOptions, type ClientOptions, type CreateClientOptions, DELIVERY_HOST, DestinationPreviewNotSupportedError, type DestinationRedirectResult, type DestinationSitemapResult, ExperienceFetchError, type ExperienceOptions, type ExperienceRequestExtensions, type ExperienceResponse, type FetchDestinationSitemapOptions, type FetchDestinationSitemapPaginationOptions, NotFoundError, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST, type PersonalizationOptions, type ResolveOptions, type SitemapPathItem, createClient, fetchDestinationSitemap, fetchExperience, readSourceMap, serializePersonalization, toExperiencePayload, toExperiencePayloadFromDestination };
+export { type ByDestinationNodeIdExperienceOptions, type ByDestinationPathExperienceOptions, type ByIdExperienceOptions, type ClientOptions, type CreateClientOptions, DELIVERY_HOST, DestinationPreviewNotSupportedError, type DestinationRedirectResult, type DestinationSitemapResult, ExperienceFetchError, type ExperienceOptions, type ExperienceParameterOrder, type ExperienceParameterRecord, type ExperienceParameterValue, type ExperienceParameters, type ExperienceRequestExtensions, type ExperienceResponse, type FetchDestinationSitemapOptions, type FetchDestinationSitemapPaginationOptions, NotFoundError, PREVIEW_HOST, PREVIEW_WEBSOCKET_HOST, type PersonalizationOptions, type ResolveOptions, type SitemapPathItem, createClient, fetchDestinationSitemap, fetchExperience, readSourceMap, serializePersonalization, toExperiencePayload, toExperiencePayloadFromDestination };

package/dist/index.js

@@ -97,6 +97,27 @@ function resolveDeliveryClient(clientOptions, log, callerName) {
   return client;
 }
 
+// src/experience-parameters.ts
+function parameterQuery(parameters) {
+  const entries = [];
+  for (const [id, value] of Object.entries(parameters ?? {})) {
+    if (id.includes(".")) return void 0;
+    if (typeof value === "string" || typeof value === "number") {
+      entries.push([`parameter.${id}`, value]);
+    } else {
+      if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+      const leaves = Object.entries(value);
+      if (leaves.length === 0) return void 0;
+      for (const [field, leaf] of leaves) {
+        if (field.includes(".")) return void 0;
+        if (typeof leaf !== "string" && typeof leaf !== "number") return void 0;
+        entries.push([`parameter.${id}.${field}`, leaf]);
+      }
+    }
+  }
+  return Object.fromEntries(entries);
+}
+
 // src/to-experience-payload.ts
 function toExperiencePayload(response) {
   return response;
@@ -157,17 +178,36 @@ async function fetchExperience(experienceOptions, clientOptions, resolveOptions)
   return resolveExperience(payload, config, { metadata, debug });
 }
 async function fetchByExperienceId(client, options) {
-  const { spaceId, environmentId, experienceId, locale, personalization, extensions } = options;
+  const { spaceId, environmentId, experienceId, locale, parameters, personalization, extensions } = options;
   const requestExtensions = { ...extensions };
   if (personalization !== void 0) {
     requestExtensions.personalization = serializePersonalization(personalization);
   }
   try {
-    if (hasRequestExtensions(requestExtensions)) {
-      return await client.experience.getWithOverrides(spaceId, environmentId, experienceId, {
+    const queryParams = parameterQuery(parameters);
+    if (hasRequestExtensions(requestExtensions) || queryParams === void 0) {
+      const request = {
         locale,
-        extensions: requestExtensions
-      });
+        extensions: requestExtensions,
+        ...parameters === void 0 ? {} : { parameters }
+      };
+      return await client.experience.getWithOverrides(
+        spaceId,
+        environmentId,
+        experienceId,
+        request
+      );
+    }
+    if (Object.keys(queryParams).length > 0) {
+      return await client.experience.get(
+        spaceId,
+        environmentId,
+        experienceId,
+        { locale },
+        {
+          queryParams
+        }
+      );
     }
     return await client.experience.get(spaceId, environmentId, experienceId, { locale });
   } catch (err) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/create-delivery-client.ts","../src/fetch-experience.ts","../src/personalization.ts","../src/destination-guards.ts","../src/hosts.ts","../src/client-resolution.ts","../src/to-experience-payload.ts","../src/fetch-destination-sitemap.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';\nexport { serializePersonalization } from './personalization.js';\n","/**\n * Thrown by `fetchExperience` for a fetch failure that is not \"experience not\n * found\" — network failure, an invalid/expired token, a 5xx from the\n * delivery API, etc. This failure mode is \"surface clearly to the host app,\"\n * unlike the diagnostics `resolveExperience` collects for resolve/render-time\n * issues — there's no partial payload to render around a fetch that never\n * returned one, so a real thrown class is the right shape.\n *\n * `NotFoundError` (the delivery client's class, re-exported from this\n * package) is the one exception: it passes through undisturbed so callers\n * can route it to their framework's 404 idiom, per the existing\n * distinguishable-404 contract.\n *\n * `environmentId` is `undefined` for the destination-shaped `fetchExperience`\n * branches — the destinations delivery endpoints are space-scoped only, with\n * no environment segment, unlike the by-id path.\n */\nexport class ExperienceFetchError extends Error {\n  readonly spaceId: string;\n  readonly environmentId: string | undefined;\n  readonly experienceId: string;\n\n  constructor(\n    message: string,\n    options: {\n      spaceId: string;\n      environmentId?: string;\n      experienceId: string;\n      cause?: unknown;\n    }\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = 'ExperienceFetchError';\n    this.spaceId = options.spaceId;\n    this.environmentId = options.environmentId;\n    this.experienceId = options.experienceId;\n  }\n}\n\n/**\n * Thrown by `fetchExperience` and `fetchDestinationSitemap` when\n * `clientOptions.preview` is `true` for a destination-shaped call\n * (`destinationId` + `nodeId`/`path`, or a sitemap fetch). The Destinations\n * Delivery API has no preview host or preview-token support yet, so this\n * guards against silently hitting the production host with a preview token\n * it doesn't accept.\n *\n * This is a bridge, not a permanent design: revisit once the platform ships\n * preview support for destinations.\n *\n * Only fires for the inline-credentials branch of `ClientOptions`. A\n * caller-supplied `{ client }` already ignores `preview` entirely, per that\n * branch's existing contract.\n */\nexport class DestinationPreviewNotSupportedError extends Error {\n  readonly spaceId: string;\n  readonly destinationId: string;\n  readonly nodeId: string | undefined;\n  readonly path: string | undefined;\n\n  constructor(\n    message: string,\n    options: { spaceId: string; destinationId: string; nodeId?: string; path?: string }\n  ) {\n    super(message);\n    this.name = 'DestinationPreviewNotSupportedError';\n    this.spaceId = options.spaceId;\n    this.destinationId = options.destinationId;\n    this.nodeId = options.nodeId;\n    this.path = options.path;\n  }\n}\n","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","import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { serializePersonalization } from './personalization.js';\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 = { ...extensions };\n  if (personalization !== undefined) {\n    requestExtensions.personalization = serializePersonalization(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","import { GetWithOverridesExperienceRequestExtensionsPersonalization as personalizationSchema } from '@contentful/experience-delivery/serialization';\nimport type { PersonalizationOptions } from './fetch-experience.js';\n\n/** Validate and serialize events to the generated XDA request contract. */\nexport function serializePersonalization(personalization: unknown): PersonalizationOptions {\n  try {\n    // XDA rejects EventBuilder's context.gdpr with HTTP 422. Keep caller-built\n    // events intact and serialize to its generated schema, which omits consent.\n    return personalizationSchema.parseOrThrow(personalization, {\n      unrecognizedObjectKeys: 'strip',\n    });\n  } catch (cause) {\n    throw new TypeError('Invalid Experience personalization options', { cause });\n  }\n}\n","import { DestinationPreviewNotSupportedError } from './errors.js';\n\n/**\n * Throws `DestinationPreviewNotSupportedError` when `clientOptions.preview` is\n * `true` and `experienceOptions` is destination-shaped (a caller-supplied\n * `{ client }` already ignores `preview` entirely, so this only fires for the\n * inline-credentials branch). Shared by `fetchExperience` and\n * `fetchDestinationSitemap` — both call into the same preview-less\n * Destinations Delivery API.\n */\nexport function assertDestinationPreviewSupported(\n  isPreview: boolean | undefined,\n  destination: { spaceId: string; destinationId: string; nodeId?: string; path?: string }\n): void {\n  if (!isPreview) return;\n\n  const { spaceId, destinationId, nodeId, path } = destination;\n  const locator = nodeId !== undefined ? `nodeId \"${nodeId}\"` : `path \"${path}\"`;\n  throw new DestinationPreviewNotSupportedError(\n    `preview: true was combined with a destination-shaped call (destinationId ` +\n      `\"${destinationId}\", ${locator}). The Destinations Delivery API does not support ` +\n      `preview mode yet — pass preview: false (or omit it) for destination-based fetches.`,\n    { spaceId, destinationId, nodeId, path }\n  );\n}\n","export const DELIVERY_HOST = 'https://xdn.contentful.com';\nexport const PREVIEW_HOST = 'https://preview.xdn.contentful.com';\nexport const PREVIEW_WEBSOCKET_HOST = 'wss://preview.xdn.contentful.com';\n","import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { createClient } from './create-delivery-client.js';\nimport { createDebugLogger } from '@contentful/experiences-sdk-core';\nimport { PREVIEW_HOST } from './hosts.js';\n\nexport type ClientOptions =\n  | {\n      accessToken: string;\n      /**\n       * Preview access token. Required when calling with `preview: true`.\n       */\n      previewToken?: string;\n      /**\n       * Flip between delivery (default) and preview at request time. When\n       * `true`, uses `previewToken` and the preview host; when `false` or\n       * unset, uses `accessToken` and the delivery host. Ignored when a\n       * pre-made `client` is passed instead of inline creds.\n       */\n      preview?: boolean;\n      /**\n       * Custom base URL for the delivery client (staging, proxy, per-region).\n       * Wins over the `preview`-derived default host — combine `host` with\n       * `preview: true` to point preview mode at a non-prod endpoint.\n       * Omit for the standard delivery / preview hosts.\n       */\n      host?: string;\n    }\n  | { client: ContentfulViewDeliveryClient };\n\n/**\n * Resolve a `ClientOptions` union into a real delivery client. Shared by\n * `fetchExperience` and `fetchDestinationSitemap` — both accept the same\n * inline-creds-or-pre-made-client shape.\n */\nexport function resolveDeliveryClient(\n  clientOptions: ClientOptions,\n  log: ReturnType<typeof createDebugLogger>,\n  callerName: string\n): ContentfulViewDeliveryClient {\n  if ('client' in clientOptions) {\n    log.log('using caller-supplied delivery client');\n    return clientOptions.client;\n  }\n\n  const { accessToken, previewToken, preview, host } = clientOptions;\n  if (preview && !previewToken) {\n    throw new Error(`${callerName}() called with preview: true but no previewToken was provided`);\n  }\n  const resolvedHost = host ?? (preview ? PREVIEW_HOST : undefined);\n  const client = createClient({\n    accessToken: preview ? (previewToken as string) : accessToken,\n    host: resolvedHost,\n  });\n  log.log('created delivery client', { preview: Boolean(preview), host: resolvedHost });\n  return client;\n}\n","/*\n * Typed narrowing from a delivery-client response to the payload shape the\n * renderer consumes.\n */\n\nimport type { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport type { ExperiencePayload, ExperienceSourceMap } from '@contentful/experiences-sdk-core';\n\n/** Either shape the experience endpoint can return — `get()` and `getWithOverrides()` share it. */\nexport type ExperienceResponse =\n  | ContentfulViewDelivery.GetExperienceResponse\n  | ContentfulViewDelivery.GetWithOverridesExperienceResponse;\n\n/**\n * Narrow a delivery response to `ExperiencePayload`.\n *\n * The endpoint types its response as `HydratedView | HydratedExperienceView`.\n * The alpha-feature header the delivery client always sends guarantees the\n * latter, but TypeScript cannot know that, so callers were left casting by hand.\n *\n * `fetchExperience` uses this internally; it is exported for anyone driving the\n * delivery client directly. Type-level only — no validation, no copying.\n *\n * A legacy-shaped response carries `componentType` / `template` links instead;\n * `resolveExperience` reports those through `warnUnrenderableNode`.\n */\nexport function toExperiencePayload(response: ExperienceResponse): ExperiencePayload {\n  return response as ContentfulViewDelivery.HydratedExperienceView as ExperiencePayload;\n}\n\n/** Read `extensions.sourceMap` off a response. `undefined` when the request did not opt in. */\nexport function readSourceMap(response: ExperienceResponse): ExperienceSourceMap | undefined {\n  const extensions = (response as ContentfulViewDelivery.HydratedExperienceView).extensions;\n  return extensions?.sourceMap as ExperienceSourceMap | undefined;\n}\n\n/**\n * Narrow a `ResolvedDestinationExperience.experience` to `ExperiencePayload`.\n *\n * Same cast rationale as `toExperiencePayload` above, for the destination\n * resolution endpoints' `HydratedExperience` shape instead of the by-id\n * endpoints' `HydratedExperienceView`.\n */\nexport function toExperiencePayloadFromDestination(\n  experience: ContentfulViewDelivery.HydratedExperience\n): ExperiencePayload {\n  return experience as unknown as ExperiencePayload;\n}\n","import { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { createDebugLogger } from '@contentful/experiences-sdk-core';\nimport { assertDestinationPreviewSupported } from './destination-guards.js';\nimport { resolveDeliveryClient, type ClientOptions } from './client-resolution.js';\nimport { ExperienceFetchError } from './errors.js';\n\nexport type FetchDestinationSitemapOptions = {\n  spaceId: string;\n  destinationId: string;\n};\n\nexport type FetchDestinationSitemapPaginationOptions = {\n  /** Maximum number of paths to return. Defaults to `100`, maximum `1000`. */\n  limit?: number;\n  /** Cursor from a previous call's `pages.next`. Treat as opaque; don't combine with `pagePrev`. */\n  pageNext?: string;\n  /** Cursor from a previous call's `pages.prev`. Treat as opaque; don't combine with `pageNext`. */\n  pagePrev?: string;\n};\n\nexport type SitemapPathItem = {\n  /** Path this entry routes. */\n  path: string;\n  /** Flat id extracted from the entry's `experienceUrn`. */\n  experienceId: string;\n  /** Type of the Destination Node that claims this path, e.g. `\"DestinationExperienceNode\"`. */\n  type: string;\n};\n\nexport type DestinationSitemapResult = {\n  items: SitemapPathItem[];\n  limit: number;\n  pages: { next?: string; prev?: string };\n};\n\n/**\n * List every routable path in a published Destination. Bulk enumeration —\n * pairs with `fetchExperience`'s `destinationId` + `nodeId`/`path` branches,\n * which resolve one path at a time. Does not hydrate any Experience itself\n * and does not call `fetchExperience` internally.\n */\nexport async function fetchDestinationSitemap(\n  destinationOptions: FetchDestinationSitemapOptions,\n  clientOptions: ClientOptions,\n  paginationOptions: FetchDestinationSitemapPaginationOptions = {}\n): Promise<DestinationSitemapResult> {\n  const { spaceId, destinationId } = destinationOptions;\n  const log = createDebugLogger(false, 'client');\n\n  if (!('client' in clientOptions)) {\n    assertDestinationPreviewSupported(clientOptions.preview, { spaceId, destinationId });\n  }\n\n  const client = resolveDeliveryClient(clientOptions, log, 'fetchDestinationSitemap');\n\n  const { limit, pageNext, pagePrev } = paginationOptions;\n\n  let response: ContentfulViewDelivery.DestinationSitemap;\n  try {\n    response = await client.destination.sitemap(spaceId, destinationId, {\n      limit,\n      pageNext,\n      pagePrev,\n    });\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 fetch sitemap for Destination \"${destinationId}\" (space \"${spaceId}\"): ` +\n        `${reason}. Check network connectivity, the access token, and that the space/` +\n        `destination ids are correct.`,\n      { spaceId, experienceId: destinationId, cause: err }\n    );\n  }\n\n  const result = {\n    items: response.paths.items.map((item) => ({\n      path: item.path,\n      experienceId: extractIdFromUrn(item.experienceUrn),\n      type: item.sys.type,\n    })),\n    limit: response.paths.limit,\n    pages: response.paths.pages,\n  };\n\n  log.lazy('received sitemap page', () => result);\n\n  return result;\n}\n\n/**\n * Extract the flat id from an `experienceUrn`. Real shape:\n *   crn:contentful:::experience:spaces/$self/environments/$self/experiences/<id>\n *\n * Same one-line logic as the private `extractIdFromUrn` in\n * `packages/core/src/resolve-experience.ts` — not shared across the\n * `core`/`client` package boundary (core stays zero-dep) for one line.\n */\nfunction extractIdFromUrn(urn: string): string {\n  const segments = urn.split('/').filter((s) => s.length > 0);\n  return segments[segments.length - 1] ?? urn;\n}\n"],"mappings":"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","names":["ContentfulViewDelivery","ContentfulViewDeliveryClient","spaceId","ContentfulViewDelivery","createDebugLogger","createDebugLogger","ContentfulViewDelivery","ContentfulViewDelivery"]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/create-delivery-client.ts","../src/fetch-experience.ts","../src/personalization.ts","../src/destination-guards.ts","../src/hosts.ts","../src/client-resolution.ts","../src/experience-parameters.ts","../src/to-experience-payload.ts","../src/fetch-destination-sitemap.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';\nexport type {\n  ExperienceParameters,\n  ExperienceParameterValue,\n  ExperienceParameterRecord,\n  ExperienceParameterOrder,\n} from './experience-parameters.js';\nexport { serializePersonalization } from './personalization.js';\n","/**\n * Thrown by `fetchExperience` for a fetch failure that is not \"experience not\n * found\" — network failure, an invalid/expired token, a 5xx from the\n * delivery API, etc. This failure mode is \"surface clearly to the host app,\"\n * unlike the diagnostics `resolveExperience` collects for resolve/render-time\n * issues — there's no partial payload to render around a fetch that never\n * returned one, so a real thrown class is the right shape.\n *\n * `NotFoundError` (the delivery client's class, re-exported from this\n * package) is the one exception: it passes through undisturbed so callers\n * can route it to their framework's 404 idiom, per the existing\n * distinguishable-404 contract.\n *\n * `environmentId` is `undefined` for the destination-shaped `fetchExperience`\n * branches — the destinations delivery endpoints are space-scoped only, with\n * no environment segment, unlike the by-id path.\n */\nexport class ExperienceFetchError extends Error {\n  readonly spaceId: string;\n  readonly environmentId: string | undefined;\n  readonly experienceId: string;\n\n  constructor(\n    message: string,\n    options: {\n      spaceId: string;\n      environmentId?: string;\n      experienceId: string;\n      cause?: unknown;\n    }\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = 'ExperienceFetchError';\n    this.spaceId = options.spaceId;\n    this.environmentId = options.environmentId;\n    this.experienceId = options.experienceId;\n  }\n}\n\n/**\n * Thrown by `fetchExperience` and `fetchDestinationSitemap` when\n * `clientOptions.preview` is `true` for a destination-shaped call\n * (`destinationId` + `nodeId`/`path`, or a sitemap fetch). The Destinations\n * Delivery API has no preview host or preview-token support yet, so this\n * guards against silently hitting the production host with a preview token\n * it doesn't accept.\n *\n * This is a bridge, not a permanent design: revisit once the platform ships\n * preview support for destinations.\n *\n * Only fires for the inline-credentials branch of `ClientOptions`. A\n * caller-supplied `{ client }` already ignores `preview` entirely, per that\n * branch's existing contract.\n */\nexport class DestinationPreviewNotSupportedError extends Error {\n  readonly spaceId: string;\n  readonly destinationId: string;\n  readonly nodeId: string | undefined;\n  readonly path: string | undefined;\n\n  constructor(\n    message: string,\n    options: { spaceId: string; destinationId: string; nodeId?: string; path?: string }\n  ) {\n    super(message);\n    this.name = 'DestinationPreviewNotSupportedError';\n    this.spaceId = options.spaceId;\n    this.destinationId = options.destinationId;\n    this.nodeId = options.nodeId;\n    this.path = options.path;\n  }\n}\n","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","import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { serializePersonalization } from './personalization.js';\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 { parameterQuery, type ExperienceParameters } from './experience-parameters.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  /** Values for declared Experience parameters. Refetch with new values to swap content. */\n  parameters?: ExperienceParameters;\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, parameters, personalization, extensions } =\n    options;\n  const requestExtensions: DeliveryExperienceRequestExtensions = { ...extensions };\n  if (personalization !== undefined) {\n    requestExtensions.personalization = serializePersonalization(personalization);\n  }\n\n  try {\n    // GET uses namespaced query leaves. POST preserves values that cannot be\n    // represented by leaves and carries existing request extensions.\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    const queryParams = parameterQuery(parameters);\n    if (hasRequestExtensions(requestExtensions) || queryParams === undefined) {\n      // dev.10's POST serializer passes through extra body keys. Its generated\n      // request type omits parameters, so retain our typed extension locally.\n      // TODO: Remove this intersection once contentful-experience-delivery.js\n      // generates parameters on GetWithOverridesExperienceRequest and we upgrade.\n      const request: ContentfulViewDelivery.GetWithOverridesExperienceRequest & {\n        parameters?: ExperienceParameters;\n      } = {\n        locale,\n        extensions: requestExtensions,\n        ...(parameters === undefined ? {} : { parameters }),\n      };\n      return await client.experience.getWithOverrides(\n        spaceId,\n        environmentId,\n        experienceId,\n        request\n      );\n    }\n\n    if (Object.keys(queryParams).length > 0) {\n      return await client.experience.get(\n        spaceId,\n        environmentId,\n        experienceId,\n        { locale },\n        {\n          queryParams,\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","import { GetWithOverridesExperienceRequestExtensionsPersonalization as personalizationSchema } from '@contentful/experience-delivery/serialization';\nimport type { PersonalizationOptions } from './fetch-experience.js';\n\n/** Validate and serialize events to the generated XDA request contract. */\nexport function serializePersonalization(personalization: unknown): PersonalizationOptions {\n  try {\n    // XDA rejects EventBuilder's context.gdpr with HTTP 422. Keep caller-built\n    // events intact and serialize to its generated schema, which omits consent.\n    return personalizationSchema.parseOrThrow(personalization, {\n      unrecognizedObjectKeys: 'strip',\n    });\n  } catch (cause) {\n    throw new TypeError('Invalid Experience personalization options', { cause });\n  }\n}\n","import { DestinationPreviewNotSupportedError } from './errors.js';\n\n/**\n * Throws `DestinationPreviewNotSupportedError` when `clientOptions.preview` is\n * `true` and `experienceOptions` is destination-shaped (a caller-supplied\n * `{ client }` already ignores `preview` entirely, so this only fires for the\n * inline-credentials branch). Shared by `fetchExperience` and\n * `fetchDestinationSitemap` — both call into the same preview-less\n * Destinations Delivery API.\n */\nexport function assertDestinationPreviewSupported(\n  isPreview: boolean | undefined,\n  destination: { spaceId: string; destinationId: string; nodeId?: string; path?: string }\n): void {\n  if (!isPreview) return;\n\n  const { spaceId, destinationId, nodeId, path } = destination;\n  const locator = nodeId !== undefined ? `nodeId \"${nodeId}\"` : `path \"${path}\"`;\n  throw new DestinationPreviewNotSupportedError(\n    `preview: true was combined with a destination-shaped call (destinationId ` +\n      `\"${destinationId}\", ${locator}). The Destinations Delivery API does not support ` +\n      `preview mode yet — pass preview: false (or omit it) for destination-based fetches.`,\n    { spaceId, destinationId, nodeId, path }\n  );\n}\n","export const DELIVERY_HOST = 'https://xdn.contentful.com';\nexport const PREVIEW_HOST = 'https://preview.xdn.contentful.com';\nexport const PREVIEW_WEBSOCKET_HOST = 'wss://preview.xdn.contentful.com';\n","import type { ContentfulViewDeliveryClient } from '@contentful/experience-delivery';\nimport { createClient } from './create-delivery-client.js';\nimport { createDebugLogger } from '@contentful/experiences-sdk-core';\nimport { PREVIEW_HOST } from './hosts.js';\n\nexport type ClientOptions =\n  | {\n      accessToken: string;\n      /**\n       * Preview access token. Required when calling with `preview: true`.\n       */\n      previewToken?: string;\n      /**\n       * Flip between delivery (default) and preview at request time. When\n       * `true`, uses `previewToken` and the preview host; when `false` or\n       * unset, uses `accessToken` and the delivery host. Ignored when a\n       * pre-made `client` is passed instead of inline creds.\n       */\n      preview?: boolean;\n      /**\n       * Custom base URL for the delivery client (staging, proxy, per-region).\n       * Wins over the `preview`-derived default host — combine `host` with\n       * `preview: true` to point preview mode at a non-prod endpoint.\n       * Omit for the standard delivery / preview hosts.\n       */\n      host?: string;\n    }\n  | { client: ContentfulViewDeliveryClient };\n\n/**\n * Resolve a `ClientOptions` union into a real delivery client. Shared by\n * `fetchExperience` and `fetchDestinationSitemap` — both accept the same\n * inline-creds-or-pre-made-client shape.\n */\nexport function resolveDeliveryClient(\n  clientOptions: ClientOptions,\n  log: ReturnType<typeof createDebugLogger>,\n  callerName: string\n): ContentfulViewDeliveryClient {\n  if ('client' in clientOptions) {\n    log.log('using caller-supplied delivery client');\n    return clientOptions.client;\n  }\n\n  const { accessToken, previewToken, preview, host } = clientOptions;\n  if (preview && !previewToken) {\n    throw new Error(`${callerName}() called with preview: true but no previewToken was provided`);\n  }\n  const resolvedHost = host ?? (preview ? PREVIEW_HOST : undefined);\n  const client = createClient({\n    accessToken: preview ? (previewToken as string) : accessToken,\n    host: resolvedHost,\n  });\n  log.log('created delivery client', { preview: Boolean(preview), host: resolvedHost });\n  return client;\n}\n","/** One collection order path; `-` selects descending order. Delivery validates the path. */\nexport type ExperienceParameterOrder =\n  `fields.${string}` | `sys.${string}` | `-fields.${string}` | `-sys.${string}`;\n\n/** Runtime values for one Record parameter. Nested records and arrays are not supported. */\nexport type ExperienceParameterRecord = Record<string, string | number>;\n\nexport type ExperienceParameterValue = string | number | ExperienceParameterRecord;\n\n/** Unprefixed IDs declared in Experience.parameters and referenced as `$parameters/<id>`. */\nexport type ExperienceParameters = Record<string, ExperienceParameterValue>;\n\n/**\n * Flatten values for the generated client's GET queryParams escape hatch.\n * An empty Record cannot be represented by query leaves: preserve it via POST.\n * Delivery owns name, requiredness, fallback and value validation.\n */\nexport function parameterQuery(\n  parameters: ExperienceParameters | undefined\n): Record<string, string | number> | undefined {\n  const entries: [string, string | number][] = [];\n  for (const [id, value] of Object.entries(parameters ?? {})) {\n    // A dotted ID could masquerade as another parameter's Record leaf on GET.\n    // Preserve the original name on POST and let delivery validate it.\n    if (id.includes('.')) return undefined;\n    if (typeof value === 'string' || typeof value === 'number') {\n      entries.push([`parameter.${id}`, value]);\n    } else {\n      // Untyped callers can supply other JSON shapes. Use POST so delivery\n      // sees their original value rather than a lossy query string coercion.\n      if (value === null || typeof value !== 'object' || Array.isArray(value)) return undefined;\n      const leaves = Object.entries(value);\n      if (leaves.length === 0) return undefined;\n      for (const [field, leaf] of leaves) {\n        if (field.includes('.')) return undefined;\n        if (typeof leaf !== 'string' && typeof leaf !== 'number') return undefined;\n        entries.push([`parameter.${id}.${field}`, leaf]);\n      }\n    }\n  }\n  return Object.fromEntries(entries);\n}\n","/*\n * Typed narrowing from a delivery-client response to the payload shape the\n * renderer consumes.\n */\n\nimport type { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport type { ExperiencePayload, ExperienceSourceMap } from '@contentful/experiences-sdk-core';\n\n/** Either shape the experience endpoint can return — `get()` and `getWithOverrides()` share it. */\nexport type ExperienceResponse =\n  | ContentfulViewDelivery.GetExperienceResponse\n  | ContentfulViewDelivery.GetWithOverridesExperienceResponse;\n\n/**\n * Narrow a delivery response to `ExperiencePayload`.\n *\n * The endpoint types its response as `HydratedView | HydratedExperienceView`.\n * The alpha-feature header the delivery client always sends guarantees the\n * latter, but TypeScript cannot know that, so callers were left casting by hand.\n *\n * `fetchExperience` uses this internally; it is exported for anyone driving the\n * delivery client directly. Type-level only — no validation, no copying.\n *\n * A legacy-shaped response carries `componentType` / `template` links instead;\n * `resolveExperience` reports those through `warnUnrenderableNode`.\n */\nexport function toExperiencePayload(response: ExperienceResponse): ExperiencePayload {\n  return response as ContentfulViewDelivery.HydratedExperienceView as ExperiencePayload;\n}\n\n/** Read `extensions.sourceMap` off a response. `undefined` when the request did not opt in. */\nexport function readSourceMap(response: ExperienceResponse): ExperienceSourceMap | undefined {\n  const extensions = (response as ContentfulViewDelivery.HydratedExperienceView).extensions;\n  return extensions?.sourceMap as ExperienceSourceMap | undefined;\n}\n\n/**\n * Narrow a `ResolvedDestinationExperience.experience` to `ExperiencePayload`.\n *\n * Same cast rationale as `toExperiencePayload` above, for the destination\n * resolution endpoints' `HydratedExperience` shape instead of the by-id\n * endpoints' `HydratedExperienceView`.\n */\nexport function toExperiencePayloadFromDestination(\n  experience: ContentfulViewDelivery.HydratedExperience\n): ExperiencePayload {\n  return experience as unknown as ExperiencePayload;\n}\n","import { ContentfulViewDelivery } from '@contentful/experience-delivery';\nimport { createDebugLogger } from '@contentful/experiences-sdk-core';\nimport { assertDestinationPreviewSupported } from './destination-guards.js';\nimport { resolveDeliveryClient, type ClientOptions } from './client-resolution.js';\nimport { ExperienceFetchError } from './errors.js';\n\nexport type FetchDestinationSitemapOptions = {\n  spaceId: string;\n  destinationId: string;\n};\n\nexport type FetchDestinationSitemapPaginationOptions = {\n  /** Maximum number of paths to return. Defaults to `100`, maximum `1000`. */\n  limit?: number;\n  /** Cursor from a previous call's `pages.next`. Treat as opaque; don't combine with `pagePrev`. */\n  pageNext?: string;\n  /** Cursor from a previous call's `pages.prev`. Treat as opaque; don't combine with `pageNext`. */\n  pagePrev?: string;\n};\n\nexport type SitemapPathItem = {\n  /** Path this entry routes. */\n  path: string;\n  /** Flat id extracted from the entry's `experienceUrn`. */\n  experienceId: string;\n  /** Type of the Destination Node that claims this path, e.g. `\"DestinationExperienceNode\"`. */\n  type: string;\n};\n\nexport type DestinationSitemapResult = {\n  items: SitemapPathItem[];\n  limit: number;\n  pages: { next?: string; prev?: string };\n};\n\n/**\n * List every routable path in a published Destination. Bulk enumeration —\n * pairs with `fetchExperience`'s `destinationId` + `nodeId`/`path` branches,\n * which resolve one path at a time. Does not hydrate any Experience itself\n * and does not call `fetchExperience` internally.\n */\nexport async function fetchDestinationSitemap(\n  destinationOptions: FetchDestinationSitemapOptions,\n  clientOptions: ClientOptions,\n  paginationOptions: FetchDestinationSitemapPaginationOptions = {}\n): Promise<DestinationSitemapResult> {\n  const { spaceId, destinationId } = destinationOptions;\n  const log = createDebugLogger(false, 'client');\n\n  if (!('client' in clientOptions)) {\n    assertDestinationPreviewSupported(clientOptions.preview, { spaceId, destinationId });\n  }\n\n  const client = resolveDeliveryClient(clientOptions, log, 'fetchDestinationSitemap');\n\n  const { limit, pageNext, pagePrev } = paginationOptions;\n\n  let response: ContentfulViewDelivery.DestinationSitemap;\n  try {\n    response = await client.destination.sitemap(spaceId, destinationId, {\n      limit,\n      pageNext,\n      pagePrev,\n    });\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 fetch sitemap for Destination \"${destinationId}\" (space \"${spaceId}\"): ` +\n        `${reason}. Check network connectivity, the access token, and that the space/` +\n        `destination ids are correct.`,\n      { spaceId, experienceId: destinationId, cause: err }\n    );\n  }\n\n  const result = {\n    items: response.paths.items.map((item) => ({\n      path: item.path,\n      experienceId: extractIdFromUrn(item.experienceUrn),\n      type: item.sys.type,\n    })),\n    limit: response.paths.limit,\n    pages: response.paths.pages,\n  };\n\n  log.lazy('received sitemap page', () => result);\n\n  return result;\n}\n\n/**\n * Extract the flat id from an `experienceUrn`. Real shape:\n *   crn:contentful:::experience:spaces/$self/environments/$self/experiences/<id>\n *\n * Same one-line logic as the private `extractIdFromUrn` in\n * `packages/core/src/resolve-experience.ts` — not shared across the\n * `core`/`client` package boundary (core stays zero-dep) for one line.\n */\nfunction extractIdFromUrn(urn: string): string {\n  const segments = urn.split('/').filter((s) => s.length > 0);\n  return segments[segments.length - 1] ?? urn;\n}\n"],"mappings":"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","names":["ContentfulViewDelivery","ContentfulViewDeliveryClient","spaceId","ContentfulViewDelivery","createDebugLogger","createDebugLogger","ContentfulViewDelivery","ContentfulViewDelivery"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-client",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Delivery client + fetchExperience for Contentful Experiences",
   "license": "MIT",
   "type": "module",