@nestia/fetcher 1.3.1 → 1.3.3

package/lib/IConnection.d.ts

@@ -20,26 +20,35 @@ export interface IConnection {
      */
     host: string;
     /**
-     * Use `typia.random<T>()` function instead.
+     * 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 an {@link IRandomGenerator}
+     * 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 a random data generated by `typia.random<T>()` function.
+     * but just returns random data generated by `typia.random<T>()` function with
+     * request data validation.
      *
-     * By the way, to utilize this random property, SDK library must be generated with
-     * {@link INestiaConfig.random} option, too. Open `nestia.config.ts` file, and
-     * configure {@link INestiaConfig.random} property to be true. Then newly generated
-     * SDK library would have a built-in random generator.
+     * 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
      */
-    random?: boolean | Partial<IRandomGenerator>;
-    /**
-     * Header values delivered to the remote HTTP server.
-     */
-    headers?: Record<string, string>;
+    simulate?: boolean | Partial<IRandomGenerator>;
     /**
-     * Encryption password of its closure function.
+     * Use simulation mode.
+     *
+     * @default false
+     * @deprecated Use {@link simulate} property instead.
+     *             This property would be erased after v2.0 update
      */
-    encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
+    random?: boolean | Partial<IRandomGenerator>;
 }

package/lib/Primitive.d.ts

@@ -27,10 +27,12 @@
  *
  * @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> = 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 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]>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/fetcher",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Fetcher library of Nestia SDK",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -34,6 +34,9 @@
     "rimraf": "^3.0.2",
     "typescript": "^4.9.4"
   },
+  "peerDependencies": {
+    "typescript": ">= 4.7.4"
+  },
   "dependencies": {
     "import2": "^1.0.3",
     "node-fetch": "^2.6.7"

package/src/IConnection.ts

@@ -22,28 +22,38 @@ export interface IConnection {
     host: string;
 
     /**
-     * Use `typia.random<T>()` function instead.
+     * 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 an {@link IRandomGenerator}
+     * 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 a random data generated by `typia.random<T>()` function.
+     * but just returns random data generated by `typia.random<T>()` function with
+     * request data validation.
      *
-     * By the way, to utilize this random property, SDK library must be generated with
-     * {@link INestiaConfig.random} option, too. Open `nestia.config.ts` file, and
-     * configure {@link INestiaConfig.random} property to be true. Then newly generated
-     * SDK library would have a built-in random generator.
+     * 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
      */
-    random?: boolean | Partial<IRandomGenerator>;
+    simulate?: boolean | Partial<IRandomGenerator>;
 
     /**
-     * Header values delivered to the remote HTTP server.
-     */
-    headers?: Record<string, string>;
-
-    /**
-     * Encryption password of its closure function.
+     * Use simulation mode.
+     *
+     * @default false
+     * @deprecated Use {@link simulate} property instead.
+     *             This property would be erased after v2.0 update
      */
-    encryption?: IEncryptionPassword | IEncryptionPassword.Closure;
+    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
             ? {}