typia 7.0.0-dev.20241126 → 7.0.0-dev.20241126-2

package/src/schemas/json/IJsonApplication.ts

@@ -1,61 +1,73 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+import { IJsonSchemaCollection } from "./IJsonSchemaCollection";
 
-export interface IJsonApplication<
-  Version extends "3.0" | "3.1" = "3.1",
-  App extends any = object,
-> {
-  version: Version;
-  components: IJsonApplication.IComponents<IJsonApplication.Schema<Version>>;
-  functions: IJsonApplication.IFunction<IJsonApplication.Schema<Version>>[];
-  __application?: App | undefined;
-}
-export namespace IJsonApplication {
-  export type Schema<Version extends "3.0" | "3.1"> = Version extends "3.1"
-    ? OpenApi.IJsonSchema
-    : OpenApiV3.IJsonSchema;
+/**
+ * Collection of JSON schemas.
+ *
+ * @deprecated Use {@link IJsonSchemaCollection} instead please.
+ *             This interface type would be changed to {@link ILlmApplication} like
+ *             structure in the future version (maybe next v8 major update).
+ * @template Version Version of the OpenAPI specification.
+ * @template Types Original TypeScript types used in the JSON schemas.
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export import IJsonApplication = IJsonSchemaCollection;
 
-  export interface IComponents<
-    Schema extends
-      | OpenApi.IJsonSchema
-      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-  > {
-    schemas?: Record<string, Schema>;
-  }
+// export interface IJsonApplication<
+//   Version extends "3.0" | "3.1" = "3.1",
+//   App extends any = object,
+// > {
+//   version: Version;
+//   components: IJsonApplication.IComponents<IJsonApplication.Schema<Version>>;
+//   functions: IJsonApplication.IFunction<IJsonApplication.Schema<Version>>[];
+//   __application?: App | undefined;
+// }
+// export namespace IJsonApplication {
+//   export type Schema<Version extends "3.0" | "3.1"> = Version extends "3.1"
+//     ? OpenApi.IJsonSchema
+//     : OpenApiV3.IJsonSchema;
 
-  export interface IFunction<
-    Schema extends
-      | OpenApi.IJsonSchema
-      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-  > {
-    async: boolean;
-    name: string;
-    parameters: IParameter<Schema>[];
-    output: IOutput<Schema> | undefined;
-    summary?: string | undefined;
-    description?: string | undefined;
-    deprecated?: boolean;
-    tags?: string[];
-  }
+//   export interface IComponents<
+//     Schema extends
+//       | OpenApi.IJsonSchema
+//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+//   > {
+//     schemas?: Record<string, Schema>;
+//   }
 
-  export interface IParameter<
-    Schema extends
-      | OpenApi.IJsonSchema
-      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-  > {
-    name: string;
-    required: boolean;
-    schema: Schema;
-    title?: string | undefined;
-    description?: string | undefined;
-  }
+//   export interface IFunction<
+//     Schema extends
+//       | OpenApi.IJsonSchema
+//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+//   > {
+//     async: boolean;
+//     name: string;
+//     parameters: IParameter<Schema>[];
+//     output: IOutput<Schema> | undefined;
+//     summary?: string | undefined;
+//     description?: string | undefined;
+//     deprecated?: boolean;
+//     tags?: string[];
+//   }
 
-  export interface IOutput<
-    Schema extends
-      | OpenApi.IJsonSchema
-      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-  > {
-    schema: Schema;
-    required: boolean;
-    description?: string | undefined;
-  }
-}
+//   export interface IParameter<
+//     Schema extends
+//       | OpenApi.IJsonSchema
+//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+//   > {
+//     name: string;
+//     required: boolean;
+//     schema: Schema;
+//     title?: string | undefined;
+//     description?: string | undefined;
+//   }
+
+//   export interface IOutput<
+//     Schema extends
+//       | OpenApi.IJsonSchema
+//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+//   > {
+//     schema: Schema;
+//     required: boolean;
+//     description?: string | undefined;
+//   }
+// }

package/src/schemas/json/IJsonSchemaCollection.ts

@@ -1,5 +1,12 @@
 import type { OpenApi, OpenApiV3 } from "@samchon/openapi";
 
+/**
+ * Collection of JSON schemas.
+ *
+ * @template Version Version of the OpenAPI specification.
+ * @template Types Original TypeScript types used in the JSON schemas.
+ * @author Jeongho Nam - https://github.com/samchon
+ */
 export type IJsonSchemaCollection<
   Version extends "3.0" | "3.1" = "3.1",
   Types = unknown[],

package/src/schemas/json/__IJsonApplication.ts

@@ -0,0 +1,63 @@
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+export interface __IJsonApplication<
+  Version extends "3.0" | "3.1" = "3.1",
+  App extends any = object,
+> {
+  version: Version;
+  components: __IJsonApplication.IComponents<
+    __IJsonApplication.Schema<Version>
+  >;
+  functions: __IJsonApplication.IFunction<__IJsonApplication.Schema<Version>>[];
+  __application?: App | undefined;
+}
+export namespace __IJsonApplication {
+  export type Schema<Version extends "3.0" | "3.1"> = Version extends "3.1"
+    ? OpenApi.IJsonSchema
+    : OpenApiV3.IJsonSchema;
+
+  export interface IComponents<
+    Schema extends
+      | OpenApi.IJsonSchema
+      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+  > {
+    schemas?: Record<string, Schema>;
+  }
+
+  export interface IFunction<
+    Schema extends
+      | OpenApi.IJsonSchema
+      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+  > {
+    async: boolean;
+    name: string;
+    parameters: IParameter<Schema>[];
+    output: IOutput<Schema> | undefined;
+    summary?: string | undefined;
+    description?: string | undefined;
+    deprecated?: boolean;
+    tags?: string[];
+  }
+
+  export interface IParameter<
+    Schema extends
+      | OpenApi.IJsonSchema
+      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+  > {
+    name: string;
+    required: boolean;
+    schema: Schema;
+    title?: string | undefined;
+    description?: string | undefined;
+  }
+
+  export interface IOutput<
+    Schema extends
+      | OpenApi.IJsonSchema
+      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+  > {
+    schema: Schema;
+    required: boolean;
+    description?: string | undefined;
+  }
+}

package/src/transformers/CallExpressionTransformer.ts

@@ -50,7 +50,7 @@ import { HttpQueryTransformer } from "./features/http/HttpQueryTransformer";
 import { HttpValidateFormDataTransformer } from "./features/http/HttpValidateFormDataTransformer";
 import { HttpValidateHeadersTransformer } from "./features/http/HttpValidateHeadersTransformer";
 import { HttpValidateQueryTransformer } from "./features/http/HttpValidateQueryTransformer";
-import { JsonApplicationTransformer } from "./features/json/JsonApplicationTransformer";
+// import { JsonApplicationTransformer } from "./features/json/JsonApplicationTransformer";
 import { JsonAssertParseTransformer } from "./features/json/JsonAssertParseTransformer";
 import { JsonAssertStringifyTransformer } from "./features/json/JsonAssertStringifyTransformer";
 import { JsonCreateAssertParseTransformer } from "./features/json/JsonCreateAssertParseTransformer";
@@ -400,7 +400,8 @@ const FUNCTORS: Record<string, Record<string, () => Task>> = {
   },
   json: {
     // METADATA
-    application: () => JsonApplicationTransformer.transform,
+    // application: () => JsonApplicationTransformer.transform,
+    application: () => JsonSchemasTransformer.transform,
     schemas: () => JsonSchemasTransformer.transform,
 
     // PARSER

package/src/transformers/features/json/JsonApplicationTransformer.ts

@@ -1,105 +1,105 @@
-import ts from "typescript";
+// import ts from "typescript";
 
-import { LiteralFactory } from "../../../factories/LiteralFactory";
-import { MetadataCollection } from "../../../factories/MetadataCollection";
-import { MetadataFactory } from "../../../factories/MetadataFactory";
+// import { LiteralFactory } from "../../../factories/LiteralFactory";
+// import { MetadataCollection } from "../../../factories/MetadataCollection";
+// import { MetadataFactory } from "../../../factories/MetadataFactory";
 
-import { IJsonApplication } from "../../../schemas/json/IJsonApplication";
-import { Metadata } from "../../../schemas/metadata/Metadata";
+// import { IJsonApplication } from "../../../schemas/json/IJsonApplication";
+// import { Metadata } from "../../../schemas/metadata/Metadata";
 
-import { JsonApplicationProgrammer } from "../../../programmers/json/JsonApplicationProgrammer";
+// import { JsonApplicationProgrammer } from "../../../programmers/json/JsonApplicationProgrammer";
 
-import { ValidationPipe } from "../../../typings/ValidationPipe";
+// import { ValidationPipe } from "../../../typings/ValidationPipe";
 
-import { ITransformProps } from "../../ITransformProps";
-import { TransformerError } from "../../TransformerError";
+// import { ITransformProps } from "../../ITransformProps";
+// import { TransformerError } from "../../TransformerError";
 
-export namespace JsonApplicationTransformer {
-  export const transform = (props: ITransformProps): ts.Expression => {
-    // GET GENERIC ARGUMENT
-    if (!props.expression.typeArguments?.length)
-      throw new TransformerError({
-        code: "typia.json.application",
-        message: "no generic argument.",
-      });
+// export namespace JsonApplicationTransformer {
+//   export const transform = (props: ITransformProps): ts.Expression => {
+//     // GET GENERIC ARGUMENT
+//     if (!props.expression.typeArguments?.length)
+//       throw new TransformerError({
+//         code: "typia.json.application",
+//         message: "no generic argument.",
+//       });
 
-    const top: ts.Node = props.expression.typeArguments[0]!;
-    if (ts.isTypeNode(top) === false) return props.expression;
+//     const top: ts.Node = props.expression.typeArguments[0]!;
+//     if (ts.isTypeNode(top) === false) return props.expression;
 
-    const version: "3.0" | "3.1" = get_parameter<"3.0" | "3.1">({
-      checker: props.context.checker,
-      name: "Version",
-      is: (str) => str === "3.0" || str === "3.1",
-      cast: (str) => str as "3.0" | "3.1",
-      default: () => "3.1",
-    })(props.expression.typeArguments[1]);
+//     const version: "3.0" | "3.1" = get_parameter<"3.0" | "3.1">({
+//       checker: props.context.checker,
+//       name: "Version",
+//       is: (str) => str === "3.0" || str === "3.1",
+//       cast: (str) => str as "3.0" | "3.1",
+//       default: () => "3.1",
+//     })(props.expression.typeArguments[1]);
 
-    // GET TYPE
-    const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
-    const collection: MetadataCollection = new MetadataCollection({
-      replace: MetadataCollection.replace,
-    });
-    const result: ValidationPipe<Metadata, MetadataFactory.IError> =
-      MetadataFactory.analyze({
-        checker: props.context.checker,
-        transformer: props.context.transformer,
-        options: {
-          escape: true,
-          constant: true,
-          absorb: false,
-          functional: true,
-          validate: JsonApplicationProgrammer.validate,
-        },
-        collection,
-        type,
-      });
-    if (result.success === false)
-      throw TransformerError.from({
-        code: "typia.json.application",
-        errors: result.errors,
-      });
+//     // GET TYPE
+//     const type: ts.Type = props.context.checker.getTypeFromTypeNode(top);
+//     const collection: MetadataCollection = new MetadataCollection({
+//       replace: MetadataCollection.replace,
+//     });
+//     const result: ValidationPipe<Metadata, MetadataFactory.IError> =
+//       MetadataFactory.analyze({
+//         checker: props.context.checker,
+//         transformer: props.context.transformer,
+//         options: {
+//           escape: true,
+//           constant: true,
+//           absorb: false,
+//           functional: true,
+//           validate: JsonApplicationProgrammer.validate,
+//         },
+//         collection,
+//         type,
+//       });
+//     if (result.success === false)
+//       throw TransformerError.from({
+//         code: "typia.json.application",
+//         errors: result.errors,
+//       });
 
-    // GENERATE LLM APPLICATION
-    const app: IJsonApplication<"3.0" | "3.1"> =
-      JsonApplicationProgrammer.write({
-        version,
-        metadata: result.data,
-      });
-    const literal: ts.Expression = LiteralFactory.write(app);
-    return literal;
-  };
+//     // GENERATE LLM APPLICATION
+//     const app: IJsonApplication<"3.0" | "3.1"> =
+//       JsonApplicationProgrammer.write({
+//         version,
+//         metadata: result.data,
+//       });
+//     const literal: ts.Expression = LiteralFactory.write(app);
+//     return literal;
+//   };
 
-  const get_parameter =
-    <Value>(props: {
-      checker: ts.TypeChecker;
-      name: string;
-      is: (value: string) => boolean;
-      cast: (value: string) => Value;
-      default: () => Value;
-    }) =>
-    (node: ts.TypeNode | undefined): Value => {
-      if (!node) return props.default();
+//   const get_parameter =
+//     <Value>(props: {
+//       checker: ts.TypeChecker;
+//       name: string;
+//       is: (value: string) => boolean;
+//       cast: (value: string) => Value;
+//       default: () => Value;
+//     }) =>
+//     (node: ts.TypeNode | undefined): Value => {
+//       if (!node) return props.default();
 
-      // CHECK LITERAL TYPE
-      const type: ts.Type = props.checker.getTypeFromTypeNode(node);
-      if (
-        !type.isLiteral() &&
-        (type.getFlags() & ts.TypeFlags.BooleanLiteral) === 0
-      )
-        throw new TransformerError({
-          code: "typia.json.application",
-          message: `generic argument "${props.name}" must be constant.`,
-        });
+//       // CHECK LITERAL TYPE
+//       const type: ts.Type = props.checker.getTypeFromTypeNode(node);
+//       if (
+//         !type.isLiteral() &&
+//         (type.getFlags() & ts.TypeFlags.BooleanLiteral) === 0
+//       )
+//         throw new TransformerError({
+//           code: "typia.json.application",
+//           message: `generic argument "${props.name}" must be constant.`,
+//         });
 
-      // GET VALUE AND VALIDATE IT
-      const value = type.isLiteral()
-        ? type.value
-        : props.checker.typeToString(type);
-      if (typeof value !== "string" || props.is(value) === false)
-        throw new TransformerError({
-          code: "typia.json.application",
-          message: `invalid value on generic argument "${props.name}".`,
-        });
-      return props.cast(value);
-    };
-}
+//       // GET VALUE AND VALIDATE IT
+//       const value = type.isLiteral()
+//         ? type.value
+//         : props.checker.typeToString(type);
+//       if (typeof value !== "string" || props.is(value) === false)
+//         throw new TransformerError({
+//           code: "typia.json.application",
+//           message: `invalid value on generic argument "${props.name}".`,
+//         });
+//       return props.cast(value);
+//     };
+// }