mitra-interactions-sdk 1.0.24 → 1.0.26

package/README.md

@@ -33,65 +33,33 @@ MITRA_BASE_URL=https://api.mitra.com
 MITRA_TOKEN=seu-jwt-token-da-plataforma-mitra
 ```
 
-### configureMitra
-
-Auto-configura o SDK a partir dos query params da URL (`token` e `backURL`). Útil quando o SDK roda dentro de um iframe que recebe as credenciais via URL.
-
-```typescript
-import { configureMitra } from 'mitra-interactions-sdk';
-
-const { configured } = configureMitra();
-// Se a URL contém ?token=xxx&backURL=xxx, o SDK é configurado automaticamente
-```
-
 ## Autenticação (Login)
 
-O SDK oferece 3 métodos de login que autenticam o usuário e **auto-configuram o SDK** automaticamente.
-
-### loginWithEmailMitra
-
-Login com email e senha.
+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.
 
 ```typescript
-import { loginWithEmailMitra } from 'mitra-interactions-sdk';
+import { loginMitra } from 'mitra-interactions-sdk';
 
-const result = await loginWithEmailMitra({
-  baseURL: 'https://api0.mitraecp.com:1005',
-  email: 'user@example.com',
-  password: 'senha123'
+// Login com email e senha
+const result = await loginMitra('email', {
+  authUrl: 'https://validacao.mitralab.io/auth/',
+  projectId: 123
 });
-// SDK auto-configurado, pronto pra usar
-// result: { token, type, merge: { userToken, backURL, userEmail, integrationURL, ... } }
-```
-
-### loginWithGoogleMitra
-
-Login via Google OAuth. Abre popup do Google automaticamente (sem dependências npm extras).
-
-```typescript
-import { loginWithGoogleMitra } from 'mitra-interactions-sdk';
 
-const result = await loginWithGoogleMitra({
-  baseURL: 'https://api0.mitraecp.com:1005',
-  googleClientId: 'xxxxx.apps.googleusercontent.com'
+// Login com Google
+const result = await loginMitra('google', {
+  authUrl: 'https://validacao.mitralab.io/auth/',
+  projectId: 123
 });
-// SDK auto-configurado após login
-```
-
-### loginWithMicrosoftMitra
-
-Login via Microsoft OAuth. Abre popup da Microsoft automaticamente.
-
-> **Requisito:** Instale `@azure/msal-browser` separadamente: `npm install @azure/msal-browser`
 
-```typescript
-import { loginWithMicrosoftMitra } from 'mitra-interactions-sdk';
-
-const result = await loginWithMicrosoftMitra({
-  baseURL: 'https://api0.mitraecp.com:1005',
-  msClientId: 'xxxxx-xxxx-xxxx-xxxx'
+// Login com Microsoft
+const result = await loginMitra('microsoft', {
+  authUrl: 'https://validacao.mitralab.io/auth/',
+  projectId: 123
 });
-// SDK auto-configurado após login
+
+// authUrl e projectId são opcionais se já configurados via configureSdkMitra()
+// result: { token, baseURL, integrationURL? }
 ```
 
 ## Métodos Disponíveis
@@ -179,7 +147,7 @@ const result = await stopServerFunctionExecutionMitra({
 
 ### Integrações
 
-> **Requisito:** A `integrationURL` deve ser configurada via `configureSdkMitra({ ..., integrationURL: 'https://api0.mitraecp.com:1003' })` ou via query param `integrationURL` (auto-config com `configureMitra()`).
+> **Requisito:** A `integrationURL` deve ser configurada via `configureSdkMitra({ ..., integrationURL: 'https://api0.mitraecp.com:1003' })`.
 
 #### listIntegrationsMitra
 
@@ -301,16 +269,6 @@ const result2 = await listRecordsMitra({
 });
 ```
 
-### logoutMitra
-
-Solicita logout ao app pai (Mitra Nuxt) via postMessage.
-
-```typescript
-import { logoutMitra } from 'mitra-interactions-sdk';
-
-logoutMitra();
-```
-
 ## Tipos TypeScript
 
 Todos os tipos estão incluídos:
@@ -319,9 +277,7 @@ Todos os tipos estão incluídos:
 import type {
   MitraConfig,
   // Login
-  LoginWithEmailOptions,
-  LoginWithGoogleOptions,
-  LoginWithMicrosoftOptions,
+  LoginOptions,
   LoginResponse,
   // Options
   RunQueryOptions,

package/dist/index.d.mts

@@ -1,40 +1,3 @@
-/**
- * Mitra Interactions SDK - Configuração
- */
-interface MitraConfig {
-    /** URL base da API (ex: https://api.mitra.com) */
-    baseURL: string;
-    /** Token JWT para autenticação */
-    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/) */
-    authUrl?: string;
-    /** ID do projeto (usado como fallback nos métodos de login e serviços) */
-    projectId?: number;
-}
-/**
- * Configura o SDK globalmente e persiste no localStorage.
- */
-declare function configureSdkMitra(config: MitraConfig): void;
-/**
- * Obtém a configuração atual
- */
-declare function getConfig(): MitraConfig;
-/**
- * Resolve projectId: usa o valor passado, senão pega do config salvo.
- */
-declare function resolveProjectId(projectId?: number): number;
-/**
- * Auto-configura o SDK.
- * 1. Verifica query params (token + backURL) — se encontrar, salva no store e configura.
- * 2. Se não tem params, tenta carregar do localStorage.
- * Retorna { configured: true } se configurou, ou { configured: false } caso contrário.
- */
-declare function configureMitra(): {
-    configured: boolean;
-};
-
 /**
  * Mitra Interactions SDK - Types
  */
@@ -252,6 +215,66 @@ interface StopServerFunctionExecutionResponse {
     };
 }
 
+/**
+ * Mitra Interactions SDK - Instance
+ *
+ * Permite múltiplas instâncias configuradas independentemente.
+ */
+
+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>;
+    setVariable(options: SetVariableOptions): Promise<SetVariableResponse>;
+    executeServerFunction(options: ExecuteServerFunctionOptions): Promise<ExecuteServerFunctionResponse>;
+    executeServerFunctionAsync(options: ExecuteServerFunctionAsyncOptions): Promise<ExecuteServerFunctionAsyncResponse>;
+    stopServerFunctionExecution(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
+    listIntegrations(options?: ListIntegrationsOptions): Promise<IntegrationResponse[]>;
+    callIntegration(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
+    listRecords(options: ListRecordsOptions): Promise<ListRecordsResponse>;
+    getRecord(options: GetRecordOptions): Promise<Record<string, any>>;
+    createRecord(options: CreateRecordOptions): Promise<Record<string, any>>;
+    updateRecord(options: UpdateRecordOptions): Promise<Record<string, any>>;
+    patchRecord(options: PatchRecordOptions): Promise<Record<string, any>>;
+    deleteRecord(options: DeleteRecordOptions): Promise<void>;
+    createRecordsBatch(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
+}
+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;
+    /** Token JWT para autenticação */
+    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/) */
+    authUrl?: string;
+    /** ID do projeto (usado como fallback nos métodos de login e serviços) */
+    projectId?: number;
+}
+/**
+ * Configura o SDK globalmente e retorna uma instância configurada.
+ */
+declare function configureSdkMitra(config: MitraConfig): MitraInstance;
+/**
+ * Obtém a configuração atual
+ */
+declare function getConfig(): MitraConfig;
+/**
+ * Resolve projectId: usa o valor passado, senão pega do config salvo.
+ */
+declare function resolveProjectId(projectId?: number): number;
+
 /**
  * Mitra Interactions SDK - Autenticação
  *
@@ -280,6 +303,11 @@ declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResp
  * Se passados, sobrescrevem os valores salvos.
  */
 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.
+ */
+declare function loginMitra(method: 'email' | 'google' | 'microsoft', options?: LoginOptions): Promise<LoginResponse>;
 
 /**
  * Mitra Interactions SDK - Services
@@ -338,11 +366,5 @@ declare function updateRecordMitra(options: UpdateRecordOptions): Promise<Record
 declare function patchRecordMitra(options: PatchRecordOptions): Promise<Record<string, any>>;
 declare function deleteRecordMitra(options: DeleteRecordOptions): Promise<void>;
 declare function createRecordsBatchMitra(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
-/**
- * Realiza logout do SDK.
- * - Se embarcado no Mitra (iframe): envia postMessage pro app pai solicitando logout.
- * - Se standalone: limpa config (memória + localStorage) e redireciona pro redirectPath se informado.
- */
-declare function logoutMitra(redirectPath?: string): void;
 
-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 IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type LoginOptions, type LoginResponse, type MitraConfig, type PatchRecordOptions, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, callIntegrationMitra, configureMitra, configureSdkMitra, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, listIntegrationsMitra, listRecordsMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, logoutMitra, patchRecordMitra, resolveProjectId, 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 IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, 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, listIntegrationsMitra, listRecordsMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, resolveProjectId, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra };

package/dist/index.d.ts

@@ -1,40 +1,3 @@
-/**
- * Mitra Interactions SDK - Configuração
- */
-interface MitraConfig {
-    /** URL base da API (ex: https://api.mitra.com) */
-    baseURL: string;
-    /** Token JWT para autenticação */
-    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/) */
-    authUrl?: string;
-    /** ID do projeto (usado como fallback nos métodos de login e serviços) */
-    projectId?: number;
-}
-/**
- * Configura o SDK globalmente e persiste no localStorage.
- */
-declare function configureSdkMitra(config: MitraConfig): void;
-/**
- * Obtém a configuração atual
- */
-declare function getConfig(): MitraConfig;
-/**
- * Resolve projectId: usa o valor passado, senão pega do config salvo.
- */
-declare function resolveProjectId(projectId?: number): number;
-/**
- * Auto-configura o SDK.
- * 1. Verifica query params (token + backURL) — se encontrar, salva no store e configura.
- * 2. Se não tem params, tenta carregar do localStorage.
- * Retorna { configured: true } se configurou, ou { configured: false } caso contrário.
- */
-declare function configureMitra(): {
-    configured: boolean;
-};
-
 /**
  * Mitra Interactions SDK - Types
  */
@@ -252,6 +215,66 @@ interface StopServerFunctionExecutionResponse {
     };
 }
 
+/**
+ * Mitra Interactions SDK - Instance
+ *
+ * Permite múltiplas instâncias configuradas independentemente.
+ */
+
+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>;
+    setVariable(options: SetVariableOptions): Promise<SetVariableResponse>;
+    executeServerFunction(options: ExecuteServerFunctionOptions): Promise<ExecuteServerFunctionResponse>;
+    executeServerFunctionAsync(options: ExecuteServerFunctionAsyncOptions): Promise<ExecuteServerFunctionAsyncResponse>;
+    stopServerFunctionExecution(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
+    listIntegrations(options?: ListIntegrationsOptions): Promise<IntegrationResponse[]>;
+    callIntegration(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
+    listRecords(options: ListRecordsOptions): Promise<ListRecordsResponse>;
+    getRecord(options: GetRecordOptions): Promise<Record<string, any>>;
+    createRecord(options: CreateRecordOptions): Promise<Record<string, any>>;
+    updateRecord(options: UpdateRecordOptions): Promise<Record<string, any>>;
+    patchRecord(options: PatchRecordOptions): Promise<Record<string, any>>;
+    deleteRecord(options: DeleteRecordOptions): Promise<void>;
+    createRecordsBatch(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
+}
+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;
+    /** Token JWT para autenticação */
+    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/) */
+    authUrl?: string;
+    /** ID do projeto (usado como fallback nos métodos de login e serviços) */
+    projectId?: number;
+}
+/**
+ * Configura o SDK globalmente e retorna uma instância configurada.
+ */
+declare function configureSdkMitra(config: MitraConfig): MitraInstance;
+/**
+ * Obtém a configuração atual
+ */
+declare function getConfig(): MitraConfig;
+/**
+ * Resolve projectId: usa o valor passado, senão pega do config salvo.
+ */
+declare function resolveProjectId(projectId?: number): number;
+
 /**
  * Mitra Interactions SDK - Autenticação
  *
@@ -280,6 +303,11 @@ declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResp
  * Se passados, sobrescrevem os valores salvos.
  */
 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.
+ */
+declare function loginMitra(method: 'email' | 'google' | 'microsoft', options?: LoginOptions): Promise<LoginResponse>;
 
 /**
  * Mitra Interactions SDK - Services
@@ -338,11 +366,5 @@ declare function updateRecordMitra(options: UpdateRecordOptions): Promise<Record
 declare function patchRecordMitra(options: PatchRecordOptions): Promise<Record<string, any>>;
 declare function deleteRecordMitra(options: DeleteRecordOptions): Promise<void>;
 declare function createRecordsBatchMitra(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
-/**
- * Realiza logout do SDK.
- * - Se embarcado no Mitra (iframe): envia postMessage pro app pai solicitando logout.
- * - Se standalone: limpa config (memória + localStorage) e redireciona pro redirectPath se informado.
- */
-declare function logoutMitra(redirectPath?: string): void;
 
-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 IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type LoginOptions, type LoginResponse, type MitraConfig, type PatchRecordOptions, type RunQueryOptions, type RunQueryResponse, type SetFileStatusOptions, type SetFileStatusResponse, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, callIntegrationMitra, configureMitra, configureSdkMitra, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, executeDbActionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getConfig, getRecordMitra, listIntegrationsMitra, listRecordsMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, logoutMitra, patchRecordMitra, resolveProjectId, 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 IntegrationResponse, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, 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, listIntegrationsMitra, listRecordsMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, patchRecordMitra, resolveProjectId, runQueryMitra, setFileStatusMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateRecordMitra };