mitra-interactions-sdk 1.0.68 → 1.0.70

package/README.md

@@ -132,6 +132,18 @@ await loginMitra('mitra', {
 
 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.
 
+**Sessão com duração limitada.** Quando o ambiente limita a duração da sessão, o token vale poucos minutos e traz a claim `authTime`. Nesse caso a SDK renova sozinha **antes** do vencimento (e ao voltar para a aba), sem esperar o 403. Se a sessão acabou de vez, a SDK chama `onSessionExpired`: limpe a sessão guardada e leve o usuário ao login. Para os demais tokens nada muda.
+
+```typescript
+configureSdkMitra({
+  ...session,
+  onSessionExpired: () => {
+    localStorage.removeItem('minha_sessao');
+    window.location.reload();
+  }
+});
+```
+
 O callback `onTokenRefresh` é chamado após renovação bem-sucedida:
 
 ```typescript
@@ -514,19 +526,21 @@ const profiles = await listProfilesMitra({ projectId: 123 });
 // { status, projectId, result: [{ id, name, color, homeScreenId }] }
 
 // Criar perfil
-const created = await createProfileMitra({ projectId: 123, name: 'Vendedores', color: '#FF5733' });
-// { status, result: { id, name, message } }
+const created = await createProfileMitra({ projectId: 123, name: 'Vendedores' });
+// { status, result: { profileId, message } }  (mitraapi ≥ #8735 também devolve id e name)
+// A cor passada na criação ainda não é gravada pelo servidor: defina com updateProfileMitra.
 
 // Detalhes do perfil
 const details = await getProfileDetailsMitra({ projectId: 123, profileId: 1 });
-// { status, projectId, result: { id, name, users, selectTables, dmlTables, actions, screens, serverFunctions } }
+// { status, projectId, result: { id, name, color, homeScreenId, users?: [{ id, name, email }], selectTables: [{ tableName, jdbcConnectionConfigId, onlineTable }],
+//   dmlTables, actions: [{ actionId, actionName }], screens: [{ screenId, screenName }], serverFunctions: [{ serverFunctionId, serverFunctionName }] } }
 ```
 
 #### Permissões de Perfil
 
-Define quais recursos cada perfil pode acessar. Todas substituem a lista atual (não fazem append).
+Define quais recursos cada perfil pode acessar. Todas substituem a lista atual, **menos `setProfileUsersMitra`, que só acrescenta** (não tira quem já está no perfil).
 
-- `setProfileUsersMitra({ projectId?, profileId, userIds })` - Define os usuários do perfil
+- `setProfileUsersMitra({ projectId?, profileId, userIds?, emails? })` - Acrescenta usuários ao perfil (ao menos um de userIds ou emails; os não encontrados voltam em `userIdsNotFound`/`emailsNotFound`)
 - `setProfileSelectTablesMitra({ projectId?, profileId, jdbcConnectionConfigId?, tables })` - Define tabelas SELECT permitidas
 - `setProfileDmlTablesMitra({ projectId?, profileId, jdbcConnectionConfigId?, tables })` - Define tabelas DML permitidas
 - `setProfileActionsMitra({ projectId?, profileId, actionIds })` - Define actions permitidas

package/dist/index.d.mts

@@ -472,36 +472,43 @@ interface GetProfileDetailsOptions {
     projectId?: number;
     profileId: number;
 }
+interface ProfileUserItem {
+    id: number;
+    userId: number;
+    name: string;
+    email: string;
+    /** Login (= email), mantido por compatibilidade. */
+    username: string;
+}
+interface ProfileTableItem {
+    tableName: string;
+    jdbcConnectionConfigId?: number | null;
+    onlineTable?: boolean | null;
+}
+/** Formato conferido no mitraapi (getProfileDetails). */
 interface GetProfileDetailsResponse {
     status: string;
     projectId: number;
     result: {
         id: number;
         name: string;
-        users: {
-            id: number;
-            name: string;
-            email: string;
-        }[];
-        selectTables: {
-            tableName: string;
-            jdbcConnectionConfigId?: number;
-        }[];
-        dmlTables: {
-            tableName: string;
-            jdbcConnectionConfigId?: number;
-        }[];
+        color?: string | null;
+        homeScreenId?: number | null;
+        /** Usuários ativos do perfil (mitraapi ≥ #8735; antes o campo não vinha). */
+        users?: ProfileUserItem[];
+        selectTables: ProfileTableItem[];
+        dmlTables: ProfileTableItem[];
         actions: {
-            id: number;
-            name: string;
+            actionId: number;
+            actionName: string | null;
         }[];
         screens: {
-            id: number;
-            name: string;
+            screenId: number;
+            screenName: string | null;
         }[];
         serverFunctions: {
-            id: number;
-            name: string;
+            serverFunctionId: number;
+            serverFunctionName: string | null;
         }[];
     };
 }
@@ -514,8 +521,12 @@ interface CreateProfileOptions {
 interface CreateProfileResponse {
     status: string;
     result: {
-        id: number;
-        name: string;
+        /** Id do novo perfil: use este campo. */
+        profileId: number;
+        /** Igual a profileId (mitraapi ≥ #8735). */
+        id?: number;
+        /** mitraapi ≥ #8735 */
+        name?: string;
         message: string;
     };
 }
@@ -529,8 +540,7 @@ interface UpdateProfileOptions {
 interface UpdateProfileResponse {
     status: string;
     result: {
-        id: number;
-        name: string;
+        profileId: number;
         message: string;
     };
 }
@@ -547,10 +557,15 @@ interface DeleteProfileResponse {
 interface SetProfileUsersOptions {
     projectId?: number;
     profileId: number;
-    userIds: number[];
+    /** IDs dos usuários no tenant (INT_USERS.ID) — ao menos um de userIds ou emails deve ser informado */
+    userIds?: number[];
+    /** Emails dos usuários (resolvidos para userId no tenant) — ao menos um de userIds ou emails deve ser informado */
+    emails?: string[];
 }
 interface ProfileTableRef {
     tableName: string;
+    /** true = online table (query alias), sem conexão JDBC */
+    onlineTable?: boolean;
 }
 interface SetProfileSelectTablesOptions {
     projectId?: number;
@@ -1027,6 +1042,13 @@ interface MitraConfig {
     projectId?: number;
     /** Callback chamado quando o token é renovado automaticamente (após 401/403). Recebe a nova sessão. */
     onTokenRefresh?: (session: LoginResponse) => void;
+    /**
+     * Callback chamado quando a sessão acabou e não há mais como renovar: o token
+     * de uma sessão com duração limitada venceu e a renovação foi recusada. O app
+     * deve limpar a sessão guardada e levar o usuário ao login. Nunca é chamado
+     * para token de validade longa nem em erro de permissão (403 comum).
+     */
+    onSessionExpired?: () => void;
 }
 /**
  * Configura o SDK globalmente e retorna uma instância configurada.
@@ -1087,8 +1109,15 @@ declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra',
 /**
  * Renova o token silenciosamente via iframe invisível.
  * Se já houver um refresh em andamento, reaproveita a mesma promise.
+ *
+ * `currentToken` é o token que o app tem agora. Quando a página de auth pede
+ * (aperto de mão `mitra-auth-ready`), ele é entregue ao iframe por postMessage.
+ * Sem isso, app em domínio próprio não renova: o navegador particiona o
+ * localStorage do iframe de outro site e a página de auth não acha o token que
+ * gravou no login. Página de auth antiga ignora o pedido e renova pelo token
+ * guardado, como sempre.
  */
-declare function refreshTokenSilently(authUrl: string, projectId: number): Promise<LoginResponse>;
+declare function refreshTokenSilently(authUrl: string, projectId: number, currentToken?: string): Promise<LoginResponse>;
 /**
  * Cria conta via email usando iframe silencioso.
  * Após sucesso, o usuário recebe um código de verificação por email.
@@ -1436,4 +1465,4 @@ type EnvLike = Record<string, string | undefined> | undefined;
  */
 declare function readServerFunctionProof(env?: EnvLike, hasWindow?: boolean): string | null;
 
-export { type AgentApiKeyTarget, type AgentAttachment, type AgentAttachmentType, type AgentAuthMeta, type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModelGroup, type AgentModelOption, type AgentProviderListItem, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentSubscriptionAccount, type AgentSubscriptionTarget, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialOptions, type AuthAgentCredentialResult, type AuthClaudeResult, type AuthCodexResult, type AuthMethod, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialOptions, type ConnectAgentSubscriptionResult, type ConnectableSubscriptionTarget, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAccessType, type CredentialAction, type CredentialTarget, type DeleteAgentChatResult, type DeleteFileOptions, type DeleteFileResponse, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type DownloadFileOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDataLoaderOptions, type ExecuteDataLoaderResponse, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type FileLinkOptions, type FileLinkResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type ManageAgentCredentialResult, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type QueuedItem, type RenameAgentChatResult, type ResetPasswordOptions, type RunActionOptions, type RunActionResponse, SF_EXECUTION_TOKEN_ENV, SF_EXECUTION_TOKEN_HEADER, type SendOptions, type SendPasswordResetCodeOptions, type SetFileStatusOptions, type SetFileStatusResponse, type SetProfileActionsOptions, type SetProfileDmlTablesOptions, type SetProfilePermissionResponse, type SetProfileScreensOptions, type SetProfileSelectTablesOptions, type SetProfileServerFunctionsOptions, type SetProfileUsersOptions, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateProfileOptions, type UpdateProfileResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, type ValidatePasswordResetCodeOptions, callIntegrationMitra, closeChatMitra, configureSdkMitra, createMitraInstance, createProfileMitra, createRecordMitra, createRecordsBatchMitra, deleteFileMitra, deleteProfileMitra, deleteRecordMitra, downloadFilePrivateMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getFileLinkMitra, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, openChatMitra, patchRecordMitra, readServerFunctionProof, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePrivateMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };
+export { type AgentApiKeyTarget, type AgentAttachment, type AgentAttachmentType, type AgentAuthMeta, type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModelGroup, type AgentModelOption, type AgentProviderListItem, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentSubscriptionAccount, type AgentSubscriptionTarget, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialOptions, type AuthAgentCredentialResult, type AuthClaudeResult, type AuthCodexResult, type AuthMethod, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialOptions, type ConnectAgentSubscriptionResult, type ConnectableSubscriptionTarget, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAccessType, type CredentialAction, type CredentialTarget, type DeleteAgentChatResult, type DeleteFileOptions, type DeleteFileResponse, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type DownloadFileOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDataLoaderOptions, type ExecuteDataLoaderResponse, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type FileLinkOptions, type FileLinkResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type ManageAgentCredentialResult, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableItem, type ProfileTableRef, type ProfileUserItem, type QueuedItem, type RenameAgentChatResult, type ResetPasswordOptions, type RunActionOptions, type RunActionResponse, SF_EXECUTION_TOKEN_ENV, SF_EXECUTION_TOKEN_HEADER, type SendOptions, type SendPasswordResetCodeOptions, type SetFileStatusOptions, type SetFileStatusResponse, type SetProfileActionsOptions, type SetProfileDmlTablesOptions, type SetProfilePermissionResponse, type SetProfileScreensOptions, type SetProfileSelectTablesOptions, type SetProfileServerFunctionsOptions, type SetProfileUsersOptions, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateProfileOptions, type UpdateProfileResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, type ValidatePasswordResetCodeOptions, callIntegrationMitra, closeChatMitra, configureSdkMitra, createMitraInstance, createProfileMitra, createRecordMitra, createRecordsBatchMitra, deleteFileMitra, deleteProfileMitra, deleteRecordMitra, downloadFilePrivateMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getFileLinkMitra, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, openChatMitra, patchRecordMitra, readServerFunctionProof, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePrivateMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };

package/dist/index.d.ts

@@ -472,36 +472,43 @@ interface GetProfileDetailsOptions {
     projectId?: number;
     profileId: number;
 }
+interface ProfileUserItem {
+    id: number;
+    userId: number;
+    name: string;
+    email: string;
+    /** Login (= email), mantido por compatibilidade. */
+    username: string;
+}
+interface ProfileTableItem {
+    tableName: string;
+    jdbcConnectionConfigId?: number | null;
+    onlineTable?: boolean | null;
+}
+/** Formato conferido no mitraapi (getProfileDetails). */
 interface GetProfileDetailsResponse {
     status: string;
     projectId: number;
     result: {
         id: number;
         name: string;
-        users: {
-            id: number;
-            name: string;
-            email: string;
-        }[];
-        selectTables: {
-            tableName: string;
-            jdbcConnectionConfigId?: number;
-        }[];
-        dmlTables: {
-            tableName: string;
-            jdbcConnectionConfigId?: number;
-        }[];
+        color?: string | null;
+        homeScreenId?: number | null;
+        /** Usuários ativos do perfil (mitraapi ≥ #8735; antes o campo não vinha). */
+        users?: ProfileUserItem[];
+        selectTables: ProfileTableItem[];
+        dmlTables: ProfileTableItem[];
         actions: {
-            id: number;
-            name: string;
+            actionId: number;
+            actionName: string | null;
         }[];
         screens: {
-            id: number;
-            name: string;
+            screenId: number;
+            screenName: string | null;
         }[];
         serverFunctions: {
-            id: number;
-            name: string;
+            serverFunctionId: number;
+            serverFunctionName: string | null;
         }[];
     };
 }
@@ -514,8 +521,12 @@ interface CreateProfileOptions {
 interface CreateProfileResponse {
     status: string;
     result: {
-        id: number;
-        name: string;
+        /** Id do novo perfil: use este campo. */
+        profileId: number;
+        /** Igual a profileId (mitraapi ≥ #8735). */
+        id?: number;
+        /** mitraapi ≥ #8735 */
+        name?: string;
         message: string;
     };
 }
@@ -529,8 +540,7 @@ interface UpdateProfileOptions {
 interface UpdateProfileResponse {
     status: string;
     result: {
-        id: number;
-        name: string;
+        profileId: number;
         message: string;
     };
 }
@@ -547,10 +557,15 @@ interface DeleteProfileResponse {
 interface SetProfileUsersOptions {
     projectId?: number;
     profileId: number;
-    userIds: number[];
+    /** IDs dos usuários no tenant (INT_USERS.ID) — ao menos um de userIds ou emails deve ser informado */
+    userIds?: number[];
+    /** Emails dos usuários (resolvidos para userId no tenant) — ao menos um de userIds ou emails deve ser informado */
+    emails?: string[];
 }
 interface ProfileTableRef {
     tableName: string;
+    /** true = online table (query alias), sem conexão JDBC */
+    onlineTable?: boolean;
 }
 interface SetProfileSelectTablesOptions {
     projectId?: number;
@@ -1027,6 +1042,13 @@ interface MitraConfig {
     projectId?: number;
     /** Callback chamado quando o token é renovado automaticamente (após 401/403). Recebe a nova sessão. */
     onTokenRefresh?: (session: LoginResponse) => void;
+    /**
+     * Callback chamado quando a sessão acabou e não há mais como renovar: o token
+     * de uma sessão com duração limitada venceu e a renovação foi recusada. O app
+     * deve limpar a sessão guardada e levar o usuário ao login. Nunca é chamado
+     * para token de validade longa nem em erro de permissão (403 comum).
+     */
+    onSessionExpired?: () => void;
 }
 /**
  * Configura o SDK globalmente e retorna uma instância configurada.
@@ -1087,8 +1109,15 @@ declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra',
 /**
  * Renova o token silenciosamente via iframe invisível.
  * Se já houver um refresh em andamento, reaproveita a mesma promise.
+ *
+ * `currentToken` é o token que o app tem agora. Quando a página de auth pede
+ * (aperto de mão `mitra-auth-ready`), ele é entregue ao iframe por postMessage.
+ * Sem isso, app em domínio próprio não renova: o navegador particiona o
+ * localStorage do iframe de outro site e a página de auth não acha o token que
+ * gravou no login. Página de auth antiga ignora o pedido e renova pelo token
+ * guardado, como sempre.
  */
-declare function refreshTokenSilently(authUrl: string, projectId: number): Promise<LoginResponse>;
+declare function refreshTokenSilently(authUrl: string, projectId: number, currentToken?: string): Promise<LoginResponse>;
 /**
  * Cria conta via email usando iframe silencioso.
  * Após sucesso, o usuário recebe um código de verificação por email.
@@ -1436,4 +1465,4 @@ type EnvLike = Record<string, string | undefined> | undefined;
  */
 declare function readServerFunctionProof(env?: EnvLike, hasWindow?: boolean): string | null;
 
-export { type AgentApiKeyTarget, type AgentAttachment, type AgentAttachmentType, type AgentAuthMeta, type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModelGroup, type AgentModelOption, type AgentProviderListItem, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentSubscriptionAccount, type AgentSubscriptionTarget, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialOptions, type AuthAgentCredentialResult, type AuthClaudeResult, type AuthCodexResult, type AuthMethod, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialOptions, type ConnectAgentSubscriptionResult, type ConnectableSubscriptionTarget, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAccessType, type CredentialAction, type CredentialTarget, type DeleteAgentChatResult, type DeleteFileOptions, type DeleteFileResponse, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type DownloadFileOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDataLoaderOptions, type ExecuteDataLoaderResponse, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type FileLinkOptions, type FileLinkResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type ManageAgentCredentialResult, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type QueuedItem, type RenameAgentChatResult, type ResetPasswordOptions, type RunActionOptions, type RunActionResponse, SF_EXECUTION_TOKEN_ENV, SF_EXECUTION_TOKEN_HEADER, type SendOptions, type SendPasswordResetCodeOptions, type SetFileStatusOptions, type SetFileStatusResponse, type SetProfileActionsOptions, type SetProfileDmlTablesOptions, type SetProfilePermissionResponse, type SetProfileScreensOptions, type SetProfileSelectTablesOptions, type SetProfileServerFunctionsOptions, type SetProfileUsersOptions, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateProfileOptions, type UpdateProfileResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, type ValidatePasswordResetCodeOptions, callIntegrationMitra, closeChatMitra, configureSdkMitra, createMitraInstance, createProfileMitra, createRecordMitra, createRecordsBatchMitra, deleteFileMitra, deleteProfileMitra, deleteRecordMitra, downloadFilePrivateMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getFileLinkMitra, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, openChatMitra, patchRecordMitra, readServerFunctionProof, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePrivateMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };
+export { type AgentApiKeyTarget, type AgentAttachment, type AgentAttachmentType, type AgentAuthMeta, type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModelGroup, type AgentModelOption, type AgentProviderListItem, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentSubscriptionAccount, type AgentSubscriptionTarget, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialOptions, type AuthAgentCredentialResult, type AuthClaudeResult, type AuthCodexResult, type AuthMethod, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialOptions, type ConnectAgentSubscriptionResult, type ConnectableSubscriptionTarget, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAccessType, type CredentialAction, type CredentialTarget, type DeleteAgentChatResult, type DeleteFileOptions, type DeleteFileResponse, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type DownloadFileOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDataLoaderOptions, type ExecuteDataLoaderResponse, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type FileLinkOptions, type FileLinkResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type ManageAgentCredentialResult, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableItem, type ProfileTableRef, type ProfileUserItem, type QueuedItem, type RenameAgentChatResult, type ResetPasswordOptions, type RunActionOptions, type RunActionResponse, SF_EXECUTION_TOKEN_ENV, SF_EXECUTION_TOKEN_HEADER, type SendOptions, type SendPasswordResetCodeOptions, type SetFileStatusOptions, type SetFileStatusResponse, type SetProfileActionsOptions, type SetProfileDmlTablesOptions, type SetProfilePermissionResponse, type SetProfileScreensOptions, type SetProfileSelectTablesOptions, type SetProfileServerFunctionsOptions, type SetProfileUsersOptions, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateProfileOptions, type UpdateProfileResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, type ValidatePasswordResetCodeOptions, callIntegrationMitra, closeChatMitra, configureSdkMitra, createMitraInstance, createProfileMitra, createRecordMitra, createRecordsBatchMitra, deleteFileMitra, deleteProfileMitra, deleteRecordMitra, downloadFilePrivateMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getFileLinkMitra, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, openChatMitra, patchRecordMitra, readServerFunctionProof, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePrivateMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };

package/dist/index.js

@@ -120,19 +120,28 @@ async function loginMitra(method, options) {
   return doLogin(method, options);
 }
 var REFRESH_TIMEOUT_MS = 15e3;
+var AUTH_HANDOFF_READY_TYPE = "mitra-auth-ready";
+var AUTH_HANDOFF_TOKEN_TYPE = "mitra-auth-refresh-token";
 var _refreshPromise = null;
-function openAuthIframe(url, expectedOrigin) {
+function openAuthIframe(url, expectedOrigin, handoffToken) {
   return new Promise((resolve, reject) => {
     const iframe = document.createElement("iframe");
     iframe.style.display = "none";
     iframe.src = url;
-    const timer = setTimeout(() => {
+    const timer2 = setTimeout(() => {
       cleanup();
       reject(new Error("Token refresh timeout"));
     }, REFRESH_TIMEOUT_MS);
     function onMessage(event) {
       if (event.origin !== expectedOrigin) return;
-      if (!event.data || event.data.type !== AUTH_MESSAGE_TYPE) return;
+      if (!event.data) return;
+      if (event.data.type === AUTH_HANDOFF_READY_TYPE) {
+        if (handoffToken && iframe.contentWindow && event.source === iframe.contentWindow) {
+          iframe.contentWindow.postMessage({ type: AUTH_HANDOFF_TOKEN_TYPE, token: handoffToken }, expectedOrigin);
+        }
+        return;
+      }
+      if (event.data.type !== AUTH_MESSAGE_TYPE) return;
       cleanup();
       if (event.data.success) {
         resolve(event.data.data);
@@ -142,20 +151,20 @@ function openAuthIframe(url, expectedOrigin) {
     }
     function cleanup() {
       window.removeEventListener("message", onMessage);
-      clearTimeout(timer);
+      clearTimeout(timer2);
       if (iframe.parentNode) iframe.parentNode.removeChild(iframe);
     }
     window.addEventListener("message", onMessage);
     document.body.appendChild(iframe);
   });
 }
-async function refreshTokenSilently(authUrl, projectId) {
+async function refreshTokenSilently(authUrl, projectId, currentToken) {
   if (_refreshPromise) return _refreshPromise;
   _refreshPromise = (async () => {
     try {
       const origin = getOriginFromUrl(authUrl);
-      const url = buildAuthUrl(authUrl, "refresh", projectId);
-      const response = await openAuthIframe(url, origin);
+      const url = buildAuthUrl(authUrl, "refresh", projectId) + (currentToken ? "&handoff=1" : "");
+      const response = await openAuthIframe(url, origin, currentToken);
       return response;
     } finally {
       _refreshPromise = null;
@@ -177,7 +186,7 @@ function openSilentAuthIframe(authUrl, projectId, credentials) {
     }
     const iframe = document.createElement("iframe");
     iframe.style.display = "none";
-    const timer = setTimeout(() => {
+    const timer2 = setTimeout(() => {
       cleanup();
       reject(new Error("Timeout na autentica\xE7\xE3o silenciosa"));
     }, SILENT_TIMEOUT_MS);
@@ -201,7 +210,7 @@ function openSilentAuthIframe(authUrl, projectId, credentials) {
     }
     function cleanup() {
       window.removeEventListener("message", onMessage);
-      clearTimeout(timer);
+      clearTimeout(timer2);
       if (iframe.parentNode) iframe.parentNode.removeChild(iframe);
     }
     window.addEventListener("message", onMessage);
@@ -383,6 +392,105 @@ function withServerFunctionProof(headers, proof = readServerFunctionProof()) {
   return { ...headers, [SF_EXECUTION_TOKEN_HEADER]: proof };
 }
 
+// src/session-watch.ts
+var RENEW_BEFORE_MS = 6e4;
+var RETRY_MS = 1e4;
+var MAX_TIMEOUT_MS = 2147483647;
+var refresher = null;
+var timer = null;
+var listening = false;
+var expiryAtLastAttempt = null;
+var notifiedFor = null;
+function registerSessionRefresher(fn) {
+  refresher = fn;
+}
+function limitedSessionExpiry(token) {
+  if (!token) return null;
+  const payload = decodeJwtPayload(token);
+  if (!payload || typeof payload.authTime !== "number" || typeof payload.exp !== "number") return null;
+  return payload.exp * 1e3;
+}
+function currentExpiry() {
+  if (typeof window === "undefined" || !isConfigured()) return null;
+  const config = getConfig();
+  if (!config.token || !config.authUrl || config.projectId == null) return null;
+  return limitedSessionExpiry(config.token);
+}
+function clearTimer() {
+  if (timer) {
+    clearTimeout(timer);
+    timer = null;
+  }
+}
+function startSessionWatch() {
+  expiryAtLastAttempt = null;
+  notifiedFor = null;
+  watchSession();
+}
+function watchSession() {
+  clearTimer();
+  const expiry = currentExpiry();
+  if (expiry == null) return;
+  listenForReturn();
+  let delay = Math.max(expiry - Date.now() - RENEW_BEFORE_MS, 0);
+  if (expiryAtLastAttempt != null && expiry <= expiryAtLastAttempt + 1e3) {
+    delay = Math.max(expiry - Date.now() + 1e3, RETRY_MS);
+  }
+  if (delay > MAX_TIMEOUT_MS) return;
+  timer = setTimeout(() => {
+    void renewNow();
+  }, delay);
+}
+async function renewNow() {
+  clearTimer();
+  const before = currentExpiry();
+  if (before == null || !refresher) return;
+  expiryAtLastAttempt = before;
+  const renewed = await refresher().catch(() => false);
+  if (renewed) return;
+  const expiry = currentExpiry();
+  if (expiry != null && Date.now() < expiry) {
+    timer = setTimeout(() => {
+      void renewNow();
+    }, RETRY_MS);
+  }
+}
+function onReturn() {
+  const expiry = currentExpiry();
+  if (expiry == null) return;
+  const atSessionEnd = expiryAtLastAttempt != null && expiry <= expiryAtLastAttempt + 1e3;
+  if (expiry - Date.now() <= RENEW_BEFORE_MS && (!atSessionEnd || Date.now() >= expiry)) {
+    void renewNow();
+  } else {
+    watchSession();
+  }
+}
+function listenForReturn() {
+  if (listening || typeof window === "undefined") return;
+  listening = true;
+  if (typeof document !== "undefined" && typeof document.addEventListener === "function") {
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState === "visible") onReturn();
+    });
+  }
+  if (typeof window.addEventListener === "function") {
+    window.addEventListener("online", onReturn);
+  }
+}
+function reportRefreshFailure() {
+  var _a, _b;
+  const expiry = currentExpiry();
+  if (expiry == null || Date.now() < expiry) return;
+  const config = getConfig();
+  if (notifiedFor === config.token) return;
+  notifiedFor = (_a = config.token) != null ? _a : null;
+  clearTimer();
+  try {
+    (_b = config.onSessionExpired) == null ? void 0 : _b.call(config);
+  } catch (e) {
+  }
+}
+
 // src/client.ts
 function getFetch2() {
   if (typeof globalThis.fetch === "function") {
@@ -417,14 +525,18 @@ function tryRefreshToken() {
     if (refreshInFlight === attempt) refreshInFlight = null;
   };
   attempt.then(clear, clear);
+  attempt.then((renewed) => {
+    if (!renewed) reportRefreshFailure();
+  }, () => void 0);
   return attempt;
 }
+registerSessionRefresher(tryRefreshToken);
 async function doRefreshToken() {
   const config = getConfig();
   if (!config.token || config.projectId == null || !config.baseURL) return false;
   if (!config.authUrl || typeof window === "undefined") return false;
   try {
-    const session = await refreshTokenSilently(config.authUrl, config.projectId);
+    const session = await refreshTokenSilently(config.authUrl, config.projectId, config.token);
     updateGlobalToken(session.token);
     if (config.onTokenRefresh) config.onTokenRefresh(session);
     return true;
@@ -826,11 +938,13 @@ async function deleteProfileMitra(options) {
   });
 }
 async function setProfileUsersMitra(options) {
-  return http.post("/interactions/profiles/users", {
+  const body = {
     projectId: resolveProjectId2(options.projectId),
-    profileId: options.profileId,
-    userIds: options.userIds
-  });
+    profileId: options.profileId
+  };
+  if (options.userIds !== void 0) body.userIds = options.userIds;
+  if (options.emails !== void 0) body.emails = options.emails;
+  return http.post("/interactions/profiles/users", body);
 }
 async function setProfileSelectTablesMitra(options) {
   const body = {
@@ -1498,7 +1612,7 @@ function openSocket() {
   return new Promise((resolve, reject) => {
     const socket = new WebSocket(url);
     let opened = false;
-    const timer = setTimeout(() => {
+    const timer2 = setTimeout(() => {
       if (!opened) {
         try {
           socket.close();
@@ -1509,13 +1623,13 @@ function openSocket() {
     }, 15e3);
     socket.onopen = () => {
       opened = true;
-      clearTimeout(timer);
+      clearTimeout(timer2);
       ws = socket;
       resolve(socket);
     };
     socket.onerror = () => {
       if (!opened) {
-        clearTimeout(timer);
+        clearTimeout(timer2);
         reject(new Error("Agent Chat: erro ao conectar no WebSocket"));
       }
     };
@@ -1523,7 +1637,7 @@ function openSocket() {
       if (ws === socket) ws = null;
       const detalhe = closeDetail(event);
       if (!opened) {
-        clearTimeout(timer);
+        clearTimeout(timer2);
         reject(new Error(`Agent Chat: conex\xE3o fechada${detalhe}`));
       }
       for (const [id, pending] of pendingRequests) {
@@ -1898,7 +2012,7 @@ function createMitraInstance(initialConfig) {
     if (!_config.token || _config.projectId == null || !_config.baseURL) return false;
     if (!_config.authUrl || typeof window === "undefined") return false;
     try {
-      const session = await refreshTokenSilently(_config.authUrl, _config.projectId);
+      const session = await refreshTokenSilently(_config.authUrl, _config.projectId, _config.token);
       _config = { ..._config, token: stripBearer(session.token) };
       updateGlobalToken(session.token);
       if (_config.onTokenRefresh) _config.onTokenRefresh(session);
@@ -2188,19 +2302,21 @@ function createMitraInstance(initialConfig) {
       return request("DELETE", "/interactions/profiles", { body: { projectId: resolveProjectId4(options.projectId), profileId: options.profileId } });
     },
     async setProfileUsers(options) {
-      return request("POST", "/interactions/profiles/users", {
-        body: { projectId: resolveProjectId4(options.projectId), profileId: options.profileId, userIds: options.userIds }
-      });
+      const body = { projectId: resolveProjectId4(options.projectId), profileId: options.profileId };
+      if (options.userIds !== void 0) body.userIds = options.userIds;
+      if (options.emails !== void 0) body.emails = options.emails;
+      return request("POST", "/interactions/profiles/users", { body });
     },
+    // jdbcConnectionConfigId era descartado nos dois abaixo (as funções soltas repassavam).
     async setProfileSelectTables(options) {
-      return request("POST", "/interactions/profiles/selectTables", {
-        body: { projectId: resolveProjectId4(options.projectId), profileId: options.profileId, tables: options.tables }
-      });
+      const body = { projectId: resolveProjectId4(options.projectId), profileId: options.profileId, tables: options.tables };
+      if (options.jdbcConnectionConfigId !== void 0) body.jdbcConnectionConfigId = options.jdbcConnectionConfigId;
+      return request("POST", "/interactions/profiles/selectTables", { body });
     },
     async setProfileDmlTables(options) {
-      return request("POST", "/interactions/profiles/dmlTables", {
-        body: { projectId: resolveProjectId4(options.projectId), profileId: options.profileId, tables: options.tables }
-      });
+      const body = { projectId: resolveProjectId4(options.projectId), profileId: options.profileId, tables: options.tables };
+      if (options.jdbcConnectionConfigId !== void 0) body.jdbcConnectionConfigId = options.jdbcConnectionConfigId;
+      return request("POST", "/interactions/profiles/dmlTables", { body });
     },
     async setProfileActions(options) {
       return request("POST", "/interactions/profiles/actions", {
@@ -2306,6 +2422,7 @@ function configureSdkMitra(config = {}) {
     const chat = window.__mitraChat;
     if (chat) chat.init(merged.token);
   }
+  startSessionWatch();
   return createMitraInstance(globalConfig);
 }
 function getConfig() {
@@ -2320,6 +2437,7 @@ function isConfigured() {
 function updateGlobalToken(token) {
   if (globalConfig) {
     globalConfig = { ...globalConfig, token: stripBearer(token) };
+    watchSession();
   }
 }
 function inferProjectId(projectId) {