@dcl/playground-assets 7.29.1-36863326504.commit-aa54c50 → 7.30.0

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 - a fullscreen panel is already open */
+        /** WAS_ALREADY_OPEN - the slot the requested panel occupies is already in use; panels sharing a slot exclude each other */
         WAS_ALREADY_OPEN = 2,
         /** REJECTED_NOT_CURRENT_SCENE - the standard restricted-actions current-scene gate rejected the call */
         REJECTED_NOT_CURRENT_SCENE = 3,
@@ -1355,6 +1355,15 @@ 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. */
@@ -1392,7 +1401,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 a specific fullscreen explorer panel and returns the open verdict. */
+    /** OpenExplorerUi opens an explorer panel, fullscreen or modal, 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-36863326504.commit-aa54c50",
+  "version": "7.30.0",
   "author": "Decentraland",
   "dependencies": {
     "@dcl/ecs": "file:../ecs",
@@ -33,5 +33,5 @@
   },
   "types": "./index.d.ts",
   "typings": "./index.d.ts",
-  "commit": "aa54c508d64b518bf772287608b3de1c409be04f"
+  "commit": "ab46c8191eddd44d23a8e01bdf5fc7d7b7141986"
 }

package/dist/playground-assets.d.ts

@@ -245,42 +245,6 @@ 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
@@ -456,22 +420,6 @@ 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 */
@@ -1505,6 +1453,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>>;
@@ -1714,12 +1663,12 @@ export declare const CRDT_MESSAGE_HEADER_LENGTH = 8;
 /**
  * @public
  */
-export declare type CrdtMessage = PutComponentMessage | AuthoritativePutComponentMessage | DeleteComponentMessage | AppendValueMessage | DeleteEntityMessage | PutNetworkComponentMessage | DeleteComponentNetworkMessage | DeleteEntityNetworkMessage;
+export declare type CrdtMessage = PutComponentMessage | DeleteComponentMessage | AppendValueMessage | DeleteEntityMessage | PutNetworkComponentMessage | DeleteComponentNetworkMessage | DeleteEntityNetworkMessage;
 
 /**
  * @public
  */
-export declare type CrdtMessageBody = PutComponentMessageBody | AuthoritativePutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody | CrdtNetworkMessageBody;
+export declare type CrdtMessageBody = PutComponentMessageBody | DeleteComponentMessageBody | DeleteEntityMessageBody | AppendValueMessageBody | CrdtNetworkMessageBody;
 
 /**
  * Min length = 8 bytes
@@ -1774,8 +1723,7 @@ export declare enum CrdtMessageType {
     PUT_COMPONENT_NETWORK = 5,
     DELETE_COMPONENT_NETWORK = 6,
     DELETE_ENTITY_NETWORK = 7,
-    AUTHORITATIVE_PUT_COMPONENT = 8,
-    MAX_MESSAGE_TYPE = 9
+    MAX_MESSAGE_TYPE = 8
 }
 
 /**
@@ -1783,8 +1731,6 @@ export declare enum CrdtMessageType {
  */
 export declare type CrdtNetworkMessageBody = PutNetworkComponentMessageBody | DeleteComponentNetworkMessageBody | DeleteEntityNetworkMessageBody;
 
-export declare const CreatedBy: ICreatedBy;
-
 /**
  * @public
  */
@@ -2261,8 +2207,11 @@ export declare type ExcludeUndefined<T> = {
  */
 export declare const executeTask: (task: Task<unknown>) => void;
 
+/** @public */
+export declare const ExplorerItemPurchaseResult: GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>;
+
 /**
- * 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.
  */
 /**
@@ -2275,7 +2224,9 @@ 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
 }
 
 /** @public */
@@ -2556,12 +2507,6 @@ 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
  */
@@ -3048,35 +2993,6 @@ 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
  */
@@ -5364,7 +5280,82 @@ export declare namespace PBEngineInfo {
 }
 
 /**
- * PBExplorerUiEventsResult transports the lifecycle events of fullscreen explorer panels — a panel was
+ * 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
  * 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.
  */
@@ -5376,6 +5367,8 @@ 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;
@@ -5393,7 +5386,7 @@ export declare namespace PBExplorerUiEventsResult {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerUiEventsResult;
 }
 
-/** Emitted when a fullscreen explorer panel is closed. */
+/** Emitted when an explorer panel is closed. */
 /**
  * @public
  */
@@ -5408,7 +5401,10 @@ export declare namespace PBExplorerUiEventsResult_UiClosed {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBExplorerUiEventsResult_UiClosed;
 }
 
-/** Emitted when a fullscreen explorer panel is opened. */
+/**
+ * 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.
+ */
 /**
  * @public
  */
@@ -9537,16 +9533,6 @@ 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;
 };
 
 /**
@@ -10126,14 +10112,6 @@ 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
  */

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.59.3"
+      "packageVersion": "7.59.4"
     }
   ]
 }