@laserdata/laser-sdk 0.5.3 → 0.6.0

package/dist/stream/bson.js

@@ -0,0 +1,245 @@
+const DOUBLE = 0x01;
+const STRING = 0x02;
+const DOCUMENT = 0x03;
+const ARRAY = 0x04;
+const BINARY = 0x05;
+const BOOLEAN = 0x08;
+const NULL = 0x0a;
+const INT32 = 0x10;
+const INT64 = 0x12;
+const BINARY_OLD = 0x02;
+const MAX_DEPTH = 100;
+const I64_MIN = -(1n << 63n);
+const I64_MAX = (1n << 63n) - 1n;
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder("utf-8", { fatal: true });
+// Encodes the way the Rust and Python clients do through serde: every integer
+// is an Int64, every other number a Double, bytes a generic Binary.
+export function encodeBsonDocument(value) {
+    const entries = documentEntries(value);
+    if (entries === undefined)
+        throw new TypeError("a BSON body must be a document");
+    const out = [];
+    writeDocument(out, entries, 0);
+    return Uint8Array.from(out);
+}
+export function decodeBsonDocument(payload) {
+    const reader = new Reader(payload);
+    const document = reader.document(0, false);
+    if (reader.offset !== payload.length)
+        throw new RangeError("BSON payload has trailing bytes");
+    return document;
+}
+function documentEntries(value) {
+    if (value instanceof Map) {
+        const entries = [...value.entries()];
+        if (!entries.every(([key]) => typeof key === "string"))
+            throw new TypeError("BSON document keys must be strings");
+        return entries;
+    }
+    if (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        !ArrayBuffer.isView(value) &&
+        !(value instanceof Date)) {
+        return Object.entries(value).filter(([, nested]) => nested !== undefined);
+    }
+    return undefined;
+}
+function writeDocument(out, entries, depth) {
+    if (depth > MAX_DEPTH)
+        throw new TypeError("BSON value exceeds the maximum depth");
+    const start = out.length;
+    writeI32(out, 0);
+    for (const [key, value] of entries)
+        writeElement(out, key, value, depth);
+    out.push(0);
+    patchI32(out, start, out.length - start);
+}
+function writeElement(out, key, value, depth) {
+    const tag = out.length;
+    out.push(0);
+    writeCString(out, key);
+    out[tag] = writeValue(out, value, depth);
+}
+function writeValue(out, value, depth) {
+    if (value === null)
+        return NULL;
+    if (typeof value === "boolean") {
+        out.push(value ? 1 : 0);
+        return BOOLEAN;
+    }
+    if (typeof value === "number") {
+        if (Number.isSafeInteger(value)) {
+            writeI64(out, BigInt(value));
+            return INT64;
+        }
+        writeF64(out, value);
+        return DOUBLE;
+    }
+    if (typeof value === "bigint") {
+        if (value < I64_MIN || value > I64_MAX)
+            throw new RangeError("BSON integers must fit in signed 64 bits");
+        writeI64(out, value);
+        return INT64;
+    }
+    if (typeof value === "string") {
+        const bytes = textEncoder.encode(value);
+        writeI32(out, bytes.length + 1);
+        for (const byte of bytes)
+            out.push(byte);
+        out.push(0);
+        return STRING;
+    }
+    if (value instanceof Uint8Array) {
+        writeI32(out, value.length);
+        out.push(0);
+        for (const byte of value)
+            out.push(byte);
+        return BINARY;
+    }
+    if (Array.isArray(value)) {
+        writeDocument(out, value.map((item, index) => [String(index), item ?? null]), depth + 1);
+        return ARRAY;
+    }
+    const entries = documentEntries(value);
+    if (entries === undefined)
+        throw new TypeError(`${typeof value} has no BSON form`);
+    writeDocument(out, entries, depth + 1);
+    return DOCUMENT;
+}
+function writeCString(out, text) {
+    const bytes = textEncoder.encode(text);
+    if (bytes.includes(0))
+        throw new TypeError("BSON keys must not contain a NUL byte");
+    for (const byte of bytes)
+        out.push(byte);
+    out.push(0);
+}
+function writeI32(out, value) {
+    out.push(value & 0xff, (value >>> 8) & 0xff, (value >>> 16) & 0xff, (value >>> 24) & 0xff);
+}
+function patchI32(out, at, value) {
+    out[at] = value & 0xff;
+    out[at + 1] = (value >>> 8) & 0xff;
+    out[at + 2] = (value >>> 16) & 0xff;
+    out[at + 3] = (value >>> 24) & 0xff;
+}
+function writeI64(out, value) {
+    const view = new DataView(new ArrayBuffer(8));
+    view.setBigInt64(0, value, true);
+    for (let index = 0; index < 8; index += 1)
+        out.push(view.getUint8(index));
+}
+function writeF64(out, value) {
+    const view = new DataView(new ArrayBuffer(8));
+    view.setFloat64(0, value, true);
+    for (let index = 0; index < 8; index += 1)
+        out.push(view.getUint8(index));
+}
+class Reader {
+    bytes;
+    offset = 0;
+    view;
+    constructor(bytes) {
+        this.bytes = bytes;
+        this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    }
+    document(depth, array) {
+        if (depth > MAX_DEPTH)
+            throw new RangeError("BSON value exceeds the maximum depth");
+        const start = this.offset;
+        const length = this.i32();
+        const end = start + length;
+        if (length < 5 || end > this.bytes.length)
+            throw new RangeError("BSON document length is invalid");
+        const object = {};
+        const items = [];
+        while (this.offset < end - 1) {
+            const tag = this.u8();
+            const key = this.cstring();
+            const value = this.value(tag, depth);
+            if (array)
+                items.push(value);
+            else
+                object[key] = value;
+        }
+        if (this.offset !== end - 1 || this.u8() !== 0)
+            throw new RangeError("BSON document is not terminated");
+        return array ? items : object;
+    }
+    value(tag, depth) {
+        switch (tag) {
+            case DOUBLE:
+                return this.view.getFloat64(this.take(8), true);
+            case STRING: {
+                const length = this.i32();
+                if (length < 1)
+                    throw new RangeError("BSON string length is invalid");
+                const start = this.take(length);
+                if (this.bytes[start + length - 1] !== 0)
+                    throw new RangeError("BSON string is not terminated");
+                return textDecoder.decode(this.bytes.subarray(start, start + length - 1));
+            }
+            case DOCUMENT:
+                return this.document(depth + 1, false);
+            case ARRAY:
+                return this.document(depth + 1, true);
+            case BINARY: {
+                const length = this.i32();
+                if (length < 0)
+                    throw new RangeError("BSON binary length is invalid");
+                const subtype = this.u8();
+                if (subtype === BINARY_OLD) {
+                    const inner = this.i32();
+                    if (inner !== length - 4)
+                        throw new RangeError("BSON binary length is invalid");
+                    const start = this.take(inner);
+                    return this.bytes.slice(start, start + inner);
+                }
+                const start = this.take(length);
+                return this.bytes.slice(start, start + length);
+            }
+            case BOOLEAN: {
+                const byte = this.u8();
+                if (byte > 1)
+                    throw new RangeError("BSON boolean must be 0 or 1");
+                return byte === 1;
+            }
+            case NULL:
+                return null;
+            case INT32:
+                return this.view.getInt32(this.take(4), true);
+            case INT64: {
+                const value = this.view.getBigInt64(this.take(8), true);
+                return value >= BigInt(Number.MIN_SAFE_INTEGER) && value <= BigInt(Number.MAX_SAFE_INTEGER)
+                    ? Number(value)
+                    : value;
+            }
+            default:
+                throw new RangeError(`BSON element type 0x${tag.toString(16)} has no plain value form`);
+        }
+    }
+    cstring() {
+        const end = this.bytes.indexOf(0, this.offset);
+        if (end < 0)
+            throw new RangeError("BSON key is not terminated");
+        const text = textDecoder.decode(this.bytes.subarray(this.offset, end));
+        this.offset = end + 1;
+        return text;
+    }
+    i32() {
+        return this.view.getInt32(this.take(4), true);
+    }
+    u8() {
+        return this.view.getUint8(this.take(1));
+    }
+    take(length) {
+        const start = this.offset;
+        if (start + length > this.bytes.length)
+            throw new RangeError("BSON payload is truncated");
+        this.offset += length;
+        return start;
+    }
+}
+//# sourceMappingURL=bson.js.map

package/dist/stream/bson.js.map

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

package/dist/stream/codecs.d.ts

@@ -1,9 +1,61 @@
-export interface Codec<T> {
+import { ContentType } from "../wire/content.js";
+import type { KvEntry } from "../wire/kv.js";
+/** The decode half of a codec. */
+export interface Decoder<T> {
+    decode(payload: Uint8Array): T;
+}
+/**
+ * Encoding strategy for a typed body. `contentType` is the tag stamped on
+ * `agdx.ct` so consumers can decode downstream.
+ */
+export interface Codec<T> extends Decoder<T> {
+    readonly contentType: ContentType;
+    encode(value: T): Uint8Array;
+}
+/**
+ * The built-in JSON codec. `decodeValue` checks a decoded value and narrows it
+ * to `T`, and the codec passes the decoded value through without it.
+ */
+export declare class Json<T = unknown> implements Codec<T> {
+    private readonly decodeValue;
+    readonly contentType: ContentType;
+    constructor(decodeValue?: (value: unknown) => T);
+    encode(value: T): Uint8Array;
+    decode(payload: Uint8Array): T;
+}
+/** The built-in CBOR codec. `decodeValue` narrows a decoded value to `T`. */
+export declare class Cbor<T = unknown> implements Codec<T> {
+    private readonly decodeValue;
+    readonly contentType: ContentType;
+    constructor(decodeValue?: (value: unknown) => T);
+    encode(value: T): Uint8Array;
+    decode(payload: Uint8Array): T;
+}
+/**
+ * The built-in MessagePack codec, with named-map encoding so field names
+ * round-trip with JSON-shaped consumers. `decodeValue` narrows a decoded value
+ * to `T`.
+ */
+export declare class Msgpack<T = unknown> implements Codec<T> {
+    private readonly decodeValue;
+    readonly contentType: ContentType;
+    constructor(decodeValue?: (value: unknown) => T);
+    encode(value: T): Uint8Array;
+    decode(payload: Uint8Array): T;
+}
+/**
+ * The built-in BSON codec. The top-level body must be a document (an object or
+ * a string-keyed map). `decodeValue` narrows a decoded value to `T`.
+ */
+export declare class Bson<T = unknown> implements Codec<T> {
+    private readonly decodeValue;
+    readonly contentType: ContentType;
+    constructor(decodeValue?: (value: unknown) => T);
     encode(value: T): Uint8Array;
-    decode(bytes: Uint8Array): T;
+    decode(payload: Uint8Array): T;
 }
-export type ValueDecoder<T> = (value: unknown) => T;
-export declare function jsonCodec<T>(decodeValue: ValueDecoder<T>): Codec<T>;
-export declare function cborCodec<T>(decodeValue: ValueDecoder<T>): Codec<T>;
-export declare function messagePackCodec<T>(decodeValue: ValueDecoder<T>): Codec<T>;
+/** Decode a key-value entry's value as JSON, narrowed by `decodeValue` when given. */
+export declare function kvEntryDecodeValue<T = unknown>(entry: KvEntry, decodeValue?: (value: unknown) => T): T;
+/** Decode a key-value entry's value with any decoder. */
+export declare function kvEntryDecodeValueWith<T>(entry: KvEntry, decoder: Decoder<T>): T;
 //# sourceMappingURL=codecs.d.ts.map

package/dist/stream/codecs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../../src/stream/codecs.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;IAC5B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,CAAC,CAAA;CAC7B;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAA;AAkCnD,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAKnE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAanE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAsB1E"}
+{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../../src/stream/codecs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAG5C,kCAAkC;AAClC,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;CAC7B;AAED;;;GAGG;AACH,qBAAa,IAAI,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAGpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAFxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAmB;IAEpD,YAA6B,WAAW,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAyB,EAAI;IAE3F,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAS3B;IAED,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,CAQ7B;CACF;AAED,6EAA6E;AAC7E,qBAAa,IAAI,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAGpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAFxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAmB;IAEpD,YAA6B,WAAW,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAyB,EAAI;IAE3F,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAM3B;IAED,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,CAE7B;CACF;AAED;;;;GAIG;AACH,qBAAa,OAAO,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAGvC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAFxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAsB;IAEvD,YAA6B,WAAW,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAyB,EAAI;IAE3F,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAQ3B;IAED,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,CAU7B;CACF;AAED;;;GAGG;AACH,qBAAa,IAAI,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAGpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAFxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAmB;IAEpD,YAA6B,WAAW,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAyB,EAAI;IAE3F,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAM3B;IAED,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,CAQ7B;CACF;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAC5C,KAAK,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAClC,CAAC,CAEH;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAEhF"}

package/dist/stream/codecs.js

@@ -1,26 +1,130 @@
 import { decode as decodeMessagePack, encode as encodeMessagePack } from "@msgpack/msgpack";
 import { CodecError } from "../client/errors.js";
 import { decodeOne, encodeOne } from "../wire/cbor.js";
-function encodeJson(value) {
-    try {
-        if (value === undefined || typeof value === "function" || typeof value === "symbol") {
-            throw new TypeError("value has no JSON representation");
+import { ContentType } from "../wire/content.js";
+import { decodeBsonDocument, encodeBsonDocument } from "./bson.js";
+/**
+ * The built-in JSON codec. `decodeValue` checks a decoded value and narrows it
+ * to `T`, and the codec passes the decoded value through without it.
+ */
+export class Json {
+    decodeValue;
+    contentType = ContentType.Json;
+    constructor(decodeValue = (value) => value) {
+        this.decodeValue = decodeValue;
+    }
+    encode(value) {
+        try {
+            if (value === undefined || typeof value === "function" || typeof value === "symbol") {
+                throw new TypeError("value has no JSON representation");
+            }
+            return new TextEncoder().encode(JSON.stringify(value));
+        }
+        catch (cause) {
+            throw new CodecError("value does not encode as JSON", "json", "encode", { cause });
+        }
+    }
+    decode(payload) {
+        let value;
+        try {
+            value = JSON.parse(new TextDecoder().decode(payload));
+        }
+        catch (cause) {
+            throw new CodecError("payload does not decode as JSON", "json", "decode", { cause });
+        }
+        return this.decodeValue(value);
+    }
+}
+/** The built-in CBOR codec. `decodeValue` narrows a decoded value to `T`. */
+export class Cbor {
+    decodeValue;
+    contentType = ContentType.Cbor;
+    constructor(decodeValue = (value) => value) {
+        this.decodeValue = decodeValue;
+    }
+    encode(value) {
+        try {
+            return encodeOne(value);
+        }
+        catch (cause) {
+            throw new CodecError("value does not encode as CBOR", "cbor", "encode", { cause });
         }
-        const json = JSON.stringify(value);
-        return new TextEncoder().encode(json);
     }
-    catch (cause) {
-        throw new CodecError("value does not encode as JSON", "json", "encode", { cause });
+    decode(payload) {
+        return this.decodeValue(lowerCborValue(decodeOne(payload, "typed CBOR payload")));
     }
 }
-function decodeJson(bytes) {
-    try {
-        return JSON.parse(new TextDecoder().decode(bytes));
+/**
+ * The built-in MessagePack codec, with named-map encoding so field names
+ * round-trip with JSON-shaped consumers. `decodeValue` narrows a decoded value
+ * to `T`.
+ */
+export class Msgpack {
+    decodeValue;
+    contentType = ContentType.Msgpack;
+    constructor(decodeValue = (value) => value) {
+        this.decodeValue = decodeValue;
     }
-    catch (cause) {
-        throw new CodecError("payload does not decode as JSON", "json", "decode", { cause });
+    encode(value) {
+        try {
+            return encodeMessagePack(messagePackValue(value), { useBigInt64: true });
+        }
+        catch (cause) {
+            throw new CodecError("value does not encode as MessagePack", "msgpack", "encode", {
+                cause
+            });
+        }
+    }
+    decode(payload) {
+        let value;
+        try {
+            value = decodeMessagePack(payload, { useBigInt64: true });
+        }
+        catch (cause) {
+            throw new CodecError("payload does not decode as MessagePack", "msgpack", "decode", {
+                cause
+            });
+        }
+        return this.decodeValue(value);
     }
 }
+/**
+ * The built-in BSON codec. The top-level body must be a document (an object or
+ * a string-keyed map). `decodeValue` narrows a decoded value to `T`.
+ */
+export class Bson {
+    decodeValue;
+    contentType = ContentType.Bson;
+    constructor(decodeValue = (value) => value) {
+        this.decodeValue = decodeValue;
+    }
+    encode(value) {
+        try {
+            return encodeBsonDocument(value);
+        }
+        catch (cause) {
+            throw new CodecError("value does not encode as BSON", "bson", "encode", { cause });
+        }
+    }
+    decode(payload) {
+        let value;
+        try {
+            value = decodeBsonDocument(payload);
+        }
+        catch (cause) {
+            throw new CodecError("payload does not decode as BSON", "bson", "decode", { cause });
+        }
+        return this.decodeValue(value);
+    }
+}
+/** Decode a key-value entry's value as JSON, narrowed by `decodeValue` when given. */
+export function kvEntryDecodeValue(entry, decodeValue) {
+    return new Json(decodeValue).decode(entry.value);
+}
+/** Decode a key-value entry's value with any decoder. */
+export function kvEntryDecodeValueWith(entry, decoder) {
+    return decoder.decode(entry.value);
+}
 function lowerCborValue(value) {
     if (Array.isArray(value))
         return value.map(lowerCborValue);
@@ -33,51 +137,31 @@ function lowerCborValue(value) {
     }
     return value;
 }
-export function jsonCodec(decodeValue) {
-    return {
-        encode: encodeJson,
-        decode: (bytes) => decodeValue(decodeJson(bytes))
-    };
-}
-export function cborCodec(decodeValue) {
-    return {
-        encode(value) {
-            try {
-                return encodeOne(value);
-            }
-            catch (cause) {
-                throw new CodecError("value does not encode as CBOR", "cbor", "encode", { cause });
-            }
-        },
-        decode(bytes) {
-            return decodeValue(lowerCborValue(decodeOne(bytes, "typed CBOR payload")));
-        }
-    };
-}
-export function messagePackCodec(decodeValue) {
-    return {
-        encode(value) {
-            try {
-                return encodeMessagePack(value, { useBigInt64: true });
-            }
-            catch (cause) {
-                throw new CodecError("value does not encode as MessagePack", "msgpack", "encode", {
-                    cause
-                });
-            }
-        },
-        decode(bytes) {
-            try {
-                return decodeValue(decodeMessagePack(bytes, { useBigInt64: true }));
-            }
-            catch (cause) {
-                if (cause instanceof CodecError)
-                    throw cause;
-                throw new CodecError("payload does not decode as MessagePack", "msgpack", "decode", {
-                    cause
-                });
-            }
-        }
-    };
+function messagePackValue(value, depth = 0) {
+    if (depth > 100)
+        throw new TypeError("MessagePack value exceeds the maximum depth");
+    if (typeof value === "bigint") {
+        if (value < -(1n << 63n) || value > (1n << 64n) - 1n)
+            throw new RangeError("MessagePack integers must fit in signed or unsigned 64 bits");
+        return value >= -0x80000000n && value <= 0xffffffffn ? Number(value) : value;
+    }
+    if (typeof value === "number" && Number.isSafeInteger(value)) {
+        return value < -0x8000_0000 || value > 0xffff_ffff ? BigInt(value) : value;
+    }
+    if (Array.isArray(value))
+        return value.map((nested) => messagePackValue(nested, depth + 1));
+    if (value instanceof Map) {
+        const entries = [...value.entries()];
+        if (!entries.every(([key]) => typeof key === "string"))
+            throw new TypeError("MessagePack object keys must be strings");
+        return Object.fromEntries(entries.map(([key, nested]) => [key, messagePackValue(nested, depth + 1)]));
+    }
+    if (typeof value === "object" &&
+        value !== null &&
+        !ArrayBuffer.isView(value) &&
+        !(value instanceof Date)) {
+        return Object.fromEntries(Object.entries(value).map(([key, nested]) => [key, messagePackValue(nested, depth + 1)]));
+    }
+    return value;
 }
 //# sourceMappingURL=codecs.js.map

package/dist/stream/codecs.js.map

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

package/dist/stream/consumer-group.d.ts

@@ -1,12 +1,14 @@
 import type { Capabilities } from "../client/capabilities.js";
-import type { LaserTransport } from "../iggy/apache-iggy.js";
-import { FilteredReaderBuilder, type CatalogPageOptions, type FilterPreviewOptions, type FilterTransport } from "../managed/filters.js";
+import { FilteredReaderBuilder, type FilterPreviewOptions, type FilterTransport } from "../managed/filters.js";
 import type { ConsumerFilter, FilterBinding, FilterGroupIdentity, FilterHeader, FilterPreview, FilterRevisionPage, FilterRevisionRef, FilterTestResult, GroupFilterSpec } from "../wire/filter.js";
 import { Consumer, type ConsumerOptions } from "./consumer.js";
+import type { Topic } from "./topic.js";
 /** What a consumer group needs beyond the stream transport to reach its filter policy. */
 export interface GroupContext {
     readonly transport: FilterTransport;
     readonly capabilities: () => Promise<Capabilities>;
+    /** Probes the server again, for a consumer built before any probe answered. */
+    readonly refreshCapabilities?: () => Promise<Capabilities>;
 }
 /** A consumer group by name or by its native numeric id. */
 export type GroupTarget = {
@@ -48,12 +50,12 @@ export interface CreateConsumerGroupOptions {
  */
 export declare class ConsumerGroup {
     private readonly transport;
-    readonly streamName: string;
-    readonly topicName: string;
+    /** The topic this group consumes. */
+    readonly topic: Topic;
     private readonly target;
     private readonly context?;
     private configuredAt;
-    constructor(transport: LaserTransport, streamName: string, topicName: string, target: GroupTarget, context?: GroupContext | undefined);
+    private constructor();
     /** The group name, `undefined` for a handle addressed by numeric id. */
     get name(): string | undefined;
     /** The native numeric id, `undefined` for a handle addressed by name. */
@@ -63,8 +65,8 @@ export declare class ConsumerGroup {
      * call. Idempotent: an existing group is kept, and the same policy keeps its
      * binding. A policy is preflighted against the server's capabilities before
      * the native group is created. A group that runs another policy throws
-     * `ConsumerGroupSetupError` with reason `conflict`, and the group is left as
-     * it is.
+     * `ConsumerGroupSetupError` whose cause has filter reason `conflict`, and
+     * the group is left as it is.
      */
     create(options?: CreateConsumerGroupOptions): Promise<ConsumerGroupInfo>;
     /** The group as the server knows it: its id, exact identity and active policy. */
@@ -79,8 +81,9 @@ export declare class ConsumerGroup {
      * resolves group policies the consumer runs the group's filter, or none, and
      * commits through the group's fenced acknowledgments. On Apache Iggy it is
      * the native group consumer. A server that serves filters without group
-     * reads is refused with `UnsupportedError`, and a capability probe that
-     * established nothing is a retryable `TransportError`, never a native read.
+     * reads is refused with `UnsupportedError`. When no probe answered yet, the
+     * server is probed again, and a probe that still established nothing is a
+     * retryable `TimeoutError`, never a native read.
      */
     consumer(options?: ConsumerOptions): Promise<Consumer>;
     /**
@@ -120,7 +123,7 @@ export declare class GroupFilter {
     /** The active policy, `undefined` for an unbound group. */
     get(): Promise<FilterBinding | undefined>;
     /** One page of the group's own filter revisions, newest first. */
-    revisions(options?: CatalogPageOptions): Promise<FilterRevisionPage>;
+    revisions(page?: number, pageSize?: number): Promise<FilterRevisionPage>;
     /**
      * Draft a revision of the group's own filter. Readers keep running the
      * active revision. `expectedRevision` must still be the latest.