@series-inc/rundot-syncplay 6.0.0-rc.39 → 6.0.0-rc.40

package/MIGRATING-RC39-TO-RC40.md

@@ -0,0 +1,41 @@
+# Character landing repair
+
+Use `behaviorRevision: 3` to recover from prop edge intersections and to walk on tilted dynamic props.
+Revision 1 remains the default.
+Revisions 1 and 2 keep their previous results.
+
+```ts
+const result = stepDeterministicKcc3D(body, input, bounds, {
+  frame,
+  physics: world,
+  behaviorRevision: 3,
+  groundOnStaticBodies: true,
+  standOnDynamicBodies: true,
+});
+```
+
+Revision 3 extends revision 1 movement.
+It recovers the stored capsule before it applies input.
+It adds capsule clearance when it selects dynamic ground.
+Each recovery correction stops before another solid.
+Recovery obeys ignored bodies, collision layers, sensors, and collision filters.
+Ground and recovery filters receive the native contact normal.
+
+Recovery has a limit of four passes.
+It does not guarantee escape from deep containment or a space that is too small.
+It does not add revision 2 support state or portal movement.
+Keep revision 2 for games that use those features.
+
+Revision 3 returns `hasChecksum: true` and `checksumMode: 'required'` when the mode is omitted.
+Use `checksumMode: 'disabled'` to omit the checksum.
+The character module also accepts revision 3 in its movement config.
+Its revision 1 default and revision 2 physics preset remain unchanged.
+
+The new revision changes queries, positions, and checksums.
+Pin the SDK version and controller revision in the game identity.
+All clients and the authoritative server must use the same identity.
+Do not reuse a revision 1 replay as a revision 3 replay.
+
+The release gates use native WASM.
+They cover flat and tilted boxes, cooked voxels, hollow roofs, edge drops, corner drops, walls, ceilings, filters, and checkpoint replay.
+The frozen revision 1 source and result corpus remain unchanged.

package/README.md

@@ -558,6 +558,13 @@ the bits of a finite input. It rejects NaN and infinity.
 This change can produce TypeScript errors in existing games. Update those call
 sites when you upgrade the SDK. Revision 1 helper behavior remains selected by
 default. The revision 1 tests compare complete results with the previous RC.
+
+Set `behaviorRevision: 3` to recover from contact penetration after a landing.
+This revision includes slope clearance for dynamic supports. It keeps the
+revision 1 result shape and uses required checksums by default. Revision 1
+remains the default. Revision 2 keeps its support state and portal movement.
+See [the rc.40 migration notes](MIGRATING-RC39-TO-RC40.md).
+
 New helper behavior requires an explicit revision selection.
 
 ### Shape-preserving body changes

package/core/src/physics/physics-profile-wasm-module.generated.mjs

@@ -23,7 +23,7 @@ export const physicsProfileWasmMetadata = Object.freeze({
   "sourceHash": "809bedd50c7a554eacbded424f8c8779850747183b0d5d29a754ad613b8bf8d0",
   "wasmSha256": "d877cf4ace481e14ea2730b3a839008ecf8326b80784c40a5f447f0294dc2e41",
   "artifact": "profile",
-  "packageVersion": "6.0.0-rc.39",
+  "packageVersion": "6.0.0-rc.40",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/core/src/physics/physics-wasm-module.generated.mjs

@@ -23,7 +23,7 @@ export const physicsWasmMetadata = Object.freeze({
   "sourceHash": "dffa6d2a7e3e96815bc8e6708fd1a1544833aefc7d96d36291406a94177cc591",
   "wasmSha256": "aaa6b82830fbc7613e5b8110b3e09ab5b3a2b9339a544a935f88aa20b02125aa",
   "artifact": "production",
-  "packageVersion": "6.0.0-rc.39",
+  "packageVersion": "6.0.0-rc.40",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/core/src/physics2d/physics2d-wasm-module.generated.mjs

@@ -50,7 +50,7 @@ export const physics2dWasmMetadata = Object.freeze({
   "sourceHash": "faa090a03a6fddaf79c704fb1d76f810955ff35597449c8cec9541a75905a37e",
   "wasmSha256": "49cb90541deed40f5fff1015bb578e13ec9a793d51931c1227e3e5a11bbfa3f7",
   "artifact": "production",
-  "packageVersion": "6.0.0-rc.39",
+  "packageVersion": "6.0.0-rc.40",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/dist/authority-room.d.ts

@@ -1,5 +1,6 @@
 import { type KinetixRuntimeIdentity } from '@series-inc/rundot-syncplay/core/runtime';
-import { type ConfirmedInputFrame, type EncodedInput } from './input-authority.js';
+import { type ConfirmedInputFrame, type EncodedInput, type AuthoritySlotPolicy, type InputSubmissionResult } from './input-authority.js';
+export type { AuthoritySlotPolicy };
 import type { SyncplayMatchLog } from './match-log.js';
 import { type SyncplaySecretAuthoritySnapshot } from './secret-authority.js';
 import type { SyncplaySecretAuthorityCrypto } from './secret-crypto.js';
@@ -87,6 +88,9 @@ export interface DeterministicAuthorityRoomConfig {
      * `historyRetentionTicks` — a match longer than that loses tick 0 and stops
      * being log-verifiable (matchLog() returns undefined; fail loud, never lie).
      */
+    readonly raidMode?: boolean;
+    readonly requiredCapabilities?: readonly string[];
+    readonly authorityEpoch?: number;
     readonly preserveFullHistory?: boolean;
     /**
      * Catch-up telemetry (M8): fired whenever the room serves a player state
@@ -116,6 +120,8 @@ export interface DeterministicAuthorityRoomConfig {
     readonly reconfigurePolicy?: 'creator' | 'any' | 'none';
     /** The creator's seat, required to enforce `reconfigurePolicy: 'creator'`. */
     readonly creatorSlot?: number;
+    readonly eventKeyId?: string;
+    readonly slotPolicies?: readonly AuthoritySlotPolicy[];
 }
 export interface DeterministicAuthorityRoomReconfiguration {
     readonly sessionConfigBytes: Uint8Array;
@@ -124,6 +130,137 @@ export interface DeterministicAuthorityRoomReconfiguration {
     /** When supplied, must equal the live identity; a mismatch throws. */
     readonly runtimeIdentity?: KinetixRuntimeIdentity;
 }
+export interface StagedSquadSeat {
+    readonly playerId: string;
+    readonly slot: number;
+    readonly manifestHash: string;
+}
+export interface StagedSquadAdmission {
+    readonly admissionId: string;
+    readonly handoffId: string;
+    readonly raidId: string;
+    readonly authorityEpoch: number;
+    readonly membershipEpoch: number;
+    readonly seats: readonly StagedSquadSeat[];
+    readonly hydrateThroughTick: number;
+    readonly runtimeDigest: string;
+    readonly preparedPlayerIds?: readonly string[];
+}
+export interface HydrationAck {
+    readonly profileId?: string;
+    readonly playerId?: string;
+    readonly handoffId: string;
+    readonly connectionId?: string;
+    readonly generation: number;
+    readonly membershipEpoch?: number;
+    readonly snapshotTick: number;
+    readonly appliedThroughTick: number;
+    readonly stateChecksum: string;
+    readonly manifestHash: string;
+    readonly runtimeDigest?: string;
+}
+export type StageResult = {
+    readonly ok: true;
+    readonly admission: StagedSquadAdmission;
+} | {
+    readonly ok: false;
+    readonly reason: 'slot-collision' | 'player-collision' | 'already-staged' | 'stale-epoch' | 'epoch-mismatch' | 'capacity-exceeded' | 'invalid-admission';
+};
+export type PrepareResult = {
+    readonly ok: true;
+    readonly allPrepared: boolean;
+    readonly preparedPlayerIds: readonly string[];
+} | {
+    readonly ok: false;
+    readonly reason: 'unknown-player' | 'not-staged' | 'not-connected' | 'generation-mismatch' | 'handoff-mismatch' | 'checksum-mismatch' | 'digest-mismatch' | 'manifest-mismatch' | 'tick-mismatch' | 'invalid-ack';
+};
+export type ScheduleResult = {
+    readonly ok: true;
+    readonly effectiveTick: number;
+} | {
+    readonly ok: false;
+    readonly reason: 'unknown-admission' | 'not-all-prepared' | 'past-tick' | 'collision' | 'invalid-tick' | 'already-scheduled';
+};
+export type AbortResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason: 'unknown-admission' | 'already-applied';
+};
+export interface CommittedAdmissionDecision {
+    readonly admissionId: string;
+    readonly handoffId: string;
+    readonly raidId: string;
+    readonly authorityEpoch: number;
+    readonly escrowState: 'committed';
+    readonly seats: readonly {
+        readonly playerId: string;
+        readonly slot: number;
+        readonly manifestHash: string;
+    }[];
+}
+export interface AdmissionDecisionSource {
+    read(admissionId: string): Promise<CommittedAdmissionDecision>;
+}
+export type AuthorityEvent = {
+    readonly kind: 'airdrop';
+    readonly grantId: string;
+    readonly spawnPointId: string;
+    readonly tableDigest: string;
+} | {
+    readonly kind: 'beacon';
+    readonly beaconId: string;
+    readonly locationId: string;
+    readonly expiresAtTick: number;
+} | {
+    readonly kind: 'raidDeadline';
+    readonly cutoffTick: number;
+};
+export interface AuthorityEventRequest {
+    readonly v: 1;
+    readonly eventId: string;
+    readonly raidId: string;
+    readonly authorityEpoch: number;
+    readonly notBeforeTick: number;
+    readonly expiresAtTick: number;
+    readonly event: AuthorityEvent;
+}
+export interface OrderedAuthorityEvent {
+    readonly v: 1;
+    readonly origin: 'server';
+    readonly kind: 'platform.event';
+    readonly eventId: string;
+    readonly authorityEpoch: number;
+    readonly authoritySequence: number;
+    readonly tick: number;
+    readonly payload: AuthorityEvent;
+    readonly signature: string;
+    readonly keyId: string;
+}
+export interface BotInputSubmission {
+    readonly v: 1;
+    readonly raidId: string;
+    readonly authorityEpoch: number;
+    readonly botLeaseId: string;
+    readonly slot: number;
+    readonly tick: number;
+    readonly sequence: number;
+    readonly input: EncodedInput;
+}
+export type EventQueueResult = {
+    readonly status: 'accepted';
+    readonly eventId: string;
+    readonly assignedTick: number;
+    readonly authoritySequence: number;
+} | {
+    readonly status: 'duplicate';
+    readonly eventId: string;
+    readonly assignedTick: number;
+    readonly authoritySequence: number;
+} | {
+    readonly status: 'rejected';
+    readonly reason: string;
+};
 export interface DeterministicAuthorityRoomRestoreState {
     readonly now: number;
     readonly confirmedThrough: number;
@@ -138,6 +275,29 @@ export interface DeterministicAuthorityRoomRestoreState {
     readonly secretState?: SyncplaySecretAuthoritySnapshot;
     /** Session generation at persist time; a restored room re-greets with it. Default 0. */
     readonly generation?: number;
+    readonly membershipEpoch?: number;
+    readonly memberships?: readonly TickMembership[];
+    readonly bots?: readonly string[];
+    readonly pendingPlayers?: readonly string[];
+    readonly disconnectedPlayers?: readonly string[];
+    readonly stagedAdmissions?: readonly StagedSquadAdmission[];
+    readonly scheduledAdmissions?: readonly {
+        readonly admissionId: string;
+        readonly effectiveTick: number;
+    }[];
+    readonly appliedAdmissionIds?: readonly string[];
+    readonly enqueuedEvents?: readonly {
+        readonly request: AuthorityEventRequest;
+        readonly assignedTick: number;
+        readonly authoritySequence: number;
+    }[];
+    readonly nextAuthorityEventSequence?: number;
+    readonly evacuatedSlots?: readonly number[];
+    readonly evacuatedPlayerIds?: readonly string[];
+    readonly scheduledEvacuations?: readonly {
+        readonly targetTick: number;
+        readonly slot: number;
+    }[];
 }
 export interface AuthorityRoomCatchUpEvent {
     readonly playerId: string;
@@ -192,7 +352,7 @@ export interface AuthorityRoomNetcodeStats {
 export interface AuthorityRoomJoinResult {
     readonly accepted: boolean;
     readonly slot?: number;
-    readonly reason?: 'room-full' | 'already-joined' | 'history-unavailable';
+    readonly reason?: 'room-full' | 'already-joined' | 'history-unavailable' | 'incompatible-protocol';
     /** True when this join re-attached a previously-seen playerId to its original slot. */
     readonly rejoined?: boolean;
 }
@@ -220,12 +380,37 @@ export interface AuthorityRoomSnapshot {
     /** Most recent snapshot rejection reason, if any snapshot attempt was rejected. */
     readonly lastSnapshotRejection?: string;
     /** Details of the pending snapshot transfer currently in-flight, if any. */
+    readonly membershipEpoch?: number;
+    readonly memberships?: readonly TickMembership[];
+    readonly bots?: readonly string[];
+    readonly pendingPlayers?: readonly string[];
+    readonly disconnectedPlayers?: readonly string[];
     readonly pendingSnapshotTransfer?: {
         readonly donorId: string;
         readonly minFrame: number;
         readonly startedAt: number;
         readonly elapsedTicks: number;
+        readonly targetTick?: number;
+        readonly frozenReporterSlots?: readonly number[];
     };
+    readonly stagedAdmissions?: readonly StagedSquadAdmission[];
+    readonly scheduledAdmissions?: readonly {
+        readonly admissionId: string;
+        readonly effectiveTick: number;
+    }[];
+    readonly appliedAdmissionIds?: readonly string[];
+    readonly evacuatedSlots?: readonly number[];
+    readonly evacuatedPlayerIds?: readonly string[];
+    readonly scheduledEvacuations?: readonly {
+        readonly targetTick: number;
+        readonly slot: number;
+    }[];
+}
+export interface TickMembership {
+    readonly tick: number;
+    readonly membershipEpoch: number;
+    readonly occupiedSlots: readonly number[];
+    readonly humanReporterSlots: readonly number[];
 }
 export interface AuthorityRoomStoredSnapshotMeta {
     readonly tick: number;
@@ -237,7 +422,16 @@ export interface AuthorityRoomStoredSnapshotMeta {
 export interface DeterministicAuthorityRoom {
     readonly confirmedThrough: number;
     readonly playerCount: number;
-    onPlayerJoin(playerId: string): AuthorityRoomJoinResult;
+    onPlayerJoin(playerId: string, options?: {
+        readonly isPending?: boolean;
+        readonly capabilities?: readonly string[];
+    }): AuthorityRoomJoinResult;
+    setPlayerPending(playerId: string, pending: boolean): void;
+    stageSquad(admission: StagedSquadAdmission): StageResult;
+    markPrepared(playerId: string, acknowledgement: HydrationAck): PrepareResult;
+    scheduleAdmission(admissionId: string, effectiveTick: number): ScheduleResult;
+    abortStagedAdmission(admissionId: string): AbortResult;
+    isAdmissionActivated?(admissionId: string): boolean;
     /** Seat a read-only spectator (G11): role 'spectator', no slot, full catch-up + live follow. */
     onSpectatorJoin(playerId: string): boolean;
     onPlayerMessage(playerId: string, envelope: string): void;
@@ -258,6 +452,8 @@ export interface DeterministicAuthorityRoom {
      * with no slot (spectator, unknown id).
      */
     onPlayerDisconnected(playerId: string): void;
+    membershipAt(tick: number): TickMembership;
+    registerBot(playerId: string): void;
     /** Advance the authority by one server tick and broadcast newly-confirmed frames. */
     onTick(): void;
     /**
@@ -297,5 +493,15 @@ export interface DeterministicAuthorityRoom {
     matchLog(): SyncplayMatchLog | undefined;
     /** Server-only secret state. Never include this value in public snapshots or match logs. */
     secretSnapshot(): SyncplaySecretAuthoritySnapshot | undefined;
+    enqueueAuthorityEvent(validated: AuthorityEventRequest, options?: {
+        readonly signature?: string;
+        readonly keyId?: string;
+    }): EventQueueResult;
+    receiveVirtualInput(validated: BotInputSubmission): InputSubmissionResult;
+    activateBotSlot(slot: number, botId?: string): void;
+    deactivateBotSlot(slot: number): void;
+    evacuateParticipant(slot: number, scheduledTick?: number): {
+        scheduledTick: number;
+    };
 }
 export declare function createDeterministicAuthorityRoom(transport: AuthorityRoomTransport, config: DeterministicAuthorityRoomConfig): DeterministicAuthorityRoom;