portal-aiatende-api 0.5.6 → 0.7.0

package/dist/index.d.mts

@@ -379,6 +379,16 @@ interface MessagingConversation {
     aiCareStatusSetByName: string | null;
     /** Só presente na resposta do GET de detalhe (não na listagem). */
     aiResumeMode?: AiResumeMode | null;
+    /**
+     * Resumo + motivo do último handoff (IA -> humano) — guardam só a transferência mais recente,
+     * sem histórico (uma nova transferência sobrescreve). `summary` é congelado no momento do
+     * handoff (não atualizado a cada resposta da IA). Ver Conversation.summary/handoffReason em
+     * prisma/schema.prisma do Portal.
+     */
+    summary?: string | null;
+    handoffReason?: string | null;
+    handoffSetAt?: Date | string | null;
+    handoffSetByName?: string | null;
     /**
      * Lead da Kommo dono desse mesmo número de telefone — hoje toda a movimentação/tools da IA
      * (agendamento, mover pipeline, etc.) opera em cima de um lead_id da Kommo; este canal não tem
@@ -456,6 +466,18 @@ interface PatchConversationPayload {
     kommoLeadId?: number | null;
     /** Status de triagem, puramente organizacional (não bloqueia envio/recebimento). Reabre sozinho ('open') com qualquer mensagem inbound nova. */
     status?: 'open' | 'closed';
+    /**
+     * Resumo da conversa, congelado no momento do handoff — reaproveita o `resumo_conversa` que
+     * as tools de handoff já pedem ao modelo hoje. Não é recalculado a cada resposta da IA.
+     */
+    summary?: string;
+    /**
+     * Motivo do handoff/perda — texto livre de propósito (sem lista fechada de opções no Portal:
+     * um valor nunca visto antes é aceito e passa a aparecer nas sugestões da UI sozinho). Quando
+     * enviado junto com `aiCareStatus: 'INACTIVE'` sem `assignedToId` explícito, o Portal pode
+     * auto-atribuir a conversa por round-robin (ver MessagingConfig.assignmentMode).
+     */
+    handoffReason?: string;
 }
 /**
  * `actor` só é respeitado pelo Portal quando o chamador é um papel de sistema/staff (ex.: o
@@ -578,12 +600,83 @@ declare class MessagingResource extends BaseResource {
     downloadMedia(clientId: string, mediaId: string): Promise<DownloadMediaResponse>;
 }
 
+type ContactFieldType = 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'DATE' | 'DATETIME' | 'BOOLEAN' | 'SELECT' | 'MULTISELECT';
+interface ContactFieldOption {
+    value: string;
+    label: string;
+}
+/** Espelha ContactFieldDefinition (prisma/schema.prisma) do Portal. */
+interface ContactFieldDefinition {
+    id: string;
+    clientId: string;
+    /** Chave estável — é a que deve ser usada em Contact.customFields e em UpdateContactPayload.customFields. */
+    key: string;
+    label: string;
+    type: ContactFieldType;
+    /** Array<{value,label}> — só quando type é SELECT ou MULTISELECT. */
+    options: ContactFieldOption[] | null;
+    required: boolean;
+    order: number;
+    createdAt: string;
+    updatedAt: string;
+    [key: string]: unknown;
+}
+/** Espelha Contact (prisma/schema.prisma) do Portal. */
+interface Contact {
+    id: string;
+    clientId: string;
+    phone: string;
+    name: string | null;
+    email: string | null;
+    company: string | null;
+    jobTitle: string | null;
+    /** Chaves são `ContactFieldDefinition.key`; tipo/formato de cada valor depende do tipo do campo. */
+    customFields: Record<string, unknown>;
+    kommoLeadId: number | null;
+    createdAt: string;
+    updatedAt: string;
+    [key: string]: unknown;
+}
+interface ContactByConversationResponse {
+    /** null quando a conversa ainda não tem telefone resolvível (caso raro/defensivo). */
+    contact: Contact | null;
+    definitions: ContactFieldDefinition[];
+    kommoSubdomain: string | null;
+}
+interface UpdateContactPayload {
+    name?: string | null;
+    email?: string | null;
+    company?: string | null;
+    jobTitle?: string | null;
+    /**
+     * SUBSTITUI Contact.customFields por inteiro (não mescla) — quem chama precisa mandar todas
+     * as chaves que quer preservar, não só as que mudaram. Chaves reconhecidas (com
+     * ContactFieldDefinition correspondente) são validadas/coeridas pelo tipo do campo no Portal;
+     * chaves sem definição são preservadas sem validação.
+     */
+    customFields?: Record<string, unknown>;
+}
+
+/**
+ * Entidade Contact do Portal (dados padrão + customFields dinâmico por cliente) — proxy pras
+ * rotas `/api/clients/{clientId}/contacts/...`. Deliberadamente restrito a `by-conversation`
+ * (sem list/getById): o atende360-assistant sempre opera dentro de uma conversa
+ * (`portalConversationRef.conversationId`), nunca já tem um `contactId` em mãos.
+ */
+declare class ContactsResource extends BaseResource {
+    getByConversation(clientId: string, conversationId: string): Promise<ContactByConversationResponse>;
+    updateByConversation(clientId: string, conversationId: string, payload: UpdateContactPayload): Promise<{
+        contact: Contact;
+    }>;
+}
+
 declare class PortalClient {
     config: PortalClientConfig;
     httpClient: AxiosInstance;
     clients: ClientsResource;
     knowledge: KnowledgeResource;
     messaging: MessagingResource;
+    contacts: ContactsResource;
     constructor(config: PortalClientConfig);
 }
 
@@ -593,4 +686,4 @@ declare class PortalApiError extends Error {
     constructor(message: string, info?: Partial<PortalApiError>);
 }
 
-export { type AiActivationSchedule, type AiCareStatus, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type AiResumeMode, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type ConversationHistoryMessage, type CreateToolEventPayload, type DateException, type DownloadMediaResponse, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type ListConversationsFilters, type LossReasonMapping, type MessagingContact, type MessagingConversation, type MessagingConversationsListResponse, type MessagingMediaItem, type MessagingMessage, type MessagingMessagesListResponse, type MessagingPhoneNumber, MessagingResource, type NudgeSettings, type PatchConversationPayload, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type SendMessagePayload, type SendMessageResponse, type StageMapping, type TimeRange, type UploadMediaPayload, type UploadMediaResponse, type Wazzup, type WazzupChannel };
+export { type AiActivationSchedule, type AiCareStatus, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type AiResumeMode, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type Contact, type ContactByConversationResponse, type ContactFieldDefinition, type ContactFieldOption, type ContactFieldType, ContactsResource, type ConversationHistoryMessage, type CreateToolEventPayload, type DateException, type DownloadMediaResponse, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type ListConversationsFilters, type LossReasonMapping, type MessagingContact, type MessagingConversation, type MessagingConversationsListResponse, type MessagingMediaItem, type MessagingMessage, type MessagingMessagesListResponse, type MessagingPhoneNumber, MessagingResource, type NudgeSettings, type PatchConversationPayload, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type SendMessagePayload, type SendMessageResponse, type StageMapping, type TimeRange, type UpdateContactPayload, type UploadMediaPayload, type UploadMediaResponse, type Wazzup, type WazzupChannel };

package/dist/index.d.ts

@@ -379,6 +379,16 @@ interface MessagingConversation {
     aiCareStatusSetByName: string | null;
     /** Só presente na resposta do GET de detalhe (não na listagem). */
     aiResumeMode?: AiResumeMode | null;
+    /**
+     * Resumo + motivo do último handoff (IA -> humano) — guardam só a transferência mais recente,
+     * sem histórico (uma nova transferência sobrescreve). `summary` é congelado no momento do
+     * handoff (não atualizado a cada resposta da IA). Ver Conversation.summary/handoffReason em
+     * prisma/schema.prisma do Portal.
+     */
+    summary?: string | null;
+    handoffReason?: string | null;
+    handoffSetAt?: Date | string | null;
+    handoffSetByName?: string | null;
     /**
      * Lead da Kommo dono desse mesmo número de telefone — hoje toda a movimentação/tools da IA
      * (agendamento, mover pipeline, etc.) opera em cima de um lead_id da Kommo; este canal não tem
@@ -456,6 +466,18 @@ interface PatchConversationPayload {
     kommoLeadId?: number | null;
     /** Status de triagem, puramente organizacional (não bloqueia envio/recebimento). Reabre sozinho ('open') com qualquer mensagem inbound nova. */
     status?: 'open' | 'closed';
+    /**
+     * Resumo da conversa, congelado no momento do handoff — reaproveita o `resumo_conversa` que
+     * as tools de handoff já pedem ao modelo hoje. Não é recalculado a cada resposta da IA.
+     */
+    summary?: string;
+    /**
+     * Motivo do handoff/perda — texto livre de propósito (sem lista fechada de opções no Portal:
+     * um valor nunca visto antes é aceito e passa a aparecer nas sugestões da UI sozinho). Quando
+     * enviado junto com `aiCareStatus: 'INACTIVE'` sem `assignedToId` explícito, o Portal pode
+     * auto-atribuir a conversa por round-robin (ver MessagingConfig.assignmentMode).
+     */
+    handoffReason?: string;
 }
 /**
  * `actor` só é respeitado pelo Portal quando o chamador é um papel de sistema/staff (ex.: o
@@ -578,12 +600,83 @@ declare class MessagingResource extends BaseResource {
     downloadMedia(clientId: string, mediaId: string): Promise<DownloadMediaResponse>;
 }
 
+type ContactFieldType = 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'DATE' | 'DATETIME' | 'BOOLEAN' | 'SELECT' | 'MULTISELECT';
+interface ContactFieldOption {
+    value: string;
+    label: string;
+}
+/** Espelha ContactFieldDefinition (prisma/schema.prisma) do Portal. */
+interface ContactFieldDefinition {
+    id: string;
+    clientId: string;
+    /** Chave estável — é a que deve ser usada em Contact.customFields e em UpdateContactPayload.customFields. */
+    key: string;
+    label: string;
+    type: ContactFieldType;
+    /** Array<{value,label}> — só quando type é SELECT ou MULTISELECT. */
+    options: ContactFieldOption[] | null;
+    required: boolean;
+    order: number;
+    createdAt: string;
+    updatedAt: string;
+    [key: string]: unknown;
+}
+/** Espelha Contact (prisma/schema.prisma) do Portal. */
+interface Contact {
+    id: string;
+    clientId: string;
+    phone: string;
+    name: string | null;
+    email: string | null;
+    company: string | null;
+    jobTitle: string | null;
+    /** Chaves são `ContactFieldDefinition.key`; tipo/formato de cada valor depende do tipo do campo. */
+    customFields: Record<string, unknown>;
+    kommoLeadId: number | null;
+    createdAt: string;
+    updatedAt: string;
+    [key: string]: unknown;
+}
+interface ContactByConversationResponse {
+    /** null quando a conversa ainda não tem telefone resolvível (caso raro/defensivo). */
+    contact: Contact | null;
+    definitions: ContactFieldDefinition[];
+    kommoSubdomain: string | null;
+}
+interface UpdateContactPayload {
+    name?: string | null;
+    email?: string | null;
+    company?: string | null;
+    jobTitle?: string | null;
+    /**
+     * SUBSTITUI Contact.customFields por inteiro (não mescla) — quem chama precisa mandar todas
+     * as chaves que quer preservar, não só as que mudaram. Chaves reconhecidas (com
+     * ContactFieldDefinition correspondente) são validadas/coeridas pelo tipo do campo no Portal;
+     * chaves sem definição são preservadas sem validação.
+     */
+    customFields?: Record<string, unknown>;
+}
+
+/**
+ * Entidade Contact do Portal (dados padrão + customFields dinâmico por cliente) — proxy pras
+ * rotas `/api/clients/{clientId}/contacts/...`. Deliberadamente restrito a `by-conversation`
+ * (sem list/getById): o atende360-assistant sempre opera dentro de uma conversa
+ * (`portalConversationRef.conversationId`), nunca já tem um `contactId` em mãos.
+ */
+declare class ContactsResource extends BaseResource {
+    getByConversation(clientId: string, conversationId: string): Promise<ContactByConversationResponse>;
+    updateByConversation(clientId: string, conversationId: string, payload: UpdateContactPayload): Promise<{
+        contact: Contact;
+    }>;
+}
+
 declare class PortalClient {
     config: PortalClientConfig;
     httpClient: AxiosInstance;
     clients: ClientsResource;
     knowledge: KnowledgeResource;
     messaging: MessagingResource;
+    contacts: ContactsResource;
     constructor(config: PortalClientConfig);
 }
 
@@ -593,4 +686,4 @@ declare class PortalApiError extends Error {
     constructor(message: string, info?: Partial<PortalApiError>);
 }
 
-export { type AiActivationSchedule, type AiCareStatus, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type AiResumeMode, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type ConversationHistoryMessage, type CreateToolEventPayload, type DateException, type DownloadMediaResponse, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type ListConversationsFilters, type LossReasonMapping, type MessagingContact, type MessagingConversation, type MessagingConversationsListResponse, type MessagingMediaItem, type MessagingMessage, type MessagingMessagesListResponse, type MessagingPhoneNumber, MessagingResource, type NudgeSettings, type PatchConversationPayload, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type SendMessagePayload, type SendMessageResponse, type StageMapping, type TimeRange, type UploadMediaPayload, type UploadMediaResponse, type Wazzup, type WazzupChannel };
+export { type AiActivationSchedule, type AiCareStatus, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type AiResumeMode, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type Contact, type ContactByConversationResponse, type ContactFieldDefinition, type ContactFieldOption, type ContactFieldType, ContactsResource, type ConversationHistoryMessage, type CreateToolEventPayload, type DateException, type DownloadMediaResponse, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type ListConversationsFilters, type LossReasonMapping, type MessagingContact, type MessagingConversation, type MessagingConversationsListResponse, type MessagingMediaItem, type MessagingMessage, type MessagingMessagesListResponse, type MessagingPhoneNumber, MessagingResource, type NudgeSettings, type PatchConversationPayload, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type SendMessagePayload, type SendMessageResponse, type StageMapping, type TimeRange, type UpdateContactPayload, type UploadMediaPayload, type UploadMediaResponse, type Wazzup, type WazzupChannel };

package/dist/index.js

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ClientsResource: () => ClientsResource,
+  ContactsResource: () => ContactsResource,
   KnowledgeResource: () => KnowledgeResource,
   MessagingResource: () => MessagingResource,
   PortalApiError: () => PortalApiError,
@@ -239,6 +240,23 @@ var MessagingResource = class extends BaseResource {
   }
 };
 
+// src/resources/contacts/index.ts
+var ContactsResource = class extends BaseResource {
+  async getByConversation(clientId, conversationId) {
+    const response = await this.client.get(
+      `/api/clients/${clientId}/contacts/by-conversation/${conversationId}`
+    );
+    return response.data;
+  }
+  async updateByConversation(clientId, conversationId, payload) {
+    const response = await this.client.patch(
+      `/api/clients/${clientId}/contacts/by-conversation/${conversationId}`,
+      payload
+    );
+    return response.data;
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://portal.aiatende.com.br";
 var PortalClient = class {
@@ -247,6 +265,7 @@ var PortalClient = class {
   clients;
   knowledge;
   messaging;
+  contacts;
   constructor(config) {
     this.config = config;
     this.httpClient = import_axios.default.create({
@@ -273,11 +292,13 @@ var PortalClient = class {
     this.clients = new ClientsResource(this.httpClient);
     this.knowledge = new KnowledgeResource(this.httpClient);
     this.messaging = new MessagingResource(this.httpClient);
+    this.contacts = new ContactsResource(this.httpClient);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ClientsResource,
+  ContactsResource,
   KnowledgeResource,
   MessagingResource,
   PortalApiError,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/base.ts","../src/errors.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/resources/messaging/index.ts"],"sourcesContent":["export * from './client';\nexport * from './types';\nexport * from './errors';\nexport * from './resources/clients';\nexport * from './resources/clients/types';\nexport * from './resources/knowledge';\nexport * from './resources/knowledge/types';\nexport * from './resources/messaging';\nexport * from './resources/messaging/types';\n","import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { MessagingResource } from './resources/messaging';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n  public messaging: MessagingResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n    this.messaging = new MessagingResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n","import { BaseResource } from '../../base';\nimport { PortalApiError } from '../../errors';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /**\n   * Busca o Client pelo seu id direto (`GET /api/clients/{id}`) — inclui `aiConfig` e\n   * `messagingConfig` (sem a API key criptografada). Usado pelo canal aiatendeWa, que resolve o\n   * tenant a partir do `clientId` já incluído no payload do relay de webhook, sem precisar de\n   * um identificador de canal indireto como Kommo subdomain ou Wazzup channelId.\n   */\n  async getById(clientId: string): Promise<Client | null> {\n    try {\n      const response = await this.client.get<Client>(`/api/clients/${clientId}`);\n      return response.data;\n    } catch (error) {\n      if (error instanceof PortalApiError && error.status === 404) return null;\n      throw error;\n    }\n  }\n}\n","import { z } from 'zod';\nimport { BaseResource } from '../../base';\nimport { PortalApiError } from '../../errors';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nconst internalContextChunkSchema = z.object({\n  chunkId: z.string().optional(),\n  content: z.string(),\n  similarity: z.number(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst internalContextResultSchema = z.array(internalContextChunkSchema);\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<unknown>('/api/knowledge/internal/context', {\n      aiConfigId: params.aiConfigId,\n      question: params.question,\n      conversationHistory: params.conversationHistory\n    });\n\n    const parsed = internalContextResultSchema.safeParse(response.data);\n    if (!parsed.success) {\n      throw new PortalApiError('Resposta inválida de /api/knowledge/internal/context', {\n        raw: parsed.error.flatten(),\n      });\n    }\n    return parsed.data;\n  }\n}\n","import { BaseResource } from '../../base';\nimport {\n  CreateToolEventPayload,\n  DownloadMediaResponse,\n  ListConversationsFilters,\n  MessagingConversation,\n  MessagingConversationsListResponse,\n  MessagingMessagesListResponse,\n  PatchConversationPayload,\n  SendMessagePayload,\n  SendMessageResponse,\n  UploadMediaPayload,\n  UploadMediaResponse,\n} from './types';\n\n/**\n * Canal WhatsApp direto (aiatendeWa) — proxy pras rotas `/api/clients/{clientId}/messaging/...`\n * do Portal, que por sua vez falam com a plataforma de mensageria própria\n * (plataforma_whatsapp_coexistence). O atende360-assistant nunca fala direto com essa\n * plataforma — sempre por aqui, autenticado via a mesma `apiKey`/APP_API_KEY já usada pro\n * resto do SDK.\n */\nexport class MessagingResource extends BaseResource {\n  async listConversations(\n    clientId: string,\n    filters?: ListConversationsFilters,\n  ): Promise<MessagingConversationsListResponse> {\n    const response = await this.client.get<MessagingConversationsListResponse>(\n      `/api/clients/${clientId}/messaging/conversations`,\n      { params: filters },\n    );\n    return response.data;\n  }\n\n  async getConversation(clientId: string, conversationId: string): Promise<MessagingConversation> {\n    const response = await this.client.get<MessagingConversation>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,\n    );\n    return response.data;\n  }\n\n  async patchConversation(\n    clientId: string,\n    conversationId: string,\n    payload: PatchConversationPayload,\n  ): Promise<MessagingConversation> {\n    const response = await this.client.patch<MessagingConversation>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,\n      payload,\n    );\n    return response.data;\n  }\n\n  async getMessages(\n    clientId: string,\n    conversationId: string,\n    params?: { page?: number; limit?: number },\n  ): Promise<MessagingMessagesListResponse> {\n    const response = await this.client.get<MessagingMessagesListResponse>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,\n      { params },\n    );\n    return response.data;\n  }\n\n  async sendMessage(\n    clientId: string,\n    conversationId: string,\n    payload: SendMessagePayload,\n  ): Promise<SendMessageResponse> {\n    const response = await this.client.post<SendMessageResponse>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,\n      payload,\n    );\n    return response.data;\n  }\n\n  /**\n   * Upload de mídia (ex.: áudio gerado por TTS) — pré-requisito pra mandar `type: 'audio'` no\n   * `sendMessage` (o `content.id` retornado aqui vira `content.id` do envio; `storagePath`\n   * precisa ser ecoado em `content._media.storagePath` no send, senão a plataforma não cria o\n   * registro de mídia local pra conexões Cloud API).\n   */\n  async uploadMedia(clientId: string, payload: UploadMediaPayload): Promise<UploadMediaResponse> {\n    const form = new FormData();\n    // Ordem importa: phoneNumberId/isVoiceNote precisam vir ANTES de file no multipart — o\n    // parser do Portal (e o da plataforma por trás dele) lê em stream.\n    form.append('phoneNumberId', payload.phoneNumberId);\n    if (payload.isVoiceNote) form.append('isVoiceNote', 'true');\n    form.append(\n      'file',\n      new Blob([new Uint8Array(payload.file)], { type: payload.mimeType }),\n      payload.filename,\n    );\n\n    const response = await this.client.post<UploadMediaResponse>(\n      `/api/clients/${clientId}/messaging/media`,\n      form,\n      // A instância do axios (client.ts) fixa Content-Type: application/json como default —\n      // sem isto, esse header explícito vence e nunca deixa o axios detectar o FormData nativo\n      // e gerar o multipart/form-data; boundary=... correto. `undefined` remove o default do\n      // merge de headers só nesta chamada, liberando a detecção automática.\n      { headers: { 'Content-Type': undefined } },\n    );\n    return response.data;\n  }\n\n  /**\n   * Registra a execução de uma tool da IA (canal aiatendeWa) como uma mensagem 'internal' na\n   * conversa — visível no Portal, nunca despachada pro WhatsApp. Idempotente por `toolCallId`\n   * (upsert do lado do Portal — retry seguro).\n   */\n  async createToolEvent(\n    clientId: string,\n    conversationId: string,\n    payload: CreateToolEventPayload,\n  ): Promise<{ id: string }> {\n    const response = await this.client.post<{ id: string }>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/tool-events`,\n      payload,\n    );\n    return response.data;\n  }\n\n  /**\n   * Resolve a conversa local (aiatendeWa) vinculada a um lead da Kommo, se existir — usado pelo\n   * KommoServices.setAiStateTag do atende360-assistant pra também atualizar\n   * Conversation.aiCareStatus no Portal quando a tag de IA de um lead muda pela Kommo/Wazzup.\n   */\n  async getConversationByKommoLead(\n    clientId: string,\n    kommoLeadId: number,\n  ): Promise<{ conversationId: string | null }> {\n    const response = await this.client.get<{ conversationId: string | null }>(\n      `/api/clients/${clientId}/messaging/conversations/by-kommo-lead`,\n      { params: { kommoLeadId } },\n    );\n    return response.data;\n  }\n\n  /**\n   * Mostra \"digitando...\" pro lead no WhatsApp (canal aiatendeWa, só Cloud API — sem\n   * equivalente no WhatsApp Lite). A Portal já implementa isso ponta a ponta (usado hoje só\n   * pelo atendente humano digitando no textarea do Portal); este método só expõe a mesma rota\n   * pro atende360-assistant poder chamar antes/durante o processamento da IA.\n   */\n  async sendTyping(\n    clientId: string,\n    conversationId: string,\n  ): Promise<{ status: string; reason?: string }> {\n    const response = await this.client.post<{ status: string; reason?: string }>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/typing`,\n    );\n    return response.data;\n  }\n\n  /**\n   * Baixa os bytes de um anexo (Message.media[].id) — usado hoje só pelo caminho de imagem do\n   * canal aiatendeWa (monta uma data URI pra mandar pro modelo de visão, já que a URL não pode\n   * ser pública). Áudio/PDF seguem passando a URL autenticada direto pros métodos de\n   * transcrição/extração do atende360-assistant, sem baixar bytes por aqui.\n   */\n  async downloadMedia(clientId: string, mediaId: string): Promise<DownloadMediaResponse> {\n    const response = await this.client.get<ArrayBuffer>(\n      `/api/clients/${clientId}/messaging/media/${mediaId}`,\n      { responseType: 'arraybuffer' },\n    );\n    return {\n      data: Buffer.from(response.data),\n      contentType: (response.headers['content-type'] as string) || 'application/octet-stream',\n    };\n  }\n}\n"],"mappings":"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","names":["axios"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/base.ts","../src/errors.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/resources/messaging/index.ts","../src/resources/contacts/index.ts"],"sourcesContent":["export * from './client';\nexport * from './types';\nexport * from './errors';\nexport * from './resources/clients';\nexport * from './resources/clients/types';\nexport * from './resources/knowledge';\nexport * from './resources/knowledge/types';\nexport * from './resources/messaging';\nexport * from './resources/messaging/types';\nexport * from './resources/contacts';\nexport * from './resources/contacts/types';\n","import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { MessagingResource } from './resources/messaging';\nimport { ContactsResource } from './resources/contacts';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n  public messaging: MessagingResource;\n  public contacts: ContactsResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n    this.messaging = new MessagingResource(this.httpClient);\n    this.contacts = new ContactsResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n","import { BaseResource } from '../../base';\nimport { PortalApiError } from '../../errors';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /**\n   * Busca o Client pelo seu id direto (`GET /api/clients/{id}`) — inclui `aiConfig` e\n   * `messagingConfig` (sem a API key criptografada). Usado pelo canal aiatendeWa, que resolve o\n   * tenant a partir do `clientId` já incluído no payload do relay de webhook, sem precisar de\n   * um identificador de canal indireto como Kommo subdomain ou Wazzup channelId.\n   */\n  async getById(clientId: string): Promise<Client | null> {\n    try {\n      const response = await this.client.get<Client>(`/api/clients/${clientId}`);\n      return response.data;\n    } catch (error) {\n      if (error instanceof PortalApiError && error.status === 404) return null;\n      throw error;\n    }\n  }\n}\n","import { z } from 'zod';\nimport { BaseResource } from '../../base';\nimport { PortalApiError } from '../../errors';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nconst internalContextChunkSchema = z.object({\n  chunkId: z.string().optional(),\n  content: z.string(),\n  similarity: z.number(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst internalContextResultSchema = z.array(internalContextChunkSchema);\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<unknown>('/api/knowledge/internal/context', {\n      aiConfigId: params.aiConfigId,\n      question: params.question,\n      conversationHistory: params.conversationHistory\n    });\n\n    const parsed = internalContextResultSchema.safeParse(response.data);\n    if (!parsed.success) {\n      throw new PortalApiError('Resposta inválida de /api/knowledge/internal/context', {\n        raw: parsed.error.flatten(),\n      });\n    }\n    return parsed.data;\n  }\n}\n","import { BaseResource } from '../../base';\nimport {\n  CreateToolEventPayload,\n  DownloadMediaResponse,\n  ListConversationsFilters,\n  MessagingConversation,\n  MessagingConversationsListResponse,\n  MessagingMessagesListResponse,\n  PatchConversationPayload,\n  SendMessagePayload,\n  SendMessageResponse,\n  UploadMediaPayload,\n  UploadMediaResponse,\n} from './types';\n\n/**\n * Canal WhatsApp direto (aiatendeWa) — proxy pras rotas `/api/clients/{clientId}/messaging/...`\n * do Portal, que por sua vez falam com a plataforma de mensageria própria\n * (plataforma_whatsapp_coexistence). O atende360-assistant nunca fala direto com essa\n * plataforma — sempre por aqui, autenticado via a mesma `apiKey`/APP_API_KEY já usada pro\n * resto do SDK.\n */\nexport class MessagingResource extends BaseResource {\n  async listConversations(\n    clientId: string,\n    filters?: ListConversationsFilters,\n  ): Promise<MessagingConversationsListResponse> {\n    const response = await this.client.get<MessagingConversationsListResponse>(\n      `/api/clients/${clientId}/messaging/conversations`,\n      { params: filters },\n    );\n    return response.data;\n  }\n\n  async getConversation(clientId: string, conversationId: string): Promise<MessagingConversation> {\n    const response = await this.client.get<MessagingConversation>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,\n    );\n    return response.data;\n  }\n\n  async patchConversation(\n    clientId: string,\n    conversationId: string,\n    payload: PatchConversationPayload,\n  ): Promise<MessagingConversation> {\n    const response = await this.client.patch<MessagingConversation>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,\n      payload,\n    );\n    return response.data;\n  }\n\n  async getMessages(\n    clientId: string,\n    conversationId: string,\n    params?: { page?: number; limit?: number },\n  ): Promise<MessagingMessagesListResponse> {\n    const response = await this.client.get<MessagingMessagesListResponse>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,\n      { params },\n    );\n    return response.data;\n  }\n\n  async sendMessage(\n    clientId: string,\n    conversationId: string,\n    payload: SendMessagePayload,\n  ): Promise<SendMessageResponse> {\n    const response = await this.client.post<SendMessageResponse>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,\n      payload,\n    );\n    return response.data;\n  }\n\n  /**\n   * Upload de mídia (ex.: áudio gerado por TTS) — pré-requisito pra mandar `type: 'audio'` no\n   * `sendMessage` (o `content.id` retornado aqui vira `content.id` do envio; `storagePath`\n   * precisa ser ecoado em `content._media.storagePath` no send, senão a plataforma não cria o\n   * registro de mídia local pra conexões Cloud API).\n   */\n  async uploadMedia(clientId: string, payload: UploadMediaPayload): Promise<UploadMediaResponse> {\n    const form = new FormData();\n    // Ordem importa: phoneNumberId/isVoiceNote precisam vir ANTES de file no multipart — o\n    // parser do Portal (e o da plataforma por trás dele) lê em stream.\n    form.append('phoneNumberId', payload.phoneNumberId);\n    if (payload.isVoiceNote) form.append('isVoiceNote', 'true');\n    form.append(\n      'file',\n      new Blob([new Uint8Array(payload.file)], { type: payload.mimeType }),\n      payload.filename,\n    );\n\n    const response = await this.client.post<UploadMediaResponse>(\n      `/api/clients/${clientId}/messaging/media`,\n      form,\n      // A instância do axios (client.ts) fixa Content-Type: application/json como default —\n      // sem isto, esse header explícito vence e nunca deixa o axios detectar o FormData nativo\n      // e gerar o multipart/form-data; boundary=... correto. `undefined` remove o default do\n      // merge de headers só nesta chamada, liberando a detecção automática.\n      { headers: { 'Content-Type': undefined } },\n    );\n    return response.data;\n  }\n\n  /**\n   * Registra a execução de uma tool da IA (canal aiatendeWa) como uma mensagem 'internal' na\n   * conversa — visível no Portal, nunca despachada pro WhatsApp. Idempotente por `toolCallId`\n   * (upsert do lado do Portal — retry seguro).\n   */\n  async createToolEvent(\n    clientId: string,\n    conversationId: string,\n    payload: CreateToolEventPayload,\n  ): Promise<{ id: string }> {\n    const response = await this.client.post<{ id: string }>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/tool-events`,\n      payload,\n    );\n    return response.data;\n  }\n\n  /**\n   * Resolve a conversa local (aiatendeWa) vinculada a um lead da Kommo, se existir — usado pelo\n   * KommoServices.setAiStateTag do atende360-assistant pra também atualizar\n   * Conversation.aiCareStatus no Portal quando a tag de IA de um lead muda pela Kommo/Wazzup.\n   */\n  async getConversationByKommoLead(\n    clientId: string,\n    kommoLeadId: number,\n  ): Promise<{ conversationId: string | null }> {\n    const response = await this.client.get<{ conversationId: string | null }>(\n      `/api/clients/${clientId}/messaging/conversations/by-kommo-lead`,\n      { params: { kommoLeadId } },\n    );\n    return response.data;\n  }\n\n  /**\n   * Mostra \"digitando...\" pro lead no WhatsApp (canal aiatendeWa, só Cloud API — sem\n   * equivalente no WhatsApp Lite). A Portal já implementa isso ponta a ponta (usado hoje só\n   * pelo atendente humano digitando no textarea do Portal); este método só expõe a mesma rota\n   * pro atende360-assistant poder chamar antes/durante o processamento da IA.\n   */\n  async sendTyping(\n    clientId: string,\n    conversationId: string,\n  ): Promise<{ status: string; reason?: string }> {\n    const response = await this.client.post<{ status: string; reason?: string }>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/typing`,\n    );\n    return response.data;\n  }\n\n  /**\n   * Baixa os bytes de um anexo (Message.media[].id) — usado hoje só pelo caminho de imagem do\n   * canal aiatendeWa (monta uma data URI pra mandar pro modelo de visão, já que a URL não pode\n   * ser pública). Áudio/PDF seguem passando a URL autenticada direto pros métodos de\n   * transcrição/extração do atende360-assistant, sem baixar bytes por aqui.\n   */\n  async downloadMedia(clientId: string, mediaId: string): Promise<DownloadMediaResponse> {\n    const response = await this.client.get<ArrayBuffer>(\n      `/api/clients/${clientId}/messaging/media/${mediaId}`,\n      { responseType: 'arraybuffer' },\n    );\n    return {\n      data: Buffer.from(response.data),\n      contentType: (response.headers['content-type'] as string) || 'application/octet-stream',\n    };\n  }\n}\n","import { BaseResource } from '../../base';\nimport { ContactByConversationResponse, Contact, UpdateContactPayload } from './types';\n\n/**\n * Entidade Contact do Portal (dados padrão + customFields dinâmico por cliente) — proxy pras\n * rotas `/api/clients/{clientId}/contacts/...`. Deliberadamente restrito a `by-conversation`\n * (sem list/getById): o atende360-assistant sempre opera dentro de uma conversa\n * (`portalConversationRef.conversationId`), nunca já tem um `contactId` em mãos.\n */\nexport class ContactsResource extends BaseResource {\n  async getByConversation(\n    clientId: string,\n    conversationId: string,\n  ): Promise<ContactByConversationResponse> {\n    const response = await this.client.get<ContactByConversationResponse>(\n      `/api/clients/${clientId}/contacts/by-conversation/${conversationId}`,\n    );\n    return response.data;\n  }\n\n  async updateByConversation(\n    clientId: string,\n    conversationId: string,\n    payload: UpdateContactPayload,\n  ): Promise<{ contact: Contact }> {\n    const response = await this.client.patch<{ contact: Contact }>(\n      `/api/clients/${clientId}/contacts/by-conversation/${conversationId}`,\n      payload,\n    );\n    return response.data;\n  }\n}\n"],"mappings":"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","names":["axios"]}

package/dist/index.mjs

@@ -199,6 +199,23 @@ var MessagingResource = class extends BaseResource {
   }
 };
 
+// src/resources/contacts/index.ts
+var ContactsResource = class extends BaseResource {
+  async getByConversation(clientId, conversationId) {
+    const response = await this.client.get(
+      `/api/clients/${clientId}/contacts/by-conversation/${conversationId}`
+    );
+    return response.data;
+  }
+  async updateByConversation(clientId, conversationId, payload) {
+    const response = await this.client.patch(
+      `/api/clients/${clientId}/contacts/by-conversation/${conversationId}`,
+      payload
+    );
+    return response.data;
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://portal.aiatende.com.br";
 var PortalClient = class {
@@ -207,6 +224,7 @@ var PortalClient = class {
   clients;
   knowledge;
   messaging;
+  contacts;
   constructor(config) {
     this.config = config;
     this.httpClient = axios.create({
@@ -233,10 +251,12 @@ var PortalClient = class {
     this.clients = new ClientsResource(this.httpClient);
     this.knowledge = new KnowledgeResource(this.httpClient);
     this.messaging = new MessagingResource(this.httpClient);
+    this.contacts = new ContactsResource(this.httpClient);
   }
 };
 export {
   ClientsResource,
+  ContactsResource,
   KnowledgeResource,
   MessagingResource,
   PortalApiError,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/base.ts","../src/errors.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/resources/messaging/index.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { MessagingResource } from './resources/messaging';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n  public messaging: MessagingResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n    this.messaging = new MessagingResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n","import { BaseResource } from '../../base';\nimport { PortalApiError } from '../../errors';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /**\n   * Busca o Client pelo seu id direto (`GET /api/clients/{id}`) — inclui `aiConfig` e\n   * `messagingConfig` (sem a API key criptografada). Usado pelo canal aiatendeWa, que resolve o\n   * tenant a partir do `clientId` já incluído no payload do relay de webhook, sem precisar de\n   * um identificador de canal indireto como Kommo subdomain ou Wazzup channelId.\n   */\n  async getById(clientId: string): Promise<Client | null> {\n    try {\n      const response = await this.client.get<Client>(`/api/clients/${clientId}`);\n      return response.data;\n    } catch (error) {\n      if (error instanceof PortalApiError && error.status === 404) return null;\n      throw error;\n    }\n  }\n}\n","import { z } from 'zod';\nimport { BaseResource } from '../../base';\nimport { PortalApiError } from '../../errors';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nconst internalContextChunkSchema = z.object({\n  chunkId: z.string().optional(),\n  content: z.string(),\n  similarity: z.number(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst internalContextResultSchema = z.array(internalContextChunkSchema);\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<unknown>('/api/knowledge/internal/context', {\n      aiConfigId: params.aiConfigId,\n      question: params.question,\n      conversationHistory: params.conversationHistory\n    });\n\n    const parsed = internalContextResultSchema.safeParse(response.data);\n    if (!parsed.success) {\n      throw new PortalApiError('Resposta inválida de /api/knowledge/internal/context', {\n        raw: parsed.error.flatten(),\n      });\n    }\n    return parsed.data;\n  }\n}\n","import { BaseResource } from '../../base';\nimport {\n  CreateToolEventPayload,\n  DownloadMediaResponse,\n  ListConversationsFilters,\n  MessagingConversation,\n  MessagingConversationsListResponse,\n  MessagingMessagesListResponse,\n  PatchConversationPayload,\n  SendMessagePayload,\n  SendMessageResponse,\n  UploadMediaPayload,\n  UploadMediaResponse,\n} from './types';\n\n/**\n * Canal WhatsApp direto (aiatendeWa) — proxy pras rotas `/api/clients/{clientId}/messaging/...`\n * do Portal, que por sua vez falam com a plataforma de mensageria própria\n * (plataforma_whatsapp_coexistence). O atende360-assistant nunca fala direto com essa\n * plataforma — sempre por aqui, autenticado via a mesma `apiKey`/APP_API_KEY já usada pro\n * resto do SDK.\n */\nexport class MessagingResource extends BaseResource {\n  async listConversations(\n    clientId: string,\n    filters?: ListConversationsFilters,\n  ): Promise<MessagingConversationsListResponse> {\n    const response = await this.client.get<MessagingConversationsListResponse>(\n      `/api/clients/${clientId}/messaging/conversations`,\n      { params: filters },\n    );\n    return response.data;\n  }\n\n  async getConversation(clientId: string, conversationId: string): Promise<MessagingConversation> {\n    const response = await this.client.get<MessagingConversation>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,\n    );\n    return response.data;\n  }\n\n  async patchConversation(\n    clientId: string,\n    conversationId: string,\n    payload: PatchConversationPayload,\n  ): Promise<MessagingConversation> {\n    const response = await this.client.patch<MessagingConversation>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,\n      payload,\n    );\n    return response.data;\n  }\n\n  async getMessages(\n    clientId: string,\n    conversationId: string,\n    params?: { page?: number; limit?: number },\n  ): Promise<MessagingMessagesListResponse> {\n    const response = await this.client.get<MessagingMessagesListResponse>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,\n      { params },\n    );\n    return response.data;\n  }\n\n  async sendMessage(\n    clientId: string,\n    conversationId: string,\n    payload: SendMessagePayload,\n  ): Promise<SendMessageResponse> {\n    const response = await this.client.post<SendMessageResponse>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,\n      payload,\n    );\n    return response.data;\n  }\n\n  /**\n   * Upload de mídia (ex.: áudio gerado por TTS) — pré-requisito pra mandar `type: 'audio'` no\n   * `sendMessage` (o `content.id` retornado aqui vira `content.id` do envio; `storagePath`\n   * precisa ser ecoado em `content._media.storagePath` no send, senão a plataforma não cria o\n   * registro de mídia local pra conexões Cloud API).\n   */\n  async uploadMedia(clientId: string, payload: UploadMediaPayload): Promise<UploadMediaResponse> {\n    const form = new FormData();\n    // Ordem importa: phoneNumberId/isVoiceNote precisam vir ANTES de file no multipart — o\n    // parser do Portal (e o da plataforma por trás dele) lê em stream.\n    form.append('phoneNumberId', payload.phoneNumberId);\n    if (payload.isVoiceNote) form.append('isVoiceNote', 'true');\n    form.append(\n      'file',\n      new Blob([new Uint8Array(payload.file)], { type: payload.mimeType }),\n      payload.filename,\n    );\n\n    const response = await this.client.post<UploadMediaResponse>(\n      `/api/clients/${clientId}/messaging/media`,\n      form,\n      // A instância do axios (client.ts) fixa Content-Type: application/json como default —\n      // sem isto, esse header explícito vence e nunca deixa o axios detectar o FormData nativo\n      // e gerar o multipart/form-data; boundary=... correto. `undefined` remove o default do\n      // merge de headers só nesta chamada, liberando a detecção automática.\n      { headers: { 'Content-Type': undefined } },\n    );\n    return response.data;\n  }\n\n  /**\n   * Registra a execução de uma tool da IA (canal aiatendeWa) como uma mensagem 'internal' na\n   * conversa — visível no Portal, nunca despachada pro WhatsApp. Idempotente por `toolCallId`\n   * (upsert do lado do Portal — retry seguro).\n   */\n  async createToolEvent(\n    clientId: string,\n    conversationId: string,\n    payload: CreateToolEventPayload,\n  ): Promise<{ id: string }> {\n    const response = await this.client.post<{ id: string }>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/tool-events`,\n      payload,\n    );\n    return response.data;\n  }\n\n  /**\n   * Resolve a conversa local (aiatendeWa) vinculada a um lead da Kommo, se existir — usado pelo\n   * KommoServices.setAiStateTag do atende360-assistant pra também atualizar\n   * Conversation.aiCareStatus no Portal quando a tag de IA de um lead muda pela Kommo/Wazzup.\n   */\n  async getConversationByKommoLead(\n    clientId: string,\n    kommoLeadId: number,\n  ): Promise<{ conversationId: string | null }> {\n    const response = await this.client.get<{ conversationId: string | null }>(\n      `/api/clients/${clientId}/messaging/conversations/by-kommo-lead`,\n      { params: { kommoLeadId } },\n    );\n    return response.data;\n  }\n\n  /**\n   * Mostra \"digitando...\" pro lead no WhatsApp (canal aiatendeWa, só Cloud API — sem\n   * equivalente no WhatsApp Lite). A Portal já implementa isso ponta a ponta (usado hoje só\n   * pelo atendente humano digitando no textarea do Portal); este método só expõe a mesma rota\n   * pro atende360-assistant poder chamar antes/durante o processamento da IA.\n   */\n  async sendTyping(\n    clientId: string,\n    conversationId: string,\n  ): Promise<{ status: string; reason?: string }> {\n    const response = await this.client.post<{ status: string; reason?: string }>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/typing`,\n    );\n    return response.data;\n  }\n\n  /**\n   * Baixa os bytes de um anexo (Message.media[].id) — usado hoje só pelo caminho de imagem do\n   * canal aiatendeWa (monta uma data URI pra mandar pro modelo de visão, já que a URL não pode\n   * ser pública). Áudio/PDF seguem passando a URL autenticada direto pros métodos de\n   * transcrição/extração do atende360-assistant, sem baixar bytes por aqui.\n   */\n  async downloadMedia(clientId: string, mediaId: string): Promise<DownloadMediaResponse> {\n    const response = await this.client.get<ArrayBuffer>(\n      `/api/clients/${clientId}/messaging/media/${mediaId}`,\n      { responseType: 'arraybuffer' },\n    );\n    return {\n      data: Buffer.from(response.data),\n      contentType: (response.headers['content-type'] as string) || 'application/octet-stream',\n    };\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/base.ts","../src/errors.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/resources/messaging/index.ts","../src/resources/contacts/index.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\nimport { MessagingResource } from './resources/messaging';\nimport { ContactsResource } from './resources/contacts';\nimport { PortalApiError } from './errors';\n\nconst DEFAULT_BASE_URL = 'https://portal.aiatende.com.br';\n\nexport class PortalClient {\n  public config: PortalClientConfig;\n  public httpClient: AxiosInstance;\n\n  public clients: ClientsResource;\n  public knowledge: KnowledgeResource;\n  public messaging: MessagingResource;\n  public contacts: ContactsResource;\n\n  constructor(config: PortalClientConfig) {\n    this.config = config;\n\n    this.httpClient = axios.create({\n      baseURL: config.baseUrl || DEFAULT_BASE_URL,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': config.apiKey,\n        'x-internal-token': config.apiKey\n      }\n    });\n\n    this.httpClient.interceptors.response.use(\n      (response) => response,\n      (error) => {\n        if (error.response) {\n          const errData = error.response.data;\n          throw new PortalApiError(errData?.error || 'Portal API Error', {\n            status: error.response.status,\n            raw: errData\n          });\n        }\n        throw error;\n      }\n    );\n\n    this.clients = new ClientsResource(this.httpClient);\n    this.knowledge = new KnowledgeResource(this.httpClient);\n    this.messaging = new MessagingResource(this.httpClient);\n    this.contacts = new ContactsResource(this.httpClient);\n  }\n}\n","import { AxiosInstance } from 'axios';\n\nexport abstract class BaseResource {\n  protected client: AxiosInstance;\n\n  constructor(client: AxiosInstance) {\n    this.client = client;\n  }\n}\n","export class PortalApiError extends Error {\n  status?: number;\n  raw?: unknown;\n\n  constructor(message: string, info?: Partial<PortalApiError>) {\n    super(message);\n    this.name = 'PortalApiError';\n\n    if (info) {\n      this.status = info.status;\n      this.raw = info.raw;\n    }\n  }\n}\n","import { BaseResource } from '../../base';\nimport { PortalApiError } from '../../errors';\nimport { Client, ClientsListResponse } from './types';\n\nexport class ClientsResource extends BaseResource {\n  /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */\n  async getByKommoSubdomain(subdomain: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { kommo_subdomain: subdomain, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */\n  async getByWazzupChannelId(channelId: string): Promise<Client | null> {\n    const response = await this.client.get<ClientsListResponse>('/api/clients', {\n      params: { channelId, includeConfigs: true }\n    });\n    return response.data.data[0] ?? null;\n  }\n\n  /**\n   * Busca o Client pelo seu id direto (`GET /api/clients/{id}`) — inclui `aiConfig` e\n   * `messagingConfig` (sem a API key criptografada). Usado pelo canal aiatendeWa, que resolve o\n   * tenant a partir do `clientId` já incluído no payload do relay de webhook, sem precisar de\n   * um identificador de canal indireto como Kommo subdomain ou Wazzup channelId.\n   */\n  async getById(clientId: string): Promise<Client | null> {\n    try {\n      const response = await this.client.get<Client>(`/api/clients/${clientId}`);\n      return response.data;\n    } catch (error) {\n      if (error instanceof PortalApiError && error.status === 404) return null;\n      throw error;\n    }\n  }\n}\n","import { z } from 'zod';\nimport { BaseResource } from '../../base';\nimport { PortalApiError } from '../../errors';\nimport { GetInternalContextParams, InternalContextResult } from './types';\n\nconst internalContextChunkSchema = z.object({\n  chunkId: z.string().optional(),\n  content: z.string(),\n  similarity: z.number(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\nconst internalContextResultSchema = z.array(internalContextChunkSchema);\n\nexport class KnowledgeResource extends BaseResource {\n  /** Recupera trechos relevantes da base RAG do cliente pra uma pergunta em texto puro (`POST /api/knowledge/internal/context`). O Portal gera o embedding internamente usando a `apiKey` do AiConfig. */\n  async getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult> {\n    const response = await this.client.post<unknown>('/api/knowledge/internal/context', {\n      aiConfigId: params.aiConfigId,\n      question: params.question,\n      conversationHistory: params.conversationHistory\n    });\n\n    const parsed = internalContextResultSchema.safeParse(response.data);\n    if (!parsed.success) {\n      throw new PortalApiError('Resposta inválida de /api/knowledge/internal/context', {\n        raw: parsed.error.flatten(),\n      });\n    }\n    return parsed.data;\n  }\n}\n","import { BaseResource } from '../../base';\nimport {\n  CreateToolEventPayload,\n  DownloadMediaResponse,\n  ListConversationsFilters,\n  MessagingConversation,\n  MessagingConversationsListResponse,\n  MessagingMessagesListResponse,\n  PatchConversationPayload,\n  SendMessagePayload,\n  SendMessageResponse,\n  UploadMediaPayload,\n  UploadMediaResponse,\n} from './types';\n\n/**\n * Canal WhatsApp direto (aiatendeWa) — proxy pras rotas `/api/clients/{clientId}/messaging/...`\n * do Portal, que por sua vez falam com a plataforma de mensageria própria\n * (plataforma_whatsapp_coexistence). O atende360-assistant nunca fala direto com essa\n * plataforma — sempre por aqui, autenticado via a mesma `apiKey`/APP_API_KEY já usada pro\n * resto do SDK.\n */\nexport class MessagingResource extends BaseResource {\n  async listConversations(\n    clientId: string,\n    filters?: ListConversationsFilters,\n  ): Promise<MessagingConversationsListResponse> {\n    const response = await this.client.get<MessagingConversationsListResponse>(\n      `/api/clients/${clientId}/messaging/conversations`,\n      { params: filters },\n    );\n    return response.data;\n  }\n\n  async getConversation(clientId: string, conversationId: string): Promise<MessagingConversation> {\n    const response = await this.client.get<MessagingConversation>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,\n    );\n    return response.data;\n  }\n\n  async patchConversation(\n    clientId: string,\n    conversationId: string,\n    payload: PatchConversationPayload,\n  ): Promise<MessagingConversation> {\n    const response = await this.client.patch<MessagingConversation>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,\n      payload,\n    );\n    return response.data;\n  }\n\n  async getMessages(\n    clientId: string,\n    conversationId: string,\n    params?: { page?: number; limit?: number },\n  ): Promise<MessagingMessagesListResponse> {\n    const response = await this.client.get<MessagingMessagesListResponse>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,\n      { params },\n    );\n    return response.data;\n  }\n\n  async sendMessage(\n    clientId: string,\n    conversationId: string,\n    payload: SendMessagePayload,\n  ): Promise<SendMessageResponse> {\n    const response = await this.client.post<SendMessageResponse>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,\n      payload,\n    );\n    return response.data;\n  }\n\n  /**\n   * Upload de mídia (ex.: áudio gerado por TTS) — pré-requisito pra mandar `type: 'audio'` no\n   * `sendMessage` (o `content.id` retornado aqui vira `content.id` do envio; `storagePath`\n   * precisa ser ecoado em `content._media.storagePath` no send, senão a plataforma não cria o\n   * registro de mídia local pra conexões Cloud API).\n   */\n  async uploadMedia(clientId: string, payload: UploadMediaPayload): Promise<UploadMediaResponse> {\n    const form = new FormData();\n    // Ordem importa: phoneNumberId/isVoiceNote precisam vir ANTES de file no multipart — o\n    // parser do Portal (e o da plataforma por trás dele) lê em stream.\n    form.append('phoneNumberId', payload.phoneNumberId);\n    if (payload.isVoiceNote) form.append('isVoiceNote', 'true');\n    form.append(\n      'file',\n      new Blob([new Uint8Array(payload.file)], { type: payload.mimeType }),\n      payload.filename,\n    );\n\n    const response = await this.client.post<UploadMediaResponse>(\n      `/api/clients/${clientId}/messaging/media`,\n      form,\n      // A instância do axios (client.ts) fixa Content-Type: application/json como default —\n      // sem isto, esse header explícito vence e nunca deixa o axios detectar o FormData nativo\n      // e gerar o multipart/form-data; boundary=... correto. `undefined` remove o default do\n      // merge de headers só nesta chamada, liberando a detecção automática.\n      { headers: { 'Content-Type': undefined } },\n    );\n    return response.data;\n  }\n\n  /**\n   * Registra a execução de uma tool da IA (canal aiatendeWa) como uma mensagem 'internal' na\n   * conversa — visível no Portal, nunca despachada pro WhatsApp. Idempotente por `toolCallId`\n   * (upsert do lado do Portal — retry seguro).\n   */\n  async createToolEvent(\n    clientId: string,\n    conversationId: string,\n    payload: CreateToolEventPayload,\n  ): Promise<{ id: string }> {\n    const response = await this.client.post<{ id: string }>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/tool-events`,\n      payload,\n    );\n    return response.data;\n  }\n\n  /**\n   * Resolve a conversa local (aiatendeWa) vinculada a um lead da Kommo, se existir — usado pelo\n   * KommoServices.setAiStateTag do atende360-assistant pra também atualizar\n   * Conversation.aiCareStatus no Portal quando a tag de IA de um lead muda pela Kommo/Wazzup.\n   */\n  async getConversationByKommoLead(\n    clientId: string,\n    kommoLeadId: number,\n  ): Promise<{ conversationId: string | null }> {\n    const response = await this.client.get<{ conversationId: string | null }>(\n      `/api/clients/${clientId}/messaging/conversations/by-kommo-lead`,\n      { params: { kommoLeadId } },\n    );\n    return response.data;\n  }\n\n  /**\n   * Mostra \"digitando...\" pro lead no WhatsApp (canal aiatendeWa, só Cloud API — sem\n   * equivalente no WhatsApp Lite). A Portal já implementa isso ponta a ponta (usado hoje só\n   * pelo atendente humano digitando no textarea do Portal); este método só expõe a mesma rota\n   * pro atende360-assistant poder chamar antes/durante o processamento da IA.\n   */\n  async sendTyping(\n    clientId: string,\n    conversationId: string,\n  ): Promise<{ status: string; reason?: string }> {\n    const response = await this.client.post<{ status: string; reason?: string }>(\n      `/api/clients/${clientId}/messaging/conversations/${conversationId}/typing`,\n    );\n    return response.data;\n  }\n\n  /**\n   * Baixa os bytes de um anexo (Message.media[].id) — usado hoje só pelo caminho de imagem do\n   * canal aiatendeWa (monta uma data URI pra mandar pro modelo de visão, já que a URL não pode\n   * ser pública). Áudio/PDF seguem passando a URL autenticada direto pros métodos de\n   * transcrição/extração do atende360-assistant, sem baixar bytes por aqui.\n   */\n  async downloadMedia(clientId: string, mediaId: string): Promise<DownloadMediaResponse> {\n    const response = await this.client.get<ArrayBuffer>(\n      `/api/clients/${clientId}/messaging/media/${mediaId}`,\n      { responseType: 'arraybuffer' },\n    );\n    return {\n      data: Buffer.from(response.data),\n      contentType: (response.headers['content-type'] as string) || 'application/octet-stream',\n    };\n  }\n}\n","import { BaseResource } from '../../base';\nimport { ContactByConversationResponse, Contact, UpdateContactPayload } from './types';\n\n/**\n * Entidade Contact do Portal (dados padrão + customFields dinâmico por cliente) — proxy pras\n * rotas `/api/clients/{clientId}/contacts/...`. Deliberadamente restrito a `by-conversation`\n * (sem list/getById): o atende360-assistant sempre opera dentro de uma conversa\n * (`portalConversationRef.conversationId`), nunca já tem um `contactId` em mãos.\n */\nexport class ContactsResource extends BaseResource {\n  async getByConversation(\n    clientId: string,\n    conversationId: string,\n  ): Promise<ContactByConversationResponse> {\n    const response = await this.client.get<ContactByConversationResponse>(\n      `/api/clients/${clientId}/contacts/by-conversation/${conversationId}`,\n    );\n    return response.data;\n  }\n\n  async updateByConversation(\n    clientId: string,\n    conversationId: string,\n    payload: UpdateContactPayload,\n  ): Promise<{ contact: Contact }> {\n    const response = await this.client.patch<{ contact: Contact }>(\n      `/api/clients/${clientId}/contacts/by-conversation/${conversationId}`,\n      payload,\n    );\n    return response.data;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portal-aiatende-api",
-  "version": "0.5.6",
+  "version": "0.7.0",
   "description": "Cliente TypeScript tipado para a API interna do Portal AI Atende.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",