@doist/todoist-api-typescript 7.5.0 → 7.6.0

package/dist/types/types/entities.d.ts

@@ -9,7 +9,7 @@ export declare const DueDateSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Represents a due date for a task.
- * @see https://todoist.com/api/v1/docs#tag/Tasks/operation/get_tasks_api_v1_tasks_get
+ * @see https://developer.todoist.com/api/v1/#tag/Tasks/operation/get_tasks_api_v1_tasks_get
  */
 export type DueDate = z.infer<typeof DueDateSchema>;
 /** Available duration units for task deadlines. */
@@ -25,7 +25,7 @@ export declare const DurationSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Represents a duration for a task deadline.
- * @see https://todoist.com/api/v1/docs#tag/Tasks
+ * @see https://developer.todoist.com/api/v1/#tag/Tasks
  */
 export type Duration = z.infer<typeof DurationSchema>;
 export declare const DeadlineSchema: z.ZodObject<{
@@ -157,7 +157,7 @@ export declare const TaskSchema: z.ZodPipe<z.ZodObject<{
 }>>;
 /**
  * Represents a task in Todoist.
- * @see https://todoist.com/api/v1/docs#tag/Tasks
+ * @see https://developer.todoist.com/api/v1/#tag/Tasks
  */
 export type Task = z.infer<typeof TaskSchema>;
 /**
@@ -345,19 +345,19 @@ export declare const WorkspaceProjectSchema: z.ZodPipe<z.ZodObject<{
 }>>;
 /**
  * Represents a personal project in Todoist.
- * @see https://todoist.com/api/v1/docs#tag/Projects
+ * @see https://developer.todoist.com/api/v1/#tag/Projects
  */
 export type PersonalProject = z.infer<typeof PersonalProjectSchema>;
 /**
  * Represents a workspace project in Todoist.
- * @see https://todoist.com/api/v1/docs#tag/Projects
+ * @see https://developer.todoist.com/api/v1/#tag/Projects
  */
 export type WorkspaceProject = z.infer<typeof WorkspaceProjectSchema>;
 /** Available project view styles. */
 export declare const PROJECT_VIEW_STYLES: readonly ["list", "board", "calendar"];
 /**
  * View style for a project.
- * @see https://todoist.com/api/v1/docs#tag/Projects
+ * @see https://developer.todoist.com/api/v1/#tag/Projects
  */
 export type ProjectViewStyle = (typeof PROJECT_VIEW_STYLES)[number];
 export declare const SectionSchema: z.ZodPipe<z.ZodObject<{
@@ -400,7 +400,7 @@ export declare const SectionSchema: z.ZodPipe<z.ZodObject<{
 }>>;
 /**
  * Represents a section in a Todoist project.
- * @see https://todoist.com/api/v1/docs#tag/Sections
+ * @see https://developer.todoist.com/api/v1/#tag/Sections
  */
 export type Section = z.infer<typeof SectionSchema>;
 export declare const LabelSchema: z.ZodObject<{
@@ -412,7 +412,7 @@ export declare const LabelSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Represents a label in Todoist.
- * @see https://todoist.com/api/v1/docs#tag/Labels
+ * @see https://developer.todoist.com/api/v1/#tag/Labels
  */
 export type Label = z.infer<typeof LabelSchema>;
 /** Available file attachment upload states. */
@@ -438,7 +438,7 @@ export declare const AttachmentSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Represents a file attachment in a comment.
- * @see https://todoist.com/api/v1/docs#tag/Sync/Comments/File-Attachments
+ * @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<{
@@ -471,7 +471,7 @@ export declare const RawCommentSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Represents a raw comment response from the API.
- * @see https://todoist.com/api/v1/docs#tag/Comments
+ * @see https://developer.todoist.com/api/v1/#tag/Comments
  */
 export type RawComment = z.infer<typeof RawCommentSchema>;
 export declare const CommentSchema: z.ZodPipe<z.ZodObject<{
@@ -552,7 +552,7 @@ export declare const CommentSchema: z.ZodPipe<z.ZodObject<{
 }>>;
 /**
  * Represents a comment in Todoist.
- * @see https://todoist.com/api/v1/docs#tag/Comments
+ * @see https://developer.todoist.com/api/v1/#tag/Comments
  */
 export type Comment = z.infer<typeof CommentSchema>;
 export declare const UserSchema: z.ZodObject<{
@@ -562,7 +562,7 @@ export declare const UserSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Represents a user in Todoist (simplified for collaborators).
- * @see https://todoist.com/api/v1/docs#tag/User
+ * @see https://developer.todoist.com/api/v1/#tag/User
  */
 export type User = z.infer<typeof UserSchema>;
 export declare const TimezoneInfoSchema: z.ZodObject<{
@@ -617,7 +617,7 @@ export declare const CurrentUserSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Represents the current authenticated user with detailed information.
- * @see https://todoist.com/api/v1/docs#tag/User
+ * @see https://developer.todoist.com/api/v1/#tag/User
  */
 export type CurrentUser = z.infer<typeof CurrentUserSchema>;
 export declare const StreakSchema: z.ZodObject<{
@@ -731,7 +731,7 @@ export declare const ColorSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Represents a color in Todoist.
- * @see https://todoist.com/api/v1/docs#tag/Colors
+ * @see https://developer.todoist.com/api/v1/#tag/Colors
  */
 export type Color = z.infer<typeof ColorSchema>;
 /**
@@ -968,4 +968,244 @@ export declare const WorkspaceSchema: z.ZodObject<{
     properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
 export type Workspace = z.infer<typeof WorkspaceSchema>;
+export declare const MemberActivityInfoSchema: z.ZodObject<{
+    userId: z.ZodString;
+    tasksAssigned: z.ZodNumber;
+    tasksOverdue: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Represents activity information for a workspace member.
+ */
+export type MemberActivityInfo = z.infer<typeof MemberActivityInfoSchema>;
+export declare const WorkspaceUserTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    responsibleUid: z.ZodNullable<z.ZodString>;
+    due: z.ZodNullable<z.ZodObject<{
+        isRecurring: z.ZodBoolean;
+        string: z.ZodString;
+        date: z.ZodString;
+        datetime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lang: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    deadline: z.ZodNullable<z.ZodObject<{
+        date: z.ZodString;
+        lang: z.ZodString;
+    }, z.core.$strip>>;
+    labels: z.ZodArray<z.ZodString>;
+    notesCount: z.ZodNumber;
+    projectId: z.ZodString;
+    projectName: z.ZodString;
+    priority: z.ZodNumber;
+    description: z.ZodString;
+    isOverdue: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Represents a task assigned to a workspace user.
+ */
+export type WorkspaceUserTask = z.infer<typeof WorkspaceUserTaskSchema>;
+export declare const DayActivitySchema: z.ZodObject<{
+    date: z.ZodString;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>;
+/** Daily activity count for a specific date. */
+export type DayActivity = z.infer<typeof DayActivitySchema>;
+export declare const WeekRollupSchema: z.ZodObject<{
+    fromDate: z.ZodString;
+    toDate: z.ZodString;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>;
+/** Weekly rollup of activity data. */
+export type WeekRollup = z.infer<typeof WeekRollupSchema>;
+export declare const ProjectActivityStatsSchema: z.ZodObject<{
+    dayItems: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        totalCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    weekItems: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        fromDate: z.ZodString;
+        toDate: z.ZodString;
+        totalCount: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** Project activity statistics with daily and optional weekly rollups. */
+export type ProjectActivityStats = z.infer<typeof ProjectActivityStatsSchema>;
+/** Available project health statuses. */
+export declare const HEALTH_STATUSES: readonly ["UNKNOWN", "ON_TRACK", "AT_RISK", "CRITICAL", "EXCELLENT", "ERROR"];
+/** Health status of a project. */
+export type HealthStatus = (typeof HEALTH_STATUSES)[number];
+export declare const TaskRecommendationSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    recommendation: z.ZodString;
+}, z.core.$strip>;
+/** A recommendation for a specific task. */
+export type TaskRecommendation = z.infer<typeof TaskRecommendationSchema>;
+export declare const ProjectHealthSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
+        ON_TRACK: "ON_TRACK";
+        AT_RISK: "AT_RISK";
+        CRITICAL: "CRITICAL";
+        EXCELLENT: "EXCELLENT";
+        ERROR: "ERROR";
+    }>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    descriptionSummary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    taskRecommendations: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        recommendation: z.ZodString;
+    }, z.core.$strip>>>>;
+    projectId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isStale: z.ZodDefault<z.ZodBoolean>;
+    updateInProgress: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Project health status and recommendations. */
+export type ProjectHealth = z.infer<typeof ProjectHealthSchema>;
+export declare const ProjectMetricsSchema: z.ZodObject<{
+    totalTasks: z.ZodNumber;
+    completedTasks: z.ZodNumber;
+    overdueTasks: z.ZodNumber;
+    tasksCreatedThisWeek: z.ZodNumber;
+    tasksCompletedThisWeek: z.ZodNumber;
+    averageCompletionTime: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+/** Project metrics summary. */
+export type ProjectMetrics = z.infer<typeof ProjectMetricsSchema>;
+export declare const TaskContextSchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    due: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deadline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    priority: z.ZodString;
+    isCompleted: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodString>;
+    completedByUid: z.ZodNullable<z.ZodString>;
+    labels: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** Task context used in health analysis. */
+export type TaskContext = z.infer<typeof TaskContextSchema>;
+export declare const ProjectHealthContextSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    projectName: z.ZodString;
+    projectDescription: z.ZodNullable<z.ZodString>;
+    projectMetrics: z.ZodObject<{
+        totalTasks: z.ZodNumber;
+        completedTasks: z.ZodNumber;
+        overdueTasks: z.ZodNumber;
+        tasksCreatedThisWeek: z.ZodNumber;
+        tasksCompletedThisWeek: z.ZodNumber;
+        averageCompletionTime: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        due: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        deadline: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        priority: z.ZodString;
+        isCompleted: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        completedAt: z.ZodNullable<z.ZodString>;
+        completedByUid: z.ZodNullable<z.ZodString>;
+        labels: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** Full project context for health analysis. */
+export type ProjectHealthContext = z.infer<typeof ProjectHealthContextSchema>;
+export declare const ProjectProgressSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    completedCount: z.ZodNumber;
+    activeCount: z.ZodNumber;
+    progressPercent: z.ZodNumber;
+}, z.core.$strip>;
+/** Project progress with completion counts and percentage. */
+export type ProjectProgress = z.infer<typeof ProjectProgressSchema>;
+export declare const ProjectInsightSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    health: z.ZodNullable<z.ZodObject<{
+        status: z.ZodEnum<{
+            UNKNOWN: "UNKNOWN";
+            ON_TRACK: "ON_TRACK";
+            AT_RISK: "AT_RISK";
+            CRITICAL: "CRITICAL";
+            EXCELLENT: "EXCELLENT";
+            ERROR: "ERROR";
+        }>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        descriptionSummary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taskRecommendations: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            taskId: z.ZodString;
+            recommendation: z.ZodString;
+        }, z.core.$strip>>>>;
+        projectId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        isStale: z.ZodDefault<z.ZodBoolean>;
+        updateInProgress: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    progress: z.ZodNullable<z.ZodObject<{
+        projectId: z.ZodString;
+        completedCount: z.ZodNumber;
+        activeCount: z.ZodNumber;
+        progressPercent: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Insight data for a single project within a workspace. */
+export type ProjectInsight = z.infer<typeof ProjectInsightSchema>;
+export declare const WorkspaceInsightsSchema: z.ZodObject<{
+    folderId: z.ZodNullable<z.ZodString>;
+    projectInsights: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        health: z.ZodNullable<z.ZodObject<{
+            status: z.ZodEnum<{
+                UNKNOWN: "UNKNOWN";
+                ON_TRACK: "ON_TRACK";
+                AT_RISK: "AT_RISK";
+                CRITICAL: "CRITICAL";
+                EXCELLENT: "EXCELLENT";
+                ERROR: "ERROR";
+            }>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            descriptionSummary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            taskRecommendations: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+                taskId: z.ZodString;
+                recommendation: z.ZodString;
+            }, z.core.$strip>>>>;
+            projectId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            updatedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            isStale: z.ZodDefault<z.ZodBoolean>;
+            updateInProgress: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        progress: z.ZodNullable<z.ZodObject<{
+            projectId: z.ZodString;
+            completedCount: z.ZodNumber;
+            activeCount: z.ZodNumber;
+            progressPercent: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Workspace insights grouped by folder. */
+export type WorkspaceInsights = z.infer<typeof WorkspaceInsightsSchema>;
+export declare const BackupSchema: z.ZodObject<{
+    version: z.ZodString;
+    url: z.ZodString;
+}, z.core.$strip>;
+/** Represents a backup snapshot. */
+export type Backup = z.infer<typeof BackupSchema>;
+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>;
 export {};