/*
This file is part of GNU Taler
(C) 2022 Taler Systems S.A.
GNU Taler is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation; either version 3, or (at your option) any later version.
GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
GNU Taler; see the file COPYING. If not, see
*/
/**
* Imports.
*/
import {
Duration,
RequestThrottler,
TalerError,
TalerErrorCode,
} from "@gnu-taler/taler-util";
import {
DEFAULT_REQUEST_TIMEOUT_MS,
Headers,
HttpLibArgs,
HttpRequestLibrary,
HttpRequestOptions,
HttpResponse,
encodeBody,
getDefaultHeaders,
} from "@gnu-taler/taler-util/http";
/**
* An implementation of the [[HttpRequestLibrary]] using the
* browser's XMLHttpRequest.
*/
export class BrowserFetchHttpLib implements HttpRequestLibrary {
private throttle = new RequestThrottler();
private throttlingEnabled = true;
private requireTls = false;
public constructor(args?: HttpLibArgs) {
this.throttlingEnabled = args?.enableThrottling ?? true;
this.requireTls = args?.requireTls ?? false;
}
async fetch(
requestUrl: string,
options?: HttpRequestOptions,
): Promise {
const requestMethod = options?.method ?? "GET";
const requestBody = options?.body;
const requestHeader = options?.headers;
const requestTimeout =
options?.timeout ?? Duration.fromMilliseconds(DEFAULT_REQUEST_TIMEOUT_MS);
const requestCancel = options?.cancellationToken;
const requestRedirect = options?.redirect;
const parsedUrl = new URL(requestUrl);
if (this.throttlingEnabled && this.throttle.applyThrottle(requestUrl)) {
throw TalerError.fromDetail(
TalerErrorCode.WALLET_HTTP_REQUEST_THROTTLED,
{
requestMethod,
requestUrl,
throttleStats: this.throttle.getThrottleStats(requestUrl),
},
`request to origin ${parsedUrl.origin} was throttled`,
);
}
if (this.requireTls && parsedUrl.protocol !== "https:") {
throw TalerError.fromDetail(
TalerErrorCode.WALLET_NETWORK_ERROR,
{
requestMethod: requestMethod,
requestUrl: requestUrl,
},
`request to ${parsedUrl.origin} is not possible with protocol ${parsedUrl.protocol}`,
);
}
const myBody: ArrayBuffer | undefined =
requestMethod === "POST" ||
requestMethod === "PUT" ||
requestMethod === "PATCH"
? encodeBody(requestBody)
: undefined;
const requestHeadersMap = getDefaultHeaders(requestMethod);
if (requestHeader) {
Object.entries(requestHeader).forEach(([key, value]) => {
if (value === undefined) return;
requestHeadersMap[key] = value;
});
}
/**
* default header assume everything is json
* in case of formData the content-type will be
* auto generated
*/
if (myBody instanceof FormData) {
delete requestHeadersMap["Content-Type"]
}
const controller = new AbortController();
let timeoutId: ReturnType | undefined;
if (requestTimeout.d_ms !== "forever") {
timeoutId = setTimeout(() => {
controller.abort(TalerErrorCode.GENERIC_TIMEOUT);
}, requestTimeout.d_ms);
}
if (requestCancel) {
requestCancel.onCancelled(() => {
controller.abort(TalerErrorCode.GENERIC_CLIENT_INTERNAL_ERROR);
});
}
try {
const response = await fetch(requestUrl, {
headers: requestHeadersMap,
body: myBody,
method: requestMethod,
signal: controller.signal,
redirect: requestRedirect,
});
if (timeoutId) {
clearTimeout(timeoutId);
}
const headerMap = new Headers();
response.headers.forEach((value, key) => {
headerMap.set(key, value);
});
const text = makeTextHandler(response, requestUrl, requestMethod);
const json = makeJsonHandler(response, requestUrl, requestMethod, text);
return {
headers: headerMap,
status: response.status,
requestMethod,
requestUrl,
json,
text,
bytes: async () => (await response.blob()).arrayBuffer(),
};
} catch (e) {
if (controller.signal) {
throw TalerError.fromDetail(
controller.signal.reason,
{
requestUrl,
requestMethod,
timeoutMs:
requestTimeout.d_ms === "forever" ? 0 : requestTimeout.d_ms,
},
`HTTP request failed.`,
);
}
throw e;
}
}
}
function makeTextHandler(
response: Response,
requestUrl: string,
requestMethod: string,
) {
let firstTime = true;
let respText: string;
let error: TalerError | undefined;
return async function getTextFromResponse(): Promise {
if (firstTime) {
firstTime = false;
try {
respText = await response.text();
} catch (e) {
error = TalerError.fromDetail(
TalerErrorCode.WALLET_RECEIVED_MALFORMED_RESPONSE,
{
requestUrl,
requestMethod,
httpStatusCode: response.status,
validationError: e instanceof Error ? e.message : String(e),
},
"Invalid text from HTTP response",
);
}
}
if (error !== undefined) {
throw error;
}
return respText;
};
}
function makeJsonHandler(
response: Response,
requestUrl: string,
requestMethod: string,
readTextHandler: () => Promise,
) {
let firstTime = true;
let responseJson: string | undefined = undefined;
let error: TalerError | undefined;
return async function getJsonFromResponse(): Promise {
if (firstTime) {
let responseText: string;
try {
responseText = await readTextHandler();
} catch (e) {
const message =
e instanceof Error
? `Couldn't read HTTP response: ${e.message}`
: "Couldn't read HTTP response";
error = TalerError.fromDetail(
TalerErrorCode.WALLET_RECEIVED_MALFORMED_RESPONSE,
{
requestUrl,
requestMethod,
httpStatusCode: response.status,
validationError: e instanceof Error ? e.message : String(e),
},
message,
);
}
if (!error) {
try {
// @ts-expect-error no error then text is initialized
responseJson = JSON.parse(responseText);
} catch (e) {
const message =
e instanceof Error
? `Invalid JSON from HTTP response: ${e.message}`
: "Invalid JSON from HTTP response";
error = TalerError.fromDetail(
TalerErrorCode.WALLET_RECEIVED_MALFORMED_RESPONSE,
{
requestUrl,
requestMethod,
// @ts-expect-error no error then text is initialized
response: responseText,
httpStatusCode: response.status,
validationError: e instanceof Error ? e.message : String(e),
},
message,
);
}
if (responseJson === null || typeof responseJson !== "object") {
error = TalerError.fromDetail(
TalerErrorCode.WALLET_RECEIVED_MALFORMED_RESPONSE,
{
requestUrl,
requestMethod,
response: JSON.stringify(responseJson),
httpStatusCode: response.status,
},
"Invalid JSON from HTTP response: null or not object",
);
}
}
}
if (error !== undefined) {
throw error;
}
return responseJson;
};
}