@allanfsouza/aether-sdk 2.4.2 → 2.4.3

package/dist/auth.d.ts

@@ -1,18 +1,19 @@
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
+export interface User {
+    id: string;
+    name: string;
+    email: string;
+    avatarUrl?: string;
+    role?: string;
+    aetherRole?: string;
+    planCode?: string;
+    emailVerified?: boolean;
+}
 export interface LoginResponse {
     accessToken: string;
     refreshToken: string;
-    user: {
-        id: string;
-        name: string;
-        email: string;
-        avatarUrl?: string;
-        role?: string;
-        aetherRole?: string;
-        planCode?: string;
-        emailVerified?: boolean;
-    };
+    user: User;
 }
 export interface Session {
     id: string;
@@ -25,55 +26,66 @@ export declare class AuthModule {
     private client;
     private http;
     private refreshToken;
+    private currentUser;
     constructor(client: PlataformaClient, http: AxiosInstance);
-    /**
-     * Login com email e senha
-     */
     login(email: string, password: string): Promise<LoginResponse>;
-    /**
-     * Registrar novo usuário
-     */
     register(credentials: {
         name: string;
         email: string;
         password: string;
     }): Promise<any>;
-    /**
-     * Renovar access token usando refresh token
-     */
     refresh(): Promise<{
         accessToken: string;
     }>;
-    /**
-     * Obter URL de autenticação do Google
-     */
     getGoogleAuthUrl(): string;
-    /**
-     * Logout da sessão atual
-     */
     logout(): Promise<void>;
-    /**
-     * Logout de todas as sessões
-     */
     logoutAll(): Promise<void>;
-    /**
-     * Listar sessões ativas
-     */
     getSessions(): Promise<Session[]>;
+    forgotPassword(email: string): Promise<any>;
+    resetPassword(token: string, newPassword: string): Promise<any>;
+    getRefreshToken(): string | null;
+    setRefreshToken(token: string | null): void;
     /**
-     * Esqueci minha senha
+     * Alias para login, retornando { user, error } padrão do Showcase
      */
-    forgotPassword(email: string): Promise<any>;
+    signInWithPassword(credentials: {
+        email: string;
+        password: string;
+    }): Promise<{
+        user: User;
+        error: null;
+    } | {
+        user: null;
+        error: any;
+    }>;
     /**
-     * Redefinir senha
+     * Alias para register, retornando { user, error }
      */
-    resetPassword(token: string, newPassword: string): Promise<any>;
+    signUp(credentials: {
+        email: string;
+        password: string;
+        data?: {
+            name: string;
+        };
+    }): Promise<{
+        user: any;
+        error: null;
+    } | {
+        user: null;
+        error: any;
+    }>;
     /**
-     * Obter refresh token atual (para armazenamento)
+     * Alias para logout
      */
-    getRefreshToken(): string | null;
+    signOut(): Promise<{
+        error: null;
+    }>;
     /**
-     * Definir refresh token (para restaurar sessão)
+     * Recupera a sessão atual (User + Token).
+     * Se não tiver logado, retorna null ou tenta validar o token.
      */
-    setRefreshToken(token: string | null): void;
+    getSession(): Promise<{
+        user: User;
+        access_token: string;
+    } | null>;
 }

package/dist/auth.js

@@ -1,12 +1,14 @@
 export class AuthModule {
     constructor(client, http) {
         this.refreshToken = null;
+        // Armazena o user localmente para acesso rápido via getSession
+        this.currentUser = null;
         this.client = client;
         this.http = http;
     }
-    /**
-     * Login com email e senha
-     */
+    // =================================================================
+    // MÉTODOS ORIGINAIS (MANTIDOS)
+    // =================================================================
     async login(email, password) {
         try {
             const { data } = await this.http.post("/auth/login", {
@@ -16,30 +18,31 @@ export class AuthModule {
             if (data.accessToken) {
                 this.client.setToken(data.accessToken);
                 this.refreshToken = data.refreshToken;
+                this.currentUser = data.user;
             }
             return data;
         }
         catch (e) {
             this.client.setToken(null);
             this.refreshToken = null;
+            this.currentUser = null;
             throw e;
         }
     }
-    /**
-     * Registrar novo usuário
-     */
     async register(credentials) {
         try {
             const { data } = await this.http.post("/auth/register", credentials);
+            // Se o register já retornar token, configura:
+            if (data.accessToken) {
+                this.client.setToken(data.accessToken);
+                this.currentUser = data.user;
+            }
             return data;
         }
         catch (e) {
             throw e;
         }
     }
-    /**
-     * Renovar access token usando refresh token
-     */
     async refresh() {
         if (!this.refreshToken) {
             throw new Error("Nenhum refresh token disponível");
@@ -59,15 +62,9 @@ export class AuthModule {
             throw e;
         }
     }
-    /**
-     * Obter URL de autenticação do Google
-     */
     getGoogleAuthUrl() {
         return `${this.client.apiUrl}/v1/auth/google`;
     }
-    /**
-     * Logout da sessão atual
-     */
     async logout() {
         if (this.refreshToken) {
             try {
@@ -81,10 +78,8 @@ export class AuthModule {
         }
         this.client.setToken(null);
         this.refreshToken = null;
+        this.currentUser = null;
     }
-    /**
-     * Logout de todas as sessões
-     */
     async logoutAll() {
         try {
             await this.http.post("/auth/logout-all");
@@ -92,25 +87,17 @@ export class AuthModule {
         finally {
             this.client.setToken(null);
             this.refreshToken = null;
+            this.currentUser = null;
         }
     }
-    /**
-     * Listar sessões ativas
-     */
     async getSessions() {
         const { data } = await this.http.get("/auth/sessions");
         return data.sessions;
     }
-    /**
-     * Esqueci minha senha
-     */
     async forgotPassword(email) {
         const { data } = await this.http.post("/auth/forgot-password", { email });
         return data;
     }
-    /**
-     * Redefinir senha
-     */
     async resetPassword(token, newPassword) {
         const { data } = await this.http.post("/auth/reset-password", {
             token,
@@ -118,16 +105,66 @@ export class AuthModule {
         });
         return data;
     }
-    /**
-     * Obter refresh token atual (para armazenamento)
-     */
     getRefreshToken() {
         return this.refreshToken;
     }
-    /**
-     * Definir refresh token (para restaurar sessão)
-     */
     setRefreshToken(token) {
         this.refreshToken = token;
     }
+    // =================================================================
+    // NOVOS MÉTODOS (COMPATIBILIDADE COM SHOWCASE / SUPABASE STYLE)
+    // =================================================================
+    /**
+     * Alias para login, retornando { user, error } padrão do Showcase
+     */
+    async signInWithPassword(credentials) {
+        try {
+            const data = await this.login(credentials.email, credentials.password);
+            return { user: data.user, error: null };
+        }
+        catch (err) {
+            return { user: null, error: err.response?.data?.message || err.message };
+        }
+    }
+    /**
+     * Alias para register, retornando { user, error }
+     */
+    async signUp(credentials) {
+        try {
+            const data = await this.register({
+                email: credentials.email,
+                password: credentials.password,
+                name: credentials.data?.name || credentials.email.split('@')[0],
+            });
+            return { user: data.user, error: null };
+        }
+        catch (err) {
+            return { user: null, error: err.response?.data?.message || err.message };
+        }
+    }
+    /**
+     * Alias para logout
+     */
+    async signOut() {
+        await this.logout();
+        return { error: null };
+    }
+    /**
+     * Recupera a sessão atual (User + Token).
+     * Se não tiver logado, retorna null ou tenta validar o token.
+     */
+    async getSession() {
+        const token = this.client.getToken();
+        if (!token)
+            return null;
+        // Se já temos o user em memória, retorna.
+        // O ideal seria validar o token no backend (/auth/me), mas vamos simplificar.
+        if (this.currentUser) {
+            return {
+                user: this.currentUser,
+                access_token: token
+            };
+        }
+        return null;
+    }
 }

package/dist/index.d.ts

@@ -8,36 +8,27 @@ import { PushModule } from "./push.js";
  * Configuração usada para criar o cliente principal da plataforma.
  */
 export type ClientConfig = {
-    apiUrl: string;
-    projectId: string;
+    apiUrl?: string;
+    baseUrl?: string;
+    projectId?: string;
+    apiKey?: string;
 };
-/**
- * O cliente principal da Plataforma API (Aether).
- * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions, Push).
- */
 export declare class PlataformaClient {
     auth: AuthModule;
     db: DatabaseModule;
     storage: StorageModule;
     functions: FunctionsModule;
     push: PushModule;
+    database: DatabaseModule;
     apiUrl: string;
     projectId: string;
     http: AxiosInstance;
     private _token;
     constructor(config: ClientConfig);
-    /**
-     * Armazena o token de autenticação em memória.
-     * Chamado automaticamente pelo AuthModule após login/registro.
-     */
     setToken(token: string | null): void;
-    /**
-     * Recupera o token de autenticação atual.
-     * Usado pelo http-client para injetar o header Authorization.
-     */
     getToken(): string | null;
 }
 export { AetherError } from "./errors.js";
-export type { LoginResponse, Session } from "./auth.js";
+export type { LoginResponse, Session, User } from "./auth.js";
 export type { ListOptions } from "./database.js";
 export type { PushPlatform, PushEnvironment, PushDevice, RegisterDeviceParams, SendPushResponse, PushStatus, PushLogEntry, ListPushLogsOptions, PushStats, } from "./push.js";

package/dist/index.js

@@ -1,47 +1,36 @@
 import { createHttpClient } from "./http-client.js";
-import { AuthModule } from "./auth.js";
+import { AuthModule } from "./auth.js"; // Importando User
 import { DatabaseModule } from "./database.js";
 import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
 import { PushModule } from "./push.js";
-/**
- * O cliente principal da Plataforma API (Aether).
- * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions, Push).
- */
 export class PlataformaClient {
     constructor(config) {
         this._token = null;
-        if (!config.apiUrl || !config.projectId) {
-            throw new Error("apiUrl e projectId são obrigatórios.");
+        // Resolve URL (prioridade para baseUrl se existir, senão apiUrl)
+        const url = config.baseUrl || config.apiUrl;
+        const project = config.apiKey || config.projectId;
+        if (!url || !project) {
+            throw new Error("baseUrl (API URL) e apiKey (Project ID) são obrigatórios.");
         }
-        // Normaliza apiUrl removendo barras finais, se houver
-        this.apiUrl = config.apiUrl.replace(/\/+$/, "");
-        this.projectId = config.projectId;
-        // Inicializa o cliente HTTP (passando a própria instância)
+        this.apiUrl = url.replace(/\/+$/, "");
+        this.projectId = project;
         this.http = createHttpClient(this);
-        // Inicializa os módulos de alto nível
+        // Inicializa módulos
         this.auth = new AuthModule(this, this.http);
         this.db = new DatabaseModule(this, this.http);
         this.storage = new StorageModule(this, this.http);
         this.functions = new FunctionsModule(this, this.http);
         this.push = new PushModule(this, this.http);
+        // Cria o alias que o Showcase App espera
+        this.database = this.db;
     }
-    // --- Gerenciamento de Token ---
-    /**
-     * Armazena o token de autenticação em memória.
-     * Chamado automaticamente pelo AuthModule após login/registro.
-     */
     setToken(token) {
         this._token = token;
     }
-    /**
-     * Recupera o token de autenticação atual.
-     * Usado pelo http-client para injetar o header Authorization.
-     */
     getToken() {
         return this._token;
     }
 }
-// Re-exports convenientes para quem consome o SDK
-// ===== ERRORS =====
+// ===== EXPORTS =====
 export { AetherError } from "./errors.js";

package/dist/storage.d.ts

@@ -4,25 +4,36 @@ export declare class StorageModule {
     private client;
     private http;
     constructor(client: PlataformaClient, http: AxiosInstance);
+    /**
+     * Seleciona um Bucket para operar.
+     * Ex: storage.from('avatars').upload(...)
+     */
+    from(bucketId: string): {
+        upload: (path: string, file: File | Blob | Buffer) => Promise<{
+            data: {
+                id: any;
+                key: any;
+                path: any;
+                downloadUrl: any;
+                url: any;
+            };
+            error: null;
+        }>;
+        list: () => Promise<any>;
+    };
     /**
      * Faz o upload de um arquivo.
-     * @param file Arquivo (Browser: File, Node: Buffer)
-     * @param fileName Nome do arquivo (ex: 'foto.jpg')
-     * @param contentType MIME Type (ex: 'image/jpeg')
-     * @param folder (Opcional) Pasta de destino (ex: 'usuarios/123/')
      */
     upload(file: File | Buffer | Blob, fileName: string, contentType: string, folder?: string): Promise<{
-        id: any;
-        key: any;
-        downloadUrl: any;
-        url: any;
+        data: {
+            id: any;
+            key: any;
+            path: any;
+            downloadUrl: any;
+            url: any;
+        };
+        error: null;
     }>;
-    /**
-     * Lista arquivos de uma pasta.
-     */
     list(folder?: string): Promise<any>;
-    /**
-     * Deleta um arquivo pelo ID.
-     */
     delete(fileId: string): Promise<boolean>;
 }

package/dist/storage.js

@@ -4,15 +4,40 @@ export class StorageModule {
         this.client = client;
         this.http = http;
     }
+    // =================================================================
+    // COMPATIBILIDADE: MÈTODO .from() (Estilo Supabase/Drizzle)
+    // =================================================================
+    /**
+     * Seleciona um Bucket para operar.
+     * Ex: storage.from('avatars').upload(...)
+     */
+    from(bucketId) {
+        return {
+            upload: async (path, file) => {
+                // Tenta inferir o contentType se for File/Blob
+                let contentType = "application/octet-stream";
+                if (typeof File !== "undefined" && file instanceof File) {
+                    contentType = file.type;
+                }
+                else if (typeof Blob !== "undefined" && file instanceof Blob) {
+                    contentType = file.type;
+                }
+                // Chama o método upload original passando o bucket como folder/prefix
+                // O path vira o nome do arquivo final
+                return this.upload(file, path, contentType, bucketId);
+            },
+            list: async () => {
+                return this.list(bucketId);
+            }
+        };
+    }
+    // =================================================================
+    // MÉTODOS ORIGINAIS
+    // =================================================================
     /**
      * Faz o upload de um arquivo.
-     * @param file Arquivo (Browser: File, Node: Buffer)
-     * @param fileName Nome do arquivo (ex: 'foto.jpg')
-     * @param contentType MIME Type (ex: 'image/jpeg')
-     * @param folder (Opcional) Pasta de destino (ex: 'usuarios/123/')
      */
-    async upload(file, fileName, contentType, folder // [NOVO]
-    ) {
+    async upload(file, fileName, contentType, folder) {
         // Calcula tamanho de forma segura para Browser e Node
         let size = 0;
         if (typeof File !== "undefined" && file instanceof File) {
@@ -22,7 +47,6 @@ export class StorageModule {
             size = file.size;
         }
         else if (file instanceof Buffer) {
-            // Node.js
             size = file.length;
         }
         // 1. Pedir URL assinada
@@ -30,34 +54,32 @@ export class StorageModule {
             fileName,
             contentType,
             size,
-            prefix: folder || "", // [NOVO] Envia o prefixo para o backend
+            prefix: folder || "",
         });
         const presign = presignData.data;
         if (!presign?.url)
             throw new Error("Falha ao obter URL de upload.");
-        // 2. Upload direto para S3
+        // 2. Upload direto para S3 (PUT na URL assinada)
         await axios.put(presign.url, file, {
             headers: { "Content-Type": contentType },
         });
         return {
-            id: presign.objectId,
-            key: presign.key,
-            downloadUrl: presign.downloadUrl,
-            url: presign.downloadUrl, // Alias amigável
+            data: {
+                id: presign.objectId,
+                key: presign.key,
+                path: presign.key, // Alias para facilitar o frontend
+                downloadUrl: presign.downloadUrl,
+                url: presign.downloadUrl,
+            },
+            error: null
         };
     }
-    /**
-     * Lista arquivos de uma pasta.
-     */
     async list(folder = "") {
         const { data } = await this.http.get("/storage/list", {
             params: { projectId: this.client.projectId, prefix: folder },
         });
-        return data.data; // Retorna { files: [], folders: [] }
+        return data.data;
     }
-    /**
-     * Deleta um arquivo pelo ID.
-     */
     async delete(fileId) {
         await this.http.delete("/storage/delete", { data: { objectId: fileId } });
         return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allanfsouza/aether-sdk",
-  "version": "2.4.2",
+  "version": "2.4.3",
   "description": "SDK do Cliente para a Plataforma Aether",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,4 +32,4 @@
     "@types/ws": "^8.5.10",
     "typescript": "^5.3.0"
   }
-}
+}

package/src/auth.ts

@@ -2,19 +2,22 @@
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
 
+// Exportando a interface User para o App usar
+export interface User {
+  id: string;
+  name: string;
+  email: string;
+  avatarUrl?: string;
+  role?: string;
+  aetherRole?: string;
+  planCode?: string;
+  emailVerified?: boolean;
+}
+
 export interface LoginResponse {
   accessToken: string;
   refreshToken: string;
-  user: {
-    id: string;
-    name: string;
-    email: string;
-    avatarUrl?: string;
-    role?: string;
-    aetherRole?: string;
-    planCode?: string;
-    emailVerified?: boolean;
-  };
+  user: User;
 }
 
 export interface Session {
@@ -29,15 +32,18 @@ export class AuthModule {
   private client: PlataformaClient;
   private http: AxiosInstance;
   private refreshToken: string | null = null;
+  // Armazena o user localmente para acesso rápido via getSession
+  private currentUser: User | null = null;
 
   constructor(client: PlataformaClient, http: AxiosInstance) {
     this.client = client;
     this.http = http;
   }
 
-  /**
-   * Login com email e senha
-   */
+  // =================================================================
+  // MÉTODOS ORIGINAIS (MANTIDOS)
+  // =================================================================
+
   async login(email: string, password: string): Promise<LoginResponse> {
     try {
       const { data } = await this.http.post<LoginResponse>("/auth/login", {
@@ -48,19 +54,18 @@ export class AuthModule {
       if (data.accessToken) {
         this.client.setToken(data.accessToken);
         this.refreshToken = data.refreshToken;
+        this.currentUser = data.user;
       }
 
       return data;
     } catch (e) {
       this.client.setToken(null);
       this.refreshToken = null;
+      this.currentUser = null;
       throw e;
     }
   }
 
-  /**
-   * Registrar novo usuário
-   */
   async register(credentials: {
     name: string;
     email: string;
@@ -68,15 +73,17 @@ export class AuthModule {
   }) {
     try {
       const { data } = await this.http.post("/auth/register", credentials);
+      // Se o register já retornar token, configura:
+      if (data.accessToken) {
+        this.client.setToken(data.accessToken);
+        this.currentUser = data.user;
+      }
       return data;
     } catch (e) {
       throw e;
     }
   }
 
-  /**
-   * Renovar access token usando refresh token
-   */
   async refresh(): Promise<{ accessToken: string }> {
     if (!this.refreshToken) {
       throw new Error("Nenhum refresh token disponível");
@@ -99,16 +106,10 @@ export class AuthModule {
     }
   }
 
-  /**
-   * Obter URL de autenticação do Google
-   */
   getGoogleAuthUrl(): string {
     return `${this.client.apiUrl}/v1/auth/google`;
   }
 
-  /**
-   * Logout da sessão atual
-   */
   async logout(): Promise<void> {
     if (this.refreshToken) {
       try {
@@ -119,26 +120,21 @@ export class AuthModule {
         // Ignora erro de logout
       }
     }
-
     this.client.setToken(null);
     this.refreshToken = null;
+    this.currentUser = null;
   }
 
-  /**
-   * Logout de todas as sessões
-   */
   async logoutAll(): Promise<void> {
     try {
       await this.http.post("/auth/logout-all");
     } finally {
       this.client.setToken(null);
       this.refreshToken = null;
+      this.currentUser = null;
     }
   }
 
-  /**
-   * Listar sessões ativas
-   */
   async getSessions(): Promise<Session[]> {
     const { data } = await this.http.get<{ sessions: Session[] }>(
       "/auth/sessions"
@@ -146,17 +142,11 @@ export class AuthModule {
     return data.sessions;
   }
 
-  /**
-   * Esqueci minha senha
-   */
   async forgotPassword(email: string) {
     const { data } = await this.http.post("/auth/forgot-password", { email });
     return data;
   }
 
-  /**
-   * Redefinir senha
-   */
   async resetPassword(token: string, newPassword: string) {
     const { data } = await this.http.post("/auth/reset-password", {
       token,
@@ -165,17 +155,71 @@ export class AuthModule {
     return data;
   }
 
-  /**
-   * Obter refresh token atual (para armazenamento)
-   */
   getRefreshToken(): string | null {
     return this.refreshToken;
   }
 
-  /**
-   * Definir refresh token (para restaurar sessão)
-   */
   setRefreshToken(token: string | null) {
     this.refreshToken = token;
   }
+
+  // =================================================================
+  // NOVOS MÉTODOS (COMPATIBILIDADE COM SHOWCASE / SUPABASE STYLE)
+  // =================================================================
+
+  /**
+   * Alias para login, retornando { user, error } padrão do Showcase
+   */
+  async signInWithPassword(credentials: { email: string; password: string }) {
+    try {
+      const data = await this.login(credentials.email, credentials.password);
+      return { user: data.user, error: null };
+    } catch (err: any) {
+      return { user: null, error: err.response?.data?.message || err.message };
+    }
+  }
+
+  /**
+   * Alias para register, retornando { user, error }
+   */
+  async signUp(credentials: { email: string; password: string; data?: { name: string } }) {
+    try {
+      const data = await this.register({
+        email: credentials.email,
+        password: credentials.password,
+        name: credentials.data?.name || credentials.email.split('@')[0],
+      });
+      return { user: data.user, error: null };
+    } catch (err: any) {
+      return { user: null, error: err.response?.data?.message || err.message };
+    }
+  }
+
+  /**
+   * Alias para logout
+   */
+  async signOut() {
+    await this.logout();
+    return { error: null };
+  }
+
+  /**
+   * Recupera a sessão atual (User + Token).
+   * Se não tiver logado, retorna null ou tenta validar o token.
+   */
+  async getSession() {
+    const token = this.client.getToken();
+    if (!token) return null;
+
+    // Se já temos o user em memória, retorna.
+    // O ideal seria validar o token no backend (/auth/me), mas vamos simplificar.
+    if (this.currentUser) {
+      return {
+        user: this.currentUser,
+        access_token: token
+      };
+    }
+
+    return null;
+  }
 }

package/src/index.ts

@@ -1,7 +1,7 @@
 // src/index.ts
 import type { AxiosInstance } from "axios";
 import { createHttpClient } from "./http-client.js";
-import { AuthModule } from "./auth.js";
+import { AuthModule, User } from "./auth.js"; // Importando User
 import { DatabaseModule } from "./database.js";
 import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
@@ -11,89 +11,70 @@ import { PushModule } from "./push.js";
  * Configuração usada para criar o cliente principal da plataforma.
  */
 export type ClientConfig = {
-  apiUrl: string;
-  projectId: string;
+  // Suporte duplo para compatibilidade:
+  // apiUrl (nome original) OU baseUrl (nome novo do App)
+  apiUrl?: string;
+  baseUrl?: string;
+
+  // projectId (nome original) OU apiKey (nome novo do App)
+  projectId?: string;
+  apiKey?: string;
 };
 
-/**
- * O cliente principal da Plataforma API (Aether).
- * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions, Push).
- */
 export class PlataformaClient {
-  // Módulos públicos disponíveis para o usuário do SDK
   public auth: AuthModule;
   public db: DatabaseModule;
   public storage: StorageModule;
   public functions: FunctionsModule;
   public push: PushModule;
 
-  // Configurações imutáveis da instância
+  // Alias para 'db' que o showcase tenta usar como 'database'
+  public database: DatabaseModule;
+
   public apiUrl: string;
   public projectId: string;
 
-  // Infra interna
   public http: AxiosInstance;
   private _token: string | null = null;
 
   constructor(config: ClientConfig) {
-    if (!config.apiUrl || !config.projectId) {
-      throw new Error("apiUrl e projectId são obrigatórios.");
+    // Resolve URL (prioridade para baseUrl se existir, senão apiUrl)
+    const url = config.baseUrl || config.apiUrl;
+    const project = config.apiKey || config.projectId;
+
+    if (!url || !project) {
+      throw new Error("baseUrl (API URL) e apiKey (Project ID) são obrigatórios.");
     }
 
-    // Normaliza apiUrl removendo barras finais, se houver
-    this.apiUrl = config.apiUrl.replace(/\/+$/, "");
-    this.projectId = config.projectId;
+    this.apiUrl = url.replace(/\/+$/, "");
+    this.projectId = project;
 
-    // Inicializa o cliente HTTP (passando a própria instância)
     this.http = createHttpClient(this);
 
-    // Inicializa os módulos de alto nível
+    // Inicializa módulos
     this.auth = new AuthModule(this, this.http);
     this.db = new DatabaseModule(this, this.http);
     this.storage = new StorageModule(this, this.http);
     this.functions = new FunctionsModule(this, this.http);
     this.push = new PushModule(this, this.http);
-  }
 
-  // --- Gerenciamento de Token ---
+    // Cria o alias que o Showcase App espera
+    this.database = this.db;
+  }
 
-  /**
-   * Armazena o token de autenticação em memória.
-   * Chamado automaticamente pelo AuthModule após login/registro.
-   */
   setToken(token: string | null) {
     this._token = token;
   }
 
-  /**
-   * Recupera o token de autenticação atual.
-   * Usado pelo http-client para injetar o header Authorization.
-   */
   getToken(): string | null {
     return this._token;
   }
 }
 
-// Re-exports convenientes para quem consome o SDK
-
-// ===== ERRORS =====
+// ===== EXPORTS =====
 export { AetherError } from "./errors.js";
-
-// ===== AUTH =====
-export type { LoginResponse, Session } from "./auth.js";
-
-// ===== DATABASE =====
+export type { LoginResponse, Session, User } from "./auth.js"; // User exportado!
 export type { ListOptions } from "./database.js";
-
-// ===== STORAGE =====
-// Nota: storage.ts não declara tipos específicos além dos retornos inline
-// Se necessário, tipos podem ser adicionados em storage.ts e re-exportados aqui
-
-// ===== FUNCTIONS =====
-// Nota: functions.ts usa genéricos inline
-// Se necessário, tipos podem ser adicionados em functions.ts e re-exportados aqui
-
-// ===== PUSH =====
 export type {
   PushPlatform,
   PushEnvironment,
@@ -104,4 +85,4 @@ export type {
   PushLogEntry,
   ListPushLogsOptions,
   PushStats,
-} from "./push.js";
+} from "./push.js";

package/src/storage.ts

@@ -12,18 +12,48 @@ export class StorageModule {
     this.http = http;
   }
 
+  // =================================================================
+  // COMPATIBILIDADE: MÈTODO .from() (Estilo Supabase/Drizzle)
+  // =================================================================
+
+  /**
+   * Seleciona um Bucket para operar.
+   * Ex: storage.from('avatars').upload(...)
+   */
+  from(bucketId: string) {
+    return {
+      upload: async (path: string, file: File | Blob | Buffer) => {
+        // Tenta inferir o contentType se for File/Blob
+        let contentType = "application/octet-stream";
+        if (typeof File !== "undefined" && file instanceof File) {
+          contentType = file.type;
+        } else if (typeof Blob !== "undefined" && file instanceof Blob) {
+          contentType = file.type;
+        }
+
+        // Chama o método upload original passando o bucket como folder/prefix
+        // O path vira o nome do arquivo final
+        return this.upload(file, path, contentType, bucketId);
+      },
+
+      list: async () => {
+        return this.list(bucketId);
+      }
+    };
+  }
+
+  // =================================================================
+  // MÉTODOS ORIGINAIS
+  // =================================================================
+
   /**
    * Faz o upload de um arquivo.
-   * @param file Arquivo (Browser: File, Node: Buffer)
-   * @param fileName Nome do arquivo (ex: 'foto.jpg')
-   * @param contentType MIME Type (ex: 'image/jpeg')
-   * @param folder (Opcional) Pasta de destino (ex: 'usuarios/123/')
    */
   async upload(
     file: File | Buffer | Blob,
     fileName: string,
     contentType: string,
-    folder?: string // [NOVO]
+    folder?: string
   ) {
     // Calcula tamanho de forma segura para Browser e Node
     let size = 0;
@@ -32,7 +62,6 @@ export class StorageModule {
     } else if (typeof Blob !== "undefined" && file instanceof Blob) {
       size = file.size;
     } else if (file instanceof Buffer) {
-      // Node.js
       size = file.length;
     }
 
@@ -41,40 +70,38 @@ export class StorageModule {
       fileName,
       contentType,
       size,
-      prefix: folder || "", // [NOVO] Envia o prefixo para o backend
+      prefix: folder || "",
     });
 
     const presign = presignData.data;
     if (!presign?.url) throw new Error("Falha ao obter URL de upload.");
 
-    // 2. Upload direto para S3
+    // 2. Upload direto para S3 (PUT na URL assinada)
     await axios.put(presign.url, file, {
       headers: { "Content-Type": contentType },
     });
 
     return {
-      id: presign.objectId,
-      key: presign.key,
-      downloadUrl: presign.downloadUrl,
-      url: presign.downloadUrl, // Alias amigável
+      data: {
+        id: presign.objectId,
+        key: presign.key,
+        path: presign.key, // Alias para facilitar o frontend
+        downloadUrl: presign.downloadUrl,
+        url: presign.downloadUrl,
+      },
+      error: null
     };
   }
 
-  /**
-   * Lista arquivos de uma pasta.
-   */
   async list(folder = "") {
     const { data } = await this.http.get("/storage/list", {
       params: { projectId: this.client.projectId, prefix: folder },
     });
-    return data.data; // Retorna { files: [], folders: [] }
+    return data.data;
   }
 
-  /**
-   * Deleta um arquivo pelo ID.
-   */
   async delete(fileId: string) {
     await this.http.delete("/storage/delete", { data: { objectId: fileId } });
     return true;
   }
-}
+}