@divyacon/piece-trello 0.0.0-stage → 0.1.0

package/src/lib/common/props/card.ts

@@ -0,0 +1,113 @@
+export type TrelloCard = {
+  id: string;
+  address: string;
+  badges: {
+    attachmentsByType: {
+      trello: {
+        board: number;
+        card: number;
+      };
+    };
+    location: boolean;
+    votes: number;
+    viewingMemberVoted: boolean;
+    subscribed: boolean;
+    fogbugz: string;
+    checkItems: number;
+    checkItemsChecked: number;
+    comments: number;
+    attachments: number;
+    description: boolean;
+    due: string;
+    start: string;
+    dueComplete: boolean;
+  };
+  checkItemStates: string[];
+  closed: boolean;
+  coordinates: string;
+  creationMethod: string;
+  dateLastActivity: string;
+  desc: string;
+  due: string;
+  dueReminder: string;
+  email: string;
+  idBoard: string;
+  idChecklists: { id: string }[];
+  idLabels: {
+    id: string;
+    idBoard: string;
+    name: string;
+    color: string;
+  }[];
+  idList: string;
+  idMembers: string[];
+  idMembersVoted: string[];
+  idShort: number;
+  labels: string[];
+  locationName: string;
+  manualCoverAttachment: boolean;
+  name: string;
+  pos: number;
+  shortLink: string;
+  shortUrl: string;
+  subscribed: boolean;
+  url: string;
+};
+export type TrelloCardMoved = {
+  action: {
+    display: {
+      translationKey: string;
+      entities: {
+        card: {
+          type: string;
+          idList: string;
+          id: string;
+          shortLink: string;
+          text: string;
+        };
+        listBefore: {
+          type: string;
+          id: string;
+          text: string;
+        };
+        listAfter: {
+          type: string;
+          id: string;
+          text: string;
+        };
+        memberCreator: {
+          type: string;
+          id: string;
+          username: string;
+          text: string;
+        };
+      };
+    };
+  };
+};
+export type TrelloNewCard = {
+  action: {
+    display: {
+      translationKey: string;
+      entities: {
+        card: {
+          type: string;
+          id: string;
+          shortLink: string;
+          text: string;
+        };
+        list: {
+          type: string;
+          id: string;
+          text: string;
+        };
+        memberCreator: {
+          type: string;
+          id: string;
+          username: string;
+          text: string;
+        };
+      };
+    };
+  };
+};

package/src/lib/output-schemas.ts

@@ -0,0 +1,374 @@
+import { OutputSchema } from '@agnocon/pieces-framework';
+
+const labelFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Label ID' },
+  { key: 'name', label: 'Name' },
+  { key: 'color', label: 'Color' },
+];
+
+const boardLabelFields: OutputSchema['fields'] = [
+  ...labelFields,
+  { key: 'idBoard', label: 'Board ID' },
+  { key: 'uses', label: 'Uses', format: 'number' },
+];
+
+const cardFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Card ID' },
+  { key: 'name', label: 'Name' },
+  { key: 'desc', label: 'Description' },
+  { key: 'url', label: 'URL', format: 'url' },
+  { key: 'shortUrl', label: 'Short URL', format: 'url' },
+  { key: 'closed', label: 'Archived', format: 'boolean' },
+  { key: 'due', label: 'Due Date', format: 'datetime' },
+  { key: 'dueComplete', label: 'Due Complete', format: 'boolean' },
+  { key: 'dateLastActivity', label: 'Last Activity', format: 'datetime' },
+  { key: 'idBoard', label: 'Board ID' },
+  { key: 'idList', label: 'List ID' },
+  { key: 'idMembers', label: 'Member IDs' },
+  { key: 'idChecklists', label: 'Checklist IDs' },
+  { key: 'labels', label: 'Labels', labelKey: 'name', listItems: labelFields },
+];
+
+const attachmentFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Attachment ID' },
+  { key: 'name', label: 'Name' },
+  { key: 'url', label: 'URL', format: 'url' },
+  { key: 'mimeType', label: 'MIME Type' },
+  { key: 'bytes', label: 'Size (Bytes)', format: 'filesize' },
+  { key: 'isUpload', label: 'Is Upload', format: 'boolean' },
+  { key: 'date', label: 'Added At', format: 'datetime' },
+];
+
+const listFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'List ID' },
+  { key: 'name', label: 'Name' },
+  { key: 'closed', label: 'Archived', format: 'boolean' },
+  { key: 'color', label: 'Color' },
+  { key: 'idBoard', label: 'Board ID' },
+  { key: 'pos', label: 'Position', format: 'number' },
+];
+
+const boardFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Board ID' },
+  { key: 'name', label: 'Name' },
+  { key: 'desc', label: 'Description' },
+  { key: 'closed', label: 'Archived', format: 'boolean' },
+  { key: 'url', label: 'URL', format: 'url' },
+  { key: 'shortUrl', label: 'Short URL', format: 'url' },
+  { key: 'idOrganization', label: 'Organization ID' },
+  {
+    key: 'prefs',
+    label: 'Preferences',
+    children: [
+      { key: 'permissionLevel', label: 'Permission Level' },
+      { key: 'background', label: 'Background Color' },
+    ],
+  },
+];
+
+const memberSummaryFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Member ID' },
+  { key: 'fullName', label: 'Full Name' },
+  { key: 'username', label: 'Username' },
+  { key: 'avatarUrl', label: 'Avatar URL', format: 'image' },
+  { key: 'initials', label: 'Initials' },
+];
+
+const boardMemberFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Member ID' },
+  { key: 'fullName', label: 'Full Name' },
+  { key: 'username', label: 'Username' },
+];
+
+const checkItemFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Check Item ID' },
+  { key: 'name', label: 'Name' },
+  { key: 'state', label: 'State' },
+  { key: 'due', label: 'Due Date', format: 'datetime' },
+  { key: 'idMember', label: 'Member ID' },
+  { key: 'idChecklist', label: 'Checklist ID' },
+];
+
+const checklistFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Checklist ID' },
+  { key: 'name', label: 'Name' },
+  { key: 'idBoard', label: 'Board ID' },
+  { key: 'idCard', label: 'Card ID' },
+  {
+    key: 'checkItems',
+    label: 'Check Items',
+    labelKey: 'name',
+    listItems: checkItemFields,
+  },
+];
+
+const memberFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Member ID' },
+  { key: 'username', label: 'Username' },
+  { key: 'fullName', label: 'Full Name' },
+  { key: 'email', label: 'Email', format: 'email' },
+  { key: 'url', label: 'URL', format: 'url' },
+  { key: 'avatarUrl', label: 'Avatar URL', format: 'image' },
+];
+
+const reactionFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Reaction ID' },
+  { key: 'idMember', label: 'Member ID' },
+  { key: 'idModel', label: 'Comment ID' },
+  {
+    key: 'member',
+    label: 'Member',
+    children: [
+      { key: 'id', label: 'Member ID' },
+      { key: 'fullName', label: 'Full Name' },
+      { key: 'username', label: 'Username' },
+    ],
+  },
+  {
+    key: 'emoji',
+    label: 'Emoji',
+    children: [
+      { key: 'shortName', label: 'Short Name' },
+      { key: 'native', label: 'Native' },
+      { key: 'name', label: 'Name' },
+    ],
+  },
+];
+
+const commentActionFields: OutputSchema['fields'] = [
+  { key: 'id', label: 'Comment ID' },
+  { key: 'type', label: 'Type' },
+  { key: 'date', label: 'Date', format: 'datetime' },
+  {
+    key: 'data',
+    label: 'Data',
+    children: [
+      { key: 'text', label: 'Text' },
+      {
+        key: 'card',
+        label: 'Card',
+        children: [
+          { key: 'id', label: 'Card ID' },
+          { key: 'name', label: 'Name' },
+        ],
+      },
+      { key: 'dateLastEdited', label: 'Last Edited', format: 'datetime' },
+    ],
+  },
+  {
+    key: 'memberCreator',
+    label: 'Member Creator',
+    children: [
+      { key: 'id', label: 'Member ID' },
+      { key: 'fullName', label: 'Full Name' },
+      { key: 'username', label: 'Username' },
+    ],
+  },
+];
+
+export const createCardAiActionOutputSchema: OutputSchema = { fields: cardFields };
+
+export const getCardAiActionOutputSchema: OutputSchema = { fields: cardFields };
+
+export const updateCardAiActionOutputSchema: OutputSchema = { fields: cardFields };
+
+export const listCardAttachmentsAiActionOutputSchema: OutputSchema = {
+  itemLabel: '{name}',
+  fields: [
+    { key: 'attachments', label: 'Attachments', value: '', listItems: attachmentFields },
+  ],
+};
+
+export const searchCardsActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    { key: 'cards', label: 'Cards', labelKey: 'name', listItems: cardFields },
+  ],
+};
+
+export const searchMembersActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    {
+      key: 'members',
+      label: 'Members',
+      labelKey: 'fullName',
+      listItems: [
+        ...memberSummaryFields,
+        { key: 'email', label: 'Email', format: 'email' },
+        { key: 'active', label: 'Active', format: 'boolean' },
+      ],
+    },
+  ],
+};
+
+export const listCardsInListActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    { key: 'cards', label: 'Cards', labelKey: 'name', listItems: cardFields },
+  ],
+};
+
+export const listCardsInBoardActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    { key: 'cards', label: 'Cards', labelKey: 'name', listItems: cardFields },
+  ],
+};
+
+export const listCardMembersActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    {
+      key: 'members',
+      label: 'Members',
+      labelKey: 'fullName',
+      listItems: memberSummaryFields,
+    },
+  ],
+};
+
+export const addCommentToCardActionOutputSchema: OutputSchema = { fields: commentActionFields };
+
+export const listCardCommentsActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    {
+      key: 'comments',
+      label: 'Comments',
+      labelKey: 'id',
+      listItems: commentActionFields,
+    },
+  ],
+};
+
+export const updateCommentActionOutputSchema: OutputSchema = { fields: commentActionFields };
+
+export const addMemberToCardActionOutputSchema: OutputSchema = {
+  itemLabel: '{fullName}',
+  fields: [
+    { key: 'members', label: 'Card Members', value: '', listItems: memberSummaryFields },
+  ],
+};
+
+export const removeMemberFromCardActionOutputSchema: OutputSchema = {
+  itemLabel: '{fullName}',
+  fields: [
+    { key: 'members', label: 'Card Members', value: '', listItems: memberSummaryFields },
+  ],
+};
+
+export const createBoardLabelActionOutputSchema: OutputSchema = { fields: boardLabelFields };
+
+export const updateLabelActionOutputSchema: OutputSchema = { fields: boardLabelFields };
+
+export const listBoardLabelsActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    { key: 'labels', label: 'Labels', labelKey: 'name', listItems: boardLabelFields },
+  ],
+};
+
+export const addLabelToCardActionOutputSchema: OutputSchema = {
+  fields: [{ key: 'labelIds', label: 'Label IDs', value: '' }],
+};
+
+export const moveCardActionOutputSchema: OutputSchema = { fields: cardFields };
+
+export const archiveCardActionOutputSchema: OutputSchema = { fields: cardFields };
+
+export const createListActionOutputSchema: OutputSchema = { fields: listFields };
+
+export const getListActionOutputSchema: OutputSchema = { fields: listFields };
+
+export const listListsActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    { key: 'lists', label: 'Lists', labelKey: 'name', listItems: listFields },
+  ],
+};
+
+export const renameListActionOutputSchema: OutputSchema = { fields: listFields };
+
+export const archiveListActionOutputSchema: OutputSchema = { fields: listFields };
+
+export const createBoardActionOutputSchema: OutputSchema = { fields: boardFields };
+
+export const getBoardActionOutputSchema: OutputSchema = { fields: boardFields };
+
+export const listBoardsActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    { key: 'boards', label: 'Boards', labelKey: 'name', listItems: boardFields },
+  ],
+};
+
+export const listOrganizationBoardsActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    { key: 'boards', label: 'Boards', labelKey: 'name', listItems: boardFields },
+  ],
+};
+
+export const listBoardMembersActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    {
+      key: 'members',
+      label: 'Members',
+      labelKey: 'fullName',
+      listItems: boardMemberFields,
+    },
+  ],
+};
+
+export const getMemberActionOutputSchema: OutputSchema = { fields: memberFields };
+
+export const getMyMemberActionOutputSchema: OutputSchema = { fields: memberFields };
+
+export const addChecklistToCardActionOutputSchema: OutputSchema = { fields: checklistFields };
+
+export const addChecklistItemActionOutputSchema: OutputSchema = { fields: checkItemFields };
+
+export const listCardChecklistsActionOutputSchema: OutputSchema = {
+  fields: [
+    { key: 'count', label: 'Count', format: 'number' },
+    {
+      key: 'checklists',
+      label: 'Checklists',
+      labelKey: 'name',
+      listItems: checklistFields,
+    },
+  ],
+};
+
+export const setChecklistItemStateActionOutputSchema: OutputSchema = { fields: checkItemFields };
+
+export const addReactionToCommentActionOutputSchema: OutputSchema = { fields: reactionFields };
+
+export const updateBoardActionOutputSchema: OutputSchema = { fields: boardFields };
+
+export const archiveBoardActionOutputSchema: OutputSchema = { fields: boardFields };
+
+export const createCardActionOutputSchema: OutputSchema = { fields: cardFields };
+
+export const getCardActionOutputSchema: OutputSchema = { fields: cardFields };
+
+export const updateCardActionOutputSchema: OutputSchema = { fields: cardFields };
+
+export const getCardAttachmentActionOutputSchema: OutputSchema = { fields: attachmentFields };
+
+export const getCardAttachmentsActionOutputSchema: OutputSchema = {
+  itemLabel: '{name}',
+  fields: [
+    { key: 'attachments', label: 'Attachments', value: '', listItems: attachmentFields },
+  ],
+};
+
+export const addCardAttachmentActionOutputSchema: OutputSchema = { fields: attachmentFields };
+
+export const cardMovedTriggerOutputSchema: OutputSchema = { fields: cardFields };
+
+export const newCardTriggerOutputSchema: OutputSchema = { fields: cardFields };
+
+export const deadlineTriggerOutputSchema: OutputSchema = { fields: cardFields };

package/src/lib/triggers/cardMoved.ts

@@ -0,0 +1,155 @@
+import { trelloAuth } from '../..';
+import { TriggerStrategy, createTrigger } from '@agnocon/pieces-framework';
+import { getCardDetail, getCardsInList, trelloCommon } from '../common';
+import { TrelloCardMoved } from '../common/props/card';
+import { isNil } from '@agnocon/pieces-framework';
+import { WebhookHandshakeStrategy } from '@agnocon/pieces-framework';
+import { cardMovedTriggerOutputSchema } from '../output-schemas';
+
+export const cardMovedTrigger = createTrigger({
+	auth: trelloAuth,
+	name: 'card_moved_to_list',
+	displayName: 'Card Moved to list',
+	description: 'Trigger when a card is moved to the list specified',
+	outputSchema: cardMovedTriggerOutputSchema,
+	aiMetadata: {
+		description: 'Fires when a card is moved into the specified list on a board (from a different list). Represents a card transitioning to a new stage; emits the moved card with its full details.',
+	},
+	props: {
+		board_id: trelloCommon.board_id,
+		list_id: trelloCommon.list_id,
+	},
+	type: TriggerStrategy.WEBHOOK,
+	handshakeConfiguration: {
+		strategy: WebhookHandshakeStrategy.HEAD_REQUEST,
+	},
+	async onHandshake() {
+		return { status: 200 }
+	},
+	async onEnable(context) {
+		const element_id = context.propsValue.list_id;
+		const webhooks = await trelloCommon.list_webhooks(context.auth);
+		const webhook = webhooks.find(
+			(webhook) => webhook.idModel === element_id && webhook.callbackURL === context.webhookUrl,
+		);
+		if (webhook) {
+			context.webhookUrl = webhook.callbackURL;
+			return;
+		}
+		const response = await trelloCommon.create_webhook(
+			context.auth,
+			element_id,
+			context.webhookUrl,
+		);
+		await context.store.put('webhook_id', response.id);
+	},
+	async onDisable(context) {
+		const webhook_id = (await context.store.get('webhook_id')) as string;
+		if (isNil(webhook_id)) {
+			return;
+		}
+		const webhooks = await trelloCommon.list_webhooks(context.auth);
+		const webhook = webhooks.find((webhook) => webhook.callbackURL === context.webhookUrl);
+		if (!webhook) {
+			return;
+		}
+		await trelloCommon.delete_webhook(context.auth, webhook_id);
+	},
+	async run(context) {
+		const response = context.payload.body as TrelloCardMoved;
+		const response_body = response.action.display;
+		if (response.action.display.translationKey !== 'action_move_card_from_list_to_list') {
+			return [];
+		}
+		if (response_body.entities.listAfter.id !== context.propsValue.list_id) {
+			return [];
+		}
+		if (response_body.entities.listBefore.id === context.propsValue.list_id) {
+			return [];
+		}
+		const card = await getCardDetail(
+			context.auth.username,
+			context.auth.password,
+			response_body.entities.card.id,
+		);
+		return [card];
+	},
+	async test(context) {
+		let cards: Array<Record<string, unknown>> = [];
+		try {
+			cards = await getCardsInList(
+				context.auth.username,
+				context.auth.password,
+				context.propsValue.list_id,
+			);
+
+			cards.sort(
+				(a: any, b: any) =>
+					new Date(b.dateLastActivity).getTime() - new Date(a.dateLastActivity).getTime(),
+			);
+
+			return cards.slice(0, 5);
+		} catch (error) {
+			console.error('An error occurred:', error);
+			return [];
+		}
+	},
+	sampleData: {
+		id: '6651d6d6298164adb4a598b6',
+		badges: {
+			attachmentsByType: { trello: { board: 0, card: 0 } },
+			externalSource: null,
+			location: false,
+			votes: 0,
+			viewingMemberVoted: false,
+			subscribed: false,
+			attachments: 0,
+			fogbugz: '',
+			checkItems: 0,
+			checkItemsChecked: 0,
+			checkItemsEarliestDue: null,
+			comments: 0,
+			description: false,
+			due: null,
+			dueComplete: false,
+			lastUpdatedByAi: false,
+			start: null,
+		},
+		checkItemStates: [],
+		closed: false,
+		dueComplete: false,
+		dateLastActivity: '2024-05-25T12:17:26.372Z',
+		desc: '',
+		descData: { emoji: {} },
+		due: null,
+		dueReminder: null,
+		email: null,
+		idBoard: '6639c3a2f9a2ecd2b53adcc4',
+		idChecklists: [],
+		idList: '6639c3a342f39d7f6ff9e9b0',
+		idMembers: [],
+		idMembersVoted: [],
+		idShort: 11,
+		idAttachmentCover: null,
+		labels: [],
+		idLabels: [],
+		manualCoverAttachment: false,
+		name: 'TEST CARDS',
+		pos: 196608,
+		shortLink: '57tgmppm',
+		shortUrl: 'https://trello.com/c/57tghpk',
+		start: null,
+		subscribed: false,
+		url: 'https://trello.com/c/57tkkppm/11-again-cards',
+		cover: {
+			idAttachment: null,
+			color: null,
+			idUploadedBackground: null,
+			size: 'normal',
+			brightness: 'dark',
+			idPlugin: null,
+		},
+		isTemplate: false,
+		cardRole: null,
+	},
+});