@aether-baas/core 3.0.0

package/dist/modules/push.d.ts

@@ -0,0 +1,174 @@
+import type { AxiosInstance } from 'axios';
+import type { PlataformaClient } from '../client/index.js';
+import type { PushPlatform, PushEnvironment, PushDevice, RegisterDeviceParams, PushStats } from '../types/index.js';
+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 type PushTriggerEvent = 'create' | 'update' | 'delete';
+export interface PushTriggerCondition {
+    equals?: unknown;
+    notEquals?: unknown;
+    in?: unknown[];
+    notIn?: unknown[];
+    exists?: boolean;
+    gt?: number;
+    gte?: number;
+    lt?: number;
+    lte?: number;
+}
+export interface LookupFieldConfig {
+    collection: string;
+    foreignKey: string;
+    fields: string[];
+}
+export interface PushTrigger {
+    id: string;
+    projectId: string;
+    name: string;
+    description: string | null;
+    collectionName: string;
+    event: PushTriggerEvent;
+    conditions: Record<string, PushTriggerCondition>;
+    lookupFields: Record<string, LookupFieldConfig>;
+    targetUserField: string;
+    titleTemplate: string;
+    bodyTemplate: string;
+    dataTemplate: Record<string, unknown>;
+    enabled: boolean;
+    priority: string;
+    timesTriggered: number;
+    lastTriggeredAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreatePushTriggerParams {
+    name: string;
+    description?: string;
+    collectionName: string;
+    event: PushTriggerEvent;
+    conditions?: Record<string, PushTriggerCondition>;
+    lookupFields?: Record<string, LookupFieldConfig>;
+    targetUserField: string;
+    titleTemplate: string;
+    bodyTemplate: string;
+    dataTemplate?: Record<string, unknown>;
+    enabled?: boolean;
+    priority?: string;
+}
+export type { PushPlatform, PushEnvironment, PushDevice, RegisterDeviceParams, PushStats };
+/**
+ * Módulo de push notifications do Aether.
+ *
+ * @example
+ * ```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'
+ * });
+ * ```
+ */
+export declare class PushModule {
+    private client;
+    private http;
+    constructor(client: PlataformaClient, http: AxiosInstance);
+    /**
+     * Obtém a chave pública VAPID para Web Push.
+     */
+    getVapidKey(): Promise<{
+        publicKey: string;
+    }>;
+    /**
+     * Registra um dispositivo para receber push notifications.
+     */
+    registerDevice(params: RegisterDeviceParams): Promise<PushDevice>;
+    /**
+     * Remove registro de dispositivo.
+     */
+    unregisterDevice(deviceId: string): Promise<void>;
+    /**
+     * Lista dispositivos do usuário atual.
+     */
+    listDevices(): Promise<PushDevice[]>;
+    /**
+     * Envia notificação para um usuário específico.
+     */
+    sendToUser(params: {
+        userId: string;
+        title: string;
+        body: string;
+        data?: Record<string, string>;
+        environment?: PushEnvironment;
+    }): Promise<SendPushResponse>;
+    /**
+     * Envia notificação para múltiplos usuários.
+     */
+    sendToMany(params: {
+        userIds: string[];
+        title: string;
+        body: string;
+        data?: Record<string, string>;
+        environment?: PushEnvironment;
+    }): Promise<SendPushResponse>;
+    /**
+     * Lista logs de push notifications.
+     */
+    listLogs(options?: ListPushLogsOptions): Promise<PushLogEntry[]>;
+    /**
+     * Obtém estatísticas de push.
+     */
+    getStats(): Promise<PushStats>;
+    /**
+     * Lista todos os triggers configurados.
+     */
+    listTriggers(): Promise<PushTrigger[]>;
+    /**
+     * Obtém um trigger específico.
+     */
+    getTrigger(triggerId: string): Promise<PushTrigger>;
+    /**
+     * Cria um novo trigger.
+     */
+    createTrigger(params: CreatePushTriggerParams): Promise<PushTrigger>;
+    /**
+     * Atualiza um trigger.
+     */
+    updateTrigger(triggerId: string, params: Partial<CreatePushTriggerParams>): Promise<PushTrigger>;
+    /**
+     * Remove um trigger.
+     */
+    deleteTrigger(triggerId: string): Promise<void>;
+    /**
+     * Ativa ou desativa um trigger.
+     */
+    toggleTrigger(triggerId: string, enabled: boolean): Promise<PushTrigger>;
+}
+//# sourceMappingURL=push.d.ts.map

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

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

package/dist/modules/push.js

@@ -0,0 +1,181 @@
+// =============================================================================
+// @aether/core - Push Module
+// =============================================================================
+// Módulo de push notifications (FCM e Web Push).
+// =============================================================================
+// =============================================================================
+// PUSH MODULE
+// =============================================================================
+/**
+ * Módulo de push notifications do Aether.
+ *
+ * @example
+ * ```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'
+ * });
+ * ```
+ */
+export class PushModule {
+    client;
+    http;
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    // ===========================================================================
+    // VAPID KEY (Web Push)
+    // ===========================================================================
+    /**
+     * Obtém a chave pública VAPID para Web Push.
+     */
+    async getVapidKey() {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.get(`/projects/${projectId}/push/vapid-key`);
+        return data;
+    }
+    // ===========================================================================
+    // REGISTRO DE DISPOSITIVO
+    // ===========================================================================
+    /**
+     * Registra um dispositivo para receber push notifications.
+     */
+    async registerDevice(params) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.post(`/projects/${projectId}/push/devices`, {
+            ...params,
+            environment: params.environment ?? 'prod',
+        });
+        return data.data;
+    }
+    /**
+     * Remove registro de dispositivo.
+     */
+    async unregisterDevice(deviceId) {
+        const projectId = this.client.projectId;
+        await this.http.delete(`/projects/${projectId}/push/devices/${deviceId}`);
+    }
+    /**
+     * Lista dispositivos do usuário atual.
+     */
+    async listDevices() {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.get(`/projects/${projectId}/push/devices`);
+        return data.data;
+    }
+    // ===========================================================================
+    // ENVIO DE NOTIFICAÇÕES
+    // ===========================================================================
+    /**
+     * Envia notificação para um usuário específico.
+     */
+    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;
+    }
+    /**
+     * Envia notificação para múltiplos usuários.
+     */
+    async sendToMany(params) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.post(`/projects/${projectId}/push/send-batch`, {
+            userIds: params.userIds,
+            title: params.title,
+            body: params.body,
+            data: params.data ?? {},
+            environment: params.environment ?? 'prod',
+        });
+        return data;
+    }
+    // ===========================================================================
+    // LOGS E ESTATÍSTICAS
+    // ===========================================================================
+    /**
+     * Lista logs de push notifications.
+     */
+    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;
+    }
+    /**
+     * Obtém estatísticas de push.
+     */
+    async getStats() {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.get(`/projects/${projectId}/push/stats`);
+        return data;
+    }
+    // ===========================================================================
+    // TRIGGERS
+    // ===========================================================================
+    /**
+     * Lista todos os triggers configurados.
+     */
+    async listTriggers() {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.get(`/projects/${projectId}/push/triggers`);
+        return data.data;
+    }
+    /**
+     * Obtém um trigger específico.
+     */
+    async getTrigger(triggerId) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.get(`/projects/${projectId}/push/triggers/${triggerId}`);
+        return data.data;
+    }
+    /**
+     * Cria um novo trigger.
+     */
+    async createTrigger(params) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.post(`/projects/${projectId}/push/triggers`, params);
+        return data.data;
+    }
+    /**
+     * Atualiza um trigger.
+     */
+    async updateTrigger(triggerId, params) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.put(`/projects/${projectId}/push/triggers/${triggerId}`, params);
+        return data.data;
+    }
+    /**
+     * Remove um trigger.
+     */
+    async deleteTrigger(triggerId) {
+        const projectId = this.client.projectId;
+        await this.http.delete(`/projects/${projectId}/push/triggers/${triggerId}`);
+    }
+    /**
+     * Ativa ou desativa um trigger.
+     */
+    async toggleTrigger(triggerId, enabled) {
+        return this.updateTrigger(triggerId, { enabled });
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/modules/push.js.map

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

package/dist/modules/storage.d.ts

@@ -0,0 +1,69 @@
+import type { AxiosInstance } from 'axios';
+import type { PlataformaClient } from '../client/index.js';
+import type { FileObject, UploadProgress, ListFilesOptions } from '../types/index.js';
+/**
+ * Módulo de storage do Aether.
+ *
+ * @example
+ * ```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');
+ * ```
+ */
+export declare class StorageModule {
+    private client;
+    private http;
+    constructor(client: PlataformaClient, http: AxiosInstance);
+    /**
+     * Faz upload de um arquivo.
+     *
+     * @param file Arquivo a ser enviado (File, Blob ou Buffer)
+     * @param fileName Nome do arquivo (com extensão)
+     * @param contentType MIME type do arquivo (ex: 'image/png')
+     * @param folder Pasta de destino (opcional)
+     * @param onProgress Callback de progresso (opcional)
+     */
+    upload(file: File | Blob | Buffer, fileName: string, contentType?: string, folder?: string, onProgress?: (progress: UploadProgress) => void): Promise<{
+        data: FileObject;
+        error: null;
+    } | {
+        data: null;
+        error: string;
+    }>;
+    /**
+     * Lista arquivos de uma pasta.
+     */
+    list(folder?: string, options?: ListFilesOptions): Promise<FileObject[]>;
+    /**
+     * Busca um arquivo por ID.
+     */
+    get(fileId: string): Promise<FileObject>;
+    /**
+     * Deleta um arquivo.
+     */
+    delete(fileId: string): Promise<boolean>;
+    /**
+     * Gera URL assinada temporária para download.
+     */
+    getSignedUrl(fileId: string, expiresIn?: number): Promise<string>;
+    /**
+     * Retorna URL pública do arquivo (se bucket for público).
+     */
+    getPublicUrl(fileId: string): string;
+    /**
+     * Move arquivo para outra pasta.
+     */
+    move(fileId: string, newFolder: string): Promise<FileObject>;
+    /**
+     * Renomeia arquivo.
+     */
+    rename(fileId: string, newName: string): Promise<FileObject>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/modules/storage.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAMtF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,IAAI,CAAgB;gBAEhB,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa;IAKzD;;;;;;;;OAQG;IACG,MAAM,CACV,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAC9C,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAyD7E;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAgB9E;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAU9C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO9C;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAWrE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAKpC;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAWlE;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAUnE"}

package/dist/modules/storage.js

@@ -0,0 +1,151 @@
+// =============================================================================
+// @aether/core - Storage Module
+// =============================================================================
+// Módulo de storage para upload/download de arquivos.
+// =============================================================================
+import axios from 'axios';
+// =============================================================================
+// STORAGE MODULE
+// =============================================================================
+/**
+ * Módulo de storage do Aether.
+ *
+ * @example
+ * ```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');
+ * ```
+ */
+export class StorageModule {
+    client;
+    http;
+    constructor(client, http) {
+        this.client = client;
+        this.http = http;
+    }
+    /**
+     * Faz upload de um arquivo.
+     *
+     * @param file Arquivo a ser enviado (File, Blob ou Buffer)
+     * @param fileName Nome do arquivo (com extensão)
+     * @param contentType MIME type do arquivo (ex: 'image/png')
+     * @param folder Pasta de destino (opcional)
+     * @param onProgress Callback de progresso (opcional)
+     */
+    async upload(file, fileName, contentType, folder, onProgress) {
+        const projectId = this.client.projectId;
+        try {
+            // Primeiro obtém URL assinada para upload
+            const { data: uploadData } = await this.http.post(`/projects/${projectId}/storage/upload-url`, {
+                fileName,
+                contentType: contentType || 'application/octet-stream',
+                folder,
+            });
+            // Prepara o arquivo
+            let blob;
+            if (Buffer.isBuffer(file)) {
+                blob = new Blob([new Uint8Array(file)], { type: contentType });
+            }
+            else {
+                blob = file;
+            }
+            // Faz upload direto para S3/storage
+            await axios.put(uploadData.uploadUrl, blob, {
+                headers: {
+                    'Content-Type': contentType || 'application/octet-stream',
+                },
+                onUploadProgress: (event) => {
+                    if (onProgress && event.total) {
+                        onProgress({
+                            loaded: event.loaded,
+                            total: event.total,
+                            percent: Math.round((event.loaded / event.total) * 100),
+                        });
+                    }
+                },
+            });
+            // Confirma upload
+            const { data: fileData } = await this.http.post(`/projects/${projectId}/storage/confirm`, {
+                fileId: uploadData.fileId,
+            });
+            return { data: fileData.data, error: null };
+        }
+        catch (err) {
+            const error = err;
+            return {
+                data: null,
+                error: error.response?.data?.message || error.message || 'Erro no upload'
+            };
+        }
+    }
+    /**
+     * Lista arquivos de uma pasta.
+     */
+    async list(folder, options) {
+        const projectId = this.client.projectId;
+        const params = {};
+        if (folder)
+            params.folder = folder;
+        if (options?.limit)
+            params.limit = options.limit;
+        if (options?.offset)
+            params.offset = options.offset;
+        const { data } = await this.http.get(`/projects/${projectId}/storage`, { params });
+        return data.data;
+    }
+    /**
+     * Busca um arquivo por ID.
+     */
+    async get(fileId) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.get(`/projects/${projectId}/storage/${fileId}`);
+        return data.data;
+    }
+    /**
+     * Deleta um arquivo.
+     */
+    async delete(fileId) {
+        const projectId = this.client.projectId;
+        await this.http.delete(`/projects/${projectId}/storage/${fileId}`);
+        return true;
+    }
+    /**
+     * Gera URL assinada temporária para download.
+     */
+    async getSignedUrl(fileId, expiresIn = 3600) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.post(`/projects/${projectId}/storage/${fileId}/signed-url`, { expiresIn });
+        return data.url;
+    }
+    /**
+     * Retorna URL pública do arquivo (se bucket for público).
+     */
+    getPublicUrl(fileId) {
+        const projectId = this.client.projectId;
+        return `${this.client.apiUrl}/v1/projects/${projectId}/storage/public/${fileId}`;
+    }
+    /**
+     * Move arquivo para outra pasta.
+     */
+    async move(fileId, newFolder) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.put(`/projects/${projectId}/storage/${fileId}/move`, { folder: newFolder });
+        return data.data;
+    }
+    /**
+     * Renomeia arquivo.
+     */
+    async rename(fileId, newName) {
+        const projectId = this.client.projectId;
+        const { data } = await this.http.put(`/projects/${projectId}/storage/${fileId}`, { name: newName });
+        return data.data;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/modules/storage.js.map

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