@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/TrackingManager-LjaX_R2V.js +851 -0
- package/dist/TrackingManager-LjaX_R2V.js.map +1 -0
- package/dist/errors-C-xomnpl.d.ts +408 -0
- package/dist/errors-C-xomnpl.d.ts.map +1 -0
- package/dist/index.d.ts +40 -376
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +728 -319
- package/dist/index.js.map +1 -1
- package/dist/internal.d.ts +208 -0
- package/dist/internal.d.ts.map +1 -0
- package/dist/internal.js +369 -0
- package/dist/internal.js.map +1 -0
- package/package.json +11 -2
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"TrackingManager-LjaX_R2V.js","names":["#endpoint","#headers","#sessionId","#fetch","#dedupe","#isDeduped","#toBody"],"sources":["../src/api/generated/recommendations/zod.gen.ts","../src/env.ts","../src/errors.ts","../src/lib/primitives.ts","../src/lib/case.ts","../src/external/recommendationsTransforms.ts","../src/TrackingManager.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport * as z from \"zod/v4\";\n\n/**\n * Address\n */\nexport const zAddress = z.object({\n address_line_1: z.string().nullish(),\n address_line_2: z.string().nullish(),\n city: z.string().nullish(),\n state: z.string().nullish(),\n zip: z.string().nullish(),\n phone: z.string().nullish(),\n country_code: z.string().nullish(),\n});\n\n/**\n * Advertiser\n */\nexport const zAdvertiser = z.object({\n id: z.uuid(),\n name: z.string(),\n logo_url: z.url().min(1),\n description: z.string().nullish(),\n});\n\n/**\n * AssetType\n */\nexport const zAssetType = z.enum([\"PRODUCT\", \"IMAGE\"]);\n\n/**\n * Asset\n */\nexport const zAsset = z.object({\n asset_type: zAssetType,\n image_url: z.url().min(1),\n insertion_order: z.int().gte(0),\n id: z.string().nullable(),\n target_url: z.url().min(1).nullish(),\n should_trigger_claim_flow: z.boolean().optional().default(false),\n});\n\n/**\n * AttributionDetails\n */\nexport const zAttributionDetails = z.object({\n copy: z.string(),\n disco_logo_url: z.url().min(1),\n target_url: z.url().min(1),\n});\n\n/**\n * CostDetails\n */\nexport const zCostDetails = z.object({\n amount: z.number().nullish(),\n currency_code: z.string().nullish(),\n});\n\n/**\n * CtaDetails\n */\nexport const zCtaDetails = z.object({\n accept_copy: z.string(),\n decline_copy: z.string(),\n transition_copy: z.string().nullish(),\n claimed_accept_copy: z.string().nullish(),\n claimed_decline_copy: z.string().nullish(),\n});\n\n/**\n * CustomMetadata\n */\nexport const zCustomMetadata = z.object({\n is_add_to_order_customer: z.boolean().nullish(),\n is_sports_betting_eligible: z.boolean().nullish(),\n is_fam: z.boolean().nullish(),\n is_student: z.boolean().nullish(),\n is_sandbox: z.boolean().nullish(),\n studio_id: z.string().nullish(),\n booking_for_self: z.boolean().nullish(),\n is_survey_present: z.boolean().nullish(),\n transaction_type: z.string().nullish(),\n inventory_type: z.string().nullish(),\n booking_datetime: z.iso.datetime().nullish(),\n booking_duration: z.string().nullish(),\n booking_follow_up_action: z.string().nullish(),\n booking_instructor_id: z.string().nullish(),\n pricing_type: z.string().nullish(),\n no_targeting: z.boolean().nullish(),\n no_functional: z.boolean().nullish(),\n registration_date: z.iso.datetime().nullish(),\n flow_session: z.string().nullish(),\n long_flow_session: z.string().nullish(),\n client_version: z.string().nullish(),\n sdk_version: z.string().nullish(),\n core_persona_id: z.int().nullish(),\n track_id: z.string().nullish(),\n shipping_method: z.string().nullish(),\n tracking_status: z.string().nullish(),\n customer_tier: z.string().nullish(),\n order_channel: z.string().nullish(),\n fulfillment_type: z.string().nullish(),\n narvar_session_id: z.string().nullish(),\n delivery_minutes: z.string().nullish(),\n});\n\n/**\n * DisclosureDetails\n */\nexport const zDisclosureDetails = z.object({\n copy: z.string(),\n target_url: z.url().min(1).nullish(),\n content: z.string().nullish(),\n});\n\n/**\n * DisplayMode\n */\nexport const zDisplayMode = z.enum([\n \"OVERLAY\",\n \"FULLSCREEN\",\n \"PULLUP\",\n \"INLINE\",\n]);\n\n/**\n * Gender\n */\nexport const zGender = z.enum([\"MALE\", \"FEMALE\", \"OTHER\", \"UNSPECIFIED\"]);\n\n/**\n * LayoutType\n */\nexport const zLayoutType = z.enum([\n \"TEXT_RICH\",\n \"BRAND_VISUAL\",\n \"FEATURED_IMAGE\",\n \"BANNER_VISUAL\",\n \"STACKED_TILE\",\n \"LAYERED_TILE\",\n \"PRODUCT_VISUAL\",\n]);\n\n/**\n * NoPromoCodeType\n */\nexport const zNoPromoCodeType = z.enum([\"NO_PROMO_CODE\"]);\n\n/**\n * NoPromoCodeMetadata\n */\nexport const zNoPromoCodeMetadata = z.object({\n type: zNoPromoCodeType,\n layout_type: zLayoutType,\n});\n\n/**\n * OrderDetails\n */\nexport const zOrderDetails = z.object({\n cost_details: zCostDetails.nullish(),\n order_id: z.string().nullish(),\n payment_type: z.string().nullish(),\n});\n\n/**\n * PlatformType\n */\nexport const zPlatformType = z.enum([\"MOBILE\", \"WEB\"]);\n\n/**\n * Attributes\n */\nexport const zAttributes = z.object({\n user_agent: z.string().nullish(),\n operating_system: z.string().nullish(),\n operating_system_version: z.string().nullish(),\n ip_address: z.string().nullish(),\n ip_address_hash: z.string().nullish(),\n platform_type: zPlatformType.nullish(),\n language: z.string().nullish(),\n device_type: z.string().nullish(),\n});\n\n/**\n * PrivacyPolicy\n */\nexport const zPrivacyPolicy = z.object({\n copy: z.string(),\n target_url: z.url().min(1),\n});\n\n/**\n * Footer\n */\nexport const zFooter = z.object({\n attribution_details: zAttributionDetails,\n privacy_policy: zPrivacyPolicy,\n});\n\n/**\n * PromoCodeType\n */\nexport const zPromoCodeType = z.enum([\"PROMO_CODE\"]);\n\n/**\n * PromoCodeMetadata\n */\nexport const zPromoCodeMetadata = z.object({\n code: z.string(),\n type: zPromoCodeType,\n layout_type: zLayoutType,\n});\n\n/**\n * Offer\n */\nexport const zOffer = z.object({\n id: z.uuid(),\n heading: z.string(),\n subheading: z.string().nullish(),\n json_content: z.record(z.string(), z.unknown()).nullish(),\n target_url: z.url().min(1),\n cta_details: zCtaDetails,\n assets: z.array(zAsset).nullish(),\n metadata: z.union([zPromoCodeMetadata, zNoPromoCodeMetadata]),\n disclosure_details: zDisclosureDetails.nullish(),\n});\n\n/**\n * PurchaseAttributes\n */\nexport const zPurchaseAttributes = z.object({\n is_clearance: z.boolean().nullish(),\n is_gift: z.boolean().nullish(),\n});\n\n/**\n * Product\n */\nexport const zProduct = z.object({\n name: z.string().nullish(),\n type: z.string().nullish(),\n variant: z.union([z.record(z.string(), z.string()), z.string()]).nullish(),\n quantity: z.number().gte(1).lte(9999999999).nullish(),\n description: z.string().nullish(),\n cost_details: zCostDetails.nullish(),\n product_id: z.string().nullish(),\n is_gift: z.boolean().nullish(),\n attributes: zPurchaseAttributes.nullish(),\n});\n\n/**\n * Recommendation\n */\nexport const zRecommendation = z.object({\n advertiser: zAdvertiser,\n offer: zOffer,\n});\n\n/**\n * RecommendationGroupEntry\n */\nexport const zRecommendationGroupEntry = z.object({\n insertion_order: z.int().gte(0),\n insertion_id: z.string(),\n offer_id: z.string(),\n advertiser_id: z.string(),\n});\n\n/**\n * RunningExperiment\n */\nexport const zRunningExperiment = z.object({\n name: z.string(),\n version: z.int().gte(0).lte(999),\n});\n\n/**\n * SlotContext\n */\nexport const zSlotContext = z.enum([\"HERO\", \"SCROLLABLE\"]);\n\n/**\n * RecommendationGroupProperty\n */\nexport const zRecommendationGroupProperty = z.object({\n heading: z.string().nullish(),\n slot_context: zSlotContext,\n});\n\n/**\n * RecommendationsResponse\n */\nexport const zRecommendationsResponse = z.object({\n session_id: z.uuid(),\n recommendations: z.record(z.string(), zRecommendation),\n recommendation_groups: z.record(\n z.string(),\n z.array(zRecommendationGroupEntry),\n ),\n recommendation_group_properties: z\n .record(z.string(), zRecommendationGroupProperty)\n .nullish(),\n running_experiments: z.array(zRunningExperiment).nullish(),\n footer: zFooter,\n});\n\n/**\n * SubView\n *\n * Used to distinguish two different views of the same page type\n */\nexport const zSubView = z.enum([\n \"DEFAULT\",\n \"POST_CLAIM\",\n \"BOOKING\",\n \"PURCHASE\",\n \"BOOKING_AND_PURCHASE\",\n]);\n\n/**\n * Title\n */\nexport const zTitle = z.enum([\"MR\", \"MRS\", \"MS\", \"MISS\"]);\n\n/**\n * EmailHashUserDetails\n */\nexport const zEmailHashUserDetails = z.object({\n title: zTitle.nullish(),\n first_name: z.string().nullish(),\n last_name: z.string().nullish(),\n phone: z.string().nullish(),\n gender: zGender.nullish(),\n dob: z.string().nullish(),\n age: z.number().gte(0).nullish(),\n email_hash: z.string().min(1),\n});\n\n/**\n * EmailUserDetails\n */\nexport const zEmailUserDetails = z.object({\n title: zTitle.nullish(),\n first_name: z.string().nullish(),\n last_name: z.string().nullish(),\n phone: z.string().nullish(),\n gender: zGender.nullish(),\n dob: z.string().nullish(),\n age: z.number().gte(0).nullish(),\n email: z.email(),\n});\n\n/**\n * ExternalGuidUserDetails\n */\nexport const zExternalGuidUserDetails = z.object({\n title: zTitle.nullish(),\n first_name: z.string().nullish(),\n last_name: z.string().nullish(),\n phone: z.string().nullish(),\n gender: zGender.nullish(),\n dob: z.string().nullish(),\n age: z.number().gte(0).nullish(),\n external_guid: z.string().min(1),\n});\n\n/**\n * PhoneNumberUserDetails\n */\nexport const zPhoneNumberUserDetails = z.object({\n title: zTitle.nullish(),\n first_name: z.string().nullish(),\n last_name: z.string().nullish(),\n phone: z.string().min(1),\n gender: zGender.nullish(),\n dob: z.string().nullish(),\n age: z.number().gte(0).nullish(),\n});\n\n/**\n * ValidationError\n */\nexport const zValidationError = z.object({\n loc: z.array(z.union([z.string(), z.int()])),\n msg: z.string(),\n type: z.string(),\n});\n\n/**\n * HTTPValidationError\n */\nexport const zHttpValidationError = z.object({\n detail: z.array(zValidationError).optional(),\n});\n\n/**\n * View\n *\n * deprecated, please use PageType instead\n */\nexport const zView = z.enum([\n \"ORDER_STATUS\",\n \"CHECKOUT\",\n \"THANK_YOU\",\n \"POST_ORDER\",\n \"ORDER_TRACKING\",\n \"SUPPORT_CENTER\",\n]);\n\n/**\n * PlacementDetails\n */\nexport const zPlacementDetails = z.object({\n display_mode: zDisplayMode,\n layout_id: z.string().nullish(),\n view: zView,\n sub_view: zSubView.optional().default(\"DEFAULT\"),\n});\n\n/**\n * RecommendationsRequest\n */\nexport const zRecommendationsRequest = z.object({\n user_details: z.union([\n zEmailUserDetails,\n zEmailHashUserDetails,\n zPhoneNumberUserDetails,\n zExternalGuidUserDetails,\n ]),\n placement_details: zPlacementDetails,\n order_details: zOrderDetails.nullish(),\n purchases: z.array(zProduct).nullish(),\n attributes: zAttributes.nullish(),\n custom_metadata: zCustomMetadata.nullish(),\n shipping: zAddress.nullish(),\n billing: zAddress.nullish(),\n running_experiments: z.array(zRunningExperiment).nullish(),\n});\n\nexport const zRecommendationsBody = zRecommendationsRequest;\n\n/**\n * Successful Response\n */\nexport const zRecommendationsResponse2 = zRecommendationsResponse;\n","export type DiscoEnv = \"production\" | \"staging\";\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","/**\n * Base class for every error thrown by the Disco clients. Catch this to handle\n * any SDK-originated failure; narrow to a subclass for specifics.\n *\n * Note: a request aborted via an `AbortSignal` is intentionally *not* a\n * `DiscoError` — the native `AbortError` propagates untouched so callers can\n * detect cancellation idiomatically (`err.name === \"AbortError\"`).\n */\nexport abstract class DiscoError extends Error {}\n\n/**\n * Thrown when a recommendations/events request returns a non-2xx status. The\n * HTTP status and an optional parsed body are preserved for error UIs and\n * retry logic. Shared by both the external and internal clients.\n */\nexport class DiscoApiError extends DiscoError {\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 * Thrown when request or response data fails schema validation.\n *\n * Wraps the underlying Zod `ZodError` and the offending value for debugging,\n * but presents a plain message so consumers never have to import or\n * pattern-match on Zod's own types. `cause` is typed as the common `Error`\n * base because the major differs by client — the external client validates with\n * the generated SDK's `zod/v4` schemas, the internal client with its own\n * `zod/v3` schemas. Narrow `cause` to your Zod major for the structured issues,\n * or read `rawValue` for what was being validated.\n */\nexport class DiscoValidationError extends DiscoError {\n /** The underlying Zod error (a `ZodError`; narrow to read `.issues`). */\n readonly cause: Error;\n /** The value that failed validation. */\n readonly rawValue: unknown;\n\n constructor(message: string, cause: Error, rawValue: unknown) {\n super(`${message}: ${cause.message}`);\n this.name = \"DiscoValidationError\";\n this.cause = cause;\n this.rawValue = rawValue;\n }\n}\n\n/**\n * Thrown when a request never completes — a network failure, DNS error,\n * connection reset, timeout, etc. A cancellation via `AbortSignal` is excluded:\n * the native `AbortError` propagates as-is (see {@link isAbortError}).\n */\nexport class DiscoNetworkError extends DiscoError {\n /** The underlying transport error (typically a `TypeError` from `fetch`). */\n readonly cause: unknown;\n\n constructor(message: string, cause: unknown) {\n super(message);\n this.name = \"DiscoNetworkError\";\n this.cause = cause;\n }\n}\n\n/**\n * True for an `AbortController` cancellation. Such errors propagate untouched\n * (never wrapped in `DiscoNetworkError`) so callers can detect cancellation by\n * name. Internal helper — not part of the public surface.\n */\nexport function isAbortError(error: unknown): boolean {\n return error instanceof Error && error.name === \"AbortError\";\n}\n","/**\n * Key-remapping helper used inside Zod `.transform()` steps to rename fields\n * between the public camelCase shape and the snake_case wire shape — the same\n * utility Speakeasy emits in its generated SDKs.\n */\n\nexport type Remap<Inp, Mapping extends { [k in keyof Inp]?: string | null }> = {\n [k in keyof Inp as Mapping[k] extends string\n ? Mapping[k]\n : Mapping[k] extends null\n ? never\n : k]: Inp[k];\n};\n\n/**\n * Return a new object with `inp`'s keys renamed according to `mappings`.\n * A key mapped to a string is renamed; a key mapped to `null` is dropped; a key\n * absent from the mapping is kept as-is.\n */\nexport function remap<\n Inp extends Record<string, unknown>,\n const Mapping extends { [k in keyof Inp]?: string | null },\n>(inp: Inp, mappings: Mapping): Remap<Inp, Mapping> {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n let out: any = {};\n\n if (!Object.keys(mappings).length) {\n out = inp;\n return out;\n }\n\n for (const [k, v] of Object.entries(inp)) {\n const j = (mappings as Record<string, string | null | undefined>)[k];\n if (j === null) {\n continue;\n }\n out[j ?? k] = v;\n }\n\n return out;\n}\n","/**\n * Recursively convert an object's keys from camelCase to snake_case, descending\n * into nested objects and arrays. Values are left untouched.\n *\n * Reserved for the request's `customMetadata` — an untyped map whose keys are\n * known field names we want recased, not arbitrary data. Everything else on the\n * request path is remapped field-by-field (see `recommendationsTransforms.ts`), so\n * data-keyed values like a purchase `variant` map are never blindly recased.\n */\nexport function toSnakeKeys(value: unknown): unknown {\n if (Array.isArray(value)) {\n return value.map(toSnakeKeys);\n }\n if (value !== null && typeof value === \"object\") {\n const out: Record<string, unknown> = {};\n for (const [key, v] of Object.entries(value)) {\n out[snakeCase(key)] = toSnakeKeys(v);\n }\n return out;\n }\n return value;\n}\n\nfunction snakeCase(key: string): string {\n return (\n key\n // Split a letter→digit boundary so `addressLine1` → `address_line_1`.\n .replace(/([A-Za-z])([0-9])/g, \"$1_$2\")\n .replace(/[A-Z]/g, (match) => `_${match.toLowerCase()}`)\n );\n}\n","/**\n * Zod schemas + casing transforms for the **external** recommendations contract.\n *\n * The public types mirror the endpoint 1:1 in structure, so the only\n * transformation is snake_case ↔ camelCase:\n * - Request: validate the camelCase input, then build the wire body with\n * explicit per-field `remap`s (the same mechanism Speakeasy-generated SDKs\n * use). Named fields are renamed deterministically; genuinely data-keyed\n * values — `variant`'s map, `customMetadata` — are handled explicitly so a\n * blind recaser can't corrupt them.\n * - Response: validate the snake_case wire, then recase to camelCase\n * **preserving map keys** (offer ids / group keys are data, not field names).\n *\n * @internal Built into the external `DiscoClient`; not part of the public API.\n */\n\nimport { remap } from \"../lib/primitives.js\";\nimport { toSnakeKeys } from \"../lib/case.js\";\n// The wire types the generated SDK returns (and has already validated). Aliased\n// with a `Wire` suffix to avoid clashing with the public camelCase domain types\n// imported above.\nimport type {\n Advertiser as AdvertiserWire,\n Asset as AssetWire,\n CtaDetails as CtaDetailsWire,\n Footer as FooterWire,\n Offer as OfferWire,\n Recommendation as RecommendationWire,\n RecommendationGroupEntry as RecommendationGroupEntryWire,\n RecommendationGroupProperty as RecommendationGroupPropertyWire,\n RecommendationsRequest as RecommendationsWireRequest,\n RecommendationsResponse as RecommendationsWireResponse,\n} from \"../api/generated/recommendations/types.gen.js\";\nimport type {\n Advertiser,\n CostDetails,\n Offer,\n OfferAsset,\n OfferCtaDetails,\n OfferMetadata,\n OrderDetails,\n Purchase,\n Recommendation,\n RecommendationGroupEntry,\n RecommendationGroupProperty,\n RecommendationsRequest,\n RecommendationsResponse,\n RunningExperiment,\n} from \"./recommendations.js\";\n\n/**\n * Build the snake_case wire body from the public request via explicit per-field\n * `remap`s. Transform-only: validation is performed by the generated SDK's\n * request validator (which surfaces as `DiscoValidationError` from\n * `DiscoClient`), so this does not parse or throw on bad input.\n */\nexport function transformRequest(\n request: RecommendationsRequest,\n): RecommendationsWireRequest {\n const v = request;\n // `compact` erases field types, so this cast is the request-side seam between\n // the domain shape and the wire shape. The generated SDK validates the result\n // at runtime; a full compile-time check would require a typed builder.\n return compact({\n user_details: remap(v.userDetails, {\n firstName: \"first_name\",\n lastName: \"last_name\",\n emailHash: \"email_hash\",\n externalGuid: \"external_guid\",\n }),\n placement_details: remap(v.placementDetails, {\n displayMode: \"display_mode\",\n subView: \"sub_view\",\n layoutId: \"layout_id\",\n }),\n order_details: v.orderDetails && wireOrderDetails(v.orderDetails),\n purchases: v.purchases?.map(wirePurchase),\n attributes: v.attributes && remap(v.attributes, attributesKeyMap),\n // Untyped map: recase keys algorithmically rather than field-by-field.\n custom_metadata: v.customMetadata && toSnakeKeys(v.customMetadata),\n shipping: v.shipping && remap(v.shipping, addressKeyMap),\n billing: v.billing && remap(v.billing, addressKeyMap),\n // `name` / `version` are already snake-safe; left as-is.\n running_experiments: v.runningExperiments,\n }) as unknown as RecommendationsWireRequest;\n}\n\nconst attributesKeyMap = {\n userAgent: \"user_agent\",\n operatingSystem: \"operating_system\",\n operatingSystemVersion: \"operating_system_version\",\n ipAddress: \"ip_address\",\n ipAddressHash: \"ip_address_hash\",\n platformType: \"platform_type\",\n deviceType: \"device_type\",\n} as const;\n\nconst addressKeyMap = {\n addressLine1: \"address_line_1\",\n addressLine2: \"address_line_2\",\n countryCode: \"country_code\",\n} as const;\n\nfunction wireCostDetails(c: CostDetails): Record<string, unknown> {\n return remap(c, { currencyCode: \"currency_code\" });\n}\n\nfunction wireOrderDetails(o: OrderDetails): Record<string, unknown> {\n return {\n ...remap(o, {\n orderId: \"order_id\",\n paymentType: \"payment_type\",\n costDetails: null,\n }),\n ...(o.costDetails && { cost_details: wireCostDetails(o.costDetails) }),\n };\n}\n\nfunction wirePurchase(p: Purchase): Record<string, unknown> {\n return {\n // `variant` is unmapped, so its value — string or data-keyed map — passes\n // through verbatim; recasing its keys would corrupt advertiser data.\n ...remap(p, {\n productId: \"product_id\",\n costDetails: null,\n attributes: null,\n }),\n ...(p.costDetails && { cost_details: wireCostDetails(p.costDetails) }),\n ...(p.attributes && {\n attributes: remap(p.attributes, {\n isClearance: \"is_clearance\",\n isGift: \"is_gift\",\n }),\n }),\n };\n}\n\n/** Drop keys whose value is `undefined` so absent optionals leave no trace. */\nfunction compact(obj: Record<string, unknown>): Record<string, unknown> {\n const out: Record<string, unknown> = {};\n for (const [k, val] of Object.entries(obj)) {\n if (val !== undefined) out[k] = val;\n }\n return out;\n}\n\n// ─── Response: recase the generated wire response, preserving map keys ──────\n// Validation lives in the generated SDK; this is pure transformation over its\n// already-validated wire types (the `*Wire` aliases).\n\n/**\n * Recase the rec-api wire response into the friendly camelCase shape, keeping\n * the normalized maps intact. Transform-only: the generated SDK validates the\n * response before this runs, so it neither parses nor throws.\n */\nexport function transformResponse(\n raw: RecommendationsWireResponse,\n): RecommendationsResponse {\n return {\n sessionId: raw.session_id,\n recommendations: mapValues(raw.recommendations ?? {}, mapRecommendation),\n recommendationGroups: mapValues(\n raw.recommendation_groups ?? {},\n (entries) => entries.map(mapGroupEntry),\n ),\n recommendationGroupProperties: raw.recommendation_group_properties\n ? mapValues(raw.recommendation_group_properties, mapGroupProperty)\n : undefined,\n runningExperiments: raw.running_experiments?.map(\n (e): RunningExperiment => ({ name: e.name, version: e.version }),\n ),\n footer: mapFooter(raw.footer),\n };\n}\n\n/** Map a dictionary's values while preserving its (data) keys. */\nfunction mapValues<T, U>(\n obj: Record<string, T>,\n fn: (value: T) => U,\n): Record<string, U> {\n const out: Record<string, U> = {};\n for (const [key, value] of Object.entries(obj)) {\n out[key] = fn(value);\n }\n return out;\n}\n\nfunction mapRecommendation(raw: RecommendationWire): Recommendation {\n return {\n advertiser: mapAdvertiser(raw.advertiser),\n offer: mapOffer(raw.offer),\n };\n}\n\nfunction mapGroupEntry(\n raw: RecommendationGroupEntryWire,\n): RecommendationGroupEntry {\n return {\n insertionOrder: raw.insertion_order,\n insertionId: raw.insertion_id,\n offerId: raw.offer_id,\n advertiserId: raw.advertiser_id,\n };\n}\n\nfunction mapGroupProperty(\n raw: RecommendationGroupPropertyWire,\n): RecommendationGroupProperty {\n return { heading: raw.heading ?? null, slotContext: raw.slot_context };\n}\n\nfunction mapAdvertiser(raw: AdvertiserWire): 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: OfferWire): Offer {\n return {\n id: raw.id,\n heading: raw.heading,\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: mapMetadata(raw.metadata),\n disclosureDetails: raw.disclosure_details\n ? {\n copy: raw.disclosure_details.copy,\n targetUrl: raw.disclosure_details.target_url ?? null,\n content: raw.disclosure_details.content ?? null,\n }\n : null,\n };\n}\n\nfunction mapCtaDetails(raw: CtaDetailsWire): OfferCtaDetails {\n return {\n acceptCopy: raw.accept_copy,\n declineCopy: raw.decline_copy,\n transitionCopy: raw.transition_copy ?? null,\n claimedAcceptCopy: raw.claimed_accept_copy ?? null,\n claimedDeclineCopy: raw.claimed_decline_copy ?? null,\n };\n}\n\nfunction mapAsset(raw: AssetWire): OfferAsset {\n return {\n assetType: raw.asset_type,\n imageUrl: raw.image_url,\n insertionOrder: raw.insertion_order,\n id: raw.id ?? null,\n targetUrl: raw.target_url ?? null,\n // Spec marks this optional; default to `false` to keep the public type's\n // required boolean.\n shouldTriggerClaimFlow: raw.should_trigger_claim_flow ?? false,\n };\n}\n\nfunction mapMetadata(raw: OfferWire[\"metadata\"]): OfferMetadata {\n return raw.type === \"PROMO_CODE\"\n ? { type: \"PROMO_CODE\", code: raw.code, layoutType: raw.layout_type }\n : { type: \"NO_PROMO_CODE\", layoutType: raw.layout_type };\n}\n\nfunction mapFooter(raw: FooterWire): RecommendationsResponse[\"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","import 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 * Absolute URL events are POSTed to. The external client points this at the\n * events service (`/events`); the internal client at the proxy\n * (`/track/partners_event/`). Prefer a client's `createTrackingManager` over\n * constructing this directly, so the endpoint and auth stay consistent with\n * the recommendations call.\n */\n endpoint: string;\n\n /**\n * Extra request headers — e.g. `{ \"x-api-key\": key }` for the external\n * events service. `Content-Type: application/json` is always sent.\n */\n headers?: Record<string, string>;\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 #headers: Record<string, string>;\n readonly #sessionId: string;\n readonly #fetch: typeof fetch;\n readonly #dedupe = new Set<string>();\n\n constructor(config: TrackingManagerConfig) {\n this.#endpoint = config.endpoint;\n this.#headers = config.headers ?? {};\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\", ...this.#headers },\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 // RFC-3339 with an explicit offset. \"+00:00\" is accepted by both the\n // events service and the legacy proxy validator (the latter can't parse\n // the bare \"Z\" suffix).\n event_datetime: new Date().toISOString().replace(\"Z\", \"+00:00\"),\n placement_details: event.placement\n ? {\n display_mode: event.placement.displayMode,\n view: event.placement.view,\n layout_id: event.placement.layoutId,\n }\n : undefined,\n };\n\n switch (event.type) {\n case \"BRAND_CLICK\":\n return {\n ...commonEventFields,\n brand_properties: brandProperties(event.brand),\n initiating_target: event.target,\n asset_id: event.assetId,\n };\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 \"PRODUCT_DISPLAY\":\n case \"PRODUCT_VIEW\":\n case \"PRODUCT_CLICK\":\n return {\n ...commonEventFields,\n brand_properties: brandProperties(event.brand),\n product_properties: { product_id: event.product.productId },\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"],"mappings":"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"}
|
|
@@ -0,0 +1,408 @@
|
|
|
1
|
+
//#region src/api/generated/recommendations/types.gen.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* DisplayMode
|
|
4
|
+
*/
|
|
5
|
+
type DisplayMode = "OVERLAY" | "FULLSCREEN" | "PULLUP" | "INLINE";
|
|
6
|
+
/**
|
|
7
|
+
* Gender
|
|
8
|
+
*/
|
|
9
|
+
type Gender = "MALE" | "FEMALE" | "OTHER" | "UNSPECIFIED";
|
|
10
|
+
/**
|
|
11
|
+
* PlatformType
|
|
12
|
+
*/
|
|
13
|
+
type PlatformType = "MOBILE" | "WEB";
|
|
14
|
+
/**
|
|
15
|
+
* SubView
|
|
16
|
+
*
|
|
17
|
+
* Used to distinguish two different views of the same page type
|
|
18
|
+
*/
|
|
19
|
+
type SubView = "DEFAULT" | "POST_CLAIM" | "BOOKING" | "PURCHASE" | "BOOKING_AND_PURCHASE";
|
|
20
|
+
/**
|
|
21
|
+
* Title
|
|
22
|
+
*/
|
|
23
|
+
type Title = "MR" | "MRS" | "MS" | "MISS";
|
|
24
|
+
/**
|
|
25
|
+
* View
|
|
26
|
+
*
|
|
27
|
+
* deprecated, please use PageType instead
|
|
28
|
+
*/
|
|
29
|
+
type View = "ORDER_STATUS" | "CHECKOUT" | "THANK_YOU" | "POST_ORDER" | "ORDER_TRACKING" | "SUPPORT_CENTER";
|
|
30
|
+
//#endregion
|
|
31
|
+
//#region src/external/recommendations.d.ts
|
|
32
|
+
/**
|
|
33
|
+
* A running experiment — shared by the request (input) and the response
|
|
34
|
+
* (echoed back). Declared here (not inferred) because the response references
|
|
35
|
+
* it; the request schema validates the identical `{ name, version }` shape.
|
|
36
|
+
*/
|
|
37
|
+
type RunningExperiment = {
|
|
38
|
+
name: string; /** 0 .. 999. */
|
|
39
|
+
version: number;
|
|
40
|
+
};
|
|
41
|
+
/**
|
|
42
|
+
* Structured device/session attributes. Only these fields are recognized by the
|
|
43
|
+
* backend (`disco_shared` `Attributes`); unknown keys are dropped server-side.
|
|
44
|
+
*/
|
|
45
|
+
type Attributes = {
|
|
46
|
+
userAgent?: string;
|
|
47
|
+
operatingSystem?: string;
|
|
48
|
+
operatingSystemVersion?: string;
|
|
49
|
+
ipAddress?: string;
|
|
50
|
+
ipAddressHash?: string;
|
|
51
|
+
platformType?: PlatformType; /** ISO-639 language code. */
|
|
52
|
+
language?: string;
|
|
53
|
+
deviceType?: string;
|
|
54
|
+
};
|
|
55
|
+
type UserProfile = {
|
|
56
|
+
title?: Title;
|
|
57
|
+
firstName?: string;
|
|
58
|
+
lastName?: string;
|
|
59
|
+
phone?: string;
|
|
60
|
+
gender?: Gender; /** Date of birth, `YYYY-MM-DD`. */
|
|
61
|
+
dob?: string; /** Non-negative. */
|
|
62
|
+
age?: number;
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* User details must carry at least one identifier — email, email hash, external
|
|
66
|
+
* GUID, or phone. (Enforced by the generated SDK's request validator, not the
|
|
67
|
+
* type.)
|
|
68
|
+
*/
|
|
69
|
+
type UserDetails = (UserProfile & {
|
|
70
|
+
email: string;
|
|
71
|
+
}) | (UserProfile & {
|
|
72
|
+
emailHash: string;
|
|
73
|
+
}) | (UserProfile & {
|
|
74
|
+
externalGuid: string;
|
|
75
|
+
}) | (UserProfile & {
|
|
76
|
+
phone: string;
|
|
77
|
+
});
|
|
78
|
+
type CostDetails = {
|
|
79
|
+
amount?: number; /** ISO-4217 currency code. */
|
|
80
|
+
currencyCode?: string;
|
|
81
|
+
};
|
|
82
|
+
type PlacementDetails = {
|
|
83
|
+
displayMode: DisplayMode;
|
|
84
|
+
view: View;
|
|
85
|
+
subView?: SubView;
|
|
86
|
+
layoutId?: string;
|
|
87
|
+
};
|
|
88
|
+
type OrderDetails = {
|
|
89
|
+
orderId?: string;
|
|
90
|
+
paymentType?: string;
|
|
91
|
+
costDetails?: CostDetails;
|
|
92
|
+
};
|
|
93
|
+
type PurchaseAttributes = {
|
|
94
|
+
isClearance?: boolean;
|
|
95
|
+
isGift?: boolean;
|
|
96
|
+
};
|
|
97
|
+
type Purchase = {
|
|
98
|
+
name?: string;
|
|
99
|
+
type?: string; /** A string, or a data-keyed map passed through to the wire verbatim. */
|
|
100
|
+
variant?: string | Record<string, string>;
|
|
101
|
+
quantity?: number;
|
|
102
|
+
description?: string;
|
|
103
|
+
productId?: string;
|
|
104
|
+
costDetails?: CostDetails;
|
|
105
|
+
attributes?: PurchaseAttributes;
|
|
106
|
+
};
|
|
107
|
+
type Address = {
|
|
108
|
+
addressLine1?: string;
|
|
109
|
+
addressLine2?: string;
|
|
110
|
+
city?: string;
|
|
111
|
+
state?: string;
|
|
112
|
+
zip?: string;
|
|
113
|
+
phone?: string;
|
|
114
|
+
countryCode?: string;
|
|
115
|
+
};
|
|
116
|
+
/**
|
|
117
|
+
* Free-form custom metadata. Untyped on purpose: the backend `CustomMetadata`
|
|
118
|
+
* model has many fields and churns; keys are recased camelCase → snake_case on
|
|
119
|
+
* the way out so callers can stay in the camelCase idiom.
|
|
120
|
+
*/
|
|
121
|
+
type CustomMetadata = Record<string, unknown>;
|
|
122
|
+
type RecommendationsRequest = {
|
|
123
|
+
userDetails: UserDetails;
|
|
124
|
+
placementDetails: PlacementDetails;
|
|
125
|
+
orderDetails?: OrderDetails;
|
|
126
|
+
purchases?: Purchase[];
|
|
127
|
+
attributes?: Attributes;
|
|
128
|
+
customMetadata?: CustomMetadata;
|
|
129
|
+
shipping?: Address;
|
|
130
|
+
billing?: Address;
|
|
131
|
+
runningExperiments?: RunningExperiment[];
|
|
132
|
+
};
|
|
133
|
+
type RecommendationsResponse = {
|
|
134
|
+
sessionId: string; /** Offer id → recommendation. */
|
|
135
|
+
recommendations: Record<string, Recommendation>; /** Group key → ordered entry list referencing offer ids. */
|
|
136
|
+
recommendationGroups: Record<string, RecommendationGroupEntry[]>; /** Group key → display properties. */
|
|
137
|
+
recommendationGroupProperties?: Record<string, RecommendationGroupProperty>;
|
|
138
|
+
runningExperiments?: RunningExperiment[];
|
|
139
|
+
footer: Footer;
|
|
140
|
+
};
|
|
141
|
+
type Recommendation = {
|
|
142
|
+
advertiser: Advertiser;
|
|
143
|
+
offer: Offer;
|
|
144
|
+
};
|
|
145
|
+
type RecommendationGroupEntry = {
|
|
146
|
+
insertionOrder: number;
|
|
147
|
+
insertionId: string;
|
|
148
|
+
offerId: string;
|
|
149
|
+
advertiserId: string;
|
|
150
|
+
};
|
|
151
|
+
type RecommendationGroupProperty = {
|
|
152
|
+
heading: string | null;
|
|
153
|
+
slotContext: string;
|
|
154
|
+
};
|
|
155
|
+
type Advertiser = {
|
|
156
|
+
id: string;
|
|
157
|
+
name: string;
|
|
158
|
+
logoUrl: string;
|
|
159
|
+
description: string | null;
|
|
160
|
+
};
|
|
161
|
+
type Offer = {
|
|
162
|
+
id: string;
|
|
163
|
+
heading: string;
|
|
164
|
+
subheading: string | null;
|
|
165
|
+
jsonContent: Record<string, unknown> | null;
|
|
166
|
+
targetUrl: string;
|
|
167
|
+
ctaDetails: OfferCtaDetails;
|
|
168
|
+
assets: OfferAsset[];
|
|
169
|
+
metadata: OfferMetadata;
|
|
170
|
+
disclosureDetails: OfferDisclosureDetails | null;
|
|
171
|
+
};
|
|
172
|
+
type OfferCtaDetails = {
|
|
173
|
+
acceptCopy: string;
|
|
174
|
+
declineCopy: string;
|
|
175
|
+
transitionCopy: string | null;
|
|
176
|
+
claimedAcceptCopy: string | null;
|
|
177
|
+
claimedDeclineCopy: string | null;
|
|
178
|
+
};
|
|
179
|
+
type OfferAsset = {
|
|
180
|
+
/** Server-defined asset type (e.g. `PRODUCT`). Open-ended. */assetType: string;
|
|
181
|
+
imageUrl: string;
|
|
182
|
+
insertionOrder: number;
|
|
183
|
+
id: string | null;
|
|
184
|
+
targetUrl: string | null;
|
|
185
|
+
shouldTriggerClaimFlow: boolean;
|
|
186
|
+
};
|
|
187
|
+
/** Discriminated on `type`. `layoutType` is a server-defined display format. */
|
|
188
|
+
type OfferMetadata = {
|
|
189
|
+
type: "PROMO_CODE";
|
|
190
|
+
code: string;
|
|
191
|
+
layoutType: string;
|
|
192
|
+
} | {
|
|
193
|
+
type: "NO_PROMO_CODE";
|
|
194
|
+
layoutType: string;
|
|
195
|
+
};
|
|
196
|
+
type OfferDisclosureDetails = {
|
|
197
|
+
copy: string;
|
|
198
|
+
targetUrl: string | null;
|
|
199
|
+
content: string | null;
|
|
200
|
+
};
|
|
201
|
+
type Footer = {
|
|
202
|
+
attributionDetails: {
|
|
203
|
+
copy: string;
|
|
204
|
+
discoLogoUrl: string;
|
|
205
|
+
targetUrl: string;
|
|
206
|
+
};
|
|
207
|
+
privacyPolicy: {
|
|
208
|
+
copy: string;
|
|
209
|
+
targetUrl: string;
|
|
210
|
+
};
|
|
211
|
+
};
|
|
212
|
+
//#endregion
|
|
213
|
+
//#region src/types.d.ts
|
|
214
|
+
/**
|
|
215
|
+
* Targets for `BRAND_CLICK` events — where in the widget the click originated.
|
|
216
|
+
*/
|
|
217
|
+
type BrandClickInitiatingTarget = "INLINE_ACTION_BUTTON" | "INLINE_ASSET_TILE" | "SCROLLABLE_SLOT_TILE";
|
|
218
|
+
/**
|
|
219
|
+
* Targets for `ELEMENT_CLICK` events — non-brand UI interactions.
|
|
220
|
+
*/
|
|
221
|
+
type ElementClickInitiatingTarget = "INLINE_NAV_FORWARD" | "INLINE_NAV_BACKWARD" | "EXPLICIT_NAV_FORWARD" | "EXPLICIT_NAV_BACKWARD" | "INLINE_FOOTER_DISCO" | "INLINE_FOOTER_PRIVACY" | "CLOSE_BUTTON" | "CLOSE_BACKDROP" | "OPEN_OVERLAY";
|
|
222
|
+
/**
|
|
223
|
+
* Targets for `BRAND_DISPLAY` / `BRAND_VIEW` events.
|
|
224
|
+
*/
|
|
225
|
+
type BrandDisplayInitiatingTarget = "INLINE_SLOT" | "SCROLLABLE_SLOT";
|
|
226
|
+
/**
|
|
227
|
+
* Targets for `PRODUCT_DISPLAY` / `PRODUCT_VIEW` / `PRODUCT_CLICK` events.
|
|
228
|
+
*/
|
|
229
|
+
type ProductDisplayInitiatingTarget = "INLINE_TILE";
|
|
230
|
+
/**
|
|
231
|
+
* Identifies a brand instance in the recommendations response.
|
|
232
|
+
*
|
|
233
|
+
* `insertionId` is the unique-per-render identifier and is what dedup keys
|
|
234
|
+
* are built from.
|
|
235
|
+
*/
|
|
236
|
+
type BrandProperties = {
|
|
237
|
+
offerId: string;
|
|
238
|
+
advertiserId: string;
|
|
239
|
+
insertionId: string;
|
|
240
|
+
};
|
|
241
|
+
type ProductProperties = {
|
|
242
|
+
productId: string;
|
|
243
|
+
};
|
|
244
|
+
type WidgetEventType = "WIDGET_LOAD" | "WIDGET_DISPLAY" | "WIDGET_VIEW";
|
|
245
|
+
type BrandVisibilityEventType = "BRAND_DISPLAY" | "BRAND_VIEW";
|
|
246
|
+
type ProductEventType = "PRODUCT_DISPLAY" | "PRODUCT_VIEW" | "PRODUCT_CLICK";
|
|
247
|
+
/**
|
|
248
|
+
* Optional placement context attached to an event, emitted as
|
|
249
|
+
* `placement_details`. All fields are optional; values are open-ended.
|
|
250
|
+
*/
|
|
251
|
+
type EventPlacementDetails = {
|
|
252
|
+
displayMode?: string;
|
|
253
|
+
view?: string;
|
|
254
|
+
layoutId?: string;
|
|
255
|
+
};
|
|
256
|
+
/**
|
|
257
|
+
* Discriminated union of every event the SDK can emit. `session_id` and
|
|
258
|
+
* `event_datetime` are stamped by `TrackingManager`, so callers supply only the
|
|
259
|
+
* event-specific fields.
|
|
260
|
+
*
|
|
261
|
+
* The same union is sent by both the external client (direct to the events
|
|
262
|
+
* service) and the internal/proxy client — the proxy forwards events verbatim,
|
|
263
|
+
* so the contract is identical.
|
|
264
|
+
*/
|
|
265
|
+
type EventPayload = {
|
|
266
|
+
type: WidgetEventType;
|
|
267
|
+
placement?: EventPlacementDetails;
|
|
268
|
+
} | {
|
|
269
|
+
type: BrandVisibilityEventType;
|
|
270
|
+
brand: BrandProperties;
|
|
271
|
+
target: BrandDisplayInitiatingTarget;
|
|
272
|
+
placement?: EventPlacementDetails;
|
|
273
|
+
} | {
|
|
274
|
+
type: "BRAND_CLICK";
|
|
275
|
+
brand: BrandProperties;
|
|
276
|
+
target: BrandClickInitiatingTarget;
|
|
277
|
+
assetId?: string;
|
|
278
|
+
placement?: EventPlacementDetails;
|
|
279
|
+
} | {
|
|
280
|
+
type: "ELEMENT_CLICK";
|
|
281
|
+
target: ElementClickInitiatingTarget;
|
|
282
|
+
brand?: BrandProperties;
|
|
283
|
+
placement?: EventPlacementDetails;
|
|
284
|
+
} | {
|
|
285
|
+
type: ProductEventType;
|
|
286
|
+
product: ProductProperties;
|
|
287
|
+
brand: BrandProperties;
|
|
288
|
+
target: ProductDisplayInitiatingTarget;
|
|
289
|
+
placement?: EventPlacementDetails;
|
|
290
|
+
};
|
|
291
|
+
//#endregion
|
|
292
|
+
//#region src/TrackingManager.d.ts
|
|
293
|
+
type TrackingManagerConfig = {
|
|
294
|
+
/**
|
|
295
|
+
* Session identifier returned by the recommendations API. Stamped onto
|
|
296
|
+
* every emitted event as `session_id`. A tracker is meaningless without
|
|
297
|
+
* a session, so this is required — instantiate the manager only after
|
|
298
|
+
* the recommendations response is in hand.
|
|
299
|
+
*/
|
|
300
|
+
sessionId: string;
|
|
301
|
+
/**
|
|
302
|
+
* Absolute URL events are POSTed to. The external client points this at the
|
|
303
|
+
* events service (`/events`); the internal client at the proxy
|
|
304
|
+
* (`/track/partners_event/`). Prefer a client's `createTrackingManager` over
|
|
305
|
+
* constructing this directly, so the endpoint and auth stay consistent with
|
|
306
|
+
* the recommendations call.
|
|
307
|
+
*/
|
|
308
|
+
endpoint: string;
|
|
309
|
+
/**
|
|
310
|
+
* Extra request headers — e.g. `{ "x-api-key": key }` for the external
|
|
311
|
+
* events service. `Content-Type: application/json` is always sent.
|
|
312
|
+
*/
|
|
313
|
+
headers?: Record<string, string>;
|
|
314
|
+
/**
|
|
315
|
+
* Override the global `fetch`. Primarily useful in tests and in runtimes
|
|
316
|
+
* that provide a non-standard fetch implementation. Defaults to
|
|
317
|
+
* `globalThis.fetch`.
|
|
318
|
+
*/
|
|
319
|
+
fetch?: typeof fetch;
|
|
320
|
+
};
|
|
321
|
+
type EventTracker = {
|
|
322
|
+
track: (event: EventPayload) => void;
|
|
323
|
+
};
|
|
324
|
+
/**
|
|
325
|
+
* Renderer-agnostic event tracker for Disco recommendation surfaces.
|
|
326
|
+
*
|
|
327
|
+
* Owns:
|
|
328
|
+
* - the dedup set (so repeated display/view events for the same brand
|
|
329
|
+
* don't get re-sent within a session)
|
|
330
|
+
* - the network call to the partner-events endpoint
|
|
331
|
+
* - payload formatting (snake_case keys, BE-friendly datetime)
|
|
332
|
+
*
|
|
333
|
+
* Does not know about React. Wrap it in a Provider (`@disconetwork/react`'s
|
|
334
|
+
* `DiscoProvider`) when consuming from a React tree, or instantiate it
|
|
335
|
+
* directly from any other JS environment.
|
|
336
|
+
*
|
|
337
|
+
* `track` is implemented as an instance-bound arrow function so consumers
|
|
338
|
+
* can safely destructure it without losing `this`.
|
|
339
|
+
*/
|
|
340
|
+
declare class TrackingManager {
|
|
341
|
+
#private;
|
|
342
|
+
constructor(config: TrackingManagerConfig);
|
|
343
|
+
/**
|
|
344
|
+
* Send a tracking event. Fire-and-forget — never throws.
|
|
345
|
+
* Failures are logged via `console.error`.
|
|
346
|
+
*
|
|
347
|
+
* Idempotency: `WIDGET_DISPLAY`, `WIDGET_VIEW`, `BRAND_DISPLAY`, and
|
|
348
|
+
* `BRAND_VIEW` are deduped per-instance by (event type, insertionId).
|
|
349
|
+
*/
|
|
350
|
+
track: (event: EventPayload) => void;
|
|
351
|
+
}
|
|
352
|
+
//#endregion
|
|
353
|
+
//#region src/errors.d.ts
|
|
354
|
+
/**
|
|
355
|
+
* Base class for every error thrown by the Disco clients. Catch this to handle
|
|
356
|
+
* any SDK-originated failure; narrow to a subclass for specifics.
|
|
357
|
+
*
|
|
358
|
+
* Note: a request aborted via an `AbortSignal` is intentionally *not* a
|
|
359
|
+
* `DiscoError` — the native `AbortError` propagates untouched so callers can
|
|
360
|
+
* detect cancellation idiomatically (`err.name === "AbortError"`).
|
|
361
|
+
*/
|
|
362
|
+
declare abstract class DiscoError extends Error {}
|
|
363
|
+
/**
|
|
364
|
+
* Thrown when a recommendations/events request returns a non-2xx status. The
|
|
365
|
+
* HTTP status and an optional parsed body are preserved for error UIs and
|
|
366
|
+
* retry logic. Shared by both the external and internal clients.
|
|
367
|
+
*/
|
|
368
|
+
declare class DiscoApiError extends DiscoError {
|
|
369
|
+
readonly status: number;
|
|
370
|
+
readonly statusText: string;
|
|
371
|
+
readonly body: unknown;
|
|
372
|
+
constructor(message: string, info: {
|
|
373
|
+
status: number;
|
|
374
|
+
statusText: string;
|
|
375
|
+
body?: unknown;
|
|
376
|
+
});
|
|
377
|
+
}
|
|
378
|
+
/**
|
|
379
|
+
* Thrown when request or response data fails schema validation.
|
|
380
|
+
*
|
|
381
|
+
* Wraps the underlying Zod `ZodError` and the offending value for debugging,
|
|
382
|
+
* but presents a plain message so consumers never have to import or
|
|
383
|
+
* pattern-match on Zod's own types. `cause` is typed as the common `Error`
|
|
384
|
+
* base because the major differs by client — the external client validates with
|
|
385
|
+
* the generated SDK's `zod/v4` schemas, the internal client with its own
|
|
386
|
+
* `zod/v3` schemas. Narrow `cause` to your Zod major for the structured issues,
|
|
387
|
+
* or read `rawValue` for what was being validated.
|
|
388
|
+
*/
|
|
389
|
+
declare class DiscoValidationError extends DiscoError {
|
|
390
|
+
/** The underlying Zod error (a `ZodError`; narrow to read `.issues`). */
|
|
391
|
+
readonly cause: Error;
|
|
392
|
+
/** The value that failed validation. */
|
|
393
|
+
readonly rawValue: unknown;
|
|
394
|
+
constructor(message: string, cause: Error, rawValue: unknown);
|
|
395
|
+
}
|
|
396
|
+
/**
|
|
397
|
+
* Thrown when a request never completes — a network failure, DNS error,
|
|
398
|
+
* connection reset, timeout, etc. A cancellation via `AbortSignal` is excluded:
|
|
399
|
+
* the native `AbortError` propagates as-is (see {@link isAbortError}).
|
|
400
|
+
*/
|
|
401
|
+
declare class DiscoNetworkError extends DiscoError {
|
|
402
|
+
/** The underlying transport error (typically a `TypeError` from `fetch`). */
|
|
403
|
+
readonly cause: unknown;
|
|
404
|
+
constructor(message: string, cause: unknown);
|
|
405
|
+
}
|
|
406
|
+
//#endregion
|
|
407
|
+
export { RecommendationsResponse as A, OfferCtaDetails as C, RecommendationGroupEntry as D, Recommendation as E, SubView as F, Title as I, View as L, DisplayMode as M, Gender as N, RecommendationGroupProperty as O, PlatformType as P, OfferAsset as S, OfferMetadata as T, ProductProperties as _, EventTracker as a, Footer as b, BrandClickInitiatingTarget as c, BrandVisibilityEventType as d, ElementClickInitiatingTarget as f, ProductEventType as g, ProductDisplayInitiatingTarget as h, DiscoValidationError as i, RunningExperiment as j, RecommendationsRequest as k, BrandDisplayInitiatingTarget as l, EventPlacementDetails as m, DiscoError as n, TrackingManager as o, EventPayload as p, DiscoNetworkError as r, TrackingManagerConfig as s, DiscoApiError as t, BrandProperties as u, WidgetEventType as v, OfferDisclosureDetails as w, Offer as x, Advertiser as y };
|
|
408
|
+
//# sourceMappingURL=errors-C-xomnpl.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors-C-xomnpl.d.ts","names":[],"sources":["../src/api/generated/recommendations/types.gen.ts","../src/external/recommendations.ts","../src/types.ts","../src/TrackingManager.ts","../src/errors.ts"],"mappings":"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"}
|