ARTESCA-6419: implement base http(s) agents and export

Author: Seragonia

index.ts

@@ -0,0 +1,10 @@
+import httpAgent from "./lib/http-agent";
+import httpsAgent from "./lib/https-agent";
+
+export const http = {
+    Agent: httpAgent,
+};
+
+export const https = {
+    Agent: httpsAgent,
+};

lib/config/default.ts

@@ -0,0 +1,6 @@
+export default interface clientConfigurationDefault {
+    /**
+     * Maximum Socket Number: true if TCP session reuse must be enabled
+     */
+    maxSockets?: boolean;
+}

lib/http-agent.ts

@@ -0,0 +1,39 @@
+import * as http from 'http';
+import clientConfigurationDefault from './config/default';
+
+/**
+ * @class ClientHttp
+ * Abstracts the native http.Agent class to enforce common
+ * networking configuration across components.
+ */
+export default class ClientHttp extends http.Agent {
+    /**
+     * The maximum socket configuration defaults to 50.
+     */
+    private static maxSocketsConfiguration = Number(process.env.MAX_SOCKETS) || 50;
+
+    /**
+     * Constructor for the ClientHttp class
+     *
+     * @param opts - Custom HTTP Agent options
+     * @param config - user-defined default configuration du apply
+     */
+    constructor(
+        opts?: http.AgentOptions,
+        config: clientConfigurationDefault = {
+            maxSockets: true,
+        },
+    ) {
+        // Enforce TCP session reuse configuration, unless explicitely specified.
+        const defaultConfigurations: http.AgentOptions = {};
+        if (config.maxSockets) {
+            defaultConfigurations.keepAlive = true;
+            defaultConfigurations.maxSockets = ClientHttp.maxSocketsConfiguration;
+            defaultConfigurations.maxFreeSockets = ClientHttp.maxSocketsConfiguration;
+        }
+        super({
+            ...opts,
+            ...defaultConfigurations,
+        });
+    }
+}

lib/https-agent.ts

@@ -0,0 +1,39 @@
+import * as https from 'https';
+import clientConfigurationDefault from './config/default';
+
+/**
+ * @class ClientHttps
+ * Abstracts the native https.Agent class to enforce common
+ * networking configuration across components.
+ */
+ export default class ClientHttps extends https.Agent {
+    /**
+     * The maximum socket configuration defaults to 50.
+     */
+    private static maxSocketsConfiguration = Number(process.env.MAX_SOCKETS) || 50;
+
+    /**
+     * Constructor for the ClientHttps class
+     *
+     * @param opts - Custom HTTPs Agent options
+     * @param config - user-defined default configuration du apply
+     */
+    constructor(
+        opts?: https.AgentOptions,
+        config: clientConfigurationDefault = {
+            maxSockets: true,
+        },
+    ) {
+        // Enforce TCP session reuse configuration, unless explicitely specified.
+        const defaultConfigurations: https.AgentOptions = {};
+        if (config.maxSockets) {
+            defaultConfigurations.keepAlive = true;
+            defaultConfigurations.maxSockets = ClientHttps.maxSocketsConfiguration;
+            defaultConfigurations.maxFreeSockets = ClientHttps.maxSocketsConfiguration;
+        }
+        super({
+            ...opts,
+            ...defaultConfigurations,
+        });
+    }
+}