@ughuuu/gamend 1.0.0

package/dist/gamend_proto.js

@@ -0,0 +1,444 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PB = void 0;
+exports.decodeEvent = decodeEvent;
+exports.registerKvSchema = registerKvSchema;
+exports.registerMetaSchema = registerMetaSchema;
+var _gamend_realtimePb = require("./gamend_realtime.pb.js");
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; } /**
+ * GamendProto — protobuf event decoding for gamend realtime transports.
+ *
+ * Mirrors the server's `GamendWeb.EventCodec` mapping (single wire
+ * contract: proto/gamend_realtime.proto). Used by GameRealtime when
+ * constructed with `format: 'protobuf'` and by GameWebRTC DataChannels
+ * negotiated with `protocol: 'protobuf'`.
+ *
+ * Decoded payloads differ from JSON payloads in two documented ways:
+ *   - timestamps are unix-millisecond numbers (`*_ms` suffixed fields)
+ *   - arbitrary JSON values (metadata, KV data) are already parsed from
+ *     their bytes form back into JS values
+ */
+var PB = exports.PB = _gamend_realtimePb.gamend.realtime.v1;
+var td = new TextDecoder();
+
+// Game-registered metadata schemas: entity ('user'|'lobby'|'group'|'party')
+// -> protobufjs message class (or a custom (bytes) => value decoder).
+var metaSchemas = {};
+
+/**
+ * Registers the game's metadata schema for an entity so decoded events expose
+ * `metadata` as a plain object (mirrors the plugin-side UserMeta/LobbyMeta/...
+ * registration). Without a registration, binary metadata is left on the
+ * payload as raw `metadata_pb` bytes.
+ *
+ * @param {string} entity - 'user' | 'lobby' | 'group' | 'party'
+ * @param {Object|Function} schema - protobufjs class, or (Uint8Array) => value
+ */
+function registerMetaSchema(entity, schema) {
+  metaSchemas[entity] = schema;
+}
+
+// Game-registered KV data schemas: exact key or '*'-suffixed prefix pattern
+// -> protobufjs class (or a custom (bytes) => value decoder). Mirrors the
+// plugin's kv_schemas/0 registration.
+var kvSchemas = {
+  exact: {},
+  prefixes: []
+};
+
+/**
+ * Registers the game's KV data schema for a key or key-prefix pattern
+ * (e.g. 'loadout' or 'match:*'). Exact keys win; longest prefix wins.
+ * @param {string} pattern
+ * @param {Object|Function} schema - protobufjs class, or (Uint8Array) => value
+ */
+function registerKvSchema(pattern, schema) {
+  if (pattern.endsWith('*')) {
+    kvSchemas.prefixes.push([pattern.slice(0, -1), schema]);
+    kvSchemas.prefixes.sort(function (a, b) {
+      return b[0].length - a[0].length;
+    });
+  } else {
+    kvSchemas.exact[pattern] = schema;
+  }
+}
+function kvSchemaFor(key) {
+  if (kvSchemas.exact[key]) return kvSchemas.exact[key];
+  var hit = kvSchemas.prefixes.find(function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 1),
+      prefix = _ref2[0];
+    return key.startsWith(prefix);
+  });
+  return hit ? hit[1] : null;
+}
+function withMeta(obj, entity) {
+  if (obj.metadata_pb != null && obj.metadata_pb.length) {
+    var schema = metaSchemas[entity];
+    if (schema) {
+      obj.metadata = typeof schema === 'function' ? schema(obj.metadata_pb) : schema.toObject(schema.decode(obj.metadata_pb), {
+        defaults: true,
+        longs: Number
+      });
+      delete obj.metadata_pb;
+    }
+  }
+  return obj;
+}
+
+/** Parses a bytes-JSON field; empty/absent bytes decode to defaultValue. */
+function fromJsonBytes(bytes) {
+  var defaultValue = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : undefined;
+  if (!bytes || bytes.length === 0) return defaultValue;
+  return JSON.parse(td.decode(bytes));
+}
+
+/** Parses JSON-bytes fields into their JSON-mode field names. */
+function withParsedJson(obj, fields) {
+  var _iterator = _createForOfIteratorHelper(fields),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _step$value = _slicedToArray(_step.value, 2),
+        src = _step$value[0],
+        dest = _step$value[1];
+      if (obj[src] !== undefined && obj[src] !== null) {
+        obj[dest] = fromJsonBytes(obj[src], {});
+        if (src !== dest) delete obj[src];
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return obj;
+}
+function decodeUser(bin) {
+  var u = PB.User.decode(bin);
+  var out = PB.User.toObject(u, {
+    defaults: false,
+    longs: Number
+  });
+  return withMeta(withParsedJson(out, [['metadata_json', 'metadata']]), 'user');
+}
+var decoders = {
+  user: {
+    updated: decodeUser,
+    friend_updated: function friend_updated(bin) {
+      var msg = PB.FriendUpdate.decode(bin);
+      var friends = {};
+      for (var _i = 0, _Object$entries = Object.entries(msg.friends); _i < _Object$entries.length; _i++) {
+        var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+          id = _Object$entries$_i[0],
+          user = _Object$entries$_i[1];
+        friends[id] = withMeta(withParsedJson(PB.User.toObject(user, {
+          defaults: false,
+          longs: Number
+        }), [['metadata_json', 'metadata']]), 'user');
+      }
+      return {
+        friends: friends
+      };
+    },
+    group_invite_accepted: function group_invite_accepted(bin) {
+      return PB.GroupInviteEvent.toObject(PB.GroupInviteEvent.decode(bin));
+    },
+    group_invite_cancelled: function group_invite_cancelled(bin) {
+      return PB.GroupInviteEvent.toObject(PB.GroupInviteEvent.decode(bin));
+    },
+    group_join_request_approved: function group_join_request_approved(bin) {
+      return PB.GroupInviteEvent.toObject(PB.GroupInviteEvent.decode(bin));
+    },
+    group_join_request_rejected: function group_join_request_rejected(bin) {
+      return PB.GroupInviteEvent.toObject(PB.GroupInviteEvent.decode(bin));
+    },
+    party_invite_accepted: function party_invite_accepted(bin) {
+      return PB.PartyInviteEvent.toObject(PB.PartyInviteEvent.decode(bin));
+    },
+    party_invite_declined: function party_invite_declined(bin) {
+      return PB.PartyInviteEvent.toObject(PB.PartyInviteEvent.decode(bin));
+    },
+    party_invite_cancelled: function party_invite_cancelled(bin) {
+      return PB.PartyInviteEvent.toObject(PB.PartyInviteEvent.decode(bin));
+    },
+    tournament_updated: function tournament_updated(bin) {
+      return PB.TournamentEvent.toObject(PB.TournamentEvent.decode(bin));
+    },
+    tournament_finished: function tournament_finished(bin) {
+      return PB.TournamentEvent.toObject(PB.TournamentEvent.decode(bin));
+    },
+    tournament_match_ready: function tournament_match_ready(bin) {
+      return PB.TournamentMatchEvent.toObject(PB.TournamentMatchEvent.decode(bin), {
+        defaults: true,
+        longs: Number
+      });
+    },
+    tournament_match_resolved: function tournament_match_resolved(bin) {
+      return PB.TournamentMatchEvent.toObject(PB.TournamentMatchEvent.decode(bin), {
+        defaults: true,
+        longs: Number
+      });
+    },
+    match_found: function match_found(bin) {
+      return PB.MatchmakingFound.toObject(PB.MatchmakingFound.decode(bin), {
+        defaults: true
+      });
+    }
+  },
+  lobby: {
+    updated: function updated(bin) {
+      return decodeLobby(bin);
+    },
+    user_joined: function user_joined(bin) {
+      return decodeMember(bin);
+    },
+    user_left: function user_left(bin) {
+      return decodeMember(bin);
+    },
+    user_kicked: function user_kicked(bin) {
+      return decodeMember(bin);
+    },
+    host_changed: function host_changed(bin) {
+      return PB.HostChanged.toObject(PB.HostChanged.decode(bin));
+    },
+    user_online: function user_online(bin) {
+      return decodeMember(bin);
+    },
+    user_offline: function user_offline(bin) {
+      return decodeMember(bin);
+    },
+    user_updated: function user_updated(bin) {
+      return decodeBrief(bin);
+    }
+  },
+  lobbies: {
+    lobby_created: function lobby_created(bin) {
+      return decodeLobby(bin);
+    },
+    lobby_updated: function lobby_updated(bin) {
+      return decodeLobby(bin);
+    },
+    lobby_deleted: function lobby_deleted(bin) {
+      return PB.EntityId.toObject(PB.EntityId.decode(bin));
+    },
+    lobby_membership_changed: function lobby_membership_changed(bin) {
+      return PB.EntityId.toObject(PB.EntityId.decode(bin));
+    }
+  },
+  group: {
+    updated: function updated(bin) {
+      return decodeGroup(bin);
+    },
+    member_joined: function member_joined(bin) {
+      return decodeMember(bin);
+    },
+    member_left: function member_left(bin) {
+      return decodeMember(bin);
+    },
+    member_kicked: function member_kicked(bin) {
+      return decodeMember(bin);
+    },
+    member_promoted: function member_promoted(bin) {
+      return decodeMember(bin);
+    },
+    member_demoted: function member_demoted(bin) {
+      return decodeMember(bin);
+    },
+    join_request_approved: function join_request_approved(bin) {
+      return decodeMember(bin);
+    },
+    join_request_rejected: function join_request_rejected(bin) {
+      return decodeMember(bin);
+    },
+    member_online: function member_online(bin) {
+      return decodeMember(bin);
+    },
+    member_offline: function member_offline(bin) {
+      return decodeMember(bin);
+    },
+    member_updated: function member_updated(bin) {
+      return decodeBrief(bin);
+    }
+  },
+  groups: {
+    group_created: function group_created(bin) {
+      return decodeGroup(bin);
+    },
+    group_updated: function group_updated(bin) {
+      return decodeGroup(bin);
+    },
+    group_deleted: function group_deleted(bin) {
+      return PB.EntityId.toObject(PB.EntityId.decode(bin));
+    }
+  },
+  party: {
+    updated: function updated(bin) {
+      return withMeta(withParsedJson(PB.Party.toObject(PB.Party.decode(bin), {
+        defaults: false,
+        longs: Number
+      }), [['metadata_json', 'metadata']]), 'party');
+    },
+    member_joined: function member_joined(bin) {
+      return decodeMember(bin);
+    },
+    member_left: function member_left(bin) {
+      return decodeMember(bin);
+    },
+    member_online: function member_online(bin) {
+      return decodeMember(bin);
+    },
+    member_offline: function member_offline(bin) {
+      return decodeMember(bin);
+    },
+    member_updated: function member_updated(bin) {
+      return decodeBrief(bin);
+    },
+    disbanded: function disbanded(bin) {
+      return PB.PartyRef.toObject(PB.PartyRef.decode(bin));
+    }
+  }
+};
+function decodeLobby(bin) {
+  return withMeta(withParsedJson(PB.Lobby.toObject(PB.Lobby.decode(bin), {
+    defaults: false,
+    longs: Number
+  }), [['metadata_json', 'metadata']]), 'lobby');
+}
+function decodeGroup(bin) {
+  return withMeta(withParsedJson(PB.Group.toObject(PB.Group.decode(bin), {
+    defaults: false,
+    longs: Number
+  }), [['metadata_json', 'metadata']]), 'group');
+}
+function decodeMember(bin) {
+  return withMeta(withParsedJson(PB.MemberEvent.toObject(PB.MemberEvent.decode(bin), {
+    defaults: false,
+    longs: Number
+  }), [['metadata_json', 'metadata']]), 'user');
+}
+function decodeBrief(bin) {
+  return withMeta(withParsedJson(PB.UserBrief.toObject(PB.UserBrief.decode(bin), {
+    defaults: false,
+    longs: Number
+  }), [['metadata_json', 'metadata']]), 'user');
+}
+
+// Events with the same shape on every topic.
+var anyTopic = {
+  kv_updated: function kv_updated(bin) {
+    return decodeKv(bin);
+  },
+  kv_deleted: function kv_deleted(bin) {
+    return decodeKv(bin);
+  },
+  notification_created: function notification_created(bin) {
+    return withParsedJson(PB.Notification.toObject(PB.Notification.decode(bin), {
+      defaults: true,
+      longs: Number
+    }), [['metadata_json', 'metadata']]);
+  },
+  chat_message_created: function chat_message_created(bin) {
+    return decodeChat(bin);
+  },
+  chat_message_updated: function chat_message_updated(bin) {
+    return decodeChat(bin);
+  },
+  chat_message_deleted: function chat_message_deleted(bin) {
+    return PB.EntityId.toObject(PB.EntityId.decode(bin));
+  },
+  quest_progress: function quest_progress(bin) {
+    return decodeQuestProgress(bin);
+  },
+  quest_completed: function quest_completed(bin) {
+    return decodeQuestProgress(bin);
+  },
+  quest_claimed: function quest_claimed(bin) {
+    return decodeQuestProgress(bin);
+  },
+  // Ready checks arrive on lobby:<id> and, for an accept check, on user:<id>.
+  ready_check_started: function ready_check_started(bin) {
+    return decodeReadyCheck(bin);
+  },
+  ready_check_updated: function ready_check_updated(bin) {
+    return decodeReadyCheck(bin);
+  },
+  ready_check_passed: function ready_check_passed(bin) {
+    return decodeReadyCheck(bin);
+  },
+  ready_check_failed: function ready_check_failed(bin) {
+    return decodeReadyCheck(bin);
+  }
+};
+
+// `participants` is absent on an accept check: it carries counts only, so a
+// pending match does not reveal who you were paired with.
+function decodeReadyCheck(bin) {
+  return PB.ReadyCheckState.toObject(PB.ReadyCheckState.decode(bin), {
+    defaults: true,
+    longs: Number,
+    arrays: true
+  });
+}
+function decodeQuestProgress(bin) {
+  return withParsedJson(PB.QuestProgress.toObject(PB.QuestProgress.decode(bin), {
+    defaults: true,
+    longs: Number
+  }), [['metadata_json', 'metadata']]);
+}
+function decodeKv(bin) {
+  var msg = PB.KvEntry.decode(bin);
+  var kv = PB.KvEntry.toObject(msg, {
+    defaults: false
+  });
+  if (msg.data_json && msg.data_json.length) kv.data = fromJsonBytes(msg.data_json);
+  if (msg.metadata_json && msg.metadata_json.length) kv.metadata = fromJsonBytes(msg.metadata_json, {});
+  if (msg.data_pb && msg.data_pb.length) {
+    var schema = kvSchemaFor(msg.key);
+    if (schema) {
+      kv.data = typeof schema === 'function' ? schema(msg.data_pb) : schema.toObject(schema.decode(msg.data_pb), {
+        defaults: true,
+        longs: Number
+      });
+      delete kv.data_pb;
+    }
+    // unregistered: raw bytes stay on kv.data_pb
+  } else {
+    delete kv.data_pb;
+  }
+  delete kv.data_json;
+  delete kv.metadata_json;
+  return kv;
+}
+function decodeChat(bin) {
+  return withParsedJson(PB.ChatMessage.toObject(PB.ChatMessage.decode(bin), {
+    defaults: true,
+    longs: Number
+  }), [['metadata_json', 'metadata']]);
+}
+
+/**
+ * Decodes a binary event payload received on `topic` for `event`.
+ * Returns the decoded object, or null when the event has no protobuf
+ * mapping (callers should treat the frame as opaque).
+ *
+ * @param {string} topic  - Phoenix topic, e.g. "user:<id>" or "lobby:<id>"
+ * @param {string} event  - event name, e.g. "updated"
+ * @param {ArrayBuffer|Uint8Array} data
+ */
+function decodeEvent(topic, event, data) {
+  var kind = topic.split(':', 1)[0];
+  var bin = data instanceof Uint8Array ? data : new Uint8Array(data);
+  var decoder = decoders[kind] && decoders[kind][event] || anyTopic[event];
+  return decoder ? decoder(bin) : null;
+}
+
+/** Raw generated messages, for advanced use (RtcEnvelope etc.). */