@aether-baas/core 3.0.0

package/dist/modules/ai.js

@@ -0,0 +1,330 @@
+// =============================================================================
+// @aether/core - AI Module
+// =============================================================================
+// Módulo de Inteligência Artificial do Aether.
+// Oferece chat, busca semântica, geração de conteúdo e análise.
+// =============================================================================
+// =============================================================================
+// SUB-MÓDULOS
+// =============================================================================
+/**
+ * API de conversas.
+ */
+class ConversationsAPI {
+    client;
+    http;
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    async list() {
+        const { data } = await this.http.get('/ai/conversations', { params: { projectId: this.client.projectId } });
+        return data.data;
+    }
+    async get(conversationId) {
+        const { data } = await this.http.get(`/ai/conversations/${conversationId}`, { params: { projectId: this.client.projectId } });
+        return data.data;
+    }
+    async getMessages(conversationId) {
+        const { data } = await this.http.get(`/ai/conversations/${conversationId}/messages`, { params: { projectId: this.client.projectId } });
+        return data.data;
+    }
+    async rename(conversationId, title) {
+        const { data } = await this.http.put(`/ai/conversations/${conversationId}`, { title, projectId: this.client.projectId });
+        return data.data;
+    }
+    async delete(conversationId) {
+        await this.http.delete(`/ai/conversations/${conversationId}`, {
+            params: { projectId: this.client.projectId },
+        });
+    }
+}
+/**
+ * API de memória de usuário.
+ */
+class MemoryAPI {
+    client;
+    http;
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    async get(userId, key) {
+        const { data } = await this.http.get(`/ai/memory/${userId}/${key}`, { params: { projectId: this.client.projectId } });
+        return data.data;
+    }
+    async set(userId, key, value) {
+        await this.http.post('/ai/memory', {
+            projectId: this.client.projectId,
+            userId,
+            key,
+            value,
+        });
+    }
+    async delete(userId, key) {
+        await this.http.delete(`/ai/memory/${userId}/${key}`, {
+            params: { projectId: this.client.projectId },
+        });
+    }
+    async listKeys(userId) {
+        const { data } = await this.http.get(`/ai/memory/${userId}`, { params: { projectId: this.client.projectId } });
+        return data.data;
+    }
+}
+/**
+ * API administrativa de IA.
+ */
+class AIAdminAPI {
+    client;
+    http;
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    async stats() {
+        const { data } = await this.http.get('/ai/admin/stats', {
+            params: { projectId: this.client.projectId },
+        });
+        return data;
+    }
+    async reindex() {
+        const { data } = await this.http.post('/ai/admin/reindex', {
+            projectId: this.client.projectId,
+        });
+        return data;
+    }
+    async setIndexedCollections(collections) {
+        await this.http.post('/ai/admin/indexed-collections', {
+            projectId: this.client.projectId,
+            collections,
+        });
+    }
+    async clear() {
+        await this.http.post('/ai/admin/clear', {
+            projectId: this.client.projectId,
+        });
+    }
+    async setPersona(config) {
+        await this.http.post('/ai/persona', {
+            projectId: this.client.projectId,
+            ...config,
+        });
+    }
+    async getPersona() {
+        const { data } = await this.http.get('/ai/persona', {
+            params: { projectId: this.client.projectId },
+        });
+        return data.persona || null;
+    }
+}
+// =============================================================================
+// AI MODULE
+// =============================================================================
+/**
+ * Módulo de IA do Aether.
+ *
+ * @example
+ * ```typescript
+ * // Pergunta simples
+ * const { text } = await aether.ai.ask("Quais produtos estão em promoção?");
+ *
+ * // Chat com streaming
+ * await aether.ai.chat("Explique o sistema", {
+ *   onChunk: (chunk) => console.log(chunk),
+ *   onComplete: (full, meta) => console.log("Conversa:", meta.conversationId)
+ * });
+ * ```
+ */
+export class AIModule {
+    client;
+    http;
+    /** API de conversas */
+    conversations;
+    /** API de memória */
+    memory;
+    /** API administrativa */
+    admin;
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+        this.conversations = new ConversationsAPI(client, http);
+        this.memory = new MemoryAPI(client, http);
+        this.admin = new AIAdminAPI(client, http);
+    }
+    // ===========================================================================
+    // MÉTODOS PRINCIPAIS
+    // ===========================================================================
+    /**
+     * Faz uma pergunta simples e aguarda resposta completa.
+     */
+    async ask(message, conversationId) {
+        return new Promise((resolve, reject) => {
+            let fullText = '';
+            let _metadata = { conversationId: conversationId || '' };
+            this.chat(message, {
+                conversationId,
+                onChunk: (chunk) => {
+                    fullText += chunk;
+                },
+                onComplete: (_response, meta) => {
+                    _metadata = meta;
+                    resolve({
+                        text: fullText,
+                        conversationId: meta.conversationId,
+                        sources: meta.sources,
+                    });
+                },
+                onError: reject,
+            }).catch(reject);
+        });
+    }
+    /**
+     * Chat com streaming de resposta.
+     */
+    async chat(message, options = {}) {
+        const projectId = this.client.projectId;
+        const token = this.client.getToken();
+        if (!token) {
+            const error = new Error('Usuário não autenticado. Faça login primeiro.');
+            if (options.onError) {
+                options.onError(error);
+                return;
+            }
+            throw error;
+        }
+        const timeout = options.timeout || 30000;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(`${this.client.apiUrl}/v1/ai/chat`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${token}`,
+                    'X-Project-ID': projectId,
+                },
+                body: JSON.stringify({
+                    message,
+                    projectId,
+                    conversationId: options.conversationId,
+                    context: options.context || 'general',
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Erro na API: ${response.status} - ${errorText}`);
+            }
+            const convIdFromHeader = response.headers.get('X-Conversation-ID');
+            const reader = response.body?.getReader();
+            if (!reader) {
+                throw new Error('Resposta sem corpo');
+            }
+            const decoder = new TextDecoder();
+            let fullText = '';
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const chunk = decoder.decode(value, { stream: true });
+                fullText += chunk;
+                if (options.onChunk) {
+                    options.onChunk(chunk);
+                }
+            }
+            if (options.onComplete) {
+                options.onComplete(fullText, {
+                    conversationId: convIdFromHeader || options.conversationId || '',
+                });
+            }
+        }
+        catch (error) {
+            if (options.onError) {
+                options.onError(error);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    // ===========================================================================
+    // BUSCA SEMÂNTICA
+    // ===========================================================================
+    /**
+     * Busca semântica usando embeddings.
+     */
+    async search(query, options) {
+        const { data } = await this.http.post('/ai/search', {
+            projectId: this.client.projectId,
+            query,
+            limit: options?.limit ?? 10,
+            minScore: options?.minScore ?? 0.5,
+            collection: options?.collection,
+        });
+        return data.data;
+    }
+    // ===========================================================================
+    // GERAÇÃO DE CONTEÚDO
+    // ===========================================================================
+    /**
+     * Gera texto baseado em prompt e dados.
+     */
+    async generate(prompt, data, options) {
+        const { data: response } = await this.http.post('/ai/generate', {
+            projectId: this.client.projectId,
+            prompt,
+            data,
+            ...options,
+        });
+        return response.text;
+    }
+    // ===========================================================================
+    // ANÁLISE
+    // ===========================================================================
+    /**
+     * Analisa dados de uma collection.
+     */
+    async analyze(collection, options) {
+        const { data } = await this.http.post('/ai/analyze', {
+            projectId: this.client.projectId,
+            collection,
+            ...options,
+        });
+        return data;
+    }
+    /**
+     * Converte linguagem natural em query estruturada.
+     */
+    async parseQuery(text) {
+        const { data } = await this.http.post('/ai/parse-query', {
+            projectId: this.client.projectId,
+            text,
+        });
+        return data;
+    }
+    // ===========================================================================
+    // FEEDBACK E USAGE
+    // ===========================================================================
+    /**
+     * Envia feedback sobre uma resposta.
+     */
+    async feedback(messageId, type, comment) {
+        await this.http.post('/ai/feedback', {
+            projectId: this.client.projectId,
+            messageId,
+            type,
+            comment,
+        });
+    }
+    /**
+     * Retorna informações de uso/quota.
+     */
+    async getUsage() {
+        const { data } = await this.http.get('/ai/usage', {
+            params: { projectId: this.client.projectId },
+        });
+        return data;
+    }
+}
+//# sourceMappingURL=ai.js.map

package/dist/modules/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/modules/ai.ts"],"names":[],"mappings":"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"}

package/dist/modules/database.d.ts

@@ -0,0 +1,187 @@
+import type { AxiosInstance } from 'axios';
+import type { PlataformaClient } from '../client/index.js';
+import type { ListOptions, BatchOperation } from '../types/index.js';
+/**
+ * Builder para construção fluente de queries.
+ *
+ * @example
+ * ```typescript
+ * const adults = await aether.db.collection('users')
+ *   .query()
+ *   .eq('status', 'active')
+ *   .gt('age', 18)
+ *   .order('name', 'ASC')
+ *   .limit(50)
+ *   .get();
+ * ```
+ */
+export declare class QueryBuilder<T> {
+    private collectionRef;
+    private filter;
+    private sort?;
+    private limitVal?;
+    private offsetVal?;
+    constructor(collectionRef: CollectionReference<T>);
+    /** Igual a */
+    eq(column: keyof T & string, value: unknown): this;
+    /** Diferente de */
+    neq(column: keyof T & string, value: unknown): this;
+    /** Maior que */
+    gt(column: keyof T & string, value: number | string): this;
+    /** Maior ou igual */
+    gte(column: keyof T & string, value: number | string): this;
+    /** Menor que */
+    lt(column: keyof T & string, value: number | string): this;
+    /** Menor ou igual */
+    lte(column: keyof T & string, value: number | string): this;
+    /** Contém (LIKE %value%) */
+    like(column: keyof T & string, value: string): this;
+    /** Contém case-insensitive (ILIKE) */
+    ilike(column: keyof T & string, value: string): this;
+    /** Está na lista */
+    in(column: keyof T & string, values: unknown[]): this;
+    /** Não está na lista */
+    notIn(column: keyof T & string, values: unknown[]): this;
+    /** É nulo */
+    isNull(column: keyof T & string): this;
+    /** Não é nulo */
+    isNotNull(column: keyof T & string): this;
+    /** Ordenação */
+    order(column: keyof T & string, direction?: 'ASC' | 'DESC'): this;
+    /** Limite de resultados */
+    limit(count: number): this;
+    /** Offset para paginação */
+    offset(count: number): this;
+    /** Executa a query e retorna resultados */
+    get(): Promise<T[]>;
+    /** Executa e retorna primeiro resultado ou null */
+    first(): Promise<T | null>;
+    /** Conta resultados */
+    count(): Promise<number>;
+}
+/**
+ * Referência a uma coleção específica.
+ */
+export declare class CollectionReference<T> {
+    private client;
+    private http;
+    private collectionName;
+    private wsUrl;
+    constructor(client: PlataformaClient, http: AxiosInstance, name: string);
+    /** Atalho para query().eq() */
+    eq(column: keyof T & string, value: unknown): QueryBuilder<T>;
+    /** Atalho para query().gt() */
+    gt(column: keyof T & string, value: number | string): QueryBuilder<T>;
+    /** Inicia uma nova query */
+    query(): QueryBuilder<T>;
+    /**
+     * Lista documentos da collection.
+     */
+    list(options?: ListOptions<T>): Promise<T[]>;
+    /**
+     * Busca um documento por ID.
+     */
+    get(id: string): Promise<T>;
+    /**
+     * Cria um novo documento.
+     */
+    create(newData: Partial<T>): Promise<T>;
+    /**
+     * Atualiza um documento existente.
+     */
+    update(id: string, updates: Partial<T>): Promise<T>;
+    /**
+     * Remove um documento.
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Cria ou atualiza documento (upsert).
+     */
+    upsert(data: Partial<T> & {
+        id?: string;
+    }): Promise<T>;
+    /**
+     * Inscreve para receber atualizações em tempo real.
+     *
+     * @param callback Função chamada quando há mudanças
+     * @returns Função para cancelar inscrição
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = aether.db.collection('messages').subscribe((action, data) => {
+     *   if (action === 'create') {
+     *     console.log('Nova mensagem:', data);
+     *   }
+     * });
+     *
+     * // Para cancelar:
+     * unsubscribe();
+     * ```
+     */
+    subscribe(callback: (action: 'create' | 'update' | 'delete', data: T) => void): () => void;
+}
+/**
+ * Módulo de banco de dados do Aether.
+ */
+export declare class DatabaseModule {
+    private client;
+    private http;
+    constructor(client: PlataformaClient, http: AxiosInstance);
+    /**
+     * Seleciona uma coleção de dados.
+     *
+     * @example
+     * ```typescript
+     * interface Product {
+     *   id: string;
+     *   name: string;
+     *   price: number;
+     * }
+     *
+     * const products = aether.db.collection<Product>('products');
+     * ```
+     */
+    collection<T = Record<string, unknown>>(collectionName: string): CollectionReference<T>;
+    /**
+     * Método compatível com estilo Supabase/Drizzle.
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await aether.db.from('posts').select('*');
+     * ```
+     */
+    from<T = Record<string, unknown>>(tableName: string): {
+        select: (_columns?: string) => Promise<{
+            data: T[];
+            error: null;
+        } | {
+            data: null;
+            error: {} | undefined;
+        }>;
+        insert: (data: T) => Promise<{
+            data: Awaited<T>;
+            error: null;
+        } | {
+            data: null;
+            error: {} | undefined;
+        }>;
+        update: (data: Partial<T> & {
+            id?: string;
+        }) => Promise<{
+            data: Awaited<T>;
+            error: null;
+        } | {
+            data: null;
+            error: {} | undefined;
+        }>;
+        delete: () => Promise<{
+            data: null;
+            error: string;
+        }>;
+    };
+    /**
+     * Executa múltiplas operações em uma única transação.
+     */
+    batch(operations: BatchOperation[]): Promise<unknown[]>;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/modules/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/modules/database.ts"],"names":[],"mappings":"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"}