@doist/todoist-api-typescript 7.4.0 → 7.6.0

package/dist/esm/todoist-api.js

@@ -9,17 +9,21 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
-import { request, isSuccess } from './rest-client.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_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_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_USER, ENDPOINT_REST_PRODUCTIVITY, ENDPOINT_REST_ACTIVITIES, ENDPOINT_REST_UPLOADS, 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, } from './consts/endpoints.js';
-import { validateAttachment, validateComment, validateCommentArray, validateCurrentUser, validateLabel, validateLabelArray, validateProject, validateProjectArray, validateSection, validateSectionArray, validateTask, validateTaskArray, validateUserArray, validateProductivityStats, validateActivityEventArray, validateWorkspaceUserArray, validateWorkspaceInvitation, validateWorkspaceInvitationArray, validateWorkspacePlanDetails, validateJoinWorkspaceResult, validateWorkspaceArray, } from './utils/validators.js';
+import { DueDateSchema, } from './types/entities.js';
+import { LOCATION_TRIGGERS } from './types/sync/resources/reminders.js';
+import { REMINDER_DELIVERY_SERVICES, } from './types/requests.js';
+import { request, isSuccess } from './transport/http-client.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, } from './consts/endpoints.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, } from './utils/validators.js';
 import { formatDateToYYYYMMDD } from './utils/url-helpers.js';
 import { uploadMultipartFile } from './utils/multipart-upload.js';
+import { camelCaseKeys } from './utils/case-conversion.js';
 import { normalizeObjectEventTypeForApi, denormalizeObjectTypeFromApi, } from './utils/activity-helpers.js';
 import { processTaskContent } from './utils/uncompletable-helpers.js';
 import { z } from 'zod';
 import { v4 as uuidv4 } from 'uuid';
 import { DATE_FORMAT_TO_API, TIME_FORMAT_TO_API, DAY_OF_WEEK_TO_API, } from './types/sync/index.js';
-import { TodoistRequestError } from './types/index.js';
+import { TodoistArgumentError, TodoistRequestError } from './types/index.js';
 const MAX_COMMAND_COUNT = 100;
 /**
  * Joins path segments using `/` separator.
@@ -80,6 +84,56 @@ function headersToRecord(headers) {
     });
     return result;
 }
+const ReminderDeliveryServiceSchema = z.enum(REMINDER_DELIVERY_SERVICES);
+const ReminderIdSchema = z.string();
+const ReminderDueDateSchema = DueDateSchema.pick({
+    date: true,
+    string: true,
+    timezone: true,
+    lang: true,
+    isRecurring: true,
+})
+    .partial()
+    .strict();
+const UpdateRelativeReminderArgsSchema = z
+    .object({
+    reminderType: z.literal('relative'),
+    minuteOffset: z.number().int().optional(),
+    notifyUid: z.string().optional(),
+    service: ReminderDeliveryServiceSchema.optional(),
+    isUrgent: z.boolean().optional(),
+})
+    .strict();
+const UpdateAbsoluteReminderArgsSchema = z
+    .object({
+    reminderType: z.literal('absolute'),
+    due: ReminderDueDateSchema.optional(),
+    notifyUid: z.string().optional(),
+    service: ReminderDeliveryServiceSchema.optional(),
+    isUrgent: z.boolean().optional(),
+})
+    .strict();
+const UpdateLocationReminderArgsSchema = z
+    .object({
+    notifyUid: z.string().optional(),
+    name: z.string().optional(),
+    locLat: z.string().optional(),
+    locLong: z.string().optional(),
+    locTrigger: z.enum(LOCATION_TRIGGERS).optional(),
+    radius: z.number().int().optional(),
+})
+    .strict()
+    .refine((args) => Object.values(args).some((value) => value !== undefined), {
+    message: 'At least one reminder field must be provided to updateLocationReminder',
+});
+const UpdateReminderArgsSchema = z
+    .discriminatedUnion('reminderType', [
+    UpdateRelativeReminderArgsSchema,
+    UpdateAbsoluteReminderArgsSchema,
+])
+    .refine((args) => Object.entries(args).some(([key, value]) => key !== 'reminderType' && value !== undefined), {
+    message: 'At least one reminder field must be provided to updateReminder',
+});
 export class TodoistApi {
     constructor(
     /**
@@ -291,6 +345,30 @@ export class TodoistApi {
             nextCursor,
         };
     }
+    /**
+     * Retrieves all completed tasks with optional filters.
+     *
+     * Uses offset-based pagination rather than cursor-based.
+     *
+     * @param args - Optional parameters including project ID, label, date range, and pagination.
+     * @returns A promise that resolves to completed tasks with associated project and section data.
+     */
+    async getAllCompletedTasks(args = {}) {
+        const { since, until } = args, rest = __rest(args, ["since", "until"]);
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_TASKS_COMPLETED,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign(Object.assign(Object.assign({}, rest), (since ? { since: since.toISOString() } : {})), (until ? { until: until.toISOString() } : {})),
+        });
+        return {
+            projects: data.projects,
+            sections: data.sections,
+            items: validateTaskArray(data.items),
+        };
+    }
     /**
      * Creates a new task with the provided parameters.
      *
@@ -683,6 +761,83 @@ export class TodoistApi {
         });
         return validateProject(response.data.project);
     }
+    /**
+     * Counts the number of archived projects.
+     *
+     * @param args - Optional parameters to filter the count.
+     * @returns A promise that resolves to the count of archived projects.
+     */
+    async getArchivedProjectsCount(args = {}) {
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return data;
+    }
+    /**
+     * Retrieves the role-to-action permission mappings for projects.
+     *
+     * @returns A promise that resolves to the permission mappings.
+     */
+    async getProjectPermissions() {
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_PROJECTS_PERMISSIONS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return data;
+    }
+    /**
+     * Retrieves full project data including tasks, sections, collaborators, and notes.
+     *
+     * @param id - The unique identifier of the project.
+     * @param args - Optional parameters.
+     * @returns A promise that resolves to the full project data.
+     */
+    async getFullProject(id, args = {}) {
+        z.string().parse(id);
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_PROJECTS, id, ENDPOINT_REST_PROJECT_FULL),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            project: data.project ? validateProject(data.project) : null,
+            commentsCount: data.commentsCount,
+            tasks: validateTaskArray(data.tasks),
+            sections: validateSectionArray(data.sections),
+            collaborators: validateUserArray(data.collaborators),
+            notes: validateCommentArray(data.notes),
+        };
+    }
+    /**
+     * Joins a shared project by its ID.
+     *
+     * @param id - The unique identifier of the project to join.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the joined project.
+     */
+    async joinProject(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_PROJECTS, id, ENDPOINT_REST_PROJECT_JOIN),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateProject(response.data);
+    }
     /**
      * Retrieves a list of collaborators for a specific project.
      *
@@ -705,6 +860,116 @@ export class TodoistApi {
             nextCursor,
         };
     }
+    // ── Insights ──
+    /**
+     * Retrieves activity statistics for a project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @param args - Optional parameters including weeks and weekly counts flag.
+     * @returns A promise that resolves to the project activity stats.
+     */
+    async getProjectActivityStats(projectId, args = {}) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsActivityStatsEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign({ objectType: 'ITEM', eventType: 'COMPLETED' }, args),
+        });
+        return validateProjectActivityStats(response.data);
+    }
+    /**
+     * Retrieves the health status of a project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @returns A promise that resolves to the project health data.
+     */
+    async getProjectHealth(projectId) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsHealthEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateProjectHealth(response.data);
+    }
+    /**
+     * Retrieves the health context for a project, including metrics and task details.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @returns A promise that resolves to the project health context.
+     */
+    async getProjectHealthContext(projectId) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsHealthContextEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateProjectHealthContext(response.data);
+    }
+    /**
+     * Retrieves progress information for a project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @returns A promise that resolves to the project progress data.
+     */
+    async getProjectProgress(projectId) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsProgressEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateProjectProgress(response.data);
+    }
+    /**
+     * Retrieves insights for all projects in a workspace.
+     *
+     * @param workspaceId - The unique identifier of the workspace.
+     * @param args - Optional parameters including project IDs filter.
+     * @returns A promise that resolves to workspace insights data.
+     */
+    async getWorkspaceInsights(workspaceId, args = {}) {
+        z.string().parse(workspaceId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceInsightsEndpoint(workspaceId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign(Object.assign({}, args), (args.projectIds ? { projectIds: args.projectIds.join(',') } : {})),
+        });
+        return validateWorkspaceInsights(response.data);
+    }
+    /**
+     * Triggers a health analysis for a project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated project health data.
+     */
+    async analyzeProjectHealth(projectId, requestId) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsHealthAnalyzeEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateProjectHealth(response.data);
+    }
+    // ── Sections ──
     /**
      * Retrieves all sections within a specific project or matching criteria.
      *
@@ -822,6 +1087,44 @@ export class TodoistApi {
         });
         return isSuccess(response);
     }
+    /**
+     * Archives a section by its ID.
+     *
+     * @param id - The unique identifier of the section to archive.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated section.
+     */
+    async archiveSection(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_SECTIONS, id, SECTION_ARCHIVE),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateSection(response.data);
+    }
+    /**
+     * Unarchives a section by its ID.
+     *
+     * @param id - The unique identifier of the section to unarchive.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated section.
+     */
+    async unarchiveSection(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_SECTIONS, id, SECTION_UNARCHIVE),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateSection(response.data);
+    }
     /**
      * Retrieves a label by its ID.
      *
@@ -1086,117 +1389,359 @@ export class TodoistApi {
         return isSuccess(response);
     }
     /**
-     * Retrieves productivity stats for the authenticated user.
+     * Retrieves a paginated list of time-based reminders.
      *
-     * @returns A promise that resolves to the productivity stats.
+     * @param args - Optional parameters including task ID filter and pagination.
+     * @returns A promise that resolves to a paginated list of reminders.
      */
-    async getProductivityStats() {
-        const response = await request({
+    async getReminders(args = {}) {
+        const { data: { results, nextCursor }, } = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
-            relativePath: ENDPOINT_REST_PRODUCTIVITY,
+            relativePath: ENDPOINT_REST_REMINDERS,
             apiToken: this.authToken,
             customFetch: this.customFetch,
+            payload: args,
         });
-        return validateProductivityStats(response.data);
+        return {
+            results: validateReminderArray(results),
+            nextCursor,
+        };
     }
     /**
-     * Retrieves activity logs with optional filters.
+     * Retrieves a paginated list of location-based reminders.
      *
-     * @param args - Optional filter parameters for activity logs.
-     * @returns A promise that resolves to a paginated response of activity events.
+     * @param args - Optional parameters including task ID filter and pagination.
+     * @returns A promise that resolves to a paginated list of location reminders.
      */
-    async getActivityLogs(args = {}) {
-        // Convert Date objects to YYYY-MM-DD strings
-        const dateFrom = args.dateFrom instanceof Date ? formatDateToYYYYMMDD(args.dateFrom) : args.dateFrom;
-        const dateTo = args.dateTo instanceof Date ? formatDateToYYYYMMDD(args.dateTo) : args.dateTo;
-        // Destructure out raw date, filter-type, and removed legacy fields so they don't leak into payload
-        const _a = args, { dateFrom: _dateFrom, dateTo: _dateTo, objectEventTypes, objectType: _objectType, eventType: _eventType, since: _since, until: _until } = _a, rest = __rest(_a, ["dateFrom", "dateTo", "objectEventTypes", "objectType", "eventType", "since", "until"]);
-        // Build normalized objectEventTypes for the API
-        let normalizedObjectEventTypes;
-        if (objectEventTypes !== undefined) {
-            const arr = Array.isArray(objectEventTypes) ? objectEventTypes : [objectEventTypes];
-            normalizedObjectEventTypes = arr.map(normalizeObjectEventTypeForApi);
-        }
-        const processedArgs = Object.assign(Object.assign(Object.assign(Object.assign({}, rest), (dateFrom !== undefined ? { dateFrom } : {})), (dateTo !== undefined ? { dateTo } : {})), (normalizedObjectEventTypes !== undefined
-            ? { objectEventTypes: normalizedObjectEventTypes }
-            : {}));
+    async getLocationReminders(args = {}) {
         const { data: { results, nextCursor }, } = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
-            relativePath: ENDPOINT_REST_ACTIVITIES,
+            relativePath: ENDPOINT_REST_LOCATION_REMINDERS,
             apiToken: this.authToken,
             customFetch: this.customFetch,
-            payload: processedArgs,
-        });
-        // Convert legacy API object types back to modern SDK types
-        const normalizedResults = results.map((event) => {
-            const normalizedType = denormalizeObjectTypeFromApi(event.objectType);
-            return Object.assign(Object.assign({}, event), { objectType: normalizedType || event.objectType });
+            payload: args,
         });
         return {
-            results: validateActivityEventArray(normalizedResults),
+            results: validateLocationReminderArray(results),
             nextCursor,
         };
     }
     /**
-     * Uploads a file and returns attachment metadata.
-     * This creates an upload record that can be referenced in tasks or comments.
-     *
-     * @param args - Upload parameters including file content, filename, and optional project ID.
-     * @param requestId - Optional custom identifier for the request.
-     * @returns A promise that resolves to the uploaded file's attachment metadata.
-     *
-     * @example
-     * ```typescript
-     * // Upload from a file path
-     * const upload = await api.uploadFile({
-     *   file: '/path/to/document.pdf',
-     *   projectId: '12345'
-     * })
-     *
-     * // Upload from a Buffer
-     * const buffer = fs.readFileSync('/path/to/document.pdf')
-     * const upload = await api.uploadFile({
-     *   file: buffer,
-     *   fileName: 'document.pdf',  // Required for Buffer/Stream
-     *   projectId: '12345'
-     * })
+     * Retrieves a time-based reminder by its ID.
      *
-     * // Use the returned fileUrl in a comment
-     * await api.addComment({
-     *   content: 'See attached document',
-     *   taskId: '67890',
-     *   attachment: {
-     *     fileUrl: upload.fileUrl,
-     *     fileName: upload.fileName,
-     *     fileType: upload.fileType,
-     *     resourceType: upload.resourceType
-     *   }
-     * })
-     * ```
+     * @param id - The unique identifier of the reminder to retrieve.
+     * @returns A promise that resolves to the requested reminder.
      */
-    async uploadFile(args, requestId) {
-        const additionalFields = {};
-        if (args.projectId) {
-            additionalFields.project_id = args.projectId;
+    async getReminder(id) {
+        ReminderIdSchema.parse(id);
+        try {
+            const response = await request({
+                httpMethod: 'GET',
+                baseUri: this.syncApiBase,
+                relativePath: generatePath(ENDPOINT_REST_REMINDERS, id),
+                apiToken: this.authToken,
+                customFetch: this.customFetch,
+            });
+            return validateReminder(response.data);
+        }
+        catch (error) {
+            if (!(error instanceof TodoistRequestError) || error.httpStatusCode !== 404) {
+                throw error;
+            }
+            throw new TodoistArgumentError(`Reminder ${id} was not found on the time-based reminder endpoint. If this is a location reminder, use getLocationReminder instead.`);
         }
-        const data = await uploadMultipartFile({
-            baseUrl: this.syncApiBase,
-            authToken: this.authToken,
-            endpoint: ENDPOINT_REST_UPLOADS,
-            file: args.file,
-            fileName: args.fileName,
-            additionalFields: additionalFields,
-            requestId: requestId,
-            customFetch: this.customFetch,
-        });
-        return validateAttachment(data);
     }
     /**
-     * Deletes an uploaded file by its URL.
+     * Retrieves a location reminder by its ID.
      *
-     * @param args - The file URL to delete.
+     * @param id - The unique identifier of the location reminder to retrieve.
+     * @returns A promise that resolves to the requested reminder.
+     */
+    async getLocationReminder(id) {
+        ReminderIdSchema.parse(id);
+        try {
+            const response = await request({
+                httpMethod: 'GET',
+                baseUri: this.syncApiBase,
+                relativePath: generatePath(ENDPOINT_REST_LOCATION_REMINDERS, id),
+                apiToken: this.authToken,
+                customFetch: this.customFetch,
+            });
+            return validateReminder(response.data);
+        }
+        catch (error) {
+            if (!(error instanceof TodoistRequestError) || error.httpStatusCode !== 404) {
+                throw error;
+            }
+            throw new TodoistArgumentError(`Location reminder ${id} was not found on the location reminder endpoint. If this is a time-based reminder, use getReminder instead.`);
+        }
+    }
+    /**
+     * Creates a time-based reminder for a task.
+     *
+     * @param args - Reminder creation parameters for relative or absolute reminders.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created reminder.
+     */
+    async addReminder(args, requestId) {
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_REMINDERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return validateReminder(response.data);
+    }
+    /**
+     * Creates a location reminder for a task.
+     *
+     * @param args - Location reminder creation parameters.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created reminder.
+     */
+    async addLocationReminder(args, requestId) {
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_LOCATION_REMINDERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign(Object.assign({}, args), { reminderType: 'location' }),
+            requestId: requestId,
+        });
+        return validateReminder(response.data);
+    }
+    /**
+     * Updates an existing time-based reminder.
+     *
+     * @param id - The unique identifier of the reminder to update.
+     * @param args - Reminder update parameters.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated reminder.
+     */
+    async updateReminder(id, args, requestId) {
+        ReminderIdSchema.parse(id);
+        const payload = UpdateReminderArgsSchema.parse(args);
+        try {
+            const response = await request({
+                httpMethod: 'POST',
+                baseUri: this.syncApiBase,
+                relativePath: generatePath(ENDPOINT_REST_REMINDERS, id),
+                apiToken: this.authToken,
+                customFetch: this.customFetch,
+                payload,
+                requestId: requestId,
+            });
+            return validateReminder(response.data);
+        }
+        catch (error) {
+            if (!(error instanceof TodoistRequestError) || error.httpStatusCode !== 404) {
+                throw error;
+            }
+            throw new TodoistArgumentError(`Reminder ${id} was not found on the time-based reminder endpoint. If this is a location reminder, use updateLocationReminder instead.`);
+        }
+    }
+    /**
+     * Updates an existing location reminder.
+     *
+     * @param id - The unique identifier of the location reminder to update.
+     * @param args - Location reminder update parameters.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated reminder.
+     */
+    async updateLocationReminder(id, args, requestId) {
+        ReminderIdSchema.parse(id);
+        const payload = UpdateLocationReminderArgsSchema.parse(args);
+        try {
+            const response = await request({
+                httpMethod: 'POST',
+                baseUri: this.syncApiBase,
+                relativePath: generatePath(ENDPOINT_REST_LOCATION_REMINDERS, id),
+                apiToken: this.authToken,
+                customFetch: this.customFetch,
+                payload,
+                requestId: requestId,
+            });
+            return validateReminder(response.data);
+        }
+        catch (error) {
+            if (!(error instanceof TodoistRequestError) || error.httpStatusCode !== 404) {
+                throw error;
+            }
+            throw new TodoistArgumentError(`Location reminder ${id} was not found on the location reminder endpoint. If this is a time-based reminder, use updateReminder instead.`);
+        }
+    }
+    /**
+     * Deletes a time-based reminder by its ID.
+     *
+     * @param id - The unique identifier of the reminder to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteReminder(id, requestId) {
+        ReminderIdSchema.parse(id);
+        try {
+            const response = await request({
+                httpMethod: 'DELETE',
+                baseUri: this.syncApiBase,
+                relativePath: generatePath(ENDPOINT_REST_REMINDERS, id),
+                apiToken: this.authToken,
+                customFetch: this.customFetch,
+                requestId: requestId,
+            });
+            return isSuccess(response);
+        }
+        catch (error) {
+            if (!(error instanceof TodoistRequestError) || error.httpStatusCode !== 404) {
+                throw error;
+            }
+            throw new TodoistArgumentError(`Reminder ${id} was not found on the time-based reminder endpoint. If this is a location reminder, use deleteLocationReminder instead.`);
+        }
+    }
+    /**
+     * Deletes a location reminder by its ID.
+     *
+     * @param id - The unique identifier of the location reminder to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteLocationReminder(id, requestId) {
+        ReminderIdSchema.parse(id);
+        try {
+            const response = await request({
+                httpMethod: 'DELETE',
+                baseUri: this.syncApiBase,
+                relativePath: generatePath(ENDPOINT_REST_LOCATION_REMINDERS, id),
+                apiToken: this.authToken,
+                customFetch: this.customFetch,
+                requestId: requestId,
+            });
+            return isSuccess(response);
+        }
+        catch (error) {
+            if (!(error instanceof TodoistRequestError) || error.httpStatusCode !== 404) {
+                throw error;
+            }
+            throw new TodoistArgumentError(`Location reminder ${id} was not found on the location reminder endpoint. If this is a time-based reminder, use deleteReminder instead.`);
+        }
+    }
+    /**
+     * Retrieves productivity stats for the authenticated user.
+     *
+     * @returns A promise that resolves to the productivity stats.
+     */
+    async getProductivityStats() {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_PRODUCTIVITY,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateProductivityStats(response.data);
+    }
+    /**
+     * Retrieves activity logs with optional filters.
+     *
+     * @param args - Optional filter parameters for activity logs.
+     * @returns A promise that resolves to a paginated response of activity events.
+     */
+    async getActivityLogs(args = {}) {
+        // Convert Date objects to YYYY-MM-DD strings
+        const dateFrom = args.dateFrom instanceof Date ? formatDateToYYYYMMDD(args.dateFrom) : args.dateFrom;
+        const dateTo = args.dateTo instanceof Date ? formatDateToYYYYMMDD(args.dateTo) : args.dateTo;
+        // Destructure out raw date, filter-type, and removed legacy fields so they don't leak into payload
+        const _a = args, { dateFrom: _dateFrom, dateTo: _dateTo, objectEventTypes, objectType: _objectType, eventType: _eventType, since: _since, until: _until } = _a, rest = __rest(_a, ["dateFrom", "dateTo", "objectEventTypes", "objectType", "eventType", "since", "until"]);
+        // Build normalized objectEventTypes for the API
+        let normalizedObjectEventTypes;
+        if (objectEventTypes !== undefined) {
+            const arr = Array.isArray(objectEventTypes) ? objectEventTypes : [objectEventTypes];
+            normalizedObjectEventTypes = arr.map(normalizeObjectEventTypeForApi);
+        }
+        const processedArgs = Object.assign(Object.assign(Object.assign(Object.assign({}, rest), (dateFrom !== undefined ? { dateFrom } : {})), (dateTo !== undefined ? { dateTo } : {})), (normalizedObjectEventTypes !== undefined
+            ? { objectEventTypes: normalizedObjectEventTypes }
+            : {}));
+        const { data: { results, nextCursor }, } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_ACTIVITIES,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: processedArgs,
+        });
+        // Convert legacy API object types back to modern SDK types
+        const normalizedResults = results.map((event) => {
+            const normalizedType = denormalizeObjectTypeFromApi(event.objectType);
+            return Object.assign(Object.assign({}, event), { objectType: normalizedType || event.objectType });
+        });
+        return {
+            results: validateActivityEventArray(normalizedResults),
+            nextCursor,
+        };
+    }
+    /**
+     * Uploads a file and returns attachment metadata.
+     * This creates an upload record that can be referenced in tasks or comments.
+     *
+     * @param args - Upload parameters including file content, filename, and optional project ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the uploaded file's attachment metadata.
+     *
+     * @example
+     * ```typescript
+     * // Upload from a file path
+     * const upload = await api.uploadFile({
+     *   file: '/path/to/document.pdf',
+     *   projectId: '12345'
+     * })
+     *
+     * // Upload from a Buffer
+     * const buffer = fs.readFileSync('/path/to/document.pdf')
+     * const upload = await api.uploadFile({
+     *   file: buffer,
+     *   fileName: 'document.pdf',  // Required for Buffer/Stream
+     *   projectId: '12345'
+     * })
+     *
+     * // Use the returned fileUrl in a comment
+     * await api.addComment({
+     *   content: 'See attached document',
+     *   taskId: '67890',
+     *   attachment: {
+     *     fileUrl: upload.fileUrl,
+     *     fileName: upload.fileName,
+     *     fileType: upload.fileType,
+     *     resourceType: upload.resourceType
+     *   }
+     * })
+     * ```
+     */
+    async uploadFile(args, requestId) {
+        const additionalFields = {};
+        if (args.projectId) {
+            additionalFields.project_id = args.projectId;
+        }
+        const data = await uploadMultipartFile({
+            baseUrl: this.syncApiBase,
+            authToken: this.authToken,
+            endpoint: ENDPOINT_REST_UPLOADS,
+            file: args.file,
+            fileName: args.fileName,
+            additionalFields: additionalFields,
+            requestId: requestId,
+            customFetch: this.customFetch,
+        });
+        return validateAttachment(data);
+    }
+    /**
+     * Deletes an uploaded file by its URL.
+     *
+     * @param args - The file URL to delete.
      * @param requestId - Optional custom identifier for the request.
      * @returns A promise that resolves to `true` if deletion was successful.
      *
@@ -1296,6 +1841,246 @@ export class TodoistApi {
             arrayBuffer: () => response.arrayBuffer(),
         };
     }
+    // ── Backups ──
+    /**
+     * Retrieves a list of available backups.
+     *
+     * @param args - Optional parameters including MFA token.
+     * @returns A promise that resolves to an array of backups.
+     */
+    async getBackups(args = {}) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_BACKUPS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return validateBackupArray(response.data);
+    }
+    /**
+     * Downloads a backup file as binary data.
+     *
+     * @param args - Arguments including the backup file URL (from getBackups).
+     * @returns A promise that resolves to a response with binary data accessible via arrayBuffer().
+     */
+    async downloadBackup(args) {
+        const url = `${this.syncApiBase}${ENDPOINT_REST_BACKUPS_DOWNLOAD}?file=${encodeURIComponent(args.file)}`;
+        const fetchOptions = {
+            headers: { Authorization: `Bearer ${this.authToken}` },
+        };
+        if (this.customFetch) {
+            const response = await this.customFetch(url, fetchOptions);
+            if (!response.ok) {
+                throw new Error(`Failed to download backup: ${response.status} ${response.statusText}`);
+            }
+            const text = await response.text();
+            const buffer = new TextEncoder().encode(text).buffer;
+            return {
+                ok: response.ok,
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+                text: () => Promise.resolve(text),
+                json: () => response.json(),
+                arrayBuffer: () => Promise.resolve(buffer),
+            };
+        }
+        const response = await fetch(url, fetchOptions);
+        if (!response.ok) {
+            throw new Error(`Failed to download backup: ${response.status} ${response.statusText}`);
+        }
+        return {
+            ok: response.ok,
+            status: response.status,
+            statusText: response.statusText,
+            headers: headersToRecord(response.headers),
+            text: () => response.text(),
+            json: () => response.json(),
+            arrayBuffer: () => response.arrayBuffer(),
+        };
+    }
+    // ── Emails ──
+    /**
+     * Gets or creates an email forwarding address for an object.
+     *
+     * @param args - Arguments including object type and ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the email address.
+     */
+    async getOrCreateEmailForwarding(args, requestId) {
+        const { data } = await request({
+            httpMethod: 'PUT',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_EMAILS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return data;
+    }
+    /**
+     * Disables email forwarding for an object.
+     *
+     * @param args - Arguments including object type and ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async disableEmailForwarding(args, requestId) {
+        const queryParams = new URLSearchParams({
+            obj_type: args.objType,
+            obj_id: args.objId,
+        });
+        const response = await request({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: `${ENDPOINT_REST_EMAILS}?${queryParams.toString()}`,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return isSuccess(response);
+    }
+    // ── ID Mappings ──
+    /**
+     * Retrieves ID mappings between old and new IDs.
+     *
+     * @param args - Arguments including object type and IDs to look up.
+     * @returns A promise that resolves to an array of ID mappings.
+     */
+    async getIdMappings(args) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_ID_MAPPINGS, args.objName, args.objIds.join(',')),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateIdMappingArray(response.data);
+    }
+    /**
+     * Retrieves moved IDs for objects that have been migrated.
+     *
+     * @param args - Arguments including object type and optional old IDs to look up.
+     * @returns A promise that resolves to an array of moved ID pairs.
+     */
+    async getMovedIds(args) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_MOVED_IDS, args.objName),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args.oldIds ? { oldIds: args.oldIds.join(',') } : undefined,
+        });
+        return validateMovedIdArray(response.data);
+    }
+    // ── Templates ──
+    /**
+     * Exports a project as a template file (CSV format).
+     *
+     * @param args - Arguments including project ID and optional date format preference.
+     * @returns A promise that resolves to the template file content as a string.
+     */
+    async exportTemplateAsFile(args) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_TEMPLATES_FILE,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return response.data;
+    }
+    /**
+     * Exports a project as a template URL.
+     *
+     * @param args - Arguments including project ID and optional date format preference.
+     * @returns A promise that resolves to the file name and URL.
+     */
+    async exportTemplateAsUrl(args) {
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_TEMPLATES_URL,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return data;
+    }
+    /**
+     * Creates a new project from a template file.
+     *
+     * @param args - Arguments including project name, template file, and optional workspace ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created project data.
+     */
+    async createProjectFromTemplate(args, requestId) {
+        const { file, fileName, name, workspaceId } = args;
+        const additionalFields = { name };
+        if (workspaceId !== undefined && workspaceId !== null) {
+            additionalFields.workspace_id = workspaceId;
+        }
+        const data = await uploadMultipartFile({
+            baseUrl: this.syncApiBase,
+            authToken: this.authToken,
+            endpoint: ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE,
+            file,
+            fileName,
+            additionalFields,
+            customFetch: this.customFetch,
+            requestId,
+        });
+        return this.validateTemplateResponse(camelCaseKeys(data));
+    }
+    /**
+     * Imports a template file into an existing project.
+     *
+     * @param args - Arguments including project ID and template file.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the import result.
+     */
+    async importTemplateIntoProject(args, requestId) {
+        const { file, fileName, projectId } = args;
+        const data = await uploadMultipartFile({
+            baseUrl: this.syncApiBase,
+            authToken: this.authToken,
+            endpoint: ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE,
+            file,
+            fileName,
+            additionalFields: { project_id: projectId },
+            customFetch: this.customFetch,
+            requestId,
+        });
+        return this.validateTemplateResponse(camelCaseKeys(data));
+    }
+    /**
+     * Imports a template by ID into an existing project.
+     *
+     * @param args - Arguments including project ID, template ID, and optional locale.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the import result.
+     */
+    async importTemplateFromId(args, requestId) {
+        const { data } = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return this.validateTemplateResponse(data);
+    }
+    validateTemplateResponse(data) {
+        var _a, _b, _c, _d;
+        return Object.assign(Object.assign({}, data), { projects: validateProjectArray((_a = data.projects) !== null && _a !== void 0 ? _a : []), sections: validateSectionArray((_b = data.sections) !== null && _b !== void 0 ? _b : []), tasks: validateTaskArray((_c = data.tasks) !== null && _c !== void 0 ? _c : []), comments: validateCommentArray((_d = data.comments) !== null && _d !== void 0 ? _d : []) });
+    }
     /* Workspace methods */
     /**
      * Gets pending invitations for a workspace.
@@ -1520,8 +2305,6 @@ export class TodoistApi {
     /**
      * Retrieves all workspaces for the authenticated user.
      *
-     * Uses the Sync API internally to fetch workspace data.
-     *
      * @param requestId - Optional custom identifier for the request.
      * @returns A promise that resolves to an array of workspaces.
      *
@@ -1534,17 +2317,196 @@ export class TodoistApi {
      * ```
      */
     async getWorkspaces(requestId) {
-        const syncRequest = {
-            syncToken: '*',
-            resourceTypes: ['workspaces'],
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_WORKSPACES,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateWorkspaceArray(response.data);
+    }
+    /**
+     * Retrieves a workspace by its ID.
+     *
+     * @param id - The unique identifier of the workspace.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the requested workspace.
+     */
+    async getWorkspace(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_WORKSPACES, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateWorkspace(response.data);
+    }
+    /**
+     * Creates a new workspace.
+     *
+     * @param args - The arguments for creating the workspace.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created workspace.
+     */
+    async addWorkspace(args, requestId) {
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_WORKSPACES,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return validateWorkspace(response.data);
+    }
+    /**
+     * Updates an existing workspace.
+     *
+     * @param id - The unique identifier of the workspace to update.
+     * @param args - The arguments for updating the workspace.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated workspace.
+     */
+    async updateWorkspace(id, args, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_WORKSPACES, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return validateWorkspace(response.data);
+    }
+    /**
+     * Deletes a workspace by its ID.
+     *
+     * @param id - The unique identifier of the workspace to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteWorkspace(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_WORKSPACES, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return isSuccess(response);
+    }
+    /**
+     * Retrieves activity information for workspace members.
+     *
+     * @param args - Arguments including workspace ID and optional user/project filters.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to workspace members activity data.
+     */
+    async getWorkspaceMembersActivity(args, requestId) {
+        const { workspaceId } = args, queryParams = __rest(args, ["workspaceId"]);
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_WORKSPACE_MEMBERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign({ workspaceId }, queryParams),
+            requestId: requestId,
+        });
+        return {
+            members: validateMemberActivityInfoArray(data.members),
         };
-        const syncResponse = await this.requestSync(syncRequest, requestId, false);
-        const workspacesData = syncResponse.workspaces;
-        if (!workspacesData || typeof workspacesData !== 'object') {
-            return [];
-        }
-        const workspacesArray = Object.values(workspacesData);
-        return validateWorkspaceArray(workspacesArray);
+    }
+    /**
+     * Retrieves tasks assigned to a specific user in a workspace.
+     *
+     * @param args - Arguments including workspace ID, user ID, and optional project filter.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to workspace user tasks.
+     */
+    async getWorkspaceUserTasks(args, requestId) {
+        const { workspaceId, userId } = args, queryParams = __rest(args, ["workspaceId", "userId"]);
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceUserTasksEndpoint(workspaceId, userId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: queryParams,
+            requestId: requestId,
+        });
+        return {
+            tasks: validateWorkspaceUserTaskArray(data.tasks),
+        };
+    }
+    /**
+     * Invites users to a workspace by email.
+     *
+     * @param args - Arguments including workspace ID, email list, and optional role.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the list of invited emails.
+     */
+    async inviteWorkspaceUsers(args, requestId) {
+        const { workspaceId } = args, payload = __rest(args, ["workspaceId"]);
+        const { data } = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceInviteUsersEndpoint(workspaceId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: payload,
+            requestId: requestId,
+        });
+        return data;
+    }
+    /**
+     * Updates a workspace user's role.
+     *
+     * @param args - Arguments including workspace ID, user ID, and new role.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated workspace user view.
+     */
+    async updateWorkspaceUser(args, requestId) {
+        const { workspaceId, userId } = args, payload = __rest(args, ["workspaceId", "userId"]);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceUserEndpoint(workspaceId, userId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: payload,
+            requestId: requestId,
+        });
+        return validateJoinWorkspaceResult(response.data);
+    }
+    /**
+     * Removes a user from a workspace.
+     *
+     * @param args - Arguments including workspace ID and user ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async removeWorkspaceUser(args, requestId) {
+        const { workspaceId, userId } = args;
+        const response = await request({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceUserEndpoint(workspaceId, userId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return isSuccess(response);
     }
     /**
      * Gets active projects in a workspace with pagination.