@doist/todoist-sdk 9.0.0 → 9.1.0

package/dist/types/clients/insights-client.d.ts

@@ -0,0 +1,18 @@
+import type { GetProjectActivityStatsArgs, GetWorkspaceInsightsArgs, ProjectActivityStats, ProjectHealth, ProjectHealthContext, ProjectProgress, WorkspaceInsights } from '../types/insights/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all insights-domain endpoints
+ * (project activity stats, health, progress, workspace insights).
+ *
+ * Instantiated by `TodoistApi`; every public insights method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing
+ * JSDoc.
+ */
+export declare class InsightsClient extends BaseClient {
+    getProjectActivityStats(projectId: string, args?: GetProjectActivityStatsArgs): Promise<ProjectActivityStats>;
+    getProjectHealth(projectId: string): Promise<ProjectHealth>;
+    getProjectHealthContext(projectId: string): Promise<ProjectHealthContext>;
+    getProjectProgress(projectId: string): Promise<ProjectProgress>;
+    getWorkspaceInsights(workspaceId: string, args?: GetWorkspaceInsightsArgs): Promise<WorkspaceInsights>;
+    analyzeProjectHealth(projectId: string, requestId?: string): Promise<ProjectHealth>;
+}

package/dist/types/clients/label-client.d.ts

@@ -0,0 +1,19 @@
+import type { AddLabelArgs, GetLabelsArgs, GetLabelsResponse, GetSharedLabelsArgs, GetSharedLabelsResponse, Label, RemoveSharedLabelArgs, RenameSharedLabelArgs, SearchLabelsArgs, UpdateLabelArgs } from '../types/labels/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all label-domain endpoints.
+ *
+ * Instantiated by `TodoistApi`; every public label method on `TodoistApi`
+ * delegates here. See `todoist-api.ts` for the user-facing JSDoc.
+ */
+export declare class LabelClient extends BaseClient {
+    getLabel(id: string): Promise<Label>;
+    getLabels(args?: GetLabelsArgs): Promise<GetLabelsResponse>;
+    searchLabels(args: SearchLabelsArgs): Promise<GetLabelsResponse>;
+    addLabel(args: AddLabelArgs, requestId?: string): Promise<Label>;
+    updateLabel(id: string, args: UpdateLabelArgs, requestId?: string): Promise<Label>;
+    deleteLabel(id: string, requestId?: string): Promise<boolean>;
+    getSharedLabels(args?: GetSharedLabelsArgs): Promise<GetSharedLabelsResponse>;
+    renameSharedLabel(args: RenameSharedLabelArgs): Promise<boolean>;
+    removeSharedLabel(args: RemoveSharedLabelArgs): Promise<boolean>;
+}

package/dist/types/clients/productivity-client.d.ts

@@ -0,0 +1,12 @@
+import type { ProductivityStats } from '../types/productivity/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling the productivity-stats endpoint.
+ *
+ * Instantiated by `TodoistApi`; the public `getProductivityStats` method
+ * on `TodoistApi` delegates here. See `todoist-api.ts` for user-facing
+ * JSDoc.
+ */
+export declare class ProductivityClient extends BaseClient {
+    getProductivityStats(): Promise<ProductivityStats>;
+}

package/dist/types/clients/project-client.d.ts

@@ -0,0 +1,26 @@
+import type { AddProjectArgs, GetArchivedProjectsArgs, GetArchivedProjectsCountArgs, GetArchivedProjectsCountResponse, GetArchivedProjectsResponse, GetFullProjectArgs, GetFullProjectResponse, GetProjectCollaboratorsArgs, GetProjectCollaboratorsResponse, GetProjectPermissionsResponse, GetProjectsArgs, GetProjectsResponse, JoinProjectResponse, MoveProjectToPersonalArgs, MoveProjectToWorkspaceArgs, PersonalProject, SearchProjectsArgs, UpdateProjectArgs, WorkspaceProject } from '../types/projects/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all project-domain endpoints.
+ *
+ * Instantiated by `TodoistApi`; every public project method on `TodoistApi`
+ * delegates here. See `todoist-api.ts` for the user-facing JSDoc.
+ */
+export declare class ProjectClient extends BaseClient {
+    getProject(id: string): Promise<PersonalProject | WorkspaceProject>;
+    getProjects(args?: GetProjectsArgs): Promise<GetProjectsResponse>;
+    searchProjects(args: SearchProjectsArgs): Promise<GetProjectsResponse>;
+    getArchivedProjects(args?: GetArchivedProjectsArgs): Promise<GetArchivedProjectsResponse>;
+    addProject(args: AddProjectArgs, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
+    updateProject(id: string, args: UpdateProjectArgs, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
+    deleteProject(id: string, requestId?: string): Promise<boolean>;
+    archiveProject(id: string, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
+    unarchiveProject(id: string, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
+    moveProjectToWorkspace(args: MoveProjectToWorkspaceArgs, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
+    moveProjectToPersonal(args: MoveProjectToPersonalArgs, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
+    getArchivedProjectsCount(args?: GetArchivedProjectsCountArgs): Promise<GetArchivedProjectsCountResponse>;
+    getProjectPermissions(): Promise<GetProjectPermissionsResponse>;
+    getFullProject(id: string, args?: GetFullProjectArgs): Promise<GetFullProjectResponse>;
+    joinProject(id: string, requestId?: string): Promise<JoinProjectResponse>;
+    getProjectCollaborators(projectId: string, args?: GetProjectCollaboratorsArgs): Promise<GetProjectCollaboratorsResponse>;
+}

package/dist/types/clients/reminder-client.d.ts

@@ -0,0 +1,25 @@
+import type { Reminder } from '../types/index.js';
+import type { AddLocationReminderArgs, AddReminderArgs, GetLocationRemindersArgs, GetLocationRemindersResponse, GetRemindersArgs, GetRemindersResponse, UpdateLocationReminderArgs, UpdateReminderArgs } from '../types/reminders/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all reminder-domain endpoints
+ * (both time-based and location-based reminders).
+ *
+ * Instantiated by `TodoistApi`; every public reminder method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing
+ * JSDoc. The time-vs-location 404 translation is preserved here so a
+ * caller who used the wrong endpoint gets a TodoistArgumentError
+ * pointing at the correct method, rather than a bare 404.
+ */
+export declare class ReminderClient extends BaseClient {
+    getReminders(args?: GetRemindersArgs): Promise<GetRemindersResponse>;
+    getLocationReminders(args?: GetLocationRemindersArgs): Promise<GetLocationRemindersResponse>;
+    getReminder(id: string): Promise<Reminder>;
+    getLocationReminder(id: string): Promise<Reminder>;
+    addReminder(args: AddReminderArgs, requestId?: string): Promise<Reminder>;
+    addLocationReminder(args: AddLocationReminderArgs, requestId?: string): Promise<Reminder>;
+    updateReminder(id: string, args: UpdateReminderArgs, requestId?: string): Promise<Reminder>;
+    updateLocationReminder(id: string, args: UpdateLocationReminderArgs, requestId?: string): Promise<Reminder>;
+    deleteReminder(id: string, requestId?: string): Promise<boolean>;
+    deleteLocationReminder(id: string, requestId?: string): Promise<boolean>;
+}

package/dist/types/clients/section-client.d.ts

@@ -0,0 +1,18 @@
+import type { AddSectionArgs, GetSectionsArgs, GetSectionsResponse, SearchSectionsArgs, Section, UpdateSectionArgs } from '../types/sections/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all section-domain endpoints.
+ *
+ * Instantiated by `TodoistApi`; every public section method on `TodoistApi`
+ * delegates here. See `todoist-api.ts` for the user-facing JSDoc.
+ */
+export declare class SectionClient extends BaseClient {
+    getSections(args?: GetSectionsArgs): Promise<GetSectionsResponse>;
+    searchSections(args: SearchSectionsArgs): Promise<GetSectionsResponse>;
+    getSection(id: string): Promise<Section>;
+    addSection(args: AddSectionArgs, requestId?: string): Promise<Section>;
+    updateSection(id: string, args: UpdateSectionArgs, requestId?: string): Promise<Section>;
+    deleteSection(id: string, requestId?: string): Promise<boolean>;
+    archiveSection(id: string, requestId?: string): Promise<Section>;
+    unarchiveSection(id: string, requestId?: string): Promise<Section>;
+}

package/dist/types/clients/task-client.d.ts

@@ -0,0 +1,25 @@
+import type { AddTaskArgs, GetAllCompletedTasksArgs, GetAllCompletedTasksResponse, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, GetTasksArgs, GetTasksByFilterArgs, GetTasksResponse, MoveTaskArgs, QuickAddTaskArgs, SearchCompletedTasksArgs, Task, UpdateTaskArgs } from '../types/tasks/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all task-domain endpoints.
+ *
+ * Instantiated by `TodoistApi`; every public task method on `TodoistApi`
+ * delegates here. See `todoist-api.ts` for the user-facing JSDoc.
+ */
+export declare class TaskClient extends BaseClient {
+    getTask(id: string): Promise<Task>;
+    getTasks(args?: GetTasksArgs): Promise<GetTasksResponse>;
+    getTasksByFilter(args: GetTasksByFilterArgs): Promise<GetTasksResponse>;
+    getCompletedTasksByCompletionDate(args: GetCompletedTasksByCompletionDateArgs): Promise<GetCompletedTasksResponse>;
+    getCompletedTasksByDueDate(args: GetCompletedTasksByDueDateArgs): Promise<GetCompletedTasksResponse>;
+    searchCompletedTasks(args: SearchCompletedTasksArgs): Promise<GetCompletedTasksResponse>;
+    getAllCompletedTasks(args?: GetAllCompletedTasksArgs): Promise<GetAllCompletedTasksResponse>;
+    addTask(args: AddTaskArgs, requestId?: string): Promise<Task>;
+    quickAddTask(args: QuickAddTaskArgs): Promise<Task>;
+    updateTask(id: string, args: UpdateTaskArgs, requestId?: string): Promise<Task>;
+    moveTasks(ids: string[], args: MoveTaskArgs, requestId?: string): Promise<Task[]>;
+    moveTask(id: string, args: MoveTaskArgs, requestId?: string): Promise<Task>;
+    closeTask(id: string, requestId?: string): Promise<boolean>;
+    reopenTask(id: string, requestId?: string): Promise<boolean>;
+    deleteTask(id: string, requestId?: string): Promise<boolean>;
+}

package/dist/types/clients/template-client.d.ts

@@ -0,0 +1,17 @@
+import type { CreateProjectFromTemplateArgs, CreateProjectFromTemplateResponse, ExportTemplateFileArgs, ExportTemplateUrlArgs, ExportTemplateUrlResponse, ImportTemplateFromIdArgs, ImportTemplateIntoProjectArgs, ImportTemplateResponse } from '../types/templates/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all template-domain endpoints.
+ *
+ * Instantiated by `TodoistApi`; every public template method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing
+ * JSDoc.
+ */
+export declare class TemplateClient extends BaseClient {
+    exportTemplateAsFile(args: ExportTemplateFileArgs): Promise<string>;
+    exportTemplateAsUrl(args: ExportTemplateUrlArgs): Promise<ExportTemplateUrlResponse>;
+    createProjectFromTemplate(args: CreateProjectFromTemplateArgs, requestId?: string): Promise<CreateProjectFromTemplateResponse>;
+    importTemplateIntoProject(args: ImportTemplateIntoProjectArgs, requestId?: string): Promise<ImportTemplateResponse>;
+    importTemplateFromId(args: ImportTemplateFromIdArgs, requestId?: string): Promise<ImportTemplateResponse>;
+    private validateTemplateResponse;
+}

package/dist/types/clients/ui-extension-client.d.ts

@@ -0,0 +1,18 @@
+import type { AddUiExtensionArgs, UiExtension, UpdateUiExtensionArgs, UploadUiExtensionIconArgs } from '../types/ui-extensions/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all UI-extension endpoints for developer
+ * applications. All endpoints require the `dev:app_console` OAuth scope.
+ *
+ * Instantiated by `TodoistApi`; every public UI-extension method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing JSDoc.
+ */
+export declare class UiExtensionClient extends BaseClient {
+    getUiExtension(uiExtensionId: string, requestId?: string): Promise<UiExtension>;
+    getInstalledUiExtensions(requestId?: string): Promise<UiExtension[]>;
+    getUiExtensionsForApp(appId: string, requestId?: string): Promise<UiExtension[]>;
+    addUiExtension(args: AddUiExtensionArgs, requestId?: string): Promise<UiExtension>;
+    updateUiExtension(uiExtensionId: string, args: UpdateUiExtensionArgs, requestId?: string): Promise<UiExtension>;
+    deleteUiExtension(uiExtensionId: string, requestId?: string): Promise<boolean>;
+    uploadUiExtensionIcon(args: UploadUiExtensionIconArgs, requestId?: string): Promise<UiExtension>;
+}

package/dist/types/clients/upload-client.d.ts

@@ -0,0 +1,17 @@
+import type { Attachment, Comment } from '../types/comments/index.js';
+import type { FileResponse } from '../types/http.js';
+import type { DeleteUploadArgs, UploadFileArgs } from '../types/uploads/index.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling upload + attachment endpoints
+ * (file upload, upload delete, attachment view).
+ *
+ * Instantiated by `TodoistApi`; every public upload method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing
+ * JSDoc.
+ */
+export declare class UploadClient extends BaseClient {
+    uploadFile(args: UploadFileArgs, requestId?: string): Promise<Attachment>;
+    deleteUpload(args: DeleteUploadArgs, requestId?: string): Promise<boolean>;
+    viewAttachment(commentOrUrl: Comment | string): Promise<FileResponse>;
+}

package/dist/types/clients/workspace-client.d.ts

@@ -0,0 +1,43 @@
+import type { GetProjectsResponse } from '../types/projects/index.js';
+import type { AddWorkspaceArgs, AllWorkspaceInvitationsResponse, DeleteWorkspaceInvitationArgs, GetWorkspaceMembersActivityArgs, GetWorkspaceMembersActivityResponse, GetWorkspaceProjectsArgs, GetWorkspaceUserTasksArgs, GetWorkspaceUserTasksResponse, GetWorkspaceUsersArgs, GetWorkspaceUsersResponse, InviteWorkspaceUsersArgs, InviteWorkspaceUsersResponse, JoinWorkspaceArgs, JoinWorkspaceResult, RemoveWorkspaceUserArgs, UpdateWorkspaceArgs, UpdateWorkspaceUserArgs, Workspace, WorkspaceInvitation, WorkspaceInvitationActionArgs, WorkspaceInvitationsResponse, WorkspaceLogoArgs, WorkspaceLogoResponse, WorkspacePlanDetails } from '../types/workspaces/index.js';
+import { BaseClient } from './base-client.js';
+type GetAllWorkspaceInvitationsArgs = {
+    workspaceId?: string;
+};
+/**
+ * Internal sub-client handling all workspace-domain endpoints —
+ * workspaces, invitations, users, plans, logos, and workspace project
+ * pagination.
+ *
+ * Instantiated by `TodoistApi`; every public workspace method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing
+ * JSDoc.
+ */
+export declare class WorkspaceClient extends BaseClient {
+    getWorkspaceInvitations(args: {
+        workspaceId: string;
+    }, requestId?: string): Promise<WorkspaceInvitationsResponse>;
+    getAllWorkspaceInvitations(args?: GetAllWorkspaceInvitationsArgs, requestId?: string): Promise<AllWorkspaceInvitationsResponse>;
+    deleteWorkspaceInvitation(args: DeleteWorkspaceInvitationArgs, requestId?: string): Promise<WorkspaceInvitation>;
+    acceptWorkspaceInvitation(args: WorkspaceInvitationActionArgs, requestId?: string): Promise<WorkspaceInvitation>;
+    rejectWorkspaceInvitation(args: WorkspaceInvitationActionArgs, requestId?: string): Promise<WorkspaceInvitation>;
+    joinWorkspace(args: JoinWorkspaceArgs, requestId?: string): Promise<JoinWorkspaceResult>;
+    uploadWorkspaceLogo(args: WorkspaceLogoArgs, requestId?: string): Promise<WorkspaceLogoResponse>;
+    getWorkspacePlanDetails(args: {
+        workspaceId: string;
+    }, requestId?: string): Promise<WorkspacePlanDetails>;
+    getWorkspaceUsers(args?: GetWorkspaceUsersArgs, requestId?: string): Promise<GetWorkspaceUsersResponse>;
+    getWorkspaces(requestId?: string): Promise<Workspace[]>;
+    getWorkspace(id: string, requestId?: string): Promise<Workspace>;
+    addWorkspace(args: AddWorkspaceArgs, requestId?: string): Promise<Workspace>;
+    updateWorkspace(id: string, args: UpdateWorkspaceArgs, requestId?: string): Promise<Workspace>;
+    deleteWorkspace(id: string, requestId?: string): Promise<boolean>;
+    getWorkspaceMembersActivity(args: GetWorkspaceMembersActivityArgs, requestId?: string): Promise<GetWorkspaceMembersActivityResponse>;
+    getWorkspaceUserTasks(args: GetWorkspaceUserTasksArgs, requestId?: string): Promise<GetWorkspaceUserTasksResponse>;
+    inviteWorkspaceUsers(args: InviteWorkspaceUsersArgs, requestId?: string): Promise<InviteWorkspaceUsersResponse>;
+    updateWorkspaceUser(args: UpdateWorkspaceUserArgs, requestId?: string): Promise<JoinWorkspaceResult>;
+    removeWorkspaceUser(args: RemoveWorkspaceUserArgs, requestId?: string): Promise<boolean>;
+    getWorkspaceActiveProjects(args: GetWorkspaceProjectsArgs, requestId?: string): Promise<GetProjectsResponse>;
+    getWorkspaceArchivedProjects(args: GetWorkspaceProjectsArgs, requestId?: string): Promise<GetProjectsResponse>;
+}
+export {};

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

@@ -80,3 +80,27 @@ export declare function getWorkspaceInviteUsersEndpoint(workspaceId: string): st
 export declare function getWorkspaceUserEndpoint(workspaceId: string, userId: string): string;
 export declare function getWorkspaceActiveProjectsEndpoint(workspaceId: string): string;
 export declare function getWorkspaceArchivedProjectsEndpoint(workspaceId: string): string;
+export declare const ENDPOINT_REST_APPS = "apps";
+export declare const ENDPOINT_REST_APPS_INSTALLATIONS = "apps/installations";
+export declare const ENDPOINT_REST_APPS_UI_EXTENSIONS = "apps/ui_extensions";
+export declare const ENDPOINT_REST_APPS_UI_EXTENSIONS_INSTALLED = "apps/ui_extensions/installed";
+export declare const ENDPOINT_REST_USER_AUTHORIZATIONS = "user/authorizations";
+export declare const ENDPOINT_REST_USER_AUTHORIZATIONS_DELETE = "user/authorizations/delete";
+/** Available app icon sizes (small 60x60, medium 300x300, large 600x600). */
+export declare const APP_ICON_SIZES: readonly ["small", "medium", "large"];
+/** Size of an app icon. */
+export type AppIconSize = (typeof APP_ICON_SIZES)[number];
+export declare function getAppEndpoint(appId: string): string;
+export declare function getAppSecretsEndpoint(appId: string): string;
+export declare function getAppClientSecretEndpoint(appId: string): string;
+export declare function getAppTokensEndpoint(appId: string): string;
+export declare function getAppTestTokenEndpoint(appId: string): string;
+export declare function getAppDistributionTokenEndpoint(appId: string): string;
+export declare function getAppVerificationTokenEndpoint(appId: string): string;
+export declare function getAppWebhookEndpoint(appId: string): string;
+export declare function getAppIconEndpoint(appId: string, size: AppIconSize): string;
+export declare function getAppInstallationEndpoint(installationId: string): string;
+export declare function getAppByDistributionTokenEndpoint(distributionToken: string): string;
+export declare function getUiExtensionEndpoint(uiExtensionId: string): string;
+export declare function getUiExtensionIconEndpoint(uiExtensionId: string): string;
+export declare function getUiExtensionsByIntegrationEndpoint(integrationId: string): string;

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

@@ -1,4 +1,4 @@
-import { Label, Section, Task, User, Attachment, Duration, Deadline, RawComment, PersonalProject, WorkspaceProject, Reminder, Folder } from '../types/index.js';
+import { Label, Section, Task, User, Attachment, Duration, Deadline, RawComment, PersonalProject, WorkspaceProject, Reminder, Folder, App, AppWithUserCount, AppSecrets, AppVerificationToken, AppTestToken, AppDistributionToken, AppWebhook, AppInstallation, UserAuthorization, UiExtension } from '../types/index.js';
 import type { Collaborator, CollaboratorState } from '../types/sync/resources/collaborators.js';
 import type { Note } from '../types/sync/resources/notes.js';
 export declare const DEFAULT_TASK_ID = "1234";
@@ -264,4 +264,19 @@ export declare const COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT: {
 export declare const DEFAULT_FOLDER: Folder;
 export declare const DEFAULT_COLLABORATOR: Collaborator;
 export declare const DEFAULT_COLLABORATOR_STATE: CollaboratorState;
+export declare const DEFAULT_APP_ID = "42";
+export declare const DEFAULT_INSTALLATION_ID = "1001";
+export declare const DEFAULT_UI_EXTENSION_ID = "2002";
+export declare const DEFAULT_DISTRIBUTION_TOKEN = "dist-token-abc";
+export declare const DEFAULT_ACCESS_TOKEN_ID = "3003";
+export declare const DEFAULT_APP: App;
+export declare const DEFAULT_APP_WITH_USER_COUNT: AppWithUserCount;
+export declare const DEFAULT_APP_SECRETS: AppSecrets;
+export declare const DEFAULT_APP_VERIFICATION_TOKEN: AppVerificationToken;
+export declare const DEFAULT_APP_TEST_TOKEN: AppTestToken;
+export declare const DEFAULT_APP_DISTRIBUTION_TOKEN: AppDistributionToken;
+export declare const DEFAULT_APP_WEBHOOK: AppWebhook;
+export declare const DEFAULT_APP_INSTALLATION: AppInstallation;
+export declare const DEFAULT_USER_AUTHORIZATION: UserAuthorization;
+export declare const DEFAULT_UI_EXTENSION: UiExtension;
 export declare const DEFAULT_NOTE: Note;

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

@@ -1,10 +1,11 @@
 import type { Reminder } from './types/index.js';
 import { GetActivityLogsArgs, GetActivityLogsResponse } from './types/activity/index.js';
+import type { AddAppArgs, App, AppByDistributionToken, AppDistributionToken, AppInstallation, AppSecrets, AppTestToken, AppVerificationToken, AppWebhook, AppWithUserCount, InstallAppArgs, RevokeUserAuthorizationArgs, UpdateAppArgs, UpdateAppInstallationArgs, UpdateAppWebhookArgs, UploadAppIconArgs, UserAuthorization } from './types/apps/index.js';
 import { Backup, GetBackupsArgs, DownloadBackupArgs } from './types/backups/index.js';
 import { Attachment, Comment, AddCommentArgs, UpdateCommentArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetCommentsResponse } from './types/comments/index.js';
 import { GetOrCreateEmailArgs, GetOrCreateEmailResponse, DisableEmailArgs } from './types/emails/index.js';
 import { GetFoldersArgs, GetFoldersResponse, AddFolderArgs, UpdateFolderArgs } from './types/folders/index.js';
-import { CustomFetch, CustomFetchResponse } from './types/http.js';
+import { CustomFetch, FileResponse } from './types/http.js';
 import { IdMapping, MovedId, GetIdMappingsArgs, GetMovedIdsArgs } from './types/id-mappings/index.js';
 import { ProjectActivityStats, ProjectHealth, ProjectHealthContext, ProjectProgress, WorkspaceInsights, GetProjectActivityStatsArgs, GetWorkspaceInsightsArgs } from './types/insights/index.js';
 import { Label, AddLabelArgs, UpdateLabelArgs, GetLabelsArgs, SearchLabelsArgs, GetLabelsResponse, GetSharedLabelsArgs, GetSharedLabelsResponse, RenameSharedLabelArgs, RemoveSharedLabelArgs } from './types/labels/index.js';
@@ -15,17 +16,32 @@ import { Section, AddSectionArgs, UpdateSectionArgs, GetSectionsArgs, SearchSect
 import type { Folder } from './types/sync/resources/folders.js';
 import { Task, AddTaskArgs, GetTasksArgs, GetTasksByFilterArgs, UpdateTaskArgs, QuickAddTaskArgs, type MoveTaskArgs, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, SearchCompletedTasksArgs, GetTasksResponse, GetAllCompletedTasksArgs, GetAllCompletedTasksResponse } from './types/tasks/index.js';
 import { ExportTemplateFileArgs, ExportTemplateUrlArgs, ExportTemplateUrlResponse, CreateProjectFromTemplateArgs, CreateProjectFromTemplateResponse, ImportTemplateIntoProjectArgs, ImportTemplateFromIdArgs, ImportTemplateResponse } from './types/templates/index.js';
+import type { AddUiExtensionArgs, UiExtension, UpdateUiExtensionArgs, UploadUiExtensionIconArgs } from './types/ui-extensions/index.js';
 import { UploadFileArgs, DeleteUploadArgs } from './types/uploads/index.js';
 import { CurrentUser } from './types/users/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 { type SyncResponse, type SyncRequest } from './types/sync/index.js';
 /**
- * Response from viewAttachment, extending CustomFetchResponse with
- * arrayBuffer() support for binary file content.
+ * A client for interacting with the Todoist API v1.
+ * This class provides methods to manage tasks, projects, sections, labels, and comments in Todoist.
+ *
+ * @example
+ * ```typescript
+ * const api = new TodoistApi('your-api-token');
+ *
+ * // Get all tasks
+ * const tasks = await api.getTasks();
+ *
+ * // Create a new task
+ * const newTask = await api.addTask({
+ *   content: 'My new task',
+ *   projectId: '12345'
+ * });
+ * ```
+ *
+ * For more information about the Todoist API v1, see the [official documentation](https://todoist.com/api/v1).
+ * If you're migrating from v9, please refer to the [migration guide](https://todoist.com/api/v1/docs#tag/Migrating-from-v9).
  */
-export type FileResponse = CustomFetchResponse & {
-    arrayBuffer(): Promise<ArrayBuffer>;
-};
 /**
  * Configuration options for the TodoistApi constructor
  */
@@ -43,6 +59,24 @@ export declare class TodoistApi {
     private authToken;
     private syncApiBase;
     private customFetch?;
+    private readonly taskClient;
+    private readonly projectClient;
+    private readonly sectionClient;
+    private readonly labelClient;
+    private readonly commentClient;
+    private readonly reminderClient;
+    private readonly insightsClient;
+    private readonly folderClient;
+    private readonly templateClient;
+    private readonly uploadClient;
+    private readonly backupClient;
+    private readonly emailClient;
+    private readonly idMappingClient;
+    private readonly activityClient;
+    private readonly productivityClient;
+    private readonly workspaceClient;
+    private readonly appClient;
+    private readonly uiExtensionClient;
     constructor(
     /**
      * Your Todoist API token.
@@ -52,16 +86,6 @@ export declare class TodoistApi {
      * Optional configuration options
      */
     options?: TodoistApiOptions);
-    /**
-     * Makes a request to the Sync API and handles error checking.
-     *
-     * @param syncRequest - The sync request payload
-     * @param requestId - Optional request identifier
-     * @param hasSyncCommands - Whether this request contains sync commands (write operations)
-     * @returns The sync response data
-     * @throws TodoistRequestError if sync status contains errors
-     */
-    private requestSync;
     /**
      * Executes a raw Sync API request.
      *
@@ -845,7 +869,6 @@ export declare class TodoistApi {
      * @returns A promise that resolves to the import result.
      */
     importTemplateFromId(args: ImportTemplateFromIdArgs, requestId?: string): Promise<ImportTemplateResponse>;
-    private validateTemplateResponse;
     /**
      * Gets pending invitations for a workspace.
      *
@@ -1023,4 +1046,202 @@ export declare class TodoistApi {
      * @returns Paginated list of archived workspace projects.
      */
     getWorkspaceArchivedProjects(args: GetWorkspaceProjectsArgs, requestId?: string): Promise<GetProjectsResponse>;
+    /**
+     * Lists all developer applications owned by the authenticated user.
+     *
+     * Requires the `dev:app_console` scope.
+     *
+     * @param requestId - Optional request ID for idempotency.
+     * @returns A promise that resolves to the list of apps.
+     */
+    getApps(requestId?: string): Promise<App[]>;
+    /**
+     * Retrieves a single developer application by ID.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getApp(appId: string, requestId?: string): Promise<AppWithUserCount>;
+    /**
+     * Creates a new developer application.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    addApp(args: AddAppArgs, requestId?: string): Promise<App>;
+    /**
+     * Updates a developer application.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    updateApp(appId: string, args: UpdateAppArgs, requestId?: string): Promise<AppWithUserCount>;
+    /**
+     * Deletes a developer application.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    deleteApp(appId: string, requestId?: string): Promise<boolean>;
+    /**
+     * Retrieves the OAuth client credentials (client ID and secret) for an app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getAppSecrets(appId: string, requestId?: string): Promise<AppSecrets>;
+    /**
+     * Rotates the app's OAuth client secret, returning the updated app record.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    resetAppClientSecret(appId: string, requestId?: string): Promise<AppWithUserCount>;
+    /**
+     * Revokes every access token issued for the given app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    revokeAppTokens(appId: string, requestId?: string): Promise<AppWithUserCount>;
+    /**
+     * Uploads an icon for a developer application. The `size` argument
+     * selects which icon slot to update (defaults to `'medium'`).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    uploadAppIcon(args: UploadAppIconArgs, requestId?: string): Promise<AppWithUserCount>;
+    /**
+     * Gets the currently issued developer test token for an app (null if none exists).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getAppTestToken(appId: string, requestId?: string): Promise<AppTestToken>;
+    /**
+     * Creates (or rotates) a developer test token for an app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    createAppTestToken(appId: string, requestId?: string): Promise<AppTestToken>;
+    /**
+     * Gets the distribution token for an app, which third parties use to install it.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getAppDistributionToken(appId: string, requestId?: string): Promise<AppDistributionToken>;
+    /**
+     * Gets the current webhook verification token for an app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getAppVerificationToken(appId: string, requestId?: string): Promise<AppVerificationToken>;
+    /**
+     * Resets the webhook verification token for an app, returning the new value.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    resetAppVerificationToken(appId: string, requestId?: string): Promise<AppVerificationToken>;
+    /**
+     * Resolves a public-facing app view from a distribution token. Used during
+     * the installation flow to show prospective installers what the app does
+     * and which scopes it requests.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getAppByDistributionToken(distributionToken: string, requestId?: string): Promise<AppByDistributionToken>;
+    /**
+     * Gets the webhook configuration for an app (null if no webhook is configured).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getAppWebhook(appId: string, requestId?: string): Promise<AppWebhook | null>;
+    /**
+     * Creates or updates an app webhook configuration (upsert).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    updateAppWebhook(args: UpdateAppWebhookArgs, requestId?: string): Promise<AppWebhook>;
+    /**
+     * Deletes an app webhook configuration.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    deleteAppWebhook(appId: string, requestId?: string): Promise<boolean>;
+    /**
+     * Lists all apps installed on the authenticated user's account.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getAppInstallations(requestId?: string): Promise<AppInstallation[]>;
+    /**
+     * Installs an application via its distribution token.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    installApp(args: InstallAppArgs, requestId?: string): Promise<AppInstallation>;
+    /**
+     * Retrieves a single app installation by ID.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getAppInstallation(installationId: string, requestId?: string): Promise<AppInstallation>;
+    /**
+     * Updates an app installation.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    updateAppInstallation(installationId: string, args: UpdateAppInstallationArgs, requestId?: string): Promise<AppInstallation>;
+    /**
+     * Uninstalls (removes) an app installation.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    uninstallApp(installationId: string, requestId?: string): Promise<boolean>;
+    /**
+     * Retrieves a single UI extension by ID.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getUiExtension(uiExtensionId: string, requestId?: string): Promise<UiExtension>;
+    /**
+     * Lists UI extensions available (installed) in the web client for the current user.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getInstalledUiExtensions(requestId?: string): Promise<UiExtension[]>;
+    /**
+     * Lists all UI extensions belonging to a given app (integration).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getUiExtensionsForApp(appId: string, requestId?: string): Promise<UiExtension[]>;
+    /**
+     * Adds a new UI extension to an app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    addUiExtension(args: AddUiExtensionArgs, requestId?: string): Promise<UiExtension>;
+    /**
+     * Updates an existing UI extension.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    updateUiExtension(uiExtensionId: string, args: UpdateUiExtensionArgs, requestId?: string): Promise<UiExtension>;
+    /**
+     * Deletes a UI extension.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    deleteUiExtension(uiExtensionId: string, requestId?: string): Promise<boolean>;
+    /**
+     * Uploads an icon for a UI extension.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    uploadUiExtensionIcon(args: UploadUiExtensionIconArgs, requestId?: string): Promise<UiExtension>;
+    /**
+     * Lists all apps the user has authorized (granted a token to).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    getUserAuthorizations(requestId?: string): Promise<UserAuthorization[]>;
+    /**
+     * Revokes a specific user authorization (access token granted to a third-party app).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    revokeUserAuthorization(args: RevokeUserAuthorizationArgs, requestId?: string): Promise<boolean>;
 }

package/dist/types/transport/sync-request.d.ts

@@ -0,0 +1,27 @@
+import type { CustomFetch } from '../types/http.js';
+import { type SyncRequest, type SyncResponse } from '../types/sync/index.js';
+/**
+ * Shared context needed to issue Sync API requests.
+ *
+ * Constructed by {@link TodoistApi} and each {@link BaseClient} subclass so
+ * that sub-clients can delegate to {@link performSyncRequest} without
+ * rebuilding the HTTP identity on every call.
+ */
+export type SyncRequestContext = {
+    authToken: string;
+    syncApiBase: string;
+    customFetch?: CustomFetch;
+};
+/**
+ * Makes a request to the Sync API and handles error checking.
+ *
+ * @param ctx - HTTP identity (auth token, sync API base URI, optional custom fetch).
+ * @param syncRequest - The sync request payload.
+ * @param options - Optional request identifier and commands flag.
+ * @returns The sync response data.
+ * @throws TodoistRequestError if sync status contains errors.
+ */
+export declare function performSyncRequest(ctx: SyncRequestContext, syncRequest: SyncRequest, options?: {
+    requestId?: string;
+    hasSyncCommands?: boolean;
+}): Promise<SyncResponse>;

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

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