@g9tm/syncdata 1.2.1

package/dist/protocol/rowBatch/writer.d.ts

@@ -0,0 +1,101 @@
+import { G9Long } from '../../abstractions/long.js';
+import { type DecimalParts } from '../../internal/dotnetFormat.js';
+/** A DateTime value on the wire: ticks (100 ns since 0001-01-01) and the `DateTimeKind` (0 unspecified, 1 UTC, 2 local). */
+export interface G9DateTimeValue {
+    ticks: G9Long;
+    kind: number;
+}
+/** A DateTimeOffset value on the wire: UTC ticks and the offset in minutes. */
+export interface G9DateTimeOffsetValue {
+    utcTicks: G9Long;
+    offsetMinutes: number;
+}
+/**
+ * A compressor for push frames. Optional: without one the writer emits uncompressed frames, which every reader
+ * accepts (the .NET writer falls back to them whenever compression does not help).
+ */
+export interface G9FrameCompressor {
+    compress(body: Uint8Array, quality: number, window: number): Uint8Array | null;
+}
+/**
+ * Writes a G9RowBatch frame: a 10-byte header (`'G' '9' 'R' 'B' | version | compression | body length i32 LE`) and a
+ * body of sections, each holding rows of one table and one op.
+ */
+export declare class G9RowBatchWriter {
+    private _buffer;
+    private _length;
+    private _sectionCount;
+    private _totalRows;
+    private _inSection;
+    private _op;
+    private _keyType;
+    private _types;
+    private _rowCountPosition;
+    private _sectionRows;
+    private _inRow;
+    private _rowHasValues;
+    private _column;
+    private _bitmapPosition;
+    constructor(initialCapacity?: number);
+    /** Uncompressed body length written so far. */
+    get length(): number;
+    get totalRows(): number;
+    get sectionCount(): number;
+    get currentSectionRows(): number;
+    get inSection(): boolean;
+    /** Starts a section. Key-only ops (Tombstone, MoveOut, KeyVersions) take no column types. */
+    beginSection(op: number, tableId: number, keyType: number, columnTypes: readonly number[]): void;
+    endSection(): void;
+    /** Starts an Upsert or Backfill row; write every column, then {@link endRow}. `key` is canonical key text. */
+    beginRow(key: string, version: number | G9Long): void;
+    /** Adds a complete Tombstone or MoveOut row. */
+    addKey(key: string, version: number | G9Long): void;
+    /** Adds a complete KeyVersions row. */
+    addKeyVersion(key: string, version: number | G9Long, rowHash: G9Long): void;
+    /** Starts a Push row. Upserts must then write every column; deletes write none. Finish with {@link endRow}. */
+    beginPushRow(key: string, op: number, sequence: number | G9Long, baseVersion: number | G9Long, dirtyMask: G9Long, hlcMs: number | G9Long): void;
+    /** Completes a row started with beginRow or beginPushRow. */
+    endRow(): void;
+    writeNull(): void;
+    writeBoolean(value: boolean): void;
+    writeInt32(value: number): void;
+    writeInt64(value: number | G9Long): void;
+    writeDouble(value: number): void;
+    /** A decimal: its .NET parts, or invariant decimal text. */
+    writeDecimal(value: DecimalParts | string): void;
+    /** Writes a string, or NULL when `value` is null. */
+    writeString(value: string | null): void;
+    /** Writes a string that is already UTF-8 encoded. */
+    writeStringUtf8(utf8: Uint8Array): void;
+    /** Writes a GUID given as text in any form `Guid.Parse` accepts. */
+    writeGuid(value: string): void;
+    writeDateTime(value: G9DateTimeValue): void;
+    writeDateTimeOffset(value: G9DateTimeOffsetValue): void;
+    /** A TimeSpan as ticks. */
+    writeTimeSpan(ticks: number | G9Long): void;
+    writeBytes(value: Uint8Array): void;
+    /**
+     * Produces the frame. With a compressor and `compression` Brotli, the body is compressed when it is over 128 bytes
+     * and compression helps; otherwise the frame is uncompressed. `version` 2 writes the column-grouped layout (only for
+     * a peer that asked for it).
+     */
+    toFrame(options?: {
+        compression?: number;
+        quality?: number;
+        version?: number;
+        compressor?: G9FrameCompressor | null;
+    }): Uint8Array;
+    /** Clears all content so the buffer can be reused for the next frame. */
+    reset(): void;
+    private _startRow;
+    private _completeRow;
+    private _openValues;
+    private _nextColumn;
+    private _writeKey;
+    private _unsigned;
+    private _varintNumber;
+    private _varintLong;
+    private _zigZagNumber;
+    private _bytesRaw;
+    private _ensure;
+}

package/dist/protocol/rowBatch/writer.js

@@ -0,0 +1,412 @@
+// Twin of G9SyncData.Protocol/RowBatch/G9CRowBatchWriter.cs. Same bytes for the same rows: the frame header, the
+// section layout and every value encoding are specified in AiGuides/04-Protocol.md.
+import { G9ESyncColumnType, isColumnType } from '../../abstractions/enums.js';
+import { writeGuidBytes } from '../../abstractions/guid.js';
+import { G9SyncKey } from '../../abstractions/key.js';
+import { G9Long } from '../../abstractions/long.js';
+import { parseDecimal } from '../../internal/dotnetFormat.js';
+import { utf8Encode } from '../../internal/utf8.js';
+import { fromRows } from './columnLayout.js';
+import { G9ECompression, G9EPushRowOp, G9ERowBatchOp, G9RowBatchFormat, isRowBatchOp, writeInt32LE, zigZag } from './format.js';
+/**
+ * Writes a G9RowBatch frame: a 10-byte header (`'G' '9' 'R' 'B' | version | compression | body length i32 LE`) and a
+ * body of sections, each holding rows of one table and one op.
+ */
+export class G9RowBatchWriter {
+    constructor(initialCapacity = 64 * 1024) {
+        this._length = 4;
+        this._sectionCount = 0;
+        this._totalRows = 0;
+        this._inSection = false;
+        this._op = 0;
+        this._keyType = 0;
+        this._types = [];
+        this._rowCountPosition = 0;
+        this._sectionRows = 0;
+        this._inRow = false;
+        this._rowHasValues = false;
+        this._column = 0;
+        this._bitmapPosition = 0;
+        this._buffer = new Uint8Array(Math.max(initialCapacity, 256));
+    }
+    /** Uncompressed body length written so far. */
+    get length() {
+        return this._length;
+    }
+    get totalRows() {
+        return this._totalRows;
+    }
+    get sectionCount() {
+        return this._sectionCount;
+    }
+    get currentSectionRows() {
+        return this._sectionRows;
+    }
+    get inSection() {
+        return this._inSection;
+    }
+    /** Starts a section. Key-only ops (Tombstone, MoveOut, KeyVersions) take no column types. */
+    beginSection(op, tableId, keyType, columnTypes) {
+        if (this._inSection)
+            throw new Error('EndSection must be called before BeginSection.');
+        if (!isRowBatchOp(op))
+            throw new RangeError(`Unknown row batch op ${op}.`);
+        if (!G9SyncKey.isSupportedKeyType(keyType))
+            throw new RangeError(`Unsupported key type ${keyType}.`);
+        if (!(tableId >= 0) || Math.floor(tableId) !== tableId)
+            throw new RangeError('The table id must be a non-negative integer.');
+        if ((op === G9ERowBatchOp.Tombstone || op === G9ERowBatchOp.MoveOut || op === G9ERowBatchOp.KeyVersions) && columnTypes.length > 0) {
+            throw new RangeError('Key-only sections carry no columns.');
+        }
+        if (columnTypes.length > 1024)
+            throw new RangeError('Too many columns.');
+        for (const type of columnTypes) {
+            if (!isColumnType(type))
+                throw new RangeError(`Invalid column type '${type}'.`);
+        }
+        this._ensure(2 + 20 + columnTypes.length + 4);
+        this._buffer[this._length++] = op;
+        this._varintNumber(tableId);
+        this._buffer[this._length++] = keyType;
+        this._varintNumber(columnTypes.length);
+        for (const type of columnTypes)
+            this._buffer[this._length++] = type;
+        this._rowCountPosition = this._length;
+        this._length += 4;
+        this._op = op;
+        this._keyType = keyType;
+        this._types = columnTypes.slice();
+        this._sectionRows = 0;
+        this._inSection = true;
+    }
+    endSection() {
+        if (!this._inSection)
+            throw new Error('No section is open.');
+        if (this._inRow)
+            throw new Error('EndRow must be called before EndSection.');
+        writeInt32LE(this._buffer, this._rowCountPosition, this._sectionRows);
+        this._sectionCount++;
+        this._inSection = false;
+    }
+    // ---------------------------------------------------------------- rows
+    /** Starts an Upsert or Backfill row; write every column, then {@link endRow}. `key` is canonical key text. */
+    beginRow(key, version) {
+        this._startRow(G9ERowBatchOp.Upsert, G9ERowBatchOp.Backfill);
+        this._writeKey(key);
+        this._unsigned(version);
+        this._openValues();
+    }
+    /** Adds a complete Tombstone or MoveOut row. */
+    addKey(key, version) {
+        this._startRow(G9ERowBatchOp.Tombstone, G9ERowBatchOp.MoveOut);
+        this._writeKey(key);
+        this._unsigned(version);
+        this._completeRow();
+    }
+    /** Adds a complete KeyVersions row. */
+    addKeyVersion(key, version, rowHash) {
+        this._startRow(G9ERowBatchOp.KeyVersions, G9ERowBatchOp.KeyVersions);
+        this._writeKey(key);
+        this._unsigned(version);
+        this._ensure(8);
+        rowHash.writeLE(this._buffer, this._length);
+        this._length += 8;
+        this._completeRow();
+    }
+    /** Starts a Push row. Upserts must then write every column; deletes write none. Finish with {@link endRow}. */
+    beginPushRow(key, op, sequence, baseVersion, dirtyMask, hlcMs) {
+        this._startRow(G9ERowBatchOp.Push, G9ERowBatchOp.Push);
+        if (op !== G9EPushRowOp.Upsert && op !== G9EPushRowOp.Delete)
+            throw new RangeError(`Unknown push op ${op}.`);
+        this._writeKey(key);
+        this._ensure(1);
+        this._buffer[this._length++] = op;
+        this._unsigned(sequence);
+        this._unsigned(baseVersion);
+        this._ensure(8);
+        dirtyMask.writeLE(this._buffer, this._length);
+        this._length += 8;
+        if (hlcMs instanceof G9Long)
+            this._varintLong(zigZag(hlcMs));
+        else
+            this._zigZagNumber(hlcMs);
+        if (op === G9EPushRowOp.Upsert)
+            this._openValues();
+    }
+    /** Completes a row started with beginRow or beginPushRow. */
+    endRow() {
+        if (!this._inRow)
+            throw new Error('No row is open.');
+        if (this._rowHasValues && this._column !== this._types.length) {
+            throw new Error(`Row ended after ${this._column} of ${this._types.length} column values.`);
+        }
+        this._completeRow();
+    }
+    // ---------------------------------------------------------------- values
+    writeNull() {
+        const column = this._nextColumn(null);
+        const at = this._bitmapPosition + (column >> 3);
+        this._buffer[at] = this._buffer[at] | (1 << (column & 7));
+    }
+    writeBoolean(value) {
+        this._nextColumn(G9ESyncColumnType.Boolean);
+        this._ensure(1);
+        this._buffer[this._length++] = value ? 1 : 0;
+    }
+    writeInt32(value) {
+        this._nextColumn(G9ESyncColumnType.Int32);
+        if (!(value >= -2147483648 && value <= 2147483647) || Math.floor(value) !== value)
+            throw new RangeError(`${value} is not an Int32.`);
+        this._zigZagNumber(value);
+    }
+    writeInt64(value) {
+        this._nextColumn(G9ESyncColumnType.Int64);
+        if (value instanceof G9Long)
+            this._varintLong(zigZag(value));
+        else
+            this._zigZagNumber(value);
+    }
+    writeDouble(value) {
+        this._nextColumn(G9ESyncColumnType.Double);
+        this._ensure(8);
+        DOUBLE_VIEW.setFloat64(0, value, true);
+        for (let i = 0; i < 8; i++)
+            this._buffer[this._length + i] = DOUBLE_BYTES[i];
+        this._length += 8;
+    }
+    /** A decimal: its .NET parts, or invariant decimal text. */
+    writeDecimal(value) {
+        this._nextColumn(G9ESyncColumnType.Decimal);
+        const parts = typeof value === 'string' ? parseDecimal(value) : value;
+        if (!parts)
+            throw new RangeError(`'${String(value)}' is not a decimal.`);
+        if (!(parts.scale >= 0 && parts.scale <= 28))
+            throw new RangeError('Decimal scale must be 0..28.');
+        this._ensure(16);
+        const flags = ((parts.scale & 0xff) << 16) | (parts.negative ? 0x80000000 : 0);
+        writeInt32LE(this._buffer, this._length, parts.lo);
+        writeInt32LE(this._buffer, this._length + 4, parts.mid);
+        writeInt32LE(this._buffer, this._length + 8, parts.hi);
+        writeInt32LE(this._buffer, this._length + 12, flags);
+        this._length += 16;
+    }
+    /** Writes a string, or NULL when `value` is null. */
+    writeString(value) {
+        if (value === null || value === undefined) {
+            this.writeNull();
+            return;
+        }
+        this._nextColumn(G9ESyncColumnType.String);
+        this._bytesRaw(utf8Encode(value));
+    }
+    /** Writes a string that is already UTF-8 encoded. */
+    writeStringUtf8(utf8) {
+        this._nextColumn(G9ESyncColumnType.String);
+        this._bytesRaw(utf8);
+    }
+    /** Writes a GUID given as text in any form `Guid.Parse` accepts. */
+    writeGuid(value) {
+        this._nextColumn(G9ESyncColumnType.Guid);
+        this._ensure(16);
+        writeGuidBytes(value, this._buffer, this._length);
+        this._length += 16;
+    }
+    writeDateTime(value) {
+        this._nextColumn(G9ESyncColumnType.DateTime);
+        this._ensure(9);
+        value.ticks.writeLE(this._buffer, this._length);
+        this._length += 8;
+        this._buffer[this._length++] = value.kind & 0xff;
+    }
+    writeDateTimeOffset(value) {
+        this._nextColumn(G9ESyncColumnType.DateTimeOffset);
+        if (!(value.offsetMinutes >= -32768 && value.offsetMinutes <= 32767))
+            throw new RangeError('The offset does not fit 16 bits.');
+        this._ensure(10);
+        value.utcTicks.writeLE(this._buffer, this._length);
+        this._length += 8;
+        this._buffer[this._length++] = value.offsetMinutes & 0xff;
+        this._buffer[this._length++] = (value.offsetMinutes >> 8) & 0xff;
+    }
+    /** A TimeSpan as ticks. */
+    writeTimeSpan(ticks) {
+        this._nextColumn(G9ESyncColumnType.TimeSpan);
+        if (ticks instanceof G9Long)
+            this._varintLong(zigZag(ticks));
+        else
+            this._zigZagNumber(ticks);
+    }
+    writeBytes(value) {
+        this._nextColumn(G9ESyncColumnType.Bytes);
+        this._bytesRaw(value);
+    }
+    // ---------------------------------------------------------------- frame
+    /**
+     * Produces the frame. With a compressor and `compression` Brotli, the body is compressed when it is over 128 bytes
+     * and compression helps; otherwise the frame is uncompressed. `version` 2 writes the column-grouped layout (only for
+     * a peer that asked for it).
+     */
+    toFrame(options) {
+        var _a, _b, _c;
+        if (this._inSection)
+            throw new Error('EndSection must be called before ToFrame.');
+        const version = (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : G9RowBatchFormat.Version;
+        if (version !== G9RowBatchFormat.Version && version !== G9RowBatchFormat.ColumnVersion) {
+            throw new RangeError(`Unknown G9RowBatch version ${version}.`);
+        }
+        writeInt32LE(this._buffer, 0, this._sectionCount);
+        const rows = this._buffer.subarray(0, this._length);
+        const body = version === G9RowBatchFormat.ColumnVersion ? fromRows(rows) : rows;
+        const compression = (_b = options === null || options === void 0 ? void 0 : options.compression) !== null && _b !== void 0 ? _b : G9ECompression.Brotli;
+        const compressor = options === null || options === void 0 ? void 0 : options.compressor;
+        if (compression === G9ECompression.Brotli && compressor && body.length > 128) {
+            const compressed = compressor.compress(body, (_c = options === null || options === void 0 ? void 0 : options.quality) !== null && _c !== void 0 ? _c : 4, 22);
+            if (compressed && compressed.length < body.length) {
+                const frame = new Uint8Array(G9RowBatchFormat.HeaderSize + compressed.length);
+                writeHeader(frame, version, G9ECompression.Brotli, body.length);
+                frame.set(compressed, G9RowBatchFormat.HeaderSize);
+                return frame;
+            }
+        }
+        const frame = new Uint8Array(G9RowBatchFormat.HeaderSize + body.length);
+        writeHeader(frame, version, G9ECompression.None, body.length);
+        frame.set(body, G9RowBatchFormat.HeaderSize);
+        return frame;
+    }
+    /** Clears all content so the buffer can be reused for the next frame. */
+    reset() {
+        this._length = 4;
+        this._sectionCount = 0;
+        this._totalRows = 0;
+        this._inSection = false;
+        this._inRow = false;
+        this._rowHasValues = false;
+        this._sectionRows = 0;
+    }
+    // ---------------------------------------------------------------- internals
+    _startRow(allowed1, allowed2) {
+        if (!this._inSection)
+            throw new Error('BeginSection must be called before adding rows.');
+        if (this._inRow)
+            throw new Error('EndRow must be called before starting another row.');
+        if (this._op !== allowed1 && this._op !== allowed2)
+            throw new Error(`This row kind is not valid in a section of op ${this._op}.`);
+        this._inRow = true;
+        this._rowHasValues = false;
+        this._column = 0;
+    }
+    _completeRow() {
+        this._inRow = false;
+        this._rowHasValues = false;
+        this._sectionRows++;
+        this._totalRows++;
+    }
+    _openValues() {
+        const bitmapBytes = (this._types.length + 7) >> 3;
+        this._ensure(bitmapBytes);
+        this._bitmapPosition = this._length;
+        this._buffer.fill(0, this._length, this._length + bitmapBytes);
+        this._length += bitmapBytes;
+        this._column = 0;
+        this._rowHasValues = true;
+    }
+    _nextColumn(expected) {
+        if (!this._inRow || !this._rowHasValues)
+            throw new Error('No row with column values is open.');
+        if (this._column >= this._types.length)
+            throw new Error('Every column of this row has already been written.');
+        if (expected !== null && this._types[this._column] !== expected) {
+            throw new Error(`Column ${this._column} is declared ${this._types[this._column]}, but a ${expected} value was written.`);
+        }
+        return this._column++;
+    }
+    _writeKey(key) {
+        if (typeof key !== 'string')
+            throw new TypeError('The key is required.');
+        switch (this._keyType) {
+            case G9ESyncColumnType.Guid:
+                this._ensure(16);
+                writeGuidBytes(key, this._buffer, this._length);
+                this._length += 16;
+                break;
+            case G9ESyncColumnType.Int32:
+            case G9ESyncColumnType.Int64:
+                this._varintLong(zigZag(G9Long.parse(key)));
+                break;
+            default:
+                this._bytesRaw(utf8Encode(key));
+                break;
+        }
+    }
+    _unsigned(value) {
+        if (value instanceof G9Long) {
+            if (value.isNegative())
+                throw new RangeError(`${value.toString()} must be non-negative.`);
+            this._varintLong(value);
+            return;
+        }
+        if (!(value >= 0) || Math.floor(value) !== value)
+            throw new RangeError(`${value} must be a non-negative integer.`);
+        if (value > 9007199254740991)
+            this._varintLong(G9Long.fromNumber(value));
+        else
+            this._varintNumber(value);
+    }
+    _varintNumber(value) {
+        this._ensure(10);
+        let v = value;
+        while (v >= 128) {
+            this._buffer[this._length++] = (v % 128) | 0x80;
+            v = Math.floor(v / 128);
+        }
+        this._buffer[this._length++] = v;
+    }
+    _varintLong(value) {
+        this._ensure(10);
+        let lo = value.lo;
+        let hi = value.hi >>> 0;
+        while (hi !== 0 || lo >= 128) {
+            this._buffer[this._length++] = (lo & 0x7f) | 0x80;
+            lo = ((lo >>> 7) | (hi << 25)) >>> 0;
+            hi = hi >>> 7;
+        }
+        this._buffer[this._length++] = lo;
+    }
+    _zigZagNumber(value) {
+        if (Math.floor(value) !== value)
+            throw new RangeError(`${value} is not an integer.`);
+        if (value >= -4503599627370496 && value < 4503599627370496)
+            this._varintNumber(value >= 0 ? value * 2 : -value * 2 - 1);
+        else
+            this._varintLong(zigZag(G9Long.fromNumber(value)));
+    }
+    _bytesRaw(value) {
+        this._ensure(10 + value.length);
+        this._varintNumber(value.length);
+        this._buffer.set(value, this._length);
+        this._length += value.length;
+    }
+    _ensure(additional) {
+        const required = this._length + additional;
+        if (required <= this._buffer.length)
+            return;
+        if (required > G9RowBatchFormat.MaxBodyBytes)
+            throw new Error('Row batch exceeds the maximum body size.');
+        const next = new Uint8Array(Math.min(Math.max(required, this._buffer.length * 2), G9RowBatchFormat.MaxBodyBytes));
+        next.set(this._buffer.subarray(0, this._length));
+        this._buffer = next;
+    }
+}
+const DOUBLE_BUFFER = new ArrayBuffer(8);
+const DOUBLE_VIEW = new DataView(DOUBLE_BUFFER);
+const DOUBLE_BYTES = new Uint8Array(DOUBLE_BUFFER);
+function writeHeader(frame, version, compression, bodyLength) {
+    frame[0] = 0x47; // G
+    frame[1] = 0x39; // 9
+    frame[2] = 0x52; // R
+    frame[3] = 0x42; // B
+    frame[4] = version;
+    frame[5] = compression;
+    writeInt32LE(frame, 6, bodyLength);
+}
+//# sourceMappingURL=writer.js.map

package/dist/protocol/rowBatch/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../../src/protocol/rowBatch/writer.ts"],"names":[],"mappings":"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","sourcesContent":["// Twin of G9SyncData.Protocol/RowBatch/G9CRowBatchWriter.cs. Same bytes for the same rows: the frame header, the\n// section layout and every value encoding are specified in AiGuides/04-Protocol.md.\nimport { G9ESyncColumnType, isColumnType } from '../../abstractions/enums.js';\nimport { writeGuidBytes } from '../../abstractions/guid.js';\nimport { G9SyncKey } from '../../abstractions/key.js';\nimport { G9Long } from '../../abstractions/long.js';\nimport { type DecimalParts, parseDecimal } from '../../internal/dotnetFormat.js';\nimport { utf8Encode } from '../../internal/utf8.js';\nimport { fromRows } from './columnLayout.js';\nimport { G9ECompression, G9EPushRowOp, G9ERowBatchOp, G9RowBatchFormat, isRowBatchOp, writeInt32LE, zigZag } from './format.js';\n\n/** A DateTime value on the wire: ticks (100 ns since 0001-01-01) and the `DateTimeKind` (0 unspecified, 1 UTC, 2 local). */\nexport interface G9DateTimeValue {\n  ticks: G9Long;\n  kind: number;\n}\n\n/** A DateTimeOffset value on the wire: UTC ticks and the offset in minutes. */\nexport interface G9DateTimeOffsetValue {\n  utcTicks: G9Long;\n  offsetMinutes: number;\n}\n\n/**\n * A compressor for push frames. Optional: without one the writer emits uncompressed frames, which every reader\n * accepts (the .NET writer falls back to them whenever compression does not help).\n */\nexport interface G9FrameCompressor {\n  compress(body: Uint8Array, quality: number, window: number): Uint8Array | null;\n}\n\n/**\n * Writes a G9RowBatch frame: a 10-byte header (`'G' '9' 'R' 'B' | version | compression | body length i32 LE`) and a\n * body of sections, each holding rows of one table and one op.\n */\nexport class G9RowBatchWriter {\n  private _buffer: Uint8Array;\n  private _length = 4;\n  private _sectionCount = 0;\n  private _totalRows = 0;\n\n  private _inSection = false;\n  private _op: number = 0;\n  private _keyType: number = 0;\n  private _types: number[] = [];\n  private _rowCountPosition = 0;\n  private _sectionRows = 0;\n\n  private _inRow = false;\n  private _rowHasValues = false;\n  private _column = 0;\n  private _bitmapPosition = 0;\n\n  constructor(initialCapacity: number = 64 * 1024) {\n    this._buffer = new Uint8Array(Math.max(initialCapacity, 256));\n  }\n\n  /** Uncompressed body length written so far. */\n  get length(): number {\n    return this._length;\n  }\n\n  get totalRows(): number {\n    return this._totalRows;\n  }\n\n  get sectionCount(): number {\n    return this._sectionCount;\n  }\n\n  get currentSectionRows(): number {\n    return this._sectionRows;\n  }\n\n  get inSection(): boolean {\n    return this._inSection;\n  }\n\n  /** Starts a section. Key-only ops (Tombstone, MoveOut, KeyVersions) take no column types. */\n  beginSection(op: number, tableId: number, keyType: number, columnTypes: readonly number[]): void {\n    if (this._inSection) throw new Error('EndSection must be called before BeginSection.');\n    if (!isRowBatchOp(op)) throw new RangeError(`Unknown row batch op ${op}.`);\n    if (!G9SyncKey.isSupportedKeyType(keyType)) throw new RangeError(`Unsupported key type ${keyType}.`);\n    if (!(tableId >= 0) || Math.floor(tableId) !== tableId) throw new RangeError('The table id must be a non-negative integer.');\n    if ((op === G9ERowBatchOp.Tombstone || op === G9ERowBatchOp.MoveOut || op === G9ERowBatchOp.KeyVersions) && columnTypes.length > 0) {\n      throw new RangeError('Key-only sections carry no columns.');\n    }\n    if (columnTypes.length > 1024) throw new RangeError('Too many columns.');\n    for (const type of columnTypes) {\n      if (!isColumnType(type)) throw new RangeError(`Invalid column type '${type}'.`);\n    }\n\n    this._ensure(2 + 20 + columnTypes.length + 4);\n    this._buffer[this._length++] = op;\n    this._varintNumber(tableId);\n    this._buffer[this._length++] = keyType;\n    this._varintNumber(columnTypes.length);\n    for (const type of columnTypes) this._buffer[this._length++] = type;\n    this._rowCountPosition = this._length;\n    this._length += 4;\n\n    this._op = op;\n    this._keyType = keyType;\n    this._types = columnTypes.slice();\n    this._sectionRows = 0;\n    this._inSection = true;\n  }\n\n  endSection(): void {\n    if (!this._inSection) throw new Error('No section is open.');\n    if (this._inRow) throw new Error('EndRow must be called before EndSection.');\n    writeInt32LE(this._buffer, this._rowCountPosition, this._sectionRows);\n    this._sectionCount++;\n    this._inSection = false;\n  }\n\n  // ---------------------------------------------------------------- rows\n\n  /** Starts an Upsert or Backfill row; write every column, then {@link endRow}. `key` is canonical key text. */\n  beginRow(key: string, version: number | G9Long): void {\n    this._startRow(G9ERowBatchOp.Upsert, G9ERowBatchOp.Backfill);\n    this._writeKey(key);\n    this._unsigned(version);\n    this._openValues();\n  }\n\n  /** Adds a complete Tombstone or MoveOut row. */\n  addKey(key: string, version: number | G9Long): void {\n    this._startRow(G9ERowBatchOp.Tombstone, G9ERowBatchOp.MoveOut);\n    this._writeKey(key);\n    this._unsigned(version);\n    this._completeRow();\n  }\n\n  /** Adds a complete KeyVersions row. */\n  addKeyVersion(key: string, version: number | G9Long, rowHash: G9Long): void {\n    this._startRow(G9ERowBatchOp.KeyVersions, G9ERowBatchOp.KeyVersions);\n    this._writeKey(key);\n    this._unsigned(version);\n    this._ensure(8);\n    rowHash.writeLE(this._buffer, this._length);\n    this._length += 8;\n    this._completeRow();\n  }\n\n  /** Starts a Push row. Upserts must then write every column; deletes write none. Finish with {@link endRow}. */\n  beginPushRow(key: string, op: number, sequence: number | G9Long, baseVersion: number | G9Long, dirtyMask: G9Long, hlcMs: number | G9Long): void {\n    this._startRow(G9ERowBatchOp.Push, G9ERowBatchOp.Push);\n    if (op !== G9EPushRowOp.Upsert && op !== G9EPushRowOp.Delete) throw new RangeError(`Unknown push op ${op}.`);\n    this._writeKey(key);\n    this._ensure(1);\n    this._buffer[this._length++] = op;\n    this._unsigned(sequence);\n    this._unsigned(baseVersion);\n    this._ensure(8);\n    dirtyMask.writeLE(this._buffer, this._length);\n    this._length += 8;\n    if (hlcMs instanceof G9Long) this._varintLong(zigZag(hlcMs));\n    else this._zigZagNumber(hlcMs);\n    if (op === G9EPushRowOp.Upsert) this._openValues();\n  }\n\n  /** Completes a row started with beginRow or beginPushRow. */\n  endRow(): void {\n    if (!this._inRow) throw new Error('No row is open.');\n    if (this._rowHasValues && this._column !== this._types.length) {\n      throw new Error(`Row ended after ${this._column} of ${this._types.length} column values.`);\n    }\n    this._completeRow();\n  }\n\n  // ---------------------------------------------------------------- values\n\n  writeNull(): void {\n    const column = this._nextColumn(null);\n    const at = this._bitmapPosition + (column >> 3);\n    this._buffer[at] = (this._buffer[at] as number) | (1 << (column & 7));\n  }\n\n  writeBoolean(value: boolean): void {\n    this._nextColumn(G9ESyncColumnType.Boolean);\n    this._ensure(1);\n    this._buffer[this._length++] = value ? 1 : 0;\n  }\n\n  writeInt32(value: number): void {\n    this._nextColumn(G9ESyncColumnType.Int32);\n    if (!(value >= -2147483648 && value <= 2147483647) || Math.floor(value) !== value) throw new RangeError(`${value} is not an Int32.`);\n    this._zigZagNumber(value);\n  }\n\n  writeInt64(value: number | G9Long): void {\n    this._nextColumn(G9ESyncColumnType.Int64);\n    if (value instanceof G9Long) this._varintLong(zigZag(value));\n    else this._zigZagNumber(value);\n  }\n\n  writeDouble(value: number): void {\n    this._nextColumn(G9ESyncColumnType.Double);\n    this._ensure(8);\n    DOUBLE_VIEW.setFloat64(0, value, true);\n    for (let i = 0; i < 8; i++) this._buffer[this._length + i] = DOUBLE_BYTES[i] as number;\n    this._length += 8;\n  }\n\n  /** A decimal: its .NET parts, or invariant decimal text. */\n  writeDecimal(value: DecimalParts | string): void {\n    this._nextColumn(G9ESyncColumnType.Decimal);\n    const parts = typeof value === 'string' ? parseDecimal(value) : value;\n    if (!parts) throw new RangeError(`'${String(value)}' is not a decimal.`);\n    if (!(parts.scale >= 0 && parts.scale <= 28)) throw new RangeError('Decimal scale must be 0..28.');\n    this._ensure(16);\n    const flags = ((parts.scale & 0xff) << 16) | (parts.negative ? 0x80000000 : 0);\n    writeInt32LE(this._buffer, this._length, parts.lo);\n    writeInt32LE(this._buffer, this._length + 4, parts.mid);\n    writeInt32LE(this._buffer, this._length + 8, parts.hi);\n    writeInt32LE(this._buffer, this._length + 12, flags);\n    this._length += 16;\n  }\n\n  /** Writes a string, or NULL when `value` is null. */\n  writeString(value: string | null): void {\n    if (value === null || value === undefined) {\n      this.writeNull();\n      return;\n    }\n    this._nextColumn(G9ESyncColumnType.String);\n    this._bytesRaw(utf8Encode(value));\n  }\n\n  /** Writes a string that is already UTF-8 encoded. */\n  writeStringUtf8(utf8: Uint8Array): void {\n    this._nextColumn(G9ESyncColumnType.String);\n    this._bytesRaw(utf8);\n  }\n\n  /** Writes a GUID given as text in any form `Guid.Parse` accepts. */\n  writeGuid(value: string): void {\n    this._nextColumn(G9ESyncColumnType.Guid);\n    this._ensure(16);\n    writeGuidBytes(value, this._buffer, this._length);\n    this._length += 16;\n  }\n\n  writeDateTime(value: G9DateTimeValue): void {\n    this._nextColumn(G9ESyncColumnType.DateTime);\n    this._ensure(9);\n    value.ticks.writeLE(this._buffer, this._length);\n    this._length += 8;\n    this._buffer[this._length++] = value.kind & 0xff;\n  }\n\n  writeDateTimeOffset(value: G9DateTimeOffsetValue): void {\n    this._nextColumn(G9ESyncColumnType.DateTimeOffset);\n    if (!(value.offsetMinutes >= -32768 && value.offsetMinutes <= 32767)) throw new RangeError('The offset does not fit 16 bits.');\n    this._ensure(10);\n    value.utcTicks.writeLE(this._buffer, this._length);\n    this._length += 8;\n    this._buffer[this._length++] = value.offsetMinutes & 0xff;\n    this._buffer[this._length++] = (value.offsetMinutes >> 8) & 0xff;\n  }\n\n  /** A TimeSpan as ticks. */\n  writeTimeSpan(ticks: number | G9Long): void {\n    this._nextColumn(G9ESyncColumnType.TimeSpan);\n    if (ticks instanceof G9Long) this._varintLong(zigZag(ticks));\n    else this._zigZagNumber(ticks);\n  }\n\n  writeBytes(value: Uint8Array): void {\n    this._nextColumn(G9ESyncColumnType.Bytes);\n    this._bytesRaw(value);\n  }\n\n  // ---------------------------------------------------------------- frame\n\n  /**\n   * Produces the frame. With a compressor and `compression` Brotli, the body is compressed when it is over 128 bytes\n   * and compression helps; otherwise the frame is uncompressed. `version` 2 writes the column-grouped layout (only for\n   * a peer that asked for it).\n   */\n  toFrame(options?: { compression?: number; quality?: number; version?: number; compressor?: G9FrameCompressor | null }): Uint8Array {\n    if (this._inSection) throw new Error('EndSection must be called before ToFrame.');\n    const version = options?.version ?? G9RowBatchFormat.Version;\n    if (version !== G9RowBatchFormat.Version && version !== G9RowBatchFormat.ColumnVersion) {\n      throw new RangeError(`Unknown G9RowBatch version ${version}.`);\n    }\n    writeInt32LE(this._buffer, 0, this._sectionCount);\n    const rows = this._buffer.subarray(0, this._length);\n    const body = version === G9RowBatchFormat.ColumnVersion ? fromRows(rows) : rows;\n\n    const compression = options?.compression ?? G9ECompression.Brotli;\n    const compressor = options?.compressor;\n    if (compression === G9ECompression.Brotli && compressor && body.length > 128) {\n      const compressed = compressor.compress(body, options?.quality ?? 4, 22);\n      if (compressed && compressed.length < body.length) {\n        const frame = new Uint8Array(G9RowBatchFormat.HeaderSize + compressed.length);\n        writeHeader(frame, version, G9ECompression.Brotli, body.length);\n        frame.set(compressed, G9RowBatchFormat.HeaderSize);\n        return frame;\n      }\n    }\n    const frame = new Uint8Array(G9RowBatchFormat.HeaderSize + body.length);\n    writeHeader(frame, version, G9ECompression.None, body.length);\n    frame.set(body, G9RowBatchFormat.HeaderSize);\n    return frame;\n  }\n\n  /** Clears all content so the buffer can be reused for the next frame. */\n  reset(): void {\n    this._length = 4;\n    this._sectionCount = 0;\n    this._totalRows = 0;\n    this._inSection = false;\n    this._inRow = false;\n    this._rowHasValues = false;\n    this._sectionRows = 0;\n  }\n\n  // ---------------------------------------------------------------- internals\n\n  private _startRow(allowed1: number, allowed2: number): void {\n    if (!this._inSection) throw new Error('BeginSection must be called before adding rows.');\n    if (this._inRow) throw new Error('EndRow must be called before starting another row.');\n    if (this._op !== allowed1 && this._op !== allowed2) throw new Error(`This row kind is not valid in a section of op ${this._op}.`);\n    this._inRow = true;\n    this._rowHasValues = false;\n    this._column = 0;\n  }\n\n  private _completeRow(): void {\n    this._inRow = false;\n    this._rowHasValues = false;\n    this._sectionRows++;\n    this._totalRows++;\n  }\n\n  private _openValues(): void {\n    const bitmapBytes = (this._types.length + 7) >> 3;\n    this._ensure(bitmapBytes);\n    this._bitmapPosition = this._length;\n    this._buffer.fill(0, this._length, this._length + bitmapBytes);\n    this._length += bitmapBytes;\n    this._column = 0;\n    this._rowHasValues = true;\n  }\n\n  private _nextColumn(expected: number | null): number {\n    if (!this._inRow || !this._rowHasValues) throw new Error('No row with column values is open.');\n    if (this._column >= this._types.length) throw new Error('Every column of this row has already been written.');\n    if (expected !== null && this._types[this._column] !== expected) {\n      throw new Error(`Column ${this._column} is declared ${this._types[this._column]}, but a ${expected} value was written.`);\n    }\n    return this._column++;\n  }\n\n  private _writeKey(key: string): void {\n    if (typeof key !== 'string') throw new TypeError('The key is required.');\n    switch (this._keyType) {\n      case G9ESyncColumnType.Guid:\n        this._ensure(16);\n        writeGuidBytes(key, this._buffer, this._length);\n        this._length += 16;\n        break;\n      case G9ESyncColumnType.Int32:\n      case G9ESyncColumnType.Int64:\n        this._varintLong(zigZag(G9Long.parse(key)));\n        break;\n      default:\n        this._bytesRaw(utf8Encode(key));\n        break;\n    }\n  }\n\n  private _unsigned(value: number | G9Long): void {\n    if (value instanceof G9Long) {\n      if (value.isNegative()) throw new RangeError(`${value.toString()} must be non-negative.`);\n      this._varintLong(value);\n      return;\n    }\n    if (!(value >= 0) || Math.floor(value) !== value) throw new RangeError(`${value} must be a non-negative integer.`);\n    if (value > 9007199254740991) this._varintLong(G9Long.fromNumber(value));\n    else this._varintNumber(value);\n  }\n\n  private _varintNumber(value: number): void {\n    this._ensure(10);\n    let v = value;\n    while (v >= 128) {\n      this._buffer[this._length++] = (v % 128) | 0x80;\n      v = Math.floor(v / 128);\n    }\n    this._buffer[this._length++] = v;\n  }\n\n  private _varintLong(value: G9Long): void {\n    this._ensure(10);\n    let lo = value.lo;\n    let hi = value.hi >>> 0;\n    while (hi !== 0 || lo >= 128) {\n      this._buffer[this._length++] = (lo & 0x7f) | 0x80;\n      lo = ((lo >>> 7) | (hi << 25)) >>> 0;\n      hi = hi >>> 7;\n    }\n    this._buffer[this._length++] = lo;\n  }\n\n  private _zigZagNumber(value: number): void {\n    if (Math.floor(value) !== value) throw new RangeError(`${value} is not an integer.`);\n    if (value >= -4503599627370496 && value < 4503599627370496) this._varintNumber(value >= 0 ? value * 2 : -value * 2 - 1);\n    else this._varintLong(zigZag(G9Long.fromNumber(value)));\n  }\n\n  private _bytesRaw(value: Uint8Array): void {\n    this._ensure(10 + value.length);\n    this._varintNumber(value.length);\n    this._buffer.set(value, this._length);\n    this._length += value.length;\n  }\n\n  private _ensure(additional: number): void {\n    const required = this._length + additional;\n    if (required <= this._buffer.length) return;\n    if (required > G9RowBatchFormat.MaxBodyBytes) throw new Error('Row batch exceeds the maximum body size.');\n    const next = new Uint8Array(Math.min(Math.max(required, this._buffer.length * 2), G9RowBatchFormat.MaxBodyBytes));\n    next.set(this._buffer.subarray(0, this._length));\n    this._buffer = next;\n  }\n}\n\nconst DOUBLE_BUFFER = new ArrayBuffer(8);\nconst DOUBLE_VIEW = new DataView(DOUBLE_BUFFER);\nconst DOUBLE_BYTES = new Uint8Array(DOUBLE_BUFFER);\n\nfunction writeHeader(frame: Uint8Array, version: number, compression: number, bodyLength: number): void {\n  frame[0] = 0x47; // G\n  frame[1] = 0x39; // 9\n  frame[2] = 0x52; // R\n  frame[3] = 0x42; // B\n  frame[4] = version;\n  frame[5] = compression;\n  writeInt32LE(frame, 6, bodyLength);\n}\n"]}

package/dist/protocol/wire.d.ts

@@ -0,0 +1,32 @@
+import type { G9DtChangesAvailable, G9DtHelloResult, G9DtNegotiatedTable, G9DtPullContinuation, G9DtPullPlan, G9DtPushResult, G9DtReconcileSummary, G9DtSubscriptionDefinition, G9DtSubscriptionState, G9DtSyncChunk, G9DtSyncError } from './dtos.js';
+/** Which SignalR hub protocol a value came from or goes to. */
+export type G9WireFormat = 'json' | 'messagepack';
+/** A GUID on its way into MessagePack (written as extension type 2, 16 big-endian bytes, like Nerdbank's Guid converter). */
+export declare class G9WireGuid {
+    readonly value: string;
+    constructor(value: string);
+}
+/** Nerdbank.MessagePack's extension type for System.Guid. */
+export declare const GUID_EXTENSION_TYPE = 2;
+/** The camelCase twin of a decoded MessagePack value (a `Parameters` dictionary keeps its own keys). */
+export declare function fromMessagePackNames(value: unknown): unknown;
+/**
+ * The MessagePack form of an outgoing DTO: PascalCase names (a `parameters` dictionary keeps its keys), GUID fields as
+ * {@link G9WireGuid}. G9Long values stay as they are (the protocol writes them as int64).
+ */
+export declare function toMessagePackNames(value: unknown): unknown;
+/** A byte[] field: base64 text (JSON) or bytes (MessagePack). */
+export declare function bytesField(value: unknown): Uint8Array | null;
+/** Epoch milliseconds of a wire DateTime: ISO text (JSON) or a Date (MessagePack timestamp). */
+export declare function dateTimeMs(value: unknown): number;
+export declare function readSyncError(value: unknown): G9DtSyncError | null;
+export declare function readNegotiatedTable(value: unknown): G9DtNegotiatedTable;
+export declare function readSubscriptionDefinition(value: unknown): G9DtSubscriptionDefinition;
+export declare function readSubscriptionState(value: unknown): G9DtSubscriptionState;
+export declare function readHelloResult(value: unknown): G9DtHelloResult;
+export declare function readPushResult(value: unknown): G9DtPushResult;
+export declare function readPullPlan(value: unknown): G9DtPullPlan;
+export declare function readContinuation(value: unknown): G9DtPullContinuation | null;
+export declare function readReconcileSummary(value: unknown): G9DtReconcileSummary | null;
+export declare function readSyncChunk(value: unknown): G9DtSyncChunk;
+export declare function readChangesAvailable(value: unknown): G9DtChangesAvailable;