@encorekit/web-sdk 2.0.4 → 2.0.7

package/types/core/TransactionStore.d.ts

@@ -1,35 +1,79 @@
 /**
  * TransactionStore
  *
- * Local persistence for the two-phase (transaction -> redeem) flow. Backed by
- * StorageManager (localStorage-first), it holds:
- *  - transactions:     transactionId -> Transaction
- *  - placements: placementId -> transactionId  (the per-placement live-transaction map)
- *  - latest:     transactionId of the most recently created transaction
+ * Local record of claims awaiting redemption. Holds:
+ *  - transactions: transactionId -> Transaction
+ *  - placements:   placementId -> transactionId (the per-placement live-claim map)
+ *  - latest:       the most recently created transaction
  *
- * This is the fast path; the server transaction record (keyed by app_account_id, carrying
- * placementId) is the durable source of truth for cross-page / post-localStorage-loss
- * recovery. Expired or redeemed transactions are filtered out of the lookups.
+ * The BACKING is injected, and that is the whole of the difference between the two
+ * deferred behaviours: `deferred` writes through StorageManager and survives a
+ * reload; `deferredWhileAlive` writes to a plain object that dies with the page.
+ * Both then resolve, prune and expire identically — one implementation, so the
+ * session-scoped mode cannot quietly drift from the durable one.
+ *
+ * The server transaction record (keyed by app_account_id) remains the durable
+ * source of truth for cross-device recovery; this is the fast path.
+ *
+ * Expired and redeemed claims are filtered out of the RESOLVING lookups —
+ * `getLatest` and `getByPlacement`, the two that answer "what can be redeemed
+ * now". `getByTransactionId` deliberately does not filter: it answers "what is on
+ * record for this exact id", so it can report that a claim was redeemed.
+ *
+ * That report is not durable, and callers must not treat it as one: `#prune` drops
+ * redeemed and expired entries on the NEXT write, so a redeemed claim is readable
+ * only until then. The store is a cache of what is still actionable, not a ledger.
  */
 import type { Transaction } from '../types';
 import type { StorageManager } from './StorageManager';
+interface TransactionStoreState {
+    transactions: Record<string, Transaction>;
+    placements: Record<string, string>;
+    latest: string | null;
+}
+/** Where a store keeps its state. The only thing the two behaviours disagree on. */
+export interface TransactionBacking {
+    read(): TransactionStoreState | null;
+    write(state: TransactionStoreState): void;
+}
+/**
+ * A claim's creation time in ms, with an unparseable one pinned to 0 (oldest).
+ *
+ * Sorting on a raw `getTime()` puts NaN into the comparator, and a comparator that
+ * returns NaN makes the whole ordering implementation-defined — so ONE undateable
+ * record could change which claim is picked as "latest" among perfectly good ones.
+ * Deterministic beats correct-looking here: this store already defends against
+ * corrupted state, and the ordering has to be defended in the same breath.
+ */
+export declare function createdAtMs(transaction: {
+    createdAt: string;
+}): number;
+/** Durable: localStorage via StorageManager. Survives the page load. */
+export declare function persistentBacking(storage: StorageManager): TransactionBacking;
+/**
+ * Session-scoped: a closure. Deliberately touches NO storage API at all — not the
+ * key, not StorageManager — so `deferredWhileAlive` cannot leak a claim to disk
+ * through a shared code path.
+ */
+export declare function ephemeralBacking(): TransactionBacking;
 export declare class TransactionStore {
     #private;
-    constructor(storage: StorageManager);
+    constructor(backing: TransactionBacking);
     /** Persist a new transaction, updating the placement map and the latest pointer. */
     save(transaction: Transaction): void;
-    /** Resolve a transaction by exact transaction id (any status). */
+    /** Resolve a transaction by exact id (any status). */
     getByTransactionId(transactionId: string): Transaction | null;
     /**
-     * Resolve the LIVE transaction made at a placement. Returns null if none/expired/redeemed —
+     * The LIVE transaction claimed at a placement. Null if none/expired/redeemed —
      * never crosses to another placement's transaction.
      */
     getByPlacement(placementId: string): Transaction | null;
-    /** Resolve the single most-recent LIVE transaction for this user (the flat redeem() fallback). */
+    /** The single most-recent LIVE transaction (the flat redeem() fallback). */
     getLatest(): Transaction | null;
     /** Mark a transaction redeemed (idempotent). Frees its placement slot. */
     markRedeemed(transactionId: string): void;
-    /** Clear all transactions (used by reset()). */
+    /** Clear every transaction (reset()). */
     clear(): void;
 }
+export {};
 //# sourceMappingURL=TransactionStore.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TransactionStore.d.ts","sourceRoot":"","sources":["../../src/core/TransactionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAavD,qBAAa,gBAAgB;;gBAGf,OAAO,EAAE,cAAc;IAwBnC,oFAAoF;IACpF,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAepC,kEAAkE;IAClE,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAI7D;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAQvD,kGAAkG;IAClG,SAAS,IAAI,WAAW,GAAG,IAAI;IAa/B,0EAA0E;IAC1E,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IA8BzC,gDAAgD;IAChD,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"TransactionStore.d.ts","sourceRoot":"","sources":["../../src/core/TransactionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,IAAI,IAAI,qBAAqB,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC3C;AAID;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGtE;AA2BD,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAK7E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAQrD;AAED,qBAAa,gBAAgB;;gBAGf,OAAO,EAAE,kBAAkB;IAwDvC,oFAAoF;IACpF,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAepC,sDAAsD;IACtD,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAI7D;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAQvD,4EAA4E;IAC5E,SAAS,IAAI,WAAW,GAAG,IAAI;IAa/B,0EAA0E;IAC1E,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IA2BzC,yCAAyC;IACzC,KAAK,IAAI,IAAI;CAGd"}

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

@@ -1 +1 @@
-{"version":3,"file":"VerificationPoller.d.ts","sourceRoot":"","sources":["../../src/core/VerificationPoller.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,qBAAa,kBAAkB;;gBAUjB,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,yBAAyB;IAMpE;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAkBzC;;OAEG;IACH,IAAI,IAAI,IAAI;CAkFb"}
+{"version":3,"file":"VerificationPoller.d.ts","sourceRoot":"","sources":["../../src/core/VerificationPoller.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,qBAAa,kBAAkB;;gBAYjB,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,yBAAyB;IAMpE;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAkBzC;;OAEG;IACH,IAAI,IAAI,IAAI;CAqGb"}

package/types/core/claimBehavior.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `claimBehavior` — what a claim does with the advertiser handoff.
+ *
+ * 🔴 NOT A PUBLISHER OPTION. This is data on the VARIANT, the same way the reward
+ * sheet's copy and button actions are: `RewardActions.ts` tracks its variant's
+ * actions by symbol because web has no SDUI engine, and this file tracks the
+ * variant's claim behaviour the same way. It is deliberately absent from
+ * `PlacementOptions` and from `configure()` — 2.0.1's `redemptionMode` was a
+ * config knob, and making zero-config behaviour depend on a knob is what let a
+ * default flip break every integration that never set one.
+ *
+ *   immediate           redirect inside the click gesture; nothing is persisted.
+ *   deferred            persist the claim, hold the primer, redirect from redeem()
+ *                       — which may run on a LATER PAGE LOAD.
+ *   deferredWhileAlive  hold the claim in memory for this session only; never
+ *                       touch storage. Gone on reload, by design.
+ *
+ * The defaults below are the built-in variants' values and restore pre-2.0.2
+ * zero-config behaviour: `reduceChurn` is deferred (the host runs its own
+ * conversion, then redeems), `rewardUsers` is immediate (matching swift).
+ */
+import type { UseCase } from '../types';
+export type ClaimBehavior = 'immediate' | 'deferred' | 'deferredWhileAlive';
+/** Whether a behaviour keeps the claim past the click — i.e. redeem() has work. */
+export declare function isDeferred(behavior: ClaimBehavior): boolean;
+/** The behaviour for a presentation: the variant's value, else the built-in default. */
+export declare function claimBehaviorFor(useCase: UseCase, variantValues?: unknown): ClaimBehavior;
+//# sourceMappingURL=claimBehavior.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimBehavior.d.ts","sourceRoot":"","sources":["../../src/core/claimBehavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,oBAAoB,CAAC;AAE5E,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAE3D;AAmCD,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,aAAa,CAEzF"}

package/types/core/errorContext.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Where an error happened, as the backend's error-reporting taxonomy.
+ *
+ * The eleven values are copied verbatim from the Swift and Android SDKs. The
+ * backend fingerprints an issue as `[errorType, context]`, so a value invented
+ * here would split one cross-platform defect into a separate issue per
+ * platform instead of grouping it.
+ *
+ * Before this, web sent free prose ('Show flow error', 'Offer flow error'),
+ * which fingerprinted against nothing the other two SDKs emit.
+ *
+ * Deliberately not exported from `index.ts`: it is an internal wire vocabulary,
+ * not something a publisher passes in. Add a value here only together with the
+ * same value in Swift and Android.
+ */
+export declare const ERROR_CONTEXTS: readonly ["configuration", "present_offer_initialization", "fetch_offer_data", "start_transaction", "log_impression", "fetch_entitlements", "verify_transaction", "grant_signal", "api_request", "outbox", "analytics"];
+export type ErrorContext = (typeof ERROR_CONTEXTS)[number];
+//# sourceMappingURL=errorContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorContext.d.ts","sourceRoot":"","sources":["../../src/core/errorContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,yNAYjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/types/core/errorType.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The `errorType` half of the error-report fingerprint.
+ *
+ * The backend groups a Sentry issue by `[errorType, context]`, so this value
+ * has to mean the same thing on every SDK. Swift and Android both emit it from
+ * a sealed `EncoreError` hierarchy via `typeIdentifier`. web reported
+ * `error.constructor.name` instead, which is `"Error"` for essentially
+ * everything, so web errors grouped by `context` alone and could never join
+ * their iOS and Android counterparts.
+ *
+ * What was missing was never a taxonomy. web already has `ErrorCode`, and
+ * `APIClient` already attaches it to the errors it throws. This maps that
+ * existing structure onto the shared wire vocabulary.
+ *
+ * Deliberately NOT a rewrite into a sealed hierarchy. That is still worth doing
+ * (it would make the type intrinsic to the error rather than derived at the
+ * boundary, so a throw from outside `APIClient` would carry it too), and it
+ * remains its own ticket. This closes the fingerprint gap without waiting for
+ * it.
+ */
+/**
+ * The wire vocabulary, identical to Swift's and Android's `typeIdentifier`.
+ * A value invented here would split one defect into a separate issue per
+ * platform, which is the whole thing this exists to prevent.
+ */
+export declare const ERROR_TYPES: readonly ["network_error", "persistence_error", "http_error", "api_error", "decoding_error", "not_configured", "invalid_api_key", "invalid_url", "domain_error"];
+export type ErrorTypeIdentifier = (typeof ERROR_TYPES)[number];
+/**
+ * The server's own error code and status, for a report's metadata.
+ *
+ * Grouping is canonical across platforms; this is how the detail survives that.
+ * A backend `UNAUTHORIZED` and a backend `OFFER_EXPIRED` both group as
+ * `api_error`, and stay distinguishable by this field in Cloud Logging, or as
+ * an indexed tag if the backend ever promotes it.
+ */
+export declare function serverDetailOf(error: unknown): Record<string, string>;
+/**
+ * Deliberately NOT mapped, and this is the subtle half.
+ *
+ * `UNAUTHORIZED` and `NOT_FOUND` arrive as `data.code` in a server error body,
+ * so they describe the SERVER's verdict, not a client-side condition. Swift and
+ * Android turn any intelligible server rejection into `api_error`, and reserve
+ * `invalid_api_key` for their own client-side key validation. Mapping them here
+ * made the same backend 401 fingerprint as `[invalid_api_key, api_request]` on
+ * web and `[api_error, api_request]` on mobile, which is precisely the split
+ * this vocabulary exists to prevent.
+ *
+ * They fall through to `api_error`. The server's own code is not lost: it is
+ * echoed into the report as `serverCode`, where it segments without changing
+ * how anything groups.
+ */
+/**
+ * Resolves an unknown caught value to a shared `errorType`.
+ *
+ * Total by construction: anything unrecognised is `domain_error`, matching how
+ * Swift and Android wrap a foreign throwable. Reporting must never throw.
+ */
+export declare function errorTypeOf(error: unknown): ErrorTypeIdentifier;
+//# sourceMappingURL=errorType.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorType.d.ts","sourceRoot":"","sources":["../../src/core/errorType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;;;GAIG;AACH,eAAO,MAAM,WAAW,kKAUd,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAyB/D;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWrE;AAED;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA8B/D"}

package/types/core/hostDisplay.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Host display nouns + the deferred flow's composed copy.
+ *
+ * The nouns name the PUBLISHER's product (the host), as distinct from the
+ * advertiser on the offer. They are resolved fresh at each screen from the
+ * then-current remote config — nothing about them is persisted on a transaction,
+ * which stores transactional facts only.
+ *
+ * Everything the primer and redemption screens say is composed here. The screens
+ * never concatenate nouns themselves, so one sentence has one source.
+ *
+ * Absent nouns are NEVER an error. 2.0.1 failed the whole presentation with a
+ * CONFIGURATION_ERROR when the app icon was unset; an SDK that refuses to present
+ * because a logo is missing is worse than one that presents a quieter sentence.
+ * The screens degrade instead — see PrimerScreen's 'holding' variant.
+ */
+export interface HostDisplay {
+    appDisplayName?: string;
+    /** Composed, display-only, e.g. "1 month". Never parsed back into a number. */
+    trialPeriod?: string;
+    logoUrl?: string;
+}
+/** The remote values the nouns resolve from. All optional — the fetch may not have landed. */
+export interface RemoteHostSource {
+    appName?: string;
+    entitlementValue?: string;
+    entitlementUnit?: string;
+    /** `/config` `ui.values.media.appstoreIcon`. */
+    appIconUrl?: string;
+    /** `entitlements.native.durationDays` — the trial-end line's only input. */
+    trialDurationDays?: number;
+}
+/** 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 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 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;
+};
+//# sourceMappingURL=hostDisplay.d.ts.map

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

@@ -0,0 +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"}

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

package/types/types.d.ts

@@ -3,6 +3,7 @@
  * Shared types used across the SDK
  */
 import type { TextSlot, ButtonSlot } from './ui/appearance';
+import type { LogLevel } from './utils/logger';
 /**
  * Supported entitlement types with optional values
  */
@@ -202,6 +203,40 @@ export interface PlacementOptions {
     headline?: string;
     /** Counterpart to {@link headline}: same precedence, same blank-falls-through rule. */
     subheadline?: string;
+    /**
+     * Whether the user can dismiss the sheet. Defaults to `true`, and almost
+     * every integration should leave it there.
+     *
+     * `false` removes every in-sheet way out at once — the ×, the "No thanks"
+     * decline CTA, backdrop-click and Escape. Not "fewer ways out": a sheet that
+     * still closes on a backdrop tap is dismissable, so the flag would be doing
+     * nothing while reading as though it did.
+     *
+     * ⚠️ ONLY FOR A HOST THAT IS ITSELF THE WAY OUT. The single intended caller
+     * is Encore's hosted offer page, which a publisher's app opens in a webview:
+     * closing that webview is the dismissal, and it is a better one, because the
+     * in-sheet dismissal only ever landed the user on a page they then had to
+     * close the webview to leave anyway.
+     *
+     * On your own site there is no webview to close. A user who cannot dismiss
+     * the sheet is stuck on your page, so do not pass this. Nothing about the
+     * default changes for an integration that never mentions it.
+     *
+     * The focus trap is unaffected: Tab still cycles inside the sheet, which is
+     * a statement about where focus goes rather than a way out.
+     *
+     * ⚠️ THE PROMISE `show()` RETURNS THEN SETTLES ONLY ON A CLAIM. Every other
+     * resolution came from a dismissal, and there is no longer one — so a user
+     * who claims nothing leaves it pending for the life of the page. Correct
+     * where the host is the way out, since closing the webview ends the page and
+     * the promise with it, and another reason not to pass this anywhere else: on
+     * your own site it is a promise that never resolves.
+     *
+     * On the reward composition the "No thanks" button becomes "Next offer"
+     * rather than disappearing — see `RewardActionsOptions.secondary`. A button
+     * reading "No thanks" on a sheet with no way out is a control that lies.
+     */
+    dismissible?: boolean;
     /**
      * Status icon above the headline. Defaults to `'none'` — nothing renders unless
      * you explicitly ask for `'success'`, which draws a green-circle check.
@@ -261,6 +296,23 @@ export interface PlacementBuilder {
      * `Encore.show()`. Never rejects.
      */
     show(): Promise<ShowResult>;
+    /**
+     * Redeem the claim made at this placement — phase 2 of the deferred flow.
+     *
+     * Scoping follows the placement ID, and only a PUBLISHER-SET one exists to scope
+     * by:
+     * - `placement('cancel_flow').redeem()` resolves only the claim banked at
+     *   `'cancel_flow'`, never crossing to another placement's. Nothing there
+     *   resolves `unavailable`, even when a claim exists elsewhere.
+     * - `placement().redeem()` — the no-id form — has no placement to scope by. Its
+     *   minted `placement_<hex>` is local builder identity that never goes on the
+     *   wire, so no claim was ever filed under it. It falls back to the flat
+     *   most-recent-claim rule, i.e. exactly `Encore.redeem()`.
+     *
+     * Either form resolves `unavailable` when the variant's claim behaviour is
+     * `immediate`, since nothing is ever banked.
+     */
+    redeem(): Promise<RedeemResult>;
 }
 /**
  * Error codes used throughout the SDK
@@ -321,7 +373,11 @@ export interface UIConfiguration {
 export interface EncoreConfig {
     apiKey: string;
     environment?: 'production' | 'development' | 'staging' | 'localhost';
-    logLevel?: 'none' | 'debug';
+    /**
+     * Console verbosity. An ordered ladder: `'warn'` shows warnings and errors.
+     * Defaults to `'none'`, matching the Swift and Android SDKs.
+     */
+    logLevel?: LogLevel;
     /**
      * When a claim is treated as confirmed — the same axis as iOS's and Android's
      * `UnlockMode`, and global for the session (the native SDKs deliberately have no
@@ -384,6 +440,95 @@ export type ShowResult =
  | {
     status: 'unavailable';
 };
+/**
+ * The offer descriptor carried on a transaction — enough to render the redemption
+ * screen AND to rebuild the advertiser redirect at redeem() time, so a deferred
+ * claim never needs the live offer again (it may be redeemed on a page load that
+ * fetched no offers at all). `advertiserUrl` may contain a TRANSACTION_ID
+ * placeholder, substituted 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 `id` is
+ * that transaction's durable handle — the same value `didGrant()`,
+ * `waitForVerification()` and the backend all key on.
+ *
+ * Present only for the deferred claim behaviours. An `immediate` claim redeems
+ * inside the click and records nothing here.
+ */
+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 placement->claim map). */
+    placementId?: string;
+    offer: OfferRef;
+    /**
+     * The use case this claim was made under — persisted because redeem() may run on
+     * a later page load with only this record in hand, and the entitlement grant and
+     * the redemption narrative both turn on it. Stored as the PUBLIC symbol; records
+     * written by 2.0.1 and earlier carry the wire value and are normalised on read.
+     */
+    useCase?: UseCase;
+    status: 'claimed' | 'redeemed';
+    /** ISO-8601 timestamps. */
+    createdAt: string;
+    expiresAt: string;
+    redeemedAt?: string;
+}
+/** Options for `redeem()`. */
+export interface RedeemOptions {
+    /**
+     * Redeem the claim made at this placement. If none exists there it resolves
+     * `unavailable` — it never crosses to another placement's claim. Omit to take
+     * the single most-recent claim for this user.
+     */
+    placement?: string;
+    /**
+     * Host product row for the redemption screen's ledger. Override-only: name and
+     * logo default from the same remote config the primer uses, so most integrations
+     * never pass this. The trial-end detail line is always DERIVED (remote
+     * durationDays + the redemption moment) and is not settable.
+     */
+    host?: {
+        name?: string;
+        status?: string;
+        logoUrl?: string;
+    };
+}
+/** Result of `redeem()`. */
+export type RedeemResult = 
+/** The advertiser redirect was performed and the claim is now consumed. */
+{
+    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 claim is
+ * untouched, so calling redeem() again later is safe.
+ */
+ | {
+    status: 'dismissed';
+    reason?: NotGrantedReason;
+}
+/**
+ * STRICTLY "there is no claim to redeem" — never an error in disguise. This is
+ * also what an `immediate` integration always gets: nothing was ever held.
+ */
+ | {
+    status: 'unavailable';
+};
 /**
  * A subscription/conversion event forwarded from the host (Tier-1 client signal).
  * NON-AUTHORITATIVE — posted via the pk-authed analytics channel, never the HMAC

package/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM5D;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,aAAa,GAAG,KAAK,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAClD;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAMD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,oBAAoB,GACpB,uBAAuB,GACvB,mBAAmB;AACrB,sFAAsF;GACpF,mBAAmB;AACrB;;;;GAIG;GACD,eAAe,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oDAAoD;IACpD,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,wEAAwE;IACxE,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IACpD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACzC,oEAAoE;IACpE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,kFAAkF;IAClF,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,gBAAgB,CAAC;IAC7E,oBAAoB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAAG,gBAAgB,CAAC;IAC/E;;;;;OAKG;IACH,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7B;AAMD;;GAEG;AACH,oBAAY,SAAS;IACnB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAM7F;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;IACrE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;CACtC;AAMD,wCAAwC;AACxC,MAAM,MAAM,UAAU;AACpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AACH,wDAAwD;GACtD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE;AACpD,8DAA8D;GAC5D;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/types/ui/OfferModal.d.ts

@@ -26,6 +26,26 @@ export interface OfferModalOptions {
      * remain on every composition.
      */
     showCloseButton?: boolean;
+    /**
+     * Whether the sheet can be dismissed AT ALL. Defaults to `true`, which is
+     * every integration that does not deliberately ask otherwise.
+     *
+     * `false` removes the ×, backdrop-click and Escape together, because
+     * removing any one of them alone leaves the sheet dismissable and the caller
+     * did not ask for "fewer ways out", they asked for none. It is a
+     * host-capability statement, not a style: the only caller is Encore's own
+     * hosted offer page, where the surrounding webview is itself the way out and
+     * an in-sheet dismissal lands the user on a page they cannot leave either.
+     *
+     * ⚠️ A publisher's own site must NEVER pass this. There the sheet sits over
+     * the publisher's content with no webview to close, so a user who cannot
+     * dismiss is trapped on the page. The default keeps that impossible by
+     * omission rather than by convention.
+     *
+     * THE FOCUS TRAP IS NOT PART OF THIS. Tab still cycles inside the sheet:
+     * that is an accessibility guarantee about where focus goes, not a way out.
+     */
+    dismissible?: boolean;
     /**
      * Publisher override for the modal container's background, applied INLINE on the
      * modal element. Narrower than the `backgroundColor` theme variable, which also moves

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;AAG/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,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,UAAU;;gBAqBT,KAAK,GAAE,cAAmB,EAAE,OAAO,GAAE,iBAAsB;IASvE;;OAEG;IACH,IAAI,IAAI,IAAI;IAqCZ;;OAEG;IACH,IAAI,IAAI,IAAI;IA4CZ;;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;IA4BtC;;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;IA2Jb;;OAEG;IACH,OAAO,IAAI,IAAI;CAoBhB"}
+{"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;AAG/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,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,UAAU;;gBAsBT,KAAK,GAAE,cAAmB,EAAE,OAAO,GAAE,iBAAsB;IAavE;;OAEG;IACH,IAAI,IAAI,IAAI;IAqCZ;;OAEG;IACH,IAAI,IAAI,IAAI;IA4CZ;;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;IA4BtC;;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;IAmKb;;OAEG;IACH,OAAO,IAAI,IAAI;CAoBhB"}

package/types/ui/PrimerScreen.d.ts

@@ -1,17 +1,24 @@
 /**
- * Primer Screen Component (S1.5 of the deferred flow)
+ * Primer Screen — the holding state a deferred claim lands on.
  *
- * 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.
+ * Rendered into the open modal immediately after a deferred claim: the moment the
+ * claim is banked and the user is told it will be waiting. show() settles
+ * 'claimed' on this screen's CTA or on ANY modal dismissal — the claim is a fact
+ * either way, so the post-claim latch holds here.
+ *
+ * Two narratives, chosen by whether the host is nameable:
+ * - 'activation': the host's own trial is what happens next, so the copy names it.
+ * - 'holding':    no host nouns resolved, so the sentence is about the reward
+ *                 itself. This is a DEGRADATION, never an error — 2.0.1 refused to
+ *                 present at all here, which is the worse failure for an SDK.
  */
-import { type ResolvedDisplay } from '../core/DisplayResolver';
+import { type HostDisplay } from '../core/hostDisplay';
+export type PrimerVariant = 'activation' | 'holding';
 export interface PrimerScreenConfig {
-    /** Resolved host display nouns (guard-validated before Screen 1 rendered). */
-    display: ResolvedDisplay;
+    /** Which narrative to render. Defaults to 'holding' (the safe, host-free story). */
+    variant?: PrimerVariant;
+    /** Resolved host nouns. Empty is legal and selects 'holding'. */
+    display: HostDisplay;
     /** Partner branding from the just-claimed offer. */
     partner: {
         name?: string;
@@ -20,7 +27,7 @@ export interface PrimerScreenConfig {
     };
 }
 interface PrimerScreenEventMap extends Record<string, unknown> {
-    /** The user tapped the forward CTA — caller settles 'claimed' and closes. */
+    /** The user tapped the forward CTA — the caller settles 'claimed' and closes. */
     continue: undefined;
 }
 export declare class PrimerScreen {

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

@@ -1 +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"}
+{"version":3,"file":"PrimerScreen.d.ts","sourceRoot":"","sources":["../../src/ui/PrimerScreen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGpE,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,iEAAiE;IACjE,OAAO,EAAE,WAAW,CAAC;IACrB,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,iFAAiF;IACjF,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,qBAAa,YAAY;;gBAKX,MAAM,EAAE,kBAAkB;IAKtC,MAAM,IAAI,WAAW;IAoErB,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"}