@doist/todoist-api-typescript 5.7.1 → 5.9.0

package/dist/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/entities.js

@@ -22,9 +22,9 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActivityEventSchema = exports.ActivityEventExtraDataSchema = exports.ColorSchema = exports.ProductivityStatsSchema = exports.CurrentUserSchema = exports.TimezoneInfoSchema = exports.UserSchema = exports.CommentSchema = exports.RawCommentSchema = exports.AttachmentSchema = exports.LabelSchema = exports.SectionSchema = exports.WorkspaceProjectSchema = exports.PersonalProjectSchema = exports.BaseProjectSchema = exports.TaskSchema = exports.DeadlineSchema = exports.DurationSchema = exports.DueDateSchema = void 0;
+exports.JoinWorkspaceResultSchema = exports.WorkspacePlanDetailsSchema = exports.FormattedPriceListingSchema = exports.PlanPriceSchema = exports.WorkspaceInvitationSchema = exports.WorkspaceUserSchema = exports.WorkspaceRoleSchema = exports.WORKSPACE_ROLES = exports.ActivityEventSchema = exports.ActivityEventExtraDataSchema = exports.ColorSchema = exports.ProductivityStatsSchema = exports.CurrentUserSchema = exports.TimezoneInfoSchema = exports.UserSchema = exports.CommentSchema = exports.RawCommentSchema = exports.AttachmentSchema = exports.LabelSchema = exports.SectionSchema = exports.WorkspaceProjectSchema = exports.PersonalProjectSchema = exports.BaseProjectSchema = exports.TaskSchema = exports.DeadlineSchema = exports.DurationSchema = exports.DueDateSchema = void 0;
 var zod_1 = require("zod");
-var urlHelpers_1 = require("../utils/urlHelpers");
+var url_helpers_1 = require("../utils/url-helpers");
 exports.DueDateSchema = zod_1.z
     .object({
     isRecurring: zod_1.z.boolean(),
@@ -72,7 +72,7 @@ exports.TaskSchema = zod_1.z
     isCollapsed: zod_1.z.boolean(),
 })
     .transform(function (data) {
-    return __assign(__assign({}, data), { url: (0, urlHelpers_1.getTaskUrl)(data.id, data.content) });
+    return __assign(__assign({}, data), { url: (0, url_helpers_1.getTaskUrl)(data.id, data.content) });
 });
 /**
  * Base schema for all project types in Todoist.
@@ -103,7 +103,7 @@ exports.PersonalProjectSchema = exports.BaseProjectSchema.extend({
     parentId: zod_1.z.string().nullable(),
     inboxProject: zod_1.z.boolean().optional().default(false),
 }).transform(function (data) {
-    return __assign(__assign({}, data), { url: (0, urlHelpers_1.getProjectUrl)(data.id, data.name) });
+    return __assign(__assign({}, data), { url: (0, url_helpers_1.getProjectUrl)(data.id, data.name) });
 });
 /**
  * Schema for workspace projects in Todoist.
@@ -117,7 +117,7 @@ exports.WorkspaceProjectSchema = exports.BaseProjectSchema.extend({
     status: zod_1.z.string(),
     workspaceId: zod_1.z.string(),
 }).transform(function (data) {
-    return __assign(__assign({}, data), { url: (0, urlHelpers_1.getProjectUrl)(data.id, data.name) });
+    return __assign(__assign({}, data), { url: (0, url_helpers_1.getProjectUrl)(data.id, data.name) });
 });
 exports.SectionSchema = zod_1.z
     .object({
@@ -134,7 +134,7 @@ exports.SectionSchema = zod_1.z
     isCollapsed: zod_1.z.boolean(),
 })
     .transform(function (data) {
-    return __assign(__assign({}, data), { url: (0, urlHelpers_1.getSectionUrl)(data.id, data.name) });
+    return __assign(__assign({}, data), { url: (0, url_helpers_1.getSectionUrl)(data.id, data.name) });
 });
 exports.LabelSchema = zod_1.z.object({
     id: zod_1.z.string(),
@@ -320,3 +320,61 @@ exports.ActivityEventSchema = zod_1.z
     extraData: exports.ActivityEventExtraDataSchema,
 })
     .catchall(zod_1.z.any());
+/**
+ * Available workspace roles.
+ */
+exports.WORKSPACE_ROLES = ['ADMIN', 'MEMBER', 'GUEST'];
+exports.WorkspaceRoleSchema = zod_1.z.enum(exports.WORKSPACE_ROLES);
+exports.WorkspaceUserSchema = zod_1.z.object({
+    userId: zod_1.z.string(),
+    workspaceId: zod_1.z.string(),
+    userEmail: zod_1.z.string(),
+    fullName: zod_1.z.string(),
+    timezone: zod_1.z.string(),
+    role: exports.WorkspaceRoleSchema,
+    imageId: zod_1.z.string().nullable(),
+    isDeleted: zod_1.z.boolean().default(false),
+});
+exports.WorkspaceInvitationSchema = zod_1.z.object({
+    id: zod_1.z.string().default('0'),
+    inviterId: zod_1.z.string(),
+    userEmail: zod_1.z.string(),
+    workspaceId: zod_1.z.string(),
+    role: exports.WorkspaceRoleSchema,
+    isExistingUser: zod_1.z.boolean(),
+});
+exports.PlanPriceSchema = zod_1.z.object({
+    currency: zod_1.z.string(),
+    amount: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]),
+    interval: zod_1.z.string().optional(),
+});
+exports.FormattedPriceListingSchema = zod_1.z.object({
+    currency: zod_1.z.string().optional(),
+    amount: zod_1.z.number().optional(),
+    interval: zod_1.z.string().optional(),
+    formatted: zod_1.z.string().optional(),
+});
+exports.WorkspacePlanDetailsSchema = zod_1.z.object({
+    currentMemberCount: zod_1.z.number(),
+    currentPlan: zod_1.z.enum(['Business', 'Starter']),
+    currentPlanStatus: zod_1.z.enum(['Active', 'Downgraded', 'Cancelled', 'NeverSubscribed']),
+    downgradeAt: zod_1.z.string().nullable(),
+    currentActiveProjects: zod_1.z.number(),
+    maximumActiveProjects: zod_1.z.number(),
+    priceList: zod_1.z.array(exports.FormattedPriceListingSchema),
+    workspaceId: zod_1.z.number(),
+    isTrialing: zod_1.z.boolean(),
+    trialEndsAt: zod_1.z.string().nullable(),
+    cancelAtPeriodEnd: zod_1.z.boolean(),
+    hasTrialed: zod_1.z.boolean(),
+    planPrice: exports.PlanPriceSchema.nullable(),
+    hasBillingPortal: zod_1.z.boolean(),
+    hasBillingPortalSwitchToAnnual: zod_1.z.boolean(),
+});
+exports.JoinWorkspaceResultSchema = zod_1.z.object({
+    custom_sorting_applied: zod_1.z.boolean(),
+    project_sort_preference: zod_1.z.string(),
+    role: exports.WorkspaceRoleSchema,
+    user_id: zod_1.z.string(),
+    workspace_id: zod_1.z.string(),
+});

package/dist/types/http.d.ts

@@ -1 +1 @@
-export type HttpMethod = 'POST' | 'GET' | 'DELETE';
+export type HttpMethod = 'POST' | 'GET' | 'DELETE' | 'PUT';

package/dist/types/requests.d.ts

@@ -478,4 +478,173 @@ export type GetActivityLogsResponse = {
     results: ActivityEvent[];
     nextCursor: string | null;
 };
+/**
+ * Arguments for uploading a file.
+ * @see https://todoist.com/api/v1/docs#tag/Uploads/operation/upload_file_api_v1_uploads_post
+ */
+export type UploadFileArgs = {
+    /**
+     * The file content to upload. Can be:
+     * - Buffer: File content as a Buffer (requires fileName)
+     * - ReadableStream: File content as a stream (requires fileName)
+     * - string: Path to a file on the filesystem (fileName is optional, will be inferred from path)
+     */
+    file: Buffer | NodeJS.ReadableStream | string;
+    /**
+     * The name of the file. Required for Buffer and Stream inputs.
+     * Optional for file path strings (will be inferred from the path if not provided).
+     */
+    fileName?: string;
+    /**
+     * The project ID to associate the upload with.
+     */
+    projectId?: string | null;
+};
+/**
+ * Arguments for deleting an uploaded file.
+ * @see https://todoist.com/api/v1/docs#tag/Uploads/operation/delete_upload_api_v1_uploads_delete
+ */
+export type DeleteUploadArgs = {
+    /**
+     * The URL of the file to delete.
+     */
+    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/utils/index.d.ts

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

package/dist/utils/index.js

@@ -17,7 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSectionUrl = exports.getProjectUrl = exports.getTaskUrl = void 0;
 __exportStar(require("./colors"), exports);
 __exportStar(require("./sanitization"), exports);
-var urlHelpers_1 = require("./urlHelpers");
-Object.defineProperty(exports, "getTaskUrl", { enumerable: true, get: function () { return urlHelpers_1.getTaskUrl; } });
-Object.defineProperty(exports, "getProjectUrl", { enumerable: true, get: function () { return urlHelpers_1.getProjectUrl; } });
-Object.defineProperty(exports, "getSectionUrl", { enumerable: true, get: function () { return urlHelpers_1.getSectionUrl; } });
+var url_helpers_1 = require("./url-helpers");
+Object.defineProperty(exports, "getTaskUrl", { enumerable: true, get: function () { return url_helpers_1.getTaskUrl; } });
+Object.defineProperty(exports, "getProjectUrl", { enumerable: true, get: function () { return url_helpers_1.getProjectUrl; } });
+Object.defineProperty(exports, "getSectionUrl", { enumerable: true, get: function () { return url_helpers_1.getSectionUrl; } });

package/dist/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 {};

package/dist/utils/multipart-upload.js

@@ -0,0 +1,171 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadMultipartFile = uploadMultipartFile;
+var form_data_1 = __importDefault(require("form-data"));
+var fs_1 = require("fs");
+var path_1 = require("path");
+var axios_1 = __importDefault(require("axios"));
+/**
+ * Helper function to determine content-type from filename extension.
+ * @param fileName - The filename to analyze
+ * @returns The appropriate MIME type
+ */
+function getContentTypeFromFileName(fileName) {
+    var extension = fileName.toLowerCase().split('.').pop();
+    switch (extension) {
+        case 'png':
+            return 'image/png';
+        case 'jpg':
+        case 'jpeg':
+            return 'image/jpeg';
+        case 'gif':
+            return 'image/gif';
+        case 'webp':
+            return 'image/webp';
+        case 'svg':
+            return 'image/svg+xml';
+        default:
+            return 'application/octet-stream';
+    }
+}
+/**
+ * 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' }
+ * )
+ * ```
+ */
+function uploadMultipartFile(args) {
+    return __awaiter(this, void 0, void 0, function () {
+        var baseUrl, authToken, endpoint, file, fileName, additionalFields, requestId, form, filePath, resolvedFileName, contentType, _i, _a, _b, key, value, url, headers, response;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    baseUrl = args.baseUrl, authToken = args.authToken, endpoint = args.endpoint, file = args.file, fileName = args.fileName, additionalFields = args.additionalFields, requestId = args.requestId;
+                    form = new form_data_1.default();
+                    // Determine file type and add to form data
+                    if (typeof file === 'string') {
+                        filePath = file;
+                        resolvedFileName = fileName || (0, path_1.basename)(filePath);
+                        form.append('file', (0, fs_1.createReadStream)(filePath), resolvedFileName);
+                    }
+                    else if (Buffer.isBuffer(file)) {
+                        // Buffer - require fileName
+                        if (!fileName) {
+                            throw new Error('fileName is required when uploading from a Buffer');
+                        }
+                        contentType = getContentTypeFromFileName(fileName);
+                        form.append('file', file, {
+                            filename: fileName,
+                            contentType: contentType,
+                        });
+                    }
+                    else {
+                        // Stream - require fileName
+                        if (!fileName) {
+                            throw new Error('fileName is required when uploading from a stream');
+                        }
+                        form.append('file', file, fileName);
+                    }
+                    // Add additional fields to the form
+                    for (_i = 0, _a = Object.entries(additionalFields); _i < _a.length; _i++) {
+                        _b = _a[_i], key = _b[0], value = _b[1];
+                        if (value !== undefined && value !== null) {
+                            form.append(key, value.toString());
+                        }
+                    }
+                    url = "".concat(baseUrl).concat(endpoint);
+                    headers = __assign({ Authorization: "Bearer ".concat(authToken) }, form.getHeaders());
+                    if (requestId) {
+                        headers['X-Request-Id'] = requestId;
+                    }
+                    return [4 /*yield*/, axios_1.default.post(url, form, { headers: headers })];
+                case 1:
+                    response = _c.sent();
+                    return [2 /*return*/, response.data];
+            }
+        });
+    });
+}

package/dist/utils/validators.d.ts

@@ -1,4 +1,4 @@
-import { type Task, type Section, type Label, type Comment, type User, type CurrentUser, type ProductivityStats, type WorkspaceProject, type PersonalProject, type ActivityEvent } from '../types/entities';
+import { type Attachment, type Task, type Section, type Label, type Comment, type User, type CurrentUser, type ProductivityStats, type WorkspaceProject, type PersonalProject, type ActivityEvent, type WorkspaceUser, type WorkspaceInvitation, type WorkspacePlanDetails, type JoinWorkspaceResult } from '../types/entities';
 export declare function validateTask(input: unknown): Task;
 export declare function validateTaskArray(input: unknown[]): Task[];
 /**
@@ -32,3 +32,10 @@ export declare function validateProductivityStats(input: unknown): ProductivityS
 export declare function validateCurrentUser(input: unknown): CurrentUser;
 export declare function validateActivityEvent(input: unknown): ActivityEvent;
 export declare function validateActivityEventArray(input: unknown[]): ActivityEvent[];
+export declare function validateAttachment(input: unknown): Attachment;
+export declare function validateWorkspaceUser(input: unknown): WorkspaceUser;
+export declare function validateWorkspaceUserArray(input: unknown): WorkspaceUser[];
+export declare function validateWorkspaceInvitation(input: unknown): WorkspaceInvitation;
+export declare function validateWorkspaceInvitationArray(input: unknown[]): WorkspaceInvitation[];
+export declare function validateWorkspacePlanDetails(input: unknown): WorkspacePlanDetails;
+export declare function validateJoinWorkspaceResult(input: unknown): JoinWorkspaceResult;