@idosgames/core 0.5.1 → 0.7.0

package/dist/index.d.cts

@@ -45,9 +45,39 @@ declare const ResourceEntryType: {
     readonly Item: "Item";
     readonly VirtualCurrency: "VirtualCurrency";
     readonly CryptoCurrency: "CryptoCurrency";
-    readonly UsdCent: "UsdCent";
+    /** Rewarded-video credit: one verified ad view, spendable in ad-gated actions. */
+    readonly RewardedVideoCredit: "RewardedVideoCredit";
+    /**
+     * Real-money payment in a store. Only `ProductID` is populated — the amount and currency come
+     * from the SKU price tier, not from us. Never a stored resource: the money is paid outside,
+     * and the server settles the receipt before the resource operation runs.
+     */
+    readonly Purchase: "Purchase";
 };
 type ResourceEntryType = (typeof ResourceEntryType)[keyof typeof ResourceEntryType];
+/**
+ * Platform the client runs on. Sent with every request (header `X-IG-Platform`) because the set
+ * of available payment options depends on it: an App Store build must not offer payment outside
+ * IAP. `Unknown` is a value of its own, not a synonym for `Web` — a client that does not report
+ * its platform only gets options that are safe everywhere.
+ */
+declare const ClientPlatform: {
+    readonly Unknown: "Unknown";
+    readonly Web: "Web";
+    readonly Android: "Android";
+    readonly Ios: "Ios";
+};
+type ClientPlatform = (typeof ClientPlatform)[keyof typeof ClientPlatform];
+/** Store that issued a receipt. Must match a key in the title's `Purchase.Stores`. */
+declare const IapStore$1: {
+    readonly GooglePlay: "GooglePlay";
+    readonly AppleAppStore: "AppleAppStore";
+};
+type IapStore$1 = (typeof IapStore$1)[keyof typeof IapStore$1];
+declare const zIapStore: z.ZodEnum<{
+    GooglePlay: "GooglePlay";
+    AppleAppStore: "AppleAppStore";
+}>;
 declare const EventTokenType: {
     readonly TimedEvent: "TimedEvent";
     readonly Quest: "Quest";
@@ -208,6 +238,9 @@ interface UserEventTokensState {
     CoopEvent?: Record<string, UserEventTokenProgress>;
     Season?: Record<string, UserEventTokenProgress>;
 }
+type PriceOption = { OptionID?: null | string; Name?: null | string; Cost?: null | ResourceConsume; AllowedPlatforms?: null | Array<'Unknown' | 'Web' | 'Android' | 'Ios'>; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
+type PriceOptions = Record<string, PriceOption>;
+type PaymentProof = { Store: 'GooglePlay' | 'AppleAppStore'; Receipt: string; Signature?: null | string; [key: string]: unknown; };
 
 interface StorePurchaseState {
     OfferID: string;
@@ -222,7 +255,7 @@ interface UserStoreState {
 type StorePurchaseResponse = { ServerTimeUtc: string; OfferID: string; Count: number; Resources?: null | ResourceOperation; };
 type PurchaseBatchResponse = Array<{ Id: string; Success: boolean; Error?: null | string; Data?: null | StorePurchaseResponse; }>;
 type StoreDefinition = { StoreID: string; Type?: null | string; Name?: null | string; Description?: null | string; Rules?: null | { StartUtc?: null | string; EndUtc?: null | string; RequiredFlags?: null | Array<string>; [key: string]: unknown; }; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
-type StoreOfferDefinition = { OfferID: string; StoreIDs?: null | Array<string>; Name?: null | string; Cost?: null | ResourceConsume; Rewards?: null | ResourceGrant; Rules?: null | { StartUtc?: null | string; EndUtc?: null | string; Gate?: null | SegmentGate; Limits?: null | LimitSpec; [key: string]: unknown; }; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
+type StoreOfferDefinition = { OfferID: string; StoreIDs?: null | Array<string>; Name?: null | string; PriceOptions?: null | PriceOptions; Rewards?: null | ResourceGrant; Rules?: null | { StartUtc?: null | string; EndUtc?: null | string; Gate?: null | SegmentGate; Limits?: null | LimitSpec; [key: string]: unknown; }; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
 /** The title's shop system (config), returned by getStoreDefinitions(). */
 interface StoreDefinitions {
     Stores?: Record<string, StoreDefinition> | null;
@@ -232,10 +265,19 @@ interface StoreDefinitions {
 interface StorePurchaseRef {
     OfferID?: string;
     Count?: number;
+    /** Chosen payment option. Empty = first one available on this platform. */
+    SelectedOptionID?: string;
 }
 interface StoreRequest extends BaseRequest {
     OfferID?: string;
     Count?: number;
+    /** Chosen payment option (`PriceOption.OptionID`). Empty = first one available here. */
+    SelectedOptionID?: string;
+    /**
+     * Store receipt. Required exactly when the chosen option is paid with real money
+     * (a `Purchase` entry in its cost); ignored for resource prices.
+     */
+    Payment?: PaymentProof;
     /** PurchaseBatch: per-offer purchase counts (deduped by OfferID). */
     Purchases?: StorePurchaseRef[];
 }
@@ -292,7 +334,8 @@ interface UserLootboxState {
     Pity?: Record<string, UserLootboxPityCounter>;
 }
 type LootboxPityTriggerResponse = { RuleID: string; BoxIndex?: null | number; };
-type LootboxOpenResponse = { ServerTimeUtc: string; LootboxID: string; OpenedCount?: null | number; SelectedOptionID?: null | number; Resources?: null | ResourceOperation; Inventory?: null | InventoryDelta; Results?: null | Array<ResourceOperation>; TriggeredPity?: null | Array<LootboxPityTriggerResponse>; };
+type LootboxOpenResponse = { ServerTimeUtc: string; LootboxID: string; OpenedCount?: null | number; SelectedOptionID?: null | string; Resources?: null | ResourceOperation; Inventory?: null | InventoryDelta; Results?: null | Array<ResourceOperation>; TriggeredPity?: null | Array<LootboxPityTriggerResponse>; };
+/** One opening price option: an idempotent option ID and its consume-only cost. */
 /**
  * Container of preset wiring for a lootbox — one PresetBinding per block. Inline data
  * (RewardSlots/PityRules) lives on LootboxDefinition. null = presets unused.
@@ -302,17 +345,30 @@ interface LootboxPresetBindings {
     PityRules?: PresetBinding | null;
 }
 type LootboxSupplyRule = { CatalogID?: null | string; ItemID?: null | string; MaxDrops?: null | number; [key: string]: unknown; };
-type LootboxDefinition = { LootboxID: string; AssetPaths?: null | Record<string, string>; PriceOptions?: null | Record<string, { PriceOptionID?: null | number; RequiredResources?: null | ResourceConsume; [key: string]: unknown; }>; RewardSlots?: null | Array<LootboxRewardSlot>; PityRules?: null | Array<LootboxPityRule>; Presets?: null | LootboxPresetBindings; RewardMultiplier?: null | RewardProgressionMultiplierSpec; SupplyLimits?: null | Array<LootboxSupplyRule>; [key: string]: unknown; };
+type LootboxDefinition = { LootboxID: string; AssetPaths?: null | Record<string, string>; PriceOptions?: null | PriceOptions; RewardSlots?: null | Array<LootboxRewardSlot>; PityRules?: null | Array<LootboxPityRule>; Presets?: null | LootboxPresetBindings; RewardMultiplier?: null | RewardProgressionMultiplierSpec; SupplyLimits?: null | Array<LootboxSupplyRule>; MaxOpenCount?: null | number; [key: string]: unknown; };
 /** The title's lootbox catalog (config), returned by getDefinitions(). */
+/** Module-wide Lootbox settings shared by every lootbox of the title. */
+interface LootboxGlobalSettings {
+    /**
+     * Max boxes per single open() call for every lootbox of the title. Overridden per lootbox via
+     * LootboxDefinition.MaxOpenCount. null = platform default (100). <= 0 = opening disabled.
+     */
+    MaxOpenCount?: number | null;
+}
 interface LootboxDefinitions {
     Definitions?: Record<string, LootboxDefinition> | null;
+    /** Module-wide settings (e.g. the max-open ceiling). null = platform defaults apply. */
+    Settings?: LootboxGlobalSettings | null;
     RewardPools?: RewardPoolLibrary | null;
 }
 type LootboxDefinitionsResponse = { LootboxDefinitions?: null | LootboxDefinitions; };
 interface LootboxRequest extends BaseRequest {
     LootboxID?: string;
     Count?: number;
-    SelectedOptionID?: number;
+    /** Chosen payment option. Empty = first one available on this platform. */
+    SelectedOptionID?: string;
+    /** Store receipt — required when the chosen option is paid with real money. */
+    Payment?: PaymentProof;
 }
 declare const LootboxAction: {
     readonly GetDefinitions: "GetDefinitions";
@@ -394,7 +450,15 @@ declare const RewardAction: {
 };
 type RewardAction = (typeof RewardAction)[keyof typeof RewardAction];
 type ExperimentVariantCondition = { ExperimentID?: null | string; Variants?: null | Array<string>; [key: string]: unknown; };
-type SegmentGate = { Segments?: null | Array<string>; MinPremiumTier?: null | number; RequiredPremiumIDs?: null | Array<string>; MinLevel?: null | number; MaxLevel?: null | number; Countries?: null | Array<string>; RegisteredWithinDays?: null | number; ActiveWithinDays?: null | number; Experiment?: null | ExperimentVariantCondition; [key: string]: unknown; };
+/** What a TutorialGateCondition checks about the player's onboarding progress. */
+declare const TutorialGateMode: {
+    readonly Completed: "Completed";
+    readonly Started: "Started";
+    readonly StepReached: "StepReached";
+};
+type TutorialGateMode = (typeof TutorialGateMode)[keyof typeof TutorialGateMode];
+type TutorialGateCondition = { FlowIDs?: null | Array<string>; Mode?: null | 'Completed' | 'Started' | 'StepReached'; StepID?: null | string; Negate?: null | boolean; SkippedCountsAsCompleted?: null | boolean; [key: string]: unknown; };
+type SegmentGate = { Segments?: null | Array<string>; MinPremiumTier?: null | number; RequiredPremiumIDs?: null | Array<string>; MinLevel?: null | number; MaxLevel?: null | number; Countries?: null | Array<string>; RegisteredWithinDays?: null | number; ActiveWithinDays?: null | number; Experiment?: null | ExperimentVariantCondition; Tutorial?: null | TutorialGateCondition; Platforms?: null | Array<'Unknown' | 'Web' | 'Android' | 'Ios'>; [key: string]: unknown; };
 type RelativeWindow = { OffsetSecondsFromParentStart?: null | number; DurationSeconds?: null | number; AllowEarningAfterEnd?: null | boolean; ClaimGraceHours?: null | number; [key: string]: unknown; };
 type ScheduledWindow = { StartUtc?: null | string; EndUtc?: null | string; AllowEarningAfterEnd?: null | boolean; ClaimGraceHours?: null | number; [key: string]: unknown; };
 type ScheduleChain = { AnchorUtc?: null | string; MaxCycles?: null | number; PauseBetweenPhasesSec?: null | number; PauseBetweenCyclesSec?: null | number; [key: string]: unknown; };
@@ -530,7 +594,117 @@ declare const QuestAction: {
     readonly ClaimGroupCompletionReward: "ClaimGroupCompletionReward";
 };
 type QuestAction = (typeof QuestAction)[keyof typeof QuestAction];
-type ResourceEntry = { Type?: null | 'Item' | 'VirtualCurrency' | 'CryptoCurrency' | 'UsdCent'; CurrencyID?: null | string; Amount?: null | number; CatalogID?: null | string; ItemID?: null | string; };
+
+declare const TutorialStepCompletionMode: {
+    /** The client calls completeStep itself ("the player tapped Next"). Default. */
+    readonly ClientAck: "ClientAck";
+    /** An engine game event closes it — the client only reports it was shown. */
+    readonly SystemEvent: "SystemEvent";
+    /** Closes on being shown (reportStepShown) — an informational aside. */
+    readonly Auto: "Auto";
+    /** Several triggers with an explicit all/any rule. */
+    readonly Composite: "Composite";
+};
+type TutorialStepCompletionMode = (typeof TutorialStepCompletionMode)[keyof typeof TutorialStepCompletionMode];
+declare const TutorialRestartPolicy: {
+    readonly Never: "Never";
+    readonly OnRequest: "OnRequest";
+    readonly Always: "Always";
+};
+type TutorialRestartPolicy = (typeof TutorialRestartPolicy)[keyof typeof TutorialRestartPolicy];
+declare const TutorialFlowStatus: {
+    readonly NotStarted: "NotStarted";
+    readonly InProgress: "InProgress";
+    readonly Completed: "Completed";
+    readonly Skipped: "Skipped";
+    /** Expired per Policy.ExpireAfterSeconds without being completed. */
+    readonly Expired: "Expired";
+};
+type TutorialFlowStatus = (typeof TutorialFlowStatus)[keyof typeof TutorialFlowStatus];
+declare const TutorialScriptModule: {
+    readonly GameLoop: "GameLoop";
+};
+type TutorialScriptModule = (typeof TutorialScriptModule)[keyof typeof TutorialScriptModule];
+declare const TutorialBoardAction: {
+    readonly Raid: "Raid";
+    readonly Attack: "Attack";
+};
+type TutorialBoardAction = (typeof TutorialBoardAction)[keyof typeof TutorialBoardAction];
+type TutorialStepIdentity = { Title?: null | string; TitleKey?: null | string; Body?: null | string; BodyKey?: null | string; AnchorID?: null | string; HighlightTarget?: null | string; AssetPaths?: null | Record<string, string>; UiHint?: null | Record<string, string>; [key: string]: unknown; };
+type TutorialStepCompletion = { Mode?: null | 'SystemEvent' | 'ClientAck' | 'Auto' | 'Composite'; Triggers?: null | Array<TriggerSource>; TargetValue?: null | number; RequireAllTriggers?: null | boolean; [key: string]: unknown; };
+type TutorialStepEffects = { Grant?: null | ResourceGrant; UnlockFeatures?: null | Array<string>; [key: string]: unknown; };
+type TutorialBoardScript = { TileType?: null | string; TileIndex?: null | number; ChanceOutcomeID?: null | string; RandomActionType?: null | 'Raid' | 'Attack'; [key: string]: unknown; };
+type TutorialScriptedOutcome = { Module?: null | 'GameLoop'; Board?: null | TutorialBoardScript; MaxUses?: null | number; [key: string]: unknown; };
+type TutorialStepPolicy = { Skippable?: null | boolean; TimeoutSeconds?: null | number; [key: string]: unknown; };
+type TutorialStepDefinition = { StepID?: null | string; Order?: null | number; Identity?: null | TutorialStepIdentity; Completion?: null | TutorialStepCompletion; Effects?: null | TutorialStepEffects; Script?: null | TutorialScriptedOutcome; Policy?: null | TutorialStepPolicy; [key: string]: unknown; };
+type TutorialIdentity = { DisplayName?: null | string; DisplayNameKey?: null | string; Description?: null | string; DescriptionKey?: null | string; SortOrder?: null | number; AssetPaths?: null | Record<string, string>; CustomParams?: null | Record<string, string>; [key: string]: unknown; };
+type TutorialAvailability = { Schedule?: null | ScheduleSpec; Gate?: null | SegmentGate; RequiredFlowIDs?: null | Array<string>; AutoStart?: null | boolean; StartTrigger?: null | TriggerSource; [key: string]: unknown; };
+type TutorialFlowPolicy = { Skippable?: null | boolean; SkippableFromOrder?: null | number; RestartPolicy?: null | 'Never' | 'OnRequest' | 'Always'; ExpireAfterSeconds?: null | number; IsBlocking?: null | boolean; UnlockFeatures?: null | Array<string>; [key: string]: unknown; };
+type TutorialReward = { Grant?: null | ResourceGrant; AutoClaim?: null | boolean; [key: string]: unknown; };
+type TutorialPresetBindings = { Availability?: null | PresetBinding; Policy?: null | PresetBinding; Reward?: null | PresetBinding; Steps?: null | PresetBinding; [key: string]: unknown; };
+type TutorialFlowDefinition = { FlowID?: null | string; Identity?: null | TutorialIdentity; Availability?: null | TutorialAvailability; Policy?: null | TutorialFlowPolicy; Steps?: null | Record<string, TutorialStepDefinition>; Reward?: null | TutorialReward; Presets?: null | TutorialPresetBindings; [key: string]: unknown; };
+type TutorialBlockingPolicy = { BlockingFlowIDs?: null | Array<string>; BlockedModules?: null | Array<string>; BlockedActions?: null | Record<string, Array<string>>; BlockBeforeStart?: null | boolean; SkipLiftsBlock?: null | boolean; [key: string]: unknown; };
+type TutorialGlobalSettings = { IsEnabled?: null | boolean; MaxActiveFlows?: null | number; Blocking?: null | TutorialBlockingPolicy; [key: string]: unknown; };
+type TutorialPresetRegistry = { Availability?: null | Record<string, TutorialAvailability>; Policy?: null | Record<string, TutorialFlowPolicy>; Reward?: null | Record<string, TutorialReward>; Steps?: null | Record<string, Record<string, TutorialStepDefinition>>; [key: string]: unknown; };
+type TutorialDefinitions = { Flows?: null | Record<string, TutorialFlowDefinition>; Settings?: null | TutorialGlobalSettings; Presets?: null | TutorialPresetRegistry; [key: string]: unknown; };
+interface UserTutorialStepState {
+    StepID?: string;
+    Progress?: number;
+    FiredTriggers?: number[];
+    ShownAtUtc?: string;
+    CompletedAtUtc?: string;
+    Skipped?: boolean;
+    ScriptUses?: number;
+}
+interface UserTutorialFlowState {
+    FlowID?: string;
+    Status?: TutorialFlowStatus;
+    CurrentStepID?: string | null;
+    StartedAtUtc?: string;
+    FinishedAtUtc?: string;
+    Steps?: Record<string, UserTutorialStepState>;
+    RestartCount?: number;
+    RewardClaimed?: boolean;
+    /**
+     * Experiment and variant captured when the flow STARTED. Not a duplicate of the live
+     * assignment: changing the experiment salt reassigns the player, and without the snapshot the
+     * funnel would attribute the run to a variant they never saw.
+     */
+    ExperimentID?: string | null;
+    VariantID?: string | null;
+}
+interface UserTutorialState {
+    Flows?: Record<string, UserTutorialFlowState>;
+    LastUpdatedUtc?: string;
+}
+type TutorialFlowView = { FlowID: string; Status: 'Completed' | 'Expired' | 'NotStarted' | 'InProgress' | 'Skipped'; TotalSteps: number; CompletedSteps: number; CanSkip: boolean; RewardClaimed: boolean; RewardPending: boolean; CurrentStepID?: null | string; CurrentStep?: null | TutorialStepDefinition; VariantID?: null | string; [key: string]: unknown; };
+type GetUserTutorialStateResponse = { State?: null | UserTutorialState; Flows?: null | Array<TutorialFlowView>; UnlockedFeatures?: null | Array<string>; [key: string]: unknown; };
+type TutorialFlowResponse = { Flow?: null | TutorialFlowView; [key: string]: unknown; };
+type TutorialClaimResponse = { FlowID?: null | string; Granted?: null | ResourceOperation; [key: string]: unknown; };
+type TutorialFlowBatchResponse = Array<{ Id: string; Success: boolean; Error?: null | string; Data?: null | TutorialFlowResponse; }>;
+type TutorialStepProgress = { FlowID: string; StepID: string; Progress: number; Target: number; Completed: boolean; [key: string]: unknown; };
+interface TutorialRequest extends BaseRequest {
+    FlowID?: string;
+    StepID?: string;
+    /** CompleteStepsBatch: steps to close, in order. Deduped by StepID. */
+    StepIDs?: string[];
+    /** Allow auto-start while reading state. Default true. */
+    AutoStart?: boolean;
+}
+declare const TutorialAction: {
+    readonly GetTutorialDefinitions: "GetTutorialDefinitions";
+    readonly GetUserTutorialState: "GetUserTutorialState";
+    readonly StartFlow: "StartFlow";
+    readonly ReportStepShown: "ReportStepShown";
+    readonly CompleteStep: "CompleteStep";
+    readonly CompleteStepsBatch: "CompleteStepsBatch";
+    readonly SkipStep: "SkipStep";
+    readonly SkipFlow: "SkipFlow";
+    readonly ClaimFlowReward: "ClaimFlowReward";
+    readonly ResetFlow: "ResetFlow";
+};
+type TutorialAction = (typeof TutorialAction)[keyof typeof TutorialAction];
+type ResourceEntry = { Type?: null | 'Item' | 'VirtualCurrency' | 'CryptoCurrency' | 'RewardedVideoCredit' | 'Purchase'; CurrencyID?: null | string; Amount?: null | number; CatalogID?: null | string; ItemID?: null | string; ProductID?: null | string; };
 type EventTokenAddress = { EntityID: string; Type?: null | 'TimedEvent' | 'Quest' | 'Leaderboard' | 'CoopEvent' | 'Season'; };
 type EventTokenOperation = { Address?: null | EventTokenAddress; Amount?: null | number; Source?: null | string; };
 type ResourceBundle = { Entries?: null | Array<ResourceEntry>; EventTokens?: null | Array<EventTokenOperation>; };
@@ -704,6 +878,7 @@ type UserSeasonStateResponse = UserSeasonState;
 type ActiveSeasonInfo = { SeasonChainID: string; CycleIndex?: null | number; Season?: null | { SeasonID?: null | string; Order?: null | number; DurationSec?: null | number; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; Tiers?: null | Array<{ Tier?: null | number; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; RequiredTokens?: null | number; TierReachedReward?: null | ResourceGrant; [key: string]: unknown; }>; LinkedCollectionID?: null | string; CustomParams?: null | Record<string, string>; [key: string]: unknown; }; ComputedStartUtc?: null | string; ComputedEndUtc?: null | string; SecondsRemaining?: null | number; UserState?: null | UserSeasonState; NextTier?: null | { Tier?: null | number; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; RequiredTokens?: null | number; TierReachedReward?: null | ResourceGrant; [key: string]: unknown; }; [key: string]: unknown; };
 type GrantStatusTokensResponse = { SeasonChainID: string; NewTier: number; CurrentSeasonID?: null | string; AmountGranted?: null | number; NewStatusTokens?: null | number; OldTier?: null | number; TierUp?: null | boolean; };
 type ClaimTierRewardResponse = { SeasonChainID: string; TierNumber: number; CurrentSeasonID?: null | string; Resources?: null | ResourceOperation; };
+type ClaimTierRewardsBatchResponse = { ServerTimeUtc: string; Items: Array<{ Id: string; Success: boolean; Error?: null | string; Data?: null | ClaimTierRewardResponse; }>; Resources?: null | ResourceOperation; };
 type SeasonChainDefinition = { SeasonChainID?: null | string; DisplayName?: null | string; Schedule?: null | ScheduleSpec; Seasons?: null | Array<{ SeasonID?: null | string; Order?: null | number; DurationSec?: null | number; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; Tiers?: null | Array<{ Tier?: null | number; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; RequiredTokens?: null | number; TierReachedReward?: null | ResourceGrant; [key: string]: unknown; }>; LinkedCollectionID?: null | string; CustomParams?: null | Record<string, string>; [key: string]: unknown; }>; GrantTokensAccessMode?: null | string; Gate?: null | SegmentGate; [key: string]: unknown; };
 /** Root configuration of the title's season system, returned by getDefinitions(). */
 interface SeasonDefinitions {
@@ -713,6 +888,12 @@ interface SeasonRequest extends BaseRequest {
     SeasonChainID?: string;
     Amount?: number;
     TierNumber?: number;
+    /**
+     * ClaimTierRewardsBatch: tier numbers to claim. Non-positive entries are dropped, the rest is
+     * deduped keeping order and clamped to the platform batch size. Needed because tiers are
+     * reached in batches — one token grant can raise the player through several at once.
+     */
+    TierNumbers?: number[];
 }
 declare const SeasonAction: {
     readonly GetDefinitions: "GetDefinitions";
@@ -720,6 +901,7 @@ declare const SeasonAction: {
     readonly GetUserState: "GetUserState";
     readonly GrantStatusTokens: "GrantStatusTokens";
     readonly ClaimTierReward: "ClaimTierReward";
+    readonly ClaimTierRewardsBatch: "ClaimTierRewardsBatch";
 };
 type SeasonAction = (typeof SeasonAction)[keyof typeof SeasonAction];
 
@@ -740,7 +922,7 @@ interface UserPremiumState {
     ActivatedTrialIDs?: string[];
     MaxActiveTier?: number;
 }
-type PremiumDefinition = { PremiumID?: null | string; DisplayName?: null | string; Tier?: null | number; DurationDays?: null | number; TrialDurationDays?: null | number; PriceOptions?: null | Record<string, { OptionID?: null | string; Name?: null | string; RequiredResources?: null | ResourceConsume; [key: string]: unknown; }>; AppleProductID?: null | string; GoogleProductID?: null | string; Benefits?: null | Record<string, string>; [key: string]: unknown; };
+type PremiumDefinition = { PremiumID?: null | string; DisplayName?: null | string; Tier?: null | number; DurationDays?: null | number; TrialDurationDays?: null | number; PriceOptions?: null | PriceOptions; AppleProductID?: null | string; GoogleProductID?: null | string; Benefits?: null | Record<string, string>; [key: string]: unknown; };
 interface PremiumDefinitions {
     Definitions?: Record<string, PremiumDefinition> | null;
 }
@@ -790,13 +972,13 @@ type UnlockCharactersBatchResponse = { ServerTimeUtc: string; Items: Array<{ Id:
 type UpgradeCharacterLevelsBatchResponse = { ServerTimeUtc: string; Items: Array<{ Id: string; Success: boolean; Error?: null | string; Data?: null | UpgradeCharacterLevelResponse; }>; Resources?: null | ResourceOperation; };
 type UpgradeStatLevelsBatchResponse = { ServerTimeUtc: string; Items: Array<{ Id: string; Success: boolean; Error?: null | string; Data?: null | UpgradeStatLevelResponse; }>; Resources?: null | ResourceOperation; };
 type StatRequirement = { RequiredStatID: string; RequiredLevel: number; [key: string]: unknown; };
-type StatDefinition = { StatID: string; TypeID?: null | string; DisplayName?: null | string; Description?: null | string; MaxLevel?: null | number; Weight?: null | number; BaseCostResource?: null | ResourceConsume; CostScalingFactor?: null | number; BaseStatValue?: null | number; StatScalingFactor?: null | number; CharacterLevelScalingFactor?: null | number; Requirements?: null | Array<StatRequirement>; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
-type CharacterLevelDefinition = { Level?: null | number; UpgradeCost?: null | ResourceConsume; GlobalStatMultiplier?: null | number; StatMaxLevelMultiplier?: null | number; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
+type StatDefinition = { StatID: string; TypeID?: null | string; DisplayName?: null | string; Description?: null | string; MaxLevel?: null | number; Weight?: null | number; PriceOptions?: null | PriceOptions; CostScalingFactor?: null | number; BaseStatValue?: null | number; StatScalingFactor?: null | number; CharacterLevelScalingFactor?: null | number; Requirements?: null | Array<StatRequirement>; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
+type CharacterLevelDefinition = { Level?: null | number; PriceOptions?: null | PriceOptions; GlobalStatMultiplier?: null | number; StatMaxLevelMultiplier?: null | number; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
 type CharacterEquipmentSlot = { SlotID: string; MinCharacterLevel?: null | number; StatRequirements?: null | Array<StatRequirement>; AllowedRarityIDs?: null | Array<string>; AllowedItemTags?: null | Array<string>; MinItemLevel?: null | number; MaxItemLevel?: null | number; [key: string]: unknown; };
 type CharacterEquipment = { Slots?: null | Record<string, CharacterEquipmentSlot>; [key: string]: unknown; };
 type CharacterIdentity = { DisplayName?: null | string; Description?: null | string; Lore?: null | string; SortOrder?: null | number; AssetPaths?: null | Record<string, string>; [key: string]: unknown; };
 type CharacterClassification = { ClassID?: null | string; RarityID?: null | string; Tags?: null | Array<string>; [key: string]: unknown; };
-type CharacterUnlock = { UnlockedByDefault?: null | boolean; Cost?: null | ResourceConsume; [key: string]: unknown; };
+type CharacterUnlock = { UnlockedByDefault?: null | boolean; PriceOptions?: null | PriceOptions; [key: string]: unknown; };
 type CharacterDefinition = { CharacterID: string; Identity?: null | CharacterIdentity; Classification?: null | CharacterClassification; Unlock?: null | CharacterUnlock; Presets?: null | { Stats?: null | PresetBinding; Levels?: null | PresetBinding; Equipment?: null | PresetBinding; [key: string]: unknown; }; Equipment?: null | CharacterEquipment; Stats?: null | Record<string, StatDefinition>; Levels?: null | Record<string, CharacterLevelDefinition>; [key: string]: unknown; };
 type StatsPreset = { Stats?: null | Record<string, StatDefinition>; [key: string]: unknown; };
 type LevelsPreset = { Levels?: null | Record<string, CharacterLevelDefinition>; [key: string]: unknown; };
@@ -839,6 +1021,13 @@ interface CharacterStatRef {
 }
 interface CharacterRequest extends BaseRequest {
     CharacterID?: string;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which is what keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
+    /** Store receipt. Required exactly when the chosen option is paid in a store. */
+    Payment?: PaymentProof;
     StatID?: string;
     ItemsToEquip?: EquipSlotPair[];
     UnequipSlotIDs?: string[];
@@ -891,14 +1080,19 @@ interface UserMatchState {
     CreationLimits?: UserMatchCreationLimitState | null;
 }
 type BattleResult = { WinnerUserID?: null | string; LoserUserID?: null | string; Entry?: null | ResourceBundle; NetReward?: null | ResourceBundle; BattleLog?: null | Array<{ RoundIndex?: null | number; AttackerID?: null | string; DefenderID?: null | string; AttackZone?: null | 'Head' | 'Torso' | 'Legs'; DefenseZone?: null | 'Head' | 'Torso' | 'Legs'; HitType?: null | 'Hit' | 'Critical' | 'Block' | 'Dodge'; DamageDealt?: null | number; DefenderHpRemaining?: null | number; [key: string]: unknown; }>; IsDraw?: null | boolean; P1BattleProfile?: null | { UserID?: null | string; SelectedCharacterID?: null | string; SelectedCharacter?: null | CharacterModel; BattleStrategy?: null | Array<BattleStepConfig>; UnstackableItems?: null | Record<string, UnstackableItemInstanceState>; Stats?: null | { MaxHp?: null | number; CurrentHp?: null | number; Damage?: null | number; AttackSpeed?: null | number; CritChance?: null | number; CritMultiplier?: null | number; Armor?: null | number; DodgeChance?: null | number; [key: string]: unknown; }; [key: string]: unknown; }; P2BattleProfile?: null | { UserID?: null | string; SelectedCharacterID?: null | string; SelectedCharacter?: null | CharacterModel; BattleStrategy?: null | Array<BattleStepConfig>; UnstackableItems?: null | Record<string, UnstackableItemInstanceState>; Stats?: null | { MaxHp?: null | number; CurrentHp?: null | number; Damage?: null | number; AttackSpeed?: null | number; CritChance?: null | number; CritMultiplier?: null | number; Armor?: null | number; DodgeChance?: null | number; [key: string]: unknown; }; [key: string]: unknown; }; [key: string]: unknown; };
-type PvPMatch = { MatchID: string; TitleID?: null | string; RuleID?: null | string; CreatedAt?: null | string; CreatorID?: null | string; CreatorCharacterID?: null | string; CreatorStrategy?: null | Array<BattleStepConfig>; TargetUserID?: null | string; Entry?: null | ResourceBundle; CreationCostPaid?: null | ResourceBundle; RefundCreationCostOnCancel?: null | boolean; JoinedByUserID?: null | string; JoinedByCharacterID?: null | string; JoinedAt?: null | string; Status?: null | 'Completed' | 'Open' | 'InProgress' | 'Cancelled'; WinnerUserID?: null | string; CompletedAt?: null | string; IsRewardDistributed?: null | boolean; RewardDistributedAt?: null | string; [key: string]: unknown; };
-type CreateMatchResponse = { Status: 'Completed' | 'Open' | 'InProgress' | 'Cancelled'; MatchID: string; Entry?: null | ResourceBundle; Resources?: null | ResourceOperation; };
+type PvPMatch = { MatchID: string; TitleID?: null | string; RuleID?: null | string; CreatedAt?: null | string; CreatorID?: null | string; CreatorCharacterID?: null | string; CreatorStrategy?: null | Array<BattleStepConfig>; TargetUserID?: null | string; Entry?: null | ResourceBundle; CreationCostPaid?: null | ResourceBundle; RefundCreationCostOnCancel?: null | boolean; JoinedByUserID?: null | string; JoinedByCharacterID?: null | string; JoinedAt?: null | string; Status?: null | 'Completed' | 'InProgress' | 'Open' | 'Cancelled'; WinnerUserID?: null | string; CompletedAt?: null | string; IsRewardDistributed?: null | boolean; RewardDistributedAt?: null | string; [key: string]: unknown; };
+type CreateMatchResponse = { Status: 'Completed' | 'InProgress' | 'Open' | 'Cancelled'; MatchID: string; Entry?: null | ResourceBundle; Resources?: null | ResourceOperation; };
 type UpdateMatchResponse = { Match?: null | PvPMatch; };
-type CancelMatchResponse = { MatchID: string; Status: 'Completed' | 'Open' | 'InProgress' | 'Cancelled'; Resources?: null | ResourceOperation; };
+type CancelMatchResponse = { MatchID: string; Status: 'Completed' | 'InProgress' | 'Open' | 'Cancelled'; Resources?: null | ResourceOperation; };
 type InstantBattleResponse = { Battle?: null | BattleResult; Resources?: null | ResourceOperation; ResourcesDual?: null | ResourceDualPartyResult; };
 type MatchesPageResponse = { Matches?: null | Array<PvPMatch>; Page?: null | number; PageSize?: null | number; HasMore?: null | boolean; };
 interface MatchRequest extends BaseRequest {
     MatchID?: string;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
     TargetUserID?: string;
     /** Entry stake for one side (currencies / stackable items / event tokens). */
     Entry?: ResourceBundle;
@@ -926,7 +1120,7 @@ type MatchAction = (typeof MatchAction)[keyof typeof MatchAction];
 type InstantBattleSettings = { StatMapping?: null | { HealthStatID?: null | string; DamageStatID?: null | string; ArmorStatID?: null | string; AttackSpeedStatID?: null | string; CritChanceStatID?: null | string; CritDamageStatID?: null | string; DodgeStatID?: null | string; AllMightStatID?: null | string; [key: string]: unknown; }; Combat?: null | { MaxRounds?: null | number; BlockDamageMultiplier?: null | number; MinHitDamage?: null | number; DefaultCritMultiplier?: null | number; MaxCritChance?: null | number; MaxDodgeChance?: null | number; [key: string]: unknown; }; Formula?: null | { Health?: null | { Terms?: null | Array<{ Coefficient?: null | number; Factors?: null | Array<{ Source?: null | 'Constant' | 'Stat' | 'RankMultiplier' | 'AllMight' | 'GearFlat' | 'GearPercent'; StatID?: null | string; Value?: null | number; OnePlus?: null | boolean; [key: string]: unknown; }>; [key: string]: unknown; }>; [key: string]: unknown; }; Damage?: null | { Terms?: null | Array<{ Coefficient?: null | number; Factors?: null | Array<{ Source?: null | 'Constant' | 'Stat' | 'RankMultiplier' | 'AllMight' | 'GearFlat' | 'GearPercent'; StatID?: null | string; Value?: null | number; OnePlus?: null | boolean; [key: string]: unknown; }>; [key: string]: unknown; }>; [key: string]: unknown; }; Armor?: null | { Terms?: null | Array<{ Coefficient?: null | number; Factors?: null | Array<{ Source?: null | 'Constant' | 'Stat' | 'RankMultiplier' | 'AllMight' | 'GearFlat' | 'GearPercent'; StatID?: null | string; Value?: null | number; OnePlus?: null | boolean; [key: string]: unknown; }>; [key: string]: unknown; }>; [key: string]: unknown; }; AttackSpeed?: null | { Terms?: null | Array<{ Coefficient?: null | number; Factors?: null | Array<{ Source?: null | 'Constant' | 'Stat' | 'RankMultiplier' | 'AllMight' | 'GearFlat' | 'GearPercent'; StatID?: null | string; Value?: null | number; OnePlus?: null | boolean; [key: string]: unknown; }>; [key: string]: unknown; }>; [key: string]: unknown; }; CritChance?: null | { Terms?: null | Array<{ Coefficient?: null | number; Factors?: null | Array<{ Source?: null | 'Constant' | 'Stat' | 'RankMultiplier' | 'AllMight' | 'GearFlat' | 'GearPercent'; StatID?: null | string; Value?: null | number; OnePlus?: null | boolean; [key: string]: unknown; }>; [key: string]: unknown; }>; [key: string]: unknown; }; CritDamage?: null | { Terms?: null | Array<{ Coefficient?: null | number; Factors?: null | Array<{ Source?: null | 'Constant' | 'Stat' | 'RankMultiplier' | 'AllMight' | 'GearFlat' | 'GearPercent'; StatID?: null | string; Value?: null | number; OnePlus?: null | boolean; [key: string]: unknown; }>; [key: string]: unknown; }>; [key: string]: unknown; }; Dodge?: null | { Terms?: null | Array<{ Coefficient?: null | number; Factors?: null | Array<{ Source?: null | 'Constant' | 'Stat' | 'RankMultiplier' | 'AllMight' | 'GearFlat' | 'GearPercent'; StatID?: null | string; Value?: null | number; OnePlus?: null | boolean; [key: string]: unknown; }>; [key: string]: unknown; }>; [key: string]: unknown; }; [key: string]: unknown; }; [key: string]: unknown; };
 type MatchEconomySettings = { BurnRate?: null | number; [key: string]: unknown; };
 type MatchEntrySettings = { AllowVirtualCurrency?: null | boolean; AllowItems?: null | boolean; AllowEventTokens?: null | boolean; Allowed?: null | Array<{ Kind?: null | 'Item' | 'VirtualCurrency' | 'EventToken'; CurrencyID?: null | string; CatalogID?: null | string; ItemID?: null | string; TokenType?: null | 'TimedEvent' | 'Quest' | 'Leaderboard' | 'CoopEvent' | 'Season'; EntityID?: null | string; MinAmount?: null | number; MaxAmount?: null | number; [key: string]: unknown; }>; MaxPositions?: null | number; [key: string]: unknown; };
-type MatchCreationSettings = { Cost?: null | ResourceConsume; RefundCostOnCancel?: null | boolean; MaxOpenMatches?: null | number; Limits?: null | LimitSpec; AllowPrivateMatches?: null | boolean; MaxMatchesPerOpponentPerDay?: null | number; [key: string]: unknown; };
+type MatchCreationSettings = { PriceOptions?: null | PriceOptions; RefundCostOnCancel?: null | boolean; MaxOpenMatches?: null | number; Limits?: null | LimitSpec; AllowPrivateMatches?: null | boolean; MaxMatchesPerOpponentPerDay?: null | number; [key: string]: unknown; };
 /** One instant-battle rule, keyed by RuleID in InstantBattleDefinitions.Rules. */
 interface InstantBattleRule {
     RuleID?: string | null;
@@ -981,8 +1175,9 @@ interface UserCollectionState {
     [key: string]: unknown;
 }
 type GrantedCollectible = { CollectibleID: string; Rarity?: null | number; IsSpecial?: null | boolean; IsDuplicate?: null | boolean; CollectionCurrencyConverted?: null | number; };
-type OpenPackResponse = { GrantedCollectibles?: null | Array<GrantedCollectible>; DuplicateCollectibles?: null | Array<GrantedCollectible>; CollectionCurrencyEarned?: null | number; NewCollectionCurrencyBalance?: null | number; NewlyCompletedSetIDs?: null | Array<string>; CollectionJustCompleted?: null | boolean; Resources?: null | ResourceOperation; TriggeredPity?: null | Array<unknown>; };
-type OpenCollectionChestResponse = { GrantedCollectibles?: null | Array<GrantedCollectible>; DuplicateCollectibles?: null | Array<GrantedCollectible>; CollectionCurrencyEarned?: null | number; NewCollectionCurrencyBalance?: null | number; Resources?: null | ResourceOperation; TriggeredPity?: null | Array<unknown>; };
+type PackOpenResult = { GrantedCollectibles?: null | Array<GrantedCollectible>; DuplicateCollectibles?: null | Array<GrantedCollectible>; CollectionCurrencyEarned?: null | number; };
+type OpenPackResponse = { OpenedCount?: null | number; Packs?: null | Array<PackOpenResult>; GrantedCollectibles?: null | Array<GrantedCollectible>; DuplicateCollectibles?: null | Array<GrantedCollectible>; CollectionCurrencyEarned?: null | number; NewCollectionCurrencyBalance?: null | number; NewlyCompletedSetIDs?: null | Array<string>; CollectionJustCompleted?: null | boolean; Resources?: null | ResourceOperation; TriggeredPity?: null | Array<unknown>; };
+type OpenCollectionChestResponse = { OpenedCount?: null | number; Chests?: null | Array<PackOpenResult>; GrantedCollectibles?: null | Array<GrantedCollectible>; DuplicateCollectibles?: null | Array<GrantedCollectible>; CollectionCurrencyEarned?: null | number; NewCollectionCurrencyBalance?: null | number; Resources?: null | ResourceOperation; TriggeredPity?: null | Array<unknown>; };
 type UseCollectibleJokerResponse = { GrantedCollectibleID?: null | string; NewlyCompletedSetID?: null | string; CollectionJustCompleted?: null | boolean; Resources?: null | ResourceOperation; };
 type ClaimSetRewardResponse = { SetID: string; Resources?: null | ResourceOperation; };
 type ClaimSetRewardsBatchResponse = Array<{ Id: string; Success: boolean; Error?: null | string; Data?: null | ClaimSetRewardResponse; }>;
@@ -994,13 +1189,22 @@ type AcceptTradeOfferResponse = { OfferID: string; ReceivedCollectibleID?: null
 type DeclineTradeOfferResponse = { OfferID: string; Resources?: null | ResourceOperation; };
 type GetTradeOffersResponse = { Offers?: null | Array<CollectionTradeOfferDocument>; };
 type CollectionDefinition = { CollectionID?: null | string; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; SeasonChainID?: null | string; Sets?: null | Array<{ SetID?: null | string; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; SortOrder?: null | number; Collectibles?: null | Array<{ CollectibleID?: null | string; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; Rarity?: null | number; HasSpecialVersion?: null | boolean; SortOrder?: null | number; [key: string]: unknown; }>; SetCompletionReward?: null | ResourceGrant; [key: string]: unknown; }>; GrandPrize?: null | ResourceGrant; [key: string]: unknown; };
-type CollectionPackTypeDefinition = { PackTypeID?: null | string; Cost?: null | ResourceConsume; BonusRewardSlots?: null | Array<LootboxRewardSlot>; PityRules?: null | Array<LootboxPityRule>; Presets?: null | { BonusRewardSlots?: null | PresetBinding; PityRules?: null | PresetBinding; [key: string]: unknown; }; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; CollectibleCount?: null | number; GuaranteedMinRarity?: null | number; GuaranteeMaxRarity?: null | boolean; RarityWeights?: null | Record<string, number>; ColorTier?: null | number; [key: string]: unknown; };
+type CollectionPackTypeDefinition = { PackTypeID?: null | string; PriceOptions?: null | PriceOptions; BonusRewardSlots?: null | Array<LootboxRewardSlot>; PityRules?: null | Array<LootboxPityRule>; Presets?: null | { BonusRewardSlots?: null | PresetBinding; PityRules?: null | PresetBinding; [key: string]: unknown; }; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; CollectibleCount?: null | number; MaxOpenCount?: null | number; GuaranteedMinRarity?: null | number; GuaranteeMaxRarity?: null | boolean; RarityWeights?: null | Record<string, number>; ColorTier?: null | number; [key: string]: unknown; };
 type DuplicateCollectionCurrencyConversion = { Rarity?: null | number; CollectionCurrencyGranted?: null | number; [key: string]: unknown; };
-type CollectionChestDefinition = { CollectionChestID?: null | string; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; CollectionCurrencyCost?: null | number; MinCollectibleCount?: null | number; MaxCollectibleCount?: null | number; GuaranteedMinRarity?: null | number; BonusRewardSlots?: null | Array<LootboxRewardSlot>; PityRules?: null | Array<LootboxPityRule>; Presets?: null | { BonusRewardSlots?: null | PresetBinding; PityRules?: null | PresetBinding; [key: string]: unknown; }; Tier?: null | number; [key: string]: unknown; };
+type CollectionChestDefinition = { CollectionChestID?: null | string; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; CollectionCurrencyCost?: null | number; MaxOpenCount?: null | number; MinCollectibleCount?: null | number; MaxCollectibleCount?: null | number; GuaranteedMinRarity?: null | number; BonusRewardSlots?: null | Array<LootboxRewardSlot>; PityRules?: null | Array<LootboxPityRule>; Presets?: null | { BonusRewardSlots?: null | PresetBinding; PityRules?: null | PresetBinding; [key: string]: unknown; }; Tier?: null | number; [key: string]: unknown; };
 type SpecialTradeEventDefinition = { SpecialTradeEventID?: null | string; StartUtc?: null | string; EndUtc?: null | string; AllowedSpecialCollectibleIDs?: null | Array<string>; SpecialTradeEventDailyTradeLimit?: null | number; [key: string]: unknown; };
 /** The title's collection-system config (config), returned by getCollectionDefinitions(). */
+/** Module-wide Collection settings shared by every collection and pack type of the title. */
+interface CollectionGlobalSettings {
+    /** Max packs per single OpenPack call. null = platform default (100). <= 0 = disabled. */
+    MaxPackOpenCount?: number | null;
+    /** Same for collection chests (OpenCollectionChest) — a separate knob. */
+    MaxChestOpenCount?: number | null;
+}
 interface CollectionDefinitions {
     Collections?: Record<string, CollectionDefinition> | null;
+    /** Module-wide settings (multi-open ceilings). null = platform defaults apply. */
+    Settings?: CollectionGlobalSettings | null;
     PackTypes?: Record<string, CollectionPackTypeDefinition> | null;
     CollectionChests?: CollectionChestDefinition[] | null;
     DuplicateConversions?: DuplicateCollectionCurrencyConversion[] | null;
@@ -1017,6 +1221,13 @@ interface CollectionSetRef {
 }
 interface CollectionRequest extends BaseRequest {
     CollectionID?: string;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which is what keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
+    /** Store receipt. Required exactly when the chosen option is paid in a store. */
+    Payment?: PaymentProof;
     CollectibleID?: string;
     PackTypeID?: string;
     CollectionChestID?: string;
@@ -1028,6 +1239,11 @@ interface CollectionRequest extends BaseRequest {
     RequestedCollectibleID?: string;
     RequestedCollectibleIsSpecial?: boolean;
     OfferID?: string;
+    /**
+     * How many packs/chests to open in a single OpenPack / OpenCollectionChest call. Default 1.
+     * Clamped to [1, MaxOpenCount].
+     */
+    Count?: number;
 }
 declare const CollectionAction: {
     readonly GetDefinitions: "GetDefinitions";
@@ -1084,7 +1300,7 @@ type CoopPartnerObjectState = { Index?: null | number; OwnerUserID?: null | stri
 type CoopBuildObjectsState = { Objects?: null | Array<CoopPartnerObjectState>; [key: string]: unknown; };
 type CoopGroupDocument = { GroupID?: null | string; TitleID?: null | string; CoopChainID?: null | string; CoopEventID?: null | string; CycleIndex?: null | number; Members?: null | Array<CoopGroupMember>; BuildObjectsState?: null | CoopBuildObjectsState; Status?: null | string; CreatedAtUtc?: null | string; ExpiresAtUtc?: null | string; Version?: null | number; [key: string]: unknown; };
 type ActiveCoopEventInfo = { CoopChainID: string; [key: string]: unknown; };
-type CoopEventDefinition = { CoopEventID?: null | string; Order?: null | number; DurationSec?: null | number; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; EventType?: null | string; PartnerCount?: null | number; MatchmakingTimeoutMinutes?: null | number; MemberGracePeriodMinutes?: null | number; BuildObjects?: null | { Objects?: null | Array<{ Index?: null | number; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; MaxProgress?: null | number; CompletionReward?: null | ResourceGrant; [key: string]: unknown; }>; SpinCost?: null | ResourceConsume; SpinnerTable?: null | Array<{ DisplayName?: null | string; AssetPaths?: null | Record<string, string>; Weight?: null | number; MinProgress?: null | number; MaxProgress?: null | number; [key: string]: unknown; }>; [key: string]: unknown; }; GrandPrize?: null | ResourceGrant; [key: string]: unknown; };
+type CoopEventDefinition = { CoopEventID?: null | string; Order?: null | number; DurationSec?: null | number; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; EventType?: null | string; PartnerCount?: null | number; MatchmakingTimeoutMinutes?: null | number; MemberGracePeriodMinutes?: null | number; BuildObjects?: null | { Objects?: null | Array<{ Index?: null | number; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; MaxProgress?: null | number; CompletionReward?: null | ResourceGrant; [key: string]: unknown; }>; PriceOptions?: null | PriceOptions; SpinnerTable?: null | Array<{ DisplayName?: null | string; AssetPaths?: null | Record<string, string>; Weight?: null | number; MinProgress?: null | number; MaxProgress?: null | number; [key: string]: unknown; }>; MaxSpinsPerCall?: null | number; [key: string]: unknown; }; GrandPrize?: null | ResourceGrant; [key: string]: unknown; };
 /** A coop event chain: cyclic schedule + ordered events + audience gate. */
 interface CoopEventChainDefinition {
     CoopChainID?: string | null;
@@ -1096,7 +1312,7 @@ interface CoopEventChainDefinition {
 }
 type CoopUserStateResponse = { ServerTimeUtc?: null | string; UserState?: null | UserCoopEventState; ActiveGroup?: null | CoopGroupDocument; };
 type CoopGroupStateResponse = { ServerTimeUtc?: null | string; Group?: null | CoopGroupDocument; SecondsRemaining?: null | number; };
-type CoopSpinResponse = { ServerTimeUtc?: null | string; GroupID?: null | string; Resources?: null | ResourceOperation; ObjectIndex?: null | number; Sector?: null | { DisplayName?: null | string; AssetPaths?: null | Record<string, string>; Weight?: null | number; MinProgress?: null | number; MaxProgress?: null | number; [key: string]: unknown; }; ProgressDelta?: null | number; NewProgress?: null | number; MaxProgress?: null | number; ObjectCompleted?: null | boolean; AllObjectsCompleted?: null | boolean; };
+type CoopSpinResponse = { ServerTimeUtc?: null | string; GroupID?: null | string; Resources?: null | ResourceOperation; ObjectIndex?: null | number; Sector?: null | { DisplayName?: null | string; AssetPaths?: null | Record<string, string>; Weight?: null | number; MinProgress?: null | number; MaxProgress?: null | number; [key: string]: unknown; }; RequestedSpins?: null | number; SpinsUsed?: null | number; Sectors?: null | Array<{ DisplayName?: null | string; AssetPaths?: null | Record<string, string>; Weight?: null | number; MinProgress?: null | number; MaxProgress?: null | number; [key: string]: unknown; }>; ProgressDelta?: null | number; NewProgress?: null | number; MaxProgress?: null | number; ObjectCompleted?: null | boolean; AllObjectsCompleted?: null | boolean; };
 type CoopClaimRewardResponse = { ServerTimeUtc?: null | string; GroupID?: null | string; RewardType?: null | string; Resources?: null | ResourceOperation; };
 type CoopLeaveGroupResponse = { ServerTimeUtc?: null | string; GroupID?: null | string; Success?: null | boolean; };
 /** Root config of the title's cooperative events system. Plugs into TitlePublicConfig as CoopEvent. */
@@ -1107,7 +1323,17 @@ interface CoopEventDefinitions {
 }
 interface CoopEventRequest extends BaseRequest {
     CoopChainID?: string;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
     GroupID?: string;
+    /**
+     * How many spins to perform in a single Spin call. Default 1. Clamped to
+     * [1, MaxSpinsPerCall]. Only spins that actually happen are charged — see SpinsUsed.
+     */
+    Count?: number;
 }
 declare const CoopEventAction: {
     readonly GetDefinitions: "GetDefinitions";
@@ -1153,7 +1379,7 @@ interface UserDealOffersState {
     LastUpdatedUtc?: string | null;
 }
 type DealSlotDefinition = { SlotID?: null | string; Enabled?: null | boolean; SortOrder?: null | number; Queue?: null | Array<{ Order?: null | number; OfferID?: null | string; DurationSec?: null | number; DelayBeforeActivationSec?: null | number; [key: string]: unknown; }>; Schedule?: null | ScheduleSpec; Gate?: null | SegmentGate; AllowDismissSkip?: null | boolean; DismissSkipDelaySec?: null | number; [key: string]: unknown; };
-type DealNodeActionDefinition = { Purchase?: null | { StoreOfferID?: null | string; BillingProductID?: null | string; DirectCost?: null | ResourceConsume; UseExternalRewards?: null | boolean; [key: string]: unknown; }; RewardedVideo?: null | { AdPlacementID?: null | string; ViewsRequiredToComplete?: null | number; MaxViewsPerActivation?: null | number; CooldownSecondsBetweenViews?: null | number; RequireServerVerification?: null | boolean; GrantRewardsPerView?: null | boolean; [key: string]: unknown; }; [key: string]: unknown; };
+type DealNodeActionDefinition = { Purchase?: null | { StoreOfferID?: null | string; BillingProductID?: null | string; PriceOptions?: null | PriceOptions; UseExternalRewards?: null | boolean; [key: string]: unknown; }; RewardedVideo?: null | { AdPlacementID?: null | string; ViewsRequiredToComplete?: null | number; MaxViewsPerActivation?: null | number; CooldownSecondsBetweenViews?: null | number; RequireServerVerification?: null | boolean; GrantRewardsPerView?: null | boolean; [key: string]: unknown; }; [key: string]: unknown; };
 /**
  * Container of preset wiring for an offer — one PresetBinding per block. Inline data (Milestones)
  * lives on DealOfferDefinition. null = presets unused.
@@ -1251,6 +1477,13 @@ type ClaimDealMilestoneResponse = { ServerTimeUtc?: null | string; SlotID?: null
 type ClaimDealMilestonesBatchResponse = { ServerTimeUtc?: null | string; SlotID?: null | string; ClaimedIDs?: null | Array<string>; Rejected?: null | Record<string, string>; Resources?: null | ResourceOperation; };
 interface DealOfferRequest extends BaseRequest {
     SlotID?: string;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
+    /** Store receipt. Required exactly when the chosen option is paid in a store. */
+    Payment?: PaymentProof;
     NodeID?: string;
     MilestoneID?: string;
     MilestoneIDs?: string[];
@@ -1296,15 +1529,23 @@ interface ReferralDefinitionsResponse {
 type UserReferralStateResponse = { Referral?: null | UserReferralState; };
 type ActivateReferralCodeResponse = { ReferralCode?: null | string; IsFirstActivation?: null | boolean; Resources?: null | ResourceOperation; };
 type ClaimInviteRewardResponse = { RewardID?: null | string; Resources?: null | ResourceOperation; };
+type ClaimInviteRewardsBatchResponse = { ServerTimeUtc: string; Items: Array<{ Id: string; Success: boolean; Error?: null | string; Data?: null | ClaimInviteRewardResponse; }>; Resources?: null | ResourceOperation; };
 interface ReferralRequest extends BaseRequest {
     ReferralCode?: string;
     InviteRewardID?: string;
+    /**
+     * ClaimInviteRewardsBatch: invite-milestone IDs to claim. Deduped keeping order, clamped to
+     * the platform batch size. Invalid entries (unknown / not reached / already claimed) fail as
+     * their own item without dropping the batch.
+     */
+    InviteRewardIDs?: string[];
 }
 declare const ReferralAction: {
     readonly GetDefinitions: "GetDefinitions";
     readonly GetUserState: "GetUserState";
     readonly ActivateReferralCode: "ActivateReferralCode";
     readonly ClaimInviteReward: "ClaimInviteReward";
+    readonly ClaimInviteRewardsBatch: "ClaimInviteRewardsBatch";
 };
 type ReferralAction = (typeof ReferralAction)[keyof typeof ReferralAction];
 
@@ -1330,7 +1571,8 @@ interface UserSocialState {
     Timeline?: SocialTimelineEvent[];
 }
 type FriendsListResponse = { Friends?: null | Array<FriendPublicProfile>; };
-type FriendActionResponse = { TargetUserID?: null | string; Status?: null | string; };
+type SocialCounters = { FriendsCount?: null | number; IncomingRequestsCount?: null | number; OutgoingRequestsCount?: null | number; };
+type FriendActionResponse = { TargetUserID?: null | string; Status?: null | string; Target?: null | FriendPublicProfile; Counters?: null | SocialCounters; };
 type TimelineResponse = { Events?: null | Array<SocialTimelineEvent>; };
 interface SocialRequest extends BaseRequest {
     TargetUserID?: string;
@@ -1355,7 +1597,7 @@ declare const TimedBoostStackingPolicy: {
     readonly Stack: "Stack";
 };
 type TimedBoostStackingPolicy = (typeof TimedBoostStackingPolicy)[keyof typeof TimedBoostStackingPolicy];
-type TimedBoostDefinition = { BoostID?: null | string; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; ActivationCost?: null | ResourceConsume; Effect?: null | { Target?: null | string; Operation?: null | string; Value?: null | number; [key: string]: unknown; }; DurationSeconds?: null | number; Charges?: null | number; StackingPolicy?: null | string; MaxActiveInstances?: null | number; Tags?: null | Array<string>; [key: string]: unknown; };
+type TimedBoostDefinition = { BoostID?: null | string; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; PriceOptions?: null | PriceOptions; Effect?: null | { Target?: null | string; Operation?: null | string; Value?: null | number; [key: string]: unknown; }; DurationSeconds?: null | number; Charges?: null | number; StackingPolicy?: null | string; MaxActiveInstances?: null | number; Tags?: null | Array<string>; [key: string]: unknown; };
 type ScheduledBoostDefinition = { ScheduledBoostID?: null | string; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; Tags?: null | Array<string>; Schedule?: null | ScheduleSpec; Effects?: null | Array<{ Target?: null | string; Operation?: null | string; Value?: null | number; [key: string]: unknown; }>; Gate?: null | SegmentGate; CustomParams?: null | Record<string, string>; [key: string]: unknown; };
 type BoostChainDefinition = { ChainID?: null | string; DisplayName?: null | string; Description?: null | string; AssetPaths?: null | Record<string, string>; Schedule?: null | ScheduleSpec; Phases?: null | Array<{ ChainedBoostID?: null | string; Order?: null | number; DurationSec?: null | number; Effects?: null | Array<{ Target?: null | string; Operation?: null | string; Value?: null | number; [key: string]: unknown; }>; CustomParams?: null | Record<string, string>; [key: string]: unknown; }>; Gate?: null | SegmentGate; CustomParams?: null | Record<string, string>; [key: string]: unknown; };
 type TriggeredBoostDefinition = { TriggeredBoostID?: null | string; DisplayName?: null | string; AssetPaths?: null | Record<string, string>; Tags?: null | Array<string>; Sources?: null | Array<TriggerSource>; Effects?: null | Array<{ Target?: null | string; Operation?: null | string; Value?: null | number; [key: string]: unknown; }>; DurationSeconds?: null | number; Charges?: null | number; StackingPolicy?: null | string; MaxActiveInstances?: null | number; Gate?: null | SegmentGate; [key: string]: unknown; };
@@ -1386,6 +1628,13 @@ type ActiveBoostWindowInfo = { Kind?: null | string; SourceID?: null | string; P
 type GetActiveBoostWindowsResponse = { ServerTimeUtc?: null | string; Windows?: null | Array<ActiveBoostWindowInfo>; };
 interface TimedBoostRequest extends BaseRequest {
     BoostID?: string;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
+    /** Store receipt. Required exactly when the chosen option is paid in a store. */
+    Payment?: PaymentProof;
 }
 declare const TimedBoostAction: {
     readonly GetDefinitions: "GetDefinitions";
@@ -1652,7 +1901,7 @@ interface GameLoopDefinitions {
     [key: string]: unknown;
 }
 type RollActionData = { TargetUserID?: null | string; IsBot?: null | boolean; PublicData?: null | UserPublicDataModel; TargetBuildingStates?: null | Array<BuildingState>; TargetHasShield?: null | boolean; [key: string]: unknown; };
-type SpecialModeOfferData = { ModeID?: null | string; Choices?: null | Array<{ ChoiceID?: null | string; Mode?: null | string; Reward?: null | ScaledResourceOperation; DurationSeconds?: null | number; EntryCost?: null | ResourceConsume; Multipliers?: null | SpecialClaimMultipliers; [key: string]: unknown; }>; [key: string]: unknown; };
+type SpecialModeOfferData = { ModeID?: null | string; Choices?: null | Array<{ ChoiceID?: null | string; Mode?: null | string; Reward?: null | ScaledResourceOperation; DurationSeconds?: null | number; PriceOptions?: null | PriceOptions; Multipliers?: null | SpecialClaimMultipliers; [key: string]: unknown; }>; [key: string]: unknown; };
 type CommunityChestContributionResult = { GroupID?: null | string; Delta?: null | number; NewProgress?: null | number; MaxProgress?: null | number; UnlockedMilestoneIDs?: null | Array<string>; Completed?: null | boolean; [key: string]: unknown; };
 interface BoardRollResponse {
     UsedMultiplier?: number | null;
@@ -1700,6 +1949,11 @@ type CommunityChestClaimResponse = { ServerTimeUtc?: null | string; GroupID?: nu
 type CommunityChestLeaveResponse = { ServerTimeUtc?: null | string; GroupID?: null | string; Success?: null | boolean; };
 interface GameLoopRequest extends BaseRequest {
     RollMultiplier?: number;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
     BuildingIndex?: number;
     DigIndex?: number;
     StageLevel?: number;
@@ -1762,14 +2016,14 @@ type MarketplaceCommissionOverride = { Percent?: null | number; MinPerPosition?:
 type MarketplacePricePolicy = { AllowVirtualCurrency?: null | boolean; AllowItems?: null | boolean; AllowEventTokens?: null | boolean; Allowed?: null | Array<{ Kind?: null | 'Item' | 'VirtualCurrency' | 'EventToken'; CurrencyID?: null | string; CatalogID?: null | string; ItemID?: null | string; TokenType?: null | 'TimedEvent' | 'Quest' | 'Leaderboard' | 'CoopEvent' | 'Season'; EntityID?: null | string; MinAmount?: null | number; MaxAmount?: null | number; [key: string]: unknown; }>; MaxPositions?: null | number; [key: string]: unknown; };
 type MarketplaceCommissionPolicy = { Percent?: null | number; MinPerPosition?: null | number; Sink?: null | 'Burn' | 'Ledger'; LedgerAccountID?: null | string; PerCatalogOverrides?: null | Record<string, MarketplaceCommissionOverride>; ApplyToDirectTrades?: null | boolean; [key: string]: unknown; };
 type MarketplaceTradabilityPolicy = { AllowedCatalogIDs?: null | Array<string>; DeniedCatalogIDs?: null | Array<string>; DeniedItemIDs?: null | Array<string>; AllowUnstackableWithState?: null | boolean; [key: string]: unknown; };
-type MarketplaceListingSettings = { Enabled?: null | boolean; AllowedDurationsHours?: null | Array<number>; MaxActiveListings?: null | number; CreateLimits?: null | LimitSpec; BuyLimits?: null | LimitSpec; ListingFee?: null | ResourceConsume; RefundListingFeeOnCancel?: null | boolean; [key: string]: unknown; };
+type MarketplaceListingSettings = { Enabled?: null | boolean; AllowedDurationsHours?: null | Array<number>; MaxActiveListings?: null | number; CreateLimits?: null | LimitSpec; BuyLimits?: null | LimitSpec; ListingFeeOptions?: null | PriceOptions; RefundListingFeeOnCancel?: null | boolean; [key: string]: unknown; };
 type MarketplaceAuctionSettings = { Enabled?: null | boolean; MinDurationHours?: null | number; MaxDurationHours?: null | number; AntiSnipeWindowSeconds?: null | number; AntiSnipeExtensionSeconds?: null | number; MaxAntiSnipeExtensions?: null | number; MinBidStepPercent?: null | number; MinBidStepAbsolute?: null | number; BidLimits?: null | LimitSpec; [key: string]: unknown; };
 type MarketplaceBuyOrderSettings = { Enabled?: null | boolean; MaxActiveOrders?: null | number; AllowedDurationsHours?: null | Array<number>; CreateLimits?: null | LimitSpec; FillLimits?: null | LimitSpec; [key: string]: unknown; };
 type MarketplaceDirectTradeSettings = { Enabled?: null | boolean; OfferExpirationHours?: null | number; MaxPendingOutgoing?: null | number; AllowGifts?: null | boolean; CreateLimits?: null | LimitSpec; [key: string]: unknown; };
 type MarketplaceMatchingSettings = { Enabled?: null | boolean; [key: string]: unknown; };
 type MarketplaceDefinitions = { Enabled?: null | boolean; Gate?: null | SegmentGate; Schedule?: null | ScheduleSpec; PricePolicy?: null | MarketplacePricePolicy; Commission?: null | MarketplaceCommissionPolicy; Tradability?: null | MarketplaceTradabilityPolicy; Listings?: null | MarketplaceListingSettings; Auctions?: null | MarketplaceAuctionSettings; BuyOrders?: null | MarketplaceBuyOrderSettings; DirectTrades?: null | MarketplaceDirectTradeSettings; Matching?: null | MarketplaceMatchingSettings; [key: string]: unknown; };
 type MarketplaceBidRefund = { BidIndex?: null | number; UserID?: null | string; Amount?: null | number; Settled?: null | boolean; SettledAt?: null | string; [key: string]: unknown; };
-type MarketplaceAuctionState = { BidAxisType?: null | 'Item' | 'VirtualCurrency' | 'CryptoCurrency' | 'UsdCent'; BidCurrencyID?: null | string; BidCatalogID?: null | string; BidItemID?: null | string; StartingBid?: null | number; CurrentBid?: null | number; CurrentBidderID?: null | string; BidCount?: null | number; ExtensionCount?: null | number; PendingRefunds?: null | Array<MarketplaceBidRefund>; [key: string]: unknown; };
+type MarketplaceAuctionState = { BidAxisType?: null | 'Item' | 'VirtualCurrency' | 'CryptoCurrency' | 'RewardedVideoCredit' | 'Purchase'; BidCurrencyID?: null | string; BidCatalogID?: null | string; BidItemID?: null | string; StartingBid?: null | number; CurrentBid?: null | number; CurrentBidderID?: null | string; BidCount?: null | number; ExtensionCount?: null | number; PendingRefunds?: null | Array<MarketplaceBidRefund>; [key: string]: unknown; };
 type MarketplaceActionCounter = { LastAt?: null | string; DailyCount?: null | number; DailyResetUtc?: null | string; [key: string]: unknown; };
 type UserMarketplaceState = { Create?: null | MarketplaceActionCounter; Buy?: null | MarketplaceActionCounter; Sell?: null | MarketplaceActionCounter; Bid?: null | MarketplaceActionCounter; [key: string]: unknown; };
 type MarketplaceOfferView = { OfferID?: null | string; OfferType?: null | 'Listing' | 'Auction' | 'BuyOrder' | 'DirectTrade'; Status?: null | 'Active' | 'Completed' | 'Expired' | 'Cancelled' | 'Declined'; CreatorUserID?: null | string; CreatorPublicData?: null | UserPublicDataModel; TargetUserID?: null | string; GoodsType?: null | 'Item' | 'VirtualCurrency'; GoodsCatalogID?: null | string; GoodsItemID?: null | string; GoodsCurrencyID?: null | string; GoodsAmount?: null | number; GoodsInstances?: null | Array<UnstackableItemInstanceState>; Price?: null | ResourceBundle; Auction?: null | MarketplaceAuctionState; CreatedAt?: null | string; ExpiresAt?: null | string; [key: string]: unknown; };
@@ -1790,6 +2044,11 @@ type MarketplaceHistoryEntryView = { OfferID?: null | string; OfferType?: null |
 type MarketplaceHistoryResponse = { Entries?: null | Array<MarketplaceHistoryEntryView>; ContinuationToken?: null | string; [key: string]: unknown; };
 interface MarketplaceRequest extends BaseRequest {
     OfferID?: string;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
     /**
      * Item (default) or VirtualCurrency. For Create actions / MarketBuy / MarketSell: what's
      * traded. For browsing (GetOffersByItem/GetBuyOrders): a storefront filter.
@@ -1844,6 +2103,111 @@ declare const MarketplaceAction: {
 };
 type MarketplaceAction = (typeof MarketplaceAction)[keyof typeof MarketplaceAction];
 
+declare const LocalizationMissingKeyMode: {
+    /** Render the key itself. Default — this is what keeps literal-name titles working. */
+    readonly ReturnKey: "ReturnKey";
+    /** Render the key wrapped in markers (⟦quest.daily.title⟧) — proofreading mode. */
+    readonly ReturnMarkedKey: "ReturnMarkedKey";
+    /** Render an empty string. */
+    readonly ReturnEmpty: "ReturnEmpty";
+};
+type LocalizationMissingKeyMode = (typeof LocalizationMissingKeyMode)[keyof typeof LocalizationMissingKeyMode];
+/** One language offered to the player. */
+interface LocalizationLocaleDefinition {
+    /** Readability mirror of the dictionary key; the KEY is the identifier. */
+    Locale?: string | null;
+    /**
+     * Language name written IN THAT LANGUAGE ("Русский", "Deutsch") — an endonym, not a
+     * translation: the picker is read by someone who may not know the current language.
+     */
+    DisplayName?: string | null;
+    IsEnabled?: boolean | null;
+    Order?: number | null;
+    [k: string]: unknown;
+}
+/**
+ * `TitlePublicConfigurationModel.Localization` — settings only. No translations here.
+ */
+interface LocalizationDefinitions {
+    IsEnabled?: boolean | null;
+    /** Default locale, which is also the FALLBACK. Canonical form (lower-case, "-"). */
+    DefaultLocale?: string | null;
+    /** Keyed by canonical locale code ("en", "pt-br"). */
+    Locales?: Record<string, LocalizationLocaleDefinition> | null;
+    MissingKeyMode?: LocalizationMissingKeyMode | null;
+    MaxEntriesPerLocale?: number | null;
+    MaxValueLengthBytes?: number | null;
+    [k: string]: unknown;
+}
+/** One table: which locale, which version, and where the artifact is. */
+interface LocalizationTableRef {
+    Locale?: string | null;
+    Version?: number | null;
+    /** `null` — nothing to download, or the artifact could not be published. */
+    Url?: string | null;
+    [k: string]: unknown;
+}
+/**
+ * `ClientState.Localization` — what to download and from where.
+ *
+ * `Fallback` is present only when the player's own locale is NOT fully translated. A fully
+ * translated language carries ONE file, and edits to the default language then cost that player
+ * nothing — this is the whole reason coverage is computed server-side.
+ */
+interface LocalizationState {
+    /** The locale the request was resolved to. Cache the table UNDER THIS, not under what you sent. */
+    Locale?: string | null;
+    /** `0` — no table exists for this locale (declared but untranslated). */
+    Version?: number | null;
+    Url?: string | null;
+    Fallback?: LocalizationTableRef | null;
+    [k: string]: unknown;
+}
+interface LocalizationRequest extends BaseRequest {
+    /** Any form: "ru", "pt-BR", "pt_br". The server canonicalizes and resolves it. */
+    Locale?: string;
+    /** Version already held by the client. `0`/absent — nothing cached. */
+    KnownVersion?: number;
+}
+declare const LocalizationAction: {
+    readonly GetLocalizationManifest: "GetLocalizationManifest";
+    readonly GetLocalizationTable: "GetLocalizationTable";
+};
+type LocalizationAction = (typeof LocalizationAction)[keyof typeof LocalizationAction];
+interface LocalizationLocaleInfo {
+    Locale?: string | null;
+    DisplayName?: string | null;
+    Order?: number | null;
+    /** `0` — the language is declared but has no table yet. */
+    Version?: number | null;
+    [k: string]: unknown;
+}
+/** Discovery: what exists, without downloading any table. */
+interface LocalizationManifestResponse {
+    IsEnabled?: boolean | null;
+    DefaultLocale?: string | null;
+    MissingKeyMode?: LocalizationMissingKeyMode | null;
+    ResolvedLocale?: string | null;
+    Locales?: LocalizationLocaleInfo[] | null;
+    [k: string]: unknown;
+}
+/**
+ * A translation table delivered in the response BODY — the fallback for when the CDN artifact
+ * is unavailable. `Entries` is exactly what the artifact file contains: a flat `{key: value}`
+ * object.
+ */
+interface LocalizationTableResponse {
+    RequestedLocale?: string | null;
+    Locale?: string | null;
+    Version?: number | null;
+    /** `true` — the client's version matched; `Entries` is absent. */
+    NotModified?: boolean | null;
+    Entries?: Record<string, string> | null;
+    FallbackLocale?: string | null;
+    FallbackVersion?: number | null;
+    [k: string]: unknown;
+}
+
 interface UserDailyCounters {
     PeriodStartUtc: string;
     Earned: number;
@@ -1955,6 +2319,7 @@ interface UserState {
     Lootbox?: UserLootboxState | null;
     Reward?: UserRewardState | null;
     Quest?: UserQuestState | null;
+    Tutorial?: UserTutorialState | null;
     Leaderboard?: UserLeaderboardsState | null;
     Season?: UserSeasonsState | null;
     Premium?: UserPremiumState | null;
@@ -2014,6 +2379,15 @@ interface ClientState {
      * недействительна, состояние приходит целиком.
      */
     StateEpoch?: string | null;
+    /**
+     * Локализация: какую таблицу переводов качать и откуда. Устроено как конфиг тайтла — уезжает
+     * ССЫЛКОЙ на immutable-артефакт, — но таблиц может понадобиться ДВЕ: своя и запасная, если
+     * своя переведена не полностью.
+     *
+     * `null` — локализация у тайтла выключена. `UserService` разбирается с этим сам: качает,
+     * кладёт в локальное хранилище и отдаёт `client.localization`.
+     */
+    Localization?: LocalizationState | null;
     [k: string]: unknown;
 }
 /**
@@ -2064,6 +2438,21 @@ interface UserRequest extends BaseRequest {
      * запроса, когда скачать артефакт не удалось; вручную задавать не нужно.
      */
     ForceInlineConfig?: boolean;
+    /**
+     * Локаль игрока в любой форме («ru», «pt-BR», «pt_br»). Сервер сводит её к объявленной
+     * тайтлом и отвечает про результат в `ClientState.Localization.Locale`.
+     *
+     * Ставится SDK автоматически из `settings.locale` (по умолчанию — язык устройства);
+     * задавать вручную нужно только при явной смене языка игроком.
+     */
+    Locale?: string;
+    /**
+     * Версии таблиц переводов, которые уже есть у клиента: «локаль → версия». Ставится SDK.
+     *
+     * Карта, а не одно число, потому что таблиц у клиента бывает две — своя и запасная, — и
+     * устареть они могут независимо: правка английского не трогает версию русского.
+     */
+    KnownLocalizationVersions?: Record<string, number>;
 }
 declare const UserAction: {
     readonly GetClientState: "GetClientState";
@@ -2357,6 +2746,11 @@ interface ItemUpgradeRef {
 }
 interface ItemRequest extends BaseRequest {
     ItemInstanceID?: string;
+    /**
+     * Chosen way to pay (`PriceOption.OptionID`). Empty = the first option available on this
+     * player's platform, which keeps single-price entities working unchanged.
+     */
+    SelectedOptionID?: string;
     Levels?: number;
     TargetLevel?: number;
     FodderInstanceIDs?: string[];
@@ -2385,7 +2779,7 @@ type NFTModel = { Networks?: null | Record<string, NFTNetworkBinding>; MetadataU
 type ItemStats = { FlatBonuses?: null | Record<string, number>; PercentBonuses?: null | Record<string, number>; Power?: null | number; [key: string]: unknown; };
 type ItemEquipment = { MinCharacterLevel?: null | number; UseRequirements?: null | Record<string, number>; AllowedCharacterIDs?: null | Array<string>; AllowedSlotIDs?: null | Array<string>; [key: string]: unknown; };
 type ItemUpgradeFodder = { ValuationMode?: null | 'FlatCount' | 'Merge' | 'InvestmentRefund'; MergeRatio?: null | number; Selection?: null | 'ProtectLeveled' | 'CheapestFirst' | 'ClientSelected'; [key: string]: unknown; };
-type ItemUpgrade = { MaxLevel?: null | number; BaseCostResource?: null | ResourceConsume; CostScalingFactor?: null | number; FlatScalingFactor?: null | number; PercentScalingFactor?: null | number; PowerScalingFactor?: null | number; Fodder?: null | ItemUpgradeFodder; [key: string]: unknown; };
+type ItemUpgrade = { MaxLevel?: null | number; PriceOptions?: null | PriceOptions; CostScalingFactor?: null | number; FlatScalingFactor?: null | number; PercentScalingFactor?: null | number; PowerScalingFactor?: null | number; Fodder?: null | ItemUpgradeFodder; [key: string]: unknown; };
 type ItemMetadata = { RarityID?: null | string; CollectionID?: null | string; AuthorID?: null | string; [key: string]: unknown; };
 type ItemDefinition = { ItemID: string; CatalogID: string; ItemClass?: null | string; DisplayName?: null | string; Description?: null | string; Tags?: null | Array<string>; CustomData?: null | string; IsStackable?: null | boolean; IsTradable?: null | boolean; Weight?: null | number; AssetPaths?: null | Record<string, string>; NFT?: null | NFTModel; Stats?: null | ItemStats; Equipment?: null | ItemEquipment; Upgrade?: null | ItemUpgrade; Metadata?: null | ItemMetadata; ExpirationDurationSeconds?: null | number; [key: string]: unknown; };
 /** Catalog: a set of items of one thematic group. Key of `Items` is ItemID. */
@@ -2547,7 +2941,7 @@ declare const CraftType: {
 type CraftType = (typeof CraftType)[keyof typeof CraftType];
 type CraftSingleResult = { Index?: null | number; BurnedItemIDs?: null | Array<string>; RolledCollectionID?: null | string; UsedCollections?: null | Record<string, number>; Output?: null | ResourceEntry; };
 type CraftResponse = { ServerTimeUtc: string; CraftID: string; Type?: null | 'TradeUpRarity' | 'TradeUpCollection'; CraftedCount?: null | number; SelectedOptionID?: null | string; InputRarity?: null | string; OutputRarity?: null | string; Resources?: null | ResourceOperation; Results?: null | Array<CraftSingleResult>; };
-type CraftDefinition = { CraftID?: null | string; Type?: null | 'TradeUpRarity' | 'TradeUpCollection'; CatalogID?: null | string; CollectionID?: null | string; InputRarityID?: null | string; OutputRarityID?: null | string; RequiredItemCount?: null | number; PriceOptions?: null | Record<string, { OptionID?: null | string; RequiredResources?: null | ResourceConsume; [key: string]: unknown; }>; [key: string]: unknown; };
+type CraftDefinition = { CraftID?: null | string; Type?: null | 'TradeUpRarity' | 'TradeUpCollection'; CatalogID?: null | string; CollectionID?: null | string; InputRarityID?: null | string; OutputRarityID?: null | string; RequiredItemCount?: null | number; PriceOptions?: null | PriceOptions; [key: string]: unknown; };
 /** The title's craft catalog (config), returned by getDefinitions(). */
 interface CraftDefinitions {
     Definitions?: Record<string, CraftDefinition> | null;
@@ -2634,6 +3028,12 @@ interface TitlePublicConfigurationModel {
     Multiplayer?: MultiplayerDefinitions | null;
     UserCustomData?: UserCustomDataDefinitions | null;
     Referral?: ReferralDefinitions | null;
+    /**
+     * Localization SETTINGS only — which locales exist, which is the fallback, the limits. The
+     * translation TABLES are delivered separately, one file per locale; use `client.localization`
+     * rather than reading anything out of here.
+     */
+    Localization?: LocalizationDefinitions | null;
     [key: string]: unknown;
 }
 interface TitleRequest extends BaseRequest {
@@ -2666,6 +3066,7 @@ interface SdkEvents {
     "user:lootboxUpdated": void;
     "user:rewardUpdated": void;
     "user:questUpdated": void;
+    "user:tutorialUpdated": void;
     "user:timedEventUpdated": void;
     "user:leaderboardUpdated": void;
     "user:seasonUpdated": void;
@@ -2722,6 +3123,32 @@ interface SdkEvents {
      * quest UI. Nothing to call to trigger it.
      */
     "quest:systemProgress": QuestProgressUpdate[];
+    "tutorial:definitionsLoaded": TutorialDefinitions;
+    "tutorial:userStateLoaded": GetUserTutorialStateResponse;
+    "tutorial:flowStarted": TutorialFlowResponse;
+    "tutorial:flowSkipped": TutorialFlowResponse;
+    "tutorial:flowReset": TutorialFlowResponse;
+    "tutorial:stepChanged": TutorialFlowResponse;
+    "tutorial:stepsCompletedBatch": TutorialFlowBatchResponse;
+    "tutorial:rewardClaimed": TutorialClaimResponse;
+    /**
+     * Steps the BACKEND advanced while handling some other call (Mode = SystemEvent). Arrives on
+     * the response of the action that caused it — subscribe instead of polling the state.
+     */
+    "tutorial:systemProgress": TutorialStepProgress[];
+    /**
+     * Таблица переводов сменилась: игрок вошёл, переключил язык или издатель поправил тексты.
+     * Подписка — штатный способ перерисовать уже нарисованные подписи: `t()` синхронна, поэтому
+     * без сигнала интерфейс останется со старыми строками до следующей перерисовки.
+     *
+     * `fallbackLocale` не `null` — своя локаль переведена не полностью, часть надписей приедет
+     * на языке по умолчанию.
+     */
+    "localization:changed": {
+        locale: string | null;
+        fallbackLocale: string | null;
+        entryCount: number;
+    };
     /**
      * New revisions of the state containers the backend changed while handling some other call
      * (a purchase, a claim, a roll). Rides on that call's response so the client can keep its
@@ -2761,6 +3188,8 @@ interface SdkEvents {
     "season:userStateLoaded": UserSeasonStateResponse;
     "season:statusTokensGranted": GrantStatusTokensResponse;
     "season:tierRewardClaimed": ClaimTierRewardResponse;
+    /** Batch claim of several tier rewards applied in one atomic operation. */
+    "season:tierRewardsBatchClaimed": ClaimTierRewardsBatchResponse;
     "premium:definitionsLoaded": PremiumDefinitionsResponse;
     "premium:stateLoaded": PremiumStateResponse;
     "premium:trialActivated": PremiumPurchaseResponse;
@@ -2826,6 +3255,8 @@ interface SdkEvents {
     "referral:userStateLoaded": UserReferralStateResponse;
     "referral:codeActivated": ActivateReferralCodeResponse;
     "referral:inviteRewardClaimed": ClaimInviteRewardResponse;
+    /** Batch claim of several invite milestones applied in one atomic operation. */
+    "referral:inviteRewardsBatchClaimed": ClaimInviteRewardsBatchResponse;
     "social:friendsListLoaded": FriendsListResponse;
     "social:incomingRequestsLoaded": FriendsListResponse;
     "social:recommendedFriendsLoaded": FriendsListResponse;
@@ -2945,6 +3376,15 @@ interface IDosGamesSettings {
      * перезапуск (React Native, встраивание в нативную оболочку).
      */
     readonly configStorage: ConfigStorage;
+    /**
+     * Локаль игрока, с которой стартует игра. По умолчанию — язык устройства; не определился —
+     * пусто, и тогда сервер отдаст язык тайтла по умолчанию.
+     *
+     * Это ПОЖЕЛАНИЕ, а не факт: сервер сводит код к тому, на что тайтл реально переведён
+     * («pt-BR» → «pt-br» → «en»), и отвечает результатом. Смотреть надо
+     * `client.localization.locale`, а не это поле.
+     */
+    readonly locale: string;
 }
 interface SettingsInput {
     titleID: string;
@@ -2954,6 +3394,7 @@ interface SettingsInput {
     devBuild?: boolean;
     debugLogging?: boolean;
     configStorage?: ConfigStorage;
+    locale?: string;
 }
 
 /**
@@ -2998,6 +3439,21 @@ declare class UserData {
     /** Stores the authoritative points-track snapshot in the Quest event-token bucket. */
     patchQuestPointsTracks(tracks: Record<string, QuestPointsTrackView> | null | undefined): void;
     patchGroupCompletionClaimed(cycleID: string, groupCompletionID: string): void;
+    applyTutorial(data: UserTutorialState | null): void;
+    /**
+     * Fold a flow view returned by a mutating call into the cached state, so the game can read
+     * `state.Tutorial` right after the call without waiting for a refresh.
+     *
+     * Only the fields the view actually carries are written. `CurrentStep` is deliberately NOT
+     * stored: it is a copy of the CONFIG, and duplicating it into player state would give two
+     * sources of truth for the same step the moment the config changes.
+     */
+    patchTutorialFlow(view: TutorialFlowView | null | undefined): void;
+    /**
+     * Apply step progress the backend advanced by itself (Mode = SystemEvent), delivered on the
+     * response of whatever action caused it.
+     */
+    patchTutorialProgress(updates: readonly TutorialStepProgress[] | null | undefined): void;
     patchQuestProgressUpdates(updates: readonly QuestProgressUpdate[] | null | undefined): void;
     getQuestPointsProgress(cycleID: string): UserEventTokenProgress | null;
     applyActiveEvents(data: GetActiveEventsResponse | null): void;
@@ -3243,6 +3699,8 @@ declare class UserService {
     private baseRequest;
     private get configCache();
     private cache?;
+    private get localizationCache();
+    private locCache?;
     private get stateStore();
     private versionStore?;
     /**
@@ -3298,6 +3756,26 @@ declare class UserService {
      * refresh doesn't wipe the active board.
      */
     getClientStateExcept(excludeFields?: string[], excludeTitleFields?: string[]): Promise<OperationResult<ClientState>>;
+    /**
+     * Прикладывает к запросу локаль и версии уже сохранённых таблиц. Сервер по ним не станет
+     * присылать ссылки на то, что у клиента и так свежее.
+     *
+     * Локаль берётся из уже применённой (игрок мог переключить язык руками), иначе из настроек
+     * (по умолчанию — язык устройства). Пусто — сервер отдаст язык тайтла по умолчанию.
+     */
+    private prepareLocalization;
+    /**
+     * Достраивает таблицы переводов и отдаёт их `client.localization`.
+     *
+     * Порядок источников ТОТ ЖЕ, что у конфига тайтла, и по той же причине: хранилище (версия
+     * совпала) → CDN → эндпоинт телом → устаревшая локальная копия. Отличие одно, и оно
+     * принципиальное: **провал здесь игру НЕ роняет.** Конфига нет — играть не во что; переводов
+     * нет — интерфейс покажет ключи. Поэтому `applyState` зовётся при любом исходе.
+     */
+    private applyLocalization;
+    private resolveLocalizationTable;
+    private fetchLocalizationFromCdn;
+    private fetchLocalizationFromApi;
     /**
      * Только версии контейнеров — без единого байта данных.
      *
@@ -3350,7 +3828,7 @@ declare class ItemService {
      * Upgrade an item instance's level, optionally consuming fodder instances. On success the
      * server-authoritative inventory is re-fetched (mirrors the C# GetUserInventory call).
      */
-    upgradeLevel(itemInstanceID: string, fodderInstanceIDs?: readonly string[]): Promise<OperationResult<UpgradeItemLevelResponse>>;
+    upgradeLevel(itemInstanceID: string, fodderInstanceIDs?: readonly string[], selectedOptionID?: string): Promise<OperationResult<UpgradeItemLevelResponse>>;
     /**
      * Upgrade several item instances (+1 level each, or a multi-level/target-level upgrade per
      * ref) in one atomic operation. On success the server-authoritative inventory is re-fetched.
@@ -3362,7 +3840,17 @@ declare class ItemService {
 declare class StoreService {
     private readonly ctx;
     constructor(ctx: ClientContext);
-    purchase(offerID: string, count?: number): Promise<OperationResult<StorePurchaseResponse>>;
+    /**
+     * Buys an offer.
+     *
+     * `selectedOptionID` picks the way to pay; omitting it takes the first option available on this
+     * platform, which is what keeps single-price offers working without any client change.
+     * `payment` is required exactly when the chosen option is paid in a store — see CheckoutService.
+     */
+    purchase(offerID: string, count?: number, options?: {
+        selectedOptionID?: string;
+        payment?: PaymentProof;
+    }): Promise<OperationResult<StorePurchaseResponse>>;
     /** Buy several offers in one atomic operation. Each ref is `{ OfferID, Count }`. */
     purchaseBatch(purchases: StorePurchaseRef[]): Promise<OperationResult<PurchaseBatchResponse>>;
     getDefinitions(): Promise<OperationResult<StoreDefinitions>>;
@@ -3370,12 +3858,165 @@ declare class StoreService {
     private baseRequest;
 }
 
+/** What happens after a receipt is verified. */
+declare const IapProductType: {
+    readonly Consumable: "Consumable";
+    readonly NonConsumable: "NonConsumable";
+    readonly Subscription: "Subscription";
+};
+type IapProductType = (typeof IapProductType)[keyof typeof IapProductType];
+type IapProductRules = { StartUtc?: null | string; EndUtc?: null | string; Gate?: null | SegmentGate; Limits?: null | LimitSpec; [key: string]: unknown; };
+type IapProductDefinition = { ProductID?: null | string; Name?: null | string; Type?: null | 'Subscription' | 'Consumable' | 'NonConsumable'; Enabled?: null | boolean; StoreProductIDs?: null | Record<string, string>; Rewards?: null | ResourceGrant; PriceUsdCents?: null | number; Rules?: null | IapProductRules; AssetPaths?: null | Record<string, string>; CustomParams?: null | Record<string, string>; [key: string]: unknown; };
+type PurchaseDefinitions = { Enabled?: null | boolean; Products?: null | Record<string, IapProductDefinition>; [key: string]: unknown; };
+type IapProductPurchaseState = { ProductID?: null | string; TotalPurchases?: null | number; DailyPurchases?: null | number; DailyResetUtc?: null | string; LastPurchasedAt?: null | string; Owned?: null | boolean; [key: string]: unknown; };
+type UserPurchaseState = { Products?: null | Record<string, IapProductPurchaseState>; LifetimeSpendUsdCents?: null | number; [key: string]: unknown; };
+/** How the server treated the receipt. */
+declare const IapPurchaseStatus: {
+    readonly Granted: "Granted";
+    readonly Restored: "Restored";
+    readonly AlreadyProcessed: "AlreadyProcessed";
+};
+type IapPurchaseStatus = (typeof IapPurchaseStatus)[keyof typeof IapPurchaseStatus];
+type PurchaseValidationResponse = { ServerTimeUtc: string; Store?: null | 'GooglePlay' | 'AppleAppStore'; ProductID?: null | string; TransactionID?: null | string; Status?: null | 'Granted' | 'Restored' | 'AlreadyProcessed'; Granted?: null | boolean; Quantity?: null | number; Resources?: null | ResourceOperation; ProductState?: null | IapProductPurchaseState; [key: string]: unknown; };
+type PurchaseValidationBatchResponse = { ServerTimeUtc: string; Items: Array<{ Id: string; Success: boolean; Error?: null | string; Data?: null | PurchaseValidationResponse; }>; Resources?: null | ResourceOperation; };
+interface PurchaseReceiptRef {
+    Store?: IapStore;
+    Receipt?: string;
+    Signature?: string;
+    /** Only used when the receipt itself is opaque (legacy Apple app receipt). */
+    ProductID?: string;
+}
+interface PurchaseRequest extends BaseRequest {
+    Store?: IapStore;
+    Receipt?: string;
+    Signature?: string;
+    ProductID?: string;
+    /** ValidatePurchasesBatch: receipts to restore after a reinstall. */
+    Receipts?: PurchaseReceiptRef[];
+}
+type IapStore = 'GooglePlay' | 'AppleAppStore';
+declare const PurchaseAction: {
+    readonly GetDefinitions: "GetDefinitions";
+    readonly GetUserState: "GetUserState";
+    readonly ValidatePurchase: "ValidatePurchase";
+    readonly ValidatePurchasesBatch: "ValidatePurchasesBatch";
+};
+type PurchaseAction = (typeof PurchaseAction)[keyof typeof PurchaseAction];
+
+/**
+ * Real-money purchases (IAP) — the catalog of store products and receipt validation.
+ *
+ * The money is paid in the store BEFORE the server hears about it, so a refusal here is an
+ * incident, not "not enough funds": every refusal is recorded in the title's transaction ledger.
+ * That is also why the client must hand every receipt it receives to `validatePurchase`, including
+ * the ones the store re-delivers on startup — an order confirmed to the store but never delivered
+ * to us is a purchase the player paid for and will never get.
+ *
+ * This service covers products that ARE the goods. When a store product is used as the *price* of
+ * something else (an offer, a lootbox, a deal), the purchase goes through that module instead —
+ * see `CheckoutService`.
+ */
+declare class PurchaseService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /** Product catalog with per-player availability. */
+    getDefinitions(): Promise<OperationResult<PurchaseDefinitions>>;
+    /** Player's IAP state: per-product counters, ownership, lifetime spend. */
+    getUserState(): Promise<OperationResult<UserPurchaseState>>;
+    /**
+     * Verifies a receipt and grants the product.
+     *
+     * `productID` is only a hint for stores whose receipt is opaque (legacy Apple app receipt): in
+     * every other case the SKU is read from the receipt itself, because the client's claim about
+     * what was bought cannot be trusted.
+     */
+    validatePurchase(store: IapStore, receipt: string, options?: {
+        signature?: string;
+        productID?: string;
+    }): Promise<OperationResult<PurchaseValidationResponse>>;
+    /**
+     * Restores purchases after a reinstall: several receipts in one call.
+     *
+     * Non-consumables come back as `Restored` (ownership confirmed, nothing granted twice), while a
+     * consumable that never reached us is granted now.
+     */
+    validatePurchasesBatch(receipts: PurchaseReceiptRef[]): Promise<OperationResult<PurchaseValidationBatchResponse>>;
+}
+
+/** What a price option needs before it can be paid. */
+interface PaymentRequirement {
+    /** The option itself — pass its `OptionID` to the module that sells the entity. */
+    option: PriceOption;
+    /** `store` = a receipt is required; `resources` = the server charges the player's balances. */
+    kind: "store" | "resources";
+    /** IAP product to buy in the store. Set only when `kind` is `"store"`. */
+    productID?: string;
+    /** Crypto shortfall, if this option is paid with an on-chain currency the player is short on. */
+    shortfall?: CryptoShortfall;
+}
+/** How much of a crypto currency is missing to pay for an option. */
+interface CryptoShortfall {
+    currencyID: string;
+    /** Price of the option in that currency. */
+    required: number;
+    /** What the player currently holds in-game. */
+    available: number;
+    /** `required - available` — what a deposit has to cover. */
+    missing: number;
+}
+/**
+ * Helper layer over prices: which options this client may show, what each of them needs, and how
+ * much crypto is missing to pay one.
+ *
+ * It deliberately does NOT buy anything. Buying belongs to the module that owns the entity
+ * (`client.store.purchase`, `client.lootbox.open`, …), because only that module knows the rest of
+ * the request — count, target ids, idempotency key. This service answers the question that comes
+ * *before* the call: which option, and what does it need.
+ *
+ * Depositing crypto lives in `@idosgames/wallet`: `core` never imports a wallet stack, so a game
+ * that pays only with in-game currencies does not ship one.
+ */
+declare class CheckoutService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /** Platform this client reports to the server. */
+    get platform(): ClientPlatform;
+    /**
+     * Options this client may show, in the order the server would pick them (by `OptionID`).
+     *
+     * ⚠ Filtering here is what the player SEES. The server re-checks the platform when charging, so
+     * a hidden option cannot be paid anyway — but showing one that a store forbids is itself a
+     * policy violation, which is why the filter exists on the client at all.
+     */
+    availableOptions(options: PriceOptions | null | undefined): PriceOption[];
+    /** Is this option offered on the current platform? Empty `AllowedPlatforms` = everywhere. */
+    isAvailable(option: PriceOption | null | undefined): boolean;
+    /**
+     * What the option needs before it can be paid: a store receipt, or just the player's balances.
+     *
+     * For a crypto price it also reports the shortfall — the number a deposit has to cover. The
+     * balance comes from the cached player state, so it is as fresh as the last server response.
+     */
+    requirementOf(option: PriceOption): PaymentRequirement;
+    /** IAP product this option is paid with, or `null` when it is a resource price. */
+    storeProductOf(cost: ResourceConsume | null | undefined): string | null;
+    /**
+     * Crypto shortfall of a price, or `null` when the player can already afford it.
+     *
+     * Only the first crypto entry is reported: a price mixing two on-chain currencies would need two
+     * deposits, and no wallet flow does that in one go — such a price is a config mistake, not a
+     * case to paper over here.
+     */
+    cryptoShortfallOf(cost: ResourceConsume | null | undefined): CryptoShortfall | null;
+    private cryptoBalance;
+}
+
 /** Port of LootboxService.cs. */
 declare class LootboxService {
     private readonly ctx;
     constructor(ctx: ClientContext);
     getDefinitions(): Promise<OperationResult<LootboxDefinitionsResponse>>;
-    open(lootboxID: string, count: number, selectedOptionID: number): Promise<OperationResult<LootboxOpenResponse>>;
+    open(lootboxID: string, count: number, selectedOptionID?: string, payment?: PaymentProof): Promise<OperationResult<LootboxOpenResponse>>;
     private baseRequest;
 }
 
@@ -3397,6 +4038,194 @@ declare class RewardService {
     private baseRequest;
 }
 
+/**
+ * Onboarding: flows of ordered steps that the server hands out, gates and closes.
+ *
+ * Two things the game must know before using this:
+ *
+ * 1. **Not every step is yours to close.** `completeStep` works only for steps whose
+ *    `Completion.Mode` is `ClientAck` (or `Auto`, which closes on being shown). A `SystemEvent`
+ *    step is closed by the backend off a real game event — a board roll, a purchase, a chest
+ *    open — and calling `completeStep` on it is refused. Read `CurrentStep.Completion.Mode` from
+ *    the flow view and only offer a "Next" button when it is `ClientAck`.
+ * 2. **Progress can arrive on OTHER calls.** When a system-event step advances, the backend
+ *    attaches it to the response of the action that caused it, and the SDK applies it to the
+ *    cached state and emits `tutorial:systemProgress`. Subscribe to that instead of polling.
+ */
+declare class TutorialService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /** Flow and step definitions of the title (presets already resolved server-side). */
+    getTutorialDefinitions(): Promise<OperationResult<TutorialDefinitions>>;
+    /**
+     * Player state plus everything needed to draw the current step without a second call.
+     *
+     * @param autoStart Let the server start flows marked for auto-start. Pass `false` from a
+     * settings screen that merely lists tutorials — otherwise opening it would begin one.
+     */
+    getUserTutorialState(autoStart?: boolean): Promise<OperationResult<GetUserTutorialStateResponse>>;
+    /** Start a flow explicitly. Returns the flow with its first step. */
+    startFlow(flowID: string): Promise<OperationResult<TutorialFlowResponse>>;
+    /**
+     * Report that the step was shown to the player. Worth calling for every step: it is what the
+     * funnel measures time-on-step from, and a step with `Mode = Auto` closes on it.
+     */
+    reportStepShown(flowID: string, stepID: string): Promise<OperationResult<TutorialFlowResponse>>;
+    /**
+     * Close the current step by the player's acknowledgement.
+     * Refused for `SystemEvent`/`Composite` steps — those are closed by the game event itself.
+     */
+    completeStep(flowID: string, stepID: string): Promise<OperationResult<TutorialFlowResponse>>;
+    /**
+     * Close several steps of one flow, in order — for a client catching up after being offline.
+     * Steps are closed one by one: closing the third without the second stays impossible.
+     */
+    completeStepsBatch(flowID: string, stepIDs: string[]): Promise<OperationResult<TutorialFlowBatchResponse>>;
+    /** Skip one step (only if the step declares itself skippable). */
+    skipStep(flowID: string, stepID: string): Promise<OperationResult<TutorialFlowResponse>>;
+    /**
+     * Skip the whole flow. Allowed only when the flow is skippable AND the current step is at or
+     * past `Policy.SkippableFromOrder` — the flow view's `CanSkip` tells you whether to show the
+     * button at all.
+     */
+    skipFlow(flowID: string): Promise<OperationResult<TutorialFlowResponse>>;
+    /**
+     * Take the completion reward. Show this when the flow view reports `RewardPending`.
+     * A flow with `Reward.AutoClaim` pays out on its last step and never reports it pending.
+     */
+    claimFlowReward(flowID: string): Promise<OperationResult<TutorialClaimResponse>>;
+    /**
+     * Replay a flow. Only for flows whose `RestartPolicy` allows it; the reward is NOT granted
+     * again — the server keeps the claimed flag through the reset.
+     */
+    resetFlow(flowID: string): Promise<OperationResult<TutorialFlowResponse>>;
+    private flowCall;
+    private stepCall;
+    /**
+     * Fold the returned flow view into the cached player state. The view is authoritative for the
+     * fields it carries, so the game can read `client.data.user.state.Tutorial` right after the
+     * call without waiting for a state refresh.
+     */
+    private applyFlowView;
+    /**
+     * Batch and claim responses do not carry a flow view, so the cached state is re-read once.
+     * Silent: a failed refresh must not turn a successful claim into an error for the player.
+     */
+    private refreshAfterMutation;
+    private baseRequest;
+}
+
+/** Значения для подстановки в перевод: `{count}`, `{name}` и т.п. */
+type LocalizationParams = Record<string, string | number>;
+/**
+ * Локализация: перевод по ключу и загрузка таблиц.
+ *
+ * **Контракт резолва — `t(x) = своя таблица → запасная таблица → сам x`.** Последнее звено не
+ * запасной вариант на случай ошибки, а часть замысла: у существующих тайтлов в конфиге лежат
+ * готовые названия («Iron Sword» в `DisplayName`), и такой литерал — это просто ключ, для
+ * которого перевода не нашлось. Поэтому оборачивать в `t()` можно ВСЁ, включая строки из
+ * конфига, и ни один тайтл от этого не ломается.
+ *
+ * **Таблиц бывает две.** Свою локаль клиент качает всегда, запасную — только если своя
+ * переведена не полностью; решает это сервер и сообщает в `ClientState.Localization.Fallback`.
+ * У полностью переведённого языка файл один, и правки языка по умолчанию такому игроку ничего
+ * не стоят.
+ *
+ * Загрузкой занимается `UserService` на входе в игру — здесь только применение и чтение.
+ * Отдельно грузить ничего не надо; `setLocale` нужен, только когда язык меняет сам игрок.
+ */
+declare class LocalizationService {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private table;
+    private fallbackTable;
+    private currentLocale;
+    private currentFallbackLocale;
+    private pluralRules;
+    private get cache();
+    private tableCache?;
+    /**
+     * Локаль, на которой игра идёт СЕЙЧАС, — та, к которой сервер свёл запрошенную. `null`,
+     * пока состояние не загружено или если локализация у тайтла выключена.
+     *
+     * Смотреть надо сюда, а не в `settings.locale`: там пожелание, здесь факт.
+     */
+    get locale(): string | null;
+    /** Запасная локаль, если своя переведена не полностью. `null` — вторая таблица не нужна. */
+    get fallbackLocale(): string | null;
+    /**
+     * Языки, объявленные тайтлом, — для меню выбора. Берутся из конфига (там же лежат эндонимы),
+     * поэтому обращение к сети не нужно.
+     */
+    get locales(): LocalizationLocaleInfo[];
+    /** Есть ли перевод для ключа (в своей таблице или в запасной). */
+    has(key: string): boolean;
+    /**
+     * Перевод по ключу.
+     *
+     * Порядок: своя таблица → запасная → сам ключ (или то, что задано
+     * `MissingKeyMode` в конфиге тайтла).
+     *
+     * Множественное число: передайте `{ count }` — сервер хранит формы суффиксами
+     * (`items.count.one`, `.few`, `.many`, `.other`), а категорию выбирает `Intl.PluralRules`
+     * ПО ТЕКУЩЕЙ ЛОКАЛИ. Своей таблицы правил здесь нет намеренно: у русского их три, у
+     * польского четыре, у арабского шесть, и переписывать CLDR руками — верный способ разойтись
+     * с ним на редкой локали.
+     *
+     * Подстановка: `{name}` в переводе заменяется на `params.name`. Отсутствующий параметр
+     * оставляется как есть — видимый `{name}` на экране находится сразу, а молча пропавший
+     * кусок текста не находится никогда.
+     */
+    t(key: string, params?: LocalizationParams): string;
+    /**
+     * Применяет блок, приехавший в `GetClientState`. Зовётся `UserService`; вызывать вручную не
+     * нужно.
+     *
+     * Таблицы уже разрешены вызывающим (хранилище → CDN → эндпоинт), потому что порядок
+     * источников общий с конфигом тайтла и живёт там же.
+     */
+    applyState(state: LocalizationState | null | undefined, tables: {
+        table: Record<string, string> | null;
+        fallbackTable: Record<string, string> | null;
+    }): void;
+    /**
+     * Смена языка игроком.
+     *
+     * Идёт ЧЕРЕЗ ЭНДПОИНТ, а не через CDN, и это осознанно: ссылку на артефакт выдаёт только
+     * `GetClientState`, а тянуть ради смены языка полное состояние игрока дороже, чем один раз
+     * взять таблицу телом. Дальше она лежит в локальном хранилище и повторных загрузок не
+     * стоит.
+     *
+     * Запасная таблица догружается тем же способом, если сервер сообщил, что она нужна.
+     */
+    setLocale(locale: string): Promise<OperationResult<string>>;
+    /** Какие языки доступны и какие у их таблиц версии. Таблицы не качает. */
+    getManifest(): Promise<OperationResult<LocalizationManifestResponse>>;
+    private reset;
+    private setLocaleInternal;
+    private baseRequest;
+    /**
+     * Таблица телом + запись в локальное хранилище. Кэш проверяется ПЕРЕД запросом и
+     * приезжает в `KnownVersion`: совпала версия — сервер записи не шлёт, и таблица берётся с
+     * диска.
+     */
+    private loadTableFromApi;
+    /** Значение из своей таблицы, иначе из запасной. */
+    private lookup;
+    /**
+     * Ключ с учётом множественного числа. Без `count` — сам ключ; с ним — сначала форма для
+     * категории CLDR, потом `other`.
+     */
+    private resolveKey;
+    /**
+     * Категория множественного числа по текущей локали. `Intl.PluralRules` может бросить на
+     * некорректном языковом теге — тогда откатываемся к `other`: показать не ту форму хуже, чем
+     * не показать ничего, но уронить кадр из-за перевода нельзя.
+     */
+    private pluralCategory;
+    private onMissing;
+}
+
 /** Port of QuestService.cs. */
 declare class QuestService {
     private readonly ctx;
@@ -3478,6 +4307,14 @@ declare class SeasonService {
     getUserState(seasonChainID: string): Promise<OperationResult<UserSeasonStateResponse>>;
     grantStatusTokens(seasonChainID: string, amount: number): Promise<OperationResult<GrantStatusTokensResponse>>;
     claimTierReward(seasonChainID: string, tierNumber: number): Promise<OperationResult<ClaimTierRewardResponse>>;
+    /**
+     * Claims the rewards of several tiers in ONE atomic backend operation.
+     *
+     * Exists because tiers are reached in BATCHES — a single token grant can raise the player
+     * through several at once, leaving more than one reward unclaimed. The merged `Resources` is
+     * applied ONCE from the top level; per-item `Data.Resources` is null by contract.
+     */
+    claimTierRewardsBatch(seasonChainID: string, tierNumbers: number[]): Promise<OperationResult<ClaimTierRewardsBatchResponse>>;
     private baseRequest;
 }
 
@@ -3510,7 +4347,16 @@ declare class CharacterService {
     constructor(ctx: ClientContext);
     getCharacterDefinitions(): Promise<OperationResult<CharacterDefinitions>>;
     getUserCharacters(): Promise<OperationResult<GetCharactersResponse>>;
-    unlockCharacter(characterID: string): Promise<OperationResult<UnlockCharacterResponse>>;
+    /**
+     * Unlocks a character.
+     *
+     * `options.selectedOptionID` picks the way to pay; omitting it takes the first option available
+     * on this platform. `options.payment` is required exactly when that option is paid in a store.
+     */
+    unlockCharacter(characterID: string, options?: {
+        selectedOptionID?: string;
+        payment?: PaymentProof;
+    }): Promise<OperationResult<UnlockCharacterResponse>>;
     upgradeStatLevel(characterID: string, statID: string, opts?: UpgradeLevelsOptions): Promise<OperationResult<UpgradeStatLevelResponse>>;
     upgradeCharacterLevel(characterID: string, opts?: UpgradeLevelsOptions): Promise<OperationResult<UpgradeCharacterLevelResponse>>;
     equipItems(characterID: string, itemsToEquip: EquipSlotPair[]): Promise<OperationResult<EquipItemsResponse>>;
@@ -3552,7 +4398,7 @@ declare class CharacterService {
 declare class MatchService {
     private readonly ctx;
     constructor(ctx: ClientContext);
-    createMatch(entry: ResourceBundle, ruleID: string, characterID?: string, battleStrategy?: BattleStepConfig[], targetUserID?: string): Promise<OperationResult<CreateMatchResponse>>;
+    createMatch(entry: ResourceBundle, ruleID: string, characterID?: string, battleStrategy?: BattleStepConfig[], targetUserID?: string, selectedOptionID?: string): Promise<OperationResult<CreateMatchResponse>>;
     /** Edit an open match's own fields (e.g. privacy) before anyone joins. */
     updateMatch(matchID: string, fields?: {
         targetUserID?: string;
@@ -3587,8 +4433,19 @@ declare class CollectionService {
     constructor(ctx: ClientContext);
     getDefinitions(): Promise<OperationResult<CollectionDefinitions>>;
     getUserState(): Promise<OperationResult<UserCollectionState>>;
-    openPack(collectionID: string, packTypeID: string): Promise<OperationResult<OpenPackResponse>>;
-    openCollectionChest(collectionID: string, collectionChestID: string): Promise<OperationResult<OpenCollectionChestResponse>>;
+    /**
+     * Opens `count` packs in ONE atomic operation. The cost scales with the count and each pack
+     * is rolled against the state left by the previous one, so a collectible dropping twice in a
+     * row is correctly counted as a duplicate. `count` is clamped server-side to the configured
+     * ceiling (pack type → module setting → platform default); the response reports what actually
+     * happened in `OpenedCount` and breaks it down per pack in `Packs`.
+     */
+    openPack(collectionID: string, packTypeID: string, count?: number, options?: {
+        selectedOptionID?: string;
+        payment?: PaymentProof;
+    }): Promise<OperationResult<OpenPackResponse>>;
+    /** Opens `count` chests in ONE atomic operation. See openPack() for the multi-open contract. */
+    openCollectionChest(collectionID: string, collectionChestID: string, count?: number): Promise<OperationResult<OpenCollectionChestResponse>>;
     useCollectibleJoker(collectionID: string, collectibleID: string): Promise<OperationResult<UseCollectibleJokerResponse>>;
     claimSetReward(collectionID: string, setID: string): Promise<OperationResult<ClaimSetRewardResponse>>;
     /** Claim rewards for several completed sets in one atomic operation (deduped by SetID). */
@@ -3612,7 +4469,14 @@ declare class CoopEventService {
     getUserState(): Promise<OperationResult<CoopUserStateResponse>>;
     getGroupState(groupID: string): Promise<OperationResult<CoopGroupStateResponse>>;
     joinOrCreateGroup(coopChainID: string): Promise<OperationResult<CoopGroupStateResponse>>;
-    spin(coopChainID: string, groupID: string): Promise<OperationResult<CoopSpinResponse>>;
+    /**
+     * Spins the wheel `count` times in ONE atomic operation.
+     *
+     * Only spins that actually happen are charged: the run stops at the spin that completes the
+     * object, and the remainder is neither rolled nor billed — check `SpinsUsed` against
+     * `RequestedSpins`. `count` is clamped server-side to `MaxSpinsPerCall`.
+     */
+    spin(coopChainID: string, groupID: string, count?: number, selectedOptionID?: string): Promise<OperationResult<CoopSpinResponse>>;
     claimObjectReward(groupID: string): Promise<OperationResult<CoopClaimRewardResponse>>;
     claimGrandPrize(groupID: string): Promise<OperationResult<CoopClaimRewardResponse>>;
     leaveGroup(groupID?: string): Promise<OperationResult<CoopLeaveGroupResponse>>;
@@ -3627,7 +4491,17 @@ declare class DealOfferService {
     getUserState(): Promise<OperationResult<UserDealOffersStateResponse>>;
     getActiveDeals(): Promise<OperationResult<GetActiveDealsResponse>>;
     dismissDeal(slotID: string): Promise<OperationResult<DismissDealResponse>>;
-    executeNode(slotID: string, nodeID: string, externalRefID?: string): Promise<OperationResult<ExecuteNodeResponse>>;
+    /**
+     * Executes a node of an active deal.
+     *
+     * `options.selectedOptionID` picks the way to pay the node; `options.payment` carries the store
+     * receipt and is required exactly when that option is paid in a store — the main monetization
+     * path of deal offers.
+     */
+    executeNode(slotID: string, nodeID: string, externalRefID?: string, options?: {
+        selectedOptionID?: string;
+        payment?: PaymentProof;
+    }): Promise<OperationResult<ExecuteNodeResponse>>;
     recordShow(slotID: string): Promise<OperationResult<RecordShowResponse>>;
     claimMilestone(slotID: string, milestoneID: string): Promise<OperationResult<ClaimDealMilestoneResponse>>;
     claimMilestonesBatch(slotID: string, milestoneIDs: string[]): Promise<OperationResult<ClaimDealMilestonesBatchResponse>>;
@@ -3642,6 +4516,15 @@ declare class ReferralService {
     getUserState(): Promise<OperationResult<UserReferralStateResponse>>;
     activateReferralCode(referralCode: string): Promise<OperationResult<ActivateReferralCodeResponse>>;
     claimInviteReward(inviteRewardID: string): Promise<OperationResult<ClaimInviteRewardResponse>>;
+    /**
+     * Claims several invite milestones in ONE atomic backend operation.
+     *
+     * The merged `Resources` of the batch is applied ONCE from the top level — per-item
+     * `Data.Resources` is null by contract, so applying both would double count the grant.
+     * Invalid items (unknown / not reached / already claimed) come back as failed elements
+     * without dropping the rest of the batch.
+     */
+    claimInviteRewardsBatch(inviteRewardIDs: string[]): Promise<OperationResult<ClaimInviteRewardsBatchResponse>>;
     private baseRequest;
 }
 
@@ -3667,7 +4550,10 @@ declare class TimedBoostService {
     getDefinitions(): Promise<OperationResult<TimedBoostDefinitions>>;
     getActive(): Promise<OperationResult<GetActiveTimedBoostsResponse>>;
     getActiveWindows(): Promise<OperationResult<GetActiveBoostWindowsResponse>>;
-    activate(boostID: string): Promise<OperationResult<ActivateTimedBoostResponse>>;
+    activate(boostID: string, options?: {
+        selectedOptionID?: string;
+        payment?: PaymentProof;
+    }): Promise<OperationResult<ActivateTimedBoostResponse>>;
     cleanupExpired(): Promise<OperationResult<SuccessResponse>>;
     private baseRequest;
 }
@@ -3758,7 +4644,7 @@ declare class GameLoopService {
     boardLoopRaid(digIndex: number, existingRelatedEntityID?: string): Promise<OperationResult<RaidResponse>>;
     boardLoopRaidFast(digIndices: number[]): Promise<OperationResult<RaidResponse>>;
     boardLoopBuild(buildingIndex: number): Promise<OperationResult<BuildResponse>>;
-    boardSpecialChoose(choiceID: string): Promise<OperationResult<SpecialChooseResponse>>;
+    boardSpecialChoose(choiceID: string, selectedOptionID?: string): Promise<OperationResult<SpecialChooseResponse>>;
     boardSpecialApplyMultiplier(existingRelatedEntityID?: string): Promise<OperationResult<SpecialApplyMultiplierResponse>>;
     boardSpecialClaim(): Promise<OperationResult<SpecialClaimResponse>>;
     /** Fetch this player's Community Chest state (active group, if any) + seconds remaining. */
@@ -3818,7 +4704,7 @@ declare class MarketplaceService {
     getBuyOrders(itemID?: string, continuationToken?: string, pageSize?: number): Promise<OperationResult<MarketplaceBrowseResponse>>;
     getMyState(): Promise<OperationResult<MarketplaceMyStateResponse>>;
     getHistory(continuationToken?: string, pageSize?: number): Promise<OperationResult<MarketplaceHistoryResponse>>;
-    createListing(itemID: string, catalogID: string, goodsAmount: number, priceBundle: ResourceBundle, durationHours: number, itemInstanceIDs?: string[]): Promise<OperationResult<MarketplaceCreateOfferResponse>>;
+    createListing(itemID: string, catalogID: string, goodsAmount: number, priceBundle: ResourceBundle, durationHours: number, itemInstanceIDs?: string[], selectedOptionID?: string): Promise<OperationResult<MarketplaceCreateOfferResponse>>;
     cancelListing(offerID: string): Promise<OperationResult<MarketplaceSettlementResponse>>;
     buy(offerID: string): Promise<OperationResult<MarketplaceSettlementResponse>>;
     /** Immediate-or-cancel market buy against the best matching active Listing (no resting order left behind on miss). */
@@ -3840,6 +4726,8 @@ declare class MarketplaceService {
         bidCatalogID?: string;
         bidItemID?: string;
         itemInstanceIDs?: string[];
+        /** Way to pay the listing fee (`PriceOption.OptionID`). */
+        selectedOptionID?: string;
     }): Promise<OperationResult<MarketplaceCreateOfferResponse>>;
     placeBid(offerID: string, bidAmount: number): Promise<OperationResult<MarketplacePlaceBidResponse>>;
     /** Role-dependent lazy finalization: winner claims goods, seller claims proceeds (net). */
@@ -3971,6 +4859,17 @@ declare class StoreApi {
     getUserState(request: StoreRequest): Promise<OperationResult<UserStoreState>>;
 }
 
+/** Thin transport wrapper for the Purchase feature (port of PurchaseAPI.cs). */
+declare class PurchaseApi {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private send;
+    getDefinitions(request: PurchaseRequest): Promise<OperationResult<PurchaseDefinitions>>;
+    getUserState(request: PurchaseRequest): Promise<OperationResult<UserPurchaseState>>;
+    validatePurchase(request: PurchaseRequest): Promise<OperationResult<PurchaseValidationResponse>>;
+    validatePurchasesBatch(request: PurchaseRequest): Promise<OperationResult<PurchaseValidationBatchResponse>>;
+}
+
 /** Thin transport wrapper for the Lootbox feature (port of LootboxAPI.cs). */
 declare class LootboxApi {
     private readonly ctx;
@@ -3994,6 +4893,40 @@ declare class RewardApi {
     claimReward(request: RewardRequest): Promise<OperationResult<ClaimRewardResponse>>;
 }
 
+/** Thin transport wrapper for the Tutorial feature (port of TutorialV2). */
+declare class TutorialApi {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private send;
+    getTutorialDefinitions(request: TutorialRequest): Promise<OperationResult<TutorialDefinitions>>;
+    getUserTutorialState(request: TutorialRequest): Promise<OperationResult<GetUserTutorialStateResponse>>;
+    startFlow(request: TutorialRequest): Promise<OperationResult<TutorialFlowResponse>>;
+    reportStepShown(request: TutorialRequest): Promise<OperationResult<TutorialFlowResponse>>;
+    completeStep(request: TutorialRequest): Promise<OperationResult<TutorialFlowResponse>>;
+    completeStepsBatch(request: TutorialRequest): Promise<OperationResult<TutorialFlowBatchResponse>>;
+    skipStep(request: TutorialRequest): Promise<OperationResult<TutorialFlowResponse>>;
+    skipFlow(request: TutorialRequest): Promise<OperationResult<TutorialFlowResponse>>;
+    claimFlowReward(request: TutorialRequest): Promise<OperationResult<TutorialClaimResponse>>;
+    resetFlow(request: TutorialRequest): Promise<OperationResult<TutorialFlowResponse>>;
+}
+
+/** Thin transport wrapper for the Localization feature (port of LocalizationV2). */
+declare class LocalizationApi {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private send;
+    /** Which languages exist and what their table versions are. Downloads no table. */
+    getLocalizationManifest(request: LocalizationRequest): Promise<OperationResult<LocalizationManifestResponse>>;
+    /**
+     * A translation table in the response body.
+     *
+     * This is the FALLBACK path: the main one is the immutable CDN artifact referenced by
+     * `ClientState.Localization.Url`. Coming here is normal (first player after a translation
+     * edit, blocked CDN, a manual language switch) — it just costs one more round trip.
+     */
+    getLocalizationTable(request: LocalizationRequest): Promise<OperationResult<LocalizationTableResponse>>;
+}
+
 /** Thin transport wrapper for the Quest feature (port of QuestAPI.cs). */
 declare class QuestApi {
     private readonly ctx;
@@ -4059,6 +4992,7 @@ declare class SeasonApi {
     getUserState(request: SeasonRequest): Promise<OperationResult<UserSeasonStateResponse>>;
     grantStatusTokens(request: SeasonRequest): Promise<OperationResult<GrantStatusTokensResponse>>;
     claimTierReward(request: SeasonRequest): Promise<OperationResult<ClaimTierRewardResponse>>;
+    claimTierRewardsBatch(request: SeasonRequest): Promise<OperationResult<ClaimTierRewardsBatchResponse>>;
 }
 
 /** Thin transport wrapper for the Premium feature (port of PremiumAPI.cs). */
@@ -4176,6 +5110,7 @@ declare class ReferralApi {
     getUserState(request: ReferralRequest): Promise<OperationResult<UserReferralStateResponse>>;
     activateReferralCode(request: ReferralRequest): Promise<OperationResult<ActivateReferralCodeResponse>>;
     claimInviteReward(request: ReferralRequest): Promise<OperationResult<ClaimInviteRewardResponse>>;
+    claimInviteRewardsBatch(request: ReferralRequest): Promise<OperationResult<ClaimInviteRewardsBatchResponse>>;
 }
 
 /** Thin transport wrapper for the Social feature (port of SocialAPI.cs). */
@@ -4347,6 +5282,11 @@ declare class MultiplayerApi {
 interface IDosGamesClientConfig extends SettingsInput {
     /** Platform adapter (defaults to BrowserPlatformAdapter). Inject NoopPlatformAdapter in tests. */
     platform?: PlatformAdapter;
+    /**
+     * Platform reported to the server (`X-IG-Platform`). Auto-detected when omitted; set it
+     * explicitly in a native wrapper — the wrapper knows for certain, sniffing does not.
+     */
+    clientPlatform?: ClientPlatform;
     /** Custom fetch (defaults to global fetch). Inject a mock in tests. */
     fetch?: typeof fetch;
     /** Override the per-endpoint throttle window (ms). Default 600. */
@@ -4361,6 +5301,8 @@ declare class ClientContext {
     readonly settings: IDosGamesSettings;
     readonly emitter: TypedEmitter<SdkEvents>;
     readonly platform: PlatformAdapter;
+    /** Platform reported to the server; services read it to filter payment options. */
+    readonly clientPlatform: ClientPlatform;
     readonly data: IDosGamesData;
     readonly authStore: AuthStore;
     readonly api: {
@@ -4369,9 +5311,12 @@ declare class ClientContext {
         currency: CurrencyApi;
         item: ItemApi;
         store: StoreApi;
+        purchase: PurchaseApi;
         lootbox: LootboxApi;
         reward: RewardApi;
         quest: QuestApi;
+        tutorial: TutorialApi;
+        localization: LocalizationApi;
         timedEvent: TimedEventApi;
         leaderboard: LeaderboardApi;
         season: SeasonApi;
@@ -4399,9 +5344,13 @@ declare class ClientContext {
     readonly currency: CurrencyService;
     readonly item: ItemService;
     readonly store: StoreService;
+    readonly purchase: PurchaseService;
+    readonly checkout: CheckoutService;
     readonly lootbox: LootboxService;
     readonly reward: RewardService;
     readonly quest: QuestService;
+    readonly tutorial: TutorialService;
+    readonly localization: LocalizationService;
     readonly timedEvent: TimedEventService;
     readonly leaderboard: LeaderboardService;
     readonly season: SeasonService;
@@ -4443,9 +5392,23 @@ declare class IDosGamesClient {
     get currency(): CurrencyService;
     get item(): ItemService;
     get store(): StoreService;
+    /** Real-money purchases: the store product catalog and receipt validation. */
+    get purchase(): PurchaseService;
+    /**
+     * Price options: what this client may show, what each option needs, how much crypto is missing.
+     * Buying itself stays in the module that owns the entity — see the service docs.
+     */
+    get checkout(): CheckoutService;
     get lootbox(): LootboxService;
     get reward(): RewardService;
     get quest(): QuestService;
+    /** Onboarding flows: start, advance, skip and claim tutorial steps. */
+    get tutorial(): TutorialService;
+    /**
+     * Переводы: `t(key)` и смена языка. Загружать ничего не нужно — таблицы приезжают вместе с
+     * состоянием на входе в игру.
+     */
+    get localization(): LocalizationService;
     get timedEvent(): TimedEventService;
     get leaderboard(): LeaderboardService;
     get season(): SeasonService;
@@ -4583,4 +5546,46 @@ type MailboxMessageDocument = { MessageID?: null | string; TitleID?: null | stri
 type MailboxBroadcastDocument = { BroadcastID?: null | string; TitleID?: null | string; MessageTypeID?: null | string; Subject?: null | string; Body?: null | string; TemplateParams?: null | Record<string, string>; AssetPaths?: null | Record<string, string>; Rewards?: null | ResourceGrant; TargetSegmentID?: null | string; TargetUserIDs?: null | Array<string>; StartsAtUtc?: null | string; ExpiresAtUtc?: null | string; CreatedAtUtc?: null | string; CreatedByAdminID?: null | string; AdminComment?: null | string; Status?: null | 'Active' | 'Completed' | 'Cancelled' | 'Paused'; DeliveredCount?: null | number; ClaimedCount?: null | number; [key: string]: unknown; };
 type UserMailboxState = { UnreadCount?: null | number; UnclaimedRewardCount?: null | number; LastFetchCursor?: null | string; ReceivedBroadcastIDs?: null | Array<string>; ClaimedBroadcastIDs?: null | Array<string>; DailyP2PGiftsSent?: null | number; DailyGiftsResetDate?: null | string; LastOpenedAtUtc?: null | string; TotalMessagesReceived?: null | number; TotalRewardsClaimed?: null | number; [key: string]: unknown; };
 
-export { type AcceptTradeOfferResponse, type ActivateReferralCodeResponse, type ActivateTimedBoostResponse, type ActiveBoostWindowInfo, type ActiveCoopEventInfo, type ActiveDealSlotInfo, type ActiveEventInfo, type ActiveSeasonInfo, type ActiveTimedBoost, type AdConsentSettings, type AdConsentState, type AdCreditsData, type AdDailyData, type AdFraudFlags, type AdFrequencyCappingSettings, type AdPendingRequest, type AdPlacementDefinition, type AdPlacementUserState, type AdProviderDefinition, type AdSessionData, AdType, type AdUnitConfig, type AdVerificationSettings, type AddQuestProgressResponse, type AdvertisingDefinitions, type AppOpenSettings, AttackOutcome, type AttackResponse, type AttributionInput, type AuthContext, AuthType, AuthenticationAction, type AuthenticationRequest, AuthenticationService, BannerPosition, type BannerSettings, type BaseRequest, type BatchDeleteUserCustomDataResponse, type BatchGetPublicUserCustomDataResponse, type BatchItemResult, type BatchResponse, type BatchSetUserCustomDataResponse, type BattleResult, type BattleStepConfig, type BlockchainAccountSafetyPolicy, BlockchainAction, type BlockchainConfigResponse, type BlockchainDefinitions, type BlockchainNetworkDefinition, BlockchainNetworkType, type BlockchainNftCollectionBinding, BlockchainOperationCategory, type BlockchainRequest, BlockchainService, type BlockchainStats, type BlockchainSystemState, BlockchainTransactionStatus, BlockchainTransactionType, type BoardLoopDefinition, type BoardLoopState, type BoardPendingInteraction, type BoardRollResponse, BodyPart, type BoostTriggerCounter, BoostWindowKind, BroadcastStatus, type BuildResponse, type BuildingState, type CancelMatchResponse, type CancelTradeOfferResponse, type ChangeUsernameResponse, CharacterAction, type CharacterClassification, type CharacterDefinition, type CharacterDefinitions, type CharacterEquipment, type CharacterEquipmentSlot, type CharacterIdentity, type CharacterLevelDefinition, type CharacterLevelRef, type CharacterModel, type CharacterRequest, CharacterService, type CharacterStatRef, type CharacterUnequipResult, type CharacterUnlock, type ClaimAllRewardsBatchResponse, type ClaimAllRewardsResult, type ClaimComebackRewardResponse, type ClaimCycleRewardResponse, type ClaimCycleRewardsBatchResponse, type ClaimDailyRewardResponse, type ClaimDealMilestoneResponse, type ClaimDealMilestonesBatchResponse, type ClaimGrandPrizeResponse, type ClaimGroupCompletionRewardResponse, type ClaimInviteRewardResponse, type ClaimLeaderboardMilestoneResponse, type ClaimLeaderboardMilestonesBatchResponse, type ClaimMilestoneRewardResponse, type ClaimMilestoneRewardsBatchResponse, type ClaimMilestonesBatchResponse, type ClaimQuestRewardResponse, type ClaimQuestRewardsBatchResponse, type ClaimRewardResponse, type ClaimSetRewardResponse, type ClaimSetRewardsBatchResponse, type ClaimTierRewardResponse, type ClientState, CloudCodeAction, CloudCodeErrorCode, type CloudCodeLogEntry, CloudCodeLogLevel, type CloudCodeRequest, CloudCodeRevisionSelection, CloudCodeService, type CodeExecutionError, type CollectIdleAccrualResponse, CollectionAction, type CollectionDefinitions, type CollectionRequest, CollectionService, type CollectionSetRef, type CollectionTradeOfferDocument, CommissionSink, type CommunityChestClaimResponse, type CommunityChestGroupDocument, type CommunityChestGroupStateResponse, type CommunityChestHistoryEntry, type CommunityChestLeaveResponse, type CommunityChestMember, CommunityChestMemberStatus, type CommunityChestSharedState, CommunityChestStatus, type CommunityChestUserStateResponse, type ConfirmWithdrawalResponse, type ConversionDailyCounter, ConversionRateMode, type ConversionTarget, type ConvertResponse, type CoopBuildObjectsMemberState, type CoopBuildObjectsState, type CoopClaimRewardResponse, CoopEventAction, type CoopEventDefinitions, type CoopEventRequest, CoopEventService, type CoopGroupDocument, type CoopGroupMember, type CoopGroupStateResponse, CoopGroupStatus, type CoopLeaveGroupResponse, CoopMemberStatus, type CoopPartnerObjectState, type CoopSpinResponse, type CoopUserStateResponse, CraftAction, type CraftDefinitions, type CraftDefinitionsResponse, type CraftRequest, type CraftResponse, CraftService, type CraftSingleResult, CraftType, type CreateMatchResponse, type CryptoConvertResponse, type CryptoCurrencyDefinition, type CryptoCurrencyPermissions, type CryptoLimits, type CryptoNetworkBinding, CurrencyAction, type CurrencyAudit, type CurrencyConversion, type CurrencyDefinitions, type CurrencyRequest, CurrencyService, CurrencyStatus, CurrencyType, CustomDataBucket, CustomDataValueType, CustomDataWriter, type CyclicSchedule, DEFAULT_BASE_URL, type DailyUsageRecord, type DealMilestoneProgressInfo, DealNodeRuntimeStatus, DealOfferAction, DealOfferActivationStatus, type DealOfferDefinitions, type DealOfferRequest, DealOfferService, type DealOffersDefinitionResponse, type DeclineTradeOfferResponse, type DepositNFTResponse, type DepositTokenResponse, type DismissDealResponse, type DonationResponse, EnvelopeType, type EquipItemsResponse, type EquipSlotPair, type EquipmentPreset, type EquipmentSlot, type EquippedItem, type EventMap, type EventMilestoneClaimResponse, type EventTokenAddress, type EventTokenConversion, type EventTokenDefinition, type EventTokenGrantResponse, type EventTokenOperation, type EventTokenSpendResponse, EventTokenType, type ExecuteCloudCodeResponse, type ExecuteNodeResponse, type ExperimentDefinition, type ExperimentDefinitions, type ExperimentVariant, type ExperimentVariantCondition, type FodderConsumedEntry, FodderSelectionMode, FodderValuationMode, type FriendActionResponse, FriendActionStatus, type FriendPublicProfile, type FriendsListResponse, GameLoopAction, type GameLoopDefinitions, type GameLoopRequest, GameLoopService, type GetActiveBoostWindowsResponse, type GetActiveDealsResponse, type GetActiveEventsResponse, type GetActiveTimedBoostsResponse, type GetCharactersResponse, type GetLeaderboardResponse, type GetLeaderboardsBatchResponse, type GetMatchDefinitionsResponse, type GetMilestoneRewardMultiplierResponse, type GetMyProgressResponse, type GetMyUserCustomDataResponse, type GetOverviewBatchResponse, type GetProgressBatchResponse, type GetPublicTitleDataResponse, type GetPublicUserCustomDataResponse, type GetTradeOffersResponse, type GetUserQuestStateResponse, type GrantStatusTokensResponse, type GrantTokensBatchResponse, type GrantedCollectible, type HeistCell, IDosGamesClient, type IDosGamesClientConfig, IDosGamesData, type IDosGamesSettings, type IceServer, type InstantBattleDefinitions, type InstantBattleResponse, type InstantBattleRule, type InterstitialSettings, type InventoryDelta, ItemAction, type ItemCatalog, type ItemDefinition, type ItemDefinitions, type ItemEquipment, type ItemMetadata, type ItemRequest, ItemService, type ItemStats, type ItemTotals, type ItemUpgrade, type ItemUpgradeFodder, type ItemUpgradeRef, type JsonValue, KeyValueStorage, KycStatus, KycTier, LeaderboardAction, type LeaderboardDefinitions, type LeaderboardMilestoneRef, type LeaderboardOverview, type LeaderboardRequest, type LeaderboardScoreRef, LeaderboardService, type LeaderboardUserEntry, type LeaveRoomResponse, type LevelsPreset, type LimitSpec, type LinkedWalletInfo, type Listener, LootboxAction, type LootboxAmountRange, type LootboxDefinitions, type LootboxDefinitionsResponse, type LootboxOpenResponse, type LootboxPityRule, type LootboxPityTriggerResponse, type LootboxRequest, type LootboxRewardRoll, type LootboxRewardSlot, LootboxService, type LootboxSupplyRule, type MailboxBroadcastDocument, type MailboxDefinition, type MailboxMessageDocument, MailboxMessageSource, MailboxMessageStatus, type MailboxMessageTypeDefinition, type MailboxSegmentDefinition, MarketGoodsType, MarketOfferStatus, MarketOfferType, MarketplaceAction, type MarketplaceActionCounter, type MarketplaceAuctionSettings, type MarketplaceAuctionState, type MarketplaceBidRefund, type MarketplaceBrowseResponse, type MarketplaceBuyOrderSettings, type MarketplaceCommissionOverride, type MarketplaceCommissionPolicy, type MarketplaceCreateOfferResponse, type MarketplaceDefinitions, type MarketplaceDirectTradeSettings, type MarketplaceGetDefinitionsResponse, type MarketplaceGroupedOfferView, type MarketplaceGroupedOffersResponse, type MarketplaceHistoryEntryView, type MarketplaceHistoryResponse, type MarketplaceListingSettings, type MarketplaceMatchingSettings, type MarketplaceMyStateResponse, type MarketplaceOfferResponse, type MarketplaceOfferView, type MarketplacePlaceBidResponse, type MarketplacePricePolicy, type MarketplaceRequest, MarketplaceService, type MarketplaceSettlementResponse, type MarketplaceTradabilityPolicy, MatchAction, type MatchDefinitions, type MatchRequest, MatchService, MatchStatus, type MatchesPageResponse, type MilestoneClaimRef, type MilestoneDefinition, MultiplayerAction, MultiplayerChatMode, type MultiplayerDefinitions, type MultiplayerRequest, MultiplayerService, type MultiplayerSystemState, MultiplayerTopology, type NFTModel, type NFTNetworkBinding, type NFTTransactionDocument, type NFTWithdrawalResponse, type NftCollectionStats, type NftStatsContainer, type OpenCollectionChestResponse, type OpenPackResponse, type OperationFailure, type OperationFailureReason, type OperationResult, type OperationSuccess, type PendingWithdrawalRef, PlatformAdapter, type PlatformBlockchainState, type PlatformLoginResponse, type PlayerEconomyTuningState, type PollResponse, PremiumAction, type PremiumAdReduction, type PremiumDefinitions, type PremiumDefinitionsResponse, type PremiumPurchaseResponse, type PremiumRequest, PremiumService, type PremiumStateResponse, type PremiumSubscription, type PublishResponse, type PurchaseBatchResponse, type PvPMatch, QuestAction, type QuestAvailability, type QuestClaimRef, type QuestCycleDefinition, type QuestDefinition, type QuestDefinitions, type QuestGroupCompletionDefinition, type QuestIdentity, type QuestLinking, type QuestObjectiveDefinition, QuestObjectiveSource, type QuestPhaseDefinition, type QuestPointsTrackView, QuestPrerequisiteMode, type QuestPresetBindings, type QuestPresetRegistry, type QuestProgressUpdate, type QuestRequest, type QuestReward, QuestService, QuestStatus, RaidMode, type RaidResponse, type RealtimeEnvelope, type RechargeConfig, type RecordShowResponse, ReferralAction, type ReferralDefinitions, type ReferralDefinitionsResponse, type ReferralInviteRewardState, type ReferralRequest, ReferralService, type RelativeWindow, type ResourceBundle, type ResourceConsume, type ResourceDualPartyResult, type ResourceEntry, ResourceEntryType, type ResourceGrant, type ResourceOperation, type ResourceTransferResult, type RetryWithdrawalResponse, RewardAction, type RewardDefinitions, type RewardDefinitionsResponse, type RewardRequest, RewardService, type RewardedVideoSettings, type RollActionData, type RoomListItem, type RoomMemberView, type RoomSnapshotResponse, RoomVisibility, type RoomsPageResponse, type ScheduleChain, type ScheduleChainPhase, ScheduleMode, type ScheduleSpec, type ScheduledWindow, type SdkEvents, SeasonAction, type SeasonDefinitions, type SeasonRequest, SeasonService, type SeasonTierRewardBundle, type SeasonTierRewardMultiplier, type SeasonTierRewardSet, type SegmentGate, type SendTradeOfferResponse, type SetUserCustomDataResponse, type SettingsInput, SocialAction, type SocialRequest, SocialService, type SocialTimelineEvent, type SolanaWithdrawalSignature, type SpecialApplyMultiplierResponse, SpecialChoiceMode, type SpecialChooseResponse, type SpecialClaimResponse, type SpecialModeOfferData, type SpecialPendingState, type SpendRewardDefinition, type SpendTokensBatchResponse, type SsoCodeFromUrl, type StatDefinition, type StatRequirement, type StatsPreset, StoreAction, type StoreDefinitions, type StorePurchaseRef, type StorePurchaseResponse, type StorePurchaseState, type StoreRequest, StoreService, StoreType, type SubmitScoreResponse, type SubmitScoresBatchResponse, type SuccessResponse, TimedBoostAction, type TimedBoostDefinitions, type TimedBoostRequest, TimedBoostService, TimedBoostStackingPolicy, TimedEventAction, type TimedEventDefinitions, type TimedEventGrantRef, type TimedEventInstanceRef, type TimedEventMilestoneRef, type TimedEventRequest, TimedEventService, type TimedEventSpendRef, TimelineEventType, type TimelineResponse, TitleAction, TitleConfig, TitleCustomDataAction, type TitleCustomDataDefinitions, type TitleCustomDataKeyDefinition, type TitleCustomDataRecord, type TitleCustomDataRequest, TitleCustomDataService, TitleDataBucket, TitleDataScope, type TitlePublicConfigurationModel, type TitleRequest, TitleService, type TokenCurrencyStats, type TokenStatsContainer, type TokenTransactionDocument, type TokenWithdrawalResponse, TradeOfferStatus, TransactionDirection, type TransactionHistoryResponse, type TriggerContext, type TriggerSource, TypedEmitter, type UnequipAllCharactersResponse, type UnequipItemsResponse, type UnlockCharacterResponse, type UnlockCharactersBatchResponse, type UnstackableItemInstanceState, type Unsubscribe, type UpdateMatchResponse, type UpgradeCharacterLevelResponse, type UpgradeCharacterLevelsBatchResponse, type UpgradeItemLevelResponse, type UpgradeLevelsBatchResponse, type UpgradeLevelsOptions, type UpgradeStatLevelResponse, type UpgradeStatLevelsBatchResponse, type UsageReactivationEvent, type UsageTimeStats, type UseCollectibleJokerResponse, UserAction, type UserAdvertisingState, type UserBlockchainState, type UserBlockchainStateResponse, type UserCharactersState, type UserClaimRewardState, type UserCollectionState, type UserComebackState, type UserCommunityChestState, type UserCoopEventState, type UserCryptoComplianceCounters, type UserCryptoCurrencyState, UserCustomDataAction, type UserCustomDataBatchDeleteItem, type UserCustomDataBatchSetItem, type UserCustomDataDefinitions, type UserCustomDataKeyDefinition, type UserCustomDataRecord, type UserCustomDataRequest, UserCustomDataService, type UserCustomDataState, type UserDailyCalendarState, type UserDailyCounters, UserData, type UserDealNodeLifetimeCounts, type UserDealNodeState, type UserDealOfferActivationState, type UserDealOfferHistory, type UserDealOffersState, type UserDealOffersStateResponse, type UserDealSlotState, type UserDealTrackState, type UserDepositAddress, type UserEventTokenProgress, type UserEventTokensState, type UserGameLoopsState, type UserIdleAccrualState, type UserInventoryState, type UserKycState, type UserLeaderboardProgress, type UserLeaderboardsState, type UserLootboxPityCounter, type UserLootboxState, type UserMailboxState, type UserMarketplaceState, type UserMatchCreationLimitState, type UserMatchState, type UserPremiumState, type UserPublicDataModel, type UserQuestCycleState, type UserQuestObjectiveProgress, type UserQuestProgress, type UserQuestState, type UserReferralState, type UserReferralStateResponse, type UserRequest, type UserRewardState, type UserRewardsStateResponse, type UserSeasonState, type UserSeasonStateResponse, type UserSeasonsState, UserService, type UserSocialState, type UserState, type UserStateSlice, type UserStateVersions, type UserStoreState, type UserTimedBoostsState, type UserTimedEventStateResponse, type UserUsageState, type UserVirtualCurrencyState, type VirtualCurrencyDefinition, type VirtualCurrencyEconomy, type VirtualCurrencyPermissions, type WalletChallengeResponse, WalletLinkType, type WithdrawalSignatureResponse, type WithdrawalSplit, beginSsoRedirect, createIDosGamesClient, isFail, isOk, normalizeBlockchainCategory, readSsoCodeFromUrl };
+/** Что лежит в хранилище: версия таблицы и сама плоская таблица. */
+interface StoredLocalizationTable {
+    v: number;
+    t: Record<string, string>;
+}
+/**
+ * Таблицы переводов, переживающие перезапуск игры.
+ *
+ * Механика та же, что у `TitleConfigCache`, с одним отличием: запись на ЛОКАЛЬ, а не на набор
+ * полей. Иначе смена языка стирала бы предыдущий, и игрок, переключающийся туда-обратно,
+ * перекачивал бы таблицы каждый раз.
+ *
+ * Переводы — публичные данные тайтла, одни и те же для всех игроков, поэтому при логауте они
+ * намеренно НЕ удаляются: чистка только заставила бы качать заново.
+ *
+ * Любая ошибка хранилища трактуется как «кэша нет»: механизм обязан деградировать до полной
+ * загрузки таблицы, а не ломать запуск игры.
+ */
+declare class LocalizationCache {
+    private readonly storage;
+    private readonly titleId;
+    constructor(storage: ConfigStorage, titleId: string);
+    read(locale: string): Promise<StoredLocalizationTable | null>;
+    write(locale: string, version: number, table: Record<string, string>): Promise<void>;
+    /**
+     * Версии ВСЕХ сохранённых таблиц одной картой — то, что уезжает в
+     * `KnownLocalizationVersions`.
+     *
+     * Отдельная запись, а не обход ключей: интерфейс `ConfigStorage` намеренно узкий (get/set/
+     * remove) и перечислять ключи не умеет — иначе его нельзя было бы реализовать поверх
+     * PlayerPrefs или нативной обёртки.
+     *
+     * Карта нужна ДО того, как сервер ответит, какая локаль игроку досталась: прислать версию
+     * только своего языка мало — на смене языка и у неполного перевода в дело идёт вторая
+     * таблица, и её версию сервер тоже обязан сверить.
+     */
+    readVersions(): Promise<Record<string, number>>;
+    private noteVersion;
+    private keyOf;
+    private versionsKey;
+}
+
+export { type AcceptTradeOfferResponse, type ActivateReferralCodeResponse, type ActivateTimedBoostResponse, type ActiveBoostWindowInfo, type ActiveCoopEventInfo, type ActiveDealSlotInfo, type ActiveEventInfo, type ActiveSeasonInfo, type ActiveTimedBoost, type AdConsentSettings, type AdConsentState, type AdCreditsData, type AdDailyData, type AdFraudFlags, type AdFrequencyCappingSettings, type AdPendingRequest, type AdPlacementDefinition, type AdPlacementUserState, type AdProviderDefinition, type AdSessionData, AdType, type AdUnitConfig, type AdVerificationSettings, type AddQuestProgressResponse, type AdvertisingDefinitions, type AppOpenSettings, AttackOutcome, type AttackResponse, type AttributionInput, type AuthContext, AuthType, AuthenticationAction, type AuthenticationRequest, AuthenticationService, BannerPosition, type BannerSettings, type BaseRequest, type BatchDeleteUserCustomDataResponse, type BatchGetPublicUserCustomDataResponse, type BatchItemResult, type BatchResponse, type BatchSetUserCustomDataResponse, type BattleResult, type BattleStepConfig, type BlockchainAccountSafetyPolicy, BlockchainAction, type BlockchainConfigResponse, type BlockchainDefinitions, type BlockchainNetworkDefinition, BlockchainNetworkType, type BlockchainNftCollectionBinding, BlockchainOperationCategory, type BlockchainRequest, BlockchainService, type BlockchainStats, type BlockchainSystemState, BlockchainTransactionStatus, BlockchainTransactionType, type BoardLoopDefinition, type BoardLoopState, type BoardPendingInteraction, type BoardRollResponse, BodyPart, type BoostTriggerCounter, BoostWindowKind, BroadcastStatus, type BuildResponse, type BuildingState, type CancelMatchResponse, type CancelTradeOfferResponse, type ChangeUsernameResponse, CharacterAction, type CharacterClassification, type CharacterDefinition, type CharacterDefinitions, type CharacterEquipment, type CharacterEquipmentSlot, type CharacterIdentity, type CharacterLevelDefinition, type CharacterLevelRef, type CharacterModel, type CharacterRequest, CharacterService, type CharacterStatRef, type CharacterUnequipResult, type CharacterUnlock, CheckoutService, type ClaimAllRewardsBatchResponse, type ClaimAllRewardsResult, type ClaimComebackRewardResponse, type ClaimCycleRewardResponse, type ClaimCycleRewardsBatchResponse, type ClaimDailyRewardResponse, type ClaimDealMilestoneResponse, type ClaimDealMilestonesBatchResponse, type ClaimGrandPrizeResponse, type ClaimGroupCompletionRewardResponse, type ClaimInviteRewardResponse, type ClaimInviteRewardsBatchResponse, type ClaimLeaderboardMilestoneResponse, type ClaimLeaderboardMilestonesBatchResponse, type ClaimMilestoneRewardResponse, type ClaimMilestoneRewardsBatchResponse, type ClaimMilestonesBatchResponse, type ClaimQuestRewardResponse, type ClaimQuestRewardsBatchResponse, type ClaimRewardResponse, type ClaimSetRewardResponse, type ClaimSetRewardsBatchResponse, type ClaimTierRewardResponse, type ClaimTierRewardsBatchResponse, ClientPlatform, type ClientState, CloudCodeAction, CloudCodeErrorCode, type CloudCodeLogEntry, CloudCodeLogLevel, type CloudCodeRequest, CloudCodeRevisionSelection, CloudCodeService, type CodeExecutionError, type CollectIdleAccrualResponse, CollectionAction, type CollectionDefinitions, type CollectionGlobalSettings, type CollectionRequest, CollectionService, type CollectionSetRef, type CollectionTradeOfferDocument, CommissionSink, type CommunityChestClaimResponse, type CommunityChestGroupDocument, type CommunityChestGroupStateResponse, type CommunityChestHistoryEntry, type CommunityChestLeaveResponse, type CommunityChestMember, CommunityChestMemberStatus, type CommunityChestSharedState, CommunityChestStatus, type CommunityChestUserStateResponse, type ConfirmWithdrawalResponse, type ConversionDailyCounter, ConversionRateMode, type ConversionTarget, type ConvertResponse, type CoopBuildObjectsMemberState, type CoopBuildObjectsState, type CoopClaimRewardResponse, CoopEventAction, type CoopEventDefinitions, type CoopEventRequest, CoopEventService, type CoopGroupDocument, type CoopGroupMember, type CoopGroupStateResponse, CoopGroupStatus, type CoopLeaveGroupResponse, CoopMemberStatus, type CoopPartnerObjectState, type CoopSpinResponse, type CoopUserStateResponse, CraftAction, type CraftDefinitions, type CraftDefinitionsResponse, type CraftRequest, type CraftResponse, CraftService, type CraftSingleResult, CraftType, type CreateMatchResponse, type CryptoConvertResponse, type CryptoCurrencyDefinition, type CryptoCurrencyPermissions, type CryptoLimits, type CryptoNetworkBinding, type CryptoShortfall, CurrencyAction, type CurrencyAudit, type CurrencyConversion, type CurrencyDefinitions, type CurrencyRequest, CurrencyService, CurrencyStatus, CurrencyType, CustomDataBucket, CustomDataValueType, CustomDataWriter, type CyclicSchedule, DEFAULT_BASE_URL, type DailyUsageRecord, type DealMilestoneProgressInfo, DealNodeRuntimeStatus, DealOfferAction, DealOfferActivationStatus, type DealOfferDefinitions, type DealOfferRequest, DealOfferService, type DealOffersDefinitionResponse, type DeclineTradeOfferResponse, type DepositNFTResponse, type DepositTokenResponse, type DismissDealResponse, type DonationResponse, EnvelopeType, type EquipItemsResponse, type EquipSlotPair, type EquipmentPreset, type EquipmentSlot, type EquippedItem, type EventMap, type EventMilestoneClaimResponse, type EventTokenAddress, type EventTokenConversion, type EventTokenDefinition, type EventTokenGrantResponse, type EventTokenOperation, type EventTokenSpendResponse, EventTokenType, type ExecuteCloudCodeResponse, type ExecuteNodeResponse, type ExperimentDefinition, type ExperimentDefinitions, type ExperimentVariant, type ExperimentVariantCondition, type FodderConsumedEntry, FodderSelectionMode, FodderValuationMode, type FriendActionResponse, FriendActionStatus, type FriendPublicProfile, type FriendsListResponse, GameLoopAction, type GameLoopDefinitions, type GameLoopRequest, GameLoopService, type GetActiveBoostWindowsResponse, type GetActiveDealsResponse, type GetActiveEventsResponse, type GetActiveTimedBoostsResponse, type GetCharactersResponse, type GetLeaderboardResponse, type GetLeaderboardsBatchResponse, type GetMatchDefinitionsResponse, type GetMilestoneRewardMultiplierResponse, type GetMyProgressResponse, type GetMyUserCustomDataResponse, type GetOverviewBatchResponse, type GetProgressBatchResponse, type GetPublicTitleDataResponse, type GetPublicUserCustomDataResponse, type GetTradeOffersResponse, type GetUserQuestStateResponse, type GetUserTutorialStateResponse, type GrantStatusTokensResponse, type GrantTokensBatchResponse, type GrantedCollectible, type HeistCell, IDosGamesClient, type IDosGamesClientConfig, IDosGamesData, type IDosGamesSettings, type IapProductDefinition, type IapProductPurchaseState, type IapProductRules, IapProductType, IapPurchaseStatus, type IapStore, IapStore$1 as IapStoreValues, type IceServer, type InstantBattleDefinitions, type InstantBattleResponse, type InstantBattleRule, type InterstitialSettings, type InventoryDelta, ItemAction, type ItemCatalog, type ItemDefinition, type ItemDefinitions, type ItemEquipment, type ItemMetadata, type ItemRequest, ItemService, type ItemStats, type ItemTotals, type ItemUpgrade, type ItemUpgradeFodder, type ItemUpgradeRef, type JsonValue, KeyValueStorage, KycStatus, KycTier, LeaderboardAction, type LeaderboardDefinitions, type LeaderboardMilestoneRef, type LeaderboardOverview, type LeaderboardRequest, type LeaderboardScoreRef, LeaderboardService, type LeaderboardUserEntry, type LeaveRoomResponse, type LevelsPreset, type LimitSpec, type LinkedWalletInfo, type Listener, LocalizationAction, LocalizationCache, type LocalizationDefinitions, type LocalizationLocaleDefinition, type LocalizationLocaleInfo, type LocalizationManifestResponse, LocalizationMissingKeyMode, type LocalizationParams, type LocalizationRequest, LocalizationService, type LocalizationState, type LocalizationTableRef, type LocalizationTableResponse, LootboxAction, type LootboxAmountRange, type LootboxDefinitions, type LootboxDefinitionsResponse, type LootboxGlobalSettings, type LootboxOpenResponse, type LootboxPityRule, type LootboxPityTriggerResponse, type LootboxRequest, type LootboxRewardRoll, type LootboxRewardSlot, LootboxService, type LootboxSupplyRule, type MailboxBroadcastDocument, type MailboxDefinition, type MailboxMessageDocument, MailboxMessageSource, MailboxMessageStatus, type MailboxMessageTypeDefinition, type MailboxSegmentDefinition, MarketGoodsType, MarketOfferStatus, MarketOfferType, MarketplaceAction, type MarketplaceActionCounter, type MarketplaceAuctionSettings, type MarketplaceAuctionState, type MarketplaceBidRefund, type MarketplaceBrowseResponse, type MarketplaceBuyOrderSettings, type MarketplaceCommissionOverride, type MarketplaceCommissionPolicy, type MarketplaceCreateOfferResponse, type MarketplaceDefinitions, type MarketplaceDirectTradeSettings, type MarketplaceGetDefinitionsResponse, type MarketplaceGroupedOfferView, type MarketplaceGroupedOffersResponse, type MarketplaceHistoryEntryView, type MarketplaceHistoryResponse, type MarketplaceListingSettings, type MarketplaceMatchingSettings, type MarketplaceMyStateResponse, type MarketplaceOfferResponse, type MarketplaceOfferView, type MarketplacePlaceBidResponse, type MarketplacePricePolicy, type MarketplaceRequest, MarketplaceService, type MarketplaceSettlementResponse, type MarketplaceTradabilityPolicy, MatchAction, type MatchDefinitions, type MatchRequest, MatchService, MatchStatus, type MatchesPageResponse, type MilestoneClaimRef, type MilestoneDefinition, MultiplayerAction, MultiplayerChatMode, type MultiplayerDefinitions, type MultiplayerRequest, MultiplayerService, type MultiplayerSystemState, MultiplayerTopology, type NFTModel, type NFTNetworkBinding, type NFTTransactionDocument, type NFTWithdrawalResponse, type NftCollectionStats, type NftStatsContainer, type OpenCollectionChestResponse, type OpenPackResponse, type OperationFailure, type OperationFailureReason, type OperationResult, type OperationSuccess, type PackOpenResult, type PaymentProof, type PaymentRequirement, type PendingWithdrawalRef, PlatformAdapter, type PlatformBlockchainState, type PlatformLoginResponse, type PlayerEconomyTuningState, type PollResponse, PremiumAction, type PremiumAdReduction, type PremiumDefinitions, type PremiumDefinitionsResponse, type PremiumPurchaseResponse, type PremiumRequest, PremiumService, type PremiumStateResponse, type PremiumSubscription, type PriceOption, type PriceOptions, type PublishResponse, PurchaseAction, type PurchaseBatchResponse, type PurchaseDefinitions, type PurchaseReceiptRef, type PurchaseRequest, PurchaseService, type PurchaseValidationBatchResponse, type PurchaseValidationResponse, type PvPMatch, QuestAction, type QuestAvailability, type QuestClaimRef, type QuestCycleDefinition, type QuestDefinition, type QuestDefinitions, type QuestGroupCompletionDefinition, type QuestIdentity, type QuestLinking, type QuestObjectiveDefinition, QuestObjectiveSource, type QuestPhaseDefinition, type QuestPointsTrackView, QuestPrerequisiteMode, type QuestPresetBindings, type QuestPresetRegistry, type QuestProgressUpdate, type QuestRequest, type QuestReward, QuestService, QuestStatus, RaidMode, type RaidResponse, type RealtimeEnvelope, type RechargeConfig, type RecordShowResponse, ReferralAction, type ReferralDefinitions, type ReferralDefinitionsResponse, type ReferralInviteRewardState, type ReferralRequest, ReferralService, type RelativeWindow, type ResourceBundle, type ResourceConsume, type ResourceDualPartyResult, type ResourceEntry, ResourceEntryType, type ResourceGrant, type ResourceOperation, type ResourceTransferResult, type RetryWithdrawalResponse, RewardAction, type RewardDefinitions, type RewardDefinitionsResponse, type RewardRequest, RewardService, type RewardedVideoSettings, type RollActionData, type RoomListItem, type RoomMemberView, type RoomSnapshotResponse, RoomVisibility, type RoomsPageResponse, type ScheduleChain, type ScheduleChainPhase, ScheduleMode, type ScheduleSpec, type ScheduledWindow, type SdkEvents, SeasonAction, type SeasonDefinitions, type SeasonRequest, SeasonService, type SeasonTierRewardBundle, type SeasonTierRewardMultiplier, type SeasonTierRewardSet, type SegmentGate, type SendTradeOfferResponse, type SetUserCustomDataResponse, type SettingsInput, SocialAction, type SocialCounters, type SocialRequest, SocialService, type SocialTimelineEvent, type SolanaWithdrawalSignature, type SpecialApplyMultiplierResponse, SpecialChoiceMode, type SpecialChooseResponse, type SpecialClaimResponse, type SpecialModeOfferData, type SpecialPendingState, type SpendRewardDefinition, type SpendTokensBatchResponse, type SsoCodeFromUrl, type StatDefinition, type StatRequirement, type StatsPreset, StoreAction, type StoreDefinitions, type StorePurchaseRef, type StorePurchaseResponse, type StorePurchaseState, type StoreRequest, StoreService, StoreType, type StoredLocalizationTable, type SubmitScoreResponse, type SubmitScoresBatchResponse, type SuccessResponse, TimedBoostAction, type TimedBoostDefinitions, type TimedBoostRequest, TimedBoostService, TimedBoostStackingPolicy, TimedEventAction, type TimedEventDefinitions, type TimedEventGrantRef, type TimedEventInstanceRef, type TimedEventMilestoneRef, type TimedEventRequest, TimedEventService, type TimedEventSpendRef, TimelineEventType, type TimelineResponse, TitleAction, TitleConfig, TitleCustomDataAction, type TitleCustomDataDefinitions, type TitleCustomDataKeyDefinition, type TitleCustomDataRecord, type TitleCustomDataRequest, TitleCustomDataService, TitleDataBucket, TitleDataScope, type TitlePublicConfigurationModel, type TitleRequest, TitleService, type TokenCurrencyStats, type TokenStatsContainer, type TokenTransactionDocument, type TokenWithdrawalResponse, TradeOfferStatus, TransactionDirection, type TransactionHistoryResponse, type TriggerContext, type TriggerSource, TutorialAction, type TutorialAvailability, type TutorialBlockingPolicy, TutorialBoardAction, type TutorialBoardScript, type TutorialClaimResponse, type TutorialDefinitions, type TutorialFlowBatchResponse, type TutorialFlowDefinition, type TutorialFlowPolicy, type TutorialFlowResponse, TutorialFlowStatus, type TutorialFlowView, type TutorialGateCondition, TutorialGateMode, type TutorialGlobalSettings, type TutorialIdentity, type TutorialPresetBindings, type TutorialPresetRegistry, type TutorialRequest, TutorialRestartPolicy, type TutorialReward, TutorialScriptModule, type TutorialScriptedOutcome, type TutorialStepCompletion, TutorialStepCompletionMode, type TutorialStepDefinition, type TutorialStepEffects, type TutorialStepIdentity, type TutorialStepPolicy, type TutorialStepProgress, TypedEmitter, type UnequipAllCharactersResponse, type UnequipItemsResponse, type UnlockCharacterResponse, type UnlockCharactersBatchResponse, type UnstackableItemInstanceState, type Unsubscribe, type UpdateMatchResponse, type UpgradeCharacterLevelResponse, type UpgradeCharacterLevelsBatchResponse, type UpgradeItemLevelResponse, type UpgradeLevelsBatchResponse, type UpgradeLevelsOptions, type UpgradeStatLevelResponse, type UpgradeStatLevelsBatchResponse, type UsageReactivationEvent, type UsageTimeStats, type UseCollectibleJokerResponse, UserAction, type UserAdvertisingState, type UserBlockchainState, type UserBlockchainStateResponse, type UserCharactersState, type UserClaimRewardState, type UserCollectionState, type UserComebackState, type UserCommunityChestState, type UserCoopEventState, type UserCryptoComplianceCounters, type UserCryptoCurrencyState, UserCustomDataAction, type UserCustomDataBatchDeleteItem, type UserCustomDataBatchSetItem, type UserCustomDataDefinitions, type UserCustomDataKeyDefinition, type UserCustomDataRecord, type UserCustomDataRequest, UserCustomDataService, type UserCustomDataState, type UserDailyCalendarState, type UserDailyCounters, UserData, type UserDealNodeLifetimeCounts, type UserDealNodeState, type UserDealOfferActivationState, type UserDealOfferHistory, type UserDealOffersState, type UserDealOffersStateResponse, type UserDealSlotState, type UserDealTrackState, type UserDepositAddress, type UserEventTokenProgress, type UserEventTokensState, type UserGameLoopsState, type UserIdleAccrualState, type UserInventoryState, type UserKycState, type UserLeaderboardProgress, type UserLeaderboardsState, type UserLootboxPityCounter, type UserLootboxState, type UserMailboxState, type UserMarketplaceState, type UserMatchCreationLimitState, type UserMatchState, type UserPremiumState, type UserPublicDataModel, type UserPurchaseState, type UserQuestCycleState, type UserQuestObjectiveProgress, type UserQuestProgress, type UserQuestState, type UserReferralState, type UserReferralStateResponse, type UserRequest, type UserRewardState, type UserRewardsStateResponse, type UserSeasonState, type UserSeasonStateResponse, type UserSeasonsState, UserService, type UserSocialState, type UserState, type UserStateSlice, type UserStateVersions, type UserStoreState, type UserTimedBoostsState, type UserTimedEventStateResponse, type UserTutorialFlowState, type UserTutorialState, type UserTutorialStepState, type UserUsageState, type UserVirtualCurrencyState, type VirtualCurrencyDefinition, type VirtualCurrencyEconomy, type VirtualCurrencyPermissions, type WalletChallengeResponse, WalletLinkType, type WithdrawalSignatureResponse, type WithdrawalSplit, beginSsoRedirect, createIDosGamesClient, isFail, isOk, normalizeBlockchainCategory, readSsoCodeFromUrl, zPaymentProof, zPriceOption, zPriceOptions };