@doist/todoist-api-typescript 7.5.0 → 7.6.0

package/dist/esm/todoist-api.js

@@ -13,10 +13,11 @@ import { DueDateSchema, } from './types/entities.js';
 import { LOCATION_TRIGGERS } from './types/sync/resources/reminders.js';
 import { REMINDER_DELIVERY_SERVICES, } from './types/requests.js';
 import { request, isSuccess } from './transport/http-client.js';
-import { getSyncBaseUri, ENDPOINT_REST_TASKS, ENDPOINT_REST_TASKS_FILTER, ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE, ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE, ENDPOINT_REST_TASKS_COMPLETED_SEARCH, ENDPOINT_REST_PROJECTS, ENDPOINT_REST_PROJECTS_SEARCH, ENDPOINT_SYNC_QUICK_ADD, ENDPOINT_REST_TASK_CLOSE, ENDPOINT_REST_TASK_REOPEN, ENDPOINT_REST_TASK_MOVE, ENDPOINT_REST_LABELS, ENDPOINT_REST_LABELS_SEARCH, ENDPOINT_REST_PROJECT_COLLABORATORS, ENDPOINT_REST_SECTIONS, ENDPOINT_REST_SECTIONS_SEARCH, ENDPOINT_REST_COMMENTS, ENDPOINT_REST_LOCATION_REMINDERS, ENDPOINT_REST_REMINDERS, ENDPOINT_REST_LABELS_SHARED, ENDPOINT_REST_LABELS_SHARED_RENAME, ENDPOINT_REST_LABELS_SHARED_REMOVE, ENDPOINT_SYNC, PROJECT_ARCHIVE, PROJECT_UNARCHIVE, ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE, ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL, ENDPOINT_REST_PROJECTS_ARCHIVED, ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT, ENDPOINT_REST_PROJECTS_PERMISSIONS, ENDPOINT_REST_PROJECT_FULL, ENDPOINT_REST_PROJECT_JOIN, SECTION_ARCHIVE, SECTION_UNARCHIVE, ENDPOINT_REST_USER, ENDPOINT_REST_PRODUCTIVITY, ENDPOINT_REST_ACTIVITIES, ENDPOINT_REST_UPLOADS, ENDPOINT_REST_WORKSPACES, ENDPOINT_WORKSPACE_INVITATIONS, ENDPOINT_WORKSPACE_INVITATIONS_ALL, ENDPOINT_WORKSPACE_INVITATIONS_DELETE, getWorkspaceInvitationAcceptEndpoint, getWorkspaceInvitationRejectEndpoint, ENDPOINT_WORKSPACE_JOIN, ENDPOINT_WORKSPACE_LOGO, ENDPOINT_WORKSPACE_PLAN_DETAILS, ENDPOINT_WORKSPACE_USERS, getWorkspaceActiveProjectsEndpoint, getWorkspaceArchivedProjectsEndpoint, } from './consts/endpoints.js';
-import { validateAttachment, validateComment, validateCommentArray, validateCurrentUser, validateLabel, validateLabelArray, validateProject, validateProjectArray, validateSection, validateSectionArray, validateTask, validateTaskArray, validateUserArray, validateProductivityStats, validateReminder, validateActivityEventArray, validateWorkspaceUserArray, validateWorkspaceInvitation, validateWorkspaceInvitationArray, validateWorkspacePlanDetails, validateJoinWorkspaceResult, validateWorkspace, validateWorkspaceArray, } from './utils/validators.js';
+import { getSyncBaseUri, ENDPOINT_REST_TASKS, ENDPOINT_REST_TASKS_FILTER, ENDPOINT_REST_TASKS_COMPLETED_BY_COMPLETION_DATE, ENDPOINT_REST_TASKS_COMPLETED_BY_DUE_DATE, ENDPOINT_REST_TASKS_COMPLETED_SEARCH, ENDPOINT_REST_TASKS_COMPLETED, ENDPOINT_REST_TEMPLATES_FILE, ENDPOINT_REST_TEMPLATES_URL, ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID, ENDPOINT_REST_PROJECTS, ENDPOINT_REST_PROJECTS_SEARCH, ENDPOINT_SYNC_QUICK_ADD, ENDPOINT_REST_TASK_CLOSE, ENDPOINT_REST_TASK_REOPEN, ENDPOINT_REST_TASK_MOVE, ENDPOINT_REST_LABELS, ENDPOINT_REST_LABELS_SEARCH, ENDPOINT_REST_PROJECT_COLLABORATORS, ENDPOINT_REST_SECTIONS, ENDPOINT_REST_SECTIONS_SEARCH, ENDPOINT_REST_COMMENTS, ENDPOINT_REST_LOCATION_REMINDERS, ENDPOINT_REST_REMINDERS, ENDPOINT_REST_LABELS_SHARED, ENDPOINT_REST_LABELS_SHARED_RENAME, ENDPOINT_REST_LABELS_SHARED_REMOVE, ENDPOINT_SYNC, PROJECT_ARCHIVE, PROJECT_UNARCHIVE, ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE, ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL, ENDPOINT_REST_PROJECTS_ARCHIVED, ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT, ENDPOINT_REST_PROJECTS_PERMISSIONS, ENDPOINT_REST_PROJECT_FULL, ENDPOINT_REST_PROJECT_JOIN, SECTION_ARCHIVE, SECTION_UNARCHIVE, ENDPOINT_REST_USER, ENDPOINT_REST_PRODUCTIVITY, ENDPOINT_REST_ACTIVITIES, ENDPOINT_REST_UPLOADS, getProjectInsightsActivityStatsEndpoint, getProjectInsightsHealthEndpoint, getProjectInsightsHealthContextEndpoint, getProjectInsightsProgressEndpoint, getProjectInsightsHealthAnalyzeEndpoint, getWorkspaceInsightsEndpoint, ENDPOINT_REST_BACKUPS, ENDPOINT_REST_BACKUPS_DOWNLOAD, ENDPOINT_REST_EMAILS, ENDPOINT_REST_ID_MAPPINGS, ENDPOINT_REST_MOVED_IDS, ENDPOINT_REST_WORKSPACES, ENDPOINT_WORKSPACE_MEMBERS, getWorkspaceUserTasksEndpoint, getWorkspaceInviteUsersEndpoint, getWorkspaceUserEndpoint, ENDPOINT_WORKSPACE_INVITATIONS, ENDPOINT_WORKSPACE_INVITATIONS_ALL, ENDPOINT_WORKSPACE_INVITATIONS_DELETE, getWorkspaceInvitationAcceptEndpoint, getWorkspaceInvitationRejectEndpoint, ENDPOINT_WORKSPACE_JOIN, ENDPOINT_WORKSPACE_LOGO, ENDPOINT_WORKSPACE_PLAN_DETAILS, ENDPOINT_WORKSPACE_USERS, getWorkspaceActiveProjectsEndpoint, getWorkspaceArchivedProjectsEndpoint, } from './consts/endpoints.js';
+import { validateAttachment, validateComment, validateCommentArray, validateCurrentUser, validateLabel, validateLabelArray, validateProject, validateProjectArray, validateSection, validateSectionArray, validateTask, validateTaskArray, validateUserArray, validateProductivityStats, validateReminder, validateReminderArray, validateLocationReminderArray, validateActivityEventArray, validateWorkspaceUserArray, validateWorkspaceInvitation, validateWorkspaceInvitationArray, validateWorkspacePlanDetails, validateJoinWorkspaceResult, validateWorkspace, validateWorkspaceArray, validateMemberActivityInfoArray, validateWorkspaceUserTaskArray, validateProjectActivityStats, validateProjectHealth, validateProjectHealthContext, validateProjectProgress, validateWorkspaceInsights, validateBackupArray, validateIdMappingArray, validateMovedIdArray, } from './utils/validators.js';
 import { formatDateToYYYYMMDD } from './utils/url-helpers.js';
 import { uploadMultipartFile } from './utils/multipart-upload.js';
+import { camelCaseKeys } from './utils/case-conversion.js';
 import { normalizeObjectEventTypeForApi, denormalizeObjectTypeFromApi, } from './utils/activity-helpers.js';
 import { processTaskContent } from './utils/uncompletable-helpers.js';
 import { z } from 'zod';
@@ -344,6 +345,30 @@ export class TodoistApi {
             nextCursor,
         };
     }
+    /**
+     * Retrieves all completed tasks with optional filters.
+     *
+     * Uses offset-based pagination rather than cursor-based.
+     *
+     * @param args - Optional parameters including project ID, label, date range, and pagination.
+     * @returns A promise that resolves to completed tasks with associated project and section data.
+     */
+    async getAllCompletedTasks(args = {}) {
+        const { since, until } = args, rest = __rest(args, ["since", "until"]);
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_TASKS_COMPLETED,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign(Object.assign(Object.assign({}, rest), (since ? { since: since.toISOString() } : {})), (until ? { until: until.toISOString() } : {})),
+        });
+        return {
+            projects: data.projects,
+            sections: data.sections,
+            items: validateTaskArray(data.items),
+        };
+    }
     /**
      * Creates a new task with the provided parameters.
      *
@@ -835,6 +860,116 @@ export class TodoistApi {
             nextCursor,
         };
     }
+    // ── Insights ──
+    /**
+     * Retrieves activity statistics for a project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @param args - Optional parameters including weeks and weekly counts flag.
+     * @returns A promise that resolves to the project activity stats.
+     */
+    async getProjectActivityStats(projectId, args = {}) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsActivityStatsEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign({ objectType: 'ITEM', eventType: 'COMPLETED' }, args),
+        });
+        return validateProjectActivityStats(response.data);
+    }
+    /**
+     * Retrieves the health status of a project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @returns A promise that resolves to the project health data.
+     */
+    async getProjectHealth(projectId) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsHealthEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateProjectHealth(response.data);
+    }
+    /**
+     * Retrieves the health context for a project, including metrics and task details.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @returns A promise that resolves to the project health context.
+     */
+    async getProjectHealthContext(projectId) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsHealthContextEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateProjectHealthContext(response.data);
+    }
+    /**
+     * Retrieves progress information for a project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @returns A promise that resolves to the project progress data.
+     */
+    async getProjectProgress(projectId) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsProgressEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateProjectProgress(response.data);
+    }
+    /**
+     * Retrieves insights for all projects in a workspace.
+     *
+     * @param workspaceId - The unique identifier of the workspace.
+     * @param args - Optional parameters including project IDs filter.
+     * @returns A promise that resolves to workspace insights data.
+     */
+    async getWorkspaceInsights(workspaceId, args = {}) {
+        z.string().parse(workspaceId);
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceInsightsEndpoint(workspaceId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign(Object.assign({}, args), (args.projectIds ? { projectIds: args.projectIds.join(',') } : {})),
+        });
+        return validateWorkspaceInsights(response.data);
+    }
+    /**
+     * Triggers a health analysis for a project.
+     *
+     * @param projectId - The unique identifier of the project.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated project health data.
+     */
+    async analyzeProjectHealth(projectId, requestId) {
+        z.string().parse(projectId);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: getProjectInsightsHealthAnalyzeEndpoint(projectId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return validateProjectHealth(response.data);
+    }
+    // ── Sections ──
     /**
      * Retrieves all sections within a specific project or matching criteria.
      *
@@ -1253,6 +1388,46 @@ export class TodoistApi {
         });
         return isSuccess(response);
     }
+    /**
+     * Retrieves a paginated list of time-based reminders.
+     *
+     * @param args - Optional parameters including task ID filter and pagination.
+     * @returns A promise that resolves to a paginated list of reminders.
+     */
+    async getReminders(args = {}) {
+        const { data: { results, nextCursor }, } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_REMINDERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            results: validateReminderArray(results),
+            nextCursor,
+        };
+    }
+    /**
+     * Retrieves a paginated list of location-based reminders.
+     *
+     * @param args - Optional parameters including task ID filter and pagination.
+     * @returns A promise that resolves to a paginated list of location reminders.
+     */
+    async getLocationReminders(args = {}) {
+        const { data: { results, nextCursor }, } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_LOCATION_REMINDERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return {
+            results: validateLocationReminderArray(results),
+            nextCursor,
+        };
+    }
     /**
      * Retrieves a time-based reminder by its ID.
      *
@@ -1666,6 +1841,246 @@ export class TodoistApi {
             arrayBuffer: () => response.arrayBuffer(),
         };
     }
+    // ── Backups ──
+    /**
+     * Retrieves a list of available backups.
+     *
+     * @param args - Optional parameters including MFA token.
+     * @returns A promise that resolves to an array of backups.
+     */
+    async getBackups(args = {}) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_BACKUPS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return validateBackupArray(response.data);
+    }
+    /**
+     * Downloads a backup file as binary data.
+     *
+     * @param args - Arguments including the backup file URL (from getBackups).
+     * @returns A promise that resolves to a response with binary data accessible via arrayBuffer().
+     */
+    async downloadBackup(args) {
+        const url = `${this.syncApiBase}${ENDPOINT_REST_BACKUPS_DOWNLOAD}?file=${encodeURIComponent(args.file)}`;
+        const fetchOptions = {
+            headers: { Authorization: `Bearer ${this.authToken}` },
+        };
+        if (this.customFetch) {
+            const response = await this.customFetch(url, fetchOptions);
+            if (!response.ok) {
+                throw new Error(`Failed to download backup: ${response.status} ${response.statusText}`);
+            }
+            const text = await response.text();
+            const buffer = new TextEncoder().encode(text).buffer;
+            return {
+                ok: response.ok,
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+                text: () => Promise.resolve(text),
+                json: () => response.json(),
+                arrayBuffer: () => Promise.resolve(buffer),
+            };
+        }
+        const response = await fetch(url, fetchOptions);
+        if (!response.ok) {
+            throw new Error(`Failed to download backup: ${response.status} ${response.statusText}`);
+        }
+        return {
+            ok: response.ok,
+            status: response.status,
+            statusText: response.statusText,
+            headers: headersToRecord(response.headers),
+            text: () => response.text(),
+            json: () => response.json(),
+            arrayBuffer: () => response.arrayBuffer(),
+        };
+    }
+    // ── Emails ──
+    /**
+     * Gets or creates an email forwarding address for an object.
+     *
+     * @param args - Arguments including object type and ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the email address.
+     */
+    async getOrCreateEmailForwarding(args, requestId) {
+        const { data } = await request({
+            httpMethod: 'PUT',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_EMAILS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return data;
+    }
+    /**
+     * Disables email forwarding for an object.
+     *
+     * @param args - Arguments including object type and ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async disableEmailForwarding(args, requestId) {
+        const queryParams = new URLSearchParams({
+            obj_type: args.objType,
+            obj_id: args.objId,
+        });
+        const response = await request({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: `${ENDPOINT_REST_EMAILS}?${queryParams.toString()}`,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return isSuccess(response);
+    }
+    // ── ID Mappings ──
+    /**
+     * Retrieves ID mappings between old and new IDs.
+     *
+     * @param args - Arguments including object type and IDs to look up.
+     * @returns A promise that resolves to an array of ID mappings.
+     */
+    async getIdMappings(args) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_ID_MAPPINGS, args.objName, args.objIds.join(',')),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+        });
+        return validateIdMappingArray(response.data);
+    }
+    /**
+     * Retrieves moved IDs for objects that have been migrated.
+     *
+     * @param args - Arguments including object type and optional old IDs to look up.
+     * @returns A promise that resolves to an array of moved ID pairs.
+     */
+    async getMovedIds(args) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: generatePath(ENDPOINT_REST_MOVED_IDS, args.objName),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args.oldIds ? { oldIds: args.oldIds.join(',') } : undefined,
+        });
+        return validateMovedIdArray(response.data);
+    }
+    // ── Templates ──
+    /**
+     * Exports a project as a template file (CSV format).
+     *
+     * @param args - Arguments including project ID and optional date format preference.
+     * @returns A promise that resolves to the template file content as a string.
+     */
+    async exportTemplateAsFile(args) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_TEMPLATES_FILE,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return response.data;
+    }
+    /**
+     * Exports a project as a template URL.
+     *
+     * @param args - Arguments including project ID and optional date format preference.
+     * @returns A promise that resolves to the file name and URL.
+     */
+    async exportTemplateAsUrl(args) {
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_TEMPLATES_URL,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return data;
+    }
+    /**
+     * Creates a new project from a template file.
+     *
+     * @param args - Arguments including project name, template file, and optional workspace ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created project data.
+     */
+    async createProjectFromTemplate(args, requestId) {
+        const { file, fileName, name, workspaceId } = args;
+        const additionalFields = { name };
+        if (workspaceId !== undefined && workspaceId !== null) {
+            additionalFields.workspace_id = workspaceId;
+        }
+        const data = await uploadMultipartFile({
+            baseUrl: this.syncApiBase,
+            authToken: this.authToken,
+            endpoint: ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE,
+            file,
+            fileName,
+            additionalFields,
+            customFetch: this.customFetch,
+            requestId,
+        });
+        return this.validateTemplateResponse(camelCaseKeys(data));
+    }
+    /**
+     * Imports a template file into an existing project.
+     *
+     * @param args - Arguments including project ID and template file.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the import result.
+     */
+    async importTemplateIntoProject(args, requestId) {
+        const { file, fileName, projectId } = args;
+        const data = await uploadMultipartFile({
+            baseUrl: this.syncApiBase,
+            authToken: this.authToken,
+            endpoint: ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE,
+            file,
+            fileName,
+            additionalFields: { project_id: projectId },
+            customFetch: this.customFetch,
+            requestId,
+        });
+        return this.validateTemplateResponse(camelCaseKeys(data));
+    }
+    /**
+     * Imports a template by ID into an existing project.
+     *
+     * @param args - Arguments including project ID, template ID, and optional locale.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the import result.
+     */
+    async importTemplateFromId(args, requestId) {
+        const { data } = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+            requestId: requestId,
+        });
+        return this.validateTemplateResponse(data);
+    }
+    validateTemplateResponse(data) {
+        var _a, _b, _c, _d;
+        return Object.assign(Object.assign({}, data), { projects: validateProjectArray((_a = data.projects) !== null && _a !== void 0 ? _a : []), sections: validateSectionArray((_b = data.sections) !== null && _b !== void 0 ? _b : []), tasks: validateTaskArray((_c = data.tasks) !== null && _c !== void 0 ? _c : []), comments: validateCommentArray((_d = data.comments) !== null && _d !== void 0 ? _d : []) });
+    }
     /* Workspace methods */
     /**
      * Gets pending invitations for a workspace.
@@ -1990,6 +2405,109 @@ export class TodoistApi {
         });
         return isSuccess(response);
     }
+    /**
+     * Retrieves activity information for workspace members.
+     *
+     * @param args - Arguments including workspace ID and optional user/project filters.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to workspace members activity data.
+     */
+    async getWorkspaceMembersActivity(args, requestId) {
+        const { workspaceId } = args, queryParams = __rest(args, ["workspaceId"]);
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_WORKSPACE_MEMBERS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: Object.assign({ workspaceId }, queryParams),
+            requestId: requestId,
+        });
+        return {
+            members: validateMemberActivityInfoArray(data.members),
+        };
+    }
+    /**
+     * Retrieves tasks assigned to a specific user in a workspace.
+     *
+     * @param args - Arguments including workspace ID, user ID, and optional project filter.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to workspace user tasks.
+     */
+    async getWorkspaceUserTasks(args, requestId) {
+        const { workspaceId, userId } = args, queryParams = __rest(args, ["workspaceId", "userId"]);
+        const { data } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceUserTasksEndpoint(workspaceId, userId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: queryParams,
+            requestId: requestId,
+        });
+        return {
+            tasks: validateWorkspaceUserTaskArray(data.tasks),
+        };
+    }
+    /**
+     * Invites users to a workspace by email.
+     *
+     * @param args - Arguments including workspace ID, email list, and optional role.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the list of invited emails.
+     */
+    async inviteWorkspaceUsers(args, requestId) {
+        const { workspaceId } = args, payload = __rest(args, ["workspaceId"]);
+        const { data } = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceInviteUsersEndpoint(workspaceId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: payload,
+            requestId: requestId,
+        });
+        return data;
+    }
+    /**
+     * Updates a workspace user's role.
+     *
+     * @param args - Arguments including workspace ID, user ID, and new role.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated workspace user view.
+     */
+    async updateWorkspaceUser(args, requestId) {
+        const { workspaceId, userId } = args, payload = __rest(args, ["workspaceId", "userId"]);
+        const response = await request({
+            httpMethod: 'POST',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceUserEndpoint(workspaceId, userId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: payload,
+            requestId: requestId,
+        });
+        return validateJoinWorkspaceResult(response.data);
+    }
+    /**
+     * Removes a user from a workspace.
+     *
+     * @param args - Arguments including workspace ID and user ID.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
+    async removeWorkspaceUser(args, requestId) {
+        const { workspaceId, userId } = args;
+        const response = await request({
+            httpMethod: 'DELETE',
+            baseUri: this.syncApiBase,
+            relativePath: getWorkspaceUserEndpoint(workspaceId, userId),
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            requestId: requestId,
+        });
+        return isSuccess(response);
+    }
     /**
      * Gets active projects in a workspace with pagination.
      *

package/dist/esm/types/entities.js

@@ -432,3 +432,117 @@ export const WorkspaceSchema = z.object({
     creatorId: z.string(),
     properties: WorkspacePropertiesSchema,
 });
+export const MemberActivityInfoSchema = z.object({
+    userId: z.string(),
+    tasksAssigned: z.number().int(),
+    tasksOverdue: z.number().int(),
+});
+export const WorkspaceUserTaskSchema = z.object({
+    id: z.string(),
+    content: z.string(),
+    responsibleUid: z.string().nullable(),
+    due: DueDateSchema.nullable(),
+    deadline: DeadlineSchema.nullable(),
+    labels: z.array(z.string()),
+    notesCount: z.number().int(),
+    projectId: z.string(),
+    projectName: z.string(),
+    priority: z.number().int(),
+    description: z.string(),
+    isOverdue: z.boolean(),
+});
+// Insights entities
+export const DayActivitySchema = z.object({
+    date: z.string(),
+    totalCount: z.number().int(),
+});
+export const WeekRollupSchema = z.object({
+    fromDate: z.string(),
+    toDate: z.string(),
+    totalCount: z.number().int(),
+});
+export const ProjectActivityStatsSchema = z.object({
+    dayItems: z.array(DayActivitySchema),
+    weekItems: z.array(WeekRollupSchema).nullable(),
+});
+/** Available project health statuses. */
+export const HEALTH_STATUSES = [
+    'UNKNOWN',
+    'ON_TRACK',
+    'AT_RISK',
+    'CRITICAL',
+    'EXCELLENT',
+    'ERROR',
+];
+export const TaskRecommendationSchema = z.object({
+    taskId: z.string(),
+    recommendation: z.string(),
+});
+export const ProjectHealthSchema = z.object({
+    status: z.enum(HEALTH_STATUSES),
+    description: z.string().nullable().optional(),
+    descriptionSummary: z.string().nullable().optional(),
+    taskRecommendations: z.array(TaskRecommendationSchema).nullable().optional(),
+    projectId: z.string().nullable().optional(),
+    updatedAt: z.string().nullable().optional(),
+    isStale: z.boolean().default(false),
+    updateInProgress: z.boolean().default(false),
+});
+export const ProjectMetricsSchema = z.object({
+    totalTasks: z.number().int(),
+    completedTasks: z.number().int(),
+    overdueTasks: z.number().int(),
+    tasksCreatedThisWeek: z.number().int(),
+    tasksCompletedThisWeek: z.number().int(),
+    averageCompletionTime: z.number().nullable(),
+});
+export const TaskContextSchema = z.object({
+    id: z.string(),
+    content: z.string(),
+    due: z.string().nullable().optional(),
+    deadline: z.string().nullable().optional(),
+    priority: z.string(),
+    isCompleted: z.boolean(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    completedAt: z.string().nullable(),
+    completedByUid: z.string().nullable(),
+    labels: z.array(z.string()),
+});
+export const ProjectHealthContextSchema = z.object({
+    projectId: z.string(),
+    projectName: z.string(),
+    projectDescription: z.string().nullable(),
+    projectMetrics: ProjectMetricsSchema,
+    tasks: z.array(TaskContextSchema),
+    language: z.string().nullable().optional(),
+});
+export const ProjectProgressSchema = z.object({
+    projectId: z.string(),
+    completedCount: z.number().int(),
+    activeCount: z.number().int(),
+    progressPercent: z.number().int(),
+});
+export const ProjectInsightSchema = z.object({
+    projectId: z.string(),
+    health: ProjectHealthSchema.nullable(),
+    progress: ProjectProgressSchema.nullable(),
+});
+export const WorkspaceInsightsSchema = z.object({
+    folderId: z.string().nullable(),
+    projectInsights: z.array(ProjectInsightSchema),
+});
+// Backups
+export const BackupSchema = z.object({
+    version: z.string(),
+    url: z.string(),
+});
+// ID Mappings
+export const IdMappingSchema = z.object({
+    oldId: z.string().nullable(),
+    newId: z.string().nullable(),
+});
+export const MovedIdSchema = z.object({
+    oldId: z.string(),
+    newId: z.string(),
+});