@rhyster/wow-casc-dbc 2.3.0 → 2.4.0

package/README.md

@@ -4,7 +4,11 @@ Node.js tool to fetch World of Warcraft data files from CASC and parse DBC/DB2 f
 
 ## Snippet
 
+### Basic Usage
+
 ```javascript
+import { CASCClient, WDCReader, DBDParser } from '@rhyster/wow-casc-dbc';
+
 // Get version
 const region = 'us';
 const product = 'wow';
@@ -14,10 +18,10 @@ const version = await CASCClient.getProductVersion(region, product);
 const client = new CASCClient(region, product, version);
 await client.init();
 await client.loadRemoteTACTKeys();
-await client.loadRemoteListFile();
+await client.loadRemoteListFile(); // pretty slow, recommend to provide fileDataID directly
 
 // Fetch file
-const fileDataID = client.getFileDataIDByName('dbfilesclient/questxp.db2');
+const fileDataID = client.getFileDataIDByName('dbfilesclient/questxp.db2'); // see previous line
 const cKeys = client.getContentKeysByFileDataID(fileDataID);
 const cKey = cKeys.find((data) => !!(data.localeFlags & CASCClient.LocaleFlags.enUS));
 const { buffer } = await client.getFileByContentKey(cKey.cKey);
@@ -27,8 +31,47 @@ const reader = new WDCReader(buffer);
 const parser = await DBDParser.parse(reader);
 
 // Access DB2 file
-// reader.getRowData
-// parser.getRowData
+reader.getAllIDs().forEach((id) => {
+    const rowFields = reader.getRowData(id);
+});
+parser.getAllIDs().forEach((id) => {
+    const rowObject = parser.getRowData(id);
+});
+```
+
+### Partial Decrypt
+
+Some file is encrypted and no key released yet. For DB2 files, you can ignore the encrypted part and parse the others.
+
+```javascript
+// ...
+
+const result = await client.getFileByContentKey(cKey.cKey, true);
+const reader = new WDCReader(result.buffer, result.type === 'partial' ? result.blocks : []);
+const parser = await DBDParser.parse(reader);
+
+// ...
+```
+
+### Hotfix
+
+Applying hotfix requires `DBCache.bin` file from the client, and it seems the only way to get this is from the client. So, you need to search for `DBCache.bin` yourself, like `<WoWPath>/_retail_/Cache/ADB/enUS/DBCache.bin` or download it somewhere.
+
+It's also important to compare build, region and locale with the db2 file that to be patched to avoid broken data.
+
+```javascript
+// ...
+
+const dbcache = await fs.readFile('path/to/DBCache.bin');
+const buffer = await fs.readFile('path/to/name.db2');
+
+const adb = new ADBReader(dbcache);
+assert(adb.build === parseInt(version.BuildId, 10));
+
+const reader = new WDCReader(buffer, [], adb);
+const parser = await DBDParser.parse(reader);
+
+// ...
 ```
 
 ## License

package/dist/index.cjs

@@ -19,17 +19,17 @@ const path__default = /*#__PURE__*/_interopDefaultCompat(path);
 const http__default = /*#__PURE__*/_interopDefaultCompat(http);
 const zlib__default = /*#__PURE__*/_interopDefaultCompat(zlib);
 
-var __defProp$5 = Object.defineProperty;
-var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$5 = (obj, key, value) => {
-  __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$6 = Object.defineProperty;
+var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$6 = (obj, key, value) => {
+  __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 class Store {
   constructor(dataFile) {
-    __publicField$5(this, "data");
-    __publicField$5(this, "dataFile");
-    __publicField$5(this, "promise");
+    __publicField$6(this, "data");
+    __publicField$6(this, "dataFile");
+    __publicField$6(this, "promise");
     this.dataFile = dataFile;
     this.data = {};
     this.promise = new Promise((resolve) => {
@@ -294,21 +294,21 @@ const parseArchiveIndex = (buffer, cKey) => {
   return result;
 };
 
-var __defProp$4 = Object.defineProperty;
-var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$4 = (obj, key, value) => {
-  __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$5 = Object.defineProperty;
+var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$5 = (obj, key, value) => {
+  __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 class Salsa20 {
   constructor(key, nonce) {
-    __publicField$4(this, "fixed");
-    __publicField$4(this, "key");
-    __publicField$4(this, "nonce");
-    __publicField$4(this, "counter", new Uint32Array([0, 0]));
-    __publicField$4(this, "state", new Uint32Array(16));
-    __publicField$4(this, "block", new Uint8Array(64));
-    __publicField$4(this, "position", 0);
+    __publicField$5(this, "fixed");
+    __publicField$5(this, "key");
+    __publicField$5(this, "nonce");
+    __publicField$5(this, "counter", new Uint32Array([0, 0]));
+    __publicField$5(this, "state", new Uint32Array(16));
+    __publicField$5(this, "block", new Uint8Array(64));
+    __publicField$5(this, "position", 0);
     assert__default(key.length === 32 || key.length === 16, "Salsa20 requires 128-bit or 256-bit key");
     assert__default(nonce.length === 8, "Salsa20 requires 64-bit nonce");
     this.key = new Uint32Array(8);
@@ -411,10 +411,10 @@ class Salsa20 {
   }
 }
 
-var __defProp$3 = Object.defineProperty;
-var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$3 = (obj, key, value) => {
-  __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$4 = Object.defineProperty;
+var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$4 = (obj, key, value) => {
+  __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const BLTE_MAGIC = 1112298565;
@@ -422,12 +422,12 @@ const ENC_TYPE_SALSA20 = 83;
 const EMPTY_HASH = "00000000000000000000000000000000";
 class BLTEReader {
   constructor(buffer, eKey, keys = /* @__PURE__ */ new Map()) {
-    __publicField$3(this, "buffer");
-    __publicField$3(this, "blte");
-    __publicField$3(this, "blocks", []);
-    __publicField$3(this, "keys");
-    __publicField$3(this, "processedBlock", 0);
-    __publicField$3(this, "processedOffset", 0);
+    __publicField$4(this, "buffer");
+    __publicField$4(this, "blte");
+    __publicField$4(this, "blocks", []);
+    __publicField$4(this, "keys");
+    __publicField$4(this, "processedBlock", 0);
+    __publicField$4(this, "processedOffset", 0);
     this.blte = buffer;
     this.buffer = Buffer.alloc(0);
     this.keys = keys;
@@ -895,10 +895,10 @@ const getNameHash = (name) => {
   return `${pc.toString(16).padStart(8, "0")}${pb.toString(16).padStart(8, "0")}`;
 };
 
-var __defProp$2 = Object.defineProperty;
-var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$2 = (obj, key, value) => {
-  __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => {
+  __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const WDC5_MAGIC = 1464091445;
@@ -924,17 +924,18 @@ const readBitpackedValue = (buffer, fieldOffsetBits, fieldSizeBits, signed = fal
   return signed ? BigInt.asIntN(fieldSizeBits, value >> BigInt(bitOffset)) : BigInt.asUintN(fieldSizeBits, value >> BigInt(bitOffset));
 };
 class WDCReader {
-  constructor(buffer, blocks = []) {
-    __publicField$2(this, "tableHash");
-    __publicField$2(this, "layoutHash");
-    __publicField$2(this, "locale");
-    __publicField$2(this, "isNormal");
-    __publicField$2(this, "hasRelationshipData");
-    __publicField$2(this, "fields");
-    __publicField$2(this, "fieldsInfo");
-    __publicField$2(this, "rows", /* @__PURE__ */ new Map());
-    __publicField$2(this, "relationships", /* @__PURE__ */ new Map());
-    __publicField$2(this, "copyTable", /* @__PURE__ */ new Map());
+  constructor(buffer, blocks = [], adb) {
+    __publicField$3(this, "tableHash");
+    __publicField$3(this, "layoutHash");
+    __publicField$3(this, "locale");
+    __publicField$3(this, "isNormal");
+    __publicField$3(this, "hasRelationshipData");
+    __publicField$3(this, "fields");
+    __publicField$3(this, "fieldsInfo");
+    __publicField$3(this, "rows", /* @__PURE__ */ new Map());
+    __publicField$3(this, "relationships", /* @__PURE__ */ new Map());
+    __publicField$3(this, "copyTable", /* @__PURE__ */ new Map());
+    __publicField$3(this, "hotfixes", /* @__PURE__ */ new Map());
     const magic = buffer.readUInt32BE(0);
     const fieldCount = buffer.readUInt32LE(140);
     const recordSize = buffer.readUInt32LE(144);
@@ -1339,11 +1340,43 @@ class WDCReader {
         }
       }
     });
+    const entries = adb?.tableEntries.get(tableHash);
+    entries?.filter((entry) => entry.pushID !== -1).sort((a, b) => a.pushID - b.pushID).forEach((entry) => {
+      switch (entry.recordState) {
+        case 1:
+          this.hotfixes.set(entry.recordID, { type: "modify", data: entry.data });
+          break;
+        case 2:
+          this.hotfixes.set(entry.recordID, { type: "delete" });
+          break;
+        case 3:
+          this.hotfixes.delete(entry.recordID);
+          break;
+        case 4:
+          break;
+        default:
+          throw new Error(`Unknown record state: ${entry.recordState.toString()}`);
+      }
+    });
   }
   getAllIDs() {
     return [...this.rows.keys(), ...this.copyTable.keys()];
   }
   getRowData(id) {
+    const hotfix = this.hotfixes.get(id);
+    if (hotfix) {
+      switch (hotfix.type) {
+        case "modify":
+          return {
+            type: "sparse",
+            data: hotfix.data
+          };
+        case "delete":
+          return void 0;
+        default:
+          throw new Error("Unreachable");
+      }
+    }
     const dst = this.copyTable.get(id);
     if (dst) {
       return this.rows.get(dst);
@@ -1405,10 +1438,10 @@ const formatFileSize = (input) => {
   return result.join(" ");
 };
 
-var __defProp$1 = Object.defineProperty;
-var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$1 = (obj, key, value) => {
-  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => {
+  __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
@@ -1421,13 +1454,13 @@ var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
 const textLogLevel = ["ERROR", "WARN", "INFO", "DEBUG"];
 class CASCClient {
   constructor(region, product, version, logLevel = 2 /* info */) {
-    __publicField$1(this, "region");
-    __publicField$1(this, "product");
-    __publicField$1(this, "version");
-    __publicField$1(this, "name2FileDataID", /* @__PURE__ */ new Map());
-    __publicField$1(this, "keys", /* @__PURE__ */ new Map());
-    __publicField$1(this, "preload");
-    __publicField$1(this, "logLevel");
+    __publicField$2(this, "region");
+    __publicField$2(this, "product");
+    __publicField$2(this, "version");
+    __publicField$2(this, "name2FileDataID", /* @__PURE__ */ new Map());
+    __publicField$2(this, "keys", /* @__PURE__ */ new Map());
+    __publicField$2(this, "preload");
+    __publicField$2(this, "logLevel");
     this.region = region;
     this.product = product;
     this.version = version;
@@ -1572,7 +1605,7 @@ class CASCClient {
     ]);
     const keysReader = new WDCReader(keysResult.buffer);
     const lookupReader = new WDCReader(lookupResult.buffer);
-    [...lookupReader.rows.keys()].forEach((keyID) => {
+    lookupReader.getAllIDs().forEach((keyID) => {
       const lookupRow = lookupReader.rows.get(keyID);
       const keyRow = keysReader.rows.get(keyID);
       if (keyRow) {
@@ -1588,6 +1621,31 @@ class CASCClient {
       }
     });
   }
+  loadBroadcastTACTKeys(adb) {
+    adb.tableEntries.get(35137211)?.forEach(({ data }) => {
+      if (data.byteLength > 0) {
+        let pointer = 0;
+        while (data[pointer] !== 0) {
+          pointer += 1;
+        }
+        pointer += 1;
+        while (data[pointer] !== 0) {
+          pointer += 1;
+        }
+        pointer += 1 + 43;
+        if (pointer < data.byteLength) {
+          const extraTableHash = data.readUInt32LE(pointer);
+          if (extraTableHash === 3744420815) {
+            const keyName = data.readBigUInt64LE(pointer + 4).toString(16).padStart(16, "0");
+            const key = Uint8Array.from(data.subarray(pointer + 12));
+            if (!this.keys.has(keyName)) {
+              this.keys.set(keyName, key);
+            }
+          }
+        }
+      }
+    });
+  }
   getFileDataIDByName(name) {
     assert__default(this.preload, "Client not initialized");
     const { rootFile } = this.preload;
@@ -1641,14 +1699,14 @@ class CASCClient {
     };
   }
 }
-__publicField$1(CASCClient, "LocaleFlags", LocaleFlags);
-__publicField$1(CASCClient, "ContentFlags", ContentFlags);
-__publicField$1(CASCClient, "LogLevel", LogLevel);
+__publicField$2(CASCClient, "LocaleFlags", LocaleFlags);
+__publicField$2(CASCClient, "ContentFlags", ContentFlags);
+__publicField$2(CASCClient, "LogLevel", LogLevel);
 
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$1 = Object.defineProperty;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$1 = (obj, key, value) => {
+  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const PATTERN_COLUMN = /^(int|float|locstring|string)(<[^:]+::[^>]+>)?\s([^\s]+)/;
@@ -1684,10 +1742,10 @@ const castBigInt64 = (value, srcSigned, dstSigned) => {
 };
 class DBDParser {
   constructor(wdc) {
-    __publicField(this, "wdc");
-    __publicField(this, "definitions", /* @__PURE__ */ new Map());
-    __publicField(this, "columns", []);
-    __publicField(this, "cache", /* @__PURE__ */ new Map());
+    __publicField$1(this, "wdc");
+    __publicField$1(this, "definitions", /* @__PURE__ */ new Map());
+    __publicField$1(this, "columns", []);
+    __publicField$1(this, "cache", /* @__PURE__ */ new Map());
     this.wdc = wdc;
   }
   async init() {
@@ -1855,6 +1913,9 @@ class DBDParser {
         if (column.isID) {
           data[column.name] = id;
           if (column.isInline) {
+            const currField = this.wdc.fields[fieldIndex];
+            const size = Math.ceil((column.size ?? 32 - currField.size) / 8);
+            offset += size;
             fieldIndex += 1;
           }
         } else if (column.isInline) {
@@ -1876,7 +1937,7 @@ class DBDParser {
             const size = Math.ceil((column.size ?? 32 - currField.size) / 8);
             let count;
             if (fieldIndex + 1 < this.wdc.fields.length) {
-              count = (nextField.position - currField.position) / size;
+              count = Math.max((nextField.position - currField.position) / size, 1);
             } else {
               count = column.arraySize ? (buffer.byteLength - offset) / size : 1;
             }
@@ -1910,6 +1971,58 @@ class DBDParser {
   }
 }
 
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+const ADB_MAGIC = 1481004104;
+class ADBReader {
+  constructor(buffer) {
+    __publicField(this, "build");
+    __publicField(this, "entries", []);
+    __publicField(this, "tableEntries", /* @__PURE__ */ new Map());
+    const magic = buffer.readUInt32BE(0);
+    assert__default(magic === ADB_MAGIC, `[ADB]: Invalid magic: ${magic.toString(16).padStart(8, "0")}`);
+    const version = buffer.readUInt32LE(4);
+    assert__default(version === 9, `[ADB]: Invalid version: ${version.toString()}`);
+    const build = buffer.readUInt32LE(8);
+    this.build = build;
+    let pointer = 44;
+    while (pointer < buffer.byteLength) {
+      const offset = pointer;
+      const entryMagic = buffer.readUInt32BE(offset);
+      assert__default(entryMagic === ADB_MAGIC, `[ADB]: Invalid entry magic: ${magic.toString(16).padStart(8, "0")}`);
+      const regionID = buffer.readInt32LE(offset + 4);
+      const pushID = buffer.readInt32LE(offset + 8);
+      const uniqueID = buffer.readUInt32LE(offset + 12);
+      const tableHash = buffer.readUInt32LE(offset + 16);
+      const recordID = buffer.readUInt32LE(offset + 20);
+      const dataSize = buffer.readUInt32LE(offset + 24);
+      const recordState = buffer.readUInt32LE(offset + 28);
+      const data = buffer.subarray(offset + 32, offset + 32 + dataSize);
+      const entry = {
+        regionID,
+        pushID,
+        uniqueID,
+        tableHash,
+        recordID,
+        dataSize,
+        recordState,
+        data
+      };
+      this.entries.push(entry);
+      if (!this.tableEntries.has(tableHash)) {
+        this.tableEntries.set(tableHash, []);
+      }
+      this.tableEntries.get(tableHash)?.push(entry);
+      pointer += 32 + dataSize;
+    }
+  }
+}
+
+exports.ADBReader = ADBReader;
 exports.CASCClient = CASCClient;
 exports.DBDParser = DBDParser;
 exports.WDCReader = WDCReader;

package/dist/index.d.cts

@@ -42,6 +42,23 @@ interface MissingKeyBlock {
     keyName: string;
 }
 
+interface HotfixEntry {
+    regionID: number;
+    pushID: number;
+    uniqueID: number;
+    tableHash: number;
+    recordID: number;
+    dataSize: number;
+    recordState: number;
+    data: Buffer;
+}
+declare class ADBReader {
+    build: number;
+    entries: HotfixEntry[];
+    tableEntries: Map<number, HotfixEntry[]>;
+    constructor(buffer: Buffer);
+}
+
 interface ClientPreloadData {
     prefixes: string[];
     archives: ReturnType<typeof parseArchiveIndex>;
@@ -111,6 +128,7 @@ declare class CASCClient {
     loadRemoteListFile(): Promise<void>;
     loadRemoteTACTKeys(): Promise<void>;
     loadTACTKeys(): Promise<void>;
+    loadBroadcastTACTKeys(adb: ADBReader): void;
     getFileDataIDByName(name: string): number | undefined;
     getContentKeysByFileDataID(fileDataID: number): FileInfo[] | undefined;
     getFileByContentKey(cKey: string, allowMissingKey?: false): Promise<FileFetchResultFull>;
@@ -192,6 +210,14 @@ interface SparseRow {
     type: 'sparse';
     data: Buffer;
 }
+interface HotfixModify {
+    type: 'modify';
+    data: Buffer;
+}
+interface HotfixDelete {
+    type: 'delete';
+}
+type Hotfix = HotfixModify | HotfixDelete;
 declare class WDCReader {
     readonly tableHash: number;
     readonly layoutHash: number;
@@ -203,7 +229,8 @@ declare class WDCReader {
     readonly rows: Map<number, SparseRow | ParsedField[]>;
     readonly relationships: Map<number, number>;
     readonly copyTable: Map<number, number>;
-    constructor(buffer: Buffer, blocks?: MissingKeyBlock[]);
+    readonly hotfixes: Map<number, Hotfix>;
+    constructor(buffer: Buffer, blocks?: MissingKeyBlock[], adb?: ADBReader);
     getAllIDs(): number[];
     getRowData(id: number): ParsedField[] | SparseRow | undefined;
     getRowRelationship(id: number): number | undefined;
@@ -232,4 +259,4 @@ declare class DBDParser {
     getRowData(id: number): Record<string, ColumnData | ColumnData[]> | undefined;
 }
 
-export { CASCClient, DBDParser, WDCReader };
+export { ADBReader, CASCClient, DBDParser, WDCReader };

package/dist/index.d.mts

@@ -42,6 +42,23 @@ interface MissingKeyBlock {
     keyName: string;
 }
 
+interface HotfixEntry {
+    regionID: number;
+    pushID: number;
+    uniqueID: number;
+    tableHash: number;
+    recordID: number;
+    dataSize: number;
+    recordState: number;
+    data: Buffer;
+}
+declare class ADBReader {
+    build: number;
+    entries: HotfixEntry[];
+    tableEntries: Map<number, HotfixEntry[]>;
+    constructor(buffer: Buffer);
+}
+
 interface ClientPreloadData {
     prefixes: string[];
     archives: ReturnType<typeof parseArchiveIndex>;
@@ -111,6 +128,7 @@ declare class CASCClient {
     loadRemoteListFile(): Promise<void>;
     loadRemoteTACTKeys(): Promise<void>;
     loadTACTKeys(): Promise<void>;
+    loadBroadcastTACTKeys(adb: ADBReader): void;
     getFileDataIDByName(name: string): number | undefined;
     getContentKeysByFileDataID(fileDataID: number): FileInfo[] | undefined;
     getFileByContentKey(cKey: string, allowMissingKey?: false): Promise<FileFetchResultFull>;
@@ -192,6 +210,14 @@ interface SparseRow {
     type: 'sparse';
     data: Buffer;
 }
+interface HotfixModify {
+    type: 'modify';
+    data: Buffer;
+}
+interface HotfixDelete {
+    type: 'delete';
+}
+type Hotfix = HotfixModify | HotfixDelete;
 declare class WDCReader {
     readonly tableHash: number;
     readonly layoutHash: number;
@@ -203,7 +229,8 @@ declare class WDCReader {
     readonly rows: Map<number, SparseRow | ParsedField[]>;
     readonly relationships: Map<number, number>;
     readonly copyTable: Map<number, number>;
-    constructor(buffer: Buffer, blocks?: MissingKeyBlock[]);
+    readonly hotfixes: Map<number, Hotfix>;
+    constructor(buffer: Buffer, blocks?: MissingKeyBlock[], adb?: ADBReader);
     getAllIDs(): number[];
     getRowData(id: number): ParsedField[] | SparseRow | undefined;
     getRowRelationship(id: number): number | undefined;
@@ -232,4 +259,4 @@ declare class DBDParser {
     getRowData(id: number): Record<string, ColumnData | ColumnData[]> | undefined;
 }
 
-export { CASCClient, DBDParser, WDCReader };
+export { ADBReader, CASCClient, DBDParser, WDCReader };

package/dist/index.d.ts

@@ -42,6 +42,23 @@ interface MissingKeyBlock {
     keyName: string;
 }
 
+interface HotfixEntry {
+    regionID: number;
+    pushID: number;
+    uniqueID: number;
+    tableHash: number;
+    recordID: number;
+    dataSize: number;
+    recordState: number;
+    data: Buffer;
+}
+declare class ADBReader {
+    build: number;
+    entries: HotfixEntry[];
+    tableEntries: Map<number, HotfixEntry[]>;
+    constructor(buffer: Buffer);
+}
+
 interface ClientPreloadData {
     prefixes: string[];
     archives: ReturnType<typeof parseArchiveIndex>;
@@ -111,6 +128,7 @@ declare class CASCClient {
     loadRemoteListFile(): Promise<void>;
     loadRemoteTACTKeys(): Promise<void>;
     loadTACTKeys(): Promise<void>;
+    loadBroadcastTACTKeys(adb: ADBReader): void;
     getFileDataIDByName(name: string): number | undefined;
     getContentKeysByFileDataID(fileDataID: number): FileInfo[] | undefined;
     getFileByContentKey(cKey: string, allowMissingKey?: false): Promise<FileFetchResultFull>;
@@ -192,6 +210,14 @@ interface SparseRow {
     type: 'sparse';
     data: Buffer;
 }
+interface HotfixModify {
+    type: 'modify';
+    data: Buffer;
+}
+interface HotfixDelete {
+    type: 'delete';
+}
+type Hotfix = HotfixModify | HotfixDelete;
 declare class WDCReader {
     readonly tableHash: number;
     readonly layoutHash: number;
@@ -203,7 +229,8 @@ declare class WDCReader {
     readonly rows: Map<number, SparseRow | ParsedField[]>;
     readonly relationships: Map<number, number>;
     readonly copyTable: Map<number, number>;
-    constructor(buffer: Buffer, blocks?: MissingKeyBlock[]);
+    readonly hotfixes: Map<number, Hotfix>;
+    constructor(buffer: Buffer, blocks?: MissingKeyBlock[], adb?: ADBReader);
     getAllIDs(): number[];
     getRowData(id: number): ParsedField[] | SparseRow | undefined;
     getRowRelationship(id: number): number | undefined;
@@ -232,4 +259,4 @@ declare class DBDParser {
     getRowData(id: number): Record<string, ColumnData | ColumnData[]> | undefined;
 }
 
-export { CASCClient, DBDParser, WDCReader };
+export { ADBReader, CASCClient, DBDParser, WDCReader };

package/dist/index.mjs

@@ -7,17 +7,17 @@ import path from 'node:path';
 import http from 'node:http';
 import zlib from 'node:zlib';
 
-var __defProp$5 = Object.defineProperty;
-var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$5 = (obj, key, value) => {
-  __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$6 = Object.defineProperty;
+var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$6 = (obj, key, value) => {
+  __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 class Store {
   constructor(dataFile) {
-    __publicField$5(this, "data");
-    __publicField$5(this, "dataFile");
-    __publicField$5(this, "promise");
+    __publicField$6(this, "data");
+    __publicField$6(this, "dataFile");
+    __publicField$6(this, "promise");
     this.dataFile = dataFile;
     this.data = {};
     this.promise = new Promise((resolve) => {
@@ -282,21 +282,21 @@ const parseArchiveIndex = (buffer, cKey) => {
   return result;
 };
 
-var __defProp$4 = Object.defineProperty;
-var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$4 = (obj, key, value) => {
-  __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$5 = Object.defineProperty;
+var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$5 = (obj, key, value) => {
+  __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 class Salsa20 {
   constructor(key, nonce) {
-    __publicField$4(this, "fixed");
-    __publicField$4(this, "key");
-    __publicField$4(this, "nonce");
-    __publicField$4(this, "counter", new Uint32Array([0, 0]));
-    __publicField$4(this, "state", new Uint32Array(16));
-    __publicField$4(this, "block", new Uint8Array(64));
-    __publicField$4(this, "position", 0);
+    __publicField$5(this, "fixed");
+    __publicField$5(this, "key");
+    __publicField$5(this, "nonce");
+    __publicField$5(this, "counter", new Uint32Array([0, 0]));
+    __publicField$5(this, "state", new Uint32Array(16));
+    __publicField$5(this, "block", new Uint8Array(64));
+    __publicField$5(this, "position", 0);
     assert(key.length === 32 || key.length === 16, "Salsa20 requires 128-bit or 256-bit key");
     assert(nonce.length === 8, "Salsa20 requires 64-bit nonce");
     this.key = new Uint32Array(8);
@@ -399,10 +399,10 @@ class Salsa20 {
   }
 }
 
-var __defProp$3 = Object.defineProperty;
-var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$3 = (obj, key, value) => {
-  __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$4 = Object.defineProperty;
+var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$4 = (obj, key, value) => {
+  __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const BLTE_MAGIC = 1112298565;
@@ -410,12 +410,12 @@ const ENC_TYPE_SALSA20 = 83;
 const EMPTY_HASH = "00000000000000000000000000000000";
 class BLTEReader {
   constructor(buffer, eKey, keys = /* @__PURE__ */ new Map()) {
-    __publicField$3(this, "buffer");
-    __publicField$3(this, "blte");
-    __publicField$3(this, "blocks", []);
-    __publicField$3(this, "keys");
-    __publicField$3(this, "processedBlock", 0);
-    __publicField$3(this, "processedOffset", 0);
+    __publicField$4(this, "buffer");
+    __publicField$4(this, "blte");
+    __publicField$4(this, "blocks", []);
+    __publicField$4(this, "keys");
+    __publicField$4(this, "processedBlock", 0);
+    __publicField$4(this, "processedOffset", 0);
     this.blte = buffer;
     this.buffer = Buffer.alloc(0);
     this.keys = keys;
@@ -883,10 +883,10 @@ const getNameHash = (name) => {
   return `${pc.toString(16).padStart(8, "0")}${pb.toString(16).padStart(8, "0")}`;
 };
 
-var __defProp$2 = Object.defineProperty;
-var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$2 = (obj, key, value) => {
-  __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => {
+  __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const WDC5_MAGIC = 1464091445;
@@ -912,17 +912,18 @@ const readBitpackedValue = (buffer, fieldOffsetBits, fieldSizeBits, signed = fal
   return signed ? BigInt.asIntN(fieldSizeBits, value >> BigInt(bitOffset)) : BigInt.asUintN(fieldSizeBits, value >> BigInt(bitOffset));
 };
 class WDCReader {
-  constructor(buffer, blocks = []) {
-    __publicField$2(this, "tableHash");
-    __publicField$2(this, "layoutHash");
-    __publicField$2(this, "locale");
-    __publicField$2(this, "isNormal");
-    __publicField$2(this, "hasRelationshipData");
-    __publicField$2(this, "fields");
-    __publicField$2(this, "fieldsInfo");
-    __publicField$2(this, "rows", /* @__PURE__ */ new Map());
-    __publicField$2(this, "relationships", /* @__PURE__ */ new Map());
-    __publicField$2(this, "copyTable", /* @__PURE__ */ new Map());
+  constructor(buffer, blocks = [], adb) {
+    __publicField$3(this, "tableHash");
+    __publicField$3(this, "layoutHash");
+    __publicField$3(this, "locale");
+    __publicField$3(this, "isNormal");
+    __publicField$3(this, "hasRelationshipData");
+    __publicField$3(this, "fields");
+    __publicField$3(this, "fieldsInfo");
+    __publicField$3(this, "rows", /* @__PURE__ */ new Map());
+    __publicField$3(this, "relationships", /* @__PURE__ */ new Map());
+    __publicField$3(this, "copyTable", /* @__PURE__ */ new Map());
+    __publicField$3(this, "hotfixes", /* @__PURE__ */ new Map());
     const magic = buffer.readUInt32BE(0);
     const fieldCount = buffer.readUInt32LE(140);
     const recordSize = buffer.readUInt32LE(144);
@@ -1327,11 +1328,43 @@ class WDCReader {
         }
       }
     });
+    const entries = adb?.tableEntries.get(tableHash);
+    entries?.filter((entry) => entry.pushID !== -1).sort((a, b) => a.pushID - b.pushID).forEach((entry) => {
+      switch (entry.recordState) {
+        case 1:
+          this.hotfixes.set(entry.recordID, { type: "modify", data: entry.data });
+          break;
+        case 2:
+          this.hotfixes.set(entry.recordID, { type: "delete" });
+          break;
+        case 3:
+          this.hotfixes.delete(entry.recordID);
+          break;
+        case 4:
+          break;
+        default:
+          throw new Error(`Unknown record state: ${entry.recordState.toString()}`);
+      }
+    });
   }
   getAllIDs() {
     return [...this.rows.keys(), ...this.copyTable.keys()];
   }
   getRowData(id) {
+    const hotfix = this.hotfixes.get(id);
+    if (hotfix) {
+      switch (hotfix.type) {
+        case "modify":
+          return {
+            type: "sparse",
+            data: hotfix.data
+          };
+        case "delete":
+          return void 0;
+        default:
+          throw new Error("Unreachable");
+      }
+    }
     const dst = this.copyTable.get(id);
     if (dst) {
       return this.rows.get(dst);
@@ -1393,10 +1426,10 @@ const formatFileSize = (input) => {
   return result.join(" ");
 };
 
-var __defProp$1 = Object.defineProperty;
-var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$1 = (obj, key, value) => {
-  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => {
+  __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
@@ -1409,13 +1442,13 @@ var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
 const textLogLevel = ["ERROR", "WARN", "INFO", "DEBUG"];
 class CASCClient {
   constructor(region, product, version, logLevel = 2 /* info */) {
-    __publicField$1(this, "region");
-    __publicField$1(this, "product");
-    __publicField$1(this, "version");
-    __publicField$1(this, "name2FileDataID", /* @__PURE__ */ new Map());
-    __publicField$1(this, "keys", /* @__PURE__ */ new Map());
-    __publicField$1(this, "preload");
-    __publicField$1(this, "logLevel");
+    __publicField$2(this, "region");
+    __publicField$2(this, "product");
+    __publicField$2(this, "version");
+    __publicField$2(this, "name2FileDataID", /* @__PURE__ */ new Map());
+    __publicField$2(this, "keys", /* @__PURE__ */ new Map());
+    __publicField$2(this, "preload");
+    __publicField$2(this, "logLevel");
     this.region = region;
     this.product = product;
     this.version = version;
@@ -1560,7 +1593,7 @@ class CASCClient {
     ]);
     const keysReader = new WDCReader(keysResult.buffer);
     const lookupReader = new WDCReader(lookupResult.buffer);
-    [...lookupReader.rows.keys()].forEach((keyID) => {
+    lookupReader.getAllIDs().forEach((keyID) => {
       const lookupRow = lookupReader.rows.get(keyID);
       const keyRow = keysReader.rows.get(keyID);
       if (keyRow) {
@@ -1576,6 +1609,31 @@ class CASCClient {
       }
     });
   }
+  loadBroadcastTACTKeys(adb) {
+    adb.tableEntries.get(35137211)?.forEach(({ data }) => {
+      if (data.byteLength > 0) {
+        let pointer = 0;
+        while (data[pointer] !== 0) {
+          pointer += 1;
+        }
+        pointer += 1;
+        while (data[pointer] !== 0) {
+          pointer += 1;
+        }
+        pointer += 1 + 43;
+        if (pointer < data.byteLength) {
+          const extraTableHash = data.readUInt32LE(pointer);
+          if (extraTableHash === 3744420815) {
+            const keyName = data.readBigUInt64LE(pointer + 4).toString(16).padStart(16, "0");
+            const key = Uint8Array.from(data.subarray(pointer + 12));
+            if (!this.keys.has(keyName)) {
+              this.keys.set(keyName, key);
+            }
+          }
+        }
+      }
+    });
+  }
   getFileDataIDByName(name) {
     assert(this.preload, "Client not initialized");
     const { rootFile } = this.preload;
@@ -1629,14 +1687,14 @@ class CASCClient {
     };
   }
 }
-__publicField$1(CASCClient, "LocaleFlags", LocaleFlags);
-__publicField$1(CASCClient, "ContentFlags", ContentFlags);
-__publicField$1(CASCClient, "LogLevel", LogLevel);
+__publicField$2(CASCClient, "LocaleFlags", LocaleFlags);
+__publicField$2(CASCClient, "ContentFlags", ContentFlags);
+__publicField$2(CASCClient, "LogLevel", LogLevel);
 
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$1 = Object.defineProperty;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$1 = (obj, key, value) => {
+  __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
   return value;
 };
 const PATTERN_COLUMN = /^(int|float|locstring|string)(<[^:]+::[^>]+>)?\s([^\s]+)/;
@@ -1672,10 +1730,10 @@ const castBigInt64 = (value, srcSigned, dstSigned) => {
 };
 class DBDParser {
   constructor(wdc) {
-    __publicField(this, "wdc");
-    __publicField(this, "definitions", /* @__PURE__ */ new Map());
-    __publicField(this, "columns", []);
-    __publicField(this, "cache", /* @__PURE__ */ new Map());
+    __publicField$1(this, "wdc");
+    __publicField$1(this, "definitions", /* @__PURE__ */ new Map());
+    __publicField$1(this, "columns", []);
+    __publicField$1(this, "cache", /* @__PURE__ */ new Map());
     this.wdc = wdc;
   }
   async init() {
@@ -1843,6 +1901,9 @@ class DBDParser {
         if (column.isID) {
           data[column.name] = id;
           if (column.isInline) {
+            const currField = this.wdc.fields[fieldIndex];
+            const size = Math.ceil((column.size ?? 32 - currField.size) / 8);
+            offset += size;
             fieldIndex += 1;
           }
         } else if (column.isInline) {
@@ -1864,7 +1925,7 @@ class DBDParser {
             const size = Math.ceil((column.size ?? 32 - currField.size) / 8);
             let count;
             if (fieldIndex + 1 < this.wdc.fields.length) {
-              count = (nextField.position - currField.position) / size;
+              count = Math.max((nextField.position - currField.position) / size, 1);
             } else {
               count = column.arraySize ? (buffer.byteLength - offset) / size : 1;
             }
@@ -1898,4 +1959,55 @@ class DBDParser {
   }
 }
 
-export { CASCClient, DBDParser, WDCReader };
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+const ADB_MAGIC = 1481004104;
+class ADBReader {
+  constructor(buffer) {
+    __publicField(this, "build");
+    __publicField(this, "entries", []);
+    __publicField(this, "tableEntries", /* @__PURE__ */ new Map());
+    const magic = buffer.readUInt32BE(0);
+    assert(magic === ADB_MAGIC, `[ADB]: Invalid magic: ${magic.toString(16).padStart(8, "0")}`);
+    const version = buffer.readUInt32LE(4);
+    assert(version === 9, `[ADB]: Invalid version: ${version.toString()}`);
+    const build = buffer.readUInt32LE(8);
+    this.build = build;
+    let pointer = 44;
+    while (pointer < buffer.byteLength) {
+      const offset = pointer;
+      const entryMagic = buffer.readUInt32BE(offset);
+      assert(entryMagic === ADB_MAGIC, `[ADB]: Invalid entry magic: ${magic.toString(16).padStart(8, "0")}`);
+      const regionID = buffer.readInt32LE(offset + 4);
+      const pushID = buffer.readInt32LE(offset + 8);
+      const uniqueID = buffer.readUInt32LE(offset + 12);
+      const tableHash = buffer.readUInt32LE(offset + 16);
+      const recordID = buffer.readUInt32LE(offset + 20);
+      const dataSize = buffer.readUInt32LE(offset + 24);
+      const recordState = buffer.readUInt32LE(offset + 28);
+      const data = buffer.subarray(offset + 32, offset + 32 + dataSize);
+      const entry = {
+        regionID,
+        pushID,
+        uniqueID,
+        tableHash,
+        recordID,
+        dataSize,
+        recordState,
+        data
+      };
+      this.entries.push(entry);
+      if (!this.tableEntries.has(tableHash)) {
+        this.tableEntries.set(tableHash, []);
+      }
+      this.tableEntries.get(tableHash)?.push(entry);
+      pointer += 32 + dataSize;
+    }
+  }
+}
+
+export { ADBReader, CASCClient, DBDParser, WDCReader };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhyster/wow-casc-dbc",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Fetch World of Warcraft data files from CASC and parse DBC/DB2 files.",
   "type": "module",
   "exports": {
@@ -41,14 +41,14 @@
     "@types/cli-progress": "^3.11.5",
     "@types/jest": "^29.5.12",
     "@types/node": "^20.12.7",
-    "@typescript-eslint/eslint-plugin": "^7.7.1",
-    "@typescript-eslint/parser": "^7.7.1",
+    "@typescript-eslint/eslint-plugin": "^7.8.0",
+    "@typescript-eslint/parser": "^7.8.0",
     "eslint": "^8.57.0",
     "eslint-config-airbnb-base": "^15.0.0",
     "eslint-config-airbnb-typescript": "^18.0.0",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.2",
-    "ts-node": "^10.9.2",
+    "tsx": "^4.7.3",
     "typescript": "^5.4.5",
     "unbuild": "^2.0.0"
   },