@dcl/protocol 1.0.0-3227242807.commit-ad14cba → 1.0.0-32360428523.commit-60c2fb5

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,46 @@
+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/explorer_ui_events_result.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/touch_screen_controls.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_input_binding.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/bff/authentication-service.proto

@@ -1,28 +0,0 @@
-syntax = "proto3";
-
-package decentraland.bff;
-
-message GetChallengeRequest {
-  string address = 1;
-}
-
-message GetChallengeResponse {
-  string challenge_to_sign = 1;
-  bool already_connected = 2;
-}
-
-message SignedChallenge {
-  string auth_chain_json = 1;
-}
-
-message WelcomePeerInformation {
-  string peer_id = 1;
-
-  // list of available modules in this BFF
-  repeated string available_modules = 2;
-}
-
-service BffAuthenticationService {
-  rpc GetChallenge(GetChallengeRequest) returns (GetChallengeResponse) {}
-  rpc Authenticate(SignedChallenge) returns (WelcomePeerInformation) {}
-}

package/bff/comms-director-service.proto

@@ -1,33 +0,0 @@
-syntax = "proto3";
-
-// CommsDirector are formalized at https://rfc.decentraland.org/adr/ADR-81
-
-import "google/protobuf/empty.proto";
-import "common/Vectors.proto";
-
-package decentraland.bff;
-
-message WorldCommand {
-  oneof command {
-    SetCommsAdapter set_comms_adapter = 1;
-  }
-}
-
-message SetCommsAdapter {
-  string connection_string = 1;
-}
-
-message Heartbeat {
-  decentraland.common.Position position = 1;
-  optional string desired_room = 2;
-}
-
-service CommsDirectorService {
-  // every couple seconds AND at the beginning, the explorers must send a heartbeat
-  // to make the comms director aware of their location
-  rpc SendHeartbeat(Heartbeat) returns (google.protobuf.Empty) {}
-
-  // before sending the first heartbeat, it is required that the explorers subscribe
-  // to a list of comms commands
-  rpc GetCommsCommands(google.protobuf.Empty) returns (stream WorldCommand) {}
-}

package/bff/comms-service.proto

@@ -1,25 +0,0 @@
-syntax = "proto3";
-
-import public "bff/topics-service.proto";
-package decentraland.bff;
-
-message Subscription {
-  uint32 subscription_id = 1;
-}
-
-message UnsubscriptionResult {
-  bool ok = 1;
-}
-
-service CommsService {
-  rpc SubscribeToPeerMessages(SubscriptionRequest) returns (Subscription) {}
-  rpc GetPeerMessages(Subscription) returns (stream PeerTopicSubscriptionResultElem) {}
-  rpc UnsubscribeToPeerMessages(Subscription) returns (UnsubscriptionResult) {}
-
-  rpc SubscribeToSystemMessages(SubscriptionRequest) returns (Subscription) {}
-  rpc GetSystemMessages(Subscription) returns (stream SystemTopicSubscriptionResultElem) {}
-  rpc UnsubscribeToSystemMessages(Subscription) returns (UnsubscriptionResult) {}
-
-  // send a peer message to a topic
-  rpc PublishToTopic(PublishToTopicRequest) returns (PublishToTopicResult) {}
-}

package/bff/http-endpoints.proto

@@ -1,78 +0,0 @@
-syntax = "proto3";
-
-import "google/protobuf/empty.proto";
-import "google/api/annotations.proto";
-
-package decentraland.bff;
-
-message AboutResponse {
-  bool healthy = 1;
-  AboutConfiguration configurations = 2;
-  ContentInfo content = 3;
-  CommsInfo comms = 4;
-  LambdasInfo lambdas = 5;
-  optional BffInfo bff = 6;
-
-  message MinimapConfiguration {
-    bool enabled = 1;
-    optional string data_image = 2;
-    optional string estate_image = 3;
-  }
-
-  message SkyboxConfiguration {
-    // only one value at a time
-    optional float fixed_hour = 1;
-  }
-
-  message AboutConfiguration {
-    optional string realm_name = 1;
-    uint32 network_id = 2;
-    repeated string global_scenes_urn = 3;
-    repeated string scenes_urn = 4;
-    optional MinimapConfiguration minimap = 5;
-    optional SkyboxConfiguration skybox = 6;
-  }
-
-  message ContentInfo {
-    // common properties
-    bool healthy = 1;
-    optional string version = 2;
-    optional string commit_hash = 3;
-    string public_url = 4;
-  }
-  message LambdasInfo {
-    // common properties
-    bool healthy = 1;
-    optional string version = 2;
-    optional string commit_hash = 3;
-    string public_url = 4;
-  }
-  message CommsInfo {
-    // common properties
-    bool healthy = 1;
-    optional string version = 2;
-    optional string commit_hash = 3;
-    optional string public_url = 4;
-    // specific properties
-    string protocol = 50;
-    optional int32 users_count = 51;
-    optional string fixed_adapter = 52;
-  }
-  message BffInfo {
-    // common properties
-    bool healthy = 1;
-    optional string version = 2;
-    optional string commit_hash = 3;
-    string public_url = 4;
-    // specific properties
-    optional int32 user_count = 51;
-    optional string protocol_version = 52;
-  }
-}
-
-service HttpEndpoints {
-  // Returns the status and configuration of the bff microservice
-  rpc About(google.protobuf.Empty) returns (AboutResponse) {
-    option (google.api.http) = { get: "/about" };
-  }
-}

package/bff/topics-service.proto

@@ -1,35 +0,0 @@
-syntax = "proto3";
-
-package decentraland.bff;
-
-message SubscriptionRequest {
-  string topic = 1;
-}
-
-message PeerTopicSubscriptionResultElem {
-  bytes payload = 1;
-  string topic = 2;
-  string sender = 3;
-}
-
-message SystemTopicSubscriptionResultElem {
-  bytes payload = 1;
-  string topic = 2;
-}
-
-message PublishToTopicRequest {
-  string topic = 1;
-  bytes payload = 2;
-}
-
-message PublishToTopicResult {
-  bool ok = 1;
-}
-
-service TopicsService {
-  rpc PeerSubscription(SubscriptionRequest) returns (stream PeerTopicSubscriptionResultElem) {}
-  rpc SystemSubscription(SubscriptionRequest) returns (stream SystemTopicSubscriptionResultElem) {}
-
-  // send a peer message to a topic
-  rpc PublishToTopic(PublishToTopicRequest) returns (PublishToTopicResult) {}
-}

package/bff-services.proto

@@ -1,16 +0,0 @@
-syntax = "proto3";
-
-// This version is used to check compatibility between Kernel<>BFF
-// Update it manually using semantic versioning. Patches may be skipped.
-package v1_0_0;
-
-// This file only imports all the services for the BFF to help the compiler
-// resolve all dependencies
-
-import public "bff/authentication-service.proto";
-import public "bff/http-endpoints.proto";
-import public "bff/topics-service.proto";
-import public "bff/comms-director-service.proto";
-
-// TO BE DELETED
-import public "bff/comms-service.proto";

package/ecs/components/Animator.proto

@@ -1,18 +0,0 @@
-syntax = "proto3";
-
-import "ecs/components/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 "ecs/components/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 "ecs/components/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 "ecs/components/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 "ecs/components/common/id.proto";
-option (ecs_component_id) = 1070;
-import "ecs/components/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,31 +0,0 @@
-syntax = "proto3";
-
-import "ecs/components/common/id.proto";
-option (ecs_component_id) = 1080;
-import "ecs/components/common/Color3.proto";
-
-message PBAvatarShape {
-  string id = 1;
-  optional string name = 2; // default = NPC
-  optional string body_shape = 3; // default = urn:decentraland:off-chain:base-avatars:BaseFemale
-  optional Color3 skin_color = 4; // default = Color3(R = 0.6f, G = 0.462f, B = 0.356f)
-  optional Color3 hair_color = 5; // default = Color3(R = 0.283f, G = 0.142f, B = 0f)
-  optional Color3 eye_color = 6; // default = Color3(R = 0.6f, G = 0.462f, B = 0.356f)
-  optional string expression_trigger_id = 7;
-  optional int64 expression_trigger_timestamp = 8; // default = timestamp
-  optional bool talking = 9;
-  /**
-   * default = ["urn:decentraland:off-chain:base-avatars:f_eyes_00", 
-   *  "urn:decentraland:off-chain:base-avatars:f_eyebrows_00",
-   *  "urn:decentraland:off-chain:base-avatars:f_mouth_00" 
-   *  "urn:decentraland:off-chain:base-avatars:standard_hair", 
-   *  "urn:decentraland:off-chain:base-avatars:f_simple_yellow_tshirt", 
-   *  "urn:decentraland:off-chain:base-avatars:f_brown_trousers", 
-   *  "urn:decentraland:off-chain:base-avatars:bun_shoes"]
-   */
-  repeated string wearables = 10;
-  /**
-   * default = []
-   */
-  repeated string emotes = 11;
-}