@golpoai/sdk 0.1.8 → 0.1.10

package/dist/index.cjs

@@ -110,13 +110,11 @@ var Golpo = class {
   async createPodcast(prompt, opts = {}) {
     const { pollIntervalMs = 2e3, ...jobOpts } = opts;
     const jobId = await this.createPodcastJob(prompt, jobOpts);
-    return this.pollUntilComplete(
+    const r = await this.pollUntilComplete(
       jobId,
       pollIntervalMs
-    ).then((r) => ({
-      podcastUrl: r.podcast_url,
-      podcastScript: r.podcast_script
-    }));
+    );
+    return { url: r.podcast_url, script: r.podcast_script, videoId: jobId };
   }
   async createVideo(prompt, opts = {}) {
     const {
@@ -135,9 +133,7 @@ var Golpo = class {
       videoType = "long",
       includeWatermark = true,
       logo,
-      timing = "1",
-      useColor = false,
-      newScript = null
+      timing = "1"
     } = opts;
     const fields = [
       ["prompt", prompt],
@@ -148,14 +144,12 @@ var Golpo = class {
       ["style", style],
       ["video_type", videoType],
       ["include_watermark", String(includeWatermark)],
-      ["timing", timing],
-      ["use_color", String(useColor)]
+      ["timing", timing]
     ];
     if (language) fields.push(["language", language]);
     if (voiceInstructions) fields.push(["voice_instructions", voiceInstructions]);
     if (personality1) fields.push(["personality_1", personality1]);
     if (bgMusic) fields.push(["bg_music", bgMusic]);
-    if (newScript !== null) fields.push(["new_script", newScript]);
     if (logo) {
       fields.push(["logo_path", logo]);
     }
@@ -164,13 +158,231 @@ var Golpo = class {
       timeout: 24e4,
       headers: formData.getHeaders()
     });
-    return this.pollUntilComplete(
+    const r = await this.pollUntilComplete(
       data.job_id,
       pollIntervalMs
-    ).then((r) => ({
-      videoUrl: r.podcast_url,
-      videoScript: r.podcast_script
-    }));
+    );
+    return { url: r.podcast_url, script: r.podcast_script, videoId: data.job_id };
+  }
+  /**
+   * Edit specific frames of a video and regenerate the video.
+   * This method polls until completion and returns the final edited video URL.
+   * If autoCombine is true, it will also combine all frames into a final video.
+   */
+  async editVideo(videoId, opts) {
+    const {
+      frameIds,
+      editPrompts,
+      referenceImages,
+      videoUrl,
+      userId,
+      pollIntervalMs = 2e3,
+      autoCombine = false
+    } = opts;
+    if (frameIds.length !== editPrompts.length) {
+      throw new Error("frameIds and editPrompts must have the same length");
+    }
+    if (!videoUrl) {
+      throw new Error("videoUrl is required");
+    }
+    const jobId = await this.editVideoJob(videoId, opts);
+    const editResult = await this.pollEditStatus(jobId, pollIntervalMs);
+    if (autoCombine) {
+      return this.combineEditedFrames(videoId, editResult, {
+        frameIds,
+        videoUrl,
+        pollIntervalMs
+      });
+    }
+    return {
+      videoUrl: editResult,
+      jobId
+    };
+  }
+  /**
+   * Combines edited frames into a final video with audio.
+   * This is a helper method used by editVideo when autoCombine is enabled.
+   */
+  async combineEditedFrames(videoId, editResult, opts) {
+    const { frameIds, videoUrl, pollIntervalMs } = opts;
+    const jobId = videoId;
+    try {
+      const frameVersions = await this.getFrameVersions(videoId);
+      let frameAnimations = frameVersions.frame_animations ? { ...frameVersions.frame_animations } : {};
+      for (const frameId of frameIds) {
+        await this.setFrameVersion(videoId, frameId, editResult);
+        const updatedVersions = await this.getFrameVersions(videoId);
+        frameAnimations = updatedVersions.frame_animations || {};
+      }
+      const mp4Urls = Object.entries(frameAnimations).sort(([a], [b]) => parseInt(a) - parseInt(b)).map(([_, url]) => url);
+      if (mp4Urls.length === 0) {
+        throw new Error("No frame animations found to combine");
+      }
+      const combineOptions = {
+        mp4Urls,
+        pollIntervalMs,
+        videoUrl
+      };
+      const combined = await this.combineVideos(combineOptions);
+      return { videoUrl: combined.url, jobId };
+    } catch (error) {
+      console.warn("Failed to auto-combine videos, returning edit result:", error);
+      return { videoUrl: editResult, jobId };
+    }
+  }
+  /**
+   * Create an edit job for a video without waiting for completion.
+   * Returns the job ID that can be used to check status later.
+   */
+  async editVideoJob(videoId, opts) {
+    const {
+      frameIds,
+      editPrompts,
+      referenceImages,
+      videoUrl,
+      userId
+    } = opts;
+    if (frameIds.length !== editPrompts.length) {
+      throw new Error("frameIds and editPrompts must have the same length");
+    }
+    const body = {
+      job_id: videoId,
+      frame_ids: frameIds,
+      edit_prompts: editPrompts,
+      return_single_frame: true
+    };
+    if (referenceImages) {
+      body.reference_images = referenceImages;
+    }
+    if (videoUrl) {
+      body.video_url = videoUrl;
+    }
+    if (userId) {
+      body.user_id = userId;
+    }
+    console.log("Body:", body);
+    const { data } = await this.http.post("/api/edit-and-reanimate-frames", body, {
+      headers: {
+        "Content-Type": "application/json"
+      },
+      timeout: 6e4
+    });
+    return data.job_id;
+  }
+  /**
+   * Check the status of an edit job.
+   * Returns the video URL if completed, or status information if still processing.
+   */
+  async getEditStatus(jobId) {
+    const { data } = await this.http.post(
+      "/api/edit-status",
+      { job_id: jobId },
+      {
+        headers: {
+          "Content-Type": "application/json"
+        }
+      }
+    );
+    return data;
+  }
+  /**
+   * Update video metadata (prompt, context, scenes, video_url, frame_animations).
+   * Note: This requires JWT authentication.
+   */
+  async updateVideo(videoId, opts) {
+    const { jwtToken, ...updateData } = opts;
+    if (!jwtToken) {
+      throw new Error("JWT token is required for updating video metadata");
+    }
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${jwtToken}`
+    };
+    const body = {};
+    if (updateData.prompt !== void 0) body.prompt = updateData.prompt;
+    if (updateData.context !== void 0) body.context = updateData.context;
+    if (updateData.scenes !== void 0) body.scenes = updateData.scenes;
+    if (updateData.videoUrl !== void 0) body.video_url = updateData.videoUrl;
+    if (updateData.frameAnimations !== void 0) body.frame_animations = updateData.frameAnimations;
+    const { data } = await this.http.put(
+      `/api/videos/${videoId}`,
+      body,
+      { headers }
+    );
+    return data;
+  }
+  /**
+   * Get frame animations for a video.
+   * Returns a dictionary mapping frame indices to animation URLs.
+   * This is a convenience method that extracts frame_animations from getFrameVersions.
+   */
+  async getFrameAnimations(videoId) {
+    const versions = await this.getFrameVersions(videoId);
+    return versions.frame_animations || {};
+  }
+  /**
+   * Get frame versions and animations for a video.
+   * Returns both the current frame_animations and available frame_animation_versions.
+   */
+  async getFrameVersions(videoId) {
+    const { data } = await this.http.get(`/api/frame-versions/${videoId}`, {
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+    return data;
+  }
+  /**
+   * Set a specific frame animation version.
+   * Updates the frame_animations for a specific frame in the video.
+   */
+  async setFrameVersion(videoId, frameId, animationUrl) {
+    const { data } = await this.http.post(
+      "/api/set-frame-version",
+      {
+        job_id: videoId,
+        frame_id: frameId,
+        url: animationUrl
+      },
+      {
+        headers: {
+          "Content-Type": "application/json"
+        }
+      }
+    );
+    return data;
+  }
+  /**
+   * Combine multiple MP4 videos into a single video.
+   * This is used to combine frame animations into a final video.
+   */
+  async combineVideos(opts) {
+    const {
+      mp4Urls,
+      videoUrl,
+      pollIntervalMs = 2e3
+    } = opts;
+    if (!mp4Urls || mp4Urls.length === 0) {
+      throw new Error("At least one MP4 URL is required");
+    }
+    const body = {
+      mp4_urls: mp4Urls
+    };
+    if (videoUrl) {
+      body.video_url = videoUrl;
+    }
+    const { data } = await this.http.post("/combine-videos", body, {
+      headers: {
+        "Content-Type": "application/json"
+      },
+      timeout: 6e4
+    });
+    const combineJobId = data.job_id;
+    if (!combineJobId) {
+      throw new Error("No job ID received from combine-videos API");
+    }
+    const url = await this.pollEditStatus(combineJobId, pollIntervalMs);
+    return { url };
   }
   /* ------------------------------------------------------------ *
    * INTERNAL HELPERS
@@ -186,6 +398,52 @@ var Golpo = class {
       await new Promise((r) => setTimeout(r, interval));
     }
   }
+  async pollEditStatus(jobId, interval) {
+    const maxAttempts = 1200;
+    let attempts = 0;
+    let retryCount = 0;
+    const maxRetries = 3;
+    while (true) {
+      if (attempts >= maxAttempts) {
+        throw new Error("Edit job timed out");
+      }
+      try {
+        const { data } = await this.http.post(
+          "/api/edit-status",
+          { job_id: jobId },
+          {
+            headers: {
+              "Content-Type": "application/json"
+            }
+          }
+        );
+        if (data.status === "completed") {
+          return data.url;
+        } else if (data.status === "failed" || data.status === "not found") {
+          throw new Error(`Edit job failed: ${data.status}`);
+        } else {
+          console.log("Edit job status:", data.status);
+        }
+        retryCount = 0;
+      } catch (error) {
+        if (error.name === "TypeError" && error.message.includes("fetch failed") || error.code === "ECONNRESET" || error.name === "TimeoutError" || error.response?.status >= 500 && error.response?.status < 600) {
+          if (retryCount < maxRetries) {
+            retryCount++;
+            console.warn(`Retrying request (${retryCount}/${maxRetries}) after network error...`);
+            await new Promise((resolve2) => setTimeout(resolve2, Math.min(5e3 * retryCount, 15e3)));
+            continue;
+          } else {
+            console.warn(`Max retries (${maxRetries}) exceeded for network errors`);
+            retryCount = 0;
+          }
+        } else {
+          console.warn(`Error on attempt ${attempts + 1}, continuing polling:`, error instanceof Error ? error.message : error);
+        }
+      }
+      await new Promise((r) => setTimeout(r, interval));
+      attempts++;
+    }
+  }
   async createFormData(fields, uploads, concurrency, logo) {
     const formData = new import_form_data.default();
     fields.forEach(([key, value]) => {

package/dist/index.d.cts

@@ -29,11 +29,47 @@ interface CreateVideoOptions {
     includeWatermark?: boolean;
     logo?: string;
     timing?: '1' | '2';
-    useColor?: boolean;
-    newScript?: string | null;
     pollIntervalMs?: number;
     concurrency?: number;
 }
+interface EditVideoOptions {
+    frameIds: string[];
+    editPrompts: string[];
+    referenceImages?: string[];
+    videoUrl: string;
+    userId?: string;
+    pollIntervalMs?: number;
+    autoCombine?: boolean;
+}
+interface FrameAnimations {
+    [frameId: string]: string;
+}
+interface CombineVideosOptions {
+    mp4Urls: string[];
+    videoUrl?: string;
+    pollIntervalMs?: number;
+}
+/**
+ * Result of createPodcast or createVideo (generated content URL, script, and job ID).
+ */
+interface GenerationResult {
+    url: string;
+    script: string;
+    videoId: string;
+}
+/**
+ * Result of editVideo (edited or combined video URL and job ID).
+ */
+interface VideoEditResult {
+    videoUrl: string;
+    jobId: string;
+}
+/**
+ * Result of combineVideos (URL of the combined video).
+ */
+interface CombinedVideoResult {
+    url: string;
+}
 declare class Golpo {
     private readonly http;
     constructor(apiKey: string, baseUrl?: string);
@@ -45,16 +81,58 @@ declare class Golpo {
         podcastUrl: string;
         podcastScript: string;
     }>;
-    createPodcast(prompt: string, opts?: CreatePodcastOptions): Promise<{
-        podcastUrl: string;
-        podcastScript: string;
-    }>;
-    createVideo(prompt: string, opts?: CreateVideoOptions): Promise<{
-        videoUrl: string;
-        videoScript: string;
-    }>;
+    createPodcast(prompt: string, opts?: CreatePodcastOptions): Promise<GenerationResult>;
+    createVideo(prompt: string, opts?: CreateVideoOptions): Promise<GenerationResult>;
+    /**
+     * Edit specific frames of a video and regenerate the video.
+     * This method polls until completion and returns the final edited video URL.
+     * If autoCombine is true, it will also combine all frames into a final video.
+     */
+    editVideo(videoId: string, opts: EditVideoOptions): Promise<VideoEditResult>;
+    /**
+     * Combines edited frames into a final video with audio.
+     * This is a helper method used by editVideo when autoCombine is enabled.
+     */
+    private combineEditedFrames;
+    /**
+     * Create an edit job for a video without waiting for completion.
+     * Returns the job ID that can be used to check status later.
+     */
+    private editVideoJob;
+    /**
+     * Check the status of an edit job.
+     * Returns the video URL if completed, or status information if still processing.
+     */
+    private getEditStatus;
+    /**
+     * Update video metadata (prompt, context, scenes, video_url, frame_animations).
+     * Note: This requires JWT authentication.
+     */
+    private updateVideo;
+    /**
+     * Get frame animations for a video.
+     * Returns a dictionary mapping frame indices to animation URLs.
+     * This is a convenience method that extracts frame_animations from getFrameVersions.
+     */
+    getFrameAnimations(videoId: string): Promise<FrameAnimations>;
+    /**
+     * Get frame versions and animations for a video.
+     * Returns both the current frame_animations and available frame_animation_versions.
+     */
+    private getFrameVersions;
+    /**
+     * Set a specific frame animation version.
+     * Updates the frame_animations for a specific frame in the video.
+     */
+    private setFrameVersion;
+    /**
+     * Combine multiple MP4 videos into a single video.
+     * This is used to combine frame animations into a final video.
+     */
+    combineVideos(opts: CombineVideosOptions): Promise<CombinedVideoResult>;
     private pollUntilComplete;
+    private pollEditStatus;
     private createFormData;
 }
 
-export { type CreatePodcastOptions, type CreateVideoOptions, Golpo, Golpo as default };
+export { type CombineVideosOptions, type CombinedVideoResult, type CreatePodcastOptions, type CreateVideoOptions, type EditVideoOptions, type GenerationResult, Golpo, type VideoEditResult, Golpo as default };

package/dist/index.d.ts

@@ -29,11 +29,47 @@ interface CreateVideoOptions {
     includeWatermark?: boolean;
     logo?: string;
     timing?: '1' | '2';
-    useColor?: boolean;
-    newScript?: string | null;
     pollIntervalMs?: number;
     concurrency?: number;
 }
+interface EditVideoOptions {
+    frameIds: string[];
+    editPrompts: string[];
+    referenceImages?: string[];
+    videoUrl: string;
+    userId?: string;
+    pollIntervalMs?: number;
+    autoCombine?: boolean;
+}
+interface FrameAnimations {
+    [frameId: string]: string;
+}
+interface CombineVideosOptions {
+    mp4Urls: string[];
+    videoUrl?: string;
+    pollIntervalMs?: number;
+}
+/**
+ * Result of createPodcast or createVideo (generated content URL, script, and job ID).
+ */
+interface GenerationResult {
+    url: string;
+    script: string;
+    videoId: string;
+}
+/**
+ * Result of editVideo (edited or combined video URL and job ID).
+ */
+interface VideoEditResult {
+    videoUrl: string;
+    jobId: string;
+}
+/**
+ * Result of combineVideos (URL of the combined video).
+ */
+interface CombinedVideoResult {
+    url: string;
+}
 declare class Golpo {
     private readonly http;
     constructor(apiKey: string, baseUrl?: string);
@@ -45,16 +81,58 @@ declare class Golpo {
         podcastUrl: string;
         podcastScript: string;
     }>;
-    createPodcast(prompt: string, opts?: CreatePodcastOptions): Promise<{
-        podcastUrl: string;
-        podcastScript: string;
-    }>;
-    createVideo(prompt: string, opts?: CreateVideoOptions): Promise<{
-        videoUrl: string;
-        videoScript: string;
-    }>;
+    createPodcast(prompt: string, opts?: CreatePodcastOptions): Promise<GenerationResult>;
+    createVideo(prompt: string, opts?: CreateVideoOptions): Promise<GenerationResult>;
+    /**
+     * Edit specific frames of a video and regenerate the video.
+     * This method polls until completion and returns the final edited video URL.
+     * If autoCombine is true, it will also combine all frames into a final video.
+     */
+    editVideo(videoId: string, opts: EditVideoOptions): Promise<VideoEditResult>;
+    /**
+     * Combines edited frames into a final video with audio.
+     * This is a helper method used by editVideo when autoCombine is enabled.
+     */
+    private combineEditedFrames;
+    /**
+     * Create an edit job for a video without waiting for completion.
+     * Returns the job ID that can be used to check status later.
+     */
+    private editVideoJob;
+    /**
+     * Check the status of an edit job.
+     * Returns the video URL if completed, or status information if still processing.
+     */
+    private getEditStatus;
+    /**
+     * Update video metadata (prompt, context, scenes, video_url, frame_animations).
+     * Note: This requires JWT authentication.
+     */
+    private updateVideo;
+    /**
+     * Get frame animations for a video.
+     * Returns a dictionary mapping frame indices to animation URLs.
+     * This is a convenience method that extracts frame_animations from getFrameVersions.
+     */
+    getFrameAnimations(videoId: string): Promise<FrameAnimations>;
+    /**
+     * Get frame versions and animations for a video.
+     * Returns both the current frame_animations and available frame_animation_versions.
+     */
+    private getFrameVersions;
+    /**
+     * Set a specific frame animation version.
+     * Updates the frame_animations for a specific frame in the video.
+     */
+    private setFrameVersion;
+    /**
+     * Combine multiple MP4 videos into a single video.
+     * This is used to combine frame animations into a final video.
+     */
+    combineVideos(opts: CombineVideosOptions): Promise<CombinedVideoResult>;
     private pollUntilComplete;
+    private pollEditStatus;
     private createFormData;
 }
 
-export { type CreatePodcastOptions, type CreateVideoOptions, Golpo, Golpo as default };
+export { type CombineVideosOptions, type CombinedVideoResult, type CreatePodcastOptions, type CreateVideoOptions, type EditVideoOptions, type GenerationResult, Golpo, type VideoEditResult, Golpo as default };

package/dist/index.js

@@ -73,13 +73,11 @@ var Golpo = class {
   async createPodcast(prompt, opts = {}) {
     const { pollIntervalMs = 2e3, ...jobOpts } = opts;
     const jobId = await this.createPodcastJob(prompt, jobOpts);
-    return this.pollUntilComplete(
+    const r = await this.pollUntilComplete(
       jobId,
       pollIntervalMs
-    ).then((r) => ({
-      podcastUrl: r.podcast_url,
-      podcastScript: r.podcast_script
-    }));
+    );
+    return { url: r.podcast_url, script: r.podcast_script, videoId: jobId };
   }
   async createVideo(prompt, opts = {}) {
     const {
@@ -98,9 +96,7 @@ var Golpo = class {
       videoType = "long",
       includeWatermark = true,
       logo,
-      timing = "1",
-      useColor = false,
-      newScript = null
+      timing = "1"
     } = opts;
     const fields = [
       ["prompt", prompt],
@@ -111,14 +107,12 @@ var Golpo = class {
       ["style", style],
       ["video_type", videoType],
       ["include_watermark", String(includeWatermark)],
-      ["timing", timing],
-      ["use_color", String(useColor)]
+      ["timing", timing]
     ];
     if (language) fields.push(["language", language]);
     if (voiceInstructions) fields.push(["voice_instructions", voiceInstructions]);
     if (personality1) fields.push(["personality_1", personality1]);
     if (bgMusic) fields.push(["bg_music", bgMusic]);
-    if (newScript !== null) fields.push(["new_script", newScript]);
     if (logo) {
       fields.push(["logo_path", logo]);
     }
@@ -127,13 +121,231 @@ var Golpo = class {
       timeout: 24e4,
       headers: formData.getHeaders()
     });
-    return this.pollUntilComplete(
+    const r = await this.pollUntilComplete(
       data.job_id,
       pollIntervalMs
-    ).then((r) => ({
-      videoUrl: r.podcast_url,
-      videoScript: r.podcast_script
-    }));
+    );
+    return { url: r.podcast_url, script: r.podcast_script, videoId: data.job_id };
+  }
+  /**
+   * Edit specific frames of a video and regenerate the video.
+   * This method polls until completion and returns the final edited video URL.
+   * If autoCombine is true, it will also combine all frames into a final video.
+   */
+  async editVideo(videoId, opts) {
+    const {
+      frameIds,
+      editPrompts,
+      referenceImages,
+      videoUrl,
+      userId,
+      pollIntervalMs = 2e3,
+      autoCombine = false
+    } = opts;
+    if (frameIds.length !== editPrompts.length) {
+      throw new Error("frameIds and editPrompts must have the same length");
+    }
+    if (!videoUrl) {
+      throw new Error("videoUrl is required");
+    }
+    const jobId = await this.editVideoJob(videoId, opts);
+    const editResult = await this.pollEditStatus(jobId, pollIntervalMs);
+    if (autoCombine) {
+      return this.combineEditedFrames(videoId, editResult, {
+        frameIds,
+        videoUrl,
+        pollIntervalMs
+      });
+    }
+    return {
+      videoUrl: editResult,
+      jobId
+    };
+  }
+  /**
+   * Combines edited frames into a final video with audio.
+   * This is a helper method used by editVideo when autoCombine is enabled.
+   */
+  async combineEditedFrames(videoId, editResult, opts) {
+    const { frameIds, videoUrl, pollIntervalMs } = opts;
+    const jobId = videoId;
+    try {
+      const frameVersions = await this.getFrameVersions(videoId);
+      let frameAnimations = frameVersions.frame_animations ? { ...frameVersions.frame_animations } : {};
+      for (const frameId of frameIds) {
+        await this.setFrameVersion(videoId, frameId, editResult);
+        const updatedVersions = await this.getFrameVersions(videoId);
+        frameAnimations = updatedVersions.frame_animations || {};
+      }
+      const mp4Urls = Object.entries(frameAnimations).sort(([a], [b]) => parseInt(a) - parseInt(b)).map(([_, url]) => url);
+      if (mp4Urls.length === 0) {
+        throw new Error("No frame animations found to combine");
+      }
+      const combineOptions = {
+        mp4Urls,
+        pollIntervalMs,
+        videoUrl
+      };
+      const combined = await this.combineVideos(combineOptions);
+      return { videoUrl: combined.url, jobId };
+    } catch (error) {
+      console.warn("Failed to auto-combine videos, returning edit result:", error);
+      return { videoUrl: editResult, jobId };
+    }
+  }
+  /**
+   * Create an edit job for a video without waiting for completion.
+   * Returns the job ID that can be used to check status later.
+   */
+  async editVideoJob(videoId, opts) {
+    const {
+      frameIds,
+      editPrompts,
+      referenceImages,
+      videoUrl,
+      userId
+    } = opts;
+    if (frameIds.length !== editPrompts.length) {
+      throw new Error("frameIds and editPrompts must have the same length");
+    }
+    const body = {
+      job_id: videoId,
+      frame_ids: frameIds,
+      edit_prompts: editPrompts,
+      return_single_frame: true
+    };
+    if (referenceImages) {
+      body.reference_images = referenceImages;
+    }
+    if (videoUrl) {
+      body.video_url = videoUrl;
+    }
+    if (userId) {
+      body.user_id = userId;
+    }
+    console.log("Body:", body);
+    const { data } = await this.http.post("/api/edit-and-reanimate-frames", body, {
+      headers: {
+        "Content-Type": "application/json"
+      },
+      timeout: 6e4
+    });
+    return data.job_id;
+  }
+  /**
+   * Check the status of an edit job.
+   * Returns the video URL if completed, or status information if still processing.
+   */
+  async getEditStatus(jobId) {
+    const { data } = await this.http.post(
+      "/api/edit-status",
+      { job_id: jobId },
+      {
+        headers: {
+          "Content-Type": "application/json"
+        }
+      }
+    );
+    return data;
+  }
+  /**
+   * Update video metadata (prompt, context, scenes, video_url, frame_animations).
+   * Note: This requires JWT authentication.
+   */
+  async updateVideo(videoId, opts) {
+    const { jwtToken, ...updateData } = opts;
+    if (!jwtToken) {
+      throw new Error("JWT token is required for updating video metadata");
+    }
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${jwtToken}`
+    };
+    const body = {};
+    if (updateData.prompt !== void 0) body.prompt = updateData.prompt;
+    if (updateData.context !== void 0) body.context = updateData.context;
+    if (updateData.scenes !== void 0) body.scenes = updateData.scenes;
+    if (updateData.videoUrl !== void 0) body.video_url = updateData.videoUrl;
+    if (updateData.frameAnimations !== void 0) body.frame_animations = updateData.frameAnimations;
+    const { data } = await this.http.put(
+      `/api/videos/${videoId}`,
+      body,
+      { headers }
+    );
+    return data;
+  }
+  /**
+   * Get frame animations for a video.
+   * Returns a dictionary mapping frame indices to animation URLs.
+   * This is a convenience method that extracts frame_animations from getFrameVersions.
+   */
+  async getFrameAnimations(videoId) {
+    const versions = await this.getFrameVersions(videoId);
+    return versions.frame_animations || {};
+  }
+  /**
+   * Get frame versions and animations for a video.
+   * Returns both the current frame_animations and available frame_animation_versions.
+   */
+  async getFrameVersions(videoId) {
+    const { data } = await this.http.get(`/api/frame-versions/${videoId}`, {
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+    return data;
+  }
+  /**
+   * Set a specific frame animation version.
+   * Updates the frame_animations for a specific frame in the video.
+   */
+  async setFrameVersion(videoId, frameId, animationUrl) {
+    const { data } = await this.http.post(
+      "/api/set-frame-version",
+      {
+        job_id: videoId,
+        frame_id: frameId,
+        url: animationUrl
+      },
+      {
+        headers: {
+          "Content-Type": "application/json"
+        }
+      }
+    );
+    return data;
+  }
+  /**
+   * Combine multiple MP4 videos into a single video.
+   * This is used to combine frame animations into a final video.
+   */
+  async combineVideos(opts) {
+    const {
+      mp4Urls,
+      videoUrl,
+      pollIntervalMs = 2e3
+    } = opts;
+    if (!mp4Urls || mp4Urls.length === 0) {
+      throw new Error("At least one MP4 URL is required");
+    }
+    const body = {
+      mp4_urls: mp4Urls
+    };
+    if (videoUrl) {
+      body.video_url = videoUrl;
+    }
+    const { data } = await this.http.post("/combine-videos", body, {
+      headers: {
+        "Content-Type": "application/json"
+      },
+      timeout: 6e4
+    });
+    const combineJobId = data.job_id;
+    if (!combineJobId) {
+      throw new Error("No job ID received from combine-videos API");
+    }
+    const url = await this.pollEditStatus(combineJobId, pollIntervalMs);
+    return { url };
   }
   /* ------------------------------------------------------------ *
    * INTERNAL HELPERS
@@ -149,6 +361,52 @@ var Golpo = class {
       await new Promise((r) => setTimeout(r, interval));
     }
   }
+  async pollEditStatus(jobId, interval) {
+    const maxAttempts = 1200;
+    let attempts = 0;
+    let retryCount = 0;
+    const maxRetries = 3;
+    while (true) {
+      if (attempts >= maxAttempts) {
+        throw new Error("Edit job timed out");
+      }
+      try {
+        const { data } = await this.http.post(
+          "/api/edit-status",
+          { job_id: jobId },
+          {
+            headers: {
+              "Content-Type": "application/json"
+            }
+          }
+        );
+        if (data.status === "completed") {
+          return data.url;
+        } else if (data.status === "failed" || data.status === "not found") {
+          throw new Error(`Edit job failed: ${data.status}`);
+        } else {
+          console.log("Edit job status:", data.status);
+        }
+        retryCount = 0;
+      } catch (error) {
+        if (error.name === "TypeError" && error.message.includes("fetch failed") || error.code === "ECONNRESET" || error.name === "TimeoutError" || error.response?.status >= 500 && error.response?.status < 600) {
+          if (retryCount < maxRetries) {
+            retryCount++;
+            console.warn(`Retrying request (${retryCount}/${maxRetries}) after network error...`);
+            await new Promise((resolve2) => setTimeout(resolve2, Math.min(5e3 * retryCount, 15e3)));
+            continue;
+          } else {
+            console.warn(`Max retries (${maxRetries}) exceeded for network errors`);
+            retryCount = 0;
+          }
+        } else {
+          console.warn(`Error on attempt ${attempts + 1}, continuing polling:`, error instanceof Error ? error.message : error);
+        }
+      }
+      await new Promise((r) => setTimeout(r, interval));
+      attempts++;
+    }
+  }
   async createFormData(fields, uploads, concurrency, logo) {
     const formData = new FormData();
     fields.forEach(([key, value]) => {

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@golpoai/sdk",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "type": "module",
-  "exports": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist/**/*"