@creativeorange/azure-text-to-speech 2.2.3 → 3.0.0

package/dist/co-azure-tts.es.js

@@ -8350,17 +8350,170 @@ class RestMessageAdapter {
     return Object.keys(params).map((k) => encodeURIComponent(k) + "=" + encodeURIComponent(params[k])).join("&");
   }
 }
+const DEFAULT_TOKEN_LIFETIME_MS = 8 * 60 * 1e3;
+function createSpeechAuthorizationProvider(options) {
+  var _a;
+  const hasTokenEndpoint = typeof options.tokenEndpoint === "string" && options.tokenEndpoint.trim() !== "";
+  const hasProvider = typeof options.getAuthorizationToken === "function";
+  if (hasTokenEndpoint && hasProvider) {
+    throw new Error(
+      "Provide either tokenEndpoint or getAuthorizationToken, not both."
+    );
+  }
+  if (!hasTokenEndpoint && !hasProvider) {
+    throw new Error(
+      "A tokenEndpoint or getAuthorizationToken provider is required."
+    );
+  }
+  if (hasProvider) {
+    return options.getAuthorizationToken;
+  }
+  const tokenEndpoint = options.tokenEndpoint.trim();
+  const requestOptions = (_a = options.tokenRequestOptions) != null ? _a : {};
+  return async () => {
+    var _a2, _b;
+    let response;
+    try {
+      response = await fetch(tokenEndpoint, {
+        method: "GET",
+        credentials: (_a2 = requestOptions.credentials) != null ? _a2 : "same-origin",
+        headers: {
+          Accept: "application/json",
+          ...(_b = requestOptions.headers) != null ? _b : {}
+        }
+      });
+    } catch {
+      throw createSafeError(
+        "Could not reach the speech token endpoint.",
+        "TOKEN_ENDPOINT_UNREACHABLE"
+      );
+    }
+    if (!response.ok) {
+      throw createSafeError(
+        `Speech token endpoint returned HTTP ${response.status}.`,
+        "TOKEN_ENDPOINT_HTTP_ERROR"
+      );
+    }
+    let payload;
+    try {
+      payload = await response.json();
+    } catch {
+      throw createSafeError(
+        "Speech token endpoint returned invalid JSON.",
+        "TOKEN_ENDPOINT_INVALID_JSON"
+      );
+    }
+    return validateSpeechAuthorization(payload);
+  };
+}
+function validateSpeechAuthorization(value) {
+  if (!value || typeof value !== "object") {
+    throw createSafeError(
+      "Speech authorization response must be an object.",
+      "TOKEN_INVALID_RESPONSE"
+    );
+  }
+  const candidate = value;
+  const token = typeof candidate.token === "string" ? candidate.token.trim() : "";
+  const region = typeof candidate.region === "string" ? candidate.region.trim() : "";
+  if (token === "") {
+    throw createSafeError(
+      "Speech authorization token is missing or empty.",
+      "TOKEN_EMPTY"
+    );
+  }
+  if (region === "") {
+    throw createSafeError(
+      "Speech authorization region is missing or empty.",
+      "TOKEN_REGION_MISSING"
+    );
+  }
+  return { token, region };
+}
+function createSafeError(message, code) {
+  const error = new Error(message);
+  error.message = message;
+  if (code) {
+    error.code = code;
+  }
+  return error;
+}
+function toSafeErrorDetail(error) {
+  if (error && typeof error === "object") {
+    const candidate = error;
+    const message = typeof candidate.message === "string" && candidate.message.trim() !== "" ? sanitizeErrorText(candidate.message) : "An unexpected speech error occurred.";
+    const detail = { message };
+    if (typeof candidate.code === "string" && candidate.code.trim() !== "") {
+      detail.code = candidate.code;
+    }
+    return detail;
+  }
+  return {
+    message: "An unexpected speech error occurred."
+  };
+}
+function sanitizeErrorText(message) {
+  return message.replace(/Bearer\s+\S+/gi, "Bearer [redacted]").replace(/token["']?\s*[:=]\s*["']?[^"',\s}]+/gi, "token=[redacted]");
+}
+class SpeechAuthorizationManager {
+  constructor(options) {
+    __publicField(this, "authorization");
+    __publicField(this, "authorizationExpiresAt", 0);
+    __publicField(this, "authorizationRequest");
+    __publicField(this, "provider");
+    __publicField(this, "tokenLifetimeMs");
+    this.provider = createSpeechAuthorizationProvider(options);
+    this.tokenLifetimeMs = options.tokenLifetimeMs && options.tokenLifetimeMs > 0 ? options.tokenLifetimeMs : DEFAULT_TOKEN_LIFETIME_MS;
+  }
+  async getAuthorization() {
+    if (this.authorization && Date.now() < this.authorizationExpiresAt) {
+      return this.authorization;
+    }
+    if (this.authorizationRequest) {
+      return this.authorizationRequest;
+    }
+    this.authorizationRequest = this.fetchAuthorization().then((authorization) => {
+      this.authorization = authorization;
+      this.authorizationExpiresAt = Date.now() + this.tokenLifetimeMs;
+      return authorization;
+    }).finally(() => {
+      this.authorizationRequest = void 0;
+    });
+    return this.authorizationRequest;
+  }
+  clearAuthorization() {
+    this.authorization = void 0;
+    this.authorizationExpiresAt = 0;
+    this.authorizationRequest = void 0;
+  }
+  async fetchAuthorization() {
+    try {
+      const authorization = await this.provider();
+      return validateSpeechAuthorization(authorization);
+    } catch (error) {
+      this.clearAuthorization();
+      throw createSafeError(
+        toSafeErrorDetail(error).message,
+        error == null ? void 0 : error.code
+      );
+    }
+  }
+}
 class SpeechToText {
-  constructor(key, region, sourceLanguage, targetLanguage = null) {
-    __publicField(this, "key");
+  constructor(options) {
     __publicField(this, "region");
     __publicField(this, "sourceLanguage");
     __publicField(this, "targetLanguage");
     __publicField(this, "recognizer");
-    this.key = key;
-    this.region = region;
-    this.sourceLanguage = sourceLanguage;
-    this.targetLanguage = targetLanguage !== null ? targetLanguage : sourceLanguage;
+    __publicField(this, "authorizationManager");
+    var _a, _b, _c;
+    if (!options || typeof options.sourceLanguage !== "string" || options.sourceLanguage.trim() === "") {
+      throw new Error("A sourceLanguage is required.");
+    }
+    this.authorizationManager = new SpeechAuthorizationManager(options);
+    this.region = (_b = (_a = options.region) == null ? void 0 : _a.trim()) != null ? _b : "";
+    this.sourceLanguage = options.sourceLanguage;
+    this.targetLanguage = (_c = options.targetLanguage) != null ? _c : options.sourceLanguage;
   }
   async start() {
     await this.registerBindings(document);
@@ -8384,39 +8537,55 @@ class SpeechToText {
       }
     }
   }
+  async createSpeechTranslationConfig() {
+    const authorization = await this.authorizationManager.getAuthorization();
+    const speechConfig = SpeechTranslationConfig.fromAuthorizationToken(
+      authorization.token,
+      authorization.region
+    );
+    speechConfig.speechRecognitionLanguage = this.sourceLanguage;
+    speechConfig.addTargetLanguage(
+      this.targetLanguage
+    );
+    this.region = authorization.region;
+    return speechConfig;
+  }
   async handleStartModifier(node, attr) {
     node.addEventListener("click", async (_) => {
-      const speechConfig = SpeechTranslationConfig.fromSubscription(this.key, this.region);
-      speechConfig.speechRecognitionLanguage = this.sourceLanguage;
-      speechConfig.addTargetLanguage(this.targetLanguage);
-      const audioConfig = AudioConfig.fromDefaultMicrophoneInput();
-      this.recognizer = new TranslationRecognizer(speechConfig, audioConfig);
-      document.dispatchEvent(new CustomEvent("COAzureSTTStartedRecording", {}));
-      const prevResults = [];
-      this.recognizer.recognizing = (sender, event) => {
-        const result = event.result;
-        if (result && result.reason === ResultReason.TranslatingSpeech) {
-          const translation = result.translations.get(this.targetLanguage);
-          prevResults["result_" + result.privOffset.toString()] = translation;
-          const totalResult = Object.values(prevResults).join(". ");
-          const inputElement = document.getElementById(attr.value);
-          if (inputElement !== null) {
-            if (inputElement instanceof HTMLInputElement) {
-              inputElement.value = `${totalResult} `;
-            } else {
-              inputElement.innerHTML = `${totalResult} `;
+      try {
+        const speechConfig = await this.createSpeechTranslationConfig();
+        const audioConfig = AudioConfig.fromDefaultMicrophoneInput();
+        this.recognizer = new TranslationRecognizer(speechConfig, audioConfig);
+        document.dispatchEvent(new CustomEvent("COAzureSTTStartedRecording", {}));
+        const prevResults = [];
+        this.recognizer.recognizing = (sender, event) => {
+          const result = event.result;
+          if (result && result.reason === ResultReason.TranslatingSpeech) {
+            const translation = result.translations.get(this.targetLanguage);
+            prevResults["result_" + result.privOffset.toString()] = translation;
+            const totalResult = Object.values(prevResults).join(". ");
+            const inputElement = document.getElementById(attr.value);
+            if (inputElement !== null) {
+              if (inputElement instanceof HTMLInputElement) {
+                inputElement.value = `${totalResult} `;
+              } else {
+                inputElement.innerHTML = `${totalResult} `;
+              }
             }
           }
-        }
-      };
-      this.recognizer.startContinuousRecognitionAsync(
-        (result) => {
-        },
-        (err) => {
-          console.log(err);
-          this.stop();
-        }
-      );
+        };
+        this.recognizer.startContinuousRecognitionAsync(
+          () => {
+          },
+          (err) => {
+            this.dispatchError(err, "RECOGNITION_ERROR");
+            this.stop();
+          }
+        );
+      } catch (error) {
+        this.dispatchError(error);
+        await this.stop();
+      }
     });
   }
   async handleStopModifier(node, attr) {
@@ -8426,16 +8595,34 @@ class SpeechToText {
   }
   async stop() {
     if (this.recognizer !== void 0) {
-      this.recognizer.stopContinuousRecognitionAsync();
-      this.recognizer.close();
+      try {
+        this.recognizer.stopContinuousRecognitionAsync();
+      } catch {
+      }
+      try {
+        this.recognizer.close();
+      } catch {
+      }
       this.recognizer = void 0;
     }
     document.dispatchEvent(new CustomEvent("COAzureSTTStoppedRecording", {}));
   }
+  dispatchError(error, code) {
+    const detail = toSafeErrorDetail(error);
+    if (code && !detail.code) {
+      detail.code = code;
+    }
+    document.dispatchEvent(
+      new CustomEvent("COAzureSTTError", {
+        detail: {
+          error: detail
+        }
+      })
+    );
+  }
 }
 class TextToSpeech {
-  constructor(key, region, voice, rate = 0, pitch = 0, url = "") {
-    __publicField(this, "key");
+  constructor(options) {
     __publicField(this, "region");
     __publicField(this, "voice");
     __publicField(this, "rate");
@@ -8462,12 +8649,17 @@ class TextToSpeech {
     __publicField(this, "prefetchPromises", /* @__PURE__ */ new Map());
     __publicField(this, "activePrefetchedAudioUrl", "");
     __publicField(this, "playbackSegments", []);
-    this.key = key;
-    this.region = region;
-    this.voice = voice;
-    this.rate = rate;
-    this.pitch = pitch;
-    this.url = url;
+    __publicField(this, "authorizationManager");
+    var _a, _b, _c, _d, _e;
+    if (!options || typeof options.voice !== "string" || options.voice.trim() === "") {
+      throw new Error("A voice is required.");
+    }
+    this.authorizationManager = new SpeechAuthorizationManager(options);
+    this.region = (_b = (_a = options.region) == null ? void 0 : _a.trim()) != null ? _b : "";
+    this.voice = options.voice;
+    this.rate = (_c = options.rate) != null ? _c : 0;
+    this.pitch = (_d = options.pitch) != null ? _d : 0;
+    this.url = (_e = options.url) != null ? _e : "";
   }
   async start() {
     await this.registerBindings(document);
@@ -8516,7 +8708,7 @@ class TextToSpeech {
   }
   async handleIdModifier(node, attr) {
     node.addEventListener("click", async (_) => {
-      var _a, _b;
+      var _a, _b, _c, _d;
       this.stopPlayer();
       await this.createInterval();
       const referenceDiv = document.getElementById(attr.value);
@@ -8527,10 +8719,10 @@ class TextToSpeech {
       if (referenceDiv.hasAttribute("co-tts.text") && referenceDiv.getAttribute("co-tts.text") !== "") {
         this.textToRead = (_a = referenceDiv.getAttribute("co-tts.text")) != null ? _a : "";
       } else {
-        this.textToRead = referenceDiv.innerText;
+        this.textToRead = (_c = (_b = referenceDiv.innerText) != null ? _b : referenceDiv.textContent) != null ? _c : "";
       }
       if (referenceDiv.hasAttribute("co-tts.highlight")) {
-        if (((_b = referenceDiv.attributes.getNamedItem("co-tts.highlight")) == null ? void 0 : _b.value) !== "") {
+        if (((_d = referenceDiv.attributes.getNamedItem("co-tts.highlight")) == null ? void 0 : _d.value) !== "") {
           const newReferenceDiv = document.getElementById(referenceDiv.attributes.getNamedItem("co-tts.highlight").value);
           this.highlightDiv = newReferenceDiv;
           this.originalHighlightDivInnerHTML = newReferenceDiv.innerHTML;
@@ -8539,7 +8731,7 @@ class TextToSpeech {
           this.originalHighlightDivInnerHTML = referenceDiv.innerHTML;
         }
       }
-      this.startSynthesizer(node, attr);
+      await this.startSynthesizer(node, attr);
     });
   }
   async handleAjaxModifier(node, attr) {
@@ -8551,12 +8743,12 @@ class TextToSpeech {
         method: `GET`
       });
       this.textToRead = await response.text();
-      this.startSynthesizer(node, attr);
+      await this.startSynthesizer(node, attr);
     });
   }
   async handleDefault(node, attr) {
     node.addEventListener("click", async (_) => {
-      var _a;
+      var _a, _b, _c;
       this.stopPlayer();
       await this.createInterval();
       this.clickedNode = node;
@@ -8571,15 +8763,15 @@ class TextToSpeech {
         }
       }
       if (attr.value === "") {
-        this.textToRead = node.innerText;
+        this.textToRead = (_c = (_b = node.innerText) != null ? _b : node.textContent) != null ? _c : "";
       } else {
         this.textToRead = attr.value;
       }
-      this.startSynthesizer(node, attr);
+      await this.startSynthesizer(node, attr);
     });
   }
   async handleWithoutClick(node, attr) {
-    var _a;
+    var _a, _b, _c;
     this.stopPlayer();
     await this.createInterval();
     this.clickedNode = node;
@@ -8596,11 +8788,11 @@ class TextToSpeech {
       }
     }
     if (attr.value === "") {
-      this.textToRead = node.innerText;
+      this.textToRead = (_c = (_b = node.innerText) != null ? _b : node.textContent) != null ? _c : "";
     } else {
       this.textToRead = attr.value;
     }
-    this.startSynthesizer(node, attr);
+    await this.startSynthesizer(node, attr);
   }
   async handleStopModifier(node, attr) {
     node.addEventListener("click", async (_) => {
@@ -8641,66 +8833,83 @@ class TextToSpeech {
       URL.revokeObjectURL(this.activePrefetchedAudioUrl);
       this.activePrefetchedAudioUrl = "";
     }
+    this.closeSynthesizer();
     this.player = void 0;
+    this.audioConfig = void 0;
+    this.speechConfig = void 0;
     this.highlightDiv = void 0;
     this.prevTextOffset = 0;
     this.playbackTextOffsetBase = void 0;
   }
+  async createSpeechConfig() {
+    const authorization = await this.authorizationManager.getAuthorization();
+    const speechConfig = SpeechConfig.fromAuthorizationToken(
+      authorization.token,
+      authorization.region
+    );
+    speechConfig.speechSynthesisVoiceName = `Microsoft Server Speech Text to Speech Voice (${this.voice})`;
+    speechConfig.speechSynthesisOutputFormat = SpeechSynthesisOutputFormat.Audio24Khz160KBitRateMonoMp3;
+    this.region = authorization.region;
+    return speechConfig;
+  }
   async startSynthesizer(node, attr) {
-    this.speechConfig = SpeechConfig.fromSubscription(this.key, this.region);
-    this.speechConfig.speechSynthesisVoiceName = `Microsoft Server Speech Text to Speech Voice (${this.voice})`;
-    this.speechConfig.speechSynthesisOutputFormat = SpeechSynthesisOutputFormat.Audio24Khz160KBitRateMonoMp3;
-    this.player = new SpeakerAudioDestination();
-    this.audioConfig = AudioConfig.fromSpeakerOutput(this.player);
-    this.synthesizer = new SpeechSynthesizer(this.speechConfig, this.audioConfig);
-    this.synthesizer.wordBoundary = (s, e) => {
-      this.wordBoundryList.push(e);
-    };
-    const playbackChain = this.collectPlaybackChain(this.clickedNode);
-    const isChainedPlayback = playbackChain.length > 1;
-    if (isChainedPlayback) {
-      this.preparePlaybackChain(playbackChain);
-    } else {
-      this.playbackSegments = [];
-    }
-    this.player.onAudioEnd = async () => {
-      const wasChainedPlayback = this.playbackSegments.length > 0;
-      this.stopPlayer();
-      if (wasChainedPlayback) {
-        document.dispatchEvent(new CustomEvent("COAzureTTSFinishedPlaying", {}));
-        return;
+    try {
+      this.speechConfig = await this.createSpeechConfig();
+      this.player = new SpeakerAudioDestination();
+      this.audioConfig = AudioConfig.fromSpeakerOutput(this.player);
+      this.synthesizer = new SpeechSynthesizer(this.speechConfig, this.audioConfig);
+      this.synthesizer.wordBoundary = (s, e) => {
+        this.wordBoundryList.push(e);
+      };
+      const playbackChain = this.collectPlaybackChain(this.clickedNode);
+      const isChainedPlayback = playbackChain.length > 1;
+      if (isChainedPlayback) {
+        this.preparePlaybackChain(playbackChain);
+      } else {
+        this.playbackSegments = [];
       }
-      if (this.clickedNode.hasAttribute("co-tts.next")) {
-        const nextNode = document.getElementById(this.clickedNode.getAttribute("co-tts.next"));
-        if (nextNode && await this.playPrefetchedNode(nextNode)) {
+      this.player.onAudioEnd = async () => {
+        const wasChainedPlayback = this.playbackSegments.length > 0;
+        this.stopPlayer();
+        if (wasChainedPlayback) {
+          document.dispatchEvent(new CustomEvent("COAzureTTSFinishedPlaying", {}));
           return;
         }
-        if (nextNode && nextNode.attributes.getNamedItem("co-tts.text")) {
-          this.handleWithoutClick(nextNode, nextNode.attributes.getNamedItem("co-tts.text"));
-        } else if (nextNode) {
-          nextNode.dispatchEvent(new Event("click"));
+        if (this.clickedNode.hasAttribute("co-tts.next")) {
+          const nextNode = document.getElementById(this.clickedNode.getAttribute("co-tts.next"));
+          if (nextNode && await this.playPrefetchedNode(nextNode)) {
+            return;
+          }
+          if (nextNode && nextNode.attributes.getNamedItem("co-tts.text")) {
+            this.handleWithoutClick(nextNode, nextNode.attributes.getNamedItem("co-tts.text"));
+          } else if (nextNode) {
+            nextNode.dispatchEvent(new Event("click"));
+          }
+        } else {
+          document.dispatchEvent(new CustomEvent("COAzureTTSFinishedPlaying", {}));
         }
-      } else {
-        document.dispatchEvent(new CustomEvent("COAzureTTSFinishedPlaying", {}));
-      }
-    };
-    this.player.onAudioStart = async () => {
-      document.dispatchEvent(new CustomEvent("COAzureTTSStartedPlaying", {}));
-    };
-    if (!isChainedPlayback) {
-      this.prefetchNextNode(this.clickedNode);
-    }
-    this.synthesizer.speakSsmlAsync(
-      this.buildSSML(this.textToRead),
-      () => {
-        this.synthesizer.close();
-        this.synthesizer = void 0;
-      },
-      () => {
-        this.synthesizer.close();
-        this.synthesizer = void 0;
+      };
+      this.player.onAudioStart = async () => {
+        document.dispatchEvent(new CustomEvent("COAzureTTSStartedPlaying", {}));
+      };
+      if (!isChainedPlayback) {
+        this.prefetchNextNode(this.clickedNode);
       }
-    );
+      this.synthesizer.speakSsmlAsync(
+        this.buildSSML(this.textToRead),
+        () => {
+          this.closeSynthesizer();
+        },
+        (error) => {
+          this.dispatchError(error, "SYNTHESIS_ERROR");
+          this.closeSynthesizer();
+          this.stopPlayer();
+        }
+      );
+    } catch (error) {
+      this.dispatchError(error);
+      await this.stopPlayer();
+    }
   }
   collectPlaybackChain(node) {
     var _a, _b;
@@ -8796,14 +9005,14 @@ class TextToSpeech {
     this.previousWordBoundary = wordBoundary;
   }
   getNodeText(node, attr) {
-    var _a;
+    var _a, _b, _c;
     if (attr && attr.value !== "") {
       return attr.value;
     }
     if (node.hasAttribute("co-tts.text") && node.getAttribute("co-tts.text") !== "") {
       return (_a = node.getAttribute("co-tts.text")) != null ? _a : "";
     }
-    return node.innerText;
+    return (_c = (_b = node.innerText) != null ? _b : node.textContent) != null ? _c : "";
   }
   getPrefetchKey(node, text) {
     return [
@@ -8842,41 +9051,52 @@ class TextToSpeech {
     if (this.prefetchedAudio.has(key) || this.prefetchPromises.has(key)) {
       return;
     }
-    const speechConfig = SpeechConfig.fromSubscription(this.key, this.region);
-    speechConfig.speechSynthesisVoiceName = `Microsoft Server Speech Text to Speech Voice (${this.voice})`;
-    speechConfig.speechSynthesisOutputFormat = SpeechSynthesisOutputFormat.Audio24Khz160KBitRateMonoMp3;
-    const synthesizer = new SpeechSynthesizer(speechConfig, null);
-    const wordBoundryList = [];
-    synthesizer.wordBoundary = (s, e) => {
-      wordBoundryList.push(e);
-    };
-    const prefetchPromise = new Promise((resolve) => {
-      synthesizer.speakSsmlAsync(
-        this.buildSSML(text),
-        (result) => {
-          synthesizer.close();
-          if (!(result == null ? void 0 : result.audioData)) {
-            resolve(null);
-            return;
-          }
-          const blob = new Blob([result.audioData], { type: "audio/mpeg" });
-          const url = URL.createObjectURL(blob);
-          const prefetch = {
-            key,
-            nodeId: nextNode.id,
-            text,
-            url,
-            wordBoundryList
-          };
-          this.prefetchedAudio.set(key, prefetch);
-          resolve(prefetch);
-        },
-        () => {
-          synthesizer.close();
-          resolve(null);
-        }
-      );
-    }).finally(() => {
+    let synthesizer;
+    const prefetchPromise = (async () => {
+      try {
+        const speechConfig = await this.createSpeechConfig();
+        synthesizer = new SpeechSynthesizer(speechConfig, null);
+        const wordBoundryList = [];
+        synthesizer.wordBoundary = (s, e) => {
+          wordBoundryList.push(e);
+        };
+        return await new Promise((resolve) => {
+          synthesizer == null ? void 0 : synthesizer.speakSsmlAsync(
+            this.buildSSML(text),
+            (result) => {
+              this.closeResource(synthesizer);
+              synthesizer = void 0;
+              if (!(result == null ? void 0 : result.audioData)) {
+                resolve(null);
+                return;
+              }
+              const blob = new Blob([result.audioData], { type: "audio/mpeg" });
+              const url = URL.createObjectURL(blob);
+              const prefetch = {
+                key,
+                nodeId: nextNode.id,
+                text,
+                url,
+                wordBoundryList
+              };
+              this.prefetchedAudio.set(key, prefetch);
+              resolve(prefetch);
+            },
+            (error) => {
+              this.closeResource(synthesizer);
+              synthesizer = void 0;
+              this.dispatchError(error, "PREFETCH_ERROR");
+              resolve(null);
+            }
+          );
+        });
+      } catch (error) {
+        this.closeResource(synthesizer);
+        synthesizer = void 0;
+        this.dispatchError(error);
+        return null;
+      }
+    })().finally(() => {
       this.prefetchPromises.delete(key);
     });
     this.prefetchPromises.set(key, prefetchPromise);
@@ -8913,31 +9133,44 @@ class TextToSpeech {
       }
     }
     await this.createInterval();
-    const audio = new Audio(prefetch.url);
-    this.activePrefetchedAudioUrl = prefetch.url;
-    this.player = audio;
-    audio.addEventListener("play", () => {
-      document.dispatchEvent(new CustomEvent("COAzureTTSStartedPlaying", {}));
-    }, { once: true });
-    audio.addEventListener("ended", async () => {
-      this.stopPlayer();
-      if (this.clickedNode.hasAttribute("co-tts.next")) {
-        const nextNode = document.getElementById(this.clickedNode.getAttribute("co-tts.next"));
-        if (nextNode && await this.playPrefetchedNode(nextNode)) {
-          return;
-        }
-        if (nextNode && nextNode.attributes.getNamedItem("co-tts.text")) {
-          this.handleWithoutClick(nextNode, nextNode.attributes.getNamedItem("co-tts.text"));
-        } else if (nextNode) {
-          nextNode.dispatchEvent(new Event("click"));
+    try {
+      const audio = new Audio(prefetch.url);
+      this.activePrefetchedAudioUrl = prefetch.url;
+      this.player = audio;
+      audio.addEventListener("play", () => {
+        document.dispatchEvent(new CustomEvent("COAzureTTSStartedPlaying", {}));
+      }, { once: true });
+      audio.addEventListener("ended", async () => {
+        this.stopPlayer();
+        if (this.clickedNode.hasAttribute("co-tts.next")) {
+          const nextNode = document.getElementById(this.clickedNode.getAttribute("co-tts.next"));
+          if (nextNode && await this.playPrefetchedNode(nextNode)) {
+            return;
+          }
+          if (nextNode && nextNode.attributes.getNamedItem("co-tts.text")) {
+            this.handleWithoutClick(nextNode, nextNode.attributes.getNamedItem("co-tts.text"));
+          } else if (nextNode) {
+            nextNode.dispatchEvent(new Event("click"));
+          }
+        } else {
+          document.dispatchEvent(new CustomEvent("COAzureTTSFinishedPlaying", {}));
         }
-      } else {
-        document.dispatchEvent(new CustomEvent("COAzureTTSFinishedPlaying", {}));
-      }
-    }, { once: true });
-    this.prefetchNextNode(node);
-    await audio.play();
-    return true;
+      }, { once: true });
+      audio.addEventListener("error", () => {
+        this.dispatchError(
+          new Error("Prefetched audio resource closed unexpectedly."),
+          "AUDIO_RESOURCE_ERROR"
+        );
+        this.stopPlayer();
+      }, { once: true });
+      this.prefetchNextNode(node);
+      await audio.play();
+      return true;
+    } catch (error) {
+      this.dispatchError(error, "AUDIO_RESOURCE_ERROR");
+      await this.stopPlayer();
+      return false;
+    }
   }
   async clearInterval() {
     clearInterval(this.interval);
@@ -9040,5 +9273,31 @@ class TextToSpeech {
     p.textContent = input;
     return p.innerHTML;
   }
+  closeSynthesizer() {
+    this.closeResource(this.synthesizer);
+    this.synthesizer = void 0;
+  }
+  closeResource(resource) {
+    if (!resource || typeof resource.close !== "function") {
+      return;
+    }
+    try {
+      resource.close();
+    } catch {
+    }
+  }
+  dispatchError(error, code) {
+    const detail = toSafeErrorDetail(error);
+    if (code && !detail.code) {
+      detail.code = code;
+    }
+    document.dispatchEvent(
+      new CustomEvent("COAzureTTSError", {
+        detail: {
+          error: detail
+        }
+      })
+    );
+  }
 }
 export { SpeechToText, TextToSpeech };