@allanfsouza/aether-sdk 1.0.0

package/README.md

@@ -0,0 +1,9 @@
+# Plataforma SDK (Cliente JS/TS)
+
+Este é o SDK oficial para interagir com a sua "Plataforma BaaS" (clone do Firebase). Ele gerencia autenticação, banco de dados genérico (com tempo real) e storage.
+
+## Instalação
+
+```bash
+npm install @seu-username/plataforma-sdk
+```

package/dist/auth.d.ts

@@ -0,0 +1,32 @@
+import type { AxiosInstance } from "axios";
+import type { PlataformaClient } from "./index.js";
+/**
+ * Módulo de Autenticação
+ * Lida com login, registro e gerenciamento de token.
+ */
+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á o loga.
+     * @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>;
+    /**
+     * Desconecta o usuário limpando o token do SDK.
+     */
+    logout(): void;
+}

package/dist/auth.js

@@ -0,0 +1,50 @@
+/**
+ * Módulo de Autenticação
+ * Lida com login, registro e gerenciamento de token.
+ */
+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
+            this.client.setToken(data.token);
+            return data; // Retorna { user, token }
+        }
+        catch (e) {
+            this.client.setToken(null); // Limpa o token em caso de falha
+            throw e;
+        }
+    }
+    /**
+     * Registra um novo usuário e já o loga.
+     * @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);
+            this.client.setToken(data.token);
+            return data;
+        }
+        catch (e) {
+            this.client.setToken(null);
+            throw e;
+        }
+    }
+    /**
+     * Desconecta o usuário limpando o token do SDK.
+     */
+    logout() {
+        this.client.setToken(null);
+    }
+}

package/dist/database.d.ts

@@ -0,0 +1,59 @@
+import type { AxiosInstance } from "axios";
+import type { PlataformaClient } from "./index.js";
+/**
+ * Módulo de Banco de Dados (Firestore-like)
+ * Ponto de entrada para acessar as coleções.
+ */
+export declare class DatabaseModule {
+    private client;
+    private http;
+    constructor(client: PlataformaClient, http: AxiosInstance);
+    /**
+     * Seleciona uma coleção de dados (ex: 'tasks' ou 'posts').
+     * @param collectionName O nome da coleção (ex: "tasks")
+     * @returns Uma instância de CollectionReference para operar nela
+     */
+    collection(collectionName: string): CollectionReference;
+}
+/**
+ * Representa uma referência a uma coleção específica no banco.
+ * Contém os métodos CRUD (create, list, update, delete) e subscribe.
+ */
+declare class CollectionReference {
+    private client;
+    private http;
+    private collectionName;
+    private wsUrl;
+    constructor(client: PlataformaClient, http: AxiosInstance, name: string);
+    /**
+     * Lista todos os documentos da coleção.
+     * (GET /v1/db/tasks)
+     */
+    list(): Promise<any>;
+    /**
+     * Cria um novo documento na coleção.
+     * (POST /v1/db/tasks)
+     * @param newData O objeto de dados a ser criado
+     */
+    create(newData: Record<string, any>): Promise<any>;
+    /**
+     * Atualiza um documento existente.
+     * (PUT /v1/db/tasks/:id)
+     * @param id O ID do documento
+     * @param updates Os campos a serem atualizados
+     */
+    update(id: string, updates: Record<string, any>): Promise<any>;
+    /**
+     * Deleta um documento.
+     * (DELETE /v1/db/tasks/:id)
+     * @param id O ID do documento
+     */
+    delete(id: string): Promise<any>;
+    /**
+     * Inscreve-se para mudanças em tempo real na coleção.
+     * @param callback A função que será chamada com (action, data)
+     * @returns Uma função 'unsubscribe' para fechar a conexão
+     */
+    subscribe(callback: (action: "create" | "update" | "delete", data: any) => void): () => void;
+}
+export {};

package/dist/database.js

@@ -0,0 +1,106 @@
+import WebSocket from "ws";
+/**
+ * Módulo de Banco de Dados (Firestore-like)
+ * Ponto de entrada para acessar as coleções.
+ */
+export class DatabaseModule {
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    /**
+     * Seleciona uma coleção de dados (ex: 'tasks' ou 'posts').
+     * @param collectionName O nome da coleção (ex: "tasks")
+     * @returns Uma instância de CollectionReference para operar nela
+     */
+    collection(collectionName) {
+        return new CollectionReference(this.client, this.http, collectionName);
+    }
+}
+/**
+ * Representa uma referência a uma coleção específica no banco.
+ * Contém os métodos CRUD (create, list, update, delete) e subscribe.
+ */
+class CollectionReference {
+    constructor(client, http, name) {
+        this.client = client;
+        this.http = http;
+        this.collectionName = name;
+        // Constrói a URL do WebSocket (substituindo http por ws)
+        this.wsUrl = client.apiUrl.replace(/^http/, "ws");
+    }
+    /**
+     * Lista todos os documentos da coleção.
+     * (GET /v1/db/tasks)
+     */
+    async list() {
+        const { data } = await this.http.get(`/db/${this.collectionName}`);
+        return data.data; // Retorna o array de documentos
+    }
+    /**
+     * Cria um novo documento na coleção.
+     * (POST /v1/db/tasks)
+     * @param newData O objeto de dados a ser criado
+     */
+    async create(newData) {
+        const { data } = await this.http.post(`/db/${this.collectionName}`, newData);
+        return data.data; // Retorna o documento criado
+    }
+    /**
+     * Atualiza um documento existente.
+     * (PUT /v1/db/tasks/:id)
+     * @param id O ID do documento
+     * @param updates Os campos a serem atualizados
+     */
+    async update(id, updates) {
+        const { data } = await this.http.put(`/db/${this.collectionName}/${id}`, updates);
+        return data.data; // Retorna o documento atualizado
+    }
+    /**
+     * Deleta um documento.
+     * (DELETE /v1/db/tasks/:id)
+     * @param id O ID do documento
+     */
+    async delete(id) {
+        const { data } = await this.http.delete(`/db/${this.collectionName}/${id}`);
+        return data; // Retorna { ok: true, ... }
+    }
+    /**
+     * Inscreve-se para mudanças em tempo real na coleção.
+     * @param callback A função que será chamada com (action, data)
+     * @returns Uma função 'unsubscribe' para fechar a conexão
+     */
+    subscribe(callback) {
+        const token = this.client.getToken();
+        const projectId = this.client.projectId;
+        if (!token || !projectId) {
+            throw new Error("Não é possível se inscrever sem um token e projectId.");
+        }
+        // Constrói a URL: ws://localhost:3000/v1/db/subscribe/tasks?token=...&projectId=...
+        const url = `${this.wsUrl}/v1/db/subscribe/${this.collectionName}?token=${token}&projectId=${projectId}`;
+        const ws = new WebSocket(url);
+        ws.on("open", () => {
+            console.log(`[SDK] Inscrito em tempo real na coleção '${this.collectionName}'`);
+        });
+        ws.on("message", (message) => {
+            try {
+                const payload = JSON.parse(message);
+                // Chama o callback do usuário
+                callback(payload.action, payload.data);
+            }
+            catch (e) {
+                console.error("[SDK] Erro ao processar mensagem WS:", e);
+            }
+        });
+        ws.on("close", () => {
+            console.log(`[SDK] Desconectado da coleção '${this.collectionName}'`);
+        });
+        ws.on("error", (err) => {
+            console.error("[SDK] Erro no WebSocket:", err.message);
+        });
+        // Retorna uma função que o usuário pode chamar para parar de "ouvir"
+        return () => {
+            ws.close();
+        };
+    }
+}

package/dist/http-client.d.ts

@@ -0,0 +1,10 @@
+import { type AxiosInstance } from "axios";
+import { 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
+ */
+export declare function createHttpClient(client: PlataformaClient): AxiosInstance;

package/dist/http-client.js

@@ -0,0 +1,27 @@
+// src/http-client.ts
+import axios from "axios";
+/**
+ * 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
+ */
+export function createHttpClient(client) {
+    const http = axios.create({
+        baseURL: `${client.apiUrl}/v1`, // Adiciona o /v1 automaticamente
+    });
+    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;
+    });
+    return http;
+}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { AuthModule } from "./auth.js";
+import { DatabaseModule } from "./database.js";
+import { StorageModule } from "./storage.js";
+type ClientConfig = {
+    apiUrl: string;
+    projectId: string;
+};
+/**
+ * O cliente principal da Plataforma API.
+ * Ponto de entrada para todos os módulos (Auth, DB, Storage).
+ */
+export declare class PlataformaClient {
+    auth: AuthModule;
+    db: DatabaseModule;
+    storage: StorageModule;
+    apiUrl: string;
+    projectId: string;
+    private http;
+    private _token;
+    constructor(config: ClientConfig);
+    /**
+     * Armazena o token de autenticação em memória.
+     * @param token O JWT (ou null para logout)
+     */
+    setToken(token: string | null): void;
+    /**
+     * Recupera o token de autenticação atual.
+     * @returns O JWT ou null
+     */
+    getToken(): string | null;
+}
+export {};

package/dist/index.js

@@ -0,0 +1,39 @@
+import { createHttpClient } from "./http-client.js";
+import { AuthModule } from "./auth.js";
+import { DatabaseModule } from "./database.js";
+import { StorageModule } from "./storage.js";
+/**
+ * O cliente principal da Plataforma API.
+ * Ponto de entrada para todos os módulos (Auth, DB, Storage).
+ */
+export class PlataformaClient {
+    constructor(config) {
+        this._token = null;
+        if (!config.apiUrl || !config.projectId) {
+            throw new Error("apiUrl e projectId são obrigatórios.");
+        }
+        this.apiUrl = config.apiUrl.replace(/\/$/, ""); // Remove barra final
+        this.projectId = config.projectId;
+        // Inicializa o cliente HTTP (passando 'this', a própria instância)
+        this.http = createHttpClient(this);
+        // Inicializa os módulos
+        this.auth = new AuthModule(this, this.http);
+        this.db = new DatabaseModule(this, this.http);
+        this.storage = new StorageModule(this, this.http);
+    }
+    // --- Gerenciamento de Token ---
+    /**
+     * Armazena o token de autenticação em memória.
+     * @param token O JWT (ou null para logout)
+     */
+    setToken(token) {
+        this._token = token;
+    }
+    /**
+     * Recupera o token de autenticação atual.
+     * @returns O JWT ou null
+     */
+    getToken() {
+        return this._token;
+    }
+}

package/dist/storage.d.ts

@@ -0,0 +1,20 @@
+import type { AxiosInstance } from "axios";
+import type { PlataformaClient } from "./index.js";
+/**
+ * Módulo de Storage
+ * Lida com upload e download de arquivos.
+ */
+export declare class StorageModule {
+    private client;
+    private http;
+    constructor(client: PlataformaClient, http: AxiosInstance);
+    /**
+     * 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
+     */
+    upload(file: File | Buffer, fileName: string, contentType: string): Promise<any>;
+}

package/dist/storage.js

@@ -0,0 +1,40 @@
+import axios from "axios"; // [A CORREÇÃO ESTÁ AQUI]
+/**
+ * Módulo de Storage
+ * Lida com upload e download de arquivos.
+ */
+export class StorageModule {
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    /**
+     * 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
+     */
+    async upload(file, fileName, contentType) {
+        const size = file.size || file.length;
+        // 1. Pedir a URL de upload para nossa API
+        const { data: presignData } = await this.http.post("/storage/presign", {
+            fileName: fileName,
+            contentType: contentType,
+            size: size,
+        });
+        // 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.");
+        }
+        // 2. Enviar o arquivo diretamente para o Minio/S3 (sem auth)
+        //    Usamos o 'axios' global aqui, não o 'this.http' (que adicionaria auth)
+        await axios.put(presign.url, file, {
+            headers: { "Content-Type": contentType },
+        });
+        // 3. Retorna os detalhes do objeto (downloadUrl, objectId, etc.)
+        return presign;
+    }
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@allanfsouza/aether-sdk",
+  "version": "1.0.0",
+  "description": "SDK do Cliente para a Plataforma API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "npx tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "axios": "^1.13.2",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.11",
+    "typescript": "^5.9.3"
+  }
+}

package/src/auth.ts

@@ -0,0 +1,62 @@
+// src/auth.ts
+import type { AxiosInstance } from "axios";
+import type { PlataformaClient } from "./index.js";
+
+/**
+ * Módulo de Autenticação
+ * Lida com login, registro e gerenciamento de token.
+ */
+export class AuthModule {
+  private client: PlataformaClient;
+  private http: AxiosInstance;
+
+  constructor(client: PlataformaClient, http: AxiosInstance) {
+    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: string, password: string) {
+    try {
+      const { data } = await this.http.post("/auth/login", { email, password });
+      // Salva o token DENTRO da instância do SDK
+      this.client.setToken(data.token);
+      return data; // Retorna { user, token }
+    } catch (e: unknown) {
+      this.client.setToken(null); // Limpa o token em caso de falha
+      throw e;
+    }
+  }
+
+  /**
+   * Registra um novo usuário e já o loga.
+   * @param credentials Nome, email e senha
+   * @returns O objeto do usuário e o token
+   */
+  async register(credentials: {
+    name: string;
+    email: string;
+    password: string;
+  }) {
+    try {
+      const { data } = await this.http.post("/auth/register", credentials);
+      this.client.setToken(data.token);
+      return data;
+    } catch (e: unknown) {
+      this.client.setToken(null);
+      throw e;
+    }
+  }
+
+  /**
+   * Desconecta o usuário limpando o token do SDK.
+   */
+  logout() {
+    this.client.setToken(null);
+  }
+}

package/src/database.ts

@@ -0,0 +1,149 @@
+// src/database.ts
+import type { AxiosInstance } from "axios";
+import type { PlataformaClient } from "./index.js";
+import WebSocket from "ws";
+
+// Tipo para a mensagem que recebemos do WebSocket
+type WebSocketMessage = {
+  action: "create" | "update" | "delete";
+  collection: string;
+  data: any;
+};
+
+/**
+ * Módulo de Banco de Dados (Firestore-like)
+ * Ponto de entrada para acessar as coleções.
+ */
+export class DatabaseModule {
+  private client: PlataformaClient;
+  private http: AxiosInstance;
+
+  constructor(client: PlataformaClient, http: AxiosInstance) {
+    this.client = client;
+    this.http = http;
+  }
+
+  /**
+   * Seleciona uma coleção de dados (ex: 'tasks' ou 'posts').
+   * @param collectionName O nome da coleção (ex: "tasks")
+   * @returns Uma instância de CollectionReference para operar nela
+   */
+  collection(collectionName: string) {
+    return new CollectionReference(this.client, this.http, collectionName);
+  }
+}
+
+/**
+ * Representa uma referência a uma coleção específica no banco.
+ * Contém os métodos CRUD (create, list, update, delete) e subscribe.
+ */
+class CollectionReference {
+  private client: PlataformaClient;
+  private http: AxiosInstance;
+  private collectionName: string;
+  private wsUrl: string;
+
+  constructor(client: PlataformaClient, http: AxiosInstance, name: string) {
+    this.client = client;
+    this.http = http;
+    this.collectionName = name;
+    // Constrói a URL do WebSocket (substituindo http por ws)
+    this.wsUrl = client.apiUrl.replace(/^http/, "ws");
+  }
+
+  /**
+   * Lista todos os documentos da coleção.
+   * (GET /v1/db/tasks)
+   */
+  async list() {
+    const { data } = await this.http.get(`/db/${this.collectionName}`);
+    return data.data; // Retorna o array de documentos
+  }
+
+  /**
+   * Cria um novo documento na coleção.
+   * (POST /v1/db/tasks)
+   * @param newData O objeto de dados a ser criado
+   */
+  async create(newData: Record<string, any>) {
+    const { data } = await this.http.post(
+      `/db/${this.collectionName}`,
+      newData
+    );
+    return data.data; // Retorna o documento criado
+  }
+
+  /**
+   * Atualiza um documento existente.
+   * (PUT /v1/db/tasks/:id)
+   * @param id O ID do documento
+   * @param updates Os campos a serem atualizados
+   */
+  async update(id: string, updates: Record<string, any>) {
+    const { data } = await this.http.put(
+      `/db/${this.collectionName}/${id}`,
+      updates
+    );
+    return data.data; // Retorna o documento atualizado
+  }
+
+  /**
+   * Deleta um documento.
+   * (DELETE /v1/db/tasks/:id)
+   * @param id O ID do documento
+   */
+  async delete(id: string) {
+    const { data } = await this.http.delete(`/db/${this.collectionName}/${id}`);
+    return data; // Retorna { ok: true, ... }
+  }
+
+  /**
+   * Inscreve-se para mudanças em tempo real na coleção.
+   * @param callback A função que será chamada com (action, data)
+   * @returns Uma função 'unsubscribe' para fechar a conexão
+   */
+  subscribe(
+    callback: (action: "create" | "update" | "delete", data: any) => void
+  ) {
+    const token = this.client.getToken();
+    const projectId = this.client.projectId;
+
+    if (!token || !projectId) {
+      throw new Error("Não é possível se inscrever sem um token e projectId.");
+    }
+
+    // Constrói a URL: ws://localhost:3000/v1/db/subscribe/tasks?token=...&projectId=...
+    const url = `${this.wsUrl}/v1/db/subscribe/${this.collectionName}?token=${token}&projectId=${projectId}`;
+
+    const ws = new WebSocket(url);
+
+    ws.on("open", () => {
+      console.log(
+        `[SDK] Inscrito em tempo real na coleção '${this.collectionName}'`
+      );
+    });
+
+    ws.on("message", (message: string) => {
+      try {
+        const payload = JSON.parse(message) as WebSocketMessage;
+        // Chama o callback do usuário
+        callback(payload.action, payload.data);
+      } catch (e) {
+        console.error("[SDK] Erro ao processar mensagem WS:", e);
+      }
+    });
+
+    ws.on("close", () => {
+      console.log(`[SDK] Desconectado da coleção '${this.collectionName}'`);
+    });
+
+    ws.on("error", (err) => {
+      console.error("[SDK] Erro no WebSocket:", err.message);
+    });
+
+    // Retorna uma função que o usuário pode chamar para parar de "ouvir"
+    return () => {
+      ws.close();
+    };
+  }
+}

package/src/http-client.ts

@@ -0,0 +1,33 @@
+// src/http-client.ts
+import axios, { type AxiosInstance } from "axios";
+import { PlataformaClient } from "./index.js"; // Importa o tipo da classe principal
+
+/**
+ * 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
+ */
+export function createHttpClient(client: PlataformaClient): AxiosInstance {
+  const http = axios.create({
+    baseURL: `${client.apiUrl}/v1`, // Adiciona o /v1 automaticamente
+  });
+
+  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;
+  });
+
+  return http;
+}

package/src/index.ts

@@ -0,0 +1,64 @@
+// src/index.ts
+import type { AxiosInstance } from "axios";
+import { createHttpClient } from "./http-client.js";
+import { AuthModule } from "./auth.js";
+import { DatabaseModule } from "./database.js";
+import { StorageModule } from "./storage.js";
+
+type ClientConfig = {
+  apiUrl: string;
+  projectId: string;
+};
+
+/**
+ * O cliente principal da Plataforma API.
+ * Ponto de entrada para todos os módulos (Auth, DB, Storage).
+ */
+export class PlataformaClient {
+  // Propriedades públicas (os "módulos")
+  public auth: AuthModule;
+  public db: DatabaseModule;
+  public storage: StorageModule;
+
+  // Propriedades de configuração
+  public apiUrl: string;
+  public projectId: string;
+
+  // Propriedades internas
+  private 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.");
+    }
+    this.apiUrl = config.apiUrl.replace(/\/$/, ""); // Remove barra final
+    this.projectId = config.projectId;
+
+    // Inicializa o cliente HTTP (passando 'this', a própria instância)
+    this.http = createHttpClient(this);
+
+    // Inicializa os módulos
+    this.auth = new AuthModule(this, this.http);
+    this.db = new DatabaseModule(this, this.http);
+    this.storage = new StorageModule(this, this.http);
+  }
+
+  // --- Gerenciamento de Token ---
+
+  /**
+   * Armazena o token de autenticação em memória.
+   * @param token O JWT (ou null para logout)
+   */
+  setToken(token: string | null) {
+    this._token = token;
+  }
+
+  /**
+   * Recupera o token de autenticação atual.
+   * @returns O JWT ou null
+   */
+  getToken(): string | null {
+    return this._token;
+  }
+}

package/src/storage.ts

@@ -0,0 +1,52 @@
+// src/storage.ts
+import type { AxiosInstance } from "axios";
+import type { PlataformaClient } from "./index.js";
+import axios from "axios"; // [A CORREÇÃO ESTÁ AQUI]
+
+/**
+ * Módulo de Storage
+ * Lida com upload e download de arquivos.
+ */
+export class StorageModule {
+  private client: PlataformaClient;
+  private http: AxiosInstance;
+
+  constructor(client: PlataformaClient, http: AxiosInstance) {
+    this.client = client;
+    this.http = http;
+  }
+
+  /**
+   * 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
+   */
+  async upload(file: File | Buffer, fileName: string, contentType: string) {
+    const size = (file as File).size || (file as Buffer).length;
+
+    // 1. Pedir a URL de upload para nossa API
+    const { data: presignData } = await this.http.post("/storage/presign", {
+      fileName: fileName,
+      contentType: contentType,
+      size: size,
+    });
+
+    // 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.");
+    }
+
+    // 2. Enviar o arquivo diretamente para o Minio/S3 (sem auth)
+    //    Usamos o 'axios' global aqui, não o 'this.http' (que adicionaria auth)
+    await axios.put(presign.url, file, {
+      headers: { "Content-Type": contentType },
+    });
+
+    // 3. Retorna os detalhes do objeto (downloadUrl, objectId, etc.)
+    return presign;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "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
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "NodeNext"
+  },
+  "include": ["src"] // Só compila o que está na pasta 'src'
+}