@vworlds/vecs-client 1.0.16

package/vecs-client/src/interpolator.js

@@ -0,0 +1,305 @@
+import { ALL_COMPONENTS, ComponentSnapshot as WireComponentSnapshot, cid_pack, cid_unpack, } from "@vworlds/vecs-protocol";
+import { Decoder } from "@vworlds/vecs-wire";
+const MAX_LENGTH = 3;
+const POSITION_COMPONENT_TYPE = 1;
+export class ComponentSnapshot {
+    constructor(eid, type, payload) {
+        this.eid = eid;
+        this.type = type;
+        this.payload = payload;
+        this.cid = cid_pack(eid, type);
+    }
+}
+export class Diff {
+    constructor(from, to, removed) {
+        this.from = from;
+        this.to = to;
+        this.removed = removed;
+        this.snapshots = [];
+    }
+    get smap() {
+        if (this._smap) {
+            return this._smap;
+        }
+        return (this._smap = new Map((this.snapshots || []).map((s) => [s.cid, s])));
+    }
+    set smap(v) {
+        this._smap = v;
+        this.updateSnapshotsFromMap();
+    }
+    updateSnapshotsFromMap() {
+        this.snapshots = [...this.smap.values()];
+    }
+}
+export function diffFromStateDiff(sd) {
+    const d = new Diff(sd.fromFrame, sd.toFrame);
+    d.snapshots = sd.snapshots.map((snapshot) => {
+        const wire = new Decoder(snapshot.bytes).read(WireComponentSnapshot);
+        return new ComponentSnapshot(wire.eid, wire.type, wire.payload);
+    });
+    d.removed = sd.removed.map(([eid, type]) => cid_pack(eid, type));
+    return d;
+}
+export class Interpolator {
+    constructor(max_length = MAX_LENGTH, // max bucket length
+    server_tick_interval = 1000 / 60, // server tick interval FPS configuration
+    _decodeComponentSnapshot) {
+        this.max_length = max_length;
+        this.server_tick_interval = server_tick_interval;
+        this._decodeComponentSnapshot = _decodeComponentSnapshot;
+        // state contains the state the game is currently rendering.
+        this._state = new Map();
+        this._stateVersion = 0;
+        // first has the version of the first element in the bucket
+        // if first is undefined, then the bucket is empty
+        this._first = undefined;
+        // version indicates the last version received by the server
+        // that can be acknowledged
+        this.version = -1;
+        // tServ tracks the server time approximately
+        this._tServ = -1;
+        // lastTime contains the timestamp for the last pull() call and is used as
+        // the moving interpolation baseline when pull() is called before tServ.
+        this._lastTime = -1;
+        if (max_length < 2) {
+            throw new Error("minimum interpolation bucket length is 2");
+        }
+        this.bucket = Array(this.max_length).fill(undefined);
+    }
+    _updateState(sd) {
+        // apply diff to current state
+        sd.snapshots?.forEach((s) => {
+            this._state.set(s.cid, s);
+        });
+        sd.removed?.forEach((r) => {
+            const [eid, type] = cid_unpack(r);
+            if (type === ALL_COMPONENTS) {
+                this._state.forEach((_, cid) => {
+                    if (cid_unpack(cid)[0] === eid) {
+                        this._state.delete(cid);
+                    }
+                });
+                return;
+            }
+            this._state.delete(r);
+        });
+        this._stateVersion = sd.to;
+    }
+    // pop removes the first element of the bucket
+    // shifting all elements to the left.
+    _pop() {
+        for (let j = 0; j < this.bucket.length - 1; j++) {
+            this.bucket[j] = this.bucket[j + 1];
+        }
+        this.bucket[this.bucket.length - 1] = undefined;
+    }
+    // pull returns a constructed Diff from elements
+    // in the bucket + interpolation
+    pull(now) {
+        const next = this.bucket[0];
+        let sd = new Diff(this._stateVersion, this._stateVersion, undefined);
+        if (next === undefined) {
+            // there is nothing in the buffer, so return an empty diff
+            // since we are hitting an empty buffer, allow some extra time for it
+            // to replenish, by delaying the server time.
+            this._tServ = now + this.server_tick_interval * this.bucket.length;
+            this._first = undefined;
+            this._lastTime = now;
+            return sd; // return empty diff
+        }
+        if (this._tServ === -1) {
+            this._tServ = now;
+        }
+        // lerpStart is the timestamp of the currently visualized state.
+        let lerpStart = this._lastTime;
+        // The following loop will incorporate (merge) into the
+        // proposed diff (sd) as many snapshots from the bucket
+        // as it needs in order to catch up to server time, that is,
+        // if we are ahead of the server timestamp, merge
+        // snapshots until we are behind
+        // or have eaten the whole buffer.
+        for (let i = 0; i < this.bucket.length && now >= this._tServ; i++, this._tServ += this.server_tick_interval) {
+            // take snapshot on bucket[0] and merge it on to the result:
+            sd = merge(sd, this.bucket[0], false);
+            lerpStart = this._tServ;
+            this._pop(); //remove bucket[0] and shift contents to the left
+        }
+        // skip bucket items that are undefined. At the end of this
+        // loop either bucket[0] has a diff or the whole bucket is empty.
+        // we only alter tServ if something was actually in the bucket at all.
+        let tsDelta = 0;
+        for (let i = 0; i < this.bucket.length; i++) {
+            if (this.bucket[0]) {
+                this._tServ += tsDelta;
+                break;
+            }
+            this._pop();
+            tsDelta += this.server_tick_interval;
+        }
+        // At this point, if something is in the bucket, bucket[0] contains the
+        // next target. Position snapshots are blended into the returned diff so
+        // callers can render fake frames between server ticks.
+        const target = this.bucket[0];
+        if (target) {
+            this._interpolatePositions(sd, target, lerpStart, this._tServ, now);
+            this._first = target.to;
+        }
+        else {
+            this._first = undefined;
+        }
+        // incorporate this diff into our visualization of the state prior
+        // to handing this diff out to the scene:
+        this._updateState(sd);
+        this._lastTime = now;
+        return sd;
+    }
+    // push takes diffs coming from the wire and incorporates them
+    // to the snapshot bucket in the right position:
+    push(diff) {
+        // in case of buffer empty or first diff, initialize everything:
+        if (this._first === undefined) {
+            this.bucket[0] = diff;
+            this._first = diff.to;
+            this.version = diff.to;
+            return;
+        }
+        // servers should never send a diff we can't handle
+        // The below can only happen if the server is ignoring acks:
+        if (diff.from > this.version) {
+            throw new Error("protocol error");
+        }
+        // Locate the index position for this diff in the bucket based on the
+        // version of the first item in the bucket:
+        let index = diff.to - this._first;
+        // negative index means this information is too old:
+        if (index < 0) {
+            return; // too old. Discard
+        }
+        if (index >= this.bucket.length) {
+            // index falls out of the bucket, meaning
+            // there is old information in the bucket.
+            let d = index - (this.bucket.length - 1);
+            if (d >= this.bucket.length) {
+                // information in the bucket is extremely old
+                // we will merge everything on to bucket[0] + this diff
+                this._first = diff.to;
+                d = this.bucket.length;
+                index = 0;
+            }
+            else {
+                // information was old, but it can be fixed by
+                // merging partially.
+                index = this.bucket.length - d;
+            }
+            // the following loop merges as much as needed to make
+            // space for the incoming diff.
+            for (let i = 0; i < d; i++) {
+                this.bucket[0] = merge(this.bucket[0], this.bucket[1]);
+                for (let j = 1; j < this.bucket.length - 1; j++) {
+                    this.bucket[j] = this.bucket[j + 1];
+                }
+                this.bucket[this.bucket.length - 1] = undefined;
+            }
+        }
+        // merge the incoming diff with whatever is at the target
+        // index, normally undefined, but it could be a retransmit
+        // of the same frame.
+        this.bucket[index] = merge(this.bucket[index], diff);
+        // bucket[0] can never be undefined. If so, there is something wrong
+        // with the algorithm itself.
+        if (this.bucket[0] === undefined) {
+            throw new Error("bucket[0] is undefined");
+        }
+        this._first = this.bucket[0].to;
+        // setting `version` allows the session layer to ack this diff.
+        if (diff.to > this.version) {
+            this.version = diff.to;
+        }
+    }
+    _decodePositionSnapshot(snapshot) {
+        if (!(snapshot.payload instanceof Uint8Array)) {
+            if (!isPosition(snapshot.payload)) {
+                throw new Error(`Component type ${POSITION_COMPONENT_TYPE} must satisfy IPosition`);
+            }
+            return snapshot.payload;
+        }
+        if (!this._decodeComponentSnapshot) {
+            throw new Error("Position interpolation requires a component snapshot decoder");
+        }
+        const component = this._decodeComponentSnapshot(snapshot);
+        if (!isPosition(component)) {
+            throw new Error(`Component type ${POSITION_COMPONENT_TYPE} must satisfy IPosition`);
+        }
+        return component;
+    }
+    _interpolatePositions(sd, target, start, end, now) {
+        target.snapshots.forEach((targetSnapshot) => {
+            if (targetSnapshot.type !== POSITION_COMPONENT_TYPE) {
+                return;
+            }
+            const sourceSnapshot = sd.smap.get(targetSnapshot.cid) ?? this._state.get(targetSnapshot.cid);
+            if (!sourceSnapshot) {
+                return;
+            }
+            const sourcePosition = this._decodePositionSnapshot(sourceSnapshot);
+            const targetPosition = this._decodePositionSnapshot(targetSnapshot);
+            const position = lerp(sourcePosition, targetPosition, start, end, now);
+            sd.smap.set(targetSnapshot.cid, new ComponentSnapshot(targetSnapshot.eid, POSITION_COMPONENT_TYPE, position));
+        });
+        sd.updateSnapshotsFromMap();
+    }
+}
+function isPosition(component) {
+    const candidate = component;
+    return typeof candidate.x === "number" && typeof candidate.y === "number";
+}
+function lerp(a, b, start, end, t) {
+    if (end === start) {
+        return b;
+    }
+    const d = end - start;
+    const position = new b.constructor();
+    position.x = a.x + ((b.x - a.x) / d) * (t - start);
+    position.y = a.y + ((b.y - a.y) / d) * (t - start);
+    return position;
+}
+// helper function to add items to a set
+function addToSet(set, data) {
+    if (!data) {
+        return;
+    }
+    for (const item of data) {
+        set.add(item);
+    }
+}
+export function merge(a, b, check = true) {
+    if (!a) {
+        return b;
+    }
+    if (!b) {
+        return a;
+    }
+    if (check && (b.from || 0) > (a.to || 0)) {
+        // This is a protocol error.
+        // can only happen if server ignored our ACKs and
+        // incremented version counter on its own.
+        throw new Error("cannot merge snapshots");
+    }
+    const m = new Diff(a.from, b.to, undefined);
+    const removed = new Set();
+    addToSet(removed, a.removed);
+    addToSet(removed, b.removed);
+    const as = new Map(a.smap);
+    const bs = b.smap;
+    bs.forEach((s) => {
+        as.set(s.cid, s);
+        removed.delete(s.cid); // undelete re-added entities
+    });
+    removed.forEach((r) => as.delete(r));
+    if (removed.size) {
+        m.removed = [...removed];
+    }
+    m.smap = as;
+    return m;
+}
+//# sourceMappingURL=interpolator.js.map

package/vecs-client/src/interpolator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolator.js","sourceRoot":"","sources":["../../../src/interpolator.ts"],"names":[],"mappings":"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"}

package/vecs-client/src/world_path.d.ts

@@ -0,0 +1 @@
+export declare function worldPath(basePath: string | undefined, worldName: string): string;

package/vecs-client/src/world_path.js

@@ -0,0 +1,4 @@
+export function worldPath(basePath = "/rtc/v1/world", worldName) {
+    return `${basePath.replace(/\/$/, "")}/${encodeURIComponent(worldName)}`;
+}
+//# sourceMappingURL=world_path.js.map

package/vecs-client/src/world_path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world_path.js","sourceRoot":"","sources":["../../../src/world_path.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,QAAQ,GAAG,eAAe,EAAE,SAAiB;IACrE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;AAC3E,CAAC"}

package/vecs-protocol/src/cid.d.ts

@@ -0,0 +1,14 @@
+/** A component id packs an entity id and component type id into a uint32. */
+export type CID = number;
+/** Component type ids below this value can fit into packed wire component ids. */
+export declare let LOCAL_COMPONENT_MIN: number;
+/** Protocol removal marker for all components on an entity. */
+export declare const ALL_COMPONENTS = 0;
+/** Return the configured local component minimum after validating its alignment. */
+export declare function getLocalComponentMin(): number;
+/** Configure the local component type range before constructing networked worlds. */
+export declare function setLocalComponentMin(value: number): void;
+/** Pack an entity id and component type id into a uint32 component id. */
+export declare function cid_pack(eid: number, type: number): CID;
+/** Unpack a uint32 component id into [entity id, component type id]. */
+export declare function cid_unpack(cid: CID): [eid: number, type: number];

package/vecs-protocol/src/cid.js

@@ -0,0 +1,58 @@
+/** Component type ids below this value can fit into packed wire component ids. */
+export let LOCAL_COMPONENT_MIN = 256;
+/** Protocol removal marker for all components on an entity. */
+export const ALL_COMPONENTS = 0;
+let componentTypeMask = LOCAL_COMPONENT_MIN - 1;
+let componentTypeShift = Math.log2(LOCAL_COMPONENT_MIN);
+let MAX_ENTITY_ID = 2 ** (32 - componentTypeShift) - 1;
+let MAX_COMPONENT_TYPE = componentTypeMask;
+function validateLocalComponentMin(value) {
+    if (!isAlignedLocalComponentMin(value)) {
+        throw new Error("LOCAL_COMPONENT_MIN must be a power-of-two safe integer >= 2");
+    }
+    if (Math.log2(value) > 31) {
+        throw new Error("LOCAL_COMPONENT_MIN must reserve fewer than 32 component type bits");
+    }
+}
+function isAlignedLocalComponentMin(value) {
+    return Number.isSafeInteger(value) && value >= 2 && (value & (value - 1)) === 0;
+}
+/** Return the configured local component minimum after validating its alignment. */
+export function getLocalComponentMin() {
+    validateLocalComponentMin(LOCAL_COMPONENT_MIN);
+    return LOCAL_COMPONENT_MIN;
+}
+/** Configure the local component type range before constructing networked worlds. */
+export function setLocalComponentMin(value) {
+    LOCAL_COMPONENT_MIN = value;
+    if (isAlignedLocalComponentMin(value)) {
+        getLocalComponentMin();
+        componentTypeMask = LOCAL_COMPONENT_MIN - 1;
+        componentTypeShift = Math.log2(LOCAL_COMPONENT_MIN);
+        MAX_ENTITY_ID = 2 ** (32 - componentTypeShift) - 1;
+        MAX_COMPONENT_TYPE = componentTypeMask;
+    }
+}
+/** Pack an entity id and component type id into a uint32 component id. */
+export function cid_pack(eid, type) {
+    if (eid < 0) {
+        throw new Error(`cid_pack: entity id must be non-negative, got ${eid}`);
+    }
+    if (eid > MAX_ENTITY_ID) {
+        throw new Error(`cid_pack: entity id ${eid} exceeds maximum ${MAX_ENTITY_ID} for LOCAL_COMPONENT_MIN=${LOCAL_COMPONENT_MIN}. ` +
+            `Increase LOCAL_COMPONENT_MIN or use a smaller entity id.`);
+    }
+    if (type < 0) {
+        throw new Error(`cid_pack: type id must be non-negative, got ${type}`);
+    }
+    if (type > MAX_COMPONENT_TYPE) {
+        throw new Error(`cid_pack: type id ${type} exceeds maximum component type ${MAX_COMPONENT_TYPE}. ` +
+            `Ensure type id is less than LOCAL_COMPONENT_MIN=${LOCAL_COMPONENT_MIN}.`);
+    }
+    return ((eid << componentTypeShift) | (type & componentTypeMask)) >>> 0;
+}
+/** Unpack a uint32 component id into [entity id, component type id]. */
+export function cid_unpack(cid) {
+    return [cid >>> componentTypeShift, cid & componentTypeMask];
+}
+//# sourceMappingURL=cid.js.map

package/vecs-protocol/src/cid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cid.js","sourceRoot":"","sources":["../../../../vecs-protocol/src/cid.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,MAAM,CAAC,IAAI,mBAAmB,GAAG,GAAG,CAAC;AAErC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,IAAI,iBAAiB,GAAG,mBAAmB,GAAG,CAAC,CAAC;AAChD,IAAI,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AACxD,IAAI,aAAa,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACvD,IAAI,kBAAkB,GAAG,iBAAiB,CAAC;AAE3C,SAAS,yBAAyB,CAAC,KAAa;IAC9C,IAAI,CAAC,0BAA0B,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAa;IAC/C,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAClF,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,oBAAoB;IAClC,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;IAC/C,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,mBAAmB,GAAG,KAAK,CAAC;IAC5B,IAAI,0BAA0B,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,oBAAoB,EAAE,CAAC;QACvB,iBAAiB,GAAG,mBAAmB,GAAG,CAAC,CAAC;QAC5C,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACpD,aAAa,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACnD,kBAAkB,GAAG,iBAAiB,CAAC;IACzC,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAY;IAChD,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,GAAG,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,GAAG,GAAG,aAAa,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,uBAAuB,GAAG,oBAAoB,aAAa,4BAA4B,mBAAmB,IAAI;YAC5G,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,IAAI,GAAG,kBAAkB,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,mCAAmC,kBAAkB,IAAI;YAChF,mDAAmD,mBAAmB,GAAG,CAC5E,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,CAAC,GAAG,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,GAAG,iBAAiB,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,GAAQ;IACjC,OAAO,CAAC,GAAG,KAAK,kBAAkB,EAAE,GAAG,GAAG,iBAAiB,CAAC,CAAC;AAC/D,CAAC"}

package/vecs-protocol/src/index.d.ts

@@ -0,0 +1,5 @@
+export { ALL_COMPONENTS, LOCAL_COMPONENT_MIN, cid_pack, cid_unpack, getLocalComponentMin, setLocalComponentMin, type CID, } from "./cid.js";
+export { NetworkWorld, type NetworkWorldOptions, type RegisteredNetworkComponent, } from "./network_world.js";
+export { Client2Server, ComponentSnapshot, EncodedSnapshot, Server2Client, StateDiff, type RemovedComponent, } from "./messages.js";
+export { FIRST_USER_RPC_ID, RPC, RPC_RESPONSE_ID, RPC_TIMEOUT_ERROR, SessionRPC, type RPCHandler, } from "./rpc.js";
+export type { ConnectionError, VecsSocket, VecsSocketEvents, VecsSocketListener, VecsSocketListenerEvents, } from "./transport.js";

package/vecs-protocol/src/index.js

@@ -0,0 +1,5 @@
+export { ALL_COMPONENTS, LOCAL_COMPONENT_MIN, cid_pack, cid_unpack, getLocalComponentMin, setLocalComponentMin, } from "./cid.js";
+export { NetworkWorld, } from "./network_world.js";
+export { Client2Server, ComponentSnapshot, EncodedSnapshot, Server2Client, StateDiff, } from "./messages.js";
+export { FIRST_USER_RPC_ID, RPC, RPC_RESPONSE_ID, RPC_TIMEOUT_ERROR, SessionRPC, } from "./rpc.js";
+//# sourceMappingURL=index.js.map

package/vecs-protocol/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../vecs-protocol/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,SAAS,GAEV,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,GAAG,EACH,eAAe,EACf,iBAAiB,EACjB,UAAU,GAEX,MAAM,UAAU,CAAC"}

package/vecs-protocol/src/messages.d.ts

@@ -0,0 +1,42 @@
+import { Decoder, Encoder, type IEncodable } from "@vworlds/vecs-wire";
+import { RPC } from "./rpc.js";
+export declare class ComponentSnapshot implements IEncodable {
+    eid: number;
+    type: number;
+    payload: Uint8Array;
+    constructor(values?: Partial<ComponentSnapshot>);
+    wireEncode(encoder: Encoder): void;
+    static wireDecode(decoder: Decoder): ComponentSnapshot;
+}
+export declare class EncodedSnapshot {
+    bytes: Uint8Array;
+    eid: number;
+    type: number;
+    constructor(bytes: Uint8Array, // contains an already-encoded ComponentSnapshot
+    eid?: number, type?: number);
+}
+export type RemovedComponent = [eid: number, type: number];
+export declare class StateDiff implements IEncodable {
+    toFrame: number;
+    fromFrame: number;
+    snapshots: EncodedSnapshot[];
+    removed: RemovedComponent[];
+    constructor(values?: Partial<StateDiff>);
+    wireEncode(encoder: Encoder): void;
+    static wireDecode(decoder: Decoder): StateDiff;
+}
+export declare class Server2Client implements IEncodable {
+    diff: StateDiff | undefined;
+    rpc: RPC[];
+    constructor(values?: Partial<Server2Client>);
+    wireEncode(encoder: Encoder): void;
+    static wireDecode(decoder: Decoder): Server2Client;
+}
+export declare class Client2Server implements IEncodable {
+    ackFrame: number;
+    input: unknown | undefined;
+    rpc: RPC[];
+    constructor(values?: Partial<Client2Server>);
+    wireEncode(encoder: Encoder): void;
+    static wireDecode(decoder: Decoder): Client2Server;
+}

package/vecs-protocol/src/messages.js

@@ -0,0 +1,149 @@
+import { cid_pack, cid_unpack } from "./cid.js";
+import { RPC } from "./rpc.js";
+const FIELD_DIFF = 1;
+const FIELD_RPC = 2;
+const FIELD_INPUT = 3;
+export class ComponentSnapshot {
+    constructor(values) {
+        this.eid = 0;
+        this.type = 0;
+        this.payload = new Uint8Array();
+        if (values) {
+            Object.assign(this, values);
+        }
+    }
+    wireEncode(encoder) {
+        encoder.write_u32(cid_pack(this.eid, this.type));
+        encoder.write_buffer(this.payload);
+    }
+    static wireDecode(decoder) {
+        const [eid, type] = cid_unpack(decoder.read_u32());
+        return new ComponentSnapshot({
+            eid,
+            type,
+            payload: decoder.read_bytes(),
+        });
+    }
+}
+export class EncodedSnapshot {
+    constructor(bytes, // contains an already-encoded ComponentSnapshot
+    eid = 0, type = 0) {
+        this.bytes = bytes;
+        this.eid = eid;
+        this.type = type;
+    }
+}
+export class StateDiff {
+    constructor(values) {
+        this.toFrame = 0;
+        this.fromFrame = 0;
+        this.snapshots = [];
+        this.removed = [];
+        if (values) {
+            Object.assign(this, values);
+        }
+    }
+    wireEncode(encoder) {
+        encoder.write_u32(this.toFrame);
+        encoder.write_u32(this.fromFrame);
+        encoder.write_u32(this.snapshots.length);
+        this.snapshots.forEach((snapshot) => encoder.write_buffer(snapshot.bytes));
+        encoder.write_u32(this.removed.length);
+        this.removed.forEach(([eid, type]) => encoder.write_u32(cid_pack(eid, type)));
+    }
+    static wireDecode(decoder) {
+        const diff = new StateDiff({ toFrame: decoder.read_u32(), fromFrame: decoder.read_u32() });
+        const snapshotCount = decoder.read_u32();
+        for (let i = 0; i < snapshotCount; i++) {
+            diff.snapshots.push(new EncodedSnapshot(decoder.read_bytes()));
+        }
+        const removedCount = decoder.read_u32();
+        for (let i = 0; i < removedCount; i++) {
+            diff.removed.push(cid_unpack(decoder.read_u32()));
+        }
+        return diff;
+    }
+}
+export class Server2Client {
+    constructor(values) {
+        this.rpc = [];
+        if (values) {
+            Object.assign(this, values);
+        }
+    }
+    wireEncode(encoder) {
+        if (this.diff) {
+            encoder.write_u8(FIELD_DIFF);
+            encoder.write(this.diff);
+        }
+        if (this.rpc.length > 0) {
+            encoder.write_u8(FIELD_RPC);
+            encoder.write_u32(this.rpc.length);
+            this.rpc.forEach((rpc) => encoder.write(rpc));
+        }
+    }
+    static wireDecode(decoder) {
+        const message = new Server2Client();
+        while (!decoder.EOF) {
+            const tag = decoder.read_u8();
+            switch (tag) {
+                case FIELD_DIFF:
+                    message.diff = decoder.read(StateDiff);
+                    break;
+                case FIELD_RPC: {
+                    const count = decoder.read_u32();
+                    for (let i = 0; i < count; i++) {
+                        message.rpc.push(decoder.read(RPC));
+                    }
+                    break;
+                }
+                default:
+                    throw new Error(`Invalid Server2Client field tag ${tag}`);
+            }
+        }
+        return message;
+    }
+}
+export class Client2Server {
+    constructor(values) {
+        this.ackFrame = 0;
+        this.rpc = [];
+        if (values) {
+            Object.assign(this, values);
+        }
+    }
+    wireEncode(encoder) {
+        encoder.write_u32(this.ackFrame);
+        if (this.input !== undefined) {
+            encoder.write_u8(FIELD_INPUT);
+            encoder.write_any(this.input);
+        }
+        if (this.rpc.length > 0) {
+            encoder.write_u8(FIELD_RPC);
+            encoder.write_u32(this.rpc.length);
+            this.rpc.forEach((rpc) => encoder.write(rpc));
+        }
+    }
+    static wireDecode(decoder) {
+        const message = new Client2Server({ ackFrame: decoder.read_u32() });
+        while (!decoder.EOF) {
+            const tag = decoder.read_u8();
+            switch (tag) {
+                case FIELD_INPUT:
+                    message.input = decoder.read_any();
+                    break;
+                case FIELD_RPC: {
+                    const count = decoder.read_u32();
+                    for (let i = 0; i < count; i++) {
+                        message.rpc.push(decoder.read(RPC));
+                    }
+                    break;
+                }
+                default:
+                    throw new Error(`Invalid Client2Server field tag ${tag}`);
+            }
+        }
+        return message;
+    }
+}
+//# sourceMappingURL=messages.js.map

package/vecs-protocol/src/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../../vecs-protocol/src/messages.ts"],"names":[],"mappings":"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"}

package/vecs-protocol/src/network_world.d.ts

@@ -0,0 +1,18 @@
+import { World, type ComponentClass, type WorldOptions } from "@vworlds/vecs";
+export interface RegisteredNetworkComponent {
+    Class: ComponentClass;
+    type: number;
+}
+export interface NetworkWorldOptions extends Omit<WorldOptions, "idPools"> {
+    networkComponents?: readonly ComponentClass[];
+    entityIdStart?: number;
+    localEntityIdStart?: number;
+    networkEntityReuseWaitFrames?: number;
+}
+export declare class NetworkWorld extends World {
+    readonly localComponentMin: number;
+    readonly networkComponents: readonly RegisteredNetworkComponent[];
+    private readonly _networkComponentsByType;
+    constructor(options?: NetworkWorldOptions);
+    getNetworkComponent(type: number): RegisteredNetworkComponent | undefined;
+}