@nestia/fetcher 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+# Nestia Fetcher
+## Outline
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/@nestia/fetcher/blob/master/LICENSE)
+[![npm version](https://badge.fury.io/js/@nestia/fetcher.svg)](https://www.npmjs.com/package/@nestia/fetcher)
+[![Downloads](https://img.shields.io/npm/dm/@nestia/fetcher.svg)](https://www.npmjs.com/package/@nestia/fetcher)
+[![Build Status](https://github.com/samchon/@nestia/fetcher/workflows/build/badge.svg)](https://github.com/samchon/@nestia/fetcher/actions?query=workflow%3Abuild)
+
+```bash
+npm install --save @nestia/fetcher
+```
+
+`@nestia/fetcher` is a fetcher library of [**Nestia**](https://github.com/samchon/nestia) SDK.
+
+When you build an SDK (Software Development Kit) library interacting with remote HTTP server through the [**Nestia**](https://github.com/samchon/nestia), the SDK library would be dependent on this `@nestia/fetcher`. Therefore, if you publish the SDK library on the NPM module, you have to add this `@nestia/fetcher` in the `dependencies` field of the `package.json`.
+
+Also, if you're a client developer who've installed an SDK library which has been generated by the [**Nestia**](https://github.com/samchon/nestia), you also need to install this `@nestia/fetcher` module. With the `IConnection` and `HttpError` instances provided this `@nestia/fetcher`, you can enjoy the SDK library much conveniently. 
+
+
+
+
+## Example
+### `package.json`
+When you build an SDK library who've been generated by the [**Nestia**](https://github.com/samchon/nestia), you have to add this `@nestia/fetcher` in the `dependencies` field of the `package.json`. If your project had installed the [**Nestia**](https://github.com/samchon/nestia), you can write the `dependencies`' property by writing the `npx nestia dependencies` command on your console.
+
+```json
+{
+  "name": "payments-server-api",
+  "dependencies": {
+    "@nestia/fetcher": "^1.0.0"
+  }
+}
+```
+
+### SDK Library
+Opening the SDK library source file who've been generated by the [**Nestia**](https://github.com/samchon/nestia), you can find the SDK library is importing this `@nestia/fetcher` module in every `functional` files. Therefore, I repeat that you have to put this `@nestia/fetcher` down into the `dependencies` field of the `package.json`.
+
+```typescript
+import { Fetcher, IConnection, Primitive } from "@nestia/fetcher";
+
+/**
+ * 결제 내역 발행하기.
+ * 
+ * @param connection connection information
+ * @param input 결제 내역 입력 정보
+ * @returns 결제 내역
+ * 
+ * @nestia Generated by Nestia - https://github.com/samchon/nestia
+ * @controller PaymentHistoriesController.store()
+ * @path POST /histories
+ */
+export function store
+    (
+        connection: IConnection,
+        input: Primitive<store.Input>
+    ): Promise<store.Output>
+{
+    return Fetcher.fetch
+    (
+        connection,
+        store.CONFIG,
+        store.METHOD,
+        store.path(),
+        input
+    );
+}
+export namespace store
+{
+    export type Input = Primitive<IPaymentHistory.IStore>;
+    export type Output = Primitive<IPaymentHistory>;
+
+    export const METHOD = "POST" as const;
+    export const PATH: string = "/histories";
+    export const CONFIG: IConnection.IEncrypted = {
+        input_encrypted: true,
+        output_encrypted: true,
+    };
+
+    export function path(): string
+    {
+        return `/histories`;
+    }
+}
+```
+
+### Utilization Code
+After you've published the SDK library and let client developers to install the SDK library, the client developers would import this `@nestia/fetcher` module, too. They would utilize the `IConnection` and `HttpError` instances like below.
+
+```typescript
+import payments from "payments-server-api";
+import { IPaymentHistory } from "payments-server-api/lib/structures/IPaymentHistory";
+import { IConnection, HttpError } from "@nestia/fetcher";
+
+export async function main(): Promise<void>
+{
+    // CONNECTION INFO OF THE REMOTE HTTP SERVER
+    const connection: IConnection = {
+        host: "http://payments.somewhere.com",
+        encryption: {
+            key: "SqwHmmXm1fZteI3URPtoyBWFJDMQ7FBQ",
+            iv: "9eSfjygAClnE1JJs"
+        }
+    };
+
+    try
+    {
+        const input: IPaymentHistory.IStore = { ...SOME_DATA };
+        const history: IPaymentHistory = await payments.functional.histories.store
+        (
+            connection,
+            input
+        );
+    }
+    catch (exp)
+    {
+        // HTTP-ERRROR
+        if (exp instanceof HttpError)
+            console.log(exp);
+    }
+}
+```

package/lib/AesPkcs5.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Utility class for the AES-128/256 encryption.
+ *
+ *   - AES-128/256
+ *   - CBC mode
+ *   - PKCS#5 Padding
+ *   - Base64 Encoding
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace AesPkcs5 {
+    /**
+     * Encrypt data
+     *
+     * @param data Target data
+     * @param key Key value of the encryption.
+     * @param iv Initializer Vector for the encryption
+     * @return Encrypted data
+     */
+    function encrypt(data: string, key: string, iv: string): string;
+    /**
+     * Decrypt data.
+     *
+     * @param data Target data
+     * @param key Key value of the decryption.
+     * @param iv Initializer Vector for the decryption
+     * @return Decrypted data.
+     */
+    function decrypt(data: string, key: string, iv: string): string;
+}

package/lib/AesPkcs5.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AesPkcs5 = void 0;
+var crypto_1 = __importDefault(require("crypto"));
+/**
+ * Utility class for the AES-128/256 encryption.
+ *
+ *   - AES-128/256
+ *   - CBC mode
+ *   - PKCS#5 Padding
+ *   - Base64 Encoding
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var AesPkcs5;
+(function (AesPkcs5) {
+    /**
+     * Encrypt data
+     *
+     * @param data Target data
+     * @param key Key value of the encryption.
+     * @param iv Initializer Vector for the encryption
+     * @return Encrypted data
+     */
+    function encrypt(data, key, iv) {
+        var bytes = key.length * 8;
+        var cipher = crypto_1.default.createCipheriv("AES-".concat(bytes, "-CBC"), key, iv);
+        return cipher.update(data, "utf8", "base64") + cipher.final("base64");
+    }
+    AesPkcs5.encrypt = encrypt;
+    /**
+     * Decrypt data.
+     *
+     * @param data Target data
+     * @param key Key value of the decryption.
+     * @param iv Initializer Vector for the decryption
+     * @return Decrypted data.
+     */
+    function decrypt(data, key, iv) {
+        var bytes = key.length * 8;
+        var decipher = crypto_1.default.createDecipheriv("AES-".concat(bytes, "-CBC"), key, iv);
+        return decipher.update(data, "base64", "utf8") + decipher.final("utf8");
+    }
+    AesPkcs5.decrypt = decrypt;
+})(AesPkcs5 = exports.AesPkcs5 || (exports.AesPkcs5 = {}));
+//# sourceMappingURL=AesPkcs5.js.map

package/lib/AesPkcs5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AesPkcs5.js","sourceRoot":"","sources":["../src/AesPkcs5.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA4B;AAE5B;;;;;;;;;GASG;AACH,IAAiB,QAAQ,CAsCxB;AAtCD,WAAiB,QAAQ;IACrB;;;;;;;OAOG;IACH,SAAgB,OAAO,CAAC,IAAY,EAAE,GAAW,EAAE,EAAU;QACzD,IAAM,KAAK,GAAW,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QACrC,IAAM,MAAM,GAAkB,gBAAM,CAAC,cAAc,CAC/C,cAAO,KAAK,SAAM,EAClB,GAAG,EACH,EAAE,CACL,CAAC;QAEF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1E,CAAC;IATe,gBAAO,UAStB,CAAA;IAED;;;;;;;OAOG;IACH,SAAgB,OAAO,CAAC,IAAY,EAAE,GAAW,EAAE,EAAU;QACzD,IAAM,KAAK,GAAW,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QACrC,IAAM,QAAQ,GAAoB,gBAAM,CAAC,gBAAgB,CACrD,cAAO,KAAK,SAAM,EAClB,GAAG,EACH,EAAE,CACL,CAAC;QAEF,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5E,CAAC;IATe,gBAAO,UAStB,CAAA;AACL,CAAC,EAtCgB,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QAsCxB"}

package/lib/Fetcher.d.ts

@@ -0,0 +1,68 @@
+import { IConnection } from "./IConnection";
+import { Primitive } from "./Primitive";
+/**
+ * Fetcher, utility class for the [**Nestia**](https://github.com/samchon/nestia) fetch.
+ *
+ * `Fetcher` is a utility class providing the {@link Fetcher.fetch} functions who're being
+ * used by all of the SDK libraries, interacting with the remote HTTP servers, who are
+ * generated by the [**Nestia**](https://github.com/samchon/nestia).
+ *
+ * As this `Fetcher` be used only by the [**Nestia**](https://github.com/samchon/nestia)
+ * generated SDK libraries, you don't need to handle this class directly. It may only be
+ * appeared in the source codes of the [**Nestia**](https://github.com/samchon/nestia)
+ * generated SDK libraries.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare class Fetcher {
+    /**
+     * Fetch function for the `GET` or `DELETE` methods.
+     *
+     * @param connection Connection information for the remote HTTP server
+     * @param encrypted Whether the request/response body be encrypted or not
+     * @param method Method of the HTTP request
+     * @param path Path of the HTTP request
+     * @return Response body data from the remote HTTP server
+     */
+    static fetch<Output>(connection: IConnection, encrypted: Fetcher.IEncrypted, method: "GET" | "DELETE", path: string): Promise<Primitive<Output>>;
+    /**
+     * Fetch function for the `POST`, `PUT` and `PATCH` methods.
+     *
+     * @param connection Connection information for the remote HTTP server
+     * @param encrypted Whether the request/response body be encrypted or not
+     * @param method Method of the HTTP request
+     * @param path Path of the HTTP request
+     * @param input Request body data for the HTTP request
+     * @param stringify JSON string conversion function, default is the `JSON.stringify`
+     * @return Response body data from the remote HTTP server
+     */
+    static fetch<Input, Output>(connection: IConnection, encrypted: Fetcher.IEncrypted, method: "POST" | "PUT" | "PATCH", path: string, input: Input, stringify?: (input: Input) => string): Promise<Primitive<Output>>;
+}
+export declare namespace Fetcher {
+    /**
+     * Whether be encrypted or not.
+     *
+     * `Fetcher.IEncrypted` is a type of interface who represents whether the HTTP request
+     * and response body must be encrypted or not.
+     *
+     * Like the {@link Fetcher} who are being used by all of the SDK libraries that are
+     * generated by the [Nestia](https://github.com/samchon/nestia), this `IEncrypted`
+     * interface would be used by the [Nestia](https://github.com/samchon/nestia) generated
+     * SDK libaries.
+     *
+     * As this `Fetcher` be used only by the [**Nestia**](https://github.com/samchon/nestia)
+     * generated SDK libraries, you don't need to handle this class directly. It may only be
+     * appeared in the source codes of the [**Nestia**](https://github.com/samchon/nestia)
+     * generated SDK libraries.
+     */
+    interface IEncrypted {
+        /**
+         * Whether the request body be encrypted or not.
+         */
+        request?: boolean;
+        /**
+         * Whether the response body be encrypted or not.
+         */
+        response: boolean;
+    }
+}

package/lib/Fetcher.js

@@ -0,0 +1,190 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Fetcher = void 0;
+var import2_1 = __importDefault(require("import2"));
+var AesPkcs5_1 = require("./AesPkcs5");
+var HttpError_1 = require("./HttpError");
+var Singleton_1 = require("./internal/Singleton");
+/**
+ * Fetcher, utility class for the [**Nestia**](https://github.com/samchon/nestia) fetch.
+ *
+ * `Fetcher` is a utility class providing the {@link Fetcher.fetch} functions who're being
+ * used by all of the SDK libraries, interacting with the remote HTTP servers, who are
+ * generated by the [**Nestia**](https://github.com/samchon/nestia).
+ *
+ * As this `Fetcher` be used only by the [**Nestia**](https://github.com/samchon/nestia)
+ * generated SDK libraries, you don't need to handle this class directly. It may only be
+ * appeared in the source codes of the [**Nestia**](https://github.com/samchon/nestia)
+ * generated SDK libraries.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var Fetcher = /** @class */ (function () {
+    function Fetcher() {
+    }
+    Fetcher.fetch = function (connection, encrypted, method, path, input, stringify) {
+        return __awaiter(this, void 0, void 0, function () {
+            var init, body_1, headers, password, url, response, body, headers, password, ret;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (encrypted.request === true || encrypted.response === true)
+                            if (connection.encryption === undefined)
+                                throw new Error("Error on nestia.Fetcher.encrypt(): the encryption password has not been configured.");
+                        init = {
+                            method: method,
+                            headers: encrypted.request === false &&
+                                input !== undefined &&
+                                typeof input === "object"
+                                ? __assign(__assign({}, connection.headers), { "Content-Type": "application/json" }) : connection.headers,
+                        };
+                        // REQUEST BODY (WITH ENCRYPTION)
+                        if (input !== undefined) {
+                            body_1 = (stringify || JSON.stringify)(input);
+                            if (encrypted.request === true) {
+                                headers = new Singleton_1.Singleton(function () { return init.headers; });
+                                password = connection.encryption instanceof Function
+                                    ? connection.encryption({ headers: headers.get(), body: body_1 }, true)
+                                    : connection.encryption;
+                                if (is_disabled(password, headers, body_1, true) === false)
+                                    body_1 = AesPkcs5_1.AesPkcs5.encrypt(body_1, password.key, password.iv);
+                            }
+                            init.body = body_1;
+                        }
+                        //----
+                        // RESPONSE MESSAGE
+                        //----
+                        // URL SPECIFICATION
+                        if (connection.host[connection.host.length - 1] !== "/" &&
+                            path[0] !== "/")
+                            path = "/" + path;
+                        url = new URL("".concat(connection.host).concat(path));
+                        return [4 /*yield*/, polyfill.get()];
+                    case 1: return [4 /*yield*/, (_a.sent())(url.href, init)];
+                    case 2:
+                        response = _a.sent();
+                        return [4 /*yield*/, response.text()];
+                    case 3:
+                        body = _a.sent();
+                        if (!body)
+                            return [2 /*return*/, undefined];
+                        // CHECK THE STATUS CODE
+                        if (response.status !== 200 && response.status !== 201)
+                            throw new HttpError_1.HttpError(method, path, response.status, body);
+                        // FINALIZATION (WITH DECODING)
+                        if (encrypted.response === true) {
+                            headers = new Singleton_1.Singleton(function () { return headers_to_object(response.headers); });
+                            password = connection.encryption instanceof Function
+                                ? connection.encryption({ headers: headers.get(), body: body }, false)
+                                : connection.encryption;
+                            if (is_disabled(password, headers, body, false) === false)
+                                body = AesPkcs5_1.AesPkcs5.decrypt(body, password.key, password.iv);
+                        }
+                        ret = body;
+                        try {
+                            // PARSE RESPONSE BODY
+                            ret = JSON.parse(ret);
+                            // FIND __SET_HEADERS__ FIELD
+                            if (ret.__set_headers__ !== undefined &&
+                                typeof ret.__set_headers__ === "object") {
+                                if (connection.headers === undefined)
+                                    connection.headers = {};
+                                Object.assign(connection.headers, ret.__set_headers__);
+                            }
+                        }
+                        catch (_b) { }
+                        // RETURNS
+                        return [2 /*return*/, ret];
+                }
+            });
+        });
+    };
+    return Fetcher;
+}());
+exports.Fetcher = Fetcher;
+var polyfill = new Singleton_1.Singleton(function () { return __awaiter(void 0, void 0, void 0, function () {
+    var _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                if (!(typeof global === "object" &&
+                    typeof global.process === "object" &&
+                    typeof global.process.versions === "object" &&
+                    typeof global.process.versions.node !== undefined)) return [3 /*break*/, 3];
+                if (!(global.fetch === undefined)) return [3 /*break*/, 2];
+                _a = global;
+                return [4 /*yield*/, (0, import2_1.default)("node-fetch")];
+            case 1:
+                _a.fetch = (_b.sent()).default;
+                _b.label = 2;
+            case 2: return [2 /*return*/, global.fetch];
+            case 3: return [2 /*return*/, window.fetch];
+        }
+    });
+}); });
+function is_disabled(password, headers, body, encoded) {
+    if (password.disabled === undefined)
+        return false;
+    if (typeof password.disabled === "function")
+        return password.disabled({
+            headers: headers.get(),
+            body: body,
+        }, encoded);
+    return password.disabled;
+}
+function headers_to_object(headers) {
+    var output = {};
+    headers.forEach(function (value, key) { return (output[key] = value); });
+    return output;
+}
+//# sourceMappingURL=Fetcher.js.map

package/lib/Fetcher.js.map

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

package/lib/HttpError.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HTTP Error.
+ *
+ * `HttpError` is a type of error class who've been thrown by the remote HTTP server.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare class HttpError extends Error {
+    readonly method: "GET" | "DELETE" | "POST" | "PUT" | "PATCH";
+    readonly path: string;
+    readonly status: number;
+    /**
+     * Initializer Constructor.
+     *
+     * @param method Method of the HTTP request.
+     * @param path Path of the HTTP request.
+     * @param status Status code from the remote HTTP server.
+     * @param message Error message from the remote HTTP server.
+     */
+    constructor(method: "GET" | "DELETE" | "POST" | "PUT" | "PATCH", path: string, status: number, message: string);
+}

package/lib/HttpError.js

@@ -0,0 +1,53 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = void 0;
+/**
+ * HTTP Error.
+ *
+ * `HttpError` is a type of error class who've been thrown by the remote HTTP server.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var HttpError = /** @class */ (function (_super) {
+    __extends(HttpError, _super);
+    /**
+     * Initializer Constructor.
+     *
+     * @param method Method of the HTTP request.
+     * @param path Path of the HTTP request.
+     * @param status Status code from the remote HTTP server.
+     * @param message Error message from the remote HTTP server.
+     */
+    function HttpError(method, path, status, message) {
+        var _newTarget = this.constructor;
+        var _this = _super.call(this, message) || this;
+        _this.method = method;
+        _this.path = path;
+        _this.status = status;
+        // INHERITANCE POLYFILL
+        var proto = _newTarget.prototype;
+        if (Object.setPrototypeOf)
+            Object.setPrototypeOf(_this, proto);
+        else
+            _this.__proto__ = proto;
+        return _this;
+    }
+    return HttpError;
+}(Error));
+exports.HttpError = HttpError;
+//# sourceMappingURL=HttpError.js.map

package/lib/HttpError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpError.js","sourceRoot":"","sources":["../src/HttpError.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH;IAA+B,6BAAK;IAChC;;;;;;;OAOG;IACH,mBACoB,MAAmD,EACnD,IAAY,EACZ,MAAc,EAC9B,OAAe;;QAJnB,YAMI,kBAAM,OAAO,CAAC,SAMjB;QAXmB,YAAM,GAAN,MAAM,CAA6C;QACnD,UAAI,GAAJ,IAAI,CAAQ;QACZ,YAAM,GAAN,MAAM,CAAQ;QAK9B,uBAAuB;QACvB,IAAM,KAAK,GAAc,WAAW,SAAS,CAAC;QAC9C,IAAI,MAAM,CAAC,cAAc;YAAE,MAAM,CAAC,cAAc,CAAC,KAAI,EAAE,KAAK,CAAC,CAAC;;YACxD,KAAY,CAAC,SAAS,GAAG,KAAK,CAAC;;IACzC,CAAC;IACL,gBAAC;AAAD,CAAC,AAtBD,CAA+B,KAAK,GAsBnC;AAtBY,8BAAS"}

package/lib/IConnection.d.ts

@@ -0,0 +1,29 @@
+import { IEncryptionPassword } from "./IEncryptionPassword";
+/**
+ * Connection information.
+ *
+ * `IConnection` is a type of interface who represents connection information of the remote
+ * HTTP server. You can target the remote HTTP server by wring the {@link IConnection.host}
+ * variable down. Also, you can configure special header values by specializing the
+ * {@link IConnection.headers} variable.
+ *
+ * If the remote HTTP server encrypts or decrypts its body data through the AES-128/256
+ * algorithm, specify the {@link IConnection.encryption} with {@link IEncryptionPassword}
+ * or {@link IEncryptionPassword.Closure} variable.
+ *
+ * @author Jenogho Nam - https://github.com/samchon
+ */
+export interface IConnection {
+    /**
+     * Host address of the remote HTTP server.
+     */
+    host: string;
+    /**
+     * Header values delivered to the remote HTTP server.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Encryption password of its closure function.
+     */
+    encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
+}

package/lib/IConnection.js

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

package/lib/IConnection.js.map

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

package/lib/IEncryptionPassword.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Encryption password.
+ *
+ * `IEncryptionPassword` is a type of interface who represents encryption password used by
+ * the {@link Fetcher} with AES-128/256 algorithm. If your encryption password is not fixed
+ * but changes according to the input content, you can utilize the
+ * {@link IEncryptionPassword.Closure} function type.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IEncryptionPassword {
+    /**
+     * Secret key.
+     */
+    key: string;
+    /**
+     * Initialization vector.
+     */
+    iv: string;
+    /**
+     * Disable encryption to let content as plain.
+     *
+     * When you configure this `disabled` variable to be `false`, encryption and decryption
+     * algorithm would be disabled. Therefore, content like request or response body
+     * would be considered as a plain text instead.
+     *
+     * Default is `false`.
+     */
+    disabled?: boolean | ((param: IEncryptionPassword.IParameter, encoded: boolean) => boolean);
+}
+export declare namespace IEncryptionPassword {
+    /**
+     * Type of a closure function returning the {@link IEncryptionPassword} object.
+     *
+     * `IEncryptionPassword.Closure` is a type of closure function who are returning the
+     * {@link IEncryptionPassword} object. It would be used when your encryption password
+     * be changed according to the input content.
+     */
+    interface Closure {
+        /**
+         * Encryption password getter.
+         *
+         * @param param Request or response headers and body content
+         * @param encoded Be encoded or to be decoded
+         * @returns Encryption password
+         */
+        (param: IParameter, encoded: boolean): IEncryptionPassword;
+    }
+    /**
+     * Parameter for the closure.
+     */
+    interface IParameter {
+        headers: Record<string, string>;
+        body: string;
+    }
+}

package/lib/IEncryptionPassword.js

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

package/lib/IEncryptionPassword.js.map

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