@insforge/sdk 0.0.6 → 0.0.8

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, GetCurrentSessionResponse } from '@insforge/shared-schemas';
+import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, GetCurrentSessionResponse, StorageFileSchema, ListObjectsResponseSchema } from '@insforge/shared-schemas';
 export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, UserSchema } from '@insforge/shared-schemas';
 
 /**
@@ -68,8 +68,8 @@ interface RequestOptions extends RequestInit {
     params?: Record<string, string>;
 }
 declare class HttpClient {
-    private baseUrl;
-    private fetch;
+    readonly baseUrl: string;
+    readonly fetch: typeof fetch;
     private defaultHeaders;
     constructor(config: InsForgeConfig);
     private buildUrl;
@@ -80,6 +80,7 @@ declare class HttpClient {
     patch<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
     delete<T>(path: string, options?: RequestOptions): Promise<T>;
     setAuthToken(token: string | null): void;
+    getHeaders(): Record<string, string>;
 }
 
 declare class TokenManager {
@@ -177,11 +178,12 @@ declare class QueryBuilder<T = any> {
     constructor(table: string, http: HttpClient);
     /**
      * Perform a SELECT query
+     * For mutations (insert/update/delete), this enables returning data
      * @param columns - Columns to select (default: '*')
      * @example
      * .select('*')
      * .select('id, title, content')
-     * .select('*, user:user_id(name, email)')  // Foreign key expansion
+     * .insert({ title: 'New' }).select()  // Returns inserted data
      */
     select(columns?: string): this;
     /**
@@ -189,8 +191,8 @@ declare class QueryBuilder<T = any> {
      * @param values - Single object or array of objects
      * @param options - { upsert: true } for upsert behavior
      * @example
-     * .insert({ title: 'Hello', content: 'World' })
-     * .insert([{ title: 'Post 1' }, { title: 'Post 2' }])
+     * .insert({ title: 'Hello', content: 'World' }).select()
+     * .insert([{ title: 'Post 1' }, { title: 'Post 2' }]).select()
      */
     insert(values: Partial<T> | Partial<T>[], options?: {
         upsert?: boolean;
@@ -199,13 +201,13 @@ declare class QueryBuilder<T = any> {
      * Perform an UPDATE
      * @param values - Object with fields to update
      * @example
-     * .update({ title: 'Updated Title' })
+     * .update({ title: 'Updated Title' }).select()
      */
     update(values: Partial<T>): this;
     /**
      * Perform a DELETE
      * @example
-     * .delete()
+     * .delete().select()
      */
     delete(): this;
     /**
@@ -329,6 +331,81 @@ declare class Database {
     from<T = any>(table: string): QueryBuilder<T>;
 }
 
+/**
+ * Storage module for InsForge SDK
+ * Handles file uploads, downloads, and bucket management
+ */
+
+interface StorageResponse<T> {
+    data: T | null;
+    error: InsForgeError | null;
+}
+/**
+ * Storage bucket operations
+ */
+declare class StorageBucket {
+    private bucketName;
+    private http;
+    constructor(bucketName: string, http: HttpClient);
+    /**
+     * Upload a file with a specific key
+     * @param path - The object key/path
+     * @param file - File, Blob, or FormData to upload
+     */
+    upload(path: string, file: File | Blob | FormData): Promise<StorageResponse<StorageFileSchema>>;
+    /**
+     * Upload a file with auto-generated key
+     * @param file - File, Blob, or FormData to upload
+     */
+    uploadAuto(file: File | Blob | FormData): Promise<StorageResponse<StorageFileSchema>>;
+    /**
+     * Download a file
+     * @param path - The object key/path
+     * Returns the file as a Blob
+     */
+    download(path: string): Promise<{
+        data: Blob | null;
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Get public URL for a file
+     * @param path - The object key/path
+     */
+    getPublicUrl(path: string): string;
+    /**
+     * List objects in the bucket
+     * @param prefix - Filter by key prefix
+     * @param search - Search in file names
+     * @param limit - Maximum number of results (default: 100, max: 1000)
+     * @param offset - Number of results to skip
+     */
+    list(options?: {
+        prefix?: string;
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<StorageResponse<ListObjectsResponseSchema>>;
+    /**
+     * Delete a file
+     * @param path - The object key/path
+     */
+    remove(path: string): Promise<StorageResponse<{
+        message: string;
+    }>>;
+}
+/**
+ * Storage module for file operations
+ */
+declare class Storage {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get a bucket instance for operations
+     * @param bucketName - Name of the bucket
+     */
+    from(bucketName: string): StorageBucket;
+}
+
 /**
  * Main InsForge SDK Client
  *
@@ -367,6 +444,7 @@ declare class InsForgeClient {
     private tokenManager;
     readonly auth: Auth;
     readonly database: Database;
+    readonly storage: Storage;
     constructor(config?: InsForgeConfig);
     /**
      * Set a custom API key for authentication
@@ -400,4 +478,4 @@ declare class InsForgeClient {
 
 declare function createClient(config: InsForgeConfig): InsForgeClient;
 
-export { type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, Database, type DatabaseResponse, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, QueryBuilder, TokenManager, type TokenStorage, createClient, InsForgeClient as default };
+export { type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, Database, type DatabaseResponse, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, QueryBuilder, Storage, StorageBucket, type StorageResponse, TokenManager, type TokenStorage, createClient, InsForgeClient as default };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, GetCurrentSessionResponse } from '@insforge/shared-schemas';
+import { UserSchema, CreateUserRequest, CreateUserResponse, CreateSessionRequest, CreateSessionResponse, GetCurrentSessionResponse, StorageFileSchema, ListObjectsResponseSchema } from '@insforge/shared-schemas';
 export { AuthErrorResponse, CreateSessionRequest, CreateUserRequest, UserSchema } from '@insforge/shared-schemas';
 
 /**
@@ -68,8 +68,8 @@ interface RequestOptions extends RequestInit {
     params?: Record<string, string>;
 }
 declare class HttpClient {
-    private baseUrl;
-    private fetch;
+    readonly baseUrl: string;
+    readonly fetch: typeof fetch;
     private defaultHeaders;
     constructor(config: InsForgeConfig);
     private buildUrl;
@@ -80,6 +80,7 @@ declare class HttpClient {
     patch<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
     delete<T>(path: string, options?: RequestOptions): Promise<T>;
     setAuthToken(token: string | null): void;
+    getHeaders(): Record<string, string>;
 }
 
 declare class TokenManager {
@@ -177,11 +178,12 @@ declare class QueryBuilder<T = any> {
     constructor(table: string, http: HttpClient);
     /**
      * Perform a SELECT query
+     * For mutations (insert/update/delete), this enables returning data
      * @param columns - Columns to select (default: '*')
      * @example
      * .select('*')
      * .select('id, title, content')
-     * .select('*, user:user_id(name, email)')  // Foreign key expansion
+     * .insert({ title: 'New' }).select()  // Returns inserted data
      */
     select(columns?: string): this;
     /**
@@ -189,8 +191,8 @@ declare class QueryBuilder<T = any> {
      * @param values - Single object or array of objects
      * @param options - { upsert: true } for upsert behavior
      * @example
-     * .insert({ title: 'Hello', content: 'World' })
-     * .insert([{ title: 'Post 1' }, { title: 'Post 2' }])
+     * .insert({ title: 'Hello', content: 'World' }).select()
+     * .insert([{ title: 'Post 1' }, { title: 'Post 2' }]).select()
      */
     insert(values: Partial<T> | Partial<T>[], options?: {
         upsert?: boolean;
@@ -199,13 +201,13 @@ declare class QueryBuilder<T = any> {
      * Perform an UPDATE
      * @param values - Object with fields to update
      * @example
-     * .update({ title: 'Updated Title' })
+     * .update({ title: 'Updated Title' }).select()
      */
     update(values: Partial<T>): this;
     /**
      * Perform a DELETE
      * @example
-     * .delete()
+     * .delete().select()
      */
     delete(): this;
     /**
@@ -329,6 +331,81 @@ declare class Database {
     from<T = any>(table: string): QueryBuilder<T>;
 }
 
+/**
+ * Storage module for InsForge SDK
+ * Handles file uploads, downloads, and bucket management
+ */
+
+interface StorageResponse<T> {
+    data: T | null;
+    error: InsForgeError | null;
+}
+/**
+ * Storage bucket operations
+ */
+declare class StorageBucket {
+    private bucketName;
+    private http;
+    constructor(bucketName: string, http: HttpClient);
+    /**
+     * Upload a file with a specific key
+     * @param path - The object key/path
+     * @param file - File, Blob, or FormData to upload
+     */
+    upload(path: string, file: File | Blob | FormData): Promise<StorageResponse<StorageFileSchema>>;
+    /**
+     * Upload a file with auto-generated key
+     * @param file - File, Blob, or FormData to upload
+     */
+    uploadAuto(file: File | Blob | FormData): Promise<StorageResponse<StorageFileSchema>>;
+    /**
+     * Download a file
+     * @param path - The object key/path
+     * Returns the file as a Blob
+     */
+    download(path: string): Promise<{
+        data: Blob | null;
+        error: InsForgeError | null;
+    }>;
+    /**
+     * Get public URL for a file
+     * @param path - The object key/path
+     */
+    getPublicUrl(path: string): string;
+    /**
+     * List objects in the bucket
+     * @param prefix - Filter by key prefix
+     * @param search - Search in file names
+     * @param limit - Maximum number of results (default: 100, max: 1000)
+     * @param offset - Number of results to skip
+     */
+    list(options?: {
+        prefix?: string;
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<StorageResponse<ListObjectsResponseSchema>>;
+    /**
+     * Delete a file
+     * @param path - The object key/path
+     */
+    remove(path: string): Promise<StorageResponse<{
+        message: string;
+    }>>;
+}
+/**
+ * Storage module for file operations
+ */
+declare class Storage {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get a bucket instance for operations
+     * @param bucketName - Name of the bucket
+     */
+    from(bucketName: string): StorageBucket;
+}
+
 /**
  * Main InsForge SDK Client
  *
@@ -367,6 +444,7 @@ declare class InsForgeClient {
     private tokenManager;
     readonly auth: Auth;
     readonly database: Database;
+    readonly storage: Storage;
     constructor(config?: InsForgeConfig);
     /**
      * Set a custom API key for authentication
@@ -400,4 +478,4 @@ declare class InsForgeClient {
 
 declare function createClient(config: InsForgeConfig): InsForgeClient;
 
-export { type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, Database, type DatabaseResponse, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, QueryBuilder, TokenManager, type TokenStorage, createClient, InsForgeClient as default };
+export { type ApiError, Auth, type AuthSession, type InsForgeConfig as ClientOptions, Database, type DatabaseResponse, HttpClient, InsForgeClient, type InsForgeConfig, InsForgeError, QueryBuilder, Storage, StorageBucket, type StorageResponse, TokenManager, type TokenStorage, createClient, InsForgeClient as default };

package/dist/index.js

@@ -26,6 +26,8 @@ __export(index_exports, {
   InsForgeClient: () => InsForgeClient,
   InsForgeError: () => InsForgeError,
   QueryBuilder: () => QueryBuilder,
+  Storage: () => Storage,
+  StorageBucket: () => StorageBucket,
   TokenManager: () => TokenManager,
   createClient: () => createClient,
   default: () => index_default
@@ -83,14 +85,22 @@ var HttpClient = class {
     const requestHeaders = {
       ...this.defaultHeaders
     };
-    if (method !== "GET" && body !== void 0) {
-      requestHeaders["Content-Type"] = "application/json;charset=UTF-8";
+    let processedBody;
+    if (body !== void 0) {
+      if (typeof FormData !== "undefined" && body instanceof FormData) {
+        processedBody = body;
+      } else {
+        if (method !== "GET") {
+          requestHeaders["Content-Type"] = "application/json;charset=UTF-8";
+        }
+        processedBody = JSON.stringify(body);
+      }
     }
     Object.assign(requestHeaders, headers);
     const response = await this.fetch(url, {
       method,
       headers: requestHeaders,
-      body: body ? JSON.stringify(body) : void 0,
+      body: processedBody,
       ...fetchOptions
     });
     if (response.status === 204) {
@@ -137,6 +147,9 @@ var HttpClient = class {
       delete this.defaultHeaders["Authorization"];
     }
   }
+  getHeaders() {
+    return { ...this.defaultHeaders };
+  }
 };
 
 // src/lib/token-manager.ts
@@ -379,14 +392,22 @@ var QueryBuilder = class {
   }
   /**
    * Perform a SELECT query
+   * For mutations (insert/update/delete), this enables returning data
    * @param columns - Columns to select (default: '*')
    * @example
    * .select('*')
    * .select('id, title, content')
-   * .select('*, user:user_id(name, email)')  // Foreign key expansion
+   * .insert({ title: 'New' }).select()  // Returns inserted data
    */
   select(columns = "*") {
-    this.method = "GET";
+    if (this.method !== "GET") {
+      const existingPrefer = this.headers["Prefer"] || "";
+      const preferParts = existingPrefer ? [existingPrefer] : [];
+      if (!preferParts.some((p) => p.includes("return="))) {
+        preferParts.push("return=representation");
+      }
+      this.headers["Prefer"] = preferParts.join(",");
+    }
     if (columns !== "*") {
       this.queryParams.select = columns;
     }
@@ -397,16 +418,14 @@ var QueryBuilder = class {
    * @param values - Single object or array of objects
    * @param options - { upsert: true } for upsert behavior
    * @example
-   * .insert({ title: 'Hello', content: 'World' })
-   * .insert([{ title: 'Post 1' }, { title: 'Post 2' }])
+   * .insert({ title: 'Hello', content: 'World' }).select()
+   * .insert([{ title: 'Post 1' }, { title: 'Post 2' }]).select()
    */
   insert(values, options) {
     this.method = "POST";
     this.body = Array.isArray(values) ? values : [values];
     if (options?.upsert) {
-      this.headers["Prefer"] = "resolution=merge-duplicates,return=representation";
-    } else {
-      this.headers["Prefer"] = "return=representation";
+      this.headers["Prefer"] = "resolution=merge-duplicates";
     }
     return this;
   }
@@ -414,22 +433,20 @@ var QueryBuilder = class {
    * Perform an UPDATE
    * @param values - Object with fields to update
    * @example
-   * .update({ title: 'Updated Title' })
+   * .update({ title: 'Updated Title' }).select()
    */
   update(values) {
     this.method = "PATCH";
     this.body = values;
-    this.headers["Prefer"] = "return=representation";
     return this;
   }
   /**
    * Perform a DELETE
    * @example
-   * .delete()
+   * .delete().select()
    */
   delete() {
     this.method = "DELETE";
-    this.headers["Prefer"] = "return=representation";
     return this;
   }
   /**
@@ -651,6 +668,186 @@ var Database = class {
   }
 };
 
+// src/modules/storage.ts
+var StorageBucket = class {
+  constructor(bucketName, http) {
+    this.bucketName = bucketName;
+    this.http = http;
+  }
+  /**
+   * Upload a file with a specific key
+   * @param path - The object key/path
+   * @param file - File, Blob, or FormData to upload
+   */
+  async upload(path, file) {
+    try {
+      const formData = file instanceof FormData ? file : new FormData();
+      if (!(file instanceof FormData)) {
+        formData.append("file", file);
+      }
+      const response = await this.http.request(
+        "PUT",
+        `/api/storage/buckets/${this.bucketName}/objects/${encodeURIComponent(path)}`,
+        {
+          body: formData,
+          headers: {
+            // Don't set Content-Type, let browser set multipart boundary
+          }
+        }
+      );
+      return { data: response, error: null };
+    } catch (error) {
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          "Upload failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+  /**
+   * Upload a file with auto-generated key
+   * @param file - File, Blob, or FormData to upload
+   */
+  async uploadAuto(file) {
+    try {
+      const formData = file instanceof FormData ? file : new FormData();
+      if (!(file instanceof FormData)) {
+        formData.append("file", file);
+      }
+      const response = await this.http.request(
+        "POST",
+        `/api/storage/buckets/${this.bucketName}/objects`,
+        {
+          body: formData,
+          headers: {
+            // Don't set Content-Type, let browser set multipart boundary
+          }
+        }
+      );
+      return { data: response, error: null };
+    } catch (error) {
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          "Upload failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+  /**
+   * Download a file
+   * @param path - The object key/path
+   * Returns the file as a Blob
+   */
+  async download(path) {
+    try {
+      const url = `${this.http.baseUrl}/api/storage/buckets/${this.bucketName}/objects/${encodeURIComponent(path)}`;
+      const response = await this.http.fetch(url, {
+        method: "GET",
+        headers: this.http.getHeaders()
+      });
+      if (!response.ok) {
+        try {
+          const error = await response.json();
+          throw InsForgeError.fromApiError(error);
+        } catch {
+          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(
+          "Download failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+  /**
+   * Get public URL for a file
+   * @param path - The object key/path
+   */
+  getPublicUrl(path) {
+    return `${this.http.baseUrl}/api/storage/buckets/${this.bucketName}/objects/${encodeURIComponent(path)}`;
+  }
+  /**
+   * List objects in the bucket
+   * @param prefix - Filter by key prefix
+   * @param search - Search in file names
+   * @param limit - Maximum number of results (default: 100, max: 1000)
+   * @param offset - Number of results to skip
+   */
+  async list(options) {
+    try {
+      const params = {};
+      if (options?.prefix) params.prefix = options.prefix;
+      if (options?.search) params.search = options.search;
+      if (options?.limit) params.limit = options.limit.toString();
+      if (options?.offset) params.offset = options.offset.toString();
+      const response = await this.http.get(
+        `/api/storage/buckets/${this.bucketName}/objects`,
+        { params }
+      );
+      return { data: response, error: null };
+    } catch (error) {
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          "List failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+  /**
+   * Delete a file
+   * @param path - The object key/path
+   */
+  async remove(path) {
+    try {
+      const response = await this.http.delete(
+        `/api/storage/buckets/${this.bucketName}/objects/${encodeURIComponent(path)}`
+      );
+      return { data: response, error: null };
+    } catch (error) {
+      return {
+        data: null,
+        error: error instanceof InsForgeError ? error : new InsForgeError(
+          "Delete failed",
+          500,
+          "STORAGE_ERROR"
+        )
+      };
+    }
+  }
+};
+var Storage = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Get a bucket instance for operations
+   * @param bucketName - Name of the bucket
+   */
+  from(bucketName) {
+    return new StorageBucket(bucketName, this.http);
+  }
+};
+
 // src/client.ts
 var InsForgeClient = class {
   constructor(config = {}) {
@@ -661,6 +858,7 @@ var InsForgeClient = class {
       this.tokenManager
     );
     this.database = new Database(this.http);
+    this.storage = new Storage(this.http);
   }
   /**
    * Set a custom API key for authentication
@@ -711,6 +909,8 @@ var index_default = InsForgeClient;
   InsForgeClient,
   InsForgeError,
   QueryBuilder,
+  Storage,
+  StorageBucket,
   TokenManager,
   createClient
 });