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

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_NOTE = exports.DEFAULT_GOAL_NO_PROGRESS = exports.DEFAULT_GOAL = exports.DEFAULT_GOAL_ID = exports.DEFAULT_COLLABORATOR_STATE = exports.DEFAULT_COLLABORATOR = exports.DEFAULT_FOLDER = exports.COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = exports.COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = exports.RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = exports.COMMENT_WITH_OPTIONALS_AS_NULL_TASK = exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_TASK = exports.INVALID_COMMENT = exports.DEFAULT_LOCATION_REMINDER = exports.DEFAULT_ABSOLUTE_REMINDER = exports.DEFAULT_RELATIVE_REMINDER = exports.DEFAULT_REMINDER_ID = exports.DEFAULT_COMMENT = exports.DEFAULT_RAW_COMMENT = exports.INVALID_ATTACHMENT = exports.DEFAULT_ATTACHMENT = exports.INVALID_USER = exports.DEFAULT_USER = exports.INVALID_LABEL = exports.DEFAULT_LABEL = exports.INVALID_SECTION = exports.DEFAULT_SECTION = exports.DEFAULT_WORKSPACE_PROJECT = exports.PROJECT_WITH_OPTIONALS_AS_NULL = exports.INVALID_PROJECT = exports.DEFAULT_PROJECT = exports.TASK_WITH_OPTIONALS_AS_NULL = exports.INVALID_TASK = exports.DEFAULT_TASK = exports.DEFAULT_DEADLINE = exports.DEFAULT_DURATION = exports.DEFAULT_DUE_DATE = exports.INVALID_ENTITY_ID = exports.DEFAULT_REQUEST_ID = exports.DEFAULT_AUTH_TOKEN = exports.DEFAULT_PROJECT_VIEW_STYLE = exports.DEFAULT_PROJECT_NAME = exports.DEFAULT_PROJECT_ID = exports.DEFAULT_ORDER = exports.DEFAULT_TASK_PRIORITY = exports.DEFAULT_TASK_DESCRIPTION = exports.DEFAULT_TASK_CONTENT = exports.DEFAULT_TASK_ID = void 0;
+exports.DEFAULT_ACCESS_TOKEN_ID = exports.DEFAULT_DISTRIBUTION_TOKEN = exports.DEFAULT_UI_EXTENSION_ID = exports.DEFAULT_INSTALLATION_ID = exports.DEFAULT_APP_ID = exports.DEFAULT_COLLABORATOR_STATE = exports.DEFAULT_COLLABORATOR = exports.DEFAULT_FOLDER = exports.COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT = exports.COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = exports.RAW_COMMENT_WITH_ATTACHMENT_WITH_OPTIONALS_AS_NULL = exports.COMMENT_WITH_OPTIONALS_AS_NULL_TASK = exports.RAW_COMMENT_WITH_OPTIONALS_AS_NULL_TASK = exports.INVALID_COMMENT = exports.DEFAULT_LOCATION_REMINDER = exports.DEFAULT_ABSOLUTE_REMINDER = exports.DEFAULT_RELATIVE_REMINDER = exports.DEFAULT_REMINDER_ID = exports.DEFAULT_COMMENT = exports.DEFAULT_RAW_COMMENT = exports.INVALID_ATTACHMENT = exports.DEFAULT_ATTACHMENT = exports.INVALID_USER = exports.DEFAULT_USER = exports.INVALID_LABEL = exports.DEFAULT_LABEL = exports.INVALID_SECTION = exports.DEFAULT_SECTION = exports.DEFAULT_WORKSPACE_PROJECT = exports.PROJECT_WITH_OPTIONALS_AS_NULL = exports.INVALID_PROJECT = exports.DEFAULT_PROJECT = exports.TASK_WITH_OPTIONALS_AS_NULL = exports.INVALID_TASK = exports.DEFAULT_TASK = exports.DEFAULT_DEADLINE = exports.DEFAULT_DURATION = exports.DEFAULT_DUE_DATE = exports.INVALID_ENTITY_ID = exports.DEFAULT_REQUEST_ID = exports.DEFAULT_AUTH_TOKEN = exports.DEFAULT_PROJECT_VIEW_STYLE = exports.DEFAULT_PROJECT_NAME = exports.DEFAULT_PROJECT_ID = exports.DEFAULT_ORDER = exports.DEFAULT_TASK_PRIORITY = exports.DEFAULT_TASK_DESCRIPTION = exports.DEFAULT_TASK_CONTENT = exports.DEFAULT_TASK_ID = void 0;
+exports.DEFAULT_NOTE = exports.DEFAULT_UI_EXTENSION = exports.DEFAULT_USER_AUTHORIZATION = exports.DEFAULT_APP_INSTALLATION = exports.DEFAULT_APP_WEBHOOK = exports.DEFAULT_APP_DISTRIBUTION_TOKEN = exports.DEFAULT_APP_TEST_TOKEN = exports.DEFAULT_APP_VERIFICATION_TOKEN = exports.DEFAULT_APP_SECRETS = exports.DEFAULT_APP_WITH_USER_COUNT = exports.DEFAULT_APP = void 0;
 const url_helpers_1 = require("../utils/url-helpers");
 exports.DEFAULT_TASK_ID = '1234';
 exports.DEFAULT_TASK_CONTENT = 'This is a task';
@@ -280,30 +281,81 @@ exports.DEFAULT_COLLABORATOR_STATE = {
     state: 'active',
     isDeleted: false,
 };
-exports.DEFAULT_GOAL_ID = '550e8400-e29b-41d4-a716-446655440000';
-exports.DEFAULT_GOAL = {
-    id: exports.DEFAULT_GOAL_ID,
-    ownerType: 'USER',
-    ownerId: DEFAULT_USER_ID,
-    name: 'Ship v2',
-    description: 'Launch the new version',
-    deadline: '2026-04-03',
-    parentGoalId: null,
-    childOrder: 0,
-    isCompleted: false,
-    completedAt: null,
-    responsibleUid: null,
-    isDeleted: false,
-    progress: {
-        totalTaskCount: 5,
-        completedTaskCount: 2,
-        percentage: 40,
-    },
-    creatorUid: DEFAULT_USER_ID,
+exports.DEFAULT_APP_ID = '42';
+exports.DEFAULT_INSTALLATION_ID = '1001';
+exports.DEFAULT_UI_EXTENSION_ID = '2002';
+exports.DEFAULT_DISTRIBUTION_TOKEN = 'dist-token-abc';
+exports.DEFAULT_ACCESS_TOKEN_ID = '3003';
+exports.DEFAULT_APP = {
+    id: exports.DEFAULT_APP_ID,
+    status: 'public',
+    displayName: 'Sample App',
+    userId: DEFAULT_USER_ID,
     createdAt: defaultDate(),
-    updatedAt: defaultDate(),
+    serviceUrl: 'https://example.com',
+    oauthRedirectUri: 'https://example.com/callback',
+    description: 'A sample app',
+    iconSm: 'https://example.com/icon-sm.png',
+    iconMd: 'https://example.com/icon-md.png',
+    iconLg: 'https://example.com/icon-lg.png',
+    appTokenScopes: ['data:read', 'task:add'],
+};
+exports.DEFAULT_APP_WITH_USER_COUNT = Object.assign(Object.assign({}, exports.DEFAULT_APP), { userCount: 12 });
+exports.DEFAULT_APP_SECRETS = {
+    clientId: 'client-id-xyz',
+    clientSecret: 'client-secret-xyz',
+};
+exports.DEFAULT_APP_VERIFICATION_TOKEN = {
+    verificationToken: 'verif-token-abc',
+};
+exports.DEFAULT_APP_TEST_TOKEN = {
+    accessToken: 'test-token-xyz',
+};
+exports.DEFAULT_APP_DISTRIBUTION_TOKEN = {
+    distributionToken: exports.DEFAULT_DISTRIBUTION_TOKEN,
+};
+exports.DEFAULT_APP_WEBHOOK = {
+    status: 'active',
+    callbackUrl: 'https://example.com/webhook',
+    version: '1',
+    events: ['item:added', 'item:completed'],
+};
+exports.DEFAULT_APP_INSTALLATION = {
+    id: exports.DEFAULT_INSTALLATION_ID,
+    creator: DEFAULT_USER_ID,
+    createdTs: 1700000000,
+    installationType: 'user',
+    appTokenScopesValidated: true,
+    integration: exports.DEFAULT_APP,
+};
+exports.DEFAULT_USER_AUTHORIZATION = {
+    accessTokenId: exports.DEFAULT_ACCESS_TOKEN_ID,
+    scope: ['data:read', 'task:add'],
+    scopeDescriptions: ['Read data', 'Add tasks'],
+    createdAt: new Date('2025-01-01T00:00:00Z'),
+    app: {
+        id: exports.DEFAULT_APP_ID,
+        displayName: 'Sample App',
+        description: 'A sample app',
+        serviceUrl: 'https://example.com',
+        iconMd: 'https://example.com/icon-md.png',
+    },
+};
+exports.DEFAULT_UI_EXTENSION = {
+    id: exports.DEFAULT_UI_EXTENSION_ID,
+    integrationId: exports.DEFAULT_APP_ID,
+    extensionId: 'ext-guid-1',
+    extensionType: 'context-menu',
+    contextType: 'task',
+    url: 'https://example.com/extension',
+    icon: 'https://example.com/icon.png',
+    name: 'My Extension',
+    description: 'Does things in the task context menu',
+    width: 400,
+    height: 600,
+    defVersion: 2,
+    minimumCardistVersion: '0.60',
 };
-exports.DEFAULT_GOAL_NO_PROGRESS = Object.assign(Object.assign({}, exports.DEFAULT_GOAL), { id: 'e5f6g7h8-e29b-41d4-a716-446655440001', progress: undefined });
 exports.DEFAULT_NOTE = {
     id: DEFAULT_COMMENT_ID,
     projectId: exports.DEFAULT_PROJECT_ID,

package/dist/cjs/todoist-api.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TodoistApi = void 0;
 const activity_client_1 = require("./clients/activity-client");
+const app_client_1 = require("./clients/app-client");
 const backup_client_1 = require("./clients/backup-client");
 const comment_client_1 = require("./clients/comment-client");
 const email_client_1 = require("./clients/email-client");
 const folder_client_1 = require("./clients/folder-client");
-const goals_client_1 = require("./clients/goals-client");
 const id_mapping_client_1 = require("./clients/id-mapping-client");
 const insights_client_1 = require("./clients/insights-client");
 const label_client_1 = require("./clients/label-client");
@@ -16,6 +16,7 @@ const reminder_client_1 = require("./clients/reminder-client");
 const section_client_1 = require("./clients/section-client");
 const task_client_1 = require("./clients/task-client");
 const template_client_1 = require("./clients/template-client");
+const ui_extension_client_1 = require("./clients/ui-extension-client");
 const upload_client_1 = require("./clients/upload-client");
 const workspace_client_1 = require("./clients/workspace-client");
 const endpoints_1 = require("./consts/endpoints");
@@ -60,7 +61,8 @@ class TodoistApi {
         this.activityClient = new activity_client_1.ActivityClient(clientDeps);
         this.productivityClient = new productivity_client_1.ProductivityClient(clientDeps);
         this.workspaceClient = new workspace_client_1.WorkspaceClient(clientDeps);
-        this.goalsClient = new goals_client_1.GoalsClient(clientDeps);
+        this.appClient = new app_client_1.AppClient(clientDeps);
+        this.uiExtensionClient = new ui_extension_client_1.UiExtensionClient(clientDeps);
     }
     /**
      * Executes a raw Sync API request.
@@ -940,37 +942,6 @@ class TodoistApi {
     async deleteFolder(id, requestId) {
         return this.folderClient.deleteFolder(id, requestId);
     }
-    // ── Goals ──
-    async getGoals(args) {
-        return this.goalsClient.getGoals(args);
-    }
-    async searchGoals(args) {
-        return this.goalsClient.searchGoals(args);
-    }
-    async getGoal(id) {
-        return this.goalsClient.getGoal(id);
-    }
-    async addGoal(args, requestId) {
-        return this.goalsClient.addGoal(args, requestId);
-    }
-    async updateGoal(id, args, requestId) {
-        return this.goalsClient.updateGoal(id, args, requestId);
-    }
-    async deleteGoal(id, requestId) {
-        return this.goalsClient.deleteGoal(id, requestId);
-    }
-    async completeGoal(id, requestId) {
-        return this.goalsClient.completeGoal(id, requestId);
-    }
-    async uncompleteGoal(id, requestId) {
-        return this.goalsClient.uncompleteGoal(id, requestId);
-    }
-    async linkTaskToGoal(args, requestId) {
-        return this.goalsClient.linkTaskToGoal(args, requestId);
-    }
-    async unlinkTaskFromGoal(args, requestId) {
-        return this.goalsClient.unlinkTaskFromGoal(args, requestId);
-    }
     // ── Backups ──
     /**
      * Retrieves a list of available backups.
@@ -1297,5 +1268,270 @@ class TodoistApi {
     async getWorkspaceArchivedProjects(args, requestId) {
         return this.workspaceClient.getWorkspaceArchivedProjects(args, requestId);
     }
+    // ---------------------------------------------------------------------------
+    // App management (dev:app_console scope)
+    // ---------------------------------------------------------------------------
+    /**
+     * 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.
+     */
+    async getApps(requestId) {
+        return this.appClient.getApps(requestId);
+    }
+    /**
+     * Retrieves a single developer application by ID.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getApp(appId, requestId) {
+        return this.appClient.getApp(appId, requestId);
+    }
+    /**
+     * Creates a new developer application.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async addApp(args, requestId) {
+        return this.appClient.addApp(args, requestId);
+    }
+    /**
+     * Updates a developer application.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async updateApp(appId, args, requestId) {
+        return this.appClient.updateApp(appId, args, requestId);
+    }
+    /**
+     * Deletes a developer application.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async deleteApp(appId, requestId) {
+        return this.appClient.deleteApp(appId, requestId);
+    }
+    /**
+     * Retrieves the OAuth client credentials (client ID and secret) for an app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getAppSecrets(appId, requestId) {
+        return this.appClient.getAppSecrets(appId, requestId);
+    }
+    /**
+     * Rotates the app's OAuth client secret, returning the updated app record.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async resetAppClientSecret(appId, requestId) {
+        return this.appClient.resetAppClientSecret(appId, requestId);
+    }
+    /**
+     * Revokes every access token issued for the given app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async revokeAppTokens(appId, requestId) {
+        return this.appClient.revokeAppTokens(appId, requestId);
+    }
+    /**
+     * 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.
+     */
+    async uploadAppIcon(args, requestId) {
+        return this.appClient.uploadAppIcon(args, requestId);
+    }
+    /**
+     * Gets the currently issued developer test token for an app (null if none exists).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getAppTestToken(appId, requestId) {
+        return this.appClient.getAppTestToken(appId, requestId);
+    }
+    /**
+     * Creates (or rotates) a developer test token for an app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async createAppTestToken(appId, requestId) {
+        return this.appClient.createAppTestToken(appId, requestId);
+    }
+    /**
+     * Gets the distribution token for an app, which third parties use to install it.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getAppDistributionToken(appId, requestId) {
+        return this.appClient.getAppDistributionToken(appId, requestId);
+    }
+    /**
+     * Gets the current webhook verification token for an app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getAppVerificationToken(appId, requestId) {
+        return this.appClient.getAppVerificationToken(appId, requestId);
+    }
+    /**
+     * Resets the webhook verification token for an app, returning the new value.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async resetAppVerificationToken(appId, requestId) {
+        return this.appClient.resetAppVerificationToken(appId, requestId);
+    }
+    /**
+     * 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.
+     */
+    async getAppByDistributionToken(distributionToken, requestId) {
+        return this.appClient.getAppByDistributionToken(distributionToken, requestId);
+    }
+    /**
+     * Gets the webhook configuration for an app (null if no webhook is configured).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getAppWebhook(appId, requestId) {
+        return this.appClient.getAppWebhook(appId, requestId);
+    }
+    /**
+     * Creates or updates an app webhook configuration (upsert).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async updateAppWebhook(args, requestId) {
+        return this.appClient.updateAppWebhook(args, requestId);
+    }
+    /**
+     * Deletes an app webhook configuration.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async deleteAppWebhook(appId, requestId) {
+        return this.appClient.deleteAppWebhook(appId, requestId);
+    }
+    /**
+     * Lists all apps installed on the authenticated user's account.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getAppInstallations(requestId) {
+        return this.appClient.getAppInstallations(requestId);
+    }
+    /**
+     * Installs an application via its distribution token.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async installApp(args, requestId) {
+        return this.appClient.installApp(args, requestId);
+    }
+    /**
+     * Retrieves a single app installation by ID.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getAppInstallation(installationId, requestId) {
+        return this.appClient.getAppInstallation(installationId, requestId);
+    }
+    /**
+     * Updates an app installation.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async updateAppInstallation(installationId, args, requestId) {
+        return this.appClient.updateAppInstallation(installationId, args, requestId);
+    }
+    /**
+     * Uninstalls (removes) an app installation.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async uninstallApp(installationId, requestId) {
+        return this.appClient.uninstallApp(installationId, requestId);
+    }
+    /**
+     * Retrieves a single UI extension by ID.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getUiExtension(uiExtensionId, requestId) {
+        return this.uiExtensionClient.getUiExtension(uiExtensionId, requestId);
+    }
+    /**
+     * Lists UI extensions available (installed) in the web client for the current user.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getInstalledUiExtensions(requestId) {
+        return this.uiExtensionClient.getInstalledUiExtensions(requestId);
+    }
+    /**
+     * Lists all UI extensions belonging to a given app (integration).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getUiExtensionsForApp(appId, requestId) {
+        return this.uiExtensionClient.getUiExtensionsForApp(appId, requestId);
+    }
+    /**
+     * Adds a new UI extension to an app.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async addUiExtension(args, requestId) {
+        return this.uiExtensionClient.addUiExtension(args, requestId);
+    }
+    /**
+     * Updates an existing UI extension.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async updateUiExtension(uiExtensionId, args, requestId) {
+        return this.uiExtensionClient.updateUiExtension(uiExtensionId, args, requestId);
+    }
+    /**
+     * Deletes a UI extension.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async deleteUiExtension(uiExtensionId, requestId) {
+        return this.uiExtensionClient.deleteUiExtension(uiExtensionId, requestId);
+    }
+    /**
+     * Uploads an icon for a UI extension.
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async uploadUiExtensionIcon(args, requestId) {
+        return this.uiExtensionClient.uploadUiExtensionIcon(args, requestId);
+    }
+    /**
+     * Lists all apps the user has authorized (granted a token to).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async getUserAuthorizations(requestId) {
+        return this.appClient.getUserAuthorizations(requestId);
+    }
+    /**
+     * Revokes a specific user authorization (access token granted to a third-party app).
+     *
+     * Requires the `dev:app_console` scope.
+     */
+    async revokeUserAuthorization(args, requestId) {
+        return this.appClient.revokeUserAuthorization(args, requestId);
+    }
 }
 exports.TodoistApi = TodoistApi;

package/dist/cjs/transport/http-client.js

@@ -100,6 +100,7 @@ async function request(args) {
                 break;
             case 'POST':
             case 'PUT':
+            case 'PATCH':
             case 'DELETE': {
                 // Convert payload from camelCase to snake_case
                 // Note: While DELETE with body is uncommon, the Todoist API uses it for some endpoints