t2-demo-parser 2.1.0 → 3.0.0

package/dist/DemoParser.d.ts

@@ -1,5 +1,5 @@
 import { PacketParser } from "./PacketParser.js";
-import { ClassRegistry } from "./ClassRegistry.js";
+import type { ClassRegistry } from "./ClassRegistry.js";
 import { GhostTracker } from "./GhostManager.js";
 import type { DemoHeader, DemoFile, DemoBlock, InitialBlockData, LoadResult } from "./types.js";
 export declare class DemoParser {
@@ -17,7 +17,33 @@ export declare class DemoParser {
     private _blockStreamOffset;
     private _blockCount?;
     private _blockCursor;
-    constructor(buffer: Uint8Array);
+    private readonly _incremental;
+    private _complete;
+    private _inflator?;
+    /** The zlib stream announced its own end (final deflate block seen) —
+     *  later bytes are trailing garbage and further pushes would throw. */
+    private _streamEnded;
+    /** Backing store for the growing decompressed stream (incremental
+     *  mode). `_decompressedData` is always a length-exact subarray of
+     *  this, so every existing `.length`-based read stays correct. */
+    private _backing?;
+    private _decompressedLength;
+    private _scanOffset;
+    private _bufferedMoveTicks;
+    private readonly _ignoreProtocolVersion;
+    private readonly _haltOnFault;
+    constructor(buffer: Uint8Array, options?: {
+        /** Feed the compressed block stream in chunks via push()/finish(). */
+        incremental?: boolean;
+        /**
+         * Parse demos whose protocol version differs from build 25034's
+         * (0x330004). The game itself refuses to play them, and the block
+         * formats are not guaranteed to match, so expect faults.
+         */
+        ignoreProtocolVersion?: boolean;
+        /** Passed to PacketParser; see its `haltOnFault` option. */
+        haltOnFault?: boolean;
+    });
     getRegistry(): ClassRegistry;
     getGhostTracker(): GhostTracker;
     getPacketParser(): PacketParser;
@@ -25,6 +51,12 @@ export declare class DemoParser {
     get header(): DemoHeader;
     get initialBlock(): InitialBlockData;
     get blockCount(): number;
+    /**
+     * Walk complete block headers from byte offset `from`, calling `visit`
+     * for each; returns the offset of the first incomplete block (or the
+     * end of the data).
+     */
+    private _walkBlockHeaders;
     get blockCursor(): number;
     /**
      * Async load: parses header, initial block (DataBlocks, events,
@@ -34,6 +66,53 @@ export declare class DemoParser {
      * Idempotent — second call returns cached result.
      */
     load(): Promise<LoadResult>;
+    /**
+     * Parse just the fixed-size demo header from a byte prefix, without
+     * constructing a parser. Throws RangeError when `bytes` is too short —
+     * callers streaming a download retry as more data arrives. The
+     * returned `byteLength` is where the initial block begins; the block
+     * stream begins at `byteLength + header.initialBlockSize`.
+     */
+    static peekHeader(bytes: Uint8Array): {
+        header: DemoHeader;
+        byteLength: number;
+    };
+    /**
+     * Incremental mode only: feed the next chunk of raw (compressed) block
+     * stream bytes as they arrive. Inflation happens synchronously; any
+     * blocks completed by this chunk become readable via nextBlock().
+     * The chunk is not retained.
+     */
+    push(chunk: Uint8Array): void;
+    /**
+     * Incremental mode only: signal that the download is complete. Flushes
+     * the inflator; after this, running out of blocks means the true end
+     * of the demo rather than the frontier.
+     */
+    finish(): void;
+    /**
+     * False only in incremental mode before finish(): nextBlock()
+     * returning undefined then means "frontier — more data may arrive",
+     * not the end of the demo.
+     */
+    get isComplete(): boolean;
+    /**
+     * Bytes of decompressed block stream available so far. Grows during
+     * an incremental feed; consumers that latched an "out of blocks"
+     * state can compare against it to know new data has arrived.
+     */
+    get decompressedByteLength(): number;
+    /**
+     * Move-tick blocks in the decompressed stream so far — each is one
+     * fixed 32ms simulation tick, so this measures buffered DEMO TIME
+     * exactly (compressed bytes don't: quiet stretches pack far denser).
+     * Independent of the read cursor; unaffected by reset(). Maintained
+     * incrementally as data arrives; a full lazy scan on first access
+     * covers the one-shot mode.
+     */
+    get bufferedMoveTicks(): number;
+    private _scanBufferedTicks;
+    private _appendDecompressed;
     /**
      * Read and parse the next block from the decompressed buffer.
      * Returns the parsed block, or undefined when all blocks are exhausted.
@@ -65,6 +144,11 @@ export declare class DemoParser {
      * Full parse: async load + drain all blocks.
      */
     parseFullDemo(): Promise<DemoFile>;
+    /**
+     * Read and validate the header the way GameConnection's demo playback
+     * does: the ident string must match and the protocol version must be
+     * the one this build speaks (unless `ignoreProtocolVersion` is set).
+     */
     private readHeader;
     /** Parse the initial block: DataBlocks, scores, targets, connection state,
      *  events, ghosts, control object, and mission name. */
@@ -110,27 +194,6 @@ export declare class DemoParser {
     private readConnectionProtocol;
     private readEventStartBlock;
     private readGhostStartBlock;
-    /**
-     * Try parsing a ghost with a given parser and validate alignment.
-     * Returns true if parsing succeeded and alignment is valid.
-     * On success, the BitStream is positioned after the parsed ghost data.
-     * On failure, the BitStream is restored to updateBitsStart.
-     */
-    private tryGhostParser;
-    /**
-     * Peek at the GameBase DataBlock prefix to identify a ghost's parser.
-     * GameBase subclass ghost creates always start with:
-     *   flag(1b) + if flag: DataBlockId(11b)
-     * The DataBlock type (e.g., "PlayerData") maps to the ghost parser
-     * (e.g., "Player") by stripping the "Data" suffix.
-     *
-     * Returns { entry, dbFlag } where entry is the parser (if found) and
-     * dbFlag indicates whether the first bit was 1 (DataBlock flag set).
-     * In the initial block (mask=0xFFFFFFFF), dbFlag=false means the ghost
-     * is definitely NOT a GameBase subclass.
-     * The BitStream position is always restored after peeking.
-     */
-    private identifyGhostViaDataBlock;
     /**
      * Parse a raw 64-byte Move struct from a type 2 block.
      *

package/dist/DemoParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DemoParser.d.ts","sourceRoot":"","sources":["../src/DemoParser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AAuBvE,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,gBAAgB,EAWhB,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IAEnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAmB;IACzC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,iBAAiB,CAAC,CAAW;IACrC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,UAAU;IAyE9B,WAAW,IAAI,aAAa;IAI5B,eAAe,IAAI,YAAY;IAI/B,eAAe,IAAI,YAAY;IAM/B,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,IAAI,UAAU,CAGvB;IAED,IAAI,YAAY,IAAI,gBAAgB,CAGnC;IAED,IAAI,UAAU,IAAI,MAAM,CAkBvB;IAED,IAAI,WAAW,IAAI,MAAM,CAGxB;IAID;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IA4DjC;;;;;OAKG;IACH,SAAS,IAAI,SAAS,GAAG,SAAS;IA2DlC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAWb;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUpC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC;IAQxC,OAAO,CAAC,UAAU;IAwBlB;4DACwD;IACxD,OAAO,CAAC,gBAAgB;IA4TxB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAuBtB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IA6EhC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,mBAAmB;IAmE3B,OAAO,CAAC,mBAAmB;IAuH3B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAsEtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA4CjC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,WAAW;IA0CnB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAOtB"}
+{"version":3,"file":"DemoParser.d.ts","sourceRoot":"","sources":["../src/DemoParser.ts"],"names":[],"mappings":"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"}