@my-swu/simulator-client 0.1.1 → 0.1.3

package/dist/match-session/session-state.d.ts

@@ -100,11 +100,25 @@ export interface MatchSessionAutoReconnectPolicy {
     maxDelayMs?: number | undefined;
     /** Multiplier applied to each subsequent delay. */
     backoffFactor?: number | undefined;
+    /**
+     * Detect sockets that remain reported as open after their transport path
+     * stops delivering server messages. Enabled by default with auto-reconnect.
+     */
+    heartbeat?: MatchSessionHeartbeatOptions | undefined;
 }
 /**
  * Automatic reconnect setting for one match session.
  */
 export type MatchSessionAutoReconnectOptions = boolean | MatchSessionAutoReconnectPolicy;
+/** Settings for the ping/pong liveness check owned by an auto-reconnecting session. */
+export interface MatchSessionHeartbeatPolicy {
+    /** Delay between a successful pong and the next liveness ping. */
+    intervalMs?: number | undefined;
+    /** Maximum time to wait for the matching pong before reconnecting. */
+    timeoutMs?: number | undefined;
+}
+/** Enable, disable, or configure session heartbeat detection. */
+export type MatchSessionHeartbeatOptions = boolean | MatchSessionHeartbeatPolicy;
 /** Progress of automatic recovery after an abnormal match socket close. */
 export type MatchSessionReconnectState = {
     phase: 'idle';
@@ -118,10 +132,14 @@ export type MatchSessionReconnectState = {
     attempt: number;
     maxAttempts: number;
 } | {
-    phase: 'exhausted';
+    phase: 'terminal';
     attempts: number;
     maxAttempts: number;
+    cause: MatchSessionTerminalCause;
+    error: ErrorPayload;
 };
+/** Server or transport condition which stopped automatic reconnect retries. */
+export type MatchSessionTerminalCause = 'matchNotFound' | 'invalidCredentials' | 'retriesExhausted';
 /**
  * Options for creating one SDK-owned match session.
  *

package/dist/match-session/types.d.ts

@@ -3,7 +3,7 @@ import type { MatchHistoryFeedEntry } from '../generated/types/server-message.js
 import type { ConnectionState } from '../session.js';
 import type { MatchSessionMethods } from './methods.js';
 import type { MatchSeat, MatchSessionReconnectState, MatchSessionState } from './session-state.js';
-export type { MatchSeat, MatchSessionAccess, MatchSessionAutoReconnectOptions, MatchSessionAutoReconnectPolicy, MatchSessionConnectOptions, MatchSessionEvents, MatchSessionOptions, MatchSessionReconnectState, MatchSessionSnapshotPredicate, MatchSessionState, MatchSessionWaitOptions, } from './session-state.js';
+export type { MatchSeat, MatchSessionAccess, MatchSessionAutoReconnectOptions, MatchSessionAutoReconnectPolicy, MatchSessionConnectOptions, MatchSessionEvents, MatchSessionHeartbeatOptions, MatchSessionHeartbeatPolicy, MatchSessionOptions, MatchSessionReconnectState, MatchSessionSnapshotPredicate, MatchSessionState, MatchSessionTerminalCause, MatchSessionWaitOptions, } from './session-state.js';
 /**
  * Main ergonomic SDK API for interacting with one live match.
  *

package/dist/match-session.d.ts

@@ -1,3 +1,3 @@
 export { MatchSessionController } from './match-session/controller.js';
 export type { MatchSessionControllerOptions } from './match-session/controller.js';
-export type { MatchSeat, MatchSession, MatchSessionAccess, MatchSessionAutoReconnectOptions, MatchSessionAutoReconnectPolicy, MatchSessionConnectOptions, MatchSessionEvents, MatchSessionOptions, MatchSessionReconnectState, MatchSessionSnapshotPredicate, MatchSessionState, MatchSessionWaitOptions, } from './match-session/types.js';
+export type { MatchSeat, MatchSession, MatchSessionAccess, MatchSessionAutoReconnectOptions, MatchSessionAutoReconnectPolicy, MatchSessionConnectOptions, MatchSessionEvents, MatchSessionHeartbeatOptions, MatchSessionHeartbeatPolicy, MatchSessionOptions, MatchSessionReconnectState, MatchSessionTerminalCause, MatchSessionSnapshotPredicate, MatchSessionState, MatchSessionWaitOptions, } from './match-session/types.js';

package/dist/resources/admin.d.ts

@@ -1,4 +1,4 @@
-import type { SimulatorReportListResponse, SimulatorReportResponse, CardCatalogRefreshResponse, CreateMetaWindowRequest, MatchChatLookupResponse, MetaWindowsResponse, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedProfileRequest, RankedProfileResponse, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SimulatorAdminStatusResponse } from '../generated/index.js';
+import type { AdminMatchDebugBundle, AdminMatchListResponse, AdminMatchReplayResponse, SimulatorReportListResponse, SimulatorReportResponse, CardCatalogRefreshResponse, CreateMetaWindowRequest, MatchChatLookupResponse, MetaWindowsResponse, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedProfileRequest, RankedProfileResponse, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SimulatorAdminStatusResponse } from '../generated/index.js';
 import type { SimulatorRequestOptions } from '../http/options.js';
 import type { EngineHttpRequester } from '../http/request.js';
 /**
@@ -10,6 +10,13 @@ export interface SimulatorReportListOptions {
     cursor?: string;
     limit?: number;
 }
+/** Filters and cursor pagination controls for durable simulator admin games. */
+export interface AdminGameListOptions {
+    matchId?: string;
+    playerSearch?: string;
+    cursor?: string;
+    limit?: number;
+}
 /**
  * Bearer-token credentials for simulator admin calls.
  */
@@ -23,6 +30,12 @@ export interface SimulatorAdminAuth {
  * Simulator administration API methods.
  */
 export interface AdminResource {
+    /** Lists durable saved and completed matches for simulator support work. */
+    listGames(auth: SimulatorAdminAuth, query?: AdminGameListOptions, options?: SimulatorRequestOptions): Promise<AdminMatchListResponse>;
+    /** Returns all durable diagnostics for one match with restore credentials removed. */
+    getGameDebugBundle(auth: SimulatorAdminAuth, historyId: string, options?: SimulatorRequestOptions): Promise<AdminMatchDebugBundle>;
+    /** Returns a completed replay archive for one match. */
+    getGameReplay(auth: SimulatorAdminAuth, historyId: string, options?: SimulatorRequestOptions): Promise<AdminMatchReplayResponse>;
     /** Lists safe metadata for retained simulator diagnostic reports. */
     listSimulatorReports(auth: SimulatorAdminAuth, query?: SimulatorReportListOptions, options?: SimulatorRequestOptions): Promise<SimulatorReportListResponse>;
     /** Returns one full sanitized simulator support bundle. */

package/dist/resources/admin.js

@@ -4,6 +4,9 @@ import { jsonBody, jsonHeaders } from '../http/json.js';
  */
 export function createAdminResource(requester) {
     return {
+        listGames: (auth, query, options) => requester.request('admin-match-list-response', adminGamesPath(query ?? {}), { headers: authHeaders(auth) }, options),
+        getGameDebugBundle: (auth, historyId, options) => requester.request('admin-match-debug-bundle', `/api/admin/games/${encodeURIComponent(historyId)}/debug`, { headers: authHeaders(auth) }, options),
+        getGameReplay: (auth, historyId, options) => requester.request('admin-match-replay-response', `/api/admin/games/${encodeURIComponent(historyId)}/replay`, { headers: authHeaders(auth) }, options),
         listSimulatorReports: (auth, query, options) => requester.request('simulator-report-list-response', simulatorReportsPath(query ?? {}), { headers: authHeaders(auth) }, options),
         getSimulatorReport: (auth, reportId, options) => requester.request('simulator-report-response', `/api/admin/reports/${encodeURIComponent(reportId)}`, { headers: authHeaders(auth) }, options),
         refreshCardCatalog: (auth, options) => requester.request('card-catalog-refresh-response', '/api/admin/card-catalog/refresh', { headers: authHeaders(auth), method: 'POST' }, options),
@@ -34,6 +37,24 @@ export function createAdminResource(requester) {
         rankedLeaderboard: (auth, windowId, query, options) => requester.request('ranked-leaderboard-response', leaderboardPath(requester, windowId, query ?? {}), { headers: authHeaders(auth) }, options),
     };
 }
+/** Builds an encoded durable-game query without exposing the route shape. */
+function adminGamesPath(options) {
+    const parameters = new URLSearchParams();
+    if (options.matchId) {
+        parameters.set('matchId', options.matchId);
+    }
+    if (options.playerSearch) {
+        parameters.set('playerSearch', options.playerSearch);
+    }
+    if (options.cursor) {
+        parameters.set('cursor', options.cursor);
+    }
+    if (options.limit != null) {
+        parameters.set('limit', String(options.limit));
+    }
+    const suffix = parameters.size === 0 ? '' : `?${parameters.toString()}`;
+    return `/api/admin/games${suffix}`;
+}
 /** Builds a report-list path without exposing pagination implementation. */
 function simulatorReportsPath(options) {
     const parameters = new URLSearchParams();

package/dist/resources/lobby-types.d.ts

@@ -62,9 +62,9 @@ export type LobbyConfig = {
 export interface CreateLobbyRequest {
     config: LobbyConfig;
     /** Fixed limited pack/leader seed. */
-    packSeed?: number | null;
+    packSeed?: string | null;
     /** Fixed match seed reused for limited duel matches. */
-    matchSeed?: number | null;
+    matchSeed?: string | null;
     /** Whether the lobby should appear in public browsing surfaces. */
     visibility: LobbyVisibility;
     hostName: string;
@@ -183,9 +183,9 @@ export interface LobbySnapshot {
     visibility: LobbyVisibility;
     config: LobbyConfig;
     /** Fixed limited pack/leader seed when configured. */
-    packSeed?: number | null;
+    packSeed?: string | null;
     /** Fixed match seed when configured. */
-    matchSeed?: number | null;
+    matchSeed?: string | null;
     hostPlayerId: string;
     requiredPlayerCount: number;
     /** Absolute server deadline for the ready-lobby auto-start countdown. */

package/dist/resources/match-history.d.ts

@@ -1,4 +1,4 @@
-import type { MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, RestoreHistoryResponse } from '../generated/index.js';
+import type { CreateMatchHistoryReplayShareRequest, CreateMatchHistoryReplayShareResponse, MatchRecoveryRequest, MatchRecoveryResponse, MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, RestoreHistoryResponse, SharedMatchHistoryReplayResponse } from '../generated/index.js';
 import type { SimulatorRequestOptions } from '../http/options.js';
 import type { EngineHttpRequester } from '../http/request.js';
 /**
@@ -10,11 +10,18 @@ export interface MatchHistoryRestoreInput extends MatchHistoryRestoreRequest {
      */
     historyId: string;
 }
+/** Recovery request for a source runtime that is no longer available. */
+export type MatchRecoveryInput = MatchRecoveryRequest;
 /** Request used to load a completed server-side replay archive. */
 export interface MatchHistoryReplayInput extends MatchHistoryReplayRequest {
     /** Durable history row id returned by {@link MatchHistoryResource.list}. */
     historyId: string;
 }
+/** Participant-authorized request that creates one scoped replay-share link. */
+export interface CreateMatchHistoryReplayShareInput extends CreateMatchHistoryReplayShareRequest {
+    /** Durable history row id returned by {@link MatchHistoryResource.list}. */
+    historyId: string;
+}
 /**
  * Server-owned simulator history APIs.
  */
@@ -29,10 +36,16 @@ export interface MatchHistoryResource {
     list(request: MatchHistoryListRequest, options?: SimulatorRequestOptions): Promise<MatchHistoryListResponse>;
     /** Loads public and post-game reveal-all frames for an authorized result. */
     replay(request: MatchHistoryReplayInput, options?: SimulatorRequestOptions): Promise<MatchHistoryReplayResponse>;
+    /** Creates or returns a stable opaque replay link for one disclosure scope. */
+    createReplayShare(request: CreateMatchHistoryReplayShareInput, options?: SimulatorRequestOptions): Promise<CreateMatchHistoryReplayShareResponse>;
+    /** Loads a replay through an opaque link without participant identities. */
+    loadReplayShare(shareToken: string, options?: SimulatorRequestOptions): Promise<SharedMatchHistoryReplayResponse>;
     /**
      * Restores one authorized row whose eligibility is `available`.
      */
     restore(request: MatchHistoryRestoreInput, options?: SimulatorRequestOptions): Promise<RestoreHistoryResponse>;
+    /** Restores an owned Solo-versus-AI source after its runtime is lost. */
+    recover(request: MatchRecoveryInput, options?: SimulatorRequestOptions): Promise<MatchRecoveryResponse>;
 }
 /**
  * Dependencies needed by the match-history resource.

package/dist/resources/match-history.js

@@ -22,6 +22,17 @@ export function createMatchHistoryResource(options) {
             headers: jsonHeaders(),
             method: 'POST',
         }, options),
+        createReplayShare: (request, options) => requester.request('create-match-history-replay-share-response', `/api/match-history/${request.historyId}/replay-shares`, {
+            body: jsonBody(requester.validate('create-match-history-replay-share-request', {
+                identities: request.identities,
+                includeHiddenInformation: request.includeHiddenInformation,
+            })),
+            headers: jsonHeaders(),
+            method: 'POST',
+        }, options),
+        loadReplayShare: (shareToken, options) => requester.request('shared-match-history-replay-response', `/api/match-history/replay-shares/${shareToken}`, {
+            method: 'GET',
+        }, options),
         restore: (request, options) => requester.request('restore-history-response', `/api/match-history/${request.historyId}/restore`, {
             body: jsonBody(requester.validate('match-history-restore-request', {
                 identities: request.identities,
@@ -30,5 +41,10 @@ export function createMatchHistoryResource(options) {
             headers: jsonHeaders(),
             method: 'POST',
         }, options),
+        recover: (request, options) => requester.request('match-recovery-response', '/api/match-history/recover', {
+            body: jsonBody(requester.validate('match-recovery-request', request)),
+            headers: jsonHeaders(),
+            method: 'POST',
+        }, options),
     };
 }

package/dist/resources/match-types.d.ts

@@ -1,4 +1,4 @@
-import type { AiStatusPayload, CreateMatchRequest, GameState, JoinMatchRequest, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessResponse, MatchSpectatorAccessResponse, MatchSavePayload, RematchMatchResponse, RestoreMatchSaveResponse, SpectateMatchRequest, SubmitMatchDeckRequest } from '../generated/index.js';
+import type { AiStatusPayload, CreateMatchRequest, GameState, JoinMatchRequest, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessRecoveryRequest, MatchAccessRecoveryResponse, MatchAccessResponse, MatchSpectatorAccessResponse, MatchSavePayload, RematchMatchResponse, RestoreMatchSaveResponse, SpectateMatchRequest, SubmitMatchDeckRequest } from '../generated/index.js';
 import type { FormatEventCommand } from '../generated/types/format-event-request.js';
 import type { SimulatorRequestOptions } from '../http/options.js';
 /**
@@ -87,7 +87,7 @@ export interface MatchAccessInput extends MatchReference {
     /**
      * Resolved seed for a private solo-vs-AI match, retained across reconnects.
      */
-    replaySeed?: number;
+    replaySeed?: string;
 }
 export interface MatchSpectatorAccessInput extends MatchReference {
     /**
@@ -134,6 +134,15 @@ export type MatchConnectionAccessInput = MatchAccessInput | MatchSpectatorAccess
  * @see https://simulator-sdk.my-swu.com/guide/match-session
  */
 export interface MatchesResource {
+    /** Refreshes private seat access after validating its existing seat token. */
+    refreshAccess(access: MatchAccessInput, options?: SimulatorRequestOptions): Promise<MatchAccess>;
+    /**
+     * Recovers current host access for an owned remote Solo-versus-AI match.
+     *
+     * `unavailable` intentionally hides whether the match is absent, no longer
+     * resumable, or not owned by the supplied history identities.
+     */
+    recoverAccess(match: MatchReference, request: MatchAccessRecoveryRequest, options?: SimulatorRequestOptions): Promise<MatchAccessRecoveryResponse>;
     /** Records an intentional player departure without conceding the match. */
     leave(access: MatchAccessInput, options?: SimulatorRequestOptions): Promise<void>;
     /**

package/dist/resources/matches.js

@@ -5,6 +5,16 @@ import { jsonBody, jsonHeaders } from '../http/json.js';
 export function createMatchesResource(options) {
     const { requester } = options;
     return {
+        refreshAccess: (access, requestOptions) => requester.request('match-access-response', `/api/matches/${matchIdFrom(access)}/access`, {
+            body: jsonBody(requester.validate('save-match-request', { seatToken: access.seatToken })),
+            headers: jsonHeaders(),
+            method: 'POST',
+        }, requestOptions),
+        recoverAccess: (match, request, options) => requester.request('match-access-recovery-response', `/api/matches/${matchIdFrom(match)}/recover-access`, {
+            body: jsonBody(requester.validate('match-access-recovery-request', request)),
+            headers: jsonHeaders(),
+            method: 'POST',
+        }, options),
         leave: (access, options) => requester.request('leave-match-response', `/api/matches/${matchIdFrom(access)}/leave`, {
             body: jsonBody(requester.validate('leave-match-request', { seatToken: access.seatToken })),
             headers: jsonHeaders(),

package/dist/validators.d.ts

@@ -1,4 +1,4 @@
-import type { SimulatorReportListResponse, SimulatorReportResponse, CloseTournamentRoomRequest, AbandonMatchRequest, AbandonMatchResponse, AddLobbyAiPlayerRequest, ApiErrorResponse, CardCatalogRefreshResponse, CardsResponse, ClientMessage, CreateLimitedEventRequest, CreateLobbyRequest, CreateMetaWindowRequest, CreateMatchRequest, CreateTournamentRoomRequest, CreateTournamentTableRequest, ErrorPayload, FormatEventRequest, FormatEventResponse, GameCommand, GameEvent, GameState, GetMatchResponse, HealthResponse, JoinLimitedEventRequest, JoinLobbyRequest, JoinMatchRequest, JoinTournamentRoomRequest, JoinTournamentTableRequest, KickLobbyPlayerRequest, KickLobbySpectatorRequest, LeaveLobbyRequest, LeaveMatchRequest, LeaveMatchResponse, LeaveTournamentRoomRequest, LimitedEventAccessResponse, LimitedEventCommandRequest, LimitedEventPreflightResponse, LimitedEventResponse, LobbyAccessResponse, LobbyChatRequest, LobbyChatResponse, LobbyListResponse, LobbyListServerMessage, LobbyMatchmakingDecisionRequest, PrepareLobbyLimitedAiDecksRequest, LobbyResponse, LobbyServerMessage, LobbySyncRequest, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessResponse, MatchChatLookupResponse, MatchConnectionRole, MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryEntry, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, RestoreHistoryResponse, MatchSavePayload, MatchSpectatorAccessResponse, MetaWindow, MetaWindowsResponse, LobbyMatchmakingRequest, ResolveCardIdsRequest, ResolveCardIdsResponse, RankedAdminStatus, RankedLeaderboardEntry, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedMatchmakingView, RankedProfileRequest, RankedProfileResponse, RankedQueue, RematchMatchRequest, RematchMatchResponse, SaveMatchRequest, ReturnLobbyMatchRequest, ReturnTournamentMatchRequest, RestoreMatchSaveRequest, RestoreMatchSaveResponse, ServerMessage, AiStatusPayload, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SetAiPausedRequest, SimulatorAdminStatusResponse, SimulatorAvailabilityResponse, SpectateLobbyRequest, SpectateMatchRequest, StartLobbyLimitedMatchRequest, StartLobbyRequest, StartTournamentEventRequest, SubmitLobbyLimitedDeckRequest, SubmitMatchDeckRequest, SubmitMatchDeckResponse, SubmitTournamentDeckRequest, TournamentEventCommandRequest, TournamentRoomAccessResponse, TournamentRoomChatRequest, TournamentRoomChatResponse, TournamentRoomListResponse, TournamentRoomResponse, TournamentRoomServerMessage, TournamentRoomSyncRequest, UndoMatchRequest, UndoMatchResponse, UndoRespondMatchRequest, UpdateLobbyAiPlayerRequest, UpdateLobbyPlayerRequest, UpdateLobbySettingsRequest, UpdateTournamentRoomPlayerRequest, UpdateTournamentRoomSettingsRequest, WelcomePayload } from './generated/index.js';
+import type { AdminMatchDebugBundle, AdminMatchListResponse, AdminMatchReplayResponse, SimulatorReportListResponse, SimulatorReportResponse, CloseTournamentRoomRequest, AbandonMatchRequest, AbandonMatchResponse, AddLobbyAiPlayerRequest, ApiErrorResponse, CardCatalogRefreshResponse, CardsResponse, ClientMessage, CreateMatchHistoryReplayShareRequest, CreateMatchHistoryReplayShareResponse, CreateLimitedEventRequest, CreateLobbyRequest, CreateMetaWindowRequest, CreateMatchRequest, CreateTournamentRoomRequest, CreateTournamentTableRequest, ErrorPayload, FormatEventRequest, FormatEventResponse, GameCommand, GameEvent, GameState, GetMatchResponse, HealthResponse, JoinLimitedEventRequest, JoinLobbyRequest, JoinMatchRequest, JoinTournamentRoomRequest, JoinTournamentTableRequest, KickLobbyPlayerRequest, KickLobbySpectatorRequest, LeaveLobbyRequest, LeaveMatchRequest, LeaveMatchResponse, LeaveTournamentRoomRequest, LimitedEventAccessResponse, LimitedEventCommandRequest, LimitedEventPreflightResponse, LimitedEventResponse, LobbyAccessResponse, LobbyChatRequest, LobbyChatResponse, LobbyListResponse, LobbyListServerMessage, LobbyMatchmakingDecisionRequest, PrepareLobbyLimitedAiDecksRequest, LobbyResponse, LobbyServerMessage, LobbySyncRequest, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessRecoveryRequest, MatchAccessRecoveryResponse, MatchAccessResponse, MatchChatLookupResponse, MatchConnectionRole, MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryEntry, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, MatchRecoveryRequest, MatchRecoveryResponse, RestoreHistoryResponse, MatchSavePayload, MatchSpectatorAccessResponse, MetaWindow, MetaWindowsResponse, LobbyMatchmakingRequest, ResolveCardIdsRequest, ResolveCardIdsResponse, RankedAdminStatus, RankedLeaderboardEntry, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedMatchmakingView, RankedProfileRequest, RankedProfileResponse, RankedQueue, RematchMatchRequest, RematchMatchResponse, SaveMatchRequest, ReturnLobbyMatchRequest, ReturnTournamentMatchRequest, RestoreMatchSaveRequest, RestoreMatchSaveResponse, ServerMessage, AiStatusPayload, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SetAiPausedRequest, SharedMatchHistoryReplayResponse, SimulatorAdminStatusResponse, SimulatorAvailabilityResponse, SpectateLobbyRequest, SpectateMatchRequest, StartLobbyLimitedMatchRequest, StartLobbyRequest, StartTournamentEventRequest, SubmitLobbyLimitedDeckRequest, SubmitMatchDeckRequest, SubmitMatchDeckResponse, SubmitTournamentDeckRequest, TournamentEventCommandRequest, TournamentRoomAccessResponse, TournamentRoomChatRequest, TournamentRoomChatResponse, TournamentRoomListResponse, TournamentRoomResponse, TournamentRoomServerMessage, TournamentRoomSyncRequest, UndoMatchRequest, UndoMatchResponse, UndoRespondMatchRequest, UpdateLobbyAiPlayerRequest, UpdateLobbyPlayerRequest, UpdateLobbySettingsRequest, UpdateTournamentRoomPlayerRequest, UpdateTournamentRoomSettingsRequest, WelcomePayload } from './generated/index.js';
 import type { SchemaValidator } from './validators/validator.js';
 /**
  * Exact schema-to-type map generated from Rust public wire contracts.
@@ -9,6 +9,9 @@ import type { SchemaValidator } from './validators/validator.js';
  * @see https://simulator-sdk.my-swu.com/guide/versioning
  */
 export interface SchemaTypeMap {
+    'admin-match-list-response': AdminMatchListResponse;
+    'admin-match-debug-bundle': AdminMatchDebugBundle;
+    'admin-match-replay-response': AdminMatchReplayResponse;
     'simulator-report-list-response': SimulatorReportListResponse;
     'simulator-report-response': SimulatorReportResponse;
     'close-tournament-room-request': CloseTournamentRoomRequest;
@@ -69,8 +72,15 @@ export interface SchemaTypeMap {
     'match-history-list-response': MatchHistoryListResponse;
     'match-history-replay-request': MatchHistoryReplayRequest;
     'match-history-replay-response': MatchHistoryReplayResponse;
+    'create-match-history-replay-share-request': CreateMatchHistoryReplayShareRequest;
+    'create-match-history-replay-share-response': CreateMatchHistoryReplayShareResponse;
+    'shared-match-history-replay-response': SharedMatchHistoryReplayResponse;
     'match-history-restore-request': MatchHistoryRestoreRequest;
     'restore-history-response': RestoreHistoryResponse;
+    'match-recovery-request': MatchRecoveryRequest;
+    'match-recovery-response': MatchRecoveryResponse;
+    'match-access-recovery-request': MatchAccessRecoveryRequest;
+    'match-access-recovery-response': MatchAccessRecoveryResponse;
     'match-save-payload': MatchSavePayload;
     'save-match-request': SaveMatchRequest;
     'match-spectator-access-response': MatchSpectatorAccessResponse;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@my-swu/simulator-client",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Typed TypeScript client for the swu-simulator HTTP and WebSocket engine.",
   "keywords": [
     "swu",

package/schema/add-lobby-ai-player-request.schema.json

@@ -3,6 +3,13 @@
   "title": "AddLobbyAiPlayerRequest",
   "type": "object",
   "properties": {
+    "accountToken": {
+      "description": "Signed app account proof required to create a server-controlled AI.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
     "deck": {
       "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/DeckInput"
     },

package/schema/admin-match-debug-bundle.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AdminMatchDebugBundle",
+  "description": "Complete durable diagnostics for one match, excluding restore credentials.",
+  "type": "object",
+  "properties": {
+    "exportVersion": {
+      "type": "integer",
+      "format": "uint8",
+      "maximum": 255,
+      "minimum": 0
+    },
+    "exportedAtMs": {
+      "type": "integer",
+      "format": "uint64",
+      "minimum": 0
+    },
+    "game": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AdminMatchSummary"
+    },
+    "replay": {
+      "anyOf": [
+        {
+          "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchHistoryReplayArchive"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "reports": {
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/SimulatorReportResponse"
+      }
+    },
+    "save": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchSavePayload"
+    }
+  },
+  "required": [
+    "exportVersion",
+    "exportedAtMs",
+    "game",
+    "save",
+    "reports"
+  ]
+}

package/schema/admin-match-list-response.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AdminMatchListResponse",
+  "description": "Cursor-paginated durable match list for simulator administrators.",
+  "type": "object",
+  "properties": {
+    "games": {
+      "type": "array",
+      "items": {
+        "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/AdminMatchSummary"
+      }
+    },
+    "nextCursor": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "games"
+  ]
+}

package/schema/admin-match-replay-response.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AdminMatchReplayResponse",
+  "description": "Completed replay archive returned to an authenticated simulator administrator.",
+  "type": "object",
+  "properties": {
+    "archive": {
+      "$ref": "https://simulator-sdk.my-swu.com/schema/common.json#/$defs/MatchHistoryReplayArchive"
+    }
+  },
+  "required": [
+    "archive"
+  ]
+}