@nestia/fetcher 1.6.7 → 2.0.0-dev.20230830

package/lib/AesPkcs5.js.map

@@ -1 +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,wBAAR,QAAQ,QAsCxB"}
+{"version":3,"file":"AesPkcs5.js","sourceRoot":"","sources":["../src/AesPkcs5.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA4B;AAE5B;;;;;;;;;GASG;AACH,IAAiB,QAAQ,CAqCxB;AArCD,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;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1E,CAAC;IARe,gBAAO,UAQtB,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,EArCgB,QAAQ,wBAAR,QAAQ,QAqCxB"}

package/lib/EncryptedFetcher.d.ts

@@ -0,0 +1,43 @@
+import { IConnection } from "./IConnection";
+import { Primitive } from "./Primitive";
+import { IFetchRoute } from "./internal/IFetchRoute";
+/**
+ * Utility class for `fetch` functions used in `@nestia/sdk` with encryption.
+ *
+ * `EncryptedFetcher` is a utility class designed for SDK functions generated by
+ * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
+ * HTTP API encrypted by AES-PKCS algorithm. In other words, this is a collection of
+ * dedicated `fetch()` functions for `@nestia/sdk` with encryption.
+ *
+ * For reference, `EncryptedFetcher` class being used only when target controller
+ * method is encrypting body data by `@EncryptedRoute` or `@EncryptedBody` decorators.
+ * If those decorators are not used, {@link PlainFetcher} class would be used instead.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace EncryptedFetcher {
+    /**
+     * Fetch function only for `HEAD` method.
+     *
+     * @param connection Connection information for the remote HTTP server
+     * @param route Route information about the target API
+     * @return Nothing because of `HEAD` method
+     */
+    function fetch(connection: IConnection, route: IFetchRoute<"HEAD">): Promise<void>;
+    /**
+     * Fetch function only for `GET` method.
+     *
+     * @param connection Connection information for the remote HTTP server
+     * @param route Route information about the target API
+     * @return Response body data from the remote API
+     */
+    function fetch<Output>(connection: IConnection, route: IFetchRoute<"GET">): Promise<Primitive<Output>>;
+    /**
+     * Fetch function for the `POST`, `PUT`, `PATCH` and `DELETE` methods.
+     *
+     * @param connection Connection information for the remote HTTP server
+     * @param route Route information about the target API
+     * @return Response body data from the remote API
+     */
+    function fetch<Input, Output>(connection: IConnection, route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">, input?: Input, stringify?: (input: Input) => string): Promise<Primitive<Output>>;
+}

package/lib/EncryptedFetcher.js

@@ -0,0 +1,97 @@
+"use strict";
+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 (g && (g = 0, op[0] && (_ = 0)), _) 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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EncryptedFetcher = void 0;
+var AesPkcs5_1 = require("./AesPkcs5");
+var FetcherBase_1 = require("./internal/FetcherBase");
+/**
+ * Utility class for `fetch` functions used in `@nestia/sdk` with encryption.
+ *
+ * `EncryptedFetcher` is a utility class designed for SDK functions generated by
+ * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
+ * HTTP API encrypted by AES-PKCS algorithm. In other words, this is a collection of
+ * dedicated `fetch()` functions for `@nestia/sdk` with encryption.
+ *
+ * For reference, `EncryptedFetcher` class being used only when target controller
+ * method is encrypting body data by `@EncryptedRoute` or `@EncryptedBody` decorators.
+ * If those decorators are not used, {@link PlainFetcher} class would be used instead.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var EncryptedFetcher;
+(function (EncryptedFetcher) {
+    function fetch(connection, route, input, stringify) {
+        var _a, _b, _c, _d;
+        return __awaiter(this, void 0, void 0, function () {
+            var closure;
+            return __generator(this, function (_e) {
+                if ((((_a = route.request) === null || _a === void 0 ? void 0 : _a.encrypted) === true || ((_b = route.response) === null || _b === void 0 ? void 0 : _b.encrypted)) &&
+                    connection.encryption === undefined)
+                    throw new Error("Error on EncryptedFetcher.fetch(): the encryption password has not been configured.");
+                closure = typeof connection.encryption === "function"
+                    ? function (direction) {
+                        return function (headers, body) {
+                            return connection.encryption({
+                                headers: headers,
+                                body: body,
+                                direction: direction,
+                            });
+                        };
+                    }
+                    : function () { return function () { return connection.encryption; }; };
+                return [2 /*return*/, FetcherBase_1.FetcherBase.fetch({
+                        className: "EncryptedFetcher",
+                        encode: ((_c = route.request) === null || _c === void 0 ? void 0 : _c.encrypted) === true
+                            ? function (input, headers) {
+                                var p = closure("encode")(headers, input);
+                                return AesPkcs5_1.AesPkcs5.encrypt(input, p.key, p.iv);
+                            }
+                            : function (input) { return input; },
+                        decode: ((_d = route.response) === null || _d === void 0 ? void 0 : _d.encrypted) === true
+                            ? function (input, headers) {
+                                var p = closure("decode")(headers, input);
+                                return JSON.parse(AesPkcs5_1.AesPkcs5.decrypt(input, p.key, p.iv));
+                            }
+                            : function (input) { return input; },
+                    })(connection, route, input, stringify)];
+            });
+        });
+    }
+    EncryptedFetcher.fetch = fetch;
+})(EncryptedFetcher || (exports.EncryptedFetcher = EncryptedFetcher = {}));
+//# sourceMappingURL=EncryptedFetcher.js.map

package/lib/EncryptedFetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncryptedFetcher.js","sourceRoot":"","sources":["../src/EncryptedFetcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAsC;AAItC,sDAAqD;AAGrD;;;;;;;;;;;;;GAaG;AACH,IAAiB,gBAAgB,CA6FhC;AA7FD,WAAiB,gBAAgB;IAuC7B,SAAsB,KAAK,CACvB,UAAuB,EACvB,KAEC,EACD,KAAa,EACb,SAAoC;;;;;gBAEpC,IACI,CAAC,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,SAAS,MAAK,IAAI,KAAI,MAAA,KAAK,CAAC,QAAQ,0CAAE,SAAS,CAAA,CAAC;oBAChE,UAAU,CAAC,UAAU,KAAK,SAAS;oBAEnC,MAAM,IAAI,KAAK,CACX,qFAAqF,CACxF,CAAC;gBACA,OAAO,GACT,OAAO,UAAU,CAAC,UAAU,KAAK,UAAU;oBACvC,CAAC,CAAC,UAAC,SAA8B;wBAC3B,OAAA,UACI,OAGC,EACD,IAAY;4BAEZ,OACI,UAAU,CAAC,UACd,CAAC;gCACE,OAAO,SAAA;gCACP,IAAI,MAAA;gCACJ,SAAS,WAAA;6BACZ,CAAC;wBANF,CAME;oBAbN,CAaM;oBACZ,CAAC,CAAC,cAAM,OAAA,cAAM,OAAA,UAAU,CAAC,UAAiC,EAA5C,CAA4C,EAAlD,CAAkD,CAAC;gBAEnE,sBAAO,yBAAW,CAAC,KAAK,CAAC;wBACrB,SAAS,EAAE,kBAAkB;wBAC7B,MAAM,EACF,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,SAAS,MAAK,IAAI;4BAC7B,CAAC,CAAC,UAAC,KAAK,EAAE,OAAO;gCACX,IAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gCAC5C,OAAO,mBAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;4BAChD,CAAC;4BACH,CAAC,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,EAAL,CAAK;wBAC1B,MAAM,EACF,CAAA,MAAA,KAAK,CAAC,QAAQ,0CAAE,SAAS,MAAK,IAAI;4BAC9B,CAAC,CAAC,UAAC,KAAK,EAAE,OAAO;gCACX,IAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gCAC5C,OAAO,IAAI,CAAC,KAAK,CACb,mBAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CACvC,CAAC;4BACN,CAAC;4BACH,CAAC,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,EAAL,CAAK;qBAC7B,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAC;;;KAC3C;IArDqB,sBAAK,QAqD1B,CAAA;AACL,CAAC,EA7FgB,gBAAgB,gCAAhB,gBAAgB,QA6FhC"}

package/lib/IConnection.d.ts

@@ -25,10 +25,6 @@ export interface IConnection<Headers extends object = {}> {
      * Header values delivered to the remote HTTP server.
      */
     headers?: Record<string, IConnection.HeaderValue> & IConnection.Headerify<Headers>;
-    /**
-     * Encryption password of its closure function.
-     */
-    encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
     /**
      * Use simulation mode.
      *
@@ -49,6 +45,14 @@ export interface IConnection<Headers extends object = {}> {
      * Additional options for the `fetch` function.
      */
     options?: IConnection.IOptions;
+    /**
+     * Encryption password of its closure function.
+     *
+     * Define it only when target backend server is encrypting body data through
+     * `@EncryptedRoute` or `@EncryptedBody` decorators of `@nestia/core` for
+     * security reason.
+     */
+    encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
 }
 export declare namespace IConnection {
     /**

package/lib/IEncryptionPassword.d.ts

@@ -1,3 +1,4 @@
+import { IConnection } from "./IConnection";
 /**
  * Encryption password.
  *
@@ -30,17 +31,17 @@ export declare namespace IEncryptionPassword {
         /**
          * Encryption password getter.
          *
-         * @param param Request or response headers and body content
-         * @param encoded Be encoded or to be decoded
+         * @param props Properties for predication
          * @returns Encryption password
          */
-        (param: IParameter, encoded: boolean): IEncryptionPassword;
+        (props: IProps): IEncryptionPassword;
     }
     /**
-     * Parameter for the closure.
+     * Properties for the closure.
      */
-    interface IParameter {
-        headers: Record<string, string>;
+    interface IProps {
+        headers: Record<string, IConnection.HeaderValue | undefined>;
         body: string;
+        direction: "encode" | "decode";
     }
 }

package/lib/PlainFetcher.d.ts

@@ -0,0 +1,44 @@
+import { IConnection } from "./IConnection";
+import { Primitive } from "./Primitive";
+import { IFetchRoute } from "./internal/IFetchRoute";
+/**
+ * Utility class for `fetch` functions used in `@nestia/sdk`.
+ *
+ * `PlainFetcher` is a utility class designed for SDK functions generated by
+ * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
+ * HTTP sever API. In other words, this is a collection of dedicated `fetch()`
+ * functions for `@nestia/sdk`.
+ *
+ * For reference, `PlainFetcher` class does not encrypt or decrypt the body data
+ * at all. It just delivers plain data without any post processing. If you've
+ * defined a controller method through `@EncryptedRoute` or `@EncryptedBody`
+ * decorator, then {@liink EncryptedFetcher} class would be used instead.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace PlainFetcher {
+    /**
+     * Fetch function only for `HEAD` method.
+     *
+     * @param connection Connection information for the remote HTTP server
+     * @param route Route information about the target API
+     * @return Nothing because of `HEAD` method
+     */
+    function fetch(connection: IConnection, route: IFetchRoute<"HEAD">): Promise<void>;
+    /**
+     * Fetch function only for `GET` method.
+     *
+     * @param connection Connection information for the remote HTTP server
+     * @param route Route information about the target API
+     * @return Response body data from the remote API
+     */
+    function fetch<Output>(connection: IConnection, route: IFetchRoute<"GET">): Promise<Primitive<Output>>;
+    /**
+     * Fetch function for the `POST`, `PUT`, `PATCH` and `DELETE` methods.
+     *
+     * @param connection Connection information for the remote HTTP server
+     * @param route Route information about the target API
+     * @return Response body data from the remote API
+     */
+    function fetch<Input, Output>(connection: IConnection, route: IFetchRoute<"POST" | "PUT" | "PATCH" | "DELETE">, input?: Input, stringify?: (input: Input) => string): Promise<Primitive<Output>>;
+}

package/lib/PlainFetcher.js

@@ -0,0 +1,75 @@
+"use strict";
+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 (g && (g = 0, op[0] && (_ = 0)), _) 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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlainFetcher = void 0;
+var FetcherBase_1 = require("./internal/FetcherBase");
+/**
+ * Utility class for `fetch` functions used in `@nestia/sdk`.
+ *
+ * `PlainFetcher` is a utility class designed for SDK functions generated by
+ * [`@nestia/sdk`](https://nestia.io/docs/sdk/sdk), interacting with the remote
+ * HTTP sever API. In other words, this is a collection of dedicated `fetch()`
+ * functions for `@nestia/sdk`.
+ *
+ * For reference, `PlainFetcher` class does not encrypt or decrypt the body data
+ * at all. It just delivers plain data without any post processing. If you've
+ * defined a controller method through `@EncryptedRoute` or `@EncryptedBody`
+ * decorator, then {@liink EncryptedFetcher} class would be used instead.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var PlainFetcher;
+(function (PlainFetcher) {
+    function fetch(connection, route, input, stringify) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_c) {
+                if (((_a = route.request) === null || _a === void 0 ? void 0 : _a.encrypted) === true ||
+                    ((_b = route.response) === null || _b === void 0 ? void 0 : _b.encrypted) === true)
+                    throw new Error("Error on PlainFetcher.fetch(): PlainFetcher doesn't have encryption ability. Use EncryptedFetcher instead.");
+                return [2 /*return*/, FetcherBase_1.FetcherBase.fetch({
+                        className: "PlainFetcher",
+                        encode: function (input) { return input; },
+                        decode: function (input) { return input; },
+                    })(connection, route, input, stringify)];
+            });
+        });
+    }
+    PlainFetcher.fetch = fetch;
+})(PlainFetcher || (exports.PlainFetcher = PlainFetcher = {}));
+//# sourceMappingURL=PlainFetcher.js.map

package/lib/PlainFetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlainFetcher.js","sourceRoot":"","sources":["../src/PlainFetcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,sDAAqD;AAErD;;;;;;;;;;;;;;GAcG;AACH,IAAiB,YAAY,CA4D5B;AA5DD,WAAiB,YAAY;IAuCzB,SAAsB,KAAK,CACvB,UAAuB,EACvB,KAEC,EACD,KAAa,EACb,SAAoC;;;;gBAEpC,IACI,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,SAAS,MAAK,IAAI;oBACjC,CAAA,MAAA,KAAK,CAAC,QAAQ,0CAAE,SAAS,MAAK,IAAI;oBAElC,MAAM,IAAI,KAAK,CACX,4GAA4G,CAC/G,CAAC;gBACN,sBAAO,yBAAW,CAAC,KAAK,CAAC;wBACrB,SAAS,EAAE,cAAc;wBACzB,MAAM,EAAE,UAAC,KAAK,IAAK,OAAA,KAAK,EAAL,CAAK;wBACxB,MAAM,EAAE,UAAC,KAAK,IAAK,OAAA,KAAK,EAAL,CAAK;qBAC3B,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAC;;;KAC3C;IApBqB,kBAAK,QAoB1B,CAAA;AACL,CAAC,EA5DgB,YAAY,4BAAZ,YAAY,QA4D5B"}

package/lib/index.d.ts

@@ -1,6 +1,3 @@
 export * from "./IConnection";
-export * from "./IEncryptionPassword";
 export * from "./Primitive";
-export * from "./AesPkcs5";
-export * from "./Fetcher";
 export * from "./HttpError";

package/lib/index.js

@@ -15,9 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./IConnection"), exports);
-__exportStar(require("./IEncryptionPassword"), exports);
 __exportStar(require("./Primitive"), exports);
-__exportStar(require("./AesPkcs5"), exports);
-__exportStar(require("./Fetcher"), exports);
 __exportStar(require("./HttpError"), exports);
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,wDAAsC;AACtC,8CAA4B;AAE5B,6CAA2B;AAC3B,4CAA0B;AAC1B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,8CAA4B;AAC5B,8CAA4B"}

package/lib/internal/FetcherBase.d.ts

@@ -0,0 +1,11 @@
+import { IConnection } from "../IConnection";
+import { Primitive } from "../Primitive";
+import { IFetchRoute } from "./IFetchRoute";
+export declare namespace FetcherBase {
+    interface IProps {
+        className: string;
+        encode: (input: string, headers: Record<string, IConnection.HeaderValue | undefined>) => string;
+        decode: (input: string, headers: Record<string, IConnection.HeaderValue | undefined>) => any;
+    }
+    const fetch: (props: IProps) => <Input, Output>(connection: IConnection, route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">, input?: Input | undefined, stringify?: ((input: Input) => string) | undefined) => Promise<Primitive<Output>>;
+}

package/lib/{Fetcher.js → internal/FetcherBase.js}

@@ -73,48 +73,40 @@ var __read = (this && this.__read) || function (o, n) {
     }
     return ar;
 };
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Fetcher = void 0;
+exports.FetcherBase = 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) {
-        var _a, _b, _c, _d, _e;
-        return __awaiter(this, void 0, void 0, function () {
-            var headers, init, url, response, text, content, ret;
-            return __generator(this, function (_f) {
-                switch (_f.label) {
+var Singleton_1 = require("./Singleton");
+var HttpError_1 = require("../HttpError");
+var FetcherBase;
+(function (FetcherBase) {
+    var _this = this;
+    FetcherBase.fetch = function (props) {
+        return function (connection, route, input, stringify) { return __awaiter(_this, void 0, void 0, function () {
+            var headers, init, path, url, response, _a, _b, _c, _d;
+            var _e, _f, _g, _h, _j, _k, _l, _m;
+            return __generator(this, function (_o) {
+                switch (_o.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.");
-                        headers = __assign({}, ((_a = connection.headers) !== null && _a !== void 0 ? _a : {}));
-                        if (input !== undefined)
-                            (_b = headers["Content-Type"]) !== null && _b !== void 0 ? _b : (headers["Content-Type"] = encrypted.request === true || typeof input === "string"
-                                ? "text/plain"
-                                : "application/json");
-                        init = __assign(__assign({}, ((_c = connection.options) !== null && _c !== void 0 ? _c : {})), { method: method, headers: (function () {
+                        headers = __assign({}, ((_e = connection.headers) !== null && _e !== void 0 ? _e : {}));
+                        if (input !== undefined) {
+                            if (((_f = route.request) === null || _f === void 0 ? void 0 : _f.type) === undefined)
+                                throw new Error("Error on ".concat(props.className, ".fetch(): no content-type being configured."));
+                            headers["Content-Type"] = route.request.type;
+                        }
+                        init = __assign(__assign({}, ((_g = connection.options) !== null && _g !== void 0 ? _g : {})), { method: route.method, headers: (function () {
                                 var e_1, _a, e_2, _b;
                                 var output = [];
                                 try {
@@ -148,80 +140,53 @@ var Fetcher = /** @class */ (function () {
                                     finally { if (e_1) throw e_1.error; }
                                 }
                                 return output;
-                            })() });
-                        // REQUEST BODY (WITH ENCRYPTION)
-                        if (input !== undefined)
-                            init.body = (function () {
-                                var json = encrypted.request === true ||
-                                    headers["Content-Type"] !== "text/plain"
+                            })(), body: input !== undefined
+                                ? props.encode(
+                                // BODY TRANSFORM
+                                ((_h = route.request) === null || _h === void 0 ? void 0 : _h.type) !== "text/plain"
                                     ? (stringify !== null && stringify !== void 0 ? stringify : JSON.stringify)(input)
-                                    : String(input);
-                                if (encrypted.request !== true)
-                                    return json;
-                                var password = connection.encryption instanceof Function
-                                    ? connection.encryption({
-                                        headers: init.headers,
-                                        body: json,
-                                    }, true)
-                                    : connection.encryption;
-                                return AesPkcs5_1.AesPkcs5.encrypt(json, password.key, password.iv);
-                            })();
-                        //----
-                        // RESPONSE MESSAGE
-                        //----
-                        // URL SPECIFICATION
-                        if (connection.host[connection.host.length - 1] !== "/" &&
-                            path[0] !== "/")
-                            path = "/" + path;
+                                    : String(input), headers)
+                                : undefined });
+                        path = connection.host[connection.host.length - 1] !== "/" &&
+                            route.path[0] !== "/"
+                            ? "/".concat(route.path)
+                            : route.path;
                         url = new URL("".concat(connection.host).concat(path));
                         return [4 /*yield*/, polyfill.get()];
-                    case 1: return [4 /*yield*/, (_f.sent())(url.href, init)];
+                    case 1: return [4 /*yield*/, (_o.sent())(url.href, init)];
                     case 2:
-                        response = _f.sent();
-                        return [4 /*yield*/, response.text()];
-                    case 3:
-                        text = (_d = (_f.sent())) !== null && _d !== void 0 ? _d : "";
-                        // CHECK THE STATUS CODE
-                        if ((encrypted.status !== undefined &&
-                            response.status !== encrypted.status) ||
-                            (encrypted.status === undefined &&
+                        response = _o.sent();
+                        if (!((route.status !== undefined &&
+                            route.status !== null &&
+                            response.status !== route.status) ||
+                            ((route.status === undefined || route.status === null) &&
                                 response.status !== 200 &&
-                                response.status !== 201))
-                            throw new HttpError_1.HttpError(method, path, response.status, text);
-                        //----
-                        // OUTPUT
-                        //----
-                        // HEAD METHOD CANNOT HAVE ANYTHING
-                        if (method === "HEAD")
-                            return [2 /*return*/, undefined];
-                        content = !encrypted.response || text.length === 0
-                            ? text
-                            : (function () {
-                                var password = connection.encryption instanceof Function
-                                    ? connection.encryption({
-                                        headers: headers_to_object(response.headers),
-                                        body: text,
-                                    }, false)
-                                    : connection.encryption;
-                                return AesPkcs5_1.AesPkcs5.decrypt(text, password.key, password.iv);
-                            })();
-                        ret = content;
-                        try {
-                            // PARSE RESPONSE BODY
-                            if (encrypted.response ||
-                                ((_e = response.headers.get("Content-Type")) !== null && _e !== void 0 ? _e : "").indexOf("application/json") !== -1)
-                                ret = content.length ? JSON.parse(content) : undefined;
-                        }
-                        catch (_g) { }
+                                response.status !== 201))) return [3 /*break*/, 4];
+                        _a = HttpError_1.HttpError.bind;
+                        _b = [void 0, route.method,
+                            path,
+                            response.status];
+                        return [4 /*yield*/, response.text()];
+                    case 3: throw new (_a.apply(HttpError_1.HttpError, _b.concat([_o.sent()])))();
+                    case 4:
+                        if (((_j = route.response) === null || _j === void 0 ? void 0 : _j.type) &&
+                            ((_l = ((_k = response.headers.get("content-type")) !== null && _k !== void 0 ? _k : "")) === null || _l === void 0 ? void 0 : _l.indexOf(route.response.type)) === -1)
+                            throw new Error("Error on ".concat(props.className, ".fetch(): response type mismatched - expected ").concat(route.response.type, ", but ").concat(response.headers.get("content-type"), "."));
+                        _o.label = 5;
+                    case 5:
                         // RETURNS
-                        return [2 /*return*/, ret];
+                        if (route.method === "HEAD")
+                            return [2 /*return*/, undefined];
+                        else if (((_m = route.response) === null || _m === void 0 ? void 0 : _m.type) === "application/json")
+                            return [2 /*return*/, response.json()];
+                        _d = (_c = props).decode;
+                        return [4 /*yield*/, response.text()];
+                    case 6: return [2 /*return*/, _d.apply(_c, [_o.sent(), response_headers_to_object(response.headers)])];
                 }
             });
-        });
+        }); };
     };
-    return Fetcher;
-}());
-exports.Fetcher = Fetcher;
+})(FetcherBase || (exports.FetcherBase = FetcherBase = {}));
 var polyfill = new Singleton_1.Singleton(function () { return __awaiter(void 0, void 0, void 0, function () {
     var _a;
     return __generator(this, function (_b) {
@@ -242,9 +207,18 @@ var polyfill = new Singleton_1.Singleton(function () { return __awaiter(void 0,
         }
     });
 }); });
-function headers_to_object(headers) {
+var response_headers_to_object = function (headers) {
     var output = {};
-    headers.forEach(function (value, key) { return (output[key] = value); });
+    headers.forEach(function (value, key) {
+        var _a;
+        var _b;
+        if (key === "set-cookie") {
+            (_b = output[key]) !== null && _b !== void 0 ? _b : (output[key] = []);
+            (_a = output[key]).push.apply(_a, __spreadArray([], __read(value.split(";").map(function (str) { return str.trim(); })), false));
+        }
+        else
+            output[key] = value;
+    });
     return output;
-}
-//# sourceMappingURL=Fetcher.js.map
+};
+//# sourceMappingURL=FetcherBase.js.map

package/lib/internal/FetcherBase.js.map

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

package/lib/internal/IFetchRoute.d.ts

@@ -0,0 +1,28 @@
+export interface IFetchRoute<Method extends "HEAD" | "GET" | "POST" | "PUT" | "PATCH" | "DELETE"> {
+    /**
+     * Method of the HTTP request.
+     */
+    method: Method;
+    /**
+     * Path of the HTTP request.
+     */
+    path: string;
+    /**
+     * Request body data info.
+     */
+    request: Method extends "DELETE" | "POST" | "PUT" | "PATCH" ? IRoute.IBody | null : null;
+    /**
+     * Response body data info.
+     */
+    response: Method extends "HEAD" ? null : IRoute.IBody;
+    /**
+     * When special status code being used.
+     */
+    status?: null | number;
+}
+export declare namespace IRoute {
+    interface IBody {
+        type: "application/json" | "text/plain";
+        encrypted?: boolean;
+    }
+}