webrtc-tree 1.0.0

package/dist/client/RTCTreeClient.d.ts

@@ -0,0 +1,33 @@
+export interface RTCTreeClientOptions {
+    onStreamReceived?: (stream: MediaStream) => void;
+    onStatusChange?: (status: string) => void;
+    onError?: (error: any) => void;
+    fetchParentIdFn?: () => Promise<string | null>;
+    reportDeadFn?: (deadPeerId: string) => Promise<void>;
+}
+export declare class RTCTreeClient {
+    private options;
+    private peer;
+    private myPeerId;
+    private myStream;
+    private activeCalls;
+    private parentConnection;
+    private isStreamer;
+    private isReconnecting;
+    constructor(options: RTCTreeClientOptions);
+    /**
+     * 初始化為直播主 (Streamer)
+     * @param stream 本地攝影機/麥克風的 MediaStream
+     * @param maxChildren 第一層最大觀眾數 (Layer 1 Capacity)
+     * @returns 建立完成後的 Peer ID
+     */
+    initStreamer(stream: MediaStream, maxChildren?: number): Promise<string>;
+    /**
+     * 初始化為觀眾 (Viewer)
+     * @param maxChildren 轉發最大觀眾數 (Layer N Capacity)
+     */
+    initViewer(maxChildren?: number): Promise<string>;
+    private connectToMesh;
+    private handleParentDisconnect;
+    destroy(): void;
+}

package/dist/client/index.d.ts

@@ -0,0 +1 @@
+export * from './RTCTreeClient';

package/dist/client/index.js

@@ -0,0 +1,205 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  RTCTreeClient: () => RTCTreeClient
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/client/RTCTreeClient.ts
+var import_peerjs = __toESM(require("peerjs"));
+var RTCTreeClient = class {
+  constructor(options) {
+    this.options = options;
+    this.peer = null;
+    this.myPeerId = null;
+    this.myStream = null;
+    this.activeCalls = {};
+    this.parentConnection = null;
+    // State
+    this.isStreamer = false;
+    this.isReconnecting = false;
+  }
+  /**
+   * 初始化為直播主 (Streamer)
+   * @param stream 本地攝影機/麥克風的 MediaStream
+   * @param maxChildren 第一層最大觀眾數 (Layer 1 Capacity)
+   * @returns 建立完成後的 Peer ID
+   */
+  initStreamer(stream, maxChildren = 4) {
+    this.isStreamer = true;
+    this.myStream = stream;
+    return new Promise((resolve, reject) => {
+      this.peer = new import_peerjs.default();
+      this.peer.on("open", (id) => {
+        this.myPeerId = id;
+        this.options.onStatusChange?.("\u76F4\u64AD\u5DF2\u958B\u59CB");
+        resolve(id);
+      });
+      this.peer.on("error", (err) => {
+        this.options.onError?.(err);
+        reject(err);
+      });
+      this.peer.on("connection", (conn) => {
+        conn.on("data", (data) => {
+          if (data === "VIEWER_READY") {
+            if (Object.keys(this.activeCalls).length < maxChildren) {
+              const call = this.peer.call(conn.peer, this.myStream);
+              this.activeCalls[conn.peer] = call;
+            } else {
+              conn.send({ type: "REJECT_FULL" });
+            }
+          }
+        });
+        conn.on("close", () => {
+          if (this.activeCalls[conn.peer]) {
+            this.activeCalls[conn.peer].close();
+            delete this.activeCalls[conn.peer];
+          }
+        });
+      });
+    });
+  }
+  /**
+   * 初始化為觀眾 (Viewer)
+   * @param maxChildren 轉發最大觀眾數 (Layer N Capacity)
+   */
+  initViewer(maxChildren = 4) {
+    this.isStreamer = false;
+    return new Promise((resolve, reject) => {
+      this.peer = new import_peerjs.default();
+      this.peer.on("open", async (id) => {
+        this.myPeerId = id;
+        this.options.onStatusChange?.("\u6B63\u5728\u5206\u914D\u7BC0\u9EDE...");
+        resolve(id);
+        await this.connectToMesh();
+      });
+      this.peer.on("error", (err) => {
+        this.options.onError?.(err);
+        reject(err);
+      });
+      this.peer.on("connection", (conn) => {
+        conn.on("data", (data) => {
+          if (data === "VIEWER_READY") {
+            if (Object.keys(this.activeCalls).length < maxChildren && this.myStream) {
+              const call = this.peer.call(conn.peer, this.myStream);
+              this.activeCalls[conn.peer] = call;
+            } else {
+              conn.send({ type: "REJECT_FULL" });
+            }
+          }
+        });
+        conn.on("close", () => {
+          if (this.activeCalls[conn.peer]) {
+            this.activeCalls[conn.peer].close();
+            delete this.activeCalls[conn.peer];
+          }
+        });
+      });
+      this.peer.on("call", (call) => {
+        this.options.onStatusChange?.("\u63A5\u6536\u5F71\u50CF\u4E2D...");
+        this.parentConnection = call;
+        call.answer();
+        call.on("stream", (remoteStream) => {
+          this.myStream = remoteStream;
+          this.options.onStatusChange?.("");
+          this.options.onStreamReceived?.(remoteStream);
+        });
+        call.on("close", () => {
+          this.handleParentDisconnect(call.peer);
+        });
+      });
+    });
+  }
+  async connectToMesh() {
+    if (!this.options.fetchParentIdFn) {
+      throw new Error("fetchParentIdFn is required for viewers");
+    }
+    try {
+      const targetPeerId = await this.options.fetchParentIdFn();
+      if (!targetPeerId) {
+        this.options.onStatusChange?.("\u66AB\u7121\u53EF\u7528\u7BC0\u9EDE\uFF0C\u8ACB\u7A0D\u5F8C\u91CD\u8A66");
+        return;
+      }
+      this.options.onStatusChange?.("\u9023\u7DDA\u4E2D...");
+      const conn = this.peer.connect(targetPeerId);
+      const timeoutId = setTimeout(() => {
+        conn.close();
+        this.handleParentDisconnect(targetPeerId);
+      }, 5e3);
+      conn.on("open", () => {
+        clearTimeout(timeoutId);
+        conn.send("VIEWER_READY");
+      });
+      conn.on("data", (data) => {
+        if (data && data.type === "REJECT_FULL") {
+          clearTimeout(timeoutId);
+          conn.close();
+          this.handleParentDisconnect(targetPeerId);
+        }
+      });
+      conn.on("close", () => {
+        clearTimeout(timeoutId);
+        this.handleParentDisconnect(targetPeerId);
+      });
+      conn.on("error", () => {
+        clearTimeout(timeoutId);
+        this.handleParentDisconnect(targetPeerId);
+      });
+    } catch (e) {
+      this.options.onStatusChange?.("\u9023\u7DDA\u5931\u6557");
+      console.error(e);
+    }
+  }
+  async handleParentDisconnect(deadPeerId) {
+    if (this.isReconnecting) return;
+    this.isReconnecting = true;
+    this.options.onStatusChange?.("\u4E0A\u5C64\u7BC0\u9EDE\u65B7\u7DDA\uFF0C\u91CD\u65B0\u5C0B\u627E\u8DEF\u5F91...");
+    if (this.options.reportDeadFn) {
+      await this.options.reportDeadFn(deadPeerId).catch(console.error);
+    }
+    setTimeout(async () => {
+      this.isReconnecting = false;
+      await this.connectToMesh();
+    }, 2e3);
+  }
+  destroy() {
+    if (this.peer) {
+      this.peer.destroy();
+      this.peer = null;
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RTCTreeClient
+});
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/index.ts","../../src/client/RTCTreeClient.ts"],"sourcesContent":["export * from './RTCTreeClient';\n","import Peer, { MediaConnection } from 'peerjs';\n\nexport interface RTCTreeClientOptions {\n  onStreamReceived?: (stream: MediaStream) => void;\n  onStatusChange?: (status: string) => void;\n  onError?: (error: any) => void;\n  fetchParentIdFn?: () => Promise<string | null>; // Client uses this to ask Server for a parent\n  reportDeadFn?: (deadPeerId: string) => Promise<void>; // Client uses this to tell Server a node is dead\n}\n\nexport class RTCTreeClient {\n  private peer: Peer | null = null;\n  private myPeerId: string | null = null;\n  private myStream: MediaStream | null = null;\n  private activeCalls: Record<string, MediaConnection> = {};\n  private parentConnection: MediaConnection | null = null;\n  \n  // State\n  private isStreamer: boolean = false;\n  private isReconnecting: boolean = false;\n\n  constructor(private options: RTCTreeClientOptions) {}\n\n  /**\n   * 初始化為直播主 (Streamer)\n   * @param stream 本地攝影機/麥克風的 MediaStream\n   * @param maxChildren 第一層最大觀眾數 (Layer 1 Capacity)\n   * @returns 建立完成後的 Peer ID\n   */\n  public initStreamer(stream: MediaStream, maxChildren: number = 4): Promise<string> {\n    this.isStreamer = true;\n    this.myStream = stream;\n\n    return new Promise((resolve, reject) => {\n      this.peer = new Peer();\n\n      this.peer.on('open', (id) => {\n        this.myPeerId = id;\n        this.options.onStatusChange?.(\"直播已開始\");\n        resolve(id);\n      });\n\n      this.peer.on('error', (err) => {\n        this.options.onError?.(err);\n        reject(err);\n      });\n\n      // 監聽觀眾連線請求\n      this.peer.on('connection', (conn) => {\n        conn.on('data', (data: any) => {\n          if (data === 'VIEWER_READY') {\n            if (Object.keys(this.activeCalls).length < maxChildren) {\n              const call = this.peer!.call(conn.peer, this.myStream!);\n              this.activeCalls[conn.peer] = call;\n            } else {\n              conn.send({ type: 'REJECT_FULL' });\n            }\n          }\n        });\n\n        conn.on('close', () => {\n          if (this.activeCalls[conn.peer]) {\n            this.activeCalls[conn.peer].close();\n            delete this.activeCalls[conn.peer];\n          }\n        });\n      });\n    });\n  }\n\n  /**\n   * 初始化為觀眾 (Viewer)\n   * @param maxChildren 轉發最大觀眾數 (Layer N Capacity)\n   */\n  public initViewer(maxChildren: number = 4): Promise<string> {\n    this.isStreamer = false;\n\n    return new Promise((resolve, reject) => {\n      this.peer = new Peer();\n\n      this.peer.on('open', async (id) => {\n        this.myPeerId = id;\n        this.options.onStatusChange?.(\"正在分配節點...\");\n        resolve(id);\n        \n        // 開始加入流程\n        await this.connectToMesh();\n      });\n\n      this.peer.on('error', (err) => {\n        this.options.onError?.(err);\n        reject(err);\n      });\n\n      // 當我們自己也是別人的 parent 時，處理下層觀眾連線\n      this.peer.on('connection', (conn) => {\n        conn.on('data', (data: any) => {\n          if (data === 'VIEWER_READY') {\n            if (Object.keys(this.activeCalls).length < maxChildren && this.myStream) {\n              const call = this.peer!.call(conn.peer, this.myStream);\n              this.activeCalls[conn.peer] = call;\n            } else {\n              conn.send({ type: 'REJECT_FULL' });\n            }\n          }\n        });\n\n        conn.on('close', () => {\n          if (this.activeCalls[conn.peer]) {\n            this.activeCalls[conn.peer].close();\n            delete this.activeCalls[conn.peer];\n          }\n        });\n      });\n\n      // 接收上層傳來的影像\n      this.peer.on('call', (call) => {\n        this.options.onStatusChange?.(\"接收影像中...\");\n        this.parentConnection = call;\n        call.answer(); \n        \n        call.on('stream', (remoteStream) => {\n          this.myStream = remoteStream;\n          this.options.onStatusChange?.(\"\"); \n          this.options.onStreamReceived?.(remoteStream);\n        });\n\n        call.on('close', () => {\n          // 上層斷線！啟動 Self-Healing\n          this.handleParentDisconnect(call.peer);\n        });\n      });\n    });\n  }\n\n  private async connectToMesh(): Promise<void> {\n    if (!this.options.fetchParentIdFn) {\n      throw new Error(\"fetchParentIdFn is required for viewers\");\n    }\n\n    try {\n      const targetPeerId = await this.options.fetchParentIdFn();\n      if (!targetPeerId) {\n        this.options.onStatusChange?.(\"暫無可用節點，請稍後重試\");\n        // 可以加上 retry 機制\n        return;\n      }\n\n      this.options.onStatusChange?.(\"連線中...\");\n      const conn = this.peer!.connect(targetPeerId);\n\n      const timeoutId = setTimeout(() => {\n        conn.close();\n        this.handleParentDisconnect(targetPeerId);\n      }, 5000);\n\n      conn.on('open', () => {\n        clearTimeout(timeoutId);\n        conn.send('VIEWER_READY');\n      });\n\n      conn.on('data', (data: any) => {\n        if (data && data.type === 'REJECT_FULL') {\n          clearTimeout(timeoutId);\n          conn.close();\n          this.handleParentDisconnect(targetPeerId);\n        }\n      });\n\n      conn.on('close', () => {\n        clearTimeout(timeoutId);\n        this.handleParentDisconnect(targetPeerId);\n      });\n\n      conn.on('error', () => {\n        clearTimeout(timeoutId);\n        this.handleParentDisconnect(targetPeerId);\n      });\n\n    } catch (e) {\n      this.options.onStatusChange?.(\"連線失敗\");\n      console.error(e);\n    }\n  }\n\n  private async handleParentDisconnect(deadPeerId: string) {\n    if (this.isReconnecting) return;\n    this.isReconnecting = true;\n    this.options.onStatusChange?.(\"上層節點斷線，重新尋找路徑...\");\n\n    if (this.options.reportDeadFn) {\n      await this.options.reportDeadFn(deadPeerId).catch(console.error);\n    }\n\n    // 延遲一下避免大量 request\n    setTimeout(async () => {\n      this.isReconnecting = false;\n      await this.connectToMesh();\n    }, 2000);\n  }\n\n  public destroy() {\n    if (this.peer) {\n      this.peer.destroy();\n      this.peer = null;\n    }\n  }\n}\n"],"mappings":"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","names":["Peer"]}

package/dist/client/index.mjs

@@ -0,0 +1,168 @@
+// src/client/RTCTreeClient.ts
+import Peer from "peerjs";
+var RTCTreeClient = class {
+  constructor(options) {
+    this.options = options;
+    this.peer = null;
+    this.myPeerId = null;
+    this.myStream = null;
+    this.activeCalls = {};
+    this.parentConnection = null;
+    // State
+    this.isStreamer = false;
+    this.isReconnecting = false;
+  }
+  /**
+   * 初始化為直播主 (Streamer)
+   * @param stream 本地攝影機/麥克風的 MediaStream
+   * @param maxChildren 第一層最大觀眾數 (Layer 1 Capacity)
+   * @returns 建立完成後的 Peer ID
+   */
+  initStreamer(stream, maxChildren = 4) {
+    this.isStreamer = true;
+    this.myStream = stream;
+    return new Promise((resolve, reject) => {
+      this.peer = new Peer();
+      this.peer.on("open", (id) => {
+        this.myPeerId = id;
+        this.options.onStatusChange?.("\u76F4\u64AD\u5DF2\u958B\u59CB");
+        resolve(id);
+      });
+      this.peer.on("error", (err) => {
+        this.options.onError?.(err);
+        reject(err);
+      });
+      this.peer.on("connection", (conn) => {
+        conn.on("data", (data) => {
+          if (data === "VIEWER_READY") {
+            if (Object.keys(this.activeCalls).length < maxChildren) {
+              const call = this.peer.call(conn.peer, this.myStream);
+              this.activeCalls[conn.peer] = call;
+            } else {
+              conn.send({ type: "REJECT_FULL" });
+            }
+          }
+        });
+        conn.on("close", () => {
+          if (this.activeCalls[conn.peer]) {
+            this.activeCalls[conn.peer].close();
+            delete this.activeCalls[conn.peer];
+          }
+        });
+      });
+    });
+  }
+  /**
+   * 初始化為觀眾 (Viewer)
+   * @param maxChildren 轉發最大觀眾數 (Layer N Capacity)
+   */
+  initViewer(maxChildren = 4) {
+    this.isStreamer = false;
+    return new Promise((resolve, reject) => {
+      this.peer = new Peer();
+      this.peer.on("open", async (id) => {
+        this.myPeerId = id;
+        this.options.onStatusChange?.("\u6B63\u5728\u5206\u914D\u7BC0\u9EDE...");
+        resolve(id);
+        await this.connectToMesh();
+      });
+      this.peer.on("error", (err) => {
+        this.options.onError?.(err);
+        reject(err);
+      });
+      this.peer.on("connection", (conn) => {
+        conn.on("data", (data) => {
+          if (data === "VIEWER_READY") {
+            if (Object.keys(this.activeCalls).length < maxChildren && this.myStream) {
+              const call = this.peer.call(conn.peer, this.myStream);
+              this.activeCalls[conn.peer] = call;
+            } else {
+              conn.send({ type: "REJECT_FULL" });
+            }
+          }
+        });
+        conn.on("close", () => {
+          if (this.activeCalls[conn.peer]) {
+            this.activeCalls[conn.peer].close();
+            delete this.activeCalls[conn.peer];
+          }
+        });
+      });
+      this.peer.on("call", (call) => {
+        this.options.onStatusChange?.("\u63A5\u6536\u5F71\u50CF\u4E2D...");
+        this.parentConnection = call;
+        call.answer();
+        call.on("stream", (remoteStream) => {
+          this.myStream = remoteStream;
+          this.options.onStatusChange?.("");
+          this.options.onStreamReceived?.(remoteStream);
+        });
+        call.on("close", () => {
+          this.handleParentDisconnect(call.peer);
+        });
+      });
+    });
+  }
+  async connectToMesh() {
+    if (!this.options.fetchParentIdFn) {
+      throw new Error("fetchParentIdFn is required for viewers");
+    }
+    try {
+      const targetPeerId = await this.options.fetchParentIdFn();
+      if (!targetPeerId) {
+        this.options.onStatusChange?.("\u66AB\u7121\u53EF\u7528\u7BC0\u9EDE\uFF0C\u8ACB\u7A0D\u5F8C\u91CD\u8A66");
+        return;
+      }
+      this.options.onStatusChange?.("\u9023\u7DDA\u4E2D...");
+      const conn = this.peer.connect(targetPeerId);
+      const timeoutId = setTimeout(() => {
+        conn.close();
+        this.handleParentDisconnect(targetPeerId);
+      }, 5e3);
+      conn.on("open", () => {
+        clearTimeout(timeoutId);
+        conn.send("VIEWER_READY");
+      });
+      conn.on("data", (data) => {
+        if (data && data.type === "REJECT_FULL") {
+          clearTimeout(timeoutId);
+          conn.close();
+          this.handleParentDisconnect(targetPeerId);
+        }
+      });
+      conn.on("close", () => {
+        clearTimeout(timeoutId);
+        this.handleParentDisconnect(targetPeerId);
+      });
+      conn.on("error", () => {
+        clearTimeout(timeoutId);
+        this.handleParentDisconnect(targetPeerId);
+      });
+    } catch (e) {
+      this.options.onStatusChange?.("\u9023\u7DDA\u5931\u6557");
+      console.error(e);
+    }
+  }
+  async handleParentDisconnect(deadPeerId) {
+    if (this.isReconnecting) return;
+    this.isReconnecting = true;
+    this.options.onStatusChange?.("\u4E0A\u5C64\u7BC0\u9EDE\u65B7\u7DDA\uFF0C\u91CD\u65B0\u5C0B\u627E\u8DEF\u5F91...");
+    if (this.options.reportDeadFn) {
+      await this.options.reportDeadFn(deadPeerId).catch(console.error);
+    }
+    setTimeout(async () => {
+      this.isReconnecting = false;
+      await this.connectToMesh();
+    }, 2e3);
+  }
+  destroy() {
+    if (this.peer) {
+      this.peer.destroy();
+      this.peer = null;
+    }
+  }
+};
+export {
+  RTCTreeClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/RTCTreeClient.ts"],"sourcesContent":["import Peer, { MediaConnection } from 'peerjs';\n\nexport interface RTCTreeClientOptions {\n  onStreamReceived?: (stream: MediaStream) => void;\n  onStatusChange?: (status: string) => void;\n  onError?: (error: any) => void;\n  fetchParentIdFn?: () => Promise<string | null>; // Client uses this to ask Server for a parent\n  reportDeadFn?: (deadPeerId: string) => Promise<void>; // Client uses this to tell Server a node is dead\n}\n\nexport class RTCTreeClient {\n  private peer: Peer | null = null;\n  private myPeerId: string | null = null;\n  private myStream: MediaStream | null = null;\n  private activeCalls: Record<string, MediaConnection> = {};\n  private parentConnection: MediaConnection | null = null;\n  \n  // State\n  private isStreamer: boolean = false;\n  private isReconnecting: boolean = false;\n\n  constructor(private options: RTCTreeClientOptions) {}\n\n  /**\n   * 初始化為直播主 (Streamer)\n   * @param stream 本地攝影機/麥克風的 MediaStream\n   * @param maxChildren 第一層最大觀眾數 (Layer 1 Capacity)\n   * @returns 建立完成後的 Peer ID\n   */\n  public initStreamer(stream: MediaStream, maxChildren: number = 4): Promise<string> {\n    this.isStreamer = true;\n    this.myStream = stream;\n\n    return new Promise((resolve, reject) => {\n      this.peer = new Peer();\n\n      this.peer.on('open', (id) => {\n        this.myPeerId = id;\n        this.options.onStatusChange?.(\"直播已開始\");\n        resolve(id);\n      });\n\n      this.peer.on('error', (err) => {\n        this.options.onError?.(err);\n        reject(err);\n      });\n\n      // 監聽觀眾連線請求\n      this.peer.on('connection', (conn) => {\n        conn.on('data', (data: any) => {\n          if (data === 'VIEWER_READY') {\n            if (Object.keys(this.activeCalls).length < maxChildren) {\n              const call = this.peer!.call(conn.peer, this.myStream!);\n              this.activeCalls[conn.peer] = call;\n            } else {\n              conn.send({ type: 'REJECT_FULL' });\n            }\n          }\n        });\n\n        conn.on('close', () => {\n          if (this.activeCalls[conn.peer]) {\n            this.activeCalls[conn.peer].close();\n            delete this.activeCalls[conn.peer];\n          }\n        });\n      });\n    });\n  }\n\n  /**\n   * 初始化為觀眾 (Viewer)\n   * @param maxChildren 轉發最大觀眾數 (Layer N Capacity)\n   */\n  public initViewer(maxChildren: number = 4): Promise<string> {\n    this.isStreamer = false;\n\n    return new Promise((resolve, reject) => {\n      this.peer = new Peer();\n\n      this.peer.on('open', async (id) => {\n        this.myPeerId = id;\n        this.options.onStatusChange?.(\"正在分配節點...\");\n        resolve(id);\n        \n        // 開始加入流程\n        await this.connectToMesh();\n      });\n\n      this.peer.on('error', (err) => {\n        this.options.onError?.(err);\n        reject(err);\n      });\n\n      // 當我們自己也是別人的 parent 時，處理下層觀眾連線\n      this.peer.on('connection', (conn) => {\n        conn.on('data', (data: any) => {\n          if (data === 'VIEWER_READY') {\n            if (Object.keys(this.activeCalls).length < maxChildren && this.myStream) {\n              const call = this.peer!.call(conn.peer, this.myStream);\n              this.activeCalls[conn.peer] = call;\n            } else {\n              conn.send({ type: 'REJECT_FULL' });\n            }\n          }\n        });\n\n        conn.on('close', () => {\n          if (this.activeCalls[conn.peer]) {\n            this.activeCalls[conn.peer].close();\n            delete this.activeCalls[conn.peer];\n          }\n        });\n      });\n\n      // 接收上層傳來的影像\n      this.peer.on('call', (call) => {\n        this.options.onStatusChange?.(\"接收影像中...\");\n        this.parentConnection = call;\n        call.answer(); \n        \n        call.on('stream', (remoteStream) => {\n          this.myStream = remoteStream;\n          this.options.onStatusChange?.(\"\"); \n          this.options.onStreamReceived?.(remoteStream);\n        });\n\n        call.on('close', () => {\n          // 上層斷線！啟動 Self-Healing\n          this.handleParentDisconnect(call.peer);\n        });\n      });\n    });\n  }\n\n  private async connectToMesh(): Promise<void> {\n    if (!this.options.fetchParentIdFn) {\n      throw new Error(\"fetchParentIdFn is required for viewers\");\n    }\n\n    try {\n      const targetPeerId = await this.options.fetchParentIdFn();\n      if (!targetPeerId) {\n        this.options.onStatusChange?.(\"暫無可用節點，請稍後重試\");\n        // 可以加上 retry 機制\n        return;\n      }\n\n      this.options.onStatusChange?.(\"連線中...\");\n      const conn = this.peer!.connect(targetPeerId);\n\n      const timeoutId = setTimeout(() => {\n        conn.close();\n        this.handleParentDisconnect(targetPeerId);\n      }, 5000);\n\n      conn.on('open', () => {\n        clearTimeout(timeoutId);\n        conn.send('VIEWER_READY');\n      });\n\n      conn.on('data', (data: any) => {\n        if (data && data.type === 'REJECT_FULL') {\n          clearTimeout(timeoutId);\n          conn.close();\n          this.handleParentDisconnect(targetPeerId);\n        }\n      });\n\n      conn.on('close', () => {\n        clearTimeout(timeoutId);\n        this.handleParentDisconnect(targetPeerId);\n      });\n\n      conn.on('error', () => {\n        clearTimeout(timeoutId);\n        this.handleParentDisconnect(targetPeerId);\n      });\n\n    } catch (e) {\n      this.options.onStatusChange?.(\"連線失敗\");\n      console.error(e);\n    }\n  }\n\n  private async handleParentDisconnect(deadPeerId: string) {\n    if (this.isReconnecting) return;\n    this.isReconnecting = true;\n    this.options.onStatusChange?.(\"上層節點斷線，重新尋找路徑...\");\n\n    if (this.options.reportDeadFn) {\n      await this.options.reportDeadFn(deadPeerId).catch(console.error);\n    }\n\n    // 延遲一下避免大量 request\n    setTimeout(async () => {\n      this.isReconnecting = false;\n      await this.connectToMesh();\n    }, 2000);\n  }\n\n  public destroy() {\n    if (this.peer) {\n      this.peer.destroy();\n      this.peer = null;\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './server/index';
+export * from './client/index';