ygopro-msg-encode 1.1.0 → 1.1.2

package/dist/index.cjs

@@ -39,6 +39,7 @@ var index_exports = {};
 __export(index_exports, {
   BattleCmdType: () => BattleCmdType,
   BinaryField: () => BinaryField,
+  CardData: () => CardData,
   CardQuery: () => CardQuery,
   CardQuery_CardLocation: () => CardQuery_CardLocation,
   CardQuery_Counter: () => CardQuery_Counter,
@@ -486,10 +487,14 @@ var toBinaryFields = (obj, useClass) => {
         const length = resolveLength(obj, info.length, key);
         let currentOffset = offset;
         for (let i = 0; i < length; i++) {
-          if (value[i]) {
+          if (value && i < value.length && value[i]) {
             const itemData = toBinaryFields(value[i], Constructor);
             data.set(itemData, currentOffset);
             currentOffset += itemData.length;
+          } else {
+            const emptyInstance = new Constructor();
+            const itemData = toBinaryFields(emptyInstance, Constructor);
+            currentOffset += itemData.length;
           }
         }
       } else {
@@ -508,7 +513,7 @@ var toBinaryFields = (obj, useClass) => {
     if (info.length != null) {
       const length = resolveLength(obj, info.length, key);
       for (let i = 0; i < length; i++) {
-        if (value[i] !== void 0 && value[i] !== null) {
+        if (value && i < value.length && value[i] !== void 0 && value[i] !== null) {
           writeValue(typeStr, offset + i * typeSize, value[i]);
         }
       }
@@ -582,449 +587,6 @@ var PayloadBase = class {
 };
 PayloadBase.identifier = 0;
 
-// src/protos/ctos/base.ts
-var YGOProCtosBase = class extends PayloadBase {
-  /**
-   * Serialize to full payload including header (length + identifier + body)
-   * Format: [length 2 bytes LE][identifier 1 byte][body]
-   * Length = 1 (identifier) + body.length
-   */
-  toFullPayload() {
-    const body = this.toPayload();
-    const length = 1 + body.length;
-    const fullPayload = new Uint8Array(3 + body.length);
-    fullPayload[0] = length & 255;
-    fullPayload[1] = length >> 8 & 255;
-    fullPayload[2] = this.identifier;
-    fullPayload.set(body, 3);
-    return fullPayload;
-  }
-  /**
-   * Deserialize from full payload including header (length + identifier + body)
-   * Format: [length 2 bytes LE][identifier 1 byte][body]
-   * @param data - Full payload data
-   * @returns this instance
-   * @throws Error if data is too short or identifier mismatch
-   */
-  fromFullPayload(data) {
-    if (data.length < 3) {
-      throw new Error(
-        `CTOS payload too short: expected at least 3 bytes, got ${data.length}`
-      );
-    }
-    const declaredLength = data[0] | data[1] << 8;
-    const identifier = data[2];
-    if (identifier !== this.identifier) {
-      throw new Error(
-        `CTOS identifier mismatch: expected 0x${this.identifier.toString(16)}, got 0x${identifier.toString(16)}`
-      );
-    }
-    const expectedTotalLength = 3 + declaredLength - 1;
-    if (data.length < expectedTotalLength) {
-      throw new Error(
-        `CTOS payload too short: declared length ${declaredLength} requires ${expectedTotalLength} bytes total, got ${data.length}`
-      );
-    }
-    const bodyData = data.length > expectedTotalLength ? data.slice(3, expectedTotalLength) : data.slice(3);
-    return this.fromPayload(bodyData);
-  }
-};
-
-// src/proto-base/registry-base.ts
-var RegistryBase = class {
-  constructor(payloadClass, options = {}) {
-    this.payloadClass = payloadClass;
-    this.options = options;
-    this.protos = /* @__PURE__ */ new Map();
-  }
-  register(proto) {
-    const identifier = proto.identifier;
-    this.protos.set(identifier, proto);
-  }
-  get(identifier) {
-    return this.protos.get(identifier);
-  }
-  getInstanceFromPayload(data) {
-    const identifier = data[this.options.identifierOffset ?? 0];
-    const proto = this.get(identifier);
-    if (!proto) {
-      return void 0;
-    }
-    return new proto().fromPayload(
-      data.slice(this.options.dataOffset ?? 0)
-    );
-  }
-};
-
-// src/protos/ctos/proto/response.ts
-var YGOProCtosResponse = class extends YGOProCtosBase {
-  fromPayload(data) {
-    this.response = data;
-    return this;
-  }
-  toPayload() {
-    return this.response || new Uint8Array(0);
-  }
-};
-YGOProCtosResponse.identifier = 1;
-
-// src/protos/ctos/proto/update-deck.ts
-var import_ygopro_deck_encode = __toESM(require("ygopro-deck-encode"));
-var YGOProCtosUpdateDeck = class extends YGOProCtosBase {
-  constructor() {
-    super();
-    this.deck = new import_ygopro_deck_encode.default();
-  }
-  fromPayload(data) {
-    this.deck = import_ygopro_deck_encode.default.fromUpdateDeckPayload(data);
-    return this;
-  }
-  toPayload() {
-    return this.deck.toUpdateDeckPayload();
-  }
-  fromPartial(data) {
-    if (data.deck) {
-      this.deck = new import_ygopro_deck_encode.default(data.deck);
-    }
-    return this;
-  }
-  copy() {
-    const copied = new this.constructor();
-    copied.deck = new import_ygopro_deck_encode.default(this.deck);
-    return copied;
-  }
-};
-YGOProCtosUpdateDeck.identifier = 2;
-
-// src/protos/ctos/proto/hand-result.ts
-var YGOProCtosHandResult = class extends YGOProCtosBase {
-};
-YGOProCtosHandResult.identifier = 3;
-__decorateClass([
-  BinaryField("u8", 0)
-], YGOProCtosHandResult.prototype, "res", 2);
-
-// src/protos/ctos/proto/tp-result.ts
-var YGOProCtosTpResult = class extends YGOProCtosBase {
-};
-YGOProCtosTpResult.identifier = 4;
-__decorateClass([
-  BinaryField("u8", 0)
-], YGOProCtosTpResult.prototype, "res", 2);
-
-// src/protos/ctos/proto/player-info.ts
-var YGOProCtosPlayerInfo = class extends YGOProCtosBase {
-};
-YGOProCtosPlayerInfo.identifier = 16;
-__decorateClass([
-  BinaryField("utf16", 0, 20)
-], YGOProCtosPlayerInfo.prototype, "name", 2);
-
-// src/protos/ctos/proto/create-game.ts
-var YGOProCtosCreateGame = class extends YGOProCtosBase {
-};
-YGOProCtosCreateGame.identifier = 17;
-__decorateClass([
-  BinaryField(() => HostInfo, 0)
-], YGOProCtosCreateGame.prototype, "info", 2);
-__decorateClass([
-  BinaryField("utf16", 20, 20)
-], YGOProCtosCreateGame.prototype, "name", 2);
-__decorateClass([
-  BinaryField("utf16", 60, 20)
-], YGOProCtosCreateGame.prototype, "pass", 2);
-
-// src/protos/ctos/proto/join-game.ts
-var YGOProCtosJoinGame = class extends YGOProCtosBase {
-};
-YGOProCtosJoinGame.identifier = 18;
-__decorateClass([
-  BinaryField("u16", 0)
-], YGOProCtosJoinGame.prototype, "version", 2);
-__decorateClass([
-  BinaryField("u32", 4)
-], YGOProCtosJoinGame.prototype, "gameid", 2);
-__decorateClass([
-  BinaryField("utf16", 8, 20)
-], YGOProCtosJoinGame.prototype, "pass", 2);
-
-// src/protos/ctos/proto/leave-game.ts
-var YGOProCtosLeaveGame = class extends YGOProCtosBase {
-};
-YGOProCtosLeaveGame.identifier = 19;
-
-// src/protos/ctos/proto/surrender.ts
-var YGOProCtosSurrender = class extends YGOProCtosBase {
-};
-YGOProCtosSurrender.identifier = 20;
-
-// src/protos/ctos/proto/time-confirm.ts
-var YGOProCtosTimeConfirm = class extends YGOProCtosBase {
-};
-YGOProCtosTimeConfirm.identifier = 21;
-
-// src/protos/ctos/proto/chat.ts
-var YGOProCtosChat = class extends YGOProCtosBase {
-  constructor() {
-    super();
-    this.msg = "";
-  }
-  fromPayload(data) {
-    const decoder = new TextDecoder("utf-16le");
-    this.msg = decoder.decode(data).replace(/\0+$/, "");
-    return this;
-  }
-  toPayload() {
-    const encoder = new TextEncoder();
-    const utf8 = encoder.encode(this.msg);
-    const decoder = new TextDecoder("utf-8");
-    const text = decoder.decode(utf8);
-    const utf16 = new Uint16Array(text.length + 1);
-    for (let i = 0; i < text.length; i++) {
-      utf16[i] = text.charCodeAt(i);
-    }
-    utf16[text.length] = 0;
-    const result = new Uint8Array(utf16.buffer);
-    return result;
-  }
-  fromPartial(data) {
-    if (data.msg !== void 0) {
-      this.msg = data.msg;
-    }
-    return this;
-  }
-};
-YGOProCtosChat.identifier = 22;
-
-// src/protos/ctos/proto/external-address.ts
-var YGOProCtosExternalAddress = class extends YGOProCtosBase {
-  constructor() {
-    super();
-    this.real_ip = "0.0.0.0";
-    this.hostname = "";
-  }
-  // Convert IPv4 string to uint32 (network byte order / big endian)
-  ipToUint32(ip) {
-    let ipv4 = ip;
-    if (ip.startsWith("::ffff:")) {
-      ipv4 = ip.substring(7);
-    }
-    const parts = ipv4.split(".");
-    if (parts.length !== 4) {
-      return 0;
-    }
-    const bytes = parts.map((p) => parseInt(p, 10));
-    if (bytes.some((b) => isNaN(b) || b < 0 || b > 255)) {
-      return 0;
-    }
-    return bytes[0] << 24 | bytes[1] << 16 | bytes[2] << 8 | bytes[3];
-  }
-  // Convert uint32 (network byte order / big endian) to IPv4 string
-  uint32ToIp(value) {
-    const byte1 = value >>> 24 & 255;
-    const byte2 = value >>> 16 & 255;
-    const byte3 = value >>> 8 & 255;
-    const byte4 = value & 255;
-    return `${byte1}.${byte2}.${byte3}.${byte4}`;
-  }
-  fromPayload(data) {
-    if (data.length < 4) {
-      throw new Error("CTOS_EXTERNAL_ADDRESS data too short");
-    }
-    const ipUint32 = data[0] << 24 | data[1] << 16 | data[2] << 8 | data[3];
-    this.real_ip = this.uint32ToIp(ipUint32);
-    if (data.length > 4) {
-      const decoder = new TextDecoder("utf-16le");
-      this.hostname = decoder.decode(data.slice(4)).replace(/\0+$/, "");
-    } else {
-      this.hostname = "";
-    }
-    return this;
-  }
-  toPayload() {
-    const encoder = new TextEncoder();
-    const utf8 = encoder.encode(this.hostname);
-    const decoder = new TextDecoder("utf-8");
-    const text = decoder.decode(utf8);
-    const utf16 = new Uint16Array(text.length + 1);
-    for (let i = 0; i < text.length; i++) {
-      utf16[i] = text.charCodeAt(i);
-    }
-    utf16[text.length] = 0;
-    const result = new Uint8Array(4 + utf16.byteLength);
-    const ipUint32 = this.ipToUint32(this.real_ip);
-    result[0] = ipUint32 >>> 24 & 255;
-    result[1] = ipUint32 >>> 16 & 255;
-    result[2] = ipUint32 >>> 8 & 255;
-    result[3] = ipUint32 & 255;
-    result.set(new Uint8Array(utf16.buffer), 4);
-    return result;
-  }
-  fromPartial(data) {
-    if (data.real_ip !== void 0) {
-      this.real_ip = data.real_ip;
-    }
-    if (data.hostname !== void 0) {
-      this.hostname = data.hostname;
-    }
-    return this;
-  }
-};
-YGOProCtosExternalAddress.identifier = 23;
-
-// src/protos/ctos/proto/hs-toduelist.ts
-var YGOProCtosHsToDuelist = class extends YGOProCtosBase {
-};
-YGOProCtosHsToDuelist.identifier = 32;
-
-// src/protos/ctos/proto/hs-toobserver.ts
-var YGOProCtosHsToObserver = class extends YGOProCtosBase {
-};
-YGOProCtosHsToObserver.identifier = 33;
-
-// src/protos/ctos/proto/hs-ready.ts
-var YGOProCtosHsReady = class extends YGOProCtosBase {
-};
-YGOProCtosHsReady.identifier = 34;
-
-// src/protos/ctos/proto/hs-notready.ts
-var YGOProCtosHsNotReady = class extends YGOProCtosBase {
-};
-YGOProCtosHsNotReady.identifier = 35;
-
-// src/protos/ctos/proto/kick.ts
-var YGOProCtosKick = class extends YGOProCtosBase {
-};
-YGOProCtosKick.identifier = 36;
-__decorateClass([
-  BinaryField("u8", 0)
-], YGOProCtosKick.prototype, "pos", 2);
-
-// src/protos/ctos/proto/hs-start.ts
-var YGOProCtosHsStart = class extends YGOProCtosBase {
-};
-YGOProCtosHsStart.identifier = 37;
-
-// src/protos/ctos/proto/request-field.ts
-var YGOProCtosRequestField = class extends YGOProCtosBase {
-};
-YGOProCtosRequestField.identifier = 48;
-
-// src/protos/ctos/registry.ts
-var YGOProCtos = new RegistryBase(YGOProCtosBase, {
-  identifierOffset: 2,
-  dataOffset: 3
-});
-YGOProCtos.register(YGOProCtosResponse);
-YGOProCtos.register(YGOProCtosUpdateDeck);
-YGOProCtos.register(YGOProCtosHandResult);
-YGOProCtos.register(YGOProCtosTpResult);
-YGOProCtos.register(YGOProCtosPlayerInfo);
-YGOProCtos.register(YGOProCtosCreateGame);
-YGOProCtos.register(YGOProCtosJoinGame);
-YGOProCtos.register(YGOProCtosLeaveGame);
-YGOProCtos.register(YGOProCtosSurrender);
-YGOProCtos.register(YGOProCtosTimeConfirm);
-YGOProCtos.register(YGOProCtosChat);
-YGOProCtos.register(YGOProCtosExternalAddress);
-YGOProCtos.register(YGOProCtosHsToDuelist);
-YGOProCtos.register(YGOProCtosHsToObserver);
-YGOProCtos.register(YGOProCtosHsReady);
-YGOProCtos.register(YGOProCtosHsNotReady);
-YGOProCtos.register(YGOProCtosKick);
-YGOProCtos.register(YGOProCtosHsStart);
-YGOProCtos.register(YGOProCtosRequestField);
-
-// src/protos/stoc/base.ts
-var YGOProStocBase = class extends PayloadBase {
-  /**
-   * Serialize to full payload including header (length + identifier + body)
-   * Format: [length 2 bytes LE][identifier 1 byte][body]
-   * Length = 1 (identifier) + body.length
-   */
-  toFullPayload() {
-    const body = this.toPayload();
-    const length = 1 + body.length;
-    const fullPayload = new Uint8Array(3 + body.length);
-    fullPayload[0] = length & 255;
-    fullPayload[1] = length >> 8 & 255;
-    fullPayload[2] = this.identifier;
-    fullPayload.set(body, 3);
-    return fullPayload;
-  }
-  /**
-   * Deserialize from full payload including header (length + identifier + body)
-   * Format: [length 2 bytes LE][identifier 1 byte][body]
-   * @param data - Full payload data
-   * @returns this instance
-   * @throws Error if data is too short or identifier mismatch
-   */
-  fromFullPayload(data) {
-    if (data.length < 3) {
-      throw new Error(
-        `STOC payload too short: expected at least 3 bytes, got ${data.length}`
-      );
-    }
-    const declaredLength = data[0] | data[1] << 8;
-    const identifier = data[2];
-    if (identifier !== this.identifier) {
-      throw new Error(
-        `STOC identifier mismatch: expected 0x${this.identifier.toString(16)}, got 0x${identifier.toString(16)}`
-      );
-    }
-    const expectedTotalLength = 3 + declaredLength - 1;
-    if (data.length < expectedTotalLength) {
-      throw new Error(
-        `STOC payload too short: declared length ${declaredLength} requires ${expectedTotalLength} bytes total, got ${data.length}`
-      );
-    }
-    const bodyData = data.length > expectedTotalLength ? data.slice(3, expectedTotalLength) : data.slice(3);
-    return this.fromPayload(bodyData);
-  }
-};
-
-// src/protos/msg/base.ts
-var YGOProMsgBase = class extends PayloadBase {
-  fromPayload(data) {
-    if (data.length < 1) {
-      throw new Error("MSG data too short");
-    }
-    const msgType = data[0];
-    if (msgType !== this.identifier) {
-      throw new Error(
-        `MSG type mismatch: expected ${this.identifier}, got ${msgType}`
-      );
-    }
-    return super.fromPayload(data.slice(1));
-  }
-  toPayload() {
-    const payload = super.toPayload();
-    const result = new Uint8Array(1 + payload.length);
-    result[0] = this.identifier;
-    result.set(payload, 1);
-    return result;
-  }
-  opponentView() {
-    return this.copy();
-  }
-  teammateView() {
-    return this.copy();
-  }
-  observerView() {
-    return this.opponentView();
-  }
-  playerView(playerId) {
-    if (typeof this["player"] === "number") {
-      const selfPlayerId = this["player"];
-      if (selfPlayerId === playerId) {
-        return this.copy();
-      }
-      return this.opponentView();
-    }
-    return this.copy();
-  }
-};
-
 // src/vendor/ocgcore-constants.ts
 var OcgcoreCommonConstants = {
   ACTIVITY_ATTACK: 5,
@@ -1387,6 +949,645 @@ var OcgcoreCommonConstants = {
   TYPE_XYZ: 8388608
 };
 
+// src/protos/common/card-data.ts
+var CARD_ARTWORK_VERSIONS_OFFSET = 20;
+var CARD_BLACK_LUSTER_SOLDIER2 = 5405695;
+var CARD_MARINE_DOLPHIN = 78734254;
+var CARD_TWINKLE_MOSS = 13857930;
+function checkSetcode(setcode, value) {
+  const settype = value & 4095;
+  const setsubtype = value & 61440;
+  return setcode && (setcode & 4095) === settype && (setcode & setsubtype) === setsubtype;
+}
+function isAlternative(code, alias) {
+  if (code === CARD_BLACK_LUSTER_SOLDIER2) {
+    return false;
+  }
+  return alias && alias < code + CARD_ARTWORK_VERSIONS_OFFSET && code < alias + CARD_ARTWORK_VERSIONS_OFFSET;
+}
+var CardData = class extends PayloadBase {
+  /**
+   * Check if this card belongs to a specific setcode
+   * @param value The setcode value to check against
+   * @returns true if the card belongs to the setcode
+   */
+  isSetCard(value) {
+    for (const x of this.setcode) {
+      if (!x) {
+        return false;
+      }
+      if (checkSetcode(x, value)) {
+        return true;
+      }
+    }
+    return false;
+  }
+  /**
+   * Get the original code of this card (handles alternate artworks)
+   * @returns The original card code
+   */
+  getOriginalCode() {
+    return isAlternative(this.code, this.alias) ? this.alias : this.code;
+  }
+  /**
+   * Check if this card can be declared with the given opcode filter
+   * @param opcode Array of opcodes that define the filter expression
+   * @returns true if the card can be declared
+   */
+  isDeclarable(opcode) {
+    const stack = [];
+    for (const it of opcode) {
+      switch (it) {
+        case OcgcoreCommonConstants.OPCODE_ADD: {
+          if (stack.length >= 2) {
+            const rhs = stack.pop();
+            const lhs = stack.pop();
+            stack.push(lhs + rhs);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_SUB: {
+          if (stack.length >= 2) {
+            const rhs = stack.pop();
+            const lhs = stack.pop();
+            stack.push(lhs - rhs);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_MUL: {
+          if (stack.length >= 2) {
+            const rhs = stack.pop();
+            const lhs = stack.pop();
+            stack.push(lhs * rhs);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_DIV: {
+          if (stack.length >= 2) {
+            const rhs = stack.pop();
+            const lhs = stack.pop();
+            stack.push(Math.floor(lhs / rhs));
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_AND: {
+          if (stack.length >= 2) {
+            const rhs = stack.pop();
+            const lhs = stack.pop();
+            stack.push(lhs && rhs ? 1 : 0);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_OR: {
+          if (stack.length >= 2) {
+            const rhs = stack.pop();
+            const lhs = stack.pop();
+            stack.push(lhs || rhs ? 1 : 0);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_NEG: {
+          if (stack.length >= 1) {
+            const val = stack.pop();
+            stack.push(-val);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_NOT: {
+          if (stack.length >= 1) {
+            const val = stack.pop();
+            stack.push(!val ? 1 : 0);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_ISCODE: {
+          if (stack.length >= 1) {
+            const code = stack.pop();
+            stack.push(this.code === code ? 1 : 0);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_ISSETCARD: {
+          if (stack.length >= 1) {
+            const setCode = stack.pop();
+            const res = this.isSetCard(setCode);
+            stack.push(res ? 1 : 0);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_ISTYPE: {
+          if (stack.length >= 1) {
+            const val = stack.pop();
+            stack.push(this.type & val ? 1 : 0);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_ISRACE: {
+          if (stack.length >= 1) {
+            const raceVal = stack.pop();
+            stack.push(this.race & raceVal ? 1 : 0);
+          }
+          break;
+        }
+        case OcgcoreCommonConstants.OPCODE_ISATTRIBUTE: {
+          if (stack.length >= 1) {
+            const attributeVal = stack.pop();
+            stack.push(this.attribute & attributeVal ? 1 : 0);
+          }
+          break;
+        }
+        default: {
+          stack.push(it);
+          break;
+        }
+      }
+    }
+    if (stack.length !== 1 || stack[0] === 0) {
+      return false;
+    }
+    return this.code === CARD_MARINE_DOLPHIN || this.code === CARD_TWINKLE_MOSS || !this.alias && (this.type & (OcgcoreCommonConstants.TYPE_MONSTER | OcgcoreCommonConstants.TYPE_TOKEN)) !== (OcgcoreCommonConstants.TYPE_MONSTER | OcgcoreCommonConstants.TYPE_TOKEN);
+  }
+};
+__decorateClass([
+  BinaryField("u32", 0)
+], CardData.prototype, "code", 2);
+__decorateClass([
+  BinaryField("u32", 4)
+], CardData.prototype, "alias", 2);
+__decorateClass([
+  BinaryField("u16", 8, 16)
+], CardData.prototype, "setcode", 2);
+__decorateClass([
+  BinaryField("u32", 40)
+], CardData.prototype, "type", 2);
+__decorateClass([
+  BinaryField("u32", 44)
+], CardData.prototype, "level", 2);
+__decorateClass([
+  BinaryField("u32", 48)
+], CardData.prototype, "attribute", 2);
+__decorateClass([
+  BinaryField("u32", 52)
+], CardData.prototype, "race", 2);
+__decorateClass([
+  BinaryField("i32", 56)
+], CardData.prototype, "attack", 2);
+__decorateClass([
+  BinaryField("i32", 60)
+], CardData.prototype, "defense", 2);
+__decorateClass([
+  BinaryField("u32", 64)
+], CardData.prototype, "lscale", 2);
+__decorateClass([
+  BinaryField("u32", 68)
+], CardData.prototype, "rscale", 2);
+__decorateClass([
+  BinaryField("u32", 72)
+], CardData.prototype, "linkMarker", 2);
+
+// src/protos/ctos/base.ts
+var YGOProCtosBase = class extends PayloadBase {
+  /**
+   * Serialize to full payload including header (length + identifier + body)
+   * Format: [length 2 bytes LE][identifier 1 byte][body]
+   * Length = 1 (identifier) + body.length
+   */
+  toFullPayload() {
+    const body = this.toPayload();
+    const length = 1 + body.length;
+    const fullPayload = new Uint8Array(3 + body.length);
+    fullPayload[0] = length & 255;
+    fullPayload[1] = length >> 8 & 255;
+    fullPayload[2] = this.identifier;
+    fullPayload.set(body, 3);
+    return fullPayload;
+  }
+  /**
+   * Deserialize from full payload including header (length + identifier + body)
+   * Format: [length 2 bytes LE][identifier 1 byte][body]
+   * @param data - Full payload data
+   * @returns this instance
+   * @throws Error if data is too short or identifier mismatch
+   */
+  fromFullPayload(data) {
+    if (data.length < 3) {
+      throw new Error(
+        `CTOS payload too short: expected at least 3 bytes, got ${data.length}`
+      );
+    }
+    const declaredLength = data[0] | data[1] << 8;
+    const identifier = data[2];
+    if (identifier !== this.identifier) {
+      throw new Error(
+        `CTOS identifier mismatch: expected 0x${this.identifier.toString(16)}, got 0x${identifier.toString(16)}`
+      );
+    }
+    const expectedTotalLength = 3 + declaredLength - 1;
+    if (data.length < expectedTotalLength) {
+      throw new Error(
+        `CTOS payload too short: declared length ${declaredLength} requires ${expectedTotalLength} bytes total, got ${data.length}`
+      );
+    }
+    const bodyData = data.length > expectedTotalLength ? data.slice(3, expectedTotalLength) : data.slice(3);
+    return this.fromPayload(bodyData);
+  }
+};
+
+// src/proto-base/registry-base.ts
+var RegistryBase = class {
+  constructor(payloadClass, options = {}) {
+    this.payloadClass = payloadClass;
+    this.options = options;
+    this.protos = /* @__PURE__ */ new Map();
+  }
+  register(proto) {
+    const identifier = proto.identifier;
+    this.protos.set(identifier, proto);
+  }
+  get(identifier) {
+    return this.protos.get(identifier);
+  }
+  getInstanceFromPayload(data) {
+    const identifier = data[this.options.identifierOffset ?? 0];
+    const proto = this.get(identifier);
+    if (!proto) {
+      return void 0;
+    }
+    return new proto().fromPayload(
+      data.slice(this.options.dataOffset ?? 0)
+    );
+  }
+};
+
+// src/protos/ctos/proto/response.ts
+var YGOProCtosResponse = class extends YGOProCtosBase {
+  fromPayload(data) {
+    this.response = data;
+    return this;
+  }
+  toPayload() {
+    return this.response || new Uint8Array(0);
+  }
+};
+YGOProCtosResponse.identifier = 1;
+
+// src/protos/ctos/proto/update-deck.ts
+var import_ygopro_deck_encode = __toESM(require("ygopro-deck-encode"));
+var YGOProCtosUpdateDeck = class extends YGOProCtosBase {
+  constructor() {
+    super();
+    this.deck = new import_ygopro_deck_encode.default();
+  }
+  fromPayload(data) {
+    this.deck = import_ygopro_deck_encode.default.fromUpdateDeckPayload(data);
+    return this;
+  }
+  toPayload() {
+    return this.deck.toUpdateDeckPayload();
+  }
+  fromPartial(data) {
+    if (data.deck) {
+      this.deck = new import_ygopro_deck_encode.default(data.deck);
+    }
+    return this;
+  }
+  copy() {
+    const copied = new this.constructor();
+    copied.deck = new import_ygopro_deck_encode.default(this.deck);
+    return copied;
+  }
+};
+YGOProCtosUpdateDeck.identifier = 2;
+
+// src/protos/ctos/proto/hand-result.ts
+var YGOProCtosHandResult = class extends YGOProCtosBase {
+};
+YGOProCtosHandResult.identifier = 3;
+__decorateClass([
+  BinaryField("u8", 0)
+], YGOProCtosHandResult.prototype, "res", 2);
+
+// src/protos/ctos/proto/tp-result.ts
+var YGOProCtosTpResult = class extends YGOProCtosBase {
+};
+YGOProCtosTpResult.identifier = 4;
+__decorateClass([
+  BinaryField("u8", 0)
+], YGOProCtosTpResult.prototype, "res", 2);
+
+// src/protos/ctos/proto/player-info.ts
+var YGOProCtosPlayerInfo = class extends YGOProCtosBase {
+};
+YGOProCtosPlayerInfo.identifier = 16;
+__decorateClass([
+  BinaryField("utf16", 0, 20)
+], YGOProCtosPlayerInfo.prototype, "name", 2);
+
+// src/protos/ctos/proto/create-game.ts
+var YGOProCtosCreateGame = class extends YGOProCtosBase {
+};
+YGOProCtosCreateGame.identifier = 17;
+__decorateClass([
+  BinaryField(() => HostInfo, 0)
+], YGOProCtosCreateGame.prototype, "info", 2);
+__decorateClass([
+  BinaryField("utf16", 20, 20)
+], YGOProCtosCreateGame.prototype, "name", 2);
+__decorateClass([
+  BinaryField("utf16", 60, 20)
+], YGOProCtosCreateGame.prototype, "pass", 2);
+
+// src/protos/ctos/proto/join-game.ts
+var YGOProCtosJoinGame = class extends YGOProCtosBase {
+};
+YGOProCtosJoinGame.identifier = 18;
+__decorateClass([
+  BinaryField("u16", 0)
+], YGOProCtosJoinGame.prototype, "version", 2);
+__decorateClass([
+  BinaryField("u32", 4)
+], YGOProCtosJoinGame.prototype, "gameid", 2);
+__decorateClass([
+  BinaryField("utf16", 8, 20)
+], YGOProCtosJoinGame.prototype, "pass", 2);
+
+// src/protos/ctos/proto/leave-game.ts
+var YGOProCtosLeaveGame = class extends YGOProCtosBase {
+};
+YGOProCtosLeaveGame.identifier = 19;
+
+// src/protos/ctos/proto/surrender.ts
+var YGOProCtosSurrender = class extends YGOProCtosBase {
+};
+YGOProCtosSurrender.identifier = 20;
+
+// src/protos/ctos/proto/time-confirm.ts
+var YGOProCtosTimeConfirm = class extends YGOProCtosBase {
+};
+YGOProCtosTimeConfirm.identifier = 21;
+
+// src/protos/ctos/proto/chat.ts
+var YGOProCtosChat = class extends YGOProCtosBase {
+  constructor() {
+    super();
+    this.msg = "";
+  }
+  fromPayload(data) {
+    const decoder = new TextDecoder("utf-16le");
+    this.msg = decoder.decode(data).replace(/\0+$/, "");
+    return this;
+  }
+  toPayload() {
+    const encoder = new TextEncoder();
+    const utf8 = encoder.encode(this.msg);
+    const decoder = new TextDecoder("utf-8");
+    const text = decoder.decode(utf8);
+    const utf16 = new Uint16Array(text.length + 1);
+    for (let i = 0; i < text.length; i++) {
+      utf16[i] = text.charCodeAt(i);
+    }
+    utf16[text.length] = 0;
+    const result = new Uint8Array(utf16.buffer);
+    return result;
+  }
+  fromPartial(data) {
+    if (data.msg !== void 0) {
+      this.msg = data.msg;
+    }
+    return this;
+  }
+};
+YGOProCtosChat.identifier = 22;
+
+// src/protos/ctos/proto/external-address.ts
+var YGOProCtosExternalAddress = class extends YGOProCtosBase {
+  constructor() {
+    super();
+    this.real_ip = "0.0.0.0";
+    this.hostname = "";
+  }
+  // Convert IPv4 string to uint32 (network byte order / big endian)
+  ipToUint32(ip) {
+    let ipv4 = ip;
+    if (ip.startsWith("::ffff:")) {
+      ipv4 = ip.substring(7);
+    }
+    const parts = ipv4.split(".");
+    if (parts.length !== 4) {
+      return 0;
+    }
+    const bytes = parts.map((p) => parseInt(p, 10));
+    if (bytes.some((b) => isNaN(b) || b < 0 || b > 255)) {
+      return 0;
+    }
+    return bytes[0] << 24 | bytes[1] << 16 | bytes[2] << 8 | bytes[3];
+  }
+  // Convert uint32 (network byte order / big endian) to IPv4 string
+  uint32ToIp(value) {
+    const byte1 = value >>> 24 & 255;
+    const byte2 = value >>> 16 & 255;
+    const byte3 = value >>> 8 & 255;
+    const byte4 = value & 255;
+    return `${byte1}.${byte2}.${byte3}.${byte4}`;
+  }
+  fromPayload(data) {
+    if (data.length < 4) {
+      throw new Error("CTOS_EXTERNAL_ADDRESS data too short");
+    }
+    const ipUint32 = data[0] << 24 | data[1] << 16 | data[2] << 8 | data[3];
+    this.real_ip = this.uint32ToIp(ipUint32);
+    if (data.length > 4) {
+      const decoder = new TextDecoder("utf-16le");
+      this.hostname = decoder.decode(data.slice(4)).replace(/\0+$/, "");
+    } else {
+      this.hostname = "";
+    }
+    return this;
+  }
+  toPayload() {
+    const encoder = new TextEncoder();
+    const utf8 = encoder.encode(this.hostname);
+    const decoder = new TextDecoder("utf-8");
+    const text = decoder.decode(utf8);
+    const utf16 = new Uint16Array(text.length + 1);
+    for (let i = 0; i < text.length; i++) {
+      utf16[i] = text.charCodeAt(i);
+    }
+    utf16[text.length] = 0;
+    const result = new Uint8Array(4 + utf16.byteLength);
+    const ipUint32 = this.ipToUint32(this.real_ip);
+    result[0] = ipUint32 >>> 24 & 255;
+    result[1] = ipUint32 >>> 16 & 255;
+    result[2] = ipUint32 >>> 8 & 255;
+    result[3] = ipUint32 & 255;
+    result.set(new Uint8Array(utf16.buffer), 4);
+    return result;
+  }
+  fromPartial(data) {
+    if (data.real_ip !== void 0) {
+      this.real_ip = data.real_ip;
+    }
+    if (data.hostname !== void 0) {
+      this.hostname = data.hostname;
+    }
+    return this;
+  }
+};
+YGOProCtosExternalAddress.identifier = 23;
+
+// src/protos/ctos/proto/hs-toduelist.ts
+var YGOProCtosHsToDuelist = class extends YGOProCtosBase {
+};
+YGOProCtosHsToDuelist.identifier = 32;
+
+// src/protos/ctos/proto/hs-toobserver.ts
+var YGOProCtosHsToObserver = class extends YGOProCtosBase {
+};
+YGOProCtosHsToObserver.identifier = 33;
+
+// src/protos/ctos/proto/hs-ready.ts
+var YGOProCtosHsReady = class extends YGOProCtosBase {
+};
+YGOProCtosHsReady.identifier = 34;
+
+// src/protos/ctos/proto/hs-notready.ts
+var YGOProCtosHsNotReady = class extends YGOProCtosBase {
+};
+YGOProCtosHsNotReady.identifier = 35;
+
+// src/protos/ctos/proto/kick.ts
+var YGOProCtosKick = class extends YGOProCtosBase {
+};
+YGOProCtosKick.identifier = 36;
+__decorateClass([
+  BinaryField("u8", 0)
+], YGOProCtosKick.prototype, "pos", 2);
+
+// src/protos/ctos/proto/hs-start.ts
+var YGOProCtosHsStart = class extends YGOProCtosBase {
+};
+YGOProCtosHsStart.identifier = 37;
+
+// src/protos/ctos/proto/request-field.ts
+var YGOProCtosRequestField = class extends YGOProCtosBase {
+};
+YGOProCtosRequestField.identifier = 48;
+
+// src/protos/ctos/registry.ts
+var YGOProCtos = new RegistryBase(YGOProCtosBase, {
+  identifierOffset: 2,
+  dataOffset: 3
+});
+YGOProCtos.register(YGOProCtosResponse);
+YGOProCtos.register(YGOProCtosUpdateDeck);
+YGOProCtos.register(YGOProCtosHandResult);
+YGOProCtos.register(YGOProCtosTpResult);
+YGOProCtos.register(YGOProCtosPlayerInfo);
+YGOProCtos.register(YGOProCtosCreateGame);
+YGOProCtos.register(YGOProCtosJoinGame);
+YGOProCtos.register(YGOProCtosLeaveGame);
+YGOProCtos.register(YGOProCtosSurrender);
+YGOProCtos.register(YGOProCtosTimeConfirm);
+YGOProCtos.register(YGOProCtosChat);
+YGOProCtos.register(YGOProCtosExternalAddress);
+YGOProCtos.register(YGOProCtosHsToDuelist);
+YGOProCtos.register(YGOProCtosHsToObserver);
+YGOProCtos.register(YGOProCtosHsReady);
+YGOProCtos.register(YGOProCtosHsNotReady);
+YGOProCtos.register(YGOProCtosKick);
+YGOProCtos.register(YGOProCtosHsStart);
+YGOProCtos.register(YGOProCtosRequestField);
+
+// src/protos/stoc/base.ts
+var YGOProStocBase = class extends PayloadBase {
+  /**
+   * Serialize to full payload including header (length + identifier + body)
+   * Format: [length 2 bytes LE][identifier 1 byte][body]
+   * Length = 1 (identifier) + body.length
+   */
+  toFullPayload() {
+    const body = this.toPayload();
+    const length = 1 + body.length;
+    const fullPayload = new Uint8Array(3 + body.length);
+    fullPayload[0] = length & 255;
+    fullPayload[1] = length >> 8 & 255;
+    fullPayload[2] = this.identifier;
+    fullPayload.set(body, 3);
+    return fullPayload;
+  }
+  /**
+   * Deserialize from full payload including header (length + identifier + body)
+   * Format: [length 2 bytes LE][identifier 1 byte][body]
+   * @param data - Full payload data
+   * @returns this instance
+   * @throws Error if data is too short or identifier mismatch
+   */
+  fromFullPayload(data) {
+    if (data.length < 3) {
+      throw new Error(
+        `STOC payload too short: expected at least 3 bytes, got ${data.length}`
+      );
+    }
+    const declaredLength = data[0] | data[1] << 8;
+    const identifier = data[2];
+    if (identifier !== this.identifier) {
+      throw new Error(
+        `STOC identifier mismatch: expected 0x${this.identifier.toString(16)}, got 0x${identifier.toString(16)}`
+      );
+    }
+    const expectedTotalLength = 3 + declaredLength - 1;
+    if (data.length < expectedTotalLength) {
+      throw new Error(
+        `STOC payload too short: declared length ${declaredLength} requires ${expectedTotalLength} bytes total, got ${data.length}`
+      );
+    }
+    const bodyData = data.length > expectedTotalLength ? data.slice(3, expectedTotalLength) : data.slice(3);
+    return this.fromPayload(bodyData);
+  }
+};
+
+// src/protos/msg/base.ts
+var YGOProMsgBase = class extends PayloadBase {
+  fromPayload(data) {
+    if (data.length < 1) {
+      throw new Error("MSG data too short");
+    }
+    const msgType = data[0];
+    if (msgType !== this.identifier) {
+      throw new Error(
+        `MSG type mismatch: expected ${this.identifier}, got ${msgType}`
+      );
+    }
+    return super.fromPayload(data.slice(1));
+  }
+  toPayload() {
+    const payload = super.toPayload();
+    const result = new Uint8Array(1 + payload.length);
+    result[0] = this.identifier;
+    result.set(payload, 1);
+    return result;
+  }
+  opponentView() {
+    return this.copy();
+  }
+  teammateView() {
+    return this.copy();
+  }
+  observerView() {
+    return this.opponentView();
+  }
+  playerView(playerId) {
+    if (typeof this["player"] === "number") {
+      const selfPlayerId = this["player"];
+      if (selfPlayerId === playerId) {
+        return this.copy();
+      }
+      return this.opponentView();
+    }
+    return this.copy();
+  }
+};
+
 // src/protos/msg/proto/add-counter.ts
 var YGOProMsgAddCounter = class extends YGOProMsgBase {
 };
@@ -5651,6 +5852,7 @@ var RoomStatus = /* @__PURE__ */ ((RoomStatus2) => {
 0 && (module.exports = {
   BattleCmdType,
   BinaryField,
+  CardData,
   CardQuery,
   CardQuery_CardLocation,
   CardQuery_Counter,