@doist/todoist-sdk 14.0.2 → 14.2.0

package/dist/types/types/sync/commands/view-options.d.ts

@@ -1,4 +1,4 @@
-import type { ViewType, ViewMode, GroupedBy, SortedBy, SortOrder } from '../resources/view-options.js';
+import type { CalendarSettings, GroupedBy, SortedBy, SortOrder, ViewMode, ViewType } from '../resources/view-options.js';
 export type ViewOptionsSetArgs = {
     viewType: ViewType;
     objectId?: string;
@@ -8,6 +8,7 @@ export type ViewOptionsSetArgs = {
     showCompletedTasks?: boolean;
     sortedBy?: SortedBy | null;
     sortOrder?: SortOrder | null;
+    calendarSettings?: CalendarSettings | null;
 };
 export type ViewOptionsDeleteArgs = {
     viewType: ViewType;

package/dist/types/types/sync/resources/view-options.d.ts

@@ -68,12 +68,23 @@ export declare const SortOrderSchema: z.ZodNullable<z.ZodEnum<{
 export declare const CALENDAR_LAYOUTS: readonly ["WEEK", "MONTH"];
 /** Calendar layout mode. */
 export type CalendarLayout = (typeof CALENDAR_LAYOUTS)[number];
+/** Available task color sources for calendar views. */
+export declare const CALENDAR_COLORS: readonly ["PRIORITY", "LABEL", "PROJECT"];
+/** Task color source for a calendar view. */
+export type CalendarColor = (typeof CALENDAR_COLORS)[number];
 export declare const CalendarSettingsSchema: z.ZodObject<{
-    layout: z.ZodOptional<z.ZodEnum<{
+    layout: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         WEEK: "WEEK";
         MONTH: "MONTH";
-    }>>;
+    }>>>;
+    visibleDayCount: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>]>>>;
+    color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        PROJECT: "PROJECT";
+        LABEL: "LABEL";
+        PRIORITY: "PRIORITY";
+    }>>>;
 }, z.core.$loose>;
+export type CalendarSettings = z.infer<typeof CalendarSettingsSchema>;
 export declare const ViewOptionsSchema: z.ZodObject<{
     viewType: z.ZodEnum<{
         PROJECT: "PROJECT";
@@ -90,7 +101,7 @@ export declare const ViewOptionsSchema: z.ZodObject<{
         OVERDUE: "OVERDUE";
         WORKSPACE_OVERVIEW: "WORKSPACE_OVERVIEW";
     }>;
-    objectId: z.ZodOptional<z.ZodString>;
+    objectId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     groupedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         PROJECT: "PROJECT";
         LABEL: "LABEL";
@@ -102,11 +113,11 @@ export declare const ViewOptionsSchema: z.ZodObject<{
         WORKSPACE: "WORKSPACE";
     }>>>;
     filteredBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    viewMode: z.ZodOptional<z.ZodEnum<{
+    viewMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         LIST: "LIST";
         BOARD: "BOARD";
         CALENDAR: "CALENDAR";
-    }>>;
+    }>>>;
     showCompletedTasks: z.ZodOptional<z.ZodBoolean>;
     sortedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         PROJECT: "PROJECT";
@@ -123,6 +134,19 @@ export declare const ViewOptionsSchema: z.ZodObject<{
         ASC: "ASC";
         DESC: "DESC";
     }>>>;
+    calendarSettings: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        layout: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            WEEK: "WEEK";
+            MONTH: "MONTH";
+        }>>>;
+        visibleDayCount: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>]>>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            PROJECT: "PROJECT";
+            LABEL: "LABEL";
+            PRIORITY: "PRIORITY";
+        }>>>;
+    }, z.core.$loose>>>;
+    isDeleted: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 export type ViewOptions = z.infer<typeof ViewOptionsSchema>;
 export declare const ProjectViewOptionsDefaultsSchema: z.ZodObject<{
@@ -160,10 +184,16 @@ export declare const ProjectViewOptionsDefaultsSchema: z.ZodObject<{
     showCompletedTasks: z.ZodOptional<z.ZodBoolean>;
     filteredBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     calendarSettings: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        layout: z.ZodOptional<z.ZodEnum<{
+        layout: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             WEEK: "WEEK";
             MONTH: "MONTH";
-        }>>;
+        }>>>;
+        visibleDayCount: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>]>>>;
+        color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            PROJECT: "PROJECT";
+            LABEL: "LABEL";
+            PRIORITY: "PRIORITY";
+        }>>>;
     }, z.core.$loose>>>;
 }, z.core.$loose>;
 export type ProjectViewOptionsDefaults = z.infer<typeof ProjectViewOptionsDefaultsSchema>;

package/dist/types/types/sync/response.d.ts

@@ -751,7 +751,7 @@ export declare const SyncResponseSchema: z.ZodObject<{
             OVERDUE: "OVERDUE";
             WORKSPACE_OVERVIEW: "WORKSPACE_OVERVIEW";
         }>;
-        objectId: z.ZodOptional<z.ZodString>;
+        objectId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         groupedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             PROJECT: "PROJECT";
             LABEL: "LABEL";
@@ -763,11 +763,11 @@ export declare const SyncResponseSchema: z.ZodObject<{
             WORKSPACE: "WORKSPACE";
         }>>>;
         filteredBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        viewMode: z.ZodOptional<z.ZodEnum<{
+        viewMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             LIST: "LIST";
             BOARD: "BOARD";
             CALENDAR: "CALENDAR";
-        }>>;
+        }>>>;
         showCompletedTasks: z.ZodOptional<z.ZodBoolean>;
         sortedBy: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             PROJECT: "PROJECT";
@@ -784,6 +784,19 @@ export declare const SyncResponseSchema: z.ZodObject<{
             ASC: "ASC";
             DESC: "DESC";
         }>>>;
+        calendarSettings: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            layout: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                WEEK: "WEEK";
+                MONTH: "MONTH";
+            }>>>;
+            visibleDayCount: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>]>>>;
+            color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                PROJECT: "PROJECT";
+                LABEL: "LABEL";
+                PRIORITY: "PRIORITY";
+            }>>>;
+        }, z.core.$loose>>>;
+        isDeleted: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>>>;
     projectViewOptionsDefaults: z.ZodOptional<z.ZodArray<z.ZodObject<{
         projectId: z.ZodString;
@@ -820,10 +833,16 @@ export declare const SyncResponseSchema: z.ZodObject<{
         showCompletedTasks: z.ZodOptional<z.ZodBoolean>;
         filteredBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         calendarSettings: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            layout: z.ZodOptional<z.ZodEnum<{
+            layout: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 WEEK: "WEEK";
                 MONTH: "MONTH";
-            }>>;
+            }>>>;
+            visibleDayCount: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<3>, z.ZodLiteral<7>]>>>;
+            color: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                PROJECT: "PROJECT";
+                LABEL: "LABEL";
+                PRIORITY: "PRIORITY";
+            }>>>;
         }, z.core.$loose>>>;
     }, z.core.$loose>>>;
     roleActions: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;

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

@@ -3,5 +3,7 @@ export * from './sanitization.js';
 export { getTaskUrl, getProjectUrl, getSectionUrl } from './url-helpers.js';
 export { createCommand } from './sync-helpers.js';
 export * from './project-helpers.js';
+export * from './task-sorting.js';
+export * from './view-options.js';
 export { parseWebhookPayload, verifyWebhookSignature } from './webhook-parser.js';
 export type { VerifyWebhookSignatureArgs } from './webhook-parser.js';

package/dist/types/utils/task-sorting.d.ts

@@ -0,0 +1,38 @@
+import type { SortOrder, SortedBy } from '../types/sync/index.js';
+import type { Task } from '../types/tasks/index.js';
+/** Todoist's default task-ordering hierarchies. */
+export declare const DEFAULT_TASK_ORDERS: readonly ["PRIORITY_FIRST", "DATE_FIRST"];
+/** Default hierarchy used when a view has no named sorting. */
+export type DefaultTaskOrder = (typeof DEFAULT_TASK_ORDERS)[number];
+export type TaskSortOptions = {
+    /** Saved or requested sort field. Null and MANUAL use defaultOrder. */
+    sortedBy?: SortedBy | null;
+    /** Saved or requested direction. Defaults by field when absent. */
+    sortOrder?: SortOrder | null;
+    /** Default hierarchy for this view or filter query. */
+    defaultOrder: DefaultTaskOrder;
+};
+export type TaskSortContext = {
+    /** Project ID to its visible order. */
+    projectOrder?: ReadonlyMap<string, number>;
+    /** Project ID to the visible order of its workspace bucket. */
+    workspaceOrder?: ReadonlyMap<string, number>;
+    /** Resolves the display name used for assignee sorting. */
+    assigneeName?: (task: Task) => string | null | undefined;
+    /** Account IANA timezone. Defaults to UTC for deterministic behavior. */
+    timezone?: string;
+    /** Locale used for text comparisons. Defaults to English. */
+    locale?: string | readonly string[];
+};
+/**
+ * Sorts the supplied tasks using Todoist view-ordering rules.
+ *
+ * The function performs no I/O and always returns a new array. Exact project,
+ * workspace, assignee, localized text, and due-time ordering requires the
+ * corresponding context. Callers must sort each independent view section or
+ * group separately and preserve any subtask structure they render.
+ *
+ * This function sorts only the tasks supplied to it. Fetch every page first
+ * when globally correct ordering is required for a paginated query.
+ */
+export declare function sortTasks(tasks: readonly Task[], options: TaskSortOptions, context?: TaskSortContext): Task[];

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

@@ -1153,23 +1153,37 @@ export declare const validateCompletedInfo: (input: unknown) => {
 export declare const validateViewOptions: (input: unknown) => {
     [x: string]: unknown;
     viewType: "PROJECT" | "TODAY" | "UPCOMING" | "LABEL" | "FILTER" | "WORKSPACE_FILTER" | "SEARCH" | "TEMPLATE_PREVIEW" | "TASK_DETAIL" | "AUTOMATION" | "ASSIGNED" | "OVERDUE" | "WORKSPACE_OVERVIEW";
-    objectId?: string | undefined;
+    objectId?: string | null | undefined;
     groupedBy?: "PROJECT" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "WORKSPACE" | null | undefined;
     filteredBy?: string | null | undefined;
-    viewMode?: "LIST" | "BOARD" | "CALENDAR" | undefined;
+    viewMode?: "LIST" | "BOARD" | "CALENDAR" | null | undefined;
     showCompletedTasks?: boolean | undefined;
     sortedBy?: "PROJECT" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "WORKSPACE" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
     sortOrder?: "ASC" | "DESC" | null | undefined;
+    calendarSettings?: {
+        [x: string]: unknown;
+        layout?: "WEEK" | "MONTH" | null | undefined;
+        visibleDayCount?: 3 | 1 | 7 | null | undefined;
+        color?: "PROJECT" | "LABEL" | "PRIORITY" | null | undefined;
+    } | null | undefined;
+    isDeleted?: boolean | undefined;
 }, validateViewOptionsArray: (input: unknown) => {
     [x: string]: unknown;
     viewType: "PROJECT" | "TODAY" | "UPCOMING" | "LABEL" | "FILTER" | "WORKSPACE_FILTER" | "SEARCH" | "TEMPLATE_PREVIEW" | "TASK_DETAIL" | "AUTOMATION" | "ASSIGNED" | "OVERDUE" | "WORKSPACE_OVERVIEW";
-    objectId?: string | undefined;
+    objectId?: string | null | undefined;
     groupedBy?: "PROJECT" | "LABEL" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "WORKSPACE" | null | undefined;
     filteredBy?: string | null | undefined;
-    viewMode?: "LIST" | "BOARD" | "CALENDAR" | undefined;
+    viewMode?: "LIST" | "BOARD" | "CALENDAR" | null | undefined;
     showCompletedTasks?: boolean | undefined;
     sortedBy?: "PROJECT" | "ASSIGNEE" | "ADDED_DATE" | "DUE_DATE" | "DEADLINE" | "PRIORITY" | "WORKSPACE" | "MANUAL" | "ALPHABETICALLY" | null | undefined;
     sortOrder?: "ASC" | "DESC" | null | undefined;
+    calendarSettings?: {
+        [x: string]: unknown;
+        layout?: "WEEK" | "MONTH" | null | undefined;
+        visibleDayCount?: 3 | 1 | 7 | null | undefined;
+        color?: "PROJECT" | "LABEL" | "PRIORITY" | null | undefined;
+    } | null | undefined;
+    isDeleted?: boolean | undefined;
 }[];
 export declare const validateProjectViewOptionsDefaults: (input: unknown) => {
     [x: string]: unknown;
@@ -1182,7 +1196,9 @@ export declare const validateProjectViewOptionsDefaults: (input: unknown) => {
     filteredBy?: string | null | undefined;
     calendarSettings?: {
         [x: string]: unknown;
-        layout?: "WEEK" | "MONTH" | undefined;
+        layout?: "WEEK" | "MONTH" | null | undefined;
+        visibleDayCount?: 3 | 1 | 7 | null | undefined;
+        color?: "PROJECT" | "LABEL" | "PRIORITY" | null | undefined;
     } | null | undefined;
 }, validateProjectViewOptionsDefaultsArray: (input: unknown) => {
     [x: string]: unknown;
@@ -1195,7 +1211,9 @@ export declare const validateProjectViewOptionsDefaults: (input: unknown) => {
     filteredBy?: string | null | undefined;
     calendarSettings?: {
         [x: string]: unknown;
-        layout?: "WEEK" | "MONTH" | undefined;
+        layout?: "WEEK" | "MONTH" | null | undefined;
+        visibleDayCount?: 3 | 1 | 7 | null | undefined;
+        color?: "PROJECT" | "LABEL" | "PRIORITY" | null | undefined;
     } | null | undefined;
 }[];
 export declare const validateUserPlanLimits: (input: unknown) => {

package/dist/types/utils/view-options.d.ts

@@ -0,0 +1,11 @@
+import type { ViewOptions, ViewType } from '../types/sync/index.js';
+export type FindViewOptionsArgs = {
+    /** View types that identify the logical view. */
+    viewTypes: readonly ViewType[];
+    /** Object ID for object-backed views. Omit for singleton views. */
+    objectId?: string | null;
+};
+/** Returns whether saved view options are active rather than a deletion tombstone. */
+export declare function isActiveViewOption(options: ViewOptions): boolean;
+/** Finds the active saved options for one logical view. */
+export declare function findViewOptions(options: readonly ViewOptions[], args: FindViewOptionsArgs): ViewOptions | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-sdk",
-    "version": "14.0.2",
+    "version": "14.2.0",
     "description": "The official TypeScript SDK for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "https://github.com/Doist/todoist-sdk-typescript",
@@ -53,9 +53,8 @@
     "dependencies": {
         "camelcase": "6.3.0",
         "emoji-regex": "10.6.0",
-        "form-data": "4.0.6",
         "ts-custom-error": "^3.2.0",
-        "undici": "7.24.8",
+        "undici": "^7.29.0",
         "uuid": "11.1.1",
         "zod": "4.3.6"
     },