@allanfsouza/aether-sdk 1.0.0 → 2.1.0

package/src/index.ts

@@ -4,27 +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";
 
-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.
- * Ponto de entrada para todos os módulos (Auth, DB, Storage).
+ * 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;
 
-  // 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;
 
@@ -32,23 +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
+
+    // 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)
+    // Inicializa o cliente HTTP (passando a própria instância)
     this.http = createHttpClient(this);
 
-    // Inicializa os módulos
+    // 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);
   }
 
   // --- Gerenciamento de Token ---
 
   /**
    * Armazena o token de autenticação em memória.
-   * @param token O JWT (ou null para logout)
+   * Chamado automaticamente pelo AuthModule após login/registro.
    */
   setToken(token: string | null) {
     this._token = token;
@@ -56,9 +64,14 @@ export class PlataformaClient {
 
   /**
    * Recupera o token de autenticação atual.
-   * @returns O JWT ou null
+   * Usado pelo http-client para injetar o header Authorization.
    */
   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/src/storage.ts

@@ -1,12 +1,8 @@
 // src/storage.ts
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
-import axios from "axios"; // [A CORREÇÃO ESTÁ AQUI]
+import axios from "axios";
 
-/**
- * Módulo de Storage
- * Lida com upload e download de arquivos.
- */
 export class StorageModule {
   private client: PlataformaClient;
   private http: AxiosInstance;
@@ -17,36 +13,68 @@ export class StorageModule {
   }
 
   /**
-   * Faz o upload de um arquivo para o Storage do projeto.
-   * Isso lida com o fluxo de "presign" (URL assinada) automaticamente.
-   * @param file O objeto 'File' (do navegador) ou um Buffer (do Node.js)
-   * @param fileName O nome do arquivo (ex: "imagem.png")
-   * @param contentType O tipo (ex: "image/png")
-   * @returns O objeto do arquivo criado no banco
+   * 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, fileName: string, contentType: string) {
-    const size = (file as File).size || (file as Buffer).length;
+  async upload(
+    file: File | Buffer | Blob,
+    fileName: string,
+    contentType: string,
+    folder?: string // [NOVO]
+  ) {
+    // Calcula tamanho de forma segura para Browser e Node
+    let size = 0;
+    if (typeof File !== "undefined" && file instanceof File) {
+      size = file.size;
+    } else if (typeof Blob !== "undefined" && file instanceof Blob) {
+      size = file.size;
+    } else if (file instanceof Buffer) {
+      // Node.js
+      size = file.length;
+    }
 
-    // 1. Pedir a URL de upload para nossa API
+    // 1. Pedir URL assinada
     const { data: presignData } = await this.http.post("/storage/presign", {
-      fileName: fileName,
-      contentType: contentType,
-      size: size,
+      fileName,
+      contentType,
+      size,
+      prefix: folder || "", // [NOVO] Envia o prefixo para o backend
     });
 
-    // O 'presign' vem dentro de 'data'
     const presign = presignData.data;
-    if (!presign?.url) {
-      throw new Error("API não retornou uma URL de upload assinada.");
-    }
+    if (!presign?.url) throw new Error("Falha ao obter URL de upload.");
 
-    // 2. Enviar o arquivo diretamente para o Minio/S3 (sem auth)
-    //    Usamos o 'axios' global aqui, não o 'this.http' (que adicionaria auth)
+    // 2. Upload direto para S3
     await axios.put(presign.url, file, {
       headers: { "Content-Type": contentType },
     });
 
-    // 3. Retorna os detalhes do objeto (downloadUrl, objectId, etc.)
-    return presign;
+    return {
+      id: presign.objectId,
+      key: presign.key,
+      downloadUrl: presign.downloadUrl,
+      url: presign.downloadUrl, // Alias amigável
+    };
+  }
+
+  /**
+   * 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: [] }
+  }
+
+  /**
+   * Deleta um arquivo pelo ID.
+   */
+  async delete(fileId: string) {
+    await this.http.delete("/storage/delete", { data: { objectId: fileId } });
+    return true;
   }
 }

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"
+  ]
+}