@allanfsouza/aether-sdk 2.4.6 → 2.4.9

package/src/tenant-auth.ts

@@ -0,0 +1,333 @@
+// src/tenant-auth.ts
+// [FEATURE] Módulo de Autenticação de Tenants para SDK
+// Permite autenticação de end-users em projetos Aether
+// Compatible with Firebase Auth-style usage
+
+import type { AxiosInstance, AxiosError } from "axios";
+import type { PlataformaClient } from "./index.js";
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+/**
+ * Representa um usuário tenant (end-user de um projeto)
+ */
+export interface TenantUser {
+    id: string;
+    email: string;
+    name: string;
+    data: Record<string, any>;
+    emailVerified: boolean;
+    status: "active" | "suspended" | string;
+    createdAt: string;
+}
+
+/**
+ * Resposta de login do tenant
+ */
+export interface TenantLoginResponse {
+    accessToken: string;
+    user: TenantUser;
+}
+
+/**
+ * Credenciais para registro de tenant
+ */
+export interface TenantRegisterCredentials {
+    email: string;
+    password: string;
+    name?: string;
+    data?: Record<string, any>;
+}
+
+/**
+ * Credenciais para login de tenant
+ */
+export interface TenantLoginCredentials {
+    email: string;
+    password: string;
+}
+
+// ============================================================================
+// MODULE
+// ============================================================================
+
+/**
+ * Módulo de Autenticação de Tenants
+ * 
+ * Permite que usuários finais (clientes) de projetos Aether
+ * se registrem, façam login e gerenciem seus perfis.
+ * 
+ * Os dados são isolados por projeto (tabela prj_{id}_users).
+ * 
+ * @example
+ * ```typescript
+ * const aether = new PlataformaClient({ ... });
+ * 
+ * // Registrar usuário no projeto
+ * const { user, error } = await aether.tenantAuth.signUp('project-id', {
+ *   email: 'user@example.com',
+ *   password: '123456',
+ *   name: 'John Doe',
+ * });
+ * 
+ * // Login
+ * const { accessToken, user } = await aether.tenantAuth.signIn('project-id', {
+ *   email: 'user@example.com',
+ *   password: '123456',
+ * });
+ * 
+ * // Obter perfil
+ * const profile = await aether.tenantAuth.getProfile('project-id');
+ * ```
+ */
+export class TenantAuthModule {
+    private client: PlataformaClient;
+    private http: AxiosInstance;
+
+    // Armazena o token do tenant atual em memória
+    private currentToken: string | null = null;
+    private currentUser: TenantUser | null = null;
+
+    constructor(client: PlataformaClient, http: AxiosInstance) {
+        this.client = client;
+        this.http = http;
+    }
+
+    // ==========================================================================
+    // MÉTODOS PRINCIPAIS
+    // ==========================================================================
+
+    /**
+     * Registra um novo usuário tenant no projeto.
+     * A tabela de usuários é criada automaticamente se não existir.
+     * 
+     * @param projectId - ID do projeto
+     * @param credentials - Email, senha, nome e dados opcionais
+     */
+    async register(
+        projectId: string,
+        credentials: TenantRegisterCredentials
+    ): Promise<{ user: TenantUser; message: string }> {
+        const { data } = await this.http.post("/auth/tenant/register", {
+            projectId,
+            ...credentials,
+        });
+        return data;
+    }
+
+    /**
+     * Realiza login de usuário tenant.
+     * Armazena o token para uso em requisições subsequentes.
+     * 
+     * @param projectId - ID do projeto
+     * @param credentials - Email e senha
+     */
+    async login(
+        projectId: string,
+        credentials: TenantLoginCredentials
+    ): Promise<TenantLoginResponse> {
+        const { data } = await this.http.post<TenantLoginResponse>(
+            "/auth/tenant/login",
+            {
+                projectId,
+                ...credentials,
+            }
+        );
+
+        // Armazena token e usuário
+        this.currentToken = data.accessToken;
+        this.currentUser = data.user;
+
+        return data;
+    }
+
+    /**
+     * Solicita reset de senha.
+     * Retorna mensagem genérica para prevenir enumeração de usuários.
+     * 
+     * @param projectId - ID do projeto
+     * @param email - Email do usuário
+     */
+    async forgotPassword(
+        projectId: string,
+        email: string
+    ): Promise<{ message: string }> {
+        const { data } = await this.http.post("/auth/tenant/forgot-password", {
+            projectId,
+            email,
+        });
+        return data;
+    }
+
+    /**
+     * Redefine a senha usando o token recebido por email.
+     * 
+     * @param projectId - ID do projeto
+     * @param email - Email do usuário
+     * @param token - Token de reset (recebido por email)
+     * @param newPassword - Nova senha
+     */
+    async resetPassword(
+        projectId: string,
+        email: string,
+        token: string,
+        newPassword: string
+    ): Promise<{ message: string }> {
+        const { data } = await this.http.post("/auth/tenant/reset-password", {
+            projectId,
+            email,
+            token,
+            newPassword,
+        });
+        return data;
+    }
+
+    /**
+     * Obtém o perfil do usuário autenticado.
+     * Requer que login() tenha sido chamado antes.
+     * 
+     * @param projectId - ID do projeto (opcional, usa do token se não fornecido)
+     */
+    async getProfile(projectId?: string): Promise<TenantUser> {
+        const headers = this.currentToken
+            ? { Authorization: `Bearer ${this.currentToken}` }
+            : {};
+
+        const { data } = await this.http.get<{ user: TenantUser }>(
+            "/auth/tenant/me",
+            { headers }
+        );
+
+        this.currentUser = data.user;
+        return data.user;
+    }
+
+    /**
+     * Atualiza o perfil do usuário autenticado.
+     * 
+     * @param projectId - ID do projeto
+     * @param updates - Campos a atualizar (name, data)
+     */
+    async updateProfile(
+        projectId: string,
+        updates: { name?: string; data?: Record<string, any> }
+    ): Promise<{ user: TenantUser; message: string }> {
+        const headers = this.currentToken
+            ? { Authorization: `Bearer ${this.currentToken}` }
+            : {};
+
+        const { data } = await this.http.put(
+            "/auth/tenant/profile",
+            {
+                projectId,
+                ...updates,
+            },
+            { headers }
+        );
+
+        this.currentUser = data.user;
+        return data;
+    }
+
+    /**
+     * Faz logout do tenant (limpa token local).
+     */
+    logout(): void {
+        this.currentToken = null;
+        this.currentUser = null;
+    }
+
+    // ==========================================================================
+    // MÉTODOS ESTILO SUPABASE/FIREBASE
+    // ==========================================================================
+
+    /**
+     * Alias para register com retorno { user, error }
+     */
+    async signUp(
+        projectId: string,
+        credentials: TenantRegisterCredentials
+    ): Promise<{ user: TenantUser | null; error: string | null }> {
+        try {
+            const { user } = await this.register(projectId, credentials);
+            return { user, error: null };
+        } catch (err: any) {
+            const axiosError = err as AxiosError<{ error?: string; message?: string }>;
+            return {
+                user: null,
+                error:
+                    axiosError.response?.data?.error ||
+                    axiosError.response?.data?.message ||
+                    err.message,
+            };
+        }
+    }
+
+    /**
+     * Alias para login com retorno { user, accessToken, error }
+     */
+    async signIn(
+        projectId: string,
+        credentials: TenantLoginCredentials
+    ): Promise<{
+        user: TenantUser | null;
+        accessToken: string | null;
+        error: string | null;
+    }> {
+        try {
+            const { user, accessToken } = await this.login(projectId, credentials);
+            return { user, accessToken, error: null };
+        } catch (err: any) {
+            const axiosError = err as AxiosError<{ error?: string; message?: string }>;
+            return {
+                user: null,
+                accessToken: null,
+                error:
+                    axiosError.response?.data?.error ||
+                    axiosError.response?.data?.message ||
+                    err.message,
+            };
+        }
+    }
+
+    /**
+     * Alias para logout
+     */
+    signOut(): void {
+        this.logout();
+    }
+
+    // ==========================================================================
+    // ACCESSORS
+    // ==========================================================================
+
+    /**
+     * Retorna o token atual do tenant
+     */
+    getToken(): string | null {
+        return this.currentToken;
+    }
+
+    /**
+     * Define o token do tenant (útil para restaurar sessão)
+     */
+    setToken(token: string | null): void {
+        this.currentToken = token;
+    }
+
+    /**
+     * Retorna o usuário atual do tenant
+     */
+    getCurrentUser(): TenantUser | null {
+        return this.currentUser;
+    }
+
+    /**
+     * Verifica se há um usuário autenticado
+     */
+    isAuthenticated(): boolean {
+        return this.currentToken !== null;
+    }
+}