@dcl/hammurabi-server 1.0.0-17268386187.commit-b609629

package/dist/lib/decentraland/communications/player-entity-manager.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.playerEntityManager = exports.PlayerEntityManager = exports.EntityUtils = void 0;
+// Entity utilities for bit-packed entity numbers and versions
+const MAX_U16 = 0xffff;
+const MASK_UPPER_16_ON_32 = 0xffff0000;
+var EntityUtils;
+(function (EntityUtils) {
+    function fromEntityId(entityId) {
+        return [(entityId & MAX_U16) >>> 0, (((entityId & MASK_UPPER_16_ON_32) >> 16) & MAX_U16) >>> 0];
+    }
+    EntityUtils.fromEntityId = fromEntityId;
+    function toEntityId(entityNumber, entityVersion) {
+        return (((entityNumber & MAX_U16) | ((entityVersion & MAX_U16) << 16)) >>> 0);
+    }
+    EntityUtils.toEntityId = toEntityId;
+})(EntityUtils = exports.EntityUtils || (exports.EntityUtils = {}));
+// Based on Unity's SpecialEntitiesID constants
+const PLAYER_ENTITY = 1;
+const OTHER_PLAYER_ENTITIES_FROM = 32;
+const OTHER_PLAYER_ENTITIES_TO = 256;
+class PlayerEntityManager {
+    constructor() {
+        // Set of allocated entities for efficient checking
+        this.allocatedEntities = new Set();
+        // Map from player address to entity ID
+        this.addressToEntityMap = new Map();
+        // Map from entity ID to player address
+        this.entityToAddressMap = new Map();
+        // Track entity versions for reuse (entity number -> highest version)
+        this.entityVersions = new Map();
+        // Next available entity number to allocate
+        this.nextEntityNumber = OTHER_PLAYER_ENTITIES_FROM;
+    }
+    /**
+     * Allocates a reserved entity ID for a player address.
+     * Returns the local player entity (1) for the local player, or a versioned entity (32-255) for remote players.
+     */
+    allocateEntityForPlayer(address, isLocalPlayer = false) {
+        // Normalize address to lowercase to match Unity behavior
+        const normalizedAddress = address.toLowerCase();
+        // Return existing entity if already allocated
+        if (this.addressToEntityMap.has(normalizedAddress)) {
+            return this.addressToEntityMap.get(normalizedAddress);
+        }
+        let entityId;
+        if (isLocalPlayer) {
+            entityId = PLAYER_ENTITY;
+            this.addressToEntityMap.set(normalizedAddress, entityId);
+            this.entityToAddressMap.set(entityId, normalizedAddress);
+            console.log(`Allocated local player entity ${entityId} for ${normalizedAddress}`);
+            return entityId;
+        }
+        // For remote players, try to reuse an entity with incremented version first
+        for (const [entityNumber, currentVersion] of this.entityVersions) {
+            if (entityNumber >= OTHER_PLAYER_ENTITIES_FROM && entityNumber < OTHER_PLAYER_ENTITIES_TO) {
+                if (currentVersion < MAX_U16) {
+                    const newEntity = EntityUtils.toEntityId(entityNumber, currentVersion + 1);
+                    if (!this.allocatedEntities.has(newEntity)) {
+                        this.entityVersions.set(entityNumber, currentVersion + 1);
+                        this.allocatedEntities.add(newEntity);
+                        this.addressToEntityMap.set(normalizedAddress, newEntity);
+                        this.entityToAddressMap.set(newEntity, normalizedAddress);
+                        console.log(`Reused entity ${entityNumber} version ${currentVersion + 1} (id: ${newEntity}) for ${normalizedAddress}`);
+                        return newEntity;
+                    }
+                }
+            }
+        }
+        // Allocate new entity number if no reusable entities available
+        if (this.nextEntityNumber < OTHER_PLAYER_ENTITIES_TO) {
+            const entityNumber = this.nextEntityNumber++;
+            const entityVersion = 0;
+            const newEntity = EntityUtils.toEntityId(entityNumber, entityVersion);
+            this.entityVersions.set(entityNumber, entityVersion);
+            this.allocatedEntities.add(newEntity);
+            this.addressToEntityMap.set(normalizedAddress, newEntity);
+            this.entityToAddressMap.set(newEntity, normalizedAddress);
+            return newEntity;
+        }
+        console.warn('No available entity slots for remote players');
+        return null;
+    }
+    /**
+     * Frees the entity allocated to a player address
+     */
+    freeEntityForPlayer(address) {
+        const normalizedAddress = address.toLowerCase();
+        const entityId = this.addressToEntityMap.get(normalizedAddress);
+        if (entityId !== undefined) {
+            // Don't free the local player entity, just clear mappings
+            if (entityId === PLAYER_ENTITY) {
+                this.addressToEntityMap.delete(normalizedAddress);
+                this.entityToAddressMap.delete(entityId);
+                console.log(`Cleared local player entity ${entityId} for ${normalizedAddress}`);
+                return;
+            }
+            // For remote player entities, remove from allocated set but keep version info
+            const [entityNumber] = EntityUtils.fromEntityId(entityId);
+            if (entityNumber >= OTHER_PLAYER_ENTITIES_FROM && entityNumber < OTHER_PLAYER_ENTITIES_TO) {
+                this.allocatedEntities.delete(entityId);
+                // Keep entityVersions entry for potential reuse with incremented version
+            }
+            this.addressToEntityMap.delete(normalizedAddress);
+            this.entityToAddressMap.delete(entityId);
+        }
+    }
+    /**
+     * Gets the player address for a given entity ID
+     */
+    getAddressForEntity(entityId) {
+        return this.entityToAddressMap.get(entityId) || null;
+    }
+    /**
+     * Gets the entity ID for a given player address
+     */
+    getEntityForAddress(address) {
+        const normalizedAddress = address.toLowerCase();
+        return this.addressToEntityMap.get(normalizedAddress) || null;
+    }
+    /**
+     * Checks if an entity ID is a reserved player entity
+     */
+    isPlayerEntity(entityId) {
+        if (entityId === PLAYER_ENTITY)
+            return true;
+        const [entityNumber] = EntityUtils.fromEntityId(entityId);
+        return entityNumber >= OTHER_PLAYER_ENTITIES_FROM && entityNumber < OTHER_PLAYER_ENTITIES_TO;
+    }
+    /**
+     * Gets all allocated player entities
+     */
+    getAllPlayerEntities() {
+        return new Map(this.entityToAddressMap);
+    }
+    /**
+     * Gets entity state information for debugging
+     */
+    getEntityInfo(entityId) {
+        const [number, version] = EntityUtils.fromEntityId(entityId);
+        return {
+            number,
+            version,
+            allocated: this.allocatedEntities.has(entityId)
+        };
+    }
+    /**
+     * Clears all reserved entities (for cleanup)
+     */
+    clear() {
+        this.allocatedEntities.clear();
+        this.addressToEntityMap.clear();
+        this.entityToAddressMap.clear();
+        this.entityVersions.clear();
+        this.nextEntityNumber = OTHER_PLAYER_ENTITIES_FROM;
+    }
+    /**
+     * Gets all allocated entities
+     */
+    getAllocatedEntities() {
+        return new Set(this.allocatedEntities);
+    }
+}
+exports.PlayerEntityManager = PlayerEntityManager;
+// Singleton instance for global use
+exports.playerEntityManager = new PlayerEntityManager();
+//# sourceMappingURL=player-entity-manager.js.map

package/dist/lib/decentraland/communications/player-entity-manager.js.map

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

package/dist/lib/decentraland/communications/position-report-system.d.ts

@@ -0,0 +1,8 @@
+import { CommsTransportWrapper } from "./CommsTransportWrapper";
+import { Quaternion, TransformNode, Vector3 } from "@babylonjs/core";
+import { DecentralandSystem } from "../system";
+export type ReportPositionSystem = DecentralandSystem & {
+    reportPosition(position: Vector3, rotation: Quaternion, forcePosition: boolean): void;
+};
+export declare function createCommunicationsPositionReportSystem(transports: () => Iterable<CommsTransportWrapper>, playerEntity: TransformNode): ReportPositionSystem;
+//# sourceMappingURL=position-report-system.d.ts.map

package/dist/lib/decentraland/communications/position-report-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-report-system.d.ts","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/position-report-system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAwB,MAAM,yBAAyB,CAAA;AACrF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAG9C,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,GAAG;IACtD,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;CACtF,CAAA;AAGD,wBAAgB,wCAAwC,CAAC,UAAU,EAAE,MAAM,QAAQ,CAAC,qBAAqB,CAAC,EAAE,YAAY,EAAE,aAAa,GAAG,oBAAoB,CAgD7J"}

package/dist/lib/decentraland/communications/position-report-system.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCommunicationsPositionReportSystem = void 0;
+const CommsTransportWrapper_1 = require("./CommsTransportWrapper");
+const core_1 = require("@babylonjs/core");
+const static_entities_1 = require("../../babylon/scene/logic/static-entities");
+// this function generates a delegate that filters by time and limits position reports to 10Hz
+function createCommunicationsPositionReportSystem(transports, playerEntity) {
+    // force max of 10Hz
+    const MAX_POSITIONS_PER_SECOND = 10;
+    let globalPositionIndex = 0;
+    let lastReport = performance.now();
+    function shouldDiscard() {
+        const now = performance.now();
+        if ((now - lastReport) < (1000 / MAX_POSITIONS_PER_SECOND)) {
+            return true;
+        }
+        lastReport = now;
+        return false;
+    }
+    function reportPosition(position, rotation, forcePosition) {
+        globalPositionIndex++;
+        if (!forcePosition && shouldDiscard())
+            return;
+        const positionReport = {
+            index: globalPositionIndex,
+            positionX: position.x,
+            positionY: position.y,
+            positionZ: position.z,
+            rotationX: rotation.x,
+            rotationY: rotation.y,
+            rotationZ: rotation.z,
+            rotationW: rotation.w,
+            // timestamp: performance.now()
+        };
+        for (const it of transports()) {
+            if (it.state === CommsTransportWrapper_1.RoomConnectionStatus.CONNECTED) {
+                it.sendPositionMessage(positionReport);
+            }
+        }
+    }
+    return {
+        update() {
+            // report the position of the first person camera to all transports
+            reportPosition(playerEntity.absolutePosition.subtract(new core_1.Vector3(0, static_entities_1.PLAYER_HEIGHT, 0)), playerEntity.absoluteRotationQuaternion, false);
+        },
+        reportPosition
+    };
+}
+exports.createCommunicationsPositionReportSystem = createCommunicationsPositionReportSystem;
+//# sourceMappingURL=position-report-system.js.map

package/dist/lib/decentraland/communications/position-report-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-report-system.js","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/position-report-system.ts"],"names":[],"mappings":";;;AACA,mEAAqF;AACrF,0CAAoE;AAEpE,+EAAyE;AAMzE,8FAA8F;AAC9F,SAAgB,wCAAwC,CAAC,UAAiD,EAAE,YAA2B;IACrI,oBAAoB;IACpB,MAAM,wBAAwB,GAAG,EAAE,CAAA;IAEnC,IAAI,mBAAmB,GAAG,CAAC,CAAA;IAE3B,IAAI,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAElC,SAAS,aAAa;QACpB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAC7B,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,wBAAwB,CAAC,EAAE;YAC1D,OAAO,IAAI,CAAA;SACZ;QACD,UAAU,GAAG,GAAG,CAAA;QAChB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,SAAS,cAAc,CAAC,QAAiB,EAAE,QAAoB,EAAE,aAAsB;QACrF,mBAAmB,EAAE,CAAA;QAErB,IAAI,CAAC,aAAa,IAAI,aAAa,EAAE;YAAE,OAAM;QAE7C,MAAM,cAAc,GAAa;YAC/B,KAAK,EAAE,mBAAmB;YAC1B,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrB,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrB,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrB,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrB,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrB,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrB,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrB,+BAA+B;SAChC,CAAA;QAED,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,EAAE;YAC7B,IAAI,EAAE,CAAC,KAAK,KAAK,4CAAoB,CAAC,SAAS,EAAE;gBAC/C,EAAE,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAA;aACvC;SACF;IACH,CAAC;IAED,OAAO;QACL,MAAM;YACJ,mEAAmE;YACnE,cAAc,CAAC,YAAY,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,cAAO,CAAC,CAAC,EAAE,+BAAa,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAA;QAC1I,CAAC;QACD,cAAc;KACf,CAAA;AACH,CAAC;AAhDD,4FAgDC"}

package/dist/lib/decentraland/communications/realm-communications-system.d.ts

@@ -0,0 +1,17 @@
+import { Atom } from "../../misc/atom";
+import { ExplorerIdentity } from "../identity/types";
+import { CommsAdapter } from "./types";
+import { CommsTransportWrapper } from "./CommsTransportWrapper";
+import { Scene } from "@babylonjs/core";
+import { CurrentRealm } from "../state";
+/**
+ * This system is in charge to handle realm connections and connect/disconnect transports accordingly.
+ */
+export declare function createRealmCommunicationSystem(userIdentity: Atom<ExplorerIdentity>, currentRealm: Atom<CurrentRealm>, scene: Scene): {
+    currentAdapter: Atom<CommsAdapter>;
+    currentRealm: Atom<CurrentRealm>;
+    getTransports(): IterableIterator<CommsTransportWrapper>;
+    lateUpdate(): void;
+};
+export declare function connectRealm(currentRealm: Atom<CurrentRealm>, realmConnectionString: string): Promise<CurrentRealm>;
+//# sourceMappingURL=realm-communications-system.d.ts.map

package/dist/lib/decentraland/communications/realm-communications-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realm-communications-system.d.ts","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/realm-communications-system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGpD,OAAO,EAAE,YAAY,EAAe,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK;;;;;EAsFlI;AAED,wBAAsB,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBzH"}

package/dist/lib/decentraland/communications/realm-communications-system.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectRealm = exports.createRealmCommunicationSystem = void 0;
+const atom_1 = require("../../misc/atom");
+const connect_adapter_1 = require("./connect-adapter");
+const connect_transport_1 = require("./connect-transport");
+const types_1 = require("./types");
+const resolution_1 = require("../realm/resolution");
+/**
+ * This system is in charge to handle realm connections and connect/disconnect transports accordingly.
+ */
+function createRealmCommunicationSystem(userIdentity, currentRealm, scene) {
+    const currentAdapter = (0, atom_1.Atom)();
+    const activeTransports = new Map();
+    currentRealm.pipe(async function connectNewCommsAdapter(realm) {
+        const identity = await userIdentity.deref();
+        const isLocalPreview = realm.aboutResponse.configurations?.realmName === "LocalPreview";
+        const newAdapter = isLocalPreview ? await (0, connect_adapter_1.connectLocalAdapter)(realm.baseUrl) : await (0, connect_adapter_1.connectAdapter)(realm.aboutResponse.comms?.fixedAdapter ?? "offline:offline", identity, 'realm');
+        const oldAdapter = currentAdapter.swap(newAdapter);
+        if (oldAdapter) {
+            oldAdapter.disconnect();
+        }
+    });
+    // this function returns the absolute list of transports that should be connected
+    // for the moment it only takes the desired transports from the CommsAdapter only
+    function getDesiredTransports() {
+        const ret = [];
+        const adapter = currentAdapter.getOrNull();
+        if (adapter) {
+            const desiredTransports = adapter.desiredTransports.getOrNull();
+            if (desiredTransports)
+                ret.push(...desiredTransports);
+        }
+        // TODO: here we add more desired transports from i.e. the scenes
+        return ret;
+    }
+    // updateAdapters connects the adapters that are not connected yet and disconnects the ones that are not desired anymore
+    // TODO: debounce this function to prevent fast reconnections and DDoSing the servers
+    function updateAdapters(connectionStrings) {
+        const identity = userIdentity.getOrNull();
+        if (!identity)
+            return;
+        // first remove all the extra adapters
+        for (const [connectionString, connection] of activeTransports) {
+            if (!connectionStrings.find($ => $.url === connectionString)) {
+                connection.disconnect().finally(() => {
+                    types_1.commsLogger.log(`removinng not needed transport ${connectionString}`);
+                    activeTransports.delete(connectionString);
+                });
+            }
+        }
+        // then connect all missing transports
+        for (const connectionString of connectionStrings) {
+            if (!activeTransports.has(connectionString.url)) {
+                const transport = (0, connect_transport_1.connectTransport)(connectionString.url, identity, scene, connectionString.sceneId);
+                // store the handle of the active transport
+                activeTransports.set(connectionString.url, transport);
+                // and then hook into its connection events
+                transport.events.on('DISCONNECTION', (e) => {
+                    types_1.commsLogger.error(`🔌❌ ${connectionString.url} disconnected`, e);
+                    if (activeTransports.get(connectionString.url) === transport) {
+                        activeTransports.delete(connectionString.url);
+                        types_1.commsLogger.log(`Removing disconnected transport ${connectionString}`);
+                    }
+                });
+                transport.connect().then(() => {
+                    types_1.commsLogger.log(`🔌 Connected to ${connectionString}`);
+                }).catch((e) => {
+                    types_1.commsLogger.error(`❌ Could not connect to ${connectionString}`, e);
+                });
+            }
+        }
+    }
+    let applicationRunning = true;
+    return {
+        currentAdapter,
+        currentRealm,
+        getTransports() {
+            return activeTransports.values();
+        },
+        lateUpdate() {
+            // connects and disconnect the transports based on the desired list
+            if (applicationRunning) {
+                const desiredTransports = getDesiredTransports();
+                updateAdapters(desiredTransports);
+            }
+        }
+    };
+}
+exports.createRealmCommunicationSystem = createRealmCommunicationSystem;
+async function connectRealm(currentRealm, realmConnectionString) {
+    // naively, first destroy all created scenes before loading the new realm.
+    // in the future many optimization could be applied here, like only destroying
+    // the scenes that will be replaced by the new realm.
+    const baseUrl = (await (0, resolution_1.resolveRealmBaseUrl)(realmConnectionString)).replace(/\/$/, '');
+    // fetch the standard /about endpoint for the realm
+    const res = await fetch(baseUrl + '/about');
+    if (res.ok) {
+        const aboutResponse = await res.json();
+        const newRealm = {
+            baseUrl,
+            connectionString: realmConnectionString,
+            aboutResponse
+        };
+        currentRealm.swap(newRealm);
+        return newRealm;
+    }
+    throw new Error(`Could not load the realm ${realmConnectionString}`);
+}
+exports.connectRealm = connectRealm;
+//# sourceMappingURL=realm-communications-system.js.map

package/dist/lib/decentraland/communications/realm-communications-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realm-communications-system.js","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/realm-communications-system.ts"],"names":[],"mappings":";;;AACA,0CAAsC;AAEtC,uDAAuE;AACvE,2DAAsD;AACtD,mCAAmD;AAEnD,oDAAyD;AAIzD;;GAEG;AACH,SAAgB,8BAA8B,CAAC,YAAoC,EAAE,YAAgC,EAAE,KAAY;IACjI,MAAM,cAAc,GAAG,IAAA,WAAI,GAAgB,CAAA;IAC3C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAiC,CAAA;IAEjE,YAAY,CAAC,IAAI,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAAmB;QACzE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,CAAA;QAE3C,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,SAAS,KAAK,cAAc,CAAA;QACvF,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,IAAA,qCAAmB,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,IAAA,gCAAc,EAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;QACpL,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAClD,IAAI,UAAU,EAAE;YACd,UAAU,CAAC,UAAU,EAAE,CAAA;SACxB;IACH,CAAC,CAAC,CAAA;IAEF,iFAAiF;IACjF,iFAAiF;IACjF,SAAS,oBAAoB;QAC3B,MAAM,GAAG,GAAG,EAAE,CAAA;QACd,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,EAAE,CAAA;QAC1C,IAAI,OAAO,EAAE;YACX,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAA;YAC/D,IAAI,iBAAiB;gBACnB,GAAG,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAA;SACjC;QACD,iEAAiE;QACjE,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,wHAAwH;IACxH,qFAAqF;IACrF,SAAS,cAAc,CAAC,iBAAqD;QAC3E,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,EAAE,CAAA;QACzC,IAAI,CAAC,QAAQ;YAAE,OAAM;QAErB,sCAAsC;QACtC,KAAK,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC,IAAI,gBAAgB,EAAE;YAC7D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,gBAAgB,CAAC,EAAE;gBAC5D,UAAU,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;oBACnC,mBAAW,CAAC,GAAG,CAAC,kCAAkC,gBAAgB,EAAE,CAAC,CAAA;oBACrE,gBAAgB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;gBAC3C,CAAC,CAAC,CAAA;aACH;SACF;QAED,sCAAsC;QACtC,KAAK,MAAM,gBAAgB,IAAI,iBAAiB,EAAE;YAChD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE;gBAC/C,MAAM,SAAS,GAAG,IAAA,oCAAgB,EAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;gBAEnG,2CAA2C;gBAC3C,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;gBACrD,2CAA2C;gBAC3C,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE;oBACzC,mBAAW,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GAAG,eAAe,EAAE,CAAC,CAAC,CAAA;oBAChE,IAAI,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;wBAC5D,gBAAgB,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAA;wBAC7C,mBAAW,CAAC,GAAG,CAAC,mCAAmC,gBAAgB,EAAE,CAAC,CAAA;qBACvE;gBACH,CAAC,CAAC,CAAA;gBAEF,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;oBAC5B,mBAAW,CAAC,GAAG,CAAC,mBAAmB,gBAAgB,EAAE,CAAC,CAAA;gBACxD,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACb,mBAAW,CAAC,KAAK,CAAC,0BAA0B,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAA;gBACpE,CAAC,CAAC,CAAA;aACH;SACF;IACH,CAAC;IAED,IAAI,kBAAkB,GAAG,IAAI,CAAA;IAE7B,OAAO;QACL,cAAc;QACd,YAAY;QACZ,aAAa;YACX,OAAO,gBAAgB,CAAC,MAAM,EAAE,CAAA;QAClC,CAAC;QACD,UAAU;YACR,mEAAmE;YACnE,IAAI,kBAAkB,EAAE;gBACtB,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAA;gBAChD,cAAc,CAAC,iBAAiB,CAAC,CAAA;aAClC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAtFD,wEAsFC;AAEM,KAAK,UAAU,YAAY,CAAC,YAAgC,EAAE,qBAA6B;IAChG,0EAA0E;IAC1E,8EAA8E;IAC9E,qDAAqD;IACrD,MAAM,OAAO,GAAG,CAAC,MAAM,IAAA,gCAAmB,EAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAErF,mDAAmD;IACnD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAA;IAC3C,IAAI,GAAG,CAAC,EAAE,EAAE;QACV,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,IAAI,EAAmB,CAAA;QACvD,MAAM,QAAQ,GAAiB;YAC7B,OAAO;YACP,gBAAgB,EAAE,qBAAqB;YACvC,aAAa;SACd,CAAA;QACD,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC3B,OAAO,QAAQ,CAAA;KAChB;IAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,qBAAqB,EAAE,CAAC,CAAA;AACtE,CAAC;AApBD,oCAoBC"}

package/dist/lib/decentraland/communications/scene-comms.d.ts

@@ -0,0 +1,9 @@
+import { Atom } from "../../misc/atom";
+import { ExplorerIdentity } from "../identity/types";
+import { Scene } from "@babylonjs/core";
+import { CurrentRealm } from "../state";
+/**
+ * This system is in charge to handle realm connections and connect/disconnect transports accordingly.
+ */
+export declare function createSceneComms(realm: CurrentRealm, userIdentity: Atom<ExplorerIdentity>, scene: Scene): Promise<import("./CommsTransportWrapper").CommsTransportWrapper>;
+//# sourceMappingURL=scene-comms.d.ts.map

package/dist/lib/decentraland/communications/scene-comms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-comms.d.ts","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/scene-comms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGpD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,oEAY7G"}

package/dist/lib/decentraland/communications/scene-comms.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSceneComms = void 0;
+const connect_adapter_1 = require("./connect-adapter");
+const connect_transport_1 = require("./connect-transport");
+/**
+ * This system is in charge to handle realm connections and connect/disconnect transports accordingly.
+ */
+async function createSceneComms(realm, userIdentity, scene) {
+    const identity = await userIdentity.deref();
+    const isLocalPreview = realm.aboutResponse.configurations?.realmName === "LocalPreview";
+    const newAdapter = isLocalPreview ? await (0, connect_adapter_1.connectLocalAdapter)(realm.baseUrl) : await (0, connect_adapter_1.connectAdapter)(realm.aboutResponse.comms?.fixedAdapter ?? "offline:offline", identity, 'realm');
+    const desiredTransports = await newAdapter.desiredTransports.deref();
+    const connectionString = desiredTransports[0];
+    const transport = (0, connect_transport_1.connectTransport)(connectionString.url, identity, scene, connectionString.sceneId);
+    transport.connect();
+    return transport;
+}
+exports.createSceneComms = createSceneComms;
+//# sourceMappingURL=scene-comms.js.map

package/dist/lib/decentraland/communications/scene-comms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-comms.js","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/scene-comms.ts"],"names":[],"mappings":";;;AAEA,uDAAuE;AACvE,2DAAsD;AAItD;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAAC,KAAmB,EAAE,YAAoC,EAAE,KAAY;IAC5G,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,CAAA;IAE3C,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,SAAS,KAAK,cAAc,CAAA;IACvF,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,IAAA,qCAAmB,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,IAAA,gCAAc,EAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IACpL,MAAM,iBAAiB,GAAG,MAAM,UAAU,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAA;IACpE,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAA;IAC7C,MAAM,SAAS,GAAG,IAAA,oCAAgB,EAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAEnG,SAAS,CAAC,OAAO,EAAE,CAAA;IAEnB,OAAO,SAAS,CAAA;AAClB,CAAC;AAZD,4CAYC"}

package/dist/lib/decentraland/communications/transports/livekit.d.ts

@@ -0,0 +1,27 @@
+import * as proto from '@dcl/protocol/out-js/decentraland/kernel/comms/rfc4/comms.gen';
+import { CommsTransportEvents, MinimumCommunicationsTransport, SendHints } from '../types';
+import { Scene } from '@babylonjs/core';
+export type LivekitConfig = {
+    url: string;
+    token: string;
+    scene: Scene;
+};
+export type VoiceSpatialParams = {
+    position: [number, number, number];
+    orientation: [number, number, number];
+};
+export declare class LivekitAdapter implements MinimumCommunicationsTransport {
+    private config;
+    readonly events: import("mitt").Emitter<CommsTransportEvents>;
+    private disposed;
+    private readonly room;
+    constructor(config: LivekitConfig);
+    connect(): Promise<void>;
+    send(data: Uint8Array, { reliable }: SendHints, destination?: string[]): Promise<void>;
+    disconnect(): Promise<void>;
+    doDisconnect(kicked: boolean): Promise<void>;
+    setVoicePosition(address: string, position: proto.Position): void;
+    handleMessage(address: string, data: Uint8Array): void;
+}
+export declare function getSpatialParamsFor(position: proto.Position): VoiceSpatialParams;
+//# sourceMappingURL=livekit.d.ts.map

package/dist/lib/decentraland/communications/transports/livekit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit.d.ts","sourceRoot":"","sources":["../../../../../src/lib/decentraland/communications/transports/livekit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,+DAA+D,CAAA;AAStF,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,SAAS,EAAe,MAAM,UAAU,CAAA;AACvG,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEvC,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC,CAAA;AAID,qBAAa,cAAe,YAAW,8BAA8B;IAMvD,OAAO,CAAC,MAAM;IAL1B,SAAgB,MAAM,+CAA+B;IAErD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAM;gBAEP,MAAM,EAAE,aAAa;IA8CnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBtF,UAAU;IAIV,YAAY,CAAC,MAAM,EAAE,OAAO;IAUlC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ;IAI1D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU;CAMhD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,kBAAkB,CAKhF"}

package/dist/lib/decentraland/communications/transports/livekit.js

@@ -0,0 +1,135 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSpatialParamsFor = exports.LivekitAdapter = void 0;
+const proto = __importStar(require("@dcl/protocol/out-js/decentraland/kernel/comms/rfc4/comms.gen"));
+const rtc_node_1 = require("@livekit/rtc-node");
+const mitt_1 = __importDefault(require("mitt"));
+const types_1 = require("../types");
+const MAXIMUM_NETWORK_MSG_LENGTH = 30000;
+class LivekitAdapter {
+    constructor(config) {
+        this.config = config;
+        this.events = (0, mitt_1.default)();
+        this.disposed = false;
+        this.room = new rtc_node_1.Room();
+        this.room
+            .on(rtc_node_1.RoomEvent.ParticipantConnected, (_) => {
+            const address = _.identity;
+            this.events.emit('PEER_CONNECTED', {
+                address: address
+            });
+        })
+            .on(rtc_node_1.RoomEvent.ParticipantDisconnected, (_) => {
+            const address = _.identity;
+            this.events.emit('PEER_DISCONNECTED', {
+                address: address
+            });
+        })
+            .on(rtc_node_1.RoomEvent.Disconnected, (reason) => {
+            if (this.disposed) {
+                return;
+            }
+            // Only show the warning if it's not a manual disconnect during restart
+            if (reason !== rtc_node_1.DisconnectReason.CLIENT_INITIATED) {
+                console.error('\n' + '═'.repeat(60));
+                console.error('⚠️  LIVEKIT DISCONNECTED - SERVER COMMUNICATION LOST');
+                console.error('═'.repeat(60));
+                console.error(`Reason: ${rtc_node_1.DisconnectReason[reason] || reason}`);
+                console.error(`Room: ${this.room.name}`);
+                console.error('═'.repeat(60));
+                console.error('Press [R] to restart the server or [Ctrl+C] to exit');
+                console.error('═'.repeat(60) + '\n');
+            }
+            const kicked = reason === rtc_node_1.DisconnectReason.DUPLICATE_IDENTITY;
+            this.doDisconnect(kicked).catch((err) => {
+                types_1.commsLogger.error(`error during disconnection ${err.toString()}`);
+            });
+        })
+            .on(rtc_node_1.RoomEvent.DataReceived, (payload, participant, _) => {
+            if (participant) {
+                this.handleMessage(participant.identity, payload);
+            }
+        });
+    }
+    async connect() {
+        await this.room.connect(this.config.url, this.config.token);
+        types_1.commsLogger.log(`Connected to livekit room ${this.room.name?.split(':')[0]}`, { sid: await this.room.getSid(), metadata: this.room.metadata });
+    }
+    async send(data, { reliable }, destination) {
+        if (this.disposed) {
+            types_1.commsLogger.error('disposed');
+            return;
+        }
+        if (data.length > MAXIMUM_NETWORK_MSG_LENGTH) {
+            const message = proto.Packet.decode(data);
+            types_1.commsLogger.error('Skipping big message over comms', message);
+            return;
+        }
+        if (this.room.connectionState !== rtc_node_1.ConnectionState.CONN_CONNECTED) {
+            types_1.commsLogger.error('Not connected to LiveKit', this.room.connectionState);
+            return;
+        }
+        try {
+            await this.room.localParticipant?.publishData(data, { reliable, destination_identities: destination });
+        }
+        catch (err) {
+            // NOTE: for tracking purposes only, this is not a "code" error, this is a failed connection or a problem with the livekit instance
+            await this.disconnect();
+        }
+    }
+    async disconnect() {
+        return this.doDisconnect(false);
+    }
+    async doDisconnect(kicked) {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        await this.room.disconnect().catch(types_1.commsLogger.error);
+        this.events.emit('DISCONNECTION', { kicked });
+    }
+    setVoicePosition(address, position) {
+        // No-op for headless server
+    }
+    handleMessage(address, data) {
+        this.events.emit('message', {
+            address,
+            data
+        });
+    }
+}
+exports.LivekitAdapter = LivekitAdapter;
+function getSpatialParamsFor(position) {
+    return {
+        position: [position.positionX, position.positionY, position.positionZ],
+        orientation: [0, 0, 1] // Default forward orientation for headless
+    };
+}
+exports.getSpatialParamsFor = getSpatialParamsFor;
+//# sourceMappingURL=livekit.js.map

package/dist/lib/decentraland/communications/transports/livekit.js.map

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

package/dist/lib/decentraland/communications/transports/ws-room.d.ts

@@ -0,0 +1,26 @@
+import { IFuture } from 'fp-future';
+import { WebSocket } from 'ws';
+import * as rfc5 from '@dcl/protocol/out-js/decentraland/kernel/comms/rfc5/ws_comms.gen';
+import { ExplorerIdentity } from '../../identity/types';
+import { CommsTransportEvents, MinimumCommunicationsTransport, SendHints } from '../types';
+import { Position } from '@dcl/protocol/out-js/decentraland/kernel/comms/rfc4/comms.gen';
+export declare class WebSocketAdapter implements MinimumCommunicationsTransport {
+    url: string;
+    private identity;
+    alias: number | null;
+    events: import("mitt").Emitter<CommsTransportEvents>;
+    private connected;
+    private peersToAddress;
+    get connectedPromise(): IFuture<Set<string>>;
+    private ws;
+    constructor(url: string, identity: ExplorerIdentity);
+    setVoicePosition(_address: string, _position: Position): void;
+    connect(): Promise<void>;
+    handleWelcomeMessage(welcomeMessage: rfc5.WsWelcome, socket: WebSocket): Set<string>;
+    send(body: Uint8Array, hints: SendHints): void;
+    disconnect(error?: Error): Promise<void>;
+    internalDisconnect(kicked: boolean, _error?: Error): void;
+    private onWsMessage;
+    private internalSend;
+}
+//# sourceMappingURL=ws-room.d.ts.map

package/dist/lib/decentraland/communications/transports/ws-room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-room.d.ts","sourceRoot":"","sources":["../../../../../src/lib/decentraland/communications/transports/ws-room.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,OAAO,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAgB,MAAM,IAAI,CAAA;AAE5C,OAAO,KAAK,IAAI,MAAM,kEAAkE,CAAA;AAKxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,+DAA+D,CAAA;AAWxF,qBAAa,gBAAiB,YAAW,8BAA8B;IAalD,GAAG,EAAE,MAAM;IAAE,OAAO,CAAC,QAAQ;IAZzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAO;IAC3B,MAAM,+CAA+B;IAE5C,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,cAAc,CAA4B;IAElD,IAAI,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAE3C;IAED,OAAO,CAAC,EAAE,CAAyB;gBAEhB,GAAG,EAAE,MAAM,EAAU,QAAQ,EAAE,gBAAgB;IAElE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,IAAI;IAGvD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgG9B,oBAAoB,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;IAYpF,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS;IAejC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK;IAI9B,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,KAAK;YAapC,WAAW;IA0CzB,OAAO,CAAC,YAAY;CAYrB"}