n8n-nodes-zarkchat 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZARK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# n8n-nodes-zarkchat
+
+Nodes do **ZarkChat** para o n8n: CRM, conversas, envio de mensagem no WhatsApp, base de conhecimento e gatilho por webhook assinado.
+
+Dois nodes e duas credenciais:
+
+| Item                     | Para quê                                                           |
+| ------------------------ | ------------------------------------------------------------------ |
+| **ZarkChat**             | 9 resources, 30 operações. Também usável como ferramenta de Agent. |
+| **ZarkChat Trigger**     | Recebe os webhooks de saída, com validação de assinatura HMAC.     |
+| **ZarkChat API**         | Credencial da api-key (`zk_live_...`) e da URL base.               |
+| **ZarkChat Webhook API** | Credencial do segredo HMAC de um webhook.                          |
+
+## Instalação
+
+**No n8n auto-hospedado**, em Settings → Community Nodes → Install, informe:
+
+```
+n8n-nodes-zarkchat
+```
+
+**Para testar antes de publicar**, com o pacote local:
+
+```bash
+cd packages/n8n-nodes-zarkchat
+npm run build
+npm link
+cd ~/.n8n/nodes && npm link n8n-nodes-zarkchat
+```
+
+Reinicie o n8n. Os nodes aparecem buscando por "ZarkChat".
+
+## Credenciais
+
+### ZarkChat API
+
+Crie a chave no painel em **Configurações → API**. Ela aparece uma única vez.
+
+| Campo    | Valor                                      |
+| -------- | ------------------------------------------ |
+| API Key  | `zk_live_...`                              |
+| Base URL | `https://api.zark.chat` (sem barra no fim) |
+
+> **Instalação própria do ZarkChat?** Troque a Base URL pela raiz da sua API, sem o `/v1` no fim (as rotas já o incluem). O padrão aponta para a instância hospedada pela ZARK.
+
+> O botão **Test** chama `GET /v1/conversations/counts`, então a chave precisa do escopo `conversations:read` para o teste passar. Uma chave sem esse escopo pode estar perfeitamente válida e ainda assim falhar no teste.
+
+Escopos por resource:
+
+| Resource                              | Escopo necessário                                      |
+| ------------------------------------- | ------------------------------------------------------ |
+| Agent                                 | `agents:read`                                          |
+| Contact, Label, Lead Source, Pipeline | `contacts:read` / `contacts:write` / `contacts:export` |
+| Conversation                          | `conversations:read`, `messages:read`, `messages:send` |
+| Flow                                  | `flows:trigger`                                        |
+| Knowledge Base                        | `kb:search`                                            |
+| Message                               | `messages:send` / `messages:read`                      |
+
+Dê só o que o workflow usa: se a chave vazar, o estrago fica contido.
+
+### ZarkChat Webhook API
+
+O segredo aparece quando você cria o webhook no painel. Guarde na hora: ele não é exibido de novo.
+
+## Gatilho: o cadastro é manual, e é de propósito
+
+O `ZarkChat Trigger` **não se registra sozinho** no ZarkChat. A rota que cria webhook (`POST /v1/webhooks`) exige login de admin e não aceita api-key, então o node não teria como fazer isso com a credencial que possui. Em vez de falhar de forma confusa na ativação, ele mostra a URL para você colar.
+
+Passo a passo:
+
+1. Adicione o **ZarkChat Trigger** ao workflow e copie a **Production URL**.
+2. No painel do ZarkChat, vá em **WhatsApp → Webhooks**, cole a URL e assine os eventos.
+3. Copie o **secret** exibido na criação e guarde na credencial **ZarkChat Webhook API**.
+4. Marque os mesmos eventos no node.
+5. Use o botão **Testar** do painel para ver o primeiro evento chegando.
+
+**Deixe `Validate Signature` ligado.** Sem isso, qualquer pessoa que descubra a URL do seu webhook injeta evento falso no seu agente. O node valida sobre o corpo cru, exatamente como a API assina.
+
+Evento que chega e não está na lista selecionada é descartado com `200`, e não com erro: responder erro faria o ZarkChat repetir a entrega (30s, 2min, 10min, 30min, 2h) de algo que este fluxo ignora de propósito.
+
+## Limites
+
+**120 requisições por minuto por api-key.** Envios têm um teto extra de 10 por segundo. Toda resposta traz `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`, então dá para se auto-regular sem bater no limite.
+
+Um agente que gasta ~7 chamadas por mensagem sustenta cerca de 17 mensagens por minuto. Se precisar de mais, cachear `Agent: Get Config` corta boa parte das chamadas, porque essa configuração muda raramente.
+
+## Por que só 30 operações, se a API tem 141 rotas
+
+As outras 111 são do painel e exigem login de usuário com papel. Uma api-key receberia `403` em todas elas, sempre. Expor essas rotas aqui só produziria nodes que falham, então a fronteira do pacote é exatamente o que uma chave alcança. Há um teste que quebra o build se alguma operação sair dessa fronteira.
+
+## Dois cuidados que evitam problema real
+
+**Não responda por cima de um atendente.** O ZarkChat pausa o bot quando um humano assume, mas o seu workflow é externo e não sabe disso sozinho. Antes de enviar, use `Conversation: Get` e confira `botEnabled`.
+
+**Silêncio é resposta válida.** Sem base para responder, não responda. Inventar resposta em nome do cliente custa mais caro que demorar.
+
+## Desenvolvimento
+
+```bash
+npm run build        # tsc + copia ícones e .node.json para dist
+npm run type-check
+npm run lint         # eslint-plugin-n8n-nodes-base, as convenções oficiais
+npm test
+```
+
+### Testar num n8n de verdade antes de publicar
+
+```bash
+npm run build
+mkdir -p /tmp/n8n-lab/.n8n/nodes/node_modules
+cp -r . /tmp/n8n-lab/.n8n/nodes/node_modules/n8n-nodes-zarkchat
+rm -rf /tmp/n8n-lab/.n8n/nodes/node_modules/n8n-nodes-zarkchat/node_modules
+
+N8N_USER_FOLDER=/tmp/n8n-lab N8N_PORT=5679 \
+N8N_COMMUNITY_PACKAGES_ENABLED=true npx n8n start
+```
+
+Com `N8N_USER_FOLDER=X`, o n8n cria `X/.n8n/` e procura os nodes em **`X/.n8n/nodes/`**, não em `X/nodes/`. Errar esse caminho faz o n8n subir normalmente e simplesmente ignorar o pacote, sem erro nenhum no log.
+
+### Publicar
+
+```bash
+npm run build
+npm pack --dry-run    # confira que dist, icons, README e LICENSE estão no tarball
+npm login
+npm publish           # publishConfig já força --access public
+```
+
+Depois de publicado, quem usa n8n auto-hospedado instala em **Settings → Community Nodes → Install** digitando `n8n-nodes-zarkchat`.
+
+Em n8n com `EXECUTIONS_MODE=queue`, o pacote precisa estar no editor, no webhook **e nos workers**: um node presente só no editor aparece na tela e falha na execução, porque quem executa é o worker.
+
+Versão: semver. O npm só permite despublicar uma versão nas primeiras 72 horas, então prefira publicar um patch novo a tentar apagar.
+
+## Licença
+
+MIT

package/dist/credentials/ZarkChatApi.credentials.d.ts

@@ -0,0 +1,23 @@
+import type { IAuthenticateGeneric, Icon, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+/**
+ * Credencial do ZarkChat: api-key de tenant (`zk_live_...`), criada no painel
+ * em Configurações → API. A chave pertence a UM tenant e só enxerga dados
+ * dele, então uma credencial por cliente é o padrão.
+ *
+ * `baseUrl` é configurável porque a API pode viver em domínio próprio por
+ * instalação (produção da ZARK é https://api.zark.chat, sem prefixo /api).
+ */
+export declare class ZarkChatApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    /**
+     * Testa contra uma rota de leitura barata que exige apenas
+     * `conversations:read`. Não usa /v1/me: api-key não representa usuário, e a
+     * rota devolveria 403 mesmo com a chave válida.
+     */
+    test: ICredentialTestRequest;
+}

package/dist/credentials/ZarkChatApi.credentials.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZarkChatApi = void 0;
+/**
+ * Credencial do ZarkChat: api-key de tenant (`zk_live_...`), criada no painel
+ * em Configurações → API. A chave pertence a UM tenant e só enxerga dados
+ * dele, então uma credencial por cliente é o padrão.
+ *
+ * `baseUrl` é configurável porque a API pode viver em domínio próprio por
+ * instalação (produção da ZARK é https://api.zark.chat, sem prefixo /api).
+ */
+class ZarkChatApi {
+    constructor() {
+        this.name = 'zarkChatApi';
+        this.displayName = 'ZarkChat API';
+        this.icon = { light: 'file:../icons/zarkchat.svg', dark: 'file:../icons/zarkchat.dark.svg' };
+        this.documentationUrl = 'https://github.com/mayconjordanr/zark-chat/blob/main/docs/api/agentes-n8n.md';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                placeholder: 'zk_live_...',
+                description: 'Chave criada no painel em Configurações, aba API. Aparece uma única vez. Dê apenas os escopos que o workflow usa.',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.zark.chat',
+                required: true,
+                description: 'Raiz da API, sem barra no fim e sem o /v1 (ele é adicionado pelas rotas)',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        /**
+         * Testa contra uma rota de leitura barata que exige apenas
+         * `conversations:read`. Não usa /v1/me: api-key não representa usuário, e a
+         * rota devolveria 403 mesmo com a chave válida.
+         */
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/v1/conversations/counts',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.ZarkChatApi = ZarkChatApi;
+//# sourceMappingURL=ZarkChatApi.credentials.js.map

package/dist/credentials/ZarkChatApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZarkChatApi.credentials.js","sourceRoot":"","sources":["../../credentials/ZarkChatApi.credentials.ts"],"names":[],"mappings":";;;AAQA;;;;;;;GAOG;AACH,MAAa,WAAW;IAAxB;QACC,SAAI,GAAG,aAAa,CAAC;QAErB,gBAAW,GAAG,cAAc,CAAC;QAE7B,SAAI,GAAS,EAAE,KAAK,EAAE,4BAA4B,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC;QAE9F,qBAAgB,GAAG,8EAA8E,CAAC;QAElG,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,aAAa;gBAC1B,WAAW,EACV,mHAAmH;aACpH;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,0EAA0E;aACvF;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,iCAAiC;iBAChD;aACD;SACD,CAAC;QAEF;;;;WAIG;QACH,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,0BAA0B;gBAC/B,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AApDD,kCAoDC"}

package/dist/credentials/ZarkChatWebhookApi.credentials.d.ts

@@ -0,0 +1,16 @@
+import type { Icon, ICredentialType, INodeProperties } from 'n8n-workflow';
+/**
+ * Segredo HMAC de um webhook de saída do ZarkChat, mostrado UMA única vez
+ * quando o webhook é criado no painel (WhatsApp → Webhooks).
+ *
+ * É credencial, e não parâmetro do node, por dois motivos: fica cifrado no
+ * n8n em vez de viajar no JSON do workflow, e o mesmo segredo costuma ser
+ * reusado por vários workflows do mesmo cliente.
+ */
+export declare class ZarkChatWebhookApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/ZarkChatWebhookApi.credentials.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZarkChatWebhookApi = void 0;
+/**
+ * Segredo HMAC de um webhook de saída do ZarkChat, mostrado UMA única vez
+ * quando o webhook é criado no painel (WhatsApp → Webhooks).
+ *
+ * É credencial, e não parâmetro do node, por dois motivos: fica cifrado no
+ * n8n em vez de viajar no JSON do workflow, e o mesmo segredo costuma ser
+ * reusado por vários workflows do mesmo cliente.
+ */
+class ZarkChatWebhookApi {
+    constructor() {
+        this.name = 'zarkChatWebhookApi';
+        this.displayName = 'ZarkChat Webhook API';
+        this.icon = { light: 'file:../icons/zarkchat.svg', dark: 'file:../icons/zarkchat.dark.svg' };
+        this.documentationUrl = 'https://github.com/mayconjordanr/zark-chat/blob/main/docs/api/agentes-n8n.md';
+        this.properties = [
+            {
+                displayName: 'Webhook Secret',
+                name: 'secret',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Segredo exibido na criação do webhook no painel. Valida o cabeçalho X-Zark-Signature; sem ele qualquer um que descubra a URL injeta evento falso.',
+            },
+        ];
+    }
+}
+exports.ZarkChatWebhookApi = ZarkChatWebhookApi;
+//# sourceMappingURL=ZarkChatWebhookApi.credentials.js.map

package/dist/credentials/ZarkChatWebhookApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZarkChatWebhookApi.credentials.js","sourceRoot":"","sources":["../../credentials/ZarkChatWebhookApi.credentials.ts"],"names":[],"mappings":";;;AAEA;;;;;;;GAOG;AACH,MAAa,kBAAkB;IAA/B;QACC,SAAI,GAAG,oBAAoB,CAAC;QAE5B,gBAAW,GAAG,sBAAsB,CAAC;QAErC,SAAI,GAAS,EAAE,KAAK,EAAE,4BAA4B,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC;QAE9F,qBAAgB,GAAG,8EAA8E,CAAC;QAElG,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EACV,mJAAmJ;aACpJ;SACD,CAAC;IACH,CAAC;CAAA;AArBD,gDAqBC"}

package/dist/icons/zarkchat.dark.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="ZarkChat">
+  <title>ZarkChat</title>
+  <!--
+    Marca quadrada derivada do wordmark ZARK (design-system/assets/logo-primary.png):
+    o "Z" angular é o único elemento que continua legível a 16px na barra de
+    nodes do n8n; o wordmark inteiro vira borrão. Cor = var(--brand-500) do
+    design system (#ff8a3d), literal porque SVG de ícone não enxerga token CSS. Variante DARK: brand-400
+    (#ff8a3d), um passo mais claro, para manter contraste no tema escuro do n8n.
+  -->
+  <path
+    fill="#ff8a3d"
+    d="M12 8 H52 V20 L30 44 H52 V56 H12 V44 L34 20 H12 Z"
+  />
+</svg>

package/dist/icons/zarkchat.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="ZarkChat">
+  <title>ZarkChat</title>
+  <!--
+    Marca quadrada derivada do wordmark ZARK (design-system/assets/logo-primary.png):
+    o "Z" angular é o único elemento que continua legível a 16px na barra de
+    nodes do n8n; o wordmark inteiro vira borrão. Cor = var(--brand-500) do
+    design system (#f56f10), literal porque SVG de ícone não enxerga token CSS.
+  -->
+  <path
+    fill="#f56f10"
+    d="M12 8 H52 V20 L30 44 H52 V56 H12 V44 L34 20 H12 Z"
+  />
+</svg>

package/dist/nodes/ZarkChat/ZarkChat.node.d.ts

@@ -0,0 +1,16 @@
+import type { INodeType, INodeTypeDescription } from 'n8n-workflow';
+/**
+ * Node do ZarkChat (estilo declarativo: as chamadas vivem em `routing`, sem
+ * `execute`).
+ *
+ * ESCOPO: expõe exatamente as 30 rotas que uma api-key alcança. As outras 111
+ * da API são do painel (JWT com papel) e responderiam 403 para qualquer chave,
+ * então colocá-las aqui só produziria nodes que falham. A fronteira é o
+ * decorator `@RequiresScope` no backend.
+ *
+ * `usableAsTool` ligado: um Agent do n8n pode chamar estas operações
+ * diretamente como ferramenta.
+ */
+export declare class ZarkChat implements INodeType {
+    description: INodeTypeDescription;
+}

package/dist/nodes/ZarkChat/ZarkChat.node.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZarkChat = void 0;
+const contact_1 = require("./resources/contact");
+const conversation_1 = require("./resources/conversation");
+const message_1 = require("./resources/message");
+const misc_1 = require("./resources/misc");
+/**
+ * Node do ZarkChat (estilo declarativo: as chamadas vivem em `routing`, sem
+ * `execute`).
+ *
+ * ESCOPO: expõe exatamente as 30 rotas que uma api-key alcança. As outras 111
+ * da API são do painel (JWT com papel) e responderiam 403 para qualquer chave,
+ * então colocá-las aqui só produziria nodes que falham. A fronteira é o
+ * decorator `@RequiresScope` no backend.
+ *
+ * `usableAsTool` ligado: um Agent do n8n pode chamar estas operações
+ * diretamente como ferramenta.
+ */
+class ZarkChat {
+    constructor() {
+        this.description = {
+            displayName: 'ZarkChat',
+            name: 'zarkChat',
+            icon: {
+                light: 'file:../../icons/zarkchat.svg',
+                dark: 'file:../../icons/zarkchat.dark.svg',
+            },
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'CRM, conversas, envio de mensagem e base de conhecimento do ZarkChat',
+            defaults: { name: 'ZarkChat' },
+            usableAsTool: true,
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [{ name: 'zarkChatApi', required: true }],
+            requestDefaults: {
+                baseURL: '={{$credentials.baseUrl}}',
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                },
+            },
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        { name: 'Agent', value: 'agent' },
+                        { name: 'Contact', value: 'contact' },
+                        { name: 'Conversation', value: 'conversation' },
+                        { name: 'Flow', value: 'flow' },
+                        { name: 'Knowledge Base', value: 'knowledgeBase' },
+                        { name: 'Label', value: 'label' },
+                        { name: 'Lead Source', value: 'leadSource' },
+                        { name: 'Message', value: 'message' },
+                        { name: 'Pipeline', value: 'pipeline' },
+                    ],
+                    default: 'conversation',
+                },
+                ...misc_1.agentOperations,
+                ...misc_1.agentFields,
+                ...contact_1.contactOperations,
+                ...contact_1.contactFields,
+                ...conversation_1.conversationOperations,
+                ...conversation_1.conversationFields,
+                ...misc_1.flowOperations,
+                ...misc_1.flowFields,
+                ...misc_1.knowledgeBaseOperations,
+                ...misc_1.knowledgeBaseFields,
+                ...misc_1.labelOperations,
+                ...misc_1.leadSourceOperations,
+                ...message_1.messageOperations,
+                ...message_1.messageFields,
+                ...misc_1.pipelineOperations,
+                ...misc_1.pipelineFields,
+            ],
+        };
+    }
+}
+exports.ZarkChat = ZarkChat;
+//# sourceMappingURL=ZarkChat.node.js.map

package/dist/nodes/ZarkChat/ZarkChat.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZarkChat.node.js","sourceRoot":"","sources":["../../../nodes/ZarkChat/ZarkChat.node.ts"],"names":[],"mappings":";;;AACA,iDAAuE;AACvE,2DAAsF;AACtF,iDAAuE;AACvE,2CAW0B;AAE1B;;;;;;;;;;;GAWG;AACH,MAAa,QAAQ;IAArB;QACC,gBAAW,GAAyB;YACnC,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE;gBACL,KAAK,EAAE,+BAA+B;gBACtC,IAAI,EAAE,oCAAoC;aAC1C;YACD,KAAK,EAAE,CAAC,WAAW,CAAC;YACpB,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,8DAA8D;YACxE,WAAW,EAAE,sEAAsE;YACnF,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC9B,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,MAAM,CAAC;YAChB,OAAO,EAAE,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACtD,eAAe,EAAE;gBAChB,OAAO,EAAE,2BAA2B;gBACpC,OAAO,EAAE;oBACR,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;iBAClC;aACD;YACD,UAAU,EAAE;gBACX;oBACC,WAAW,EAAE,UAAU;oBACvB,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,SAAS;oBACf,gBAAgB,EAAE,IAAI;oBACtB,OAAO,EAAE;wBACR,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;wBACjC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;wBACrC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;wBAC/C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;wBAC/B,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,eAAe,EAAE;wBAClD,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;wBACjC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE;wBAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;wBACrC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;qBACvC;oBACD,OAAO,EAAE,cAAc;iBACvB;gBAED,GAAG,sBAAe;gBAClB,GAAG,kBAAW;gBACd,GAAG,2BAAiB;gBACpB,GAAG,uBAAa;gBAChB,GAAG,qCAAsB;gBACzB,GAAG,iCAAkB;gBACrB,GAAG,qBAAc;gBACjB,GAAG,iBAAU;gBACb,GAAG,8BAAuB;gBAC1B,GAAG,0BAAmB;gBACtB,GAAG,sBAAe;gBAClB,GAAG,2BAAoB;gBACvB,GAAG,2BAAiB;gBACpB,GAAG,uBAAa;gBAChB,GAAG,yBAAkB;gBACrB,GAAG,qBAAc;aACjB;SACD,CAAC;IACH,CAAC;CAAA;AA9DD,4BA8DC"}

package/dist/nodes/ZarkChat/ZarkChat.node.json

@@ -0,0 +1,16 @@
+{
+	"node": "n8n-nodes-zarkchat.zarkChat",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": ["Communication", "Sales"],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://github.com/mayconjordanr/zark-chat/blob/main/docs/api/agentes-n8n.md#1-autenticacao"
+			}
+		],
+		"primaryDocumentation": [
+			{ "url": "https://github.com/mayconjordanr/zark-chat/blob/main/docs/api/agentes-n8n.md" }
+		]
+	}
+}

package/dist/nodes/ZarkChat/resources/contact.d.ts

@@ -0,0 +1,12 @@
+import type { INodeProperties } from 'n8n-workflow';
+/**
+ * Contatos (escopos `contacts:read` / `contacts:write` / `contacts:export`).
+ * 13 operações, todas mapeadas 1:1 nas rotas reais de `contacts.controller.ts`.
+ *
+ * Duas regras da API que a UI aqui respeita, em vez de mascarar:
+ * - `stageId` NÃO entra no update: mudança de estágio é auditada e tem rota
+ *   própria (`Move To Stage`). O PATCH rejeita com 422.
+ * - `Create` exige `numberId` + `waId`; o nome é opcional.
+ */
+export declare const contactOperations: INodeProperties[];
+export declare const contactFields: INodeProperties[];