@encorekit/web-sdk 2.3.0 → 2.4.0

package/types/api/models.d.ts

@@ -21,8 +21,11 @@ export interface OfferModel {
     id: string;
     title: string;
     description: string;
+    /** The creative's own `description`, which SDUI's `offerDescription` reads, as Swift does. */
+    creativeDescription?: string;
     imageUrl?: string;
-    ctaText: string;
+    /** Absent when the server sends none: the card shows its own `card.claim` string. */
+    ctaText?: string;
     advertiserUrl: string;
     campaignId: string;
     /** Absent for a campaign served without a creative (no picture). */
@@ -80,17 +83,30 @@ export interface OfferModel {
      *
      * Read tolerantly from `campaign.category` on the `/offers/search` response (nullable
      * in the contract). Absent, the sheet renders one list with no tabs. See
-     * `readCategory` in `offerBuilder.ts`.
+     * `readCampaignText` in `offerBuilder.ts`.
+     *
+     * Stays English on every locale: it is a key, never display text.
      */
     category?: string;
+    /**
+     * The gift sheet group the server filed this offer under ("Watch & listen", "Money",
+     * "Everyday"), English, trimmed. Preferred over mapping `category` locally.
+     */
+    categoryGroup?: string;
+    /** `categoryGroup` in the response locale, for the tab label only. */
+    categoryGroupDisplayName?: string;
     instructions?: {
         title: string;
         subtitle: string;
         ctaButtonText?: string;
+        /** The step's image, when it has one. */
+        imageUrl?: string;
     }[];
     quickInstructions?: string;
     tooltipText?: string;
     trackingParameters?: Record<string, string>;
+    /** Admin copy a variant draws by key (`propertyKey`). Blank values are absent. */
+    displayProperties?: Record<string, string>;
 }
 export interface TransactionModel {
     id: string;

package/types/api/models.d.ts.map

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

package/types/api/offerBuilder.d.ts

@@ -12,11 +12,15 @@
  */
 import type { OfferModel } from './models';
 /**
- * The campaign's shelf category (`campaign.category`, a nullable free string in the
- * contract), read tolerantly: only a non-blank string is kept (trimmed). Anything else,
- * and the field's absence on an older backend, is `undefined`.
+ * A campaign's category field, read tolerantly: only a non-blank string is kept (trimmed).
+ * Anything else, and the field's absence on an older backend, is `undefined`, so a
+ * response with none of them maps to one list with no tabs.
+ *
+ * `category` is the shelf taxonomy name (nullable free string in the contract);
+ * `categoryGroup` is the gift sheet group the server filed it under (English, a key);
+ * `categoryGroupDisplayName` is that group in the response locale, for the tab label.
  */
-export declare function readCategory(campaign: unknown): string | undefined;
+export declare function readCampaignText(campaign: unknown, key: 'category' | 'categoryGroup' | 'categoryGroupDisplayName'): string | undefined;
 /**
  * A campaign-level URL (`heroImageUrl`, `termsUrl`), read tolerantly: a non-blank string,
  * trimmed, that passes the SDK's https guard. Anything else, a `javascript:` or plain
@@ -40,6 +44,8 @@ export declare function readShareUrl(campaign: unknown): string | undefined;
  * dropped. Only a bare hostname is kept, so a bad row can never put a URL on screen.
  */
 export declare function readExpectedDomain(campaign: unknown): string | undefined;
+/** String values only, and a blank one is absent, as on iOS. Empty → undefined. */
+export declare function readDisplayProperties(value: unknown): Record<string, string> | undefined;
 /** Never throws: a malformed campaign is skipped, not allowed to fail the list. */
 export declare function buildOffers(campaigns: readonly unknown[] | null | undefined): OfferModel[];
 //# sourceMappingURL=offerBuilder.d.ts.map

package/types/api/offerBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offerBuilder.d.ts","sourceRoot":"","sources":["../../src/api/offerBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMlE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,cAAc,GAAG,UAAU,GAC/B,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAYlE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAYxE;AA2ID,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,EAAE,CAQ1F"}
+{"version":3,"file":"offerBuilder.d.ts","sourceRoot":"","sources":["../../src/api/offerBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,UAAU,GAAG,eAAe,GAAG,0BAA0B,GAC7D,MAAM,GAAG,SAAS,CAMpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,cAAc,GAAG,UAAU,GAC/B,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAYlE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAYxE;AAuCD,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQxF;AA2ID,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,EAAE,CAQ1F"}

package/types/core/Encore.d.ts

@@ -2,16 +2,96 @@
  * Main Encore SDK Class
  * Singleton class that serves as the public API entry point
  */
-import type { EncoreConfig, UserAttributes, EntitlementType, EntitlementScope, EventHandler, Unsubscribe, PresentationOptions, PresentationResult, PlacementOptions, VerificationStatus, PlacementBuilder as IPlacementBuilder, RedeemOptions, RedeemResult, ShowResult, Transaction } from '../types';
+import type { EncoreConfig, UserAttributes, EntitlementType, EntitlementScope, EventHandler, Unsubscribe, PresentationOptions, PresentationResult, PlacementOptions, VerificationStatus, PlacementBuilder as IPlacementBuilder, RedeemOptions, RedeemResult, ShowResult, Transaction, UseCase, EncoreClaim, EncoreClaimOptions, EncoreTriggers } from '../types';
+import { APIClient } from '../api/APIClient';
+import { type PlacementResolutionOverride } from '../analytics/placementResolved';
 import type { NCLExperimentState } from '../experiments/types';
+import type { ClaimReminderSource } from '../triggers/claimReminder/source';
 import { type LogLevel } from '../utils/logger';
+/**
+ * What an internal exit hands back to `show()`'s wrapper, so exactly one
+ * `sdk_placement_resolved` record is written per attempt no matter which path
+ * produced the result. Mirrors iOS's `OfferSheetCoordinator.present()` wrapping a
+ * `presentCore()`.
+ *
+ * `override` is set ONLY by sites whose public `ShowResult` collapses something the
+ * record still needs — the deliberately overloaded `'unavailable'`, and the
+ * `UNKNOWN_ERROR` code shared by three structurally different failures. See
+ * `PlacementResolutionOverride`.
+ */
+export interface OfferFlowOutcome {
+    result: ShowResult;
+    /**
+     * THE id for this attempt — the same one every analytics event from this attempt
+     * carries, so the terminal record joins to all of them. Required: it is minted
+     * above every gate in #showCore, so there is no exit that lacks one.
+     */
+    presentationId: string;
+    variantId?: string;
+    override?: PlacementResolutionOverride;
+    /**
+     * INTERNAL: a trigger's automatic pop dropped before its sheet showed (its mount went
+     * away). Nothing happened, so no placement record is written, as on iOS.
+     */
+    aborted?: true;
+}
+/**
+ * The whole years since a date of birth, on today's UTC date as the native SDKs count
+ * it: floored, so the age turns only on the birthday itself. Null for an unreadable or
+ * future date, or one that gives an age outside 0 to 120.
+ */
+export declare function ageFromDateOfBirth(value: unknown, now?: Date): number | null;
+/**
+ * Attributes as they may be kept (`age` for this page load only, see savedAttributes): `age` only as a number from 0 to 120,
+ * floored to whole years (15.5 is 15), so a fractional age still restricts a minor; a
+ * `dateOfBirth` only when it names a real date. The date stays on the device, and
+ * `outgoingAttributes` turns it into an age each time attributes are sent.
+ */
+export declare function cleanUserAttributes<T extends UserAttributes>(attributes: T): T;
+/**
+ * Kept attributes as they are sent: never the date of birth, and `age` as of now. The
+ * age comes from `age`, from `dateOfBirth`, or, given both, the lower of the two, so a
+ * minor is never sent as an adult. A date that gives no age adds none.
+ */
+export declare function outgoingAttributes<T extends UserAttributes>(attributes: T, now?: Date): T;
 export declare class EncoreSDK {
     #private;
+    /**
+     * Drop-in UI pieces a host places in its own layout.
+     *
+     * `mount(id, element, { placement, useCase, autoOpen, ... })` draws trigger
+     * `id` in `element`. It renders nothing (zero height) until there is something to
+     * show, including before `configure()`, for an id this version does not ship, and for
+     * churn, and never throws. An untyped `layout` pins a look for demos and tests only
+     * (as Swift's `@_spi(EncoreDemo)`): apps never pin, Encore picks looks per placement. Returns a handle whose
+     * `unmount()` removes it. `claimReminder.mount(element, options)` is
+     * `mount('claimReminder', element, options)`, and likewise `giftsButton`.
+     */
+    readonly triggers: EncoreTriggers;
+    /**
+     * Your own gifts button or claim reminder, counted and driven by Encore: a handle for
+     * `placement` whose `state` says what to draw (`hidden`, `gifts`, `reminder`). Bind your
+     * view with `handle.bind(element)` (or report visibility with `setVisible` and call
+     * `tap()`); Encore counts the impression and the tap, opens the reward sheet, and
+     * calls `onResult`. Encore decides what it shows after a claim and after a completion
+     * (rules read once the view is on screen; the defaults until then). Never throws; `hidden` until the
+     * SDK is configured.
+     */
+    claim(options: EncoreClaimOptions): EncoreClaim;
+    /**
+     * 🔴 INTERNAL: binds the claims adapter the claim reminder reads (null unbinds).
+     * Static, so it stays off the public instance. Its callers are the SDK's own
+     * mapper over the claims bank, once that is on main, and tests.
+     */
+    static bindClaimReminderSource(sdk: EncoreSDK, source: ClaimReminderSource | null): void;
     constructor();
     /**
      * Configure the SDK with API key and options
      */
     configure(config: EncoreConfig): boolean;
+    /**
+     * Identify user with custom user ID and optionally set attributes
+     */
     identify(userId: string, attributes?: UserAttributes): void;
     /**
      * Get current user ID
@@ -87,9 +167,45 @@ export declare class EncoreSDK {
      */
     revokeEntitlements(): Promise<boolean>;
     /**
-     * Set user attributes (merges with existing attributes)
+     * Set user attributes (merges with existing attributes).
+     *
+     * A `language` here is not kept as an attribute: it is forwarded to
+     * `setLanguage()` (see `UserAttributes.language`, deprecated).
      */
     setUserAttributes(attributes: UserAttributes): void;
+    /**
+     * Show Encore's copy and offers in `tag`, a BCP 47 language tag such as `'fr'` or
+     * `'pt-BR'`, until `clearLanguage()`. Any case is accepted and stored in BCP 47
+     * case (`'PT-br'` → `'pt-BR'`), with a deprecated code replaced (`'iw'` →
+     * `'he'`); separators are hyphens only.
+     *
+     * The tag rides the next `/config` and `/offers/search` requests, so the sheet's
+     * copy and its offers are always in one language, and analytics events carry the
+     * locale the server then serves. Only languages enabled for your app are served;
+     * anything else falls back to the browser's `Accept-Language`, then the app's
+     * default language. Call it after `configure()`.
+     *
+     * The choice is kept on this device (localStorage, when the browser allows it)
+     * until `clearLanguage()`: a later `configure()`, a reload and `reset()` keep it.
+     * A change drops the served strings and the cached copy and offers and asks
+     * `/config` again at once; once it answers, the offers are fetched again in the new
+     * language and `user_identified` is sent again, as on iOS and Android. Setting the
+     * current language again does nothing. A value that is not a well-formed tag
+     * (`'pt_BR'`, `'english'`, `' fr'`) is ignored with one console warning, never
+     * thrown, and the current language stays. A new identity (`identify()` with
+     * another user, `reset()`) keeps it.
+     * iOS, Android, React Native and Flutter have the same call.
+     */
+    setLanguage(tag: string): void;
+    /**
+     * Stop choosing a language: forget the `setLanguage()` choice on this device, so
+     * copy and offers follow the browser's `Accept-Language` again. Every attribute is
+     * kept. Like any language change it drops the served strings and the config and
+     * offer caches, and it asks `/config` again at once for the current user (with no
+     * `?language=`), then fetches the offers again and identifies again. A no-op when
+     * no language was set. iOS, Android, React Native and Flutter have the same call.
+     */
+    clearLanguage(): void;
     /**
      * Get current user attributes
      */
@@ -99,7 +215,9 @@ export declare class EncoreSDK {
      *
      * Resolves 'claimed' when the user claims an offer (a transaction is recorded and
      * the advertiser opens in a new tab), 'dismissed' if the user closes the carousel,
-     * or 'unavailable' if there are no eligible offers.
+     * or 'unavailable' if there are no eligible offers. A served variant with a
+     * post-claim screen keeps the sheet up, as iOS does, and resolves 'claimed' when
+     * that sheet closes.
      *
      * @param placementId The publisher's placement label. Attributed on the offers
      *        request AND stamped as `placement_id` on every analytics row this
@@ -193,6 +311,30 @@ export declare class EncoreSDK {
      *   placement("cancel_flow", { appearance: { ... } })
      */
     placement(idOrOptions?: string | PlacementOptions, options?: PlacementOptions): IPlacementBuilder;
+    /**
+     * 🔴 INTERNAL — the render-only preview behind `@encorekit/web-sdk/preview`, its only
+     * caller (which owns the session, `ready` and `destroy()`).
+     *
+     * Runs the REAL presentation (`#runOfferFlow`) on a fresh instance, never the
+     * singleton, whose only "network" is `transport`. No analytics client exists, so
+     * nothing is tracked, and nothing is stored (claims, the only path that stores, do
+     * nothing in a preview).
+     */
+    static runPreview(session: PreviewSession, transport: PreviewTransport, useCase: UseCase): {
+        flow: Promise<OfferFlowOutcome>;
+        stop: () => void;
+    };
+}
+/** The preview's stand-in for the API client: the only calls a presentation makes. */
+export type PreviewTransport = Pick<APIClient, 'fetchConfig' | 'fetchOffers' | 'reportError'>;
+/** A preview's hooks into the presentation. */
+export interface PreviewSession {
+    /** Where the sheet mounts, inline. */
+    mount: HTMLElement | ShadowRoot;
+    /** Called once the sheet's content is in the DOM. */
+    mounted: () => void;
+    /** Set by the presentation: settles it and removes the sheet. */
+    end: (() => void) | null;
 }
 export declare const Encore: EncoreSDK;
 //# sourceMappingURL=Encore.d.ts.map

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

@@ -6,8 +6,11 @@ import type { APIClient, OffersSearchScope } from '../api/APIClient';
 import type { OfferModel } from '../api/models';
 import type { UserAttributes, UseCase } from '../types';
 import type { AnalyticsClient } from '../analytics/AnalyticsClient';
+import { type PresentationTrigger } from '../analytics/events';
 export declare class OfferManager {
     #private;
+    /** Test hook: scopes with searches still out. */
+    pendingScopeCount(): number;
     constructor(apiClient: APIClient, userId: string, analyticsClient?: AnalyticsClient);
     /**
      * Fetch offers from API with optional caching.
@@ -22,6 +25,23 @@ export declare class OfferManager {
     fetchOffers(userAttributes: UserAttributes, useCache?: boolean, placementId?: string, maxPostbackTimeMs?: number, scope?: OffersSearchScope): Promise<{
         offers: OfferModel[];
     }>;
+    /**
+     * Warm the cache for `scope` without presenting anything: the set a sheet already on
+     * screen reports its analytics against is left alone. Never throws. A set already
+     * cached is not fetched again.
+     */
+    prefetchOffers(userAttributes: UserAttributes, scope?: OffersSearchScope): Promise<void>;
+    /**
+     * A trigger's gate: the offers the sheet would show for `scope`.
+     * The result is cached under the same key the sheet's own search reads (the scope's
+     * `wireVariantId` and `purpose` are not part of it), so a tap that opens the sheet
+     * presents these offers without searching again. A set already cached is not
+     * fetched again unless `fresh` (after a claim, the held set may still list the
+     * claimed offer); a fresh answer replaces it. In strict unlock mode the cache is
+     * bypassed and every check searches. Rejects when the search fails; nothing on
+     * screen changes.
+     */
+    searchForTrigger(userAttributes: UserAttributes, placementId: string | undefined, scope: OffersSearchScope, maxPostbackTimeMs?: number, fresh?: boolean): Promise<OfferModel[]>;
     /**
      * Begin a new presentation session. `variantId` is the SDUI variant this
      * presentation renders — stamped onto every event the session emits — and
@@ -39,7 +59,7 @@ export declare class OfferManager {
      * presentation's own id the same value. Absent a caller-supplied one this still mints,
      * which is the behaviour every non-`show()` entry point relies on.
      */
-    beginPresentation(variantId?: string, useCase?: UseCase, placementId?: string, presentationId?: string): string;
+    beginPresentation(variantId?: string, useCase?: UseCase, placementId?: string, presentationId?: string, experimentId?: string): string;
     /**
      * The live presentation's placement label, or undefined when the publisher gave
      * none. Exposed for the strict-unlock pending record, which has to persist the
@@ -50,9 +70,11 @@ export declare class OfferManager {
     /** The live presentation's id, or null between presentations. */
     get presentationId(): string | null;
     /**
-     * Track that an offer was presented (replaces impression logging)
+     * Track that an offer was presented. Sent at most once per impression id; a repeat
+     * (a later view after a claim sent it, a second claim) is a no-op.
+     * `presentationTrigger` is `'claim'` when a claim sends it before any view did.
      */
-    trackOfferPresented(offer: OfferModel, impressionId: string, offerIndex: number, totalOffers: number, useCase?: UseCase): void;
+    trackOfferPresented(offer: OfferModel, impressionId: string, offerIndex: number, totalOffers: number, useCase?: UseCase, presentationTrigger?: PresentationTrigger, imageCacheHit?: boolean): void;
     /**
      * Track that a user navigated away from an offer (pause time tracking)
      */

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

@@ -1 +1 @@
-{"version":3,"file":"OfferManager.d.ts","sourceRoot":"","sources":["../../src/core/OfferManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAiBpE,qBAAa,YAAY;;gBAsDX,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,eAAe;IAOnF;;;;;;;;;OASG;IACG,WAAW,CACf,cAAc,EAAE,cAAc,EAC9B,QAAQ,UAAO,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,KAAK,CAAC,EAAE,iBAAiB,GACxB,OAAO,CAAC;QAAE,MAAM,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IA0DpC;;;;;;;;;OASG;IACH;;;;;;OAMG;IACH,iBAAiB,CACf,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,OAAO,EACjB,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM;IAaT;;;;;OAKG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,iEAAiE;IACjE,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAiBD;;OAEG;IACH,mBAAmB,CACjB,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI;IA8CP;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,iBAAiB,CACf,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI;IAoBP;;OAEG;IACH,kBAAkB,CAChB,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI;IAqBP;;OAEG;IACH,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IA+FhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAwCjE,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAKf;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB9E;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAKhC"}
+{"version":3,"file":"OfferManager.d.ts","sourceRoot":"","sources":["../../src/core/OfferManager.ts"],"names":[],"mappings":"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"}

package/types/core/PlacementBuilder.d.ts

@@ -2,7 +2,7 @@
  * Placement Builder
  * Fluent API for configuring and presenting offers
  */
-import type { PlacementBuilder as IPlacementBuilder, PlacementOptions, RedeemResult, ShowResult, NotGrantedReason, UseCase } from '../types';
+import type { PlacementBuilder as IPlacementBuilder, PlacementOptions, PublisherReward, RedeemResult, ShowResult, NotGrantedReason, UseCase } from '../types';
 export type PresentationExecutor = (options?: PlacementOptions) => Promise<ShowResult>;
 export type RedemptionExecutor = (placementId: string) => Promise<RedeemResult>;
 export declare class PlacementBuilder implements IPlacementBuilder {
@@ -25,6 +25,11 @@ export declare class PlacementBuilder implements IPlacementBuilder {
     headline(text: string): PlacementBuilder;
     /** Counterpart to {@link headline}: same precedence, same blank-falls-through rule. */
     subheadline(text: string): PlacementBuilder;
+    /**
+     * Your own prize for trying an offer here; the same as `PlacementOptions.publisherReward`.
+     * Passed to the sheet, which does not yet draw or grant it on web.
+     */
+    publisherReward(reward: PublisherReward): PlacementBuilder;
     /**
      * Set callback for when user declines or offer not granted
      */

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

@@ -1 +1 @@
-{"version":3,"file":"PlacementBuilder.d.ts","sourceRoot":"","sources":["../../src/core/PlacementBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,gBAAgB,IAAI,iBAAiB,EACrC,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,OAAO,EACR,MAAM,UAAU,CAAC;AAIlB,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AACvF,MAAM,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEhF,qBAAa,gBAAiB,YAAW,iBAAiB;;gBAatD,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,QAAQ,EAAE,kBAAkB;IAQ9B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB;IAK3C;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAKxC,uFAAuF;IACvF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAK3C;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,gBAAgB;IAK5E;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAAG,gBAAgB;IAK9E;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IA8CjC;;;;;;;;;OASG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;CAItC"}
+{"version":3,"file":"PlacementBuilder.d.ts","sourceRoot":"","sources":["../../src/core/PlacementBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,gBAAgB,IAAI,iBAAiB,EACrC,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,OAAO,EACR,MAAM,UAAU,CAAC;AAIlB,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AACvF,MAAM,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEhF,qBAAa,gBAAiB,YAAW,iBAAiB;;gBAatD,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,QAAQ,EAAE,kBAAkB;IAQ9B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB;IAK3C;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAKxC,uFAAuF;IACvF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAK3C;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB;IAK1D;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,gBAAgB;IAK5E;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAAG,gBAAgB;IAK9E;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IA8CjC;;;;;;;;;OASG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;CAItC"}

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

@@ -1 +1 @@
-{"version":3,"file":"SignalManager.d.ts","sourceRoot":"","sources":["../../src/core/SignalManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AASlD,UAAU,WAAW;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,aAAa;;gBAQZ,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;IAezE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAuC/B;;OAEG;IACH,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;IAuBxE;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAelC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/F;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAyGnC;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB"}
+{"version":3,"file":"SignalManager.d.ts","sourceRoot":"","sources":["../../src/core/SignalManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AASlD,UAAU,WAAW;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAaD,qBAAa,aAAa;;gBAUZ,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;IAezE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA+C/B;;OAEG;IACH,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;IA+BxE;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAmBlC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/F;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA0GnC;;OAEG;IACH,OAAO,IAAI,IAAI;CAchB"}

package/types/core/StorageManager.d.ts

@@ -22,9 +22,10 @@ export declare class StorageManager {
      */
     remove(key: string): void;
     /**
-     * Clear all Encore-prefixed items from storage
+     * Clear all Encore-prefixed items from storage, except those `keep` (given the
+     * unprefixed key) returns true for.
      */
-    clear(): void;
+    clear(keep?: (key: string) => boolean): void;
     /**
      * Get the current storage type being used
      */

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

@@ -1 +1 @@
-{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../src/core/StorageManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,KAAK,WAAW,GAAG,cAAc,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAIhE,qBAAa,cAAc;;;IAgEzB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAoCnC;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IA+B7B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAkBzB;;OAEG;IACH,KAAK,IAAI,IAAI;IA6Bb;;OAEG;IACH,cAAc,IAAI,WAAW;CAG9B"}
+{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../src/core/StorageManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,KAAK,WAAW,GAAG,cAAc,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAIhE,qBAAa,cAAc;;;IA2EzB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAoCnC;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IA+B7B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAkBzB;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI;IA+B5C;;OAEG;IACH,cAAc,IAAI,WAAW;CAG9B"}

package/types/core/StrictUnlockReconciler.d.ts

@@ -59,7 +59,7 @@ export declare class StrictUnlockReconciler {
      * their unlock silently never lands. reset() is the destructive path, and it
      * clears storage before this runs, so nothing carries over there.
      */
-    setUserId(userId: string): void;
+    setUserId(userId: string, carryPending?: boolean): void;
     /**
      * Record a claim as awaiting verification. Called as soon as the transaction id
      * exists and BEFORE the advertiser redirect opens, so a tab closed one moment

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

@@ -1 +1 @@
-{"version":3,"file":"StrictUnlockReconciler.d.ts","sourceRoot":"","sources":["../../src/core/StrictUnlockReconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAa5D,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,sBAAsB;;gBAKrB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;IAMzE;;;;;;;;;;OAUG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/B;;;;OAIG;IACH,WAAW,CACT,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACjF,IAAI;IAgBP,2EAA2E;IAC3E,YAAY,IAAI,IAAI;IAKpB;;;;;;;;;OASG;IACH,UAAU,IAAI,YAAY,GAAG,IAAI;IAsCjC;;;;;OAKG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAiBtG"}
+{"version":3,"file":"StrictUnlockReconciler.d.ts","sourceRoot":"","sources":["../../src/core/StrictUnlockReconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAY5D,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,sBAAsB;;gBAKrB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;IAMzE;;;;;;;;;;OAUG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,IAAI;IASpD;;;;OAIG;IACH,WAAW,CACT,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACjF,IAAI;IAgBP,2EAA2E;IAC3E,YAAY,IAAI,IAAI;IAKpB;;;;;;;;;OASG;IACH,UAAU,IAAI,YAAY,GAAG,IAAI;IAsCjC;;;;;OAKG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAiBtG"}

package/types/core/claimHandle.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The `EncoreClaim` handle a host app holds for its own gifts button or claim reminder
+ * (`Encore.claim`). INTERNAL module, public object.
+ *
+ * This part is in the core bundle and stays small: the state and its listeners, and
+ * `bind()`'s DOM wiring (visibility, click, Enter/Space). Everything that decides
+ * (the sheet gate, the claim log, impressions, events, the tap and its sheet) is the
+ * controller in `triggers/host/customClaim.ts`, loaded on first use. Until it is
+ * attached the state is `hidden`, a tap resolves `unavailable`, and visibility is kept
+ * for it.
+ */
+import type { ClaimTarget, EncoreClaim, EncoreClaimState, ShowResult } from '../types';
+/** What the handle needs from its controller once loaded. */
+export interface ClaimController {
+    /**
+     * `covered`: whether something the app presents sits over every bound element that is
+     * on screen (asked when an impression's dwell starts and ends); never covered with no
+     * bound element.
+     */
+    setVisible(fraction: number, covered?: () => boolean): void;
+    tap(target: ClaimTarget | undefined): Promise<ShowResult>;
+    dismiss(): void;
+    destroy(): void;
+}
+export declare class ClaimHandle implements EncoreClaim {
+    #private;
+    constructor(onDestroy?: () => void);
+    get state(): EncoreClaimState;
+    get destroyed(): boolean;
+    /** INTERNAL: the controller loaded. It hears the visibility reported so far. */
+    attach(controller: ClaimController): void;
+    /** INTERNAL: the controller's new state. Listeners hear it only when it changed. */
+    setState(next: EncoreClaimState): void;
+    subscribe(listener: (state: EncoreClaimState) => void): () => void;
+    setVisible(fraction: number): void;
+    tap(target?: ClaimTarget): Promise<ShowResult>;
+    dismiss(): void;
+    bind(element: HTMLElement, options?: {
+        target?: ClaimTarget;
+        tap?: boolean;
+    }): () => void;
+    destroy(): void;
+}
+//# sourceMappingURL=claimHandle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimHandle.d.ts","sourceRoot":"","sources":["../../src/core/claimHandle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAKvF,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IAC5D,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;CACjB;AAiDD,qBAAa,WAAY,YAAW,WAAW;;gBAiBjC,SAAS,CAAC,EAAE,MAAM,IAAI;IAIlC,IAAI,KAAK,IAAI,gBAAgB,CAE5B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,gFAAgF;IAChF,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IASzC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAYtC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAoClE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMlC,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAU9C,OAAO,IAAI,IAAI;IASf,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,IAAI;IAuHzF,OAAO,IAAI,IAAI;CAqBhB"}

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"}