samsar-js 0.48.25 → 0.48.26

package/README.md

@@ -160,6 +160,14 @@ const translated = await samsar.translateVideo(
   { webhookUrl: 'https://example.com/webhook' },
 );
 
+// Deep-clone an existing completed session and render a new final video URL
+const cloned = await samsar.cloneVideo(
+  {
+    videoSessionId: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
+  },
+  { webhookUrl: 'https://example.com/webhook' },
+);
+
 // Join multiple completed sessions into a single appended video
 const joined = await samsar.joinVideos(
   {
@@ -544,6 +552,7 @@ Video model support notes:
 - `createVideoFromImageList` can render per-scene footer QR cards by setting `add_footer_animation: true` and providing one `footer_metadata` item per image scene.
 - `updateVideoOutroImage` accepts either a replacement outro image URL (`outro_image_url`, `outroImageUrl`, `new_outro_image_url`) or a generated QR CTA outro (`generate_outro_image: true` with `cta_url`, or just `cta_url` when no outro image URL is supplied). Generated outro updates reuse the existing session image layers for tiling and only queue frame/video regeneration.
 - `updateVideoFooterImage` updates the footer CTA on a cloned session with `cta_text`, `cta_logo`, and/or `cta_url`, or removes all scene footers with `remove_footer: true`. Footer updates queue only frame/video regeneration.
+- `cloneVideo` creates a deep copy of a completed session and queues only the final video render so the clone receives a new rendered video path and URL. It does not charge credits.
 - Main video methods and external-user methods accept the same generated outro and footer parameters. The API can resolve either internal session ids or external `extreq_...` ids on repeated video routes, so client code can keep using `translateVideo`, `joinVideos`, `addSubtitles`, `removeSubtitles`, `addVideoOutroImage`, `updateVideoOutroImage`, and `updateVideoFooterImage`; the explicit external variants are available when you want to call `/external_users/*` directly. Do not strip the `extreq_` prefix.
 - Completed video status, latest-version, and completed-session list responses expose `has_subtitles` and `result_language` when the session metadata is available.
 - `publishPublication`, `editPublication`, and `revokePublication` manage public feed publications for completed sessions through free `/publications/*` endpoints. They work with account API keys, customer sub-account API keys, and client auth tokens when the session belongs to the authenticated actor.
@@ -551,7 +560,7 @@ Video model support notes:
 
 Upcoming `/v2` omni route adapters:
 - `/v2` is additive; `/v1` is not deprecated.
-- `createV2VideoFromText`, `createV2VideoFromImageList`, `translateV2Video`, `updateV2VideoOutroImage`, `updateV2VideoFooterImage`, `addV2VideoOutroImage`, `getV2Status`, `getV2Credits`, `listV2Requests`, and `createV2Session` call the new omni route surface.
+- `createV2VideoFromText`, `createV2VideoFromImageList`, `translateV2Video`, `cloneV2Video`, `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.
 
@@ -580,6 +589,10 @@ const v2Translated = await platform.translateV2Video({
   translate_footer: true,
 });
 
+const v2Clone = await platform.cloneV2Video({
+  videoSessionId: v2Video.data.request_id!,
+});
+
 const v2Status = await platform.getV2Status(v2Video.data.request_id!);
 console.log(v2Status.data.status);
 ```

package/dist/index.d.ts

@@ -237,6 +237,26 @@ export interface TranslateVideoResponse {
     remainingCredits?: number | null;
     [key: string]: unknown;
 }
+export interface CloneVideoInput {
+    videoSessionId?: string;
+    video_session_id?: string;
+    videoSessionID?: string;
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    request_id?: string;
+    requestId?: string;
+    source_session_id?: string;
+    sourceSessionId?: string;
+    source_request_id?: string;
+    sourceRequestId?: string;
+    [key: string]: unknown;
+}
+export interface CloneVideoResponse extends GlobalStatusResponse {
+    sessionID?: string;
+    creditsCharged?: number;
+    remainingCredits?: number | null;
+}
 export interface UpdateVideoOutroImageInput {
     videoSessionId?: string;
     video_session_id?: string;
@@ -1722,6 +1742,7 @@ export declare class SamsarClient {
     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>>;
+    cloneV2Video(input: CloneVideoInput, options?: V2RequestOptions): Promise<SamsarResult<CloneVideoResponse>>;
     uploadV2ImageData(imageData: string[], options?: V2RequestOptions): Promise<SamsarResult<{
         image_urls: string[];
     }>>;
@@ -1807,6 +1828,13 @@ export declare class SamsarClient {
     translateVideo(input: TranslateVideoInput, options?: {
         webhookUrl?: string;
     } & SamsarRequestOptions): Promise<SamsarResult<TranslateVideoResponse>>;
+    /**
+     * Deep-clone a completed video session and queue one final render for the new session.
+     * The clone copies session assets, then regenerates only the final rendered video URL.
+     */
+    cloneVideo(input: CloneVideoInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<CloneVideoResponse>>;
     /**
      * Join multiple existing video sessions into a single session by appending their timelines.
      * Creates a new session_id and queues transcription + frame + video generation.

package/dist/index.js

@@ -170,6 +170,28 @@ function normalizeTranslateVideoInput(input, context = 'translateVideo') {
         translate_footer: translateFooter,
     };
 }
+function normalizeCloneVideoInput(input, context = 'cloneVideo') {
+    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 ??
+        raw.source_session_id ??
+        raw.sourceSessionId ??
+        raw.source_request_id ??
+        raw.sourceRequestId;
+    if (!videoSessionId) {
+        throw new Error(`videoSessionId is required for ${context}`);
+    }
+    return {
+        ...input,
+        videoSessionId: String(videoSessionId),
+    };
+}
 function normalizeUpdateVideoOutroImageInput(input, context = 'updateVideoOutroImage') {
     const raw = input;
     const videoSessionId = raw.videoSessionId ??
@@ -541,6 +563,13 @@ export class SamsarClient {
             webhookUrl: options?.webhookUrl,
         }, options);
     }
+    async cloneV2Video(input, options) {
+        const normalizedInput = normalizeCloneVideoInput(input, 'cloneV2Video');
+        return this.postV2('video/clone', {
+            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');
@@ -782,6 +811,39 @@ export class SamsarClient {
         }
         return response;
     }
+    /**
+     * Deep-clone a completed video session and queue one final render for the new session.
+     * The clone copies session assets, then regenerates only the final rendered video URL.
+     */
+    async cloneVideo(input, options) {
+        const normalizedInput = normalizeCloneVideoInput(input, 'cloneVideo');
+        const body = {
+            input: {
+                ...normalizedInput,
+            },
+            webhookUrl: options?.webhookUrl,
+        };
+        const response = await this.post('video/clone', body, options);
+        const data = response.data;
+        if (data && typeof data === 'object') {
+            const sessionId = typeof data.sessionID === 'string'
+                ? data.sessionID
+                : typeof data.session_id === 'string'
+                    ? data.session_id
+                    : typeof data.request_id === 'string'
+                        ? data.request_id
+                        : undefined;
+            const normalizedSessionId = sessionId ? String(sessionId) : undefined;
+            const normalizedData = {
+                ...data,
+                sessionID: data.sessionID ?? normalizedSessionId ?? '',
+                session_id: data.session_id ?? normalizedSessionId ?? null,
+                request_id: data.request_id ?? normalizedSessionId ?? null,
+            };
+            return { ...response, data: normalizedData };
+        }
+        return response;
+    }
     /**
      * Join multiple existing video sessions into a single session by appending their timelines.
      * Creates a new session_id and queues transcription + frame + video generation.

package/package.json

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