glitch-javascript-sdk 2.9.9 → 3.0.1

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.
@@ -6291,13 +6322,12 @@ declare class Media {
     static uploadTikTokMusic<T>(file: File, scheduler_id: string): AxiosPromise<Response<T>>;
     /**
      * Generate an S3 Presigned URL for direct upload.
-     * Use this for large files (up to 2GB) to bypass the Laravel server.
      *
      * @param filename The original name of the file.
      * @param extension The file extension (e.g., 'mp4').
-     * @returns AxiosPromise containing upload_url and file_path.
+     * @param is_public Set to true if the file should be publicly accessible via URL.
      */
-    static getPresignedUrl<T = PresignedUrlResponse>(filename: string, extension: string): AxiosPromise<Response<T>>;
+    static getPresignedUrl<T = PresignedUrlResponse>(filename: string, extension: string, is_public?: boolean): AxiosPromise<Response<T>>;
     /**
      * Confirm a successful S3 upload and create the database record.
      * Call this after the direct S3 upload is complete.
@@ -6306,6 +6336,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.1",
   "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.
@@ -358,14 +396,21 @@ class Media {
 
     /**
      * Generate an S3 Presigned URL for direct upload.
-     * Use this for large files (up to 2GB) to bypass the Laravel server.
      * 
      * @param filename The original name of the file.
      * @param extension The file extension (e.g., 'mp4').
-     * @returns AxiosPromise containing upload_url and file_path.
+     * @param is_public Set to true if the file should be publicly accessible via URL.
      */
-    public static getPresignedUrl<T = PresignedUrlResponse>(filename: string, extension: string): AxiosPromise<Response<T>> {
-        return Requests.processRoute(MediaRoute.routes.getPresignedUrl, { filename, extension });
+    public static getPresignedUrl<T = PresignedUrlResponse>(
+        filename: string, 
+        extension: string, 
+        is_public: boolean = false // Added parameter
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(MediaRoute.routes.getPresignedUrl, { 
+            filename, 
+            extension, 
+            is_public // Pass to backend
+        });
     }
 
     /**
@@ -378,6 +423,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 },
     };
 }