@burdenoff/website-sdk 2026.828.5 → 2026.828.7

package/dist/hooks/index.mjs

@@ -1276,11 +1276,40 @@ function getRecognitionCtor() {
   const w = window;
   return w.SpeechRecognition ?? w.webkitSpeechRecognition ?? null;
 }
+var MIC_DENIED_MESSAGE = "Microphone access was blocked. Allow it in your browser's site settings to dictate.";
+async function ensureMicrophoneAccess() {
+  const media = typeof navigator === "undefined" ? void 0 : navigator.mediaDevices;
+  if (!media?.getUserMedia) return { ok: true, confirmed: false };
+  try {
+    const status = await navigator.permissions?.query({
+      name: "microphone"
+    });
+    if (status?.state === "granted") return { ok: true, confirmed: true };
+  } catch {
+  }
+  try {
+    const stream = await media.getUserMedia({ audio: true });
+    for (const track of stream.getTracks()) track.stop();
+    return { ok: true, confirmed: true };
+  } catch (error) {
+    const name = typeof error === "object" && error !== null && "name" in error ? String(error.name) : "";
+    if (name === "NotAllowedError" || name === "SecurityError") {
+      return { ok: false, message: MIC_DENIED_MESSAGE };
+    }
+    if (name === "NotFoundError" || name === "DevicesNotFoundError") {
+      return { ok: false, message: "No microphone was found." };
+    }
+    return {
+      ok: false,
+      message: "Dictation could not start. You can type instead."
+    };
+  }
+}
 function describeError(code) {
   switch (code) {
     case "not-allowed":
     case "service-not-allowed":
-      return "Microphone access was blocked. Allow it in your browser's site settings to dictate.";
+      return MIC_DENIED_MESSAGE;
     case "no-speech":
       return "I didn't catch anything \u2014 try again a little closer to the mic.";
     case "audio-capture":
@@ -1303,11 +1332,23 @@ function useSpeechInput({
   const [interim, setInterim] = useState("");
   const [error, setError] = useState(null);
   const recognitionRef = useRef(null);
+  const startTokenRef = useRef(0);
+  const micConfirmedRef = useRef(false);
+  const beginRecognitionRef = useRef(null);
+  const beginRecognition = useCallback(
+    (Ctor, token) => {
+      beginRecognitionRef.current?.(Ctor, token);
+    },
+    []
+  );
   const finalRef = useRef(onFinalTranscript);
   const errorRef = useRef(onError);
   finalRef.current = onFinalTranscript;
   errorRef.current = onError;
   const stop = useCallback(() => {
+    startTokenRef.current += 1;
+    setListening(false);
+    setInterim("");
     const recognition = recognitionRef.current;
     if (!recognition) return;
     try {
@@ -1321,48 +1362,70 @@ function useSpeechInput({
     const Ctor = getRecognitionCtor();
     if (!Ctor) return;
     if (recognitionRef.current) stop();
-    const recognition = new Ctor();
-    recognition.lang = lang ?? (typeof navigator === "undefined" ? "en-US" : navigator.language || "en-US");
-    recognition.continuous = true;
-    recognition.interimResults = true;
-    recognition.maxAlternatives = 1;
-    recognition.onstart = () => {
-      setError(null);
-      setListening(true);
-    };
-    recognition.onresult = (event) => {
-      let settled = "";
-      let pending = "";
-      for (let i = event.resultIndex; i < event.results.length; i += 1) {
-        const result = event.results[i];
-        if (!result) continue;
-        const text = result[0]?.transcript ?? "";
-        if (result.isFinal) settled += text;
-        else pending += text;
+    setError(null);
+    setListening(true);
+    startTokenRef.current += 1;
+    const token = startTokenRef.current;
+    void ensureMicrophoneAccess().then((access) => {
+      if (token !== startTokenRef.current) return;
+      micConfirmedRef.current = access.ok && access.confirmed;
+      if (!access.ok) {
+        setListening(false);
+        setError(access.message);
+        errorRef.current?.(access.message);
+        return;
       }
-      setInterim(pending);
-      if (settled.trim() !== "") finalRef.current(settled);
-    };
-    recognition.onerror = (event) => {
-      const message = describeError(event.error);
-      setListening(false);
-      setInterim("");
-      if (message !== "") {
-        setError(message);
-        errorRef.current?.(message);
+      beginRecognition(Ctor, token);
+    });
+  }, [beginRecognition, stop]);
+  const beginRecognitionImpl = useCallback(
+    (Ctor, token) => {
+      const recognition = new Ctor();
+      recognition.lang = lang ?? (typeof navigator === "undefined" ? "en-US" : navigator.language || "en-US");
+      recognition.continuous = true;
+      recognition.interimResults = true;
+      recognition.maxAlternatives = 1;
+      recognition.onstart = () => {
+        if (token !== startTokenRef.current) return;
+        setError(null);
+        setListening(true);
+      };
+      recognition.onresult = (event) => {
+        let settled = "";
+        let pending = "";
+        for (let i = event.resultIndex; i < event.results.length; i += 1) {
+          const result = event.results[i];
+          if (!result) continue;
+          const text = result[0]?.transcript ?? "";
+          if (result.isFinal) settled += text;
+          else pending += text;
+        }
+        setInterim(pending);
+        if (settled.trim() !== "") finalRef.current(settled);
+      };
+      recognition.onerror = (event) => {
+        const message = micConfirmedRef.current && (event.error === "not-allowed" || event.error === "service-not-allowed") ? "Dictation isn't available in this browser. You can type instead." : describeError(event.error);
+        setListening(false);
+        setInterim("");
+        if (message !== "") {
+          setError(message);
+          errorRef.current?.(message);
+        }
+      };
+      recognition.onend = () => {
+        setListening(false);
+        setInterim("");
+      };
+      recognitionRef.current = recognition;
+      try {
+        recognition.start();
+      } catch {
+        setListening(false);
       }
-    };
-    recognition.onend = () => {
-      setListening(false);
-      setInterim("");
-    };
-    recognitionRef.current = recognition;
-    try {
-      recognition.start();
-    } catch {
-      setListening(false);
-    }
-  }, [lang, stop]);
+    },
+    [lang]
+  );
+  beginRecognitionRef.current = beginRecognitionImpl;
   const toggle = useCallback(() => {
     if (listening) stop();
     else start();