@aether-baas/core 3.0.0

package/dist/adapters/storage.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Interface que todos os adapters de storage devem implementar.
+ * Baseada na API do localStorage, mas com suporte a async.
+ */
+export interface StorageAdapter {
+    /**
+     * Obtém um valor do storage.
+     * @returns O valor ou null se não existir
+     */
+    getItem(key: string): string | null | Promise<string | null>;
+    /**
+     * Salva um valor no storage.
+     */
+    setItem(key: string, value: string): void | Promise<void>;
+    /**
+     * Remove um valor do storage.
+     */
+    removeItem(key: string): void | Promise<void>;
+    /**
+     * Remove todos os valores do storage (opcional).
+     */
+    clear?(): void | Promise<void>;
+    /**
+     * Retorna todas as chaves (opcional).
+     */
+    getAllKeys?(): string[] | Promise<string[]>;
+}
+/**
+ * Adapter noop para quando storage não está disponível.
+ * Útil para SSR ou quando não quer persistência.
+ */
+export declare class NoopStorageAdapter implements StorageAdapter {
+    getItem(_key: string): string | null;
+    setItem(_key: string, _value: string): void;
+    removeItem(_key: string): void;
+    clear(): void;
+}
+/**
+ * Adapter de memória (volátil).
+ * Útil para testes, SSR, ou quando não quer persistência.
+ */
+export declare class MemoryStorageAdapter implements StorageAdapter {
+    private store;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    getAllKeys(): string[];
+}
+/**
+ * Adapter para localStorage do browser.
+ * Funciona apenas em ambiente browser.
+ */
+export declare class BrowserStorageAdapter implements StorageAdapter {
+    private storage;
+    private prefix;
+    constructor(options?: {
+        storage?: 'local' | 'session';
+        prefix?: string;
+    });
+    private getKey;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    getAllKeys(): string[];
+}
+/**
+ * Adapter para cookies (útil para SSR com Next.js).
+ * Permite compartilhar sessão entre cliente e servidor.
+ */
+export declare class CookieStorageAdapter implements StorageAdapter {
+    private prefix;
+    private defaultOptions;
+    constructor(options?: {
+        prefix?: string;
+        /** Opções padrão para cookies */
+        cookieOptions?: CookieOptions;
+    });
+    private getKey;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+export interface CookieOptions {
+    path?: string;
+    domain?: string;
+    maxAge?: number;
+    expires?: Date;
+    secure?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+    httpOnly?: boolean;
+}
+/**
+ * Verifica se estamos em ambiente browser com localStorage disponível.
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Verifica se localStorage está disponível e funcionando.
+ */
+export declare function isLocalStorageAvailable(): boolean;
+/**
+ * Cria o adapter de storage mais apropriado para o ambiente atual.
+ * - Browser com localStorage: BrowserStorageAdapter
+ * - Browser sem localStorage: MemoryStorageAdapter
+ * - SSR/Node: MemoryStorageAdapter
+ */
+export declare function createDefaultStorageAdapter(options?: {
+    prefix?: string;
+    forceMemory?: boolean;
+}): StorageAdapter;
+/**
+ * Wrapper que normaliza adapters sync e async para sempre retornar Promise.
+ * Útil para usar o mesmo código com localStorage (sync) e AsyncStorage (async).
+ */
+export declare class AsyncStorageWrapper implements StorageAdapter {
+    private adapter;
+    constructor(adapter: StorageAdapter);
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    getAllKeys(): Promise<string[]>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

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

package/dist/adapters/storage.js

@@ -0,0 +1,299 @@
+// =============================================================================
+// @aether/core - Storage Adapters
+// =============================================================================
+// Abstração de storage para suportar múltiplos ambientes:
+// - Browser: localStorage/sessionStorage
+// - React Native: AsyncStorage
+// - SSR/Next.js: cookies
+// - Node.js: memória ou arquivo
+// =============================================================================
+/**
+ * Adapter noop para quando storage não está disponível.
+ * Útil para SSR ou quando não quer persistência.
+ */
+export class NoopStorageAdapter {
+    getItem(_key) {
+        return null;
+    }
+    setItem(_key, _value) {
+        // Noop - não faz nada
+    }
+    removeItem(_key) {
+        // Noop - não faz nada
+    }
+    clear() {
+        // Noop - não faz nada
+    }
+}
+/**
+ * Adapter de memória (volátil).
+ * Útil para testes, SSR, ou quando não quer persistência.
+ */
+export class MemoryStorageAdapter {
+    store = new Map();
+    getItem(key) {
+        return this.store.get(key) ?? null;
+    }
+    setItem(key, value) {
+        this.store.set(key, value);
+    }
+    removeItem(key) {
+        this.store.delete(key);
+    }
+    clear() {
+        this.store.clear();
+    }
+    getAllKeys() {
+        return Array.from(this.store.keys());
+    }
+}
+/**
+ * Adapter para localStorage do browser.
+ * Funciona apenas em ambiente browser.
+ */
+export class BrowserStorageAdapter {
+    storage;
+    prefix;
+    constructor(options) {
+        const storageType = options?.storage ?? 'local';
+        this.prefix = options?.prefix ?? '';
+        if (typeof window === 'undefined') {
+            throw new Error('[Aether] BrowserStorageAdapter só pode ser usado em ambiente browser. ' +
+                'Use MemoryStorageAdapter ou outro adapter para SSR.');
+        }
+        this.storage = storageType === 'session'
+            ? window.sessionStorage
+            : window.localStorage;
+    }
+    getKey(key) {
+        return this.prefix ? `${this.prefix}${key}` : key;
+    }
+    getItem(key) {
+        try {
+            return this.storage.getItem(this.getKey(key));
+        }
+        catch {
+            // Modo privado do Safari pode lançar exceção
+            return null;
+        }
+    }
+    setItem(key, value) {
+        try {
+            this.storage.setItem(this.getKey(key), value);
+        }
+        catch (error) {
+            // Quota excedida ou modo privado
+            console.warn('[Aether] Falha ao salvar no storage:', error);
+        }
+    }
+    removeItem(key) {
+        try {
+            this.storage.removeItem(this.getKey(key));
+        }
+        catch {
+            // Ignora erros de remoção
+        }
+    }
+    clear() {
+        try {
+            if (this.prefix) {
+                // Remove apenas itens com o prefix
+                const keysToRemove = [];
+                for (let i = 0; i < this.storage.length; i++) {
+                    const key = this.storage.key(i);
+                    if (key?.startsWith(this.prefix)) {
+                        keysToRemove.push(key);
+                    }
+                }
+                keysToRemove.forEach(key => this.storage.removeItem(key));
+            }
+            else {
+                this.storage.clear();
+            }
+        }
+        catch {
+            // Ignora erros
+        }
+    }
+    getAllKeys() {
+        const keys = [];
+        try {
+            for (let i = 0; i < this.storage.length; i++) {
+                const key = this.storage.key(i);
+                if (key) {
+                    if (this.prefix) {
+                        if (key.startsWith(this.prefix)) {
+                            keys.push(key.slice(this.prefix.length));
+                        }
+                    }
+                    else {
+                        keys.push(key);
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignora erros
+        }
+        return keys;
+    }
+}
+/**
+ * Adapter para cookies (útil para SSR com Next.js).
+ * Permite compartilhar sessão entre cliente e servidor.
+ */
+export class CookieStorageAdapter {
+    prefix;
+    defaultOptions;
+    constructor(options) {
+        this.prefix = options?.prefix ?? '';
+        this.defaultOptions = {
+            path: '/',
+            sameSite: 'lax',
+            secure: typeof window !== 'undefined' && window.location.protocol === 'https:',
+            maxAge: 60 * 60 * 24 * 30, // 30 dias
+            ...options?.cookieOptions,
+        };
+    }
+    getKey(key) {
+        return this.prefix ? `${this.prefix}${key}` : key;
+    }
+    getItem(key) {
+        if (typeof document === 'undefined')
+            return null;
+        const name = this.getKey(key);
+        const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
+        if (match) {
+            try {
+                return decodeURIComponent(match[2]);
+            }
+            catch {
+                return match[2];
+            }
+        }
+        return null;
+    }
+    setItem(key, value) {
+        if (typeof document === 'undefined')
+            return;
+        const name = this.getKey(key);
+        const encodedValue = encodeURIComponent(value);
+        let cookie = `${name}=${encodedValue}`;
+        if (this.defaultOptions.path) {
+            cookie += `; path=${this.defaultOptions.path}`;
+        }
+        if (this.defaultOptions.maxAge) {
+            cookie += `; max-age=${this.defaultOptions.maxAge}`;
+        }
+        if (this.defaultOptions.domain) {
+            cookie += `; domain=${this.defaultOptions.domain}`;
+        }
+        if (this.defaultOptions.secure) {
+            cookie += '; secure';
+        }
+        if (this.defaultOptions.sameSite) {
+            cookie += `; samesite=${this.defaultOptions.sameSite}`;
+        }
+        if (this.defaultOptions.httpOnly) {
+            cookie += '; httponly';
+        }
+        document.cookie = cookie;
+    }
+    removeItem(key) {
+        if (typeof document === 'undefined')
+            return;
+        const name = this.getKey(key);
+        document.cookie = `${name}=; path=${this.defaultOptions.path ?? '/'}; max-age=0`;
+    }
+    clear() {
+        if (typeof document === 'undefined')
+            return;
+        const cookies = document.cookie.split(';');
+        for (const cookie of cookies) {
+            const [name] = cookie.trim().split('=');
+            if (name && (!this.prefix || name.startsWith(this.prefix))) {
+                document.cookie = `${name}=; path=${this.defaultOptions.path ?? '/'}; max-age=0`;
+            }
+        }
+    }
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+/**
+ * Verifica se estamos em ambiente browser com localStorage disponível.
+ */
+export function isBrowser() {
+    return (typeof window !== 'undefined' &&
+        typeof window.localStorage !== 'undefined');
+}
+/**
+ * Verifica se localStorage está disponível e funcionando.
+ */
+export function isLocalStorageAvailable() {
+    if (!isBrowser())
+        return false;
+    try {
+        const testKey = '__aether_storage_test__';
+        window.localStorage.setItem(testKey, 'test');
+        window.localStorage.removeItem(testKey);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Cria o adapter de storage mais apropriado para o ambiente atual.
+ * - Browser com localStorage: BrowserStorageAdapter
+ * - Browser sem localStorage: MemoryStorageAdapter
+ * - SSR/Node: MemoryStorageAdapter
+ */
+export function createDefaultStorageAdapter(options) {
+    if (options?.forceMemory) {
+        return new MemoryStorageAdapter();
+    }
+    if (isLocalStorageAvailable()) {
+        return new BrowserStorageAdapter({ prefix: options?.prefix });
+    }
+    return new MemoryStorageAdapter();
+}
+// =============================================================================
+// ASYNC STORAGE WRAPPER
+// =============================================================================
+/**
+ * Wrapper que normaliza adapters sync e async para sempre retornar Promise.
+ * Útil para usar o mesmo código com localStorage (sync) e AsyncStorage (async).
+ */
+export class AsyncStorageWrapper {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async getItem(key) {
+        const result = this.adapter.getItem(key);
+        return result instanceof Promise ? result : Promise.resolve(result);
+    }
+    async setItem(key, value) {
+        const result = this.adapter.setItem(key, value);
+        return result instanceof Promise ? result : Promise.resolve(result);
+    }
+    async removeItem(key) {
+        const result = this.adapter.removeItem(key);
+        return result instanceof Promise ? result : Promise.resolve(result);
+    }
+    async clear() {
+        if (this.adapter.clear) {
+            const result = this.adapter.clear();
+            return result instanceof Promise ? result : Promise.resolve(result);
+        }
+    }
+    async getAllKeys() {
+        if (this.adapter.getAllKeys) {
+            const result = this.adapter.getAllKeys();
+            return result instanceof Promise ? result : Promise.resolve(result);
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/adapters/storage.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,172 @@
+import type { AxiosInstance } from 'axios';
+import { type TokenProvider } from '../http/client.js';
+import { type StorageAdapter } from '../adapters/storage.js';
+import type { ClientConfig, TenantUser } from '../types/index.js';
+type DatabaseModuleType = import('../modules/database.js').DatabaseModule;
+type StorageModuleType = import('../modules/storage.js').StorageModule;
+type FunctionsModuleType = import('../modules/functions.js').FunctionsModule;
+type PushModuleType = import('../modules/push.js').PushModule;
+type TenantAuthModuleType = import('../modules/tenant-auth.js').TenantAuthModule;
+type AIModuleType = import('../modules/ai.js').AIModule;
+/**
+ * Cliente principal do Aether SDK.
+ * Ponto de entrada para todas as funcionalidades.
+ *
+ * @example
+ * ```typescript
+ * import { PlataformaClient } from '@aether/core';
+ *
+ * const aether = new PlataformaClient({
+ *   baseUrl: 'https://api.aether.dev',
+ *   apiKey: 'seu-project-id',
+ * });
+ *
+ * // Database
+ * const users = await aether.db.collection('users').list();
+ *
+ * // Auth
+ * await aether.tenantAuth.signIn({ email, password });
+ *
+ * // Storage
+ * await aether.storage.upload(file, 'avatar.png');
+ * ```
+ */
+export declare class PlataformaClient implements TokenProvider {
+    /** Módulo de banco de dados */
+    db: DatabaseModuleType;
+    /** Alias para db (compatibilidade com showcase) */
+    database: DatabaseModuleType;
+    /** Módulo de storage (arquivos) */
+    storage: StorageModuleType;
+    /** Módulo de functions serverless */
+    functions: FunctionsModuleType;
+    /** Módulo de push notifications */
+    push: PushModuleType;
+    /** Módulo de auth para usuários de apps (tenant) */
+    tenantAuth: TenantAuthModuleType;
+    /** Módulo de IA */
+    ai: AIModuleType;
+    /** URL base da API */
+    readonly apiUrl: string;
+    /** ID do projeto */
+    readonly projectId: string;
+    /** API Key de serviço */
+    serviceApiKey: string | null;
+    /** Cliente HTTP configurado */
+    http: AxiosInstance;
+    /** Token de acesso atual */
+    private _token;
+    /** Se deve persistir sessão */
+    private _persistSession;
+    /** Adapter de storage */
+    private _storage;
+    /** Prefixo para chaves de storage */
+    private _storagePrefix;
+    /** Se os módulos foram inicializados */
+    private _initialized;
+    constructor(config: ClientConfig);
+    /**
+     * Cria o adapter de storage apropriado para o ambiente.
+     */
+    private _createStorageAdapter;
+    /**
+     * Inicializa os módulos do SDK.
+     * Usa import dinâmico para evitar circular dependencies.
+     */
+    private _initializeModules;
+    /**
+     * Define o token de acesso (JWT).
+     * Se persistSession estiver ativo, salva no storage.
+     */
+    setToken(token: string | null): void;
+    /**
+     * Retorna o token de acesso atual.
+     */
+    getToken(): string | null;
+    /**
+     * Salva o refresh token.
+     */
+    setRefreshToken(token: string | null): void;
+    /**
+     * Retorna o refresh token.
+     */
+    getRefreshToken(): string | null;
+    /**
+     * Salva dados do usuário tenant no storage.
+     */
+    setUser(user: TenantUser | null): void;
+    /**
+     * Retorna dados do usuário tenant.
+     */
+    getUser(): TenantUser | null;
+    /**
+     * Limpa toda a sessão (token, refresh, user).
+     */
+    clearSession(): void;
+    /**
+     * Verifica se existe uma sessão salva.
+     */
+    hasSession(): boolean;
+    /**
+     * Verifica se está autenticado (tem token E user).
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Restaura sessão do storage ao inicializar.
+     */
+    private _restoreSession;
+    /**
+     * Obtém item do storage (sync).
+     * Para adapters async, usa versão síncrona se disponível.
+     */
+    private _getStorageItem;
+    /**
+     * Define item no storage (fire and forget para async).
+     */
+    private _setStorageItem;
+    /**
+     * Remove item do storage (fire and forget para async).
+     */
+    private _removeStorageItem;
+    /**
+     * Define um adapter de storage customizado.
+     * Útil para React Native (AsyncStorage) ou SSR (cookies).
+     *
+     * @example
+     * ```typescript
+     * import AsyncStorage from '@react-native-async-storage/async-storage';
+     *
+     * aether.setStorageAdapter({
+     *   getItem: (key) => AsyncStorage.getItem(key),
+     *   setItem: (key, value) => AsyncStorage.setItem(key, value),
+     *   removeItem: (key) => AsyncStorage.removeItem(key),
+     * });
+     * ```
+     */
+    setStorageAdapter(adapter: StorageAdapter): void;
+    /**
+     * Retorna o adapter de storage atual.
+     */
+    getStorageAdapter(): StorageAdapter;
+}
+/**
+ * Cria uma instância do PlataformaClient.
+ * Alias para `new PlataformaClient(config)`.
+ */
+export declare function createClient(config: ClientConfig): PlataformaClient;
+/**
+ * Inicializa e retorna uma instância singleton do client.
+ * Útil para apps simples que só precisam de uma instância.
+ */
+export declare function initializeClient(config: ClientConfig): PlataformaClient;
+/**
+ * Retorna a instância singleton do client.
+ * Deve ser chamado após initializeClient().
+ */
+export declare function getClient(): PlataformaClient;
+/**
+ * Destrói a instância singleton.
+ */
+export declare function destroyClient(): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

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