@todoist/sdk 0.0.1 → 19.0.0

package/dist/esm/types/sync/resources/suggestions.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/** Available template types. */
+export const TEMPLATE_TYPES = ['project', 'setup'];
+export const TemplateSuggestionSchema = z.looseObject({
+    id: z.string(),
+    name: z.string(),
+    templateType: z.enum(TEMPLATE_TYPES),
+});
+export const WorkspaceTemplateSuggestionSchema = TemplateSuggestionSchema.extend({
+    workspaceId: z.string().nullable(),
+});
+/** Available suggestion section types. */
+export const SUGGESTION_SECTION_TYPES = ['templates', 'most_used_user_templates'];
+export const SyncTemplateSuggestionsSchema = z.looseObject({
+    type: z.enum(SUGGESTION_SECTION_TYPES),
+    content: z.object({
+        templates: z.array(TemplateSuggestionSchema),
+        locale: z.string(),
+    }),
+    isDeleted: z.boolean(),
+});
+export const SyncWorkspaceTemplateSuggestionsSchema = z.looseObject({
+    type: z.literal('most_used_workspace_templates'),
+    content: z.object({
+        templates: z.array(WorkspaceTemplateSuggestionSchema),
+        locale: z.string(),
+    }),
+    isDeleted: z.boolean(),
+});
+export const SuggestionSchema = z.union([
+    SyncWorkspaceTemplateSuggestionsSchema,
+    SyncTemplateSuggestionsSchema,
+]);

package/dist/esm/types/sync/resources/tooltips.js

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export const TooltipsSchema = z.looseObject({
+    seen: z.array(z.string()).optional(),
+    scheduled: z.array(z.string()).optional(),
+});

package/dist/esm/types/sync/resources/user-plan-limits.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export const PlanLimitsSchema = z.looseObject({
+    activeProjects: z.number().int().optional(),
+    activityLog: z.boolean().optional(),
+    collaboratorsPerProject: z.number().int().optional(),
+    commentsPerTask: z.number().int().optional(),
+    fileUploadsPerComment: z.number().int().optional(),
+    filtersPerUser: z.number().int().optional(),
+    labelsPerTask: z.number().int().optional(),
+    /** How many active personal projects the plan allows, not counting the Inbox. */
+    maxProjects: z.number().int().optional(),
+    remindersPerUser: z.number().int().optional(),
+    sectionsPerProject: z.number().int().optional(),
+    /** Whether the plan includes the Table layout for views. */
+    tableLayout: z.boolean().optional(),
+    tasksPerProject: z.number().int().optional(),
+});
+export const UserPlanLimitsSchema = z.looseObject({
+    current: PlanLimitsSchema,
+    next: PlanLimitsSchema.nullable(),
+});

package/dist/esm/types/sync/resources/user-settings.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export const NavigationFeatureSchema = z.object({
+    name: z.string(),
+    shown: z.boolean(),
+});
+export const QuickAddFeatureSchema = z.object({
+    name: z.string(),
+    shown: z.boolean(),
+});
+/**
+ * Sync API user settings resource.
+ */
+export const UserSettingsSchema = z.looseObject({
+    completedSoundDesktop: z.boolean(),
+    completedSoundMobile: z.boolean(),
+    debugLogSendingEnabledUntil: z.string().nullish(),
+    /**
+     * The Pro price version kept for the account, or `0` when none is kept.
+     * Version numbers are not sequential, and new ones can appear at any time.
+     */
+    legacyPricing: z.number().int(),
+    navigation: z
+        .object({
+        countsShown: z.boolean(),
+        features: z.array(NavigationFeatureSchema),
+    })
+        .loose(),
+    reminderDesktop: z.boolean(),
+    reminderEmail: z.boolean(),
+    reminderPush: z.boolean(),
+    resetRecurringSubtasks: z.boolean(),
+    aiEmailAssist: z.boolean(),
+    theme: z.string().nullable().optional(),
+    syncTheme: z.boolean().optional(),
+    quickAdd: z
+        .object({
+        labelsShown: z.boolean(),
+        features: z.array(QuickAddFeatureSchema),
+    })
+        .loose(),
+});

package/dist/esm/types/sync/resources/user-status.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/**
+ * `mode` stays a plain string and `scope` optional so that a new mode, or an effect another
+ * client stored without a scope, does not break parsing.
+ */
+export const UserStatusEffectSchema = z.looseObject({
+    scope: z.looseObject({ mode: z.string() }).optional(),
+});
+export const UserStatusEffectsSchema = z.looseObject({
+    pauseNotifications: UserStatusEffectSchema.optional(),
+    pauseActivity: UserStatusEffectSchema.optional(),
+});
+/**
+ * A user's status, shared across Todoist and Comms. The API returns `null` in its place
+ * when the user has no status or it has expired.
+ */
+export const UserStatusSchema = z.looseObject({
+    message: z.string(),
+    emoji: z.string().nullish(),
+    activeUntil: z.coerce.date().nullish(),
+    effects: UserStatusEffectsSchema.default({}),
+});

package/dist/esm/types/sync/resources/user.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { PREMIUM_STATUSES } from '../../users/types.js';
+import { BooleanFromZeroOneSchema, DateFormatSchema, DayOfWeekSchema, TimeFormatSchema, } from '../user-preferences.js';
+import { UserStatusSchema } from './user-status.js';
+export const FeaturesSchema = z.looseObject({
+    karmaDisabled: z.union([z.boolean(), BooleanFromZeroOneSchema]),
+    restriction: z.number().int(),
+    karmaVacation: z.boolean(),
+    dateistLang: z.any(),
+    beta: BooleanFromZeroOneSchema,
+    hasPushReminders: z.boolean(),
+    dateistInlineDisabled: z.boolean(),
+    autoInviteDisabled: z.boolean().optional(),
+    goldTheme: z.boolean().optional(),
+    migratedFromTdb: z.boolean().optional(),
+});
+export const TzInfoSchema = z.looseObject({
+    timezone: z.string(),
+    hours: z.number().int(),
+    minutes: z.number().int(),
+    isDst: BooleanFromZeroOneSchema,
+    gmtString: z.string(),
+});
+export const JoinableWorkspaceSchema = z.looseObject({
+    workspaceId: z.string(),
+    workspaceName: z.string(),
+    memberCount: z.number().int(),
+});
+export const GettingStartedGuideProjectSchema = z.looseObject({
+    onboardingUseCase: z.string(),
+    projectId: z.string(),
+    completed: z.boolean(),
+    closed: z.boolean(),
+});
+/**
+ * Sync API user resource.
+ *
+ * This is a superset of the REST `CurrentUserSchema` — the Sync API returns
+ * many additional fields for features, onboarding state, and account details.
+ */
+export const SyncUserSchema = z.looseObject({
+    id: z.string(),
+    email: z.string(),
+    fullName: z.string(),
+    activatedUser: z.boolean(),
+    autoReminder: z.number().int(),
+    avatarBig: z.string().optional(),
+    avatarMedium: z.string().optional(),
+    avatarS640: z.string().optional(),
+    avatarSmall: z.string().optional(),
+    businessAccountId: z.string().nullable(),
+    dailyGoal: z.number().int(),
+    dateFormat: DateFormatSchema,
+    dateistLang: z.string().nullish(),
+    daysOff: z.array(z.number().int()),
+    featureIdentifier: z.string(),
+    features: FeaturesSchema,
+    freeTrailExpires: z.coerce.date().optional(),
+    hasMagicNumber: z.boolean(),
+    hasPassword: z.boolean(),
+    hasStartedATrial: z.boolean().optional(),
+    imageId: z.string().nullable(),
+    inboxProjectId: z.string(),
+    isCelebrationsEnabled: z.boolean(),
+    isPremium: z.boolean(),
+    joinableWorkspace: JoinableWorkspaceSchema.nullable(),
+    joinedAt: z.coerce.date(),
+    gettingStartedGuideProjects: z.array(GettingStartedGuideProjectSchema).nullable(),
+    karma: z.number(),
+    karmaTrend: z.string(),
+    lang: z.string(),
+    mfaEnabled: z.boolean().optional(),
+    mobileHost: z.string().nullish(),
+    mobileNumber: z.string().nullish(),
+    nextWeek: DayOfWeekSchema,
+    onboardingLevel: z.string().nullable().optional(),
+    onboardingRole: z.string().nullable().optional(),
+    onboardingPersona: z.string().nullable().optional(),
+    onboardingInitiated: z.boolean().nullable().optional(),
+    onboardingCompleted: z.boolean().nullable().optional(),
+    onboardingSkipped: z.boolean().optional(),
+    onboardingTeamMode: z.boolean().nullable().optional(),
+    onboardingUseCases: z.array(z.string()).nullable().optional(),
+    premiumStatus: z.enum(PREMIUM_STATUSES),
+    premiumUntil: z.coerce.date().nullable(),
+    rambleSessionsUsage: z
+        .object({
+        currentCount: z.number().int(),
+        limit: z.number().int(),
+        remaining: z.number().int(),
+        resetDate: z.coerce.date(),
+    })
+        .nullable()
+        .optional(),
+    shareLimit: z.number().int(),
+    sortOrder: z.number().int(),
+    startDay: DayOfWeekSchema,
+    startPage: z.string(),
+    status: UserStatusSchema.nullish(),
+    themeId: z.string(),
+    timeFormat: TimeFormatSchema,
+    token: z.string().optional(),
+    tzInfo: TzInfoSchema,
+    uniquePrefix: z.number().int(),
+    verificationStatus: z.string(),
+    websocketUrl: z.string(),
+    weekendStartDay: z.number().int(),
+    weeklyGoal: z.number().int(),
+});

package/dist/esm/types/sync/resources/view-options.js

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+/**
+ * Parses a response field that the API can extend: any string is kept as sent, typed as one
+ * of the `Known` values or another string. Parsing doesn't check that a value is known.
+ */
+function openEnumSchema() {
+    return z.string();
+}
+/** View types the SDK knows. */
+export const VIEW_TYPES = [
+    'TODAY',
+    'UPCOMING',
+    'PROJECT',
+    'LABEL',
+    'FILTER',
+    'WORKSPACE_FILTER',
+    'SEARCH',
+    'TEMPLATE_PREVIEW',
+    'TASK_DETAIL',
+    'AUTOMATION',
+    'ASSIGNED',
+    'ASSIGNED_TO_ME',
+    'OVERDUE',
+    'WORKSPACE_OVERVIEW',
+];
+export const ViewTypeSchema = openEnumSchema();
+/** View modes the SDK knows. */
+export const VIEW_MODES = ['LIST', 'BOARD', 'CALENDAR', 'TABLE'];
+export const ViewModeSchema = openEnumSchema();
+/** Grouping options the SDK knows. */
+export const GROUPED_BY_OPTIONS = [
+    'ASSIGNEE',
+    'ADDED_DATE',
+    'DUE_DATE',
+    'DEADLINE',
+    'LABEL',
+    'PRIORITY',
+    'PROJECT',
+    'WORKSPACE',
+];
+export const GroupedBySchema = openEnumSchema().nullable();
+/** Sorting options the SDK knows. */
+export const SORTED_BY_OPTIONS = [
+    'MANUAL',
+    'ALPHABETICALLY',
+    'ASSIGNEE',
+    'DUE_DATE',
+    'DEADLINE',
+    'ADDED_DATE',
+    'LABEL',
+    'PRIORITY',
+    'PROJECT',
+    'WORKSPACE',
+];
+export const SortedBySchema = openEnumSchema().nullable();
+/** Sort directions the SDK knows. */
+export const SORT_ORDERS = ['ASC', 'DESC'];
+export const SortOrderSchema = openEnumSchema().nullable();
+/** Calendar layout modes the SDK knows. */
+export const CALENDAR_LAYOUTS = ['WEEK', 'MONTH'];
+/** Task color sources for calendar views the SDK knows. */
+export const CALENDAR_COLORS = ['PRIORITY', 'LABEL', 'PROJECT'];
+export const CalendarSettingsSchema = z.looseObject({
+    layout: openEnumSchema().nullable().optional(),
+    visibleDayCount: z
+        .union([z.literal(1), z.literal(3), z.literal(7)])
+        .nullable()
+        .optional(),
+    color: openEnumSchema().nullable().optional(),
+});
+/** How a view shows one task property. Attributes the SDK doesn't know are kept. */
+export const PropertyAttributesSchema = z.looseObject({
+    is_hidden: z.boolean().optional(),
+    /** Width of the property's column, in CSS pixels. */
+    width: z.number().int().optional(),
+});
+/**
+ * How a view shows task properties, such as `due` or `labels`, holding only what the user
+ * changed. Property IDs are opaque strings (`field:6Jf8VQXx`), so every key inside keeps its
+ * API spelling rather than being camel-cased, and keys the SDK doesn't know are kept.
+ */
+export const PropertySettingsSchema = z.looseObject({
+    /** Property IDs in display order. */
+    order: z.array(z.string()).optional(),
+    /** How each property shows, by property ID. */
+    properties: z.record(z.string(), PropertyAttributesSchema).optional(),
+});
+export const ViewOptionsSchema = z.looseObject({
+    viewType: ViewTypeSchema,
+    objectId: z.string().nullable().optional(),
+    groupedBy: GroupedBySchema.optional(),
+    filteredBy: z.string().nullable().optional(),
+    viewMode: ViewModeSchema.nullable().optional(),
+    showCompletedTasks: z.boolean().optional(),
+    sortedBy: SortedBySchema.optional(),
+    sortOrder: SortOrderSchema.optional(),
+    calendarSettings: CalendarSettingsSchema.nullable().optional(),
+    propertySettings: PropertySettingsSchema.nullable().optional(),
+    isDeleted: z.literal(false).optional(),
+});
+// A tombstone keeps only what identifies the deleted row, and the API empties every option.
+const TOMBSTONE_FIELDS = {
+    isDeleted: z.literal(true),
+    viewMode: z.literal('').optional(),
+    groupedBy: z.literal('').optional(),
+    sortedBy: z.literal('').optional(),
+    sortOrder: z.literal('').optional(),
+    filteredBy: z.literal('').optional(),
+    showCompletedTasks: z.boolean().optional(),
+    calendarSettings: z.null().optional(),
+    propertySettings: z.null().optional(),
+};
+/** Deleted view options, as incremental syncs report them. */
+export const ViewOptionsTombstoneSchema = z.looseObject(Object.assign({ viewType: ViewTypeSchema, objectId: z.string().nullable().optional() }, TOMBSTONE_FIELDS));
+export const ProjectViewOptionsDefaultsSchema = z.looseObject({
+    projectId: z.string(),
+    viewMode: ViewModeSchema.nullable().optional(),
+    groupedBy: GroupedBySchema.optional(),
+    sortedBy: SortedBySchema.optional(),
+    sortOrder: SortOrderSchema.optional(),
+    showCompletedTasks: z.boolean().optional(),
+    filteredBy: z.string().nullable().optional(),
+    calendarSettings: CalendarSettingsSchema.nullable().optional(),
+    propertySettings: PropertySettingsSchema.nullable().optional(),
+    isDeleted: z.literal(false).optional(),
+});
+/** Deleted project view options defaults, as incremental syncs report them. */
+export const ProjectViewOptionsDefaultsTombstoneSchema = z.looseObject(Object.assign({ projectId: z.string() }, TOMBSTONE_FIELDS));

package/dist/esm/types/sync/resources/workspace-filters.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const WorkspaceFilterSchema = z.looseObject({
+    id: z.string(),
+    workspaceId: z.string(),
+    name: z.string(),
+    query: z.string(),
+    description: z.string().nullish(),
+    color: z.string(),
+    itemOrder: z.number().int(),
+    isDeleted: z.boolean(),
+    isFavorite: z.boolean(),
+    isFrozen: z.boolean(),
+    creatorUid: z.string(),
+    updaterUid: z.string(),
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+});

package/dist/esm/types/sync/resources/workspaces.js

@@ -0,0 +1,69 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { z } from 'zod';
+import { StringOrNumberSchema } from '../../common.js';
+import { WorkspaceRoleSchema, WorkspacePlanSchema, WorkspaceLimitsSchema, WorkspacePropertiesSchema, } from '../../workspaces/types.js';
+/**
+ * Sync API workspace resource.
+ *
+ * This is a superset of the REST `WorkspaceSchema` — the Sync API returns
+ * additional fields like description, isDeleted, isCollapsed, member counts,
+ * domain settings, and sorting preferences.
+ */
+export const SyncWorkspaceSchema = z
+    .looseObject({
+    id: StringOrNumberSchema,
+    name: z.string(),
+    description: z.string(),
+    logoBig: z.string().nullish(),
+    logoMedium: z.string().nullish(),
+    logoSmall: z.string().nullish(),
+    logoS640: z.string().nullish(),
+    creatorId: StringOrNumberSchema,
+    createdAt: z.coerce.date().optional(),
+    dateCreated: z.coerce.date().optional(),
+    isDeleted: z.boolean(),
+    isCollapsed: z.boolean(),
+    role: WorkspaceRoleSchema.optional(),
+    plan: WorkspacePlanSchema,
+    limits: WorkspaceLimitsSchema.optional(),
+    inviteCode: z.string().nullable().optional(),
+    isLinkSharingEnabled: z.boolean().nullable().optional(),
+    isGuestAllowed: z.boolean().nullable().optional(),
+    currentActiveProjects: z.number().nullable(),
+    currentMemberCount: z.number().nullable(),
+    memberCountByType: z
+        .object({
+        adminCount: z.number().int(),
+        guestCount: z.number().int(),
+        memberCount: z.number().int(),
+    })
+        .optional(),
+    currentTemplateCount: z.number().nullable(),
+    pendingInvitations: z.array(z.string()).nullable().optional(),
+    domainName: z.string().nullish(),
+    domainDiscovery: z.boolean().nullish(),
+    restrictEmailDomains: z.boolean().nullish(),
+    adminSortingApplied: z.boolean(),
+    projectSortPreference: z.string().nullish(),
+    defaultCollaborators: z
+        .object({
+        predefinedGroupIds: z.array(z.string()),
+        userIds: z.array(StringOrNumberSchema),
+    })
+        .optional(),
+    properties: WorkspacePropertiesSchema.optional(),
+})
+    .transform((_a) => {
+    var { dateCreated, createdAt } = _a, rest = __rest(_a, ["dateCreated", "createdAt"]);
+    return (Object.assign(Object.assign({}, rest), { createdAt: createdAt !== null && createdAt !== void 0 ? createdAt : dateCreated }));
+});

package/dist/esm/types/sync/response.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { ProjectSchema } from '../projects/types.js';
+import { SectionSchema } from '../sections/types.js';
+import { TaskSchema } from '../tasks/types.js';
+import { WorkspaceUserSchema } from '../workspaces/types.js';
+import { FilterSchema, CollaboratorSchema, CollaboratorStateSchema, FolderSchema, NoteSchema, TooltipsSchema, WorkspaceFilterSchema, CalendarSchema, CalendarAccountSchema, SyncLabelSchema, SyncReminderSchema, LocationReminderSchema, CompletedInfoSchema, ViewOptionsSchema, ViewOptionsTombstoneSchema, ProjectViewOptionsDefaultsSchema, ProjectViewOptionsDefaultsTombstoneSchema, UserPlanLimitsSchema, LiveNotificationSchema, SyncWorkspaceSchema, SyncUserSchema, UserSettingsSchema, SuggestionSchema, } from './resources/index.js';
+export const SyncErrorSchema = z.object({
+    error: z.string(),
+    errorCode: z.number(),
+    errorExtra: z.record(z.string(), z.unknown()),
+    errorTag: z.string(),
+    httpCode: z.number(),
+});
+export const SyncResponseSchema = z.looseObject({
+    syncToken: z.string().optional(),
+    fullSync: z.boolean().optional(),
+    syncStatus: z.record(z.string(), z.union([z.literal('ok'), SyncErrorSchema])).optional(),
+    tempIdMapping: z.record(z.string(), z.string()).optional(),
+    items: z.array(TaskSchema).optional(),
+    projects: z.array(ProjectSchema).optional(),
+    sections: z.array(SectionSchema).optional(),
+    labels: z.array(SyncLabelSchema).optional(),
+    notes: z.array(NoteSchema).optional(),
+    projectNotes: z.array(NoteSchema).optional(),
+    filters: z.array(FilterSchema).optional(),
+    reminders: z.array(SyncReminderSchema).optional(),
+    remindersLocation: z.array(LocationReminderSchema).optional(),
+    locations: z.array(z.record(z.string(), z.unknown())).optional(),
+    user: SyncUserSchema.optional(),
+    liveNotifications: z.array(LiveNotificationSchema).optional(),
+    collaborators: z.array(CollaboratorSchema).optional(),
+    collaboratorStates: z.array(CollaboratorStateSchema).optional(),
+    userSettings: UserSettingsSchema.optional(),
+    notificationSettings: z.record(z.string(), z.boolean()).optional(),
+    userPlanLimits: UserPlanLimitsSchema.optional(),
+    completedInfo: z.array(CompletedInfoSchema).optional(),
+    stats: z.record(z.string(), z.unknown()).optional(),
+    workspaces: z.array(SyncWorkspaceSchema).optional(),
+    workspaceUsers: z.array(WorkspaceUserSchema).optional(),
+    workspaceFilters: z.array(WorkspaceFilterSchema).optional(),
+    viewOptions: z
+        .array(z.discriminatedUnion('isDeleted', [ViewOptionsSchema, ViewOptionsTombstoneSchema]))
+        .optional(),
+    projectViewOptionsDefaults: z
+        .array(z.discriminatedUnion('isDeleted', [
+        ProjectViewOptionsDefaultsSchema,
+        ProjectViewOptionsDefaultsTombstoneSchema,
+    ]))
+        .optional(),
+    roleActions: z.array(z.record(z.string(), z.unknown())).optional(),
+    folders: z.array(FolderSchema).optional(),
+    dayOrders: z.record(z.string(), z.number()).optional(),
+    calendars: z.array(CalendarSchema).optional(),
+    calendarAccounts: z.array(CalendarAccountSchema).optional(),
+    suggestions: z.array(SuggestionSchema).optional(),
+    tooltips: TooltipsSchema.optional(),
+});

package/dist/esm/types/sync/user-preferences.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+/** Available date format options. */
+export const DATE_FORMATS = ['DD/MM/YYYY', 'MM/DD/YYYY'];
+/** Available time format options. */
+export const TIME_FORMATS = ['24h', '12h'];
+/** Available days of the week. */
+export const DAYS_OF_WEEK = [
+    'Monday',
+    'Tuesday',
+    'Wednesday',
+    'Thursday',
+    'Friday',
+    'Saturday',
+    'Sunday',
+];
+export const DATE_FORMAT_FROM_API = {
+    0: 'DD/MM/YYYY',
+    1: 'MM/DD/YYYY',
+};
+export const TIME_FORMAT_FROM_API = {
+    0: '24h',
+    1: '12h',
+};
+export const DAY_OF_WEEK_FROM_API = {
+    1: 'Monday',
+    2: 'Tuesday',
+    3: 'Wednesday',
+    4: 'Thursday',
+    5: 'Friday',
+    6: 'Saturday',
+    7: 'Sunday',
+};
+export const DATE_FORMAT_TO_API = {
+    'DD/MM/YYYY': 0,
+    'MM/DD/YYYY': 1,
+};
+export const TIME_FORMAT_TO_API = { '24h': 0, '12h': 1 };
+export const DAY_OF_WEEK_TO_API = {
+    Monday: 1,
+    Tuesday: 2,
+    Wednesday: 3,
+    Thursday: 4,
+    Friday: 5,
+    Saturday: 6,
+    Sunday: 7,
+};
+/** Zod read-schema: parse API 0/1 integer, emit boolean */
+export const BooleanFromZeroOneSchema = z
+    .union([z.literal(0), z.literal(1)])
+    .transform((v) => v === 1);
+/** Zod read-schemas: parse API numbers, emit descriptive strings */
+export const DateFormatSchema = z
+    .union([z.literal(0), z.literal(1)])
+    .transform((v) => DATE_FORMAT_FROM_API[v]);
+export const TimeFormatSchema = z
+    .union([z.literal(0), z.literal(1)])
+    .transform((v) => TIME_FORMAT_FROM_API[v]);
+export const DayOfWeekSchema = z
+    .union([
+    z.literal(1),
+    z.literal(2),
+    z.literal(3),
+    z.literal(4),
+    z.literal(5),
+    z.literal(6),
+    z.literal(7),
+])
+    .transform((v) => DAY_OF_WEEK_FROM_API[v]);

package/dist/esm/types/tasks/index.js

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

package/dist/esm/types/tasks/requests.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/tasks/types.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { hasUncompletablePrefix } from '../../utils/uncompletable-helpers.js';
+import { getTaskUrl } from '../../utils/url-helpers.js';
+export const DueDateSchema = z
+    .object({
+    isRecurring: z.boolean(),
+    string: z.string(),
+    date: z.string(),
+})
+    .extend({
+    datetime: z.string().nullable().optional(),
+    timezone: z.string().nullable().optional(),
+    lang: z.string().nullable().optional(),
+});
+/** Available duration units for task deadlines. */
+export const DURATION_UNITS = ['minute', 'day'];
+export const DurationSchema = z.object({
+    amount: z.number().positive('Value should be greater than zero'),
+    unit: z.enum(DURATION_UNITS),
+});
+export const DeadlineSchema = z.object({
+    date: z.string(),
+    lang: z.string(),
+});
+export const TaskSchema = z
+    .object({
+    id: z.string(),
+    userId: z.string(),
+    projectId: z.string(),
+    sectionId: z.string().nullable(),
+    parentId: z.string().nullable(),
+    addedByUid: z.string().nullable(),
+    assignedByUid: z.string().nullable(),
+    responsibleUid: z.string().nullable(),
+    labels: z.array(z.string()),
+    deadline: DeadlineSchema.nullable(),
+    duration: DurationSchema.nullable(),
+    checked: z.boolean(),
+    isDeleted: z.boolean(),
+    addedAt: z.coerce.date().nullable(),
+    completedAt: z.coerce.date().nullable(),
+    updatedAt: z.coerce.date().nullable(),
+    due: DueDateSchema.nullable(),
+    priority: z.number().int(),
+    childOrder: z.number().int(),
+    content: z.string(),
+    description: z.string(),
+    dayOrder: z.number().int(),
+    isCollapsed: z.boolean(),
+    isUncompletable: z.boolean().default(false),
+})
+    .transform((data) => {
+    // Auto-detect uncompletable status from content prefix
+    const isUncompletable = hasUncompletablePrefix(data.content);
+    return Object.assign(Object.assign({}, data), { isUncompletable, url: getTaskUrl(data.id, data.content) });
+});

package/dist/esm/types/templates/index.js

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

package/dist/esm/types/templates/requests.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/ui-extensions/index.js

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

package/dist/esm/types/ui-extensions/requests.js

@@ -0,0 +1 @@
+export {};