@nestia/fetcher 11.0.0-dev.20260305 → 11.0.0-dev.20260312

package/lib/IPropagation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 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.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @template StatusMap Map of status code and its body data type.
+ * @template Success Default success status code.
+ */
+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: 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/NestiaSimulator.d.ts

@@ -0,0 +1,13 @@
+export declare namespace NestiaSimulator {
+    interface IProps {
+        host: string;
+        path: string;
+        method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+        contentType: string;
+    }
+    const assert: (props: IProps) => {
+        param: (name: string) => <T>(task: () => T) => void;
+        query: <T>(task: () => T) => void;
+        body: <T>(task: () => T) => void;
+    };
+}

package/lib/NestiaSimulator.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestiaSimulator = void 0;
+const HttpError_1 = require("./HttpError");
+var NestiaSimulator;
+(function (NestiaSimulator) {
+    NestiaSimulator.assert = (props) => {
+        return {
+            param: param(props),
+            query: query(props),
+            body: body(props),
+        };
+    };
+    const param = (props) => (name) => (task) => {
+        validate((exp) => `URL parameter "${name}" is not ${exp.expected} type.`)(props)(task);
+    };
+    const query = (props) => (task) => validate(() => "Request query parameters are not following the promised type.")(props)(task);
+    const body = (props) => (task) => validate(() => "Request body is not following the promised type.")(props)(task);
+    const validate = (message, path) => (props) => (task) => {
+        try {
+            task();
+        }
+        catch (exp) {
+            if (isTypeGuardError(exp))
+                throw new HttpError_1.HttpError(props.method, props.host + props.path, 400, {
+                    "Content-Type": props.contentType,
+                }, JSON.stringify({
+                    method: exp.method,
+                    path: path !== null && path !== void 0 ? path : exp.path,
+                    expected: exp.expected,
+                    value: exp.value,
+                    message: message(exp),
+                }));
+            throw exp;
+        }
+    };
+})(NestiaSimulator || (exports.NestiaSimulator = NestiaSimulator = {}));
+const isTypeGuardError = (input) => "string" === typeof input.method &&
+    (undefined === input.path || "string" === typeof input.path) &&
+    "string" === typeof input.expected &&
+    "string" === typeof input.name &&
+    "string" === typeof input.message &&
+    (undefined === input.stack || "string" === typeof input.stack);
+//# sourceMappingURL=NestiaSimulator.js.map

package/lib/NestiaSimulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NestiaSimulator.js","sourceRoot":"","sources":["../src/NestiaSimulator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC,IAAiB,eAAe,CAgE/B;AAhED,WAAiB,eAAe;IAQjB,sBAAM,GAAG,CAAC,KAAa,EAAE,EAAE;QACtC,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;YACnB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;SAClB,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,KAAK,GACT,CAAC,KAAa,EAAE,EAAE,CAClB,CAAC,IAAY,EAAE,EAAE,CACjB,CAAI,IAAa,EAAQ,EAAE;QACzB,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,kBAAkB,IAAI,YAAY,GAAG,CAAC,QAAQ,QAAQ,CAAC,CACvE,KAAK,CACN,CAAC,IAAI,CAAC,CAAC;IACV,CAAC,CAAC;IAEJ,MAAM,KAAK,GACT,CAAC,KAAa,EAAE,EAAE,CAClB,CAAI,IAAa,EAAQ,EAAE,CACzB,QAAQ,CACN,GAAG,EAAE,CAAC,+DAA+D,CACtE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IAEnB,MAAM,IAAI,GACR,CAAC,KAAa,EAAE,EAAE,CAClB,CAAI,IAAa,EAAQ,EAAE,CACzB,QAAQ,CAAC,GAAG,EAAE,CAAC,kDAAkD,CAAC,CAAC,KAAK,CAAC,CACvE,IAAI,CACL,CAAC;IAEN,MAAM,QAAQ,GACZ,CAAC,OAAwC,EAAE,IAAa,EAAE,EAAE,CAC5D,CAAC,KAAa,EAAE,EAAE,CAClB,CAAI,IAAa,EAAQ,EAAE;QACzB,IAAI,CAAC;YACH,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,gBAAgB,CAAC,GAAG,CAAC;gBACvB,MAAM,IAAI,qBAAS,CACjB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,EACvB,GAAG,EACH;oBACE,cAAc,EAAE,KAAK,CAAC,WAAW;iBAClC,EACD,IAAI,CAAC,SAAS,CAAC;oBACb,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,IAAI,EAAE,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,GAAG,CAAC,IAAI;oBACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC;iBACtB,CAAC,CACH,CAAC;YACJ,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;AACN,CAAC,EAhEgB,eAAe,+BAAf,eAAe,QAgE/B;AAED,MAAM,gBAAgB,GAAG,CAAC,KAAU,EAA2B,EAAE,CAC/D,QAAQ,KAAK,OAAO,KAAK,CAAC,MAAM;IAChC,CAAC,SAAS,KAAK,KAAK,CAAC,IAAI,IAAI,QAAQ,KAAK,OAAO,KAAK,CAAC,IAAI,CAAC;IAC5D,QAAQ,KAAK,OAAO,KAAK,CAAC,QAAQ;IAClC,QAAQ,KAAK,OAAO,KAAK,CAAC,IAAI;IAC9B,QAAQ,KAAK,OAAO,KAAK,CAAC,OAAO;IACjC,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,IAAI,QAAQ,KAAK,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC"}

package/lib/PlainFetcher.d.ts

@@ -0,0 +1,46 @@
+import { IConnection } from "./IConnection";
+import { IFetchRoute } from "./IFetchRoute";
+import { IPropagation } from "./IPropagation";
+/**
+ * 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
+     * @returns 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
+     * @returns Response body data from the remote API
+     */
+    function fetch<Output>(connection: IConnection, route: IFetchRoute<"GET">): Promise<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
+     * @returns 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<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

@@ -0,0 +1,58 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlainFetcher = void 0;
+const 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) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            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 FetcherBase_1.FetcherBase.request({
+                className: "PlainFetcher",
+                encode: (input) => input,
+                decode: (input) => input,
+            })(connection, route, input, stringify);
+        });
+    }
+    PlainFetcher.fetch = fetch;
+    function propagate(connection, route, input, stringify) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            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 FetcherBase_1.FetcherBase.propagate({
+                className: "PlainFetcher",
+                encode: (input) => input,
+                decode: (input) => input,
+            })(connection, route, input, stringify);
+        });
+    }
+    PlainFetcher.propagate = propagate;
+})(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":";;;;;;;;;;;;AAGA,wDAAqD;AAErD;;;;;;;;;;;;;;GAcG;AACH,IAAiB,YAAY,CAoF5B;AApFD,WAAiB,YAAY;IAuC3B,SAAsB,KAAK,CACzB,UAAuB,EACvB,KAAwE,EACxE,KAAa,EACb,SAAoC;;;YAEpC,IAAI,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,SAAS,MAAK,IAAI,IAAI,CAAA,MAAA,KAAK,CAAC,QAAQ,0CAAE,SAAS,MAAK,IAAI;gBACzE,MAAM,IAAI,KAAK,CACb,4GAA4G,CAC7G,CAAC;YACJ,OAAO,yBAAW,CAAC,OAAO,CAAC;gBACzB,SAAS,EAAE,cAAc;gBACzB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;gBACxB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;aACzB,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;KAAA;IAfqB,kBAAK,QAe1B,CAAA;IAcD,SAAsB,SAAS,CAC7B,UAAuB,EACvB,KAAwE,EACxE,KAAa,EACb,SAAoC;;;YAEpC,IAAI,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,SAAS,MAAK,IAAI,IAAI,CAAA,MAAA,KAAK,CAAC,QAAQ,0CAAE,SAAS,MAAK,IAAI;gBACzE,MAAM,IAAI,KAAK,CACb,gHAAgH,CACjH,CAAC;YACJ,OAAO,yBAAW,CAAC,SAAS,CAAC;gBAC3B,SAAS,EAAE,cAAc;gBACzB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;gBACxB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;aACzB,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAoB,CAAC;QAC7D,CAAC;KAAA;IAfqB,sBAAS,YAe9B,CAAA;AACH,CAAC,EApFgB,YAAY,4BAAZ,YAAY,QAoF5B"}

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./AesPkcs5";
+export * from "./EncryptedFetcher";
+export * from "./FormDataInput";
+export * from "./HttpError";
+export * from "./IConnection";
+export * from "./IEncryptionPassword";
+export * from "./IFetchEvent";
+export * from "./IFetchRoute";
+export * from "./IPropagation";
+export * from "./NestiaSimulator";
+export * from "./PlainFetcher";

package/lib/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AesPkcs5"), exports);
+__exportStar(require("./EncryptedFetcher"), exports);
+__exportStar(require("./FormDataInput"), exports);
+__exportStar(require("./HttpError"), exports);
+__exportStar(require("./IConnection"), exports);
+__exportStar(require("./IEncryptionPassword"), exports);
+__exportStar(require("./IFetchEvent"), exports);
+__exportStar(require("./IFetchRoute"), exports);
+__exportStar(require("./IPropagation"), exports);
+__exportStar(require("./NestiaSimulator"), exports);
+__exportStar(require("./PlainFetcher"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,qDAAmC;AACnC,kDAAgC;AAChC,8CAA4B;AAC5B,gDAA8B;AAC9B,wDAAsC;AACtC,gDAA8B;AAC9B,gDAA8B;AAC9B,iDAA+B;AAE/B,oDAAkC;AAClC,iDAA+B"}

package/lib/internal/FetcherBase.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/internal/FetcherBase.js

@@ -0,0 +1,185 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FetcherBase = void 0;
+const HttpError_1 = require("../HttpError");
+/** @internal */
+var FetcherBase;
+(function (FetcherBase) {
+    FetcherBase.request = (props) => (connection, route, input, stringify) => __awaiter(this, void 0, void 0, function* () {
+        const result = yield _Propagate("fetch")(props)(connection, route, input, stringify);
+        if (result.success === false)
+            throw new HttpError_1.HttpError(route.method, route.path, result.status, result.headers, result.data);
+        return result.data;
+    });
+    FetcherBase.propagate = (props) => (connection, route, input, stringify) => __awaiter(this, void 0, void 0, function* () { return _Propagate("propagate")(props)(connection, route, input, stringify); });
+    /** @internal */
+    const _Propagate = (method) => (props) => (connection, route, input, stringify) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        //----
+        // REQUEST MESSAGE
+        //----
+        // METHOD & HEADERS
+        const headers = Object.assign({}, ((_a = connection.headers) !== null && _a !== void 0 ? _a : {}));
+        if (input !== undefined) {
+            if (((_b = route.request) === null || _b === void 0 ? void 0 : _b.type) === undefined)
+                throw new Error(`Error on ${props.className}.fetch(): no content-type being configured.`);
+            else if (route.request.type !== "multipart/form-data")
+                headers["Content-Type"] = route.request.type;
+        }
+        else if (input === undefined && headers["Content-Type"] !== undefined)
+            delete headers["Content-Type"];
+        // INIT REQUEST DATA
+        const init = Object.assign(Object.assign({}, ((_c = connection.options) !== null && _c !== void 0 ? _c : {})), { method: route.method, headers: (() => {
+                const output = [];
+                for (const [key, value] of Object.entries(headers))
+                    if (value === undefined)
+                        continue;
+                    else if (Array.isArray(value))
+                        for (const v of value)
+                            output.push([key, String(v)]);
+                    else
+                        output.push([key, String(value)]);
+                return output;
+            })() });
+        // CONSTRUCT BODY DATA
+        if (input !== undefined)
+            init.body = props.encode(
+            // BODY TRANSFORM
+            ((_d = route.request) === null || _d === void 0 ? void 0 : _d.type) === "application/x-www-form-urlencoded"
+                ? request_query_body(input)
+                : ((_e = route.request) === null || _e === void 0 ? void 0 : _e.type) === "multipart/form-data"
+                    ? request_form_data_body(input)
+                    : ((_f = route.request) === null || _f === void 0 ? void 0 : _f.type) !== "text/plain"
+                        ? (stringify !== null && stringify !== void 0 ? stringify : JSON.stringify)(input)
+                        : input, headers);
+        //----
+        // RESPONSE MESSAGE
+        //----
+        // URL SPECIFICATION
+        const path = connection.host[connection.host.length - 1] !== "/" &&
+            route.path[0] !== "/"
+            ? `/${route.path}`
+            : route.path;
+        const url = new URL(`${connection.host}${path}`);
+        // DO FETCH
+        const event = {
+            route,
+            path,
+            status: null,
+            input,
+            output: undefined,
+            started_at: new Date(),
+            respond_at: null,
+            completed_at: null,
+        };
+        try {
+            // TRY FETCH
+            const response = yield ((_g = connection.fetch) !== null && _g !== void 0 ? _g : fetch)(url.href, init);
+            event.respond_at = new Date();
+            event.status = response.status;
+            // CONSTRUCT RESULT DATA
+            const 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) {
+                // WHEN FAILED
+                result.data = yield response.text();
+                const type = response.headers.get("content-type");
+                if (method !== "fetch" &&
+                    type &&
+                    type.indexOf("application/json") !== -1)
+                    try {
+                        result.data = JSON.parse(result.data);
+                    }
+                    catch (_k) { }
+            }
+            else {
+                // WHEN SUCCESS
+                if (route.method === "HEAD")
+                    result.data = undefined;
+                else if (((_h = route.response) === null || _h === void 0 ? void 0 : _h.type) === "application/json") {
+                    const text = yield response.text();
+                    result.data = text.length ? JSON.parse(text) : undefined;
+                }
+                else if (((_j = route.response) === null || _j === void 0 ? void 0 : _j.type) === "application/x-www-form-urlencoded") {
+                    const query = new URLSearchParams(yield response.text());
+                    result.data = route.parseQuery ? route.parseQuery(query) : query;
+                }
+                else
+                    result.data = props.decode(yield response.text(), result.headers);
+            }
+            event.output = result.data;
+            return result;
+        }
+        catch (exp) {
+            throw exp;
+        }
+        finally {
+            event.completed_at = new Date();
+            if (connection.logger)
+                try {
+                    yield connection.logger(event);
+                }
+                catch (_l) { }
+        }
+    });
+})(FetcherBase || (exports.FetcherBase = FetcherBase = {}));
+/** @internal */
+const request_query_body = (input) => {
+    const q = new URLSearchParams();
+    for (const [key, value] of Object.entries(input))
+        if (value === undefined)
+            continue;
+        else if (Array.isArray(value))
+            value.forEach((elem) => q.append(key, String(elem)));
+        else
+            q.set(key, String(value));
+    return q;
+};
+/** @internal */
+const request_form_data_body = (input) => {
+    const encoded = new FormData();
+    const append = (key) => (value) => {
+        if (value === undefined)
+            return;
+        else if (typeof File === "function" && value instanceof File)
+            encoded.append(key, value, value.name);
+        else
+            encoded.append(key, value);
+    };
+    for (const [key, value] of Object.entries(input))
+        if (Array.isArray(value))
+            value.map(append(key));
+        else
+            append(key)(value);
+    return encoded;
+};
+/** @internal */
+const response_headers_to_object = (headers) => {
+    const output = {};
+    headers.forEach((value, key) => {
+        var _a;
+        if (key === "set-cookie") {
+            (_a = output[key]) !== null && _a !== void 0 ? _a : (output[key] = []);
+            output[key].push(...value.split(";").map((str) => str.trim()));
+        }
+        else
+            output[key] = value;
+    });
+    return output;
+};
+//# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/fetcher",
-  "version": "11.0.0-dev.20260305",
+  "version": "11.0.0-dev.20260312",
   "description": "Fetcher library of Nestia SDK",
   "main": "lib/index.js",
   "exports": {
@@ -26,8 +26,8 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@typia/interface": "12.0.0-dev.20260303-2",
-    "@typia/utils": "12.0.0-dev.20260303-2"
+    "@typia/interface": "12.0.0-dev.20260312-2",
+    "@typia/utils": "12.0.0-dev.20260312-2"
   },
   "devDependencies": {
     "@types/node": "^25.3.3",