@allanfsouza/aether-sdk 2.4.11 → 2.5.1

package/README.md

@@ -1,9 +1,383 @@
-# Plataforma SDK (Cliente JS/TS)
+# 🚀 Aether SDK
 
-Este é o SDK oficial para interagir com a sua "Plataforma BaaS" (clone do Firebase). Ele gerencia autenticação, banco de dados genérico (com tempo real) e storage.
+SDK oficial JavaScript/TypeScript para a plataforma **Aether BaaS**.
+
+[![npm version](https://badge.fury.io/js/%40allanfsouza%2Faether-sdk.svg)](https://www.npmjs.com/package/@allanfsouza/aether-sdk)
 
 ## Instalação
 
 ```bash
-npm install @seu-username/plataforma-sdk
+npm install @allanfsouza/aether-sdk
+```
+
+## Inicialização
+
+```typescript
+import { PlataformaClient } from '@allanfsouza/aether-sdk';
+
+const aether = new PlataformaClient({
+  baseUrl: 'https://sua-api.aether.com',
+  apiKey: 'seu-project-id',
+  persistSession: true // Salva sessão no localStorage (padrão: true)
+});
+```
+
+---
+
+## 📦 Database
+
+```typescript
+const users = aether.db.collection('users');
+
+// Listar
+const list = await users.list({ limit: 10 });
+
+// Buscar por ID
+const user = await users.get('user-id');
+
+// Criar
+const newUser = await users.create({ name: 'João', email: 'joao@email.com' });
+
+// Atualizar
+await users.update('user-id', { name: 'Novo Nome' });
+
+// Deletar
+await users.delete('user-id');
+```
+
+### Query Builder
+
+```typescript
+const adults = await aether.db.collection('users')
+  .query()
+  .eq('status', 'active')
+  .gt('age', 18)
+  .order('name', 'ASC')
+  .limit(50)
+  .get();
+```
+
+---
+
+## 🔐 Autenticação
+
+```typescript
+// Login
+const { accessToken, user } = await aether.auth.login('email@test.com', 'senha');
+
+// Registro
+await aether.auth.register({ name: 'João', email: 'joao@email.com', password: 'senha' });
+
+// Logout
+await aether.auth.logout();
+
+// Sessão
+const user = aether.auth.getCurrentUser();
+```
+
+---
+
+## 📁 Storage
+
+```typescript
+// Upload
+const { data } = await aether.storage.upload(file, 'avatar.png', 'image/png');
+console.log(data.downloadUrl);
+
+// Listar
+const files = await aether.storage.list('folder');
+
+// Deletar
+await aether.storage.delete('file-id');
+```
+
+---
+
+## ⚡ Functions
+
+```typescript
+// Invocar função
+const result = await aether.functions.invoke('send-email', {
+  to: 'user@email.com',
+  subject: 'Olá!',
+  body: 'Bem-vindo!'
+});
+```
+
+---
+
+## 📱 Push Notifications
+
+```typescript
+// Registrar dispositivo
+await aether.push.registerDevice({
+  token: 'fcm-token',
+  platform: 'android',
+  environment: 'prod'
+});
+
+// Enviar para usuário
+await aether.push.sendToUser({
+  userId: 'user-id',
+  title: 'Olá!',
+  body: 'Nova mensagem'
+});
+```
+
+---
+
+## 🤖 AI (Inteligência Artificial)
+
+O módulo de IA permite adicionar capacidades de linguagem natural aos seus apps.
+**Limites de uso são aplicados por plano** - veja a seção de [Monetização](#-monetização-e-quotas).
+
+### Chat Simples
+
+```typescript
+// Pergunta simples (aguarda resposta completa)
+const { text, conversationId } = await aether.ai.ask("Quais produtos estão em promoção?");
+console.log(text);
+```
+
+### Chat com Streaming
+
+```typescript
+// Resposta em tempo real (chunk por chunk)
+await aether.ai.chat("Explique como funciona o sistema de pagamentos", {
+  conversationId: 'conv-id-opcional', // Mantém contexto
+  onChunk: (chunk) => {
+    // Atualiza UI em tempo real
+    setResponse(prev => prev + chunk);
+  },
+  onComplete: (fullResponse, meta) => {
+    console.log("Conversa:", meta.conversationId);
+  },
+  onError: (error) => {
+    console.error(error);
+  }
+});
+```
+
+### Busca Semântica
+
+```typescript
+// Encontra documentos similares usando embeddings
+const results = await aether.ai.search("tênis confortável para corrida", {
+  collection: "products", // Opcional: filtrar por collection
+  limit: 10,
+  minScore: 0.7
+});
+
+results.forEach(r => console.log(r.content, r.similarity));
 ```
+
+### Geração de Conteúdo
+
+```typescript
+// Gera texto baseado em dados e prompt
+const descricao = await aether.ai.generate(
+  "Escreva uma descrição para o produto",
+  { name: "iPhone 15", price: 5999, features: ["5G", "48MP"] },
+  { tone: 'friendly', length: 'medium', language: 'pt-BR' }
+);
+```
+
+### Análise de Dados
+
+```typescript
+// Analisa dados e retorna insights em linguagem natural
+const { insights, data } = await aether.ai.analyze("orders", {
+  question: "Como foram as vendas essa semana?",
+  period: "7d"
+});
+console.log(insights);
+```
+
+### Conversão de Linguagem Natural para Query
+
+```typescript
+// Converte texto em filtros estruturados
+const query = await aether.ai.parseQuery(
+  "produtos vermelhos acima de 100 reais ordenados por preço"
+);
+// Retorna: { filter: { color: 'vermelho', price: { $gt: 100 } }, sort: { price: 'ASC' } }
+```
+
+### Gerenciar Conversas
+
+```typescript
+// Listar conversas
+const conversas = await aether.ai.conversations.list();
+
+// Histórico de mensagens
+const mensagens = await aether.ai.conversations.getMessages(conversationId);
+
+// Renomear conversa
+await aether.ai.conversations.rename(conversationId, "Suporte Técnico");
+
+// Deletar conversa
+await aether.ai.conversations.delete(conversationId);
+```
+
+### Memória de Usuário (Pro+)
+
+```typescript
+// Salvar preferências do usuário
+await aether.ai.memory.set("user-123", "preferences", { 
+  theme: "dark", 
+  language: "pt-BR" 
+});
+
+// Buscar memória
+const prefs = await aether.ai.memory.get("user-123", "preferences");
+
+// Listar chaves
+const keys = await aether.ai.memory.listKeys("user-123");
+
+// Deletar memória
+await aether.ai.memory.delete("user-123", "preferences");
+```
+
+### Feedback
+
+```typescript
+// Enviar feedback sobre resposta
+await aether.ai.feedback(messageId, 'thumbs_up');
+await aether.ai.feedback(messageId, 'thumbs_down', 'Resposta incorreta');
+```
+
+### Verificar Uso
+
+```typescript
+// Retorna informações de quota
+const usage = await aether.ai.getUsage();
+console.log(`${usage.percentUsed}% do limite usado`);
+console.log(`Requests: ${usage.requestsUsed}/${usage.requestsLimit}`);
+console.log(`Tokens: ${usage.tokensUsed}/${usage.tokensLimit}`);
+console.log(`Reset: ${usage.resetsAt}`);
+```
+
+### Funções Administrativas
+
+```typescript
+// Configurar persona da IA
+await aether.ai.admin.setPersona({
+  name: "Luna",
+  role: "Assistente de Vendas",
+  personality: "Amigável e usa emojis 🎉",
+  rules: ["Sempre sugira produtos relacionados", "Responda em português"],
+  temperature: 0.8
+});
+
+// Buscar persona
+const persona = await aether.ai.admin.getPersona();
+
+// Reindexa dados para RAG
+await aether.ai.admin.reindex();
+
+// Estatísticas de uso
+const stats = await aether.ai.admin.stats();
+console.log(stats.totalConversations, stats.totalMessages);
+
+// Configurar collections indexadas
+await aether.ai.admin.setIndexedCollections(['products', 'articles', 'faq']);
+
+// Limpar embeddings (CUIDADO!)
+await aether.ai.admin.clear();
+```
+
+---
+
+## 💰 Monetização e Quotas
+
+O uso de IA é limitado por plano para controlar custos:
+
+| Plano | Requests/mês | Tokens/mês | Features |
+|-------|--------------|------------|----------|
+| **FREE** | 100 | 50k | Chat, Search |
+| **PRO** | 10.000 | 2M | + Generate, Analyze, Memory, Persona |
+| **BUSINESS** | 100.000 | 20M | + Vision, Tudo liberado |
+
+### Quando o limite é atingido
+
+```typescript
+try {
+  await aether.ai.ask("Pergunta...");
+} catch (error) {
+  if (error.code === 'QUOTA_EXCEEDED') {
+    console.log(error.usage.percentUsed); // 100
+    console.log(error.upgradeUrl); // '/billing/upgrade'
+  }
+}
+```
+
+### Features por plano
+
+| Feature | Free | Pro | Business |
+|---------|:----:|:---:|:--------:|
+| Chat/Ask | ✅ | ✅ | ✅ |
+| Search | ✅ | ✅ | ✅ |
+| Streaming | ✅ | ✅ | ✅ |
+| Generate | ❌ | ✅ | ✅ |
+| Analyze | ❌ | ✅ | ✅ |
+| ParseQuery | ❌ | ✅ | ✅ |
+| Memory | ❌ | ✅ | ✅ |
+| Persona | ❌ | ✅ | ✅ |
+| Suggestions | ❌ | ✅ | ✅ |
+| Vision | ❌ | ❌ | ✅ |
+
+---
+
+## 👥 Tenant Auth
+
+Para apps que precisam de sistema de login para usuários finais:
+
+```typescript
+// Registro de usuário no projeto
+const { user } = await aether.tenantAuth.signUp('project-id', {
+  email: 'usuario@app.com',
+  password: 'senha123',
+  name: 'Nome'
+});
+
+// Login
+const { accessToken, user } = await aether.tenantAuth.signIn('project-id', {
+  email: 'usuario@app.com',
+  password: 'senha123'
+});
+
+// Perfil
+const profile = await aether.tenantAuth.getProfile();
+
+// Logout
+aether.tenantAuth.signOut();
+```
+
+---
+
+## 📖 Tipos Exportados
+
+```typescript
+import type {
+  // Auth
+  LoginResponse, Session, User,
+  // Database
+  ListOptions,
+  // Push
+  PushDevice, PushStatus, PushStats,
+  // Tenant
+  TenantUser, TenantLoginResponse,
+  // AI
+  ChatOptions, ChatMetadata, AskResponse,
+  Conversation, Message, FeedbackType,
+  SemanticSearchOptions, SemanticSearchResult,
+  GenerateOptions, RetrievedSource,
+  UsageInfo, PersonaConfig
+} from '@allanfsouza/aether-sdk';
+```
+
+---
+
+## 📝 Licença
+
+MIT © Allan Felipe de Souza

package/dist/ai.d.ts

@@ -102,11 +102,37 @@ export interface GenerateOptions {
     /** Contexto adicional para a geração */
     context?: string;
 }
+/**
+ * Informações de uso/quota
+ */
+export interface UsageInfo {
+    requestsUsed: number;
+    requestsLimit: number;
+    tokensUsed: number;
+    tokensLimit: number;
+    percentUsed: number;
+    plan: string;
+    resetsAt: string;
+}
+/**
+ * Configuração de persona
+ */
+export interface PersonaConfig {
+    name: string;
+    role: string;
+    personality?: string;
+    language?: string;
+    rules?: string[];
+    knowledge?: string[];
+    temperature?: number;
+}
 export declare class AIModule {
     private client;
     private http;
     /** Sub-módulo para gerenciar conversas */
     conversations: ConversationsAPI;
+    /** Sub-módulo para gerenciar memória de usuários */
+    memory: MemoryAPI;
     /** Sub-módulo para funções administrativas */
     admin: AIAdminAPI;
     constructor(client: PlataformaClient, http: AxiosInstance);
@@ -205,6 +231,14 @@ export declare class AIModule {
         filter?: Record<string, any>;
         sort?: Record<string, any>;
     }>;
+    /**
+     * Retorna informações de uso e quota.
+     *
+     * @example
+     * const usage = await aether.ai.getUsage();
+     * console.log(`${usage.percentUsed}% do limite usado`);
+     */
+    getUsage(): Promise<UsageInfo>;
 }
 declare class ConversationsAPI {
     private client;
@@ -241,6 +275,33 @@ declare class ConversationsAPI {
      */
     rename(conversationId: string, title: string): Promise<Conversation>;
 }
+declare class MemoryAPI {
+    private client;
+    private http;
+    constructor(client: PlataformaClient, http: AxiosInstance);
+    /**
+     * Busca memória de um usuário.
+     *
+     * @example
+     * const prefs = await aether.ai.memory.get("user-123", "preferences");
+     */
+    get(userId: string, key: string): Promise<any>;
+    /**
+     * Salva memória de um usuário.
+     *
+     * @example
+     * await aether.ai.memory.set("user-123", "preferences", { theme: "dark" });
+     */
+    set(userId: string, key: string, value: any): Promise<void>;
+    /**
+     * Deleta memória de um usuário.
+     */
+    delete(userId: string, key?: string): Promise<void>;
+    /**
+     * Lista todas as chaves de memória de um usuário.
+     */
+    listKeys(userId: string): Promise<string[]>;
+}
 declare class AIAdminAPI {
     private client;
     private http;
@@ -296,5 +357,21 @@ declare class AIAdminAPI {
         autoIndex: boolean;
         embeddingModel: string;
     }>;
+    /**
+     * Configura a persona da IA para o projeto.
+     *
+     * @example
+     * await aether.ai.admin.setPersona({
+     *   name: "Luna",
+     *   role: "Assistente de Vendas",
+     *   personality: "Amigável e usa emojis",
+     *   rules: ["Sempre sugira produtos relacionados"]
+     * });
+     */
+    setPersona(config: PersonaConfig): Promise<void>;
+    /**
+     * Busca a persona configurada.
+     */
+    getPersona(): Promise<PersonaConfig | null>;
 }
 export {};

package/dist/ai.js

@@ -10,6 +10,7 @@ export class AIModule {
         this.client = client;
         this.http = http;
         this.conversations = new ConversationsAPI(client, http);
+        this.memory = new MemoryAPI(client, http);
         this.admin = new AIAdminAPI(client, http);
     }
     // ===========================================================================
@@ -243,6 +244,22 @@ export class AIModule {
         });
         return data;
     }
+    // ===========================================================================
+    // INFORMAÇÕES DE USO
+    // ===========================================================================
+    /**
+     * Retorna informações de uso e quota.
+     *
+     * @example
+     * const usage = await aether.ai.getUsage();
+     * console.log(`${usage.percentUsed}% do limite usado`);
+     */
+    async getUsage() {
+        const { data } = await this.http.get('/ai/usage', {
+            params: { projectId: this.client.projectId }
+        });
+        return data;
+    }
 }
 // =============================================================================
 // SUB-MÓDULO: CONVERSAS
@@ -298,6 +315,69 @@ class ConversationsAPI {
     }
 }
 // =============================================================================
+// SUB-MÓDULO: MEMÓRIA DE USUÁRIO
+// =============================================================================
+class MemoryAPI {
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    /**
+     * Busca memória de um usuário.
+     *
+     * @example
+     * const prefs = await aether.ai.memory.get("user-123", "preferences");
+     */
+    async get(userId, key) {
+        const { data } = await this.http.get('/ai/memory', {
+            params: {
+                projectId: this.client.projectId,
+                userId,
+                key
+            }
+        });
+        return data.value;
+    }
+    /**
+     * Salva memória de um usuário.
+     *
+     * @example
+     * await aether.ai.memory.set("user-123", "preferences", { theme: "dark" });
+     */
+    async set(userId, key, value) {
+        await this.http.post('/ai/memory', {
+            projectId: this.client.projectId,
+            userId,
+            key,
+            value
+        });
+    }
+    /**
+     * Deleta memória de um usuário.
+     */
+    async delete(userId, key) {
+        await this.http.delete('/ai/memory', {
+            params: {
+                projectId: this.client.projectId,
+                userId,
+                key
+            }
+        });
+    }
+    /**
+     * Lista todas as chaves de memória de um usuário.
+     */
+    async listKeys(userId) {
+        const { data } = await this.http.get('/ai/memory/keys', {
+            params: {
+                projectId: this.client.projectId,
+                userId
+            }
+        });
+        return data.keys || [];
+    }
+}
+// =============================================================================
 // SUB-MÓDULO: ADMIN
 // =============================================================================
 class AIAdminAPI {
@@ -367,4 +447,30 @@ class AIAdminAPI {
         });
         return data;
     }
+    /**
+     * Configura a persona da IA para o projeto.
+     *
+     * @example
+     * await aether.ai.admin.setPersona({
+     *   name: "Luna",
+     *   role: "Assistente de Vendas",
+     *   personality: "Amigável e usa emojis",
+     *   rules: ["Sempre sugira produtos relacionados"]
+     * });
+     */
+    async setPersona(config) {
+        await this.http.post('/ai/persona', {
+            projectId: this.client.projectId,
+            ...config
+        });
+    }
+    /**
+     * Busca a persona configurada.
+     */
+    async getPersona() {
+        const { data } = await this.http.get('/ai/persona', {
+            params: { projectId: this.client.projectId }
+        });
+        return data.persona || null;
+    }
 }

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
 import { PushModule } from "./push.js";
 import { TenantAuthModule } from "./tenant-auth.js";
+import { AIModule } from "./ai.js";
 /**
  * Configuração usada para criar o cliente principal da plataforma.
  */
@@ -31,6 +32,7 @@ export declare class PlataformaClient {
     functions: FunctionsModule;
     push: PushModule;
     tenantAuth: TenantAuthModule;
+    ai: AIModule;
     database: DatabaseModule;
     apiUrl: string;
     projectId: string;
@@ -85,3 +87,4 @@ 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";
 export type { TenantUser, TenantLoginResponse, TenantRegisterCredentials, TenantLoginCredentials, } from "./tenant-auth.js";
+export type { ChatOptions, ChatMetadata, AskResponse, Conversation, Message, FeedbackType, SemanticSearchOptions, SemanticSearchResult, GenerateOptions, RetrievedSource, UsageInfo, PersonaConfig, } from "./ai.js";

package/dist/index.js

@@ -5,6 +5,7 @@ import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
 import { PushModule } from "./push.js";
 import { TenantAuthModule } from "./tenant-auth.js";
+import { AIModule } from "./ai.js";
 // =============================================================================
 // CONSTANTES DE STORAGE
 // Chaves padronizadas para localStorage - evita conflito com outros SDKs
@@ -48,6 +49,7 @@ export class PlataformaClient {
         this.functions = new FunctionsModule(this, this.http);
         this.push = new PushModule(this, this.http);
         this.tenantAuth = new TenantAuthModule(this, this.http);
+        this.ai = new AIModule(this, this.http);
         // Cria o alias que o Showcase App espera
         this.database = this.db;
     }

package/package.json

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

package/src/ai.ts

@@ -132,6 +132,32 @@ export interface GenerateOptions {
     context?: string;
 }
 
+/**
+ * Informações de uso/quota
+ */
+export interface UsageInfo {
+    requestsUsed: number;
+    requestsLimit: number;
+    tokensUsed: number;
+    tokensLimit: number;
+    percentUsed: number;
+    plan: string;
+    resetsAt: string;
+}
+
+/**
+ * Configuração de persona
+ */
+export interface PersonaConfig {
+    name: string;
+    role: string;
+    personality?: string;
+    language?: string;
+    rules?: string[];
+    knowledge?: string[];
+    temperature?: number;
+}
+
 // =============================================================================
 // MÓDULO PRINCIPAL
 // =============================================================================
@@ -143,6 +169,9 @@ export class AIModule {
     /** Sub-módulo para gerenciar conversas */
     public conversations: ConversationsAPI;
 
+    /** Sub-módulo para gerenciar memória de usuários */
+    public memory: MemoryAPI;
+
     /** Sub-módulo para funções administrativas */
     public admin: AIAdminAPI;
 
@@ -150,6 +179,7 @@ export class AIModule {
         this.client = client;
         this.http = http;
         this.conversations = new ConversationsAPI(client, http);
+        this.memory = new MemoryAPI(client, http);
         this.admin = new AIAdminAPI(client, http);
     }
 
@@ -425,6 +455,24 @@ export class AIModule {
         });
         return data;
     }
+
+    // ===========================================================================
+    // INFORMAÇÕES DE USO
+    // ===========================================================================
+
+    /**
+     * Retorna informações de uso e quota.
+     * 
+     * @example
+     * const usage = await aether.ai.getUsage();
+     * console.log(`${usage.percentUsed}% do limite usado`);
+     */
+    async getUsage(): Promise<UsageInfo> {
+        const { data } = await this.http.get('/ai/usage', {
+            params: { projectId: this.client.projectId }
+        });
+        return data;
+    }
 }
 
 // =============================================================================
@@ -489,6 +537,78 @@ class ConversationsAPI {
     }
 }
 
+// =============================================================================
+// SUB-MÓDULO: MEMÓRIA DE USUÁRIO
+// =============================================================================
+
+class MemoryAPI {
+    private client: PlataformaClient;
+    private http: AxiosInstance;
+
+    constructor(client: PlataformaClient, http: AxiosInstance) {
+        this.client = client;
+        this.http = http;
+    }
+
+    /**
+     * Busca memória de um usuário.
+     * 
+     * @example
+     * const prefs = await aether.ai.memory.get("user-123", "preferences");
+     */
+    async get(userId: string, key: string): Promise<any> {
+        const { data } = await this.http.get('/ai/memory', {
+            params: {
+                projectId: this.client.projectId,
+                userId,
+                key
+            }
+        });
+        return data.value;
+    }
+
+    /**
+     * Salva memória de um usuário.
+     * 
+     * @example
+     * await aether.ai.memory.set("user-123", "preferences", { theme: "dark" });
+     */
+    async set(userId: string, key: string, value: any): Promise<void> {
+        await this.http.post('/ai/memory', {
+            projectId: this.client.projectId,
+            userId,
+            key,
+            value
+        });
+    }
+
+    /**
+     * Deleta memória de um usuário.
+     */
+    async delete(userId: string, key?: string): Promise<void> {
+        await this.http.delete('/ai/memory', {
+            params: {
+                projectId: this.client.projectId,
+                userId,
+                key
+            }
+        });
+    }
+
+    /**
+     * Lista todas as chaves de memória de um usuário.
+     */
+    async listKeys(userId: string): Promise<string[]> {
+        const { data } = await this.http.get('/ai/memory/keys', {
+            params: {
+                projectId: this.client.projectId,
+                userId
+            }
+        });
+        return data.keys || [];
+    }
+}
+
 // =============================================================================
 // SUB-MÓDULO: ADMIN
 // =============================================================================
@@ -577,4 +697,32 @@ class AIAdminAPI {
         });
         return data;
     }
+
+    /**
+     * Configura a persona da IA para o projeto.
+     * 
+     * @example
+     * await aether.ai.admin.setPersona({
+     *   name: "Luna",
+     *   role: "Assistente de Vendas",
+     *   personality: "Amigável e usa emojis",
+     *   rules: ["Sempre sugira produtos relacionados"]
+     * });
+     */
+    async setPersona(config: PersonaConfig): Promise<void> {
+        await this.http.post('/ai/persona', {
+            projectId: this.client.projectId,
+            ...config
+        });
+    }
+
+    /**
+     * Busca a persona configurada.
+     */
+    async getPersona(): Promise<PersonaConfig | null> {
+        const { data } = await this.http.get('/ai/persona', {
+            params: { projectId: this.client.projectId }
+        });
+        return data.persona || null;
+    }
 }

package/src/index.ts

@@ -7,6 +7,7 @@ import { StorageModule } from "./storage.js";
 import { FunctionsModule } from "./functions.js";
 import { PushModule } from "./push.js";
 import { TenantAuthModule, TenantUser, TenantLoginResponse, TenantRegisterCredentials, TenantLoginCredentials } from "./tenant-auth.js";
+import { AIModule } from "./ai.js";
 
 // =============================================================================
 // CONSTANTES DE STORAGE
@@ -59,6 +60,7 @@ export class PlataformaClient {
   public functions: FunctionsModule;
   public push: PushModule;
   public tenantAuth: TenantAuthModule;
+  public ai: AIModule;
 
   // Alias para 'db' que o showcase tenta usar como 'database'
   public database: DatabaseModule;
@@ -101,6 +103,7 @@ export class PlataformaClient {
     this.functions = new FunctionsModule(this, this.http);
     this.push = new PushModule(this, this.http);
     this.tenantAuth = new TenantAuthModule(this, this.http);
+    this.ai = new AIModule(this, this.http);
 
     // Cria o alias que o Showcase App espera
     this.database = this.db;
@@ -258,4 +261,18 @@ export type {
   TenantLoginResponse,
   TenantRegisterCredentials,
   TenantLoginCredentials,
-} from "./tenant-auth.js";
+} from "./tenant-auth.js";
+export type {
+  ChatOptions,
+  ChatMetadata,
+  AskResponse,
+  Conversation,
+  Message,
+  FeedbackType,
+  SemanticSearchOptions,
+  SemanticSearchResult,
+  GenerateOptions,
+  RetrievedSource,
+  UsageInfo,
+  PersonaConfig,
+} from "./ai.js";