react-jssip-kit 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -4,7 +4,7 @@
 - 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.
+- 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;
@@ -774,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();
@@ -803,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();
@@ -818,7 +933,7 @@ var SipClient = class extends EventTargetEmitter {
     } = 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();
@@ -1120,18 +1235,55 @@ var SipClient = class extends EventTargetEmitter {
   syncDebugInspector(debug) {
     if (typeof window === "undefined")
       return;
-    const enabled = Boolean(debug);
+    this.toggleStateLogger(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 {
+    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) {