@tienne/gestalt 0.108.0 → 0.110.0

package/dist/src/peer/transport.js

@@ -0,0 +1,345 @@
+import { EventEmitter } from 'node:events';
+import { signText } from './seal.js';
+import { connectWs } from './ws.js';
+import { CLOSE_REMOVED, helloSigned } from './wire.js';
+import { errMessage } from './errors.js';
+export class RelaySendError extends Error {
+    reason;
+    constructor(reason) {
+        super(reason === 'offline'
+            ? '받는 기기가 릴레이에 안 붙어 있어요'
+            : reason === 'not_connected'
+                ? '릴레이에 안 붙어 있어요'
+                : `릴레이가 전달하지 못했어요: ${reason}`);
+        this.reason = reason;
+        this.name = 'RelaySendError';
+    }
+}
+/**
+ * 릴레이 접속 하나. 이벤트:
+ * - `state`(TransportState)
+ * - `welcome`(roster, online) — member로 붙었다. 다시 붙을 때마다 온다
+ * - `roster`(SignedRoster) — 릴레이가 새 명단을 돌렸다. 받을지는 부른 쪽이 다시 확인한다
+ * - `presence`(key, online)
+ * - `join`(from, sealed) — 관리자에게 온 join 요청
+ * - `relay-error`(code, message)
+ */
+export class RelayTransport extends EventEmitter {
+    options;
+    ws = null;
+    roster = null;
+    status = 'idle';
+    nextId = 1;
+    acks = new Map();
+    resolves = new Map();
+    receivers = [];
+    backoff;
+    retry = null;
+    announced = [];
+    constructor(options) {
+        super();
+        this.options = options;
+        this.backoff = options.minBackoffMs ?? 500;
+    }
+    get state() {
+        return this.status;
+    }
+    get bufferedAmount() {
+        return this.ws?.bufferedAmount ?? 0;
+    }
+    /** 다음 hello에 들고 갈 명단 */
+    setRoster(roster) {
+        this.roster = roster;
+    }
+    /**
+     * 처음 붙는다. member면 welcome, join 모드면 pending까지 기다린다. 첫 시도가 실패하면
+     * 던지고 reconnect가 켜져 있으면 뒤에서 계속 다시 붙는다.
+     */
+    connect(roster) {
+        this.roster = roster;
+        return this.attempt();
+    }
+    onReceive(handler) {
+        this.receivers.push(handler);
+    }
+    send(to, sealed) {
+        return new Promise((resolve, reject) => {
+            const ws = this.ws;
+            if (!ws || this.status !== 'online') {
+                reject(new RelaySendError('not_connected'));
+                return;
+            }
+            const id = this.nextId++;
+            const timer = setTimeout(() => {
+                this.acks.delete(id);
+                reject(new RelaySendError('timeout'));
+            }, this.options.ackTimeoutMs ?? 10_000);
+            timer.unref();
+            this.acks.set(id, {
+                timer,
+                resolve: (ok, error) => ok ? resolve('delivered') : reject(new RelaySendError(error ?? 'unknown')),
+            });
+            this.write({ t: 'send', id, to, data: Buffer.from(sealed).toString('base64url') });
+        });
+    }
+    /**
+     * 답을 안 기다리고 보낸다. 공유 스트림 프레임처럼 자주 가는 것에 쓴다. 릴레이도 ack를
+     * 안 돌려준다. 받는 쪽이 없으면 조용히 버려진다.
+     */
+    post(to, sealed) {
+        if (!this.ws || this.status !== 'online')
+            return false;
+        const id = this.nextId++;
+        return this.write({
+            t: 'send',
+            id,
+            to,
+            data: Buffer.from(sealed).toString('base64url'),
+            ack: false,
+        });
+    }
+    /** 공유 id를 연 기기를 릴레이에 묻는다 */
+    resolveShare(share, timeoutMs = 5_000) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || this.status !== 'online') {
+                reject(new RelaySendError('not_connected'));
+                return;
+            }
+            const id = this.nextId++;
+            const timer = setTimeout(() => {
+                this.resolves.delete(id);
+                reject(new RelaySendError('timeout'));
+            }, timeoutMs);
+            timer.unref();
+            this.resolves.set(id, (owner) => {
+                clearTimeout(timer);
+                resolve(owner);
+            });
+            this.write({ t: 'resolve', id, share });
+        });
+    }
+    /** 지금 연 공유 id 전부를 알린다. 다시 붙을 때도 같은 목록을 다시 보낸다 */
+    announce(shares) {
+        this.announced = [...shares];
+        if (this.status === 'online')
+            this.write({ t: 'announce', shares: this.announced });
+    }
+    publishRoster(roster) {
+        this.roster = roster;
+        if (this.status === 'online')
+            this.write({ t: 'roster', roster });
+    }
+    sendJoin(to, sealed) {
+        if (!this.ws)
+            return false;
+        return this.write({ t: 'join', to, data: Buffer.from(sealed).toString('base64url') });
+    }
+    async close() {
+        this.setState('closed');
+        if (this.retry)
+            clearTimeout(this.retry);
+        this.retry = null;
+        const ws = this.ws;
+        this.ws = null;
+        ws?.close(1000, 'bye');
+        this.failPending('not_connected');
+    }
+    attempt() {
+        if (this.status === 'closed' || this.status === 'removed')
+            return Promise.resolve();
+        this.setState('connecting');
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const settle = (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            };
+            connectWs(this.options.url).then((ws) => {
+                if (this.status === 'closed') {
+                    ws.close(1000, 'bye');
+                    settle();
+                    return;
+                }
+                this.ws = ws;
+                ws.on('message', (text) => this.onMessage(ws, text, settle));
+                ws.on('close', (code, reason) => {
+                    if (this.ws !== ws)
+                        return;
+                    this.ws = null;
+                    this.failPending('not_connected');
+                    if (code === CLOSE_REMOVED) {
+                        this.setState('removed');
+                        settle(new Error('명단에 없는 기기라 릴레이가 끊었어요'));
+                        return;
+                    }
+                    settle(new Error(`릴레이 연결이 끊겼어요 (${code}${reason ? ` ${reason}` : ''})`));
+                    this.lost();
+                });
+            }, (err) => {
+                settle(new Error(`릴레이에 못 붙었어요: ${errMessage(err)}`));
+                this.lost();
+            });
+        });
+    }
+    lost() {
+        if (this.status === 'closed' || this.status === 'removed')
+            return;
+        this.setState('offline');
+        const reconnect = this.options.reconnect ?? (this.options.mode ?? 'member') === 'member';
+        if (!reconnect || this.retry)
+            return;
+        const wait = this.backoff;
+        this.backoff = Math.min(this.backoff * 2, this.options.maxBackoffMs ?? 30_000);
+        this.retry = setTimeout(() => {
+            this.retry = null;
+            this.attempt().catch(() => {
+                // 실패는 close 핸들러가 다음 시도를 건다
+            });
+        }, wait);
+        this.retry.unref();
+    }
+    /**
+     * 릴레이가 보낸 프레임. 릴레이도 믿지 않는 쪽이라 꼴이 틀린 프레임은 버린다. 여기서
+     * 던지면 소켓 data 핸들러 밖으로 나가 데몬이 죽는다.
+     */
+    onMessage(ws, text, settle) {
+        let frame;
+        try {
+            frame = JSON.parse(text);
+        }
+        catch {
+            return;
+        }
+        if (typeof frame !== 'object' || frame === null || !wellFormed(frame))
+            return;
+        try {
+            this.dispatch(ws, frame, settle);
+        }
+        catch (err) {
+            process.stderr.write(`[peer] relay frame failed: ${errMessage(err)}\n`);
+        }
+    }
+    dispatch(ws, frame, settle) {
+        switch (frame.t) {
+            case 'challenge': {
+                const mode = this.options.mode ?? 'member';
+                const hello = {
+                    t: 'hello',
+                    team: this.options.team,
+                    key: this.options.key.id,
+                    mode,
+                    sig: signText(this.options.key, helloSigned(this.options.team, frame.nonce, mode)),
+                    ...(this.roster ? { roster: this.roster } : {}),
+                };
+                ws.send(JSON.stringify(hello));
+                return;
+            }
+            case 'welcome':
+                this.backoff = this.options.minBackoffMs ?? 500;
+                this.setState('online');
+                if (this.announced.length > 0)
+                    this.write({ t: 'announce', shares: this.announced });
+                this.emit('welcome', frame.roster, frame.online);
+                settle();
+                return;
+            case 'pending':
+                this.emit('pending');
+                settle();
+                return;
+            case 'error':
+                this.emit('relay-error', frame.code, frame.message);
+                settle(new Error(`릴레이가 거절했어요: ${frame.message}`));
+                return;
+            case 'recv': {
+                const bytes = Buffer.from(frame.data, 'base64url');
+                for (const r of this.receivers) {
+                    try {
+                        r(frame.from, bytes);
+                    }
+                    catch (err) {
+                        process.stderr.write(`[peer] receive handler failed: ${errMessage(err)}\n`);
+                    }
+                }
+                return;
+            }
+            case 'ack': {
+                const p = this.acks.get(frame.id);
+                if (!p)
+                    return;
+                this.acks.delete(frame.id);
+                clearTimeout(p.timer);
+                p.resolve(frame.ok, frame.error);
+                return;
+            }
+            case 'resolved': {
+                const r = this.resolves.get(frame.id);
+                this.resolves.delete(frame.id);
+                r?.(typeof frame.owner === 'string' ? frame.owner : null);
+                return;
+            }
+            case 'roster':
+                this.emit('roster', frame.roster);
+                return;
+            case 'presence':
+                this.emit('presence', frame.key, frame.online);
+                return;
+            case 'join':
+                this.emit('join', frame.from, Buffer.from(frame.data, 'base64url'));
+                return;
+        }
+    }
+    write(frame) {
+        return this.ws?.send(JSON.stringify(frame)) ?? false;
+    }
+    failPending(reason) {
+        for (const [id, p] of this.acks) {
+            clearTimeout(p.timer);
+            this.acks.delete(id);
+            p.resolve(false, reason);
+        }
+        this.resolves.clear();
+    }
+    setState(next) {
+        if (this.status === next)
+            return;
+        // closed와 removed는 되돌리지 않는다
+        if ((this.status === 'closed' || this.status === 'removed') && next !== 'closed')
+            return;
+        this.status = next;
+        this.emit('state', next);
+    }
+}
+/** 프레임 종류마다 쓰는 칸의 타입만 본다. 내용 검사는 받는 쪽이 한다 */
+function wellFormed(frame) {
+    const f = frame;
+    const str = (k) => typeof f[k] === 'string';
+    switch (f.t) {
+        case 'challenge':
+            return str('nonce');
+        case 'welcome':
+            return typeof f.roster === 'object' && f.roster !== null && Array.isArray(f.online);
+        case 'pending':
+            return true;
+        case 'error':
+            return str('code') && str('message');
+        case 'recv':
+        case 'join':
+            return str('from') && str('data');
+        case 'ack':
+            return Number.isSafeInteger(f.id) && typeof f.ok === 'boolean';
+        case 'resolved':
+            return Number.isSafeInteger(f.id);
+        case 'roster':
+            return typeof f.roster === 'object' && f.roster !== null;
+        case 'presence':
+            return str('key') && typeof f.online === 'boolean';
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/src/peer/transport.js.map

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

package/dist/src/peer/viewer-html.d.ts

@@ -0,0 +1,10 @@
+export declare const VIEWER_WARNING = "\uBE44\uBC00\uAC12 \uD328\uD134\uC740 \uAC00\uB9AC\uC9C0\uB9CC \uC804\uBD80 \uC7A1\uC9C0\uB294 \uBABB\uD574\uC694.";
+/**
+ * 뷰어 페이지. 바깥 자원을 하나도 안 끌어온다 — CSP가 `default-src 'none'`이라
+ * 인라인 스크립트와 스타일도 nonce가 맞는 것만 돈다.
+ *
+ * 대화 내용은 전부 textContent로 넣는다. 마크다운을 HTML로 그리면 남의 도구 출력에
+ * 든 태그가 이 페이지에서 실행될 길이 생긴다. localStorage나 IndexedDB도 안 쓴다.
+ */
+export declare function renderViewerHtml(nonce: string, maxViewers: number): string;
+//# sourceMappingURL=viewer-html.d.ts.map

package/dist/src/peer/viewer-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-html.d.ts","sourceRoot":"","sources":["../../../src/peer/viewer-html.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,uHAA6B,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA2J1E"}

package/dist/src/peer/viewer-html.js

@@ -0,0 +1,165 @@
+export const VIEWER_WARNING = '비밀값 패턴은 가리지만 전부 잡지는 못해요.';
+/**
+ * 뷰어 페이지. 바깥 자원을 하나도 안 끌어온다 — CSP가 `default-src 'none'`이라
+ * 인라인 스크립트와 스타일도 nonce가 맞는 것만 돈다.
+ *
+ * 대화 내용은 전부 textContent로 넣는다. 마크다운을 HTML로 그리면 남의 도구 출력에
+ * 든 태그가 이 페이지에서 실행될 길이 생긴다. localStorage나 IndexedDB도 안 쓴다.
+ */
+export function renderViewerHtml(nonce, maxViewers) {
+    return `<!doctype html>
+<html lang="ko">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="referrer" content="no-referrer">
+<title>gestalt peer</title>
+<style nonce="${nonce}">
+  :root { color-scheme: light dark; --muted: #888; --line: #8884; }
+  body { font: 14px/1.55 -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; margin: 0; }
+  header { position: sticky; top: 0; padding: 10px 16px; border-bottom: 1px solid var(--line);
+    background: Canvas; z-index: 1; }
+  header h1 { font-size: 15px; margin: 0 0 4px; }
+  .warn { color: #b45309; font-size: 13px; }
+  .meta { color: var(--muted); font-size: 12px; display: flex; gap: 12px; flex-wrap: wrap; }
+  main { padding: 12px 16px 48px; max-width: 980px; }
+  .ev { margin: 10px 0; }
+  .who { font-size: 12px; color: var(--muted); }
+  .text { white-space: pre-wrap; word-break: break-word; }
+  .prompt .text { border-left: 3px solid #2563eb; padding-left: 8px; }
+  details { border: 1px solid var(--line); border-radius: 6px; padding: 4px 8px; }
+  details pre { white-space: pre-wrap; word-break: break-word; font-size: 12px; margin: 6px 0 2px; }
+  summary { cursor: pointer; font-size: 13px; }
+  .error summary { color: #dc2626; }
+  .note { color: var(--muted); font-style: italic; font-size: 13px; }
+</style>
+</head>
+<body>
+<header>
+  <h1 id="title">gestalt peer</h1>
+  <div class="warn">${VIEWER_WARNING}</div>
+  <div class="meta">
+    <span id="status">연결 중</span>
+    <span id="unknown"></span>
+  </div>
+</header>
+<main id="log"></main>
+<script nonce="${nonce}">
+(() => {
+  const log = document.getElementById('log');
+  const statusEl = document.getElementById('status');
+  const unknownEl = document.getElementById('unknown');
+  const titleEl = document.getElementById('title');
+  const params = new URLSearchParams(location.search);
+  const token = params.get('t') || '';
+  const base = location.pathname.replace(/\\/$/, '');
+  const results = new Map();
+
+  const el = (tag, cls, text) => {
+    const n = document.createElement(tag);
+    if (cls) n.className = cls;
+    if (text !== undefined) n.textContent = text;
+    return n;
+  };
+  const time = (at) => (at ? new Date(at).toLocaleTimeString() : '');
+  const atBottom = () => window.innerHeight + window.scrollY >= document.body.scrollHeight - 40;
+
+  const STATUS = {
+    live: '실시간',
+    missing: '대화 기록 파일이 안 보여요',
+    truncated: '대화 기록이 줄어들어서 멈췄어요',
+    offline: '주인 데몬이 오프라인이에요',
+  };
+  const CLOSED = {
+    removed: '명단에서 빠져 공유가 끊겼어요',
+    owner_removed: '주인이 명단에서 빠져 공유가 끊겼어요',
+    expired: '공유가 만료됐어요',
+  };
+
+  function render(ev) {
+    const box = el('div', 'ev ' + ev.kind);
+    if (ev.kind === 'prompt' || ev.kind === 'reply') {
+      box.append(el('div', 'who', (ev.kind === 'prompt' ? '주인' : '모델') + ' ' + time(ev.at)));
+      box.append(el('div', 'text', ev.text));
+    } else if (ev.kind === 'tool_call') {
+      const d = el('details');
+      d.append(el('summary', '', '도구 ' + ev.name + ' ' + time(ev.at)));
+      if (ev.input !== undefined) d.append(el('pre', '', ev.input));
+      const slot = el('div');
+      d.append(slot);
+      if (ev.id) results.set(ev.id, slot);
+      box.append(d);
+    } else if (ev.kind === 'tool_result') {
+      const d = el('details', ev.isError ? 'error' : '');
+      const label = ev.hidden ? '결과 (주인이 숨김)' : ev.isError ? '결과 (에러)' : '결과';
+      d.append(el('summary', '', label + (ev.truncated ? ' · 앞부분만' : '')));
+      if (!ev.hidden) d.append(el('pre', '', ev.text || ''));
+      const slot = ev.toolUseId ? results.get(ev.toolUseId) : undefined;
+      if (slot) { slot.append(d); return; }
+      box.append(d);
+    } else if (ev.kind === 'title') {
+      titleEl.textContent = ev.text;
+      document.title = ev.text + ' · gestalt peer';
+      return;
+    } else if (ev.kind === 'sidechain') {
+      box.append(el('div', 'note', '서브에이전트 실행 중'));
+    } else if (ev.kind === 'compacted') {
+      box.append(el('div', 'note', '이전 대화가 압축됐어요'));
+    } else {
+      return;
+    }
+    log.append(box);
+  }
+
+  const eventsUrl = base + '/events?t=' + encodeURIComponent(token);
+  const es = new EventSource(eventsUrl);
+  es.addEventListener('line', (m) => {
+    const stick = atBottom();
+    render(JSON.parse(m.data));
+    if (stick) window.scrollTo(0, document.body.scrollHeight);
+  });
+  es.addEventListener('trimmed', (m) => {
+    const n = JSON.parse(m.data).dropped;
+    log.append(el('div', 'ev note', '메모리 상한에 걸려 앞부분 ' + n + '개를 생략했어요'));
+  });
+  es.addEventListener('stats', (m) => {
+    const n = JSON.parse(m.data).unknownLines;
+    unknownEl.textContent = n > 0 ? '모르는 줄 ' + n + '개 건너뜀' : '';
+  });
+  es.addEventListener('state', (m) => {
+    statusEl.textContent = STATUS[JSON.parse(m.data).status] || '';
+  });
+  es.addEventListener('closed', (m) => {
+    const closed = JSON.parse(m.data);
+    // 원격 공유의 reason은 주인 데몬이 보낸 글자다. 프로토타입 이름이 들어와도 안 걸리게 자기 키만 본다
+    statusEl.textContent = Object.hasOwn(CLOSED, closed.reason) ? CLOSED[closed.reason] : '공유가 종료됐어요';
+    const missed = closed.missed;
+    if (missed > 0) {
+      log.append(el('div', 'ev note', '공유가 종료돼 뒤쪽 ' + missed + '개는 못 받았어요'));
+    }
+    es.close();
+  });
+  // EventSource는 응답 코드를 안 알려 준다. 끊긴 이유가 뷰어 상한(429)인지 한 번 물어본다
+  es.onerror = () => {
+    if (es.readyState !== EventSource.CLOSED) {
+      statusEl.textContent = '다시 연결 중';
+      return;
+    }
+    statusEl.textContent = '연결이 끊겼어요';
+    const ctl = new AbortController();
+    fetch(eventsUrl, { signal: ctl.signal, cache: 'no-store' })
+      .then((r) => {
+        ctl.abort();
+        if (r.status === 429) {
+          statusEl.textContent = '보는 사람 수 상한(${maxViewers}명)에 걸려 못 붙었어요';
+        }
+      })
+      .catch(() => {});
+  };
+})();
+</script>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=viewer-html.js.map

package/dist/src/peer/viewer-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-html.js","sourceRoot":"","sources":["../../../src/peer/viewer-html.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,UAAkB;IAChE,OAAO;;;;;;;gBAOO,KAAK;;;;;;;;;;;;;;;;;;;;;;;sBAuBC,cAAc;;;;;;;iBAOnB,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CA2GyB,UAAU;;;;;;;;;CASxD,CAAC;AACF,CAAC"}

package/dist/src/peer/viewer.d.ts

@@ -0,0 +1,58 @@
+import type { ShareFeed } from './feed.js';
+export interface ViewerShare {
+    stream: ShareFeed;
+    token: string;
+}
+export interface ViewerHooks {
+    lookup(id: string): ViewerShare | undefined;
+    onConnect?(shareId: string): void;
+    onDisconnect?(shareId: string): void;
+}
+/**
+ * 공유 하나에 동시에 붙는 뷰어 상한. 넘으면 429. 뷰어 하나가 붙잡는 메모리는 소켓 버퍼로
+ * 묶여 있지만 연결마다 소켓과 타이머가 생기니 토큰을 아는 쪽이 끝없이 열지 못하게 한다.
+ * 사람이 보는 숫자로는 넉넉하다.
+ */
+export declare const MAX_VIEWERS_PER_SHARE = 16;
+/**
+ * 실시간 프레임을 쓰기 전에 소켓 버퍼에 이만큼 넘게 밀려 있으면 그 뷰어를 끊는다. 안 읽는
+ * 뷰어 하나가 데몬 메모리를 끝없이 붙잡지 못하게 한다. 이보다 큰 이벤트 하나는 들어가지만
+ * 소켓으로 다 빠지기 전에 다음 프레임이 오면 그때 끊는다. 앞부분은 소켓이 비는 만큼만 꺼내
+ * 보내서 여기에 안 쌓인다. 브라우저는 다시 붙어 Last-Event-ID부터 받는다.
+ */
+export declare const MAX_LIVE_BACKLOG_BYTES: number;
+/** 앞부분을 공유에서 한 번에 꺼내는 양. 소켓이 차면 그 자리에서 멈추므로 대략이면 된다 */
+export declare const REPLAY_CHUNK_BYTES: number;
+export interface ViewerServerOptions {
+    /** 테스트가 작게 준다 */
+    maxLiveBacklogBytes?: number;
+}
+/**
+ * 로컬 뷰어 HTTP 서버. `127.0.0.1`에만 붙는다.
+ *
+ * 같은 머신의 다른 프로세스나 브라우저에 열린 남의 웹페이지도 이 포트에 닿을 수 있다.
+ * 그래서 공유마다 토큰을 주소에 붙이고 없거나 틀리면 401이다. 모르는 공유 id도 401로
+ * 돌려준다 — 404와 401을 나누면 토큰 없이 공유 id가 살아 있는지 떠볼 수 있다.
+ *
+ * Routes:
+ *   GET /s/:id?t=TOKEN          → 뷰어 HTML
+ *   GET /s/:id/events?t=TOKEN   → SSE (line, trimmed, stats, state, closed). 뷰어 상한을 넘으면 429.
+ *                                 closed의 missed는 따라잡는 중에 공유가 종료돼 못 보낸 이벤트 수
+ *   *                           → 404
+ */
+export declare class ViewerServer {
+    private readonly hooks;
+    private server;
+    private open;
+    private viewers;
+    private readonly maxLiveBacklogBytes;
+    constructor(hooks: ViewerHooks, options?: ViewerServerOptions);
+    start(port?: number): Promise<number>;
+    get port(): number | undefined;
+    stop(): Promise<void>;
+    private handle;
+    private hostAllowed;
+    private page;
+    private stream;
+}
+//# sourceMappingURL=viewer.d.ts.map

package/dist/src/peer/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../../src/peer/viewer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,WAAW,CAAC;AAIvD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAQD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,QAAa,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IAOrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAG1B,KAAK,EAAE,WAAW,EACnC,OAAO,GAAE,mBAAwB;IAKnC,KAAK,CAAC,IAAI,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBhC,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAG7B;IAED,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrB,OAAO,CAAC,MAAM;IAwBd,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,IAAI;IAkBZ,OAAO,CAAC,MAAM;CA4Ef"}