@replicast/core 0.1.2 → 1.0.0-rc.10

package/dist/entity/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/entity/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEzE,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CACnF;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAA;IAClC,gGAAgG;IAChG,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAChC,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAQD,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAA;AAE9D;;;;GAIG;AACH,qBAAa,oBAAoB;IAanB,OAAO,CAAC,OAAO;IAZ3B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,WAAW,CAA2D;IAC9E;wGACoG;IACpG,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,OAAO,CAAI;gBAEC,OAAO,EAAE,2BAA2B;IAqBxD,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;IAIrC,GAAG,IAAI,MAAM,EAAE;IAIf,iGAAiG;IACjG,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;IASzD,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,eAAe;IAIvB,+FAA+F;IAC/F,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAIxF,sFAAsF;IACtF,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAI1F,gGAAgG;IAChG,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAK3C,oEAAoE;IACpE,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAsCjC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAO7D,0FAA0F;IAC1F,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,MAAM;CASf"}

package/dist/entity/registry.js

@@ -0,0 +1,167 @@
+import { getEntityHooks, getEntityName } from '../decorators/entity.js';
+import { isEmptySync } from './types.js';
+/**
+ * The client's mirror of the entities it can currently see. Creates the same class on `enter`,
+ * applies `update` patches in place, and calls `@ClientSpawn` / `@ClientDespawn` as entities join
+ * and leave this viewer's set.
+ */
+export class ClientEntityRegistry {
+    options;
+    entities = new Map();
+    infoByName = new Map();
+    infoByCtor = new Map();
+    spawnListeners = new Map();
+    despawnListeners = new Map();
+    subscribers = new Set();
+    byTypeCache = new Map();
+    /** Per-type version, bumped only for types actually touched by a sync — keeps an update to one
+     *  type from invalidating every other type's `byType()` cache (and its `useEntities()` callers). */
+    typeVersions = new Map();
+    version = 0;
+    constructor(options) {
+        this.options = options;
+        for (const Type of options.types) {
+            const proto = Type.prototype;
+            const hooks = getEntityHooks(proto);
+            const name = getEntityName(Type);
+            const existing = this.infoByName.get(name);
+            if (existing && existing.Type !== Type) {
+                throw new Error(`[replicast] two @Entity classes are both named "${name}" — give one an explicit @Entity({ name }) option`);
+            }
+            const info = {
+                Type,
+                spawnHooks: Object.keys(hooks).filter(m => hooks[m] === 'clientSpawn'),
+                despawnHooks: Object.keys(hooks).filter(m => hooks[m] === 'clientDespawn'),
+            };
+            this.infoByName.set(name, info);
+            this.infoByCtor.set(Type, info);
+        }
+    }
+    get(id) {
+        return this.entities.get(id);
+    }
+    all() {
+        return [...this.entities.values()];
+    }
+    /** Entities of one type. The array is referentially stable until that type's entities change. */
+    byType(Type) {
+        const version = this.typeVersions.get(Type) ?? 0;
+        const cached = this.byTypeCache.get(Type);
+        if (cached?.version === version)
+            return cached.list;
+        const list = this.all().filter(e => e instanceof Type);
+        this.byTypeCache.set(Type, { version, list });
+        return list;
+    }
+    touchType(entity) {
+        const Type = Object.getPrototypeOf(entity).constructor;
+        this.typeVersions.set(Type, (this.typeVersions.get(Type) ?? 0) + 1);
+    }
+    hasAuthorityFor(entity) {
+        return entity['ownerId'] != null && entity['ownerId'] === this.options.getPlayerId();
+    }
+    /** Called when an entity of `Type` enters this viewer's set, after its fields are assigned. */
+    onSpawn(Type, listener) {
+        return addListener(this.spawnListeners, Type, listener);
+    }
+    /** Called when an entity of `Type` leaves this viewer's set, before it is dropped. */
+    onDespawn(Type, listener) {
+        return addListener(this.despawnListeners, Type, listener);
+    }
+    /** Fires once per applied sync, after the whole batch is in place. For game loops and React. */
+    subscribe(listener) {
+        this.subscribers.add(listener);
+        return () => { this.subscribers.delete(listener); };
+    }
+    /** Applies one `{ enter, update, leave }` delta from the server. */
+    applySync(sync) {
+        if (isEmptySync(sync))
+            return;
+        for (const { type, id, fields } of sync.enter) {
+            const info = this.infoByName.get(type);
+            if (!info) {
+                console.warn(`[replicast] received an unknown entity type "${type}" — register it in createApp({ entities })`);
+                continue;
+            }
+            const entity = new info.Type();
+            entity['id'] = id;
+            entity['isServer'] = false;
+            if (this.options.client)
+                entity['__wsClient'] = this.options.client;
+            Object.assign(entity, fields);
+            entity['hasAuthority'] = this.hasAuthorityFor(entity);
+            this.entities.set(id, entity);
+            this.touchType(entity);
+            callHooks(entity, info.spawnHooks);
+            notify(this.spawnListeners, entity);
+        }
+        for (const { id, fields } of sync.update) {
+            const entity = this.entities.get(id);
+            if (entity) {
+                Object.assign(entity, fields);
+                // ownerId is a replicated built-in and can change on an already-mirrored entity
+                // (e.g. a ship changes hands) — hasAuthority must track it, not just the initial enter.
+                entity['hasAuthority'] = this.hasAuthorityFor(entity);
+                this.touchType(entity);
+            }
+        }
+        for (const id of sync.leave)
+            this.remove(id);
+        this.version++;
+        for (const listener of this.subscribers)
+            listener();
+    }
+    /** Dispatches a server-pushed `@Client` / `@Multicast` call onto the mirrored entity. */
+    applyRpc(id, method, args) {
+        const entity = this.entities.get(id);
+        const methodName = method.split('.')[1];
+        if (!entity || !methodName || typeof entity[methodName] !== 'function')
+            return;
+        entity[methodName].apply(entity, args);
+    }
+    /** Despawns every mirror — used when the connection drops so a reconnect starts clean. */
+    clear() {
+        if (this.entities.size === 0)
+            return;
+        for (const id of [...this.entities.keys()])
+            this.remove(id);
+        this.version++;
+        for (const listener of this.subscribers)
+            listener();
+    }
+    remove(id) {
+        const entity = this.entities.get(id);
+        if (!entity)
+            return;
+        const info = this.infoByCtor.get(Object.getPrototypeOf(entity).constructor);
+        callHooks(entity, info?.despawnHooks ?? []);
+        this.entities.delete(id);
+        this.touchType(entity);
+        notify(this.despawnListeners, entity);
+    }
+}
+function addListener(map, Type, listener) {
+    let set = map.get(Type);
+    if (!set) {
+        set = new Set();
+        map.set(Type, set);
+    }
+    set.add(listener);
+    return () => { set.delete(listener); };
+}
+function notify(map, entity) {
+    for (const [Type, listeners] of map) {
+        if (!(entity instanceof Type))
+            continue;
+        for (const listener of listeners)
+            listener(entity);
+    }
+}
+function callHooks(entity, methods) {
+    for (const method of methods) {
+        const fn = entity[method];
+        if (typeof fn === 'function')
+            fn.call(entity);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/entity/registry.js.map

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

package/dist/entity/replicator.d.ts

@@ -0,0 +1,40 @@
+import type { FieldPlan } from './fields.js';
+import type { VisibleTo } from './visibility.js';
+import type { EntityId, EntitySync, EntityWorldView } from './types.js';
+/** One live entity as the replicator needs to see it: identity, wire type, field plan, scoping. */
+export interface ReplicationEntry {
+    id: EntityId;
+    entity: object;
+    type: string;
+    plan: FieldPlan;
+    visibleTo?: VisibleTo;
+}
+/**
+ * Tracks, per client, which entities that client has been sent and the fields it last saw, and turns
+ * the current world into that client's `{ enter, update, leave }` delta.
+ *
+ * Cost is O(clients x entities) per flush — deliberate for now; a spatial index hook comes later.
+ */
+export declare class EntityReplicator {
+    /** playerId → entityId → last-sent field snapshot. */
+    private views;
+    /** True when `playerId` currently has `id` in their set (i.e. as of the last flush). */
+    hasInView(playerId: string, id: EntityId): boolean;
+    /** The clients that currently see `id` — the audience for a `@Multicast`. */
+    viewersOf(id: EntityId): string[];
+    /** Forget a disconnected client so they re-enter from scratch on reconnect. */
+    dropViewer(playerId: string): void;
+    /**
+     * Records `id` as already sent to `playerId` with `fields`, without waiting for the next flush —
+     * for a caller that must guarantee delivery order (an `@Client`/`@Multicast` send that needs the
+     * recipient's mirror to exist before the rpc arrives). The next real `flush()` then sees this id
+     * already in `view` and sends only a diff, never a duplicate `enter`.
+     */
+    recordEnter(playerId: string, id: EntityId, fields: Record<string, unknown>): void;
+    /**
+     * Builds one client's delta and records it as sent. An entity is visible when the client owns it
+     * (owners always see their own entities) or the type's `visibleTo` hook allows it.
+     */
+    computeSync(playerId: string, entries: Iterable<ReplicationEntry>, world: EntityWorldView): EntitySync;
+}
+//# sourceMappingURL=replicator.d.ts.map

package/dist/entity/replicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicator.d.ts","sourceRoot":"","sources":["../../src/entity/replicator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEvE,mGAAmG;AACnG,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,sDAAsD;IACtD,OAAO,CAAC,KAAK,CAA4D;IAEzE,wFAAwF;IACxF,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO;IAIlD,6EAA6E;IAC7E,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE;IAQjC,+EAA+E;IAC/E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMlF;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,UAAU;CAmCvG"}

package/dist/entity/replicator.js

@@ -0,0 +1,82 @@
+import { snapshotFields, diffFields, ownerIdField } from './fields.js';
+import { isEntityVisible } from './visibility.js';
+/**
+ * Tracks, per client, which entities that client has been sent and the fields it last saw, and turns
+ * the current world into that client's `{ enter, update, leave }` delta.
+ *
+ * Cost is O(clients x entities) per flush — deliberate for now; a spatial index hook comes later.
+ */
+export class EntityReplicator {
+    /** playerId → entityId → last-sent field snapshot. */
+    views = new Map();
+    /** True when `playerId` currently has `id` in their set (i.e. as of the last flush). */
+    hasInView(playerId, id) {
+        return this.views.get(playerId)?.has(id) ?? false;
+    }
+    /** The clients that currently see `id` — the audience for a `@Multicast`. */
+    viewersOf(id) {
+        const viewers = [];
+        for (const [playerId, view] of this.views) {
+            if (view.has(id))
+                viewers.push(playerId);
+        }
+        return viewers;
+    }
+    /** Forget a disconnected client so they re-enter from scratch on reconnect. */
+    dropViewer(playerId) {
+        this.views.delete(playerId);
+    }
+    /**
+     * Records `id` as already sent to `playerId` with `fields`, without waiting for the next flush —
+     * for a caller that must guarantee delivery order (an `@Client`/`@Multicast` send that needs the
+     * recipient's mirror to exist before the rpc arrives). The next real `flush()` then sees this id
+     * already in `view` and sends only a diff, never a duplicate `enter`.
+     */
+    recordEnter(playerId, id, fields) {
+        let view = this.views.get(playerId);
+        if (!view) {
+            view = new Map();
+            this.views.set(playerId, view);
+        }
+        view.set(id, fields);
+    }
+    /**
+     * Builds one client's delta and records it as sent. An entity is visible when the client owns it
+     * (owners always see their own entities) or the type's `visibleTo` hook allows it.
+     */
+    computeSync(playerId, entries, world) {
+        let view = this.views.get(playerId);
+        if (!view) {
+            view = new Map();
+            this.views.set(playerId, view);
+        }
+        const sync = { enter: [], update: [], leave: [] };
+        const stillVisible = new Set();
+        for (const { id, entity, type, plan, visibleTo } of entries) {
+            const isOwner = entity[ownerIdField] === playerId;
+            if (!isEntityVisible(isOwner, playerId, entity, visibleTo, world))
+                continue;
+            stillVisible.add(id);
+            const fields = snapshotFields(entity, plan, isOwner);
+            const previous = view.get(id);
+            if (previous === undefined) {
+                sync.enter.push({ type, id, fields });
+                view.set(id, fields);
+                continue;
+            }
+            const patch = diffFields(previous, fields);
+            if (Object.keys(patch).length > 0) {
+                sync.update.push({ id, fields: patch });
+                view.set(id, fields);
+            }
+        }
+        for (const id of view.keys()) {
+            if (!stillVisible.has(id)) {
+                sync.leave.push(id);
+                view.delete(id);
+            }
+        }
+        return sync;
+    }
+}
+//# sourceMappingURL=replicator.js.map

package/dist/entity/replicator.js.map

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

package/dist/entity/types.d.ts

@@ -0,0 +1,29 @@
+/** Server-assigned entity id. Numeric so it stays compact on the msgpack wire. */
+export type EntityId = number;
+/** Any class usable as a replicated entity type: it must be constructible with no arguments. */
+export type EntityConstructor<T extends object = object> = new () => T;
+/** Read-only view of the server world handed to `visibleTo` / `canCall` hooks. */
+export interface EntityWorldView {
+    get(id: EntityId): object | undefined;
+    byType<T extends object>(Type: EntityConstructor<T>): T[];
+    all(): object[];
+}
+/** One entity entering a client's view: the full replicated field set for that client. */
+export interface EntityEnter {
+    type: string;
+    id: EntityId;
+    fields: Record<string, unknown>;
+}
+/** One entity already in view whose replicated fields changed. */
+export interface EntityUpdate {
+    id: EntityId;
+    fields: Record<string, unknown>;
+}
+/** A single client's per-flush entity delta. */
+export interface EntitySync {
+    enter: EntityEnter[];
+    update: EntityUpdate[];
+    leave: EntityId[];
+}
+export declare function isEmptySync(sync: EntitySync): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/entity/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/entity/types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE7B,gGAAgG;AAChG,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,UAAU,CAAC,CAAA;AAEtE,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;IACrC,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA;IACzD,GAAG,IAAI,MAAM,EAAE,CAAA;CAChB;AAED,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,QAAQ,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAErD"}

package/dist/entity/types.js

@@ -0,0 +1,4 @@
+export function isEmptySync(sync) {
+    return sync.enter.length === 0 && sync.update.length === 0 && sync.leave.length === 0;
+}
+//# sourceMappingURL=types.js.map

package/dist/entity/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/entity/types.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAA;AACvF,CAAC"}

package/dist/entity/visibility.d.ts

@@ -0,0 +1,11 @@
+import type { EntityWorldView } from './types.js';
+/** Scopes replication and RPC visibility for an `@Entity` type. Default (undefined): visible to everyone. */
+export type VisibleTo = (viewerId: string, entity: object, world: EntityWorldView) => boolean;
+/**
+ * Whether `viewerId` can see `entity`: an owner always can; everyone else defers to `visibleTo`
+ * (no hook means visible to everyone). Shared by replication (who gets `enter`/`update`) and by
+ * `@Server` RPC authorisation (`EntityWorld.invoke`), so a caller can never act on an entity the
+ * server would not otherwise show them.
+ */
+export declare function isEntityVisible(isOwner: boolean, viewerId: string, entity: object, visibleTo: VisibleTo | undefined, world: EntityWorldView): boolean;
+//# sourceMappingURL=visibility.d.ts.map

package/dist/entity/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/entity/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,6GAA6G;AAC7G,MAAM,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAA;AAE7F;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,KAAK,EAAE,eAAe,GACrB,OAAO,CAET"}

package/dist/entity/visibility.js

@@ -0,0 +1,10 @@
+/**
+ * Whether `viewerId` can see `entity`: an owner always can; everyone else defers to `visibleTo`
+ * (no hook means visible to everyone). Shared by replication (who gets `enter`/`update`) and by
+ * `@Server` RPC authorisation (`EntityWorld.invoke`), so a caller can never act on an entity the
+ * server would not otherwise show them.
+ */
+export function isEntityVisible(isOwner, viewerId, entity, visibleTo, world) {
+    return isOwner || !visibleTo || visibleTo(viewerId, entity, world);
+}
+//# sourceMappingURL=visibility.js.map

package/dist/entity/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../src/entity/visibility.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,QAAgB,EAChB,MAAc,EACd,SAAgC,EAChC,KAAsB;IAEtB,OAAO,OAAO,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;AACpE,CAAC"}

package/dist/entity/world.d.ts

@@ -0,0 +1,67 @@
+import type { EntityConstructor, EntityId, EntitySync, EntityWorldView } from './types.js';
+/** How the world reaches connected clients. Injected so the world stays testable without sockets. */
+export interface EntityTransport {
+    /** Push one entity-scoped `@Client` / `@Multicast` call to a client. */
+    sendRpc(playerId: string, id: EntityId, method: string, args: unknown[]): void;
+    /** Push one client their `{ enter, update, leave }` delta. */
+    sendSync(playerId: string, sync: EntitySync): void;
+    /** The currently connected players. */
+    players(): string[];
+}
+export interface EntityWorldOptions {
+    /** Entity classes registered up front (also auto-registered lazily on first spawn). */
+    types?: EntityConstructor<object>[];
+    transport?: EntityTransport;
+}
+/**
+ * Server-side entity registry: spawns entities, runs their `@ServerTick`, authorises their
+ * `@Server` calls, and flushes each client's interest-scoped delta.
+ */
+export declare class EntityWorld implements EntityWorldView {
+    private entities;
+    private infoByCtor;
+    private replicator;
+    private transport;
+    private nextId;
+    constructor(options?: EntityWorldOptions);
+    private register;
+    private infoOf;
+    /** Registers an entity, assigns its id and owner, and wires its server → client dispatch. */
+    spawn<T extends object>(entity: T, options?: {
+        ownerId?: string | null;
+    }): T;
+    despawn(id: EntityId): void;
+    get(id: EntityId): object | undefined;
+    byType<T extends object>(Type: EntityConstructor<T>): T[];
+    all(): object[];
+    /** Forget a disconnected client's view so they re-enter from scratch on reconnect. */
+    dropViewer(playerId: string): void;
+    /** Runs every entity's `@ServerTick` methods. Called by the server's fixed-step scheduler. */
+    tick(dt: number): void;
+    /** Computes and sends every connected client's delta. Called at the replication rate. */
+    flush(): void;
+    private replicationEntries;
+    /**
+     * Runs a client-initiated `@Server` call on one entity after checking the caller is allowed.
+     * Rejects on an unknown entity, a method that is not `@Server` on that type, an entity the caller
+     * cannot see, or a failed `canCall` — `canCall` alone would otherwise let a `canCall: 'anyone'`
+     * entity be driven by a client the `visibleTo` hook was written to hide it from entirely.
+     */
+    invoke(callerId: string, id: EntityId, method: string, args: unknown[]): Promise<unknown>;
+    private canCall;
+    /**
+     * Replaces `@Client` / `@Multicast` methods on this instance with sends, so the server stays
+     * independent of the Vite transform (plain tsx/node works) and tick code can call them directly.
+     *
+     * Both recompute visibility live against `this.transport.players()` rather than asking the
+     * replicator who was already sent an `enter` for this id, because `flush()` runs on its own timer:
+     * an entity spawned and called on within the same tick would otherwise have no recorded viewers yet
+     * and the rpc would reach nobody. That alone isn't sufficient though — a recipient who is newly
+     * visible but has not yet had a flush also has no client-side mirror to run the rpc against, so
+     * `sendToRecipient` first catches that one recipient up with a synthetic `enter` (recorded into the
+     * replicator so the next real flush sends a diff, not a duplicate enter) before sending the rpc, to
+     * guarantee enter-before-rpc per `(player, entity)`.
+     */
+    private bindClientDispatch;
+}
+//# sourceMappingURL=world.d.ts.map

package/dist/entity/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../src/entity/world.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE1F,qGAAqG;AACrG,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9E,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IAClD,uCAAuC;IACvC,OAAO,IAAI,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,KAAK,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAA;IACnC,SAAS,CAAC,EAAE,eAAe,CAAA;CAC5B;AAeD;;;GAGG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAI;gBAEN,OAAO,GAAE,kBAAuB;IAK5C,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,MAAM;IAId,6FAA6F;IAC7F,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAO,GAAG,CAAC;IAahF,OAAO,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI;IAI3B,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;IAIrC,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;IAQzD,GAAG,IAAI,MAAM,EAAE;IAIf,sFAAsF;IACtF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC,8FAA8F;IAC9F,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQtB,yFAAyF;IACzF,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,kBAAkB;IAS1B;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB/F,OAAO,CAAC,OAAO;IAOf;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;CA2B3B"}

package/dist/entity/world.js

@@ -0,0 +1,183 @@
+import { getMethodRoles } from '../decorators/metadata.js';
+import { getEntityHooks, getEntityName, getEntityOptions, isEntityClass } from '../decorators/entity.js';
+import { fieldPlanOf, ownerIdField, snapshotFields } from './fields.js';
+import { EntityReplicator } from './replicator.js';
+import { isEntityVisible } from './visibility.js';
+import { isEmptySync } from './types.js';
+const noopTransport = {
+    sendRpc() { }, sendSync() { }, players: () => [],
+};
+/**
+ * Server-side entity registry: spawns entities, runs their `@ServerTick`, authorises their
+ * `@Server` calls, and flushes each client's interest-scoped delta.
+ */
+export class EntityWorld {
+    entities = new Map();
+    infoByCtor = new Map();
+    replicator = new EntityReplicator();
+    transport;
+    nextId = 1;
+    constructor(options = {}) {
+        this.transport = options.transport ?? noopTransport;
+        for (const Type of options.types ?? [])
+            this.register(Type);
+    }
+    register(Type) {
+        const existing = this.infoByCtor.get(Type);
+        if (existing)
+            return existing;
+        if (!isEntityClass(Type)) {
+            throw new Error(`${Type.name || 'class'} is not decorated with @Entity`);
+        }
+        const proto = Type.prototype;
+        const hooks = getEntityHooks(proto);
+        const roles = getMethodRoles(proto);
+        const info = {
+            name: getEntityName(Type),
+            plan: fieldPlanOf(Type),
+            options: getEntityOptions(Type) ?? {},
+            serverTicks: Object.keys(hooks).filter(m => hooks[m] === 'serverTick'),
+            clientMethods: Object.fromEntries(Object.entries(roles).filter(([, r]) => r === 'client' || r === 'multicast')),
+            serverMethods: new Set(Object.keys(roles).filter(m => roles[m] === 'server')),
+        };
+        this.infoByCtor.set(Type, info);
+        return info;
+    }
+    infoOf(entity) {
+        return this.register(Object.getPrototypeOf(entity).constructor);
+    }
+    /** Registers an entity, assigns its id and owner, and wires its server → client dispatch. */
+    spawn(entity, options = {}) {
+        const info = this.infoOf(entity);
+        const id = this.nextId++;
+        const target = entity;
+        target['id'] = id;
+        target['ownerId'] = options.ownerId ?? null;
+        target['isServer'] = true;
+        target['hasAuthority'] = true;
+        this.entities.set(id, entity);
+        this.bindClientDispatch(entity, id, info);
+        return entity;
+    }
+    despawn(id) {
+        this.entities.delete(id);
+    }
+    get(id) {
+        return this.entities.get(id);
+    }
+    byType(Type) {
+        const out = [];
+        for (const entity of this.entities.values()) {
+            if (entity instanceof Type)
+                out.push(entity);
+        }
+        return out;
+    }
+    all() {
+        return [...this.entities.values()];
+    }
+    /** Forget a disconnected client's view so they re-enter from scratch on reconnect. */
+    dropViewer(playerId) {
+        this.replicator.dropViewer(playerId);
+    }
+    /** Runs every entity's `@ServerTick` methods. Called by the server's fixed-step scheduler. */
+    tick(dt) {
+        for (const entity of [...this.entities.values()]) {
+            for (const method of this.infoOf(entity).serverTicks) {
+                entity[method].call(entity, dt);
+            }
+        }
+    }
+    /** Computes and sends every connected client's delta. Called at the replication rate. */
+    flush() {
+        const entries = this.replicationEntries();
+        for (const playerId of this.transport.players()) {
+            const sync = this.replicator.computeSync(playerId, entries, this);
+            if (!isEmptySync(sync))
+                this.transport.sendSync(playerId, sync);
+        }
+    }
+    replicationEntries() {
+        const entries = [];
+        for (const [id, entity] of this.entities) {
+            const info = this.infoOf(entity);
+            entries.push({ id, entity, type: info.name, plan: info.plan, visibleTo: info.options.visibleTo });
+        }
+        return entries;
+    }
+    /**
+     * Runs a client-initiated `@Server` call on one entity after checking the caller is allowed.
+     * Rejects on an unknown entity, a method that is not `@Server` on that type, an entity the caller
+     * cannot see, or a failed `canCall` — `canCall` alone would otherwise let a `canCall: 'anyone'`
+     * entity be driven by a client the `visibleTo` hook was written to hide it from entirely.
+     */
+    async invoke(callerId, id, method, args) {
+        const entity = this.entities.get(id);
+        if (!entity)
+            throw new Error(`Unknown entity ${id}`);
+        const info = this.infoOf(entity);
+        const [typeName, methodName] = method.split('.');
+        if (typeName !== info.name || !methodName || !info.serverMethods.has(methodName)) {
+            throw new Error(`Unknown entity method: ${method}`);
+        }
+        const isOwner = entity[ownerIdField] === callerId;
+        if (!isEntityVisible(isOwner, callerId, entity, info.options.visibleTo, this)) {
+            // Same message as a missing id: a caller with no visibility shouldn't learn the entity exists.
+            throw new Error(`Unknown entity ${id}`);
+        }
+        if (!this.canCall(callerId, entity, info)) {
+            throw new Error(`Not allowed: ${method}`);
+        }
+        return entity[methodName].apply(entity, args);
+    }
+    canCall(callerId, entity, info) {
+        const rule = info.options.canCall ?? 'owner';
+        if (rule === 'anyone')
+            return true;
+        if (rule === 'owner')
+            return entity['ownerId'] === callerId;
+        return rule(callerId, entity, this);
+    }
+    /**
+     * Replaces `@Client` / `@Multicast` methods on this instance with sends, so the server stays
+     * independent of the Vite transform (plain tsx/node works) and tick code can call them directly.
+     *
+     * Both recompute visibility live against `this.transport.players()` rather than asking the
+     * replicator who was already sent an `enter` for this id, because `flush()` runs on its own timer:
+     * an entity spawned and called on within the same tick would otherwise have no recorded viewers yet
+     * and the rpc would reach nobody. That alone isn't sufficient though — a recipient who is newly
+     * visible but has not yet had a flush also has no client-side mirror to run the rpc against, so
+     * `sendToRecipient` first catches that one recipient up with a synthetic `enter` (recorded into the
+     * replicator so the next real flush sends a diff, not a duplicate enter) before sending the rpc, to
+     * guarantee enter-before-rpc per `(player, entity)`.
+     */
+    bindClientDispatch(entity, id, info) {
+        const sendToRecipient = (playerId, isOwner, key, args) => {
+            if (!this.replicator.hasInView(playerId, id)) {
+                const fields = snapshotFields(entity, info.plan, isOwner);
+                this.replicator.recordEnter(playerId, id, fields);
+                this.transport.sendSync(playerId, { enter: [{ type: info.name, id, fields }], update: [], leave: [] });
+            }
+            this.transport.sendRpc(playerId, id, key, args);
+        };
+        for (const [methodName, role] of Object.entries(info.clientMethods)) {
+            const key = `${info.name}.${methodName}`;
+            const send = role === 'client'
+                ? (...args) => {
+                    const ownerId = entity['ownerId'];
+                    if (typeof ownerId === 'string')
+                        sendToRecipient(ownerId, true, key, args);
+                }
+                : (...args) => {
+                    for (const playerId of this.transport.players()) {
+                        const isOwner = entity[ownerIdField] === playerId;
+                        if (isEntityVisible(isOwner, playerId, entity, info.options.visibleTo, this)) {
+                            sendToRecipient(playerId, isOwner, key, args);
+                        }
+                    }
+                };
+            Object.defineProperty(entity, methodName, { value: send, configurable: true, writable: true });
+        }
+    }
+}
+//# sourceMappingURL=world.js.map