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

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';
@@ -1916,6 +1916,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/goals/types.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+/** Available goal owner types. */
+export const GOAL_OWNER_TYPES = ['USER', 'WORKSPACE'];
+export const GoalProgressSchema = z.looseObject({
+    totalTaskCount: z.number().int(),
+    completedTaskCount: z.number().int(),
+    percentage: z.number(),
+});
+export const GoalSchema = z.looseObject({
+    id: z.string(),
+    ownerType: z.enum(GOAL_OWNER_TYPES),
+    ownerId: z.string(),
+    name: z.string(),
+    description: z.string().nullable(),
+    deadline: z.string().nullable(),
+    parentGoalId: z.string().nullable(),
+    childOrder: z.number().int(),
+    isCompleted: z.boolean(),
+    completedAt: z.coerce.date().nullable(),
+    responsibleUid: z.string().nullable(),
+    isDeleted: z.boolean(),
+    progress: GoalProgressSchema.optional(),
+    creatorUid: z.string(),
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+});

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/projects/types.js

@@ -49,5 +49,15 @@ export const WorkspaceProjectSchema = BaseProjectSchema.extend({
 }).transform((data) => {
     return Object.assign(Object.assign({}, data), { url: getProjectUrl(data.id, data.name) });
 });
+/**
+ * Schema for any project type in Todoist (personal or workspace).
+ * Dispatches to WorkspaceProjectSchema when workspaceId is present, PersonalProjectSchema otherwise.
+ */
+export const ProjectSchema = z.unknown().transform((val) => {
+    if (typeof val === 'object' && val !== null && 'workspaceId' in val) {
+        return WorkspaceProjectSchema.parse(val);
+    }
+    return PersonalProjectSchema.parse(val);
+});
 /** Available project view styles. */
 export const PROJECT_VIEW_STYLES = ['list', 'board', 'calendar'];

package/dist/esm/types/sync/commands/goals.js

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

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

@@ -11,6 +11,7 @@ export * from './workspaces.js';
 export * from './folders.js';
 export * from './workspace-filters.js';
 export * from './workspace-goals.js';
+export * from './goals.js';
 export * from './notifications.js';
 export * from './sharing.js';
 export * from './view-options.js';

package/dist/esm/types/sync/resource-types.js

@@ -29,6 +29,7 @@ export const SYNC_RESOURCE_TYPES = [
     'role_actions',
     'folders',
     'workspace_goals',
+    'goals',
     'day_orders',
     'calendars',
     'calendar_accounts',

package/dist/esm/types/sync/response.js

@@ -1 +1,54 @@
-export {};
+import { z } from 'zod';
+import { GoalSchema } from '../goals/types.js';
+import { LabelSchema } from '../labels/types.js';
+import { ProjectSchema } from '../projects/types.js';
+import { SectionSchema } from '../sections/types.js';
+import { TaskSchema } from '../tasks/types.js';
+import { WorkspaceUserSchema } from '../workspaces/types.js';
+import { FilterSchema, CollaboratorSchema, CollaboratorStateSchema, FolderSchema, NoteSchema, TooltipsSchema, WorkspaceFilterSchema, WorkspaceGoalSchema, CalendarSchema, CalendarAccountSchema, ReminderSchema, LocationReminderSchema, CompletedInfoSchema, ViewOptionsSchema, ProjectViewOptionsDefaultsSchema, UserPlanLimitsSchema, LiveNotificationSchema, SyncWorkspaceSchema, SyncUserSchema, UserSettingsSchema, SuggestionSchema, } from './resources/index.js';
+export const SyncErrorSchema = z.object({
+    error: z.string(),
+    errorCode: z.number(),
+    errorExtra: z.record(z.string(), z.unknown()),
+    errorTag: z.string(),
+    httpCode: z.number(),
+});
+export const SyncResponseSchema = z.looseObject({
+    syncToken: z.string().optional(),
+    fullSync: z.boolean().optional(),
+    syncStatus: z.record(z.string(), z.union([z.literal('ok'), SyncErrorSchema])).optional(),
+    tempIdMapping: z.record(z.string(), z.string()).optional(),
+    items: z.array(TaskSchema).optional(),
+    projects: z.array(ProjectSchema).optional(),
+    sections: z.array(SectionSchema).optional(),
+    labels: z.array(LabelSchema).optional(),
+    notes: z.array(NoteSchema).optional(),
+    projectNotes: z.array(NoteSchema).optional(),
+    filters: z.array(FilterSchema).optional(),
+    reminders: z.array(ReminderSchema).optional(),
+    remindersLocation: z.array(LocationReminderSchema).optional(),
+    locations: z.array(z.record(z.string(), z.unknown())).optional(),
+    user: SyncUserSchema.optional(),
+    liveNotifications: z.array(LiveNotificationSchema).optional(),
+    collaborators: z.array(CollaboratorSchema).optional(),
+    collaboratorStates: z.array(CollaboratorStateSchema).optional(),
+    userSettings: UserSettingsSchema.optional(),
+    notificationSettings: z.record(z.string(), z.boolean()).optional(),
+    userPlanLimits: UserPlanLimitsSchema.optional(),
+    completedInfo: z.array(CompletedInfoSchema).optional(),
+    stats: z.record(z.string(), z.unknown()).optional(),
+    workspaces: z.array(SyncWorkspaceSchema).optional(),
+    workspaceUsers: z.array(WorkspaceUserSchema).optional(),
+    workspaceFilters: z.array(WorkspaceFilterSchema).optional(),
+    viewOptions: z.array(ViewOptionsSchema).optional(),
+    projectViewOptionsDefaults: z.array(ProjectViewOptionsDefaultsSchema).optional(),
+    roleActions: z.array(z.record(z.string(), z.unknown())).optional(),
+    folders: z.array(FolderSchema).optional(),
+    goals: z.array(GoalSchema).optional(),
+    workspaceGoals: z.array(WorkspaceGoalSchema).optional(),
+    dayOrders: z.record(z.string(), z.number()).optional(),
+    calendars: z.array(CalendarSchema).optional(),
+    calendarAccounts: z.array(CalendarAccountSchema).optional(),
+    suggestions: z.array(SuggestionSchema).optional(),
+    tooltips: TooltipsSchema.optional(),
+});

package/dist/esm/utils/validators.js

@@ -1,153 +1,80 @@
+import { z } from 'zod';
 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';
 import { ProductivityStatsSchema } from '../types/productivity/types.js';
-import { PersonalProjectSchema, WorkspaceProjectSchema, } from '../types/projects/types.js';
+import { WorkspaceProjectSchema, ProjectSchema } from '../types/projects/types.js';
 import { SectionSchema } from '../types/sections/types.js';
+import { SyncResponseSchema } from '../types/sync/response.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, 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);
-}
-function createArrayValidator(validateItem) {
-    return (input) => {
-        if (!Array.isArray(input)) {
-            throw new TypeError(`Expected array, got ${typeof input}`);
-        }
-        return input.map(validateItem);
+    return {
+        validate: (input) => schema.parse(input),
+        validateArray: (input) => z.array(schema).parse(input),
     };
 }
 // Entity validators
-export const validateTask = createValidator(TaskSchema);
-export const validateTaskArray = createArrayValidator(validateTask);
+export const { validate: validateTask, validateArray: validateTaskArray } = createValidator(TaskSchema);
 /**
  * Validates and parses a project input.
  * @param input The input to validate
  * @returns A validated project (either PersonalProject or WorkspaceProject)
  */
-export function validateProject(input) {
-    if ('workspaceId' in input) {
-        return WorkspaceProjectSchema.parse(input);
-    }
-    return PersonalProjectSchema.parse(input);
-}
-export function validateProjectArray(input) {
-    if (!Array.isArray(input)) {
-        throw new TypeError(`Expected array, got ${typeof input}`);
-    }
-    return input.map(validateProject);
-}
-export const validateWorkspaceProject = createValidator(WorkspaceProjectSchema);
-export const validateWorkspaceProjectArray = createArrayValidator(validateWorkspaceProject);
-export const validateSection = createValidator(SectionSchema);
-export const validateSectionArray = createArrayValidator(validateSection);
-export const validateLabel = createValidator(LabelSchema);
-export const validateLabelArray = createArrayValidator(validateLabel);
-export const validateComment = createValidator(CommentSchema);
-export const validateCommentArray = createArrayValidator(validateComment);
-export const validateUser = createValidator(UserSchema);
-export const validateUserArray = createArrayValidator(validateUser);
-export const validateProductivityStats = createValidator(ProductivityStatsSchema);
-export const validateCurrentUser = createValidator(CurrentUserSchema);
-export const validateActivityEvent = createValidator(ActivityEventSchema);
-export const validateActivityEventArray = createArrayValidator(validateActivityEvent);
-export const validateAttachment = createValidator(AttachmentSchema);
-export const validateWorkspaceUser = createValidator(WorkspaceUserSchema);
-export function validateWorkspaceUserArray(input) {
-    if (!Array.isArray(input)) {
-        throw new Error(`Expected array for workspace users, got ${typeof input}`);
-    }
-    return input.map(validateWorkspaceUser);
-}
-export const validateWorkspaceInvitation = createValidator(WorkspaceInvitationSchema);
-export const validateWorkspaceInvitationArray = createArrayValidator(validateWorkspaceInvitation);
-export const validateWorkspacePlanDetails = createValidator(WorkspacePlanDetailsSchema);
-export const validateJoinWorkspaceResult = createValidator(JoinWorkspaceResultSchema);
-export const validateWorkspace = createValidator(WorkspaceSchema);
-export const validateWorkspaceArray = createArrayValidator(validateWorkspace);
-export const validateMemberActivityInfo = createValidator(MemberActivityInfoSchema);
-export const validateMemberActivityInfoArray = createArrayValidator(validateMemberActivityInfo);
-export const validateWorkspaceUserTask = createValidator(WorkspaceUserTaskSchema);
-export const validateWorkspaceUserTaskArray = createArrayValidator(validateWorkspaceUserTask);
-export const validateProjectActivityStats = createValidator(ProjectActivityStatsSchema);
-export const validateProjectHealth = createValidator(ProjectHealthSchema);
-export const validateProjectHealthContext = createValidator(ProjectHealthContextSchema);
-export const validateProjectProgress = createValidator(ProjectProgressSchema);
-export const validateWorkspaceInsights = createValidator(WorkspaceInsightsSchema);
-export const validateBackup = createValidator(BackupSchema);
-export const validateBackupArray = createArrayValidator(validateBackup);
-export const validateIdMapping = createValidator(IdMappingSchema);
-export const validateIdMappingArray = createArrayValidator(validateIdMapping);
-export const validateMovedId = createValidator(MovedIdSchema);
-export const validateMovedIdArray = createArrayValidator(validateMovedId);
+export const { validate: validateProject, validateArray: validateProjectArray } = createValidator(ProjectSchema);
+export const { validate: validateWorkspaceProject, validateArray: validateWorkspaceProjectArray } = createValidator(WorkspaceProjectSchema);
+export const { validate: validateSection, validateArray: validateSectionArray } = createValidator(SectionSchema);
+export const { validate: validateLabel, validateArray: validateLabelArray } = createValidator(LabelSchema);
+export const { validate: validateComment, validateArray: validateCommentArray } = createValidator(CommentSchema);
+export const { validate: validateUser, validateArray: validateUserArray } = createValidator(UserSchema);
+export const { validate: validateProductivityStats } = createValidator(ProductivityStatsSchema);
+export const { validate: validateCurrentUser } = createValidator(CurrentUserSchema);
+export const { validate: validateActivityEvent, validateArray: validateActivityEventArray } = createValidator(ActivityEventSchema);
+export const { validate: validateAttachment } = createValidator(AttachmentSchema);
+export const { validate: validateWorkspaceUser, validateArray: validateWorkspaceUserArray } = createValidator(WorkspaceUserSchema);
+export const { validate: validateWorkspaceInvitation, validateArray: validateWorkspaceInvitationArray, } = createValidator(WorkspaceInvitationSchema);
+export const { validate: validateWorkspacePlanDetails } = createValidator(WorkspacePlanDetailsSchema);
+export const { validate: validateJoinWorkspaceResult } = createValidator(JoinWorkspaceResultSchema);
+export const { validate: validateWorkspace, validateArray: validateWorkspaceArray } = createValidator(WorkspaceSchema);
+export const { validate: validateMemberActivityInfo, validateArray: validateMemberActivityInfoArray, } = createValidator(MemberActivityInfoSchema);
+export const { validate: validateWorkspaceUserTask, validateArray: validateWorkspaceUserTaskArray, } = createValidator(WorkspaceUserTaskSchema);
+export const { validate: validateProjectActivityStats } = createValidator(ProjectActivityStatsSchema);
+export const { validate: validateProjectHealth } = createValidator(ProjectHealthSchema);
+export const { validate: validateProjectHealthContext } = createValidator(ProjectHealthContextSchema);
+export const { validate: validateProjectProgress } = createValidator(ProjectProgressSchema);
+export const { validate: validateWorkspaceInsights } = createValidator(WorkspaceInsightsSchema);
+export const { validate: validateBackup, validateArray: validateBackupArray } = createValidator(BackupSchema);
+export const { validate: validateIdMapping, validateArray: validateIdMappingArray } = createValidator(IdMappingSchema);
+export const { validate: validateMovedId, validateArray: validateMovedIdArray } = createValidator(MovedIdSchema);
 // Sync resource validators
-export const validateFilter = createValidator(FilterSchema);
-export const validateFilterArray = createArrayValidator(validateFilter);
-export const validateCollaborator = createValidator(CollaboratorSchema);
-export const validateCollaboratorArray = createArrayValidator(validateCollaborator);
-export const validateCollaboratorState = createValidator(CollaboratorStateSchema);
-export const validateCollaboratorStateArray = createArrayValidator(validateCollaboratorState);
-export const validateFolder = createValidator(FolderSchema);
-export const validateFolderArray = createArrayValidator(validateFolder);
-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 validateWorkspaceGoal = createValidator(WorkspaceGoalSchema);
-export const validateWorkspaceGoalArray = createArrayValidator(validateWorkspaceGoal);
-export const validateCalendar = createValidator(CalendarSchema);
-export const validateCalendarArray = createArrayValidator(validateCalendar);
-export const validateCalendarAccount = createValidator(CalendarAccountSchema);
-export const validateCalendarAccountArray = createArrayValidator(validateCalendarAccount);
-export const validateReminder = createValidator(ReminderSchema);
-export const validateReminderArray = createArrayValidator(validateReminder);
-export const validateLocationReminder = createValidator(LocationReminderSchema);
-export const validateLocationReminderArray = createArrayValidator(validateLocationReminder);
-export const validateCompletedInfo = createValidator(CompletedInfoSchema);
-export const validateCompletedInfoArray = createArrayValidator(validateCompletedInfo);
-export const validateViewOptions = createValidator(ViewOptionsSchema);
-export const validateViewOptionsArray = createArrayValidator(validateViewOptions);
-export const validateProjectViewOptionsDefaults = createValidator(ProjectViewOptionsDefaultsSchema);
-export const validateProjectViewOptionsDefaultsArray = createArrayValidator(validateProjectViewOptionsDefaults);
-export const validateUserPlanLimits = createValidator(UserPlanLimitsSchema);
-export const validateLiveNotification = createValidator(LiveNotificationSchema);
-export const validateLiveNotificationArray = createArrayValidator(validateLiveNotification);
-export const validateSyncWorkspace = createValidator(SyncWorkspaceSchema);
-export const validateSyncWorkspaceArray = createArrayValidator(validateSyncWorkspace);
-export const validateSyncUser = createValidator(SyncUserSchema);
-export const validateUserSettings = createValidator(UserSettingsSchema);
-export const validateSuggestion = createValidator(SuggestionSchema);
-export const validateSuggestionArray = createArrayValidator(validateSuggestion);
+export const { validate: validateFilter, validateArray: validateFilterArray } = createValidator(FilterSchema);
+export const { validate: validateCollaborator, validateArray: validateCollaboratorArray } = createValidator(CollaboratorSchema);
+export const { validate: validateCollaboratorState, validateArray: validateCollaboratorStateArray, } = createValidator(CollaboratorStateSchema);
+export const { validate: validateFolder, validateArray: validateFolderArray } = createValidator(FolderSchema);
+export const { validate: validateGoal, validateArray: validateGoalArray } = createValidator(GoalSchema);
+export const { validate: validateNote, validateArray: validateNoteArray } = createValidator(NoteSchema);
+export const { validate: validateTooltips } = createValidator(TooltipsSchema);
+export const { validate: validateWorkspaceFilter, validateArray: validateWorkspaceFilterArray } = createValidator(WorkspaceFilterSchema);
+export const { validate: validateWorkspaceGoal, validateArray: validateWorkspaceGoalArray } = createValidator(WorkspaceGoalSchema);
+export const { validate: validateCalendar, validateArray: validateCalendarArray } = createValidator(CalendarSchema);
+export const { validate: validateCalendarAccount, validateArray: validateCalendarAccountArray } = createValidator(CalendarAccountSchema);
+export const { validate: validateReminder, validateArray: validateReminderArray } = createValidator(ReminderSchema);
+export const { validate: validateLocationReminder, validateArray: validateLocationReminderArray } = createValidator(LocationReminderSchema);
+export const { validate: validateCompletedInfo, validateArray: validateCompletedInfoArray } = createValidator(CompletedInfoSchema);
+export const { validate: validateViewOptions, validateArray: validateViewOptionsArray } = createValidator(ViewOptionsSchema);
+export const { validate: validateProjectViewOptionsDefaults, validateArray: validateProjectViewOptionsDefaultsArray, } = createValidator(ProjectViewOptionsDefaultsSchema);
+export const { validate: validateUserPlanLimits } = createValidator(UserPlanLimitsSchema);
+export const { validate: validateLiveNotification, validateArray: validateLiveNotificationArray } = createValidator(LiveNotificationSchema);
+export const { validate: validateSyncWorkspace, validateArray: validateSyncWorkspaceArray } = createValidator(SyncWorkspaceSchema);
+export const { validate: validateSyncUser } = createValidator(SyncUserSchema);
+export const { validate: validateUserSettings } = createValidator(UserSettingsSchema);
+export const { validate: validateSuggestion, validateArray: validateSuggestionArray } = createValidator(SuggestionSchema);
 export function parseSyncResponse(raw) {
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, raw), ('items' in raw ? { items: validateTaskArray(raw.items) } : {})), ('projects' in raw ? { projects: validateProjectArray(raw.projects) } : {})), ('sections' in raw ? { sections: validateSectionArray(raw.sections) } : {})), ('labels' in raw ? { labels: validateLabelArray(raw.labels) } : {})), ('notes' in raw ? { notes: validateNoteArray(raw.notes) } : {})), ('projectNotes' in raw ? { projectNotes: validateNoteArray(raw.projectNotes) } : {})), ('filters' in raw ? { filters: validateFilterArray(raw.filters) } : {})), ('reminders' in raw ? { reminders: validateReminderArray(raw.reminders) } : {})), ('remindersLocation' in raw
-        ? { remindersLocation: validateLocationReminderArray(raw.remindersLocation) }
-        : {})), ('user' in raw ? { user: validateSyncUser(raw.user) } : {})), ('liveNotifications' in raw
-        ? { liveNotifications: validateLiveNotificationArray(raw.liveNotifications) }
-        : {})), ('collaborators' in raw
-        ? { collaborators: validateCollaboratorArray(raw.collaborators) }
-        : {})), ('collaboratorStates' in raw
-        ? { collaboratorStates: validateCollaboratorStateArray(raw.collaboratorStates) }
-        : {})), ('userSettings' in raw ? { userSettings: validateUserSettings(raw.userSettings) } : {})), ('userPlanLimits' in raw
-        ? { userPlanLimits: validateUserPlanLimits(raw.userPlanLimits) }
-        : {})), ('completedInfo' in raw
-        ? { completedInfo: validateCompletedInfoArray(raw.completedInfo) }
-        : {})), ('workspaces' in raw ? { workspaces: validateSyncWorkspaceArray(raw.workspaces) } : {})), ('workspaceUsers' in raw
-        ? { workspaceUsers: validateWorkspaceUserArray(raw.workspaceUsers) }
-        : {})), ('workspaceFilters' in raw
-        ? { workspaceFilters: validateWorkspaceFilterArray(raw.workspaceFilters) }
-        : {})), ('viewOptions' in raw ? { viewOptions: validateViewOptionsArray(raw.viewOptions) } : {})), ('projectViewOptionsDefaults' in raw
-        ? {
-            projectViewOptionsDefaults: validateProjectViewOptionsDefaultsArray(raw.projectViewOptionsDefaults),
-        }
-        : {})), ('folders' in raw ? { folders: validateFolderArray(raw.folders) } : {})), ('workspaceGoals' in raw
-        ? { workspaceGoals: validateWorkspaceGoalArray(raw.workspaceGoals) }
-        : {})), ('calendars' in raw ? { calendars: validateCalendarArray(raw.calendars) } : {})), ('calendarAccounts' in raw
-        ? { calendarAccounts: validateCalendarAccountArray(raw.calendarAccounts) }
-        : {})), ('suggestions' in raw ? { suggestions: validateSuggestionArray(raw.suggestions) } : {})), ('tooltips' in raw ? { tooltips: validateTooltips(raw.tooltips) } : {}));
+    return SyncResponseSchema.parse(raw);
 }

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';
@@ -763,6 +764,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/goals/types.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/** Available goal owner types. */
+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<{
+    totalTaskCount: z.ZodNumber;
+    completedTaskCount: z.ZodNumber;
+    percentage: z.ZodNumber;
+}, z.core.$loose>;
+export type GoalProgress = z.infer<typeof GoalProgressSchema>;
+export declare const GoalSchema: z.ZodObject<{
+    id: z.ZodString;
+    ownerType: z.ZodEnum<{
+        USER: "USER";
+        WORKSPACE: "WORKSPACE";
+    }>;
+    ownerId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    deadline: z.ZodNullable<z.ZodString>;
+    parentGoalId: z.ZodNullable<z.ZodString>;
+    childOrder: z.ZodNumber;
+    isCompleted: z.ZodBoolean;
+    completedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+    responsibleUid: z.ZodNullable<z.ZodString>;
+    isDeleted: z.ZodBoolean;
+    progress: z.ZodOptional<z.ZodObject<{
+        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>;