@lakutata/webrtc 3.1.4 → 3.1.5

package/README.md

@@ -26,7 +26,8 @@ npm install @lakutata/webrtc
 An application also needs `lakutata` (or `@lakutata/core` and `@lakutata/entrypoint`). The signaling is served over
 Socket.IO (`npm install socket.io`) or JSON-RPC over WebSocket (`npm install ws`), through the adapters of the
 entrypoint. An application joining rooms over Socket.IO needs `socket.io-client`; over JSON-RPC, it uses the
-`WebSocket` built into Node.js 22 and Bun. Instances working together need `nats` or `ioredis`.
+`WebSocket` built into Node.js 22 and Bun, else the `WebSocket` of `ws` (Node.js 18 to 21). Instances working together
+need `nats` or `ioredis`.
 
 A frontend installs the same package and imports `@lakutata/webrtc/client`; the framework is not installed with it.
 

package/README.zh-CN.md

@@ -15,7 +15,7 @@
 npm install @lakutata/webrtc
 ```
 
-应用还需要 `lakutata`（或者 `@lakutata/core` 和 `@lakutata/entrypoint`）。信令通过 entrypoint 的适配器提供，走 Socket.IO（`npm install socket.io`）或 WebSocket 上的 JSON-RPC（`npm install ws`）。应用作为成员通过 Socket.IO 加入房间时需要 `socket.io-client`；通过 JSON-RPC 加入时，使用 Node.js 22 和 Bun 自带的 `WebSocket`。多个实例协同工作时需要 `nats` 或 `ioredis`。
+应用还需要 `lakutata`（或者 `@lakutata/core` 和 `@lakutata/entrypoint`）。信令通过 entrypoint 的适配器提供，走 Socket.IO（`npm install socket.io`）或 WebSocket 上的 JSON-RPC（`npm install ws`）。应用作为成员通过 Socket.IO 加入房间时需要 `socket.io-client`；通过 JSON-RPC 加入时，使用 Node.js 22 和 Bun 自带的 `WebSocket`，没有时使用 `ws` 的 `WebSocket`（Node.js 18 到 21）。多个实例协同工作时需要 `nats` 或 `ioredis`。
 
 前端安装同一个包，引用 `@lakutata/webrtc/client`；框架不会随之安装。
 

package/dist/cjs/exceptions/SignalingConnectionException.d.ts

@@ -2,7 +2,7 @@ import { Exception } from '@lakutata/core';
 /**
  * Thrown when `SignalingClient` cannot use the transport of its URL: Socket.IO (an `http:` or `https:` URL) needs the
  * package `socket.io-client`, JSON-RPC (a `ws:` or `wss:` URL) needs the global `WebSocket` (Node.js 22 and later,
- * Bun). Its `errno` is `'E_SIGNALING_CONNECTION'`.
+ * Bun) or the package `ws`. Its `errno` is `'E_SIGNALING_CONNECTION'`.
  */
 export declare class SignalingConnectionException extends Exception {
     /**

package/dist/cjs/exceptions/SignalingConnectionException.js

@@ -5,7 +5,7 @@ const core_1 = require("@lakutata/core");
 /**
  * Thrown when `SignalingClient` cannot use the transport of its URL: Socket.IO (an `http:` or `https:` URL) needs the
  * package `socket.io-client`, JSON-RPC (a `ws:` or `wss:` URL) needs the global `WebSocket` (Node.js 22 and later,
- * Bun). Its `errno` is `'E_SIGNALING_CONNECTION'`.
+ * Bun) or the package `ws`. Its `errno` is `'E_SIGNALING_CONNECTION'`.
  */
 class SignalingConnectionException extends core_1.Exception {
     constructor() {

package/dist/cjs/lib/peer/peerConnection.d.ts

@@ -56,6 +56,7 @@ export declare class RTCPeerConnection extends EventTarget {
     private readonly sctpManager;
     private readonly secureManager;
     private isClosed;
+    private closing?;
     private shouldNegotiationneeded;
     private lastCreatedAnswer?;
     private lastCreatedOffer?;
@@ -307,6 +308,7 @@ export declare class RTCPeerConnection extends EventTarget {
     private createPeerConnectionStats;
     getStats(selector?: MediaStreamTrack | null): Promise<RTCStatsReport>;
     close(): Promise<void>;
+    private closeOnce;
     private completePeerEvents;
 }
 export type DebugConfig = Partial<{

package/dist/cjs/lib/peer/peerConnection.js

@@ -1399,8 +1399,10 @@ class RTCPeerConnection extends helper_js_1.EventTarget {
         return (0, stats_js_1.buildStatsReport)(stats, this.transceiverManager.getStatsRootIds(selector));
     }
     async close() {
-        if (this.isClosed)
-            return;
+        this.closing ??= this.closeOnce();
+        return this.closing;
+    }
+    async closeOnce() {
         this.isClosed = true;
         this.pendingRemoteCandidates.length = 0;
         this.setSignalingState('closed');

package/dist/cjs/peer/PeerThreads.js

@@ -8,10 +8,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PeerThreads = void 0;
 exports.buildPeerThreadsOptions = buildPeerThreadsOptions;
-const node_os_1 = require("node:os");
+const node_os_1 = __importDefault(require("node:os"));
 const node_worker_threads_1 = require("node:worker_threads");
 const core_1 = require("@lakutata/core");
 const di_1 = require("@lakutata/core/decorator/di");
@@ -24,6 +27,13 @@ const log = (0, log_js_1.debug)('webrtc/peer/threads');
  * How long a thread asked to stop has to close its connections, in milliseconds
  */
 const STOP_TIMEOUT = 5000;
+/**
+ * The parallelism the system advises: os.availableParallelism (Node.js 18.14, 19.4), else the cores
+ */
+function parallelism() {
+    //node-compat: os.availableParallelism
+    return typeof node_os_1.default.availableParallelism === 'function' ? node_os_1.default.availableParallelism() : Math.max(1, node_os_1.default.cpus().length);
+}
 /**
  * Worker threads serving connections, to use more cores: a {@link PeerConnection} given the name of this component
  * (its `threads` option) runs its ICE, DTLS, SCTP and SRTP there, while its object, its events and the messages of its
@@ -67,7 +77,7 @@ let PeerThreads = class PeerThreads extends core_1.Component {
     async init() {
         if (!PeerWorkerCode_js_1.peerWorkerCode)
             throw new Error('The code of the worker threads of the connections is not built (scripts/workers.mjs)');
-        const count = this.threads ?? Math.max(1, (0, node_os_1.availableParallelism)() - 1);
+        const count = this.threads ?? Math.max(1, parallelism() - 1);
         this.#slots = Array.from({ length: count }, (_, index) => ({ index: index, connections: new Map(), opening: 0 }));
         log_js_1.debugHandlerWatchers.add(this.#debugging);
     }