@series-inc/rundot-game-sdk 5.24.0-beta.2 → 5.24.0-beta.3

package/dist/{AdsApi-CDJtVB3I.d.ts → AdsApi-CscCuIMY.d.ts}

@@ -37,6 +37,8 @@ interface RpcResponse {
         detail?: string;
         /** Structured provider rejection detail, when available. */
         errorDetail?: ProviderErrorDetail;
+        /** Milliseconds the caller should wait before retrying a rate-limited request. */
+        retryAfterMs?: number;
         stack?: string;
     };
 }
@@ -1190,6 +1192,11 @@ interface Experiment {
     readonly groupName: string | null;
 }
 interface FeaturesApi {
+    /**
+     * @deprecated Platform-managed (1p-only) experiments. For your own A/B
+     * tests use LiveOps experiments: `liveops.getConfigAsync()` → `assignments`.
+     * Slated for removal once remaining 1p callers migrate.
+     */
     getExperiment(experimentName: string): Promise<Experiment | null>;
     getFeatureFlag(flagName: string): Promise<boolean>;
     getFeatureGate(gateName: string): Promise<boolean>;
@@ -1201,29 +1208,75 @@ interface LiveOpsOverride {
     expiresAt?: string;
     values: Record<string, unknown>;
 }
+interface LiveOpsVariant {
+    id: string;
+    weight: number;
+    values: Record<string, unknown>;
+}
+interface LiveOpsExperiment {
+    id: string;
+    salt?: string;
+    activeAt?: string;
+    expiresAt?: string;
+    variants: LiveOpsVariant[];
+    /** Mock-mode only: short-circuits hashing. Rejected by push-time validators. */
+    forceVariant?: string;
+}
+interface ExperimentAssignment {
+    experimentId: string;
+    variantId: string;
+    /** Configured weights, forwarded into the exposure event so the warehouse can
+     *  compare the observed split against the intended one (sample-ratio check). */
+    variantWeight: number;
+    totalWeight: number;
+}
+/** assignVariant's return: the winning variant plus the weight sum it won under. */
+interface AssignedVariant {
+    variant: LiveOpsVariant;
+    totalWeight: number;
+}
 interface LiveOpsSection {
     values?: Record<string, unknown>;
     overrides?: LiveOpsOverride[];
+    experiments?: LiveOpsExperiment[];
 }
 interface ResolvedLiveOps {
     values: Record<string, unknown>;
     activeOverrideIds: string[];
+    assignments: ExperimentAssignment[];
     /** Epoch-ms of the next window boundary that changes the active set, or null. */
     nextChangeAt: number | null;
 }
+/** FNV-1a 32-bit. Stable, portable; do not change without re-shuffling every live experiment. */
+declare function fnv1a32(input: string): number;
+declare const BUCKET_COUNT = 10000;
+/** Double-hash into [0, BUCKET_COUNT). The double pass is load-bearing: bit 0 of a
+ *  single fnv1a32 is a parity function of the input chars (odd-char XOR flips it,
+ *  odd-prime multiply preserves it), so `hash % 2` gave every 50/50 experiment the
+ *  same global player split (verified: 0%/100% cross-experiment agreement). Hashing
+ *  the first hash's decimal string breaks that structure (cf. GrowthBook hashVersion 2).
+ *  Do not change without re-shuffling every live experiment. */
+declare function assignmentBucket(seed: string, unitId: string): number;
+/** Pure deterministic assignment; null on malformed input (degrade-not-throw).
+ *  Variants own contiguous bucket ranges in array order, boundaries scaled to
+ *  BUCKET_COUNT, so a constant-total weight edit moves only the boundaries,
+ *  which is what makes the documented ramp recipe safe. */
+declare function assignVariant(experiment: LiveOpsExperiment, unitId: string): AssignedVariant | null;
 /**
  * Resolve a LiveOps `client` section against a caller-supplied clock. Pure: never
  * reads an ambient clock (`nowMs` is server-anchored in the SDK real paths,
  * `Date.now()` in Mock, UTC now in the CLI preview). Purity is load-bearing — the
  * MP authority resolves once at match start with a frozen timestamp.
  */
-declare function resolveLiveOpsSection(section: LiveOpsSection | undefined, nowMs: number): ResolvedLiveOps;
+declare function resolveLiveOpsSection(section: LiveOpsSection | undefined, nowMs: number, unitId?: string): ResolvedLiveOps;
 
 /** Resolved config — the foot-gun-free default. */
 interface LiveOpsConfigResult {
-    /** Resolved client-visible values (base + currently-active overrides). */
+    /** Resolved client-visible values (base + active overrides + assigned variants). */
     values: Record<string, unknown>;
     activeOverrideIds: string[];
+    /** Deterministic experiment assignments for the current profile (empty pre-identity). */
+    assignments: ExperimentAssignment[];
     /** Server config snapshot id the rules came from — quote it in bug reports. */
     configVersion: string;
     /** Epoch-ms (server clock) of the next schedule flip, or null. Re-call at/after it. */
@@ -1233,6 +1286,7 @@ interface LiveOpsConfigResult {
 interface LiveOpsRawConfig {
     values: Record<string, unknown>;
     overrides: LiveOpsOverride[];
+    experiments: LiveOpsExperiment[];
     configVersion: string;
     /** Authoritative server clock at fetch, for callers doing their own resolution. */
     serverTimeMs: number;
@@ -1806,6 +1860,7 @@ interface RundotGameMessage {
         data?: any;
         error?: string;
         errorCode?: string;
+        retryAfterMs?: number;
         /** Legacy flattened provider detail STRING — the field name is wire-frozen. */
         errorDetail?: string;
         /** Structured provider rejection detail (new wire field; see errors.ts). */
@@ -1910,6 +1965,17 @@ declare class RpcSharedAssetsApi implements SharedAssetsApi {
     private readonly rpcClient;
     constructor(rpcClient: RpcClient, rundotGameApi: RundotGameAPI);
     loadAssetsBundle(game: string, bundleKey: string, fileType?: string): Promise<ArrayBuffer>;
+    /**
+     * Pull the asset from the host in chunks. Only a host that predates the
+     * chunk protocol (BEGIN rejected with "Unsupported message type") falls
+     * back to the legacy single-shot RPC. A failure DURING the chunked
+     * transfer must NOT fall back to single-shot: pushing the whole asset
+     * through the bridge in one message is the exact Android wedge this
+     * protocol exists to avoid (venus issue #2749). Those errors propagate to
+     * the caller's CDN fallback instead.
+     */
+    private loadViaHostRpc;
+    private loadSingleShot;
 }
 interface LoadEmbeddedAssetsRequest {
     assetKey: string;
@@ -1917,6 +1983,21 @@ interface LoadEmbeddedAssetsRequest {
 interface LoadEmbeddedAssetsResponse {
     base64Data: string;
 }
+interface LoadEmbeddedAssetBeginRequest {
+    assetKey: string;
+}
+interface LoadEmbeddedAssetBeginResponse {
+    totalBytes: number;
+    maxChunkBytes: number;
+}
+interface LoadEmbeddedAssetChunkRequest {
+    assetKey: string;
+    position: number;
+    length: number;
+}
+interface LoadEmbeddedAssetChunkResponse {
+    base64Data: string;
+}
 
 /** the different subscription tiers RUN offers. LITE is lowest, ULTIMATE is highest */
 type SubscriptionTier = 'LITE' | 'CORE' | 'PLUS' | 'PRIME' | 'ULTIMATE';
@@ -2004,6 +2085,30 @@ interface OpenStoreResult {
     /** The updated balance after the store closed (saves a refetch) */
     newBalance: number;
 }
+type DirectPurchaseGrantKind = 'consumable' | 'durable';
+type DirectPurchaseStorePlatform = 'web' | 'ios' | 'android' | 'steam' | 'telegram';
+interface DirectPurchaseStorePrice {
+    platform: DirectPurchaseStorePlatform;
+    displayPrice?: string;
+    appStoreProductId?: string;
+    playProductId?: string;
+    stripePriceIds?: Record<string, string>;
+    taxBehavior?: 'inclusive' | 'exclusive';
+    amountByCurrency?: Record<string, number>;
+    stars?: number;
+}
+interface DirectPurchaseSku {
+    sku: string;
+    gameId: string;
+    tierId: string;
+    nominalUsd: number;
+    storePrices: DirectPurchaseStorePrice[];
+    grant: {
+        entitlementId: string;
+        quantity: number;
+        kind: DirectPurchaseGrantKind;
+    };
+}
 interface IapApi {
     getHardCurrencyBalance(): Promise<number>;
     spendCurrency(productId: string, amount: number, options?: SpendCurrencyOptions): Promise<SpendCurrencyResult>;
@@ -2013,6 +2118,7 @@ interface IapApi {
     purchaseSubscription(tier: SubscriptionTier, interval: SubscriptionInterval): Promise<PurchaseSubscriptionResponse>;
     isUserSubscribed(tier: SubscriptionTier): Promise<boolean>;
     hasUserMadePurchase(): Promise<boolean>;
+    listDirectPurchaseSkus(gameId: string): Promise<DirectPurchaseSku[]>;
 }
 
 /**
@@ -4510,6 +4616,11 @@ interface RundotGameAPI {
         eventName: string;
         params?: Record<string, any>;
     }): Promise<void>;
+    /**
+     * @deprecated Platform-managed (1p-only) experiments. For your own A/B
+     * tests use LiveOps experiments: `liveops.getConfigAsync()` → `assignments`.
+     * Slated for removal once remaining 1p callers migrate.
+     */
     getExperiment(options: {
         experimentName: string;
     }): Promise<any>;
@@ -4719,4 +4830,4 @@ interface AdsApi {
     showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-export { type DeviceInfo as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type SubmitMessageInput as E, type SubmitMessageResult as F, type ScheduleNotificationOptions as G, type Host as H, type RCSAvailabilityStatus as I, type ScheduleRCSInput as J, type ScheduleRCSResult as K, type RequestRCSOptInInput as L, type RequestRCSOptInResult as M, type NavigationApi as N, type PopupsApi as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type ShowToastOptions as T, type LikeDialogResult as U, type CommentsPanelResult as V, type LikeStateResult as W, type ShowInterstitialAdOptions as X, type ShowRewardedAdOptions as Y, type ProfileApi as Z, type DeviceApi as _, type RecipeRequirementQuery as a, type RoomMessageEvent as a$, type EnvironmentApi as a0, type EnvironmentInfo as a1, type SystemApi as a2, type SafeArea as a3, type AddToHomeScreenResult as a4, type CdnApi as a5, type FetchFromCdnOptions as a6, type AssetUrlResult as a7, type TimeApi as a8, type ServerTimeData as a9, type BackButtonCallback as aA, type IdentityChangedCallback as aB, type IdentityChangedEvent as aC, type SimulationApi as aD, type SimulationSlotValidationResult as aE, type SimulationBatchOperation as aF, type SimulationBatchOperationsResult as aG, type SimulationAvailableItem as aH, type SimulationPowerPreview as aI, type SimulationSlotMutationResult as aJ, type SimulationSlotContainer as aK, type SimulationAssignment as aL, type SimulationState as aM, type ExecuteRecipeOptions as aN, type ExecuteRecipeResponse as aO, type CollectRecipeResult as aP, type ResetStateOptions as aQ, type ResetStateResult as aR, type GetActiveRunsOptions as aS, type ExecuteScopedRecipeOptions as aT, type ExecuteScopedRecipeResult as aU, type GetAvailableRecipesOptions as aV, type GetAvailableRecipesResult as aW, type Recipe as aX, type GetBatchRecipeRequirements as aY, type TriggerRecipeChainOptions as aZ, type RoomDataUpdate as a_, type GetFutureTimeOptions as aa, type AiApi as ab, type AiChatCompletionRequest as ac, type AiChatCompletionData as ad, type PromptCompletionRequest as ae, type AiChatCompletionStreamOptions as af, type AiChatCompletionStreamChunk as ag, type HapticsApi as ah, HapticFeedbackStyle as ai, type GamepadSnapshot as aj, type GamepadConnectionEvent as ak, type Subscription as al, type GamepadApi as am, type GamepadLatencyStats as an, type FeaturesApi as ao, type Experiment as ap, type LiveOpsApi as aq, type LiveOpsConfigResult as ar, type LiveOpsRawConfig as as, type LiveOpsSection as at, type LifecycleApi as au, type SleepCallback as av, type AwakeCallback as aw, type PauseCallback as ax, type ResumeCallback as ay, type QuitCallback as az, type RecipeRequirementResult as b, type UgcApi as b$, type ProposedMoveEvent as b0, RundotGameTransport as b1, type RoomsApi as b2, type CreateRoomOptions as b3, type JoinOrCreateRoomOptions as b4, type JoinOrCreateResult as b5, type ListRoomsOptions as b6, type UpdateRoomDataOptions as b7, type RoomMessageRequest as b8, type StartRoomGameOptions as b9, type ShareMetadata as bA, type ShareLinkResult as bB, type SocialQRCodeOptions as bC, type QRCodeResult as bD, type ShareClickData as bE, type ShareFileOptions as bF, type ShareFileResult as bG, type CanShareFileResult as bH, type ComposeSocialPostOptions as bI, type ComposeSocialPostResult as bJ, type EntitlementApi as bK, type Entitlement as bL, type LedgerEntry as bM, type StatsApi as bN, type GrantInfo as bO, type CollectiblesApi as bP, type CollectibleCard as bQ, type VipClaimResult as bR, type ShopApi as bS, type StorefrontResponse as bT, type StorefrontItem as bU, type ShopPurchaseResponse as bV, type ShopOrderHistoryResponse as bW, type PromptLoginResult as bX, type AccessTier as bY, type AccessGateApi as bZ, type TextGenApi as b_, type ProposeMoveRequest as ba, type ProposeMoveResult as bb, type ValidateMoveVerdict as bc, type ValidateMoveResult as bd, type RoomSubscriptionOptions as be, type LoggingApi as bf, type IapApi as bg, type SpendCurrencyOptions as bh, type SpendCurrencyResult as bi, type SubscriptionTier as bj, type RunSubscriptionsResponse as bk, type SubscriptionInterval as bl, type PurchaseSubscriptionResponse as bm, type OpenStoreResult as bn, type LoadEmbeddedAssetsResponse as bo, type SharedAssetsApi as bp, type CreditsApi as bq, type CreditsBillingContext as br, type CreditBalance as bs, type CreditSubscription as bt, type CreditPlansCatalog as bu, type OpenPaywallOptions as bv, type CreditsPurchaseResult as bw, type Unsubscribe as bx, type PreloaderApi as by, type SocialApi as bz, type RundotGameAvailableRecipe as c, type AdminThreeDGenListReportsParams as c$, type VideoApi as c0, type AppApi as c1, type AdminUgcApi as c2, type AdminImageGenApi as c3, type AdminVideoGenApi as c4, type AdminSpriteGenApi as c5, type AdminAudioGenApi as c6, type AdminThreeDGenApi as c7, type AppRole as c8, type ResolveLaunchIntentOptions as c9, type FilesApi as cA, type ClipsApi as cB, type AttributionApi as cC, type InitializationContext as cD, type InitializationOptions as cE, type CaptureConsent as cF, type StartClipRecordingOptions as cG, type ClipBlob as cH, type ClipsSupport as cI, type ClipPersistOptions as cJ, type ClipResult as cK, type UgcEntry as cL, type CaptureConsentStatus as cM, AccessDeniedError as cN, type AdminGenApi as cO, type AdminImageGenBrowseParams as cP, type AdminImageGenBrowseResponse as cQ, type AdminImageGenListReportsParams as cR, type AdminImageGenListReportsResponse as cS, type AdminImageGenResolveAction as cT, type AdminSpriteGenBrowseParams as cU, type AdminSpriteGenBrowseResponse as cV, type AdminSpriteGenListReportsParams as cW, type AdminSpriteGenListReportsResponse as cX, type AdminSpriteGenResolveAction as cY, type AdminThreeDGenBrowseParams as cZ, type AdminThreeDGenBrowseResponse as c_, type LaunchIntent as ca, type ReleaseNote as cb, type AdminUgcBrowseParams as cc, type AdminUgcBrowseResponse as cd, type AdminUgcListReportsParams as ce, type AdminUgcListReportsResponse as cf, type AdminUgcResolveAction as cg, type AdminGenBrowseParams as ch, type AdminGenBrowseResponse as ci, type ImageGenEntry as cj, type AdminGenListReportsParams as ck, type AdminGenListReportsResponse as cl, type ImageGenReport as cm, type AdminGenResolveAction as cn, type SpriteGenEntry as co, type SpriteGenReport as cp, type ThreeDGenEntry as cq, type ThreeDGenReport as cr, type Avatar3dApi as cs, type AssetManifest as ct, type Avatar3dConfig as cu, type ShowEditorOptions as cv, type Avatar3dEdits as cw, type AdsApi as cx, type RawEnvironmentInfo as cy, type SharedStorageHostApi as cz, type RundotGameCollectRecipeResult as d, type RCSAvailabilityReason as d$, type AdminThreeDGenListReportsResponse as d0, type AdminThreeDGenResolveAction as d1, type AdminUgcEntry as d2, type AdminVideoGenBrowseParams as d3, type AdminVideoGenBrowseResponse as d4, type AdminVideoGenListReportsParams as d5, type AdminVideoGenListReportsResponse as d6, type AdminVideoGenResolveAction as d7, type AiContentBlock as d8, type AiImageContent as d9, type CreditsExhaustedErrorInfo as dA, type CreditsPurchaseOutcome as dB, GAMEPAD_BUTTON_NAMES as dC, type GamepadAxes as dD, type GamepadButtonName as dE, type GamepadButtonState as dF, type GamepadSource as dG, type GetSubscriptionsForTierRequest as dH, type HudInsets as dI, type IdentityChangeReason as dJ, type InboundForKeyEntry as dK, type InboundMethodIds as dL, type InboundStorageApi as dM, type IsPlayerSubscribedRequest as dN, type JoinOrCreateRoomEnvelopeResponse as dO, type JoinRoomMatchCriteria as dP, type LaunchIntentKind as dQ, type LiveOpsOverride as dR, type LoadEmbeddedAssetsRequest as dS, MockAvatarApi as dT, type NotificationTriggerInput as dU, type OnNotificationCallback as dV, type OnRequestCallback as dW, type OnResponseCallback as dX, type PlatformCapabilities as dY, type ProposedMovePayload as dZ, type PurchaseSubscriptionRequest as d_, type AiImageUrlContent as da, type AiMessage as db, type AiResponseFormat as dc, type AiTextContent as dd, type AiToolResultContent as de, type AiToolUseContent as df, type Asset as dg, type AudioGenEntry as dh, type AudioGenReport as di, CLIP_CONTENT_TYPE as dj, COMPOSE_POST_MAX_TEXT_LENGTH as dk, COMPOSE_POST_MAX_TITLE_LENGTH as dl, COMPOSE_POST_SUBREDDIT_PATTERN as dm, CREDITS_EXHAUSTED_CODE as dn, type Category as dp, type ClipAudioOptions as dq, type ClipCameraOptions as dr, type ClipPipLayout as ds, type ClipPipPosition as dt, type ComposeSocialPostMedia as du, type CreditFreeDailyInfo as dv, type CreditPlan as dw, type CreditTopUpPack as dx, type CreditsBilledTo as dy, CreditsExhaustedError as dz, type RundotGameExecuteRecipeOptions as e, type RCSOptInStatus as e0, ROOM_GAME_PHASES as e1, type RecipeInfo as e2, type ReleaseType as e3, type ResolvedLiveOps as e4, type RoomEnvelopeResponse as e5, type RoomGamePhase as e6, type RoomMessageEventType as e7, type RoomMessagePayload as e8, type RoomsEnvelopeResponse as e9, type SubmitMessageResultChannel as eA, TIER_SUPPORTED_INTERVALS as eB, type Tool as eC, type ToolChoice as eD, type ToolUse as eE, type TimeIntervalTriggerInput as eF, type UgcReport as eG, type VideoGenEntry as eH, type VideoGenReport as eI, asCreditsExhaustedError as eJ, assertTierSupportsInterval as eK, createHost as eL, isCreditsExhaustedError as eM, mapCreditsExhaustion as eN, resolveCollectionItemPrice as eO, resolveLiveOpsSection as eP, toPromptWireRequest as eQ, RpcInboundStorageApi as ea, RpcSharedAssetsApi as eb, type RpcTransport as ec, type RunSubscription as ed, type RundotGameRoomCustomMetadata as ee, type RundotGameRoomPayload as ef, type RundotGameRoomRules as eg, type RundotGameRoomRulesGameState as eh, SHARE_FILE_ALLOWED_MIME_TYPES as ei, SHARE_FILE_MAX_SIZE_BYTES as ej, SOCIAL_COMPOSE_PLATFORMS as ek, type ScheduleRCSStatus as el, type ShareFileMimeType as em, type ShopOrder as en, type SimulationBatchOperationAssign as eo, type SimulationBatchOperationRemove as ep, type SimulationBatchOperationResult as eq, type SimulationPersonalState as er, type SimulationRoomActiveRecipe as es, type SimulationRoomState as et, type SocialComposePlatform as eu, type StorefrontCollection as ev, type StorefrontCollectionItem as ew, type SubPath as ex, type SubmitMessageChannel as ey, type SubmitMessageChannelResult as ez, type RundotGameExecuteRecipeResult as f, type RundotGameExecuteScopedRecipeOptions as g, RundotGameRoom as h, type RundotGameSimulationConfig as i, type RundotGameSimulationEffect as j, type RundotGameSimulationRecipe as k, type RundotGameSimulationStateResponse as l, type SimulationEntityUpdate as m, type SimulationRunSummary as n, type SimulationSnapshotUpdate as o, type SimulationSubscribeOptions as p, type SimulationUpdateData as q, type SimulationUpdateType as r, type RpcRequest as s, type RpcResponse as t, type RpcNotification as u, RpcClient as v, type StorageApi as w, type NavigationStackInfo as x, type PushAppOptions as y, type NavigateToGameOptions as z };
+export { type DeviceInfo as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type SubmitMessageInput as E, type SubmitMessageResult as F, type ScheduleNotificationOptions as G, type Host as H, type RCSAvailabilityStatus as I, type ScheduleRCSInput as J, type ScheduleRCSResult as K, type RequestRCSOptInInput as L, type RequestRCSOptInResult as M, type NavigationApi as N, type PopupsApi as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type ShowToastOptions as T, type LikeDialogResult as U, type CommentsPanelResult as V, type LikeStateResult as W, type ShowInterstitialAdOptions as X, type ShowRewardedAdOptions as Y, type ProfileApi as Z, type DeviceApi as _, type RecipeRequirementQuery as a, type RoomDataUpdate as a$, type EnvironmentApi as a0, type EnvironmentInfo as a1, type SystemApi as a2, type SafeArea as a3, type AddToHomeScreenResult as a4, type CdnApi as a5, type FetchFromCdnOptions as a6, type AssetUrlResult as a7, type TimeApi as a8, type ServerTimeData as a9, type QuitCallback as aA, type BackButtonCallback as aB, type IdentityChangedCallback as aC, type IdentityChangedEvent as aD, type SimulationApi as aE, type SimulationSlotValidationResult as aF, type SimulationBatchOperation as aG, type SimulationBatchOperationsResult as aH, type SimulationAvailableItem as aI, type SimulationPowerPreview as aJ, type SimulationSlotMutationResult as aK, type SimulationSlotContainer as aL, type SimulationAssignment as aM, type SimulationState as aN, type ExecuteRecipeOptions as aO, type ExecuteRecipeResponse as aP, type CollectRecipeResult as aQ, type ResetStateOptions as aR, type ResetStateResult as aS, type GetActiveRunsOptions as aT, type ExecuteScopedRecipeOptions as aU, type ExecuteScopedRecipeResult as aV, type GetAvailableRecipesOptions as aW, type GetAvailableRecipesResult as aX, type Recipe as aY, type GetBatchRecipeRequirements as aZ, type TriggerRecipeChainOptions as a_, type GetFutureTimeOptions as aa, type AiApi as ab, type AiChatCompletionRequest as ac, type AiChatCompletionData as ad, type PromptCompletionRequest as ae, type AiChatCompletionStreamOptions as af, type AiChatCompletionStreamChunk as ag, type HapticsApi as ah, HapticFeedbackStyle as ai, type GamepadSnapshot as aj, type GamepadConnectionEvent as ak, type Subscription as al, type GamepadApi as am, type GamepadLatencyStats as an, type FeaturesApi as ao, type Experiment as ap, type ExperimentAssignment as aq, type LiveOpsApi as ar, type LiveOpsConfigResult as as, type LiveOpsRawConfig as at, type LiveOpsSection as au, type LifecycleApi as av, type SleepCallback as aw, type AwakeCallback as ax, type PauseCallback as ay, type ResumeCallback as az, type RecipeRequirementResult as b, type AccessGateApi as b$, type RoomMessageEvent as b0, type ProposedMoveEvent as b1, RundotGameTransport as b2, type RoomsApi as b3, type CreateRoomOptions as b4, type JoinOrCreateRoomOptions as b5, type JoinOrCreateResult as b6, type ListRoomsOptions as b7, type UpdateRoomDataOptions as b8, type RoomMessageRequest as b9, type PreloaderApi as bA, type SocialApi as bB, type ShareMetadata as bC, type ShareLinkResult as bD, type SocialQRCodeOptions as bE, type QRCodeResult as bF, type ShareClickData as bG, type ShareFileOptions as bH, type ShareFileResult as bI, type CanShareFileResult as bJ, type ComposeSocialPostOptions as bK, type ComposeSocialPostResult as bL, type EntitlementApi as bM, type Entitlement as bN, type LedgerEntry as bO, type StatsApi as bP, type GrantInfo as bQ, type CollectiblesApi as bR, type CollectibleCard as bS, type VipClaimResult as bT, type ShopApi as bU, type StorefrontResponse as bV, type StorefrontItem as bW, type ShopPurchaseResponse as bX, type ShopOrderHistoryResponse as bY, type PromptLoginResult as bZ, type AccessTier as b_, type StartRoomGameOptions as ba, type ProposeMoveRequest as bb, type ProposeMoveResult as bc, type ValidateMoveVerdict as bd, type ValidateMoveResult as be, type RoomSubscriptionOptions as bf, type LoggingApi as bg, type IapApi as bh, type SpendCurrencyOptions as bi, type SpendCurrencyResult as bj, type SubscriptionTier as bk, type RunSubscriptionsResponse as bl, type SubscriptionInterval as bm, type PurchaseSubscriptionResponse as bn, type OpenStoreResult as bo, type LoadEmbeddedAssetsResponse as bp, type DirectPurchaseSku as bq, type SharedAssetsApi as br, type CreditsApi as bs, type CreditsBillingContext as bt, type CreditBalance as bu, type CreditSubscription as bv, type CreditPlansCatalog as bw, type OpenPaywallOptions as bx, type CreditsPurchaseResult as by, type Unsubscribe as bz, type RundotGameAvailableRecipe as c, type AdminThreeDGenBrowseParams as c$, type TextGenApi as c0, type UgcApi as c1, type VideoApi as c2, type AppApi as c3, type AdminUgcApi as c4, type AdminImageGenApi as c5, type AdminVideoGenApi as c6, type AdminSpriteGenApi as c7, type AdminAudioGenApi as c8, type AdminThreeDGenApi as c9, type RawEnvironmentInfo as cA, type SharedStorageHostApi as cB, type FilesApi as cC, type ClipsApi as cD, type AttributionApi as cE, type InitializationContext as cF, type InitializationOptions as cG, type CaptureConsent as cH, type StartClipRecordingOptions as cI, type ClipBlob as cJ, type ClipsSupport as cK, type ClipPersistOptions as cL, type ClipResult as cM, type UgcEntry as cN, type CaptureConsentStatus as cO, AccessDeniedError as cP, type AdminGenApi as cQ, type AdminImageGenBrowseParams as cR, type AdminImageGenBrowseResponse as cS, type AdminImageGenListReportsParams as cT, type AdminImageGenListReportsResponse as cU, type AdminImageGenResolveAction as cV, type AdminSpriteGenBrowseParams as cW, type AdminSpriteGenBrowseResponse as cX, type AdminSpriteGenListReportsParams as cY, type AdminSpriteGenListReportsResponse as cZ, type AdminSpriteGenResolveAction as c_, type AppRole as ca, type ResolveLaunchIntentOptions as cb, type LaunchIntent as cc, type ReleaseNote as cd, type AdminUgcBrowseParams as ce, type AdminUgcBrowseResponse as cf, type AdminUgcListReportsParams as cg, type AdminUgcListReportsResponse as ch, type AdminUgcResolveAction as ci, type AdminGenBrowseParams as cj, type AdminGenBrowseResponse as ck, type ImageGenEntry as cl, type AdminGenListReportsParams as cm, type AdminGenListReportsResponse as cn, type ImageGenReport as co, type AdminGenResolveAction as cp, type SpriteGenEntry as cq, type SpriteGenReport as cr, type ThreeDGenEntry as cs, type ThreeDGenReport as ct, type Avatar3dApi as cu, type AssetManifest as cv, type Avatar3dConfig as cw, type ShowEditorOptions as cx, type Avatar3dEdits as cy, type AdsApi as cz, type RundotGameCollectRecipeResult as d, type LoadEmbeddedAssetBeginRequest as d$, type AdminThreeDGenBrowseResponse as d0, type AdminThreeDGenListReportsParams as d1, type AdminThreeDGenListReportsResponse as d2, type AdminThreeDGenResolveAction as d3, type AdminUgcEntry as d4, type AdminVideoGenBrowseParams as d5, type AdminVideoGenBrowseResponse as d6, type AdminVideoGenListReportsParams as d7, type AdminVideoGenListReportsResponse as d8, type AdminVideoGenResolveAction as d9, type CreditPlan as dA, type CreditTopUpPack as dB, type CreditsBilledTo as dC, CreditsExhaustedError as dD, type CreditsExhaustedErrorInfo as dE, type CreditsPurchaseOutcome as dF, type DirectPurchaseGrantKind as dG, type DirectPurchaseStorePlatform as dH, type DirectPurchaseStorePrice as dI, GAMEPAD_BUTTON_NAMES as dJ, type GamepadAxes as dK, type GamepadButtonName as dL, type GamepadButtonState as dM, type GamepadSource as dN, type GetSubscriptionsForTierRequest as dO, type HudInsets as dP, type IdentityChangeReason as dQ, type InboundForKeyEntry as dR, type InboundMethodIds as dS, type InboundStorageApi as dT, type IsPlayerSubscribedRequest as dU, type JoinOrCreateRoomEnvelopeResponse as dV, type JoinRoomMatchCriteria as dW, type LaunchIntentKind as dX, type LiveOpsExperiment as dY, type LiveOpsOverride as dZ, type LiveOpsVariant as d_, type AiContentBlock as da, type AiImageContent as db, type AiImageUrlContent as dc, type AiMessage as dd, type AiResponseFormat as de, type AiTextContent as df, type AiToolResultContent as dg, type AiToolUseContent as dh, type Asset as di, type AssignedVariant as dj, type AudioGenEntry as dk, type AudioGenReport as dl, BUCKET_COUNT as dm, CLIP_CONTENT_TYPE as dn, COMPOSE_POST_MAX_TEXT_LENGTH as dp, COMPOSE_POST_MAX_TITLE_LENGTH as dq, COMPOSE_POST_SUBREDDIT_PATTERN as dr, CREDITS_EXHAUSTED_CODE as ds, type Category as dt, type ClipAudioOptions as du, type ClipCameraOptions as dv, type ClipPipLayout as dw, type ClipPipPosition as dx, type ComposeSocialPostMedia as dy, type CreditFreeDailyInfo as dz, type RundotGameExecuteRecipeOptions as e, fnv1a32 as e$, type LoadEmbeddedAssetBeginResponse as e0, type LoadEmbeddedAssetChunkRequest as e1, type LoadEmbeddedAssetChunkResponse as e2, type LoadEmbeddedAssetsRequest as e3, MockAvatarApi as e4, type NotificationTriggerInput as e5, type OnNotificationCallback as e6, type OnRequestCallback as e7, type OnResponseCallback as e8, type PlatformCapabilities as e9, type ShopOrder as eA, type SimulationBatchOperationAssign as eB, type SimulationBatchOperationRemove as eC, type SimulationBatchOperationResult as eD, type SimulationPersonalState as eE, type SimulationRoomActiveRecipe as eF, type SimulationRoomState as eG, type SocialComposePlatform as eH, type StorefrontCollection as eI, type StorefrontCollectionItem as eJ, type SubPath as eK, type SubmitMessageChannel as eL, type SubmitMessageChannelResult as eM, type SubmitMessageResultChannel as eN, TIER_SUPPORTED_INTERVALS as eO, type Tool as eP, type ToolChoice as eQ, type ToolUse as eR, type TimeIntervalTriggerInput as eS, type UgcReport as eT, type VideoGenEntry as eU, type VideoGenReport as eV, asCreditsExhaustedError as eW, assertTierSupportsInterval as eX, assignVariant as eY, assignmentBucket as eZ, createHost as e_, type ProposedMovePayload as ea, type PurchaseSubscriptionRequest as eb, type RCSAvailabilityReason as ec, type RCSOptInStatus as ed, ROOM_GAME_PHASES as ee, type RecipeInfo as ef, type ReleaseType as eg, type ResolvedLiveOps as eh, type RoomEnvelopeResponse as ei, type RoomGamePhase as ej, type RoomMessageEventType as ek, type RoomMessagePayload as el, type RoomsEnvelopeResponse as em, RpcInboundStorageApi as en, RpcSharedAssetsApi as eo, type RpcTransport as ep, type RunSubscription as eq, type RundotGameRoomCustomMetadata as er, type RundotGameRoomPayload as es, type RundotGameRoomRules as et, type RundotGameRoomRulesGameState as eu, SHARE_FILE_ALLOWED_MIME_TYPES as ev, SHARE_FILE_MAX_SIZE_BYTES as ew, SOCIAL_COMPOSE_PLATFORMS as ex, type ScheduleRCSStatus as ey, type ShareFileMimeType as ez, type RundotGameExecuteRecipeResult as f, isCreditsExhaustedError as f0, mapCreditsExhaustion as f1, resolveCollectionItemPrice as f2, resolveLiveOpsSection as f3, toPromptWireRequest as f4, type RundotGameExecuteScopedRecipeOptions as g, RundotGameRoom as h, type RundotGameSimulationConfig as i, type RundotGameSimulationEffect as j, type RundotGameSimulationRecipe as k, type RundotGameSimulationStateResponse as l, type SimulationEntityUpdate as m, type SimulationRunSummary as n, type SimulationSnapshotUpdate as o, type SimulationSubscribeOptions as p, type SimulationUpdateData as q, type SimulationUpdateType as r, type RpcRequest as s, type RpcResponse as t, type RpcNotification as u, RpcClient as v, type StorageApi as w, type NavigationStackInfo as x, type PushAppOptions as y, type NavigateToGameOptions as z };

package/dist/{SyncplayRoomTransport-BZFFN-il.d.ts → SyncplayRoomTransport-Bfv_KE63.d.ts}

@@ -1,4 +1,5 @@
-import { C as CanonicalValue, h as ReplayFile, O as OfflineSession } from './types-BV8uchSD.js';
+import { C as CanonicalValue, c as DeterministicStepContext, h as ReplayFile, O as OfflineSession } from './types-BV8uchSD.js';
+import { S as SyncplaySignedReceipt } from './secret-protocol-hnhTHLBs.js';
 import { M as MultiplayerApi } from './MultiplayerApi-nnrGTTcO.js';
 
 /**
@@ -20,6 +21,8 @@ interface ConfirmedInputFrame {
     readonly inputs: readonly EncodedInput[];
     /** Slots whose input was substituted (repeated) because it never arrived in time. */
     readonly substitutedSlots: readonly number[];
+    /** Immutable authority-owned consequences applied immediately before this tick's simulation step. */
+    readonly commands?: readonly CanonicalValue[];
     readonly checksum: string;
 }
 interface InputAuthorityConfig {
@@ -63,6 +66,7 @@ interface InputAuthority {
     /** Lowest confirmed tick still retained, or -1 when nothing is confirmed yet. */
     readonly earliestRetainedTick: number;
     receiveInput(slot: number, tick: number, input: EncodedInput): InputSubmissionResult;
+    queueCommand(tick: number, command: CanonicalValue): void;
     /** Confirm every tick that can be confirmed up to and including `now`. Returns the new frames in order. */
     advance(now: number): readonly ConfirmedInputFrame[];
     /** A confirmed frame still inside the retained window, for redundant re-broadcast. */
@@ -172,6 +176,107 @@ type DeterministicSessionDecodeResult = {
 declare function encodeDeterministicSessionMessage(message: DeterministicSessionMessage): string;
 declare function decodeDeterministicSessionMessage(text: string): DeterministicSessionDecodeResult;
 
+interface SyncplaySecretAuthorityCrypto {
+    readonly kid: string;
+    readonly publicKeySpki: string;
+    randomBytes(length: number): Uint8Array;
+    sha256(bytes: Uint8Array): Uint8Array;
+    sign(bytes: Uint8Array): Uint8Array;
+}
+interface SyncplaySecretBrowserCrypto {
+    randomBytes(length: number): Uint8Array;
+    sha256(bytes: Uint8Array): Promise<Uint8Array>;
+    verify(publicKeySpki: string, bytes: Uint8Array, signature: Uint8Array): Promise<boolean>;
+}
+declare function createBrowserSyncplaySecretCrypto(): SyncplaySecretBrowserCrypto;
+declare function verifySyncplaySignedReceipt(receipt: SyncplaySignedReceipt, publicKeySpki: string, cryptoProvider?: SyncplaySecretBrowserCrypto): Promise<boolean>;
+
+interface SyncplaySecretClientTransport {
+    sendSecret?(text: string): void;
+    onSecretMessage?(handler: (text: string) => void): void;
+}
+interface SyncplaySecretConnectionIdentity {
+    readonly playerId?: string;
+    readonly slot: number;
+    readonly role: 'player' | 'spectator';
+}
+interface SyncplayOwnedSecret<T> {
+    readonly tokenId: string;
+    readonly systemId: string;
+    readonly ownerSlot: number;
+    readonly value: T;
+}
+interface SyncplayChoiceResolvedEvent<T> {
+    readonly systemId: string;
+    readonly requestId: string;
+    readonly roundId: string;
+    readonly reveals: Readonly<Record<number, T>>;
+    readonly missingSlots: readonly number[];
+    readonly missingReveal: 'omit' | 'forfeit';
+}
+interface SyncplayRandomDrawnEvent {
+    readonly systemId: string;
+    readonly requestId: string;
+    readonly drawIndex: number;
+    readonly value: number;
+}
+interface SyncplayCollectionRevealedEvent<T> {
+    readonly systemId: string;
+    readonly requestId: string;
+    readonly ownerSlot: number;
+    readonly tokenId: string;
+    readonly action: 'reveal' | 'play';
+    readonly value: T;
+}
+interface SyncplayRoleRevealedEvent<T> {
+    readonly systemId: string;
+    readonly requestId: string;
+    readonly slot: number;
+    readonly tokenId: string;
+    readonly value: T;
+}
+interface SyncplayChoiceClient<T> {
+    commit(roundId: string, value: T): Promise<SyncplaySignedReceipt>;
+    reveal(roundId: string): Promise<SyncplaySignedReceipt>;
+    resolved(roundId: string): Promise<SyncplayChoiceResolvedEvent<T>>;
+}
+interface SyncplayRandomClient {
+    draw(): Promise<SyncplayRandomDrawnEvent>;
+}
+interface SyncplayCollectionClient<T> {
+    draw(count?: number): Promise<readonly SyncplayOwnedSecret<T>[]>;
+    hand(): readonly SyncplayOwnedSecret<T>[];
+    reveal(tokenId: string): Promise<SyncplayCollectionRevealedEvent<T>>;
+    play(tokenId: string): Promise<SyncplayCollectionRevealedEvent<T>>;
+}
+interface SyncplayRoleClient<T> {
+    current(): SyncplayOwnedSecret<T> | undefined;
+    whenAssigned(): Promise<SyncplayOwnedSecret<T>>;
+    reveal(): Promise<SyncplayRoleRevealedEvent<T>>;
+}
+interface SyncplaySecretsClient {
+    whenReady(): Promise<void>;
+    choice<T>(systemId: string): SyncplayChoiceClient<T>;
+    random(systemId: string): SyncplayRandomClient;
+    deck<T>(systemId: string): SyncplayCollectionClient<T>;
+    bag<T>(systemId: string): SyncplayCollectionClient<T>;
+    role<T>(systemId: string): SyncplayRoleClient<T>;
+    acceptConfirmedCommands(commands: readonly CanonicalValue[]): Promise<void>;
+}
+interface CreateSyncplaySecretsClientOptions {
+    readonly transport: SyncplaySecretClientTransport;
+    readonly connection: () => SyncplaySecretConnectionIdentity;
+    readonly crypto?: SyncplaySecretBrowserCrypto;
+}
+declare function createSyncplaySecretsClient(options: CreateSyncplaySecretsClientOptions): SyncplaySecretsClient;
+interface SyncplaySecretEventReader {
+    choiceResolved<T>(systemId: string): readonly SyncplayChoiceResolvedEvent<T>[];
+    randomDrawn(systemId: string): readonly SyncplayRandomDrawnEvent[];
+    collectionRevealed<T>(systemId: string): readonly SyncplayCollectionRevealedEvent<T>[];
+    roleRevealed<T>(systemId: string): readonly SyncplayRoleRevealedEvent<T>[];
+}
+declare function createSyncplaySecretEventReader(ctx: Pick<DeterministicStepContext, 'commands'>): SyncplaySecretEventReader;
+
 /**
  * Reusable client transport for game-agnostic deterministic multiplayer (§6 M4).
  *
@@ -185,6 +290,9 @@ declare function decodeDeterministicSessionMessage(text: string): DeterministicS
 interface NetworkedClientTransport {
     send(text: string): void;
     onMessage(handler: (text: string) => void): void;
+    sendSecret?(text: string): void;
+    onSecretMessage?(handler: (text: string) => void): void;
+    readonly playerId?: string;
 }
 interface NetworkedSyncplayClientOptions<State, Input> {
     readonly transport: NetworkedClientTransport;
@@ -233,6 +341,8 @@ interface NetworkedSyncplayClientOptions<State, Input> {
     readonly inputDelay?: NetworkedSyncplayClientInputDelayOptions;
     /** Monotonic-enough clock for RTT measurement. Default Date.now. NEVER used by the sim. */
     readonly now?: () => number;
+    readonly playerId?: string;
+    readonly secretCrypto?: SyncplaySecretBrowserCrypto;
 }
 interface NetworkedSyncplayClientPacingOptions {
     /** Interval between time-sync pings while pumpPaced is driven. Default 1000. */
@@ -273,6 +383,7 @@ interface NetworkedSyncplayClient {
     readonly rollbacks: number;
     /** Live local netcode telemetry (RTT, timescale, delay, rollback depth). */
     readonly netStats: NetworkedSyncplayClientNetStats;
+    readonly secrets: SyncplaySecretsClient;
     /** Resolves once `session-start` has been received. */
     whenReady(): Promise<void>;
     /** Predict and submit local input up to the prediction budget. */
@@ -376,4 +487,4 @@ declare function quickMatchSyncplayRoom(api: MultiplayerApi, criteria?: Record<s
  */
 declare function createSyncplayRoom(api: MultiplayerApi): Promise<SyncplayRoomTransport>;
 
-export { type ConfirmedInputFrame as C, type DeterministicSessionDecodeRejection as D, type EncodedInput as E, type InputAuthority as I, type NetworkedClientTransport as N, type QuickMatchSyncplayOptions as Q, type SyncplayRoomTransport as S, type DeterministicSessionDecodeResult as a, type DeterministicSessionMessage as b, type DeterministicSessionMessageKind as c, type DeterministicSessionRole as d, type InputAuthorityConfig as e, type InputAuthorityRestoreState as f, type InputAuthorityStats as g, type InputRejectionReason as h, type InputSubmissionResult as i, type NetworkedSyncplayClient as j, type NetworkedSyncplayClientInputDelayOptions as k, type NetworkedSyncplayClientNetStats as l, type NetworkedSyncplayClientOptions as m, type NetworkedSyncplayClientPacingOptions as n, createInputAuthority as o, createNetworkedSyncplayClient as p, createSyncplayRoom as q, decodeDeterministicSessionMessage as r, deterministicSessionWireVersion as s, encodeDeterministicSessionMessage as t, joinSyncplayRoomByCode as u, quickMatchSyncplayRoom as v };
+export { createBrowserSyncplaySecretCrypto as A, createInputAuthority as B, type ConfirmedInputFrame as C, type DeterministicSessionDecodeRejection as D, type EncodedInput as E, createNetworkedSyncplayClient as F, createSyncplayRoom as G, createSyncplaySecretEventReader as H, type InputAuthority as I, createSyncplaySecretsClient as J, decodeDeterministicSessionMessage as K, deterministicSessionWireVersion as L, encodeDeterministicSessionMessage as M, type NetworkedClientTransport as N, joinSyncplayRoomByCode as O, quickMatchSyncplayRoom as P, type QuickMatchSyncplayOptions as Q, verifySyncplaySignedReceipt as R, type SyncplaySecretAuthorityCrypto as S, type DeterministicSessionDecodeResult as a, type DeterministicSessionMessage as b, type DeterministicSessionMessageKind as c, type DeterministicSessionRole as d, type InputAuthorityConfig as e, type InputAuthorityRestoreState as f, type InputAuthorityStats as g, type InputRejectionReason as h, type InputSubmissionResult as i, type NetworkedSyncplayClient as j, type NetworkedSyncplayClientInputDelayOptions as k, type NetworkedSyncplayClientNetStats as l, type NetworkedSyncplayClientOptions as m, type NetworkedSyncplayClientPacingOptions as n, type SyncplayChoiceClient as o, type SyncplayChoiceResolvedEvent as p, type SyncplayCollectionClient as q, type SyncplayCollectionRevealedEvent as r, type SyncplayOwnedSecret as s, type SyncplayRandomClient as t, type SyncplayRandomDrawnEvent as u, type SyncplayRoleClient as v, type SyncplayRoleRevealedEvent as w, type SyncplayRoomTransport as x, type SyncplaySecretEventReader as y, type SyncplaySecretsClient as z };