@doist/todoist-api-typescript 5.8.0 → 6.0.0

package/dist/esm/utils/validators.js

@@ -0,0 +1,97 @@
+import { AttachmentSchema, SectionSchema, LabelSchema, CommentSchema, UserSchema, CurrentUserSchema, TaskSchema, PersonalProjectSchema, WorkspaceProjectSchema, ProductivityStatsSchema, ActivityEventSchema, WorkspaceUserSchema, WorkspaceInvitationSchema, WorkspacePlanDetailsSchema, JoinWorkspaceResultSchema, } from '../types/entities.js';
+export function validateTask(input) {
+    return TaskSchema.parse(input);
+}
+export function validateTaskArray(input) {
+    return input.map(validateTask);
+}
+/**
+ * Type guard to check if a project is a workspace project.
+ * @param project The project to check
+ * @returns True if the project is a workspace project
+ */
+export function isWorkspaceProject(project) {
+    return 'workspaceId' in project;
+}
+/**
+ * Type guard to check if a project is a personal project.
+ * @param project The project to check
+ * @returns True if the project is a personal project
+ */
+export function isPersonalProject(project) {
+    return !isWorkspaceProject(project);
+}
+/**
+ * Validates and parses a project input.
+ * @param input The input to validate
+ * @returns A validated project (either PersonalProject or WorkspaceProject)
+ */
+export function validateProject(input) {
+    if ('workspaceId' in input) {
+        return WorkspaceProjectSchema.parse(input);
+    }
+    return PersonalProjectSchema.parse(input);
+}
+export function validateProjectArray(input) {
+    return input.map(validateProject);
+}
+export function validateSection(input) {
+    return SectionSchema.parse(input);
+}
+export function validateSectionArray(input) {
+    return input.map(validateSection);
+}
+export function validateLabel(input) {
+    return LabelSchema.parse(input);
+}
+export function validateLabelArray(input) {
+    return input.map(validateLabel);
+}
+export function validateComment(input) {
+    return CommentSchema.parse(input);
+}
+export function validateCommentArray(input) {
+    return input.map(validateComment);
+}
+export function validateUser(input) {
+    return UserSchema.parse(input);
+}
+export function validateUserArray(input) {
+    return input.map(validateUser);
+}
+export function validateProductivityStats(input) {
+    return ProductivityStatsSchema.parse(input);
+}
+export function validateCurrentUser(input) {
+    return CurrentUserSchema.parse(input);
+}
+export function validateActivityEvent(input) {
+    return ActivityEventSchema.parse(input);
+}
+export function validateActivityEventArray(input) {
+    return input.map(validateActivityEvent);
+}
+export function validateAttachment(input) {
+    return AttachmentSchema.parse(input);
+}
+export function validateWorkspaceUser(input) {
+    return WorkspaceUserSchema.parse(input);
+}
+export function validateWorkspaceUserArray(input) {
+    if (!Array.isArray(input)) {
+        throw new Error(`Expected array for workspace users, got ${typeof input}`);
+    }
+    return input.map(validateWorkspaceUser);
+}
+export function validateWorkspaceInvitation(input) {
+    return WorkspaceInvitationSchema.parse(input);
+}
+export function validateWorkspaceInvitationArray(input) {
+    return input.map(validateWorkspaceInvitation);
+}
+export function validateWorkspacePlanDetails(input) {
+    return WorkspacePlanDetailsSchema.parse(input);
+}
+export function validateJoinWorkspaceResult(input) {
+    return JoinWorkspaceResultSchema.parse(input);
+}

package/dist/{authentication.d.ts → types/authentication.d.ts}

@@ -68,7 +68,12 @@ export declare function getAuthStateParameter(): string;
  * @returns The full authorization URL to redirect users to
  * @see https://todoist.com/api/v1/docs#tag/Authorization/OAuth
  */
-export declare function getAuthorizationUrl(clientId: string, permissions: Permission[], state: string, baseUrl?: string): string;
+export declare function getAuthorizationUrl({ clientId, permissions, state, baseUrl, }: {
+    clientId: string;
+    permissions: Permission[];
+    state: string;
+    baseUrl?: string;
+}): string;
 /**
  * Exchanges an authorization code for an access token.
  *

package/dist/{consts → types/consts}/endpoints.d.ts

@@ -32,3 +32,14 @@ export declare const ENDPOINT_AUTHORIZATION = "authorize";
 export declare const ENDPOINT_GET_TOKEN = "access_token";
 export declare const ENDPOINT_REVOKE_TOKEN = "access_tokens/revoke";
 export declare const ENDPOINT_REVOKE = "revoke";
+export declare const ENDPOINT_WORKSPACE_INVITATIONS = "workspaces/invitations";
+export declare const ENDPOINT_WORKSPACE_INVITATIONS_ALL = "workspaces/invitations/all";
+export declare const ENDPOINT_WORKSPACE_INVITATIONS_DELETE = "workspaces/invitations/delete";
+export declare const ENDPOINT_WORKSPACE_JOIN = "workspaces/join";
+export declare const ENDPOINT_WORKSPACE_LOGO = "workspaces/logo";
+export declare const ENDPOINT_WORKSPACE_PLAN_DETAILS = "workspaces/plan_details";
+export declare const ENDPOINT_WORKSPACE_USERS = "workspaces/users";
+export declare function getWorkspaceInvitationAcceptEndpoint(inviteCode: string): string;
+export declare function getWorkspaceInvitationRejectEndpoint(inviteCode: string): string;
+export declare function getWorkspaceActiveProjectsEndpoint(workspaceId: number): string;
+export declare function getWorkspaceArchivedProjectsEndpoint(workspaceId: number): string;

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
-export * from './entities';
-export * from './errors';
-export * from './requests';
+export * from './todoist-api';
+export * from './authentication';
+export * from './types';
+export * from './utils';

package/dist/types/rest-client.d.ts

@@ -0,0 +1,15 @@
+import { HttpMethod, HttpResponse } from './types/http';
+type RequestArgs = {
+    httpMethod: HttpMethod;
+    baseUri: string;
+    relativePath: string;
+    apiToken?: string;
+    payload?: Record<string, unknown>;
+    requestId?: string;
+    hasSyncCommands?: boolean;
+    customHeaders?: Record<string, string>;
+};
+export declare function paramsSerializer(params: Record<string, unknown>): string;
+export declare function isSuccess(response: HttpResponse): boolean;
+export declare function request<T>(args: RequestArgs): Promise<HttpResponse<T>>;
+export {};

package/dist/types/test-utils/msw-setup.d.ts

@@ -0,0 +1,3 @@
+export declare const handlers: never[];
+export declare const server: import("msw/node").SetupServerApi;
+export { http, HttpResponse } from 'msw';

package/dist/{TodoistApi.d.ts → types/todoist-api.d.ts}

@@ -1,5 +1,5 @@
-import { Attachment, PersonalProject, WorkspaceProject, Label, Section, Comment, Task, CurrentUser, ProductivityStats } from './types/entities';
-import { AddCommentArgs, AddLabelArgs, AddProjectArgs, AddSectionArgs, AddTaskArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetTasksArgs, GetTasksByFilterArgs, UpdateCommentArgs, UpdateLabelArgs, UpdateProjectArgs, UpdateSectionArgs, UpdateTaskArgs, QuickAddTaskArgs, GetSharedLabelsArgs, RenameSharedLabelArgs, RemoveSharedLabelArgs, GetProjectsArgs, GetProjectCollaboratorsArgs, GetLabelsArgs, GetLabelsResponse, GetTasksResponse, GetProjectsResponse, GetProjectCollaboratorsResponse, GetSectionsArgs, GetSectionsResponse, GetSharedLabelsResponse, GetCommentsResponse, type MoveTaskArgs, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, GetArchivedProjectsArgs, GetArchivedProjectsResponse, SearchCompletedTasksArgs, GetActivityLogsArgs, GetActivityLogsResponse, UploadFileArgs, DeleteUploadArgs } from './types/requests';
+import { Attachment, PersonalProject, WorkspaceProject, Label, Section, Comment, Task, CurrentUser, ProductivityStats, WorkspaceInvitation, WorkspacePlanDetails, JoinWorkspaceResult } from './types/entities';
+import { AddCommentArgs, AddLabelArgs, AddProjectArgs, AddSectionArgs, AddTaskArgs, GetProjectCommentsArgs, GetTaskCommentsArgs, GetTasksArgs, GetTasksByFilterArgs, UpdateCommentArgs, UpdateLabelArgs, UpdateProjectArgs, UpdateSectionArgs, UpdateTaskArgs, QuickAddTaskArgs, GetSharedLabelsArgs, RenameSharedLabelArgs, RemoveSharedLabelArgs, GetProjectsArgs, GetProjectCollaboratorsArgs, GetLabelsArgs, GetLabelsResponse, GetTasksResponse, GetProjectsResponse, GetProjectCollaboratorsResponse, GetSectionsArgs, GetSectionsResponse, GetSharedLabelsResponse, GetCommentsResponse, type MoveTaskArgs, GetCompletedTasksByCompletionDateArgs, GetCompletedTasksByDueDateArgs, GetCompletedTasksResponse, GetArchivedProjectsArgs, GetArchivedProjectsResponse, SearchCompletedTasksArgs, GetActivityLogsArgs, GetActivityLogsResponse, UploadFileArgs, DeleteUploadArgs, GetWorkspaceInvitationsArgs, DeleteWorkspaceInvitationArgs, WorkspaceInvitationActionArgs, JoinWorkspaceArgs, WorkspaceLogoArgs, GetWorkspacePlanDetailsArgs, GetWorkspaceUsersArgs, GetWorkspaceUsersResponse, GetWorkspaceProjectsArgs, WorkspaceInvitationsResponse, AllWorkspaceInvitationsResponse, WorkspaceLogoResponse } from './types/requests';
 /**
  * A client for interacting with the Todoist API v1.
  * This class provides methods to manage tasks, projects, sections, labels, and comments in Todoist.
@@ -422,4 +422,93 @@ export declare class TodoistApi {
      * ```
      */
     deleteUpload(args: DeleteUploadArgs, requestId?: string): Promise<boolean>;
+    /**
+     * Gets pending invitations for a workspace.
+     *
+     * @param args - Arguments including workspace ID.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Array of email addresses with pending invitations.
+     */
+    getWorkspaceInvitations(args: GetWorkspaceInvitationsArgs, requestId?: string): Promise<WorkspaceInvitationsResponse>;
+    /**
+     * Gets all workspace invitations (admin only).
+     *
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Array of email addresses with pending invitations.
+     */
+    getAllWorkspaceInvitations(args?: {
+        workspaceId?: number;
+    }, requestId?: string): Promise<AllWorkspaceInvitationsResponse>;
+    /**
+     * Deletes a workspace invitation (admin only).
+     *
+     * @param args - Arguments including workspace ID and user email.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns The deleted invitation.
+     */
+    deleteWorkspaceInvitation(args: DeleteWorkspaceInvitationArgs, requestId?: string): Promise<WorkspaceInvitation>;
+    /**
+     * Accepts a workspace invitation.
+     *
+     * @param args - Arguments including invite code.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns The accepted invitation.
+     */
+    acceptWorkspaceInvitation(args: WorkspaceInvitationActionArgs, requestId?: string): Promise<WorkspaceInvitation>;
+    /**
+     * Rejects a workspace invitation.
+     *
+     * @param args - Arguments including invite code.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns The rejected invitation.
+     */
+    rejectWorkspaceInvitation(args: WorkspaceInvitationActionArgs, requestId?: string): Promise<WorkspaceInvitation>;
+    /**
+     * Joins a workspace via invitation link or domain auto-join.
+     *
+     * @param args - Arguments including invite code or workspace ID.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Workspace user information.
+     */
+    joinWorkspace(args: JoinWorkspaceArgs, requestId?: string): Promise<JoinWorkspaceResult>;
+    /**
+     * Uploads or updates a workspace logo.
+     *
+     * @param args - Arguments including workspace ID, file, and options.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Logo information or null if deleted.
+     */
+    uploadWorkspaceLogo(args: WorkspaceLogoArgs, requestId?: string): Promise<WorkspaceLogoResponse>;
+    /**
+     * Gets workspace plan and billing details.
+     *
+     * @param args - Arguments including workspace ID.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Workspace plan details.
+     */
+    getWorkspacePlanDetails(args: GetWorkspacePlanDetailsArgs, requestId?: string): Promise<WorkspacePlanDetails>;
+    /**
+     * Gets workspace users with pagination.
+     *
+     * @param args - Arguments including optional workspace ID, cursor, and limit.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Paginated list of workspace users.
+     */
+    getWorkspaceUsers(args?: GetWorkspaceUsersArgs, requestId?: string): Promise<GetWorkspaceUsersResponse>;
+    /**
+     * Gets active projects in a workspace with pagination.
+     *
+     * @param args - Arguments including workspace ID, cursor, and limit.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Paginated list of active workspace projects.
+     */
+    getWorkspaceActiveProjects(args: GetWorkspaceProjectsArgs, requestId?: string): Promise<GetProjectsResponse>;
+    /**
+     * Gets archived projects in a workspace with pagination.
+     *
+     * @param args - Arguments including workspace ID, cursor, and limit.
+     * @param requestId - Optional request ID for idempotency.
+     * @returns Paginated list of archived workspace projects.
+     */
+    getWorkspaceArchivedProjects(args: GetWorkspaceProjectsArgs, requestId?: string): Promise<GetProjectsResponse>;
 }

package/dist/types/{entities.d.ts → types/entities.d.ts}

@@ -713,4 +713,123 @@ export declare const ActivityEventSchema: z.ZodObject<{
  * Represents an activity log event in Todoist.
  */
 export type ActivityEvent = z.infer<typeof ActivityEventSchema>;
+/**
+ * Available workspace roles.
+ */
+export declare const WORKSPACE_ROLES: readonly ["ADMIN", "MEMBER", "GUEST"];
+/**
+ * Role of a user within a workspace.
+ */
+export type WorkspaceRole = (typeof WORKSPACE_ROLES)[number];
+export declare const WorkspaceRoleSchema: z.ZodEnum<{
+    ADMIN: "ADMIN";
+    MEMBER: "MEMBER";
+    GUEST: "GUEST";
+}>;
+export declare const WorkspaceUserSchema: z.ZodObject<{
+    userId: z.ZodString;
+    workspaceId: z.ZodString;
+    userEmail: z.ZodString;
+    fullName: z.ZodString;
+    timezone: z.ZodString;
+    role: z.ZodEnum<{
+        ADMIN: "ADMIN";
+        MEMBER: "MEMBER";
+        GUEST: "GUEST";
+    }>;
+    imageId: z.ZodNullable<z.ZodString>;
+    isDeleted: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Represents a user within a workspace (MemberView from API).
+ */
+export type WorkspaceUser = z.infer<typeof WorkspaceUserSchema>;
+export declare const WorkspaceInvitationSchema: z.ZodObject<{
+    id: z.ZodDefault<z.ZodString>;
+    inviterId: z.ZodString;
+    userEmail: z.ZodString;
+    workspaceId: z.ZodString;
+    role: z.ZodEnum<{
+        ADMIN: "ADMIN";
+        MEMBER: "MEMBER";
+        GUEST: "GUEST";
+    }>;
+    isExistingUser: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Represents a workspace invitation.
+ */
+export type WorkspaceInvitation = z.infer<typeof WorkspaceInvitationSchema>;
+export declare const PlanPriceSchema: z.ZodObject<{
+    currency: z.ZodString;
+    amount: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    interval: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Plan pricing information.
+ */
+export type PlanPrice = z.infer<typeof PlanPriceSchema>;
+export declare const FormattedPriceListingSchema: z.ZodObject<{
+    currency: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    interval: z.ZodOptional<z.ZodString>;
+    formatted: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Formatted price listing for workspace plans.
+ */
+export type FormattedPriceListing = z.infer<typeof FormattedPriceListingSchema>;
+export declare const WorkspacePlanDetailsSchema: z.ZodObject<{
+    currentMemberCount: z.ZodNumber;
+    currentPlan: z.ZodEnum<{
+        Business: "Business";
+        Starter: "Starter";
+    }>;
+    currentPlanStatus: z.ZodEnum<{
+        Active: "Active";
+        Downgraded: "Downgraded";
+        Cancelled: "Cancelled";
+        NeverSubscribed: "NeverSubscribed";
+    }>;
+    downgradeAt: z.ZodNullable<z.ZodString>;
+    currentActiveProjects: z.ZodNumber;
+    maximumActiveProjects: z.ZodNumber;
+    priceList: z.ZodArray<z.ZodObject<{
+        currency: z.ZodOptional<z.ZodString>;
+        amount: z.ZodOptional<z.ZodNumber>;
+        interval: z.ZodOptional<z.ZodString>;
+        formatted: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    workspaceId: z.ZodNumber;
+    isTrialing: z.ZodBoolean;
+    trialEndsAt: z.ZodNullable<z.ZodString>;
+    cancelAtPeriodEnd: z.ZodBoolean;
+    hasTrialed: z.ZodBoolean;
+    planPrice: z.ZodNullable<z.ZodObject<{
+        currency: z.ZodString;
+        amount: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+        interval: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    hasBillingPortal: z.ZodBoolean;
+    hasBillingPortalSwitchToAnnual: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Represents workspace plan and billing details.
+ */
+export type WorkspacePlanDetails = z.infer<typeof WorkspacePlanDetailsSchema>;
+export declare const JoinWorkspaceResultSchema: z.ZodObject<{
+    custom_sorting_applied: z.ZodBoolean;
+    project_sort_preference: z.ZodString;
+    role: z.ZodEnum<{
+        ADMIN: "ADMIN";
+        MEMBER: "MEMBER";
+        GUEST: "GUEST";
+    }>;
+    user_id: z.ZodString;
+    workspace_id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Result returned when successfully joining a workspace.
+ */
+export type JoinWorkspaceResult = z.infer<typeof JoinWorkspaceResultSchema>;
 export {};

package/dist/types/types/http.d.ts

@@ -0,0 +1,68 @@
+export type HttpMethod = 'POST' | 'GET' | 'DELETE' | 'PUT';
+/**
+ * HTTP response type that replaces AxiosResponse
+ */
+export type HttpResponse<T = unknown> = {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+};
+/**
+ * HTTP request configuration
+ */
+export type HttpRequestConfig = {
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    timeout?: number;
+    signal?: AbortSignal;
+};
+/**
+ * Internal HTTP request options
+ */
+export type HttpRequestOptions = HttpRequestConfig & {
+    url: string;
+    params?: Record<string, unknown>;
+    data?: unknown;
+};
+/**
+ * Configuration for retry behavior
+ */
+export type RetryConfig = {
+    retries: number;
+    retryCondition: (error: Error) => boolean;
+    retryDelay: (retryNumber: number) => number;
+};
+/**
+ * Configuration for the HTTP client
+ */
+export type HttpClientConfig = {
+    baseURL?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    retry?: RetryConfig;
+};
+/**
+ * Network error type for retry logic
+ */
+export type NetworkError = Error & {
+    code?: string;
+    isNetworkError: true;
+};
+/**
+ * HTTP error with status code and response data
+ */
+export type HttpError = Error & {
+    status?: number;
+    statusText?: string;
+    response?: HttpResponse<unknown>;
+    data?: unknown;
+};
+/**
+ * Type guard to check if an error is a network error
+ */
+export declare function isNetworkError(error: Error): error is NetworkError;
+/**
+ * Type guard to check if an error is an HTTP error
+ */
+export declare function isHttpError(error: Error): error is HttpError;

package/dist/types/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './entities';
+export * from './errors';
+export * from './requests';

package/dist/types/{requests.d.ts → types/requests.d.ts}

@@ -510,4 +510,141 @@ export type DeleteUploadArgs = {
      */
     fileUrl: string;
 };
+/**
+ * Arguments for getting workspace invitations.
+ */
+export type GetWorkspaceInvitationsArgs = {
+    /**
+     * The workspace ID to get invitations for.
+     */
+    workspaceId: number;
+};
+/**
+ * Arguments for deleting a workspace invitation.
+ */
+export type DeleteWorkspaceInvitationArgs = {
+    /**
+     * The workspace ID.
+     */
+    workspaceId: number;
+    /**
+     * The email address of the invitation to delete.
+     */
+    userEmail: string;
+};
+/**
+ * Arguments for accepting/rejecting a workspace invitation.
+ */
+export type WorkspaceInvitationActionArgs = {
+    /**
+     * The invitation code from the email.
+     */
+    inviteCode: string;
+};
+/**
+ * Arguments for joining a workspace.
+ */
+export type JoinWorkspaceArgs = {
+    /**
+     * Optional invitation code/link to join via.
+     */
+    inviteCode?: string | null;
+    /**
+     * Optional workspace ID to join via domain auto-join.
+     */
+    workspaceId?: number | null;
+};
+/**
+ * Arguments for uploading/updating workspace logo.
+ */
+export type WorkspaceLogoArgs = {
+    /**
+     * The workspace ID.
+     */
+    workspaceId: number;
+    /**
+     * The image file to upload (Buffer, Stream, or file path).
+     */
+    file?: Buffer | NodeJS.ReadableStream | string;
+    /**
+     * The file name (required for Buffer/Stream uploads).
+     */
+    fileName?: string;
+    /**
+     * Whether to delete the logo instead of updating it.
+     */
+    delete?: boolean;
+};
+/**
+ * Arguments for getting workspace plan details.
+ */
+export type GetWorkspacePlanDetailsArgs = {
+    /**
+     * The workspace ID.
+     */
+    workspaceId: number;
+};
+/**
+ * Arguments for getting workspace users (paginated).
+ */
+export type GetWorkspaceUsersArgs = {
+    /**
+     * Optional workspace ID. If not provided, returns users for all workspaces.
+     */
+    workspaceId?: number | null;
+    /**
+     * Cursor for pagination.
+     */
+    cursor?: string | null;
+    /**
+     * Maximum number of users to return (default: 100).
+     */
+    limit?: number;
+};
+/**
+ * Arguments for getting workspace projects (paginated).
+ */
+export type GetWorkspaceProjectsArgs = {
+    /**
+     * The workspace ID.
+     */
+    workspaceId: number;
+    /**
+     * Cursor for pagination.
+     */
+    cursor?: string | null;
+    /**
+     * Maximum number of projects to return (default: 100).
+     */
+    limit?: number;
+};
+/**
+ * Paginated response for workspace users.
+ */
+export type GetWorkspaceUsersResponse = {
+    /**
+     * Whether there are more users available.
+     */
+    hasMore: boolean;
+    /**
+     * Cursor for the next page of results.
+     */
+    nextCursor?: string;
+    /**
+     * Array of workspace users.
+     */
+    workspaceUsers: import('./entities').WorkspaceUser[];
+};
+/**
+ * Response type for workspace invitations endpoint (simple email list).
+ */
+export type WorkspaceInvitationsResponse = string[];
+/**
+ * Response type for all workspace invitations endpoint (detailed objects).
+ */
+export type AllWorkspaceInvitationsResponse = import('./entities').WorkspaceInvitation[];
+/**
+ * Response type for workspace logo upload.
+ */
+export type WorkspaceLogoResponse = Record<string, unknown> | null;
 export {};

package/dist/types/utils/case-conversion.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Custom camelCase function that preserves emoji strings
+ */
+export declare function customCamelCase(input: string): string;
+/**
+ * Converts object keys from snake_case to camelCase recursively
+ */
+export declare function camelCaseKeys<T>(obj: T): T;
+/**
+ * Converts object keys from camelCase to snake_case recursively
+ */
+export declare function snakeCaseKeys<T>(obj: T): T;

package/dist/types/utils/fetch-with-retry.d.ts

@@ -0,0 +1,11 @@
+import type { HttpResponse, RetryConfig } from '../types/http';
+/**
+ * Performs a fetch request with retry logic and timeout support
+ */
+export declare function fetchWithRetry<T = unknown>(args: {
+    url: string;
+    options?: RequestInit & {
+        timeout?: number;
+    };
+    retryConfig?: Partial<RetryConfig>;
+}): Promise<HttpResponse<T>>;

package/dist/types/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './colors';
+export * from './sanitization';
+export { getTaskUrl, getProjectUrl, getSectionUrl } from './url-helpers';

package/dist/types/utils/multipart-upload.d.ts

@@ -0,0 +1,50 @@
+type UploadMultipartFileArgs = {
+    baseUrl: string;
+    authToken: string;
+    endpoint: string;
+    file: Buffer | NodeJS.ReadableStream | string;
+    fileName?: string;
+    additionalFields: Record<string, string | number | boolean>;
+    requestId?: string;
+};
+/**
+ * Uploads a file using multipart/form-data.
+ *
+ * This is a shared utility for uploading files to Todoist endpoints that require
+ * multipart/form-data content type (e.g., file uploads, workspace logo uploads).
+ *
+ * @param baseUrl - The base API URL (e.g., https://api.todoist.com/api/v1/)
+ * @param authToken - The authentication token
+ * @param endpoint - The relative endpoint path (e.g., 'uploads', 'workspaces/logo')
+ * @param file - The file content (Buffer, ReadableStream, or file system path)
+ * @param fileName - Optional file name (required for Buffer/Stream, optional for paths)
+ * @param additionalFields - Additional form fields to include (e.g., project_id, workspace_id)
+ * @param requestId - Optional request ID for idempotency
+ * @returns The response data from the server
+ *
+ * @example
+ * ```typescript
+ * // Upload from a file path
+ * const result = await uploadMultipartFile(
+ *   'https://api.todoist.com/api/v1/',
+ *   'my-token',
+ *   'uploads',
+ *   '/path/to/file.pdf',
+ *   undefined,
+ *   { project_id: '12345' }
+ * )
+ *
+ * // Upload from a Buffer
+ * const buffer = Buffer.from('file content')
+ * const result = await uploadMultipartFile(
+ *   'https://api.todoist.com/api/v1/',
+ *   'my-token',
+ *   'uploads',
+ *   buffer,
+ *   'document.pdf',
+ *   { project_id: '12345' }
+ * )
+ * ```
+ */
+export declare function uploadMultipartFile<T>(args: UploadMultipartFileArgs): Promise<T>;
+export {};