@oatelauser/crosschat 1.4.0 → 1.5.0

package/dist/serve/file-channel.js

@@ -0,0 +1,211 @@
+/**
+ * 文件通道（票B B2）：接收侧 FileInbox——inbox 收 whole 文件、parts 暂存
+ * 分块与断点锚。发送侧的分块循环在 via-tcp.ts，这里只有两端共用的常量、
+ * 文件名安全化与接收状态机。路径约定：~/.crosschat/tcp/{inbox,parts}/。
+ */
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { Buffer } from 'node:buffer';
+/** 单文件上限 64MiB（发送侧读文件时与 broker file-begin 预拒同用此值）。 */
+export const FILE_MAX_BYTES = 64 * 1024 * 1024;
+/** 分块大小 256KiB（base64 后约 350KB，留在一帧 2MiB 上限内）。 */
+export const FILE_CHUNK_BYTES = 256 * 1024;
+/** 懒删除：inbox/parts 落盘超 5 天视为残迹。 */
+export const FILE_STALE_MS = 5 * 24 * 3_600_000;
+/** 懒删除：inbox 总量超 512MiB 从最旧删起。 */
+export const INBOX_MAX_BYTES = 512 * 1024 * 1024;
+/** 原名剥离目录成分与 Windows 危险字符，空则兜底 'file'。 */
+export function safeFileName(name) {
+    const base = name.split(/[\\/]/).pop() ?? '';
+    // eslint-disable-next-line no-control-regex -- 控制字符必须一并剥掉
+    const cleaned = base.replace(/[/\\:*?"<>|\u0000-\u001f]/g, '_').trim();
+    return cleaned === '' || cleaned === '.' || cleaned === '..' ? 'file' : cleaned;
+}
+/** 接收完成后的最终路径：inbox/<sha 前 8>-<安全化原名>。 */
+export function inboxPathFor(inboxDir, sha256, name) {
+    return join(inboxDir, `${sha256.slice(0, 8)}-${safeFileName(name)}`);
+}
+/**
+ * 一次 file-begin..file-end 的接收状态机（多 id 并发各写各的 parts 文件）。
+ * 断点锚 parts/&lt;sha&gt;.part.json{nextSeq} 每块落盘后更新——传输中断后
+ * 重新 begin 会拿到 resumeFrom=nextSeq，发方从该块续传。
+ */
+export class FileInbox {
+    dirs;
+    now;
+    transfers = new Map();
+    constructor(dirs, now = () => Date.now()) {
+        this.dirs = dirs;
+        this.now = now;
+    }
+    /** file-begin 应答：去重秒回 / 断点续传锚 / 全新开始（顺带懒删除）。 */
+    begin(frame) {
+        this.lazyDelete();
+        const { sha256, name, size } = frame;
+        const finalPath = inboxPathFor(this.dirs.inboxDir, sha256, name);
+        if (existsSync(finalPath)) {
+            return { op: 'file-result', id: frame.id, ok: true, path: finalPath, dedup: true };
+        }
+        this.transfers.set(frame.id, { sha256, name, size });
+        const anchor = this.readAnchor(sha256);
+        if (anchor !== undefined && anchor.nextSeq > 0) {
+            return { op: 'file-result', id: frame.id, ok: true, resumeFrom: anchor.nextSeq };
+        }
+        // 无锚或锚损坏：清掉可能存在的残片，从零开始（残片混写必致 sha 失败）
+        this.cleanup(sha256);
+        this.writeAnchor(sha256, 0);
+        return { op: 'file-result', id: frame.id, ok: true, resumeFrom: 0 };
+    }
+    /** 顺序落盘一块；seq 必须等于锚的 nextSeq（发方遵守 resumeFrom 时恒真）。 */
+    chunk(frame) {
+        const t = this.transfers.get(frame.id);
+        if (t === undefined)
+            return false;
+        const anchor = this.readAnchor(t.sha256);
+        if (anchor === undefined || anchor.nextSeq !== frame.seq)
+            return false;
+        let bytes;
+        try {
+            bytes = Buffer.from(frame.bytes, 'base64');
+        }
+        catch {
+            return false;
+        }
+        mkdirSync(this.dirs.partsDir, { recursive: true });
+        appendFileSync(this.partFile(t.sha256), bytes);
+        this.writeAnchor(t.sha256, frame.seq + 1);
+        return true;
+    }
+    /** file-end：sha256 校验 → 改名转正 → 清残片；失败删残片要求整档重传。 */
+    end(id) {
+        const t = this.transfers.get(id);
+        if (t === undefined) {
+            return { op: 'file-result', id, ok: false, error: '未知传输 id（可能已被清理）' };
+        }
+        this.transfers.delete(id);
+        const part = this.partFile(t.sha256);
+        let ok = false;
+        try {
+            ok = existsSync(part) && sha256File(part) === t.sha256;
+        }
+        catch {
+            ok = false;
+        }
+        if (!ok) {
+            this.cleanup(t.sha256);
+            return {
+                op: 'file-result',
+                id,
+                ok: false,
+                error: 'sha256 校验失败——残片已清理，请整档重传（重跑同一命令即可）',
+            };
+        }
+        const finalPath = inboxPathFor(this.dirs.inboxDir, t.sha256, t.name);
+        mkdirSync(this.dirs.inboxDir, { recursive: true });
+        // 同名不同 sha 不可能（sha 在文件名里）；同 sha 同名已提前 dedup
+        renameSync(part, finalPath);
+        this.cleanup(t.sha256);
+        return { op: 'file-result', id, ok: true, path: finalPath };
+    }
+    partFile(sha) {
+        return join(this.dirs.partsDir, `${sha}.part`);
+    }
+    anchorFile(sha) {
+        return join(this.dirs.partsDir, `${sha}.part.json`);
+    }
+    /** 无锚/锚损坏统一 undefined（损坏时 begin 会连残片一起清掉重来）。 */
+    readAnchor(sha) {
+        try {
+            const parsed = JSON.parse(readFileSync(this.anchorFile(sha), 'utf8'));
+            return typeof parsed?.nextSeq === 'number' ? { nextSeq: parsed.nextSeq } : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    writeAnchor(sha, nextSeq) {
+        mkdirSync(this.dirs.partsDir, { recursive: true });
+        writeFileSync(this.anchorFile(sha), `${JSON.stringify({ nextSeq })}\n`, 'utf8');
+    }
+    cleanup(sha) {
+        rmSync(this.partFile(sha), { force: true });
+        rmSync(this.anchorFile(sha), { force: true });
+    }
+    /**
+     * 懒删除（每次 file-begin 顺带执行）：inbox 落盘 >5 天删；inbox 总量
+     * >512MiB 从最旧删起；parts 残片同 5 天规则。best-effort——单文件删除
+     * 失败不阻断传输。
+     */
+    lazyDelete() {
+        const cutoff = this.now() - FILE_STALE_MS;
+        const statOf = (file) => {
+            try {
+                const s = statSync(file);
+                return { mtime: s.mtimeMs, size: s.size };
+            }
+            catch {
+                return undefined;
+            }
+        };
+        try {
+            const entries = readdirSync(this.dirs.inboxDir).map((f) => ({
+                file: join(this.dirs.inboxDir, f),
+                ...statOf(join(this.dirs.inboxDir, f)),
+            }));
+            for (const e of entries) {
+                if (e.mtime !== undefined && e.mtime < cutoff) {
+                    try {
+                        rmSync(e.file, { force: true });
+                    }
+                    catch { /* best-effort */ }
+                }
+            }
+            const live = entries
+                .filter((e) => e.mtime !== undefined && e.mtime >= cutoff && existsSync(e.file))
+                .sort((a, b) => a.mtime - b.mtime);
+            let total = live.reduce((sum, e) => sum + (e.size ?? 0), 0);
+            for (const e of live) {
+                if (total <= INBOX_MAX_BYTES)
+                    break;
+                try {
+                    rmSync(e.file, { force: true });
+                    total -= e.size ?? 0;
+                }
+                catch { /* best-effort */ }
+            }
+        }
+        catch {
+            // inbox 目录不存在等——首份文件会建目录
+        }
+        try {
+            for (const f of readdirSync(this.dirs.partsDir)) {
+                const file = join(this.dirs.partsDir, f);
+                const s = statOf(file);
+                if (s !== undefined && s.mtime < cutoff) {
+                    try {
+                        rmSync(file, { force: true });
+                    }
+                    catch { /* best-effort */ }
+                }
+            }
+        }
+        catch {
+            // parts 目录不存在——忽略
+        }
+    }
+}
+function sha256File(file) {
+    return createHash('sha256').update(readFileSync(file)).digest('hex');
+}
+/** 发送侧文件读取 + 摘要（64MiB 预检在调用方）。 */
+export function readFileForSend(path) {
+    const bytes = readFileSync(path);
+    return {
+        bytes,
+        sha256: createHash('sha256').update(bytes).digest('hex'),
+        name: (path.split(/[\\/]/).pop() ?? 'file'),
+        size: bytes.length,
+    };
+}
+//# sourceMappingURL=file-channel.js.map

package/dist/serve/file-channel.js.map

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

package/dist/serve/node.js

@@ -0,0 +1,340 @@
+/**
+ * 节点客户端（票B B2）：`crosschat serve --connect` 的常驻腿——连 broker、
+ * 收 deliver 帧进程内调 runSend（与 ssh 远端 CLI 同权：会话状态/限流/发件箱
+ * 全是本机既有行为）、收 file-* 帧落盘 inbox。断线指数退避 1s→2s→…封顶
+ * 60s 永不放弃；连续失败 ≥5 分钟进静音模式（日志每 10 次一条）。
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { WebSocket } from 'ws';
+import { MultichatError } from '../errors.js';
+import { encodeFrame, MAX_PAYLOAD_BYTES, parseFrame, PROTOCOL_VERSION } from './protocol.js';
+import { runSend } from '../commands/send.js';
+/** 会员凭证缺失/损坏的教学报错（send --via tcp: 与 --connect 同用）。 */
+export const NOT_JOINED_MESSAGE = '本机未入网——向管理员索取 node.json 放到 ~/.crosschat/tcp/（broker 机上 crosschat serve --gen-key 生成）';
+export function readNodeConfig(configFile) {
+    let raw;
+    try {
+        raw = readFileSync(configFile, 'utf8');
+    }
+    catch {
+        throw new MultichatError('USAGE', NOT_JOINED_MESSAGE);
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== 'object' ||
+            typeof parsed.key !== 'string' || parsed.key === '' ||
+            typeof parsed.broker?.host !== 'string' || !Number.isInteger(parsed.broker.port)) {
+            throw new Error('bad shape');
+        }
+        return parsed;
+    }
+    catch {
+        throw new MultichatError('USAGE', `node.json 损坏（${configFile}）——向管理员重新索取覆盖；${NOT_JOINED_MESSAGE}`);
+    }
+}
+/**
+ * deliver 帧 → 本机 runSend（broker 侧 deliverLocal 同用此桥）：
+ * payload=正文，to/conversation/origin 透传；origin 是发送机的
+ * encodeOriginIdentity 编码（ssh 远端 CLI 的 --origin 同语义）。
+ */
+export async function deliverViaRunSend(frame, deps) {
+    let output;
+    try {
+        output = await runSend({
+            to: frame.to,
+            conversation: frame.conversation,
+            bodyArg: frame.payload,
+            origin: frame.origin,
+            json: true,
+        }, deps);
+    }
+    catch (err) {
+        if (err instanceof MultichatError) {
+            return { op: 'result', id: frame.id, status: 'error', code: err.code, message: err.message };
+        }
+        return {
+            op: 'result',
+            id: frame.id,
+            status: 'error',
+            code: 'INTERNAL',
+            message: err instanceof Error ? err.message : String(err),
+        };
+    }
+    // runSend --json 输出：{status,to,turn,replyRef[,queue,mailbox]}
+    try {
+        const receipt = JSON.parse(output);
+        return {
+            op: 'result',
+            id: frame.id,
+            status: receipt.status,
+            turn: receipt.turn === undefined ? undefined : String(receipt.turn),
+            replyRef: receipt.replyRef,
+            output,
+        };
+    }
+    catch {
+        return { op: 'result', id: frame.id, status: 'error', code: 'INTERNAL', message: `本机回执不是 JSON: ${output.slice(0, 200)}` };
+    }
+}
+export class NodeClient {
+    d;
+    stopped = false;
+    ws;
+    state = 'connecting';
+    stateSince = 0;
+    frameWaiters = [];
+    /** 本连接已收帧（open 与 nextFrame 注册之间到达的帧先落此，注册时回查）。 */
+    frameLog = [];
+    stateWaiters = [];
+    minuteTimer;
+    mainLoop;
+    stopResolve;
+    constructor(deps) {
+        this.d = { backoffBaseMs: 1_000, quietAfterMs: 300_000, ...deps };
+    }
+    /** 阻塞跑直到 stop（serve --connect 前台姿态）。 */
+    async run() {
+        this.d.onSignal?.('SIGINT', () => void this.stop());
+        this.d.onSignal?.('SIGTERM', () => void this.stop());
+        this.mainLoop = this.loop();
+        await new Promise((resolve) => {
+            this.stopResolve = resolve;
+        });
+        await this.mainLoop;
+    }
+    /** 停主循环、关连接（幂等）；打断退避睡眠立即返回。 */
+    async stop() {
+        if (this.stopped) {
+            await this.mainLoop?.catch(() => { });
+            return;
+        }
+        this.stopped = true;
+        this.clearFrameWaiters(new Error('stopped'));
+        try {
+            this.ws?.close(1000, 'node stopping');
+        }
+        catch { /* 竞态关闭忽略 */ }
+        clearInterval(this.minuteTimer);
+        this.stopResolve?.();
+        await this.mainLoop?.catch(() => { });
+    }
+    /** 等到指定状态（测试用）；超时拒绝。 */
+    waitForState(state, timeoutMs = 5_000) {
+        if (this.state === state)
+            return Promise.resolve();
+        return new Promise((resolve, reject) => {
+            const waiter = {
+                state,
+                resolve,
+                timer: setTimeout(() => {
+                    const i = this.stateWaiters.indexOf(waiter);
+                    if (i >= 0)
+                        this.stateWaiters.splice(i, 1);
+                    reject(new Error(`waitForState(${state}) timeout`));
+                }, timeoutMs),
+            };
+            this.stateWaiters.push(waiter);
+        });
+    }
+    async loop() {
+        let attempt = 0;
+        let firstFailAt;
+        while (!this.stopped) {
+            this.setState('connecting');
+            const everOnline = await this.connectOnce();
+            if (this.stopped)
+                break;
+            attempt = everOnline ? 0 : attempt + 1;
+            if (attempt === 1)
+                firstFailAt = this.d.now();
+            const failedFor = firstFailAt === undefined ? 0 : this.d.now() - firstFailAt;
+            const quiet = failedFor >= this.d.quietAfterMs;
+            const delay = Math.min(this.d.backoffBaseMs * 2 ** Math.max(0, attempt - 1), 60_000);
+            if (!quiet || attempt % 10 === 1) {
+                this.log(`reconnect-wait 第 ${attempt} 次失败后 ${delay}ms 再试（连续失败 ${Math.round(failedFor / 1000)}s）`);
+            }
+            this.setState('reconnect-wait');
+            this.writeStatus(this.d.now() + delay);
+            await this.sleepInterruptible(delay);
+        }
+    }
+    /** 一次连接生命周期；resolve(false)=从未上线即断，resolve(true)=上线后断开。 */
+    async connectOnce() {
+        const cfg = this.d.config;
+        const url = `ws://${cfg.broker.host}:${cfg.broker.port}`;
+        this.frameLog = [];
+        const ws = new WebSocket(url, { maxPayload: MAX_PAYLOAD_BYTES });
+        this.ws = ws;
+        let everOnline = false;
+        let closed = () => { };
+        const closedPromise = new Promise((resolve) => {
+            closed = resolve;
+        });
+        ws.once('close', () => closed());
+        ws.once('error', () => closed());
+        ws.on('message', (data) => {
+            void this.onFrame(data.toString());
+        });
+        try {
+            await new Promise((resolve, reject) => {
+                const t = setTimeout(() => reject(new Error('connect timeout')), 15_000);
+                ws.once('open', () => { clearTimeout(t); resolve(); });
+                ws.once('error', (err) => { clearTimeout(t); reject(err); });
+            });
+            const info = await this.nextFrame((f) => f.op === 'info', 10_000);
+            if (info.op !== 'info' || info.proto !== PROTOCOL_VERSION) {
+                throw new Error(`协议不匹配：服务端 ${info.op === 'info' ? info.proto : '?'}`);
+            }
+            ws.send(encodeFrame({
+                op: 'connect',
+                proto: PROTOCOL_VERSION,
+                role: 'node',
+                machineId: this.d.machineId() ?? '',
+                auth: cfg.key,
+                ...(cfg.name === undefined ? {} : { name: cfg.name }),
+            }));
+            const verdict = await this.nextFrame((f) => f.op === 'connected' || f.op === 'error', 10_000);
+            if (verdict.op === 'error') {
+                throw new Error(`broker 拒绝: ${verdict.code} ${verdict.message}`);
+            }
+            everOnline = true;
+            this.setState('online');
+            this.log(`online（broker ${cfg.broker.alias ?? url}）`);
+            this.minuteTimer = setInterval(() => {
+                if (this.state === 'online')
+                    this.writeStatus(undefined);
+            }, 60_000);
+            await closedPromise;
+            this.log('offline（连接断开）');
+        }
+        catch (err) {
+            this.log(`connect 失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            clearInterval(this.minuteTimer);
+            this.clearFrameWaiters(new Error('connection closed'));
+            try {
+                ws.close();
+            }
+            catch { /* 已断开 */ }
+            if (this.ws === ws)
+                this.ws = undefined;
+        }
+        return everOnline;
+    }
+    async onFrame(text) {
+        const frame = parseFrame(text);
+        if (frame === undefined)
+            return;
+        this.frameLog.push(frame);
+        for (let i = 0; i < this.frameWaiters.length; i++) {
+            const w = this.frameWaiters[i];
+            if (w.pred(frame)) {
+                clearTimeout(w.timer);
+                this.frameWaiters.splice(i, 1);
+                w.resolve(frame);
+                return;
+            }
+        }
+        if (frame.op === 'deliver') {
+            void this.onDeliver(frame);
+            return;
+        }
+        if (frame.op === 'file-begin' || frame.op === 'file-chunk' || frame.op === 'file-end') {
+            this.onFile(frame);
+        }
+    }
+    async onDeliver(frame) {
+        const result = await deliverViaRunSend(frame, this.d.makeSendDeps());
+        this.send(result);
+        this.log(`deliver ${frame.id} → ${result.status}${result.status === 'error' ? ` (${result.code})` : ''}`);
+    }
+    onFile(frame) {
+        if (frame.op === 'file-begin') {
+            this.send(this.d.fileInbox.begin(frame));
+            return;
+        }
+        if (frame.op === 'file-chunk') {
+            if (!this.d.fileInbox.chunk(frame)) {
+                this.send({ op: 'file-result', id: frame.id, ok: false, error: '分块失序或未知 id——请重新 begin 续传' });
+            }
+            return;
+        }
+        const res = this.d.fileInbox.end(frame.id);
+        this.send(res);
+        this.log(`file ${frame.id} ${res.ok ? `→ ${res.path}` : `失败: ${res.error}`}`);
+    }
+    nextFrame(pred, timeoutMs) {
+        const seen = this.frameLog.find(pred);
+        if (seen !== undefined)
+            return Promise.resolve(seen);
+        return new Promise((resolve, reject) => {
+            const waiter = {
+                pred,
+                resolve,
+                reject,
+                timer: setTimeout(() => {
+                    const i = this.frameWaiters.indexOf(waiter);
+                    if (i >= 0)
+                        this.frameWaiters.splice(i, 1);
+                    reject(new Error('frame timeout'));
+                }, timeoutMs),
+            };
+            this.frameWaiters.push(waiter);
+        });
+    }
+    clearFrameWaiters(err) {
+        for (const w of this.frameWaiters.splice(0)) {
+            clearTimeout(w.timer);
+            w.reject(err);
+        }
+    }
+    send(frame) {
+        if (this.ws !== undefined && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(encodeFrame(frame));
+        }
+    }
+    setState(state) {
+        this.state = state;
+        this.stateSince = this.d.now();
+        this.writeStatus(undefined);
+        for (let i = this.stateWaiters.length - 1; i >= 0; i--) {
+            const w = this.stateWaiters[i];
+            if (w.state !== state)
+                continue;
+            clearTimeout(w.timer);
+            this.stateWaiters.splice(i, 1);
+            w.resolve();
+        }
+    }
+    writeStatus(nextAttemptAt) {
+        const status = {
+            state: this.state,
+            brokerAlias: this.d.config.broker.alias ?? `${this.d.config.broker.host}:${this.d.config.broker.port}`,
+            since: new Date(this.stateSince).toISOString(),
+            lastUpdated: new Date(this.d.now()).toISOString(),
+            ...(nextAttemptAt === undefined ? {} : { nextAttemptAt: new Date(nextAttemptAt).toISOString() }),
+        };
+        try {
+            mkdirSync(dirname(this.d.statusFile), { recursive: true });
+            writeFileSync(this.d.statusFile, `${JSON.stringify(status, null, 2)}\n`, 'utf8');
+        }
+        catch {
+            // 状态文件写失败不倒客户端
+        }
+    }
+    /** 退避睡眠可被 stop 打断（100ms 片轮询），避免 SIGINT 卡最长 60s。 */
+    async sleepInterruptible(ms) {
+        let left = ms;
+        while (left > 0 && !this.stopped) {
+            const slice = Math.min(left, 100);
+            await new Promise((resolve) => setTimeout(resolve, slice));
+            left -= slice;
+        }
+    }
+    log(event) {
+        this.d.log(`${new Date(this.d.now()).toISOString()} ${event}`);
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/serve/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/serve/node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAU7F,OAAO,EAAE,OAAO,EAAiB,MAAM,qBAAqB,CAAC;AAU7D,sDAAsD;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAC7B,sFAAsF,CAAC;AAEzF,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA+B,CAAC;QAC7D,IACE,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;YAC7C,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,KAAK,EAAE;YACnD,OAAO,MAAM,CAAC,MAAM,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAChF,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,MAAoB,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,gBAAgB,UAAU,iBAAiB,kBAAkB,EAAE,CAAC,CAAC;IACrG,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAmB,EAAE,IAAc;IACzE,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CACpB;YACE,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,IAAI;SACX,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC/F,CAAC;QACD,OAAO;YACL,EAAE,EAAE,QAAQ;YACZ,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAC1D,CAAC;IACJ,CAAC;IACD,8DAA8D;IAC9D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAoF,CAAC;QACtH,OAAO;YACL,EAAE,EAAE,QAAQ;YACZ,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;YACnE,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAC5H,CAAC;AACH,CAAC;AAsCD,MAAM,OAAO,UAAU;IACJ,CAAC,CAAmE;IAC7E,OAAO,GAAG,KAAK,CAAC;IAChB,EAAE,CAAa;IACf,KAAK,GAA4B,YAAY,CAAC;IAC9C,UAAU,GAAG,CAAC,CAAC;IACN,YAAY,GAAkB,EAAE,CAAC;IAClD,kDAAkD;IAC1C,QAAQ,GAAY,EAAE,CAAC;IACd,YAAY,GAAkB,EAAE,CAAC;IAC1C,WAAW,CAAkC;IAC7C,QAAQ,CAAiB;IACzB,WAAW,CAAc;IAEjC,YAAY,IAAoB;QAC9B,IAAI,CAAC,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACpE,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACxB,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,wBAAwB;IACxB,YAAY,CAAC,KAA8B,EAAE,SAAS,GAAG,KAAK;QAC5D,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACnD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAgB;gBAC1B,KAAK;gBACL,OAAO;gBACP,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE;oBACrB,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBAC5C,IAAI,CAAC,IAAI,CAAC;wBAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC3C,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,KAAK,WAAW,CAAC,CAAC,CAAC;gBACtD,CAAC,EAAE,SAAS,CAAC;aACd,CAAC;YACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,WAA+B,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC5B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM;YACxB,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;YACvC,IAAI,OAAO,KAAK,CAAC;gBAAE,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;YAC7E,MAAM,KAAK,GAAG,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACrF,IAAI,CAAC,KAAK,IAAI,OAAO,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,GAAG,CAAC,oBAAoB,OAAO,SAAS,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACpG,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;YACvC,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,0DAA0D;IAClD,KAAK,CAAC,WAAW;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,MAAM,GAAG,GAAG,QAAQ,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,MAAM,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;QAClC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClD,MAAM,GAAG,OAAO,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACjC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACjC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;gBACzE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,MAAM,CAAC,CAAC;YAClE,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,gBAAgB,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;gBAClB,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,gBAAgB;gBACvB,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE;gBACnC,IAAI,EAAE,GAAG,CAAC,GAAG;gBACb,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;aACtD,CAAC,CAAC,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9F,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,cAAe,OAAsB,CAAC,IAAI,IAAK,OAAsB,CAAC,OAAO,EAAE,CAAC,CAAC;YACnG,CAAC;YACD,UAAU,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,GAAG,CAAC,CAAC;YACtD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;gBAClC,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;oBAAE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAC3D,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,MAAM,aAAa,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChC,IAAI,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC;gBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE;gBAAE,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;QAC1C,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAY;QAChC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC;YAChC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClB,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACtB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC/B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,OAAO;YACT,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,EAAE,KAAK,YAAY,IAAI,KAAK,CAAC,EAAE,KAAK,YAAY,IAAI,KAAK,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;YACtF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,KAAmB;QACzC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,IAAI,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5G,CAAC;IAEO,MAAM,CAAC,KAAqD;QAClE,IAAI,KAAK,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAC;YAC/F,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChF,CAAC;IAEO,SAAS,CAAC,IAA2B,EAAE,SAAiB;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAgB;gBAC1B,IAAI;gBACJ,OAAO;gBACP,MAAM;gBACN,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE;oBACrB,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBAC5C,IAAI,CAAC,IAAI,CAAC;wBAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC3C,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;gBACrC,CAAC,EAAE,SAAS,CAAC;aACd,CAAC;YACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,GAAU;QAClC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,KAAY;QACvB,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACnE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,KAA8B;QAC7C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC;YAChC,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK;gBAAE,SAAS;YAChC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/B,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,aAAiC;QACnD,MAAM,MAAM,GAAmB;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YACtG,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE;YAC9C,WAAW,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;YACjD,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;SACjG,CAAC;QACF,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAED,mDAAmD;IAC3C,KAAK,CAAC,kBAAkB,CAAC,EAAU;QACzC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC;IACH,CAAC;IAEO,GAAG,CAAC,KAAa;QACvB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/serve/protocol.js

@@ -0,0 +1,51 @@
+/**
+ * tcp broker 协议层（票B B1）：单文件、客户端服务端共用。JSON 单帧单 ws
+ * 文本消息。B2 才有行为实现的帧（file-* 等）类型先定义全。
+ */
+export const PROTOCOL_VERSION = 1;
+export const MAX_PAYLOAD_BYTES = 2 * 1024 * 1024;
+/** 协议错误码（error.code），与各端报错文案共用。 */
+export const ERR = {
+    BAD_AUTH: 'BAD_AUTH',
+    BAD_PROTO: 'BAD_PROTO',
+    UNKNOWN_MACHINE: 'UNKNOWN_MACHINE',
+    PEER_OFFLINE: 'PEER_OFFLINE',
+    MACHINE_NAME_COLLISION: 'MACHINE_NAME_COLLISION',
+    NOT_READY: 'NOT_READY',
+    /** B2 修订：file-begin 尺寸预拒（>64MiB）。 */
+    FILE_TOO_LARGE: 'FILE_TOO_LARGE',
+};
+const OPS = new Set([
+    'info',
+    'connect',
+    'connected',
+    'error',
+    'send',
+    'receipt',
+    'deliver',
+    'result',
+    'file-begin',
+    'file-chunk',
+    'file-end',
+    'file-result',
+    'roster',
+    'roster-result',
+]);
+/** 解析一帧 ws 文本消息；JSON 损坏或 op 未知返回 undefined（调用方丢弃）。 */
+export function parseFrame(text) {
+    let obj;
+    try {
+        obj = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof obj !== 'object' || obj === null)
+        return undefined;
+    const op = obj.op;
+    return typeof op === 'string' && OPS.has(op) ? obj : undefined;
+}
+export function encodeFrame(frame) {
+    return JSON.stringify(frame);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/serve/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/serve/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,mCAAmC;AACnC,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,sBAAsB,EAAE,wBAAwB;IAChD,SAAS,EAAE,WAAW;IACtB,qCAAqC;IACrC,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAgIX,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;IAClB,MAAM;IACN,SAAS;IACT,WAAW;IACX,OAAO;IACP,MAAM;IACN,SAAS;IACT,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,aAAa;IACb,QAAQ;IACR,eAAe;CAChB,CAAC,CAAC;AAEH,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,GAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}