@doist/todoist-api-typescript 5.7.0 → 5.8.0

package/dist/TodoistApi.d.ts

@@ -1,5 +1,5 @@
-import { PersonalProject, WorkspaceProject, Label, Section, Comment, Task, CurrentUser, ProductivityStats } from './types/entities';
-import { AddCommentArgs, AddLabelArgs, AddProjectArgs, AddSectionArgs, AddTaskArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetTasksArgs, GetTasksByFilterArgs, UpdateCommentArgs, UpdateLabelArgs, UpdateProjectArgs, UpdateSectionArgs, UpdateTaskArgs, QuickAddTaskArgs, GetSharedLabelsArgs, RenameSharedLabelArgs, RemoveSharedLabelArgs, GetProjectsArgs, GetProjectCollaboratorsArgs, GetLabelsArgs, GetLabelsResponse, GetTasksResponse, GetProjectsResponse, GetProjectCollaboratorsResponse, GetSectionsArgs, GetSectionsResponse, GetSharedLabelsResponse, GetCommentsResponse, type MoveTaskArgs, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, GetArchivedProjectsArgs, GetArchivedProjectsResponse, SearchCompletedTasksArgs, GetActivityLogsArgs, GetActivityLogsResponse } from './types/requests';
+import { Attachment, PersonalProject, WorkspaceProject, Label, Section, Comment, Task, CurrentUser, ProductivityStats } from './types/entities';
+import { AddCommentArgs, AddLabelArgs, AddProjectArgs, AddSectionArgs, AddTaskArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetTasksArgs, GetTasksByFilterArgs, UpdateCommentArgs, UpdateLabelArgs, UpdateProjectArgs, UpdateSectionArgs, UpdateTaskArgs, QuickAddTaskArgs, GetSharedLabelsArgs, RenameSharedLabelArgs, RemoveSharedLabelArgs, GetProjectsArgs, GetProjectCollaboratorsArgs, GetLabelsArgs, GetLabelsResponse, GetTasksResponse, GetProjectsResponse, GetProjectCollaboratorsResponse, GetSectionsArgs, GetSectionsResponse, GetSharedLabelsResponse, GetCommentsResponse, type MoveTaskArgs, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, GetArchivedProjectsArgs, GetArchivedProjectsResponse, SearchCompletedTasksArgs, GetActivityLogsArgs, GetActivityLogsResponse, UploadFileArgs, DeleteUploadArgs } from './types/requests';
 /**
  * A client for interacting with the Todoist API v1.
  * This class provides methods to manage tasks, projects, sections, labels, and comments in Todoist.
@@ -369,4 +369,57 @@ export declare class TodoistApi {
      * @returns A promise that resolves to a paginated response of activity events.
      */
     getActivityLogs(args?: GetActivityLogsArgs): Promise<GetActivityLogsResponse>;
+    /**
+     * 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
+     *   }
+     * })
+     * ```
+     */
+    uploadFile(args: UploadFileArgs, requestId?: string): Promise<Attachment>;
+    /**
+     * 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/...'
+     * })
+     * ```
+     */
+    deleteUpload(args: DeleteUploadArgs, requestId?: string): Promise<boolean>;
 }

package/dist/TodoistApi.js

@@ -46,12 +46,19 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TodoistApi = void 0;
 var restClient_1 = require("./restClient");
 var endpoints_1 = require("./consts/endpoints");
 var validators_1 = require("./utils/validators");
 var urlHelpers_1 = require("./utils/urlHelpers");
+var form_data_1 = __importDefault(require("form-data"));
+var fs_1 = require("fs");
+var path_1 = require("path");
+var axios_1 = __importDefault(require("axios"));
 var activity_helpers_1 = require("./utils/activity-helpers");
 var zod_1 = require("zod");
 var uuid_1 = require("uuid");
@@ -1089,6 +1096,114 @@ var TodoistApi = /** @class */ (function () {
             });
         });
     };
+    /**
+     * 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
+     *   }
+     * })
+     * ```
+     */
+    TodoistApi.prototype.uploadFile = function (args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var form, filePath, fileName, url, headers, response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        form = new form_data_1.default();
+                        // Determine file type and add to form data
+                        if (typeof args.file === 'string') {
+                            filePath = args.file;
+                            fileName = args.fileName || (0, path_1.basename)(filePath);
+                            form.append('file', (0, fs_1.createReadStream)(filePath), fileName);
+                        }
+                        else if (Buffer.isBuffer(args.file)) {
+                            // Buffer - require fileName
+                            if (!args.fileName) {
+                                throw new Error('fileName is required when uploading from a Buffer');
+                            }
+                            form.append('file', args.file, args.fileName);
+                        }
+                        else {
+                            // Stream - require fileName
+                            if (!args.fileName) {
+                                throw new Error('fileName is required when uploading from a stream');
+                            }
+                            form.append('file', args.file, args.fileName);
+                        }
+                        // Add optional project_id as a form field
+                        if (args.projectId) {
+                            form.append('project_id', args.projectId);
+                        }
+                        url = "".concat(this.syncApiBase).concat(endpoints_1.ENDPOINT_REST_UPLOADS);
+                        headers = __assign({ Authorization: "Bearer ".concat(this.authToken) }, form.getHeaders());
+                        if (requestId) {
+                            headers['X-Request-Id'] = requestId;
+                        }
+                        return [4 /*yield*/, axios_1.default.post(url, form, { headers: headers })];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, validators_1.validateAttachment)(response.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/...'
+     * })
+     * ```
+     */
+    TodoistApi.prototype.deleteUpload = function (args, requestId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, (0, restClient_1.request)('DELETE', this.syncApiBase, endpoints_1.ENDPOINT_REST_UPLOADS, this.authToken, args, requestId)];
+                    case 1:
+                        response = _a.sent();
+                        return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+                }
+            });
+        });
+    };
     return TodoistApi;
 }());
 exports.TodoistApi = TodoistApi;

package/dist/authentication.d.ts

@@ -29,6 +29,15 @@ export type RevokeAuthTokenRequestArgs = {
     clientSecret: string;
     accessToken: string;
 };
+/**
+ * Parameters required to revoke a token using RFC 7009 compliant endpoint.
+ * @see https://todoist.com/api/v1/docs#tag/Authorization
+ */
+export type RevokeTokenRequestArgs = {
+    clientId: string;
+    clientSecret: string;
+    token: string;
+};
 /**
  * Generates a random state parameter for OAuth2 authorization.
  * The state parameter helps prevent CSRF attacks.
@@ -88,7 +97,28 @@ export declare function getAuthToken(args: AuthTokenRequestArgs, baseUrl?: strin
  * })
  * ```
  *
+ * @deprecated Use {@link revokeToken} instead. This function uses a legacy endpoint that will be removed in a future version. The new function uses the RFC 7009 compliant endpoint.
  * @returns True if revocation was successful
  * @see https://todoist.com/api/v1/docs#tag/Authorization/operation/revoke_access_token_api_api_v1_access_tokens_delete
  */
 export declare function revokeAuthToken(args: RevokeAuthTokenRequestArgs, baseUrl?: string): Promise<boolean>;
+/**
+ * Revokes a token using the RFC 7009 OAuth 2.0 Token Revocation standard.
+ *
+ * This function uses HTTP Basic Authentication with client credentials and follows
+ * the RFC 7009 specification for token revocation.
+ *
+ * @example
+ * ```typescript
+ * await revokeToken({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ *   token: 'access-token-to-revoke'
+ * })
+ * ```
+ *
+ * @returns True if revocation was successful
+ * @see https://datatracker.ietf.org/doc/html/rfc7009
+ * @see https://todoist.com/api/v1/docs#tag/Authorization
+ */
+export declare function revokeToken(args: RevokeTokenRequestArgs, baseUrl?: string): Promise<boolean>;

package/dist/authentication.js

@@ -40,10 +40,21 @@ exports.getAuthStateParameter = getAuthStateParameter;
 exports.getAuthorizationUrl = getAuthorizationUrl;
 exports.getAuthToken = getAuthToken;
 exports.revokeAuthToken = revokeAuthToken;
+exports.revokeToken = revokeToken;
 var restClient_1 = require("./restClient");
 var uuid_1 = require("uuid");
 var types_1 = require("./types");
 var endpoints_1 = require("./consts/endpoints");
+/**
+ * Creates a Basic Authentication header value from client credentials.
+ * @param clientId - The OAuth client ID
+ * @param clientSecret - The OAuth client secret
+ * @returns The Basic Auth header value (without the 'Basic ' prefix)
+ */
+function createBasicAuthHeader(clientId, clientSecret) {
+    var credentials = "".concat(clientId, ":").concat(clientSecret);
+    return Buffer.from(credentials).toString('base64');
+}
 /**
  * Generates a random state parameter for OAuth2 authorization.
  * The state parameter helps prevent CSRF attacks.
@@ -127,6 +138,7 @@ function getAuthToken(args, baseUrl) {
  * })
  * ```
  *
+ * @deprecated Use {@link revokeToken} instead. This function uses a legacy endpoint that will be removed in a future version. The new function uses the RFC 7009 compliant endpoint.
  * @returns True if revocation was successful
  * @see https://todoist.com/api/v1/docs#tag/Authorization/operation/revoke_access_token_api_api_v1_access_tokens_delete
  */
@@ -143,3 +155,45 @@ function revokeAuthToken(args, baseUrl) {
         });
     });
 }
+/**
+ * Revokes a token using the RFC 7009 OAuth 2.0 Token Revocation standard.
+ *
+ * This function uses HTTP Basic Authentication with client credentials and follows
+ * the RFC 7009 specification for token revocation.
+ *
+ * @example
+ * ```typescript
+ * await revokeToken({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ *   token: 'access-token-to-revoke'
+ * })
+ * ```
+ *
+ * @returns True if revocation was successful
+ * @see https://datatracker.ietf.org/doc/html/rfc7009
+ * @see https://todoist.com/api/v1/docs#tag/Authorization
+ */
+function revokeToken(args, baseUrl) {
+    return __awaiter(this, void 0, void 0, function () {
+        var clientId, clientSecret, token, basicAuth, customHeaders, requestBody, response;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    clientId = args.clientId, clientSecret = args.clientSecret, token = args.token;
+                    basicAuth = createBasicAuthHeader(clientId, clientSecret);
+                    customHeaders = {
+                        Authorization: "Basic ".concat(basicAuth),
+                    };
+                    requestBody = {
+                        token: token,
+                        token_type_hint: 'access_token',
+                    };
+                    return [4 /*yield*/, (0, restClient_1.request)('POST', (0, endpoints_1.getSyncBaseUri)(baseUrl), endpoints_1.ENDPOINT_REVOKE, undefined, requestBody, undefined, false, customHeaders)];
+                case 1:
+                    response = _a.sent();
+                    return [2 /*return*/, (0, restClient_1.isSuccess)(response)];
+            }
+        });
+    });
+}

package/dist/consts/endpoints.d.ts

@@ -23,6 +23,7 @@ export declare const ENDPOINT_REST_PROJECT_COLLABORATORS = "collaborators";
 export declare const ENDPOINT_REST_USER = "user";
 export declare const ENDPOINT_REST_PRODUCTIVITY: string;
 export declare const ENDPOINT_REST_ACTIVITIES = "activities";
+export declare const ENDPOINT_REST_UPLOADS = "uploads";
 export declare const PROJECT_ARCHIVE = "archive";
 export declare const PROJECT_UNARCHIVE = "unarchive";
 export declare const ENDPOINT_SYNC_QUICK_ADD: string;
@@ -30,3 +31,4 @@ export declare const ENDPOINT_SYNC = "sync";
 export declare const ENDPOINT_AUTHORIZATION = "authorize";
 export declare const ENDPOINT_GET_TOKEN = "access_token";
 export declare const ENDPOINT_REVOKE_TOKEN = "access_tokens/revoke";
+export declare const ENDPOINT_REVOKE = "revoke";

package/dist/consts/endpoints.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENDPOINT_REVOKE_TOKEN = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.PROJECT_UNARCHIVE = exports.PROJECT_ARCHIVE = exports.ENDPOINT_REST_ACTIVITIES = exports.ENDPOINT_REST_PRODUCTIVITY = exports.ENDPOINT_REST_USER = exports.ENDPOINT_REST_PROJECT_COLLABORATORS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED = exports.ENDPOINT_REST_PROJECTS = exports.ENDPOINT_REST_TASK_MOVE = exports.ENDPOINT_REST_TASK_REOPEN = exports.ENDPOINT_REST_TASK_CLOSE = exports.ENDPOINT_REST_COMMENTS = exports.ENDPOINT_REST_LABELS_SHARED_REMOVE = exports.ENDPOINT_REST_LABELS_SHARED_RENAME = exports.ENDPOINT_REST_LABELS_SHARED = exports.ENDPOINT_REST_LABELS = exports.ENDPOINT_REST_SECTIONS = exports.ENDPOINT_REST_TASKS_COMPLETED_SEARCH = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE = exports.ENDPOINT_REST_TASKS_FILTER = exports.ENDPOINT_REST_TASKS = exports.API_BASE_URI = exports.API_VERSION = exports.TODOIST_WEB_URI = void 0;
+exports.ENDPOINT_REVOKE = exports.ENDPOINT_REVOKE_TOKEN = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.PROJECT_UNARCHIVE = exports.PROJECT_ARCHIVE = exports.ENDPOINT_REST_UPLOADS = exports.ENDPOINT_REST_ACTIVITIES = exports.ENDPOINT_REST_PRODUCTIVITY = exports.ENDPOINT_REST_USER = exports.ENDPOINT_REST_PROJECT_COLLABORATORS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED = exports.ENDPOINT_REST_PROJECTS = exports.ENDPOINT_REST_TASK_MOVE = exports.ENDPOINT_REST_TASK_REOPEN = exports.ENDPOINT_REST_TASK_CLOSE = exports.ENDPOINT_REST_COMMENTS = exports.ENDPOINT_REST_LABELS_SHARED_REMOVE = exports.ENDPOINT_REST_LABELS_SHARED_RENAME = exports.ENDPOINT_REST_LABELS_SHARED = exports.ENDPOINT_REST_LABELS = exports.ENDPOINT_REST_SECTIONS = exports.ENDPOINT_REST_TASKS_COMPLETED_SEARCH = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE = exports.ENDPOINT_REST_TASKS_FILTER = exports.ENDPOINT_REST_TASKS = exports.API_BASE_URI = exports.API_VERSION = exports.TODOIST_WEB_URI = void 0;
 exports.getSyncBaseUri = getSyncBaseUri;
 exports.getAuthBaseUri = getAuthBaseUri;
 var BASE_URI = 'https://api.todoist.com';
@@ -39,6 +39,7 @@ exports.ENDPOINT_REST_PROJECT_COLLABORATORS = 'collaborators';
 exports.ENDPOINT_REST_USER = 'user';
 exports.ENDPOINT_REST_PRODUCTIVITY = exports.ENDPOINT_REST_TASKS + '/completed/stats';
 exports.ENDPOINT_REST_ACTIVITIES = 'activities';
+exports.ENDPOINT_REST_UPLOADS = 'uploads';
 exports.PROJECT_ARCHIVE = 'archive';
 exports.PROJECT_UNARCHIVE = 'unarchive';
 exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_TASKS + '/quick';
@@ -46,3 +47,4 @@ exports.ENDPOINT_SYNC = 'sync';
 exports.ENDPOINT_AUTHORIZATION = 'authorize';
 exports.ENDPOINT_GET_TOKEN = 'access_token';
 exports.ENDPOINT_REVOKE_TOKEN = 'access_tokens/revoke';
+exports.ENDPOINT_REVOKE = 'revoke';

package/dist/restClient.d.ts

@@ -2,4 +2,4 @@ import { AxiosResponse } from 'axios';
 import { HttpMethod } from './types/http';
 export declare function paramsSerializer(params: Record<string, unknown>): string;
 export declare function isSuccess(response: AxiosResponse): boolean;
-export declare function request<T>(httpMethod: HttpMethod, baseUri: string, relativePath: string, apiToken?: string, payload?: Record<string, unknown>, requestId?: string, hasSyncCommands?: boolean): Promise<AxiosResponse<T>>;
+export declare function request<T>(httpMethod: HttpMethod, baseUri: string, relativePath: string, apiToken?: string, payload?: Record<string, unknown>, requestId?: string, hasSyncCommands?: boolean, customHeaders?: Record<string, string>): Promise<AxiosResponse<T>>;

package/dist/restClient.js

@@ -100,14 +100,14 @@ function getTodoistRequestError(error, originalStack) {
     }
     return requestError;
 }
-function getRequestConfiguration(baseURL, apiToken, requestId) {
+function getRequestConfiguration(baseURL, apiToken, requestId, customHeaders) {
     var authHeader = apiToken ? { Authorization: getAuthHeader(apiToken) } : undefined;
     var requestIdHeader = requestId ? { 'X-Request-Id': requestId } : undefined;
-    var headers = __assign(__assign(__assign({}, defaultHeaders), authHeader), requestIdHeader);
+    var headers = __assign(__assign(__assign(__assign({}, defaultHeaders), authHeader), requestIdHeader), customHeaders);
     return { baseURL: baseURL, headers: headers };
 }
-function getAxiosClient(baseURL, apiToken, requestId) {
-    var configuration = getRequestConfiguration(baseURL, apiToken, requestId);
+function getAxiosClient(baseURL, apiToken, requestId, customHeaders) {
+    var configuration = getRequestConfiguration(baseURL, apiToken, requestId, customHeaders);
     var client = (0, axios_case_converter_1.default)(axios_1.default.create(configuration), {
         caseFunctions: {
             camel: processing_helpers_1.customCamelCase,
@@ -123,7 +123,7 @@ function getAxiosClient(baseURL, apiToken, requestId) {
 function isSuccess(response) {
     return response.status >= 200 && response.status < 300;
 }
-function request(httpMethod, baseUri, relativePath, apiToken, payload, requestId, hasSyncCommands) {
+function request(httpMethod, baseUri, relativePath, apiToken, payload, requestId, hasSyncCommands, customHeaders) {
     return __awaiter(this, void 0, void 0, function () {
         var originalStack, axiosClient, _a, error_1;
         return __generator(this, function (_b) {
@@ -137,7 +137,7 @@ function request(httpMethod, baseUri, relativePath, apiToken, payload, requestId
                     if (httpMethod === 'POST' && !requestId && !baseUri.includes(endpoints_1.API_BASE_URI)) {
                         requestId = (0, uuid_1.v4)();
                     }
-                    axiosClient = getAxiosClient(baseUri, apiToken, requestId);
+                    axiosClient = getAxiosClient(baseUri, apiToken, requestId, customHeaders);
                     _a = httpMethod;
                     switch (_a) {
                         case 'GET': return [3 /*break*/, 2];

package/dist/types/entities.d.ts

@@ -703,7 +703,7 @@ export declare const ActivityEventSchema: z.ZodObject<{
     objectId: z.ZodString;
     eventType: z.ZodString;
     eventDate: z.ZodString;
-    id: z.ZodNullable<z.ZodString>;
+    id: z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
     parentProjectId: z.ZodNullable<z.ZodString>;
     parentItemId: z.ZodNullable<z.ZodString>;
     initiatorId: z.ZodNullable<z.ZodString>;

package/dist/types/entities.js

@@ -310,7 +310,10 @@ exports.ActivityEventSchema = zod_1.z
     objectId: zod_1.z.string(),
     eventType: zod_1.z.string(),
     eventDate: zod_1.z.string(),
-    id: zod_1.z.string().nullable(),
+    id: zod_1.z
+        .union([zod_1.z.string(), zod_1.z.number()])
+        .transform(function (val) { var _a; return (_a = val === null || val === void 0 ? void 0 : val.toString()) !== null && _a !== void 0 ? _a : null; })
+        .nullable(),
     parentProjectId: zod_1.z.string().nullable(),
     parentItemId: zod_1.z.string().nullable(),
     initiatorId: zod_1.z.string().nullable(),

package/dist/types/requests.d.ts

@@ -478,4 +478,36 @@ export type GetActivityLogsResponse = {
     results: ActivityEvent[];
     nextCursor: string | null;
 };
+/**
+ * Arguments for uploading a file.
+ * @see https://todoist.com/api/v1/docs#tag/Uploads/operation/upload_file_api_v1_uploads_post
+ */
+export type UploadFileArgs = {
+    /**
+     * The file content to upload. Can be:
+     * - Buffer: File content as a Buffer (requires fileName)
+     * - ReadableStream: File content as a stream (requires fileName)
+     * - string: Path to a file on the filesystem (fileName is optional, will be inferred from path)
+     */
+    file: Buffer | NodeJS.ReadableStream | string;
+    /**
+     * The name of the file. Required for Buffer and Stream inputs.
+     * Optional for file path strings (will be inferred from the path if not provided).
+     */
+    fileName?: string;
+    /**
+     * The project ID to associate the upload with.
+     */
+    projectId?: string | null;
+};
+/**
+ * Arguments for deleting an uploaded file.
+ * @see https://todoist.com/api/v1/docs#tag/Uploads/operation/delete_upload_api_v1_uploads_delete
+ */
+export type DeleteUploadArgs = {
+    /**
+     * The URL of the file to delete.
+     */
+    fileUrl: string;
+};
 export {};

package/dist/utils/validators.d.ts

@@ -1,4 +1,4 @@
-import { type Task, type Section, type Label, type Comment, type User, type CurrentUser, type ProductivityStats, type WorkspaceProject, type PersonalProject, type ActivityEvent } from '../types/entities';
+import { type Attachment, type Task, type Section, type Label, type Comment, type User, type CurrentUser, type ProductivityStats, type WorkspaceProject, type PersonalProject, type ActivityEvent } from '../types/entities';
 export declare function validateTask(input: unknown): Task;
 export declare function validateTaskArray(input: unknown[]): Task[];
 /**
@@ -32,3 +32,4 @@ export declare function validateProductivityStats(input: unknown): ProductivityS
 export declare function validateCurrentUser(input: unknown): CurrentUser;
 export declare function validateActivityEvent(input: unknown): ActivityEvent;
 export declare function validateActivityEventArray(input: unknown[]): ActivityEvent[];
+export declare function validateAttachment(input: unknown): Attachment;

package/dist/utils/validators.js

@@ -18,6 +18,7 @@ exports.validateProductivityStats = validateProductivityStats;
 exports.validateCurrentUser = validateCurrentUser;
 exports.validateActivityEvent = validateActivityEvent;
 exports.validateActivityEventArray = validateActivityEventArray;
+exports.validateAttachment = validateAttachment;
 var entities_1 = require("../types/entities");
 function validateTask(input) {
     return entities_1.TaskSchema.parse(input);
@@ -91,3 +92,6 @@ function validateActivityEvent(input) {
 function validateActivityEventArray(input) {
     return input.map(validateActivityEvent);
 }
+function validateAttachment(input) {
+    return entities_1.AttachmentSchema.parse(input);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-api-typescript",
-    "version": "5.7.0",
+    "version": "5.8.0",
     "description": "A typescript wrapper for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "git@github.com:doist/todoist-api-typescript.git",
@@ -28,10 +28,11 @@
         "axios-case-converter": "^1.0.0",
         "axios-retry": "^4.0.0",
         "camelcase": "6.3.0",
-        "emoji-regex": "10.5.0",
+        "emoji-regex": "10.6.0",
+        "form-data": "4.0.4",
         "ts-custom-error": "^3.2.0",
         "uuid": "11.1.0",
-        "zod": "4.1.5"
+        "zod": "4.1.12"
     },
     "devDependencies": {
         "@doist/eslint-config": "11.1.0",
@@ -50,10 +51,10 @@
         "npm-run-all2": "8.0.4",
         "prettier": "3.3.2",
         "rimraf": "6.0.1",
-        "ts-jest": "29.4.1",
+        "ts-jest": "29.4.5",
         "ts-node": "10.9.2",
         "type-fest": "^4.12.0",
-        "typescript": "5.9.2"
+        "typescript": "5.9.3"
     },
     "peerDependencies": {
         "type-fest": "^4.12.0"