@allanfsouza/aether-sdk 2.4.3 → 2.4.5

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 () => { };
     }
   }
-}
+}

package/src/index.ts

@@ -1,26 +1,50 @@
 // src/index.ts
 import type { AxiosInstance } from "axios";
 import { createHttpClient } from "./http-client.js";
-import { AuthModule, User } from "./auth.js"; // Importando User
+import { AuthModule, User } from "./auth.js";
 import { DatabaseModule } from "./database.js";
 import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
 import { PushModule } from "./push.js";
 
+// =============================================================================
+// CONSTANTES DE STORAGE
+// Chaves padronizadas para localStorage - evita conflito com outros SDKs
+// =============================================================================
+const STORAGE_KEYS = {
+  TOKEN: "aether_token",
+  REFRESH_TOKEN: "aether_refresh_token",
+  USER: "aether_user",
+} as const;
+
 /**
  * Configuração usada para criar o cliente principal da plataforma.
  */
 export type ClientConfig = {
   // Suporte duplo para compatibilidade:
-  // apiUrl (nome original) OU baseUrl (nome novo do App)
   apiUrl?: string;
   baseUrl?: string;
-
-  // projectId (nome original) OU apiKey (nome novo do App)
   projectId?: string;
   apiKey?: string;
+
+  /**
+   * Habilita persistência automática de sessão no localStorage.
+   * Padrão: true em browsers, false em Node.js/SSR.
+   */
+  persistSession?: boolean;
 };
 
+/**
+ * Verifica se estamos em ambiente browser com localStorage disponível.
+ * Necessário para evitar erros em SSR (Next.js, Nuxt, etc).
+ */
+function isBrowser(): boolean {
+  return (
+    typeof window !== "undefined" &&
+    typeof window.localStorage !== "undefined"
+  );
+}
+
 export class PlataformaClient {
   public auth: AuthModule;
   public db: DatabaseModule;
@@ -35,7 +59,9 @@ export class PlataformaClient {
   public projectId: string;
 
   public http: AxiosInstance;
+
   private _token: string | null = null;
+  private _persistSession: boolean;
 
   constructor(config: ClientConfig) {
     // Resolve URL (prioridade para baseUrl se existir, senão apiUrl)
@@ -49,6 +75,13 @@ export class PlataformaClient {
     this.apiUrl = url.replace(/\/+$/, "");
     this.projectId = project;
 
+    // Persistência habilitada por padrão apenas em browsers
+    this._persistSession = config.persistSession ?? isBrowser();
+
+    // Restaura sessão salva ANTES de criar o httpClient
+    // Isso garante que requisições iniciais já tenham o token
+    this._restoreSession();
+
     this.http = createHttpClient(this);
 
     // Inicializa módulos
@@ -62,18 +95,141 @@ export class PlataformaClient {
     this.database = this.db;
   }
 
-  setToken(token: string | null) {
+  // ===========================================================================
+  // TOKEN DE ACESSO
+  // ===========================================================================
+
+  /**
+   * Define o token de acesso (JWT).
+   * Se persistSession estiver ativo, salva automaticamente no localStorage.
+   */
+  setToken(token: string | null): void {
     this._token = token;
+
+    if (this._persistSession && isBrowser()) {
+      if (token) {
+        localStorage.setItem(STORAGE_KEYS.TOKEN, token);
+      } else {
+        localStorage.removeItem(STORAGE_KEYS.TOKEN);
+      }
+    }
   }
 
+  /**
+   * Retorna o token de acesso atual.
+   */
   getToken(): string | null {
     return this._token;
   }
+
+  // ===========================================================================
+  // REFRESH TOKEN
+  // ===========================================================================
+
+  /**
+   * Salva o refresh token.
+   * Usado internamente pelo AuthModule após login.
+   */
+  setRefreshToken(token: string | null): void {
+    if (this._persistSession && isBrowser()) {
+      if (token) {
+        localStorage.setItem(STORAGE_KEYS.REFRESH_TOKEN, token);
+      } else {
+        localStorage.removeItem(STORAGE_KEYS.REFRESH_TOKEN);
+      }
+    }
+  }
+
+  /**
+   * Retorna o refresh token salvo no localStorage.
+   */
+  getRefreshToken(): string | null {
+    if (this._persistSession && isBrowser()) {
+      return localStorage.getItem(STORAGE_KEYS.REFRESH_TOKEN);
+    }
+    return null;
+  }
+
+  // ===========================================================================
+  // DADOS DO USUÁRIO
+  // ===========================================================================
+
+  /**
+   * Salva dados do usuário logado no localStorage.
+   */
+  setUser(user: User | null): void {
+    if (this._persistSession && isBrowser()) {
+      if (user) {
+        localStorage.setItem(STORAGE_KEYS.USER, JSON.stringify(user));
+      } else {
+        localStorage.removeItem(STORAGE_KEYS.USER);
+      }
+    }
+  }
+
+  /**
+   * Retorna dados do usuário salvo no localStorage.
+   */
+  getUser(): User | null {
+    if (this._persistSession && isBrowser()) {
+      const saved = localStorage.getItem(STORAGE_KEYS.USER);
+      if (saved) {
+        try {
+          return JSON.parse(saved) as User;
+        } catch {
+          // JSON corrompido - limpa
+          localStorage.removeItem(STORAGE_KEYS.USER);
+          return null;
+        }
+      }
+    }
+    return null;
+  }
+
+  // ===========================================================================
+  // GERENCIAMENTO DE SESSÃO
+  // ===========================================================================
+
+  /**
+   * Limpa toda a sessão (token, refresh, user).
+   * Chamado automaticamente no logout.
+   */
+  clearSession(): void {
+    this._token = null;
+
+    if (isBrowser()) {
+      localStorage.removeItem(STORAGE_KEYS.TOKEN);
+      localStorage.removeItem(STORAGE_KEYS.REFRESH_TOKEN);
+      localStorage.removeItem(STORAGE_KEYS.USER);
+    }
+  }
+
+  /**
+   * Verifica se existe uma sessão salva (token presente).
+   */
+  hasSession(): boolean {
+    return this._token !== null;
+  }
+
+  /**
+   * Restaura sessão do localStorage ao inicializar o client.
+   * Executado automaticamente no constructor.
+   */
+  private _restoreSession(): void {
+    if (!this._persistSession || !isBrowser()) {
+      return;
+    }
+
+    const savedToken = localStorage.getItem(STORAGE_KEYS.TOKEN);
+    if (savedToken) {
+      this._token = savedToken;
+    }
+  }
 }
 
 // ===== EXPORTS =====
 export { AetherError } from "./errors.js";
-export type { LoginResponse, Session, User } from "./auth.js"; // User exportado!
+export type { LoginResponse, Session, User } from "./auth.js";
 export type { ListOptions } from "./database.js";
 export type {
   PushPlatform,