portal-aiatende-api 0.2.0 → 0.4.0

package/dist/index.d.mts

@@ -94,6 +94,14 @@ interface AiConfig {
     untaggedLeadAiState?: 'inactive' | 'active' | 'active_for_new_leads';
     /** Estado da IA após handoff. 'inactive' = trava permanente e global (nunca reativa sozinha). 'untag' = remove a tag, elegível pro bootstrap na próxima mensagem. */
     handoffAiState?: 'inactive' | 'untag';
+    /** Canal WhatsApp direto (aiatendeWa) — domínio separado das tags Kommo acima, usa Conversation.aiCareStatus/aiResumeMode. Se true (default), conversas novas nesse canal já nascem com aiCareStatus ACTIVE; se false, nascem INACTIVE e exigem ativação manual pelo Portal. */
+    aiatendeWaDefaultActive?: boolean;
+    /** Canal aiatendeWa: responder em áudio (TTS) quando o lead mandar uma mensagem de áudio. Default true. */
+    audioReplyOnInboundAudio?: boolean;
+    /** Canal aiatendeWa: responder em áudio em vez de texto quando a resposta gerada passar desse tamanho (caracteres). `undefined`/`null`/`0` desliga esse gatilho específico. Default 300. */
+    audioReplyCharThreshold?: number | null;
+    /** Canal aiatendeWa: id bruto da voz de TTS escolhida — seu significado depende de qual provider `model` indica no momento do envio (OpenAI e Gemini têm listas de vozes totalmente diferentes). */
+    ttsVoice?: string | null;
     /** Ativa a Reflection Agent (segunda passada de revisão/auditoria da resposta) pra este cliente. Ausente/undefined = usa o fallback global (env USE_REFLECTION_AGENT) no atende360-assistant — ver Orchestrator.ts. */
     reflectionAgentEnabled?: boolean;
     /** Limiar mínimo de similaridade (cosine, 0-1) pra um trecho da base de conhecimento entrar no contexto do RAG. `undefined`/`null` = o Portal usa o fallback global 0.5 até o admin calibrar via RAG eval. Aplicado internamente pelo Portal em `POST /api/knowledge/internal/context` — não precisa ser enviado pelo assistant-api. */
@@ -286,14 +294,32 @@ declare class ClientsResource extends BaseResource {
     getByKommoSubdomain(subdomain: string): Promise<Client | null>;
     /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */
     getByWazzupChannelId(channelId: string): Promise<Client | null>;
+    /**
+     * Busca o Client pelo seu id direto (`GET /api/clients/{id}`) — inclui `aiConfig` e
+     * `messagingConfig` (sem a API key criptografada). Usado pelo canal aiatendeWa, que resolve o
+     * tenant a partir do `clientId` já incluído no payload do relay de webhook, sem precisar de
+     * um identificador de canal indireto como Kommo subdomain ou Wazzup channelId.
+     */
+    getById(clientId: string): Promise<Client | null>;
 }
 
+/** Uma mensagem simplificada do histórico da conversa, enviada pro Portal reescrever a
+ * pergunta de acompanhamento como consulta autônoma antes de gerar o embedding. */
+interface ConversationHistoryMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+}
 interface GetInternalContextParams {
     /** Id do AiConfig do cliente — o Portal usa a `apiKey` configurada nele pra gerar o embedding da pergunta. */
     aiConfigId: string;
     /** Pergunta em texto puro do usuário. O embedding é gerado internamente pelo Portal (RagService.getEmbedding), não pelo chamador. */
     question: string;
-    conversationHistory?: unknown;
+    /** Últimas mensagens da conversa (mais antiga → mais recente), sem incluir `question`. Quando
+     * presente e não vazio, o Portal reescreve `question` como uma consulta autônoma (LLM rewrite)
+     * antes de buscar na base de conhecimento — melhora o recall em perguntas de acompanhamento
+     * (ex.: "e o azul?"). Omitir ou passar array vazio preserva o comportamento anterior (busca
+     * direto pela `question`, sem custo extra). */
+    conversationHistory?: ConversationHistoryMessage[];
 }
 interface InternalContextChunk {
     chunkId?: string;
@@ -310,11 +336,191 @@ declare class KnowledgeResource extends BaseResource {
     getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult>;
 }
 
+type AiCareStatus = 'ACTIVE' | 'INACTIVE' | 'PAUSED';
+type AiResumeMode = 'immediate' | 'next_message';
+interface MessagingContact {
+    id: string;
+    waId: string;
+    profileName: string | null;
+    displayName: string | null;
+    displayNameSetByName: string | null;
+    displayNameSetAt: Date | string | null;
+}
+interface MessagingPhoneNumber {
+    id: string;
+    phoneNumberId: string;
+    displayNumber: string;
+    metaConnection: {
+        channel: string;
+    };
+}
+interface MessagingConversation {
+    id: string;
+    contactId: string;
+    phoneNumberId: string;
+    lastMessageAt: Date | string | null;
+    contact: MessagingContact;
+    phoneNumber: MessagingPhoneNumber;
+    _count: {
+        messages: number;
+    };
+    assignedToId: string | null;
+    assignedTo: {
+        id: string;
+        name: string;
+        email: string;
+    } | null;
+    lastMessage: Record<string, unknown> | null;
+    lastInboundAt: Date | string | null;
+    lastOutboundAt: Date | string | null;
+    temperature: 'HOT' | 'WARM' | 'COLD' | null;
+    aiCareStatus: AiCareStatus;
+    aiCareStatusSetAt: Date | string | null;
+    aiCareStatusSetByName: string | null;
+    /** Só presente na resposta do GET de detalhe (não na listagem). */
+    aiResumeMode?: AiResumeMode | null;
+    [key: string]: unknown;
+}
+interface MessagingConversationsListResponse {
+    data: MessagingConversation[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+interface MessagingMessage {
+    id: string;
+    externalId: string;
+    conversationId: string;
+    direction: 'inbound' | 'outbound';
+    type: string;
+    status: string;
+    content: Record<string, unknown>;
+    waMessageId: string | null;
+    media: unknown[];
+    sentByType: 'platform_user' | 'api_key' | 'external_agent' | 'whatsapp_app' | null;
+    sentById: string | null;
+    sentByName: string | null;
+    error: string | null;
+    errorCode: string | null;
+    errorDetails: unknown;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+}
+interface MessagingMessagesListResponse {
+    data: MessagingMessage[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+interface ListConversationsFilters {
+    page?: number;
+    limit?: number;
+    assignedToId?: string | 'unassigned';
+    phoneNumberId?: string;
+    contactWaId?: string;
+    contactName?: string;
+    createdFrom?: string;
+    createdTo?: string;
+    lastMessageFrom?: string;
+    lastMessageTo?: string;
+    sortBy?: 'default' | 'createdAt' | 'lastMessageAt' | 'contactName';
+    sortDirection?: 'asc' | 'desc';
+}
+interface PatchConversationPayload {
+    assignedToId?: string | null;
+    contactDisplayName?: string | null;
+    aiCareStatus?: AiCareStatus;
+    /** Só tem efeito quando `aiCareStatus` é 'ACTIVE' — em qualquer outro status o Portal força `null`. */
+    aiResumeMode?: AiResumeMode | null;
+}
+/**
+ * `actor` só é respeitado pelo Portal quando o chamador é um papel de sistema/staff (ex.: o
+ * atende360-assistant autenticado via APP_API_KEY) — um usuário comum (OWNER/MEMBER) sempre
+ * manda como si mesmo, a API ignora um `actor` customizado nesse caso.
+ */
+interface SendMessagePayload {
+    phoneNumberId: string;
+    to: string;
+    type: string;
+    content: Record<string, unknown> & {
+        id?: string;
+        link?: string;
+        _media?: {
+            storagePath?: string | null;
+            mimeType?: string;
+            fileSize?: number;
+        };
+    };
+    replyToWaMessageId?: string;
+    actor?: {
+        externalUserId: string;
+        externalUserName?: string;
+    };
+}
+interface SendMessageResponse {
+    messageId: string;
+    conversationId: string;
+    status: string;
+    correlationId: string;
+}
+interface UploadMediaPayload {
+    /** Bytes do arquivo (buffer do áudio/imagem/etc. gerado ou recebido). */
+    file: Buffer;
+    filename: string;
+    mimeType: string;
+    phoneNumberId: string;
+    /**
+     * true faz a plataforma transcodificar pra OGG/Opus mono e renderizar como balão de
+     * mensagem de voz no WhatsApp (em vez de anexo de áudio genérico) — usar sempre que for
+     * uma resposta de TTS da IA.
+     */
+    isVoiceNote?: boolean;
+}
+interface UploadMediaResponse {
+    id: string | null;
+    storagePath: string | null;
+    filename: string;
+    mimeType: string;
+    fileSize: number;
+}
+
+/**
+ * Canal WhatsApp direto (aiatendeWa) — proxy pras rotas `/api/clients/{clientId}/messaging/...`
+ * do Portal, que por sua vez falam com a plataforma de mensageria própria
+ * (plataforma_whatsapp_coexistence). O atende360-assistant nunca fala direto com essa
+ * plataforma — sempre por aqui, autenticado via a mesma `apiKey`/APP_API_KEY já usada pro
+ * resto do SDK.
+ */
+declare class MessagingResource extends BaseResource {
+    listConversations(clientId: string, filters?: ListConversationsFilters): Promise<MessagingConversationsListResponse>;
+    getConversation(clientId: string, conversationId: string): Promise<MessagingConversation>;
+    patchConversation(clientId: string, conversationId: string, payload: PatchConversationPayload): Promise<MessagingConversation>;
+    getMessages(clientId: string, conversationId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<MessagingMessagesListResponse>;
+    sendMessage(clientId: string, conversationId: string, payload: SendMessagePayload): Promise<SendMessageResponse>;
+    /**
+     * Upload de mídia (ex.: áudio gerado por TTS) — pré-requisito pra mandar `type: 'audio'` no
+     * `sendMessage` (o `content.id` retornado aqui vira `content.id` do envio; `storagePath`
+     * precisa ser ecoado em `content._media.storagePath` no send, senão a plataforma não cria o
+     * registro de mídia local pra conexões Cloud API).
+     */
+    uploadMedia(clientId: string, payload: UploadMediaPayload): Promise<UploadMediaResponse>;
+}
+
 declare class PortalClient {
     config: PortalClientConfig;
     httpClient: AxiosInstance;
     clients: ClientsResource;
     knowledge: KnowledgeResource;
+    messaging: MessagingResource;
     constructor(config: PortalClientConfig);
 }
 
@@ -324,4 +530,4 @@ declare class PortalApiError extends Error {
     constructor(message: string, info?: Partial<PortalApiError>);
 }
 
-export { type AiActivationSchedule, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type DateException, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type LossReasonMapping, type NudgeSettings, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type StageMapping, type TimeRange, 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 ConversationHistoryMessage, type DateException, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type ListConversationsFilters, type LossReasonMapping, type MessagingContact, type MessagingConversation, type MessagingConversationsListResponse, 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 };

package/dist/index.d.ts

@@ -94,6 +94,14 @@ interface AiConfig {
     untaggedLeadAiState?: 'inactive' | 'active' | 'active_for_new_leads';
     /** Estado da IA após handoff. 'inactive' = trava permanente e global (nunca reativa sozinha). 'untag' = remove a tag, elegível pro bootstrap na próxima mensagem. */
     handoffAiState?: 'inactive' | 'untag';
+    /** Canal WhatsApp direto (aiatendeWa) — domínio separado das tags Kommo acima, usa Conversation.aiCareStatus/aiResumeMode. Se true (default), conversas novas nesse canal já nascem com aiCareStatus ACTIVE; se false, nascem INACTIVE e exigem ativação manual pelo Portal. */
+    aiatendeWaDefaultActive?: boolean;
+    /** Canal aiatendeWa: responder em áudio (TTS) quando o lead mandar uma mensagem de áudio. Default true. */
+    audioReplyOnInboundAudio?: boolean;
+    /** Canal aiatendeWa: responder em áudio em vez de texto quando a resposta gerada passar desse tamanho (caracteres). `undefined`/`null`/`0` desliga esse gatilho específico. Default 300. */
+    audioReplyCharThreshold?: number | null;
+    /** Canal aiatendeWa: id bruto da voz de TTS escolhida — seu significado depende de qual provider `model` indica no momento do envio (OpenAI e Gemini têm listas de vozes totalmente diferentes). */
+    ttsVoice?: string | null;
     /** Ativa a Reflection Agent (segunda passada de revisão/auditoria da resposta) pra este cliente. Ausente/undefined = usa o fallback global (env USE_REFLECTION_AGENT) no atende360-assistant — ver Orchestrator.ts. */
     reflectionAgentEnabled?: boolean;
     /** Limiar mínimo de similaridade (cosine, 0-1) pra um trecho da base de conhecimento entrar no contexto do RAG. `undefined`/`null` = o Portal usa o fallback global 0.5 até o admin calibrar via RAG eval. Aplicado internamente pelo Portal em `POST /api/knowledge/internal/context` — não precisa ser enviado pelo assistant-api. */
@@ -286,14 +294,32 @@ declare class ClientsResource extends BaseResource {
     getByKommoSubdomain(subdomain: string): Promise<Client | null>;
     /** Busca o Client dono de um canal Wazzup (`GET /api/clients?channelId=...`). */
     getByWazzupChannelId(channelId: string): Promise<Client | null>;
+    /**
+     * Busca o Client pelo seu id direto (`GET /api/clients/{id}`) — inclui `aiConfig` e
+     * `messagingConfig` (sem a API key criptografada). Usado pelo canal aiatendeWa, que resolve o
+     * tenant a partir do `clientId` já incluído no payload do relay de webhook, sem precisar de
+     * um identificador de canal indireto como Kommo subdomain ou Wazzup channelId.
+     */
+    getById(clientId: string): Promise<Client | null>;
 }
 
+/** Uma mensagem simplificada do histórico da conversa, enviada pro Portal reescrever a
+ * pergunta de acompanhamento como consulta autônoma antes de gerar o embedding. */
+interface ConversationHistoryMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+}
 interface GetInternalContextParams {
     /** Id do AiConfig do cliente — o Portal usa a `apiKey` configurada nele pra gerar o embedding da pergunta. */
     aiConfigId: string;
     /** Pergunta em texto puro do usuário. O embedding é gerado internamente pelo Portal (RagService.getEmbedding), não pelo chamador. */
     question: string;
-    conversationHistory?: unknown;
+    /** Últimas mensagens da conversa (mais antiga → mais recente), sem incluir `question`. Quando
+     * presente e não vazio, o Portal reescreve `question` como uma consulta autônoma (LLM rewrite)
+     * antes de buscar na base de conhecimento — melhora o recall em perguntas de acompanhamento
+     * (ex.: "e o azul?"). Omitir ou passar array vazio preserva o comportamento anterior (busca
+     * direto pela `question`, sem custo extra). */
+    conversationHistory?: ConversationHistoryMessage[];
 }
 interface InternalContextChunk {
     chunkId?: string;
@@ -310,11 +336,191 @@ declare class KnowledgeResource extends BaseResource {
     getInternalContext(params: GetInternalContextParams): Promise<InternalContextResult>;
 }
 
+type AiCareStatus = 'ACTIVE' | 'INACTIVE' | 'PAUSED';
+type AiResumeMode = 'immediate' | 'next_message';
+interface MessagingContact {
+    id: string;
+    waId: string;
+    profileName: string | null;
+    displayName: string | null;
+    displayNameSetByName: string | null;
+    displayNameSetAt: Date | string | null;
+}
+interface MessagingPhoneNumber {
+    id: string;
+    phoneNumberId: string;
+    displayNumber: string;
+    metaConnection: {
+        channel: string;
+    };
+}
+interface MessagingConversation {
+    id: string;
+    contactId: string;
+    phoneNumberId: string;
+    lastMessageAt: Date | string | null;
+    contact: MessagingContact;
+    phoneNumber: MessagingPhoneNumber;
+    _count: {
+        messages: number;
+    };
+    assignedToId: string | null;
+    assignedTo: {
+        id: string;
+        name: string;
+        email: string;
+    } | null;
+    lastMessage: Record<string, unknown> | null;
+    lastInboundAt: Date | string | null;
+    lastOutboundAt: Date | string | null;
+    temperature: 'HOT' | 'WARM' | 'COLD' | null;
+    aiCareStatus: AiCareStatus;
+    aiCareStatusSetAt: Date | string | null;
+    aiCareStatusSetByName: string | null;
+    /** Só presente na resposta do GET de detalhe (não na listagem). */
+    aiResumeMode?: AiResumeMode | null;
+    [key: string]: unknown;
+}
+interface MessagingConversationsListResponse {
+    data: MessagingConversation[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+interface MessagingMessage {
+    id: string;
+    externalId: string;
+    conversationId: string;
+    direction: 'inbound' | 'outbound';
+    type: string;
+    status: string;
+    content: Record<string, unknown>;
+    waMessageId: string | null;
+    media: unknown[];
+    sentByType: 'platform_user' | 'api_key' | 'external_agent' | 'whatsapp_app' | null;
+    sentById: string | null;
+    sentByName: string | null;
+    error: string | null;
+    errorCode: string | null;
+    errorDetails: unknown;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+}
+interface MessagingMessagesListResponse {
+    data: MessagingMessage[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+interface ListConversationsFilters {
+    page?: number;
+    limit?: number;
+    assignedToId?: string | 'unassigned';
+    phoneNumberId?: string;
+    contactWaId?: string;
+    contactName?: string;
+    createdFrom?: string;
+    createdTo?: string;
+    lastMessageFrom?: string;
+    lastMessageTo?: string;
+    sortBy?: 'default' | 'createdAt' | 'lastMessageAt' | 'contactName';
+    sortDirection?: 'asc' | 'desc';
+}
+interface PatchConversationPayload {
+    assignedToId?: string | null;
+    contactDisplayName?: string | null;
+    aiCareStatus?: AiCareStatus;
+    /** Só tem efeito quando `aiCareStatus` é 'ACTIVE' — em qualquer outro status o Portal força `null`. */
+    aiResumeMode?: AiResumeMode | null;
+}
+/**
+ * `actor` só é respeitado pelo Portal quando o chamador é um papel de sistema/staff (ex.: o
+ * atende360-assistant autenticado via APP_API_KEY) — um usuário comum (OWNER/MEMBER) sempre
+ * manda como si mesmo, a API ignora um `actor` customizado nesse caso.
+ */
+interface SendMessagePayload {
+    phoneNumberId: string;
+    to: string;
+    type: string;
+    content: Record<string, unknown> & {
+        id?: string;
+        link?: string;
+        _media?: {
+            storagePath?: string | null;
+            mimeType?: string;
+            fileSize?: number;
+        };
+    };
+    replyToWaMessageId?: string;
+    actor?: {
+        externalUserId: string;
+        externalUserName?: string;
+    };
+}
+interface SendMessageResponse {
+    messageId: string;
+    conversationId: string;
+    status: string;
+    correlationId: string;
+}
+interface UploadMediaPayload {
+    /** Bytes do arquivo (buffer do áudio/imagem/etc. gerado ou recebido). */
+    file: Buffer;
+    filename: string;
+    mimeType: string;
+    phoneNumberId: string;
+    /**
+     * true faz a plataforma transcodificar pra OGG/Opus mono e renderizar como balão de
+     * mensagem de voz no WhatsApp (em vez de anexo de áudio genérico) — usar sempre que for
+     * uma resposta de TTS da IA.
+     */
+    isVoiceNote?: boolean;
+}
+interface UploadMediaResponse {
+    id: string | null;
+    storagePath: string | null;
+    filename: string;
+    mimeType: string;
+    fileSize: number;
+}
+
+/**
+ * Canal WhatsApp direto (aiatendeWa) — proxy pras rotas `/api/clients/{clientId}/messaging/...`
+ * do Portal, que por sua vez falam com a plataforma de mensageria própria
+ * (plataforma_whatsapp_coexistence). O atende360-assistant nunca fala direto com essa
+ * plataforma — sempre por aqui, autenticado via a mesma `apiKey`/APP_API_KEY já usada pro
+ * resto do SDK.
+ */
+declare class MessagingResource extends BaseResource {
+    listConversations(clientId: string, filters?: ListConversationsFilters): Promise<MessagingConversationsListResponse>;
+    getConversation(clientId: string, conversationId: string): Promise<MessagingConversation>;
+    patchConversation(clientId: string, conversationId: string, payload: PatchConversationPayload): Promise<MessagingConversation>;
+    getMessages(clientId: string, conversationId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<MessagingMessagesListResponse>;
+    sendMessage(clientId: string, conversationId: string, payload: SendMessagePayload): Promise<SendMessageResponse>;
+    /**
+     * Upload de mídia (ex.: áudio gerado por TTS) — pré-requisito pra mandar `type: 'audio'` no
+     * `sendMessage` (o `content.id` retornado aqui vira `content.id` do envio; `storagePath`
+     * precisa ser ecoado em `content._media.storagePath` no send, senão a plataforma não cria o
+     * registro de mídia local pra conexões Cloud API).
+     */
+    uploadMedia(clientId: string, payload: UploadMediaPayload): Promise<UploadMediaResponse>;
+}
+
 declare class PortalClient {
     config: PortalClientConfig;
     httpClient: AxiosInstance;
     clients: ClientsResource;
     knowledge: KnowledgeResource;
+    messaging: MessagingResource;
     constructor(config: PortalClientConfig);
 }
 
@@ -324,4 +530,4 @@ declare class PortalApiError extends Error {
     constructor(message: string, info?: Partial<PortalApiError>);
 }
 
-export { type AiActivationSchedule, type AiConfig, type AiExperiment, type AiExperimentConfig, type AiExperimentCriteria, type AiExperimentVariant, type AiPrompt, type BusinessHours, type CalendarConfig, type Client, type ClientsListResponse, ClientsResource, type DateException, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type LossReasonMapping, type NudgeSettings, type PipelineMapping, PortalApiError, PortalClient, type PortalClientConfig, type StageMapping, type TimeRange, 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 ConversationHistoryMessage, type DateException, type GetInternalContextParams, type InternalContextChunk, type InternalContextResult, KnowledgeResource, type KommoAccount, type KommoConfig, type ListConversationsFilters, type LossReasonMapping, type MessagingContact, type MessagingConversation, type MessagingConversationsListResponse, 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 };

package/dist/index.js

@@ -32,6 +32,7 @@ var index_exports = {};
 __export(index_exports, {
   ClientsResource: () => ClientsResource,
   KnowledgeResource: () => KnowledgeResource,
+  MessagingResource: () => MessagingResource,
   PortalApiError: () => PortalApiError,
   PortalClient: () => PortalClient
 });
@@ -48,6 +49,20 @@ var BaseResource = class {
   }
 };
 
+// src/errors.ts
+var PortalApiError = class extends Error {
+  status;
+  raw;
+  constructor(message, info) {
+    super(message);
+    this.name = "PortalApiError";
+    if (info) {
+      this.status = info.status;
+      this.raw = info.raw;
+    }
+  }
+};
+
 // src/resources/clients/index.ts
 var ClientsResource = class extends BaseResource {
   /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */
@@ -64,9 +79,32 @@ var ClientsResource = class extends BaseResource {
     });
     return response.data.data[0] ?? null;
   }
+  /**
+   * Busca o Client pelo seu id direto (`GET /api/clients/{id}`) — inclui `aiConfig` e
+   * `messagingConfig` (sem a API key criptografada). Usado pelo canal aiatendeWa, que resolve o
+   * tenant a partir do `clientId` já incluído no payload do relay de webhook, sem precisar de
+   * um identificador de canal indireto como Kommo subdomain ou Wazzup channelId.
+   */
+  async getById(clientId) {
+    try {
+      const response = await this.client.get(`/api/clients/${clientId}`);
+      return response.data;
+    } catch (error) {
+      if (error instanceof PortalApiError && error.status === 404) return null;
+      throw error;
+    }
+  }
 };
 
 // src/resources/knowledge/index.ts
+var import_zod = require("zod");
+var internalContextChunkSchema = import_zod.z.object({
+  chunkId: import_zod.z.string().optional(),
+  content: import_zod.z.string(),
+  similarity: import_zod.z.number(),
+  metadata: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
+});
+var internalContextResultSchema = import_zod.z.array(internalContextChunkSchema);
 var KnowledgeResource = class extends BaseResource {
   /** 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. */
   async getInternalContext(params) {
@@ -75,21 +113,72 @@ var KnowledgeResource = class extends BaseResource {
       question: params.question,
       conversationHistory: params.conversationHistory
     });
-    return response.data;
+    const parsed = internalContextResultSchema.safeParse(response.data);
+    if (!parsed.success) {
+      throw new PortalApiError("Resposta inv\xE1lida de /api/knowledge/internal/context", {
+        raw: parsed.error.flatten()
+      });
+    }
+    return parsed.data;
   }
 };
 
-// src/errors.ts
-var PortalApiError = class extends Error {
-  status;
-  raw;
-  constructor(message, info) {
-    super(message);
-    this.name = "PortalApiError";
-    if (info) {
-      this.status = info.status;
-      this.raw = info.raw;
-    }
+// src/resources/messaging/index.ts
+var MessagingResource = class extends BaseResource {
+  async listConversations(clientId, filters) {
+    const response = await this.client.get(
+      `/api/clients/${clientId}/messaging/conversations`,
+      { params: filters }
+    );
+    return response.data;
+  }
+  async getConversation(clientId, conversationId) {
+    const response = await this.client.get(
+      `/api/clients/${clientId}/messaging/conversations/${conversationId}`
+    );
+    return response.data;
+  }
+  async patchConversation(clientId, conversationId, payload) {
+    const response = await this.client.patch(
+      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,
+      payload
+    );
+    return response.data;
+  }
+  async getMessages(clientId, conversationId, params) {
+    const response = await this.client.get(
+      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,
+      { params }
+    );
+    return response.data;
+  }
+  async sendMessage(clientId, conversationId, payload) {
+    const response = await this.client.post(
+      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,
+      payload
+    );
+    return response.data;
+  }
+  /**
+   * Upload de mídia (ex.: áudio gerado por TTS) — pré-requisito pra mandar `type: 'audio'` no
+   * `sendMessage` (o `content.id` retornado aqui vira `content.id` do envio; `storagePath`
+   * precisa ser ecoado em `content._media.storagePath` no send, senão a plataforma não cria o
+   * registro de mídia local pra conexões Cloud API).
+   */
+  async uploadMedia(clientId, payload) {
+    const form = new FormData();
+    form.append("phoneNumberId", payload.phoneNumberId);
+    if (payload.isVoiceNote) form.append("isVoiceNote", "true");
+    form.append(
+      "file",
+      new Blob([new Uint8Array(payload.file)], { type: payload.mimeType }),
+      payload.filename
+    );
+    const response = await this.client.post(
+      `/api/clients/${clientId}/messaging/media`,
+      form
+    );
+    return response.data;
   }
 };
 
@@ -100,6 +189,7 @@ var PortalClient = class {
   httpClient;
   clients;
   knowledge;
+  messaging;
   constructor(config) {
     this.config = config;
     this.httpClient = import_axios.default.create({
@@ -125,12 +215,14 @@ var PortalClient = class {
     );
     this.clients = new ClientsResource(this.httpClient);
     this.knowledge = new KnowledgeResource(this.httpClient);
+    this.messaging = new MessagingResource(this.httpClient);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ClientsResource,
   KnowledgeResource,
+  MessagingResource,
   PortalApiError,
   PortalClient
 });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/base.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/errors.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';\n","import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\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\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  }\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","import { BaseResource } from '../../base';\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","import { BaseResource } from '../../base';\nimport { GetInternalContextParams, InternalContextResult } from './types';\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<InternalContextResult>('/api/knowledge/internal/context', {\n      aiConfigId: params.aiConfigId,\n      question: params.question,\n      conversationHistory: params.conversationHistory\n    });\n    return response.data;\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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAqC;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACLO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AACF;;;AChBO,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAA4B,mCAAmC;AAAA,MAChG,YAAY,OAAO;AAAA,MACnB,UAAU,OAAO;AAAA,MACjB,qBAAqB,OAAO;AAAA,IAC9B,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AACF;;;ACbO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;AJPA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,aAAAA,QAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","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"],"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  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    );\n    return response.data;\n  }\n}\n"],"mappings":"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","names":["axios"]}

package/dist/index.mjs

@@ -9,6 +9,20 @@ var BaseResource = class {
   }
 };
 
+// src/errors.ts
+var PortalApiError = class extends Error {
+  status;
+  raw;
+  constructor(message, info) {
+    super(message);
+    this.name = "PortalApiError";
+    if (info) {
+      this.status = info.status;
+      this.raw = info.raw;
+    }
+  }
+};
+
 // src/resources/clients/index.ts
 var ClientsResource = class extends BaseResource {
   /** Busca o Client dono de um subdomínio Kommo (`GET /api/clients?kommo_subdomain=...`). */
@@ -25,9 +39,32 @@ var ClientsResource = class extends BaseResource {
     });
     return response.data.data[0] ?? null;
   }
+  /**
+   * Busca o Client pelo seu id direto (`GET /api/clients/{id}`) — inclui `aiConfig` e
+   * `messagingConfig` (sem a API key criptografada). Usado pelo canal aiatendeWa, que resolve o
+   * tenant a partir do `clientId` já incluído no payload do relay de webhook, sem precisar de
+   * um identificador de canal indireto como Kommo subdomain ou Wazzup channelId.
+   */
+  async getById(clientId) {
+    try {
+      const response = await this.client.get(`/api/clients/${clientId}`);
+      return response.data;
+    } catch (error) {
+      if (error instanceof PortalApiError && error.status === 404) return null;
+      throw error;
+    }
+  }
 };
 
 // src/resources/knowledge/index.ts
+import { z } from "zod";
+var internalContextChunkSchema = z.object({
+  chunkId: z.string().optional(),
+  content: z.string(),
+  similarity: z.number(),
+  metadata: z.record(z.string(), z.unknown()).optional()
+});
+var internalContextResultSchema = z.array(internalContextChunkSchema);
 var KnowledgeResource = class extends BaseResource {
   /** 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. */
   async getInternalContext(params) {
@@ -36,21 +73,72 @@ var KnowledgeResource = class extends BaseResource {
       question: params.question,
       conversationHistory: params.conversationHistory
     });
-    return response.data;
+    const parsed = internalContextResultSchema.safeParse(response.data);
+    if (!parsed.success) {
+      throw new PortalApiError("Resposta inv\xE1lida de /api/knowledge/internal/context", {
+        raw: parsed.error.flatten()
+      });
+    }
+    return parsed.data;
   }
 };
 
-// src/errors.ts
-var PortalApiError = class extends Error {
-  status;
-  raw;
-  constructor(message, info) {
-    super(message);
-    this.name = "PortalApiError";
-    if (info) {
-      this.status = info.status;
-      this.raw = info.raw;
-    }
+// src/resources/messaging/index.ts
+var MessagingResource = class extends BaseResource {
+  async listConversations(clientId, filters) {
+    const response = await this.client.get(
+      `/api/clients/${clientId}/messaging/conversations`,
+      { params: filters }
+    );
+    return response.data;
+  }
+  async getConversation(clientId, conversationId) {
+    const response = await this.client.get(
+      `/api/clients/${clientId}/messaging/conversations/${conversationId}`
+    );
+    return response.data;
+  }
+  async patchConversation(clientId, conversationId, payload) {
+    const response = await this.client.patch(
+      `/api/clients/${clientId}/messaging/conversations/${conversationId}`,
+      payload
+    );
+    return response.data;
+  }
+  async getMessages(clientId, conversationId, params) {
+    const response = await this.client.get(
+      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,
+      { params }
+    );
+    return response.data;
+  }
+  async sendMessage(clientId, conversationId, payload) {
+    const response = await this.client.post(
+      `/api/clients/${clientId}/messaging/conversations/${conversationId}/messages`,
+      payload
+    );
+    return response.data;
+  }
+  /**
+   * Upload de mídia (ex.: áudio gerado por TTS) — pré-requisito pra mandar `type: 'audio'` no
+   * `sendMessage` (o `content.id` retornado aqui vira `content.id` do envio; `storagePath`
+   * precisa ser ecoado em `content._media.storagePath` no send, senão a plataforma não cria o
+   * registro de mídia local pra conexões Cloud API).
+   */
+  async uploadMedia(clientId, payload) {
+    const form = new FormData();
+    form.append("phoneNumberId", payload.phoneNumberId);
+    if (payload.isVoiceNote) form.append("isVoiceNote", "true");
+    form.append(
+      "file",
+      new Blob([new Uint8Array(payload.file)], { type: payload.mimeType }),
+      payload.filename
+    );
+    const response = await this.client.post(
+      `/api/clients/${clientId}/messaging/media`,
+      form
+    );
+    return response.data;
   }
 };
 
@@ -61,6 +149,7 @@ var PortalClient = class {
   httpClient;
   clients;
   knowledge;
+  messaging;
   constructor(config) {
     this.config = config;
     this.httpClient = axios.create({
@@ -86,11 +175,13 @@ var PortalClient = class {
     );
     this.clients = new ClientsResource(this.httpClient);
     this.knowledge = new KnowledgeResource(this.httpClient);
+    this.messaging = new MessagingResource(this.httpClient);
   }
 };
 export {
   ClientsResource,
   KnowledgeResource,
+  MessagingResource,
   PortalApiError,
   PortalClient
 };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/base.ts","../src/resources/clients/index.ts","../src/resources/knowledge/index.ts","../src/errors.ts"],"sourcesContent":["import axios, { AxiosInstance } from 'axios';\nimport { PortalClientConfig } from './types';\nimport { ClientsResource } from './resources/clients';\nimport { KnowledgeResource } from './resources/knowledge';\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\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  }\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","import { BaseResource } from '../../base';\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","import { BaseResource } from '../../base';\nimport { GetInternalContextParams, InternalContextResult } from './types';\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<InternalContextResult>('/api/knowledge/internal/context', {\n      aiConfigId: params.aiConfigId,\n      question: params.question,\n      conversationHistory: params.conversationHistory\n    });\n    return response.data;\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"],"mappings":";AAAA,OAAO,WAA8B;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACLO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AACF;;;AChBO,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAA4B,mCAAmC;AAAA,MAChG,YAAY,OAAO;AAAA,MACnB,UAAU,OAAO;AAAA,MACjB,qBAAqB,OAAO;AAAA,IAC9B,CAAC;AACD,WAAO,SAAS;AAAA,EAClB;AACF;;;ACbO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;AJPA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,MAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","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"],"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  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    );\n    return response.data;\n  }\n}\n"],"mappings":";AAAA,OAAO,WAA8B;;;ACE9B,IAAe,eAAf,MAA4B;AAAA,EACvB;AAAA,EAEV,YAAY,QAAuB;AACjC,SAAK,SAAS;AAAA,EAChB;AACF;;;ACRO,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EAEA,YAAY,SAAiB,MAAgC;AAC3D,UAAM,OAAO;AACb,SAAK,OAAO;AAEZ,QAAI,MAAM;AACR,WAAK,SAAS,KAAK;AACnB,WAAK,MAAM,KAAK;AAAA,IAClB;AAAA,EACF;AACF;;;ACTO,IAAM,kBAAN,cAA8B,aAAa;AAAA;AAAA,EAEhD,MAAM,oBAAoB,WAA2C;AACnE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,iBAAiB,WAAW,gBAAgB,KAAK;AAAA,IAC7D,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA,EAGA,MAAM,qBAAqB,WAA2C;AACpE,UAAM,WAAW,MAAM,KAAK,OAAO,IAAyB,gBAAgB;AAAA,MAC1E,QAAQ,EAAE,WAAW,gBAAgB,KAAK;AAAA,IAC5C,CAAC;AACD,WAAO,SAAS,KAAK,KAAK,CAAC,KAAK;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,QAAQ,UAA0C;AACtD,QAAI;AACF,YAAM,WAAW,MAAM,KAAK,OAAO,IAAY,gBAAgB,QAAQ,EAAE;AACzE,aAAO,SAAS;AAAA,IAClB,SAAS,OAAO;AACd,UAAI,iBAAiB,kBAAkB,MAAM,WAAW,IAAK,QAAO;AACpE,YAAM;AAAA,IACR;AAAA,EACF;AACF;;;ACpCA,SAAS,SAAS;AAKlB,IAAM,6BAA6B,EAAE,OAAO;AAAA,EAC1C,SAAS,EAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,SAAS,EAAE,OAAO;AAAA,EAClB,YAAY,EAAE,OAAO;AAAA,EACrB,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,EAAE,SAAS;AACvD,CAAC;AAED,IAAM,8BAA8B,EAAE,MAAM,0BAA0B;AAE/D,IAAM,oBAAN,cAAgC,aAAa;AAAA;AAAA,EAElD,MAAM,mBAAmB,QAAkE;AACzF,UAAM,WAAW,MAAM,KAAK,OAAO,KAAc,mCAAmC;AAAA,MAClF,YAAY,OAAO;AAAA,MACnB,UAAU,OAAO;AAAA,MACjB,qBAAqB,OAAO;AAAA,IAC9B,CAAC;AAED,UAAM,SAAS,4BAA4B,UAAU,SAAS,IAAI;AAClE,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,IAAI,eAAe,2DAAwD;AAAA,QAC/E,KAAK,OAAO,MAAM,QAAQ;AAAA,MAC5B,CAAC;AAAA,IACH;AACA,WAAO,OAAO;AAAA,EAChB;AACF;;;ACXO,IAAM,oBAAN,cAAgC,aAAa;AAAA,EAClD,MAAM,kBACJ,UACA,SAC6C;AAC7C,UAAM,WAAW,MAAM,KAAK,OAAO;AAAA,MACjC,gBAAgB,QAAQ;AAAA,MACxB,EAAE,QAAQ,QAAQ;AAAA,IACpB;AACA,WAAO,SAAS;AAAA,EAClB;AAAA,EAEA,MAAM,gBAAgB,UAAkB,gBAAwD;AAC9F,UAAM,WAAW,MAAM,KAAK,OAAO;AAAA,MACjC,gBAAgB,QAAQ,4BAA4B,cAAc;AAAA,IACpE;AACA,WAAO,SAAS;AAAA,EAClB;AAAA,EAEA,MAAM,kBACJ,UACA,gBACA,SACgC;AAChC,UAAM,WAAW,MAAM,KAAK,OAAO;AAAA,MACjC,gBAAgB,QAAQ,4BAA4B,cAAc;AAAA,MAClE;AAAA,IACF;AACA,WAAO,SAAS;AAAA,EAClB;AAAA,EAEA,MAAM,YACJ,UACA,gBACA,QACwC;AACxC,UAAM,WAAW,MAAM,KAAK,OAAO;AAAA,MACjC,gBAAgB,QAAQ,4BAA4B,cAAc;AAAA,MAClE,EAAE,OAAO;AAAA,IACX;AACA,WAAO,SAAS;AAAA,EAClB;AAAA,EAEA,MAAM,YACJ,UACA,gBACA,SAC8B;AAC9B,UAAM,WAAW,MAAM,KAAK,OAAO;AAAA,MACjC,gBAAgB,QAAQ,4BAA4B,cAAc;AAAA,MAClE;AAAA,IACF;AACA,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,YAAY,UAAkB,SAA2D;AAC7F,UAAM,OAAO,IAAI,SAAS;AAG1B,SAAK,OAAO,iBAAiB,QAAQ,aAAa;AAClD,QAAI,QAAQ,YAAa,MAAK,OAAO,eAAe,MAAM;AAC1D,SAAK;AAAA,MACH;AAAA,MACA,IAAI,KAAK,CAAC,IAAI,WAAW,QAAQ,IAAI,CAAC,GAAG,EAAE,MAAM,QAAQ,SAAS,CAAC;AAAA,MACnE,QAAQ;AAAA,IACV;AAEA,UAAM,WAAW,MAAM,KAAK,OAAO;AAAA,MACjC,gBAAgB,QAAQ;AAAA,MACxB;AAAA,IACF;AACA,WAAO,SAAS;AAAA,EAClB;AACF;;;AL5FA,IAAM,mBAAmB;AAElB,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEP,YAAY,QAA4B;AACtC,SAAK,SAAS;AAEd,SAAK,aAAa,MAAM,OAAO;AAAA,MAC7B,SAAS,OAAO,WAAW;AAAA,MAC3B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa,OAAO;AAAA,QACpB,oBAAoB,OAAO;AAAA,MAC7B;AAAA,IACF,CAAC;AAED,SAAK,WAAW,aAAa,SAAS;AAAA,MACpC,CAAC,aAAa;AAAA,MACd,CAAC,UAAU;AACT,YAAI,MAAM,UAAU;AAClB,gBAAM,UAAU,MAAM,SAAS;AAC/B,gBAAM,IAAI,eAAe,SAAS,SAAS,oBAAoB;AAAA,YAC7D,QAAQ,MAAM,SAAS;AAAA,YACvB,KAAK;AAAA,UACP,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAEA,SAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;AAClD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AACtD,SAAK,YAAY,IAAI,kBAAkB,KAAK,UAAU;AAAA,EACxD;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portal-aiatende-api",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Cliente TypeScript tipado para a API interna do Portal AI Atende.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -23,7 +23,8 @@
   "license": "ISC",
   "type": "commonjs",
   "dependencies": {
-    "axios": "^1.15.2"
+    "axios": "^1.15.2",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",