@encorekit/web-sdk 1.1.18 → 1.1.20

package/types/ui/OfferCarousel.d.ts

@@ -4,6 +4,15 @@
  */
 import type { OfferModel as Offer } from '../api/models';
 import type { UIConfiguration } from '../types';
+export interface OfferCarouselOptions {
+    /**
+     * 'responsive' (default): today's behavior — horizontal carousel on desktop, vertical
+     * full-screen list on mobile (viewport-derived).
+     * 'paged' (thankYou layout): always-horizontal, one-card-per-view, scroll-snap paged
+     * carousel at every breakpoint, with chevron nav bubbles.
+     */
+    mode?: 'responsive' | 'paged';
+}
 interface CarouselEventMap extends Record<string, unknown> {
     offerClaim: {
         offer: Offer;
@@ -22,7 +31,7 @@ interface CarouselEventMap extends Record<string, unknown> {
 }
 export declare class OfferCarousel {
     #private;
-    constructor(offers: Offer[], uiConfig?: UIConfiguration);
+    constructor(offers: Offer[], uiConfig?: UIConfiguration, options?: OfferCarouselOptions);
     /**
      * Render the carousel
      */
@@ -40,11 +49,13 @@ export declare class OfferCarousel {
      */
     getTotalOffers(): number;
     /**
-     * Navigate to next offer
+     * Navigate to next offer. A user INTENT: commits domain state immediately (so
+     * semantic UI updates once, and rapid clicks chain naturally), then runs the
+     * scroll as an effect. The highlight is not touched — it follows the motion.
      */
     next(): void;
     /**
-     * Navigate to previous offer
+     * Navigate to previous offer — see next().
      */
     previous(): void;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"OfferCarousel.d.ts","sourceRoot":"","sources":["../../src/ui/OfferCarousel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMhD,UAAU,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,UAAU,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChC;AAED,qBAAa,aAAa;;gBAaZ,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe;IAavD;;OAEG;IACH,MAAM,IAAI,WAAW;IAoDrB;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACjC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC9C,MAAM,IAAI;IAIb;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,QAAQ,IAAI,IAAI;IA+ShB;;OAEG;IACH,OAAO,IAAI,IAAI;CAkBhB"}
+{"version":3,"file":"OfferCarousel.d.ts","sourceRoot":"","sources":["../../src/ui/OfferCarousel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMhD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;CAC/B;AAED,UAAU,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,UAAU,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChC;AAED,qBAAa,aAAa;;gBAgDZ,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAcvF;;OAEG;IACH,MAAM,IAAI,WAAW;IAgLrB;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACjC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC9C,MAAM,IAAI;IAIb;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,QAAQ,IAAI,IAAI;IA+YhB;;OAEG;IACH,OAAO,IAAI,IAAI;CAqBhB"}

package/types/ui/OfferModal.d.ts

@@ -24,6 +24,12 @@ export declare class OfferModal {
      * Check if modal is currently visible
      */
     isVisible(): boolean;
+    /**
+     * Re-point the dialog's accessible name. Layout templates whose visually-primary
+     * heading is not the carousel title (thankYou) pass the id of their own heading so
+     * screen readers announce the dialog by what the user actually sees.
+     */
+    setLabelledBy(id: string): void;
     /**
      * Set modal content
      */

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

@@ -1 +1 @@
-{"version":3,"file":"OfferModal.d.ts","sourceRoot":"","sources":["../../src/ui/OfferModal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,UAAU,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,KAAK,EAAE,IAAI,CAAC;IACZ,aAAa,EAAE,IAAI,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,qBAAa,UAAU;;gBAWT,KAAK,GAAE,cAAmB;IAOtC;;OAEG;IACH,IAAI,IAAI,IAAI;IAqCZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAyBZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IActC;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAC9B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,MAAM,IAAI;IA6Ib;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}
+{"version":3,"file":"OfferModal.d.ts","sourceRoot":"","sources":["../../src/ui/OfferModal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,UAAU,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,KAAK,EAAE,IAAI,CAAC;IACZ,aAAa,EAAE,IAAI,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,qBAAa,UAAU;;gBAWT,KAAK,GAAE,cAAmB;IAOtC;;OAEG;IACH,IAAI,IAAI,IAAI;IAqCZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAyBZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IActC;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAC9B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,MAAM,IAAI;IA6Ib;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/types/ui/RedemptionScreen.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Redemption Screen Component
+ *
+ * Phase 2 of the two-phase flow: shown by redeem() after the host's own
+ * conversion. Presents the claimed partner offer as a "Pending" reward card with
+ * a single clean CTA that sends the user to the advertiser. Intentionally does
+ * NOT render the host's "active" product block — that content (app suite, perks)
+ * varies per integrator and isn't worth rendering generically.
+ */
+interface RedemptionScreenConfig {
+    /** Display reward copy, e.g. "30 days of free Apple Music". */
+    reward?: string;
+    /** Advertiser/partner name, e.g. "Apple Music". */
+    advertiserName?: string;
+    /** Partner logo (preferred) or a fallback image. */
+    logoUrl?: string;
+    imageUrl?: string;
+    /** Optional CTA override; otherwise derived from the reward. */
+    buttonText?: string;
+}
+interface RedemptionScreenEventMap extends Record<string, unknown> {
+    /** The user tapped the claim CTA — caller fires the advertiser redirect. */
+    continue: undefined;
+}
+export declare class RedemptionScreen {
+    #private;
+    constructor(config: RedemptionScreenConfig);
+    render(): HTMLElement;
+    on<K extends keyof RedemptionScreenEventMap>(event: K, handler: (payload: RedemptionScreenEventMap[K]) => void): () => void;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=RedemptionScreen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RedemptionScreen.d.ts","sourceRoot":"","sources":["../../src/ui/RedemptionScreen.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,UAAU,sBAAsB;IAC9B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,wBAAyB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,4EAA4E;IAC5E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,qBAAa,gBAAgB;;gBAKf,MAAM,EAAE,sBAAsB;IAK1C,MAAM,IAAI,WAAW;IAoErB,EAAE,CAAC,CAAC,SAAS,MAAM,wBAAwB,EACzC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,GACtD,MAAM,IAAI;IAIb,OAAO,IAAI,IAAI;CA6BhB"}

package/types/ui/ThankYouLayout.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Thank-You Layout — the 'thankYou' placement template.
+ *
+ * Pure chrome around the unchanged OfferCarousel: a payment-status block (success
+ * check + host-supplied title/subtitle) above, an optional trust footer below. A pure
+ * render function rather than a component class: the layout is static content with no
+ * events, no listeners, and no state — the carousel keeps its own lifecycle and is
+ * passed in as a ready element.
+ */
+import type { PlacementHeaderConfig, PlacementFooterConfig, PlacementLayout, Receipt } from '../types';
+/**
+ * The id given to the thankYou status heading so the dialog's accessible name can
+ * point at the layout's real primary heading (the carousel title is demoted to intro
+ * copy in this layout).
+ */
+export declare const THANKYOU_TITLE_ID: string;
+/**
+ * Tolerant-reader layout resolution. Never trust the TS union at runtime: plain-JS/UMD
+ * callers can pass anything, and a future server-driven selector may send a layout
+ * name this SDK version predates. Unknown values warn and fall back to 'list' so older
+ * shipped SDKs degrade gracefully.
+ */
+export declare function resolveLayout(value: unknown): PlacementLayout;
+export interface ThankYouLayoutOptions {
+    header?: PlacementHeaderConfig;
+    footer?: PlacementFooterConfig;
+    /** Per-transaction receipt — owns the subtitle slot when provided. */
+    receipt?: Receipt;
+}
+/**
+ * Compose the thankYou sheet: status (check → title → subtitle) → carousel → footer.
+ * All host-supplied copy is set via textContent (text-only, injection-safe).
+ */
+export declare function renderThankYouLayout(carouselElement: HTMLElement, options?: ThankYouLayoutOptions): HTMLElement;
+//# sourceMappingURL=ThankYouLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThankYouLayout.d.ts","sourceRoot":"","sources":["../../src/ui/ThankYouLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,OAAO,EACR,MAAM,UAAU,CAAC;AAOlB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAwB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAO7D;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAqCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,WAAW,EAC5B,OAAO,GAAE,qBAA0B,GAClC,WAAW,CAkDb"}

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;AAQH,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAGX,eAAO,MAAM,WAAW;;;;CAId,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;AAkvBD;;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,KAAK,EAAE,cAAc,GAAG,IAAI,CAUvD;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;AAQH,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAGX,eAAO,MAAM,WAAW;;;;CAId,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;AAm0CD;;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,KAAK,EAAE,cAAc,GAAG,IAAI,CAUvD;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/examples/react/.env.local

@@ -1 +0,0 @@
-VITE_ENCORE_API_KEY=pk_test_s71ycgmiukgc9myuvnv886lz

package/types/__tests__/react.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=react.test.d.ts.map

package/types/__tests__/react.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"react.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/react.test.tsx"],"names":[],"mappings":""}

package/types/ui/SuccessScreen.d.ts

@@ -1,33 +0,0 @@
-/**
- * Success Screen Component
- * Displays success feedback after entitlement is granted
- */
-import { EntitlementType } from '../types';
-interface SuccessScreenConfig {
-    entitlement: EntitlementType;
-    titleText?: string;
-    subtitleText?: string;
-    buttonText?: string;
-    autoDismissMs?: number;
-}
-interface SuccessScreenEventMap extends Record<string, unknown> {
-    continue: undefined;
-}
-export declare class SuccessScreen {
-    #private;
-    constructor(config: SuccessScreenConfig);
-    /**
-     * Render the success screen
-     */
-    render(): HTMLElement;
-    /**
-     * Subscribe to events
-     */
-    on<K extends keyof SuccessScreenEventMap>(event: K, handler: (payload: SuccessScreenEventMap[K]) => void): () => void;
-    /**
-     * Destroy the success screen
-     */
-    destroy(): void;
-}
-export {};
-//# sourceMappingURL=SuccessScreen.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SuccessScreen.d.ts","sourceRoot":"","sources":["../../src/ui/SuccessScreen.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM3C,UAAU,mBAAmB;IAC3B,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,qBAAsB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,qBAAa,aAAa;;gBAMZ,MAAM,EAAE,mBAAmB;IAKvC;;OAEG;IACH,MAAM,IAAI,WAAW;IAgDrB;;OAEG;IACH,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;;OAEG;IACH,OAAO,IAAI,IAAI;CAiGhB"}