@doist/todoist-api-typescript 6.9.0 → 6.10.0

package/dist/cjs/rest-client.js

@@ -15,7 +15,7 @@ function paramsSerializer(params) {
         const value = params[key];
         if (value != null) {
             if (Array.isArray(value)) {
-                qs.append(key, value.join(','));
+                qs.append(key, JSON.stringify(value));
             }
             else if (typeof value === 'string' ||
                 typeof value === 'number' ||

package/dist/cjs/todoist-api.js

@@ -1085,18 +1085,30 @@ class TodoistApi {
      * @returns A promise that resolves to a paginated response of activity events.
      */
     async getActivityLogs(args = {}) {
-        var _a, _b;
+        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 and raw date fields so they don't leak into the payload
-        const { since: _since, until: _until, dateFrom: _dateFrom, dateTo: _dateTo } = args, rest = __rest(args, ["since", "until", "dateFrom", "dateTo"]);
-        const processedArgs = Object.assign(Object.assign(Object.assign(Object.assign({}, rest), (dateFrom !== undefined ? { dateFrom } : {})), (dateTo !== undefined ? { dateTo } : {})), spreadIfDefined(args.objectType, (v) => ({
-            objectType: (0, activity_helpers_1.normalizeObjectTypeForApi)(v),
-        })));
+        // 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"]);
+        // 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 }
+            : {}));
         const { data: { results, nextCursor }, } = await (0, rest_client_1.request)({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,

package/dist/cjs/utils/activity-helpers.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeObjectTypeForApi = normalizeObjectTypeForApi;
 exports.denormalizeObjectTypeFromApi = denormalizeObjectTypeFromApi;
+exports.normalizeObjectEventTypeForApi = normalizeObjectEventTypeForApi;
 /**
  * Converts modern SDK object type naming to legacy API naming.
  * Maps 'task' -> 'item' and 'comment' -> 'note' for API requests.
@@ -38,3 +39,20 @@ function denormalizeObjectTypeFromApi(objectType) {
         return 'comment';
     return objectType;
 }
+/**
+ * Normalizes an `ActivityObjectEventType` filter string for the API,
+ * converting modern object type names to legacy API names.
+ * e.g. 'task:added' -> 'item:added', 'comment:' -> 'note:', ':deleted' -> ':deleted'
+ *
+ * @internal
+ */
+function normalizeObjectEventTypeForApi(filter) {
+    var _a, _b;
+    const colonIndex = filter.indexOf(':');
+    if (colonIndex === -1) {
+        return (_a = normalizeObjectTypeForApi(filter)) !== null && _a !== void 0 ? _a : filter;
+    }
+    const objectPart = filter.slice(0, colonIndex);
+    const eventPart = filter.slice(colonIndex); // includes the colon
+    return `${(_b = normalizeObjectTypeForApi(objectPart)) !== null && _b !== void 0 ? _b : objectPart}${eventPart}`;
+}

package/dist/esm/rest-client.js

@@ -10,7 +10,7 @@ export function paramsSerializer(params) {
         const value = params[key];
         if (value != null) {
             if (Array.isArray(value)) {
-                qs.append(key, value.join(','));
+                qs.append(key, JSON.stringify(value));
             }
             else if (typeof value === 'string' ||
                 typeof value === 'number' ||

package/dist/esm/todoist-api.js

@@ -14,7 +14,7 @@ import { getSyncBaseUri, ENDPOINT_REST_TASKS, ENDPOINT_REST_TASKS_FILTER, ENDPOI
 import { validateAttachment, validateComment, validateCommentArray, validateCurrentUser, validateLabel, validateLabelArray, validateProject, validateProjectArray, validateSection, validateSectionArray, validateTask, validateTaskArray, validateUserArray, validateProductivityStats, validateActivityEventArray, validateWorkspaceUserArray, validateWorkspaceInvitation, validateWorkspaceInvitationArray, validateWorkspacePlanDetails, validateJoinWorkspaceResult, validateWorkspaceArray, } from './utils/validators.js';
 import { formatDateToYYYYMMDD } from './utils/url-helpers.js';
 import { uploadMultipartFile } from './utils/multipart-upload.js';
-import { normalizeObjectTypeForApi, denormalizeObjectTypeFromApi } from './utils/activity-helpers.js';
+import { normalizeObjectTypeForApi, normalizeObjectEventTypeForApi, denormalizeObjectTypeFromApi, } from './utils/activity-helpers.js';
 import { processTaskContent } from './utils/uncompletable-helpers.js';
 import { z } from 'zod';
 import { v4 as uuidv4 } from 'uuid';
@@ -1082,18 +1082,30 @@ export class TodoistApi {
      * @returns A promise that resolves to a paginated response of activity events.
      */
     async getActivityLogs(args = {}) {
-        var _a, _b;
+        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 ? formatDateToYYYYMMDD(rawDateFrom) : rawDateFrom;
         const dateTo = rawDateTo instanceof Date ? formatDateToYYYYMMDD(rawDateTo) : rawDateTo;
-        // Destructure out deprecated and raw date fields so they don't leak into the payload
-        const { since: _since, until: _until, dateFrom: _dateFrom, dateTo: _dateTo } = args, rest = __rest(args, ["since", "until", "dateFrom", "dateTo"]);
-        const processedArgs = Object.assign(Object.assign(Object.assign(Object.assign({}, rest), (dateFrom !== undefined ? { dateFrom } : {})), (dateTo !== undefined ? { dateTo } : {})), spreadIfDefined(args.objectType, (v) => ({
-            objectType: normalizeObjectTypeForApi(v),
-        })));
+        // 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"]);
+        // Build normalized objectEventTypes for the API
+        let normalizedObjectEventTypes;
+        if (objectEventTypes !== undefined) {
+            const arr = Array.isArray(objectEventTypes) ? objectEventTypes : [objectEventTypes];
+            normalizedObjectEventTypes = arr.map(normalizeObjectEventTypeForApi);
+        }
+        else if (objectType !== undefined || eventType !== undefined) {
+            // Synthesize combined filter from deprecated separate params
+            const objPart = (_c = 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 }
+            : {}));
         const { data: { results, nextCursor }, } = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,

package/dist/esm/utils/activity-helpers.js

@@ -34,3 +34,20 @@ export function denormalizeObjectTypeFromApi(objectType) {
         return 'comment';
     return objectType;
 }
+/**
+ * Normalizes an `ActivityObjectEventType` filter string for the API,
+ * converting modern object type names to legacy API names.
+ * e.g. 'task:added' -> 'item:added', 'comment:' -> 'note:', ':deleted' -> ':deleted'
+ *
+ * @internal
+ */
+export function normalizeObjectEventTypeForApi(filter) {
+    var _a, _b;
+    const colonIndex = filter.indexOf(':');
+    if (colonIndex === -1) {
+        return (_a = normalizeObjectTypeForApi(filter)) !== null && _a !== void 0 ? _a : filter;
+    }
+    const objectPart = filter.slice(0, colonIndex);
+    const eventPart = filter.slice(colonIndex); // includes the colon
+    return `${(_b = normalizeObjectTypeForApi(objectPart)) !== null && _b !== void 0 ? _b : objectPart}${eventPart}`;
+}

package/dist/types/types/entities.d.ts

@@ -717,6 +717,21 @@ export type ActivityObjectType = 'task' | 'comment' | 'project' | DeprecatedItem
  * Type hints for known event types. Accepts any string for forward compatibility.
  */
 export type ActivityEventType = 'added' | 'updated' | 'deleted' | 'completed' | 'uncompleted' | 'archived' | 'unarchived' | 'shared' | 'left' | (string & Record<string, never>);
+type ModernActivityObjectType = 'task' | 'comment' | 'project' | (string & Record<string, never>);
+/**
+ * Combined object:event filter string for the `objectEventTypes` parameter of `getActivityLogs`.
+ *
+ * Uses modern object type names (`task`, `comment`) rather than legacy API names (`item`, `note`).
+ * Either part may be omitted:
+ * - `'task:added'` — task additions only
+ * - `'task:'` — all events for tasks
+ * - `':deleted'` — all deleted events across all object types
+ *
+ * The final `string & Record<string, never>` member allows any arbitrary string
+ * to be passed for forward compatibility, while still providing autocomplete for
+ * the known combinations above.
+ */
+export type ActivityObjectEventType = `${ModernActivityObjectType}:${ActivityEventType}` | `${ModernActivityObjectType}:` | `:${ActivityEventType}` | (string & Record<string, never>);
 /**
  * Flexible object containing event-specific data.
  * Uses z.record to accept any properties for forward compatibility.

package/dist/types/types/requests.d.ts

@@ -1,6 +1,6 @@
 import type { RequireAllOrNone, RequireOneOrNone, RequireExactlyOne } from 'type-fest';
 import type { ColorKey } from '../utils/colors.js';
-import type { ActivityEvent, ActivityEventType, ActivityObjectType, Comment, Duration, Label, PersonalProject, ProjectViewStyle, ProjectVisibility, Section, Task, User, WorkspaceProject } from './entities.js';
+import type { ActivityEvent, ActivityEventType, ActivityObjectEventType, ActivityObjectType, Comment, Duration, Label, PersonalProject, ProjectViewStyle, ProjectVisibility, Section, Task, User, WorkspaceProject } from './entities.js';
 /**
  * Arguments for creating a new task.
  * @see https://todoist.com/api/v1/docs#tag/Tasks/operation/create_task_api_v1_tasks_post
@@ -404,18 +404,9 @@ export type UpdateCommentArgs = {
     content: string;
 };
 /**
- * Arguments for retrieving activity logs.
+ * Common arguments for retrieving activity logs (excluding filter-type params).
  */
-type GetActivityLogsArgsBase = {
-    /**
-     * Type of object to filter by (e.g., 'task', 'comment', 'project').
-     * Accepts both modern naming ('task', 'comment') and legacy naming ('item', 'note').
-     */
-    objectType?: ActivityObjectType;
-    /**
-     * Type of event to filter by (e.g., 'added', 'updated', 'deleted', 'completed', 'uncompleted', 'archived', 'unarchived', 'shared', 'left').
-     */
-    eventType?: ActivityEventType;
+type GetActivityLogsArgsCommon = {
     /**
      * Filter by the ID of a specific object.
      */
@@ -477,7 +468,32 @@ type GetActivityLogsArgsBase = {
      */
     dateTo?: Date | string;
 };
-type GetActivityLogsArgsWithDate = GetActivityLogsArgsBase & {
+/** Use the legacy separate objectType/eventType params. Cannot be combined with objectEventTypes. */
+type GetActivityLogsArgsLegacy = GetActivityLogsArgsCommon & {
+    /**
+     * Type of object to filter by (e.g., 'task', 'comment', 'project').
+     * Accepts both modern naming ('task', 'comment') and legacy naming ('item', 'note').
+     * @deprecated Use `objectEventTypes` instead.
+     */
+    objectType?: ActivityObjectType;
+    /**
+     * Type of event to filter by (e.g., 'added', 'updated', 'deleted').
+     * @deprecated Use `objectEventTypes` instead.
+     */
+    eventType?: ActivityEventType;
+    objectEventTypes?: never;
+};
+/** Use the modern combined objectEventTypes param. Cannot be combined with objectType/eventType. */
+type GetActivityLogsArgsModern = GetActivityLogsArgsCommon & {
+    /**
+     * One or more combined object:event filter strings, e.g. `'task:added'`, `'task:'`, `':deleted'`.
+     * Accepts a single value or an array of values for multi-type filtering.
+     */
+    objectEventTypes?: ActivityObjectEventType | ActivityObjectEventType[];
+    objectType?: never;
+    eventType?: never;
+};
+type GetActivityLogsArgsWithDate<TBase> = TBase & {
     /**
      * @deprecated Use `dateFrom` instead. Will be removed in the next major version.
      */
@@ -491,7 +507,7 @@ type GetActivityLogsArgsWithDate = GetActivityLogsArgsBase & {
  * @deprecated String dates (YYYY-MM-DD format) are deprecated. Use Date objects instead.
  * This type will be removed in the next major version.
  */
-type GetActivityLogsArgsWithString = GetActivityLogsArgsBase & {
+type GetActivityLogsArgsWithString<TBase> = TBase & {
     /**
      * @deprecated Use `dateFrom` instead. Will be removed in the next major version.
      */
@@ -501,7 +517,7 @@ type GetActivityLogsArgsWithString = GetActivityLogsArgsBase & {
      */
     until?: string;
 };
-export type GetActivityLogsArgs = GetActivityLogsArgsWithDate | GetActivityLogsArgsWithString;
+export type GetActivityLogsArgs = GetActivityLogsArgsWithDate<GetActivityLogsArgsLegacy> | GetActivityLogsArgsWithString<GetActivityLogsArgsLegacy> | GetActivityLogsArgsWithDate<GetActivityLogsArgsModern> | GetActivityLogsArgsWithString<GetActivityLogsArgsModern>;
 /**
  * Response from retrieving activity logs.
  */

package/dist/types/utils/activity-helpers.d.ts

@@ -18,3 +18,11 @@ export declare function normalizeObjectTypeForApi(objectType: string | undefined
  * @returns The object type using modern SDK naming.
  */
 export declare function denormalizeObjectTypeFromApi(objectType: string | undefined): string | undefined;
+/**
+ * Normalizes an `ActivityObjectEventType` filter string for the API,
+ * converting modern object type names to legacy API names.
+ * e.g. 'task:added' -> 'item:added', 'comment:' -> 'note:', ':deleted' -> ':deleted'
+ *
+ * @internal
+ */
+export declare function normalizeObjectEventTypeForApi(filter: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-api-typescript",
-    "version": "6.9.0",
+    "version": "6.10.0",
     "description": "A typescript wrapper for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "https://github.com/Doist/todoist-api-typescript",