@series-inc/rundot-syncplay 5.23.0-beta.7

package/dist/local-authority.d.ts

@@ -0,0 +1,160 @@
+import { type CanonicalValue } from './canonical.js';
+export interface DeterministicLocalAuthorityClient {
+    readonly slot: number;
+    readonly connected: boolean;
+    readonly spectator: boolean;
+    readonly inputDelayFrames: number;
+    readonly lastAckFrame: number;
+}
+export interface DeterministicLocalAuthorityState {
+    readonly frame: number;
+    readonly players: number;
+    readonly clients: readonly DeterministicLocalAuthorityClient[];
+    readonly stateBySlot: readonly number[];
+    readonly rejectedMessages: number;
+    readonly rollbackDepths: readonly number[];
+    readonly clockDriftFrames: readonly number[];
+}
+export interface DeterministicLocalAuthorityResult {
+    readonly authorityChecksum: string;
+    readonly clientChecksum: string;
+    readonly authorityProjectionChecksum: string;
+    readonly clientProjectionChecksum: string;
+    readonly convergence: boolean;
+    readonly players: number;
+    readonly frames: number;
+    readonly reconnects: number;
+    readonly lateJoins: number;
+    readonly spectators: number;
+    readonly absentBeforeJoinInputs: number;
+    readonly lateJoinReconstructions: number;
+    readonly spectatorReconstructions: number;
+    readonly rejectedMessages: number;
+    readonly migrationFrame: number;
+    readonly migrationPersistedSections: number;
+    readonly migrationQueueRestored: boolean;
+    readonly migrationCommandTimelineRestored: boolean;
+    readonly slotReservationsRestored: boolean;
+    readonly inputDelayP95: number;
+    readonly rollbackDepthP95: number;
+    readonly clockDriftP95: number;
+    readonly p95FrameCost: number;
+    readonly p99FrameCost: number;
+}
+export interface DeterministicLocalAuthorityRuntimePolicyFixtureResult {
+    readonly checksum: string;
+    readonly restoredChecksum: string;
+    readonly rollbackEquivalent: boolean;
+    readonly nonCommutativeRuntimeChecksum: string;
+    readonly nonCommutativeFullReplayChecksum: string;
+    readonly nonCommutativeAppendOnlyChecksum: string;
+    readonly nonCommutativeLateInputResimulated: boolean;
+    readonly nonCommutativeAppendOnlyDiverged: boolean;
+    readonly nonCommutativeResimulatedFrames: number;
+    readonly lateWithinRollbackWindowAccepted: boolean;
+    readonly expiredLateInputRejected: boolean;
+    readonly strictStaleInputRejected: boolean;
+    readonly structuredInputDataPreserved: boolean;
+    readonly malformedStructuredInputRejected: boolean;
+    readonly structuredInputChecksum: string;
+    readonly authorityValueAfterLateInput: number;
+    readonly clientProjectionValueAfterLateInput: number;
+    readonly rollbackWindowFrames: number;
+}
+export interface DeterministicOfflineToAuthorityUpgradeFixtureResult {
+    readonly checksum: string;
+    readonly players: number;
+    readonly frames: number;
+    readonly offlineFrame: number;
+    readonly authorityFrame: number;
+    readonly offlineChecksum: string;
+    readonly authorityChecksum: string;
+    readonly authorityRestoredChecksum: string;
+    readonly replayChecksum: string;
+    readonly stateMatch: boolean;
+    readonly replayVerified: boolean;
+    readonly restoreVerified: boolean;
+    readonly authorityConvergence: boolean;
+    readonly inputRows: number;
+    readonly snapshotFrame: number;
+}
+export interface DeterministicLocalAuthorityReplayMinimizerFixtureResult {
+    readonly checksum: string;
+    readonly players: number;
+    readonly frames: number;
+    readonly validReplayVerified: boolean;
+    readonly corruptedReplayFailed: boolean;
+    readonly minimizedReplayFailed: boolean;
+    readonly mismatchFrame: number;
+    readonly minimizedMismatchFrame: number;
+    readonly originalReplayBytes: number;
+    readonly minimizedReplayBytes: number;
+    readonly removedInputFrames: number;
+    readonly removedSnapshots: number;
+    readonly removedChecksumFrames: number;
+    readonly debugEvents: number;
+}
+export interface DeterministicLocalAuthorityInputMessage {
+    readonly slot: number;
+    readonly senderSlot?: number;
+    readonly frame: number;
+    readonly value: number;
+    readonly data?: CanonicalValue;
+    readonly delay?: number;
+    readonly inputId?: string;
+}
+export interface DeterministicLocalAuthorityRuntimeSnapshot {
+    readonly state: DeterministicLocalAuthorityState;
+    readonly authorityQueue: readonly {
+        readonly frame: number;
+        readonly messages: readonly AcceptedAuthorityMessage[];
+    }[];
+    readonly deliveryQueue: readonly {
+        readonly frame: number;
+        readonly messages: readonly AcceptedAuthorityMessage[];
+    }[];
+    readonly acceptedMessages: readonly AcceptedAuthorityMessage[];
+    readonly clientStateBySlot: readonly number[];
+    readonly commandChecksum: string;
+    readonly lateJoinSlots: readonly number[];
+    readonly spectatorSlots: readonly number[];
+    readonly acceptedInputIds: readonly string[];
+}
+export interface DeterministicLocalAuthorityRuntime {
+    readonly state: DeterministicLocalAuthorityState;
+    submitInput(message: DeterministicLocalAuthorityInputMessage): boolean;
+    disconnect(slot: number): void;
+    reconnect(slot: number): void;
+    lateJoin(slot: number): void;
+    addSpectator(slot: number): void;
+    step(): void;
+    snapshot(): DeterministicLocalAuthorityRuntimeSnapshot;
+    restore(snapshot: DeterministicLocalAuthorityRuntimeSnapshot): void;
+    checksums(): {
+        readonly authorityChecksum: string;
+        readonly clientChecksum: string;
+        readonly authorityProjectionChecksum: string;
+        readonly clientProjectionChecksum: string;
+        readonly convergence: boolean;
+        readonly commandChecksum: string;
+    };
+}
+export interface DeterministicLocalAuthorityRuntimeOptions {
+    readonly maxFrameLead?: number;
+    readonly rollbackWindowFrames?: number;
+    readonly stateReducer?: (currentValue: number, message: AcceptedAuthorityMessage) => number;
+}
+interface AcceptedAuthorityMessage {
+    readonly slot: number;
+    readonly frame: number;
+    readonly delay: number;
+    readonly deliveryFrame: number;
+    readonly value: number;
+    readonly data?: CanonicalValue;
+}
+export declare function createDeterministicLocalAuthorityRuntime(players: number, options?: DeterministicLocalAuthorityRuntimeOptions): DeterministicLocalAuthorityRuntime;
+export declare function runDeterministicLocalAuthorityFixture(players: number, frames: number, seed: number): DeterministicLocalAuthorityResult;
+export declare function runDeterministicLocalAuthorityRuntimePolicyFixture(): DeterministicLocalAuthorityRuntimePolicyFixtureResult;
+export declare function runDeterministicOfflineToAuthorityUpgradeFixture(players: number, frames: number, seed: number): DeterministicOfflineToAuthorityUpgradeFixtureResult;
+export declare function runDeterministicLocalAuthorityReplayMinimizerFixture(players: number, frames: number, seed: number): DeterministicLocalAuthorityReplayMinimizerFixtureResult;
+export {};