@doist/todoist-api-typescript 7.7.0 → 7.9.0

package/dist/cjs/consts/endpoints.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ENDPOINT_REST_ID_MAPPINGS = exports.ENDPOINT_REST_EMAILS = exports.ENDPOINT_REST_BACKUPS_DOWNLOAD = exports.ENDPOINT_REST_BACKUPS = exports.ENDPOINT_REST_ACCESS_TOKENS_MIGRATE = exports.ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID = exports.ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE = exports.ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE = exports.ENDPOINT_REST_TEMPLATES_URL = exports.ENDPOINT_REST_TEMPLATES_FILE = exports.ENDPOINT_REST_TASKS_COMPLETED = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE = exports.SECTION_UNARCHIVE = exports.SECTION_ARCHIVE = exports.ENDPOINT_REST_PROJECT_JOIN = exports.ENDPOINT_REST_PROJECT_FULL = exports.ENDPOINT_REST_PROJECTS_PERMISSIONS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT = 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_LOCATION_REMINDERS = exports.ENDPOINT_REST_REMINDERS = 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_MEMBERS = 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_REST_WORKSPACES = exports.ENDPOINT_REVOKE = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_MOVED_IDS = void 0;
+exports.ENDPOINT_WORKSPACE_MEMBERS = 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_REST_WORKSPACES = exports.ENDPOINT_REST_FOLDERS = exports.ENDPOINT_REVOKE = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_MOVED_IDS = void 0;
 exports.getSyncBaseUri = getSyncBaseUri;
 exports.getAuthBaseUri = getAuthBaseUri;
 exports.getWorkspaceInvitationAcceptEndpoint = getWorkspaceInvitationAcceptEndpoint;
@@ -84,6 +84,7 @@ exports.ENDPOINT_SYNC = 'sync';
 exports.ENDPOINT_AUTHORIZATION = 'authorize';
 exports.ENDPOINT_GET_TOKEN = 'access_token';
 exports.ENDPOINT_REVOKE = 'revoke';
+exports.ENDPOINT_REST_FOLDERS = 'folders';
 // Workspace endpoints
 exports.ENDPOINT_REST_WORKSPACES = 'workspaces';
 exports.ENDPOINT_WORKSPACE_INVITATIONS = 'workspaces/invitations';

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = exports.COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = exports.RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = exports.COMMENT_WITH_OPTIONALS_AS_NULL_TASK = exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_TASK = exports.INVALID_COMMENT = exports.DEFAULT_LOCATION_REMINDER = exports.DEFAULT_ABSOLUTE_REMINDER = exports.DEFAULT_RELATIVE_REMINDER = exports.DEFAULT_REMINDER_ID = exports.DEFAULT_COMMENT = exports.DEFAULT_RAW_COMMENT = exports.INVALID_ATTACHMENT = exports.DEFAULT_ATTACHMENT = exports.INVALID_USER = exports.DEFAULT_USER = exports.INVALID_LABEL = exports.DEFAULT_LABEL = exports.INVALID_SECTION = exports.DEFAULT_SECTION = exports.PROJECT_WITH_OPTIONALS_AS_NULL = exports.INVALID_PROJECT = exports.DEFAULT_PROJECT = exports.TASK_WITH_OPTIONALS_AS_NULL = exports.INVALID_TASK = exports.DEFAULT_TASK = exports.DEFAULT_DEADLINE = exports.DEFAULT_DURATION = exports.DEFAULT_DUE_DATE = exports.INVALID_ENTITY_ID = exports.DEFAULT_REQUEST_ID = exports.DEFAULT_AUTH_TOKEN = exports.DEFAULT_PROJECT_VIEW_STYLE = exports.DEFAULT_PROJECT_NAME = exports.DEFAULT_PROJECT_ID = exports.DEFAULT_ORDER = exports.DEFAULT_TASK_PRIORITY = exports.DEFAULT_TASK_DESCRIPTION = exports.DEFAULT_TASK_CONTENT = exports.DEFAULT_TASK_ID = void 0;
+exports.DEFAULT_FOLDER = exports.COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = exports.COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = exports.RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = exports.COMMENT_WITH_OPTIONALS_AS_NULL_TASK = exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_TASK = exports.INVALID_COMMENT = exports.DEFAULT_LOCATION_REMINDER = exports.DEFAULT_ABSOLUTE_REMINDER = exports.DEFAULT_RELATIVE_REMINDER = exports.DEFAULT_REMINDER_ID = exports.DEFAULT_COMMENT = exports.DEFAULT_RAW_COMMENT = exports.INVALID_ATTACHMENT = exports.DEFAULT_ATTACHMENT = exports.INVALID_USER = exports.DEFAULT_USER = exports.INVALID_LABEL = exports.DEFAULT_LABEL = exports.INVALID_SECTION = exports.DEFAULT_SECTION = exports.PROJECT_WITH_OPTIONALS_AS_NULL = exports.INVALID_PROJECT = exports.DEFAULT_PROJECT = exports.TASK_WITH_OPTIONALS_AS_NULL = exports.INVALID_TASK = exports.DEFAULT_TASK = exports.DEFAULT_DEADLINE = exports.DEFAULT_DURATION = exports.DEFAULT_DUE_DATE = exports.INVALID_ENTITY_ID = exports.DEFAULT_REQUEST_ID = exports.DEFAULT_AUTH_TOKEN = exports.DEFAULT_PROJECT_VIEW_STYLE = exports.DEFAULT_PROJECT_NAME = exports.DEFAULT_PROJECT_ID = exports.DEFAULT_ORDER = exports.DEFAULT_TASK_PRIORITY = exports.DEFAULT_TASK_DESCRIPTION = exports.DEFAULT_TASK_CONTENT = exports.DEFAULT_TASK_ID = void 0;
 const url_helpers_1 = require("../utils/url-helpers");
 exports.DEFAULT_TASK_ID = '1234';
 exports.DEFAULT_TASK_CONTENT = 'This is a task';
@@ -230,3 +230,11 @@ exports.RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = Object.assign(Objec
 exports.COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = Object.assign(Object.assign({}, exports.RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL), { taskId: exports.RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL.itemId, itemId: undefined });
 exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = Object.assign(Object.assign({}, exports.DEFAULT_RAW_COMMENT), { itemId: undefined, projectId: exports.DEFAULT_PROJECT_ID });
 exports.COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = Object.assign(Object.assign({}, exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT), { taskId: undefined });
+exports.DEFAULT_FOLDER = {
+    id: '789',
+    name: 'This is a folder',
+    workspaceId: '100',
+    defaultOrder: 3,
+    childOrder: 3,
+    isDeleted: false,
+};

package/dist/cjs/todoist-api.js

@@ -12,9 +12,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TodoistApi = void 0;
-const tasks_1 = require("./types/tasks");
 const reminders_1 = require("./types/reminders");
-const reminders_2 = require("./types/sync/resources/reminders");
 const http_client_1 = require("./transport/http-client");
 const endpoints_1 = require("./consts/endpoints");
 const validators_1 = require("./utils/validators");
@@ -87,56 +85,6 @@ function headersToRecord(headers) {
     });
     return result;
 }
-const ReminderDeliveryServiceSchema = zod_1.z.enum(reminders_1.REMINDER_DELIVERY_SERVICES);
-const ReminderIdSchema = zod_1.z.string();
-const ReminderDueDateSchema = tasks_1.DueDateSchema.pick({
-    date: true,
-    string: true,
-    timezone: true,
-    lang: true,
-    isRecurring: true,
-})
-    .partial()
-    .strict();
-const UpdateRelativeReminderArgsSchema = zod_1.z
-    .object({
-    reminderType: zod_1.z.literal('relative'),
-    minuteOffset: zod_1.z.number().int().optional(),
-    notifyUid: zod_1.z.string().optional(),
-    service: ReminderDeliveryServiceSchema.optional(),
-    isUrgent: zod_1.z.boolean().optional(),
-})
-    .strict();
-const UpdateAbsoluteReminderArgsSchema = zod_1.z
-    .object({
-    reminderType: zod_1.z.literal('absolute'),
-    due: ReminderDueDateSchema.optional(),
-    notifyUid: zod_1.z.string().optional(),
-    service: ReminderDeliveryServiceSchema.optional(),
-    isUrgent: zod_1.z.boolean().optional(),
-})
-    .strict();
-const UpdateLocationReminderArgsSchema = zod_1.z
-    .object({
-    notifyUid: zod_1.z.string().optional(),
-    name: zod_1.z.string().optional(),
-    locLat: zod_1.z.string().optional(),
-    locLong: zod_1.z.string().optional(),
-    locTrigger: zod_1.z.enum(reminders_2.LOCATION_TRIGGERS).optional(),
-    radius: zod_1.z.number().int().optional(),
-})
-    .strict()
-    .refine((args) => Object.values(args).some((value) => value !== undefined), {
-    message: 'At least one reminder field must be provided to updateLocationReminder',
-});
-const UpdateReminderArgsSchema = zod_1.z
-    .discriminatedUnion('reminderType', [
-    UpdateRelativeReminderArgsSchema,
-    UpdateAbsoluteReminderArgsSchema,
-])
-    .refine((args) => Object.entries(args).some(([key, value]) => key !== 'reminderType' && value !== undefined), {
-    message: 'At least one reminder field must be provided to updateReminder',
-});
 class TodoistApi {
     constructor(
     /**
@@ -1439,7 +1387,7 @@ class TodoistApi {
      * @returns A promise that resolves to the requested reminder.
      */
     async getReminder(id) {
-        ReminderIdSchema.parse(id);
+        reminders_1.ReminderIdSchema.parse(id);
         try {
             const response = await (0, http_client_1.request)({
                 httpMethod: 'GET',
@@ -1464,7 +1412,7 @@ class TodoistApi {
      * @returns A promise that resolves to the requested reminder.
      */
     async getLocationReminder(id) {
-        ReminderIdSchema.parse(id);
+        reminders_1.ReminderIdSchema.parse(id);
         try {
             const response = await (0, http_client_1.request)({
                 httpMethod: 'GET',
@@ -1529,8 +1477,8 @@ class TodoistApi {
      * @returns A promise that resolves to the updated reminder.
      */
     async updateReminder(id, args, requestId) {
-        ReminderIdSchema.parse(id);
-        const payload = UpdateReminderArgsSchema.parse(args);
+        reminders_1.ReminderIdSchema.parse(id);
+        const payload = reminders_1.UpdateReminderArgsSchema.parse(args);
         try {
             const response = await (0, http_client_1.request)({
                 httpMethod: 'POST',
@@ -1559,8 +1507,8 @@ class TodoistApi {
      * @returns A promise that resolves to the updated reminder.
      */
     async updateLocationReminder(id, args, requestId) {
-        ReminderIdSchema.parse(id);
-        const payload = UpdateLocationReminderArgsSchema.parse(args);
+        reminders_1.ReminderIdSchema.parse(id);
+        const payload = reminders_1.UpdateLocationReminderArgsSchema.parse(args);
         try {
             const response = await (0, http_client_1.request)({
                 httpMethod: 'POST',
@@ -1588,7 +1536,7 @@ class TodoistApi {
      * @returns A promise that resolves to `true` if successful.
      */
     async deleteReminder(id, requestId) {
-        ReminderIdSchema.parse(id);
+        reminders_1.ReminderIdSchema.parse(id);
         try {
             const response = await (0, http_client_1.request)({
                 httpMethod: 'DELETE',
@@ -1615,7 +1563,7 @@ class TodoistApi {
      * @returns A promise that resolves to `true` if successful.
      */
     async deleteLocationReminder(id, requestId) {
-        ReminderIdSchema.parse(id);
+        reminders_1.ReminderIdSchema.parse(id);
         try {
             const response = await (0, http_client_1.request)({
                 httpMethod: 'DELETE',
@@ -1845,6 +1793,103 @@ class TodoistApi {
             arrayBuffer: () => response.arrayBuffer(),
         };
     }
+    // ── Folders ──
+    /**
+     * Retrieves a paginated list of folders.
+     *
+     * @param args - Filter parameters such as workspace ID.
+     * @returns A promise that resolves to a paginated response of folders.
+     */
+    async getFolders(args) {
+        const { data: { results, nextCursor }, } = await (0, http_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_FOLDERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            results: (0, validators_1.validateFolderArray)(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves a single folder by its ID.
+     *
+     * @param id - The unique identifier of the folder.
+     * @returns A promise that resolves to the requested folder.
+     */
+    async getFolder(id) {
+        zod_1.z.string().parse(id);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_FOLDERS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return (0, validators_1.validateFolder)(response.data);
+    }
+    /**
+     * Creates a new folder.
+     *
+     * @param args - Folder creation parameters including name and workspace ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created folder.
+     */
+    async addFolder(args, requestId) {
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: endpoints_1.ENDPOINT_REST_FOLDERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateFolder)(response.data);
+    }
+    /**
+     * Updates an existing folder by its ID.
+     *
+     * @param id - The unique identifier of the folder to update.
+     * @param args - Update parameters such as name or default order.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated folder.
+     */
+    async updateFolder(id, args, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_FOLDERS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return (0, validators_1.validateFolder)(response.data);
+    }
+    /**
+     * Deletes a folder by its ID.
+     *
+     * @param id - The unique identifier of the folder to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteFolder(id, requestId) {
+        zod_1.z.string().parse(id);
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(endpoints_1.ENDPOINT_REST_FOLDERS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return (0, http_client_1.isSuccess)(response);
+    }
     // ── Backups ──
     /**
      * Retrieves a list of available backups.

package/dist/cjs/types/folders/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests"), exports);

package/dist/cjs/types/folders/requests.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./users"), exports);
 __exportStar(require("./productivity"), exports);
 __exportStar(require("./activity"), exports);
 __exportStar(require("./workspaces"), exports);
+__exportStar(require("./folders"), exports);
 __exportStar(require("./insights"), exports);
 __exportStar(require("./backups"), exports);
 __exportStar(require("./id-mappings"), exports);

package/dist/cjs/types/reminders/requests.js

@@ -1,5 +1,95 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REMINDER_DELIVERY_SERVICES = void 0;
+exports.UpdateLocationReminderArgsSchema = exports.UpdateReminderArgsSchema = exports.UpdateAbsoluteReminderArgsSchema = exports.UpdateRelativeReminderArgsSchema = exports.AddLocationReminderArgsSchema = exports.AddReminderArgsSchema = exports.AddAbsoluteReminderArgsSchema = exports.AddRelativeReminderArgsSchema = exports.ReminderDueDateSchema = exports.ReminderIdSchema = exports.ReminderDeliveryServiceSchema = exports.REMINDER_DELIVERY_SERVICES = void 0;
+const zod_1 = require("zod");
+const types_1 = require("../tasks/types");
+const reminders_1 = require("../sync/resources/reminders");
 /** Available reminder delivery services. */
 exports.REMINDER_DELIVERY_SERVICES = ['email', 'push'];
+exports.ReminderDeliveryServiceSchema = zod_1.z.enum(exports.REMINDER_DELIVERY_SERVICES);
+exports.ReminderIdSchema = zod_1.z.string();
+exports.ReminderDueDateSchema = types_1.DueDateSchema.pick({
+    date: true,
+    string: true,
+    timezone: true,
+    lang: true,
+    isRecurring: true,
+})
+    .partial()
+    .strict();
+// ── Add schemas ──────────────────────────────────────────────────────
+exports.AddRelativeReminderArgsSchema = zod_1.z
+    .object({
+    taskId: zod_1.z.string(),
+    reminderType: zod_1.z.literal(reminders_1.ReminderTypeEnum.Relative).optional(),
+    minuteOffset: zod_1.z.number().int(),
+    service: exports.ReminderDeliveryServiceSchema.optional(),
+    notifyUid: zod_1.z.string().optional(),
+    isUrgent: zod_1.z.boolean().optional(),
+})
+    .strict();
+exports.AddAbsoluteReminderArgsSchema = zod_1.z
+    .object({
+    taskId: zod_1.z.string(),
+    reminderType: zod_1.z.literal(reminders_1.ReminderTypeEnum.Absolute),
+    due: exports.ReminderDueDateSchema,
+    service: exports.ReminderDeliveryServiceSchema.optional(),
+    notifyUid: zod_1.z.string().optional(),
+    isUrgent: zod_1.z.boolean().optional(),
+})
+    .strict();
+exports.AddReminderArgsSchema = zod_1.z.union([
+    exports.AddRelativeReminderArgsSchema,
+    exports.AddAbsoluteReminderArgsSchema,
+]);
+exports.AddLocationReminderArgsSchema = zod_1.z
+    .object({
+    taskId: zod_1.z.string(),
+    notifyUid: zod_1.z.string().optional(),
+    name: zod_1.z.string(),
+    locLat: zod_1.z.string(),
+    locLong: zod_1.z.string(),
+    locTrigger: zod_1.z.enum(reminders_1.LOCATION_TRIGGERS),
+    radius: zod_1.z.number().int().optional(),
+})
+    .strict();
+// ── Update schemas ───────────────────────────────────────────────────
+exports.UpdateRelativeReminderArgsSchema = zod_1.z
+    .object({
+    reminderType: zod_1.z.literal(reminders_1.ReminderTypeEnum.Relative),
+    minuteOffset: zod_1.z.number().int().optional(),
+    notifyUid: zod_1.z.string().optional(),
+    service: exports.ReminderDeliveryServiceSchema.optional(),
+    isUrgent: zod_1.z.boolean().optional(),
+})
+    .strict();
+exports.UpdateAbsoluteReminderArgsSchema = zod_1.z
+    .object({
+    reminderType: zod_1.z.literal(reminders_1.ReminderTypeEnum.Absolute),
+    due: exports.ReminderDueDateSchema.optional(),
+    notifyUid: zod_1.z.string().optional(),
+    service: exports.ReminderDeliveryServiceSchema.optional(),
+    isUrgent: zod_1.z.boolean().optional(),
+})
+    .strict();
+exports.UpdateReminderArgsSchema = zod_1.z
+    .discriminatedUnion('reminderType', [
+    exports.UpdateRelativeReminderArgsSchema,
+    exports.UpdateAbsoluteReminderArgsSchema,
+])
+    .refine((args) => Object.entries(args).some(([key, value]) => key !== 'reminderType' && value !== undefined), {
+    message: 'At least one reminder field must be provided to updateReminder',
+});
+exports.UpdateLocationReminderArgsSchema = zod_1.z
+    .object({
+    notifyUid: zod_1.z.string().optional(),
+    name: zod_1.z.string().optional(),
+    locLat: zod_1.z.string().optional(),
+    locLong: zod_1.z.string().optional(),
+    locTrigger: zod_1.z.enum(reminders_1.LOCATION_TRIGGERS).optional(),
+    radius: zod_1.z.number().int().optional(),
+})
+    .strict()
+    .refine((args) => Object.values(args).some((value) => value !== undefined), {
+    message: 'At least one reminder field must be provided to updateLocationReminder',
+});

package/dist/cjs/types/sync/resources/reminders.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReminderSchema = exports.RelativeReminderSchema = exports.AbsoluteReminderSchema = exports.LocationReminderSchema = exports.LOCATION_TRIGGERS = exports.ReminderBaseSchema = void 0;
+exports.ReminderSchema = exports.RelativeReminderSchema = exports.AbsoluteReminderSchema = exports.LocationReminderSchema = exports.LOCATION_TRIGGERS = exports.REMINDER_TYPES = exports.ReminderTypeEnum = exports.ReminderBaseSchema = void 0;
 const zod_1 = require("zod");
 const types_1 = require("../../tasks/types");
 exports.ReminderBaseSchema = zod_1.z.object({
@@ -10,10 +10,22 @@ exports.ReminderBaseSchema = zod_1.z.object({
     projectId: zod_1.z.string().optional(),
     isDeleted: zod_1.z.boolean(),
 });
+/** Enum-like object of reminder type values. */
+exports.ReminderTypeEnum = {
+    Relative: 'relative',
+    Absolute: 'absolute',
+    Location: 'location',
+};
+/** Available reminder types. */
+exports.REMINDER_TYPES = [
+    exports.ReminderTypeEnum.Relative,
+    exports.ReminderTypeEnum.Absolute,
+    exports.ReminderTypeEnum.Location,
+];
 /** Available location reminder triggers. */
 exports.LOCATION_TRIGGERS = ['on_enter', 'on_leave'];
 exports.LocationReminderSchema = exports.ReminderBaseSchema.extend({
-    type: zod_1.z.literal('location'),
+    type: zod_1.z.literal(exports.ReminderTypeEnum.Location),
     name: zod_1.z.string(),
     locLat: zod_1.z.string(),
     locLong: zod_1.z.string(),
@@ -21,12 +33,12 @@ exports.LocationReminderSchema = exports.ReminderBaseSchema.extend({
     radius: zod_1.z.number().int(),
 }).passthrough();
 exports.AbsoluteReminderSchema = exports.ReminderBaseSchema.extend({
-    type: zod_1.z.literal('absolute'),
+    type: zod_1.z.literal(exports.ReminderTypeEnum.Absolute),
     due: types_1.DueDateSchema,
     isUrgent: zod_1.z.boolean().optional(),
 }).passthrough();
 exports.RelativeReminderSchema = exports.ReminderBaseSchema.extend({
-    type: zod_1.z.literal('relative'),
+    type: zod_1.z.literal(exports.ReminderTypeEnum.Relative),
     minuteOffset: zod_1.z.number().int(),
     due: types_1.DueDateSchema.optional(),
     isUrgent: zod_1.z.boolean().optional(),

package/dist/esm/consts/endpoints.js

@@ -65,6 +65,7 @@ export const ENDPOINT_SYNC = 'sync';
 export const ENDPOINT_AUTHORIZATION = 'authorize';
 export const ENDPOINT_GET_TOKEN = 'access_token';
 export const ENDPOINT_REVOKE = 'revoke';
+export const ENDPOINT_REST_FOLDERS = 'folders';
 // Workspace endpoints
 export const ENDPOINT_REST_WORKSPACES = 'workspaces';
 export const ENDPOINT_WORKSPACE_INVITATIONS = 'workspaces/invitations';

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

@@ -227,3 +227,11 @@ export const RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = Object.assign(
 export const COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = Object.assign(Object.assign({}, RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL), { taskId: RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL.itemId, itemId: undefined });
 export const RAW_COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = Object.assign(Object.assign({}, DEFAULT_RAW_COMMENT), { itemId: undefined, projectId: DEFAULT_PROJECT_ID });
 export const COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = Object.assign(Object.assign({}, RAW_COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT), { taskId: undefined });
+export const DEFAULT_FOLDER = {
+    id: '789',
+    name: 'This is a folder',
+    workspaceId: '100',
+    defaultOrder: 3,
+    childOrder: 3,
+    isDeleted: false,
+};

package/dist/esm/todoist-api.js

@@ -9,12 +9,10 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
-import { DueDateSchema, } from './types/tasks/index.js';
-import { REMINDER_DELIVERY_SERVICES, } from './types/reminders/index.js';
-import { LOCATION_TRIGGERS } from './types/sync/resources/reminders.js';
+import { UpdateReminderArgsSchema, UpdateLocationReminderArgsSchema, ReminderIdSchema, } from './types/reminders/index.js';
 import { request, isSuccess } from './transport/http-client.js';
-import { getSyncBaseUri, ENDPOINT_REST_TASKS, ENDPOINT_REST_TASKS_FILTER, ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE, ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE, ENDPOINT_REST_TASKS_COMPLETED_SEARCH, ENDPOINT_REST_TASKS_COMPLETED, ENDPOINT_REST_TEMPLATES_FILE, ENDPOINT_REST_TEMPLATES_URL, ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID, ENDPOINT_REST_PROJECTS, ENDPOINT_REST_PROJECTS_SEARCH, ENDPOINT_SYNC_QUICK_ADD, ENDPOINT_REST_TASK_CLOSE, ENDPOINT_REST_TASK_REOPEN, ENDPOINT_REST_TASK_MOVE, ENDPOINT_REST_LABELS, ENDPOINT_REST_LABELS_SEARCH, ENDPOINT_REST_PROJECT_COLLABORATORS, ENDPOINT_REST_SECTIONS, ENDPOINT_REST_SECTIONS_SEARCH, ENDPOINT_REST_COMMENTS, ENDPOINT_REST_LOCATION_REMINDERS, ENDPOINT_REST_REMINDERS, ENDPOINT_REST_LABELS_SHARED, ENDPOINT_REST_LABELS_SHARED_RENAME, ENDPOINT_REST_LABELS_SHARED_REMOVE, ENDPOINT_SYNC, PROJECT_ARCHIVE, PROJECT_UNARCHIVE, ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE, ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL, ENDPOINT_REST_PROJECTS_ARCHIVED, ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT, ENDPOINT_REST_PROJECTS_PERMISSIONS, ENDPOINT_REST_PROJECT_FULL, ENDPOINT_REST_PROJECT_JOIN, SECTION_ARCHIVE, SECTION_UNARCHIVE, ENDPOINT_REST_USER, ENDPOINT_REST_PRODUCTIVITY, ENDPOINT_REST_ACTIVITIES, ENDPOINT_REST_UPLOADS, getProjectInsightsActivityStatsEndpoint, getProjectInsightsHealthEndpoint, getProjectInsightsHealthContextEndpoint, getProjectInsightsProgressEndpoint, getProjectInsightsHealthAnalyzeEndpoint, getWorkspaceInsightsEndpoint, ENDPOINT_REST_BACKUPS, ENDPOINT_REST_BACKUPS_DOWNLOAD, ENDPOINT_REST_EMAILS, ENDPOINT_REST_ID_MAPPINGS, ENDPOINT_REST_MOVED_IDS, ENDPOINT_REST_WORKSPACES, ENDPOINT_WORKSPACE_MEMBERS, getWorkspaceUserTasksEndpoint, getWorkspaceInviteUsersEndpoint, getWorkspaceUserEndpoint, ENDPOINT_WORKSPACE_INVITATIONS, ENDPOINT_WORKSPACE_INVITATIONS_ALL, ENDPOINT_WORKSPACE_INVITATIONS_DELETE, getWorkspaceInvitationAcceptEndpoint, getWorkspaceInvitationRejectEndpoint, ENDPOINT_WORKSPACE_JOIN, ENDPOINT_WORKSPACE_LOGO, ENDPOINT_WORKSPACE_PLAN_DETAILS, ENDPOINT_WORKSPACE_USERS, getWorkspaceActiveProjectsEndpoint, getWorkspaceArchivedProjectsEndpoint, } from './consts/endpoints.js';
-import { validateAttachment, validateComment, validateCommentArray, validateCurrentUser, validateLabel, validateLabelArray, validateProject, validateProjectArray, validateSection, validateSectionArray, validateTask, validateTaskArray, validateUserArray, validateProductivityStats, validateReminder, validateReminderArray, validateLocationReminderArray, validateActivityEventArray, validateWorkspaceUserArray, validateWorkspaceInvitation, validateWorkspaceInvitationArray, validateWorkspacePlanDetails, validateJoinWorkspaceResult, validateWorkspace, validateWorkspaceArray, validateMemberActivityInfoArray, validateWorkspaceUserTaskArray, validateProjectActivityStats, validateProjectHealth, validateProjectHealthContext, validateProjectProgress, validateWorkspaceInsights, validateBackupArray, validateIdMappingArray, validateMovedIdArray, } from './utils/validators.js';
+import { getSyncBaseUri, ENDPOINT_REST_TASKS, ENDPOINT_REST_TASKS_FILTER, ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE, ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE, ENDPOINT_REST_TASKS_COMPLETED_SEARCH, ENDPOINT_REST_TASKS_COMPLETED, ENDPOINT_REST_TEMPLATES_FILE, ENDPOINT_REST_TEMPLATES_URL, ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID, ENDPOINT_REST_PROJECTS, ENDPOINT_REST_PROJECTS_SEARCH, ENDPOINT_SYNC_QUICK_ADD, ENDPOINT_REST_TASK_CLOSE, ENDPOINT_REST_TASK_REOPEN, ENDPOINT_REST_TASK_MOVE, ENDPOINT_REST_LABELS, ENDPOINT_REST_LABELS_SEARCH, ENDPOINT_REST_PROJECT_COLLABORATORS, ENDPOINT_REST_SECTIONS, ENDPOINT_REST_SECTIONS_SEARCH, ENDPOINT_REST_COMMENTS, ENDPOINT_REST_LOCATION_REMINDERS, ENDPOINT_REST_REMINDERS, ENDPOINT_REST_LABELS_SHARED, ENDPOINT_REST_LABELS_SHARED_RENAME, ENDPOINT_REST_LABELS_SHARED_REMOVE, ENDPOINT_SYNC, PROJECT_ARCHIVE, PROJECT_UNARCHIVE, ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE, ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL, ENDPOINT_REST_PROJECTS_ARCHIVED, ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT, ENDPOINT_REST_PROJECTS_PERMISSIONS, ENDPOINT_REST_PROJECT_FULL, ENDPOINT_REST_PROJECT_JOIN, SECTION_ARCHIVE, SECTION_UNARCHIVE, ENDPOINT_REST_USER, ENDPOINT_REST_PRODUCTIVITY, ENDPOINT_REST_ACTIVITIES, ENDPOINT_REST_UPLOADS, getProjectInsightsActivityStatsEndpoint, getProjectInsightsHealthEndpoint, getProjectInsightsHealthContextEndpoint, getProjectInsightsProgressEndpoint, getProjectInsightsHealthAnalyzeEndpoint, getWorkspaceInsightsEndpoint, ENDPOINT_REST_BACKUPS, ENDPOINT_REST_BACKUPS_DOWNLOAD, ENDPOINT_REST_EMAILS, ENDPOINT_REST_ID_MAPPINGS, ENDPOINT_REST_MOVED_IDS, ENDPOINT_REST_WORKSPACES, ENDPOINT_WORKSPACE_MEMBERS, getWorkspaceUserTasksEndpoint, getWorkspaceInviteUsersEndpoint, getWorkspaceUserEndpoint, ENDPOINT_WORKSPACE_INVITATIONS, ENDPOINT_WORKSPACE_INVITATIONS_ALL, ENDPOINT_WORKSPACE_INVITATIONS_DELETE, getWorkspaceInvitationAcceptEndpoint, getWorkspaceInvitationRejectEndpoint, ENDPOINT_WORKSPACE_JOIN, ENDPOINT_WORKSPACE_LOGO, ENDPOINT_WORKSPACE_PLAN_DETAILS, ENDPOINT_WORKSPACE_USERS, getWorkspaceActiveProjectsEndpoint, getWorkspaceArchivedProjectsEndpoint, ENDPOINT_REST_FOLDERS, } from './consts/endpoints.js';
+import { validateAttachment, validateComment, validateCommentArray, validateCurrentUser, validateLabel, validateLabelArray, validateProject, validateProjectArray, validateSection, validateSectionArray, validateTask, validateTaskArray, validateUserArray, validateProductivityStats, validateReminder, validateReminderArray, validateLocationReminderArray, validateActivityEventArray, validateWorkspaceUserArray, validateWorkspaceInvitation, validateWorkspaceInvitationArray, validateWorkspacePlanDetails, validateJoinWorkspaceResult, validateWorkspace, validateWorkspaceArray, validateMemberActivityInfoArray, validateWorkspaceUserTaskArray, validateProjectActivityStats, validateProjectHealth, validateProjectHealthContext, validateProjectProgress, validateWorkspaceInsights, validateBackupArray, validateIdMappingArray, validateMovedIdArray, validateFolder, validateFolderArray, } from './utils/validators.js';
 import { formatDateToYYYYMMDD } from './utils/url-helpers.js';
 import { uploadMultipartFile } from './utils/multipart-upload.js';
 import { camelCaseKeys } from './utils/case-conversion.js';
@@ -84,56 +82,6 @@ function headersToRecord(headers) {
     });
     return result;
 }
-const ReminderDeliveryServiceSchema = z.enum(REMINDER_DELIVERY_SERVICES);
-const ReminderIdSchema = z.string();
-const ReminderDueDateSchema = DueDateSchema.pick({
-    date: true,
-    string: true,
-    timezone: true,
-    lang: true,
-    isRecurring: true,
-})
-    .partial()
-    .strict();
-const UpdateRelativeReminderArgsSchema = z
-    .object({
-    reminderType: z.literal('relative'),
-    minuteOffset: z.number().int().optional(),
-    notifyUid: z.string().optional(),
-    service: ReminderDeliveryServiceSchema.optional(),
-    isUrgent: z.boolean().optional(),
-})
-    .strict();
-const UpdateAbsoluteReminderArgsSchema = z
-    .object({
-    reminderType: z.literal('absolute'),
-    due: ReminderDueDateSchema.optional(),
-    notifyUid: z.string().optional(),
-    service: ReminderDeliveryServiceSchema.optional(),
-    isUrgent: z.boolean().optional(),
-})
-    .strict();
-const UpdateLocationReminderArgsSchema = z
-    .object({
-    notifyUid: z.string().optional(),
-    name: z.string().optional(),
-    locLat: z.string().optional(),
-    locLong: z.string().optional(),
-    locTrigger: z.enum(LOCATION_TRIGGERS).optional(),
-    radius: z.number().int().optional(),
-})
-    .strict()
-    .refine((args) => Object.values(args).some((value) => value !== undefined), {
-    message: 'At least one reminder field must be provided to updateLocationReminder',
-});
-const UpdateReminderArgsSchema = z
-    .discriminatedUnion('reminderType', [
-    UpdateRelativeReminderArgsSchema,
-    UpdateAbsoluteReminderArgsSchema,
-])
-    .refine((args) => Object.entries(args).some(([key, value]) => key !== 'reminderType' && value !== undefined), {
-    message: 'At least one reminder field must be provided to updateReminder',
-});
 export class TodoistApi {
     constructor(
     /**
@@ -1842,6 +1790,103 @@ export class TodoistApi {
             arrayBuffer: () => response.arrayBuffer(),
         };
     }
+    // ── Folders ──
+    /**
+     * Retrieves a paginated list of folders.
+     *
+     * @param args - Filter parameters such as workspace ID.
+     * @returns A promise that resolves to a paginated response of folders.
+     */
+    async getFolders(args) {
+        const { data: { results, nextCursor }, } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_FOLDERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            results: validateFolderArray(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves a single folder by its ID.
+     *
+     * @param id - The unique identifier of the folder.
+     * @returns A promise that resolves to the requested folder.
+     */
+    async getFolder(id) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_FOLDERS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateFolder(response.data);
+    }
+    /**
+     * Creates a new folder.
+     *
+     * @param args - Folder creation parameters including name and workspace ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created folder.
+     */
+    async addFolder(args, requestId) {
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_FOLDERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return validateFolder(response.data);
+    }
+    /**
+     * Updates an existing folder by its ID.
+     *
+     * @param id - The unique identifier of the folder to update.
+     * @param args - Update parameters such as name or default order.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated folder.
+     */
+    async updateFolder(id, args, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_FOLDERS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return validateFolder(response.data);
+    }
+    /**
+     * Deletes a folder by its ID.
+     *
+     * @param id - The unique identifier of the folder to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async deleteFolder(id, requestId) {
+        z.string().parse(id);
+        const response = await request({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_FOLDERS, id),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return isSuccess(response);
+    }
     // ── Backups ──
     /**
      * Retrieves a list of available backups.

package/dist/esm/types/folders/index.js

@@ -0,0 +1 @@
+export * from './requests.js';

package/dist/esm/types/folders/requests.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/index.js

@@ -8,6 +8,7 @@ export * from './users/index.js';
 export * from './productivity/index.js';
 export * from './activity/index.js';
 export * from './workspaces/index.js';
+export * from './folders/index.js';
 export * from './insights/index.js';
 export * from './backups/index.js';
 export * from './id-mappings/index.js';

package/dist/esm/types/reminders/requests.js

@@ -1,2 +1,92 @@
+import { z } from 'zod';
+import { DueDateSchema } from '../tasks/types.js';
+import { LOCATION_TRIGGERS, ReminderTypeEnum } from '../sync/resources/reminders.js';
 /** Available reminder delivery services. */
 export const REMINDER_DELIVERY_SERVICES = ['email', 'push'];
+export const ReminderDeliveryServiceSchema = z.enum(REMINDER_DELIVERY_SERVICES);
+export const ReminderIdSchema = z.string();
+export const ReminderDueDateSchema = DueDateSchema.pick({
+    date: true,
+    string: true,
+    timezone: true,
+    lang: true,
+    isRecurring: true,
+})
+    .partial()
+    .strict();
+// ── Add schemas ──────────────────────────────────────────────────────
+export const AddRelativeReminderArgsSchema = z
+    .object({
+    taskId: z.string(),
+    reminderType: z.literal(ReminderTypeEnum.Relative).optional(),
+    minuteOffset: z.number().int(),
+    service: ReminderDeliveryServiceSchema.optional(),
+    notifyUid: z.string().optional(),
+    isUrgent: z.boolean().optional(),
+})
+    .strict();
+export const AddAbsoluteReminderArgsSchema = z
+    .object({
+    taskId: z.string(),
+    reminderType: z.literal(ReminderTypeEnum.Absolute),
+    due: ReminderDueDateSchema,
+    service: ReminderDeliveryServiceSchema.optional(),
+    notifyUid: z.string().optional(),
+    isUrgent: z.boolean().optional(),
+})
+    .strict();
+export const AddReminderArgsSchema = z.union([
+    AddRelativeReminderArgsSchema,
+    AddAbsoluteReminderArgsSchema,
+]);
+export const AddLocationReminderArgsSchema = z
+    .object({
+    taskId: z.string(),
+    notifyUid: z.string().optional(),
+    name: z.string(),
+    locLat: z.string(),
+    locLong: z.string(),
+    locTrigger: z.enum(LOCATION_TRIGGERS),
+    radius: z.number().int().optional(),
+})
+    .strict();
+// ── Update schemas ───────────────────────────────────────────────────
+export const UpdateRelativeReminderArgsSchema = z
+    .object({
+    reminderType: z.literal(ReminderTypeEnum.Relative),
+    minuteOffset: z.number().int().optional(),
+    notifyUid: z.string().optional(),
+    service: ReminderDeliveryServiceSchema.optional(),
+    isUrgent: z.boolean().optional(),
+})
+    .strict();
+export const UpdateAbsoluteReminderArgsSchema = z
+    .object({
+    reminderType: z.literal(ReminderTypeEnum.Absolute),
+    due: ReminderDueDateSchema.optional(),
+    notifyUid: z.string().optional(),
+    service: ReminderDeliveryServiceSchema.optional(),
+    isUrgent: z.boolean().optional(),
+})
+    .strict();
+export const UpdateReminderArgsSchema = z
+    .discriminatedUnion('reminderType', [
+    UpdateRelativeReminderArgsSchema,
+    UpdateAbsoluteReminderArgsSchema,
+])
+    .refine((args) => Object.entries(args).some(([key, value]) => key !== 'reminderType' && value !== undefined), {
+    message: 'At least one reminder field must be provided to updateReminder',
+});
+export const UpdateLocationReminderArgsSchema = z
+    .object({
+    notifyUid: z.string().optional(),
+    name: z.string().optional(),
+    locLat: z.string().optional(),
+    locLong: z.string().optional(),
+    locTrigger: z.enum(LOCATION_TRIGGERS).optional(),
+    radius: z.number().int().optional(),
+})
+    .strict()
+    .refine((args) => Object.values(args).some((value) => value !== undefined), {
+    message: 'At least one reminder field must be provided to updateLocationReminder',
+});

package/dist/esm/types/sync/resources/reminders.js

@@ -7,10 +7,22 @@ export const ReminderBaseSchema = z.object({
     projectId: z.string().optional(),
     isDeleted: z.boolean(),
 });
+/** Enum-like object of reminder type values. */
+export const ReminderTypeEnum = {
+    Relative: 'relative',
+    Absolute: 'absolute',
+    Location: 'location',
+};
+/** Available reminder types. */
+export const REMINDER_TYPES = [
+    ReminderTypeEnum.Relative,
+    ReminderTypeEnum.Absolute,
+    ReminderTypeEnum.Location,
+];
 /** Available location reminder triggers. */
 export const LOCATION_TRIGGERS = ['on_enter', 'on_leave'];
 export const LocationReminderSchema = ReminderBaseSchema.extend({
-    type: z.literal('location'),
+    type: z.literal(ReminderTypeEnum.Location),
     name: z.string(),
     locLat: z.string(),
     locLong: z.string(),
@@ -18,12 +30,12 @@ export const LocationReminderSchema = ReminderBaseSchema.extend({
     radius: z.number().int(),
 }).passthrough();
 export const AbsoluteReminderSchema = ReminderBaseSchema.extend({
-    type: z.literal('absolute'),
+    type: z.literal(ReminderTypeEnum.Absolute),
     due: DueDateSchema,
     isUrgent: z.boolean().optional(),
 }).passthrough();
 export const RelativeReminderSchema = ReminderBaseSchema.extend({
-    type: z.literal('relative'),
+    type: z.literal(ReminderTypeEnum.Relative),
     minuteOffset: z.number().int(),
     due: DueDateSchema.optional(),
     isUrgent: z.boolean().optional(),

package/dist/types/consts/endpoints.d.ts

@@ -56,6 +56,7 @@ 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 = "revoke";
+export declare const ENDPOINT_REST_FOLDERS = "folders";
 export declare const ENDPOINT_REST_WORKSPACES = "workspaces";
 export declare const ENDPOINT_WORKSPACE_INVITATIONS = "workspaces/invitations";
 export declare const ENDPOINT_WORKSPACE_INVITATIONS_ALL = "workspaces/invitations/all";

package/dist/types/test-utils/test-defaults.d.ts

@@ -1,4 +1,4 @@
-import { Label, Section, Task, User, Attachment, Duration, Deadline, RawComment, PersonalProject, Reminder } from '../types/index.js';
+import { Label, Section, Task, User, Attachment, Duration, Deadline, RawComment, PersonalProject, Reminder, Folder } from '../types/index.js';
 export declare const DEFAULT_TASK_ID = "1234";
 export declare const DEFAULT_TASK_CONTENT = "This is a task";
 export declare const DEFAULT_TASK_DESCRIPTION = "A description";
@@ -258,3 +258,4 @@ export declare const COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT: {
     itemId?: string | undefined;
     projectId?: string | undefined;
 };
+export declare const DEFAULT_FOLDER: Folder;

package/dist/types/todoist-api.d.ts

@@ -8,6 +8,8 @@ import { CurrentUser } from './types/users/index.js';
 import { ProductivityStats } from './types/productivity/index.js';
 import { GetActivityLogsArgs, GetActivityLogsResponse } from './types/activity/index.js';
 import { WorkspaceInvitation, WorkspacePlanDetails, JoinWorkspaceResult, Workspace, AddWorkspaceArgs, UpdateWorkspaceArgs, GetWorkspaceMembersActivityArgs, GetWorkspaceMembersActivityResponse, GetWorkspaceUserTasksArgs, GetWorkspaceUserTasksResponse, InviteWorkspaceUsersArgs, InviteWorkspaceUsersResponse, UpdateWorkspaceUserArgs, RemoveWorkspaceUserArgs, GetWorkspaceInvitationsArgs, DeleteWorkspaceInvitationArgs, WorkspaceInvitationActionArgs, JoinWorkspaceArgs, WorkspaceLogoArgs, GetWorkspacePlanDetailsArgs, GetWorkspaceUsersArgs, GetWorkspaceUsersResponse, GetWorkspaceProjectsArgs, WorkspaceInvitationsResponse, AllWorkspaceInvitationsResponse, WorkspaceLogoResponse } from './types/workspaces/index.js';
+import { GetFoldersArgs, GetFoldersResponse, AddFolderArgs, UpdateFolderArgs } from './types/folders/index.js';
+import type { Folder } from './types/sync/resources/folders.js';
 import { ProjectActivityStats, ProjectHealth, ProjectHealthContext, ProjectProgress, WorkspaceInsights, GetProjectActivityStatsArgs, GetWorkspaceInsightsArgs } from './types/insights/index.js';
 import { Backup, GetBackupsArgs, DownloadBackupArgs } from './types/backups/index.js';
 import { IdMapping, MovedId, GetIdMappingsArgs, GetMovedIdsArgs } from './types/id-mappings/index.js';
@@ -714,6 +716,45 @@ export declare class TodoistApi {
      * ```
      */
     viewAttachment(commentOrUrl: Comment | string): Promise<FileResponse>;
+    /**
+     * Retrieves a paginated list of folders.
+     *
+     * @param args - Filter parameters such as workspace ID.
+     * @returns A promise that resolves to a paginated response of folders.
+     */
+    getFolders(args: GetFoldersArgs): Promise<GetFoldersResponse>;
+    /**
+     * Retrieves a single folder by its ID.
+     *
+     * @param id - The unique identifier of the folder.
+     * @returns A promise that resolves to the requested folder.
+     */
+    getFolder(id: string): Promise<Folder>;
+    /**
+     * Creates a new folder.
+     *
+     * @param args - Folder creation parameters including name and workspace ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created folder.
+     */
+    addFolder(args: AddFolderArgs, requestId?: string): Promise<Folder>;
+    /**
+     * Updates an existing folder by its ID.
+     *
+     * @param id - The unique identifier of the folder to update.
+     * @param args - Update parameters such as name or default order.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated folder.
+     */
+    updateFolder(id: string, args: UpdateFolderArgs, requestId?: string): Promise<Folder>;
+    /**
+     * Deletes a folder by its ID.
+     *
+     * @param id - The unique identifier of the folder to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    deleteFolder(id: string, requestId?: string): Promise<boolean>;
     /**
      * Retrieves a list of available backups.
      *

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

@@ -0,0 +1 @@
+export * from './requests.js';

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

@@ -0,0 +1,20 @@
+import type { Folder } from '../sync/resources/folders.js';
+export type GetFoldersArgs = {
+    workspaceId: number;
+    cursor?: string | null;
+    limit?: number;
+};
+export type GetFoldersResponse = {
+    results: Folder[];
+    nextCursor: string | null;
+};
+export type AddFolderArgs = {
+    name: string;
+    workspaceId: number;
+    defaultOrder?: number | null;
+    childOrder?: number | null;
+};
+export type UpdateFolderArgs = {
+    name?: string | null;
+    defaultOrder?: number | null;
+};

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

@@ -8,6 +8,7 @@ export * from './users/index.js';
 export * from './productivity/index.js';
 export * from './activity/index.js';
 export * from './workspaces/index.js';
+export * from './folders/index.js';
 export * from './insights/index.js';
 export * from './backups/index.js';
 export * from './id-mappings/index.js';

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

@@ -1,55 +1,170 @@
-import type { DueDate } from '../tasks/types.js';
-import type { LocationTrigger, Reminder, LocationReminder } from '../sync/resources/reminders.js';
+import { z } from 'zod';
+import type { Reminder, LocationReminder } from '../sync/resources/reminders.js';
 /** Available reminder delivery services. */
 export declare const REMINDER_DELIVERY_SERVICES: readonly ["email", "push"];
 /** Delivery service for a reminder notification. */
 export type ReminderDeliveryService = (typeof REMINDER_DELIVERY_SERVICES)[number];
-export type ReminderDueDate = Partial<Pick<DueDate, 'date' | 'string' | 'timezone' | 'lang' | 'isRecurring'>>;
-type ReminderTaskArgs = {
-    taskId: string;
-};
-type TimeBasedReminderArgs = {
-    service?: ReminderDeliveryService;
-    notifyUid?: string;
-    isUrgent?: boolean;
-};
-type AddLocationReminderFields = {
-    notifyUid?: string;
-    name: string;
-    locLat: string;
-    locLong: string;
-    locTrigger: LocationTrigger;
-    radius?: number;
-};
-export type AddRelativeReminderArgs = ReminderTaskArgs & {
-    reminderType?: 'relative';
-    minuteOffset: number;
-} & TimeBasedReminderArgs;
-export type AddAbsoluteReminderArgs = ReminderTaskArgs & {
-    reminderType: 'absolute';
-    due: ReminderDueDate;
-} & TimeBasedReminderArgs;
-export type AddLocationReminderArgs = ReminderTaskArgs & AddLocationReminderFields;
+export declare const ReminderDeliveryServiceSchema: z.ZodEnum<{
+    email: "email";
+    push: "push";
+}>;
+export declare const ReminderIdSchema: z.ZodString;
+export declare const ReminderDueDateSchema: z.ZodObject<{
+    string: z.ZodOptional<z.ZodString>;
+    isRecurring: z.ZodOptional<z.ZodBoolean>;
+    date: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    lang: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+}, z.core.$strict>;
+export type ReminderDueDate = z.infer<typeof ReminderDueDateSchema>;
+export declare const AddRelativeReminderArgsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    reminderType: z.ZodOptional<z.ZodLiteral<"relative">>;
+    minuteOffset: z.ZodNumber;
+    service: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        push: "push";
+    }>>;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    isUrgent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type AddRelativeReminderArgs = z.infer<typeof AddRelativeReminderArgsSchema>;
+export declare const AddAbsoluteReminderArgsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    reminderType: z.ZodLiteral<"absolute">;
+    due: z.ZodObject<{
+        string: z.ZodOptional<z.ZodString>;
+        isRecurring: z.ZodOptional<z.ZodBoolean>;
+        date: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        lang: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    }, z.core.$strict>;
+    service: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        push: "push";
+    }>>;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    isUrgent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type AddAbsoluteReminderArgs = z.infer<typeof AddAbsoluteReminderArgsSchema>;
+export declare const AddReminderArgsSchema: z.ZodUnion<readonly [z.ZodObject<{
+    taskId: z.ZodString;
+    reminderType: z.ZodOptional<z.ZodLiteral<"relative">>;
+    minuteOffset: z.ZodNumber;
+    service: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        push: "push";
+    }>>;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    isUrgent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    taskId: z.ZodString;
+    reminderType: z.ZodLiteral<"absolute">;
+    due: z.ZodObject<{
+        string: z.ZodOptional<z.ZodString>;
+        isRecurring: z.ZodOptional<z.ZodBoolean>;
+        date: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        lang: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    }, z.core.$strict>;
+    service: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        push: "push";
+    }>>;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    isUrgent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>]>;
 /**
  * Arguments for creating a new reminder.
  * @see https://developer.todoist.com/api/v1/#tag/Reminders/operation/create_reminder_api_v1_reminders_post
  */
 export type AddReminderArgs = AddRelativeReminderArgs | AddAbsoluteReminderArgs;
-export type UpdateRelativeReminderArgs = {
-    reminderType: 'relative';
-} & Partial<Omit<AddRelativeReminderArgs, 'taskId' | 'reminderType'>>;
-export type UpdateAbsoluteReminderArgs = {
-    reminderType: 'absolute';
-} & Partial<Omit<AddAbsoluteReminderArgs, 'taskId' | 'reminderType'>>;
+export declare const AddLocationReminderArgsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    locLat: z.ZodString;
+    locLong: z.ZodString;
+    locTrigger: z.ZodEnum<{
+        on_enter: "on_enter";
+        on_leave: "on_leave";
+    }>;
+    radius: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type AddLocationReminderArgs = z.infer<typeof AddLocationReminderArgsSchema>;
+export declare const UpdateRelativeReminderArgsSchema: z.ZodObject<{
+    reminderType: z.ZodLiteral<"relative">;
+    minuteOffset: z.ZodOptional<z.ZodNumber>;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    service: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        push: "push";
+    }>>;
+    isUrgent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type UpdateRelativeReminderArgs = z.infer<typeof UpdateRelativeReminderArgsSchema>;
+export declare const UpdateAbsoluteReminderArgsSchema: z.ZodObject<{
+    reminderType: z.ZodLiteral<"absolute">;
+    due: z.ZodOptional<z.ZodObject<{
+        string: z.ZodOptional<z.ZodString>;
+        isRecurring: z.ZodOptional<z.ZodBoolean>;
+        date: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        lang: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    }, z.core.$strict>>;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    service: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        push: "push";
+    }>>;
+    isUrgent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type UpdateAbsoluteReminderArgs = z.infer<typeof UpdateAbsoluteReminderArgsSchema>;
+export declare const UpdateReminderArgsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    reminderType: z.ZodLiteral<"relative">;
+    minuteOffset: z.ZodOptional<z.ZodNumber>;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    service: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        push: "push";
+    }>>;
+    isUrgent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    reminderType: z.ZodLiteral<"absolute">;
+    due: z.ZodOptional<z.ZodObject<{
+        string: z.ZodOptional<z.ZodString>;
+        isRecurring: z.ZodOptional<z.ZodBoolean>;
+        date: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        lang: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    }, z.core.$strict>>;
+    notifyUid: z.ZodOptional<z.ZodString>;
+    service: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        push: "push";
+    }>>;
+    isUrgent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>], "reminderType">;
 /**
  * Arguments for updating an existing reminder.
  * @see https://developer.todoist.com/api/v1/#tag/Reminders/operation/update_reminder_api_v1_reminders__reminder_id__post
  */
 export type UpdateReminderArgs = UpdateRelativeReminderArgs | UpdateAbsoluteReminderArgs;
+export declare const UpdateLocationReminderArgsSchema: z.ZodObject<{
+    notifyUid: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    locLat: z.ZodOptional<z.ZodString>;
+    locLong: z.ZodOptional<z.ZodString>;
+    locTrigger: z.ZodOptional<z.ZodEnum<{
+        on_enter: "on_enter";
+        on_leave: "on_leave";
+    }>>;
+    radius: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
 /**
  * Arguments for updating an existing location reminder.
  */
-export type UpdateLocationReminderArgs = Partial<Omit<AddLocationReminderArgs, 'taskId'>>;
+export type UpdateLocationReminderArgs = z.infer<typeof UpdateLocationReminderArgsSchema>;
 /**
  * Arguments for listing reminders.
  * @see https://developer.todoist.com/api/v1/#tag/Reminders/operation/get_reminders_api_v1_reminders_get
@@ -88,4 +203,3 @@ export type GetLocationRemindersResponse = {
     results: LocationReminder[];
     nextCursor: string | null;
 };
-export {};

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

@@ -1,20 +1,20 @@
 import type { SyncDueDate, ReminderService } from './shared.js';
-import type { LocationTrigger } from '../resources/reminders.js';
+import type { LocationTrigger, ReminderType } from '../resources/reminders.js';
 export type ReminderAddArgs = {
-    type: 'absolute';
+    type: Extract<ReminderType, 'absolute'>;
     itemId: string;
     service?: ReminderService;
     notifyUid?: string;
     due?: SyncDueDate;
 } | {
-    type: 'relative';
+    type: Extract<ReminderType, 'relative'>;
     itemId: string;
     service?: ReminderService;
     notifyUid?: string;
     minuteOffset?: number;
     due?: SyncDueDate;
 } | {
-    type: 'location';
+    type: Extract<ReminderType, 'location'>;
     itemId: string;
     name: string;
     locLat: string;
@@ -25,20 +25,20 @@ export type ReminderAddArgs = {
 };
 export type ReminderUpdateArgs = {
     id: string;
-    type: 'absolute';
+    type: Extract<ReminderType, 'absolute'>;
     service?: ReminderService;
     notifyUid?: string;
     due?: SyncDueDate;
 } | {
     id: string;
-    type: 'relative';
+    type: Extract<ReminderType, 'relative'>;
     service?: ReminderService;
     notifyUid?: string;
     minuteOffset?: number;
     due?: SyncDueDate;
 } | {
     id: string;
-    type: 'location';
+    type: Extract<ReminderType, 'location'>;
     name?: string;
     locLat?: string;
     locLong?: string;

package/dist/types/types/sync/resources/reminders.d.ts

@@ -6,6 +6,16 @@ export declare const ReminderBaseSchema: z.ZodObject<{
     projectId: z.ZodOptional<z.ZodString>;
     isDeleted: z.ZodBoolean;
 }, z.core.$strip>;
+/** Enum-like object of reminder type values. */
+export declare const ReminderTypeEnum: {
+    readonly Relative: "relative";
+    readonly Absolute: "absolute";
+    readonly Location: "location";
+};
+/** Available reminder types. */
+export declare const REMINDER_TYPES: readonly ["relative", "absolute", "location"];
+/** Discriminator for reminder type. */
+export type ReminderType = (typeof REMINDER_TYPES)[number];
 /** Available location reminder triggers. */
 export declare const LOCATION_TRIGGERS: readonly ["on_enter", "on_leave"];
 /** Trigger condition for a location-based reminder. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-api-typescript",
-    "version": "7.7.0",
+    "version": "7.9.0",
     "description": "A typescript wrapper for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "https://github.com/Doist/todoist-api-typescript",
@@ -17,6 +17,10 @@
             "require": "./dist/cjs/index.js"
         }
     },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
     "sideEffects": false,
     "engines": {
         "node": ">=20.18.1"
@@ -55,6 +59,10 @@
     },
     "devDependencies": {
         "@doist/prettier-config": "4.0.0",
+        "@semantic-release/changelog": "6.0.3",
+        "@semantic-release/exec": "7.1.0",
+        "@semantic-release/git": "10.0.1",
+        "conventional-changelog-conventionalcommits": "9.3.0",
         "dotenv": "17.3.1",
         "husky": "9.1.7",
         "lint-staged": "16.2.7",
@@ -64,6 +72,7 @@
         "oxlint": "1.57.0",
         "prettier": "3.3.2",
         "rimraf": "6.1.3",
+        "semantic-release": "25.0.3",
         "ts-node": "10.9.2",
         "type-fest": "^5.0.0",
         "typescript": "5.9.3",