@tienne/gestalt 0.109.0 → 0.111.0

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

@@ -0,0 +1,103 @@
+/**
+ * 뷰어 하나가 받는 것. seq는 SSE id로 써서 다시 붙었을 때 이어 받게 한다. 이벤트는
+ * 쌓을 때 한 번 직렬화한 글자를 그대로 넘긴다. 뷰어마다 다시 직렬화하지 않는다.
+ */
+export type ShareFrame = {
+    type: 'event';
+    seq: number;
+    json: string;
+}
+/** 붙은 뷰어가 받을 앞부분 중 메모리 상한에 밀려 버려진 이벤트 수 */
+ | {
+    type: 'trimmed';
+    dropped: number;
+} | {
+    type: 'stats';
+    unknownLines: number;
+} | {
+    type: 'state';
+    status: ShareStatus;
+}
+/**
+ * 공유 종료. 앞부분을 따라잡는 중에 종료되면 아직 못 보낸 이벤트는 사라지므로 그 개수를
+ * missed에 싣는다. 붙어 있던 뷰어는 다 받은 뒤라 안 싣는다
+ */
+ | {
+    type: 'closed';
+    reason: string;
+    missed?: number;
+};
+/** offline은 원격 공유에서 주인 데몬이 릴레이에서 빠졌을 때다 */
+export type ShareStatus = 'live' | 'missing' | 'truncated' | 'offline';
+export type ShareListener = (frame: ShareFrame) => void;
+/**
+ * 새 뷰어에게 다시 보낼 앞부분의 상한. 넘으면 오래된 것부터 버린다. 공유는 최대 7일
+ * 열려 있고 도구 출력이 크면 events가 끝없이 는다.
+ */
+export declare const DEFAULT_MAX_BACKLOG_BYTES: number;
+export interface BacklogSlice {
+    /** `afterSeq` 뒤로 상한에 밀려 버려진 이벤트 수 */
+    dropped: number;
+    items: {
+        seq: number;
+        json: string;
+    }[];
+}
+/**
+ * 바꾼 이벤트를 직렬화한 글자로 상한까지 들고 붙은 뷰어에 흘린다. 뷰어 서버는 이것만 안다.
+ * 내 대화 기록을 읽는 ShareStream과 원격 공유를 받아 옮기는 MirrorFeed가 이걸 물려받는다.
+ *
+ * seq는 공유가 연 뒤로 나온 이벤트의 번호다. 앞부분을 버려도 번호는 안 당긴다.
+ * 배열 위치로 매기면 버린 만큼 번호가 밀려 Last-Event-ID로 이어 받을 때 겹치거나 빠진다.
+ */
+export declare class ShareFeed {
+    readonly id: string;
+    /**
+     * `events[head]`부터가 살아 있다. 앞에서 하나씩 shift하면 큰 배열에서 매번 다 옮긴다.
+     * head 앞 칸은 버릴 때 비워 둔다. 압축은 head가 1024를 넘어야 돌아서 칸에 참조를
+     * 남기면 버린 이벤트를 GC가 못 가져간다.
+     */
+    private events;
+    private head;
+    /** `events[0]` 앞에서 잘라 낸 이벤트 수. `events[i]`의 seq는 `base + i + 1`이다 */
+    private base;
+    private backlogBytes;
+    private readonly maxBacklogBytes;
+    private listeners;
+    protected status: ShareStatus;
+    private closedReason;
+    constructor(id: string, maxBacklogBytes?: number);
+    get currentStatus(): ShareStatus;
+    get unknownLines(): number;
+    get eventCount(): number;
+    /** 상한에 밀려 버린 이벤트 수 */
+    get droppedEvents(): number;
+    get viewerCount(): number;
+    get isClosed(): boolean;
+    get closeReason(): string | undefined;
+    /**
+     * 쌓인 것 중 `afterSeq` 뒤를 `maxBytes`쯤까지 꺼낸다. 이벤트 하나가 상한보다 커도 하나는
+     * 꺼낸다. 뷰어가 소켓이 비는 만큼씩 앞부분을 보내려고 쓴다. 한 번에 다 넘기면 안 읽는
+     * 뷰어마다 앞부분 전체가 소켓 버퍼에 쌓인다.
+     */
+    backlogAfter(afterSeq: number, maxBytes: number): BacklogSlice;
+    /**
+     * 뷰어를 붙인다. 지금 상태와 `afterSeq` 뒤 앞부분을 한 번에 보내고 이후는 생기는 대로.
+     * 떼어내는 함수를 돌려준다. 앞부분이 큰 뷰어는 backlogAfter로 먼저 따라잡은 뒤 이벤트
+     * 루프로 돌아가기 전에 바로 붙어야 사이에 poll이 끼어 이벤트가 빠지지 않는다.
+     */
+    subscribe(listener: ShareListener, afterSeq?: number): () => void;
+    close(reason: string): void;
+    /** 이벤트 하나를 쌓고 흘린다. 상한 정리는 부른 쪽이 trim으로 한 번에 한다 */
+    protected pushEvent(json: string): void;
+    /**
+     * 들고 있던 걸 다 버리고 다음 이벤트 번호를 `seq + 1`부터 잇는다. 원격 공유에서 주인
+     * 쪽이 버린 구간을 건너뛸 때 쓴다. 버린 개수는 droppedEvents에 들어간다.
+     */
+    protected skipTo(seq: number): void;
+    /** 가장 최근 이벤트 하나는 상한을 넘어도 남긴다. 다 버리면 새 뷰어가 지금 상태를 못 본다 */
+    protected trim(): void;
+    protected setStatus(next: ShareStatus): void;
+    protected emit(frame: ShareFrame): void;
+}
+//# sourceMappingURL=feed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../../../src/peer/feed.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC9C,2CAA2C;GACzC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE;AACxC;;;GAGG;GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAEvE,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAO1D,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxC;AAED;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAK;IACjB,qEAAqE;IACrE,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,SAAS,CAA4B;IAC7C,SAAS,CAAC,MAAM,EAAE,WAAW,CAAU;IACvC,OAAO,CAAC,YAAY,CAAqB;gBAE7B,EAAE,EAAE,MAAM,EAAE,eAAe,SAA4B;IAKnE,IAAI,aAAa,IAAI,WAAW,CAE/B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,sBAAsB;IACtB,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAe9D;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,SAAI,GAAG,MAAM,IAAI;IAqB5D,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY3B,kDAAkD;IAClD,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOvC;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQnC,yDAAyD;IACzD,SAAS,CAAC,IAAI,IAAI,IAAI;IAatB,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAM5C,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAWxC"}

package/dist/src/peer/feed.js

@@ -0,0 +1,167 @@
+import { errMessage } from './errors.js';
+/**
+ * 새 뷰어에게 다시 보낼 앞부분의 상한. 넘으면 오래된 것부터 버린다. 공유는 최대 7일
+ * 열려 있고 도구 출력이 크면 events가 끝없이 는다.
+ */
+export const DEFAULT_MAX_BACKLOG_BYTES = 32 * 1024 * 1024;
+/**
+ * 바꾼 이벤트를 직렬화한 글자로 상한까지 들고 붙은 뷰어에 흘린다. 뷰어 서버는 이것만 안다.
+ * 내 대화 기록을 읽는 ShareStream과 원격 공유를 받아 옮기는 MirrorFeed가 이걸 물려받는다.
+ *
+ * seq는 공유가 연 뒤로 나온 이벤트의 번호다. 앞부분을 버려도 번호는 안 당긴다.
+ * 배열 위치로 매기면 버린 만큼 번호가 밀려 Last-Event-ID로 이어 받을 때 겹치거나 빠진다.
+ */
+export class ShareFeed {
+    id;
+    /**
+     * `events[head]`부터가 살아 있다. 앞에서 하나씩 shift하면 큰 배열에서 매번 다 옮긴다.
+     * head 앞 칸은 버릴 때 비워 둔다. 압축은 head가 1024를 넘어야 돌아서 칸에 참조를
+     * 남기면 버린 이벤트를 GC가 못 가져간다.
+     */
+    events = [];
+    head = 0;
+    /** `events[0]` 앞에서 잘라 낸 이벤트 수. `events[i]`의 seq는 `base + i + 1`이다 */
+    base = 0;
+    backlogBytes = 0;
+    maxBacklogBytes;
+    listeners = new Set();
+    status = 'live';
+    closedReason;
+    constructor(id, maxBacklogBytes = DEFAULT_MAX_BACKLOG_BYTES) {
+        this.id = id;
+        this.maxBacklogBytes = maxBacklogBytes;
+    }
+    get currentStatus() {
+        return this.status;
+    }
+    get unknownLines() {
+        return 0;
+    }
+    get eventCount() {
+        return this.base + this.events.length;
+    }
+    /** 상한에 밀려 버린 이벤트 수 */
+    get droppedEvents() {
+        return this.base + this.head;
+    }
+    get viewerCount() {
+        return this.listeners.size;
+    }
+    get isClosed() {
+        return this.closedReason !== undefined;
+    }
+    get closeReason() {
+        return this.closedReason;
+    }
+    /**
+     * 쌓인 것 중 `afterSeq` 뒤를 `maxBytes`쯤까지 꺼낸다. 이벤트 하나가 상한보다 커도 하나는
+     * 꺼낸다. 뷰어가 소켓이 비는 만큼씩 앞부분을 보내려고 쓴다. 한 번에 다 넘기면 안 읽는
+     * 뷰어마다 앞부분 전체가 소켓 버퍼에 쌓인다.
+     */
+    backlogAfter(afterSeq, maxBytes) {
+        if (this.closedReason !== undefined)
+            return { dropped: 0, items: [] };
+        const droppedTotal = this.droppedEvents;
+        const after = Math.max(0, afterSeq);
+        const items = [];
+        let bytes = 0;
+        for (let i = Math.max(after, droppedTotal) - this.base; i < this.events.length; i++) {
+            const held = this.events[i];
+            if (items.length > 0 && bytes + held.bytes > maxBytes)
+                break;
+            items.push({ seq: this.base + i + 1, json: held.json });
+            bytes += held.bytes;
+        }
+        return { dropped: after < droppedTotal ? droppedTotal - after : 0, items };
+    }
+    /**
+     * 뷰어를 붙인다. 지금 상태와 `afterSeq` 뒤 앞부분을 한 번에 보내고 이후는 생기는 대로.
+     * 떼어내는 함수를 돌려준다. 앞부분이 큰 뷰어는 backlogAfter로 먼저 따라잡은 뒤 이벤트
+     * 루프로 돌아가기 전에 바로 붙어야 사이에 poll이 끼어 이벤트가 빠지지 않는다.
+     */
+    subscribe(listener, afterSeq = 0) {
+        listener({ type: 'state', status: this.status });
+        listener({ type: 'stats', unknownLines: this.unknownLines });
+        const { dropped, items } = this.backlogAfter(afterSeq, Infinity);
+        if (dropped > 0)
+            listener({ type: 'trimmed', dropped });
+        for (const item of items)
+            listener({ type: 'event', ...item });
+        if (this.closedReason !== undefined) {
+            // close가 events를 비워도 base를 늘려 두므로 eventCount는 그때까지 나온 전체 개수다
+            listener({
+                type: 'closed',
+                reason: this.closedReason,
+                missed: Math.max(0, this.eventCount - afterSeq),
+            });
+            return () => { };
+        }
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    close(reason) {
+        if (this.closedReason !== undefined)
+            return;
+        this.closedReason = reason;
+        this.emit({ type: 'closed', reason });
+        this.listeners.clear();
+        // 종료된 공유의 내용을 메모리에 붙잡아 둘 이유가 없다
+        this.base += this.events.length;
+        this.events = [];
+        this.head = 0;
+        this.backlogBytes = 0;
+    }
+    /** 이벤트 하나를 쌓고 흘린다. 상한 정리는 부른 쪽이 trim으로 한 번에 한다 */
+    pushEvent(json) {
+        const bytes = Buffer.byteLength(json);
+        this.events.push({ json, bytes });
+        this.backlogBytes += bytes;
+        this.emit({ type: 'event', seq: this.eventCount, json });
+    }
+    /**
+     * 들고 있던 걸 다 버리고 다음 이벤트 번호를 `seq + 1`부터 잇는다. 원격 공유에서 주인
+     * 쪽이 버린 구간을 건너뛸 때 쓴다. 버린 개수는 droppedEvents에 들어간다.
+     */
+    skipTo(seq) {
+        if (seq <= this.eventCount)
+            return;
+        this.base = seq;
+        this.events = [];
+        this.head = 0;
+        this.backlogBytes = 0;
+    }
+    /** 가장 최근 이벤트 하나는 상한을 넘어도 남긴다. 다 버리면 새 뷰어가 지금 상태를 못 본다 */
+    trim() {
+        while (this.backlogBytes > this.maxBacklogBytes && this.events.length - this.head > 1) {
+            this.backlogBytes -= this.events[this.head].bytes;
+            this.events[this.head] = undefined;
+            this.head++;
+        }
+        if (this.head > 1024 && this.head * 2 > this.events.length) {
+            this.base += this.head;
+            this.events = this.events.slice(this.head);
+            this.head = 0;
+        }
+    }
+    setStatus(next) {
+        if (next === this.status)
+            return;
+        this.status = next;
+        this.emit({ type: 'state', status: next });
+    }
+    emit(frame) {
+        for (const listener of [...this.listeners]) {
+            try {
+                listener(frame);
+            }
+            catch (err) {
+                // 뷰어 하나가 끊겨 쓰기에 실패해도 다른 뷰어와 데몬은 계속 돈다
+                this.listeners.delete(listener);
+                process.stderr.write(`[peer] viewer listener failed: ${errMessage(err)}\n`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=feed.js.map

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

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

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

@@ -11,4 +11,14 @@ export { TranscriptTransformer, stripSystemReminders } from './transform.js';
 export type { PeerEvent } from './transform.js';
 export { PeerState } from './state.js';
 export type { DaemonStatus, PeerRequest, PeerResponse, ShareInfo } from './protocol.js';
+export { RelayServer } from './relay.js';
+export type { RelayServerOptions } from './relay.js';
+export { RelayTransport, RelaySendError } from './transport.js';
+export type { PeerTransport, TransportState } from './transport.js';
+export { PeerNetwork } from './network.js';
+export type { MemberInfo, TeamStatus } from './network.js';
+export { loadOrCreateMachineKey, machineKeyPath } from './keys.js';
+export type { MachineKey } from './keys.js';
+export { checkRosterUpdate, formatShareLink, parseShareLink } from './roster.js';
+export type { Roster, RosterMember, SignedRoster } from './roster.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/peer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7F,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/peer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7F,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/peer/index.js

@@ -6,4 +6,9 @@ export { redactText, redactValue, truncateBytes, isToolsLevel, REDACTED } from '
 export { TranscriptTail } from './tail.js';
 export { TranscriptTransformer, stripSystemReminders } from './transform.js';
 export { PeerState } from './state.js';
+export { RelayServer } from './relay.js';
+export { RelayTransport, RelaySendError } from './transport.js';
+export { PeerNetwork } from './network.js';
+export { loadOrCreateMachineKey, machineKeyPath } from './keys.js';
+export { checkRosterUpdate, formatShareLink, parseShareLink } from './roster.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/peer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/peer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { KeyObject } from 'node:crypto';
+/**
+ * 기기 키. Ed25519로 서명하고 X25519로 봉인을 연다. 이 기기를 가리키는 이름(`id`)은
+ * Ed25519 공개키 32바이트를 base64url로 쓴 43자다.
+ */
+export interface MachineKey {
+    id: string;
+    /** X25519 공개키 32바이트 base64url */
+    boxKey: string;
+    signPrivate: KeyObject;
+    boxPrivate: KeyObject;
+}
+export declare function machineKeyPath(root: string): string;
+/**
+ * 키 파일을 읽고 없으면 만든다. 파일은 만드는 순간부터 0600이다 — 쓰고 나서 chmod하면
+ * 그 사이에 기본 권한(umask)으로 열려 있다.
+ *
+ * 권한이 넓거나 심링크거나 남의 파일이면 읽지 않고 던진다. 고치는 건 사람 몫이다.
+ */
+export declare function loadOrCreateMachineKey(root: string): MachineKey;
+export declare function loadMachineKey(path: string): MachineKey;
+/** 32바이트 공개키를 base64url로 쓴 꼴인지 */
+export declare function isRawKey(value: unknown): value is string;
+export declare function signPublicKey(id: string): KeyObject;
+export declare function boxPublicKey(raw: string): KeyObject;
+//# sourceMappingURL=keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/peer/keys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,aAAa,CAAC;AAIzD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,SAAS,CAAC;CACvB;AAQD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAyB/D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAmBvD;AAwBD,kCAAkC;AAClC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAEnD"}

package/dist/src/peer/keys.js

@@ -0,0 +1,95 @@
+import { createPrivateKey, createPublicKey, generateKeyPairSync } from 'node:crypto';
+import { closeSync, fsyncSync, lstatSync, openSync, readFileSync, writeSync } from 'node:fs';
+import { join } from 'node:path';
+export function machineKeyPath(root) {
+    return join(root, 'machine.key');
+}
+/**
+ * 키 파일을 읽고 없으면 만든다. 파일은 만드는 순간부터 0600이다 — 쓰고 나서 chmod하면
+ * 그 사이에 기본 권한(umask)으로 열려 있다.
+ *
+ * 권한이 넓거나 심링크거나 남의 파일이면 읽지 않고 던진다. 고치는 건 사람 몫이다.
+ */
+export function loadOrCreateMachineKey(root) {
+    const path = machineKeyPath(root);
+    try {
+        return loadMachineKey(path);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+    const sign = generateKeyPairSync('ed25519').privateKey.export({ format: 'jwk' });
+    const box = generateKeyPairSync('x25519').privateKey.export({ format: 'jwk' });
+    const body = { v: 1, sign, box };
+    let fd;
+    try {
+        fd = openSync(path, 'wx', 0o600);
+    }
+    catch (err) {
+        // 다른 데몬이 먼저 만들었다. 그쪽 키를 쓴다
+        if (err.code === 'EEXIST')
+            return loadMachineKey(path);
+        throw err;
+    }
+    try {
+        writeSync(fd, JSON.stringify(body) + '\n');
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+    return fromFile(body, path);
+}
+export function loadMachineKey(path) {
+    const st = lstatSync(path);
+    if (st.isSymbolicLink())
+        throw new Error(`기기 키가 심링크예요: ${path}`);
+    if (!st.isFile())
+        throw new Error(`기기 키 자리에 다른 파일이 있어요: ${path}`);
+    const uid = process.getuid?.();
+    if (uid !== undefined && st.uid !== uid)
+        throw new Error(`기기 키의 주인이 내가 아니에요: ${path}`);
+    if ((st.mode & 0o077) !== 0) {
+        throw new Error(`기기 키 권한이 넓어요(${(st.mode & 0o777).toString(8)}). chmod 600 ${path} 뒤에 다시 띄워 주세요`);
+    }
+    let body;
+    try {
+        body = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        throw new Error(`기기 키 파일을 못 읽었어요: ${path}`);
+    }
+    return fromFile(body, path);
+}
+function fromFile(body, path) {
+    if (body.v !== 1 || body.sign?.crv !== 'Ed25519' || body.box?.crv !== 'X25519') {
+        throw new Error(`기기 키 형식이 아니에요: ${path}`);
+    }
+    const signPrivate = createPrivateKey({ key: body.sign, format: 'jwk' });
+    const boxPrivate = createPrivateKey({ key: body.box, format: 'jwk' });
+    return {
+        id: rawPublic(signPrivate),
+        boxKey: rawPublic(boxPrivate),
+        signPrivate,
+        boxPrivate,
+    };
+}
+function rawPublic(priv) {
+    const jwk = createPublicKey(priv).export({ format: 'jwk' });
+    if (typeof jwk.x !== 'string')
+        throw new Error('공개키를 못 꺼냈어요');
+    return jwk.x;
+}
+const RAW_KEY = /^[A-Za-z0-9_-]{43}$/;
+/** 32바이트 공개키를 base64url로 쓴 꼴인지 */
+export function isRawKey(value) {
+    return typeof value === 'string' && RAW_KEY.test(value);
+}
+export function signPublicKey(id) {
+    return createPublicKey({ key: { kty: 'OKP', crv: 'Ed25519', x: id }, format: 'jwk' });
+}
+export function boxPublicKey(raw) {
+    return createPublicKey({ key: { kty: 'OKP', crv: 'X25519', x: raw }, format: 'jwk' });
+}
+//# sourceMappingURL=keys.js.map

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

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

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

@@ -0,0 +1,32 @@
+export interface DaemonLock {
+    path: string;
+    dev: number;
+    ino: number;
+    /** 적어 둔 내용. 지운 파일의 inode를 새 파일이 다시 받을 수 있어서 내용까지 맞춰 본다 */
+    content: string;
+}
+/**
+ * 잠금 파일이 막 생긴 뒤 소켓이 아직 안 열렸어도 살아 있는 데몬으로 치는 시간. 이보다
+ * 오래됐는데 소켓이 답하지 않으면 pid가 다른 프로세스에 다시 쓰인 걸로 보고 치운다.
+ */
+export declare const LOCK_GRACE_MS = 10000;
+export declare function lockPath(root: string): string;
+/**
+ * 데몬 잠금. 이걸 쥔 데몬만 소켓 자리를 확인하고 치우고 만든다.
+ *
+ * 남은 잠금 파일을 치우는 규칙:
+ * 1. 적힌 pid가 없는 프로세스면 남은 것이다.
+ * 2. pid가 살아 있어도 잠금이 `LOCK_GRACE_MS`보다 오래됐고 소켓이 답하지 않으면 남은 것이다
+ *    (데몬이 죽고 그 pid를 다른 프로세스가 받은 경우).
+ * 3. 남은 잠금은 지우지 않고 내 이름으로 옮긴 뒤 옮긴 파일이 내가 읽은 그 파일인지 본다.
+ *    그 사이 다른 데몬이 남은 잠금을 치우고 새로 잡았으면 옮긴 게 그 데몬의 잠금이라 같은
+ *    이름으로 되돌리고 물러난다. 옮기기는 한쪽만 성공하므로 둘이 같은 남은 잠금을 동시에
+ *    치워도 둘 다 잠금을 쥐었다고 믿지 않는다.
+ *
+ * 되돌리는 사이에 세 번째 데몬이 빈 자리에 잠금을 만들면 그 데몬과 원래 데몬이 함께 쥔다.
+ * 남은 잠금 하나를 데몬 셋이 같은 순간에 치울 때만 생기는 틈이다.
+ */
+export declare function acquireDaemonLock(root: string, sock: string): Promise<DaemonLock>;
+/** 내 잠금일 때만 지운다. 이미 다른 데몬이 그 자리를 잡았으면 안 건드린다 */
+export declare function releaseDaemonLock(lock: DaemonLock): void;
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/peer/lock.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAS,CAAC;AAEpC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBvF;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CASxD"}

package/dist/src/peer/lock.js

@@ -0,0 +1,147 @@
+import { randomBytes } from 'node:crypto';
+import { closeSync, linkSync, lstatSync, openSync, readFileSync, renameSync, unlinkSync, writeSync, } from 'node:fs';
+import { createConnection } from 'node:net';
+import { join } from 'node:path';
+/**
+ * 잠금 파일이 막 생긴 뒤 소켓이 아직 안 열렸어도 살아 있는 데몬으로 치는 시간. 이보다
+ * 오래됐는데 소켓이 답하지 않으면 pid가 다른 프로세스에 다시 쓰인 걸로 보고 치운다.
+ */
+export const LOCK_GRACE_MS = 10_000;
+export function lockPath(root) {
+    return join(root, 'peer.lock');
+}
+/**
+ * 데몬 잠금. 이걸 쥔 데몬만 소켓 자리를 확인하고 치우고 만든다.
+ *
+ * 남은 잠금 파일을 치우는 규칙:
+ * 1. 적힌 pid가 없는 프로세스면 남은 것이다.
+ * 2. pid가 살아 있어도 잠금이 `LOCK_GRACE_MS`보다 오래됐고 소켓이 답하지 않으면 남은 것이다
+ *    (데몬이 죽고 그 pid를 다른 프로세스가 받은 경우).
+ * 3. 남은 잠금은 지우지 않고 내 이름으로 옮긴 뒤 옮긴 파일이 내가 읽은 그 파일인지 본다.
+ *    그 사이 다른 데몬이 남은 잠금을 치우고 새로 잡았으면 옮긴 게 그 데몬의 잠금이라 같은
+ *    이름으로 되돌리고 물러난다. 옮기기는 한쪽만 성공하므로 둘이 같은 남은 잠금을 동시에
+ *    치워도 둘 다 잠금을 쥐었다고 믿지 않는다.
+ *
+ * 되돌리는 사이에 세 번째 데몬이 빈 자리에 잠금을 만들면 그 데몬과 원래 데몬이 함께 쥔다.
+ * 남은 잠금 하나를 데몬 셋이 같은 순간에 치울 때만 생기는 틈이다.
+ */
+export async function acquireDaemonLock(root, sock) {
+    const path = lockPath(root);
+    for (let attempt = 0; attempt < 3; attempt++) {
+        let fd;
+        try {
+            fd = openSync(path, 'wx', 0o600);
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST')
+                throw err;
+            await clearStaleLock(path, sock);
+            continue;
+        }
+        const content = `${process.pid}\n${Date.now()}\n${randomBytes(8).toString('hex')}\n`;
+        try {
+            writeSync(fd, content);
+        }
+        finally {
+            closeSync(fd);
+        }
+        const st = lstatSync(path);
+        return { path, dev: st.dev, ino: st.ino, content };
+    }
+    throw new Error(`데몬 잠금을 못 잡았어요: ${path}`);
+}
+/** 내 잠금일 때만 지운다. 이미 다른 데몬이 그 자리를 잡았으면 안 건드린다 */
+export function releaseDaemonLock(lock) {
+    try {
+        const st = lstatSync(lock.path);
+        if (st.dev !== lock.dev || st.ino !== lock.ino)
+            return;
+        if (readFileSync(lock.path, 'utf8') !== lock.content)
+            return;
+        unlinkSync(lock.path);
+    }
+    catch {
+        // 이미 없으면 그만이다
+    }
+}
+async function clearStaleLock(path, sock) {
+    let st;
+    let text;
+    try {
+        st = lstatSync(path);
+        text = readFileSync(path, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    if (!st.isFile())
+        throw new Error(`잠금 파일 자리에 다른 파일이 있어요: ${path}`);
+    const [pidLine, atLine] = text.split('\n');
+    const pid = Number(pidLine);
+    const at = Number(atLine);
+    const validPid = pidLine !== '' && Number.isSafeInteger(pid) && pid > 0;
+    // 다른 데몬이 막 만들고 pid를 아직 안 적은 파일일 수 있다. 오래된 것만 남은 것으로 친다
+    if (!validPid && Date.now() - st.mtimeMs < LOCK_GRACE_MS) {
+        throw new Error(`다른 데몬이 같이 뜨는 중이에요: ${sock}`);
+    }
+    if (validPid && processAlive(pid)) {
+        const young = Number.isFinite(at) && Date.now() - at < LOCK_GRACE_MS;
+        if (young || (await socketAnswers(sock))) {
+            throw new Error(`데몬이 이미 떠 있어요 (pid ${pid}): ${sock}`);
+        }
+    }
+    const aside = `${path}.${process.pid}.stale`;
+    try {
+        renameSync(path, aside);
+    }
+    catch (err) {
+        // 다른 데몬이 먼저 옮겼다. 처음부터 다시 본다
+        if (err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+    const moved = lstatSync(aside);
+    // inode는 지운 파일 것을 새 파일이 다시 받을 수 있다. 내용까지 같아야 내가 읽은 그 파일이다
+    if (moved.dev !== st.dev || moved.ino !== st.ino || readFileSync(aside, 'utf8') !== text) {
+        try {
+            linkSync(aside, path);
+        }
+        catch {
+            // 그새 또 다른 데몬이 잡았다. 그쪽 잠금이 남는다
+        }
+        unlinkSync(aside);
+        throw new Error(`다른 데몬이 같이 뜨는 중이에요: ${sock}`);
+    }
+    unlinkSync(aside);
+}
+function processAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // 남의 프로세스면 EPERM이다. 살아 있다
+        return err.code === 'EPERM';
+    }
+}
+function socketAnswers(sock) {
+    return new Promise((resolve) => {
+        const c = createConnection(sock);
+        const timer = setTimeout(() => {
+            c.destroy();
+            resolve(false);
+        }, 1_000);
+        c.once('connect', () => {
+            clearTimeout(timer);
+            c.destroy();
+            resolve(true);
+        });
+        c.once('error', () => {
+            clearTimeout(timer);
+            resolve(false);
+        });
+    });
+}
+//# sourceMappingURL=lock.js.map