ssml-builder-js 2.15.0 → 2.16.0

package/dist/core.js

@@ -43,6 +43,7 @@ __export(core_exports, {
   parseSsml: () => parseSsml,
   splitSsmlDocument: () => splitSsmlDocument,
   validateAzureSsml: () => validateAzureSsml,
+  validateAzureSsmlChunks: () => validateAzureSsmlChunks,
   validateSsml: () => validateSsml,
   validateSsmlStructureIntegrity: () => validateSsmlStructureIntegrity
 });
@@ -2059,6 +2060,7 @@ function tokenizeElements(source) {
     if (parent) parent.childElementCount += 1;
     const parentVoiceName = [...openElements].reverse().find((element) => element.voiceName)?.voiceName;
     const tokenName = nameMatch[1];
+    const path = parent ? [...parent.path, `${tokenName}[${childElementIndex ?? 0}]`] : [tokenName];
     const tokenVoiceName = tokenName.toLowerCase() === "voice" ? attributes.get("name") : tokenName.toLowerCase() === "mstts:turn" ? attributes.get("voice") ?? parentVoiceName : parentVoiceName;
     tokens.push({
       attributes,
@@ -2069,12 +2071,14 @@ function tokenizeElements(source) {
       parentName: parent?.name,
       parentVoiceName,
       selfClosing,
-      start
+      start,
+      path
     });
     if (!selfClosing) {
       openElements.push({
         childElementCount: 0,
         name: tokenName,
+        path,
         voiceName: tokenVoiceName
       });
     }
@@ -2087,13 +2091,14 @@ function location(source, offset) {
   const line = before.split("\n").length;
   return { line, column: before.length - (before.lastIndexOf("\n") + 1) + 1 };
 }
-function addDiagnostic(diagnostics, source, offset, message, severity = "error", code) {
+function addDiagnostic(diagnostics, source, offset, message, severity = "error", code, metadata = {}) {
   diagnostics.push({
     ...location(source, offset),
     message,
     severity,
     source: "ssml-static-validator",
-    ...code ? { code } : {}
+    ...code ? { code } : {},
+    ...metadata
   });
 }
 function isSupportedProsodyRate(value) {
@@ -2566,9 +2571,11 @@ function validateAzureSsmlStatic(ssml, options = {}) {
   for (const token of tokens) {
     const tokenName = token.name.toLowerCase();
     const tokenVoiceName = tokenName === "voice" ? attr(token, "name")?.trim() : tokenName === "mstts:turn" ? attr(token, "voice")?.trim() || token.parentVoiceName : options.validateNestedVoices === false ? voiceName : token.parentVoiceName;
+    const tokenDiagnosticStart = diagnostics.length;
     validateElement(token, ssml, diagnostics, tokenVoiceName, options, voiceCatalog);
     const definition = tokenVoiceName ? voiceCatalog.get(tokenVoiceName.toLowerCase()) : void 0;
     validateVoiceFeatureMatrix(token, ssml, diagnostics, tokenVoiceName, definition);
+    annotateTokenDiagnostics(diagnostics, tokenDiagnosticStart, token, options, tokenVoiceName);
     if (tokenName === "voice" && options.model && definition?.models && !definition.models.some((model) => model.toLowerCase() === options.model?.toLowerCase())) {
       addDiagnostic(
         diagnostics,
@@ -2590,12 +2597,30 @@ function urlAttributes(token) {
     return value === void 0 ? [] : [{ attribute, value }];
   });
 }
+function annotateTokenDiagnostics(diagnostics, startIndex, token, options, voiceName) {
+  const attributes = [...token.attributes.keys()];
+  for (const diagnostic of diagnostics.slice(startIndex)) {
+    const attributeName = attributes.find(
+      (attribute) => new RegExp(`(?:<[^> ]+\\s+|")${attribute}(?:"|>|\\s)`, "i").test(diagnostic.message)
+    );
+    const nodePath = options.sourceNodePath ? [...options.sourceNodePath] : [...token.path];
+    Object.assign(diagnostic, {
+      range: { start: token.start, end: token.end + 1 },
+      tagName: token.name,
+      ...attributeName ? { attributeName } : {},
+      ...voiceName ? { voiceName } : {},
+      ...options.chunkIndex !== void 0 ? { chunkIndex: options.chunkIndex } : {},
+      nodePath,
+      targetNodePath: [...token.path]
+    });
+  }
+}
 function validateAzureSsml(ssml, options = {}) {
   const diagnostics = validateAzureSsmlStatic(ssml, options);
   const validator = options.urlValidator ?? options.customUrlValidator;
   if (!validator || typeof ssml !== "string") return diagnostics;
   const runnerOptions = options.urlValidation ?? {};
-  const boundedValidator = createAzureUrlValidatorRunner(validator, {
+  const boundedValidator = options.urlValidatorRunner ?? createAzureUrlValidatorRunner(validator, {
     ...runnerOptions,
     ...options.urlValidatorConcurrency !== void 0 ? { concurrency: options.urlValidatorConcurrency } : {},
     ...options.urlValidatorTimeoutMs !== void 0 ? { timeoutMs: options.urlValidatorTimeoutMs } : {},
@@ -2620,26 +2645,46 @@ function validateAzureSsml(ssml, options = {}) {
         const valid = typeof result === "boolean" ? result : result.valid;
         if (!valid) {
           const reason = typeof result === "boolean" ? void 0 : result.reason;
+          const diagnosticStart = diagnostics.length;
           addDiagnostic(
             diagnostics,
             ssml,
             token.start,
             `<${token.name} ${attribute}> was rejected by the custom URL validator${reason ? `: ${reason}` : "."}`
           );
+          annotateTokenDiagnostics(diagnostics, diagnosticStart, token, options, token.parentVoiceName);
         }
       } catch (error) {
         const reason = error instanceof Error ? error.message : String(error);
+        const diagnosticStart = diagnostics.length;
         addDiagnostic(
           diagnostics,
           ssml,
           token.start,
           `<${token.name} ${attribute}> could not be validated by the custom URL validator: ${reason}`
         );
+        annotateTokenDiagnostics(diagnostics, diagnosticStart, token, options, token.parentVoiceName);
       }
     })
   );
   return Promise.all(checks).then(() => diagnostics);
 }
+async function validateAzureSsmlChunks(chunks, options = {}) {
+  const validator = options.urlValidator ?? options.customUrlValidator;
+  const sharedOptions = validator ? {
+    ...options,
+    urlValidatorRunner: options.urlValidatorRunner ?? createAzureUrlValidatorRunner(validator, {
+      ...options.urlValidation ?? {},
+      ...options.urlValidatorConcurrency !== void 0 ? { concurrency: options.urlValidatorConcurrency } : {},
+      ...options.urlValidatorTimeoutMs !== void 0 ? { timeoutMs: options.urlValidatorTimeoutMs } : {},
+      ...options.urlValidatorSignal ? { signal: options.urlValidatorSignal } : {},
+      ...options.urlValidatorCache ? { cache: options.urlValidatorCache } : {}
+    })
+  } : options;
+  return Promise.all(
+    chunks.map((chunk, chunkIndex) => Promise.resolve(validateAzureSsml(chunk, { ...sharedOptions, chunkIndex })))
+  );
+}
 
 // packages/ssml-core/src/generated/azureVoiceCatalog.ts
 var AZURE_VOICE_CATALOG_METADATA = {
@@ -2675,6 +2720,7 @@ var getBuiltInVoiceCatalogMetadata = getAzureVoiceCatalogMetadata;
   parseSsml,
   splitSsmlDocument,
   validateAzureSsml,
+  validateAzureSsmlChunks,
   validateSsml,
   validateSsmlStructureIntegrity
 });