glitch-javascript-sdk 2.9.8 → 3.0.0

package/dist/index.d.ts

@@ -2275,6 +2275,55 @@ declare class Users {
         title_id?: string;
         page?: number;
     }): AxiosPromise<Response<T>>;
+    /**
+    * List the authenticated user's media library (clips, screenshots, AI generated).
+    *
+    * @param params Optional filters: { type: 'clip'|'screenshot'|'ai_generated', title_id: string }
+    */
+    static listMedia<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Add a Media record to the user's personal library.
+     *
+     * @param data { media_id: string, type: string, title_id?: string, label?: string, studio_metadata?: object }
+     */
+    static storeMedia<T>(data: object): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve details for a specific library item.
+     */
+    static viewMedia<T>(id: string): AxiosPromise<Response<T>>;
+    /**
+     * Update a library item's label or metadata.
+     */
+    static updateMedia<T>(id: string, data: object): AxiosPromise<Response<T>>;
+    /**
+     * Remove an item from the user's library (Soft Delete).
+     */
+    static deleteMedia<T>(id: string): AxiosPromise<Response<T>>;
+    /**
+     * Apply AI transformations (Style Transfer/Upscale) to a library item.
+     *
+     * @param id The UUID of the UserMedia record.
+     * @param data { prompt: string, tool: 'style_transfer'|'upscale' }
+     */
+    static modifyMedia<T>(id: string, data: {
+        prompt: string;
+        tool: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get AI-generated suggestions for the best 15-second window to trim a video.
+     */
+    static suggestSmartTrim<T>(id: string): AxiosPromise<Response<T>>;
+    /**
+     * Share a library item to social media as User Generated Content (UGC).
+     *
+     * @param id The UUID of the UserMedia record.
+     * @param data { platform: string, title?: string, content: string }
+     */
+    static shareMedia<T>(id: string, data: {
+        platform: string;
+        title?: string;
+        content: string;
+    }): AxiosPromise<Response<T>>;
 }
 
 declare class Events {
@@ -6105,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.
@@ -6257,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.8",
+  "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/api/Users.ts

@@ -593,6 +593,71 @@ class Users {
         return Requests.processRoute(UserRoutes.routes.userProgressionHistory, undefined, { user_id }, params);
     }
 
+     /**
+     * List the authenticated user's media library (clips, screenshots, AI generated).
+     * 
+     * @param params Optional filters: { type: 'clip'|'screenshot'|'ai_generated', title_id: string }
+     */
+    public static listMedia<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.listMedia, undefined, undefined, params);
+    }
+
+    /**
+     * Add a Media record to the user's personal library.
+     * 
+     * @param data { media_id: string, type: string, title_id?: string, label?: string, studio_metadata?: object }
+     */
+    public static storeMedia<T>(data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.storeMedia, data);
+    }
+
+    /**
+     * Retrieve details for a specific library item.
+     */
+    public static viewMedia<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.viewMedia, undefined, { id });
+    }
+
+    /**
+     * Update a library item's label or metadata.
+     */
+    public static updateMedia<T>(id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.updateMedia, data, { id });
+    }
+
+    /**
+     * Remove an item from the user's library (Soft Delete).
+     */
+    public static deleteMedia<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.deleteMedia, undefined, { id });
+    }
+
+    /**
+     * Apply AI transformations (Style Transfer/Upscale) to a library item.
+     * 
+     * @param id The UUID of the UserMedia record.
+     * @param data { prompt: string, tool: 'style_transfer'|'upscale' }
+     */
+    public static modifyMedia<T>(id: string, data: { prompt: string, tool: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.modifyMedia, data, { id });
+    }
+
+    /**
+     * Get AI-generated suggestions for the best 15-second window to trim a video.
+     */
+    public static suggestSmartTrim<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.suggestSmartTrim, undefined, { id });
+    }
+
+    /**
+     * Share a library item to social media as User Generated Content (UGC).
+     * 
+     * @param id The UUID of the UserMedia record.
+     * @param data { platform: string, title?: string, content: string }
+     */
+    public static shareMedia<T>(id: string, data: { platform: string, title?: string, content: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.shareMedia, data, { id });
+    }
 
 }
 

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 },
     };
 }
 

package/src/routes/UserRoutes.ts

@@ -57,7 +57,17 @@ class UserRoutes {
     userProgressionAchievements: { url: '/users/{user_id}/progression/achievements', method: HTTP_METHODS.GET },
     userProgressionHistory: { url: '/users/{user_id}/progression/history', method: HTTP_METHODS.GET },
 
-
+     // --- User Media Library (Viral Clip Studio) ---
+    listMedia: { url: '/users/me/media', method: HTTP_METHODS.GET },
+    storeMedia: { url: '/users/me/media', method: HTTP_METHODS.POST },
+    viewMedia: { url: '/users/me/media/{id}', method: HTTP_METHODS.GET },
+    updateMedia: { url: '/users/me/media/{id}', method: HTTP_METHODS.PUT },
+    deleteMedia: { url: '/users/me/media/{id}', method: HTTP_METHODS.DELETE },
+    
+    // AI & Social Actions
+    modifyMedia: { url: '/users/me/media/{id}/modify', method: HTTP_METHODS.POST },
+    suggestSmartTrim: { url: '/users/me/media/{id}/smart-trim', method: HTTP_METHODS.GET },
+    shareMedia: { url: '/users/me/media/{id}/share', method: HTTP_METHODS.POST },
   };
 
 }