@azysinovacao/kanbn-client

Cliente JS minimalista para a API do Kan.bn — mesma cobertura do servidor MCP, com os gotchas já encapsulados. Zero dependências (usa fetch nativo do Node 18+). Feito para Code blocks do Activepieces e Node.

Uso (Activepieces Code block)

import { createKanbn } from '@azysinovacao/kanbn-client';

export const code = async (inputs) => {
  const kanbn = createKanbn(inputs.token);            // token = variável com a chave (Ips)
  return await kanbn.createCard({
    listPublicId: inputs.listId,
    title: inputs.title,
  });
};

Uso (Node)

const { createKanbn } = require('@azysinovacao/kanbn-client');
const kanbn = createKanbn(process.env.KAN_TOKEN);
const me = await kanbn.whoami();

Gotchas já tratados

• Content-Type: application/json sempre (toggles não dão 415).
• Retry automático em 500 deadlock detected.
• attachFile faz os 3 passos S3 (presign → PUT → confirm); aceita data (Buffer/Uint8Array/string) ou base64. Limite 50 MB.
• getBoard(id, { isTemplate: true }) lê template com ?type=template.

Métodos

whoami, searchWorkspace · listWorkspaces, getWorkspace, createWorkspace, deleteWorkspace · createBoard, listBoards, getBoard, updateBoard, archiveBoard, deleteBoard · createTemplate, listTemplates, instantiateTemplate · createList, updateList, deleteList · createCard, getCard, updateCard, moveCard, deleteCard, duplicateCard, toggleCardLabel, toggleCardMember, addComment, addChecklist, addChecklistItem, getCardActivities · createLabel · attachFile, deleteAttachment · inviteMember, setMemberRole, removeMember, getWorkspaceInviteLink · createWebhook, listWebhooks, updateWebhook, testWebhook, deleteWebhook.

Escotilha: kanbn.raw(method, path, { json, params }) para qualquer endpoint não coberto.

Licença MIT · Azys.