@caoruhua/open-claude-remote 0.1.0

package/dist/pty/output-buffer.js

@@ -0,0 +1,58 @@
+/**
+ * Ring buffer for PTY output. Stores raw ANSI strings, enforces max line count.
+ * Provides monotonically increasing sequence numbers for reconnection sync.
+ */
+export class OutputBuffer {
+    lines = [];
+    partial = ''; // incomplete line (no trailing \n yet)
+    seq = 0;
+    maxLines;
+    constructor(maxLines = 10000) {
+        this.maxLines = maxLines;
+    }
+    get sequenceNumber() {
+        return this.seq;
+    }
+    /**
+     * Append raw PTY output data. May contain multiple lines or partial lines.
+     */
+    append(data) {
+        this.seq++;
+        // Combine with any pending partial line
+        const combined = this.partial + data;
+        const parts = combined.split('\n');
+        // Last element is either empty (data ended with \n) or a partial line
+        this.partial = parts.pop() ?? '';
+        // All other elements are complete lines
+        for (const line of parts) {
+            this.lines.push(line);
+        }
+        // Trim when exceeding max by 10%, to amortize allocation cost
+        const trimThreshold = Math.floor(this.maxLines * 1.1);
+        if (this.lines.length > trimThreshold) {
+            this.lines = this.lines.slice(this.lines.length - this.maxLines);
+        }
+    }
+    /**
+     * Get full buffered content as a single string (for history_sync).
+     */
+    getFullContent() {
+        const joined = this.lines.join('\n');
+        if (this.lines.length === 0) {
+            return this.partial;
+        }
+        if (this.partial) {
+            return joined + '\n' + this.partial;
+        }
+        // Lines were split from \n, so the original data had \n between/after them
+        return joined + '\n';
+    }
+    /**
+     * Clear the buffer.
+     */
+    clear() {
+        this.lines = [];
+        this.partial = '';
+    }
+}
+//# sourceMappingURL=output-buffer.js.map

package/dist/pty/output-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-buffer.js","sourceRoot":"","sources":["../../src/pty/output-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAa,EAAE,CAAC;IACrB,OAAO,GAAW,EAAE,CAAC,CAAC,uCAAuC;IAC7D,GAAG,GAAW,CAAC,CAAC;IACP,QAAQ,CAAS;IAElC,YAAY,WAAmB,KAAK;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,GAAG,EAAE,CAAC;QAEX,wCAAwC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnC,sEAAsE;QACtE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAEjC,wCAAwC;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,8DAA8D;QAC9D,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;QACtC,CAAC;QACD,2EAA2E;QAC3E,OAAO,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/pty/pty-manager.d.ts

@@ -0,0 +1,45 @@
+import { EventEmitter } from 'node:events';
+export interface PtyManagerOptions {
+    command: string;
+    args?: string[];
+    cwd?: string;
+    cols?: number;
+    rows?: number;
+    env?: Record<string, string>;
+}
+export interface PtyManagerEvents {
+    data: (data: string) => void;
+    exit: (exitCode: number, signal?: number) => void;
+    error: (err: Error) => void;
+    resize: (cols: number, rows: number) => void;
+}
+/**
+ * Manages a PTY process (Claude Code CLI).
+ * Emits: 'data', 'exit', 'error', 'resize'
+ */
+export declare class PtyManager extends EventEmitter {
+    private process;
+    private _exited;
+    private _cols;
+    private _rows;
+    get exited(): boolean;
+    get cols(): number;
+    get rows(): number;
+    /**
+     * Spawn the PTY process.
+     */
+    spawn(options: PtyManagerOptions): void;
+    /**
+     * Write data to the PTY stdin.
+     */
+    write(data: string): void;
+    /**
+     * Resize the PTY.
+     */
+    resize(cols: number, rows: number): void;
+    /**
+     * Kill the PTY process.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=pty-manager.d.ts.map

package/dist/pty/pty-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-manager.d.ts","sourceRoot":"","sources":["../../src/pty/pty-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAc;IAE3B,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAyCvC;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBxC;;OAEG;IACH,OAAO,IAAI,IAAI;CAUhB"}

package/dist/pty/pty-manager.js

@@ -0,0 +1,108 @@
+import { EventEmitter } from 'node:events';
+import * as pty from 'node-pty';
+import { logger } from '../logger/logger.js';
+/**
+ * Manages a PTY process (Claude Code CLI).
+ * Emits: 'data', 'exit', 'error', 'resize'
+ */
+export class PtyManager extends EventEmitter {
+    process = null;
+    _exited = false;
+    _cols = 80;
+    _rows = 24;
+    get exited() {
+        return this._exited;
+    }
+    get cols() {
+        return this._cols;
+    }
+    get rows() {
+        return this._rows;
+    }
+    /**
+     * Spawn the PTY process.
+     */
+    spawn(options) {
+        if (this.process) {
+            throw new Error('PTY process already running');
+        }
+        const cols = options.cols ?? process.stdout.columns ?? 80;
+        const rows = options.rows ?? process.stdout.rows ?? 24;
+        // Store initial size
+        this._cols = cols;
+        this._rows = rows;
+        logger.info({ command: options.command, args: options.args, cwd: options.cwd, cols, rows }, 'Spawning PTY process');
+        try {
+            this.process = pty.spawn(options.command, options.args ?? [], {
+                name: 'xterm-256color',
+                cols,
+                rows,
+                cwd: options.cwd ?? process.cwd(),
+                env: { ...process.env, ...options.env },
+            });
+            this.process.onData((data) => {
+                this.emit('data', data);
+            });
+            this.process.onExit(({ exitCode, signal }) => {
+                this._exited = true;
+                logger.info({ exitCode, signal }, 'PTY process exited');
+                this.emit('exit', exitCode, signal);
+                this.process = null;
+            });
+            logger.info({ pid: this.process.pid }, 'PTY process spawned');
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to spawn PTY process');
+            this.emit('error', err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    /**
+     * Write data to the PTY stdin.
+     */
+    write(data) {
+        if (!this.process) {
+            logger.warn('Attempted to write to PTY but no process is running');
+            return;
+        }
+        this.process.write(data);
+    }
+    /**
+     * Resize the PTY.
+     */
+    resize(cols, rows) {
+        if (!this.process)
+            return;
+        // 避免重复 resize，防止无限循环
+        if (cols === this._cols && rows === this._rows) {
+            logger.info({ cols, rows }, 'PTY resize skipped (same size)');
+            return;
+        }
+        logger.info({ cols, rows, prevCols: this._cols, prevRows: this._rows }, 'PTY resize executing');
+        try {
+            this.process.resize(cols, rows);
+            this._cols = cols;
+            this._rows = rows;
+            logger.info({ cols, rows }, 'PTY resized successfully');
+            this.emit('resize', cols, rows);
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to resize PTY');
+        }
+    }
+    /**
+     * Kill the PTY process.
+     */
+    destroy() {
+        if (!this.process)
+            return;
+        try {
+            this.process.kill();
+            logger.info('PTY process killed');
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to kill PTY process');
+        }
+        this.process = null;
+    }
+}
+//# sourceMappingURL=pty-manager.js.map

package/dist/pty/pty-manager.js.map

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

package/dist/pty/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PTY 管理器接口
+ * 支持本地 PtyManager 和远程 VirtualPtyManager
+ */
+export interface IPtyManager {
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    cols: number;
+    rows: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pty/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pty/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/pty/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pty/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pty/types.ts"],"names":[],"mappings":""}

package/dist/pty/virtual-pty.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter } from 'node:events';
+import type { IPtyManager } from './types.js';
+/**
+ * VirtualPtyManager 模拟 PtyManager 接口，
+ * 但将写入操作通过 WebSocket 转发到远程实例。
+ * 用于 attach 命令，让本地终端接管远程实例。
+ */
+export declare class VirtualPtyManager extends EventEmitter implements IPtyManager {
+    private ws;
+    private _cols;
+    private _rows;
+    private _connected;
+    get cols(): number;
+    get rows(): number;
+    get connected(): boolean;
+    /**
+     * 连接到远程实例的 WebSocket。
+     */
+    connect(url: string, token: string): Promise<void>;
+    /**
+     * 写入数据（发送到远程实例）。
+     */
+    write(data: string): void;
+    /**
+     * 调整终端大小。
+     */
+    resize(cols: number, rows: number): void;
+    /**
+     * 发送 resize 消息到服务端（内部方法）。
+     */
+    private sendResize;
+    /**
+     * 断开连接。
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=virtual-pty.d.ts.map

package/dist/pty/virtual-pty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-pty.d.ts","sourceRoot":"","sources":["../../src/pty/virtual-pty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,YAAa,YAAW,WAAW;IACxE,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAkB;IAEpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqGlD;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAazB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/dist/pty/virtual-pty.js

@@ -0,0 +1,161 @@
+import { EventEmitter } from 'node:events';
+import { WebSocket } from 'ws';
+import { logger } from '../logger/logger.js';
+/**
+ * VirtualPtyManager 模拟 PtyManager 接口，
+ * 但将写入操作通过 WebSocket 转发到远程实例。
+ * 用于 attach 命令，让本地终端接管远程实例。
+ */
+export class VirtualPtyManager extends EventEmitter {
+    ws = null;
+    _cols = 80;
+    _rows = 24;
+    _connected = false;
+    get cols() {
+        return this._cols;
+    }
+    get rows() {
+        return this._rows;
+    }
+    get connected() {
+        return this._connected;
+    }
+    /**
+     * 连接到远程实例的 WebSocket。
+     */
+    connect(url, token) {
+        return new Promise((resolve, reject) => {
+            const wsUrl = `${url}?token=${encodeURIComponent(token)}`;
+            logger.info({ url }, 'VirtualPtyManager: connecting to remote instance');
+            this.ws = new WebSocket(wsUrl);
+            this.ws.on('open', () => {
+                logger.info('VirtualPtyManager: connected');
+                this._connected = true;
+                resolve();
+            });
+            this.ws.on('message', (rawData) => {
+                try {
+                    const msg = JSON.parse(rawData.toString());
+                    switch (msg.type) {
+                        case 'terminal_output':
+                            // 转发输出到本地终端
+                            this.emit('data', msg.data);
+                            break;
+                        case 'history_sync':
+                            // 历史数据也是输出
+                            this.emit('data', msg.data);
+                            // history_sync 包含服务端当前 PTY 尺寸
+                            // 作为从控端，attach 应该跟随服务端（webapp 主控端）的尺寸
+                            if (msg.cols && msg.rows && (msg.cols !== this._cols || msg.rows !== this._rows)) {
+                                const oldCols = this._cols;
+                                const oldRows = this._rows;
+                                this._cols = msg.cols;
+                                this._rows = msg.rows;
+                                logger.info({ serverCols: msg.cols, serverRows: msg.rows, localCols: oldCols, localRows: oldRows }, 'VirtualPtyManager: server size differs, updating local to match');
+                                // 通知本地终端调整尺寸
+                                this.emit('resize', msg.cols, msg.rows);
+                            }
+                            break;
+                        case 'terminal_resize':
+                            // 服务端 PTY 尺寸变化通知
+                            // 作为从控端，attach 应该跟随 webapp（主控端）的尺寸
+                            if (msg.cols && msg.rows) {
+                                const sizeChanged = msg.cols !== this._cols || msg.rows !== this._rows;
+                                this._cols = msg.cols;
+                                this._rows = msg.rows;
+                                if (sizeChanged) {
+                                    // 通知本地终端调整尺寸
+                                    this.emit('resize', msg.cols, msg.rows);
+                                }
+                                // emit server_resize 事件，让 attach.ts 用真实终端尺寸响应
+                                // 这在 WebApp 断开后特别重要：让 PTY 恢复到 attach 终端的尺寸
+                                this.emit('server_resize', msg.cols, msg.rows);
+                                logger.info({ cols: msg.cols, rows: msg.rows }, 'VirtualPtyManager: synced size from server');
+                            }
+                            break;
+                        case 'status_update':
+                            logger.info({ status: msg.status }, 'VirtualPtyManager: status update');
+                            break;
+                        case 'ip_changed':
+                            logger.info({ newUrl: msg.newUrl }, 'VirtualPtyManager: IP changed');
+                            break;
+                        default:
+                            // 忽略其他消息类型
+                            break;
+                    }
+                }
+                catch (err) {
+                    logger.warn({ err }, 'VirtualPtyManager: failed to parse server message');
+                }
+            });
+            this.ws.on('close', () => {
+                logger.info('VirtualPtyManager: connection closed');
+                this._connected = false;
+                this.emit('exit', 0);
+            });
+            this.ws.on('error', (err) => {
+                logger.error({ err }, 'VirtualPtyManager: WebSocket error');
+                const wasConnected = this._connected;
+                this._connected = false;
+                if (!wasConnected) {
+                    // 连接阶段的错误
+                    reject(err);
+                }
+                else {
+                    // 已连接后的错误
+                    this.emit('error', err);
+                }
+            });
+        });
+    }
+    /**
+     * 写入数据（发送到远程实例）。
+     */
+    write(data) {
+        if (!this.ws || !this._connected) {
+            logger.warn('VirtualPtyManager: attempted to write but not connected');
+            return;
+        }
+        const msg = {
+            type: 'user_input',
+            data,
+        };
+        this.ws.send(JSON.stringify(msg));
+    }
+    /**
+     * 调整终端大小。
+     */
+    resize(cols, rows) {
+        if (!this.ws || !this._connected)
+            return;
+        this._cols = cols;
+        this._rows = rows;
+        this.sendResize();
+    }
+    /**
+     * 发送 resize 消息到服务端（内部方法）。
+     */
+    sendResize() {
+        if (!this.ws || !this._connected)
+            return;
+        const msg = {
+            type: 'resize',
+            cols: this._cols,
+            rows: this._rows,
+        };
+        this.ws.send(JSON.stringify(msg));
+        logger.debug({ cols: this._cols, rows: this._rows }, 'VirtualPtyManager: resized');
+    }
+    /**
+     * 断开连接。
+     */
+    destroy() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this._connected = false;
+        logger.info('VirtualPtyManager: destroyed');
+    }
+}
+//# sourceMappingURL=virtual-pty.js.map

package/dist/pty/virtual-pty.js.map

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

package/dist/push/push-service.d.ts

@@ -0,0 +1,87 @@
+export interface PushNotificationPayload {
+    title: string;
+    body: string;
+    tag?: string;
+    renotify?: boolean;
+}
+export interface PushSubscriptionData {
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+}
+/**
+ * Web Push notification service.
+ * Manages VAPID keys, subscriptions, and notification delivery.
+ *
+ * 多实例支持：订阅数据通过文件持久化并跨实例共享。
+ * subscribe/unsubscribe 使用最终一致性语义——内存立即更新，
+ * 文件持久化异步执行（不阻塞调用方）。如果进程在持久化完成前崩溃，
+ * 该订阅需客户端重新注册。
+ */
+export declare class PushService {
+    private subscriptions;
+    private vapidPublicKey;
+    private vapidPrivateKey;
+    private vapidSubject;
+    private vapidInitPromise;
+    private readonly vapidKeysFile;
+    private readonly vapidLockPath;
+    private readonly subscriptionsFile;
+    private readonly subscriptionsLockPath;
+    private readonly dataDir;
+    constructor(baseDir: string);
+    /**
+     * 确保数据目录存在
+     */
+    private ensureDataDir;
+    /**
+     * 从文件加载 VAPID 密钥
+     */
+    private loadVapidKeys;
+    /**
+     * 保存 VAPID 密钥到文件
+     */
+    private saveVapidKeys;
+    /**
+     * 从文件加载订阅数据
+     */
+    private loadSubscriptions;
+    /**
+     * 从文件读取所有订阅（包含其他实例写入的）。
+     * 通过文件锁保护，防止读到半写的 JSON。
+     */
+    private readSubscriptionsFromFile;
+    /**
+     * 锁定读-合并-写订阅变更。
+     * type='add': 将 sub 合并到文件中（按 endpoint 去重）
+     * type='remove': 从文件中移除一个或多个 endpoints
+     */
+    private persistSubscriptionChange;
+    /**
+     * 初始化 VAPID 密钥和订阅数据。
+     * VAPID 密钥生成通过文件锁保护，防止多实例并发生成不同密钥对。
+     */
+    private initVapidAndSubscriptions;
+    getVapidPublicKey(): string;
+    waitForVapidPublicKey(timeoutMs?: number): Promise<string | null>;
+    /**
+     * 添加推送订阅。
+     * 内存立即更新，文件持久化异步执行（最终一致性）。
+     */
+    subscribe(subscription: PushSubscriptionData): void;
+    /**
+     * 移除推送订阅。
+     * 内存立即更新，文件持久化异步执行（最终一致性）。
+     */
+    unsubscribe(endpoint: string): boolean;
+    get subscriberCount(): number;
+    /**
+     * 验证订阅数据是否有效。
+     * p256dh 是 65 字节的 ECDH 公钥，Base64 URL-safe 编码后约 87 字符。
+     */
+    private isValidSubscription;
+    notifyAll(payload: PushNotificationPayload): Promise<void>;
+}
+//# sourceMappingURL=push-service.d.ts.map

package/dist/push/push-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-service.d.ts","sourceRoot":"","sources":["../../src/push/push-service.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAOD;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAgB;IAExC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,MAAM;IA0B3B;;OAEG;YACW,aAAa;IAS3B;;OAEG;YACW,aAAa;IAa3B;;OAEG;YACW,aAAa;IAK3B;;OAEG;YACW,iBAAiB;IAc/B;;;OAGG;YACW,yBAAyB;IAWvC;;;;OAIG;YACW,yBAAyB;IAwCvC;;;OAGG;YACW,yBAAyB;IA+BvC,iBAAiB,IAAI,MAAM;IAIrB,qBAAqB,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmB7E;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,oBAAoB,GAAG,IAAI;IAQnD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWtC,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAKrB,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;CAwEjE"}