@allanfsouza/aether-sdk 2.4.2 → 2.4.4

package/dist/database.js

@@ -1,4 +1,5 @@
-import WebSocket from "ws";
+// Ajuste para WebSocket funcionar no Browser (Vite) e Node
+const WS = typeof window !== "undefined" ? window.WebSocket : global.WebSocket || null;
 /**
  * Builder para construção fluente de queries.
  */
@@ -7,79 +8,46 @@ export class QueryBuilder {
         this.filter = {};
         this.collectionRef = collectionRef;
     }
-    /**
-     * Adiciona um filtro de igualdade.
-     */
     eq(column, value) {
         this.filter[column] = value;
         return this;
     }
-    /**
-     * Adiciona um filtro de desigualdade ($ne).
-     */
     neq(column, value) {
         this.filter[column] = { ...this.filter[column], $ne: value };
         return this;
     }
-    /**
-     * Adiciona um filtro maior que ($gt).
-     */
     gt(column, value) {
         this.filter[column] = { ...this.filter[column], $gt: value };
         return this;
     }
-    /**
-     * Adiciona um filtro maior ou igual ($gte).
-     */
     gte(column, value) {
         this.filter[column] = { ...this.filter[column], $gte: value };
         return this;
     }
-    /**
-     * Adiciona um filtro menor que ($lt).
-     */
     lt(column, value) {
         this.filter[column] = { ...this.filter[column], $lt: value };
         return this;
     }
-    /**
-     * Adiciona um filtro menor ou igual ($lte).
-     */
     lte(column, value) {
         this.filter[column] = { ...this.filter[column], $lte: value };
         return this;
     }
-    /**
-     * Adiciona um filtro LIKE ($like).
-     */
     like(column, value) {
         this.filter[column] = { ...this.filter[column], $like: value };
         return this;
     }
-    /**
-     * Define a ordenação.
-     */
     order(column, direction = "ASC") {
         this.sort = { field: column, order: direction };
         return this;
     }
-    /**
-     * Define o limite de registros.
-     */
     limit(count) {
         this.limitVal = count;
         return this;
     }
-    /**
-     * Define o deslocamento (paginação).
-     */
     offset(count) {
         this.offsetVal = count;
         return this;
     }
-    /**
-     * Executa a query e retorna os resultados.
-     */
     async get() {
         return this.collectionRef.list({
             filter: this.filter,
@@ -100,14 +68,63 @@ export class DatabaseModule {
     /**
      * Seleciona uma coleção de dados.
      * [PREMIUM] Suporta Generics <T> para tipagem forte.
-     * * @example client.db.collection<Product>('products')
+     * @example client.db.collection<Product>('products')
      */
     collection(collectionName) {
         return new CollectionReference(this.client, this.http, collectionName);
     }
+    /**
+     * [NOVO] Método compatível com estilo 'Supabase/Drizzle'.
+     * É um alias para .collection() mas retorna interface compatível com o Showcase.
+     * @example client.db.from('posts').select('*')
+     */
+    from(tableName) {
+        const ref = this.collection(tableName);
+        return {
+            // Mapeia .select() para .list()
+            select: async (columns = "*") => {
+                try {
+                    // Nota: O parametro 'columns' poderia ser enviado ao backend se suportado
+                    const data = await ref.list();
+                    return { data, error: null };
+                }
+                catch (err) {
+                    return { data: null, error: err.response?.data || err.message };
+                }
+            },
+            // Mapeia .insert() para .create()
+            insert: async (data) => {
+                try {
+                    const res = await ref.create(data);
+                    return { data: res, error: null };
+                }
+                catch (err) {
+                    return { data: null, error: err.response?.data || err.message };
+                }
+            },
+            // Mapeia .update() para .update() (Requer ID no payload ou logica extra)
+            update: async (data) => {
+                try {
+                    if (!data.id)
+                        throw new Error("ID é obrigatório para update via .from()");
+                    const { id, ...updates } = data;
+                    const res = await ref.update(id, updates);
+                    return { data: res, error: null };
+                }
+                catch (err) {
+                    return { data: null, error: err.response?.data || err.message };
+                }
+            },
+            // Mapeia .delete()
+            delete: async () => {
+                // O showcase não passou argumentos no delete, o que é perigoso.
+                // Aqui retornamos erro ou implementamos delete por query se suportado.
+                return { data: null, error: "Delete via .from() requer implementação de filtros" };
+            }
+        };
+    }
     /**
      * Executa múltiplas operações em uma única transação.
-     * Se uma falhar, todas são revertidas.
      */
     async batch(operations) {
         const { data } = await this.http.post("/db/batch", { operations });
@@ -116,7 +133,6 @@ export class DatabaseModule {
 }
 /**
  * Referência a uma coleção específica.
- * O <T> define o formato dos dados (ex: interface User).
  */
 export class CollectionReference {
     constructor(client, http, name) {
@@ -127,93 +143,69 @@ export class CollectionReference {
         const protocol = client.apiUrl.startsWith("https") ? "wss" : "ws";
         this.wsUrl = client.apiUrl.replace(/^https?/, protocol);
     }
-    /**
-     * Inicia o QueryBuilder.
-     * Atalho para .eq()
-     */
+    // --- Atalhos de Query ---
     eq(column, value) {
         return new QueryBuilder(this).eq(column, value);
     }
-    /**
-     * Inicia o QueryBuilder.
-     * Atalho para .gt()
-     */
     gt(column, value) {
         return new QueryBuilder(this).gt(column, value);
     }
-    // ... Outros atalhos podem ser adicionados conforme necessidade ...
-    /**
-     * Retorna uma nova instância do QueryBuilder.
-     */
     query() {
         return new QueryBuilder(this);
     }
-    /**
-     * Lista documentos da coleção com filtros opcionais.
-     * @param options Filtros e Ordenação
-     */
+    // --- Operações CRUD ---
     async list(options) {
         const params = {};
-        // Converte os objetos do SDK para strings que o Backend entende
         if (options?.filter) {
             params.filter = JSON.stringify(options.filter);
         }
         if (options?.sort) {
-            // Backend espera formato array: ["campo", "DESC"]
             params.sort = JSON.stringify([options.sort.field, options.sort.order]);
         }
-        // TODO: Backend precisa implementar limit/offset na rota GET
-        // if (options?.limit) params.limit = options.limit;
-        // if (options?.offset) params.offset = options.offset;
+        if (options?.limit)
+            params.limit = options.limit;
+        if (options?.offset)
+            params.offset = options.offset;
         const { data } = await this.http.get(`/db/${this.collectionName}`, {
             params,
         });
         return data.data;
     }
-    /**
-     * Busca um documento pelo ID.
-     */
     async get(id) {
         const { data } = await this.http.get(`/db/${this.collectionName}/${id}`);
         return data.data;
     }
-    /**
-     * Cria um novo documento.
-     * O Partial<T> permite criar sem passar campos gerados (como id, createdAt).
-     */
     async create(newData) {
         const { data } = await this.http.post(`/db/${this.collectionName}`, newData);
         return data.data;
     }
-    /**
-     * Atualiza um documento existente.
-     */
     async update(id, updates) {
         const { data } = await this.http.put(`/db/${this.collectionName}/${id}`, updates);
         return data.data;
     }
-    /**
-     * Deleta um documento.
-     */
     async delete(id) {
         await this.http.delete(`/db/${this.collectionName}/${id}`);
         return true;
     }
-    /**
-     * Inscreve-se para mudanças em tempo real.
-     * O callback recebe os dados já tipados como T.
-     */
+    // --- Realtime ---
     subscribe(callback) {
+        if (!WS) {
+            console.warn("[SDK] WebSocket não disponível neste ambiente.");
+            return () => { };
+        }
         const token = this.client.getToken();
         const projectId = this.client.projectId;
         if (!token || !projectId) {
             console.warn("[SDK] Realtime falhou: Token ou ProjectId ausentes.");
             return () => { };
         }
+        // URL correta de subscribe
         const url = `${this.wsUrl}/v1/db/subscribe/${this.collectionName}?token=${token}&projectId=${projectId}`;
         let ws = null;
         try {
-            ws = new WebSocket(url);
+            ws = new WS(url);
+            if (!ws)
+                return () => { };
             ws.onopen = () => {
                 // Conectado
             };
@@ -229,10 +221,12 @@ export class CollectionReference {
                     // Erro silencioso de parse
                 }
             };
-            // Mantém a conexão viva (Heartbeat)
+            // Heartbeat
             const pingInterval = setInterval(() => {
-                if (ws?.readyState === WebSocket.OPEN)
+                // [CORREÇÃO] Adicionada verificação explicita 'ws &&' para evitar erro 'possibly null'
+                if (ws && ws.readyState === 1) { // 1 = OPEN
                     ws.send("ping");
+                }
             }, 30000);
             return () => {
                 clearInterval(pingInterval);

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.4",
   "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"
   }
-}
+}