@doist/twist-sdk 2.9.2 → 2.9.4

package/dist/cjs/testUtils/msw-setup.js

@@ -1,8 +1,75 @@
 "use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.server = void 0;
 var node_1 = require("msw/node");
 var vitest_1 = require("vitest");
+// In production the transport uses undici's own `fetch` (paired with the
+// dispatcher) so the request client and dispatcher stay on one undici version.
+// MSW intercepts the *global* `fetch`, not that separate undici instance, so
+// force the transport onto the global `fetch` for every test in the suite;
+// MSW then intercepts requests as usual. The real undici transport is covered
+// directly by `http-dispatcher.test.ts` and `fetch-with-retry.test.ts`, which
+// opt out of this seam.
+vitest_1.vi.mock('../transport/http-dispatcher', function (importOriginal) { return __awaiter(void 0, void 0, void 0, function () {
+    var actual;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, importOriginal()];
+            case 1:
+                actual = _a.sent();
+                return [2 /*return*/, __assign(__assign({}, actual), { getDefaultTransport: vitest_1.vi.fn(function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+                            return [2 /*return*/, undefined];
+                        }); }); }) })];
+        }
+    });
+}); });
 // Create MSW server instance
 exports.server = (0, node_1.setupServer)();
 // Start server before all tests

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

@@ -137,23 +137,29 @@ function fetchWithRetry(url_1, options_1) {
 }
 function fetchWithDefaultTransport(url, options, signal) {
     return __awaiter(this, void 0, void 0, function () {
-        var dispatcher, response, _a;
-        return __generator(this, function (_b) {
-            switch (_b.label) {
-                case 0: return [4 /*yield*/, (0, http_dispatcher_1.getDefaultDispatcher)()];
+        var transport, fetchImpl, response, _a;
+        var _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0: return [4 /*yield*/, (0, http_dispatcher_1.getDefaultTransport)()
+                    // undici's `fetch` and the global `fetch` are the same function at runtime
+                    // but carry different (undici vs DOM) `RequestInit`/`Response` types. Call
+                    // through the global signature, which matches the global-typed `options`.
+                ];
                 case 1:
-                    dispatcher = _b.sent();
-                    if (!dispatcher) return [3 /*break*/, 3];
-                    return [4 /*yield*/, fetch(url, __assign(__assign({}, options), { signal: signal, 
+                    transport = _c.sent();
+                    fetchImpl = ((_b = transport === null || transport === void 0 ? void 0 : transport.fetch) !== null && _b !== void 0 ? _b : fetch);
+                    if (!(transport === null || transport === void 0 ? void 0 : transport.dispatcher)) return [3 /*break*/, 3];
+                    return [4 /*yield*/, fetchImpl(url, __assign(__assign({}, options), { signal: signal, 
                             // @ts-expect-error - dispatcher is valid for Node.js fetch but not in TS types
-                            dispatcher: dispatcher }))];
+                            dispatcher: transport.dispatcher }))];
                 case 2:
-                    _a = _b.sent();
+                    _a = _c.sent();
                     return [3 /*break*/, 5];
-                case 3: return [4 /*yield*/, fetch(url, __assign(__assign({}, options), { signal: signal }))];
+                case 3: return [4 /*yield*/, fetchImpl(url, __assign(__assign({}, options), { signal: signal }))];
                 case 4:
-                    _a = _b.sent();
-                    _b.label = 5;
+                    _a = _c.sent();
+                    _c.label = 5;
                 case 5:
                     response = _a;
                     return [2 /*return*/, convertResponseToCustomFetch(response)];

package/dist/cjs/transport/http-dispatcher.js

@@ -78,8 +78,10 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultTransport = getDefaultTransport;
 exports.getDefaultDispatcher = getDefaultDispatcher;
 exports.resetDefaultDispatcherForTests = resetDefaultDispatcherForTests;
+exports.getDefaultFetch = getDefaultFetch;
 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.
@@ -87,41 +89,76 @@ var keepAliveOptions = {
     keepAliveTimeout: 1,
     keepAliveMaxTimeout: 1,
 };
-var defaultDispatcher;
-var defaultDispatcherPromise;
-function getDefaultDispatcher() {
+var defaultTransport;
+var defaultTransportPromise;
+/**
+ * The default dispatcher and its paired `fetch`, as a single value so the two
+ * are always read consistently. Resolves to `undefined` outside Node (browser/
+ * edge), where callers use the global `fetch` with no dispatcher.
+ */
+function getDefaultTransport() {
     return __awaiter(this, void 0, void 0, function () {
         return __generator(this, function (_a) {
-            if (defaultDispatcher) {
-                return [2 /*return*/, defaultDispatcher];
+            if (defaultTransport) {
+                return [2 /*return*/, defaultTransport];
             }
-            if (!defaultDispatcherPromise) {
-                defaultDispatcherPromise = createDefaultDispatcher()
-                    .then(function (dispatcher) {
-                    defaultDispatcher = dispatcher;
-                    return dispatcher;
+            if (!defaultTransportPromise) {
+                defaultTransportPromise = createDefaultTransport()
+                    .then(function (transport) {
+                    defaultTransport = transport;
+                    return transport;
                 })
                     .catch(function (error) {
-                    defaultDispatcher = undefined;
-                    defaultDispatcherPromise = undefined;
+                    defaultTransport = undefined;
+                    defaultTransportPromise = undefined;
                     throw error;
                 });
             }
-            return [2 /*return*/, defaultDispatcherPromise];
+            return [2 /*return*/, defaultTransportPromise];
+        });
+    });
+}
+function getDefaultDispatcher() {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, getDefaultTransport()];
+                case 1: return [2 /*return*/, (_a = (_b.sent())) === null || _a === void 0 ? void 0 : _a.dispatcher];
+            }
         });
     });
 }
 function resetDefaultDispatcherForTests() {
-    defaultDispatcher = undefined;
-    defaultDispatcherPromise = undefined;
+    defaultTransport = undefined;
+    defaultTransportPromise = undefined;
+}
+/**
+ * The `fetch` implementation that must be used with the default dispatcher.
+ * Returns undici's own `fetch` on the full-undici Node path, or `undefined`
+ * (meaning: use the global `fetch`) in the browser/edge/Bun paths.
+ *
+ * Node's global `fetch` is backed by whatever undici version ships inside that
+ * Node release (6.x on Node 22 … 8.x on Node 26). Our dispatcher — and its
+ * `decompress` interceptor — comes from the npm `undici` package, which is a
+ * different version. Handing an npm-undici dispatcher to a mismatched built-in
+ * client makes gzip responses fail mid-stream with `terminated`. Sourcing
+ * `fetch` from the same npm `undici` keeps the whole request path on one
+ * version and removes the split.
+ *
+ * Only meaningful after {@link getDefaultTransport} has resolved, which is the
+ * one place that populates it.
+ */
+function getDefaultFetch() {
+    return defaultTransport === null || defaultTransport === void 0 ? void 0 : defaultTransport.fetch;
 }
 function isNodeEnvironment() {
     var _a;
     return typeof process !== 'undefined' && typeof ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node) === 'string';
 }
-function createDefaultDispatcher() {
+function createDefaultTransport() {
     return __awaiter(this, void 0, void 0, function () {
-        var _a, EnvHttpProxyAgent, interceptors, decompress;
+        var _a, EnvHttpProxyAgent, interceptors, undiciFetch, agent, decompress;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
@@ -130,9 +167,27 @@ function createDefaultDispatcher() {
                     }
                     return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require('undici')); })];
                 case 1:
-                    _a = _b.sent(), EnvHttpProxyAgent = _a.EnvHttpProxyAgent, interceptors = _a.interceptors;
+                    _a = _b.sent(), EnvHttpProxyAgent = _a.EnvHttpProxyAgent, interceptors = _a.interceptors, undiciFetch = _a.fetch;
+                    agent = new EnvHttpProxyAgent(keepAliveOptions);
+                    // Some runtimes report `process.versions.node` (so `isNodeEnvironment()`
+                    // passes) but ship only a partial undici: `interceptors.decompress` is
+                    // absent and dispatchers have no `.compose`. Bun is the common case. There
+                    // the proxy agent alone is enough — Bun's `fetch` decompresses
+                    // gzip/deflate/br/zstd natively — so skip the interceptor instead of
+                    // crashing on the missing API. Optional chaining also guards a runtime that
+                    // omits the `interceptors` export entirely.
+                    if (typeof (interceptors === null || interceptors === void 0 ? void 0 : interceptors.decompress) !== 'function') {
+                        // Bun: pair the agent with the global `fetch` (undefined), which
+                        // decompresses natively.
+                        return [2 /*return*/, { dispatcher: agent, fetch: undefined }];
+                    }
                     decompress = suppressExperimentalWarningsSync(function () { return interceptors.decompress(); });
-                    return [2 /*return*/, new EnvHttpProxyAgent(keepAliveOptions).compose(decompress)];
+                    // Pair undici's own `fetch` with this dispatcher so the request client and
+                    // the dispatcher stay on one undici version (see `getDefaultFetch`). The
+                    // global `fetch` is backed by a different, Node-bundled undici; mixing the
+                    // two makes the decompress interceptor terminate gzip responses on some
+                    // Node versions.
+                    return [2 /*return*/, { dispatcher: agent.compose(decompress), fetch: undiciFetch }];
             }
         });
     });

package/dist/esm/testUtils/msw-setup.js

@@ -1,5 +1,72 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 import { setupServer } from 'msw/node';
-import { afterAll, afterEach, beforeAll } from 'vitest';
+import { afterAll, afterEach, beforeAll, vi } from 'vitest';
+// In production the transport uses undici's own `fetch` (paired with the
+// dispatcher) so the request client and dispatcher stay on one undici version.
+// MSW intercepts the *global* `fetch`, not that separate undici instance, so
+// force the transport onto the global `fetch` for every test in the suite;
+// MSW then intercepts requests as usual. The real undici transport is covered
+// directly by `http-dispatcher.test.ts` and `fetch-with-retry.test.ts`, which
+// opt out of this seam.
+vi.mock('../transport/http-dispatcher', function (importOriginal) { return __awaiter(void 0, void 0, void 0, function () {
+    var actual;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, importOriginal()];
+            case 1:
+                actual = _a.sent();
+                return [2 /*return*/, __assign(__assign({}, actual), { getDefaultTransport: vi.fn(function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+                            return [2 /*return*/, undefined];
+                        }); }); }) })];
+        }
+    });
+}); });
 // Create MSW server instance
 export var server = setupServer();
 // Start server before all tests

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

@@ -48,7 +48,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 import { TwistRequestError } from '../types/errors.js';
 import { camelCaseKeys } from '../utils/case-conversion.js';
 import { transformTimestamps } from '../utils/timestamp-conversion.js';
-import { getDefaultDispatcher } from './http-dispatcher.js';
+import { getDefaultTransport } from './http-dispatcher.js';
 export function fetchWithRetry(url_1, options_1) {
     return __awaiter(this, arguments, void 0, function (url, options, maxRetries, customFetch) {
         var lastError, attempt, clearTimeoutFn, requestSignal, timeoutResult, response, _a, responseText, responseData, camelCased, transformed, error_1, delay;
@@ -134,23 +134,29 @@ export function fetchWithRetry(url_1, options_1) {
 }
 function fetchWithDefaultTransport(url, options, signal) {
     return __awaiter(this, void 0, void 0, function () {
-        var dispatcher, response, _a;
-        return __generator(this, function (_b) {
-            switch (_b.label) {
-                case 0: return [4 /*yield*/, getDefaultDispatcher()];
+        var transport, fetchImpl, response, _a;
+        var _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0: return [4 /*yield*/, getDefaultTransport()
+                    // undici's `fetch` and the global `fetch` are the same function at runtime
+                    // but carry different (undici vs DOM) `RequestInit`/`Response` types. Call
+                    // through the global signature, which matches the global-typed `options`.
+                ];
                 case 1:
-                    dispatcher = _b.sent();
-                    if (!dispatcher) return [3 /*break*/, 3];
-                    return [4 /*yield*/, fetch(url, __assign(__assign({}, options), { signal: signal, 
+                    transport = _c.sent();
+                    fetchImpl = ((_b = transport === null || transport === void 0 ? void 0 : transport.fetch) !== null && _b !== void 0 ? _b : fetch);
+                    if (!(transport === null || transport === void 0 ? void 0 : transport.dispatcher)) return [3 /*break*/, 3];
+                    return [4 /*yield*/, fetchImpl(url, __assign(__assign({}, options), { signal: signal, 
                             // @ts-expect-error - dispatcher is valid for Node.js fetch but not in TS types
-                            dispatcher: dispatcher }))];
+                            dispatcher: transport.dispatcher }))];
                 case 2:
-                    _a = _b.sent();
+                    _a = _c.sent();
                     return [3 /*break*/, 5];
-                case 3: return [4 /*yield*/, fetch(url, __assign(__assign({}, options), { signal: signal }))];
+                case 3: return [4 /*yield*/, fetchImpl(url, __assign(__assign({}, options), { signal: signal }))];
                 case 4:
-                    _a = _b.sent();
-                    _b.label = 5;
+                    _a = _c.sent();
+                    _c.label = 5;
                 case 5:
                     response = _a;
                     return [2 /*return*/, convertResponseToCustomFetch(response)];

package/dist/esm/transport/http-dispatcher.js

@@ -49,59 +49,105 @@ var keepAliveOptions = {
     keepAliveTimeout: 1,
     keepAliveMaxTimeout: 1,
 };
-var defaultDispatcher;
-var defaultDispatcherPromise;
-export function getDefaultDispatcher() {
+var defaultTransport;
+var defaultTransportPromise;
+/**
+ * The default dispatcher and its paired `fetch`, as a single value so the two
+ * are always read consistently. Resolves to `undefined` outside Node (browser/
+ * edge), where callers use the global `fetch` with no dispatcher.
+ */
+export function getDefaultTransport() {
     return __awaiter(this, void 0, void 0, function () {
         return __generator(this, function (_a) {
-            if (defaultDispatcher) {
-                return [2 /*return*/, defaultDispatcher];
+            if (defaultTransport) {
+                return [2 /*return*/, defaultTransport];
             }
-            if (!defaultDispatcherPromise) {
-                defaultDispatcherPromise = createDefaultDispatcher()
-                    .then(function (dispatcher) {
-                    defaultDispatcher = dispatcher;
-                    return dispatcher;
+            if (!defaultTransportPromise) {
+                defaultTransportPromise = createDefaultTransport()
+                    .then(function (transport) {
+                    defaultTransport = transport;
+                    return transport;
                 })
                     .catch(function (error) {
-                    defaultDispatcher = undefined;
-                    defaultDispatcherPromise = undefined;
+                    defaultTransport = undefined;
+                    defaultTransportPromise = undefined;
                     throw error;
                 });
             }
-            return [2 /*return*/, defaultDispatcherPromise];
+            return [2 /*return*/, defaultTransportPromise];
+        });
+    });
+}
+export function getDefaultDispatcher() {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, getDefaultTransport()];
+                case 1: return [2 /*return*/, (_a = (_b.sent())) === null || _a === void 0 ? void 0 : _a.dispatcher];
+            }
         });
     });
 }
 export function resetDefaultDispatcherForTests() {
-    defaultDispatcher = undefined;
-    defaultDispatcherPromise = undefined;
+    defaultTransport = undefined;
+    defaultTransportPromise = undefined;
+}
+/**
+ * The `fetch` implementation that must be used with the default dispatcher.
+ * Returns undici's own `fetch` on the full-undici Node path, or `undefined`
+ * (meaning: use the global `fetch`) in the browser/edge/Bun paths.
+ *
+ * Node's global `fetch` is backed by whatever undici version ships inside that
+ * Node release (6.x on Node 22 … 8.x on Node 26). Our dispatcher — and its
+ * `decompress` interceptor — comes from the npm `undici` package, which is a
+ * different version. Handing an npm-undici dispatcher to a mismatched built-in
+ * client makes gzip responses fail mid-stream with `terminated`. Sourcing
+ * `fetch` from the same npm `undici` keeps the whole request path on one
+ * version and removes the split.
+ *
+ * Only meaningful after {@link getDefaultTransport} has resolved, which is the
+ * one place that populates it.
+ */
+export function getDefaultFetch() {
+    return defaultTransport === null || defaultTransport === void 0 ? void 0 : defaultTransport.fetch;
 }
 function isNodeEnvironment() {
     var _a;
     return typeof process !== 'undefined' && typeof ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node) === 'string';
 }
-function createDefaultDispatcher() {
+function createDefaultTransport() {
     return __awaiter(this, void 0, void 0, function () {
-        var _a, EnvHttpProxyAgent, interceptors, decompress;
+        var _a, EnvHttpProxyAgent, interceptors, undiciFetch, agent, decompress;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
                     if (!isNodeEnvironment()) {
                         return [2 /*return*/, undefined];
                     }
-                    return [4 /*yield*/, 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.
-                    ];
+                    return [4 /*yield*/, import('undici')];
                 case 1:
-                    _a = _b.sent(), EnvHttpProxyAgent = _a.EnvHttpProxyAgent, interceptors = _a.interceptors;
+                    _a = _b.sent(), EnvHttpProxyAgent = _a.EnvHttpProxyAgent, interceptors = _a.interceptors, undiciFetch = _a.fetch;
+                    agent = new EnvHttpProxyAgent(keepAliveOptions);
+                    // Some runtimes report `process.versions.node` (so `isNodeEnvironment()`
+                    // passes) but ship only a partial undici: `interceptors.decompress` is
+                    // absent and dispatchers have no `.compose`. Bun is the common case. There
+                    // the proxy agent alone is enough — Bun's `fetch` decompresses
+                    // gzip/deflate/br/zstd natively — so skip the interceptor instead of
+                    // crashing on the missing API. Optional chaining also guards a runtime that
+                    // omits the `interceptors` export entirely.
+                    if (typeof (interceptors === null || interceptors === void 0 ? void 0 : interceptors.decompress) !== 'function') {
+                        // Bun: pair the agent with the global `fetch` (undefined), which
+                        // decompresses natively.
+                        return [2 /*return*/, { dispatcher: agent, fetch: undefined }];
+                    }
                     decompress = suppressExperimentalWarningsSync(function () { return interceptors.decompress(); });
-                    return [2 /*return*/, new EnvHttpProxyAgent(keepAliveOptions).compose(decompress)];
+                    // Pair undici's own `fetch` with this dispatcher so the request client and
+                    // the dispatcher stay on one undici version (see `getDefaultFetch`). The
+                    // global `fetch` is backed by a different, Node-bundled undici; mixing the
+                    // two makes the decompress interceptor terminate gzip responses on some
+                    // Node versions.
+                    return [2 /*return*/, { dispatcher: agent.compose(decompress), fetch: undiciFetch }];
             }
         });
     });

package/dist/types/transport/http-dispatcher.d.ts

@@ -1,4 +1,40 @@
 import type { Dispatcher } from 'undici';
+type UndiciFetch = typeof import('undici').fetch;
+/**
+ * A dispatcher and the `fetch` that must be used with it. `fetch` is undici's
+ * own `fetch` on the full-undici Node path, or `undefined` (meaning: use the
+ * global `fetch`) on the Bun path. The two are cached together so callers can
+ * never observe a dispatcher paired with a mismatched `fetch` — see
+ * {@link getDefaultFetch} for why the pairing matters.
+ */
+type DefaultTransport = {
+    dispatcher: Dispatcher;
+    fetch: UndiciFetch | undefined;
+};
+/**
+ * The default dispatcher and its paired `fetch`, as a single value so the two
+ * are always read consistently. Resolves to `undefined` outside Node (browser/
+ * edge), where callers use the global `fetch` with no dispatcher.
+ */
+export declare function getDefaultTransport(): Promise<DefaultTransport | undefined>;
 export declare function getDefaultDispatcher(): Promise<Dispatcher | undefined>;
 export declare function resetDefaultDispatcherForTests(): void;
+/**
+ * The `fetch` implementation that must be used with the default dispatcher.
+ * Returns undici's own `fetch` on the full-undici Node path, or `undefined`
+ * (meaning: use the global `fetch`) in the browser/edge/Bun paths.
+ *
+ * Node's global `fetch` is backed by whatever undici version ships inside that
+ * Node release (6.x on Node 22 … 8.x on Node 26). Our dispatcher — and its
+ * `decompress` interceptor — comes from the npm `undici` package, which is a
+ * different version. Handing an npm-undici dispatcher to a mismatched built-in
+ * client makes gzip responses fail mid-stream with `terminated`. Sourcing
+ * `fetch` from the same npm `undici` keeps the whole request path on one
+ * version and removes the split.
+ *
+ * Only meaningful after {@link getDefaultTransport} has resolved, which is the
+ * one place that populates it.
+ */
+export declare function getDefaultFetch(): UndiciFetch | undefined;
 export declare function suppressExperimentalWarningsSync<T>(fn: () => T): T;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/twist-sdk",
-    "version": "2.9.2",
+    "version": "2.9.4",
     "description": "A TypeScript wrapper for the Twist REST API.",
     "author": "Doist developers",
     "homepage": "https://doist.github.io/twist-sdk-typescript/",