@doist/todoist-sdk 9.0.0 → 9.1.0-next.2

package/dist/cjs/transport/sync-request.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performSyncRequest = performSyncRequest;
+const endpoints_1 = require("../consts/endpoints");
+const types_1 = require("../types");
+const sync_1 = require("../types/sync");
+const request_helpers_1 = require("../utils/request-helpers");
+const validators_1 = require("../utils/validators");
+const http_client_1 = require("./http-client");
+function serializeUserUpdateArgs(args) {
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, args), (0, request_helpers_1.spreadIfDefined)(args.dateFormat, (v) => ({
+        dateFormat: sync_1.DATE_FORMAT_TO_API[v],
+    }))), (0, request_helpers_1.spreadIfDefined)(args.timeFormat, (v) => ({
+        timeFormat: sync_1.TIME_FORMAT_TO_API[v],
+    }))), (0, request_helpers_1.spreadIfDefined)(args.startDay, (v) => ({
+        startDay: sync_1.DAY_OF_WEEK_TO_API[v],
+    }))), (0, request_helpers_1.spreadIfDefined)(args.nextWeek, (v) => ({
+        nextWeek: sync_1.DAY_OF_WEEK_TO_API[v],
+    })));
+}
+function serializeTaskUpdateDateCompleteArgs(args) {
+    return Object.assign(Object.assign(Object.assign({}, args), { isForward: args.isForward ? 1 : 0 }), (0, request_helpers_1.spreadIfDefined)(args.resetSubtasks, (v) => ({
+        resetSubtasks: v ? 1 : 0,
+    })));
+}
+function serializeUpdateGoalsArgs(args) {
+    return Object.assign(Object.assign(Object.assign({}, args), (0, request_helpers_1.spreadIfDefined)(args.vacationMode, (v) => ({ vacationMode: v ? 1 : 0 }))), (0, request_helpers_1.spreadIfDefined)(args.karmaDisabled, (v) => ({
+        karmaDisabled: v ? 1 : 0,
+    })));
+}
+function preprocessSyncCommands(commands) {
+    return commands.map((cmd) => {
+        if (cmd.type === 'user_update')
+            return Object.assign(Object.assign({}, cmd), { args: serializeUserUpdateArgs(cmd.args) });
+        if (cmd.type === 'item_update_date_complete')
+            return Object.assign(Object.assign({}, cmd), { args: serializeTaskUpdateDateCompleteArgs(cmd.args) });
+        if (cmd.type === 'update_goals')
+            return Object.assign(Object.assign({}, cmd), { args: serializeUpdateGoalsArgs(cmd.args) });
+        return cmd;
+    });
+}
+/**
+ * Makes a request to the Sync API and handles error checking.
+ *
+ * @param ctx - HTTP identity (auth token, sync API base URI, optional custom fetch).
+ * @param syncRequest - The sync request payload.
+ * @param options - Optional request identifier and commands flag.
+ * @returns The sync response data.
+ * @throws TodoistRequestError if sync status contains errors.
+ */
+async function performSyncRequest(ctx, syncRequest, options = {}) {
+    var _a;
+    const { requestId, hasSyncCommands = false } = options;
+    const processedRequest = ((_a = syncRequest.commands) === null || _a === void 0 ? void 0 : _a.length)
+        ? Object.assign(Object.assign({}, syncRequest), { commands: preprocessSyncCommands(syncRequest.commands) }) : syncRequest;
+    const response = await (0, http_client_1.request)({
+        httpMethod: 'POST',
+        baseUri: ctx.syncApiBase,
+        relativePath: endpoints_1.ENDPOINT_SYNC,
+        apiToken: ctx.authToken,
+        customFetch: ctx.customFetch,
+        payload: processedRequest,
+        requestId: requestId,
+        hasSyncCommands: hasSyncCommands,
+    });
+    // Check for sync errors and throw if any are found
+    if (response.data.syncStatus) {
+        Object.entries(response.data.syncStatus).forEach(([_, value]) => {
+            if (value === 'ok')
+                return;
+            throw new types_1.TodoistRequestError(value.error, value.httpCode, value.errorExtra);
+        });
+    }
+    return (0, validators_1.parseSyncResponse)(response.data);
+}

package/dist/cjs/types/goals/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./requests"), exports);

package/dist/cjs/types/goals/requests.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/goals/types.js

@@ -0,0 +1,56 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoalSchema = exports.GoalProgressSchema = exports.GOAL_OWNER_TYPES = void 0;
+const zod_1 = require("zod");
+/** Available goal owner types. */
+exports.GOAL_OWNER_TYPES = ['USER', 'WORKSPACE'];
+/**
+ * Progress of a {@link Goal}.
+ *
+ * The REST API returns these counts under `total_item_count` / `completed_item_count`,
+ * reflecting the backend's generic "item" terminology. The SDK normalizes them to
+ * `totalTaskCount` / `completedTaskCount` so the public surface consistently speaks
+ * in "tasks" (matching the rest of the SDK). The `preprocess` step below performs
+ * that rename after the transport layer's snake_case → camelCase conversion — do not
+ * remove it without also changing the downstream field names.
+ */
+exports.GoalProgressSchema = zod_1.z.preprocess((raw) => {
+    if (raw === null || raw === undefined || typeof raw !== 'object' || Array.isArray(raw)) {
+        return raw;
+    }
+    const _a = raw, { totalItemCount, completedItemCount, totalTaskCount, completedTaskCount } = _a, rest = __rest(_a, ["totalItemCount", "completedItemCount", "totalTaskCount", "completedTaskCount"]);
+    return Object.assign(Object.assign({}, rest), { totalTaskCount: totalTaskCount !== null && totalTaskCount !== void 0 ? totalTaskCount : totalItemCount, completedTaskCount: completedTaskCount !== null && completedTaskCount !== void 0 ? completedTaskCount : completedItemCount });
+}, zod_1.z.looseObject({
+    totalTaskCount: zod_1.z.number().int(),
+    completedTaskCount: zod_1.z.number().int(),
+    percentage: zod_1.z.number(),
+}));
+exports.GoalSchema = zod_1.z.looseObject({
+    id: zod_1.z.string(),
+    ownerType: zod_1.z.enum(exports.GOAL_OWNER_TYPES),
+    ownerId: zod_1.z.string(),
+    name: zod_1.z.string(),
+    description: zod_1.z.string().nullable(),
+    deadline: zod_1.z.string().nullable(),
+    parentGoalId: zod_1.z.string().nullable(),
+    childOrder: zod_1.z.number().int(),
+    isCompleted: zod_1.z.boolean(),
+    completedAt: zod_1.z.coerce.date().nullable(),
+    responsibleUid: zod_1.z.string().nullable(),
+    isDeleted: zod_1.z.boolean(),
+    progress: exports.GoalProgressSchema.optional(),
+    creatorUid: zod_1.z.string(),
+    createdAt: zod_1.z.coerce.date(),
+    updatedAt: zod_1.z.coerce.date(),
+});

package/dist/cjs/types/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./productivity"), exports);
 __exportStar(require("./activity"), exports);
 __exportStar(require("./workspaces"), exports);
 __exportStar(require("./folders"), exports);
+__exportStar(require("./goals"), exports);
 __exportStar(require("./insights"), exports);
 __exportStar(require("./backups"), exports);
 __exportStar(require("./id-mappings"), exports);

package/dist/cjs/types/sync/commands/goals.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/sync/commands/index.js

@@ -27,6 +27,7 @@ __exportStar(require("./workspaces"), exports);
 __exportStar(require("./folders"), exports);
 __exportStar(require("./workspace-filters"), exports);
 __exportStar(require("./workspace-goals"), exports);
+__exportStar(require("./goals"), exports);
 __exportStar(require("./notifications"), exports);
 __exportStar(require("./sharing"), exports);
 __exportStar(require("./view-options"), exports);

package/dist/cjs/types/sync/resource-types.js

@@ -32,6 +32,7 @@ exports.SYNC_RESOURCE_TYPES = [
     'role_actions',
     'folders',
     'workspace_goals',
+    'goals',
     'day_orders',
     'calendars',
     'calendar_accounts',

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

@@ -2,11 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyncResponseSchema = exports.SyncErrorSchema = void 0;
 const zod_1 = require("zod");
-const types_1 = require("../labels/types");
-const types_2 = require("../projects/types");
-const types_3 = require("../sections/types");
-const types_4 = require("../tasks/types");
-const types_5 = require("../workspaces/types");
+const types_1 = require("../goals/types");
+const types_2 = require("../labels/types");
+const types_3 = require("../projects/types");
+const types_4 = require("../sections/types");
+const types_5 = require("../tasks/types");
+const types_6 = require("../workspaces/types");
 const resources_1 = require("./resources");
 exports.SyncErrorSchema = zod_1.z.object({
     error: zod_1.z.string(),
@@ -20,10 +21,10 @@ exports.SyncResponseSchema = zod_1.z.looseObject({
     fullSync: zod_1.z.boolean().optional(),
     syncStatus: zod_1.z.record(zod_1.z.string(), zod_1.z.union([zod_1.z.literal('ok'), exports.SyncErrorSchema])).optional(),
     tempIdMapping: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
-    items: zod_1.z.array(types_4.TaskSchema).optional(),
-    projects: zod_1.z.array(types_2.ProjectSchema).optional(),
-    sections: zod_1.z.array(types_3.SectionSchema).optional(),
-    labels: zod_1.z.array(types_1.LabelSchema).optional(),
+    items: zod_1.z.array(types_5.TaskSchema).optional(),
+    projects: zod_1.z.array(types_3.ProjectSchema).optional(),
+    sections: zod_1.z.array(types_4.SectionSchema).optional(),
+    labels: zod_1.z.array(types_2.LabelSchema).optional(),
     notes: zod_1.z.array(resources_1.NoteSchema).optional(),
     projectNotes: zod_1.z.array(resources_1.NoteSchema).optional(),
     filters: zod_1.z.array(resources_1.FilterSchema).optional(),
@@ -40,12 +41,13 @@ exports.SyncResponseSchema = zod_1.z.looseObject({
     completedInfo: zod_1.z.array(resources_1.CompletedInfoSchema).optional(),
     stats: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
     workspaces: zod_1.z.array(resources_1.SyncWorkspaceSchema).optional(),
-    workspaceUsers: zod_1.z.array(types_5.WorkspaceUserSchema).optional(),
+    workspaceUsers: zod_1.z.array(types_6.WorkspaceUserSchema).optional(),
     workspaceFilters: zod_1.z.array(resources_1.WorkspaceFilterSchema).optional(),
     viewOptions: zod_1.z.array(resources_1.ViewOptionsSchema).optional(),
     projectViewOptionsDefaults: zod_1.z.array(resources_1.ProjectViewOptionsDefaultsSchema).optional(),
     roleActions: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())).optional(),
     folders: zod_1.z.array(resources_1.FolderSchema).optional(),
+    goals: zod_1.z.array(types_1.GoalSchema).optional(),
     workspaceGoals: zod_1.z.array(resources_1.WorkspaceGoalSchema).optional(),
     dayOrders: zod_1.z.record(zod_1.z.string(), zod_1.z.number()).optional(),
     calendars: zod_1.z.array(resources_1.CalendarSchema).optional(),

package/dist/cjs/utils/headers.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.headersToRecord = headersToRecord;
+/**
+ * Converts a native Fetch `Headers` object into a plain `Record<string, string>`.
+ * Used when wrapping a native `fetch` response into the SDK's `FileResponse`
+ * shape (which expects headers as a plain record for symmetry with
+ * `CustomFetchResponse`).
+ */
+function headersToRecord(headers) {
+    const result = {};
+    headers.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}

package/dist/cjs/utils/request-helpers.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePath = generatePath;
+exports.spreadIfDefined = spreadIfDefined;
+/**
+ * Joins path segments using `/` separator.
+ * @param segments A list of **valid** path segments.
+ * @returns A joined path.
+ */
+function generatePath(...segments) {
+    return segments.join('/');
+}
+/**
+ * Returns `fn(value)` spread into an object if `value` is defined, otherwise an empty object.
+ *
+ * Used to conditionally include a property on a payload object without
+ * resorting to mutation or ternary-built object literals.
+ */
+function spreadIfDefined(value, fn) {
+    return value !== undefined ? fn(value) : {};
+}

package/dist/cjs/utils/validators.js

@@ -1,23 +1,24 @@
 "use strict";
-var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8;
+var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateFolderArray = exports.validateFolder = exports.validateCollaboratorStateArray = exports.validateCollaboratorState = exports.validateCollaboratorArray = exports.validateCollaborator = exports.validateFilterArray = exports.validateFilter = exports.validateMovedIdArray = exports.validateMovedId = exports.validateIdMappingArray = exports.validateIdMapping = exports.validateBackupArray = exports.validateBackup = exports.validateWorkspaceInsights = exports.validateProjectProgress = exports.validateProjectHealthContext = exports.validateProjectHealth = exports.validateProjectActivityStats = exports.validateWorkspaceUserTaskArray = exports.validateWorkspaceUserTask = exports.validateMemberActivityInfoArray = exports.validateMemberActivityInfo = exports.validateWorkspaceArray = exports.validateWorkspace = exports.validateJoinWorkspaceResult = exports.validateWorkspacePlanDetails = exports.validateWorkspaceInvitationArray = exports.validateWorkspaceInvitation = exports.validateWorkspaceUserArray = exports.validateWorkspaceUser = exports.validateAttachment = exports.validateActivityEventArray = exports.validateActivityEvent = exports.validateCurrentUser = exports.validateProductivityStats = exports.validateUserArray = exports.validateUser = exports.validateCommentArray = exports.validateComment = exports.validateLabelArray = exports.validateLabel = exports.validateSectionArray = exports.validateSection = exports.validateWorkspaceProjectArray = exports.validateWorkspaceProject = exports.validateProjectArray = exports.validateProject = exports.validateTaskArray = exports.validateTask = void 0;
-exports.validateSuggestionArray = exports.validateSuggestion = exports.validateUserSettings = exports.validateSyncUser = exports.validateSyncWorkspaceArray = exports.validateSyncWorkspace = exports.validateLiveNotificationArray = exports.validateLiveNotification = exports.validateUserPlanLimits = exports.validateProjectViewOptionsDefaultsArray = exports.validateProjectViewOptionsDefaults = exports.validateViewOptionsArray = exports.validateViewOptions = exports.validateCompletedInfoArray = exports.validateCompletedInfo = exports.validateLocationReminderArray = exports.validateLocationReminder = exports.validateReminderArray = exports.validateReminder = exports.validateCalendarAccountArray = exports.validateCalendarAccount = exports.validateCalendarArray = exports.validateCalendar = exports.validateWorkspaceGoalArray = exports.validateWorkspaceGoal = exports.validateWorkspaceFilterArray = exports.validateWorkspaceFilter = exports.validateTooltips = exports.validateNoteArray = exports.validateNote = void 0;
+exports.validateSuggestionArray = exports.validateSuggestion = exports.validateUserSettings = exports.validateSyncUser = exports.validateSyncWorkspaceArray = exports.validateSyncWorkspace = exports.validateLiveNotificationArray = exports.validateLiveNotification = exports.validateUserPlanLimits = exports.validateProjectViewOptionsDefaultsArray = exports.validateProjectViewOptionsDefaults = exports.validateViewOptionsArray = exports.validateViewOptions = exports.validateCompletedInfoArray = exports.validateCompletedInfo = exports.validateLocationReminderArray = exports.validateLocationReminder = exports.validateReminderArray = exports.validateReminder = exports.validateCalendarAccountArray = exports.validateCalendarAccount = exports.validateCalendarArray = exports.validateCalendar = exports.validateWorkspaceGoalArray = exports.validateWorkspaceGoal = exports.validateWorkspaceFilterArray = exports.validateWorkspaceFilter = exports.validateTooltips = exports.validateNoteArray = exports.validateNote = exports.validateGoalArray = exports.validateGoal = void 0;
 exports.parseSyncResponse = parseSyncResponse;
 const zod_1 = require("zod");
 const types_1 = require("../types/activity/types");
 const types_2 = require("../types/backups/types");
 const types_3 = require("../types/comments/types");
-const types_4 = require("../types/id-mappings/types");
-const types_5 = require("../types/insights/types");
-const types_6 = require("../types/labels/types");
-const types_7 = require("../types/productivity/types");
-const types_8 = require("../types/projects/types");
-const types_9 = require("../types/sections/types");
+const types_4 = require("../types/goals/types");
+const types_5 = require("../types/id-mappings/types");
+const types_6 = require("../types/insights/types");
+const types_7 = require("../types/labels/types");
+const types_8 = require("../types/productivity/types");
+const types_9 = require("../types/projects/types");
+const types_10 = require("../types/sections/types");
 const response_1 = require("../types/sync/response");
-const types_10 = require("../types/tasks/types");
-const types_11 = require("../types/users/types");
-const types_12 = require("../types/workspaces/types");
+const types_11 = require("../types/tasks/types");
+const types_12 = require("../types/users/types");
+const types_13 = require("../types/workspaces/types");
 const resources_1 = require("../types/sync/resources");
 function createValidator(schema) {
     return {
@@ -26,59 +27,60 @@ function createValidator(schema) {
     };
 }
 // Entity validators
-_a = createValidator(types_10.TaskSchema), exports.validateTask = _a.validate, exports.validateTaskArray = _a.validateArray;
+_a = createValidator(types_11.TaskSchema), exports.validateTask = _a.validate, exports.validateTaskArray = _a.validateArray;
 /**
  * Validates and parses a project input.
  * @param input The input to validate
  * @returns A validated project (either PersonalProject or WorkspaceProject)
  */
-_b = createValidator(types_8.ProjectSchema), exports.validateProject = _b.validate, exports.validateProjectArray = _b.validateArray;
-_c = createValidator(types_8.WorkspaceProjectSchema), exports.validateWorkspaceProject = _c.validate, exports.validateWorkspaceProjectArray = _c.validateArray;
-_d = createValidator(types_9.SectionSchema), exports.validateSection = _d.validate, exports.validateSectionArray = _d.validateArray;
-_e = createValidator(types_6.LabelSchema), exports.validateLabel = _e.validate, exports.validateLabelArray = _e.validateArray;
+_b = createValidator(types_9.ProjectSchema), exports.validateProject = _b.validate, exports.validateProjectArray = _b.validateArray;
+_c = createValidator(types_9.WorkspaceProjectSchema), exports.validateWorkspaceProject = _c.validate, exports.validateWorkspaceProjectArray = _c.validateArray;
+_d = createValidator(types_10.SectionSchema), exports.validateSection = _d.validate, exports.validateSectionArray = _d.validateArray;
+_e = createValidator(types_7.LabelSchema), exports.validateLabel = _e.validate, exports.validateLabelArray = _e.validateArray;
 _f = createValidator(types_3.CommentSchema), exports.validateComment = _f.validate, exports.validateCommentArray = _f.validateArray;
-_g = createValidator(types_11.UserSchema), exports.validateUser = _g.validate, exports.validateUserArray = _g.validateArray;
-exports.validateProductivityStats = createValidator(types_7.ProductivityStatsSchema).validate;
-exports.validateCurrentUser = createValidator(types_11.CurrentUserSchema).validate;
+_g = createValidator(types_12.UserSchema), exports.validateUser = _g.validate, exports.validateUserArray = _g.validateArray;
+exports.validateProductivityStats = createValidator(types_8.ProductivityStatsSchema).validate;
+exports.validateCurrentUser = createValidator(types_12.CurrentUserSchema).validate;
 _h = createValidator(types_1.ActivityEventSchema), exports.validateActivityEvent = _h.validate, exports.validateActivityEventArray = _h.validateArray;
 exports.validateAttachment = createValidator(types_3.AttachmentSchema).validate;
-_j = createValidator(types_12.WorkspaceUserSchema), exports.validateWorkspaceUser = _j.validate, exports.validateWorkspaceUserArray = _j.validateArray;
-_k = createValidator(types_12.WorkspaceInvitationSchema), exports.validateWorkspaceInvitation = _k.validate, exports.validateWorkspaceInvitationArray = _k.validateArray;
-exports.validateWorkspacePlanDetails = createValidator(types_12.WorkspacePlanDetailsSchema).validate;
-exports.validateJoinWorkspaceResult = createValidator(types_12.JoinWorkspaceResultSchema).validate;
-_l = createValidator(types_12.WorkspaceSchema), exports.validateWorkspace = _l.validate, exports.validateWorkspaceArray = _l.validateArray;
-_m = createValidator(types_12.MemberActivityInfoSchema), exports.validateMemberActivityInfo = _m.validate, exports.validateMemberActivityInfoArray = _m.validateArray;
-_o = createValidator(types_12.WorkspaceUserTaskSchema), exports.validateWorkspaceUserTask = _o.validate, exports.validateWorkspaceUserTaskArray = _o.validateArray;
-exports.validateProjectActivityStats = createValidator(types_5.ProjectActivityStatsSchema).validate;
-exports.validateProjectHealth = createValidator(types_5.ProjectHealthSchema).validate;
-exports.validateProjectHealthContext = createValidator(types_5.ProjectHealthContextSchema).validate;
-exports.validateProjectProgress = createValidator(types_5.ProjectProgressSchema).validate;
-exports.validateWorkspaceInsights = createValidator(types_5.WorkspaceInsightsSchema).validate;
+_j = createValidator(types_13.WorkspaceUserSchema), exports.validateWorkspaceUser = _j.validate, exports.validateWorkspaceUserArray = _j.validateArray;
+_k = createValidator(types_13.WorkspaceInvitationSchema), exports.validateWorkspaceInvitation = _k.validate, exports.validateWorkspaceInvitationArray = _k.validateArray;
+exports.validateWorkspacePlanDetails = createValidator(types_13.WorkspacePlanDetailsSchema).validate;
+exports.validateJoinWorkspaceResult = createValidator(types_13.JoinWorkspaceResultSchema).validate;
+_l = createValidator(types_13.WorkspaceSchema), exports.validateWorkspace = _l.validate, exports.validateWorkspaceArray = _l.validateArray;
+_m = createValidator(types_13.MemberActivityInfoSchema), exports.validateMemberActivityInfo = _m.validate, exports.validateMemberActivityInfoArray = _m.validateArray;
+_o = createValidator(types_13.WorkspaceUserTaskSchema), exports.validateWorkspaceUserTask = _o.validate, exports.validateWorkspaceUserTaskArray = _o.validateArray;
+exports.validateProjectActivityStats = createValidator(types_6.ProjectActivityStatsSchema).validate;
+exports.validateProjectHealth = createValidator(types_6.ProjectHealthSchema).validate;
+exports.validateProjectHealthContext = createValidator(types_6.ProjectHealthContextSchema).validate;
+exports.validateProjectProgress = createValidator(types_6.ProjectProgressSchema).validate;
+exports.validateWorkspaceInsights = createValidator(types_6.WorkspaceInsightsSchema).validate;
 _p = createValidator(types_2.BackupSchema), exports.validateBackup = _p.validate, exports.validateBackupArray = _p.validateArray;
-_q = createValidator(types_4.IdMappingSchema), exports.validateIdMapping = _q.validate, exports.validateIdMappingArray = _q.validateArray;
-_r = createValidator(types_4.MovedIdSchema), exports.validateMovedId = _r.validate, exports.validateMovedIdArray = _r.validateArray;
+_q = createValidator(types_5.IdMappingSchema), exports.validateIdMapping = _q.validate, exports.validateIdMappingArray = _q.validateArray;
+_r = createValidator(types_5.MovedIdSchema), exports.validateMovedId = _r.validate, exports.validateMovedIdArray = _r.validateArray;
 // Sync resource validators
 _s = createValidator(resources_1.FilterSchema), exports.validateFilter = _s.validate, exports.validateFilterArray = _s.validateArray;
 _t = createValidator(resources_1.CollaboratorSchema), exports.validateCollaborator = _t.validate, exports.validateCollaboratorArray = _t.validateArray;
 _u = createValidator(resources_1.CollaboratorStateSchema), exports.validateCollaboratorState = _u.validate, exports.validateCollaboratorStateArray = _u.validateArray;
 _v = createValidator(resources_1.FolderSchema), exports.validateFolder = _v.validate, exports.validateFolderArray = _v.validateArray;
-_w = createValidator(resources_1.NoteSchema), exports.validateNote = _w.validate, exports.validateNoteArray = _w.validateArray;
+_w = createValidator(types_4.GoalSchema), exports.validateGoal = _w.validate, exports.validateGoalArray = _w.validateArray;
+_x = createValidator(resources_1.NoteSchema), exports.validateNote = _x.validate, exports.validateNoteArray = _x.validateArray;
 exports.validateTooltips = createValidator(resources_1.TooltipsSchema).validate;
-_x = createValidator(resources_1.WorkspaceFilterSchema), exports.validateWorkspaceFilter = _x.validate, exports.validateWorkspaceFilterArray = _x.validateArray;
-_y = createValidator(resources_1.WorkspaceGoalSchema), exports.validateWorkspaceGoal = _y.validate, exports.validateWorkspaceGoalArray = _y.validateArray;
-_z = createValidator(resources_1.CalendarSchema), exports.validateCalendar = _z.validate, exports.validateCalendarArray = _z.validateArray;
-_0 = createValidator(resources_1.CalendarAccountSchema), exports.validateCalendarAccount = _0.validate, exports.validateCalendarAccountArray = _0.validateArray;
-_1 = createValidator(resources_1.ReminderSchema), exports.validateReminder = _1.validate, exports.validateReminderArray = _1.validateArray;
-_2 = createValidator(resources_1.LocationReminderSchema), exports.validateLocationReminder = _2.validate, exports.validateLocationReminderArray = _2.validateArray;
-_3 = createValidator(resources_1.CompletedInfoSchema), exports.validateCompletedInfo = _3.validate, exports.validateCompletedInfoArray = _3.validateArray;
-_4 = createValidator(resources_1.ViewOptionsSchema), exports.validateViewOptions = _4.validate, exports.validateViewOptionsArray = _4.validateArray;
-_5 = createValidator(resources_1.ProjectViewOptionsDefaultsSchema), exports.validateProjectViewOptionsDefaults = _5.validate, exports.validateProjectViewOptionsDefaultsArray = _5.validateArray;
+_y = createValidator(resources_1.WorkspaceFilterSchema), exports.validateWorkspaceFilter = _y.validate, exports.validateWorkspaceFilterArray = _y.validateArray;
+_z = createValidator(resources_1.WorkspaceGoalSchema), exports.validateWorkspaceGoal = _z.validate, exports.validateWorkspaceGoalArray = _z.validateArray;
+_0 = createValidator(resources_1.CalendarSchema), exports.validateCalendar = _0.validate, exports.validateCalendarArray = _0.validateArray;
+_1 = createValidator(resources_1.CalendarAccountSchema), exports.validateCalendarAccount = _1.validate, exports.validateCalendarAccountArray = _1.validateArray;
+_2 = createValidator(resources_1.ReminderSchema), exports.validateReminder = _2.validate, exports.validateReminderArray = _2.validateArray;
+_3 = createValidator(resources_1.LocationReminderSchema), exports.validateLocationReminder = _3.validate, exports.validateLocationReminderArray = _3.validateArray;
+_4 = createValidator(resources_1.CompletedInfoSchema), exports.validateCompletedInfo = _4.validate, exports.validateCompletedInfoArray = _4.validateArray;
+_5 = createValidator(resources_1.ViewOptionsSchema), exports.validateViewOptions = _5.validate, exports.validateViewOptionsArray = _5.validateArray;
+_6 = createValidator(resources_1.ProjectViewOptionsDefaultsSchema), exports.validateProjectViewOptionsDefaults = _6.validate, exports.validateProjectViewOptionsDefaultsArray = _6.validateArray;
 exports.validateUserPlanLimits = createValidator(resources_1.UserPlanLimitsSchema).validate;
-_6 = createValidator(resources_1.LiveNotificationSchema), exports.validateLiveNotification = _6.validate, exports.validateLiveNotificationArray = _6.validateArray;
-_7 = createValidator(resources_1.SyncWorkspaceSchema), exports.validateSyncWorkspace = _7.validate, exports.validateSyncWorkspaceArray = _7.validateArray;
+_7 = createValidator(resources_1.LiveNotificationSchema), exports.validateLiveNotification = _7.validate, exports.validateLiveNotificationArray = _7.validateArray;
+_8 = createValidator(resources_1.SyncWorkspaceSchema), exports.validateSyncWorkspace = _8.validate, exports.validateSyncWorkspaceArray = _8.validateArray;
 exports.validateSyncUser = createValidator(resources_1.SyncUserSchema).validate;
 exports.validateUserSettings = createValidator(resources_1.UserSettingsSchema).validate;
-_8 = createValidator(resources_1.SuggestionSchema), exports.validateSuggestion = _8.validate, exports.validateSuggestionArray = _8.validateArray;
+_9 = createValidator(resources_1.SuggestionSchema), exports.validateSuggestion = _9.validate, exports.validateSuggestionArray = _9.validateArray;
 function parseSyncResponse(raw) {
     return response_1.SyncResponseSchema.parse(raw);
 }

package/dist/esm/clients/activity-client.js

@@ -0,0 +1,59 @@
+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 { ENDPOINT_REST_ACTIVITIES } from '../consts/endpoints.js';
+import { request } from '../transport/http-client.js';
+import { denormalizeObjectTypeFromApi, normalizeObjectEventTypeForApi, } from '../utils/activity-helpers.js';
+import { formatDateToYYYYMMDD } from '../utils/url-helpers.js';
+import { validateActivityEventArray } from '../utils/validators.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling the activity-log endpoint.
+ *
+ * Instantiated by `TodoistApi`; the public `getActivityLogs` method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing
+ * JSDoc.
+ */
+export class ActivityClient extends BaseClient {
+    async getActivityLogs(args = {}) {
+        // Convert Date objects to YYYY-MM-DD strings
+        const dateFrom = args.dateFrom instanceof Date ? formatDateToYYYYMMDD(args.dateFrom) : args.dateFrom;
+        const dateTo = args.dateTo instanceof Date ? formatDateToYYYYMMDD(args.dateTo) : args.dateTo;
+        // Destructure out raw date, filter-type, and removed legacy fields so they don't leak into payload
+        const _a = args, { dateFrom: _dateFrom, dateTo: _dateTo, objectEventTypes, objectType: _objectType, eventType: _eventType, since: _since, until: _until } = _a, rest = __rest(_a, ["dateFrom", "dateTo", "objectEventTypes", "objectType", "eventType", "since", "until"]);
+        // Build normalized objectEventTypes for the API
+        let normalizedObjectEventTypes;
+        if (objectEventTypes !== undefined) {
+            const arr = Array.isArray(objectEventTypes) ? objectEventTypes : [objectEventTypes];
+            normalizedObjectEventTypes = arr.map(normalizeObjectEventTypeForApi);
+        }
+        const processedArgs = Object.assign(Object.assign(Object.assign(Object.assign({}, rest), (dateFrom !== undefined ? { dateFrom } : {})), (dateTo !== undefined ? { dateTo } : {})), (normalizedObjectEventTypes !== undefined
+            ? { objectEventTypes: normalizedObjectEventTypes }
+            : {}));
+        const { data: { results, nextCursor }, } = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_ACTIVITIES,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: processedArgs,
+        });
+        // Convert legacy API object types back to modern SDK types
+        const normalizedResults = results.map((event) => {
+            const normalizedType = denormalizeObjectTypeFromApi(event.objectType);
+            return Object.assign(Object.assign({}, event), { objectType: normalizedType || event.objectType });
+        });
+        return {
+            results: validateActivityEventArray(normalizedResults),
+            nextCursor,
+        };
+    }
+}

package/dist/esm/clients/backup-client.js

@@ -0,0 +1,61 @@
+import { ENDPOINT_REST_BACKUPS, ENDPOINT_REST_BACKUPS_DOWNLOAD } from '../consts/endpoints.js';
+import { request } from '../transport/http-client.js';
+import { headersToRecord } from '../utils/headers.js';
+import { validateBackupArray } from '../utils/validators.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Internal sub-client handling backup-domain endpoints.
+ *
+ * Instantiated by `TodoistApi`; every public backup method on
+ * `TodoistApi` delegates here. See `todoist-api.ts` for user-facing
+ * JSDoc.
+ */
+export class BackupClient extends BaseClient {
+    async getBackups(args = {}) {
+        const response = await request({
+            httpMethod: 'GET',
+            baseUri: this.syncApiBase,
+            relativePath: ENDPOINT_REST_BACKUPS,
+            apiToken: this.authToken,
+            customFetch: this.customFetch,
+            payload: args,
+        });
+        return validateBackupArray(response.data);
+    }
+    async downloadBackup(args) {
+        const url = `${this.syncApiBase}${ENDPOINT_REST_BACKUPS_DOWNLOAD}?file=${encodeURIComponent(args.file)}`;
+        const fetchOptions = {
+            headers: { Authorization: `Bearer ${this.authToken}` },
+        };
+        if (this.customFetch) {
+            const response = await this.customFetch(url, fetchOptions);
+            if (!response.ok) {
+                throw new Error(`Failed to download backup: ${response.status} ${response.statusText}`);
+            }
+            const text = await response.text();
+            const buffer = new TextEncoder().encode(text).buffer;
+            return {
+                ok: response.ok,
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+                text: () => Promise.resolve(text),
+                json: () => response.json(),
+                arrayBuffer: () => Promise.resolve(buffer),
+            };
+        }
+        const response = await fetch(url, fetchOptions);
+        if (!response.ok) {
+            throw new Error(`Failed to download backup: ${response.status} ${response.statusText}`);
+        }
+        return {
+            ok: response.ok,
+            status: response.status,
+            statusText: response.statusText,
+            headers: headersToRecord(response.headers),
+            text: () => response.text(),
+            json: () => response.json(),
+            arrayBuffer: () => response.arrayBuffer(),
+        };
+    }
+}

package/dist/esm/clients/base-client.js

@@ -0,0 +1,26 @@
+/**
+ * Internal base class for every domain sub-client (tasks, projects, …).
+ *
+ * Not exported from the package — sub-clients are an implementation detail
+ * of `TodoistApi`. Holds the three pieces of HTTP identity every sub-client
+ * needs and exposes a typed accessor to feed the Sync API helper.
+ *
+ * The constructor takes a {@link SyncRequestContext} — the same record
+ * shape used by `performSyncRequest` — so there is a single type describing
+ * "the HTTP identity an SDK component needs", not two types that must stay
+ * in sync.
+ */
+export class BaseClient {
+    constructor(context) {
+        this.authToken = context.authToken;
+        this.syncApiBase = context.syncApiBase;
+        this.customFetch = context.customFetch;
+    }
+    get syncContext() {
+        return {
+            authToken: this.authToken,
+            syncApiBase: this.syncApiBase,
+            customFetch: this.customFetch,
+        };
+    }
+}