@doist/todoist-sdk 10.2.0-next.1 → 10.2.0-next.3

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/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/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/transport/http-dispatcher.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDefaultDispatcher = getDefaultDispatcher;
 exports.resetDefaultDispatcherForTests = resetDefaultDispatcherForTests;
+exports.suppressExperimentalWarningsSync = suppressExperimentalWarningsSync;
 // Use effectively-disabled keep-alive so short-lived CLI processes do not stay
 // open waiting on idle sockets. Undici requires positive values, so we use 1ms.
 const KEEP_ALIVE_OPTIONS = {
@@ -63,8 +64,53 @@ async function resetDefaultDispatcherForTests() {
     await dispatcherPromise.then((dispatcher) => dispatcher.close(), () => undefined);
 }
 async function createDefaultDispatcher() {
-    const { EnvHttpProxyAgent } = await Promise.resolve().then(() => __importStar(require('undici')));
-    return new EnvHttpProxyAgent(KEEP_ALIVE_OPTIONS);
+    // Dynamic import so non-Node consumers (browser, edge runtimes) don't pull
+    // undici into their bundle. `getDefaultDispatcher` already short-circuits
+    // outside Node, so this branch only runs when undici is safe to load.
+    const { EnvHttpProxyAgent, interceptors } = await Promise.resolve().then(() => __importStar(require('undici')));
+    // Compose the response-decompression interceptor so gzip/deflate/br/zstd
+    // bodies are decoded before consumers parse them. Required on Node 24+:
+    // attaching any custom dispatcher to the global `fetch` strips the
+    // `content-encoding` header but does not actually decompress the body,
+    // so callers receive raw gzipped bytes and `JSON.parse` fails.
+    // See https://github.com/Doist/todoist-cli/issues/318.
+    const decompress = suppressExperimentalWarningsSync(() => interceptors.decompress());
+    return new EnvHttpProxyAgent(KEEP_ALIVE_OPTIONS).compose(decompress);
+}
+// undici emits an `ExperimentalWarning` the first time `interceptors.decompress()`
+// runs. The interceptor is stable for our gzipped-JSON-over-HTTPS use case;
+// silence the warning during dispatcher init only so it does not leak to every
+// consumer's stderr on the first request.
+//
+// `fn` must be synchronous so the override covers a single critical section
+// (microseconds) — no unrelated `ExperimentalWarning` from elsewhere can
+// interleave and be lost. We suppress every `ExperimentalWarning` rather than
+// pattern-matching the message text: the message wording is an undici
+// implementation detail (not a stable API), and the suppression window is
+// narrow enough that a coarse type filter is safe.
+//
+// Exported for direct unit testing — the integration path through
+// `getDefaultDispatcher()` cannot reliably exercise the helper because both
+// the dispatcher singleton and undici's internal `warningEmitted` flag are
+// once-per-process.
+function suppressExperimentalWarningsSync(fn) {
+    const originalEmit = process.emitWarning;
+    process.emitWarning = ((warning, typeOrOptions, ...rest) => {
+        const type = typeof typeOrOptions === 'string'
+            ? typeOrOptions
+            : typeof typeOrOptions === 'object' && typeOrOptions !== null
+                ? typeOrOptions.type
+                : undefined;
+        if (type === 'ExperimentalWarning')
+            return;
+        originalEmit.call(process, warning, typeOrOptions, ...rest);
+    });
+    try {
+        return fn();
+    }
+    finally {
+        process.emitWarning = originalEmit;
+    }
 }
 function isNodeEnvironment() {
     var _a;

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/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/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/transport/http-dispatcher.js

@@ -26,8 +26,53 @@ export async function resetDefaultDispatcherForTests() {
     await dispatcherPromise.then((dispatcher) => dispatcher.close(), () => undefined);
 }
 async function createDefaultDispatcher() {
-    const { EnvHttpProxyAgent } = await import('undici');
-    return new EnvHttpProxyAgent(KEEP_ALIVE_OPTIONS);
+    // Dynamic import so non-Node consumers (browser, edge runtimes) don't pull
+    // undici into their bundle. `getDefaultDispatcher` already short-circuits
+    // outside Node, so this branch only runs when undici is safe to load.
+    const { EnvHttpProxyAgent, interceptors } = await import('undici');
+    // Compose the response-decompression interceptor so gzip/deflate/br/zstd
+    // bodies are decoded before consumers parse them. Required on Node 24+:
+    // attaching any custom dispatcher to the global `fetch` strips the
+    // `content-encoding` header but does not actually decompress the body,
+    // so callers receive raw gzipped bytes and `JSON.parse` fails.
+    // See https://github.com/Doist/todoist-cli/issues/318.
+    const decompress = suppressExperimentalWarningsSync(() => interceptors.decompress());
+    return new EnvHttpProxyAgent(KEEP_ALIVE_OPTIONS).compose(decompress);
+}
+// undici emits an `ExperimentalWarning` the first time `interceptors.decompress()`
+// runs. The interceptor is stable for our gzipped-JSON-over-HTTPS use case;
+// silence the warning during dispatcher init only so it does not leak to every
+// consumer's stderr on the first request.
+//
+// `fn` must be synchronous so the override covers a single critical section
+// (microseconds) — no unrelated `ExperimentalWarning` from elsewhere can
+// interleave and be lost. We suppress every `ExperimentalWarning` rather than
+// pattern-matching the message text: the message wording is an undici
+// implementation detail (not a stable API), and the suppression window is
+// narrow enough that a coarse type filter is safe.
+//
+// Exported for direct unit testing — the integration path through
+// `getDefaultDispatcher()` cannot reliably exercise the helper because both
+// the dispatcher singleton and undici's internal `warningEmitted` flag are
+// once-per-process.
+export function suppressExperimentalWarningsSync(fn) {
+    const originalEmit = process.emitWarning;
+    process.emitWarning = ((warning, typeOrOptions, ...rest) => {
+        const type = typeof typeOrOptions === 'string'
+            ? typeOrOptions
+            : typeof typeOrOptions === 'object' && typeOrOptions !== null
+                ? typeOrOptions.type
+                : undefined;
+        if (type === 'ExperimentalWarning')
+            return;
+        originalEmit.call(process, warning, typeOrOptions, ...rest);
+    });
+    try {
+        return fn();
+    }
+    finally {
+        process.emitWarning = originalEmit;
+    }
 }
 function isNodeEnvironment() {
     var _a;

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/transport/http-dispatcher.d.ts

@@ -1,3 +1,4 @@
 import type { Dispatcher } from 'undici';
 export declare function getDefaultDispatcher(): Promise<Dispatcher | undefined>;
 export declare function resetDefaultDispatcherForTests(): Promise<void>;
+export declare function suppressExperimentalWarningsSync<T>(fn: () => T): T;

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.1",
+    "version": "10.2.0-next.3",
     "description": "The official TypeScript SDK for the Todoist REST API.",
     "author": "Doist developers",
     "repository": "https://github.com/Doist/todoist-sdk-typescript",
@@ -52,7 +52,7 @@
         "form-data": "4.0.5",
         "ts-custom-error": "^3.2.0",
         "undici": "^7.16.0",
-        "uuid": "11.1.0",
+        "uuid": "11.1.1",
         "zod": "4.3.6"
     },
     "devDependencies": {