krisspy-sdk 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -300,6 +300,195 @@ declare class KrisspyAuth {
 }
 type AuthChangeEvent = 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED' | 'USER_UPDATED';
 
+/**
+ * Krisspy Storage - File storage client
+ *
+ * Provides a simple API for uploading, downloading, and managing files
+ * in Krisspy Cloud Storage (Azure Blob Storage backend).
+ */
+
+interface StorageUploadResponse {
+    data: {
+        path: string;
+        url: string;
+        bucket: string;
+        contentType: string;
+        size: number;
+    } | null;
+    error: KrisspyError | null;
+}
+interface StorageDownloadResponse {
+    data: {
+        url: string;
+        path: string;
+        bucket: string;
+    } | null;
+    error: KrisspyError | null;
+}
+interface StorageListResponse {
+    data: FileObject[] | null;
+    error: KrisspyError | null;
+}
+interface StorageDeleteResponse {
+    data: {
+        success: boolean;
+    } | null;
+    error: KrisspyError | null;
+}
+interface StorageUrlResponse {
+    data: {
+        signedUrl: string;
+        path: string;
+        expiresIn: number;
+    } | null;
+    error: KrisspyError | null;
+}
+/**
+ * Storage bucket interface for file operations
+ */
+declare class StorageBucket {
+    private http;
+    private backendId;
+    private bucketName;
+    constructor(http: HttpClient, backendId: string, bucketName: string);
+    /**
+     * Upload a file to the bucket
+     *
+     * @param path - Path/filename for the file (e.g., "images/profile.jpg")
+     * @param file - File data as Blob, File, ArrayBuffer, or base64 string
+     * @param options - Upload options
+     *
+     * @example
+     * // Upload from file input
+     * const file = event.target.files[0]
+     * const { data, error } = await krisspy.storage
+     *   .from('avatars')
+     *   .upload('profile.jpg', file)
+     *
+     * // Upload base64 image
+     * const { data, error } = await krisspy.storage
+     *   .from('images')
+     *   .upload('photo.png', base64Data, { contentType: 'image/png' })
+     */
+    upload(path: string, file: Blob | File | ArrayBuffer | string, options?: FileUploadOptions): Promise<StorageUploadResponse>;
+    /**
+     * Get the public URL of a file
+     *
+     * @param path - Path to the file
+     *
+     * @example
+     * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+     * console.log(data.publicUrl) // https://...
+     */
+    getPublicUrl(path: string): {
+        data: {
+            publicUrl: string;
+        };
+    };
+    /**
+     * Download a file (get download URL)
+     *
+     * @param path - Path to the file
+     *
+     * @example
+     * const { data, error } = await krisspy.storage
+     *   .from('documents')
+     *   .download('report.pdf')
+     */
+    download(path: string): Promise<StorageDownloadResponse>;
+    /**
+     * Delete a file from storage
+     *
+     * @param paths - Path(s) to delete
+     *
+     * @example
+     * // Delete single file
+     * const { error } = await krisspy.storage.from('avatars').remove(['profile.jpg'])
+     *
+     * // Delete multiple files
+     * const { error } = await krisspy.storage.from('images').remove(['a.jpg', 'b.jpg'])
+     */
+    remove(paths: string[]): Promise<StorageDeleteResponse>;
+    /**
+     * List files in the bucket
+     *
+     * @param prefix - Filter files by path prefix
+     * @param options - List options
+     *
+     * @example
+     * // List all files
+     * const { data, error } = await krisspy.storage.from('uploads').list()
+     *
+     * // List files in a folder
+     * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+     */
+    list(prefix?: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<StorageListResponse>;
+    /**
+     * Create a signed URL for temporary access
+     *
+     * @param path - Path to the file
+     * @param expiresIn - Expiration time in seconds (default: 3600)
+     *
+     * @example
+     * const { data, error } = await krisspy.storage
+     *   .from('private')
+     *   .createSignedUrl('document.pdf', 3600)
+     */
+    createSignedUrl(path: string, expiresIn?: number): Promise<StorageUrlResponse>;
+    private blobToBase64;
+    private arrayBufferToBase64;
+    private detectMimeType;
+}
+/**
+ * Krisspy Storage client
+ *
+ * @example
+ * // Upload a file
+ * const { data, error } = await krisspy.storage
+ *   .from('avatars')
+ *   .upload('profile.jpg', file)
+ *
+ * // Get public URL
+ * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+ *
+ * // Download
+ * const { data, error } = await krisspy.storage.from('docs').download('file.pdf')
+ *
+ * // List files
+ * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+ *
+ * // Delete files
+ * const { error } = await krisspy.storage.from('uploads').remove(['old.jpg'])
+ */
+declare class KrisspyStorage {
+    private http;
+    private backendId;
+    constructor(http: HttpClient, backendId: string);
+    /**
+     * Select a storage bucket
+     *
+     * @param bucket - Bucket name (e.g., 'avatars', 'documents', 'media')
+     * @returns StorageBucket instance for file operations
+     *
+     * @example
+     * const bucket = krisspy.storage.from('avatars')
+     * await bucket.upload('profile.jpg', file)
+     */
+    from(bucket: string): StorageBucket;
+    /**
+     * List all buckets (currently returns predefined buckets)
+     */
+    listBuckets(): Promise<{
+        data: {
+            name: string;
+        }[] | null;
+        error: KrisspyError | null;
+    }>;
+}
+
 /**
  * Query Builder - Supabase-style fluent API for database queries
  */
@@ -448,6 +637,7 @@ declare class KrisspyClient {
     private http;
     private backendId;
     private _auth;
+    private _storage;
     private useRLS;
     constructor(options: KrisspyClientOptions);
     /**
@@ -473,6 +663,28 @@ declare class KrisspyClient {
      * await krisspy.auth.signOut()
      */
     get auth(): KrisspyAuth;
+    /**
+     * Storage module for file uploads and downloads
+     *
+     * @example
+     * // Upload a file
+     * const { data, error } = await krisspy.storage
+     *   .from('avatars')
+     *   .upload('profile.jpg', file)
+     *
+     * // Get public URL
+     * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+     *
+     * // Download
+     * const { data, error } = await krisspy.storage.from('docs').download('file.pdf')
+     *
+     * // List files
+     * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+     *
+     * // Delete files
+     * const { error } = await krisspy.storage.from('uploads').remove(['old.jpg'])
+     */
+    get storage(): KrisspyStorage;
     /**
      * Create a query builder for a table
      *
@@ -557,7 +769,7 @@ declare class KrisspyClient {
 /**
  * @krisspy/sdk - Krisspy Cloud SDK
  *
- * Database, Auth, and Functions for your apps.
+ * Database, Auth, Storage, and Functions for your apps.
  * A simpler alternative to Supabase.
  *
  * @example
@@ -583,6 +795,10 @@ declare class KrisspyClient {
  * // Insert
  * await krisspy.from('products').insert({ name: 'iPhone', price: 999 })
  *
+ * // Storage
+ * await krisspy.storage.from('avatars').upload('profile.jpg', file)
+ * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+ *
  * // Functions
  * await krisspy.functions.invoke('hello', { body: { name: 'World' } })
  */
@@ -602,4 +818,4 @@ declare class KrisspyClient {
  */
 declare function createClient(options: KrisspyClientOptions): KrisspyClient;
 
-export { type AuthChangeEvent, type AuthResponse, type FileObject, type FileUploadOptions, type Filter, type FilterOperator, type FunctionInvokeOptions, type FunctionResponse, HttpClient, KrisspyAuth, KrisspyClient, type KrisspyClientOptions, type KrisspyError, type MutationResponse, type OAuthProvider, type OrderBy, QueryBuilder, type QueryOptions, type QueryResponse, type Session, type SignInCredentials, type SignUpCredentials, type SingleResponse, type User, createClient };
+export { type AuthChangeEvent, type AuthResponse, type FileObject, type FileUploadOptions, type Filter, type FilterOperator, type FunctionInvokeOptions, type FunctionResponse, HttpClient, KrisspyAuth, KrisspyClient, type KrisspyClientOptions, type KrisspyError, KrisspyStorage, type MutationResponse, type OAuthProvider, type OrderBy, QueryBuilder, type QueryOptions, type QueryResponse, type Session, type SignInCredentials, type SignUpCredentials, type SingleResponse, StorageBucket, type User, createClient };

package/dist/index.d.ts

@@ -300,6 +300,195 @@ declare class KrisspyAuth {
 }
 type AuthChangeEvent = 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED' | 'USER_UPDATED';
 
+/**
+ * Krisspy Storage - File storage client
+ *
+ * Provides a simple API for uploading, downloading, and managing files
+ * in Krisspy Cloud Storage (Azure Blob Storage backend).
+ */
+
+interface StorageUploadResponse {
+    data: {
+        path: string;
+        url: string;
+        bucket: string;
+        contentType: string;
+        size: number;
+    } | null;
+    error: KrisspyError | null;
+}
+interface StorageDownloadResponse {
+    data: {
+        url: string;
+        path: string;
+        bucket: string;
+    } | null;
+    error: KrisspyError | null;
+}
+interface StorageListResponse {
+    data: FileObject[] | null;
+    error: KrisspyError | null;
+}
+interface StorageDeleteResponse {
+    data: {
+        success: boolean;
+    } | null;
+    error: KrisspyError | null;
+}
+interface StorageUrlResponse {
+    data: {
+        signedUrl: string;
+        path: string;
+        expiresIn: number;
+    } | null;
+    error: KrisspyError | null;
+}
+/**
+ * Storage bucket interface for file operations
+ */
+declare class StorageBucket {
+    private http;
+    private backendId;
+    private bucketName;
+    constructor(http: HttpClient, backendId: string, bucketName: string);
+    /**
+     * Upload a file to the bucket
+     *
+     * @param path - Path/filename for the file (e.g., "images/profile.jpg")
+     * @param file - File data as Blob, File, ArrayBuffer, or base64 string
+     * @param options - Upload options
+     *
+     * @example
+     * // Upload from file input
+     * const file = event.target.files[0]
+     * const { data, error } = await krisspy.storage
+     *   .from('avatars')
+     *   .upload('profile.jpg', file)
+     *
+     * // Upload base64 image
+     * const { data, error } = await krisspy.storage
+     *   .from('images')
+     *   .upload('photo.png', base64Data, { contentType: 'image/png' })
+     */
+    upload(path: string, file: Blob | File | ArrayBuffer | string, options?: FileUploadOptions): Promise<StorageUploadResponse>;
+    /**
+     * Get the public URL of a file
+     *
+     * @param path - Path to the file
+     *
+     * @example
+     * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+     * console.log(data.publicUrl) // https://...
+     */
+    getPublicUrl(path: string): {
+        data: {
+            publicUrl: string;
+        };
+    };
+    /**
+     * Download a file (get download URL)
+     *
+     * @param path - Path to the file
+     *
+     * @example
+     * const { data, error } = await krisspy.storage
+     *   .from('documents')
+     *   .download('report.pdf')
+     */
+    download(path: string): Promise<StorageDownloadResponse>;
+    /**
+     * Delete a file from storage
+     *
+     * @param paths - Path(s) to delete
+     *
+     * @example
+     * // Delete single file
+     * const { error } = await krisspy.storage.from('avatars').remove(['profile.jpg'])
+     *
+     * // Delete multiple files
+     * const { error } = await krisspy.storage.from('images').remove(['a.jpg', 'b.jpg'])
+     */
+    remove(paths: string[]): Promise<StorageDeleteResponse>;
+    /**
+     * List files in the bucket
+     *
+     * @param prefix - Filter files by path prefix
+     * @param options - List options
+     *
+     * @example
+     * // List all files
+     * const { data, error } = await krisspy.storage.from('uploads').list()
+     *
+     * // List files in a folder
+     * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+     */
+    list(prefix?: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<StorageListResponse>;
+    /**
+     * Create a signed URL for temporary access
+     *
+     * @param path - Path to the file
+     * @param expiresIn - Expiration time in seconds (default: 3600)
+     *
+     * @example
+     * const { data, error } = await krisspy.storage
+     *   .from('private')
+     *   .createSignedUrl('document.pdf', 3600)
+     */
+    createSignedUrl(path: string, expiresIn?: number): Promise<StorageUrlResponse>;
+    private blobToBase64;
+    private arrayBufferToBase64;
+    private detectMimeType;
+}
+/**
+ * Krisspy Storage client
+ *
+ * @example
+ * // Upload a file
+ * const { data, error } = await krisspy.storage
+ *   .from('avatars')
+ *   .upload('profile.jpg', file)
+ *
+ * // Get public URL
+ * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+ *
+ * // Download
+ * const { data, error } = await krisspy.storage.from('docs').download('file.pdf')
+ *
+ * // List files
+ * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+ *
+ * // Delete files
+ * const { error } = await krisspy.storage.from('uploads').remove(['old.jpg'])
+ */
+declare class KrisspyStorage {
+    private http;
+    private backendId;
+    constructor(http: HttpClient, backendId: string);
+    /**
+     * Select a storage bucket
+     *
+     * @param bucket - Bucket name (e.g., 'avatars', 'documents', 'media')
+     * @returns StorageBucket instance for file operations
+     *
+     * @example
+     * const bucket = krisspy.storage.from('avatars')
+     * await bucket.upload('profile.jpg', file)
+     */
+    from(bucket: string): StorageBucket;
+    /**
+     * List all buckets (currently returns predefined buckets)
+     */
+    listBuckets(): Promise<{
+        data: {
+            name: string;
+        }[] | null;
+        error: KrisspyError | null;
+    }>;
+}
+
 /**
  * Query Builder - Supabase-style fluent API for database queries
  */
@@ -448,6 +637,7 @@ declare class KrisspyClient {
     private http;
     private backendId;
     private _auth;
+    private _storage;
     private useRLS;
     constructor(options: KrisspyClientOptions);
     /**
@@ -473,6 +663,28 @@ declare class KrisspyClient {
      * await krisspy.auth.signOut()
      */
     get auth(): KrisspyAuth;
+    /**
+     * Storage module for file uploads and downloads
+     *
+     * @example
+     * // Upload a file
+     * const { data, error } = await krisspy.storage
+     *   .from('avatars')
+     *   .upload('profile.jpg', file)
+     *
+     * // Get public URL
+     * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+     *
+     * // Download
+     * const { data, error } = await krisspy.storage.from('docs').download('file.pdf')
+     *
+     * // List files
+     * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+     *
+     * // Delete files
+     * const { error } = await krisspy.storage.from('uploads').remove(['old.jpg'])
+     */
+    get storage(): KrisspyStorage;
     /**
      * Create a query builder for a table
      *
@@ -557,7 +769,7 @@ declare class KrisspyClient {
 /**
  * @krisspy/sdk - Krisspy Cloud SDK
  *
- * Database, Auth, and Functions for your apps.
+ * Database, Auth, Storage, and Functions for your apps.
  * A simpler alternative to Supabase.
  *
  * @example
@@ -583,6 +795,10 @@ declare class KrisspyClient {
  * // Insert
  * await krisspy.from('products').insert({ name: 'iPhone', price: 999 })
  *
+ * // Storage
+ * await krisspy.storage.from('avatars').upload('profile.jpg', file)
+ * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+ *
  * // Functions
  * await krisspy.functions.invoke('hello', { body: { name: 'World' } })
  */
@@ -602,4 +818,4 @@ declare class KrisspyClient {
  */
 declare function createClient(options: KrisspyClientOptions): KrisspyClient;
 
-export { type AuthChangeEvent, type AuthResponse, type FileObject, type FileUploadOptions, type Filter, type FilterOperator, type FunctionInvokeOptions, type FunctionResponse, HttpClient, KrisspyAuth, KrisspyClient, type KrisspyClientOptions, type KrisspyError, type MutationResponse, type OAuthProvider, type OrderBy, QueryBuilder, type QueryOptions, type QueryResponse, type Session, type SignInCredentials, type SignUpCredentials, type SingleResponse, type User, createClient };
+export { type AuthChangeEvent, type AuthResponse, type FileObject, type FileUploadOptions, type Filter, type FilterOperator, type FunctionInvokeOptions, type FunctionResponse, HttpClient, KrisspyAuth, KrisspyClient, type KrisspyClientOptions, type KrisspyError, KrisspyStorage, type MutationResponse, type OAuthProvider, type OrderBy, QueryBuilder, type QueryOptions, type QueryResponse, type Session, type SignInCredentials, type SignUpCredentials, type SingleResponse, StorageBucket, type User, createClient };

package/dist/index.js

@@ -23,7 +23,9 @@ __export(index_exports, {
   HttpClient: () => HttpClient,
   KrisspyAuth: () => KrisspyAuth,
   KrisspyClient: () => KrisspyClient,
+  KrisspyStorage: () => KrisspyStorage,
   QueryBuilder: () => QueryBuilder,
+  StorageBucket: () => StorageBucket,
   createClient: () => createClient
 });
 module.exports = __toCommonJS(index_exports);
@@ -478,6 +480,303 @@ var KrisspyAuth = class {
   }
 };
 
+// src/storage.ts
+var StorageBucket = class {
+  constructor(http, backendId, bucketName) {
+    this.http = http;
+    this.backendId = backendId;
+    this.bucketName = bucketName;
+  }
+  /**
+   * Upload a file to the bucket
+   *
+   * @param path - Path/filename for the file (e.g., "images/profile.jpg")
+   * @param file - File data as Blob, File, ArrayBuffer, or base64 string
+   * @param options - Upload options
+   *
+   * @example
+   * // Upload from file input
+   * const file = event.target.files[0]
+   * const { data, error } = await krisspy.storage
+   *   .from('avatars')
+   *   .upload('profile.jpg', file)
+   *
+   * // Upload base64 image
+   * const { data, error } = await krisspy.storage
+   *   .from('images')
+   *   .upload('photo.png', base64Data, { contentType: 'image/png' })
+   */
+  async upload(path, file, options) {
+    try {
+      let base64Data;
+      let contentType = options?.contentType;
+      if (typeof file === "string") {
+        base64Data = file;
+      } else if (file instanceof Blob || file instanceof File) {
+        base64Data = await this.blobToBase64(file);
+        if (!contentType && file instanceof File) {
+          contentType = file.type;
+        }
+      } else if (file instanceof ArrayBuffer) {
+        base64Data = this.arrayBufferToBase64(file);
+      } else {
+        throw new Error("Invalid file type. Expected Blob, File, ArrayBuffer, or base64 string.");
+      }
+      if (!contentType) {
+        contentType = this.detectMimeType(path);
+      }
+      const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/upload`;
+      const response = await this.http.post(apiPath, {
+        bucket: this.bucketName,
+        path,
+        data: base64Data,
+        contentType
+      });
+      if (response.error) {
+        return { data: null, error: response.error };
+      }
+      return {
+        data: {
+          path: response.data?.path || path,
+          url: response.data?.url || "",
+          bucket: response.data?.bucket || this.bucketName,
+          contentType: response.data?.contentType || contentType || "application/octet-stream",
+          size: response.data?.size || 0
+        },
+        error: null
+      };
+    } catch (error) {
+      return {
+        data: null,
+        error: {
+          message: error.message || "Upload failed",
+          code: "STORAGE_UPLOAD_ERROR"
+        }
+      };
+    }
+  }
+  /**
+   * Get the public URL of a file
+   *
+   * @param path - Path to the file
+   *
+   * @example
+   * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+   * console.log(data.publicUrl) // https://...
+   */
+  getPublicUrl(path) {
+    const baseUrl = "https://krisspy.blob.core.windows.net/public";
+    const storagePath = `backends/${this.backendId}/${this.bucketName}/${path}`;
+    const publicUrl = `${baseUrl}/${storagePath}`;
+    return {
+      data: { publicUrl }
+    };
+  }
+  /**
+   * Download a file (get download URL)
+   *
+   * @param path - Path to the file
+   *
+   * @example
+   * const { data, error } = await krisspy.storage
+   *   .from('documents')
+   *   .download('report.pdf')
+   */
+  async download(path) {
+    const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/download`;
+    const response = await this.http.post(apiPath, {
+      bucket: this.bucketName,
+      path
+    });
+    if (response.error) {
+      return { data: null, error: response.error };
+    }
+    return {
+      data: {
+        url: response.data?.url || "",
+        path: response.data?.path || path,
+        bucket: response.data?.bucket || this.bucketName
+      },
+      error: null
+    };
+  }
+  /**
+   * Delete a file from storage
+   *
+   * @param paths - Path(s) to delete
+   *
+   * @example
+   * // Delete single file
+   * const { error } = await krisspy.storage.from('avatars').remove(['profile.jpg'])
+   *
+   * // Delete multiple files
+   * const { error } = await krisspy.storage.from('images').remove(['a.jpg', 'b.jpg'])
+   */
+  async remove(paths) {
+    const results = [];
+    for (const path of paths) {
+      const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/delete`;
+      const response = await this.http.post(apiPath, {
+        bucket: this.bucketName,
+        path
+      });
+      if (response.error) {
+        return { data: null, error: response.error };
+      }
+      results.push({ success: response.data?.success || false });
+    }
+    return { data: { success: true }, error: null };
+  }
+  /**
+   * List files in the bucket
+   *
+   * @param prefix - Filter files by path prefix
+   * @param options - List options
+   *
+   * @example
+   * // List all files
+   * const { data, error } = await krisspy.storage.from('uploads').list()
+   *
+   * // List files in a folder
+   * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+   */
+  async list(prefix, options) {
+    const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/list`;
+    const response = await this.http.post(apiPath, {
+      bucket: this.bucketName,
+      prefix,
+      limit: options?.limit || 100
+    });
+    if (response.error) {
+      return { data: null, error: response.error };
+    }
+    return { data: response.data?.files || [], error: null };
+  }
+  /**
+   * Create a signed URL for temporary access
+   *
+   * @param path - Path to the file
+   * @param expiresIn - Expiration time in seconds (default: 3600)
+   *
+   * @example
+   * const { data, error } = await krisspy.storage
+   *   .from('private')
+   *   .createSignedUrl('document.pdf', 3600)
+   */
+  async createSignedUrl(path, expiresIn = 3600) {
+    const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/signed-url`;
+    const response = await this.http.post(apiPath, {
+      bucket: this.bucketName,
+      path,
+      expiresIn
+    });
+    if (response.error) {
+      return { data: null, error: response.error };
+    }
+    return {
+      data: {
+        signedUrl: response.data?.url || "",
+        path: response.data?.path || path,
+        expiresIn: response.data?.expiresIn || expiresIn
+      },
+      error: null
+    };
+  }
+  // Helper: Convert Blob to base64
+  blobToBase64(blob) {
+    return new Promise((resolve, reject) => {
+      const reader = new FileReader();
+      reader.onloadend = () => {
+        const result = reader.result;
+        const base64 = result.includes(",") ? result.split(",")[1] : result;
+        resolve(base64);
+      };
+      reader.onerror = reject;
+      reader.readAsDataURL(blob);
+    });
+  }
+  // Helper: Convert ArrayBuffer to base64
+  arrayBufferToBase64(buffer) {
+    let binary = "";
+    const bytes = new Uint8Array(buffer);
+    for (let i = 0; i < bytes.length; i++) {
+      binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+  }
+  // Helper: Detect MIME type from file extension
+  detectMimeType(path) {
+    const ext = path.split(".").pop()?.toLowerCase() || "";
+    const mimeTypes = {
+      // Images
+      jpg: "image/jpeg",
+      jpeg: "image/jpeg",
+      png: "image/png",
+      gif: "image/gif",
+      webp: "image/webp",
+      svg: "image/svg+xml",
+      ico: "image/x-icon",
+      // Documents
+      pdf: "application/pdf",
+      doc: "application/msword",
+      docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+      xls: "application/vnd.ms-excel",
+      xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+      // Text
+      txt: "text/plain",
+      csv: "text/csv",
+      json: "application/json",
+      xml: "application/xml",
+      html: "text/html",
+      css: "text/css",
+      js: "application/javascript",
+      // Audio/Video
+      mp3: "audio/mpeg",
+      wav: "audio/wav",
+      mp4: "video/mp4",
+      webm: "video/webm",
+      // Archives
+      zip: "application/zip",
+      tar: "application/x-tar",
+      gz: "application/gzip"
+    };
+    return mimeTypes[ext] || "application/octet-stream";
+  }
+};
+var KrisspyStorage = class {
+  constructor(http, backendId) {
+    this.http = http;
+    this.backendId = backendId;
+  }
+  /**
+   * Select a storage bucket
+   *
+   * @param bucket - Bucket name (e.g., 'avatars', 'documents', 'media')
+   * @returns StorageBucket instance for file operations
+   *
+   * @example
+   * const bucket = krisspy.storage.from('avatars')
+   * await bucket.upload('profile.jpg', file)
+   */
+  from(bucket) {
+    return new StorageBucket(this.http, this.backendId, bucket);
+  }
+  /**
+   * List all buckets (currently returns predefined buckets)
+   */
+  async listBuckets() {
+    return {
+      data: [
+        { name: "media" },
+        { name: "avatars" },
+        { name: "documents" },
+        { name: "uploads" }
+      ],
+      error: null
+    };
+  }
+};
+
 // src/query-builder.ts
 var QueryBuilder = class {
   constructor(http, backendId, tableName, useRLS = true) {
@@ -769,6 +1068,7 @@ var KrisspyClient = class {
       debug: options.debug
     });
     this._auth = new KrisspyAuth(this.http, this.backendId);
+    this._storage = new KrisspyStorage(this.http, this.backendId);
   }
   /**
    * Auth module for user authentication
@@ -795,6 +1095,30 @@ var KrisspyClient = class {
   get auth() {
     return this._auth;
   }
+  /**
+   * Storage module for file uploads and downloads
+   *
+   * @example
+   * // Upload a file
+   * const { data, error } = await krisspy.storage
+   *   .from('avatars')
+   *   .upload('profile.jpg', file)
+   *
+   * // Get public URL
+   * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+   *
+   * // Download
+   * const { data, error } = await krisspy.storage.from('docs').download('file.pdf')
+   *
+   * // List files
+   * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+   *
+   * // Delete files
+   * const { error } = await krisspy.storage.from('uploads').remove(['old.jpg'])
+   */
+  get storage() {
+    return this._storage;
+  }
   /**
    * Create a query builder for a table
    *
@@ -916,6 +1240,8 @@ function createClient(options) {
   HttpClient,
   KrisspyAuth,
   KrisspyClient,
+  KrisspyStorage,
   QueryBuilder,
+  StorageBucket,
   createClient
 });

package/dist/index.mjs

@@ -448,6 +448,303 @@ var KrisspyAuth = class {
   }
 };
 
+// src/storage.ts
+var StorageBucket = class {
+  constructor(http, backendId, bucketName) {
+    this.http = http;
+    this.backendId = backendId;
+    this.bucketName = bucketName;
+  }
+  /**
+   * Upload a file to the bucket
+   *
+   * @param path - Path/filename for the file (e.g., "images/profile.jpg")
+   * @param file - File data as Blob, File, ArrayBuffer, or base64 string
+   * @param options - Upload options
+   *
+   * @example
+   * // Upload from file input
+   * const file = event.target.files[0]
+   * const { data, error } = await krisspy.storage
+   *   .from('avatars')
+   *   .upload('profile.jpg', file)
+   *
+   * // Upload base64 image
+   * const { data, error } = await krisspy.storage
+   *   .from('images')
+   *   .upload('photo.png', base64Data, { contentType: 'image/png' })
+   */
+  async upload(path, file, options) {
+    try {
+      let base64Data;
+      let contentType = options?.contentType;
+      if (typeof file === "string") {
+        base64Data = file;
+      } else if (file instanceof Blob || file instanceof File) {
+        base64Data = await this.blobToBase64(file);
+        if (!contentType && file instanceof File) {
+          contentType = file.type;
+        }
+      } else if (file instanceof ArrayBuffer) {
+        base64Data = this.arrayBufferToBase64(file);
+      } else {
+        throw new Error("Invalid file type. Expected Blob, File, ArrayBuffer, or base64 string.");
+      }
+      if (!contentType) {
+        contentType = this.detectMimeType(path);
+      }
+      const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/upload`;
+      const response = await this.http.post(apiPath, {
+        bucket: this.bucketName,
+        path,
+        data: base64Data,
+        contentType
+      });
+      if (response.error) {
+        return { data: null, error: response.error };
+      }
+      return {
+        data: {
+          path: response.data?.path || path,
+          url: response.data?.url || "",
+          bucket: response.data?.bucket || this.bucketName,
+          contentType: response.data?.contentType || contentType || "application/octet-stream",
+          size: response.data?.size || 0
+        },
+        error: null
+      };
+    } catch (error) {
+      return {
+        data: null,
+        error: {
+          message: error.message || "Upload failed",
+          code: "STORAGE_UPLOAD_ERROR"
+        }
+      };
+    }
+  }
+  /**
+   * Get the public URL of a file
+   *
+   * @param path - Path to the file
+   *
+   * @example
+   * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+   * console.log(data.publicUrl) // https://...
+   */
+  getPublicUrl(path) {
+    const baseUrl = "https://krisspy.blob.core.windows.net/public";
+    const storagePath = `backends/${this.backendId}/${this.bucketName}/${path}`;
+    const publicUrl = `${baseUrl}/${storagePath}`;
+    return {
+      data: { publicUrl }
+    };
+  }
+  /**
+   * Download a file (get download URL)
+   *
+   * @param path - Path to the file
+   *
+   * @example
+   * const { data, error } = await krisspy.storage
+   *   .from('documents')
+   *   .download('report.pdf')
+   */
+  async download(path) {
+    const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/download`;
+    const response = await this.http.post(apiPath, {
+      bucket: this.bucketName,
+      path
+    });
+    if (response.error) {
+      return { data: null, error: response.error };
+    }
+    return {
+      data: {
+        url: response.data?.url || "",
+        path: response.data?.path || path,
+        bucket: response.data?.bucket || this.bucketName
+      },
+      error: null
+    };
+  }
+  /**
+   * Delete a file from storage
+   *
+   * @param paths - Path(s) to delete
+   *
+   * @example
+   * // Delete single file
+   * const { error } = await krisspy.storage.from('avatars').remove(['profile.jpg'])
+   *
+   * // Delete multiple files
+   * const { error } = await krisspy.storage.from('images').remove(['a.jpg', 'b.jpg'])
+   */
+  async remove(paths) {
+    const results = [];
+    for (const path of paths) {
+      const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/delete`;
+      const response = await this.http.post(apiPath, {
+        bucket: this.bucketName,
+        path
+      });
+      if (response.error) {
+        return { data: null, error: response.error };
+      }
+      results.push({ success: response.data?.success || false });
+    }
+    return { data: { success: true }, error: null };
+  }
+  /**
+   * List files in the bucket
+   *
+   * @param prefix - Filter files by path prefix
+   * @param options - List options
+   *
+   * @example
+   * // List all files
+   * const { data, error } = await krisspy.storage.from('uploads').list()
+   *
+   * // List files in a folder
+   * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+   */
+  async list(prefix, options) {
+    const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/list`;
+    const response = await this.http.post(apiPath, {
+      bucket: this.bucketName,
+      prefix,
+      limit: options?.limit || 100
+    });
+    if (response.error) {
+      return { data: null, error: response.error };
+    }
+    return { data: response.data?.files || [], error: null };
+  }
+  /**
+   * Create a signed URL for temporary access
+   *
+   * @param path - Path to the file
+   * @param expiresIn - Expiration time in seconds (default: 3600)
+   *
+   * @example
+   * const { data, error } = await krisspy.storage
+   *   .from('private')
+   *   .createSignedUrl('document.pdf', 3600)
+   */
+  async createSignedUrl(path, expiresIn = 3600) {
+    const apiPath = `/api/v1/cloud-backends/${this.backendId}/storage/signed-url`;
+    const response = await this.http.post(apiPath, {
+      bucket: this.bucketName,
+      path,
+      expiresIn
+    });
+    if (response.error) {
+      return { data: null, error: response.error };
+    }
+    return {
+      data: {
+        signedUrl: response.data?.url || "",
+        path: response.data?.path || path,
+        expiresIn: response.data?.expiresIn || expiresIn
+      },
+      error: null
+    };
+  }
+  // Helper: Convert Blob to base64
+  blobToBase64(blob) {
+    return new Promise((resolve, reject) => {
+      const reader = new FileReader();
+      reader.onloadend = () => {
+        const result = reader.result;
+        const base64 = result.includes(",") ? result.split(",")[1] : result;
+        resolve(base64);
+      };
+      reader.onerror = reject;
+      reader.readAsDataURL(blob);
+    });
+  }
+  // Helper: Convert ArrayBuffer to base64
+  arrayBufferToBase64(buffer) {
+    let binary = "";
+    const bytes = new Uint8Array(buffer);
+    for (let i = 0; i < bytes.length; i++) {
+      binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+  }
+  // Helper: Detect MIME type from file extension
+  detectMimeType(path) {
+    const ext = path.split(".").pop()?.toLowerCase() || "";
+    const mimeTypes = {
+      // Images
+      jpg: "image/jpeg",
+      jpeg: "image/jpeg",
+      png: "image/png",
+      gif: "image/gif",
+      webp: "image/webp",
+      svg: "image/svg+xml",
+      ico: "image/x-icon",
+      // Documents
+      pdf: "application/pdf",
+      doc: "application/msword",
+      docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+      xls: "application/vnd.ms-excel",
+      xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+      // Text
+      txt: "text/plain",
+      csv: "text/csv",
+      json: "application/json",
+      xml: "application/xml",
+      html: "text/html",
+      css: "text/css",
+      js: "application/javascript",
+      // Audio/Video
+      mp3: "audio/mpeg",
+      wav: "audio/wav",
+      mp4: "video/mp4",
+      webm: "video/webm",
+      // Archives
+      zip: "application/zip",
+      tar: "application/x-tar",
+      gz: "application/gzip"
+    };
+    return mimeTypes[ext] || "application/octet-stream";
+  }
+};
+var KrisspyStorage = class {
+  constructor(http, backendId) {
+    this.http = http;
+    this.backendId = backendId;
+  }
+  /**
+   * Select a storage bucket
+   *
+   * @param bucket - Bucket name (e.g., 'avatars', 'documents', 'media')
+   * @returns StorageBucket instance for file operations
+   *
+   * @example
+   * const bucket = krisspy.storage.from('avatars')
+   * await bucket.upload('profile.jpg', file)
+   */
+  from(bucket) {
+    return new StorageBucket(this.http, this.backendId, bucket);
+  }
+  /**
+   * List all buckets (currently returns predefined buckets)
+   */
+  async listBuckets() {
+    return {
+      data: [
+        { name: "media" },
+        { name: "avatars" },
+        { name: "documents" },
+        { name: "uploads" }
+      ],
+      error: null
+    };
+  }
+};
+
 // src/query-builder.ts
 var QueryBuilder = class {
   constructor(http, backendId, tableName, useRLS = true) {
@@ -739,6 +1036,7 @@ var KrisspyClient = class {
       debug: options.debug
     });
     this._auth = new KrisspyAuth(this.http, this.backendId);
+    this._storage = new KrisspyStorage(this.http, this.backendId);
   }
   /**
    * Auth module for user authentication
@@ -765,6 +1063,30 @@ var KrisspyClient = class {
   get auth() {
     return this._auth;
   }
+  /**
+   * Storage module for file uploads and downloads
+   *
+   * @example
+   * // Upload a file
+   * const { data, error } = await krisspy.storage
+   *   .from('avatars')
+   *   .upload('profile.jpg', file)
+   *
+   * // Get public URL
+   * const { data } = krisspy.storage.from('avatars').getPublicUrl('profile.jpg')
+   *
+   * // Download
+   * const { data, error } = await krisspy.storage.from('docs').download('file.pdf')
+   *
+   * // List files
+   * const { data, error } = await krisspy.storage.from('uploads').list('images/')
+   *
+   * // Delete files
+   * const { error } = await krisspy.storage.from('uploads').remove(['old.jpg'])
+   */
+  get storage() {
+    return this._storage;
+  }
   /**
    * Create a query builder for a table
    *
@@ -885,6 +1207,8 @@ export {
   HttpClient,
   KrisspyAuth,
   KrisspyClient,
+  KrisspyStorage,
   QueryBuilder,
+  StorageBucket,
   createClient
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "krisspy-sdk",
-  "version": "0.1.0",
-  "description": "Krisspy Cloud SDK - Database, Auth, and Functions for your apps",
+  "version": "0.2.0",
+  "description": "Krisspy Cloud SDK - Database, Auth, Storage, and Functions for your apps",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -24,6 +24,8 @@
     "baas",
     "database",
     "auth",
+    "storage",
+    "blob",
     "sdk",
     "supabase-alternative"
   ],