samsar-js 0.48.24 → 0.48.25

package/README.md

@@ -153,8 +153,9 @@ const translated = await samsar.translateVideo(
   {
     videoSessionId: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
     language: 'es',
-    // Optional: override the outro image in the translated session
-    outro_image_url: 'https://cdn.example.com/outro.png',
+    enable_subtitles: false,
+    translate_outro: true,
+    translate_footer: true,
   },
   { webhookUrl: 'https://example.com/webhook' },
 );
@@ -550,7 +551,7 @@ Video model support notes:
 
 Upcoming `/v2` omni route adapters:
 - `/v2` is additive; `/v1` is not deprecated.
-- `createV2VideoFromText`, `createV2VideoFromImageList`, `updateV2VideoOutroImage`, `updateV2VideoFooterImage`, `addV2VideoOutroImage`, `getV2Status`, `getV2Credits`, `listV2Requests`, and `createV2Session` call the new omni route surface.
+- `createV2VideoFromText`, `createV2VideoFromImageList`, `translateV2Video`, `updateV2VideoOutroImage`, `updateV2VideoFooterImage`, `addV2VideoOutroImage`, `getV2Status`, `getV2Credits`, `listV2Requests`, and `createV2Session` call the new omni route surface.
 - Programmatic user billing helpers include `createV2UserRechargeCredits`, `refreshV2UserToken`, `createV2UserAppKey`, `refreshV2UserAppKey`, `getV2UserCredits`, `getV2UserUsageLogs`, and `getV2UserPaymentStatus`.
 - Omit `externalUser` for internal account billing, pass `externalUser` to scope an external user with the account API key, or authenticate the client directly with an external-user auth token/API key.
 
@@ -571,6 +572,14 @@ const v2ExternalVideo = await platform.createV2VideoFromImageList(
   { externalUser },
 );
 
+const v2Translated = await platform.translateV2Video({
+  videoSessionId: v2Video.data.request_id!,
+  language: 'es',
+  enable_subtitles: false,
+  translate_outro: true,
+  translate_footer: true,
+});
+
 const v2Status = await platform.getV2Status(v2Video.data.request_id!);
 console.log(v2Status.data.status);
 ```

package/dist/index.d.ts

@@ -219,10 +219,14 @@ export interface TranslateVideoInput {
     langauge?: string;
     langauge_code?: string;
     langaugeCode?: string;
-    outro_image_url?: string;
-    outroImageUrl?: string;
-    new_outro_image_url?: string;
-    newOutroImageUrl?: string;
+    enable_subtitles?: boolean;
+    enableSubtitles?: boolean;
+    add_subtitles?: boolean;
+    addSubtitles?: boolean;
+    translate_outro?: boolean;
+    translateOutro?: boolean;
+    translate_footer?: boolean;
+    translateFooter?: boolean;
     [key: string]: unknown;
 }
 export interface TranslateVideoResponse {
@@ -1717,6 +1721,7 @@ export declare class SamsarClient {
     }): Promise<SamsarResult<CreateLoginTokenResponse | ExternalCreateLoginTokenResponse>>;
     createV2VideoFromText(input: CreateVideoFromTextInput, options?: V2RequestOptions): Promise<SamsarResult<CreateVideoResponse | ExternalRequestResponse>>;
     createV2VideoFromImageList(input: CreateVideoFromImageListInput, options?: V2RequestOptions): Promise<SamsarResult<CreateVideoFromImageListResponse | ExternalRequestResponse>>;
+    translateV2Video(input: TranslateVideoInput, options?: V2RequestOptions): Promise<SamsarResult<TranslateVideoResponse | ExternalRequestResponse>>;
     uploadV2ImageData(imageData: string[], options?: V2RequestOptions): Promise<SamsarResult<{
         image_urls: string[];
     }>>;

package/dist/index.js

@@ -126,6 +126,50 @@ function normalizeCreateVideoFromImageListInput(input) {
     }
     return normalized;
 }
+function normalizeTranslateVideoInput(input, context = 'translateVideo') {
+    const raw = input;
+    const videoSessionId = raw.videoSessionId ??
+        raw.video_session_id ??
+        raw.videoSessionID ??
+        raw.session_id ??
+        raw.sessionId ??
+        raw.sessionID ??
+        raw.request_id ??
+        raw.requestId;
+    const language = raw.language ??
+        raw.language_code ??
+        raw.languageCode ??
+        raw.langauge ??
+        raw.langauge_code ??
+        raw.langaugeCode ??
+        raw.languageString;
+    const enableSubtitles = resolveAliasedInputValue(raw, ['enable_subtitles', 'enableSubtitles', 'add_subtitles', 'addSubtitles'], 'enable_subtitles') ?? false;
+    const translateOutro = resolveAliasedInputValue(raw, ['translate_outro', 'translateOutro'], 'translate_outro') ?? true;
+    const translateFooter = resolveAliasedInputValue(raw, ['translate_footer', 'translateFooter'], 'translate_footer') ?? true;
+    if (!videoSessionId) {
+        throw new Error(`videoSessionId is required for ${context}`);
+    }
+    if (!language) {
+        throw new Error(`language is required for ${context}`);
+    }
+    assertOptionalBoolean(enableSubtitles, 'enable_subtitles', context);
+    assertOptionalBoolean(translateOutro, 'translate_outro', context);
+    assertOptionalBoolean(translateFooter, 'translate_footer', context);
+    const normalizedInput = { ...input };
+    delete normalizedInput.outro_image_url;
+    delete normalizedInput.outroImageUrl;
+    delete normalizedInput.outroImageURL;
+    delete normalizedInput.new_outro_image_url;
+    delete normalizedInput.newOutroImageUrl;
+    return {
+        ...normalizedInput,
+        videoSessionId: String(videoSessionId),
+        language: String(language),
+        enable_subtitles: enableSubtitles,
+        translate_outro: translateOutro,
+        translate_footer: translateFooter,
+    };
+}
 function normalizeUpdateVideoOutroImageInput(input, context = 'updateVideoOutroImage') {
     const raw = input;
     const videoSessionId = raw.videoSessionId ??
@@ -490,6 +534,13 @@ export class SamsarClient {
             webhookUrl: options?.webhookUrl,
         }, options);
     }
+    async translateV2Video(input, options) {
+        const normalizedInput = normalizeTranslateVideoInput(input, 'translateV2Video');
+        return this.postV2('translate_video', {
+            input: normalizedInput,
+            webhookUrl: options?.webhookUrl,
+        }, options);
+    }
     async uploadV2ImageData(imageData, options) {
         if (!Array.isArray(imageData) || imageData.length === 0) {
             throw new Error('imageData must be a non-empty array of data URLs');
@@ -703,33 +754,10 @@ export class SamsarClient {
      * Creates a new session_id and queues generation steps for lip sync + transcription + video render.
      */
     async translateVideo(input, options) {
-        const raw = input;
-        const videoSessionId = raw.videoSessionId ??
-            raw.video_session_id ??
-            raw.videoSessionID ??
-            raw.session_id ??
-            raw.sessionId ??
-            raw.sessionID ??
-            raw.request_id ??
-            raw.requestId;
-        const language = raw.language ??
-            raw.language_code ??
-            raw.languageCode ??
-            raw.langauge ??
-            raw.langauge_code ??
-            raw.langaugeCode ??
-            raw.languageString;
-        if (!videoSessionId) {
-            throw new Error('videoSessionId is required for translateVideo');
-        }
-        if (!language) {
-            throw new Error('language is required for translateVideo');
-        }
+        const normalizedInput = normalizeTranslateVideoInput(input, 'translateVideo');
         const body = {
             input: {
-                ...input,
-                videoSessionId: String(videoSessionId),
-                language: String(language),
+                ...normalizedInput,
             },
             webhookUrl: options?.webhookUrl,
         };
@@ -1861,7 +1889,10 @@ export class SamsarClient {
                     body: parsedBody,
                 });
             }
-            throw new SamsarRequestError(`Request to ${url} failed with status ${response.status}`, {
+            const responseMessage = getResponseErrorMessage(parsedBody);
+            throw new SamsarRequestError(responseMessage
+                ? `Request to ${url} failed with status ${response.status}: ${responseMessage}`
+                : `Request to ${url} failed with status ${response.status}`, {
                 status: response.status,
                 body: parsedBody,
                 headers: headerRecord,
@@ -1943,6 +1974,25 @@ function parseMaybeJson(value) {
         return value;
     }
 }
+function getResponseErrorMessage(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body)) {
+        return typeof body === 'string' && body.trim() ? body.trim() : null;
+    }
+    const record = body;
+    for (const key of ['message', 'error', 'detail']) {
+        const value = record[key];
+        if (typeof value === 'string' && value.trim()) {
+            return value.trim();
+        }
+    }
+    if (record.error && typeof record.error === 'object' && !Array.isArray(record.error)) {
+        const nestedMessage = record.error.message;
+        if (typeof nestedMessage === 'string' && nestedMessage.trim()) {
+            return nestedMessage.trim();
+        }
+    }
+    return null;
+}
 function headersToObject(headers) {
     const result = {};
     headers.forEach((value, key) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "samsar-js",
-  "version": "0.48.24",
+  "version": "0.48.25",
   "description": "TypeScript client for the Samsar Processor API routes.",
   "type": "module",
   "main": "dist/index.js",