react-jssip-kit 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.4.0
+- Breaking: public client control methods now require an explicit `sessionId` as the first argument (`answer`, `hangup`, mute/hold toggles, DTMF/transfer helpers).
+- Added exports for client-facing types (events, options, RTCSession/UA maps) from the package entrypoint for easier consumption.
+- Allow setting media on a session id before the session object is attached to retain pending streams.
+- When debug is enabled, expose `window.sipState()` and `window.sipSessions()` helpers for quick inspection.
+
 ## 0.1.1
 - Exported `SipSessionState` from the public entrypoint and aligned demo/imports to the new package name.
 

package/dist/index.cjs

@@ -717,10 +717,6 @@ var SessionManager = class {
     const rtc = this.getRtc(sessionId);
     return rtc ? rtc.attendedTransfer(otherSession) : false;
   }
-  startScreenShare(sessionId, getDisplayMedia) {
-    const rtc = this.getRtc(sessionId);
-    return rtc ? rtc.startScreenShare(getDisplayMedia) : false;
-  }
 };
 
 // src/jssip-lib/sip/sessionLifecycle.ts
@@ -814,17 +810,25 @@ var SipClient = class extends EventTargetEmitter {
   connect(uri, password, config) {
     this.disconnect();
     this.stateStore.setState({ sipStatus: SipStatus.Connecting });
-    const { debug: cfgDebug, maxSessionCount, pendingMediaTtlMs, ...uaCfg } = config;
+    const {
+      debug: cfgDebug,
+      maxSessionCount,
+      pendingMediaTtlMs,
+      ...uaCfg
+    } = config;
     this.maxSessionCount = typeof maxSessionCount === "number" ? maxSessionCount : Infinity;
     this.sessionManager.setPendingMediaTtl(pendingMediaTtlMs);
     const debug = this.debugPattern ?? cfgDebug;
     this.userAgent.start(uri, password, uaCfg, { debug });
     this.attachUAHandlers();
+    this.attachBeforeUnload();
+    this.syncDebugInspector(debug);
   }
   registerUA() {
     this.userAgent.register();
   }
   disconnect() {
+    this.detachBeforeUnload();
     this.detachUAHandlers();
     this.userAgent.stop();
     this.cleanupAllSessions();
@@ -845,33 +849,37 @@ var SipClient = class extends EventTargetEmitter {
       });
     }
   }
-  answer(options = {}) {
-    const sessionId = this.resolveSessionId();
-    if (!sessionId)
+  answer(sessionId, options = {}) {
+    const resolved = this.resolveExistingSessionId(sessionId);
+    if (!resolved)
       return false;
-    return this.answerSession(sessionId, options);
+    return this.answerSession(resolved, options);
   }
-  hangup(options) {
-    const sessionId = this.resolveSessionId();
-    if (!sessionId)
+  hangup(sessionId, options) {
+    const resolved = this.resolveExistingSessionId(sessionId);
+    if (!resolved)
       return false;
-    return this.hangupSession(sessionId, options);
+    return this.hangupSession(resolved, options);
   }
-  toggleMute() {
-    return this.toggleMuteSession();
+  hangupAll(options) {
+    const ids = this.getSessionIds();
+    ids.forEach((id) => this.hangupSession(id, options));
+    return ids.length > 0;
   }
-  toggleHold() {
-    return this.toggleHoldSession();
+  toggleMute(sessionId) {
+    return this.toggleMuteSession(sessionId);
   }
-  sendDTMF(tones, options) {
-    const sessionId = this.resolveSessionId();
-    return this.sendDTMFSession(tones, options, sessionId ?? void 0);
+  toggleHold(sessionId) {
+    return this.toggleHoldSession(sessionId);
   }
-  transfer(target, options) {
-    return this.transferSession(target, options);
+  sendDTMF(sessionId, tones, options) {
+    return this.sendDTMFSession(sessionId, tones, options);
   }
-  attendedTransfer(otherSession) {
-    return this.attendedTransferSession(otherSession);
+  transfer(sessionId, target, options) {
+    return this.transferSession(sessionId, target, options);
+  }
+  attendedTransfer(sessionId, otherSession) {
+    return this.attendedTransferSession(sessionId, otherSession);
   }
   onChange(fn) {
     return this.stateStore.onChange(fn);
@@ -890,6 +898,7 @@ var SipClient = class extends EventTargetEmitter {
   setDebug(debug) {
     this.debugPattern = debug;
     this.userAgent.setDebug(debug);
+    this.syncDebugInspector(debug);
   }
   attachSessionHandlers(sessionId, session) {
     const handlers = this.createSessionHandlersFor(sessionId, session);
@@ -979,24 +988,33 @@ var SipClient = class extends EventTargetEmitter {
     const active = sessions.find((s) => s.status === CallStatus.Active);
     return active?.id ?? sessions[0]?.id ?? null;
   }
+  sessionExists(sessionId) {
+    return !!this.sessionManager.getSession(sessionId) || !!this.sessionManager.getRtc(sessionId);
+  }
+  resolveExistingSessionId(sessionId) {
+    const id = this.resolveSessionId(sessionId);
+    if (!id)
+      return null;
+    return this.sessionExists(id) ? id : null;
+  }
   ensureMediaConstraints(opts) {
     if (opts.mediaStream || opts.mediaConstraints)
       return opts;
     return { ...opts, mediaConstraints: { audio: true, video: false } };
   }
   answerSession(sessionId, options = {}) {
-    if (!sessionId)
+    if (!sessionId || !this.sessionExists(sessionId))
       return false;
     const opts = this.ensureMediaConstraints(options);
     return this.sessionManager.answer(sessionId, opts);
   }
   hangupSession(sessionId, options) {
-    if (!sessionId)
+    if (!sessionId || !this.sessionExists(sessionId))
       return false;
     return this.sessionManager.hangup(sessionId, options);
   }
   toggleMuteSession(sessionId) {
-    const resolved = this.resolveSessionId(sessionId);
+    const resolved = this.resolveExistingSessionId(sessionId);
     if (!resolved)
       return false;
     const sessionState = this.stateStore.getState().sessions.find((s) => s.id === resolved);
@@ -1009,7 +1027,7 @@ var SipClient = class extends EventTargetEmitter {
     return true;
   }
   toggleHoldSession(sessionId) {
-    const resolved = this.resolveSessionId(sessionId);
+    const resolved = this.resolveExistingSessionId(sessionId);
     if (!resolved)
       return false;
     const sessionState = this.stateStore.getState().sessions.find((s) => s.id === resolved);
@@ -1024,8 +1042,8 @@ var SipClient = class extends EventTargetEmitter {
     }
     return true;
   }
-  sendDTMFSession(tones, options, sessionId) {
-    const resolved = this.resolveSessionId(sessionId);
+  sendDTMFSession(sessionId, tones, options) {
+    const resolved = this.resolveExistingSessionId(sessionId);
     if (!resolved)
       return false;
     const sessionState = this.stateStore.getState().sessions.find((s) => s.id === resolved);
@@ -1033,8 +1051,8 @@ var SipClient = class extends EventTargetEmitter {
       this.sessionManager.sendDTMF(resolved, tones, options);
     return true;
   }
-  transferSession(target, options, sessionId) {
-    const resolved = this.resolveSessionId(sessionId);
+  transferSession(sessionId, target, options) {
+    const resolved = this.resolveExistingSessionId(sessionId);
     if (!resolved)
       return false;
     const sessionState = this.stateStore.getState().sessions.find((s) => s.id === resolved);
@@ -1042,8 +1060,8 @@ var SipClient = class extends EventTargetEmitter {
       this.sessionManager.transfer(resolved, target, options);
     return true;
   }
-  attendedTransferSession(otherSession, sessionId) {
-    const resolved = this.resolveSessionId(sessionId);
+  attendedTransferSession(sessionId, otherSession) {
+    const resolved = this.resolveExistingSessionId(sessionId);
     if (!resolved)
       return false;
     const sessionState = this.stateStore.getState().sessions.find((s) => s.id === resolved);
@@ -1055,18 +1073,21 @@ var SipClient = class extends EventTargetEmitter {
     this.sessionManager.setSessionMedia(sessionId, stream);
   }
   switchCameraSession(sessionId, track) {
+    if (!this.sessionExists(sessionId))
+      return false;
     const rtc = this.sessionManager.getRtc(sessionId);
     return rtc ? rtc.switchCamera(track) : false;
   }
-  startScreenShareSession(sessionId, getDisplayMedia) {
-    return this.sessionManager.startScreenShare(sessionId, getDisplayMedia);
-  }
   enableVideoSession(sessionId) {
+    if (!this.sessionExists(sessionId))
+      return false;
     const rtc = this.sessionManager.getRtc(sessionId);
     rtc?.enableVideo();
     return !!rtc;
   }
   disableVideoSession(sessionId) {
+    if (!this.sessionExists(sessionId))
+      return false;
     const rtc = this.sessionManager.getRtc(sessionId);
     rtc?.disableVideo();
     return !!rtc;
@@ -1080,6 +1101,38 @@ var SipClient = class extends EventTargetEmitter {
   getSessions() {
     return this.sessionManager.getSessions();
   }
+  attachBeforeUnload() {
+    if (typeof window === "undefined" || this.unloadHandler)
+      return;
+    const handler = () => {
+      this.hangupAll();
+      this.disconnect();
+    };
+    window.addEventListener("beforeunload", handler);
+    this.unloadHandler = handler;
+  }
+  detachBeforeUnload() {
+    if (typeof window === "undefined" || !this.unloadHandler)
+      return;
+    window.removeEventListener("beforeunload", this.unloadHandler);
+    this.unloadHandler = void 0;
+  }
+  syncDebugInspector(debug) {
+    if (typeof window === "undefined")
+      return;
+    const enabled = Boolean(debug);
+    const win = window;
+    if (enabled) {
+      win.sipState = () => this.stateStore.getState();
+      win.sipSessions = () => this.getSessions();
+    } else {
+      try {
+        delete win.sipState;
+        delete win.sipSessions;
+      } catch {
+      }
+    }
+  }
 };
 function createSipClientInstance(options) {
   return new SipClient(options);
@@ -1159,7 +1212,6 @@ function useSipActions() {
       getSessions: () => client.getSessions(),
       setSessionMedia: (...args) => client.setSessionMedia(...args),
       switchCamera: (...args) => client.switchCameraSession(...args),
-      startScreenShare: (...args) => client.startScreenShareSession(...args),
       enableVideo: (...args) => client.enableVideoSession(...args),
       disableVideo: (...args) => client.disableVideoSession(...args)
     }),