@doist/todoist-api-typescript 6.9.0 → 7.0.0

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

@@ -70,7 +70,6 @@ export declare const TaskSchema: z.ZodPipe<z.ZodObject<{
     childOrder: z.ZodNumber;
     content: z.ZodString;
     description: z.ZodString;
-    noteCount: z.ZodNumber;
     dayOrder: z.ZodNumber;
     isCollapsed: z.ZodBoolean;
     isUncompletable: z.ZodDefault<z.ZodBoolean>;
@@ -111,7 +110,6 @@ export declare const TaskSchema: z.ZodPipe<z.ZodObject<{
     childOrder: number;
     content: string;
     description: string;
-    noteCount: number;
     dayOrder: number;
     isCollapsed: boolean;
 }, {
@@ -149,7 +147,6 @@ export declare const TaskSchema: z.ZodPipe<z.ZodObject<{
     childOrder: number;
     content: string;
     description: string;
-    noteCount: number;
     dayOrder: number;
     isCollapsed: boolean;
     isUncompletable: boolean;
@@ -686,37 +683,38 @@ export declare const ProductivityStatsSchema: z.ZodObject<{
  */
 export type ProductivityStats = z.infer<typeof ProductivityStatsSchema>;
 export declare const ColorSchema: z.ZodObject<{
-    id: z.ZodNumber;
     key: z.ZodString;
     displayName: z.ZodString;
-    name: z.ZodString;
     hexValue: z.ZodString;
-    value: z.ZodString;
 }, z.core.$strip>;
 /**
  * Represents a color in Todoist.
  * @see https://todoist.com/api/v1/docs#tag/Colors
  */
 export type Color = z.infer<typeof ColorSchema>;
-/**
- * @deprecated Use 'task' instead. This will be removed in the next major version.
- */
-type DeprecatedItem = 'item';
-/**
- * @deprecated Use 'comment' instead. This will be removed in the next major version.
- */
-type DeprecatedNote = 'note';
 /**
  * Type hints for known object types. Accepts any string for forward compatibility.
- * Supports both modern naming ('task', 'comment') and legacy naming ('item', 'note').
- *
- * **Note**: The legacy values 'item' and 'note' are deprecated. Use 'task' and 'comment' instead.
  */
-export type ActivityObjectType = 'task' | 'comment' | 'project' | DeprecatedItem | DeprecatedNote | (string & Record<string, never>);
+export type ActivityObjectType = 'task' | 'comment' | 'project' | (string & Record<string, never>);
 /**
  * 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, ActivityObjectEventType, 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
@@ -115,9 +115,17 @@ export type UpdateTaskArgs = {
     description?: string;
     labels?: string[];
     priority?: number;
-    dueString?: string;
+    /**
+     * Natural language due date.
+     * Use `"no date"` to clear a due date, or `null` as an SDK alias for the same behavior.
+     */
+    dueString?: (string & {}) | 'no date' | null;
     dueLang?: string | null;
     assigneeId?: string | null;
+    /**
+     * Deadline date in `YYYY-MM-DD` format.
+     * Use `null` to clear a task deadline.
+     */
     deadlineDate?: string | null;
     deadlineLang?: string | null;
     isUncompletable?: boolean;
@@ -404,18 +412,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,31 +476,17 @@ type GetActivityLogsArgsBase = {
      */
     dateTo?: Date | string;
 };
-type GetActivityLogsArgsWithDate = GetActivityLogsArgsBase & {
-    /**
-     * @deprecated Use `dateFrom` instead. Will be removed in the next major version.
-     */
-    since?: Date;
-    /**
-     * @deprecated Use `dateTo` instead. Will be removed in the next major version.
-     */
-    until?: Date;
-};
-/**
- * @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 & {
-    /**
-     * @deprecated Use `dateFrom` instead. Will be removed in the next major version.
-     */
-    since?: string;
-    /**
-     * @deprecated Use `dateTo` instead. Will be removed in the next major version.
-     */
-    until?: string;
+export type GetActivityLogsArgs = GetActivityLogsArgsCommon & {
+    objectEventTypes?: ActivityObjectEventType | ActivityObjectEventType[];
+    /** @removed Use `objectEventTypes` instead. */
+    objectType?: never;
+    /** @removed Use `objectEventTypes` instead. */
+    eventType?: never;
+    /** @removed Use `dateFrom` instead. */
+    since?: never;
+    /** @removed Use `dateTo` instead. */
+    until?: never;
 };
-export type GetActivityLogsArgs = GetActivityLogsArgsWithDate | GetActivityLogsArgsWithString;
 /**
  * Response from retrieving activity logs.
  */

package/dist/types/types/sync/commands/index.d.ts

@@ -151,10 +151,6 @@ export type SyncCommand<Type extends SyncCommandType | string = string> = {
     args: Type extends SyncCommandType ? SyncCommandsMap[Type] : Record<string, unknown>;
     tempId?: string;
 };
-/**
- * @deprecated Use `SyncCommand` instead.
- */
-export type Command = SyncCommand<string>;
 export * from './shared.js';
 export * from './tasks.js';
 export * from './projects.js';

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/dist/types/utils/colors.d.ts

@@ -1,317 +1,187 @@
 import type { Color } from '../types/entities.js';
 export declare const berryRed: {
-    readonly id: 30;
     readonly key: "berry_red";
     readonly displayName: "Berry Red";
-    readonly name: "Berry Red";
     readonly hexValue: "#b8255f";
-    readonly value: "#b8255f";
 };
 export declare const red: {
-    readonly id: 31;
     readonly key: "red";
     readonly displayName: "Red";
-    readonly name: "Red";
     readonly hexValue: "#db4035";
-    readonly value: "#db4035";
 };
 export declare const orange: {
-    readonly id: 32;
     readonly key: "orange";
     readonly displayName: "Orange";
-    readonly name: "Orange";
     readonly hexValue: "#ff9933";
-    readonly value: "#ff9933";
 };
 export declare const yellow: {
-    readonly id: 33;
     readonly key: "yellow";
     readonly displayName: "Yellow";
-    readonly name: "Yellow";
     readonly hexValue: "#fad000";
-    readonly value: "#fad000";
 };
 export declare const oliveGreen: {
-    readonly id: 34;
     readonly key: "olive_green";
     readonly displayName: "Olive Green";
-    readonly name: "Olive Green";
     readonly hexValue: "#afb83b";
-    readonly value: "#afb83b";
 };
 export declare const limeGreen: {
-    readonly id: 35;
     readonly key: "lime_green";
     readonly displayName: "Lime Green";
-    readonly name: "Lime Green";
     readonly hexValue: "#7ecc49";
-    readonly value: "#7ecc49";
 };
 export declare const green: {
-    readonly id: 36;
     readonly key: "green";
     readonly displayName: "Green";
-    readonly name: "Green";
     readonly hexValue: "#299438";
-    readonly value: "#299438";
 };
 export declare const mintGreen: {
-    readonly id: 37;
     readonly key: "mint_green";
     readonly displayName: "Mint Green";
-    readonly name: "Mint Green";
     readonly hexValue: "#6accbc";
-    readonly value: "#6accbc";
 };
-export declare const turquoise: {
-    readonly id: 38;
-    readonly key: "turquoise";
-    readonly displayName: "Turquoise";
-    readonly name: "Turquoise";
+export declare const teal: {
+    readonly key: "teal";
+    readonly displayName: "Teal";
     readonly hexValue: "#158fad";
-    readonly value: "#158fad";
 };
 export declare const skyBlue: {
-    readonly id: 39;
     readonly key: "sky_blue";
     readonly displayName: "Sky Blue";
-    readonly name: "Sky Blue";
     readonly hexValue: "#14aaf5";
-    readonly value: "#14aaf5";
 };
 export declare const lightBlue: {
-    readonly id: 40;
     readonly key: "light_blue";
     readonly displayName: "Light Blue";
-    readonly name: "Light Blue";
     readonly hexValue: "#96c3eb";
-    readonly value: "#96c3eb";
 };
 export declare const blue: {
-    readonly id: 41;
     readonly key: "blue";
     readonly displayName: "Blue";
-    readonly name: "Blue";
     readonly hexValue: "#4073ff";
-    readonly value: "#4073ff";
 };
 export declare const grape: {
-    readonly id: 42;
     readonly key: "grape";
     readonly displayName: "Grape";
-    readonly name: "Grape";
     readonly hexValue: "#884dff";
-    readonly value: "#884dff";
 };
 export declare const violet: {
-    readonly id: 43;
     readonly key: "violet";
     readonly displayName: "Violet";
-    readonly name: "Violet";
     readonly hexValue: "#af38eb";
-    readonly value: "#af38eb";
 };
 export declare const lavender: {
-    readonly id: 44;
     readonly key: "lavender";
     readonly displayName: "Lavender";
-    readonly name: "Lavender";
     readonly hexValue: "#eb96eb";
-    readonly value: "#eb96eb";
 };
 export declare const magenta: {
-    readonly id: 45;
     readonly key: "magenta";
     readonly displayName: "Magenta";
-    readonly name: "Magenta";
     readonly hexValue: "#e05194";
-    readonly value: "#e05194";
 };
 export declare const salmon: {
-    readonly id: 46;
     readonly key: "salmon";
     readonly displayName: "Salmon";
-    readonly name: "Salmon";
     readonly hexValue: "#ff8d85";
-    readonly value: "#ff8d85";
 };
 export declare const charcoal: {
-    readonly id: 47;
     readonly key: "charcoal";
     readonly displayName: "Charcoal";
-    readonly name: "Charcoal";
     readonly hexValue: "#808080";
-    readonly value: "#808080";
 };
-export declare const gray: {
-    readonly id: 48;
-    readonly key: "gray";
-    readonly displayName: "Gray";
-    readonly name: "Gray";
+export declare const grey: {
+    readonly key: "grey";
+    readonly displayName: "Grey";
     readonly hexValue: "#b8b8b8";
-    readonly value: "#b8b8b8";
 };
 export declare const taupe: {
-    readonly id: 49;
     readonly key: "taupe";
     readonly displayName: "Taupe";
-    readonly name: "Taupe";
     readonly hexValue: "#ccac93";
-    readonly value: "#ccac93";
 };
 export declare const colors: readonly [{
-    readonly id: 30;
     readonly key: "berry_red";
     readonly displayName: "Berry Red";
-    readonly name: "Berry Red";
     readonly hexValue: "#b8255f";
-    readonly value: "#b8255f";
 }, {
-    readonly id: 31;
     readonly key: "red";
     readonly displayName: "Red";
-    readonly name: "Red";
     readonly hexValue: "#db4035";
-    readonly value: "#db4035";
 }, {
-    readonly id: 32;
     readonly key: "orange";
     readonly displayName: "Orange";
-    readonly name: "Orange";
     readonly hexValue: "#ff9933";
-    readonly value: "#ff9933";
 }, {
-    readonly id: 33;
     readonly key: "yellow";
     readonly displayName: "Yellow";
-    readonly name: "Yellow";
     readonly hexValue: "#fad000";
-    readonly value: "#fad000";
 }, {
-    readonly id: 34;
     readonly key: "olive_green";
     readonly displayName: "Olive Green";
-    readonly name: "Olive Green";
     readonly hexValue: "#afb83b";
-    readonly value: "#afb83b";
 }, {
-    readonly id: 35;
     readonly key: "lime_green";
     readonly displayName: "Lime Green";
-    readonly name: "Lime Green";
     readonly hexValue: "#7ecc49";
-    readonly value: "#7ecc49";
 }, {
-    readonly id: 36;
     readonly key: "green";
     readonly displayName: "Green";
-    readonly name: "Green";
     readonly hexValue: "#299438";
-    readonly value: "#299438";
 }, {
-    readonly id: 37;
     readonly key: "mint_green";
     readonly displayName: "Mint Green";
-    readonly name: "Mint Green";
     readonly hexValue: "#6accbc";
-    readonly value: "#6accbc";
 }, {
-    readonly id: 38;
-    readonly key: "turquoise";
-    readonly displayName: "Turquoise";
-    readonly name: "Turquoise";
+    readonly key: "teal";
+    readonly displayName: "Teal";
     readonly hexValue: "#158fad";
-    readonly value: "#158fad";
 }, {
-    readonly id: 39;
     readonly key: "sky_blue";
     readonly displayName: "Sky Blue";
-    readonly name: "Sky Blue";
     readonly hexValue: "#14aaf5";
-    readonly value: "#14aaf5";
 }, {
-    readonly id: 40;
     readonly key: "light_blue";
     readonly displayName: "Light Blue";
-    readonly name: "Light Blue";
     readonly hexValue: "#96c3eb";
-    readonly value: "#96c3eb";
 }, {
-    readonly id: 41;
     readonly key: "blue";
     readonly displayName: "Blue";
-    readonly name: "Blue";
     readonly hexValue: "#4073ff";
-    readonly value: "#4073ff";
 }, {
-    readonly id: 42;
     readonly key: "grape";
     readonly displayName: "Grape";
-    readonly name: "Grape";
     readonly hexValue: "#884dff";
-    readonly value: "#884dff";
 }, {
-    readonly id: 43;
     readonly key: "violet";
     readonly displayName: "Violet";
-    readonly name: "Violet";
     readonly hexValue: "#af38eb";
-    readonly value: "#af38eb";
 }, {
-    readonly id: 44;
     readonly key: "lavender";
     readonly displayName: "Lavender";
-    readonly name: "Lavender";
     readonly hexValue: "#eb96eb";
-    readonly value: "#eb96eb";
 }, {
-    readonly id: 45;
     readonly key: "magenta";
     readonly displayName: "Magenta";
-    readonly name: "Magenta";
     readonly hexValue: "#e05194";
-    readonly value: "#e05194";
 }, {
-    readonly id: 46;
     readonly key: "salmon";
     readonly displayName: "Salmon";
-    readonly name: "Salmon";
     readonly hexValue: "#ff8d85";
-    readonly value: "#ff8d85";
 }, {
-    readonly id: 47;
     readonly key: "charcoal";
     readonly displayName: "Charcoal";
-    readonly name: "Charcoal";
     readonly hexValue: "#808080";
-    readonly value: "#808080";
 }, {
-    readonly id: 48;
-    readonly key: "gray";
-    readonly displayName: "Gray";
-    readonly name: "Gray";
+    readonly key: "grey";
+    readonly displayName: "Grey";
     readonly hexValue: "#b8b8b8";
-    readonly value: "#b8b8b8";
 }, {
-    readonly id: 49;
     readonly key: "taupe";
     readonly displayName: "Taupe";
-    readonly name: "Taupe";
     readonly hexValue: "#ccac93";
-    readonly value: "#ccac93";
 }];
 export type ColorKey = (typeof colors)[number]['key'];
 export declare const defaultColor: Color;
-/**
- * @private
- * @deprecated Use {@link getColorByKey} instead
- */
-export declare function getColorById(colorId: number): Color;
-/**
- * @private
- * @deprecated Use {@link getColorByKey} instead
- */
-export declare function getColorByName(colorName: string): Color;
 /**
  * Retrieves a {@link Color} object by its key identifier.
  *

package/dist/types/utils/validators.d.ts

@@ -36,7 +36,6 @@ export declare const validateTask: (input: unknown) => {
     childOrder: number;
     content: string;
     description: string;
-    noteCount: number;
     dayOrder: number;
     isCollapsed: boolean;
 };
@@ -77,7 +76,6 @@ export declare const validateTaskArray: (input: unknown[]) => {
     childOrder: number;
     content: string;
     description: string;
-    noteCount: number;
     dayOrder: number;
     isCollapsed: boolean;
 }[];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-api-typescript",
-    "version": "6.9.0",
+    "version": "7.0.0",
     "description": "A typescript wrapper for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "https://github.com/Doist/todoist-api-typescript",
@@ -30,6 +30,7 @@
         "ts-compile-check": "npx tsc -p tsconfig.typecheck.json",
         "audit": "npm audit --audit-level=moderate",
         "test": "jest",
+        "api:request": "node ./scripts/todoist-api-request.cjs",
         "build:cjs": "npx tsc -p tsconfig.cjs.json",
         "build:esm": "npx tsc -p tsconfig.esm.json",
         "build:fix-esm": "node scripts/fix-esm-imports.cjs",
@@ -56,6 +57,7 @@
         "@types/jest": "30.0.0",
         "@typescript-eslint/eslint-plugin": "8.46.3",
         "@typescript-eslint/parser": "8.46.3",
+        "dotenv": "17.3.1",
         "eslint": "8.57.1",
         "eslint-config-prettier": "8.7.0",
         "eslint-import-resolver-webpack": "0.13.2",