@doist/todoist-api-typescript 7.5.0 → 7.6.0

package/dist/cjs/authentication.js

@@ -5,6 +5,7 @@ exports.getAuthStateParameter = getAuthStateParameter;
 exports.getAuthorizationUrl = getAuthorizationUrl;
 exports.getAuthToken = getAuthToken;
 exports.revokeToken = revokeToken;
+exports.migratePersonalToken = migratePersonalToken;
 const http_client_1 = require("./transport/http-client");
 const uuid_1 = require("uuid");
 const types_1 = require("./types");
@@ -58,7 +59,7 @@ function getAuthStateParameter() {
  * ```
  *
  * @returns The full authorization URL to redirect users to
- * @see https://todoist.com/api/v1/docs#tag/Authorization/OAuth
+ * @see https://developer.todoist.com/api/v1/#tag/Authorization/OAuth
  */
 function getAuthorizationUrl({ clientId, permissions, state, baseUrl, }) {
     if (!(permissions === null || permissions === void 0 ? void 0 : permissions.length)) {
@@ -126,7 +127,7 @@ async function getAuthToken(args, options) {
  *
  * @returns True if revocation was successful
  * @see https://datatracker.ietf.org/doc/html/rfc7009
- * @see https://todoist.com/api/v1/docs#tag/Authorization
+ * @see https://developer.todoist.com/api/v1/#tag/Authorization
  */
 async function revokeToken(args, options) {
     if (typeof options === 'string') {
@@ -158,3 +159,46 @@ async function revokeToken(args, options) {
     });
     return (0, http_client_1.isSuccess)(response);
 }
+/**
+ * Migrates a personal API token to an OAuth access token.
+ *
+ * This allows applications to transition users from personal API tokens
+ * to proper OAuth tokens without requiring the user to go through the
+ * full OAuth authorization flow.
+ *
+ * @example
+ * ```typescript
+ * const { accessToken } = await migratePersonalToken({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ *   personalToken: 'user-personal-token',
+ *   scope: 'data:read_write,data:delete'
+ * })
+ * ```
+ *
+ * @returns The new OAuth token response
+ * @throws {@link TodoistRequestError} If the migration fails
+ */
+async function migratePersonalToken(args, options) {
+    var _a;
+    const baseUrl = options === null || options === void 0 ? void 0 : options.baseUrl;
+    const customFetch = options === null || options === void 0 ? void 0 : options.customFetch;
+    try {
+        const response = await (0, http_client_1.request)({
+            httpMethod: 'POST',
+            baseUri: (0, endpoints_1.getSyncBaseUri)(baseUrl),
+            relativePath: endpoints_1.ENDPOINT_REST_ACCESS_TOKENS_MIGRATE,
+            apiToken: undefined,
+            payload: Object.assign(Object.assign({}, args), { scope: args.scope.join(',') }),
+            customFetch,
+        });
+        if (response.status !== 200 || !((_a = response.data) === null || _a === void 0 ? void 0 : _a.accessToken)) {
+            throw new types_1.TodoistRequestError('Personal token migration failed.', response.status, response.data);
+        }
+        return response.data;
+    }
+    catch (error) {
+        const err = error;
+        throw new types_1.TodoistRequestError('Personal token migration failed.', err.httpStatusCode, err.responseData);
+    }
+}

package/dist/cjs/consts/endpoints.js

@@ -1,11 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENDPOINT_WORKSPACE_LOGO = exports.ENDPOINT_WORKSPACE_JOIN = exports.ENDPOINT_WORKSPACE_INVITATIONS_DELETE = exports.ENDPOINT_WORKSPACE_INVITATIONS_ALL = exports.ENDPOINT_WORKSPACE_INVITATIONS = exports.ENDPOINT_REST_WORKSPACES = exports.ENDPOINT_REVOKE = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE = exports.SECTION_UNARCHIVE = exports.SECTION_ARCHIVE = exports.ENDPOINT_REST_PROJECT_JOIN = exports.ENDPOINT_REST_PROJECT_FULL = exports.ENDPOINT_REST_PROJECTS_PERMISSIONS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT = exports.PROJECT_UNARCHIVE = exports.PROJECT_ARCHIVE = exports.ENDPOINT_REST_UPLOADS = exports.ENDPOINT_REST_ACTIVITIES = exports.ENDPOINT_REST_PRODUCTIVITY = exports.ENDPOINT_REST_USER = exports.ENDPOINT_REST_PROJECT_COLLABORATORS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED = exports.ENDPOINT_REST_PROJECTS_SEARCH = exports.ENDPOINT_REST_PROJECTS = exports.ENDPOINT_REST_TASK_MOVE = exports.ENDPOINT_REST_TASK_REOPEN = exports.ENDPOINT_REST_TASK_CLOSE = exports.ENDPOINT_REST_LOCATION_REMINDERS = exports.ENDPOINT_REST_REMINDERS = exports.ENDPOINT_REST_COMMENTS = exports.ENDPOINT_REST_LABELS_SHARED_REMOVE = exports.ENDPOINT_REST_LABELS_SHARED_RENAME = exports.ENDPOINT_REST_LABELS_SHARED = exports.ENDPOINT_REST_LABELS_SEARCH = exports.ENDPOINT_REST_LABELS = exports.ENDPOINT_REST_SECTIONS_SEARCH = exports.ENDPOINT_REST_SECTIONS = exports.ENDPOINT_REST_TASKS_COMPLETED_SEARCH = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE = exports.ENDPOINT_REST_TASKS_FILTER = exports.ENDPOINT_REST_TASKS = exports.API_BASE_URI = exports.API_VERSION = exports.TODOIST_WEB_URI = void 0;
-exports.ENDPOINT_WORKSPACE_USERS = exports.ENDPOINT_WORKSPACE_PLAN_DETAILS = void 0;
+exports.ENDPOINT_REST_ID_MAPPINGS = exports.ENDPOINT_REST_EMAILS = exports.ENDPOINT_REST_BACKUPS_DOWNLOAD = exports.ENDPOINT_REST_BACKUPS = exports.ENDPOINT_REST_ACCESS_TOKENS_MIGRATE = exports.ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID = exports.ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE = exports.ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE = exports.ENDPOINT_REST_TEMPLATES_URL = exports.ENDPOINT_REST_TEMPLATES_FILE = exports.ENDPOINT_REST_TASKS_COMPLETED = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL = exports.ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE = exports.SECTION_UNARCHIVE = exports.SECTION_ARCHIVE = exports.ENDPOINT_REST_PROJECT_JOIN = exports.ENDPOINT_REST_PROJECT_FULL = exports.ENDPOINT_REST_PROJECTS_PERMISSIONS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT = exports.PROJECT_UNARCHIVE = exports.PROJECT_ARCHIVE = exports.ENDPOINT_REST_UPLOADS = exports.ENDPOINT_REST_ACTIVITIES = exports.ENDPOINT_REST_PRODUCTIVITY = exports.ENDPOINT_REST_USER = exports.ENDPOINT_REST_PROJECT_COLLABORATORS = exports.ENDPOINT_REST_PROJECTS_ARCHIVED = exports.ENDPOINT_REST_PROJECTS_SEARCH = exports.ENDPOINT_REST_PROJECTS = exports.ENDPOINT_REST_TASK_MOVE = exports.ENDPOINT_REST_TASK_REOPEN = exports.ENDPOINT_REST_TASK_CLOSE = exports.ENDPOINT_REST_LOCATION_REMINDERS = exports.ENDPOINT_REST_REMINDERS = exports.ENDPOINT_REST_COMMENTS = exports.ENDPOINT_REST_LABELS_SHARED_REMOVE = exports.ENDPOINT_REST_LABELS_SHARED_RENAME = exports.ENDPOINT_REST_LABELS_SHARED = exports.ENDPOINT_REST_LABELS_SEARCH = exports.ENDPOINT_REST_LABELS = exports.ENDPOINT_REST_SECTIONS_SEARCH = exports.ENDPOINT_REST_SECTIONS = exports.ENDPOINT_REST_TASKS_COMPLETED_SEARCH = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE = exports.ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE = exports.ENDPOINT_REST_TASKS_FILTER = exports.ENDPOINT_REST_TASKS = exports.API_BASE_URI = exports.API_VERSION = exports.TODOIST_WEB_URI = void 0;
+exports.ENDPOINT_WORKSPACE_MEMBERS = exports.ENDPOINT_WORKSPACE_USERS = exports.ENDPOINT_WORKSPACE_PLAN_DETAILS = exports.ENDPOINT_WORKSPACE_LOGO = exports.ENDPOINT_WORKSPACE_JOIN = exports.ENDPOINT_WORKSPACE_INVITATIONS_DELETE = exports.ENDPOINT_WORKSPACE_INVITATIONS_ALL = exports.ENDPOINT_WORKSPACE_INVITATIONS = exports.ENDPOINT_REST_WORKSPACES = exports.ENDPOINT_REVOKE = exports.ENDPOINT_GET_TOKEN = exports.ENDPOINT_AUTHORIZATION = exports.ENDPOINT_SYNC = exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_MOVED_IDS = void 0;
 exports.getSyncBaseUri = getSyncBaseUri;
 exports.getAuthBaseUri = getAuthBaseUri;
 exports.getWorkspaceInvitationAcceptEndpoint = getWorkspaceInvitationAcceptEndpoint;
 exports.getWorkspaceInvitationRejectEndpoint = getWorkspaceInvitationRejectEndpoint;
+exports.getProjectInsightsActivityStatsEndpoint = getProjectInsightsActivityStatsEndpoint;
+exports.getProjectInsightsHealthEndpoint = getProjectInsightsHealthEndpoint;
+exports.getProjectInsightsHealthContextEndpoint = getProjectInsightsHealthContextEndpoint;
+exports.getProjectInsightsProgressEndpoint = getProjectInsightsProgressEndpoint;
+exports.getProjectInsightsHealthAnalyzeEndpoint = getProjectInsightsHealthAnalyzeEndpoint;
+exports.getWorkspaceInsightsEndpoint = getWorkspaceInsightsEndpoint;
+exports.getWorkspaceUserTasksEndpoint = getWorkspaceUserTasksEndpoint;
+exports.getWorkspaceInviteUsersEndpoint = getWorkspaceInviteUsersEndpoint;
+exports.getWorkspaceUserEndpoint = getWorkspaceUserEndpoint;
 exports.getWorkspaceActiveProjectsEndpoint = getWorkspaceActiveProjectsEndpoint;
 exports.getWorkspaceArchivedProjectsEndpoint = getWorkspaceArchivedProjectsEndpoint;
 const BASE_URI = 'https://api.todoist.com';
@@ -58,6 +67,18 @@ exports.SECTION_ARCHIVE = 'archive';
 exports.SECTION_UNARCHIVE = 'unarchive';
 exports.ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE = exports.ENDPOINT_REST_PROJECTS + '/move_to_workspace';
 exports.ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL = exports.ENDPOINT_REST_PROJECTS + '/move_to_personal';
+exports.ENDPOINT_REST_TASKS_COMPLETED = exports.ENDPOINT_REST_TASKS + '/completed';
+exports.ENDPOINT_REST_TEMPLATES_FILE = 'templates/file';
+exports.ENDPOINT_REST_TEMPLATES_URL = 'templates/url';
+exports.ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE = 'templates/create_project_from_file';
+exports.ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE = 'templates/import_into_project_from_file';
+exports.ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID = 'templates/import_into_project_from_template_id';
+exports.ENDPOINT_REST_ACCESS_TOKENS_MIGRATE = 'access_tokens/migrate_personal_token';
+exports.ENDPOINT_REST_BACKUPS = 'backups';
+exports.ENDPOINT_REST_BACKUPS_DOWNLOAD = 'backups/download';
+exports.ENDPOINT_REST_EMAILS = 'emails';
+exports.ENDPOINT_REST_ID_MAPPINGS = 'id_mappings';
+exports.ENDPOINT_REST_MOVED_IDS = 'moved_ids';
 exports.ENDPOINT_SYNC_QUICK_ADD = exports.ENDPOINT_REST_TASKS + '/quick';
 exports.ENDPOINT_SYNC = 'sync';
 exports.ENDPOINT_AUTHORIZATION = 'authorize';
@@ -79,6 +100,37 @@ function getWorkspaceInvitationAcceptEndpoint(inviteCode) {
 function getWorkspaceInvitationRejectEndpoint(inviteCode) {
     return `workspaces/invitations/${inviteCode}/reject`;
 }
+// Insights endpoints
+function getProjectInsightsActivityStatsEndpoint(projectId) {
+    return `projects/${projectId}/insights/activity_stats`;
+}
+function getProjectInsightsHealthEndpoint(projectId) {
+    return `projects/${projectId}/insights/health`;
+}
+function getProjectInsightsHealthContextEndpoint(projectId) {
+    return `projects/${projectId}/insights/health/context`;
+}
+function getProjectInsightsProgressEndpoint(projectId) {
+    return `projects/${projectId}/insights/progress`;
+}
+function getProjectInsightsHealthAnalyzeEndpoint(projectId) {
+    return `projects/${projectId}/insights/health/analyze`;
+}
+function getWorkspaceInsightsEndpoint(workspaceId) {
+    return `workspaces/${workspaceId}/insights`;
+}
+// Workspace members
+exports.ENDPOINT_WORKSPACE_MEMBERS = 'workspaces/members';
+// Workspace user management (require workspace_id and/or user_id parameters)
+function getWorkspaceUserTasksEndpoint(workspaceId, userId) {
+    return `workspaces/${workspaceId}/users/${userId}/tasks`;
+}
+function getWorkspaceInviteUsersEndpoint(workspaceId) {
+    return `workspaces/${workspaceId}/users/invite`;
+}
+function getWorkspaceUserEndpoint(workspaceId, userId) {
+    return `workspaces/${workspaceId}/users/${userId}`;
+}
 // Workspace projects (require workspace_id parameter)
 function getWorkspaceActiveProjectsEndpoint(workspaceId) {
     return `workspaces/${workspaceId}/projects/active`;