@dcl/playground-assets 7.29.1-36591934525.commit-48aa9b5 → 7.29.1-36625469671.commit-2d5ffac

package/dist/playground/sdk/apis.d.ts

@@ -1285,7 +1285,7 @@ declare module "~system/RestrictedActions" {
     export enum OpenExplorerUiResult {
         UNSPECIFIED = 0,
         OPENED = 1,
-        /** WAS_ALREADY_OPEN - the slot the requested panel occupies is already in use; panels sharing a slot exclude each other */
+        /** WAS_ALREADY_OPEN - a fullscreen panel is already open */
         WAS_ALREADY_OPEN = 2,
         /** REJECTED_NOT_CURRENT_SCENE - the standard restricted-actions current-scene gate rejected the call */
         REJECTED_NOT_CURRENT_SCENE = 3,
@@ -1355,15 +1355,6 @@ declare module "~system/RestrictedActions" {
     }
     export interface OpenExplorerUiRequest {
         ui: import('../ecs').ExplorerUi;
-        /**
-         * Echoed back in the events this request produces, so they can be matched to their call.
-         * Unset means no correlation, and 0 is reserved for the same meaning on the result, so ids start at 1.
-         */
-        requestId?: number | undefined;
-        itemPurchase?: OpenExplorerUiRequest_ItemPurchaseParams | undefined;
-    }
-    export interface OpenExplorerUiRequest_ItemPurchaseParams {
-        urn: string;
     }
     export interface OpenExplorerUiResponse {
         /** Carries only the verdict of the open action. */
@@ -1401,7 +1392,7 @@ declare module "~system/RestrictedActions" {
     export function copyToClipboard(body: CopyToClipboardRequest): Promise<EmptyResponse>;
     /** StopEmote will stop the current emote */
     export function stopEmote(body: StopEmoteRequest): Promise<SuccessResponse>;
-    /** OpenExplorerUi opens an explorer panel, fullscreen or modal, and returns the open verdict. */
+    /** OpenExplorerUi opens a specific fullscreen explorer panel and returns the open verdict. */
     export function openExplorerUi(body: OpenExplorerUiRequest): Promise<OpenExplorerUiResponse>;
 
 }

package/dist/playground/sdk/dcl-sdk.package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dcl/sdk",
   "description": "",
-  "version": "7.29.1-36591934525.commit-48aa9b5",
+  "version": "7.29.1-36625469671.commit-2d5ffac",
   "author": "Decentraland",
   "dependencies": {
     "@dcl/ecs": "file:../ecs",
@@ -33,5 +33,5 @@
   },
   "types": "./index.d.ts",
   "typings": "./index.d.ts",
-  "commit": "48aa9b5f50109f9ef5fd28c79eebdf458fb78061"
+  "commit": "2d5ffaca13b81a16cd09d797bc95b052151a89df"
 }

package/dist/playground-assets.d.ts

@@ -245,6 +245,42 @@ export declare interface AudioStreamComponentDefinitionExtended extends LastWrit
     getAudioState(entity: Entity): PBAudioEvent | undefined;
 }
 
+/**
+ * @public
+ */
+export declare type AuthoritativePutComponentMessage = CrdtMessageHeader & AuthoritativePutComponentMessageBody;
+
+/**
+ * Server authoritative message - identical to PutComponentMessageBody but with forced processing
+ * Min. length = header (8 bytes) + 16 bytes = 24 bytes
+ *
+ * @param entity - Uint32 number of the entity
+ * @param componentId - Uint32 number of id
+ * @param timestamp - Uint32 Lamport timestamp (server's authoritative timestamp)
+ * @param data - Uint8[] data of component => length(4 bytes) + block of bytes[0..length-1]
+ * @public
+ */
+export declare type AuthoritativePutComponentMessageBody = {
+    type: CrdtMessageType.AUTHORITATIVE_PUT_COMPONENT;
+    entityId: Entity;
+    componentId: number;
+    timestamp: number;
+    data: Uint8Array;
+};
+
+/**
+ * @public
+ */
+export declare namespace AuthoritativePutComponentOperation {
+    const MESSAGE_HEADER_LENGTH = 16;
+    /**
+     * Call this function for an optimal writing data passing the ByteBuffer
+     *  already allocated
+     */
+    export function write(entity: Entity, timestamp: number, componentId: number, data: Uint8Array, buf: ByteBuffer): void;
+    export function read(buf: ByteBuffer): AuthoritativePutComponentMessage | null;
+}
+
 /** AvatarAnchorPointType determines the part of the avatar's body that anchors the Entity. */
 /**
  * @public
@@ -420,6 +456,22 @@ export declare interface BaseComponent<T> {
      * If the value is undefined, the component was deleted.
      */
     onChange(entity: Entity, cb: (value: T | undefined) => void): void;
+    /**
+     * @public
+     *
+     */
+    validateBeforeChange(entity: Entity, cb: ValidateCallback<T>): void;
+    validateBeforeChange(cb: ValidateCallback<T>): void;
+    /**
+     * Get the CRDT state for an entity (serialized data and timestamp)
+     * @param entity - Entity to get the CRDT state for
+     * @returns Object with serialized data and timestamp, or null if entity doesn't have the component
+     * @public
+     */
+    getCrdtState(entity: Entity): {
+        data: Uint8Array;
+        timestamp: number;
+    } | null;
 }
 
 /** @public */
@@ -1453,7 +1505,6 @@ 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>>;
@@ -1663,12 +1714,12 @@ export declare const CRDT_MESSAGE_HEADER_LENGTH = 8;
 /**
  * @public
  */
-export declare type CrdtMessage = PutComponentMessage | DeleteComponentMessage | AppendValueMessage | DeleteEntityMessage | PutNetworkComponentMessage | DeleteComponentNetworkMessage | DeleteEntityNetworkMessage;
+export declare type CrdtMessage = PutComponentMessage | AuthoritativePutComponentMessage | DeleteComponentMessage | AppendValueMessage | DeleteEntityMessage | PutNetworkComponentMessage | DeleteComponentNetworkMessage | DeleteEntityNetworkMessage;
 
 /**
  * @public
  */
-export declare type CrdtMessageBody = PutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody | CrdtNetworkMessageBody;
+export declare type CrdtMessageBody = PutComponentMessageBody | AuthoritativePutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody | CrdtNetworkMessageBody;
 
 /**
  * Min length = 8 bytes
@@ -1723,7 +1774,8 @@ export declare enum CrdtMessageType {
     PUT_COMPONENT_NETWORK = 5,
     DELETE_COMPONENT_NETWORK = 6,
     DELETE_ENTITY_NETWORK = 7,
-    MAX_MESSAGE_TYPE = 8
+    AUTHORITATIVE_PUT_COMPONENT = 8,
+    MAX_MESSAGE_TYPE = 9
 }
 
 /**
@@ -1731,6 +1783,8 @@ export declare enum CrdtMessageType {
  */
 export declare type CrdtNetworkMessageBody = PutNetworkComponentMessageBody | DeleteComponentNetworkMessageBody | DeleteEntityNetworkMessageBody;
 
+export declare const CreatedBy: ICreatedBy;
+
 /**
  * @public
  */
@@ -2207,11 +2261,8 @@ export declare type ExcludeUndefined<T> = {
  */
 export declare const executeTask: (task: Task<unknown>) => void;
 
-/** @public */
-export declare const ExplorerItemPurchaseResult: GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>;
-
 /**
- * Identifies which explorer panel OpenExplorerUi targets. Panels are not all fullscreen.
+ * Identifies which fullscreen explorer panel OpenExplorerUi targets.
  * EU_SETTINGS holds 0 so an unset `ui` field defaults to the least-intrusive panel.
  */
 /**
@@ -2224,9 +2275,7 @@ export declare const enum ExplorerUi {
     EU_CAMERA_REEL = 3,
     EU_COMMUNITIES = 4,
     EU_PLACES = 5,
-    EU_EVENTS = 6,
-    /** EU_ITEM_PURCHASE - the item-purchase confirmation modal; see OpenExplorerUi for its parameters and result component */
-    EU_ITEM_PURCHASE = 7
+    EU_EVENTS = 6
 }
 
 /** @public */
@@ -2507,6 +2556,12 @@ export declare interface GrowOnlyValueSetComponentDefinition<T> extends BaseComp
 
 export declare type GSetComponentGetter<T extends GrowOnlyValueSetComponentDefinition<any>> = (engine: Pick<IEngine, 'defineValueSetComponentFromSchema'>) => T;
 
+export declare type ICreatedBy = LastWriteWinElementSetComponentDefinition<ICreatedByType>;
+
+export declare interface ICreatedByType {
+    address: string;
+}
+
 /**
  * @public
  */
@@ -2993,6 +3048,35 @@ export declare const enum InteractionType {
     PROXIMITY = 1
 }
 
+/**
+ * Internal component interface that exposes all internal methods for SDK use
+ * This is not exposed to users, only for internal SDK operations
+ */
+export declare interface InternalBaseComponent<T> extends BaseComponent<T> {
+    /**
+     * @public
+     * Dry run update to check if a CRDT message would be accepted without actually applying it
+     */
+    __dry_run_updateFromCrdt(body: CrdtMessageBody): ProcessMessageResultType;
+    /**
+     * @public
+     * Get the iterator to every entity has the component
+     */
+    iterator(): Iterable<[Entity, any]>;
+    /**
+     * @public
+     */
+    dirtyIterator(): Iterable<Entity>;
+    /**
+     * @public
+     */
+    __onChangeCallbacks(entity: Entity, value: T): void;
+    /**
+     * @public
+     */
+    __run_validateBeforeChange(entity: Entity, newValue: T | undefined, senderAddress: string, createdBy: string): boolean;
+}
+
 /**
  * @public
  */
@@ -5280,82 +5364,7 @@ export declare namespace PBEngineInfo {
 }
 
 /**
- * Grow-only value set appended to the scene root entity.
- * Reports the outcome of an EU_ITEM_PURCHASE flow triggered via OpenExplorerUi.
- */
-/**
- * @public
- */
-export declare 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 declare namespace PBExplorerItemPurchaseResult {
-    export function encode(message: PBExplorerItemPurchaseResult, writer?: _m0.Writer): _m0.Writer;
-    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerItemPurchaseResult;
-}
-
-/**
- * @public
- */
-export declare interface PBExplorerItemPurchaseResult_Dismissed {
-}
-
-/**
- * @public
- */
-export declare namespace PBExplorerItemPurchaseResult_Dismissed {
-    export function encode(_: PBExplorerItemPurchaseResult_Dismissed, writer?: _m0.Writer): _m0.Writer;
-    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerItemPurchaseResult_Dismissed;
-}
-
-/**
- * @public
- */
-export declare interface PBExplorerItemPurchaseResult_Failed {
-}
-
-/**
- * @public
- */
-export declare namespace PBExplorerItemPurchaseResult_Failed {
-    export function encode(_: PBExplorerItemPurchaseResult_Failed, writer?: _m0.Writer): _m0.Writer;
-    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerItemPurchaseResult_Failed;
-}
-
-/**
- * @public
- */
-export declare interface PBExplorerItemPurchaseResult_Purchased {
-}
-
-/**
- * @public
- */
-export declare namespace PBExplorerItemPurchaseResult_Purchased {
-    export function encode(_: PBExplorerItemPurchaseResult_Purchased, writer?: _m0.Writer): _m0.Writer;
-    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerItemPurchaseResult_Purchased;
-}
-
-/**
- * PBExplorerUiEventsResult transports the lifecycle events of explorer UI panels — a panel was
+ * PBExplorerUiEventsResult transports the lifecycle events of fullscreen explorer panels — a panel was
  * opened, a panel was closed. It is a grow only value set appended to the scene root entity, so every
  * event of a tick is delivered and none overwrites another.
  */
@@ -5367,8 +5376,6 @@ export declare interface PBExplorerUiEventsResult {
     ui: ExplorerUi;
     /** 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;
     event?: {
         $case: "opened";
         opened: PBExplorerUiEventsResult_UiOpened;
@@ -5386,7 +5393,7 @@ export declare namespace PBExplorerUiEventsResult {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerUiEventsResult;
 }
 
-/** Emitted when an explorer panel is closed. */
+/** Emitted when a fullscreen explorer panel is closed. */
 /**
  * @public
  */
@@ -5401,10 +5408,7 @@ export declare namespace PBExplorerUiEventsResult_UiClosed {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerUiEventsResult_UiClosed;
 }
 
-/**
- * Emitted when an explorer panel is opened. The OpenExplorerUi response carries the same fact,
- * but it reaches only the caller; this channel is scene wide.
- */
+/** Emitted when a fullscreen explorer panel is opened. */
 /**
  * @public
  */
@@ -9533,6 +9537,16 @@ export declare 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;
 };
 
 /**
@@ -10112,6 +10126,14 @@ export declare interface UiTransformProps {
  */
 export declare type Unpacked<T> = T extends (infer U)[] ? U : T;
 
+export declare type ValidateCallback<T> = (value: {
+    entity: Entity;
+    currentValue: T | undefined;
+    newValue: T | undefined;
+    senderAddress: string;
+    createdBy: string;
+}) => boolean;
+
 /**
  * @public
  */