@encorekit/web-sdk 1.1.19 → 1.1.21

package/types/types.d.ts

@@ -71,6 +71,18 @@ export type NotGrantedReason = 'userClosedModal' | 'userClickedOutside' | 'userD
  */
 export interface PresentationResult {
     granted: boolean;
+    /**
+     * Human-readable reward text for display only (e.g. "3 months of Ahead free"),
+     * derived from the campaign's UI copy. NEVER use this for access control —
+     * entitlements are server-authoritative (verify on your backend).
+     */
+    reward?: string;
+    /**
+     * @deprecated Web entitlements are server-authoritative. Verify access on your backend via
+     * Encore's server-side entitlements API (`/entitlements/server`, HMAC-signed) — not from the
+     * client. This field is no longer populated from a trusted source and will be removed in the
+     * next major version. For display, use `reward`.
+     */
     entitlement?: EntitlementType;
     reason?: NotGrantedReason;
 }
@@ -83,29 +95,142 @@ export interface AppearanceConfig {
     accentColor?: string;
 }
 /**
- * Options for placement configuration
+ * `'thankYou'`-only priming copy shown ABOVE the offers — the lead-in pair between
+ * the payment status and the carousel, context for why offers are being shown (never
+ * any one offer's own copy). Ignored by the `'list'` layout, whose top heading is
+ * `header` instead: one name means one thing in every layout.
  */
-export interface OfferConfig {
+export interface OfferContextConfig {
     title?: string;
+    /**
+     * Context subtitle. When the active offer's campaign carries a `perk` line (e.g.
+     * "Enjoy 30 days of Apple Music free") the perk takes this slot and follows the
+     * carousel as it pages; this value is the per-placement fallback.
+     */
     subtitle?: string;
 }
-export interface CompletionConfig {
+/**
+ * Layout template for a placement presentation.
+ * - `'list'` (default): today's offer sheet — header copy + offer carousel.
+ * - `'thankYou'`: post-purchase success composition — status check + payment-status
+ *   header + intro copy + carousel + optional trust footer.
+ */
+export type PlacementLayout = 'list' | 'thankYou';
+/**
+ * The sheet's top heading block — in EVERY layout. In `'list'` it is the modal
+ * title/subtitle above the offers (local override of the remote copy); in
+ * `'thankYou'` it is the payment-status block (check + title + subtitle). The host
+ * supplies the copy — the SDK never invents payment facts.
+ */
+export interface PlacementHeaderConfig {
+    /**
+     * Status icon (`'thankYou'` only). `'success'` (default) renders a green-circle
+     * check; `'none'` hides it. Ignored by `'list'`.
+     */
+    icon?: 'success' | 'none';
+    /**
+     * Heading title. In `'list'` the sheet title (falls back to remote copy when
+     * omitted); in `'thankYou'` the status title, e.g. "Payment Successful"
+     * (omitted → not rendered).
+     */
     title?: string;
+    /**
+     * Heading subtitle (a plain constant string). In `'list'` the sheet subtitle; in
+     * `'thankYou'` the muted status line, where a `receipt` passed to `show()` takes
+     * precedence over this slot.
+     */
     subtitle?: string;
-    buttonText?: string;
-    typeText?: string;
-    amountText?: string;
 }
-export interface PlacementOptions {
+/** Trust footer for the `'thankYou'` layout. Omitted → not rendered. */
+export interface PlacementFooterConfig {
+    /** Small muted centered line, e.g. "🔒 Secured by Acme". */
+    text?: string;
+}
+/**
+ * Host-product display nouns for the deferred flow's SDK-composed copy (the S1
+ * header default, the primer screen, the redemption screen). Every field is optional
+ * in the TYPE because each resolves through a chain — local value, else remote
+ * /config (app name, native entitlement, app icon) — and requiredness is enforced at
+ * RUNTIME by the display contract (see core/DisplayResolver.ts). Display only;
+ * nothing here gates behavior.
+ */
+export interface HostDisplay {
+    /** Host product name, e.g. "PlanetVPN". Falls back to the remote app name. */
+    appDisplayName?: string;
+    /**
+     * Display-only trial length, e.g. "1 month" — never parsed. Falls back to the
+     * remote native-entitlement value + unit.
+     */
+    trialPeriod?: string;
+    /** Host logo URL (https). Falls back to the remote app icon when available. */
+    logoUrl?: string;
+}
+/**
+ * Options shared by every layout. Layout-specific options extend this — see
+ * ListPlacementOptions / ThankYouPlacementOptions; PlacementOptions is their union,
+ * discriminated on `layout`.
+ */
+export interface BasePlacementOptions {
     appearance?: AppearanceConfig;
-    offer?: OfferConfig;
-    completion?: CompletionConfig;
+    /** Top heading block: modal title in `'list'`, payment status in `'thankYou'`. */
+    header?: PlacementHeaderConfig;
+    /** Host display nouns — local override of the remote-config defaults. */
+    display?: HostDisplay;
+    /**
+     * Per-placement override of the configure() redemptionMode. Layout and mode are
+     * ORTHOGONAL axes: layout composes the UI; redemptionMode decides whether the
+     * claim redirects now ('immediate') or is decoupled from redemption ('deferred'
+     * — the host calls redeem() after its own conversion). Unusual combinations
+     * (e.g. 'thankYou' + 'deferred') are allowed and warned, not forbidden.
+     */
+    redemptionMode?: 'deferred' | 'immediate';
+}
+/** The default offer sheet. */
+export interface ListPlacementOptions extends BasePlacementOptions {
+    layout?: 'list';
+}
+/** The post-purchase success composition. */
+export interface ThankYouPlacementOptions extends BasePlacementOptions {
+    layout: 'thankYou';
+    /** Priming pair above the offers. */
+    offerContext?: OfferContextConfig;
+    /** Trust footer. Omitted → not rendered. */
+    footer?: PlacementFooterConfig;
+}
+export type PlacementOptions = ListPlacementOptions | ThankYouPlacementOptions;
+/**
+ * Per-transaction receipt details for the `'thankYou'` layout. Rendered by the SDK as
+ * "You paid {amount} for {purpose}" (or "You paid {amount}" without a purpose) in the
+ * payment-status subtitle slot. Values are rendered verbatim as text — pre-format the
+ * currency on your side.
+ */
+export interface Receipt {
+    /** Pre-formatted amount, e.g. "NGN 100". */
+    amount: string;
+    /** What was paid for, e.g. "Demo". */
+    purpose?: string;
+}
+/**
+ * Per-call options for show().
+ */
+export interface ShowOptions {
+    /**
+     * Per-transaction receipt for the `'thankYou'` layout. When provided it owns the
+     * payment-status subtitle (overriding `header.subtitle`). Ignored by `'list'`.
+     */
+    receipt?: Receipt;
 }
 /**
- * Optional callbacks for presentation events
+ * Presentation callbacks and show-time options
  */
-export interface PresentationOptions {
-    onGranted?: (entitlement: EntitlementType) => void;
+export interface PresentationOptions extends ShowOptions {
+    /**
+     * Fires when the user completes the offer flow (provisional grant). The argument is the
+     * deprecated, display-derived entitlement and may be `undefined`.
+     * @deprecated The structured `entitlement` argument is no longer trustworthy. Read
+     * `PresentationResult.reward` for display, and verify real access server-side. Removed next major.
+     */
+    onGranted?: (entitlement?: EntitlementType) => void;
     onNotGranted?: (reason: NotGrantedReason) => void;
     onError?: (error: EncoreError) => void;
 }
@@ -113,10 +238,13 @@ export interface PresentationOptions {
  * Builder pattern for placement API
  */
 export interface PlacementBuilder {
-    onGranted(callback: (entitlement: EntitlementType) => void): PlacementBuilder;
+    /** Fires when the sheet closes without a claim — carries the dismissal reason. */
     onNotGranted(callback: (reason: NotGrantedReason) => void): PlacementBuilder;
     onLoadingStateChange(callback: (isLoading: boolean) => void): PlacementBuilder;
-    show(): Promise<PresentationResult>;
+    /** Same bare ShowResult contract as Encore.show(). Never rejects. */
+    show(options?: ShowOptions): Promise<ShowResult>;
+    /** Redeem the transaction made at this placement — phase 2 of the two-phase flow. */
+    redeem(): Promise<RedeemResult>;
 }
 /**
  * Error codes used throughout the SDK
@@ -148,7 +276,9 @@ export interface EncoreError {
  */
 export type VerificationStatus = 'pending' | 'verified' | 'failed' | 'timeout' | 'cancelled';
 /**
- * UI Configuration options
+ * Presentation copy slots consumed by the offer UI. Populated from the remote
+ * /config payload and overridden per-call via placement options — NOT part of
+ * EncoreConfig (configure() is connection/behavior settings only).
  */
 export interface UIConfiguration {
     titleText?: string;
@@ -162,17 +292,153 @@ export interface UIConfiguration {
     creditClaimedTitleText?: string;
     creditClaimedSubtitleText?: string;
     applyCreditsButtonText?: string;
+    /** App name for reward template substitution (e.g. "Tinder Plus"). Display only. */
+    appName?: string;
+    /** Reward value for template substitution (e.g. "3"). Display only — not an entitlement. */
+    entitlementValue?: string;
+    /** Reward unit for template substitution (e.g. "months"). Display only — not an entitlement. */
+    entitlementUnit?: string;
 }
 /**
  * Main SDK configuration options
  */
 export interface EncoreConfig {
     apiKey: string;
-    userId?: string | undefined;
-    baseURL?: string;
     environment?: 'production' | 'development' | 'staging' | 'localhost';
     logLevel?: 'none' | 'debug';
-    uiConfiguration?: UIConfiguration;
+    /**
+     * Redemption flow:
+     * - 'deferred' (default): show() resolves when the user CLAIMS an offer (a transaction
+     *   record is created, NO redirect). The host runs its own conversion, then calls
+     *   redeem() to render the redemption screen + send the user to the advertiser.
+     * - 'immediate': the legacy one-step flow — claiming an offer redirects to the
+     *   advertiser and shows the success screen inline (no separate redeem() call).
+     * This is a control-flow contract (it changes what host code must call), so it is
+     * a LOCAL config value, not remote.
+     */
+    redemptionMode?: 'deferred' | 'immediate';
+}
+/**
+ * Offer descriptor carried on a transaction — enough to render the redemption screen AND
+ * to rebuild the advertiser redirect at redeem() time (so the deferred flow never
+ * needs the live offer again). `advertiserUrl` may contain a TRANSACTION_ID
+ * placeholder, substituted with the transaction id when the redemption fires.
+ */
+export interface OfferRef {
+    id: string;
+    campaignId: string;
+    advertiserUrl: string;
+    trackingParameters?: Record<string, string>;
+    advertiserName?: string;
+    /** Display-only reward copy (e.g. "30 days of Apple Music"). NOT an entitlement. */
+    reward?: string;
+    imageUrl?: string;
+    logoUrl?: string;
+}
+/**
+ * A claimed offer awaiting redemption. Claiming starts a transaction, and the
+ * returned `transactionId` is this transaction's durable handle (the same id used by
+ * `didGrant`, `waitForVerification`, and the backend).
+ */
+export interface Transaction {
+    id: string;
+    /** The persistent account identity this transaction is bound to (app_account_id). */
+    appAccountId: string;
+    /** The placement the offer was claimed at, if any (keys the local placement->transaction map). */
+    placementId?: string;
+    offer: OfferRef;
+    /**
+     * The layout of the placement the claim happened on — claim provenance (a
+     * transactional fact, like placementId). Drives which redemption narrative
+     * renders: a 'list' claim earns the activation story (host trial + ledger); a
+     * 'thankYou' claim renders the minimal reward story. Absent on legacy
+     * transactions → reward (the safe minimal narrative).
+     */
+    claimLayout?: PlacementLayout;
+    status: 'claimed' | 'redeemed';
+    /** ISO-8601 timestamps. */
+    createdAt: string;
+    expiresAt: string;
+    redeemedAt?: string;
+}
+/** Result of `show()` / `present()`. */
+export type ShowResult = 
+/**
+ * The user claimed an offer. A transaction was recorded SDK-side, and in
+ * 'immediate' mode the advertiser was also opened in a new tab; the SDK
+ * renders nothing after a claim — the host owns that moment. Deliberately
+ * NOT a conversion claim: advertiser conversion is asynchronous and
+ * server-authoritative; check it server-side by user (never from the client).
+ * In 'deferred' mode, call redeem() after your own conversion work — the SDK
+ * resolves the pending transaction internally; no handle needed.
+ */
+{
+    status: 'claimed';
+}
+/** The user dismissed the carousel without claiming. */
+ | {
+    status: 'dismissed';
+    reason?: NotGrantedReason;
+}
+/** No eligible offers (or a control-cohort ghost trigger). */
+ | {
+    status: 'unavailable';
+};
+/** Options for `redeem()`. */
+export interface RedeemOptions {
+    /**
+     * Resolve the transaction made at this placement (the local placement->transaction map). When
+     * passed via Encore.placement(id).redeem() this is the placement id. If no transaction
+     * exists for the placement, resolves `none` — it never crosses to another placement.
+     */
+    placement?: string;
+    /**
+     * Host product row for the redemption screen's deal ledger. Override-only: name
+     * and logo default from the same display resolution show() uses (live remote
+     * config), so most integrations never pass this. The trial-end detail line is
+     * always DERIVED (remote durationDays + the redemption moment) — not settable.
+     */
+    host?: {
+        name?: string;
+        status?: string;
+        logoUrl?: string;
+    };
+}
+/** Result of `redeem()`. */
+export type RedeemResult = 
+/** The advertiser redirect was performed for the pending transaction. */
+{
+    status: 'redeemed';
+}
+/**
+ * The sheet closed without redeeming. `reason` mirrors show(): user-driven
+ * closes carry no reason or a user reason; internal failures carry
+ * `{ type: 'error', error }` — redeem() never rejects. On an error the pending
+ * transaction is untouched, so calling redeem() again later is safe.
+ */
+ | {
+    status: 'dismissed';
+    reason?: NotGrantedReason;
+} | {
+    status: 'expired';
+}
+/** STRICTLY "no pending transaction to redeem" — never an error disguise. */
+ | {
+    status: 'none';
+};
+/**
+ * A subscription/conversion event forwarded from the host (Tier-1 client signal).
+ * NON-AUTHORITATIVE — posted via the pk-authed analytics channel, never the HMAC
+ * webhook. Use server-to-server webhooks (apple/google/revenuecat/superwall/encore)
+ * for authoritative revenue truth.
+ */
+export interface SubscriptionEvent {
+    type: 'did_subscribe' | 'did_renew' | 'did_cancel' | 'did_convert' | (string & {});
+    plan?: string;
+    price?: number;
+    currency?: string;
+    productId?: string;
+    [key: string]: unknown;
 }
 /**
  * Event handler function type

package/types/types.d.ts.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"OfferCard.d.ts","sourceRoot":"","sources":["../../src/ui/OfferCard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAMpD,UAAU,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IACxB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,qBAAa,SAAS;;;IAUpB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW;IAkBjC;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAClC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,MAAM,IAAI;IA8Jb;;OAEG;IACH,OAAO,IAAI,IAAI;CAUhB"}
+{"version":3,"file":"OfferCard.d.ts","sourceRoot":"","sources":["../../src/ui/OfferCard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAOpD,UAAU,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IACxB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,qBAAa,SAAS;;;IAUpB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW;IAkBjC;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAClC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,MAAM,IAAI;IAgKb;;OAEG;IACH,OAAO,IAAI,IAAI;CAUhB"}

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/PrimerScreen.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Primer Screen Component (S1.5 of the deferred flow)
+ *
+ * Rendered into the open OfferModal immediately after a deferred-mode claim: the
+ * handoff moment that converts claim momentum into starting the host's own trial.
+ * Dual-brand lockup (partner + host), SDK-composed copy from the resolved display
+ * nouns, and a single forward CTA. show()'s promise settles on this screen's CTA
+ * or on any modal dismissal — both resolve 'claimed' (the claim is a fact either
+ * way); dismissal is the modal's own X-chrome, not a control here.
+ */
+import { type ResolvedDisplay } from '../core/DisplayResolver';
+export interface PrimerScreenConfig {
+    /** Resolved host display nouns (guard-validated before Screen 1 rendered). */
+    display: ResolvedDisplay;
+    /** Partner branding from the just-claimed offer. */
+    partner: {
+        name?: string;
+        logoUrl?: string;
+        imageUrl?: string;
+    };
+}
+interface PrimerScreenEventMap extends Record<string, unknown> {
+    /** The user tapped the forward CTA — caller settles 'claimed' and closes. */
+    continue: undefined;
+}
+export declare class PrimerScreen {
+    #private;
+    constructor(config: PrimerScreenConfig);
+    render(): HTMLElement;
+    on<K extends keyof PrimerScreenEventMap>(event: K, handler: (payload: PrimerScreenEventMap[K]) => void): () => void;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=PrimerScreen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PrimerScreen.d.ts","sourceRoot":"","sources":["../../src/ui/PrimerScreen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG5E,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,OAAO,EAAE,eAAe,CAAC;IACzB,oDAAoD;IACpD,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED,UAAU,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,6EAA6E;IAC7E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,qBAAa,YAAY;;gBAKX,MAAM,EAAE,kBAAkB;IAKtC,MAAM,IAAI,WAAW;IA+CrB,EAAE,CAAC,CAAC,SAAS,MAAM,oBAAoB,EACrC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,GAClD,MAAM,IAAI;IAIb,OAAO,IAAI,IAAI;CAQhB"}

package/types/ui/RedemptionScreen.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Redemption Screen Component (S2 of the deferred flow)
+ *
+ * Phase 2, shown by redeem(). The NARRATIVE is a function of the claim's
+ * originating surface (Transaction.claimLayout), expressed as a variant map of
+ * separate builders — extensible by adding an entry, never by threading more
+ * conditionals through one render path:
+ *
+ * - 'activation' (claims from the 'list' handoff flow): the host conversion just
+ *   completed — dual-brand lockup, "your trial is active" copy, and the deal
+ *   ledger (host row Active with the derived trial-end detail, partner Pending).
+ * - 'reward' (claims from 'thankYou' or unknown/legacy provenance): there was no
+ *   host-unlock moment — minimal congratulations + the pending partner row.
+ *
+ * Both variants share the same chrome: reassurance note + one CTA ("Claim your
+ * reward") that sends the user to the advertiser inside the click gesture.
+ */
+type RedemptionVariant = 'activation' | 'reward';
+interface RedemptionScreenConfig {
+    /** Which narrative to render. Defaults to 'reward' (the safe minimal story). */
+    variant?: RedemptionVariant;
+    /** 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;
+    /**
+     * Host product context — consumed by the 'activation' variant only (resolved
+     * from live remote config + the redeem() host override by the caller).
+     */
+    host?: {
+        name?: string;
+        trialPeriod?: string;
+        /** Status chip text; defaults to "Active". */
+        status?: string;
+        /** Derived trial-end line, e.g. "Free until August 8, 2026". */
+        detail?: string;
+        logoUrl?: string;
+    };
+    /** Optional CTA override; default is exactly "Claim your 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;;;;;;;;;;;;;;;;GAgBG;AAQH,KAAK,iBAAiB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEjD,UAAU,sBAAsB;IAC9B,gFAAgF;IAChF,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,+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;;;OAGG;IACH,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,8CAA8C;QAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gEAAgE;QAChE,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,wBAAyB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,4EAA4E;IAC5E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAmED,qBAAa,gBAAgB;;gBAKf,MAAM,EAAE,sBAAsB;IAK1C,MAAM,IAAI,WAAW;IA+BrB,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;CAQhB"}

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/brandComponents.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared brand components for the deferred-flow screens.
+ *
+ * The dual-brand lockup (partner + host tiles) and the deal-ledger row are the
+ * continuity thread between the primer screen (S1.5) and the redemption screen
+ * (S2) — one implementation, consumed by both. Pure render functions in the
+ * ThankYouLayout style: no state, no events.
+ *
+ * Rendering hardening lives here once for every consumer:
+ * - URL scheme guard via safeImageSrc (reject → monogram tile)
+ * - monogram rendered IMMEDIATELY and swapped to the <img> only when it has
+ *   loaded — a slow remote logo never shows an empty tile mid-animation
+ * - explicit dimensions + decoding="async", alt text on every logo
+ */
+export interface BrandRef {
+    name?: string;
+    logoUrl?: string;
+}
+/**
+ * The dual-brand lockup: partner tile and host tile, gently overlapped —
+ * "two brands, one deal". Rendered at the top of the primer and redemption
+ * screens. Motion (the settle) is pure CSS and respects prefers-reduced-motion
+ * via the stylesheet's global override.
+ */
+export declare function renderDualBrandLockup(partner: BrandRef, host: BrandRef): HTMLElement;
+export interface LedgerRowConfig {
+    brand: BrandRef;
+    /** Primary line, e.g. "PlanetVPN" or "Apple Music deal". */
+    name: string;
+    /** Secondary muted line, e.g. "Free until August 3, 2026" or the reward copy. */
+    detail?: string;
+    /** Status chip text + tone. Active renders in the success color. */
+    status: {
+        text: string;
+        tone: 'active' | 'pending';
+    };
+}
+/** The ledger container: rows stacked with hairline dividers. */
+export declare function renderLedger(rows: LedgerRowConfig[]): HTMLElement;
+/**
+ * The screens' single forward CTA: the clean pill button (encore-button-claim)
+ * made full-width by the given per-screen modifier class.
+ */
+export declare function renderCtaButton(text: string, modifierClass: string, onClick: () => void): HTMLButtonElement;
+//# sourceMappingURL=brandComponents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brandComponents.d.ts","sourceRoot":"","sources":["../../src/ui/brandComponents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,WAAW,CAmBpF;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,CAAC;IAChB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;KAAE,CAAC;CACtD;AAoCD,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,WAAW,CAKjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,IAAI,GAClB,iBAAiB,CAOnB"}