@braze/sanity-plugin-ai-translation 0.2.71 → 0.2.72

package/dist/index.d.ts

@@ -476,6 +476,7 @@ declare type TelemetryEvent =
   | TranslationBatchStartedEvent
   | TranslationBatchCompletedEvent
   | TranslationJobCompletedEvent
+  | TranslationJobFailedEvent
   | OpenAIApiCallEvent;
 
 /**
@@ -678,6 +679,28 @@ declare interface TranslationJobCompletedEvent extends TelemetryEventBase {
   };
 }
 
+/**
+ * Event emitted when an individual translation job fails.
+ * This is emitted alongside the detailed error bundle (via onError) to enable
+ * easy error rate calculations by comparing job_completed vs job_failed counts.
+ * @public
+ */
+declare interface TranslationJobFailedEvent extends TelemetryEventBase {
+  name: "translation.job_failed";
+  data: {
+    documentId: string;
+    documentType: string;
+    sourceLanguage: string;
+    targetLanguage: string;
+    translationMode: TranslationMode;
+    durationMs: number;
+    /** Categorized error type for filtering/grouping */
+    errorType: TranslationErrorType;
+    /** Error message (kept short for metrics; full details in error bundle) */
+    errorMessage: string;
+  };
+}
+
 declare type TranslationMode = "sanity-only" | "openai-only";
 
 /**

package/dist/index.js

@@ -2892,7 +2892,8 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
       telemetryConfig
     }), newDocument = translationResult?.document;
     if (!newDocument) {
-      devLog.error("Translation failed: no document returned", new Error("Translation returned null"), logContext), setJobStatus(
+      const failureError = new Error("Translation returned null");
+      devLog.error("Translation failed: no document returned", failureError, logContext), setJobStatus(
         dispatch,
         sourceDocument._id,
         targetLanguage,
@@ -2901,7 +2902,20 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
           errorMessage: "Translation failed"
         },
         mainSourceDocumentId
-      ), devLog.timeEnd("translateDocument"), devLog.groupEnd();
+      ), emitTelemetryEvent(telemetryConfig, {
+        name: "translation.job_failed",
+        timestamp: createTimestamp(),
+        data: {
+          documentId: sourceDocument._id,
+          documentType: sourceDocument._type,
+          sourceLanguage,
+          targetLanguage,
+          translationMode,
+          durationMs: Date.now() - jobStartTime,
+          errorType: classifyError(failureError),
+          errorMessage: "Translation failed"
+        }
+      }), devLog.timeEnd("translateDocument"), devLog.groupEnd();
       return;
     }
     return setJobStatus(
@@ -2950,8 +2964,8 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
       }
     }), devLog.timeEnd("translateDocument"), devLog.groupEnd(), newDocument._id;
   } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    devLog.error("Translation failed", error instanceof Error ? error : new Error(String(error)), logContext), setJobStatus(
+    const errorMessage = error instanceof Error ? error.message : String(error), errorObj = error instanceof Error ? error : new Error(String(error));
+    devLog.error("Translation failed", errorObj, logContext), setJobStatus(
       dispatch,
       sourceDocument._id,
       targetLanguage,
@@ -2960,7 +2974,20 @@ ${protectedPhrases.join(", ")}`, buildStyleGuideSection = (globalPrompt, localeP
         errorMessage
       },
       mainSourceDocumentId
-    ), devLog.timeEnd("translateDocument"), devLog.groupEnd();
+    ), emitTelemetryEvent(telemetryConfig, {
+      name: "translation.job_failed",
+      timestamp: createTimestamp(),
+      data: {
+        documentId: sourceDocument._id,
+        documentType: sourceDocument._type,
+        sourceLanguage,
+        targetLanguage,
+        translationMode,
+        durationMs: Date.now() - jobStartTime,
+        errorType: classifyError(errorObj),
+        errorMessage
+      }
+    }), devLog.timeEnd("translateDocument"), devLog.groupEnd();
     return;
   }
 }, translationSemaphore = new Semaphore(2), translateDocumentSet = async ({