@mux/ai 0.1.6 → 0.3.0

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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { createAnthropic } from '@ai-sdk/anthropic';
 import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import { createOpenAI } from '@ai-sdk/openai';
-import { h as TokenUsage, a as MuxAIOptions, I as ImageSubmissionMode, C as ChunkingStrategy, g as VideoEmbeddingsResult, T as ToneType } from './types-ktXDZ93V.js';
+import { g as TokenUsage, M as MuxAIOptions, I as ImageSubmissionMode, C as ChunkingStrategy, f as VideoEmbeddingsResult, T as ToneType } from './types-DzOQNn9R.js';
 import { Buffer } from 'node:buffer';
 
 interface ImageDownloadOptions {
@@ -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.
@@ -335,7 +339,7 @@ interface SummarizationOptions extends MuxAIOptions {
     provider?: SupportedProvider;
     /** Provider-specific chat model identifier. */
     model?: ModelIdByProvider[SupportedProvider];
-    /** Prompt tone shim applied to the system instruction (defaults to 'normal'). */
+    /** Prompt tone shim applied to the system instruction (defaults to 'neutral'). */
     tone?: ToneType;
     /** Fetch the transcript and send it alongside the storyboard (defaults to true). */
     includeTranscript?: boolean;
@@ -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;
@@ -373,10 +478,6 @@ interface AudioTranslationOptions extends MuxAIOptions {
     s3Region?: string;
     /** Bucket that will store dubbed audio files. */
     s3Bucket?: string;
-    /** Access key ID used for uploads. */
-    s3AccessKeyId?: string;
-    /** Secret access key used for uploads. */
-    s3SecretAccessKey?: string;
     /**
      * When true (default) the dubbed audio file is uploaded to the configured
      * bucket and attached to the Mux asset.
@@ -390,12 +491,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 {
@@ -409,10 +524,6 @@ interface TranslationOptions<P extends SupportedProvider = SupportedProvider> ex
     s3Region?: string;
     /** Bucket that will store translated VTT files. */
     s3Bucket?: string;
-    /** Access key ID used for uploads. */
-    s3AccessKeyId?: string;
-    /** Secret access key used for uploads. */
-    s3SecretAccessKey?: string;
     /**
      * When true (default) the translated VTT is uploaded to the configured
      * bucket and attached to the Mux asset.

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 primitives } from './index-BcNDGOI6.js';
+export { A as AssetTextTrack, e as ChunkEmbedding, C as ChunkingStrategy, I as ImageSubmissionMode, M as MuxAIOptions, a as MuxAsset, b as PlaybackAsset, P as PlaybackPolicy, d as TextChunk, c as TokenChunkingConfig, g as TokenUsage, T as ToneType, V as VTTChunkingConfig, f as VideoEmbeddingsResult } from './types-DzOQNn9R.js';
+export { i as workflows } from './index-D3fZHu0h.js';
 import '@mux/mux-node';
 import 'zod';
 import '@ai-sdk/anthropic';