glitch-javascript-sdk 2.9.9 → 3.0.0

package/dist/index.d.ts

@@ -6154,6 +6154,37 @@ interface S3ConfirmRequest {
     title?: string;
     filename?: string;
 }
+/**
+ * Interfaces for the Video Editor Manifest
+ */
+interface VideoEdit {
+    type: 'trim' | 'crop' | 'text' | 'speed' | 'overlay' | 'thumbnail';
+    params: TrimParams | CropParams | TextParams | SpeedParams | any;
+}
+interface TrimParams {
+    start: number;
+    duration: number;
+}
+interface CropParams {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface TextParams {
+    text: string;
+    x: string | number;
+    y: string | number;
+    fontSize: number;
+    fontColor: string;
+}
+interface SpeedParams {
+    multiplier: number;
+}
+interface VideoProcessRequest {
+    edits: VideoEdit[];
+    output_format?: 'mp4' | 'webm';
+}
 declare class Media {
     /**
      * Upload media content using a File object.
@@ -6306,6 +6337,15 @@ declare class Media {
      * @returns AxiosPromise containing the created Media resource.
      */
     static confirmS3Upload<T>(data: S3ConfirmRequest): AxiosPromise<Response<T>>;
+    /**
+    * Submit a video for processing (Trim, Crop, Text, etc.)
+    * This triggers a background job on the server.
+    *
+    * @param media_id The UUID of the source video.
+    * @param data The edit manifest containing the array of transformations.
+    * @returns Promise with the pending_media_id.
+    */
+    static process<T>(media_id: string, data: VideoProcessRequest): AxiosPromise<Response<T>>;
 }
 
 declare class Scheduler {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "2.9.9",
+  "version": "3.0.0",
   "description": "Javascript SDK for Glitch",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/api/Media.ts

@@ -116,6 +116,44 @@ export interface S3ConfirmRequest {
     filename?: string;
 }
 
+/**
+ * Interfaces for the Video Editor Manifest
+ */
+export interface VideoEdit {
+    type: 'trim' | 'crop' | 'text' | 'speed' | 'overlay' | 'thumbnail';
+    params: TrimParams | CropParams | TextParams | SpeedParams | any;
+}
+
+export interface TrimParams {
+    start: number;    // Seconds
+    duration: number; // Seconds
+}
+
+export interface CropParams {
+    x: number;      // Pixels or Percentage based on backend implementation
+    y: number;
+    width: number;
+    height: number;
+}
+
+export interface TextParams {
+    text: string;
+    x: string | number; // e.g., 'center' or 100
+    y: string | number;
+    fontSize: number;
+    fontColor: string; // e.g., 'white' or '#ffffff'
+}
+
+export interface SpeedParams {
+    multiplier: number; // 0.5 for slow-mo, 2.0 for fast-forward
+}
+
+export interface VideoProcessRequest {
+    edits: VideoEdit[];
+    output_format?: 'mp4' | 'webm';
+}
+
+
 class Media {
     /**
      * Upload media content using a File object.
@@ -378,6 +416,22 @@ class Media {
     public static confirmS3Upload<T>(data: S3ConfirmRequest): AxiosPromise<Response<T>> {
         return Requests.processRoute(MediaRoute.routes.confirmS3Upload, data);
     }
+
+     /**
+     * Submit a video for processing (Trim, Crop, Text, etc.)
+     * This triggers a background job on the server.
+     * 
+     * @param media_id The UUID of the source video.
+     * @param data The edit manifest containing the array of transformations.
+     * @returns Promise with the pending_media_id.
+     */
+    public static process<T>(media_id: string, data: VideoProcessRequest): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            MediaRoute.routes.processVideo, 
+            data, 
+            { media_id: media_id }
+        );
+    }
 }
 
 export default Media;

package/src/routes/MediaRoute.ts

@@ -14,6 +14,7 @@ class MediaRoute {
         uploadTikTokMusic: { url: '/media/tiktok/music', method: HTTP_METHODS.POST },
         getPresignedUrl: { url: '/media/presigned-url', method: HTTP_METHODS.POST },
         confirmS3Upload: { url: '/media/s3-confirm', method: HTTP_METHODS.POST },
+        processVideo: { url: '/media/{media_id}/process', method: HTTP_METHODS.POST },
     };
 }