@doist/todoist-api-typescript 7.3.0 → 7.5.0

package/dist/esm/{utils → transport}/fetch-with-retry.js

@@ -10,6 +10,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 import { isNetworkError } from '../types/http.js';
+import { getDefaultDispatcher } from './http-dispatcher.js';
 /**
  * Default retry configuration matching the original axios-retry behavior
  */
@@ -22,32 +23,11 @@ const DEFAULT_RETRY_CONFIG = {
         return retryNumber === 1 ? 0 : 500;
     },
 };
-/**
- * Cached HTTP agent to prevent creating multiple agents
- * null = not initialized, undefined = browser env, UndiciAgent = Node.js env
- */
-let httpAgent = null;
-/**
- * Gets the HTTP agent for Node.js environments or undefined for browser environments.
- * Uses dynamic import to avoid loading undici in browser environments.
- */
-async function getHttpAgent() {
-    var _a;
-    if (httpAgent === null) {
-        if (typeof process !== 'undefined' && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
-            // We're in Node.js - dynamically import undici
-            const { Agent } = await import('undici');
-            httpAgent = new Agent({
-                keepAliveTimeout: 1, // Close connections after 1ms of idle time
-                keepAliveMaxTimeout: 1, // Maximum time to keep connections alive
-            });
-        }
-        else {
-            // We're in browser - no agent needed
-            httpAgent = undefined;
-        }
-    }
-    return httpAgent;
+const TIMEOUT_ERROR_NAME = 'TimeoutError';
+function createTimeoutError(timeoutMs) {
+    const error = new Error(`Request timeout after ${timeoutMs}ms`);
+    error.name = TIMEOUT_ERROR_NAME;
+    return error;
 }
 /**
  * Converts Headers object to a plain object
@@ -67,10 +47,14 @@ function createTimeoutSignal(timeoutMs, existingSignal) {
     const controller = new AbortController();
     // Timeout logic
     const timeoutId = setTimeout(() => {
-        controller.abort(new Error(`Request timeout after ${timeoutMs}ms`));
+        controller.abort(createTimeoutError(timeoutMs));
     }, timeoutMs);
+    let abortHandler;
     function clear() {
         clearTimeout(timeoutId);
+        if (existingSignal && abortHandler) {
+            existingSignal.removeEventListener('abort', abortHandler);
+        }
     }
     // If there's an existing signal, forward its abort
     if (existingSignal) {
@@ -79,10 +63,11 @@ function createTimeoutSignal(timeoutMs, existingSignal) {
             controller.abort(existingSignal.reason);
         }
         else {
-            existingSignal.addEventListener('abort', () => {
+            abortHandler = () => {
                 clearTimeout(timeoutId);
                 controller.abort(existingSignal.reason);
-            }, { once: true });
+            };
+            existingSignal.addEventListener('abort', abortHandler, { once: true });
         }
     }
     // Clean up timeout when request completes
@@ -131,9 +116,13 @@ export async function fetchWithRetry(args) {
                 fetchResponse = await customFetch(url, Object.assign(Object.assign({}, fetchOptions), { signal: requestSignal, timeout }));
             }
             else {
-                const nativeResponse = await fetch(url, Object.assign(Object.assign({}, fetchOptions), { signal: requestSignal, 
+                const dispatcher = await getDefaultDispatcher();
+                const nativeFetchOptions = Object.assign(Object.assign({}, fetchOptions), { signal: requestSignal });
+                if (dispatcher !== undefined) {
                     // @ts-expect-error - dispatcher is a valid option for Node.js fetch but not in the TS types
-                    dispatcher: await getHttpAgent() }));
+                    nativeFetchOptions.dispatcher = dispatcher;
+                }
+                const nativeResponse = await fetch(url, nativeFetchOptions);
                 fetchResponse = convertResponseToCustomFetch(nativeResponse);
             }
             // Check if the response is successful
@@ -188,6 +177,9 @@ export async function fetchWithRetry(args) {
             };
         }
         catch (error) {
+            if (clearTimeoutFn) {
+                clearTimeoutFn();
+            }
             lastError = error;
             // Check if this error should trigger a retry
             const shouldRetry = attempt < config.retries && config.retryCondition(lastError);
@@ -197,9 +189,6 @@ export async function fetchWithRetry(args) {
                     const networkError = lastError;
                     networkError.isNetworkError = true;
                 }
-                if (clearTimeoutFn) {
-                    clearTimeoutFn();
-                }
                 throw lastError;
             }
             // Wait before retrying
@@ -207,10 +196,6 @@ export async function fetchWithRetry(args) {
             if (delay > 0) {
                 await new Promise((resolve) => setTimeout(resolve, delay));
             }
-            // Retry path – ensure this attempt's timeout is cleared before looping
-            if (clearTimeoutFn) {
-                clearTimeoutFn();
-            }
         }
     }
     // This should never be reached, but just in case

package/dist/esm/{rest-client.js → transport/http-client.js}

@@ -1,14 +1,14 @@
-import { TodoistRequestError } from './types/errors.js';
-import { isNetworkError, isHttpError } from './types/http.js';
 import { v4 as uuidv4 } from 'uuid';
-import { API_BASE_URI } from './consts/endpoints.js';
-import { camelCaseKeys, snakeCaseKeys } from './utils/case-conversion.js';
-import { fetchWithRetry } from './utils/fetch-with-retry.js';
+import { API_BASE_URI } from '../consts/endpoints.js';
+import { TodoistRequestError } from '../types/errors.js';
+import { isHttpError, isNetworkError } from '../types/http.js';
+import { camelCaseKeys, snakeCaseKeys } from '../utils/case-conversion.js';
+import { fetchWithRetry } from './fetch-with-retry.js';
 export function paramsSerializer(params) {
     const qs = new URLSearchParams();
     Object.keys(params).forEach((key) => {
         const value = params[key];
-        if (value != null) {
+        if (value !== null && value !== undefined) {
             if (Array.isArray(value)) {
                 qs.append(key, JSON.stringify(value));
             }

package/dist/esm/transport/http-dispatcher.js

@@ -0,0 +1,35 @@
+// Use effectively-disabled keep-alive so short-lived CLI processes do not stay
+// open waiting on idle sockets. Undici requires positive values, so we use 1ms.
+const KEEP_ALIVE_OPTIONS = {
+    keepAliveTimeout: 1,
+    keepAliveMaxTimeout: 1,
+};
+let defaultDispatcherPromise;
+export function getDefaultDispatcher() {
+    if (!isNodeEnvironment()) {
+        return Promise.resolve(undefined);
+    }
+    if (!defaultDispatcherPromise) {
+        defaultDispatcherPromise = createDefaultDispatcher().catch((error) => {
+            defaultDispatcherPromise = undefined;
+            throw error;
+        });
+    }
+    return defaultDispatcherPromise;
+}
+export async function resetDefaultDispatcherForTests() {
+    if (!defaultDispatcherPromise) {
+        return;
+    }
+    const dispatcherPromise = defaultDispatcherPromise;
+    defaultDispatcherPromise = undefined;
+    await dispatcherPromise.then((dispatcher) => dispatcher.close(), () => undefined);
+}
+async function createDefaultDispatcher() {
+    const { EnvHttpProxyAgent } = await import('undici');
+    return new EnvHttpProxyAgent(KEEP_ALIVE_OPTIONS);
+}
+function isNodeEnvironment() {
+    var _a;
+    return typeof process !== 'undefined' && Boolean((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node);
+}

package/dist/esm/types/entities.js

@@ -114,6 +114,8 @@ export const WorkspaceProjectSchema = BaseProjectSchema.extend({
 }).transform((data) => {
     return Object.assign(Object.assign({}, data), { url: getProjectUrl(data.id, data.name) });
 });
+/** Available project view styles. */
+export const PROJECT_VIEW_STYLES = ['list', 'board', 'calendar'];
 export const SectionSchema = z
     .object({
     id: z.string(),
@@ -317,6 +319,14 @@ export const ActivityEventSchema = z
     extraData: ActivityEventExtraDataSchema,
 })
     .catchall(z.any());
+/** Available project collaborator roles. */
+export const COLLABORATOR_ROLES = [
+    'CREATOR',
+    'ADMIN',
+    'READ_WRITE',
+    'EDIT_ONLY',
+    'COMPLETE_ONLY',
+];
 /**
  * Available workspace roles.
  */

package/dist/esm/types/errors.js

@@ -1,7 +1,6 @@
 import { CustomError } from 'ts-custom-error';
 const authenticationErrorCodes = [401, 403];
 export class TodoistRequestError extends CustomError {
-    // eslint-disable-next-line max-params
     constructor(message, httpStatusCode, responseData) {
         super(message);
         this.message = message;
@@ -16,3 +15,10 @@ export class TodoistRequestError extends CustomError {
         Object.defineProperty(this, 'name', { value: 'TodoistRequestError' });
     }
 }
+export class TodoistArgumentError extends CustomError {
+    constructor(message) {
+        super(message);
+        this.message = message;
+        Object.defineProperty(this, 'name', { value: 'TodoistArgumentError' });
+    }
+}

package/dist/esm/types/http.js

@@ -2,12 +2,14 @@
  * Type guard to check if an error is a network error
  */
 export function isNetworkError(error) {
-    // Network errors in fetch are typically TypeError with specific messages
+    // Network errors in fetch are typically TypeError with specific messages.
+    // Timeout errors are created by fetch-with-retry with the TimeoutError name.
     return ((error instanceof TypeError &&
         (error.message.includes('fetch') ||
             error.message.includes('network') ||
             error.message.includes('Failed to fetch') ||
             error.message.includes('NetworkError'))) ||
+        error.name === 'TimeoutError' ||
         error.isNetworkError === true);
 }
 /**

package/dist/esm/types/requests.js

@@ -1 +1,2 @@
-export {};
+/** Available reminder delivery services. */
+export const REMINDER_DELIVERY_SERVICES = ['email', 'push'];

package/dist/esm/types/sync/commands/labels.js

@@ -1 +1,2 @@
-export {};
+/** Available label delete cascade modes. */
+export const LABEL_DELETE_CASCADE_MODES = ['none', 'all'];

package/dist/esm/types/sync/commands/shared.js

@@ -1,4 +1,16 @@
 /**
  * Shared types used across multiple Sync API command argument types.
  */
-export {};
+/** Available project workflow statuses. */
+export const PROJECT_STATUSES = [
+    'PLANNED',
+    'IN_PROGRESS',
+    'PAUSED',
+    'COMPLETED',
+    'CANCELED',
+];
+export { COLLABORATOR_ROLES } from '../../entities.js';
+/** Available reminder notification services. */
+export const REMINDER_SERVICES = ['default', 'email', 'mobile', 'push', 'no_default'];
+/** Available workspace project sort orders. */
+export const WORKSPACE_PROJECT_SORT_ORDERS = ['MANUAL', 'A_TO_Z', 'Z_TO_A'];

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

@@ -20,11 +20,13 @@ export const LocationReminderSchema = ReminderBaseSchema.extend({
 export const AbsoluteReminderSchema = ReminderBaseSchema.extend({
     type: z.literal('absolute'),
     due: DueDateSchema,
+    isUrgent: z.boolean().optional(),
 }).passthrough();
 export const RelativeReminderSchema = ReminderBaseSchema.extend({
     type: z.literal('relative'),
     minuteOffset: z.number().int(),
     due: DueDateSchema.optional(),
+    isUrgent: z.boolean().optional(),
 }).passthrough();
 export const ReminderSchema = z.discriminatedUnion('type', [
     LocationReminderSchema,

package/dist/esm/types/sync/user-preferences.js

@@ -1,7 +1,27 @@
 import { z } from 'zod';
-const DATE_FORMAT_FROM_API = { 0: 'DD/MM/YYYY', 1: 'MM/DD/YYYY' };
-const TIME_FORMAT_FROM_API = { 0: '24h', 1: '12h' };
-const DAY_OF_WEEK_FROM_API = {
+/** Available date format options. */
+export const DATE_FORMATS = ['DD/MM/YYYY', 'MM/DD/YYYY'];
+/** Available time format options. */
+export const TIME_FORMATS = ['24h', '12h'];
+/** Available days of the week. */
+export const DAYS_OF_WEEK = [
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday',
+    'Sunday',
+];
+export const DATE_FORMAT_FROM_API = {
+    0: 'DD/MM/YYYY',
+    1: 'MM/DD/YYYY',
+};
+export const TIME_FORMAT_FROM_API = {
+    0: '24h',
+    1: '12h',
+};
+export const DAY_OF_WEEK_FROM_API = {
     1: 'Monday',
     2: 'Tuesday',
     3: 'Wednesday',

package/dist/esm/utils/multipart-upload.js

@@ -1,4 +1,4 @@
-import { fetchWithRetry } from './fetch-with-retry.js';
+import { fetchWithRetry } from '../transport/fetch-with-retry.js';
 /**
  * Helper function to determine content-type from filename extension.
  * @param fileName - The filename to analyze

package/dist/esm/utils/sanitization.js

@@ -14,7 +14,7 @@ function removeStyleFormatting(input) {
     if (!input.includes('!') && !input.includes('*') && !input.includes('_')) {
         return input;
     }
-    function removeMarkdown(match, prefix, text) {
+    function removeMarkdown(_match, prefix, text) {
         return `${prefix}${text}`;
     }
     input = input.replace(BOLD_ITALIC_FORMAT, removeMarkdown);
@@ -23,7 +23,7 @@ function removeStyleFormatting(input) {
     return input;
 }
 function removeCodeFormatting(input) {
-    function removeMarkdown(match, text) {
+    function removeMarkdown(_match, text) {
         return text;
     }
     input = input.replace(CODE_BLOCK_FORMAT, removeMarkdown);
@@ -43,7 +43,7 @@ function removeMarkdownLinks(input) {
     if (!input.includes('[') || !input.includes(']')) {
         return input;
     }
-    function removeMarkdown(match, text) {
+    function removeMarkdown(_match, text) {
         return text;
     }
     return input.replace(MARKDOWN_LINK, removeMarkdown);
@@ -52,20 +52,20 @@ function removeTodoistLinks(input) {
     if (!input.includes('(') || !input.includes(')')) {
         return input;
     }
-    function removeMarkdown(match, url, text) {
+    function removeMarkdown(_match, _url, text) {
         return text;
     }
     return input.replace(TODOIST_LINK, removeMarkdown);
 }
 function removeAppLinks(input) {
     if (input.includes('gmail')) {
-        input = input.replace(GMAIL_LINK, (match, id, text) => text);
+        input = input.replace(GMAIL_LINK, (_match, _id, text) => text);
     }
     if (input.includes('outlook')) {
-        input = input.replace(OUTLOOK_LINK, (match, id, text) => text);
+        input = input.replace(OUTLOOK_LINK, (_match, _id, text) => text);
     }
     if (input.includes('thunderbird')) {
-        input = input.replace(THUNDERBIRD_LINK, (match, text) => text);
+        input = input.replace(THUNDERBIRD_LINK, (_match, text) => text);
     }
     return input;
 }

package/dist/types/authentication.d.ts

@@ -6,11 +6,13 @@ export type AuthOptions = {
     baseUrl?: string;
     customFetch?: CustomFetch;
 };
+/** Available OAuth2 permission scopes. */
+export declare const PERMISSIONS: readonly ["task:add", "data:read", "data:read_write", "data:delete", "project:delete", "backups:read"];
 /**
- * Permission scopes that can be requested during OAuth2 authorization.
+ * Permission scope that can be requested during OAuth2 authorization.
  * @see {@link https://todoist.com/api/v1/docs#tag/Authorization}
  */
-export type Permission = 'task:add' | 'data:read' | 'data:read_write' | 'data:delete' | 'project:delete' | 'backups:read';
+export type Permission = (typeof PERMISSIONS)[number];
 /**
  * Parameters required to exchange an authorization code for an access token.
  * @see https://todoist.com/api/v1/docs#tag/Authorization/OAuth
@@ -69,7 +71,7 @@ export declare function getAuthStateParameter(): string;
  */
 export declare function getAuthorizationUrl({ clientId, permissions, state, baseUrl, }: {
     clientId: string;
-    permissions: Permission[];
+    permissions: readonly Permission[];
     state: string;
     baseUrl?: string;
 }): string;

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

@@ -16,6 +16,8 @@ export declare const ENDPOINT_REST_LABELS_SHARED: string;
 export declare const ENDPOINT_REST_LABELS_SHARED_RENAME: string;
 export declare const ENDPOINT_REST_LABELS_SHARED_REMOVE: string;
 export declare const ENDPOINT_REST_COMMENTS = "comments";
+export declare const ENDPOINT_REST_REMINDERS = "reminders";
+export declare const ENDPOINT_REST_LOCATION_REMINDERS = "location_reminders";
 export declare const ENDPOINT_REST_TASK_CLOSE = "close";
 export declare const ENDPOINT_REST_TASK_REOPEN = "reopen";
 export declare const ENDPOINT_REST_TASK_MOVE = "move";
@@ -29,6 +31,12 @@ export declare const ENDPOINT_REST_ACTIVITIES = "activities";
 export declare const ENDPOINT_REST_UPLOADS = "uploads";
 export declare const PROJECT_ARCHIVE = "archive";
 export declare const PROJECT_UNARCHIVE = "unarchive";
+export declare const ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT: string;
+export declare const ENDPOINT_REST_PROJECTS_PERMISSIONS: string;
+export declare const ENDPOINT_REST_PROJECT_FULL = "full";
+export declare const ENDPOINT_REST_PROJECT_JOIN = "join";
+export declare const SECTION_ARCHIVE = "archive";
+export declare const SECTION_UNARCHIVE = "unarchive";
 export declare const ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE: string;
 export declare const ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL: string;
 export declare const ENDPOINT_SYNC_QUICK_ADD: string;
@@ -36,6 +44,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_WORKSPACES = "workspaces";
 export declare const ENDPOINT_WORKSPACE_INVITATIONS = "workspaces/invitations";
 export declare const ENDPOINT_WORKSPACE_INVITATIONS_ALL = "workspaces/invitations/all";
 export declare const ENDPOINT_WORKSPACE_INVITATIONS_DELETE = "workspaces/invitations/delete";

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

@@ -1,4 +1,4 @@
-import { Label, Section, Task, User, Attachment, Duration, Deadline, RawComment, PersonalProject } from '../types/index.js';
+import { Label, Section, Task, User, Attachment, Duration, Deadline, RawComment, PersonalProject, Reminder } 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";
@@ -148,6 +148,10 @@ export declare const DEFAULT_COMMENT: {
     isDeleted: boolean;
     projectId?: string | undefined;
 };
+export declare const DEFAULT_REMINDER_ID = "6XGgmFQrx44wfGHr";
+export declare const DEFAULT_RELATIVE_REMINDER: Reminder;
+export declare const DEFAULT_ABSOLUTE_REMINDER: Reminder;
+export declare const DEFAULT_LOCATION_REMINDER: Reminder;
 export declare const INVALID_COMMENT: {
     isDeleted: string;
     id: string;

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

@@ -1,6 +1,7 @@
 import { Attachment, PersonalProject, WorkspaceProject, Label, Section, Comment, Task, CurrentUser, ProductivityStats, WorkspaceInvitation, WorkspacePlanDetails, JoinWorkspaceResult, Workspace } from './types/entities.js';
-import { AddCommentArgs, AddLabelArgs, AddProjectArgs, AddSectionArgs, AddTaskArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetTasksArgs, GetTasksByFilterArgs, UpdateCommentArgs, UpdateLabelArgs, UpdateProjectArgs, UpdateSectionArgs, UpdateTaskArgs, QuickAddTaskArgs, GetSharedLabelsArgs, RenameSharedLabelArgs, RemoveSharedLabelArgs, GetProjectsArgs, SearchProjectsArgs, GetProjectCollaboratorsArgs, GetLabelsArgs, SearchLabelsArgs, GetLabelsResponse, GetTasksResponse, GetProjectsResponse, GetProjectCollaboratorsResponse, GetSectionsArgs, SearchSectionsArgs, GetSectionsResponse, GetSharedLabelsResponse, GetCommentsResponse, type MoveTaskArgs, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, GetArchivedProjectsArgs, GetArchivedProjectsResponse, SearchCompletedTasksArgs, GetActivityLogsArgs, GetActivityLogsResponse, UploadFileArgs, DeleteUploadArgs, GetWorkspaceInvitationsArgs, DeleteWorkspaceInvitationArgs, WorkspaceInvitationActionArgs, JoinWorkspaceArgs, WorkspaceLogoArgs, GetWorkspacePlanDetailsArgs, GetWorkspaceUsersArgs, GetWorkspaceUsersResponse, GetWorkspaceProjectsArgs, WorkspaceInvitationsResponse, AllWorkspaceInvitationsResponse, WorkspaceLogoResponse, MoveProjectToWorkspaceArgs, MoveProjectToPersonalArgs } from './types/requests.js';
+import { AddCommentArgs, AddLabelArgs, AddLocationReminderArgs, AddProjectArgs, AddReminderArgs, AddSectionArgs, AddTaskArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetTasksArgs, GetTasksByFilterArgs, UpdateCommentArgs, UpdateLabelArgs, UpdateLocationReminderArgs, UpdateProjectArgs, UpdateReminderArgs, UpdateSectionArgs, UpdateTaskArgs, QuickAddTaskArgs, GetSharedLabelsArgs, RenameSharedLabelArgs, RemoveSharedLabelArgs, GetProjectsArgs, SearchProjectsArgs, GetProjectCollaboratorsArgs, GetLabelsArgs, SearchLabelsArgs, GetLabelsResponse, GetTasksResponse, GetProjectsResponse, GetProjectCollaboratorsResponse, GetSectionsArgs, SearchSectionsArgs, GetSectionsResponse, GetSharedLabelsResponse, GetCommentsResponse, type MoveTaskArgs, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, GetArchivedProjectsArgs, GetArchivedProjectsResponse, SearchCompletedTasksArgs, GetActivityLogsArgs, GetActivityLogsResponse, UploadFileArgs, DeleteUploadArgs, GetWorkspaceInvitationsArgs, DeleteWorkspaceInvitationArgs, WorkspaceInvitationActionArgs, JoinWorkspaceArgs, WorkspaceLogoArgs, GetWorkspacePlanDetailsArgs, GetWorkspaceUsersArgs, GetWorkspaceUsersResponse, GetWorkspaceProjectsArgs, WorkspaceInvitationsResponse, AllWorkspaceInvitationsResponse, WorkspaceLogoResponse, MoveProjectToWorkspaceArgs, MoveProjectToPersonalArgs, GetArchivedProjectsCountArgs, GetArchivedProjectsCountResponse, GetProjectPermissionsResponse, GetFullProjectArgs, GetFullProjectResponse, AddWorkspaceArgs, UpdateWorkspaceArgs } from './types/requests.js';
 import { CustomFetch, CustomFetchResponse } from './types/http.js';
+import type { Reminder } from './types/index.js';
 import { type SyncResponse, type SyncRequest } from './types/sync/index.js';
 /**
  * Response from viewAttachment, extending CustomFetchResponse with
@@ -270,6 +271,35 @@ export declare class TodoistApi {
      * @returns A promise that resolves to the moved project.
      */
     moveProjectToPersonal(args: MoveProjectToPersonalArgs, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
+    /**
+     * Counts the number of archived projects.
+     *
+     * @param args - Optional parameters to filter the count.
+     * @returns A promise that resolves to the count of archived projects.
+     */
+    getArchivedProjectsCount(args?: GetArchivedProjectsCountArgs): Promise<GetArchivedProjectsCountResponse>;
+    /**
+     * Retrieves the role-to-action permission mappings for projects.
+     *
+     * @returns A promise that resolves to the permission mappings.
+     */
+    getProjectPermissions(): Promise<GetProjectPermissionsResponse>;
+    /**
+     * Retrieves full project data including tasks, sections, collaborators, and notes.
+     *
+     * @param id - The unique identifier of the project.
+     * @param args - Optional parameters.
+     * @returns A promise that resolves to the full project data.
+     */
+    getFullProject(id: string, args?: GetFullProjectArgs): Promise<GetFullProjectResponse>;
+    /**
+     * Joins a shared project by its ID.
+     *
+     * @param id - The unique identifier of the project to join.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the joined project.
+     */
+    joinProject(id: string, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
     /**
      * Retrieves a list of collaborators for a specific project.
      *
@@ -325,6 +355,22 @@ export declare class TodoistApi {
      * @returns A promise that resolves to `true` if successful.
      */
     deleteSection(id: string, requestId?: string): Promise<boolean>;
+    /**
+     * Archives a section by its ID.
+     *
+     * @param id - The unique identifier of the section to archive.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated section.
+     */
+    archiveSection(id: string, requestId?: string): Promise<Section>;
+    /**
+     * Unarchives a section by its ID.
+     *
+     * @param id - The unique identifier of the section to unarchive.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated section.
+     */
+    unarchiveSection(id: string, requestId?: string): Promise<Section>;
     /**
      * Retrieves a label by its ID.
      *
@@ -431,6 +477,70 @@ export declare class TodoistApi {
      * @returns A promise that resolves to `true` if successful.
      */
     deleteComment(id: string, requestId?: string): Promise<boolean>;
+    /**
+     * Retrieves a time-based reminder by its ID.
+     *
+     * @param id - The unique identifier of the reminder to retrieve.
+     * @returns A promise that resolves to the requested reminder.
+     */
+    getReminder(id: string): Promise<Reminder>;
+    /**
+     * Retrieves a location reminder by its ID.
+     *
+     * @param id - The unique identifier of the location reminder to retrieve.
+     * @returns A promise that resolves to the requested reminder.
+     */
+    getLocationReminder(id: string): Promise<Reminder>;
+    /**
+     * Creates a time-based reminder for a task.
+     *
+     * @param args - Reminder creation parameters for relative or absolute reminders.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created reminder.
+     */
+    addReminder(args: AddReminderArgs, requestId?: string): Promise<Reminder>;
+    /**
+     * Creates a location reminder for a task.
+     *
+     * @param args - Location reminder creation parameters.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created reminder.
+     */
+    addLocationReminder(args: AddLocationReminderArgs, requestId?: string): Promise<Reminder>;
+    /**
+     * Updates an existing time-based reminder.
+     *
+     * @param id - The unique identifier of the reminder to update.
+     * @param args - Reminder update parameters.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated reminder.
+     */
+    updateReminder(id: string, args: UpdateReminderArgs, requestId?: string): Promise<Reminder>;
+    /**
+     * Updates an existing location reminder.
+     *
+     * @param id - The unique identifier of the location reminder to update.
+     * @param args - Location reminder update parameters.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated reminder.
+     */
+    updateLocationReminder(id: string, args: UpdateLocationReminderArgs, requestId?: string): Promise<Reminder>;
+    /**
+     * Deletes a time-based reminder by its ID.
+     *
+     * @param id - The unique identifier of the reminder to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    deleteReminder(id: string, requestId?: string): Promise<boolean>;
+    /**
+     * Deletes a location reminder by its ID.
+     *
+     * @param id - The unique identifier of the location reminder to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    deleteLocationReminder(id: string, requestId?: string): Promise<boolean>;
     /**
      * Retrieves productivity stats for the authenticated user.
      *
@@ -598,8 +708,6 @@ export declare class TodoistApi {
     /**
      * Retrieves all workspaces for the authenticated user.
      *
-     * Uses the Sync API internally to fetch workspace data.
-     *
      * @param requestId - Optional custom identifier for the request.
      * @returns A promise that resolves to an array of workspaces.
      *
@@ -612,6 +720,39 @@ export declare class TodoistApi {
      * ```
      */
     getWorkspaces(requestId?: string): Promise<Workspace[]>;
+    /**
+     * Retrieves a workspace by its ID.
+     *
+     * @param id - The unique identifier of the workspace.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the requested workspace.
+     */
+    getWorkspace(id: string, requestId?: string): Promise<Workspace>;
+    /**
+     * Creates a new workspace.
+     *
+     * @param args - The arguments for creating the workspace.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created workspace.
+     */
+    addWorkspace(args: AddWorkspaceArgs, requestId?: string): Promise<Workspace>;
+    /**
+     * Updates an existing workspace.
+     *
+     * @param id - The unique identifier of the workspace to update.
+     * @param args - The arguments for updating the workspace.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated workspace.
+     */
+    updateWorkspace(id: string, args: UpdateWorkspaceArgs, requestId?: string): Promise<Workspace>;
+    /**
+     * Deletes a workspace by its ID.
+     *
+     * @param id - The unique identifier of the workspace to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    deleteWorkspace(id: string, requestId?: string): Promise<boolean>;
     /**
      * Gets active projects in a workspace with pagination.
      *

package/dist/types/{utils → transport}/fetch-with-retry.d.ts

@@ -1,4 +1,4 @@
-import type { HttpResponse, RetryConfig, CustomFetch } from '../types/http.js';
+import type { CustomFetch, HttpResponse, RetryConfig } from '../types/http.js';
 /**
  * Performs a fetch request with retry logic and timeout support
  */

package/dist/types/{rest-client.d.ts → transport/http-client.d.ts}

@@ -1,4 +1,4 @@
-import { HttpMethod, HttpResponse, CustomFetch } from './types/http.js';
+import type { CustomFetch, HttpMethod, HttpResponse } from '../types/http.js';
 type RequestArgs = {
     httpMethod: HttpMethod;
     baseUri: string;

package/dist/types/transport/http-dispatcher.d.ts

@@ -0,0 +1,3 @@
+import type { Dispatcher } from 'undici';
+export declare function getDefaultDispatcher(): Promise<Dispatcher | undefined>;
+export declare function resetDefaultDispatcherForTests(): Promise<void>;