typia 3.8.2 → 3.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/README.md +1 -1
  2. package/lib/Primitive.d.ts +10 -10
  3. package/lib/factories/MetadataFactory.d.ts +1 -1
  4. package/lib/factories/MetadataFactory.js +1 -1
  5. package/lib/factories/MetadataFactory.js.map +1 -1
  6. package/lib/factories/internal/metadata/emplace_metadata_object.js +3 -1
  7. package/lib/factories/internal/metadata/emplace_metadata_object.js.map +1 -1
  8. package/lib/factories/internal/metadata/iterate_metadata_tuple.js +2 -0
  9. package/lib/factories/internal/metadata/iterate_metadata_tuple.js.map +1 -1
  10. package/lib/metadata/IMetadata.d.ts +1 -0
  11. package/lib/metadata/Metadata.d.ts +1 -0
  12. package/lib/metadata/Metadata.js +5 -0
  13. package/lib/metadata/Metadata.js.map +1 -1
  14. package/lib/programmers/CheckerProgrammer.js +17 -6
  15. package/lib/programmers/CheckerProgrammer.js.map +1 -1
  16. package/lib/programmers/internal/application_object.js +1 -0
  17. package/lib/programmers/internal/application_object.js.map +1 -1
  18. package/lib/programmers/internal/application_tuple.js +1 -1
  19. package/lib/programmers/internal/application_tuple.js.map +1 -1
  20. package/lib/schemas/IJsonSchema.d.ts +1 -0
  21. package/package.json +1 -1
  22. package/src/Primitive.ts +123 -120
  23. package/src/executable/TypiaGenerateWizard.ts +85 -85
  24. package/src/executable/TypiaSetupWizard.ts +133 -133
  25. package/src/executable/setup/CommandExecutor.ts +8 -8
  26. package/src/executable/setup/PackageManager.ts +71 -71
  27. package/src/executable/typia.ts +52 -52
  28. package/src/factories/CommentFactory.ts +14 -14
  29. package/src/factories/ExpressionFactory.ts +70 -70
  30. package/src/factories/IdentifierFactory.ts +63 -63
  31. package/src/factories/LiteralFactory.ts +39 -39
  32. package/src/factories/MetadataCollection.ts +121 -121
  33. package/src/factories/MetadataFactory.ts +62 -62
  34. package/src/factories/MetadataTagFactory.ts +297 -297
  35. package/src/factories/StatementFactory.ts +24 -24
  36. package/src/factories/TemplateFactory.ts +58 -58
  37. package/src/factories/TypeFactory.ts +124 -124
  38. package/src/factories/internal/metadata/MetadataHelper.ts +12 -12
  39. package/src/factories/internal/metadata/emplace_metadata_object.ts +143 -140
  40. package/src/factories/internal/metadata/iterate_metadata.ts +67 -67
  41. package/src/factories/internal/metadata/iterate_metadata_map.ts +41 -41
  42. package/src/factories/internal/metadata/iterate_metadata_native.ts +219 -219
  43. package/src/factories/internal/metadata/iterate_metadata_resolve.ts +27 -27
  44. package/src/factories/internal/metadata/iterate_metadata_set.ts +33 -33
  45. package/src/factories/internal/metadata/iterate_metadata_tuple.ts +48 -44
  46. package/src/factories/internal/metadata/iterate_metadata_union.ts +57 -57
  47. package/src/functional/$any.ts +2 -2
  48. package/src/functional/$is_between.ts +2 -2
  49. package/src/functional/$is_custom.ts +14 -14
  50. package/src/functional/$is_date.ts +3 -3
  51. package/src/functional/$is_datetime.ts +2 -2
  52. package/src/functional/$is_email.ts +4 -4
  53. package/src/functional/$is_ipv4.ts +4 -4
  54. package/src/functional/$is_ipv6.ts +4 -4
  55. package/src/functional/$is_url.ts +4 -4
  56. package/src/functional/$is_uuid.ts +4 -4
  57. package/src/functional/$join.ts +46 -46
  58. package/src/functional/$number.ts +12 -12
  59. package/src/functional/$rest.ts +3 -3
  60. package/src/functional/$string.ts +37 -37
  61. package/src/functional/$tail.ts +5 -5
  62. package/src/metadata/IMetadata.ts +1 -0
  63. package/src/metadata/Metadata.ts +539 -533
  64. package/src/metadata/MetadataConstant.ts +3 -3
  65. package/src/metadata/MetadataObject.ts +127 -127
  66. package/src/module.ts +2043 -2043
  67. package/src/programmers/ApplicationProgrammer.ts +62 -62
  68. package/src/programmers/AssertCloneProgrammer.ts +79 -79
  69. package/src/programmers/AssertParseProgrammer.ts +74 -74
  70. package/src/programmers/AssertProgrammer.ts +285 -285
  71. package/src/programmers/AssertPruneProgrammer.ts +76 -76
  72. package/src/programmers/AssertStringifyProgrammer.ts +74 -74
  73. package/src/programmers/CheckerProgrammer.ts +901 -875
  74. package/src/programmers/CloneProgrammer.ts +389 -389
  75. package/src/programmers/FeatureProgrammer.ts +500 -500
  76. package/src/programmers/IsCloneProgrammer.ts +86 -86
  77. package/src/programmers/IsParseProgrammer.ts +80 -80
  78. package/src/programmers/IsProgrammer.ts +212 -212
  79. package/src/programmers/IsPruneProgrammer.ts +81 -81
  80. package/src/programmers/IsStringifyProgrammer.ts +84 -84
  81. package/src/programmers/LiteralsProgrammer.ts +65 -65
  82. package/src/programmers/PruneProgrammer.ts +347 -347
  83. package/src/programmers/RandomProgrammer.ts +423 -423
  84. package/src/programmers/StringifyProgrammer.ts +798 -798
  85. package/src/programmers/TypiaProgrammer.ts +129 -129
  86. package/src/programmers/ValidateCloneProgrammer.ts +93 -93
  87. package/src/programmers/ValidateParseProgrammer.ts +78 -78
  88. package/src/programmers/ValidateProgrammer.ts +316 -316
  89. package/src/programmers/ValidatePruneProgrammer.ts +86 -86
  90. package/src/programmers/ValidateStringifyProgrammer.ts +92 -92
  91. package/src/programmers/helpers/CloneJoiner.ts +131 -131
  92. package/src/programmers/helpers/FunctionImporeter.ts +54 -54
  93. package/src/programmers/helpers/OptionPredicator.ts +15 -15
  94. package/src/programmers/helpers/PruneJoiner.ts +144 -144
  95. package/src/programmers/helpers/StringifyJoinder.ts +113 -113
  96. package/src/programmers/helpers/StringifyPredicator.ts +12 -12
  97. package/src/programmers/helpers/UnionExplorer.ts +275 -275
  98. package/src/programmers/helpers/UnionPredicator.ts +81 -81
  99. package/src/programmers/internal/application_array.ts +36 -36
  100. package/src/programmers/internal/application_boolean.ts +17 -17
  101. package/src/programmers/internal/application_constant.ts +30 -30
  102. package/src/programmers/internal/application_default_string.ts +33 -33
  103. package/src/programmers/internal/application_native.ts +32 -32
  104. package/src/programmers/internal/application_number.ts +73 -73
  105. package/src/programmers/internal/application_object.ts +155 -154
  106. package/src/programmers/internal/application_schema.ts +213 -213
  107. package/src/programmers/internal/application_string.ts +45 -45
  108. package/src/programmers/internal/application_templates.ts +26 -26
  109. package/src/programmers/internal/application_tuple.ts +31 -29
  110. package/src/programmers/internal/check_array.ts +30 -30
  111. package/src/programmers/internal/check_custom.ts +31 -31
  112. package/src/programmers/internal/check_dynamic_properties.ts +194 -194
  113. package/src/programmers/internal/check_everything.ts +28 -28
  114. package/src/programmers/internal/check_native.ts +21 -21
  115. package/src/programmers/internal/check_string_tags.ts +67 -67
  116. package/src/programmers/internal/check_union_array_like.ts +271 -271
  117. package/src/programmers/internal/check_union_tuple.ts +33 -33
  118. package/src/programmers/internal/random_custom.ts +29 -29
  119. package/src/programmers/internal/stringify_dynamic_properties.ts +167 -167
  120. package/src/programmers/internal/stringify_native.ts +7 -7
  121. package/src/programmers/internal/stringify_regular_properties.ts +83 -83
  122. package/src/schemas/IJsonSchema.ts +130 -129
  123. package/src/transform.ts +17 -17
  124. package/src/transformers/CallExpressionTransformer.ts +177 -177
  125. package/src/transformers/FileTransformer.ts +47 -47
  126. package/src/transformers/NodeTransformer.ts +13 -13
  127. package/src/transformers/features/miscellaneous/ApplicationTransformer.ts +114 -114
  128. package/src/transformers/features/miscellaneous/AssertCloneTransformer.ts +9 -9
  129. package/src/transformers/features/miscellaneous/AssertPruneTransformer.ts +9 -9
  130. package/src/transformers/features/miscellaneous/CloneTransformer.ts +9 -9
  131. package/src/transformers/features/miscellaneous/CreateAssertCloneTransformer.ts +9 -9
  132. package/src/transformers/features/miscellaneous/CreateAssertPruneTransformer.ts +9 -9
  133. package/src/transformers/features/miscellaneous/CreateCloneTransformer.ts +9 -9
  134. package/src/transformers/features/miscellaneous/CreateIsCloneTransformer.ts +9 -9
  135. package/src/transformers/features/miscellaneous/CreateIsPruneTransformer.ts +9 -9
  136. package/src/transformers/features/miscellaneous/CreatePruneTransformer.ts +9 -9
  137. package/src/transformers/features/miscellaneous/CreateRandomTransformer.ts +39 -39
  138. package/src/transformers/features/miscellaneous/CreateValidateCloneTransformer.ts +9 -9
  139. package/src/transformers/features/miscellaneous/CreateValidatePruneTransformer.ts +9 -9
  140. package/src/transformers/features/miscellaneous/IsCloneTransformer.ts +9 -9
  141. package/src/transformers/features/miscellaneous/IsPruneTransformer.ts +9 -9
  142. package/src/transformers/features/miscellaneous/LiteralsTransformer.ts +28 -28
  143. package/src/transformers/features/miscellaneous/MetadataTransformer.ts +52 -52
  144. package/src/transformers/features/miscellaneous/PruneTransformer.ts +9 -9
  145. package/src/transformers/features/miscellaneous/RandomTransformer.ts +42 -42
  146. package/src/transformers/features/miscellaneous/ValidateCloneTransformer.ts +9 -9
  147. package/src/transformers/features/miscellaneous/ValidatePruneTransformer.ts +9 -9
  148. package/src/transformers/features/parsers/AssertParseTransformer.ts +9 -9
  149. package/src/transformers/features/parsers/CreateAssertParseTransformer.ts +9 -9
  150. package/src/transformers/features/parsers/CreateIsParseTransformer.ts +9 -9
  151. package/src/transformers/features/parsers/CreateValidateParseTransformer.ts +9 -9
  152. package/src/transformers/features/parsers/IsParseTransformer.ts +9 -9
  153. package/src/transformers/features/parsers/ValidateParseTransformer.ts +9 -9
  154. package/src/transformers/features/stringifiers/AssertStringifyTransformer.ts +10 -10
  155. package/src/transformers/features/stringifiers/CreateAssertStringifyTransformer.ts +12 -12
  156. package/src/transformers/features/stringifiers/CreateIsStringifyTransformer.ts +9 -9
  157. package/src/transformers/features/stringifiers/CreateStringifyTransformer.ts +9 -9
  158. package/src/transformers/features/stringifiers/CreateValidateStringifyProgrammer.ts +12 -12
  159. package/src/transformers/features/stringifiers/IsStringifyTransformer.ts +9 -9
  160. package/src/transformers/features/stringifiers/StringifyTransformer.ts +9 -9
  161. package/src/transformers/features/stringifiers/ValidateStringifyTransformer.ts +10 -10
  162. package/src/transformers/features/validators/AssertTransformer.ts +11 -11
  163. package/src/transformers/features/validators/CreateAssertTransformer.ts +13 -13
  164. package/src/transformers/features/validators/CreateIsTransformer.ts +11 -11
  165. package/src/transformers/features/validators/CreateValidateTransformer.ts +13 -13
  166. package/src/transformers/features/validators/IsTransformer.ts +11 -11
  167. package/src/transformers/features/validators/ValidateTransformer.ts +11 -11
  168. package/src/transformers/internal/GenericTransformer.ts +97 -97
  169. package/src/utils/ArrayUtil.ts +44 -44
  170. package/src/utils/Escaper.ts +45 -45
  171. package/src/utils/MapUtil.ts +12 -12
  172. package/src/utils/PatternUtil.ts +30 -30
  173. package/src/utils/RandomGenerator.ts +81 -81
@@ -1,154 +1,155 @@
1
- import { CommentFactory } from "../../factories/CommentFactory";
2
-
3
- import { IJsDocTagInfo } from "../../metadata/IJsDocTagInfo";
4
- import { Metadata } from "../../metadata/Metadata";
5
- import { MetadataObject } from "../../metadata/MetadataObject";
6
- import { IJsonComponents } from "../../schemas/IJsonComponents";
7
-
8
- import { PatternUtil } from "../../utils/PatternUtil";
9
-
10
- import { IJsonSchema } from "../../module";
11
- import { ApplicationProgrammer } from "../ApplicationProgrammer";
12
- import { application_schema } from "./application_schema";
13
- import { metadata_to_pattern } from "./metadata_to_pattern";
14
-
15
- /**
16
- * @internal
17
- */
18
- export const application_object =
19
- (options: ApplicationProgrammer.IOptions) =>
20
- (components: IJsonComponents) =>
21
- (obj: MetadataObject) =>
22
- (props: { key: string; nullable: boolean }): void => {
23
- // TEMPORARY ASSIGNMENT
24
- if (components.schemas[props.key] !== undefined) return;
25
- components.schemas[props.key] = {} as any;
26
-
27
- // ITERATE PROPERTIES
28
- const properties: Record<string, any> = {};
29
- const extraMeta: ISuperfluous = {
30
- patternProperties: {},
31
- additionalProperties: undefined,
32
- };
33
- const required: string[] = [];
34
-
35
- for (const property of obj.properties) {
36
- if (
37
- property.value.functional === true &&
38
- property.value.nullable === false &&
39
- property.value.required === true &&
40
- property.value.size() === 0
41
- )
42
- continue;
43
-
44
- const key: string | null = property.key.getSoleLiteral();
45
- const schema: IJsonSchema | null = application_schema(options)(
46
- true,
47
- )(components)(property.value)({
48
- deprecated:
49
- !!property.jsDocTags.find(
50
- (tag) => tag.name === "deprecated",
51
- ) || undefined,
52
- title: (() => {
53
- const info: IJsDocTagInfo | undefined =
54
- property.jsDocTags.find((tag) => tag.name === "title");
55
- return info?.text?.length
56
- ? CommentFactory.string(info.text)
57
- : undefined;
58
- })(),
59
- description: property.description,
60
- "x-typia-metaTags": property.tags.length
61
- ? property.tags
62
- : undefined,
63
- "x-typia-jsDocTags": property.jsDocTags.length
64
- ? property.jsDocTags
65
- : undefined,
66
- "x-typia-required": property.value.required,
67
- });
68
-
69
- if (schema === null) continue;
70
- else if (key !== null) {
71
- properties[key] = schema;
72
- if (property.value.required === true) required.push(key);
73
- } else {
74
- const pattern: string = metadata_to_pattern(true)(property.key);
75
- if (pattern === PatternUtil.STRING)
76
- extraMeta.additionalProperties = [property.value, schema];
77
- else
78
- extraMeta.patternProperties[pattern] = [
79
- property.value,
80
- schema,
81
- ];
82
- }
83
- }
84
-
85
- const extraProps = {
86
- additionalProperties: extraMeta.additionalProperties?.[1],
87
- patternProperties: (() => {
88
- if (Object.keys(extraMeta.patternProperties).length === 0)
89
- return undefined;
90
- const output: Record<string, IJsonSchema> = {};
91
- for (const [key, value] of Object.entries(
92
- extraMeta.patternProperties,
93
- ))
94
- output[key] = value[1];
95
- return output;
96
- })(),
97
- };
98
- const schema: IJsonComponents.IObject = {
99
- $id:
100
- options.purpose === "ajv"
101
- ? options.prefix + "/" + props.key
102
- : undefined,
103
- $recursiveAnchor:
104
- (options.purpose === "ajv" && obj.recursive) || undefined,
105
- type: "object",
106
- properties,
107
- nullable: props.nullable,
108
- required: required.length ? required : undefined,
109
- description: obj.description,
110
- "x-typia-jsDocTags": obj.jsDocTags,
111
- ...(options.purpose === "ajv"
112
- ? extraProps
113
- : {
114
- // swagger can't express patternProperties
115
- "x-typia-additionalProperties":
116
- extraProps.additionalProperties,
117
- "x-typia-patternProperties": extraProps.patternProperties,
118
- additionalProperties:
119
- join(options)(components)(extraMeta),
120
- }),
121
- };
122
- components.schemas[props.key] = schema;
123
- };
124
-
125
- const join =
126
- (options: ApplicationProgrammer.IOptions) =>
127
- (components: IJsonComponents) =>
128
- (extra: ISuperfluous): IJsonSchema | undefined => {
129
- // LIST UP METADATA
130
- const elements: [Metadata, IJsonSchema][] = Object.values(
131
- extra.patternProperties || {},
132
- );
133
- if (extra.additionalProperties)
134
- elements.push(extra.additionalProperties);
135
-
136
- // SHORT RETURN
137
- if (elements.length === 0) return undefined;
138
- else if (elements.length === 1) return elements[0]![1]!;
139
-
140
- // MERGE METADATA AND GENERATE VULNERABLE SCHEMA
141
- const meta: Metadata = elements
142
- .map((tuple) => tuple[0])
143
- .reduce((x, y) => Metadata.merge(x, y));
144
- return (
145
- application_schema(options)(true)(components)(meta)({
146
- "x-typia-required": false,
147
- }) ?? undefined
148
- );
149
- };
150
-
151
- interface ISuperfluous {
152
- additionalProperties?: [Metadata, IJsonSchema];
153
- patternProperties: Record<string, [Metadata, IJsonSchema]>;
154
- }
1
+ import { CommentFactory } from "../../factories/CommentFactory";
2
+
3
+ import { IJsDocTagInfo } from "../../metadata/IJsDocTagInfo";
4
+ import { Metadata } from "../../metadata/Metadata";
5
+ import { MetadataObject } from "../../metadata/MetadataObject";
6
+ import { IJsonComponents } from "../../schemas/IJsonComponents";
7
+
8
+ import { PatternUtil } from "../../utils/PatternUtil";
9
+
10
+ import { IJsonSchema } from "../../module";
11
+ import { ApplicationProgrammer } from "../ApplicationProgrammer";
12
+ import { application_schema } from "./application_schema";
13
+ import { metadata_to_pattern } from "./metadata_to_pattern";
14
+
15
+ /**
16
+ * @internal
17
+ */
18
+ export const application_object =
19
+ (options: ApplicationProgrammer.IOptions) =>
20
+ (components: IJsonComponents) =>
21
+ (obj: MetadataObject) =>
22
+ (props: { key: string; nullable: boolean }): void => {
23
+ // TEMPORARY ASSIGNMENT
24
+ if (components.schemas[props.key] !== undefined) return;
25
+ components.schemas[props.key] = {} as any;
26
+
27
+ // ITERATE PROPERTIES
28
+ const properties: Record<string, any> = {};
29
+ const extraMeta: ISuperfluous = {
30
+ patternProperties: {},
31
+ additionalProperties: undefined,
32
+ };
33
+ const required: string[] = [];
34
+
35
+ for (const property of obj.properties) {
36
+ if (
37
+ property.value.functional === true &&
38
+ property.value.nullable === false &&
39
+ property.value.required === true &&
40
+ property.value.size() === 0
41
+ )
42
+ continue;
43
+
44
+ const key: string | null = property.key.getSoleLiteral();
45
+ const schema: IJsonSchema | null = application_schema(options)(
46
+ true,
47
+ )(components)(property.value)({
48
+ deprecated:
49
+ !!property.jsDocTags.find(
50
+ (tag) => tag.name === "deprecated",
51
+ ) || undefined,
52
+ title: (() => {
53
+ const info: IJsDocTagInfo | undefined =
54
+ property.jsDocTags.find((tag) => tag.name === "title");
55
+ return info?.text?.length
56
+ ? CommentFactory.string(info.text)
57
+ : undefined;
58
+ })(),
59
+ description: property.description,
60
+ "x-typia-metaTags": property.tags.length
61
+ ? property.tags
62
+ : undefined,
63
+ "x-typia-jsDocTags": property.jsDocTags.length
64
+ ? property.jsDocTags
65
+ : undefined,
66
+ "x-typia-required": property.value.required,
67
+ "x-typia-optional": property.value.optional,
68
+ });
69
+
70
+ if (schema === null) continue;
71
+ else if (key !== null) {
72
+ properties[key] = schema;
73
+ if (property.value.required === true) required.push(key);
74
+ } else {
75
+ const pattern: string = metadata_to_pattern(true)(property.key);
76
+ if (pattern === PatternUtil.STRING)
77
+ extraMeta.additionalProperties = [property.value, schema];
78
+ else
79
+ extraMeta.patternProperties[pattern] = [
80
+ property.value,
81
+ schema,
82
+ ];
83
+ }
84
+ }
85
+
86
+ const extraProps = {
87
+ additionalProperties: extraMeta.additionalProperties?.[1],
88
+ patternProperties: (() => {
89
+ if (Object.keys(extraMeta.patternProperties).length === 0)
90
+ return undefined;
91
+ const output: Record<string, IJsonSchema> = {};
92
+ for (const [key, value] of Object.entries(
93
+ extraMeta.patternProperties,
94
+ ))
95
+ output[key] = value[1];
96
+ return output;
97
+ })(),
98
+ };
99
+ const schema: IJsonComponents.IObject = {
100
+ $id:
101
+ options.purpose === "ajv"
102
+ ? options.prefix + "/" + props.key
103
+ : undefined,
104
+ $recursiveAnchor:
105
+ (options.purpose === "ajv" && obj.recursive) || undefined,
106
+ type: "object",
107
+ properties,
108
+ nullable: props.nullable,
109
+ required: required.length ? required : undefined,
110
+ description: obj.description,
111
+ "x-typia-jsDocTags": obj.jsDocTags,
112
+ ...(options.purpose === "ajv"
113
+ ? extraProps
114
+ : {
115
+ // swagger can't express patternProperties
116
+ "x-typia-additionalProperties":
117
+ extraProps.additionalProperties,
118
+ "x-typia-patternProperties": extraProps.patternProperties,
119
+ additionalProperties:
120
+ join(options)(components)(extraMeta),
121
+ }),
122
+ };
123
+ components.schemas[props.key] = schema;
124
+ };
125
+
126
+ const join =
127
+ (options: ApplicationProgrammer.IOptions) =>
128
+ (components: IJsonComponents) =>
129
+ (extra: ISuperfluous): IJsonSchema | undefined => {
130
+ // LIST UP METADATA
131
+ const elements: [Metadata, IJsonSchema][] = Object.values(
132
+ extra.patternProperties || {},
133
+ );
134
+ if (extra.additionalProperties)
135
+ elements.push(extra.additionalProperties);
136
+
137
+ // SHORT RETURN
138
+ if (elements.length === 0) return undefined;
139
+ else if (elements.length === 1) return elements[0]![1]!;
140
+
141
+ // MERGE METADATA AND GENERATE VULNERABLE SCHEMA
142
+ const meta: Metadata = elements
143
+ .map((tuple) => tuple[0])
144
+ .reduce((x, y) => Metadata.merge(x, y));
145
+ return (
146
+ application_schema(options)(true)(components)(meta)({
147
+ "x-typia-required": false,
148
+ }) ?? undefined
149
+ );
150
+ };
151
+
152
+ interface ISuperfluous {
153
+ additionalProperties?: [Metadata, IJsonSchema];
154
+ patternProperties: Record<string, [Metadata, IJsonSchema]>;
155
+ }