typia 7.2.1 → 7.3.0-dev.20241213

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 (447) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +148 -148
  3. package/lib/executable/typia.js +0 -0
  4. package/lib/programmers/llm/LlmApplicationProgrammer.js +0 -1
  5. package/lib/programmers/llm/LlmApplicationProgrammer.js.map +1 -1
  6. package/package.json +3 -3
  7. package/src/IRandomGenerator.ts +49 -49
  8. package/src/IReadableURLSearchParams.ts +9 -9
  9. package/src/IValidation.ts +21 -21
  10. package/src/executable/TypiaGenerateWizard.ts +83 -83
  11. package/src/executable/TypiaPatchWizard.ts +45 -45
  12. package/src/executable/TypiaSetupWizard.ts +179 -179
  13. package/src/executable/setup/ArgumentParser.ts +42 -42
  14. package/src/executable/setup/FileRetriever.ts +19 -19
  15. package/src/executable/setup/PackageManager.ts +87 -87
  16. package/src/factories/ExpressionFactory.ts +216 -216
  17. package/src/factories/IdentifierFactory.ts +89 -89
  18. package/src/factories/JsonMetadataFactory.ts +76 -76
  19. package/src/factories/LiteralFactory.ts +52 -52
  20. package/src/factories/MetadataCollection.ts +278 -278
  21. package/src/factories/MetadataCommentTagFactory.ts +650 -650
  22. package/src/factories/MetadataFactory.ts +404 -404
  23. package/src/factories/MetadataTypeTagFactory.ts +411 -411
  24. package/src/factories/MetadataTypeTagSchemaFactory.ts +82 -82
  25. package/src/factories/NumericRangeFactory.ts +72 -72
  26. package/src/factories/ProtobufFactory.ts +875 -875
  27. package/src/factories/StatementFactory.ts +90 -90
  28. package/src/factories/TemplateFactory.ts +64 -64
  29. package/src/factories/TypeFactory.ts +140 -140
  30. package/src/factories/internal/metadata/IMetadataIteratorProps.ts +17 -17
  31. package/src/factories/internal/metadata/MetadataHelper.ts +21 -21
  32. package/src/factories/internal/metadata/emplace_metadata_alias.ts +33 -33
  33. package/src/factories/internal/metadata/emplace_metadata_array_type.ts +39 -39
  34. package/src/factories/internal/metadata/emplace_metadata_object.ts +208 -208
  35. package/src/factories/internal/metadata/emplace_metadata_tuple.ts +57 -57
  36. package/src/factories/internal/metadata/explore_metadata.ts +31 -31
  37. package/src/factories/internal/metadata/iterate_metadata.ts +54 -54
  38. package/src/factories/internal/metadata/iterate_metadata_alias.ts +33 -33
  39. package/src/factories/internal/metadata/iterate_metadata_array.ts +63 -63
  40. package/src/factories/internal/metadata/iterate_metadata_atomic.ts +62 -62
  41. package/src/factories/internal/metadata/iterate_metadata_coalesce.ts +28 -28
  42. package/src/factories/internal/metadata/iterate_metadata_collection.ts +146 -146
  43. package/src/factories/internal/metadata/iterate_metadata_comment_tags.ts +32 -32
  44. package/src/factories/internal/metadata/iterate_metadata_constant.ts +76 -76
  45. package/src/factories/internal/metadata/iterate_metadata_escape.ts +49 -49
  46. package/src/factories/internal/metadata/iterate_metadata_function.ts +91 -91
  47. package/src/factories/internal/metadata/iterate_metadata_intersection.ts +213 -213
  48. package/src/factories/internal/metadata/iterate_metadata_map.ts +57 -57
  49. package/src/factories/internal/metadata/iterate_metadata_native.ts +255 -255
  50. package/src/factories/internal/metadata/iterate_metadata_object.ts +35 -35
  51. package/src/factories/internal/metadata/iterate_metadata_set.ts +57 -57
  52. package/src/factories/internal/metadata/iterate_metadata_sort.ts +87 -87
  53. package/src/factories/internal/metadata/iterate_metadata_template.ts +41 -41
  54. package/src/factories/internal/metadata/iterate_metadata_tuple.ts +26 -26
  55. package/src/factories/internal/metadata/iterate_metadata_union.ts +19 -19
  56. package/src/functional.ts +750 -750
  57. package/src/http.ts +1047 -1047
  58. package/src/internal/_IProtobufWriter.ts +18 -18
  59. package/src/internal/_ProtobufReader.ts +194 -194
  60. package/src/internal/_ProtobufSizer.ts +145 -145
  61. package/src/internal/_ProtobufWriter.ts +145 -145
  62. package/src/internal/_accessExpressionAsString.ts +46 -46
  63. package/src/internal/_assertGuard.ts +13 -13
  64. package/src/internal/_functionalTypeGuardErrorFactory.ts +4 -4
  65. package/src/internal/_httpFormDataReadArray.ts +4 -4
  66. package/src/internal/_httpFormDataReadBigint.ts +18 -18
  67. package/src/internal/_httpFormDataReadBlob.ts +10 -10
  68. package/src/internal/_httpFormDataReadBoolean.ts +16 -16
  69. package/src/internal/_httpFormDataReadFile.ts +10 -10
  70. package/src/internal/_httpFormDataReadNumber.ts +15 -15
  71. package/src/internal/_httpFormDataReadString.ts +10 -10
  72. package/src/internal/_httpHeaderReadBigint.ts +10 -10
  73. package/src/internal/_httpHeaderReadBoolean.ts +8 -8
  74. package/src/internal/_httpHeaderReadNumber.ts +7 -7
  75. package/src/internal/_httpParameterReadBigint.ts +10 -10
  76. package/src/internal/_httpParameterReadBoolean.ts +8 -8
  77. package/src/internal/_httpParameterReadNumber.ts +7 -7
  78. package/src/internal/_httpParameterReadString.ts +2 -2
  79. package/src/internal/_httpQueryParseURLSearchParams.ts +12 -12
  80. package/src/internal/_httpQueryReadArray.ts +4 -4
  81. package/src/internal/_httpQueryReadBigint.ts +12 -12
  82. package/src/internal/_httpQueryReadBoolean.ts +14 -14
  83. package/src/internal/_httpQueryReadNumber.ts +9 -9
  84. package/src/internal/_httpQueryReadString.ts +4 -4
  85. package/src/internal/_isBetween.ts +2 -2
  86. package/src/internal/_isBigintString.ts +8 -8
  87. package/src/internal/_isFormatByte.ts +7 -7
  88. package/src/internal/_isFormatDate.ts +3 -3
  89. package/src/internal/_isFormatDateTime.ts +4 -4
  90. package/src/internal/_isFormatDuration.ts +4 -4
  91. package/src/internal/_isFormatEmail.ts +4 -4
  92. package/src/internal/_isFormatHostname.ts +4 -4
  93. package/src/internal/_isFormatIdnEmail.ts +4 -4
  94. package/src/internal/_isFormatIdnHostname.ts +4 -4
  95. package/src/internal/_isFormatIpv4.ts +4 -4
  96. package/src/internal/_isFormatIpv6.ts +4 -4
  97. package/src/internal/_isFormatIri.ts +3 -3
  98. package/src/internal/_isFormatIriReference.ts +4 -4
  99. package/src/internal/_isFormatJsonPointer.ts +3 -3
  100. package/src/internal/_isFormatPassword.ts +1 -1
  101. package/src/internal/_isFormatRegex.ts +8 -8
  102. package/src/internal/_isFormatRelativeJsonPointer.ts +4 -4
  103. package/src/internal/_isFormatTime.ts +4 -4
  104. package/src/internal/_isFormatUri.ts +6 -6
  105. package/src/internal/_isFormatUriReference.ts +5 -5
  106. package/src/internal/_isFormatUriTemplate.ts +4 -4
  107. package/src/internal/_isFormatUrl.ts +4 -4
  108. package/src/internal/_isFormatUuid.ts +3 -3
  109. package/src/internal/_isTypeFloat.ts +5 -5
  110. package/src/internal/_isTypeInt32.ts +5 -5
  111. package/src/internal/_isTypeInt64.ts +5 -5
  112. package/src/internal/_isTypeUint32.ts +5 -5
  113. package/src/internal/_isTypeUint64.ts +5 -5
  114. package/src/internal/_isUniqueItems.ts +159 -159
  115. package/src/internal/_jsonStringifyNumber.ts +12 -12
  116. package/src/internal/_jsonStringifyRest.ts +3 -3
  117. package/src/internal/_jsonStringifyString.ts +42 -42
  118. package/src/internal/_jsonStringifyTail.ts +2 -2
  119. package/src/internal/_llmApplicationFinalize.ts +20 -20
  120. package/src/internal/_miscCloneAny.ts +46 -46
  121. package/src/internal/_notationAny.ts +37 -37
  122. package/src/internal/_notationCamel.ts +13 -13
  123. package/src/internal/_notationPascal.ts +8 -8
  124. package/src/internal/_notationSnake.ts +43 -43
  125. package/src/internal/_randomArray.ts +21 -21
  126. package/src/internal/_randomBigint.ts +6 -6
  127. package/src/internal/_randomBoolean.ts +1 -1
  128. package/src/internal/_randomFormatByte.ts +3 -3
  129. package/src/internal/_randomFormatDate.ts +18 -18
  130. package/src/internal/_randomFormatDatetime.ts +16 -16
  131. package/src/internal/_randomFormatDuration.ts +27 -27
  132. package/src/internal/_randomFormatEmail.ts +11 -11
  133. package/src/internal/_randomFormatHostname.ts +6 -6
  134. package/src/internal/_randomFormatIdnEmail.ts +3 -3
  135. package/src/internal/_randomFormatIdnHostname.ts +3 -3
  136. package/src/internal/_randomFormatIpv4.ts +11 -11
  137. package/src/internal/_randomFormatIpv6.ts +11 -11
  138. package/src/internal/_randomFormatIri.ts +3 -3
  139. package/src/internal/_randomFormatIriReference.ts +3 -3
  140. package/src/internal/_randomFormatJsonPointer.ts +7 -7
  141. package/src/internal/_randomFormatPassword.ts +8 -8
  142. package/src/internal/_randomFormatRegex.ts +4 -4
  143. package/src/internal/_randomFormatRelativeJsonPointer.ts +8 -8
  144. package/src/internal/_randomFormatTime.ts +14 -14
  145. package/src/internal/_randomFormatUri.ts +3 -3
  146. package/src/internal/_randomFormatUriReference.ts +3 -3
  147. package/src/internal/_randomFormatUriTemplate.ts +3 -3
  148. package/src/internal/_randomFormatUrl.ts +11 -11
  149. package/src/internal/_randomFormatUuid.ts +6 -6
  150. package/src/internal/_randomInteger.ts +47 -47
  151. package/src/internal/_randomNumber.ts +74 -74
  152. package/src/internal/_randomPattern.ts +10 -10
  153. package/src/internal/_randomPick.ts +9 -9
  154. package/src/internal/_randomString.ts +24 -24
  155. package/src/internal/_throwTypeGuardError.ts +5 -5
  156. package/src/internal/_validateReport.ts +13 -13
  157. package/src/internal/private/__notationCapitalize.ts +2 -2
  158. package/src/internal/private/__notationUnsnake.ts +24 -24
  159. package/src/json.ts +752 -752
  160. package/src/llm.ts +481 -481
  161. package/src/misc.ts +658 -658
  162. package/src/module.ts +937 -937
  163. package/src/notations.ts +827 -827
  164. package/src/programmers/AssertProgrammer.ts +454 -454
  165. package/src/programmers/CheckerProgrammer.ts +1617 -1617
  166. package/src/programmers/FeatureProgrammer.ts +622 -622
  167. package/src/programmers/ImportProgrammer.ts +185 -185
  168. package/src/programmers/IsProgrammer.ts +273 -273
  169. package/src/programmers/RandomProgrammer.ts +1190 -1190
  170. package/src/programmers/TypiaProgrammer.ts +174 -174
  171. package/src/programmers/ValidateProgrammer.ts +439 -439
  172. package/src/programmers/functional/FunctionalAssertFunctionProgrammer.ts +153 -153
  173. package/src/programmers/functional/FunctionalAssertParametersProgrammer.ts +125 -125
  174. package/src/programmers/functional/FunctionalAssertReturnProgrammer.ts +115 -115
  175. package/src/programmers/functional/FunctionalIsFunctionProgrammer.ts +72 -72
  176. package/src/programmers/functional/FunctionalIsParametersProgrammer.ts +113 -113
  177. package/src/programmers/functional/FunctionalIsReturnProgrammer.ts +116 -116
  178. package/src/programmers/functional/FunctionalValidateFunctionProgrammer.ts +119 -119
  179. package/src/programmers/functional/FunctionalValidateParametersProgrammer.ts +274 -274
  180. package/src/programmers/functional/FunctionalValidateReturnProgrammer.ts +135 -135
  181. package/src/programmers/functional/internal/FunctionalGeneralProgrammer.ts +34 -34
  182. package/src/programmers/helpers/AtomicPredicator.ts +35 -35
  183. package/src/programmers/helpers/CloneJoiner.ts +143 -143
  184. package/src/programmers/helpers/FunctionProgrammer.ts +67 -67
  185. package/src/programmers/helpers/HttpMetadataUtil.ts +21 -21
  186. package/src/programmers/helpers/NotationJoiner.ts +144 -144
  187. package/src/programmers/helpers/OptionPredicator.ts +15 -15
  188. package/src/programmers/helpers/ProtobufUtil.ts +228 -228
  189. package/src/programmers/helpers/PruneJoiner.ts +148 -148
  190. package/src/programmers/helpers/RandomJoiner.ts +168 -168
  191. package/src/programmers/helpers/StringifyJoinder.ts +115 -115
  192. package/src/programmers/helpers/StringifyPredicator.ts +13 -13
  193. package/src/programmers/helpers/UnionExplorer.ts +372 -372
  194. package/src/programmers/helpers/UnionPredicator.ts +79 -79
  195. package/src/programmers/helpers/disable_function_programmer_declare.ts +32 -32
  196. package/src/programmers/http/HttpAssertFormDataProgrammer.ts +99 -99
  197. package/src/programmers/http/HttpAssertHeadersProgrammer.ts +99 -99
  198. package/src/programmers/http/HttpAssertQueryProgrammer.ts +105 -105
  199. package/src/programmers/http/HttpFormDataProgrammer.ts +308 -308
  200. package/src/programmers/http/HttpHeadersProgrammer.ts +400 -400
  201. package/src/programmers/http/HttpIsFormDataProgrammer.ts +108 -108
  202. package/src/programmers/http/HttpIsHeadersProgrammer.ts +108 -108
  203. package/src/programmers/http/HttpIsQueryProgrammer.ts +114 -114
  204. package/src/programmers/http/HttpParameterProgrammer.ts +115 -115
  205. package/src/programmers/http/HttpQueryProgrammer.ts +336 -336
  206. package/src/programmers/http/HttpValidateFormDataProgrammer.ts +92 -92
  207. package/src/programmers/http/HttpValidateHeadersProgrammer.ts +92 -92
  208. package/src/programmers/http/HttpValidateQueryProgrammer.ts +98 -98
  209. package/src/programmers/internal/check_array_length.ts +47 -47
  210. package/src/programmers/internal/check_bigint.ts +50 -50
  211. package/src/programmers/internal/check_dynamic_key.ts +201 -201
  212. package/src/programmers/internal/check_dynamic_properties.ts +208 -208
  213. package/src/programmers/internal/check_everything.ts +23 -23
  214. package/src/programmers/internal/check_native.ts +27 -27
  215. package/src/programmers/internal/check_number.ts +112 -112
  216. package/src/programmers/internal/check_object.ts +75 -75
  217. package/src/programmers/internal/check_string.ts +50 -50
  218. package/src/programmers/internal/check_template.ts +48 -48
  219. package/src/programmers/internal/check_union_array_like.ts +335 -335
  220. package/src/programmers/internal/decode_union_object.ts +116 -116
  221. package/src/programmers/internal/feature_object_entries.ts +61 -61
  222. package/src/programmers/internal/json_schema_alias.ts +47 -47
  223. package/src/programmers/internal/json_schema_array.ts +45 -45
  224. package/src/programmers/internal/json_schema_bigint.ts +15 -15
  225. package/src/programmers/internal/json_schema_boolean.ts +15 -15
  226. package/src/programmers/internal/json_schema_constant.ts +26 -26
  227. package/src/programmers/internal/json_schema_description.ts +12 -12
  228. package/src/programmers/internal/json_schema_discriminator.ts +35 -35
  229. package/src/programmers/internal/json_schema_escaped.ts +82 -82
  230. package/src/programmers/internal/json_schema_native.ts +33 -33
  231. package/src/programmers/internal/json_schema_number.ts +15 -15
  232. package/src/programmers/internal/json_schema_object.ts +158 -158
  233. package/src/programmers/internal/json_schema_plugin.ts +18 -18
  234. package/src/programmers/internal/json_schema_station.ts +182 -182
  235. package/src/programmers/internal/json_schema_string.ts +15 -15
  236. package/src/programmers/internal/json_schema_template.ts +55 -55
  237. package/src/programmers/internal/json_schema_title.ts +20 -20
  238. package/src/programmers/internal/json_schema_tuple.ts +35 -35
  239. package/src/programmers/internal/metadata_to_pattern.ts +42 -42
  240. package/src/programmers/internal/postfix_of_tuple.ts +5 -5
  241. package/src/programmers/internal/prune_object_properties.ts +71 -71
  242. package/src/programmers/internal/stringify_dynamic_properties.ts +162 -162
  243. package/src/programmers/internal/stringify_regular_properties.ts +81 -81
  244. package/src/programmers/internal/template_to_pattern.ts +23 -23
  245. package/src/programmers/internal/wrap_metadata_rest_tuple.ts +23 -23
  246. package/src/programmers/json/JsonApplicationProgrammer.ts +279 -279
  247. package/src/programmers/json/JsonAssertParseProgrammer.ts +113 -113
  248. package/src/programmers/json/JsonAssertStringifyProgrammer.ts +115 -115
  249. package/src/programmers/json/JsonIsParseProgrammer.ts +114 -114
  250. package/src/programmers/json/JsonIsStringifyProgrammer.ts +108 -108
  251. package/src/programmers/json/JsonSchemasProgrammer.ts +91 -91
  252. package/src/programmers/json/JsonStringifyProgrammer.ts +1124 -1124
  253. package/src/programmers/json/JsonValidateParseProgrammer.ts +105 -105
  254. package/src/programmers/json/JsonValidateStringifyProgrammer.ts +124 -124
  255. package/src/programmers/llm/LlmApplicationOfValidateProgrammer.ts +81 -81
  256. package/src/programmers/llm/LlmApplicationProgrammer.ts +277 -278
  257. package/src/programmers/llm/LlmModelPredicator.ts +127 -127
  258. package/src/programmers/llm/LlmParametersProgrammer.ts +90 -90
  259. package/src/programmers/llm/LlmSchemaProgrammer.ts +143 -143
  260. package/src/programmers/misc/MiscAssertCloneProgrammer.ts +95 -95
  261. package/src/programmers/misc/MiscAssertPruneProgrammer.ts +116 -116
  262. package/src/programmers/misc/MiscCloneProgrammer.ts +1032 -1032
  263. package/src/programmers/misc/MiscIsCloneProgrammer.ts +99 -99
  264. package/src/programmers/misc/MiscIsPruneProgrammer.ts +97 -97
  265. package/src/programmers/misc/MiscLiteralsProgrammer.ts +80 -80
  266. package/src/programmers/misc/MiscPruneProgrammer.ts +728 -728
  267. package/src/programmers/misc/MiscValidateCloneProgrammer.ts +111 -111
  268. package/src/programmers/misc/MiscValidatePruneProgrammer.ts +113 -113
  269. package/src/programmers/notations/NotationAssertGeneralProgrammer.ts +101 -101
  270. package/src/programmers/notations/NotationGeneralProgrammer.ts +984 -984
  271. package/src/programmers/notations/NotationIsGeneralProgrammer.ts +105 -105
  272. package/src/programmers/notations/NotationValidateGeneralProgrammer.ts +119 -119
  273. package/src/programmers/protobuf/ProtobufAssertDecodeProgrammer.ts +98 -98
  274. package/src/programmers/protobuf/ProtobufAssertEncodeProgrammer.ts +102 -102
  275. package/src/programmers/protobuf/ProtobufDecodeProgrammer.ts +654 -654
  276. package/src/programmers/protobuf/ProtobufEncodeProgrammer.ts +945 -945
  277. package/src/programmers/protobuf/ProtobufIsDecodeProgrammer.ts +109 -109
  278. package/src/programmers/protobuf/ProtobufIsEncodeProgrammer.ts +98 -98
  279. package/src/programmers/protobuf/ProtobufMessageProgrammer.ts +179 -179
  280. package/src/programmers/protobuf/ProtobufValidateDecodeProgrammer.ts +92 -92
  281. package/src/programmers/protobuf/ProtobufValidateEncodeProgrammer.ts +119 -119
  282. package/src/protobuf.ts +868 -868
  283. package/src/reflect.ts +57 -57
  284. package/src/schemas/json/IJsonApplication.ts +73 -73
  285. package/src/schemas/json/IJsonSchemaCollection.ts +29 -29
  286. package/src/schemas/json/__IJsonApplication.ts +63 -63
  287. package/src/schemas/llm/ILlmApplicationOfValidate.ts +55 -55
  288. package/src/schemas/llm/ILlmFunctionOfValidate.ts +39 -39
  289. package/src/schemas/metadata/IMetadata.ts +35 -35
  290. package/src/schemas/metadata/IMetadataAlias.ts +6 -6
  291. package/src/schemas/metadata/IMetadataAliasType.ts +12 -12
  292. package/src/schemas/metadata/IMetadataApplication.ts +7 -7
  293. package/src/schemas/metadata/IMetadataArray.ts +6 -6
  294. package/src/schemas/metadata/IMetadataComponents.ts +11 -11
  295. package/src/schemas/metadata/IMetadataConstantValue.ts +11 -11
  296. package/src/schemas/metadata/IMetadataDictionary.ts +11 -11
  297. package/src/schemas/metadata/IMetadataMap.ts +8 -8
  298. package/src/schemas/metadata/IMetadataNative.ts +6 -6
  299. package/src/schemas/metadata/IMetadataObject.ts +6 -6
  300. package/src/schemas/metadata/IMetadataObjectType.ts +13 -13
  301. package/src/schemas/metadata/IMetadataSet.ts +7 -7
  302. package/src/schemas/metadata/IMetadataTemplate.ts +7 -7
  303. package/src/schemas/metadata/IMetadataTuple.ts +6 -6
  304. package/src/schemas/metadata/IMetadataTypeTag.ts +16 -16
  305. package/src/schemas/metadata/Metadata.ts +669 -669
  306. package/src/schemas/metadata/MetadataAlias.ts +46 -46
  307. package/src/schemas/metadata/MetadataAliasType.ts +63 -63
  308. package/src/schemas/metadata/MetadataApplication.ts +44 -44
  309. package/src/schemas/metadata/MetadataArray.ts +49 -49
  310. package/src/schemas/metadata/MetadataAtomic.ts +87 -87
  311. package/src/schemas/metadata/MetadataComponents.ts +98 -98
  312. package/src/schemas/metadata/MetadataConstantValue.ts +62 -62
  313. package/src/schemas/metadata/MetadataMap.ts +48 -48
  314. package/src/schemas/metadata/MetadataNative.ts +44 -44
  315. package/src/schemas/metadata/MetadataObject.ts +48 -48
  316. package/src/schemas/metadata/MetadataObjectType.ts +149 -149
  317. package/src/schemas/metadata/MetadataParameter.ts +54 -54
  318. package/src/schemas/metadata/MetadataProperty.ts +59 -59
  319. package/src/schemas/metadata/MetadataSet.ts +45 -45
  320. package/src/schemas/metadata/MetadataTemplate.ts +80 -80
  321. package/src/schemas/metadata/MetadataTuple.ts +32 -32
  322. package/src/schemas/protobuf/IProtobufProperty.ts +6 -6
  323. package/src/schemas/protobuf/IProtobufPropertyType.ts +37 -37
  324. package/src/schemas/protobuf/IProtobufSchema.ts +50 -50
  325. package/src/tags/Example.ts +24 -24
  326. package/src/tags/Examples.ts +16 -16
  327. package/src/tags/Format.ts +50 -50
  328. package/src/tags/JsonSchemaPlugin.ts +8 -8
  329. package/src/tags/Sequence.ts +10 -10
  330. package/src/tags/TagBase.ts +82 -82
  331. package/src/tags/Type.ts +32 -32
  332. package/src/tags/UniqueItems.ts +14 -14
  333. package/src/tags/index.ts +21 -21
  334. package/src/transform.ts +35 -35
  335. package/src/transformers/CallExpressionTransformer.ts +547 -547
  336. package/src/transformers/FileTransformer.ts +136 -136
  337. package/src/transformers/IProgrammerProps.ts +11 -11
  338. package/src/transformers/ITransformOptions.ts +62 -62
  339. package/src/transformers/ITransformProps.ts +9 -9
  340. package/src/transformers/ITypiaContext.ts +18 -18
  341. package/src/transformers/ImportTransformer.ts +81 -81
  342. package/src/transformers/NodeTransformer.ts +17 -17
  343. package/src/transformers/TransformerError.ts +60 -60
  344. package/src/transformers/features/AssertTransformer.ts +24 -24
  345. package/src/transformers/features/CreateAssertTransformer.ts +24 -24
  346. package/src/transformers/features/CreateIsTransformer.ts +18 -18
  347. package/src/transformers/features/CreateRandomTransformer.ts +43 -43
  348. package/src/transformers/features/CreateValidateTransformer.ts +18 -18
  349. package/src/transformers/features/IsTransformer.ts +18 -18
  350. package/src/transformers/features/RandomTransformer.ts +41 -41
  351. package/src/transformers/features/ValidateTransformer.ts +18 -18
  352. package/src/transformers/features/functional/FunctionalGenericTransformer.ts +57 -57
  353. package/src/transformers/features/http/CreateHttpAssertFormDataTransformer.ts +13 -13
  354. package/src/transformers/features/http/CreateHttpAssertHeadersTransformer.ts +13 -13
  355. package/src/transformers/features/http/CreateHttpAssertQueryTransformer.ts +13 -13
  356. package/src/transformers/features/http/CreateHttpFormDataTransformer.ts +13 -13
  357. package/src/transformers/features/http/CreateHttpHeadersTransformer.ts +13 -13
  358. package/src/transformers/features/http/CreateHttpIsFormDataTransformer.ts +13 -13
  359. package/src/transformers/features/http/CreateHttpIsHeadersTransformer.ts +13 -13
  360. package/src/transformers/features/http/CreateHttpIsQueryTransformer.ts +13 -13
  361. package/src/transformers/features/http/CreateHttpParameterTransformer.ts +13 -13
  362. package/src/transformers/features/http/CreateHttpQueryTransformer.ts +13 -13
  363. package/src/transformers/features/http/CreateHttpValidateFormDataTransformer.ts +13 -13
  364. package/src/transformers/features/http/CreateHttpValidateHeadersTransformer.ts +13 -13
  365. package/src/transformers/features/http/CreateHttpValidateQueryTransformer.ts +13 -13
  366. package/src/transformers/features/http/HttpAssertFormDataTransformer.ts +13 -13
  367. package/src/transformers/features/http/HttpAssertHeadersTransformer.ts +13 -13
  368. package/src/transformers/features/http/HttpAssertQueryTransformer.ts +13 -13
  369. package/src/transformers/features/http/HttpFormDataTransformer.ts +13 -13
  370. package/src/transformers/features/http/HttpHeadersTransformer.ts +13 -13
  371. package/src/transformers/features/http/HttpIsFormDataTransformer.ts +13 -13
  372. package/src/transformers/features/http/HttpIsHeadersTransformer.ts +13 -13
  373. package/src/transformers/features/http/HttpIsQueryTransformer.ts +13 -13
  374. package/src/transformers/features/http/HttpParameterTransformer.ts +13 -13
  375. package/src/transformers/features/http/HttpQueryTransformer.ts +13 -13
  376. package/src/transformers/features/http/HttpValidateFormDataTransformer.ts +13 -13
  377. package/src/transformers/features/http/HttpValidateHeadersTransformer.ts +13 -13
  378. package/src/transformers/features/http/HttpValidateQueryTransformer.ts +13 -13
  379. package/src/transformers/features/json/JsonApplicationTransformer.ts +105 -105
  380. package/src/transformers/features/json/JsonAssertParseTransformer.ts +13 -13
  381. package/src/transformers/features/json/JsonAssertStringifyTransformer.ts +13 -13
  382. package/src/transformers/features/json/JsonCreateAssertParseTransformer.ts +13 -13
  383. package/src/transformers/features/json/JsonCreateAssertStringifyTransformer.ts +13 -13
  384. package/src/transformers/features/json/JsonCreateIsParseTransformer.ts +13 -13
  385. package/src/transformers/features/json/JsonCreateIsStringifyTransformer.ts +13 -13
  386. package/src/transformers/features/json/JsonCreateStringifyTransformer.ts +13 -13
  387. package/src/transformers/features/json/JsonCreateValidateParseTransformer.ts +13 -13
  388. package/src/transformers/features/json/JsonCreateValidateStringifyProgrammer.ts +13 -13
  389. package/src/transformers/features/json/JsonIsParseTransformer.ts +13 -13
  390. package/src/transformers/features/json/JsonIsStringifyTransformer.ts +13 -13
  391. package/src/transformers/features/json/JsonSchemasTransformer.ts +143 -143
  392. package/src/transformers/features/json/JsonStringifyTransformer.ts +13 -13
  393. package/src/transformers/features/json/JsonValidateParseTransformer.ts +13 -13
  394. package/src/transformers/features/json/JsonValidateStringifyTransformer.ts +13 -13
  395. package/src/transformers/features/llm/LlmApplicationOfValidateTransformer.ts +115 -115
  396. package/src/transformers/features/llm/LlmApplicationTransformer.ts +113 -113
  397. package/src/transformers/features/llm/LlmParametersTransformer.ts +89 -89
  398. package/src/transformers/features/llm/LlmSchemaTransformer.ts +130 -130
  399. package/src/transformers/features/misc/MiscAssertCloneTransformer.ts +13 -13
  400. package/src/transformers/features/misc/MiscAssertPruneTransformer.ts +13 -13
  401. package/src/transformers/features/misc/MiscCloneTransformer.ts +13 -13
  402. package/src/transformers/features/misc/MiscCreateAssertCloneTransformer.ts +13 -13
  403. package/src/transformers/features/misc/MiscCreateAssertPruneTransformer.ts +13 -13
  404. package/src/transformers/features/misc/MiscCreateCloneTransformer.ts +13 -13
  405. package/src/transformers/features/misc/MiscCreateIsCloneTransformer.ts +13 -13
  406. package/src/transformers/features/misc/MiscCreateIsPruneTransformer.ts +13 -13
  407. package/src/transformers/features/misc/MiscCreatePruneTransformer.ts +13 -13
  408. package/src/transformers/features/misc/MiscCreateValidateCloneTransformer.ts +13 -13
  409. package/src/transformers/features/misc/MiscCreateValidatePruneTransformer.ts +13 -13
  410. package/src/transformers/features/misc/MiscIsCloneTransformer.ts +13 -13
  411. package/src/transformers/features/misc/MiscIsPruneTransformer.ts +13 -13
  412. package/src/transformers/features/misc/MiscLiteralsTransformer.ts +35 -35
  413. package/src/transformers/features/misc/MiscPruneTransformer.ts +13 -13
  414. package/src/transformers/features/misc/MiscValidateCloneTransformer.ts +13 -13
  415. package/src/transformers/features/misc/MiscValidatePruneTransformer.ts +13 -13
  416. package/src/transformers/features/notations/NotationAssertGeneralTransformer.ts +20 -20
  417. package/src/transformers/features/notations/NotationCreateAssertGeneralTransformer.ts +20 -20
  418. package/src/transformers/features/notations/NotationCreateGeneralTransformer.ts +20 -20
  419. package/src/transformers/features/notations/NotationCreateIsGeneralTransformer.ts +20 -20
  420. package/src/transformers/features/notations/NotationCreateValidateGeneralTransformer.ts +20 -20
  421. package/src/transformers/features/notations/NotationGeneralTransformer.ts +18 -18
  422. package/src/transformers/features/notations/NotationIsGeneralTransformer.ts +20 -20
  423. package/src/transformers/features/notations/NotationValidateGeneralTransformer.ts +20 -20
  424. package/src/transformers/features/protobuf/ProtobufAssertDecodeTransformer.ts +13 -13
  425. package/src/transformers/features/protobuf/ProtobufAssertEncodeTransformer.ts +13 -13
  426. package/src/transformers/features/protobuf/ProtobufCreateAssertDecodeTransformer.ts +13 -13
  427. package/src/transformers/features/protobuf/ProtobufCreateAssertEncodeTransformer.ts +13 -13
  428. package/src/transformers/features/protobuf/ProtobufCreateDecodeTransformer.ts +13 -13
  429. package/src/transformers/features/protobuf/ProtobufCreateEncodeTransformer.ts +13 -13
  430. package/src/transformers/features/protobuf/ProtobufCreateIsDecodeTransformer.ts +13 -13
  431. package/src/transformers/features/protobuf/ProtobufCreateIsEncodeTransformer.ts +13 -13
  432. package/src/transformers/features/protobuf/ProtobufCreateValidateDecodeTransformer.ts +13 -13
  433. package/src/transformers/features/protobuf/ProtobufCreateValidateEncodeTransformer.ts +13 -13
  434. package/src/transformers/features/protobuf/ProtobufDecodeTransformer.ts +13 -13
  435. package/src/transformers/features/protobuf/ProtobufEncodeTransformer.ts +13 -13
  436. package/src/transformers/features/protobuf/ProtobufIsDecodeTransformer.ts +13 -13
  437. package/src/transformers/features/protobuf/ProtobufIsEncodeTransformer.ts +13 -13
  438. package/src/transformers/features/protobuf/ProtobufMessageTransformer.ts +35 -35
  439. package/src/transformers/features/protobuf/ProtobufValidateDecodeTransformer.ts +13 -13
  440. package/src/transformers/features/protobuf/ProtobufValidateEncodeTransformer.ts +13 -13
  441. package/src/transformers/features/reflect/ReflectMetadataTransformer.ts +69 -69
  442. package/src/transformers/features/reflect/ReflectNameTransformer.ts +82 -82
  443. package/src/transformers/internal/GenericTransformer.ts +101 -101
  444. package/src/utils/MapUtil.ts +14 -14
  445. package/src/utils/NamingConvention.ts +94 -94
  446. package/src/utils/ProtobufNameEncoder.ts +32 -32
  447. package/src/utils/StringUtil.ts +16 -16
@@ -1,454 +1,454 @@
1
- import ts from "typescript";
2
-
3
- import { IdentifierFactory } from "../factories/IdentifierFactory";
4
- import { StatementFactory } from "../factories/StatementFactory";
5
- import { TypeFactory } from "../factories/TypeFactory";
6
-
7
- import { IProgrammerProps } from "../transformers/IProgrammerProps";
8
- import { ITypiaContext } from "../transformers/ITypiaContext";
9
-
10
- import { CheckerProgrammer } from "./CheckerProgrammer";
11
- import { FeatureProgrammer } from "./FeatureProgrammer";
12
- import { IsProgrammer } from "./IsProgrammer";
13
- import { FunctionProgrammer } from "./helpers/FunctionProgrammer";
14
- import { IExpressionEntry } from "./helpers/IExpressionEntry";
15
- import { OptionPredicator } from "./helpers/OptionPredicator";
16
- import { check_object } from "./internal/check_object";
17
-
18
- export namespace AssertProgrammer {
19
- export interface IConfig {
20
- equals: boolean;
21
- guard: boolean;
22
- }
23
- export interface IProps extends IProgrammerProps {
24
- config: IConfig;
25
- }
26
-
27
- export const decompose = (props: {
28
- config: IConfig;
29
- context: ITypiaContext;
30
- functor: FunctionProgrammer;
31
- type: ts.Type;
32
- name: string | undefined;
33
- init?: ts.Expression | undefined;
34
- }): FeatureProgrammer.IDecomposed => {
35
- const is: FeatureProgrammer.IDecomposed = IsProgrammer.decompose({
36
- ...props,
37
- config: {
38
- equals: props.config.equals,
39
- },
40
- });
41
- const composed: FeatureProgrammer.IComposed = CheckerProgrammer.compose({
42
- ...props,
43
- config: {
44
- prefix: "_a",
45
- path: true,
46
- trace: true,
47
- numeric: OptionPredicator.numeric(props.context.options),
48
- equals: props.config.equals,
49
- atomist: (next) =>
50
- [
51
- ...(next.entry.expression ? [next.entry.expression] : []),
52
- ...(next.entry.conditions.length === 0
53
- ? []
54
- : next.entry.conditions.length === 1
55
- ? next.entry.conditions[0]!.map((cond) =>
56
- ts.factory.createLogicalOr(
57
- cond.expression,
58
- create_guard_call({
59
- context: props.context,
60
- functor: props.functor,
61
- exceptionable:
62
- next.explore.from === "top"
63
- ? ts.factory.createTrue()
64
- : ts.factory.createIdentifier("_exceptionable"),
65
- path: ts.factory.createIdentifier(
66
- next.explore.postfix
67
- ? `_path + ${next.explore.postfix}`
68
- : "_path",
69
- ),
70
- expected: cond.expected,
71
- input: next.input,
72
- }),
73
- ),
74
- )
75
- : [
76
- ts.factory.createLogicalOr(
77
- next.entry.conditions
78
- .map((set) =>
79
- set
80
- .map((s) => s.expression)
81
- .reduce((a, b) =>
82
- ts.factory.createLogicalAnd(a, b),
83
- ),
84
- )
85
- .reduce((a, b) => ts.factory.createLogicalOr(a, b)),
86
- create_guard_call({
87
- context: props.context,
88
- functor: props.functor,
89
- exceptionable:
90
- next.explore.from === "top"
91
- ? ts.factory.createTrue()
92
- : ts.factory.createIdentifier("_exceptionable"),
93
- path: ts.factory.createIdentifier(
94
- next.explore.postfix
95
- ? `_path + ${next.explore.postfix}`
96
- : "_path",
97
- ),
98
- expected: next.entry.expected,
99
- input: next.input,
100
- }),
101
- ),
102
- ]),
103
- ].reduce((x, y) => ts.factory.createLogicalAnd(x, y)),
104
- combiner: combiner(props),
105
- joiner: joiner(props),
106
- success: ts.factory.createTrue(),
107
- },
108
- });
109
- const arrow: ts.ArrowFunction = ts.factory.createArrowFunction(
110
- undefined,
111
- undefined,
112
- [
113
- IdentifierFactory.parameter("input", TypeFactory.keyword("any")),
114
- Guardian.parameter({
115
- context: props.context,
116
- init: props.init,
117
- }),
118
- ],
119
- props.config.guard
120
- ? ts.factory.createTypePredicateNode(
121
- ts.factory.createToken(ts.SyntaxKind.AssertsKeyword),
122
- ts.factory.createIdentifier("input"),
123
- ts.factory.createTypeReferenceNode(
124
- props.name ??
125
- TypeFactory.getFullName({
126
- checker: props.context.checker,
127
- type: props.type,
128
- }),
129
- ),
130
- )
131
- : ts.factory.createTypeReferenceNode(
132
- props.name ??
133
- TypeFactory.getFullName({
134
- checker: props.context.checker,
135
- type: props.type,
136
- }),
137
- ),
138
- undefined,
139
- ts.factory.createBlock(
140
- [
141
- ts.factory.createIfStatement(
142
- ts.factory.createStrictEquality(
143
- ts.factory.createFalse(),
144
- ts.factory.createCallExpression(
145
- ts.factory.createIdentifier("__is"),
146
- undefined,
147
- [ts.factory.createIdentifier("input")],
148
- ),
149
- ),
150
- ts.factory.createBlock(
151
- [
152
- ts.factory.createExpressionStatement(
153
- ts.factory.createBinaryExpression(
154
- ts.factory.createIdentifier("_errorFactory"),
155
- ts.factory.createToken(ts.SyntaxKind.EqualsToken),
156
- ts.factory.createIdentifier("errorFactory"),
157
- ),
158
- ),
159
- ts.factory.createExpressionStatement(
160
- ts.factory.createCallExpression(
161
- ts.factory.createArrowFunction(
162
- undefined,
163
- undefined,
164
- composed.parameters,
165
- undefined,
166
- undefined,
167
- composed.body,
168
- ),
169
- undefined,
170
- [
171
- ts.factory.createIdentifier("input"),
172
- ts.factory.createStringLiteral("$input"),
173
- ts.factory.createTrue(),
174
- ],
175
- ),
176
- ),
177
- ],
178
- true,
179
- ),
180
- undefined,
181
- ),
182
- ...(props.config.guard === false
183
- ? [
184
- ts.factory.createReturnStatement(
185
- ts.factory.createIdentifier(`input`),
186
- ),
187
- ]
188
- : []),
189
- ],
190
- true,
191
- ),
192
- );
193
- return {
194
- functions: {
195
- ...is.functions,
196
- ...composed.functions,
197
- },
198
- statements: [
199
- ...is.statements,
200
- ...composed.statements,
201
- StatementFactory.constant({
202
- name: "__is",
203
- value: is.arrow,
204
- }),
205
- StatementFactory.mut({
206
- name: "_errorFactory",
207
- }),
208
- ],
209
- arrow,
210
- };
211
- };
212
-
213
- export const write = (props: IProps): ts.CallExpression => {
214
- const functor: FunctionProgrammer = new FunctionProgrammer(
215
- props.modulo.getText(),
216
- );
217
- const result: FeatureProgrammer.IDecomposed = decompose({
218
- ...props,
219
- functor,
220
- });
221
- return FeatureProgrammer.writeDecomposed({
222
- modulo: props.modulo,
223
- functor,
224
- result,
225
- });
226
- };
227
-
228
- const combiner =
229
- (props: {
230
- config: IConfig;
231
- context: ITypiaContext;
232
- functor: FunctionProgrammer;
233
- }): CheckerProgrammer.IConfig.Combiner =>
234
- (next) => {
235
- if (next.explore.tracable === false)
236
- return IsProgrammer.configure({
237
- options: {
238
- object: (v) =>
239
- assert_object({
240
- config: props.config,
241
- context: props.context,
242
- functor: props.functor,
243
- entries: v.entries,
244
- input: v.input,
245
- }),
246
- numeric: true,
247
- },
248
- context: props.context,
249
- functor: props.functor,
250
- }).combiner(next);
251
-
252
- const path: string = next.explore.postfix
253
- ? `_path + ${next.explore.postfix}`
254
- : "_path";
255
- return next.logic === "and"
256
- ? next.binaries
257
- .map((binary) =>
258
- binary.combined
259
- ? binary.expression
260
- : ts.factory.createLogicalOr(
261
- binary.expression,
262
- create_guard_call({
263
- context: props.context,
264
- functor: props.functor,
265
- exceptionable:
266
- next.explore.source === "top"
267
- ? ts.factory.createTrue()
268
- : ts.factory.createIdentifier("_exceptionable"),
269
- path: ts.factory.createIdentifier(path),
270
- expected: next.expected,
271
- input: next.input,
272
- }),
273
- ),
274
- )
275
- .reduce(ts.factory.createLogicalAnd)
276
- : ts.factory.createLogicalOr(
277
- next.binaries
278
- .map((binary) => binary.expression)
279
- .reduce(ts.factory.createLogicalOr),
280
- create_guard_call({
281
- context: props.context,
282
- functor: props.functor,
283
- exceptionable:
284
- next.explore.source === "top"
285
- ? ts.factory.createTrue()
286
- : ts.factory.createIdentifier("_exceptionable"),
287
- path: ts.factory.createIdentifier(path),
288
- expected: next.expected,
289
- input: next.input,
290
- }),
291
- );
292
- };
293
-
294
- const assert_object = (props: {
295
- config: IConfig;
296
- context: ITypiaContext;
297
- functor: FunctionProgrammer;
298
- entries: IExpressionEntry<ts.Expression>[];
299
- input: ts.Expression;
300
- }) =>
301
- check_object({
302
- config: {
303
- equals: props.config.equals,
304
- assert: true,
305
- undefined: true,
306
- reduce: ts.factory.createLogicalAnd,
307
- positive: ts.factory.createTrue(),
308
- superfluous: (input) =>
309
- create_guard_call({
310
- context: props.context,
311
- functor: props.functor,
312
- path: ts.factory.createAdd(
313
- ts.factory.createIdentifier("_path"),
314
- ts.factory.createCallExpression(
315
- props.context.importer.internal("accessExpressionAsString"),
316
- undefined,
317
- [ts.factory.createIdentifier("key")],
318
- ),
319
- ),
320
- expected: "undefined",
321
- input,
322
- }),
323
- halt: (expr) =>
324
- ts.factory.createLogicalOr(
325
- ts.factory.createStrictEquality(
326
- ts.factory.createFalse(),
327
- ts.factory.createIdentifier("_exceptionable"),
328
- ),
329
- expr,
330
- ),
331
- },
332
- context: props.context,
333
- entries: props.entries,
334
- input: props.input,
335
- });
336
-
337
- const joiner = (props: {
338
- config: IConfig;
339
- context: ITypiaContext;
340
- functor: FunctionProgrammer;
341
- }): CheckerProgrammer.IConfig.IJoiner => ({
342
- object: (next) =>
343
- assert_object({
344
- config: props.config,
345
- context: props.context,
346
- functor: props.functor,
347
- entries: next.entries,
348
- input: next.input,
349
- }),
350
- array: (props) =>
351
- ts.factory.createCallExpression(
352
- IdentifierFactory.access(props.input, "every"),
353
- undefined,
354
- [props.arrow],
355
- ),
356
- failure: (next) =>
357
- create_guard_call({
358
- context: props.context,
359
- functor: props.functor,
360
- exceptionable:
361
- next.explore?.from === "top"
362
- ? ts.factory.createTrue()
363
- : ts.factory.createIdentifier("_exceptionable"),
364
- path: ts.factory.createIdentifier(
365
- next.explore?.postfix ? `_path + ${next.explore.postfix}` : "_path",
366
- ),
367
- expected: next.expected,
368
- input: next.input,
369
- }),
370
- full: props.config.equals
371
- ? undefined
372
- : (next) =>
373
- ts.factory.createLogicalOr(
374
- next.condition,
375
- create_guard_call({
376
- context: props.context,
377
- functor: props.functor,
378
- exceptionable:
379
- next.explore.from === "top"
380
- ? ts.factory.createTrue()
381
- : ts.factory.createIdentifier("_exceptionable"),
382
- path: ts.factory.createIdentifier("_path"),
383
- expected: next.expected,
384
- input: next.input,
385
- }),
386
- ),
387
- });
388
-
389
- const create_guard_call = (props: {
390
- context: ITypiaContext;
391
- functor: FunctionProgrammer;
392
- expected: string;
393
- input: ts.Expression;
394
- path: ts.Expression;
395
- exceptionable?: ts.Expression;
396
- }): ts.Expression =>
397
- ts.factory.createCallExpression(
398
- props.context.importer.internal("assertGuard"),
399
- undefined,
400
- [
401
- props.exceptionable ?? ts.factory.createIdentifier("_exceptionable"),
402
- ts.factory.createObjectLiteralExpression(
403
- [
404
- ts.factory.createPropertyAssignment(
405
- "method",
406
- ts.factory.createStringLiteral(props.functor.method),
407
- ),
408
- ts.factory.createPropertyAssignment("path", props.path),
409
- ts.factory.createPropertyAssignment(
410
- "expected",
411
- ts.factory.createStringLiteral(props.expected),
412
- ),
413
- ts.factory.createPropertyAssignment("value", props.input),
414
- ],
415
- true,
416
- ),
417
- ts.factory.createIdentifier("_errorFactory"),
418
- ],
419
- );
420
-
421
- export namespace Guardian {
422
- export const identifier = () => ts.factory.createIdentifier("errorFactory");
423
- export const parameter = (props: {
424
- context: ITypiaContext;
425
- init: ts.Expression | undefined;
426
- }) =>
427
- IdentifierFactory.parameter(
428
- "errorFactory",
429
- type(props.context),
430
- props.init ?? ts.factory.createToken(ts.SyntaxKind.QuestionToken),
431
- );
432
- export const type = (context: ITypiaContext) =>
433
- ts.factory.createFunctionTypeNode(
434
- undefined,
435
- [
436
- ts.factory.createParameterDeclaration(
437
- undefined,
438
- undefined,
439
- ts.factory.createIdentifier("p"),
440
- undefined,
441
- context.importer.type({
442
- file: "typia",
443
- name: "TypeGuardError.IProps",
444
- }),
445
- undefined,
446
- ),
447
- ],
448
- ts.factory.createTypeReferenceNode(
449
- ts.factory.createIdentifier("Error"),
450
- undefined,
451
- ),
452
- );
453
- }
454
- }
1
+ import ts from "typescript";
2
+
3
+ import { IdentifierFactory } from "../factories/IdentifierFactory";
4
+ import { StatementFactory } from "../factories/StatementFactory";
5
+ import { TypeFactory } from "../factories/TypeFactory";
6
+
7
+ import { IProgrammerProps } from "../transformers/IProgrammerProps";
8
+ import { ITypiaContext } from "../transformers/ITypiaContext";
9
+
10
+ import { CheckerProgrammer } from "./CheckerProgrammer";
11
+ import { FeatureProgrammer } from "./FeatureProgrammer";
12
+ import { IsProgrammer } from "./IsProgrammer";
13
+ import { FunctionProgrammer } from "./helpers/FunctionProgrammer";
14
+ import { IExpressionEntry } from "./helpers/IExpressionEntry";
15
+ import { OptionPredicator } from "./helpers/OptionPredicator";
16
+ import { check_object } from "./internal/check_object";
17
+
18
+ export namespace AssertProgrammer {
19
+ export interface IConfig {
20
+ equals: boolean;
21
+ guard: boolean;
22
+ }
23
+ export interface IProps extends IProgrammerProps {
24
+ config: IConfig;
25
+ }
26
+
27
+ export const decompose = (props: {
28
+ config: IConfig;
29
+ context: ITypiaContext;
30
+ functor: FunctionProgrammer;
31
+ type: ts.Type;
32
+ name: string | undefined;
33
+ init?: ts.Expression | undefined;
34
+ }): FeatureProgrammer.IDecomposed => {
35
+ const is: FeatureProgrammer.IDecomposed = IsProgrammer.decompose({
36
+ ...props,
37
+ config: {
38
+ equals: props.config.equals,
39
+ },
40
+ });
41
+ const composed: FeatureProgrammer.IComposed = CheckerProgrammer.compose({
42
+ ...props,
43
+ config: {
44
+ prefix: "_a",
45
+ path: true,
46
+ trace: true,
47
+ numeric: OptionPredicator.numeric(props.context.options),
48
+ equals: props.config.equals,
49
+ atomist: (next) =>
50
+ [
51
+ ...(next.entry.expression ? [next.entry.expression] : []),
52
+ ...(next.entry.conditions.length === 0
53
+ ? []
54
+ : next.entry.conditions.length === 1
55
+ ? next.entry.conditions[0]!.map((cond) =>
56
+ ts.factory.createLogicalOr(
57
+ cond.expression,
58
+ create_guard_call({
59
+ context: props.context,
60
+ functor: props.functor,
61
+ exceptionable:
62
+ next.explore.from === "top"
63
+ ? ts.factory.createTrue()
64
+ : ts.factory.createIdentifier("_exceptionable"),
65
+ path: ts.factory.createIdentifier(
66
+ next.explore.postfix
67
+ ? `_path + ${next.explore.postfix}`
68
+ : "_path",
69
+ ),
70
+ expected: cond.expected,
71
+ input: next.input,
72
+ }),
73
+ ),
74
+ )
75
+ : [
76
+ ts.factory.createLogicalOr(
77
+ next.entry.conditions
78
+ .map((set) =>
79
+ set
80
+ .map((s) => s.expression)
81
+ .reduce((a, b) =>
82
+ ts.factory.createLogicalAnd(a, b),
83
+ ),
84
+ )
85
+ .reduce((a, b) => ts.factory.createLogicalOr(a, b)),
86
+ create_guard_call({
87
+ context: props.context,
88
+ functor: props.functor,
89
+ exceptionable:
90
+ next.explore.from === "top"
91
+ ? ts.factory.createTrue()
92
+ : ts.factory.createIdentifier("_exceptionable"),
93
+ path: ts.factory.createIdentifier(
94
+ next.explore.postfix
95
+ ? `_path + ${next.explore.postfix}`
96
+ : "_path",
97
+ ),
98
+ expected: next.entry.expected,
99
+ input: next.input,
100
+ }),
101
+ ),
102
+ ]),
103
+ ].reduce((x, y) => ts.factory.createLogicalAnd(x, y)),
104
+ combiner: combiner(props),
105
+ joiner: joiner(props),
106
+ success: ts.factory.createTrue(),
107
+ },
108
+ });
109
+ const arrow: ts.ArrowFunction = ts.factory.createArrowFunction(
110
+ undefined,
111
+ undefined,
112
+ [
113
+ IdentifierFactory.parameter("input", TypeFactory.keyword("any")),
114
+ Guardian.parameter({
115
+ context: props.context,
116
+ init: props.init,
117
+ }),
118
+ ],
119
+ props.config.guard
120
+ ? ts.factory.createTypePredicateNode(
121
+ ts.factory.createToken(ts.SyntaxKind.AssertsKeyword),
122
+ ts.factory.createIdentifier("input"),
123
+ ts.factory.createTypeReferenceNode(
124
+ props.name ??
125
+ TypeFactory.getFullName({
126
+ checker: props.context.checker,
127
+ type: props.type,
128
+ }),
129
+ ),
130
+ )
131
+ : ts.factory.createTypeReferenceNode(
132
+ props.name ??
133
+ TypeFactory.getFullName({
134
+ checker: props.context.checker,
135
+ type: props.type,
136
+ }),
137
+ ),
138
+ undefined,
139
+ ts.factory.createBlock(
140
+ [
141
+ ts.factory.createIfStatement(
142
+ ts.factory.createStrictEquality(
143
+ ts.factory.createFalse(),
144
+ ts.factory.createCallExpression(
145
+ ts.factory.createIdentifier("__is"),
146
+ undefined,
147
+ [ts.factory.createIdentifier("input")],
148
+ ),
149
+ ),
150
+ ts.factory.createBlock(
151
+ [
152
+ ts.factory.createExpressionStatement(
153
+ ts.factory.createBinaryExpression(
154
+ ts.factory.createIdentifier("_errorFactory"),
155
+ ts.factory.createToken(ts.SyntaxKind.EqualsToken),
156
+ ts.factory.createIdentifier("errorFactory"),
157
+ ),
158
+ ),
159
+ ts.factory.createExpressionStatement(
160
+ ts.factory.createCallExpression(
161
+ ts.factory.createArrowFunction(
162
+ undefined,
163
+ undefined,
164
+ composed.parameters,
165
+ undefined,
166
+ undefined,
167
+ composed.body,
168
+ ),
169
+ undefined,
170
+ [
171
+ ts.factory.createIdentifier("input"),
172
+ ts.factory.createStringLiteral("$input"),
173
+ ts.factory.createTrue(),
174
+ ],
175
+ ),
176
+ ),
177
+ ],
178
+ true,
179
+ ),
180
+ undefined,
181
+ ),
182
+ ...(props.config.guard === false
183
+ ? [
184
+ ts.factory.createReturnStatement(
185
+ ts.factory.createIdentifier(`input`),
186
+ ),
187
+ ]
188
+ : []),
189
+ ],
190
+ true,
191
+ ),
192
+ );
193
+ return {
194
+ functions: {
195
+ ...is.functions,
196
+ ...composed.functions,
197
+ },
198
+ statements: [
199
+ ...is.statements,
200
+ ...composed.statements,
201
+ StatementFactory.constant({
202
+ name: "__is",
203
+ value: is.arrow,
204
+ }),
205
+ StatementFactory.mut({
206
+ name: "_errorFactory",
207
+ }),
208
+ ],
209
+ arrow,
210
+ };
211
+ };
212
+
213
+ export const write = (props: IProps): ts.CallExpression => {
214
+ const functor: FunctionProgrammer = new FunctionProgrammer(
215
+ props.modulo.getText(),
216
+ );
217
+ const result: FeatureProgrammer.IDecomposed = decompose({
218
+ ...props,
219
+ functor,
220
+ });
221
+ return FeatureProgrammer.writeDecomposed({
222
+ modulo: props.modulo,
223
+ functor,
224
+ result,
225
+ });
226
+ };
227
+
228
+ const combiner =
229
+ (props: {
230
+ config: IConfig;
231
+ context: ITypiaContext;
232
+ functor: FunctionProgrammer;
233
+ }): CheckerProgrammer.IConfig.Combiner =>
234
+ (next) => {
235
+ if (next.explore.tracable === false)
236
+ return IsProgrammer.configure({
237
+ options: {
238
+ object: (v) =>
239
+ assert_object({
240
+ config: props.config,
241
+ context: props.context,
242
+ functor: props.functor,
243
+ entries: v.entries,
244
+ input: v.input,
245
+ }),
246
+ numeric: true,
247
+ },
248
+ context: props.context,
249
+ functor: props.functor,
250
+ }).combiner(next);
251
+
252
+ const path: string = next.explore.postfix
253
+ ? `_path + ${next.explore.postfix}`
254
+ : "_path";
255
+ return next.logic === "and"
256
+ ? next.binaries
257
+ .map((binary) =>
258
+ binary.combined
259
+ ? binary.expression
260
+ : ts.factory.createLogicalOr(
261
+ binary.expression,
262
+ create_guard_call({
263
+ context: props.context,
264
+ functor: props.functor,
265
+ exceptionable:
266
+ next.explore.source === "top"
267
+ ? ts.factory.createTrue()
268
+ : ts.factory.createIdentifier("_exceptionable"),
269
+ path: ts.factory.createIdentifier(path),
270
+ expected: next.expected,
271
+ input: next.input,
272
+ }),
273
+ ),
274
+ )
275
+ .reduce(ts.factory.createLogicalAnd)
276
+ : ts.factory.createLogicalOr(
277
+ next.binaries
278
+ .map((binary) => binary.expression)
279
+ .reduce(ts.factory.createLogicalOr),
280
+ create_guard_call({
281
+ context: props.context,
282
+ functor: props.functor,
283
+ exceptionable:
284
+ next.explore.source === "top"
285
+ ? ts.factory.createTrue()
286
+ : ts.factory.createIdentifier("_exceptionable"),
287
+ path: ts.factory.createIdentifier(path),
288
+ expected: next.expected,
289
+ input: next.input,
290
+ }),
291
+ );
292
+ };
293
+
294
+ const assert_object = (props: {
295
+ config: IConfig;
296
+ context: ITypiaContext;
297
+ functor: FunctionProgrammer;
298
+ entries: IExpressionEntry<ts.Expression>[];
299
+ input: ts.Expression;
300
+ }) =>
301
+ check_object({
302
+ config: {
303
+ equals: props.config.equals,
304
+ assert: true,
305
+ undefined: true,
306
+ reduce: ts.factory.createLogicalAnd,
307
+ positive: ts.factory.createTrue(),
308
+ superfluous: (input) =>
309
+ create_guard_call({
310
+ context: props.context,
311
+ functor: props.functor,
312
+ path: ts.factory.createAdd(
313
+ ts.factory.createIdentifier("_path"),
314
+ ts.factory.createCallExpression(
315
+ props.context.importer.internal("accessExpressionAsString"),
316
+ undefined,
317
+ [ts.factory.createIdentifier("key")],
318
+ ),
319
+ ),
320
+ expected: "undefined",
321
+ input,
322
+ }),
323
+ halt: (expr) =>
324
+ ts.factory.createLogicalOr(
325
+ ts.factory.createStrictEquality(
326
+ ts.factory.createFalse(),
327
+ ts.factory.createIdentifier("_exceptionable"),
328
+ ),
329
+ expr,
330
+ ),
331
+ },
332
+ context: props.context,
333
+ entries: props.entries,
334
+ input: props.input,
335
+ });
336
+
337
+ const joiner = (props: {
338
+ config: IConfig;
339
+ context: ITypiaContext;
340
+ functor: FunctionProgrammer;
341
+ }): CheckerProgrammer.IConfig.IJoiner => ({
342
+ object: (next) =>
343
+ assert_object({
344
+ config: props.config,
345
+ context: props.context,
346
+ functor: props.functor,
347
+ entries: next.entries,
348
+ input: next.input,
349
+ }),
350
+ array: (props) =>
351
+ ts.factory.createCallExpression(
352
+ IdentifierFactory.access(props.input, "every"),
353
+ undefined,
354
+ [props.arrow],
355
+ ),
356
+ failure: (next) =>
357
+ create_guard_call({
358
+ context: props.context,
359
+ functor: props.functor,
360
+ exceptionable:
361
+ next.explore?.from === "top"
362
+ ? ts.factory.createTrue()
363
+ : ts.factory.createIdentifier("_exceptionable"),
364
+ path: ts.factory.createIdentifier(
365
+ next.explore?.postfix ? `_path + ${next.explore.postfix}` : "_path",
366
+ ),
367
+ expected: next.expected,
368
+ input: next.input,
369
+ }),
370
+ full: props.config.equals
371
+ ? undefined
372
+ : (next) =>
373
+ ts.factory.createLogicalOr(
374
+ next.condition,
375
+ create_guard_call({
376
+ context: props.context,
377
+ functor: props.functor,
378
+ exceptionable:
379
+ next.explore.from === "top"
380
+ ? ts.factory.createTrue()
381
+ : ts.factory.createIdentifier("_exceptionable"),
382
+ path: ts.factory.createIdentifier("_path"),
383
+ expected: next.expected,
384
+ input: next.input,
385
+ }),
386
+ ),
387
+ });
388
+
389
+ const create_guard_call = (props: {
390
+ context: ITypiaContext;
391
+ functor: FunctionProgrammer;
392
+ expected: string;
393
+ input: ts.Expression;
394
+ path: ts.Expression;
395
+ exceptionable?: ts.Expression;
396
+ }): ts.Expression =>
397
+ ts.factory.createCallExpression(
398
+ props.context.importer.internal("assertGuard"),
399
+ undefined,
400
+ [
401
+ props.exceptionable ?? ts.factory.createIdentifier("_exceptionable"),
402
+ ts.factory.createObjectLiteralExpression(
403
+ [
404
+ ts.factory.createPropertyAssignment(
405
+ "method",
406
+ ts.factory.createStringLiteral(props.functor.method),
407
+ ),
408
+ ts.factory.createPropertyAssignment("path", props.path),
409
+ ts.factory.createPropertyAssignment(
410
+ "expected",
411
+ ts.factory.createStringLiteral(props.expected),
412
+ ),
413
+ ts.factory.createPropertyAssignment("value", props.input),
414
+ ],
415
+ true,
416
+ ),
417
+ ts.factory.createIdentifier("_errorFactory"),
418
+ ],
419
+ );
420
+
421
+ export namespace Guardian {
422
+ export const identifier = () => ts.factory.createIdentifier("errorFactory");
423
+ export const parameter = (props: {
424
+ context: ITypiaContext;
425
+ init: ts.Expression | undefined;
426
+ }) =>
427
+ IdentifierFactory.parameter(
428
+ "errorFactory",
429
+ type(props.context),
430
+ props.init ?? ts.factory.createToken(ts.SyntaxKind.QuestionToken),
431
+ );
432
+ export const type = (context: ITypiaContext) =>
433
+ ts.factory.createFunctionTypeNode(
434
+ undefined,
435
+ [
436
+ ts.factory.createParameterDeclaration(
437
+ undefined,
438
+ undefined,
439
+ ts.factory.createIdentifier("p"),
440
+ undefined,
441
+ context.importer.type({
442
+ file: "typia",
443
+ name: "TypeGuardError.IProps",
444
+ }),
445
+ undefined,
446
+ ),
447
+ ],
448
+ ts.factory.createTypeReferenceNode(
449
+ ts.factory.createIdentifier("Error"),
450
+ undefined,
451
+ ),
452
+ );
453
+ }
454
+ }