@my-swu/simulator-client 0.1.2 → 0.1.4

package/dist/match-session/controller.js

@@ -2,6 +2,7 @@ import { MatchConnection } from '../connection.js';
 import { TypedEmitter } from '../internal/emitter.js';
 import { formatErrorMessages } from '../internal/errors.js';
 import { DEFAULT_ERROR_HISTORY_LIMIT, DEFAULT_MATCH_HISTORY_LIMIT } from '../internal/limits.js';
+import { upsertMatchHistoryEntry } from '../internal/match-history.js';
 import { nonNegativeNumber, normalizeReconnectBackoff, reconnectDelayMs, } from '../internal/reconnect-backoff.js';
 import { createMatchSessionHeartbeat } from './heartbeat.js';
 import { hasAccessSnapshot, matchReferenceFrom } from './access.js';
@@ -91,6 +92,9 @@ export class MatchSessionController {
     get reconnectState() {
         return this.#reconnectState;
     }
+    get snapshotRevision() {
+        return this.#connection?.snapshotRevision ?? 0;
+    }
     get snapshot() {
         return this.#snapshot;
     }
@@ -207,6 +211,21 @@ export class MatchSessionController {
     reconnect(options = {}) {
         return this.connect(undefined, options);
     }
+    recoverNow() {
+        if (this.#manualClose || !this.#autoReconnect.enabled || this.#access == null) {
+            return;
+        }
+        this.#reconnectGeneration += 1;
+        if (this.#reconnectTimer != null) {
+            clearTimeout(this.#reconnectTimer);
+            this.#reconnectTimer = undefined;
+        }
+        // Detach before close so this intentional foreground replacement cannot
+        // schedule a duplicate close-driven retry.
+        this.#closeActiveConnection();
+        this.#setConnectionState('closed');
+        void this.#runAutoReconnectAttempt(1, this.#reconnectGeneration);
+    }
     ready() {
         this.#activeConnection().ready();
     }
@@ -333,8 +352,7 @@ export class MatchSessionController {
         this.#emitChange();
     }
     #recordHistoryEntry(entry) {
-        const withoutDuplicate = this.#history.filter(existing => existing.id !== entry.id);
-        this.#history = [...withoutDuplicate, entry].slice(-DEFAULT_MATCH_HISTORY_LIMIT);
+        this.#history = upsertMatchHistoryEntry(this.#history, entry);
         this.#emitter.emit('historyEntry', entry);
         this.#emitChange();
     }
@@ -368,15 +386,18 @@ export class MatchSessionController {
     }
     #scheduleAutoReconnect(attempt, generation) {
         if (attempt > this.#autoReconnect.maxRetries) {
+            const error = {
+                code: 'sdk_session_error',
+                message: 'automatic reconnect exhausted',
+            };
             this.#setReconnectState({
-                phase: 'exhausted',
+                phase: 'terminal',
                 attempts: this.#autoReconnect.maxRetries,
                 maxAttempts: this.#autoReconnect.maxRetries,
+                cause: 'retriesExhausted',
+                error,
             });
-            this.#recordError({
-                code: 'sdk_session_error',
-                message: 'automatic reconnect exhausted',
-            });
+            this.#recordError(error);
             return;
         }
         const delayMs = reconnectDelayMs(this.#autoReconnect, attempt);
@@ -418,17 +439,23 @@ export class MatchSessionController {
             if (generation !== this.#reconnectGeneration || this.#manualClose) {
                 return;
             }
-            if (attempt >= this.#autoReconnect.maxRetries) {
-                this.#recordError(errorPayloadFromUnknown(error));
-                this.#recordError({
-                    code: 'sdk_session_error',
-                    message: 'automatic reconnect exhausted',
-                });
+            const payload = errorPayloadFromUnknown(error);
+            const cause = terminalCauseForError(payload);
+            if (cause != null || attempt >= this.#autoReconnect.maxRetries) {
+                const terminalError = cause == null
+                    ? {
+                        code: 'sdk_session_error',
+                        message: 'automatic reconnect exhausted',
+                    }
+                    : payload;
                 this.#setReconnectState({
-                    phase: 'exhausted',
+                    phase: 'terminal',
                     attempts: attempt,
                     maxAttempts: this.#autoReconnect.maxRetries,
+                    cause: cause ?? 'retriesExhausted',
+                    error: terminalError,
                 });
+                this.#recordError(terminalError);
                 this.#setConnectionState('closed');
                 return;
             }
@@ -556,9 +583,24 @@ function sameReconnectState(left, right) {
             return right.phase === 'connecting'
                 && left.attempt === right.attempt
                 && left.maxAttempts === right.maxAttempts;
-        case 'exhausted':
-            return right.phase === 'exhausted'
+        case 'terminal':
+            return right.phase === 'terminal'
                 && left.attempts === right.attempts
-                && left.maxAttempts === right.maxAttempts;
+                && left.maxAttempts === right.maxAttempts
+                && left.cause === right.cause
+                && left.error.code === right.error.code
+                && left.error.message === right.error.message;
+    }
+}
+/** Maps definitive server rejections to terminal causes without parsing text. */
+function terminalCauseForError(error) {
+    switch (error.code) {
+        case 'match_not_found':
+            return 'matchNotFound';
+        case 'invalid_seat_token':
+        case 'invalid_spectator_token':
+            return 'invalidCredentials';
+        default:
+            return undefined;
     }
 }

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

@@ -159,6 +159,14 @@ export interface MatchSessionMethods {
      * @see https://simulator-sdk.my-swu.com/guide/reconnect
      */
     reconnect(options?: MatchSessionConnectOptions): Promise<MatchSession>;
+    /**
+     * Immediately starts session-owned automatic recovery using stored access.
+     *
+     * This is intended for foreground restoration: it preserves automatic
+     * backoff after a failed dial instead of turning recovery into a one-shot
+     * manual reconnect.
+     */
+    recoverNow(): void;
     /**
      * Sends one ready message for the current seat.
      *

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

@@ -132,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, MatchSessionHeartbeatOptions, MatchSessionHeartbeatPolicy, 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.
  *
@@ -45,6 +45,8 @@ export interface MatchSession extends MatchSessionMethods {
     readonly matchId: string | undefined;
     /** Automatic reconnect progress after an abnormal socket close. */
     readonly reconnectState: MatchSessionReconnectState;
+    /** Monotonic revision of the latest authoritative match snapshot. */
+    readonly snapshotRevision: number;
     /** Latest authoritative private snapshot for this seat. */
     readonly snapshot: GameState | undefined;
     /** Seat controlled by this session when known. */

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, MatchSessionHeartbeatOptions, MatchSessionHeartbeatPolicy, 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.2",
+  "version": "0.1.4",
   "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"
+  ]
+}