@absolutejs/voice 0.0.22-beta.645 → 0.0.22-beta.646

package/dist/client/index.d.ts

@@ -1,6 +1,8 @@
 export { bindVoiceReactiveSource, voiceSseReactiveSource, } from "./reactiveSource";
 export type { VoiceReactiveSource, VoiceSseReactiveSourceOptions, } from "./reactiveSource";
 export { createVoiceConnection } from "./connection";
+export { checkBrowserVoiceSupport, probeBrowserVoiceSupport, } from "./browserVoiceSupport";
+export type { BrowserVoiceSupportProbe, BrowserVoiceSupportReport, } from "./browserVoiceSupport";
 export { createVoiceAudioPlayer, decodeVoiceAudioChunk } from "./audioPlayer";
 export { createTimeStretcher, type TimeStretcher } from "./timeStretch";
 export { createVoiceStream } from "./createVoiceStream";

package/dist/client/index.js

@@ -375,6 +375,88 @@ var createVoiceConnection = (path, options = {}) => {
     getSessionId: () => state.sessionId
   };
 };
+// src/client/browserVoiceSupport.ts
+var safeGet = (fn) => {
+  try {
+    return fn();
+  } catch {
+    return;
+  }
+};
+var detectMediaRecorderOpus = (ctor) => {
+  if (!ctor || typeof ctor.isTypeSupported !== "function")
+    return false;
+  try {
+    return ctor.isTypeSupported("audio/webm;codecs=opus");
+  } catch {
+    return false;
+  }
+};
+var checkBrowserVoiceSupport = (globalScope = globalThis) => {
+  const capabilities = probeBrowserVoiceSupport(globalScope);
+  const blockers = [];
+  const warnings = [];
+  if (!capabilities.hasWebSocket) {
+    blockers.push("WebSocket is not available \u2014 voice runtime cannot stream audio.");
+  }
+  if (!capabilities.hasGetUserMedia) {
+    blockers.push("navigator.mediaDevices.getUserMedia is not available \u2014 cannot capture microphone.");
+  }
+  if (capabilities.isInsecureContext) {
+    blockers.push("Page is served from an insecure context; getUserMedia requires HTTPS or localhost.");
+  }
+  if (!capabilities.hasAudioContext) {
+    blockers.push("AudioContext is not available \u2014 cannot decode or play TTS audio.");
+  }
+  if (!capabilities.hasAudioWorklet) {
+    warnings.push("AudioWorklet is unavailable \u2014 noise suppression and custom audio processors won't run.");
+  }
+  if (!capabilities.hasRTCPeerConnection) {
+    warnings.push("RTCPeerConnection is unavailable \u2014 WebRTC transport paths are disabled.");
+  }
+  if (!capabilities.hasOpusEncoding) {
+    warnings.push("MediaRecorder does not advertise Opus support \u2014 fall back to PCM streaming.");
+  }
+  if (capabilities.requiresUserGestureToResumeAudio) {
+    warnings.push("Safari / iOS requires a user gesture before audioContext.resume() succeeds.");
+  }
+  return {
+    blockers,
+    capabilities,
+    ok: blockers.length === 0,
+    warnings
+  };
+};
+var probeBrowserVoiceSupport = (globalScope = globalThis) => {
+  const win = globalScope;
+  const userAgent = win.navigator?.userAgent ?? "";
+  const audioContextCtor = win.AudioContext ?? win.webkitAudioContext;
+  const hasAudioContext = typeof audioContextCtor === "function";
+  const hasAudioWorklet = hasAudioContext ? safeGet(() => ("audioWorklet" in audioContextCtor.prototype)) === true : false;
+  const hasGetUserMedia = Boolean(win.navigator?.mediaDevices && typeof win.navigator.mediaDevices.getUserMedia === "function");
+  const hasMediaRecorder = typeof win.MediaRecorder === "function";
+  const hasRTCPeerConnection = typeof win.RTCPeerConnection === "function";
+  const hasWebSocket = typeof win.WebSocket === "function";
+  const isInsecureContext = typeof win.isSecureContext === "boolean" ? !win.isSecureContext : false;
+  const isSafari = /^((?!chrome|android).)*safari/i.test(userAgent);
+  const isIos = /iPad|iPhone|iPod/.test(userAgent);
+  const requiresUserGestureToResumeAudio = isSafari || isIos;
+  const hasOpusEncoding = detectMediaRecorderOpus(win.MediaRecorder);
+  return {
+    hasAudioContext,
+    hasAudioWorklet,
+    hasGetUserMedia,
+    hasMediaRecorder,
+    hasOpusEncoding,
+    hasRTCPeerConnection,
+    hasWebSocket,
+    isInsecureContext,
+    isIos,
+    isSafari,
+    requiresUserGestureToResumeAudio,
+    userAgent
+  };
+};
 // src/client/timeStretch.ts
 var HOP_MS = 10;
 var SEEK_MS = 5;
@@ -12464,6 +12546,7 @@ export {
   renderVoiceCallDebuggerLaunchHTML,
   renderVoiceAgentSquadStatusHTML,
   recordVoiceOpsActionResult,
+  probeBrowserVoiceSupport,
   postVoiceLiveOpsAction,
   mountVoiceTurnQuality,
   mountVoiceTurnLatency,
@@ -12609,6 +12692,7 @@ export {
   createVoiceAgentSquadStatusStore,
   createTimeStretcher,
   createMicrophoneCapture,
+  checkBrowserVoiceSupport,
   buildVoiceAgentSquadStatusReport,
   bindVoiceReactiveSource,
   bindVoiceProviderSimulationControls,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.645",
+  "version": "0.0.22-beta.646",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",