@allanfsouza/aether-sdk 2.1.0 → 2.2.0

package/dist/auth.d.ts

@@ -1,16 +1,79 @@
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
+export interface LoginResponse {
+    accessToken: string;
+    refreshToken: string;
+    user: {
+        id: string;
+        name: string;
+        email: string;
+        avatarUrl?: string;
+        role?: string;
+        aetherRole?: string;
+        planCode?: string;
+        emailVerified?: boolean;
+    };
+}
+export interface Session {
+    id: string;
+    userAgent?: string;
+    ip?: string;
+    createdAt: string;
+    expiresAt: string;
+}
 export declare class AuthModule {
     private client;
     private http;
+    private refreshToken;
     constructor(client: PlataformaClient, http: AxiosInstance);
-    login(email: string, password: string): Promise<any>;
+    /**
+     * Login com email e senha
+     */
+    login(email: string, password: string): Promise<LoginResponse>;
+    /**
+     * Registrar novo usuário
+     */
     register(credentials: {
         name: string;
         email: string;
         password: string;
     }): Promise<any>;
+    /**
+     * Renovar access token usando refresh token
+     */
+    refresh(): Promise<{
+        accessToken: string;
+    }>;
+    /**
+     * Obter URL de autenticação do Google
+     */
+    getGoogleAuthUrl(): string;
+    /**
+     * Logout da sessão atual
+     */
+    logout(): Promise<void>;
+    /**
+     * Logout de todas as sessões
+     */
+    logoutAll(): Promise<void>;
+    /**
+     * Listar sessões ativas
+     */
+    getSessions(): Promise<Session[]>;
+    /**
+     * Esqueci minha senha
+     */
     forgotPassword(email: string): Promise<any>;
+    /**
+     * Redefinir senha
+     */
     resetPassword(token: string, newPassword: string): Promise<any>;
-    logout(): void;
+    /**
+     * Obter refresh token atual (para armazenamento)
+     */
+    getRefreshToken(): string | null;
+    /**
+     * Definir refresh token (para restaurar sessão)
+     */
+    setRefreshToken(token: string | null): void;
 }

package/dist/auth.js

@@ -1,43 +1,133 @@
 export class AuthModule {
     constructor(client, http) {
+        this.refreshToken = null;
         this.client = client;
         this.http = http;
     }
+    /**
+     * Login com email e senha
+     */
     async login(email, password) {
         try {
-            const { data } = await this.http.post("/auth/login", { email, password });
-            if (data.token) {
-                this.client.setToken(data.token);
+            const { data } = await this.http.post("/auth/login", {
+                email,
+                password,
+            });
+            if (data.accessToken) {
+                this.client.setToken(data.accessToken);
+                this.refreshToken = data.refreshToken;
             }
             return data;
         }
         catch (e) {
             this.client.setToken(null);
+            this.refreshToken = null;
             throw e;
         }
     }
+    /**
+     * Registrar novo usuário
+     */
     async register(credentials) {
         try {
             const { data } = await this.http.post("/auth/register", credentials);
-            if (data.token) {
-                this.client.setToken(data.token);
+            return data;
+        }
+        catch (e) {
+            throw e;
+        }
+    }
+    /**
+     * Renovar access token usando refresh token
+     */
+    async refresh() {
+        if (!this.refreshToken) {
+            throw new Error("Nenhum refresh token disponível");
+        }
+        try {
+            const { data } = await this.http.post("/auth/refresh", {
+                refreshToken: this.refreshToken,
+            });
+            if (data.accessToken) {
+                this.client.setToken(data.accessToken);
             }
             return data;
         }
         catch (e) {
             this.client.setToken(null);
+            this.refreshToken = null;
             throw e;
         }
     }
+    /**
+     * Obter URL de autenticação do Google
+     */
+    getGoogleAuthUrl() {
+        return `${this.client.apiUrl}/v1/auth/google`;
+    }
+    /**
+     * Logout da sessão atual
+     */
+    async logout() {
+        if (this.refreshToken) {
+            try {
+                await this.http.post("/auth/logout", {
+                    refreshToken: this.refreshToken,
+                });
+            }
+            catch (e) {
+                // Ignora erro de logout
+            }
+        }
+        this.client.setToken(null);
+        this.refreshToken = null;
+    }
+    /**
+     * Logout de todas as sessões
+     */
+    async logoutAll() {
+        try {
+            await this.http.post("/auth/logout-all");
+        }
+        finally {
+            this.client.setToken(null);
+            this.refreshToken = null;
+        }
+    }
+    /**
+     * Listar sessões ativas
+     */
+    async getSessions() {
+        const { data } = await this.http.get("/auth/sessions");
+        return data.sessions;
+    }
+    /**
+     * Esqueci minha senha
+     */
     async forgotPassword(email) {
         const { data } = await this.http.post("/auth/forgot-password", { email });
         return data;
     }
+    /**
+     * Redefinir senha
+     */
     async resetPassword(token, newPassword) {
-        const { data } = await this.http.post("/auth/reset-password", { token, newPassword });
+        const { data } = await this.http.post("/auth/reset-password", {
+            token,
+            newPassword,
+        });
         return data;
     }
-    logout() {
-        this.client.setToken(null);
+    /**
+     * Obter refresh token atual (para armazenamento)
+     */
+    getRefreshToken() {
+        return this.refreshToken;
+    }
+    /**
+     * Definir refresh token (para restaurar sessão)
+     */
+    setRefreshToken(token) {
+        this.refreshToken = token;
     }
 }

package/dist/database.d.ts

@@ -1,11 +1,85 @@
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
 export type ListOptions<T> = {
-    filter?: Partial<T>;
+    filter?: Partial<T> | Record<string, any>;
     sort?: {
         field: keyof T & string;
         order: "ASC" | "DESC";
     };
+    limit?: number;
+    offset?: number;
+};
+/**
+ * Builder para construção fluente de queries.
+ */
+export declare class QueryBuilder<T> {
+    private collectionRef;
+    private filter;
+    private sort?;
+    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[]>;
+}
+/**
+ * Operação em lote.
+ */
+export type BatchOperation = {
+    type: "create";
+    collection: string;
+    data: any;
+} | {
+    type: "update";
+    collection: string;
+    id: string;
+    data: any;
+} | {
+    type: "delete";
+    collection: string;
+    id: string;
 };
 /**
  * Módulo de Banco de Dados
@@ -20,17 +94,36 @@ export declare class DatabaseModule {
      * * @example client.db.collection<Product>('products')
      */
     collection<T = any>(collectionName: string): CollectionReference<T>;
+    /**
+     * 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).
  */
-declare class CollectionReference<T> {
+export declare class CollectionReference<T> {
     private client;
     private http;
     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
@@ -59,4 +152,3 @@ declare class CollectionReference<T> {
      */
     subscribe(callback: (action: "create" | "update" | "delete", data: T) => void): () => void;
 }
-export {};

package/dist/database.js

@@ -1,4 +1,94 @@
 import WebSocket from "ws";
+/**
+ * Builder para construção fluente de queries.
+ */
+export class QueryBuilder {
+    constructor(collectionRef) {
+        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,
+            sort: this.sort,
+            limit: this.limitVal,
+            offset: this.offsetVal,
+        });
+    }
+}
 /**
  * Módulo de Banco de Dados
  */
@@ -15,12 +105,20 @@ export class DatabaseModule {
     collection(collectionName) {
         return new CollectionReference(this.client, this.http, collectionName);
     }
+    /**
+     * 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 });
+        return data.results;
+    }
 }
 /**
  * Referência a uma coleção específica.
  * O <T> define o formato dos dados (ex: interface User).
  */
-class CollectionReference {
+export class CollectionReference {
     constructor(client, http, name) {
         this.client = client;
         this.http = http;
@@ -29,6 +127,27 @@ class CollectionReference {
         const protocol = client.apiUrl.startsWith("https") ? "wss" : "ws";
         this.wsUrl = client.apiUrl.replace(/^https?/, protocol);
     }
+    /**
+     * Inicia o QueryBuilder.
+     * Atalho para .eq()
+     */
+    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
@@ -43,6 +162,9 @@ class CollectionReference {
             // 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;
         const { data } = await this.http.get(`/db/${this.collectionName}`, {
             params,
         });

package/dist/index.d.ts

@@ -1,7 +1,9 @@
+import type { AxiosInstance } from "axios";
 import { AuthModule } from "./auth.js";
 import { DatabaseModule } from "./database.js";
 import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
+import { PushModule } from "./push.js";
 /**
  * Configuração usada para criar o cliente principal da plataforma.
  */
@@ -11,16 +13,17 @@ export type ClientConfig = {
 };
 /**
  * O cliente principal da Plataforma API (Aether).
- * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions).
+ * 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;
     apiUrl: string;
     projectId: string;
-    private http;
+    http: AxiosInstance;
     private _token;
     constructor(config: ClientConfig);
     /**
@@ -36,3 +39,4 @@ export declare class PlataformaClient {
 }
 export { AetherError } from "./errors.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

@@ -3,9 +3,10 @@ import { AuthModule } from "./auth.js";
 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).
+ * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions, Push).
  */
 export class PlataformaClient {
     constructor(config) {
@@ -13,8 +14,8 @@ export class PlataformaClient {
         if (!config.apiUrl || !config.projectId) {
             throw new Error("apiUrl e projectId são obrigatórios.");
         }
-        // Normaliza apiUrl removendo barra final, se houver
-        this.apiUrl = config.apiUrl.replace(/\/$/, "");
+        // 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.http = createHttpClient(this);
@@ -23,6 +24,7 @@ export class PlataformaClient {
         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);
     }
     // --- Gerenciamento de Token ---
     /**

package/dist/push.d.ts

@@ -0,0 +1,72 @@
+import type { AxiosInstance } from "axios";
+import type { PlataformaClient } from "./index.js";
+export type PushPlatform = "android" | "ios" | "web";
+export type PushEnvironment = "dev" | "staging" | "prod";
+export interface RegisterDeviceParams {
+    platform: PushPlatform;
+    token: string;
+    environment?: PushEnvironment;
+}
+export interface PushDevice {
+    id: string;
+    projectId: string;
+    userId?: string | null;
+    platform: PushPlatform;
+    token: string;
+    environment: PushEnvironment;
+    createdAt: string;
+    lastSeenAt: string;
+}
+export interface RegisterDeviceResponse {
+    device: PushDevice;
+}
+export interface SendPushResponse {
+    sent: number;
+    total: number;
+    message: string;
+}
+export type PushStatus = "sent" | "failed";
+export interface PushLogEntry {
+    id: string;
+    projectId: string;
+    userId?: string | null;
+    deviceId?: string | null;
+    title: string;
+    body: string;
+    data: Record<string, string>;
+    status: PushStatus;
+    errorMessage?: string | null;
+    createdAt: string;
+}
+export interface ListPushLogsOptions {
+    limit?: number;
+    offset?: number;
+    status?: PushStatus;
+}
+export interface PushStats {
+    totalDevices: number;
+    sent24h: number;
+    successRate: number;
+}
+export declare class PushModule {
+    private client;
+    private http;
+    constructor(client: PlataformaClient, http: AxiosInstance);
+    registerDevice(params: RegisterDeviceParams): Promise<PushDevice>;
+    sendToToken(params: {
+        token: string;
+        title: string;
+        body: string;
+        data?: Record<string, string>;
+        environment?: PushEnvironment;
+    }): Promise<SendPushResponse>;
+    sendToUser(params: {
+        userId: string;
+        title: string;
+        body: string;
+        data?: Record<string, string>;
+        environment?: PushEnvironment;
+    }): Promise<SendPushResponse>;
+    listLogs(options?: ListPushLogsOptions): Promise<PushLogEntry[]>;
+    getStats(): Promise<PushStats>;
+}

package/dist/push.js

@@ -0,0 +1,53 @@
+export class PushModule {
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    async registerDevice(params) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.post(`/projects/${projectId}/push/devices`, {
+            platform: params.platform,
+            token: params.token,
+            environment: params.environment ?? "prod",
+        });
+        return data.device;
+    }
+    async sendToToken(params) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.post(`/projects/${projectId}/push/send`, {
+            token: params.token,
+            title: params.title,
+            body: params.body,
+            data: params.data ?? {},
+            environment: params.environment ?? "prod",
+        });
+        return data;
+    }
+    async sendToUser(params) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.post(`/projects/${projectId}/push/send`, {
+            userId: params.userId,
+            title: params.title,
+            body: params.body,
+            data: params.data ?? {},
+            environment: params.environment ?? "prod",
+        });
+        return data;
+    }
+    async listLogs(options = {}) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.get(`/projects/${projectId}/push/logs`, {
+            params: {
+                limit: options.limit,
+                offset: options.offset,
+                status: options.status,
+            },
+        });
+        return data.data;
+    }
+    async getStats() {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.get(`/projects/${projectId}/push/stats`);
+        return data;
+    }
+}

package/package.json

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

package/src/auth.ts

@@ -2,52 +2,180 @@
 import type { AxiosInstance } from "axios";
 import type { PlataformaClient } from "./index.js";
 
+export interface LoginResponse {
+  accessToken: string;
+  refreshToken: string;
+  user: {
+    id: string;
+    name: string;
+    email: string;
+    avatarUrl?: string;
+    role?: string;
+    aetherRole?: string;
+    planCode?: string;
+    emailVerified?: boolean;
+  };
+}
+
+export interface Session {
+  id: string;
+  userAgent?: string;
+  ip?: string;
+  createdAt: string;
+  expiresAt: string;
+}
+
 export class AuthModule {
   private client: PlataformaClient;
   private http: AxiosInstance;
+  private refreshToken: string | null = null;
 
   constructor(client: PlataformaClient, http: AxiosInstance) {
     this.client = client;
     this.http = http;
   }
 
-  async login(email: string, password: string) {
+  /**
+   * Login com email e senha
+   */
+  async login(email: string, password: string): Promise<LoginResponse> {
     try {
-      const { data } = await this.http.post("/auth/login", { email, password });
-      if (data.token) {
-        this.client.setToken(data.token);
+      const { data } = await this.http.post<LoginResponse>("/auth/login", {
+        email,
+        password,
+      });
+
+      if (data.accessToken) {
+        this.client.setToken(data.accessToken);
+        this.refreshToken = data.refreshToken;
       }
+
       return data;
     } catch (e) {
       this.client.setToken(null);
+      this.refreshToken = null;
       throw e;
     }
   }
 
-  async register(credentials: { name: string; email: string; password: string }) {
+  /**
+   * Registrar novo usuário
+   */
+  async register(credentials: {
+    name: string;
+    email: string;
+    password: string;
+  }) {
     try {
       const { data } = await this.http.post("/auth/register", credentials);
-      if (data.token) {
-        this.client.setToken(data.token);
+      return data;
+    } catch (e) {
+      throw e;
+    }
+  }
+
+  /**
+   * Renovar access token usando refresh token
+   */
+  async refresh(): Promise<{ accessToken: string }> {
+    if (!this.refreshToken) {
+      throw new Error("Nenhum refresh token disponível");
+    }
+
+    try {
+      const { data } = await this.http.post("/auth/refresh", {
+        refreshToken: this.refreshToken,
+      });
+
+      if (data.accessToken) {
+        this.client.setToken(data.accessToken);
       }
+
       return data;
     } catch (e) {
       this.client.setToken(null);
+      this.refreshToken = null;
       throw e;
     }
   }
 
+  /**
+   * Obter URL de autenticação do Google
+   */
+  getGoogleAuthUrl(): string {
+    return `${this.client.apiUrl}/v1/auth/google`;
+  }
+
+  /**
+   * Logout da sessão atual
+   */
+  async logout(): Promise<void> {
+    if (this.refreshToken) {
+      try {
+        await this.http.post("/auth/logout", {
+          refreshToken: this.refreshToken,
+        });
+      } catch (e) {
+        // Ignora erro de logout
+      }
+    }
+
+    this.client.setToken(null);
+    this.refreshToken = null;
+  }
+
+  /**
+   * Logout de todas as sessões
+   */
+  async logoutAll(): Promise<void> {
+    try {
+      await this.http.post("/auth/logout-all");
+    } finally {
+      this.client.setToken(null);
+      this.refreshToken = null;
+    }
+  }
+
+  /**
+   * Listar sessões ativas
+   */
+  async getSessions(): Promise<Session[]> {
+    const { data } = await this.http.get<{ sessions: Session[] }>(
+      "/auth/sessions"
+    );
+    return data.sessions;
+  }
+
+  /**
+   * Esqueci minha senha
+   */
   async forgotPassword(email: string) {
     const { data } = await this.http.post("/auth/forgot-password", { email });
     return data;
   }
 
+  /**
+   * Redefinir senha
+   */
   async resetPassword(token: string, newPassword: string) {
-    const { data } = await this.http.post("/auth/reset-password", { token, newPassword });
+    const { data } = await this.http.post("/auth/reset-password", {
+      token,
+      newPassword,
+    });
     return data;
   }
 
-  logout() {
-    this.client.setToken(null);
+  /**
+   * Obter refresh token atual (para armazenamento)
+   */
+  getRefreshToken(): string | null {
+    return this.refreshToken;
+  }
+
+  /**
+   * Definir refresh token (para restaurar sessão)
+   */
+  setRefreshToken(token: string | null) {
+    this.refreshToken = token;
   }
 }

package/src/database.ts

@@ -12,15 +12,130 @@ type WebSocketMessage<T = any> = {
 
 // [NOVO] Opções de Listagem Avançada
 export type ListOptions<T> = {
-  // Filtro parcial (ex: { status: 'active' })
-  filter?: Partial<T>;
-  // Ordenação
+  filter?: Partial<T> | Record<string, any>; // Suporta operadores avançados
   sort?: {
-    field: keyof T & string; // Garante que o campo existe no tipo T
+    field: keyof T & string;
     order: "ASC" | "DESC";
   };
+  limit?: number;
+  offset?: number;
 };
 
+/**
+ * Builder para construção fluente de queries.
+ */
+export class QueryBuilder<T> {
+  private collectionRef: CollectionReference<T>;
+  private filter: Record<string, any> = {};
+  private sort?: { field: string; order: "ASC" | "DESC" };
+  private limitVal?: number;
+  private offsetVal?: number;
+
+  constructor(collectionRef: CollectionReference<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,
+      sort: this.sort as any,
+      limit: this.limitVal,
+      offset: this.offsetVal,
+    });
+  }
+}
+
+/**
+ * Operação em lote.
+ */
+export type BatchOperation =
+  | { type: "create"; collection: string; data: any }
+  | { type: "update"; collection: string; id: string; data: any }
+  | { type: "delete"; collection: string; id: string };
+
 /**
  * Módulo de Banco de Dados
  */
@@ -41,13 +156,22 @@ export class DatabaseModule {
   collection<T = any>(collectionName: string) {
     return new CollectionReference<T>(this.client, this.http, collectionName);
   }
+
+  /**
+   * 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 });
+    return data.results;
+  }
 }
 
 /**
  * Referência a uma coleção específica.
  * O <T> define o formato dos dados (ex: interface User).
  */
-class CollectionReference<T> {
+export class CollectionReference<T> {
   private client: PlataformaClient;
   private http: AxiosInstance;
   private collectionName: string;
@@ -62,6 +186,31 @@ class CollectionReference<T> {
     this.wsUrl = client.apiUrl.replace(/^https?/, protocol);
   }
 
+  /**
+   * Inicia o QueryBuilder.
+   * Atalho para .eq()
+   */
+  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
@@ -79,6 +228,10 @@ class CollectionReference<T> {
       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;
+
     const { data } = await this.http.get(`/db/${this.collectionName}`, {
       params,
     });
@@ -136,7 +289,7 @@ class CollectionReference<T> {
 
     if (!token || !projectId) {
       console.warn("[SDK] Realtime falhou: Token ou ProjectId ausentes.");
-      return () => {};
+      return () => { };
     }
 
     const url = `${this.wsUrl}/v1/db/subscribe/${this.collectionName}?token=${token}&projectId=${projectId}`;
@@ -173,7 +326,7 @@ class CollectionReference<T> {
       };
     } catch (err) {
       console.error("[SDK] Erro WS:", err);
-      return () => {};
+      return () => { };
     }
   }
 }

package/src/index.ts

@@ -5,6 +5,7 @@ import { AuthModule } from "./auth.js";
 import { DatabaseModule } from "./database.js";
 import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
+import { PushModule } from "./push.js";
 
 /**
  * Configuração usada para criar o cliente principal da plataforma.
@@ -16,7 +17,7 @@ export type ClientConfig = {
 
 /**
  * O cliente principal da Plataforma API (Aether).
- * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions).
+ * Ponto de entrada para todos os módulos (Auth, DB, Storage, Functions, Push).
  */
 export class PlataformaClient {
   // Módulos públicos disponíveis para o usuário do SDK
@@ -24,13 +25,14 @@ export class PlataformaClient {
   public db: DatabaseModule;
   public storage: StorageModule;
   public functions: FunctionsModule;
+  public push: PushModule;
 
   // Configurações imutáveis da instância
   public apiUrl: string;
   public projectId: string;
 
   // Infra interna
-  private http: AxiosInstance;
+  public http: AxiosInstance;
   private _token: string | null = null;
 
   constructor(config: ClientConfig) {
@@ -38,8 +40,8 @@ export class PlataformaClient {
       throw new Error("apiUrl e projectId são obrigatórios.");
     }
 
-    // Normaliza apiUrl removendo barra final, se houver
-    this.apiUrl = config.apiUrl.replace(/\/$/, "");
+    // 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)
@@ -50,6 +52,7 @@ export class PlataformaClient {
     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);
   }
 
   // --- Gerenciamento de Token ---
@@ -75,3 +78,15 @@ export class PlataformaClient {
 export { AetherError } from "./errors.js";
 export type { ListOptions } from "./database.js";
 
+// Tipos relacionados a Push
+export type {
+  PushPlatform,
+  PushEnvironment,
+  PushDevice,
+  RegisterDeviceParams,
+  SendPushResponse,
+  PushStatus,
+  PushLogEntry,
+  ListPushLogsOptions,
+  PushStats,
+} from "./push.js";

package/src/push.ts

@@ -0,0 +1,157 @@
+// src/push.ts
+import type { AxiosInstance } from "axios";
+import type { PlataformaClient } from "./index.js";
+
+export type PushPlatform = "android" | "ios" | "web";
+export type PushEnvironment = "dev" | "staging" | "prod";
+
+export interface RegisterDeviceParams {
+    platform: PushPlatform;
+    token: string;
+    environment?: PushEnvironment;
+}
+
+export interface PushDevice {
+    id: string;
+    projectId: string;
+    userId?: string | null;
+    platform: PushPlatform;
+    token: string;
+    environment: PushEnvironment;
+    createdAt: string;
+    lastSeenAt: string;
+}
+
+export interface RegisterDeviceResponse {
+    device: PushDevice;
+}
+
+export interface SendPushResponse {
+    sent: number;
+    total: number;
+    message: string;
+}
+
+export type PushStatus = "sent" | "failed";
+
+export interface PushLogEntry {
+    id: string;
+    projectId: string;
+    userId?: string | null;
+    deviceId?: string | null;
+    title: string;
+    body: string;
+    data: Record<string, string>;
+    status: PushStatus;
+    errorMessage?: string | null;
+    createdAt: string;
+}
+
+export interface ListPushLogsOptions {
+    limit?: number;
+    offset?: number;
+    status?: PushStatus;
+}
+
+export interface PushStats {
+    totalDevices: number;
+    sent24h: number;
+    successRate: number;
+}
+
+export class PushModule {
+    constructor(
+        private client: PlataformaClient,
+        private http: AxiosInstance
+    ) { }
+
+    async registerDevice(params: RegisterDeviceParams): Promise<PushDevice> {
+        const projectId = this.client.projectId;
+
+        const { data } = await this.http.post<RegisterDeviceResponse>(
+            `/projects/${projectId}/push/devices`,
+            {
+                platform: params.platform,
+                token: params.token,
+                environment: params.environment ?? "prod",
+            }
+        );
+
+        return data.device;
+    }
+
+    async sendToToken(params: {
+        token: string;
+        title: string;
+        body: string;
+        data?: Record<string, string>;
+        environment?: PushEnvironment;
+    }): Promise<SendPushResponse> {
+        const projectId = this.client.projectId;
+
+        const { data } = await this.http.post<SendPushResponse>(
+            `/projects/${projectId}/push/send`,
+            {
+                token: params.token,
+                title: params.title,
+                body: params.body,
+                data: params.data ?? {},
+                environment: params.environment ?? "prod",
+            }
+        );
+
+        return data;
+    }
+
+    async sendToUser(params: {
+        userId: string;
+        title: string;
+        body: string;
+        data?: Record<string, string>;
+        environment?: PushEnvironment;
+    }): Promise<SendPushResponse> {
+        const projectId = this.client.projectId;
+
+        const { data } = await this.http.post<SendPushResponse>(
+            `/projects/${projectId}/push/send`,
+            {
+                userId: params.userId,
+                title: params.title,
+                body: params.body,
+                data: params.data ?? {},
+                environment: params.environment ?? "prod",
+            }
+        );
+
+        return data;
+    }
+
+    async listLogs(
+        options: ListPushLogsOptions = {}
+    ): Promise<PushLogEntry[]> {
+        const projectId = this.client.projectId;
+
+        const { data } = await this.http.get<{ data: PushLogEntry[] }>(
+            `/projects/${projectId}/push/logs`,
+            {
+                params: {
+                    limit: options.limit,
+                    offset: options.offset,
+                    status: options.status,
+                },
+            }
+        );
+
+        return data.data;
+    }
+
+    async getStats(): Promise<PushStats> {
+        const projectId = this.client.projectId;
+
+        const { data } = await this.http.get<PushStats>(
+            `/projects/${projectId}/push/stats`
+        );
+
+        return data;
+    }
+}