@g9tm/syncdata 1.2.1

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

@@ -0,0 +1,119 @@
+import { G9Long } from '../../abstractions/long.js';
+import type { DecimalParts } from '../../internal/dotnetFormat.js';
+import type { G9DateTimeOffsetValue, G9DateTimeValue } from './writer.js';
+/**
+ * Decompresses a Brotli frame body. Returns exactly `expectedLength` bytes or throws. Node: `nodeBrotliDecompressor()`
+ * (`@g9tm/syncdata/node`); Lynx: the native module of `@g9tm/syncdata-lynx`; anywhere: `jsBrotliDecompressor()`
+ * (`@g9tm/syncdata/brotli-js`, pure JavaScript, slower).
+ */
+export interface G9FrameDecompressor {
+    decompress(compressed: Uint8Array, expectedLength: number): Uint8Array | Promise<Uint8Array>;
+}
+/** The header of a frame, read without decoding the body. */
+export interface G9FrameHeader {
+    version: number;
+    compression: number;
+    bodyLength: number;
+}
+/** Validates a frame's header (magic, version, compression, body length, budget). */
+export declare function readFrameHeader(frame: Uint8Array, maxBodyBytes?: number): G9FrameHeader;
+/**
+ * Sets the Brotli decoder used wherever none is passed explicitly (the store, the engine's reconciliation). Call it
+ * once at start-up: `useNodeBrotli()` (`@g9tm/syncdata/node`), `useLynxBrotli()` (`@g9tm/syncdata-lynx`) or
+ * `setDefaultFrameDecompressor(jsBrotliDecompressor())` (`@g9tm/syncdata/brotli-js`).
+ */
+export declare function setDefaultFrameDecompressor(decompressor: G9FrameDecompressor | null): void;
+/** The decoder set with {@link setDefaultFrameDecompressor}, or null. */
+export declare function getDefaultFrameDecompressor(): G9FrameDecompressor | null;
+/** Options of {@link openRowBatch}. */
+export interface G9OpenRowBatchOptions {
+    /** Brotli decoder for compressed frames (every frame the server sends over 128 bytes); the default decoder when omitted. */
+    decompressor?: G9FrameDecompressor | null;
+    /** The largest decoded body this caller allocates for (ADR-0051). */
+    maxBodyBytes?: number;
+}
+/**
+ * Validates, decompresses when needed, and opens a frame. Async because a Lynx decompressor crosses the native bridge;
+ * an uncompressed frame resolves without waiting on anything.
+ */
+export declare function openRowBatch(frame: Uint8Array, options?: G9OpenRowBatchOptions): Promise<G9RowBatchReader>;
+/** Opens an uncompressed frame synchronously (throws for a compressed one). */
+export declare function openRowBatchSync(frame: Uint8Array, maxBodyBytes?: number): G9RowBatchReader;
+/** Reads the sections and rows of one G9RowBatch body. */
+export declare class G9RowBatchReader {
+    private readonly _body;
+    private readonly _cursor;
+    private _sectionsRemaining;
+    private _sectionOpen;
+    private _rowsRemaining;
+    private _types;
+    private _offsets;
+    private _keyStart;
+    private _keyLength;
+    private _keyText;
+    private _versionPos;
+    private _sequencePos;
+    private _baseVersionPos;
+    private _hlcPos;
+    readonly sectionCount: number;
+    op: number;
+    tableId: number;
+    keyType: number;
+    rowCount: number;
+    version: number;
+    pushOp: number;
+    sequence: number;
+    baseVersion: number;
+    dirtyMask: G9Long;
+    hlcMs: number;
+    rowHash: G9Long;
+    hasValues: boolean;
+    private constructor();
+    /** Opens an already decompressed body of the given layout version. */
+    static fromBody(body: Uint8Array, version: number): G9RowBatchReader;
+    /** The decoded size of this frame's body (row-wise layout). */
+    get bodyBytes(): number;
+    get columnTypes(): readonly number[];
+    get columnCount(): number;
+    /** Moves to the next section, skipping unread rows of the current one. */
+    nextSection(): boolean;
+    /** Moves to the next row of the current section. */
+    readRow(): boolean;
+    /** The row's version, exact (the {@link version} number is exact below 2^53). */
+    get versionLong(): G9Long;
+    /** A push row's local sequence, exact. */
+    get sequenceLong(): G9Long;
+    /** A push row's base version, exact. */
+    get baseVersionLong(): G9Long;
+    /** A push row's HLC milliseconds, exact. */
+    get hlcLong(): G9Long;
+    /** Canonical key text (see G9SyncKey). */
+    get key(): string;
+    /** The integer key. */
+    get keyInt64(): G9Long;
+    /** UTF-8 bytes of a string key. */
+    get keyUtf8(): Uint8Array;
+    isNull(column: number): boolean;
+    getBoolean(column: number): boolean;
+    getInt32(column: number): number;
+    /** An Int64 value, exact. */
+    getInt64(column: number): G9Long;
+    getDouble(column: number): number;
+    getDecimal(column: number): DecimalParts;
+    getString(column: number): string;
+    getUtf8(column: number): Uint8Array;
+    /** A GUID in canonical text form. */
+    getGuid(column: number): string;
+    getDateTime(column: number): G9DateTimeValue;
+    getDateTimeOffset(column: number): G9DateTimeOffsetValue;
+    /** A TimeSpan as ticks, exact. */
+    getTimeSpan(column: number): G9Long;
+    /** The bytes of a Bytes column (a view into the body; copy it to keep it). */
+    getBytes(column: number): Uint8Array;
+    private _readValues;
+    private _offset;
+    private _ensureValues;
+    private _lengthPrefixed;
+    private _readByte;
+    private _ensure;
+}

package/dist/protocol/rowBatch/reader.js

@@ -0,0 +1,459 @@
+// Twin of G9SyncData.Protocol/RowBatch/G9CRowBatchReader.cs: reads a G9RowBatch frame in either body layout. Forward
+// only; values are decoded from the body on demand.
+import { G9ESyncColumnType } from '../../abstractions/enums.js';
+import { readGuidBytes } from '../../abstractions/guid.js';
+import { G9SyncKey } from '../../abstractions/key.js';
+import { G9Long } from '../../abstractions/long.js';
+import { utf8Decode } from '../../internal/utf8.js';
+import { toRows } from './columnLayout.js';
+import { G9ECompression, G9EPushRowOp, G9ERowBatchOp, G9RowBatchFormat, G9RowBatchFormatError, isRowBatchOp, readInt32LE, readVarint, readVarintInt32, readVarintLong, readZigZagLong, readZigZagNumber, } from './format.js';
+/** Validates a frame's header (magic, version, compression, body length, budget). */
+export function readFrameHeader(frame, maxBodyBytes = G9RowBatchFormat.MaxDecodedBytes) {
+    if (!(maxBodyBytes > 0))
+        throw new RangeError('maxBodyBytes must be positive.');
+    if (frame.length < G9RowBatchFormat.HeaderSize || frame[0] !== 0x47 || frame[1] !== 0x39 || frame[2] !== 0x52 || frame[3] !== 0x42) {
+        throw new G9RowBatchFormatError('Not a G9RowBatch frame.');
+    }
+    const version = frame[4];
+    if (version !== G9RowBatchFormat.Version && version !== G9RowBatchFormat.ColumnVersion) {
+        throw new G9RowBatchFormatError(`Unsupported G9RowBatch version ${version}.`);
+    }
+    const compression = frame[5];
+    const bodyLength = readInt32LE(frame, 6);
+    if (bodyLength < 4 || bodyLength > G9RowBatchFormat.MaxDecodedBytes)
+        throw new G9RowBatchFormatError('Invalid body length.');
+    if (bodyLength > maxBodyBytes) {
+        throw new G9RowBatchFormatError(`The frame declares a ${bodyLength}-byte body; this reader accepts at most ${maxBodyBytes} bytes.`);
+    }
+    if (compression !== G9ECompression.None && compression !== G9ECompression.Brotli) {
+        throw new G9RowBatchFormatError(`Unknown compression ${compression}.`);
+    }
+    if (compression === G9ECompression.None && frame.length - G9RowBatchFormat.HeaderSize !== bodyLength) {
+        throw new G9RowBatchFormatError('Body length mismatch.');
+    }
+    return { version, compression, bodyLength };
+}
+let defaultDecompressor = null;
+/**
+ * Sets the Brotli decoder used wherever none is passed explicitly (the store, the engine's reconciliation). Call it
+ * once at start-up: `useNodeBrotli()` (`@g9tm/syncdata/node`), `useLynxBrotli()` (`@g9tm/syncdata-lynx`) or
+ * `setDefaultFrameDecompressor(jsBrotliDecompressor())` (`@g9tm/syncdata/brotli-js`).
+ */
+export function setDefaultFrameDecompressor(decompressor) {
+    defaultDecompressor = decompressor;
+}
+/** The decoder set with {@link setDefaultFrameDecompressor}, or null. */
+export function getDefaultFrameDecompressor() {
+    return defaultDecompressor;
+}
+/**
+ * Validates, decompresses when needed, and opens a frame. Async because a Lynx decompressor crosses the native bridge;
+ * an uncompressed frame resolves without waiting on anything.
+ */
+export async function openRowBatch(frame, options) {
+    var _a;
+    const header = readFrameHeader(frame, options === null || options === void 0 ? void 0 : options.maxBodyBytes);
+    if (header.compression === G9ECompression.None)
+        return G9RowBatchReader.fromBody(frame.subarray(G9RowBatchFormat.HeaderSize), header.version);
+    const decompressor = (_a = options === null || options === void 0 ? void 0 : options.decompressor) !== null && _a !== void 0 ? _a : defaultDecompressor;
+    if (!decompressor) {
+        throw new G9RowBatchFormatError('The frame is Brotli-compressed and no decompressor is configured (see G9FrameDecompressor).');
+    }
+    let body;
+    try {
+        body = await decompressor.decompress(frame.subarray(G9RowBatchFormat.HeaderSize), header.bodyLength);
+    }
+    catch (error) {
+        throw new G9RowBatchFormatError(`Brotli body could not be decompressed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!body || body.length !== header.bodyLength)
+        throw new G9RowBatchFormatError('Brotli body could not be decompressed.');
+    return G9RowBatchReader.fromBody(body, header.version);
+}
+/** Opens an uncompressed frame synchronously (throws for a compressed one). */
+export function openRowBatchSync(frame, maxBodyBytes) {
+    const header = readFrameHeader(frame, maxBodyBytes);
+    if (header.compression !== G9ECompression.None)
+        throw new G9RowBatchFormatError('The frame is compressed; use openRowBatch.');
+    return G9RowBatchReader.fromBody(frame.subarray(G9RowBatchFormat.HeaderSize), header.version);
+}
+/** Reads the sections and rows of one G9RowBatch body. */
+export class G9RowBatchReader {
+    constructor(body) {
+        this._cursor = { pos: 4 };
+        this._sectionOpen = false;
+        this._rowsRemaining = 0;
+        this._types = [];
+        this._offsets = [];
+        this._keyStart = 0;
+        this._keyLength = 0;
+        this._keyText = null;
+        this._versionPos = -1;
+        this._sequencePos = -1;
+        this._baseVersionPos = -1;
+        this._hlcPos = -1;
+        // section
+        this.op = 0;
+        this.tableId = 0;
+        this.keyType = 0;
+        this.rowCount = 0;
+        // row
+        this.version = 0;
+        this.pushOp = 0;
+        this.sequence = 0;
+        this.baseVersion = 0;
+        this.dirtyMask = G9Long.ZERO;
+        this.hlcMs = 0;
+        this.rowHash = G9Long.ZERO;
+        this.hasValues = false;
+        if (body.length < 4)
+            throw new G9RowBatchFormatError('Row batch body is too short.');
+        this._body = body;
+        this.sectionCount = readInt32LE(body, 0);
+        if (this.sectionCount < 0)
+            throw new G9RowBatchFormatError('Negative section count.');
+        this._sectionsRemaining = this.sectionCount;
+    }
+    /** Opens an already decompressed body of the given layout version. */
+    static fromBody(body, version) {
+        return new G9RowBatchReader(version === G9RowBatchFormat.ColumnVersion ? toRows(body) : body);
+    }
+    /** The decoded size of this frame's body (row-wise layout). */
+    get bodyBytes() {
+        return this._body.length;
+    }
+    get columnTypes() {
+        return this._types;
+    }
+    get columnCount() {
+        return this._types.length;
+    }
+    /** Moves to the next section, skipping unread rows of the current one. */
+    nextSection() {
+        if (this._sectionOpen) {
+            while (this.readRow()) {
+                // skip
+            }
+        }
+        if (this._sectionsRemaining === 0) {
+            this._sectionOpen = false;
+            return false;
+        }
+        const body = this._body;
+        const cursor = this._cursor;
+        this.op = this._readByte();
+        if (!isRowBatchOp(this.op))
+            throw new G9RowBatchFormatError(`Unknown op ${this.op}.`);
+        this.tableId = readVarintInt32(body, cursor);
+        this.keyType = this._readByte();
+        if (!G9SyncKey.isSupportedKeyType(this.keyType))
+            throw new G9RowBatchFormatError(`Unsupported key type ${this.keyType}.`);
+        const columnCount = readVarintInt32(body, cursor);
+        if (columnCount > 1024)
+            throw new G9RowBatchFormatError('Too many columns.');
+        this._ensure(columnCount + 4);
+        const types = [];
+        for (let i = 0; i < columnCount; i++)
+            types.push(body[cursor.pos++]);
+        this._types = types;
+        this.rowCount = readInt32LE(body, cursor.pos);
+        cursor.pos += 4;
+        if (this.rowCount < 0)
+            throw new G9RowBatchFormatError('Negative row count.');
+        if (this._offsets.length < columnCount)
+            this._offsets = new Array(columnCount);
+        this._rowsRemaining = this.rowCount;
+        this._sectionsRemaining--;
+        this._sectionOpen = true;
+        return true;
+    }
+    /** Moves to the next row of the current section. */
+    readRow() {
+        if (!this._sectionOpen || this._rowsRemaining === 0)
+            return false;
+        const body = this._body;
+        const cursor = this._cursor;
+        this._keyText = null;
+        this.hasValues = false;
+        this.version = 0;
+        this.rowHash = G9Long.ZERO;
+        switch (this.keyType) {
+            case G9ESyncColumnType.Guid:
+                this._ensure(16);
+                this._keyStart = cursor.pos;
+                this._keyLength = 16;
+                cursor.pos += 16;
+                break;
+            case G9ESyncColumnType.Int32:
+            case G9ESyncColumnType.Int64:
+                this._keyStart = cursor.pos;
+                readVarintLong(body, cursor);
+                this._keyLength = cursor.pos - this._keyStart;
+                break;
+            default: {
+                const length = readVarintInt32(body, cursor);
+                this._ensure(length);
+                this._keyStart = cursor.pos;
+                this._keyLength = length;
+                cursor.pos += length;
+                break;
+            }
+        }
+        switch (this.op) {
+            case G9ERowBatchOp.Upsert:
+            case G9ERowBatchOp.Backfill:
+                this._versionPos = cursor.pos;
+                this.version = readVarint(body, cursor);
+                this._readValues();
+                break;
+            case G9ERowBatchOp.Tombstone:
+            case G9ERowBatchOp.MoveOut:
+                this._versionPos = cursor.pos;
+                this.version = readVarint(body, cursor);
+                break;
+            case G9ERowBatchOp.KeyVersions:
+                this._versionPos = cursor.pos;
+                this.version = readVarint(body, cursor);
+                this._ensure(8);
+                this.rowHash = G9Long.readLE(body, cursor.pos);
+                cursor.pos += 8;
+                break;
+            case G9ERowBatchOp.Push:
+                this.pushOp = this._readByte();
+                if (this.pushOp !== G9EPushRowOp.Upsert && this.pushOp !== G9EPushRowOp.Delete)
+                    throw new G9RowBatchFormatError(`Unknown push op ${this.pushOp}.`);
+                this._versionPos = -1;
+                this._sequencePos = cursor.pos;
+                this.sequence = readVarint(body, cursor);
+                this._baseVersionPos = cursor.pos;
+                this.baseVersion = readVarint(body, cursor);
+                this._ensure(8);
+                this.dirtyMask = G9Long.readLE(body, cursor.pos);
+                cursor.pos += 8;
+                this._hlcPos = cursor.pos;
+                this.hlcMs = readZigZagNumber(body, cursor);
+                if (this.pushOp === G9EPushRowOp.Upsert)
+                    this._readValues();
+                break;
+        }
+        this._rowsRemaining--;
+        return true;
+    }
+    /** The row's version, exact (the {@link version} number is exact below 2^53). */
+    get versionLong() {
+        return this._versionPos < 0 ? G9Long.ZERO : readVarintLong(this._body, { pos: this._versionPos });
+    }
+    /** A push row's local sequence, exact. */
+    get sequenceLong() {
+        return readVarintLong(this._body, { pos: this._sequencePos });
+    }
+    /** A push row's base version, exact. */
+    get baseVersionLong() {
+        return readVarintLong(this._body, { pos: this._baseVersionPos });
+    }
+    /** A push row's HLC milliseconds, exact. */
+    get hlcLong() {
+        return readZigZagLong(this._body, { pos: this._hlcPos });
+    }
+    // ---------------------------------------------------------------- key
+    /** Canonical key text (see G9SyncKey). */
+    get key() {
+        if (this._keyText === null) {
+            switch (this.keyType) {
+                case G9ESyncColumnType.Guid:
+                    this._keyText = readGuidBytes(this._body, this._keyStart);
+                    break;
+                case G9ESyncColumnType.Int32:
+                case G9ESyncColumnType.Int64:
+                    this._keyText = this.keyInt64.toString();
+                    break;
+                default:
+                    this._keyText = utf8Decode(this._body.subarray(this._keyStart, this._keyStart + this._keyLength));
+                    break;
+            }
+        }
+        return this._keyText;
+    }
+    /** The integer key. */
+    get keyInt64() {
+        if (this.keyType !== G9ESyncColumnType.Int32 && this.keyType !== G9ESyncColumnType.Int64)
+            throw new Error(`Key type is ${this.keyType}.`);
+        return readZigZagLong(this._body, { pos: this._keyStart });
+    }
+    /** UTF-8 bytes of a string key. */
+    get keyUtf8() {
+        if (this.keyType !== G9ESyncColumnType.String)
+            throw new Error(`Key type is ${this.keyType}.`);
+        return this._body.subarray(this._keyStart, this._keyStart + this._keyLength);
+    }
+    // ---------------------------------------------------------------- values
+    isNull(column) {
+        this._ensureValues(column);
+        return this._offsets[column] < 0;
+    }
+    getBoolean(column) {
+        return this._body[this._offset(column, G9ESyncColumnType.Boolean)] !== 0;
+    }
+    getInt32(column) {
+        const value = readZigZagNumber(this._body, { pos: this._offset(column, G9ESyncColumnType.Int32) });
+        if (value < -2147483648 || value > 2147483647)
+            throw new G9RowBatchFormatError('Int32 value is out of range.');
+        return value;
+    }
+    /** An Int64 value, exact. */
+    getInt64(column) {
+        return readZigZagLong(this._body, { pos: this._offset(column, G9ESyncColumnType.Int64) });
+    }
+    getDouble(column) {
+        const at = this._offset(column, G9ESyncColumnType.Double);
+        for (let i = 0; i < 8; i++)
+            DOUBLE_BYTES[i] = this._body[at + i];
+        return DOUBLE_VIEW.getFloat64(0, true);
+    }
+    getDecimal(column) {
+        const at = this._offset(column, G9ESyncColumnType.Decimal);
+        const flags = readInt32LE(this._body, at + 12);
+        // decimal.GetBits: bits 0-15 and 24-30 of the flags are zero and the scale is at most 28.
+        if ((flags & 0x7f00ffff) !== 0 || ((flags >> 16) & 0xff) > 28)
+            throw new G9RowBatchFormatError('Invalid decimal value.');
+        return {
+            lo: readInt32LE(this._body, at) >>> 0,
+            mid: readInt32LE(this._body, at + 4) >>> 0,
+            hi: readInt32LE(this._body, at + 8) >>> 0,
+            scale: (flags >> 16) & 0xff,
+            negative: flags < 0,
+        };
+    }
+    getString(column) {
+        return utf8Decode(this.getUtf8(column));
+    }
+    getUtf8(column) {
+        return this._lengthPrefixed(this._offset(column, G9ESyncColumnType.String));
+    }
+    /** A GUID in canonical text form. */
+    getGuid(column) {
+        return readGuidBytes(this._body, this._offset(column, G9ESyncColumnType.Guid));
+    }
+    getDateTime(column) {
+        const at = this._offset(column, G9ESyncColumnType.DateTime);
+        const ticks = G9Long.readLE(this._body, at);
+        const kind = this._body[at + 8];
+        if (ticks.compare(G9Long.ZERO) < 0 || ticks.compare(MAX_TICKS) > 0 || kind > 2)
+            throw new G9RowBatchFormatError('Invalid DateTime value.');
+        return { ticks, kind };
+    }
+    getDateTimeOffset(column) {
+        const at = this._offset(column, G9ESyncColumnType.DateTimeOffset);
+        const utcTicks = G9Long.readLE(this._body, at);
+        const raw = this._body[at + 8] | (this._body[at + 9] << 8);
+        const minutes = raw >= 0x8000 ? raw - 0x10000 : raw;
+        const local = utcTicks.add(G9Long.fromNumber(minutes * 600000000));
+        if (minutes < -840 ||
+            minutes > 840 ||
+            utcTicks.compare(G9Long.ZERO) < 0 ||
+            utcTicks.compare(MAX_TICKS) > 0 ||
+            local.compare(G9Long.ZERO) < 0 ||
+            local.compare(MAX_TICKS) > 0) {
+            throw new G9RowBatchFormatError('Invalid DateTimeOffset value.');
+        }
+        return { utcTicks, offsetMinutes: minutes };
+    }
+    /** A TimeSpan as ticks, exact. */
+    getTimeSpan(column) {
+        return readZigZagLong(this._body, { pos: this._offset(column, G9ESyncColumnType.TimeSpan) });
+    }
+    /** The bytes of a Bytes column (a view into the body; copy it to keep it). */
+    getBytes(column) {
+        return this._lengthPrefixed(this._offset(column, G9ESyncColumnType.Bytes));
+    }
+    // ---------------------------------------------------------------- internals
+    _readValues() {
+        const body = this._body;
+        const cursor = this._cursor;
+        const count = this._types.length;
+        const bitmapBytes = (count + 7) >> 3;
+        this._ensure(bitmapBytes);
+        const bitmap = cursor.pos;
+        cursor.pos += bitmapBytes;
+        this.hasValues = true;
+        const offsets = this._offsets;
+        for (let column = 0; column < count; column++) {
+            if ((body[bitmap + (column >> 3)] & (1 << (column & 7))) !== 0) {
+                offsets[column] = -1;
+                continue;
+            }
+            offsets[column] = cursor.pos;
+            switch (this._types[column]) {
+                case G9ESyncColumnType.Boolean:
+                    this._ensure(1);
+                    cursor.pos += 1;
+                    break;
+                case G9ESyncColumnType.Int32:
+                case G9ESyncColumnType.Int64:
+                case G9ESyncColumnType.TimeSpan:
+                    readVarintLong(body, cursor);
+                    break;
+                case G9ESyncColumnType.Double:
+                    this._ensure(8);
+                    cursor.pos += 8;
+                    break;
+                case G9ESyncColumnType.Decimal:
+                case G9ESyncColumnType.Guid:
+                    this._ensure(16);
+                    cursor.pos += 16;
+                    break;
+                case G9ESyncColumnType.DateTime:
+                    this._ensure(9);
+                    cursor.pos += 9;
+                    break;
+                case G9ESyncColumnType.DateTimeOffset:
+                    this._ensure(10);
+                    cursor.pos += 10;
+                    break;
+                case G9ESyncColumnType.String:
+                case G9ESyncColumnType.Bytes: {
+                    const length = readVarintInt32(body, cursor);
+                    this._ensure(length);
+                    cursor.pos += length;
+                    break;
+                }
+                default:
+                    throw new G9RowBatchFormatError(`Unknown column type ${this._types[column]}.`);
+            }
+        }
+    }
+    _offset(column, expected) {
+        this._ensureValues(column);
+        if (this._types[column] !== expected)
+            throw new Error(`Column ${column} is ${this._types[column]}, not ${expected}.`);
+        const offset = this._offsets[column];
+        if (offset < 0)
+            throw new Error(`Column ${column} is NULL.`);
+        return offset;
+    }
+    _ensureValues(column) {
+        if (!this.hasValues)
+            throw new Error('The current row carries no column values.');
+        if (!(column >= 0 && column < this._types.length))
+            throw new RangeError(`Column ${column} is out of range.`);
+    }
+    _lengthPrefixed(position) {
+        const cursor = { pos: position };
+        const length = readVarintInt32(this._body, cursor);
+        return this._body.subarray(cursor.pos, cursor.pos + length);
+    }
+    _readByte() {
+        this._ensure(1);
+        return this._body[this._cursor.pos++];
+    }
+    _ensure(count) {
+        if (count < 0 || this._cursor.pos + count > this._body.length)
+            throw new G9RowBatchFormatError('Row batch is truncated.');
+    }
+}
+/** DateTime.MaxValue.Ticks. */
+const MAX_TICKS = G9Long.parse('3155378975999999999');
+const DOUBLE_BUFFER = new ArrayBuffer(8);
+const DOUBLE_VIEW = new DataView(DOUBLE_BUFFER);
+const DOUBLE_BYTES = new Uint8Array(DOUBLE_BUFFER);
+//# sourceMappingURL=reader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/protocol/rowBatch/reader.ts"],"names":[],"mappings":"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","sourcesContent":["// Twin of G9SyncData.Protocol/RowBatch/G9CRowBatchReader.cs: reads a G9RowBatch frame in either body layout. Forward\n// only; values are decoded from the body on demand.\nimport { G9ESyncColumnType } from '../../abstractions/enums.js';\nimport { readGuidBytes } from '../../abstractions/guid.js';\nimport { G9SyncKey } from '../../abstractions/key.js';\nimport { G9Long } from '../../abstractions/long.js';\nimport type { DecimalParts } from '../../internal/dotnetFormat.js';\nimport { utf8Decode } from '../../internal/utf8.js';\nimport { toRows } from './columnLayout.js';\nimport {\n  type Cursor,\n  G9ECompression,\n  G9EPushRowOp,\n  G9ERowBatchOp,\n  G9RowBatchFormat,\n  G9RowBatchFormatError,\n  isRowBatchOp,\n  readInt32LE,\n  readVarint,\n  readVarintInt32,\n  readVarintLong,\n  readZigZagLong,\n  readZigZagNumber,\n} from './format.js';\nimport type { G9DateTimeOffsetValue, G9DateTimeValue } from './writer.js';\n\n/**\n * Decompresses a Brotli frame body. Returns exactly `expectedLength` bytes or throws. Node: `nodeBrotliDecompressor()`\n * (`@g9tm/syncdata/node`); Lynx: the native module of `@g9tm/syncdata-lynx`; anywhere: `jsBrotliDecompressor()`\n * (`@g9tm/syncdata/brotli-js`, pure JavaScript, slower).\n */\nexport interface G9FrameDecompressor {\n  decompress(compressed: Uint8Array, expectedLength: number): Uint8Array | Promise<Uint8Array>;\n}\n\n/** The header of a frame, read without decoding the body. */\nexport interface G9FrameHeader {\n  version: number;\n  compression: number;\n  bodyLength: number;\n}\n\n/** Validates a frame's header (magic, version, compression, body length, budget). */\nexport function readFrameHeader(frame: Uint8Array, maxBodyBytes: number = G9RowBatchFormat.MaxDecodedBytes): G9FrameHeader {\n  if (!(maxBodyBytes > 0)) throw new RangeError('maxBodyBytes must be positive.');\n  if (frame.length < G9RowBatchFormat.HeaderSize || frame[0] !== 0x47 || frame[1] !== 0x39 || frame[2] !== 0x52 || frame[3] !== 0x42) {\n    throw new G9RowBatchFormatError('Not a G9RowBatch frame.');\n  }\n  const version = frame[4] as number;\n  if (version !== G9RowBatchFormat.Version && version !== G9RowBatchFormat.ColumnVersion) {\n    throw new G9RowBatchFormatError(`Unsupported G9RowBatch version ${version}.`);\n  }\n  const compression = frame[5] as number;\n  const bodyLength = readInt32LE(frame, 6);\n  if (bodyLength < 4 || bodyLength > G9RowBatchFormat.MaxDecodedBytes) throw new G9RowBatchFormatError('Invalid body length.');\n  if (bodyLength > maxBodyBytes) {\n    throw new G9RowBatchFormatError(`The frame declares a ${bodyLength}-byte body; this reader accepts at most ${maxBodyBytes} bytes.`);\n  }\n  if (compression !== G9ECompression.None && compression !== G9ECompression.Brotli) {\n    throw new G9RowBatchFormatError(`Unknown compression ${compression}.`);\n  }\n  if (compression === G9ECompression.None && frame.length - G9RowBatchFormat.HeaderSize !== bodyLength) {\n    throw new G9RowBatchFormatError('Body length mismatch.');\n  }\n  return { version, compression, bodyLength };\n}\n\nlet defaultDecompressor: G9FrameDecompressor | null = null;\n\n/**\n * Sets the Brotli decoder used wherever none is passed explicitly (the store, the engine's reconciliation). Call it\n * once at start-up: `useNodeBrotli()` (`@g9tm/syncdata/node`), `useLynxBrotli()` (`@g9tm/syncdata-lynx`) or\n * `setDefaultFrameDecompressor(jsBrotliDecompressor())` (`@g9tm/syncdata/brotli-js`).\n */\nexport function setDefaultFrameDecompressor(decompressor: G9FrameDecompressor | null): void {\n  defaultDecompressor = decompressor;\n}\n\n/** The decoder set with {@link setDefaultFrameDecompressor}, or null. */\nexport function getDefaultFrameDecompressor(): G9FrameDecompressor | null {\n  return defaultDecompressor;\n}\n\n/** Options of {@link openRowBatch}. */\nexport interface G9OpenRowBatchOptions {\n  /** Brotli decoder for compressed frames (every frame the server sends over 128 bytes); the default decoder when omitted. */\n  decompressor?: G9FrameDecompressor | null;\n  /** The largest decoded body this caller allocates for (ADR-0051). */\n  maxBodyBytes?: number;\n}\n\n/**\n * Validates, decompresses when needed, and opens a frame. Async because a Lynx decompressor crosses the native bridge;\n * an uncompressed frame resolves without waiting on anything.\n */\nexport async function openRowBatch(frame: Uint8Array, options?: G9OpenRowBatchOptions): Promise<G9RowBatchReader> {\n  const header = readFrameHeader(frame, options?.maxBodyBytes);\n  if (header.compression === G9ECompression.None) return G9RowBatchReader.fromBody(frame.subarray(G9RowBatchFormat.HeaderSize), header.version);\n  const decompressor = options?.decompressor ?? defaultDecompressor;\n  if (!decompressor) {\n    throw new G9RowBatchFormatError('The frame is Brotli-compressed and no decompressor is configured (see G9FrameDecompressor).');\n  }\n  let body: Uint8Array;\n  try {\n    body = await decompressor.decompress(frame.subarray(G9RowBatchFormat.HeaderSize), header.bodyLength);\n  } catch (error) {\n    throw new G9RowBatchFormatError(`Brotli body could not be decompressed: ${error instanceof Error ? error.message : String(error)}`);\n  }\n  if (!body || body.length !== header.bodyLength) throw new G9RowBatchFormatError('Brotli body could not be decompressed.');\n  return G9RowBatchReader.fromBody(body, header.version);\n}\n\n/** Opens an uncompressed frame synchronously (throws for a compressed one). */\nexport function openRowBatchSync(frame: Uint8Array, maxBodyBytes?: number): G9RowBatchReader {\n  const header = readFrameHeader(frame, maxBodyBytes);\n  if (header.compression !== G9ECompression.None) throw new G9RowBatchFormatError('The frame is compressed; use openRowBatch.');\n  return G9RowBatchReader.fromBody(frame.subarray(G9RowBatchFormat.HeaderSize), header.version);\n}\n\n/** Reads the sections and rows of one G9RowBatch body. */\nexport class G9RowBatchReader {\n  private readonly _body: Uint8Array;\n  private readonly _cursor: Cursor = { pos: 4 };\n  private _sectionsRemaining: number;\n  private _sectionOpen = false;\n  private _rowsRemaining = 0;\n  private _types: number[] = [];\n  private _offsets: number[] = [];\n  private _keyStart = 0;\n  private _keyLength = 0;\n  private _keyText: string | null = null;\n  private _versionPos = -1;\n  private _sequencePos = -1;\n  private _baseVersionPos = -1;\n  private _hlcPos = -1;\n\n  readonly sectionCount: number;\n\n  // section\n  op = 0;\n  tableId = 0;\n  keyType = 0;\n  rowCount = 0;\n\n  // row\n  version = 0;\n  pushOp = 0;\n  sequence = 0;\n  baseVersion = 0;\n  dirtyMask: G9Long = G9Long.ZERO;\n  hlcMs = 0;\n  rowHash: G9Long = G9Long.ZERO;\n  hasValues = false;\n\n  private constructor(body: Uint8Array) {\n    if (body.length < 4) throw new G9RowBatchFormatError('Row batch body is too short.');\n    this._body = body;\n    this.sectionCount = readInt32LE(body, 0);\n    if (this.sectionCount < 0) throw new G9RowBatchFormatError('Negative section count.');\n    this._sectionsRemaining = this.sectionCount;\n  }\n\n  /** Opens an already decompressed body of the given layout version. */\n  static fromBody(body: Uint8Array, version: number): G9RowBatchReader {\n    return new G9RowBatchReader(version === G9RowBatchFormat.ColumnVersion ? toRows(body) : body);\n  }\n\n  /** The decoded size of this frame's body (row-wise layout). */\n  get bodyBytes(): number {\n    return this._body.length;\n  }\n\n  get columnTypes(): readonly number[] {\n    return this._types;\n  }\n\n  get columnCount(): number {\n    return this._types.length;\n  }\n\n  /** Moves to the next section, skipping unread rows of the current one. */\n  nextSection(): boolean {\n    if (this._sectionOpen) {\n      while (this.readRow()) {\n        // skip\n      }\n    }\n    if (this._sectionsRemaining === 0) {\n      this._sectionOpen = false;\n      return false;\n    }\n    const body = this._body;\n    const cursor = this._cursor;\n    this.op = this._readByte();\n    if (!isRowBatchOp(this.op)) throw new G9RowBatchFormatError(`Unknown op ${this.op}.`);\n    this.tableId = readVarintInt32(body, cursor);\n    this.keyType = this._readByte();\n    if (!G9SyncKey.isSupportedKeyType(this.keyType)) throw new G9RowBatchFormatError(`Unsupported key type ${this.keyType}.`);\n    const columnCount = readVarintInt32(body, cursor);\n    if (columnCount > 1024) throw new G9RowBatchFormatError('Too many columns.');\n    this._ensure(columnCount + 4);\n    const types: number[] = [];\n    for (let i = 0; i < columnCount; i++) types.push(body[cursor.pos++] as number);\n    this._types = types;\n    this.rowCount = readInt32LE(body, cursor.pos);\n    cursor.pos += 4;\n    if (this.rowCount < 0) throw new G9RowBatchFormatError('Negative row count.');\n    if (this._offsets.length < columnCount) this._offsets = new Array<number>(columnCount);\n    this._rowsRemaining = this.rowCount;\n    this._sectionsRemaining--;\n    this._sectionOpen = true;\n    return true;\n  }\n\n  /** Moves to the next row of the current section. */\n  readRow(): boolean {\n    if (!this._sectionOpen || this._rowsRemaining === 0) return false;\n    const body = this._body;\n    const cursor = this._cursor;\n    this._keyText = null;\n    this.hasValues = false;\n    this.version = 0;\n    this.rowHash = G9Long.ZERO;\n\n    switch (this.keyType) {\n      case G9ESyncColumnType.Guid:\n        this._ensure(16);\n        this._keyStart = cursor.pos;\n        this._keyLength = 16;\n        cursor.pos += 16;\n        break;\n      case G9ESyncColumnType.Int32:\n      case G9ESyncColumnType.Int64:\n        this._keyStart = cursor.pos;\n        readVarintLong(body, cursor);\n        this._keyLength = cursor.pos - this._keyStart;\n        break;\n      default: {\n        const length = readVarintInt32(body, cursor);\n        this._ensure(length);\n        this._keyStart = cursor.pos;\n        this._keyLength = length;\n        cursor.pos += length;\n        break;\n      }\n    }\n\n    switch (this.op) {\n      case G9ERowBatchOp.Upsert:\n      case G9ERowBatchOp.Backfill:\n        this._versionPos = cursor.pos;\n        this.version = readVarint(body, cursor);\n        this._readValues();\n        break;\n      case G9ERowBatchOp.Tombstone:\n      case G9ERowBatchOp.MoveOut:\n        this._versionPos = cursor.pos;\n        this.version = readVarint(body, cursor);\n        break;\n      case G9ERowBatchOp.KeyVersions:\n        this._versionPos = cursor.pos;\n        this.version = readVarint(body, cursor);\n        this._ensure(8);\n        this.rowHash = G9Long.readLE(body, cursor.pos);\n        cursor.pos += 8;\n        break;\n      case G9ERowBatchOp.Push:\n        this.pushOp = this._readByte();\n        if (this.pushOp !== G9EPushRowOp.Upsert && this.pushOp !== G9EPushRowOp.Delete) throw new G9RowBatchFormatError(`Unknown push op ${this.pushOp}.`);\n        this._versionPos = -1;\n        this._sequencePos = cursor.pos;\n        this.sequence = readVarint(body, cursor);\n        this._baseVersionPos = cursor.pos;\n        this.baseVersion = readVarint(body, cursor);\n        this._ensure(8);\n        this.dirtyMask = G9Long.readLE(body, cursor.pos);\n        cursor.pos += 8;\n        this._hlcPos = cursor.pos;\n        this.hlcMs = readZigZagNumber(body, cursor);\n        if (this.pushOp === G9EPushRowOp.Upsert) this._readValues();\n        break;\n    }\n    this._rowsRemaining--;\n    return true;\n  }\n\n  /** The row's version, exact (the {@link version} number is exact below 2^53). */\n  get versionLong(): G9Long {\n    return this._versionPos < 0 ? G9Long.ZERO : readVarintLong(this._body, { pos: this._versionPos });\n  }\n\n  /** A push row's local sequence, exact. */\n  get sequenceLong(): G9Long {\n    return readVarintLong(this._body, { pos: this._sequencePos });\n  }\n\n  /** A push row's base version, exact. */\n  get baseVersionLong(): G9Long {\n    return readVarintLong(this._body, { pos: this._baseVersionPos });\n  }\n\n  /** A push row's HLC milliseconds, exact. */\n  get hlcLong(): G9Long {\n    return readZigZagLong(this._body, { pos: this._hlcPos });\n  }\n\n  // ---------------------------------------------------------------- key\n\n  /** Canonical key text (see G9SyncKey). */\n  get key(): string {\n    if (this._keyText === null) {\n      switch (this.keyType) {\n        case G9ESyncColumnType.Guid:\n          this._keyText = readGuidBytes(this._body, this._keyStart);\n          break;\n        case G9ESyncColumnType.Int32:\n        case G9ESyncColumnType.Int64:\n          this._keyText = this.keyInt64.toString();\n          break;\n        default:\n          this._keyText = utf8Decode(this._body.subarray(this._keyStart, this._keyStart + this._keyLength));\n          break;\n      }\n    }\n    return this._keyText;\n  }\n\n  /** The integer key. */\n  get keyInt64(): G9Long {\n    if (this.keyType !== G9ESyncColumnType.Int32 && this.keyType !== G9ESyncColumnType.Int64) throw new Error(`Key type is ${this.keyType}.`);\n    return readZigZagLong(this._body, { pos: this._keyStart });\n  }\n\n  /** UTF-8 bytes of a string key. */\n  get keyUtf8(): Uint8Array {\n    if (this.keyType !== G9ESyncColumnType.String) throw new Error(`Key type is ${this.keyType}.`);\n    return this._body.subarray(this._keyStart, this._keyStart + this._keyLength);\n  }\n\n  // ---------------------------------------------------------------- values\n\n  isNull(column: number): boolean {\n    this._ensureValues(column);\n    return (this._offsets[column] as number) < 0;\n  }\n\n  getBoolean(column: number): boolean {\n    return this._body[this._offset(column, G9ESyncColumnType.Boolean)] !== 0;\n  }\n\n  getInt32(column: number): number {\n    const value = readZigZagNumber(this._body, { pos: this._offset(column, G9ESyncColumnType.Int32) });\n    if (value < -2147483648 || value > 2147483647) throw new G9RowBatchFormatError('Int32 value is out of range.');\n    return value;\n  }\n\n  /** An Int64 value, exact. */\n  getInt64(column: number): G9Long {\n    return readZigZagLong(this._body, { pos: this._offset(column, G9ESyncColumnType.Int64) });\n  }\n\n  getDouble(column: number): number {\n    const at = this._offset(column, G9ESyncColumnType.Double);\n    for (let i = 0; i < 8; i++) DOUBLE_BYTES[i] = this._body[at + i] as number;\n    return DOUBLE_VIEW.getFloat64(0, true);\n  }\n\n  getDecimal(column: number): DecimalParts {\n    const at = this._offset(column, G9ESyncColumnType.Decimal);\n    const flags = readInt32LE(this._body, at + 12);\n    // decimal.GetBits: bits 0-15 and 24-30 of the flags are zero and the scale is at most 28.\n    if ((flags & 0x7f00ffff) !== 0 || ((flags >> 16) & 0xff) > 28) throw new G9RowBatchFormatError('Invalid decimal value.');\n    return {\n      lo: readInt32LE(this._body, at) >>> 0,\n      mid: readInt32LE(this._body, at + 4) >>> 0,\n      hi: readInt32LE(this._body, at + 8) >>> 0,\n      scale: (flags >> 16) & 0xff,\n      negative: flags < 0,\n    };\n  }\n\n  getString(column: number): string {\n    return utf8Decode(this.getUtf8(column));\n  }\n\n  getUtf8(column: number): Uint8Array {\n    return this._lengthPrefixed(this._offset(column, G9ESyncColumnType.String));\n  }\n\n  /** A GUID in canonical text form. */\n  getGuid(column: number): string {\n    return readGuidBytes(this._body, this._offset(column, G9ESyncColumnType.Guid));\n  }\n\n  getDateTime(column: number): G9DateTimeValue {\n    const at = this._offset(column, G9ESyncColumnType.DateTime);\n    const ticks = G9Long.readLE(this._body, at);\n    const kind = this._body[at + 8] as number;\n    if (ticks.compare(G9Long.ZERO) < 0 || ticks.compare(MAX_TICKS) > 0 || kind > 2) throw new G9RowBatchFormatError('Invalid DateTime value.');\n    return { ticks, kind };\n  }\n\n  getDateTimeOffset(column: number): G9DateTimeOffsetValue {\n    const at = this._offset(column, G9ESyncColumnType.DateTimeOffset);\n    const utcTicks = G9Long.readLE(this._body, at);\n    const raw = (this._body[at + 8] as number) | ((this._body[at + 9] as number) << 8);\n    const minutes = raw >= 0x8000 ? raw - 0x10000 : raw;\n    const local = utcTicks.add(G9Long.fromNumber(minutes * 600000000));\n    if (\n      minutes < -840 ||\n      minutes > 840 ||\n      utcTicks.compare(G9Long.ZERO) < 0 ||\n      utcTicks.compare(MAX_TICKS) > 0 ||\n      local.compare(G9Long.ZERO) < 0 ||\n      local.compare(MAX_TICKS) > 0\n    ) {\n      throw new G9RowBatchFormatError('Invalid DateTimeOffset value.');\n    }\n    return { utcTicks, offsetMinutes: minutes };\n  }\n\n  /** A TimeSpan as ticks, exact. */\n  getTimeSpan(column: number): G9Long {\n    return readZigZagLong(this._body, { pos: this._offset(column, G9ESyncColumnType.TimeSpan) });\n  }\n\n  /** The bytes of a Bytes column (a view into the body; copy it to keep it). */\n  getBytes(column: number): Uint8Array {\n    return this._lengthPrefixed(this._offset(column, G9ESyncColumnType.Bytes));\n  }\n\n  // ---------------------------------------------------------------- internals\n\n  private _readValues(): void {\n    const body = this._body;\n    const cursor = this._cursor;\n    const count = this._types.length;\n    const bitmapBytes = (count + 7) >> 3;\n    this._ensure(bitmapBytes);\n    const bitmap = cursor.pos;\n    cursor.pos += bitmapBytes;\n    this.hasValues = true;\n    const offsets = this._offsets;\n    for (let column = 0; column < count; column++) {\n      if (((body[bitmap + (column >> 3)] as number) & (1 << (column & 7))) !== 0) {\n        offsets[column] = -1;\n        continue;\n      }\n      offsets[column] = cursor.pos;\n      switch (this._types[column]) {\n        case G9ESyncColumnType.Boolean:\n          this._ensure(1);\n          cursor.pos += 1;\n          break;\n        case G9ESyncColumnType.Int32:\n        case G9ESyncColumnType.Int64:\n        case G9ESyncColumnType.TimeSpan:\n          readVarintLong(body, cursor);\n          break;\n        case G9ESyncColumnType.Double:\n          this._ensure(8);\n          cursor.pos += 8;\n          break;\n        case G9ESyncColumnType.Decimal:\n        case G9ESyncColumnType.Guid:\n          this._ensure(16);\n          cursor.pos += 16;\n          break;\n        case G9ESyncColumnType.DateTime:\n          this._ensure(9);\n          cursor.pos += 9;\n          break;\n        case G9ESyncColumnType.DateTimeOffset:\n          this._ensure(10);\n          cursor.pos += 10;\n          break;\n        case G9ESyncColumnType.String:\n        case G9ESyncColumnType.Bytes: {\n          const length = readVarintInt32(body, cursor);\n          this._ensure(length);\n          cursor.pos += length;\n          break;\n        }\n        default:\n          throw new G9RowBatchFormatError(`Unknown column type ${this._types[column]}.`);\n      }\n    }\n  }\n\n  private _offset(column: number, expected: number): number {\n    this._ensureValues(column);\n    if (this._types[column] !== expected) throw new Error(`Column ${column} is ${this._types[column]}, not ${expected}.`);\n    const offset = this._offsets[column] as number;\n    if (offset < 0) throw new Error(`Column ${column} is NULL.`);\n    return offset;\n  }\n\n  private _ensureValues(column: number): void {\n    if (!this.hasValues) throw new Error('The current row carries no column values.');\n    if (!(column >= 0 && column < this._types.length)) throw new RangeError(`Column ${column} is out of range.`);\n  }\n\n  private _lengthPrefixed(position: number): Uint8Array {\n    const cursor = { pos: position };\n    const length = readVarintInt32(this._body, cursor);\n    return this._body.subarray(cursor.pos, cursor.pos + length);\n  }\n\n  private _readByte(): number {\n    this._ensure(1);\n    return this._body[this._cursor.pos++] as number;\n  }\n\n  private _ensure(count: number): void {\n    if (count < 0 || this._cursor.pos + count > this._body.length) throw new G9RowBatchFormatError('Row batch is truncated.');\n  }\n}\n\n/** DateTime.MaxValue.Ticks. */\nconst MAX_TICKS = G9Long.parse('3155378975999999999');\n\nconst DOUBLE_BUFFER = new ArrayBuffer(8);\nconst DOUBLE_VIEW = new DataView(DOUBLE_BUFFER);\nconst DOUBLE_BYTES = new Uint8Array(DOUBLE_BUFFER);\n"]}