Skip to content

GetComponentOptions

@ebitex/content-sdk — the framework-agnostic half.

  • Low-level: createDeliveryClient — one method per Content Delivery API endpoint, the delivered vocabulary as types (types.ts) and runtime guards (guards.ts), typed errors.
  • High-level: createContentClientresolveLocation(location) for router changes: site from the page’s own host, locale from the browser’s languages against the organization’s tree, the context bag, a full/normalized resolve strategy, caching and cancellation.

Nothing here imports React; the rendering layer is @ebitex/content-sdk/react. Both clients run in a browser (with a browser-safe delivery key) and in Node (any key).

optional ctx?: ContextBag

The personalization context. Present = server-resolve (personalization collapsed, tokens injected); absent = client-resolve (unresolved variant-set envelopes come back).

ReadOptions.ctx


optional locale?: string

One locale code. The server resolves its fallback chain; the high-level client picks the code.

ReadOptions.locale


optional paths?: boolean

Attach this component’s own published address(es) — wire include=paths, the same value listComponents({ paths: true }) reports for the same key. Distinct from referencePaths, which is about the pages this component’s document names.


optional raw?: boolean

Keep Localizable envelopes unresolved. Never sent by the high-level client.

ReadOptions.raw


optional referencePaths?: boolean

Attach every reference descriptor’s own published address(es) — wire include=referencePaths. The paths member is the same one listComponents({ paths: true }) puts on an item, with the same rules, but on the references inside a document: a post’s series, a parent article, a related-reading list. [] means the target is bound at no live node; the member being absent means this option was not sent.

Present at any depth and whether or not the descriptor was expanded, so a resolve: 0 read is enough to build navigation. Pick one with pathForSite.

ReadOptions.referencePaths


optional resolve?: number

Expansion depth (an integer, capped at 10 server-side). Omitted = 0, descriptors only.

ReadOptions.resolve


optional signal?: AbortSignal

ReadOptions.signal


optional site?: string

CurrentSiteOption.site