@leemour/max-cli 0.5.0 → 0.7.0

package/dist/sends/journal.js

@@ -0,0 +1,40 @@
+import { appendFileSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { resolvePaths } from "@leemour/cli-core";
+/**
+ * `<state dir>/sends/<profile>.jsonl` — beside `runs`, never in the cache directory, so that
+ * `max cache clear` cannot erase what was sent in the owner's name (the reason of `NEED-51`).
+ */
+export const sendsPathFor = (profile, env = process.env) => join(resolvePaths({ appName: "max-cli", prefix: "MAX", env }).state, "sends", `${profile}.jsonl`);
+export class SendJournal {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    append(entry) {
+        mkdirSync(dirname(this.path), { recursive: true, mode: 0o700 });
+        appendFileSync(this.path, `${JSON.stringify(entry)}\n`, { mode: 0o600 });
+    }
+    /** Oldest first. A line that does not parse is skipped: a torn last write must not block sending. */
+    entries() {
+        let text;
+        try {
+            text = readFileSync(this.path, "utf8");
+        }
+        catch {
+            return [];
+        }
+        return text
+            .split("\n")
+            .filter((line) => line.trim() !== "")
+            .flatMap((line) => {
+            try {
+                return [JSON.parse(line)];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/sends/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/sends/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAqDhD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,MAAyB,OAAO,CAAC,GAAG,EAAU,EAAE,CAC5F,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,QAAQ,CAAC,CAAA;AAEnG,MAAM,OAAO,WAAW;IACD;IAArB,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAErC,MAAM,CAAC,KAAgB;QACrB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC/D,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC1E,CAAC;IAED,qGAAqG;IACrG,OAAO;QACL,IAAI,IAAY,CAAA;QAChB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAA;QACX,CAAC;QACD,OAAO,IAAI;aACR,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;aACpC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC,CAAA;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC,CAAC,CAAA;IACN,CAAC;CACF"}

package/dist/sends/recipients.d.ts

@@ -0,0 +1,29 @@
+import type { Id } from "../domain/models.js";
+export interface Recipient {
+    id: Id;
+    title: string | null;
+    addedAt: string;
+}
+/**
+ * A state file, not a setting: the configuration schema has deliberately no place for a chat id
+ * (`src/config.ts`), and this list is data about a profile rather than a preference.
+ */
+export declare const recipientsPathFor: (profile: string, env?: NodeJS.ProcessEnv) => string;
+/**
+ * The chats a profile may send to. **No file means the check is off**; a file with no chats in it
+ * means nowhere. Optional by the owner's ruling (`NEED-159`).
+ */
+export declare class RecipientList {
+    #private;
+    readonly path: string;
+    constructor(path: string);
+    /** `undefined` when the list is off. A file that cannot be read refuses rather than opening up. */
+    read(): Recipient[] | undefined;
+    /** Whether it was new. */
+    add(recipient: Recipient): boolean;
+    /** The id or the title as it was stored; `undefined` when neither matched. */
+    remove(reference: string): Recipient | undefined;
+    /** Whether there was a list to turn off. */
+    off(): boolean;
+}
+//# sourceMappingURL=recipients.d.ts.map

package/dist/sends/recipients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipients.d.ts","sourceRoot":"","sources":["../../src/sends/recipients.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAE7C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,EAAE,CAAA;IACN,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,MAAK,MAAM,CAAC,UAAwB,KAAG,MACsB,CAAA;AAEhH;;;GAGG;AACH,qBAAa,aAAa;;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAEjC,mGAAmG;IACnG,IAAI,IAAI,SAAS,EAAE,GAAG,SAAS;IAe/B,0BAA0B;IAC1B,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAOlC,8EAA8E;IAC9E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAUhD,4CAA4C;IAC5C,GAAG,IAAI,OAAO;CASf"}

package/dist/sends/recipients.js

@@ -0,0 +1,62 @@
+import { existsSync, readFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, resolvePaths, writeSecurely } from "@leemour/cli-core";
+/**
+ * A state file, not a setting: the configuration schema has deliberately no place for a chat id
+ * (`src/config.ts`), and this list is data about a profile rather than a preference.
+ */
+export const recipientsPathFor = (profile, env = process.env) => join(resolvePaths({ appName: "max-cli", prefix: "MAX", env }).state, "profiles", `${profile}.recipients.json`);
+/**
+ * The chats a profile may send to. **No file means the check is off**; a file with no chats in it
+ * means nowhere. Optional by the owner's ruling (`NEED-159`).
+ */
+export class RecipientList {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    /** `undefined` when the list is off. A file that cannot be read refuses rather than opening up. */
+    read() {
+        if (!existsSync(this.path))
+            return undefined;
+        try {
+            const parsed = JSON.parse(readFileSync(this.path, "utf8"));
+            if (!Array.isArray(parsed.chats))
+                throw new Error("no `chats` array");
+            return parsed.chats;
+        }
+        catch (error) {
+            throw new CliError("configuration_error", `the recipient list ${this.path} cannot be read (${error instanceof Error ? error.message : String(error)}) — ` +
+                "fix the file or turn the list off with `max recipients off`");
+        }
+    }
+    /** Whether it was new. */
+    add(recipient) {
+        const chats = this.read() ?? [];
+        if (chats.some((chat) => chat.id === recipient.id))
+            return false;
+        this.#write([...chats, recipient]);
+        return true;
+    }
+    /** The id or the title as it was stored; `undefined` when neither matched. */
+    remove(reference) {
+        const chats = this.read() ?? [];
+        const wanted = reference.trim();
+        const gone = chats.find((chat) => chat.id === wanted) ??
+            chats.find((chat) => chat.title?.toLocaleLowerCase() === wanted.toLocaleLowerCase());
+        if (gone)
+            this.#write(chats.filter((chat) => chat !== gone));
+        return gone;
+    }
+    /** Whether there was a list to turn off. */
+    off() {
+        if (!existsSync(this.path))
+            return false;
+        rmSync(this.path);
+        return true;
+    }
+    #write(chats) {
+        writeSecurely(this.path, `${JSON.stringify({ chats }, null, 2)}\n`, 0o600);
+    }
+}
+//# sourceMappingURL=recipients.js.map

package/dist/sends/recipients.js.map

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

package/dist/server/lines.d.ts

@@ -0,0 +1,9 @@
+/**
+ * One JSON value per line, **losslessly**: a request or an answer passing through `max serve`
+ * carries MAX's 18-digit message ids, which `JSON` would round into somebody else's message.
+ */
+export declare const toLine: (value: unknown) => string;
+export declare const fromLine: (line: string) => Record<string, unknown>;
+/** Calls `onLine` for each complete line `data` finishes, keeping the rest for next time. */
+export declare const lineReader: (onLine: (line: string) => void) => (data: Buffer | string) => void;
+//# sourceMappingURL=lines.d.ts.map

package/dist/server/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../src/server/lines.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,MAAiC,CAAA;AAEzE,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAG/B,CAAA;AAE/B,6FAA6F;AAC7F,eAAO,MAAM,UAAU,GAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,MAE/C,MAAM,MAAM,GAAG,MAAM,SAU9B,CAAA"}

package/dist/server/lines.js

@@ -0,0 +1,25 @@
+import { isInteger, isSafeNumber, parse, stringify } from "lossless-json";
+/**
+ * One JSON value per line, **losslessly**: a request or an answer passing through `max serve`
+ * carries MAX's 18-digit message ids, which `JSON` would round into somebody else's message.
+ */
+export const toLine = (value) => `${stringify(value)}\n`;
+export const fromLine = (line) => parse(line, undefined, {
+    parseNumber: (text) => (isInteger(text) && !isSafeNumber(text) ? BigInt(text) : Number(text)),
+});
+/** Calls `onLine` for each complete line `data` finishes, keeping the rest for next time. */
+export const lineReader = (onLine) => {
+    let buffered = "";
+    return (data) => {
+        buffered += String(data);
+        let end = buffered.indexOf("\n");
+        while (end >= 0) {
+            const line = buffered.slice(0, end);
+            buffered = buffered.slice(end + 1);
+            if (line.trim() !== "")
+                onLine(line);
+            end = buffered.indexOf("\n");
+        }
+    };
+};
+//# sourceMappingURL=lines.js.map

package/dist/server/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../src/server/lines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAA;AAEzE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAA2B,EAAE,CAChE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE;IACrB,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC9F,CAA4B,CAAA;AAE/B,6FAA6F;AAC7F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAA8B,EAAE,EAAE;IAC3D,IAAI,QAAQ,GAAG,EAAE,CAAA;IACjB,OAAO,CAAC,IAAqB,EAAE,EAAE;QAC/B,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,CAAA;QACxB,IAAI,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YACnC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;YAClC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YACpC,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC,CAAA;AACH,CAAC,CAAA"}

package/dist/server/server-connection.d.ts

@@ -0,0 +1,35 @@
+import { Connection, type Wire, type WireEvent } from "../protocol/connection.js";
+import { type Payload } from "../protocol/frame.js";
+import type { SessionStore } from "../session/store.js";
+/**
+ * **A command's connection that goes through `max serve`** when one is running (`MAX-16`).
+ *
+ * INIT and LOGIN are answered by the server's own login, so the command logs in without logging
+ * in. Reads go through the server's connection. **Anything else — a send, a reaction — makes this
+ * open a connection of its own and log in on it**, so it passes the send guards exactly as it does
+ * without a server (`NEED-185`). No server, a stale login, or a server that stops answering: the
+ * whole command falls back to its own connection before it has sent anything.
+ */
+export declare class ServerConnection implements Wire {
+    #private;
+    constructor({ path, store, timeoutMs, direct, onUnreachable, }: {
+        path: string;
+        store: SessionStore;
+        timeoutMs?: number;
+        direct?: () => Connection;
+        /** The socket file is there and nobody answers — a server that died; start another. */
+        onUnreachable?: () => void;
+    });
+    open(): Promise<void>;
+    invoke(opcode: number, payload?: Payload, watch?: (event: WireEvent) => void): Promise<Payload>;
+    close(): Promise<void>;
+}
+/**
+ * What a command may ask for through the server — the server allows exactly these. **Nothing here
+ * changes anything**: sending, reacting, marking read and deleting never come this way, so no
+ * guard can be walked around.
+ */
+export declare const READS: Set<number>;
+/** Asks a running server to stop. Resolves whether or not one was there. */
+export declare const stopServer: (path: string) => Promise<boolean>;
+//# sourceMappingURL=server-connection.d.ts.map

package/dist/server/server-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-connection.d.ts","sourceRoot":"","sources":["../../src/server/server-connection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAiB,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAChG,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAUvD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,IAAI;;gBAe/B,EACV,IAAI,EACJ,KAAK,EACL,SAAkB,EAClB,MAAM,EACN,aAAa,GACd,EAAE;QACD,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,YAAY,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,MAAM,CAAC,EAAE,MAAM,UAAU,CAAA;QACzB,uFAAuF;QACvF,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;KAC3B;IAQK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAY,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCnG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA4F7B;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,aAOhB,CAAA;AAEF,4EAA4E;AAC5E,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAkBrD,CAAA"}

package/dist/server/server-connection.js

@@ -0,0 +1,195 @@
+import { connect } from "node:net";
+import { Opcode } from "../generated/opcodes.generated.js";
+import { Connection, ProtocolError } from "../protocol/connection.js";
+import { asId } from "../protocol/frame.js";
+import { startSession } from "../session/handshake.js";
+import { buildRequest } from "../spec/index.js";
+import { fromLine, lineReader, toLine } from "./lines.js";
+/**
+ * **A command's connection that goes through `max serve`** when one is running (`MAX-16`).
+ *
+ * INIT and LOGIN are answered by the server's own login, so the command logs in without logging
+ * in. Reads go through the server's connection. **Anything else — a send, a reaction — makes this
+ * open a connection of its own and log in on it**, so it passes the send guards exactly as it does
+ * without a server (`NEED-185`). No server, a stale login, or a server that stops answering: the
+ * whole command falls back to its own connection before it has sent anything.
+ */
+export class ServerConnection {
+    #path;
+    #store;
+    #timeoutMs;
+    #direct;
+    #onUnreachable;
+    #pending = new Map();
+    #socket;
+    #id = 0;
+    #login;
+    /** What the client sent as INIT; a fallback at LOGIN has to send it first, or MAX refuses. */
+    #init;
+    #own;
+    #ownLoggedIn = false;
+    constructor({ path, store, timeoutMs = 30_000, direct, onUnreachable, }) {
+        this.#onUnreachable = onUnreachable;
+        this.#path = path;
+        this.#store = store;
+        this.#timeoutMs = timeoutMs;
+        this.#direct = direct ?? (() => new Connection({ timeoutMs }));
+    }
+    async open() { }
+    async invoke(opcode, payload = {}, watch) {
+        if (this.#own)
+            return this.#ownRequest(opcode, payload, watch);
+        if (opcode === Opcode.SESSION_INIT) {
+            this.#init = payload;
+            this.#login = await this.#ask({ login: true }).catch((error) => {
+                if (error.code === "ECONNREFUSED" || error.code === "ENOENT")
+                    this.#onUnreachable?.();
+                return undefined;
+            });
+            if (!this.#login)
+                return this.#fallBack(opcode, payload, watch);
+            return {};
+        }
+        if (opcode === Opcode.LOGIN) {
+            // A token being tried out (`max session start`) is not the one the server logged in with, and
+            // a server still logged in as the account this profile had before is not this profile's.
+            if (!this.#login || payload.token !== this.#store.readToken() || !this.#sameAccount(this.#login)) {
+                return this.#fallBack(opcode, payload, watch);
+            }
+            return this.#login;
+        }
+        if (!READS.has(opcode))
+            return this.#ownRequest(opcode, payload, watch);
+        watch?.({ phase: "sent", seq: this.#id + 1, opcode, bytes: 0 });
+        const answer = await this.#ask({ opcode, payload });
+        watch?.({ phase: "received", seq: this.#id, opcode, bytes: 0 });
+        return answer;
+    }
+    #sameAccount(login) {
+        const profile = login.profile;
+        const viewerId = this.#store.readState().viewerId;
+        return viewerId === undefined || asId(profile?.contact?.id) === viewerId;
+    }
+    async close() {
+        for (const { reject, timer } of this.#pending.values()) {
+            clearTimeout(timer);
+            reject(new Error("the connection was closed before max serve answered"));
+        }
+        this.#pending.clear();
+        this.#socket?.destroy();
+        this.#socket = undefined;
+        await this.#own?.close();
+    }
+    /** Before anything was sent: the command simply runs as it would with no server. */
+    async #fallBack(opcode, payload, watch) {
+        this.#socket?.destroy();
+        this.#socket = undefined;
+        this.#own = this.#direct();
+        await this.#own.open();
+        if (opcode === Opcode.LOGIN && this.#init)
+            await this.#own.invoke(Opcode.SESSION_INIT, this.#init);
+        this.#ownLoggedIn = opcode === Opcode.LOGIN;
+        return this.#own.invoke(opcode, payload, watch);
+    }
+    /** A write mid-command: a connection of its own, logged in, then the request. */
+    async #ownRequest(opcode, payload, watch) {
+        if (!this.#own) {
+            this.#own = this.#direct();
+            await this.#own.open();
+        }
+        const own = this.#own;
+        if (!this.#ownLoggedIn && opcode !== Opcode.SESSION_INIT && opcode !== Opcode.LOGIN) {
+            const token = this.#store.readToken() ?? "";
+            await startSession((operation, request) => own.invoke(operation.opcode, buildRequest(operation, request)), {
+                token,
+                deviceId: this.#store.readState().deviceId,
+            });
+            this.#ownLoggedIn = true;
+        }
+        if (opcode === Opcode.LOGIN)
+            this.#ownLoggedIn = true;
+        return own.invoke(opcode, payload, watch);
+    }
+    async #ask(request) {
+        const socket = await this.#connected();
+        this.#id += 1;
+        const id = this.#id;
+        const answer = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.#pending.delete(id);
+                reject(new Error(`max serve did not answer within ${this.#timeoutMs}ms`));
+            }, this.#timeoutMs);
+            this.#pending.set(id, { resolve, reject, timer });
+            socket.write(toLine({ id, ...request }));
+        });
+        const error = answer.error;
+        if (error?.code === "refused") {
+            throw new ProtocolError(error.message ?? "MAX refused it", Number(request.opcode), error.payload ?? null);
+        }
+        if (error)
+            throw new Error(error.message ?? "max serve could not do it");
+        return (answer.payload ?? {});
+    }
+    async #connected() {
+        if (this.#socket)
+            return this.#socket;
+        const socket = connect(this.#path);
+        await new Promise((resolve, reject) => {
+            socket.once("connect", () => resolve());
+            socket.once("error", reject);
+        });
+        socket.on("data", lineReader((line) => {
+            const answer = fromLine(line);
+            const waiting = this.#pending.get(Number(answer.id));
+            if (!waiting)
+                return;
+            clearTimeout(waiting.timer);
+            this.#pending.delete(Number(answer.id));
+            waiting.resolve(answer);
+        }));
+        socket.on("error", () => { });
+        socket.on("close", () => {
+            for (const { reject, timer } of this.#pending.values()) {
+                clearTimeout(timer);
+                reject(new Error("max serve went away"));
+            }
+            this.#pending.clear();
+            this.#socket = undefined;
+        });
+        this.#socket = socket;
+        return socket;
+    }
+}
+/**
+ * What a command may ask for through the server — the server allows exactly these. **Nothing here
+ * changes anything**: sending, reacting, marking read and deleting never come this way, so no
+ * guard can be walked around.
+ */
+export const READS = new Set([
+    Opcode.CHAT_HISTORY,
+    Opcode.CHATS_LIST,
+    Opcode.CONTACT_INFO,
+    Opcode.FILE_DOWNLOAD,
+    Opcode.VIDEO_PLAY,
+    Opcode.MSG_GET_REACTIONS,
+]);
+/** Asks a running server to stop. Resolves whether or not one was there. */
+export const stopServer = (path) => new Promise((resolve) => {
+    const socket = connect(path);
+    const timer = setTimeout(() => {
+        socket.destroy();
+        resolve(false);
+    }, 2000);
+    socket.once("connect", () => socket.write(toLine({ id: 1, stop: true })));
+    // Nobody reads the answer, and a socket nobody reads never sees its end, so never closes.
+    socket.resume();
+    socket.once("error", () => {
+        clearTimeout(timer);
+        resolve(false);
+    });
+    socket.once("close", () => {
+        clearTimeout(timer);
+        resolve(true);
+    });
+});
+//# sourceMappingURL=server-connection.js.map

package/dist/server/server-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-connection.js","sourceRoot":"","sources":["../../src/server/server-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAA6B,MAAM,2BAA2B,CAAA;AAChG,OAAO,EAAE,IAAI,EAAgB,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAQzD;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAClB,KAAK,CAAQ;IACb,MAAM,CAAc;IACpB,UAAU,CAAQ;IAClB,OAAO,CAAkB;IACzB,cAAc,CAA0B;IACxC,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC9C,OAAO,CAAoB;IAC3B,GAAG,GAAG,CAAC,CAAA;IACP,MAAM,CAAqB;IAC3B,8FAA8F;IAC9F,KAAK,CAAqB;IAC1B,IAAI,CAAwB;IAC5B,YAAY,GAAG,KAAK,CAAA;IAEpB,YAAY,EACV,IAAI,EACJ,KAAK,EACL,SAAS,GAAG,MAAM,EAClB,MAAM,EACN,aAAa,GAQd;QACC,IAAI,CAAC,cAAc,GAAG,aAAa,CAAA;QACnC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAA;QAC3B,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;IAChE,CAAC;IAED,KAAK,CAAC,IAAI,KAAmB,CAAC;IAE9B,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,UAAmB,EAAE,EAAE,KAAkC;QACpF,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;QAE9D,IAAI,MAAM,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAA;YACpB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;gBACpF,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;oBAAE,IAAI,CAAC,cAAc,EAAE,EAAE,CAAA;gBACrF,OAAO,SAAS,CAAA;YAClB,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;YAC/D,OAAO,EAAE,CAAA;QACX,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5B,8FAA8F;YAC9F,yFAAyF;YACzF,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjG,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;YAC/C,CAAC;YACD,OAAO,IAAI,CAAC,MAAM,CAAA;QACpB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;QAEvE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;QACnD,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QAC/D,OAAO,MAAM,CAAA;IACf,CAAC;IAED,YAAY,CAAC,KAAc;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAqD,CAAA;QAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAA;QACjD,OAAO,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAA;IAC1E,CAAC;IAED,KAAK,CAAC,KAAK;QACT,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACvD,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,CAAC,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC,CAAA;QAC1E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;QACrB,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QACxB,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;IAC1B,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,OAAgB,EAAE,KAAkC;QAClF,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;QAC1B,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QACtB,IAAI,MAAM,KAAK,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAClG,IAAI,CAAC,YAAY,GAAG,MAAM,KAAK,MAAM,CAAC,KAAK,CAAA;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IACjD,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,OAAgB,EAAE,KAAkC;QACpF,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YAC1B,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QACxB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,MAAM,KAAK,MAAM,CAAC,YAAY,IAAI,MAAM,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YACpF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,CAAA;YAC3C,MAAM,YAAY,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE;gBACzG,KAAK;gBACL,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ;aAC3C,CAAC,CAAA;YACF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QAC1B,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,CAAC,KAAK;YAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QACrD,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAgC;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACtC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACb,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAA;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5E,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAA;YAC3E,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;YACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;YACjD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;QAEF,MAAM,KAAK,GAAG,MAAM,CAAC,KAA2E,CAAA;QAChG,IAAI,KAAK,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,OAAO,IAAI,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAA;QAC3G,CAAC;QACD,IAAI,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,2BAA2B,CAAC,CAAA;QACxE,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAY,CAAA;IAC1C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAA;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;YACvC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;QACF,MAAM,CAAC,EAAE,CACP,MAAM,EACN,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;YACpD,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;YACvC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACzB,CAAC,CAAC,CACH,CAAA;QACD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC5B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACvD,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnB,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAA;YAC1C,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;YACrB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QAC1B,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS;IACnC,MAAM,CAAC,YAAY;IACnB,MAAM,CAAC,UAAU;IACjB,MAAM,CAAC,YAAY;IACnB,MAAM,CAAC,aAAa;IACpB,MAAM,CAAC,UAAU;IACjB,MAAM,CAAC,iBAAiB;CACzB,CAAC,CAAA;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAoB,EAAE,CAC3D,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,MAAM,CAAC,OAAO,EAAE,CAAA;QAChB,OAAO,CAAC,KAAK,CAAC,CAAA;IAChB,CAAC,EAAE,IAAI,CAAC,CAAA;IACR,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IACzE,0FAA0F;IAC1F,MAAM,CAAC,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACxB,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,OAAO,CAAC,KAAK,CAAC,CAAA;IAChB,CAAC,CAAC,CAAA;IACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACxB,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/server/server.d.ts

@@ -0,0 +1,62 @@
+import type { CacheStore } from "../cache/store.js";
+import { type MaxClientOptions } from "../client.js";
+import type { MessageHit } from "../domain/models.js";
+import { Connection, type ConnectionOptions } from "../protocol/connection.js";
+import type { SessionStore } from "../session/store.js";
+export type ServerEvent = {
+    event: "message";
+    message: MessageHit;
+} | {
+    event: "status";
+    connected: boolean;
+    at: string;
+};
+export interface MaxServerOptions {
+    store: SessionStore;
+    cache?: CacheStore;
+    timeoutMs?: number;
+    /** One line for a person, on stderr. */
+    note: (line: string) => void;
+    /** Tests hand in a scripted MAX; the hooks must reach it. */
+    connection?: (hooks: Pick<ConnectionOptions, "onEvent" | "onClose">) => Connection;
+    pingEveryMs?: number;
+    /** The least time between two background logins after the snapshot went stale. */
+    refreshEveryMs?: number;
+    retryAfterMs?: (attempt: number) => number;
+    /**
+     * Stop after this long with nobody using it — no request, no `max watch`. Absent, it runs until
+     * stopped; a server started by a command gets one, or it would outlive every reason it had.
+     */
+    idleMs?: number;
+    /** One event per request, for `--trace` and the run log — pings included. */
+    events?: MaxClientOptions["events"];
+}
+/**
+ * **One logged-in connection per profile, kept open** (`MAX-16`), and a Unix socket beside the
+ * profile's state for local readers.
+ *
+ * It reopens REQUIREMENTS §3 and §18 on purpose and only here: every other command stays one-shot.
+ * What it does on the wire copies web.max.ru — a ping every 30 s, MAX's pings answered, each new
+ * message acknowledged (`Connection` with `live`). It never marks anything read and never sends.
+ *
+ * The socket answers `{"subscribe": true}` with a stream of `ServerEvent` lines and
+ * `{"status": true}` with one. For a command reusing the connection (`ServerConnection`) it answers
+ * `{"id", "login": true}` with the login it holds, and `{"id", "opcode", "payload"}` by passing the
+ * request to MAX — **reads only** (`NEED-185`). Anything that writes goes on the command's own
+ * connection, through the send guards, which live in the client and nowhere else.
+ */
+export declare class MaxServer {
+    #private;
+    /** Settles when the server stops — cleanly, or with the error that stopped it. */
+    readonly done: Promise<void>;
+    constructor(options: MaxServerOptions);
+    get connected(): boolean;
+    /** Logs in first: a token that does not work should fail here, before anything listens. */
+    start(): Promise<void>;
+    stop(error?: Error): Promise<void>;
+}
+/** Present while a server is being started in the background, so two commands do not start two. */
+export declare const startingPath: (store: SessionStore) => string;
+/** Whether something is listening on the socket — a live server, not a leftover file. */
+export declare const answers: (path: string) => Promise<boolean>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAiB,MAAM,2BAA2B,CAAA;AAC7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAIvD,MAAM,MAAM,WAAW,GACnB;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GACzC;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wCAAwC;IACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,SAAS,CAAC,KAAK,UAAU,CAAA;IAClF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;IAC1C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;CACpC;AAQD;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAS;;IAgBpB,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;gBAEhB,OAAO,EAAE,gBAAgB;IAOrC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,2FAA2F;IACrF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtB,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAkNzC;AAKD,mGAAmG;AACnG,eAAO,MAAM,YAAY,GAAI,OAAO,YAAY,KAAG,MAA0C,CAAA;AAE7F,yFAAyF;AACzF,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAQlD,CAAA"}