@elaraai/east 0.0.1-beta.0

package/dist/src/serialization/binary-utils.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+export declare class BufferWriter {
+    private buffer;
+    private view;
+    private offset;
+    constructor(initialCapacity?: number);
+    private ensureCapacity;
+    writeUint8(value: number): void;
+    writeUint16LE(value: number): void;
+    writeUint16BE(value: number): void;
+    writeBytes(bytes: Uint8Array): void;
+    writeVarint(value: number): void;
+    writeZigzag(value: bigint): void;
+    writeInt64Twiddled(value: bigint): void;
+    writeFloat64LE(value: number): void;
+    private static _floatBuffer;
+    private static _uintBuffer;
+    writeFloat64Twiddled(value: number): void;
+    writeStringUtf8Varint(str: string): void;
+    writeStringUtf8Null(str: string): void;
+    get size(): number;
+    get currentOffset(): number;
+    /**
+     * Extract the current buffer contents and reset for reuse.
+     * Used by streaming encoders to generate chunks.
+     */
+    pop(): Uint8Array;
+    toUint8Array(): Uint8Array;
+}
+export declare function readVarint(buffer: Uint8Array, offset: number): [number, number];
+export declare function readZigzag(buffer: Uint8Array, offset: number): [bigint, number];
+export declare function readInt64Twiddled(view: DataView, offset: number): [bigint, number];
+export declare function readFloat64LE(view: DataView, offset: number): number;
+export declare function readFloat64Twiddled(view: DataView, offset: number): number;
+export declare function readStringUtf8Varint(buffer: Uint8Array, offset: number): [string, number];
+export declare function readStringUtf8Null(buffer: Uint8Array, offset: number): [string, number];
+export declare function utf8EncodeInto(str: string, buffer: Uint8Array, offset: number): number;
+export declare function utf8Decode(buffer: Uint8Array, offset: number, length: number): string;
+/**
+ * StreamBufferReader - Helper for reading bytes from a Web Streams ReadableStream
+ * with lookahead support for parsing.
+ *
+ * Maintains an internal buffer of unconsumed bytes pulled from the underlying stream.
+ */
+export declare class StreamBufferReader {
+    private reader;
+    private buffer;
+    private bufferOffset;
+    private done;
+    private totalBytesConsumed;
+    private tempBuffer8;
+    private tempView8;
+    private floatUintBuffer;
+    private floatBuffer;
+    constructor(stream: ReadableStream<Uint8Array>);
+    /**
+     * Get the current position in the stream (total bytes read so far).
+     */
+    get position(): number;
+    /**
+     * Ensure we have at least `count` bytes available in the buffer.
+     * Pulls from underlying stream as needed.
+     */
+    private ensureBytes;
+    /**
+     * Peek at the next byte without consuming it.
+     * Returns null if stream is done.
+     * Optimized to avoid promises unless necessary.
+     */
+    peekByte(): Promise<number | null> | number | null;
+    private peekByteAsync;
+    /**
+     * Read and consume the next byte.
+     * Returns synchronously if data is buffered, otherwise returns a Promise.
+     * Throws if stream is done.
+     * Optimized to avoid promises unless necessary.
+     */
+    readByte(): number | Promise<number>;
+    private readByteAsync;
+    /**
+     * Read exactly `buffer.length` bytes into the provided buffer.
+     * Throws if not enough bytes available.
+     * Optimized to avoid promises unless necessary.
+     */
+    readBytes(buffer: Uint8Array): void | Promise<void>;
+    private readBytesAsync;
+    /**
+     * Read bytes until the terminator byte is found (exclusive).
+     * Returns the bytes read (not including terminator).
+     * The terminator byte is consumed.
+     * Optimized to avoid promises unless necessary.
+     */
+    readUntilByte(terminator: number): Uint8Array | Promise<Uint8Array>;
+    private readUntilByteAsync;
+    /**
+     * Release the underlying reader.
+     * Should be called when done reading to release resources.
+     */
+    release(): Promise<void>;
+    /**
+     * Read a twiddled big-endian int64 (Beast v1 format).
+     * Uses sign-bit flip for total ordering.
+     * Optimized to avoid promises unless necessary.
+     */
+    readInt64Twiddled(): bigint | Promise<bigint>;
+    private readInt64TwiddledAsync;
+    /**
+     * Read a twiddled big-endian float64 (Beast v1 format).
+     * Uses bit-twiddling for total ordering.
+     */
+    readFloat64Twiddled(): number | Promise<number>;
+    private readFloat64TwiddledAsync;
+    /**
+     * Read a null-terminated UTF-8 string (Beast v1 format).
+     * Decodes UTF-8 while searching for null terminator in single pass.
+     * Optimized to avoid promises unless necessary.
+     */
+    readStringUtf8Null(): string | Promise<string>;
+    private readStringUtf8NullAsync;
+    /**
+     * Read an unsigned varint (LEB128) - Beast v2 format.
+     * Returns a number (safe for lengths/tags up to 2^53-1).
+     * Optimized to avoid promises unless necessary.
+     */
+    readVarint(): number | Promise<number>;
+    private readVarintAsync;
+    /**
+     * Read a zigzag-encoded signed integer (varint) - Beast v2 format.
+     * Returns a bigint.
+     * Optimized to avoid promises unless necessary.
+     */
+    readZigzag(): bigint | Promise<bigint>;
+    private readZigzagAsync;
+    /**
+     * Read a little-endian float64 - Beast v2 format.
+     * Validates NaN values are canonical.
+     * Optimized to avoid promises unless necessary.
+     */
+    readFloat64LE(): number | Promise<number>;
+    private readFloat64LEAsync;
+    /**
+     * Read a varint-length-prefixed UTF-8 string - Beast v2 format.
+     */
+    readStringUtf8Varint(): string | Promise<string>;
+    private readStringUtf8VarintAsync;
+    private readStringUtf8SizedAsync;
+}
+//# sourceMappingURL=binary-utils.d.ts.map

package/dist/src/serialization/binary-utils.d.ts.map

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