@frak-labs/core-sdk 1.1.5 → 1.1.6-beta.ea740bc7

package/dist/{openSso-B0igO6Iu.d.cts → openSso-DSXbUP-j.d.cts}

@@ -1,202 +1,9 @@
+import { d as InteractionTypeKey, f as Currency, h as Language, i as GetMerchantInformationReturnType, m as I18nConfig, p as FrakWalletSdkConfig, v as AttributionDefaults, y as AttributionParams } from "./merchantInformation-BSuahpjl.cjs";
 import { OpenPanel } from "@openpanel/web";
 import { Address, Hex } from "viem";
 import { LifecycleMessage, RpcClient } from "@frak-labs/frame-connector";
 import { SiweMessage } from "viem/siwe";
 
-//#region src/types/tracking.d.ts
-type UtmParams = {
-  source?: string;
-  medium?: string;
-  campaign?: string;
-  term?: string;
-  content?: string;
-};
-/**
- * Attribution parameters appended to outbound sharing URLs.
- *
- * Defaults are derived from the V2 Frak context when available:
- * - `utmSource`: `"frak"`
- * - `utmMedium`: `"referral"`
- * - `utmCampaign`: merchantId (`context.m`)
- * - `via`: `"frak"`
- * - `ref`: clientId (`context.c`)
- *
- * Fields explicitly set here override the defaults. Existing params on the
- * base URL are preserved (gap-fill policy) to respect merchant-provided UTMs.
- */
-type AttributionParams = {
-  utmSource?: string;
-  utmMedium?: string;
-  utmCampaign?: string;
-  utmContent?: string;
-  utmTerm?: string;
-  via?: string;
-  ref?: string;
-};
-/**
- * Merchant-level attribution defaults.
- *
- * Same shape as {@link AttributionParams} minus `utmContent`, because
- * `utm_content` describes the specific content/creative being shared and is
- * inherently per-call or per-product (never a merchant-wide default).
- *
- * Used as the shape for both:
- * - `FrakWalletSdkConfig.attribution` (SDK-side compile-time defaults)
- * - Backend merchant-config attribution (dashboard-driven defaults)
- */
-type AttributionDefaults = Omit<AttributionParams, "utmContent">;
-type TrackArrivalParams = {
-  /** Sharer wallet address. Accepted in both V1 (legacy) and V2 (authenticated sharer) contexts. */referrerWallet?: Address;
-  referrerClientId?: string;
-  referrerMerchantId?: string; /** Epoch seconds timestamp from the referral link creation */
-  referralTimestamp?: number;
-};
-type TrackArrivalResult = {
-  success: boolean;
-  identityGroupId?: string;
-  referralLinkId?: string;
-  error?: string;
-};
-//#endregion
-//#region src/types/config.d.ts
-/**
- * All the currencies available
- * @category Config
- */
-type Currency = "eur" | "usd" | "gbp";
-/**
- * All the languages available
- * @category Config
- */
-type Language = "fr" | "en";
-/**
- * Configuration for the Frak Wallet SDK
- * @category Config
- */
-type FrakWalletSdkConfig = {
-  /**
-   * The Frak wallet url
-   * @defaultValue "https://wallet.frak.id"
-   */
-  walletUrl?: string;
-  /**
-   * Some metadata about your implementation of the Frak SDK
-   */
-  metadata: {
-    /**
-     * Your application name (will be displayed in a few modals and in SSO)
-     */
-    name?: string;
-    /**
-     * Your merchant ID from the Frak dashboard (UUID format)
-     * Used for referral tracking and analytics
-     * If not provided, will be auto-fetched from the backend using your domain
-     */
-    merchantId?: string;
-    /**
-     * Language to display in the modal
-     * If undefined, will default to the browser language
-     */
-    lang?: Language;
-    /**
-     * The currency to display in the modal
-     * @defaultValue `"eur"`
-     */
-    currency?: Currency;
-    /**
-     * The logo URL that will be displayed in a few components
-     */
-    logoUrl?: string;
-    /**
-     * The homepage link that could be displayed in a few components
-     */
-    homepageLink?: string;
-  };
-  /**
-   * Some customization for the modal
-   */
-  customizations?: {
-    /**
-     * Custom CSS styles to apply to the modals and components
-     */
-    css?: `${string}.css`;
-    /**
-     * Custom i18n configuration for the modal
-     */
-    i18n?: I18nConfig;
-  };
-  /**
-   * The domain name of your application
-   * @defaultValue window.location.host
-   */
-  domain?: string;
-  /**
-   * Wait for backend config before rendering components.
-   * When true (default), components show a spinner until backend config is resolved.
-   * When false, components render immediately with SDK static config / HTML attributes.
-   * @defaultValue true
-   */
-  waitForBackendConfig?: boolean;
-  /**
-   * Default attribution params (UTM / via / ref) appended to outbound
-   * sharing URLs. Per-call `displaySharingPage` overrides win, then backend
-   * config, then this SDK-level default. `utm_content` is intentionally
-   * excluded — it is per-content/per-product, never a merchant-wide default.
-   */
-  attribution?: AttributionDefaults;
-  /**
-   * Preload specific UI views inside the listener iframe for better UX.
-   * Default: ["sharing"]
-   */
-  preload?: ListenerPreloadOption[];
-};
-/**
- * Custom i18n configuration for the modal
- *  See [i18next json format](https://www.i18next.com/misc/json-format#i18next-json-v4)
- *
- * Available variables
- *  - `{{ productName }}` : The name of your website (`metadata.name`)
- *  - `{{ productOrigin }}` : The origin url of your website
- *  - `{{ estimatedReward }}` : The estimated reward for the user (based on the specific `targetInteraction` you can specify, or the max referrer reward if no target interaction is specified)
- *
- * Context of the translation [see i18n context](https://www.i18next.com/translation-function/context)
- *  - For modal display, the key of the final action (`sharing`, `reward`, or undefined)
- *  - For embedded wallet display, the key of the logged in action (`sharing` or undefined)
- *
- * @example
- * ```ts
- * // Multi language config
- * const multiI18n = {
- *  fr: {
- *      "sdk.modal.title": "Titre de modal",
- *      "sdk.modal.description": "Description de modal, avec {{ estimatedReward }} de gains possible",
- *  },
- *  en: "https://example.com/en.json"
- * }
- *
- * // Single language config
- * const singleI18n = {
- *      "sdk.modal.title": "Modal title",
- *      "sdk.modal.description": "Modal description, with {{ estimatedReward }} of gains possible",
- * }
- * ```
- *
- * @category Config
- */
-type I18nConfig = Record<Language, LocalizedI18nConfig> | LocalizedI18nConfig;
-/**
- * Options for preloading the listener UI
- * @category Config
- */
-type ListenerPreloadOption = "modal" | "sharing";
-/**
- * A localized i18n config (inline objects only — URL-based i18n removed)
- * @category Config
- */
-type LocalizedI18nConfig = {
-  [key: string]: string;
-};
-//#endregion
 //#region src/types/resolvedConfig.d.ts
 /**
  * Response from the merchant resolve endpoint
@@ -237,7 +44,8 @@ type ResolvedPlacement = {
       referrerText?: string;
       referrerNoRewardText?: string;
       ctaText?: string;
-      ctaNoRewardText?: string;
+      ctaNoRewardText?: string; /** Custom illustration URL replacing the built-in gift icon. */
+      imageUrl?: string;
       css?: string;
     };
     banner?: {
@@ -246,7 +54,8 @@ type ResolvedPlacement = {
       referralCta?: string;
       inappTitle?: string;
       inappDescription?: string;
-      inappCta?: string;
+      inappCta?: string; /** Custom illustration URL replacing the built-in gift icon. */
+      imageUrl?: string;
       css?: string;
     };
   };
@@ -404,19 +213,6 @@ type RedirectRequestEvent = {
   };
 };
 //#endregion
-//#region src/constants/interactionTypes.d.ts
-/**
- * The supported interaction type keys
- *
- * - `referral` - User arrived via a referral link
- * - `create_referral_link` - User created/shared a referral link
- * - `purchase` - User completed a purchase
- * - `custom.${string}` - Custom interaction type defined per campaign
- *
- * @inline
- */
-type InteractionTypeKey = "referral" | "create_referral_link" | "purchase" | `custom.${string}`;
-//#endregion
 //#region src/types/rpc/modal/generic.d.ts
 /**
  * Represent a generic modal step type
@@ -978,81 +774,6 @@ type SendInteractionParamsType = {
   idempotencyKey?: string;
 };
 //#endregion
-//#region src/types/rpc/merchantInformation.d.ts
-/**
- * The type for the amount of tokens
- */
-type TokenAmountType = {
-  amount: number;
-  eurAmount: number;
-  usdAmount: number;
-  gbpAmount: number;
-};
-/**
- * A tier definition for tiered rewards — pays either a flat token amount
- * or a percent of the tier field value
- */
-type RewardTier = {
-  minValue: number;
-  maxValue?: number;
-  amount: TokenAmountType;
-} | {
-  minValue: number;
-  maxValue?: number;
-  percent: number;
-};
-/**
- * Estimated reward amount — discriminated union by payout type
- *
- * - `fixed`: A known token amount (with fiat equivalents)
- * - `percentage`: A percent of a purchase field (e.g. 5% of purchase_amount), with optional min/max caps
- * - `tiered`: Amount depends on a field value matching tier brackets
- */
-type EstimatedReward = {
-  payoutType: "fixed";
-  amount: TokenAmountType;
-} | {
-  payoutType: "percentage";
-  percent: number;
-  percentOf: string;
-  maxAmount?: TokenAmountType;
-  minAmount?: TokenAmountType;
-} | {
-  payoutType: "tiered";
-  tierField: string;
-  tiers: RewardTier[];
-};
-/**
- * Response of the `frak_getMerchantInformation` RPC method
- * @group RPC Schema
- */
-type GetMerchantInformationReturnType = {
-  /**
-   * Current merchant id
-   */
-  id: string;
-  /**
-   * Some metadata
-   */
-  onChainMetadata: {
-    /**
-     * Name of the merchant on-chain
-     */
-    name: string;
-    /**
-     * Domain of the merchant on-chain
-     */
-    domain: string;
-  };
-  rewards: {
-    token?: Address;
-    campaignId: string;
-    interactionTypeKey: InteractionTypeKey;
-    referrer?: EstimatedReward;
-    referee?: EstimatedReward;
-  }[];
-};
-//#endregion
 //#region src/types/rpc/userReferralStatus.d.ts
 /**
  * User referral status returned by `frak_getUserReferralStatus`.
@@ -1392,5 +1113,5 @@ declare const ssoPopupName = "frak-sso";
  */
 declare function openSso(client: FrakClient, inputArgs: OpenSsoParamsType): Promise<OpenSsoReturnType>;
 //#endregion
-export { SdkResolvedConfig as $, ModalRpcStepsResultType as A, OpenSsoReturnType as B, LoggedInEmbeddedView as C, DisplayModalParamsType as D, SharingPageProduct as E, SiweAuthenticateModalStepType as F, FinalModalStepType as G, PrepareSsoReturnType as H, SiweAuthenticateReturnType as I, IFrameLifecycleEvent as J, ModalStepMetadata as K, SiweAuthenticationParams as L, SendTransactionModalStepType as M, SendTransactionReturnType as N, ModalRpcMetadata as O, SendTransactionTxType as P, ResolvedSdkConfig as Q, LoginModalStepType as R, EmbeddedViewActionSharing as S, DisplaySharingPageResultType as T, SsoMetadata as U, PrepareSsoParamsType as V, FinalActionType as W, MerchantConfigResponse as X, ClientLifecycleEvent as Y, ResolvedPlacement as Z, SendInteractionParamsType as _, FrakContextV1 as a, LocalizedI18nConfig as at, LoggedOutEmbeddedView as b, FrakLifecycleEvent as c, TrackArrivalParams as ct, WalletStatusReturnType as d, Currency as et, UserReferralStatusType as f, TokenAmountType as g, RewardTier as h, FrakContext as i, ListenerPreloadOption as it, ModalStepTypes as j, ModalRpcStepsInput as k, IFrameTransport as l, TrackArrivalResult as lt, GetMerchantInformationReturnType as m, ssoPopupFeatures as n, I18nConfig as nt, FrakContextV2 as o, AttributionDefaults as ot, EstimatedReward as p, InteractionTypeKey as q, ssoPopupName as r, Language as rt, FrakClient as s, AttributionParams as st, openSso as t, FrakWalletSdkConfig as tt, IFrameRpcSchema as u, UtmParams as ut, DisplayEmbeddedWalletParamsType as v, DisplaySharingPageParamsType as w, EmbeddedViewActionReferred as x, DisplayEmbeddedWalletResultType as y, OpenSsoParamsType as z };
-//# sourceMappingURL=openSso-B0igO6Iu.d.cts.map
+export { SendTransactionTxType as A, FinalActionType as B, DisplayModalParamsType as C, ModalStepTypes as D, ModalRpcStepsResultType as E, OpenSsoParamsType as F, MerchantConfigResponse as G, ModalStepMetadata as H, OpenSsoReturnType as I, SdkResolvedConfig as J, ResolvedPlacement as K, PrepareSsoParamsType as L, SiweAuthenticateReturnType as M, SiweAuthenticationParams as N, SendTransactionModalStepType as O, LoginModalStepType as P, PrepareSsoReturnType as R, SharingPageProduct as S, ModalRpcStepsInput as T, IFrameLifecycleEvent as U, FinalModalStepType as V, ClientLifecycleEvent as W, EmbeddedViewActionReferred as _, FrakContextV1 as a, DisplaySharingPageParamsType as b, FrakLifecycleEvent as c, WalletStatusReturnType as d, UserReferralStatusType as f, LoggedOutEmbeddedView as g, DisplayEmbeddedWalletResultType as h, FrakContext as i, SiweAuthenticateModalStepType as j, SendTransactionReturnType as k, IFrameTransport as l, DisplayEmbeddedWalletParamsType as m, ssoPopupFeatures as n, FrakContextV2 as o, SendInteractionParamsType as p, ResolvedSdkConfig as q, ssoPopupName as r, FrakClient as s, openSso as t, IFrameRpcSchema as u, EmbeddedViewActionSharing as v, ModalRpcMetadata as w, DisplaySharingPageResultType as x, LoggedInEmbeddedView as y, SsoMetadata as z };
+//# sourceMappingURL=openSso-DSXbUP-j.d.cts.map

package/dist/rewards.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./getCurrencyAmountKey-h2eOiYzv.cjs`);function t(e){return Array.isArray(e)?e:e.conditions}function n(e){if(typeof e==`number`)return e;if(typeof e==`string`&&e.trim()!==``){let t=Number(e);return Number.isFinite(t)?t:void 0}}function r(e,i,a){let o=[];for(let s of t(e)){if(`logic`in s){o.push(...r(s,i,a));continue}if(s.field===i&&a.has(s.operator)){let e=n(s.value);e!=null&&o.push(e)}}return o}const i=new Set([`gt`,`gte`,`between`]),a=new Set([`gt`,`gte`]);function o(e){let t=r(e,`purchase.amount`,i);return t.length>0?Math.min(...t):void 0}function s(e){let t=r(e,`time.timestamp`,a);if(t.length!==0)return new Date(Math.min(...t)*1e3)}function c(e,t){let n=Math.round((e+t)/2/10)*10;return Math.min(t,Math.max(e,n))}function l(e){return Math.max(100,e??0)}function u(e,t){return t==null?e:e<=100&&100<=t?100:c(e,t)}function d(e,t){let n=l(t);if(n<=0)return;let r=e.percent/100*n;return e.minAmount&&(r=Math.max(r,e.minAmount.eurAmount)),e.maxAmount&&(r=Math.min(r,e.maxAmount.eurAmount)),{basket:n,reward:r}}function f(e,t,n){let r=u(t,n);if(!(r<=0))return{basket:r,reward:e/100*r}}function p(e,t){switch(e.payoutType){case`fixed`:return e.amount[t];case`percentage`:return e.maxAmount?.[t]??0;case`tiered`:return e.tiers.reduce((e,n)=>`amount`in n?Math.max(e,n.amount[t]):e,0)}}function m(e){return e.payoutType===`percentage`?e.percent:e.payoutType===`tiered`?e.tiers.reduce((e,t)=>`percent`in t?Math.max(e,t.percent):e,0):0}function h(e,t){let n=p(e,t);return n>0?n:m(e)*1e-6}function g(t,n){let r=e.r(n),i=e.t(r);switch(t.payoutType){case`fixed`:return e.n(Math.round(t.amount[i]),r);case`percentage`:return`${t.percent} %`;case`tiered`:{let n=p(t,i);if(n>0)return e.n(Math.round(n),r);let a=m(t);return a>0?`${a} %`:e.n(0,r)}}}function _(t,n){if(t&&!(h(t,e.t(e.r(n)))<=0))return g(t,n)}function v(e,t){return t?e.replaceAll(`{REWARD}`,t):e.replaceAll(`{REWARD}`,``)}function y(e,t){return e.expiresAt!=null&&new Date(e.expiresAt).getTime()<=t}function b(e,t){let n=s(e.conditions);return n==null||n.getTime()<=t}function x(e,t){return t===`referee`?e.referee:e.referrer}function S(e,t,n){let r=x(e,n);return r?h(r,t):0}function C(t,n={}){let r=(n.now??new Date).getTime(),i=n.audience??`referrer`,a=e.t(e.r(n.currency)),o=(n.targetInteraction?t.filter(e=>e.interactionTypeKey===n.targetInteraction):t).filter(e=>!y(e,r)),c=o.filter(e=>b(e,r));if(c.length>0)return{campaign:c.reduce((e,t)=>S(t,a,i)>S(e,a,i)?t:e),status:`live`};let l=o.map(e=>({campaign:e,startsAt:s(e.conditions)})).filter(e=>e.startsAt!=null);if(l.length===0)return;let u=l.reduce((e,t)=>t.startsAt.getTime()<e.startsAt.getTime()?t:e);return{campaign:u.campaign,status:`upcoming`,startsAt:u.startsAt}}function w(t,n={}){let r=C(t,n);if(!r)return;let i=x(r.campaign,n.audience??`referrer`);if(!i)return;let a=_(i,n.currency);if(!a)return;let s=o(r.campaign.conditions),c=s==null?void 0:e.n(s,n.currency),l=r.campaign.defaultLockupSeconds,u=l&&l>0?Math.round(l/86400):void 0;return{formatted:a,payoutType:i.payoutType,minPurchaseAmount:c,lockupDurationDays:u}}function T(e,t={}){return w(e,t)?.formatted}exports.applyRewardPlaceholder=v,exports.buildPercentageExample=d,exports.buildTierExample=f,exports.extractMinPurchaseAmount=o,exports.extractStartDate=s,exports.formatBestReward=T,exports.formatEstimatedReward=g,exports.formatRewardOrHide=_,exports.getRewardValue=p,exports.pickFlatBasket=l,exports.pickTierBasket=u,exports.selectBestReward=w,exports.selectDisplayCampaign=C;
+//# sourceMappingURL=rewards.cjs.map

package/dist/rewards.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.cjs","names":["getSupportedCurrency","getCurrencyAmountKey","formatAmount","getCurrencyAmountKey","getSupportedCurrency","formatAmount"],"sources":["../src/rewards/conditions.ts","../src/rewards/example.ts","../src/rewards/value.ts","../src/rewards/format.ts","../src/rewards/select.ts"],"sourcesContent":["import type { ConditionGroup, RuleCondition, RuleConditions } from \"../types\";\n\ntype ConditionNode = RuleCondition | ConditionGroup;\n\nfunction conditionNodes(conditions: RuleConditions): ConditionNode[] {\n    return Array.isArray(conditions) ? conditions : conditions.conditions;\n}\n\nfunction conditionValueToNumber(\n    value: RuleCondition[\"value\"]\n): number | undefined {\n    if (typeof value === \"number\") return value;\n    if (typeof value === \"string\" && value.trim() !== \"\") {\n        const parsed = Number(value);\n        return Number.isFinite(parsed) ? parsed : undefined;\n    }\n    return undefined;\n}\n\n// Conditions arrive as a flat list or recursive groups; collect every numeric\n// value whose field + operator match, descending into nested groups.\nfunction collectConditionValues(\n    conditions: RuleConditions,\n    field: string,\n    operators: ReadonlySet<RuleCondition[\"operator\"]>\n): number[] {\n    const values: number[] = [];\n    for (const node of conditionNodes(conditions)) {\n        if (\"logic\" in node) {\n            values.push(...collectConditionValues(node, field, operators));\n            continue;\n        }\n        if (node.field === field && operators.has(node.operator)) {\n            const value = conditionValueToNumber(node.value);\n            if (value != null) values.push(value);\n        }\n    }\n    return values;\n}\n\nconst MIN_PURCHASE_OPERATORS: ReadonlySet<RuleCondition[\"operator\"]> = new Set([\n    \"gt\",\n    \"gte\",\n    \"between\",\n]);\nconst START_DATE_OPERATORS: ReadonlySet<RuleCondition[\"operator\"]> = new Set([\n    \"gt\",\n    \"gte\",\n]);\n\nexport function extractMinPurchaseAmount(\n    conditions: RuleConditions\n): number | undefined {\n    const values = collectConditionValues(\n        conditions,\n        \"purchase.amount\",\n        MIN_PURCHASE_OPERATORS\n    );\n    return values.length > 0 ? Math.min(...values) : undefined;\n}\n\n// The business app encodes a campaign start as a `time.timestamp >= <unix s>`\n// rule condition; the endpoint returns it verbatim inside `conditions`.\nexport function extractStartDate(conditions: RuleConditions): Date | undefined {\n    const values = collectConditionValues(\n        conditions,\n        \"time.timestamp\",\n        START_DATE_OPERATORS\n    );\n    if (values.length === 0) return undefined;\n    return new Date(Math.min(...values) * 1000);\n}\n","import type { EstimatedReward } from \"../types\";\n\ntype PercentageReward = Extract<EstimatedReward, { payoutType: \"percentage\" }>;\n\n// Reference order total used to turn a \"% of basket\" reward into a concrete\n// example amount. The campaign's minimum purchase overrides it when higher.\nconst REFERENCE_BASKET = 100;\n\nexport type RewardExample = {\n    basket: number;\n    reward: number;\n};\n\nfunction roundWithinRange(min: number, max: number): number {\n    const rounded = Math.round((min + max) / 2 / 10) * 10;\n    return Math.min(max, Math.max(min, rounded));\n}\n\nexport function pickFlatBasket(minPurchase: number | undefined): number {\n    return Math.max(REFERENCE_BASKET, minPurchase ?? 0);\n}\n\n// Basket for a percentage tier: the reference when it sits inside the tier\n// range, a round number within the range otherwise, or the lower bound for an\n// open-ended (uncapped) top tier.\nexport function pickTierBasket(\n    minValue: number,\n    maxValue: number | undefined\n): number {\n    if (maxValue == null) return minValue;\n    if (minValue <= REFERENCE_BASKET && REFERENCE_BASKET <= maxValue) {\n        return REFERENCE_BASKET;\n    }\n    return roundWithinRange(minValue, maxValue);\n}\n\nexport function buildPercentageExample(\n    reward: PercentageReward,\n    minPurchase: number | undefined\n): RewardExample | undefined {\n    const basket = pickFlatBasket(minPurchase);\n    if (basket <= 0) return undefined;\n    let amount = (reward.percent / 100) * basket;\n    if (reward.minAmount) amount = Math.max(amount, reward.minAmount.eurAmount);\n    if (reward.maxAmount) amount = Math.min(amount, reward.maxAmount.eurAmount);\n    return { basket, reward: amount };\n}\n\nexport function buildTierExample(\n    percent: number,\n    minValue: number,\n    maxValue: number | undefined\n): RewardExample | undefined {\n    const basket = pickTierBasket(minValue, maxValue);\n    if (basket <= 0) return undefined;\n    return { basket, reward: (percent / 100) * basket };\n}\n","import type { EstimatedReward, TokenAmountType } from \"../types\";\n\n/**\n * Comparable fiat value of a single reward, used to rank rewards against each\n * other.\n *\n * - `fixed`      → the token amount in the requested currency\n * - `tiered`     → the highest token amount across tiers\n * - `percentage` → the capped (`maxAmount`) value when present, otherwise `0`\n *                  (an uncapped percentage has no comparable fiat value)\n */\nexport function getRewardValue(\n    reward: EstimatedReward,\n    key: keyof TokenAmountType\n): number {\n    switch (reward.payoutType) {\n        case \"fixed\":\n            return reward.amount[key];\n        case \"percentage\":\n            return reward.maxAmount?.[key] ?? 0;\n        case \"tiered\":\n            return reward.tiers.reduce(\n                (max, tier) =>\n                    \"amount\" in tier ? Math.max(max, tier.amount[key]) : max,\n                0\n            );\n    }\n}\n\n/**\n * Highest percent a reward exposes: the flat `percentage` percent, or the\n * richest percent across `tiered` tiers, or `0` when it carries none.\n *\n * Shared by {@link getRewardRank} (to weight a percentage-only reward) and\n * `formatEstimatedReward` (to render it as `\"X %\"`), so the value the UI ranks\n * by and the value it prints stay derived from one tier traversal.\n */\nexport function maxRewardPercent(reward: EstimatedReward): number {\n    if (reward.payoutType === \"percentage\") return reward.percent;\n    if (reward.payoutType === \"tiered\") {\n        return reward.tiers.reduce(\n            (max, tier) =>\n                \"percent\" in tier ? Math.max(max, tier.percent) : max,\n            0\n        );\n    }\n    return 0;\n}\n\n// A reward with no money value (an uncapped percentage, or a percent-only\n// tier set) still renders as \"X %\", so it is worth surfacing. We give it a\n// positive ranking weight derived from its percent but scaled far below any\n// real-money reward, so the two invariants the UI relies on hold: (1) a reward\n// with real money always outranks a percentage-only reward, and (2) a\n// percentage-only reward still outranks a zero-value reward. Together they\n// guarantee the reward the ranking picks is always one we can display.\nconst PERCENT_ONLY_RANK_WEIGHT = 1e-6;\n\n/**\n * Ranking weight used to pick the single most attractive reward to surface.\n *\n * Mirrors {@link getRewardValue} (money value) but lifts a percentage-only\n * reward to a tiny positive weight instead of `0`, so it is never buried\n * behind a zero-value reward when choosing what to display.\n */\nexport function getRewardRank(\n    reward: EstimatedReward,\n    key: keyof TokenAmountType\n): number {\n    const value = getRewardValue(reward, key);\n    if (value > 0) return value;\n    return maxRewardPercent(reward) * PERCENT_ONLY_RANK_WEIGHT;\n}\n","import type { Currency, EstimatedReward } from \"../types\";\nimport { formatAmount } from \"../utils/format/formatAmount\";\nimport { getCurrencyAmountKey } from \"../utils/format/getCurrencyAmountKey\";\nimport { getSupportedCurrency } from \"../utils/format/getSupportedCurrency\";\nimport { getRewardRank, getRewardValue, maxRewardPercent } from \"./value\";\n\n/**\n * Format an {@link EstimatedReward} into a human-readable string.\n *\n * - `fixed`      → e.g. `\"5 €\"`\n * - `percentage` → e.g. `\"10 %\"`\n * - `tiered`     → the richest tier: max token amount (e.g. `\"50 €\"`) or, when\n *                  tiers only carry percentages, the max percent (e.g. `\"10 %\"`)\n *\n * Percentages are always rendered as a `\"X %\"` string: the backend never sends\n * a reference basket, so the reward cannot be resolved to a concrete amount\n * here. Callers that need a worked example use the `example` helpers instead.\n */\nexport function formatEstimatedReward(\n    reward: EstimatedReward,\n    currency?: Currency\n): string {\n    const supportedCurrency = getSupportedCurrency(currency);\n    const key = getCurrencyAmountKey(supportedCurrency);\n\n    switch (reward.payoutType) {\n        case \"fixed\":\n            return formatAmount(\n                Math.round(reward.amount[key]),\n                supportedCurrency\n            );\n\n        case \"percentage\":\n            return `${reward.percent} %`;\n\n        case \"tiered\": {\n            const maxAmount = getRewardValue(reward, key);\n            if (maxAmount > 0) {\n                return formatAmount(Math.round(maxAmount), supportedCurrency);\n            }\n            const maxPercent = maxRewardPercent(reward);\n            if (maxPercent > 0) {\n                return `${maxPercent} %`;\n            }\n            return formatAmount(0, supportedCurrency);\n        }\n    }\n}\n\n/**\n * Format a reward for display, or return `undefined` when it is not worth\n * advertising. Callers rely on `undefined` to hide a badge / fall back to\n * other copy.\n *\n * A reward is hidden only when it carries no displayable value — a `fixed` or\n * `tiered` reward whose money value is `0` (e.g. an unknown token price). An\n * uncapped percentage always renders as `\"X %\"`, since the percent itself is\n * meaningful even without a money value.\n */\nexport function formatRewardOrHide(\n    reward: EstimatedReward | undefined,\n    currency?: Currency\n): string | undefined {\n    if (!reward) return undefined;\n    const key = getCurrencyAmountKey(getSupportedCurrency(currency));\n    if (getRewardRank(reward, key) <= 0) return undefined;\n    return formatEstimatedReward(reward, currency);\n}\n\n/**\n * Replace the `{REWARD}` placeholder in a text string with a reward value.\n * If no reward is provided, returns the text with `{REWARD}` stripped.\n */\nexport function applyRewardPlaceholder(\n    text: string,\n    reward: string | undefined\n): string {\n    return reward\n        ? text.replaceAll(\"{REWARD}\", reward)\n        : text.replaceAll(\"{REWARD}\", \"\");\n}\n","import type { InteractionTypeKey } from \"../constants/interactionTypes\";\nimport type {\n    Currency,\n    EstimatedReward,\n    MerchantReward,\n    TokenAmountType,\n} from \"../types\";\nimport { formatAmount } from \"../utils/format/formatAmount\";\nimport { getCurrencyAmountKey } from \"../utils/format/getCurrencyAmountKey\";\nimport { getSupportedCurrency } from \"../utils/format/getSupportedCurrency\";\nimport { extractMinPurchaseAmount, extractStartDate } from \"./conditions\";\nimport { formatRewardOrHide } from \"./format\";\nimport { getRewardRank } from \"./value\";\n\n/** Reward side a surface cares about: the sharer (`referrer`) or the referred\n * user (`referee`). Drives both campaign ranking and which side is displayed. */\nexport type RewardAudience = \"referrer\" | \"referee\";\n\nexport type DisplayCampaign = {\n    campaign: MerchantReward;\n    status: \"live\" | \"upcoming\";\n    startsAt?: Date;\n};\n\nexport type SelectDisplayCampaignOptions = {\n    /** Reference \"now\" for expiry / start gating; defaults to the current time. */\n    now?: Date;\n    /** Currency the ranking is expressed in; defaults to EUR. */\n    currency?: Currency;\n    /** When set, only campaigns triggered by this interaction are considered. */\n    targetInteraction?: InteractionTypeKey;\n    /** Reward side to rank campaigns by; defaults to `\"referrer\"`. */\n    audience?: RewardAudience;\n};\n\nfunction isExpired(campaign: MerchantReward, nowMs: number): boolean {\n    return (\n        campaign.expiresAt != null &&\n        new Date(campaign.expiresAt).getTime() <= nowMs\n    );\n}\n\nfunction hasStarted(campaign: MerchantReward, nowMs: number): boolean {\n    const startsAt = extractStartDate(campaign.conditions);\n    return startsAt == null || startsAt.getTime() <= nowMs;\n}\n\nfunction audienceReward(campaign: MerchantReward, audience: RewardAudience) {\n    return audience === \"referee\" ? campaign.referee : campaign.referrer;\n}\n\nfunction campaignRank(\n    campaign: MerchantReward,\n    key: keyof TokenAmountType,\n    audience: RewardAudience\n): number {\n    const reward = audienceReward(campaign, audience);\n    return reward ? getRewardRank(reward, key) : 0;\n}\n\n/**\n * Pick the single campaign a merchant surface should display.\n *\n * Filters out expired (and, when `targetInteraction` is set, non-matching)\n * campaigns, then prefers the highest-ranked *live* campaign — ranked by the\n * `audience` reward side in the requested currency. When none has started yet\n * it falls back to the soonest-starting upcoming campaign (the endpoint does\n * not gate on the start-date condition, so future-start campaigns come\n * through).\n */\nexport function selectDisplayCampaign(\n    rewards: readonly MerchantReward[],\n    options: SelectDisplayCampaignOptions = {}\n): DisplayCampaign | undefined {\n    const nowMs = (options.now ?? new Date()).getTime();\n    const audience = options.audience ?? \"referrer\";\n    const key = getCurrencyAmountKey(getSupportedCurrency(options.currency));\n\n    const matching = options.targetInteraction\n        ? rewards.filter(\n              (campaign) =>\n                  campaign.interactionTypeKey === options.targetInteraction\n          )\n        : rewards;\n    const active = matching.filter((campaign) => !isExpired(campaign, nowMs));\n\n    const live = active.filter((campaign) => hasStarted(campaign, nowMs));\n    if (live.length > 0) {\n        const best = live.reduce((a, b) =>\n            campaignRank(b, key, audience) > campaignRank(a, key, audience)\n                ? b\n                : a\n        );\n        return { campaign: best, status: \"live\" };\n    }\n\n    const upcoming = active\n        .map((campaign) => ({\n            campaign,\n            startsAt: extractStartDate(campaign.conditions),\n        }))\n        .filter(\n            (entry): entry is { campaign: MerchantReward; startsAt: Date } =>\n                entry.startsAt != null\n        );\n    if (upcoming.length === 0) return undefined;\n\n    const soonest = upcoming.reduce((a, b) =>\n        b.startsAt.getTime() < a.startsAt.getTime() ? b : a\n    );\n    return {\n        campaign: soonest.campaign,\n        status: \"upcoming\",\n        startsAt: soonest.startsAt,\n    };\n}\n\n/**\n * The single reward a merchant surface should display: its formatted string\n * plus the `payoutType` of the underlying reward, so surfaces can adapt their\n * presentation (e.g. hide percentage rewards, prefix tiered ones with \"Up to\").\n */\nexport type BestReward = {\n    /** Display-ready reward string (e.g. `\"5 €\"`, `\"10 %\"`). */\n    formatted: string;\n    /** Payout type of the selected reward. */\n    payoutType: EstimatedReward[\"payoutType\"];\n    /**\n     * Minimum purchase amount gating the reward, formatted with the requested\n     * currency (e.g. `\"10 €\"`), or `undefined` when the campaign sets no\n     * minimum.\n     */\n    minPurchaseAmount?: string;\n    /**\n     * Whole-day lockup applied before the reward settles, or `undefined` when\n     * the campaign has no lockup.\n     */\n    lockupDurationDays?: number;\n};\n\n/**\n * Pick the best campaign for `options` and resolve its `audience`-side reward\n * to a formatted string plus its `payoutType`, or `undefined` when there is\n * nothing worth showing.\n *\n * Single entry point shared by every \"headline reward\" surface (share button,\n * wallet modal, sharing/install screens) so they all show the same number for\n * a given merchant and can branch on the payout type.\n */\nexport function selectBestReward(\n    rewards: readonly MerchantReward[],\n    options: SelectDisplayCampaignOptions = {}\n): BestReward | undefined {\n    const selected = selectDisplayCampaign(rewards, options);\n    if (!selected) return undefined;\n    const reward = audienceReward(\n        selected.campaign,\n        options.audience ?? \"referrer\"\n    );\n    if (!reward) return undefined;\n    const formatted = formatRewardOrHide(reward, options.currency);\n    if (!formatted) return undefined;\n\n    const minPurchase = extractMinPurchaseAmount(selected.campaign.conditions);\n    const minPurchaseAmount =\n        minPurchase != null\n            ? formatAmount(minPurchase, options.currency)\n            : undefined;\n\n    const lockupSeconds = selected.campaign.defaultLockupSeconds;\n    const lockupDurationDays =\n        lockupSeconds && lockupSeconds > 0\n            ? Math.round(lockupSeconds / 86_400)\n            : undefined;\n\n    return {\n        formatted,\n        payoutType: reward.payoutType,\n        minPurchaseAmount,\n        lockupDurationDays,\n    };\n}\n\n/**\n * Headline reward string for a merchant: picks the best campaign for `options`\n * and formats its `audience`-side reward, or returns `undefined` when there is\n * nothing worth showing.\n *\n * Thin wrapper over {@link selectBestReward} for callers that only need the\n * formatted string.\n */\nexport function formatBestReward(\n    rewards: readonly MerchantReward[],\n    options: SelectDisplayCampaignOptions = {}\n): string | undefined {\n    return selectBestReward(rewards, options)?.formatted;\n}\n"],"mappings":"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"}

package/dist/rewards.d.cts

@@ -0,0 +1,130 @@
+import { a as MerchantReward, c as RuleConditions, d as InteractionTypeKey, f as Currency, r as EstimatedReward, u as TokenAmountType } from "./merchantInformation-BSuahpjl.cjs";
+
+//#region src/rewards/conditions.d.ts
+declare function extractMinPurchaseAmount(conditions: RuleConditions): number | undefined;
+declare function extractStartDate(conditions: RuleConditions): Date | undefined;
+//#endregion
+//#region src/rewards/example.d.ts
+type PercentageReward = Extract<EstimatedReward, {
+  payoutType: "percentage";
+}>;
+type RewardExample = {
+  basket: number;
+  reward: number;
+};
+declare function pickFlatBasket(minPurchase: number | undefined): number;
+declare function pickTierBasket(minValue: number, maxValue: number | undefined): number;
+declare function buildPercentageExample(reward: PercentageReward, minPurchase: number | undefined): RewardExample | undefined;
+declare function buildTierExample(percent: number, minValue: number, maxValue: number | undefined): RewardExample | undefined;
+//#endregion
+//#region src/rewards/format.d.ts
+/**
+ * Format an {@link EstimatedReward} into a human-readable string.
+ *
+ * - `fixed`      → e.g. `"5 €"`
+ * - `percentage` → e.g. `"10 %"`
+ * - `tiered`     → the richest tier: max token amount (e.g. `"50 €"`) or, when
+ *                  tiers only carry percentages, the max percent (e.g. `"10 %"`)
+ *
+ * Percentages are always rendered as a `"X %"` string: the backend never sends
+ * a reference basket, so the reward cannot be resolved to a concrete amount
+ * here. Callers that need a worked example use the `example` helpers instead.
+ */
+declare function formatEstimatedReward(reward: EstimatedReward, currency?: Currency): string;
+/**
+ * Format a reward for display, or return `undefined` when it is not worth
+ * advertising. Callers rely on `undefined` to hide a badge / fall back to
+ * other copy.
+ *
+ * A reward is hidden only when it carries no displayable value — a `fixed` or
+ * `tiered` reward whose money value is `0` (e.g. an unknown token price). An
+ * uncapped percentage always renders as `"X %"`, since the percent itself is
+ * meaningful even without a money value.
+ */
+declare function formatRewardOrHide(reward: EstimatedReward | undefined, currency?: Currency): string | undefined;
+/**
+ * Replace the `{REWARD}` placeholder in a text string with a reward value.
+ * If no reward is provided, returns the text with `{REWARD}` stripped.
+ */
+declare function applyRewardPlaceholder(text: string, reward: string | undefined): string;
+//#endregion
+//#region src/rewards/select.d.ts
+/** Reward side a surface cares about: the sharer (`referrer`) or the referred
+ * user (`referee`). Drives both campaign ranking and which side is displayed. */
+type RewardAudience = "referrer" | "referee";
+type DisplayCampaign = {
+  campaign: MerchantReward;
+  status: "live" | "upcoming";
+  startsAt?: Date;
+};
+type SelectDisplayCampaignOptions = {
+  /** Reference "now" for expiry / start gating; defaults to the current time. */now?: Date; /** Currency the ranking is expressed in; defaults to EUR. */
+  currency?: Currency; /** When set, only campaigns triggered by this interaction are considered. */
+  targetInteraction?: InteractionTypeKey; /** Reward side to rank campaigns by; defaults to `"referrer"`. */
+  audience?: RewardAudience;
+};
+/**
+ * Pick the single campaign a merchant surface should display.
+ *
+ * Filters out expired (and, when `targetInteraction` is set, non-matching)
+ * campaigns, then prefers the highest-ranked *live* campaign — ranked by the
+ * `audience` reward side in the requested currency. When none has started yet
+ * it falls back to the soonest-starting upcoming campaign (the endpoint does
+ * not gate on the start-date condition, so future-start campaigns come
+ * through).
+ */
+declare function selectDisplayCampaign(rewards: readonly MerchantReward[], options?: SelectDisplayCampaignOptions): DisplayCampaign | undefined;
+/**
+ * The single reward a merchant surface should display: its formatted string
+ * plus the `payoutType` of the underlying reward, so surfaces can adapt their
+ * presentation (e.g. hide percentage rewards, prefix tiered ones with "Up to").
+ */
+type BestReward = {
+  /** Display-ready reward string (e.g. `"5 €"`, `"10 %"`). */formatted: string; /** Payout type of the selected reward. */
+  payoutType: EstimatedReward["payoutType"];
+  /**
+   * Minimum purchase amount gating the reward, formatted with the requested
+   * currency (e.g. `"10 €"`), or `undefined` when the campaign sets no
+   * minimum.
+   */
+  minPurchaseAmount?: string;
+  /**
+   * Whole-day lockup applied before the reward settles, or `undefined` when
+   * the campaign has no lockup.
+   */
+  lockupDurationDays?: number;
+};
+/**
+ * Pick the best campaign for `options` and resolve its `audience`-side reward
+ * to a formatted string plus its `payoutType`, or `undefined` when there is
+ * nothing worth showing.
+ *
+ * Single entry point shared by every "headline reward" surface (share button,
+ * wallet modal, sharing/install screens) so they all show the same number for
+ * a given merchant and can branch on the payout type.
+ */
+declare function selectBestReward(rewards: readonly MerchantReward[], options?: SelectDisplayCampaignOptions): BestReward | undefined;
+/**
+ * Headline reward string for a merchant: picks the best campaign for `options`
+ * and formats its `audience`-side reward, or returns `undefined` when there is
+ * nothing worth showing.
+ *
+ * Thin wrapper over {@link selectBestReward} for callers that only need the
+ * formatted string.
+ */
+declare function formatBestReward(rewards: readonly MerchantReward[], options?: SelectDisplayCampaignOptions): string | undefined;
+//#endregion
+//#region src/rewards/value.d.ts
+/**
+ * Comparable fiat value of a single reward, used to rank rewards against each
+ * other.
+ *
+ * - `fixed`      → the token amount in the requested currency
+ * - `tiered`     → the highest token amount across tiers
+ * - `percentage` → the capped (`maxAmount`) value when present, otherwise `0`
+ *                  (an uncapped percentage has no comparable fiat value)
+ */
+declare function getRewardValue(reward: EstimatedReward, key: keyof TokenAmountType): number;
+//#endregion
+export { type BestReward, type DisplayCampaign, type RewardAudience, type RewardExample, type SelectDisplayCampaignOptions, applyRewardPlaceholder, buildPercentageExample, buildTierExample, extractMinPurchaseAmount, extractStartDate, formatBestReward, formatEstimatedReward, formatRewardOrHide, getRewardValue, pickFlatBasket, pickTierBasket, selectBestReward, selectDisplayCampaign };
+//# sourceMappingURL=rewards.d.cts.map

package/dist/rewards.d.ts

@@ -0,0 +1,130 @@
+import { a as MerchantReward, c as RuleConditions, d as InteractionTypeKey, f as Currency, r as EstimatedReward, u as TokenAmountType } from "./merchantInformation--tLnowAN.js";
+
+//#region src/rewards/conditions.d.ts
+declare function extractMinPurchaseAmount(conditions: RuleConditions): number | undefined;
+declare function extractStartDate(conditions: RuleConditions): Date | undefined;
+//#endregion
+//#region src/rewards/example.d.ts
+type PercentageReward = Extract<EstimatedReward, {
+  payoutType: "percentage";
+}>;
+type RewardExample = {
+  basket: number;
+  reward: number;
+};
+declare function pickFlatBasket(minPurchase: number | undefined): number;
+declare function pickTierBasket(minValue: number, maxValue: number | undefined): number;
+declare function buildPercentageExample(reward: PercentageReward, minPurchase: number | undefined): RewardExample | undefined;
+declare function buildTierExample(percent: number, minValue: number, maxValue: number | undefined): RewardExample | undefined;
+//#endregion
+//#region src/rewards/format.d.ts
+/**
+ * Format an {@link EstimatedReward} into a human-readable string.
+ *
+ * - `fixed`      → e.g. `"5 €"`
+ * - `percentage` → e.g. `"10 %"`
+ * - `tiered`     → the richest tier: max token amount (e.g. `"50 €"`) or, when
+ *                  tiers only carry percentages, the max percent (e.g. `"10 %"`)
+ *
+ * Percentages are always rendered as a `"X %"` string: the backend never sends
+ * a reference basket, so the reward cannot be resolved to a concrete amount
+ * here. Callers that need a worked example use the `example` helpers instead.
+ */
+declare function formatEstimatedReward(reward: EstimatedReward, currency?: Currency): string;
+/**
+ * Format a reward for display, or return `undefined` when it is not worth
+ * advertising. Callers rely on `undefined` to hide a badge / fall back to
+ * other copy.
+ *
+ * A reward is hidden only when it carries no displayable value — a `fixed` or
+ * `tiered` reward whose money value is `0` (e.g. an unknown token price). An
+ * uncapped percentage always renders as `"X %"`, since the percent itself is
+ * meaningful even without a money value.
+ */
+declare function formatRewardOrHide(reward: EstimatedReward | undefined, currency?: Currency): string | undefined;
+/**
+ * Replace the `{REWARD}` placeholder in a text string with a reward value.
+ * If no reward is provided, returns the text with `{REWARD}` stripped.
+ */
+declare function applyRewardPlaceholder(text: string, reward: string | undefined): string;
+//#endregion
+//#region src/rewards/select.d.ts
+/** Reward side a surface cares about: the sharer (`referrer`) or the referred
+ * user (`referee`). Drives both campaign ranking and which side is displayed. */
+type RewardAudience = "referrer" | "referee";
+type DisplayCampaign = {
+  campaign: MerchantReward;
+  status: "live" | "upcoming";
+  startsAt?: Date;
+};
+type SelectDisplayCampaignOptions = {
+  /** Reference "now" for expiry / start gating; defaults to the current time. */now?: Date; /** Currency the ranking is expressed in; defaults to EUR. */
+  currency?: Currency; /** When set, only campaigns triggered by this interaction are considered. */
+  targetInteraction?: InteractionTypeKey; /** Reward side to rank campaigns by; defaults to `"referrer"`. */
+  audience?: RewardAudience;
+};
+/**
+ * Pick the single campaign a merchant surface should display.
+ *
+ * Filters out expired (and, when `targetInteraction` is set, non-matching)
+ * campaigns, then prefers the highest-ranked *live* campaign — ranked by the
+ * `audience` reward side in the requested currency. When none has started yet
+ * it falls back to the soonest-starting upcoming campaign (the endpoint does
+ * not gate on the start-date condition, so future-start campaigns come
+ * through).
+ */
+declare function selectDisplayCampaign(rewards: readonly MerchantReward[], options?: SelectDisplayCampaignOptions): DisplayCampaign | undefined;
+/**
+ * The single reward a merchant surface should display: its formatted string
+ * plus the `payoutType` of the underlying reward, so surfaces can adapt their
+ * presentation (e.g. hide percentage rewards, prefix tiered ones with "Up to").
+ */
+type BestReward = {
+  /** Display-ready reward string (e.g. `"5 €"`, `"10 %"`). */formatted: string; /** Payout type of the selected reward. */
+  payoutType: EstimatedReward["payoutType"];
+  /**
+   * Minimum purchase amount gating the reward, formatted with the requested
+   * currency (e.g. `"10 €"`), or `undefined` when the campaign sets no
+   * minimum.
+   */
+  minPurchaseAmount?: string;
+  /**
+   * Whole-day lockup applied before the reward settles, or `undefined` when
+   * the campaign has no lockup.
+   */
+  lockupDurationDays?: number;
+};
+/**
+ * Pick the best campaign for `options` and resolve its `audience`-side reward
+ * to a formatted string plus its `payoutType`, or `undefined` when there is
+ * nothing worth showing.
+ *
+ * Single entry point shared by every "headline reward" surface (share button,
+ * wallet modal, sharing/install screens) so they all show the same number for
+ * a given merchant and can branch on the payout type.
+ */
+declare function selectBestReward(rewards: readonly MerchantReward[], options?: SelectDisplayCampaignOptions): BestReward | undefined;
+/**
+ * Headline reward string for a merchant: picks the best campaign for `options`
+ * and formats its `audience`-side reward, or returns `undefined` when there is
+ * nothing worth showing.
+ *
+ * Thin wrapper over {@link selectBestReward} for callers that only need the
+ * formatted string.
+ */
+declare function formatBestReward(rewards: readonly MerchantReward[], options?: SelectDisplayCampaignOptions): string | undefined;
+//#endregion
+//#region src/rewards/value.d.ts
+/**
+ * Comparable fiat value of a single reward, used to rank rewards against each
+ * other.
+ *
+ * - `fixed`      → the token amount in the requested currency
+ * - `tiered`     → the highest token amount across tiers
+ * - `percentage` → the capped (`maxAmount`) value when present, otherwise `0`
+ *                  (an uncapped percentage has no comparable fiat value)
+ */
+declare function getRewardValue(reward: EstimatedReward, key: keyof TokenAmountType): number;
+//#endregion
+export { type BestReward, type DisplayCampaign, type RewardAudience, type RewardExample, type SelectDisplayCampaignOptions, applyRewardPlaceholder, buildPercentageExample, buildTierExample, extractMinPurchaseAmount, extractStartDate, formatBestReward, formatEstimatedReward, formatRewardOrHide, getRewardValue, pickFlatBasket, pickTierBasket, selectBestReward, selectDisplayCampaign };
+//# sourceMappingURL=rewards.d.ts.map