@doist/todoist-sdk 8.4.0-next.1 → 8.4.0-next.2

package/dist/cjs/consts/endpoints.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ENDPOINT_REST_ID_MAPPINGS = exports.ENDPOINT_REST_EMAILS = exports.ENDPOINT_REST_BACKUPS_DOWNLOAD = exports.ENDPOINT_REST_BACKUPS = exports.ENDPOINT_REST_ACCESS_TOKENS_MIGRATE = exports.ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID = exports.ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE = exports.ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE = exports.ENDPOINT_REST_TEMPLATES_URL = exports.ENDPOINT_REST_TEMPLATES_FILE = exports.ENDPOINT_REST_TASKS_COMPLETED = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE = exports.SECTION_UNARCHIVE = exports.SECTION_ARCHIVE = exports.ENDPOINT_REST_PROJECT_JOIN = exports.ENDPOINT_REST_PROJECT_FULL = exports.ENDPOINT_REST_PROJECTS_PERMISSIONS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT = exports.PROJECT_UNARCHIVE = exports.PROJECT_ARCHIVE = exports.ENDPOINT_REST_UPLOADS = exports.ENDPOINT_REST_ACTIVITIES = exports.ENDPOINT_REST_PRODUCTIVITY = exports.ENDPOINT_REST_USER = exports.ENDPOINT_REST_PROJECT_COLLABORATORS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED = exports.ENDPOINT_REST_PROJECTS_SEARCH = exports.ENDPOINT_REST_PROJECTS = exports.ENDPOINT_REST_TASK_MOVE = exports.ENDPOINT_REST_TASK_REOPEN = exports.ENDPOINT_REST_TASK_CLOSE = exports.ENDPOINT_REST_LOCATION_REMINDERS = exports.ENDPOINT_REST_REMINDERS = exports.ENDPOINT_REST_COMMENTS = exports.ENDPOINT_REST_LABELS_SHARED_REMOVE = exports.ENDPOINT_REST_LABELS_SHARED_RENAME = exports.ENDPOINT_REST_LABELS_SHARED = exports.ENDPOINT_REST_LABELS_SEARCH = exports.ENDPOINT_REST_LABELS = exports.ENDPOINT_REST_SECTIONS_SEARCH = exports.ENDPOINT_REST_SECTIONS = exports.ENDPOINT_REST_TASKS_COMPLETED_SEARCH = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE = exports.ENDPOINT_REST_TASKS_FILTER = exports.ENDPOINT_REST_TASKS = exports.API_BASE_URI = exports.API_VERSION = exports.TODOIST_WEB_URI = void 0;
-exports.ENDPOINT_WORKSPACE_MEMBERS = exports.ENDPOINT_WORKSPACE_USERS = exports.ENDPOINT_WORKSPACE_PLAN_DETAILS = exports.ENDPOINT_WORKSPACE_LOGO = exports.ENDPOINT_WORKSPACE_JOIN = exports.ENDPOINT_WORKSPACE_INVITATIONS_DELETE = exports.ENDPOINT_WORKSPACE_INVITATIONS_ALL = exports.ENDPOINT_WORKSPACE_INVITATIONS = exports.ENDPOINT_REST_WORKSPACES = exports.ENDPOINT_REST_FOLDERS = exports.ENDPOINT_REGISTER = exports.ENDPOINT_REVOKE = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_MOVED_IDS = void 0;
+exports.ENDPOINT_WORKSPACE_MEMBERS = exports.ENDPOINT_WORKSPACE_USERS = exports.ENDPOINT_WORKSPACE_PLAN_DETAILS = exports.ENDPOINT_WORKSPACE_LOGO = exports.ENDPOINT_WORKSPACE_JOIN = exports.ENDPOINT_WORKSPACE_INVITATIONS_DELETE = exports.ENDPOINT_WORKSPACE_INVITATIONS_ALL = exports.ENDPOINT_WORKSPACE_INVITATIONS = exports.ENDPOINT_REST_WORKSPACES = exports.GOAL_TASKS = exports.GOAL_UNCOMPLETE = exports.GOAL_COMPLETE = exports.ENDPOINT_REST_GOALS_SEARCH = exports.ENDPOINT_REST_GOALS = exports.ENDPOINT_REST_FOLDERS = exports.ENDPOINT_REGISTER = exports.ENDPOINT_REVOKE = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_MOVED_IDS = void 0;
 exports.getSyncBaseUri = getSyncBaseUri;
 exports.getAuthBaseUri = getAuthBaseUri;
 exports.getWorkspaceInvitationAcceptEndpoint = getWorkspaceInvitationAcceptEndpoint;
@@ -86,6 +86,11 @@ exports.ENDPOINT_GET_TOKEN = 'access_token';
 exports.ENDPOINT_REVOKE = 'revoke';
 exports.ENDPOINT_REGISTER = 'register';
 exports.ENDPOINT_REST_FOLDERS = 'folders';
+exports.ENDPOINT_REST_GOALS = 'goals';
+exports.ENDPOINT_REST_GOALS_SEARCH = exports.ENDPOINT_REST_GOALS + '/search';
+exports.GOAL_COMPLETE = 'complete';
+exports.GOAL_UNCOMPLETE = 'uncomplete';
+exports.GOAL_TASKS = 'items';
 // Workspace endpoints
 exports.ENDPOINT_REST_WORKSPACES = 'workspaces';
 exports.ENDPOINT_WORKSPACE_INVITATIONS = 'workspaces/invitations';

package/dist/cjs/todoist-api.js

@@ -1914,6 +1914,134 @@ class TodoistApi {
         });
         return (0, http_client_1.isSuccess)(response);
     }
+    // ── Goals ──
+    async getGoals(args) {
+        const { data: { results, nextCursor }, } = await (0, http_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_GOALS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateGoalArray)(results),
+            nextCursor,
+        };
+    }
+    async searchGoals(args) {
+        const { data: { results, nextCursor }, } = await (0, http_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_GOALS_SEARCH,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateGoalArray)(results),
+            nextCursor,
+        };
+    }
+    async getGoal(id) {
+        zod_1.z.string().parse(id);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_GOALS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return (0, validators_1.validateGoal)(response.data);
+    }
+    async addGoal(args, requestId) {
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_GOALS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateGoal)(response.data);
+    }
+    async updateGoal(id, args, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_GOALS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateGoal)(response.data);
+    }
+    async deleteGoal(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_GOALS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return (0, http_client_1.isSuccess)(response);
+    }
+    async completeGoal(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_GOALS, id, endpoints_1.GOAL_COMPLETE),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateGoal)(response.data);
+    }
+    async uncompleteGoal(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_GOALS, id, endpoints_1.GOAL_UNCOMPLETE),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateGoal)(response.data);
+    }
+    async linkTaskToGoal({ goalId, taskId }, requestId) {
+        zod_1.z.string().parse(goalId);
+        zod_1.z.string().parse(taskId);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_GOALS, goalId, endpoints_1.GOAL_TASKS),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: { itemId: taskId },
+            requestId: requestId,
+        });
+        return (0, validators_1.validateGoal)(response.data);
+    }
+    async unlinkTaskFromGoal({ goalId, taskId }, requestId) {
+        zod_1.z.string().parse(goalId);
+        zod_1.z.string().parse(taskId);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_GOALS, goalId, endpoints_1.GOAL_TASKS, taskId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return (0, http_client_1.isSuccess)(response);
+    }
     // ── Backups ──
     /**
      * Retrieves a list of available backups.

package/dist/cjs/types/goals/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./requests"), exports);

package/dist/cjs/types/goals/requests.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/{sync/resources/goals.js → goals/types.js}

@@ -4,15 +4,12 @@ exports.GoalSchema = exports.GoalProgressSchema = exports.GOAL_OWNER_TYPES = voi
 const zod_1 = require("zod");
 /** Available goal owner types. */
 exports.GOAL_OWNER_TYPES = ['USER', 'WORKSPACE'];
-exports.GoalProgressSchema = zod_1.z
-    .object({
-    totalItemCount: zod_1.z.number().int(),
-    completedItemCount: zod_1.z.number().int(),
+exports.GoalProgressSchema = zod_1.z.looseObject({
+    totalTaskCount: zod_1.z.number().int(),
+    completedTaskCount: zod_1.z.number().int(),
     percentage: zod_1.z.number(),
-})
-    .passthrough();
-exports.GoalSchema = zod_1.z
-    .object({
+});
+exports.GoalSchema = zod_1.z.looseObject({
     id: zod_1.z.string(),
     ownerType: zod_1.z.enum(exports.GOAL_OWNER_TYPES),
     ownerId: zod_1.z.string(),
@@ -29,5 +26,4 @@ exports.GoalSchema = zod_1.z
     creatorUid: zod_1.z.string(),
     createdAt: zod_1.z.coerce.date(),
     updatedAt: zod_1.z.coerce.date(),
-})
-    .passthrough();
+});

package/dist/cjs/types/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./productivity"), exports);
 __exportStar(require("./activity"), exports);
 __exportStar(require("./workspaces"), exports);
 __exportStar(require("./folders"), exports);
+__exportStar(require("./goals"), exports);
 __exportStar(require("./insights"), exports);
 __exportStar(require("./backups"), exports);
 __exportStar(require("./id-mappings"), exports);

package/dist/cjs/types/sync/resources/index.js

@@ -21,7 +21,6 @@ __exportStar(require("./tooltips"), exports);
 __exportStar(require("./notes"), exports);
 __exportStar(require("./workspace-filters"), exports);
 __exportStar(require("./workspace-goals"), exports);
-__exportStar(require("./goals"), exports);
 __exportStar(require("./calendars"), exports);
 __exportStar(require("./reminders"), exports);
 __exportStar(require("./completed-info"), exports);

package/dist/cjs/utils/validators.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateTooltips = exports.validateNoteArray = exports.validateNote = exports.validateFolderArray = exports.validateFolder = exports.validateCollaboratorStateArray = exports.validateCollaboratorState = exports.validateCollaboratorArray = exports.validateCollaborator = exports.validateFilterArray = exports.validateFilter = exports.validateMovedIdArray = exports.validateMovedId = exports.validateIdMappingArray = exports.validateIdMapping = exports.validateBackupArray = exports.validateBackup = exports.validateWorkspaceInsights = exports.validateProjectProgress = exports.validateProjectHealthContext = exports.validateProjectHealth = exports.validateProjectActivityStats = exports.validateWorkspaceUserTaskArray = exports.validateWorkspaceUserTask = exports.validateMemberActivityInfoArray = exports.validateMemberActivityInfo = exports.validateWorkspaceArray = exports.validateWorkspace = exports.validateJoinWorkspaceResult = exports.validateWorkspacePlanDetails = exports.validateWorkspaceInvitationArray = exports.validateWorkspaceInvitation = exports.validateWorkspaceUser = exports.validateAttachment = exports.validateActivityEventArray = exports.validateActivityEvent = exports.validateCurrentUser = exports.validateProductivityStats = exports.validateUserArray = exports.validateUser = exports.validateCommentArray = exports.validateComment = exports.validateLabelArray = exports.validateLabel = exports.validateSectionArray = exports.validateSection = exports.validateWorkspaceProjectArray = exports.validateWorkspaceProject = exports.validateTaskArray = exports.validateTask = void 0;
-exports.validateSuggestionArray = exports.validateSuggestion = exports.validateUserSettings = exports.validateSyncUser = exports.validateSyncWorkspaceArray = exports.validateSyncWorkspace = exports.validateLiveNotificationArray = exports.validateLiveNotification = exports.validateUserPlanLimits = exports.validateProjectViewOptionsDefaultsArray = exports.validateProjectViewOptionsDefaults = exports.validateViewOptionsArray = exports.validateViewOptions = exports.validateCompletedInfoArray = exports.validateCompletedInfo = exports.validateLocationReminderArray = exports.validateLocationReminder = exports.validateReminderArray = exports.validateReminder = exports.validateCalendarAccountArray = exports.validateCalendarAccount = exports.validateCalendarArray = exports.validateCalendar = exports.validateWorkspaceGoalArray = exports.validateWorkspaceGoal = exports.validateGoalArray = exports.validateGoal = exports.validateWorkspaceFilterArray = exports.validateWorkspaceFilter = void 0;
+exports.validateNote = exports.validateGoalArray = exports.validateGoal = exports.validateFolderArray = exports.validateFolder = exports.validateCollaboratorStateArray = exports.validateCollaboratorState = exports.validateCollaboratorArray = exports.validateCollaborator = exports.validateFilterArray = exports.validateFilter = exports.validateMovedIdArray = exports.validateMovedId = exports.validateIdMappingArray = exports.validateIdMapping = exports.validateBackupArray = exports.validateBackup = exports.validateWorkspaceInsights = exports.validateProjectProgress = exports.validateProjectHealthContext = exports.validateProjectHealth = exports.validateProjectActivityStats = exports.validateWorkspaceUserTaskArray = exports.validateWorkspaceUserTask = exports.validateMemberActivityInfoArray = exports.validateMemberActivityInfo = exports.validateWorkspaceArray = exports.validateWorkspace = exports.validateJoinWorkspaceResult = exports.validateWorkspacePlanDetails = exports.validateWorkspaceInvitationArray = exports.validateWorkspaceInvitation = exports.validateWorkspaceUser = exports.validateAttachment = exports.validateActivityEventArray = exports.validateActivityEvent = exports.validateCurrentUser = exports.validateProductivityStats = exports.validateUserArray = exports.validateUser = exports.validateCommentArray = exports.validateComment = exports.validateLabelArray = exports.validateLabel = exports.validateSectionArray = exports.validateSection = exports.validateWorkspaceProjectArray = exports.validateWorkspaceProject = exports.validateTaskArray = exports.validateTask = void 0;
+exports.validateSuggestionArray = exports.validateSuggestion = exports.validateUserSettings = exports.validateSyncUser = exports.validateSyncWorkspaceArray = exports.validateSyncWorkspace = exports.validateLiveNotificationArray = exports.validateLiveNotification = exports.validateUserPlanLimits = exports.validateProjectViewOptionsDefaultsArray = exports.validateProjectViewOptionsDefaults = exports.validateViewOptionsArray = exports.validateViewOptions = exports.validateCompletedInfoArray = exports.validateCompletedInfo = exports.validateLocationReminderArray = exports.validateLocationReminder = exports.validateReminderArray = exports.validateReminder = exports.validateCalendarAccountArray = exports.validateCalendarAccount = exports.validateCalendarArray = exports.validateCalendar = exports.validateWorkspaceGoalArray = exports.validateWorkspaceGoal = exports.validateWorkspaceFilterArray = exports.validateWorkspaceFilter = exports.validateTooltips = exports.validateNoteArray = void 0;
 exports.isWorkspaceProject = isWorkspaceProject;
 exports.isPersonalProject = isPersonalProject;
 exports.validateProject = validateProject;
@@ -11,15 +11,16 @@ exports.parseSyncResponse = parseSyncResponse;
 const types_1 = require("../types/activity/types");
 const types_2 = require("../types/backups/types");
 const types_3 = require("../types/comments/types");
-const types_4 = require("../types/id-mappings/types");
-const types_5 = require("../types/insights/types");
-const types_6 = require("../types/labels/types");
-const types_7 = require("../types/productivity/types");
-const types_8 = require("../types/projects/types");
-const types_9 = require("../types/sections/types");
-const types_10 = require("../types/tasks/types");
-const types_11 = require("../types/users/types");
-const types_12 = require("../types/workspaces/types");
+const types_4 = require("../types/goals/types");
+const types_5 = require("../types/id-mappings/types");
+const types_6 = require("../types/insights/types");
+const types_7 = require("../types/labels/types");
+const types_8 = require("../types/productivity/types");
+const types_9 = require("../types/projects/types");
+const types_10 = require("../types/sections/types");
+const types_11 = require("../types/tasks/types");
+const types_12 = require("../types/users/types");
+const types_13 = require("../types/workspaces/types");
 const resources_1 = require("../types/sync/resources");
 function createValidator(schema) {
     return (input) => schema.parse(input);
@@ -33,7 +34,7 @@ function createArrayValidator(validateItem) {
     };
 }
 // Entity validators
-exports.validateTask = createValidator(types_10.TaskSchema);
+exports.validateTask = createValidator(types_11.TaskSchema);
 exports.validateTaskArray = createArrayValidator(exports.validateTask);
 /**
  * Type guard to check if a project is a workspace project.
@@ -58,9 +59,9 @@ function isPersonalProject(project) {
  */
 function validateProject(input) {
     if ('workspaceId' in input) {
-        return types_8.WorkspaceProjectSchema.parse(input);
+        return types_9.WorkspaceProjectSchema.parse(input);
     }
-    return types_8.PersonalProjectSchema.parse(input);
+    return types_9.PersonalProjectSchema.parse(input);
 }
 function validateProjectArray(input) {
     if (!Array.isArray(input)) {
@@ -68,48 +69,48 @@ function validateProjectArray(input) {
     }
     return input.map(validateProject);
 }
-exports.validateWorkspaceProject = createValidator(types_8.WorkspaceProjectSchema);
+exports.validateWorkspaceProject = createValidator(types_9.WorkspaceProjectSchema);
 exports.validateWorkspaceProjectArray = createArrayValidator(exports.validateWorkspaceProject);
-exports.validateSection = createValidator(types_9.SectionSchema);
+exports.validateSection = createValidator(types_10.SectionSchema);
 exports.validateSectionArray = createArrayValidator(exports.validateSection);
-exports.validateLabel = createValidator(types_6.LabelSchema);
+exports.validateLabel = createValidator(types_7.LabelSchema);
 exports.validateLabelArray = createArrayValidator(exports.validateLabel);
 exports.validateComment = createValidator(types_3.CommentSchema);
 exports.validateCommentArray = createArrayValidator(exports.validateComment);
-exports.validateUser = createValidator(types_11.UserSchema);
+exports.validateUser = createValidator(types_12.UserSchema);
 exports.validateUserArray = createArrayValidator(exports.validateUser);
-exports.validateProductivityStats = createValidator(types_7.ProductivityStatsSchema);
-exports.validateCurrentUser = createValidator(types_11.CurrentUserSchema);
+exports.validateProductivityStats = createValidator(types_8.ProductivityStatsSchema);
+exports.validateCurrentUser = createValidator(types_12.CurrentUserSchema);
 exports.validateActivityEvent = createValidator(types_1.ActivityEventSchema);
 exports.validateActivityEventArray = createArrayValidator(exports.validateActivityEvent);
 exports.validateAttachment = createValidator(types_3.AttachmentSchema);
-exports.validateWorkspaceUser = createValidator(types_12.WorkspaceUserSchema);
+exports.validateWorkspaceUser = createValidator(types_13.WorkspaceUserSchema);
 function validateWorkspaceUserArray(input) {
     if (!Array.isArray(input)) {
         throw new Error(`Expected array for workspace users, got ${typeof input}`);
     }
     return input.map(exports.validateWorkspaceUser);
 }
-exports.validateWorkspaceInvitation = createValidator(types_12.WorkspaceInvitationSchema);
+exports.validateWorkspaceInvitation = createValidator(types_13.WorkspaceInvitationSchema);
 exports.validateWorkspaceInvitationArray = createArrayValidator(exports.validateWorkspaceInvitation);
-exports.validateWorkspacePlanDetails = createValidator(types_12.WorkspacePlanDetailsSchema);
-exports.validateJoinWorkspaceResult = createValidator(types_12.JoinWorkspaceResultSchema);
-exports.validateWorkspace = createValidator(types_12.WorkspaceSchema);
+exports.validateWorkspacePlanDetails = createValidator(types_13.WorkspacePlanDetailsSchema);
+exports.validateJoinWorkspaceResult = createValidator(types_13.JoinWorkspaceResultSchema);
+exports.validateWorkspace = createValidator(types_13.WorkspaceSchema);
 exports.validateWorkspaceArray = createArrayValidator(exports.validateWorkspace);
-exports.validateMemberActivityInfo = createValidator(types_12.MemberActivityInfoSchema);
+exports.validateMemberActivityInfo = createValidator(types_13.MemberActivityInfoSchema);
 exports.validateMemberActivityInfoArray = createArrayValidator(exports.validateMemberActivityInfo);
-exports.validateWorkspaceUserTask = createValidator(types_12.WorkspaceUserTaskSchema);
+exports.validateWorkspaceUserTask = createValidator(types_13.WorkspaceUserTaskSchema);
 exports.validateWorkspaceUserTaskArray = createArrayValidator(exports.validateWorkspaceUserTask);
-exports.validateProjectActivityStats = createValidator(types_5.ProjectActivityStatsSchema);
-exports.validateProjectHealth = createValidator(types_5.ProjectHealthSchema);
-exports.validateProjectHealthContext = createValidator(types_5.ProjectHealthContextSchema);
-exports.validateProjectProgress = createValidator(types_5.ProjectProgressSchema);
-exports.validateWorkspaceInsights = createValidator(types_5.WorkspaceInsightsSchema);
+exports.validateProjectActivityStats = createValidator(types_6.ProjectActivityStatsSchema);
+exports.validateProjectHealth = createValidator(types_6.ProjectHealthSchema);
+exports.validateProjectHealthContext = createValidator(types_6.ProjectHealthContextSchema);
+exports.validateProjectProgress = createValidator(types_6.ProjectProgressSchema);
+exports.validateWorkspaceInsights = createValidator(types_6.WorkspaceInsightsSchema);
 exports.validateBackup = createValidator(types_2.BackupSchema);
 exports.validateBackupArray = createArrayValidator(exports.validateBackup);
-exports.validateIdMapping = createValidator(types_4.IdMappingSchema);
+exports.validateIdMapping = createValidator(types_5.IdMappingSchema);
 exports.validateIdMappingArray = createArrayValidator(exports.validateIdMapping);
-exports.validateMovedId = createValidator(types_4.MovedIdSchema);
+exports.validateMovedId = createValidator(types_5.MovedIdSchema);
 exports.validateMovedIdArray = createArrayValidator(exports.validateMovedId);
 // Sync resource validators
 exports.validateFilter = createValidator(resources_1.FilterSchema);
@@ -120,13 +121,13 @@ exports.validateCollaboratorState = createValidator(resources_1.CollaboratorStat
 exports.validateCollaboratorStateArray = createArrayValidator(exports.validateCollaboratorState);
 exports.validateFolder = createValidator(resources_1.FolderSchema);
 exports.validateFolderArray = createArrayValidator(exports.validateFolder);
+exports.validateGoal = createValidator(types_4.GoalSchema);
+exports.validateGoalArray = createArrayValidator(exports.validateGoal);
 exports.validateNote = createValidator(resources_1.NoteSchema);
 exports.validateNoteArray = createArrayValidator(exports.validateNote);
 exports.validateTooltips = createValidator(resources_1.TooltipsSchema);
 exports.validateWorkspaceFilter = createValidator(resources_1.WorkspaceFilterSchema);
 exports.validateWorkspaceFilterArray = createArrayValidator(exports.validateWorkspaceFilter);
-exports.validateGoal = createValidator(resources_1.GoalSchema);
-exports.validateGoalArray = createArrayValidator(exports.validateGoal);
 exports.validateWorkspaceGoal = createValidator(resources_1.WorkspaceGoalSchema);
 exports.validateWorkspaceGoalArray = createArrayValidator(exports.validateWorkspaceGoal);
 exports.validateCalendar = createValidator(resources_1.CalendarSchema);

package/dist/esm/consts/endpoints.js

@@ -67,6 +67,11 @@ export const ENDPOINT_GET_TOKEN = 'access_token';
 export const ENDPOINT_REVOKE = 'revoke';
 export const ENDPOINT_REGISTER = 'register';
 export const ENDPOINT_REST_FOLDERS = 'folders';
+export const ENDPOINT_REST_GOALS = 'goals';
+export const ENDPOINT_REST_GOALS_SEARCH = ENDPOINT_REST_GOALS + '/search';
+export const GOAL_COMPLETE = 'complete';
+export const GOAL_UNCOMPLETE = 'uncomplete';
+export const GOAL_TASKS = 'items';
 // Workspace endpoints
 export const ENDPOINT_REST_WORKSPACES = 'workspaces';
 export const ENDPOINT_WORKSPACE_INVITATIONS = 'workspaces/invitations';

package/dist/esm/todoist-api.js

@@ -10,7 +10,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 import { z } from 'zod';
-import { getSyncBaseUri, ENDPOINT_REST_TASKS, ENDPOINT_REST_TASKS_FILTER, ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE, ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE, ENDPOINT_REST_TASKS_COMPLETED_SEARCH, ENDPOINT_REST_TASKS_COMPLETED, ENDPOINT_REST_TEMPLATES_FILE, ENDPOINT_REST_TEMPLATES_URL, ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID, ENDPOINT_REST_PROJECTS, ENDPOINT_REST_PROJECTS_SEARCH, ENDPOINT_SYNC_QUICK_ADD, ENDPOINT_REST_TASK_CLOSE, ENDPOINT_REST_TASK_REOPEN, ENDPOINT_REST_TASK_MOVE, ENDPOINT_REST_LABELS, ENDPOINT_REST_LABELS_SEARCH, ENDPOINT_REST_PROJECT_COLLABORATORS, ENDPOINT_REST_SECTIONS, ENDPOINT_REST_SECTIONS_SEARCH, ENDPOINT_REST_COMMENTS, ENDPOINT_REST_LOCATION_REMINDERS, ENDPOINT_REST_REMINDERS, ENDPOINT_REST_LABELS_SHARED, ENDPOINT_REST_LABELS_SHARED_RENAME, ENDPOINT_REST_LABELS_SHARED_REMOVE, ENDPOINT_SYNC, PROJECT_ARCHIVE, PROJECT_UNARCHIVE, ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE, ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL, ENDPOINT_REST_PROJECTS_ARCHIVED, ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT, ENDPOINT_REST_PROJECTS_PERMISSIONS, ENDPOINT_REST_PROJECT_FULL, ENDPOINT_REST_PROJECT_JOIN, SECTION_ARCHIVE, SECTION_UNARCHIVE, ENDPOINT_REST_USER, ENDPOINT_REST_PRODUCTIVITY, ENDPOINT_REST_ACTIVITIES, ENDPOINT_REST_UPLOADS, getProjectInsightsActivityStatsEndpoint, getProjectInsightsHealthEndpoint, getProjectInsightsHealthContextEndpoint, getProjectInsightsProgressEndpoint, getProjectInsightsHealthAnalyzeEndpoint, getWorkspaceInsightsEndpoint, ENDPOINT_REST_BACKUPS, ENDPOINT_REST_BACKUPS_DOWNLOAD, ENDPOINT_REST_EMAILS, ENDPOINT_REST_ID_MAPPINGS, ENDPOINT_REST_MOVED_IDS, ENDPOINT_REST_WORKSPACES, ENDPOINT_WORKSPACE_MEMBERS, getWorkspaceUserTasksEndpoint, getWorkspaceInviteUsersEndpoint, getWorkspaceUserEndpoint, ENDPOINT_WORKSPACE_INVITATIONS, ENDPOINT_WORKSPACE_INVITATIONS_ALL, ENDPOINT_WORKSPACE_INVITATIONS_DELETE, getWorkspaceInvitationAcceptEndpoint, getWorkspaceInvitationRejectEndpoint, ENDPOINT_WORKSPACE_JOIN, ENDPOINT_WORKSPACE_LOGO, ENDPOINT_WORKSPACE_PLAN_DETAILS, ENDPOINT_WORKSPACE_USERS, getWorkspaceActiveProjectsEndpoint, getWorkspaceArchivedProjectsEndpoint, ENDPOINT_REST_FOLDERS, } from './consts/endpoints.js';
+import { getSyncBaseUri, ENDPOINT_REST_TASKS, ENDPOINT_REST_TASKS_FILTER, ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE, ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE, ENDPOINT_REST_TASKS_COMPLETED_SEARCH, ENDPOINT_REST_TASKS_COMPLETED, ENDPOINT_REST_TEMPLATES_FILE, ENDPOINT_REST_TEMPLATES_URL, ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID, ENDPOINT_REST_PROJECTS, ENDPOINT_REST_PROJECTS_SEARCH, ENDPOINT_SYNC_QUICK_ADD, ENDPOINT_REST_TASK_CLOSE, ENDPOINT_REST_TASK_REOPEN, ENDPOINT_REST_TASK_MOVE, ENDPOINT_REST_LABELS, ENDPOINT_REST_LABELS_SEARCH, ENDPOINT_REST_PROJECT_COLLABORATORS, ENDPOINT_REST_SECTIONS, ENDPOINT_REST_SECTIONS_SEARCH, ENDPOINT_REST_COMMENTS, ENDPOINT_REST_LOCATION_REMINDERS, ENDPOINT_REST_REMINDERS, ENDPOINT_REST_LABELS_SHARED, ENDPOINT_REST_LABELS_SHARED_RENAME, ENDPOINT_REST_LABELS_SHARED_REMOVE, ENDPOINT_SYNC, PROJECT_ARCHIVE, PROJECT_UNARCHIVE, ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE, ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL, ENDPOINT_REST_PROJECTS_ARCHIVED, ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT, ENDPOINT_REST_PROJECTS_PERMISSIONS, ENDPOINT_REST_PROJECT_FULL, ENDPOINT_REST_PROJECT_JOIN, SECTION_ARCHIVE, SECTION_UNARCHIVE, ENDPOINT_REST_USER, ENDPOINT_REST_PRODUCTIVITY, ENDPOINT_REST_ACTIVITIES, ENDPOINT_REST_UPLOADS, getProjectInsightsActivityStatsEndpoint, getProjectInsightsHealthEndpoint, getProjectInsightsHealthContextEndpoint, getProjectInsightsProgressEndpoint, getProjectInsightsHealthAnalyzeEndpoint, getWorkspaceInsightsEndpoint, ENDPOINT_REST_BACKUPS, ENDPOINT_REST_BACKUPS_DOWNLOAD, ENDPOINT_REST_EMAILS, ENDPOINT_REST_ID_MAPPINGS, ENDPOINT_REST_MOVED_IDS, ENDPOINT_REST_WORKSPACES, ENDPOINT_WORKSPACE_MEMBERS, getWorkspaceUserTasksEndpoint, getWorkspaceInviteUsersEndpoint, getWorkspaceUserEndpoint, ENDPOINT_WORKSPACE_INVITATIONS, ENDPOINT_WORKSPACE_INVITATIONS_ALL, ENDPOINT_WORKSPACE_INVITATIONS_DELETE, getWorkspaceInvitationAcceptEndpoint, getWorkspaceInvitationRejectEndpoint, ENDPOINT_WORKSPACE_JOIN, ENDPOINT_WORKSPACE_LOGO, ENDPOINT_WORKSPACE_PLAN_DETAILS, ENDPOINT_WORKSPACE_USERS, getWorkspaceActiveProjectsEndpoint, getWorkspaceArchivedProjectsEndpoint, ENDPOINT_REST_FOLDERS, ENDPOINT_REST_GOALS, ENDPOINT_REST_GOALS_SEARCH, GOAL_COMPLETE, GOAL_UNCOMPLETE, GOAL_TASKS, } from './consts/endpoints.js';
 import { request, isSuccess } from './transport/http-client.js';
 import { UpdateReminderArgsSchema, UpdateLocationReminderArgsSchema, ReminderIdSchema, } from './types/reminders/index.js';
 import { normalizeObjectEventTypeForApi, denormalizeObjectTypeFromApi, } from './utils/activity-helpers.js';
@@ -18,7 +18,7 @@ import { camelCaseKeys } from './utils/case-conversion.js';
 import { uploadMultipartFile } from './utils/multipart-upload.js';
 import { processTaskContent } from './utils/uncompletable-helpers.js';
 import { formatDateToYYYYMMDD } from './utils/url-helpers.js';
-import { validateAttachment, validateComment, validateCommentArray, validateCurrentUser, validateLabel, validateLabelArray, validateProject, validateProjectArray, validateSection, validateSectionArray, validateTask, validateTaskArray, validateUserArray, validateProductivityStats, validateReminder, validateReminderArray, validateLocationReminderArray, validateActivityEventArray, validateWorkspaceUserArray, validateWorkspaceInvitation, validateWorkspaceInvitationArray, validateWorkspacePlanDetails, validateJoinWorkspaceResult, validateWorkspace, validateWorkspaceArray, validateMemberActivityInfoArray, validateWorkspaceUserTaskArray, validateProjectActivityStats, validateProjectHealth, validateProjectHealthContext, validateProjectProgress, validateWorkspaceInsights, validateBackupArray, validateIdMappingArray, validateMovedIdArray, validateFolder, validateFolderArray, validateCollaboratorArray, validateCollaboratorStateArray, validateNoteArray, validateWorkspaceProject, validateWorkspaceProjectArray, parseSyncResponse, } from './utils/validators.js';
+import { validateAttachment, validateComment, validateCommentArray, validateCurrentUser, validateLabel, validateLabelArray, validateProject, validateProjectArray, validateSection, validateSectionArray, validateTask, validateTaskArray, validateUserArray, validateProductivityStats, validateReminder, validateReminderArray, validateLocationReminderArray, validateActivityEventArray, validateWorkspaceUserArray, validateWorkspaceInvitation, validateWorkspaceInvitationArray, validateWorkspacePlanDetails, validateJoinWorkspaceResult, validateWorkspace, validateWorkspaceArray, validateMemberActivityInfoArray, validateWorkspaceUserTaskArray, validateProjectActivityStats, validateProjectHealth, validateProjectHealthContext, validateProjectProgress, validateWorkspaceInsights, validateBackupArray, validateIdMappingArray, validateMovedIdArray, validateFolder, validateFolderArray, validateGoal, validateGoalArray, validateCollaboratorArray, validateCollaboratorStateArray, validateNoteArray, validateWorkspaceProject, validateWorkspaceProjectArray, parseSyncResponse, } from './utils/validators.js';
 import { v4 as uuidv4 } from 'uuid';
 import { TodoistArgumentError, TodoistRequestError } from './types/index.js';
 import { DATE_FORMAT_TO_API, TIME_FORMAT_TO_API, DAY_OF_WEEK_TO_API, } from './types/sync/index.js';
@@ -1911,6 +1911,134 @@ export class TodoistApi {
         });
         return isSuccess(response);
     }
+    // ── Goals ──
+    async getGoals(args) {
+        const { data: { results, nextCursor }, } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_GOALS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            results: validateGoalArray(results),
+            nextCursor,
+        };
+    }
+    async searchGoals(args) {
+        const { data: { results, nextCursor }, } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_GOALS_SEARCH,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            results: validateGoalArray(results),
+            nextCursor,
+        };
+    }
+    async getGoal(id) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_GOALS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateGoal(response.data);
+    }
+    async addGoal(args, requestId) {
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_GOALS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return validateGoal(response.data);
+    }
+    async updateGoal(id, args, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_GOALS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return validateGoal(response.data);
+    }
+    async deleteGoal(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_GOALS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return isSuccess(response);
+    }
+    async completeGoal(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_GOALS, id, GOAL_COMPLETE),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateGoal(response.data);
+    }
+    async uncompleteGoal(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_GOALS, id, GOAL_UNCOMPLETE),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateGoal(response.data);
+    }
+    async linkTaskToGoal({ goalId, taskId }, requestId) {
+        z.string().parse(goalId);
+        z.string().parse(taskId);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_GOALS, goalId, GOAL_TASKS),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: { itemId: taskId },
+            requestId: requestId,
+        });
+        return validateGoal(response.data);
+    }
+    async unlinkTaskFromGoal({ goalId, taskId }, requestId) {
+        z.string().parse(goalId);
+        z.string().parse(taskId);
+        const response = await request({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_GOALS, goalId, GOAL_TASKS, taskId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return isSuccess(response);
+    }
     // ── Backups ──
     /**
      * Retrieves a list of available backups.

package/dist/esm/types/goals/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+export * from './requests.js';

package/dist/esm/types/goals/requests.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/{sync/resources/goals.js → goals/types.js}

@@ -1,15 +1,12 @@
 import { z } from 'zod';
 /** Available goal owner types. */
 export const GOAL_OWNER_TYPES = ['USER', 'WORKSPACE'];
-export const GoalProgressSchema = z
-    .object({
-    totalItemCount: z.number().int(),
-    completedItemCount: z.number().int(),
+export const GoalProgressSchema = z.looseObject({
+    totalTaskCount: z.number().int(),
+    completedTaskCount: z.number().int(),
     percentage: z.number(),
-})
-    .passthrough();
-export const GoalSchema = z
-    .object({
+});
+export const GoalSchema = z.looseObject({
     id: z.string(),
     ownerType: z.enum(GOAL_OWNER_TYPES),
     ownerId: z.string(),
@@ -26,5 +23,4 @@ export const GoalSchema = z
     creatorUid: z.string(),
     createdAt: z.coerce.date(),
     updatedAt: z.coerce.date(),
-})
-    .passthrough();
+});

package/dist/esm/types/index.js

@@ -9,6 +9,7 @@ export * from './productivity/index.js';
 export * from './activity/index.js';
 export * from './workspaces/index.js';
 export * from './folders/index.js';
+export * from './goals/index.js';
 export * from './insights/index.js';
 export * from './backups/index.js';
 export * from './id-mappings/index.js';

package/dist/esm/types/sync/resources/index.js

@@ -5,7 +5,6 @@ export * from './tooltips.js';
 export * from './notes.js';
 export * from './workspace-filters.js';
 export * from './workspace-goals.js';
-export * from './goals.js';
 export * from './calendars.js';
 export * from './reminders.js';
 export * from './completed-info.js';

package/dist/esm/utils/validators.js

@@ -1,6 +1,7 @@
 import { ActivityEventSchema } from '../types/activity/types.js';
 import { BackupSchema } from '../types/backups/types.js';
 import { AttachmentSchema, CommentSchema } from '../types/comments/types.js';
+import { GoalSchema } from '../types/goals/types.js';
 import { IdMappingSchema, MovedIdSchema } from '../types/id-mappings/types.js';
 import { ProjectActivityStatsSchema, ProjectHealthSchema, ProjectHealthContextSchema, ProjectProgressSchema, WorkspaceInsightsSchema, } from '../types/insights/types.js';
 import { LabelSchema } from '../types/labels/types.js';
@@ -10,7 +11,7 @@ import { SectionSchema } from '../types/sections/types.js';
 import { TaskSchema } from '../types/tasks/types.js';
 import { UserSchema, CurrentUserSchema } from '../types/users/types.js';
 import { WorkspaceUserSchema, WorkspaceInvitationSchema, WorkspacePlanDetailsSchema, JoinWorkspaceResultSchema, WorkspaceSchema, MemberActivityInfoSchema, WorkspaceUserTaskSchema, } from '../types/workspaces/types.js';
-import { FilterSchema, CollaboratorSchema, CollaboratorStateSchema, FolderSchema, NoteSchema, TooltipsSchema, WorkspaceFilterSchema, GoalSchema, WorkspaceGoalSchema, CalendarSchema, CalendarAccountSchema, ReminderSchema, LocationReminderSchema, CompletedInfoSchema, ViewOptionsSchema, ProjectViewOptionsDefaultsSchema, UserPlanLimitsSchema, LiveNotificationSchema, SyncWorkspaceSchema, SyncUserSchema, UserSettingsSchema, SuggestionSchema, } from '../types/sync/resources/index.js';
+import { FilterSchema, CollaboratorSchema, CollaboratorStateSchema, FolderSchema, NoteSchema, TooltipsSchema, WorkspaceFilterSchema, WorkspaceGoalSchema, CalendarSchema, CalendarAccountSchema, ReminderSchema, LocationReminderSchema, CompletedInfoSchema, ViewOptionsSchema, ProjectViewOptionsDefaultsSchema, UserPlanLimitsSchema, LiveNotificationSchema, SyncWorkspaceSchema, SyncUserSchema, UserSettingsSchema, SuggestionSchema, } from '../types/sync/resources/index.js';
 function createValidator(schema) {
     return (input) => schema.parse(input);
 }
@@ -110,13 +111,13 @@ export const validateCollaboratorState = createValidator(CollaboratorStateSchema
 export const validateCollaboratorStateArray = createArrayValidator(validateCollaboratorState);
 export const validateFolder = createValidator(FolderSchema);
 export const validateFolderArray = createArrayValidator(validateFolder);
+export const validateGoal = createValidator(GoalSchema);
+export const validateGoalArray = createArrayValidator(validateGoal);
 export const validateNote = createValidator(NoteSchema);
 export const validateNoteArray = createArrayValidator(validateNote);
 export const validateTooltips = createValidator(TooltipsSchema);
 export const validateWorkspaceFilter = createValidator(WorkspaceFilterSchema);
 export const validateWorkspaceFilterArray = createArrayValidator(validateWorkspaceFilter);
-export const validateGoal = createValidator(GoalSchema);
-export const validateGoalArray = createArrayValidator(validateGoal);
 export const validateWorkspaceGoal = createValidator(WorkspaceGoalSchema);
 export const validateWorkspaceGoalArray = createArrayValidator(validateWorkspaceGoal);
 export const validateCalendar = createValidator(CalendarSchema);

package/dist/types/consts/endpoints.d.ts

@@ -58,6 +58,11 @@ export declare const ENDPOINT_GET_TOKEN = "access_token";
 export declare const ENDPOINT_REVOKE = "revoke";
 export declare const ENDPOINT_REGISTER = "register";
 export declare const ENDPOINT_REST_FOLDERS = "folders";
+export declare const ENDPOINT_REST_GOALS = "goals";
+export declare const ENDPOINT_REST_GOALS_SEARCH: string;
+export declare const GOAL_COMPLETE = "complete";
+export declare const GOAL_UNCOMPLETE = "uncomplete";
+export declare const GOAL_TASKS = "items";
 export declare const ENDPOINT_REST_WORKSPACES = "workspaces";
 export declare const ENDPOINT_WORKSPACE_INVITATIONS = "workspaces/invitations";
 export declare const ENDPOINT_WORKSPACE_INVITATIONS_ALL = "workspaces/invitations/all";

package/dist/types/todoist-api.d.ts

@@ -4,6 +4,7 @@ import { Backup, GetBackupsArgs, DownloadBackupArgs } from './types/backups/inde
 import { Attachment, Comment, AddCommentArgs, UpdateCommentArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetCommentsResponse } from './types/comments/index.js';
 import { GetOrCreateEmailArgs, GetOrCreateEmailResponse, DisableEmailArgs } from './types/emails/index.js';
 import { GetFoldersArgs, GetFoldersResponse, AddFolderArgs, UpdateFolderArgs } from './types/folders/index.js';
+import type { Goal, GetGoalsArgs, GetGoalsResponse, SearchGoalsArgs, AddGoalArgs, UpdateGoalArgs, TaskLinkingArgs } from './types/goals/index.js';
 import { CustomFetch, CustomFetchResponse } from './types/http.js';
 import { IdMapping, MovedId, GetIdMappingsArgs, GetMovedIdsArgs } from './types/id-mappings/index.js';
 import { ProjectActivityStats, ProjectHealth, ProjectHealthContext, ProjectProgress, WorkspaceInsights, GetProjectActivityStatsArgs, GetWorkspaceInsightsArgs } from './types/insights/index.js';
@@ -758,6 +759,16 @@ export declare class TodoistApi {
      * @returns A promise that resolves to `true` if successful.
      */
     deleteFolder(id: string, requestId?: string): Promise<boolean>;
+    getGoals(args?: GetGoalsArgs): Promise<GetGoalsResponse>;
+    searchGoals(args: SearchGoalsArgs): Promise<GetGoalsResponse>;
+    getGoal(id: string): Promise<Goal>;
+    addGoal(args: AddGoalArgs, requestId?: string): Promise<Goal>;
+    updateGoal(id: string, args: UpdateGoalArgs, requestId?: string): Promise<Goal>;
+    deleteGoal(id: string, requestId?: string): Promise<boolean>;
+    completeGoal(id: string, requestId?: string): Promise<Goal>;
+    uncompleteGoal(id: string, requestId?: string): Promise<Goal>;
+    linkTaskToGoal({ goalId, taskId }: TaskLinkingArgs, requestId?: string): Promise<Goal>;
+    unlinkTaskFromGoal({ goalId, taskId }: TaskLinkingArgs, requestId?: string): Promise<boolean>;
     /**
      * Retrieves a list of available backups.
      *

package/dist/types/types/goals/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types.js';
+export * from './requests.js';

package/dist/types/types/goals/requests.d.ts

@@ -0,0 +1,33 @@
+import type { SearchArgs } from '../common.js';
+import type { Workspace } from '../workspaces/index.js';
+import type { Goal, GoalOwnerType } from './types.js';
+export type GetGoalsArgs = {
+    ownerType?: GoalOwnerType;
+    workspaceId?: Workspace['id'];
+    cursor?: string | null;
+    limit?: number;
+};
+export type SearchGoalsArgs = SearchArgs & {
+    ownerType?: GoalOwnerType;
+};
+export type GetGoalsResponse = {
+    results: Goal[];
+    nextCursor: string | null;
+};
+export type AddGoalArgs = {
+    name: string;
+    workspaceId?: string;
+    description?: string | null;
+    deadline?: string | null;
+    responsibleUid?: string | null;
+};
+export type UpdateGoalArgs = {
+    name?: string;
+    description?: string | null;
+    deadline?: string | null;
+    responsibleUid?: string | null;
+};
+export type TaskLinkingArgs = {
+    goalId: string;
+    taskId: string;
+};

package/dist/types/types/{sync/resources/goals.d.ts → goals/types.d.ts}

@@ -4,8 +4,8 @@ export declare const GOAL_OWNER_TYPES: readonly ["USER", "WORKSPACE"];
 /** Goal owner type. */
 export type GoalOwnerType = (typeof GOAL_OWNER_TYPES)[number];
 export declare const GoalProgressSchema: z.ZodObject<{
-    totalItemCount: z.ZodNumber;
-    completedItemCount: z.ZodNumber;
+    totalTaskCount: z.ZodNumber;
+    completedTaskCount: z.ZodNumber;
     percentage: z.ZodNumber;
 }, z.core.$loose>;
 export type GoalProgress = z.infer<typeof GoalProgressSchema>;
@@ -26,12 +26,16 @@ export declare const GoalSchema: z.ZodObject<{
     responsibleUid: z.ZodNullable<z.ZodString>;
     isDeleted: z.ZodBoolean;
     progress: z.ZodOptional<z.ZodObject<{
-        totalItemCount: z.ZodNumber;
-        completedItemCount: z.ZodNumber;
+        totalTaskCount: z.ZodNumber;
+        completedTaskCount: z.ZodNumber;
         percentage: z.ZodNumber;
     }, z.core.$loose>>;
     creatorUid: z.ZodString;
     createdAt: z.ZodCoercedDate<unknown>;
     updatedAt: z.ZodCoercedDate<unknown>;
 }, z.core.$loose>;
+/**
+ * Represents a goal in Todoist.
+ * Goals support dual ownership: personal (ownerType=USER) and workspace (ownerType=WORKSPACE).
+ */
 export type Goal = z.infer<typeof GoalSchema>;

package/dist/types/types/index.d.ts

@@ -9,6 +9,7 @@ export * from './productivity/index.js';
 export * from './activity/index.js';
 export * from './workspaces/index.js';
 export * from './folders/index.js';
+export * from './goals/index.js';
 export * from './insights/index.js';
 export * from './backups/index.js';
 export * from './id-mappings/index.js';

package/dist/types/types/sync/commands/goals.d.ts

@@ -1,4 +1,4 @@
-import type { GoalOwnerType } from '../resources/goals.js';
+import type { GoalOwnerType } from '../../goals/types.js';
 export type GoalAddArgs = {
     ownerType: GoalOwnerType;
     ownerId: string;

package/dist/types/types/sync/resources/index.d.ts

@@ -5,7 +5,6 @@ export * from './tooltips.js';
 export * from './notes.js';
 export * from './workspace-filters.js';
 export * from './workspace-goals.js';
-export * from './goals.js';
 export * from './calendars.js';
 export * from './reminders.js';
 export * from './completed-info.js';

package/dist/types/types/sync/resources/view-options.d.ts

@@ -32,8 +32,8 @@ export declare const GROUPED_BY_OPTIONS: readonly ["ASSIGNEE", "ADDED_DATE", "DU
 /** Field to group tasks by. */
 export type GroupedBy = (typeof GROUPED_BY_OPTIONS)[number];
 export declare const GroupedBySchema: z.ZodNullable<z.ZodEnum<{
-    PROJECT: "PROJECT";
     WORKSPACE: "WORKSPACE";
+    PROJECT: "PROJECT";
     LABEL: "LABEL";
     ASSIGNEE: "ASSIGNEE";
     ADDED_DATE: "ADDED_DATE";
@@ -46,8 +46,8 @@ export declare const SORTED_BY_OPTIONS: readonly ["MANUAL", "ALPHABETICALLY", "A
 /** Field to sort tasks by. */
 export type SortedBy = (typeof SORTED_BY_OPTIONS)[number];
 export declare const SortedBySchema: z.ZodNullable<z.ZodEnum<{
-    PROJECT: "PROJECT";
     WORKSPACE: "WORKSPACE";
+    PROJECT: "PROJECT";
     ASSIGNEE: "ASSIGNEE";
     ADDED_DATE: "ADDED_DATE";
     DUE_DATE: "DUE_DATE";
@@ -92,8 +92,8 @@ export declare const ViewOptionsSchema: z.ZodObject<{
     }>;
     objectId: z.ZodOptional<z.ZodString>;
     groupedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        PROJECT: "PROJECT";
         WORKSPACE: "WORKSPACE";
+        PROJECT: "PROJECT";
         LABEL: "LABEL";
         ASSIGNEE: "ASSIGNEE";
         ADDED_DATE: "ADDED_DATE";
@@ -109,8 +109,8 @@ export declare const ViewOptionsSchema: z.ZodObject<{
     }>>;
     showCompletedTasks: z.ZodOptional<z.ZodBoolean>;
     sortedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        PROJECT: "PROJECT";
         WORKSPACE: "WORKSPACE";
+        PROJECT: "PROJECT";
         ASSIGNEE: "ASSIGNEE";
         ADDED_DATE: "ADDED_DATE";
         DUE_DATE: "DUE_DATE";
@@ -133,8 +133,8 @@ export declare const ProjectViewOptionsDefaultsSchema: z.ZodObject<{
         CALENDAR: "CALENDAR";
     }>>>;
     groupedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        PROJECT: "PROJECT";
         WORKSPACE: "WORKSPACE";
+        PROJECT: "PROJECT";
         LABEL: "LABEL";
         ASSIGNEE: "ASSIGNEE";
         ADDED_DATE: "ADDED_DATE";
@@ -143,8 +143,8 @@ export declare const ProjectViewOptionsDefaultsSchema: z.ZodObject<{
         PRIORITY: "PRIORITY";
     }>>>;
     sortedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        PROJECT: "PROJECT";
         WORKSPACE: "WORKSPACE";
+        PROJECT: "PROJECT";
         ASSIGNEE: "ASSIGNEE";
         ADDED_DATE: "ADDED_DATE";
         DUE_DATE: "DUE_DATE";

package/dist/types/types/sync/response.d.ts

@@ -1,9 +1,10 @@
+import type { Goal } from '../goals/types.js';
 import type { Label } from '../labels/types.js';
 import type { PersonalProject, WorkspaceProject } from '../projects/types.js';
 import type { Section } from '../sections/types.js';
 import type { Task } from '../tasks/types.js';
 import type { WorkspaceUser } from '../workspaces/types.js';
-import type { Filter, Collaborator, CollaboratorState, Folder, Note, Tooltips, WorkspaceFilter, WorkspaceGoal, Goal, Calendar, CalendarAccount, Reminder, CompletedInfo, ViewOptions, ProjectViewOptionsDefaults, UserPlanLimits, LiveNotification, SyncWorkspace, SyncUser, UserSettings, LocationReminder, Suggestion } from './resources/index.js';
+import type { Filter, Collaborator, CollaboratorState, Folder, Note, Tooltips, WorkspaceFilter, WorkspaceGoal, Calendar, CalendarAccount, Reminder, CompletedInfo, ViewOptions, ProjectViewOptionsDefaults, UserPlanLimits, LiveNotification, SyncWorkspace, SyncUser, UserSettings, LocationReminder, Suggestion } from './resources/index.js';
 export type SyncError = {
     error: string;
     errorCode: number;

package/dist/types/types/tasks/requests.d.ts

@@ -36,6 +36,7 @@ export type GetTasksArgs = {
     parentId?: string;
     label?: string;
     ids?: string[];
+    goalId?: string;
     cursor?: string | null;
     limit?: number;
 };

package/dist/types/utils/validators.d.ts

@@ -745,6 +745,54 @@ export declare const validateFolderArray: (input: unknown) => {
     defaultOrder: number;
     childOrder: number;
 }[];
+export declare const validateGoal: (input: unknown) => {
+    [x: string]: unknown;
+    id: string;
+    ownerType: "USER" | "WORKSPACE";
+    ownerId: string;
+    name: string;
+    description: string | null;
+    deadline: string | null;
+    parentGoalId: string | null;
+    childOrder: number;
+    isCompleted: boolean;
+    completedAt: Date | null;
+    responsibleUid: string | null;
+    isDeleted: boolean;
+    creatorUid: string;
+    createdAt: Date;
+    updatedAt: Date;
+    progress?: {
+        [x: string]: unknown;
+        totalTaskCount: number;
+        completedTaskCount: number;
+        percentage: number;
+    } | undefined;
+};
+export declare const validateGoalArray: (input: unknown) => {
+    [x: string]: unknown;
+    id: string;
+    ownerType: "USER" | "WORKSPACE";
+    ownerId: string;
+    name: string;
+    description: string | null;
+    deadline: string | null;
+    parentGoalId: string | null;
+    childOrder: number;
+    isCompleted: boolean;
+    completedAt: Date | null;
+    responsibleUid: string | null;
+    isDeleted: boolean;
+    creatorUid: string;
+    createdAt: Date;
+    updatedAt: Date;
+    progress?: {
+        [x: string]: unknown;
+        totalTaskCount: number;
+        completedTaskCount: number;
+        percentage: number;
+    } | undefined;
+}[];
 export declare const validateNote: (input: unknown) => {
     [x: string]: unknown;
     id: string;
@@ -834,54 +882,6 @@ export declare const validateWorkspaceFilterArray: (input: unknown) => {
     createdAt: string;
     updatedAt: string;
 }[];
-export declare const validateGoal: (input: unknown) => {
-    [x: string]: unknown;
-    id: string;
-    ownerType: "USER" | "WORKSPACE";
-    ownerId: string;
-    name: string;
-    description: string | null;
-    deadline: string | null;
-    parentGoalId: string | null;
-    childOrder: number;
-    isCompleted: boolean;
-    completedAt: Date | null;
-    responsibleUid: string | null;
-    isDeleted: boolean;
-    creatorUid: string;
-    createdAt: Date;
-    updatedAt: Date;
-    progress?: {
-        [x: string]: unknown;
-        totalItemCount: number;
-        completedItemCount: number;
-        percentage: number;
-    } | undefined;
-};
-export declare const validateGoalArray: (input: unknown) => {
-    [x: string]: unknown;
-    id: string;
-    ownerType: "USER" | "WORKSPACE";
-    ownerId: string;
-    name: string;
-    description: string | null;
-    deadline: string | null;
-    parentGoalId: string | null;
-    childOrder: number;
-    isCompleted: boolean;
-    completedAt: Date | null;
-    responsibleUid: string | null;
-    isDeleted: boolean;
-    creatorUid: string;
-    createdAt: Date;
-    updatedAt: Date;
-    progress?: {
-        [x: string]: unknown;
-        totalItemCount: number;
-        completedItemCount: number;
-        percentage: number;
-    } | undefined;
-}[];
 export declare const validateWorkspaceGoal: (input: unknown) => {
     [x: string]: unknown;
     id: string;
@@ -1122,30 +1122,30 @@ export declare const validateViewOptions: (input: unknown) => {
     [x: string]: unknown;
     viewType: "PROJECT" | "TODAY" | "UPCOMING" | "LABEL" | "FILTER" | "WORKSPACE_FILTER" | "SEARCH" | "TEMPLATE_PREVIEW" | "TASK_DETAIL" | "AUTOMATION" | "ASSIGNED" | "OVERDUE" | "WORKSPACE_OVERVIEW";
     objectId?: string | undefined;
-    groupedBy?: "PROJECT" | "WORKSPACE" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | null | undefined;
+    groupedBy?: "WORKSPACE" | "PROJECT" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | null | undefined;
     filteredBy?: string | null | undefined;
     viewMode?: "LIST" | "BOARD" | "CALENDAR" | undefined;
     showCompletedTasks?: boolean | undefined;
-    sortedBy?: "PROJECT" | "WORKSPACE" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
+    sortedBy?: "WORKSPACE" | "PROJECT" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
     sortOrder?: "ASC" | "DESC" | null | undefined;
 };
 export declare const validateViewOptionsArray: (input: unknown) => {
     [x: string]: unknown;
     viewType: "PROJECT" | "TODAY" | "UPCOMING" | "LABEL" | "FILTER" | "WORKSPACE_FILTER" | "SEARCH" | "TEMPLATE_PREVIEW" | "TASK_DETAIL" | "AUTOMATION" | "ASSIGNED" | "OVERDUE" | "WORKSPACE_OVERVIEW";
     objectId?: string | undefined;
-    groupedBy?: "PROJECT" | "WORKSPACE" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | null | undefined;
+    groupedBy?: "WORKSPACE" | "PROJECT" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | null | undefined;
     filteredBy?: string | null | undefined;
     viewMode?: "LIST" | "BOARD" | "CALENDAR" | undefined;
     showCompletedTasks?: boolean | undefined;
-    sortedBy?: "PROJECT" | "WORKSPACE" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
+    sortedBy?: "WORKSPACE" | "PROJECT" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
     sortOrder?: "ASC" | "DESC" | null | undefined;
 }[];
 export declare const validateProjectViewOptionsDefaults: (input: unknown) => {
     [x: string]: unknown;
     projectId: string;
     viewMode?: "LIST" | "BOARD" | "CALENDAR" | null | undefined;
-    groupedBy?: "PROJECT" | "WORKSPACE" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | null | undefined;
-    sortedBy?: "PROJECT" | "WORKSPACE" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
+    groupedBy?: "WORKSPACE" | "PROJECT" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | null | undefined;
+    sortedBy?: "WORKSPACE" | "PROJECT" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
     sortOrder?: "ASC" | "DESC" | null | undefined;
     showCompletedTasks?: boolean | undefined;
     filteredBy?: string | null | undefined;
@@ -1158,8 +1158,8 @@ export declare const validateProjectViewOptionsDefaultsArray: (input: unknown) =
     [x: string]: unknown;
     projectId: string;
     viewMode?: "LIST" | "BOARD" | "CALENDAR" | null | undefined;
-    groupedBy?: "PROJECT" | "WORKSPACE" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | null | undefined;
-    sortedBy?: "PROJECT" | "WORKSPACE" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
+    groupedBy?: "WORKSPACE" | "PROJECT" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | null | undefined;
+    sortedBy?: "WORKSPACE" | "PROJECT" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
     sortOrder?: "ASC" | "DESC" | null | undefined;
     showCompletedTasks?: boolean | undefined;
     filteredBy?: string | null | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-sdk",
-    "version": "8.4.0-next.1",
+    "version": "8.4.0-next.2",
     "description": "The official TypeScript SDK for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "https://github.com/Doist/todoist-sdk-typescript",