@encorekit/web-sdk 2.2.1 → 2.4.0

package/types/core/claimLog.d.ts

@@ -0,0 +1,102 @@
+/**
+ * The on-device claim log: the claims this browser saw a user make in any Encore
+ * sheet, so a GiftsButton spot can turn into the claim reminder right after a claim and
+ * after a reload. INTERNAL. Never sent to the server; once the claims API is bound its
+ * list wins for the same transaction (see `mergeReminderClaims`).
+ *
+ * Kept per user id, at most 50 rows each, for 720 hours. localStorage when it works,
+ * and always a copy in memory, so a page whose storage throws still remembers its own
+ * claims. `reset()` clears it; an anonymous user's rows move to the id they identify as.
+ */
+import type { ReminderClaim } from '../triggers/claimReminder/source';
+/** One claim as the log keeps it. */
+export interface ClaimLogRow {
+    /** The transaction id, or `campaign:<campaignId>` when the claim had none. */
+    id: string;
+    transactionId?: string;
+    campaignId: string;
+    advertiserName: string;
+    logoUrl?: string;
+    /** The offer's perk as the sheet showed it ("3 months free"), in the language of that sheet. */
+    perk?: string;
+    /** Epoch ms. */
+    claimedAt: number;
+    useCase: string;
+    placement?: string;
+    /** Ended (completed, expired or failed): no longer a claim to remind about. */
+    finished?: true;
+    /** Epoch ms the claim was completed (verified or granted). Absent when open, or when it only ended. */
+    completedAt?: number;
+    /** Epoch ms the thanks look (or `Encore.claim`'s thanks state) for this completion was tapped. */
+    thanksTappedAt?: number;
+}
+/** Where the log persists. StorageManager's `get` and `set`; either may fail silently. */
+export interface ClaimLogStore {
+    get<T>(key: string): T | null;
+    set<T>(key: string, value: T): void;
+    remove(key: string): void;
+}
+export declare const CLAIM_LOG_KEY = "claim_log";
+export declare const CLAIM_LOG_MAX_ROWS = 50;
+export declare const CLAIM_LOG_RETENTION_MS: number;
+/** A local row the server's fresh list leaves out is dropped once it is this old. */
+export declare const SERVER_LAG_MS: number;
+export declare class ClaimLog {
+    #private;
+    constructor(store: ClaimLogStore, now?: () => number);
+    /** Note a claim. A claim with no advertiser name is kept but never reminded about. */
+    record(userId: string, claim: Omit<ClaimLogRow, 'id' | 'claimedAt'> & {
+        claimedAt?: number;
+    }): void;
+    /**
+     * Mark a claim ended: the reminder no longer shows it. `completed` (verified, granted)
+     * also stamps when, for what a spot shows after a completion; expired and failed end it
+     * without one.
+     * Returns whether anything changed.
+     */
+    finish(transactionId: string, completed?: boolean): boolean;
+    /**
+     * This user completed a claim on `now`'s local day and has made none since
+     * (an `Encore.claim` view whose rules say `afterComplete: hide`).
+     */
+    completedToday(userId: string, now: number): boolean;
+    /**
+     * As `completedToday`, and the thanks look for that completion has not been tapped
+     * yet: a trigger's `completed` state, and an `Encore.claim` view whose rules say `afterComplete: thanks`.
+     */
+    thanksDue(userId: string, now: number): boolean;
+    /**
+     * The completion `thanksDue` is for, so each completion counts its own view and marks
+     * its own hide: its claim's transaction id, else its completion time in epoch ms. Else null.
+     */
+    thanksFor(userId: string, now: number): string | null;
+    /** The thanks look was tapped: it ends for this user's latest completion. */
+    thanksTapped(userId: string): void;
+    /** This user's open claims (not finished), newest first. */
+    open(userId: string): ClaimLogRow[];
+    /** Whether this user's claim for `transactionId` is in the log and ended. */
+    finished(userId: string, transactionId: string): boolean;
+    /** An anonymous user identified: their rows become the identified user's. */
+    carryOver(fromUserId: string, toUserId: string): void;
+    /**
+     * Forget every row (reset). Another tab's in-memory copy can write its rows back on
+     * its next write; accepted, since that tab is the same browser and its next reset or
+     * reload clears it.
+     */
+    clear(): void;
+    /**
+     * TEST AND DEMO ONLY: move every row of this user `ms` into the past, so a reminder
+     * window can be ended without waiting.
+     */
+    age(userId: string, ms: number): void;
+}
+/** A log row as the reminder reads a claim. */
+export declare function reminderClaimOf(row: ClaimLogRow): ReminderClaim;
+/**
+ * The reminder's claims: the claims API's list when one is bound, plus local rows it
+ * does not have yet. The server wins for the same transaction; a local row the server
+ * does not list is kept only while it is younger than `SERVER_LAG_MS` (the server may
+ * not have it yet), then dropped. A row without a transaction id matches by campaign.
+ */
+export declare function mergeReminderClaims(local: readonly ClaimLogRow[], server: readonly ReminderClaim[] | null, now: number): ReminderClaim[];
+//# sourceMappingURL=claimLog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimLog.d.ts","sourceRoot":"","sources":["../../src/core/claimLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,uGAAuG;IACvG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IAC9B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,sBAAsB,QAAuB,CAAC;AAC3D,qFAAqF;AACrF,eAAO,MAAM,aAAa,QAAiB,CAAC;AAgF5C,qBAAa,QAAQ;;gBAMP,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,MAAM,MAAyB;IA+BtE,sFAAsF;IACtF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAcnG;;;;;OAKG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,OAAO;IAsBxD;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAQpD;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAI/C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUrD,6EAA6E;IAC7E,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA4BlC,4DAA4D;IAC5D,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAQnC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;IAQxD,6EAA6E;IAC7E,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAcrD;;;;OAIG;IACH,KAAK,IAAI,IAAI;IASb;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAWtC;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAU/D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,EACvC,GAAG,EAAE,MAAM,GACV,aAAa,EAAE,CASjB"}

package/types/core/claimRefusal.d.ts

@@ -0,0 +1,3 @@
+/** True when a claim failed because the server says it was already completed. */
+export declare function isAlreadyCompletedRefusal(error: unknown): boolean;
+//# sourceMappingURL=claimRefusal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimRefusal.d.ts","sourceRoot":"","sources":["../../src/core/claimRefusal.ts"],"names":[],"mappings":"AAeA,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIjE"}

package/types/core/claimScreenVariant.d.ts

@@ -0,0 +1,3 @@
+/** Whether the served variant's claim shows the claim screen. */
+export declare function showsClaimScreen(variantName: string | null | undefined): boolean;
+//# sourceMappingURL=claimScreenVariant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimScreenVariant.d.ts","sourceRoot":"","sources":["../../src/core/claimScreenVariant.ts"],"names":[],"mappings":"AAYA,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEhF"}

package/types/core/claimStatusCheck.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Whether the user's open claims ended, asked of the server
+ * (`GET /transactions/{id}/status`, the stored status: never `verify`, which would call
+ * the advertiser; the server's poller keeps the stored status current) and written to
+ * the claim log. INTERNAL.
+ *
+ * Callers run it before the reminder draws (a mount, a page visible again, and a
+ * GiftsButton spot's own re-reads at a window's end or midnight) and when a tap re-opens
+ * the sheet for a claim (without waiting: on the web the
+ * sheet must open inside the click, where native waits up to 1.5 s). It asks about the
+ * newest open claims only, each at most once per 5 minutes (jittered; a failed ask
+ * counts), until the claim is past its 720 hour window, one claim at a time. Callers at
+ * the same time share one request per claim, and a 429 stops the round and pauses every
+ * check. The answers' times and the pause are kept in storage, so they hold across page
+ * loads and tabs. The bounds are in
+ * {@link CLAIM_CHECK_BOUNDS}, the same on every platform.
+ */
+import type { ClaimLog } from './claimLog';
+export interface ClaimCheckBounds {
+    /** The newest open claims asked about per check. */
+    maxPerCheck: number;
+    /** How long one claim's answer (or failure) stands before it is asked again. Jittered. */
+    cacheMs: number;
+    /** No check once the claim is this old (its longest reminder window). */
+    windowMs: number;
+    /** Every check pauses this long after a 429. */
+    rateLimitPauseMs: number;
+}
+export declare const CLAIM_CHECK_BOUNDS: Readonly<ClaimCheckBounds>;
+/** The server's status for a transaction (the backend's raw value), or null. Rejects on failure. */
+export type ClaimStatusRead = (transactionId: string) => Promise<string | null | undefined>;
+/**
+ * Where the per-claim answers and the 429 pause are kept across page loads and tabs, so
+ * the 5 minutes and the pause hold for the browser, not one page. StorageManager's slot.
+ */
+export interface ClaimStatusStore {
+    get(): unknown;
+    set(value: unknown): void;
+}
+export declare class ClaimStatusCheck {
+    #private;
+    /** Called whenever a check ends a claim, even one answered after its caller stopped waiting. */
+    onEnded: (() => void) | null;
+    constructor(status: ClaimStatusRead, now?: () => number, jitter?: () => number, bounds?: Readonly<ClaimCheckBounds>, store?: ClaimStatusStore | null);
+    /**
+     * Before the reminder draws: ask about the newest open claims that are due (skipping
+     * the ones `dismissed` names), and finish
+     * the ones that ended. Resolves true when one of them ended (here, or in a request
+     * this check joined). Never rejects.
+     */
+    run(log: ClaimLog, userId: string, dismissed?: (transactionId: string) => boolean): Promise<boolean>;
+    /**
+     * A tap on a reminder for this claim, about to open the sheet: false when the log
+     * already knows it ended. Otherwise true, and the claim is asked about now if it is
+     * due, without waiting: the sheet must open inside the click, so an answer lands
+     * through `onEnded`. Never throws.
+     */
+    beforeTap(transactionId: string, log: ClaimLog, userId: string): boolean;
+    /** Another person: what this page knew about the last one's claims no longer applies. */
+    forget(): void;
+}
+//# sourceMappingURL=claimStatusCheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimStatusCheck.d.ts","sourceRoot":"","sources":["../../src/core/claimStatusCheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,gBAAgB,CAKxD,CAAC;AAOH,oGAAoG;AACpG,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAQ5F;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,IAAI,OAAO,CAAC;IACf,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAiCD,qBAAa,gBAAgB;;IAa3B,gGAAgG;IAChG,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAGlC,MAAM,EAAE,eAAe,EACvB,GAAG,GAAE,MAAM,MAAyB,EACpC,MAAM,GAAE,MAAM,MAAwC,EACtD,MAAM,GAAE,QAAQ,CAAC,gBAAgB,CAAsB,EACvD,KAAK,GAAE,gBAAgB,GAAG,IAAW;IAoCvC;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA6B1G;;;;;OAKG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAcxE,yFAAyF;IACzF,MAAM,IAAI,IAAI;CAoDf"}

package/types/core/giftVariant.d.ts

@@ -70,4 +70,9 @@ export declare function rewardSurfaceKind(variantName: string | null | undefined
  * callers pass one argument.
  */
 table?: Readonly<Record<string, RewardSurfaceKind>>): RewardSurfaceKind | null;
+/**
+ * The web control arm. The backend serves it with a placeholder tree and says web
+ * draws its default carousel, so control cells carry a real variant id.
+ */
+export declare function isCarouselControlArm(variantName: string | null | undefined): boolean;
 //# sourceMappingURL=giftVariant.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"giftVariant.d.ts","sourceRoot":"","sources":["../../src/core/giftVariant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,eAAe,CAAC;AAEpB;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAQ3E,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,eAAe,CAAC;AAEpB;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAU3E,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;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEpF"}

package/types/core/hostDisplay.d.ts

@@ -29,22 +29,29 @@ export interface RemoteHostSource {
     appIconUrl?: string;
     /** `entitlements.native.durationDays` — the trial-end line's only input. */
     trialDurationDays?: number;
+    /**
+     * `entitlements.iap.premiumTierName` — the publisher's own name for its paid
+     * tier, which served variants address as `${premiumTierName}`.
+     */
+    premiumTierName?: string;
 }
 /** Resolve the host nouns. Every field independently optional. */
 export declare function resolveHostDisplay(source: RemoteHostSource): HostDisplay;
 /** The deferred flow's sentences, each with exactly one definition. */
 export declare const displayCopy: {
     readonly primerTitle: (app: string, trial?: string) => string;
-    readonly primerSubtitle: (app: string) => string;
+    readonly primerSubtitle: (app: string, knownTrial?: boolean) => string;
     readonly primerCta: (app: string, trial?: string) => string;
     /** The holding story: the host is unnamed, so the sentence is about the reward. */
     readonly holdingTitle: () => string;
-    readonly holdingSubtitle: (advertiser?: string) => string;
+    readonly holdingSubtitle: (advertiser?: string, knownTrial?: boolean) => string;
     readonly holdingCta: () => string;
     readonly s2Title: (app: string, trial?: string) => string;
     readonly s2Subtitle: (app: string) => string;
     /** Host-row detail composed from the remote durationDays and the redemption moment. */
     readonly s2HostDetail: (trialEnd: Date) => string;
     readonly s2Cta: () => string;
+    /** The line above the redemption CTA; undefined when there is nothing true to say. */
+    readonly redemptionNote: (advertiser: string | undefined, knownTrial: boolean) => string | undefined;
 };
 //# sourceMappingURL=hostDisplay.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hostDisplay.d.ts","sourceRoot":"","sources":["../../src/core/hostDisplay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA+BD,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CASxE;AAED,uEAAuE;AACvE,eAAO,MAAM,WAAW;gCACH,MAAM,UAAU,MAAM,KAAG,MAAM;mCAE5B,MAAM,KAAG,MAAM;8BAEpB,MAAM,UAAU,MAAM,KAAG,MAAM;IAEhD,mFAAmF;iCACjE,MAAM;4CACO,MAAM,KAAG,MAAM;+BAI9B,MAAM;4BACP,MAAM,UAAU,MAAM,KAAG,MAAM;+BAI5B,MAAM,KAAG,MAAM;IACjC,uFAAuF;sCAC9D,IAAI,KAAG,MAAM;0BAM3B,MAAM;CACT,CAAC"}
+{"version":3,"file":"hostDisplay.d.ts","sourceRoot":"","sources":["../../src/core/hostDisplay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4CD,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CASxE;AAED,uEAAuE;AACvE,eAAO,MAAM,WAAW;gCACH,MAAM,UAAU,MAAM,KAAG,MAAM;mCAW5B,MAAM,2BAAuB,MAAM;8BAMxC,MAAM,UAAU,MAAM,KAAG,MAAM;IAIhD,mFAAmF;iCACjE,MAAM;4CACO,MAAM,2BAAuB,MAAM;+BAgBlD,MAAM;4BACP,MAAM,UAAU,MAAM,KAAG,MAAM;+BAI5B,MAAM,KAAG,MAAM;IAEjC,uFAAuF;sCAC9D,IAAI,KAAG,MAAM;0BAK3B,MAAM;IACjB,sFAAsF;0CACzD,MAAM,GAAG,SAAS,cAAc,OAAO,KAAG,MAAM,GAAG,SAAS;CAYjF,CAAC"}

package/types/core/sduiVariables.d.ts

@@ -0,0 +1,20 @@
+import type { RemoteHostSource } from './hostDisplay';
+/**
+ * The `${token}` variables a served template reads, built as Swift's
+ * `OfferContext.allVariables` builds them. Web has no purchases, so the IAP
+ * variables Swift adds are absent.
+ */
+export interface SduiVariableSources {
+    /** `values.text`. Loosely typed, so a null can reach here. */
+    text: Readonly<Record<string, unknown>> | null | undefined;
+    /** `values.appearance`. */
+    appearance: Readonly<Record<string, unknown>> | null | undefined;
+    host: RemoteHostSource;
+    /** Churn reads `customHeadline`; reward reads `rewardHeadline`. */
+    churn: boolean;
+    /** The placement's own `headline` and `subheadline`, already blank-checked. */
+    headline: string | undefined;
+    subheadline: string | undefined;
+}
+export declare function sduiTemplateVariables(src: SduiVariableSources): Record<string, string>;
+//# sourceMappingURL=sduiVariables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sduiVariables.d.ts","sourceRoot":"","sources":["../../src/core/sduiVariables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,2BAA2B;IAC3B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACjE,IAAI,EAAE,gBAAgB,CAAC;IACvB,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAgBD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsCtF"}

package/types/core/strings.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The ONE strings provider: every sentence the SDK itself says, looked up by a stable
+ * string id, with the shipped English as the fallback.
+ *
+ * WHY THIS SHAPE. SDK-owned copy is served by the backend in a `strings` block on
+ * `/config`, and the English literals stay in code as the last fallback. No per-language dictionary is bundled, so the
+ * bundle stays flat however many languages Encore turns on.
+ *
+ * `/config` serves the block as `ui.values.strings` and `ui.values.plurals`, holding
+ * only the ids the resolved locale has an APPROVED translation for; every other id
+ * keeps its English here. {@link setServedCopy} adopts both maps together with the
+ * locale they were resolved in. Nothing is served for English, so an English session
+ * renders byte-identically to before.
+ *
+ * TEMPLATES use `${name}` placeholders, the token syntax the backend's copy tokens and
+ * its machine-translation token protection already use, so a served string survives
+ * translation with its holes intact. A placeholder with no value is left visible
+ * rather than printed as `undefined`.
+ *
+ * PLURALS are CLDR forms (`zero`, `one`, `two`, `few`, `many`, `other`; only `other`
+ * is required). The category is chosen with `Intl.PluralRules` in the SERVED locale
+ * when the served block supplied the forms, and in English when the fallback is
+ * used: Arabic rules over English forms would pick "few" and land on the wrong one.
+ *
+ * Module state, not instance state, because `Encore` is itself a module singleton
+ * and the UI modules read copy at render time without a handle to it.
+ */
+export type Vars = Record<string, string | number>;
+/** CLDR plural forms. `other` is the only one every language has. */
+export interface PluralForms {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other: string;
+}
+/**
+ * Adopt a served strings block. TOLERANT by design, because it is remote data: only a
+ * non-blank string or a well-formed plural (with `other`) is kept; anything else
+ * falls through to English for that id alone. Replaces the previous block wholesale,
+ * so a language change never leaves the old language's strings behind.
+ */
+export declare function setServedStrings(...blocks: unknown[]): void;
+/**
+ * Adopt one `/config` answer: the locale it resolved and, when it carries `values`,
+ * that locale's `strings` and `plurals` (one id namespace). The maps live and die with
+ * their locale: an answer with no `values` keeps the maps only while the locale is
+ * unchanged, so strings of one language never sit under another's `lang`.
+ */
+export declare function setServedCopy(tag: unknown, values: {
+    strings?: unknown;
+    plurals?: unknown;
+} | null | undefined): void;
+/** The locale the backend says it served (`/config` `locale`), or undefined. */
+export declare function setServedLocale(tag: unknown): void;
+export declare function servedLocale(): string | undefined;
+/** Forget every served string and the served locale. */
+export declare function resetStrings(): void;
+/** One sentence by id: the served string when there is one, else `fallback`. */
+export declare function str(id: string, fallback: string, vars?: Vars): string;
+/**
+ * A count-dependent sentence. `${count}` is always available to the template.
+ * The served forms are chosen by the served locale's rules, the English fallback by
+ * English rules.
+ */
+export declare function plural(id: string, count: number, fallback: PluralForms, vars?: Vars): string;
+/** A count-dependent string only when the server sent its forms, as Swift's `servedPlural`. */
+export declare function servedPlural(id: string, count: number): string | undefined;
+/**
+ * A sentence whose holes hold ELEMENTS (a link, a styled amount), as DOM nodes in
+ * reading order. The sentence is ONE template (`'By proceeding you agree to our
+ * ${link}'`), so a translation can put the element anywhere in it; splitting it into
+ * a lead and a tail would fix English word order into every language.
+ *
+ * A `${name}` in `nodes` becomes that node (its first occurrence); one in `vars` is
+ * filled as text; any other stays visible, as in {@link str}. A node the template
+ * never places is appended after a space, so a translation that dropped the
+ * placeholder never loses the control. `text` wraps each text run (to style it);
+ * by default runs are plain text nodes. Empty runs are skipped.
+ */
+export declare function fillNodes(template: string, nodes: Record<string, Node>, vars?: Vars, text?: (run: string) => Node): Node[];
+/**
+ * A copy table whose every key reads through {@link str} under `namespace`, so
+ * `GIFT_COPY.headline` is the id `gift.headline` with its English beside it. Keeps
+ * the property-access shape the UI modules and their tests already use.
+ */
+export declare function copyTable<T extends Record<string, string>>(namespace: string, english: T): T;
+/**
+ * Languages written right to left, by language subtag: the same 18 as iOS and Android
+ * (`ServedLayoutDirection` on both), so a served locale mirrors the sheet on every
+ * platform or on none.
+ */
+export declare const RTL_LANGUAGES: ReadonlySet<string>;
+export declare function isRtlLocale(tag: string | undefined): boolean;
+/**
+ * Stamp `lang` and `dir` on an SDK root from the served locale. With no served
+ * locale the attributes are REMOVED, so the host page's own language and direction
+ * apply exactly as before.
+ */
+export declare function applyLocaleAttributes(el: HTMLElement): void;
+/** Whether `el` renders right to left, by the nearest `dir` attribute. */
+export declare function isRtlElement(el: Element | null): boolean;
+/**
+ * A keydown's key in READING order: ArrowLeft and ArrowRight swap inside a
+ * right-to-left subtree, so "ArrowRight means next" holds for every handler without
+ * each one knowing about direction. Every other key passes through.
+ */
+export declare function logicalArrowKey(key: string, el: Element | null): string;
+/** A date in the served locale (the browser's when none was served). */
+export declare function formatDate(date: Date, options: Intl.DateTimeFormatOptions): string;
+/** A number in the served locale (the browser's when none was served). */
+export declare function formatNumber(value: number): string;
+//# sourceMappingURL=strings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/core/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAEnD,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAyBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAQ3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAClE,IAAI,CAKN;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,gFAAgF;AAChF,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAGrE;AAUD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAQ5F;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAC3B,IAAI,CAAC,EAAE,IAAI,EACX,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAA4C,GAClE,IAAI,EAAE,CAgCR;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAS5F;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAG5C,CAAC;AAEH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAQ3D;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAKvE;AAaD,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAElF;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/types/core/unlockCode.d.ts

@@ -17,9 +17,19 @@ export declare function normalizeUnlockCode(raw: unknown): string;
 /**
  * The "Up to {amount} in rewards" amount, or null for no line. Page-supplied: a campaign's
  * oldPrice/newPrice are free-text display prices with no currency or period, so nothing on
- * an offer states a reward value. Only a short money amount is accepted, never free text.
+ * an offer states a reward value. Only a short money amount is accepted, never free text:
+ * a currency symbol or code before or after a number of up to five digits and optional
+ * cents.
+ *
+ * Returned verbatim unless the server named a locale; then it is written the way that
+ * locale writes money. A symbol the page wrote stays narrow, so "$" stays "$" rather
+ * than "US$"; a currency CODE keeps its currency visible ("CA$", "AU$"), because the
+ * narrow symbol would print CAD and AUD as a bare "$".
  */
 export declare function unlockValueAmount(raw: unknown): string | null;
-/** Does `code` unlock the offers? Placeholder: yes, for any non-empty code. */
+/**
+ * Does `code` unlock the offers? Placeholder: yes, for any non-empty code. A real check must
+ * always settle: with `dismissible: false` the code screen has no other way out.
+ */
 export declare function checkUnlockCode(code: string): Promise<UnlockCodeVerdict>;
 //# sourceMappingURL=unlockCode.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"unlockCode.d.ts","sourceRoot":"","sources":["../../src/core/unlockCode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE;AACd,8EAA8E;GAC5E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAAA;CAAE,CAAC;AAEhD,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ7D;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAExE"}
+{"version":3,"file":"unlockCode.d.ts","sourceRoot":"","sources":["../../src/core/unlockCode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE;AACd,8EAA8E;GAC5E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAAA;CAAE,CAAC;AAEhD,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAqB7D;AAOD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAExE"}

package/types/core/userKeys.d.ts

@@ -0,0 +1,7 @@
+/** One user's pending grant signals (SignalManager). */
+export declare function signalQueueKey(userId: string): string;
+/** One user's strict-mode claim awaiting verification (StrictUnlockReconciler). */
+export declare function strictPendingKey(userId: string): string;
+/** Whether `key` holds some user's still-owed record: queued grant signals or a strict claim. */
+export declare function isUserPendingKey(key: string): boolean;
+//# sourceMappingURL=userKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userKeys.d.ts","sourceRoot":"","sources":["../../src/core/userKeys.ts"],"names":[],"mappings":"AAKA,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

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.2.1";
+export declare const SDK_VERSION = "2.4.0";
 //# sourceMappingURL=version.d.ts.map

package/types/experiments/ExposureOutbox.d.ts

@@ -7,6 +7,7 @@
  */
 import { ReliableOutbox } from '../analytics/ReliableOutbox';
 import type { StorageManager } from '../core/StorageManager';
+export declare const EXPOSURE_OUTBOX_KEY = "ncl_exposure_outbox";
 export declare class ExposureOutbox extends ReliableOutbox {
     constructor(apiKey: string, analyticsBaseURL: string, storage: StorageManager);
 }

package/types/experiments/ExposureOutbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExposureOutbox.d.ts","sourceRoot":"","sources":["../../src/experiments/ExposureOutbox.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,qBAAa,cAAe,SAAQ,cAAc;gBACpC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;CAG9E"}
+{"version":3,"file":"ExposureOutbox.d.ts","sourceRoot":"","sources":["../../src/experiments/ExposureOutbox.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,qBAAa,cAAe,SAAQ,cAAc;gBACpC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;CAG9E"}

package/types/preview.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `@encorekit/web-sdk/preview` — 🔴 INTERNAL, for the Encore admin portal only. Not a
+ * public API: no semver promise, and it may change with any release.
+ *
+ * Renders the SDK's REAL churn or reward sheet inline, from what the portal already
+ * has: the `/config` `ui` object (strings and plurals included) and the `/offers/search`
+ * `offers`. It is the live presentation code with its I/O replaced, so the preview is
+ * what users see. Guarantees:
+ *
+ *   - no fetch, XHR or beacon: /config and /offers/search answer from the input;
+ *   - no analytics and no storage write, from import to destroy();
+ *   - claim, decline, share and close do nothing, and nothing navigates;
+ *   - inline in `container` (an element or a shadow root), stylesheet included; nothing
+ *     is added to `document.head` or `document.body`, and no global is created;
+ *   - after destroy(), no window or document listener, timer or node is left behind;
+ *   - no React.
+ *
+ * LIMITS. Served strings are module state, so render one locale per page at a time (an
+ * iframe per locale for side by side). The mobile/desktop layout follows the viewport,
+ * so preview a phone in an iframe that width. Offer images load from their URLs. While
+ * mounted, the churn carousel listens for arrow keys on the document, as it does live.
+ *
+ * TRIGGERS. `renderTriggerPreview` draws one trigger look (a GiftsButton or ClaimReminder
+ * variant file) with sample offers and claims, in a device state, through the live
+ * plug-ins, under the same guarantees. See `triggers/preview.ts`.
+ */
+import type { ConfigResponse, OffersSearchResponse } from './api/contract';
+export { renderTriggerPreview, type TriggerPreviewClaim, type TriggerPreviewHandle, type TriggerPreviewInput, type TriggerPreviewOffer, type TriggerPreviewResult, type TriggerPreviewState, } from './triggers/preview';
+/** What one preview renders. */
+export interface PreviewInput {
+    /** BCP 47 locale the payload was resolved in: drives `lang`/`dir`, Intl and plurals. */
+    locale: string;
+    /**
+     * The `/publisher/sdk/v1/config` response's `ui`: `useCase` (wire value, e.g.
+     * `'churn-intervention'`, `'post-action-reward'`), `variantName` (picks the reward
+     * surface), `template`, and `values` with `text`, `strings` and `plurals`.
+     */
+    ui: NonNullable<ConfigResponse['ui']>;
+    /** The `/offers/search` response's `offers` (campaigns with creatives). */
+    offers: OffersSearchResponse['offers'];
+}
+/** A mounted preview. */
+export interface PreviewHandle {
+    /** Re-render with new input in the same container. */
+    update(input: PreviewInput): void;
+    /** Remove everything the preview added. Safe to call more than once. */
+    destroy(): void;
+}
+/** Mount a preview of the sheet `input` describes in `container`. */
+export declare function renderPreview(container: HTMLElement | ShadowRoot, input: PreviewInput): PreviewHandle;
+//# sourceMappingURL=preview.d.ts.map

package/types/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,EAAE,EAAE,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,2EAA2E;IAC3E,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED,yBAAyB;AACzB,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,wEAAwE;IACxE,OAAO,IAAI,IAAI,CAAC;CACjB;AAKD,qEAAqE;AACrE,wBAAgB,aAAa,CAC3B,SAAS,EAAE,WAAW,GAAG,UAAU,EACnC,KAAK,EAAE,YAAY,GAClB,aAAa,CAqEf"}

package/types/react.d.ts

@@ -1,10 +1,62 @@
 import { type ReactNode } from 'react';
-import type { EncoreConfig } from '@encorekit/web-sdk';
+import type { ClaimTarget, EncoreClaimOptions, EncoreClaimState, ClaimReminderOptions, TriggerMountOptions, EncoreConfig, GiftsButtonOptions, ShowResult } from '@encorekit/web-sdk';
 type EncoreProviderProps = {
     children: ReactNode;
 } & EncoreConfig;
 export declare function EncoreProvider({ children, ...config }: EncoreProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useEncore(): import("./core/Encore").EncoreSDK;
+export type EncoreTriggerProps = TriggerMountOptions & {
+    /** The trigger id, such as `'claimReminder'`. */
+    id: string;
+};
+/**
+ * An Encore trigger. Render it inside your `EncoreProvider`, where it should sit.
+ * It takes no space until it has something to show, and renders nothing for an id
+ * this SDK version does not ship.
+ *
+ * Remounts when `id`, `placement`, `useCase`, `autoOpen`, `icon`, an `appearance` field a trigger reads, the prize, an `options` entry or a `values` entry
+ * changes; a new `appearance`, `options` or
+ * `publisherReward` object with the same values does not. A new `alignment` only moves it, and new
+ * `headline`, `subheadline` or `cta` only redraws it, with no request.
+ */
+export declare function EncoreTrigger({ id, ...rest }: EncoreTriggerProps): import("react/jsx-runtime").JSX.Element;
+export type ClaimReminderProps = ClaimReminderOptions;
+/**
+ * The claim reminder card: `<EncoreTrigger id="claimReminder" ... />`. It takes no
+ * space until there is a claim to remind about, and a tap opens the Encore sheet for
+ * `useCase` (default `'rewardUsers'`) at `placement`.
+ */
+export declare function ClaimReminder(props: ClaimReminderProps): import("react/jsx-runtime").JSX.Element;
+export type GiftsButtonProps = GiftsButtonOptions;
+/**
+ * The gifts button: `<EncoreTrigger id="giftsButton" ... />`. A tap opens the Encore
+ * sheet for `useCase` (default `'rewardUsers'`) at `placement`. It takes no space while
+ * that sheet has no offers.
+ */
+export declare function GiftsButton(props: GiftsButtonProps): import("react/jsx-runtime").JSX.Element;
 export { Encore } from '@encorekit/web-sdk';
 export type * from '@encorekit/web-sdk';
+/** What `useEncoreClaim` gives you. */
+export interface UseEncoreClaim {
+    /** What to draw now. */
+    state: EncoreClaimState;
+    /** Put on your view's element: Encore counts its impression and opens the sheet on a click. */
+    ref: (element: HTMLElement | null) => void;
+    /** Open the sheet yourself (a view with its own buttons). */
+    tap: (target?: ClaimTarget) => Promise<ShowResult>;
+    /** Hide the reminder. */
+    dismiss: () => void;
+    /** Report how much of your view is visible (0 to 1), when you do not use `ref`. */
+    setVisible: (fraction: number) => void;
+}
+/**
+ * Your own gifts button or claim reminder, as `Encore.claim()` in React. Draw from
+ * `state`, and put `ref` on the element that should count as seen and open the sheet.
+ * Starts over when `placement`, `useCase`, `autoOpen` or the prize changes; the newest
+ * `onResult` is called without starting over.
+ */
+export declare function useEncoreClaim(options: EncoreClaimOptions & {
+    target?: ClaimTarget;
+    tap?: boolean;
+}): UseEncoreClaim;
 //# sourceMappingURL=react.d.ts.map

package/types/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAAC;AAIjB,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,mBAAmB,2CAa1E;AAED,wBAAgB,SAAS,sCAExB;AAGD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,mBAAmB,oBAAoB,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgF,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAErH,OAAO,KAAK,EAEV,WAAW,EAEX,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EAGpB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACX,MAAM,oBAAoB,CAAC;AAE5B,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAAC;AAIjB,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,mBAAmB,2CAa1E;AAED,wBAAgB,SAAS,sCAExB;AAED,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AA4KF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,kBAAkB,2CAShE;AAED,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAGtD;AAED,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAElD;AAGD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,mBAAmB,oBAAoB,CAAC;AAIxC,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,+FAA+F;IAC/F,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,6DAA6D;IAC7D,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,yBAAyB;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mFAAmF;IACnF,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,kBAAkB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACpE,cAAc,CAmGhB"}