ticktick-mcp 0.1.0

package/dist/sdk/errors.d.ts

@@ -0,0 +1,92 @@
+/**
+ * TickTick SDK Error Classes
+ *
+ * Custom error classes for handling TickTick API errors.
+ */
+import type { ApiErrorResponse } from "./types.js";
+/**
+ * Base error class for all TickTick SDK errors.
+ */
+export declare class TickTickError extends Error {
+    /** Error name for instanceof checks */
+    name: string;
+    constructor(message: string);
+}
+/**
+ * Error thrown when an API request fails.
+ * Contains HTTP status code and response details.
+ */
+export declare class TickTickApiError extends TickTickError {
+    name: string;
+    /** HTTP status code */
+    readonly statusCode: number;
+    /** Error code from the API response */
+    readonly errorCode?: string;
+    /** Raw response body */
+    readonly responseBody?: ApiErrorResponse;
+    constructor(message: string, statusCode: number, errorCode?: string, responseBody?: ApiErrorResponse);
+    /**
+     * Create an error from an HTTP response.
+     */
+    static fromResponse(response: Response): Promise<TickTickApiError>;
+}
+/**
+ * Error thrown when authentication fails or the token is invalid/expired.
+ */
+export declare class TickTickAuthError extends TickTickApiError {
+    name: string;
+    constructor(message: string, responseBody?: ApiErrorResponse);
+}
+/**
+ * Error thrown when the user doesn't have permission to access a resource.
+ */
+export declare class TickTickForbiddenError extends TickTickApiError {
+    name: string;
+    constructor(message: string, responseBody?: ApiErrorResponse);
+}
+/**
+ * Error thrown when a requested resource is not found.
+ */
+export declare class TickTickNotFoundError extends TickTickApiError {
+    name: string;
+    constructor(message: string, responseBody?: ApiErrorResponse);
+}
+/**
+ * Error thrown when rate limits are exceeded.
+ */
+export declare class TickTickRateLimitError extends TickTickApiError {
+    name: string;
+    /** Time to wait before retrying (in seconds), if provided by the API */
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number, responseBody?: ApiErrorResponse);
+}
+/**
+ * Error thrown when the request is invalid (bad parameters, etc.).
+ */
+export declare class TickTickBadRequestError extends TickTickApiError {
+    name: string;
+    constructor(message: string, responseBody?: ApiErrorResponse);
+}
+/**
+ * Error thrown when a request times out.
+ */
+export declare class TickTickTimeoutError extends TickTickError {
+    name: string;
+    /** The timeout duration that was exceeded (in milliseconds) */
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number);
+}
+/**
+ * Error thrown when there's a network connectivity issue.
+ */
+export declare class TickTickNetworkError extends TickTickError {
+    name: string;
+    /** The underlying error that caused the network failure */
+    readonly cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Create the appropriate error class based on HTTP status code.
+ */
+export declare function createErrorFromResponse(response: Response): Promise<TickTickApiError>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/sdk/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/sdk/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,uCAAuC;IAC9B,IAAI,SAAmB;gBAEpB,OAAO,EAAE,MAAM;CAO5B;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACxC,IAAI,SAAsB;IAEnC,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,uCAAuC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,wBAAwB;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,gBAAgB;IAQjC;;OAEG;WACU,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAwBzE;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IAC5C,IAAI,SAAuB;gBAExB,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,gBAAgB;CAG7D;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;IACjD,IAAI,SAA4B;gBAE7B,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,gBAAgB;CAG7D;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IAChD,IAAI,SAA2B;gBAE5B,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,gBAAgB;CAG7D;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;IACjD,IAAI,SAA4B;IAEzC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,gBAAgB;CAKlC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,gBAAgB;IAClD,IAAI,SAA6B;gBAE9B,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,gBAAgB;CAG7D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IAC5C,IAAI,SAA0B;IAEvC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI/C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IAC5C,IAAI,SAA0B;IAEvC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,gBAAgB,CAAC,CA4C3B"}

package/dist/sdk/errors.js

@@ -0,0 +1,187 @@
+/**
+ * TickTick SDK Error Classes
+ *
+ * Custom error classes for handling TickTick API errors.
+ */
+/**
+ * Base error class for all TickTick SDK errors.
+ */
+export class TickTickError extends Error {
+    /** Error name for instanceof checks */
+    name = "TickTickError";
+    constructor(message) {
+        super(message);
+        // Maintains proper stack trace for where error was thrown (only in V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * Error thrown when an API request fails.
+ * Contains HTTP status code and response details.
+ */
+export class TickTickApiError extends TickTickError {
+    name = "TickTickApiError";
+    /** HTTP status code */
+    statusCode;
+    /** Error code from the API response */
+    errorCode;
+    /** Raw response body */
+    responseBody;
+    constructor(message, statusCode, errorCode, responseBody) {
+        super(message);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.responseBody = responseBody;
+    }
+    /**
+     * Create an error from an HTTP response.
+     */
+    static async fromResponse(response) {
+        let body;
+        let message = `HTTP ${response.status}: ${response.statusText}`;
+        let errorCode;
+        try {
+            const text = await response.text();
+            if (text) {
+                body = JSON.parse(text);
+                if (body.error_description) {
+                    message = body.error_description;
+                }
+                else if (body.message) {
+                    message = body.message;
+                }
+                else if (body.error) {
+                    message = body.error;
+                }
+                errorCode = body.error;
+            }
+        }
+        catch {
+            // Failed to parse response body - use default message
+        }
+        return new TickTickApiError(message, response.status, errorCode, body);
+    }
+}
+/**
+ * Error thrown when authentication fails or the token is invalid/expired.
+ */
+export class TickTickAuthError extends TickTickApiError {
+    name = "TickTickAuthError";
+    constructor(message, responseBody) {
+        super(message, 401, "unauthorized", responseBody);
+    }
+}
+/**
+ * Error thrown when the user doesn't have permission to access a resource.
+ */
+export class TickTickForbiddenError extends TickTickApiError {
+    name = "TickTickForbiddenError";
+    constructor(message, responseBody) {
+        super(message, 403, "forbidden", responseBody);
+    }
+}
+/**
+ * Error thrown when a requested resource is not found.
+ */
+export class TickTickNotFoundError extends TickTickApiError {
+    name = "TickTickNotFoundError";
+    constructor(message, responseBody) {
+        super(message, 404, "not_found", responseBody);
+    }
+}
+/**
+ * Error thrown when rate limits are exceeded.
+ */
+export class TickTickRateLimitError extends TickTickApiError {
+    name = "TickTickRateLimitError";
+    /** Time to wait before retrying (in seconds), if provided by the API */
+    retryAfter;
+    constructor(message, retryAfter, responseBody) {
+        super(message, 429, "rate_limited", responseBody);
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Error thrown when the request is invalid (bad parameters, etc.).
+ */
+export class TickTickBadRequestError extends TickTickApiError {
+    name = "TickTickBadRequestError";
+    constructor(message, responseBody) {
+        super(message, 400, "bad_request", responseBody);
+    }
+}
+/**
+ * Error thrown when a request times out.
+ */
+export class TickTickTimeoutError extends TickTickError {
+    name = "TickTickTimeoutError";
+    /** The timeout duration that was exceeded (in milliseconds) */
+    timeoutMs;
+    constructor(message, timeoutMs) {
+        super(message);
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Error thrown when there's a network connectivity issue.
+ */
+export class TickTickNetworkError extends TickTickError {
+    name = "TickTickNetworkError";
+    /** The underlying error that caused the network failure */
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+    }
+}
+/**
+ * Create the appropriate error class based on HTTP status code.
+ */
+export async function createErrorFromResponse(response) {
+    let body;
+    let message = `HTTP ${response.status}: ${response.statusText}`;
+    let retryAfter;
+    try {
+        const text = await response.text();
+        if (text) {
+            body = JSON.parse(text);
+            if (body.error_description) {
+                message = body.error_description;
+            }
+            else if (body.message) {
+                message = body.message;
+            }
+            else if (body.error) {
+                message = body.error;
+            }
+        }
+    }
+    catch {
+        // Failed to parse response body - use default message
+    }
+    // Try to get retry-after header for rate limit errors
+    const retryAfterHeader = response.headers.get("retry-after");
+    if (retryAfterHeader) {
+        retryAfter = parseInt(retryAfterHeader, 10);
+        if (isNaN(retryAfter)) {
+            retryAfter = undefined;
+        }
+    }
+    switch (response.status) {
+        case 400:
+            return new TickTickBadRequestError(message, body);
+        case 401:
+            return new TickTickAuthError(message, body);
+        case 403:
+            return new TickTickForbiddenError(message, body);
+        case 404:
+            return new TickTickNotFoundError(message, body);
+        case 429:
+            return new TickTickRateLimitError(message, retryAfter, body);
+        default:
+            return new TickTickApiError(message, response.status, body?.error, body);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/sdk/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/sdk/errors.ts"],"names":[],"mappings":"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"}

package/dist/sdk/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * TickTick SDK
+ *
+ * A TypeScript SDK for interacting with the TickTick Open API.
+ *
+ * @example
+ * ```typescript
+ * import { TickTickClient, Priority, Status } from './sdk';
+ *
+ * const client = new TickTickClient({
+ *   accessToken: 'your-oauth-access-token',
+ *   region: 'global',
+ * });
+ *
+ * // Get user info
+ * const user = await client.getUser();
+ *
+ * // List projects
+ * const projects = await client.listProjects();
+ *
+ * // Create a task
+ * const task = await client.createTask({
+ *   title: 'My task',
+ *   projectId: projects[0].id,
+ *   priority: Priority.High,
+ * });
+ *
+ * // Complete the task
+ * await client.completeTask(task.projectId, task.id);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { TickTickClient } from "./client.js";
+export type { User, Project, CreateProjectInput, UpdateProjectInput, ProjectWithTasks, Task, CreateTaskInput, UpdateTaskInput, BatchCreateTasksInput, ChecklistItem, ChecklistItemInput, TokenResponse, OAuthError, TickTickClientConfig, Region, ViewMode, ProjectKind, TaskKind, ApiErrorResponse, } from "./types.js";
+export { Priority, Status } from "./types.js";
+export { TickTickError, TickTickApiError, TickTickAuthError, TickTickForbiddenError, TickTickNotFoundError, TickTickRateLimitError, TickTickBadRequestError, TickTickTimeoutError, TickTickNetworkError, createErrorFromResponse, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7C,YAAY,EAEV,IAAI,EAGJ,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAGhB,IAAI,EACJ,eAAe,EACf,eAAe,EACf,qBAAqB,EAGrB,aAAa,EACb,kBAAkB,EAGlB,aAAa,EACb,UAAU,EAGV,oBAAoB,EACpB,MAAM,EACN,QAAQ,EACR,WAAW,EACX,QAAQ,EAGR,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAM9C,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/sdk/index.js

@@ -0,0 +1,46 @@
+/**
+ * TickTick SDK
+ *
+ * A TypeScript SDK for interacting with the TickTick Open API.
+ *
+ * @example
+ * ```typescript
+ * import { TickTickClient, Priority, Status } from './sdk';
+ *
+ * const client = new TickTickClient({
+ *   accessToken: 'your-oauth-access-token',
+ *   region: 'global',
+ * });
+ *
+ * // Get user info
+ * const user = await client.getUser();
+ *
+ * // List projects
+ * const projects = await client.listProjects();
+ *
+ * // Create a task
+ * const task = await client.createTask({
+ *   title: 'My task',
+ *   projectId: projects[0].id,
+ *   priority: Priority.High,
+ * });
+ *
+ * // Complete the task
+ * await client.completeTask(task.projectId, task.id);
+ * ```
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Client
+// =============================================================================
+export { TickTickClient } from "./client.js";
+// =============================================================================
+// Enums
+// =============================================================================
+export { Priority, Status } from "./types.js";
+// =============================================================================
+// Error Classes
+// =============================================================================
+export { TickTickError, TickTickApiError, TickTickAuthError, TickTickForbiddenError, TickTickNotFoundError, TickTickRateLimitError, TickTickBadRequestError, TickTickTimeoutError, TickTickNetworkError, createErrorFromResponse, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAyC7C,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9C,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/sdk/types.d.ts

@@ -0,0 +1,308 @@
+/**
+ * TickTick SDK Types
+ *
+ * TypeScript interfaces and types for the TickTick API.
+ * Based on the official TickTick Open API documentation.
+ */
+/**
+ * Task priority levels.
+ */
+export declare enum Priority {
+    None = 0,
+    Low = 1,
+    Medium = 3,
+    High = 5
+}
+/**
+ * Task/checklist item status.
+ */
+export declare enum Status {
+    Normal = 0,
+    Completed = 1
+}
+/**
+ * Project view modes.
+ */
+export type ViewMode = "list" | "kanban" | "timeline";
+/**
+ * Project/task kind.
+ */
+export type ProjectKind = "TASK" | "NOTE";
+/**
+ * Task kind.
+ */
+export type TaskKind = "TEXT";
+/**
+ * API region configuration.
+ */
+export type Region = "global" | "china";
+/**
+ * TickTick user information.
+ */
+export interface User {
+    /** Unique user identifier */
+    id: string;
+    /** User's email/username */
+    username: string;
+    /** User's display name */
+    name: string;
+}
+/**
+ * A subtask/checklist item within a task.
+ */
+export interface ChecklistItem {
+    /** Unique item identifier */
+    id: string;
+    /** Item text/title */
+    title: string;
+    /** Item status: 0 = unchecked, 1 = checked */
+    status: Status;
+    /** When the item was completed (ISO 8601) */
+    completedTime: string | null;
+    /** Whether this has an all-day date */
+    isAllDay: boolean;
+    /** Start date (ISO 8601) */
+    startDate: string | null;
+    /** Timezone (IANA format) */
+    timeZone: string;
+    /** Position in the checklist */
+    sortOrder: number;
+}
+/**
+ * Input for creating a checklist item.
+ */
+export interface ChecklistItemInput {
+    /** Item text/title */
+    title: string;
+    /** Item status: 0 = unchecked, 1 = checked */
+    status?: Status;
+    /** Whether this has an all-day date */
+    isAllDay?: boolean;
+    /** Start date (ISO 8601) */
+    startDate?: string | null;
+    /** Timezone (IANA format) */
+    timeZone?: string;
+    /** Position in the checklist */
+    sortOrder?: number;
+}
+/**
+ * Complete Task object as returned by the API.
+ */
+export interface Task {
+    /** Unique task identifier */
+    id: string;
+    /** ID of the parent project */
+    projectId: string;
+    /** Task title */
+    title: string;
+    /** Task description/notes */
+    content: string;
+    /** Additional description */
+    desc: string;
+    /** Whether this is an all-day task */
+    allDay: boolean;
+    /** Start date (ISO 8601) */
+    startDate: string | null;
+    /** Due date (ISO 8601) */
+    dueDate: string | null;
+    /** IANA timezone */
+    timeZone: string;
+    /** Whether the date is timezone-independent */
+    isFloating: boolean;
+    /** Array of reminders (iCalendar TRIGGER format) */
+    reminders: string[];
+    /** Recurrence rule (RRULE format) */
+    repeat: string;
+    /** Priority: 0=None, 1=Low, 3=Medium, 5=High */
+    priority: Priority;
+    /** Status: 0=Normal, 1=Completed */
+    status: Status;
+    /** When task was completed (ISO 8601) */
+    completedTime: string | null;
+    /** Position in list */
+    sortOrder: number;
+    /** Array of tag names */
+    tags: string[];
+    /** Array of subtasks/checklist items */
+    items: ChecklistItem[];
+    /** Last modification timestamp (ISO 8601) */
+    modifiedTime: string;
+    /** Creation timestamp (ISO 8601) */
+    createdTime: string;
+    /** Version identifier for sync */
+    etag: string;
+    /** Deletion flag (0=not deleted) */
+    deleted: number;
+    /** User ID of creator */
+    creator: number;
+    /** Task type */
+    kind: TaskKind;
+}
+/**
+ * Input for creating a new task.
+ */
+export interface CreateTaskInput {
+    /** Task title (required) */
+    title: string;
+    /** Project ID (defaults to inbox if not specified) */
+    projectId?: string;
+    /** Task description/notes */
+    content?: string;
+    /** Whether this is an all-day task */
+    allDay?: boolean;
+    /** Start date (ISO 8601: yyyy-MM-dd'T'HH:mm:ssZ) */
+    startDate?: string;
+    /** Due date (ISO 8601: yyyy-MM-dd'T'HH:mm:ssZ) */
+    dueDate?: string;
+    /** IANA timezone (e.g., "America/New_York") */
+    timeZone?: string;
+    /** Array of reminders in iCalendar TRIGGER format */
+    reminders?: string[];
+    /** Recurrence rule in RRULE format */
+    repeat?: string;
+    /** Priority: 0=None, 1=Low, 3=Medium, 5=High */
+    priority?: Priority;
+    /** Array of subtask/checklist items */
+    items?: ChecklistItemInput[];
+}
+/**
+ * Input for updating an existing task.
+ * All fields are optional - only include fields you want to update.
+ */
+export interface UpdateTaskInput {
+    /** Task title */
+    title?: string;
+    /** Project ID (to move task to another project) */
+    projectId?: string;
+    /** Task description/notes */
+    content?: string;
+    /** Whether this is an all-day task */
+    allDay?: boolean;
+    /** Start date (ISO 8601) */
+    startDate?: string | null;
+    /** Due date (ISO 8601) */
+    dueDate?: string | null;
+    /** IANA timezone */
+    timeZone?: string;
+    /** Array of reminders in iCalendar TRIGGER format */
+    reminders?: string[];
+    /** Recurrence rule in RRULE format */
+    repeat?: string;
+    /** Priority: 0=None, 1=Low, 3=Medium, 5=High */
+    priority?: Priority;
+    /** Array of subtask/checklist items */
+    items?: ChecklistItemInput[];
+    /** Array of tag names */
+    tags?: string[];
+}
+/**
+ * Complete Project object as returned by the API.
+ */
+export interface Project {
+    /** Unique project identifier */
+    id: string;
+    /** Project name */
+    name: string;
+    /** Hex color code (e.g., "#ff6b6b") */
+    color: string;
+    /** Position in project list */
+    sortOrder: number;
+    /** Whether project is archived */
+    closed: boolean;
+    /** Parent folder ID */
+    groupId: string | null;
+    /** View mode: "list", "kanban", or "timeline" */
+    viewMode: ViewMode;
+    /** Project type: "TASK" or "NOTE" */
+    kind: ProjectKind;
+}
+/**
+ * Input for creating a new project.
+ */
+export interface CreateProjectInput {
+    /** Project name (required) */
+    name: string;
+    /** Hex color code (e.g., "#ff6b6b") */
+    color?: string;
+    /** View mode: "list", "kanban", or "timeline" */
+    viewMode?: ViewMode;
+    /** Project type: "TASK" or "NOTE" */
+    kind?: ProjectKind;
+}
+/**
+ * Input for updating an existing project.
+ * All fields are optional - only include fields you want to update.
+ */
+export interface UpdateProjectInput {
+    /** Project name */
+    name?: string;
+    /** Hex color code */
+    color?: string;
+    /** View mode */
+    viewMode?: ViewMode;
+    /** Project type */
+    kind?: ProjectKind;
+}
+/**
+ * Project data including all tasks.
+ */
+export interface ProjectWithTasks {
+    /** The project */
+    project: Project;
+    /** All tasks in the project */
+    tasks: Task[];
+}
+/**
+ * Input for batch creating tasks.
+ */
+export interface BatchCreateTasksInput {
+    /** Array of tasks to create */
+    add: CreateTaskInput[];
+}
+/**
+ * OAuth token response from the token endpoint.
+ */
+export interface TokenResponse {
+    /** The access token for API requests */
+    access_token: string;
+    /** Token type (typically "bearer") */
+    token_type: string;
+    /** Token expiration time in seconds */
+    expires_in: number;
+    /** Refresh token for obtaining new access tokens */
+    refresh_token: string;
+}
+/**
+ * OAuth error response.
+ */
+export interface OAuthError {
+    /** Error code */
+    error: string;
+    /** Human-readable error description */
+    error_description: string;
+}
+/**
+ * Configuration options for the TickTick SDK client.
+ */
+export interface TickTickClientConfig {
+    /** OAuth access token */
+    accessToken: string;
+    /** API region: "global" (ticktick.com) or "china" (dida365.com) */
+    region?: Region;
+    /** Optional custom base URL (overrides region setting) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Generic API error response structure.
+ */
+export interface ApiErrorResponse {
+    /** Error code or type */
+    error?: string;
+    /** Error message */
+    message?: string;
+    /** Detailed error description */
+    error_description?: string;
+}
+//# sourceMappingURL=types.d.ts.map