nlcurl 0.6.0 → 0.8.0

package/dist/utils/buffer-reader.d.ts

@@ -1,122 +1,67 @@
-/**
- * Stateful cursor for reading typed values from a `Buffer` in big-endian byte
- * order. Advances an internal position pointer after every read so callers
- * don't need to track offsets manually.
- *
- * @example
- * const r = new BufferReader(buf);
- * const version = r.readUInt8();
- * const length  = r.readUInt16();
- * const payload = r.readBytes(length);
- */
+/** Sequential big-endian reader over a fixed-size buffer. */
 export declare class BufferReader {
     private _buf;
     private _pos;
     /**
-     * Creates a new BufferReader.
+     * Create a reader over the given buffer.
      *
-     * @param {Buffer} buf      - Buffer to read from.
-     * @param {number} [offset=0] - Initial cursor position.
+     * @param {Buffer} buf - Source buffer.
+     * @param {number} offset - Initial read position.
      */
     constructor(buf: Buffer, offset?: number);
-    /** Current byte offset of the read cursor. */
+    /** Current read position within the buffer. */
     get position(): number;
-    /** Number of bytes remaining after the current cursor position. */
+    /** Number of bytes remaining after the current position. */
     get remaining(): number;
-    /** Total length of the underlying buffer. */
+    /** Total buffer length. */
     get length(): number;
-    /** The underlying `Buffer` instance. */
+    /** Return the underlying buffer. */
     get buffer(): Buffer;
     /**
-     * Returns the next `length` bytes without advancing the cursor.
+     * Preview bytes at the current position without advancing.
      *
-     * @param {number} length - Number of bytes to peek at.
-     * @returns {Buffer} A view into the underlying buffer (not a copy).
-     * @throws {RangeError} If `length` bytes are not available.
+     * @param {number} length - Number of bytes to peek.
+     * @returns {Buffer} Buffer slice.
      */
     peek(length: number): Buffer;
-    /**
-     * Reads one unsigned 8-bit integer and advances the cursor by 1.
-     *
-     * @returns {number} Unsigned byte value (0–255).
-     * @throws {RangeError} If fewer than 1 byte remains.
-     */
+    /** Read a single unsigned 8-bit integer. */
     readUInt8(): number;
-    /**
-     * Reads one big-endian unsigned 16-bit integer and advances the cursor by 2.
-     *
-     * @returns {number} Unsigned 16-bit value (0–65 535).
-     * @throws {RangeError} If fewer than 2 bytes remain.
-     */
+    /** Read an unsigned 16-bit big-endian integer. */
     readUInt16(): number;
-    /**
-     * Reads one big-endian unsigned 24-bit integer and advances the cursor by 3.
-     *
-     * @returns {number} Unsigned 24-bit value (0–16 777 215).
-     * @throws {RangeError} If fewer than 3 bytes remain.
-     */
+    /** Read an unsigned 24-bit big-endian integer. */
     readUInt24(): number;
-    /**
-     * Reads one big-endian unsigned 32-bit integer and advances the cursor by 4.
-     *
-     * @returns {number} Unsigned 32-bit value (0–4 294 967 295).
-     * @throws {RangeError} If fewer than 4 bytes remain.
-     */
+    /** Read an unsigned 32-bit big-endian integer. */
     readUInt32(): number;
     /**
-     * Reads `length` bytes into a new `Buffer` and advances the cursor.
+     * Read a fixed number of bytes and advance the position.
      *
      * @param {number} length - Number of bytes to read.
-     * @returns {Buffer} Copy of the requested bytes.
-     * @throws {RangeError} If `length` bytes are not available.
+     * @returns {Buffer} Copied buffer slice.
      */
     readBytes(length: number): Buffer;
-    /**
-     * Reads a length-prefixed byte vector where the length is encoded as a
-     * one-byte (8-bit) unsigned integer immediately preceding the data.
-     *
-     * @returns {Buffer} The vector payload bytes.
-     * @throws {RangeError} If insufficient bytes remain.
-     */
+    /** Read a length-prefixed vector with a 1-byte length prefix. */
     readVector8(): Buffer;
-    /**
-     * Reads a length-prefixed byte vector where the length is encoded as a
-     * big-endian two-byte (16-bit) unsigned integer immediately preceding the data.
-     *
-     * @returns {Buffer} The vector payload bytes.
-     * @throws {RangeError} If insufficient bytes remain.
-     */
+    /** Read a length-prefixed vector with a 2-byte big-endian length prefix. */
     readVector16(): Buffer;
-    /**
-     * Reads a length-prefixed byte vector where the length is encoded as a
-     * big-endian three-byte (24-bit) unsigned integer immediately preceding the data.
-     *
-     * @returns {Buffer} The vector payload bytes.
-     * @throws {RangeError} If insufficient bytes remain.
-     */
+    /** Read a length-prefixed vector with a 3-byte big-endian length prefix. */
     readVector24(): Buffer;
     /**
-     * Advances the cursor by `length` bytes without returning the data.
+     * Advance the read position without returning data.
      *
      * @param {number} length - Number of bytes to skip.
-     * @throws {RangeError} If `length` bytes are not available.
      */
     skip(length: number): void;
     /**
-     * Moves the cursor to an absolute byte position within the buffer.
+     * Set the read position to an absolute offset.
      *
-     * @param {number} position - Target byte offset (0 to `length` inclusive).
-     * @throws {RangeError} If `position` is negative or beyond the buffer length.
+     * @param {number} position - Target position.
      */
     seek(position: number): void;
     /**
-     * Reads `length` bytes from the current position and returns a new
-     * `BufferReader` positioned at offset 0 within that sub-slice. The parent
-     * cursor advances by `length` bytes.
+     * Create a sub-reader covering the next `length` bytes and advance.
      *
-     * @param {number} length - Byte count to slice into the sub-reader.
-     * @returns {BufferReader} Reader over the requested sub-slice.
-     * @throws {RangeError} If `length` bytes are not available.
+     * @param {number} length - Number of bytes for the sub-reader.
+     * @returns {BufferReader} New `BufferReader` over the sub-range.
      */
     subReader(length: number): BufferReader;
     private assertAvailable;

package/dist/utils/buffer-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer-reader.d.ts","sourceRoot":"","sources":["../../src/utils/buffer-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IAErB;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU;IAK3C,8CAA8C;IAC9C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,mEAAmE;IACnE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,6CAA6C;IAC7C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,wCAAwC;IACxC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAK5B;;;;;OAKG;IACH,SAAS,IAAI,MAAM;IAOnB;;;;;OAKG;IACH,UAAU,IAAI,MAAM;IAOpB;;;;;OAKG;IACH,UAAU,IAAI,MAAM;IASpB;;;;;OAKG;IACH,UAAU,IAAI,MAAM;IAOpB;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOjC;;;;;;OAMG;IACH,WAAW,IAAI,MAAM;IAKrB;;;;;;OAMG;IACH,YAAY,IAAI,MAAM;IAKtB;;;;;;OAMG;IACH,YAAY,IAAI,MAAM;IAKtB;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAOvC,OAAO,CAAC,eAAe;CAKxB"}
+{"version":3,"file":"buffer-reader.d.ts","sourceRoot":"","sources":["../../src/utils/buffer-reader.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IAErB;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU;IAK3C,+CAA+C;IAC/C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,4DAA4D;IAC5D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,2BAA2B;IAC3B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,oCAAoC;IACpC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAK5B,4CAA4C;IAC5C,SAAS,IAAI,MAAM;IAOnB,kDAAkD;IAClD,UAAU,IAAI,MAAM;IAOpB,kDAAkD;IAClD,UAAU,IAAI,MAAM;IASpB,kDAAkD;IAClD,UAAU,IAAI,MAAM;IAOpB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOjC,iEAAiE;IACjE,WAAW,IAAI,MAAM;IAKrB,4EAA4E;IAC5E,YAAY,IAAI,MAAM;IAKtB,4EAA4E;IAC5E,YAAY,IAAI,MAAM;IAKtB;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAOvC,OAAO,CAAC,eAAe;CAKxB"}

package/dist/utils/buffer-reader.js

@@ -1,84 +1,58 @@
-/**
- * Stateful cursor for reading typed values from a `Buffer` in big-endian byte
- * order. Advances an internal position pointer after every read so callers
- * don't need to track offsets manually.
- *
- * @example
- * const r = new BufferReader(buf);
- * const version = r.readUInt8();
- * const length  = r.readUInt16();
- * const payload = r.readBytes(length);
- */
+/** Sequential big-endian reader over a fixed-size buffer. */
 export class BufferReader {
     _buf;
     _pos;
     /**
-     * Creates a new BufferReader.
+     * Create a reader over the given buffer.
      *
-     * @param {Buffer} buf      - Buffer to read from.
-     * @param {number} [offset=0] - Initial cursor position.
+     * @param {Buffer} buf - Source buffer.
+     * @param {number} offset - Initial read position.
      */
     constructor(buf, offset = 0) {
         this._buf = buf;
         this._pos = offset;
     }
-    /** Current byte offset of the read cursor. */
+    /** Current read position within the buffer. */
     get position() {
         return this._pos;
     }
-    /** Number of bytes remaining after the current cursor position. */
+    /** Number of bytes remaining after the current position. */
     get remaining() {
         return this._buf.length - this._pos;
     }
-    /** Total length of the underlying buffer. */
+    /** Total buffer length. */
     get length() {
         return this._buf.length;
     }
-    /** The underlying `Buffer` instance. */
+    /** Return the underlying buffer. */
     get buffer() {
         return this._buf;
     }
     /**
-     * Returns the next `length` bytes without advancing the cursor.
+     * Preview bytes at the current position without advancing.
      *
-     * @param {number} length - Number of bytes to peek at.
-     * @returns {Buffer} A view into the underlying buffer (not a copy).
-     * @throws {RangeError} If `length` bytes are not available.
+     * @param {number} length - Number of bytes to peek.
+     * @returns {Buffer} Buffer slice.
      */
     peek(length) {
         this.assertAvailable(length);
         return this._buf.subarray(this._pos, this._pos + length);
     }
-    /**
-     * Reads one unsigned 8-bit integer and advances the cursor by 1.
-     *
-     * @returns {number} Unsigned byte value (0–255).
-     * @throws {RangeError} If fewer than 1 byte remains.
-     */
+    /** Read a single unsigned 8-bit integer. */
     readUInt8() {
         this.assertAvailable(1);
         const v = this._buf[this._pos];
         this._pos += 1;
         return v;
     }
-    /**
-     * Reads one big-endian unsigned 16-bit integer and advances the cursor by 2.
-     *
-     * @returns {number} Unsigned 16-bit value (0–65 535).
-     * @throws {RangeError} If fewer than 2 bytes remain.
-     */
+    /** Read an unsigned 16-bit big-endian integer. */
     readUInt16() {
         this.assertAvailable(2);
         const v = this._buf.readUInt16BE(this._pos);
         this._pos += 2;
         return v;
     }
-    /**
-     * Reads one big-endian unsigned 24-bit integer and advances the cursor by 3.
-     *
-     * @returns {number} Unsigned 24-bit value (0–16 777 215).
-     * @throws {RangeError} If fewer than 3 bytes remain.
-     */
+    /** Read an unsigned 24-bit big-endian integer. */
     readUInt24() {
         this.assertAvailable(3);
         const b0 = this._buf[this._pos];
@@ -87,12 +61,7 @@ export class BufferReader {
         this._pos += 3;
         return (b0 << 16) | (b1 << 8) | b2;
     }
-    /**
-     * Reads one big-endian unsigned 32-bit integer and advances the cursor by 4.
-     *
-     * @returns {number} Unsigned 32-bit value (0–4 294 967 295).
-     * @throws {RangeError} If fewer than 4 bytes remain.
-     */
+    /** Read an unsigned 32-bit big-endian integer. */
     readUInt32() {
         this.assertAvailable(4);
         const v = this._buf.readUInt32BE(this._pos);
@@ -100,11 +69,10 @@ export class BufferReader {
         return v;
     }
     /**
-     * Reads `length` bytes into a new `Buffer` and advances the cursor.
+     * Read a fixed number of bytes and advance the position.
      *
      * @param {number} length - Number of bytes to read.
-     * @returns {Buffer} Copy of the requested bytes.
-     * @throws {RangeError} If `length` bytes are not available.
+     * @returns {Buffer} Copied buffer slice.
      */
     readBytes(length) {
         this.assertAvailable(length);
@@ -112,54 +80,34 @@ export class BufferReader {
         this._pos += length;
         return slice;
     }
-    /**
-     * Reads a length-prefixed byte vector where the length is encoded as a
-     * one-byte (8-bit) unsigned integer immediately preceding the data.
-     *
-     * @returns {Buffer} The vector payload bytes.
-     * @throws {RangeError} If insufficient bytes remain.
-     */
+    /** Read a length-prefixed vector with a 1-byte length prefix. */
     readVector8() {
         const len = this.readUInt8();
         return this.readBytes(len);
     }
-    /**
-     * Reads a length-prefixed byte vector where the length is encoded as a
-     * big-endian two-byte (16-bit) unsigned integer immediately preceding the data.
-     *
-     * @returns {Buffer} The vector payload bytes.
-     * @throws {RangeError} If insufficient bytes remain.
-     */
+    /** Read a length-prefixed vector with a 2-byte big-endian length prefix. */
     readVector16() {
         const len = this.readUInt16();
         return this.readBytes(len);
     }
-    /**
-     * Reads a length-prefixed byte vector where the length is encoded as a
-     * big-endian three-byte (24-bit) unsigned integer immediately preceding the data.
-     *
-     * @returns {Buffer} The vector payload bytes.
-     * @throws {RangeError} If insufficient bytes remain.
-     */
+    /** Read a length-prefixed vector with a 3-byte big-endian length prefix. */
     readVector24() {
         const len = this.readUInt24();
         return this.readBytes(len);
     }
     /**
-     * Advances the cursor by `length` bytes without returning the data.
+     * Advance the read position without returning data.
      *
      * @param {number} length - Number of bytes to skip.
-     * @throws {RangeError} If `length` bytes are not available.
      */
     skip(length) {
         this.assertAvailable(length);
         this._pos += length;
     }
     /**
-     * Moves the cursor to an absolute byte position within the buffer.
+     * Set the read position to an absolute offset.
      *
-     * @param {number} position - Target byte offset (0 to `length` inclusive).
-     * @throws {RangeError} If `position` is negative or beyond the buffer length.
+     * @param {number} position - Target position.
      */
     seek(position) {
         if (position < 0 || position > this._buf.length) {
@@ -168,13 +116,10 @@ export class BufferReader {
         this._pos = position;
     }
     /**
-     * Reads `length` bytes from the current position and returns a new
-     * `BufferReader` positioned at offset 0 within that sub-slice. The parent
-     * cursor advances by `length` bytes.
+     * Create a sub-reader covering the next `length` bytes and advance.
      *
-     * @param {number} length - Byte count to slice into the sub-reader.
-     * @returns {BufferReader} Reader over the requested sub-slice.
-     * @throws {RangeError} If `length` bytes are not available.
+     * @param {number} length - Number of bytes for the sub-reader.
+     * @returns {BufferReader} New `BufferReader` over the sub-range.
      */
     subReader(length) {
         this.assertAvailable(length);

package/dist/utils/buffer-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"buffer-reader.js","sourceRoot":"","sources":["../../src/utils/buffer-reader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"buffer-reader.js","sourceRoot":"","sources":["../../src/utils/buffer-reader.ts"],"names":[],"mappings":"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"}

package/dist/utils/buffer-writer.d.ts

@@ -1,122 +1,86 @@
-/**
- * Growable binary buffer writer that serializes typed values in big-endian byte
- * order. The internal buffer doubles in capacity as needed. Call
- * {@link BufferWriter.toBuffer} to obtain the written bytes as a new `Buffer`.
- *
- * @example
- * const w = new BufferWriter();
- * w.writeUInt8(0x16);
- * w.writeUInt16(0x0303);
- * w.writeVector16(data);
- * return w.toBuffer();
- */
+/** Auto-growing big-endian buffer builder. */
 export declare class BufferWriter {
     private _buf;
     private _pos;
     /**
-     * Creates a new BufferWriter with an optional initial capacity.
+     * Create a writer with the given initial capacity.
      *
-     * @param {number} [capacity=1024] - Initial internal buffer capacity in bytes.
+     * @param {number} [capacity] - Initial buffer allocation in bytes.
      */
     constructor(capacity?: number);
-    /** Current write position (equals the number of bytes written so far). */
+    /** Current write position (identical to the number of bytes written). */
     get position(): number;
-    /** Number of bytes that have been written (alias for {@link BufferWriter.position}). */
+    /** Number of bytes written so far. */
     get length(): number;
-    /**
-     * Returns a copy of the written bytes as a new `Buffer`. The returned buffer
-     * contains only the bytes that have been written, regardless of the internal
-     * capacity.
-     *
-     * @returns {Buffer} Copy of all written data.
-     */
+    /** Copy the written region into a new buffer and return it. */
     toBuffer(): Buffer;
     /**
-     * Writes one unsigned byte and advances the write position by 1.
+     * Write an unsigned 8-bit integer.
      *
-     * @param {number} value - Byte value (only the lowest 8 bits are used).
-     * @returns {this} This instance for chaining.
+     * @param {number} value - Value to write.
      */
     writeUInt8(value: number): this;
     /**
-     * Writes one big-endian unsigned 16-bit integer and advances the write position by 2.
+     * Write an unsigned 16-bit big-endian integer.
      *
-     * @param {number} value - 16-bit value to write.
-     * @returns {this} This instance for chaining.
+     * @param {number} value - Value to write.
      */
     writeUInt16(value: number): this;
     /**
-     * Writes one big-endian unsigned 24-bit integer and advances the write position by 3.
+     * Write an unsigned 24-bit big-endian integer.
      *
-     * @param {number} value - 24-bit value to write.
-     * @returns {this} This instance for chaining.
+     * @param {number} value - Value to write.
      */
     writeUInt24(value: number): this;
     /**
-     * Writes one big-endian unsigned 32-bit integer and advances the write position by 4.
+     * Write an unsigned 32-bit big-endian integer.
      *
-     * @param {number} value - 32-bit value to write.
-     * @returns {this} This instance for chaining.
+     * @param {number} value - Value to write.
      */
     writeUInt32(value: number): this;
     /**
-     * Appends raw bytes from `data` and advances the write position accordingly.
+     * Write raw bytes into the buffer.
      *
-     * @param {Buffer | Uint8Array} data - Data to write.
-     * @returns {this} This instance for chaining.
+     * @param {Buffer | Uint8Array} data - Bytes to append.
      */
     writeBytes(data: Buffer | Uint8Array): this;
     /**
-     * Writes a length-prefixed byte vector using an 8-bit length prefix.
-     * Equivalent to `writeUInt8(data.length)` followed by `writeBytes(data)`.
+     * Write a length-prefixed vector with a 1-byte length prefix.
      *
-     * @param {Buffer | Uint8Array} data - Data to write (must be ≤ 255 bytes).
-     * @returns {this} This instance for chaining.
-     * @throws {RangeError} If `data.length` exceeds 255.
+     * @param {Buffer | Uint8Array} data - Data to write.
      */
     writeVector8(data: Buffer | Uint8Array): this;
     /**
-     * Writes a length-prefixed byte vector using a big-endian 16-bit length prefix.
-     * Equivalent to `writeUInt16(data.length)` followed by `writeBytes(data)`.
+     * Write a length-prefixed vector with a 2-byte big-endian length prefix.
      *
-     * @param {Buffer | Uint8Array} data - Data to write (must be ≤ 65 535 bytes).
-     * @returns {this} This instance for chaining.
-     * @throws {RangeError} If `data.length` exceeds 65 535.
+     * @param {Buffer | Uint8Array} data - Data to write.
      */
     writeVector16(data: Buffer | Uint8Array): this;
     /**
-     * Writes a length-prefixed byte vector using a big-endian 24-bit length prefix.
-     * Equivalent to `writeUInt24(data.length)` followed by `writeBytes(data)`.
+     * Write a length-prefixed vector with a 3-byte big-endian length prefix.
      *
-     * @param {Buffer | Uint8Array} data - Data to write (must be ≤ 16 777 215 bytes).
-     * @returns {this} This instance for chaining.
-     * @throws {RangeError} If `data.length` exceeds 16 777 215.
+     * @param {Buffer | Uint8Array} data - Data to write.
      */
     writeVector24(data: Buffer | Uint8Array): this;
     /**
-     * Reserves `size` bytes at the current position without writing any data,
-     * advances the cursor, and returns the byte offset of the reserved region.
-     * Use this to write a length prefix, then later patch it with
-     * {@link BufferWriter.patchUInt16} or {@link BufferWriter.patchUInt24}.
+     * Reserve space and return its offset for later patching.
      *
      * @param {number} size - Number of bytes to reserve.
-     * @returns {number} Byte offset of the start of the reserved region.
+     * @returns {number} Starting offset of the reserved region.
      */
     reserve(size: number): number;
     /**
-     * Overwrites a previously reserved 16-bit slot with `value` in big-endian byte order.
-     * Does not advance the write cursor.
+     * Overwrite a previously reserved 16-bit value.
      *
-     * @param {number} offset - Byte offset returned by {@link BufferWriter.reserve}.
-     * @param {number} value  - 16-bit value to patch in.
+     * @param {number} offset - Byte offset to patch.
+     * @param {number} value - New 16-bit value.
      */
     patchUInt16(offset: number, value: number): void;
     /**
-     * Overwrites a previously reserved 24-bit slot with `value` in big-endian byte order.
-     * Does not advance the write cursor.
+     * Overwrite a previously reserved 24-bit value.
      *
-     * @param {number} offset - Byte offset returned by {@link BufferWriter.reserve}.
-     * @param {number} value  - 24-bit value to patch in.
+     * @param {number} offset - Byte offset to patch.
+     * @param {number} value - New 24-bit value.
      */
     patchUInt24(offset: number, value: number): void;
     private ensureCapacity;

package/dist/utils/buffer-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer-writer.d.ts","sourceRoot":"","sources":["../../src/utils/buffer-writer.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IAErB;;;;OAIG;gBACS,QAAQ,GAAE,MAAyB;IAK/C,0EAA0E;IAC1E,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,wFAAwF;IACxF,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO/B;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAShC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAW3C;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS7C;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS9C;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS9C;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAO7B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhD,OAAO,CAAC,cAAc;CAevB"}
+{"version":3,"file":"buffer-writer.d.ts","sourceRoot":"","sources":["../../src/utils/buffer-writer.ts"],"names":[],"mappings":"AAIA,8CAA8C;AAC9C,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IAErB;;;;OAIG;gBACS,QAAQ,GAAE,MAAyB;IAK/C,yEAAyE;IACzE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,sCAAsC;IACtC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,+DAA+D;IAC/D,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO/B;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAShC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAW3C;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS7C;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS9C;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAS9C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAO7B;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhD,OAAO,CAAC,cAAc;CAevB"}