mitra-interactions-sdk 1.0.30 → 1.0.32

package/README.md

@@ -21,45 +21,113 @@ Antes de usar qualquer função, configure o SDK com seu token da plataforma Mit
 ```typescript
 import { configureSdkMitra } from 'mitra-interactions-sdk';
 
-configureSdkMitra({
+const instance = configureSdkMitra({
   baseURL: process.env.MITRA_BASE_URL || 'https://api.mitra.com',
-  token: process.env.MITRA_TOKEN!
+  token: process.env.MITRA_TOKEN!,
+  authUrl: 'https://coder.mitralab.io/sdk-auth/',       // Opcional — necessário para login e token refresh
+  projectId: 123,                                        // Opcional — se informado, torna projectId opcional em TODOS os métodos
+  integrationURL: 'https://api0.mitraecp.com:1003',     // Opcional — necessário para integrações
+  onTokenRefresh: (session) => {                         // Opcional — chamado quando o token é renovado automaticamente
+    localStorage.setItem('mitra_session', JSON.stringify(session));
+  }
 });
 ```
 
-Exemplo de `.env`:
-```
-MITRA_BASE_URL=https://api.mitra.com
-MITRA_TOKEN=seu-jwt-token-da-plataforma-mitra
+> **`projectId` global:** Se você passar `projectId` no `configureSdkMitra`, ele será usado como fallback em **todos** os métodos do SDK. Assim, não é necessário passar `projectId` em cada chamada individual — basta configurar uma vez.
+
+`configureSdkMitra` retorna uma `MitraInstance` que também pode ser usada diretamente:
+
+```typescript
+await instance.executeDbAction({ dbActionId: 456 });  // projectId já vem do configureSdkMitra
 ```
 
 ## Autenticação (Login)
 
-Login via popup seguro hospedado no domínio Mitra. Credenciais nunca passam pelo código do desenvolvedor. O SDK é **auto-configurado** após o login.
+Login via popup ou redirect seguro hospedado no domínio Mitra. Credenciais nunca passam pelo código do desenvolvedor. O SDK é **auto-configurado** após o login.
+
+> **Nota:** `authUrl` e `projectId` são **obrigatórios** para login. Porém, se já foram passados no `configureSdkMitra()`, não é necessário repeti-los — o SDK usa os valores configurados como fallback.
+
+### Login via Popup (padrão)
 
 ```typescript
 import { loginMitra } from 'mitra-interactions-sdk';
 
-// Login com email e senha
+// Primeira vez — sem configureSdkMitra: authUrl e projectId são obrigatórios
 const result = await loginMitra('email', {
   authUrl: 'https://coder.mitralab.io/sdk-auth/',
   projectId: 123
 });
 
-// Login com Google
-const result = await loginMitra('google', {
-  authUrl: 'https://coder.mitralab.io/sdk-auth/',
-  projectId: 123
+// Se já chamou configureSdkMitra({ authUrl, projectId }), basta:
+const result = await loginMitra('google');
+const result = await loginMitra('microsoft');
+
+// result: { token, baseURL, integrationURL? }
+```
+
+### Login via Redirect
+
+Navega o usuário para a página de auth. Após o login, redireciona de volta com token nos query params.
+
+```typescript
+import { loginMitra, handleAuthRedirect } from 'mitra-interactions-sdk';
+
+// Iniciar login — o navegador navega para fora da página
+await loginMitra('google', {
+  mode: 'redirect',
+  returnTo: '/dashboard'   // Opcional — URL de retorno após login (default: página atual). Só funciona com mode 'redirect'.
 });
+```
 
-// Login com Microsoft
-const result = await loginMitra('microsoft', {
-  authUrl: 'https://coder.mitralab.io/sdk-auth/',
-  projectId: 123
+### Fluxo de Criar Conta
+
+```typescript
+// create funciona tanto em popup quanto redirect
+await loginMitra('email', { create: true });
+
+await loginMitra('email', {
+  mode: 'redirect',
+  create: true,
+  returnTo: '/onboarding'
 });
+```
 
-// authUrl e projectId são opcionais se já configurados via configureSdkMitra()
-// result: { token, baseURL, integrationURL? }
+### Processar Retorno do Redirect
+
+Após o redirect, a página de destino deve chamar `handleAuthRedirect()` para capturar o token:
+
+```typescript
+import { handleAuthRedirect, configureSdkMitra } from 'mitra-interactions-sdk';
+
+// No mounted/onLoad da página de retorno
+const session = handleAuthRedirect();
+if (session) {
+  // Login OK — session: { token, baseURL, integrationURL? }
+  configureSdkMitra({
+    baseURL: session.baseURL,
+    token: session.token,
+    integrationURL: session.integrationURL
+  });
+}
+```
+
+### Token Refresh Automático
+
+Quando qualquer requisição retorna **403**, o SDK tenta renovar o token automaticamente via iframe invisível (usa o cookie de sessão do provider). Se o refresh funcionar, a requisição é retentada com o novo token — transparente para o desenvolvedor.
+
+O callback `onTokenRefresh` é chamado após renovação bem-sucedida:
+
+```typescript
+configureSdkMitra({
+  baseURL: '...',
+  token: '...',
+  authUrl: 'https://coder.mitralab.io/sdk-auth/',
+  projectId: 123,
+  onTokenRefresh: (session) => {
+    // Atualiza o token salvo (ex: localStorage, store, etc.)
+    localStorage.setItem('mitra_token', session.token);
+  }
+});
 ```
 
 ## Métodos Disponíveis
@@ -142,7 +210,47 @@ Lista as integrações configuradas no projeto.
 import { listIntegrationsMitra } from 'mitra-interactions-sdk';
 
 const integrations = await listIntegrationsMitra({ projectId: 123 });
-// result: IntegrationResponse[] — [{ id (UUID), projectId, name, slug, blueprintId, blueprintType, authType, credentials, status, lastCheckedAt, createdAt, updatedAt }]
+// result: IntegrationResponse[] — [{ id, projectId, name, slug, blueprintId, blueprintType, authType, credentials, status, lastCheckedAt, createdAt, updatedAt }]
+```
+
+#### callIntegrationMitra
+
+Chama uma integração configurada, delegando a requisição ao serviço externo.
+
+```typescript
+import { callIntegrationMitra } from 'mitra-interactions-sdk';
+
+const result = await callIntegrationMitra({
+  projectId: 123,
+  connection: 'meu-erp',        // Slug da integração
+  method: 'GET',                 // GET, POST, PUT, DELETE
+  endpoint: '/api/v1/pedidos',   // Path no serviço externo (opcional)
+  params: { status: 'ativo' },   // Query params (opcional)
+  body: { nome: 'Teste' }        // Body para POST/PUT (opcional)
+});
+// result: { statusCode: number, body: any }
+```
+
+### uploadFilePublicMitra / uploadFileLoadableMitra
+
+Faz upload de um arquivo diretamente para a pasta PUBLIC ou LOADABLE do projeto. Usa `multipart/form-data`.
+
+```typescript
+import { uploadFilePublicMitra, uploadFileLoadableMitra } from 'mitra-interactions-sdk';
+
+// Upload para PUBLIC (arquivo fica acessível publicamente via URL)
+const result = await uploadFilePublicMitra({
+  projectId: 123,
+  file: fileInput.files[0]   // File ou Blob
+});
+// result: { status, result: { fileName, currentPath, publicUrl, message } }
+
+// Upload para LOADABLE (arquivo disponível para carga via Spark/ETL)
+const result2 = await uploadFileLoadableMitra({
+  projectId: 123,
+  file: myBlob
+});
+// result2: { status, result: { fileName, currentPath, publicUrl: null, message } }
 ```
 
 ### setFileStatusMitra
@@ -280,6 +388,8 @@ import type {
   ExecuteServerFunctionOptions,
   ExecuteServerFunctionAsyncOptions,
   ListIntegrationsOptions,
+  CallIntegrationOptions,
+  UploadFileOptions,
   StopServerFunctionExecutionOptions,
   SetFileStatusOptions,
   SetVariableOptions,
@@ -303,6 +413,8 @@ import type {
   ExecuteServerFunctionResponse,
   ExecuteServerFunctionAsyncResponse,
   IntegrationResponse,
+  CallIntegrationResponse,
+  UploadFileResponse,
   StopServerFunctionExecutionResponse,
   ListRecordsResponse
 } from 'mitra-interactions-sdk';

package/dist/index.d.mts

@@ -2,10 +2,16 @@
  * Mitra Interactions SDK - Types
  */
 interface LoginOptions {
-    /** URL da página de autenticação Mitra (ex: https://validacao.mitralab.io/auth/). Opcional se já configurado via configureSdkMitra. */
+    /** 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;
+    /** 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. */
+    returnTo?: string;
+    /** Se true, abre o fluxo de criar conta em vez de login. */
+    create?: boolean;
 }
 interface LoginResponse {
     /** Token JWT (já com prefixo Bearer) */
@@ -163,6 +169,23 @@ interface CreateRecordsBatchOptions {
     records: Record<string, unknown>[];
     jdbcConnectionConfigId?: number;
 }
+interface UploadFileOptions {
+    /** ID do projeto (opcional se já configurado via configureSdkMitra) */
+    projectId?: number;
+    /** Arquivo a ser enviado (File ou Blob) */
+    file: File | Blob;
+    /** Habilitar debug (opcional) */
+    debug?: boolean;
+}
+interface UploadFileResponse {
+    status: string;
+    result: {
+        fileName: string;
+        currentPath: string;
+        publicUrl: string | null;
+        message: string;
+    };
+}
 interface ListVariablesOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
     projectId?: number;
@@ -264,10 +287,6 @@ interface StopServerFunctionExecutionResponse {
 
 interface MitraInstance {
     readonly config: MitraConfig;
-    login(method: 'email' | 'google' | 'microsoft', options?: LoginOptions): Promise<MitraInstance>;
-    loginWithEmail(options?: LoginOptions): Promise<MitraInstance>;
-    loginWithGoogle(options?: LoginOptions): Promise<MitraInstance>;
-    loginWithMicrosoft(options?: LoginOptions): Promise<MitraInstance>;
     runQuery(options: RunQueryOptions): Promise<RunQueryResponse>;
     executeDbAction(options: ExecuteDbActionOptions): Promise<ExecuteDbActionResponse>;
     setFileStatus(options: SetFileStatusOptions): Promise<SetFileStatusResponse>;
@@ -278,6 +297,8 @@ interface MitraInstance {
     executeServerFunction(options: ExecuteServerFunctionOptions): Promise<ExecuteServerFunctionResponse>;
     executeServerFunctionAsync(options: ExecuteServerFunctionAsyncOptions): Promise<ExecuteServerFunctionAsyncResponse>;
     stopServerFunctionExecution(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
+    uploadFilePublic(options: UploadFileOptions): Promise<UploadFileResponse>;
+    uploadFileLoadable(options: UploadFileOptions): Promise<UploadFileResponse>;
     listIntegrations(options?: ListIntegrationsOptions): Promise<IntegrationResponse[]>;
     callIntegration(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
     listRecords(options: ListRecordsOptions): Promise<ListRecordsResponse>;
@@ -290,10 +311,6 @@ interface MitraInstance {
 }
 declare function createMitraInstance(initialConfig: Partial<MitraConfig>): MitraInstance;
 
-/**
- * Mitra Interactions SDK - Configuração
- */
-
 interface MitraConfig {
     /** URL base da API (ex: https://api.mitra.com) */
     baseURL: string;
@@ -301,10 +318,12 @@ interface MitraConfig {
     token: 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/auth/) */
+    /** 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;
+    /** Callback chamado quando o token é renovado automaticamente (após 401/403). Recebe a nova sessão. */
+    onTokenRefresh?: (session: LoginResponse) => void;
 }
 /**
  * Configura o SDK globalmente e retorna uma instância configurada.
@@ -327,31 +346,39 @@ declare function resolveProjectId(projectId?: number): number;
  */
 
 /**
- * Login com email e senha via popup seguro Mitra.
- *
- * authUrl e projectId são opcionais se já configurados via configureSdkMitra().
- * Se passados, sobrescrevem os valores salvos.
+ * Login com email e senha via popup/redirect seguro Mitra.
  */
 declare function loginWithEmailMitra(options?: LoginOptions): Promise<LoginResponse>;
 /**
- * Login com Google via popup seguro Mitra.
- *
- * authUrl e projectId são opcionais se já configurados via configureSdkMitra().
- * Se passados, sobrescrevem os valores salvos.
+ * Login com Google via popup/redirect seguro Mitra.
  */
 declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResponse>;
 /**
- * Login com Microsoft via popup seguro Mitra.
- *
- * authUrl e projectId são opcionais se já configurados via configureSdkMitra().
- * Se passados, sobrescrevem os valores salvos.
+ * Login com Microsoft via popup/redirect seguro Mitra.
  */
 declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginResponse>;
 /**
- * Login genérico via popup seguro Mitra.
- * Recebe o método de login como string e delega para a função correspondente.
+ * Login genérico via popup/redirect seguro Mitra.
  */
 declare function loginMitra(method: 'email' | 'google' | 'microsoft', options?: LoginOptions): Promise<LoginResponse>;
+/**
+ * Processa o retorno de um login com mode 'redirect'.
+ *
+ * Após o redirect, a página de auth redireciona de volta com query params:
+ *   ?tokenMitra={token}&backURLMitra={baseURL}&integrationURLMitra={integrationURL}
+ *
+ * Esta função:
+ * - Lê os query params da URL atual
+ * - Se `tokenMitra=error`, lança erro
+ * - Se encontrou tokens, limpa a URL e retorna LoginResponse
+ * - Se não encontrou nada, retorna null
+ */
+declare function handleAuthRedirect(): LoginResponse | null;
+/**
+ * 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>;
 
 /**
  * Mitra Interactions SDK - Services
@@ -418,6 +445,16 @@ declare function callIntegrationMitra(options: CallIntegrationOptions): Promise<
  * Para a execução de uma Server Function em andamento
  */
 declare function stopServerFunctionExecutionMitra(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
+/**
+ * POST /agentAiShortcut/uploadFilePublic (multipart/form-data)
+ * Faz upload de um arquivo para a pasta PUBLIC do projeto.
+ */
+declare function uploadFilePublicMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
+/**
+ * POST /agentAiShortcut/uploadFileLoadable (multipart/form-data)
+ * Faz upload de um arquivo para a pasta LOADABLE do projeto.
+ */
+declare function uploadFileLoadableMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
 declare function listRecordsMitra(options: ListRecordsOptions): Promise<ListRecordsResponse>;
 declare function getRecordMitra(options: GetRecordOptions): Promise<Record<string, any>>;
 declare function createRecordMitra(options: CreateRecordOptions): Promise<Record<string, any>>;
@@ -426,4 +463,4 @@ declare function patchRecordMitra(options: PatchRecordOptions): Promise<Record<s
 declare function deleteRecordMitra(options: DeleteRecordOptions): Promise<void>;
 declare function createRecordsBatchMitra(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
 
-export { type CallIntegrationOptions, type CallIntegrationResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteRecordOptions, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type RunActionOptions, type RunActionResponse, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, getVariableMitra, listIntegrationsMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, resolveProjectId, runActionMitra, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra };
+export { type CallIntegrationOptions, type CallIntegrationResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteRecordOptions, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type RunActionOptions, type RunActionResponse, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, getVariableMitra, handleAuthRedirect, listIntegrationsMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, runActionMitra, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra };

package/dist/index.d.ts

@@ -2,10 +2,16 @@
  * Mitra Interactions SDK - Types
  */
 interface LoginOptions {
-    /** URL da página de autenticação Mitra (ex: https://validacao.mitralab.io/auth/). Opcional se já configurado via configureSdkMitra. */
+    /** 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;
+    /** 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. */
+    returnTo?: string;
+    /** Se true, abre o fluxo de criar conta em vez de login. */
+    create?: boolean;
 }
 interface LoginResponse {
     /** Token JWT (já com prefixo Bearer) */
@@ -163,6 +169,23 @@ interface CreateRecordsBatchOptions {
     records: Record<string, unknown>[];
     jdbcConnectionConfigId?: number;
 }
+interface UploadFileOptions {
+    /** ID do projeto (opcional se já configurado via configureSdkMitra) */
+    projectId?: number;
+    /** Arquivo a ser enviado (File ou Blob) */
+    file: File | Blob;
+    /** Habilitar debug (opcional) */
+    debug?: boolean;
+}
+interface UploadFileResponse {
+    status: string;
+    result: {
+        fileName: string;
+        currentPath: string;
+        publicUrl: string | null;
+        message: string;
+    };
+}
 interface ListVariablesOptions {
     /** ID do projeto (opcional se já configurado via configureSdkMitra) */
     projectId?: number;
@@ -264,10 +287,6 @@ interface StopServerFunctionExecutionResponse {
 
 interface MitraInstance {
     readonly config: MitraConfig;
-    login(method: 'email' | 'google' | 'microsoft', options?: LoginOptions): Promise<MitraInstance>;
-    loginWithEmail(options?: LoginOptions): Promise<MitraInstance>;
-    loginWithGoogle(options?: LoginOptions): Promise<MitraInstance>;
-    loginWithMicrosoft(options?: LoginOptions): Promise<MitraInstance>;
     runQuery(options: RunQueryOptions): Promise<RunQueryResponse>;
     executeDbAction(options: ExecuteDbActionOptions): Promise<ExecuteDbActionResponse>;
     setFileStatus(options: SetFileStatusOptions): Promise<SetFileStatusResponse>;
@@ -278,6 +297,8 @@ interface MitraInstance {
     executeServerFunction(options: ExecuteServerFunctionOptions): Promise<ExecuteServerFunctionResponse>;
     executeServerFunctionAsync(options: ExecuteServerFunctionAsyncOptions): Promise<ExecuteServerFunctionAsyncResponse>;
     stopServerFunctionExecution(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
+    uploadFilePublic(options: UploadFileOptions): Promise<UploadFileResponse>;
+    uploadFileLoadable(options: UploadFileOptions): Promise<UploadFileResponse>;
     listIntegrations(options?: ListIntegrationsOptions): Promise<IntegrationResponse[]>;
     callIntegration(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
     listRecords(options: ListRecordsOptions): Promise<ListRecordsResponse>;
@@ -290,10 +311,6 @@ interface MitraInstance {
 }
 declare function createMitraInstance(initialConfig: Partial<MitraConfig>): MitraInstance;
 
-/**
- * Mitra Interactions SDK - Configuração
- */
-
 interface MitraConfig {
     /** URL base da API (ex: https://api.mitra.com) */
     baseURL: string;
@@ -301,10 +318,12 @@ interface MitraConfig {
     token: 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/auth/) */
+    /** 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;
+    /** Callback chamado quando o token é renovado automaticamente (após 401/403). Recebe a nova sessão. */
+    onTokenRefresh?: (session: LoginResponse) => void;
 }
 /**
  * Configura o SDK globalmente e retorna uma instância configurada.
@@ -327,31 +346,39 @@ declare function resolveProjectId(projectId?: number): number;
  */
 
 /**
- * Login com email e senha via popup seguro Mitra.
- *
- * authUrl e projectId são opcionais se já configurados via configureSdkMitra().
- * Se passados, sobrescrevem os valores salvos.
+ * Login com email e senha via popup/redirect seguro Mitra.
  */
 declare function loginWithEmailMitra(options?: LoginOptions): Promise<LoginResponse>;
 /**
- * Login com Google via popup seguro Mitra.
- *
- * authUrl e projectId são opcionais se já configurados via configureSdkMitra().
- * Se passados, sobrescrevem os valores salvos.
+ * Login com Google via popup/redirect seguro Mitra.
  */
 declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResponse>;
 /**
- * Login com Microsoft via popup seguro Mitra.
- *
- * authUrl e projectId são opcionais se já configurados via configureSdkMitra().
- * Se passados, sobrescrevem os valores salvos.
+ * Login com Microsoft via popup/redirect seguro Mitra.
  */
 declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginResponse>;
 /**
- * Login genérico via popup seguro Mitra.
- * Recebe o método de login como string e delega para a função correspondente.
+ * Login genérico via popup/redirect seguro Mitra.
  */
 declare function loginMitra(method: 'email' | 'google' | 'microsoft', options?: LoginOptions): Promise<LoginResponse>;
+/**
+ * Processa o retorno de um login com mode 'redirect'.
+ *
+ * Após o redirect, a página de auth redireciona de volta com query params:
+ *   ?tokenMitra={token}&backURLMitra={baseURL}&integrationURLMitra={integrationURL}
+ *
+ * Esta função:
+ * - Lê os query params da URL atual
+ * - Se `tokenMitra=error`, lança erro
+ * - Se encontrou tokens, limpa a URL e retorna LoginResponse
+ * - Se não encontrou nada, retorna null
+ */
+declare function handleAuthRedirect(): LoginResponse | null;
+/**
+ * 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>;
 
 /**
  * Mitra Interactions SDK - Services
@@ -418,6 +445,16 @@ declare function callIntegrationMitra(options: CallIntegrationOptions): Promise<
  * Para a execução de uma Server Function em andamento
  */
 declare function stopServerFunctionExecutionMitra(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
+/**
+ * POST /agentAiShortcut/uploadFilePublic (multipart/form-data)
+ * Faz upload de um arquivo para a pasta PUBLIC do projeto.
+ */
+declare function uploadFilePublicMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
+/**
+ * POST /agentAiShortcut/uploadFileLoadable (multipart/form-data)
+ * Faz upload de um arquivo para a pasta LOADABLE do projeto.
+ */
+declare function uploadFileLoadableMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
 declare function listRecordsMitra(options: ListRecordsOptions): Promise<ListRecordsResponse>;
 declare function getRecordMitra(options: GetRecordOptions): Promise<Record<string, any>>;
 declare function createRecordMitra(options: CreateRecordOptions): Promise<Record<string, any>>;
@@ -426,4 +463,4 @@ declare function patchRecordMitra(options: PatchRecordOptions): Promise<Record<s
 declare function deleteRecordMitra(options: DeleteRecordOptions): Promise<void>;
 declare function createRecordsBatchMitra(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
 
-export { type CallIntegrationOptions, type CallIntegrationResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteRecordOptions, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type RunActionOptions, type RunActionResponse, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, getVariableMitra, listIntegrationsMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, resolveProjectId, runActionMitra, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra };
+export { type CallIntegrationOptions, type CallIntegrationResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteRecordOptions, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type RunActionOptions, type RunActionResponse, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, getVariableMitra, handleAuthRedirect, listIntegrationsMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, runActionMitra, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra };