@dcl/ecs 7.29.1-35862852104.commit-1f44e80 → 7.29.1-35917671376.commit-046b268

package/dist/systems/crdt/index.js

@@ -1,17 +1,24 @@
 import { EntityState } from '../../engine/entity';
 import { ReadWriteByteBuffer } from '../../serialization/ByteBuffer';
-import { AppendValueOperation, CrdtMessageProtocol } from '../../serialization/crdt';
+import { AppendValueOperation, CrdtMessageProtocol, DeleteComponentNetwork, DeleteEntityNetwork } from '../../serialization/crdt';
 import { DeleteComponent } from '../../serialization/crdt/deleteComponent';
 import { DeleteEntity } from '../../serialization/crdt/deleteEntity';
 import { PutComponentOperation } from '../../serialization/crdt/putComponent';
-import { AuthoritativePutComponentOperation } from '../../serialization/crdt/authoritativePutComponent';
 import { CrdtMessageType } from '../../serialization/crdt/types';
+import { PutNetworkComponentOperation } from '../../serialization/crdt/network/putComponentNetwork';
+import { NetworkEntity as defineNetworkEntity, NetworkParent as defineNetworkParent, Transform as defineTransform } from '../../components';
+import * as networkUtils from '../../serialization/crdt/network/utils';
+// NetworkMessages can only have a MAX_SIZE of 12kb. So we need to send it in chunks.
+export const LIVEKIT_MAX_SIZE = 12;
 /**
  * @internal
  */
 export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
     const transports = [];
-    // No network components needed - pure CRDT processing only
+    // Components that we used on this system
+    const NetworkEntity = defineNetworkEntity(engine);
+    const NetworkParent = defineNetworkParent(engine);
+    const Transform = defineTransform(engine);
     // Messages that we received at transport.onMessage waiting to be processed
     const receivedMessages = [];
     // Messages already processed by the engine but that we need to broadcast to other transports.
@@ -36,20 +43,27 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
                 if (header.type === CrdtMessageType.DELETE_COMPONENT) {
                     message = DeleteComponent.read(buffer);
                 }
+                else if (header.type === CrdtMessageType.DELETE_COMPONENT_NETWORK) {
+                    message = DeleteComponentNetwork.read(buffer);
+                }
                 else if (header.type === CrdtMessageType.PUT_COMPONENT) {
                     message = PutComponentOperation.read(buffer);
                 }
-                else if (header.type === CrdtMessageType.AUTHORITATIVE_PUT_COMPONENT) {
-                    message = AuthoritativePutComponentOperation.read(buffer);
+                else if (header.type === CrdtMessageType.PUT_COMPONENT_NETWORK) {
+                    message = PutNetworkComponentOperation.read(buffer);
                 }
                 else if (header.type === CrdtMessageType.DELETE_ENTITY) {
                     message = DeleteEntity.read(buffer);
                 }
+                else if (header.type === CrdtMessageType.DELETE_ENTITY_NETWORK) {
+                    message = DeleteEntityNetwork.read(buffer);
+                }
                 else if (header.type === CrdtMessageType.APPEND_VALUE) {
                     message = AppendValueOperation.read(buffer);
+                    // Unknown message, we skip it
                 }
                 else {
-                    // Unknown message, we skip it (including NETWORK messages)
+                    // consume the message
                     buffer.incrementReadOffset(header.length);
                 }
                 if (message) {
@@ -71,12 +85,20 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
         return messagesToProcess;
     }
     /**
-     * Reserved-range entities (root/player/camera + avatars, entity number <
-     * RESERVED_STATIC_ENTITIES) are host-owned: only a transport flagged with
-     * `allowReservedEntities` (the host/renderer) may mutate or delete them.
+     * Find the local entityId associated to the network component message.
+     * It's a mapping Network -> to Local
+     * If it's not a network message, return the entityId received by the message
      */
-    function isTrustedForReservedEntities(transportId) {
-        return transportId !== undefined && !!transports[transportId]?.allowReservedEntities;
+    function findNetworkId(msg) {
+        const hasNetworkId = 'networkId' in msg;
+        if (hasNetworkId) {
+            for (const [entityId, network] of engine.getEntitiesWith(NetworkEntity)) {
+                if (network.networkId === msg.networkId && network.entityId === msg.entityId) {
+                    return { entityId, network };
+                }
+            }
+        }
+        return { entityId: msg.entityId };
     }
     /**
      * This fn will be called on every tick.
@@ -86,68 +108,46 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
         const messagesToProcess = getMessages(receivedMessages);
         const entitiesShouldBeCleaned = [];
         for (const msg of messagesToProcess) {
-            // Simple CRDT processing - no network logic
-            if (msg.type === CrdtMessageType.DELETE_ENTITY) {
-                // Reject an inbound DELETE_ENTITY on a reserved entity from an untrusted
-                // transport (a comms peer, or a scene-added transport). The allocator half
-                // is already guarded (engine.removeEntity is a no-op on this range); this
-                // closes the receive-side half.
-                const isReserved = engine.entityContainer.getEntityState(msg.entityId) === EntityState.Reserved;
-                if (isReserved && !isTrustedForReservedEntities(msg.transportId)) {
-                    continue;
-                }
-                entitiesShouldBeCleaned.push(msg.entityId);
+            let { entityId, network } = findNetworkId(msg);
+            // We receive a new Entity. Create the localEntity and map it to the NetworkEntity component
+            if (networkUtils.isNetworkMessage(msg) && !network) {
+                entityId = engine.addEntity();
+                network = { entityId: msg.entityId, networkId: msg.networkId };
+                NetworkEntity.createOrReplace(entityId, network);
+            }
+            if (msg.type === CrdtMessageType.DELETE_ENTITY || msg.type === CrdtMessageType.DELETE_ENTITY_NETWORK) {
+                entitiesShouldBeCleaned.push(entityId);
                 broadcastMessages.push(msg);
             }
             else {
-                const entityState = engine.entityContainer.getEntityState(msg.entityId);
-                // Skip updates from removed entities
+                const entityState = engine.entityContainer.getEntityState(entityId);
+                // Skip updates from removed entityes
                 if (entityState === EntityState.Removed)
                     continue;
-                // Reject component operations (PUT/DELETE/APPEND, including AUTHORITATIVE_PUT
-                // which bypasses timestamps entirely) on reserved entities from untrusted
-                // transports. Dropping before updateFromCrdt keeps local LWW timestamps
-                // unpoisoned by forged high timestamps, and also prevents the
-                // unknown-component rebroadcast below from relaying forged reserved-entity
-                // data to other transports (including the renderer).
-                if (entityState === EntityState.Reserved && !isTrustedForReservedEntities(msg.transportId))
-                    continue;
-                // Entities with unknown state should update its entity state
+                // Entities with unknown entities should update its entity state
                 if (entityState === EntityState.Unknown) {
-                    engine.entityContainer.updateUsedEntity(msg.entityId);
-                }
-                // Only process component-related messages (not DELETE_ENTITY)
-                if ('componentId' in msg) {
-                    const component = engine.getComponentOrNull(msg.componentId);
-                    if (component) {
-                        // Handle authoritative messages differently - they force the state regardless of timestamp
-                        const tryUpdate = () => {
-                            try {
-                                return msg.type === CrdtMessageType.AUTHORITATIVE_PUT_COMPONENT
-                                    ? component.__forceUpdateFromCrdt(msg)
-                                    : component.updateFromCrdt(msg);
-                            }
-                            catch (e) {
-                                console.error('[receiveMessages] ERROR processing message', msg, e);
-                                return null;
-                            }
-                        };
-                        const result = tryUpdate();
-                        if (!result)
-                            continue;
-                        const [conflictMessage, value] = result;
-                        if (!conflictMessage) {
-                            // Add message to broadcast queue when no conflict
-                            broadcastMessages.push(msg);
-                            onProcessEntityComponentChange && onProcessEntityComponentChange(msg.entityId, msg.type, component, value);
-                        }
+                    engine.entityContainer.updateUsedEntity(entityId);
+                }
+                const component = engine.getComponentOrNull(msg.componentId);
+                /* istanbul ignore else */
+                if (component) {
+                    if (msg.type === CrdtMessageType.PUT_COMPONENT &&
+                        component.componentId === Transform.componentId &&
+                        NetworkEntity.has(entityId) &&
+                        NetworkParent.has(entityId)) {
+                        msg.data = networkUtils.fixTransformParent(msg);
                     }
-                    else {
-                        // Component not found - still broadcast for editor compatibility
-                        /* istanbul ignore next */
+                    const [conflictMessage, value] = component.updateFromCrdt({ ...msg, entityId });
+                    if (!conflictMessage) {
+                        // Add message to transport queue to be processed by others transports
                         broadcastMessages.push(msg);
+                        onProcessEntityComponentChange && onProcessEntityComponentChange(entityId, msg.type, component, value);
                     }
                 }
+                else {
+                    // TODO: test this line, it is fundammental to make the editor work
+                    broadcastMessages.push(msg);
+                }
             }
         }
         // the last stage of the syncrhonization is to delete the entities
@@ -161,17 +161,16 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
         }
     }
     /**
-     * Simple CRDT message broadcasting - no network-specific logic
+     * Iterates the dirty map and generates crdt messages to be send
      */
     async function sendMessages(entitiesDeletedThisTick) {
-        // Get messages from broadcast queue and component updates
+        // CRDT Messages will be the merge between the recieved transport messages and the new crdt messages
         const crdtMessages = getMessages(broadcastMessages);
         const buffer = new ReadWriteByteBuffer();
-        // Generate CRDT messages from component updates
         for (const component of engine.componentsIter()) {
             for (const message of component.getCrdtUpdates()) {
                 const offset = buffer.currentWriteOffset();
-                // Only create messages if there's a transport that will handle it
+                // Avoid creating messages if there is no transport that will handle it
                 if (transports.some((t) => t.filter(message))) {
                     if (message.type === CrdtMessageType.PUT_COMPONENT) {
                         PutComponentOperation.write(message.entityId, message.timestamp, message.componentId, message.data, buffer);
@@ -195,7 +194,7 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
                 }
             }
         }
-        // Handle deleted entities
+        // After all updates, I execute the DeletedEntity messages
         for (const entityId of entitiesDeletedThisTick) {
             const offset = buffer.currentWriteOffset();
             DeleteEntity.write(entityId, buffer);
@@ -206,19 +205,87 @@ export function crdtSceneSystem(engine, onProcessEntityComponentChange) {
             });
             onProcessEntityComponentChange && onProcessEntityComponentChange(entityId, CrdtMessageType.DELETE_ENTITY);
         }
-        // Simple transport broadcasting - no network-specific transforms
-        for (const transport of transports) {
-            const transportBuffer = new ReadWriteByteBuffer();
+        // Send CRDT messages to transports
+        const transportBuffer = new ReadWriteByteBuffer();
+        for (const index in transports) {
+            const __NetworkMessagesBuffer = [];
+            const transportIndex = Number(index);
+            const transport = transports[transportIndex];
+            const isRendererTransport = transport.type === 'renderer';
+            const isNetworkTransport = transport.type === 'network';
+            // Reset Buffer for each Transport
+            transportBuffer.resetBuffer();
+            const buffer = new ReadWriteByteBuffer();
+            // Then we send all the new crdtMessages that the transport needs to process
             for (const message of crdtMessages) {
                 // Avoid echo messages
-                if (message.transportId === transports.indexOf(transport))
+                if (message.transportId === transportIndex)
                     continue;
-                // Check if transport wants this message
-                if (transport.filter(message)) {
-                    transportBuffer.writeBuffer(message.messageBuffer, false);
+                // Redundant message for the transport
+                if (!transport.filter(message))
+                    continue;
+                // Check if adding this message would exceed the size limit
+                const currentBufferSize = transportBuffer.toBinary().byteLength;
+                const messageSize = message.messageBuffer.byteLength;
+                if (isNetworkTransport && (currentBufferSize + messageSize) / 1024 > LIVEKIT_MAX_SIZE) {
+                    // If the current buffer has content, save it as a chunk
+                    if (currentBufferSize > 0) {
+                        __NetworkMessagesBuffer.push(transportBuffer.toCopiedBinary());
+                        transportBuffer.resetBuffer();
+                    }
+                    // If the message itself is larger than the limit, we need to handle it specially
+                    // For now, we'll skip it to prevent infinite loops
+                    if (messageSize / 1024 > LIVEKIT_MAX_SIZE) {
+                        console.error(`Message too large (${messageSize} bytes), skipping message for entity ${message.entityId}`);
+                        continue;
+                    }
                 }
+                const { entityId } = findNetworkId(message);
+                const transformNeedsFix = 'componentId' in message &&
+                    message.componentId === Transform.componentId &&
+                    Transform.has(entityId) &&
+                    NetworkParent.has(entityId) &&
+                    NetworkEntity.has(entityId);
+                // If there was a LOCAL change in the transform. Add the parent to that transform
+                if (isRendererTransport && message.type === CrdtMessageType.PUT_COMPONENT && transformNeedsFix) {
+                    const parent = findNetworkId(NetworkParent.get(entityId));
+                    const transformData = networkUtils.fixTransformParent(message, Transform.get(entityId), parent.entityId);
+                    const offset = buffer.currentWriteOffset();
+                    PutComponentOperation.write(entityId, message.timestamp, message.componentId, transformData, buffer);
+                    transportBuffer.writeBuffer(buffer.buffer().subarray(offset, buffer.currentWriteOffset()), false);
+                    continue;
+                }
+                if (isRendererTransport && networkUtils.isNetworkMessage(message)) {
+                    // If it's the renderer transport and its a NetworkMessage, we need to fix the entityId field and convert it to a known Message.
+                    // PUT_NETWORK_COMPONENT -> PUT_COMPONENT
+                    let transformData = 'data' in message ? message.data : new Uint8Array();
+                    if (transformNeedsFix) {
+                        const parent = findNetworkId(NetworkParent.get(entityId));
+                        transformData = networkUtils.fixTransformParent(message, Transform.get(entityId), parent.entityId);
+                    }
+                    networkUtils.networkMessageToLocal({ ...message, data: transformData }, entityId, buffer, transportBuffer);
+                    // Iterate the next message
+                    continue;
+                }
+                // If its a network transport and its a PUT_COMPONENT that has a NetworkEntity component, we need to send this message
+                // through comms with the EntityID and NetworkID from ther NetworkEntity so everyone can recieve this message and map to their custom entityID.
+                if (isNetworkTransport && !networkUtils.isNetworkMessage(message)) {
+                    const networkData = NetworkEntity.getOrNull(message.entityId);
+                    // If it has networkData convert the message to PUT_NETWORK_COMPONENT.
+                    if (networkData) {
+                        networkUtils.localMessageToNetwork(message, networkData, buffer, transportBuffer);
+                        // Iterate the next message
+                        continue;
+                    }
+                }
+                // Common message
+                transportBuffer.writeBuffer(message.messageBuffer, false);
+            }
+            if (isNetworkTransport && transportBuffer.currentWriteOffset()) {
+                __NetworkMessagesBuffer.push(transportBuffer.toBinary());
             }
-            await transport.send(transportBuffer.toBinary());
+            const message = isNetworkTransport ? __NetworkMessagesBuffer : transportBuffer.toBinary();
+            await transport.send(message);
         }
     }
     /**

package/dist/systems/crdt/types.d.ts

@@ -29,14 +29,4 @@ export type Transport = {
     onmessage?(message: Uint8Array): void;
     filter(message: Omit<TransportMessage, 'messageBuffer'>): boolean;
     type?: string;
-    /**
-     * Whether this transport is allowed to mutate reserved-range entities
-     * (root/player/camera + avatars, entity number below `RESERVED_STATIC_ENTITIES`).
-     * Only the trusted host/renderer transport sets this. An inbound DELETE_ENTITY
-     * or component operation (PUT_COMPONENT, DELETE_COMPONENT, APPEND_VALUE,
-     * AUTHORITATIVE_PUT_COMPONENT) on a reserved entity from a transport without
-     * this flag (a comms peer, or any scene-added transport) is rejected — see
-     * `receiveMessages`.
-     */
-    allowReservedEntities?: boolean;
 };

package/dist-cjs/components/generated/ExplorerItemPurchaseResult.gen.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-cjs/components/generated/ExplorerItemPurchaseResult.gen.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExplorerItemPurchaseResultSchema = void 0;
+const explorer_item_purchase_result_gen_1 = require("./pb/decentraland/sdk/components/explorer_item_purchase_result.gen");
+/**
+ * @internal
+ */
+exports.ExplorerItemPurchaseResultSchema = {
+    COMPONENT_ID: 1222,
+    serialize(value, builder) {
+        const writer = explorer_item_purchase_result_gen_1.PBExplorerItemPurchaseResult.encode(value);
+        const buffer = new Uint8Array(writer.finish(), 0, writer.len);
+        builder.writeBuffer(buffer, false);
+    },
+    deserialize(reader) {
+        return explorer_item_purchase_result_gen_1.PBExplorerItemPurchaseResult.decode(reader.buffer(), reader.remainingBytes());
+    },
+    create() {
+        // TODO: this is a hack.
+        return explorer_item_purchase_result_gen_1.PBExplorerItemPurchaseResult.decode(new Uint8Array());
+    },
+    jsonSchema: {
+        type: "object",
+        properties: {},
+        serializationType: "protocol-buffer",
+        protocolBuffer: "PBExplorerItemPurchaseResult"
+    }
+};

package/dist-cjs/components/generated/component-names.gen.js

@@ -25,6 +25,7 @@ exports.coreComponentMappings = {
     "core::CameraMode": 1072,
     "core::CameraModeArea": 1071,
     "core::EngineInfo": 1048,
+    "core::ExplorerItemPurchaseResult": 1222,
     "core::ExplorerUiEventsResult": 1220,
     "core::GltfContainer": 1041,
     "core::GltfContainerLoadingState": 1049,

package/dist-cjs/components/generated/global.gen.d.ts

@@ -18,6 +18,7 @@ import { PBBillboard } from './pb/decentraland/sdk/components/billboard.gen';
 import { PBCameraMode } from './pb/decentraland/sdk/components/camera_mode.gen';
 import { PBCameraModeArea } from './pb/decentraland/sdk/components/camera_mode_area.gen';
 import { PBEngineInfo } from './pb/decentraland/sdk/components/engine_info.gen';
+import { PBExplorerItemPurchaseResult } from './pb/decentraland/sdk/components/explorer_item_purchase_result.gen';
 import { PBExplorerUiEventsResult } from './pb/decentraland/sdk/components/explorer_ui_events_result.gen';
 import { PBGltfContainer } from './pb/decentraland/sdk/components/gltf_container.gen';
 import { PBGltfContainerLoadingState } from './pb/decentraland/sdk/components/gltf_container_loading_state.gen';
@@ -75,6 +76,7 @@ import { PBVisibilityComponent } from './pb/decentraland/sdk/components/visibili
 /** @public */ export declare const CameraMode: LastWriteWinElementSetComponentDefinition<PBCameraMode>;
 /** @public */ export declare const CameraModeArea: LastWriteWinElementSetComponentDefinition<PBCameraModeArea>;
 /** @public */ export declare const EngineInfo: LastWriteWinElementSetComponentDefinition<PBEngineInfo>;
+/** @public */ export declare const ExplorerItemPurchaseResult: GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>;
 /** @public */ export declare const ExplorerUiEventsResult: GrowOnlyValueSetComponentDefinition<PBExplorerUiEventsResult>;
 /** @public */ export declare const GltfContainer: LastWriteWinElementSetComponentDefinition<PBGltfContainer>;
 /** @public */ export declare const GltfContainerLoadingState: LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>;

package/dist-cjs/components/generated/global.gen.js

@@ -26,8 +26,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UiInputBinding = exports.UiInput = exports.UiDropdownResult = exports.UiDropdown = exports.UiCanvasInformation = exports.UiBackground = exports.TweenState = exports.TweenSequence = exports.TriggerAreaResult = exports.TriggerArea = exports.TouchScreenControls = exports.TextShape = exports.SkyboxTime = exports.RealmInfo = exports.RaycastResult = exports.Raycast = exports.PrimaryPointerInfo = exports.PointerLock = exports.PointerEventsResult = exports.PointerEvents = exports.PlayerIdentityData = exports.PhysicsCombinedImpulse = exports.PhysicsCombinedForce = exports.ParticleSystem = exports.NftShape = exports.MainCamera = exports.LightSource = exports.InputModifier = exports.GltfNodeModifiers = exports.GltfContainerLoadingState = exports.GltfContainer = exports.ExplorerUiEventsResult = exports.EngineInfo = exports.CameraModeArea = exports.CameraMode = exports.Billboard = exports.AvatarShape = exports.AvatarNametag = exports.AvatarModifierArea = exports.AvatarLocomotionSettings = exports.AvatarEquippedData = exports.AvatarEmoteCommand = exports.AvatarBase = exports.AvatarAttach = exports.AudioStream = exports.AudioSource = exports.AudioEvent = exports.AudioAnalysis = exports.AssetLoadLoadingState = exports.AssetLoad = void 0;
-exports.VisibilityComponent = exports.VirtualCamera = exports.VideoPlayer = exports.VideoEvent = exports.UiTransform = exports.UiText = exports.UiInputResult = void 0;
+exports.UiInput = exports.UiDropdownResult = exports.UiDropdown = exports.UiCanvasInformation = exports.UiBackground = exports.TweenState = exports.TweenSequence = exports.TriggerAreaResult = exports.TriggerArea = exports.TouchScreenControls = exports.TextShape = exports.SkyboxTime = exports.RealmInfo = exports.RaycastResult = exports.Raycast = exports.PrimaryPointerInfo = exports.PointerLock = exports.PointerEventsResult = exports.PointerEvents = exports.PlayerIdentityData = exports.PhysicsCombinedImpulse = exports.PhysicsCombinedForce = exports.ParticleSystem = exports.NftShape = exports.MainCamera = exports.LightSource = exports.InputModifier = exports.GltfNodeModifiers = exports.GltfContainerLoadingState = exports.GltfContainer = exports.ExplorerUiEventsResult = exports.ExplorerItemPurchaseResult = exports.EngineInfo = exports.CameraModeArea = exports.CameraMode = exports.Billboard = exports.AvatarShape = exports.AvatarNametag = exports.AvatarModifierArea = exports.AvatarLocomotionSettings = exports.AvatarEquippedData = exports.AvatarEmoteCommand = exports.AvatarBase = exports.AvatarAttach = exports.AudioStream = exports.AudioSource = exports.AudioEvent = exports.AudioAnalysis = exports.AssetLoadLoadingState = exports.AssetLoad = void 0;
+exports.VisibilityComponent = exports.VirtualCamera = exports.VideoPlayer = exports.VideoEvent = exports.UiTransform = exports.UiText = exports.UiInputResult = exports.UiInputBinding = void 0;
 const initialization_1 = require("../../runtime/initialization");
 const components = __importStar(require("./index.gen"));
 __exportStar(require("./index.gen"), exports);
@@ -49,6 +49,7 @@ __exportStar(require("./index.gen"), exports);
 /** @public */ exports.CameraMode = components.CameraMode(initialization_1.engine);
 /** @public */ exports.CameraModeArea = components.CameraModeArea(initialization_1.engine);
 /** @public */ exports.EngineInfo = components.EngineInfo(initialization_1.engine);
+/** @public */ exports.ExplorerItemPurchaseResult = components.ExplorerItemPurchaseResult(initialization_1.engine);
 /** @public */ exports.ExplorerUiEventsResult = components.ExplorerUiEventsResult(initialization_1.engine);
 /** @public */ exports.GltfContainer = components.GltfContainer(initialization_1.engine);
 /** @public */ exports.GltfContainerLoadingState = components.GltfContainerLoadingState(initialization_1.engine);

package/dist-cjs/components/generated/index.gen.d.ts

@@ -19,6 +19,7 @@ import { PBBillboard } from './pb/decentraland/sdk/components/billboard.gen';
 import { PBCameraMode } from './pb/decentraland/sdk/components/camera_mode.gen';
 import { PBCameraModeArea } from './pb/decentraland/sdk/components/camera_mode_area.gen';
 import { PBEngineInfo } from './pb/decentraland/sdk/components/engine_info.gen';
+import { PBExplorerItemPurchaseResult } from './pb/decentraland/sdk/components/explorer_item_purchase_result.gen';
 import { PBExplorerUiEventsResult } from './pb/decentraland/sdk/components/explorer_ui_events_result.gen';
 import { PBGltfContainer } from './pb/decentraland/sdk/components/gltf_container.gen';
 import { PBGltfContainerLoadingState } from './pb/decentraland/sdk/components/gltf_container_loading_state.gen';
@@ -81,6 +82,7 @@ export * from './pb/decentraland/sdk/components/billboard.gen';
 export * from './pb/decentraland/sdk/components/camera_mode.gen';
 export * from './pb/decentraland/sdk/components/camera_mode_area.gen';
 export * from './pb/decentraland/sdk/components/engine_info.gen';
+export * from './pb/decentraland/sdk/components/explorer_item_purchase_result.gen';
 export * from './pb/decentraland/sdk/components/explorer_ui_events_result.gen';
 export * from './pb/decentraland/sdk/components/gltf_container.gen';
 export * from './pb/decentraland/sdk/components/gltf_container_loading_state.gen';
@@ -145,6 +147,7 @@ export type GSetComponentGetter<T extends GrowOnlyValueSetComponentDefinition<an
 /** @public */ export declare const CameraMode: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraMode>>;
 /** @public */ export declare const CameraModeArea: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraModeArea>>;
 /** @public */ export declare const EngineInfo: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBEngineInfo>>;
+/** @public */ export declare const ExplorerItemPurchaseResult: GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>>;
 /** @public */ export declare const ExplorerUiEventsResult: GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerUiEventsResult>>;
 /** @public */ export declare const GltfContainer: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainer>>;
 /** @public */ export declare const GltfContainerLoadingState: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>>;
@@ -209,6 +212,7 @@ export declare const componentDefinitionByName: {
     "core::CameraMode": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraMode>>;
     "core::CameraModeArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraModeArea>>;
     "core::EngineInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBEngineInfo>>;
+    "core::ExplorerItemPurchaseResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>>;
     "core::ExplorerUiEventsResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerUiEventsResult>>;
     "core::GltfContainer": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainer>>;
     "core::GltfContainerLoadingState": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>>;

package/dist-cjs/components/generated/index.gen.js

@@ -14,8 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UiBackground = exports.TweenState = exports.TweenSequence = exports.Tween = exports.TriggerAreaResult = exports.TriggerArea = exports.TouchScreenControls = exports.TextShape = exports.SkyboxTime = exports.RealmInfo = exports.RaycastResult = exports.Raycast = exports.PrimaryPointerInfo = exports.PointerLock = exports.PointerEventsResult = exports.PointerEvents = exports.PlayerIdentityData = exports.PhysicsCombinedImpulse = exports.PhysicsCombinedForce = exports.ParticleSystem = exports.NftShape = exports.MeshRenderer = exports.MeshCollider = exports.Material = exports.MainCamera = exports.LightSource = exports.InputModifier = exports.GltfNodeModifiers = exports.GltfContainerLoadingState = exports.GltfContainer = exports.ExplorerUiEventsResult = exports.EngineInfo = exports.CameraModeArea = exports.CameraMode = exports.Billboard = exports.AvatarShape = exports.AvatarNametag = exports.AvatarModifierArea = exports.AvatarLocomotionSettings = exports.AvatarEquippedData = exports.AvatarEmoteCommand = exports.AvatarBase = exports.AvatarAttach = exports.AudioStream = exports.AudioSource = exports.AudioEvent = exports.AudioAnalysis = exports.AssetLoadLoadingState = exports.AssetLoad = exports.Animator = void 0;
-exports.componentDefinitionByName = exports.VisibilityComponent = exports.VirtualCamera = exports.VideoPlayer = exports.VideoEvent = exports.UiTransform = exports.UiText = exports.UiInputResult = exports.UiInputBinding = exports.UiInput = exports.UiDropdownResult = exports.UiDropdown = exports.UiCanvasInformation = void 0;
+exports.TweenState = exports.TweenSequence = exports.Tween = exports.TriggerAreaResult = exports.TriggerArea = exports.TouchScreenControls = exports.TextShape = exports.SkyboxTime = exports.RealmInfo = exports.RaycastResult = exports.Raycast = exports.PrimaryPointerInfo = exports.PointerLock = exports.PointerEventsResult = exports.PointerEvents = exports.PlayerIdentityData = exports.PhysicsCombinedImpulse = exports.PhysicsCombinedForce = exports.ParticleSystem = exports.NftShape = exports.MeshRenderer = exports.MeshCollider = exports.Material = exports.MainCamera = exports.LightSource = exports.InputModifier = exports.GltfNodeModifiers = exports.GltfContainerLoadingState = exports.GltfContainer = exports.ExplorerUiEventsResult = exports.ExplorerItemPurchaseResult = exports.EngineInfo = exports.CameraModeArea = exports.CameraMode = exports.Billboard = exports.AvatarShape = exports.AvatarNametag = exports.AvatarModifierArea = exports.AvatarLocomotionSettings = exports.AvatarEquippedData = exports.AvatarEmoteCommand = exports.AvatarBase = exports.AvatarAttach = exports.AudioStream = exports.AudioSource = exports.AudioEvent = exports.AudioAnalysis = exports.AssetLoadLoadingState = exports.AssetLoad = exports.Animator = void 0;
+exports.componentDefinitionByName = exports.VisibilityComponent = exports.VirtualCamera = exports.VideoPlayer = exports.VideoEvent = exports.UiTransform = exports.UiText = exports.UiInputResult = exports.UiInputBinding = exports.UiInput = exports.UiDropdownResult = exports.UiDropdown = exports.UiCanvasInformation = exports.UiBackground = void 0;
 const Animator_gen_1 = require("./Animator.gen");
 const AssetLoad_gen_1 = require("./AssetLoad.gen");
 const AssetLoadLoadingState_gen_1 = require("./AssetLoadLoadingState.gen");
@@ -35,6 +35,7 @@ const Billboard_gen_1 = require("./Billboard.gen");
 const CameraMode_gen_1 = require("./CameraMode.gen");
 const CameraModeArea_gen_1 = require("./CameraModeArea.gen");
 const EngineInfo_gen_1 = require("./EngineInfo.gen");
+const ExplorerItemPurchaseResult_gen_1 = require("./ExplorerItemPurchaseResult.gen");
 const ExplorerUiEventsResult_gen_1 = require("./ExplorerUiEventsResult.gen");
 const GltfContainer_gen_1 = require("./GltfContainer.gen");
 const GltfContainerLoadingState_gen_1 = require("./GltfContainerLoadingState.gen");
@@ -97,6 +98,7 @@ __exportStar(require("./pb/decentraland/sdk/components/billboard.gen"), exports)
 __exportStar(require("./pb/decentraland/sdk/components/camera_mode.gen"), exports);
 __exportStar(require("./pb/decentraland/sdk/components/camera_mode_area.gen"), exports);
 __exportStar(require("./pb/decentraland/sdk/components/engine_info.gen"), exports);
+__exportStar(require("./pb/decentraland/sdk/components/explorer_item_purchase_result.gen"), exports);
 __exportStar(require("./pb/decentraland/sdk/components/explorer_ui_events_result.gen"), exports);
 __exportStar(require("./pb/decentraland/sdk/components/gltf_container.gen"), exports);
 __exportStar(require("./pb/decentraland/sdk/components/gltf_container_loading_state.gen"), exports);
@@ -203,6 +205,11 @@ exports.CameraModeArea = CameraModeArea;
 /** @public */ const EngineInfo = engine => 
 /* @__PURE__ */ engine.defineComponentFromSchema("core::EngineInfo", EngineInfo_gen_1.EngineInfoSchema);
 exports.EngineInfo = EngineInfo;
+/** @public */ const ExplorerItemPurchaseResult = (engine) => /* @__PURE__ */ engine.defineValueSetComponentFromSchema("core::ExplorerItemPurchaseResult", ExplorerItemPurchaseResult_gen_1.ExplorerItemPurchaseResultSchema, {
+    timestampFunction: (t) => t.timestamp,
+    maxElements: 100
+});
+exports.ExplorerItemPurchaseResult = ExplorerItemPurchaseResult;
 /** @public */ const ExplorerUiEventsResult = (engine) => /* @__PURE__ */ engine.defineValueSetComponentFromSchema("core::ExplorerUiEventsResult", ExplorerUiEventsResult_gen_1.ExplorerUiEventsResultSchema, {
     timestampFunction: (t) => t.timestamp,
     maxElements: 100
@@ -361,6 +368,7 @@ exports.componentDefinitionByName = {
     "core::CameraMode": exports.CameraMode,
     "core::CameraModeArea": exports.CameraModeArea,
     "core::EngineInfo": exports.EngineInfo,
+    "core::ExplorerItemPurchaseResult": exports.ExplorerItemPurchaseResult,
     "core::ExplorerUiEventsResult": exports.ExplorerUiEventsResult,
     "core::GltfContainer": exports.GltfContainer,
     "core::GltfContainerLoadingState": exports.GltfContainerLoadingState,

package/dist-cjs/components/generated/pb/decentraland/sdk/components/common/explorer_ui.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * Identifies which fullscreen explorer panel OpenExplorerUi targets.
+ * Identifies which explorer panel OpenExplorerUi targets. Panels are not all fullscreen.
  * EU_SETTINGS holds 0 so an unset `ui` field defaults to the least-intrusive panel.
  */
 /**
@@ -12,5 +12,7 @@ export declare const enum ExplorerUi {
     EU_CAMERA_REEL = 3,
     EU_COMMUNITIES = 4,
     EU_PLACES = 5,
-    EU_EVENTS = 6
+    EU_EVENTS = 6,
+    /** EU_ITEM_PURCHASE - the item-purchase confirmation modal; see OpenExplorerUi for its parameters and result component */
+    EU_ITEM_PURCHASE = 7
 }

package/dist-cjs/components/generated/pb/decentraland/sdk/components/common/explorer_ui.gen.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExplorerUi = void 0;
 const protobufPackageSarasa = "decentraland.sdk.components.common";
 /**
- * Identifies which fullscreen explorer panel OpenExplorerUi targets.
+ * Identifies which explorer panel OpenExplorerUi targets. Panels are not all fullscreen.
  * EU_SETTINGS holds 0 so an unset `ui` field defaults to the least-intrusive panel.
  */
 /**
@@ -19,4 +19,6 @@ var ExplorerUi;
     ExplorerUi[ExplorerUi["EU_COMMUNITIES"] = 4] = "EU_COMMUNITIES";
     ExplorerUi[ExplorerUi["EU_PLACES"] = 5] = "EU_PLACES";
     ExplorerUi[ExplorerUi["EU_EVENTS"] = 6] = "EU_EVENTS";
+    /** EU_ITEM_PURCHASE - the item-purchase confirmation modal; see OpenExplorerUi for its parameters and result component */
+    ExplorerUi[ExplorerUi["EU_ITEM_PURCHASE"] = 7] = "EU_ITEM_PURCHASE";
 })(ExplorerUi = exports.ExplorerUi || (exports.ExplorerUi = {}));

package/dist-cjs/components/generated/pb/decentraland/sdk/components/explorer_item_purchase_result.gen.d.ts

@@ -0,0 +1,68 @@
+import _m0 from "protobufjs/minimal";
+/**
+ * Grow-only value set appended to the scene root entity.
+ * Reports the outcome of an EU_ITEM_PURCHASE flow triggered via OpenExplorerUi.
+ */
+/**
+ * @public
+ */
+export interface PBExplorerItemPurchaseResult {
+    urn: string;
+    /** The scene tick when the event occurred */
+    timestamp: number;
+    /** The OpenExplorerUiRequest.request_id that caused this event; 0 when the request carried none */
+    requestId: number;
+    status?: {
+        $case: "purchased";
+        purchased: PBExplorerItemPurchaseResult_Purchased;
+    } | {
+        $case: "dismissed";
+        dismissed: PBExplorerItemPurchaseResult_Dismissed;
+    } | {
+        $case: "failed";
+        failed: PBExplorerItemPurchaseResult_Failed;
+    } | undefined;
+}
+/**
+ * @public
+ */
+export interface PBExplorerItemPurchaseResult_Purchased {
+}
+/**
+ * @public
+ */
+export interface PBExplorerItemPurchaseResult_Dismissed {
+}
+/**
+ * @public
+ */
+export interface PBExplorerItemPurchaseResult_Failed {
+}
+/**
+ * @public
+ */
+export declare namespace PBExplorerItemPurchaseResult {
+    function encode(message: PBExplorerItemPurchaseResult, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerItemPurchaseResult;
+}
+/**
+ * @public
+ */
+export declare namespace PBExplorerItemPurchaseResult_Purchased {
+    function encode(_: PBExplorerItemPurchaseResult_Purchased, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerItemPurchaseResult_Purchased;
+}
+/**
+ * @public
+ */
+export declare namespace PBExplorerItemPurchaseResult_Dismissed {
+    function encode(_: PBExplorerItemPurchaseResult_Dismissed, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerItemPurchaseResult_Dismissed;
+}
+/**
+ * @public
+ */
+export declare namespace PBExplorerItemPurchaseResult_Failed {
+    function encode(_: PBExplorerItemPurchaseResult_Failed, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerItemPurchaseResult_Failed;
+}