@datocms/rest-client-utils 5.4.9 → 5.8.0

package/dist/cjs/__tests__/errors.test.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const errors_1 = require("../errors");
+const makeCancelablePromise_1 = require("../makeCancelablePromise");
+function buildApiError() {
+    return new errors_1.ApiError({
+        request: {
+            url: '/items/bad-id',
+            method: 'GET',
+            headers: {},
+            body: undefined,
+        },
+        response: {
+            status: 422,
+            statusText: 'Unprocessable Entity',
+            headers: {},
+            body: {
+                data: [
+                    {
+                        id: '1',
+                        type: 'api_error',
+                        attributes: {
+                            code: 'INVALID_FIELD',
+                            doc_url: 'https://www.datocms.com/docs',
+                            details: { field: 'item_id' },
+                        },
+                    },
+                ],
+            },
+        },
+    });
+}
+function buildTimeoutError() {
+    return new errors_1.TimeoutError({
+        request: { url: '/items', method: 'GET', headers: {}, body: undefined },
+    });
+}
+describe('ApiError', () => {
+    it('keeps a correct prototype chain and name', () => {
+        const error = buildApiError();
+        expect(error).toBeInstanceOf(errors_1.ApiError);
+        expect(error).toBeInstanceOf(Error);
+        expect(error.name).toBe('ApiError');
+        expect(error.constructor.name).toBe('ApiError');
+    });
+    it('exposes request, response and parsed errors', () => {
+        const error = buildApiError();
+        expect(error.response.status).toBe(422);
+        expect(error.request.url).toBe('/items/bad-id');
+        expect(error.errors).toHaveLength(1);
+        expect(error.findError('INVALID_FIELD')).toBeTruthy();
+    });
+    // These packages ship parallel CJS and ESM builds, so a bundler can load two
+    // distinct copies of this module. `instanceof` must still work for an error
+    // produced by the other copy.
+    it('recognizes an instance coming from a duplicate copy of the module', () => {
+        const fromOtherCopy = Object.assign(new Error('API Error!'), {
+            name: 'ApiError',
+            [Symbol.for('@datocms/rest-client-utils:ApiError')]: true,
+        });
+        expect(fromOtherCopy).toBeInstanceOf(errors_1.ApiError);
+    });
+    it('does not recognize unrelated values', () => {
+        expect(new Error('nope')).not.toBeInstanceOf(errors_1.ApiError);
+        expect({}).not.toBeInstanceOf(errors_1.ApiError);
+        expect(null).not.toBeInstanceOf(errors_1.ApiError);
+        expect(buildTimeoutError()).not.toBeInstanceOf(errors_1.ApiError);
+        // merely borrowing the name is not enough
+        expect(Object.assign(new Error('impostor'), { name: 'ApiError' })).not.toBeInstanceOf(errors_1.ApiError);
+    });
+    it('keeps subclass checks exact', () => {
+        class SubclassedApiError extends errors_1.ApiError {
+        }
+        const parent = buildApiError();
+        const child = new SubclassedApiError({
+            request: { url: '/items', method: 'GET', headers: {}, body: undefined },
+            response: { status: 500, statusText: 'Error', headers: {}, body: {} },
+        });
+        expect(child).toBeInstanceOf(SubclassedApiError);
+        expect(child).toBeInstanceOf(errors_1.ApiError);
+        expect(parent).not.toBeInstanceOf(SubclassedApiError);
+    });
+});
+describe('TimeoutError', () => {
+    it('keeps a correct prototype chain and name', () => {
+        const error = buildTimeoutError();
+        expect(error).toBeInstanceOf(errors_1.TimeoutError);
+        expect(error).toBeInstanceOf(Error);
+        expect(error.name).toBe('TimeoutError');
+    });
+    it('recognizes an instance coming from a duplicate copy of the module', () => {
+        const fromOtherCopy = Object.assign(new Error('API Error!'), {
+            name: 'TimeoutError',
+            [Symbol.for('@datocms/rest-client-utils:TimeoutError')]: true,
+        });
+        expect(fromOtherCopy).toBeInstanceOf(errors_1.TimeoutError);
+    });
+    it('is not confused with an ApiError', () => {
+        expect(buildApiError()).not.toBeInstanceOf(errors_1.TimeoutError);
+    });
+});
+describe('CanceledPromiseError', () => {
+    it('keeps a correct prototype chain and name', () => {
+        const error = new makeCancelablePromise_1.CanceledPromiseError();
+        expect(error).toBeInstanceOf(makeCancelablePromise_1.CanceledPromiseError);
+        expect(error).toBeInstanceOf(Error);
+        expect(error.name).toBe('CanceledPromiseError');
+    });
+    it('recognizes an instance coming from a duplicate copy of the module', () => {
+        const fromOtherCopy = Object.assign(new Error('Promise canceled!'), {
+            name: 'CanceledPromiseError',
+            [Symbol.for('@datocms/rest-client-utils:CanceledPromiseError')]: true,
+        });
+        expect(fromOtherCopy).toBeInstanceOf(makeCancelablePromise_1.CanceledPromiseError);
+    });
+    it('is not confused with other error types', () => {
+        expect(buildApiError()).not.toBeInstanceOf(makeCancelablePromise_1.CanceledPromiseError);
+        expect(new Error('nope')).not.toBeInstanceOf(makeCancelablePromise_1.CanceledPromiseError);
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/cjs/__tests__/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../../src/__tests__/errors.test.ts"],"names":[],"mappings":"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"}

package/dist/cjs/errors.js

@@ -24,12 +24,46 @@ function isErrorBody(body) {
     }
     return true;
 }
+/**
+ * Brands stamped on error instances.
+ *
+ * `Symbol.for()` looks up the cross-realm global symbol registry, so every copy
+ * of this module — CJS or ESM, inlined by a bundler or not — resolves these to
+ * the very same symbols. Since these packages ship parallel CJS and ESM builds
+ * with no guarantee that a consumer ends up with a single copy, identity is
+ * carried by these brands rather than by class identity alone, so `instanceof`
+ * keeps working across duplicated copies.
+ */
+const TIMEOUT_ERROR = Symbol.for('@datocms/rest-client-utils:TimeoutError');
+const API_ERROR = Symbol.for('@datocms/rest-client-utils:ApiError');
 class TimeoutError extends Error {
+    static [Symbol.hasInstance](value) {
+        if (typeof value !== 'object' ||
+            value === null ||
+            !(TIMEOUT_ERROR in value)) {
+            return false;
+        }
+        // `this` is the constructor `instanceof` was invoked on: when it is a
+        // subclass, defer to a real prototype-chain check so subclasses stay exact.
+        // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+        const invokedOn = this;
+        if (invokedOn !== TimeoutError) {
+            return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+        }
+        return true;
+    }
     constructor(initObject) {
         super('API Error!');
         Object.setPrototypeOf(this, new.target.prototype);
+        Object.defineProperty(this, TIMEOUT_ERROR, {
+            value: true,
+            enumerable: false,
+            writable: false,
+            configurable: false,
+        });
+        this.name = 'TimeoutError';
         if ('captureStackTrace' in Error) {
-            Error.captureStackTrace(this, ApiError);
+            Error.captureStackTrace(this, TimeoutError);
         }
         else {
             this.stack = new Error().stack;
@@ -44,9 +78,29 @@ class TimeoutError extends Error {
 }
 exports.TimeoutError = TimeoutError;
 class ApiError extends Error {
+    static [Symbol.hasInstance](value) {
+        if (typeof value !== 'object' || value === null || !(API_ERROR in value)) {
+            return false;
+        }
+        // `this` is the constructor `instanceof` was invoked on: when it is a
+        // subclass, defer to a real prototype-chain check so subclasses stay exact.
+        // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+        const invokedOn = this;
+        if (invokedOn !== ApiError) {
+            return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+        }
+        return true;
+    }
     constructor(initObject) {
         super('API Error!');
         Object.setPrototypeOf(this, new.target.prototype);
+        Object.defineProperty(this, API_ERROR, {
+            value: true,
+            enumerable: false,
+            writable: false,
+            configurable: false,
+        });
+        this.name = 'ApiError';
         if ('captureStackTrace' in Error) {
             Error.captureStackTrace(this, ApiError);
         }

package/dist/cjs/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/cjs/makeCancelablePromise.js

@@ -1,10 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeCancelablePromise = exports.CanceledPromiseError = void 0;
+/**
+ * See the note on the brands in `errors.ts`: identity is carried by a symbol
+ * from the cross-realm global registry so that `instanceof` keeps working even
+ * when a bundler ends up loading more than one copy of this module.
+ */
+const CANCELED_PROMISE_ERROR = Symbol.for('@datocms/rest-client-utils:CanceledPromiseError');
 class CanceledPromiseError extends Error {
+    static [Symbol.hasInstance](value) {
+        if (typeof value !== 'object' ||
+            value === null ||
+            !(CANCELED_PROMISE_ERROR in value)) {
+            return false;
+        }
+        // `this` is the constructor `instanceof` was invoked on: when it is a
+        // subclass, defer to a real prototype-chain check so subclasses stay exact.
+        // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+        const invokedOn = this;
+        if (invokedOn !== CanceledPromiseError) {
+            return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+        }
+        return true;
+    }
     constructor() {
         super('Promise canceled!');
         Object.setPrototypeOf(this, new.target.prototype);
+        Object.defineProperty(this, CANCELED_PROMISE_ERROR, {
+            value: true,
+            enumerable: false,
+            writable: false,
+            configurable: false,
+        });
+        this.name = 'CanceledPromiseError';
     }
 }
 exports.CanceledPromiseError = CanceledPromiseError;

package/dist/cjs/makeCancelablePromise.js.map

@@ -1 +1 @@
-{"version":3,"file":"makeCancelablePromise.js","sourceRoot":"","sources":["../../src/makeCancelablePromise.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAqB,SAAQ,KAAK;IAC7C;QACE,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AALD,oDAKC;AAMD,SAAgB,qBAAqB,CACnC,gBAAiD,EACjD,QAAqB;IAErB,IAAI,MAAM,GAAwB,IAAI,CAAC;IAEvC,MAAM,UAAU,GAAyB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACvE,MAAM,GAAG,GAAG,EAAE;YACZ,IAAI;gBACF,IAAI,QAAQ,EAAE;oBACZ,QAAQ,EAAE,CAAC;iBACZ;gBACD,MAAM,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;aACpC;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,CAAC,CAAC,CAAC,CAAC;aACX;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GACX,OAAO,gBAAgB,KAAK,UAAU;YACpC,CAAC,CAAC,gBAAgB,EAAE;YACpB,CAAC,CAAC,gBAAgB,CAAC;QAEvB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,EAAE;QACV,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;KAC5B;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AA/BD,sDA+BC"}
+{"version":3,"file":"makeCancelablePromise.js","sourceRoot":"","sources":["../../src/makeCancelablePromise.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CACvC,iDAAiD,CAClD,CAAC;AAEF,MAAa,oBAAqB,SAAQ,KAAK;IAG7C,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAc;QACxC,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,CAAC,CAAC,sBAAsB,IAAI,KAAK,CAAC,EAClC;YACA,OAAO,KAAK,CAAC;SACd;QAED,sEAAsE;QACtE,4EAA4E;QAC5E,iIAAiI;QACjI,MAAM,SAAS,GAAG,IAAwC,CAAC;QAE3D,IAAI,SAAS,KAAK,oBAAoB,EAAE;YACtC,OAAO,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;SACxE;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;QACE,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAElD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,EAAE;YAClD,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AArCD,oDAqCC;AAMD,SAAgB,qBAAqB,CACnC,gBAAiD,EACjD,QAAqB;IAErB,IAAI,MAAM,GAAwB,IAAI,CAAC;IAEvC,MAAM,UAAU,GAAyB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACvE,MAAM,GAAG,GAAG,EAAE;YACZ,IAAI;gBACF,IAAI,QAAQ,EAAE;oBACZ,QAAQ,EAAE,CAAC;iBACZ;gBACD,MAAM,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;aACpC;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,CAAC,CAAC,CAAC,CAAC;aACX;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GACX,OAAO,gBAAgB,KAAK,UAAU;YACpC,CAAC,CAAC,gBAAgB,EAAE;YACpB,CAAC,CAAC,gBAAgB,CAAC;QAEvB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,EAAE;QACV,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;KAC5B;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AA/BD,sDA+BC"}

package/dist/esm/__tests__/errors.test.d.ts

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

package/dist/esm/__tests__/errors.test.js

@@ -0,0 +1,119 @@
+import { ApiError, TimeoutError } from '../errors';
+import { CanceledPromiseError } from '../makeCancelablePromise';
+function buildApiError() {
+    return new ApiError({
+        request: {
+            url: '/items/bad-id',
+            method: 'GET',
+            headers: {},
+            body: undefined,
+        },
+        response: {
+            status: 422,
+            statusText: 'Unprocessable Entity',
+            headers: {},
+            body: {
+                data: [
+                    {
+                        id: '1',
+                        type: 'api_error',
+                        attributes: {
+                            code: 'INVALID_FIELD',
+                            doc_url: 'https://www.datocms.com/docs',
+                            details: { field: 'item_id' },
+                        },
+                    },
+                ],
+            },
+        },
+    });
+}
+function buildTimeoutError() {
+    return new TimeoutError({
+        request: { url: '/items', method: 'GET', headers: {}, body: undefined },
+    });
+}
+describe('ApiError', () => {
+    it('keeps a correct prototype chain and name', () => {
+        const error = buildApiError();
+        expect(error).toBeInstanceOf(ApiError);
+        expect(error).toBeInstanceOf(Error);
+        expect(error.name).toBe('ApiError');
+        expect(error.constructor.name).toBe('ApiError');
+    });
+    it('exposes request, response and parsed errors', () => {
+        const error = buildApiError();
+        expect(error.response.status).toBe(422);
+        expect(error.request.url).toBe('/items/bad-id');
+        expect(error.errors).toHaveLength(1);
+        expect(error.findError('INVALID_FIELD')).toBeTruthy();
+    });
+    // These packages ship parallel CJS and ESM builds, so a bundler can load two
+    // distinct copies of this module. `instanceof` must still work for an error
+    // produced by the other copy.
+    it('recognizes an instance coming from a duplicate copy of the module', () => {
+        const fromOtherCopy = Object.assign(new Error('API Error!'), {
+            name: 'ApiError',
+            [Symbol.for('@datocms/rest-client-utils:ApiError')]: true,
+        });
+        expect(fromOtherCopy).toBeInstanceOf(ApiError);
+    });
+    it('does not recognize unrelated values', () => {
+        expect(new Error('nope')).not.toBeInstanceOf(ApiError);
+        expect({}).not.toBeInstanceOf(ApiError);
+        expect(null).not.toBeInstanceOf(ApiError);
+        expect(buildTimeoutError()).not.toBeInstanceOf(ApiError);
+        // merely borrowing the name is not enough
+        expect(Object.assign(new Error('impostor'), { name: 'ApiError' })).not.toBeInstanceOf(ApiError);
+    });
+    it('keeps subclass checks exact', () => {
+        class SubclassedApiError extends ApiError {
+        }
+        const parent = buildApiError();
+        const child = new SubclassedApiError({
+            request: { url: '/items', method: 'GET', headers: {}, body: undefined },
+            response: { status: 500, statusText: 'Error', headers: {}, body: {} },
+        });
+        expect(child).toBeInstanceOf(SubclassedApiError);
+        expect(child).toBeInstanceOf(ApiError);
+        expect(parent).not.toBeInstanceOf(SubclassedApiError);
+    });
+});
+describe('TimeoutError', () => {
+    it('keeps a correct prototype chain and name', () => {
+        const error = buildTimeoutError();
+        expect(error).toBeInstanceOf(TimeoutError);
+        expect(error).toBeInstanceOf(Error);
+        expect(error.name).toBe('TimeoutError');
+    });
+    it('recognizes an instance coming from a duplicate copy of the module', () => {
+        const fromOtherCopy = Object.assign(new Error('API Error!'), {
+            name: 'TimeoutError',
+            [Symbol.for('@datocms/rest-client-utils:TimeoutError')]: true,
+        });
+        expect(fromOtherCopy).toBeInstanceOf(TimeoutError);
+    });
+    it('is not confused with an ApiError', () => {
+        expect(buildApiError()).not.toBeInstanceOf(TimeoutError);
+    });
+});
+describe('CanceledPromiseError', () => {
+    it('keeps a correct prototype chain and name', () => {
+        const error = new CanceledPromiseError();
+        expect(error).toBeInstanceOf(CanceledPromiseError);
+        expect(error).toBeInstanceOf(Error);
+        expect(error.name).toBe('CanceledPromiseError');
+    });
+    it('recognizes an instance coming from a duplicate copy of the module', () => {
+        const fromOtherCopy = Object.assign(new Error('Promise canceled!'), {
+            name: 'CanceledPromiseError',
+            [Symbol.for('@datocms/rest-client-utils:CanceledPromiseError')]: true,
+        });
+        expect(fromOtherCopy).toBeInstanceOf(CanceledPromiseError);
+    });
+    it('is not confused with other error types', () => {
+        expect(buildApiError()).not.toBeInstanceOf(CanceledPromiseError);
+        expect(new Error('nope')).not.toBeInstanceOf(CanceledPromiseError);
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/esm/__tests__/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../../src/__tests__/errors.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/errors.d.ts

@@ -21,6 +21,18 @@ export type ApiErrorResponse = {
     headers: Record<string, string>;
     body?: unknown;
 };
+/**
+ * Brands stamped on error instances.
+ *
+ * `Symbol.for()` looks up the cross-realm global symbol registry, so every copy
+ * of this module — CJS or ESM, inlined by a bundler or not — resolves these to
+ * the very same symbols. Since these packages ship parallel CJS and ESM builds
+ * with no guarantee that a consumer ends up with a single copy, identity is
+ * carried by these brands rather than by class identity alone, so `instanceof`
+ * keeps working across duplicated copies.
+ */
+declare const TIMEOUT_ERROR: unique symbol;
+declare const API_ERROR: unique symbol;
 export type TimeoutErrorInitObject = {
     request: ApiErrorRequest;
     preCallStack?: string;
@@ -28,6 +40,8 @@ export type TimeoutErrorInitObject = {
 export declare class TimeoutError extends Error {
     request: ApiErrorRequest;
     preCallStack?: string;
+    readonly [TIMEOUT_ERROR]: true;
+    static [Symbol.hasInstance](value: unknown): value is TimeoutError;
     constructor(initObject: TimeoutErrorInitObject);
 }
 export type ApiErrorInitObject = {
@@ -39,6 +53,8 @@ export declare class ApiError extends Error {
     request: ApiErrorRequest;
     response: ApiErrorResponse;
     preCallStack?: string;
+    readonly [API_ERROR]: true;
+    static [Symbol.hasInstance](value: unknown): value is ApiError;
     constructor(initObject: ApiErrorInitObject);
     get errors(): ErrorEntity[];
     findError(codeOrCodes: string | string[], filterDetails?: Record<string, string> | FilterFn): ErrorEntity | undefined;

package/dist/esm/errors.js

@@ -21,12 +21,46 @@ function isErrorBody(body) {
     }
     return true;
 }
+/**
+ * Brands stamped on error instances.
+ *
+ * `Symbol.for()` looks up the cross-realm global symbol registry, so every copy
+ * of this module — CJS or ESM, inlined by a bundler or not — resolves these to
+ * the very same symbols. Since these packages ship parallel CJS and ESM builds
+ * with no guarantee that a consumer ends up with a single copy, identity is
+ * carried by these brands rather than by class identity alone, so `instanceof`
+ * keeps working across duplicated copies.
+ */
+const TIMEOUT_ERROR = Symbol.for('@datocms/rest-client-utils:TimeoutError');
+const API_ERROR = Symbol.for('@datocms/rest-client-utils:ApiError');
 export class TimeoutError extends Error {
+    static [Symbol.hasInstance](value) {
+        if (typeof value !== 'object' ||
+            value === null ||
+            !(TIMEOUT_ERROR in value)) {
+            return false;
+        }
+        // `this` is the constructor `instanceof` was invoked on: when it is a
+        // subclass, defer to a real prototype-chain check so subclasses stay exact.
+        // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+        const invokedOn = this;
+        if (invokedOn !== TimeoutError) {
+            return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+        }
+        return true;
+    }
     constructor(initObject) {
         super('API Error!');
         Object.setPrototypeOf(this, new.target.prototype);
+        Object.defineProperty(this, TIMEOUT_ERROR, {
+            value: true,
+            enumerable: false,
+            writable: false,
+            configurable: false,
+        });
+        this.name = 'TimeoutError';
         if ('captureStackTrace' in Error) {
-            Error.captureStackTrace(this, ApiError);
+            Error.captureStackTrace(this, TimeoutError);
         }
         else {
             this.stack = new Error().stack;
@@ -40,9 +74,29 @@ export class TimeoutError extends Error {
     }
 }
 export class ApiError extends Error {
+    static [Symbol.hasInstance](value) {
+        if (typeof value !== 'object' || value === null || !(API_ERROR in value)) {
+            return false;
+        }
+        // `this` is the constructor `instanceof` was invoked on: when it is a
+        // subclass, defer to a real prototype-chain check so subclasses stay exact.
+        // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+        const invokedOn = this;
+        if (invokedOn !== ApiError) {
+            return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+        }
+        return true;
+    }
     constructor(initObject) {
         super('API Error!');
         Object.setPrototypeOf(this, new.target.prototype);
+        Object.defineProperty(this, API_ERROR, {
+            value: true,
+            enumerable: false,
+            writable: false,
+            configurable: false,
+        });
+        this.name = 'ApiError';
         if ('captureStackTrace' in Error) {
             Error.captureStackTrace(this, ApiError);
         }

package/dist/esm/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/esm/makeCancelablePromise.d.ts

@@ -1,7 +1,16 @@
+/**
+ * See the note on the brands in `errors.ts`: identity is carried by a symbol
+ * from the cross-realm global registry so that `instanceof` keeps working even
+ * when a bundler ends up loading more than one copy of this module.
+ */
+declare const CANCELED_PROMISE_ERROR: unique symbol;
 export declare class CanceledPromiseError extends Error {
+    readonly [CANCELED_PROMISE_ERROR]: true;
+    static [Symbol.hasInstance](value: unknown): value is CanceledPromiseError;
     constructor();
 }
 export interface CancelablePromise<T> extends Promise<T> {
     cancel(): void;
 }
 export declare function makeCancelablePromise<T>(promiseOrAsyncFn: Promise<T> | (() => Promise<T>), onCancel?: () => void): CancelablePromise<T>;
+export {};

package/dist/esm/makeCancelablePromise.js

@@ -1,7 +1,35 @@
+/**
+ * See the note on the brands in `errors.ts`: identity is carried by a symbol
+ * from the cross-realm global registry so that `instanceof` keeps working even
+ * when a bundler ends up loading more than one copy of this module.
+ */
+const CANCELED_PROMISE_ERROR = Symbol.for('@datocms/rest-client-utils:CanceledPromiseError');
 export class CanceledPromiseError extends Error {
+    static [Symbol.hasInstance](value) {
+        if (typeof value !== 'object' ||
+            value === null ||
+            !(CANCELED_PROMISE_ERROR in value)) {
+            return false;
+        }
+        // `this` is the constructor `instanceof` was invoked on: when it is a
+        // subclass, defer to a real prototype-chain check so subclasses stay exact.
+        // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+        const invokedOn = this;
+        if (invokedOn !== CanceledPromiseError) {
+            return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+        }
+        return true;
+    }
     constructor() {
         super('Promise canceled!');
         Object.setPrototypeOf(this, new.target.prototype);
+        Object.defineProperty(this, CANCELED_PROMISE_ERROR, {
+            value: true,
+            enumerable: false,
+            writable: false,
+            configurable: false,
+        });
+        this.name = 'CanceledPromiseError';
     }
 }
 export function makeCancelablePromise(promiseOrAsyncFn, onCancel) {

package/dist/esm/makeCancelablePromise.js.map

@@ -1 +1 @@
-{"version":3,"file":"makeCancelablePromise.js","sourceRoot":"","sources":["../../src/makeCancelablePromise.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C;QACE,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAMD,MAAM,UAAU,qBAAqB,CACnC,gBAAiD,EACjD,QAAqB;IAErB,IAAI,MAAM,GAAwB,IAAI,CAAC;IAEvC,MAAM,UAAU,GAAyB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACvE,MAAM,GAAG,GAAG,EAAE;YACZ,IAAI;gBACF,IAAI,QAAQ,EAAE;oBACZ,QAAQ,EAAE,CAAC;iBACZ;gBACD,MAAM,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;aACpC;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,CAAC,CAAC,CAAC,CAAC;aACX;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GACX,OAAO,gBAAgB,KAAK,UAAU;YACpC,CAAC,CAAC,gBAAgB,EAAE;YACpB,CAAC,CAAC,gBAAgB,CAAC;QAEvB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,EAAE;QACV,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;KAC5B;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"makeCancelablePromise.js","sourceRoot":"","sources":["../../src/makeCancelablePromise.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CACvC,iDAAiD,CAClD,CAAC;AAEF,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAG7C,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAc;QACxC,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,CAAC,CAAC,sBAAsB,IAAI,KAAK,CAAC,EAClC;YACA,OAAO,KAAK,CAAC;SACd;QAED,sEAAsE;QACtE,4EAA4E;QAC5E,iIAAiI;QACjI,MAAM,SAAS,GAAG,IAAwC,CAAC;QAE3D,IAAI,SAAS,KAAK,oBAAoB,EAAE;YACtC,OAAO,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;SACxE;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;QACE,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAElD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,EAAE;YAClD,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAMD,MAAM,UAAU,qBAAqB,CACnC,gBAAiD,EACjD,QAAqB;IAErB,IAAI,MAAM,GAAwB,IAAI,CAAC;IAEvC,MAAM,UAAU,GAAyB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACvE,MAAM,GAAG,GAAG,EAAE;YACZ,IAAI;gBACF,IAAI,QAAQ,EAAE;oBACZ,QAAQ,EAAE,CAAC;iBACZ;gBACD,MAAM,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;aACpC;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,CAAC,CAAC,CAAC,CAAC;aACX;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,GACX,OAAO,gBAAgB,KAAK,UAAU;YACpC,CAAC,CAAC,gBAAgB,EAAE;YACpB,CAAC,CAAC,gBAAgB,CAAC;QAEvB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,EAAE;QACV,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;KAC5B;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/types/__tests__/errors.test.d.ts

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

package/dist/types/errors.d.ts

@@ -21,6 +21,18 @@ export type ApiErrorResponse = {
     headers: Record<string, string>;
     body?: unknown;
 };
+/**
+ * Brands stamped on error instances.
+ *
+ * `Symbol.for()` looks up the cross-realm global symbol registry, so every copy
+ * of this module — CJS or ESM, inlined by a bundler or not — resolves these to
+ * the very same symbols. Since these packages ship parallel CJS and ESM builds
+ * with no guarantee that a consumer ends up with a single copy, identity is
+ * carried by these brands rather than by class identity alone, so `instanceof`
+ * keeps working across duplicated copies.
+ */
+declare const TIMEOUT_ERROR: unique symbol;
+declare const API_ERROR: unique symbol;
 export type TimeoutErrorInitObject = {
     request: ApiErrorRequest;
     preCallStack?: string;
@@ -28,6 +40,8 @@ export type TimeoutErrorInitObject = {
 export declare class TimeoutError extends Error {
     request: ApiErrorRequest;
     preCallStack?: string;
+    readonly [TIMEOUT_ERROR]: true;
+    static [Symbol.hasInstance](value: unknown): value is TimeoutError;
     constructor(initObject: TimeoutErrorInitObject);
 }
 export type ApiErrorInitObject = {
@@ -39,6 +53,8 @@ export declare class ApiError extends Error {
     request: ApiErrorRequest;
     response: ApiErrorResponse;
     preCallStack?: string;
+    readonly [API_ERROR]: true;
+    static [Symbol.hasInstance](value: unknown): value is ApiError;
     constructor(initObject: ApiErrorInitObject);
     get errors(): ErrorEntity[];
     findError(codeOrCodes: string | string[], filterDetails?: Record<string, string> | FilterFn): ErrorEntity | undefined;

package/dist/types/makeCancelablePromise.d.ts

@@ -1,7 +1,16 @@
+/**
+ * See the note on the brands in `errors.ts`: identity is carried by a symbol
+ * from the cross-realm global registry so that `instanceof` keeps working even
+ * when a bundler ends up loading more than one copy of this module.
+ */
+declare const CANCELED_PROMISE_ERROR: unique symbol;
 export declare class CanceledPromiseError extends Error {
+    readonly [CANCELED_PROMISE_ERROR]: true;
+    static [Symbol.hasInstance](value: unknown): value is CanceledPromiseError;
     constructor();
 }
 export interface CancelablePromise<T> extends Promise<T> {
     cancel(): void;
 }
 export declare function makeCancelablePromise<T>(promiseOrAsyncFn: Promise<T> | (() => Promise<T>), onCancel?: () => void): CancelablePromise<T>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datocms/rest-client-utils",
-  "version": "5.4.9",
+  "version": "5.8.0",
   "description": "Utilities for DatoCMS REST API clients",
   "keywords": [
     "datocms",
@@ -12,6 +12,16 @@
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "typings": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./dist/*": "./dist/*",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
   "sideEffects": false,
   "directories": {
     "lib": "dist",
@@ -38,7 +48,7 @@
   "dependencies": {
     "async-scheduler": "^1.4.4"
   },
-  "gitHead": "84f6eadac6b5bfaa8c8646e112041a361c842a46",
+  "gitHead": "6280620a11120a1f612a8114c2cbf879dc245599",
   "devDependencies": {
     "@types/qs": "^6.9.7"
   }

package/src/__tests__/errors.test.ts

@@ -0,0 +1,141 @@
+import { ApiError, TimeoutError } from '../errors';
+import { CanceledPromiseError } from '../makeCancelablePromise';
+
+function buildApiError() {
+  return new ApiError({
+    request: {
+      url: '/items/bad-id',
+      method: 'GET',
+      headers: {},
+      body: undefined,
+    },
+    response: {
+      status: 422,
+      statusText: 'Unprocessable Entity',
+      headers: {},
+      body: {
+        data: [
+          {
+            id: '1',
+            type: 'api_error' as const,
+            attributes: {
+              code: 'INVALID_FIELD',
+              doc_url: 'https://www.datocms.com/docs',
+              details: { field: 'item_id' },
+            },
+          },
+        ],
+      },
+    },
+  });
+}
+
+function buildTimeoutError() {
+  return new TimeoutError({
+    request: { url: '/items', method: 'GET', headers: {}, body: undefined },
+  });
+}
+
+describe('ApiError', () => {
+  it('keeps a correct prototype chain and name', () => {
+    const error = buildApiError();
+
+    expect(error).toBeInstanceOf(ApiError);
+    expect(error).toBeInstanceOf(Error);
+    expect(error.name).toBe('ApiError');
+    expect(error.constructor.name).toBe('ApiError');
+  });
+
+  it('exposes request, response and parsed errors', () => {
+    const error = buildApiError();
+
+    expect(error.response.status).toBe(422);
+    expect(error.request.url).toBe('/items/bad-id');
+    expect(error.errors).toHaveLength(1);
+    expect(error.findError('INVALID_FIELD')).toBeTruthy();
+  });
+
+  // These packages ship parallel CJS and ESM builds, so a bundler can load two
+  // distinct copies of this module. `instanceof` must still work for an error
+  // produced by the other copy.
+  it('recognizes an instance coming from a duplicate copy of the module', () => {
+    const fromOtherCopy = Object.assign(new Error('API Error!'), {
+      name: 'ApiError',
+      [Symbol.for('@datocms/rest-client-utils:ApiError')]: true,
+    });
+
+    expect(fromOtherCopy).toBeInstanceOf(ApiError);
+  });
+
+  it('does not recognize unrelated values', () => {
+    expect(new Error('nope')).not.toBeInstanceOf(ApiError);
+    expect({}).not.toBeInstanceOf(ApiError);
+    expect(null).not.toBeInstanceOf(ApiError);
+    expect(buildTimeoutError()).not.toBeInstanceOf(ApiError);
+    // merely borrowing the name is not enough
+    expect(
+      Object.assign(new Error('impostor'), { name: 'ApiError' }),
+    ).not.toBeInstanceOf(ApiError);
+  });
+
+  it('keeps subclass checks exact', () => {
+    class SubclassedApiError extends ApiError {}
+
+    const parent = buildApiError();
+    const child = new SubclassedApiError({
+      request: { url: '/items', method: 'GET', headers: {}, body: undefined },
+      response: { status: 500, statusText: 'Error', headers: {}, body: {} },
+    });
+
+    expect(child).toBeInstanceOf(SubclassedApiError);
+    expect(child).toBeInstanceOf(ApiError);
+    expect(parent).not.toBeInstanceOf(SubclassedApiError);
+  });
+});
+
+describe('TimeoutError', () => {
+  it('keeps a correct prototype chain and name', () => {
+    const error = buildTimeoutError();
+
+    expect(error).toBeInstanceOf(TimeoutError);
+    expect(error).toBeInstanceOf(Error);
+    expect(error.name).toBe('TimeoutError');
+  });
+
+  it('recognizes an instance coming from a duplicate copy of the module', () => {
+    const fromOtherCopy = Object.assign(new Error('API Error!'), {
+      name: 'TimeoutError',
+      [Symbol.for('@datocms/rest-client-utils:TimeoutError')]: true,
+    });
+
+    expect(fromOtherCopy).toBeInstanceOf(TimeoutError);
+  });
+
+  it('is not confused with an ApiError', () => {
+    expect(buildApiError()).not.toBeInstanceOf(TimeoutError);
+  });
+});
+
+describe('CanceledPromiseError', () => {
+  it('keeps a correct prototype chain and name', () => {
+    const error = new CanceledPromiseError();
+
+    expect(error).toBeInstanceOf(CanceledPromiseError);
+    expect(error).toBeInstanceOf(Error);
+    expect(error.name).toBe('CanceledPromiseError');
+  });
+
+  it('recognizes an instance coming from a duplicate copy of the module', () => {
+    const fromOtherCopy = Object.assign(new Error('Promise canceled!'), {
+      name: 'CanceledPromiseError',
+      [Symbol.for('@datocms/rest-client-utils:CanceledPromiseError')]: true,
+    });
+
+    expect(fromOtherCopy).toBeInstanceOf(CanceledPromiseError);
+  });
+
+  it('is not confused with other error types', () => {
+    expect(buildApiError()).not.toBeInstanceOf(CanceledPromiseError);
+    expect(new Error('nope')).not.toBeInstanceOf(CanceledPromiseError);
+  });
+});

package/src/errors.ts

@@ -59,6 +59,19 @@ export type ApiErrorResponse = {
   body?: unknown;
 };
 
+/**
+ * Brands stamped on error instances.
+ *
+ * `Symbol.for()` looks up the cross-realm global symbol registry, so every copy
+ * of this module — CJS or ESM, inlined by a bundler or not — resolves these to
+ * the very same symbols. Since these packages ship parallel CJS and ESM builds
+ * with no guarantee that a consumer ends up with a single copy, identity is
+ * carried by these brands rather than by class identity alone, so `instanceof`
+ * keeps working across duplicated copies.
+ */
+const TIMEOUT_ERROR = Symbol.for('@datocms/rest-client-utils:TimeoutError');
+const API_ERROR = Symbol.for('@datocms/rest-client-utils:ApiError');
+
 export type TimeoutErrorInitObject = {
   request: ApiErrorRequest;
   preCallStack?: string;
@@ -68,12 +81,44 @@ export class TimeoutError extends Error {
   request: ApiErrorRequest;
   preCallStack?: string;
 
+  declare readonly [TIMEOUT_ERROR]: true;
+
+  static [Symbol.hasInstance](value: unknown): value is TimeoutError {
+    if (
+      typeof value !== 'object' ||
+      value === null ||
+      !(TIMEOUT_ERROR in value)
+    ) {
+      return false;
+    }
+
+    // `this` is the constructor `instanceof` was invoked on: when it is a
+    // subclass, defer to a real prototype-chain check so subclasses stay exact.
+    // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+    const invokedOn = this as unknown as { prototype: object };
+
+    if (invokedOn !== TimeoutError) {
+      return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+    }
+
+    return true;
+  }
+
   constructor(initObject: TimeoutErrorInitObject) {
     super('API Error!');
     Object.setPrototypeOf(this, new.target.prototype);
 
+    Object.defineProperty(this, TIMEOUT_ERROR, {
+      value: true,
+      enumerable: false,
+      writable: false,
+      configurable: false,
+    });
+
+    this.name = 'TimeoutError';
+
     if ('captureStackTrace' in Error) {
-      Error.captureStackTrace(this, ApiError);
+      Error.captureStackTrace(this, TimeoutError);
     } else {
       this.stack = new (Error as any)().stack;
     }
@@ -100,10 +145,38 @@ export class ApiError extends Error {
   response: ApiErrorResponse;
   preCallStack?: string;
 
+  declare readonly [API_ERROR]: true;
+
+  static [Symbol.hasInstance](value: unknown): value is ApiError {
+    if (typeof value !== 'object' || value === null || !(API_ERROR in value)) {
+      return false;
+    }
+
+    // `this` is the constructor `instanceof` was invoked on: when it is a
+    // subclass, defer to a real prototype-chain check so subclasses stay exact.
+    // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+    const invokedOn = this as unknown as { prototype: object };
+
+    if (invokedOn !== ApiError) {
+      return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+    }
+
+    return true;
+  }
+
   constructor(initObject: ApiErrorInitObject) {
     super('API Error!');
     Object.setPrototypeOf(this, new.target.prototype);
 
+    Object.defineProperty(this, API_ERROR, {
+      value: true,
+      enumerable: false,
+      writable: false,
+      configurable: false,
+    });
+
+    this.name = 'ApiError';
+
     if ('captureStackTrace' in Error) {
       Error.captureStackTrace(this, ApiError);
     } else {

package/src/makeCancelablePromise.ts

@@ -1,7 +1,48 @@
+/**
+ * See the note on the brands in `errors.ts`: identity is carried by a symbol
+ * from the cross-realm global registry so that `instanceof` keeps working even
+ * when a bundler ends up loading more than one copy of this module.
+ */
+const CANCELED_PROMISE_ERROR = Symbol.for(
+  '@datocms/rest-client-utils:CanceledPromiseError',
+);
+
 export class CanceledPromiseError extends Error {
+  declare readonly [CANCELED_PROMISE_ERROR]: true;
+
+  static [Symbol.hasInstance](value: unknown): value is CanceledPromiseError {
+    if (
+      typeof value !== 'object' ||
+      value === null ||
+      !(CANCELED_PROMISE_ERROR in value)
+    ) {
+      return false;
+    }
+
+    // `this` is the constructor `instanceof` was invoked on: when it is a
+    // subclass, defer to a real prototype-chain check so subclasses stay exact.
+    // biome-ignore lint/complexity/noThisInStatic: dynamic `this` is required here; hardcoding the class would break subclass checks
+    const invokedOn = this as unknown as { prototype: object };
+
+    if (invokedOn !== CanceledPromiseError) {
+      return Object.prototype.isPrototypeOf.call(invokedOn.prototype, value);
+    }
+
+    return true;
+  }
+
   constructor() {
     super('Promise canceled!');
     Object.setPrototypeOf(this, new.target.prototype);
+
+    Object.defineProperty(this, CANCELED_PROMISE_ERROR, {
+      value: true,
+      enumerable: false,
+      writable: false,
+      configurable: false,
+    });
+
+    this.name = 'CanceledPromiseError';
   }
 }