glitch-javascript-sdk 2.5.8 → 2.5.9

package/dist/index.d.ts

@@ -5584,6 +5584,17 @@ interface ScreenshotValidationResponse {
     issues: string[];
     recommendations: string[];
 }
+interface PresignedUrlResponse {
+    upload_url: string;
+    file_path: string;
+}
+interface S3ConfirmRequest {
+    file_path: string;
+    size: number;
+    mime_type: string;
+    title?: string;
+    filename?: string;
+}
 declare class Media {
     /**
      * Upload media content using a File object.
@@ -5719,6 +5730,23 @@ declare class Media {
      * @param scheduler_id The ID of the scheduler to provide OAuth context.
      */
     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.
+     */
+    static getPresignedUrl<T = PresignedUrlResponse>(filename: string, extension: string): AxiosPromise<Response<T>>;
+    /**
+     * Confirm a successful S3 upload and create the database record.
+     * Call this after the direct S3 upload is complete.
+     *
+     * @param data The file metadata (path, size, mime_type).
+     * @returns AxiosPromise containing the created Media resource.
+     */
+    static confirmS3Upload<T>(data: S3ConfirmRequest): AxiosPromise<Response<T>>;
 }
 
 declare class Scheduler {

package/package.json

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

package/src/api/Media.ts

@@ -103,6 +103,19 @@ export interface ScreenshotValidationResponse {
     recommendations: string[];
 }
 
+export interface PresignedUrlResponse {
+    upload_url: string;
+    file_path: string;
+}
+
+export interface S3ConfirmRequest {
+    file_path: string;
+    size: number;
+    mime_type: string;
+    title?: string;
+    filename?: string;
+}
+
 class Media {
     /**
      * Upload media content using a File object.
@@ -342,6 +355,29 @@ class Media {
         // We use the raw URL here as it's a specialized upload path
         return Requests.uploadFile('/media/tiktok/music', 'audio', file, { scheduler_id });
     }
+
+    /**
+     * 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.
+     */
+    public static getPresignedUrl<T = PresignedUrlResponse>(filename: string, extension: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(MediaRoute.routes.getPresignedUrl, { filename, extension });
+    }
+
+    /**
+     * Confirm a successful S3 upload and create the database record.
+     * Call this after the direct S3 upload is complete.
+     * 
+     * @param data The file metadata (path, size, mime_type).
+     * @returns AxiosPromise containing the created Media resource.
+     */
+    public static confirmS3Upload<T>(data: S3ConfirmRequest): AxiosPromise<Response<T>> {
+        return Requests.processRoute(MediaRoute.routes.confirmS3Upload, data);
+    }
 }
 
 export default Media;

package/src/routes/MediaRoute.ts

@@ -12,6 +12,8 @@ class MediaRoute {
         createLibraryLogo: { url: '/media/create-library-logo', method: HTTP_METHODS.POST },
         validateScreenshot: { url: '/media/validate-screenshot', method: HTTP_METHODS.POST },
         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 },
     };
 }