mitra-interactions-sdk 1.0.56-beta.1 → 1.0.56

package/README.md

@@ -206,6 +206,33 @@ await executeDbActionMitra({ dbActionId: 1 });
 
 > **Nota:** `authUrl` e `projectId` são opcionais em todas as funções de email se já foram configurados via `configureSdkMitra()`.
 
+### Reset de Senha (esqueci minha senha)
+
+Endpoints públicos (sem token) para o fluxo de "esqueci minha senha":
+
+```typescript
+import {
+  sendPasswordResetCodeMitra,
+  validatePasswordResetCodeMitra,
+  resetPasswordMitra,
+  emailLoginMitra
+} from 'mitra-interactions-sdk';
+
+// 1. Envia código de 6 dígitos por email
+await sendPasswordResetCodeMitra({ email });
+
+// 2. (opcional) Valida o código antes de pedir a senha nova
+await validatePasswordResetCodeMitra({ email, code: '123456' });
+
+// 3. Troca a senha
+await resetPasswordMitra({ email, code: '123456', newPassword: 'novaSenha' });
+
+// 4. Login com a nova senha
+await emailLoginMitra({ email, password: 'novaSenha' });
+```
+
+> **Nota:** `projectId` é opcional se já configurado via `configureSdkMitra()`.
+
 ## Métodos Disponíveis
 
 ### executeServerFunctionMitra

package/dist/index.d.mts

@@ -5,7 +5,7 @@ interface LoginOptions {
     /** URL da página de autenticação Mitra (ex: https://coder.mitralab.io/sdk-auth/). Opcional se já configurado via configureSdkMitra. */
     authUrl?: string;
     /** ID do projeto. Opcional se já configurado via configureSdkMitra. */
-    projectId?: number | string;
+    projectId?: number;
     /** Modo de login: 'popup' (default) abre popup, 'redirect' navega para a página de auth. */
     mode?: 'popup' | 'redirect';
     /** URL de retorno após login com mode 'redirect'. A página de auth redirecionará de volta para esta URL com token nos query params. */
@@ -18,8 +18,6 @@ interface LoginOptions {
 interface LoginResponse {
     /** Token JWT (já com prefixo Bearer) */
     token: string;
-    /** Refresh token (novo Mitra). Presente apenas no novo mundo. */
-    refreshToken?: string;
     /** URL base da API */
     baseURL: string;
     /** URL do serviço de integrações (opcional) */
@@ -29,7 +27,7 @@ interface EmailSignupOptions {
     /** URL da página de auth (ex: https://validacao.mitralab.io/sdk-auth/). Opcional se já configurado via configureSdkMitra. */
     authUrl?: string;
     /** ID do projeto. Opcional se já configurado via configureSdkMitra. */
-    projectId?: number | string;
+    projectId?: number;
     /** Nome completo do usuário */
     name: string;
     /** Email do usuário */
@@ -41,7 +39,7 @@ interface EmailLoginOptions {
     /** URL da página de auth (ex: https://validacao.mitralab.io/sdk-auth/). Opcional se já configurado via configureSdkMitra. */
     authUrl?: string;
     /** ID do projeto. Opcional se já configurado via configureSdkMitra. */
-    projectId?: number | string;
+    projectId?: number;
     /** Email do usuário */
     email: string;
     /** Senha */
@@ -51,7 +49,7 @@ interface EmailVerifyCodeOptions {
     /** URL da página de auth. Opcional se já configurado via configureSdkMitra. */
     authUrl?: string;
     /** ID do projeto. Opcional se já configurado via configureSdkMitra. */
-    projectId?: number | string;
+    projectId?: number;
     /** Email do usuário */
     email: string;
     /** Código de verificação de 6 dígitos */
@@ -63,13 +61,15 @@ interface EmailResendCodeOptions {
     /** URL da página de auth. Opcional se já configurado via configureSdkMitra. */
     authUrl?: string;
     /** ID do projeto. Opcional se já configurado via configureSdkMitra. */
-    projectId?: number | string;
+    projectId?: number;
     /** Email do usuário */
     email: string;
 }
 interface SendPasswordResetCodeOptions {
     /** Email do usuário que esqueceu a senha */
     email: string;
+    /** ID do projeto. Default: do config global. */
+    projectId?: number | string;
     /** URL da página de auth (opcional — usado pra derivar a API base). Default: do config global. */
     authUrl?: string;
     /** Override explícito da API base (ex: https://api0.mitraecp.com:1005). Default: derivado do authUrl. */
@@ -79,6 +79,7 @@ interface ValidatePasswordResetCodeOptions {
     email: string;
     /** Código de 6 dígitos recebido por email */
     code: string;
+    projectId?: number | string;
     authUrl?: string;
     authApiURL?: string;
 }
@@ -88,18 +89,19 @@ interface ResetPasswordOptions {
     code: string;
     /** Nova senha */
     newPassword: string;
+    projectId?: number | string;
     authUrl?: string;
     authApiURL?: string;
 }
 interface ExecuteDataLoaderOptions {
-    projectId?: number | string;
-    dataLoaderId: number | string;
+    projectId?: number;
+    dataLoaderId: number;
     input?: Record<string, unknown>;
 }
 interface ExecuteDataLoaderResponse {
     status: string;
     result: {
-        dataLoaderId: number | string;
+        dataLoaderId: number;
         executionLog: {
             timestamp: string;
             rowCount: number;
@@ -113,9 +115,9 @@ interface ExecuteDataLoaderResponse {
 }
 interface ExecuteDbActionOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** ID da DBAction cadastrada */
-    dbActionId: number | string;
+    dbActionId: number;
     /** Parâmetros de entrada (opcional) — substituição de variáveis no SQL (ex: { "nome": "João" } substitui :nome) */
     input?: Record<string, unknown>;
 }
@@ -127,7 +129,7 @@ interface ExecuteDbActionResponse {
 }
 interface SetFileStatusOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** Nome do arquivo */
     fileName: string;
     /** Caminho de destino: "PUBLIC" ou "LOADABLE" */
@@ -144,7 +146,7 @@ interface SetFileStatusResponse {
 }
 interface SetVariableOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** Nome da variável (key) */
     key: string;
     /** Valor da variável (opcional) */
@@ -159,9 +161,9 @@ interface SetVariableResponse {
 }
 interface ExecuteServerFunctionOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** ID da Server Function cadastrada */
-    serverFunctionId: number | string;
+    serverFunctionId: number;
     /** Objeto de entrada para a função (opcional) */
     input?: Record<string, unknown>;
 }
@@ -178,9 +180,9 @@ interface ExecuteServerFunctionResponse {
 }
 interface ExecuteServerFunctionAsyncOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** ID da Server Function cadastrada */
-    serverFunctionId: number | string;
+    serverFunctionId: number;
     /** Objeto de entrada para a função (opcional) */
     input?: Record<string, unknown>;
 }
@@ -193,9 +195,9 @@ interface ExecuteServerFunctionAsyncResponse {
 }
 interface ExecutePublicServerFunctionOptions {
     /** ID do projeto (tenant) */
-    projectId: number | string;
+    projectId: number;
     /** ID da Server Function (deve ter publicExecution = true) */
-    serverFunctionId: number | string;
+    serverFunctionId: number;
     /** Objeto de entrada para a função (opcional) */
     input?: Record<string, unknown>;
 }
@@ -212,7 +214,7 @@ interface ExecutePublicServerFunctionAsyncResponse {
     status: string;
 }
 interface GetPublicServerFunctionExecutionOptions {
-    projectId: number | string;
+    projectId: number;
     executionId: string;
 }
 interface GetPublicServerFunctionExecutionResponse {
@@ -231,54 +233,54 @@ interface ListRecordsResponse {
     totalPages: number;
 }
 interface ListRecordsOptions {
-    projectId?: number | string;
+    projectId?: number;
     tableName: string;
     page?: number;
     size?: number;
     filters?: Record<string, unknown>;
-    jdbcConnectionConfigId?: number | string;
+    jdbcConnectionConfigId?: number;
 }
 interface GetRecordOptions {
-    projectId?: number | string;
+    projectId?: number;
     tableName: string;
-    id: number | string;
-    jdbcConnectionConfigId?: number | string;
+    id: number;
+    jdbcConnectionConfigId?: number;
 }
 interface CreateRecordOptions {
-    projectId?: number | string;
+    projectId?: number;
     tableName: string;
     data: Record<string, unknown>;
-    jdbcConnectionConfigId?: number | string;
+    jdbcConnectionConfigId?: number;
 }
 interface UpdateRecordOptions {
-    projectId?: number | string;
+    projectId?: number;
     tableName: string;
-    id: number | string;
+    id: number;
     data: Record<string, unknown>;
-    jdbcConnectionConfigId?: number | string;
+    jdbcConnectionConfigId?: number;
 }
 interface PatchRecordOptions {
-    projectId?: number | string;
+    projectId?: number;
     tableName: string;
-    id: number | string;
+    id: number;
     data: Record<string, unknown>;
-    jdbcConnectionConfigId?: number | string;
+    jdbcConnectionConfigId?: number;
 }
 interface DeleteRecordOptions {
-    projectId?: number | string;
+    projectId?: number;
     tableName: string;
-    id: number | string;
-    jdbcConnectionConfigId?: number | string;
+    id: number;
+    jdbcConnectionConfigId?: number;
 }
 interface CreateRecordsBatchOptions {
-    projectId?: number | string;
+    projectId?: number;
     tableName: string;
     records: Record<string, unknown>[];
-    jdbcConnectionConfigId?: number | string;
+    jdbcConnectionConfigId?: number;
 }
 interface UploadFileOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** Arquivo a ser enviado (File ou Blob) */
     file: File | Blob;
     /** Habilitar debug (opcional) */
@@ -295,11 +297,11 @@ interface UploadFileResponse {
 }
 interface ListVariablesOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
 }
 interface ListVariablesResponse {
     status: string;
-    projectId: number | string;
+    projectId: number;
     result: {
         key: string;
         value: string;
@@ -307,7 +309,7 @@ interface ListVariablesResponse {
 }
 interface GetVariableOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** Nome da variável (com ou sem :VAR_) */
     key: string;
 }
@@ -320,9 +322,9 @@ interface GetVariableResponse {
 }
 interface RunActionOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** ID da Action a executar */
-    actionId: number | string;
+    actionId: number;
     /** Parâmetros de entrada para a action (opcional) */
     input?: Record<string, unknown>;
 }
@@ -336,7 +338,7 @@ interface RunActionResponse {
 }
 interface CallIntegrationOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** Slug da integração configurada no painel */
     connection: string;
     /** Método HTTP: GET, POST, PUT, DELETE */
@@ -356,11 +358,11 @@ interface CallIntegrationResponse {
 }
 interface ListIntegrationsOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
 }
 interface IntegrationResponse {
     id: string;
-    projectId: number | string;
+    projectId: number;
     name: string;
     slug: string;
     blueprintId: string | null;
@@ -374,7 +376,7 @@ interface IntegrationResponse {
 }
 interface StopServerFunctionExecutionOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
-    projectId?: number | string;
+    projectId?: number;
     /** ID da execução a ser parada */
     executionId: string;
 }
@@ -386,87 +388,87 @@ interface StopServerFunctionExecutionResponse {
     };
 }
 interface ListProfilesOptions {
-    projectId?: number | string;
+    projectId?: number;
 }
 interface ListProfilesResponse {
     status: string;
-    projectId: number | string;
+    projectId: number;
     result: {
-        id: number | string;
+        id: number;
         name: string;
         color: string;
-        homeScreenId: number | string;
+        homeScreenId: number;
     }[];
 }
 interface GetProfileDetailsOptions {
-    projectId?: number | string;
-    profileId: number | string;
+    projectId?: number;
+    profileId: number;
 }
 interface GetProfileDetailsResponse {
     status: string;
-    projectId: number | string;
+    projectId: number;
     result: {
-        id: number | string;
+        id: number;
         name: string;
         users: {
-            id: number | string;
+            id: number;
             name: string;
             email: string;
         }[];
         selectTables: {
             tableName: string;
-            jdbcConnectionConfigId?: number | string;
+            jdbcConnectionConfigId?: number;
         }[];
         dmlTables: {
             tableName: string;
-            jdbcConnectionConfigId?: number | string;
+            jdbcConnectionConfigId?: number;
         }[];
         actions: {
-            id: number | string;
+            id: number;
             name: string;
         }[];
         screens: {
-            id: number | string;
+            id: number;
             name: string;
         }[];
         serverFunctions: {
-            id: number | string;
+            id: number;
             name: string;
         }[];
     };
 }
 interface CreateProfileOptions {
-    projectId?: number | string;
+    projectId?: number;
     name: string;
     color?: string;
-    homeScreenId?: number | string;
+    homeScreenId?: number;
 }
 interface CreateProfileResponse {
     status: string;
     result: {
-        id: number | string;
+        id: number;
         name: string;
         message: string;
     };
 }
 interface UpdateProfileOptions {
-    projectId?: number | string;
-    profileId: number | string;
+    projectId?: number;
+    profileId: number;
     name?: string;
     color?: string;
-    homeScreenId?: number | string;
+    homeScreenId?: number;
 }
 interface UpdateProfileResponse {
     status: string;
     result: {
-        id: number | string;
+        id: number;
         name: string;
         message: string;
     };
 }
 interface DeleteProfileOptions {
-    projectId?: number | string;
-    profileId: number | string;
+    projectId?: number;
+    profileId: number;
 }
 interface DeleteProfileResponse {
     status: string;
@@ -475,44 +477,44 @@ interface DeleteProfileResponse {
     };
 }
 interface SetProfileUsersOptions {
-    projectId?: number | string;
-    profileId: number | string;
+    projectId?: number;
+    profileId: number;
     userIds: number[];
 }
 interface ProfileTableRef {
     tableName: string;
 }
 interface SetProfileSelectTablesOptions {
-    projectId?: number | string;
-    profileId: number | string;
-    jdbcConnectionConfigId?: number | string;
+    projectId?: number;
+    profileId: number;
+    jdbcConnectionConfigId?: number;
     tables: ProfileTableRef[];
 }
 interface SetProfileDmlTablesOptions {
-    projectId?: number | string;
-    profileId: number | string;
-    jdbcConnectionConfigId?: number | string;
+    projectId?: number;
+    profileId: number;
+    jdbcConnectionConfigId?: number;
     tables: ProfileTableRef[];
 }
 interface SetProfileActionsOptions {
-    projectId?: number | string;
-    profileId: number | string;
+    projectId?: number;
+    profileId: number;
     actionIds: number[];
 }
 interface SetProfileScreensOptions {
-    projectId?: number | string;
-    profileId: number | string;
+    projectId?: number;
+    profileId: number;
     screenIds: number[];
 }
 interface SetProfileServerFunctionsOptions {
-    projectId?: number | string;
-    profileId: number | string;
+    projectId?: number;
+    profileId: number;
     serverFunctionIds: number[];
 }
 interface SetProfilePermissionResponse {
     status: string;
     result: {
-        profileId: number | string;
+        profileId: number;
         message: string;
         [key: string]: unknown;
     };
@@ -574,14 +576,12 @@ interface MitraConfig {
     baseURL: string;
     /** Token JWT para autenticação (opcional para Server Functions públicas) */
     token?: string;
-    /** Refresh token (novo Mitra). Necessário para refresh automático no novo mundo. */
-    refreshToken?: string;
     /** URL base do serviço de integrações (ex: https://api0.mitraecp.com:1003) */
     integrationURL?: string;
     /** URL da página de autenticação Mitra (ex: https://coder.mitralab.io/sdk-auth/) */
     authUrl?: string;
     /** ID do projeto (usado como fallback nos métodos de login e serviços) */
-    projectId?: number | string;
+    projectId?: number;
     /** Callback chamado quando o token é renovado automaticamente (após 401/403). Recebe a nova sessão. */
     onTokenRefresh?: (session: LoginResponse) => void;
 }
@@ -596,7 +596,7 @@ declare function getConfig(): MitraConfig;
 /**
  * Resolve projectId: usa o valor passado, senão pega do config salvo.
  */
-declare function resolveProjectId(projectId?: number | string): number | string;
+declare function resolveProjectId(projectId?: number): number;
 
 /**
  * Mitra Interactions SDK - Chat Integration
@@ -615,24 +615,56 @@ declare function openChatMitra(): void;
 declare function closeChatMitra(): void;
 
 /**
- * Mitra Interactions SDK - Autenticação (Router)
+ * Mitra Interactions SDK - Autenticação
  *
- * Roteia chamadas de auth para a implementação correta com base no `authUrl`:
- * - URLs legadas (`coder.mitralab.io/sdk-auth/`, `agent.mitralab.io/sdk-auth/`) → auth-legacy.ts
- * - Qualquer outro authUrl → auth-new.ts (novo Mitra: Kong gateway + IAM service)
- *
- * A API pública é idêntica à legacy. Consumers não precisam alterar código.
+ * Login via popup seguro hospedado no domínio Mitra.
+ * Credenciais nunca passam pelo código do desenvolvedor.
  */
 
-declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra', options?: LoginOptions): Promise<LoginResponse>;
+/**
+ * Login com email e senha via popup/redirect seguro Mitra.
+ */
 declare function loginWithEmailMitra(options?: LoginOptions): Promise<LoginResponse>;
+/**
+ * Login com Google via popup/redirect seguro Mitra.
+ */
 declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResponse>;
+/**
+ * Login com Microsoft via popup/redirect seguro Mitra.
+ */
 declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginResponse>;
+/**
+ * Login genérico via popup/redirect seguro Mitra.
+ */
+declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra', options?: LoginOptions): Promise<LoginResponse>;
+/**
+ * Renova o token silenciosamente via iframe invisível.
+ * Se já houver um refresh em andamento, reaproveita a mesma promise.
+ */
+declare function refreshTokenSilently(authUrl: string, projectId: number): Promise<LoginResponse>;
+/**
+ * Cria conta via email usando iframe silencioso.
+ * Após sucesso, o usuário recebe um código de verificação por email.
+ * Fluxo: emailSignupMitra → emailVerifyCodeMitra → emailLoginMitra
+ */
 declare function emailSignupMitra(options: EmailSignupOptions): Promise<void>;
-declare function emailLoginMitra(options: EmailLoginOptions): Promise<LoginResponse>;
+/**
+ * Verifica o código de 6 dígitos enviado por email após signup.
+ * Após verificação, faz login automático e retorna LoginResponse.
+ * Auto-configura o SDK após sucesso.
+ */
 declare function emailVerifyCodeMitra(options: EmailVerifyCodeOptions): Promise<LoginResponse>;
+/**
+ * Reenvia o código de verificação para o email.
+ */
 declare function emailResendCodeMitra(options: EmailResendCodeOptions): Promise<void>;
-declare function refreshTokenSilently(authUrl: string, projectId: number | string): Promise<LoginResponse>;
+/**
+ * Login via email e senha usando iframe silencioso.
+ * O HTML de auth faz a chamada à API e resolve as credenciais do projeto.
+ * Retorna LoginResponse com token, baseURL e integrationURL.
+ * Auto-configura o SDK após sucesso.
+ */
+declare function emailLoginMitra(options: EmailLoginOptions): Promise<LoginResponse>;
 
 /**
  * Mitra Interactions SDK - Password Reset (legacy backend)