@nestia/fetcher 2.0.0-dev.20230991 → 2.0.1

package/lib/EncryptedFetcher.d.ts

@@ -1,4 +1,5 @@
 import { IConnection } from "./IConnection";
+import { IPropagation } from "./IPropagation";
 import { Primitive } from "./Primitive";
 import { IFetchRoute } from "./internal/IFetchRoute";
 /**
@@ -40,4 +41,6 @@ export declare namespace EncryptedFetcher {
      * @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>>;
+    function propagate<Output extends IPropagation<any, any>>(connection: IConnection, route: IFetchRoute<"GET" | "HEAD">): Promise<Output>;
+    function propagate<Input, Output extends IPropagation<any, any>>(connection: IConnection, route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">, input?: Input, stringify?: (input: Input) => string): Promise<Output>;
 }

package/lib/EncryptedFetcher.js

@@ -94,5 +94,44 @@ var EncryptedFetcher;
         });
     }
     EncryptedFetcher.fetch = fetch;
+    function propagate(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.propagate(): 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.propagate({
+                        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(JSON.stringify(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);
+                                var str = AesPkcs5_1.AesPkcs5.decrypt(input, p.key, p.iv);
+                                return str.length ? JSON.parse(str) : str;
+                            }
+                            : function (input) { return input; },
+                    })(connection, route, input, stringify)];
+            });
+        });
+    }
+    EncryptedFetcher.propagate = propagate;
 })(EncryptedFetcher || (exports.EncryptedFetcher = EncryptedFetcher = {}));
 //# sourceMappingURL=EncryptedFetcher.js.map

package/lib/EncryptedFetcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"EncryptedFetcher.js","sourceRoot":"","sources":["../src/EncryptedFetcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAsC;AAItC,sDAAqD;AAGrD;;;;;;;;;;;;;GAaG;AACH,IAAiB,gBAAgB,CAgGhC;AAhGD,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,CACnB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EACrB,CAAC,CAAC,GAAG,EACL,CAAC,CAAC,EAAE,CACP,CAAC;4BACN,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,IAAM,GAAG,GAAG,mBAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gCACjD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;4BAC9C,CAAC;4BACH,CAAC,CAAC,UAAC,KAAK,IAAK,OAAA,KAAK,EAAL,CAAK;qBAC7B,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAC;;;KAC3C;IAxDqB,sBAAK,QAwD1B,CAAA;AACL,CAAC,EAhGgB,gBAAgB,gCAAhB,gBAAgB,QAgGhC"}
+{"version":3,"file":"EncryptedFetcher.js","sourceRoot":"","sources":["../src/EncryptedFetcher.ts"],"names":[],"mappings":"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"}

package/lib/HttpError.d.ts

@@ -9,6 +9,7 @@ export declare class HttpError extends Error {
     readonly method: "GET" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD";
     readonly path: string;
     readonly status: number;
+    readonly headers: Record<string, string | string[]>;
     /**
      * Initializer Constructor.
      *
@@ -17,7 +18,7 @@ export declare class HttpError extends Error {
      * @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" | "HEAD", path: string, status: number, message: string);
+    constructor(method: "GET" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD", path: string, status: number, headers: Record<string, string | string[]>, message: string);
     /**
      * `HttpError` to JSON.
      *
@@ -41,6 +42,7 @@ export declare namespace HttpError {
         method: "GET" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD";
         path: string;
         status: number;
+        headers: Record<string, string | string[]>;
         message: T;
     }
 }

package/lib/HttpError.js

@@ -33,12 +33,13 @@ var HttpError = /** @class */ (function (_super) {
      * @param status Status code from the remote HTTP server.
      * @param message Error message from the remote HTTP server.
      */
-    function HttpError(method, path, status, message) {
+    function HttpError(method, path, status, headers, message) {
         var _newTarget = this.constructor;
         var _this = _super.call(this, message) || this;
         _this.method = method;
         _this.path = path;
         _this.status = status;
+        _this.headers = headers;
         /**
          * @internal
          */
@@ -76,6 +77,7 @@ var HttpError = /** @class */ (function (_super) {
             method: this.method,
             path: this.path,
             status: this.status,
+            headers: this.headers,
             message: this.body_,
         };
     };

package/lib/HttpError.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpError.js","sourceRoot":"","sources":["../src/HttpError.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH;IAA+B,6BAAK;IAMhC;;;;;;;OAOG;IACH,mBACoB,MAMJ,EACI,IAAY,EACZ,MAAc,EAC9B,OAAe;;QAVnB,YAYI,kBAAM,OAAO,CAAC,SAMjB;QAjBmB,YAAM,GAAN,MAAM,CAMV;QACI,UAAI,GAAJ,IAAI,CAAQ;QACZ,YAAM,GAAN,MAAM,CAAQ;QAtBlC;;WAEG;QACK,WAAK,GAAQ,OAAO,CAAC;QAwBzB,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;IAED;;;;;;;;;;;;OAYG;IACI,0BAAM,GAAb;QACI,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO;YACtB,IAAI;gBACA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;aACzC;YAAC,WAAM;gBACJ,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;aAC7B;QACL,OAAO;YACH,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,KAAK;SACtB,CAAC;IACN,CAAC;IACL,gBAAC;AAAD,CAAC,AA7DD,CAA+B,KAAK,GA6DnC;AA7DY,8BAAS;AA0EtB,IAAM,OAAO,GAAG,EAAS,CAAC"}
+{"version":3,"file":"HttpError.js","sourceRoot":"","sources":["../src/HttpError.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH;IAA+B,6BAAK;IAMhC;;;;;;;OAOG;IACH,mBACoB,MAMJ,EACI,IAAY,EACZ,MAAc,EACd,OAA0C,EAC1D,OAAe;;QAXnB,YAaI,kBAAM,OAAO,CAAC,SAMjB;QAlBmB,YAAM,GAAN,MAAM,CAMV;QACI,UAAI,GAAJ,IAAI,CAAQ;QACZ,YAAM,GAAN,MAAM,CAAQ;QACd,aAAO,GAAP,OAAO,CAAmC;QAvB9D;;WAEG;QACK,WAAK,GAAQ,OAAO,CAAC;QAyBzB,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;IAED;;;;;;;;;;;;OAYG;IACI,0BAAM,GAAb;QACI,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO;YACtB,IAAI;gBACA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;aACzC;YAAC,WAAM;gBACJ,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;aAC7B;QACL,OAAO;YACH,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,KAAK;SACtB,CAAC;IACN,CAAC;IACL,gBAAC;AAAD,CAAC,AA/DD,CAA+B,KAAK,GA+DnC;AA/DY,8BAAS;AA6EtB,IAAM,OAAO,GAAG,EAAS,CAAC"}

package/lib/IPropagation.d.ts

@@ -0,0 +1,71 @@
+import { Primitive } from "./Primitive";
+/**
+ * Propagation type.
+ *
+ * `IPropagation` is a type gathering all possible status codes and their body
+ * data types as a discriminated union type. You can specify the status code and
+ * its body data type just by using conditional statement like below.
+ *
+ * ```typescript
+ * type Output = IPropagation<{
+ *    200: ISeller.IAuthorized;
+ *    400: TypeGuardError.IProps;
+ * >};
+ *
+ * const output: Output = await sdk.sellers.authenticate.join(input);
+ * if (output.success) {
+ *     // automatically casted to "ISeller.IAuthorized" type
+ *     const authorized: ISeller.IAuthorized = output.data;
+ * } else if (output.status === 400) {
+ *     // automatically casted to "TypeGuardError.IProps" type
+ *     const error: TypeGuardError.IProps = output.data;
+ * } else {
+ *     // unknown type when out of pre-defined status codes
+ *     const result: unknown = output.data;
+ * }
+ * ```
+ *
+ * For reference, this `IPropagation` type is utilized by SDK library generated by
+ * `@nestia/sdk`, when you've configured {@link INestiaConfig.propagate} to be `true`.
+ * In that case, SDK functions generated by `@nestia/sdk` no more returns response DTO
+ * typed data directly, but returns this `IPropagation` typed object instead.
+ *
+ * @template StatusMap Map of status code and its body data type.
+ * @template Success Default success status code.
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type IPropagation<StatusMap extends {
+    [P in IPropagation.Status]?: any;
+}, Success extends number = 200 | 201> = {
+    [P in keyof StatusMap]: IPropagation.IBranch<P extends Success ? true : false, P, StatusMap[P]>;
+}[keyof StatusMap] | IPropagation.IBranch<false, unknown, unknown>;
+export declare namespace IPropagation {
+    /**
+     * Type of configurable status codes.
+     *
+     * The special characters like `2XX`, `3XX`, `4XX`, `5XX` are meaning the range
+     * of status codes. If `5XX` is specified, it means the status code is in the
+     * range of `500` to `599`.
+     */
+    export type Status = number | "2XX" | "3XX" | "4XX" | "5XX";
+    /**
+     * Branch type of propagation.
+     *
+     * `IPropagation.IBranch` is a branch type composing `IPropagation` type,
+     * which is gathering all possible status codes and their body data types
+     * as a union type.
+     */
+    export interface IBranch<Success extends boolean, StatusValue, BodyData> {
+        success: Success;
+        status: StatusValue extends "2XX" | "3XX" | "4XX" | "5XX" ? StatusRange<StatusValue> : StatusValue extends number ? StatusValue : never;
+        data: Primitive<BodyData>;
+        headers: Record<string, string | string[]>;
+    }
+    /**
+     * Range of status codes by the first digit.
+     */
+    export type StatusRange<T extends "2XX" | "3XX" | "4XX" | "5XX"> = T extends 0 ? IntRange<200, 299> : T extends 3 ? IntRange<300, 399> : T extends 4 ? IntRange<400, 499> : IntRange<500, 599>;
+    type IntRange<F extends number, T extends number> = Exclude<Enumerate<T>, Enumerate<F>>;
+    type Enumerate<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? Acc[number] : Enumerate<N, [...Acc, Acc["length"]]>;
+    export {};
+}

package/lib/IPropagation.js

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

package/lib/IPropagation.js.map

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

package/lib/PlainFetcher.d.ts

@@ -1,6 +1,7 @@
 import { IConnection } from "./IConnection";
 import { Primitive } from "./Primitive";
 import { IFetchRoute } from "./internal/IFetchRoute";
+import { IPropagation } from "./IPropagation";
 /**
  * Utility class for `fetch` functions used in `@nestia/sdk`.
  *
@@ -41,4 +42,6 @@ export declare namespace PlainFetcher {
      * @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>>;
+    function propagate<Output extends IPropagation<any, any>>(connection: IConnection, route: IFetchRoute<"GET" | "HEAD">): Promise<Output>;
+    function propagate<Input, Output extends IPropagation<any, any>>(connection: IConnection, route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">, input?: Input, stringify?: (input: Input) => string): Promise<Output>;
 }

package/lib/PlainFetcher.js

@@ -71,5 +71,21 @@ var PlainFetcher;
         });
     }
     PlainFetcher.fetch = fetch;
+    function propagate(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.propagate(): PlainFetcher doesn't have encryption ability. Use EncryptedFetcher instead.");
+                return [2 /*return*/, FetcherBase_1.FetcherBase.propagate({
+                        className: "PlainFetcher",
+                        encode: function (input) { return input; },
+                        decode: function (input) { return input; },
+                    })(connection, route, input, stringify)];
+            });
+        });
+    }
+    PlainFetcher.propagate = propagate;
 })(PlainFetcher || (exports.PlainFetcher = PlainFetcher = {}));
 //# sourceMappingURL=PlainFetcher.js.map

package/lib/PlainFetcher.js.map

@@ -1 +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"}
+{"version":3,"file":"PlainFetcher.js","sourceRoot":"","sources":["../src/PlainFetcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,sDAAqD;AAGrD;;;;;;;;;;;;;;GAcG;AACH,IAAiB,YAAY,CAmG5B;AAnGD,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;IAgBD,SAAsB,SAAS,CAI3B,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,gHAAgH,CACnH,CAAC;gBACN,sBAAO,yBAAW,CAAC,SAAS,CAAC;wBACzB,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,CAAoB,EAAC;;;KAC9D;IAvBqB,sBAAS,YAuB9B,CAAA;AACL,CAAC,EAnGgB,YAAY,4BAAZ,YAAY,QAmG5B"}

package/lib/Primitive.d.ts

@@ -1,16 +1,17 @@
 /**
- * Primitive type.
+ * Primitive type of JSON.
  *
- * `Primitive` is a type of TMP (Type Meta Programming) type who converts its argument as a
- * primitive type.
+ * `Primitive<T>` is a TMP (Type Meta Programming) type which converts
+ * its argument as a primitive type within framework JSON.
  *
- * If the target argument is a built-in class who returns its origin primitive type through
- * the `valueOf()` method like the `String` or `Number`, its return type would be the
- * `string` or `number`.
+ * If the target argument is a built-in class which returns its origin primitive type
+ * through the `valueOf()` method like the `String` or `Number`, its return type would
+ * be the `string` or `number`. Otherwise, the built-in class does not have the
+ * `valueOf()` method, the return type would be an empty object (`{}`).
  *
- * Otherwise, the target argument is a type of custom class, all of its custom method would
- * be erased and its prototype would be changed to the primitive `object`. Therefore, return
- * type of the TMP type finally be the primitive object.
+ * Otherwise, the target argument is a type of custom class, all of its custom method
+ * would be erased and its prototype would be changed to the primitive `object`.
+ * Therefore, return type of the TMP type finally be the primitive object.
  *
  * In addition, if the target argument is a type of custom class and it has a special
  * method `toJSON()`, return type of this `Primitive` would be not `Primitive<Instance>`
@@ -23,18 +24,19 @@
  * `String`                | `string`
  * `Class`                 | `object`
  * `Class` with `toJSON()` | `Primitive<ReturnType<Class.toJSON>>`
+ * Native Class            | `{}`
  * Others                  | No change
  *
  * @template Instance Target argument type.
- * @author Jenogho Nam - https://github.com/samchon
+ * @author Jeongho Nam - https://github.com/samchon
  * @author Kyungsu Kang - https://github.com/kakasoo
  * @author Michael - https://github.com/8471919
  */
 export type Primitive<T> = Equal<T, PrimitiveMain<T>> extends true ? T : PrimitiveMain<T>;
 type Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;
-type PrimitiveMain<Instance> = Instance extends [never] ? never : ValueOf<Instance> extends boolean | number | bigint | string ? ValueOf<Instance> : ValueOf<Instance> extends object ? Instance extends object ? Instance extends NativeClass ? {} : Instance extends IJsonable<infer Raw> ? ValueOf<Raw> extends object ? Raw extends object ? PrimitiveObject<Raw> : never : ValueOf<Raw> : PrimitiveObject<Instance> : never : ValueOf<Instance>;
+type PrimitiveMain<Instance> = Instance extends [never] ? never : ValueOf<Instance> extends bigint ? never : ValueOf<Instance> extends boolean | number | string ? ValueOf<Instance> : Instance extends Function ? never : ValueOf<Instance> extends object ? Instance extends object ? Instance extends NativeClass ? {} : Instance extends IJsonable<infer Raw> ? ValueOf<Raw> extends object ? Raw extends object ? PrimitiveObject<Raw> : never : ValueOf<Raw> : PrimitiveObject<Instance> : never : ValueOf<Instance>;
 type PrimitiveObject<Instance extends object> = Instance extends Array<infer T> ? IsTuple<Instance> extends true ? PrimitiveTuple<Instance> : PrimitiveMain<T>[] : {
-    [P in keyof Instance]: Instance[P] extends Function ? never : PrimitiveMain<Instance[P]>;
+    [P in keyof Instance]: PrimitiveMain<Instance[P]>;
 };
 type PrimitiveTuple<T extends readonly any[]> = T extends [] ? [] : T extends [infer F] ? [PrimitiveMain<F>] : T extends [infer F, ...infer Rest extends readonly any[]] ? [PrimitiveMain<F>, ...PrimitiveTuple<Rest>] : T extends [(infer F)?] ? [PrimitiveMain<F>?] : T extends [(infer F)?, ...infer Rest extends readonly any[]] ? [PrimitiveMain<F>?, ...PrimitiveTuple<Rest>] : [];
 type ValueOf<Instance> = IsValueOf<Instance, Boolean> extends true ? boolean : IsValueOf<Instance, Number> extends true ? number : IsValueOf<Instance, String> extends true ? string : Instance;
@@ -44,7 +46,7 @@ type IsTuple<T extends readonly any[] | {
 }> = [T] extends [
     never
 ] ? false : T extends readonly any[] ? number extends T["length"] ? false : true : false;
-type IsValueOf<Instance, Object extends IValueOf<any>> = Instance extends Object ? Object extends IValueOf<infer Primitive> ? Instance extends Primitive ? false : true : false : false;
+type IsValueOf<Instance, Object extends IValueOf<any>> = Instance extends Object ? Object extends IValueOf<infer U> ? Instance extends U ? false : true : false : false;
 interface IValueOf<T> {
     valueOf(): T;
 }

package/lib/Resolved.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Resolved type erased every methods.
+ *
+ * `Resolved` is a type of TMP (Type Meta Programming) type which converts
+ * its argument as a resolved type that erased every method properties.
+ *
+ * If the target argument is a built-in class which returns its origin primitive type
+ * through the `valueOf()` method like the `String` or `Number`, its return type would
+ * be the `string` or `number`. Otherwise, the built-in class does not have the
+ * `valueOf()` method, the return type would be same with the target argument.
+ *
+ * Otherwise, the target argument is a type of custom class, all of its custom methods
+ * would be erased and its prototype would be changed to the primitive `object`.
+ * Therefore, return type of the TMP type finally be the resolved object.
+ *
+ * Before                  | After
+ * ------------------------|----------------------------------------
+ * `Boolean`               | `boolean`
+ * `Number`                | `number`
+ * `BigInt`                | `bigint`
+ * `String`                | `string`
+ * `Class`                 | `interface`
+ * Native Class or Others  | No change
+ *
+ * @template Instance Target argument type.
+ * @author Jeongho Nam - https://github.com/samchon
+ * @author Kyungsu Kang - https://github.com/kakasoo
+ */
+export type Resolved<T> = Equal<T, ResolvedMain<T>> extends true ? T : ResolvedMain<T>;
+type Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;
+type ResolvedMain<Instance> = Instance extends [never] ? never : ValueOf<Instance> extends boolean | number | bigint | string ? ValueOf<Instance> : Instance extends Function ? never : Instance extends object ? ResolvedObject<Instance> : ValueOf<Instance>;
+type ResolvedObject<Instance extends object> = Instance extends Array<infer T> ? IsTuple<Instance> extends true ? ResolvedTuple<Instance> : ResolvedMain<T>[] : Instance extends Set<infer U> ? Set<ResolvedMain<U>> : Instance extends Map<infer K, infer V> ? Map<ResolvedMain<K>, ResolvedMain<V>> : Instance extends WeakSet<any> | WeakMap<any, any> ? never : Instance extends Date | Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array | BigUint64Array | Int8Array | Int16Array | Int32Array | BigInt64Array | Float32Array | Float64Array | ArrayBuffer | SharedArrayBuffer | DataView ? Instance : {
+    [P in keyof Instance]: ResolvedMain<Instance[P]>;
+};
+type ResolvedTuple<T extends readonly any[]> = T extends [] ? [] : T extends [infer F] ? [ResolvedMain<F>] : T extends [infer F, ...infer Rest extends readonly any[]] ? [ResolvedMain<F>, ...ResolvedTuple<Rest>] : T extends [(infer F)?] ? [ResolvedMain<F>?] : T extends [(infer F)?, ...infer Rest extends readonly any[]] ? [ResolvedMain<F>?, ...ResolvedTuple<Rest>] : [];
+type ValueOf<Instance> = IsValueOf<Instance, Boolean> extends true ? boolean : IsValueOf<Instance, Number> extends true ? number : IsValueOf<Instance, String> extends true ? string : Instance;
+type IsTuple<T extends readonly any[] | {
+    length: number;
+}> = [T] extends [
+    never
+] ? false : T extends readonly any[] ? number extends T["length"] ? false : true : false;
+type IsValueOf<Instance, Object extends IValueOf<any>> = Instance extends Object ? Object extends IValueOf<infer Primitive> ? Instance extends Primitive ? false : true : false : false;
+interface IValueOf<T> {
+    valueOf(): T;
+}
+export {};

package/lib/Resolved.js

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

package/lib/Resolved.js.map

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

package/lib/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./IConnection";
 export * from "./IEncryptionPassword";
+export * from "./IPropagation";
 export * from "./IRandomGenerator";
-export * from "./Primitive";
 export * from "./HttpError";
+export * from "./Primitive";
+export * from "./Resolved";

package/lib/index.js

@@ -16,7 +16,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./IConnection"), exports);
 __exportStar(require("./IEncryptionPassword"), exports);
+__exportStar(require("./IPropagation"), exports);
 __exportStar(require("./IRandomGenerator"), exports);
-__exportStar(require("./Primitive"), exports);
 __exportStar(require("./HttpError"), exports);
+__exportStar(require("./Primitive"), exports);
+__exportStar(require("./Resolved"), 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,qDAAmC;AACnC,8CAA4B;AAC5B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,wDAAsC;AACtC,iDAA+B;AAC/B,qDAAmC;AACnC,8CAA4B;AAC5B,8CAA4B;AAC5B,6CAA2B"}

package/lib/internal/FetcherBase.d.ts

@@ -1,6 +1,7 @@
 import { IConnection } from "../IConnection";
 import { Primitive } from "../Primitive";
 import { IFetchRoute } from "./IFetchRoute";
+import { IPropagation } from "../IPropagation";
 export declare namespace FetcherBase {
     interface IProps {
         className: string;
@@ -8,4 +9,5 @@ export declare namespace FetcherBase {
         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>>;
+    const propagate: (props: IProps) => <Input>(connection: IConnection, route: IFetchRoute<"DELETE" | "GET" | "HEAD" | "PATCH" | "POST" | "PUT">, input?: Input | undefined, stringify?: ((input: Input) => string) | undefined) => Promise<IPropagation<any, any>>;
 }