@dcl/sdk 7.3.40-7698451743.commit-c9c61fe → 7.3.40-7717066166.commit-ece036d

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dcl/sdk",
   "description": "",
-  "version": "7.3.40-7698451743.commit-c9c61fe",
+  "version": "7.3.40-7717066166.commit-ece036d",
   "author": "Decentraland",
   "dependencies": {
-    "@dcl/ecs": "7.3.40-7698451743.commit-c9c61fe",
+    "@dcl/ecs": "7.3.40-7717066166.commit-ece036d",
     "@dcl/ecs-math": "2.0.2",
     "@dcl/explorer": "1.0.159327-20240122142059.commit-58ce257",
-    "@dcl/js-runtime": "7.3.40-7698451743.commit-c9c61fe",
-    "@dcl/react-ecs": "7.3.40-7698451743.commit-c9c61fe",
-    "@dcl/sdk-commands": "7.3.40-7698451743.commit-c9c61fe",
+    "@dcl/js-runtime": "7.3.40-7717066166.commit-ece036d",
+    "@dcl/react-ecs": "7.3.40-7717066166.commit-ece036d",
+    "@dcl/sdk-commands": "7.3.40-7717066166.commit-ece036d",
     "text-encoding": "0.7.0"
   },
   "keywords": [],
@@ -35,5 +35,5 @@
   },
   "types": "./index.d.ts",
   "typings": "./index.d.ts",
-  "commit": "c9c61fe791438f55937546344bdd16b4f8f0cd6c"
+  "commit": "ece036db9e954a6f07bc175aa6f139d48680be87"
 }

package/players/index.d.ts

@@ -0,0 +1,23 @@
+import { Entity, TransformType } from '@dcl/ecs';
+import { PBAvatarBase, PBAvatarEquippedData } from '@dcl/ecs/dist/components';
+type GetPlayerDataReq = {
+    userId: string;
+};
+type GetPlayerDataRes = {
+    entity: Entity;
+    name: string;
+    isGuest: boolean;
+    userId: string;
+    avatar?: PBAvatarBase;
+    wearables: PBAvatarEquippedData['wearableUrns'];
+    emotes: PBAvatarEquippedData['emoteUrns'];
+    position: TransformType['position'] | undefined;
+};
+declare const players: {
+    onEnterScene(cb: (player: GetPlayerDataRes) => void): void;
+    onLeaveScene(cb: (userId: string) => void): void;
+    getPlayer(user?: GetPlayerDataReq): GetPlayerDataRes | null;
+};
+declare const getPlayer: (user?: GetPlayerDataReq) => GetPlayerDataRes | null, onEnterScene: (cb: (player: GetPlayerDataRes) => void) => void, onLeaveScene: (cb: (userId: string) => void) => void;
+export { getPlayer, onEnterScene, onLeaveScene };
+export default players;

package/players/index.js

@@ -0,0 +1,73 @@
+import { engine } from '@dcl/ecs';
+import { PlayerIdentityData as definePlayerIdenityData, AvatarBase as defineAvatarBase, AvatarEquippedData as defineAvatarEquippedData, Transform as defineTransform } from '@dcl/ecs/dist/components';
+function definePlayerHelper(engine) {
+    const Transform = defineTransform(engine);
+    const PlayerIdentityData = definePlayerIdenityData(engine);
+    const AvatarEquippedData = defineAvatarEquippedData(engine);
+    const AvatarBase = defineAvatarBase(engine);
+    const playerEntities = new Map();
+    let onEnterSceneCb = undefined;
+    let onLeaveSceneCb = undefined;
+    engine.addSystem(() => {
+        const players = Array.from(engine.getEntitiesWith(PlayerIdentityData, AvatarBase));
+        if (players.length === playerEntities.size)
+            return;
+        for (const [entity, identity] of players) {
+            if (!playerEntities.has(entity)) {
+                playerEntities.set(entity, identity.address);
+                if (onEnterSceneCb) {
+                    onEnterSceneCb(getPlayer({ userId: identity.address }));
+                }
+                AvatarBase.onChange(entity, (value) => {
+                    if (!value && onLeaveSceneCb && playerEntities.get(entity)) {
+                        onLeaveSceneCb(playerEntities.get(entity));
+                        playerEntities.delete(entity);
+                    }
+                });
+            }
+        }
+    });
+    return {
+        onEnterScene(cb) {
+            onEnterSceneCb = cb;
+        },
+        onLeaveScene(cb) {
+            onLeaveSceneCb = cb;
+        },
+        getPlayer(user) {
+            function getEntity() {
+                if (!user?.userId)
+                    return engine.PlayerEntity;
+                for (const [entity, data] of engine.getEntitiesWith(PlayerIdentityData)) {
+                    if (data.address === user.userId) {
+                        return entity;
+                    }
+                }
+                return undefined;
+            }
+            const userEntity = getEntity();
+            if (!userEntity)
+                return null;
+            const playerData = PlayerIdentityData.getOrNull(userEntity);
+            const avatarData = AvatarBase.getOrNull(userEntity);
+            const wearablesData = AvatarEquippedData.getOrNull(userEntity);
+            if (!playerData && !avatarData && !wearablesData)
+                return null;
+            return {
+                entity: userEntity,
+                name: avatarData?.name ?? '',
+                isGuest: !!playerData?.isGuest ?? false,
+                userId: playerData?.address ?? '',
+                avatar: avatarData ?? undefined,
+                wearables: wearablesData?.wearableUrns ?? [],
+                emotes: wearablesData?.emoteUrns ?? [],
+                position: Transform.getOrNull(userEntity)?.position
+            };
+        }
+    };
+}
+const players = definePlayerHelper(engine);
+const { getPlayer, onEnterScene, onLeaveScene } = players;
+export { getPlayer, onEnterScene, onLeaveScene };
+export default players;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcGxheWVycy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQWtDLE1BQU0sRUFBRSxNQUFNLFVBQVUsQ0FBQTtBQUNqRSxPQUFPLEVBQ0wsa0JBQWtCLElBQUksdUJBQXVCLEVBQzdDLFVBQVUsSUFBSSxnQkFBZ0IsRUFDOUIsa0JBQWtCLElBQUksd0JBQXdCLEVBRzlDLFNBQVMsSUFBSSxlQUFlLEVBQzdCLE1BQU0sMEJBQTBCLENBQUE7QUFnQmpDLFNBQVMsa0JBQWtCLENBQUMsTUFBZTtJQUN6QyxNQUFNLFNBQVMsR0FBRyxlQUFlLENBQUMsTUFBTSxDQUFDLENBQUE7SUFDekMsTUFBTSxrQkFBa0IsR0FBRyx1QkFBdUIsQ0FBQyxNQUFNLENBQUMsQ0FBQTtJQUMxRCxNQUFNLGtCQUFrQixHQUFHLHdCQUF3QixDQUFDLE1BQU0sQ0FBQyxDQUFBO0lBQzNELE1BQU0sVUFBVSxHQUFHLGdCQUFnQixDQUFDLE1BQU0sQ0FBQyxDQUFBO0lBQzNDLE1BQU0sY0FBYyxHQUFHLElBQUksR0FBRyxFQUFrQixDQUFBO0lBQ2hELElBQUksY0FBYyxHQUFxRCxTQUFTLENBQUE7SUFDaEYsSUFBSSxjQUFjLEdBQTJDLFNBQVMsQ0FBQTtJQUV0RSxNQUFNLENBQUMsU0FBUyxDQUFDLEdBQUcsRUFBRTtRQUNwQixNQUFNLE9BQU8sR0FBRyxLQUFLLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxlQUFlLENBQUMsa0JBQWtCLEVBQUUsVUFBVSxDQUFDLENBQUMsQ0FBQTtRQUNsRixJQUFJLE9BQU8sQ0FBQyxNQUFNLEtBQUssY0FBYyxDQUFDLElBQUk7WUFBRSxPQUFNO1FBRWxELEtBQUssTUFBTSxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsSUFBSSxPQUFPLEVBQUU7WUFDeEMsSUFBSSxDQUFDLGNBQWMsQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLEVBQUU7Z0JB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bmdpbmUsIFRyYW5zZm9ybVR5cGUsIGVuZ2luZSB9IGZyb20gJ0BkY2wvZWNzJ1xuaW1wb3J0IHtcbiAgUGxheWVySWRlbnRpdHlEYXRhIGFzIGRlZmluZVBsYXllcklkZW5pdHlEYXRhLFxuICBBdmF0YXJCYXNlIGFzIGRlZmluZUF2YXRhckJhc2UsXG4gIEF2YXRhckVxdWlwcGVkRGF0YSBhcyBkZWZpbmVBdmF0YXJFcXVpcHBlZERhdGEsXG4gIFBCQXZhdGFyQmFzZSxcbiAgUEJBdmF0YXJFcXVpcHBlZERhdGEsXG4gIFRyYW5zZm9ybSBhcyBkZWZpbmVUcmFuc2Zvcm1cbn0gZnJvbSAnQGRjbC9lY3MvZGlzdC9jb21wb25lbnRzJ1xuXG50eXBlIEdldFBsYXllckRhdGFSZXEgPSB7XG4gIHVzZXJJZDogc3RyaW5nXG59XG50eXBlIEdldFBsYXllckRhdGFSZXMgPSB7XG4gIGVudGl0eTogRW50aXR5XG4gIG5hbWU6IHN0cmluZ1xuICBpc0d1ZXN0OiBib29sZWFuXG4gIHVzZXJJZDogc3RyaW5nXG4gIGF2YXRhcj86IFBCQXZhdGFyQmFzZVxuICB3ZWFyYWJsZXM6IFBCQXZhdGFyRXF1aXBwZWREYXRhWyd3ZWFyYWJsZVVybnMnXVxuICBlbW90ZXM6IFBCQXZhdGFyRXF1aXBwZWREYXRhWydlbW90ZVVybnMnXVxuICBwb3NpdGlvbjogVHJhbnNmb3JtVHlwZVsncG9zaXRpb24nXSB8IHVuZGVmaW5lZFxufVxuXG5mdW5jdGlvbiBkZWZpbmVQbGF5ZXJIZWxwZXIoZW5naW5lOiBJRW5naW5lKSB7XG4gIGNvbnN0IFRyYW5zZm9ybSA9IGRlZmluZVRyYW5zZm9ybShlbmdpbmUpXG4gIGNvbnN0IFBsYXllcklkZW50aXR5RGF0YSA9IGRlZmluZVBsYXllcklkZW5pdHlEYXRhKGVuZ2luZSlcbiAgY29uc3QgQXZhdGFyRXF1aXBwZWREYXRhID0gZGVmaW5lQXZhdGFyRXF1aXBwZWREYXRhKGVuZ2luZSlcbiAgY29uc3QgQXZhdGFyQmFzZSA9IGRlZmluZUF2YXRhckJhc2UoZW5naW5lKVxuICBjb25zdCBwbGF5ZXJFbnRpdGllcyA9IG5ldyBNYXA8RW50aXR5LCBzdHJpbmc+KClcbiAgbGV0IG9uRW50ZXJTY2VuZUNiOiAoKHBsYXllcjogR2V0UGxheWVyRGF0YVJlcykgPT4gdm9pZCkgfCB1bmRlZmluZWQgPSB1bmRlZmluZWRcbiAgbGV0IG9uTGVhdmVTY2VuZUNiOiAoKHVzZXJJZDogc3RyaW5nKSA9PiB2b2lkKSB8IHVuZGVmaW5lZCA9IHVuZGVmaW5lZFxuXG4gIGVuZ2luZS5hZGRTeXN0ZW0oKCkgPT4ge1xuICAgIGNvbnN0IHBsYXllcnMgPSBBcnJheS5mcm9tKGVuZ2luZS5nZXRFbnRpdGllc1dpdGgoUGxheWVySWRlbnRpdHlEYXRhLCBBdmF0YXJCYXNlKSlcbiAgICBpZiAocGxheWVycy5sZW5ndGggPT09IHBsYXllckVudGl0aWVzLnNpemUpIHJldHVyblxuXG4gICAgZm9yIChjb25zdCBbZW50aXR5LCBpZGVudGl0eV0gb2YgcGxheWVycykge1xuICAgICAgaWYgKCFwbGF5ZXJFbnRpdGllcy5oYXMoZW50aXR5KSkge1xuICAgICAgICBwbGF5ZXJFbnRpdGllcy5zZXQoZW50aXR5LCBpZGVudGl0eS5hZGRyZXNzKVxuXG4gICAgICAgIC8vIENhbGwgb25FbnRlciBjYWxsYmFja1xuICAgICAgICBpZiAob25FbnRlclNjZW5lQ2IpIHtcbiAgICAgICAgICBvbkVudGVyU2NlbmVDYihnZXRQbGF5ZXIoeyB1c2VySWQ6IGlkZW50aXR5LmFkZHJlc3MgfSkhKVxuICAgICAgICB9XG5cbiAgICAgICAgLy8gQ2hlY2sgZm9yIGNoYW5nZXMvcmVtb3ZlIGNhbGxiYWNrc1xuICAgICAgICBBdmF0YXJCYXNlLm9uQ2hhbmdlKGVudGl0eSwgKHZhbHVlKSA9PiB7XG4gICAgICAgICAgaWYgKCF2YWx1ZSAmJiBvbkxlYXZlU2NlbmVDYiAmJiBwbGF5ZXJFbnRpdGllcy5nZXQoZW50aXR5KSkge1xuICAgICAgICAgICAgb25MZWF2ZVNjZW5lQ2IocGxheWVyRW50aXRpZXMuZ2V0KGVudGl0eSkhKVxuICAgICAgICAgICAgcGxheWVyRW50aXRpZXMuZGVsZXRlKGVudGl0eSlcbiAgICAgICAgICB9XG4gICAgICAgIH0pXG4gICAgICB9XG4gICAgfVxuICB9KVxuXG4gIHJldHVybiB7XG4gICAgb25FbnRlclNjZW5lKGNiOiAocGxheWVyOiBHZXRQbGF5ZXJEYXRhUmVzKSA9PiB2b2lkKSB7XG4gICAgICBvbkVudGVyU2NlbmVDYiA9IGNiXG4gICAgfSxcbiAgICBvbkxlYXZlU2NlbmUoY2I6ICh1c2VySWQ6IHN0cmluZykgPT4gdm9pZCkge1xuICAgICAgb25MZWF2ZVNjZW5lQ2IgPSBjYlxuICAgIH0sXG4gICAgLyoqXG4gICAgICogUmV0dXJucyB0aGUgaW5mbyBvZiB0aGUgcGxheWVyIGlmIGl0J3MgaW4gdGhlIHNjZW5lLlxuICAgICAqL1xuICAgIGdldFBsYXllcih1c2VyPzogR2V0UGxheWVyRGF0YVJlcSk6IEdldFBsYXllckRhdGFSZXMgfCBudWxsIHtcbiAgICAgIGZ1bmN0aW9uIGdldEVudGl0eSgpIHtcbiAgICAgICAgaWYgKCF1c2VyPy51c2VySWQpIHJldHVybiBlbmdpbmUuUGxheWVyRW50aXR5XG4gICAgICAgIGZvciAoY29uc3QgW2VudGl0eSwgZGF0YV0gb2YgZW5naW5lLmdldEVudGl0aWVzV2l0aChQbGF5ZXJJZGVudGl0eURhdGEpKSB7XG4gICAgICAgICAgaWYgKGRhdGEuYWRkcmVzcyA9PT0gdXNlci51c2VySWQpIHtcbiAgICAgICAgICAgIHJldHVybiBlbnRpdHlcbiAgICAgICAgICB9XG4gICAgICAgIH1cbiAgICAgICAgcmV0dXJuIHVuZGVmaW5lZFxuICAgICAgfVxuXG4gICAgICBjb25zdCB1c2VyRW50aXR5ID0gZ2V0RW50aXR5KClcbiAgICAgIGlmICghdXNlckVudGl0eSkgcmV0dXJuIG51bGxcblxuICAgICAgY29uc3QgcGxheWVyRGF0YSA9IFBsYXllcklkZW50aXR5RGF0YS5nZXRPck51bGwodXNlckVudGl0eSlcbiAgICAgIGNvbnN0IGF2YXRhckRhdGEgPSBBdmF0YXJCYXNlLmdldE9yTnVsbCh1c2VyRW50aXR5KVxuICAgICAgY29uc3Qgd2VhcmFibGVzRGF0YSA9IEF2YXRhckVxdWlwcGVkRGF0YS5nZXRPck51bGwodXNlckVudGl0eSlcblxuICAgICAgaWYgKCFwbGF5ZXJEYXRhICYmICFhdmF0YXJEYXRhICYmICF3ZWFyYWJsZXNEYXRhKSByZXR1cm4gbnVsbFxuXG4gICAgICByZXR1cm4ge1xuICAgICAgICBlbnRpdHk6IHVzZXJFbnRpdHksXG4gICAgICAgIG5hbWU6IGF2YXRhckRhdGE/Lm5hbWUgPz8gJycsXG4gICAgICAgIGlzR3Vlc3Q6ICEhcGxheWVyRGF0YT8uaXNHdWVzdCA/PyBmYWxzZSxcbiAgICAgICAgdXNlcklkOiBwbGF5ZXJEYXRhPy5hZGRyZXNzID8/ICcnLFxuICAgICAgICBhdmF0YXI6IGF2YXRhckRhdGEgPz8gdW5kZWZpbmVkLFxuICAgICAgICB3ZWFyYWJsZXM6IHdlYXJhYmxlc0RhdGE/LndlYXJhYmxlVXJucyA/PyBbXSxcbiAgICAgICAgZW1vdGVzOiB3ZWFyYWJsZXNEYXRhPy5lbW90ZVVybnMgPz8gW10sXG4gICAgICAgIHBvc2l0aW9uOiBUcmFuc2Zvcm0uZ2V0T3JOdWxsKHVzZXJFbnRpdHkpPy5wb3NpdGlvblxuICAgICAgfVxuICAgIH1cbiAgfVxufVxuXG5jb25zdCBwbGF5ZXJzID0gZGVmaW5lUGxheWVySGVscGVyKGVuZ2luZSlcbmNvbnN0IHsgZ2V0UGxheWVyLCBvbkVudGVyU2NlbmUsIG9uTGVhdmVTY2VuZSB9ID0gcGxheWVyc1xuXG5leHBvcnQgeyBnZXRQbGF5ZXIsIG9uRW50ZXJTY2VuZSwgb25MZWF2ZVNjZW5lIH1cbmV4cG9ydCBkZWZhdWx0IHBsYXllcnNcbiJdfQ==

package/src/players/index.ts

@@ -0,0 +1,106 @@
+import { Entity, IEngine, TransformType, engine } from '@dcl/ecs'
+import {
+  PlayerIdentityData as definePlayerIdenityData,
+  AvatarBase as defineAvatarBase,
+  AvatarEquippedData as defineAvatarEquippedData,
+  PBAvatarBase,
+  PBAvatarEquippedData,
+  Transform as defineTransform
+} from '@dcl/ecs/dist/components'
+
+type GetPlayerDataReq = {
+  userId: string
+}
+type GetPlayerDataRes = {
+  entity: Entity
+  name: string
+  isGuest: boolean
+  userId: string
+  avatar?: PBAvatarBase
+  wearables: PBAvatarEquippedData['wearableUrns']
+  emotes: PBAvatarEquippedData['emoteUrns']
+  position: TransformType['position'] | undefined
+}
+
+function definePlayerHelper(engine: IEngine) {
+  const Transform = defineTransform(engine)
+  const PlayerIdentityData = definePlayerIdenityData(engine)
+  const AvatarEquippedData = defineAvatarEquippedData(engine)
+  const AvatarBase = defineAvatarBase(engine)
+  const playerEntities = new Map<Entity, string>()
+  let onEnterSceneCb: ((player: GetPlayerDataRes) => void) | undefined = undefined
+  let onLeaveSceneCb: ((userId: string) => void) | undefined = undefined
+
+  engine.addSystem(() => {
+    const players = Array.from(engine.getEntitiesWith(PlayerIdentityData, AvatarBase))
+    if (players.length === playerEntities.size) return
+
+    for (const [entity, identity] of players) {
+      if (!playerEntities.has(entity)) {
+        playerEntities.set(entity, identity.address)
+
+        // Call onEnter callback
+        if (onEnterSceneCb) {
+          onEnterSceneCb(getPlayer({ userId: identity.address })!)
+        }
+
+        // Check for changes/remove callbacks
+        AvatarBase.onChange(entity, (value) => {
+          if (!value && onLeaveSceneCb && playerEntities.get(entity)) {
+            onLeaveSceneCb(playerEntities.get(entity)!)
+            playerEntities.delete(entity)
+          }
+        })
+      }
+    }
+  })
+
+  return {
+    onEnterScene(cb: (player: GetPlayerDataRes) => void) {
+      onEnterSceneCb = cb
+    },
+    onLeaveScene(cb: (userId: string) => void) {
+      onLeaveSceneCb = cb
+    },
+    /**
+     * Returns the info of the player if it's in the scene.
+     */
+    getPlayer(user?: GetPlayerDataReq): GetPlayerDataRes | null {
+      function getEntity() {
+        if (!user?.userId) return engine.PlayerEntity
+        for (const [entity, data] of engine.getEntitiesWith(PlayerIdentityData)) {
+          if (data.address === user.userId) {
+            return entity
+          }
+        }
+        return undefined
+      }
+
+      const userEntity = getEntity()
+      if (!userEntity) return null
+
+      const playerData = PlayerIdentityData.getOrNull(userEntity)
+      const avatarData = AvatarBase.getOrNull(userEntity)
+      const wearablesData = AvatarEquippedData.getOrNull(userEntity)
+
+      if (!playerData && !avatarData && !wearablesData) return null
+
+      return {
+        entity: userEntity,
+        name: avatarData?.name ?? '',
+        isGuest: !!playerData?.isGuest ?? false,
+        userId: playerData?.address ?? '',
+        avatar: avatarData ?? undefined,
+        wearables: wearablesData?.wearableUrns ?? [],
+        emotes: wearablesData?.emoteUrns ?? [],
+        position: Transform.getOrNull(userEntity)?.position
+      }
+    }
+  }
+}
+
+const players = definePlayerHelper(engine)
+const { getPlayer, onEnterScene, onLeaveScene } = players
+
+export { getPlayer, onEnterScene, onLeaveScene }
+export default players