react-jssip-kit 0.3.1 → 0.4.1

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 (stubbed safely when disabled).
+
 ## 0.1.1
 - Exported `SipSessionState` from the public entrypoint and aligned demo/imports to the new package name.
 

package/dist/index.cjs

@@ -8,7 +8,118 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var JsSIP__default = /*#__PURE__*/_interopDefault(JsSIP);
 
-// src/jssip-lib/sip/userAgent.ts
+// src/jssip-lib/sip/debugger.ts
+var SipDebugger = class {
+  constructor(storageKey = "sip-debug-enabled", defaultPattern = "JsSIP:*") {
+    this.enabled = false;
+    this.storageKey = storageKey;
+    this.defaultPattern = defaultPattern;
+  }
+  initFromSession(storage = safeSessionStorage()) {
+    try {
+      const saved = storage?.getItem(this.storageKey);
+      if (saved) {
+        this.enable(saved === "true" ? this.defaultPattern : saved, storage);
+      }
+    } catch {
+    }
+  }
+  enable(pattern = this.defaultPattern, storage = safeSessionStorage()) {
+    try {
+      if (typeof JsSIP__default.default?.debug?.enable === "function") {
+        JsSIP__default.default.debug.enable(pattern);
+        this.logger = console;
+      }
+      storage?.setItem?.(this.storageKey, pattern || "true");
+      try {
+        window.sipDebugBridge?.(pattern);
+      } catch {
+      }
+      this.enabled = true;
+    } catch {
+    }
+  }
+  disable(storage = safeSessionStorage()) {
+    try {
+      if (typeof JsSIP__default.default?.debug?.disable === "function") {
+        JsSIP__default.default.debug.disable();
+      } else if (typeof JsSIP__default.default?.debug?.enable === "function") {
+        JsSIP__default.default.debug.enable("");
+      }
+      storage?.removeItem?.(this.storageKey);
+      try {
+        window.sipDebugBridge?.(false);
+      } catch {
+      }
+      this.enabled = false;
+    } catch {
+    }
+  }
+  toggle(pattern = this.defaultPattern, storage = safeSessionStorage()) {
+    if (this.isEnabled()) {
+      this.disable(storage);
+    } else {
+      this.enable(pattern, storage);
+    }
+  }
+  isEnabled() {
+    return this.enabled;
+  }
+  attachToWindow(win = window) {
+    const api = {
+      enableDebug: () => {
+        this.enable();
+        return { debug: this.isEnabled(), text: "press F5" };
+      },
+      disableDebug: () => {
+        this.disable();
+        return { debug: this.isEnabled(), text: "press F5" };
+      },
+      toggleDebug: () => {
+        this.toggle();
+        return { debug: this.isEnabled(), text: "press F5" };
+      },
+      debugState: () => ({
+        debug: this.isEnabled(),
+        text: this.isEnabled() ? "enabled" : "disabled"
+      }),
+      sipState: () => {
+        try {
+          const getter = win.sipState;
+          return typeof getter === "function" ? getter() : "sipState helper not available; ensure client debug is enabled";
+        } catch {
+          return "sipState helper not available";
+        }
+      },
+      sipSessions: () => {
+        try {
+          const getter = win.sipSessions;
+          return typeof getter === "function" ? getter() : "sipSessions helper not available; ensure client debug is enabled";
+        } catch {
+          return "sipSessions helper not available";
+        }
+      }
+    };
+    try {
+      win.sipSupport = api;
+    } catch {
+    }
+  }
+};
+function safeSessionStorage() {
+  if (typeof window === "undefined")
+    return null;
+  try {
+    return window.sessionStorage;
+  } catch {
+    return null;
+  }
+}
+var sipDebugger = new SipDebugger();
+if (typeof window !== "undefined") {
+  sipDebugger.attachToWindow();
+  sipDebugger.initFromSession();
+}
 var SipUserAgent = class {
   constructor() {
     this._ua = null;
@@ -717,10 +828,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
@@ -778,6 +885,7 @@ var SessionLifecycle = class {
 };
 
 // src/jssip-lib/sip/client.ts
+var SESSION_DEBUG_KEY = "sip-debug-enabled";
 var SipClient = class extends EventTargetEmitter {
   constructor(options = {}) {
     super();
@@ -807,6 +915,9 @@ var SipClient = class extends EventTargetEmitter {
       attachSessionHandlers: (sessionId, session) => this.attachSessionHandlers(sessionId, session),
       getMaxSessionCount: () => this.maxSessionCount
     });
+    if (typeof window !== "undefined") {
+      window.sipDebugBridge = (debug) => this.setDebug(debug ?? true);
+    }
   }
   get state() {
     return this.stateStore.getState();
@@ -814,13 +925,19 @@ 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;
+    const debug = cfgDebug ?? this.getPersistedDebug() ?? this.debugPattern;
     this.userAgent.start(uri, password, uaCfg, { debug });
     this.attachUAHandlers();
     this.attachBeforeUnload();
+    this.syncDebugInspector(debug);
   }
   registerUA() {
     this.userAgent.register();
@@ -847,11 +964,11 @@ var SipClient = class extends EventTargetEmitter {
       });
     }
   }
-  answer(options = {}) {
-    const sessionId = this.resolveExistingSessionId();
-    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(sessionId, options) {
     const resolved = this.resolveExistingSessionId(sessionId);
@@ -864,21 +981,20 @@ var SipClient = class extends EventTargetEmitter {
     ids.forEach((id) => this.hangupSession(id, options));
     return ids.length > 0;
   }
-  toggleMute() {
-    return this.toggleMuteSession();
+  toggleMute(sessionId) {
+    return this.toggleMuteSession(sessionId);
   }
-  toggleHold() {
-    return this.toggleHoldSession();
+  toggleHold(sessionId) {
+    return this.toggleHoldSession(sessionId);
   }
-  sendDTMF(tones, options) {
-    const sessionId = this.resolveExistingSessionId();
-    return this.sendDTMFSession(tones, options, sessionId ?? void 0);
+  sendDTMF(sessionId, tones, options) {
+    return this.sendDTMFSession(sessionId, tones, options);
   }
-  transfer(target, options) {
-    return this.transferSession(target, options);
+  transfer(sessionId, target, options) {
+    return this.transferSession(sessionId, target, options);
   }
-  attendedTransfer(otherSession) {
-    return this.attendedTransferSession(otherSession);
+  attendedTransfer(sessionId, otherSession) {
+    return this.attendedTransferSession(sessionId, otherSession);
   }
   onChange(fn) {
     return this.stateStore.onChange(fn);
@@ -897,6 +1013,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);
@@ -1040,7 +1157,7 @@ var SipClient = class extends EventTargetEmitter {
     }
     return true;
   }
-  sendDTMFSession(tones, options, sessionId) {
+  sendDTMFSession(sessionId, tones, options) {
     const resolved = this.resolveExistingSessionId(sessionId);
     if (!resolved)
       return false;
@@ -1049,7 +1166,7 @@ var SipClient = class extends EventTargetEmitter {
       this.sessionManager.sendDTMF(resolved, tones, options);
     return true;
   }
-  transferSession(target, options, sessionId) {
+  transferSession(sessionId, target, options) {
     const resolved = this.resolveExistingSessionId(sessionId);
     if (!resolved)
       return false;
@@ -1058,7 +1175,7 @@ var SipClient = class extends EventTargetEmitter {
       this.sessionManager.transfer(resolved, target, options);
     return true;
   }
-  attendedTransferSession(otherSession, sessionId) {
+  attendedTransferSession(sessionId, otherSession) {
     const resolved = this.resolveExistingSessionId(sessionId);
     if (!resolved)
       return false;
@@ -1068,8 +1185,6 @@ var SipClient = class extends EventTargetEmitter {
     return true;
   }
   setSessionMedia(sessionId, stream) {
-    if (!this.sessionExists(sessionId))
-      return;
     this.sessionManager.setSessionMedia(sessionId, stream);
   }
   switchCameraSession(sessionId, track) {
@@ -1078,11 +1193,6 @@ var SipClient = class extends EventTargetEmitter {
     const rtc = this.sessionManager.getRtc(sessionId);
     return rtc ? rtc.switchCamera(track) : false;
   }
-  startScreenShareSession(sessionId, getDisplayMedia) {
-    if (!this.sessionExists(sessionId))
-      return false;
-    return this.sessionManager.startScreenShare(sessionId, getDisplayMedia);
-  }
   enableVideoSession(sessionId) {
     if (!this.sessionExists(sessionId))
       return false;
@@ -1122,6 +1232,59 @@ var SipClient = class extends EventTargetEmitter {
     window.removeEventListener("beforeunload", this.unloadHandler);
     this.unloadHandler = void 0;
   }
+  syncDebugInspector(debug) {
+    if (typeof window === "undefined")
+      return;
+    this.toggleStateLogger(Boolean(debug));
+    const win = window;
+    const disabledInspector = () => {
+      console.warn("SIP debug inspector disabled; enable debug to inspect.");
+      return null;
+    };
+    win.sipState = () => debug ? this.stateStore.getState() : disabledInspector();
+    win.sipSessions = () => debug ? this.getSessions() : disabledInspector();
+  }
+  toggleStateLogger(enabled) {
+    if (!enabled) {
+      this.stateLogOff?.();
+      this.stateLogOff = void 0;
+      return;
+    }
+    if (this.stateLogOff)
+      return;
+    let prev = this.stateStore.getState();
+    console.info("[sip][state]", { initial: true }, prev);
+    this.stateLogOff = this.stateStore.onChange((next) => {
+      const changes = this.diffState(prev, next);
+      if (changes) {
+        console.info("[sip][state]", changes, next);
+      }
+      prev = next;
+    });
+  }
+  diffState(prev, next) {
+    const changed = {};
+    for (const key of Object.keys(next)) {
+      if (prev[key] !== next[key]) {
+        changed[key] = { from: prev[key], to: next[key] };
+      }
+    }
+    return Object.keys(changed).length ? changed : null;
+  }
+  getPersistedDebug() {
+    if (typeof window === "undefined")
+      return void 0;
+    try {
+      const persisted = window.sessionStorage.getItem(SESSION_DEBUG_KEY);
+      if (!persisted)
+        return void 0;
+      if (persisted === "true")
+        return true;
+      return persisted;
+    } catch {
+      return void 0;
+    }
+  }
 };
 function createSipClientInstance(options) {
   return new SipClient(options);
@@ -1201,7 +1364,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)
     }),