@doist/todoist-sdk 8.0.0 → 8.1.0

package/dist/cjs/authentication.js

@@ -1,11 +1,23 @@
 "use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PERMISSIONS = void 0;
+exports.TOKEN_ENDPOINT_AUTH_METHODS = exports.PERMISSIONS = void 0;
 exports.getAuthStateParameter = getAuthStateParameter;
 exports.getAuthorizationUrl = getAuthorizationUrl;
 exports.getAuthToken = getAuthToken;
 exports.revokeToken = revokeToken;
 exports.migratePersonalToken = migratePersonalToken;
+exports.registerClient = registerClient;
 const http_client_1 = require("./transport/http-client");
 const uuid_1 = require("uuid");
 const types_1 = require("./types");
@@ -19,6 +31,12 @@ exports.PERMISSIONS = [
     'project:delete',
     'backups:read',
 ];
+/** Supported token endpoint authentication methods for dynamic client registration. */
+exports.TOKEN_ENDPOINT_AUTH_METHODS = [
+    'client_secret_post',
+    'client_secret_basic',
+    'none',
+];
 /**
  * Creates a Basic Authentication header value from client credentials.
  * @param clientId - The OAuth client ID
@@ -48,13 +66,17 @@ function getAuthStateParameter() {
 /**
  * Generates the authorization URL for the OAuth2 flow.
  *
+ * The `clientId` can be either a traditional client ID string (e.g. from
+ * {@link registerClient}) or an HTTPS URL pointing to a client metadata document,
+ * as defined in {@link https://drafts.ietf.org/doc/draft-ietf-oauth-client-id-metadata-document/ RFC draft-ietf-oauth-client-id-metadata-document}.
+ *
  * @example
  * ```typescript
- * const url = getAuthorizationUrl(
- *   'your-client-id',
- *   ['data:read', 'task:add'],
- *   state
- * )
+ * const url = getAuthorizationUrl({
+ *   clientId: 'your-client-id',
+ *   permissions: ['data:read', 'task:add'],
+ *   state,
+ * })
  * // Redirect user to url
  * ```
  *
@@ -66,7 +88,7 @@ function getAuthorizationUrl({ clientId, permissions, state, baseUrl, }) {
         throw new Error('At least one scope value should be passed for permissions.');
     }
     const scope = permissions.join(',');
-    return `${(0, endpoints_1.getAuthBaseUri)(baseUrl)}${endpoints_1.ENDPOINT_AUTHORIZATION}?client_id=${clientId}&scope=${scope}&state=${state}`;
+    return `${(0, endpoints_1.getAuthBaseUri)(baseUrl)}${endpoints_1.ENDPOINT_AUTHORIZATION}?client_id=${encodeURIComponent(clientId)}&scope=${scope}&state=${state}`;
 }
 /**
  * Exchanges an authorization code for an access token.
@@ -202,3 +224,48 @@ async function migratePersonalToken(args, options) {
         throw new types_1.TodoistRequestError('Personal token migration failed.', err.httpStatusCode, err.responseData);
     }
 }
+/**
+ * Registers a new OAuth client via Dynamic Client Registration (RFC 7591).
+ *
+ * @example
+ * ```typescript
+ * const client = await registerClient({
+ *   redirectUris: ['https://example.com/callback'],
+ *   clientName: 'My App',
+ *   scope: ['data:read_write', 'task:add'],
+ * })
+ * // Use client.clientId and client.clientSecret for OAuth flows
+ * ```
+ *
+ * @returns The registered client details
+ * @throws {@link TodoistRequestError} If the registration fails
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc7591 RFC 7591}
+ */
+async function registerClient(args, options) {
+    var _a, _b;
+    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.getAuthBaseUri)(baseUrl),
+            relativePath: endpoints_1.ENDPOINT_REGISTER,
+            apiToken: undefined,
+            payload: Object.assign(Object.assign({}, args), { scope: (_a = args.scope) === null || _a === void 0 ? void 0 : _a.join(' ') }),
+            customFetch,
+        });
+        if (!(0, http_client_1.isSuccess)(response) || !((_b = response.data) === null || _b === void 0 ? void 0 : _b.clientId)) {
+            throw new types_1.TodoistRequestError('Dynamic client registration failed.', response.status, response.data);
+        }
+        const _c = response.data, { clientIdIssuedAt, clientSecretExpiresAt, scope } = _c, rest = __rest(_c, ["clientIdIssuedAt", "clientSecretExpiresAt", "scope"]);
+        return Object.assign(Object.assign({}, rest), { scope: scope ? scope.split(' ') : undefined, clientIdIssuedAt: clientIdIssuedAt !== undefined ? new Date(clientIdIssuedAt * 1000) : undefined, clientSecretExpiresAt: clientSecretExpiresAt === undefined
+                ? undefined
+                : clientSecretExpiresAt === 0
+                    ? null
+                    : new Date(clientSecretExpiresAt * 1000) });
+    }
+    catch (error) {
+        const err = error;
+        throw new types_1.TodoistRequestError('Dynamic client registration failed.', err.httpStatusCode, err.responseData);
+    }
+}

package/dist/cjs/consts/endpoints.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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_REST_FOLDERS = 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.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_REST_FOLDERS = exports.ENDPOINT_REGISTER = 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;
@@ -84,6 +84,7 @@ exports.ENDPOINT_SYNC = 'sync';
 exports.ENDPOINT_AUTHORIZATION = 'authorize';
 exports.ENDPOINT_GET_TOKEN = 'access_token';
 exports.ENDPOINT_REVOKE = 'revoke';
+exports.ENDPOINT_REGISTER = 'register';
 exports.ENDPOINT_REST_FOLDERS = 'folders';
 // Workspace endpoints
 exports.ENDPOINT_REST_WORKSPACES = 'workspaces';

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.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_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;
 const url_helpers_1 = require("../utils/url-helpers");
 exports.DEFAULT_TASK_ID = '1234';
 exports.DEFAULT_TASK_CONTENT = 'This is a task';
@@ -131,6 +131,32 @@ exports.DEFAULT_PROJECT = {
 };
 exports.INVALID_PROJECT = Object.assign(Object.assign({}, exports.DEFAULT_PROJECT), { name: 123 });
 exports.PROJECT_WITH_OPTIONALS_AS_NULL = Object.assign(Object.assign({}, exports.DEFAULT_PROJECT), { parentId: null });
+exports.DEFAULT_WORKSPACE_PROJECT = {
+    id: exports.DEFAULT_PROJECT_ID,
+    name: exports.DEFAULT_PROJECT_NAME,
+    color: DEFAULT_ENTITY_COLOR,
+    childOrder: exports.DEFAULT_ORDER,
+    isFavorite: false,
+    isShared: true,
+    viewStyle: exports.DEFAULT_PROJECT_VIEW_STYLE,
+    canAssignTasks: DEFAULT_CAN_ASSIGN_TASKS,
+    isArchived: DEFAULT_IS_ARCHIVED,
+    isDeleted: DEFAULT_IS_DELETED,
+    isFrozen: DEFAULT_IS_FROZEN,
+    createdAt: DEFAULT_DATE,
+    updatedAt: DEFAULT_DATE,
+    defaultOrder: exports.DEFAULT_ORDER,
+    description: '',
+    isCollapsed: DEFAULT_IS_COLLAPSED,
+    url: DEFAULT_PROJECT_URL,
+    workspaceId: '100',
+    folderId: null,
+    collaboratorRoleDefault: 'READ_WRITE',
+    isInviteOnly: false,
+    isLinkSharingEnabled: true,
+    role: 'ADMIN',
+    status: 'ACTIVE',
+};
 exports.DEFAULT_SECTION = {
     id: DEFAULT_SECTION_ID,
     userId: DEFAULT_USER_ID,
@@ -238,3 +264,27 @@ exports.DEFAULT_FOLDER = {
     childOrder: 3,
     isDeleted: false,
 };
+exports.DEFAULT_COLLABORATOR = {
+    id: DEFAULT_USER_ID,
+    email: DEFAULT_USER_EMAIL,
+    fullName: DEFAULT_USER_NAME,
+    timezone: 'UTC',
+    imageId: null,
+};
+exports.DEFAULT_COLLABORATOR_STATE = {
+    userId: DEFAULT_USER_ID,
+    projectId: exports.DEFAULT_PROJECT_ID,
+    state: 'active',
+    isDeleted: false,
+};
+exports.DEFAULT_NOTE = {
+    id: DEFAULT_COMMENT_ID,
+    projectId: exports.DEFAULT_PROJECT_ID,
+    content: DEFAULT_COMMENT_CONTENT,
+    postedAt: DEFAULT_DATE,
+    fileAttachment: exports.DEFAULT_ATTACHMENT,
+    postedUid: DEFAULT_USER_ID,
+    uidsToNotify: null,
+    reactions: DEFAULT_COMMENT_REACTIONS,
+    isDeleted: false,
+};

package/dist/cjs/todoist-api.js

@@ -12,6 +12,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TodoistApi = void 0;
+const projects_1 = require("./types/projects");
 const reminders_1 = require("./types/reminders");
 const http_client_1 = require("./transport/http-client");
 const endpoints_1 = require("./consts/endpoints");
@@ -771,15 +772,18 @@ class TodoistApi {
         };
     }
     /**
-     * Joins a shared project by its ID.
+     * Joins a workspace project.
      *
-     * @param id - The unique identifier of the project to join.
+     * Only used for workspaces — this endpoint is used to join a workspace project
+     * by a workspace user.
+     *
+     * @param id - The unique identifier of the workspace project to join.
      * @param requestId - Optional custom identifier for the request.
-     * @returns A promise that resolves to the joined project.
+     * @returns A promise that resolves to the full project data after joining.
      */
     async joinProject(id, requestId) {
         zod_1.z.string().parse(id);
-        const response = await (0, http_client_1.request)({
+        const { data } = await (0, http_client_1.request)({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
             relativePath: generatePath(endpoints_1.ENDPOINT_REST_PROJECTS, id, endpoints_1.ENDPOINT_REST_PROJECT_JOIN),
@@ -787,7 +791,16 @@ class TodoistApi {
             customFetch: this.customFetch,
             requestId: requestId,
         });
-        return (0, validators_1.validateProject)(response.data);
+        return {
+            project: projects_1.WorkspaceProjectSchema.parse(data.project),
+            tasks: (0, validators_1.validateTaskArray)(data.tasks),
+            sections: (0, validators_1.validateSectionArray)(data.sections),
+            comments: (0, validators_1.validateNoteArray)(data.comments),
+            collaborators: (0, validators_1.validateCollaboratorArray)(data.collaborators),
+            collaboratorStates: (0, validators_1.validateCollaboratorStateArray)(data.collaboratorStates),
+            folder: data.folder ? (0, validators_1.validateFolder)(data.folder) : null,
+            subprojects: data.subprojects.map((p) => projects_1.WorkspaceProjectSchema.parse(p)),
+        };
     }
     /**
      * Retrieves a list of collaborators for a specific project.

package/dist/esm/authentication.js

@@ -1,7 +1,18 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { request, isSuccess } from './transport/http-client.js';
 import { v4 as uuid } from 'uuid';
 import { TodoistRequestError } from './types/index.js';
-import { getAuthBaseUri, getSyncBaseUri, ENDPOINT_AUTHORIZATION, ENDPOINT_GET_TOKEN, ENDPOINT_REVOKE, ENDPOINT_REST_ACCESS_TOKENS_MIGRATE, } from './consts/endpoints.js';
+import { getAuthBaseUri, getSyncBaseUri, ENDPOINT_AUTHORIZATION, ENDPOINT_GET_TOKEN, ENDPOINT_REVOKE, ENDPOINT_REGISTER, ENDPOINT_REST_ACCESS_TOKENS_MIGRATE, } from './consts/endpoints.js';
 /** Available OAuth2 permission scopes. */
 export const PERMISSIONS = [
     'task:add',
@@ -11,6 +22,12 @@ export const PERMISSIONS = [
     'project:delete',
     'backups:read',
 ];
+/** Supported token endpoint authentication methods for dynamic client registration. */
+export const TOKEN_ENDPOINT_AUTH_METHODS = [
+    'client_secret_post',
+    'client_secret_basic',
+    'none',
+];
 /**
  * Creates a Basic Authentication header value from client credentials.
  * @param clientId - The OAuth client ID
@@ -40,13 +57,17 @@ export function getAuthStateParameter() {
 /**
  * Generates the authorization URL for the OAuth2 flow.
  *
+ * The `clientId` can be either a traditional client ID string (e.g. from
+ * {@link registerClient}) or an HTTPS URL pointing to a client metadata document,
+ * as defined in {@link https://drafts.ietf.org/doc/draft-ietf-oauth-client-id-metadata-document/ RFC draft-ietf-oauth-client-id-metadata-document}.
+ *
  * @example
  * ```typescript
- * const url = getAuthorizationUrl(
- *   'your-client-id',
- *   ['data:read', 'task:add'],
- *   state
- * )
+ * const url = getAuthorizationUrl({
+ *   clientId: 'your-client-id',
+ *   permissions: ['data:read', 'task:add'],
+ *   state,
+ * })
  * // Redirect user to url
  * ```
  *
@@ -58,7 +79,7 @@ export function getAuthorizationUrl({ clientId, permissions, state, baseUrl, })
         throw new Error('At least one scope value should be passed for permissions.');
     }
     const scope = permissions.join(',');
-    return `${getAuthBaseUri(baseUrl)}${ENDPOINT_AUTHORIZATION}?client_id=${clientId}&scope=${scope}&state=${state}`;
+    return `${getAuthBaseUri(baseUrl)}${ENDPOINT_AUTHORIZATION}?client_id=${encodeURIComponent(clientId)}&scope=${scope}&state=${state}`;
 }
 /**
  * Exchanges an authorization code for an access token.
@@ -194,3 +215,48 @@ export async function migratePersonalToken(args, options) {
         throw new TodoistRequestError('Personal token migration failed.', err.httpStatusCode, err.responseData);
     }
 }
+/**
+ * Registers a new OAuth client via Dynamic Client Registration (RFC 7591).
+ *
+ * @example
+ * ```typescript
+ * const client = await registerClient({
+ *   redirectUris: ['https://example.com/callback'],
+ *   clientName: 'My App',
+ *   scope: ['data:read_write', 'task:add'],
+ * })
+ * // Use client.clientId and client.clientSecret for OAuth flows
+ * ```
+ *
+ * @returns The registered client details
+ * @throws {@link TodoistRequestError} If the registration fails
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc7591 RFC 7591}
+ */
+export async function registerClient(args, options) {
+    var _a, _b;
+    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 request({
+            httpMethod: 'POST',
+            baseUri: getAuthBaseUri(baseUrl),
+            relativePath: ENDPOINT_REGISTER,
+            apiToken: undefined,
+            payload: Object.assign(Object.assign({}, args), { scope: (_a = args.scope) === null || _a === void 0 ? void 0 : _a.join(' ') }),
+            customFetch,
+        });
+        if (!isSuccess(response) || !((_b = response.data) === null || _b === void 0 ? void 0 : _b.clientId)) {
+            throw new TodoistRequestError('Dynamic client registration failed.', response.status, response.data);
+        }
+        const _c = response.data, { clientIdIssuedAt, clientSecretExpiresAt, scope } = _c, rest = __rest(_c, ["clientIdIssuedAt", "clientSecretExpiresAt", "scope"]);
+        return Object.assign(Object.assign({}, rest), { scope: scope ? scope.split(' ') : undefined, clientIdIssuedAt: clientIdIssuedAt !== undefined ? new Date(clientIdIssuedAt * 1000) : undefined, clientSecretExpiresAt: clientSecretExpiresAt === undefined
+                ? undefined
+                : clientSecretExpiresAt === 0
+                    ? null
+                    : new Date(clientSecretExpiresAt * 1000) });
+    }
+    catch (error) {
+        const err = error;
+        throw new TodoistRequestError('Dynamic client registration failed.', err.httpStatusCode, err.responseData);
+    }
+}

package/dist/esm/consts/endpoints.js

@@ -65,6 +65,7 @@ export const ENDPOINT_SYNC = 'sync';
 export const ENDPOINT_AUTHORIZATION = 'authorize';
 export const ENDPOINT_GET_TOKEN = 'access_token';
 export const ENDPOINT_REVOKE = 'revoke';
+export const ENDPOINT_REGISTER = 'register';
 export const ENDPOINT_REST_FOLDERS = 'folders';
 // Workspace endpoints
 export const ENDPOINT_REST_WORKSPACES = 'workspaces';

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

@@ -128,6 +128,32 @@ export const DEFAULT_PROJECT = {
 };
 export const INVALID_PROJECT = Object.assign(Object.assign({}, DEFAULT_PROJECT), { name: 123 });
 export const PROJECT_WITH_OPTIONALS_AS_NULL = Object.assign(Object.assign({}, DEFAULT_PROJECT), { parentId: null });
+export const DEFAULT_WORKSPACE_PROJECT = {
+    id: DEFAULT_PROJECT_ID,
+    name: DEFAULT_PROJECT_NAME,
+    color: DEFAULT_ENTITY_COLOR,
+    childOrder: DEFAULT_ORDER,
+    isFavorite: false,
+    isShared: true,
+    viewStyle: DEFAULT_PROJECT_VIEW_STYLE,
+    canAssignTasks: DEFAULT_CAN_ASSIGN_TASKS,
+    isArchived: DEFAULT_IS_ARCHIVED,
+    isDeleted: DEFAULT_IS_DELETED,
+    isFrozen: DEFAULT_IS_FROZEN,
+    createdAt: DEFAULT_DATE,
+    updatedAt: DEFAULT_DATE,
+    defaultOrder: DEFAULT_ORDER,
+    description: '',
+    isCollapsed: DEFAULT_IS_COLLAPSED,
+    url: DEFAULT_PROJECT_URL,
+    workspaceId: '100',
+    folderId: null,
+    collaboratorRoleDefault: 'READ_WRITE',
+    isInviteOnly: false,
+    isLinkSharingEnabled: true,
+    role: 'ADMIN',
+    status: 'ACTIVE',
+};
 export const DEFAULT_SECTION = {
     id: DEFAULT_SECTION_ID,
     userId: DEFAULT_USER_ID,
@@ -235,3 +261,27 @@ export const DEFAULT_FOLDER = {
     childOrder: 3,
     isDeleted: false,
 };
+export const DEFAULT_COLLABORATOR = {
+    id: DEFAULT_USER_ID,
+    email: DEFAULT_USER_EMAIL,
+    fullName: DEFAULT_USER_NAME,
+    timezone: 'UTC',
+    imageId: null,
+};
+export const DEFAULT_COLLABORATOR_STATE = {
+    userId: DEFAULT_USER_ID,
+    projectId: DEFAULT_PROJECT_ID,
+    state: 'active',
+    isDeleted: false,
+};
+export const DEFAULT_NOTE = {
+    id: DEFAULT_COMMENT_ID,
+    projectId: DEFAULT_PROJECT_ID,
+    content: DEFAULT_COMMENT_CONTENT,
+    postedAt: DEFAULT_DATE,
+    fileAttachment: DEFAULT_ATTACHMENT,
+    postedUid: DEFAULT_USER_ID,
+    uidsToNotify: null,
+    reactions: DEFAULT_COMMENT_REACTIONS,
+    isDeleted: false,
+};

package/dist/esm/todoist-api.js

@@ -9,10 +9,11 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
+import { WorkspaceProjectSchema, } from './types/projects/index.js';
 import { UpdateReminderArgsSchema, UpdateLocationReminderArgsSchema, ReminderIdSchema, } from './types/reminders/index.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_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, ENDPOINT_REST_FOLDERS, } 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, validateFolder, validateFolderArray, } from './utils/validators.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, validateFolder, validateFolderArray, validateCollaboratorArray, validateCollaboratorStateArray, validateNoteArray, } 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';
@@ -768,15 +769,18 @@ export class TodoistApi {
         };
     }
     /**
-     * Joins a shared project by its ID.
+     * Joins a workspace project.
      *
-     * @param id - The unique identifier of the project to join.
+     * Only used for workspaces — this endpoint is used to join a workspace project
+     * by a workspace user.
+     *
+     * @param id - The unique identifier of the workspace project to join.
      * @param requestId - Optional custom identifier for the request.
-     * @returns A promise that resolves to the joined project.
+     * @returns A promise that resolves to the full project data after joining.
      */
     async joinProject(id, requestId) {
         z.string().parse(id);
-        const response = await request({
+        const { data } = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
             relativePath: generatePath(ENDPOINT_REST_PROJECTS, id, ENDPOINT_REST_PROJECT_JOIN),
@@ -784,7 +788,16 @@ export class TodoistApi {
             customFetch: this.customFetch,
             requestId: requestId,
         });
-        return validateProject(response.data);
+        return {
+            project: WorkspaceProjectSchema.parse(data.project),
+            tasks: validateTaskArray(data.tasks),
+            sections: validateSectionArray(data.sections),
+            comments: validateNoteArray(data.comments),
+            collaborators: validateCollaboratorArray(data.collaborators),
+            collaboratorStates: validateCollaboratorStateArray(data.collaboratorStates),
+            folder: data.folder ? validateFolder(data.folder) : null,
+            subprojects: data.subprojects.map((p) => WorkspaceProjectSchema.parse(p)),
+        };
     }
     /**
      * Retrieves a list of collaborators for a specific project.

package/dist/types/authentication.d.ts

@@ -13,6 +13,51 @@ export declare const PERMISSIONS: readonly ["task:add", "data:read", "data:read_
  * @see {@link https://developer.todoist.com/api/v1/#tag/Authorization}
  */
 export type Permission = (typeof PERMISSIONS)[number];
+/** Supported token endpoint authentication methods for dynamic client registration. */
+export declare const TOKEN_ENDPOINT_AUTH_METHODS: readonly ["client_secret_post", "client_secret_basic", "none"];
+/**
+ * Authentication method used at the token endpoint.
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc7591#section-2 RFC 7591 Section 2}
+ */
+export type TokenEndpointAuthMethod = (typeof TOKEN_ENDPOINT_AUTH_METHODS)[number];
+/**
+ * Parameters for registering a new OAuth client via Dynamic Client Registration.
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc7591 RFC 7591}
+ */
+export type ClientRegistrationRequest = {
+    redirectUris: string[];
+    clientName?: string;
+    clientUri?: string;
+    logoUri?: string;
+    scope?: readonly Permission[];
+    grantTypes?: string[];
+    responseTypes?: string[];
+    tokenEndpointAuthMethod?: TokenEndpointAuthMethod;
+};
+type RawClientRegistrationResponse = {
+    clientId: string;
+    clientSecret?: string;
+    clientName: string;
+    redirectUris: string[];
+    scope?: string;
+    grantTypes: string[];
+    responseTypes: string[];
+    tokenEndpointAuthMethod: string;
+    clientIdIssuedAt?: number;
+    clientSecretExpiresAt?: number;
+    clientUri?: string;
+    logoUri?: string;
+};
+/**
+ * Response from a successful dynamic client registration.
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc7591#section-3.2.1 RFC 7591 Section 3.2.1}
+ */
+export type ClientRegistrationResponse = Omit<RawClientRegistrationResponse, 'clientIdIssuedAt' | 'clientSecretExpiresAt' | 'scope'> & {
+    scope?: Permission[];
+    clientIdIssuedAt?: Date;
+    /** `null` indicates the client secret never expires. Absent when no secret is issued. */
+    clientSecretExpiresAt?: Date | null;
+};
 /**
  * Parameters required to exchange an authorization code for an access token.
  * @see https://developer.todoist.com/api/v1/#tag/Authorization/OAuth
@@ -80,13 +125,17 @@ export declare function getAuthStateParameter(): string;
 /**
  * Generates the authorization URL for the OAuth2 flow.
  *
+ * The `clientId` can be either a traditional client ID string (e.g. from
+ * {@link registerClient}) or an HTTPS URL pointing to a client metadata document,
+ * as defined in {@link https://drafts.ietf.org/doc/draft-ietf-oauth-client-id-metadata-document/ RFC draft-ietf-oauth-client-id-metadata-document}.
+ *
  * @example
  * ```typescript
- * const url = getAuthorizationUrl(
- *   'your-client-id',
- *   ['data:read', 'task:add'],
- *   state
- * )
+ * const url = getAuthorizationUrl({
+ *   clientId: 'your-client-id',
+ *   permissions: ['data:read', 'task:add'],
+ *   state,
+ * })
  * // Redirect user to url
  * ```
  *
@@ -156,3 +205,22 @@ export declare function revokeToken(args: RevokeTokenRequestArgs, options?: Auth
  * @throws {@link TodoistRequestError} If the migration fails
  */
 export declare function migratePersonalToken(args: MigratePersonalTokenArgs, options?: AuthOptions): Promise<MigratePersonalTokenResponse>;
+/**
+ * Registers a new OAuth client via Dynamic Client Registration (RFC 7591).
+ *
+ * @example
+ * ```typescript
+ * const client = await registerClient({
+ *   redirectUris: ['https://example.com/callback'],
+ *   clientName: 'My App',
+ *   scope: ['data:read_write', 'task:add'],
+ * })
+ * // Use client.clientId and client.clientSecret for OAuth flows
+ * ```
+ *
+ * @returns The registered client details
+ * @throws {@link TodoistRequestError} If the registration fails
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc7591 RFC 7591}
+ */
+export declare function registerClient(args: ClientRegistrationRequest, options?: AuthOptions): Promise<ClientRegistrationResponse>;
+export {};

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

@@ -56,6 +56,7 @@ export declare const ENDPOINT_SYNC = "sync";
 export declare const ENDPOINT_AUTHORIZATION = "authorize";
 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_WORKSPACES = "workspaces";
 export declare const ENDPOINT_WORKSPACE_INVITATIONS = "workspaces/invitations";

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

@@ -1,4 +1,6 @@
-import { Label, Section, Task, User, Attachment, Duration, Deadline, RawComment, PersonalProject, Reminder, Folder } from '../types/index.js';
+import { Label, Section, Task, User, Attachment, Duration, Deadline, RawComment, PersonalProject, WorkspaceProject, Reminder, Folder } 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";
 export declare const DEFAULT_TASK_CONTENT = "This is a task";
 export declare const DEFAULT_TASK_DESCRIPTION = "A description";
@@ -77,6 +79,7 @@ export declare const INVALID_PROJECT: {
     inboxProject: boolean;
 };
 export declare const PROJECT_WITH_OPTIONALS_AS_NULL: PersonalProject;
+export declare const DEFAULT_WORKSPACE_PROJECT: WorkspaceProject;
 export declare const DEFAULT_SECTION: Section;
 export declare const INVALID_SECTION: {
     projectId: undefined;
@@ -259,3 +262,6 @@ export declare const COMMENT_WITH_OPTIONALS_AS_NULL_PROJECT: {
     projectId?: string | undefined;
 };
 export declare const DEFAULT_FOLDER: Folder;
+export declare const DEFAULT_COLLABORATOR: Collaborator;
+export declare const DEFAULT_COLLABORATOR_STATE: CollaboratorState;
+export declare const DEFAULT_NOTE: Note;

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

@@ -1,5 +1,5 @@
 import { Task, AddTaskArgs, GetTasksArgs, GetTasksByFilterArgs, UpdateTaskArgs, QuickAddTaskArgs, type MoveTaskArgs, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, SearchCompletedTasksArgs, GetTasksResponse, GetAllCompletedTasksArgs, GetAllCompletedTasksResponse } from './types/tasks/index.js';
-import { PersonalProject, WorkspaceProject, AddProjectArgs, UpdateProjectArgs, GetProjectsArgs, SearchProjectsArgs, GetProjectCollaboratorsArgs, GetProjectsResponse, GetProjectCollaboratorsResponse, GetArchivedProjectsArgs, GetArchivedProjectsResponse, MoveProjectToWorkspaceArgs, MoveProjectToPersonalArgs, GetArchivedProjectsCountArgs, GetArchivedProjectsCountResponse, GetProjectPermissionsResponse, GetFullProjectArgs, GetFullProjectResponse } from './types/projects/index.js';
+import { PersonalProject, WorkspaceProject, AddProjectArgs, UpdateProjectArgs, GetProjectsArgs, SearchProjectsArgs, GetProjectCollaboratorsArgs, GetProjectsResponse, GetProjectCollaboratorsResponse, GetArchivedProjectsArgs, GetArchivedProjectsResponse, MoveProjectToWorkspaceArgs, MoveProjectToPersonalArgs, GetArchivedProjectsCountArgs, GetArchivedProjectsCountResponse, GetProjectPermissionsResponse, GetFullProjectArgs, GetFullProjectResponse, JoinProjectResponse } from './types/projects/index.js';
 import { Section, AddSectionArgs, UpdateSectionArgs, GetSectionsArgs, SearchSectionsArgs, GetSectionsResponse } from './types/sections/index.js';
 import { Label, AddLabelArgs, UpdateLabelArgs, GetLabelsArgs, SearchLabelsArgs, GetLabelsResponse, GetSharedLabelsArgs, GetSharedLabelsResponse, RenameSharedLabelArgs, RemoveSharedLabelArgs } from './types/labels/index.js';
 import { Attachment, Comment, AddCommentArgs, UpdateCommentArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetCommentsResponse } from './types/comments/index.js';
@@ -318,13 +318,16 @@ export declare class TodoistApi {
      */
     getFullProject(id: string, args?: GetFullProjectArgs): Promise<GetFullProjectResponse>;
     /**
-     * Joins a shared project by its ID.
+     * Joins a workspace project.
      *
-     * @param id - The unique identifier of the project to join.
+     * Only used for workspaces — this endpoint is used to join a workspace project
+     * by a workspace user.
+     *
+     * @param id - The unique identifier of the workspace project to join.
      * @param requestId - Optional custom identifier for the request.
-     * @returns A promise that resolves to the joined project.
+     * @returns A promise that resolves to the full project data after joining.
      */
-    joinProject(id: string, requestId?: string): Promise<PersonalProject | WorkspaceProject>;
+    joinProject(id: string, requestId?: string): Promise<JoinProjectResponse>;
     /**
      * Retrieves a list of collaborators for a specific project.
      *

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

@@ -2,6 +2,9 @@ import type { ColorKey } from '../../utils/colors.js';
 import type { SearchArgs } from '../common.js';
 import type { Comment } from '../comments/types.js';
 import type { Section } from '../sections/types.js';
+import type { Collaborator, CollaboratorState } from '../sync/resources/collaborators.js';
+import type { Folder } from '../sync/resources/folders.js';
+import type { Note } from '../sync/resources/notes.js';
 import type { Task } from '../tasks/types.js';
 import type { User } from '../users/types.js';
 import type { CollaboratorRole, WorkspaceRole } from '../workspaces/types.js';
@@ -167,3 +170,21 @@ export type GetFullProjectResponse = {
     collaborators: User[];
     notes: Comment[];
 };
+/**
+ * Response from joining a workspace project.
+ *
+ * Only used for workspaces — this endpoint is used to join a workspace project
+ * by a workspace user.
+ *
+ * @see https://developer.todoist.com/api/v1/#tag/Projects/operation/join_project_api_v1_projects__project_id__join_post
+ */
+export type JoinProjectResponse = {
+    project: WorkspaceProject;
+    tasks: Task[];
+    sections: Section[];
+    comments: Note[];
+    collaborators: Collaborator[];
+    collaboratorStates: CollaboratorState[];
+    folder: Folder | null;
+    subprojects: WorkspaceProject[];
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-sdk",
-    "version": "8.0.0",
+    "version": "8.1.0",
     "description": "The official TypeScript SDK for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "https://github.com/Doist/todoist-sdk-typescript",