@doist/todoist-api-typescript 6.10.0 → 7.1.0

package/README.md

@@ -135,6 +135,30 @@ api.getProjects()
     .catch((error) => console.error(error))
 ```
 
+### Local API Requests With .env
+
+For live API verification, you can run raw requests with a local token:
+
+1. Copy `.env.example` to `.env`.
+2. Set `TODOIST_API_TOKEN` in `.env`.
+3. Run requests with `npm run api:request -- ...`.
+4. Optional: set `TODOIST_API_BASE_URL` in `.env` (defaults to `https://api.todoist.com`).
+
+Examples:
+
+```bash
+npm run api:request -- --path /api/v1/tasks
+npm run api:request -- --method POST --path /api/v1/tasks --body '{"content":"API smoke test"}'
+npm run api:request -- --method POST --path /api/v1/tasks/123 --body '{"due_string":"no date"}'
+npm run api:request -- --path /api/v1/tasks --query '{"project_id":"123","limit":10}'
+```
+
+To see all options:
+
+```bash
+npm run api:request -- --help
+```
+
 ## Releases
 
 This project uses [Release Please](https://github.com/googleapis/release-please) to automate releases. Releases are created automatically based on [Conventional Commits](https://www.conventionalcommits.org/).

package/dist/cjs/authentication.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAuthStateParameter = getAuthStateParameter;
 exports.getAuthorizationUrl = getAuthorizationUrl;
 exports.getAuthToken = getAuthToken;
-exports.revokeAuthToken = revokeAuthToken;
 exports.revokeToken = revokeToken;
 const rest_client_1 = require("./rest-client");
 const uuid_1 = require("uuid");
@@ -58,20 +57,28 @@ function getAuthorizationUrl({ clientId, permissions, state, baseUrl, }) {
     const scope = permissions.join(',');
     return `${(0, endpoints_1.getAuthBaseUri)(baseUrl)}${endpoints_1.ENDPOINT_AUTHORIZATION}?client_id=${clientId}&scope=${scope}&state=${state}`;
 }
-async function getAuthToken(args, baseUrlOrOptions) {
+/**
+ * Exchanges an authorization code for an access token.
+ *
+ * @example
+ * ```typescript
+ * const { accessToken } = await getAuthToken({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ *   code: authCode
+ * })
+ * ```
+ *
+ * @returns The access token response
+ * @throws {@link TodoistRequestError} If the token exchange fails
+ */
+async function getAuthToken(args, options) {
     var _a;
-    let baseUrl;
-    let customFetch;
-    if (typeof baseUrlOrOptions === 'string') {
-        // Legacy signature: (args, baseUrl)
-        baseUrl = baseUrlOrOptions;
-        customFetch = undefined;
-    }
-    else if (baseUrlOrOptions) {
-        // New signature: (args, options)
-        baseUrl = baseUrlOrOptions.baseUrl;
-        customFetch = baseUrlOrOptions.customFetch;
+    if (typeof options === 'string') {
+        throw new TypeError('Passing baseUrl as a string is no longer supported. Use an options object instead: getAuthToken(args, { baseUrl })');
     }
+    const baseUrl = options === null || options === void 0 ? void 0 : options.baseUrl;
+    const customFetch = options === null || options === void 0 ? void 0 : options.customFetch;
     try {
         const response = await (0, rest_client_1.request)({
             httpMethod: 'POST',
@@ -92,42 +99,31 @@ async function getAuthToken(args, baseUrlOrOptions) {
         throw new types_1.TodoistRequestError('Authentication token exchange failed.', err.httpStatusCode, err.responseData);
     }
 }
-async function revokeAuthToken(args, baseUrlOrOptions) {
-    let baseUrl;
-    let customFetch;
-    if (typeof baseUrlOrOptions === 'string') {
-        // Legacy signature: (args, baseUrl)
-        baseUrl = baseUrlOrOptions;
-        customFetch = undefined;
-    }
-    else if (baseUrlOrOptions) {
-        // New signature: (args, options)
-        baseUrl = baseUrlOrOptions.baseUrl;
-        customFetch = baseUrlOrOptions.customFetch;
-    }
-    const response = await (0, rest_client_1.request)({
-        httpMethod: 'POST',
-        baseUri: (0, endpoints_1.getSyncBaseUri)(baseUrl),
-        relativePath: endpoints_1.ENDPOINT_REVOKE_TOKEN,
-        apiToken: undefined,
-        payload: args,
-        customFetch,
-    });
-    return (0, rest_client_1.isSuccess)(response);
-}
-async function revokeToken(args, baseUrlOrOptions) {
-    let baseUrl;
-    let customFetch;
-    if (typeof baseUrlOrOptions === 'string') {
-        // Legacy signature: (args, baseUrl)
-        baseUrl = baseUrlOrOptions;
-        customFetch = undefined;
-    }
-    else if (baseUrlOrOptions) {
-        // New signature: (args, options)
-        baseUrl = baseUrlOrOptions.baseUrl;
-        customFetch = baseUrlOrOptions.customFetch;
+/**
+ * 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
+ */
+async function revokeToken(args, options) {
+    if (typeof options === 'string') {
+        throw new TypeError('Passing baseUrl as a string is no longer supported. Use an options object instead: revokeToken(args, { baseUrl })');
     }
+    const baseUrl = options === null || options === void 0 ? void 0 : options.baseUrl;
+    const customFetch = options === null || options === void 0 ? void 0 : options.customFetch;
     const { clientId, clientSecret, token } = args;
     // Create Basic Auth header as per RFC 7009
     const basicAuth = createBasicAuthHeader(clientId, clientSecret);

package/dist/cjs/consts/endpoints.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENDPOINT_WORKSPACE_USERS = exports.ENDPOINT_WORKSPACE_PLAN_DETAILS = exports.ENDPOINT_WORKSPACE_LOGO = exports.ENDPOINT_WORKSPACE_JOIN = exports.ENDPOINT_WORKSPACE_INVITATIONS_DELETE = exports.ENDPOINT_WORKSPACE_INVITATIONS_ALL = exports.ENDPOINT_WORKSPACE_INVITATIONS = exports.ENDPOINT_REVOKE = exports.ENDPOINT_REVOKE_TOKEN = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE = exports.PROJECT_UNARCHIVE = exports.PROJECT_ARCHIVE = exports.ENDPOINT_REST_UPLOADS = exports.ENDPOINT_REST_ACTIVITIES = exports.ENDPOINT_REST_PRODUCTIVITY = exports.ENDPOINT_REST_USER = exports.ENDPOINT_REST_PROJECT_COLLABORATORS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED = exports.ENDPOINT_REST_PROJECTS_SEARCH = exports.ENDPOINT_REST_PROJECTS = exports.ENDPOINT_REST_TASK_MOVE = exports.ENDPOINT_REST_TASK_REOPEN = exports.ENDPOINT_REST_TASK_CLOSE = exports.ENDPOINT_REST_COMMENTS = exports.ENDPOINT_REST_LABELS_SHARED_REMOVE = exports.ENDPOINT_REST_LABELS_SHARED_RENAME = exports.ENDPOINT_REST_LABELS_SHARED = exports.ENDPOINT_REST_LABELS_SEARCH = exports.ENDPOINT_REST_LABELS = exports.ENDPOINT_REST_SECTIONS_SEARCH = exports.ENDPOINT_REST_SECTIONS = exports.ENDPOINT_REST_TASKS_COMPLETED_SEARCH = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE = exports.ENDPOINT_REST_TASKS_FILTER = exports.ENDPOINT_REST_TASKS = exports.API_BASE_URI = exports.API_VERSION = exports.TODOIST_WEB_URI = void 0;
+exports.ENDPOINT_WORKSPACE_USERS = exports.ENDPOINT_WORKSPACE_PLAN_DETAILS = exports.ENDPOINT_WORKSPACE_LOGO = exports.ENDPOINT_WORKSPACE_JOIN = exports.ENDPOINT_WORKSPACE_INVITATIONS_DELETE = exports.ENDPOINT_WORKSPACE_INVITATIONS_ALL = exports.ENDPOINT_WORKSPACE_INVITATIONS = exports.ENDPOINT_REVOKE = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE = exports.PROJECT_UNARCHIVE = exports.PROJECT_ARCHIVE = exports.ENDPOINT_REST_UPLOADS = exports.ENDPOINT_REST_ACTIVITIES = exports.ENDPOINT_REST_PRODUCTIVITY = exports.ENDPOINT_REST_USER = exports.ENDPOINT_REST_PROJECT_COLLABORATORS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED = exports.ENDPOINT_REST_PROJECTS_SEARCH = exports.ENDPOINT_REST_PROJECTS = exports.ENDPOINT_REST_TASK_MOVE = exports.ENDPOINT_REST_TASK_REOPEN = exports.ENDPOINT_REST_TASK_CLOSE = exports.ENDPOINT_REST_COMMENTS = exports.ENDPOINT_REST_LABELS_SHARED_REMOVE = exports.ENDPOINT_REST_LABELS_SHARED_RENAME = exports.ENDPOINT_REST_LABELS_SHARED = exports.ENDPOINT_REST_LABELS_SEARCH = exports.ENDPOINT_REST_LABELS = exports.ENDPOINT_REST_SECTIONS_SEARCH = exports.ENDPOINT_REST_SECTIONS = exports.ENDPOINT_REST_TASKS_COMPLETED_SEARCH = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE = exports.ENDPOINT_REST_TASKS_FILTER = exports.ENDPOINT_REST_TASKS = exports.API_BASE_URI = exports.API_VERSION = exports.TODOIST_WEB_URI = void 0;
 exports.getSyncBaseUri = getSyncBaseUri;
 exports.getAuthBaseUri = getAuthBaseUri;
 exports.getWorkspaceInvitationAcceptEndpoint = getWorkspaceInvitationAcceptEndpoint;
@@ -53,7 +53,6 @@ exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_TASKS + '/quick';
 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';
 // Workspace endpoints
 exports.ENDPOINT_WORKSPACE_INVITATIONS = 'workspaces/invitations';

package/dist/cjs/test-utils/test-defaults.js

@@ -26,7 +26,6 @@ const DEFAULT_USER_EMAIL = 'atestuser@doist.com';
 const DEFAULT_COMMENT_ID = '4';
 const DEFAULT_COMMENT_CONTENT = 'A comment';
 const DEFAULT_COMMENT_REACTIONS = { '👍': ['1234', '5678'] };
-const DEFAULT_NOTE_COUNT = 0;
 const DEFAULT_CAN_ASSIGN_TASKS = true;
 const DEFAULT_IS_ARCHIVED = false;
 const DEFAULT_IS_DELETED = false;
@@ -76,7 +75,6 @@ exports.DEFAULT_TASK = {
     childOrder: exports.DEFAULT_ORDER,
     content: exports.DEFAULT_TASK_CONTENT,
     description: exports.DEFAULT_TASK_DESCRIPTION,
-    noteCount: DEFAULT_NOTE_COUNT,
     dayOrder: exports.DEFAULT_ORDER,
     isCollapsed: DEFAULT_IS_COLLAPSED,
     isUncompletable: false,
@@ -108,7 +106,6 @@ exports.TASK_WITH_OPTIONALS_AS_NULL = {
     dayOrder: exports.DEFAULT_ORDER,
     isCollapsed: DEFAULT_IS_COLLAPSED,
     isUncompletable: false,
-    noteCount: DEFAULT_NOTE_COUNT,
     url: DEFAULT_TASK_URL,
 };
 exports.DEFAULT_PROJECT = {

package/dist/cjs/todoist-api.js

@@ -62,24 +62,16 @@ class TodoistApi {
      */
     authToken, 
     /**
-     * Optional custom API base URL or options object
+     * Optional configuration options
      */
-    baseUrlOrOptions) {
-        this.authToken = authToken;
-        // Handle backward compatibility
-        if (typeof baseUrlOrOptions === 'string') {
-            // Legacy constructor: (authToken, baseUrl)
-            // eslint-disable-next-line no-console
-            console.warn('TodoistApi constructor with baseUrl as second parameter is deprecated. Use options object instead: new TodoistApi(token, { baseUrl, customFetch })');
-            this.syncApiBase = (0, endpoints_1.getSyncBaseUri)(baseUrlOrOptions);
-            this.customFetch = undefined;
-        }
-        else {
-            // New constructor: (authToken, options)
-            const options = baseUrlOrOptions || {};
-            this.syncApiBase = (0, endpoints_1.getSyncBaseUri)(options.baseUrl);
-            this.customFetch = options.customFetch;
+    options) {
+        if (typeof options === 'string') {
+            throw new TypeError('Passing baseUrl as a string is no longer supported. Use an options object instead: new TodoistApi(token, { baseUrl })');
         }
+        this.authToken = authToken;
+        const opts = options || {};
+        this.syncApiBase = (0, endpoints_1.getSyncBaseUri)(opts.baseUrl);
+        this.customFetch = opts.customFetch;
     }
     /**
      * Makes a request to the Sync API and handles error checking.
@@ -318,22 +310,28 @@ class TodoistApi {
      * 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 args - Update parameters such as content, priority, or due date. Pass
+     * `dueString: null` (or `"no date"`) to clear the 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);
+        // Translate SDK alias for due-date clearing to Todoist's accepted payload value.
+        const normalizedArgs = args.dueString === null ? Object.assign(Object.assign({}, args), { dueString: 'no date' }) : args;
         // Process content if both content and isUncompletable are provided
-        const processedArgs = args.content && args.isUncompletable !== undefined
-            ? Object.assign(Object.assign({}, args), { content: (0, uncompletable_helpers_1.processTaskContent)(args.content, args.isUncompletable) }) : args;
+        const processedArgs = normalizedArgs.content && normalizedArgs.isUncompletable !== undefined
+            ? Object.assign(Object.assign({}, normalizedArgs), { content: (0, uncompletable_helpers_1.processTaskContent)(normalizedArgs.content, normalizedArgs.isUncompletable) }) : normalizedArgs;
+        // Remap `order` → `childOrder` so snakeCaseKeys() produces `child_order`
+        const { order } = processedArgs, argsWithoutOrder = __rest(processedArgs, ["order"]);
+        const remappedArgs = order !== undefined ? Object.assign(Object.assign({}, argsWithoutOrder), { childOrder: order }) : argsWithoutOrder;
         const response = await (0, rest_client_1.request)({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
             relativePath: generatePath(endpoints_1.ENDPOINT_REST_TASKS, id),
             apiToken: this.authToken,
             customFetch: this.customFetch,
-            payload: processedArgs,
+            payload: remappedArgs,
             requestId: requestId,
         });
         return (0, validators_1.validateTask)(response.data);
@@ -345,7 +343,6 @@ class TodoistApi {
      * @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;
@@ -1085,27 +1082,17 @@ class TodoistApi {
      * @returns A promise that resolves to a paginated response of activity events.
      */
     async getActivityLogs(args = {}) {
-        var _a, _b, _c;
-        // Resolve dateFrom: prefer new param, fall back to deprecated `since`
-        const rawDateFrom = (_a = args.dateFrom) !== null && _a !== void 0 ? _a : args.since;
-        const rawDateTo = (_b = args.dateTo) !== null && _b !== void 0 ? _b : args.until;
         // Convert Date objects to YYYY-MM-DD strings
-        const dateFrom = rawDateFrom instanceof Date ? (0, url_helpers_1.formatDateToYYYYMMDD)(rawDateFrom) : rawDateFrom;
-        const dateTo = rawDateTo instanceof Date ? (0, url_helpers_1.formatDateToYYYYMMDD)(rawDateTo) : rawDateTo;
-        // Destructure out deprecated, raw date, and filter-type fields so they don't leak into payload
-        const _d = args, { since: _since, until: _until, dateFrom: _dateFrom, dateTo: _dateTo, objectType, eventType, objectEventTypes } = _d, rest = __rest(_d, ["since", "until", "dateFrom", "dateTo", "objectType", "eventType", "objectEventTypes"]);
+        const dateFrom = args.dateFrom instanceof Date ? (0, url_helpers_1.formatDateToYYYYMMDD)(args.dateFrom) : args.dateFrom;
+        const dateTo = args.dateTo instanceof Date ? (0, url_helpers_1.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(activity_helpers_1.normalizeObjectEventTypeForApi);
         }
-        else if (objectType !== undefined || eventType !== undefined) {
-            // Synthesize combined filter from deprecated separate params
-            const objPart = (_c = (0, activity_helpers_1.normalizeObjectTypeForApi)(objectType)) !== null && _c !== void 0 ? _c : '';
-            const evtPart = eventType !== null && eventType !== void 0 ? eventType : '';
-            normalizedObjectEventTypes = [`${objPart}:${evtPart}`];
-        }
         const processedArgs = Object.assign(Object.assign(Object.assign(Object.assign({}, rest), (dateFrom !== undefined ? { dateFrom } : {})), (dateTo !== undefined ? { dateTo } : {})), (normalizedObjectEventTypes !== undefined
             ? { objectEventTypes: normalizedObjectEventTypes }
             : {}));

package/dist/cjs/types/entities.js

@@ -57,10 +57,6 @@ exports.TaskSchema = zod_1.z
     childOrder: zod_1.z.number().int(),
     content: zod_1.z.string(),
     description: zod_1.z.string(),
-    /**
-     * @deprecated This field is deprecated and will always return 0. It will be removed in a future version. Do not use or rely on this field.
-     */
-    noteCount: zod_1.z.number().int(),
     dayOrder: zod_1.z.number().int(),
     isCollapsed: zod_1.z.boolean(),
     isUncompletable: zod_1.z.boolean().default(false),
@@ -285,20 +281,12 @@ exports.ProductivityStatsSchema = zod_1.z.object({
     })),
 });
 exports.ColorSchema = zod_1.z.object({
-    /** @deprecated No longer used */
-    id: zod_1.z.number(),
     /** The key of the color (i.e. 'berry_red') */
     key: zod_1.z.string(),
     /** The display name of the color (i.e. 'Berry Red') */
     displayName: zod_1.z.string(),
-    /** @deprecated Use {@link Color.displayName} instead */
-    name: zod_1.z.string(),
     /** The hex value of the color (i.e. '#b8255f') */
     hexValue: zod_1.z.string(),
-    /**
-     * @deprecated Use {@link Color.hexValue} instead
-     */
-    value: zod_1.z.string(),
 });
 /**
  * Flexible object containing event-specific data.

package/dist/cjs/utils/colors.js

@@ -1,168 +1,106 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultColor = exports.colors = exports.taupe = exports.gray = exports.charcoal = exports.salmon = exports.magenta = exports.lavender = exports.violet = exports.grape = exports.blue = exports.lightBlue = exports.skyBlue = exports.turquoise = exports.mintGreen = exports.green = exports.limeGreen = exports.oliveGreen = exports.yellow = exports.orange = exports.red = exports.berryRed = void 0;
-exports.getColorById = getColorById;
-exports.getColorByName = getColorByName;
+exports.defaultColor = exports.colors = exports.taupe = exports.grey = exports.charcoal = exports.salmon = exports.magenta = exports.lavender = exports.violet = exports.grape = exports.blue = exports.lightBlue = exports.skyBlue = exports.teal = exports.mintGreen = exports.green = exports.limeGreen = exports.oliveGreen = exports.yellow = exports.orange = exports.red = exports.berryRed = void 0;
 exports.getColorByKey = getColorByKey;
 exports.berryRed = {
-    id: 30,
     key: 'berry_red',
     displayName: 'Berry Red',
-    name: 'Berry Red',
     hexValue: '#b8255f',
-    value: '#b8255f',
 };
 exports.red = {
-    id: 31,
     key: 'red',
     displayName: 'Red',
-    name: 'Red',
     hexValue: '#db4035',
-    value: '#db4035',
 };
 exports.orange = {
-    id: 32,
     key: 'orange',
     displayName: 'Orange',
-    name: 'Orange',
     hexValue: '#ff9933',
-    value: '#ff9933',
 };
 exports.yellow = {
-    id: 33,
     key: 'yellow',
     displayName: 'Yellow',
-    name: 'Yellow',
     hexValue: '#fad000',
-    value: '#fad000',
 };
 exports.oliveGreen = {
-    id: 34,
     key: 'olive_green',
     displayName: 'Olive Green',
-    name: 'Olive Green',
     hexValue: '#afb83b',
-    value: '#afb83b',
 };
 exports.limeGreen = {
-    id: 35,
     key: 'lime_green',
     displayName: 'Lime Green',
-    name: 'Lime Green',
     hexValue: '#7ecc49',
-    value: '#7ecc49',
 };
 exports.green = {
-    id: 36,
     key: 'green',
     displayName: 'Green',
-    name: 'Green',
     hexValue: '#299438',
-    value: '#299438',
 };
 exports.mintGreen = {
-    id: 37,
     key: 'mint_green',
     displayName: 'Mint Green',
-    name: 'Mint Green',
     hexValue: '#6accbc',
-    value: '#6accbc',
 };
-exports.turquoise = {
-    id: 38,
-    key: 'turquoise',
-    displayName: 'Turquoise',
-    name: 'Turquoise',
+exports.teal = {
+    key: 'teal',
+    displayName: 'Teal',
     hexValue: '#158fad',
-    value: '#158fad',
 };
 exports.skyBlue = {
-    id: 39,
     key: 'sky_blue',
     displayName: 'Sky Blue',
-    name: 'Sky Blue',
     hexValue: '#14aaf5',
-    value: '#14aaf5',
 };
 exports.lightBlue = {
-    id: 40,
     key: 'light_blue',
     displayName: 'Light Blue',
-    name: 'Light Blue',
     hexValue: '#96c3eb',
-    value: '#96c3eb',
 };
 exports.blue = {
-    id: 41,
     key: 'blue',
     displayName: 'Blue',
-    name: 'Blue',
     hexValue: '#4073ff',
-    value: '#4073ff',
 };
 exports.grape = {
-    id: 42,
     key: 'grape',
     displayName: 'Grape',
-    name: 'Grape',
     hexValue: '#884dff',
-    value: '#884dff',
 };
 exports.violet = {
-    id: 43,
     key: 'violet',
     displayName: 'Violet',
-    name: 'Violet',
     hexValue: '#af38eb',
-    value: '#af38eb',
 };
 exports.lavender = {
-    id: 44,
     key: 'lavender',
     displayName: 'Lavender',
-    name: 'Lavender',
     hexValue: '#eb96eb',
-    value: '#eb96eb',
 };
 exports.magenta = {
-    id: 45,
     key: 'magenta',
     displayName: 'Magenta',
-    name: 'Magenta',
     hexValue: '#e05194',
-    value: '#e05194',
 };
 exports.salmon = {
-    id: 46,
     key: 'salmon',
     displayName: 'Salmon',
-    name: 'Salmon',
     hexValue: '#ff8d85',
-    value: '#ff8d85',
 };
 exports.charcoal = {
-    id: 47,
     key: 'charcoal',
     displayName: 'Charcoal',
-    name: 'Charcoal',
     hexValue: '#808080',
-    value: '#808080',
 };
-exports.gray = {
-    id: 48,
-    key: 'gray',
-    displayName: 'Gray',
-    name: 'Gray',
+exports.grey = {
+    key: 'grey',
+    displayName: 'Grey',
     hexValue: '#b8b8b8',
-    value: '#b8b8b8',
 };
 exports.taupe = {
-    id: 49,
     key: 'taupe',
     displayName: 'Taupe',
-    name: 'Taupe',
     hexValue: '#ccac93',
-    value: '#ccac93',
 };
 exports.colors = [
     exports.berryRed,
@@ -173,7 +111,7 @@ exports.colors = [
     exports.limeGreen,
     exports.green,
     exports.mintGreen,
-    exports.turquoise,
+    exports.teal,
     exports.skyBlue,
     exports.lightBlue,
     exports.blue,
@@ -183,26 +121,10 @@ exports.colors = [
     exports.magenta,
     exports.salmon,
     exports.charcoal,
-    exports.gray,
+    exports.grey,
     exports.taupe,
 ];
 exports.defaultColor = exports.charcoal;
-/**
- * @private
- * @deprecated Use {@link getColorByKey} instead
- */
-function getColorById(colorId) {
-    const color = exports.colors.find((color) => color.id === colorId);
-    return color !== null && color !== void 0 ? color : exports.defaultColor;
-}
-/**
- * @private
- * @deprecated Use {@link getColorByKey} instead
- */
-function getColorByName(colorName) {
-    const color = exports.colors.find((color) => color.name === colorName);
-    return color !== null && color !== void 0 ? color : exports.defaultColor;
-}
 /**
  * Retrieves a {@link Color} object by its key identifier.
  *

package/dist/esm/authentication.js

@@ -1,7 +1,7 @@
 import { request, isSuccess } from './rest-client.js';
 import { v4 as uuid } from 'uuid';
 import { TodoistRequestError } from './types/index.js';
-import { getAuthBaseUri, getSyncBaseUri, ENDPOINT_AUTHORIZATION, ENDPOINT_GET_TOKEN, ENDPOINT_REVOKE_TOKEN, ENDPOINT_REVOKE, } from './consts/endpoints.js';
+import { getAuthBaseUri, getSyncBaseUri, ENDPOINT_AUTHORIZATION, ENDPOINT_GET_TOKEN, ENDPOINT_REVOKE, } from './consts/endpoints.js';
 /**
  * Creates a Basic Authentication header value from client credentials.
  * @param clientId - The OAuth client ID
@@ -51,20 +51,28 @@ export function getAuthorizationUrl({ clientId, permissions, state, baseUrl, })
     const scope = permissions.join(',');
     return `${getAuthBaseUri(baseUrl)}${ENDPOINT_AUTHORIZATION}?client_id=${clientId}&scope=${scope}&state=${state}`;
 }
-export async function getAuthToken(args, baseUrlOrOptions) {
+/**
+ * Exchanges an authorization code for an access token.
+ *
+ * @example
+ * ```typescript
+ * const { accessToken } = await getAuthToken({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ *   code: authCode
+ * })
+ * ```
+ *
+ * @returns The access token response
+ * @throws {@link TodoistRequestError} If the token exchange fails
+ */
+export async function getAuthToken(args, options) {
     var _a;
-    let baseUrl;
-    let customFetch;
-    if (typeof baseUrlOrOptions === 'string') {
-        // Legacy signature: (args, baseUrl)
-        baseUrl = baseUrlOrOptions;
-        customFetch = undefined;
-    }
-    else if (baseUrlOrOptions) {
-        // New signature: (args, options)
-        baseUrl = baseUrlOrOptions.baseUrl;
-        customFetch = baseUrlOrOptions.customFetch;
+    if (typeof options === 'string') {
+        throw new TypeError('Passing baseUrl as a string is no longer supported. Use an options object instead: getAuthToken(args, { baseUrl })');
     }
+    const baseUrl = options === null || options === void 0 ? void 0 : options.baseUrl;
+    const customFetch = options === null || options === void 0 ? void 0 : options.customFetch;
     try {
         const response = await request({
             httpMethod: 'POST',
@@ -85,42 +93,31 @@ export async function getAuthToken(args, baseUrlOrOptions) {
         throw new TodoistRequestError('Authentication token exchange failed.', err.httpStatusCode, err.responseData);
     }
 }
-export async function revokeAuthToken(args, baseUrlOrOptions) {
-    let baseUrl;
-    let customFetch;
-    if (typeof baseUrlOrOptions === 'string') {
-        // Legacy signature: (args, baseUrl)
-        baseUrl = baseUrlOrOptions;
-        customFetch = undefined;
-    }
-    else if (baseUrlOrOptions) {
-        // New signature: (args, options)
-        baseUrl = baseUrlOrOptions.baseUrl;
-        customFetch = baseUrlOrOptions.customFetch;
-    }
-    const response = await request({
-        httpMethod: 'POST',
-        baseUri: getSyncBaseUri(baseUrl),
-        relativePath: ENDPOINT_REVOKE_TOKEN,
-        apiToken: undefined,
-        payload: args,
-        customFetch,
-    });
-    return isSuccess(response);
-}
-export async function revokeToken(args, baseUrlOrOptions) {
-    let baseUrl;
-    let customFetch;
-    if (typeof baseUrlOrOptions === 'string') {
-        // Legacy signature: (args, baseUrl)
-        baseUrl = baseUrlOrOptions;
-        customFetch = undefined;
-    }
-    else if (baseUrlOrOptions) {
-        // New signature: (args, options)
-        baseUrl = baseUrlOrOptions.baseUrl;
-        customFetch = baseUrlOrOptions.customFetch;
+/**
+ * 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 async function revokeToken(args, options) {
+    if (typeof options === 'string') {
+        throw new TypeError('Passing baseUrl as a string is no longer supported. Use an options object instead: revokeToken(args, { baseUrl })');
     }
+    const baseUrl = options === null || options === void 0 ? void 0 : options.baseUrl;
+    const customFetch = options === null || options === void 0 ? void 0 : options.customFetch;
     const { clientId, clientSecret, token } = args;
     // Create Basic Auth header as per RFC 7009
     const basicAuth = createBasicAuthHeader(clientId, clientSecret);