@fundedfast/sdk 1.3.0 → 1.4.0

package/dist/cjs/types.d.ts

@@ -21,9 +21,17 @@ export type WebhookDeliveryStatus = 'pending' | 'delivered' | 'failed';
 /** Tenant integration mode */
 export type IntegrationMode = 'sync' | 'async';
 /** All possible rejection reason codes from the rules engine */
-export type RejectionCode = 'min_stake_not_met' | 'max_stake_exceeded' | 'odds_limit_exceeded' | 'min_odds_not_met' | 'max_payout_exceeded' | 'max_selections_exceeded' | 'max_win_exceeded' | 'lucky_bet_profit_limit' | 'daily_drawdown_exceeded' | 'max_drawdown_exceeded' | 'cooldown_active' | 'cashout_not_allowed_during_challenge';
+export type RejectionCode = 'min_stake_not_met' | 'max_stake_exceeded' | 'odds_limit_exceeded' | 'min_odds_not_met' | 'max_payout_exceeded' | 'max_selections_exceeded' | 'max_win_exceeded' | 'lucky_bet_profit_limit' | 'daily_drawdown_exceeded' | 'max_drawdown_exceeded' | 'cooldown_active' | 'payout_pending' | 'cashout_not_allowed_during_challenge'
+/** Settlements only. A won/lost after a different result for the same bet: held for an operator, no balance change. */
+ | 'conflicting_settlement'
+/** Settlements only. Stake or odds differ from the accepted placement, or the payout exceeds stake x odds: held, no balance change. */
+ | 'settlement_mismatch'
+/** Settlements only. FAST never accepted this bet (rejected, or placed with no programme). Recorded, no balance change. */
+ | 'no_accepted_placement'
+/** Settlements only. Accepted on a programme that has closed since, typically a challenge that passed with the bet still open. Recorded under that programme, no balance change. */
+ | 'program_closed';
 /** Webhook event types emitted by FAST */
-export type WebhookEventType = 'challenge.activated' | 'challenge.passed' | 'challenge.completed' | 'challenge.failed' | 'challenge.cancelled' | 'challenge.expiring_soon' | 'challenge.stake_refunded' | 'challenge.bonus_voided' | 'funded_account.activated' | 'funded_account.revoked' | 'funded_account.payout' | 'funded_account.stake_refunded' | 'cooldown.triggered' | 'cooldown.lifted' | 'bet.validation_result' | 'achievement.earned' | 'reward.granted' | 'reward.applied' | 'user.self_excluded' | 'user.self_exclusion_lifted' | 'bonus.activated' | 'bonus.progress' | 'bonus.completed' | 'bonus.expired' | 'bonus.forfeited' | 'mission.enrolled' | 'mission.progress' | 'mission.completed' | 'mission.expired' | 'tournament.started' | 'tournament.user_joined' | 'tournament.user_invited' | 'tournament.settled' | 'tournament.cancelled' | 'loyalty.tier_upgraded' | 'loyalty.tier_downgraded' | 'loyalty.cashback_settled' | 'reward.expired';
+export type WebhookEventType = 'challenge.activated' | 'challenge.passed' | 'challenge.completed' | 'challenge.failed' | 'challenge.cancelled' | 'challenge.expiring_soon' | 'challenge.stake_refunded' | 'challenge.bonus_voided' | 'funded_account.activated' | 'funded_account.revoked' | 'funded_account.payout' | 'funded_account.stake_refunded' | 'funded_account.payout_requested' | 'funded_account.payout_rejected' | 'cooldown.triggered' | 'cooldown.lifted' | 'bet.validation_result' | 'achievement.earned' | 'reward.granted' | 'reward.applied' | 'user.self_excluded' | 'user.self_exclusion_lifted' | 'bonus.activated' | 'bonus.progress' | 'bonus.completed' | 'bonus.expired' | 'bonus.forfeited' | 'mission.enrolled' | 'mission.progress' | 'mission.completed' | 'mission.expired' | 'tournament.started' | 'tournament.user_joined' | 'tournament.user_invited' | 'tournament.settled' | 'tournament.cancelled' | 'loyalty.tier_upgraded' | 'loyalty.tier_downgraded' | 'loyalty.cashback_settled' | 'reward.expired';
 /** Body for POST /challenges/purchase */
 export interface PurchaseRequest {
     /** Your sportsbook user identifier */
@@ -60,8 +68,91 @@ export interface BetEvent {
 }
 /** Body for POST /users/:userId/withdraw */
 export interface WithdrawRequest {
-    /** Amount to withdraw. Must be <= withdrawable profit. */
+    /** Amount to pay out. Must be <= withdrawable and >= the minimum payout. Ignored on the last allowed payout, which is always the full available amount. */
+    amount?: number;
+    /** Leave the request pending for a later confirm/reject instead of executing it now. */
+    deferred?: boolean;
+}
+/** Why a payout is not possible yet. Every reason that applies is listed. */
+export interface PayoutReason {
+    code: 'account_not_active' | 'payout_pending' | 'max_payouts_reached' | 'no_profit' | 'insufficient_active_days' | 'insufficient_bets' | 'below_min_payout' | 'payout_interval' | 'open_bets';
+    /** False when the reason only keeps the cycle share out and unpaid profit can still be requested. */
+    blocking: boolean;
+    current?: number;
+    required?: number;
+    missing?: number;
+    until?: string;
+}
+export interface PendingPayout {
+    id: string;
+    amount: number;
+    fromUnpaid: number;
+    fromCycle: number;
+    isFinal: boolean;
+    isMandatory: boolean;
+    createdAt: string;
+}
+/** Payout state of a funded account (the per-cycle model). */
+export interface PayoutState {
+    currentBalance: number;
+    fundedAmount: number;
+    profitSplitPercent: number;
+    cycleProfit: number;
+    cycleShare: number;
+    /** Already split, not yet paid. Not part of the balance, never split again. */
+    unpaidProfit: number;
+    available: number;
+    withdrawableNow: number;
+    activeDays: number;
+    minActiveDays: number;
+    cycleBets: number;
+    minBets: number;
+    conditionsMet: boolean;
+    payoutCount: number;
+    maxPayouts: number | null;
+    remainingPayouts: number | null;
+    isFinal: boolean;
+    minPayout: number | null;
+    payoutIntervalDays: number | null;
+    lastPayoutAt: string | null;
+    nextPayoutAt: string | null;
+    mandatoryPayoutThreshold: number | null;
+    totalWithdrawn: number;
+    openStake: number;
+    pending: PendingPayout | null;
+    reasons: PayoutReason[];
+    canRequest: boolean;
+}
+export interface PayoutRequest {
+    id: string;
+    fundedAccountId: string;
+    userId: string;
     amount: number;
+    fromUnpaid: number;
+    fromCycle: number;
+    isFinal: boolean;
+    isMandatory: boolean;
+    status: 'pending' | 'executed' | 'rejected';
+    rejectionReason: string | null;
+    ownStakeReturned: number | null;
+    decidedBy: string | null;
+    createdAt: string;
+    decidedAt: string | null;
+}
+/** A payout request as the user's own list returns it: who decided it is not included. */
+export type UserPayoutRequest = Omit<PayoutRequest, 'decidedBy'>;
+/** Result of confirming a payout request. */
+export interface PayoutExecution {
+    payoutRequestId: string;
+    userPayout: number;
+    ownStakeReturned: number;
+    totalPayout: number;
+    operatorShare: number;
+    newBalance: number;
+    unpaidProfit: number;
+    cycleClosed: boolean;
+    forfeitedProfit: number;
+    accountClosed: boolean;
 }
 /** A challenge instance */
 export interface Challenge {
@@ -88,6 +179,54 @@ export interface Challenge {
     createdAt: string;
     updatedAt: string;
 }
+/** A challenge as GET /users/:userId/history returns it. */
+export interface ChallengeHistory {
+    id: string;
+    status: ChallengeStatus;
+    failureReason?: string | null;
+    ownStake: number;
+    startingBalance: number;
+    currentBalance: number;
+    targetBalance: number;
+    startedAt?: string | null;
+    expiresAt?: string | null;
+    totalBetsPlaced: number;
+    totalBetsAccepted: number;
+    activeDaysCount: number;
+    createdAt?: string | null;
+    /** Name of the tier it was bought as. */
+    tierName?: string | null;
+    /** When it finished. Null while active or awaiting the continue/refund choice. */
+    endedAt?: string | null;
+}
+/** A payout request as listed on a funded account in the user history. */
+export interface HistoryPayout {
+    amount: number;
+    status: 'pending' | 'executed' | 'rejected';
+    isFinal: boolean;
+    isMandatory: boolean;
+    createdAt: string;
+    decidedAt?: string | null;
+}
+/** A funded account as GET /users/:userId/history returns it. */
+export interface FundedAccountHistory {
+    id: string;
+    status: string;
+    revocationReason?: string | null;
+    fundedAmount: number;
+    currentBalance: number;
+    totalWithdrawn: number;
+    profitSplitPercent: number;
+    createdAt?: string | null;
+    /** The passed challenge the account was created from. */
+    challengeId?: string | null;
+    payoutCount?: number;
+    maxPayouts?: number | null;
+    /** When it closed or was revoked. Null while active. */
+    endedAt?: string | null;
+    /** Payout requests on the account, newest first. */
+    payouts?: HistoryPayout[];
+}
 /** A challenge product tier (as returned by the public /challenge-tiers endpoint) */
 export interface ChallengeTier {
     id: string;
@@ -123,21 +262,50 @@ export interface ChallengeTier {
     /** Lucky bet max profit as % of target */
     luckyBetMaxProfitPercent: number;
 }
-/** Full challenge tier with admin-level fields (from /admin/challenge-tiers) */
-export interface ChallengeTierFull extends ChallengeTier {
-    /** Max payout as % of funded balance per cycle. null = no cap */
-    payoutCapPercent: number | null;
-    /** ISO 4217 currency code */
-    currency: string;
-    enabled: boolean;
+/** Full challenge tier with admin-level fields (from /admin/challenge-tiers). The bet limits live on the referenced rulesets. */
+export interface ChallengeTierFull {
+    id: string;
+    tenantId: string;
+    name: string;
+    /** Own stake the user pays to enter */
+    ownStake: number;
+    /** Conditional bonus granted by the operator */
+    bonusAmount: number;
+    targetBalance: number;
+    durationDays: number;
     challengeRulesetId: string;
     fundedRulesetId: string;
+    fundedAccountBalance: number;
+    /** Profit split in user's favor (e.g. 80 = 80%) */
+    profitSplitPercent: number;
+    /** Max payout as % of funded balance per cycle. null = no cap */
+    payoutCapPercent: number | null;
+    /** @deprecated Decides nothing: every payout that includes the cycle share returns the balance to the funded amount. */
     resetBalanceOnPayout: boolean;
     fundedMinActiveDays: number;
     fundedActiveDayPercent: number;
+    /** Whether the user may take back the own stake during the funded phase. */
+    fundedStakeRefundable?: boolean;
+    /** Lifetime payout cap on the funded account. Null = none. */
+    fundedTotalPayoutCap?: number | null;
+    /** Accepted bets required per payout cycle. */
+    fundedMinBets?: number;
+    /** Most payouts the funded account allows. Null = no limit. */
+    fundedMaxPayouts?: number | null;
+    /** Smallest payout that may be requested. Null = none. */
+    fundedMinPayout?: number | null;
+    /** Days between payouts. Null = no interval. */
+    fundedPayoutIntervalDays?: number | null;
+    /** Balance at which a payout becomes mandatory. Null = never. */
+    fundedMandatoryPayoutThreshold?: number | null;
+    /** ISO 4217 currency code */
+    currency: string;
+    enabled: boolean;
     createdAt: string;
     updatedAt: string;
 }
+/** Body for creating a challenge tier: the fields the API requires, plus any optional ones. */
+export type ChallengeTierCreateRequest = Pick<ChallengeTierFull, 'name' | 'ownStake' | 'bonusAmount' | 'targetBalance' | 'durationDays' | 'challengeRulesetId' | 'fundedRulesetId' | 'fundedAccountBalance' | 'profitSplitPercent' | 'payoutCapPercent' | 'resetBalanceOnPayout' | 'fundedMinActiveDays' | 'fundedActiveDayPercent'> & Partial<Omit<ChallengeTierFull, 'id' | 'tenantId' | 'createdAt' | 'updatedAt'>>;
 /** Rules engine validation result */
 export interface ValidationResult {
     /** accepted = passes all rules, rejected = violates rules, flagged = accepted but noted */
@@ -160,8 +328,17 @@ export interface Ruleset {
     dailyDrawdownPercent: number;
     totalDrawdownPercent: number;
     cooldownDurationHours: number | null;
-    balanceCalculationBasis: 'original' | 'current';
-    enabled: boolean;
+    balanceCalculationBasis?: 'original' | 'current';
+    /** Max selections in an accumulator bet. 0 = no limit. */
+    maxAccumulatorSelections?: number;
+    /** Absolute cap on potential win per ticket. Null = no cap. */
+    maxWinPerTicket?: number | null;
+    /** Basis for the daily drawdown calculation. */
+    sessionStopBasis?: 'original' | 'current';
+    enabled?: boolean;
+    tenantId?: string;
+    createdAt?: string;
+    updatedAt?: string;
 }
 /** Live challenge progress for sportsbook UI */
 export interface ChallengeProgress {
@@ -208,7 +385,18 @@ export interface FundedAccountProgress {
     fundedAccountId: string;
     currentBalance: number;
     fundedAmount: number;
-    purchasePrice: number;
+    /** @deprecated Never returned by the API; always undefined. */
+    purchasePrice?: number;
+    /** Own stake the user paid to enter. */
+    ownStake?: number;
+    /** Operator bonus: never withdrawable. */
+    nonWithdrawableBonus?: number;
+    /** Own stake the user can still take back with `refundFundedStake` (0 when not allowed). */
+    refundableOwnStake?: number;
+    /** Whether the tier allows an own-stake refund in the funded phase. */
+    stakeRefundable?: boolean;
+    /** Lifetime payout cap, null for none. */
+    totalPayoutCap?: number | null;
     withdrawableProfit: number;
     earnedProfit: number;
     rawProfit: number;
@@ -218,8 +406,23 @@ export interface FundedAccountProgress {
     totalWithdrawn: number;
     activeDays: number;
     minActiveDays: number;
-    status: 'active';
+    status: 'active' | 'closed' | 'revoked';
     reserved: number;
+    /** Stake on bets not yet settled. */
+    openStake?: number;
+    payoutCount?: number;
+    maxPayouts?: number | null;
+    unpaidProfit?: number;
+    /** Accepted bets in the current payout cycle. */
+    totalBetsAccepted?: number;
+    /** Stake a day needs for it to count as an active day. */
+    activeDayThreshold?: number;
+    /** Stake placed today towards `activeDayThreshold`. */
+    todayWagered?: number;
+    minBetsRequired?: number;
+    maxWinPerTicket?: number | null;
+    payout?: PayoutState | null;
+    lastPayoutRequest?: Pick<PayoutRequest, 'id' | 'amount' | 'status' | 'rejectionReason' | 'isFinal' | 'isMandatory' | 'createdAt' | 'decidedAt'> | null;
     currency?: string;
     selfExcluded?: boolean;
 }
@@ -227,6 +430,11 @@ export interface FundedAccountProgress {
 export interface NoProgress {
     type: 'none';
     message: string;
+    /** How the last programme ended: a failed challenge, or a funded account that finished. */
+    lastOutcome?: (Record<string, unknown> & {
+        type: 'challenge_failed' | 'funded_closed';
+        endedAt: string;
+    }) | null;
     selfExcluded?: boolean;
 }
 /** Discriminated union - check the `type` field */
@@ -241,12 +449,23 @@ export interface WithdrawableInfo {
     activeDaysCount: number;
     minActiveDays: number;
     activeDaysMet: boolean;
+    payout: PayoutState;
 }
-/** Withdrawal result with profit split breakdown */
+/** Payout request result. `executed` carries the profit split breakdown. */
 export interface WithdrawalResult {
-    newBalance: number;
-    userPayout: number;
-    operatorShare: number;
+    status: 'pending' | 'executed';
+    payoutRequestId: string;
+    amount: number;
+    isFinal: boolean;
+    newBalance?: number;
+    userPayout?: number;
+    ownStakeReturned?: number;
+    totalPayout?: number;
+    operatorShare?: number;
+    resetApplied?: boolean;
+    unpaidProfit?: number;
+    forfeitedProfit?: number;
+    accountClosed?: boolean;
 }
 /** Bet ingestion result (sync or async mode) */
 export interface BetIngestResult {
@@ -255,17 +474,35 @@ export interface BetIngestResult {
     validationResult?: ValidationResult;
     message?: string;
 }
+/** One bet's outcome in a batch. */
+export interface BatchBetItemResult {
+    /** Zero-based position of the bet in the submitted array. */
+    index: number;
+    /**
+     * The submitted bet's externalBetId, filled in by the SDK from `index`.
+     * @sdkComputed
+     */
+    externalBetId?: string;
+    /** processed (sync mode), accepted (async mode, queued), or error. */
+    status: 'processed' | 'accepted' | 'error';
+    validationResult?: ValidationResult;
+    /** Why the bet failed, when status is 'error'. */
+    error?: string;
+}
 /** Batch bet ingestion result */
 export interface BatchBetResult {
+    status: 'completed';
     total: number;
+    /** Bets processed or accepted. */
+    succeeded: number;
+    /**
+     * @deprecated Use `succeeded`. Kept as an alias, filled in by the SDK.
+     * @sdkComputed
+     */
     processed: number;
     failed: number;
-    results: Array<{
-        externalBetId: string;
-        status: 'processed' | 'failed';
-        validationResult?: ValidationResult;
-        error?: string;
-    }>;
+    /** Per-bet results in submission order. */
+    results: BatchBetItemResult[];
 }
 /** Reconciliation data for cross-referencing with sportsbook records */
 export interface ReconciliationData {
@@ -280,13 +517,46 @@ export interface SseToken {
     ttl: number;
     userId: string;
 }
-/** Challenge tier terms and disclosures (regulatory compliance) */
+/** The ruleset limits disclosed with a tier's terms. */
+export interface TierTermsRules {
+    maxStakePercent: number;
+    minOdds: number;
+    maxOdds: number;
+    maxPayoutMultiplier: number;
+    maxWinPerTicket: number | null;
+    minBetsRequired: number;
+    minActiveDays: number;
+    dailyDrawdownPercent: number;
+    totalDrawdownPercent: number;
+    cooldownDurationHours: number | null;
+    luckyBetMaxProfitPercent: number;
+    luckyBetMaxOdds: number;
+    balanceCalculationBasis: string;
+}
+/** Language of the human-readable terms and disclosures. */
+export type TermsLanguage = 'en' | 'hr' | 'de';
+/** Challenge tier terms and disclosures (regulatory compliance), as GET /challenge-tiers/:id/terms returns them. */
 export interface TierTerms {
     tierId: string;
     tierName: string;
-    rules: string[];
+    purchasePrice: number;
+    ownStake: number;
+    bonusAmount: number;
+    currency: string;
+    /** Balance the user plays with: own stake + bonus. */
+    challengeBalance: number;
+    targetBalance: number;
+    durationDays: number;
+    /** Base balance of the reward (funded) account on continuing. */
+    rewardAccountBalance: number;
+    profitSplitPercent: number;
+    payoutCapPercent: number | null;
+    /** @deprecated Decides nothing: every payout that includes the cycle share returns the balance to the funded amount. */
+    resetBalanceOnPayout?: boolean;
+    rules: TierTermsRules;
+    /** Sentences to show the user before purchase, in `lang`. */
     disclosures: string[];
-    terms: string;
+    lang: TermsLanguage;
 }
 /** Webhook event payload delivered to your endpoint */
 export interface WebhookPayload<T = Record<string, unknown>> {
@@ -296,9 +566,8 @@ export interface WebhookPayload<T = Record<string, unknown>> {
     timestamp: string;
     data: T;
 }
-/** A user achievement (earned or locked) */
-export interface Achievement {
-    id: string;
+/** Fields every achievement carries, earned or not. */
+export interface AchievementBase {
     code: string;
     name: string;
     description: string;
@@ -306,20 +575,33 @@ export interface Achievement {
     category: string;
     points: number;
     rarity: 'common' | 'rare' | 'epic' | 'legendary';
-    earned: boolean;
-    earnedAt: string | null;
-    progress: number | null;
-    target: number | null;
+}
+/** An achievement the user has earned. */
+export interface Achievement extends AchievementBase {
+    earnedAt: string;
+    metadata: Record<string, unknown> | null;
+}
+/** An achievement not yet earned, with progress towards it. */
+export interface LockedAchievement extends AchievementBase {
+    sortOrder: number;
+    /** What earns it: `progress` counts towards `threshold`. */
+    criteria: {
+        type: string;
+        threshold: number;
+    } | null;
+    progress: number;
 }
 /** User achievements response */
 export interface UserAchievements {
+    /** Earned achievements, most recent first. */
     achievements: Achievement[];
+    /** Achievements not yet earned, in display order. */
+    locked: LockedAchievement[];
     totalPoints: number;
     level: number;
     streak: {
         current: number;
         longest: number;
-        lastActiveDate: string | null;
     };
 }
 /** Reward type */
@@ -330,11 +612,15 @@ export type RewardApplyMode = 'auto' | 'claim';
 export interface Reward {
     id: string;
     rewardType: RewardType;
+    /** In EUR for money types, otherwise percent or days. */
     rewardValue: number;
+    /** On claimable items the API omits this; the SDK fills `'claim'`. */
     applyMode: RewardApplyMode;
+    /** ISO 8601, or null when it never expires. */
     expiresAt: string | null;
     achievementCode: string | null;
     achievementName: string | null;
+    /** ISO 8601 */
     createdAt: string;
 }
 /** User rewards response */
@@ -344,10 +630,9 @@ export interface UserRewards {
     /** Rewards waiting for user to claim */
     claimable: Reward[];
 }
-/** Reward claim result */
+/** Reward claim result. Read the reward back with `users.getRewards()` if you need it. */
 export interface RewardClaimResult {
     claimed: boolean;
-    reward: Reward;
 }
 /** Leaderboard entry */
 export interface LeaderboardEntry {
@@ -380,27 +665,41 @@ export interface SandboxResetResult {
 export interface SandboxUserResetResult {
     status: string;
     userId: string;
-    deleted: Record<string, number>;
+    /** Which kinds of data were cleared (challenges, fundedAccounts, betEvents, webhookDeliveries). */
+    deleted: Record<string, boolean>;
 }
 /** Bet event as returned by admin endpoints */
 export interface AdminBetEvent {
     id: string;
+    tenantId?: string;
     userId: string;
     externalBetId: string;
+    challengeId?: string | null;
+    fundedAccountId?: string | null;
     stakeAmount: number;
     odds: number;
+    betTypeIdentifier?: string | null;
     status: BetStatus;
+    isCashOut?: boolean;
     validationResult: ValidationStatus | null;
-    reasonCodes: RejectionCode[];
+    /** Rule violation codes. Empty when accepted. */
+    rejectionReasons: RejectionCode[];
+    /**
+     * @deprecated The API calls this `rejectionReasons`; the SDK fills this alias from it.
+     * @sdkComputed
+     */
+    reasonCodes?: RejectionCode[];
     settlementAmount: number | null;
+    currency?: string;
     eventTimestamp: string;
+    processedAt?: string | null;
     createdAt: string;
 }
 /** Settle a bet event */
 export interface BetSettleRequest {
     outcome: 'won' | 'lost';
 }
-/** Bulk settle request */
+/** Bulk settle request (max 50 settlements per call) */
 export interface BulkSettleRequest {
     settlements: Array<{
         betEventId: string;
@@ -411,6 +710,10 @@ export interface BulkSettleRequest {
 export interface BulkSettleResult {
     results: Array<{
         betEventId: string;
+        status: 'settled' | 'error';
+        /** Why it was not settled, e.g. `not_found`, `already_settled`. */
+        error?: string;
+        /** @deprecated Use `status === 'settled'`. Filled in by the SDK. */
         success: boolean;
     }>;
     settled: number;
@@ -422,120 +725,294 @@ export interface WebhookDelivery {
     eventId: string;
     eventType: WebhookEventType;
     userId: string;
+    /** The exact body that was (or will be) POSTed. */
+    payload: WebhookPayload;
+    webhookUrl: string;
     status: WebhookDeliveryStatus;
     responseStatus: number | null;
     attempts: number;
     lastAttemptAt: string | null;
     createdAt: string;
 }
-/** Audit log entry */
+/** A webhook delivery that exhausted its retries. */
+export interface WebhookDeadLetter {
+    id: string;
+    tenantId: string;
+    deliveryId: string;
+    eventId: string;
+    eventType: WebhookEventType;
+    userId: string;
+    payload: WebhookPayload;
+    webhookUrl: string;
+    finalAttempts: number;
+    lastError: string | null;
+    /** When it was replayed. Null until then; a dead letter replays once. */
+    replayedAt: string | null;
+    replayDeliveryId: string | null;
+    createdAt: string;
+}
+/** Result of rotating the webhook signing secret. */
+export interface WebhookSecretRotation {
+    /** The new signing secret. Shown once: store it now. */
+    newSecret: string;
+    /** Hours the old secret keeps being accepted. */
+    gracePeriodHours: number;
+    oldSecretExpiresAt: string;
+    /** @deprecated Use `newSecret`. Filled in by the SDK. */
+    webhookSecret: string;
+}
+/** Admin audit log entry (GET /admin/audit-log) */
 export interface AuditEntry {
     id: string;
+    tenantId: string;
     action: string;
+    /** Admin email, or `api-key` for server-key calls. */
     actor: string;
-    tenantId: string;
-    targetId: string | null;
-    targetType: string | null;
-    metadata: Record<string, unknown>;
+    resourceType: string | null;
+    resourceId: string | null;
+    details: Record<string, unknown> | null;
+    ipAddress: string | null;
     createdAt: string;
 }
+/** Which ledger GET /audit/log reads. */
+export type AuditLogType = 'bets' | 'webhooks';
+/** Page of GET /audit/log: bet events or webhook deliveries. */
+export interface AuditLogPage {
+    /** `bet_events` or `webhook_deliveries`. */
+    type: string;
+    total: number;
+    limit: number;
+    offset: number;
+    entries: Array<Record<string, unknown>>;
+}
 /** Tenant settings */
 export interface TenantSettings {
+    tenantId?: string;
+    name?: string;
+    environment?: string;
     integrationMode: IntegrationMode;
     webhookUrl: string | null;
     /** Single URL FAST calls before any money/irreversible action (type in payload). */
     approvalUrl: string | null;
     operatorChallengeLimit: number | null;
+    monthlyChallengeLimit?: number | null;
+    effectiveChallengeLimit?: number | null;
+    revenueSharePercent?: number;
+    exposureAlertThreshold?: number | null;
+    exportEnabled?: boolean;
+    exportEmail?: string | null;
+    exportWebhookUrl?: string | null;
+    defaultCurrency?: string;
+    supportedCurrencies?: string[];
+    widgetLayout?: {
+        fundedOnly: boolean;
+        history: boolean;
+    };
+    createdAt?: string;
 }
-/** Admin overview stats */
+/** Admin overview stats (GET /admin/overview) */
 export interface AdminOverview {
+    period: {
+        month: number;
+        year: number;
+    };
+    /** Count per challenge status. */
     challenges: Record<string, number>;
+    /** Count per funded account status. */
     fundedAccounts: Record<string, number>;
-    totalBets: number;
-    uniqueUsers: number;
+    revenue: {
+        allTime: Record<string, number>;
+        /** Includes `uniqueUsers` for the month. */
+        month: Record<string, number>;
+        revenueShare: Record<string, number>;
+    };
+    exposure: Record<string, unknown>;
+    usage: Record<string, number>;
 }
-/** Bonus offer (admin) */
+/** Bonus type */
+export type BonusType = 'deposit_match' | 'free_bet' | 'no_deposit' | 'cashback' | 'reload';
+/** Bonus offer (admin). Money fields are integer cents. */
 export interface BonusOffer {
     id: string;
+    tenantId?: string;
     name: string;
-    bonusType: string;
+    description: string | null;
+    bonusType: BonusType;
     matchPercent: number | null;
+    /** Integer cents. */
     maxBonusAmount: number;
     wageringMultiplier: number;
-    durationDays: number;
     minOdds: number | null;
+    /** Integer cents. */
+    maxBetFromBonus: number | null;
+    excludedMarkets: string[] | null;
+    durationDays: number;
+    /** Integer cents. */
+    minQualifyingDeposit: number | null;
+    maxActivations: number | null;
     maxPerUser: number | null;
+    stackable: boolean;
     forfeitOnWithdrawal: boolean;
     enabled: boolean;
+    startsAt: string | null;
+    endsAt: string | null;
+    sortOrder: number;
     createdAt: string;
+    updatedAt: string;
 }
-/** Bonus stats */
+/** Bonus stats (GET /admin/bonuses/stats) */
 export interface BonusStats {
-    totalActive: number;
-    totalCompleted: number;
-    totalForfeited: number;
-    totalBonusAmount: number;
+    activeCount: number;
+    /** Percent of bonuses completed over the last 30 days. */
+    completionRate30d: number;
+    /** Bonus balance outstanding, integer cents. */
+    totalOutstanding: number;
+    avgProgress: number;
 }
 /** Mission definition (admin) */
 export interface MissionDef {
     id: string;
+    tenantId?: string;
     name: string;
     description: string | null;
+    icon: string | null;
     criteriaType: string;
     criteriaThreshold: number;
+    criteriaMeta: Record<string, unknown> | null;
     rewardType: string | null;
+    /** In cents for money types (bonus credit, free bet, fixed discount...), otherwise percent, days or points. Unlike reward rules and grants, which take EUR. */
     rewardValue: number;
-    enrollmentMode: 'auto' | 'opt_in';
-    durationHours: number | null;
-    maxParticipants: number | null;
+    rewardApplyMode: string;
+    startsAt: string;
+    endsAt: string;
+    enrollmentMode: 'auto' | 'opt_in' | 'targeted';
+    repeatable: boolean;
+    maxCompletionsPerUser: number;
     enabled: boolean;
+    sortOrder: number;
     createdAt: string;
+    updatedAt: string;
+}
+/** Fields the API assigns itself and drops from a request body. */
+type ServerManaged = 'id' | 'tenantId' | 'createdAt' | 'updatedAt';
+/** Body for creating a mission: the fields the API requires, plus any optional ones. A new mission starts enabled. */
+export type MissionCreateRequest = Pick<MissionDef, 'name' | 'criteriaType' | 'criteriaThreshold' | 'startsAt' | 'endsAt'> & Partial<Omit<MissionDef, ServerManaged | 'enabled'>>;
+/** Body for updating a mission: any subset of its editable fields. */
+export type MissionUpdateRequest = Partial<Omit<MissionDef, ServerManaged>>;
+type RulesetRequired = 'name' | 'maxStakePercent' | 'minOdds' | 'maxOdds' | 'maxPayoutMultiplier' | 'dailyDrawdownPercent' | 'totalDrawdownPercent' | 'minActiveDays' | 'minBetsRequired' | 'luckyBetMaxOdds' | 'luckyBetMaxProfitPercent';
+/** Body for creating a ruleset: the limits the API requires, plus any optional ones. */
+export type RulesetCreateRequest = Pick<Ruleset, RulesetRequired> & Partial<Omit<Ruleset, RulesetRequired | ServerManaged>>;
+/** Body for updating a ruleset: any subset of its editable fields. */
+export type RulesetUpdateRequest = Partial<Omit<Ruleset, ServerManaged>>;
+/** Body for creating a bonus offer. A new offer starts enabled. */
+export type BonusOfferCreateRequest = Pick<BonusOffer, 'name' | 'bonusType' | 'maxBonusAmount'> & Partial<Omit<BonusOffer, 'name' | 'bonusType' | 'maxBonusAmount' | 'enabled' | ServerManaged>>;
+/** Body for updating a bonus offer. The bonus type is fixed once created. */
+export type BonusOfferUpdateRequest = Partial<Omit<BonusOffer, 'bonusType' | ServerManaged>>;
+/** Body for updating the loyalty programme configuration. */
+export type LoyaltyConfigUpdateRequest = Partial<Omit<LoyaltyConfig, ServerManaged>>;
+/** Tournament lifecycle state */
+export type TournamentStatus = 'upcoming' | 'active' | 'settling' | 'completed' | 'cancelled';
+/** A prize band: ranks rankFrom..rankTo each receive the reward. */
+export interface TournamentPrize {
+    rankFrom: number;
+    rankTo: number;
+    rewardType: string;
+    /** In cents for money types, otherwise percent, days or points. */
+    rewardValue: number;
 }
 /** Tournament definition (admin) */
 export interface TournamentDef {
     id: string;
+    tenantId?: string;
     name: string;
     description: string | null;
-    status: 'draft' | 'scheduled' | 'active' | 'settling' | 'settled';
-    entryMode: 'free' | 'paid';
-    entryFee: number;
-    prizePool: number;
-    maxEntrants: number | null;
-    scoringMetric: string;
+    scoringMetric: 'net_profit' | 'total_wagered' | 'win_count' | 'bet_count' | 'highest_odds_won' | 'longest_win_streak';
     startsAt: string;
     endsAt: string;
+    entryMode: 'auto' | 'opt_in' | 'invite';
+    minBetsToQualify: number;
+    maxParticipants: number | null;
+    prizes: TournamentPrize[];
+    tiebreaker: 'earliest_entry' | 'most_bets' | 'highest_single_win' | null;
+    status: TournamentStatus;
+    totalEntries: number;
+    settledAt: string | null;
     createdAt: string;
+    updatedAt?: string;
 }
+/** Body for creating a tournament: the fields the API requires, plus any optional ones. */
+export type TournamentCreateRequest = Pick<TournamentDef, 'name' | 'scoringMetric' | 'startsAt' | 'endsAt' | 'prizes'> & Partial<Pick<TournamentDef, 'description' | 'entryMode' | 'minBetsToQualify' | 'maxParticipants' | 'tiebreaker'>>;
 /** Tournament leaderboard entry */
 export interface TournamentLeaderboardEntry {
     rank: number;
     userId: string;
+    /** Masked user id for display. */
     displayName: string;
     score: number;
-    prize: number | null;
+    qualifyingBets: number;
+}
+/** A tournament entry row as the admin entries list returns it. */
+export interface TournamentEntry {
+    id: string;
+    tenantId: string;
+    tournamentId: string;
+    userId: string;
+    score: number | null;
+    qualifyingBets: number | null;
+    rank: number | null;
+    prizeType: string | null;
+    /** In cents for money types. */
+    prizeValue: number | null;
+    prizeGranted: boolean | null;
+    enteredAt: string | null;
+    lastScoreUpdate: string | null;
 }
-/** Loyalty config */
+/** Loyalty config (GET/PUT /admin/loyalty/config) */
 export interface LoyaltyConfig {
-    enabled: boolean;
-    pointsPerEurWagered: number;
-    cashbackPercent: number;
-    decayDays: number | null;
+    id?: string;
+    tenantId?: string;
+    /** Activity-to-points rules, e.g. `{ activity: 'bet_placed', pointsPerEurWagered: 1, maxPerDay: 500 }`. */
+    pointRules: Array<Record<string, unknown>>;
+    decayMode: string;
     decayPercent: number | null;
+    cashbackEnabled: boolean;
+    cashbackSettleMode: string;
+    demotionEnabled: boolean;
+    demotionGraceDays: number;
+    enabled: boolean;
+    createdAt?: string;
+    updatedAt?: string;
 }
 /** Loyalty tier */
 export interface LoyaltyTier {
     id: string;
+    tenantId?: string;
     name: string;
+    /** Rank order; higher is more prestigious. Required on create. */
+    level: number;
     minPoints: number;
-    multiplier: number;
-    perks: string[];
+    cashbackPercent: number;
+    benefits: unknown[];
+    icon: string;
+    color: string;
+    createdAt?: string;
 }
+/** Body for creating a loyalty tier. */
+export type LoyaltyTierCreateRequest = Pick<LoyaltyTier, 'name' | 'level' | 'minPoints'> & Partial<Pick<LoyaltyTier, 'cashbackPercent' | 'benefits' | 'icon' | 'color'>>;
+/** Body for updating a loyalty tier: any subset of its editable fields. */
+export type LoyaltyTierUpdateRequest = Partial<Pick<LoyaltyTier, 'name' | 'level' | 'minPoints' | 'cashbackPercent' | 'benefits' | 'icon' | 'color'>>;
 /** Loyalty stats */
 export interface LoyaltyStats {
-    totalMembers: number;
-    totalPointsIssued: number;
+    totalUsers: number;
+    avgPoints: number;
     totalCashbackPaid: number;
-    tierDistribution: Record<string, number>;
+    /** Users active in the last 7 days. */
+    active7d: number;
+    tierDistribution: Array<{
+        name: string;
+        level: number;
+        userCount: number;
+    }>;
 }
 /** Webhook echo entry */
 export interface WebhookEchoEntry {
@@ -565,28 +1042,131 @@ export interface ReconciliationFlag {
     flaggedBy: string;
     createdAt: string;
 }
+/** Reward types an operator can grant or attach to a reward rule. */
+export type GrantableRewardType = 'balance_bonus' | 'balance_boost_percent' | 'purchase_discount_percent' | 'purchase_discount_fixed' | 'profit_split_boost' | 'extended_duration' | 'payout_cap_boost_percent';
 /** Reward rule definition (auto-grants rewards on criteria match) */
 export interface RewardRule {
     id: string;
+    tenantId?: string;
     name: string;
-    triggerType: string;
-    triggerThreshold: number;
-    rewardType: RewardType;
+    description: string | null;
+    /** What triggers the grant: `type` reaching `threshold` (e.g. `{ type: 'active_days', threshold: 30 }`). */
+    criteria: {
+        type: string;
+        threshold: number;
+    };
+    rewardType: GrantableRewardType;
+    /** In EUR for money types, otherwise percent or days. Unlike missions and tournament prizes, which take cents. */
     rewardValue: number;
     applyMode: RewardApplyMode;
-    maxGrantsPerUser: number | null;
+    maxGrantsPerUser: number;
     expiresInDays: number | null;
     enabled: boolean;
     sortOrder: number;
     createdAt: string;
 }
+/** Body for creating an achievement definition. */
+export interface AchievementCreateRequest {
+    /** Unique code within the tenant. */
+    code: string;
+    name: string;
+    description?: string;
+    icon?: string;
+    category?: AchievementCategory;
+    points?: number;
+    /** Unlock criteria, evaluated by the achievement engine. */
+    criteria?: Record<string, unknown>;
+    /** Reward granted on unlock, or null for none. Money values in EUR. */
+    reward?: {
+        type: GrantableRewardType;
+        value: number;
+        applyMode?: RewardApplyMode;
+        expiresInDays?: number | null;
+    } | null;
+}
+export type AchievementCategory = 'general' | 'streak' | 'volume' | 'profit' | 'milestone';
+/** Body for updating an achievement definition. Its code and reward are fixed once created. */
+export type AchievementUpdateRequest = Partial<Pick<AchievementCreateRequest, 'name' | 'description' | 'icon' | 'category' | 'points' | 'criteria'>> & {
+    enabled?: boolean;
+};
+/** Body for updating the widget theme. */
+export interface ThemeUpdateRequest {
+    primaryColor?: string;
+    secondaryColor?: string;
+    fontFamily?: string;
+    /** Absolute URL of the logo image. */
+    logoUrl?: string;
+    /** Text overrides keyed by copy id. */
+    customCopy?: Record<string, unknown>;
+}
+/** Events an operator can switch notifications on or off for. */
+export type NotificationPreferenceEvent = 'bet.validation_result' | 'challenge.activated' | 'challenge.completed' | 'challenge.failed' | 'cooldown.triggered' | 'cooldown.lifted' | 'funded_account.activated' | 'funded_account.payout' | 'funded_account.payout_requested' | 'funded_account.payout_rejected' | 'funded_account.revoked' | 'user.self_excluded' | 'user.self_exclusion_lifted';
+/** Body for updating notification preferences: the events to change, true to notify. */
+export type NotificationPreferencesUpdate = Partial<Record<NotificationPreferenceEvent, boolean>>;
+/** Body for excluding a user. Without expiresAt or durationDays the exclusion is permanent. */
+export interface SelfExclusionRequest {
+    userId: string;
+    reason?: string;
+    /** ISO 8601 end of the exclusion, or null for permanent. Wins over durationDays. */
+    expiresAt?: string | null;
+    /** Exclusion length in days from now; the SDK turns it into expiresAt. */
+    durationDays?: number;
+    /** E.g. a national registry reference. */
+    metadata?: Record<string, unknown>;
+}
+/** Body for creating or updating a reward rule. */
+export interface RewardRuleInput {
+    name?: string;
+    description?: string;
+    criteria?: {
+        type: string;
+        threshold: number;
+    };
+    rewardType?: GrantableRewardType;
+    /** In EUR for money types, otherwise percent or days. */
+    rewardValue?: number;
+    applyMode?: RewardApplyMode;
+    maxGrantsPerUser?: number;
+    expiresInDays?: number | null;
+    sortOrder?: number;
+    /** Update only. */
+    enabled?: boolean;
+    /** @deprecated Use `criteria.type`. Mapped to `criteria` by the SDK. */
+    triggerType?: string;
+    /** @deprecated Use `criteria.threshold`. Mapped to `criteria` by the SDK. */
+    triggerThreshold?: number;
+}
+/** A reward that has been applied, from the grant history. */
+export interface RewardApplication {
+    id: string;
+    tenantId: string;
+    userId: string;
+    rewardId: string;
+    /** What it was applied to (challenge / funded account / purchase). */
+    appliedTo: string;
+    rewardType: string;
+    rewardValue: number;
+    effectDescription: string | null;
+    appliedAt: string;
+    originalType: string;
+    achievementId: string | null;
+    achievementCode: string | null;
+    achievementName: string | null;
+}
 /** Self-exclusion record */
 export interface SelfExclusionRecord {
+    id: string;
+    tenantId: string;
     userId: string;
     reason: string;
+    excludedBy: string | null;
+    /** ISO 8601 */
     excludedAt: string;
+    /** ISO 8601. Null = permanent. */
     expiresAt: string | null;
-    liftedAt: string | null;
+    metadata: Record<string, unknown>;
+    /** ISO 8601 */
+    createdAt: string;
 }
 /** Standard API error response */
 export interface FastError {
@@ -648,4 +1228,5 @@ export interface FastClientConfig {
      */
     dangerouslyAllowBrowser?: boolean;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map