@doist/todoist-sdk 10.2.0-next.2 → 10.2.0-next.4

package/dist/cjs/clients/app-client.js

@@ -16,7 +16,6 @@ const zod_1 = require("zod");
 const endpoints_1 = require("../consts/endpoints");
 const http_client_1 = require("../transport/http-client");
 const apps_1 = require("../types/apps");
-const case_conversion_1 = require("../utils/case-conversion");
 const multipart_upload_1 = require("../utils/multipart-upload");
 const validators_1 = require("../utils/validators");
 const base_client_1 = require("./base-client");
@@ -145,7 +144,7 @@ class AppClient extends base_client_1.BaseClient {
             requestId: requestId,
             customFetch: this.customFetch,
         });
-        return (0, validators_1.validateAppWithUserCount)((0, case_conversion_1.camelCaseKeys)(data));
+        return (0, validators_1.validateAppWithUserCount)(data);
     }
     async getAppTestToken(appId, requestId) {
         validators_1.IdSchema.parse(appId);

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

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackupClient = void 0;
 const endpoints_1 = require("../consts/endpoints");
 const http_client_1 = require("../transport/http-client");
-const headers_1 = require("../utils/headers");
+const file_response_1 = require("../utils/file-response");
 const validators_1 = require("../utils/validators");
 const base_client_1 = require("./base-client");
 /**
@@ -35,31 +35,13 @@ class BackupClient extends base_client_1.BaseClient {
             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),
-            };
+            return (0, file_response_1.wrapAsFileResponse)(response, 'downloadBackup');
         }
         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: (0, headers_1.headersToRecord)(response.headers),
-            text: () => response.text(),
-            json: () => response.json(),
-            arrayBuffer: () => response.arrayBuffer(),
-        };
+        return (0, file_response_1.wrapAsFileResponse)(response, 'downloadBackup');
     }
 }
 exports.BackupClient = BackupClient;

package/dist/cjs/clients/goals-client.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GoalsClient = void 0;
-const zod_1 = require("zod");
 const endpoints_1 = require("../consts/endpoints");
 const http_client_1 = require("../transport/http-client");
 const request_helpers_1 = require("../utils/request-helpers");
@@ -43,7 +42,7 @@ class GoalsClient extends base_client_1.BaseClient {
         };
     }
     async getGoal(id) {
-        zod_1.z.string().parse(id);
+        validators_1.IdSchema.parse(id);
         const response = await (0, http_client_1.request)({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -66,7 +65,7 @@ class GoalsClient extends base_client_1.BaseClient {
         return (0, validators_1.validateGoal)(response.data);
     }
     async updateGoal(id, args, requestId) {
-        zod_1.z.string().parse(id);
+        validators_1.IdSchema.parse(id);
         const response = await (0, http_client_1.request)({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -79,7 +78,7 @@ class GoalsClient extends base_client_1.BaseClient {
         return (0, validators_1.validateGoal)(response.data);
     }
     async deleteGoal(id, requestId) {
-        zod_1.z.string().parse(id);
+        validators_1.IdSchema.parse(id);
         const response = await (0, http_client_1.request)({
             httpMethod: 'DELETE',
             baseUri: this.syncApiBase,
@@ -91,7 +90,7 @@ class GoalsClient extends base_client_1.BaseClient {
         return (0, http_client_1.isSuccess)(response);
     }
     async completeGoal(id, requestId) {
-        zod_1.z.string().parse(id);
+        validators_1.IdSchema.parse(id);
         const response = await (0, http_client_1.request)({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -103,7 +102,7 @@ class GoalsClient extends base_client_1.BaseClient {
         return (0, validators_1.validateGoal)(response.data);
     }
     async uncompleteGoal(id, requestId) {
-        zod_1.z.string().parse(id);
+        validators_1.IdSchema.parse(id);
         const response = await (0, http_client_1.request)({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -115,8 +114,8 @@ class GoalsClient extends base_client_1.BaseClient {
         return (0, validators_1.validateGoal)(response.data);
     }
     async linkTaskToGoal({ goalId, taskId }, requestId) {
-        zod_1.z.string().parse(goalId);
-        zod_1.z.string().parse(taskId);
+        validators_1.IdSchema.parse(goalId);
+        validators_1.IdSchema.parse(taskId);
         const response = await (0, http_client_1.request)({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -129,8 +128,8 @@ class GoalsClient extends base_client_1.BaseClient {
         return (0, validators_1.validateGoal)(response.data);
     }
     async unlinkTaskFromGoal({ goalId, taskId }, requestId) {
-        zod_1.z.string().parse(goalId);
-        zod_1.z.string().parse(taskId);
+        validators_1.IdSchema.parse(goalId);
+        validators_1.IdSchema.parse(taskId);
         const response = await (0, http_client_1.request)({
             httpMethod: 'DELETE',
             baseUri: this.syncApiBase,

package/dist/cjs/clients/template-client.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TemplateClient = void 0;
 const endpoints_1 = require("../consts/endpoints");
 const http_client_1 = require("../transport/http-client");
-const case_conversion_1 = require("../utils/case-conversion");
 const multipart_upload_1 = require("../utils/multipart-upload");
 const validators_1 = require("../utils/validators");
 const base_client_1 = require("./base-client");
@@ -53,7 +52,7 @@ class TemplateClient extends base_client_1.BaseClient {
             customFetch: this.customFetch,
             requestId,
         });
-        return this.validateTemplateResponse((0, case_conversion_1.camelCaseKeys)(data));
+        return this.validateTemplateResponse(data);
     }
     async importTemplateIntoProject(args, requestId) {
         const { file, fileName, projectId } = args;
@@ -67,7 +66,7 @@ class TemplateClient extends base_client_1.BaseClient {
             customFetch: this.customFetch,
             requestId,
         });
-        return this.validateTemplateResponse((0, case_conversion_1.camelCaseKeys)(data));
+        return this.validateTemplateResponse(data);
     }
     async importTemplateFromId(args, requestId) {
         const { data } = await (0, http_client_1.request)({

package/dist/cjs/clients/ui-extension-client.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UiExtensionClient = void 0;
 const endpoints_1 = require("../consts/endpoints");
 const http_client_1 = require("../transport/http-client");
-const case_conversion_1 = require("../utils/case-conversion");
 const multipart_upload_1 = require("../utils/multipart-upload");
 const validators_1 = require("../utils/validators");
 const base_client_1 = require("./base-client");
@@ -102,7 +101,7 @@ class UiExtensionClient extends base_client_1.BaseClient {
             requestId: requestId,
             customFetch: this.customFetch,
         });
-        return (0, validators_1.validateUiExtension)((0, case_conversion_1.camelCaseKeys)(data));
+        return (0, validators_1.validateUiExtension)(data);
     }
 }
 exports.UiExtensionClient = UiExtensionClient;

package/dist/cjs/clients/upload-client.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UploadClient = void 0;
 const endpoints_1 = require("../consts/endpoints");
 const http_client_1 = require("../transport/http-client");
-const headers_1 = require("../utils/headers");
+const file_response_1 = require("../utils/file-response");
 const multipart_upload_1 = require("../utils/multipart-upload");
 const validators_1 = require("../utils/validators");
 const base_client_1 = require("./base-client");
@@ -71,32 +71,13 @@ class UploadClient extends base_client_1.BaseClient {
             if (!response.ok) {
                 throw new Error(`Failed to fetch attachment: ${response.status} ${response.statusText}`);
             }
-            // Convert text to ArrayBuffer for custom fetch implementations that lack arrayBuffer()
-            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),
-            };
+            return (0, file_response_1.wrapAsFileResponse)(response, 'viewAttachment');
         }
         const response = await fetch(fileUrl, fetchOptions);
         if (!response.ok) {
             throw new Error(`Failed to fetch attachment: ${response.status} ${response.statusText}`);
         }
-        return {
-            ok: response.ok,
-            status: response.status,
-            statusText: response.statusText,
-            headers: (0, headers_1.headersToRecord)(response.headers),
-            text: () => response.text(),
-            json: () => response.json(),
-            arrayBuffer: () => response.arrayBuffer(),
-        };
+        return (0, file_response_1.wrapAsFileResponse)(response, 'viewAttachment');
     }
 }
 exports.UploadClient = UploadClient;

package/dist/cjs/test-utils/obsidian-fetch-adapter.js

@@ -48,6 +48,7 @@ function createObsidianFetchAdapter(requestUrl) {
             // Wrap Obsidian's direct properties as methods returning promises
             text: () => Promise.resolve(response.text),
             json: () => Promise.resolve(response.json),
+            arrayBuffer: () => Promise.resolve(response.arrayBuffer),
         };
     };
 }

package/dist/cjs/todoist-api.js

@@ -945,33 +945,101 @@ class TodoistApi {
         return this.folderClient.deleteFolder(id, requestId);
     }
     // ── Goals ──
+    /**
+     * Retrieves a paginated list of goals.
+     *
+     * @param args - Optional filters including owner type, workspace ID, cursor, and limit.
+     * @returns A promise that resolves to a paginated list of goals.
+     */
     async getGoals(args) {
         return this.goalsClient.getGoals(args);
     }
+    /**
+     * Searches for goals matching a query.
+     *
+     * @param args - Search parameters including query string and optional owner type.
+     * @returns A promise that resolves to a paginated list of matching goals.
+     */
     async searchGoals(args) {
         return this.goalsClient.searchGoals(args);
     }
+    /**
+     * Retrieves a single goal by its ID.
+     *
+     * @param id - The unique identifier of the goal.
+     * @returns A promise that resolves to the goal.
+     */
     async getGoal(id) {
         return this.goalsClient.getGoal(id);
     }
+    /**
+     * Creates a new goal.
+     *
+     * @param args - Goal attributes including name and optional workspace, description, deadline, and responsible user.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created goal.
+     */
     async addGoal(args, requestId) {
         return this.goalsClient.addGoal(args, requestId);
     }
+    /**
+     * Updates an existing goal.
+     *
+     * @param id - The unique identifier of the goal to update.
+     * @param args - Attributes to update on the goal.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     async updateGoal(id, args, requestId) {
         return this.goalsClient.updateGoal(id, args, requestId);
     }
+    /**
+     * Deletes a goal by its ID.
+     *
+     * @param id - The unique identifier of the goal to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
     async deleteGoal(id, requestId) {
         return this.goalsClient.deleteGoal(id, requestId);
     }
+    /**
+     * Marks a goal as complete.
+     *
+     * @param id - The unique identifier of the goal to complete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     async completeGoal(id, requestId) {
         return this.goalsClient.completeGoal(id, requestId);
     }
+    /**
+     * Marks a previously completed goal as incomplete.
+     *
+     * @param id - The unique identifier of the goal to uncomplete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     async uncompleteGoal(id, requestId) {
         return this.goalsClient.uncompleteGoal(id, requestId);
     }
+    /**
+     * Links a task to a goal so it contributes to goal progress.
+     *
+     * @param args - The goal ID and task ID to link.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     async linkTaskToGoal(args, requestId) {
         return this.goalsClient.linkTaskToGoal(args, requestId);
     }
+    /**
+     * Unlinks a previously linked task from a goal.
+     *
+     * @param args - The goal ID and task ID to unlink.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
     async unlinkTaskFromGoal(args, requestId) {
         return this.goalsClient.unlinkTaskFromGoal(args, requestId);
     }

package/dist/cjs/transport/fetch-with-retry.js

@@ -92,6 +92,7 @@ function convertResponseToCustomFetch(response) {
         headers: headersToObject(response.headers),
         text: () => clonedResponse.text(),
         json: () => response.json(),
+        arrayBuffer: () => response.arrayBuffer(),
     };
 }
 /**

package/dist/cjs/utils/file-response.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapAsFileResponse = wrapAsFileResponse;
+const headers_1 = require("./headers");
+/**
+ * Wraps either a native `Response` or a `CustomFetchResponse` into the SDK's
+ * `FileResponse` shape (binary endpoints: `viewAttachment`, `downloadBackup`).
+ *
+ * `arrayBuffer()` is resolved lazily. A customFetch implementation that omits
+ * `arrayBuffer()` is still valid for callers that only read `text()`/`json()`;
+ * the descriptive error is thrown only if the caller actually requests binary
+ * bytes. This avoids the lossy `text()` → `TextEncoder` round-trip that
+ * corrupts non-UTF-8 bytes (every `0x80`-`0xFF` byte not part of a valid UTF-8
+ * sequence is replaced with `U+FFFD`).
+ */
+function wrapAsFileResponse(response, context) {
+    const headers = response.headers instanceof Headers ? (0, headers_1.headersToRecord)(response.headers) : response.headers;
+    return {
+        ok: response.ok,
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+        text: () => response.text(),
+        json: () => response.json(),
+        arrayBuffer: () => {
+            if (typeof response.arrayBuffer !== 'function') {
+                throw new Error(`customFetch response must implement arrayBuffer() for ${context} (binary endpoint); reading the body via text() corrupts non-UTF-8 bytes`);
+            }
+            return response.arrayBuffer();
+        },
+    };
+}

package/dist/cjs/utils/multipart-upload.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadMultipartFile = uploadMultipartFile;
 const fetch_with_retry_1 = require("../transport/fetch-with-retry");
+const case_conversion_1 = require("./case-conversion");
 /**
  * Helper function to determine content-type from filename extension.
  * @param fileName - The filename to analyze
@@ -174,5 +175,5 @@ async function uploadMultipartFile(args) {
         },
         customFetch,
     });
-    return response.data;
+    return (0, case_conversion_1.camelCaseKeys)(response.data);
 }

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

@@ -13,7 +13,6 @@ import { z } from 'zod';
 import { ENDPOINT_REST_APPS, ENDPOINT_REST_APPS_INSTALLATIONS, ENDPOINT_REST_USER_AUTHORIZATIONS, ENDPOINT_REST_USER_AUTHORIZATIONS_DELETE, getAppByDistributionTokenEndpoint, getAppClientSecretEndpoint, getAppDistributionTokenEndpoint, getAppEndpoint, getAppIconEndpoint, getAppInstallationEndpoint, getAppSecretsEndpoint, getAppTestTokenEndpoint, getAppTokensEndpoint, getAppVerificationTokenEndpoint, getAppWebhookEndpoint, } from '../consts/endpoints.js';
 import { isSuccess, request } from '../transport/http-client.js';
 import { webhookEventToWireName } from '../types/apps/index.js';
-import { camelCaseKeys } from '../utils/case-conversion.js';
 import { uploadMultipartFile } from '../utils/multipart-upload.js';
 import { IdSchema, validateApp, validateAppArray, validateAppByDistributionToken, validateAppDistributionToken, validateAppInstallation, validateAppInstallationArray, validateAppSecrets, validateAppTestToken, validateAppVerificationToken, validateAppWebhook, validateAppWithUserCount, validateUserAuthorizationArray, } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
@@ -142,7 +141,7 @@ export class AppClient extends BaseClient {
             requestId: requestId,
             customFetch: this.customFetch,
         });
-        return validateAppWithUserCount(camelCaseKeys(data));
+        return validateAppWithUserCount(data);
     }
     async getAppTestToken(appId, requestId) {
         IdSchema.parse(appId);

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

@@ -1,6 +1,6 @@
 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 { wrapAsFileResponse } from '../utils/file-response.js';
 import { validateBackupArray } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
 /**
@@ -32,30 +32,12 @@ export class BackupClient extends BaseClient {
             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),
-            };
+            return wrapAsFileResponse(response, 'downloadBackup');
         }
         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(),
-        };
+        return wrapAsFileResponse(response, 'downloadBackup');
     }
 }

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

@@ -1,8 +1,7 @@
-import { z } from 'zod';
 import { ENDPOINT_REST_GOALS, ENDPOINT_REST_GOALS_SEARCH, GOAL_COMPLETE, GOAL_TASKS, GOAL_UNCOMPLETE, } from '../consts/endpoints.js';
 import { isSuccess, request } from '../transport/http-client.js';
 import { generatePath } from '../utils/request-helpers.js';
-import { validateGoal, validateGoalArray } from '../utils/validators.js';
+import { IdSchema, validateGoal, validateGoalArray } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
 /**
  * Internal sub-client handling all goal-domain endpoints.
@@ -40,7 +39,7 @@ export class GoalsClient extends BaseClient {
         };
     }
     async getGoal(id) {
-        z.string().parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -63,7 +62,7 @@ export class GoalsClient extends BaseClient {
         return validateGoal(response.data);
     }
     async updateGoal(id, args, requestId) {
-        z.string().parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -76,7 +75,7 @@ export class GoalsClient extends BaseClient {
         return validateGoal(response.data);
     }
     async deleteGoal(id, requestId) {
-        z.string().parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.syncApiBase,
@@ -88,7 +87,7 @@ export class GoalsClient extends BaseClient {
         return isSuccess(response);
     }
     async completeGoal(id, requestId) {
-        z.string().parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -100,7 +99,7 @@ export class GoalsClient extends BaseClient {
         return validateGoal(response.data);
     }
     async uncompleteGoal(id, requestId) {
-        z.string().parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -112,8 +111,8 @@ export class GoalsClient extends BaseClient {
         return validateGoal(response.data);
     }
     async linkTaskToGoal({ goalId, taskId }, requestId) {
-        z.string().parse(goalId);
-        z.string().parse(taskId);
+        IdSchema.parse(goalId);
+        IdSchema.parse(taskId);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -126,8 +125,8 @@ export class GoalsClient extends BaseClient {
         return validateGoal(response.data);
     }
     async unlinkTaskFromGoal({ goalId, taskId }, requestId) {
-        z.string().parse(goalId);
-        z.string().parse(taskId);
+        IdSchema.parse(goalId);
+        IdSchema.parse(taskId);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.syncApiBase,

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

@@ -1,6 +1,5 @@
 import { ENDPOINT_REST_TEMPLATES_CREATE_FROM_FILE, ENDPOINT_REST_TEMPLATES_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_FILE, ENDPOINT_REST_TEMPLATES_IMPORT_FROM_ID, ENDPOINT_REST_TEMPLATES_URL, } from '../consts/endpoints.js';
 import { request } from '../transport/http-client.js';
-import { camelCaseKeys } from '../utils/case-conversion.js';
 import { uploadMultipartFile } from '../utils/multipart-upload.js';
 import { validateCommentArray, validateProjectArray, validateSectionArray, validateTaskArray, } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
@@ -50,7 +49,7 @@ export class TemplateClient extends BaseClient {
             customFetch: this.customFetch,
             requestId,
         });
-        return this.validateTemplateResponse(camelCaseKeys(data));
+        return this.validateTemplateResponse(data);
     }
     async importTemplateIntoProject(args, requestId) {
         const { file, fileName, projectId } = args;
@@ -64,7 +63,7 @@ export class TemplateClient extends BaseClient {
             customFetch: this.customFetch,
             requestId,
         });
-        return this.validateTemplateResponse(camelCaseKeys(data));
+        return this.validateTemplateResponse(data);
     }
     async importTemplateFromId(args, requestId) {
         const { data } = await request({

package/dist/esm/clients/ui-extension-client.js

@@ -1,6 +1,5 @@
 import { ENDPOINT_REST_APPS_UI_EXTENSIONS, ENDPOINT_REST_APPS_UI_EXTENSIONS_INSTALLED, getUiExtensionEndpoint, getUiExtensionIconEndpoint, getUiExtensionsByIntegrationEndpoint, } from '../consts/endpoints.js';
 import { isSuccess, request } from '../transport/http-client.js';
-import { camelCaseKeys } from '../utils/case-conversion.js';
 import { uploadMultipartFile } from '../utils/multipart-upload.js';
 import { IdSchema, validateUiExtension, validateUiExtensionArray } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
@@ -99,6 +98,6 @@ export class UiExtensionClient extends BaseClient {
             requestId: requestId,
             customFetch: this.customFetch,
         });
-        return validateUiExtension(camelCaseKeys(data));
+        return validateUiExtension(data);
     }
 }

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

@@ -1,6 +1,6 @@
 import { ENDPOINT_REST_UPLOADS } from '../consts/endpoints.js';
 import { isSuccess, request } from '../transport/http-client.js';
-import { headersToRecord } from '../utils/headers.js';
+import { wrapAsFileResponse } from '../utils/file-response.js';
 import { uploadMultipartFile } from '../utils/multipart-upload.js';
 import { validateAttachment } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
@@ -68,31 +68,12 @@ export class UploadClient extends BaseClient {
             if (!response.ok) {
                 throw new Error(`Failed to fetch attachment: ${response.status} ${response.statusText}`);
             }
-            // Convert text to ArrayBuffer for custom fetch implementations that lack arrayBuffer()
-            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),
-            };
+            return wrapAsFileResponse(response, 'viewAttachment');
         }
         const response = await fetch(fileUrl, fetchOptions);
         if (!response.ok) {
             throw new Error(`Failed to fetch attachment: ${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(),
-        };
+        return wrapAsFileResponse(response, 'viewAttachment');
     }
 }

package/dist/esm/test-utils/obsidian-fetch-adapter.js

@@ -45,6 +45,7 @@ export function createObsidianFetchAdapter(requestUrl) {
             // Wrap Obsidian's direct properties as methods returning promises
             text: () => Promise.resolve(response.text),
             json: () => Promise.resolve(response.json),
+            arrayBuffer: () => Promise.resolve(response.arrayBuffer),
         };
     };
 }

package/dist/esm/todoist-api.js

@@ -942,33 +942,101 @@ export class TodoistApi {
         return this.folderClient.deleteFolder(id, requestId);
     }
     // ── Goals ──
+    /**
+     * Retrieves a paginated list of goals.
+     *
+     * @param args - Optional filters including owner type, workspace ID, cursor, and limit.
+     * @returns A promise that resolves to a paginated list of goals.
+     */
     async getGoals(args) {
         return this.goalsClient.getGoals(args);
     }
+    /**
+     * Searches for goals matching a query.
+     *
+     * @param args - Search parameters including query string and optional owner type.
+     * @returns A promise that resolves to a paginated list of matching goals.
+     */
     async searchGoals(args) {
         return this.goalsClient.searchGoals(args);
     }
+    /**
+     * Retrieves a single goal by its ID.
+     *
+     * @param id - The unique identifier of the goal.
+     * @returns A promise that resolves to the goal.
+     */
     async getGoal(id) {
         return this.goalsClient.getGoal(id);
     }
+    /**
+     * Creates a new goal.
+     *
+     * @param args - Goal attributes including name and optional workspace, description, deadline, and responsible user.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created goal.
+     */
     async addGoal(args, requestId) {
         return this.goalsClient.addGoal(args, requestId);
     }
+    /**
+     * Updates an existing goal.
+     *
+     * @param id - The unique identifier of the goal to update.
+     * @param args - Attributes to update on the goal.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     async updateGoal(id, args, requestId) {
         return this.goalsClient.updateGoal(id, args, requestId);
     }
+    /**
+     * Deletes a goal by its ID.
+     *
+     * @param id - The unique identifier of the goal to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
     async deleteGoal(id, requestId) {
         return this.goalsClient.deleteGoal(id, requestId);
     }
+    /**
+     * Marks a goal as complete.
+     *
+     * @param id - The unique identifier of the goal to complete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     async completeGoal(id, requestId) {
         return this.goalsClient.completeGoal(id, requestId);
     }
+    /**
+     * Marks a previously completed goal as incomplete.
+     *
+     * @param id - The unique identifier of the goal to uncomplete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     async uncompleteGoal(id, requestId) {
         return this.goalsClient.uncompleteGoal(id, requestId);
     }
+    /**
+     * Links a task to a goal so it contributes to goal progress.
+     *
+     * @param args - The goal ID and task ID to link.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     async linkTaskToGoal(args, requestId) {
         return this.goalsClient.linkTaskToGoal(args, requestId);
     }
+    /**
+     * Unlinks a previously linked task from a goal.
+     *
+     * @param args - The goal ID and task ID to unlink.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
     async unlinkTaskFromGoal(args, requestId) {
         return this.goalsClient.unlinkTaskFromGoal(args, requestId);
     }

package/dist/esm/transport/fetch-with-retry.js

@@ -89,6 +89,7 @@ function convertResponseToCustomFetch(response) {
         headers: headersToObject(response.headers),
         text: () => clonedResponse.text(),
         json: () => response.json(),
+        arrayBuffer: () => response.arrayBuffer(),
     };
 }
 /**

package/dist/esm/utils/file-response.js

@@ -0,0 +1,29 @@
+import { headersToRecord } from './headers.js';
+/**
+ * Wraps either a native `Response` or a `CustomFetchResponse` into the SDK's
+ * `FileResponse` shape (binary endpoints: `viewAttachment`, `downloadBackup`).
+ *
+ * `arrayBuffer()` is resolved lazily. A customFetch implementation that omits
+ * `arrayBuffer()` is still valid for callers that only read `text()`/`json()`;
+ * the descriptive error is thrown only if the caller actually requests binary
+ * bytes. This avoids the lossy `text()` → `TextEncoder` round-trip that
+ * corrupts non-UTF-8 bytes (every `0x80`-`0xFF` byte not part of a valid UTF-8
+ * sequence is replaced with `U+FFFD`).
+ */
+export function wrapAsFileResponse(response, context) {
+    const headers = response.headers instanceof Headers ? headersToRecord(response.headers) : response.headers;
+    return {
+        ok: response.ok,
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+        text: () => response.text(),
+        json: () => response.json(),
+        arrayBuffer: () => {
+            if (typeof response.arrayBuffer !== 'function') {
+                throw new Error(`customFetch response must implement arrayBuffer() for ${context} (binary endpoint); reading the body via text() corrupts non-UTF-8 bytes`);
+            }
+            return response.arrayBuffer();
+        },
+    };
+}

package/dist/esm/utils/multipart-upload.js

@@ -1,4 +1,5 @@
 import { fetchWithRetry } from '../transport/fetch-with-retry.js';
+import { camelCaseKeys } from './case-conversion.js';
 /**
  * Helper function to determine content-type from filename extension.
  * @param fileName - The filename to analyze
@@ -138,5 +139,5 @@ export async function uploadMultipartFile(args) {
         },
         customFetch,
     });
-    return response.data;
+    return camelCaseKeys(response.data);
 }

package/dist/types/todoist-api.d.ts

@@ -789,15 +789,83 @@ export declare class TodoistApi {
      * @returns A promise that resolves to `true` if successful.
      */
     deleteFolder(id: string, requestId?: string): Promise<boolean>;
+    /**
+     * Retrieves a paginated list of goals.
+     *
+     * @param args - Optional filters including owner type, workspace ID, cursor, and limit.
+     * @returns A promise that resolves to a paginated list of goals.
+     */
     getGoals(args?: GetGoalsArgs): Promise<GetGoalsResponse>;
+    /**
+     * Searches for goals matching a query.
+     *
+     * @param args - Search parameters including query string and optional owner type.
+     * @returns A promise that resolves to a paginated list of matching goals.
+     */
     searchGoals(args: SearchGoalsArgs): Promise<GetGoalsResponse>;
+    /**
+     * Retrieves a single goal by its ID.
+     *
+     * @param id - The unique identifier of the goal.
+     * @returns A promise that resolves to the goal.
+     */
     getGoal(id: string): Promise<Goal>;
+    /**
+     * Creates a new goal.
+     *
+     * @param args - Goal attributes including name and optional workspace, description, deadline, and responsible user.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the created goal.
+     */
     addGoal(args: AddGoalArgs, requestId?: string): Promise<Goal>;
+    /**
+     * Updates an existing goal.
+     *
+     * @param id - The unique identifier of the goal to update.
+     * @param args - Attributes to update on the goal.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     updateGoal(id: string, args: UpdateGoalArgs, requestId?: string): Promise<Goal>;
+    /**
+     * Deletes a goal by its ID.
+     *
+     * @param id - The unique identifier of the goal to delete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
     deleteGoal(id: string, requestId?: string): Promise<boolean>;
+    /**
+     * Marks a goal as complete.
+     *
+     * @param id - The unique identifier of the goal to complete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     completeGoal(id: string, requestId?: string): Promise<Goal>;
+    /**
+     * Marks a previously completed goal as incomplete.
+     *
+     * @param id - The unique identifier of the goal to uncomplete.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     uncompleteGoal(id: string, requestId?: string): Promise<Goal>;
+    /**
+     * Links a task to a goal so it contributes to goal progress.
+     *
+     * @param args - The goal ID and task ID to link.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to the updated goal.
+     */
     linkTaskToGoal(args: TaskLinkingArgs, requestId?: string): Promise<Goal>;
+    /**
+     * Unlinks a previously linked task from a goal.
+     *
+     * @param args - The goal ID and task ID to unlink.
+     * @param requestId - Optional custom identifier for the request.
+     * @returns A promise that resolves to `true` if successful.
+     */
     unlinkTaskFromGoal(args: TaskLinkingArgs, requestId?: string): Promise<boolean>;
     /**
      * Retrieves a list of available backups.

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

@@ -67,7 +67,12 @@ export declare function isNetworkError(error: Error): error is NetworkError;
  */
 export declare function isHttpError(error: Error): error is HttpError;
 /**
- * Custom fetch response interface that custom HTTP clients must implement
+ * Custom fetch response interface that custom HTTP clients must implement.
+ *
+ * `arrayBuffer()` is optional for back-compat with existing implementations,
+ * but must be provided when the fetch is used with binary endpoints
+ * (`viewAttachment`, `downloadBackup`) — those endpoints throw at runtime if
+ * it is missing rather than fall back to a lossy `text()` round-trip.
  */
 export type CustomFetchResponse = {
     ok: boolean;
@@ -76,6 +81,7 @@ export type CustomFetchResponse = {
     headers: Record<string, string>;
     text(): Promise<string>;
     json(): Promise<unknown>;
+    arrayBuffer?: () => Promise<ArrayBuffer>;
 };
 /**
  * Custom fetch function type for alternative HTTP clients

package/dist/types/utils/file-response.d.ts

@@ -0,0 +1,15 @@
+import type { CustomFetchResponse, FileResponse } from '../types/http.js';
+type AnyResponse = CustomFetchResponse | Response;
+/**
+ * Wraps either a native `Response` or a `CustomFetchResponse` into the SDK's
+ * `FileResponse` shape (binary endpoints: `viewAttachment`, `downloadBackup`).
+ *
+ * `arrayBuffer()` is resolved lazily. A customFetch implementation that omits
+ * `arrayBuffer()` is still valid for callers that only read `text()`/`json()`;
+ * the descriptive error is thrown only if the caller actually requests binary
+ * bytes. This avoids the lossy `text()` → `TextEncoder` round-trip that
+ * corrupts non-UTF-8 bytes (every `0x80`-`0xFF` byte not part of a valid UTF-8
+ * sequence is replaced with `U+FFFD`).
+ */
+export declare function wrapAsFileResponse(response: AnyResponse, context: 'viewAttachment' | 'downloadBackup'): FileResponse;
+export {};

package/dist/types/utils/multipart-upload.d.ts

@@ -50,5 +50,5 @@ type UploadMultipartFileArgs = {
  * )
  * ```
  */
-export declare function uploadMultipartFile<T>(args: UploadMultipartFileArgs): Promise<T>;
+export declare function uploadMultipartFile(args: UploadMultipartFileArgs): Promise<unknown>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-sdk",
-    "version": "10.2.0-next.2",
+    "version": "10.2.0-next.4",
     "description": "The official TypeScript SDK for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "https://github.com/Doist/todoist-sdk-typescript",
@@ -41,11 +41,14 @@
         "build:fix-dts": "node scripts/fix-dts-imports.cjs",
         "build:post": "echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
         "build": "npm-run-all clean build:cjs build:esm build:fix-esm build:fix-dts build:post",
-        "attw": "npx @arethetypeswrong/cli --pack --ignore-rules fallback-condition false-esm",
+        "attw": "attw --pack --ignore-rules fallback-condition false-esm",
         "integrity-checks": "npm-run-all clean check test build attw",
         "prepublishOnly": "npm run integrity-checks",
         "prepare": "npm run build"
     },
+    "overrides": {
+        "fflate": "0.8.2"
+    },
     "dependencies": {
         "camelcase": "6.3.0",
         "emoji-regex": "10.6.0",
@@ -56,6 +59,7 @@
         "zod": "4.3.6"
     },
     "devDependencies": {
+        "@arethetypeswrong/cli": "0.18.2",
         "@semantic-release/changelog": "6.0.3",
         "@semantic-release/git": "10.0.1",
         "conventional-changelog-conventionalcommits": "9.3.1",