@encorekit/web-sdk 2.1.1 → 2.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@encorekit/web-sdk",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "type": "module",
   "description": "Encore SDK for web applications - display targeted offers and manage user entitlements",
   "main": "./dist/cjs/index.cjs",

package/types/analytics/transport.d.ts

@@ -8,8 +8,8 @@
 import type { AnalyticsEvent, EventEnvelope } from './models';
 /**
  * Wrap an event in the analytics wire envelope, injecting the shared web metadata
- * (platform, sdk_version, app_bundle_id). `eventId` defaults to a fresh UUID;
- * callers needing idempotent retries pass a stable id.
+ * (platform, agent_type, device_os, sdk_version, app_bundle_id). `eventId` defaults to a
+ * fresh UUID; callers needing idempotent retries pass a stable id.
  */
 export declare function buildEnvelope(event: AnalyticsEvent, eventId?: string): EventEnvelope;
 /**

package/types/analytics/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/analytics/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAiD9D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,GAAE,MAAuB,GAAG,aAAa,CAcpG;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,OAAO,CAAC,QAAQ,CAAC,CAWnB"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/analytics/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAkD9D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,GAAE,MAAuB,GAAG,aAAa,CAqBpG;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,OAAO,CAAC,QAAQ,CAAC,CAWnB"}

package/types/core/Encore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Encore.d.ts","sourceRoot":"","sources":["../../src/core/Encore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Encore.d.ts","sourceRoot":"","sources":["../../src/core/Encore.ts"],"names":[],"mappings":"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"}

package/types/core/giftVariant.d.ts

@@ -7,10 +7,11 @@
  * which is the same per-app machinery `streaksCarousel` already rides
  * (`GET /publisher/sdk/v1/config` → `ui.variantName`).
  *
- * THREE NAMES, EACH ITS OWN SURFACE. `giftReveal` is the name in the approved Backend
+ * FOUR NAMES, EACH ITS OWN SURFACE. `giftReveal` is the name in the approved Backend
  * Change Report (the box that opens onto a short radio group). `giftList` and
  * `giftUnwrap` are the two later designs (a selectable list under a hero image, and a
- * closed box that unwraps onto a "your gift is ready" screen). The names are fixed:
+ * closed box that unwraps onto a "your gift is ready" screen). `giftPicker` is
+ * PayRange's original email gift picker (host bar, logo fan, brand + perk rows). The names are fixed:
  * they are what the `variants` rows will be called and what the config endpoint will
  * serve as `selectedVariant.name`. They sit beside the shipped variants
  * (bundleFraming, control, customHeadlineControl, featuredOfferCarousel,
@@ -36,7 +37,7 @@
  * this SDK, visible in review, and costs one string per surface.
  */
 /** The bespoke reward surfaces a served variant can ask for. */
-export type RewardSurfaceKind = 'giftReveal' | 'giftList' | 'giftUnwrap';
+export type RewardSurfaceKind = 'giftReveal' | 'giftList' | 'giftUnwrap' | 'giftPicker';
 /**
  * Exact served variant name → the surface it asks for. The ONLY way into any gift
  * surface: a name missing from this table is the carousel.

package/types/core/giftVariant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"giftVariant.d.ts","sourceRoot":"","sources":["../../src/core/giftVariant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAI3E,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;AACtC;;;;;;GAMG;AACH,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAwB,GACxE,iBAAiB,GAAG,IAAI,CAO1B"}
+{"version":3,"file":"giftVariant.d.ts","sourceRoot":"","sources":["../../src/core/giftVariant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;AAExF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAK3E,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;AACtC;;;;;;GAMG;AACH,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAwB,GACxE,iBAAiB,GAAG,IAAI,CAO1B"}

package/types/core/version.d.ts

@@ -1,3 +1,3 @@
 /** SDK version — single source of truth (also kept in sync with package.json via scripts/update-version.sh) */
-export declare const SDK_VERSION = "2.1.1";
+export declare const SDK_VERSION = "2.1.3";
 //# sourceMappingURL=version.d.ts.map

package/types/ui/GiftPicker.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Gift picker — the `giftPicker` reward surface, drawn after PayRange's email gift picker.
+ *
+ * Top to bottom, inside the reward chrome: the host bar and a fan of the top gifts' logos
+ * ({@link GiftPicker.renderHero}), then this surface — up to three brand + perk radio
+ * rows and "More gifts" — then the action block Encore composes: a CTA naming the gift
+ * and "One gift per person · Offer terms".
+ *
+ * 🔴 SCOPED TO ONE VARIANT. Reached only when the backend serves `giftPicker` for a
+ * `rewardUsers` presentation (see `core/giftVariant.ts`). `giftReveal` keeps its box.
+ *
+ * The SELECTION MODEL is `GiftReveal`'s and `GiftList`'s: `#selectedIndex` indexes the
+ * FULL offer array, and a gift picked from the sheet is PROMOTED into the rows, so the
+ * screen and the CTA never disagree about what will be claimed. The sheet is `GiftSheet`.
+ *
+ * Events: `offerView` once per offer the impression gate judges shown, `offerSelect` on
+ * every selection change including the initial one inside `render()`, `offerClaim` only
+ * through {@link GiftPicker.claimSelected}. Every `index` indexes the array passed in.
+ */
+import type { OfferModel as Offer } from '../api/models';
+import type { RewardSurface, RewardSurfaceEventMap } from './rewardSurface';
+import { ImpressionGate } from './impressionGate';
+/** How many gifts are shown as rows. The rest go behind "More gifts". */
+export declare const GIFT_PICKER_ROW_LIMIT = 3;
+export interface GiftPickerOptions {
+    /**
+     * Whether claiming is switched on. `false` disables the sheet's own CTA, matching
+     * what `RewardActions` does to the main one — the gate is the SDK's, so every
+     * control that can start a claim has to honour it, not just the visible one.
+     */
+    claimEnabled?: boolean;
+    /**
+     * The trust line repeated at the foot of the sheet.
+     *
+     * Passed in by the caller so it is literally the SAME value the main surface's
+     * action block receives — the two are one decision made once, not two defaults that
+     * happen to agree. The fallback is now that same string rather than a second
+     * constant that has to be kept in step with it.
+     *
+     * 🔴 THE FALLBACK CLAIMS NOTHING, AND IT CANNOT BE DERIVED. Every other fine print
+     * in this SDK is chosen per offer from `badgeLabel` — `isKnownFreeTrial` picks
+     * `GIFT_COPY.finePrint`, everything else gets `REWARD_COPY.trustUnknown` — but this
+     * line sits at the foot of a LIST. The sheet holds every gift that did not fit, one
+     * row can be a free trial and the next a paid discount, and the sheet's own CTA is
+     * "Continue" rather than a claim, so there is no single offer whose badge could
+     * decide the sentence. The badge route is unavailable here for that reason, not
+     * because the data is missing.
+     *
+     * It used to default to `GIFT_COPY.finePrint` — "FREE trial. You can cancel
+     * anytime." — over exactly that mixed list: the same false claim `ui/offerBadge.ts`
+     * exists to remove, asserted over more offers at once. The default is now the line
+     * that holds whatever the terms turn out to be.
+     */
+    trustText?: string;
+    /**
+     * The presentation's impression gate (see `impressionGate.ts`): rows and sheet cards
+     * report `offerView` only once it judges them shown. Without one the surface owns an
+     * unarmed gate, which never fires.
+     */
+    impressions?: ImpressionGate;
+    /** The host app's name for the bar above the fan (`values.text.appName`). No name, no bar. */
+    hostName?: string;
+    /** The host app's icon beside that name (`values.media.appstoreIcon`). */
+    hostIconUrl?: string;
+}
+export declare class GiftPicker implements RewardSurface {
+    #private;
+    constructor(offers: readonly Offer[], options?: GiftPickerOptions);
+    on<E extends keyof RewardSurfaceEventMap>(event: E, handler: (payload: RewardSurfaceEventMap[E]) => void): () => void;
+    getTotalOffers(): number;
+    getCurrentIndex(): number;
+    getSelectedOffer(): Offer | undefined;
+    /** True when there is anything left to put behind "More gifts". */
+    hasMoreGifts(): boolean;
+    /**
+     * The host bar and the logo fan, as their own element: they belong ABOVE the sheet's
+     * headline and the rows below it — see `RewardLayoutOptions.hero`.
+     */
+    renderHero(): HTMLElement;
+    render(): HTMLElement;
+    /**
+     * Select the offer at `index` — an index into the full offer array.
+     *
+     * Out-of-range indices are IGNORED rather than clamped: a caller asking for an offer
+     * that does not exist has a bug, and silently claiming a neighbouring advertiser's
+     * offer instead would hide it behind a real transaction.
+     */
+    selectOffer(index: number): void;
+    /** Move to the next offer, wrapping. Present for API parity with the carousel. */
+    next(): void;
+    /**
+     * Claim the SELECTED offer — the single claim path, whichever control started it.
+     *
+     * Honours the host's claim switch here as well as on the buttons, so a programmatic
+     * call cannot claim what a disabled control could not. Otherwise mirrors
+     * `OfferCarousel.claimSelected`, including the warn-and-ignore on an empty
+     * selection: an offers array that arrived empty must not produce a transaction for
+     * `undefined`.
+     */
+    claimSelected(): void;
+    openSheet(opener?: HTMLElement): void;
+    closeSheet(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=GiftPicker.d.ts.map

package/types/ui/GiftPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GiftPicker.d.ts","sourceRoot":"","sources":["../../src/ui/GiftPicker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AASzD,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAEnE,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,IAAoB,CAAC;AAOvD,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAW,YAAW,aAAa;;gBA2BlC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,GAAE,iBAAsB;IASrE,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACtC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,MAAM,IAAI;IAIb,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,MAAM;IAIzB,gBAAgB,IAAI,KAAK,GAAG,SAAS;IAIrC,mEAAmE;IACnE,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,UAAU,IAAI,WAAW;IAOzB,MAAM,IAAI,WAAW;IAkJrB;;;;;;OAMG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAchC,kFAAkF;IAClF,IAAI,IAAI,IAAI;IAmDZ;;;;;;;;OAQG;IACH,aAAa,IAAI,IAAI;IA8CrB,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI;IAKrC,UAAU,IAAI,IAAI;IAIlB,OAAO,IAAI,IAAI;CAahB"}

package/types/ui/GiftPickerHero.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Gift picker hero — the top of the `giftPicker` sheet: the host bar, then the top offers'
+ * logos fanned out with a scatter of confetti dots, as PayRange's email gift picker drew it.
+ *
+ * Everything drawn is either the backend's (the host's name and icon, the offers'
+ * logos) or SDK-owned CSS/SVG (the fan's frames, the dots). No raster ships here.
+ *
+ *   fan        240×104 stage; centre tile 64 @ top 16, sides 56 at ±55px, ±12deg
+ *   dots       six circles in the same 240×104 box (CONFETTI_SVG)
+ *
+ * Motion is a one-shot CSS pop on the tiles and dots. The BASE styles are the finished
+ * state, so reduced motion, `animation: none` or a hidden tab all render the fan settled.
+ */
+import type { OfferModel as Offer } from '../api/models';
+/** How many logos the fan holds. The rest of the offers live in the sheet. */
+export declare const PICKER_TILE_LIMIT = 3;
+export interface GiftPickerHost {
+    /** `values.text.appName`. Without it there is no host bar at all. */
+    name?: string;
+    /** `values.media.appstoreIcon`. Optional: the bar degrades to the name alone. */
+    iconUrl?: string;
+}
+export declare class GiftPickerHero {
+    #private;
+    /** Build the host bar and the fan. Renders at most {@link PICKER_TILE_LIMIT} logos. */
+    render(offers: readonly Offer[], host?: GiftPickerHost): HTMLElement;
+    /** Re-point the logos after a promotion, without replaying the entrance. */
+    updateTiles(offers: readonly Offer[]): void;
+    destroy(): void;
+}
+//# sourceMappingURL=GiftPickerHero.d.ts.map

package/types/ui/GiftPickerHero.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GiftPickerHero.d.ts","sourceRoot":"","sources":["../../src/ui/GiftPickerHero.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAOzD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAYnC,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAc;;IAKzB,uFAAuF;IACvF,MAAM,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,IAAI,GAAE,cAAmB,GAAG,WAAW;IA6BxE,4EAA4E;IAC5E,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI;IAmF3C,OAAO,IAAI,IAAI;CAMhB"}

package/types/ui/giftCopy.d.ts

@@ -72,6 +72,13 @@ export declare const GIFT_COPY: {
     readonly sheetTitle: "Other gifts";
     /** Under the CTA. A middot separator, matching the artifact. */
     readonly terms: "One gift per person · Offer terms";
+    /** `giftPicker`: the same sentence split into lead and link, so "Offer terms" can link. */
+    readonly pickerTermsLead: "One gift per person ·";
+    readonly pickerTermsLink: "Offer terms";
+    /** `giftPicker`: the underlined link above the CTA that opens the other-gifts sheet. */
+    readonly moreGifts: "More gifts";
+    /** `giftPicker`'s CTA fallback when nothing about the gift fits the label. */
+    readonly getFallback: "Get your gift";
     /**
      * The `giftList` / `giftUnwrap` terms line, in two parts because the second is the
      * link: "By proceeding you agree to our offer terms". Rendered by `ui/termsLine.ts`,
@@ -93,6 +100,8 @@ export declare const GIFT_COPY: {
     /** `giftList`: the link under the rows that opens the "Other gifts" sheet. */
     readonly showMore: "Show more gifts";
 };
+/** The CTA's verb: `giftPicker` says "Get", every other gift surface "Claim". */
+export type GiftCtaVerb = 'Claim' | 'Get';
 /**
  * The advertiser as a display noun — who the user is about to be handed off to.
  *
@@ -161,7 +170,7 @@ export declare function giftBrandFirstText(offer: Offer): GiftBrandFirstText;
  * the button specific without letting it wrap. The brand is `giftHost`, so an offer
  * with a destination but no merchant name is still named rather than dropping to rung 3.
  */
-export declare function giftCtaLabel(offer: Offer): string;
+export declare function giftCtaLabel(offer: Offer, verb?: GiftCtaVerb): string;
 /**
  * The handoff sentence: what happens after the claim.
  *

package/types/ui/giftCopy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"giftCopy.d.ts","sourceRoot":"","sources":["../../src/ui/giftCopy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAGzD;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB,uEAAuE;;IAEvE;;;;OAIG;;IAEH,uFAAuF;;IAEvF;;;;;;;OAOG;;;IASH;;;;;;;;;;;;;;;OAeG;;IAEH;qFACiF;;IAEjF;;;OAGG;;IAEH,gEAAgE;;IAEhE;;;;OAIG;;;IAGH,gFAAgF;;IAEhF,iCAAiC;;IAEjC,sFAAsF;;IAEtF;;;OAGG;;IAEH,8EAA8E;;CAEtE,CAAC;AAeX;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAUzD;AAsBD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAItB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,GAC5D,MAAM,GAAG,SAAS,CAEpB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAKrD;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB,CAInE;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAYjD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAO1F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGjE;AA4BD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoBnF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAavF;AAWD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAenF"}
+{"version":3,"file":"giftCopy.d.ts","sourceRoot":"","sources":["../../src/ui/giftCopy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAGzD;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB,uEAAuE;;IAEvE;;;;OAIG;;IAEH,uFAAuF;;IAEvF;;;;;;;OAOG;;;IASH;;;;;;;;;;;;;;;OAeG;;IAEH;qFACiF;;IAEjF;;;OAGG;;IAEH,gEAAgE;;IAEhE,2FAA2F;;;IAG3F,wFAAwF;;IAExF,8EAA8E;;IAE9E;;;;OAIG;;;IAGH,gFAAgF;;IAEhF,iCAAiC;;IAEjC,sFAAsF;;IAEtF;;;OAGG;;IAEH,8EAA8E;;CAEtE,CAAC;AAeX,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAUzD;AAsBD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAItB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,GAC5D,MAAM,GAAG,SAAS,CAEpB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAKrD;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB,CAInE;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,WAAqB,GAAG,MAAM,CAY9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAO1F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGjE;AA4BD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoBnF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAavF;AAWD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAenF"}

package/types/ui/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/ui/styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAGX,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmOG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;IAI/B,0FAA0F;;CAElF,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAi8HD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,cAAmB,GAAG,IAAI,CAgB7D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAe1D;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7C"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/ui/styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAGX,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmOG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;IAI/B,0FAA0F;;CAElF,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAs3ID;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,cAAmB,GAAG,IAAI,CAgB7D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAe1D;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/types/ui/termsLine.d.ts

@@ -2,9 +2,10 @@
  * The terms line under the primary CTA on the `giftList` and `giftUnwrap` surfaces:
  * "By proceeding you agree to our offer terms", with "offer terms" underlined.
  *
- * It REPLACES the per-offer fine print on those two surfaces only. `giftReveal` keeps
- * `GIFT_COPY.terms` through `RewardActions.termsText`, and the carousel keeps its trust
- * line; neither calls this.
+ * It REPLACES the per-offer fine print on those surfaces, and `giftPicker` renders it
+ * in its own words ("One gift per person · Offer terms") via `lead`/`linkText`.
+ * `giftReveal` keeps `GIFT_COPY.terms` through `RewardActions.termsText`, and the
+ * carousel keeps its trust line; neither calls this.
  *
  * WHERE "offer terms" GOES is the selected offer's `termsUrl` (`campaign.termsUrl`, an
  * https URL the offer mapping has already vetted; it is checked again here). With one,
@@ -25,6 +26,10 @@ export interface TermsLineOptions {
     onOpen?: () => void;
     /** The selected offer's terms URL. https only; anything else renders as text. */
     termsUrl?: string;
+    /** The words before the link. Defaults to `GIFT_COPY.termsLead`. */
+    lead?: string;
+    /** The link's own words. Defaults to `GIFT_COPY.termsLink`. */
+    linkText?: string;
 }
 /** Builds `<p class="encore-gift-terms">…<a|span|button class="encore-gift-terms-link">`. */
 export declare function renderTermsLine(options?: TermsLineOptions): HTMLElement;

package/types/ui/termsLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"termsLine.d.ts","sourceRoot":"","sources":["../../src/ui/termsLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAQ3E;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKlF"}
+{"version":3,"file":"termsLine.d.ts","sourceRoot":"","sources":["../../src/ui/termsLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAQ3E;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUlF"}

package/types/utils/deviceOs.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Device OS Detection
+ *
+ * The end user's device OS, reported on every analytics event. Named
+ * `device_os`, never `platform`: `platform` here is always the literal `web`,
+ * the SDK's own runtime, and cannot answer iOS vs Android.
+ *
+ * Vocabulary is the backend click classifier's, plus the two values only a page
+ * can resolve, so one warehouse query reads both lanes. See
+ * `docs/architecture/platform-divergence/web.md` #5.
+ */
+/** What kind of thing made the request. Always stamped, mirrors the backend. */
+export declare const AgentType: {
+    readonly Browser: "browser";
+    readonly Bot: "bot";
+    readonly HttpClient: "http_client";
+    readonly Unknown: "unknown";
+};
+export type AgentType = (typeof AgentType)[keyof typeof AgentType];
+/** The end user's OS. ONLY operating systems: null when there is none to name. */
+export declare const DeviceOs: {
+    /** iPhone or iPod touch. */
+    readonly Ios: "ios";
+    readonly Android: "android";
+    /** An iPad, separated from a Mac by touch points. Never emitted server-side. */
+    readonly IpadOs: "ipados";
+    /** A Mac, separated from an iPad by touch points. Never emitted server-side. */
+    readonly MacOs: "macos";
+    /** An Apple desktop-class UA we could NOT split, matching the backend's bucket. */
+    readonly MacOsOrIpadOs: "macos_or_ipados";
+    readonly Windows: "windows";
+    /** Parsed, none of the above (Linux desktop, ChromeOS). */
+    readonly Other: "other";
+};
+export type DeviceOs = (typeof DeviceOs)[keyof typeof DeviceOs];
+export interface AgentClassification {
+    agentType: AgentType;
+    /** Non-null if and only if `agentType` is `browser`. */
+    deviceOs: DeviceOs | null;
+}
+/** Memoized: the user agent cannot change for the life of the page. */
+export declare function detectAgent(): AgentClassification;
+/** Test seam only: clears the memo so a stubbed navigator is re-read. */
+export declare function resetDeviceOsCache(): void;
+//# sourceMappingURL=deviceOs.d.ts.map

package/types/utils/deviceOs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceOs.d.ts","sourceRoot":"","sources":["../../src/utils/deviceOs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gFAAgF;AAChF,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE,kFAAkF;AAClF,eAAO,MAAM,QAAQ;IACnB,4BAA4B;;;IAG5B,gFAAgF;;IAEhF,gFAAgF;;IAEhF,mFAAmF;;;IAGnF,2DAA2D;;CAEnD,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAoFhE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,wDAAwD;IACxD,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC3B;AA6DD,uEAAuE;AACvE,wBAAgB,WAAW,IAAI,mBAAmB,CAGjD;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}