@lionchat/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LionChat Crm
+
+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,313 @@
+# @lionchat/mcp-server
+
+MCP server que conecta agentes de IA a plataforma LionChat. Expoe mais de 540 ferramentas para gerenciar contatos, conversas, kanban, funis, mensagens, automacoes e muito mais.
+
+## O que e MCP?
+
+MCP (Model Context Protocol) e um protocolo aberto que permite agentes de IA interagirem com servicos externos. Com este servidor, qualquer agente compativel (Claude Code, n8n, agentes customizados) pode executar acoes no LionChat por linguagem natural.
+
+**Sem MCP:** Voce le a documentacao, copia endpoints, configura manualmente.
+**Com MCP:** Voce diz "crie um funil com 4 etapas" e o agente faz tudo.
+
+---
+
+## Inicio Rapido
+
+### 1. Obtenha seu token
+
+1. Faca login no LionChat
+2. Va em **Configuracoes > Perfil**
+3. Copie o **Access Token**
+
+### 2. Descubra seu Account ID
+
+O account_id aparece na URL quando voce esta logado:
+
+```
+app.lionchat.com.br/app/accounts/ACCOUNT_ID/dashboard
+```
+
+### 3. Conecte ao Claude Code
+
+```bash
+claude mcp add lionchat \
+  -e LIONCHAT_API_TOKEN=seu_token \
+  -e LIONCHAT_ACCOUNT_ID=123 \
+  -- npx @lionchat/mcp-server
+```
+
+Pronto. Agora voce pode pedir ao Claude Code para fazer qualquer coisa no LionChat.
+
+### Instalacao alternativa (variaveis de ambiente)
+
+```bash
+export LIONCHAT_API_TOKEN=seu_token
+export LIONCHAT_ACCOUNT_ID=123
+npx @lionchat/mcp-server
+```
+
+### Instancia self-hosted / white-label
+
+```bash
+export LIONCHAT_BASE_URL=https://sua-instancia.com
+npx @lionchat/mcp-server
+```
+
+---
+
+## Configuracao
+
+| Variavel | CLI | Obrigatorio | Padrao |
+|----------|-----|-------------|--------|
+| `LIONCHAT_API_TOKEN` | `--token` | Sim | -- |
+| `LIONCHAT_ACCOUNT_ID` | `--account` | Sim | -- |
+| `LIONCHAT_BASE_URL` | `--base-url` | Nao | `https://app.lionchat.com.br` |
+| `LIONCHAT_CATEGORIES` | `--categories` | Nao | todas |
+| `LIONCHAT_INCLUDE_PUBLIC_API` | `--include-public-api` | Nao | false |
+
+**Prioridade:** argumentos CLI > variaveis de ambiente > valores padrao.
+
+---
+
+## Filtro por Categoria
+
+Para melhor performance do agente, carregue apenas as ferramentas que precisa:
+
+```bash
+npx @lionchat/mcp-server --categories=contacts,conversations,kanban_items
+```
+
+### Perfis Sugeridos
+
+| Perfil | Categorias | Uso |
+|--------|-----------|-----|
+| **Vendas** | `contacts,conversations,messages,kanban_items,funnels,offers` | CRM e automacao de vendas |
+| **Suporte** | `contacts,conversations,messages,canned_responses,teams,labels` | Atendimento ao cliente |
+| **Marketing** | `contacts,automation_rules,labels,scheduled_messages` | Campanhas e automacao |
+| **Completo** | _(sem filtro)_ | Cobertura total da API (541 ferramentas) |
+
+### Categorias Disponiveis
+
+| Slug | Descricao | Tools |
+|------|-----------|-------|
+| `account` | Detalhes da conta | 3 |
+| `agents` | Agentes/operadores | 2 |
+| `agent_availability` | Disponibilidade dos agentes | 4 |
+| `announcements` | Anuncios internos | 4 |
+| `assignment_policies` | Politicas de atribuicao | 11 |
+| `automation_rules` | Regras de automacao | 7 |
+| `booking_event_types` | Tipos de evento (agenda) | 8 |
+| `canned_responses` | Respostas rapidas | 6 |
+| `capacity_policies` | Politicas de capacidade | 11 |
+| `captain_assistants` | Assistentes IA | 33 |
+| `captain_documents` | Base de conhecimento IA | 4 |
+| `contacts` | Contatos | 25 |
+| `conversations` | Conversas | 30 |
+| `copilot_prompts` | Prompts salvos do Copilot | 4 |
+| `csat` | Pesquisas de satisfacao | 3 |
+| `csat_template` | Template CSAT por inbox | 2 |
+| `custom_attributes` | Atributos personalizados | 5 |
+| `custom_filters` | Filtros personalizados | 5 |
+| `custom_roles` | Roles personalizados | 5 |
+| `dashboard_apps` | Apps no dashboard | 5 |
+| `ecommerce_webhooks` | Integracoes e-commerce (Guru, Hotmart, Kiwify, Ticto, Eduzz, Monetizze) | 55 |
+| `flows` | FlowBuilder (automacoes visuais) | 10 |
+| `flow_sessions` | Sessoes do FlowBuilder | 3 |
+| `funnels` | Funis de vendas | 10 |
+| `google_calendar` | Google Calendar | 13 |
+| `inbox_members` | Membros das inboxes | 4 |
+| `inbox_migration` | Migracao entre inboxes | 3 |
+| `inboxes` | Caixas de entrada | 4 |
+| `kanban_agents` | Agentes do Kanban | 3 |
+| `kanban_bulk` | Operacoes em massa (Kanban) | 4 |
+| `kanban_checklist` | Checklist dos cards | 5 |
+| `kanban_config` | Configuracao do Kanban | 5 |
+| `kanban_items` | Cards do Kanban | 21 |
+| `kanban_notes` | Notas dos cards | 4 |
+| `kanban_v2` | Kanban V2 (items, funis, etapas, automacoes) | 25 |
+| `labels` | Labels/etiquetas | 5 |
+| `macros` | Macros | 6 |
+| `messages` | Mensagens | 8 |
+| `meta_lead` | Meta Lead Ads (Facebook/Instagram) | 10 |
+| `notification_settings` | Config de notificacoes | 2 |
+| `notifications` | Notificacoes | 8 |
+| `offers` | Ofertas | 6 |
+| `portals` | Portais e base de conhecimento | 20 |
+| `public_booking` | Agendamento publico | 5 |
+| `public_contacts` | API publica: contatos | 3 |
+| `public_conversations` | API publica: conversas | 5 |
+| `public_csat` | API publica: CSAT | 1 |
+| `public_messages` | API publica: mensagens | 3 |
+| `reports` | Relatorios V2 | 19 |
+| `scheduled_messages` | Mensagens agendadas | 8 |
+| `search` | Busca global | 4 |
+| `sla` | SLA (Service Level Agreement) | 8 |
+| `support_access` | Acesso de suporte | 3 |
+| `tasks` | Agenda / Tarefas | 14 |
+| `teams` | Times | 7 |
+| `upload` | Upload de arquivos | 1 |
+| `voip_calls` | Ligacoes VoIP (Zenvia) | 20 |
+| `waha_groups` | Grupos WhatsApp | 14 |
+| `webhooks` | Webhooks | 4 |
+| `whatsapp_templates` | Templates WhatsApp | 5 |
+| `account_variables` | Variaveis da conta | 4 |
+
+---
+
+## Exemplos de Uso
+
+### No Claude Code
+
+Depois de conectar, basta pedir em linguagem natural:
+
+```
+"Liste meus ultimos 10 contatos"
+→ lionchat_contacts_list
+
+"Crie um funil chamado 'Vendas Q2' com etapas Prospeccao, Qualificacao, Proposta, Fechado"
+→ lionchat_funnels_create
+
+"Mova o card 42 para a etapa 'Proposta'"
+→ lionchat_kanban_items_move_to_stage
+
+"Envie 'Ola!' na conversa 15"
+→ lionchat_conversations_messages_create
+
+"Quais conversas estao abertas no time de suporte?"
+→ lionchat_conversations_list (com filtro por time)
+
+"Crie uma regra de automacao: quando criar conversa com label VIP, atribuir ao time Premium"
+→ lionchat_automation_rules_create
+
+"Qual o saldo do meu VoIP?"
+→ lionchat_voip_calls_balance
+```
+
+### No n8n
+
+O n8n suporta MCP de duas formas:
+
+#### Opcao 1: MCP Client + AI Agent (recomendado para decisoes inteligentes)
+
+1. Adicione um node **"AI Agent"** ao seu workflow (Claude, GPT, ou outro LLM)
+2. Adicione um node **"MCP Client"** como ferramenta do agente
+3. Configure o MCP Client:
+   - **Transport:** stdio
+   - **Command:** `npx`
+   - **Arguments:** `@lionchat/mcp-server`
+   - **Environment Variables:**
+     - `LIONCHAT_API_TOKEN` = seu token
+     - `LIONCHAT_ACCOUNT_ID` = seu account ID
+     - `LIONCHAT_CATEGORIES` = categorias desejadas (opcional)
+4. Conecte o MCP Client ao AI Agent
+5. O agente de IA decide automaticamente quais ferramentas usar
+
+**Exemplo de prompt no AI Agent:**
+> "Analise os contatos criados ontem. Se algum tem empresa no nome, crie um card no funil 'Vendas B2B' na etapa 'Prospeccao'."
+
+O agente vai chamar `lionchat_contacts_list`, analisar os resultados, e chamar `lionchat_kanban_items_create` para cada contato relevante.
+
+#### Opcao 2: HTTP Request (para automacoes fixas)
+
+Para automacoes tipo "se X entao Y" sem necessidade de IA, use o node **HTTP Request** do n8n chamando a API do LionChat diretamente:
+
+- **URL:** `https://app.lionchat.com.br/api/v1/accounts/{account_id}/contacts`
+- **Header:** `api_access_token: seu_token`
+- **Method:** GET, POST, etc.
+
+#### Quando usar cada opcao
+
+| Abordagem | Quando usar |
+|-----------|-------------|
+| **MCP + AI Agent** | O fluxo precisa de decisao inteligente ("analise e decida") |
+| **HTTP Request** | Automacao fixa ("quando receber webhook, criar contato") |
+
+### Em scripts ou agentes customizados
+
+O MCP server funciona com qualquer cliente MCP via transporte stdio. Execute como subprocesso e comunique via stdin/stdout (JSON-RPC).
+
+---
+
+## Ferramentas Meta
+
+Sempre disponiveis, independente do filtro de categorias:
+
+| Ferramenta | Descricao |
+|------------|-----------|
+| `lionchat_ping` | Testa conectividade e valida o token |
+| `lionchat_list_categories` | Lista categorias disponiveis com contagem de ferramentas |
+
+Use `lionchat_ping` para verificar se a conexao esta funcionando antes de executar outras acoes.
+
+---
+
+## API Publica
+
+Os 12 endpoints da API publica (widget, contatos publicos, CSAT) sao **ocultos por padrao** por seguranca. Para habilitar:
+
+```bash
+npx @lionchat/mcp-server --include-public-api
+```
+
+Esses endpoints usam `inbox_identifier` e `contact_identifier` em vez de token. Habilite apenas se seu agente precisa criar contatos ou conversas em nome de usuarios finais.
+
+---
+
+## Upload de Arquivos
+
+Endpoints que requerem upload de arquivo (importacao CSV, avatar, anexos) estao incluidos mas retornam uma mensagem orientando a usar a interface web ou chamadas API diretas. Upload via MCP sera suportado em versoes futuras.
+
+---
+
+## Seguranca
+
+- Token armazenado em variavel de ambiente, nunca logado ou incluido em respostas
+- Transporte stdio -- comunicacao local entre processos, sem porta de rede aberta
+- Stateless -- nada salvo em disco
+- Timeout de 30 segundos por requisicao
+- Retry automatico com backoff exponencial para rate limiting (429)
+- Cada requisicao usa o token do cliente -- permissoes do LionChat sao respeitadas no servidor
+
+**Recomendacao:** Use um token com permissoes minimas para seu caso de uso. Evite tokens de administrador em agentes automatizados.
+
+---
+
+## Requisitos
+
+- Node.js 18 ou superior
+- Conta no LionChat com access token
+
+---
+
+## Desenvolvimento
+
+```bash
+# Clonar o repositorio
+git clone https://github.com/LionChatCRM/lionchat-mcp-server-.git
+cd lionchat-mcp-server-
+
+# Instalar dependencias
+npm install
+
+# Build
+npm run build
+
+# Testar localmente
+LIONCHAT_API_TOKEN=seu_token LIONCHAT_ACCOUNT_ID=123 node dist/index.js
+```
+
+### Atualizar endpoints
+
+Quando a API do LionChat mudar:
+
+1. Atualize o HTML de documentacao da API
+2. Execute `npm run extract -- caminho/para/api-docs.html`
+3. Verifique o `endpoints.json` gerado
+4. Incremente a versao no `package.json`
+5. `npm publish`
+
+---
+
+## Licenca
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,27 @@
+import { Config } from './config.js';
+export interface RequestOptions {
+    method: string;
+    path: string;
+    body?: Record<string, unknown>;
+}
+export interface PaginatedResponse {
+    data: unknown[];
+    pagination?: {
+        current_page: number;
+        total_pages: number;
+        total_count: number;
+        has_more: boolean;
+    };
+}
+export declare class LionChatApiError extends Error {
+    readonly status: number;
+    readonly responseBody: unknown;
+    constructor(message: string, status: number, responseBody?: unknown);
+}
+export declare class LionChatClient {
+    private config;
+    constructor(config: Config);
+    request(options: RequestOptions): Promise<unknown>;
+    private buildUrl;
+    private executeWithRetry;
+}

package/dist/client.js

@@ -0,0 +1,264 @@
+// AIDEV-NOTE: HTTP client for LionChat API
+// Uses native fetch (Node 18+), zero external dependencies
+// Handles auth, retry (429/5xx/network), timeout, and response normalization
+// AIDEV-NOTE: Custom error class with HTTP status for callers to inspect
+export class LionChatApiError extends Error {
+    status;
+    responseBody;
+    constructor(message, status, responseBody) {
+        super(message);
+        this.name = 'LionChatApiError';
+        this.status = status;
+        this.responseBody = responseBody;
+    }
+}
+const TIMEOUT_MS = 30_000;
+const MAX_RETRIES_429 = 3;
+const MAX_RETRIES_5XX = 1;
+const MAX_RETRIES_NETWORK = 1;
+// AIDEV-NOTE: Actionable error messages per HTTP status
+function getErrorMessage(status, body) {
+    switch (status) {
+        case 401:
+            return 'Authentication failed. Check your token at Login > Profile Settings';
+        case 403:
+            return 'Permission denied. Your token may not have access to this resource';
+        case 404:
+            return 'Resource not found. Check the ID and account_id';
+        case 422: {
+            const details = extractValidationDetails(body);
+            return `Validation error: ${details}`;
+        }
+        case 429:
+            return 'Rate limited. Wait and retry';
+        default:
+            if (status >= 500) {
+                return 'LionChat server error. Try again later';
+            }
+            return `HTTP error ${status}`;
+    }
+}
+// AIDEV-NOTE: Extract validation details from 422 response body
+function extractValidationDetails(body) {
+    if (body && typeof body === 'object') {
+        const obj = body;
+        // Chatwoot returns errors in various formats
+        if (obj.message && typeof obj.message === 'string') {
+            return obj.message;
+        }
+        if (obj.error && typeof obj.error === 'string') {
+            return obj.error;
+        }
+        if (obj.errors && Array.isArray(obj.errors)) {
+            return obj.errors.join(', ');
+        }
+        if (obj.errors && typeof obj.errors === 'object') {
+            return JSON.stringify(obj.errors);
+        }
+    }
+    return JSON.stringify(body);
+}
+// AIDEV-NOTE: Check if an error is a network/timeout error worth retrying
+function isNetworkError(err) {
+    if (err instanceof Error) {
+        const msg = err.message.toLowerCase();
+        return (msg.includes('econnrefused') ||
+            msg.includes('econnreset') ||
+            msg.includes('etimedout') ||
+            msg.includes('fetch failed') ||
+            msg.includes('abort') ||
+            err.name === 'AbortError');
+    }
+    return false;
+}
+// AIDEV-NOTE: Sleep utility for retry backoff
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// AIDEV-NOTE: Normalize LionChat API responses to a consistent format
+// - Array with meta/payload pagination -> PaginatedResponse
+// - Plain array -> { data: [...] }
+// - Single object -> returned as-is
+function normalizeResponse(body) {
+    if (body && typeof body === 'object' && !Array.isArray(body)) {
+        const obj = body;
+        // AIDEV-NOTE: Chatwoot pagination format: { payload: [...], meta: { all_count, current_page } }
+        if (Array.isArray(obj.payload) && obj.meta && typeof obj.meta === 'object') {
+            const meta = obj.meta;
+            const allCount = typeof meta.all_count === 'number' ? meta.all_count : 0;
+            const currentPage = typeof meta.current_page === 'number' ? meta.current_page : 1;
+            // AIDEV-NOTE: Chatwoot uses 25 items per page by default. Don't use payload.length
+            // as it's wrong on the last page (e.g. 3 items on last page → wrong totalPages calc)
+            const perPage = 25;
+            const totalPages = perPage > 0 ? Math.ceil(allCount / perPage) : 1;
+            return {
+                data: obj.payload,
+                pagination: {
+                    current_page: currentPage,
+                    total_pages: totalPages,
+                    total_count: allCount,
+                    has_more: currentPage < totalPages,
+                },
+            };
+        }
+        // AIDEV-NOTE: Some endpoints return { data: [...], meta: {...} } format
+        if (Array.isArray(obj.data) && obj.meta && typeof obj.meta === 'object') {
+            const meta = obj.meta;
+            const totalCount = typeof meta.total_count === 'number'
+                ? meta.total_count
+                : typeof meta.all_count === 'number'
+                    ? meta.all_count
+                    : obj.data.length;
+            const currentPage = typeof meta.current_page === 'number' ? meta.current_page : 1;
+            const totalPages = typeof meta.total_pages === 'number'
+                ? meta.total_pages
+                : Math.ceil(totalCount / Math.max(obj.data.length, 1));
+            return {
+                data: obj.data,
+                pagination: {
+                    current_page: currentPage,
+                    total_pages: totalPages,
+                    total_count: totalCount,
+                    has_more: currentPage < totalPages,
+                },
+            };
+        }
+        // AIDEV-NOTE: Single object response — return as-is
+        return body;
+    }
+    // AIDEV-NOTE: Flat array response — wrap in { data: [...] }
+    if (Array.isArray(body)) {
+        return { data: body };
+    }
+    return body;
+}
+export class LionChatClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    // AIDEV-NOTE: Main request method with auth, timeout, retry, and normalization
+    async request(options) {
+        const { method, path, body } = options;
+        // AIDEV-NOTE: Build full URL (query params already embedded in path by tools.ts)
+        const url = this.buildUrl(path);
+        // AIDEV-NOTE: Build headers — api_access_token on all requests
+        const headers = {
+            api_access_token: this.config.apiToken,
+        };
+        const hasBody = body && ['POST', 'PATCH', 'PUT', 'DELETE'].includes(method.toUpperCase());
+        if (hasBody) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const fetchOptions = {
+            method: method.toUpperCase(),
+            headers,
+        };
+        if (hasBody) {
+            fetchOptions.body = JSON.stringify(body);
+        }
+        // AIDEV-NOTE: Execute with retry logic
+        return this.executeWithRetry(url, fetchOptions);
+    }
+    // AIDEV-NOTE: Build URL from base + path (query params already in path string)
+    buildUrl(path) {
+        const base = this.config.baseUrl.replace(/\/+$/, '');
+        const cleanPath = path.startsWith('/') ? path : `/${path}`;
+        return `${base}${cleanPath}`;
+    }
+    // AIDEV-NOTE: Retry logic: 429 (exponential backoff, 3x), 5xx (once, 2s), network (once, 2s)
+    async executeWithRetry(url, fetchOptions) {
+        let lastError;
+        let retries429 = 0;
+        let retries5xx = 0;
+        let retriesNetwork = 0;
+        // AIDEV-NOTE: Max possible attempts = 1 initial + 3 (429) + 1 (5xx) + 1 (network)
+        // In practice, only one retry category applies per request
+        const maxAttempts = 1 + MAX_RETRIES_429 + MAX_RETRIES_5XX + MAX_RETRIES_NETWORK;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                // AIDEV-NOTE: AbortController for 30s timeout
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
+                let response;
+                try {
+                    response = await fetch(url, {
+                        ...fetchOptions,
+                        signal: controller.signal,
+                    });
+                }
+                finally {
+                    clearTimeout(timeoutId);
+                }
+                // AIDEV-NOTE: Parse response body
+                let responseBody;
+                const contentType = response.headers.get('content-type') ?? '';
+                if (contentType.includes('application/json')) {
+                    responseBody = await response.json();
+                }
+                else {
+                    const text = await response.text();
+                    // AIDEV-NOTE: Try parsing as JSON even without content-type header
+                    try {
+                        responseBody = JSON.parse(text);
+                    }
+                    catch {
+                        responseBody = text;
+                    }
+                }
+                // AIDEV-NOTE: Success — normalize and return
+                if (response.ok) {
+                    return normalizeResponse(responseBody);
+                }
+                // AIDEV-NOTE: 429 — exponential backoff with Retry-After header support
+                if (response.status === 429 && retries429 < MAX_RETRIES_429) {
+                    retries429++;
+                    const retryAfter = response.headers.get('Retry-After');
+                    let delayMs;
+                    if (retryAfter) {
+                        const seconds = parseInt(retryAfter, 10);
+                        // AIDEV-NOTE: Retry-After can be seconds (integer) or HTTP-date. parseInt on
+                        // a date string returns NaN, so fall back to exponential backoff.
+                        delayMs = Number.isNaN(seconds) ? 1000 * Math.pow(2, retries429 - 1) : seconds * 1000;
+                    }
+                    else {
+                        delayMs = 1000 * Math.pow(2, retries429 - 1); // 1s, 2s, 4s
+                    }
+                    await sleep(delayMs);
+                    continue;
+                }
+                // AIDEV-NOTE: 5xx — retry once after 2s
+                if (response.status >= 500 && retries5xx < MAX_RETRIES_5XX) {
+                    retries5xx++;
+                    await sleep(2000);
+                    continue;
+                }
+                // AIDEV-NOTE: Non-retryable error — throw with actionable message
+                const message = getErrorMessage(response.status, responseBody);
+                throw new LionChatApiError(message, response.status, responseBody);
+            }
+            catch (err) {
+                // AIDEV-NOTE: Re-throw our own errors (already handled above)
+                if (err instanceof LionChatApiError) {
+                    throw err;
+                }
+                // AIDEV-NOTE: Network/timeout errors — retry once after 2s
+                if (isNetworkError(err) && retriesNetwork < MAX_RETRIES_NETWORK) {
+                    retriesNetwork++;
+                    lastError = err;
+                    await sleep(2000);
+                    continue;
+                }
+                // AIDEV-NOTE: Unrecoverable network error
+                if (isNetworkError(err)) {
+                    throw new LionChatApiError(`Network error: Could not connect to ${this.config.baseUrl}. Check your base URL and network connection.`, 0, undefined);
+                }
+                // AIDEV-NOTE: Unexpected error — rethrow
+                throw err;
+            }
+        }
+        // AIDEV-NOTE: Should not reach here, but safety fallback
+        throw lastError ?? new Error('Request failed after all retries');
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+export interface Config {
+    apiToken: string;
+    accountId: string;
+    baseUrl: string;
+    categories: string[] | null;
+    includePublicApi: boolean;
+}
+export declare function loadConfig(): Config;