@nestia/fetcher 1.3.2 → 1.3.4

package/lib/IConnection.d.ts

@@ -1,54 +1,46 @@
-import { IEncryptionPassword } from "./IEncryptionPassword";
-import { IRandomGenerator } from "./IRandomGenerator";
-/**
- * Connection information.
- *
- * `IConnection` is an interface ttype who represents connection information of the
- * remote HTTP server. You can target the remote HTTP server by wring the
- * {@link IConnection.host} variable down. Also, you can configure special header values
- * by specializing the {@link IConnection.headers} variable.
- *
- * If the remote HTTP server encrypts or decrypts its body data through the AES-128/256
- * algorithm, specify the {@link IConnection.encryption} with {@link IEncryptionPassword}
- * or {@link IEncryptionPassword.Closure} variable.
- *
- * @author Jenogho Nam - https://github.com/samchon
- */
-export interface IConnection {
-    /**
-     * Host address of the remote HTTP server.
-     */
-    host: string;
-    /**
-     * Header values delivered to the remote HTTP server.
-     */
-    headers?: Record<string, string>;
-    /**
-     * Encryption password of its closure function.
-     */
-    encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
-    /**
-     * Use simulation mode.
-     *
-     * If you configure this property to be `true` or assign an {@link IRandomGenerator}
-     * instance, your SDK library does not send any request to remote backend server,
-     * but just returns random data generated by `typia.random<T>()` function with
-     * request data validation.
-     *
-     * By the way, to utilize this simulation mode, SDK library must be generated with
-     * {@link INestiaConfig.simulate} option, too. Open `nestia.config.ts` file, and
-     * configure {@link INestiaConfig.simulate} property to be `true`. Them, newly
-     * generated SDK library would have a built-in mock-up data generator.
-     *
-     * @default false
-     */
-    simulate?: boolean | Partial<IRandomGenerator>;
-    /**
-     * Use simulation mode.
-     *
-     * @default false
-     * @deprecated Use {@link simulate} property instead.
-     *             This property would be erased after v2.0 update
-     */
-    random?: boolean | Partial<IRandomGenerator>;
-}
+import { IEncryptionPassword } from "./IEncryptionPassword";
+import { IRandomGenerator } from "./IRandomGenerator";
+/**
+ * Connection information.
+ *
+ * `IConnection` is an interface ttype who represents connection information of the
+ * remote HTTP server. You can target the remote HTTP server by wring the
+ * {@link IConnection.host} variable down. Also, you can configure special header values
+ * by specializing the {@link IConnection.headers} variable.
+ *
+ * If the remote HTTP server encrypts or decrypts its body data through the AES-128/256
+ * algorithm, specify the {@link IConnection.encryption} with {@link IEncryptionPassword}
+ * or {@link IEncryptionPassword.Closure} variable.
+ *
+ * @author Jenogho Nam - https://github.com/samchon
+ */
+export interface IConnection {
+    /**
+     * Host address of the remote HTTP server.
+     */
+    host: string;
+    /**
+     * Header values delivered to the remote HTTP server.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Encryption password of its closure function.
+     */
+    encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
+    /**
+     * Use simulation mode.
+     *
+     * If you configure this property to be `true` or assign an {@link IRandomGenerator}
+     * instance, your SDK library does not send any request to remote backend server,
+     * but just returns random data generated by `typia.random<T>()` function with
+     * request data validation.
+     *
+     * By the way, to utilize this simulation mode, SDK library must be generated with
+     * {@link INestiaConfig.simulate} option, too. Open `nestia.config.ts` file, and
+     * configure {@link INestiaConfig.simulate} property to be `true`. Them, newly
+     * generated SDK library would have a built-in mock-up data generator.
+     *
+     * @default false
+     */
+    simulate?: boolean | Partial<IRandomGenerator>;
+}

package/lib/IConnection.js

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

package/lib/IEncryptionPassword.d.ts

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

package/lib/IEncryptionPassword.js

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

package/lib/IRandomGenerator.d.ts

@@ -1,32 +1,32 @@
-export interface IRandomGenerator {
-    boolean(): boolean;
-    integer(minimum?: number, maximum?: number): number;
-    number(minimum?: number, maximum?: number): number;
-    bigint(minimum?: bigint, maximum?: bigint): bigint;
-    string(length?: number): string;
-    array<T>(closure: (index: number) => T, count?: number): T[];
-    length(): number;
-    uuid(): string;
-    email(): string;
-    url(): string;
-    ipv4(): string;
-    ipv6(): string;
-    pattern(regex: RegExp): string;
-    date(minimum?: number, maximum?: number): string;
-    datetime(minimum?: number, maximum?: number): string;
-    customs?: IRandomGenerator.CustomMap;
-}
-export declare namespace IRandomGenerator {
-    type CustomMap = {
-        [Type in keyof Customizable]?: (tags: ICommentTag[]) => Customizable[Type] | undefined;
-    };
-    type Customizable = {
-        number: number;
-        string: string;
-        bigint: bigint;
-    };
-    interface ICommentTag {
-        name: string;
-        value?: string;
-    }
-}
+export interface IRandomGenerator {
+    boolean(): boolean;
+    integer(minimum?: number, maximum?: number): number;
+    number(minimum?: number, maximum?: number): number;
+    bigint(minimum?: bigint, maximum?: bigint): bigint;
+    string(length?: number): string;
+    array<T>(closure: (index: number) => T, count?: number): T[];
+    length(): number;
+    uuid(): string;
+    email(): string;
+    url(): string;
+    ipv4(): string;
+    ipv6(): string;
+    pattern(regex: RegExp): string;
+    date(minimum?: number, maximum?: number): string;
+    datetime(minimum?: number, maximum?: number): string;
+    customs?: IRandomGenerator.CustomMap;
+}
+export declare namespace IRandomGenerator {
+    type CustomMap = {
+        [Type in keyof Customizable]?: (tags: ICommentTag[]) => Customizable[Type] | undefined;
+    };
+    type Customizable = {
+        number: number;
+        string: string;
+        bigint: bigint;
+    };
+    interface ICommentTag {
+        name: string;
+        value?: string;
+    }
+}

package/lib/IRandomGenerator.js

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

package/lib/Primitive.d.ts

@@ -1,52 +1,54 @@
-/**
- * Primitive type.
- *
- * `Primitive` is a type of TMP (Type Meta Programming) type who converts its argument as a
- * primitive type.
- *
- * 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`.
- *
- * 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>`
- * but `Primitive<ReturnType<Instance.toJSON>>`.
- *
- * Before                  | After
- * ------------------------|----------------------------------------
- * `Boolean`               | `boolean`
- * `Number`                | `number`
- * `String`                | `string`
- * `Class`                 | `object`
- * `Class` with `toJSON()` | `Primitive<ReturnType<Class.toJSON>>`
- * Others                  | No change
- *
- * @template Instance Target argument type.
- * @author Jenogho Nam - https://github.com/samchon
- */
-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> = 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]>;
-};
-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;
-type NativeClass = Set<any> | Map<any, any> | WeakSet<any> | WeakMap<any, any> | Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array | BigUint64Array | Int8Array | Int16Array | Int32Array | BigInt64Array | Float32Array | Float64Array | ArrayBuffer | SharedArrayBuffer | DataView;
-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;
-}
-interface IJsonable<T> {
-    toJSON(): T;
-}
-export {};
+/**
+ * Primitive type.
+ *
+ * `Primitive` is a type of TMP (Type Meta Programming) type who converts its argument as a
+ * primitive type.
+ *
+ * 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`.
+ *
+ * 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>`
+ * but `Primitive<ReturnType<Instance.toJSON>>`.
+ *
+ * Before                  | After
+ * ------------------------|----------------------------------------
+ * `Boolean`               | `boolean`
+ * `Number`                | `number`
+ * `String`                | `string`
+ * `Class`                 | `object`
+ * `Class` with `toJSON()` | `Primitive<ReturnType<Class.toJSON>>`
+ * Others                  | No change
+ *
+ * @template Instance Target argument type.
+ * @author Jenogho 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 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]>;
+};
+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;
+type NativeClass = Set<any> | Map<any, any> | WeakSet<any> | WeakMap<any, any> | Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array | BigUint64Array | Int8Array | Int16Array | Int32Array | BigInt64Array | Float32Array | Float64Array | ArrayBuffer | SharedArrayBuffer | DataView;
+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;
+}
+interface IJsonable<T> {
+    toJSON(): T;
+}
+export {};

package/lib/Primitive.js

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

package/lib/index.d.ts

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

package/lib/index.js

@@ -1,23 +1,23 @@
-"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("./IConnection"), exports);
-__exportStar(require("./IEncryptionPassword"), exports);
-__exportStar(require("./Primitive"), exports);
-__exportStar(require("./AesPkcs5"), exports);
-__exportStar(require("./Fetcher"), exports);
-__exportStar(require("./HttpError"), exports);
+"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("./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/internal/Singleton.d.ts

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

package/lib/internal/Singleton.js

@@ -1,24 +1,24 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Singleton = void 0;
-/**
- * @internal
- */
-var Singleton = /** @class */ (function () {
-    function Singleton(closure_) {
-        this.closure_ = closure_;
-        this.value_ = NOT_MOUNTED_YET;
-    }
-    Singleton.prototype.get = function () {
-        if (this.value_ === NOT_MOUNTED_YET)
-            this.value_ = this.closure_();
-        return this.value_;
-    };
-    return Singleton;
-}());
-exports.Singleton = Singleton;
-/**
- * @internal
- */
-var NOT_MOUNTED_YET = {};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Singleton = void 0;
+/**
+ * @internal
+ */
+var Singleton = /** @class */ (function () {
+    function Singleton(closure_) {
+        this.closure_ = closure_;
+        this.value_ = NOT_MOUNTED_YET;
+    }
+    Singleton.prototype.get = function () {
+        if (this.value_ === NOT_MOUNTED_YET)
+            this.value_ = this.closure_();
+        return this.value_;
+    };
+    return Singleton;
+}());
+exports.Singleton = Singleton;
+/**
+ * @internal
+ */
+var NOT_MOUNTED_YET = {};
 //# sourceMappingURL=Singleton.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/fetcher",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "Fetcher library of Nestia SDK",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -32,7 +32,10 @@
     "@typescript-eslint/parser": "^5.46.1",
     "prettier": "^2.8.1",
     "rimraf": "^3.0.2",
-    "typescript": "^4.9.4"
+    "typescript": "^5.1.3"
+  },
+  "peerDependencies": {
+    "typescript": ">= 4.7.4"
   },
   "dependencies": {
     "import2": "^1.0.3",

package/src/IConnection.ts

@@ -47,13 +47,4 @@ export interface IConnection {
      * @default false
      */
     simulate?: boolean | Partial<IRandomGenerator>;
-
-    /**
-     * Use simulation mode.
-     *
-     * @default false
-     * @deprecated Use {@link simulate} property instead.
-     *             This property would be erased after v2.0 update
-     */
-    random?: boolean | Partial<IRandomGenerator>;
 }

package/src/Primitive.ts

@@ -27,6 +27,8 @@
  *
  * @template Instance Target argument type.
  * @author Jenogho 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
@@ -34,7 +36,11 @@ export type Primitive<T> = Equal<T, PrimitiveMain<T>> extends true
 
 type Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;
 
-type PrimitiveMain<Instance> = ValueOf<Instance> extends object
+type PrimitiveMain<Instance> = Instance extends [never]
+    ? never // (special trick for jsonable | null) type
+    : ValueOf<Instance> extends boolean | number | bigint | string
+    ? ValueOf<Instance>
+    : ValueOf<Instance> extends object
     ? Instance extends object
         ? Instance extends NativeClass
             ? {}