@nestia/fetcher 2.0.0-dev.20230991 → 2.0.0

package/lib/internal/FetcherBase.js

@@ -95,121 +95,175 @@ var 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, text, _c, _d;
-            var _e, _f, _g, _h, _j, _k, _l, _m;
-            return __generator(this, function (_o) {
-                switch (_o.label) {
-                    case 0:
-                        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 {
-                                    for (var _c = __values(Object.entries(headers)), _d = _c.next(); !_d.done; _d = _c.next()) {
-                                        var _e = __read(_d.value, 2), key = _e[0], value = _e[1];
-                                        if (value === undefined)
-                                            continue;
-                                        else if (Array.isArray(value))
-                                            try {
-                                                for (var value_1 = (e_2 = void 0, __values(value)), value_1_1 = value_1.next(); !value_1_1.done; value_1_1 = value_1.next()) {
-                                                    var v = value_1_1.value;
-                                                    output.push([key, String(v)]);
-                                                }
-                                            }
-                                            catch (e_2_1) { e_2 = { error: e_2_1 }; }
-                                            finally {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, _Propagate("fetch")(props)(connection, route, input, stringify)];
+                    case 1:
+                        result = _a.sent();
+                        if (result.success === false)
+                            throw new HttpError_1.HttpError(route.method, route.path, result.status, result.headers, result.data);
+                        return [2 /*return*/, result.data];
+                }
+            });
+        }); };
+    };
+    FetcherBase.propagate = function (props) {
+        return function (connection, route, input, stringify) { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, _Propagate("propagate")(props)(connection, route, input, stringify)];
+        }); }); };
+    };
+    /**
+     * @internal
+     */
+    var _Propagate = function (method) {
+        return function (props) {
+            return function (connection, route, input, stringify) { return __awaiter(_this, void 0, void 0, function () {
+                var headers, init, path, url, response, result, _a, type, text, _b, _c, _d;
+                var _e, _f, _g, _h, _j;
+                return __generator(this, function (_k) {
+                    switch (_k.label) {
+                        case 0:
+                            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 {
+                                        for (var _c = __values(Object.entries(headers)), _d = _c.next(); !_d.done; _d = _c.next()) {
+                                            var _e = __read(_d.value, 2), key = _e[0], value = _e[1];
+                                            if (value === undefined)
+                                                continue;
+                                            else if (Array.isArray(value))
                                                 try {
-                                                    if (value_1_1 && !value_1_1.done && (_b = value_1.return)) _b.call(value_1);
+                                                    for (var value_1 = (e_2 = void 0, __values(value)), value_1_1 = value_1.next(); !value_1_1.done; value_1_1 = value_1.next()) {
+                                                        var v = value_1_1.value;
+                                                        output.push([key, String(v)]);
+                                                    }
+                                                }
+                                                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                                                finally {
+                                                    try {
+                                                        if (value_1_1 && !value_1_1.done && (_b = value_1.return)) _b.call(value_1);
+                                                    }
+                                                    finally { if (e_2) throw e_2.error; }
                                                 }
-                                                finally { if (e_2) throw e_2.error; }
-                                            }
-                                        else
-                                            output.push([key, String(value)]);
+                                            else
+                                                output.push([key, String(value)]);
+                                        }
                                     }
-                                }
-                                catch (e_1_1) { e_1 = { error: e_1_1 }; }
-                                finally {
-                                    try {
-                                        if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+                                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                                    finally {
+                                        try {
+                                            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+                                        }
+                                        finally { if (e_1) throw e_1.error; }
                                     }
-                                    finally { if (e_1) throw e_1.error; }
+                                    return output;
+                                })() });
+                            // CONSTRUCT BODY DATA
+                            if (input !== undefined)
+                                init.body = 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)
+                                    : input, headers);
+                            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*/, (_k.sent())(url.href, init)];
+                        case 2:
+                            response = _k.sent();
+                            result = {
+                                success: response.status === 200 ||
+                                    response.status === 201 ||
+                                    response.status == route.status,
+                                status: response.status,
+                                headers: response_headers_to_object(response.headers),
+                                data: undefined,
+                            };
+                            if (!(result.success === false)) return [3 /*break*/, 4];
+                            // WHEN FAILED
+                            _a = result;
+                            return [4 /*yield*/, response.text()];
+                        case 3:
+                            // WHEN FAILED
+                            _a.data = _k.sent();
+                            type = response.headers.get("content-type");
+                            if (method !== "fetch" &&
+                                type &&
+                                type.indexOf("application/json") !== -1)
+                                try {
+                                    result.data = JSON.parse(result.data);
                                 }
-                                return output;
-                            })() });
-                        // CONSTRUCT BODY DATA
-                        if (input !== undefined)
-                            init.body = 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)
-                                : input, headers);
-                        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*/, (_o.sent())(url.href, init)];
-                    case 2:
-                        response = _o.sent();
-                        if (!((route.status !== null && response.status !== route.status) ||
-                            (route.status === null &&
-                                response.status !== 200 &&
-                                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 : route.response.type)) === 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:
-                        if (!(route.method === "HEAD")) return [3 /*break*/, 6];
-                        return [2 /*return*/, undefined];
-                    case 6:
-                        if (!(((_m = route.response) === null || _m === void 0 ? void 0 : _m.type) === "application/json")) return [3 /*break*/, 8];
-                        return [4 /*yield*/, response.text()];
-                    case 7:
-                        text = _o.sent();
-                        return [2 /*return*/, text.length ? JSON.parse(text) : undefined];
-                    case 8:
-                        _d = (_c = props).decode;
-                        return [4 /*yield*/, response.text()];
-                    case 9: return [2 /*return*/, _d.apply(_c, [_o.sent(), response_headers_to_object(response.headers)])];
-                }
-            });
-        }); };
+                                catch (_l) { }
+                            return [3 /*break*/, 9];
+                        case 4:
+                            if (!(route.method === "HEAD")) return [3 /*break*/, 5];
+                            result.data = undefined;
+                            return [3 /*break*/, 9];
+                        case 5:
+                            if (!(((_j = route.response) === null || _j === void 0 ? void 0 : _j.type) === "application/json")) return [3 /*break*/, 7];
+                            return [4 /*yield*/, response.text()];
+                        case 6:
+                            text = _k.sent();
+                            result.data = text.length ? JSON.parse(text) : undefined;
+                            return [3 /*break*/, 9];
+                        case 7:
+                            _b = result;
+                            _d = (_c = props).decode;
+                            return [4 /*yield*/, response.text()];
+                        case 8:
+                            _b.data = _d.apply(_c, [_k.sent(), result.headers]);
+                            _k.label = 9;
+                        case 9: return [2 /*return*/, result];
+                    }
+                });
+            }); };
+        };
     };
 })(FetcherBase || (exports.FetcherBase = FetcherBase = {}));
+/**
+ * @internal
+ */
 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) {
+    var _a, _b;
+    var _c;
+    return __generator(this, function (_d) {
+        switch (_d.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")];
+                    typeof global.process.versions.node !== undefined)) return [3 /*break*/, 5];
+                if (!(global.fetch === undefined)) return [3 /*break*/, 4];
+                if (!((_c = global.fetch) !== null && _c !== void 0)) return [3 /*break*/, 1];
+                _a = _c;
+                return [3 /*break*/, 3];
             case 1:
-                _a.fetch = (_b.sent()).default;
-                _b.label = 2;
-            case 2: return [2 /*return*/, global.fetch];
-            case 3: return [2 /*return*/, window.fetch];
+                _b = global;
+                return [4 /*yield*/, (0, import2_1.default)("node-fetch")];
+            case 2:
+                _a = (_b.fetch = (_d.sent()).default);
+                _d.label = 3;
+            case 3:
+                _a;
+                _d.label = 4;
+            case 4: return [2 /*return*/, global.fetch];
+            case 5: return [2 /*return*/, window.fetch];
         }
     });
 }); });
+/**
+ * @internal
+ */
 var response_headers_to_object = function (headers) {
     var output = {};
     headers.forEach(function (value, key) {

package/lib/internal/FetcherBase.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/fetcher",
-  "version": "2.0.0-dev.20230991",
+  "version": "2.0.0",
   "description": "Fetcher library of Nestia SDK",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -32,7 +32,7 @@
     "@typescript-eslint/parser": "^5.46.1",
     "prettier": "^2.8.1",
     "rimraf": "^3.0.2",
-    "typescript": "^5.1.3"
+    "typescript": "^5.2.2"
   },
   "peerDependencies": {
     "typescript": ">= 4.8.0"

package/src/EncryptedFetcher.ts

@@ -1,6 +1,7 @@
 import { AesPkcs5 } from "./AesPkcs5";
 import { IConnection } from "./IConnection";
 import { IEncryptionPassword } from "./IEncryptionPassword";
+import { IPropagation } from "./IPropagation";
 import { Primitive } from "./Primitive";
 import { FetcherBase } from "./internal/FetcherBase";
 import { IFetchRoute } from "./internal/IFetchRoute";
@@ -115,4 +116,79 @@ export namespace EncryptedFetcher {
                     : (input) => input,
         })(connection, route, input, stringify);
     }
+
+    export function propagate<Output extends IPropagation<any, any>>(
+        connection: IConnection,
+        route: IFetchRoute<"GET" | "HEAD">,
+    ): Promise<Output>;
+
+    export 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>;
+
+    export async 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> {
+        if (
+            (route.request?.encrypted === true || route.response?.encrypted) &&
+            connection.encryption === undefined
+        )
+            throw new Error(
+                "Error on EncryptedFetcher.propagate(): the encryption password has not been configured.",
+            );
+        const closure =
+            typeof connection.encryption === "function"
+                ? (direction: "encode" | "decode") =>
+                      (
+                          headers: Record<
+                              string,
+                              IConnection.HeaderValue | undefined
+                          >,
+                          body: string,
+                      ) =>
+                          (
+                              connection.encryption as IEncryptionPassword.Closure
+                          )({
+                              headers,
+                              body,
+                              direction,
+                          })
+                : () => () => connection.encryption as IEncryptionPassword;
+
+        return FetcherBase.propagate({
+            className: "EncryptedFetcher",
+            encode:
+                route.request?.encrypted === true
+                    ? (input, headers) => {
+                          const p = closure("encode")(headers, input);
+                          return AesPkcs5.encrypt(
+                              JSON.stringify(input),
+                              p.key,
+                              p.iv,
+                          );
+                      }
+                    : (input) => input,
+            decode:
+                route.response?.encrypted === true
+                    ? (input, headers) => {
+                          const p = closure("decode")(headers, input);
+                          const str = AesPkcs5.decrypt(input, p.key, p.iv);
+                          return str.length ? JSON.parse(str) : str;
+                      }
+                    : (input) => input,
+        })(connection, route, input, stringify) as Promise<Output>;
+    }
 }

package/src/HttpError.ts

@@ -29,6 +29,7 @@ export class HttpError extends Error {
             | "HEAD",
         public readonly path: string,
         public readonly status: number,
+        public readonly headers: Record<string, string | string[]>,
         message: string,
     ) {
         super(message);
@@ -63,6 +64,7 @@ export class HttpError extends Error {
             method: this.method,
             path: this.path,
             status: this.status,
+            headers: this.headers,
             message: this.body_,
         };
     }
@@ -75,6 +77,7 @@ export namespace HttpError {
         method: "GET" | "DELETE" | "POST" | "PUT" | "PATCH" | "HEAD";
         path: string;
         status: number;
+        headers: Record<string, string | string[]>;
         message: T;
     }
 }

package/src/IPropagation.ts

@@ -0,0 +1,103 @@
+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 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"]]>;
+}

package/src/PlainFetcher.ts

@@ -3,6 +3,7 @@ import { Primitive } from "./Primitive";
 
 import { IFetchRoute } from "./internal/IFetchRoute";
 import { FetcherBase } from "./internal/FetcherBase";
+import { IPropagation } from "./IPropagation";
 
 /**
  * Utility class for `fetch` functions used in `@nestia/sdk`.
@@ -79,4 +80,43 @@ export namespace PlainFetcher {
             decode: (input) => input,
         })(connection, route, input, stringify);
     }
+
+    export function propagate<Output extends IPropagation<any, any>>(
+        connection: IConnection,
+        route: IFetchRoute<"GET" | "HEAD">,
+    ): Promise<Output>;
+
+    export 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>;
+
+    export async 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> {
+        if (
+            route.request?.encrypted === true ||
+            route.response?.encrypted === true
+        )
+            throw new Error(
+                "Error on PlainFetcher.propagate(): PlainFetcher doesn't have encryption ability. Use EncryptedFetcher instead.",
+            );
+        return FetcherBase.propagate({
+            className: "PlainFetcher",
+            encode: (input) => input,
+            decode: (input) => input,
+        })(connection, route, input, stringify) as Promise<Output>;
+    }
 }