@allanfsouza/aether-sdk 2.0.0 → 2.1.0

package/dist/auth.d.ts

@@ -1,45 +1,16 @@
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
-/**
- * Módulo de Autenticação
- * Lida com login, registro, gerenciamento de token e recuperação de senha.
- */
 export declare class AuthModule {
     private client;
     private http;
     constructor(client: PlataformaClient, http: AxiosInstance);
-    /**
-     * Autentica um usuário e armazena o token no SDK.
-     * @param email O e-mail do usuário
-     * @param password A senha do usuário
-     * @returns O objeto do usuário e o token
-     */
     login(email: string, password: string): Promise<any>;
-    /**
-     * Registra um novo usuário e já realiza o login automaticamente.
-     * @param credentials Nome, email e senha
-     * @returns O objeto do usuário e o token
-     */
     register(credentials: {
         name: string;
         email: string;
         password: string;
     }): Promise<any>;
-    /**
-     * Solicita um e-mail de recuperação de senha.
-     * @param email O e-mail da conta
-     * @returns A resposta da API (mensagem de sucesso)
-     */
     forgotPassword(email: string): Promise<any>;
-    /**
-     * Redefine a senha usando o token recebido por e-mail.
-     * @param token O código/token recebido
-     * @param newPassword A nova senha desejada
-     * @returns A resposta da API (mensagem de sucesso)
-     */
     resetPassword(token: string, newPassword: string): Promise<any>;
-    /**
-     * Desconecta o usuário limpando o token da memória do SDK.
-     */
     logout(): void;
 }

package/dist/auth.js

@@ -1,39 +1,24 @@
-/**
- * Módulo de Autenticação
- * Lida com login, registro, gerenciamento de token e recuperação de senha.
- */
 export class AuthModule {
     constructor(client, http) {
         this.client = client;
         this.http = http;
     }
-    /**
-     * Autentica um usuário e armazena o token no SDK.
-     * @param email O e-mail do usuário
-     * @param password A senha do usuário
-     * @returns O objeto do usuário e o token
-     */
     async login(email, password) {
         try {
             const { data } = await this.http.post("/auth/login", { email, password });
-            // Salva o token DENTRO da instância do SDK para uso futuro
-            this.client.setToken(data.token);
-            return data; // Retorna { token, user: { ... } }
+            if (data.token) {
+                this.client.setToken(data.token);
+            }
+            return data;
         }
         catch (e) {
-            this.client.setToken(null); // Limpa o token em caso de falha
+            this.client.setToken(null);
             throw e;
         }
     }
-    /**
-     * Registra um novo usuário e já realiza o login automaticamente.
-     * @param credentials Nome, email e senha
-     * @returns O objeto do usuário e o token
-     */
     async register(credentials) {
         try {
             const { data } = await this.http.post("/auth/register", credentials);
-            // Se o backend retornar o token no registro, já salvamos
             if (data.token) {
                 this.client.setToken(data.token);
             }
@@ -44,31 +29,14 @@ export class AuthModule {
             throw e;
         }
     }
-    /**
-     * Solicita um e-mail de recuperação de senha.
-     * @param email O e-mail da conta
-     * @returns A resposta da API (mensagem de sucesso)
-     */
     async forgotPassword(email) {
         const { data } = await this.http.post("/auth/forgot-password", { email });
         return data;
     }
-    /**
-     * Redefine a senha usando o token recebido por e-mail.
-     * @param token O código/token recebido
-     * @param newPassword A nova senha desejada
-     * @returns A resposta da API (mensagem de sucesso)
-     */
     async resetPassword(token, newPassword) {
-        const { data } = await this.http.post("/auth/reset-password", {
-            token,
-            newPassword,
-        });
+        const { data } = await this.http.post("/auth/reset-password", { token, newPassword });
         return data;
     }
-    /**
-     * Desconecta o usuário limpando o token da memória do SDK.
-     */
     logout() {
         this.client.setToken(null);
     }

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+export declare class AetherError extends Error {
+    code: string;
+    message: string;
+    status?: number | undefined;
+    details?: any | undefined;
+    constructor(code: string, message: string, status?: number | undefined, details?: any | undefined);
+}
+/**
+ * Converte qualquer erro vindo do Axios em um AetherError padronizado.
+ * Essa função é pensada para ser usada no interceptor de responses.
+ */
+export declare function handleAxiosError(error: any): never;

package/dist/errors.js

@@ -0,0 +1,42 @@
+// src/errors.ts
+export class AetherError extends Error {
+    constructor(code, message, status, details) {
+        super(message);
+        this.code = code;
+        this.message = message;
+        this.status = status;
+        this.details = details;
+        this.name = "AetherError";
+        // Garante que instanceof AetherError funcione mesmo em cenários com transpile/bundler
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Converte qualquer erro vindo do Axios em um AetherError padronizado.
+ * Essa função é pensada para ser usada no interceptor de responses.
+ */
+export function handleAxiosError(error) {
+    // Erro com resposta do servidor (4xx, 5xx)
+    if (error && error.response) {
+        const data = error.response.data;
+        const message = data?.error || data?.message || "Erro desconhecido na API";
+        const status = error.response.status;
+        let code = "api_error";
+        if (status === 401)
+            code = "unauthorized";
+        if (status === 403)
+            code = "permission_denied";
+        if (status === 404)
+            code = "not_found";
+        if (status === 429)
+            code = "rate_limit_exceeded";
+        throw new AetherError(code, message, status, data);
+    }
+    // Erro de rede (sem resposta do servidor)
+    if (error && error.request && !error.response) {
+        throw new AetherError("network_error", "Não foi possível conectar ao servidor Aether.", 0);
+    }
+    // Erro de configuração / código do cliente
+    const fallbackMessage = (error && error.message) || "Erro interno no cliente SDK.";
+    throw new AetherError("client_error", fallbackMessage);
+}

package/dist/functions.d.ts

@@ -4,11 +4,5 @@ export declare class FunctionsModule {
     private client;
     private http;
     constructor(client: PlataformaClient, http: AxiosInstance);
-    /**
-     * Chama uma função HTTP Serverless.
-     * @param functionName O nome da função (ou rota, ex: 'pedidos/123')
-     * @param body (Opcional) Dados para enviar no corpo (POST)
-     * @param method (Opcional) Método HTTP (padrão POST se tiver body, GET se não)
-     */
     invoke<T = any>(functionName: string, body?: any, method?: "GET" | "POST" | "PUT" | "DELETE"): Promise<T>;
 }

package/dist/functions.js

@@ -3,17 +3,9 @@ export class FunctionsModule {
         this.client = client;
         this.http = http;
     }
-    /**
-     * Chama uma função HTTP Serverless.
-     * @param functionName O nome da função (ou rota, ex: 'pedidos/123')
-     * @param body (Opcional) Dados para enviar no corpo (POST)
-     * @param method (Opcional) Método HTTP (padrão POST se tiver body, GET se não)
-     */
     async invoke(functionName, body, method) {
         const projectId = this.client.projectId;
-        // Remove barras iniciais para evitar URL malformada
         const cleanName = functionName.replace(/^\//, "");
-        // Define método automaticamente se não informado
         const finalMethod = method || (body ? "POST" : "GET");
         const response = await this.http.request({
             url: `/functions/http/${projectId}/${cleanName}`,

package/dist/http-client.d.ts

@@ -1,10 +1,8 @@
 import { type AxiosInstance } from "axios";
-import { PlataformaClient } from "./index.js";
+import type { PlataformaClient } from "./index.js";
 /**
  * Cria uma instância do Axios pré-configurada.
- * Ela usa um interceptor para adicionar dinamicamente os
- * headers 'Authorization' e 'X-Project-ID' em cada requisição.
- * * @param client A instância principal do PlataformaClient
- * @returns Uma instância configurada do Axios
+ * - Injeta automaticamente headers de Auth e Projeto.
+ * - Converte erros em AetherError.
  */
 export declare function createHttpClient(client: PlataformaClient): AxiosInstance;

package/dist/http-client.js

@@ -1,27 +1,31 @@
 // src/http-client.ts
 import axios from "axios";
+import { handleAxiosError } from "./errors.js";
 /**
  * Cria uma instância do Axios pré-configurada.
- * Ela usa um interceptor para adicionar dinamicamente os
- * headers 'Authorization' e 'X-Project-ID' em cada requisição.
- * * @param client A instância principal do PlataformaClient
- * @returns Uma instância configurada do Axios
+ * - Injeta automaticamente headers de Auth e Projeto.
+ * - Converte erros em AetherError.
  */
 export function createHttpClient(client) {
     const http = axios.create({
-        baseURL: `${client.apiUrl}/v1`, // Adiciona o /v1 automaticamente
+        // Adiciona o /v1 automaticamente em todas as chamadas do SDK
+        baseURL: `${client.apiUrl}/v1`,
+        headers: {
+            "Content-Type": "application/json",
+        },
     });
+    // Interceptor de REQUEST
     http.interceptors.request.use((config) => {
-        // 1. Pega o token atual do cliente
         const token = client.getToken();
         if (token) {
             config.headers.Authorization = `Bearer ${token}`;
         }
-        // 2. Pega o ID do projeto
         if (client.projectId) {
             config.headers["X-Project-ID"] = client.projectId;
         }
         return config;
     });
+    // Interceptor de RESPONSE
+    http.interceptors.response.use((response) => response, (error) => handleAxiosError(error));
     return http;
 }

package/dist/index.d.ts

@@ -2,12 +2,15 @@ import { AuthModule } from "./auth.js";
 import { DatabaseModule } from "./database.js";
 import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
-type ClientConfig = {
+/**
+ * Configuração usada para criar o cliente principal da plataforma.
+ */
+export type ClientConfig = {
     apiUrl: string;
     projectId: string;
 };
 /**
- * O cliente principal da Plataforma API.
+ * O cliente principal da Plataforma API (Aether).
  * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions).
  */
 export declare class PlataformaClient {
@@ -22,15 +25,14 @@ export declare class PlataformaClient {
     constructor(config: ClientConfig);
     /**
      * Armazena o token de autenticação em memória.
-     * Chamado automaticamente pelo AuthModule após login.
-     * @param token O JWT (ou null para logout)
+     * 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.
-     * @returns O JWT ou null
      */
     getToken(): string | null;
 }
-export {};
+export { AetherError } from "./errors.js";
+export type { ListOptions } from "./database.js";

package/dist/index.js

@@ -2,9 +2,9 @@ import { createHttpClient } from "./http-client.js";
 import { AuthModule } from "./auth.js";
 import { DatabaseModule } from "./database.js";
 import { StorageModule } from "./storage.js";
-import { FunctionsModule } from "./functions.js"; // [NOVO] Import do módulo
+import { FunctionsModule } from "./functions.js";
 /**
- * O cliente principal da Plataforma API.
+ * O cliente principal da Plataforma API (Aether).
  * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions).
  */
 export class PlataformaClient {
@@ -13,21 +13,21 @@ export class PlataformaClient {
         if (!config.apiUrl || !config.projectId) {
             throw new Error("apiUrl e projectId são obrigatórios.");
         }
-        this.apiUrl = config.apiUrl.replace(/\/$/, ""); // Remove barra final se houver
+        // Normaliza apiUrl removendo barra final, se houver
+        this.apiUrl = config.apiUrl.replace(/\/$/, "");
         this.projectId = config.projectId;
-        // Inicializa o cliente HTTP (passando 'this', a própria instância para injetar token/ID)
+        // Inicializa o cliente HTTP (passando a própria instância)
         this.http = createHttpClient(this);
-        // Inicializa os módulos passando a referência do cliente e do axios
+        // Inicializa os módulos de alto nível
         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); // [NOVO] Inicialização
+        this.functions = new FunctionsModule(this, this.http);
     }
     // --- Gerenciamento de Token ---
     /**
      * Armazena o token de autenticação em memória.
-     * Chamado automaticamente pelo AuthModule após login.
-     * @param token O JWT (ou null para logout)
+     * Chamado automaticamente pelo AuthModule após login/registro.
      */
     setToken(token) {
         this._token = token;
@@ -35,9 +35,10 @@ export class PlataformaClient {
     /**
      * Recupera o token de autenticação atual.
      * Usado pelo http-client para injetar o header Authorization.
-     * @returns O JWT ou null
      */
     getToken() {
         return this._token;
     }
 }
+// Re-exports convenientes para quem consome o SDK
+export { AetherError } from "./errors.js";

package/errors.ts

@@ -0,0 +1,46 @@
+// src/errors.ts
+export class AetherError extends Error {
+  constructor(
+    public code: string,
+    public message: string,
+    public status?: number,
+    public details?: any
+  ) {
+    super(message);
+    this.name = "AetherError";
+    // Garante que instanceof AetherError funcione bem em qualquer bundler (ES5/ES6)
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+
+export function handleAxiosError(error: any): never {
+  if (error?.response) {
+    // Erro vindo da API (4xx, 5xx)
+    const data = error.response.data;
+    const message =
+      data?.error || data?.message || "Erro desconhecido na API";
+    const status: number = error.response.status;
+
+    let code = "api_error";
+    if (status === 401) code = "unauthorized";
+    if (status === 403) code = "permission_denied";
+    if (status === 404) code = "not_found";
+    if (status === 409) code = "conflict";
+    if (status === 429) code = "rate_limit_exceeded";
+
+    throw new AetherError(code, message, status, data);
+  }
+
+  if (error?.request && !error.response) {
+    // Erro de rede (sem resposta, offline, timeout)
+    throw new AetherError(
+      "network_error",
+      "Não foi possível conectar ao servidor Aether. Verifique sua conexão.",
+      0
+    );
+  }
+
+  // Erro na configuração / código cliente
+  const fallbackMessage = error?.message || "Erro interno no cliente SDK.";
+  throw new AetherError("client_error", fallbackMessage);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@allanfsouza/aether-sdk",
-  "version": "2.0.0",
-  "description": "SDK do Cliente para a Plataforma API",
+  "version": "2.1.0",
+  "description": "SDK do Cliente para a Plataforma Aether",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
@@ -15,15 +15,17 @@
     "build": "npx tsc",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "keywords": [],
+  "keywords": [
+    "baas",
+    "sdk",
+    "aether"
+  ],
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "axios": "^1.13.2",
-    "ws": "^8.18.0"
+    "axios": "^1.6.0"
   },
   "devDependencies": {
-    "@types/ws": "^8.5.11",
-    "typescript": "^5.9.3"
+    "typescript": "^5.3.0"
   }
-}
+}

package/src/auth.ts

@@ -2,10 +2,6 @@
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
 
-/**
- * Módulo de Autenticação
- * Lida com login, registro, gerenciamento de token e recuperação de senha.
- */
 export class AuthModule {
   private client: PlataformaClient;
   private http: AxiosInstance;
@@ -15,75 +11,43 @@ export class AuthModule {
     this.http = http;
   }
 
-  /**
-   * Autentica um usuário e armazena o token no SDK.
-   * @param email O e-mail do usuário
-   * @param password A senha do usuário
-   * @returns O objeto do usuário e o token
-   */
   async login(email: string, password: string) {
     try {
       const { data } = await this.http.post("/auth/login", { email, password });
-      // Salva o token DENTRO da instância do SDK para uso futuro
-      this.client.setToken(data.token);
-      return data; // Retorna { token, user: { ... } }
-    } catch (e: unknown) {
-      this.client.setToken(null); // Limpa o token em caso de falha
+      if (data.token) {
+        this.client.setToken(data.token);
+      }
+      return data;
+    } catch (e) {
+      this.client.setToken(null);
       throw e;
     }
   }
 
-  /**
-   * Registra um novo usuário e já realiza o login automaticamente.
-   * @param credentials Nome, email e senha
-   * @returns O objeto do usuário e o token
-   */
-  async register(credentials: {
-    name: string;
-    email: string;
-    password: string;
-  }) {
+  async register(credentials: { name: string; email: string; password: string }) {
     try {
       const { data } = await this.http.post("/auth/register", credentials);
-      // Se o backend retornar o token no registro, já salvamos
       if (data.token) {
         this.client.setToken(data.token);
       }
       return data;
-    } catch (e: unknown) {
+    } catch (e) {
       this.client.setToken(null);
       throw e;
     }
   }
 
-  /**
-   * Solicita um e-mail de recuperação de senha.
-   * @param email O e-mail da conta
-   * @returns A resposta da API (mensagem de sucesso)
-   */
   async forgotPassword(email: string) {
     const { data } = await this.http.post("/auth/forgot-password", { email });
     return data;
   }
 
-  /**
-   * Redefine a senha usando o token recebido por e-mail.
-   * @param token O código/token recebido
-   * @param newPassword A nova senha desejada
-   * @returns A resposta da API (mensagem de sucesso)
-   */
   async resetPassword(token: string, newPassword: string) {
-    const { data } = await this.http.post("/auth/reset-password", {
-      token,
-      newPassword,
-    });
+    const { data } = await this.http.post("/auth/reset-password", { token, newPassword });
     return data;
   }
 
-  /**
-   * Desconecta o usuário limpando o token da memória do SDK.
-   */
   logout() {
     this.client.setToken(null);
   }
-}
+}

package/src/errors.ts

@@ -0,0 +1,50 @@
+// src/errors.ts
+export class AetherError extends Error {
+  constructor(
+    public code: string,
+    public message: string,
+    public status?: number,
+    public details?: any
+  ) {
+    super(message);
+    this.name = "AetherError";
+    // Garante que instanceof AetherError funcione mesmo em cenários com transpile/bundler
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+
+/**
+ * Converte qualquer erro vindo do Axios em um AetherError padronizado.
+ * Essa função é pensada para ser usada no interceptor de responses.
+ */
+export function handleAxiosError(error: any): never {
+  // Erro com resposta do servidor (4xx, 5xx)
+  if (error && error.response) {
+    const data = error.response.data;
+    const message =
+      data?.error || data?.message || "Erro desconhecido na API";
+    const status: number = error.response.status;
+
+    let code = "api_error";
+    if (status === 401) code = "unauthorized";
+    if (status === 403) code = "permission_denied";
+    if (status === 404) code = "not_found";
+    if (status === 429) code = "rate_limit_exceeded";
+
+    throw new AetherError(code, message, status, data);
+  }
+
+  // Erro de rede (sem resposta do servidor)
+  if (error && error.request && !error.response) {
+    throw new AetherError(
+      "network_error",
+      "Não foi possível conectar ao servidor Aether.",
+      0
+    );
+  }
+
+  // Erro de configuração / código do cliente
+  const fallbackMessage =
+    (error && error.message) || "Erro interno no cliente SDK.";
+  throw new AetherError("client_error", fallbackMessage);
+}

package/src/functions.ts

@@ -11,23 +11,13 @@ export class FunctionsModule {
     this.http = http;
   }
 
-  /**
-   * Chama uma função HTTP Serverless.
-   * @param functionName O nome da função (ou rota, ex: 'pedidos/123')
-   * @param body (Opcional) Dados para enviar no corpo (POST)
-   * @param method (Opcional) Método HTTP (padrão POST se tiver body, GET se não)
-   */
   async invoke<T = any>(
     functionName: string,
     body?: any,
     method?: "GET" | "POST" | "PUT" | "DELETE"
   ) {
     const projectId = this.client.projectId;
-
-    // Remove barras iniciais para evitar URL malformada
     const cleanName = functionName.replace(/^\//, "");
-
-    // Define método automaticamente se não informado
     const finalMethod = method || (body ? "POST" : "GET");
 
     const response = await this.http.request<T>({
@@ -38,4 +28,4 @@ export class FunctionsModule {
 
     return response.data;
   }
-}
+}

package/src/http-client.ts

@@ -1,27 +1,29 @@
 // src/http-client.ts
 import axios, { type AxiosInstance } from "axios";
-import { PlataformaClient } from "./index.js"; // Importa o tipo da classe principal
+import type { PlataformaClient } from "./index.js";
+import { handleAxiosError } from "./errors.js";
 
 /**
  * Cria uma instância do Axios pré-configurada.
- * Ela usa um interceptor para adicionar dinamicamente os
- * headers 'Authorization' e 'X-Project-ID' em cada requisição.
- * * @param client A instância principal do PlataformaClient
- * @returns Uma instância configurada do Axios
+ * - Injeta automaticamente headers de Auth e Projeto.
+ * - Converte erros em AetherError.
  */
 export function createHttpClient(client: PlataformaClient): AxiosInstance {
   const http = axios.create({
-    baseURL: `${client.apiUrl}/v1`, // Adiciona o /v1 automaticamente
+    // Adiciona o /v1 automaticamente em todas as chamadas do SDK
+    baseURL: `${client.apiUrl}/v1`,
+    headers: {
+      "Content-Type": "application/json",
+    },
   });
 
+  // Interceptor de REQUEST
   http.interceptors.request.use((config) => {
-    // 1. Pega o token atual do cliente
     const token = client.getToken();
     if (token) {
       config.headers.Authorization = `Bearer ${token}`;
     }
 
-    // 2. Pega o ID do projeto
     if (client.projectId) {
       config.headers["X-Project-ID"] = client.projectId;
     }
@@ -29,5 +31,11 @@ export function createHttpClient(client: PlataformaClient): AxiosInstance {
     return config;
   });
 
+  // Interceptor de RESPONSE
+  http.interceptors.response.use(
+    (response) => response,
+    (error) => handleAxiosError(error)
+  );
+
   return http;
-}
+}

package/src/index.ts

@@ -4,29 +4,32 @@ import { createHttpClient } from "./http-client.js";
 import { AuthModule } from "./auth.js";
 import { DatabaseModule } from "./database.js";
 import { StorageModule } from "./storage.js";
-import { FunctionsModule } from "./functions.js"; // [NOVO] Import do módulo
+import { FunctionsModule } from "./functions.js";
 
-type ClientConfig = {
+/**
+ * Configuração usada para criar o cliente principal da plataforma.
+ */
+export type ClientConfig = {
   apiUrl: string;
   projectId: string;
 };
 
 /**
- * O cliente principal da Plataforma API.
+ * O cliente principal da Plataforma API (Aether).
  * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions).
  */
 export class PlataformaClient {
-  // Propriedades públicas (os "módulos")
+  // Módulos públicos disponíveis para o usuário do SDK
   public auth: AuthModule;
   public db: DatabaseModule;
   public storage: StorageModule;
-  public functions: FunctionsModule; // [NOVO] Propriedade pública
+  public functions: FunctionsModule;
 
-  // Propriedades de configuração
+  // Configurações imutáveis da instância
   public apiUrl: string;
   public projectId: string;
 
-  // Propriedades internas
+  // Infra interna
   private http: AxiosInstance;
   private _token: string | null = null;
 
@@ -34,25 +37,26 @@ export class PlataformaClient {
     if (!config.apiUrl || !config.projectId) {
       throw new Error("apiUrl e projectId são obrigatórios.");
     }
-    this.apiUrl = config.apiUrl.replace(/\/$/, ""); // Remove barra final se houver
+
+    // Normaliza apiUrl removendo barra final, se houver
+    this.apiUrl = config.apiUrl.replace(/\/$/, "");
     this.projectId = config.projectId;
 
-    // Inicializa o cliente HTTP (passando 'this', a própria instância para injetar token/ID)
+    // Inicializa o cliente HTTP (passando a própria instância)
     this.http = createHttpClient(this);
 
-    // Inicializa os módulos passando a referência do cliente e do axios
+    // Inicializa os módulos de alto nível
     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); // [NOVO] Inicialização
+    this.functions = new FunctionsModule(this, this.http);
   }
 
   // --- Gerenciamento de Token ---
 
   /**
    * Armazena o token de autenticação em memória.
-   * Chamado automaticamente pelo AuthModule após login.
-   * @param token O JWT (ou null para logout)
+   * Chamado automaticamente pelo AuthModule após login/registro.
    */
   setToken(token: string | null) {
     this._token = token;
@@ -61,9 +65,13 @@ export class PlataformaClient {
   /**
    * Recupera o token de autenticação atual.
    * Usado pelo http-client para injetar o header Authorization.
-   * @returns O JWT ou null
    */
   getToken(): string | null {
     return this._token;
   }
 }
+
+// Re-exports convenientes para quem consome o SDK
+export { AetherError } from "./errors.js";
+export type { ListOptions } from "./database.js";
+

package/tsconfig.json

@@ -1,14 +1,21 @@
 {
   "compilerOptions": {
-    "target": "ES2020", // Moderno, mas compatível
-    "module": "NodeNext", // Suporta tanto 'require' (CJS) quanto 'import' (ESM)
-    "declaration": true, // [IMPORTANTE] Gera arquivos .d.ts (para autocompletar)
-    "outDir": "./dist", // Onde o JavaScript compilado irá
-    "rootDir": "./src", // Onde nosso código TypeScript está
-    "strict": true, // Força boas práticas
+    "target": "ES2020",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
-    "moduleResolution": "NodeNext"
+    // Adicionado DOM para reconhecer 'File', 'Blob' e 'WebSocket' nativos
+    "lib": [
+      "ES2020",
+      "DOM"
+    ]
   },
-  "include": ["src"] // Só compila o que está na pasta 'src'
-}
+  "include": [
+    "src"
+  ]
+}