@indiegems/gem-web-sdk 20.1.0 → 21.1.0

package/dist/index.d.ts

@@ -32,6 +32,7 @@ declare const PARENT_TO_FRAME: readonly [
     "gem.dedicatedEvent",
     "gem.partyResult",
     "gem.clusterTarget",
+    "gem.graphicsRoutes",
     "gem.devtools",
     "gem.screenshot",
     "gem.requestContext",
@@ -39,8 +40,10 @@ declare const PARENT_TO_FRAME: readonly [
     "gem.localServer.denied",
     "gem.menuSelect",
     "gem.settingChange",
+    "gem.shareResult",
     "gem.error",
     "gem.purchaseResult",
+    "gem.purchaseSettled",
     "gem.deviceSettings.result",
     "gem.adResult",
     "gem.momentResult",
@@ -99,7 +102,7 @@ declare const FRAME_TO_PARENT: readonly [
     "gem.requestStorePurchase",
     "gem.requestStoreOfferSheet"
 ];
-type GemCapability = "ads" | "signIn" | "purchases" | "avatar3dPurchases" | "friendChallenges" | "devtools" | "screenshot" | "feedbackContext" | "rooms" | "p2p" | "dedicated" | "clusterTarget" | "parties" | "autoStartFailure" | "ticketEvents" | "partySeating" | "socketState" | "audioState" | "rewardCue" | "frameStats" | "portraitBorders" | "engagement" | "viewport" | "reservedAreas" | "audioChannels" | "walletDisplay" | "localHost" | "cohorts" | "earnAllowance" | "deviceSettings" | "asyncOpponents" | "share" | "avatarPicker" | "vibration" | "gameMenu" | "controls" | "gemCorner" | "gameSettings" | "moments" | "appLinks" | "openGame" | "store" | "storeOfferSheet" | "menuStyle" | "p2pRelayDrain";
+type GemCapability = "ads" | "signIn" | "purchases" | "purchaseSettled" | "avatar3dPurchases" | "friendChallenges" | "devtools" | "screenshot" | "feedbackContext" | "rooms" | "p2p" | "dedicated" | "clusterTarget" | "graphicsRoutes" | "parties" | "autoStartFailure" | "ticketEvents" | "partySeating" | "socketState" | "audioState" | "rewardCue" | "frameStats" | "portraitBorders" | "engagement" | "viewport" | "reservedAreas" | "audioChannels" | "walletDisplay" | "localHost" | "cohorts" | "earnAllowance" | "deviceSettings" | "asyncOpponents" | "share" | "shareResult" | "shareRemap" | "avatarPicker" | "vibration" | "gameMenu" | "controls" | "gemCorner" | "gameSettings" | "moments" | "appLinks" | "openGame" | "store" | "storeOfferSheet" | "menuStyle" | "p2pRelayDrain";
 declare const CAPABILITY_GATES: Readonly<Record<string, string>>;
 declare const CAPABILITY_NAMESPACE_GATES: ReadonlyArray<readonly [
     string,
@@ -335,6 +338,15 @@ interface GemClusterTarget {
     readonly clusterTargetId: string;
     readonly clusterTargetIds?: string[];
 }
+interface GemGraphicsRoutes {
+    readonly gem: typeof PROTOCOL;
+    readonly type: "gem.graphicsRoutes";
+    readonly entries: {
+        gpu: string;
+        route?: string;
+        host?: string;
+    }[];
+}
 interface GemDevtools {
     readonly gem: typeof PROTOCOL;
     readonly type: "gem.devtools";
@@ -520,11 +532,20 @@ interface GemSettingChange {
 interface GemRequestShare {
     readonly gem: typeof PROTOCOL;
     readonly type: "gem.requestShare";
+    readonly requestId?: string;
     readonly params: {
         key: string;
         value: string;
     }[];
 }
+interface GemShareResult {
+    readonly gem: typeof PROTOCOL;
+    readonly type: "gem.shareResult";
+    readonly requestId: string;
+    readonly outcome: "accepted" | "refused";
+    readonly reason?: string;
+    readonly key?: string;
+}
 interface GemRequestAvatarPicker {
     readonly gem: typeof PROTOCOL;
     readonly type: "gem.requestAvatarPicker";
@@ -562,6 +583,7 @@ interface GemRequestPurchase {
     readonly currencySlug: string;
     readonly quantity?: number;
     readonly catalogId?: string;
+    readonly origin?: "sheet" | "direct_refused";
 }
 interface GemRequestAvatar3dPurchase {
     readonly gem: typeof PROTOCOL;
@@ -578,6 +600,15 @@ interface GemPurchaseResult {
     readonly reason?: string;
     readonly purchaseId?: string;
 }
+interface GemPurchaseSettled {
+    readonly gem: typeof PROTOCOL;
+    readonly type: "gem.purchaseSettled";
+    readonly purchaseKind: "item" | "recipe";
+    readonly targetId: string;
+    readonly catalogId?: string;
+    readonly quantity: number;
+    readonly purchaseId?: string;
+}
 interface GemDeviceSettingsPut {
     readonly gem: typeof PROTOCOL;
     readonly type: "gem.deviceSettings.put";
@@ -775,7 +806,7 @@ interface GemStoreOfferSheetResult {
     readonly outcome: "ok" | "declined" | "unavailable";
     readonly reason?: string;
 }
-type ParentMessage = GemHandshake | GemToken | GemTokenDenied | GemPlayer | GemPause | GemPrefs | GemCohorts | GemEarnAllowanceChanged | GemViewport | GemDeviceSettings | GemWillTerminate | GemRoomEvent | GemSocketState | GemSeatedEvent | GemAutoStartFailedEvent | GemTicketEvent | GemSignalEvent | GemRelayDraining | GemDedicatedEvent | GemPartyResult | GemClusterTarget | GemDevtools | GemScreenshot | GemRequestContext | GemLocalServer | GemLocalServerDenied | GemMenuSelect | GemSettingChange | GemError | GemPurchaseResult | GemDeviceSettingsResult | GemAdResult | GemMomentResult | GemSignInResult | GemFriendChallengeResult | GemAppLinksResult | GemOpenAppResult | GemOpenGameResult | GemSimilarGamesResult | GemStoreOffersResult | GemStorePurchaseResult | GemStorePurchaseSettled | GemStoreOfferSheetResult;
+type ParentMessage = GemHandshake | GemToken | GemTokenDenied | GemPlayer | GemPause | GemPrefs | GemCohorts | GemEarnAllowanceChanged | GemViewport | GemDeviceSettings | GemWillTerminate | GemRoomEvent | GemSocketState | GemSeatedEvent | GemAutoStartFailedEvent | GemTicketEvent | GemSignalEvent | GemRelayDraining | GemDedicatedEvent | GemPartyResult | GemClusterTarget | GemGraphicsRoutes | GemDevtools | GemScreenshot | GemRequestContext | GemLocalServer | GemLocalServerDenied | GemMenuSelect | GemSettingChange | GemShareResult | GemError | GemPurchaseResult | GemPurchaseSettled | GemDeviceSettingsResult | GemAdResult | GemMomentResult | GemSignInResult | GemFriendChallengeResult | GemAppLinksResult | GemOpenAppResult | GemOpenGameResult | GemSimilarGamesResult | GemStoreOffersResult | GemStorePurchaseResult | GemStorePurchaseSettled | GemStoreOfferSheetResult;
 type FrameMessage = GemHandshakeAccept | GemScreenshotDenied | GemGameContext | GemSignal | GemDedicatedOffer | GemPartyRequest | GemReady | GemEngaged | GemProgress | GemRequestToken | GemRequestLocalServer | GemExit | GemOpenExternal | GemRequestFullscreen | GemAudioState | GemRewardCue | GemWalletDisplay | GemControlsDeclare | GemMenu | GemGemCorner | GemMenuStyle | GemSettingsDeclare | GemRequestShare | GemRequestAvatarPicker | GemVibrate | GemFrameStats | GemPortraitBorders | GemError | GemRequestPurchase | GemRequestAvatar3dPurchase | GemDeviceSettingsPut | GemRequestAd | GemSignalMoment | GemRequestSignIn | GemRequestFriendChallenge | GemRequestAppLinks | GemRequestOpenApp | GemRequestOpenGame | GemRequestSimilarGames | GemRequestStoreOffers | GemRequestStorePurchase | GemRequestStoreOfferSheet;
 type GemMessage = ParentMessage | FrameMessage;
 type Rejection = string | null;
@@ -803,6 +834,7 @@ declare const validateGemRelayDraining: (raw: unknown) => Rejection;
 declare const validateGemDedicatedEvent: (raw: unknown) => Rejection;
 declare const validateGemPartyResult: (raw: unknown) => Rejection;
 declare const validateGemClusterTarget: (raw: unknown) => Rejection;
+declare const validateGemGraphicsRoutes: (raw: unknown) => Rejection;
 declare const validateGemDevtools: (raw: unknown) => Rejection;
 declare const validateGemScreenshot: (raw: unknown) => Rejection;
 declare const validateGemScreenshotDenied: (raw: unknown) => Rejection;
@@ -832,6 +864,7 @@ declare const validateGemMenuStyle: (raw: unknown) => Rejection;
 declare const validateGemSettingsDeclare: (raw: unknown) => Rejection;
 declare const validateGemSettingChange: (raw: unknown) => Rejection;
 declare const validateGemRequestShare: (raw: unknown) => Rejection;
+declare const validateGemShareResult: (raw: unknown) => Rejection;
 declare const validateGemRequestAvatarPicker: (raw: unknown) => Rejection;
 declare const validateGemVibrate: (raw: unknown) => Rejection;
 declare const validateGemFrameStats: (raw: unknown) => Rejection;
@@ -840,6 +873,7 @@ declare const validateGemError: (raw: unknown) => Rejection;
 declare const validateGemRequestPurchase: (raw: unknown) => Rejection;
 declare const validateGemRequestAvatar3dPurchase: (raw: unknown) => Rejection;
 declare const validateGemPurchaseResult: (raw: unknown) => Rejection;
+declare const validateGemPurchaseSettled: (raw: unknown) => Rejection;
 declare const validateGemDeviceSettingsPut: (raw: unknown) => Rejection;
 declare const validateGemDeviceSettingsResult: (raw: unknown) => Rejection;
 declare const validateGemRequestAd: (raw: unknown) => Rejection;
@@ -866,49 +900,6 @@ declare const validateGemStorePurchaseSettled: (raw: unknown) => Rejection;
 declare const validateGemRequestStoreOfferSheet: (raw: unknown) => Rejection;
 declare const validateGemStoreOfferSheetResult: (raw: unknown) => Rejection;
 declare const VALIDATORS: Readonly<Record<string, (raw: unknown) => Rejection>>;
-type PurchaseRefusalCode = "unknown_currency" | "currency_not_in_game_payable" | "not_purchasable" | "no_price_in_currency" | "busy" | "cancelled" | "insufficient_funds" | "price_mismatch" | "config_version_stale" | "platform_currency_unavailable" | "not_available" | "recipe_locked" | "already_owned" | "recipe_on_cooldown" | "recipe_max_uses_exceeded" | "item_max_stack_exceeded" | "recipe_costs_unmet" | "quantity_invalid" | "error";
-interface OfferRefusal {
-    readonly reason: string;
-}
-declare function buildDedicatedOfferFrame(matchId: string, gameId: string, data: unknown): {
-    frame: Record<string, unknown>;
-} | OfferRefusal;
-declare const INBOUND_EVENTS: Readonly<Record<string, string>>;
-interface RelayedDedicatedEvent {
-    readonly event: string;
-    readonly matchId: string;
-    readonly sdp?: string;
-    readonly sessionId?: string;
-    readonly code?: string;
-    readonly message?: string;
-    readonly reason?: string;
-}
-declare function projectDedicatedEvent(raw: unknown, gameId: string, knowsMatch: (matchId: string) => boolean): RelayedDedicatedEvent | null;
-declare const MAX_SOCKET_FRAME_BYTES = 16384;
-declare const MAX_SIGNALS_PER_SECOND = 24;
-interface SignalRefusal {
-    readonly reason: string;
-}
-declare function buildSocketFrame(signal: string, matchId: string, gameId: string, data: unknown): {
-    frame: Record<string, unknown>;
-} | SignalRefusal;
-interface RelayedSignal {
-    readonly event: string;
-    readonly matchId: string;
-    readonly data: Record<string, unknown>;
-}
-declare function projectSignal(raw: unknown, gameId: string, knowsMatch: (matchId: string) => boolean): RelayedSignal | null;
-interface PartyEventRelay {
-    readonly event: string;
-    readonly partyId: string;
-    readonly version?: number;
-    readonly gameRoomId?: string;
-    readonly gameId?: string;
-    readonly inviterPlayerId?: string;
-    readonly inviterDisplayTag?: string;
-    readonly partyName?: string;
-}
-declare function projectPartyEvent(raw: unknown): PartyEventRelay | null;
 type PortMessageHandler = {
     handle(event: {
         data: unknown;
@@ -951,6 +942,55 @@ declare function negotiateVersion(ours: {
     min: number;
     max: number;
 }): number | null;
+interface GemGraphicsRouteEntry {
+    readonly gpu: string;
+    readonly route?: string;
+    readonly host?: string;
+}
+declare const BUILT_IN_GRAPHICS_ROUTES: readonly GemGraphicsRouteEntry[];
+type PurchaseRefusalCode = "unknown_currency" | "currency_not_in_game_payable" | "not_purchasable" | "no_price_in_currency" | "busy" | "cancelled" | "insufficient_funds" | "price_mismatch" | "config_version_stale" | "platform_currency_unavailable" | "not_available" | "recipe_locked" | "already_owned" | "guest_upgrade_required" | "recipe_on_cooldown" | "recipe_max_uses_exceeded" | "item_max_stack_exceeded" | "recipe_costs_unmet" | "quantity_invalid" | "error";
+interface OfferRefusal {
+    readonly reason: string;
+}
+declare function buildDedicatedOfferFrame(matchId: string, gameId: string, data: unknown): {
+    frame: Record<string, unknown>;
+} | OfferRefusal;
+declare const INBOUND_EVENTS: Readonly<Record<string, string>>;
+interface RelayedDedicatedEvent {
+    readonly event: string;
+    readonly matchId: string;
+    readonly sdp?: string;
+    readonly sessionId?: string;
+    readonly code?: string;
+    readonly message?: string;
+    readonly reason?: string;
+}
+declare function projectDedicatedEvent(raw: unknown, gameId: string, knowsMatch: (matchId: string) => boolean): RelayedDedicatedEvent | null;
+declare const MAX_SOCKET_FRAME_BYTES = 16384;
+declare const MAX_SIGNALS_PER_SECOND = 24;
+interface SignalRefusal {
+    readonly reason: string;
+}
+declare function buildSocketFrame(signal: string, matchId: string, gameId: string, data: unknown): {
+    frame: Record<string, unknown>;
+} | SignalRefusal;
+interface RelayedSignal {
+    readonly event: string;
+    readonly matchId: string;
+    readonly data: Record<string, unknown>;
+}
+declare function projectSignal(raw: unknown, gameId: string, knowsMatch: (matchId: string) => boolean): RelayedSignal | null;
+interface PartyEventRelay {
+    readonly event: string;
+    readonly partyId: string;
+    readonly version?: number;
+    readonly gameRoomId?: string;
+    readonly gameId?: string;
+    readonly inviterPlayerId?: string;
+    readonly inviterDisplayTag?: string;
+    readonly partyName?: string;
+}
+declare function projectPartyEvent(raw: unknown): PartyEventRelay | null;
 interface TokenGrant {
     readonly token: string;
     readonly expiresAt: number;
@@ -1156,6 +1196,13 @@ declare class GemHost {
     private rememberAsked;
     answerPartyRequest(requestId: string, partyId?: string): boolean;
     answerPurchase(requestId: string, outcome: "ok" | "declined" | "unavailable", purchaseId?: string, reason?: PurchaseRefusalCode): boolean;
+    sendPurchaseSettled(settlement: {
+        purchaseKind: "item" | "recipe";
+        targetId: string;
+        catalogId?: string;
+        quantity: number;
+        purchaseId?: string;
+    }): boolean;
     answerDeviceSettingsPut(requestId: string, outcome: "stored" | "too_large" | "unavailable"): boolean;
     sendDeviceSettings(settings?: Readonly<Record<string, unknown>>): boolean;
     sendMenuSelect(choice: "settings" | {
@@ -1178,6 +1225,10 @@ declare class GemHost {
         readonly arcade?: "app_store" | "google_play";
         readonly game?: "app_store" | "google_play";
     }): boolean;
+    answerShare(requestId: string, outcome: "accepted" | "refused", refusal?: {
+        readonly reason?: string;
+        readonly key?: string;
+    }): boolean;
     answerOpenApp(requestId: string, outcome: ArcadeOutcomeKind, reason?: string): boolean;
     answerOpenGame(requestId: string, outcome: ArcadeOutcomeKind, reason?: string): boolean;
     answerSimilarGames(requestId: string, outcome: ArcadeOutcomeKind, games?: readonly GemGameCard[], reason?: string): boolean;
@@ -1189,6 +1240,7 @@ declare class GemHost {
     grantLocalServer(grant: LocalServerGrant): boolean;
     denyLocalServer(denial: LocalServerDenial): boolean;
     sendClusterTarget(clusterTargets: string | readonly string[]): boolean;
+    sendGraphicsRoutes(entries: readonly GemGraphicsRouteEntry[]): boolean;
     sendPlayer(player: SendPlayerInput): void;
     private chainExpired;
     private localCorrelationId;
@@ -1381,8 +1433,11 @@ interface FrameCallbacks {
     onRelayDraining?(msg: GemRelayDraining): void;
     onDedicatedEvent?(msg: GemDedicatedEvent): void;
     onClusterTarget?(msg: GemClusterTarget): void;
+    onGraphicsRoutes?(msg: GemGraphicsRoutes): void;
     onPartyResult?(msg: GemPartyResult): void;
     onPurchaseResult?(msg: GemPurchaseResult): void;
+    onPurchaseSettled?(msg: GemPurchaseSettled): void;
+    onShareResult?(msg: GemShareResult): void;
     onDeviceSettings?(msg: GemDeviceSettings): void;
     onDeviceSettingsResult?(msg: GemDeviceSettingsResult): void;
     onAdResult?(msg: GemAdResult): void;
@@ -1449,7 +1504,7 @@ declare class GemFrame {
     requestShare(params: ReadonlyArray<{
         readonly key: string;
         readonly value: string;
-    }>): boolean;
+    }>, requestId?: string): boolean;
     requestAvatarPicker(tab?: "2d" | "3d"): boolean;
     requestVibrate(pattern: readonly number[]): boolean;
     reportFrameStats(stats: {
@@ -1461,7 +1516,7 @@ declare class GemFrame {
     signal(signal: string, matchId: string, data: Record<string, unknown>): void;
     dedicatedOffer(matchId: string, sdp: string, intent: GemDedicatedOffer["intent"]): void;
     requestParty(requestId: string): boolean;
-    requestPurchase(requestId: string, purchaseKind: "item" | "recipe", targetId: string, currencySlug: string, quantity?: number, catalogId?: string): boolean;
+    requestPurchase(requestId: string, purchaseKind: "item" | "recipe", targetId: string, currencySlug: string, quantity?: number, catalogId?: string, origin?: "sheet" | "direct_refused"): boolean;
     requestAvatar3dPurchase(requestId: string, itemId: string, currencySlug: string): boolean;
     putDeviceSettings(requestId: string, settings: Readonly<Record<string, unknown>>): boolean;
     requestAd(requestId: string, placement: string, format: "interstitial" | "rewarded"): boolean;
@@ -2765,4 +2820,4 @@ interface P2pMatchApi {
     session(matchId: string): P2pSession | null;
 }
 declare function createP2pApi(options: P2pApiOptions): P2pMatchApi;
-export { type ArcadeOutcomeKind, type AutoReconnectOptions, type AwaitMatchOptions, CAPABILITY_GATES, CAPABILITY_NAMESPACE_GATES, CHANNELS, CHANNEL_KINDS, type ChannelKind, type ClientPlatform, ClientTelemetry, type ClientTelemetryOptions, type ClientVersion, type Clock, type ClusterTarget, type ClusterTargetBridge, type ClusterTargetLike, type ClusterTargetListResolver, type ClusterTargetRefresher, type ClusterTargetResolver, type ClusterTargetSource, type ClusterTargetSourceOptions, type ConnectOptions, type CreateRoomOptions, INBOUND_EVENTS as DEDICATED_INBOUND_EVENTS, DEFAULT_WELCOME_CEILING_MS, DEVICE_SETTINGS_MAX_BYTES, type DataChannelLike$1 as DataChannelLike, type DedicatedServerApi, type DedicatedServerApiOptions, DedicatedServerError, type DedicatedServerFailure, type DedicatedServerSession, type DedicatedSignalTransport, DedicatedSignalingHub, type DedicatedSignalingOptions, type EstablishOptions, FRAME_TO_PARENT, type FailedMatch, type FrameCallbacks, type FrameMessage, type FrameOptions, type FrameState, type GemAdResult, type GemAppLinksResult, type GemArcadeOffer, type GemAudioState, type GemAutoStartFailedEvent, type GemCapability, type GemClusterTarget, type GemCohorts, type GemControlsDeclare, type GemDedicatedEvent, type GemDedicatedOffer, type GemDeviceSettings, type GemDeviceSettingsPut, type GemDeviceSettingsResult, type GemDevtools, type GemEarnAllowanceChanged, type GemEngaged, type GemError, type GemErrorCode, type GemExit, GemFrame, type GemFrameStats, type GemFriendChallengeResult, type GemGameCard, type GemGameContext, type GemGemCorner, type GemHandshake, type GemHandshakeAccept, GemHost, type GemLocalServer, type GemLocalServerDenied, type GemMenu, type GemMenuSelect, type GemMenuStyle, type GemMessage, type GemMomentResult, type GemOpenAppResult, type GemOpenExternal, type GemOpenGameResult, type GemPartyRequest, type GemPartyResult, type GemPause, type GemPlayer, type GemPortraitBorders, type GemPrefs, type GemProgress, type GemPurchaseResult, type GemReady, type GemRelayDraining, type GemRequestAd, type GemRequestAppLinks, type GemRequestAvatar3dPurchase, type GemRequestAvatarPicker, type GemRequestContext, type GemRequestFriendChallenge, type GemRequestFullscreen, type GemRequestLocalServer, type GemRequestOpenApp, type GemRequestOpenGame, type GemRequestPurchase, type GemRequestShare, type GemRequestSignIn, type GemRequestSimilarGames, type GemRequestStoreOfferSheet, type GemRequestStoreOffers, type GemRequestStorePurchase, type GemRequestToken, type GemRewardCue, type GemRoomEvent, type GemScreenshot, type GemScreenshotDenied, type GemSeatedEvent, type GemSettingChange, type GemSettingsDeclare, type GemSignInResult, type GemSignal, type GemSignalEvent, type GemSignalMoment, type GemSimilarGamesResult, type GemSocketState, type GemStoreOfferSheetResult, type GemStoreOffersResult, type GemStorePurchaseResult, type GemStorePurchaseSettled, type GemTicketEvent, type GemToken, type GemTokenDenied, type GemVibrate, type GemViewport, type GemWalletDisplay, type GemWillTerminate, HANDSHAKE_TIMEOUT_MS, type HandshakeEvent, type HostCallbacks, HostMigration, type HostOptions, type HostState, type JoinCredential, type JoinExchange, type JoinRoomOptions, type JoinWelcome, type KeySource, type ListRoomsOptions, MALFORMED_INBOUND_KEY, MAX_ARRAY_LENGTH, MAX_CLUSTER_TARGETS, MAX_MESSAGE_BYTES, MAX_MESSAGE_DEPTH, MAX_MESSAGE_NODES, MAX_SIGNALS_PER_SECOND, MAX_SOCKET_FRAME_BYTES, MIGRATION_TIMEOUT_MS, type MatchAutoStartFailed, type MatchConnectionState, type MatchEnded, type MatchOutcome, type MatchOutcomeWaitOptions, type MatchReconnected, type MatchReconnecting, type MatchSession, type MatchSessionPhase, type MatchSuspended, type MatchTicket, type MatchTicketOutcome, type MatchTicketStatus, type MigrationState, type OfferRefusal, type OfferRequest, P2pApi, type P2pConnectOptions, P2pError, type P2pEventMap, type P2pEventName, type P2pFailure, type P2pMatchApi, type P2pPeer, P2pSession, PARENT_TO_FRAME, PROTOCOL, type ParentMessage, type PartyBridge, type PartyEventRelay, type PartyResolver, type PartyResolverOptions, type PartyTicket, type PartyTicketOutcome, type PartyTicketStatus, type PeerConnectionLike$1 as PeerConnectionLike, type PlayWithOutcome, PlayerText, type PortLike, type PortMessageHandler, type PresentCredentialOptions, type PurchaseRefusalCode, type QueueForMatchOptions, type QuickJoinOptions, RATE_LIMITS, RateLimiter, type ReadyMatch, type Rejection, type RelayedDedicatedEvent, type RelayedRoomEvent, type RelayedSignal, type RelayedTicketEvent, type ResolvedClientVersion, type Room, type RoomArgEntry, type RoomArgScalar, type RoomArgType, type RoomArgValue, type RoomArgs, RoomEmitter, type RoomEventMap, type RoomEventName, type RoomManager, type RoomManagerOptions, type RoomMember, type RoomOperationError, type RoomPage, type RoomStatus, type RoomSummary, RoomsApi, type RoomsApiOptions, SUPPORTED_VERSIONS, type SdpType$1 as SdpType, type SendPlayerInput, type SessionDescriptionLike$1 as SessionDescriptionLike, type SignalTransport, type SignalingAnswer, type SignalingChannel, SignalingClient, type SignalingIntent, type StartMatchOptions, type StartedMatch$1 as StartedMatch, TELEMETRY_EVENTS, TRANSPORT_LABELS, type TelemetrySample, type TokenDenial, type TokenGrant, type TransportLabel, type TurnLease, type UpdateRoomOptions, VALIDATORS, type VerifiedCredential, WEBRTC_DEDICATED, WEBRTC_P2P, WEB_ENGINE_VERSION, WEB_PROTOCOL_VERSION, type WindowLike, asPlayerText, awaitMatchOutcome, browserPeerConnection, buildDedicatedOfferFrame, buildSocketFrame, capabilityFor, createClusterTargetSource, createDedicatedServerApi, createKeySource, createP2pApi, createPartyResolver, createRoomManager, deviceSettingsByteLength, establishDataChannel, fingerprintOf, fingerprintsMatch, generateCertificate, isOrigin, listClusterTargets, memberFromWire, negotiateVersion, normaliseClusterTarget, normaliseClusterTargets, normaliseFingerprint, originsEqual, presentJoinCredential, projectDedicatedEvent, projectPartyEvent, projectSignal, roomArgValuesFromWire, roomArgsTemplateFromWire, roomFromWire, startMatch, summaryFromWire, systemClock, text, unavailableSignaling, validateGemAdResult, validateGemAppLinksResult, validateGemAudioState, validateGemAutoStartFailedEvent, validateGemClusterTarget, validateGemCohorts, validateGemControlsDeclare, validateGemDedicatedEvent, validateGemDedicatedOffer, validateGemDeviceSettings, validateGemDeviceSettingsPut, validateGemDeviceSettingsResult, validateGemDevtools, validateGemEarnAllowanceChanged, validateGemEngaged, validateGemError, validateGemExit, validateGemFrameStats, validateGemFriendChallengeResult, validateGemGameContext, validateGemGemCorner, validateGemHandshake, validateGemHandshakeAccept, validateGemLocalServer, validateGemLocalServerDenied, validateGemMenu, validateGemMenuSelect, validateGemMenuStyle, validateGemMomentResult, validateGemOpenAppResult, validateGemOpenExternal, validateGemOpenGameResult, validateGemPartyRequest, validateGemPartyResult, validateGemPause, validateGemPlayer, validateGemPortraitBorders, validateGemPrefs, validateGemProgress, validateGemPurchaseResult, validateGemReady, validateGemRelayDraining, validateGemRequestAd, validateGemRequestAppLinks, validateGemRequestAvatar3dPurchase, validateGemRequestAvatarPicker, validateGemRequestContext, validateGemRequestFriendChallenge, validateGemRequestFullscreen, validateGemRequestLocalServer, validateGemRequestOpenApp, validateGemRequestOpenGame, validateGemRequestPurchase, validateGemRequestShare, validateGemRequestSignIn, validateGemRequestSimilarGames, validateGemRequestStoreOfferSheet, validateGemRequestStoreOffers, validateGemRequestStorePurchase, validateGemRequestToken, validateGemRewardCue, validateGemRoomEvent, validateGemScreenshot, validateGemScreenshotDenied, validateGemSeatedEvent, validateGemSettingChange, validateGemSettingsDeclare, validateGemSignInResult, validateGemSignal, validateGemSignalEvent, validateGemSignalMoment, validateGemSimilarGamesResult, validateGemSocketState, validateGemStoreOfferSheetResult, validateGemStoreOffersResult, validateGemStorePurchaseResult, validateGemStorePurchaseSettled, validateGemTicketEvent, validateGemToken, validateGemTokenDenied, validateGemVibrate, validateGemViewport, validateGemWalletDisplay, validateGemWillTerminate, validateSize, verifyCredential };
+export { type ArcadeOutcomeKind, type AutoReconnectOptions, type AwaitMatchOptions, BUILT_IN_GRAPHICS_ROUTES, CAPABILITY_GATES, CAPABILITY_NAMESPACE_GATES, CHANNELS, CHANNEL_KINDS, type ChannelKind, type ClientPlatform, ClientTelemetry, type ClientTelemetryOptions, type ClientVersion, type Clock, type ClusterTarget, type ClusterTargetBridge, type ClusterTargetLike, type ClusterTargetListResolver, type ClusterTargetRefresher, type ClusterTargetResolver, type ClusterTargetSource, type ClusterTargetSourceOptions, type ConnectOptions, type CreateRoomOptions, INBOUND_EVENTS as DEDICATED_INBOUND_EVENTS, DEFAULT_WELCOME_CEILING_MS, DEVICE_SETTINGS_MAX_BYTES, type DataChannelLike$1 as DataChannelLike, type DedicatedServerApi, type DedicatedServerApiOptions, DedicatedServerError, type DedicatedServerFailure, type DedicatedServerSession, type DedicatedSignalTransport, DedicatedSignalingHub, type DedicatedSignalingOptions, type EstablishOptions, FRAME_TO_PARENT, type FailedMatch, type FrameCallbacks, type FrameMessage, type FrameOptions, type FrameState, type GemAdResult, type GemAppLinksResult, type GemArcadeOffer, type GemAudioState, type GemAutoStartFailedEvent, type GemCapability, type GemClusterTarget, type GemCohorts, type GemControlsDeclare, type GemDedicatedEvent, type GemDedicatedOffer, type GemDeviceSettings, type GemDeviceSettingsPut, type GemDeviceSettingsResult, type GemDevtools, type GemEarnAllowanceChanged, type GemEngaged, type GemError, type GemErrorCode, type GemExit, GemFrame, type GemFrameStats, type GemFriendChallengeResult, type GemGameCard, type GemGameContext, type GemGemCorner, type GemGraphicsRouteEntry, type GemGraphicsRoutes, type GemHandshake, type GemHandshakeAccept, GemHost, type GemLocalServer, type GemLocalServerDenied, type GemMenu, type GemMenuSelect, type GemMenuStyle, type GemMessage, type GemMomentResult, type GemOpenAppResult, type GemOpenExternal, type GemOpenGameResult, type GemPartyRequest, type GemPartyResult, type GemPause, type GemPlayer, type GemPortraitBorders, type GemPrefs, type GemProgress, type GemPurchaseResult, type GemPurchaseSettled, type GemReady, type GemRelayDraining, type GemRequestAd, type GemRequestAppLinks, type GemRequestAvatar3dPurchase, type GemRequestAvatarPicker, type GemRequestContext, type GemRequestFriendChallenge, type GemRequestFullscreen, type GemRequestLocalServer, type GemRequestOpenApp, type GemRequestOpenGame, type GemRequestPurchase, type GemRequestShare, type GemRequestSignIn, type GemRequestSimilarGames, type GemRequestStoreOfferSheet, type GemRequestStoreOffers, type GemRequestStorePurchase, type GemRequestToken, type GemRewardCue, type GemRoomEvent, type GemScreenshot, type GemScreenshotDenied, type GemSeatedEvent, type GemSettingChange, type GemSettingsDeclare, type GemShareResult, type GemSignInResult, type GemSignal, type GemSignalEvent, type GemSignalMoment, type GemSimilarGamesResult, type GemSocketState, type GemStoreOfferSheetResult, type GemStoreOffersResult, type GemStorePurchaseResult, type GemStorePurchaseSettled, type GemTicketEvent, type GemToken, type GemTokenDenied, type GemVibrate, type GemViewport, type GemWalletDisplay, type GemWillTerminate, HANDSHAKE_TIMEOUT_MS, type HandshakeEvent, type HostCallbacks, HostMigration, type HostOptions, type HostState, type JoinCredential, type JoinExchange, type JoinRoomOptions, type JoinWelcome, type KeySource, type ListRoomsOptions, MALFORMED_INBOUND_KEY, MAX_ARRAY_LENGTH, MAX_CLUSTER_TARGETS, MAX_MESSAGE_BYTES, MAX_MESSAGE_DEPTH, MAX_MESSAGE_NODES, MAX_SIGNALS_PER_SECOND, MAX_SOCKET_FRAME_BYTES, MIGRATION_TIMEOUT_MS, type MatchAutoStartFailed, type MatchConnectionState, type MatchEnded, type MatchOutcome, type MatchOutcomeWaitOptions, type MatchReconnected, type MatchReconnecting, type MatchSession, type MatchSessionPhase, type MatchSuspended, type MatchTicket, type MatchTicketOutcome, type MatchTicketStatus, type MigrationState, type OfferRefusal, type OfferRequest, P2pApi, type P2pConnectOptions, P2pError, type P2pEventMap, type P2pEventName, type P2pFailure, type P2pMatchApi, type P2pPeer, P2pSession, PARENT_TO_FRAME, PROTOCOL, type ParentMessage, type PartyBridge, type PartyEventRelay, type PartyResolver, type PartyResolverOptions, type PartyTicket, type PartyTicketOutcome, type PartyTicketStatus, type PeerConnectionLike$1 as PeerConnectionLike, type PlayWithOutcome, PlayerText, type PortLike, type PortMessageHandler, type PresentCredentialOptions, type PurchaseRefusalCode, type QueueForMatchOptions, type QuickJoinOptions, RATE_LIMITS, RateLimiter, type ReadyMatch, type Rejection, type RelayedDedicatedEvent, type RelayedRoomEvent, type RelayedSignal, type RelayedTicketEvent, type ResolvedClientVersion, type Room, type RoomArgEntry, type RoomArgScalar, type RoomArgType, type RoomArgValue, type RoomArgs, RoomEmitter, type RoomEventMap, type RoomEventName, type RoomManager, type RoomManagerOptions, type RoomMember, type RoomOperationError, type RoomPage, type RoomStatus, type RoomSummary, RoomsApi, type RoomsApiOptions, SUPPORTED_VERSIONS, type SdpType$1 as SdpType, type SendPlayerInput, type SessionDescriptionLike$1 as SessionDescriptionLike, type SignalTransport, type SignalingAnswer, type SignalingChannel, SignalingClient, type SignalingIntent, type StartMatchOptions, type StartedMatch$1 as StartedMatch, TELEMETRY_EVENTS, TRANSPORT_LABELS, type TelemetrySample, type TokenDenial, type TokenGrant, type TransportLabel, type TurnLease, type UpdateRoomOptions, VALIDATORS, type VerifiedCredential, WEBRTC_DEDICATED, WEBRTC_P2P, WEB_ENGINE_VERSION, WEB_PROTOCOL_VERSION, type WindowLike, asPlayerText, awaitMatchOutcome, browserPeerConnection, buildDedicatedOfferFrame, buildSocketFrame, capabilityFor, createClusterTargetSource, createDedicatedServerApi, createKeySource, createP2pApi, createPartyResolver, createRoomManager, deviceSettingsByteLength, establishDataChannel, fingerprintOf, fingerprintsMatch, generateCertificate, isOrigin, listClusterTargets, memberFromWire, negotiateVersion, normaliseClusterTarget, normaliseClusterTargets, normaliseFingerprint, originsEqual, presentJoinCredential, projectDedicatedEvent, projectPartyEvent, projectSignal, roomArgValuesFromWire, roomArgsTemplateFromWire, roomFromWire, startMatch, summaryFromWire, systemClock, text, unavailableSignaling, validateGemAdResult, validateGemAppLinksResult, validateGemAudioState, validateGemAutoStartFailedEvent, validateGemClusterTarget, validateGemCohorts, validateGemControlsDeclare, validateGemDedicatedEvent, validateGemDedicatedOffer, validateGemDeviceSettings, validateGemDeviceSettingsPut, validateGemDeviceSettingsResult, validateGemDevtools, validateGemEarnAllowanceChanged, validateGemEngaged, validateGemError, validateGemExit, validateGemFrameStats, validateGemFriendChallengeResult, validateGemGameContext, validateGemGemCorner, validateGemGraphicsRoutes, validateGemHandshake, validateGemHandshakeAccept, validateGemLocalServer, validateGemLocalServerDenied, validateGemMenu, validateGemMenuSelect, validateGemMenuStyle, validateGemMomentResult, validateGemOpenAppResult, validateGemOpenExternal, validateGemOpenGameResult, validateGemPartyRequest, validateGemPartyResult, validateGemPause, validateGemPlayer, validateGemPortraitBorders, validateGemPrefs, validateGemProgress, validateGemPurchaseResult, validateGemPurchaseSettled, validateGemReady, validateGemRelayDraining, validateGemRequestAd, validateGemRequestAppLinks, validateGemRequestAvatar3dPurchase, validateGemRequestAvatarPicker, validateGemRequestContext, validateGemRequestFriendChallenge, validateGemRequestFullscreen, validateGemRequestLocalServer, validateGemRequestOpenApp, validateGemRequestOpenGame, validateGemRequestPurchase, validateGemRequestShare, validateGemRequestSignIn, validateGemRequestSimilarGames, validateGemRequestStoreOfferSheet, validateGemRequestStoreOffers, validateGemRequestStorePurchase, validateGemRequestToken, validateGemRewardCue, validateGemRoomEvent, validateGemScreenshot, validateGemScreenshotDenied, validateGemSeatedEvent, validateGemSettingChange, validateGemSettingsDeclare, validateGemShareResult, validateGemSignInResult, validateGemSignal, validateGemSignalEvent, validateGemSignalMoment, validateGemSimilarGamesResult, validateGemSocketState, validateGemStoreOfferSheetResult, validateGemStoreOffersResult, validateGemStorePurchaseResult, validateGemStorePurchaseSettled, validateGemTicketEvent, validateGemToken, validateGemTokenDenied, validateGemVibrate, validateGemViewport, validateGemWalletDisplay, validateGemWillTerminate, validateSize, verifyCredential };

package/dist/sdk.d.ts

@@ -631,6 +631,19 @@ type TrackDefinition = {
     "requires_item_id"?: string | null;
     "track_id": string;
 };
+type PurchaseRefusalCode = "unknown_currency" | "currency_not_in_game_payable" | "not_purchasable" | "no_price_in_currency" | "busy" | "cancelled" | "insufficient_funds" | "price_mismatch" | "config_version_stale" | "platform_currency_unavailable" | "not_available" | "recipe_locked" | "already_owned" | "guest_upgrade_required" | "recipe_on_cooldown" | "recipe_max_uses_exceeded" | "item_max_stack_exceeded" | "recipe_costs_unmet" | "quantity_invalid" | "error";
+declare class PurchaseRefusal extends RangeError {
+    readonly code: Extract<PurchaseRefusalCode, "unknown_currency" | "not_purchasable" | "no_price_in_currency" | "quantity_invalid">;
+    readonly retryable: false;
+    constructor(code: Extract<PurchaseRefusalCode, "unknown_currency" | "not_purchasable" | "no_price_in_currency" | "quantity_invalid">, message: string);
+}
+interface RefusedPurchase {
+    readonly kind: "item" | "recipe";
+    readonly targetId: string;
+    readonly catalogId?: string;
+    readonly currencySlug: string;
+    readonly quantity: number;
+}
 type CacheParam = string | number | boolean | undefined;
 declare class EntityReadCache {
     private readonly clock;
@@ -870,7 +883,8 @@ declare class MutationsApi {
     private readonly api;
     private readonly entity;
     private readonly cache;
-    constructor(api: GameApi$1, entity: EntityRef, cache: EntityReadCache);
+    private readonly handOffRefused?;
+    constructor(api: GameApi$1, entity: EntityRef, cache: EntityReadCache, handOffRefused?: ((refused: RefusedPurchase) => void) | undefined);
     create(operations: readonly InventoryOperation[], options?: OrderOptions): Promise<OrderResult>;
     createMany(orders: ReadonlyArray<readonly InventoryOperation[]>, options?: OrderOptions): Promise<unknown>;
     recipeAvailability(catalogId: string, recipeId: string, signal?: AbortSignal): Promise<RecipeAvailability>;
@@ -1511,7 +1525,7 @@ declare class FunctionsApi {
 }
 type SessionEndReason = "grant_expiring" | "session_ended" | "navigating" | "kill_switch" | "pagehide";
 type MatchTransport = "dedicated" | "p2p";
-type PlatformEventName = "gem_session_start" | "gem_session_end" | "gem_pause" | "gem_resume" | "gem_boot_ready" | "gem_match_started" | "gem_match_ended" | "gem_auth_lost";
+type PlatformEventName = "gem_session_start" | "gem_session_end" | "gem_pause" | "gem_resume" | "gem_boot_ready" | "gem_match_started" | "gem_match_ended" | "gem_auth_lost" | "gem_graphics_context_lost";
 declare const PLATFORM_EVENTS: readonly PlatformEventName[];
 type AnalyticsValue = string | number;
 interface AnalyticsRejection$1 {
@@ -1582,6 +1596,22 @@ interface BootTimelineOptions {
 declare function markOnResolve<T>(boot: BootTimeline, name: string, work: Promise<T>, log?: ((message: string) => void) | null): Promise<T>;
 declare function reportOnResolve(boot: BootTimeline, log?: ((message: string) => void) | null): <T>(work: Promise<T>) => Promise<T>;
 declare function createBootTimeline(options?: BootTimelineOptions): BootTimeline;
+type GemGraphicsRoute = "webgpu" | "webgl";
+interface GemPreferredRoute {
+    readonly route: GemGraphicsRoute;
+    readonly listed: boolean;
+}
+interface GemGraphicsRouteEntry {
+    readonly gpu: string;
+    readonly route?: string;
+    readonly host?: string;
+}
+interface PreferredRouteOptions {
+    readonly timeoutMs?: number;
+}
+interface GraphicsApi {
+    preferredRoute(options?: PreferredRouteOptions): Promise<GemPreferredRoute>;
+}
 type DevToolsOpener = "game" | "platform";
 interface GemDevTools {
     open(): Promise<boolean>;
@@ -2286,6 +2316,15 @@ interface GemClusterTarget {
     readonly clusterTargetId: string;
     readonly clusterTargetIds?: string[];
 }
+interface GemGraphicsRoutes {
+    readonly gem: typeof PROTOCOL;
+    readonly type: "gem.graphicsRoutes";
+    readonly entries: {
+        gpu: string;
+        route?: string;
+        host?: string;
+    }[];
+}
 interface GemScreenshotDenied {
     readonly gem: typeof PROTOCOL;
     readonly type: "gem.screenshot.denied";
@@ -2343,6 +2382,14 @@ interface GemSettingChange {
     readonly id: string;
     readonly value: boolean | number | string;
 }
+interface GemShareResult {
+    readonly gem: typeof PROTOCOL;
+    readonly type: "gem.shareResult";
+    readonly requestId: string;
+    readonly outcome: "accepted" | "refused";
+    readonly reason?: string;
+    readonly key?: string;
+}
 interface GemPurchaseResult {
     readonly gem: typeof PROTOCOL;
     readonly type: "gem.purchaseResult";
@@ -2351,6 +2398,15 @@ interface GemPurchaseResult {
     readonly reason?: string;
     readonly purchaseId?: string;
 }
+interface GemPurchaseSettled {
+    readonly gem: typeof PROTOCOL;
+    readonly type: "gem.purchaseSettled";
+    readonly purchaseKind: "item" | "recipe";
+    readonly targetId: string;
+    readonly catalogId?: string;
+    readonly quantity: number;
+    readonly purchaseId?: string;
+}
 interface GemDeviceSettingsResult {
     readonly gem: typeof PROTOCOL;
     readonly type: "gem.deviceSettings.result";
@@ -4660,12 +4716,6 @@ interface GemMatchApi {
     serve(server: GemMatchServerModule, options?: MatchServeOptions): Promise<MatchHosting>;
     connect(options?: MatchConnectOptions): Promise<MatchConnection>;
 }
-type PurchaseRefusalCode = "unknown_currency" | "currency_not_in_game_payable" | "not_purchasable" | "no_price_in_currency" | "busy" | "cancelled" | "insufficient_funds" | "price_mismatch" | "config_version_stale" | "platform_currency_unavailable" | "not_available" | "recipe_locked" | "already_owned" | "recipe_on_cooldown" | "recipe_max_uses_exceeded" | "item_max_stack_exceeded" | "recipe_costs_unmet" | "quantity_invalid" | "error";
-declare class PurchaseRefusal extends RangeError {
-    readonly code: Extract<PurchaseRefusalCode, "unknown_currency" | "not_purchasable" | "no_price_in_currency" | "quantity_invalid">;
-    readonly retryable: false;
-    constructor(code: Extract<PurchaseRefusalCode, "unknown_currency" | "not_purchasable" | "no_price_in_currency" | "quantity_invalid">, message: string);
-}
 interface PurchaseRequest {
     kind: "item" | "recipe";
     targetId: string;
@@ -4682,6 +4732,14 @@ type PurchaseOutcome = {
 };
 interface PurchaseApi {
     request(req: PurchaseRequest): Promise<PurchaseOutcome>;
+    onSettled(listener: (settlement: PurchaseSettlement) => void): () => void;
+}
+interface PurchaseSettlement {
+    readonly kind: "item" | "recipe";
+    readonly targetId: string;
+    readonly catalogId?: string;
+    readonly quantity: number;
+    readonly purchaseId: string;
 }
 interface Avatar3dPurchaseRequest {
     itemId: string;
@@ -4776,8 +4834,11 @@ interface FrameCallbacks {
     onRelayDraining?(msg: GemRelayDraining): void;
     onDedicatedEvent?(msg: GemDedicatedEvent): void;
     onClusterTarget?(msg: GemClusterTarget): void;
+    onGraphicsRoutes?(msg: GemGraphicsRoutes): void;
     onPartyResult?(msg: GemPartyResult): void;
     onPurchaseResult?(msg: GemPurchaseResult): void;
+    onPurchaseSettled?(msg: GemPurchaseSettled): void;
+    onShareResult?(msg: GemShareResult): void;
     onDeviceSettings?(msg: GemDeviceSettings): void;
     onDeviceSettingsResult?(msg: GemDeviceSettingsResult): void;
     onAdResult?(msg: GemAdResult): void;
@@ -4844,7 +4905,7 @@ declare class GemFrame {
     requestShare(params: ReadonlyArray<{
         readonly key: string;
         readonly value: string;
-    }>): boolean;
+    }>, requestId?: string): boolean;
     requestAvatarPicker(tab?: "2d" | "3d"): boolean;
     requestVibrate(pattern: readonly number[]): boolean;
     reportFrameStats(stats: {
@@ -4856,7 +4917,7 @@ declare class GemFrame {
     signal(signal: string, matchId: string, data: Record<string, unknown>): void;
     dedicatedOffer(matchId: string, sdp: string, intent: GemDedicatedOffer["intent"]): void;
     requestParty(requestId: string): boolean;
-    requestPurchase(requestId: string, purchaseKind: "item" | "recipe", targetId: string, currencySlug: string, quantity?: number, catalogId?: string): boolean;
+    requestPurchase(requestId: string, purchaseKind: "item" | "recipe", targetId: string, currencySlug: string, quantity?: number, catalogId?: string, origin?: "sheet" | "direct_refused"): boolean;
     requestAvatar3dPurchase(requestId: string, itemId: string, currencySlug: string): boolean;
     putDeviceSettings(requestId: string, settings: Readonly<Record<string, unknown>>): boolean;
     requestAd(requestId: string, placement: string, format: "interstitial" | "rewarded"): boolean;
@@ -4880,9 +4941,14 @@ declare class GemFrame {
 interface ShareRequest {
     readonly params?: Readonly<Record<string, string>>;
 }
+declare class ShareRefusal extends Error {
+    readonly reason: string;
+    readonly key?: string;
+    constructor(reason: string, key?: string);
+}
 interface ShareApi {
     readonly available: boolean;
-    request(request?: ShareRequest): void;
+    request(request?: ShareRequest): Promise<void>;
 }
 type ArcadeOutcomeKind = "ok" | "declined" | "unavailable";
 interface ArcadeOutcome {
@@ -5256,6 +5322,7 @@ interface Gem {
     readonly gameConfig: GameConfigApi;
     readonly purchases: PurchaseApi;
     readonly deviceSettings: DeviceSettingsApi;
+    readonly graphics: GraphicsApi;
     readonly moments: MomentsApi;
     readonly ads: AdsApi;
     readonly account: AccountApi;
@@ -5318,4 +5385,4 @@ interface ExitAnalytics {
 }
 declare function leaveAndExit(rooms: ExitRooms, bridge: ExitBridge | null, reason?: string, analytics?: ExitAnalytics): Promise<void>;
 declare function createGem(options?: GemOptions): Gem;
-export { ARCADE_EMBEDDERS, AVATAR_RIGS, type AccountApi, type AdFormat, type AdOutcome, type AdOutcomeKind, type AdRequest, type AdsApi, AnalyticsApi, type AnalyticsFlushOptions, type AnalyticsFlushResult, type AnalyticsOptions, type AnalyticsRejection$1 as AnalyticsRejection, type AnalyticsValue, type AppLinksOutcome, type AppListing, type AppStore, type ArcadeApi, type ArcadeAvailability, type ArcadeOffer, type ArcadeOutcome, type ArcadeOutcomeKind, AuthError, type AuthFailure, type AuthState, type Avatar3dFamily, type Avatar3dOffer, type Avatar3dPrice, type Avatar3dPurchaseRequest, type AvatarRigNode, type AvatarRigs, type Avatars3dApi, type Base64String, type BootMark, type BootTimeline, type BrandingApi, type BrandingAsset, type BrandingAssetOptions, type BrandingCurrency, type BrandingImageOptions, type BrandingList, type BrandingLookup, type BrandingTheme, type BrandingVariant, type BroadcastOptions, type BytesResponse, CONDITIONAL_HEADERS, type Challenge, type ChallengeWindow, ChallengesApi, type ClientOptions, type Clock, type ConditionalRequestHeaders, type ConfiguredPurchasePayment, type ConfiguredPurchaseRequest, type ConfiguredPurchaseResult, type ControlsApi, DEVICE_SETTINGS_MAX_BYTES, DedicatedServerError, type DedicatedServerFailure, type DedicatedServerSession, type DevToolsOpener, type DeviceSettings, type DeviceSettingsApi, type DeviceSettingsPutOutcome, type DirectPurchaseRequest, type DirectPurchaseResult, type EarnAllowance, type EarnAllowanceEvent, type EarnAllowancePeriod, type EarnAllowanceReadOptions, type EntityLeaderboard, type EntityLeaderboardEntry, type EntityLeaderboardOptions, type EntityType$1 as EntityType, type ExitAnalytics, type ExitBridge, type ExitRooms, type FrameState, type Friend, type FriendChallenge, FriendChallengeError, type FriendChallengeErrorCode, type FriendChallengeOutcome, type FriendChallengeOutcomeKind, type FriendChallengeRequest, type FriendChallengesPage, FriendsApi, type FriendsPage, type FunctionFailure, type FunctionInvokeOptions, type FunctionResult, FunctionsApi, type GameApi, type GameCard, type GameConfig, type GameMenu, type GameMenuItem, type GamePass, type GameServerLink, type GameSettingsApi, type Gem, GemApiError, type GemAudioChannels, GemClient, type GemCohort, type GemCohorts, GemConfigError, type GemControlBox, type GemCorner, type GemDevTools, type GemErrorReason, GemFrame, GemFunctionError, type GemGameChoiceSetting, type GemGameSetting, type GemGameSettingBase, type GemGameSettingChange, type GemGameSettingIcon, type GemGameSettingOption, type GemGameSettingValue, type GemGameSliderSetting, type GemGameToggleSetting, type GemGraphicsQuality, type GemIdentity, type GemInsets, type GemLook, type GemLookBase, type GemLookDelta, type GemLookOptions, type GemLookSpeed, type GemMatchApi, type GemMatchServer, type GemMatchServerModule, type GemOptions, type GemPlayer, type GemPrefs, type GemRecommendedSettings, type GemReservedArea, GemSaveError, type GemServer, type GemServerBundle, type GemServerFactory, type GemServerHost, type GemServerHostProfile, type GemServerIdentity, type GemServerLifecycle, type GemServerOptions, type GemServerProfile, type GemTerminationNotice, GemUnframedError, type GemViewport, type GetLeaderboardOptions, type HostTokenSource, type HostTokenSourceOptions, type JoinWelcome, type Leaderboard, type LeaderboardEntry, type LeaderboardPeriod, LeaderboardsApi, type ListChallengesOptions, type ListFriendChallengesOptions, type ListFriendsOptions, MAX_PERIODS_BACK, type MatchBackfillState, type MatchConnectOptions, type MatchConnection, type MatchHosting, type MatchHostingMode, type MatchPlayerReport, type MatchPlayerReportResult, type MatchServeOptions, type MatchTransport, type MenuStyle, type MessageMeta, type MomentKind, type MomentResult, type MomentSignal, type MomentsApi, type MultiTransportSession, PLATFORM_EVENTS, type PassesApi, type PassesEvent, type PeriodOptions, PlatformApi, PlatformCurrenciesApi, type PlatformCurrency, type PlatformCurrencyAccess, type PlatformCurrencyPurchasePayment, type PlatformCurrencyPurchaseRequest, type PlatformCurrencyPurchaseResult, type PlatformCurrencyReadOptions, PlatformEarnAllowanceApi, type PlatformEventName, type PlayerBadge$1 as PlayerBadge, type PlayerBoost, type PlayerBoostMultiplier, type PlayerIdentity, type PlayerProfile, type PlayerScope, PlayerText, type ProfileCallOptions, type ProfileShowcaseEntry$1 as ProfileShowcaseEntry, ProfilesApi, type PurchaseApi, type PurchaseOptions, type PurchaseOutcome, PurchaseRefusal, type PurchaseRefusalCode, type PurchaseRequest, type PutBytesOptions, type PutSaveOptions, type RankedRow, type RecipeAvailability, type RecipeLock, type RequestOptions, type RewardCue, type RewardedStatus, type RoomArgValue, type SavePage, type SaveRecord, type SendOptions$1 as SendOptions, type ServerApi, type ServerBundleHost, type ServerTokenGrant, type SessionEndReason, type ShareApi, type ShareRequest, ShowcaseApi, type ShowcaseCallOptions, type ShowcaseFriendEntry, type ShowcaseFriends, type ShowcaseValue, type SignInOutcome, type SignInOutcomeKind, type SimilarGamesOutcome, type SnapshotCurrency, type SnapshotItem, type StoreApi, type StoreOffersOutcome, type StoreSettlement, type TokenGrant, type Transport, type TransportAdvert, type TransportKind, TransportRefusal, type TransportRequest, type TransportResponse, UNRELIABLE_CHANNEL_LABEL, type VersionedGetOptions, type VersionedResponse, type VibrationApi, type WalletVisibleOptions, type WornAvatar3d$1 as WornAvatar3d, asPlayerText, createBootTimeline, createGem, createGemServer, createHostTokenSource, createMatchServer, defineServer, experimentSelection, leaveAndExit, mapIdentity, markOnResolve, platformIconUrl, presentJoinCredential, readTemplateTransports, readTransportAdvert, reportOnResolve, systemClock, text, toBase64, webTransportAvailable };
+export { ARCADE_EMBEDDERS, AVATAR_RIGS, type AccountApi, type AdFormat, type AdOutcome, type AdOutcomeKind, type AdRequest, type AdsApi, AnalyticsApi, type AnalyticsFlushOptions, type AnalyticsFlushResult, type AnalyticsOptions, type AnalyticsRejection$1 as AnalyticsRejection, type AnalyticsValue, type AppLinksOutcome, type AppListing, type AppStore, type ArcadeApi, type ArcadeAvailability, type ArcadeOffer, type ArcadeOutcome, type ArcadeOutcomeKind, AuthError, type AuthFailure, type AuthState, type Avatar3dFamily, type Avatar3dOffer, type Avatar3dPrice, type Avatar3dPurchaseRequest, type AvatarRigNode, type AvatarRigs, type Avatars3dApi, type Base64String, type BootMark, type BootTimeline, type BrandingApi, type BrandingAsset, type BrandingAssetOptions, type BrandingCurrency, type BrandingImageOptions, type BrandingList, type BrandingLookup, type BrandingTheme, type BrandingVariant, type BroadcastOptions, type BytesResponse, CONDITIONAL_HEADERS, type Challenge, type ChallengeWindow, ChallengesApi, type ClientOptions, type Clock, type ConditionalRequestHeaders, type ConfiguredPurchasePayment, type ConfiguredPurchaseRequest, type ConfiguredPurchaseResult, type ControlsApi, DEVICE_SETTINGS_MAX_BYTES, DedicatedServerError, type DedicatedServerFailure, type DedicatedServerSession, type DevToolsOpener, type DeviceSettings, type DeviceSettingsApi, type DeviceSettingsPutOutcome, type DirectPurchaseRequest, type DirectPurchaseResult, type EarnAllowance, type EarnAllowanceEvent, type EarnAllowancePeriod, type EarnAllowanceReadOptions, type EntityLeaderboard, type EntityLeaderboardEntry, type EntityLeaderboardOptions, type EntityType$1 as EntityType, type ExitAnalytics, type ExitBridge, type ExitRooms, type FrameState, type Friend, type FriendChallenge, FriendChallengeError, type FriendChallengeErrorCode, type FriendChallengeOutcome, type FriendChallengeOutcomeKind, type FriendChallengeRequest, type FriendChallengesPage, FriendsApi, type FriendsPage, type FunctionFailure, type FunctionInvokeOptions, type FunctionResult, FunctionsApi, type GameApi, type GameCard, type GameConfig, type GameMenu, type GameMenuItem, type GamePass, type GameServerLink, type GameSettingsApi, type Gem, GemApiError, type GemAudioChannels, GemClient, type GemCohort, type GemCohorts, GemConfigError, type GemControlBox, type GemCorner, type GemDevTools, type GemErrorReason, GemFrame, GemFunctionError, type GemGameChoiceSetting, type GemGameSetting, type GemGameSettingBase, type GemGameSettingChange, type GemGameSettingIcon, type GemGameSettingOption, type GemGameSettingValue, type GemGameSliderSetting, type GemGameToggleSetting, type GemGraphicsQuality, type GemGraphicsRoute, type GemGraphicsRouteEntry, type GemIdentity, type GemInsets, type GemLook, type GemLookBase, type GemLookDelta, type GemLookOptions, type GemLookSpeed, type GemMatchApi, type GemMatchServer, type GemMatchServerModule, type GemOptions, type GemPlayer, type GemPreferredRoute, type GemPrefs, type GemRecommendedSettings, type GemReservedArea, GemSaveError, type GemServer, type GemServerBundle, type GemServerFactory, type GemServerHost, type GemServerHostProfile, type GemServerIdentity, type GemServerLifecycle, type GemServerOptions, type GemServerProfile, type GemTerminationNotice, GemUnframedError, type GemViewport, type GetLeaderboardOptions, type GraphicsApi, type HostTokenSource, type HostTokenSourceOptions, type JoinWelcome, type Leaderboard, type LeaderboardEntry, type LeaderboardPeriod, LeaderboardsApi, type ListChallengesOptions, type ListFriendChallengesOptions, type ListFriendsOptions, MAX_PERIODS_BACK, type MatchBackfillState, type MatchConnectOptions, type MatchConnection, type MatchHosting, type MatchHostingMode, type MatchPlayerReport, type MatchPlayerReportResult, type MatchServeOptions, type MatchTransport, type MenuStyle, type MessageMeta, type MomentKind, type MomentResult, type MomentSignal, type MomentsApi, type MultiTransportSession, PLATFORM_EVENTS, type PassesApi, type PassesEvent, type PeriodOptions, PlatformApi, PlatformCurrenciesApi, type PlatformCurrency, type PlatformCurrencyAccess, type PlatformCurrencyPurchasePayment, type PlatformCurrencyPurchaseRequest, type PlatformCurrencyPurchaseResult, type PlatformCurrencyReadOptions, PlatformEarnAllowanceApi, type PlatformEventName, type PlayerBadge$1 as PlayerBadge, type PlayerBoost, type PlayerBoostMultiplier, type PlayerIdentity, type PlayerProfile, type PlayerScope, PlayerText, type PreferredRouteOptions, type ProfileCallOptions, type ProfileShowcaseEntry$1 as ProfileShowcaseEntry, ProfilesApi, type PurchaseApi, type PurchaseOptions, type PurchaseOutcome, PurchaseRefusal, type PurchaseRefusalCode, type PurchaseRequest, type PurchaseSettlement, type PutBytesOptions, type PutSaveOptions, type RankedRow, type RecipeAvailability, type RecipeLock, type RequestOptions, type RewardCue, type RewardedStatus, type RoomArgValue, type SavePage, type SaveRecord, type SendOptions$1 as SendOptions, type ServerApi, type ServerBundleHost, type ServerTokenGrant, type SessionEndReason, type ShareApi, ShareRefusal, type ShareRequest, ShowcaseApi, type ShowcaseCallOptions, type ShowcaseFriendEntry, type ShowcaseFriends, type ShowcaseValue, type SignInOutcome, type SignInOutcomeKind, type SimilarGamesOutcome, type SnapshotCurrency, type SnapshotItem, type StoreApi, type StoreOffersOutcome, type StoreSettlement, type TokenGrant, type Transport, type TransportAdvert, type TransportKind, TransportRefusal, type TransportRequest, type TransportResponse, UNRELIABLE_CHANNEL_LABEL, type VersionedGetOptions, type VersionedResponse, type VibrationApi, type WalletVisibleOptions, type WornAvatar3d$1 as WornAvatar3d, asPlayerText, createBootTimeline, createGem, createGemServer, createHostTokenSource, createMatchServer, defineServer, experimentSelection, leaveAndExit, mapIdentity, markOnResolve, platformIconUrl, presentJoinCredential, readTemplateTransports, readTransportAdvert, reportOnResolve, systemClock, text, toBase64, webTransportAvailable };

package/docs/analytics.md

@@ -131,10 +131,22 @@ and a game that declares no events at all still gets them:
 | `gem_boot_ready`                   | —                                | `boot_ms`     |
 | `gem_match_started` / `gem_match_ended` | `transport` (`dedicated`, `p2p`) | —        |
 | `gem_auth_lost`                    | —                                | —             |
+| `gem_graphics_context_lost`        | `gpu`, `host`, `route`           | `context_ms`, `hidden`, `nth_loss` |
 
 `reason` on a session end is one of `grant_expiring`, `session_ended`, `navigating`,
 `kill_switch` or `pagehide`.
 
+`gem_graphics_context_lost` is the browser taking one of your WebGL contexts away, or a WebGPU
+device your game made (then `route` is `webgpu`) — on a phone usually a GPU driver fault rather
+than your code. A WebGPU device your game destroys itself is not counted. `gpu` is the GPU family (`powervr_d_series`,
+`powervr_other`, `adreno`, `mali`, `xclipse`, `apple`, `nvidia`, `amd`, `intel`, `software`,
+`other`, `unknown`), `route` is how the browser drives it (`angle_gles`, `angle_vulkan`,
+`angle_d3d11`, `angle_d3d9`, `angle_metal`, `angle_opengl`, `angle_other`, `native_gl`, `webgpu`,
+`unknown`) and `host` is `android_webview` (the Arcade app) or `other`. `hidden` is 1 when the page
+was hidden at the time, which is a phone reclaiming a backgrounded game's memory rather than a
+crash in front of the player. It is sent whether or not your game recovers from the loss, at most
+five times a page.
+
 **The `gem_` prefix is reserved.** Your config cannot declare an id beginning with it and
 `gem.analytics.track` refuses one rather than sending it, so pick another name.
 

package/docs/api/api-reference-function.md

@@ -1,6 +1,6 @@
 # The function surface — API reference
 
-Generated from `@indiegems/gem-web-sdk/function` v20.1.0, the version of the package this file ships in. Every symbol below carries an explicit anchor, its `anchor` in `reference.json` beside this file.
+Generated from `@indiegems/gem-web-sdk/function` v21.1.0, the version of the package this file ships in. Every symbol below carries an explicit anchor, its `anchor` in `reference.json` beside this file.
 
 `@indiegems/gem-web-sdk/function` exports exactly the symbols on this page and nothing else.
 
@@ -470,7 +470,7 @@ the reading a funnel should treat as approximate.
 ## PlatformEventName
 
 ```ts
-type PlatformEventName = "gem_session_start" | "gem_session_end" | "gem_pause" | "gem_resume" | "gem_boot_ready" | "gem_match_started" | "gem_match_ended" | "gem_auth_lost"
+type PlatformEventName = "gem_session_start" | "gem_session_end" | "gem_pause" | "gem_resume" | "gem_boot_ready" | "gem_match_started" | "gem_match_ended" | "gem_auth_lost" | "gem_graphics_context_lost"
 ```
 
 Every event the SDK emits by itself.
@@ -488,6 +488,12 @@ config names them as steps.
 | `gem_boot_ready` | — | `boot_ms` |
 | `gem_match_started` / `gem_match_ended` | `transport` (`MatchTransport`) | — |
 | `gem_auth_lost` | — | — |
+| `gem_graphics_context_lost` | `gpu`, `host`, `route` | `context_ms`, `hidden`, `nth_loss` |
+
+`gem_graphics_context_lost` is the browser taking a WebGL context away, or a
+WebGPU device (`route` is then `webgpu`) — usually a GPU driver fault, sized
+per device across every game (`analytics/graphics.ts` lists the dimension
+values).
 
 <a id="gemerrorreason"></a>
 
@@ -3060,6 +3066,12 @@ platform's own refusals arrive as a `GemApiError` whose `code` is its wire
 code — `insufficient_funds`, `recipe_locked`, `price_mismatch`, … Never
 draw a top-up or payment screen of your own for either.
 
+`guest_upgrade_required` means the player is a guest, and the platform
+lets only an account spend. TREAT IT LIKE A DECLINE AND DRAW NOTHING: the
+SDK has already handed the attempt to the arcade, which offers the player
+an account over your game. The call rejects at once rather than waiting
+for them; if they make one and buy, `PurchaseApi.onSettled` hears it.
+
 | Parameter | Type |
 | --- | --- |
 | `request` | `ConfiguredPurchaseRequest` |