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

package/dist/lib/decentraland/communications/avatar-communication-system.d.ts

@@ -0,0 +1,18 @@
+import { ReadWriteByteBuffer } from "../ByteBuffer";
+import { CommsTransportWrapper } from "./CommsTransportWrapper";
+/**
+ * Single avatar communication system that handles avatar entities for a specific scene transport.
+ * This system manages player entities, profiles, and avatar data for multiplayer scenarios.
+ */
+export declare function createAvatarCommunicationSystem(transport: CommsTransportWrapper): {
+    range: [number, number];
+    update(): void;
+    createSubscription(): {
+        range: [number, number];
+        dispose(): void;
+        getUpdates(writer: ReadWriteByteBuffer): void;
+    };
+    dispose(): void;
+};
+export type AvatarCommunicationSystem = ReturnType<typeof createAvatarCommunicationSystem>;
+//# sourceMappingURL=avatar-communication-system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-communication-system.d.ts","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/avatar-communication-system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAOnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAI/D;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,qBAAqB;;;;;;2BA4MrD,mBAAmB;;;EAgB7C;AAED,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAA"}

package/dist/lib/decentraland/communications/avatar-communication-system.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAvatarCommunicationSystem = void 0;
+const core_1 = require("@babylonjs/core");
+const ByteBuffer_1 = require("../ByteBuffer");
+const last_write_win_element_set_1 = require("../crdt-internal/last-write-win-element-set");
+const player_identity_data_1 = require("../sdk-components/player-identity-data");
+const avatar_base_1 = require("../sdk-components/avatar-base");
+const transform_component_1 = require("../sdk-components/transform-component");
+const static_entities_1 = require("../../babylon/scene/logic/static-entities");
+const player_entity_manager_1 = require("./player-entity-manager");
+/**
+ * Single avatar communication system that handles avatar entities for a specific scene transport.
+ * This system manages player entities, profiles, and avatar data for multiplayer scenarios.
+ */
+function createAvatarCommunicationSystem(transport) {
+    const PlayerIdentityData = (0, last_write_win_element_set_1.createLwwStore)(player_identity_data_1.playerIdentityDataComponent);
+    const AvatarBase = (0, last_write_win_element_set_1.createLwwStore)(avatar_base_1.avatarBaseComponent);
+    const Transform = (0, last_write_win_element_set_1.createLwwStore)(transform_component_1.transformComponent);
+    const listOfComponentsToSynchronize = [PlayerIdentityData, AvatarBase, Transform];
+    // Cache for profiles fetched from Catalyst
+    const profileCache = new Map();
+    function normalizeAddress(address) {
+        return address.toLowerCase();
+    }
+    async function fetchProfileFromCatalyst(address, lambdasEndpoint) {
+        try {
+            // Use lambdasEndpoint if provided, otherwise use default Catalyst
+            const baseUrl = lambdasEndpoint || 'https://peer.decentraland.org';
+            const response = await fetch(`${baseUrl}/lambdas/profiles?id=${address}`);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch profile: ${response.status}`);
+            }
+            const data = await response.json();
+            return data[0].avatars?.[0]; // Return the profile data
+        }
+        catch (error) {
+            console.error('Failed to fetch profile from Catalyst:', error);
+            throw error;
+        }
+    }
+    async function handleProfileVersionAnnouncement(entity, address, announcedVersion, lambdasEndpoint) {
+        const cached = profileCache.get(address);
+        // Only fetch if we don't have this version cached
+        if (!cached || cached.version < announcedVersion) {
+            try {
+                const profile = await fetchProfileFromCatalyst(address, lambdasEndpoint);
+                if (profile && profile.version >= announcedVersion) {
+                    profileCache.set(address, { profile, version: profile.version });
+                    updatePlayerComponents(entity, address, profile);
+                }
+            }
+            catch (error) {
+                console.error('Failed to handle profile version announcement:', error);
+            }
+        }
+    }
+    function updatePlayerComponents(entity, address, profile) {
+        // Update PlayerIdentityData component (protobuf)
+        PlayerIdentityData.createOrReplace(entity, {
+            address: address,
+            isGuest: !profile.hasConnectedWeb3
+        });
+        // Update AvatarBase component (protobuf) 
+        AvatarBase.createOrReplace(entity, {
+            name: profile.name || 'Unknown',
+            bodyShapeUrn: profile.avatar?.bodyShape || '',
+            skinColor: profile.avatar?.skin?.color ? {
+                r: profile.avatar.skin.color.r,
+                g: profile.avatar.skin.color.g,
+                b: profile.avatar.skin.color.b
+            } : { r: 0.8, g: 0.6, b: 0.4 },
+            eyesColor: profile.avatar?.eyes?.color ? {
+                r: profile.avatar.eyes.color.r,
+                g: profile.avatar.eyes.color.g,
+                b: profile.avatar.eyes.color.b
+            } : { r: 0.2, g: 0.5, b: 0.8 },
+            hairColor: profile.avatar?.hair?.color ? {
+                r: profile.avatar.hair.color.r,
+                g: profile.avatar.hair.color.g,
+                b: profile.avatar.hair.color.b
+            } : { r: 0.3, g: 0.2, b: 0.1 } // Default hair color
+        });
+    }
+    function removePlayerEntity(entity, address) {
+        for (const component of listOfComponentsToSynchronize) {
+            component.entityDeleted(entity, true);
+        }
+        // Free the entity in the player entity manager
+        player_entity_manager_1.playerEntityManager.freeEntityForPlayer(address);
+        // Clear from profile cache
+        const normalizedAddress = normalizeAddress(address);
+        profileCache.delete(normalizedAddress);
+    }
+    function findPlayerEntityByAddress(address, createIfMissing) {
+        const normalizedAddress = normalizeAddress(address);
+        // First check if we already have an entity allocated for this address
+        let entity = player_entity_manager_1.playerEntityManager.getEntityForAddress(normalizedAddress);
+        if (entity !== null) {
+            return entity;
+        }
+        if (!createIfMissing)
+            return null;
+        // Allocate a new entity for this remote player
+        entity = player_entity_manager_1.playerEntityManager.allocateEntityForPlayer(normalizedAddress, false);
+        if (entity === null) {
+            console.warn(`Failed to allocate entity for player ${normalizedAddress}`);
+            return null;
+        }
+        // Initialize with minimal identity data
+        PlayerIdentityData.createOrReplace(entity, { address: normalizedAddress, isGuest: true });
+        return entity;
+    }
+    // Wire up transport events
+    transport.events.on('PEER_CONNECTED', (event) => {
+        const address = normalizeAddress(event.address);
+        // Allocate entity for the new participant
+        const entity = findPlayerEntityByAddress(address, true);
+        if (entity) {
+            // Trigger initial profile fetch
+            transport.events.emit('profileMessage', {
+                address: address,
+                data: {
+                    profileVersion: 1 // Initial version
+                }
+            });
+        }
+    });
+    transport.events.on('PEER_DISCONNECTED', (event) => {
+        // TODO: handle the .off event
+        console.log('[PEER_DISCONNECTED]', event);
+        const entity = findPlayerEntityByAddress(event.address, false);
+        if (entity) {
+            removePlayerEntity(entity, event.address);
+        }
+    });
+    transport.events.on('position', (event) => {
+        const entity = findPlayerEntityByAddress(event.address, true);
+        if (entity) {
+            Transform.createOrReplace(entity, {
+                position: new core_1.Vector3(event.data.positionX, event.data.positionY, event.data.positionZ),
+                scale: core_1.Vector3.One(),
+                rotation: new core_1.Quaternion(event.data.rotationX, event.data.rotationY, event.data.rotationZ, event.data.rotationW),
+                parent: static_entities_1.StaticEntities.GlobalCenterOfCoordinates
+            });
+        }
+    });
+    // ADR-204: Use profileMessage for profile version announcements
+    transport.events.on('profileMessage', async (event) => {
+        const address = normalizeAddress(event.address);
+        const announcedVersion = event.data.profileVersion;
+        const entity = findPlayerEntityByAddress(event.address, true);
+        if (entity) {
+            await handleProfileVersionAnnouncement(entity, address, announcedVersion);
+        }
+    });
+    transport.events.on('chatMessage', (event) => {
+        const address = normalizeAddress(event.address);
+        const cached = profileCache.get(address);
+        findPlayerEntityByAddress(event.address, true);
+        const name = cached?.profile?.name || 'Unknown';
+    });
+    // Public API for managing the avatar system
+    return {
+        // Entity range this system manages
+        range: [32, 256],
+        // Update function to be called each frame
+        update() {
+            const updates = new ByteBuffer_1.ReadWriteByteBuffer();
+            for (const component of listOfComponentsToSynchronize) {
+                // Commit updates and clean dirty iterators
+                component.dumpCrdtUpdates(updates);
+            }
+        },
+        // Create subscription for CRDT synchronization
+        createSubscription() {
+            const state = new Map(listOfComponentsToSynchronize.map(component => [component, -1]));
+            return {
+                range: [32, 256],
+                dispose() {
+                    state.clear();
+                    // Clear player entity manager and profile cache
+                    player_entity_manager_1.playerEntityManager.clear();
+                    profileCache.clear();
+                },
+                getUpdates(writer) {
+                    // Serialize all updates from the last tick until now
+                    for (const [component, tick] of state) {
+                        const newTick = component.dumpCrdtDeltas(writer, tick);
+                        state.set(component, newTick);
+                    }
+                },
+            };
+        },
+        // Cleanup function
+        dispose() {
+            player_entity_manager_1.playerEntityManager.clear();
+            profileCache.clear();
+        }
+    };
+}
+exports.createAvatarCommunicationSystem = createAvatarCommunicationSystem;
+//# sourceMappingURL=avatar-communication-system.js.map

package/dist/lib/decentraland/communications/avatar-communication-system.js.map

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

package/dist/lib/decentraland/communications/connect-adapter.d.ts

@@ -0,0 +1,5 @@
+import { ExplorerIdentity } from "../identity/types";
+import { CommsAdapter } from "./types";
+export declare function connectLocalAdapter(baseUrl: string): Promise<CommsAdapter>;
+export declare function connectAdapter(connStr: string, identity: ExplorerIdentity, sceneId: string): Promise<CommsAdapter>;
+//# sourceMappingURL=connect-adapter.d.ts.map

package/dist/lib/decentraland/communications/connect-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-adapter.d.ts","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/connect-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAMtC,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,yBA2BxD;AAKD,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAuFxH"}

package/dist/lib/decentraland/communications/connect-adapter.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectAdapter = exports.connectLocalAdapter = void 0;
+const state_1 = require("../state");
+const load_1 = require("../../babylon/scene/load");
+const atom_1 = require("../../misc/atom");
+const signed_fetch_1 = require("../identity/signed-fetch");
+// TODO: this should be an env var
+const COMMS_GATEKEEPER_URL = 'http://localhost:3000/get-server-scene-adapter';
+// 'https://comms-gatekeeper-local.decentraland.org/get-scene-adapter' 
+async function connectLocalAdapter(baseUrl) {
+    const { urn } = await (0, load_1.getLoadableSceneFromLocalContext)(baseUrl);
+    const identity = await state_1.userIdentity.deref();
+    try {
+        const result = await (0, signed_fetch_1.signedFetch)(COMMS_GATEKEEPER_URL, identity.authChain, { method: 'POST', responseBodyType: 'json' }, {
+            intent: 'dcl:explorer:comms-handshake',
+            signer: 'dcl:explorer',
+            isGuest: identity.isGuest,
+            realm: {
+                serverName: 'LocalPreview'
+            },
+            realmName: 'LocalPreview',
+            sceneId: urn,
+        });
+        if (result.ok && result.json.adapter) {
+            return await connectAdapter(result.json.adapter, identity, urn);
+        }
+        throw 'Invalid livekit connection';
+    }
+    catch (e) {
+        console.log(e);
+        throw e;
+    }
+}
+exports.connectLocalAdapter = connectLocalAdapter;
+// this function returns adapters for the different protocols. in case of receiving a transport instead,
+// a stub adapter will be created to wrap the transport
+async function connectAdapter(connStr, identity, sceneId) {
+    const ix = connStr.indexOf(':');
+    const protocol = connStr.substring(0, ix);
+    const url = connStr.substring(ix + 1);
+    switch (protocol) {
+        case 'livekit': {
+            return {
+                reportPosition(position) {
+                    // stub
+                },
+                desiredTransports: (0, atom_1.Atom)([{ url: connStr, sceneId }]),
+                disconnect() {
+                    // stub
+                }
+            };
+        }
+        case 'offline': {
+            return {
+                reportPosition(position) {
+                    // stub
+                },
+                desiredTransports: (0, atom_1.Atom)([{ url: '', sceneId }]),
+                disconnect() {
+                    // stub
+                }
+            };
+        }
+        case 'ws-room': {
+            return {
+                desiredTransports: (0, atom_1.Atom)([{ url: connStr, sceneId }]),
+                reportPosition(position) {
+                    // stub
+                },
+                disconnect() {
+                    // stub
+                }
+            };
+        }
+        case 'signed-login': {
+            // this communications protocol signals a "required handshake" to connect
+            // to a server which requires a signature from part of the user in order
+            // to authenticate them
+            const result = await (0, signed_fetch_1.signedFetch)(url, identity.authChain, { method: 'POST', responseBodyType: 'json' }, {
+                intent: 'dcl:explorer:comms-handshake',
+                signer: 'dcl:explorer',
+                isGuest: identity.isGuest
+            });
+            const response = result.json;
+            if (!result.ok || typeof response !== 'object') {
+                throw new Error('There was an error acquiring the communications connection. Decentraland will try to connect to another realm');
+            }
+            console.log('[BOEDO]', { response });
+            if (typeof response.fixedAdapter === 'string' && !response.fixedAdapter.startsWith('signed-login:')) {
+                return {
+                    desiredTransports: (0, atom_1.Atom)([{ url: response.fixedAdapter, sceneId }]),
+                    reportPosition(position) {
+                        // stub
+                    },
+                    disconnect() {
+                        // stub
+                    }
+                };
+            }
+            if (typeof response.message === 'string') {
+                throw new Error(`There was an error acquiring the communications connection: ${response.message}`);
+            }
+            throw new Error(`An unknown error was detected while trying to connect to the selected realm.`);
+        }
+    }
+    throw new Error(`A communications adapter could not be created for protocol=${protocol}`);
+}
+exports.connectAdapter = connectAdapter;
+//# sourceMappingURL=connect-adapter.js.map

package/dist/lib/decentraland/communications/connect-adapter.js.map

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

package/dist/lib/decentraland/communications/connect-transport.d.ts

@@ -0,0 +1,5 @@
+import { Scene } from "@babylonjs/core";
+import { ExplorerIdentity } from "../identity/types";
+import { CommsTransportWrapper } from "./CommsTransportWrapper";
+export declare function connectTransport(connStr: string, identity: ExplorerIdentity, scene: Scene, sceneId: string): CommsTransportWrapper;
+//# sourceMappingURL=connect-transport.d.ts.map

package/dist/lib/decentraland/communications/connect-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-transport.d.ts","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/connect-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAK/D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB,CA4BlI"}

package/dist/lib/decentraland/communications/connect-transport.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectTransport = void 0;
+const CommsTransportWrapper_1 = require("./CommsTransportWrapper");
+const livekit_1 = require("./transports/livekit");
+const ws_room_1 = require("./transports/ws-room");
+function connectTransport(connStr, identity, scene, sceneId) {
+    const ix = connStr.indexOf(':');
+    const protocol = connStr.substring(0, ix);
+    const url = connStr.substring(ix + 1);
+    switch (protocol) {
+        case 'ws-room': {
+            const finalUrl = !url.startsWith('ws:') && !url.startsWith('wss:') ? 'wss://' + url : url;
+            return new CommsTransportWrapper_1.CommsTransportWrapper(new ws_room_1.WebSocketAdapter(finalUrl, identity), sceneId);
+        }
+        case 'livekit': {
+            const theUrl = new URL(url);
+            const token = theUrl.searchParams.get('access_token');
+            if (!token) {
+                throw new Error('No access token');
+            }
+            return new CommsTransportWrapper_1.CommsTransportWrapper(new livekit_1.LivekitAdapter({
+                url: theUrl.origin + theUrl.pathname,
+                token,
+                scene
+            }), sceneId);
+        }
+    }
+    throw new Error(`A communications transport could not be created for protocol=${protocol}`);
+}
+exports.connectTransport = connectTransport;
+//# sourceMappingURL=connect-transport.js.map

package/dist/lib/decentraland/communications/connect-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-transport.js","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/connect-transport.ts"],"names":[],"mappings":";;;AAEA,mEAA+D;AAC/D,kDAAqD;AACrD,kDAAuD;AAGvD,SAAgB,gBAAgB,CAAC,OAAe,EAAE,QAA0B,EAAE,KAAY,EAAE,OAAe;IACzG,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAErC,QAAQ,QAAQ,EAAE;QAChB,KAAK,SAAS,CAAC,CAAC;YACd,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;YAEzF,OAAO,IAAI,6CAAqB,CAAC,IAAI,0BAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAA;SACpF;QACD,KAAK,SAAS,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;YACrD,IAAI,CAAC,KAAK,EAAE;gBACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;aACnC;YACD,OAAO,IAAI,6CAAqB,CAC9B,IAAI,wBAAc,CAAC;gBACjB,GAAG,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ;gBACpC,KAAK;gBACL,KAAK;aACN,CAAC,EACF,OAAO,CACR,CAAA;SACF;KACF;IACD,MAAM,IAAI,KAAK,CAAC,gEAAgE,QAAQ,EAAE,CAAC,CAAA;AAC7F,CAAC;AA5BD,4CA4BC"}

package/dist/lib/decentraland/communications/networked-profile-system.d.ts

@@ -0,0 +1,10 @@
+import { Atom } from "../../misc/atom";
+import { Avatar } from "@dcl/schemas";
+import { CommsTransportWrapper } from "./CommsTransportWrapper";
+export declare function createNetworkedProfileSystem(transport: CommsTransportWrapper): {
+    update(): void;
+    lateUpdate: () => void;
+    setAvatar: (avatar: Avatar) => void;
+    currentAvatar: Atom<Avatar>;
+};
+//# sourceMappingURL=networked-profile-system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"networked-profile-system.d.ts","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/networked-profile-system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,yBAAyB,CAAA;AAGrF,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,qBAAqB;;;wBA2ChD,MAAM;;EA6BlC"}

package/dist/lib/decentraland/communications/networked-profile-system.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNetworkedProfileSystem = void 0;
+const atom_1 = require("../../misc/atom");
+const types_1 = require("./types");
+const CommsTransportWrapper_1 = require("./CommsTransportWrapper");
+// this function creates a controller for profile synchronization and announcement.
+function createNetworkedProfileSystem(transport) {
+    const currentAvatar = (0, atom_1.Atom)();
+    let lastReport = performance.now();
+    wireTransportEvents(transport);
+    // force max of 2Hz
+    const MAX_AVATARS_PER_SECOND = 2;
+    function shouldDiscard() {
+        const now = performance.now();
+        if ((now - lastReport) < (1000 / MAX_AVATARS_PER_SECOND)) {
+            return true;
+        }
+        lastReport = now;
+        return false;
+    }
+    function lateUpdate() {
+        const avatar = currentAvatar.getOrNull();
+        if (!avatar)
+            return;
+        if (shouldDiscard())
+            return;
+        // then send the profile message to the transports
+        if (transport.state === CommsTransportWrapper_1.RoomConnectionStatus.CONNECTED) {
+            transport.sendProfileMessage({ profileVersion: avatar.version });
+        }
+    }
+    function wireTransportEvents(transport) {
+        transport.events.on('profileRequest', async (packet) => {
+            try {
+                types_1.commsLogger.log('Responding to profile request', packet.data.address);
+                const avatar = await currentAvatar.deref();
+                if (packet.data.address.toLowerCase() === avatar.ethAddress.toLowerCase()) {
+                    sendLocalProfile(transport, avatar);
+                }
+            }
+            catch (err) {
+                types_1.commsLogger.error(err);
+            }
+        });
+    }
+    function setAvatar(avatar) {
+        const current = currentAvatar.getOrNull();
+        currentAvatar.swap({ ...avatar, version: (current?.version ?? 0) + 1 });
+        lastReport = 0;
+    }
+    // TODO: debounce this response
+    function sendLocalProfile(transport, avatar) {
+        types_1.commsLogger.log('Responding to profile request');
+        const avatarClone = structuredClone(avatar);
+        // the address is sent to the network in lower case this is for some reason required for
+        // the unity renderer to work
+        avatarClone.userId = avatarClone.userId.toLowerCase();
+        avatarClone.ethAddress = avatarClone.ethAddress.toLowerCase();
+        transport.sendProfileResponse({
+            baseUrl: "https://peer.decentraland.org/content/contents/",
+            serializedProfile: JSON.stringify(avatarClone)
+        });
+    }
+    return {
+        update() { },
+        lateUpdate,
+        setAvatar,
+        currentAvatar,
+    };
+}
+exports.createNetworkedProfileSystem = createNetworkedProfileSystem;
+//# sourceMappingURL=networked-profile-system.js.map

package/dist/lib/decentraland/communications/networked-profile-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networked-profile-system.js","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/networked-profile-system.ts"],"names":[],"mappings":";;;AAAA,0CAAsC;AAEtC,mCAAqC;AACrC,mEAAqF;AAErF,mFAAmF;AACnF,SAAgB,4BAA4B,CAAC,SAAgC;IAC3E,MAAM,aAAa,GAAG,IAAA,WAAI,GAAU,CAAA;IACpC,IAAI,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAElC,mBAAmB,CAAC,SAAS,CAAC,CAAA;IAC9B,mBAAmB;IACnB,MAAM,sBAAsB,GAAG,CAAC,CAAA;IAEhC,SAAS,aAAa;QACpB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAC7B,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,sBAAsB,CAAC,EAAE;YACxD,OAAO,IAAI,CAAA;SACZ;QACD,UAAU,GAAG,GAAG,CAAA;QAChB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,SAAS,UAAU;QACjB,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,CAAA;QAExC,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,IAAI,aAAa,EAAE;YAAE,OAAM;QAE3B,kDAAkD;QAClD,IAAI,SAAS,CAAC,KAAK,KAAK,4CAAoB,CAAC,SAAS,EAAE;YACtD,SAAS,CAAC,kBAAkB,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;SACjE;IACH,CAAC;IAED,SAAS,mBAAmB,CAAC,SAAgC;QAC3D,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACrD,IAAI;gBACF,mBAAW,CAAC,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACrE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAA;gBAC1C,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE;oBACzE,gBAAgB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;iBACpC;aACF;YAAC,OAAO,GAAG,EAAE;gBACZ,mBAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;aACvB;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,SAAS,SAAS,CAAC,MAAc;QAC/B,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,EAAE,CAAA;QACzC,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACvE,UAAU,GAAG,CAAC,CAAA;IAChB,CAAC;IAED,+BAA+B;IAC/B,SAAS,gBAAgB,CAAC,SAAgC,EAAE,MAAc;QACxE,mBAAW,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAA;QAEhD,MAAM,WAAW,GAAW,eAAe,CAAC,MAAM,CAAC,CAAA;QAEnD,wFAAwF;QACxF,6BAA6B;QAC7B,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;QACrD,WAAW,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA;QAE7D,SAAS,CAAC,mBAAmB,CAAC;YAC5B,OAAO,EAAE,iDAAiD;YAC1D,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;SAC/C,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,MAAM,KAAI,CAAC;QACX,UAAU;QACV,SAAS;QACT,aAAa;KACd,CAAA;AACH,CAAC;AAxED,oEAwEC"}

package/dist/lib/decentraland/communications/player-entity-manager.d.ts

@@ -0,0 +1,55 @@
+import { Entity } from "../types";
+export declare namespace EntityUtils {
+    function fromEntityId(entityId: Entity): [number, number];
+    function toEntityId(entityNumber: number, entityVersion: number): Entity;
+}
+export declare class PlayerEntityManager {
+    private allocatedEntities;
+    private addressToEntityMap;
+    private entityToAddressMap;
+    private entityVersions;
+    private nextEntityNumber;
+    /**
+     * 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: string, isLocalPlayer?: boolean): Entity | null;
+    /**
+     * Frees the entity allocated to a player address
+     */
+    freeEntityForPlayer(address: string): void;
+    /**
+     * Gets the player address for a given entity ID
+     */
+    getAddressForEntity(entityId: Entity): string | null;
+    /**
+     * Gets the entity ID for a given player address
+     */
+    getEntityForAddress(address: string): Entity | null;
+    /**
+     * Checks if an entity ID is a reserved player entity
+     */
+    isPlayerEntity(entityId: Entity): boolean;
+    /**
+     * Gets all allocated player entities
+     */
+    getAllPlayerEntities(): Map<Entity, string>;
+    /**
+     * Gets entity state information for debugging
+     */
+    getEntityInfo(entityId: Entity): {
+        number: number;
+        version: number;
+        allocated: boolean;
+    };
+    /**
+     * Clears all reserved entities (for cleanup)
+     */
+    clear(): void;
+    /**
+     * Gets all allocated entities
+     */
+    getAllocatedEntities(): Set<Entity>;
+}
+export declare const playerEntityManager: PlayerEntityManager;
+//# sourceMappingURL=player-entity-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"player-entity-manager.d.ts","sourceRoot":"","sources":["../../../../src/lib/decentraland/communications/player-entity-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAMjC,yBAAiB,WAAW,CAAC;IAC3B,SAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/D;IAED,SAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAE9E;CACF;AAOD,qBAAa,mBAAmB;IAE9B,OAAO,CAAC,iBAAiB,CAAoB;IAG7C,OAAO,CAAC,kBAAkB,CAA4B;IAGtD,OAAO,CAAC,kBAAkB,CAA4B;IAGtD,OAAO,CAAC,cAAc,CAA4B;IAGlD,OAAO,CAAC,gBAAgB,CAA6B;IAErD;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,GAAE,OAAe,GAAG,MAAM,GAAG,IAAI;IAqDvF;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAyB1C;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIpD;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOzC;;OAEG;IACH,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI3C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;IASxF;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,oBAAoB,IAAI,GAAG,CAAC,MAAM,CAAC;CAGpC;AAGD,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}