@doist/todoist-sdk 9.1.0-next.2 → 9.1.1

package/dist/esm/types/ui-extensions/types.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { StringOrNumberSchema } from '../common.js';
+/**
+ * Discriminator values for the UI extension variants.
+ * Exposed as an enum-like object because the values are used in `z.literal()`
+ * across multiple variant schemas (see AGENTS.md "Discriminated unions" exception).
+ */
+export const UiExtensionTypeEnum = {
+    ContextMenu: 'context-menu',
+    Composer: 'composer',
+    Settings: 'settings',
+};
+/**
+ * All UI extension type values.
+ */
+export const UI_EXTENSION_TYPES = [
+    UiExtensionTypeEnum.ContextMenu,
+    UiExtensionTypeEnum.Composer,
+    UiExtensionTypeEnum.Settings,
+];
+/**
+ * Context locations where a context-menu extension can appear.
+ */
+export const CONTEXT_MENU_EXTENSION_CONTEXTS = ['project', 'task'];
+export const ContextMenuExtensionContextSchema = z.enum(CONTEXT_MENU_EXTENSION_CONTEXTS);
+/**
+ * Composer locations where a composer extension can appear.
+ */
+export const COMPOSER_EXTENSION_CONTEXTS = ['task', 'comment'];
+export const ComposerExtensionContextSchema = z.enum(COMPOSER_EXTENSION_CONTEXTS);
+/**
+ * Shared fields across all UI extension variants.
+ */
+export const UiExtensionBaseSchema = z.object({
+    id: StringOrNumberSchema,
+    integrationId: StringOrNumberSchema,
+    extensionId: z.string(),
+    url: z.string(),
+    icon: z.string().nullable(),
+    name: z.string(),
+    description: z.string(),
+    width: z.number().int().nullable(),
+    height: z.number().int().nullable(),
+    defVersion: z.number().int(),
+    minimumCardistVersion: z.string(),
+});
+/**
+ * Schema for a context-menu UI extension.
+ */
+export const ContextMenuExtensionSchema = UiExtensionBaseSchema.extend({
+    extensionType: z.literal(UiExtensionTypeEnum.ContextMenu),
+    contextType: ContextMenuExtensionContextSchema,
+});
+/**
+ * Schema for a composer UI extension.
+ */
+export const ComposerExtensionSchema = UiExtensionBaseSchema.extend({
+    extensionType: z.literal(UiExtensionTypeEnum.Composer),
+    composerType: ComposerExtensionContextSchema,
+});
+/**
+ * Schema for a settings UI extension.
+ */
+export const SettingsExtensionSchema = UiExtensionBaseSchema.extend({
+    extensionType: z.literal(UiExtensionTypeEnum.Settings),
+});
+/**
+ * Discriminated union of all UI extension variants.
+ */
+export const UiExtensionSchema = z.discriminatedUnion('extensionType', [
+    ContextMenuExtensionSchema,
+    ComposerExtensionSchema,
+    SettingsExtensionSchema,
+]);

package/dist/esm/utils/validators.js

@@ -1,8 +1,8 @@
 import { z } from 'zod';
 import { ActivityEventSchema } from '../types/activity/types.js';
+import { AppSchema, AppWithUserCountSchema, AppSecretsSchema, AppVerificationTokenSchema, AppTestTokenSchema, AppDistributionTokenSchema, AppByDistributionTokenSchema, AppWebhookSchema, AppInstallationSchema, UserAuthorizationSchema, } from '../types/apps/types.js';
 import { BackupSchema } from '../types/backups/types.js';
 import { AttachmentSchema, CommentSchema } from '../types/comments/types.js';
-import { GoalSchema } from '../types/goals/types.js';
 import { IdMappingSchema, MovedIdSchema } from '../types/id-mappings/types.js';
 import { ProjectActivityStatsSchema, ProjectHealthSchema, ProjectHealthContextSchema, ProjectProgressSchema, WorkspaceInsightsSchema, } from '../types/insights/types.js';
 import { LabelSchema } from '../types/labels/types.js';
@@ -11,6 +11,7 @@ import { WorkspaceProjectSchema, ProjectSchema } from '../types/projects/types.j
 import { SectionSchema } from '../types/sections/types.js';
 import { SyncResponseSchema } from '../types/sync/response.js';
 import { TaskSchema } from '../types/tasks/types.js';
+import { UiExtensionSchema } from '../types/ui-extensions/types.js';
 import { UserSchema, CurrentUserSchema } from '../types/users/types.js';
 import { WorkspaceUserSchema, WorkspaceInvitationSchema, WorkspacePlanDetailsSchema, JoinWorkspaceResultSchema, WorkspaceSchema, MemberActivityInfoSchema, WorkspaceUserTaskSchema, } from '../types/workspaces/types.js';
 import { FilterSchema, CollaboratorSchema, CollaboratorStateSchema, FolderSchema, NoteSchema, TooltipsSchema, WorkspaceFilterSchema, WorkspaceGoalSchema, CalendarSchema, CalendarAccountSchema, ReminderSchema, LocationReminderSchema, CompletedInfoSchema, ViewOptionsSchema, ProjectViewOptionsDefaultsSchema, UserPlanLimitsSchema, LiveNotificationSchema, SyncWorkspaceSchema, SyncUserSchema, UserSettingsSchema, SuggestionSchema, } from '../types/sync/resources/index.js';
@@ -57,7 +58,6 @@ export const { validate: validateFilter, validateArray: validateFilterArray } =
 export const { validate: validateCollaborator, validateArray: validateCollaboratorArray } = createValidator(CollaboratorSchema);
 export const { validate: validateCollaboratorState, validateArray: validateCollaboratorStateArray, } = createValidator(CollaboratorStateSchema);
 export const { validate: validateFolder, validateArray: validateFolderArray } = createValidator(FolderSchema);
-export const { validate: validateGoal, validateArray: validateGoalArray } = createValidator(GoalSchema);
 export const { validate: validateNote, validateArray: validateNoteArray } = createValidator(NoteSchema);
 export const { validate: validateTooltips } = createValidator(TooltipsSchema);
 export const { validate: validateWorkspaceFilter, validateArray: validateWorkspaceFilterArray } = createValidator(WorkspaceFilterSchema);
@@ -78,3 +78,15 @@ export const { validate: validateSuggestion, validateArray: validateSuggestionAr
 export function parseSyncResponse(raw) {
     return SyncResponseSchema.parse(raw);
 }
+// App management validators
+export const { validate: validateApp, validateArray: validateAppArray } = createValidator(AppSchema);
+export const { validate: validateAppWithUserCount } = createValidator(AppWithUserCountSchema);
+export const { validate: validateAppSecrets } = createValidator(AppSecretsSchema);
+export const { validate: validateAppVerificationToken } = createValidator(AppVerificationTokenSchema);
+export const { validate: validateAppTestToken } = createValidator(AppTestTokenSchema);
+export const { validate: validateAppDistributionToken } = createValidator(AppDistributionTokenSchema);
+export const { validate: validateAppByDistributionToken } = createValidator(AppByDistributionTokenSchema);
+export const { validate: validateAppWebhook } = createValidator(AppWebhookSchema);
+export const { validate: validateAppInstallation, validateArray: validateAppInstallationArray } = createValidator(AppInstallationSchema);
+export const { validate: validateUserAuthorization, validateArray: validateUserAuthorizationArray, } = createValidator(UserAuthorizationSchema);
+export const { validate: validateUiExtension, validateArray: validateUiExtensionArray } = createValidator(UiExtensionSchema);

package/dist/types/authentication.d.ts

@@ -7,7 +7,7 @@ export type AuthOptions = {
     customFetch?: CustomFetch;
 };
 /** Available OAuth2 permission scopes. */
-export declare const PERMISSIONS: readonly ["task:add", "data:read", "data:read_write", "data:delete", "project:delete", "backups:read"];
+export declare const PERMISSIONS: readonly ["task:add", "data:read", "data:read_write", "data:delete", "project:delete", "backups:read", "dev:app_console"];
 /**
  * Permission scope that can be requested during OAuth2 authorization.
  * @see {@link https://developer.todoist.com/api/v1/#tag/Authorization}

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

@@ -0,0 +1,37 @@
+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 { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling all developer-app management endpoints
+ * (apps, secrets, tokens, webhooks, installations, user authorizations).
+ * All endpoints require the `dev:app_console` OAuth scope.
+ *
+ * Instantiated by `TodoistApi`; every public app-management method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing JSDoc.
+ */
+export declare class AppClient extends BaseClient {
+    getApps(requestId?: string): Promise<App[]>;
+    getApp(appId: string, requestId?: string): Promise<AppWithUserCount>;
+    addApp(args: AddAppArgs, requestId?: string): Promise<App>;
+    updateApp(appId: string, args: UpdateAppArgs, requestId?: string): Promise<AppWithUserCount>;
+    deleteApp(appId: string, requestId?: string): Promise<boolean>;
+    getAppSecrets(appId: string, requestId?: string): Promise<AppSecrets>;
+    resetAppClientSecret(appId: string, requestId?: string): Promise<AppWithUserCount>;
+    revokeAppTokens(appId: string, requestId?: string): Promise<AppWithUserCount>;
+    uploadAppIcon(args: UploadAppIconArgs, requestId?: string): Promise<AppWithUserCount>;
+    getAppTestToken(appId: string, requestId?: string): Promise<AppTestToken>;
+    createAppTestToken(appId: string, requestId?: string): Promise<AppTestToken>;
+    getAppDistributionToken(appId: string, requestId?: string): Promise<AppDistributionToken>;
+    getAppVerificationToken(appId: string, requestId?: string): Promise<AppVerificationToken>;
+    resetAppVerificationToken(appId: string, requestId?: string): Promise<AppVerificationToken>;
+    getAppByDistributionToken(distributionToken: string, requestId?: string): Promise<AppByDistributionToken>;
+    getAppWebhook(appId: string, requestId?: string): Promise<AppWebhook | null>;
+    updateAppWebhook(args: UpdateAppWebhookArgs, requestId?: string): Promise<AppWebhook>;
+    deleteAppWebhook(appId: string, requestId?: string): Promise<boolean>;
+    getAppInstallations(requestId?: string): Promise<AppInstallation[]>;
+    installApp(args: InstallAppArgs, requestId?: string): Promise<AppInstallation>;
+    getAppInstallation(installationId: string, requestId?: string): Promise<AppInstallation>;
+    updateAppInstallation(installationId: string, args: UpdateAppInstallationArgs, requestId?: string): Promise<AppInstallation>;
+    uninstallApp(installationId: string, requestId?: string): Promise<boolean>;
+    getUserAuthorizations(requestId?: string): Promise<UserAuthorization[]>;
+    revokeUserAuthorization(args: RevokeUserAuthorizationArgs, requestId?: string): Promise<boolean>;
+}

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

@@ -15,6 +15,7 @@ import type { CustomFetch } from '../types/http.js';
 export declare abstract class BaseClient {
     protected readonly authToken: string;
     protected readonly syncApiBase: string;
+    protected readonly apiRootBase: string;
     protected readonly customFetch?: CustomFetch;
     constructor(context: SyncRequestContext);
     protected get syncContext(): SyncRequestContext;

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/consts/endpoints.d.ts

@@ -2,6 +2,7 @@ export declare const TODOIST_WEB_URI = "https://app.todoist.com/app";
 export declare const API_VERSION = "v1";
 export declare const API_BASE_URI = "/api/v1/";
 export declare function getSyncBaseUri(domainBase?: string): string;
+export declare function getApiRootBaseUri(domainBase?: string): string;
 export declare function getAuthBaseUri(domainBase?: string): string;
 export declare const ENDPOINT_REST_TASKS = "tasks";
 export declare const ENDPOINT_REST_TASKS_FILTER: string;
@@ -58,11 +59,6 @@ export declare const ENDPOINT_GET_TOKEN = "access_token";
 export declare const ENDPOINT_REVOKE = "revoke";
 export declare const ENDPOINT_REGISTER = "register";
 export declare const ENDPOINT_REST_FOLDERS = "folders";
-export declare const ENDPOINT_REST_GOALS = "goals";
-export declare const ENDPOINT_REST_GOALS_SEARCH: string;
-export declare const GOAL_COMPLETE = "complete";
-export declare const GOAL_UNCOMPLETE = "uncomplete";
-export declare const GOAL_TASKS = "items";
 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";
@@ -85,3 +81,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, Goal } 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,7 +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_GOAL_ID = "550e8400-e29b-41d4-a716-446655440000";
-export declare const DEFAULT_GOAL: Goal;
-export declare const DEFAULT_GOAL_NO_PROGRESS: Goal;
+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,10 @@
 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 type { AddGoalArgs, GetGoalsArgs, GetGoalsResponse, Goal, SearchGoalsArgs, TaskLinkingArgs, UpdateGoalArgs } from './types/goals/index.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';
@@ -16,6 +16,7 @@ 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';
@@ -74,7 +75,8 @@ export declare class TodoistApi {
     private readonly activityClient;
     private readonly productivityClient;
     private readonly workspaceClient;
-    private readonly goalsClient;
+    private readonly appClient;
+    private readonly uiExtensionClient;
     constructor(
     /**
      * Your Todoist API token.
@@ -785,16 +787,6 @@ export declare class TodoistApi {
      * @returns A promise that resolves to `true` if successful.
      */
     deleteFolder(id: string, requestId?: string): Promise<boolean>;
-    getGoals(args?: GetGoalsArgs): Promise<GetGoalsResponse>;
-    searchGoals(args: SearchGoalsArgs): Promise<GetGoalsResponse>;
-    getGoal(id: string): Promise<Goal>;
-    addGoal(args: AddGoalArgs, requestId?: string): Promise<Goal>;
-    updateGoal(id: string, args: UpdateGoalArgs, requestId?: string): Promise<Goal>;
-    deleteGoal(id: string, requestId?: string): Promise<boolean>;
-    completeGoal(id: string, requestId?: string): Promise<Goal>;
-    uncompleteGoal(id: string, requestId?: string): Promise<Goal>;
-    linkTaskToGoal(args: TaskLinkingArgs, requestId?: string): Promise<Goal>;
-    unlinkTaskFromGoal(args: TaskLinkingArgs, requestId?: string): Promise<boolean>;
     /**
      * Retrieves a list of available backups.
      *
@@ -1054,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/types/apps/index.d.ts

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

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

@@ -0,0 +1,89 @@
+import type { Permission } from '../../authentication.js';
+import type { AppIconSize } from '../../consts/endpoints.js';
+import type { InstallationType, WebhookEvent, WebhookVersion } from './types.js';
+/**
+ * Arguments for creating a new developer application.
+ */
+export type AddAppArgs = {
+    /** Display name of the application. */
+    displayName: string;
+    /** The application's service URL. */
+    serviceUrl: string;
+};
+/**
+ * Arguments for updating a developer application.
+ * All fields are optional — only provided fields are updated.
+ *
+ * Pass `appTokenScopes` as an array (e.g. `['data:read', 'task:add']`);
+ * the SDK serializes it to the comma-separated string the backend expects.
+ */
+export type UpdateAppArgs = {
+    /** Updated display name. */
+    displayName?: string;
+    /** Updated OAuth redirect URI. Pass `null` to clear. */
+    oauthRedirectUri?: string | null;
+    /** Updated service URL. */
+    serviceUrl?: string;
+    /** Updated app description. */
+    description?: string;
+    /**
+     * Updated list of scopes the app may request. Pass `null` to clear.
+     *
+     * Typed as `Permission | (string & {})` so known scopes get autocomplete
+     * while still permitting plain strings — needed so a fetched
+     * `App['appTokenScopes']` (typed `string[] | null`) can be passed back
+     * to `updateApp()` without casts.
+     */
+    appTokenScopes?: readonly (Permission | (string & {}))[] | null;
+};
+/**
+ * Arguments for uploading an app icon.
+ */
+export type UploadAppIconArgs = {
+    /** The application ID. */
+    appId: string;
+    /** The icon file to upload (Buffer, Stream, or file path). */
+    file: Buffer | NodeJS.ReadableStream | string | Blob;
+    /** The file name (required for Buffer/Stream uploads). */
+    fileName?: string;
+    /** Icon size variant. Defaults to `'medium'`. */
+    size?: AppIconSize;
+};
+/**
+ * Arguments for configuring (creating or updating) an app webhook.
+ */
+export type UpdateAppWebhookArgs = {
+    /** The application ID. */
+    appId: string;
+    /** The URL the webhook will POST events to. */
+    callbackUrl: string;
+    /** Events the webhook should receive. Must be unique. */
+    events: readonly WebhookEvent[];
+    /** Webhook payload version. Defaults to the backend's latest supported version. */
+    version?: WebhookVersion;
+};
+/**
+ * Arguments for installing a developer application via its distribution token.
+ */
+export type InstallAppArgs = {
+    /** The distribution token for the app being installed. */
+    distributionToken: string;
+    /** Type of installation to create. */
+    installationType: InstallationType;
+    /** Whether the requesting client has validated the app's requested scopes with the user. */
+    appTokenScopesValidated?: boolean;
+};
+/**
+ * Arguments for updating an app installation.
+ */
+export type UpdateAppInstallationArgs = {
+    /** Updated validated-scopes flag. */
+    appTokenScopesValidated?: boolean;
+};
+/**
+ * Arguments for revoking a user's authorization of a third-party app.
+ */
+export type RevokeUserAuthorizationArgs = {
+    /** The ID of the access token to revoke. */
+    accessTokenId: string;
+};