@my-swu/simulator-client 0.1.2 → 0.1.4

package/dist/generated/types/admin-match-debug-bundle.d.ts

@@ -0,0 +1 @@
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AdminMatchDebugBundle, AdminMatchSummary, AiDifficulty, AiOpponentConfig, AiTrilogyFormatMode, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, FormatSetupInput, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, HistorySection, HistoryStatus, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryDeckSummary, MatchHistoryPlayerSummary, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSavePayload, MatchSaveSeat, MatchSeriesView, MatchStatus, MctsConfigOverride, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SimulatorReportResponse, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitCopiedCardEntry, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/admin-match-debug-bundle.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/admin-match-list-response.d.ts

@@ -0,0 +1 @@
+export type { AdminMatchListResponse, AdminMatchSummary, HistorySection, HistoryStatus, MatchFormat, MatchHistoryDeckSummary, MatchHistoryPlayerSummary, Seat, } from './common.js';

package/dist/generated/types/admin-match-list-response.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/admin-match-replay-response.d.ts

@@ -0,0 +1 @@
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AdminMatchReplayResponse, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/admin-match-replay-response.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/common.d.ts

@@ -224,6 +224,10 @@ export interface ActiveEffectView {
     targets: EffectTargetView[];
 }
 export interface AddLobbyAiPlayerRequest {
+    /**
+     * Signed app account proof required to create a server-controlled AI.
+     */
+    accountToken?: (string | null);
     deck: DeckInput;
     deckId?: (string | null);
     deckSource?: (string | null);
@@ -233,6 +237,47 @@ export interface AddLobbyAiPlayerRequest {
     playerToken: string;
     trilogyFormatMode: AiTrilogyFormatMode;
 }
+/**
+ * Complete durable diagnostics for one match, excluding restore credentials.
+ */
+export interface AdminMatchDebugBundle {
+    exportVersion: number;
+    exportedAtMs: number;
+    game: AdminMatchSummary;
+    replay?: (MatchHistoryReplayArchive | null);
+    reports: SimulatorReportResponse[];
+    save: MatchSavePayload;
+}
+/**
+ * Cursor-paginated durable match list for simulator administrators.
+ */
+export interface AdminMatchListResponse {
+    games: AdminMatchSummary[];
+    nextCursor?: (string | null);
+}
+/**
+ * Completed replay archive returned to an authenticated simulator administrator.
+ */
+export interface AdminMatchReplayResponse {
+    archive: MatchHistoryReplayArchive;
+}
+/**
+ * Compact durable match data safe for an administrator list view.
+ */
+export interface AdminMatchSummary {
+    completedAtMs?: (number | null);
+    createdAtMs: number;
+    format: MatchFormat;
+    historyId: string;
+    players: MatchHistoryPlayerSummary[];
+    replayAvailable: boolean;
+    result?: unknown;
+    section: HistorySection;
+    series: unknown;
+    sourceMatchId: string;
+    status: HistoryStatus;
+    updatedAtMs: number;
+}
 /**
  * Public difficulty presets. Internal tuning (iteration counts, time
  * budgets) lives in `crate::r#match::registry::ai_factory` so it can be
@@ -543,7 +588,7 @@ export interface CreateLimitedEventRequest {
     /**
      * Optional deterministic seed for generated boosters and draft leaders.
      */
-    seed?: (number | null);
+    seed?: (string | null);
     /**
      * Set code used for booster generation.
      */
@@ -571,16 +616,32 @@ export interface CreateLobbyRequest {
     /**
      * Optional deterministic seed reused for limited duel matches.
      */
-    matchSeed?: (number | null);
+    matchSeed?: (string | null);
     /**
      * Optional deterministic seed for limited pack/leader generation.
      */
-    packSeed?: (number | null);
+    packSeed?: (string | null);
     /**
      * Whether the lobby should appear in public browsing surfaces.
      */
     visibility: LobbyVisibility;
 }
+/**
+ * Participant-authorized request to create one permanent replay-share link.
+ */
+export interface CreateMatchHistoryReplayShareRequest {
+    identities: HistoryIdentityInput[];
+    /**
+     * Whether this capability may retrieve post-match private-zone views.
+     */
+    includeHiddenInformation: boolean;
+}
+/**
+ * Opaque capability returned after a participant creates a replay share.
+ */
+export interface CreateMatchHistoryReplayShareResponse {
+    shareToken: string;
+}
 export interface CreateMatchRequest {
     /**
      * Explicit AI-driven seats. In a two-player match use seat Two; Twin
@@ -645,7 +706,7 @@ export interface CreateMatchRequest {
     /**
      * Optional deterministic match seed.
      */
-    seed?: (number | null);
+    seed?: (string | null);
 }
 /**
  * Request to create a simulator-owned ranked meta window.
@@ -679,11 +740,11 @@ export interface CreateTournamentRoomRequest {
     /**
      * Optional deterministic seed reused for every duel table match.
      */
-    matchSeed?: (number | null);
+    matchSeed?: (string | null);
     /**
      * Optional deterministic seed for limited pack/leader generation.
      */
-    packSeed?: (number | null);
+    packSeed?: (string | null);
     /**
      * Enables the per-pick countdown with auto-pick on timeout (draft only).
      */
@@ -2053,15 +2114,18 @@ export type HistoryRestoreEligibility = ({
 /**
  * Why one history row cannot currently create a fresh live match.
  */
-export type HistoryRestoreUnavailableReason = ("completedSeries" | "unsupportedSection" | "learnScenario" | "invalidAiTopology" | "incompatibleSaveVersion" | "invalidSave" | "policyRefreshPending");
+export type HistoryRestoreUnavailableReason = ("completedSeries" | "abandoned" | "unsupportedSection" | "learnScenario" | "invalidAiTopology" | "incompatibleSaveVersion" | "invalidSave" | "policyRefreshPending");
 /**
  * Simulator setup section that owns a match-history entry.
  */
 export type HistorySection = ("solo" | "multiplayer");
 /**
  * Durable history entry status.
+ *
+ * Lives here rather than the `server-protocol`-gated history module because
+ * `MatchRuntimeRecord` embeds it in every build, including wasm and bench.
  */
-export type HistoryStatus = ("saved" | "result");
+export type HistoryStatus = ("saved" | "result" | "abandoned");
 /**
  * Why this seat is choosing the player who begins with initiative.
  */
@@ -2430,7 +2494,7 @@ export interface LimitedEventPreflightResponse {
     /**
      * Deterministic seed used by successful creation after this check.
      */
-    seed: number;
+    seed: string;
 }
 /**
  * Response body for limited event fetches and commands.
@@ -2920,12 +2984,12 @@ export interface LobbySnapshot {
     /**
      * Fixed match seed when configured.
      */
-    matchSeed?: (number | null);
+    matchSeed?: (string | null);
     matchmaking?: (LobbyMatchmakingView | null);
     /**
      * Fixed limited pack/leader seed when configured.
      */
-    packSeed?: (number | null);
+    packSeed?: (string | null);
     players: LobbyPlayerView[];
     requiredPlayerCount: number;
     spectators?: LobbySpectatorView[];
@@ -2986,12 +3050,34 @@ export interface MaintenanceStatus {
      */
     updatedAtMs?: (number | null);
 }
+/**
+ * Ownership proof used to recover current access for one live Solo-versus-AI
+ * match when browser-stored seat credentials are stale.
+ */
+export interface MatchAccessRecoveryRequest {
+    identities: HistoryIdentityInput[];
+}
+/**
+ * Result of recovering current private access for a live Solo-versus-AI match.
+ *
+ * `Unavailable` deliberately combines unknown, unauthorized, inactive, and
+ * ineligible matches so this endpoint cannot be used to probe match state.
+ */
+export type MatchAccessRecoveryResponse = ({
+    /**
+     * Current private host capability for the existing live runtime.
+     */
+    access: MatchAccessResponse;
+    kind: "recovered";
+} | {
+    kind: "unavailable";
+});
 export interface MatchAccessResponse {
     matchId: string;
     /**
      * Resolved seed for a private solo-vs-AI match. Never projected in live state.
      */
-    replaySeed?: number;
+    replaySeed?: string;
     seat: Seat;
     seatToken: string;
     snapshot: GameState;
@@ -3108,7 +3194,7 @@ export interface MatchHistoryEntry {
     restoreEligibility: HistoryRestoreEligibility;
     result?: unknown;
     section: HistorySection;
-    seed: number;
+    seed: string;
     series: unknown;
     sourceMatchId: string;
     status: HistoryStatus;
@@ -3230,6 +3316,37 @@ export type MatchPhase = ("lobby" | "setup" | "action" | "regroup" | "completed"
  * read them in their own language.
  */
 export type MatchQuickPhrase = ("greetings" | "goodLuck" | "wellPlayed" | "thinking" | "oops" | "goodGame");
+/**
+ * Request to restore an unfinished Solo-versus-AI match whose original live
+ * runtime is no longer available.
+ */
+export interface MatchRecoveryRequest {
+    identities: HistoryIdentityInput[];
+    /**
+     * Stable browser-generated id that makes recovery retries idempotent.
+     */
+    restoreRequestId: string;
+    section: HistorySection;
+    /**
+     * Id of the original runtime, never a public history id.
+     */
+    sourceMatchId: string;
+}
+/**
+ * Result of looking up a lost-runtime recovery source.
+ *
+ * `Unavailable` intentionally combines unknown, unauthorized, live, and
+ * ineligible sources so callers cannot probe match lifecycle metadata.
+ */
+export type MatchRecoveryResponse = ({
+    /**
+     * Fresh host capability for the restored runtime.
+     */
+    access: MatchAccessResponse;
+    kind: "restored";
+} | {
+    kind: "unavailable";
+});
 export interface MatchResult {
     reason: MatchEndReason;
     winner?: (Seat | null);
@@ -3509,6 +3626,11 @@ export interface PendingAbilityAttackChoiceView {
      * Structural purpose of choosing an attacker through this specialized prompt.
      */
     purpose?: (TargetGroupPurpose | null);
+    /**
+     * Publicly revealed cards which caused this instructed attack. Omitted
+     * for ordinary attacks and intentionally projected only to chooser.
+     */
+    revealedCardIds?: number[];
     sourceCardId: number;
 }
 export interface PendingAbilityCardChoiceView {
@@ -4471,6 +4593,12 @@ export interface SharedCounterState {
     available: boolean;
     controller?: (Seat | null);
 }
+/**
+ * Replay archive resolved from an opaque, publicly usable share capability.
+ */
+export interface SharedMatchHistoryReplayResponse {
+    archive: MatchHistoryReplayArchive;
+}
 /**
  * Admin status payload combining drain mode and live counters.
  */
@@ -4942,11 +5070,11 @@ export interface TournamentRoomSnapshot {
     /**
      * Fixed duel match seed when configured.
      */
-    matchSeed?: (number | null);
+    matchSeed?: (string | null);
     /**
      * Fixed limited pack/leader seed when configured.
      */
-    packSeed?: (number | null);
+    packSeed?: (string | null);
     players: TournamentRoomPlayerView[];
     requiredPlayerCount: number;
     roomId: string;

package/dist/generated/types/create-match-history-replay-share-request.d.ts

@@ -0,0 +1 @@
+export type { CreateMatchHistoryReplayShareRequest, HistoryIdentityInput, } from './common.js';

package/dist/generated/types/create-match-history-replay-share-request.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/create-match-history-replay-share-response.d.ts

@@ -0,0 +1 @@
+export type { CreateMatchHistoryReplayShareResponse, } from './common.js';

package/dist/generated/types/create-match-history-replay-share-response.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/inactive-match-recovery-request.d.ts

@@ -0,0 +1 @@
+export type { HistoryIdentityInput, HistorySection, InactiveMatchRecoveryRequest, } from './common.js';

package/dist/generated/types/inactive-match-recovery-request.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/inactive-match-recovery-response.d.ts

@@ -0,0 +1 @@
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InactiveMatchRecoveryResponse, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchAccessResponse, MatchEndReason, MatchFormat, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TwinSunsCounter, TwinSunsCountersView, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/inactive-match-recovery-response.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/match-access-recovery-request.d.ts

@@ -0,0 +1 @@
+export type { HistoryIdentityInput, MatchAccessRecoveryRequest, } from './common.js';

package/dist/generated/types/match-access-recovery-request.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/match-access-recovery-response.d.ts

@@ -0,0 +1 @@
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchAccessRecoveryResponse, MatchAccessResponse, MatchEndReason, MatchFormat, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TwinSunsCounter, TwinSunsCountersView, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/match-access-recovery-response.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/match-recovery-request.d.ts

@@ -0,0 +1 @@
+export type { HistoryIdentityInput, HistorySection, MatchRecoveryRequest, } from './common.js';

package/dist/generated/types/match-recovery-request.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/match-recovery-response.d.ts

@@ -0,0 +1 @@
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchAccessResponse, MatchEndReason, MatchFormat, MatchPhase, MatchRecoveryResponse, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TwinSunsCounter, TwinSunsCountersView, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/match-recovery-response.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/types/shared-match-history-replay-response.d.ts

@@ -0,0 +1 @@
+export type { AbilityTarget, AbilityWindow, ActionAbilitySource, ActionAbilityView, ActiveEffectDescriptionView, ActiveEffectView, AttachmentMode, AttackChoiceView, AttackTarget, AvailableAttackView, CaptureOptionsView, CaptureSelection, CapturedUnitView, CardArena, CardChoiceResourcePaymentOptionView, CardDrawSource, CardInstanceView, ConstructedFormat, CurrentAttackStateView, CurrentAttackView, DeckInput, DeckPlacement, DeckRegistrationView, DelayedEffectDescriptionView, DelayedEffectOrderChoiceView, DelayedEffectOrderOptionView, DelayedEffectTimingView, DelayedEffectView, DistributionAssignment, DistributionDamageKindView, DistributionItemView, DistributionTargetView, DistributionTokenKindView, DynamicPowerLimit, EffectCardScopeView, EffectDurationView, EffectResolutionDraftStepView, EffectResolutionDraftView, EffectRestrictionView, EffectSequenceOrder, EffectSequenceView, EffectSourceView, EffectTargetView, ExploitOptionsView, FormatSeatView, GameEvent, GameState, GameTimerActiveClockView, GameTimerReserveView, GameTimerStateView, HiddenCardChoiceMode, HiddenZoneKind, InitiativeChoiceReason, InitiativeState, InstructedAttackView, LeaderActionView, LeaderDeployActionView, LeaderDeployCostView, LeaderDeployMode, LeaderDeployThresholdBonus, LeaderStateView, LimitedEventView, LimitedSideboardPoolView, MatchEndReason, MatchFormat, MatchHistoryReplayArchive, MatchPhase, MatchResult, MatchSeriesView, MatchStatus, ModeChoiceView, NamedCardEffectDescriptionView, NullableDistributionTokenKindView, NullableSeatView, PendingAbilityAspectChoiceView, PendingAbilityAttackChoiceView, PendingAbilityCardChoiceView, PendingAbilityFamily, PendingAbilityModeChoiceInputKind, PendingAbilityModeChoiceView, PendingAbilityNameChoiceView, PendingAbilityOrderAbilityView, PendingAbilityOrderChoiceView, PendingAbilityOrderGroupView, PendingAbilityView, PendingChoiceView, PendingDistributionView, PendingUndoRequest, PlayActionView, PlayCardSourceView, PlayCardZone, PlayerTargetPattern, PresenceFilter, PromptProvenanceView, PromptState, RejectedPlayView, RelationFilter, ResourceCardView, ResourcePaymentOptionView, Seat, SeatDirection, SeatOfferIntent, SeatState, SelectionScope, SeriesEndReason, SeriesGameRecord, SeriesResultView, SharedCounterState, SharedMatchHistoryReplayResponse, SmuggleActionView, SmuggleKind, TargetGroupPurpose, TargetSelectionGroup, TargetSelectionPlanView, TriggerWindowView, TurnPassSource, TwinSunsCounter, TwinSunsCountersView, UndoCancelReason, UndoRequestReason, UniquenessFilter, UnitAbilitySuppressionView, UnitDefeatCause, UnitExtremum, UnitFilter, UnitStateView, UpgradeStateView, } from './common.js';

package/dist/generated/types/shared-match-history-replay-response.js

@@ -0,0 +1,2 @@
+/* eslint-disable */
+export {};

package/dist/generated/version.d.ts

@@ -13,4 +13,4 @@
  *
  * @see https://simulator-sdk.my-swu.com/guide/versioning
  */
-export declare const schemaVersion: "ab26122fba623256a421399b458338eb67af059d2240ba7b1594c6116d6fc030";
+export declare const schemaVersion: "e4a6c8c3043fdb5779d215ad8f673458da5a45bd6d196f0dbd5cc721aa189045";

package/dist/generated/version.js

@@ -13,4 +13,4 @@
  *
  * @see https://simulator-sdk.my-swu.com/guide/versioning
  */
-export const schemaVersion = "ab26122fba623256a421399b458338eb67af059d2240ba7b1594c6116d6fc030";
+export const schemaVersion = "e4a6c8c3043fdb5779d215ad8f673458da5a45bd6d196f0dbd5cc721aa189045";

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export type { CloseTournamentRoomRequest, CreateTournamentRoomRequest, CreateTou
 export { canDeployAnyLeader, flattenTargetGroups, getDeployableLeaderIndices, getLeaderDeployCommands, isSingleTargetPlan, leaderDeployCommand, targetGroupsOf, } from './actionable.js';
 export type { TargetingActionView } from './actionable.js';
 export type { SimulatorClient, SimulatorClientOptions } from './client.js';
-export type { AbandonMatchRequest, AbandonMatchResponse, ApiErrorResponse, AiStatusPayload, CardsResponse, CardCatalogRefreshResponse, ClientMessage, CreateLimitedEventRequest, CreateMetaWindowRequest, CreateMatchRequest, ErrorPayload, FormatEventResponse, FormatEventRequest, GameCommand, GameEvent, GameState, GetMatchResponse, HealthResponse, JoinLimitedEventRequest, JoinMatchRequest, LeaveMatchRequest, LeaveMatchResponse, LimitedEventAccessResponse, LimitedEventCommandRequest, LimitedEventPreflightResponse, LimitedEventResponse, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessResponse, MatchChatLookupResponse, MatchConnectionRole, MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, RestoreHistoryResponse, MatchSavePayload, MatchSpectatorAccessResponse, MetaWindow, MetaWindowsResponse, ResolveCardIdsRequest, ResolveCardIdsResponse, RankedAdminStatus, RankedLeaderboardEntry, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedMatchmakingView, RankedProfileRequest, RankedProfileResponse, RankedQueue, RematchMatchRequest, RematchMatchResponse, RestoreMatchSaveRequest, RestoreMatchSaveResponse, SaveMatchRequest, ServerMessage, SetAiPausedRequest, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SimulatorAdminStatusResponse, SimulatorAvailabilityResponse, SpectateMatchRequest, SubmitMatchDeckRequest, SubmitMatchDeckResponse, UndoMatchRequest, UndoMatchResponse, UndoRespondMatchRequest, WelcomePayload, } from './generated/index.js';
+export type { AbandonMatchRequest, AbandonMatchResponse, ApiErrorResponse, AiStatusPayload, CardsResponse, CardCatalogRefreshResponse, ClientMessage, CreateLimitedEventRequest, CreateMetaWindowRequest, CreateMatchRequest, ErrorPayload, FormatEventResponse, FormatEventRequest, GameCommand, GameEvent, GameState, GetMatchResponse, HealthResponse, JoinLimitedEventRequest, JoinMatchRequest, LeaveMatchRequest, LeaveMatchResponse, LimitedEventAccessResponse, LimitedEventCommandRequest, LimitedEventPreflightResponse, LimitedEventResponse, ListActiveAiMatchesRequest, ListActiveAiMatchesResponse, MatchAccessResponse, MatchChatLookupResponse, MatchConnectionRole, MatchHistoryDeckStatsRequest, MatchHistoryDeckStatsResponse, MatchHistoryListRequest, MatchHistoryListResponse, MatchHistoryReplayRequest, MatchHistoryReplayResponse, MatchHistoryRestoreRequest, MatchRecoveryRequest, MatchRecoveryResponse, RestoreHistoryResponse, MatchSavePayload, MatchSpectatorAccessResponse, MetaWindow, MetaWindowsResponse, ResolveCardIdsRequest, ResolveCardIdsResponse, RankedAdminStatus, RankedLeaderboardEntry, RankedLeaderboardQuery, RankedLeaderboardResponse, RankedMatchmakingView, RankedProfileRequest, RankedProfileResponse, RankedQueue, RematchMatchRequest, RematchMatchResponse, RestoreMatchSaveRequest, RestoreMatchSaveResponse, SaveMatchRequest, ServerMessage, SetAiPausedRequest, SetRankedAdmissionRequest, SetSimulatorMaintenanceRequest, SimulatorAdminStatusResponse, SimulatorAvailabilityResponse, SpectateMatchRequest, SubmitMatchDeckRequest, SubmitMatchDeckResponse, UndoMatchRequest, UndoMatchResponse, UndoRespondMatchRequest, WelcomePayload, } from './generated/index.js';
 export type { UndoCancelReason } from './generated/types/game-event.js';
 export type { LimitedSideboardPoolView } from './generated/types/game-state.js';
 export type { HistoryIdentityInput, HistorySection, HistoryStatus, } from './generated/types/match-history-list-request.js';
@@ -27,11 +27,11 @@ export type { CardInteractionCue, CardInteractionCueKind, CardInteractionCueStat
 export type { CardIdResolution, CardMetadata, CardReferenceInput, CardReferenceType, DeckInput, DeckJson, DeckJsonCard, } from './resources/card-types.js';
 export type { CardsResource } from './resources/card-resource.js';
 export type { LimitedEventAccess, LimitedEventAccessInput, LimitedEventCommand, LimitedEventPreflight, LimitedEventReference, LimitedEventSnapshot, LimitedEventsResource, } from './resources/limited-events.js';
-export type { MatchHistoryResource, MatchHistoryReplayInput, MatchHistoryRestoreInput, } from './resources/match-history.js';
+export type { MatchHistoryResource, MatchRecoveryInput, MatchHistoryReplayInput, MatchHistoryRestoreInput, } from './resources/match-history.js';
 export type { MatchAccess, MatchAccessInput, MatchConnectionAccessInput, MatchReference, MatchSpectatorAccess, MatchSpectatorAccessInput, MatchesResource, } from './resources/matches.js';
 export type { SessionResource } from './resources/session.js';
 export type { SystemResource } from './resources/system.js';
-export type { MatchSeat, MatchSession, MatchSessionAccess, MatchSessionAutoReconnectOptions, MatchSessionAutoReconnectPolicy, MatchSessionConnectOptions, MatchSessionEvents, MatchSessionHeartbeatOptions, MatchSessionHeartbeatPolicy, MatchSessionOptions, MatchSessionReconnectState, MatchSessionSnapshotPredicate, MatchSessionState, MatchSessionWaitOptions, } from './match-session.js';
+export type { MatchSeat, MatchSession, MatchSessionAccess, MatchSessionAutoReconnectOptions, MatchSessionAutoReconnectPolicy, MatchSessionConnectOptions, MatchSessionEvents, MatchSessionHeartbeatOptions, MatchSessionHeartbeatPolicy, MatchSessionOptions, MatchSessionReconnectState, MatchSessionTerminalCause, MatchSessionSnapshotPredicate, MatchSessionState, MatchSessionWaitOptions, } from './match-session.js';
 export type { ConnectionState, PongPayload } from './session.js';
 export { createSchemaValidator, parseSchema } from './validators.js';
 export type { SchemaTypeMap } from './validators.js';

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

@@ -0,0 +1,5 @@
+import type { MatchHistoryFeedEntry } from '../generated/types/server-message.js';
+/**
+ * Replaces a re-delivered entry and retains only recent match history.
+ */
+export declare function upsertMatchHistoryEntry(history: readonly MatchHistoryFeedEntry[], entry: MatchHistoryFeedEntry): MatchHistoryFeedEntry[];

package/dist/internal/match-history.js

@@ -0,0 +1,8 @@
+import { DEFAULT_MATCH_HISTORY_LIMIT } from './limits.js';
+/**
+ * Replaces a re-delivered entry and retains only recent match history.
+ */
+export function upsertMatchHistoryEntry(history, entry) {
+    const withoutDuplicate = history.filter(existing => existing.id !== entry.id);
+    return [...withoutDuplicate, entry].slice(-DEFAULT_MATCH_HISTORY_LIMIT);
+}

package/dist/local/engine.d.ts

@@ -19,6 +19,8 @@ export interface LocalAiTick {
 export interface LocalEngineMatch {
     matchId: string;
     seatToken: string;
+    /** Current private `MatchAccessResponse` JSON for this viewer. */
+    access: () => string;
     /** `ServerMessage[]` handshake for a fresh connection. */
     connect: () => unknown[];
     /** Applies one `ClientMessage` JSON string; returns ordered batches. */

package/dist/local/server/http-router.js

@@ -92,6 +92,16 @@ export function routeHttpRequest(engine, registry, method, path, body, nowMs) {
         if (segments.length === 3 && method === 'GET') {
             return { status: 200, body: JSON.stringify({ snapshot: JSON.parse(match.snapshot()) }) };
         }
+        if (segments[3] === 'access' && method === 'POST') {
+            if (body == null) {
+                return jsonError(400, 'invalidRequest', 'missing access request body');
+            }
+            const request = JSON.parse(body);
+            if (request.seatToken !== match.seatToken) {
+                return jsonError(403, 'invalidSeatToken', 'invalid seat token');
+            }
+            return { status: 200, body: match.access() };
+        }
         if (segments[3] === 'ai' && segments[4] === 'pause' && method === 'POST') {
             if (body == null) {
                 return jsonError(400, 'invalidRequest', 'missing pause request body');

package/dist/local/wasm-engine.d.ts

@@ -45,6 +45,7 @@ interface WasmCreatedLocalMatch {
     accessJson: () => string;
 }
 interface WasmLocalMatch {
+    access: () => string;
     connect: () => string;
     handleMessage: (seatToken: string, messageJson: string, nowMs: number) => string;
     aiHasWork: () => boolean;

package/dist/local/wasm-engine.js

@@ -12,6 +12,7 @@ function wrapMatch(inner) {
     return {
         matchId: inner.matchId(),
         seatToken,
+        access: () => inner.access(),
         connect: () => JSON.parse(inner.connect()),
         handleMessage: (token, messageJson, nowMs) => JSON.parse(inner.handleMessage(token, messageJson, nowMs)),
         aiHasWork: () => inner.aiHasWork(),

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

@@ -37,6 +37,7 @@ export declare class MatchSessionController implements MatchSession {
     get errorMessages(): readonly string[];
     get matchId(): string | undefined;
     get reconnectState(): MatchSessionReconnectState;
+    get snapshotRevision(): number;
     get snapshot(): GameState | undefined;
     get seat(): MatchSeat | undefined;
     get state(): MatchSessionState;
@@ -47,6 +48,7 @@ export declare class MatchSessionController implements MatchSession {
     spectateMatch(match: string | MatchReference, request: SpectateMatchRequest, options?: MatchSessionConnectOptions): Promise<MatchSpectatorAccess>;
     close(): void;
     reconnect(options?: MatchSessionConnectOptions): Promise<MatchSession>;
+    recoverNow(): void;
     ready(): void;
     undo(): void;
     respondUndo(approve: boolean): void;