@wirecat/max-cli 0.0.0 → 0.43.0

package/dist/protocol/connection.js

@@ -0,0 +1,301 @@
+import { WebSocket } from "ws";
+import { Command, decodeFrame, decodeHeader, encodeFrame, HEADER_BYTES, SEQ_MODULO, } from "./frame.js";
+/** Where web.max.ru connects, read off its live socket on 2026-09-25. */
+export const MAX_WEBSOCKET_URL = "wss://api.oneme.ru/websocket";
+/** MAX's web client sends this; we send what it sends rather than announcing ourselves (§34). */
+export const WEB_ORIGIN = "https://web.max.ru";
+export class ProtocolError extends Error {
+    opcode;
+    payload;
+    constructor(message, opcode, payload) {
+        super(message);
+        this.name = "ProtocolError";
+        this.opcode = opcode;
+        this.payload = payload;
+    }
+}
+/** MAX's keep-alive, both directions. */
+const PING = 1;
+/** A message arrived. The web client acknowledges each one. */
+const NEW_MESSAGE = 128;
+/**
+ * One WebSocket, one command's worth of work, then closed.
+ *
+ * **Everything that could keep the process alive is owned here**: the socket, the per-request
+ * timers and the listeners. `close()` clears all three, and a command that opens a connection
+ * closes it in a `finally` — a CLI that prints its result and then hangs is a defect, not a rough
+ * edge (REQUIREMENTS §18).
+ */
+export class Connection {
+    #url;
+    #origin;
+    #timeoutMs;
+    #onEvent;
+    #onError;
+    #live;
+    #onClose;
+    #createSocket;
+    #pending = new Map();
+    #socket;
+    #seq = 0;
+    #lastPush;
+    #closed = false;
+    constructor(options = {}) {
+        this.#url = options.url ?? MAX_WEBSOCKET_URL;
+        this.#origin = options.origin ?? WEB_ORIGIN;
+        this.#timeoutMs = options.timeoutMs ?? 30_000;
+        this.#onEvent = options.onEvent;
+        this.#onError = options.onError;
+        this.#live = options.live ?? false;
+        this.#onClose = options.onClose;
+        this.#createSocket =
+            options.createSocket ??
+                ((url, origin) => new WebSocket(url, {
+                    headers: { Origin: origin },
+                    // A frame's body is at most 16 MiB by its header; `ws` would take 100 MiB.
+                    maxPayload: HEADER_BYTES + 0xff_ffff,
+                    handshakeTimeout: this.#timeoutMs,
+                }));
+    }
+    async open() {
+        if (this.#socket)
+            return;
+        const socket = this.#createSocket(this.#url, this.#origin);
+        this.#socket = socket;
+        try {
+            await new Promise((resolve, reject) => {
+                const onOpen = () => {
+                    socket.off("error", onError);
+                    resolve();
+                };
+                const onError = (error) => {
+                    socket.off("open", onOpen);
+                    reject(error);
+                };
+                socket.once("open", onOpen);
+                socket.once("error", onError);
+            });
+        }
+        catch (error) {
+            // Left set, the next `open()` would return at once and the request after it wait out its timeout.
+            if (this.#socket === socket)
+                this.#socket = undefined;
+            socket.removeAllListeners();
+            socket.on("error", () => { });
+            if (socket.readyState === socket.OPEN || socket.readyState === socket.CONNECTING)
+                socket.close();
+            throw error;
+        }
+        socket.on("message", (data) => this.#receive(asBytes(data)));
+        // The code and reason are all there is to tell MAX ending the session from a network drop.
+        socket.on("close", (code, reason) => this.#lost(new Error(closedBy(code, reason))));
+        socket.on("error", (error) => this.#lost(error));
+    }
+    // The web client's INIT goes out as seq 0; the header holds two bytes, so the count wraps, and
+    // after the wrap a request still waiting would have its answer handed to the newer one.
+    #nextSeq() {
+        for (let tried = 0; tried < SEQ_MODULO; tried++) {
+            const seq = this.#seq;
+            this.#seq = (this.#seq + 1) % SEQ_MODULO;
+            if (!this.#pending.has(seq))
+                return seq;
+        }
+        throw new Error(`all ${SEQ_MODULO} request numbers are waiting for an answer; refusing to reuse one`);
+    }
+    /**
+     * Sends one request and waits for the response carrying the same `seq`.
+     *
+     * MAX interleaves pushed events with responses on one socket, so the `seq` is the only thing
+     * tying an answer to its question — a reader that takes the next frame as its answer will
+     * eventually read somebody's incoming message instead.
+     *
+     * `watch` is told what left and what came back, for the caller that is keeping a diagnostic. It
+     * is called synchronously on the way out, so a request that never gets an answer is still on
+     * record — which is the run somebody actually wants to read.
+     */
+    async invoke(opcode, payload = {}, watch) {
+        if (!Number.isInteger(opcode)) {
+            // A typo in an opcode constant is otherwise a round trip to MAX that comes back
+            // "неизвестный opcode", which reads as the protocol's fault rather than ours.
+            throw new Error(`refusing to send a frame with a non-integer opcode: ${String(opcode)}`);
+        }
+        if (this.#closed)
+            throw new Error("the connection is closed");
+        if (!this.#socket)
+            throw new Error("the connection is not open");
+        const seq = this.#nextSeq();
+        const socket = this.#socket;
+        const sent = encodeFrame({ seq, opcode, payload });
+        const answer = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.#pending.delete(seq);
+                reject(new Error(`MAX did not answer opcode ${opcode} within ${this.#timeoutMs}ms`));
+            }, this.#timeoutMs);
+            this.#pending.set(seq, { resolve, reject, timer });
+            socket.send(sent);
+            watch?.({ phase: "sent", seq, opcode, bytes: sent.length });
+        });
+        const frame = answer.frame;
+        watch?.({ phase: "received", seq, opcode, bytes: answer.bytes });
+        if (frame.cmd === Command.ERROR) {
+            const reason = typeof frame.payload?.error === "string" ? frame.payload.error : "an error with no reason given";
+            throw new ProtocolError(`MAX refused opcode ${opcode}: ${reason}`, opcode, frame.payload);
+        }
+        return frame.payload ?? {};
+    }
+    /**
+     * Closes the socket and **settles anything still waiting**, rather than dropping it.
+     *
+     * ⚠ It used to clear the pending map without rejecting, which left the caller of an in-flight
+     * `invoke` awaiting a promise nothing could ever settle: the timers were cleared and the socket
+     * listeners removed in the same breath, so neither the timeout nor the close event was left to
+     * fire. Invisible in normal use, because `close()` runs in a `finally` once the body is done —
+     * and a hang the moment anything closes the connection while a request is out, which is exactly
+     * what a whole-command deadline does. Found by a test, not by a user.
+     */
+    async close() {
+        this.#closed = true;
+        const socket = this.#socket;
+        this.#socket = undefined;
+        this.#failAll(new Error("the connection was closed before MAX answered"));
+        if (!socket)
+            return;
+        socket.removeAllListeners();
+        // ⚠ **An error listener has to survive the close.** `ws` emits `error` when a socket is closed
+        // while it is still CONNECTING — measured against the real service — and an `error` event with
+        // no listener is how Node kills the whole process. Removing every listener and *then* closing
+        // turned a timeout into an unhandled event and a stack trace: exit 1 and a dump of `ws`
+        // internals, instead of exit 9 and one sentence.
+        //
+        // Nothing here can act on such an error anyway. The connection is being discarded; the socket
+        // failing to shut politely changes nothing a caller could use.
+        socket.on("error", () => { });
+        if (socket.readyState === socket.OPEN || socket.readyState === socket.CONNECTING)
+            socket.close();
+    }
+    #receive(raw) {
+        let frame;
+        try {
+            frame = decodeFrame(raw);
+        }
+        catch (error) {
+            // A body we cannot read still has a header naming the request it answers. Failing that
+            // request with the reason beats letting it wait out its timeout as "MAX did not answer".
+            const header = safeHeader(raw);
+            const answers = header && (header.cmd === Command.RESPONSE || header.cmd === Command.ERROR);
+            const waiting = answers ? this.#pending.get(header.seq) : undefined;
+            if (!header || !waiting)
+                return;
+            clearTimeout(waiting.timer);
+            this.#pending.delete(header.seq);
+            waiting.reject(error instanceof Error ? error : new Error(String(error)));
+            return;
+        }
+        // MAX numbers its own frames, so a push can carry the very `seq` a request is waiting on. Only
+        // `cmd` tells an answer from a push — a lookup by `seq` alone once resolved a request with
+        // somebody's incoming message.
+        if (frame.cmd !== Command.RESPONSE && frame.cmd !== Command.ERROR) {
+            // This runs inside the socket's listener, where a throw takes the whole process down.
+            try {
+                this.#pushed(frame);
+            }
+            catch (error) {
+                this.#onError?.(error instanceof Error ? error : new Error(String(error)));
+            }
+            return;
+        }
+        const waiting = this.#pending.get(frame.seq);
+        if (!waiting)
+            return;
+        clearTimeout(waiting.timer);
+        this.#pending.delete(frame.seq);
+        waiting.resolve({ frame, bytes: raw.length });
+    }
+    #pushed(frame) {
+        if (this.#live) {
+            // After a hiccup MAX sends some pushes again; the web client drops anything not newer.
+            // "Newer" is modular: a two-byte seq wraps, and a plain `<=` would drop every push after it.
+            if (this.#lastPush !== undefined && !isAfter(frame.seq, this.#lastPush))
+                return;
+            this.#lastPush = frame.seq;
+            if (frame.opcode === PING) {
+                this.#answer({ cmd: Command.RESPONSE, seq: frame.seq, opcode: PING });
+                return;
+            }
+            const message = frame.payload?.message;
+            const chatId = frame.payload?.chatId;
+            if (frame.opcode === NEW_MESSAGE &&
+                typeof message === "object" &&
+                message !== null &&
+                "id" in message &&
+                isId(chatId) &&
+                isId(message.id)) {
+                // As bigints, so they go back wrapped the way the web client wraps an id.
+                this.#answer({
+                    cmd: Command.RESPONSE,
+                    seq: frame.seq,
+                    opcode: NEW_MESSAGE,
+                    payload: { chatId: asWireId(chatId), messageId: asWireId(message.id) },
+                });
+            }
+        }
+        this.#onEvent?.(frame);
+    }
+    #answer(frame) {
+        const socket = this.#socket;
+        if (socket && !this.#closed)
+            socket.send(encodeFrame(frame));
+    }
+    /** MAX dropped us: every waiting request fails now, and the next `invoke` refuses at once. */
+    #lost(error) {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        const socket = this.#socket;
+        this.#socket = undefined;
+        if (socket) {
+            // A dead connection must hear nothing more, or a reconnect's frames reach it twice.
+            socket.removeAllListeners();
+            socket.on("error", () => { });
+        }
+        this.#failAll(error);
+        this.#onClose?.(error);
+    }
+    #failAll(error) {
+        for (const { reject, timer } of this.#pending.values()) {
+            clearTimeout(timer);
+            reject(error);
+        }
+        this.#pending.clear();
+    }
+}
+const asBytes = (data) => {
+    if (Array.isArray(data))
+        return Buffer.concat(data);
+    return data instanceof ArrayBuffer ? new Uint8Array(data) : data;
+};
+const safeHeader = (raw) => {
+    try {
+        return decodeHeader(raw);
+    }
+    catch {
+        return undefined;
+    }
+};
+const isAfter = (seq, last) => {
+    const distance = (seq - last + SEQ_MODULO) % SEQ_MODULO;
+    return distance > 0 && distance < SEQ_MODULO / 2;
+};
+const isId = (value) => typeof value === "string" || typeof value === "number" || typeof value === "bigint";
+const asWireId = (value) => typeof value === "number" && Number.isSafeInteger(value) ? BigInt(value) : value;
+const closedBy = (code, reason) => {
+    const said = reason
+        ?.toString("utf8")
+        .replace(/\p{Cc}/gu, " ")
+        .trim()
+        .slice(0, 120);
+    if (code === undefined)
+        return "MAX closed the connection";
+    return `MAX closed the connection (code ${code}${said ? `: ${said}` : ""})`;
+};
+//# sourceMappingURL=connection.js.map

package/dist/protocol/connection.js.map

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

package/dist/protocol/frame.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The binary protocol web.max.ru speaks, captured from a live socket on 2026-09-25
+ * (`src/testing/fixtures/web-capture-2026-09-25.json`). JSON on protocol 11 was what we used to
+ * send, and nothing the web client sends looks like it.
+ */
+export declare const PROTOCOL_VERSION = 10;
+export declare const Command: {
+    readonly REQUEST: 0;
+    readonly RESPONSE: 1;
+    readonly EVENT: 2;
+    readonly ERROR: 3;
+};
+export type Command = (typeof Command)[keyof typeof Command];
+export type Payload = Record<string, unknown>;
+export interface OutboundFrame {
+    seq: number;
+    opcode: number;
+    /** Absent, or empty, goes out as a zero-length body — as the web client's ping answer does. */
+    payload?: Payload;
+    cmd?: Command;
+}
+export interface InboundFrame {
+    ver: number;
+    cmd: number;
+    seq: number;
+    opcode: number;
+    payload: Payload | null;
+}
+/** `ver` `cmd` `seq:u16` `opcode:u16` `flags:u8` `length:u24`, big-endian. */
+export declare const HEADER_BYTES = 10;
+export declare const SEQ_MODULO = 65536;
+export declare const encodeFrame: (frame: OutboundFrame) => Uint8Array;
+/** The header alone, so a body that cannot be read still says which request it answered. */
+export declare const decodeHeader: (bytes: Uint8Array) => Omit<InboundFrame, "payload"> & {
+    flags: number;
+    length: number;
+};
+/**
+ * **Integers come back as `number` unless a number would lose digits.** MessagePack hands every
+ * 64-bit integer over as a `bigint`, and MAX sends times as 64-bit — a `bigint` timestamp breaks
+ * every `Date` and every subtraction above this layer. Message ids are 18 digits, past
+ * `Number.MAX_SAFE_INTEGER`, and stay `bigint`; every id leaves the domain mapper as a string.
+ */
+export declare const decodeFrame: (bytes: Uint8Array) => InboundFrame;
+/** What one frame may grow to. The header's own bound, `flags × length`, is about 2 GB of memory. */
+export declare const MAX_DECOMPRESSED: number;
+export declare class FrameError extends Error {
+    constructor(what: string);
+}
+/**
+ * Ids arrive as `number` when small and `bigint` when not, and both have to render identically.
+ * A domain id is a string from here on — it is an identifier, never arithmetic.
+ */
+export declare const asId: (value: unknown) => string | undefined;
+//# sourceMappingURL=frame.d.ts.map

package/dist/protocol/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/protocol/frame.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,eAAO,MAAM,OAAO;aAClB,OAAO,EAAE,CAAC;aACV,QAAQ,EAAE,CAAC;aACX,KAAK,EAAE,CAAC;aACR,KAAK,EAAE,CAAC;CACA,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAA;AAE5D,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE7C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,+FAA+F;IAC/F,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CACxB;AAED,8EAA8E;AAC9E,eAAO,MAAM,YAAY,KAAK,CAAA;AAS9B,eAAO,MAAM,UAAU,QAAW,CAAA;AAKlC,eAAO,MAAM,WAAW,UAAW,aAAa,KAAG,UAwBlD,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,YAAY,UAAW,UAAU,KAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAgB/G,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,UAAW,UAAU,KAAG,YAW/C,CAAA;AAED,qGAAqG;AACrG,eAAO,MAAM,gBAAgB,QAAmB,CAAA;AAEhD,qBAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,IAAI,EAAE,MAAM,EAGvB;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,UAAW,OAAO,KAAG,MAAM,GAAG,SAK9C,CAAA"}

package/dist/protocol/frame.js

@@ -0,0 +1,149 @@
+import { decode, ExtData, ExtensionCodec, encode } from "@msgpack/msgpack";
+import { compressBlock, decompressBlock } from "./lz4.js";
+/**
+ * The binary protocol web.max.ru speaks, captured from a live socket on 2026-09-25
+ * (`src/testing/fixtures/web-capture-2026-09-25.json`). JSON on protocol 11 was what we used to
+ * send, and nothing the web client sends looks like it.
+ */
+export const PROTOCOL_VERSION = 10;
+export const Command = {
+    REQUEST: 0,
+    RESPONSE: 1,
+    EVENT: 2,
+    ERROR: 3,
+};
+/** `ver` `cmd` `seq:u16` `opcode:u16` `flags:u8` `length:u24`, big-endian. */
+export const HEADER_BYTES = 10;
+/** The web client sends 31 bytes plain and 37 compressed; where between them it switches was not seen. */
+const COMPRESS_FROM = 32;
+const ZSTD = 0xff;
+const MAX_LZ4_FLAGS = 0x7f;
+/** MAX wraps a number it means as a 64-bit id or time in extension type 1; so does the web client. */
+const WRAPPED = 1;
+export const SEQ_MODULO = 0x1_0000;
+const wrapped = new ExtensionCodec();
+wrapped.register({ type: WRAPPED, encode: () => null, decode: (data) => decodeBody(data) });
+export const encodeFrame = (frame) => {
+    const raw = frame.payload && Object.keys(frame.payload).length > 0 ? encodeBody(frame.payload) : new Uint8Array(0);
+    let body = raw;
+    let flags = 0;
+    if (raw.length >= COMPRESS_FROM) {
+        const compressed = compressBlock(raw);
+        const factor = Math.ceil(raw.length / compressed.length);
+        if (factor <= MAX_LZ4_FLAGS) {
+            // Kept even when it came out larger: the web client does the same (47 bytes sent as 49).
+            body = compressed;
+            flags = factor;
+        }
+    }
+    const bytes = new Uint8Array(HEADER_BYTES + body.length);
+    const view = new DataView(bytes.buffer);
+    view.setUint8(0, PROTOCOL_VERSION);
+    view.setUint8(1, frame.cmd ?? Command.REQUEST);
+    view.setUint16(2, frame.seq % SEQ_MODULO);
+    view.setUint16(4, frame.opcode);
+    view.setUint32(6, ((flags << 24) | body.length) >>> 0);
+    bytes.set(body, HEADER_BYTES);
+    return bytes;
+};
+/** The header alone, so a body that cannot be read still says which request it answered. */
+export const decodeHeader = (bytes) => {
+    if (bytes.length < HEADER_BYTES)
+        throw new FrameError(`a frame of ${bytes.length} bytes, shorter than its header`);
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const packed = view.getUint32(6);
+    const header = {
+        ver: view.getUint8(0),
+        cmd: view.getUint8(1),
+        seq: view.getUint16(2),
+        opcode: view.getUint16(4),
+        flags: packed >>> 24,
+        length: packed & 0xff_ffff,
+    };
+    if (HEADER_BYTES + header.length > bytes.length) {
+        throw new FrameError(`a frame that claims ${header.length} bytes and carries ${bytes.length - HEADER_BYTES}`);
+    }
+    return header;
+};
+/**
+ * **Integers come back as `number` unless a number would lose digits.** MessagePack hands every
+ * 64-bit integer over as a `bigint`, and MAX sends times as 64-bit — a `bigint` timestamp breaks
+ * every `Date` and every subtraction above this layer. Message ids are 18 digits, past
+ * `Number.MAX_SAFE_INTEGER`, and stay `bigint`; every id leaves the domain mapper as a string.
+ */
+export const decodeFrame = (bytes) => {
+    const { flags, length, ...header } = decodeHeader(bytes);
+    let body = bytes.subarray(HEADER_BYTES, HEADER_BYTES + length);
+    if (flags === ZSTD)
+        throw new FrameError("a zstd-compressed frame, which the web client was never seen receiving");
+    if (flags > MAX_LZ4_FLAGS)
+        throw new FrameError(`a frame with compression flags ${flags}`);
+    if (flags > 0)
+        body = decompressBlock(body, Math.min(flags * length, MAX_DECOMPRESSED));
+    if (body.length === 0)
+        return { ...header, payload: null };
+    const value = decodeBody(body);
+    return { ...header, payload: isRecord(value) ? value : null };
+};
+/** What one frame may grow to. The header's own bound, `flags × length`, is about 2 GB of memory. */
+export const MAX_DECOMPRESSED = 32 * 1024 * 1024;
+export class FrameError extends Error {
+    constructor(what) {
+        super(`MAX sent ${what}`);
+        this.name = "FrameError";
+    }
+}
+/**
+ * Ids arrive as `number` when small and `bigint` when not, and both have to render identically.
+ * A domain id is a string from here on — it is an identifier, never arithmetic.
+ */
+export const asId = (value) => {
+    if (typeof value === "bigint")
+        return value.toString();
+    if (typeof value === "number" && Number.isFinite(value))
+        return String(value);
+    if (typeof value === "string" && value !== "")
+        return value;
+    return undefined;
+};
+/** A `bigint` is an id we built from a string (`toWireId`), and goes out wrapped the way the web client wraps ids. */
+const encodeBody = (payload) => encode(wrapBigints(payload), { extensionCodec: wrapped, useBigInt64: true, ignoreUndefined: true });
+const decodeBody = (bytes) => narrow(decode(bytes, { extensionCodec: wrapped, useBigInt64: true, mapKeyConverter: asKey }));
+/**
+ * ⚠ With `useBigInt64` the library writes every `number` past 32 bits as a **float64**, and MAX
+ * refuses a login whose time arrives as one (`proto.payload`, measured 2026-09-25). A whole number
+ * that wide goes out as a bare 64-bit integer instead, as the web client sends `from` and
+ * `contactsSync`; only a `bigint` — an id — is wrapped.
+ */
+const wrapBigints = (value) => {
+    if (typeof value === "bigint")
+        return new ExtData(WRAPPED, encode(value, { useBigInt64: true }));
+    if (typeof value === "number" && Number.isSafeInteger(value) && (value > 0xffff_ffff || value < -0x8000_0000))
+        return BigInt(value);
+    if (Array.isArray(value))
+        return value.map(wrapBigints);
+    if (isRecord(value))
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, wrapBigints(item)]));
+    return value;
+};
+const narrow = (value) => {
+    if (typeof value === "bigint")
+        return Number.MIN_SAFE_INTEGER <= value && value <= Number.MAX_SAFE_INTEGER ? Number(value) : value;
+    if (Array.isArray(value))
+        return value.map(narrow);
+    if (isRecord(value)) {
+        for (const key of Object.keys(value))
+            value[key] = narrow(value[key]);
+    }
+    return value;
+};
+/** Map keys are chat and message ids as often as names; ours are always strings. */
+const asKey = (key) => {
+    if (typeof key === "string")
+        return key;
+    if (typeof key === "number" || typeof key === "bigint")
+        return String(key);
+    throw new FrameError(`a map key of type ${typeof key}`);
+};
+const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Uint8Array);
+//# sourceMappingURL=frame.js.map

package/dist/protocol/frame.js.map

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

package/dist/protocol/lz4.d.ts

@@ -0,0 +1,15 @@
+/**
+ * LZ4 *block* format — no frame header, no checksum — which is what MAX puts in a frame body.
+ *
+ * Hand-written because both directions are small and a native binding is what breaks under Bun
+ * (REQUIREMENTS §36). The decompressor mirrors the one that read all 73 frames of the 2026-09-25
+ * capture; the compressor keeps the format's end-of-block rules, which a lenient decoder such as
+ * ours would not notice being broken but MAX's might.
+ */
+export declare class Lz4Error extends Error {
+    constructor(what: string);
+}
+export declare const compressBlock: (src: Uint8Array) => Uint8Array;
+/** `maxOutput` bounds a hostile or corrupt block; the frame header gives the caller one. */
+export declare const decompressBlock: (src: Uint8Array, maxOutput: number) => Uint8Array;
+//# sourceMappingURL=lz4.d.ts.map

package/dist/protocol/lz4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lz4.d.ts","sourceRoot":"","sources":["../../src/protocol/lz4.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,qBAAa,QAAS,SAAQ,KAAK;IACjC,YAAY,IAAI,EAAE,MAAM,EAGvB;CACF;AAED,eAAO,MAAM,aAAa,QAAS,UAAU,KAAG,UA4B/C,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,eAAe,QAAS,UAAU,aAAa,MAAM,KAAG,UA6BpE,CAAA"}