@subsquid/http-client 1.0.0

package/README.md

@@ -0,0 +1,8 @@
+# @subsquid/util-internal-http-client
+
+A small convenience layer on top of `fetch()` which adds
+
+* `HttpClient` as a store for common request settings
+* retries
+* timeouts
+* logging.

package/esm.d.ts

@@ -0,0 +1,2 @@
+
+export declare function esm<T>(mod: string): Promise<T>

package/esm.js

@@ -0,0 +1,3 @@
+exports.esm = function esm(mod) {
+    return import(mod)
+}

package/lib/agent.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import * as http from 'http';
+import * as https from 'https';
+export interface AgentProvider {
+    getNativeAgent(url: string): http.Agent;
+}
+export declare const defaultAgentProvider: AgentProvider;
+export declare class HttpAgent implements AgentProvider {
+    private options;
+    private http?;
+    private https?;
+    constructor(options: https.AgentOptions);
+    getNativeAgent(url: string): http.Agent;
+    close(): void;
+}
+//# sourceMappingURL=agent.d.ts.map

package/lib/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,aAAa;IAC1B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAA;CAC1C;AAGD,eAAO,MAAM,oBAAoB,EAAE,aAQlC,CAAA;AAGD,qBAAa,SAAU,YAAW,aAAa;IAI/B,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,KAAK,CAAC,CAAa;gBAEP,OAAO,EAAE,KAAK,CAAC,YAAY;IAE/C,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK;IAQvC,KAAK;CAIR"}

package/lib/agent.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpAgent = exports.defaultAgentProvider = void 0;
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
+exports.defaultAgentProvider = {
+    getNativeAgent(url) {
+        if (url.startsWith('https://')) {
+            return https.globalAgent;
+        }
+        else {
+            return http.globalAgent;
+        }
+    }
+};
+class HttpAgent {
+    constructor(options) {
+        this.options = options;
+    }
+    getNativeAgent(url) {
+        if (url.startsWith('https://')) {
+            return this.https || (this.https = new https.Agent(this.options));
+        }
+        else {
+            return this.http || (this.http = new http.Agent(this.options));
+        }
+    }
+    close() {
+        this.http?.destroy();
+        this.https?.destroy();
+    }
+}
+exports.HttpAgent = HttpAgent;
+//# sourceMappingURL=agent.js.map

package/lib/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA4B;AAC5B,6CAA8B;AAQjB,QAAA,oBAAoB,GAAkB;IAC/C,cAAc,CAAC,GAAW;QACtB,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;YAC5B,OAAO,KAAK,CAAC,WAAW,CAAA;SAC3B;aAAM;YACH,OAAO,IAAI,CAAC,WAAW,CAAA;SAC1B;IACL,CAAC;CACJ,CAAA;AAGD,MAAa,SAAS;IAIlB,YAAoB,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAEnD,cAAc,CAAC,GAAW;QACtB,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;YAC5B,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;SACpE;aAAM;YACH,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;SACjE;IACL,CAAC;IAED,KAAK;QACD,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAA;QACpB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAA;IACzB,CAAC;CACJ;AAlBD,8BAkBC"}

package/lib/body.d.ts

@@ -0,0 +1,15 @@
+export type HttpBody = Content | Json | Nothing;
+interface Content {
+    content: string | Uint8Array;
+    json?: undefined;
+}
+interface Json {
+    content?: undefined;
+    json: object;
+}
+interface Nothing {
+    content?: undefined;
+    json?: undefined;
+}
+export {};
+//# sourceMappingURL=body.d.ts.map

package/lib/body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,OAAO,CAAA;AAG/C,UAAU,OAAO;IACb,OAAO,EAAE,MAAM,GAAG,UAAU,CAAA;IAC5B,IAAI,CAAC,EAAE,SAAS,CAAA;CACnB;AAGD,UAAU,IAAI;IACV,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACf;AAGD,UAAU,OAAO;IACb,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,IAAI,CAAC,EAAE,SAAS,CAAA;CACnB"}

package/lib/body.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=body.js.map

package/lib/body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":""}

package/lib/client.d.ts

@@ -0,0 +1,101 @@
+import type { Logger } from '@subsquid/logger';
+import type { Headers, RequestInit, Response } from 'node-fetch';
+import { AgentProvider } from './agent';
+import { HttpBody } from './body';
+export interface HttpClientOptions {
+    agent?: AgentProvider;
+    baseUrl?: string;
+    headers?: Record<string, string | number | bigint>;
+    /**
+     * Default request timeout in milliseconds.
+     *
+     * This timeout is only related to individual http requests.
+     * Overall request processing time might be much larger due to retries.
+     */
+    httpTimeout?: number;
+    retryAttempts?: number;
+    retrySchedule?: number[];
+    log?: Logger;
+}
+export interface RequestOptions {
+    query?: Record<string, string | number | bigint>;
+    headers?: HeadersInit;
+    retryAttempts?: number;
+    retrySchedule?: number[];
+    httpTimeout?: number;
+    abort?: AbortSignal;
+}
+export interface GraphqlRequestOptions extends RequestOptions {
+    variables?: Record<string, any>;
+    url?: string;
+    method?: 'GET' | 'POST';
+}
+export interface FetchRequest extends RequestInit {
+    id: number;
+    url: string;
+    headers: Headers;
+    timeout?: number;
+    signal?: AbortSignal;
+}
+export declare class HttpClient {
+    protected log?: Logger;
+    protected headers?: Record<string, string | number | bigint>;
+    private baseUrl?;
+    private agent;
+    private retrySchedule;
+    private retryAttempts;
+    private httpTimeout;
+    private requestCounter;
+    constructor(options?: HttpClientOptions);
+    get<T = any>(url: string, options?: RequestOptions): Promise<T>;
+    post<T = any>(url: string, options?: RequestOptions & HttpBody): Promise<T>;
+    request<T = any>(method: string, url: string, options?: RequestOptions & HttpBody): Promise<HttpResponse<T>>;
+    protected beforeRequest(req: FetchRequest): void;
+    protected beforeRetryPause(req: FetchRequest, reason: Error | HttpResponse, pause: number): void;
+    protected afterResponseHeaders(req: FetchRequest, url: string, status: number, headers: Headers): void;
+    protected afterResponse(req: FetchRequest, res: HttpResponse): void;
+    protected prepareRequest(method: string, url: string, options: RequestOptions & HttpBody): Promise<FetchRequest>;
+    private performRequestWithTimeout;
+    private performRequest;
+    protected handleResponseBody(req: FetchRequest, res: Response): Promise<any>;
+    isRetryableError(error: HttpResponse | Error, req?: FetchRequest): boolean;
+    getAbsUrl(url: string): string;
+    private setBaseUrl;
+    graphqlRequest<T = any>(gql: string, options?: GraphqlRequestOptions): Promise<T>;
+}
+export declare class HttpResponse<T = any> {
+    readonly requestId: number;
+    readonly url: string;
+    readonly status: number;
+    readonly headers: Headers;
+    readonly body: T;
+    constructor(requestId: number, url: string, status: number, headers: Headers, body: T);
+    get ok(): boolean;
+    assert(): void;
+    toJSON(): {
+        status: number;
+        headers: [string, string][];
+        body: T;
+        url: string;
+    };
+}
+export declare class HttpError extends Error {
+    readonly response: HttpResponse;
+    constructor(response: HttpResponse);
+    get name(): string;
+}
+export declare class HttpTimeoutError extends Error {
+    constructor(ms: number);
+    get name(): string;
+}
+export interface GraphqlMessage {
+    message: string;
+    path?: (string | number)[];
+}
+export declare class GraphqlError extends Error {
+    readonly messages: GraphqlMessage[];
+    constructor(messages: GraphqlMessage[]);
+    get name(): string;
+}
+export declare function isHttpConnectionError(err: unknown): boolean;
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

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

package/lib/client.js

@@ -0,0 +1,341 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isHttpConnectionError = exports.GraphqlError = exports.HttpTimeoutError = exports.HttpError = exports.HttpResponse = exports.HttpClient = void 0;
+const util_internal_1 = require("@subsquid/util-internal");
+const agent_1 = require("./agent");
+const request_1 = require("./request");
+class HttpClient {
+    constructor(options = {}) {
+        this.requestCounter = 0;
+        this.log = options.log;
+        this.headers = options.headers;
+        this.setBaseUrl(options.baseUrl);
+        this.agent = options.agent || agent_1.defaultAgentProvider;
+        this.retrySchedule = options.retrySchedule || [10, 100, 500, 2000, 10000, 20000];
+        this.retryAttempts = options.retryAttempts || 0;
+        this.httpTimeout = options.httpTimeout ?? 20000;
+    }
+    get(url, options) {
+        return this.request('GET', url, options).then(res => res.body);
+    }
+    post(url, options) {
+        return this.request('POST', url, options).then(res => res.body);
+    }
+    async request(method, url, options = {}) {
+        let req = await this.prepareRequest(method, url, options);
+        this.beforeRequest(req);
+        let retryAttempts = options.retryAttempts ?? this.retryAttempts;
+        let retrySchedule = options.retrySchedule ?? this.retrySchedule;
+        let retries = 0;
+        while (true) {
+            let res = await this.performRequestWithTimeout(req).catch(util_internal_1.ensureError);
+            if (res instanceof Error || !res.ok) {
+                if (retryAttempts > retries && this.isRetryableError(res, req)) {
+                    let pause = retrySchedule.length
+                        ? retrySchedule[Math.min(retries, retrySchedule.length - 1)]
+                        : 1000;
+                    retries += 1;
+                    this.beforeRetryPause(req, res, pause);
+                    await (0, util_internal_1.wait)(pause, req.signal);
+                }
+                else if (res instanceof Error) {
+                    throw (0, util_internal_1.addErrorContext)(res, { httpRequestId: req.id });
+                }
+                else {
+                    throw new HttpError(res);
+                }
+            }
+            else {
+                return res;
+            }
+        }
+    }
+    beforeRequest(req) {
+        if (this.log?.isDebug()) {
+            this.log.debug({
+                httpRequestId: req.id,
+                httpRequestUrl: req.url,
+                httpRequestMethod: req.method,
+                httpRequestHeaders: Array.from(req.headers),
+                httpRequestBody: req.body
+            }, 'http request');
+        }
+    }
+    beforeRetryPause(req, reason, pause) {
+        if (this.log?.isWarn()) {
+            let info = {
+                httpRequestId: req.id,
+                httpRequestUrl: req.url,
+                httpRequestMethod: req.method
+            };
+            if (reason instanceof Error) {
+                info.reason = reason.toString();
+            }
+            else {
+                info.reason = `got ${reason.status}`;
+                info.httpResponseUrl = reason.url;
+                info.httpResponseStatus = reason.status;
+                info.httpResponseHeaders = Array.from(reason.headers);
+                info.httpResponseBody = reason.body;
+            }
+            this.log.warn(info, `request will be retried in ${pause} ms`);
+        }
+    }
+    afterResponseHeaders(req, url, status, headers) {
+        if (this.log?.isDebug()) {
+            this.log.debug({
+                httpRequestId: req.id,
+                httpResponseUrl: url,
+                httpResponseStatus: status,
+                httpResponseHeaders: headers
+            }, 'http headers');
+        }
+    }
+    afterResponse(req, res) {
+        if (this.log?.isDebug()) {
+            let httpResponseBody = res.body;
+            if (typeof res.body == 'string' || res.body instanceof Uint8Array) {
+                if (res.body.length > 1024 * 1024) {
+                    httpResponseBody = '...body is too long to be logged';
+                }
+            }
+            this.log.debug({
+                httpRequestId: req.id,
+                httpResponseBody
+            }, 'http body');
+        }
+    }
+    async prepareRequest(method, url, options) {
+        await request_1.nodeFetch.load();
+        let req = {
+            id: this.requestCounter++,
+            method,
+            headers: new request_1.nodeFetch.Headers(options.headers),
+            url: this.getAbsUrl(url),
+            signal: options.abort,
+            compress: true,
+            timeout: options.httpTimeout ?? this.httpTimeout
+        };
+        if (options.query) {
+            let qs = new URLSearchParams(options.query).toString();
+            if (req.url.includes('?')) {
+                req.url += '&' + qs;
+            }
+            else {
+                req.url += '?' + qs;
+            }
+        }
+        req.agent = this.agent.getNativeAgent(req.url);
+        if (options.content !== undefined) {
+            if (typeof options.content == 'string') {
+                req.body = options.content;
+                if (!req.headers.has('content-type')) {
+                    req.headers.set('content-type', 'text/plain');
+                }
+            }
+            else if (Buffer.isBuffer(options.content)) {
+                req.body = options.content;
+            }
+            else {
+                req.body = Buffer.from(options.content.buffer, options.content.byteOffset, options.content.byteLength);
+            }
+        }
+        if (options.json !== undefined) {
+            req.body = JSON.stringify(options.json);
+            if (!req.headers.has('content-type')) {
+                req.headers.set('content-type', 'application/json');
+            }
+        }
+        for (let name in this.headers) {
+            if (!req.headers.has(name)) {
+                req.headers.set(name, '' + this.headers[name]);
+            }
+        }
+        return req;
+    }
+    async performRequestWithTimeout(req) {
+        if (!req.timeout)
+            return this.performRequest(req);
+        let ac = new AbortController();
+        function abort() {
+            ac.abort();
+        }
+        req.signal?.addEventListener('abort', abort);
+        let timer = setTimeout(() => {
+            timer = null;
+            abort();
+        }, req.timeout);
+        try {
+            return await this.performRequest({ ...req, signal: ac.signal });
+        }
+        catch (err) {
+            if (timer == null) {
+                throw new HttpTimeoutError(req.timeout);
+            }
+            else {
+                throw err;
+            }
+        }
+        finally {
+            if (timer != null) {
+                clearTimeout(timer);
+            }
+            req.signal?.removeEventListener('abort', abort);
+        }
+    }
+    async performRequest(req) {
+        let res = await request_1.nodeFetch.request(req.url, req);
+        this.afterResponseHeaders(req, res.url, res.status, res.headers);
+        let body = await this.handleResponseBody(req, res);
+        let httpResponse = new HttpResponse(req.id, res.url, res.status, res.headers, body);
+        this.afterResponse(req, httpResponse);
+        return httpResponse;
+    }
+    async handleResponseBody(req, res) {
+        let contentType = (res.headers.get('content-type') || '').split(';')[0];
+        if (contentType == 'application/json') {
+            return res.json();
+        }
+        if (contentType.startsWith('text/')) {
+            return res.text();
+        }
+        let arrayBuffer = await res.arrayBuffer();
+        let bytes = Buffer.from(arrayBuffer);
+        if (bytes.length == 0)
+            return undefined;
+        return bytes;
+    }
+    isRetryableError(error, req) {
+        if (isHttpConnectionError(error))
+            return true;
+        if (error instanceof HttpTimeoutError)
+            return true;
+        if (error instanceof HttpResponse) {
+            switch (error.status) {
+                case 429:
+                case 502:
+                case 503:
+                case 504:
+                    return true;
+                default:
+                    return false;
+            }
+        }
+        return false;
+    }
+    getAbsUrl(url) {
+        if (!this.baseUrl)
+            return url;
+        if (url.includes('://'))
+            return url;
+        if (url == '/')
+            return this.baseUrl;
+        if (url[0] == '/')
+            return this.baseUrl + url;
+        return this.baseUrl + '/' + url;
+    }
+    setBaseUrl(url) {
+        if (url) {
+            let u = new URL(url);
+            u.hash = '';
+            u.search = '';
+            url = u.toString();
+            if (url.endsWith('/')) {
+                url = url.slice(0, url.length - 1);
+            }
+            this.baseUrl = url;
+        }
+        else {
+            this.baseUrl = undefined;
+        }
+    }
+    async graphqlRequest(gql, options = {}) {
+        let { method = 'POST', url = '/', variables, ...reqOptions } = options;
+        let req = reqOptions;
+        if (method == 'GET') {
+            req.query = {
+                ...req.query,
+                query: gql,
+            };
+            if (variables) {
+                req.query.variables = JSON.stringify(variables);
+            }
+        }
+        else {
+            req.json = {
+                query: gql,
+                variables
+            };
+        }
+        let res = await this.request(method, url, req);
+        if (res.body.errors?.length) {
+            throw new GraphqlError(res.body.errors);
+        }
+        else {
+            return res.body.data;
+        }
+    }
+}
+exports.HttpClient = HttpClient;
+class HttpResponse {
+    constructor(requestId, url, status, headers, body) {
+        this.requestId = requestId;
+        this.url = url;
+        this.status = status;
+        this.headers = headers;
+        this.body = body;
+    }
+    get ok() {
+        return this.status >= 200 && this.status < 300;
+    }
+    assert() {
+        if (this.ok)
+            return;
+        throw new HttpError(this);
+    }
+    toJSON() {
+        return {
+            status: this.status,
+            headers: Array.from(this.headers),
+            body: this.body,
+            url: this.url
+        };
+    }
+}
+exports.HttpResponse = HttpResponse;
+class HttpError extends Error {
+    constructor(response) {
+        super(`Got ${response.status} from ${response.url}`);
+        this.response = response;
+    }
+    get name() {
+        return 'HttpError';
+    }
+}
+exports.HttpError = HttpError;
+class HttpTimeoutError extends Error {
+    constructor(ms) {
+        super(`request timed out after ${ms} ms`);
+    }
+    get name() {
+        return 'HttpTimeoutError';
+    }
+}
+exports.HttpTimeoutError = HttpTimeoutError;
+class GraphqlError extends Error {
+    constructor(messages) {
+        super(`GraphQL error: ${messages[0].message}`);
+        this.messages = messages;
+    }
+    get name() {
+        return 'GraphqlError';
+    }
+}
+exports.GraphqlError = GraphqlError;
+function isHttpConnectionError(err) {
+    return err instanceof request_1.nodeFetch.FetchError
+        && err.type == 'system'
+        && (err.message.startsWith('request to') || err.code == 'ERR_STREAM_PREMATURE_CLOSE');
+}
+exports.isHttpConnectionError = isHttpConnectionError;
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from './client';
+export { AgentProvider, HttpAgent } from './agent';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,OAAO,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,SAAS,CAAA"}

package/lib/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpAgent = void 0;
+__exportStar(require("./client"), exports);
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "HttpAgent", { enumerable: true, get: function () { return agent_1.HttpAgent; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,iCAAgD;AAAzB,kGAAA,SAAS,OAAA"}

package/lib/request.d.ts

@@ -0,0 +1,8 @@
+import type { RequestInit, Response } from 'node-fetch';
+export declare const nodeFetch: {
+    load(): Promise<typeof import('node-fetch')>;
+    readonly Headers: typeof import("node-fetch").Headers;
+    readonly FetchError: typeof import("node-fetch").FetchError;
+    request(url: string, init?: RequestInit): Promise<Response>;
+};
+//# sourceMappingURL=request.d.ts.map

package/lib/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,WAAW,EAAE,QAAQ,EAAC,MAAM,YAAY,CAAA;AAOrD,eAAO,MAAM,SAAS;YACJ,QAAQ,cAAc,YAAY,CAAC,CAAC;;;iBAY/B,MAAM,SAAS,WAAW,GAAG,QAAQ,QAAQ,CAAC;CAIpE,CAAA"}

package/lib/request.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeFetch = void 0;
+const assert_1 = __importDefault(require("assert"));
+const esm_1 = require("../esm");
+let mod;
+exports.nodeFetch = {
+    async load() {
+        if (mod)
+            return mod;
+        return mod = await (0, esm_1.esm)('node-fetch');
+    },
+    get Headers() {
+        (0, assert_1.default)(mod, 'node-fetch ESM is not loaded');
+        return mod.Headers;
+    },
+    get FetchError() {
+        (0, assert_1.default)(mod, 'node-fetch ESM is not loaded');
+        return mod.FetchError;
+    },
+    async request(url, init) {
+        let m = await exports.nodeFetch.load();
+        return m.default(url, init);
+    }
+};
+//# sourceMappingURL=request.js.map

package/lib/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA2B;AAE3B,gCAA0B;AAG1B,IAAI,GAA4C,CAAA;AAGnC,QAAA,SAAS,GAAG;IACrB,KAAK,CAAC,IAAI;QACN,IAAI,GAAG;YAAE,OAAO,GAAG,CAAA;QACnB,OAAO,GAAG,GAAG,MAAM,IAAA,SAAG,EAA+B,YAAY,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,OAAO;QACP,IAAA,gBAAM,EAAC,GAAG,EAAE,8BAA8B,CAAC,CAAA;QAC3C,OAAO,GAAG,CAAC,OAAO,CAAA;IACtB,CAAC;IACD,IAAI,UAAU;QACV,IAAA,gBAAM,EAAC,GAAG,EAAE,8BAA8B,CAAC,CAAA;QAC3C,OAAO,GAAG,CAAC,UAAU,CAAA;IACzB,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,IAAkB;QACzC,IAAI,CAAC,GAAG,MAAM,iBAAS,CAAC,IAAI,EAAE,CAAA;QAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;CACJ,CAAA"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@subsquid/http-client",
+  "version": "1.0.0",
+  "description": "Small convenience layer on top of fetch",
+  "license": "GPL-3.0-or-later",
+  "repository": "git@github.com:subsquid/squid.git",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "src",
+    "esm.d.ts",
+    "esm.js"
+  ],
+  "dependencies": {
+    "@subsquid/logger": "^1.0.0",
+    "@subsquid/util-internal": "^2.0.0",
+    "node-fetch": "^3.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^16.18.25",
+    "typescript": "~4.9.5"
+  },
+  "scripts": {
+    "build": "rm -rf lib && tsc"
+  },
+  "readme": "# @subsquid/util-internal-http-client\n\nA small convenience layer on top of `fetch()` which adds\n\n* `HttpClient` as a store for common request settings\n* retries\n* timeouts\n* logging.\n"
+}

package/src/agent.ts

@@ -0,0 +1,39 @@
+import * as http from 'http'
+import * as https from 'https'
+
+
+export interface AgentProvider {
+    getNativeAgent(url: string): http.Agent
+}
+
+
+export const defaultAgentProvider: AgentProvider = {
+    getNativeAgent(url: string): http.Agent {
+        if (url.startsWith('https://')) {
+            return https.globalAgent
+        } else {
+            return http.globalAgent
+        }
+    }
+}
+
+
+export class HttpAgent implements AgentProvider {
+    private http?: http.Agent
+    private https?: https.Agent
+
+    constructor(private options: https.AgentOptions) {}
+
+    getNativeAgent(url: string): http.Agent {
+        if (url.startsWith('https://')) {
+            return this.https || (this.https = new https.Agent(this.options))
+        } else {
+            return this.http || (this.http = new http.Agent(this.options))
+        }
+    }
+
+    close() {
+        this.http?.destroy()
+        this.https?.destroy()
+    }
+}

package/src/body.ts

@@ -0,0 +1,20 @@
+
+export type HttpBody = Content | Json | Nothing
+
+
+interface Content {
+    content: string | Uint8Array
+    json?: undefined
+}
+
+
+interface Json {
+    content?: undefined
+    json: object
+}
+
+
+interface Nothing {
+    content?: undefined
+    json?: undefined
+}

package/src/client.ts

@@ -0,0 +1,427 @@
+import type {Logger} from '@subsquid/logger'
+import {addErrorContext, ensureError, wait} from '@subsquid/util-internal'
+import type {Headers, RequestInit, Response} from 'node-fetch'
+import {AgentProvider, defaultAgentProvider} from './agent'
+import {HttpBody} from './body'
+import {nodeFetch} from './request'
+
+
+export interface HttpClientOptions {
+    agent?: AgentProvider
+    baseUrl?: string
+    headers?: Record<string, string | number | bigint>
+    /**
+     * Default request timeout in milliseconds.
+     *
+     * This timeout is only related to individual http requests.
+     * Overall request processing time might be much larger due to retries.
+     */
+    httpTimeout?: number
+    retryAttempts?: number
+    retrySchedule?: number[]
+    log?: Logger
+}
+
+
+export interface RequestOptions {
+    query?: Record<string, string | number | bigint>
+    headers?: HeadersInit
+    retryAttempts?: number
+    retrySchedule?: number[]
+    httpTimeout?: number
+    abort?: AbortSignal
+}
+
+
+export interface GraphqlRequestOptions extends RequestOptions {
+    variables?: Record<string, any>
+    url?: string
+    method?: 'GET' | 'POST'
+}
+
+
+export interface FetchRequest extends RequestInit {
+    id: number
+    url: string
+    headers: Headers
+    timeout?: number
+    signal?: AbortSignal
+}
+
+
+export class HttpClient {
+    protected log?: Logger
+    protected headers?: Record<string, string | number | bigint>
+    private baseUrl?: string
+    private agent: AgentProvider
+    private retrySchedule: number[]
+    private retryAttempts: number
+    private httpTimeout: number
+    private requestCounter = 0
+
+    constructor(options: HttpClientOptions = {}) {
+        this.log = options.log
+        this.headers = options.headers
+        this.setBaseUrl(options.baseUrl)
+        this.agent = options.agent || defaultAgentProvider
+        this.retrySchedule = options.retrySchedule || [10, 100, 500, 2000, 10000, 20000]
+        this.retryAttempts = options.retryAttempts || 0
+        this.httpTimeout = options.httpTimeout ?? 20000
+    }
+
+    get<T=any>(url: string, options?: RequestOptions): Promise<T> {
+        return this.request('GET', url, options).then(res => res.body)
+    }
+
+    post<T=any>(url: string, options?: RequestOptions & HttpBody): Promise<T> {
+        return this.request('POST', url, options).then(res => res.body)
+    }
+
+    async request<T=any>(
+        method: string,
+        url: string,
+        options: RequestOptions & HttpBody = {},
+    ): Promise<HttpResponse<T>> {
+        let req = await this.prepareRequest(method, url, options)
+
+        this.beforeRequest(req)
+
+        let retryAttempts = options.retryAttempts ?? this.retryAttempts
+        let retrySchedule = options.retrySchedule ?? this.retrySchedule
+        let retries = 0
+
+        while (true) {
+            let res: HttpResponse | Error = await this.performRequestWithTimeout(req).catch(ensureError)
+            if (res instanceof Error || !res.ok) {
+                if (retryAttempts > retries && this.isRetryableError(res, req)) {
+                    let pause = retrySchedule.length
+                        ? retrySchedule[Math.min(retries, retrySchedule.length - 1)]
+                        : 1000
+                    retries += 1
+                    this.beforeRetryPause(req, res, pause)
+                    await wait(pause, req.signal)
+                } else if (res instanceof Error) {
+                    throw addErrorContext(res, {httpRequestId: req.id})
+                } else {
+                    throw new HttpError(res)
+                }
+            } else {
+                return res
+            }
+        }
+    }
+
+    protected beforeRequest(req: FetchRequest): void {
+        if (this.log?.isDebug()) {
+            this.log.debug({
+                httpRequestId: req.id,
+                httpRequestUrl: req.url,
+                httpRequestMethod: req.method,
+                httpRequestHeaders: Array.from(req.headers),
+                httpRequestBody: req.body
+            }, 'http request')
+        }
+    }
+
+    protected beforeRetryPause(req: FetchRequest, reason: Error | HttpResponse, pause: number): void {
+        if (this.log?.isWarn()) {
+            let info: any = {
+                httpRequestId: req.id,
+                httpRequestUrl: req.url,
+                httpRequestMethod: req.method
+            }
+            if (reason instanceof Error) {
+                info.reason = reason.toString()
+            } else {
+                info.reason = `got ${reason.status}`
+                info.httpResponseUrl = reason.url
+                info.httpResponseStatus = reason.status
+                info.httpResponseHeaders = Array.from(reason.headers)
+                info.httpResponseBody = reason.body
+            }
+            this.log.warn(info, `request will be retried in ${pause} ms`)
+        }
+    }
+
+    protected afterResponseHeaders(req: FetchRequest, url: string, status: number, headers: Headers): void {
+        if (this.log?.isDebug()) {
+            this.log.debug({
+                httpRequestId: req.id,
+                httpResponseUrl: url,
+                httpResponseStatus: status,
+                httpResponseHeaders: headers
+            }, 'http headers')
+        }
+    }
+
+    protected afterResponse(req: FetchRequest, res: HttpResponse): void {
+        if (this.log?.isDebug()) {
+            let httpResponseBody: any = res.body
+            if (typeof res.body == 'string' || res.body instanceof Uint8Array) {
+                if (res.body.length > 1024 * 1024) {
+                    httpResponseBody = '...body is too long to be logged'
+                }
+            }
+            this.log.debug({
+                httpRequestId: req.id,
+                httpResponseBody
+            }, 'http body')
+        }
+    }
+
+    protected async prepareRequest(
+        method: string,
+        url: string,
+        options: RequestOptions & HttpBody
+    ): Promise<FetchRequest> {
+        await nodeFetch.load()
+
+        let req: FetchRequest = {
+            id: this.requestCounter++,
+            method,
+            headers: new nodeFetch.Headers(options.headers),
+            url: this.getAbsUrl(url),
+            signal: options.abort,
+            compress: true,
+            timeout: options.httpTimeout ?? this.httpTimeout
+        }
+
+        if (options.query) {
+            let qs = new URLSearchParams(options.query as any).toString()
+            if (req.url.includes('?')) {
+                req.url += '&' + qs
+            } else {
+                req.url += '?' + qs
+            }
+        }
+
+        req.agent = this.agent.getNativeAgent(req.url)
+
+        if (options.content !== undefined) {
+            if (typeof options.content == 'string') {
+                req.body = options.content
+                if (!req.headers.has('content-type')) {
+                    req.headers.set('content-type', 'text/plain')
+                }
+            } else if (Buffer.isBuffer(options.content)) {
+                req.body = options.content
+            } else {
+                req.body = Buffer.from(options.content.buffer, options.content.byteOffset, options.content.byteLength)
+            }
+        }
+
+        if (options.json !== undefined) {
+            req.body = JSON.stringify(options.json)
+            if (!req.headers.has('content-type')) {
+                req.headers.set('content-type', 'application/json')
+            }
+        }
+
+        for (let name in this.headers) {
+            if (!req.headers.has(name)) {
+                req.headers.set(name, ''+this.headers[name])
+            }
+        }
+
+        return req
+    }
+
+    private async performRequestWithTimeout(req: FetchRequest): Promise<HttpResponse> {
+        if (!req.timeout) return this.performRequest(req)
+
+        let ac = new AbortController()
+
+        function abort() {
+            ac.abort()
+        }
+
+        req.signal?.addEventListener('abort', abort)
+
+        let timer: any | null = setTimeout(() => {
+            timer = null
+            abort()
+        }, req.timeout)
+
+        try {
+            return await this.performRequest({...req, signal: ac.signal})
+        } catch(err: any) {
+            if (timer == null) {
+                throw new HttpTimeoutError(req.timeout)
+            } else {
+                throw err
+            }
+        } finally {
+            if (timer != null) {
+                clearTimeout(timer)
+            }
+            req.signal?.removeEventListener('abort', abort)
+        }
+    }
+
+    private async performRequest(req: FetchRequest): Promise<HttpResponse> {
+        let res = await nodeFetch.request(req.url, req)
+        this.afterResponseHeaders(req, res.url, res.status, res.headers)
+        let body = await this.handleResponseBody(req, res)
+        let httpResponse = new HttpResponse(req.id, res.url, res.status, res.headers, body)
+        this.afterResponse(req, httpResponse)
+        return httpResponse
+    }
+
+    protected async handleResponseBody(req: FetchRequest, res: Response): Promise<any> {
+        let contentType = (res.headers.get('content-type') || '').split(';')[0]
+
+        if (contentType == 'application/json') {
+            return res.json()
+        }
+
+        if (contentType.startsWith('text/')) {
+            return res.text()
+        }
+
+        let arrayBuffer = await res.arrayBuffer()
+        let bytes = Buffer.from(arrayBuffer)
+        if (bytes.length == 0) return undefined
+        return bytes
+    }
+
+    isRetryableError(error: HttpResponse | Error, req?: FetchRequest): boolean {
+        if (isHttpConnectionError(error)) return true
+        if (error instanceof HttpTimeoutError) return true
+        if (error instanceof HttpResponse) {
+            switch(error.status) {
+                case 429:
+                case 502:
+                case 503:
+                case 504:
+                    return true
+                default:
+                    return false
+            }
+        }
+        return false
+    }
+
+    getAbsUrl(url: string): string {
+        if (!this.baseUrl) return url
+        if (url.includes('://')) return url
+        if (url == '/') return this.baseUrl
+        if (url[0] == '/') return this.baseUrl + url
+        return this.baseUrl + '/' + url
+    }
+
+    private setBaseUrl(url?: string): void {
+        if (url) {
+            let u = new URL(url)
+            u.hash = ''
+            u.search = ''
+            url = u.toString()
+            if (url.endsWith('/')) {
+                url = url.slice(0, url.length - 1)
+            }
+            this.baseUrl = url
+        } else {
+            this.baseUrl = undefined
+        }
+    }
+
+    async graphqlRequest<T=any>(gql: string, options: GraphqlRequestOptions = {}): Promise<T> {
+        let {method = 'POST', url = '/', variables, ...reqOptions} = options
+        let req: RequestOptions & {json?: any} = reqOptions
+        if (method == 'GET') {
+            req.query = {
+                ...req.query,
+                query: gql,
+            }
+            if (variables) {
+                req.query.variables = JSON.stringify(variables)
+            }
+        } else {
+            req.json = {
+                query: gql,
+                variables
+            }
+        }
+        let res = await this.request<{data: T, errors?: GraphqlMessage[]}>(method, url, req)
+        if (res.body.errors?.length) {
+            throw new GraphqlError(res.body.errors)
+        } else {
+            return res.body.data
+        }
+    }
+}
+
+
+export class HttpResponse<T=any> {
+    constructor(
+        public readonly requestId: number,
+        public readonly url: string,
+        public readonly status: number,
+        public readonly headers: Headers,
+        public readonly body: T
+    ) {
+    }
+
+    get ok(): boolean {
+        return this.status >= 200 && this.status < 300
+    }
+
+    assert(): void {
+        if (this.ok) return
+        throw new HttpError(this)
+    }
+
+    toJSON() {
+        return {
+            status: this.status,
+            headers: Array.from(this.headers),
+            body: this.body,
+            url: this.url
+        }
+    }
+}
+
+
+export class HttpError extends Error {
+    constructor(public readonly response: HttpResponse) {
+        super(`Got ${response.status} from ${response.url}`)
+    }
+
+    get name(): string {
+        return 'HttpError'
+    }
+}
+
+
+export class HttpTimeoutError extends Error {
+    constructor(ms: number) {
+        super(`request timed out after ${ms} ms`)
+    }
+
+    get name(): string {
+        return 'HttpTimeoutError'
+    }
+}
+
+
+export interface GraphqlMessage {
+    message: string
+    path?: (string | number)[]
+}
+
+
+export class GraphqlError extends Error {
+    constructor(public readonly messages: GraphqlMessage[]) {
+        super(`GraphQL error: ${messages[0].message}`)
+    }
+
+    get name(): string {
+        return 'GraphqlError'
+    }
+}
+
+
+export function isHttpConnectionError(err: unknown): boolean {
+    return err instanceof nodeFetch.FetchError
+        && err.type == 'system'
+        && (err.message.startsWith('request to') || err.code == 'ERR_STREAM_PREMATURE_CLOSE')
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './client'
+export {AgentProvider, HttpAgent} from './agent'

package/src/request.ts

@@ -0,0 +1,26 @@
+import assert from 'assert'
+import type {RequestInit, Response} from 'node-fetch'
+import {esm} from '../esm'
+
+
+let mod: typeof import('node-fetch') | undefined
+
+
+export const nodeFetch = {
+    async load(): Promise<typeof import('node-fetch')> {
+        if (mod) return mod
+        return mod = await esm<typeof import('node-fetch') >('node-fetch')
+    },
+    get Headers() {
+        assert(mod, 'node-fetch ESM is not loaded')
+        return mod.Headers
+    },
+    get FetchError() {
+        assert(mod, 'node-fetch ESM is not loaded')
+        return mod.FetchError
+    },
+    async request(url: string, init?: RequestInit): Promise<Response> {
+        let m = await nodeFetch.load()
+        return m.default(url, init)
+    }
+}