@vworlds/vecs-server 1.0.16

package/vecs-protocol/src/network_world.js

@@ -0,0 +1,93 @@
+import { World } from "@vworlds/vecs";
+import { cid_pack, setLocalComponentMin } from "./cid.js";
+const DEFAULT_ENTITY_ID_START = 1000;
+const MODULE_ID_RANGE_SIZE = 100;
+let configuredLocalComponentMin;
+export class NetworkWorld extends World {
+    constructor(options = {}) {
+        const networkComponents = options.networkComponents ?? [];
+        const localComponentMin = getLocalComponentMinFor(networkComponents.length);
+        configureLocalComponentMin(localComponentMin);
+        super({
+            idPools: buildNetworkIdPools(localComponentMin, options),
+        });
+        this._networkComponentsByType = new Map();
+        this.localComponentMin = localComponentMin;
+        this.networkComponents = networkComponents.map((Class, index) => {
+            const type = index + 1;
+            cid_pack(0, type);
+            this.component(Class, type);
+            const registered = { Class, type };
+            this._networkComponentsByType.set(type, registered);
+            return registered;
+        });
+    }
+    getNetworkComponent(type) {
+        return this._networkComponentsByType.get(type);
+    }
+}
+function configureLocalComponentMin(localComponentMin) {
+    if (configuredLocalComponentMin === undefined) {
+        configuredLocalComponentMin = localComponentMin;
+        setLocalComponentMin(localComponentMin);
+        return;
+    }
+    if (configuredLocalComponentMin !== localComponentMin) {
+        throw new Error(`NetworkWorld localComponentMin ${localComponentMin} does not match existing value ${configuredLocalComponentMin}`);
+    }
+    setLocalComponentMin(localComponentMin);
+}
+function buildNetworkIdPools(localComponentMin, options) {
+    const entityIdStart = options.entityIdStart ?? DEFAULT_ENTITY_ID_START;
+    validateEntityStart("entityIdStart", entityIdStart);
+    if (entityIdStart <= localComponentMin) {
+        throw new Error("entityIdStart must leave room for local component ids");
+    }
+    const moduleIdStart = entityIdStart - MODULE_ID_RANGE_SIZE;
+    if (moduleIdStart <= localComponentMin) {
+        throw new Error("entityIdStart must leave room for local component and module ids");
+    }
+    const pools = [
+        { name: "network", min: 1, max: localComponentMin - 1 },
+        { name: "component", min: localComponentMin, max: moduleIdStart - 1 },
+        { name: "module", min: moduleIdStart, max: entityIdStart - 1 },
+    ];
+    if (options.localEntityIdStart === undefined) {
+        pools.push({ name: "entity", min: entityIdStart });
+        return pools;
+    }
+    const localEntityIdStart = options.localEntityIdStart;
+    validateEntityStart("localEntityIdStart", localEntityIdStart);
+    if (localEntityIdStart <= entityIdStart) {
+        throw new Error("localEntityIdStart must be greater than entityIdStart");
+    }
+    const networkEntityPool = {
+        name: "network_entity",
+        min: entityIdStart,
+        max: localEntityIdStart - 1,
+    };
+    if (options.networkEntityReuseWaitFrames !== undefined) {
+        networkEntityPool.reuseWaitFrames = options.networkEntityReuseWaitFrames;
+    }
+    pools.push(networkEntityPool, { name: "entity", min: localEntityIdStart });
+    return pools;
+}
+function getLocalComponentMinFor(networkComponentCount) {
+    return nextPowerOfTwo(Math.max(2, networkComponentCount + 1));
+}
+function nextPowerOfTwo(value) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new Error("Network component count must be a positive safe integer");
+    }
+    let power = 1;
+    while (power < value) {
+        power *= 2;
+    }
+    return power;
+}
+function validateEntityStart(name, value) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new Error(`${name} must be a positive safe integer`);
+    }
+}
+//# sourceMappingURL=network_world.js.map

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

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

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

@@ -0,0 +1,36 @@
+import { Decoder, Encoder, type IEncodable } from "@vworlds/vecs-wire";
+export declare const RPC_RESPONSE_ID = 0;
+export declare const FIRST_USER_RPC_ID = 101;
+export declare class RPC implements IEncodable {
+    rpcId: number;
+    callId: number;
+    params: unknown[];
+    error: number;
+    message: string;
+    constructor(values?: Partial<RPC>);
+    wireEncode(encoder: Encoder): void;
+    static wireDecode(decoder: Decoder): RPC;
+}
+export type RPCHandler = (params: unknown[], request: RPC) => Promise<unknown[] | unknown> | unknown[] | unknown;
+export declare const RPC_TIMEOUT_ERROR: {
+    error: number;
+    message: string;
+};
+export declare class SessionRPC {
+    private readonly _defaultTTL;
+    private _nextCallId;
+    private readonly _pending;
+    private readonly _outbox;
+    private readonly _cachedReplies;
+    private readonly _handlers;
+    constructor(_defaultTTL?: number);
+    listen(rpcId: number, handler: RPCHandler): void;
+    invoke(rpcId: number, params?: unknown[], ttl?: number): Promise<RPC>;
+    process(messages: RPC[]): void;
+    private _processResponse;
+    private _processRequest;
+    private _queueResponse;
+    timeoutTick(elapsed: number): void;
+    get pendingTotal(): number;
+    getOutgoing(): RPC[];
+}

package/vecs-protocol/src/rpc.js

@@ -0,0 +1,140 @@
+export const RPC_RESPONSE_ID = 0;
+export const FIRST_USER_RPC_ID = 101;
+export class RPC {
+    constructor(values) {
+        this.rpcId = 0;
+        this.callId = 0;
+        this.params = [];
+        this.error = 0;
+        this.message = "";
+        if (values) {
+            Object.assign(this, values);
+        }
+    }
+    wireEncode(encoder) {
+        encoder.write_u32(this.rpcId);
+        encoder.write_u32(this.callId);
+        encoder.write_u32(this.error);
+        encoder.write_string(this.message);
+        encoder.write_u32(this.params.length);
+        this.params.forEach((param) => encoder.write_any(param));
+    }
+    static wireDecode(decoder) {
+        const rpc = new RPC({
+            rpcId: decoder.read_u32(),
+            callId: decoder.read_u32(),
+            error: decoder.read_u32(),
+            message: decoder.read_string(),
+        });
+        const count = decoder.read_u32();
+        for (let i = 0; i < count; i++) {
+            rpc.params.push(decoder.read_any());
+        }
+        return rpc;
+    }
+}
+export const RPC_TIMEOUT_ERROR = { error: -1, message: "Timeout" };
+export class SessionRPC {
+    constructor(_defaultTTL = 5000) {
+        this._defaultTTL = _defaultTTL;
+        this._nextCallId = 0;
+        this._pending = new Map();
+        this._outbox = new Map();
+        this._cachedReplies = new Map();
+        this._handlers = new Map();
+    }
+    listen(rpcId, handler) {
+        if (rpcId <= RPC_RESPONSE_ID) {
+            throw new Error("RPC handler ids must be positive request ids");
+        }
+        this._handlers.set(rpcId, handler);
+    }
+    invoke(rpcId, params = [], ttl = this._defaultTTL) {
+        if (rpcId < FIRST_USER_RPC_ID) {
+            throw new Error(`RPC ids 0-${FIRST_USER_RPC_ID - 1} are reserved`);
+        }
+        const callId = this._nextCallId++;
+        const request = new RPC({ rpcId, callId, params });
+        return new Promise((resolve, reject) => {
+            this._pending.set(callId, { request, resolve, reject, ttl });
+        });
+    }
+    process(messages) {
+        messages.forEach((message) => {
+            if (message.rpcId === RPC_RESPONSE_ID) {
+                this._processResponse(message);
+            }
+            else {
+                void this._processRequest(message);
+            }
+        });
+    }
+    _processResponse(message) {
+        const pending = this._pending.get(message.callId);
+        if (!pending) {
+            return;
+        }
+        this._pending.delete(message.callId);
+        if (message.error) {
+            pending.reject({ error: message.error, message: message.message });
+            return;
+        }
+        pending.resolve(message);
+    }
+    async _processRequest(message) {
+        const cached = this._cachedReplies.get(message.callId);
+        if (cached) {
+            this._outbox.set(message.callId, cached.response);
+            return;
+        }
+        const response = new RPC({ rpcId: RPC_RESPONSE_ID, callId: message.callId });
+        const handler = this._handlers.get(message.rpcId);
+        if (!handler) {
+            response.error = 1;
+            response.message = `Unknown RPC id ${message.rpcId}`;
+            this._queueResponse(response);
+            return;
+        }
+        try {
+            const result = await handler(message.params, message);
+            response.params = Array.isArray(result) ? result : result === undefined ? [] : [result];
+        }
+        catch (err) {
+            response.error =
+                typeof err?.error === "number"
+                    ? err.error
+                    : 1;
+            response.message = err instanceof Error ? err.message : String(err);
+        }
+        this._queueResponse(response);
+    }
+    _queueResponse(response) {
+        this._cachedReplies.set(response.callId, { response, ttl: this._defaultTTL });
+        this._outbox.set(response.callId, response);
+    }
+    timeoutTick(elapsed) {
+        this._pending.forEach((pending, callId) => {
+            pending.ttl -= elapsed;
+            if (pending.ttl <= 0) {
+                this._pending.delete(callId);
+                pending.reject(RPC_TIMEOUT_ERROR);
+            }
+        });
+        this._cachedReplies.forEach((reply, callId) => {
+            reply.ttl -= elapsed;
+            if (reply.ttl <= 0) {
+                this._cachedReplies.delete(callId);
+            }
+        });
+    }
+    get pendingTotal() {
+        return this._pending.size + this._outbox.size;
+    }
+    getOutgoing() {
+        const outgoing = [...this._pending.values()].map((pending) => pending.request);
+        outgoing.push(...this._outbox.values());
+        this._outbox.clear();
+        return outgoing;
+    }
+}
+//# sourceMappingURL=rpc.js.map

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

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

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

@@ -0,0 +1,21 @@
+export interface ConnectionError extends Error {
+    status: number;
+    statusText: string;
+}
+export interface VecsSocketEvents {
+    receive: (data: Uint8Array) => void;
+    disconnect: () => void;
+    connect: (err?: ConnectionError) => void;
+}
+export interface VecsSocket {
+    readonly id: string;
+    on<K extends keyof VecsSocketEvents>(event: K, handler: VecsSocketEvents[K]): unknown;
+    send(data: Uint8Array): void;
+    close(): void;
+}
+export interface VecsSocketListenerEvents {
+    new: (socket: VecsSocket) => void;
+}
+export interface VecsSocketListener {
+    on<K extends keyof VecsSocketListenerEvents>(event: K, handler: VecsSocketListenerEvents[K]): unknown;
+}

package/vecs-protocol/src/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../vecs-protocol/src/transport.ts"],"names":[],"mappings":""}

package/vecs-server/src/history.d.ts

@@ -0,0 +1,14 @@
+import { StateDiff } from "@vworlds/vecs-protocol";
+export declare const HISTORY_LENGTH = 5;
+export declare class History {
+    private readonly _length;
+    private readonly _buffer;
+    private _lastFrame;
+    constructor(_length?: number, lastFrame?: number);
+    get lastFrame(): number;
+    get oldestFrame(): number;
+    push(diff: StateDiff): void;
+    get(frame: number): StateDiff;
+    pull(from: number, to: number): StateDiff;
+    private _index;
+}

package/vecs-server/src/history.js

@@ -0,0 +1,104 @@
+import { ArrayMap } from "@vworlds/vecs";
+import { ALL_COMPONENTS, StateDiff, } from "@vworlds/vecs-protocol";
+export const HISTORY_LENGTH = 5;
+const REMOVED = 0;
+export class History {
+    constructor(_length = HISTORY_LENGTH, lastFrame = -1) {
+        this._length = _length;
+        this._lastFrame = lastFrame;
+        this._buffer = new Array(_length);
+        for (let i = 0; i < _length; i++) {
+            const toFrame = lastFrame - i;
+            this._buffer[this._index(toFrame)] = emptyDiff(toFrame);
+        }
+    }
+    get lastFrame() {
+        return this._lastFrame;
+    }
+    get oldestFrame() {
+        return this._lastFrame - this._length + 1;
+    }
+    push(diff) {
+        if (diff.toFrame !== this._lastFrame + 1) {
+            throw new Error(`Expected frame ${this._lastFrame + 1}, got ${diff.toFrame}`);
+        }
+        this._lastFrame = diff.toFrame;
+        this._buffer[this._index(diff.toFrame)] = diff;
+    }
+    get(frame) {
+        if (frame < this.oldestFrame || frame > this._lastFrame) {
+            throw new Error(`Frame ${frame} is outside history window`);
+        }
+        return this._buffer[this._index(frame)];
+    }
+    pull(from, to) {
+        if (to < from) {
+            throw new Error(`Invalid history range ${from}..${to}`);
+        }
+        if (to === from) {
+            return new StateDiff({ fromFrame: from, toFrame: to });
+        }
+        if (to === from + 1) {
+            return this.get(to);
+        }
+        const entities = new Map();
+        for (let frame = from + 1; frame <= to; frame++) {
+            applyDiff(entities, this.get(frame));
+        }
+        return forgeDiff(from, to, entities);
+    }
+    _index(frame) {
+        return ((frame % this._length) + this._length) % this._length;
+    }
+}
+function applyDiff(entities, diff) {
+    diff.snapshots.forEach((snapshot) => {
+        let entity = entities.get(snapshot.eid);
+        if (entity === undefined || entity === REMOVED) {
+            entity = new ArrayMap();
+            entities.set(snapshot.eid, entity);
+        }
+        entity.set(snapshot.type, snapshot);
+    });
+    diff.removed.forEach(([eid, type]) => {
+        if (type === ALL_COMPONENTS) {
+            entities.set(eid, REMOVED);
+            return;
+        }
+        const entity = entities.get(eid);
+        if (entity === REMOVED) {
+            return;
+        }
+        const components = entity ?? new ArrayMap();
+        components.set(type, REMOVED);
+        entities.set(eid, components);
+    });
+}
+function forgeDiff(from, to, entities) {
+    const snapshots = [];
+    const removed = [];
+    entities.forEach((entity, eid) => {
+        if (entity === REMOVED) {
+            removed.push([eid, ALL_COMPONENTS]);
+            return;
+        }
+        entity.forEach((slot, type) => {
+            if (slot === REMOVED) {
+                removed.push([eid, type]);
+            }
+            else {
+                snapshots.push(slot);
+            }
+        });
+    });
+    return new StateDiff({ fromFrame: from, toFrame: to, snapshots, removed });
+}
+function emptyDiff(toFrame) {
+    return new StateDiff({
+        fromFrame: toFrame - 1,
+        toFrame,
+        snapshots: [],
+        removed: [],
+    });
+}
+//# sourceMappingURL=history.js.map

package/vecs-server/src/history.js.map

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

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

@@ -0,0 +1,9 @@
+export { NetworkClient, NetworkInput, Networked } from "./networked.js";
+export { VecsListener } from "./vecs_listener.js";
+export type { VecsListenerOptions } from "./vecs_listener.js";
+export { ServerWorld } from "./server_world.js";
+export type { ServerWorldOptions } from "./server_world.js";
+export type { InstallSystemsOptions } from "./server_world.js";
+export { EntityTracker, TrackerCache, View } from "./view.js";
+export type { IEntityTracker, IEntityTrackerListener } from "./view.js";
+export { worldPath } from "./world_path.js";

package/vecs-server/src/index.js

@@ -0,0 +1,6 @@
+export { NetworkClient, NetworkInput, Networked } from "./networked.js";
+export { VecsListener } from "./vecs_listener.js";
+export { ServerWorld } from "./server_world.js";
+export { EntityTracker, TrackerCache, View } from "./view.js";
+export { worldPath } from "./world_path.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/vecs-server/src/networked.d.ts

@@ -0,0 +1,8 @@
+export declare class Networked {
+}
+export declare class NetworkClient {
+    id: string;
+}
+export declare class NetworkInput {
+    input: unknown;
+}

package/vecs-server/src/networked.js

@@ -0,0 +1,13 @@
+export class Networked {
+}
+export class NetworkClient {
+    constructor() {
+        this.id = "";
+    }
+}
+export class NetworkInput {
+    constructor() {
+        this.input = undefined;
+    }
+}
+//# sourceMappingURL=networked.js.map

package/vecs-server/src/networked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networked.js","sourceRoot":"","sources":["../../../src/networked.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAS;CAAG;AAEzB,MAAM,OAAO,aAAa;IAA1B;QACS,OAAE,GAAG,EAAE,CAAC;IACjB,CAAC;CAAA;AAED,MAAM,OAAO,YAAY;IAAzB;QACS,UAAK,GAAY,SAAS,CAAC;IACpC,CAAC;CAAA"}

package/vecs-server/src/server_world.d.ts

@@ -0,0 +1,34 @@
+import { NetworkWorld, type NetworkWorldOptions, type RPCHandler } from "@vworlds/vecs-protocol";
+import { type IPhase } from "@vworlds/vecs";
+export interface ServerWorldOptions extends NetworkWorldOptions {
+    name?: string;
+    encodeBufferSize?: number;
+}
+export interface InstallSystemsOptions {
+    collectPhase: string | IPhase;
+    sendPhase: string | IPhase;
+}
+export declare class ServerWorld extends NetworkWorld {
+    readonly name: string;
+    private readonly _components;
+    private readonly _sessions;
+    private readonly _rpcHandlers;
+    private readonly _updates;
+    private readonly _snapshotCache;
+    private readonly _trackerCache;
+    private readonly _encodeBuffer;
+    private _clients;
+    private _frame;
+    private _systemsInstalled;
+    constructor(options?: ServerWorldOptions);
+    handleRpc(rpcId: number, handler: RPCHandler): void;
+    installSystems(options: InstallSystemsOptions): void;
+    send(): void;
+    private _onNewConnection;
+    private _onDisconnect;
+    private _receive;
+    private _record;
+    private _pushEntitySnapshots;
+    private _encodeSnapshot;
+    private _encode;
+}