@azysinovacao/piece-kanbn 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare const kanbnAuth: import("@activepieces/pieces-framework").SecretTextProperty<true>;
+export declare const kanbn: import("@activepieces/pieces-framework").Piece<import("@activepieces/pieces-framework").SecretTextProperty<true>>;

package/dist/index.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kanbn = exports.kanbnAuth = void 0;
+const pieces_common_1 = require("@activepieces/pieces-common");
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const shared_1 = require("@activepieces/shared");
+const create_card_1 = require("./lib/actions/create-card");
+const move_card_1 = require("./lib/actions/move-card");
+const create_board_1 = require("./lib/actions/create-board");
+const card_events_1 = require("./lib/triggers/card-events");
+// Auth: API key do Kan.bn (SecretText) -> context.auth é string.
+// Exportada para actions/triggers importarem via `import { kanbnAuth } from '../../'`.
+exports.kanbnAuth = pieces_framework_1.PieceAuth.SecretText({
+    displayName: 'API Key',
+    required: true,
+    description: 'Chave da API do Kan.bn (gere em https://kan.bn/settings). Use a chave do usuário de automação para rastreabilidade.',
+});
+exports.kanbn = (0, pieces_framework_1.createPiece)({
+    displayName: 'Kan.bn',
+    description: 'Quadros Kanban open source (alternativa ao Trello): boards, listas, cards, labels, anexos e webhooks.',
+    logoUrl: 'https://kan.bn/logo.png', // TODO: confirmar URL pública do logo
+    minimumSupportedRelease: '0.36.1',
+    categories: [shared_1.PieceCategory.PRODUCTIVITY],
+    authors: ['azysinovacao'],
+    auth: exports.kanbnAuth,
+    actions: [
+        create_card_1.createCard,
+        move_card_1.moveCard,
+        create_board_1.createBoard,
+        // Fallback HTTP genérico p/ qualquer endpoint não coberto pelas actions:
+        (0, pieces_common_1.createCustomApiCallAction)({
+            baseUrl: () => 'https://kan.bn/api/v1',
+            auth: exports.kanbnAuth,
+            authMapping: async (auth) => ({ Authorization: `Bearer ${auth}` }),
+        }),
+    ],
+    triggers: [card_events_1.cardEvents],
+});

package/dist/lib/actions/create-board.d.ts

@@ -0,0 +1,6 @@
+export declare const createBoard: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    workspaceId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    name: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    lists: import("@activepieces/pieces-framework").ArrayProperty<false>;
+    labels: import("@activepieces/pieces-framework").ArrayProperty<false>;
+}>;

package/dist/lib/actions/create-board.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBoard = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const __1 = require("../../");
+const client_1 = require("../common/client");
+const props_1 = require("../common/props");
+exports.createBoard = (0, pieces_framework_1.createAction)({
+    name: 'create_board', // permanente
+    auth: __1.kanbnAuth,
+    displayName: 'Criar Board',
+    description: 'Cria um board no workspace, com colunas e labels iniciais.',
+    props: {
+        workspaceId: props_1.workspaceId,
+        name: pieces_framework_1.Property.ShortText({ displayName: 'Nome do board', required: true }),
+        lists: pieces_framework_1.Property.Array({
+            displayName: 'Colunas',
+            description: 'Nomes das colunas iniciais (ex.: A Fazer, Fazendo, Feito).',
+            required: false,
+        }),
+        labels: pieces_framework_1.Property.Array({
+            displayName: 'Labels',
+            description: 'Nomes das labels iniciais (ex.: Urgente).',
+            required: false,
+        }),
+    },
+    async run(context) {
+        const kanbn = (0, client_1.makeKanbn)(context.auth);
+        const { workspaceId, name, lists, labels } = context.propsValue;
+        return await kanbn.createBoard(workspaceId, {
+            name,
+            lists: lists ?? [],
+            labels: labels ?? [],
+        });
+    },
+});

package/dist/lib/actions/create-card.d.ts

@@ -0,0 +1,8 @@
+export declare const createCard: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    workspaceId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    boardId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    listId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    title: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    description: import("@activepieces/pieces-framework").LongTextProperty<false>;
+    dueDate: import("@activepieces/pieces-framework").DateTimeProperty<false>;
+}>;

package/dist/lib/actions/create-card.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCard = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const __1 = require("../../");
+const client_1 = require("../common/client");
+const props_1 = require("../common/props");
+exports.createCard = (0, pieces_framework_1.createAction)({
+    name: 'create_card', // permanente — não renomear após publicar
+    auth: __1.kanbnAuth,
+    displayName: 'Criar Card',
+    description: 'Cria um card numa coluna do board.',
+    props: {
+        workspaceId: props_1.workspaceId, // dirige os dropdowns encadeados
+        boardId: // dirige os dropdowns encadeados
+        props_1.boardId,
+        listId: props_1.listId,
+        title: pieces_framework_1.Property.ShortText({ displayName: 'Título', required: true }),
+        description: pieces_framework_1.Property.LongText({ displayName: 'Descrição', required: false }),
+        dueDate: pieces_framework_1.Property.DateTime({ displayName: 'Data de vencimento', required: false }),
+    },
+    async run(context) {
+        const kanbn = (0, client_1.makeKanbn)(context.auth);
+        const { listId, title, description, dueDate } = context.propsValue;
+        return await kanbn.createCard({
+            listPublicId: listId,
+            title,
+            description: description ?? '',
+            dueDate: dueDate ?? null,
+        });
+    },
+});

package/dist/lib/actions/move-card.d.ts

@@ -0,0 +1,6 @@
+export declare const moveCard: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    workspaceId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    boardId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    cardId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    listId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+}>;

package/dist/lib/actions/move-card.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moveCard = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const __1 = require("../../");
+const client_1 = require("../common/client");
+const props_1 = require("../common/props");
+exports.moveCard = (0, pieces_framework_1.createAction)({
+    name: 'move_card', // permanente
+    auth: __1.kanbnAuth,
+    displayName: 'Mover Card',
+    description: 'Move um card para outra coluna (dispara o webhook card.moved).',
+    props: {
+        workspaceId: props_1.workspaceId,
+        boardId: props_1.boardId,
+        cardId: props_1.cardId,
+        listId: props_1.listId, // coluna de destino
+    },
+    async run(context) {
+        const kanbn = (0, client_1.makeKanbn)(context.auth);
+        const { cardId, listId } = context.propsValue;
+        return await kanbn.moveCard(cardId, listId);
+    },
+});

package/dist/lib/common/client.d.ts

@@ -0,0 +1 @@
+export declare const makeKanbn: (auth: string) => any;

package/dist/lib/common/client.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeKanbn = void 0;
+const kanbn_client_1 = require("@azysinovacao/kanbn-client");
+// Ponte: a Piece NÃO reimplementa a API — só instancia a lib compartilhada.
+// `auth` é o SecretText (string) = chave do usuário de automação (Ips).
+const makeKanbn = (auth) => (0, kanbn_client_1.createKanbn)(auth);
+exports.makeKanbn = makeKanbn;

package/dist/lib/common/props.d.ts

@@ -0,0 +1,4 @@
+export declare const workspaceId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+export declare const boardId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+export declare const listId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+export declare const cardId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;

package/dist/lib/common/props.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cardId = exports.listId = exports.boardId = exports.workspaceId = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const __1 = require("../../");
+const client_1 = require("./client");
+// Dropdowns dinâmicos encadeados — UX correta (o usuário escolhe por NOME, nunca digita ID).
+// Cada um usa a lib compartilhada para buscar as opções.
+exports.workspaceId = pieces_framework_1.Property.Dropdown({
+    displayName: 'Workspace',
+    description: 'Workspace do Kan.bn',
+    required: true,
+    auth: __1.kanbnAuth, // se o TS reclamar deste campo, remova-o (refreshers:['auth'] basta)
+    refreshers: ['auth'],
+    options: async ({ auth }) => {
+        if (!auth)
+            return { disabled: true, options: [], placeholder: 'Conecte sua conta primeiro' };
+        const kanbn = (0, client_1.makeKanbn)(auth);
+        const ws = await kanbn.listWorkspaces();
+        return {
+            options: ws.map((w) => ({ label: w.workspace.name, value: w.workspace.publicId })),
+        };
+    },
+});
+exports.boardId = pieces_framework_1.Property.Dropdown({
+    displayName: 'Board',
+    required: true,
+    auth: __1.kanbnAuth,
+    refreshers: ['auth', 'workspaceId'],
+    options: async ({ auth, workspaceId }) => {
+        if (!auth || !workspaceId)
+            return { disabled: true, options: [], placeholder: 'Selecione o workspace' };
+        const kanbn = (0, client_1.makeKanbn)(auth);
+        const boards = await kanbn.listBoards(workspaceId);
+        return { options: boards.map((b) => ({ label: b.name, value: b.publicId })) };
+    },
+});
+exports.listId = pieces_framework_1.Property.Dropdown({
+    displayName: 'Coluna (lista)',
+    required: true,
+    auth: __1.kanbnAuth,
+    refreshers: ['auth', 'boardId'],
+    options: async ({ auth, boardId }) => {
+        if (!auth || !boardId)
+            return { disabled: true, options: [], placeholder: 'Selecione o board' };
+        const kanbn = (0, client_1.makeKanbn)(auth);
+        const board = await kanbn.getBoard(boardId);
+        return { options: (board.lists || []).map((l) => ({ label: l.name, value: l.publicId })) };
+    },
+});
+exports.cardId = pieces_framework_1.Property.Dropdown({
+    displayName: 'Card',
+    required: true,
+    auth: __1.kanbnAuth,
+    refreshers: ['auth', 'boardId'],
+    options: async ({ auth, boardId }) => {
+        if (!auth || !boardId)
+            return { disabled: true, options: [], placeholder: 'Selecione o board' };
+        const kanbn = (0, client_1.makeKanbn)(auth);
+        const board = await kanbn.getBoard(boardId);
+        const cards = (board.lists || []).flatMap((l) => (l.cards || []).map((c) => ({ label: `${l.name}: ${c.title}`, value: c.publicId })));
+        return { options: cards };
+    },
+});

package/dist/lib/triggers/card-events.d.ts

@@ -0,0 +1,14 @@
+import { TriggerStrategy } from '@activepieces/pieces-framework';
+export declare const cardEvents: import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.WEBHOOK, import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    workspaceId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    events: import("@activepieces/pieces-framework").StaticMultiSelectDropdownProperty<string, true>;
+}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.POLLING, import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    workspaceId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    events: import("@activepieces/pieces-framework").StaticMultiSelectDropdownProperty<string, true>;
+}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.MANUAL, import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    workspaceId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    events: import("@activepieces/pieces-framework").StaticMultiSelectDropdownProperty<string, true>;
+}> | import("@activepieces/pieces-framework").ITrigger<TriggerStrategy.APP_WEBHOOK, import("@activepieces/pieces-framework").SecretTextProperty<true>, {
+    workspaceId: import("@activepieces/pieces-framework").DropdownProperty<unknown, true, import("@activepieces/pieces-framework").SecretTextProperty<true>>;
+    events: import("@activepieces/pieces-framework").StaticMultiSelectDropdownProperty<string, true>;
+}>;

package/dist/lib/triggers/card-events.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cardEvents = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const __1 = require("../../");
+const client_1 = require("../common/client");
+const props_1 = require("../common/props");
+// Trigger WEBHOOK (a API do Kan.bn suporta webhooks nativos de card).
+// onEnable registra o webhook via lib apontando para context.webhookUrl;
+// onDisable remove. O payload real foi capturado em teste (sampleData abaixo).
+exports.cardEvents = (0, pieces_framework_1.createTrigger)({
+    auth: __1.kanbnAuth,
+    name: 'card_events', // permanente
+    displayName: 'Evento de Card',
+    description: 'Dispara quando um card é criado, atualizado, movido ou deletado.',
+    type: pieces_framework_1.TriggerStrategy.WEBHOOK,
+    props: {
+        workspaceId: props_1.workspaceId,
+        events: pieces_framework_1.Property.StaticMultiSelectDropdown({
+            displayName: 'Eventos',
+            required: true,
+            defaultValue: ['card.created', 'card.updated', 'card.moved', 'card.deleted'],
+            options: {
+                options: [
+                    { label: 'Card criado', value: 'card.created' },
+                    { label: 'Card atualizado', value: 'card.updated' },
+                    { label: 'Card movido', value: 'card.moved' },
+                    { label: 'Card deletado', value: 'card.deleted' },
+                ],
+            },
+        }),
+    },
+    sampleData: {
+        event: 'card.moved',
+        timestamp: '2026-06-06T17:04:48.933Z',
+        data: {
+            card: {
+                id: '204957',
+                publicId: '8dc6mnkc7c7b',
+                title: 'Card Webhook',
+                description: 'teste de evento',
+                dueDate: null,
+                listId: 'e8zx58da8hqy',
+                boardId: 'e9thky5yuk4s',
+            },
+            board: { id: 'e9thky5yuk4s', name: 'Processo Comercial' },
+            list: { id: 'e8zx58da8hqy', name: 'Fazendo' },
+            user: { id: '994bd877-...', name: 'Ips' },
+            changes: { listId: { from: 'u78jjteil0s3', to: 'e8zx58da8hqy' } },
+        },
+    },
+    async onEnable(context) {
+        const kanbn = (0, client_1.makeKanbn)(context.auth);
+        const wh = await kanbn.createWebhook(context.propsValue.workspaceId, {
+            name: 'Activepieces',
+            url: context.webhookUrl,
+            events: context.propsValue.events,
+        });
+        await context.store.put('kanbn_webhook_id', wh.publicId);
+    },
+    async onDisable(context) {
+        const id = await context.store.get('kanbn_webhook_id');
+        if (id) {
+            const kanbn = (0, client_1.makeKanbn)(context.auth);
+            await kanbn.deleteWebhook(context.propsValue.workspaceId, id);
+        }
+    },
+    async run(context) {
+        // O Kan.bn entrega 1 evento por requisição.
+        return [context.payload.body];
+    },
+});

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@azysinovacao/piece-kanbn",
+  "version": "0.0.1",
+  "description": "Piece do Activepieces para o Kan.bn — camada fina que reusa @azysinovacao/kanbn-client.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@activepieces/pieces-common": "0.12.3",
+    "@activepieces/pieces-framework": "0.29.1",
+    "@activepieces/shared": "0.86.0",
+    "@azysinovacao/kanbn-client": "^0.1.0",
+    "tslib": "2.6.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}