sunsama-api 0.8.1 → 0.10.0

package/dist/cjs/queries/mutations/updateTaskText.js

@@ -0,0 +1,554 @@
+"use strict";
+/**
+ * GraphQL mutation for updating task text/title
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPDATE_TASK_TEXT_MUTATION = void 0;
+const graphql_tag_1 = require("graphql-tag");
+exports.UPDATE_TASK_TEXT_MUTATION = (0, graphql_tag_1.gql) `
+  mutation updateTaskText($input: UpdateTaskTextInput!) {
+    updateTaskText(input: $input) {
+      ...UpdateTaskPayload
+      __typename
+    }
+  }
+
+  fragment UpdateTaskPayload on UpdateTaskPayload {
+    updatedTask {
+      ...Task
+      __typename
+    }
+    updatedFields {
+      ...PartialTask
+      __typename
+    }
+    success
+    skipped
+    __typename
+  }
+
+  fragment Task on Task {
+    _id
+    groupId
+    taskType
+    streamIds
+    recommendedStreamId
+    eventInfo {
+      eventId
+      clone
+      __typename
+    }
+    seededEventIds
+    private
+    assigneeId
+    createdBy
+    integration {
+      ...TaskIntegration
+      __typename
+    }
+    deleted
+    text
+    notes
+    notesMarkdown
+    notesChecksum
+    editorVersion
+    collabSnapshot
+    completed
+    completedBy
+    completeDate
+    completeOn
+    archivedAt
+    duration
+    runDate {
+      startDate
+      endDate
+      __typename
+    }
+    snooze {
+      userId
+      date
+      until
+      __typename
+    }
+    timeHorizon {
+      type
+      relativeTo
+      __typename
+    }
+    dueDate
+    comments {
+      userId
+      text
+      markdown
+      editorVersion
+      groupId
+      createdAt
+      editedAt
+      deleted
+      file
+      fileMetadata {
+        url
+        filename
+        mimetype
+        size
+        width
+        height
+        __typename
+      }
+      __typename
+    }
+    orderings {
+      ordinal
+      panelDate
+      channelId
+      userId
+      __typename
+    }
+    backlogOrderings {
+      horizonType
+      position
+      streamId
+      __typename
+    }
+    subtasks {
+      _id
+      title
+      completedDate
+      completedBy
+      timeEstimate
+      actualTime {
+        ...TaskActualTime
+        __typename
+      }
+      snooze {
+        userId
+        date
+        until
+        __typename
+      }
+      scheduledTime {
+        ...TaskScheduledTime
+        __typename
+      }
+      integration {
+        ...TaskIntegration
+        __typename
+      }
+      mergedTaskId
+      recommendedTimeEstimate
+      __typename
+    }
+    subtasksCollapsed
+    sequence {
+      date
+      id
+      expiresDate
+      ruleString
+      searchable
+      forked
+      final
+      estimatedStart {
+        hour
+        minute
+        __typename
+      }
+      master
+      finalDate
+      template {
+        streamIds
+        private
+        text
+        notes
+        notesMarkdown
+        notesChecksum
+        editorVersion
+        subtasks {
+          _id
+          title
+          completedDate
+          completedBy
+          timeEstimate
+          actualTime {
+            ...TaskActualTime
+            __typename
+          }
+          __typename
+        }
+        timeEstimate
+        assigneeId
+        __typename
+      }
+      __typename
+    }
+    followers
+    recommendedTimeEstimate
+    timeEstimate
+    actualTime {
+      ...TaskActualTime
+      __typename
+    }
+    scheduledTime {
+      ...TaskScheduledTime
+      __typename
+    }
+    createdAt
+    lastModified
+    objectiveId
+    ritual {
+      id
+      period {
+        interval
+        startCalendarDay
+        endCalendarDay
+        __typename
+      }
+      __typename
+    }
+    __typename
+  }
+
+  fragment TaskActualTime on TaskActualTime {
+    userId
+    startDate
+    endDate
+    duration
+    isTimerEntry
+    __typename
+  }
+
+  fragment TaskScheduledTime on TaskScheduledTime {
+    eventId
+    serviceIds {
+      google
+      microsoft
+      microsoftUniqueId
+      apple
+      appleRecurrenceId
+      sunsama
+      __typename
+    }
+    calendarId
+    userId
+    startDate
+    endDate
+    isAllDay
+    importedFromCalendar
+    __typename
+  }
+
+  fragment TaskIntegration on TaskIntegration {
+    ... on TaskAsanaIntegration {
+      service
+      identifier {
+        id
+        url
+        accountId
+        __typename
+      }
+      __typename
+    }
+    ... on TaskTrelloIntegration {
+      service
+      identifier {
+        id
+        url
+        accountId
+        __typename
+      }
+      __typename
+    }
+    ... on TaskJiraIntegration {
+      service
+      identifier {
+        id
+        cloudId
+        accountId
+        url
+        __typename
+      }
+      __typename
+    }
+    ... on TaskGithubIntegration {
+      service
+      identifier {
+        id
+        repositoryOwnerLogin
+        repositoryName
+        number
+        type
+        url
+        __typename
+      }
+      __typename
+    }
+    ... on TaskTodoistIntegration {
+      service
+      identifier {
+        id
+        url
+        deepUrl
+        __typename
+      }
+      __typename
+    }
+    ... on TaskGoogleCalendarIntegration {
+      service
+      identifier {
+        sunsamaId
+        __typename
+      }
+      __typename
+    }
+    ... on TaskOutlookCalendarIntegration {
+      service
+      identifier {
+        sunsamaId
+        __typename
+      }
+      __typename
+    }
+    ... on TaskAppleCalendarIntegration {
+      service
+      identifier {
+        sunsamaId
+        __typename
+      }
+      __typename
+    }
+    ... on TaskSunsamaCalendarIntegration {
+      service
+      identifier {
+        sunsamaId
+        __typename
+      }
+      __typename
+    }
+    ... on TaskGmailIntegration {
+      service
+      identifier {
+        id
+        messageId
+        accountId
+        url
+        __typename
+      }
+      __typename
+    }
+    ... on TaskOutlookIntegration {
+      service
+      identifier {
+        id
+        internetMessageId
+        conversationId
+        accountId
+        url
+        __typename
+      }
+      __typename
+    }
+    ... on TaskSlackIntegration {
+      service
+      identifier {
+        permalink
+        notesMarkdown
+        __typename
+      }
+      __typename
+    }
+    ... on TaskNotionIntegration {
+      service
+      identifier {
+        id
+        workspaceId
+        url
+        deepUrl
+        __typename
+      }
+      __typename
+    }
+    ... on TaskClickUpIntegration {
+      service
+      identifier {
+        id
+        userId
+        teamId
+        url
+        __typename
+      }
+      __typename
+    }
+    ... on TaskGitlabIntegration {
+      service
+      identifier {
+        id
+        __typename
+      }
+      __typename
+    }
+    ... on TaskEmailIntegration {
+      service
+      identifier {
+        id
+        __typename
+      }
+      content {
+        subject
+        text
+        html
+        from {
+          name
+          email
+          __typename
+        }
+        date
+        __typename
+      }
+      __typename
+    }
+    ... on TaskLinearIntegration {
+      service
+      identifier {
+        id
+        url
+        identifier
+        linearUserId
+        linearOrganizationId
+        number
+        _version
+        __typename
+      }
+      __typename
+    }
+    ... on TaskMondayIntegration {
+      service
+      identifier {
+        id
+        boardId
+        mondayAccountId
+        url
+        __typename
+      }
+      __typename
+    }
+    ... on TaskWebsiteIntegration {
+      service
+      identifier {
+        url
+        private
+        canonicalUrl
+        description
+        faviconUrl
+        imageUrl
+        siteName
+        title
+        __typename
+      }
+      __typename
+    }
+    ... on TaskLoomVideoIntegration {
+      service
+      identifier {
+        url
+        videoId
+        title
+        description
+        thumbnail {
+          width
+          height
+          url
+          __typename
+        }
+        __typename
+      }
+      __typename
+    }
+    ... on TaskMicrosoftTeamsIntegration {
+      service
+      identifier {
+        permalink
+        notesMarkdown
+        __typename
+      }
+      __typename
+    }
+    ... on TaskAppleRemindersIntegration {
+      service
+      identifier {
+        id
+        listId
+        autoImported
+        __typename
+      }
+      __typename
+    }
+    ... on TaskGoogleTasksIntegration {
+      service
+      identifier {
+        id
+        listId
+        accountId
+        __typename
+      }
+      __typename
+    }
+    ... on TaskMicrosoftToDoIntegration {
+      service
+      identifier {
+        id
+        listId
+        accountId
+        parentTaskId
+        __typename
+      }
+      __typename
+    }
+    ... on TaskSunsamaTaskIntegration {
+      service
+      identifier {
+        taskId
+        groupId
+        sunsamaUserId
+        __typename
+      }
+      __typename
+    }
+    __typename
+  }
+
+  fragment PartialTask on PartialTask {
+    _id
+    recommendedStreamId
+    streamIds
+    recommendedTimeEstimate
+    subtasks {
+      _id
+      title
+      completedDate
+      completedBy
+      timeEstimate
+      actualTime {
+        ...TaskActualTime
+        __typename
+      }
+      snooze {
+        userId
+        date
+        until
+        __typename
+      }
+      scheduledTime {
+        ...TaskScheduledTime
+        __typename
+      }
+      integration {
+        ...TaskIntegration
+        __typename
+      }
+      mergedTaskId
+      recommendedTimeEstimate
+      __typename
+    }
+    __typename
+  }
+`;
+//# sourceMappingURL=updateTaskText.js.map

package/dist/cjs/queries/mutations/updateTaskText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateTaskText.js","sourceRoot":"","sources":["../../../../src/queries/mutations/updateTaskText.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6CAAkC;AAErB,QAAA,yBAAyB,GAAG,IAAA,iBAAG,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiiB3C,CAAC"}

package/dist/esm/client/index.js

@@ -7,7 +7,7 @@ import { print } from 'graphql';
 import { Cookie, CookieJar } from 'tough-cookie';
 import * as Y from 'yjs';
 import { SunsamaAuthError } from '../errors/index.js';
-import { CREATE_TASK_MUTATION, GET_ARCHIVED_TASKS_QUERY, GET_STREAMS_BY_GROUP_ID_QUERY, GET_TASK_BY_ID_QUERY, GET_TASKS_BACKLOG_QUERY, GET_TASKS_BY_DAY_QUERY, GET_USER_QUERY, UPDATE_TASK_COMPLETE_MUTATION, UPDATE_TASK_DELETE_MUTATION, UPDATE_TASK_NOTES_MUTATION, UPDATE_TASK_PLANNED_TIME_MUTATION, UPDATE_TASK_SNOOZE_DATE_MUTATION, } from '../queries/index.js';
+import { CREATE_TASK_MUTATION, GET_ARCHIVED_TASKS_QUERY, GET_STREAMS_BY_GROUP_ID_QUERY, GET_TASK_BY_ID_QUERY, GET_TASKS_BACKLOG_QUERY, GET_TASKS_BY_DAY_QUERY, GET_USER_QUERY, UPDATE_TASK_COMPLETE_MUTATION, UPDATE_TASK_DELETE_MUTATION, UPDATE_TASK_NOTES_MUTATION, UPDATE_TASK_PLANNED_TIME_MUTATION, UPDATE_TASK_SNOOZE_DATE_MUTATION, UPDATE_TASK_DUE_DATE_MUTATION, UPDATE_TASK_TEXT_MUTATION, } from '../queries/index.js';
 import { validateUpdateTaskCompleteArgs, toISOString, htmlToMarkdown, markdownToHtml, } from '../utils/index.js';
 /**
  * Main Sunsama API client class
@@ -922,6 +922,110 @@ export class SunsamaClient {
         }
         return response.data.updateTaskPlannedTime;
     }
+    /**
+     * Updates the due date for a task
+     *
+     * This method allows you to set or clear a task's due date. The due date represents
+     * when the task should be completed and can be used for deadline tracking and planning.
+     *
+     * @param taskId - The ID of the task to update
+     * @param dueDate - The due date as Date, ISO string, or null to clear the due date
+     * @param limitResponsePayload - Whether to limit the response payload size (defaults to true)
+     * @returns The update result with success status
+     * @throws SunsamaAuthError if not authenticated or request fails
+     *
+     * @example
+     * ```typescript
+     * // Set task due date to a specific date
+     * const result = await client.updateTaskDueDate('taskId123', new Date('2025-06-21'));
+     *
+     * // Set due date with ISO string
+     * const result = await client.updateTaskDueDate('taskId123', '2025-06-21T04:00:00.000Z');
+     *
+     * // Clear the due date
+     * const result = await client.updateTaskDueDate('taskId123', null);
+     *
+     * // Get full response payload instead of limited response
+     * const result = await client.updateTaskDueDate('taskId123', new Date('2025-06-21'), false);
+     * ```
+     */
+    async updateTaskDueDate(taskId, dueDate, limitResponsePayload = true) {
+        // Convert Date to ISO string if needed
+        let dueDateString = null;
+        if (dueDate !== null) {
+            if (dueDate instanceof Date) {
+                dueDateString = dueDate.toISOString();
+            }
+            else {
+                dueDateString = dueDate;
+            }
+        }
+        const variables = {
+            input: {
+                taskId,
+                dueDate: dueDateString,
+                limitResponsePayload,
+            },
+        };
+        const request = {
+            operationName: 'updateTaskDueDate',
+            variables,
+            query: UPDATE_TASK_DUE_DATE_MUTATION,
+        };
+        const response = await this.graphqlRequest(request);
+        if (!response.data) {
+            throw new SunsamaAuthError('No response data received');
+        }
+        return response.data.updateTaskDueDate;
+    }
+    /**
+     * Updates the text/title of a task
+     *
+     * This method allows you to update the main text or title of a task. You can optionally
+     * specify a recommended stream ID for the task.
+     *
+     * @param taskId - The ID of the task to update
+     * @param text - The new text/title for the task
+     * @param options - Additional options for the operation
+     * @returns The update result with success status
+     * @throws SunsamaAuthError if not authenticated or request fails
+     *
+     * @example
+     * ```typescript
+     * // Update task text to a new title
+     * const result = await client.updateTaskText('taskId123', 'Updated task title');
+     *
+     * // Update with recommended stream ID
+     * const result = await client.updateTaskText('taskId123', 'Task with stream', {
+     *   recommendedStreamId: 'stream-id-123'
+     * });
+     *
+     * // Get full response payload instead of limited response
+     * const result = await client.updateTaskText('taskId123', 'New title', {
+     *   limitResponsePayload: false
+     * });
+     * ```
+     */
+    async updateTaskText(taskId, text, options) {
+        const variables = {
+            input: {
+                taskId,
+                text,
+                recommendedStreamId: options?.recommendedStreamId || null,
+                limitResponsePayload: options?.limitResponsePayload ?? true,
+            },
+        };
+        const request = {
+            operationName: 'updateTaskText',
+            variables,
+            query: UPDATE_TASK_TEXT_MUTATION,
+        };
+        const response = await this.graphqlRequest(request);
+        if (!response.data) {
+            throw new SunsamaAuthError('No response data received');
+        }
+        return response.data.updateTaskText;
+    }
     /**
      * Creates an updated collaborative editing snapshot based on existing state
      *