@allanfsouza/aether-sdk 2.4.3 → 2.4.4

package/dist/database.d.ts

@@ -19,49 +19,16 @@ export declare class QueryBuilder<T> {
     private limitVal?;
     private offsetVal?;
     constructor(collectionRef: CollectionReference<T>);
-    /**
-     * Adiciona um filtro de igualdade.
-     */
     eq(column: keyof T & string, value: any): this;
-    /**
-     * Adiciona um filtro de desigualdade ($ne).
-     */
     neq(column: keyof T & string, value: any): this;
-    /**
-     * Adiciona um filtro maior que ($gt).
-     */
     gt(column: keyof T & string, value: number | string): this;
-    /**
-     * Adiciona um filtro maior ou igual ($gte).
-     */
     gte(column: keyof T & string, value: number | string): this;
-    /**
-     * Adiciona um filtro menor que ($lt).
-     */
     lt(column: keyof T & string, value: number | string): this;
-    /**
-     * Adiciona um filtro menor ou igual ($lte).
-     */
     lte(column: keyof T & string, value: number | string): this;
-    /**
-     * Adiciona um filtro LIKE ($like).
-     */
     like(column: keyof T & string, value: string): this;
-    /**
-     * Define a ordenação.
-     */
     order(column: keyof T & string, direction?: "ASC" | "DESC"): this;
-    /**
-     * Define o limite de registros.
-     */
     limit(count: number): this;
-    /**
-     * Define o deslocamento (paginação).
-     */
     offset(count: number): this;
-    /**
-     * Executa a query e retorna os resultados.
-     */
     get(): Promise<T[]>;
 }
 /**
@@ -91,18 +58,50 @@ export declare 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<T = any>(collectionName: string): CollectionReference<T>;
+    /**
+     * [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<T = any>(tableName: string): {
+        select: (columns?: string) => Promise<{
+            data: T[];
+            error: null;
+        } | {
+            data: null;
+            error: any;
+        }>;
+        insert: (data: T) => Promise<{
+            data: Awaited<T>;
+            error: null;
+        } | {
+            data: null;
+            error: any;
+        }>;
+        update: (data: Partial<T> & {
+            id?: string;
+        }) => Promise<{
+            data: Awaited<T>;
+            error: null;
+        } | {
+            data: null;
+            error: any;
+        }>;
+        delete: () => Promise<{
+            data: null;
+            error: string;
+        }>;
+    };
     /**
      * Executa múltiplas operações em uma única transação.
-     * Se uma falhar, todas são revertidas.
      */
     batch(operations: BatchOperation[]): Promise<any[]>;
 }
 /**
  * Referência a uma coleção específica.
- * O <T> define o formato dos dados (ex: interface User).
  */
 export declare class CollectionReference<T> {
     private client;
@@ -110,45 +109,13 @@ export declare class CollectionReference<T> {
     private collectionName;
     private wsUrl;
     constructor(client: PlataformaClient, http: AxiosInstance, name: string);
-    /**
-     * Inicia o QueryBuilder.
-     * Atalho para .eq()
-     */
     eq(column: keyof T & string, value: any): QueryBuilder<T>;
-    /**
-     * Inicia o QueryBuilder.
-     * Atalho para .gt()
-     */
     gt(column: keyof T & string, value: number | string): QueryBuilder<T>;
-    /**
-     * Retorna uma nova instância do QueryBuilder.
-     */
     query(): QueryBuilder<T>;
-    /**
-     * Lista documentos da coleção com filtros opcionais.
-     * @param options Filtros e Ordenação
-     */
     list(options?: ListOptions<T>): Promise<T[]>;
-    /**
-     * Busca um documento pelo ID.
-     */
     get(id: string): Promise<T>;
-    /**
-     * Cria um novo documento.
-     * O Partial<T> permite criar sem passar campos gerados (como id, createdAt).
-     */
     create(newData: Partial<T>): Promise<T>;
-    /**
-     * Atualiza um documento existente.
-     */
     update(id: string, updates: Partial<T>): Promise<T>;
-    /**
-     * Deleta um documento.
-     */
     delete(id: string): Promise<boolean>;
-    /**
-     * Inscreve-se para mudanças em tempo real.
-     * O callback recebe os dados já tipados como T.
-     */
     subscribe(callback: (action: "create" | "update" | "delete", data: T) => void): () => void;
 }

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allanfsouza/aether-sdk",
-  "version": "2.4.3",
+  "version": "2.4.4",
   "description": "SDK do Cliente para a Plataforma Aether",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/database.ts

@@ -1,7 +1,9 @@
 // src/database.ts
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
-import WebSocket from "ws";
+
+// Ajuste para WebSocket funcionar no Browser (Vite) e Node
+const WS = typeof window !== "undefined" ? window.WebSocket : (global as any).WebSocket || null;
 
 // Tipo para a mensagem que recebemos do WebSocket
 type WebSocketMessage<T = any> = {
@@ -10,7 +12,7 @@ type WebSocketMessage<T = any> = {
   data: T;
 };
 
-// [NOVO] Opções de Listagem Avançada
+// Opções de Listagem Avançada
 export type ListOptions<T> = {
   filter?: Partial<T> | Record<string, any>; // Suporta operadores avançados
   sort?: {
@@ -35,89 +37,56 @@ export class QueryBuilder<T> {
     this.collectionRef = collectionRef;
   }
 
-  /**
-   * Adiciona um filtro de igualdade.
-   */
   eq(column: keyof T & string, value: any): this {
     this.filter[column] = value;
     return this;
   }
 
-  /**
-   * Adiciona um filtro de desigualdade ($ne).
-   */
   neq(column: keyof T & string, value: any): this {
     this.filter[column] = { ...this.filter[column], $ne: value };
     return this;
   }
 
-  /**
-   * Adiciona um filtro maior que ($gt).
-   */
   gt(column: keyof T & string, value: number | string): this {
     this.filter[column] = { ...this.filter[column], $gt: value };
     return this;
   }
 
-  /**
-   * Adiciona um filtro maior ou igual ($gte).
-   */
   gte(column: keyof T & string, value: number | string): this {
     this.filter[column] = { ...this.filter[column], $gte: value };
     return this;
   }
 
-  /**
-   * Adiciona um filtro menor que ($lt).
-   */
   lt(column: keyof T & string, value: number | string): this {
     this.filter[column] = { ...this.filter[column], $lt: value };
     return this;
   }
 
-  /**
-   * Adiciona um filtro menor ou igual ($lte).
-   */
   lte(column: keyof T & string, value: number | string): this {
     this.filter[column] = { ...this.filter[column], $lte: value };
     return this;
   }
 
-  /**
-   * Adiciona um filtro LIKE ($like).
-   */
   like(column: keyof T & string, value: string): this {
     this.filter[column] = { ...this.filter[column], $like: value };
     return this;
   }
 
-  /**
-   * Define a ordenação.
-   */
   order(column: keyof T & string, direction: "ASC" | "DESC" = "ASC"): this {
     this.sort = { field: column, order: direction };
     return this;
   }
 
-  /**
-   * Define o limite de registros.
-   */
   limit(count: number): this {
     this.limitVal = count;
     return this;
   }
 
-  /**
-   * Define o deslocamento (paginação).
-   */
   offset(count: number): this {
     this.offsetVal = count;
     return this;
   }
 
-  /**
-   * Executa a query e retorna os resultados.
-   */
   async get(): Promise<T[]> {
     return this.collectionRef.list({
       filter: this.filter,
@@ -151,15 +120,65 @@ 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<T = any>(collectionName: string) {
     return new CollectionReference<T>(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<T = any>(tableName: string) {
+    const ref = this.collection<T>(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: any) {
+          return { data: null, error: err.response?.data || err.message };
+        }
+      },
+
+      // Mapeia .insert() para .create()
+      insert: async (data: T) => {
+        try {
+          const res = await ref.create(data);
+          return { data: res, error: null };
+        } catch (err: any) {
+          return { data: null, error: err.response?.data || err.message };
+        }
+      },
+
+      // Mapeia .update() para .update() (Requer ID no payload ou logica extra)
+      update: async (data: Partial<T> & { id?: string }) => {
+        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 as any);
+          return { data: res, error: null };
+        } catch (err: any) {
+          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: BatchOperation[]): Promise<any[]> {
     const { data } = await this.http.post("/db/batch", { operations });
@@ -169,7 +188,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<T> {
   private client: PlataformaClient;
@@ -181,56 +199,41 @@ export class CollectionReference<T> {
     this.client = client;
     this.http = http;
     this.collectionName = name;
+
     // Ajusta protocolo para WS/WSS
     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: keyof T & string, value: any): QueryBuilder<T> {
     return new QueryBuilder<T>(this).eq(column, value);
   }
 
-  /**
-   * Inicia o QueryBuilder.
-   * Atalho para .gt()
-   */
   gt(column: keyof T & string, value: number | string): QueryBuilder<T> {
     return new QueryBuilder<T>(this).gt(column, value);
   }
 
-  // ... Outros atalhos podem ser adicionados conforme necessidade ...
-
-  /**
-   * Retorna uma nova instância do QueryBuilder.
-   */
   query(): QueryBuilder<T> {
     return new QueryBuilder<T>(this);
   }
 
-  /**
-   * Lista documentos da coleção com filtros opcionais.
-   * @param options Filtros e Ordenação
-   */
+  // --- Operações CRUD ---
+
   async list(options?: ListOptions<T>): Promise<T[]> {
     const params: any = {};
 
-    // 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,
@@ -238,18 +241,11 @@ export class CollectionReference<T> {
     return data.data;
   }
 
-  /**
-   * Busca um documento pelo ID.
-   */
   async get(id: string): Promise<T> {
     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: Partial<T>): Promise<T> {
     const { data } = await this.http.post(
       `/db/${this.collectionName}`,
@@ -258,9 +254,6 @@ export class CollectionReference<T> {
     return data.data;
   }
 
-  /**
-   * Atualiza um documento existente.
-   */
   async update(id: string, updates: Partial<T>): Promise<T> {
     const { data } = await this.http.put(
       `/db/${this.collectionName}/${id}`,
@@ -269,21 +262,21 @@ export class CollectionReference<T> {
     return data.data;
   }
 
-  /**
-   * Deleta um documento.
-   */
   async delete(id: string): Promise<boolean> {
     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: (action: "create" | "update" | "delete", data: T) => void
   ) {
+    if (!WS) {
+      console.warn("[SDK] WebSocket não disponível neste ambiente.");
+      return () => { };
+    }
+
     const token = this.client.getToken();
     const projectId = this.client.projectId;
 
@@ -292,12 +285,15 @@ export class CollectionReference<T> {
       return () => { };
     }
 
+    // URL correta de subscribe
     const url = `${this.wsUrl}/v1/db/subscribe/${this.collectionName}?token=${token}&projectId=${projectId}`;
 
     let ws: WebSocket | null = null;
 
     try {
-      ws = new WebSocket(url);
+      ws = new WS(url);
+
+      if (!ws) return () => { };
 
       ws.onopen = () => {
         // Conectado
@@ -315,9 +311,12 @@ export class CollectionReference<T> {
         }
       };
 
-      // Mantém a conexão viva (Heartbeat)
+      // Heartbeat
       const pingInterval = setInterval(() => {
-        if (ws?.readyState === WebSocket.OPEN) ws.send("ping");
+        // [CORREÇÃO] Adicionada verificação explicita 'ws &&' para evitar erro 'possibly null'
+        if (ws && ws.readyState === 1) { // 1 = OPEN
+          ws.send("ping");
+        }
       }, 30000);
 
       return () => {
@@ -329,4 +328,4 @@ export class CollectionReference<T> {
       return () => { };
     }
   }
-}
+}