@doist/todoist-api-typescript 5.9.0 → 6.0.0

package/dist/cjs/todoist-api.js

@@ -0,0 +1,1235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TodoistApi = void 0;
+const rest_client_1 = require("./rest-client");
+const endpoints_1 = require("./consts/endpoints");
+const validators_1 = require("./utils/validators");
+const url_helpers_1 = require("./utils/url-helpers");
+const multipart_upload_1 = require("./utils/multipart-upload");
+const activity_helpers_1 = require("./utils/activity-helpers");
+const zod_1 = require("zod");
+const uuid_1 = require("uuid");
+const types_1 = require("./types");
+const MAX_COMMAND_COUNT = 100;
+/**
+ * Joins path segments using `/` separator.
+ * @param segments A list of **valid** path segments.
+ * @returns A joined path.
+ */
+function generatePath(...segments) {
+    return segments.join('/');
+}
+/**
+ * A client for interacting with the Todoist API v1.
+ * This class provides methods to manage tasks, projects, sections, labels, and comments in Todoist.
+ *
+ * @example
+ * ```typescript
+ * const api = new TodoistApi('your-api-token');
+ *
+ * // Get all tasks
+ * const tasks = await api.getTasks();
+ *
+ * // Create a new task
+ * const newTask = await api.addTask({
+ *   content: 'My new task',
+ *   projectId: '12345'
+ * });
+ * ```
+ *
+ * For more information about the Todoist API v1, see the [official documentation](https://todoist.com/api/v1).
+ * If you're migrating from v9, please refer to the [migration guide](https://todoist.com/api/v1/docs#tag/Migrating-from-v9).
+ */
+class TodoistApi {
+    constructor(
+    /**
+     * Your Todoist API token.
+     */
+    authToken, 
+    /**
+     * Optional custom API base URL. If not provided, defaults to Todoist's standard API endpoint
+     */
+    baseUrl) {
+        this.authToken = authToken;
+        this.syncApiBase = (0, endpoints_1.getSyncBaseUri)(baseUrl);
+    }
+    /**
+     * Retrieves information about the authenticated user.
+     *
+     * @returns A promise that resolves to the current user's information.
+     */
+    async getUser() {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_USER,
+            apiToken: this.authToken,
+        });
+        return (0, validators_1.validateCurrentUser)(response.data);
+    }
+    /**
+     * Retrieves a single active (non-completed) task by its ID.
+     *
+     * @param id - The unique identifier of the task.
+     * @returns A promise that resolves to the requested task.
+     */
+    async getTask(id) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_TASKS, id),
+            apiToken: this.authToken,
+        });
+        return (0, validators_1.validateTask)(response.data);
+    }
+    /**
+     * Retrieves a list of active tasks filtered by specific parameters.
+     *
+     * @param args - Filter parameters such as project ID, label ID, or due date.
+     * @returns A promise that resolves to an array of tasks.
+     */
+    async getTasks(args = {}) {
+        const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_TASKS,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateTaskArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves tasks filtered by a filter string.
+     *
+     * @param args - Parameters for filtering tasks, including the query string and optional language.
+     * @returns A promise that resolves to a paginated response of tasks.
+     */
+    async getTasksByFilter(args) {
+        const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_TASKS_FILTER,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateTaskArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves completed tasks by completion date.
+     *
+     * @param args - Parameters for filtering, including required since, until.
+     * @returns A promise that resolves to a paginated response of completed tasks.
+     */
+    async getCompletedTasksByCompletionDate(args) {
+        const { data: { items, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            items: (0, validators_1.validateTaskArray)(items),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves completed tasks by due date.
+     *
+     * @param args - Parameters for filtering, including required since, until.
+     * @returns A promise that resolves to a paginated response of completed tasks.
+     */
+    async getCompletedTasksByDueDate(args) {
+        const { data: { items, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            items: (0, validators_1.validateTaskArray)(items),
+            nextCursor,
+        };
+    }
+    /**
+     * Searches completed tasks by query string.
+     *
+     * @param args - Parameters for searching, including the query string.
+     * @returns A promise that resolves to a paginated response of completed tasks.
+     */
+    async searchCompletedTasks(args) {
+        const { data: { items, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_TASKS_COMPLETED_SEARCH,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            items: (0, validators_1.validateTaskArray)(items),
+            nextCursor,
+        };
+    }
+    /**
+     * Creates a new task with the provided parameters.
+     *
+     * @param args - Task creation parameters such as content, due date, or priority.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created task.
+     */
+    async addTask(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_TASKS,
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateTask)(response.data);
+    }
+    /**
+     * Quickly adds a task using natural language processing for due dates.
+     *
+     * @param args - Quick add task parameters, including content and due date.
+     * @returns A promise that resolves to the created task.
+     */
+    async quickAddTask(args) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_SYNC_QUICK_ADD,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return (0, validators_1.validateTask)(response.data);
+    }
+    /**
+     * Updates an existing task by its ID with the provided parameters.
+     *
+     * @param id - The unique identifier of the task to update.
+     * @param args - Update parameters such as content, priority, or due date.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated task.
+     */
+    async updateTask(id, args, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_TASKS, id),
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateTask)(response.data);
+    }
+    /**
+     * Moves existing tasks by their ID to either a different parent/section/project.
+     *
+     * @param ids - The unique identifier of the tasks to be moved.
+     * @param args - The paramets that should contain only one of projectId, sectionId, or parentId
+     * @param requestId - Optional custom identifier for the request.
+     * @returns - A promise that resolves to an array of the updated tasks.
+     * @deprecated Use `moveTask` for single task operations. This method uses the Sync API and may be removed in a future version.
+     */
+    async moveTasks(ids, args, requestId) {
+        var _a;
+        if (ids.length > MAX_COMMAND_COUNT) {
+            throw new types_1.TodoistRequestError(`Maximum number of items is ${MAX_COMMAND_COUNT}`, 400);
+        }
+        const commands = ids.map((id) => ({
+            type: 'item_move',
+            uuid: (0, uuid_1.v4)(),
+            args: Object.assign(Object.assign(Object.assign({ id }, (args.projectId && { project_id: args.projectId })), (args.sectionId && { section_id: args.sectionId })), (args.parentId && { parent_id: args.parentId })),
+        }));
+        const syncRequest = {
+            commands,
+            resource_types: ['items'],
+        };
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_SYNC,
+            apiToken: this.authToken,
+            payload: syncRequest,
+            requestId: requestId,
+            hasSyncCommands: true,
+        });
+        if (response.data.sync_status) {
+            Object.entries(response.data.sync_status).forEach(([_, value]) => {
+                if (value === 'ok')
+                    return;
+                throw new types_1.TodoistRequestError(value.error, value.http_code, value.error_extra);
+            });
+        }
+        if (!((_a = response.data.items) === null || _a === void 0 ? void 0 : _a.length)) {
+            throw new types_1.TodoistRequestError('Tasks not found', 404);
+        }
+        const syncTasks = response.data.items.filter((task) => ids.includes(task.id));
+        if (!syncTasks.length) {
+            throw new types_1.TodoistRequestError('Tasks not found', 404);
+        }
+        return (0, validators_1.validateTaskArray)(syncTasks);
+    }
+    /**
+     * Moves a task by its ID to either a different parent/section/project.
+     *
+     * @param id - The unique identifier of the task to be moved.
+     * @param args - The parameters that should contain exactly one of projectId, sectionId, or parentId
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated task.
+     */
+    async moveTask(id, args, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_TASKS, id, endpoints_1.ENDPOINT_REST_TASK_MOVE),
+            apiToken: this.authToken,
+            payload: Object.assign(Object.assign(Object.assign({}, (args.projectId && { project_id: args.projectId })), (args.sectionId && { section_id: args.sectionId })), (args.parentId && { parent_id: args.parentId })),
+            requestId: requestId,
+        });
+        return (0, validators_1.validateTask)(response.data);
+    }
+    /**
+     * Closes (completes) a task by its ID.
+     *
+     * @param id - The unique identifier of the task to close.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async closeTask(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_TASKS, id, endpoints_1.ENDPOINT_REST_TASK_CLOSE),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Reopens a previously closed (completed) task by its ID.
+     *
+     * @param id - The unique identifier of the task to reopen.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async reopenTask(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_TASKS, id, endpoints_1.ENDPOINT_REST_TASK_REOPEN),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Deletes a task by its ID.
+     *
+     * @param id - The unique identifier of the task to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteTask(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_TASKS, id),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Retrieves a project by its ID.
+     *
+     * @param id - The unique identifier of the project.
+     * @returns A promise that resolves to the requested project.
+     */
+    async getProject(id) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_PROJECTS, id),
+            apiToken: this.authToken,
+        });
+        return (0, validators_1.validateProject)(response.data);
+    }
+    /**
+     * Retrieves all projects with optional filters.
+     *
+     * @param args - Optional filters for retrieving projects.
+     * @returns A promise that resolves to an array of projects.
+     */
+    async getProjects(args = {}) {
+        const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_PROJECTS,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateProjectArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves all archived projects with optional filters.
+     *
+     * @param args - Optional filters for retrieving archived projects.
+     * @returns A promise that resolves to an array of archived projects.
+     */
+    async getArchivedProjects(args = {}) {
+        const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_PROJECTS_ARCHIVED,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateProjectArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Creates a new project with the provided parameters.
+     *
+     * @param args - Project creation parameters such as name or color.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created project.
+     */
+    async addProject(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_PROJECTS,
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateProject)(response.data);
+    }
+    /**
+     * Updates an existing project by its ID with the provided parameters.
+     *
+     * @param id - The unique identifier of the project to update.
+     * @param args - Update parameters such as name or color.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated project.
+     */
+    async updateProject(id, args, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_PROJECTS, id),
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateProject)(response.data);
+    }
+    /**
+     * Deletes a project by its ID.
+     *
+     * @param id - The unique identifier of the project to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteProject(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_PROJECTS, id),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Archives a project by its ID.
+     *
+     * @param id - The unique identifier of the project to archive.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated project.
+     */
+    async archiveProject(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_PROJECTS, id, endpoints_1.PROJECT_ARCHIVE),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateProject)(response.data);
+    }
+    /**
+     * Unarchives a project by its ID.
+     *
+     * @param id - The unique identifier of the project to unarchive.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated project.
+     */
+    async unarchiveProject(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_PROJECTS, id, endpoints_1.PROJECT_UNARCHIVE),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateProject)(response.data);
+    }
+    /**
+     * Retrieves a list of collaborators for a specific project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @param args - Optional parameters to filter collaborators.
+     * @returns A promise that resolves to an array of collaborators for the project.
+     */
+    async getProjectCollaborators(projectId, args = {}) {
+        zod_1.z.string().parse(projectId);
+        const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_PROJECTS, projectId, endpoints_1.ENDPOINT_REST_PROJECT_COLLABORATORS),
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateUserArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves all sections within a specific project or matching criteria.
+     *
+     * @param args - Filter parameters such as project ID.
+     * @returns A promise that resolves to an array of sections.
+     */
+    async getSections(args) {
+        const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_SECTIONS,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateSectionArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves a single section by its ID.
+     *
+     * @param id - The unique identifier of the section.
+     * @returns A promise that resolves to the requested section.
+     */
+    async getSection(id) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_SECTIONS, id),
+            apiToken: this.authToken,
+        });
+        return (0, validators_1.validateSection)(response.data);
+    }
+    /**
+     * Creates a new section within a project.
+     *
+     * @param args - Section creation parameters such as name or project ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created section.
+     */
+    async addSection(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_SECTIONS,
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateSection)(response.data);
+    }
+    /**
+     * Updates a section by its ID with the provided parameters.
+     *
+     * @param id - The unique identifier of the section to update.
+     * @param args - Update parameters such as name or project ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated section.
+     */
+    async updateSection(id, args, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_SECTIONS, id),
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateSection)(response.data);
+    }
+    /**
+     * Deletes a section by its ID.
+     *
+     * @param id - The unique identifier of the section to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteSection(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_SECTIONS, id),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Retrieves a label by its ID.
+     *
+     * @param id - The unique identifier of the label.
+     * @returns A promise that resolves to the requested label.
+     */
+    async getLabel(id) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_LABELS, id),
+            apiToken: this.authToken,
+        });
+        return (0, validators_1.validateLabel)(response.data);
+    }
+    /**
+     * Retrieves all labels.
+     *
+     * @param args - Optional filter parameters.
+     * @returns A promise that resolves to an array of labels.
+     */
+    async getLabels(args = {}) {
+        const { data: { results, nextCursor: nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_LABELS,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateLabelArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Adds a new label.
+     *
+     * @param args - Label creation parameters such as name.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created label.
+     */
+    async addLabel(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_LABELS,
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateLabel)(response.data);
+    }
+    /**
+     * Updates an existing label by its ID.
+     *
+     * @param id - The unique identifier of the label to update.
+     * @param args - Update parameters such as name or color.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated label.
+     */
+    async updateLabel(id, args, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_LABELS, id),
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateLabel)(response.data);
+    }
+    /**
+     * Deletes a label by its ID.
+     *
+     * @param id - The unique identifier of the label to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteLabel(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_LABELS, id),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Retrieves a list of shared labels.
+     *
+     * @param args - Optional parameters to filter shared labels.
+     * @returns A promise that resolves to an array of shared labels.
+     */
+    async getSharedLabels(args) {
+        const { data: { results, nextCursor: nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_LABELS_SHARED,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return { results, nextCursor };
+    }
+    /**
+     * Renames an existing shared label.
+     *
+     * @param args - Parameters for renaming the shared label, including the current and new name.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async renameSharedLabel(args) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_LABELS_SHARED_RENAME,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Removes a shared label.
+     *
+     * @param args - Parameters for removing the shared label.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async removeSharedLabel(args) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_LABELS_SHARED_REMOVE,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Retrieves all comments associated with a task or project.
+     *
+     * @param args - Parameters for retrieving comments, such as task ID or project ID.
+     * @returns A promise that resolves to an array of comments.
+     */
+    async getComments(args) {
+        const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_COMMENTS,
+            apiToken: this.authToken,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateCommentArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves a specific comment by its ID.
+     *
+     * @param id - The unique identifier of the comment to retrieve.
+     * @returns A promise that resolves to the requested comment.
+     */
+    async getComment(id) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_COMMENTS, id),
+            apiToken: this.authToken,
+        });
+        return (0, validators_1.validateComment)(response.data);
+    }
+    /**
+     * Adds a comment to a task or project.
+     *
+     * @param args - Parameters for creating the comment, such as content and the target task or project ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created comment.
+     */
+    async addComment(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_COMMENTS,
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateComment)(response.data);
+    }
+    /**
+     * Updates an existing comment by its ID.
+     *
+     * @param id - The unique identifier of the comment to update.
+     * @param args - Update parameters such as new content.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated comment.
+     */
+    async updateComment(id, args, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_COMMENTS, id),
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateComment)(response.data);
+    }
+    /**
+     * Deletes a comment by its ID.
+     *
+     * @param id - The unique identifier of the comment to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteComment(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_COMMENTS, id),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /**
+     * Retrieves productivity stats for the authenticated user.
+     *
+     * @returns A promise that resolves to the productivity stats.
+     */
+    async getProductivityStats() {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_PRODUCTIVITY,
+            apiToken: this.authToken,
+        });
+        return (0, validators_1.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 and modern object types to legacy API types
+        const processedArgs = Object.assign(Object.assign(Object.assign(Object.assign({}, args), (args.since instanceof Date && { since: (0, url_helpers_1.formatDateToYYYYMMDD)(args.since) })), (args.until instanceof Date && { until: (0, url_helpers_1.formatDateToYYYYMMDD)(args.until) })), (args.objectType && { objectType: (0, activity_helpers_1.normalizeObjectTypeForApi)(args.objectType) }));
+        const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_ACTIVITIES,
+            apiToken: this.authToken,
+            payload: processedArgs,
+        });
+        // Convert legacy API object types back to modern SDK types
+        const normalizedResults = results.map((event) => {
+            const normalizedType = (0, activity_helpers_1.denormalizeObjectTypeFromApi)(event.objectType);
+            return Object.assign(Object.assign({}, event), { objectType: normalizedType || event.objectType });
+        });
+        return {
+            results: (0, validators_1.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 (0, multipart_upload_1.uploadMultipartFile)({
+            baseUrl: this.syncApiBase,
+            authToken: this.authToken,
+            endpoint: endpoints_1.ENDPOINT_REST_UPLOADS,
+            file: args.file,
+            fileName: args.fileName,
+            additionalFields: additionalFields,
+            requestId: requestId,
+        });
+        return (0, validators_1.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.
+     *
+     * @example
+     * ```typescript
+     * await api.deleteUpload({
+     *   fileUrl: 'https://cdn.todoist.com/...'
+     * })
+     * ```
+     */
+    async deleteUpload(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_UPLOADS,
+            apiToken: this.authToken,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, rest_client_1.isSuccess)(response);
+    }
+    /* Workspace methods */
+    /**
+     * Gets pending invitations for a workspace.
+     *
+     * @param args - Arguments including workspace ID.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Array of email addresses with pending invitations.
+     */
+    async getWorkspaceInvitations(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_WORKSPACE_INVITATIONS,
+            apiToken: this.authToken,
+            payload: { workspace_id: args.workspaceId },
+            requestId: requestId,
+        });
+        return response.data;
+    }
+    /**
+     * Gets all workspace invitations (admin only).
+     *
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Array of email addresses with pending invitations.
+     */
+    async getAllWorkspaceInvitations(args = {}, requestId) {
+        const queryParams = {};
+        if (args.workspaceId) {
+            queryParams.workspace_id = args.workspaceId;
+        }
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_WORKSPACE_INVITATIONS_ALL,
+            apiToken: this.authToken,
+            payload: queryParams,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateWorkspaceInvitationArray)(response.data);
+    }
+    /**
+     * Deletes a workspace invitation (admin only).
+     *
+     * @param args - Arguments including workspace ID and user email.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns The deleted invitation.
+     */
+    async deleteWorkspaceInvitation(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_WORKSPACE_INVITATIONS_DELETE,
+            apiToken: this.authToken,
+            payload: {
+                workspace_id: args.workspaceId,
+                user_email: args.userEmail,
+            },
+            requestId: requestId,
+        });
+        return (0, validators_1.validateWorkspaceInvitation)(response.data);
+    }
+    /**
+     * Accepts a workspace invitation.
+     *
+     * @param args - Arguments including invite code.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns The accepted invitation.
+     */
+    async acceptWorkspaceInvitation(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'PUT',
+            baseUri: this.syncApiBase,
+            relativePath: (0, endpoints_1.getWorkspaceInvitationAcceptEndpoint)(args.inviteCode),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateWorkspaceInvitation)(response.data);
+    }
+    /**
+     * Rejects a workspace invitation.
+     *
+     * @param args - Arguments including invite code.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns The rejected invitation.
+     */
+    async rejectWorkspaceInvitation(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'PUT',
+            baseUri: this.syncApiBase,
+            relativePath: (0, endpoints_1.getWorkspaceInvitationRejectEndpoint)(args.inviteCode),
+            apiToken: this.authToken,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateWorkspaceInvitation)(response.data);
+    }
+    /**
+     * Joins a workspace via invitation link or domain auto-join.
+     *
+     * @param args - Arguments including invite code or workspace ID.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Workspace user information.
+     */
+    async joinWorkspace(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_WORKSPACE_JOIN,
+            apiToken: this.authToken,
+            payload: {
+                invite_code: args.inviteCode,
+                workspace_id: args.workspaceId,
+            },
+            requestId: requestId,
+        });
+        return (0, validators_1.validateJoinWorkspaceResult)(response.data);
+    }
+    /**
+     * Uploads or updates a workspace logo.
+     *
+     * @param args - Arguments including workspace ID, file, and options.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Logo information or null if deleted.
+     */
+    async uploadWorkspaceLogo(args, requestId) {
+        if (args.delete) {
+            // Delete logo
+            const data = await (0, multipart_upload_1.uploadMultipartFile)({
+                baseUrl: this.syncApiBase,
+                authToken: this.authToken,
+                endpoint: endpoints_1.ENDPOINT_WORKSPACE_LOGO,
+                file: Buffer.alloc(0), // Empty buffer for delete
+                fileName: 'delete',
+                additionalFields: {
+                    workspace_id: args.workspaceId,
+                    delete: true,
+                },
+                requestId: requestId,
+            });
+            return data;
+        }
+        if (!args.file) {
+            throw new Error('file is required when not deleting logo');
+        }
+        // Validate buffer is not empty if it's a Buffer
+        if (Buffer.isBuffer(args.file) && args.file.length === 0) {
+            throw new Error('Cannot upload empty image file');
+        }
+        const additionalFields = {
+            workspace_id: args.workspaceId,
+        };
+        const data = await (0, multipart_upload_1.uploadMultipartFile)({
+            baseUrl: this.syncApiBase,
+            authToken: this.authToken,
+            endpoint: endpoints_1.ENDPOINT_WORKSPACE_LOGO,
+            file: args.file,
+            fileName: args.fileName,
+            additionalFields: additionalFields,
+            requestId: requestId,
+        });
+        return data;
+    }
+    /**
+     * Gets workspace plan and billing details.
+     *
+     * @param args - Arguments including workspace ID.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Workspace plan details.
+     */
+    async getWorkspacePlanDetails(args, requestId) {
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_WORKSPACE_PLAN_DETAILS,
+            apiToken: this.authToken,
+            payload: { workspace_id: args.workspaceId },
+            requestId: requestId,
+        });
+        return (0, validators_1.validateWorkspacePlanDetails)(response.data);
+    }
+    /**
+     * Gets workspace users with pagination.
+     *
+     * @param args - Arguments including optional workspace ID, cursor, and limit.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Paginated list of workspace users.
+     */
+    async getWorkspaceUsers(args = {}, requestId) {
+        const queryParams = {};
+        if (args.workspaceId !== undefined && args.workspaceId !== null) {
+            queryParams.workspace_id = args.workspaceId;
+        }
+        if (args.cursor) {
+            queryParams.cursor = args.cursor;
+        }
+        if (args.limit) {
+            queryParams.limit = args.limit;
+        }
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_WORKSPACE_USERS,
+            apiToken: this.authToken,
+            payload: queryParams,
+            requestId: requestId,
+        });
+        return {
+            hasMore: response.data.has_more || false,
+            nextCursor: response.data.next_cursor,
+            workspaceUsers: (0, validators_1.validateWorkspaceUserArray)(response.data.workspace_users || []),
+        };
+    }
+    /**
+     * Gets active projects in a workspace with pagination.
+     *
+     * @param args - Arguments including workspace ID, cursor, and limit.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Paginated list of active workspace projects.
+     */
+    async getWorkspaceActiveProjects(args, requestId) {
+        var _a;
+        const queryParams = {};
+        if (args.cursor) {
+            queryParams.cursor = args.cursor;
+        }
+        if (args.limit) {
+            queryParams.limit = args.limit;
+        }
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: (0, endpoints_1.getWorkspaceActiveProjectsEndpoint)(args.workspaceId),
+            apiToken: this.authToken,
+            payload: queryParams,
+            requestId: requestId,
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+        const validatedProjects = (_a = response.data.results) === null || _a === void 0 ? void 0 : _a.map((project) => (0, validators_1.validateProject)(project));
+        return Object.assign(Object.assign({}, response.data), { 
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            results: validatedProjects || [] });
+    }
+    /**
+     * Gets archived projects in a workspace with pagination.
+     *
+     * @param args - Arguments including workspace ID, cursor, and limit.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Paginated list of archived workspace projects.
+     */
+    async getWorkspaceArchivedProjects(args, requestId) {
+        var _a;
+        const queryParams = {};
+        if (args.cursor) {
+            queryParams.cursor = args.cursor;
+        }
+        if (args.limit) {
+            queryParams.limit = args.limit;
+        }
+        const response = await (0, rest_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: (0, endpoints_1.getWorkspaceArchivedProjectsEndpoint)(args.workspaceId),
+            apiToken: this.authToken,
+            payload: queryParams,
+            requestId: requestId,
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+        const validatedProjects = (_a = response.data.results) === null || _a === void 0 ? void 0 : _a.map((project) => (0, validators_1.validateProject)(project));
+        return Object.assign(Object.assign({}, response.data), { 
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            results: validatedProjects || [] });
+    }
+}
+exports.TodoistApi = TodoistApi;