@divyacon/piece-trello 0.0.0-stage → 0.1.0

package/src/lib/actions/card/update-card.ts

@@ -0,0 +1,113 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { TrelloCard } from '../../common/props/card';
+import { trelloAuth } from '../../..';
+import { updateCardActionOutputSchema } from '../../output-schemas';
+
+export const updateCard = createAction({
+  auth: trelloAuth,
+  name: 'update_card',
+  displayName: 'Update Card',
+  description: 'Updates an existing card.',
+  audience: 'human',
+  outputSchema: updateCardActionOutputSchema,
+  aiMetadata: { description: 'Updates fields on an existing Trello card identified by card_id, including name, description, due date, labels, position, and archived (closed) state, and can move it to a different list. Use to edit, archive, or relocate a card. Requires card_id; only provided fields change. Repeating with the same inputs converges to the same card state.', idempotent: true },
+  props: {
+    card_id: Property.ShortText({
+      description: 'The ID of the card to update',
+      displayName: 'Card ID',
+      required: true,
+    }),
+    name: Property.ShortText({
+      description: 'The new name of the card',
+      displayName: 'Card Name',
+      required: false,
+    }),
+    description: Property.LongText({
+      description: 'The new description of the card',
+      displayName: 'Card Description',
+      required: false,
+    }),
+    board_id: trelloCommon.board_id_opt,
+    list_id: trelloCommon.list_id_opt,
+    position: Property.StaticDropdown({
+      description: 'Move the card to a new position',
+      displayName: 'Position',
+      required: false,
+      options: {
+        options: [
+          { label: 'Top', value: 'top' },
+          { label: 'Bottom', value: 'bottom' },
+        ],
+      },
+    }),
+    labels: trelloCommon.board_labels,
+    closed: Property.Checkbox({
+      description: 'Archive or unarchive the card',
+      displayName: 'Archived',
+      required: false,
+    }),
+    due: Property.DateTime({
+      description: 'Set a due date for the card',
+      displayName: 'Due Date',
+      required: false,
+    }),
+  },
+
+  async run(context) {
+    const body: any = {};
+    
+    if (context.propsValue['name']) {
+      body.name = context.propsValue['name'];
+    }
+    
+    if (context.propsValue['description']) {
+      body.desc = context.propsValue['description'];
+    }
+    
+    if (context.propsValue['list_id']) {
+      body.idList = context.propsValue['list_id'];
+    }
+    
+    if (context.propsValue['position']) {
+      body.pos = context.propsValue['position'];
+    }
+    
+    if (context.propsValue['labels']) {
+      body.idLabels = context.propsValue['labels'];
+    }
+    
+    if (context.propsValue['closed'] !== undefined) {
+      body.closed = context.propsValue['closed'];
+    }
+    
+    if (context.propsValue['due']) {
+      body.due = context.propsValue['due'];
+    }
+
+    const request: HttpRequest = {
+      method: HttpMethod.PUT,
+      url:
+        `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}` +
+        `?key=` +
+        context.auth.username +
+        `&token=` +
+        context.auth.password,
+      headers: {
+        Accept: 'application/json',
+        'Content-Type': 'application/json',
+      },
+      body,
+      queryParams: {},
+    };
+    
+    const response = await httpClient.sendRequest<TrelloCard>(request);
+
+    return response.body;
+  },
+});

package/src/lib/actions/card-attachment/add-card-attachment.ts

@@ -0,0 +1,86 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+  QueryParams,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import FormData from "form-data";
+import { addCardAttachmentActionOutputSchema } from '../../output-schemas';
+
+export const addCardAttachment = createAction({
+  auth: trelloAuth,
+  name: 'add_card_attachment',
+  displayName: 'Add Card Attachment',
+  description: 'Adds an attachment to a card.',
+  audience: 'both',
+  outputSchema: addCardAttachmentActionOutputSchema,
+  aiMetadata: { description: 'Uploads a file as an attachment to a Trello card identified by card_id, optionally naming it, setting its MIME type, and using it as the card cover. Use to attach documents or images to a card. Requires card_id and the file; each call adds a new attachment, so it is not idempotent.', idempotent: false },
+  props: {
+    card_id: Property.ShortText({
+      description: 'The ID of the card to add attachment to',
+      displayName: 'Card ID',
+      required: true,
+    }),
+    attachment: Property.File({
+      displayName: 'Attachment File',
+      required: true,
+    }),
+    name: Property.ShortText({
+      displayName: 'Attachment Name',
+      required: false,
+    }),
+    mime_type: Property.ShortText({
+      displayName: 'MIME Type',
+      required: false,
+    }),
+    set_cover: Property.Checkbox({
+      description: 'Set this attachment as the card cover',
+      displayName: 'Set as Cover',
+      required: false,
+    }),
+  },
+
+  async run(context) {
+    const attachment = context.propsValue.attachment;
+    const qs:QueryParams = {}
+    
+    const formData = new FormData();
+
+    formData.append('file',attachment.data,{filename:attachment.filename});
+
+    if (context.propsValue['name']) {
+      qs['name'] = context.propsValue['name'];
+    }
+    
+    if (context.propsValue['mime_type']) {
+      qs['mimeType'] = context.propsValue['mime_type'];
+    }
+    
+    if (context.propsValue['set_cover']) {
+      qs['setCover'] = context.propsValue['set_cover'] ?'true':'false';
+    }
+
+    const request: HttpRequest = {
+      method: HttpMethod.POST,
+      url:
+        `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/attachments` +
+        `?key=` +
+        context.auth.username +
+        `&token=` +
+        context.auth.password,
+      headers: {
+        Accept: 'application/json',
+        ...formData.getHeaders()
+      },
+      body:formData,
+      queryParams: qs,
+    };
+    
+    const response = await httpClient.sendRequest(request);
+
+    return response.body;
+  },
+});

package/src/lib/actions/card-attachment/delete-card-attachment.ts

@@ -0,0 +1,49 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+
+export const deleteCardAttachment = createAction({
+  auth: trelloAuth,
+  name: 'delete_card_attachment',
+  displayName: 'Delete Card Attachment',
+  description: 'Deletes an attachment from a card.',
+  audience: 'both',
+  aiMetadata: { description: 'Permanently removes a specific attachment from a Trello card, identified by both card_id and attachment_id. Use to delete a file or link from a card. Requires both ids; deleting the same attachment again returns an error once it no longer exists.', idempotent: false },
+  props: {
+    card_id: Property.ShortText({
+      description: 'The ID of the card',
+      displayName: 'Card ID',
+      required: true,
+    }),
+    attachment_id: Property.ShortText({
+      description: 'The ID of the attachment to delete',
+      displayName: 'Attachment ID',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    const request: HttpRequest = {
+      method: HttpMethod.DELETE,
+      url:
+        `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/attachments/${context.propsValue['attachment_id']}` +
+        `?key=` +
+        context.auth.username +
+        `&token=` +
+        context.auth.password,
+      headers: {
+        Accept: 'application/json',
+      },
+      queryParams: {},
+    };
+    
+    const response = await httpClient.sendRequest(request);
+
+    return response.body;
+  },
+});

package/src/lib/actions/card-attachment/get-card-attachment.ts

@@ -0,0 +1,51 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { getCardAttachmentActionOutputSchema } from '../../output-schemas';
+
+export const getCardAttachment = createAction({
+  auth: trelloAuth,
+  name: 'get_card_attachment',
+  displayName: 'Get Card Attachment',
+  description: 'Gets a specific attachment on a card.',
+  audience: 'both',
+  outputSchema: getCardAttachmentActionOutputSchema,
+  aiMetadata: { description: 'Retrieves the details of one specific attachment on a Trello card, identified by both card_id and attachment_id. Use to inspect a single attachment when you already know its id (e.g. from Get All Card Attachments). Read-only and idempotent.', idempotent: true },
+  props: {
+    card_id: Property.ShortText({
+      description: 'The ID of the card',
+      displayName: 'Card ID',
+      required: true,
+    }),
+    attachment_id: Property.ShortText({
+      description: 'The ID of the attachment to retrieve',
+      displayName: 'Attachment ID',
+      required: true,
+    })
+  },
+
+  async run(context) {
+
+    const request: HttpRequest = {
+      method: HttpMethod.GET,
+      url:
+        `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/attachments/${context.propsValue['attachment_id']}` +
+        `?key=` +
+        context.auth.username +
+        `&token=` +
+        context.auth.password,
+      headers: {
+        Accept: 'application/json',
+      },
+    };
+    
+    const response = await httpClient.sendRequest(request);
+
+    return response.body;
+  },
+});

package/src/lib/actions/card-attachment/get-card-attachments.ts

@@ -0,0 +1,45 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { getCardAttachmentsActionOutputSchema } from '../../output-schemas';
+
+export const getCardAttachments = createAction({
+  auth: trelloAuth,
+  name: 'get_card_attachments',
+  displayName: 'Get All Card Attachments',
+  description: 'Gets all attachments on a card.',
+  audience: 'human',
+  outputSchema: getCardAttachmentsActionOutputSchema,
+  aiMetadata: { description: 'Lists all attachments on a Trello card identified by card_id. Use to enumerate the files and links attached to a card, e.g. to find an attachment id before fetching or deleting it. Read-only and idempotent.', idempotent: true },
+  props: {
+    card_id: Property.ShortText({
+      description: 'The ID of the card to get attachments from',
+      displayName: 'Card ID',
+      required: true,
+    })
+  },
+
+  async run(context) {
+    const request: HttpRequest = {
+      method: HttpMethod.GET,
+      url:
+        `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/attachments` +
+        `?key=` +
+        context.auth.username +
+        `&token=` +
+        context.auth.password,
+      headers: {
+        Accept: 'application/json',
+      },
+    };
+    
+    const response = await httpClient.sendRequest(request);
+
+    return response.body;
+  },
+});

package/src/lib/common/index.ts

@@ -0,0 +1,333 @@
+import { BasicAuthPropertyValue, Property } from '@agnocon/pieces-framework';
+import { httpClient, HttpRequest, HttpMethod } from '@agnocon/pieces-common';
+import { trelloAuth } from '../..';
+
+export interface WebhookInformation {
+	id: string;
+	description: string;
+	idModel: string;
+	callbackURL: string;
+	active: boolean;
+	consecutiveFailures: number;
+	firstConsecutiveFailDate: string;
+}
+
+export const trelloCommon = {
+	baseUrl: 'https://api.trello.com/1/',
+	board_id:  Property.Dropdown({
+		auth: trelloAuth,
+
+		displayName: 'Boards',
+		description: 'List of boards',
+		required: true,
+		refreshers: [],
+		options: async ({ auth }) => {
+			if (!auth) {
+				return {
+					disabled: true,
+					placeholder: 'connect your account first',
+					options: [],
+				};
+			}
+
+			const basicAuthProperty = auth as BasicAuthPropertyValue;
+			const user = await getAuthorisedUser(basicAuthProperty.username, basicAuthProperty.password);
+			const boards = await listBoards(
+				basicAuthProperty.username,
+				basicAuthProperty.password,
+				user['id'],
+			);
+
+			return {
+				options: boards.map((board: { id: string; name: string }) => ({
+					value: board.id,
+					label: board.name,
+				})),
+			};
+		},
+	}),
+	list_id:  Property.Dropdown({
+		auth: trelloAuth,
+
+		displayName: 'Lists',
+		description: 'Get lists from a board',
+		required: true,
+		refreshers: ['board_id'],
+		options: async ({ auth, board_id }) => {
+			if (!auth || !board_id) {
+				return {
+					disabled: true,
+					placeholder: 'connect your account first and select a board',
+					options: [],
+				};
+			}
+
+			const basicAuthProperty = auth as BasicAuthPropertyValue;
+			const lists = await listBoardLists(
+				basicAuthProperty.username,
+				basicAuthProperty.password,
+				board_id as string,
+			);
+
+			return {
+				options: lists.map((list: { id: string; name: string }) => ({
+					value: list.id,
+					label: list.name,
+				})),
+			};
+		},
+	}),
+	list_id_opt:  Property.Dropdown({
+		auth: trelloAuth,
+
+		displayName: 'Lists',
+		description: 'Get lists from a board',
+		required: false,
+		refreshers: ['board_id'],
+		options: async ({ auth, board_id }) => {
+			if (!auth || !board_id) {
+				return {
+					disabled: true,
+					placeholder: 'connect your account first and select a board',
+					options: [],
+				};
+			}
+			const basicAuthProperty = auth as BasicAuthPropertyValue;
+			const lists = await listBoardLists(
+				basicAuthProperty.username,
+				basicAuthProperty.password,
+				board_id as string,
+			);
+
+			return {
+				options: lists.map((list: { id: string; name: string }) => ({
+					value: list.id,
+					label: list.name,
+				})),
+			};
+		},
+	}),
+	board_id_opt:  Property.Dropdown({
+		auth: trelloAuth,
+
+		displayName: 'Boards',
+		description: 'List of boards',
+		required: false,
+		refreshers: [],
+		options: async ({ auth }) => {
+			if (!auth) {
+				return {
+					disabled: true,
+					placeholder: 'connect your account first',
+					options: [],
+				};
+			}
+
+			const basicAuthProperty = auth as BasicAuthPropertyValue;
+			const user = await getAuthorisedUser(basicAuthProperty.username, basicAuthProperty.password);
+			const boards = await listBoards(
+				basicAuthProperty.username,
+				basicAuthProperty.password,
+				user['id'],
+			);
+
+			return {
+				options: boards.map((board: { id: string; name: string }) => ({
+					value: board.id,
+					label: board.name,
+				})),
+			};
+		},
+	}),
+	board_labels: Property.MultiSelectDropdown({
+		auth: trelloAuth,
+		displayName: 'Labels',
+		description: 'Assign labels to the card',
+		required: false,
+		refreshers: ['board_id'],
+		options: async ({ auth, board_id }) => {
+			if (!auth || !board_id) {
+				return {
+					disabled: true,
+					placeholder: 'connect your account first and select a board',
+					options: [],
+				};
+			}
+
+			const basicAuthProperty = auth as BasicAuthPropertyValue;
+			const labels = await listBoardLabels(
+				basicAuthProperty.username,
+				basicAuthProperty.password,
+				board_id as string,
+			);
+
+			return {
+				options: labels.map((label: { id: string; name: string; color: string }) => ({
+					label: label.name || label.color,
+					value: label.id,
+				})),
+			};
+		},
+	}),
+	create_webhook: async (auth: BasicAuthPropertyValue, list_id: string, webhookUrl: string) => {
+		const request: HttpRequest = {
+			method: HttpMethod.POST,
+			url:
+				`${trelloCommon.baseUrl}webhooks` +
+				`?key=` +
+				auth.username +
+				`&token=` +
+				auth.password +
+				`&callbackURL=` +
+				webhookUrl +
+				`&idModel=` +
+				list_id,
+		};
+		const response = await httpClient.sendRequest<WebhookInformation>(request);
+
+		return response.body;
+	},
+	delete_webhook: async (auth: BasicAuthPropertyValue, webhook_id: string) => {
+		const request: HttpRequest = {
+			method: HttpMethod.DELETE,
+			url:
+				`${trelloCommon.baseUrl}webhooks/${webhook_id}` +
+				`?key=` +
+				auth.username +
+				`&token=` +
+				auth.password,
+		};
+		const response = await httpClient.sendRequest(request);
+
+		return response.body;
+	},
+	list_webhooks: async (auth: BasicAuthPropertyValue) => {
+		const request: HttpRequest = {
+			method: HttpMethod.GET,
+			url: `${trelloCommon.baseUrl}tokens/${auth.password}/webhooks` + `?key=` + auth.username,
+		};
+		const response = await httpClient.sendRequest<WebhookInformation[]>(request);
+
+		return response.body;
+	},
+};
+
+/**
+ * Gets the authenticated user via API and token
+ * @param apikey API Key
+ * @param token  Token Key
+ * @returns JSON containing Trello user
+ */
+async function getAuthorisedUser(apikey: string, token: string) {
+	const request: HttpRequest = {
+		method: HttpMethod.GET,
+		url: `${trelloCommon.baseUrl}members/me` + `?key=` + apikey + `&token=` + token,
+		headers: {
+			Accept: 'application/json',
+		},
+	};
+	const response = await httpClient.sendRequest(request);
+
+	return response.body;
+}
+
+/**
+ * Lists all boards a member has access to in Trello
+ * @param apikey API Key
+ * @param token  API Token
+ * @param user_id ID of the user
+ * @returns JSON Array of boards user has access to
+ */
+async function listBoards(apikey: string, token: string, user_id: string) {
+	const request: HttpRequest = {
+		method: HttpMethod.GET,
+		url: `${trelloCommon.baseUrl}members/${user_id}/boards` + `?key=` + apikey + `&token=` + token,
+		headers: {
+			Accept: 'application/json',
+		},
+	};
+	const response = await httpClient.sendRequest<{ id: string; name: string }[]>(request);
+
+	return response.body;
+}
+
+/**
+ * Gets all the lists inside of a board
+ * @param apikey API Key
+ * @param token  API Token
+ * @param board_id Board to fetch lists from
+ * @returns JSON Array of lists
+ */
+async function listBoardLists(apikey: string, token: string, board_id: string) {
+	const request: HttpRequest = {
+		method: HttpMethod.GET,
+		url: `${trelloCommon.baseUrl}boards/${board_id}/lists` + `?key=` + apikey + `&token=` + token,
+		headers: {
+			Accept: 'application/json',
+		},
+	};
+	const response = await httpClient.sendRequest<{ id: string; name: string }[]>(request);
+
+	return response.body;
+}
+
+/**
+ * Gets all the labels of a board
+ * @param apikey API Key
+ * @param token  API Token
+ * @param board_id Board to fetch labels from
+ * @returns JSON Array of labels
+ */
+async function listBoardLabels(apikey: string, token: string, board_id: string) {
+	const request: HttpRequest = {
+		method: HttpMethod.GET,
+		url: `${trelloCommon.baseUrl}boards/${board_id}/labels` + `?key=` + apikey + `&token=` + token,
+		headers: {
+			Accept: 'application/json',
+		},
+	};
+	const response = await httpClient.sendRequest<{ id: string; name: string; color: string }[]>(
+		request,
+	);
+
+	return response.body;
+}
+
+export async function getCardDetail(apikey: string, token: string, card_id: string) {
+	const request: HttpRequest = {
+		method: HttpMethod.GET,
+		url: `${trelloCommon.baseUrl}cards/${card_id}` + `?key=` + apikey + `&token=` + token,
+		headers: {
+			Accept: 'application/json',
+		},
+	};
+
+	const response = await httpClient.sendRequest(request);
+	return response.body;
+}
+
+export async function getCardsInBoard(apikey: string, token: string, board_id: string) {
+	const request: HttpRequest = {
+		method: HttpMethod.GET,
+		url: `${trelloCommon.baseUrl}boards/${board_id}/cards` + `?key=` + apikey + `&token=` + token,
+		headers: {
+			Accept: 'application/json',
+		},
+	};
+
+	const response = await httpClient.sendRequest(request);
+	return response.body;
+}
+
+export async function getCardsInList(apikey: string, token: string, list_id: string) {
+	const request: HttpRequest = {
+		method: HttpMethod.GET,
+		url: `${trelloCommon.baseUrl}lists/${list_id}/cards` + `?key=` + apikey + `&token=` + token,
+		headers: {
+			Accept: 'application/json',
+		},
+	};
+
+	const response = await httpClient.sendRequest(request);
+	return response.body;
+}