@dcl/protocol 1.0.0-2920351961.commit-161c395 → 1.0.0-29255960851.commit-cd43ffd

package/protoc-gen-bitwise/wire.js

@@ -0,0 +1,239 @@
+'use strict'
+
+/**
+ * Self-contained protobuf wire-format codec for protoc-gen-bitwise.
+ *
+ * The plugin only needs a tiny slice of the descriptor/plugin schemas, so
+ * rather than pull in a protobuf runtime (which would force every consumer —
+ * including the sibling Pulse checkout that runs this file directly off disk —
+ * to `npm install` the protocol repo) we decode the handful of fields we care
+ * about by walking the wire format directly. This mirrors the original Python
+ * plugin, which already hand-parsed FieldOptions for the same reason.
+ *
+ * Decoded subset:
+ *   CodeGeneratorRequest { file_to_generate = 1; proto_file = 15; }
+ *   FileDescriptorProto  { name = 1; package = 2; message_type = 4; }
+ *   DescriptorProto      { name = 1; field = 2; }
+ *   FieldDescriptorProto { name = 1; label = 4; type = 5; options = 8 (raw bytes); }
+ *
+ * Encoded subset:
+ *   CodeGeneratorResponse { error = 1; supported_features = 2; file = 15; }
+ *   CodeGeneratorResponse.File { name = 1; content = 15; }
+ *
+ * Wire types: 0 = varint, 1 = 64-bit, 2 = length-delimited, 5 = 32-bit.
+ */
+
+// ---------------------------------------------------------------------------
+// Low-level readers
+// ---------------------------------------------------------------------------
+
+/** Decode a protobuf varint at `pos`. Returns [value, newPos]. */
+function readVarint(buf, pos) {
+  let result = 0
+  let shift = 0
+  let byte
+  do {
+    byte = buf[pos++]
+    // Multiplication (not <<) keeps values correct past 32 bits.
+    result += (byte & 0x7f) * Math.pow(2, shift)
+    shift += 7
+  } while (byte & 0x80)
+  return [result, pos]
+}
+
+/** Advance `pos` past a field of the given wire type. Returns newPos. */
+function skipField(buf, pos, wireType) {
+  switch (wireType) {
+    case 0: // varint
+      return readVarint(buf, pos)[1]
+    case 1: // 64-bit
+      return pos + 8
+    case 2: {
+      // length-delimited
+      const [length, next] = readVarint(buf, pos)
+      return next + length
+    }
+    case 5: // 32-bit
+      return pos + 4
+    default:
+      // Groups (3/4) are deprecated and never appear in descriptors.
+      return pos
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Request decoding
+// ---------------------------------------------------------------------------
+
+function decodeFieldDescriptor(buf) {
+  const field = { name: '', label: 0, type: 0, optionsRaw: null }
+  let pos = 0
+  while (pos < buf.length) {
+    let tag
+    ;[tag, pos] = readVarint(buf, pos)
+    const fieldNum = tag >>> 3
+    const wireType = tag & 0x7
+    if (fieldNum === 1 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      field.name = buf.toString('utf8', pos, pos + len)
+      pos += len
+    } else if (fieldNum === 4 && wireType === 0) {
+      ;[field.label, pos] = readVarint(buf, pos)
+    } else if (fieldNum === 5 && wireType === 0) {
+      ;[field.type, pos] = readVarint(buf, pos)
+    } else if (fieldNum === 8 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      // Keep the raw FieldOptions bytes so custom extensions survive (the
+      // descriptor schema doesn't know about ext 50001/50002).
+      field.optionsRaw = buf.subarray(pos, pos + len)
+      pos += len
+    } else {
+      pos = skipField(buf, pos, wireType)
+    }
+  }
+  return field
+}
+
+function decodeDescriptor(buf) {
+  const message = { name: '', field: [] }
+  let pos = 0
+  while (pos < buf.length) {
+    let tag
+    ;[tag, pos] = readVarint(buf, pos)
+    const fieldNum = tag >>> 3
+    const wireType = tag & 0x7
+    if (fieldNum === 1 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      message.name = buf.toString('utf8', pos, pos + len)
+      pos += len
+    } else if (fieldNum === 2 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      message.field.push(decodeFieldDescriptor(buf.subarray(pos, pos + len)))
+      pos += len
+    } else {
+      // nested_type / enum_type / etc. are intentionally ignored — the
+      // generator only walks top-level messages, matching the Python plugin.
+      pos = skipField(buf, pos, wireType)
+    }
+  }
+  return message
+}
+
+function decodeFileDescriptor(buf) {
+  const file = { name: '', package: '', messageType: [] }
+  let pos = 0
+  while (pos < buf.length) {
+    let tag
+    ;[tag, pos] = readVarint(buf, pos)
+    const fieldNum = tag >>> 3
+    const wireType = tag & 0x7
+    if (fieldNum === 1 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      file.name = buf.toString('utf8', pos, pos + len)
+      pos += len
+    } else if (fieldNum === 2 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      file.package = buf.toString('utf8', pos, pos + len)
+      pos += len
+    } else if (fieldNum === 4 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      file.messageType.push(decodeDescriptor(buf.subarray(pos, pos + len)))
+      pos += len
+    } else {
+      pos = skipField(buf, pos, wireType)
+    }
+  }
+  return file
+}
+
+/** Decode a serialized CodeGeneratorRequest. */
+function decodeRequest(buf) {
+  const request = { fileToGenerate: [], protoFile: [] }
+  let pos = 0
+  while (pos < buf.length) {
+    let tag
+    ;[tag, pos] = readVarint(buf, pos)
+    const fieldNum = tag >>> 3
+    const wireType = tag & 0x7
+    if (fieldNum === 1 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      request.fileToGenerate.push(buf.toString('utf8', pos, pos + len))
+      pos += len
+    } else if (fieldNum === 15 && wireType === 2) {
+      let len
+      ;[len, pos] = readVarint(buf, pos)
+      request.protoFile.push(decodeFileDescriptor(buf.subarray(pos, pos + len)))
+      pos += len
+    } else {
+      pos = skipField(buf, pos, wireType)
+    }
+  }
+  return request
+}
+
+// ---------------------------------------------------------------------------
+// Response encoding
+// ---------------------------------------------------------------------------
+
+/** Encode an unsigned integer as a protobuf varint Buffer. */
+function encodeVarint(value) {
+  const bytes = []
+  let v = value
+  while (v > 0x7f) {
+    bytes.push((v & 0x7f) | 0x80)
+    v = Math.floor(v / 128)
+  }
+  bytes.push(v & 0x7f)
+  return Buffer.from(bytes)
+}
+
+function encodeTag(fieldNum, wireType) {
+  return encodeVarint((fieldNum << 3) | wireType)
+}
+
+/** Encode a length-delimited (string/bytes) field: tag + length + payload. */
+function encodeLengthDelimited(fieldNum, payload) {
+  const buf = Buffer.isBuffer(payload) ? payload : Buffer.from(payload, 'utf8')
+  return Buffer.concat([encodeTag(fieldNum, 2), encodeVarint(buf.length), buf])
+}
+
+function encodeFile(file) {
+  return Buffer.concat([
+    encodeLengthDelimited(1, file.name), // name = 1
+    encodeLengthDelimited(15, file.content), // content = 15
+  ])
+}
+
+/**
+ * Encode a CodeGeneratorResponse.
+ * @param {{error?: string|null, supportedFeatures?: number, files?: Array<{name:string,content:string}>}} response
+ */
+function encodeResponse(response) {
+  const parts = []
+  if (response.error != null) {
+    parts.push(encodeLengthDelimited(1, response.error)) // error = 1
+  }
+  if (response.supportedFeatures != null) {
+    parts.push(encodeTag(2, 0)) // supported_features = 2 (varint)
+    parts.push(encodeVarint(response.supportedFeatures))
+  }
+  for (const file of response.files || []) {
+    parts.push(encodeLengthDelimited(15, encodeFile(file))) // file = 15
+  }
+  return Buffer.concat(parts)
+}
+
+module.exports = {
+  readVarint,
+  skipField,
+  decodeRequest,
+  encodeResponse,
+}

package/public/about.proto

@@ -0,0 +1,5 @@
+syntax = "proto3";
+
+package decentraland.realm;
+
+import public "decentraland/realm/about.proto";

package/public/comms.proto

@@ -0,0 +1,5 @@
+syntax = "proto3";
+
+import public "decentraland/kernel/comms/v3/archipelago.proto";
+import public "decentraland/kernel/comms/rfc4/comms.proto";
+import public "decentraland/kernel/comms/rfc5/ws_comms.proto";

package/public/quests.proto

@@ -0,0 +1,5 @@
+syntax = "proto3";
+
+package decentraland.quests;
+
+import public "decentraland/quests/definitions.proto";

package/public/sdk-apis.proto

@@ -0,0 +1,25 @@
+syntax = "proto3";
+
+package decentraland.sdk;
+// This file only imports all the modules exposed to the scenes to help the compiler
+// resolve all files without conflicts
+
+
+import public "decentraland/kernel/apis/communications_controller.proto";
+import public "decentraland/kernel/apis/dev_tools.proto";
+import public "decentraland/kernel/apis/engine_api.proto";
+import public "decentraland/kernel/apis/environment_api.proto";
+import public "decentraland/kernel/apis/ethereum_controller.proto";
+import public "decentraland/kernel/apis/parcel_identity.proto";
+import public "decentraland/kernel/apis/permissions.proto";
+import public "decentraland/kernel/apis/players.proto";
+import public "decentraland/kernel/apis/portable_experiences.proto";
+import public "decentraland/kernel/apis/restricted_actions.proto";
+import public "decentraland/kernel/apis/runtime.proto";
+import public "decentraland/kernel/apis/testing.proto";
+import public "decentraland/kernel/apis/signed_fetch.proto";
+import public "decentraland/kernel/apis/social_controller.proto";
+import public "decentraland/kernel/apis/user_action_module.proto";
+import public "decentraland/kernel/apis/user_identity.proto";
+import public "decentraland/kernel/apis/scene.proto";
+import public "decentraland/kernel/apis/comms_api.proto";

package/public/sdk-components.proto

@@ -0,0 +1,43 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+import public "decentraland/sdk/components/animator.proto";
+import public "decentraland/sdk/components/audio_source.proto";
+import public "decentraland/sdk/components/audio_stream.proto";
+import public "decentraland/sdk/components/avatar_attach.proto";
+import public "decentraland/sdk/components/avatar_base.proto";
+import public "decentraland/sdk/components/avatar_emote_command.proto";
+import public "decentraland/sdk/components/avatar_equipped_data.proto";
+import public "decentraland/sdk/components/avatar_modifier_area.proto";
+import public "decentraland/sdk/components/avatar_shape.proto";
+import public "decentraland/sdk/components/billboard.proto";
+import public "decentraland/sdk/components/camera_mode_area.proto";
+import public "decentraland/sdk/components/camera_mode.proto";
+import public "decentraland/sdk/components/engine_info.proto";
+import public "decentraland/sdk/components/gltf_container.proto";
+import public "decentraland/sdk/components/gltf_node_modifiers.proto";
+import public "decentraland/sdk/components/gltf_container_loading_state.proto";
+import public "decentraland/sdk/components/material.proto";
+import public "decentraland/sdk/components/mesh_collider.proto";
+import public "decentraland/sdk/components/mesh_renderer.proto";
+import public "decentraland/sdk/components/nft_shape.proto";
+import public "decentraland/sdk/components/player_identity_data.proto";
+import public "decentraland/sdk/components/pointer_events_result.proto";
+import public "decentraland/sdk/components/pointer_events.proto";
+import public "decentraland/sdk/components/pointer_lock.proto";
+import public "decentraland/sdk/components/raycast_result.proto";
+import public "decentraland/sdk/components/raycast.proto";
+import public "decentraland/sdk/components/realm_info.proto";
+import public "decentraland/sdk/components/text_shape.proto";
+import public "decentraland/sdk/components/tween.proto";
+import public "decentraland/sdk/components/tween_state.proto";
+import public "decentraland/sdk/components/tween_sequence.proto";
+import public "decentraland/sdk/components/ui_background.proto";
+import public "decentraland/sdk/components/ui_dropdown_result.proto";
+import public "decentraland/sdk/components/ui_dropdown.proto";
+import public "decentraland/sdk/components/ui_input_result.proto";
+import public "decentraland/sdk/components/ui_input.proto";
+import public "decentraland/sdk/components/ui_text.proto";
+import public "decentraland/sdk/components/ui_transform.proto";
+import public "decentraland/sdk/components/video_player.proto";
+import public "decentraland/sdk/components/visibility_component.proto";

package/public/sdk-development.proto

@@ -0,0 +1,5 @@
+syntax = "proto3";
+
+package decentraland.sdk.development;
+
+import public "decentraland/sdk/development/local_development.proto";

package/public/social.proto

@@ -0,0 +1,6 @@
+syntax = "proto3";
+
+package decentraland.social;
+
+import public "decentraland/social_service/v1/social_service_v1.proto";
+import public "decentraland/social_service/v2/social_service_v2.proto";

package/ecs/components/Animator.proto

@@ -1,18 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1042;
-
-message PBAnimator {
-   repeated PBAnimationState states = 1;
-}
-
-message PBAnimationState {
-  string name = 1;
-  string clip = 2;
-  optional bool playing = 3;
-  optional float weight = 4; // default=1.0s
-  optional float speed = 5; // default=1.0
-  optional bool loop = 6; // default=true
-  optional bool should_reset = 7;
-}

package/ecs/components/AudioSource.proto

@@ -1,12 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1020;
-
-message PBAudioSource {  
-  optional bool playing = 1;
-  optional float volume = 2; // default=1.0f
-  optional bool loop = 3;
-  optional float pitch = 4; // default=1.0f
-  string audio_clip_url = 5;
-}

package/ecs/components/AudioStream.proto

@@ -1,10 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1021;
-
-message PBAudioStream {  
-  optional bool playing = 1;
-  optional float volume = 2; // default=1.0f
-  string url = 3;
-}

package/ecs/components/AvatarAttach.proto

@@ -1,16 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1073;
-
-enum AvatarAnchorPoint {
-  POSITION = 0;
-  NAME_TAG = 1;
-  LEFT_HAND = 2;
-  RIGHT_HAND = 3;
-}
-
-message PBAvatarAttach {
-  string avatar_id = 1;
-  AvatarAnchorPoint anchor_point_id = 2;
-}

package/ecs/components/AvatarModifierArea.proto

@@ -1,16 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1070;
-import "common/Vector3.proto";
-
-enum AvatarModifier {
-  HIDE_AVATARS = 0;
-  DISABLE_PASSPORTS = 1;
-}
-
-message PBAvatarModifierArea {
-  Vector3 area = 1;
-  repeated string exclude_ids = 2;
-  repeated AvatarModifier modifiers = 3;
-}

package/ecs/components/AvatarShape.proto

@@ -1,20 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1080;
-import "common/Color3.proto";
-
-message PBAvatarShape {
-  string id = 1;
-  optional string name = 2;
-  optional string body_shape = 3;
-  optional Color3 skin_color = 4;
-  optional Color3 hair_color = 5;
-  optional Color3 eye_color = 6;
-  repeated string wearables = 7;
-  optional string expression_trigger_id = 8;
-  optional int64 expression_trigger_timestamp = 9;
-  optional string sticker_trigger_id = 10;
-  optional int64 sticker_trigger_timestamp = 11;
-  optional bool talking = 12;
-}

package/ecs/components/Billboard.proto

@@ -1,10 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1090;
-
-message PBBillboard {
-  optional bool x = 1; // default=true
-  optional bool y = 2; // default=true
-  optional bool z = 3; // default=true
-}

package/ecs/components/BoxShape.proto

@@ -1,14 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1013;
-
-message PBBoxShape {  
-  // @deprecated use MeshCollider instead https://github.com/decentraland/sdk/issues/366
-  optional bool with_collisions = 1; // default=true
-  // @deprecated use MeshCollider instead https://github.com/decentraland/sdk/issues/366
-  optional bool is_pointer_blocker = 2; // default=true
-  // @deprecated use HiddenComponent instead https://github.com/decentraland/sdk/issues/353
-  optional bool visible = 3; // default=true
-  repeated float uvs = 4;
-}

package/ecs/components/CameraMode.proto

@@ -1,9 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1072;
-import "common/CameraModeValue.proto";
-
-message PBCameraMode {
-  CameraModeValue mode = 1;
-}

package/ecs/components/CameraModeArea.proto

@@ -1,11 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1071;
-import "common/Vector3.proto";
-import "common/CameraModeValue.proto";
-
-message PBCameraModeArea {
-  Vector3 area = 1;
-  CameraModeValue mode = 2;
-}

package/ecs/components/CylinderShape.proto

@@ -1,15 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1016;
-
-message PBCylinderShape {  
-  // @deprecated use MeshCollider instead https://github.com/decentraland/sdk/issues/366
-  optional bool with_collisions = 1; // default=true
-  // @deprecated use MeshCollider instead https://github.com/decentraland/sdk/issues/366
-  optional bool is_pointer_blocker = 2; // default=true
-  // @deprecated use HiddenComponent instead https://github.com/decentraland/sdk/issues/353
-  optional bool visible = 3; // default=true
-  optional float radius_top = 4; // default=1.0
-  optional float radius_bottom = 5; // default=1.0
-}

package/ecs/components/GLTFShape.proto

@@ -1,14 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1041;
-
-message PBGLTFShape {
-  // @deprecated use MeshCollider instead https://github.com/decentraland/sdk/issues/366
-  optional bool with_collisions = 1; // default=true
-  // @deprecated use MeshCollider instead https://github.com/decentraland/sdk/issues/366
-  optional bool is_pointer_blocker = 2; // default=true
-  // @deprecated use HiddenComponent instead https://github.com/decentraland/sdk/issues/353
-  optional bool visible = 3; // default=true
-  string src = 4;
-}

package/ecs/components/Material.proto

@@ -1,59 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1017;
-
-import "common/Color3.proto";
-
-enum TextureWrapMode {
-    Repeat = 0;
-    Clamp = 1;
-    Mirror = 2;
-    MirrorOnce = 3;
-}
-
-enum FilterMode
-{
-    Point = 0;
-    Bilinear = 1;
-    Trilinear = 2;
-}
-
-enum TransparencyMode
-{
-    Opaque = 0;
-    AlphaTest = 1;
-    AlphaBlend = 2;
-    AlphaTestAndAlphaBlend = 3;
-    Auto = 4;
-}
-
-message PBMaterial {  
-    message Texture {
-        string src = 1;
-        optional TextureWrapMode wrapMode = 2; // default = TextureWrapMode.Clamp
-        optional FilterMode filterMode = 3; // default = FilterMode.Bilinear
-    }
-
-    optional Texture texture = 1; // default = null
-    optional float alphaTest = 2; // default = 0.5. range value: from 0 to 1
-    optional bool castShadows = 3; // default =  true
-
-    optional Texture alphaTexture = 4; // default = null
-    optional Texture emissiveTexture = 5; // default = null
-    optional Texture bumpTexture = 6; // default = null
-
-    optional Color3 albedoColor = 7; // default = white;
-    optional Color3 emissiveColor = 8; // default = black;
-    optional Color3 reflectivityColor = 9; // default = white;
-
-    optional TransparencyMode transparencyMode = 10; // default = TransparencyMode.Auto
-
-    optional float metallic = 11; // default = 0.5
-    optional float roughness = 12; // default = 0.5
-    optional float glossiness = 13; // default = 1
-
-    optional float specularIntensity = 14; // default = 1
-    optional float emissiveIntensity = 15; // default = 2
-    optional float directIntensity = 16; // default = 1
-}

package/ecs/components/MeshRenderer.proto

@@ -1,29 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1018;
-
-message PBMeshRenderer {
-    message BoxMesh {
-        repeated float uvs = 1;
-    }
-
-    message CylinderMesh {
-        optional float radius_top = 1; // default=1.0
-        optional float radius_bottom = 2; // default=1.0
-    }
-
-    message PlaneMesh {
-        repeated float uvs = 1;
-    }
-
-    message SphereMesh {
-    }
-
-    oneof mesh {
-        BoxMesh box = 1;
-        SphereMesh sphere = 2;
-        CylinderMesh cylinder = 3;
-        PlaneMesh plane = 4;
-    }
-}

package/ecs/components/NFTShape.proto

@@ -1,19 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1040;
-
-import "common/Color3.proto";
-
-message PBNFTShape {
-  // @deprecated use MeshCollider instead https://github.com/decentraland/sdk/issues/366
-  optional bool with_collisions = 1; // default=true
-  // @deprecated use MeshCollider instead https://github.com/decentraland/sdk/issues/366
-  optional bool is_pointer_blocker = 2; // default=true
-  // @deprecated use HiddenComponent instead https://github.com/decentraland/sdk/issues/353
-  optional bool visible = 3; // default=true
-  string src = 4;
-  optional string asset_id = 5;
-  optional int32 style = 6;
-  optional Color3 color = 7;
-}

package/ecs/components/OnPointerDown.proto

@@ -1,12 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1060;
-import "common/ActionButton.proto";
-
-message PBOnPointerDown {
-  optional ActionButton button = 1; // default=ActionButton.ANY
-  optional string hover_text = 2; // default='Interact'
-  optional float max_distance = 3; // default=10
-  optional bool show_feedback = 4; // default=true
-}

package/ecs/components/OnPointerDownResult.proto

@@ -1,17 +0,0 @@
-syntax = "proto3";
-
-import "common/id.proto";
-option (ecs_component_id) = 1066;
-import "common/Vector3.proto";
-import "common/ActionButton.proto";
-
-message PBOnPointerDownResult {
-  ActionButton button = 2;
-  string meshName = 3;
-  Vector3 origin = 4;
-  Vector3 direction = 5;
-  Vector3 point = 6;
-  Vector3 normal = 7;
-  float distance = 8;
-  int32 timestamp = 9;
-}