@insforge/sdk 0.0.13 → 0.0.15

package/dist/index.d.mts

@@ -102,6 +102,12 @@ declare class Auth {
     private tokenManager;
     private database;
     constructor(http: HttpClient, tokenManager: TokenManager);
+    /**
+     * Automatically detect and handle OAuth callback parameters in the URL
+     * This runs on initialization to seamlessly complete the OAuth flow
+     * Matches the backend's OAuth callback response (backend/src/api/routes/auth.ts:540-544)
+     */
+    private detectOAuthCallback;
     /**
      * Sign up a new user
      */
@@ -363,6 +369,7 @@ declare class Database {
 /**
  * Storage module for InsForge SDK
  * Handles file uploads, downloads, and bucket management
+ * Supports both presigned URLs (S3) and direct uploads (local)
  */
 
 interface StorageResponse<T> {
@@ -377,18 +384,26 @@ declare class StorageBucket {
     private http;
     constructor(bucketName: string, http: HttpClient);
     /**
-     * Upload a file with a specific key
+     * Upload a file with a specific key using the appropriate strategy
      * @param path - The object key/path
-     * @param file - File, Blob, or FormData to upload
+     * @param file - File or Blob to upload
+     */
+    upload(path: string, file: File | Blob): Promise<StorageResponse<StorageFileSchema>>;
+    /**
+     * Upload using presigned URL (for S3)
+     */
+    private uploadPresigned;
+    /**
+     * Upload directly to backend (for local storage)
      */
-    upload(path: string, file: File | Blob | FormData): Promise<StorageResponse<StorageFileSchema>>;
+    private uploadDirect;
     /**
      * Upload a file with auto-generated key
-     * @param file - File, Blob, or FormData to upload
+     * @param file - File or Blob to upload
      */
-    uploadAuto(file: File | Blob | FormData): Promise<StorageResponse<StorageFileSchema>>;
+    uploadAuto(file: File | Blob): Promise<StorageResponse<StorageFileSchema>>;
     /**
-     * Download a file
+     * Download a file using the appropriate strategy
      * @param path - The object key/path
      * Returns the file as a Blob
      */
@@ -397,7 +412,15 @@ declare class StorageBucket {
         error: InsForgeError | null;
     }>;
     /**
-     * Get public URL for a file
+     * Download using presigned URL (for S3)
+     */
+    private downloadPresigned;
+    /**
+     * Download directly from backend (for local storage)
+     */
+    private downloadDirect;
+    /**
+     * Get public URL for a file (direct URL, may not work for private S3)
      * @param path - The object key/path
      */
     getPublicUrl(path: string): string;

package/dist/index.d.ts

@@ -102,6 +102,12 @@ declare class Auth {
     private tokenManager;
     private database;
     constructor(http: HttpClient, tokenManager: TokenManager);
+    /**
+     * Automatically detect and handle OAuth callback parameters in the URL
+     * This runs on initialization to seamlessly complete the OAuth flow
+     * Matches the backend's OAuth callback response (backend/src/api/routes/auth.ts:540-544)
+     */
+    private detectOAuthCallback;
     /**
      * Sign up a new user
      */
@@ -363,6 +369,7 @@ declare class Database {
 /**
  * Storage module for InsForge SDK
  * Handles file uploads, downloads, and bucket management
+ * Supports both presigned URLs (S3) and direct uploads (local)
  */
 
 interface StorageResponse<T> {
@@ -377,18 +384,26 @@ declare class StorageBucket {
     private http;
     constructor(bucketName: string, http: HttpClient);
     /**
-     * Upload a file with a specific key
+     * Upload a file with a specific key using the appropriate strategy
      * @param path - The object key/path
-     * @param file - File, Blob, or FormData to upload
+     * @param file - File or Blob to upload
+     */
+    upload(path: string, file: File | Blob): Promise<StorageResponse<StorageFileSchema>>;
+    /**
+     * Upload using presigned URL (for S3)
+     */
+    private uploadPresigned;
+    /**
+     * Upload directly to backend (for local storage)
      */
-    upload(path: string, file: File | Blob | FormData): Promise<StorageResponse<StorageFileSchema>>;
+    private uploadDirect;
     /**
      * Upload a file with auto-generated key
-     * @param file - File, Blob, or FormData to upload
+     * @param file - File or Blob to upload
      */
-    uploadAuto(file: File | Blob | FormData): Promise<StorageResponse<StorageFileSchema>>;
+    uploadAuto(file: File | Blob): Promise<StorageResponse<StorageFileSchema>>;
     /**
-     * Download a file
+     * Download a file using the appropriate strategy
      * @param path - The object key/path
      * Returns the file as a Blob
      */
@@ -397,7 +412,15 @@ declare class StorageBucket {
         error: InsForgeError | null;
     }>;
     /**
-     * Get public URL for a file
+     * Download using presigned URL (for S3)
+     */
+    private downloadPresigned;
+    /**
+     * Download directly from backend (for local storage)
+     */
+    private downloadDirect;
+    /**
+     * Get public URL for a file (direct URL, may not work for private S3)
      * @param path - The object key/path
      */
     getPublicUrl(path: string): string;

package/dist/index.js

@@ -499,6 +499,50 @@ var Auth = class {
     this.http = http;
     this.tokenManager = tokenManager;
     this.database = new Database(http);
+    this.detectOAuthCallback();
+  }
+  /**
+   * Automatically detect and handle OAuth callback parameters in the URL
+   * This runs on initialization to seamlessly complete the OAuth flow
+   * Matches the backend's OAuth callback response (backend/src/api/routes/auth.ts:540-544)
+   */
+  detectOAuthCallback() {
+    if (typeof window === "undefined") return;
+    try {
+      const params = new URLSearchParams(window.location.search);
+      const accessToken = params.get("access_token");
+      const userId = params.get("user_id");
+      const email = params.get("email");
+      const name = params.get("name");
+      if (accessToken && userId && email) {
+        const session = {
+          accessToken,
+          user: {
+            id: userId,
+            email,
+            name: name || "",
+            // These fields are not provided by backend OAuth callback
+            // They'll be populated when calling getCurrentUser()
+            emailVerified: false,
+            createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+            updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+          }
+        };
+        this.tokenManager.saveSession(session);
+        this.http.setAuthToken(accessToken);
+        const url = new URL(window.location.href);
+        url.searchParams.delete("access_token");
+        url.searchParams.delete("user_id");
+        url.searchParams.delete("email");
+        url.searchParams.delete("name");
+        if (params.has("error")) {
+          url.searchParams.delete("error");
+        }
+        window.history.replaceState({}, document.title, url.toString());
+      }
+    } catch (error) {
+      console.debug("OAuth callback detection skipped:", error);
+    }
   }
   /**
    * Sign up a new user
@@ -717,16 +761,104 @@ var StorageBucket = class {
     this.http = http;
   }
   /**
-   * Upload a file with a specific key
+   * Upload a file with a specific key using the appropriate strategy
    * @param path - The object key/path
-   * @param file - File, Blob, or FormData to upload
+   * @param file - File or Blob to upload
    */
   async upload(path, file) {
     try {
-      const formData = file instanceof FormData ? file : new FormData();
-      if (!(file instanceof FormData)) {
-        formData.append("file", file);
+      const strategyRequest = {
+        filename: path,
+        contentType: file.type || "application/octet-stream",
+        size: file.size
+      };
+      const strategy = await this.http.post(
+        `/api/storage/buckets/${this.bucketName}/upload-strategy`,
+        strategyRequest
+      );
+      if (!strategy) {
+        throw new InsForgeError("Failed to get upload strategy", 500, "STORAGE_ERROR");
+      }
+      if (strategy.method === "presigned") {
+        return await this.uploadPresigned(strategy, file);
+      } else {
+        return await this.uploadDirect(path, file);
       }
+    } catch (error) {
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          "Upload failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+  /**
+   * Upload using presigned URL (for S3)
+   */
+  async uploadPresigned(strategy, file) {
+    try {
+      const formData = new FormData();
+      if (strategy.fields) {
+        Object.entries(strategy.fields).forEach(([key, value]) => {
+          formData.append(key, value);
+        });
+      }
+      formData.append("file", file);
+      const uploadResponse = await fetch(strategy.uploadUrl, {
+        method: "POST",
+        body: formData
+      });
+      if (!uploadResponse.ok) {
+        const text = await uploadResponse.text();
+        throw new InsForgeError(
+          `Presigned upload failed: ${text}`,
+          uploadResponse.status,
+          "STORAGE_ERROR"
+        );
+      }
+      if (strategy.confirmRequired && strategy.confirmUrl) {
+        const confirmRequest = {
+          size: file.size,
+          contentType: file.type || "application/octet-stream"
+        };
+        const confirmResponse = await this.http.post(
+          strategy.confirmUrl,
+          confirmRequest
+        );
+        return { data: confirmResponse, error: null };
+      }
+      return {
+        data: {
+          bucket: this.bucketName,
+          key: strategy.key,
+          size: file.size,
+          mimeType: file.type,
+          uploadedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          url: this.getPublicUrl(strategy.key)
+        },
+        error: null
+      };
+    } catch (error) {
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          "Presigned upload failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+  /**
+   * Upload directly to backend (for local storage)
+   */
+  async uploadDirect(path, file) {
+    try {
+      const formData = new FormData();
+      formData.append("file", file);
       const response = await this.http.request(
         "PUT",
         `/api/storage/buckets/${this.bucketName}/objects/${encodeURIComponent(path)}`,
@@ -742,7 +874,7 @@ var StorageBucket = class {
       return {
         data: null,
         error: error instanceof InsForgeError ? error : new InsForgeError(
-          "Upload failed",
+          "Direct upload failed",
           500,
           "STORAGE_ERROR"
         )
@@ -751,14 +883,12 @@ var StorageBucket = class {
   }
   /**
    * Upload a file with auto-generated key
-   * @param file - File, Blob, or FormData to upload
+   * @param file - File or Blob to upload
    */
   async uploadAuto(file) {
     try {
-      const formData = file instanceof FormData ? file : new FormData();
-      if (!(file instanceof FormData)) {
-        formData.append("file", file);
-      }
+      const formData = new FormData();
+      formData.append("file", file);
       const response = await this.http.request(
         "POST",
         `/api/storage/buckets/${this.bucketName}/objects`,
@@ -782,11 +912,78 @@ var StorageBucket = class {
     }
   }
   /**
-   * Download a file
+   * Download a file using the appropriate strategy
    * @param path - The object key/path
    * Returns the file as a Blob
    */
   async download(path) {
+    try {
+      const strategyRequest = {
+        expiresIn: 3600
+        // 1 hour default
+      };
+      const strategy = await this.http.post(
+        `/api/storage/buckets/${this.bucketName}/objects/${encodeURIComponent(path)}/download-strategy`,
+        strategyRequest
+      );
+      if (!strategy) {
+        return await this.downloadDirect(path);
+      }
+      if (strategy.method === "presigned") {
+        return await this.downloadPresigned(strategy);
+      } else {
+        return await this.downloadDirect(path);
+      }
+    } catch (error) {
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          "Download failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+  /**
+   * Download using presigned URL (for S3)
+   */
+  async downloadPresigned(strategy) {
+    try {
+      const headers = {};
+      if (strategy.headers) {
+        Object.entries(strategy.headers).forEach(([key, value]) => {
+          headers[key] = value;
+        });
+      }
+      const response = await fetch(strategy.url, {
+        method: "GET",
+        headers
+      });
+      if (!response.ok) {
+        throw new InsForgeError(
+          `Download failed: ${response.statusText}`,
+          response.status,
+          "STORAGE_ERROR"
+        );
+      }
+      const blob = await response.blob();
+      return { data: blob, error: null };
+    } catch (error) {
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          "Presigned download failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+  /**
+   * Download directly from backend (for local storage)
+   */
+  async downloadDirect(path) {
     try {
       const url = `${this.http.baseUrl}/api/storage/buckets/${this.bucketName}/objects/${encodeURIComponent(path)}`;
       const response = await this.http.fetch(url, {
@@ -811,15 +1008,17 @@ var StorageBucket = class {
       return {
         data: null,
         error: error instanceof InsForgeError ? error : new InsForgeError(
-          "Download failed",
+          "Direct download failed",
           500,
           "STORAGE_ERROR"
         )
       };
     }
   }
+  // Removed getSignedUrl - this is handled internally by download()
+  // The SDK abstracts away presigned URL complexity
   /**
-   * Get public URL for a file
+   * Get public URL for a file (direct URL, may not work for private S3)
    * @param path - The object key/path
    */
   getPublicUrl(path) {