mitra-interactions-sdk 1.0.69 → 1.0.71

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

package/dist/index.d.mts

@@ -417,6 +417,19 @@ interface CallIntegrationOptions {
     params?: Record<string, unknown>;
     /** Body da requisição (para POST/PUT) */
     body?: Record<string, unknown>;
+    /**
+     * Headers só desta chamada. Use apenas quando a API externa exigir um header específico.
+     *
+     * Se a API exigir corpo `application/x-www-form-urlencoded` (comum em endpoints OAuth como
+     * introspect, revoke e token), passe `{ 'Content-Type': 'application/x-www-form-urlencoded' }`
+     * e monte o `body` como objeto plano de campos texto, número ou booleano: objeto ou lista dentro
+     * do `body` é recusado com 400. Sem esse header, o corpo vai em JSON.
+     *
+     * A autenticação da integração continua sendo aplicada; um header com o mesmo nome de um da
+     * integração (ex.: `Authorization`) substitui o da integração nesta chamada. Valores são texto
+     * literal. Quando omitido, nenhum header é enviado.
+     */
+    headers?: Record<string, string>;
 }
 interface CallIntegrationResponse {
     /** HTTP status retornado pelo serviço externo */
@@ -1042,6 +1055,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.
@@ -1102,8 +1122,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.
@@ -1318,6 +1345,11 @@ declare function listIntegrationsMitra(options?: ListIntegrationsOptions): Promi
  * POST /interactions/integrations/call
  * Chama uma API externa via serviço de integrações
  * Mapeia connection → integrationSlug no body
+ *
+ * `headers` é opcional e vale só para esta chamada. Com
+ * `headers: { 'Content-Type': 'application/x-www-form-urlencoded' }` o `body` sai como formulário
+ * (`campo=valor&campo=valor`), o que endpoints OAuth como introspect, revoke e token exigem; o
+ * `body` precisa então ser um objeto plano. Sem esse header, o corpo vai em JSON.
  */
 declare function callIntegrationMitra(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
 /**

package/dist/index.d.ts

@@ -417,6 +417,19 @@ interface CallIntegrationOptions {
     params?: Record<string, unknown>;
     /** Body da requisição (para POST/PUT) */
     body?: Record<string, unknown>;
+    /**
+     * Headers só desta chamada. Use apenas quando a API externa exigir um header específico.
+     *
+     * Se a API exigir corpo `application/x-www-form-urlencoded` (comum em endpoints OAuth como
+     * introspect, revoke e token), passe `{ 'Content-Type': 'application/x-www-form-urlencoded' }`
+     * e monte o `body` como objeto plano de campos texto, número ou booleano: objeto ou lista dentro
+     * do `body` é recusado com 400. Sem esse header, o corpo vai em JSON.
+     *
+     * A autenticação da integração continua sendo aplicada; um header com o mesmo nome de um da
+     * integração (ex.: `Authorization`) substitui o da integração nesta chamada. Valores são texto
+     * literal. Quando omitido, nenhum header é enviado.
+     */
+    headers?: Record<string, string>;
 }
 interface CallIntegrationResponse {
     /** HTTP status retornado pelo serviço externo */
@@ -1042,6 +1055,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.
@@ -1102,8 +1122,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.
@@ -1318,6 +1345,11 @@ declare function listIntegrationsMitra(options?: ListIntegrationsOptions): Promi
  * POST /interactions/integrations/call
  * Chama uma API externa via serviço de integrações
  * Mapeia connection → integrationSlug no body
+ *
+ * `headers` é opcional e vale só para esta chamada. Com
+ * `headers: { 'Content-Type': 'application/x-www-form-urlencoded' }` o `body` sai como formulário
+ * (`campo=valor&campo=valor`), o que endpoints OAuth como introspect, revoke e token exigem; o
+ * `body` precisa então ser um objeto plano. Sem esse header, o corpo vai em JSON.
  */
 declare function callIntegrationMitra(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
 /**

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;
@@ -711,6 +823,9 @@ async function callIntegrationMitra(options) {
   if (options.body !== void 0) {
     body.body = options.body;
   }
+  if (options.headers !== void 0) {
+    body.headers = options.headers;
+  }
   return http.post("/interactions/integrations/call", body);
 }
 async function stopServerFunctionExecutionMitra(options) {
@@ -1500,7 +1615,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();
@@ -1511,13 +1626,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"));
       }
     };
@@ -1525,7 +1640,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) {
@@ -1900,7 +2015,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);
@@ -2128,6 +2243,7 @@ function createMitraInstance(initialConfig) {
       if (options.endpoint !== void 0) body.endpoint = options.endpoint;
       if (options.params !== void 0) body.params = options.params;
       if (options.body !== void 0) body.body = options.body;
+      if (options.headers !== void 0) body.headers = options.headers;
       return request("POST", "/interactions/integrations/call", { body });
     },
     // Dynamic Schema CRUD
@@ -2310,6 +2426,7 @@ function configureSdkMitra(config = {}) {
     const chat = window.__mitraChat;
     if (chat) chat.init(merged.token);
   }
+  startSessionWatch();
   return createMitraInstance(globalConfig);
 }
 function getConfig() {
@@ -2324,6 +2441,7 @@ function isConfigured() {
 function updateGlobalToken(token) {
   if (globalConfig) {
     globalConfig = { ...globalConfig, token: stripBearer(token) };
+    watchSession();
   }
 }
 function inferProjectId(projectId) {