@divyacon/piece-trello 0.0.0-stage → 0.1.0

package/src/lib/triggers/deadline.ts

@@ -0,0 +1,89 @@
+import { trelloAuth } from '../..';
+import { TriggerStrategy, createTrigger, PiecePropValueSchema, Property, AppConnectionValueForAuthProperty } from '@agnocon/pieces-framework';
+import { DedupeStrategy, Polling, pollingHelper } from '@agnocon/pieces-common';
+import dayjs from 'dayjs';
+import { trelloCommon, getCardsInBoard, getCardsInList } from '../common';
+import { deadlineTriggerOutputSchema } from '../output-schemas';
+
+interface Props {
+    board_id: string;
+    list_id_opt?: string;
+    time_before_due: number;
+    time_unit: string;
+}
+
+const polling: Polling<AppConnectionValueForAuthProperty<typeof trelloAuth>, Props> = {
+    strategy: DedupeStrategy.TIMEBASED,
+    async items({ auth, propsValue, lastFetchEpochMS }) {
+        const { board_id, list_id_opt, time_before_due, time_unit } = propsValue;
+        const getCards = list_id_opt ? getCardsInList : getCardsInBoard;
+        const cards: any[] = await getCards(auth.username, auth.password, list_id_opt || board_id);
+
+        if(lastFetchEpochMS ===0)
+        {
+            // If lastFetchEpochMS is 0, we assume this is the test run and return all cards with due dates
+            return cards
+                .filter(card => card.due && !card.dueComplete)
+                .map(card => ({
+                    epochMilliSeconds: dayjs(card.due).valueOf(),
+                    data: card,
+                }));
+        }
+        const now = dayjs();
+        const upcoming = now.add(time_before_due, time_unit as dayjs.ManipulateType);
+
+        return cards
+            .filter(card => card.due && !card.dueComplete && dayjs(card.due).isAfter(now) && dayjs(card.due).isBefore(upcoming) && dayjs(card.due).valueOf() > lastFetchEpochMS)
+            .map(card => ({
+                epochMilliSeconds: dayjs(card.due).valueOf(),
+                data: card,
+            }));
+    },
+};
+
+export const deadlineTrigger = createTrigger({
+    auth: trelloAuth,
+    name: 'deadline',
+    displayName: 'Card Deadline',
+    description: 'Triggers at a specified time before a card deadline.',
+    outputSchema: deadlineTriggerOutputSchema,
+    aiMetadata: {
+        description: 'Fires for each card whose due date falls within a configured lead time (e.g. 24 hours) ahead of now, scoped to a board or an optional list. Represents an approaching, not-yet-completed card deadline; polls periodically and skips cards already marked due-complete.',
+    },
+    type: TriggerStrategy.POLLING,
+    props: {
+        board_id: trelloCommon.board_id,
+        list_id_opt: trelloCommon.list_id_opt,
+        time_unit: Property.StaticDropdown({
+            displayName: 'Time unit',
+            description: 'Select unit for time before due',
+            required: true,
+            options: {
+            options: [
+                { label: 'Minutes', value: 'minutes' },
+                { label: 'Hours', value: 'hours' },
+            ],
+            },
+            defaultValue: 'hours',
+        }),
+        time_before_due: Property.Number({
+            displayName: 'Time before due',
+            description: 'How long before the due date the trigger should run (use with time unit)',
+            required: true,
+            defaultValue: 24,
+        }),
+    },
+    async onEnable(context) {
+        await pollingHelper.onEnable(polling, context);
+    },
+    async onDisable(context) {
+        await pollingHelper.onDisable(polling, context);
+    },
+    async run(context) {
+        return await pollingHelper.poll(polling, context);
+    },
+    async test(context) {
+        return await pollingHelper.test(polling, context);
+    },
+    sampleData: undefined,
+});

package/src/lib/triggers/newCard.ts

@@ -0,0 +1,156 @@
+import { trelloAuth } from '../..';
+import { TriggerStrategy, createTrigger } from '@agnocon/pieces-framework';
+import { getCardDetail, getCardsInBoard, getCardsInList, trelloCommon } from '../common';
+import { TrelloNewCard } from '../common/props/card';
+import { isNil } from '@agnocon/pieces-framework';
+import { WebhookHandshakeStrategy } from '@agnocon/pieces-framework';
+import { newCardTriggerOutputSchema } from '../output-schemas';
+
+export const newCardTrigger = createTrigger({
+	auth: trelloAuth,
+	name: 'new_card',
+	displayName: 'New Card',
+	description: 'Trigger when a new card is created',
+	outputSchema: newCardTriggerOutputSchema,
+	aiMetadata: {
+		description: 'Fires when a new card is created on the selected board, or within a specific list if one is provided. Represents a newly added task or item; emits the created card with its full details.',
+	},
+	props: {
+		board_id: trelloCommon.board_id,
+		list_id_opt: trelloCommon.list_id_opt,
+	},
+	type: TriggerStrategy.WEBHOOK,
+	handshakeConfiguration: {
+		strategy: WebhookHandshakeStrategy.HEAD_REQUEST,
+	},
+	async onHandshake() {
+		return { status: 200 }
+	},
+	async onEnable(context) {
+		const element_id = context.propsValue.list_id_opt || context.propsValue.board_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 body = context.payload.body as TrelloNewCard;
+		if (body.action.display.translationKey !== 'action_create_card') {
+			return [];
+		}
+		if (context.propsValue.list_id_opt) {
+			if (body.action.display.entities.list.id !== context.propsValue.list_id_opt) {
+				return [];
+			}
+		}
+
+		const card = await getCardDetail(
+			context.auth.username,
+			context.auth.password,
+			body.action.display.entities.card.id,
+		);
+
+		return [card];
+	},
+	async test(context) {
+		let cards: Array<Record<string, unknown>> = [];
+		try {
+			const getListFunction = context.propsValue.list_id_opt ? getCardsInList : getCardsInBoard;
+			cards = await getListFunction(
+				context.auth.username,
+				context.auth.password,
+				context.propsValue.list_id_opt || context.propsValue.board_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,
+	},
+});