@disconetwork/core 0.0.4 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["#endpoint","#sessionId","#fetch","#dedupe","#isDeduped","#toBody","#env","#url","#headers","#fetch"],"sources":["../src/env.ts","../src/TrackingManager.ts","../src/DiscoClient.ts","../src/recommendationsMapper.ts"],"sourcesContent":["/**\n * Disco backend environments. The SDK does not accept arbitrary URLs —\n * consumers pick an environment and the SDK resolves the correct\n * endpoints internally. This keeps partners from pointing the client or\n * tracker at unintended hosts while still supporting staging.\n */\nexport type DiscoEnv = \"production\" | \"staging\";\n\nexport type EnvEndpoints = {\n /** Base URL for the recommendations API (no trailing slash). */\n apiBaseUrl: string;\n /** Absolute URL events are POSTed to. */\n trackingEndpoint: string;\n};\n\nexport const ENV_ENDPOINTS = {\n production: {\n apiBaseUrl: \"https://consumer.disconetwork.com\",\n trackingEndpoint: \"https://consumer.disconetwork.com/track/partners_event/\",\n },\n staging: {\n apiBaseUrl: \"https://consumer.disconetwork-staging.com\",\n trackingEndpoint:\n \"https://consumer.disconetwork-staging.com/track/partners_event/\",\n },\n} as const satisfies Record<DiscoEnv, EnvEndpoints>;\n\nexport const DEFAULT_ENV: DiscoEnv = \"production\";\n\n/**\n * Derive the environment from a Disco public API key.\n *\n * Public keys are prefixed `disco_pk_<env>_…`, where `<env>` is `live`\n * (→ production) or `sandbox` (→ staging). The key is the single source\n * of truth for which backend the SDK talks to — there is no separate\n * `env` to pass or keep in sync, and a `live` key can't be pointed at\n * staging (or vice versa).\n *\n * Throws on anything that isn't a recognized public key — including a\n * secret (`disco_sk_…`) key, which must never be used in browser code.\n */\nexport function envFromApiKey(apiKey: string): DiscoEnv {\n if (apiKey.startsWith(\"disco_pk_live_\")) return \"production\";\n if (apiKey.startsWith(\"disco_pk_sandbox_\")) return \"staging\";\n throw new Error(\n 'Invalid Disco API key: expected a public key prefixed \"disco_pk_live_\" ' +\n '(production) or \"disco_pk_sandbox_\" (staging).',\n );\n}\n","import { ENV_ENDPOINTS, type DiscoEnv } from \"./env.js\";\nimport type { BrandProperties, EventPayload } from \"./types.js\";\n\nexport type TrackingManagerConfig = {\n /**\n * Session identifier returned by the recommendations API. Stamped onto\n * every emitted event as `session_id`. A tracker is meaningless without\n * a session, so this is required — instantiate the manager only after\n * the recommendations response is in hand.\n */\n sessionId: string;\n\n /**\n * Which Disco environment to send events to. The endpoint URL is resolved\n * internally — it is not configurable.\n *\n * Prefer `DiscoClient#createTrackingManager` so tracking uses the same\n * API-key-derived environment as the recommendations call.\n */\n env: DiscoEnv;\n\n /**\n * Override the global `fetch`. Primarily useful in tests and in runtimes\n * that provide a non-standard fetch implementation. Defaults to\n * `globalThis.fetch`.\n */\n fetch?: typeof fetch;\n};\n\nexport type EventTracker = {\n track: (event: EventPayload) => void;\n};\n\n/**\n * Renderer-agnostic event tracker for Disco recommendation surfaces.\n *\n * Owns:\n * - the dedup set (so repeated display/view events for the same brand\n * don't get re-sent within a session)\n * - the network call to the partner-events endpoint\n * - payload formatting (snake_case keys, BE-friendly datetime)\n *\n * Does not know about React. Wrap it in a Provider (`@disconetwork/react`'s\n * `DiscoProvider`) when consuming from a React tree, or instantiate it\n * directly from any other JS environment.\n *\n * `track` is implemented as an instance-bound arrow function so consumers\n * can safely destructure it without losing `this`.\n */\nexport class TrackingManager {\n readonly #endpoint: string;\n readonly #sessionId: string;\n readonly #fetch: typeof fetch;\n readonly #dedupe = new Set<string>();\n\n constructor(config: TrackingManagerConfig) {\n this.#endpoint = ENV_ENDPOINTS[config.env].trackingEndpoint;\n this.#sessionId = config.sessionId;\n this.#fetch = config.fetch ?? globalThis.fetch.bind(globalThis);\n }\n\n /**\n * Send a tracking event. Fire-and-forget — never throws.\n * Failures are logged via `console.error`.\n *\n * Idempotency: `WIDGET_DISPLAY`, `WIDGET_VIEW`, `BRAND_DISPLAY`, and\n * `BRAND_VIEW` are deduped per-instance by (event type, insertionId).\n */\n track = (event: EventPayload): void => {\n if (this.#isDeduped(event)) return;\n\n this.#fetch(this.#endpoint, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(this.#toBody(event)),\n }).catch((error: unknown) => {\n console.error(\"Event tracking failed:\", error);\n });\n };\n\n #isDeduped(event: EventPayload): boolean {\n if (\n event.type === \"WIDGET_DISPLAY\" ||\n event.type === \"WIDGET_VIEW\" ||\n event.type === \"BRAND_DISPLAY\" ||\n event.type === \"BRAND_VIEW\"\n ) {\n const key =\n event.type + (\"brand\" in event ? event.brand.insertionId : \"widget\");\n if (this.#dedupe.has(key)) return true;\n this.#dedupe.add(key);\n }\n return false;\n }\n\n #toBody(event: EventPayload): Record<string, unknown> {\n const commonEventFields = {\n session_id: this.#sessionId,\n event_name: event.type,\n // BE validation can't parse the \"Z\" timezone suffix, so replace it\n // with \"+00:00\".\n event_datetime: new Date().toISOString().replace(\"Z\", \"+00:00\"),\n };\n\n switch (event.type) {\n case \"BRAND_CLICK\":\n case \"BRAND_DISPLAY\":\n case \"BRAND_VIEW\":\n return {\n ...commonEventFields,\n brand_properties: brandProperties(event.brand),\n initiating_target: event.target,\n };\n case \"ELEMENT_CLICK\":\n return {\n ...commonEventFields,\n brand_properties: event.brand\n ? brandProperties(event.brand)\n : undefined,\n initiating_target: event.target,\n };\n default:\n return commonEventFields;\n }\n }\n}\n\nfunction brandProperties(brand: BrandProperties) {\n return {\n offer_id: brand.offerId,\n advertiser_id: brand.advertiserId,\n insertion_id: brand.insertionId,\n };\n}\n","import { ENV_ENDPOINTS, envFromApiKey, type DiscoEnv } from \"./env.js\";\nimport { TrackingManager, type EventTracker } from \"./TrackingManager.js\";\nimport type {\n RecommendationsRequest,\n RecommendationsResponse,\n} from \"./recommendations.js\";\nimport type { RawRecommendationsResponse } from \"./recommendationsMapper.js\";\n\n/**\n * Authenticate with a scoped public API key. Sent as the `x-api-key`\n * header against the unified `/core/recommendations/` endpoint. The key\n * prefix (`disco_pk_live_` / `disco_pk_sandbox_`) determines the\n * environment, so there is no separate `env` to set.\n *\n * Use this from partner apps and server-side code that hold a key.\n */\nexport type ApiKeyConfig = {\n apiKey: string;\n fetch?: typeof fetch;\n};\n\n/**\n * Authenticate by Shopify shop — for surfaces that must not embed a key,\n * notably the App-Store-deployed checkout extension. The request hits the\n * `/core/recommendations/shop_gid/<id>/` proxy with **no** API key; the\n * backend resolves the publisher from the shop and injects the key\n * server-side.\n *\n * `env` is required here because, unlike `ApiKeyConfig`, there is no key\n * to derive it from. `shopGid` may be a full `gid://shopify/Shop/<id>` or\n * the bare id.\n */\nexport type ShopGidConfig = {\n shopGid: string;\n env: DiscoEnv;\n fetch?: typeof fetch;\n};\n\nexport type DiscoClientConfig = ApiKeyConfig | ShopGidConfig;\n\nexport type GetRecommendationsOptions = {\n /** Forwarded to `fetch` so consumers can cancel in-flight requests. */\n signal?: AbortSignal;\n};\n\nexport type CreateTrackingManagerOptions = {\n /**\n * Override the fetch implementation used by the tracker. Defaults to the\n * same fetch implementation configured on the client.\n */\n fetch?: typeof fetch;\n};\n\n/**\n * Result of `getRecommendationsWithTracker`: the **raw** recommendations\n * response plus a tracker already bound to its session.\n */\nexport type RecommendationsWithTracker = {\n /**\n * The verbatim API response (snake_case), exactly as `getRecommendations`\n * returns it. Pass it through `mapRecommendationsResponse` for the friendly\n * denormalized shape.\n */\n data: RawRecommendationsResponse;\n /** Event tracker bound to this response's session. */\n tracker: EventTracker;\n};\n\n/**\n * Thrown by `DiscoClient.getRecommendations` when the server returns a\n * non-2xx status. The HTTP status and an optional parsed body are\n * preserved for error UIs and retry logic.\n */\nexport class DiscoApiError extends Error {\n readonly status: number;\n readonly statusText: string;\n readonly body: unknown;\n\n constructor(\n message: string,\n info: {\n status: number;\n statusText: string;\n body?: unknown;\n },\n ) {\n super(message);\n this.name = \"DiscoApiError\";\n this.status = info.status;\n this.statusText = info.statusText;\n this.body = info.body;\n }\n}\n\n/**\n * Typed client for the Disco recommendations API.\n *\n * Renderer-agnostic: this class makes plain HTTP calls and has no\n * React dependency. Wrap it in a Provider (`@disconetwork/react`'s\n * `DiscoProvider`) for use from a React tree, or instantiate it\n * directly from server code, scripts, or tests.\n */\nexport class DiscoClient {\n readonly #env: DiscoEnv;\n readonly #url: string;\n readonly #headers: Record<string, string>;\n readonly #fetch: typeof fetch;\n\n constructor(config: DiscoClientConfig) {\n this.#fetch = config.fetch ?? globalThis.fetch.bind(globalThis);\n\n if (\"apiKey\" in config) {\n this.#env = envFromApiKey(config.apiKey);\n this.#url = `${ENV_ENDPOINTS[this.#env].apiBaseUrl}/core/recommendations/`;\n this.#headers = {\n \"x-api-key\": config.apiKey,\n \"Content-Type\": \"application/json\",\n };\n } else {\n this.#env = config.env;\n const shopId = stripShopGid(config.shopGid);\n this.#url = `${ENV_ENDPOINTS[this.#env].apiBaseUrl}/core/recommendations/shop_gid/${encodeURIComponent(shopId)}/`;\n // No x-api-key: the backend resolves auth from the shop_gid.\n this.#headers = { \"Content-Type\": \"application/json\" };\n }\n }\n\n /**\n * POST the recommendations endpoint and return the backend's response\n * **verbatim** — this reflects `ExternalAPIRecommendationView` with no\n * transformation. Pass the result through `mapRecommendationsResponse`\n * if you want the friendly denormalized `RecommendationsResponse`.\n *\n * Throws `DiscoApiError` on non-2xx responses; other failures\n * (network, parse) propagate as-is.\n */\n getRecommendations = async (\n request: RecommendationsRequest,\n options?: GetRecommendationsOptions,\n ): Promise<RawRecommendationsResponse> => {\n const response = await this.#fetch(this.#url, {\n method: \"POST\",\n headers: this.#headers,\n body: JSON.stringify(toRequestBody(request)),\n signal: options?.signal,\n });\n\n if (!response.ok) {\n const body = await safeReadBody(response);\n throw new DiscoApiError(\n `Recommendations request failed: ${response.status} ${response.statusText}`,\n { status: response.status, statusText: response.statusText, body },\n );\n }\n\n return (await response.json()) as RawRecommendationsResponse;\n };\n\n /**\n * Fetch recommendations and create a session-bound tracker in one call.\n *\n * Composition convenience over `getRecommendations` + `createTrackingManager`:\n * it derives the tracker's session from the response so callers don't have to\n * thread `session_id` through themselves (and can't bind a tracker to the\n * wrong session). The returned `data` is the **raw** response — call\n * `mapRecommendationsResponse` on it if you want the friendly shape.\n *\n * Throws `DiscoApiError` on non-2xx responses, same as `getRecommendations`.\n */\n getRecommendationsWithTracker = async (\n request: RecommendationsRequest,\n options?: GetRecommendationsOptions & CreateTrackingManagerOptions,\n ): Promise<RecommendationsWithTracker> => {\n const data = await this.getRecommendations(request, {\n signal: options?.signal,\n });\n const tracker = this.createTrackingManager(\n { sessionId: data.session_id },\n { fetch: options?.fetch },\n );\n return { data, tracker };\n };\n\n /**\n * Create an event tracker for a recommendations response from this client.\n *\n * The tracker uses the same API-key-derived environment as the\n * recommendations call, so sandbox recommendations cannot accidentally emit\n * production tracking events.\n */\n createTrackingManager = (\n recommendations: Pick<RecommendationsResponse, \"sessionId\">,\n options?: CreateTrackingManagerOptions,\n ): EventTracker =>\n new TrackingManager({\n sessionId: recommendations.sessionId,\n env: this.#env,\n fetch: options?.fetch ?? this.#fetch,\n });\n}\n\nfunction stripShopGid(shopGid: string): string {\n return shopGid.replace(\"gid://shopify/Shop/\", \"\");\n}\n\n// ─── Request transformation ────────────────────────────────────────────────\n\nfunction toRequestBody(req: RecommendationsRequest): Record<string, unknown> {\n return {\n recommendations_data: {\n user_details: req.user && {\n email: req.user.email,\n first_name: req.user.firstName,\n last_name: req.user.lastName,\n phone: req.user.phone,\n },\n placement_details: req.placement && {\n display_mode: req.placement.displayMode,\n view: req.placement.view,\n },\n order_details: req.order && {\n order_id: req.order.id,\n cost_details:\n req.order.amount !== undefined || req.order.currencyCode !== undefined\n ? {\n amount: req.order.amount,\n currency_code: req.order.currencyCode,\n }\n : undefined,\n },\n purchases: req.purchases?.map((p) => ({\n name: p.name,\n type: p.type,\n variant: p.variant,\n quantity: p.quantity,\n product_id: p.productId,\n cost_details:\n p.amount !== undefined || p.currencyCode !== undefined\n ? { amount: p.amount, currency_code: p.currencyCode }\n : undefined,\n })),\n },\n running_experiments: req.experiments?.map((e) => ({\n id: e.id,\n variant: e.variant,\n })),\n attributes: req.attributes,\n ...req.extras,\n };\n}\n\n// ─── Misc ──────────────────────────────────────────────────────────────────\n\nasync function safeReadBody(response: Response): Promise<unknown> {\n try {\n return await response.clone().json();\n } catch {\n try {\n return await response.text();\n } catch {\n return undefined;\n }\n }\n}\n","/**\n * Raw wire types for the recommendations endpoint and the opt-in mapper\n * that denormalizes them into the public `RecommendationsResponse`.\n *\n * `DiscoClient.getRecommendations` returns `RawRecommendationsResponse`\n * verbatim — it reflects exactly what the backend's\n * `ExternalAPIRecommendationView` returns, with no transformation. Callers\n * that want the friendlier denormalized shape pass that raw value through\n * `mapRecommendationsResponse`. Keeping the two separate means the SDK's\n * transport contract is just \"the server's response\", and the (drift-prone)\n * mapping is an explicit, swappable step.\n */\n\nimport type {\n Advertiser,\n Footer,\n Offer,\n OfferAsset,\n OfferCtaDetails,\n Recommendation,\n RecommendationGroup,\n RecommendationsResponse,\n} from \"./recommendations.js\";\n\n// ─── Raw wire shape ──────────────────────────────────────────────────────────\n//\n// The endpoint returns a *normalized* payload: a flat map of recommendations\n// keyed by offer id, separate per-group entry lists that reference those offer\n// ids, and separate per-group properties. Plus assorted top-level fields the\n// proxy adds (widget_type, etc.) that the mapper doesn't need but that other\n// consumers (e.g. the script SDK) read directly off the raw response.\n\nexport type RawRecommendationsResponse = {\n session_id: string;\n layout_id: string;\n /** Map of offer id → recommendation. */\n recommendations?: Record<string, RawRecommendation> | null;\n /** Map of group key → ordered entry list referencing offer ids. */\n recommendation_groups?: Record<string, RawGroupEntry[]> | null;\n /** Map of group key → group display properties. */\n recommendation_group_properties?: Record<string, RawGroupProperties> | null;\n footer: RawFooter;\n publisher_customization?: RawPublisherCustomization | null;\n // Proxy-added top-level fields. Not used by the mapper; surfaced so raw\n // consumers can read them. Open-ended — see ExternalAPIRecommendationView.\n is_using_cmos_recommendations?: boolean;\n widget_type?: string;\n widget_mode?: string;\n widget_version?: string;\n running_experiments?: unknown[];\n};\n\nexport type RawRecommendation = {\n advertiser: RawAdvertiser;\n offer: RawOffer;\n};\n\nexport type RawGroupEntry = {\n insertion_order: number;\n insertion_id: string;\n offer_id: string;\n advertiser_id: string;\n};\n\nexport type RawGroupProperties = {\n heading?: string | null;\n slot_context: string;\n};\n\nexport type RawAdvertiser = {\n id: string;\n name: string;\n logo_url: string;\n description?: string | null;\n};\n\nexport type RawOffer = {\n id: string;\n heading?: string | null;\n subheading?: string | null;\n json_content?: Record<string, unknown> | null;\n target_url: string;\n cta_details: RawOfferCtaDetails;\n assets?: RawOfferAsset[] | null;\n metadata?: Record<string, unknown> | null;\n disclosure_details?: Record<string, unknown> | null;\n};\n\nexport type RawOfferCtaDetails = {\n accept_copy: string;\n decline_copy: string;\n transition_copy?: string | null;\n};\n\nexport type RawOfferAsset = {\n id: string;\n image_url: string;\n target_url?: string | null;\n};\n\nexport type RawFooter = {\n attribution_details: {\n copy: string;\n disco_logo_url: string;\n target_url: string;\n };\n privacy_policy: {\n copy: string;\n target_url: string;\n };\n};\n\nexport type RawPublisherCustomization = Record<string, Record<string, string>>;\n\n// ─── Mapper ───────────────────────────────────────────────────────────────────\n\n/**\n * Denormalize a raw recommendations response into the public\n * `RecommendationsResponse`: join group entries → recommendations by offer id,\n * order groups by the numeric suffix of their key (group_0, group_1, …), and\n * convert snake_case to camelCase.\n *\n * Pure and side-effect-free — call it on the result of\n * `DiscoClient.getRecommendations` when you want the friendly shape.\n */\nexport function mapRecommendationsResponse(\n raw: RawRecommendationsResponse,\n): RecommendationsResponse {\n const recommendations = raw.recommendations ?? {};\n const groupEntries = raw.recommendation_groups ?? {};\n const groupProps = raw.recommendation_group_properties ?? {};\n\n const orderedKeys = Object.keys(groupEntries).sort(\n (a, b) => numericSuffix(a) - numericSuffix(b),\n );\n\n const recommendationGroups: RecommendationGroup[] = [];\n for (const key of orderedKeys) {\n const entries = groupEntries[key];\n const props = groupProps[key];\n // Skip groups missing their entry list or display properties.\n if (!entries || !props) continue;\n\n const recs: Recommendation[] = [];\n for (const entry of entries) {\n const rawRec = recommendations[entry.offer_id];\n if (!rawRec) continue; // entry references an absent recommendation\n recs.push({\n id: rawRec.offer.id,\n insertionId: entry.insertion_id,\n advertiser: mapAdvertiser(rawRec.advertiser),\n offer: mapOffer(rawRec.offer),\n });\n }\n\n recommendationGroups.push({\n heading: props.heading ?? null,\n slotContext: props.slot_context,\n recommendations: recs,\n });\n }\n\n return {\n sessionId: raw.session_id,\n layoutId: raw.layout_id,\n recommendationGroups,\n footer: mapFooter(raw.footer),\n publisherCustomization: raw.publisher_customization ?? null,\n };\n}\n\nfunction numericSuffix(value: string): number {\n const suffix = value.split(\"_\").pop() ?? \"\";\n const parsed = Number.parseInt(suffix, 10);\n return Number.isNaN(parsed) ? Number.POSITIVE_INFINITY : parsed;\n}\n\nfunction mapAdvertiser(raw: RawAdvertiser): Advertiser {\n return {\n id: raw.id,\n name: raw.name,\n logoUrl: raw.logo_url,\n description: raw.description ?? null,\n };\n}\n\nfunction mapOffer(raw: RawOffer): Offer {\n return {\n id: raw.id,\n heading: raw.heading ?? null,\n subheading: raw.subheading ?? null,\n jsonContent: raw.json_content ?? null,\n targetUrl: raw.target_url,\n ctaDetails: mapCtaDetails(raw.cta_details),\n assets: (raw.assets ?? []).map(mapAsset),\n metadata: raw.metadata ?? null,\n disclosureDetails: raw.disclosure_details ?? null,\n };\n}\n\nfunction mapCtaDetails(raw: RawOfferCtaDetails): OfferCtaDetails {\n return {\n acceptCopy: raw.accept_copy,\n declineCopy: raw.decline_copy,\n transitionCopy: raw.transition_copy ?? null,\n };\n}\n\nfunction mapAsset(raw: RawOfferAsset): OfferAsset {\n return {\n id: raw.id,\n imageUrl: raw.image_url,\n targetUrl: raw.target_url ?? null,\n };\n}\n\nfunction mapFooter(raw: RawFooter): Footer {\n return {\n attributionDetails: {\n copy: raw.attribution_details.copy,\n discoLogoUrl: raw.attribution_details.disco_logo_url,\n targetUrl: raw.attribution_details.target_url,\n },\n privacyPolicy: {\n copy: raw.privacy_policy.copy,\n targetUrl: raw.privacy_policy.target_url,\n },\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["#recommendationsClient","#eventsUrl","#apiKey","#fetch"],"sources":["../src/api/generated/recommendations/core/bodySerializer.gen.ts","../src/api/generated/recommendations/core/serverSentEvents.gen.ts","../src/api/generated/recommendations/core/pathSerializer.gen.ts","../src/api/generated/recommendations/core/utils.gen.ts","../src/api/generated/recommendations/core/auth.gen.ts","../src/api/generated/recommendations/client/utils.gen.ts","../src/api/generated/recommendations/client/client.gen.ts","../src/api/generated/recommendations/client.gen.ts","../src/api/generated/recommendations/sdk.gen.ts","../src/api/index.ts","../src/config.ts","../src/external/DiscoClient.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport type {\n ArrayStyle,\n ObjectStyle,\n SerializerOptions,\n} from \"./pathSerializer.gen.js\";\n\nexport type QuerySerializer = (query: Record<string, unknown>) => string;\n\nexport type BodySerializer = (body: unknown) => unknown;\n\ntype QuerySerializerOptionsObject = {\n allowReserved?: boolean;\n array?: Partial<SerializerOptions<ArrayStyle>>;\n object?: Partial<SerializerOptions<ObjectStyle>>;\n};\n\nexport type QuerySerializerOptions = QuerySerializerOptionsObject & {\n /**\n * Per-parameter serialization overrides. When provided, these settings\n * override the global array/object settings for specific parameter names.\n */\n parameters?: Record<string, QuerySerializerOptionsObject>;\n};\n\nconst serializeFormDataPair = (\n data: FormData,\n key: string,\n value: unknown,\n): void => {\n if (typeof value === \"string\" || value instanceof Blob) {\n data.append(key, value);\n } else if (value instanceof Date) {\n data.append(key, value.toISOString());\n } else {\n data.append(key, JSON.stringify(value));\n }\n};\n\nconst serializeUrlSearchParamsPair = (\n data: URLSearchParams,\n key: string,\n value: unknown,\n): void => {\n if (typeof value === \"string\") {\n data.append(key, value);\n } else {\n data.append(key, JSON.stringify(value));\n }\n};\n\nexport const formDataBodySerializer = {\n bodySerializer: (body: unknown): FormData => {\n const data = new FormData();\n\n Object.entries(body as Record<string, unknown>).forEach(([key, value]) => {\n if (value === undefined || value === null) {\n return;\n }\n if (Array.isArray(value)) {\n value.forEach((v) => serializeFormDataPair(data, key, v));\n } else {\n serializeFormDataPair(data, key, value);\n }\n });\n\n return data;\n },\n};\n\nexport const jsonBodySerializer = {\n bodySerializer: (body: unknown): string =>\n JSON.stringify(body, (_key, value) =>\n typeof value === \"bigint\" ? value.toString() : value,\n ),\n};\n\nexport const urlSearchParamsBodySerializer = {\n bodySerializer: (body: unknown): string => {\n const data = new URLSearchParams();\n\n Object.entries(body as Record<string, unknown>).forEach(([key, value]) => {\n if (value === undefined || value === null) {\n return;\n }\n if (Array.isArray(value)) {\n value.forEach((v) => serializeUrlSearchParamsPair(data, key, v));\n } else {\n serializeUrlSearchParamsPair(data, key, value);\n }\n });\n\n return data.toString();\n },\n};\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { Config } from \"./types.gen.js\";\n\nexport type ServerSentEventsOptions<TData = unknown> = Omit<\n RequestInit,\n \"method\"\n> &\n Pick<Config, \"method\" | \"responseTransformer\" | \"responseValidator\"> & {\n /**\n * Fetch API implementation. You can use this option to provide a custom\n * fetch instance.\n *\n * @default globalThis.fetch\n */\n fetch?: typeof fetch;\n /**\n * Implementing clients can call request interceptors inside this hook.\n */\n onRequest?: (url: string, init: RequestInit) => Promise<Request>;\n /**\n * Callback invoked when a network or parsing error occurs during streaming.\n *\n * This option applies only if the endpoint returns a stream of events.\n *\n * @param error The error that occurred.\n */\n onSseError?: (error: unknown) => void;\n /**\n * Callback invoked when an event is streamed from the server.\n *\n * This option applies only if the endpoint returns a stream of events.\n *\n * @param event Event streamed from the server.\n * @returns Nothing (void).\n */\n onSseEvent?: (event: StreamEvent<TData>) => void;\n serializedBody?: RequestInit[\"body\"];\n /**\n * Default retry delay in milliseconds.\n *\n * This option applies only if the endpoint returns a stream of events.\n *\n * @default 3000\n */\n sseDefaultRetryDelay?: number;\n /**\n * Maximum number of retry attempts before giving up.\n */\n sseMaxRetryAttempts?: number;\n /**\n * Maximum retry delay in milliseconds.\n *\n * Applies only when exponential backoff is used.\n *\n * This option applies only if the endpoint returns a stream of events.\n *\n * @default 30000\n */\n sseMaxRetryDelay?: number;\n /**\n * Optional sleep function for retry backoff.\n *\n * Defaults to using `setTimeout`.\n */\n sseSleepFn?: (ms: number) => Promise<void>;\n url: string;\n };\n\nexport interface StreamEvent<TData = unknown> {\n data: TData;\n event?: string;\n id?: string;\n retry?: number;\n}\n\nexport type ServerSentEventsResult<\n TData = unknown,\n TReturn = void,\n TNext = unknown,\n> = {\n stream: AsyncGenerator<\n TData extends Record<string, unknown> ? TData[keyof TData] : TData,\n TReturn,\n TNext\n >;\n};\n\nexport function createSseClient<TData = unknown>({\n onRequest,\n onSseError,\n onSseEvent,\n responseTransformer,\n responseValidator,\n sseDefaultRetryDelay,\n sseMaxRetryAttempts,\n sseMaxRetryDelay,\n sseSleepFn,\n url,\n ...options\n}: ServerSentEventsOptions): ServerSentEventsResult<TData> {\n let lastEventId: string | undefined;\n\n const sleep =\n sseSleepFn ??\n ((ms: number) => new Promise((resolve) => setTimeout(resolve, ms)));\n\n const createStream = async function* () {\n let retryDelay: number = sseDefaultRetryDelay ?? 3000;\n let attempt = 0;\n const signal = options.signal ?? new AbortController().signal;\n\n while (true) {\n if (signal.aborted) break;\n\n attempt++;\n\n const headers =\n options.headers instanceof Headers\n ? options.headers\n : new Headers(options.headers as Record<string, string> | undefined);\n\n if (lastEventId !== undefined) {\n headers.set(\"Last-Event-ID\", lastEventId);\n }\n\n try {\n const requestInit: RequestInit = {\n redirect: \"follow\",\n ...options,\n body: options.serializedBody,\n headers,\n signal,\n };\n let request = new Request(url, requestInit);\n if (onRequest) {\n request = await onRequest(url, requestInit);\n }\n // fetch must be assigned here, otherwise it would throw the error:\n // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation\n const _fetch = options.fetch ?? globalThis.fetch;\n const response = await _fetch(request);\n\n if (!response.ok)\n throw new Error(\n `SSE failed: ${response.status} ${response.statusText}`,\n );\n\n if (!response.body) throw new Error(\"No body in SSE response\");\n\n const reader = response.body\n .pipeThrough(new TextDecoderStream())\n .getReader();\n\n let buffer = \"\";\n\n const abortHandler = () => {\n try {\n reader.cancel();\n } catch {\n // noop\n }\n };\n\n signal.addEventListener(\"abort\", abortHandler);\n\n try {\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n buffer += value;\n buffer = buffer.replace(/\\r\\n?/g, \"\\n\"); // normalize line endings\n\n const chunks = buffer.split(\"\\n\\n\");\n buffer = chunks.pop() ?? \"\";\n\n for (const chunk of chunks) {\n const lines = chunk.split(\"\\n\");\n const dataLines: Array<string> = [];\n let eventName: string | undefined;\n\n for (const line of lines) {\n if (line.startsWith(\"data:\")) {\n dataLines.push(line.replace(/^data:\\s*/, \"\"));\n } else if (line.startsWith(\"event:\")) {\n eventName = line.replace(/^event:\\s*/, \"\");\n } else if (line.startsWith(\"id:\")) {\n lastEventId = line.replace(/^id:\\s*/, \"\");\n } else if (line.startsWith(\"retry:\")) {\n const parsed = Number.parseInt(\n line.replace(/^retry:\\s*/, \"\"),\n 10,\n );\n if (!Number.isNaN(parsed)) {\n retryDelay = parsed;\n }\n }\n }\n\n let data: unknown;\n let parsedJson = false;\n\n if (dataLines.length) {\n const rawData = dataLines.join(\"\\n\");\n try {\n data = JSON.parse(rawData);\n parsedJson = true;\n } catch {\n data = rawData;\n }\n }\n\n if (parsedJson) {\n if (responseValidator) {\n await responseValidator(data);\n }\n\n if (responseTransformer) {\n data = await responseTransformer(data);\n }\n }\n\n onSseEvent?.({\n data,\n event: eventName,\n id: lastEventId,\n retry: retryDelay,\n });\n\n if (dataLines.length) {\n yield data as any;\n }\n }\n }\n } finally {\n signal.removeEventListener(\"abort\", abortHandler);\n reader.releaseLock();\n }\n\n break; // exit loop on normal completion\n } catch (error) {\n // connection failed or aborted; retry after delay\n onSseError?.(error);\n\n if (\n sseMaxRetryAttempts !== undefined &&\n attempt >= sseMaxRetryAttempts\n ) {\n break; // stop after firing error\n }\n\n // exponential backoff: double retry each attempt, cap at 30s\n const backoff = Math.min(\n retryDelay * 2 ** (attempt - 1),\n sseMaxRetryDelay ?? 30000,\n );\n await sleep(backoff);\n }\n }\n };\n\n const stream = createStream();\n\n return { stream };\n}\n","// This file is auto-generated by @hey-api/openapi-ts\n\ninterface SerializeOptions<T>\n extends SerializePrimitiveOptions, SerializerOptions<T> {}\n\ninterface SerializePrimitiveOptions {\n allowReserved?: boolean;\n name: string;\n}\n\nexport interface SerializerOptions<T> {\n /**\n * @default true\n */\n explode: boolean;\n style: T;\n}\n\nexport type ArrayStyle = \"form\" | \"spaceDelimited\" | \"pipeDelimited\";\nexport type ArraySeparatorStyle = ArrayStyle | MatrixStyle;\ntype MatrixStyle = \"label\" | \"matrix\" | \"simple\";\nexport type ObjectStyle = \"form\" | \"deepObject\";\ntype ObjectSeparatorStyle = ObjectStyle | MatrixStyle;\n\ninterface SerializePrimitiveParam extends SerializePrimitiveOptions {\n value: string;\n}\n\nexport const separatorArrayExplode = (\n style: ArraySeparatorStyle,\n): \".\" | \";\" | \",\" | \"&\" => {\n switch (style) {\n case \"label\":\n return \".\";\n case \"matrix\":\n return \";\";\n case \"simple\":\n return \",\";\n default:\n return \"&\";\n }\n};\n\nexport const separatorArrayNoExplode = (\n style: ArraySeparatorStyle,\n): \",\" | \"|\" | \"%20\" => {\n switch (style) {\n case \"form\":\n return \",\";\n case \"pipeDelimited\":\n return \"|\";\n case \"spaceDelimited\":\n return \"%20\";\n default:\n return \",\";\n }\n};\n\nexport const separatorObjectExplode = (\n style: ObjectSeparatorStyle,\n): \".\" | \";\" | \",\" | \"&\" => {\n switch (style) {\n case \"label\":\n return \".\";\n case \"matrix\":\n return \";\";\n case \"simple\":\n return \",\";\n default:\n return \"&\";\n }\n};\n\nexport const serializeArrayParam = ({\n allowReserved,\n explode,\n name,\n style,\n value,\n}: SerializeOptions<ArraySeparatorStyle> & {\n value: unknown[];\n}): string => {\n if (!explode) {\n const joinedValues = (\n allowReserved ? value : value.map((v) => encodeURIComponent(v as string))\n ).join(separatorArrayNoExplode(style));\n switch (style) {\n case \"label\":\n return `.${joinedValues}`;\n case \"matrix\":\n return `;${name}=${joinedValues}`;\n case \"simple\":\n return joinedValues;\n default:\n return `${name}=${joinedValues}`;\n }\n }\n\n const separator = separatorArrayExplode(style);\n const joinedValues = value\n .map((v) => {\n if (style === \"label\" || style === \"simple\") {\n return allowReserved ? v : encodeURIComponent(v as string);\n }\n\n return serializePrimitiveParam({\n allowReserved,\n name,\n value: v as string,\n });\n })\n .join(separator);\n return style === \"label\" || style === \"matrix\"\n ? separator + joinedValues\n : joinedValues;\n};\n\nexport const serializePrimitiveParam = ({\n allowReserved,\n name,\n value,\n}: SerializePrimitiveParam): string => {\n if (value === undefined || value === null) {\n return \"\";\n }\n\n if (typeof value === \"object\") {\n throw new Error(\n \"Deeply-nested arrays/objects aren’t supported. Provide your own `querySerializer()` to handle these.\",\n );\n }\n\n return `${name}=${allowReserved ? value : encodeURIComponent(value)}`;\n};\n\nexport const serializeObjectParam = ({\n allowReserved,\n explode,\n name,\n style,\n value,\n valueOnly,\n}: SerializeOptions<ObjectSeparatorStyle> & {\n value: Record<string, unknown> | Date;\n valueOnly?: boolean;\n}): string => {\n if (value instanceof Date) {\n return valueOnly ? value.toISOString() : `${name}=${value.toISOString()}`;\n }\n\n if (style !== \"deepObject\" && !explode) {\n let values: string[] = [];\n Object.entries(value).forEach(([key, v]) => {\n values = [\n ...values,\n key,\n allowReserved ? (v as string) : encodeURIComponent(v as string),\n ];\n });\n const joinedValues = values.join(\",\");\n switch (style) {\n case \"form\":\n return `${name}=${joinedValues}`;\n case \"label\":\n return `.${joinedValues}`;\n case \"matrix\":\n return `;${name}=${joinedValues}`;\n default:\n return joinedValues;\n }\n }\n\n const separator = separatorObjectExplode(style);\n const joinedValues = Object.entries(value)\n .map(([key, v]) =>\n serializePrimitiveParam({\n allowReserved,\n name: style === \"deepObject\" ? `${name}[${key}]` : key,\n value: v as string,\n }),\n )\n .join(separator);\n return style === \"label\" || style === \"matrix\"\n ? separator + joinedValues\n : joinedValues;\n};\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { BodySerializer, QuerySerializer } from \"./bodySerializer.gen.js\";\nimport {\n type ArraySeparatorStyle,\n serializeArrayParam,\n serializeObjectParam,\n serializePrimitiveParam,\n} from \"./pathSerializer.gen.js\";\n\nexport interface PathSerializer {\n path: Record<string, unknown>;\n url: string;\n}\n\nexport const PATH_PARAM_RE: RegExp = /\\{[^{}]+\\}/g;\n\nexport const defaultPathSerializer = ({\n path,\n url: _url,\n}: PathSerializer): string => {\n let url = _url;\n const matches = _url.match(PATH_PARAM_RE);\n if (matches) {\n for (const match of matches) {\n let explode = false;\n let name = match.substring(1, match.length - 1);\n let style: ArraySeparatorStyle = \"simple\";\n\n if (name.endsWith(\"*\")) {\n explode = true;\n name = name.substring(0, name.length - 1);\n }\n\n if (name.startsWith(\".\")) {\n name = name.substring(1);\n style = \"label\";\n } else if (name.startsWith(\";\")) {\n name = name.substring(1);\n style = \"matrix\";\n }\n\n const value = path[name];\n\n if (value === undefined || value === null) {\n continue;\n }\n\n if (Array.isArray(value)) {\n url = url.replace(\n match,\n serializeArrayParam({ explode, name, style, value }),\n );\n continue;\n }\n\n if (typeof value === \"object\") {\n url = url.replace(\n match,\n serializeObjectParam({\n explode,\n name,\n style,\n value: value as Record<string, unknown>,\n valueOnly: true,\n }),\n );\n continue;\n }\n\n if (style === \"matrix\") {\n url = url.replace(\n match,\n `;${serializePrimitiveParam({\n name,\n value: value as string,\n })}`,\n );\n continue;\n }\n\n const replaceValue = encodeURIComponent(\n style === \"label\" ? `.${value as string}` : (value as string),\n );\n url = url.replace(match, replaceValue);\n }\n }\n return url;\n};\n\nexport const getUrl = ({\n baseUrl,\n path,\n query,\n querySerializer,\n url: _url,\n}: {\n baseUrl?: string;\n path?: Record<string, unknown>;\n query?: Record<string, unknown>;\n querySerializer: QuerySerializer;\n url: string;\n}): string => {\n const pathUrl = _url.startsWith(\"/\") ? _url : `/${_url}`;\n let url = (baseUrl ?? \"\") + pathUrl;\n if (path) {\n url = defaultPathSerializer({ path, url });\n }\n let search = query ? querySerializer(query) : \"\";\n if (search.startsWith(\"?\")) {\n search = search.substring(1);\n }\n if (search) {\n url += `?${search}`;\n }\n return url;\n};\n\nexport function getValidRequestBody(options: {\n body?: unknown;\n bodySerializer?: BodySerializer | null;\n serializedBody?: unknown;\n}): unknown {\n const hasBody = options.body !== undefined;\n const isSerializedBody = hasBody && options.bodySerializer;\n\n if (isSerializedBody) {\n if (\"serializedBody\" in options) {\n const hasSerializedBody =\n options.serializedBody !== undefined && options.serializedBody !== \"\";\n\n return hasSerializedBody ? options.serializedBody : null;\n }\n\n // not all clients implement a serializedBody property (i.e., client-axios)\n return options.body !== \"\" ? options.body : null;\n }\n\n // plain/text body\n if (hasBody) {\n return options.body;\n }\n\n // no body was provided\n return undefined;\n}\n","// This file is auto-generated by @hey-api/openapi-ts\n\nexport type AuthToken = string | undefined;\n\nexport interface Auth {\n /**\n * Which part of the request do we use to send the auth?\n *\n * @default 'header'\n */\n in?: \"header\" | \"query\" | \"cookie\";\n /**\n * A unique identifier for the security scheme.\n *\n * Defined only when there are multiple security schemes whose `Auth`\n * shape would otherwise be identical.\n */\n key?: string;\n /**\n * Header or query parameter name.\n *\n * @default 'Authorization'\n */\n name?: string;\n scheme?: \"basic\" | \"bearer\";\n type: \"apiKey\" | \"http\";\n}\n\nexport const getAuthToken = async (\n auth: Auth,\n callback: ((auth: Auth) => Promise<AuthToken> | AuthToken) | AuthToken,\n): Promise<string | undefined> => {\n const token =\n typeof callback === \"function\" ? await callback(auth) : callback;\n\n if (!token) {\n return;\n }\n\n if (auth.scheme === \"bearer\") {\n return `Bearer ${token}`;\n }\n\n if (auth.scheme === \"basic\") {\n return `Basic ${btoa(token)}`;\n }\n\n return token;\n};\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport { getAuthToken } from \"../core/auth.gen.js\";\nimport type { QuerySerializerOptions } from \"../core/bodySerializer.gen.js\";\nimport { jsonBodySerializer } from \"../core/bodySerializer.gen.js\";\nimport {\n serializeArrayParam,\n serializeObjectParam,\n serializePrimitiveParam,\n} from \"../core/pathSerializer.gen.js\";\nimport { getUrl } from \"../core/utils.gen.js\";\nimport type {\n Client,\n ClientOptions,\n Config,\n RequestOptions,\n} from \"./types.gen.js\";\n\nexport const createQuerySerializer = <T = unknown>({\n parameters = {},\n ...args\n}: QuerySerializerOptions = {}): ((queryParams: T) => string) => {\n const querySerializer = (queryParams: T): string => {\n const search: string[] = [];\n if (queryParams && typeof queryParams === \"object\") {\n for (const name in queryParams) {\n const value = queryParams[name];\n\n if (value === undefined || value === null) {\n continue;\n }\n\n const options = parameters[name] || args;\n\n if (Array.isArray(value)) {\n const serializedArray = serializeArrayParam({\n allowReserved: options.allowReserved,\n explode: true,\n name,\n style: \"form\",\n value,\n ...options.array,\n });\n if (serializedArray) search.push(serializedArray);\n } else if (typeof value === \"object\") {\n const serializedObject = serializeObjectParam({\n allowReserved: options.allowReserved,\n explode: true,\n name,\n style: \"deepObject\",\n value: value as Record<string, unknown>,\n ...options.object,\n });\n if (serializedObject) search.push(serializedObject);\n } else {\n const serializedPrimitive = serializePrimitiveParam({\n allowReserved: options.allowReserved,\n name,\n value: value as string,\n });\n if (serializedPrimitive) search.push(serializedPrimitive);\n }\n }\n }\n return search.join(\"&\");\n };\n return querySerializer;\n};\n\n/**\n * Infers parseAs value from provided Content-Type header.\n */\nexport const getParseAs = (\n contentType: string | null,\n): Exclude<Config[\"parseAs\"], \"auto\"> => {\n if (!contentType) {\n // If no Content-Type header is provided, the best we can do is return the raw response body,\n // which is effectively the same as the 'stream' option.\n return \"stream\";\n }\n\n const cleanContent = contentType.split(\";\")[0]?.trim();\n\n if (!cleanContent) {\n return;\n }\n\n if (\n cleanContent.startsWith(\"application/json\") ||\n cleanContent.endsWith(\"+json\")\n ) {\n return \"json\";\n }\n\n if (cleanContent === \"multipart/form-data\") {\n return \"formData\";\n }\n\n if (\n [\"application/\", \"audio/\", \"image/\", \"video/\"].some((type) =>\n cleanContent.startsWith(type),\n )\n ) {\n return \"blob\";\n }\n\n if (cleanContent.startsWith(\"text/\")) {\n return \"text\";\n }\n\n return;\n};\n\nconst checkForExistence = (\n options: Pick<RequestOptions, \"auth\" | \"query\"> & {\n headers: Headers;\n },\n name?: string,\n): boolean => {\n if (!name) {\n return false;\n }\n if (\n options.headers.has(name) ||\n options.query?.[name] ||\n options.headers.get(\"Cookie\")?.includes(`${name}=`)\n ) {\n return true;\n }\n return false;\n};\n\nexport async function setAuthParams(\n options: Pick<RequestOptions, \"auth\" | \"query\" | \"security\"> & {\n headers: Headers;\n },\n): Promise<void> {\n for (const auth of options.security ?? []) {\n if (checkForExistence(options, auth.name)) {\n continue;\n }\n\n const token = await getAuthToken(auth, options.auth);\n\n if (!token) {\n continue;\n }\n\n const name = auth.name ?? \"Authorization\";\n\n switch (auth.in) {\n case \"query\":\n if (!options.query) {\n options.query = {};\n }\n options.query[name] = token;\n break;\n case \"cookie\":\n options.headers.append(\"Cookie\", `${name}=${token}`);\n break;\n case \"header\":\n default:\n options.headers.set(name, token);\n break;\n }\n }\n}\n\nexport const buildUrl: Client[\"buildUrl\"] = (options) =>\n getUrl({\n baseUrl: options.baseUrl as string,\n path: options.path,\n query: options.query,\n querySerializer:\n typeof options.querySerializer === \"function\"\n ? options.querySerializer\n : createQuerySerializer(options.querySerializer),\n url: options.url,\n });\n\nexport const mergeConfigs = (a: Config, b: Config): Config => {\n const config = { ...a, ...b };\n if (config.baseUrl?.endsWith(\"/\")) {\n config.baseUrl = config.baseUrl.substring(0, config.baseUrl.length - 1);\n }\n config.headers = mergeHeaders(a.headers, b.headers);\n return config;\n};\n\nconst headersEntries = (headers: Headers): Array<[string, string]> => {\n const entries: Array<[string, string]> = [];\n headers.forEach((value, key) => {\n entries.push([key, value]);\n });\n return entries;\n};\n\nexport const mergeHeaders = (\n ...headers: Array<Required<Config>[\"headers\"] | undefined>\n): Headers => {\n const mergedHeaders = new Headers();\n for (const header of headers) {\n if (!header) {\n continue;\n }\n\n const iterator =\n header instanceof Headers\n ? headersEntries(header)\n : Object.entries(header);\n\n for (const [key, value] of iterator) {\n if (value === null) {\n mergedHeaders.delete(key);\n } else if (Array.isArray(value)) {\n for (const v of value) {\n mergedHeaders.append(key, v as string);\n }\n } else if (value !== undefined) {\n // assume object headers are meant to be JSON stringified, i.e., their\n // content value in OpenAPI specification is 'application/json'\n mergedHeaders.set(\n key,\n typeof value === \"object\" ? JSON.stringify(value) : (value as string),\n );\n }\n }\n }\n return mergedHeaders;\n};\n\ntype ErrInterceptor<Err, Res, Req, Options> = (\n error: Err,\n /** response may be undefined due to a network error where no response object is produced */\n response: Res | undefined,\n /** request may be undefined, because error may be from building the request object itself */\n request: Req | undefined,\n options: Options,\n) => Err | Promise<Err>;\n\ntype ReqInterceptor<Req, Options> = (\n request: Req,\n options: Options,\n) => Req | Promise<Req>;\n\ntype ResInterceptor<Res, Req, Options> = (\n response: Res,\n request: Req,\n options: Options,\n) => Res | Promise<Res>;\n\nclass Interceptors<Interceptor> {\n fns: Array<Interceptor | null> = [];\n\n clear(): void {\n this.fns = [];\n }\n\n eject(id: number | Interceptor): void {\n const index = this.getInterceptorIndex(id);\n if (this.fns[index]) {\n this.fns[index] = null;\n }\n }\n\n exists(id: number | Interceptor): boolean {\n const index = this.getInterceptorIndex(id);\n return Boolean(this.fns[index]);\n }\n\n getInterceptorIndex(id: number | Interceptor): number {\n if (typeof id === \"number\") {\n return this.fns[id] ? id : -1;\n }\n return this.fns.indexOf(id);\n }\n\n update(\n id: number | Interceptor,\n fn: Interceptor,\n ): number | Interceptor | false {\n const index = this.getInterceptorIndex(id);\n if (this.fns[index]) {\n this.fns[index] = fn;\n return id;\n }\n return false;\n }\n\n use(fn: Interceptor): number {\n this.fns.push(fn);\n return this.fns.length - 1;\n }\n}\n\nexport interface Middleware<Req, Res, Err, Options> {\n error: Interceptors<ErrInterceptor<Err, Res, Req, Options>>;\n request: Interceptors<ReqInterceptor<Req, Options>>;\n response: Interceptors<ResInterceptor<Res, Req, Options>>;\n}\n\nexport const createInterceptors = <Req, Res, Err, Options>(): Middleware<\n Req,\n Res,\n Err,\n Options\n> => ({\n error: new Interceptors<ErrInterceptor<Err, Res, Req, Options>>(),\n request: new Interceptors<ReqInterceptor<Req, Options>>(),\n response: new Interceptors<ResInterceptor<Res, Req, Options>>(),\n});\n\nconst defaultQuerySerializer = createQuerySerializer({\n allowReserved: false,\n array: {\n explode: true,\n style: \"form\",\n },\n object: {\n explode: true,\n style: \"deepObject\",\n },\n});\n\nconst defaultHeaders = {\n \"Content-Type\": \"application/json\",\n};\n\nexport const createConfig = <T extends ClientOptions = ClientOptions>(\n override: Config<Omit<ClientOptions, keyof T> & T> = {},\n): Config<Omit<ClientOptions, keyof T> & T> => ({\n ...jsonBodySerializer,\n headers: defaultHeaders,\n parseAs: \"auto\",\n querySerializer: defaultQuerySerializer,\n ...override,\n});\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport { createSseClient } from \"../core/serverSentEvents.gen.js\";\nimport type { HttpMethod } from \"../core/types.gen.js\";\nimport { getValidRequestBody } from \"../core/utils.gen.js\";\nimport type {\n Client,\n Config,\n RequestOptions,\n ResolvedRequestOptions,\n} from \"./types.gen.js\";\nimport {\n buildUrl,\n createConfig,\n createInterceptors,\n getParseAs,\n mergeConfigs,\n mergeHeaders,\n setAuthParams,\n} from \"./utils.gen.js\";\n\ntype ReqInit = Omit<RequestInit, \"body\" | \"headers\"> & {\n body?: any;\n headers: ReturnType<typeof mergeHeaders>;\n};\n\nexport const createClient = (config: Config = {}): Client => {\n let _config = mergeConfigs(createConfig(), config);\n\n const getConfig = (): Config => ({ ..._config });\n\n const setConfig = (config: Config): Config => {\n _config = mergeConfigs(_config, config);\n return getConfig();\n };\n\n const interceptors = createInterceptors<\n Request,\n Response,\n unknown,\n ResolvedRequestOptions\n >();\n\n const beforeRequest = async <\n TData = unknown,\n TResponseStyle extends \"data\" | \"fields\" = \"fields\",\n ThrowOnError extends boolean = boolean,\n Url extends string = string,\n >(\n options: RequestOptions<TData, TResponseStyle, ThrowOnError, Url>,\n ) => {\n const opts = {\n ..._config,\n ...options,\n fetch: options.fetch ?? _config.fetch ?? globalThis.fetch,\n headers: mergeHeaders(_config.headers, options.headers),\n serializedBody: undefined as string | undefined,\n };\n\n if (opts.security) {\n await setAuthParams(opts);\n }\n\n if (opts.requestValidator) {\n await opts.requestValidator(opts);\n }\n\n if (opts.body !== undefined && opts.bodySerializer) {\n opts.serializedBody = opts.bodySerializer(opts.body) as\n | string\n | undefined;\n }\n\n // remove Content-Type header if body is empty to avoid sending invalid requests\n if (opts.body === undefined || opts.serializedBody === \"\") {\n opts.headers.delete(\"Content-Type\");\n }\n\n const resolvedOpts = opts as typeof opts &\n ResolvedRequestOptions<TResponseStyle, ThrowOnError, Url>;\n const url = buildUrl(resolvedOpts);\n\n return { opts: resolvedOpts, url };\n };\n\n const request: Client[\"request\"] = async (options) => {\n const throwOnError = options.throwOnError ?? _config.throwOnError;\n const responseStyle = options.responseStyle ?? _config.responseStyle;\n\n let request: Request | undefined;\n let response: Response | undefined;\n\n try {\n const { opts, url } = await beforeRequest(options);\n const requestInit: ReqInit = {\n redirect: \"follow\",\n ...opts,\n body: getValidRequestBody(opts),\n };\n\n request = new Request(url, requestInit);\n\n for (const fn of interceptors.request.fns) {\n if (fn) {\n request = await fn(request, opts);\n }\n }\n\n // fetch must be assigned here, otherwise it would throw the error:\n // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation\n const _fetch = opts.fetch!;\n\n response = await _fetch(request);\n\n for (const fn of interceptors.response.fns) {\n if (fn) {\n response = await fn(response, request, opts);\n }\n }\n\n const result = {\n request,\n response,\n };\n\n if (response.ok) {\n const parseAs =\n (opts.parseAs === \"auto\"\n ? getParseAs(response.headers.get(\"Content-Type\"))\n : opts.parseAs) ?? \"json\";\n\n if (\n response.status === 204 ||\n response.headers.get(\"Content-Length\") === \"0\"\n ) {\n let emptyData: any;\n switch (parseAs) {\n case \"arrayBuffer\":\n case \"blob\":\n case \"text\":\n emptyData = await response[parseAs]();\n break;\n case \"formData\":\n emptyData = new FormData();\n break;\n case \"stream\":\n emptyData = response.body;\n break;\n case \"json\":\n default:\n emptyData = {};\n break;\n }\n return opts.responseStyle === \"data\"\n ? emptyData\n : {\n data: emptyData,\n ...result,\n };\n }\n\n let data: any;\n switch (parseAs) {\n case \"arrayBuffer\":\n case \"blob\":\n case \"formData\":\n case \"text\":\n data = await response[parseAs]();\n break;\n case \"json\": {\n // Some servers return 200 with no Content-Length and empty body.\n // response.json() would throw; read as text and parse if non-empty.\n const text = await response.text();\n data = text ? JSON.parse(text) : {};\n break;\n }\n case \"stream\":\n return opts.responseStyle === \"data\"\n ? response.body\n : {\n data: response.body,\n ...result,\n };\n }\n\n if (parseAs === \"json\") {\n if (opts.responseValidator) {\n await opts.responseValidator(data);\n }\n\n if (opts.responseTransformer) {\n data = await opts.responseTransformer(data);\n }\n }\n\n return opts.responseStyle === \"data\"\n ? data\n : {\n data,\n ...result,\n };\n }\n\n const textError = await response.text();\n let jsonError: unknown;\n\n try {\n jsonError = JSON.parse(textError);\n } catch {\n // noop\n }\n\n throw jsonError ?? textError;\n } catch (error) {\n let finalError = error;\n\n for (const fn of interceptors.error.fns) {\n if (fn) {\n finalError = await fn(\n finalError,\n response,\n request,\n options as ResolvedRequestOptions,\n );\n }\n }\n\n finalError = finalError || {};\n\n if (throwOnError) {\n throw finalError;\n }\n\n // TODO: we probably want to return error and improve types\n return responseStyle === \"data\"\n ? undefined\n : {\n error: finalError,\n request,\n response,\n };\n }\n };\n\n const makeMethodFn =\n (method: Uppercase<HttpMethod>) => (options: RequestOptions) =>\n request({ ...options, method });\n\n const makeSseFn =\n (method: Uppercase<HttpMethod>) => async (options: RequestOptions) => {\n const { opts, url } = await beforeRequest(options);\n return createSseClient({\n ...opts,\n body: opts.body as BodyInit | null | undefined,\n method,\n onRequest: async (url, init) => {\n let request = new Request(url, init);\n for (const fn of interceptors.request.fns) {\n if (fn) {\n request = await fn(request, opts);\n }\n }\n return request;\n },\n serializedBody: getValidRequestBody(opts) as\n | BodyInit\n | null\n | undefined,\n url,\n });\n };\n\n const _buildUrl: Client[\"buildUrl\"] = (options) =>\n buildUrl({ ..._config, ...options });\n\n return {\n buildUrl: _buildUrl,\n connect: makeMethodFn(\"CONNECT\"),\n delete: makeMethodFn(\"DELETE\"),\n get: makeMethodFn(\"GET\"),\n getConfig,\n head: makeMethodFn(\"HEAD\"),\n interceptors,\n options: makeMethodFn(\"OPTIONS\"),\n patch: makeMethodFn(\"PATCH\"),\n post: makeMethodFn(\"POST\"),\n put: makeMethodFn(\"PUT\"),\n request,\n setConfig,\n sse: {\n connect: makeSseFn(\"CONNECT\"),\n delete: makeSseFn(\"DELETE\"),\n get: makeSseFn(\"GET\"),\n head: makeSseFn(\"HEAD\"),\n options: makeSseFn(\"OPTIONS\"),\n patch: makeSseFn(\"PATCH\"),\n post: makeSseFn(\"POST\"),\n put: makeSseFn(\"PUT\"),\n trace: makeSseFn(\"TRACE\"),\n },\n trace: makeMethodFn(\"TRACE\"),\n } as Client;\n};\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport {\n type Client,\n type ClientOptions,\n type Config,\n createClient,\n createConfig,\n} from \"./client/index.js\";\nimport type { ClientOptions as ClientOptions2 } from \"./types.gen.js\";\n\n/**\n * The `createClientConfig()` function will be called on client initialization\n * and the returned object will become the client's initial configuration.\n *\n * You may want to initialize your client this way instead of calling\n * `setConfig()`. This is useful for example if you're using Next.js\n * to ensure your client always has the correct values.\n */\nexport type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (\n override?: Config<ClientOptions & T>,\n) => Config<Required<ClientOptions> & T>;\n\nexport const client: Client = createClient(createConfig<ClientOptions2>());\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport * as z from \"zod/v4\";\n\nimport { client } from \"./client.gen.js\";\nimport type {\n Client,\n Options as Options2,\n RequestResult,\n TDataShape,\n} from \"./client/index.js\";\nimport type {\n RecommendationsData,\n RecommendationsErrors,\n RecommendationsResponses,\n} from \"./types.gen.js\";\nimport { zRecommendationsBody, zRecommendationsResponse2 } from \"./zod.gen.js\";\n\nexport type Options<\n TData extends TDataShape = TDataShape,\n ThrowOnError extends boolean = boolean,\n TResponse = unknown,\n> = Options2<TData, ThrowOnError, TResponse> & {\n /**\n * You can provide a client instance returned by `createClient()` instead of\n * individual options. This might be also useful if you want to implement a\n * custom client.\n */\n client?: Client;\n /**\n * You can pass arbitrary values through the `meta` object. This can be\n * used to access values that aren't defined as part of the SDK function.\n */\n meta?: Record<string, unknown>;\n};\n\n/**\n * Recommendations\n *\n * Unified recommendations endpoint.\n *\n * Accepts scoped PUBLIC keys (PUBLISHER or PUBLISHER_CHANNEL link level) and\n * legacy partner API keys. The controller operates in channel mode when the\n * auth context wraps a CmosPublisherContext, direct mode otherwise.\n */\nexport const recommendations = <ThrowOnError extends boolean = false>(\n options: Options<RecommendationsData, ThrowOnError>,\n): RequestResult<\n RecommendationsResponses,\n RecommendationsErrors,\n ThrowOnError\n> =>\n (options.client ?? client).post<\n RecommendationsResponses,\n RecommendationsErrors,\n ThrowOnError\n >({\n requestValidator: async (data) =>\n await z\n .object({\n body: zRecommendationsBody,\n path: z.never().optional(),\n query: z.never().optional(),\n })\n .parseAsync(data),\n responseValidator: async (data) =>\n await zRecommendationsResponse2.parseAsync(data),\n security: [{ name: \"x-api-key\", type: \"apiKey\" }],\n url: \"/recommendations\",\n ...options,\n headers: {\n \"Content-Type\": \"application/json\",\n ...options.headers,\n },\n });\n","import {\n createClient,\n createConfig,\n type Client,\n} from \"./generated/recommendations/client/index.js\";\n\ntype RecommendationsClientConfig = {\n /**\n * Gateway base URL (root). The generated SDK appends the operation path\n * (`/recommendations`), so this must not include it. Resolve it from\n * `GATEWAY_BASE_URL` in `config.ts` for the caller's environment.\n */\n baseUrl: string;\n /**\n * Pre-built auth headers (e.g. `x-api-key`, `X-API-Version`). Build these\n * with `authHeaders()` from `config.ts`.\n */\n headers: Record<string, string>;\n /**\n * Override the `fetch` implementation. Defaults to `globalThis.fetch`.\n * Primarily useful in tests and non-standard runtimes.\n */\n fetch?: typeof fetch;\n};\n\n/**\n * Build a dedicated, per-instance recommendations transport client from an\n * already-resolved base URL and auth headers. This is intentionally a pure\n * transport factory: environment derivation and header construction are the\n * caller's responsibility (see `env.ts` / `config.ts`), so there is a single\n * owner of key → env → config resolution rather than one per client.\n *\n * Pass the returned client to the generated `recommendations()` SDK function\n * via its `client` option, e.g.:\n *\n * ```ts\n * const env = envFromApiKey(apiKey);\n * const client = createRecommendationsClient({\n * baseUrl: GATEWAY_BASE_URL[env],\n * headers: authHeaders({ apiKey }),\n * });\n * await recommendations({ client, body, throwOnError: true });\n * ```\n *\n * A per-instance client (rather than the SDK's shared global singleton) keeps\n * each key's base URL and auth isolated, so multiple clients can coexist.\n */\nexport function createRecommendationsClient(\n config: RecommendationsClientConfig,\n): Client {\n return createClient(\n createConfig({\n baseUrl: config.baseUrl,\n headers: config.headers,\n ...(config.fetch ? { fetch: config.fetch } : {}),\n }),\n );\n}\n","import type { DiscoEnv } from \"./env.js\";\n\n/**\n * Per-environment base URL for the partners API gateway. Both the\n * recommendations and events services sit behind this single origin, routed by\n * path. This is the gateway **root** — callers/SDKs append the operation path\n * (`/recommendations`, `/events`), so it must not be included here.\n *\n * Single source of truth for the external gateway hostnames; consumers\n * ({@link DiscoClient}, the generated recommendations client) derive their URLs\n * from this rather than hard-coding their own.\n */\nexport const GATEWAY_BASE_URL = {\n production: \"https://partners.disconetwork.com\",\n staging: \"https://partners.disconetwork-staging.com\",\n} as const satisfies Record<DiscoEnv, string>;\n\n/**\n * Default value for the required `X-API-Version` header. Overridable per client\n * via `apiVersion`.\n */\nconst DEFAULT_API_VERSION = \"1.0.0\";\n\n/**\n * Build the auth headers the partners gateway requires from a scoped public API\n * key. The `X-API-Version` defaults to {@link DEFAULT_API_VERSION}.\n */\nexport function authHeaders(config: { apiKey: string; apiVersion?: string }): {\n \"x-api-key\": string;\n \"X-API-Version\": string;\n} {\n return {\n \"x-api-key\": config.apiKey,\n \"X-API-Version\": config.apiVersion ?? DEFAULT_API_VERSION,\n };\n}\n","import { ZodError } from \"zod/v4\";\nimport { recommendations } from \"../api/generated/recommendations/index.js\";\nimport type { Client } from \"../api/generated/recommendations/client/index.js\";\nimport { createRecommendationsClient } from \"../api/index.js\";\nimport { authHeaders, GATEWAY_BASE_URL } from \"../config.js\";\nimport { envFromApiKey } from \"../env.js\";\nimport {\n DiscoApiError,\n DiscoNetworkError,\n DiscoValidationError,\n isAbortError,\n} from \"../errors.js\";\nimport type {\n RecommendationsRequest,\n RecommendationsResponse,\n} from \"./recommendations.js\";\nimport {\n transformRequest,\n transformResponse,\n} from \"./recommendationsTransforms.js\";\nimport { TrackingManager, type EventTracker } from \"../TrackingManager.js\";\n\n/**\n * Authenticate with a scoped public API key (`disco_pk_live_…` /\n * `disco_pk_sandbox_…`). The prefix selects the environment, so there is no\n * separate `env` to set.\n */\nexport type DiscoClientConfig = {\n apiKey: string;\n /**\n * Value for the required `X-API-Version` header. Defaults to\n * `DEFAULT_API_VERSION` (see `config.ts`).\n */\n apiVersion?: string;\n fetch?: typeof fetch;\n};\n\nexport type GetRecommendationsOptions = {\n /** Forwarded to `fetch` so consumers can cancel in-flight requests. */\n signal?: AbortSignal;\n};\n\nexport type CreateTrackingManagerOptions = {\n /** Override the fetch used by the tracker. Defaults to the client's fetch. */\n fetch?: typeof fetch;\n};\n\n/**\n * Result of `getRecommendationsWithTracker`: the mapped response plus a tracker\n * already bound to its session.\n */\nexport type RecommendationsWithTracker = {\n data: RecommendationsResponse;\n tracker: EventTracker;\n};\n\n/**\n * Typed client for the Disco recommendations API — calls\n * `disco-recommendations-api` **directly** (no proxy) at\n * `partners.disconetwork(-staging).com/recommendations`.\n *\n * This is the recommended, partner-facing client. It maps the friendly\n * camelCase request into the rec-api wire body (sending `x-api-key` +\n * `X-API-Version`) and recases the response into camelCase.\n * Validation is performed by the generated SDK. The wire\n * format is fully encapsulated.\n *\n * Renderer-agnostic: plain HTTP, no React dependency.\n */\nexport class DiscoClient {\n readonly #recommendationsClient: Client;\n readonly #eventsUrl: string;\n readonly #apiKey: string;\n readonly #fetch: typeof fetch;\n\n constructor(config: DiscoClientConfig) {\n const env = envFromApiKey(config.apiKey);\n this.#apiKey = config.apiKey;\n this.#eventsUrl = `${GATEWAY_BASE_URL[env]}/events`;\n this.#fetch = config.fetch ?? globalThis.fetch.bind(globalThis);\n this.#recommendationsClient = createRecommendationsClient({\n baseUrl: GATEWAY_BASE_URL[env],\n headers: authHeaders(config),\n fetch: this.#fetch,\n });\n }\n\n /**\n * Fetch recommendations for the given request.\n *\n * Maps the request to the wire body, POSTs it, then recases the response to\n * camelCase (keeping the API's normalized shape). The generated SDK validates\n * both sides. Throws `DiscoValidationError` on a request/response schema\n * failure, `DiscoApiError` on a non-2xx response, and `DiscoNetworkError` if\n * the request can't reach the server. An aborted request rejects with the\n * native `AbortError`.\n */\n getRecommendations = async (\n request: RecommendationsRequest,\n options?: GetRecommendationsOptions,\n ): Promise<RecommendationsResponse> => {\n // `transformRequest` maps the camelCase request to the wire body; the\n // generated SDK validates both request and response.\n // Not destructured: the result is a discriminated union on `error`, so\n // accessing fields off `result` lets TS narrow `result.data` to a defined\n // response once the error/non-2xx branches have thrown.\n const result = await recommendations({\n client: this.#recommendationsClient,\n body: transformRequest(request),\n signal: options?.signal,\n });\n\n if (result.response && !result.response.ok) {\n throw new DiscoApiError(\n `Recommendations request failed: ${result.response.status} ${result.response.statusText}`,\n {\n status: result.response.status,\n statusText: result.response.statusText,\n body: result.error,\n },\n );\n }\n\n if (result.error) {\n // A ZodError means the generated validator rejected the request or\n // response.\n if (result.error instanceof ZodError) {\n throw new DiscoValidationError(\n \"Failed to validate recommendations payload\",\n result.error,\n result.data,\n );\n }\n // A cancellation propagates as-is; any other transport failure (network,\n // DNS, timeout) is wrapped so it's catchable as a `DiscoError`.\n if (isAbortError(result.error)) throw result.error;\n throw new DiscoNetworkError(\n \"Recommendations request failed to reach the server\",\n result.error,\n );\n }\n\n return transformResponse(result.data);\n };\n\n /**\n * Fetch recommendations and create a session-bound events tracker in one\n * call. The tracker inherits this client's API key and environment.\n */\n getRecommendationsWithTracker = async (\n request: RecommendationsRequest,\n options?: GetRecommendationsOptions & CreateTrackingManagerOptions,\n ): Promise<RecommendationsWithTracker> => {\n const data = await this.getRecommendations(request, {\n signal: options?.signal,\n });\n const tracker = this.createTrackingManager(data.sessionId, {\n fetch: options?.fetch,\n });\n return { data, tracker };\n };\n\n /**\n * Create an events tracker bound to a recommendations session (the\n * `sessionId` from a `getRecommendations` response). Posts to the external\n * `/events` endpoint with this client's `x-api-key`.\n */\n createTrackingManager = (\n sessionId: string,\n options?: CreateTrackingManagerOptions,\n ): EventTracker =>\n new TrackingManager({\n sessionId,\n endpoint: this.#eventsUrl,\n headers: { \"x-api-key\": this.#apiKey },\n fetch: options?.fetch ?? this.#fetch,\n });\n}\n"],"mappings":"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"}
@@ -0,0 +1,208 @@
1
+ import { C as OfferCtaDetails, S as OfferAsset, _ as ProductProperties, a as EventTracker, b as Footer, c as BrandClickInitiatingTarget, d as BrandVisibilityEventType, f as ElementClickInitiatingTarget, g as ProductEventType, h as ProductDisplayInitiatingTarget, i as DiscoValidationError, l as BrandDisplayInitiatingTarget, m as EventPlacementDetails, n as DiscoError, o as TrackingManager, p as EventPayload, r as DiscoNetworkError, s as TrackingManagerConfig, t as DiscoApiError, u as BrandProperties, v as WidgetEventType, w as OfferDisclosureDetails, x as Offer, y as Advertiser } from "./errors-C-xomnpl.js";
2
+
3
+ //#region src/env.d.ts
4
+ type DiscoEnv = "production" | "staging";
5
+ /**
6
+ * Derive the environment from a Disco public API key.
7
+ *
8
+ * Public keys are prefixed `disco_pk_<env>_…`, where `<env>` is `live`
9
+ * (→ production) or `sandbox` (→ staging). The key is the single source
10
+ * of truth for which backend the SDK talks to — there is no separate
11
+ * `env` to pass or keep in sync, and a `live` key can't be pointed at
12
+ * staging (or vice versa).
13
+ *
14
+ * Throws on anything that isn't a recognized public key — including a
15
+ * secret (`disco_sk_…`) key, which must never be used in browser code.
16
+ */
17
+ declare function envFromApiKey(apiKey: string): DiscoEnv;
18
+ //#endregion
19
+ //#region src/internal/recommendations.d.ts
20
+ type RecommendationsRequest = {
21
+ user?: UserDetails;
22
+ placement?: PlacementDetails;
23
+ order?: OrderDetails;
24
+ purchases?: Purchase[];
25
+ experiments?: RunningExperiment[];
26
+ attributes?: Record<string, unknown>;
27
+ /**
28
+ * Additional top-level fields passed through to the API unchanged.
29
+ * Use for platform-specific extensions (e.g. `shopify_checkout_token`).
30
+ * Keys here are not transformed — provide them in whatever case the
31
+ * backend expects.
32
+ */
33
+ extras?: Record<string, unknown>;
34
+ };
35
+ type UserDetails = {
36
+ email?: string;
37
+ firstName?: string;
38
+ lastName?: string;
39
+ phone?: string;
40
+ };
41
+ type PlacementDetails = {
42
+ /** e.g. `"INLINE"`. Open-ended — see backend for supported values. */displayMode?: string; /** e.g. `"THANK_YOU"`, `"ORDER_STATUS"`. Open-ended. */
43
+ view?: string;
44
+ };
45
+ type OrderDetails = {
46
+ id?: string;
47
+ amount?: number | string;
48
+ currencyCode?: string;
49
+ };
50
+ type Purchase = {
51
+ name?: string;
52
+ type?: string;
53
+ variant?: string;
54
+ quantity?: number;
55
+ productId?: string;
56
+ amount?: number;
57
+ currencyCode?: string;
58
+ };
59
+ type RunningExperiment = {
60
+ id: string;
61
+ variant: string;
62
+ };
63
+ type LayoutId = "SHOPIFY_NATIVE_LEAD_GEN" | "SHOPIFY_NATIVE_ESSENTIAL" | "SHOPIFY_NATIVE_COVER" | (string & {});
64
+ type RecommendationsResponse = {
65
+ sessionId: string;
66
+ layoutId: LayoutId;
67
+ recommendationGroups: RecommendationGroup[];
68
+ footer: Footer;
69
+ publisherCustomization: PublisherCustomization | null;
70
+ };
71
+ type RecommendationGroup = {
72
+ heading: string | null;
73
+ slotContext: "HERO" | "SCROLLABLE" | (string & {});
74
+ recommendations: Recommendation[];
75
+ };
76
+ /**
77
+ * A single recommendation within a denormalized group. Differs from the
78
+ * external `Recommendation` (`{ advertiser, offer }`): the internal one is the
79
+ * join result, so it also carries the offer-derived `id` and the group entry's
80
+ * `insertionId`. The `advertiser` / `offer` leaves are the external types.
81
+ */
82
+ type Recommendation = {
83
+ id: string;
84
+ insertionId: string;
85
+ advertiser: Advertiser;
86
+ offer: Offer;
87
+ };
88
+ /**
89
+ * Publisher-configured copy / overrides. Keyed first by surface type
90
+ * (`checkout`, `upfront`, …) and then by opaque server-defined keys —
91
+ * see `applyCustomizationOrFallback` consumer-side helpers.
92
+ *
93
+ * Inner keys remain snake_case because they're identifiers, not
94
+ * JavaScript field names.
95
+ */
96
+ type PublisherCustomization = {
97
+ checkout?: Record<string, string>;
98
+ upfront?: Record<string, string>;
99
+ } & Record<string, Record<string, string> | undefined>;
100
+ //#endregion
101
+ //#region src/internal/InternalDiscoClient.d.ts
102
+ /**
103
+ * Authenticate with a scoped public API key. Sent as the `x-api-key`
104
+ * header against the unified `/core/recommendations/` endpoint. The key
105
+ * prefix (`disco_pk_live_` / `disco_pk_sandbox_`) determines the
106
+ * environment, so there is no separate `env` to set.
107
+ *
108
+ * Use this from partner apps and server-side code that hold a key.
109
+ */
110
+ type ApiKeyConfig = {
111
+ apiKey: string;
112
+ fetch?: typeof fetch;
113
+ };
114
+ /**
115
+ * Authenticate by Shopify shop — for surfaces that must not embed a key,
116
+ * notably the App-Store-deployed checkout extension. The request hits the
117
+ * `/core/recommendations/shop_gid/<id>/` proxy with **no** API key; the
118
+ * backend resolves the publisher from the shop and injects the key
119
+ * server-side.
120
+ *
121
+ * `env` is required here because, unlike `ApiKeyConfig`, there is no key
122
+ * to derive it from. `shopGid` may be a full `gid://shopify/Shop/<id>` or
123
+ * the bare id.
124
+ */
125
+ type ShopGidConfig = {
126
+ shopGid: string;
127
+ env: DiscoEnv;
128
+ fetch?: typeof fetch;
129
+ };
130
+ type DiscoClientConfig = ApiKeyConfig | ShopGidConfig;
131
+ type GetRecommendationsOptions = {
132
+ /** Forwarded to `fetch` so consumers can cancel in-flight requests. */signal?: AbortSignal;
133
+ };
134
+ type CreateTrackingManagerOptions = {
135
+ /**
136
+ * Override the fetch implementation used by the tracker. Defaults to the
137
+ * same fetch implementation configured on the client.
138
+ */
139
+ fetch?: typeof fetch;
140
+ };
141
+ /**
142
+ * Result of `getRecommendationsWithTracker`: the mapped recommendations
143
+ * response plus a tracker already bound to its session.
144
+ */
145
+ type RecommendationsWithTracker = {
146
+ /**
147
+ * The mapped, denormalized recommendations response — the same friendly
148
+ * camelCase shape `getRecommendations` returns.
149
+ */
150
+ data: RecommendationsResponse; /** Event tracker bound to this response's session. */
151
+ tracker: EventTracker;
152
+ };
153
+ /**
154
+ * Internal client for the legacy **proxy** recommendations endpoint
155
+ * (`/core/recommendations/` on the backend), which orchestrates placement,
156
+ * experiments, layout, and `publisher_customization` server-side and supports
157
+ * `shopGid` auth for first-party surfaces (e.g. the Shopify checkout
158
+ * extension).
159
+ *
160
+ * First-party / legacy only — exported from `@disconetwork/core/internal`.
161
+ * External partners use the `DiscoClient` from the package root, which talks
162
+ * directly to `disco-recommendations-api`.
163
+ *
164
+ * Renderer-agnostic: this class makes plain HTTP calls and has no React
165
+ * dependency.
166
+ */
167
+ declare class InternalDiscoClient {
168
+ #private;
169
+ constructor(config: DiscoClientConfig);
170
+ /**
171
+ * Fetch recommendations for the given request.
172
+ *
173
+ * Validates and transforms the friendly camelCase `request` into the wire
174
+ * body, POSTs it, then validates and denormalizes the response into the
175
+ * friendly `RecommendationsResponse`. The snake_case wire format is fully
176
+ * encapsulated — callers never see it.
177
+ *
178
+ * Throws `DiscoValidationError` if the request or response fails schema
179
+ * validation, `DiscoApiError` on non-2xx responses, and `DiscoNetworkError`
180
+ * if the request can't reach the server (an abort rejects with the native
181
+ * `AbortError`). Parse failures propagate as-is.
182
+ */
183
+ getRecommendations: (request: RecommendationsRequest, options?: GetRecommendationsOptions) => Promise<RecommendationsResponse>;
184
+ /**
185
+ * Fetch recommendations and create a session-bound tracker in one call.
186
+ *
187
+ * Composition convenience over `getRecommendations` + `createTrackingManager`:
188
+ * it derives the tracker's session from the response so callers don't have to
189
+ * thread the session id through themselves (and can't bind a tracker to the
190
+ * wrong session). The returned `data` is the mapped `RecommendationsResponse`.
191
+ *
192
+ * Throws `DiscoValidationError` / `DiscoApiError` the same as
193
+ * `getRecommendations`.
194
+ */
195
+ getRecommendationsWithTracker: (request: RecommendationsRequest, options?: GetRecommendationsOptions & CreateTrackingManagerOptions) => Promise<RecommendationsWithTracker>;
196
+ /**
197
+ * Create an event tracker bound to a recommendations session (the `sessionId`
198
+ * from a `getRecommendations` response).
199
+ *
200
+ * The tracker uses the same API-key-derived environment as the
201
+ * recommendations call, so sandbox recommendations cannot accidentally emit
202
+ * production tracking events.
203
+ */
204
+ createTrackingManager: (sessionId: string, options?: CreateTrackingManagerOptions) => EventTracker;
205
+ }
206
+ //#endregion
207
+ export { type Advertiser, type ApiKeyConfig, type BrandClickInitiatingTarget, type BrandDisplayInitiatingTarget, type BrandProperties, type BrandVisibilityEventType, type CreateTrackingManagerOptions, DiscoApiError, type DiscoClientConfig, type DiscoEnv, DiscoError, DiscoNetworkError, DiscoValidationError, type ElementClickInitiatingTarget, type EventPayload, type EventPlacementDetails, type EventTracker, type Footer, type GetRecommendationsOptions, InternalDiscoClient, type LayoutId, type Offer, type OfferAsset, type OfferCtaDetails, type OfferDisclosureDetails, type OrderDetails, type PlacementDetails, type ProductDisplayInitiatingTarget, type ProductEventType, type ProductProperties, type PublisherCustomization, type Purchase, type Recommendation, type RecommendationGroup, type RecommendationsRequest, type RecommendationsResponse, type RecommendationsWithTracker, type RunningExperiment, type ShopGidConfig, TrackingManager, type TrackingManagerConfig, type UserDetails, type WidgetEventType, envFromApiKey };
208
+ //# sourceMappingURL=internal.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"internal.d.ts","names":[],"sources":["../src/env.ts","../src/internal/recommendations.ts","../src/internal/InternalDiscoClient.ts"],"mappings":";;;KAAY,QAAA;;;AAAZ;;;;AAAoB;AAcpB;;;;AAAuD;iBAAvC,aAAA,CAAc,MAAA,WAAiB,QAAQ;;;KC2B3C,sBAAA;EACV,IAAA,GAAO,WAAA;EACP,SAAA,GAAY,gBAAA;EACZ,KAAA,GAAQ,YAAA;EACR,SAAA,GAAY,QAAA;EACZ,WAAA,GAAc,iBAAA;EACd,UAAA,GAAa,MAAA;EAAA;;;;;;EAOb,MAAA,GAAS,MAAA;AAAA;AAAA,KAGC,WAAA;EACV,KAAA;EACA,SAAA;EACA,QAAA;EACA,KAAA;AAAA;AAAA,KAGU,gBAAA;EAjBG,sEAmBb,WAAA,WAZS;EAcT,IAAI;AAAA;AAAA,KAGM,YAAA;EACV,EAAA;EACA,MAAA;EACA,YAAA;AAAA;AAAA,KAGU,QAAA;EACV,IAAA;EACA,IAAA;EACA,OAAA;EACA,QAAA;EACA,SAAA;EACA,MAAA;EACA,YAAA;AAAA;AAAA,KAGU,iBAAA;EACV,EAAA;EACA,OAAO;AAAA;AAAA,KAKG,QAAA;AAAA,KAOA,uBAAA;EACV,SAAA;EACA,QAAA,EAAU,QAAA;EACV,oBAAA,EAAsB,mBAAA;EACtB,MAAA,EAAQ,MAAA;EACR,sBAAA,EAAwB,sBAAA;AAAA;AAAA,KAGd,mBAAA;EACV,OAAA;EACA,WAAA;EACA,eAAA,EAAiB,cAAc;AAAA;;;;;;AA5BnB;KAqCF,cAAA;EACV,EAAA;EACA,WAAA;EACA,UAAA,EAAY,UAAA;EACZ,KAAA,EAAO,KAAK;AAAA;;;;AA/BM;AAOpB;;;;KAmCY,sBAAA;EACV,QAAA,GAAW,MAAA;EACX,OAAA,GAAU,MAAA;AAAA,IACR,MAAA,SAAe,MAAA;;;;;;AAlGnB;;;;;KCXY,YAAA;EACV,MAAA;EACA,KAAA,UAAe,KAAK;AAAA;;;;;;;;;;;;KAcV,aAAA;EACV,OAAA;EACA,GAAA,EAAK,QAAA;EACL,KAAA,UAAe,KAAK;AAAA;AAAA,KAGV,iBAAA,GAAoB,YAAA,GAAe,aAAa;AAAA,KAEhD,yBAAA;EDAK,uECEf,MAAA,GAAS,WAAW;AAAA;AAAA,KAGV,4BAAA;EDFW;;;;ECOrB,KAAA,UAAe,KAAK;AAAA;ADHf;AAGP;;;AAHO,KCUK,0BAAA;EDHN;AAGN;;;ECKE,IAAA,EAAM,uBAAA,EDJN;ECMA,OAAA,EAAS,YAAY;AAAA;;ADJT;AAGd;;;;;;;;;;;;cCkBa,mBAAA;EAAA;cAMC,MAAA,EAAQ,iBAAA;;;ADZb;AAKT;;;;AAAoB;AAOpB;;;;;ECgCE,kBAAA,GACE,OAAA,EAAS,sBAAA,EACT,OAAA,GAAU,yBAAA,KACT,OAAA,CAAQ,uBAAA;ED9Ba;;;;;;;;;;;EC0ExB,6BAAA,GACE,OAAA,EAAS,sBAAA,EACT,OAAA,GAAU,yBAAA,GAA4B,4BAAA,KACrC,OAAA,CAAQ,0BAAA;ED7EmC;AAAA;AAGhD;;;;;;EC4FE,qBAAA,GACE,SAAA,UACA,OAAA,GAAU,4BAAA,KACT,YAAA;AAAA"}