@mux/ai 0.1.5 → 0.2.0

package/dist/{index-Bnv7tv90.d.ts → index-CMZYZcj6.d.ts}

@@ -308,6 +308,10 @@ interface SummaryAndTagsResult {
     tags: string[];
     /** Storyboard image URL that was analyzed. */
     storyboardUrl: string;
+    /** Token usage from the AI provider (for efficiency/cost analysis). */
+    usage?: TokenUsage;
+    /** Raw transcript text used for analysis (when includeTranscript is true). */
+    transcriptText?: string;
 }
 /**
  * Sections of the summarization user prompt that can be overridden.
@@ -353,10 +357,111 @@ interface SummarizationOptions extends MuxAIOptions {
 }
 declare function getSummaryAndTags(assetId: string, options?: SummarizationOptions): Promise<SummaryAndTagsResult>;
 
+/**
+ * Language Code Conversion Utilities
+ *
+ * Provides bidirectional mapping between:
+ * - ISO 639-1 (2-letter codes) - Used by browsers, BCP-47, most video players
+ * - ISO 639-3 (3-letter codes) - Used by various APIs and language processing systems
+ *
+ * This is essential for interoperability between different systems:
+ * - Mux uses ISO 639-1 for track language codes
+ * - Browser players expect BCP-47 compliant codes (based on ISO 639-1)
+ * - Some APIs require ISO 639-3 (3-letter) codes
+ */
+/**
+ * Mapping from ISO 639-1 (2-letter) to ISO 639-3 (3-letter) codes.
+ * Covers the most common languages used in video translation.
+ *
+ * Reference: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+ */
+declare const ISO639_1_TO_3: {
+    readonly en: "eng";
+    readonly es: "spa";
+    readonly fr: "fra";
+    readonly de: "deu";
+    readonly it: "ita";
+    readonly pt: "por";
+    readonly ru: "rus";
+    readonly zh: "zho";
+    readonly ja: "jpn";
+    readonly ko: "kor";
+    readonly ar: "ara";
+    readonly hi: "hin";
+    readonly nl: "nld";
+    readonly pl: "pol";
+    readonly sv: "swe";
+    readonly da: "dan";
+    readonly no: "nor";
+    readonly fi: "fin";
+    readonly el: "ell";
+    readonly cs: "ces";
+    readonly hu: "hun";
+    readonly ro: "ron";
+    readonly bg: "bul";
+    readonly hr: "hrv";
+    readonly sk: "slk";
+    readonly sl: "slv";
+    readonly uk: "ukr";
+    readonly tr: "tur";
+    readonly th: "tha";
+    readonly vi: "vie";
+    readonly id: "ind";
+    readonly ms: "msa";
+    readonly tl: "tgl";
+    readonly he: "heb";
+    readonly fa: "fas";
+    readonly bn: "ben";
+    readonly ta: "tam";
+    readonly te: "tel";
+    readonly mr: "mar";
+    readonly gu: "guj";
+    readonly kn: "kan";
+    readonly ml: "mal";
+    readonly pa: "pan";
+    readonly ur: "urd";
+    readonly sw: "swa";
+    readonly af: "afr";
+    readonly ca: "cat";
+    readonly eu: "eus";
+    readonly gl: "glg";
+    readonly is: "isl";
+    readonly et: "est";
+    readonly lv: "lav";
+    readonly lt: "lit";
+};
+/**
+ * Supported ISO 639-1 two-letter language codes.
+ * These are the language codes supported for translation workflows.
+ */
+type SupportedISO639_1 = keyof typeof ISO639_1_TO_3;
+/**
+ * Supported ISO 639-3 three-letter language codes.
+ * These are the language codes supported for translation workflows.
+ */
+type SupportedISO639_3 = (typeof ISO639_1_TO_3)[SupportedISO639_1];
+/** ISO 639-1 two-letter language code (e.g., "en", "fr", "es") */
+type ISO639_1 = SupportedISO639_1 | (string & {});
+/** ISO 639-3 three-letter language code (e.g., "eng", "fra", "spa") */
+type ISO639_3 = SupportedISO639_3 | (string & {});
+/** Structured language code result containing both formats */
+interface LanguageCodePair {
+    /** ISO 639-1 two-letter code (BCP-47 compatible) */
+    iso639_1: ISO639_1;
+    /** ISO 639-3 three-letter code */
+    iso639_3: ISO639_3;
+}
+
 /** Output returned from `translateAudio`. */
 interface AudioTranslationResult {
     assetId: string;
-    targetLanguageCode: string;
+    /** Target language code (ISO 639-1 two-letter format). */
+    targetLanguageCode: SupportedISO639_1;
+    /**
+     * Target language codes in both ISO 639-1 (2-letter) and ISO 639-3 (3-letter) formats.
+     * Use `iso639_1` for browser players (BCP-47 compliant) and `iso639_3` for ElevenLabs API.
+     */
+    targetLanguage: LanguageCodePair;
     dubbingId: string;
     uploadedTrackId?: string;
     presignedUrl?: string;
@@ -390,12 +495,26 @@ declare function translateAudio(assetId: string, toLanguageCode: string, options
 /** Output returned from `translateCaptions`. */
 interface TranslationResult {
     assetId: string;
-    sourceLanguageCode: string;
-    targetLanguageCode: string;
+    /** Source language code (ISO 639-1 two-letter format). */
+    sourceLanguageCode: SupportedISO639_1;
+    /** Target language code (ISO 639-1 two-letter format). */
+    targetLanguageCode: SupportedISO639_1;
+    /**
+     * Source language codes in both ISO 639-1 (2-letter) and ISO 639-3 (3-letter) formats.
+     * Use `iso639_1` for browser players (BCP-47 compliant) and `iso639_3` for APIs that require it.
+     */
+    sourceLanguage: LanguageCodePair;
+    /**
+     * Target language codes in both ISO 639-1 (2-letter) and ISO 639-3 (3-letter) formats.
+     * Use `iso639_1` for browser players (BCP-47 compliant) and `iso639_3` for APIs that require it.
+     */
+    targetLanguage: LanguageCodePair;
     originalVtt: string;
     translatedVtt: string;
     uploadedTrackId?: string;
     presignedUrl?: string;
+    /** Token usage from the AI provider (for efficiency/cost analysis). */
+    usage?: TokenUsage;
 }
 /** Configuration accepted by `translateCaptions`. */
 interface TranslationOptions<P extends SupportedProvider = SupportedProvider> extends MuxAIOptions {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { i as primitives } from './index-DyTSka2R.js';
 export { A as AssetTextTrack, f as ChunkEmbedding, C as ChunkingStrategy, I as ImageSubmissionMode, M as MuxAIConfig, a as MuxAIOptions, b as MuxAsset, c as PlaybackAsset, P as PlaybackPolicy, e as TextChunk, d as TokenChunkingConfig, h as TokenUsage, T as ToneType, V as VTTChunkingConfig, g as VideoEmbeddingsResult } from './types-ktXDZ93V.js';
-export { i as workflows } from './index-Bnv7tv90.js';
+export { i as workflows } from './index-CMZYZcj6.js';
 import '@mux/mux-node';
 import 'zod';
 import '@ai-sdk/anthropic';