@divyacon/piece-clickup 0.0.0-stage → 0.1.0

package/src/lib/actions/time-tracking/update-time-entry.ts

@@ -0,0 +1,69 @@
+import { HttpMethod, getAccessTokenOrThrow } from '@agnocon/pieces-common';
+import { Property, createAction } from '@agnocon/pieces-framework';
+import dayjs from 'dayjs';
+import { clickupAuth } from '../../auth';
+import { callClickUpApi, clickupCommon } from '../../common';
+import { timeEntryOutputSchema } from '../../output-schemas';
+
+export const clickupUpdateTimeEntry = createAction({
+  auth: clickupAuth,
+  name: 'clickup_update_time_entry',
+  displayName: 'Update Time Entry',
+  description: 'Update an existing time entry by its ID.',
+  audience: 'ai',
+  aiMetadata: {
+    description:
+      'Update fields on an existing tracked time entry (description, start, duration, billable flag) by its time entry ID. This sets the entry to the supplied values, so repeating with the same values leaves it unchanged (idempotent). Use Get Time Entry or List Time Entries first to obtain the entry ID.',
+    idempotent: true,
+  },
+  outputSchema: timeEntryOutputSchema,
+  props: {
+    workspace_id: clickupCommon.workspace_id(true),
+    timer_id: Property.ShortText({
+      displayName: 'Time Entry ID',
+      description:
+        'The ID of the time entry to update. Obtain it from List Time Entries.',
+      required: true,
+    }),
+    description: Property.LongText({
+      displayName: 'Description',
+      description: 'New note for the time entry.',
+      required: false,
+    }),
+    start: Property.DateTime({
+      displayName: 'Start',
+      description: 'New start time for the entry.',
+      required: false,
+    }),
+    duration: Property.Number({
+      displayName: 'Duration (ms)',
+      description: 'New length of the entry in milliseconds.',
+      required: false,
+    }),
+    billable: Property.Checkbox({
+      displayName: 'Billable',
+      description: 'Whether the time entry is billable.',
+      required: false,
+    }),
+  },
+  async run(context) {
+    const { workspace_id, timer_id, description, start, duration, billable } =
+      context.propsValue;
+    const auth = getAccessTokenOrThrow(context.auth);
+
+    const body: Record<string, unknown> = {};
+    if (description !== undefined) body['description'] = description;
+    if (start) body['start'] = dayjs(start).valueOf();
+    if (duration !== undefined) body['duration'] = duration;
+    if (billable !== undefined) body['billable'] = billable;
+
+    const response = await callClickUpApi(
+      HttpMethod.PUT,
+      `team/${workspace_id}/time_entries/${timer_id}`,
+      auth,
+      body
+    );
+
+    return response.body;
+  },
+});

package/src/lib/auth.ts

@@ -0,0 +1,9 @@
+import { PieceAuth } from '@agnocon/pieces-framework';
+
+export const clickupAuth = PieceAuth.OAuth2({
+  description: '',
+  authUrl: 'https://app.clickup.com/api',
+  tokenUrl: 'https://api.clickup.com/api/v2/oauth/token',
+  required: true,
+  scope: [],
+});