typia 9.0.1 → 9.1.0

package/src/http.ts

@@ -1,3 +1,5 @@
+import { NoTransformConfigurationError } from "./transformers/NoTransformConfigurationError";
+
 import { Atomic } from "./typings/Atomic";
 
 import { IReadableURLSearchParams } from "./IReadableURLSearchParams";
@@ -48,7 +50,7 @@ export function formData<T extends object>(input: FormData): Resolved<T>;
  * @internal
  */
 export function formData(): never {
-  halt("formData");
+  NoTransformConfigurationError("http.formData");
 }
 
 /**
@@ -89,7 +91,7 @@ export function assertFormData<T extends object>(
  * @internal
  */
 export function assertFormData(): never {
-  halt("assertFormData");
+  NoTransformConfigurationError("http.assertFormData");
 }
 
 /**
@@ -127,7 +129,7 @@ export function isFormData<T extends object>(
  * @internal
  */
 export function isFormData(): never {
-  halt("isFormData");
+  NoTransformConfigurationError("http.isFormData");
 }
 
 /**
@@ -167,7 +169,7 @@ export function validateFormData<T extends object>(
  * @internal
  */
 export function validateFormData(): never {
-  halt("validateFormData");
+  NoTransformConfigurationError("http.validateFormData");
 }
 
 /* -----------------------------------------------------------
@@ -212,7 +214,7 @@ export function query<T extends object>(
  * @internal
  */
 export function query(): never {
-  halt("query");
+  NoTransformConfigurationError("http.query");
 }
 
 /**
@@ -253,7 +255,7 @@ export function assertQuery<T extends object>(
  * @internal
  */
 export function assertQuery(): never {
-  halt("assertQuery");
+  NoTransformConfigurationError("http.assertQuery");
 }
 
 /**
@@ -291,7 +293,7 @@ export function isQuery<T extends object>(
  * @internal
  */
 export function isQuery(): never {
-  halt("isQuery");
+  NoTransformConfigurationError("http.isQuery");
 }
 
 /**
@@ -330,7 +332,7 @@ export function validateQuery<T extends object>(
  * @internal
  */
 export function validateQuery(): never {
-  halt("validateQuery");
+  NoTransformConfigurationError("http.validateQuery");
 }
 
 /* -----------------------------------------------------------
@@ -396,7 +398,7 @@ export function headers<T extends object>(
  * @internal
  */
 export function headers(): never {
-  halt("headers");
+  NoTransformConfigurationError("http.headers");
 }
 
 /**
@@ -459,7 +461,7 @@ export function assertHeaders<T extends object>(
  * @internal
  */
 export function assertHeaders(): never {
-  halt("assertHeaders");
+  NoTransformConfigurationError("http.assertHeaders");
 }
 
 /**
@@ -521,7 +523,7 @@ export function isHeaders<T extends object>(
  * @internal
  */
 export function isHeaders(): never {
-  halt("isHeaders");
+  NoTransformConfigurationError("http.isHeaders");
 }
 
 /**
@@ -582,7 +584,7 @@ export function validateHeaders<T extends object>(
  * @internal
  */
 export function validateHeaders(): never {
-  halt("validateHeaders");
+  NoTransformConfigurationError("http.validateHeaders");
 }
 
 /* -----------------------------------------------------------
@@ -611,7 +613,7 @@ export function parameter<T extends Atomic.Type | null>(
  * @internal
  */
 export function parameter(): never {
-  halt("parameter");
+  NoTransformConfigurationError("http.parameter");
 }
 
 /* -----------------------------------------------------------
@@ -642,7 +644,7 @@ export function createFormData<T extends object>(): (input: FormData) => T;
  * @internal
  */
 export function createFormData<T>(): (input: FormData) => T {
-  halt("createFormData");
+  NoTransformConfigurationError("http.createFormData");
 }
 
 /**
@@ -676,7 +678,7 @@ export function createAssertFormData<T extends object>(
  * @internal
  */
 export function createAssertFormData<T>(): (input: FormData) => T {
-  halt("createAssertFormData");
+  NoTransformConfigurationError("http.createAssertFormData");
 }
 
 /**
@@ -706,7 +708,7 @@ export function createIsFormData<T extends object>(): (
  * @internal
  */
 export function createIsFormData<T>(): (input: FormData) => T | null {
-  halt("createIsFormData");
+  NoTransformConfigurationError("http.createIsFormData");
 }
 
 /**
@@ -738,7 +740,7 @@ export function createValidateFormData<T extends object>(): (
 export function createValidateFormData<T>(): (
   input: FormData,
 ) => IValidation<Resolved<T>> {
-  halt("createValidateFormData");
+  NoTransformConfigurationError("http.createValidateFormData");
 }
 
 /**
@@ -770,7 +772,7 @@ export function createQuery<T extends object>(): (
 export function createQuery<T>(): (
   input: string | IReadableURLSearchParams,
 ) => T {
-  halt("createQuery");
+  NoTransformConfigurationError("http.createQuery");
 }
 
 /**
@@ -806,7 +808,7 @@ export function createAssertQuery<T extends object>(
 export function createAssertQuery<T>(): (
   input: string | IReadableURLSearchParams,
 ) => T {
-  halt("createAssertQuery");
+  NoTransformConfigurationError("http.createAssertQuery");
 }
 
 /**
@@ -838,7 +840,7 @@ export function createIsQuery<T extends object>(): (
 export function createIsQuery<T>(): (
   input: string | IReadableURLSearchParams,
 ) => T | null {
-  halt("createIsQuery");
+  NoTransformConfigurationError("http.createIsQuery");
 }
 
 /**
@@ -870,7 +872,7 @@ export function createValidateQuery<T extends object>(): (
 export function createValidateQuery<T>(): (
   input: string | IReadableURLSearchParams,
 ) => IValidation<Resolved<T>> {
-  halt("createValidateQuery");
+  NoTransformConfigurationError("http.createValidateQuery");
 }
 
 /**
@@ -902,7 +904,7 @@ export function createHeaders<T extends object>(): (
 export function createHeaders<T>(): (
   input: Record<string, string | string[] | undefined>,
 ) => T {
-  halt("createHeaders");
+  NoTransformConfigurationError("http.createHeaders");
 }
 
 /**
@@ -938,7 +940,7 @@ export function createAssertHeaders<T extends object>(
 export function createAssertHeaders<T>(): (
   input: Record<string, string | string[] | undefined>,
 ) => T {
-  halt("createAssertHeaders");
+  NoTransformConfigurationError("http.createAssertHeaders");
 }
 
 /**
@@ -970,7 +972,7 @@ export function createIsHeaders<T extends object>(): (
 export function createIsHeaders<T>(): (
   input: Record<string, string | string[] | undefined>,
 ) => T | null {
-  halt("createIsHeaders");
+  NoTransformConfigurationError("http.createIsHeaders");
 }
 
 /**
@@ -1002,7 +1004,7 @@ export function createValidateHeaders<T extends object>(): (
 export function createValidateHeaders<T>(): (
   input: Record<string, string | string[] | undefined>,
 ) => IValidation<Resolved<T>> {
-  halt("createValidateHeaders");
+  NoTransformConfigurationError("http.createValidateHeaders");
 }
 
 /**
@@ -1034,14 +1036,5 @@ export function createParameter<T extends Atomic.Type | null>(): (
 export function createParameter<T extends Atomic.Type | null>(): (
   input: string,
 ) => T {
-  halt("createParameter");
-}
-
-/**
- * @internal
- */
-function halt(name: string): never {
-  throw new Error(
-    `Error on typia.http.${name}(): no transform has been configured. Read and follow https://typia.io/docs/setup please.`,
-  );
+  NoTransformConfigurationError("http.createParameter");
 }

package/src/json.ts

@@ -1,4 +1,7 @@
 import { IJsonSchemaCollection } from "./schemas/json/IJsonSchemaCollection";
+import { IJsonSchemaUnit } from "./schemas/json/IJsonSchemaUnit";
+
+import { NoTransformConfigurationError } from "./transformers/NoTransformConfigurationError";
 
 import { IValidation } from "./IValidation";
 import { Primitive } from "./Primitive";
@@ -16,7 +19,7 @@ import { TypeGuardError } from "./TypeGuardError";
 /**
  * > You must configure the generic argument `Types`.
  *
- * JSON Schemas generator.
+ * JSON Schemas Generator.
  *
  * Creates a JSON schema list which contains both main JSON schemas
  * and components. Note that, all of the named types are stored in the
@@ -28,14 +31,14 @@ import { TypeGuardError } from "./TypeGuardError";
  *
  * @template Types Tuple of target types
  * @template Version Version of OpenAPI specification. Default is 3.1
- * @return JSON schema list
+ * @return JSON schema collection
  *
  * @author Jeongho Nam - https://github.com/samchon
  */
 export function schemas(): never;
 
 /**
- * JSON Schemas generator.
+ * JSON Schemas Generator.
  *
  * Creates a JSON schema list which contains both main JSON schemas
  * and components. Note that, all of the named types are stored in the
@@ -47,7 +50,7 @@ export function schemas(): never;
  *
  * @template Types Tuple of target types
  * @template Version Version of OpenAPI specification. Default is 3.1
- * @return JSON schema list
+ * @return JSON schema collection
  *
  * @author Jeongho Nam - https://github.com/samchon
  */
@@ -60,54 +63,60 @@ export function schemas<
  * @internal
  */
 export function schemas(): never {
-  halt("schemas");
+  NoTransformConfigurationError("json.schemas");
 }
 
-// /**
-//  * > You must configure the generic argument `App`.
-//  *
-//  * TypeScript functions to JSON schema based application schema.
-//  *
-//  * Creates an application schema collecting the functions' schema based on the
-//  * JSON schema specification.
-//  *
-//  * The default version of the OpenAPI specification is `"3.1"`, but you can
-//  * specify the version by configuring the second generic argument `Version`.
-//  *
-//  * @template App Target class or interface type collecting the functions
-//  * @template Version Version of OpenAPI specification. Default is 3.1
-//  * @returns Application schema of JSON schema based
-//  *
-//  * @author Jeongho Nam - https://github.com/samchon
-//  */
-// export function application(): never;
-
-// /**
-//  * TypeScript functions to JSON schema based application schema.
-//  *
-//  * Creates an application schema collecting the functions' schema based on the
-//  * JSON schema specification.
-//  *
-//  * The default version of the OpenAPI specification is `"3.1"`, but you can
-//  * specify the version by configuring the second generic argument `Version`.
-//  *
-//  * @template App Target class or interface type collecting the functions
-//  * @template Version Version of OpenAPI specification. Default is 3.1
-//  * @returns Application schema of JSON schema based
-//  *
-//  * @author Jeongho Nam - https://github.com/samchon
-//  */
-// export function application<
-//   App extends object,
-//   Version extends "3.0" | "3.1" = "3.1",
-// >(): IJsonApplication<Version, App>;
-
-// /**
-//  * @internal
-//  */
-// export function application(): never {
-//   halt("application");
-// }
+/**
+ * > You must configure the generic argument `Type`.
+ *
+ * JSON schema generator.
+ *
+ * Creates a JSON schema unit which contains a main JSON schema and
+ * its components. Note that, all of the named types are stored in the
+ * {@link IJsonSchemaUnit.components} property for the `$ref` referencing.
+ *
+ * Also, you can specify the OpenAPI version by configuring the second
+ * generic argument `Version`. For reference, the default version is `"3.1"`,
+ * and key different of `"3.0"` and `"3.1"` is whether supporting the
+ * tuple type or not.
+ *
+ * @template Type Target type
+ * @template Version Version of OpenAPI specification. Default is 3.1
+ * @return JSON schema unit
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export function schema(): never;
+
+/**
+ * JSON schema generator.
+ *
+ * Creates a JSON schema unit which contains a main JSON schema and
+ * its components. Note that, all of the named types are stored in the
+ * {@link IJsonSchemaUnit.components} property for the `$ref` referencing.
+ *
+ * Also, you can specify the OpenAPI version by configuring the second
+ * generic argument `Version`. For reference, the default version is `"3.1"`,
+ * and key different of `"3.0"` and `"3.1"` is whether supporting the
+ * tuple type or not.
+ *
+ * @template Type Target type
+ * @template Version Version of OpenAPI specification. Default is 3.1
+ * @return JSON schema unit
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export function schema<
+  Type extends unknown,
+  Version extends "3.0" | "3.1" = "3.1",
+>(): IJsonSchemaUnit<Version, Type>;
+
+/**
+ * @internal
+ */
+export function schema(): never {
+  NoTransformConfigurationError("json.schema");
+}
 
 /* -----------------------------------------------------------
     PARSE
@@ -165,7 +174,7 @@ export function assertParse<T>(
  * @internal
  */
 export function assertParse<T>(): Primitive<T> {
-  halt("assertParse");
+  NoTransformConfigurationError("json.assertParse");
 }
 
 /**
@@ -212,7 +221,7 @@ export function isParse<T>(input: string): Primitive<T> | null;
  * @internal
  */
 export function isParse<T>(): Primitive<T> | null {
-  halt("isParse");
+  NoTransformConfigurationError("json.isParse");
 }
 
 /**
@@ -261,7 +270,7 @@ export function validateParse<T>(input: string): IValidation<Primitive<T>>;
  * @internal
  */
 export function validateParse<T>(): IValidation<Primitive<T>> {
-  halt("validateParse");
+  NoTransformConfigurationError("json.validateParse");
 }
 
 /* -----------------------------------------------------------
@@ -295,7 +304,7 @@ export function stringify<T>(input: T): string;
  * @internal
  */
 export function stringify(): never {
-  halt("stringify");
+  NoTransformConfigurationError("json.stringify");
 }
 
 /**
@@ -356,7 +365,7 @@ export function assertStringify<T>(
  * @internal
  */
 export function assertStringify(): string {
-  halt("assertStringify");
+  NoTransformConfigurationError("json.assertStringify");
 }
 
 /**
@@ -409,7 +418,7 @@ export function isStringify<T>(input: unknown): string | null;
  * @internal
  */
 export function isStringify(): string | null {
-  halt("isStringify");
+  NoTransformConfigurationError("json.isStringify");
 }
 
 /**
@@ -464,7 +473,7 @@ export function validateStringify<T>(input: unknown): IValidation<string>;
  * @internal
  */
 export function validateStringify(): IValidation<string> {
-  halt("validateStringify");
+  NoTransformConfigurationError("json.validateStringify");
 }
 
 /* -----------------------------------------------------------
@@ -495,7 +504,7 @@ export function createIsParse<T>(): (input: string) => Primitive<T> | null;
  * @internal
  */
 export function createIsParse<T>(): (input: string) => Primitive<T> | null {
-  halt("createIsParse");
+  NoTransformConfigurationError("json.createIsParse");
 }
 
 /**
@@ -529,7 +538,7 @@ export function createAssertParse<T>(
  * @internal
  */
 export function createAssertParse<T>(): (input: string) => Primitive<T> {
-  halt("createAssertParse");
+  NoTransformConfigurationError("json.createAssertParse");
 }
 
 /**
@@ -561,7 +570,7 @@ export function createValidateParse<T>(): (
 export function createValidateParse<T>(): (
   input: string,
 ) => IValidation<Primitive<T>> {
-  halt("createValidateParse");
+  NoTransformConfigurationError("json.createValidateParse");
 }
 
 /**
@@ -589,7 +598,7 @@ export function createStringify<T>(): (input: T) => string;
  * @internal
  */
 export function createStringify<T>(): (input: T) => string {
-  halt("createStringify");
+  NoTransformConfigurationError("json.createStringify");
 }
 
 /**
@@ -623,7 +632,7 @@ export function createAssertStringify<T>(
  * @internal
  */
 export function createAssertStringify(): (input: unknown) => string {
-  halt("createAssertStringify");
+  NoTransformConfigurationError("json.createAssertStringify");
 }
 
 /**
@@ -651,7 +660,7 @@ export function createIsStringify<T>(): (input: unknown) => string | null;
  * @internal
  */
 export function createIsStringify(): (input: unknown) => string | null {
-  halt("createIsStringify");
+  NoTransformConfigurationError("json.createIsStringify");
 }
 
 /**
@@ -683,14 +692,5 @@ export function createValidateStringify<T>(): (
 export function createValidateStringify(): (
   input: unknown,
 ) => IValidation<string> {
-  halt("createValidateStringify");
-}
-
-/**
- * @internal
- */
-function halt(name: string): never {
-  throw new Error(
-    `Error on typia.json.${name}(): no transform has been configured. Read and follow https://typia.io/docs/setup please.`,
-  );
+  NoTransformConfigurationError("json.createValidateStringify");
 }

package/src/llm.ts

@@ -1,5 +1,7 @@
 import { ILlmApplication, ILlmSchema } from "@samchon/openapi";
 
+import { NoTransformConfigurationError } from "./transformers/NoTransformConfigurationError";
+
 /**
  * > You must configure the generic argument `App`.
  *
@@ -120,7 +122,7 @@ export function application<
  * @internal
  */
 export function application(): never {
-  halt("application");
+  NoTransformConfigurationError("llm.application");
 }
 
 /**
@@ -213,7 +215,7 @@ export function parameters<
  * @internal
  */
 export function parameters(): never {
-  halt("parameters");
+  NoTransformConfigurationError("llm.parameters");
 }
 
 /**
@@ -329,14 +331,5 @@ export function schema<
  * @internal
  */
 export function schema(): never {
-  halt("schema");
-}
-
-/**
- * @internal
- */
-function halt(name: string): never {
-  throw new Error(
-    `Error on typia.llm.${name}(): no transform has been configured. Read and follow https://typia.io/docs/setup please.`,
-  );
+  NoTransformConfigurationError("llm.schema");
 }