@omnicoreos/planka-mcp 0.2.0

package/dist/operations/cards.js

@@ -0,0 +1,81 @@
+/**
+ * Card operations for PLANKA API.
+ */
+import { plankaClient } from "../client.js";
+import { parseInput } from "../errors.js";
+import { CardIdSchema, CreateCardSchema, MoveCardSchema, UpdateCardParamsSchema, } from "../schemas/requests.js";
+import { CardResponse, CardIncludedSchema } from "../schemas/responses.js";
+import { getCommentsForCard } from "./comments.js";
+/**
+ * Create a new card in a list.
+ */
+export async function createCard(input) {
+    const validated = parseInput(CreateCardSchema, input);
+    const response = await plankaClient.post(`/api/lists/${validated.listId}/cards`, {
+        name: validated.name,
+        description: validated.description,
+        position: validated.position,
+        type: validated.type, // Required for PLANKA 2.0
+        dueDate: validated.dueDate,
+    });
+    const parsed = CardResponse.parse(response);
+    return parsed.item;
+}
+/**
+ * Get a card by ID with all related entities.
+ */
+export async function getCard(input) {
+    const { cardId } = parseInput(CardIdSchema, input);
+    // PLANKA 2.x doesn't include comments in the card response; fetch them
+    // from their own endpoint alongside. Fall back to `included` (pre-2.x)
+    // if that endpoint fails.
+    const [response, fetchedComments] = await Promise.all([
+        plankaClient.get(`/api/cards/${cardId}`),
+        getCommentsForCard({ cardId }).catch(() => null),
+    ]);
+    const parsed = CardResponse.parse(response);
+    const included = CardIncludedSchema.parse(response.included || {});
+    return {
+        card: parsed.item,
+        taskLists: (included.taskLists || []).sort((a, b) => a.position - b.position),
+        tasks: (included.tasks || []).sort((a, b) => a.position - b.position),
+        comments: fetchedComments ??
+            (included.comments || []).sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()),
+        labels: included.labels || [],
+        cardLabels: included.cardLabels || [],
+        attachments: included.attachments || [],
+    };
+}
+/**
+ * Update a card's properties.
+ */
+export async function updateCard(input) {
+    const { cardId, ...updates } = parseInput(UpdateCardParamsSchema, input);
+    const response = await plankaClient.patch(`/api/cards/${cardId}`, updates);
+    const parsed = CardResponse.parse(response);
+    return parsed.item;
+}
+/**
+ * Move a card to a different list/position.
+ */
+export async function moveCard(input) {
+    const validated = parseInput(MoveCardSchema, input);
+    const updatePayload = {
+        listId: validated.listId,
+        position: validated.position,
+    };
+    if (validated.boardId) {
+        updatePayload.boardId = validated.boardId;
+    }
+    const response = await plankaClient.patch(`/api/cards/${validated.cardId}`, updatePayload);
+    const parsed = CardResponse.parse(response);
+    return parsed.item;
+}
+/**
+ * Delete a card.
+ */
+export async function deleteCard(input) {
+    const { cardId } = parseInput(CardIdSchema, input);
+    await plankaClient.delete(`/api/cards/${cardId}`);
+}
+//# sourceMappingURL=cards.js.map

package/dist/operations/cards.js.map

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

package/dist/operations/comments.d.ts

@@ -0,0 +1,28 @@
+import { Comment } from "../schemas/entities.js";
+import { CardIdInput, CommentIdInput, CreateCommentInput, UpdateCommentParamsInput } from "../schemas/requests.js";
+/**
+ * A comment enriched with its author's display name (when the API
+ * includes the user record).
+ */
+export interface CommentWithAuthor extends Comment {
+    authorName?: string;
+}
+/**
+ * Add a comment to a card.
+ */
+export declare function createComment(input: CreateCommentInput): Promise<Comment>;
+/**
+ * Update a comment's text.
+ */
+export declare function updateComment(input: UpdateCommentParamsInput): Promise<Comment>;
+/**
+ * Delete a comment.
+ */
+export declare function deleteComment(input: CommentIdInput): Promise<void>;
+/**
+ * Get all comments for a card, newest first.
+ * PLANKA 2.x serves comments only from the dedicated endpoint — the card
+ * response's `included` never carries them.
+ */
+export declare function getCommentsForCard(input: CardIdInput): Promise<CommentWithAuthor[]>;
+//# sourceMappingURL=comments.d.ts.map

package/dist/operations/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/operations/comments.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAEL,WAAW,EAEX,cAAc,EAEd,kBAAkB,EAElB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAGhC;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY/E;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmB9B"}

package/dist/operations/comments.js

@@ -0,0 +1,53 @@
+/**
+ * Comment operations for PLANKA API.
+ */
+import { plankaClient } from "../client.js";
+import { parseInput } from "../errors.js";
+import { CardIdSchema, CommentIdSchema, CreateCommentSchema, UpdateCommentParamsSchema, } from "../schemas/requests.js";
+import { CommentResponse, CommentsResponse, CommentsIncludedSchema } from "../schemas/responses.js";
+/**
+ * Add a comment to a card.
+ */
+export async function createComment(input) {
+    const validated = parseInput(CreateCommentSchema, input);
+    const response = await plankaClient.post(`/api/cards/${validated.cardId}/comments`, {
+        text: validated.text,
+    });
+    const parsed = CommentResponse.parse(response);
+    return parsed.item;
+}
+/**
+ * Update a comment's text.
+ */
+export async function updateComment(input) {
+    const { commentId, ...updates } = parseInput(UpdateCommentParamsSchema, input);
+    const response = await plankaClient.patch(`/api/comments/${commentId}`, updates);
+    const parsed = CommentResponse.parse(response);
+    return parsed.item;
+}
+/**
+ * Delete a comment.
+ */
+export async function deleteComment(input) {
+    const { commentId } = parseInput(CommentIdSchema, input);
+    await plankaClient.delete(`/api/comments/${commentId}`);
+}
+/**
+ * Get all comments for a card, newest first.
+ * PLANKA 2.x serves comments only from the dedicated endpoint — the card
+ * response's `included` never carries them.
+ */
+export async function getCommentsForCard(input) {
+    const { cardId } = parseInput(CardIdSchema, input);
+    const response = await plankaClient.get(`/api/cards/${cardId}/comments`);
+    const parsed = CommentsResponse.parse(response);
+    const included = CommentsIncludedSchema.parse(response.included || {});
+    const users = included.users || [];
+    return parsed.items
+        .map((c) => ({
+        ...c,
+        authorName: users.find((u) => u.id === c.userId)?.name,
+    }))
+        .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+}
+//# sourceMappingURL=comments.js.map

package/dist/operations/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/operations/comments.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EACL,YAAY,EAEZ,eAAe,EAEf,mBAAmB,EAEnB,yBAAyB,GAE1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAUpG;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,MAAM,SAAS,GAAG,UAAU,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CACtC,cAAc,SAAS,CAAC,MAAM,WAAW,EACzC;QACE,IAAI,EAAE,SAAS,CAAC,IAAI;KACrB,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA+B;IAE/B,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAE/E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CACvC,iBAAiB,SAAS,EAAE,EAC5B,OAAO,CACR,CAAC;IAEF,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAqB;IACvD,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,YAAY,CAAC,MAAM,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAkB;IAElB,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CACrC,cAAc,MAAM,WAAW,CAChC,CAAC;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAC1C,QAAoC,CAAC,QAAQ,IAAI,EAAE,CACrD,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IAEnC,OAAO,MAAM,CAAC,KAAK;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,GAAG,CAAC;QACJ,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI;KACvD,CAAC,CAAC;SACF,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAC5E,CAAC;AACN,CAAC"}

package/dist/operations/labels.d.ts

@@ -0,0 +1,60 @@
+import { Label, CardLabel } from "../schemas/entities.js";
+import { AddLabelToCardInput, CreateLabelInput, LabelIdInput, RemoveLabelFromCardInput, SetCardLabelsInput, UpdateLabelParamsInput } from "../schemas/requests.js";
+/**
+ * Create a new label on a board.
+ */
+export declare function createLabel(input: CreateLabelInput): Promise<Label>;
+/**
+ * Update a label's properties.
+ */
+export declare function updateLabel(input: UpdateLabelParamsInput): Promise<Label>;
+/**
+ * Delete a label.
+ */
+export declare function deleteLabel(input: LabelIdInput): Promise<void>;
+/**
+ * Add a label to a card.
+ * Uses PLANKA 2.0 /card-labels endpoint.
+ */
+export declare function addLabelToCard(input: AddLabelToCardInput): Promise<CardLabel>;
+/**
+ * Remove a label from a card.
+ * Uses PLANKA 2.0 /card-labels endpoint.
+ *
+ * The path segment is PLANKA's criteria syntax — `labelId:<id>`, NOT the
+ * junction record's own id. Deleting by cardLabelId answers 404 on 2.x and the
+ * label silently stays on the card. Verified against PLANKA 2.x on 2026-08-02.
+ */
+export declare function removeLabelFromCard(input: RemoveLabelFromCardInput): Promise<void>;
+/**
+ * Outcome of setCardLabels, verified against the card's real state.
+ *
+ * Reporting the requested counts is not good enough: if a labelId does not
+ * exist on the board, PLANKA answers 404 and the label silently never lands.
+ * Callers need to know what is actually on the card, not what was asked for.
+ */
+export interface SetCardLabelsResult {
+    /** Labels this call put on the card. */
+    added: string[];
+    /** Labels asked for that were already there. */
+    alreadyPresent: string[];
+    /** Labels this call took off the card. */
+    removed: string[];
+    /** Labels asked to be removed that were not on the card. */
+    notPresent: string[];
+    /** Labels asked for that are still NOT on the card — these are failures. */
+    failed: Array<{
+        labelId: string;
+        reason: string;
+    }>;
+    /** Every label on the card once the operation finished. */
+    finalLabelIds: string[];
+}
+/**
+ * Set labels on a card (add some, remove others).
+ *
+ * Re-reads the card afterwards so the result reflects reality rather than the
+ * request. Never reports success for a label that did not land.
+ */
+export declare function setCardLabels(input: SetCardLabelsInput): Promise<SetCardLabelsResult>;
+//# sourceMappingURL=labels.d.ts.map

package/dist/operations/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/operations/labels.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEL,mBAAmB,EAEnB,gBAAgB,EAEhB,YAAY,EAEZ,wBAAwB,EAExB,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAIhC;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAgBzE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,KAAK,CAAC,CAUhB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAYnF;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,4EAA4E;IAC5E,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,2DAA2D;IAC3D,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAwF9B"}

package/dist/operations/labels.js

@@ -0,0 +1,146 @@
+/**
+ * Label operations for PLANKA API.
+ */
+import { plankaClient } from "../client.js";
+import { withBoardId } from "./board-id.js";
+import { parseInput } from "../errors.js";
+import { AddLabelToCardSchema, CreateLabelSchema, LabelIdSchema, RemoveLabelFromCardSchema, SetCardLabelsSchema, UpdateLabelParamsSchema, } from "../schemas/requests.js";
+import { LabelResponse, CardLabelResponse } from "../schemas/responses.js";
+import { getCard } from "./cards.js";
+/**
+ * Create a new label on a board.
+ */
+export async function createLabel(input) {
+    const validated = parseInput(CreateLabelSchema, input);
+    return withBoardId(validated.boardId, async (boardId) => {
+        const response = await plankaClient.post(`/api/boards/${boardId}/labels`, {
+            name: validated.name,
+            color: validated.color,
+            position: validated.position,
+        });
+        const parsed = LabelResponse.parse(response);
+        return parsed.item;
+    });
+}
+/**
+ * Update a label's properties.
+ */
+export async function updateLabel(input) {
+    const { labelId, ...updates } = parseInput(UpdateLabelParamsSchema, input);
+    const response = await plankaClient.patch(`/api/labels/${labelId}`, updates);
+    const parsed = LabelResponse.parse(response);
+    return parsed.item;
+}
+/**
+ * Delete a label.
+ */
+export async function deleteLabel(input) {
+    const { labelId } = parseInput(LabelIdSchema, input);
+    await plankaClient.delete(`/api/labels/${labelId}`);
+}
+/**
+ * Add a label to a card.
+ * Uses PLANKA 2.0 /card-labels endpoint.
+ */
+export async function addLabelToCard(input) {
+    const validated = parseInput(AddLabelToCardSchema, input);
+    const response = await plankaClient.post(`/api/cards/${validated.cardId}/card-labels`, {
+        labelId: validated.labelId,
+    });
+    const parsed = CardLabelResponse.parse(response);
+    return parsed.item;
+}
+/**
+ * Remove a label from a card.
+ * Uses PLANKA 2.0 /card-labels endpoint.
+ *
+ * The path segment is PLANKA's criteria syntax — `labelId:<id>`, NOT the
+ * junction record's own id. Deleting by cardLabelId answers 404 on 2.x and the
+ * label silently stays on the card. Verified against PLANKA 2.x on 2026-08-02.
+ */
+export async function removeLabelFromCard(input) {
+    const { cardId, labelId } = parseInput(RemoveLabelFromCardSchema, input);
+    await plankaClient.delete(`/api/cards/${cardId}/card-labels/labelId:${labelId}`);
+}
+/**
+ * Set labels on a card (add some, remove others).
+ *
+ * Re-reads the card afterwards so the result reflects reality rather than the
+ * request. Never reports success for a label that did not land.
+ */
+export async function setCardLabels(input) {
+    const { cardId, addLabelIds, removeLabelIds } = parseInput(SetCardLabelsSchema, input);
+    const toAdd = addLabelIds ?? [];
+    const toRemove = removeLabelIds ?? [];
+    const before = await getCard({ cardId });
+    const presentBefore = new Set(before.cardLabels.map((cl) => cl.labelId));
+    const result = {
+        added: [],
+        alreadyPresent: [],
+        removed: [],
+        notPresent: [],
+        failed: [],
+        finalLabelIds: [],
+    };
+    // Remove first, so a caller can swap a label for another in one call.
+    for (const labelId of toRemove) {
+        if (!presentBefore.has(labelId)) {
+            result.notPresent.push(labelId);
+            continue;
+        }
+        try {
+            await removeLabelFromCard({ cardId, labelId });
+        }
+        catch (error) {
+            result.failed.push({
+                labelId,
+                reason: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    for (const labelId of toAdd) {
+        if (presentBefore.has(labelId)) {
+            result.alreadyPresent.push(labelId);
+            continue;
+        }
+        try {
+            await addLabelToCard({ cardId, labelId });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            // "already on card" is not a failure — the desired state holds.
+            if (message.toLowerCase().includes("already")) {
+                result.alreadyPresent.push(labelId);
+                continue;
+            }
+            result.failed.push({ labelId, reason: message });
+        }
+    }
+    // Verify against the card itself: this is what makes the report trustworthy.
+    const after = await getCard({ cardId });
+    const presentAfter = new Set(after.cardLabels.map((cl) => cl.labelId));
+    result.finalLabelIds = [...presentAfter];
+    result.added = toAdd.filter((id) => presentAfter.has(id) && !presentBefore.has(id));
+    result.removed = toRemove.filter((id) => presentBefore.has(id) && !presentAfter.has(id));
+    // Anything requested that is still missing (or still there) is a failure,
+    // even if the HTTP call did not throw.
+    const known = new Set(result.failed.map((f) => f.labelId));
+    for (const id of toAdd) {
+        if (!presentAfter.has(id) && !known.has(id)) {
+            result.failed.push({
+                labelId: id,
+                reason: "the label is still not on the card — check that this labelId belongs to the card's board",
+            });
+        }
+    }
+    for (const id of toRemove) {
+        if (presentAfter.has(id) && !known.has(id)) {
+            result.failed.push({
+                labelId: id,
+                reason: "the label is still on the card",
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=labels.js.map

package/dist/operations/labels.js.map

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

package/dist/operations/lists.d.ts

@@ -0,0 +1,15 @@
+import { List } from "../schemas/entities.js";
+import { CreateListInput, ListIdInput, UpdateListParamsInput } from "../schemas/requests.js";
+/**
+ * Create a new list on a board.
+ */
+export declare function createList(input: CreateListInput): Promise<List>;
+/**
+ * Update a list's properties.
+ */
+export declare function updateList(input: UpdateListParamsInput): Promise<List>;
+/**
+ * Delete a list.
+ */
+export declare function deleteList(input: ListIdInput): Promise<void>;
+//# sourceMappingURL=lists.d.ts.map

package/dist/operations/lists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/operations/lists.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,OAAO,EAEL,eAAe,EAEf,WAAW,EAEX,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE"}

package/dist/operations/lists.js

@@ -0,0 +1,40 @@
+/**
+ * List operations for PLANKA API.
+ */
+import { plankaClient } from "../client.js";
+import { withBoardId } from "./board-id.js";
+import { parseInput } from "../errors.js";
+import { ListResponse } from "../schemas/responses.js";
+import { CreateListSchema, ListIdSchema, UpdateListParamsSchema, } from "../schemas/requests.js";
+/**
+ * Create a new list on a board.
+ */
+export async function createList(input) {
+    const validated = parseInput(CreateListSchema, input);
+    return withBoardId(validated.boardId, async (boardId) => {
+        const response = await plankaClient.post(`/api/boards/${boardId}/lists`, {
+            name: validated.name,
+            position: validated.position,
+            type: validated.type, // Required by PLANKA 2.0; defaults to "active"
+        });
+        const parsed = ListResponse.parse(response);
+        return parsed.item;
+    });
+}
+/**
+ * Update a list's properties.
+ */
+export async function updateList(input) {
+    const { listId, ...updates } = parseInput(UpdateListParamsSchema, input);
+    const response = await plankaClient.patch(`/api/lists/${listId}`, updates);
+    const parsed = ListResponse.parse(response);
+    return parsed.item;
+}
+/**
+ * Delete a list.
+ */
+export async function deleteList(input) {
+    const { listId } = parseInput(ListIdSchema, input);
+    await plankaClient.delete(`/api/lists/${listId}`);
+}
+//# sourceMappingURL=lists.js.map

package/dist/operations/lists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lists.js","sourceRoot":"","sources":["../../src/operations/lists.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,gBAAgB,EAEhB,YAAY,EAEZ,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,MAAM,SAAS,GAAG,UAAU,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAEtD,OAAO,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACtD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CACtC,eAAe,OAAO,QAAQ,EAC9B;YACE,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,+CAA+C;SACtE,CACF,CAAC;QAEF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAA4B;IAE5B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CACvC,cAAc,MAAM,EAAE,EACtB,OAAO,CACR,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAkB;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,YAAY,CAAC,MAAM,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/operations/projects.d.ts

@@ -0,0 +1,24 @@
+import { Project, Board, List } from "../schemas/entities.js";
+import { GetStructureInput } from "../schemas/requests.js";
+/**
+ * Full project structure with boards and lists.
+ */
+export interface ProjectStructure {
+    project: Project;
+    boards: Array<{
+        board: Board;
+        lists: List[];
+    }>;
+}
+/**
+ * Get all projects with their boards.
+ */
+export declare function getProjects(): Promise<{
+    projects: Project[];
+    boards: Board[];
+}>;
+/**
+ * Get the full structure: projects -> boards -> lists.
+ */
+export declare function getStructure(input?: GetStructureInput): Promise<ProjectStructure[]>;
+//# sourceMappingURL=projects.d.ts.map

package/dist/operations/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/operations/projects.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,IAAI,EAAE,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAC3C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB,CAAC,CAWD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,GAAE,iBAAsB,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkD7B"}

package/dist/operations/projects.js

@@ -0,0 +1,61 @@
+/**
+ * Project operations for PLANKA API.
+ */
+import { plankaClient } from "../client.js";
+import { parseInput } from "../errors.js";
+import { ProjectsResponse, ProjectsIncludedSchema } from "../schemas/responses.js";
+import { GetStructureSchema } from "../schemas/requests.js";
+import { z } from "zod";
+/**
+ * Get all projects with their boards.
+ */
+export async function getProjects() {
+    const response = await plankaClient.get("/api/projects");
+    const parsed = ProjectsResponse.parse(response);
+    const included = ProjectsIncludedSchema.parse(response.included || {});
+    return {
+        projects: parsed.items,
+        boards: included.boards || [],
+    };
+}
+/**
+ * Get the full structure: projects -> boards -> lists.
+ */
+export async function getStructure(input = {}) {
+    const { projectId } = parseInput(GetStructureSchema, input);
+    const { projects, boards } = await getProjects();
+    // Filter to specific project if requested
+    const targetProjects = projectId
+        ? projects.filter((p) => p.id === projectId)
+        : projects;
+    const structures = [];
+    for (const project of targetProjects) {
+        const projectBoards = boards.filter((b) => b.projectId === project.id);
+        const boardsWithLists = [];
+        for (const board of projectBoards) {
+            // Get board details to get lists
+            const boardResponse = await plankaClient.get(`/api/boards/${board.id}`);
+            const included = boardResponse.included;
+            const lists = included?.lists
+                ? z.array(z.object({
+                    id: z.string(),
+                    boardId: z.string(),
+                    name: z.string().nullable(),
+                    position: z.number().nullable(),
+                    createdAt: z.string(),
+                    updatedAt: z.string().nullable().optional(),
+                })).parse(included.lists)
+                : [];
+            boardsWithLists.push({
+                board,
+                lists: lists.sort((a, b) => (a.position ?? 0) - (b.position ?? 0)),
+            });
+        }
+        structures.push({
+            project,
+            boards: boardsWithLists.sort((a, b) => a.board.position - b.board.position),
+        });
+    }
+    return structures;
+}
+//# sourceMappingURL=projects.js.map

package/dist/operations/projects.js.map

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

package/dist/operations/tasks.d.ts

@@ -0,0 +1,30 @@
+import { Task, TaskList } from "../schemas/entities.js";
+import { BatchCreateTasksInput, CreateTaskListInput, CreateTaskInput, TaskIdInput, TaskListIdInput, UpdateTaskParamsInput } from "../schemas/requests.js";
+/**
+ * Create a task-list on a card.
+ */
+export declare function createTaskList(input: CreateTaskListInput): Promise<TaskList>;
+/**
+ * Create a single task on a card.
+ * Automatically creates a default task-list if the card doesn't have one.
+ */
+export declare function createTask(input: CreateTaskInput): Promise<Task>;
+/**
+ * Create multiple tasks on a card.
+ * Tasks are created in order with automatically calculated positions.
+ * Automatically creates a default task-list if the card doesn't have one.
+ */
+export declare function createTasks(input: BatchCreateTasksInput): Promise<Task[]>;
+/**
+ * Update a task's properties.
+ */
+export declare function updateTask(input: UpdateTaskParamsInput): Promise<Task>;
+/**
+ * Delete a task.
+ */
+export declare function deleteTask(input: TaskIdInput): Promise<void>;
+/**
+ * Delete a task-list and all its tasks.
+ */
+export declare function deleteTaskList(input: TaskListIdInput): Promise<void>;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/operations/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/operations/tasks.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAEL,qBAAqB,EAGrB,mBAAmB,EAEnB,eAAe,EAEf,WAAW,EAEX,eAAe,EAEf,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAqChC;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAanB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CA0B/E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E"}