@todoist/sdk 0.0.0-stage → 18.0.0

package/dist/types/types/billing/types.d.ts

@@ -0,0 +1,207 @@
+import { z } from 'zod';
+/** Available subscription statuses. */
+export declare const BILLING_SUBSCRIPTION_STATUSES: readonly ["none", "autorenew", "canceled", "expired", "trial", "trial_canceled"];
+/** Current subscription status. */
+export type BillingSubscriptionStatus = (typeof BILLING_SUBSCRIPTION_STATUSES)[number];
+/** Available plan tiers. */
+export declare const BILLING_PLANS: readonly ["free", "pro", "pro_gifted", "pro_legacy"];
+/** Plan tier a user is currently on. */
+export type BillingPlan = (typeof BILLING_PLANS)[number];
+/** Ways an active subscription can be purchased. */
+export declare const BILLING_ACTIVATION_METHODS: readonly ["stripe", "appstore", "playstore", "teams", "manual"];
+/** How an active subscription was purchased. */
+export type BillingActivationMethod = (typeof BILLING_ACTIVATION_METHODS)[number];
+/** Available billing cycles. */
+export declare const BILLING_CYCLES: readonly ["monthly", "yearly"];
+/** Billing cycle for a plan price. */
+export type BillingCycle = (typeof BILLING_CYCLES)[number];
+/** Available tax behaviors for a price. */
+export declare const TAX_BEHAVIORS: readonly ["exclusive", "inclusive", "unspecified"];
+/** Tax behavior for a plan price. */
+export type TaxBehavior = (typeof TAX_BEHAVIORS)[number];
+export declare const BillingPlanPriceSchema: z.ZodObject<{
+    amount: z.ZodString;
+    rawAmount: z.ZodNumber;
+    currency: z.ZodString;
+    billingCycle: z.ZodNullable<z.ZodEnum<{
+        monthly: "monthly";
+        yearly: "yearly";
+    }>>;
+    taxBehavior: z.ZodEnum<{
+        inclusive: "inclusive";
+        exclusive: "exclusive";
+        unspecified: "unspecified";
+    }>;
+}, z.core.$strip>;
+/** Price of an active plan. */
+export type BillingPlanPrice = z.infer<typeof BillingPlanPriceSchema>;
+export declare const SubscriptionInfoSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        none: "none";
+        autorenew: "autorenew";
+        canceled: "canceled";
+        expired: "expired";
+        trial: "trial";
+        trial_canceled: "trial_canceled";
+    }>;
+    plan: z.ZodEnum<{
+        free: "free";
+        pro: "pro";
+        pro_gifted: "pro_gifted";
+        pro_legacy: "pro_legacy";
+    }>;
+    expirationDate: z.ZodNullable<z.ZodString>;
+    activationMethod: z.ZodEnum<{
+        manual: "manual";
+        stripe: "stripe";
+        appstore: "appstore";
+        playstore: "playstore";
+        teams: "teams";
+    }>;
+    planPrice: z.ZodNullable<z.ZodObject<{
+        amount: z.ZodString;
+        rawAmount: z.ZodNumber;
+        currency: z.ZodString;
+        billingCycle: z.ZodNullable<z.ZodEnum<{
+            monthly: "monthly";
+            yearly: "yearly";
+        }>>;
+        taxBehavior: z.ZodEnum<{
+            inclusive: "inclusive";
+            exclusive: "exclusive";
+            unspecified: "unspecified";
+        }>;
+    }, z.core.$strip>>;
+    billingPortalUrl: z.ZodNullable<z.ZodString>;
+    billingPortalSwitchToAnnualUrl: z.ZodNullable<z.ZodString>;
+    hasBillingPortal: z.ZodBoolean;
+    hasBillingPortalSwitchToAnnual: z.ZodBoolean;
+    invoiceCreditBalance: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    hasSwitchLegacyToCurrent: z.ZodBoolean;
+}, z.core.$strip>;
+/** Current subscription state of a user. */
+export type SubscriptionInfo = z.infer<typeof SubscriptionInfoSchema>;
+export declare const FormattedPriceSchema: z.ZodObject<{
+    currency: z.ZodString;
+    unitAmount: z.ZodNumber;
+    taxBehavior: z.ZodEnum<{
+        inclusive: "inclusive";
+        exclusive: "exclusive";
+        unspecified: "unspecified";
+    }>;
+}, z.core.$strip>;
+/** A single price within a billing-cycle listing. */
+export type FormattedPrice = z.infer<typeof FormattedPriceSchema>;
+export declare const PriceListingSchema: z.ZodObject<{
+    billingCycle: z.ZodEnum<{
+        monthly: "monthly";
+        yearly: "yearly";
+    }>;
+    prices: z.ZodArray<z.ZodObject<{
+        currency: z.ZodString;
+        unitAmount: z.ZodNumber;
+        taxBehavior: z.ZodEnum<{
+            inclusive: "inclusive";
+            exclusive: "exclusive";
+            unspecified: "unspecified";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Prices available for a given billing cycle. */
+export type PriceListing = z.infer<typeof PriceListingSchema>;
+export declare const ProPlanDetailsSchema: z.ZodObject<{
+    currentPlanStatus: z.ZodEnum<{
+        Active: "Active";
+        Downgraded: "Downgraded";
+        Cancelled: "Cancelled";
+        NeverSubscribed: "NeverSubscribed";
+    }>;
+    downgradeAt: z.ZodNullable<z.ZodString>;
+    priceList: z.ZodArray<z.ZodObject<{
+        billingCycle: z.ZodEnum<{
+            monthly: "monthly";
+            yearly: "yearly";
+        }>;
+        prices: z.ZodArray<z.ZodObject<{
+            currency: z.ZodString;
+            unitAmount: z.ZodNumber;
+            taxBehavior: z.ZodEnum<{
+                inclusive: "inclusive";
+                exclusive: "exclusive";
+                unspecified: "unspecified";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Pro plan and billing details. */
+export type ProPlanDetails = z.infer<typeof ProPlanDetailsSchema>;
+export declare const PricesResponseSchema: z.ZodObject<{
+    pro: z.ZodArray<z.ZodObject<{
+        billingCycle: z.ZodEnum<{
+            monthly: "monthly";
+            yearly: "yearly";
+        }>;
+        prices: z.ZodArray<z.ZodObject<{
+            currency: z.ZodString;
+            unitAmount: z.ZodNumber;
+            taxBehavior: z.ZodEnum<{
+                inclusive: "inclusive";
+                exclusive: "exclusive";
+                unspecified: "unspecified";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    teams: z.ZodArray<z.ZodObject<{
+        billingCycle: z.ZodEnum<{
+            monthly: "monthly";
+            yearly: "yearly";
+        }>;
+        prices: z.ZodArray<z.ZodObject<{
+            currency: z.ZodString;
+            unitAmount: z.ZodNumber;
+            taxBehavior: z.ZodEnum<{
+                inclusive: "inclusive";
+                exclusive: "exclusive";
+                unspecified: "unspecified";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Available Pro and Teams prices. */
+export type PricesResponse = z.infer<typeof PricesResponseSchema>;
+/**
+ * Monthly and yearly amounts for a single currency. Each amount is a number in
+ * the currency's smallest unit, or a localized formatted string when the
+ * `pricing` endpoint is called with `formatted: true`.
+ */
+export declare const PricingTermsSchema: z.ZodObject<{
+    monthly: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    yearly: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+}, z.core.$strip>;
+/** Monthly/yearly amounts for one currency. */
+export type PricingTerms = z.infer<typeof PricingTermsSchema>;
+/**
+ * A pricing version entry: plan name (`pro` / `biz`) → currency code →
+ * {@link PricingTerms}.
+ */
+export declare const PricingVersionSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+    monthly: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    yearly: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+}, z.core.$strip>>>;
+/** Prices for one pricing version, keyed by plan then currency. */
+export type PricingVersion = z.infer<typeof PricingVersionSchema>;
+/**
+ * Response of the `pricing` endpoint: fixed version-pointer string fields plus
+ * dynamic version keys (`v1`, `v2`, …), each a {@link PricingVersion}.
+ */
+export declare const PricingResponseSchema: z.ZodObject<{
+    latestPro: z.ZodString;
+    latestBiz: z.ZodString;
+    sessionPro: z.ZodString;
+    sessionBiz: z.ZodString;
+}, z.core.$catchall<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+    monthly: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    yearly: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+}, z.core.$strip>>>>>;
+/** Current and legacy Pro/Teams pricing keyed by version. */
+export type PricingResponse = z.infer<typeof PricingResponseSchema>;

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

@@ -0,0 +1,2 @@
+export * from './types.js';
+export * from './requests.js';

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

@@ -0,0 +1,64 @@
+import type { RequireExactlyOne } from 'type-fest';
+import type { Comment } from './types.js';
+/**
+ * Arguments for retrieving comments.
+ * @see https://developer.todoist.com/api/v1/#tag/Comments/operation/get_comments_api_v1_comments_get
+ */
+export type GetCommentsArgs = {
+    taskId: string;
+    projectId?: never;
+    cursor?: string | null;
+    limit?: number;
+};
+/**
+ * Arguments for retrieving task comments.
+ * @see https://developer.todoist.com/api/v1/#tag/Comments/operation/get_comments_api_v1_comments_get
+ */
+export type GetTaskCommentsArgs = {
+    taskId: string;
+    projectId?: never;
+    cursor?: string | null;
+    limit?: number;
+};
+/**
+ * Arguments for retrieving project comments.
+ * @see https://developer.todoist.com/api/v1/#tag/Comments/operation/get_comments_api_v1_comments_get
+ */
+export type GetProjectCommentsArgs = {
+    projectId: string;
+    taskId?: never;
+    cursor?: string | null;
+    limit?: number;
+};
+/**
+ * Response from retrieving comments.
+ * @see https://developer.todoist.com/api/v1/#tag/Comments/operation/get_comments_api_v1_comments_get
+ */
+export type GetCommentsResponse = {
+    results: Comment[];
+    nextCursor: string | null;
+};
+/**
+ * Arguments for creating a new comment.
+ * @see https://developer.todoist.com/api/v1/#tag/Comments/operation/create_comment_api_v1_comments_post
+ */
+export type AddCommentArgs = {
+    content: string;
+    attachment?: {
+        fileName?: string;
+        fileUrl: string;
+        fileType?: string;
+        resourceType?: string;
+    } | null;
+    uidsToNotify?: string[];
+} & RequireExactlyOne<{
+    taskId?: string;
+    projectId?: string;
+}>;
+/**
+ * Arguments for updating a comment.
+ * @see https://developer.todoist.com/api/v1/#tag/Comments/operation/update_comment_api_v1_comments__comment_id__post
+ */
+export type UpdateCommentArgs = {
+    content: string;
+};

package/dist/types/types/comments/types.d.ts

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+/** Available file attachment upload states. */
+export declare const UPLOAD_STATES: readonly ["pending", "completed"];
+/** Upload state of a file attachment. */
+export type UploadState = (typeof UPLOAD_STATES)[number];
+export declare const AttachmentSchema: z.ZodObject<{
+    resourceType: z.ZodString;
+    fileName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fileSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    fileType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fileUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    fileDuration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    uploadState: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        pending: "pending";
+        completed: "completed";
+    }>>>;
+    image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    imageWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    imageHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Represents a file attachment in a comment.
+ * @see https://developer.todoist.com/api/v1/#tag/Sync/Comments/File-Attachments
+ */
+export type Attachment = z.infer<typeof AttachmentSchema>;
+export declare const RawCommentSchema: z.ZodObject<{
+    id: z.ZodString;
+    itemId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    postedAt: z.ZodCoercedDate<unknown>;
+    fileAttachment: z.ZodNullable<z.ZodObject<{
+        resourceType: z.ZodString;
+        fileName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        fileType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileDuration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        uploadState: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            pending: "pending";
+            completed: "completed";
+        }>>>;
+        image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        imageHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    postedUid: z.ZodString;
+    uidsToNotify: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    reactions: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    isDeleted: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Represents a raw comment response from the API.
+ * @see https://developer.todoist.com/api/v1/#tag/Comments
+ */
+export type RawComment = z.infer<typeof RawCommentSchema>;
+export declare const CommentSchema: z.ZodPipe<z.ZodObject<{
+    id: z.ZodString;
+    itemId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    postedAt: z.ZodCoercedDate<unknown>;
+    fileAttachment: z.ZodNullable<z.ZodObject<{
+        resourceType: z.ZodString;
+        fileName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        fileType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileDuration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        uploadState: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            pending: "pending";
+            completed: "completed";
+        }>>>;
+        image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        imageHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    postedUid: z.ZodString;
+    uidsToNotify: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    reactions: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    isDeleted: z.ZodBoolean;
+}, z.core.$strip>, z.ZodTransform<{
+    taskId: string | undefined;
+    id: string;
+    content: string;
+    postedAt: Date;
+    fileAttachment: {
+        resourceType: string;
+        fileName?: string | null | undefined;
+        fileSize?: number | null | undefined;
+        fileType?: string | null | undefined;
+        fileUrl?: string | null | undefined;
+        fileDuration?: number | null | undefined;
+        uploadState?: "pending" | "completed" | null | undefined;
+        image?: string | null | undefined;
+        imageWidth?: number | null | undefined;
+        imageHeight?: number | null | undefined;
+        url?: string | null | undefined;
+        title?: string | null | undefined;
+    } | null;
+    postedUid: string;
+    uidsToNotify: string[] | null;
+    reactions: Record<string, string[]> | null;
+    isDeleted: boolean;
+    projectId?: string | undefined;
+}, {
+    id: string;
+    content: string;
+    postedAt: Date;
+    fileAttachment: {
+        resourceType: string;
+        fileName?: string | null | undefined;
+        fileSize?: number | null | undefined;
+        fileType?: string | null | undefined;
+        fileUrl?: string | null | undefined;
+        fileDuration?: number | null | undefined;
+        uploadState?: "pending" | "completed" | null | undefined;
+        image?: string | null | undefined;
+        imageWidth?: number | null | undefined;
+        imageHeight?: number | null | undefined;
+        url?: string | null | undefined;
+        title?: string | null | undefined;
+    } | null;
+    postedUid: string;
+    uidsToNotify: string[] | null;
+    reactions: Record<string, string[]> | null;
+    isDeleted: boolean;
+    itemId?: string | undefined;
+    projectId?: string | undefined;
+}>>;
+/**
+ * Represents a comment in Todoist.
+ * @see https://developer.todoist.com/api/v1/#tag/Comments
+ */
+export type Comment = z.infer<typeof CommentSchema>;

package/dist/types/types/common.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+type SearchArgs = {
+    query: string;
+    cursor?: string | null;
+    limit?: number;
+};
+/**
+ * Zod schema that accepts both string and number values and coerces to string.
+ * The REST API returns numeric IDs while the Sync API returns string IDs.
+ */
+declare const StringOrNumberSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+export { StringOrNumberSchema };
+export type { SearchArgs };

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

@@ -0,0 +1 @@
+export * from './requests.js';

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

@@ -0,0 +1,30 @@
+/** Object types that support email forwarding. */
+export declare const EMAIL_OBJECT_TYPES: readonly ["project", "project_comments", "task"];
+/** Object type that supports email forwarding. */
+export type EmailObjectType = (typeof EMAIL_OBJECT_TYPES)[number];
+/**
+ * Arguments for getting or creating an email forwarding address.
+ * @see https://developer.todoist.com/api/v1/#tag/Emails/operation/email_get_or_create_api_v1_emails_put
+ */
+export type GetOrCreateEmailArgs = {
+    /** The type of object to forward emails to. */
+    objType: EmailObjectType;
+    /** The ID of the object. */
+    objId: string;
+};
+/**
+ * Response from getting or creating an email forwarding address.
+ */
+export type GetOrCreateEmailResponse = {
+    email: string;
+};
+/**
+ * Arguments for disabling email forwarding.
+ * @see https://developer.todoist.com/api/v1/#tag/Emails/operation/email_disable_api_v1_emails_delete
+ */
+export type DisableEmailArgs = {
+    /** The type of object to disable forwarding for. */
+    objType: EmailObjectType;
+    /** The ID of the object. */
+    objId: string;
+};

package/dist/types/types/errors.d.ts

@@ -0,0 +1,29 @@
+import { CustomError } from 'ts-custom-error';
+import type { SyncError, SyncResponse } from './sync/response.js';
+export declare class TodoistRequestError extends CustomError {
+    message: string;
+    httpStatusCode?: number | undefined;
+    responseData?: unknown | undefined;
+    constructor(message: string, httpStatusCode?: number | undefined, responseData?: unknown | undefined);
+    isAuthenticationError: () => boolean;
+}
+/**
+ * Thrown when the Sync API accepts a request but one or more of its commands fail.
+ *
+ * Sync commands are applied independently, so the commands that succeeded have
+ * already taken effect. `message`, `httpStatusCode` and `responseData` describe the
+ * first failed command, as on a plain {@link TodoistRequestError}, while
+ * `syncStatus` and `tempIdMapping` cover every command in the request, so callers
+ * can tell which ones were applied.
+ */
+export declare class TodoistSyncError extends TodoistRequestError {
+    /** Each command's outcome, keyed by the command's `uuid`: `'ok'` or the error it failed with. */
+    syncStatus: NonNullable<SyncResponse['syncStatus']>;
+    /** Server IDs assigned to the resources the request created, keyed by the command's `tempId`. */
+    tempIdMapping: NonNullable<SyncResponse['tempIdMapping']>;
+    constructor(firstFailure: SyncError, { syncStatus, tempIdMapping }: Pick<TodoistSyncError, 'syncStatus' | 'tempIdMapping'>);
+}
+export declare class TodoistArgumentError extends CustomError {
+    message: string;
+    constructor(message: string);
+}

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

@@ -0,0 +1 @@
+export * from './requests.js';

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

@@ -0,0 +1,20 @@
+import type { Folder } from '../sync/resources/folders.js';
+export type GetFoldersArgs = {
+    workspaceId: string;
+    cursor?: string | null;
+    limit?: number;
+};
+export type GetFoldersResponse = {
+    results: Folder[];
+    nextCursor: string | null;
+};
+export type AddFolderArgs = {
+    name: string;
+    workspaceId: string;
+    defaultOrder?: number | null;
+    childOrder?: number | null;
+};
+export type UpdateFolderArgs = {
+    name?: string | null;
+    defaultOrder?: number | null;
+};

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

@@ -0,0 +1,104 @@
+export type HttpMethod = 'POST' | 'GET' | 'DELETE' | 'PUT' | 'PATCH';
+/**
+ * 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;
+/**
+ * Custom fetch response interface that custom HTTP clients must implement.
+ *
+ * `arrayBuffer()` is optional for back-compat with existing implementations,
+ * but must be provided when the fetch is used with binary endpoints
+ * (`viewAttachment`, `downloadBackup`) — those endpoints throw at runtime if
+ * it is missing rather than fall back to a lossy `text()` round-trip.
+ */
+export type CustomFetchResponse = {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+    arrayBuffer?: () => Promise<ArrayBuffer>;
+};
+/**
+ * Extra headers sent with every API request: either a fixed record, or a function
+ * the SDK calls once per request (retries reuse its result) for values that change
+ * between requests, such as a per-request ID or the command currently running.
+ */
+export type CustomHeaders = Record<string, string> | (() => Record<string, string>);
+/**
+ * Custom fetch function type for alternative HTTP clients
+ */
+export type CustomFetch = (url: string, options?: RequestInit & {
+    timeout?: number;
+}) => Promise<CustomFetchResponse>;
+/**
+ * Response from a binary file endpoint (e.g. attachment view, backup download),
+ * extending CustomFetchResponse with `arrayBuffer()` support for binary content.
+ */
+export type FileResponse = CustomFetchResponse & {
+    arrayBuffer(): Promise<ArrayBuffer>;
+};

package/dist/types/types/id-mappings/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types.js';
+export * from './requests.js';

package/dist/types/types/id-mappings/requests.d.ts

@@ -0,0 +1,28 @@
+/** Object types that support ID mappings. */
+export declare const ID_MAPPING_OBJECT_TYPES: readonly ["sections", "tasks", "comments", "reminders", "location_reminders", "projects"];
+/** Object type that supports ID mappings. */
+export type IdMappingObjectType = (typeof ID_MAPPING_OBJECT_TYPES)[number];
+/** Object types that support moved ID lookups. */
+export declare const MOVED_ID_OBJECT_TYPES: readonly ["sections", "tasks", "comments", "reminders", "location_reminders"];
+/** Object type that supports moved ID lookups. */
+export type MovedIdObjectType = (typeof MOVED_ID_OBJECT_TYPES)[number];
+/**
+ * Arguments for getting ID mappings between old and new IDs.
+ * @see https://developer.todoist.com/api/v1/#tag/Ids/operation/id_mappings_api_v1_id_mappings__obj_name___obj_ids__get
+ */
+export type GetIdMappingsArgs = {
+    /** The type of object to look up. */
+    objName: IdMappingObjectType;
+    /** Array of IDs to look up. */
+    objIds: [string, ...string[]];
+};
+/**
+ * Arguments for getting moved IDs.
+ * @see https://developer.todoist.com/api/v1/#tag/Ids/operation/moved_ids_api_v1_moved_ids__obj_name__get
+ */
+export type GetMovedIdsArgs = {
+    /** The type of object to look up. */
+    objName: MovedIdObjectType;
+    /** Array of old IDs to look up. */
+    oldIds?: string[];
+};

package/dist/types/types/id-mappings/types.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const IdMappingSchema: z.ZodObject<{
+    oldId: z.ZodNullable<z.ZodString>;
+    newId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** Mapping between old and new IDs after migration. */
+export type IdMapping = z.infer<typeof IdMappingSchema>;
+export declare const MovedIdSchema: z.ZodObject<{
+    oldId: z.ZodString;
+    newId: z.ZodString;
+}, z.core.$strip>;
+/** A moved ID pair (old to new). */
+export type MovedId = z.infer<typeof MovedIdSchema>;