@scaleway/sdk-client 2.2.0 → 2.2.2

package/dist/scw/errors/standard/__tests__/index.test.js

@@ -0,0 +1,329 @@
+import { InvalidArgumentsError } from "../invalid-arguments-error.js";
+import { QuotasExceededError } from "../quotas-exceeded-error.js";
+import { ResourceNotFoundError } from "../resource-not-found-error.js";
+import { AlreadyExistsError } from "../already-exists-error.js";
+import { DeniedAuthenticationError } from "../denied-authentication-error.js";
+import { OutOfStockError } from "../out-of-stock-error.js";
+import { PermissionsDeniedError } from "../permissions-denied-error.js";
+import { PreconditionFailedError } from "../precondition-failed-error.js";
+import { ResourceExpiredError } from "../resource-expired-error.js";
+import { ResourceLockedError } from "../resource-locked-error.js";
+import { TooManyRequestsError } from "../too-many-requests-error.js";
+import { TransientStateError } from "../transient-state-error.js";
+import { parseScalewayError } from "../../error-parser.js";
+import { describe, expect, it } from "vitest";
+//#region src/scw/errors/standard/__tests__/index.test.ts
+describe("Empty input", () => {
+	it(`uses the http status`, () => {
+		expect(parseScalewayError(404, {}).message).toBe("http error 404");
+	});
+});
+describe("Unrecognied error", () => {
+	it(`parses message`, () => {
+		expect(parseScalewayError(409, {
+			message: "Group is in use. You cannot delete it.",
+			type: "conflict"
+		}).message).toBe("http error 409: Group is in use. You cannot delete it.");
+	});
+});
+describe("InvalidArgumentsError", () => {
+	const body = {
+		details: [
+			{
+				argument_name: "size",
+				help_message: "must be lower than 50GB",
+				reason: "constraint"
+			},
+			{
+				argument_name: "id",
+				reason: "required"
+			},
+			{
+				argument_name: "name",
+				reason: "unknown"
+			},
+			{
+				argument_name: "size",
+				reason: "format"
+			},
+			{
+				argument_name: 42,
+				reason: "format"
+			}
+		],
+		type: "invalid_arguments"
+	};
+	it(`parses a valid input`, () => {
+		expect(parseScalewayError(400, body).toString()).toBe("InvalidArgumentsError: invalid argument(s): size does not respect constraint, must be lower than 50GB; id is required; name is invalid for unexpected reason; size is wrongly formatted");
+	});
+	it(`doesn't parse invalid details object`, () => {
+		expect(InvalidArgumentsError.fromJSON(400, {
+			...body,
+			details: {}
+		})).toBeNull();
+	});
+});
+describe("QuotasExceededError", () => {
+	const body = {
+		details: [
+			{
+				current: 10,
+				project_id: "b7a1cf21-1e90-464c-a9f6-375c4d1f4b64",
+				quota: 10,
+				resource: "instance_volume"
+			},
+			{
+				current: 80,
+				organization_id: "72dd6741-d748-42e7-ba65-acd07447d3e9",
+				quota: 100,
+				resource: "instance_volumes_l_ssd_total_gb"
+			},
+			{
+				current: 70,
+				quota: 100,
+				resource: "instance_volumes_l_ssd_total_gb"
+			},
+			{
+				current: "70",
+				quota: "100",
+				resource: "invalid_input"
+			}
+		],
+		type: "quotas_exceeded"
+	};
+	expect(parseScalewayError(403, body).toString()).toContain("quota(s) exceeded: Quotas reached: You have reached the maximum number of instance_volume authorized by your Organization. Access the quotas page from your Organization dashboard to manage quotas. for project 'b7a1cf21-1e90-464c-a9f6-375c4d1f4b64'; Quotas reached: You have reached the maximum number of instance_volumes_l_ssd_total_gb authorized by your Organization. Access the quotas page from your Organization dashboard to manage quotas. for organization '72dd6741-d748-42e7-ba65-acd07447d3e9'; Quotas reached: You have reached the maximum number of instance_volumes_l_ssd_total_gb authorized by your Organization. Access the quotas page from your Organization dashboard to manage quotas.");
+	it(`doesn't parse invalid details object`, () => {
+		expect(QuotasExceededError.fromJSON(403, {
+			...body,
+			details: {}
+		})).toBeNull();
+	});
+});
+describe("ResourceNotFoundError", () => {
+	const body = {
+		resource: "instance_server",
+		resource_id: "f974feac-abae-4365-b988-8ec7d1cec10d",
+		type: "not_found"
+	};
+	it(`parses a valid input`, () => {
+		expect(parseScalewayError(404, body).toString()).toBe("ResourceNotFoundError: resource instance_server with ID f974feac-abae-4365-b988-8ec7d1cec10d is not found");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(ResourceNotFoundError.fromJSON(404, {
+			...body,
+			resource_id: 0
+		})).toBeNull();
+	});
+});
+describe("ResourceLockedError", () => {
+	const body = {
+		resource: "instance_server",
+		resource_id: "f974feac-abae-4365-b988-8ec7d1cec10d",
+		type: "locked"
+	};
+	it(`parses a valid input`, () => {
+		expect(parseScalewayError(423, body).toString()).toBe("ResourceLockedError: resource instance_server with ID f974feac-abae-4365-b988-8ec7d1cec10d is locked");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(ResourceLockedError.fromJSON(423, {
+			...body,
+			resource_id: 0
+		})).toBeNull();
+	});
+});
+describe("OutOfStockError", () => {
+	const body = {
+		resource: "kubernetes_cluster",
+		type: "out_of_stock"
+	};
+	it(`parses a valid input`, () => {
+		expect(parseScalewayError(503, body).toString()).toBe("OutOfStockError: resource kubernetes_cluster is out of stock");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(OutOfStockError.fromJSON(503, {
+			...body,
+			resource: 0
+		})).toBeNull();
+	});
+});
+describe("ResourceExpiredError", () => {
+	const body = {
+		expired_since: "2017-01-15T01:30:15.01Z",
+		resource: "account_token",
+		resource_id: "SCWQPD3J3PTKJFJKFQJG",
+		type: "expired"
+	};
+	it(`parses a valid input`, () => {
+		expect(parseScalewayError(410, body).toString()).toBe("ResourceExpiredError: resource account_token with ID SCWQPD3J3PTKJFJKFQJG expired since 2017-01-15T01:30:15.010Z");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(ResourceExpiredError.fromJSON(410, {
+			...body,
+			expired_since: 0
+		})).toBeNull();
+	});
+});
+describe("PermissionsDeniedError", () => {
+	const body = {
+		details: [{
+			action: "read",
+			resource: "instance_volume"
+		}, {
+			action: "read",
+			wrong_key: "instance_volume"
+		}],
+		type: "permissions_denied"
+	};
+	it(`parses a valid input`, () => {
+		expect(parseScalewayError(503, body).toString()).toBe("PermissionsDeniedError: insufficient permissions: read instance_volume");
+	});
+	it(`doesn't parse invalid details object`, () => {
+		expect(PermissionsDeniedError.fromJSON(503, {
+			...body,
+			details: {}
+		})).toBeNull();
+	});
+});
+describe("DeniedAuthenticationError", () => {
+	it(`parses a body for invalid argument `, () => {
+		expect(parseScalewayError(401, {
+			method: "jwt",
+			reason: "invalid_argument",
+			type: "denied_authentication"
+		}).toString()).toBe("DeniedAuthenticationError: denied authentication: invalid jwt format or empty value");
+	});
+	it(`parses a body for not found method`, () => {
+		expect(parseScalewayError(401, {
+			method: "api_key",
+			reason: "not_found",
+			type: "denied_authentication"
+		}).toString()).toBe("DeniedAuthenticationError: denied authentication: api_key does not exist");
+	});
+	it(`parses a body for expired method`, () => {
+		expect(parseScalewayError(401, {
+			method: "jwt",
+			reason: "expired",
+			type: "denied_authentication"
+		}).toString()).toBe("DeniedAuthenticationError: denied authentication: jwt is expired");
+	});
+	it(`parses a body for unknown reason`, () => {
+		expect(parseScalewayError(401, {
+			method: "unknown_method",
+			reason: "unknown_reason",
+			type: "denied_authentication"
+		}).toString()).toBe("DeniedAuthenticationError: denied authentication: unknown reason for unknown_method");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(DeniedAuthenticationError.fromJSON(401, { method: "jwt" })).toBeNull();
+	});
+});
+describe("PreconditionFailedError", () => {
+	it(`parses a valid input for precondition unknown_precondition`, () => {
+		expect(parseScalewayError(412, {
+			help_message: "",
+			precondition: "unknown_precondition",
+			type: "precondition_failed"
+		}).toString()).toBe("PreconditionFailedError: precondition failed: unknown_precondition");
+	});
+	it(`parses a valid input for precondition precondition_failed`, () => {
+		expect(parseScalewayError(412, {
+			help_message: "All servers must be removed from the private network before deleting it.",
+			precondition: "resource_still_in_use",
+			type: "precondition_failed"
+		}).toString()).toBe("PreconditionFailedError: precondition failed: resource_still_in_use, All servers must be removed from the private network before deleting it.");
+	});
+	it(`parses a valid input for precondition attribute_must_be_set`, () => {
+		expect(parseScalewayError(412, {
+			help_message: "",
+			precondition: "attribute_must_be_set",
+			type: "precondition_failed"
+		}).toString()).toBe("PreconditionFailedError: precondition failed: attribute_must_be_set");
+	});
+	it(`parses a valid input for unknown precondition`, () => {
+		expect(parseScalewayError(412, {
+			help_message: "",
+			precondition: "wrong_precondition_key",
+			type: "precondition_failed"
+		}).toString()).toBe("PreconditionFailedError: precondition failed: wrong_precondition_key");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(PreconditionFailedError.fromJSON(412, {
+			precondition: 0,
+			type: "precondition_failed"
+		})).toBeNull();
+	});
+});
+describe("TransientStateError", () => {
+	const body = {
+		current_state: "starting",
+		resource: "instance_server",
+		resource_id: "f974feac-abae-4365-b988-8ec7d1cec10d",
+		type: "transient_state"
+	};
+	it(`parses a valid input`, () => {
+		expect(parseScalewayError(409, body).toString()).toBe("TransientStateError: resource instance_server with ID f974feac-abae-4365-b988-8ec7d1cec10d is in a transient state: starting");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(TransientStateError.fromJSON(409, {
+			...body,
+			resource_id: 0
+		})).toBeNull();
+	});
+});
+describe("AlreadyExistsError", () => {
+	const body = {
+		help_message: "The customer level NAME already exists",
+		resource: "NAME",
+		resource_id: "unknown",
+		type: "already_exists"
+	};
+	it(`parses a valid input`, () => {
+		expect(parseScalewayError(409, body).toString()).toBe("AlreadyExistsError: resource NAME with ID unknown already exists: The customer level NAME already exists");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(AlreadyExistsError.fromJSON(409, {
+			...body,
+			resource_id: 0
+		})).toBeNull();
+	});
+});
+describe("TooManyRequestsError", () => {
+	it(`parses a valid input with limit and reset_seconds`, () => {
+		expect(parseScalewayError(429, {
+			help_message: "You are limited to 3 requests per hour to reset your password",
+			limit: {
+				quota: 3,
+				window_seconds: 60
+			},
+			reset_seconds: 13,
+			type: "too_many_requests"
+		}).toString()).toBe("TooManyRequestsError: too many requests (quota is 3 for 60s, resets in 13s): You are limited to 3 requests per hour to reset your password");
+	});
+	it(`parses a valid input with limit but no window`, () => {
+		expect(parseScalewayError(429, {
+			help_message: "You are limited to 5 requests per day",
+			limit: { quota: 5 },
+			type: "too_many_requests"
+		}).toString()).toBe("TooManyRequestsError: too many requests (quota is 5): You are limited to 5 requests per day");
+	});
+	it(`parses a valid input with empty help message`, () => {
+		expect(parseScalewayError(429, {
+			help_message: "",
+			type: "too_many_requests"
+		}).toString()).toBe("TooManyRequestsError: too many requests");
+	});
+	it(`parses a valid input with only reset_at`, () => {
+		expect(parseScalewayError(429, {
+			help_message: "",
+			reset_at: "2022-05-23T15:00:00.01Z",
+			type: "too_many_requests"
+		}).toString()).toBe("TooManyRequestsError: too many requests (resets at 2022-05-23T15:00:00.010Z)");
+	});
+	it(`doesn't parse invalid input`, () => {
+		expect(TooManyRequestsError.fromJSON(429, {
+			reset_at: "2022-05-23T15:00:00.01Z",
+			type: "too_many_requests"
+		})).toBeNull();
+	});
+});
+//#endregion

package/dist/scw/errors/standard/already-exists-error.js

@@ -1,4 +1,5 @@
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/already-exists-error.ts
 /**
 * AlreadyExists error is used when a resource already exists.
 *
@@ -19,4 +20,5 @@ var AlreadyExistsError = class AlreadyExistsError extends ScalewayError {
 		return new AlreadyExistsError(status, obj, obj.resource, obj.resource_id, obj.help_message);
 	}
 };
+//#endregion
 export { AlreadyExistsError };

package/dist/scw/errors/standard/denied-authentication-error.js

@@ -1,4 +1,5 @@
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/denied-authentication-error.ts
 /**
 * Build the default message for {@link DeniedAuthenticationError}.
 *
@@ -43,4 +44,5 @@ var DeniedAuthenticationError = class DeniedAuthenticationError extends Scaleway
 		return new DeniedAuthenticationError(status, obj, obj.method, obj.reason);
 	}
 };
+//#endregion
 export { DeniedAuthenticationError };

package/dist/scw/errors/standard/index.js

@@ -12,6 +12,7 @@ import { ResourceExpiredError } from "./resource-expired-error.js";
 import { ResourceLockedError } from "./resource-locked-error.js";
 import { TooManyRequestsError } from "./too-many-requests-error.js";
 import { TransientStateError } from "./transient-state-error.js";
+//#region src/scw/errors/standard/index.ts
 var standard_exports = /* @__PURE__ */ __exportAll({
 	AlreadyExistsError: () => AlreadyExistsError,
 	DeniedAuthenticationError: () => DeniedAuthenticationError,
@@ -27,4 +28,5 @@ var standard_exports = /* @__PURE__ */ __exportAll({
 	TooManyRequestsError: () => TooManyRequestsError,
 	TransientStateError: () => TransientStateError
 });
-export { standard_exports };
+//#endregion
+export { AlreadyExistsError, DeniedAuthenticationError, InvalidArgumentsError, OutOfStockError, PermissionsDeniedError, PreconditionFailedError, QuotasExceededError, ResourceExpiredError, ResourceLockedError, ResourceNotFoundError, ScalewayError, TooManyRequestsError, TransientStateError, standard_exports };

package/dist/scw/errors/standard/invalid-arguments-error.js

@@ -1,5 +1,6 @@
 import { isJSONObject } from "../../../helpers/json.js";
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/invalid-arguments-error.ts
 /**
 * Build the default message for {@link InvalidArgumentsError}.
 *
@@ -52,4 +53,5 @@ var InvalidArgumentsError = class InvalidArgumentsError extends ScalewayError {
 		}) : list, []));
 	}
 };
+//#endregion
 export { InvalidArgumentsError };

package/dist/scw/errors/standard/out-of-stock-error.js

@@ -1,4 +1,5 @@
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/out-of-stock-error.ts
 /**
 * OutOfStock error happens when stocks are empty for the resource.
 *
@@ -17,4 +18,5 @@ var OutOfStockError = class OutOfStockError extends ScalewayError {
 		return new OutOfStockError(status, obj, obj.resource);
 	}
 };
+//#endregion
 export { OutOfStockError };

package/dist/scw/errors/standard/permissions-denied-error.js

@@ -1,5 +1,6 @@
 import { isJSONObject } from "../../../helpers/json.js";
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/permissions-denied-error.ts
 /**
 * Build the default message for {@link PermissionsDeniedError}.
 *
@@ -30,4 +31,5 @@ var PermissionsDeniedError = class PermissionsDeniedError extends ScalewayError
 		}) : list, []));
 	}
 };
+//#endregion
 export { PermissionsDeniedError };

package/dist/scw/errors/standard/precondition-failed-error.js

@@ -1,4 +1,5 @@
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/precondition-failed-error.ts
 /**
 * Build the default message for {@link PreconditionFailedError}.
 *
@@ -32,4 +33,5 @@ var PreconditionFailedError = class PreconditionFailedError extends ScalewayErro
 		return new PreconditionFailedError(status, obj, obj.precondition, obj.help_message);
 	}
 };
+//#endregion
 export { PreconditionFailedError };

package/dist/scw/errors/standard/quotas-exceeded-error.js

@@ -1,5 +1,6 @@
 import { isJSONObject } from "../../../helpers/json.js";
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/quotas-exceeded-error.ts
 /**
 * Build the default message for {@link QuotasExceededError}.
 *
@@ -45,4 +46,5 @@ var QuotasExceededError = class QuotasExceededError extends ScalewayError {
 		}) : list, []));
 	}
 };
+//#endregion
 export { QuotasExceededError };

package/dist/scw/errors/standard/resource-expired-error.js

@@ -1,4 +1,5 @@
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/resource-expired-error.ts
 /**
 * ResourceExpired error happens when trying to access a resource that has expired.
 *
@@ -19,4 +20,5 @@ var ResourceExpiredError = class ResourceExpiredError extends ScalewayError {
 		return new ResourceExpiredError(status, obj, obj.resource, obj.resource_id, new Date(obj.expired_since));
 	}
 };
+//#endregion
 export { ResourceExpiredError };

package/dist/scw/errors/standard/resource-locked-error.js

@@ -1,4 +1,5 @@
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/resource-locked-error.ts
 /**
 * ResourceLocked error happens when a resource is locked by trust and safety.
 *
@@ -18,4 +19,5 @@ var ResourceLockedError = class ResourceLockedError extends ScalewayError {
 		return new ResourceLockedError(status, obj, obj.resource, obj.resource_id);
 	}
 };
+//#endregion
 export { ResourceLockedError };

package/dist/scw/errors/standard/resource-not-found-error.js

@@ -1,4 +1,5 @@
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/resource-not-found-error.ts
 /**
 * ResourceNotFound error happens when getting a resource that does not exist anymore.
 *
@@ -18,4 +19,5 @@ var ResourceNotFoundError = class ResourceNotFoundError extends ScalewayError {
 		return new ResourceNotFoundError(status, obj, obj.resource, obj.resource_id);
 	}
 };
+//#endregion
 export { ResourceNotFoundError };

package/dist/scw/errors/standard/too-many-requests-error.js

@@ -1,5 +1,6 @@
 import { isJSONObject } from "../../../helpers/json.js";
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/too-many-requests-error.ts
 /**
 * Build the default message for {@link TooManyRequestsError}.
 *
@@ -42,4 +43,5 @@ var TooManyRequestsError = class TooManyRequestsError extends ScalewayError {
 		return new TooManyRequestsError(status, obj, obj.help_message, limit, typeof obj.reset_seconds === "number" ? obj.reset_seconds : void 0, typeof obj.reset_at === "string" ? new Date(obj.reset_at) : void 0);
 	}
 };
+//#endregion
 export { TooManyRequestsError };

package/dist/scw/errors/standard/transient-state-error.js

@@ -1,4 +1,5 @@
 import { ScalewayError } from "../scw-error.js";
+//#region src/scw/errors/standard/transient-state-error.ts
 /**
 * TransientState error happens when trying to perform an action on a resource in a transient state.
 *
@@ -19,4 +20,5 @@ var TransientStateError = class TransientStateError extends ScalewayError {
 		return new TransientStateError(status, obj, obj.resource, obj.resource_id, obj.current_state);
 	}
 };
+//#endregion
 export { TransientStateError };

package/dist/scw/errors/types.js

@@ -1,4 +1,5 @@
 import { isJSONObject } from "../../helpers/json.js";
+//#region src/scw/errors/types.ts
 /**
 * Verifies the object is a record of string to string[].
 *
@@ -7,9 +8,10 @@ import { isJSONObject } from "../../helpers/json.js";
 *
 * @internal
 */
-const isRecordOfStringArray = (obj) => {
+var isRecordOfStringArray = (obj) => {
 	if (!isJSONObject(obj)) return false;
 	for (const elt of Object.values(obj)) if (!Array.isArray(elt) || Object.values(elt).find((x) => typeof x !== "string") !== void 0) return false;
 	return true;
 };
+//#endregion
 export { isRecordOfStringArray };

package/dist/scw/fetch/__tests__/build-fetcher.test.js

@@ -0,0 +1,114 @@
+import { isBrowser } from "../../../helpers/is-browser.js";
+import { addHeaderInterceptor } from "../../../internal/interceptors/helpers.js";
+import { buildFetcher, buildRequest } from "../build-fetcher.js";
+import { afterAll, describe, expect, it, vi } from "vitest";
+//#region src/scw/fetch/__tests__/build-fetcher.test.ts
+var DEFAULT_SETTINGS = {
+	apiURL: "https://api.scaleway.com",
+	defaultRegion: "fr-par",
+	defaultZone: "fr-par-1",
+	httpClient: global.fetch,
+	interceptors: [],
+	requestInterceptors: [],
+	responseInterceptors: [],
+	userAgent: "scaleway-sdk-js/v1.0.0"
+};
+var SCW_POST_REQUEST = {
+	method: "POST",
+	path: "/undefined"
+};
+describe(`buildRequest`, () => {
+	it(`has the specified method & url`, () => {
+		const fReq = buildRequest(SCW_POST_REQUEST, DEFAULT_SETTINGS);
+		expect(fReq.method).toBe(SCW_POST_REQUEST.method);
+		expect(fReq.url).toBe(`${DEFAULT_SETTINGS.apiURL}${SCW_POST_REQUEST.path}`);
+	});
+	it(`has the default header "Accept: 'application/json'"`, () => {
+		expect(buildRequest(SCW_POST_REQUEST, DEFAULT_SETTINGS).headers.get("accept")).toBe(`application/json`);
+	});
+	if (!isBrowser()) it(`has the default header "User-Agent: 'scaleway-sdk-js/v1.0.0'"`, () => {
+		expect(buildRequest(SCW_POST_REQUEST, DEFAULT_SETTINGS).headers.get("User-Agent")).toBe(DEFAULT_SETTINGS.userAgent);
+	});
+	else it(`has NOT the default header "User-Agent: 'scaleway-sdk-js/v1.0.0'"`, () => {
+		expect(buildRequest(SCW_POST_REQUEST, DEFAULT_SETTINGS).headers.get("User-Agent")).toBeNull();
+	});
+	it(`has the custom headers`, () => {
+		const mReq = {
+			...SCW_POST_REQUEST,
+			headers: { randomName: "random-value" }
+		};
+		expect(buildRequest(mReq, DEFAULT_SETTINGS).headers.get("randomName")).toBe(mReq.headers?.randomName);
+	});
+	it("has the url params", () => {
+		expect(buildRequest({
+			...SCW_POST_REQUEST,
+			urlParams: new URLSearchParams([["param1", "value1"], ["param2", "value2"]])
+		}, DEFAULT_SETTINGS).url).toBe("https://api.scaleway.com/undefined?param1=value1&param2=value2");
+	});
+});
+describe(`buildFetcher (mock)`, () => {
+	afterAll(() => {
+		vi.restoreAllMocks();
+	});
+	vi.spyOn(global, "fetch");
+	const mockedFetch = vi.mocked(fetch);
+	const fetcher = buildFetcher(DEFAULT_SETTINGS, global.fetch);
+	it(`gets a response without error for a simple request with unmarshaller`, async () => {
+		mockedFetch.mockResolvedValue(new Response(JSON.stringify({}), { headers: { "Content-Type": "application/json" } }));
+		return expect(fetcher({
+			method: "POST",
+			path: "/undefined"
+		}, () => "dummy-output")).resolves.toStrictEqual("dummy-output");
+	});
+	it("gets modified response", () => {
+		mockedFetch.mockResolvedValue(new Response(JSON.stringify({}), { headers: { "Content-Type": "application/json" } }));
+		return expect(buildFetcher({
+			...DEFAULT_SETTINGS,
+			interceptors: [{ response: () => new Response(JSON.stringify(42)) }]
+		}, global.fetch)({
+			method: "POST",
+			path: "/undefined"
+		})).resolves.toStrictEqual("42");
+	});
+	it(`gets a response without error for a simple request without unmarshaller`, async () => {
+		mockedFetch.mockResolvedValue(new Response(JSON.stringify({ any_parameter: "any-value" }), { headers: { "Content-Type": "application/json" } }));
+		return expect(fetcher({
+			method: "POST",
+			path: "/undefined"
+		})).resolves.toMatchObject({ any_parameter: "any-value" });
+	});
+	it("gets a response with response error interceptor despite the error", () => {
+		mockedFetch.mockRejectedValue(/* @__PURE__ */ new TypeError(""));
+		return expect(buildFetcher({
+			...DEFAULT_SETTINGS,
+			interceptors: [{ responseError: () => Promise.resolve(42) }]
+		}, global.fetch)({
+			method: "GET",
+			path: "/will-trigger-an-error"
+		})).resolves.toBe(42);
+	});
+	it("gets the unmarshalled value of what responseError returns", () => {
+		mockedFetch.mockRejectedValue(/* @__PURE__ */ new TypeError(""));
+		return expect(buildFetcher({
+			...DEFAULT_SETTINGS,
+			interceptors: [{ responseError: () => Promise.resolve(42) }]
+		}, global.fetch)({
+			method: "GET",
+			path: "/will-trigger-an-error"
+		}, (data) => `${typeof data === "number" ? data : ""}-dummy-output`)).resolves.toBe("42-dummy-output");
+	});
+	it("gets modified request in response error", () => {
+		mockedFetch.mockRejectedValue(/* @__PURE__ */ new TypeError(""));
+		return expect(buildFetcher({
+			...DEFAULT_SETTINGS,
+			interceptors: [{
+				request: addHeaderInterceptor("random-header", "42"),
+				responseError: ({ request }) => request.headers.get("random-header")
+			}]
+		}, global.fetch)({
+			method: "GET",
+			path: "/will-trigger-an-error"
+		})).resolves.toBe("42");
+	});
+});
+//#endregion

package/dist/scw/fetch/__tests__/http-dumper.test.js

@@ -0,0 +1,45 @@
+import { isBrowser } from "../../../helpers/is-browser.js";
+import { dumpRequest, dumpResponse } from "../http-dumper.js";
+import { buildRequest } from "../build-fetcher.js";
+import { describe, expect, it } from "vitest";
+//#region src/scw/fetch/__tests__/http-dumper.test.ts
+var DEFAULT_SETTINGS = {
+	apiURL: "https://api.scaleway.com",
+	defaultRegion: "fr-par",
+	defaultZone: "fr-par-1",
+	httpClient: fetch,
+	interceptors: [],
+	requestInterceptors: [],
+	responseInterceptors: [],
+	userAgent: "scaleway-sdk-js/v1.0.0"
+};
+describe(`dumpRequest`, () => {
+	it(`returns a readable string`, () => {
+		const userAgentHeader = !isBrowser() ? `User-Agent: scaleway-sdk-js/v1.0.0\r\n` : "";
+		return expect(dumpRequest(buildRequest({
+			body: JSON.stringify({ myProp: "random-value" }),
+			method: "POST",
+			path: "/random/path"
+		}, DEFAULT_SETTINGS))).resolves.toBe(`POST: https://api.scaleway.com/random/path\r\nAccept: application/json\r\nContent-Type: text/plain;charset=UTF-8\r\n${userAgentHeader}{"myProp":"random-value"}`);
+	});
+});
+var convertObjToBuffer = (obj) => Buffer.from(JSON.stringify(obj));
+var makeFetchResponse = (value, contentType, status) => new Response(new Uint8Array(convertObjToBuffer(value)), {
+	headers: { "Content-Type": contentType },
+	status
+});
+describe("dumpResponse", () => {
+	it("returns a readable string for ok response", async () => {
+		const input = { randomKey: 42 };
+		const res = makeFetchResponse(input, "application/json", 200);
+		const expectedDump = `HTTP 200 OK\r\nContent-Type: application/json\r\n${JSON.stringify(input)}`;
+		return expect(dumpResponse(res)).resolves.toBe(expectedDump);
+	});
+	it("returns a readable string for nok response", async () => {
+		const input = "Raw error message";
+		const res = makeFetchResponse(input, "text/plain", 400);
+		const expectedDump = `HTTP 400 NOK\r\nContent-Type: text/plain\r\n${JSON.stringify(input)}`;
+		return expect(dumpResponse(res)).resolves.toBe(expectedDump);
+	});
+});
+//#endregion