@marianmeres/webrtc 1.2.4 → 1.2.5

package/dist/webrtc-manager.js

@@ -241,7 +241,7 @@ export class WebRtcManager {
             return devices.filter((d) => d.kind === "audioinput");
         }
         catch (e) {
-            this.#logger.error("[WebRtcManager] Failed to enumerate devices:", e);
+            this.#logError("Failed to enumerate devices:", e);
             return [];
         }
     }
@@ -252,7 +252,7 @@ export class WebRtcManager {
      */
     async switchMicrophone(deviceId) {
         if (!this.#pc || !this.#localStream) {
-            this.#logger.error("[WebRtcManager] Cannot switch microphone: not initialized or no active stream");
+            this.#logError("Cannot switch microphone: not initialized or no active stream");
             return false;
         }
         try {
@@ -288,8 +288,8 @@ export class WebRtcManager {
             return true;
         }
         catch (e) {
-            this.#logger.error("[WebRtcManager] Failed to switch microphone:", e);
-            this.#error(e);
+            this.#logError("Failed to switch microphone:", e);
+            this.#handleError(e);
             return false;
         }
     }
@@ -299,19 +299,19 @@ export class WebRtcManager {
      */
     async initialize() {
         if (this.state !== WebRtcState.IDLE) {
-            this.#debug("initialize() called but state is not IDLE:", this.state);
+            this.#logDebug("initialize() called but state is not IDLE:", this.state);
             return;
         }
-        this.#debug("Initializing...");
+        this.#logDebug("Initializing...");
         this.#dispatch(WebRtcFsmEvent.INIT);
         try {
             this.#pc = this.#factory.createPeerConnection(this.#config.peerConfig);
-            this.#debug("Peer connection created");
+            this.#logDebug("Peer connection created");
             this.#setupPcListeners();
             // Setup device change detection now that we have a connection
             this.#setupDeviceChangeListener();
             if (this.#config.enableMicrophone) {
-                this.#debug("Enabling microphone (config enabled)");
+                this.#logDebug("Enabling microphone (config enabled)");
                 const success = await this.enableMicrophone(true);
                 if (!success) {
                     this.#pubsub.publish(WebRtcManager.EVENT_MICROPHONE_FAILED, {
@@ -323,16 +323,17 @@ export class WebRtcManager {
                 // Always setup to receive audio, even if we don't enable microphone
                 // This ensures the SDP includes audio media line
                 this.#pc.addTransceiver("audio", { direction: "recvonly" });
-                this.#debug("Added recvonly audio transceiver");
+                this.#logDebug("Added recvonly audio transceiver");
             }
             if (this.#config.dataChannelLabel) {
-                this.#debug("Creating default data channel:", this.#config.dataChannelLabel);
+                this.#logDebug("Creating default data channel:", this.#config.dataChannelLabel);
                 this.createDataChannel(this.#config.dataChannelLabel);
             }
-            this.#debug("Initialization complete");
+            this.#logDebug("Initialization complete");
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
         }
     }
     /**
@@ -340,15 +341,15 @@ export class WebRtcManager {
      * If disconnected, reinitializes the peer connection.
      */
     async connect() {
-        this.#debug("connect() called, current state:", this.state);
+        this.#logDebug("connect() called, current state:", this.state);
         // Initialize if needed
         if (this.state === WebRtcState.IDLE) {
-            this.#debug("State is IDLE, initializing first");
+            this.#logDebug("State is IDLE, initializing first");
             await this.initialize();
         }
         // Reinitialize if disconnected (PeerConnection was closed)
         if (this.state === WebRtcState.DISCONNECTED) {
-            this.#debug("State is DISCONNECTED, reinitializing");
+            this.#logDebug("State is DISCONNECTED, reinitializing");
             // Clean up old connection
             this.#cleanup();
             // Reset to IDLE and reinitialize
@@ -359,10 +360,10 @@ export class WebRtcManager {
         }
         if (this.state === WebRtcState.CONNECTED ||
             this.state === WebRtcState.CONNECTING) {
-            this.#debug("Already connected or connecting, skipping");
+            this.#logDebug("Already connected or connecting, skipping");
             return;
         }
-        this.#debug("Transitioning to CONNECTING");
+        this.#logDebug("Transitioning to CONNECTING");
         this.#dispatch(WebRtcFsmEvent.CONNECT);
     }
     /**
@@ -371,19 +372,19 @@ export class WebRtcManager {
      * @returns True if successful, false if failed to get user media.
      */
     async enableMicrophone(enable) {
-        this.#debug("enableMicrophone() called:", enable);
+        this.#logDebug("enableMicrophone() called:", enable);
         if (enable) {
             if (this.#localStream) {
-                this.#debug("Microphone already enabled");
+                this.#logDebug("Microphone already enabled");
                 return true;
             }
             try {
-                this.#debug("Requesting user media...");
+                this.#logDebug("Requesting user media...");
                 const stream = await this.#factory.getUserMedia({
                     audio: true,
                     video: false,
                 });
-                this.#debug("User media obtained, tracks:", stream.getAudioTracks().length);
+                this.#logDebug("User media obtained, tracks:", stream.getAudioTracks().length);
                 this.#localStream = stream;
                 this.#pubsub.publish(WebRtcManager.EVENT_LOCAL_STREAM, stream);
                 if (this.#pc) {
@@ -396,21 +397,21 @@ export class WebRtcManager {
                         await audioTransceiver.sender.replaceTrack(track);
                         // Update direction to sendrecv
                         audioTransceiver.direction = "sendrecv";
-                        this.#debug("Replaced track in existing transceiver");
+                        this.#logDebug("Replaced track in existing transceiver");
                     }
                     else {
                         // Add track normally
                         stream.getTracks().forEach((track) => {
                             this.#pc.addTrack(track, stream);
                         });
-                        this.#debug("Added tracks to peer connection");
+                        this.#logDebug("Added tracks to peer connection");
                     }
                 }
-                this.#debug("Microphone enabled successfully");
+                this.#logDebug("Microphone enabled successfully");
                 return true;
             }
             catch (e) {
-                this.#logger.error("[WebRtcManager] Failed to get user media:", e);
+                this.#logError("Failed to get user media:", e);
                 this.#pubsub.publish(WebRtcManager.EVENT_MICROPHONE_FAILED, {
                     error: e,
                 });
@@ -419,10 +420,10 @@ export class WebRtcManager {
         }
         else {
             if (!this.#localStream) {
-                this.#debug("Microphone already disabled");
+                this.#logDebug("Microphone already disabled");
                 return true;
             }
-            this.#debug("Disabling microphone...");
+            this.#logDebug("Disabling microphone...");
             this.#localStream.getTracks().forEach((track) => {
                 track.stop();
                 // Remove from PC if needed, or just stop sending
@@ -436,7 +437,7 @@ export class WebRtcManager {
             });
             this.#localStream = null;
             this.#pubsub.publish(WebRtcManager.EVENT_LOCAL_STREAM, null);
-            this.#debug("Microphone disabled");
+            this.#logDebug("Microphone disabled");
             return true;
         }
     }
@@ -445,7 +446,7 @@ export class WebRtcManager {
      * Transitions to DISCONNECTED state.
      */
     disconnect() {
-        this.#debug("disconnect() called");
+        this.#logDebug("disconnect() called");
         this.#cleanup();
         this.#dispatch(WebRtcFsmEvent.DISCONNECT);
     }
@@ -454,7 +455,7 @@ export class WebRtcManager {
      * Cleans up all resources and allows reinitialization.
      */
     reset() {
-        this.#debug("reset() called, current state:", this.state);
+        this.#logDebug("reset() called, current state:", this.state);
         this.#cleanup();
         // Reset from any non-IDLE state
         if (this.state !== WebRtcState.IDLE) {
@@ -470,7 +471,7 @@ export class WebRtcManager {
                 this.#dispatch(WebRtcFsmEvent.RESET);
             }
         }
-        this.#debug("Reset complete, state:", this.state);
+        this.#logDebug("Reset complete, state:", this.state);
     }
     /**
      * Creates a new data channel with the specified label.
@@ -480,24 +481,25 @@ export class WebRtcManager {
      * @returns The created data channel, or null if peer connection not initialized.
      */
     createDataChannel(label, options) {
-        this.#debug("createDataChannel() called:", label);
+        this.#logDebug("createDataChannel() called:", label);
         if (!this.#pc) {
-            this.#debug("Cannot create data channel: peer connection not initialized");
+            this.#logDebug("Cannot create data channel: peer connection not initialized");
             return null;
         }
         if (this.#dataChannels.has(label)) {
-            this.#debug("Returning existing data channel:", label);
+            this.#logDebug("Returning existing data channel:", label);
             return this.#dataChannels.get(label);
         }
         try {
             const dc = this.#pc.createDataChannel(label, options);
             this.#setupDataChannelListeners(dc);
             this.#dataChannels.set(label, dc);
-            this.#debug("Data channel created:", label);
+            this.#logDebug("Data channel created:", label);
             return dc;
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return null;
         }
     }
@@ -519,11 +521,11 @@ export class WebRtcManager {
     sendData(label, data) {
         const channel = this.#dataChannels.get(label);
         if (!channel) {
-            this.#debug(`Data channel '${label}' not found`);
+            this.#logDebug(`Data channel '${label}' not found`);
             return false;
         }
         if (channel.readyState !== "open") {
-            this.#debug(`Data channel '${label}' is not open (state: ${channel.readyState})`);
+            this.#logDebug(`Data channel '${label}' is not open (state: ${channel.readyState})`);
             return false;
         }
         try {
@@ -532,7 +534,8 @@ export class WebRtcManager {
             return true;
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return false;
         }
     }
@@ -543,18 +546,19 @@ export class WebRtcManager {
      * @returns The offer SDP, or null if peer connection not initialized.
      */
     async createOffer(options) {
-        this.#debug("createOffer() called");
+        this.#logDebug("createOffer() called");
         if (!this.#pc) {
-            this.#debug("Cannot create offer: peer connection not initialized");
+            this.#logDebug("Cannot create offer: peer connection not initialized");
             return null;
         }
         try {
             const offer = await this.#pc.createOffer(options);
-            this.#debug("Offer created:", offer.type);
+            this.#logDebug("Offer created:", offer.type);
             return offer;
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return null;
         }
     }
@@ -564,18 +568,19 @@ export class WebRtcManager {
      * @returns The answer SDP, or null if peer connection not initialized.
      */
     async createAnswer(options) {
-        this.#debug("createAnswer() called");
+        this.#logDebug("createAnswer() called");
         if (!this.#pc) {
-            this.#debug("Cannot create answer: peer connection not initialized");
+            this.#logDebug("Cannot create answer: peer connection not initialized");
             return null;
         }
         try {
             const answer = await this.#pc.createAnswer(options);
-            this.#debug("Answer created:", answer.type);
+            this.#logDebug("Answer created:", answer.type);
             return answer;
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return null;
         }
     }
@@ -585,18 +590,19 @@ export class WebRtcManager {
      * @returns True if successful, false otherwise.
      */
     async setLocalDescription(description) {
-        this.#debug("setLocalDescription() called:", description.type);
+        this.#logDebug("setLocalDescription() called:", description.type);
         if (!this.#pc) {
-            this.#debug("Cannot set local description: peer connection not initialized");
+            this.#logDebug("Cannot set local description: peer connection not initialized");
             return false;
         }
         try {
             await this.#pc.setLocalDescription(description);
-            this.#debug("Local description set successfully");
+            this.#logDebug("Local description set successfully");
             return true;
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return false;
         }
     }
@@ -606,18 +612,19 @@ export class WebRtcManager {
      * @returns True if successful, false otherwise.
      */
     async setRemoteDescription(description) {
-        this.#debug("setRemoteDescription() called:", description.type);
+        this.#logDebug("setRemoteDescription() called:", description.type);
         if (!this.#pc) {
-            this.#debug("Cannot set remote description: peer connection not initialized");
+            this.#logDebug("Cannot set remote description: peer connection not initialized");
             return false;
         }
         try {
             await this.#pc.setRemoteDescription(description);
-            this.#debug("Remote description set successfully");
+            this.#logDebug("Remote description set successfully");
             return true;
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return false;
         }
     }
@@ -627,20 +634,21 @@ export class WebRtcManager {
      * @returns True if successful, false otherwise.
      */
     async addIceCandidate(candidate) {
-        this.#debug("addIceCandidate() called:", candidate ? "candidate" : "null (end-of-candidates)");
+        this.#logDebug("addIceCandidate() called:", candidate ? "candidate" : "null (end-of-candidates)");
         if (!this.#pc) {
-            this.#debug("Cannot add ICE candidate: peer connection not initialized");
+            this.#logDebug("Cannot add ICE candidate: peer connection not initialized");
             return false;
         }
         try {
             if (candidate) {
                 await this.#pc.addIceCandidate(candidate);
-                this.#debug("ICE candidate added");
+                this.#logDebug("ICE candidate added");
             }
             return true;
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return false;
         }
     }
@@ -650,19 +658,20 @@ export class WebRtcManager {
      * @returns True if successful, false otherwise.
      */
     async iceRestart() {
-        this.#debug("iceRestart() called");
+        this.#logDebug("iceRestart() called");
         if (!this.#pc) {
-            this.#debug("Cannot perform ICE restart: peer connection not initialized");
+            this.#logDebug("Cannot perform ICE restart: peer connection not initialized");
             return false;
         }
         try {
             const offer = await this.#pc.createOffer({ iceRestart: true });
             await this.#pc.setLocalDescription(offer);
-            this.#debug("ICE restart initiated");
+            this.#logDebug("ICE restart initiated");
             return true;
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return false;
         }
     }
@@ -691,7 +700,8 @@ export class WebRtcManager {
             return await this.#pc.getStats();
         }
         catch (e) {
-            this.#error(e);
+            this.#logError(e);
+            this.#handleError(e);
             return null;
         }
     }
@@ -701,12 +711,12 @@ export class WebRtcManager {
         this.#fsm.transition(event);
         const newState = this.#fsm.state;
         if (oldState !== newState) {
-            this.#debug("State transition:", oldState, "->", newState, "(event:", event + ")");
+            this.#logDebug("State transition:", oldState, "->", newState, "(event:", event + ")");
             this.#pubsub.publish(WebRtcManager.EVENT_STATE_CHANGE, newState);
         }
     }
     // deno-lint-ignore no-explicit-any
-    #debug(...args) {
+    #logDebug(...args) {
         if (this.#config.debug) {
             this.#logger.debug("[WebRtcManager]", ...args);
         }
@@ -716,22 +726,25 @@ export class WebRtcManager {
         this.#logger.log("[WebRtcManager]", ...args);
     }
     // deno-lint-ignore no-explicit-any
-    #warn(...args) {
+    #logWarn(...args) {
         this.#logger.warn("[WebRtcManager]", ...args);
     }
     // deno-lint-ignore no-explicit-any
-    #error(error) {
-        this.#logger.error("[WebRtcManager]", error);
+    #logError(...args) {
+        this.#logger.error("[WebRtcManager]", ...args);
+    }
+    // deno-lint-ignore no-explicit-any
+    #handleError(error) {
         this.#dispatch(WebRtcFsmEvent.ERROR);
         this.#pubsub.publish(WebRtcManager.EVENT_ERROR, error);
     }
     #setupPcListeners() {
         if (!this.#pc)
             return;
-        this.#debug("Setting up peer connection listeners");
+        this.#logDebug("Setting up peer connection listeners");
         this.#pc.onconnectionstatechange = () => {
             const state = this.#pc.connectionState;
-            this.#debug("Connection state changed:", state);
+            this.#logDebug("Connection state changed:", state);
             if (state === "connected") {
                 // Connection successful - reset reconnect attempts and clear any pending timeout
                 this.#reconnectAttempts = 0;
@@ -755,7 +768,7 @@ export class WebRtcManager {
             }
         };
         this.#pc.ontrack = (event) => {
-            this.#debug("Remote track received:", event.track.kind);
+            this.#logDebug("Remote track received:", event.track.kind);
             if (event.streams && event.streams[0]) {
                 this.#remoteStream = event.streams[0];
                 this.#pubsub.publish(WebRtcManager.EVENT_REMOTE_STREAM, this.#remoteStream);
@@ -763,17 +776,17 @@ export class WebRtcManager {
         };
         this.#pc.ondatachannel = (event) => {
             const dc = event.channel;
-            this.#debug("Remote data channel received:", dc.label);
+            this.#logDebug("Remote data channel received:", dc.label);
             this.#setupDataChannelListeners(dc);
             this.#dataChannels.set(dc.label, dc);
         };
         this.#pc.onicecandidate = (event) => {
-            this.#debug("ICE candidate generated:", event.candidate ? "candidate" : "null (gathering complete)");
+            this.#logDebug("ICE candidate generated:", event.candidate ? "candidate" : "null (gathering complete)");
             this.#pubsub.publish(WebRtcManager.EVENT_ICE_CANDIDATE, event.candidate);
         };
     }
     #cleanup() {
-        this.#debug("Cleanup started");
+        this.#logDebug("Cleanup started");
         // Clear any pending reconnect timers
         if (this.#reconnectTimer !== null) {
             clearTimeout(this.#reconnectTimer);
@@ -798,25 +811,25 @@ export class WebRtcManager {
         });
         this.#dataChannels.clear();
         if (dcCount > 0) {
-            this.#debug("Closed", dcCount, "data channel(s)");
+            this.#logDebug("Closed", dcCount, "data channel(s)");
         }
         // Stop local stream tracks
         if (this.#localStream) {
             this.#localStream.getTracks().forEach((track) => track.stop());
             this.#localStream = null;
-            this.#debug("Local stream stopped");
+            this.#logDebug("Local stream stopped");
         }
         // Close peer connection
         if (this.#pc) {
             this.#pc.close();
             this.#pc = null;
-            this.#debug("Peer connection closed");
+            this.#logDebug("Peer connection closed");
         }
         this.#remoteStream = null;
-        this.#debug("Cleanup complete");
+        this.#logDebug("Cleanup complete");
     }
     #handleConnectionFailure() {
-        this.#debug("Handling connection failure");
+        this.#logDebug("Handling connection failure");
         // Only dispatch DISCONNECT if not already in a terminal state
         if (this.state !== WebRtcState.DISCONNECTED &&
             this.state !== WebRtcState.ERROR &&
@@ -825,13 +838,13 @@ export class WebRtcManager {
         }
         // Check if auto-reconnect is enabled
         if (!this.#config.autoReconnect) {
-            this.#debug("Auto-reconnect disabled, not attempting reconnection");
+            this.#logDebug("Auto-reconnect disabled, not attempting reconnection");
             return;
         }
         const maxAttempts = this.#config.maxReconnectAttempts ?? 5;
         // Check if we've exceeded max attempts
         if (this.#reconnectAttempts >= maxAttempts) {
-            this.#debug("Max reconnection attempts reached:", maxAttempts);
+            this.#logDebug("Max reconnection attempts reached:", maxAttempts);
             this.#pubsub.publish(WebRtcManager.EVENT_RECONNECT_FAILED, {
                 attempts: this.#reconnectAttempts,
             });
@@ -848,7 +861,7 @@ export class WebRtcManager {
                 strategy,
             });
             if (!shouldProceed) {
-                this.#debug("Reconnection suppressed by shouldReconnect callback");
+                this.#logDebug("Reconnection suppressed by shouldReconnect callback");
                 return;
             }
         }
@@ -863,7 +876,7 @@ export class WebRtcManager {
         const delay = baseDelay * Math.pow(2, this.#reconnectAttempts - 1);
         // Try ICE restart first (attempts 1-2), then full reconnect
         const strategy = this.#reconnectAttempts <= 2 ? "ice-restart" : "full";
-        this.#debug("Attempting reconnection:", {
+        this.#logDebug("Attempting reconnection:", {
             attempt: this.#reconnectAttempts,
             strategy,
             delay: delay + "ms",
@@ -901,13 +914,13 @@ export class WebRtcManager {
                         this.#fullReconnectTimeoutTimer = null;
                         // Only trigger failure if still not connected
                         if (this.state !== WebRtcState.CONNECTED) {
-                            this.#debug("Full reconnection timeout reached, connection not established");
+                            this.#logDebug("Full reconnection timeout reached, connection not established");
                             this.#handleConnectionFailure();
                         }
                     }, timeout);
                 }
                 catch (e) {
-                    this.#logger.error("[WebRtcManager] Reconnection failed:", e);
+                    this.#logError("Reconnection failed:", e);
                     this.#handleConnectionFailure();
                 }
             }
@@ -928,7 +941,7 @@ export class WebRtcManager {
                 this.#pubsub.publish(WebRtcManager.EVENT_DEVICE_CHANGED, devices);
             }
             catch (e) {
-                this.#logger.error("[WebRtcManager] Error handling device change:", e);
+                this.#logError("Error handling device change:", e);
             }
         };
         navigator.mediaDevices.addEventListener("devicechange", this.#deviceChangeHandler);
@@ -952,7 +965,7 @@ export class WebRtcManager {
             // Ignore "User-Initiated Abort" errors which occur during intentional close()
             const isUserAbort = error?.error?.message?.includes("User-Initiated Abort");
             if (!isUserAbort) {
-                this.#logger.error("[WebRtcManager] Data channel error:", error);
+                this.#logError("Data channel error:", error);
                 this.#pubsub.publish(WebRtcManager.EVENT_ERROR, error);
             }
         };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@marianmeres/webrtc",
-	"version": "1.2.4",
+	"version": "1.2.5",
 	"type": "module",
 	"main": "dist/mod.js",
 	"types": "dist/mod.d.ts",
@@ -13,7 +13,7 @@
 	"author": "Marian Meres",
 	"license": "MIT",
 	"dependencies": {
-		"@marianmeres/fsm": "^2.11.0",
+		"@marianmeres/fsm": "^2.11.1",
 		"@marianmeres/pubsub": "^2.4.4"
 	},
 	"repository": {