@series-inc/rundot-syncplay 5.25.0-beta.5 → 5.25.0-beta.6

package/README.md

@@ -171,6 +171,10 @@ runner without rewriting those layers:
 - Drive a room badge from the snapshot's `ready`, `appliedThrough`, `predictedThrough`,
   `localSlot`, and `status` — no reach into the underlying client (e.g. `appliedThrough < 0`
   means "waiting for peers"; `predictedThrough - appliedThrough` is the catch-up depth).
+- Tune the networked client through the runner: `pacing` (`targetLeadTicks`,
+  `maxStepsPerPump`, drift correction) and `inputDelay` (`minTicks`/`maxTicks`,
+  RTT-adaptive) are forwarded verbatim, and live `netStats` (RTT, timescale, input
+  delay) is surfaced on the snapshot + runner (`null` offline) for a netcode HUD.
 
 Direct `NetworkedSyncplayClient` users get the same projection surface:
 `getPresentationFrame()`, `renderAlpha`, `currentFrame`, `caughtUp`, and a

package/dist/runner.d.ts

@@ -1,5 +1,5 @@
 import type { DeterministicEventRecord } from './events.js';
-import { type KinetixRuntimeFactory, type NetworkedClientTransport, type NetworkedSyncplaySessionDescriptor, type NetworkedSyncplayClientOptions } from './networked-client.js';
+import { type KinetixRuntimeFactory, type NetworkedClientTransport, type NetworkedSyncplaySessionDescriptor, type NetworkedSyncplayClientInputDelayOptions, type NetworkedSyncplayClientNetStats, type NetworkedSyncplayClientOptions, type NetworkedSyncplayClientPacingOptions } from './networked-client.js';
 import type { KinetixRuntimeIdentity } from './runtime-session.js';
 export type SyncplayRunnerStatus = 'offline' | 'connecting' | 'syncing' | 'live' | 'stopped' | 'error';
 export type SyncplayRunnerConnectionEvent = {
@@ -39,6 +39,16 @@ export interface SyncplayRunnerConfig<State, Input, Checkpoint, Projection, Rend
      * omitted, the runner uses the last `applyInput(...)` value verbatim.
      */
     readonly localInputForTick?: (slot: number, frame: number) => Input;
+    /**
+     * Wall-clock pacing + clock-drift correction for the networked client (G1).
+     * Forwarded verbatim; omit for the client defaults.
+     */
+    readonly pacing?: NetworkedSyncplayClientPacingOptions;
+    /**
+     * Local input delay for the networked client. `maxTicks > minTicks` auto-tunes
+     * from measured RTT. Forwarded verbatim; omit for the client default (0).
+     */
+    readonly inputDelay?: NetworkedSyncplayClientInputDelayOptions;
 }
 export interface SyncplayRunnerOfflineOptions<Input> {
     readonly identity: KinetixRuntimeIdentity;
@@ -63,6 +73,8 @@ export interface SyncplayRunnerSnapshot<RenderState> {
     readonly ready: boolean;
     readonly appliedThrough: number;
     readonly predictedThrough: number;
+    /** Live networked netcode telemetry (RTT, timescale, input delay); null offline. */
+    readonly netStats: NetworkedSyncplayClientNetStats | null;
     readonly error?: Error;
 }
 export interface SyncplayRunner<Input, RenderState, EventPayload> {
@@ -73,6 +85,7 @@ export interface SyncplayRunner<Input, RenderState, EventPayload> {
     readonly ready: boolean;
     readonly appliedThrough: number;
     readonly predictedThrough: number;
+    readonly netStats: NetworkedSyncplayClientNetStats | null;
     startOffline(options: SyncplayRunnerOfflineOptions<Input>): void;
     startNetworked(connect: () => Promise<SyncplayRunnerTransport>): Promise<void>;
     applyInput(input: Input): void;

package/dist/runner.js

@@ -59,6 +59,7 @@ export function createSyncplayRunner(config) {
             ready: telemetryReady(),
             appliedThrough: telemetryAppliedThrough(),
             predictedThrough: telemetryPredictedThrough(),
+            netStats: networkClient?.netStats ?? null,
             ...(status === 'error' && error !== undefined ? { error } : {}),
         });
     }
@@ -190,6 +191,8 @@ export function createSyncplayRunner(config) {
                 decodeInput: config.decodeInput,
                 confirmedPresentationBufferSize: 256,
                 ...(config.maxPredictionTicks === undefined ? {} : { maxPredictionTicks: config.maxPredictionTicks }),
+                ...(config.pacing === undefined ? {} : { pacing: config.pacing }),
+                ...(config.inputDelay === undefined ? {} : { inputDelay: config.inputDelay }),
             });
             networkClient = client;
             await client.whenReady();
@@ -288,6 +291,7 @@ export function createSyncplayRunner(config) {
         get ready() { return telemetryReady(); },
         get appliedThrough() { return telemetryAppliedThrough(); },
         get predictedThrough() { return telemetryPredictedThrough(); },
+        get netStats() { return networkClient?.netStats ?? null; },
         startOffline,
         startNetworked,
         applyInput(input) { latestInput = structuredClone(input); },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/rundot-syncplay",
-  "version": "5.25.0-beta.5",
+  "version": "5.25.0-beta.6",
   "description": "Kinetix orchestration, rollback, replay, late-join, and deterministic networking for RUN.game",
   "repository": {
     "type": "git",