kommo-aiatende-api 1.0.1 → 1.1.0

package/README.md

@@ -1,7 +1,6 @@
 # Kommo API SDK (V4) 🚀
 
-SDK moderno, resiliente e **totalmente tipado** em TypeScript para a API V4 da [Kommo CRM](https://kommo.com).
-
+SDK moderno, robusto, resiliente e **totalmente tipado** em TypeScript para a API V4 da [Kommo CRM](https://kommo.com). Desenhado para remover o atrito na comunicação com a API da Kommo, encapsulando vulnerabilidades e oferecendo uma experiência de desenvolvedor (DX) premium com IntelliSense nativo.
 
 ## 📦 Instalação
 
@@ -13,100 +12,118 @@ yarn add kommo-aiatende-api
 pnpm add kommo-aiatende-api
 ```
 
-## ✨ Funcionalidades Mapeadas
-
-Esta biblioteca foi desenhada com alto nível de rigor às complexidades da documentação da Kommo, encapsulando vulnerabilidades e garantindo auto-complete puro via Typescript (IntelliSense) em centenas de propriedades:
+---
 
-*   **Entidades Base:** `leads`, `contacts`, `companies`
-*   **Caixa de Entrada (Unsorted):** Aceitar, recusar e vincular dados do pipeline.
-*   **Funis (Pipelines & Status):** Configuração estrutural do CRM.
-*   **Campos Personalizados (Custom Fields & Groups):** Inclusão de tipagem complexa para metadados invisíveis.
-*   **Usuários e Funções (Users & Roles):** Leitura de Rights Limit.
-*   **Notas e Tarefas (Notes & Tasks):** Com resolução inteligente do campo result.
-*   **Eventos (Events):** Logs estruturados para ValueType Polymorphism.
-*   **Listas (Catalogs & Elements)**.
-*   **Tags:** Operações de batch patching e validações de Hex colors.
-*   **Vínculos (Links):** Proteções Pre-flight em filtros essenciais.
-*   **Salesbots & Templates (Waba):** Controle rigoroso de disparos com validações Max Length Limits.
-*   **Integrações Externas:** Fontes (`sources`), Webhooks e Botões de Chat Web.
+## 🛠 Funcionalidades e Mapeamento
+Um dos grandes diferenciais desta biblioteca é a padronização das inconsistências da Documentação da Kommo. 
+Abaixo está o **Escopo Padrão de 100% de Cobertura** implementado no cliente:
+
+- [x] **Leads**, **Contatos** e **Empresas**: CRUD completo.
+- [x] **Unsorted (Caixa de Entrada)**: Aceitação, recusa e linkagem para pipelines.
+- [x] **Pipelines e Status (Estágios)**: Gestão de funis incluindo cores RGB validadas.
+- [x] **Campos Personalizados (Custom Fields & Groups)**: Tratamento tipado para Enum types e Multitexts.
+- [x] **Usuários e Funções (Roles)**: Suporte a Rights Limits estruturados.
+- [x] **Tarefas (Tasks)** e **Anotações (Notes)**: Automação completa do CRM interno com tratamento de `result` textuais da V4.
+- [x] **Eventos (Events)**: Log System com `value_after` e `value_before` tipados via polimorfismo.
+- [x] **Catálogos / Elements (Lists)**.
+- [x] **Vínculos (Links)**: Associações entre leads/contacts e validações pre-flight no backend para evitar BadRequests de Filtros cruzados falhos.
+- [x] **Tags (Etiquetas)**: Validadores de Hex-colors forçados apenas para Entidades suportadas (Leads).
+- [x] **Modelos (Chat Templates / WABA)**: Gestão global do WABA (Meta API), submissão de Reviews, Modificações de status com proteções (templates WABA só alteram em caso de "draft").
+- [x] **Webhooks**: Gerenciamento completo com a particularidade do Delete HTTP baseado em URL `destination`, ao invés de ID.
+- [x] **Fontes (Sources) & WebButtons**: Divisão arquitetural correta, para gestão robusta dos fluxos Frontend x Backend da sua I.A.
+- [x] **Salesbots**: Pre-flight de rate Limits bloqueando envio massivo maior que `100 bots` por fila e aviso em botões longos no DOM Mobile.
+- [x] **Files API & CDN**: Gerenciamento binário multi-part estruturado e fallback nativo na resposta inconsistente dos "Arrays brutos e Embedded JSONs". Separação do uso da infra `v1.0` de Drive, e da Infra `api/v4` de anexos de entidade.
 
+---
 
-## 🚀 Configuração Básica
+## 🚀 Configuração Básica e Autenticação
 
-Inicializando e injetando o cliente em sua aplicação Node.js:
+A biblioteca gerencia toda a serialização do Body JSON e QueryStrings, bastando que você cuide do seu Token Bearer.
 
 ```typescript
 import { KommoClient } from 'kommo-aiatende-api';
 
 const client = new KommoClient({
-  domain: 'meudominio', // Não inclua ".kommo.com", apenas o subdomínio!
+  domain: 'meudominio', // Não inclua ".kommo.com", apenas o subdomínio base!
   accessToken: 'SEU_BEARER_TOKEN_AQUI'
 });
+
+// Acessando as entidades - Exemplo de GET simples com Paginação
+const { _embedded: { leads }, _page } = await client.leads.list({
+    limit: 50,
+    page: 2,
+    with: 'contacts' // O Auto-complete trará quais parâmetros `with` a SDK suporta.
+});
+
+console.log(`Buscando a pagina ${ _page }. Total de leads recebidos: ${leads?.length}`);
 ```
 
-*Nota: Todos os métodos assumem que seus tokens são válidos. Você deve implementar o fluxo OAuth2.0 separadamente para emitir e reciclar seus tokens.*
+*Nota Cautelar: Todos os métodos assumem que seus Access Tokens estão sendo refrescados por sua infraestrutura OAuth 2.0 externa.*
 
 ---
 
-## 📖 Exemplos Rápidos de Uso
+## 📖 Exemplos Práticos de Uso Avançado
 
-### 1. Criando Entidades com Proteção Typada
+### 1. Criando Entidades com Proteção Tipada
 ```typescript
-import { KommoClient } from 'kommo-aiatende-api';
-
-const client = new KommoClient({ domain: 'meudominio', accessToken: 'TOKEN' });
-
-async function criarLead() {
+async function criarNegocioEstrategico() {
   const result = await client.leads.create({
-    name: 'Novo Negócio Estratégico',
+    name: 'Lead Inteligência Artificial',
     price: 15400,
+    pipeline_id: 8887,
     tags_to_add: [
         { name: 'VIP' }
     ]
   });
   
-  console.log('Lead criado com sucesso: ', result._embedded?.leads?.[0].id);
+  console.log('Lead ID: ', result._embedded?.leads?.[0].id);
 }
 ```
 
-### 2. Vínculos Avançados (Links)
-
-Conecte um contato diretamente ao seu Lead recém-criado em Lote (Batch).
+### 2. Vínculos e Lotes (Links Batch)
+Exemplo vinculando um Contato a um Lead recém-criado, utilizando normalização automática das strings de metadados:
 ```typescript
 await client.links.link('leads', 15591, [
     {
        to_entity_type: 'contacts',
        to_entity_id: 11069775,
        metadata: {
-          is_main: true // O SDK normalizará as ambiguidades da API!
+          is_main: true // A SDK serializa e aceita "is_main" ao invés do confuso "main_contact" de Payload cruzado
        }
     }
 ]);
 ```
 
-### 3. Executando um Salesbot com Barreiras Físicas
-
-Esqueça o Erro "403 Limit Exceeded" da Kommo por não conhecer os limites. A própria SDK bloqueia antes do tráfego:
+### 3. Rate Limits e Pre-Flight Blockers (Ex: SalesBots)
+Esqueça o Erro "403 Limit Exceeded" silencioso na Kommo. A própria SDK bloqueia ações fisicamente antes delas atingirem os cabos de rede:
 ```typescript
-await client.salesbots.runMany([
-    // ... se passar de 100 itens ...
-    // Throws: "A API da Kommo limita o 'runMany' a no máximo 100 salesbots por requisição."
-]);
+try {
+   await client.salesbots.runMany([...105 itens...]); 
+} catch (e) {
+   // ERRO PRÉVIO GERADO NO NODE: 
+   // "A API da Kommo limita o 'runMany' a no máximo 100 salesbots por requisição."
+}
 ```
 
-### 4. Gestão do Funil (Pipelines)
+### 4. Gestão de Arquivos e Binários (Files API)
+A SDK se encarrega de instruir o HTTP Client a setar os Data-Types de _octet-stream_. É só dar o Buffer Node para ele:
+
 ```typescript
-const funis = await client.pipelines.list();
+const { session_token } = await client.files.service.createUploadSession({ 
+   file_name: "Contrato.pdf",
+   file_size: 150000 
+});
 
-const funilAtivo = funis._embedded?.pipelines?.find(p => p.is_main);
-console.log('Funil Principal: ', funilAtivo?.name);
+await client.files.service.uploadPart(session_token, myPdfBufferData);
 ```
 
 ---
 
-## 🛡️ Tratamento de Erros Moderno e Intuitivo
+## 🛡️ Tratamento de Erros e `KommoApiError`
 
-Qualquer rota falha lançará a classe `KommoApiError`. Ela empacota o padrão nativo de `application/problem+json` num wrapper explícito:
+Para uma excelente depuração no seu console ou Grafana, qualquer rota do Server falha lançará a classe empacotada abstrata `KommoApiError`. Tratamentos assíncronos não resolvidos (204 e 202) são traduzidos polidamente em promessas `void`.
+
+Você mapeia o rastro do servidor nativo assim:
 
 ```typescript
 import { KommoApiError } from 'kommo-aiatende-api/errors';
@@ -115,22 +132,24 @@ try {
   await client.leads.getById(99999999);
 } catch (error) {
   if (error instanceof KommoApiError) {
-    console.error('Código HTTP:', error.status); // ex: 404
-    console.error('Título da Kommo:', error.title);
-    console.error('Detalhe Técnico:', error.detail);
+    console.error(`[ KOMMO API ERROR ] - HTTP ${error.status}`); // ex: 404
+    console.error(`=> Título: ${error.title}`);
+    console.error(`=> Detalhe: ${error.detail}`);
     
-    // Payload brutal devolvido pela requisição (quando disponível)
+    // Payload JSON completo devolvido pela web
     console.log(error.raw);
+  } else {
+    // Erros padões de Syntax NodeJS ou da engine V8
+    console.error(error);
   }
 }
 ```
 
-## 🏗️ Padrões Internos (Architecture)
-A lib adota dois estilos de serialização para proteger suas chamadas:
-1. **Raw Body Conversions:** Rotas da Kommo v4 exigem arrays brutos (`[]`) misturados a requests sem aninhamento de object. O SDK mapeia se você enviou Arrays ou Singleton e encapsula conforme o exigido na Doc.
-2. **Query String Normalization:** Usamos o `qs` com a instrução `{ arrayFormat: 'brackets' }` para evitar que seus arrays nos filtros de `GET` quebrem a formatação em backend na Rússia.
-
+## 🏗️ Padrões Internos & Arquitetura (Architecture)
+- **Raw Body Conversions:** Rotas da Kommo v4 exigem arrays brutos (`[ {...} ]`) injetados diretamente no Corpo do Payload. A SDK faz a normalização e envelopamento se você enviou Arrays ou Objetos Únicos num request que exija coleção no Backend da Rússia.
+- **Query String Normalization (`qs`)**: O Typescript utiliza o pacote `qs` formatado para `brackets`, convertendo arrays lógicos Node em arrays compreensivos pela V4 (Ex: `{ filter_id: [1,2] }` vira `?filter[id][]=1&filter[id][]=2`) sem fricção pro desenvolvedor.
 
 ---
 ## 📄 Licença
-Licenciado sob a Licença MIT. Sinta-se livre para ramificar e customizar seu repositório local.
+Licenciado livremente sob os termos da licença MIT. 
+Sinta-se à vontade para "Forkar" e ramificar customizações em sua infraestrutura!

package/dist/index.d.mts

@@ -2655,6 +2655,96 @@ declare class WebhooksResource extends BaseResource {
     delete(payload: DeleteWebhookInput): Promise<void>;
 }
 
+type FileRecord = Record<string, unknown>;
+type FileVersionRecord = Record<string, unknown>;
+type EntityAttachedFileRecord = Record<string, unknown>;
+type FileLinkedEntityRecord = Record<string, unknown>;
+interface ListFilesParams {
+    filter_uuid?: string[];
+    filter_name?: string;
+    filter_extensions?: string[];
+    filter_term?: string;
+    filter_source_id?: number;
+    filter_deleted?: boolean;
+    filter_size_unit?: number;
+    filter_size_from?: number;
+    filter_size_to?: number;
+    filter_date_type?: 'created_at' | 'updated_at';
+    filter_date_preset?: string;
+    filter_date_from?: number;
+    filter_date_to?: number;
+    filter_created_by?: number[];
+    filter_updated_by?: number[];
+}
+interface ListFilesResponse {
+    items?: FileRecord[];
+    raw?: unknown;
+}
+interface CreateFileUploadSessionInput {
+    file_name: string;
+    file_size: number;
+    file_uuid?: string;
+    content_type?: string;
+    with_preview?: boolean;
+}
+type UploadSessionResponse = Record<string, unknown>;
+type UploadFilePartInput = ArrayBuffer | Uint8Array | any;
+type UploadFilePartResponse = Record<string, unknown>;
+type UpdateFileInput = {
+    name: string;
+    version_uuid?: never;
+} | {
+    version_uuid: string;
+    name?: never;
+};
+type DeleteFilesItem = Record<string, unknown>;
+type RestoreFilesItem = Record<string, unknown>;
+interface ListFileVersionsResponse {
+    items?: FileVersionRecord[];
+    raw?: unknown;
+}
+type FileAttachEntityType = 'leads' | 'contacts' | 'companies' | 'contatos' | 'empresas' | string;
+interface ListEntityAttachedFilesParams {
+    limit?: number;
+    before_id?: number;
+}
+interface ListEntityAttachedFilesResponse {
+    items?: EntityAttachedFileRecord[];
+    raw?: unknown;
+}
+type AttachFilesToEntityItem = Record<string, unknown>;
+type DetachFilesFromEntityItem = Record<string, unknown>;
+interface ListFileLinkedEntitiesResponse {
+    items?: FileLinkedEntityRecord[];
+    raw?: unknown;
+}
+
+declare class FilesServiceResource extends BaseResource {
+    getByUuid(fileUuid: string): Promise<FileRecord | null>;
+    list(params?: ListFilesParams): Promise<ListFilesResponse>;
+    createUploadSession(payload: CreateFileUploadSessionInput): Promise<UploadSessionResponse>;
+    uploadPart(sessionToken: string, filePart: UploadFilePartInput): Promise<UploadFilePartResponse>;
+    update(fileUuid: string, payload: UpdateFileInput): Promise<FileRecord>;
+    delete(items: DeleteFilesItem | DeleteFilesItem[]): Promise<Record<string, unknown>>;
+    restore(items: RestoreFilesItem | RestoreFilesItem[]): Promise<Record<string, unknown>>;
+    listVersions(fileUuid: string): Promise<ListFileVersionsResponse>;
+}
+declare class EntityFilesResource extends BaseResource {
+    private normalizeEntity;
+    listAttachedToEntity(entity: FileAttachEntityType, entityId: number, params?: ListEntityAttachedFilesParams): Promise<ListEntityAttachedFilesResponse>;
+    attachToEntity(entity: FileAttachEntityType, entityId: number, items: AttachFilesToEntityItem | AttachFilesToEntityItem[]): Promise<Record<string, unknown>>;
+    detachFromEntity(entity: FileAttachEntityType, entityId: number, items: DetachFilesFromEntityItem | DetachFilesFromEntityItem[]): Promise<void>;
+}
+declare class FileLinksResource extends BaseResource {
+    listLinkedEntities(fileUuid: string): Promise<ListFileLinkedEntitiesResponse>;
+}
+declare class FilesResource extends BaseResource {
+    service: FilesServiceResource;
+    entities: EntityFilesResource;
+    links: FileLinksResource;
+    constructor(httpClient: any);
+}
+
 declare class KommoClient {
     config: KommoConfig;
     auth: AuthManager;
@@ -2679,6 +2769,7 @@ declare class KommoClient {
     websiteButtons: WebsiteButtonsResource;
     chatTemplates: ChatTemplatesResource;
     webhooks: WebhooksResource;
+    files: FilesResource;
     constructor(config: KommoConfig);
     setAccessToken(token: string): void;
 }
@@ -2692,4 +2783,4 @@ declare class KommoApiError extends Error {
     constructor(message: string, info?: Partial<KommoApiError>);
 }
 
-export { type AccessTokenResponse, type AttachmentNoteParams, AuthManager, type BaseCreateUnsortedItem, type BaseCustomField, type BaseEntity, type CallNoteParams, type Catalog, type CatalogElement, type CatalogElementCustomFieldValue, CatalogsResource, type ChatTemplate, type ChatTemplateAttachment, type ChatTemplateButton, type ChatTemplateButtonType, type ChatTemplateReview, type ChatTemplateType, ChatTemplatesResource, type CollectionResponse, type CommonNoteParams, CompaniesResource, type Company, type CompanyCatalogElementRef, type CompanyContactRef, type CompanyLeadRef, type CompanyTag, type CompanyTagRef, type CompanyWithParam, type Contact, type ContactCatalogElementRef, type ContactCompanyRef, type ContactCustomerRef, type ContactLeadRef, type ContactTag, type ContactTagRef, type ContactWithParam, ContactsResource, type CreateCatalogElementInput, type CreateCatalogElementsResponse, type CreateCatalogInput, type CreateCatalogsResponse, type CreateChatTemplateInput, type CreateChatTemplatesResponse, type CreateCompaniesResponse, type CreateCompanyInput, type CreateComplexLeadInput, type CreateComplexLeadsResponse, type CreateComplexLeadsResponseItem, type CreateContactInput, type CreateContactsResponse, type CreateCustomFieldGroupInput, type CreateEntityCustomFieldInput, type CreateEntityLinkInput, type CreateEntityLinksResponse, type CreateFormUnsortedLeadInput, type CreateLeadInput, type CreateLeadsResponse, type CreateListCustomFieldInput, type CreateNoteInput, type CreateNotesResponse, type CreatePipelineInput, type CreatePipelineStatusInput, type CreatePipelinesResponse, type CreateRoleInput, type CreateSipUnsortedLeadInput, type CreateSourceInput, type CreateSourcesResponse, type CreateStatusInput, type CreateStatusesResponse, type CreateTagInput, type CreateTagRef, type CreateTagsResponse, type CreateTaskInput, type CreateTasksResponse, type CreateUnsortedCompany, type CreateUnsortedContact, type CreateUnsortedLead, type CreateUnsortedLeadsResponse, type CreateUserInput, type CreateWebhookInput, type CreateWebsiteButtonInput, type CreateWebsiteButtonResponse, type CustomField, type CustomFieldEnum, type CustomFieldGroup, CustomFieldGroupsResource, type CustomFieldNestedValue, type CustomFieldRequiredStatus, type CustomFieldType, type CustomFieldValue, CustomFieldsResource, type DeleteChatTemplateInput, type DeleteEntityLinkInput, type DeleteSourceBatchInput, type DeleteWebhookInput, type Embedded, type EntityCustomField, type EntityLink, type EntityLinkMetadata, type EntityLinkWithSource, type EntityRights, type EntityType, type EntityUpdateResult, type Event, type EventTypeDefinition, type EventValueChange, type EventValueFilters, type EventWithParam, EventsResource, type FormMetadata, type GeolocationNoteParams, KNOWN_WEBHOOK_EVENTS, KOMMO_PIPELINE_STAGE_COLORS, KOMMO_TAG_COLORS, type KnownEventType, KommoApiError, KommoClient, type KommoConfig, type KommoPipelineStageColor, type Lead, type LeadCatalogElementRef, type LeadCompanyRef, type LeadContactRef, type LeadTag, type LeadTagRef, type LeadWithParam, LeadsResource, type LinkMetadataInput, type LinkSourceEntityType, type LinkTargetEntityType, type LinkUnsortedLeadResponse, LinksResource, type ListCatalogElementsParams, type ListCatalogElementsResponse, type ListCatalogsParams, type ListCatalogsResponse, type ListChatTemplatesParams, type ListChatTemplatesResponse, type ListCompaniesParams, type ListCompaniesResponse, type ListContactsParams, type ListContactsResponse, type ListCustomField, type ListCustomFieldGroupsResponse, type ListEntityCustomFieldsResponse, type ListEntityLinksParams, type ListEntityLinksResponse, type ListEntityNotesParams, type ListEventTypesParams, type ListEventTypesResponse, type ListEventsParams, type ListEventsResponse, type ListLeadsParams, type ListLeadsResponse, type ListListCustomFieldsResponse, type ListLossReasonsResponse, type ListNotesResponse, type ListPipelineStatusesResponse, type ListPipelinesResponse, type ListRolesParams, type ListRolesResponse, type ListSalesbotsParams, type ListSalesbotsResponse, type ListSourcesResponse, type ListTagsParams, type ListTagsResponse, type ListTasksParams, type ListTasksResponse, type ListUnsortedLeadsParams, type ListUnsortedLeadsResponse, type ListUsersParams, type ListUsersResponse, type ListWebhooksParams, type ListWebhooksResponse, type ListWebsiteButtonsParams, type ListWebsiteButtonsResponse, type LossReason, type Note, type NoteEntityType, type NoteParams, type NoteType, NotesResource, type PermissionLevel, type Pipeline, type PipelineStatus, PipelinesResource, type Role, type RoleWithParam, RolesResource, type RunManySalesbotsItem, type RunSalesbotInput, type Salesbot, type SalesbotContinueBotType, type SalesbotContinueInput, type SalesbotExecuteHandler, type SalesbotFunctionalityType, SalesbotsResource, type ServiceMessageNoteParams, type SipMetadata, type SmsNoteParams, type Source, type SourceService, type SourceServicePage, SourcesResource, type StatusDescription, type StatusRight, type StopSalesbotInput, type SubmitWhatsAppTemplateReviewResponse, type Tag, type TagColor, type TagEntityType, type TagRefInput, TagsResource, type Task, TasksResource, type UnsortedDecisionResponse, type UnsortedLead, UnsortedResource, type UnsortedSummaryParams, type UnsortedSummaryResponse, type UpdateCatalogElementInput, type UpdateCatalogElementsResponse, type UpdateCatalogInput, type UpdateCatalogsResponse, type UpdateChatTemplateInput, type UpdateChatTemplatesResponse, type UpdateCompaniesResponse, type UpdateCompanyInput, type UpdateContactInput, type UpdateContactsResponse, type UpdateCustomFieldGroupInput, type UpdateEntityCustomFieldInput, type UpdateEntityTagsBatchResponse, type UpdateEntityTagsInput, type UpdateEntityTagsSingleResponse, type UpdateLeadInput, type UpdateLeadsResponse, type UpdateListCustomFieldInput, type UpdateNoteInput, type UpdateNotesResponse, type UpdatePipelineInput, type UpdateRoleInput, type UpdateSingleCatalogElementInput, type UpdateSingleCatalogInput, type UpdateSingleCompanyInput, type UpdateSingleContactInput, type UpdateSingleEntityCustomFieldInput, type UpdateSingleEntityTagsInput, type UpdateSingleLeadInput, type UpdateSingleListCustomFieldInput, type UpdateSingleNoteInput, type UpdateSingleTaskInput, type UpdateSourceBatchInput, type UpdateSourceInput, type UpdateSourcesResponse, type UpdateStatusInput, type UpdateTaskInput, type UpdateTasksResponse, type UpdateWebsiteButtonInput, type UpdateWhatsAppTemplateReviewStatusInput, type UpdateWhatsAppTemplateReviewStatusResponse, type User, type UserWithParam, UsersResource, type WabaCategory, type WabaHeaderType, type WabaReviewStatus, type Webhook, type WebhookEvent, WebhooksResource, type WebsiteButton, type WebsiteButtonCreationStatus, WebsiteButtonsResource, type WhatsAppTemplateModerationStatus, eventUtils };
+export { type AccessTokenResponse, type AttachFilesToEntityItem, type AttachmentNoteParams, AuthManager, type BaseCreateUnsortedItem, type BaseCustomField, type BaseEntity, type CallNoteParams, type Catalog, type CatalogElement, type CatalogElementCustomFieldValue, CatalogsResource, type ChatTemplate, type ChatTemplateAttachment, type ChatTemplateButton, type ChatTemplateButtonType, type ChatTemplateReview, type ChatTemplateType, ChatTemplatesResource, type CollectionResponse, type CommonNoteParams, CompaniesResource, type Company, type CompanyCatalogElementRef, type CompanyContactRef, type CompanyLeadRef, type CompanyTag, type CompanyTagRef, type CompanyWithParam, type Contact, type ContactCatalogElementRef, type ContactCompanyRef, type ContactCustomerRef, type ContactLeadRef, type ContactTag, type ContactTagRef, type ContactWithParam, ContactsResource, type CreateCatalogElementInput, type CreateCatalogElementsResponse, type CreateCatalogInput, type CreateCatalogsResponse, type CreateChatTemplateInput, type CreateChatTemplatesResponse, type CreateCompaniesResponse, type CreateCompanyInput, type CreateComplexLeadInput, type CreateComplexLeadsResponse, type CreateComplexLeadsResponseItem, type CreateContactInput, type CreateContactsResponse, type CreateCustomFieldGroupInput, type CreateEntityCustomFieldInput, type CreateEntityLinkInput, type CreateEntityLinksResponse, type CreateFileUploadSessionInput, type CreateFormUnsortedLeadInput, type CreateLeadInput, type CreateLeadsResponse, type CreateListCustomFieldInput, type CreateNoteInput, type CreateNotesResponse, type CreatePipelineInput, type CreatePipelineStatusInput, type CreatePipelinesResponse, type CreateRoleInput, type CreateSipUnsortedLeadInput, type CreateSourceInput, type CreateSourcesResponse, type CreateStatusInput, type CreateStatusesResponse, type CreateTagInput, type CreateTagRef, type CreateTagsResponse, type CreateTaskInput, type CreateTasksResponse, type CreateUnsortedCompany, type CreateUnsortedContact, type CreateUnsortedLead, type CreateUnsortedLeadsResponse, type CreateUserInput, type CreateWebhookInput, type CreateWebsiteButtonInput, type CreateWebsiteButtonResponse, type CustomField, type CustomFieldEnum, type CustomFieldGroup, CustomFieldGroupsResource, type CustomFieldNestedValue, type CustomFieldRequiredStatus, type CustomFieldType, type CustomFieldValue, CustomFieldsResource, type DeleteChatTemplateInput, type DeleteEntityLinkInput, type DeleteFilesItem, type DeleteSourceBatchInput, type DeleteWebhookInput, type DetachFilesFromEntityItem, type Embedded, type EntityAttachedFileRecord, type EntityCustomField, EntityFilesResource, type EntityLink, type EntityLinkMetadata, type EntityLinkWithSource, type EntityRights, type EntityType, type EntityUpdateResult, type Event, type EventTypeDefinition, type EventValueChange, type EventValueFilters, type EventWithParam, EventsResource, type FileAttachEntityType, type FileLinkedEntityRecord, FileLinksResource, type FileRecord, type FileVersionRecord, FilesResource, FilesServiceResource, type FormMetadata, type GeolocationNoteParams, KNOWN_WEBHOOK_EVENTS, KOMMO_PIPELINE_STAGE_COLORS, KOMMO_TAG_COLORS, type KnownEventType, KommoApiError, KommoClient, type KommoConfig, type KommoPipelineStageColor, type Lead, type LeadCatalogElementRef, type LeadCompanyRef, type LeadContactRef, type LeadTag, type LeadTagRef, type LeadWithParam, LeadsResource, type LinkMetadataInput, type LinkSourceEntityType, type LinkTargetEntityType, type LinkUnsortedLeadResponse, LinksResource, type ListCatalogElementsParams, type ListCatalogElementsResponse, type ListCatalogsParams, type ListCatalogsResponse, type ListChatTemplatesParams, type ListChatTemplatesResponse, type ListCompaniesParams, type ListCompaniesResponse, type ListContactsParams, type ListContactsResponse, type ListCustomField, type ListCustomFieldGroupsResponse, type ListEntityAttachedFilesParams, type ListEntityAttachedFilesResponse, type ListEntityCustomFieldsResponse, type ListEntityLinksParams, type ListEntityLinksResponse, type ListEntityNotesParams, type ListEventTypesParams, type ListEventTypesResponse, type ListEventsParams, type ListEventsResponse, type ListFileLinkedEntitiesResponse, type ListFileVersionsResponse, type ListFilesParams, type ListFilesResponse, type ListLeadsParams, type ListLeadsResponse, type ListListCustomFieldsResponse, type ListLossReasonsResponse, type ListNotesResponse, type ListPipelineStatusesResponse, type ListPipelinesResponse, type ListRolesParams, type ListRolesResponse, type ListSalesbotsParams, type ListSalesbotsResponse, type ListSourcesResponse, type ListTagsParams, type ListTagsResponse, type ListTasksParams, type ListTasksResponse, type ListUnsortedLeadsParams, type ListUnsortedLeadsResponse, type ListUsersParams, type ListUsersResponse, type ListWebhooksParams, type ListWebhooksResponse, type ListWebsiteButtonsParams, type ListWebsiteButtonsResponse, type LossReason, type Note, type NoteEntityType, type NoteParams, type NoteType, NotesResource, type PermissionLevel, type Pipeline, type PipelineStatus, PipelinesResource, type RestoreFilesItem, type Role, type RoleWithParam, RolesResource, type RunManySalesbotsItem, type RunSalesbotInput, type Salesbot, type SalesbotContinueBotType, type SalesbotContinueInput, type SalesbotExecuteHandler, type SalesbotFunctionalityType, SalesbotsResource, type ServiceMessageNoteParams, type SipMetadata, type SmsNoteParams, type Source, type SourceService, type SourceServicePage, SourcesResource, type StatusDescription, type StatusRight, type StopSalesbotInput, type SubmitWhatsAppTemplateReviewResponse, type Tag, type TagColor, type TagEntityType, type TagRefInput, TagsResource, type Task, TasksResource, type UnsortedDecisionResponse, type UnsortedLead, UnsortedResource, type UnsortedSummaryParams, type UnsortedSummaryResponse, type UpdateCatalogElementInput, type UpdateCatalogElementsResponse, type UpdateCatalogInput, type UpdateCatalogsResponse, type UpdateChatTemplateInput, type UpdateChatTemplatesResponse, type UpdateCompaniesResponse, type UpdateCompanyInput, type UpdateContactInput, type UpdateContactsResponse, type UpdateCustomFieldGroupInput, type UpdateEntityCustomFieldInput, type UpdateEntityTagsBatchResponse, type UpdateEntityTagsInput, type UpdateEntityTagsSingleResponse, type UpdateFileInput, type UpdateLeadInput, type UpdateLeadsResponse, type UpdateListCustomFieldInput, type UpdateNoteInput, type UpdateNotesResponse, type UpdatePipelineInput, type UpdateRoleInput, type UpdateSingleCatalogElementInput, type UpdateSingleCatalogInput, type UpdateSingleCompanyInput, type UpdateSingleContactInput, type UpdateSingleEntityCustomFieldInput, type UpdateSingleEntityTagsInput, type UpdateSingleLeadInput, type UpdateSingleListCustomFieldInput, type UpdateSingleNoteInput, type UpdateSingleTaskInput, type UpdateSourceBatchInput, type UpdateSourceInput, type UpdateSourcesResponse, type UpdateStatusInput, type UpdateTaskInput, type UpdateTasksResponse, type UpdateWebsiteButtonInput, type UpdateWhatsAppTemplateReviewStatusInput, type UpdateWhatsAppTemplateReviewStatusResponse, type UploadFilePartInput, type UploadFilePartResponse, type UploadSessionResponse, type User, type UserWithParam, UsersResource, type WabaCategory, type WabaHeaderType, type WabaReviewStatus, type Webhook, type WebhookEvent, WebhooksResource, type WebsiteButton, type WebsiteButtonCreationStatus, WebsiteButtonsResource, type WhatsAppTemplateModerationStatus, eventUtils };

package/dist/index.d.ts

@@ -2655,6 +2655,96 @@ declare class WebhooksResource extends BaseResource {
     delete(payload: DeleteWebhookInput): Promise<void>;
 }
 
+type FileRecord = Record<string, unknown>;
+type FileVersionRecord = Record<string, unknown>;
+type EntityAttachedFileRecord = Record<string, unknown>;
+type FileLinkedEntityRecord = Record<string, unknown>;
+interface ListFilesParams {
+    filter_uuid?: string[];
+    filter_name?: string;
+    filter_extensions?: string[];
+    filter_term?: string;
+    filter_source_id?: number;
+    filter_deleted?: boolean;
+    filter_size_unit?: number;
+    filter_size_from?: number;
+    filter_size_to?: number;
+    filter_date_type?: 'created_at' | 'updated_at';
+    filter_date_preset?: string;
+    filter_date_from?: number;
+    filter_date_to?: number;
+    filter_created_by?: number[];
+    filter_updated_by?: number[];
+}
+interface ListFilesResponse {
+    items?: FileRecord[];
+    raw?: unknown;
+}
+interface CreateFileUploadSessionInput {
+    file_name: string;
+    file_size: number;
+    file_uuid?: string;
+    content_type?: string;
+    with_preview?: boolean;
+}
+type UploadSessionResponse = Record<string, unknown>;
+type UploadFilePartInput = ArrayBuffer | Uint8Array | any;
+type UploadFilePartResponse = Record<string, unknown>;
+type UpdateFileInput = {
+    name: string;
+    version_uuid?: never;
+} | {
+    version_uuid: string;
+    name?: never;
+};
+type DeleteFilesItem = Record<string, unknown>;
+type RestoreFilesItem = Record<string, unknown>;
+interface ListFileVersionsResponse {
+    items?: FileVersionRecord[];
+    raw?: unknown;
+}
+type FileAttachEntityType = 'leads' | 'contacts' | 'companies' | 'contatos' | 'empresas' | string;
+interface ListEntityAttachedFilesParams {
+    limit?: number;
+    before_id?: number;
+}
+interface ListEntityAttachedFilesResponse {
+    items?: EntityAttachedFileRecord[];
+    raw?: unknown;
+}
+type AttachFilesToEntityItem = Record<string, unknown>;
+type DetachFilesFromEntityItem = Record<string, unknown>;
+interface ListFileLinkedEntitiesResponse {
+    items?: FileLinkedEntityRecord[];
+    raw?: unknown;
+}
+
+declare class FilesServiceResource extends BaseResource {
+    getByUuid(fileUuid: string): Promise<FileRecord | null>;
+    list(params?: ListFilesParams): Promise<ListFilesResponse>;
+    createUploadSession(payload: CreateFileUploadSessionInput): Promise<UploadSessionResponse>;
+    uploadPart(sessionToken: string, filePart: UploadFilePartInput): Promise<UploadFilePartResponse>;
+    update(fileUuid: string, payload: UpdateFileInput): Promise<FileRecord>;
+    delete(items: DeleteFilesItem | DeleteFilesItem[]): Promise<Record<string, unknown>>;
+    restore(items: RestoreFilesItem | RestoreFilesItem[]): Promise<Record<string, unknown>>;
+    listVersions(fileUuid: string): Promise<ListFileVersionsResponse>;
+}
+declare class EntityFilesResource extends BaseResource {
+    private normalizeEntity;
+    listAttachedToEntity(entity: FileAttachEntityType, entityId: number, params?: ListEntityAttachedFilesParams): Promise<ListEntityAttachedFilesResponse>;
+    attachToEntity(entity: FileAttachEntityType, entityId: number, items: AttachFilesToEntityItem | AttachFilesToEntityItem[]): Promise<Record<string, unknown>>;
+    detachFromEntity(entity: FileAttachEntityType, entityId: number, items: DetachFilesFromEntityItem | DetachFilesFromEntityItem[]): Promise<void>;
+}
+declare class FileLinksResource extends BaseResource {
+    listLinkedEntities(fileUuid: string): Promise<ListFileLinkedEntitiesResponse>;
+}
+declare class FilesResource extends BaseResource {
+    service: FilesServiceResource;
+    entities: EntityFilesResource;
+    links: FileLinksResource;
+    constructor(httpClient: any);
+}
+
 declare class KommoClient {
     config: KommoConfig;
     auth: AuthManager;
@@ -2679,6 +2769,7 @@ declare class KommoClient {
     websiteButtons: WebsiteButtonsResource;
     chatTemplates: ChatTemplatesResource;
     webhooks: WebhooksResource;
+    files: FilesResource;
     constructor(config: KommoConfig);
     setAccessToken(token: string): void;
 }
@@ -2692,4 +2783,4 @@ declare class KommoApiError extends Error {
     constructor(message: string, info?: Partial<KommoApiError>);
 }
 
-export { type AccessTokenResponse, type AttachmentNoteParams, AuthManager, type BaseCreateUnsortedItem, type BaseCustomField, type BaseEntity, type CallNoteParams, type Catalog, type CatalogElement, type CatalogElementCustomFieldValue, CatalogsResource, type ChatTemplate, type ChatTemplateAttachment, type ChatTemplateButton, type ChatTemplateButtonType, type ChatTemplateReview, type ChatTemplateType, ChatTemplatesResource, type CollectionResponse, type CommonNoteParams, CompaniesResource, type Company, type CompanyCatalogElementRef, type CompanyContactRef, type CompanyLeadRef, type CompanyTag, type CompanyTagRef, type CompanyWithParam, type Contact, type ContactCatalogElementRef, type ContactCompanyRef, type ContactCustomerRef, type ContactLeadRef, type ContactTag, type ContactTagRef, type ContactWithParam, ContactsResource, type CreateCatalogElementInput, type CreateCatalogElementsResponse, type CreateCatalogInput, type CreateCatalogsResponse, type CreateChatTemplateInput, type CreateChatTemplatesResponse, type CreateCompaniesResponse, type CreateCompanyInput, type CreateComplexLeadInput, type CreateComplexLeadsResponse, type CreateComplexLeadsResponseItem, type CreateContactInput, type CreateContactsResponse, type CreateCustomFieldGroupInput, type CreateEntityCustomFieldInput, type CreateEntityLinkInput, type CreateEntityLinksResponse, type CreateFormUnsortedLeadInput, type CreateLeadInput, type CreateLeadsResponse, type CreateListCustomFieldInput, type CreateNoteInput, type CreateNotesResponse, type CreatePipelineInput, type CreatePipelineStatusInput, type CreatePipelinesResponse, type CreateRoleInput, type CreateSipUnsortedLeadInput, type CreateSourceInput, type CreateSourcesResponse, type CreateStatusInput, type CreateStatusesResponse, type CreateTagInput, type CreateTagRef, type CreateTagsResponse, type CreateTaskInput, type CreateTasksResponse, type CreateUnsortedCompany, type CreateUnsortedContact, type CreateUnsortedLead, type CreateUnsortedLeadsResponse, type CreateUserInput, type CreateWebhookInput, type CreateWebsiteButtonInput, type CreateWebsiteButtonResponse, type CustomField, type CustomFieldEnum, type CustomFieldGroup, CustomFieldGroupsResource, type CustomFieldNestedValue, type CustomFieldRequiredStatus, type CustomFieldType, type CustomFieldValue, CustomFieldsResource, type DeleteChatTemplateInput, type DeleteEntityLinkInput, type DeleteSourceBatchInput, type DeleteWebhookInput, type Embedded, type EntityCustomField, type EntityLink, type EntityLinkMetadata, type EntityLinkWithSource, type EntityRights, type EntityType, type EntityUpdateResult, type Event, type EventTypeDefinition, type EventValueChange, type EventValueFilters, type EventWithParam, EventsResource, type FormMetadata, type GeolocationNoteParams, KNOWN_WEBHOOK_EVENTS, KOMMO_PIPELINE_STAGE_COLORS, KOMMO_TAG_COLORS, type KnownEventType, KommoApiError, KommoClient, type KommoConfig, type KommoPipelineStageColor, type Lead, type LeadCatalogElementRef, type LeadCompanyRef, type LeadContactRef, type LeadTag, type LeadTagRef, type LeadWithParam, LeadsResource, type LinkMetadataInput, type LinkSourceEntityType, type LinkTargetEntityType, type LinkUnsortedLeadResponse, LinksResource, type ListCatalogElementsParams, type ListCatalogElementsResponse, type ListCatalogsParams, type ListCatalogsResponse, type ListChatTemplatesParams, type ListChatTemplatesResponse, type ListCompaniesParams, type ListCompaniesResponse, type ListContactsParams, type ListContactsResponse, type ListCustomField, type ListCustomFieldGroupsResponse, type ListEntityCustomFieldsResponse, type ListEntityLinksParams, type ListEntityLinksResponse, type ListEntityNotesParams, type ListEventTypesParams, type ListEventTypesResponse, type ListEventsParams, type ListEventsResponse, type ListLeadsParams, type ListLeadsResponse, type ListListCustomFieldsResponse, type ListLossReasonsResponse, type ListNotesResponse, type ListPipelineStatusesResponse, type ListPipelinesResponse, type ListRolesParams, type ListRolesResponse, type ListSalesbotsParams, type ListSalesbotsResponse, type ListSourcesResponse, type ListTagsParams, type ListTagsResponse, type ListTasksParams, type ListTasksResponse, type ListUnsortedLeadsParams, type ListUnsortedLeadsResponse, type ListUsersParams, type ListUsersResponse, type ListWebhooksParams, type ListWebhooksResponse, type ListWebsiteButtonsParams, type ListWebsiteButtonsResponse, type LossReason, type Note, type NoteEntityType, type NoteParams, type NoteType, NotesResource, type PermissionLevel, type Pipeline, type PipelineStatus, PipelinesResource, type Role, type RoleWithParam, RolesResource, type RunManySalesbotsItem, type RunSalesbotInput, type Salesbot, type SalesbotContinueBotType, type SalesbotContinueInput, type SalesbotExecuteHandler, type SalesbotFunctionalityType, SalesbotsResource, type ServiceMessageNoteParams, type SipMetadata, type SmsNoteParams, type Source, type SourceService, type SourceServicePage, SourcesResource, type StatusDescription, type StatusRight, type StopSalesbotInput, type SubmitWhatsAppTemplateReviewResponse, type Tag, type TagColor, type TagEntityType, type TagRefInput, TagsResource, type Task, TasksResource, type UnsortedDecisionResponse, type UnsortedLead, UnsortedResource, type UnsortedSummaryParams, type UnsortedSummaryResponse, type UpdateCatalogElementInput, type UpdateCatalogElementsResponse, type UpdateCatalogInput, type UpdateCatalogsResponse, type UpdateChatTemplateInput, type UpdateChatTemplatesResponse, type UpdateCompaniesResponse, type UpdateCompanyInput, type UpdateContactInput, type UpdateContactsResponse, type UpdateCustomFieldGroupInput, type UpdateEntityCustomFieldInput, type UpdateEntityTagsBatchResponse, type UpdateEntityTagsInput, type UpdateEntityTagsSingleResponse, type UpdateLeadInput, type UpdateLeadsResponse, type UpdateListCustomFieldInput, type UpdateNoteInput, type UpdateNotesResponse, type UpdatePipelineInput, type UpdateRoleInput, type UpdateSingleCatalogElementInput, type UpdateSingleCatalogInput, type UpdateSingleCompanyInput, type UpdateSingleContactInput, type UpdateSingleEntityCustomFieldInput, type UpdateSingleEntityTagsInput, type UpdateSingleLeadInput, type UpdateSingleListCustomFieldInput, type UpdateSingleNoteInput, type UpdateSingleTaskInput, type UpdateSourceBatchInput, type UpdateSourceInput, type UpdateSourcesResponse, type UpdateStatusInput, type UpdateTaskInput, type UpdateTasksResponse, type UpdateWebsiteButtonInput, type UpdateWhatsAppTemplateReviewStatusInput, type UpdateWhatsAppTemplateReviewStatusResponse, type User, type UserWithParam, UsersResource, type WabaCategory, type WabaHeaderType, type WabaReviewStatus, type Webhook, type WebhookEvent, WebhooksResource, type WebsiteButton, type WebsiteButtonCreationStatus, WebsiteButtonsResource, type WhatsAppTemplateModerationStatus, eventUtils };
+export { type AccessTokenResponse, type AttachFilesToEntityItem, type AttachmentNoteParams, AuthManager, type BaseCreateUnsortedItem, type BaseCustomField, type BaseEntity, type CallNoteParams, type Catalog, type CatalogElement, type CatalogElementCustomFieldValue, CatalogsResource, type ChatTemplate, type ChatTemplateAttachment, type ChatTemplateButton, type ChatTemplateButtonType, type ChatTemplateReview, type ChatTemplateType, ChatTemplatesResource, type CollectionResponse, type CommonNoteParams, CompaniesResource, type Company, type CompanyCatalogElementRef, type CompanyContactRef, type CompanyLeadRef, type CompanyTag, type CompanyTagRef, type CompanyWithParam, type Contact, type ContactCatalogElementRef, type ContactCompanyRef, type ContactCustomerRef, type ContactLeadRef, type ContactTag, type ContactTagRef, type ContactWithParam, ContactsResource, type CreateCatalogElementInput, type CreateCatalogElementsResponse, type CreateCatalogInput, type CreateCatalogsResponse, type CreateChatTemplateInput, type CreateChatTemplatesResponse, type CreateCompaniesResponse, type CreateCompanyInput, type CreateComplexLeadInput, type CreateComplexLeadsResponse, type CreateComplexLeadsResponseItem, type CreateContactInput, type CreateContactsResponse, type CreateCustomFieldGroupInput, type CreateEntityCustomFieldInput, type CreateEntityLinkInput, type CreateEntityLinksResponse, type CreateFileUploadSessionInput, type CreateFormUnsortedLeadInput, type CreateLeadInput, type CreateLeadsResponse, type CreateListCustomFieldInput, type CreateNoteInput, type CreateNotesResponse, type CreatePipelineInput, type CreatePipelineStatusInput, type CreatePipelinesResponse, type CreateRoleInput, type CreateSipUnsortedLeadInput, type CreateSourceInput, type CreateSourcesResponse, type CreateStatusInput, type CreateStatusesResponse, type CreateTagInput, type CreateTagRef, type CreateTagsResponse, type CreateTaskInput, type CreateTasksResponse, type CreateUnsortedCompany, type CreateUnsortedContact, type CreateUnsortedLead, type CreateUnsortedLeadsResponse, type CreateUserInput, type CreateWebhookInput, type CreateWebsiteButtonInput, type CreateWebsiteButtonResponse, type CustomField, type CustomFieldEnum, type CustomFieldGroup, CustomFieldGroupsResource, type CustomFieldNestedValue, type CustomFieldRequiredStatus, type CustomFieldType, type CustomFieldValue, CustomFieldsResource, type DeleteChatTemplateInput, type DeleteEntityLinkInput, type DeleteFilesItem, type DeleteSourceBatchInput, type DeleteWebhookInput, type DetachFilesFromEntityItem, type Embedded, type EntityAttachedFileRecord, type EntityCustomField, EntityFilesResource, type EntityLink, type EntityLinkMetadata, type EntityLinkWithSource, type EntityRights, type EntityType, type EntityUpdateResult, type Event, type EventTypeDefinition, type EventValueChange, type EventValueFilters, type EventWithParam, EventsResource, type FileAttachEntityType, type FileLinkedEntityRecord, FileLinksResource, type FileRecord, type FileVersionRecord, FilesResource, FilesServiceResource, type FormMetadata, type GeolocationNoteParams, KNOWN_WEBHOOK_EVENTS, KOMMO_PIPELINE_STAGE_COLORS, KOMMO_TAG_COLORS, type KnownEventType, KommoApiError, KommoClient, type KommoConfig, type KommoPipelineStageColor, type Lead, type LeadCatalogElementRef, type LeadCompanyRef, type LeadContactRef, type LeadTag, type LeadTagRef, type LeadWithParam, LeadsResource, type LinkMetadataInput, type LinkSourceEntityType, type LinkTargetEntityType, type LinkUnsortedLeadResponse, LinksResource, type ListCatalogElementsParams, type ListCatalogElementsResponse, type ListCatalogsParams, type ListCatalogsResponse, type ListChatTemplatesParams, type ListChatTemplatesResponse, type ListCompaniesParams, type ListCompaniesResponse, type ListContactsParams, type ListContactsResponse, type ListCustomField, type ListCustomFieldGroupsResponse, type ListEntityAttachedFilesParams, type ListEntityAttachedFilesResponse, type ListEntityCustomFieldsResponse, type ListEntityLinksParams, type ListEntityLinksResponse, type ListEntityNotesParams, type ListEventTypesParams, type ListEventTypesResponse, type ListEventsParams, type ListEventsResponse, type ListFileLinkedEntitiesResponse, type ListFileVersionsResponse, type ListFilesParams, type ListFilesResponse, type ListLeadsParams, type ListLeadsResponse, type ListListCustomFieldsResponse, type ListLossReasonsResponse, type ListNotesResponse, type ListPipelineStatusesResponse, type ListPipelinesResponse, type ListRolesParams, type ListRolesResponse, type ListSalesbotsParams, type ListSalesbotsResponse, type ListSourcesResponse, type ListTagsParams, type ListTagsResponse, type ListTasksParams, type ListTasksResponse, type ListUnsortedLeadsParams, type ListUnsortedLeadsResponse, type ListUsersParams, type ListUsersResponse, type ListWebhooksParams, type ListWebhooksResponse, type ListWebsiteButtonsParams, type ListWebsiteButtonsResponse, type LossReason, type Note, type NoteEntityType, type NoteParams, type NoteType, NotesResource, type PermissionLevel, type Pipeline, type PipelineStatus, PipelinesResource, type RestoreFilesItem, type Role, type RoleWithParam, RolesResource, type RunManySalesbotsItem, type RunSalesbotInput, type Salesbot, type SalesbotContinueBotType, type SalesbotContinueInput, type SalesbotExecuteHandler, type SalesbotFunctionalityType, SalesbotsResource, type ServiceMessageNoteParams, type SipMetadata, type SmsNoteParams, type Source, type SourceService, type SourceServicePage, SourcesResource, type StatusDescription, type StatusRight, type StopSalesbotInput, type SubmitWhatsAppTemplateReviewResponse, type Tag, type TagColor, type TagEntityType, type TagRefInput, TagsResource, type Task, TasksResource, type UnsortedDecisionResponse, type UnsortedLead, UnsortedResource, type UnsortedSummaryParams, type UnsortedSummaryResponse, type UpdateCatalogElementInput, type UpdateCatalogElementsResponse, type UpdateCatalogInput, type UpdateCatalogsResponse, type UpdateChatTemplateInput, type UpdateChatTemplatesResponse, type UpdateCompaniesResponse, type UpdateCompanyInput, type UpdateContactInput, type UpdateContactsResponse, type UpdateCustomFieldGroupInput, type UpdateEntityCustomFieldInput, type UpdateEntityTagsBatchResponse, type UpdateEntityTagsInput, type UpdateEntityTagsSingleResponse, type UpdateFileInput, type UpdateLeadInput, type UpdateLeadsResponse, type UpdateListCustomFieldInput, type UpdateNoteInput, type UpdateNotesResponse, type UpdatePipelineInput, type UpdateRoleInput, type UpdateSingleCatalogElementInput, type UpdateSingleCatalogInput, type UpdateSingleCompanyInput, type UpdateSingleContactInput, type UpdateSingleEntityCustomFieldInput, type UpdateSingleEntityTagsInput, type UpdateSingleLeadInput, type UpdateSingleListCustomFieldInput, type UpdateSingleNoteInput, type UpdateSingleTaskInput, type UpdateSourceBatchInput, type UpdateSourceInput, type UpdateSourcesResponse, type UpdateStatusInput, type UpdateTaskInput, type UpdateTasksResponse, type UpdateWebsiteButtonInput, type UpdateWhatsAppTemplateReviewStatusInput, type UpdateWhatsAppTemplateReviewStatusResponse, type UploadFilePartInput, type UploadFilePartResponse, type UploadSessionResponse, type User, type UserWithParam, UsersResource, type WabaCategory, type WabaHeaderType, type WabaReviewStatus, type Webhook, type WebhookEvent, WebhooksResource, type WebsiteButton, type WebsiteButtonCreationStatus, WebsiteButtonsResource, type WhatsAppTemplateModerationStatus, eventUtils };