typia 8.2.0 → 9.0.0-dev.20250405-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 (548) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +150 -150
  3. package/lib/executable/setup/PluginConfigurator.js +3 -3
  4. package/lib/executable/setup/PluginConfigurator.mjs +3 -3
  5. package/lib/executable/typia.js +15 -15
  6. package/lib/executable/typia.mjs +15 -15
  7. package/lib/internal/_randomInteger.d.mts +1 -1
  8. package/lib/internal/_randomInteger.d.ts +1 -1
  9. package/lib/internal/_randomInteger.js +14 -10
  10. package/lib/internal/_randomInteger.js.map +1 -1
  11. package/lib/internal/_randomInteger.mjs +17 -11
  12. package/lib/internal/_randomNumber.js +13 -9
  13. package/lib/internal/_randomNumber.js.map +1 -1
  14. package/lib/internal/_randomNumber.mjs +12 -6
  15. package/lib/json.d.mts +0 -44
  16. package/lib/json.d.ts +0 -44
  17. package/lib/json.js +0 -7
  18. package/lib/json.js.map +1 -1
  19. package/lib/json.mjs +1 -7
  20. package/lib/llm.d.mts +0 -37
  21. package/lib/llm.d.ts +0 -37
  22. package/lib/llm.js +0 -7
  23. package/lib/llm.js.map +1 -1
  24. package/lib/llm.mjs +1 -7
  25. package/lib/module.d.mts +0 -2
  26. package/lib/module.d.ts +0 -2
  27. package/lib/module.js +0 -2
  28. package/lib/module.js.map +1 -1
  29. package/lib/tags/ExclusiveMaximum.d.mts +2 -4
  30. package/lib/tags/ExclusiveMaximum.d.ts +2 -4
  31. package/lib/tags/ExclusiveMinimum.d.mts +2 -4
  32. package/lib/tags/ExclusiveMinimum.d.ts +2 -4
  33. package/lib/tags/Type.d.mts +4 -1
  34. package/lib/tags/Type.d.ts +4 -1
  35. package/package.json +3 -3
  36. package/src/AssertionGuard.ts +1 -1
  37. package/src/CamelCase.ts +75 -75
  38. package/src/IRandomGenerator.ts +49 -49
  39. package/src/IReadableURLSearchParams.ts +9 -9
  40. package/src/IValidation.ts +1 -1
  41. package/src/PascalCase.ts +71 -71
  42. package/src/Primitive.ts +92 -92
  43. package/src/Resolved.ts +74 -74
  44. package/src/SnakeCase.ts +126 -126
  45. package/src/TypeGuardError.ts +37 -37
  46. package/src/executable/TypiaGenerateWizard.ts +83 -83
  47. package/src/executable/TypiaPatchWizard.ts +45 -45
  48. package/src/executable/TypiaSetupWizard.ts +171 -171
  49. package/src/executable/setup/ArgumentParser.ts +42 -42
  50. package/src/executable/setup/CommandExecutor.ts +8 -8
  51. package/src/executable/setup/FileRetriever.ts +19 -19
  52. package/src/executable/setup/PackageManager.ts +87 -87
  53. package/src/executable/setup/PluginConfigurator.ts +69 -69
  54. package/src/executable/typia.ts +55 -55
  55. package/src/factories/CommentFactory.ts +79 -79
  56. package/src/factories/ExpressionFactory.ts +216 -216
  57. package/src/factories/IdentifierFactory.ts +89 -89
  58. package/src/factories/JsonMetadataFactory.ts +83 -83
  59. package/src/factories/LiteralFactory.ts +52 -52
  60. package/src/factories/MetadataCollection.ts +278 -278
  61. package/src/factories/MetadataCommentTagFactory.ts +650 -650
  62. package/src/factories/MetadataFactory.ts +404 -404
  63. package/src/factories/MetadataTypeTagFactory.ts +413 -413
  64. package/src/factories/MetadataTypeTagSchemaFactory.ts +82 -82
  65. package/src/factories/NumericRangeFactory.ts +72 -72
  66. package/src/factories/ProtobufFactory.ts +875 -875
  67. package/src/factories/StatementFactory.ts +90 -90
  68. package/src/factories/TemplateFactory.ts +64 -64
  69. package/src/factories/TypeFactory.ts +140 -140
  70. package/src/factories/ValueFactory.ts +12 -12
  71. package/src/factories/internal/metadata/IMetadataIteratorProps.ts +17 -17
  72. package/src/factories/internal/metadata/MetadataHelper.ts +21 -21
  73. package/src/factories/internal/metadata/emend_metadata_atomics.ts +45 -45
  74. package/src/factories/internal/metadata/emplace_metadata_alias.ts +33 -33
  75. package/src/factories/internal/metadata/emplace_metadata_array_type.ts +39 -39
  76. package/src/factories/internal/metadata/emplace_metadata_object.ts +212 -212
  77. package/src/factories/internal/metadata/emplace_metadata_tuple.ts +57 -57
  78. package/src/factories/internal/metadata/explore_metadata.ts +31 -31
  79. package/src/factories/internal/metadata/iterate_metadata.ts +54 -54
  80. package/src/factories/internal/metadata/iterate_metadata_alias.ts +33 -33
  81. package/src/factories/internal/metadata/iterate_metadata_array.ts +63 -63
  82. package/src/factories/internal/metadata/iterate_metadata_atomic.ts +62 -62
  83. package/src/factories/internal/metadata/iterate_metadata_coalesce.ts +28 -28
  84. package/src/factories/internal/metadata/iterate_metadata_collection.ts +146 -146
  85. package/src/factories/internal/metadata/iterate_metadata_comment_tags.ts +32 -32
  86. package/src/factories/internal/metadata/iterate_metadata_constant.ts +76 -76
  87. package/src/factories/internal/metadata/iterate_metadata_escape.ts +49 -49
  88. package/src/factories/internal/metadata/iterate_metadata_function.ts +91 -91
  89. package/src/factories/internal/metadata/iterate_metadata_intersection.ts +212 -212
  90. package/src/factories/internal/metadata/iterate_metadata_map.ts +57 -57
  91. package/src/factories/internal/metadata/iterate_metadata_native.ts +255 -255
  92. package/src/factories/internal/metadata/iterate_metadata_object.ts +35 -35
  93. package/src/factories/internal/metadata/iterate_metadata_set.ts +57 -57
  94. package/src/factories/internal/metadata/iterate_metadata_sort.ts +87 -87
  95. package/src/factories/internal/metadata/iterate_metadata_template.ts +41 -41
  96. package/src/factories/internal/metadata/iterate_metadata_tuple.ts +26 -26
  97. package/src/factories/internal/metadata/iterate_metadata_union.ts +19 -19
  98. package/src/functional.ts +750 -750
  99. package/src/http.ts +1047 -1047
  100. package/src/index.ts +4 -4
  101. package/src/internal/_IProtobufWriter.ts +18 -18
  102. package/src/internal/_ProtobufReader.ts +194 -194
  103. package/src/internal/_ProtobufSizer.ts +145 -145
  104. package/src/internal/_ProtobufWriter.ts +145 -145
  105. package/src/internal/_accessExpressionAsString.ts +46 -46
  106. package/src/internal/_assertGuard.ts +13 -13
  107. package/src/internal/_functionalTypeGuardErrorFactory.ts +4 -4
  108. package/src/internal/_httpFormDataReadArray.ts +4 -4
  109. package/src/internal/_httpFormDataReadBigint.ts +18 -18
  110. package/src/internal/_httpFormDataReadBlob.ts +10 -10
  111. package/src/internal/_httpFormDataReadBoolean.ts +16 -16
  112. package/src/internal/_httpFormDataReadFile.ts +10 -10
  113. package/src/internal/_httpFormDataReadNumber.ts +15 -15
  114. package/src/internal/_httpFormDataReadString.ts +10 -10
  115. package/src/internal/_httpHeaderReadBigint.ts +10 -10
  116. package/src/internal/_httpHeaderReadBoolean.ts +8 -8
  117. package/src/internal/_httpHeaderReadNumber.ts +7 -7
  118. package/src/internal/_httpParameterReadBigint.ts +10 -10
  119. package/src/internal/_httpParameterReadBoolean.ts +8 -8
  120. package/src/internal/_httpParameterReadNumber.ts +7 -7
  121. package/src/internal/_httpParameterReadString.ts +2 -2
  122. package/src/internal/_httpQueryParseURLSearchParams.ts +12 -12
  123. package/src/internal/_httpQueryReadArray.ts +4 -4
  124. package/src/internal/_httpQueryReadBigint.ts +12 -12
  125. package/src/internal/_httpQueryReadBoolean.ts +14 -14
  126. package/src/internal/_httpQueryReadNumber.ts +9 -9
  127. package/src/internal/_httpQueryReadString.ts +4 -4
  128. package/src/internal/_isBetween.ts +2 -2
  129. package/src/internal/_isBigintString.ts +8 -8
  130. package/src/internal/_isFormatByte.ts +7 -7
  131. package/src/internal/_isFormatDate.ts +3 -3
  132. package/src/internal/_isFormatDateTime.ts +4 -4
  133. package/src/internal/_isFormatDuration.ts +4 -4
  134. package/src/internal/_isFormatEmail.ts +4 -4
  135. package/src/internal/_isFormatHostname.ts +4 -4
  136. package/src/internal/_isFormatIdnEmail.ts +4 -4
  137. package/src/internal/_isFormatIdnHostname.ts +4 -4
  138. package/src/internal/_isFormatIpv4.ts +4 -4
  139. package/src/internal/_isFormatIpv6.ts +4 -4
  140. package/src/internal/_isFormatIri.ts +3 -3
  141. package/src/internal/_isFormatIriReference.ts +4 -4
  142. package/src/internal/_isFormatJsonPointer.ts +3 -3
  143. package/src/internal/_isFormatPassword.ts +1 -1
  144. package/src/internal/_isFormatRegex.ts +8 -8
  145. package/src/internal/_isFormatRelativeJsonPointer.ts +4 -4
  146. package/src/internal/_isFormatTime.ts +4 -4
  147. package/src/internal/_isFormatUri.ts +6 -6
  148. package/src/internal/_isFormatUriReference.ts +5 -5
  149. package/src/internal/_isFormatUriTemplate.ts +4 -4
  150. package/src/internal/_isFormatUrl.ts +4 -4
  151. package/src/internal/_isFormatUuid.ts +3 -3
  152. package/src/internal/_isTypeFloat.ts +5 -5
  153. package/src/internal/_isTypeInt32.ts +5 -5
  154. package/src/internal/_isTypeInt64.ts +5 -5
  155. package/src/internal/_isTypeUint32.ts +5 -5
  156. package/src/internal/_isTypeUint64.ts +5 -5
  157. package/src/internal/_isUniqueItems.ts +159 -159
  158. package/src/internal/_jsonStringifyNumber.ts +12 -12
  159. package/src/internal/_jsonStringifyRest.ts +3 -3
  160. package/src/internal/_jsonStringifyString.ts +42 -42
  161. package/src/internal/_jsonStringifyTail.ts +2 -2
  162. package/src/internal/_llmApplicationFinalize.ts +20 -20
  163. package/src/internal/_miscCloneAny.ts +46 -46
  164. package/src/internal/_notationAny.ts +37 -37
  165. package/src/internal/_notationCamel.ts +13 -13
  166. package/src/internal/_notationPascal.ts +8 -8
  167. package/src/internal/_notationSnake.ts +43 -43
  168. package/src/internal/_randomArray.ts +21 -21
  169. package/src/internal/_randomBigint.ts +6 -6
  170. package/src/internal/_randomBoolean.ts +1 -1
  171. package/src/internal/_randomFormatByte.ts +3 -3
  172. package/src/internal/_randomFormatDate.ts +18 -18
  173. package/src/internal/_randomFormatDatetime.ts +16 -16
  174. package/src/internal/_randomFormatDuration.ts +27 -27
  175. package/src/internal/_randomFormatEmail.ts +11 -11
  176. package/src/internal/_randomFormatHostname.ts +6 -6
  177. package/src/internal/_randomFormatIdnEmail.ts +3 -3
  178. package/src/internal/_randomFormatIdnHostname.ts +3 -3
  179. package/src/internal/_randomFormatIpv4.ts +11 -11
  180. package/src/internal/_randomFormatIpv6.ts +11 -11
  181. package/src/internal/_randomFormatIri.ts +3 -3
  182. package/src/internal/_randomFormatIriReference.ts +3 -3
  183. package/src/internal/_randomFormatJsonPointer.ts +7 -7
  184. package/src/internal/_randomFormatPassword.ts +8 -8
  185. package/src/internal/_randomFormatRegex.ts +4 -4
  186. package/src/internal/_randomFormatRelativeJsonPointer.ts +8 -8
  187. package/src/internal/_randomFormatTime.ts +14 -14
  188. package/src/internal/_randomFormatUri.ts +3 -3
  189. package/src/internal/_randomFormatUriReference.ts +3 -3
  190. package/src/internal/_randomFormatUriTemplate.ts +3 -3
  191. package/src/internal/_randomFormatUrl.ts +11 -11
  192. package/src/internal/_randomFormatUuid.ts +6 -6
  193. package/src/internal/_randomInteger.ts +53 -47
  194. package/src/internal/_randomNumber.ts +80 -74
  195. package/src/internal/_randomPattern.ts +10 -10
  196. package/src/internal/_randomPick.ts +9 -9
  197. package/src/internal/_randomString.ts +24 -24
  198. package/src/internal/_throwTypeGuardError.ts +5 -5
  199. package/src/internal/_validateReport.ts +13 -13
  200. package/src/internal/private/__notationCapitalize.ts +2 -2
  201. package/src/internal/private/__notationUnsnake.ts +24 -24
  202. package/src/json.ts +696 -752
  203. package/src/llm.ts +342 -396
  204. package/src/misc.ts +658 -658
  205. package/src/module.ts +935 -937
  206. package/src/notations.ts +827 -827
  207. package/src/programmers/AssertProgrammer.ts +454 -454
  208. package/src/programmers/CheckerProgrammer.ts +1617 -1617
  209. package/src/programmers/FeatureProgrammer.ts +622 -622
  210. package/src/programmers/ImportProgrammer.ts +185 -185
  211. package/src/programmers/IsProgrammer.ts +273 -273
  212. package/src/programmers/RandomProgrammer.ts +1190 -1190
  213. package/src/programmers/TypiaProgrammer.ts +175 -175
  214. package/src/programmers/ValidateProgrammer.ts +439 -439
  215. package/src/programmers/functional/FunctionalAssertFunctionProgrammer.ts +153 -153
  216. package/src/programmers/functional/FunctionalAssertParametersProgrammer.ts +125 -125
  217. package/src/programmers/functional/FunctionalAssertReturnProgrammer.ts +115 -115
  218. package/src/programmers/functional/FunctionalIsFunctionProgrammer.ts +72 -72
  219. package/src/programmers/functional/FunctionalIsParametersProgrammer.ts +113 -113
  220. package/src/programmers/functional/FunctionalIsReturnProgrammer.ts +116 -116
  221. package/src/programmers/functional/FunctionalValidateFunctionProgrammer.ts +119 -119
  222. package/src/programmers/functional/FunctionalValidateParametersProgrammer.ts +274 -274
  223. package/src/programmers/functional/FunctionalValidateReturnProgrammer.ts +135 -135
  224. package/src/programmers/functional/internal/FunctionalGeneralProgrammer.ts +34 -34
  225. package/src/programmers/helpers/AtomicPredicator.ts +35 -35
  226. package/src/programmers/helpers/CloneJoiner.ts +143 -143
  227. package/src/programmers/helpers/FunctionProgrammer.ts +67 -67
  228. package/src/programmers/helpers/HttpMetadataUtil.ts +21 -21
  229. package/src/programmers/helpers/ICheckEntry.ts +13 -13
  230. package/src/programmers/helpers/IExpressionEntry.ts +12 -12
  231. package/src/programmers/helpers/NotationJoiner.ts +144 -144
  232. package/src/programmers/helpers/OptionPredicator.ts +15 -15
  233. package/src/programmers/helpers/ProtobufUtil.ts +228 -228
  234. package/src/programmers/helpers/ProtobufWire.ts +34 -34
  235. package/src/programmers/helpers/PruneJoiner.ts +148 -148
  236. package/src/programmers/helpers/RandomJoiner.ts +168 -168
  237. package/src/programmers/helpers/StringifyJoinder.ts +115 -115
  238. package/src/programmers/helpers/StringifyPredicator.ts +13 -13
  239. package/src/programmers/helpers/UnionExplorer.ts +372 -372
  240. package/src/programmers/helpers/UnionPredicator.ts +79 -79
  241. package/src/programmers/helpers/disable_function_programmer_declare.ts +32 -32
  242. package/src/programmers/http/HttpAssertFormDataProgrammer.ts +99 -99
  243. package/src/programmers/http/HttpAssertHeadersProgrammer.ts +99 -99
  244. package/src/programmers/http/HttpAssertQueryProgrammer.ts +105 -105
  245. package/src/programmers/http/HttpFormDataProgrammer.ts +308 -308
  246. package/src/programmers/http/HttpHeadersProgrammer.ts +400 -400
  247. package/src/programmers/http/HttpIsFormDataProgrammer.ts +108 -108
  248. package/src/programmers/http/HttpIsHeadersProgrammer.ts +108 -108
  249. package/src/programmers/http/HttpIsQueryProgrammer.ts +114 -114
  250. package/src/programmers/http/HttpParameterProgrammer.ts +115 -115
  251. package/src/programmers/http/HttpQueryProgrammer.ts +336 -336
  252. package/src/programmers/http/HttpValidateFormDataProgrammer.ts +92 -92
  253. package/src/programmers/http/HttpValidateHeadersProgrammer.ts +92 -92
  254. package/src/programmers/http/HttpValidateQueryProgrammer.ts +98 -98
  255. package/src/programmers/internal/check_array_length.ts +47 -47
  256. package/src/programmers/internal/check_bigint.ts +50 -50
  257. package/src/programmers/internal/check_dynamic_key.ts +201 -201
  258. package/src/programmers/internal/check_dynamic_properties.ts +208 -208
  259. package/src/programmers/internal/check_everything.ts +23 -23
  260. package/src/programmers/internal/check_native.ts +27 -27
  261. package/src/programmers/internal/check_number.ts +112 -112
  262. package/src/programmers/internal/check_object.ts +75 -75
  263. package/src/programmers/internal/check_string.ts +50 -50
  264. package/src/programmers/internal/check_template.ts +48 -48
  265. package/src/programmers/internal/check_union_array_like.ts +335 -335
  266. package/src/programmers/internal/decode_union_object.ts +116 -116
  267. package/src/programmers/internal/feature_object_entries.ts +61 -61
  268. package/src/programmers/internal/json_schema_alias.ts +47 -47
  269. package/src/programmers/internal/json_schema_array.ts +45 -45
  270. package/src/programmers/internal/json_schema_bigint.ts +15 -15
  271. package/src/programmers/internal/json_schema_boolean.ts +15 -15
  272. package/src/programmers/internal/json_schema_constant.ts +26 -26
  273. package/src/programmers/internal/json_schema_description.ts +12 -12
  274. package/src/programmers/internal/json_schema_discriminator.ts +35 -35
  275. package/src/programmers/internal/json_schema_escaped.ts +82 -82
  276. package/src/programmers/internal/json_schema_native.ts +33 -33
  277. package/src/programmers/internal/json_schema_number.ts +15 -15
  278. package/src/programmers/internal/json_schema_object.ts +158 -158
  279. package/src/programmers/internal/json_schema_plugin.ts +18 -18
  280. package/src/programmers/internal/json_schema_station.ts +182 -182
  281. package/src/programmers/internal/json_schema_string.ts +15 -15
  282. package/src/programmers/internal/json_schema_template.ts +55 -55
  283. package/src/programmers/internal/json_schema_title.ts +20 -20
  284. package/src/programmers/internal/json_schema_tuple.ts +35 -35
  285. package/src/programmers/internal/metadata_to_pattern.ts +42 -42
  286. package/src/programmers/internal/postfix_of_tuple.ts +5 -5
  287. package/src/programmers/internal/prune_object_properties.ts +71 -71
  288. package/src/programmers/internal/stringify_dynamic_properties.ts +162 -162
  289. package/src/programmers/internal/stringify_native.ts +7 -7
  290. package/src/programmers/internal/stringify_regular_properties.ts +81 -81
  291. package/src/programmers/internal/template_to_pattern.ts +23 -23
  292. package/src/programmers/internal/wrap_metadata_rest_tuple.ts +23 -23
  293. package/src/programmers/json/JsonApplicationProgrammer.ts +266 -266
  294. package/src/programmers/json/JsonAssertParseProgrammer.ts +113 -113
  295. package/src/programmers/json/JsonAssertStringifyProgrammer.ts +115 -115
  296. package/src/programmers/json/JsonIsParseProgrammer.ts +114 -114
  297. package/src/programmers/json/JsonIsStringifyProgrammer.ts +108 -108
  298. package/src/programmers/json/JsonSchemasProgrammer.ts +91 -91
  299. package/src/programmers/json/JsonStringifyProgrammer.ts +1124 -1124
  300. package/src/programmers/json/JsonValidateParseProgrammer.ts +105 -105
  301. package/src/programmers/json/JsonValidateStringifyProgrammer.ts +124 -124
  302. package/src/programmers/llm/LlmApplicationProgrammer.ts +401 -401
  303. package/src/programmers/llm/LlmModelPredicator.ts +127 -127
  304. package/src/programmers/llm/LlmParametersProgrammer.ts +93 -93
  305. package/src/programmers/llm/LlmSchemaProgrammer.ts +192 -192
  306. package/src/programmers/misc/MiscAssertCloneProgrammer.ts +95 -95
  307. package/src/programmers/misc/MiscAssertPruneProgrammer.ts +116 -116
  308. package/src/programmers/misc/MiscCloneProgrammer.ts +1032 -1032
  309. package/src/programmers/misc/MiscIsCloneProgrammer.ts +99 -99
  310. package/src/programmers/misc/MiscIsPruneProgrammer.ts +97 -97
  311. package/src/programmers/misc/MiscLiteralsProgrammer.ts +80 -80
  312. package/src/programmers/misc/MiscPruneProgrammer.ts +728 -728
  313. package/src/programmers/misc/MiscValidateCloneProgrammer.ts +111 -111
  314. package/src/programmers/misc/MiscValidatePruneProgrammer.ts +113 -113
  315. package/src/programmers/notations/NotationAssertGeneralProgrammer.ts +101 -101
  316. package/src/programmers/notations/NotationGeneralProgrammer.ts +984 -984
  317. package/src/programmers/notations/NotationIsGeneralProgrammer.ts +105 -105
  318. package/src/programmers/notations/NotationValidateGeneralProgrammer.ts +119 -119
  319. package/src/programmers/protobuf/ProtobufAssertDecodeProgrammer.ts +98 -98
  320. package/src/programmers/protobuf/ProtobufAssertEncodeProgrammer.ts +102 -102
  321. package/src/programmers/protobuf/ProtobufDecodeProgrammer.ts +654 -654
  322. package/src/programmers/protobuf/ProtobufEncodeProgrammer.ts +945 -945
  323. package/src/programmers/protobuf/ProtobufIsDecodeProgrammer.ts +109 -109
  324. package/src/programmers/protobuf/ProtobufIsEncodeProgrammer.ts +98 -98
  325. package/src/programmers/protobuf/ProtobufMessageProgrammer.ts +179 -179
  326. package/src/programmers/protobuf/ProtobufValidateDecodeProgrammer.ts +92 -92
  327. package/src/programmers/protobuf/ProtobufValidateEncodeProgrammer.ts +119 -119
  328. package/src/protobuf.ts +868 -868
  329. package/src/reflect.ts +57 -57
  330. package/src/schemas/json/IJsonApplication.ts +73 -73
  331. package/src/schemas/json/IJsonSchemaCollection.ts +29 -29
  332. package/src/schemas/json/__IJsonApplication.ts +63 -63
  333. package/src/schemas/metadata/IJsDocTagInfo.ts +10 -10
  334. package/src/schemas/metadata/IMetadata.ts +35 -35
  335. package/src/schemas/metadata/IMetadataAlias.ts +6 -6
  336. package/src/schemas/metadata/IMetadataAliasType.ts +12 -12
  337. package/src/schemas/metadata/IMetadataApplication.ts +7 -7
  338. package/src/schemas/metadata/IMetadataArray.ts +6 -6
  339. package/src/schemas/metadata/IMetadataArrayType.ts +10 -10
  340. package/src/schemas/metadata/IMetadataAtomic.ts +6 -6
  341. package/src/schemas/metadata/IMetadataComponents.ts +11 -11
  342. package/src/schemas/metadata/IMetadataConstant.ts +18 -18
  343. package/src/schemas/metadata/IMetadataConstantValue.ts +11 -11
  344. package/src/schemas/metadata/IMetadataDictionary.ts +11 -11
  345. package/src/schemas/metadata/IMetadataEscaped.ts +6 -6
  346. package/src/schemas/metadata/IMetadataFunction.ts +8 -8
  347. package/src/schemas/metadata/IMetadataMap.ts +8 -8
  348. package/src/schemas/metadata/IMetadataNative.ts +6 -6
  349. package/src/schemas/metadata/IMetadataObject.ts +6 -6
  350. package/src/schemas/metadata/IMetadataObjectType.ts +13 -13
  351. package/src/schemas/metadata/IMetadataParameter.ts +9 -9
  352. package/src/schemas/metadata/IMetadataProperty.ts +9 -9
  353. package/src/schemas/metadata/IMetadataSet.ts +7 -7
  354. package/src/schemas/metadata/IMetadataTemplate.ts +7 -7
  355. package/src/schemas/metadata/IMetadataTuple.ts +6 -6
  356. package/src/schemas/metadata/IMetadataTupleType.ts +10 -10
  357. package/src/schemas/metadata/IMetadataTypeTag.ts +16 -16
  358. package/src/schemas/metadata/Metadata.ts +687 -687
  359. package/src/schemas/metadata/MetadataAlias.ts +46 -46
  360. package/src/schemas/metadata/MetadataAliasType.ts +63 -63
  361. package/src/schemas/metadata/MetadataApplication.ts +44 -44
  362. package/src/schemas/metadata/MetadataArray.ts +49 -49
  363. package/src/schemas/metadata/MetadataArrayType.ts +57 -57
  364. package/src/schemas/metadata/MetadataAtomic.ts +87 -87
  365. package/src/schemas/metadata/MetadataComponents.ts +98 -98
  366. package/src/schemas/metadata/MetadataConstant.ts +34 -34
  367. package/src/schemas/metadata/MetadataConstantValue.ts +62 -62
  368. package/src/schemas/metadata/MetadataEscaped.ts +51 -51
  369. package/src/schemas/metadata/MetadataFunction.ts +49 -49
  370. package/src/schemas/metadata/MetadataMap.ts +48 -48
  371. package/src/schemas/metadata/MetadataNative.ts +44 -44
  372. package/src/schemas/metadata/MetadataObject.ts +48 -48
  373. package/src/schemas/metadata/MetadataObjectType.ts +149 -149
  374. package/src/schemas/metadata/MetadataParameter.ts +54 -54
  375. package/src/schemas/metadata/MetadataProperty.ts +59 -59
  376. package/src/schemas/metadata/MetadataSet.ts +45 -45
  377. package/src/schemas/metadata/MetadataTemplate.ts +80 -80
  378. package/src/schemas/metadata/MetadataTuple.ts +32 -32
  379. package/src/schemas/metadata/MetadataTupleType.ts +67 -67
  380. package/src/schemas/protobuf/IProtobufProperty.ts +6 -6
  381. package/src/schemas/protobuf/IProtobufPropertyType.ts +37 -37
  382. package/src/schemas/protobuf/IProtobufSchema.ts +50 -50
  383. package/src/tags/Constant.ts +15 -15
  384. package/src/tags/ContentMediaType.ts +10 -10
  385. package/src/tags/Default.ts +22 -22
  386. package/src/tags/Example.ts +24 -24
  387. package/src/tags/Examples.ts +16 -16
  388. package/src/tags/ExclusiveMaximum.ts +23 -25
  389. package/src/tags/ExclusiveMinimum.ts +23 -25
  390. package/src/tags/Format.ts +50 -50
  391. package/src/tags/JsonSchemaPlugin.ts +8 -8
  392. package/src/tags/MaxItems.ts +12 -12
  393. package/src/tags/MaxLength.ts +12 -12
  394. package/src/tags/Maximum.ts +19 -19
  395. package/src/tags/MinItems.ts +12 -12
  396. package/src/tags/MinLength.ts +12 -12
  397. package/src/tags/Minimum.ts +19 -19
  398. package/src/tags/MultipleOf.ts +21 -21
  399. package/src/tags/Pattern.ts +31 -31
  400. package/src/tags/Sequence.ts +10 -10
  401. package/src/tags/TagBase.ts +82 -82
  402. package/src/tags/Type.ts +37 -32
  403. package/src/tags/UniqueItems.ts +14 -14
  404. package/src/tags/index.ts +21 -21
  405. package/src/tags/internal/FormatCheatSheet.ts +73 -73
  406. package/src/transform.ts +35 -35
  407. package/src/transformers/CallExpressionTransformer.ts +546 -546
  408. package/src/transformers/FileTransformer.ts +136 -136
  409. package/src/transformers/IProgrammerProps.ts +11 -11
  410. package/src/transformers/ITransformOptions.ts +62 -62
  411. package/src/transformers/ITransformProps.ts +9 -9
  412. package/src/transformers/ITypiaContext.ts +18 -18
  413. package/src/transformers/ImportTransformer.ts +81 -81
  414. package/src/transformers/NodeTransformer.ts +17 -17
  415. package/src/transformers/TransformerError.ts +60 -60
  416. package/src/transformers/features/AssertTransformer.ts +24 -24
  417. package/src/transformers/features/CreateAssertTransformer.ts +24 -24
  418. package/src/transformers/features/CreateIsTransformer.ts +18 -18
  419. package/src/transformers/features/CreateRandomTransformer.ts +43 -43
  420. package/src/transformers/features/CreateValidateTransformer.ts +18 -18
  421. package/src/transformers/features/IsTransformer.ts +18 -18
  422. package/src/transformers/features/RandomTransformer.ts +41 -41
  423. package/src/transformers/features/ValidateTransformer.ts +18 -18
  424. package/src/transformers/features/functional/FunctionalGenericTransformer.ts +57 -57
  425. package/src/transformers/features/http/CreateHttpAssertFormDataTransformer.ts +13 -13
  426. package/src/transformers/features/http/CreateHttpAssertHeadersTransformer.ts +13 -13
  427. package/src/transformers/features/http/CreateHttpAssertQueryTransformer.ts +13 -13
  428. package/src/transformers/features/http/CreateHttpFormDataTransformer.ts +13 -13
  429. package/src/transformers/features/http/CreateHttpHeadersTransformer.ts +13 -13
  430. package/src/transformers/features/http/CreateHttpIsFormDataTransformer.ts +13 -13
  431. package/src/transformers/features/http/CreateHttpIsHeadersTransformer.ts +13 -13
  432. package/src/transformers/features/http/CreateHttpIsQueryTransformer.ts +13 -13
  433. package/src/transformers/features/http/CreateHttpParameterTransformer.ts +13 -13
  434. package/src/transformers/features/http/CreateHttpQueryTransformer.ts +13 -13
  435. package/src/transformers/features/http/CreateHttpValidateFormDataTransformer.ts +13 -13
  436. package/src/transformers/features/http/CreateHttpValidateHeadersTransformer.ts +13 -13
  437. package/src/transformers/features/http/CreateHttpValidateQueryTransformer.ts +13 -13
  438. package/src/transformers/features/http/HttpAssertFormDataTransformer.ts +13 -13
  439. package/src/transformers/features/http/HttpAssertHeadersTransformer.ts +13 -13
  440. package/src/transformers/features/http/HttpAssertQueryTransformer.ts +13 -13
  441. package/src/transformers/features/http/HttpFormDataTransformer.ts +13 -13
  442. package/src/transformers/features/http/HttpHeadersTransformer.ts +13 -13
  443. package/src/transformers/features/http/HttpIsFormDataTransformer.ts +13 -13
  444. package/src/transformers/features/http/HttpIsHeadersTransformer.ts +13 -13
  445. package/src/transformers/features/http/HttpIsQueryTransformer.ts +13 -13
  446. package/src/transformers/features/http/HttpParameterTransformer.ts +13 -13
  447. package/src/transformers/features/http/HttpQueryTransformer.ts +13 -13
  448. package/src/transformers/features/http/HttpValidateFormDataTransformer.ts +13 -13
  449. package/src/transformers/features/http/HttpValidateHeadersTransformer.ts +13 -13
  450. package/src/transformers/features/http/HttpValidateQueryTransformer.ts +13 -13
  451. package/src/transformers/features/json/JsonApplicationTransformer.ts +105 -105
  452. package/src/transformers/features/json/JsonAssertParseTransformer.ts +13 -13
  453. package/src/transformers/features/json/JsonAssertStringifyTransformer.ts +13 -13
  454. package/src/transformers/features/json/JsonCreateAssertParseTransformer.ts +13 -13
  455. package/src/transformers/features/json/JsonCreateAssertStringifyTransformer.ts +13 -13
  456. package/src/transformers/features/json/JsonCreateIsParseTransformer.ts +13 -13
  457. package/src/transformers/features/json/JsonCreateIsStringifyTransformer.ts +13 -13
  458. package/src/transformers/features/json/JsonCreateStringifyTransformer.ts +13 -13
  459. package/src/transformers/features/json/JsonCreateValidateParseTransformer.ts +13 -13
  460. package/src/transformers/features/json/JsonCreateValidateStringifyProgrammer.ts +13 -13
  461. package/src/transformers/features/json/JsonIsParseTransformer.ts +13 -13
  462. package/src/transformers/features/json/JsonIsStringifyTransformer.ts +13 -13
  463. package/src/transformers/features/json/JsonSchemasTransformer.ts +145 -145
  464. package/src/transformers/features/json/JsonStringifyTransformer.ts +13 -13
  465. package/src/transformers/features/json/JsonValidateParseTransformer.ts +13 -13
  466. package/src/transformers/features/json/JsonValidateStringifyTransformer.ts +13 -13
  467. package/src/transformers/features/llm/LlmApplicationTransformer.ts +128 -128
  468. package/src/transformers/features/llm/LlmParametersTransformer.ts +102 -102
  469. package/src/transformers/features/llm/LlmSchemaTransformer.ts +170 -170
  470. package/src/transformers/features/misc/MiscAssertCloneTransformer.ts +13 -13
  471. package/src/transformers/features/misc/MiscAssertPruneTransformer.ts +13 -13
  472. package/src/transformers/features/misc/MiscCloneTransformer.ts +13 -13
  473. package/src/transformers/features/misc/MiscCreateAssertCloneTransformer.ts +13 -13
  474. package/src/transformers/features/misc/MiscCreateAssertPruneTransformer.ts +13 -13
  475. package/src/transformers/features/misc/MiscCreateCloneTransformer.ts +13 -13
  476. package/src/transformers/features/misc/MiscCreateIsCloneTransformer.ts +13 -13
  477. package/src/transformers/features/misc/MiscCreateIsPruneTransformer.ts +13 -13
  478. package/src/transformers/features/misc/MiscCreatePruneTransformer.ts +13 -13
  479. package/src/transformers/features/misc/MiscCreateValidateCloneTransformer.ts +13 -13
  480. package/src/transformers/features/misc/MiscCreateValidatePruneTransformer.ts +13 -13
  481. package/src/transformers/features/misc/MiscIsCloneTransformer.ts +13 -13
  482. package/src/transformers/features/misc/MiscIsPruneTransformer.ts +13 -13
  483. package/src/transformers/features/misc/MiscLiteralsTransformer.ts +35 -35
  484. package/src/transformers/features/misc/MiscPruneTransformer.ts +13 -13
  485. package/src/transformers/features/misc/MiscValidateCloneTransformer.ts +13 -13
  486. package/src/transformers/features/misc/MiscValidatePruneTransformer.ts +13 -13
  487. package/src/transformers/features/notations/NotationAssertGeneralTransformer.ts +20 -20
  488. package/src/transformers/features/notations/NotationCreateAssertGeneralTransformer.ts +20 -20
  489. package/src/transformers/features/notations/NotationCreateGeneralTransformer.ts +20 -20
  490. package/src/transformers/features/notations/NotationCreateIsGeneralTransformer.ts +20 -20
  491. package/src/transformers/features/notations/NotationCreateValidateGeneralTransformer.ts +20 -20
  492. package/src/transformers/features/notations/NotationGeneralTransformer.ts +18 -18
  493. package/src/transformers/features/notations/NotationIsGeneralTransformer.ts +20 -20
  494. package/src/transformers/features/notations/NotationValidateGeneralTransformer.ts +20 -20
  495. package/src/transformers/features/protobuf/ProtobufAssertDecodeTransformer.ts +13 -13
  496. package/src/transformers/features/protobuf/ProtobufAssertEncodeTransformer.ts +13 -13
  497. package/src/transformers/features/protobuf/ProtobufCreateAssertDecodeTransformer.ts +13 -13
  498. package/src/transformers/features/protobuf/ProtobufCreateAssertEncodeTransformer.ts +13 -13
  499. package/src/transformers/features/protobuf/ProtobufCreateDecodeTransformer.ts +13 -13
  500. package/src/transformers/features/protobuf/ProtobufCreateEncodeTransformer.ts +13 -13
  501. package/src/transformers/features/protobuf/ProtobufCreateIsDecodeTransformer.ts +13 -13
  502. package/src/transformers/features/protobuf/ProtobufCreateIsEncodeTransformer.ts +13 -13
  503. package/src/transformers/features/protobuf/ProtobufCreateValidateDecodeTransformer.ts +13 -13
  504. package/src/transformers/features/protobuf/ProtobufCreateValidateEncodeTransformer.ts +13 -13
  505. package/src/transformers/features/protobuf/ProtobufDecodeTransformer.ts +13 -13
  506. package/src/transformers/features/protobuf/ProtobufEncodeTransformer.ts +13 -13
  507. package/src/transformers/features/protobuf/ProtobufIsDecodeTransformer.ts +13 -13
  508. package/src/transformers/features/protobuf/ProtobufIsEncodeTransformer.ts +13 -13
  509. package/src/transformers/features/protobuf/ProtobufMessageTransformer.ts +35 -35
  510. package/src/transformers/features/protobuf/ProtobufValidateDecodeTransformer.ts +13 -13
  511. package/src/transformers/features/protobuf/ProtobufValidateEncodeTransformer.ts +13 -13
  512. package/src/transformers/features/reflect/ReflectMetadataTransformer.ts +69 -69
  513. package/src/transformers/features/reflect/ReflectNameTransformer.ts +82 -82
  514. package/src/transformers/internal/GenericTransformer.ts +101 -101
  515. package/src/typings/Atomic.ts +13 -13
  516. package/src/typings/ClassProperties.ts +5 -5
  517. package/src/typings/Customizable.ts +5 -5
  518. package/src/typings/Equal.ts +18 -18
  519. package/src/typings/IsTuple.ts +9 -9
  520. package/src/typings/NativeClass.ts +23 -23
  521. package/src/typings/OmitNever.ts +3 -3
  522. package/src/typings/ProtobufAtomic.ts +19 -19
  523. package/src/typings/SpecialFields.ts +3 -3
  524. package/src/typings/ValidationPipe.ts +9 -9
  525. package/src/typings/ValueOf.ts +20 -20
  526. package/src/typings/Writable.ts +11 -11
  527. package/src/utils/ArrayUtil.ts +41 -41
  528. package/src/utils/Escaper.ts +50 -50
  529. package/src/utils/MapUtil.ts +14 -14
  530. package/src/utils/NamingConvention.ts +94 -94
  531. package/src/utils/PatternUtil.ts +29 -29
  532. package/src/utils/ProtobufNameEncoder.ts +32 -32
  533. package/src/utils/Singleton.ts +16 -16
  534. package/src/utils/StringUtil.ts +16 -16
  535. package/lib/schemas/llm/ILlmApplicationOfValidate.d.mts +0 -5
  536. package/lib/schemas/llm/ILlmApplicationOfValidate.d.ts +0 -5
  537. package/lib/schemas/llm/ILlmApplicationOfValidate.js +0 -3
  538. package/lib/schemas/llm/ILlmApplicationOfValidate.js.map +0 -1
  539. package/lib/schemas/llm/ILlmApplicationOfValidate.mjs +0 -2
  540. package/lib/schemas/llm/ILlmApplicationOfValidate.mjs.map +0 -1
  541. package/lib/schemas/llm/ILlmFunctionOfValidate.d.mts +0 -5
  542. package/lib/schemas/llm/ILlmFunctionOfValidate.d.ts +0 -5
  543. package/lib/schemas/llm/ILlmFunctionOfValidate.js +0 -3
  544. package/lib/schemas/llm/ILlmFunctionOfValidate.js.map +0 -1
  545. package/lib/schemas/llm/ILlmFunctionOfValidate.mjs +0 -2
  546. package/lib/schemas/llm/ILlmFunctionOfValidate.mjs.map +0 -1
  547. package/src/schemas/llm/ILlmApplicationOfValidate.ts +0 -6
  548. package/src/schemas/llm/ILlmFunctionOfValidate.ts +0 -6
@@ -1,875 +1,875 @@
1
- import ts from "typescript";
2
-
3
- import { IMetadataTypeTag } from "../schemas/metadata/IMetadataTypeTag";
4
- import { Metadata } from "../schemas/metadata/Metadata";
5
- import { MetadataObjectType } from "../schemas/metadata/MetadataObjectType";
6
- import { MetadataProperty } from "../schemas/metadata/MetadataProperty";
7
- import { IProtobufProperty } from "../schemas/protobuf/IProtobufProperty";
8
- import { IProtobufPropertyType } from "../schemas/protobuf/IProtobufPropertyType";
9
- import { IProtobufSchema } from "../schemas/protobuf/IProtobufSchema";
10
-
11
- import { ProtobufUtil } from "../programmers/helpers/ProtobufUtil";
12
-
13
- import { TransformerError } from "../transformers/TransformerError";
14
-
15
- import { ProtobufAtomic } from "../typings/ProtobufAtomic";
16
- import { ValidationPipe } from "../typings/ValidationPipe";
17
-
18
- import { MetadataCollection } from "./MetadataCollection";
19
- import { MetadataFactory } from "./MetadataFactory";
20
-
21
- export namespace ProtobufFactory {
22
- export interface IProps {
23
- method: string;
24
- checker: ts.TypeChecker;
25
- transformer?: ts.TransformationContext;
26
- collection: MetadataCollection;
27
- type: ts.Type;
28
- }
29
-
30
- /* -----------------------------------------------------------
31
- METADATA COMPOSER
32
- ----------------------------------------------------------- */
33
- export const metadata = (props: IProps): Metadata => {
34
- // COMPOSE METADATA WITH INDIVIDUAL VALIDATIONS
35
- const result: ValidationPipe<Metadata, MetadataFactory.IError> =
36
- MetadataFactory.analyze({
37
- ...props,
38
- transformer: props.transformer,
39
- options: {
40
- escape: false,
41
- constant: true,
42
- absorb: true,
43
- validate: validate(),
44
- },
45
- });
46
- if (result.success === false)
47
- throw TransformerError.from({
48
- code: `typia.protobuf.${props.method}`,
49
- errors: result.errors,
50
- });
51
- return result.data;
52
- };
53
-
54
- /**
55
- * @internal
56
- */
57
- export const emplaceObject = (object: MetadataObjectType): void => {
58
- for (const p of object.properties) emplaceProperty(p);
59
- const properties: IProtobufProperty[] = object.properties
60
- .map((p) => p.of_protobuf_)
61
- .filter((p) => p !== undefined);
62
- const unique: Set<number> = new Set(
63
- properties
64
- .filter((p) => p !== undefined)
65
- .filter((p) => p.fixed === true)
66
- .map((p) => p.union.map((u) => u.index))
67
- .flat(),
68
- );
69
- let index: number = 1;
70
- properties.forEach((schema) => {
71
- if (schema.fixed === true)
72
- index = Math.max(
73
- index,
74
- Math.max(...schema.union.map((u) => u.index)) + 1,
75
- );
76
- else {
77
- for (const u of schema.union) {
78
- while (unique.has(index) === true) ++index;
79
- u.index = index;
80
- unique.add(index);
81
- }
82
- ++index;
83
- }
84
- });
85
- };
86
-
87
- const emplaceProperty = (prop: MetadataProperty): void => {
88
- const union: IProtobufPropertyType[] = [];
89
- for (const native of prop.value.natives)
90
- if (native.name === "Uint8Array")
91
- union.push({
92
- type: "bytes",
93
- index: ProtobufUtil.getSequence(native.tags[0] ?? [])!,
94
- });
95
- union.push(...emplaceAtomic(prop.value).values());
96
- for (const array of prop.value.arrays)
97
- union.push({
98
- type: "array",
99
- array: array.type,
100
- value: emplaceSchema(
101
- array.type.value,
102
- ) as IProtobufSchema.IArray["value"],
103
- index: ProtobufUtil.getSequence(array.tags[0] ?? [])!,
104
- });
105
- for (const obj of prop.value.objects)
106
- if (isDynamicObject(obj.type))
107
- union.push({
108
- type: "map",
109
- map: obj.type,
110
- key: emplaceSchema(
111
- obj.type.properties[0]!.key,
112
- ) as IProtobufSchema.IMap["key"],
113
- value: emplaceSchema(
114
- obj.type.properties[0]!.value,
115
- ) as IProtobufSchema.IMap["value"],
116
- index: ProtobufUtil.getSequence(obj.tags[0] ?? [])!,
117
- });
118
- else
119
- union.push({
120
- type: "object",
121
- object: obj.type,
122
- index: ProtobufUtil.getSequence(obj.tags[0] ?? [])!,
123
- });
124
- for (const map of prop.value.maps)
125
- union.push({
126
- type: "map",
127
- map,
128
- key: emplaceSchema(map.key) as IProtobufSchema.IMap["key"],
129
- value: emplaceSchema(map.value) as IProtobufSchema.IMap["value"],
130
- index: ProtobufUtil.getSequence(map.tags[0] ?? [])!,
131
- });
132
- prop.of_protobuf_ = {
133
- union,
134
- fixed: union.every((p) => p.index !== null),
135
- };
136
- };
137
-
138
- const emplaceSchema = (metadata: Metadata): IProtobufSchema => {
139
- for (const native of metadata.natives)
140
- if (native.name === "Uint8Array")
141
- return {
142
- type: "bytes",
143
- };
144
- const atomic = emplaceAtomic(metadata);
145
- if (atomic.size) return atomic.values().next().value!;
146
- for (const array of metadata.arrays)
147
- return {
148
- type: "array",
149
- array: array.type,
150
- value: emplaceSchema(
151
- array.type.value,
152
- ) as IProtobufSchema.IArray["value"],
153
- };
154
- for (const obj of metadata.objects)
155
- if (isDynamicObject(obj.type))
156
- return {
157
- type: "map",
158
- map: obj.type,
159
- key: emplaceSchema(
160
- obj.type.properties[0]!.key,
161
- ) as IProtobufSchema.IMap["key"],
162
- value: emplaceSchema(
163
- obj.type.properties[0]!.value,
164
- ) as IProtobufSchema.IMap["value"],
165
- };
166
- else
167
- return {
168
- type: "object",
169
- object: obj.type,
170
- };
171
- for (const map of metadata.maps)
172
- return {
173
- type: "map",
174
- map,
175
- key: emplaceSchema(map.key) as IProtobufSchema.IMap["key"],
176
- value: emplaceSchema(map.value) as IProtobufSchema.IMap["value"],
177
- };
178
- throw new Error(
179
- "Error on ProtobufFactory.emplaceSchema(): any type detected.",
180
- );
181
- };
182
-
183
- const emplaceAtomic = (
184
- meta: Metadata,
185
- ): Map<ProtobufAtomic, IProtobufPropertyType> => {
186
- const map: Map<ProtobufAtomic, IProtobufPropertyType> = new Map();
187
-
188
- // CONSTANTS
189
- for (const c of meta.constants)
190
- if (c.type === "boolean")
191
- map.set("bool", {
192
- type: "bool",
193
- index: getSequence(c.values[0]?.tags[0] ?? [])!,
194
- });
195
- else if (c.type === "bigint") {
196
- const init: ProtobufAtomic.BigNumeric = getBigintType(
197
- c.values.map((v) => BigInt(v.value)),
198
- );
199
- for (const value of c.values)
200
- emplaceBigint({
201
- map,
202
- tags: value.tags,
203
- init,
204
- });
205
- } else if (c.type === "number") {
206
- const init: ProtobufAtomic.Numeric = getNumberType(
207
- c.values.map((v) => v.value) as number[],
208
- );
209
- for (const value of c.values)
210
- emplaceNumber({
211
- map,
212
- tags: value.tags,
213
- init,
214
- });
215
- } else if (c.type === "string")
216
- map.set("string", {
217
- type: "string",
218
- index: getSequence(c.values[0]?.tags[0] ?? [])!,
219
- });
220
-
221
- // TEMPLATE
222
- if (meta.templates.length)
223
- map.set("string", {
224
- type: "string",
225
- index: getSequence(meta.templates[0]?.tags[0] ?? [])!,
226
- });
227
-
228
- // ATOMICS
229
- for (const atomic of meta.atomics)
230
- if (atomic.type === "boolean")
231
- map.set("bool", {
232
- type: "bool",
233
- index: getSequence(atomic.tags[0] ?? [])!,
234
- });
235
- else if (atomic.type === "bigint")
236
- emplaceBigint({
237
- map,
238
- tags: atomic.tags,
239
- init: "int64",
240
- });
241
- else if (atomic.type === "number")
242
- emplaceNumber({
243
- map,
244
- tags: atomic.tags,
245
- init: "double",
246
- });
247
- else if (atomic.type === "string")
248
- map.set("string", {
249
- type: "string",
250
- index: getSequence(atomic.tags[0] ?? [])!,
251
- });
252
-
253
- // SORTING FOR VALIDATION REASON
254
- return new Map(
255
- Array.from(map).sort((x, y) => ProtobufUtil.compare(x[0], y[0])),
256
- );
257
- };
258
-
259
- const emplaceBigint = (next: {
260
- map: Map<ProtobufAtomic, IProtobufPropertyType>;
261
- tags: IMetadataTypeTag[][];
262
- init: ProtobufAtomic.BigNumeric;
263
- }): void => {
264
- if (next.tags.length === 0) {
265
- next.map.set(next.init, {
266
- type: "bigint",
267
- name: next.init,
268
- index: null!,
269
- });
270
- return;
271
- }
272
- for (const row of next.tags) {
273
- const value: ProtobufAtomic.BigNumeric =
274
- row.find(
275
- (tag) =>
276
- tag.kind === "type" &&
277
- (tag.value === "int64" || tag.value === "uint64"),
278
- )?.value ?? next.init;
279
- next.map.set(next.init, {
280
- type: "bigint",
281
- name: value,
282
- index: ProtobufUtil.getSequence(row)!,
283
- });
284
- }
285
- };
286
-
287
- const emplaceNumber = (next: {
288
- map: Map<ProtobufAtomic, IProtobufPropertyType>;
289
- tags: IMetadataTypeTag[][];
290
- init: ProtobufAtomic.Numeric;
291
- }): void => {
292
- if (next.tags.length === 0) {
293
- next.map.set(next.init, {
294
- type: "number",
295
- name: next.init,
296
- index: null!,
297
- });
298
- return;
299
- }
300
- for (const row of next.tags) {
301
- const value: ProtobufAtomic.Numeric =
302
- row.find(
303
- (tag) =>
304
- tag.kind === "type" &&
305
- (tag.value === "int32" ||
306
- tag.value === "uint32" ||
307
- tag.value === "int64" ||
308
- tag.value === "uint64" ||
309
- tag.value === "float" ||
310
- tag.value === "double"),
311
- )?.value ?? next.init;
312
- next.map.set(value, {
313
- type: "number",
314
- name: value,
315
- index: ProtobufUtil.getSequence(row)!,
316
- });
317
- }
318
- };
319
-
320
- const getBigintType = (values: bigint[]): ProtobufAtomic.BigNumeric =>
321
- values.some((v) => v < 0) ? "int64" : "uint64";
322
-
323
- const getNumberType = (values: number[]): ProtobufAtomic.Numeric =>
324
- values.every((v) => Math.floor(v) === v)
325
- ? values.every((v) => -2147483648 <= v && v <= 2147483647)
326
- ? "int32"
327
- : "int64"
328
- : "double";
329
-
330
- const getSequence = (tags: IMetadataTypeTag[]): number | null => {
331
- const sequence = tags.find(
332
- (t) =>
333
- t.kind === "sequence" &&
334
- typeof (t.schema as any)?.["x-protobuf-sequence"] === "number",
335
- );
336
- if (sequence === undefined) return null;
337
- const value: number = Number(
338
- (sequence.schema as any)["x-protobuf-sequence"],
339
- );
340
- return Number.isNaN(value) ? null : value;
341
- };
342
-
343
- /* -----------------------------------------------------------
344
- VALIDATORS
345
- ----------------------------------------------------------- */
346
- const validate = () => {
347
- const visited: WeakSet<MetadataObjectType> = new WeakSet();
348
- return (meta: Metadata, explore: MetadataFactory.IExplore): string[] => {
349
- const errors: string[] = [];
350
- const insert = (msg: string) => errors.push(msg);
351
-
352
- if (explore.top === true) {
353
- const onlyObject: boolean =
354
- meta.size() === 1 &&
355
- meta.objects.length === 1 &&
356
- meta.objects[0]!.type.properties.every((p) =>
357
- p.key.isSoleLiteral(),
358
- ) &&
359
- meta.isRequired() === true &&
360
- meta.nullable === false;
361
- if (onlyObject === false)
362
- insert("target type must be a sole and static object type");
363
- }
364
- for (const obj of meta.objects) {
365
- if (visited.has(obj.type)) continue;
366
- visited.add(obj.type);
367
- validateObject({
368
- object: obj.type,
369
- errors,
370
- });
371
- try {
372
- emplaceObject(obj.type);
373
- } catch {}
374
- }
375
-
376
- //----
377
- // NOT SUPPORTED TYPES
378
- //----
379
- const noSupport = (msg: string) => insert(`does not support ${msg}`);
380
-
381
- // PROHIBIT ANY TYPE
382
- if (meta.any) noSupport("any type");
383
- // PROHIBIT FUNCTIONAL TYPE
384
- if (meta.functions.length) noSupport("functional type");
385
- // PROHIBIT TUPLE TYPE
386
- if (meta.tuples.length) noSupport("tuple type");
387
- // PROHIBIT SET TYPE
388
- if (meta.sets.length) noSupport("Set type");
389
- // NATIVE TYPE, BUT NOT Uint8Array
390
- if (meta.natives.length)
391
- for (const native of meta.natives) {
392
- if (native.name === "Uint8Array") continue;
393
-
394
- const instead = BANNED_NATIVE_TYPES.get(native.name);
395
- if (instead === undefined) noSupport(`${native.name} type`);
396
- else noSupport(`${native.name} type. Use ${instead} type instead.`);
397
- }
398
- //----
399
- // ATOMIC CASES
400
- //----
401
- if (meta.atomics.length) {
402
- const numbers = ProtobufUtil.getNumbers(meta);
403
- const bigints = ProtobufUtil.getBigints(meta);
404
-
405
- for (const type of ["int64", "uint64"])
406
- if (numbers.has(type) && bigints.has(type))
407
- insert(
408
- `tags.Type<"${type}"> cannot be used in both number and bigint types. Recommend to remove from number type`,
409
- );
410
- }
411
- //----
412
- // ARRAY CASES
413
- //----
414
- // DO NOT ALLOW MULTI-DIMENSIONAL ARRAY
415
- if (
416
- meta.arrays.length &&
417
- meta.arrays.some((array) => !!array.type.value.arrays.length)
418
- )
419
- noSupport("over two dimensional array type");
420
- // CHILD OF ARRAY TYPE MUST BE REQUIRED
421
- if (
422
- meta.arrays.length &&
423
- meta.arrays.some(
424
- (array) =>
425
- array.type.value.isRequired() === false ||
426
- array.type.value.nullable === true,
427
- )
428
- )
429
- noSupport("optional type in array");
430
- // UNION IN ARRAY
431
- if (
432
- meta.arrays.length &&
433
- meta.arrays.some(
434
- (a) =>
435
- a.type.value.size() > 1 &&
436
- a.type.value.constants.length !== 1 &&
437
- a.type.value.constants[0]?.values.length !== a.type.value.size(),
438
- )
439
- )
440
- noSupport("union type in array");
441
- // DO DYNAMIC OBJECT IN ARRAY
442
- if (
443
- meta.arrays.length &&
444
- meta.arrays.some(
445
- (a) =>
446
- a.type.value.maps.length ||
447
- (a.type.value.objects.length &&
448
- a.type.value.objects.some(
449
- (o) => ProtobufUtil.isStaticObject(o.type) === false,
450
- )),
451
- )
452
- )
453
- noSupport("dynamic object in array");
454
- // UNION WITH ARRAY
455
- if (meta.size() > 1 && meta.arrays.length)
456
- noSupport("union type with array type");
457
- //----
458
- // OBJECT CASES
459
- //----
460
- // EMPTY PROPERTY
461
- if (
462
- meta.objects.length &&
463
- meta.objects.some((obj) => obj.type.properties.length === 0)
464
- )
465
- noSupport("empty object type");
466
- // MULTIPLE DYNAMIC KEY TYPED PROPERTIES
467
- if (
468
- meta.objects.length &&
469
- meta.objects.some(
470
- (obj) =>
471
- obj.type.properties.filter((p) => !p.key.isSoleLiteral()).length >
472
- 1,
473
- )
474
- )
475
- noSupport(
476
- "object type with multiple dynamic key typed properties. Keep only one.",
477
- );
478
- // STATIC AND DYNAMIC PROPERTIES ARE COMPATIBLE
479
- if (
480
- meta.objects.length &&
481
- meta.objects.some(
482
- (obj) =>
483
- obj.type.properties.some((p) => p.key.isSoleLiteral()) &&
484
- obj.type.properties.some((p) => !p.key.isSoleLiteral()),
485
- )
486
- )
487
- noSupport(
488
- "object type with mixed static and dynamic key typed properties. Keep statics or dynamic only.",
489
- );
490
- // DYNAMIC OBJECT, BUT PROPERTY VALUE TYPE IS ARRAY
491
- if (
492
- meta.objects.length &&
493
- isDynamicObject(meta.objects[0]!.type) &&
494
- meta.objects[0]!.type.properties.some((p) => !!p.value.arrays.length)
495
- )
496
- noSupport("dynamic object with array value type");
497
- // UNION WITH DYNAMIC OBJECTTa
498
- if (
499
- meta.size() > 1 &&
500
- meta.objects.length &&
501
- isDynamicObject(meta.objects[0]!.type)
502
- )
503
- noSupport("union type with dynamic object type");
504
- // UNION IN DYNAMIC PROPERTY VALUE
505
- if (
506
- meta.objects.length &&
507
- meta.objects.some(
508
- (obj) =>
509
- isDynamicObject(obj.type) &&
510
- obj.type.properties.some((p) => ProtobufUtil.isUnion(p.value)),
511
- )
512
- )
513
- noSupport("union type in dynamic property");
514
- //----
515
- // MAP CASES
516
- //----
517
- // KEY TYPE IS UNION
518
- if (
519
- meta.maps.length &&
520
- meta.maps.some((m) => ProtobufUtil.isUnion(m.key))
521
- )
522
- noSupport("union key typed map");
523
- // KEY TYPE IS NOT ATOMIC
524
- if (
525
- meta.maps.length &&
526
- meta.maps.some((m) => ProtobufUtil.getAtomics(m.key).size !== 1)
527
- )
528
- noSupport("non-atomic key typed map");
529
- // MAP TYPE, BUT PROPERTY KEY TYPE IS OPTIONAL
530
- if (
531
- meta.maps.length &&
532
- meta.maps.some((m) => m.key.isRequired() === false || m.key.nullable)
533
- )
534
- noSupport("optional key typed map");
535
- // MAP TYPE, BUT VALUE TYPE IS ARRAY
536
- if (meta.maps.length && meta.maps.some((m) => !!m.value.arrays.length))
537
- noSupport("map type with array value type");
538
- // UNION WITH MAP
539
- if (meta.size() > 1 && meta.maps.length)
540
- noSupport("union type with map type");
541
- // UNION IN MAP
542
- if (
543
- meta.maps.length &&
544
- meta.maps.some((m) => ProtobufUtil.isUnion(m.value))
545
- )
546
- noSupport("union type in map value type");
547
- return errors;
548
- };
549
- };
550
-
551
- /* -----------------------------------------------------------
552
- SEQUENE VALIDATOR
553
- ----------------------------------------------------------- */
554
- const validateObject = (next: {
555
- object: MetadataObjectType;
556
- errors: string[];
557
- }): void => {
558
- for (const property of next.object.properties)
559
- validateProperty({
560
- metadata: property.value,
561
- errors: next.errors,
562
- });
563
-
564
- const entire: Map<number, string> = new Map();
565
- const visitProperty = (p: MetadataProperty) => {
566
- const local: Set<number> = new Set();
567
- const tagger = (matrix: IMetadataTypeTag[][]): void => {
568
- matrix.forEach((tags) => {
569
- const value: number | null = ProtobufUtil.getSequence(tags);
570
- if (value !== null) local.add(value);
571
- });
572
- };
573
- for (const c of p.value.constants)
574
- for (const v of c.values) tagger(v.tags);
575
- for (const a of p.value.atomics) tagger(a.tags);
576
- for (const t of p.value.templates) tagger(t.tags);
577
- for (const o of p.value.objects) tagger(o.tags);
578
- for (const a of p.value.arrays) tagger(a.tags);
579
- for (const s of local)
580
- if (entire.has(s))
581
- next.errors.push(
582
- `The Sequence<${s}> tag is duplicated in two properties (${JSON.stringify(entire.get(s))} and ${JSON.stringify(p.key.getSoleLiteral())})`,
583
- );
584
- else entire.set(s, p.key.getSoleLiteral()!);
585
- };
586
- for (const p of next.object.properties) visitProperty(p);
587
- };
588
-
589
- const validateProperty = (next: {
590
- metadata: Metadata;
591
- errors: string[];
592
- }): void => {
593
- let expected: number = 0;
594
- const sequences: Set<number> = new Set();
595
- const add = (value: number): boolean => {
596
- if (sequences.has(value)) return false;
597
- sequences.add(value);
598
- ++expected;
599
- return true;
600
- };
601
-
602
- for (const validator of [
603
- validateBooleanSequence,
604
- validateNumericSequences({
605
- type: "bigint",
606
- default: "int64",
607
- categories: BIGINT_TYPES,
608
- }),
609
- validateNumericSequences({
610
- type: "number",
611
- default: "double",
612
- categories: NUMBER_TYPES,
613
- }),
614
- validateStringSequence,
615
- ])
616
- validator({ metadata: next.metadata, errors: next.errors, add });
617
- for (const array of next.metadata.arrays)
618
- validateInstanceSequence({
619
- type: "array",
620
- tags: array.tags,
621
- errors: next.errors,
622
- add,
623
- });
624
- for (const object of next.metadata.objects)
625
- validateInstanceSequence({
626
- type: "object",
627
- tags: object.tags,
628
- errors: next.errors,
629
- add,
630
- });
631
- for (const map of next.metadata.maps)
632
- validateInstanceSequence({
633
- type: "map",
634
- tags: map.tags,
635
- errors: next.errors,
636
- add,
637
- });
638
- for (const native of next.metadata.natives)
639
- if (native.name === "Uint8Array")
640
- validateInstanceSequence({
641
- type: "Uint8Array",
642
- tags: native.tags,
643
- errors: next.errors,
644
- add,
645
- });
646
- };
647
-
648
- const validateBooleanSequence = (next: {
649
- metadata: Metadata;
650
- errors: string[];
651
- add: (value: number) => boolean;
652
- }): void => {
653
- // PREPARE EMPLACER
654
- const unique: Set<number> = new Set();
655
- let expected: number = 0;
656
- let actual: number = 0;
657
- const emplace = (matrix: IMetadataTypeTag[][]): void => {
658
- for (const tags of matrix)
659
- for (const tag of tags) {
660
- const sequence = ProtobufUtil.getSequence([tag]);
661
- if (sequence !== null) {
662
- unique.add(sequence);
663
- ++actual;
664
- }
665
- ++expected;
666
- }
667
- };
668
-
669
- // GATHER SEQUENCE TAGS
670
- for (const atomic of next.metadata.atomics)
671
- if (atomic.type === "boolean") emplace(atomic.tags);
672
- for (const constant of next.metadata.constants)
673
- if (constant.type === "boolean")
674
- for (const value of constant.values) emplace(value.tags);
675
-
676
- // PREDICATE
677
- if (unique.size && actual !== expected)
678
- next.errors.push(
679
- `The sequence tag must be declared in every union type members`,
680
- );
681
- else if (unique.size > 1)
682
- next.errors.push(
683
- `The sequence tag value must be the same in boolean type (including literal types)`,
684
- );
685
- else if (unique.size === 1) {
686
- const value: number = unique.values().next().value!;
687
- if (next.add(value) === false)
688
- next.errors.push(
689
- `The sequence tag value ${value} in boolean type is duplicated with other types`,
690
- );
691
- }
692
- };
693
-
694
- const validateNumericSequences =
695
- (config: {
696
- type: "number" | "bigint";
697
- default: string;
698
- categories: Set<string>;
699
- }) =>
700
- (next: {
701
- metadata: Metadata;
702
- errors: string[];
703
- add: (value: number) => boolean;
704
- }): void => {
705
- // FIND TYPE CATEGORIES
706
- const categories: Set<string> = new Set();
707
- const getType = (tags: IMetadataTypeTag[]): string => {
708
- const found: IMetadataTypeTag | undefined = tags.find(
709
- (t) => t.kind === "type" && config.categories.has(t.value),
710
- );
711
- return found?.value ?? config.default;
712
- };
713
- const exploreCategory = (matrix: IMetadataTypeTag[][]): void => {
714
- for (const tags of matrix) categories.add(getType(tags));
715
- };
716
- for (const atomic of next.metadata.atomics)
717
- if (atomic.type === config.type) exploreCategory(atomic.tags);
718
- for (const constant of next.metadata.constants)
719
- if (constant.type === config.type)
720
- for (const value of constant.values) exploreCategory(value.tags);
721
-
722
- // ITERATE TYPE CATEGORIES
723
- for (const category of categories) {
724
- const unique: Set<number> = new Set();
725
- let expected: number = 0;
726
- let actual: number = 0;
727
- const emplace = (tags: IMetadataTypeTag[]): void => {
728
- const sequence: number | null = ProtobufUtil.getSequence(tags);
729
- if (sequence !== null) {
730
- unique.add(sequence);
731
- ++actual;
732
- }
733
- ++expected;
734
- };
735
-
736
- for (const atomic of next.metadata.atomics)
737
- if (atomic.type === config.type)
738
- for (const tags of atomic.tags)
739
- if (getType(tags) === category) emplace(tags);
740
- for (const constant of next.metadata.constants)
741
- if (constant.type === config.type)
742
- for (const value of constant.values)
743
- for (const tags of value.tags)
744
- if (getType(tags) === category) emplace(tags);
745
-
746
- if (unique.size && actual !== expected) {
747
- next.errors.push(
748
- `The sequence tag must be declared in every union type members`,
749
- );
750
- } else if (unique.size > 1)
751
- next.errors.push(
752
- `The sequence tag value must be the same in ${config.type} type (including literal types)`,
753
- );
754
- else if (unique.size === 1) {
755
- const value: number = unique.values().next().value!;
756
- if (next.add(value) === false)
757
- next.errors.push(
758
- `The sequence tag value ${value} in ${config.type} type is duplicated with other types`,
759
- );
760
- }
761
- }
762
- };
763
-
764
- const validateStringSequence = (next: {
765
- metadata: Metadata;
766
- errors: string[];
767
- add: (value: number) => boolean;
768
- }): void => {
769
- const unique: Set<number> = new Set();
770
- let expected: number = 0;
771
- let actual: number = 0;
772
- const emplace = (matrix: IMetadataTypeTag[][]): void => {
773
- for (const tags of matrix)
774
- for (const tag of tags) {
775
- const sequence = ProtobufUtil.getSequence([tag]);
776
- if (sequence !== null) {
777
- unique.add(sequence);
778
- ++actual;
779
- }
780
- ++expected;
781
- }
782
- };
783
- for (const atomic of next.metadata.atomics)
784
- if (atomic.type === "string") emplace(atomic.tags);
785
- for (const constant of next.metadata.constants)
786
- if (constant.type === "string")
787
- for (const value of constant.values) emplace(value.tags);
788
- for (const template of next.metadata.templates) emplace(template.tags);
789
-
790
- if (unique.size && actual !== expected)
791
- next.errors.push(
792
- `The sequence tag must be declared in every union type members`,
793
- );
794
- else if (unique.size > 1)
795
- next.errors.push(
796
- `The sequence tag value must be the same in string types including literal and template types`,
797
- );
798
- else if (unique.size === 1) {
799
- const value: number = unique.values().next().value!;
800
- if (next.add(value) === false)
801
- next.errors.push(
802
- `The sequence tag value ${value} in string type is duplicated with other types`,
803
- );
804
- }
805
- };
806
-
807
- const validateInstanceSequence = (next: {
808
- type: "array" | "object" | "map" | "Uint8Array";
809
- tags: IMetadataTypeTag[][];
810
- errors: string[];
811
- add: (value: number) => boolean;
812
- }): void => {
813
- const unique: Set<number> = new Set();
814
- let count: number = 0;
815
- for (const tags of next.tags) {
816
- const value: number | null = ProtobufUtil.getSequence(tags);
817
- if (value === null) continue;
818
- unique.add(value);
819
- ++count;
820
- }
821
- if (unique.size && count !== next.tags.length)
822
- next.errors.push(
823
- `The sequence tag must be declared in every union type members`,
824
- );
825
- else if (unique.size > 1)
826
- next.errors.push(
827
- `The sequence tag value must be the same in ${next.type === "array" ? "an array" : "object"} type.`,
828
- );
829
- else if (unique.size === 1) {
830
- const value: number = unique.values().next().value!;
831
- if (next.add(value) === false)
832
- next.errors.push(
833
- `The sequence tag value ${value} in ${next.type} type is duplicated with other types`,
834
- );
835
- }
836
- };
837
- }
838
-
839
- const isDynamicObject = (obj: MetadataObjectType): boolean =>
840
- obj.properties[0]!.key.isSoleLiteral() === false;
841
-
842
- const BANNED_NATIVE_TYPES: Map<string, string | null> = new Map([
843
- ["Date", "string"],
844
- ["Boolean", "boolean"],
845
- ["BigInt", "bigint"],
846
- ["Number", "number"],
847
- ["String", "string"],
848
- ...[
849
- "Buffer",
850
- "Uint8ClampedArray",
851
- "Uint16Array",
852
- "Uint32Array",
853
- "BigUint64Array",
854
- "Int8Array",
855
- "Int16Array",
856
- "Int32Array",
857
- "BigInt64Array",
858
- "Float32Array",
859
- "Float64Array",
860
- "DataView",
861
- "ArrayBuffer",
862
- "SharedArrayBuffer",
863
- ].map((name) => [name, "Uint8Array"] as const),
864
- ["WeakSet", "Array"],
865
- ["WeakMap", "Map"],
866
- ]);
867
- const NUMBER_TYPES: Set<string> = new Set([
868
- "int32",
869
- "uint32",
870
- "int64",
871
- "uint64",
872
- "float",
873
- "double",
874
- ]);
875
- const BIGINT_TYPES = new Set(["int64", "uint64"]);
1
+ import ts from "typescript";
2
+
3
+ import { IMetadataTypeTag } from "../schemas/metadata/IMetadataTypeTag";
4
+ import { Metadata } from "../schemas/metadata/Metadata";
5
+ import { MetadataObjectType } from "../schemas/metadata/MetadataObjectType";
6
+ import { MetadataProperty } from "../schemas/metadata/MetadataProperty";
7
+ import { IProtobufProperty } from "../schemas/protobuf/IProtobufProperty";
8
+ import { IProtobufPropertyType } from "../schemas/protobuf/IProtobufPropertyType";
9
+ import { IProtobufSchema } from "../schemas/protobuf/IProtobufSchema";
10
+
11
+ import { ProtobufUtil } from "../programmers/helpers/ProtobufUtil";
12
+
13
+ import { TransformerError } from "../transformers/TransformerError";
14
+
15
+ import { ProtobufAtomic } from "../typings/ProtobufAtomic";
16
+ import { ValidationPipe } from "../typings/ValidationPipe";
17
+
18
+ import { MetadataCollection } from "./MetadataCollection";
19
+ import { MetadataFactory } from "./MetadataFactory";
20
+
21
+ export namespace ProtobufFactory {
22
+ export interface IProps {
23
+ method: string;
24
+ checker: ts.TypeChecker;
25
+ transformer?: ts.TransformationContext;
26
+ collection: MetadataCollection;
27
+ type: ts.Type;
28
+ }
29
+
30
+ /* -----------------------------------------------------------
31
+ METADATA COMPOSER
32
+ ----------------------------------------------------------- */
33
+ export const metadata = (props: IProps): Metadata => {
34
+ // COMPOSE METADATA WITH INDIVIDUAL VALIDATIONS
35
+ const result: ValidationPipe<Metadata, MetadataFactory.IError> =
36
+ MetadataFactory.analyze({
37
+ ...props,
38
+ transformer: props.transformer,
39
+ options: {
40
+ escape: false,
41
+ constant: true,
42
+ absorb: true,
43
+ validate: validate(),
44
+ },
45
+ });
46
+ if (result.success === false)
47
+ throw TransformerError.from({
48
+ code: `typia.protobuf.${props.method}`,
49
+ errors: result.errors,
50
+ });
51
+ return result.data;
52
+ };
53
+
54
+ /**
55
+ * @internal
56
+ */
57
+ export const emplaceObject = (object: MetadataObjectType): void => {
58
+ for (const p of object.properties) emplaceProperty(p);
59
+ const properties: IProtobufProperty[] = object.properties
60
+ .map((p) => p.of_protobuf_)
61
+ .filter((p) => p !== undefined);
62
+ const unique: Set<number> = new Set(
63
+ properties
64
+ .filter((p) => p !== undefined)
65
+ .filter((p) => p.fixed === true)
66
+ .map((p) => p.union.map((u) => u.index))
67
+ .flat(),
68
+ );
69
+ let index: number = 1;
70
+ properties.forEach((schema) => {
71
+ if (schema.fixed === true)
72
+ index = Math.max(
73
+ index,
74
+ Math.max(...schema.union.map((u) => u.index)) + 1,
75
+ );
76
+ else {
77
+ for (const u of schema.union) {
78
+ while (unique.has(index) === true) ++index;
79
+ u.index = index;
80
+ unique.add(index);
81
+ }
82
+ ++index;
83
+ }
84
+ });
85
+ };
86
+
87
+ const emplaceProperty = (prop: MetadataProperty): void => {
88
+ const union: IProtobufPropertyType[] = [];
89
+ for (const native of prop.value.natives)
90
+ if (native.name === "Uint8Array")
91
+ union.push({
92
+ type: "bytes",
93
+ index: ProtobufUtil.getSequence(native.tags[0] ?? [])!,
94
+ });
95
+ union.push(...emplaceAtomic(prop.value).values());
96
+ for (const array of prop.value.arrays)
97
+ union.push({
98
+ type: "array",
99
+ array: array.type,
100
+ value: emplaceSchema(
101
+ array.type.value,
102
+ ) as IProtobufSchema.IArray["value"],
103
+ index: ProtobufUtil.getSequence(array.tags[0] ?? [])!,
104
+ });
105
+ for (const obj of prop.value.objects)
106
+ if (isDynamicObject(obj.type))
107
+ union.push({
108
+ type: "map",
109
+ map: obj.type,
110
+ key: emplaceSchema(
111
+ obj.type.properties[0]!.key,
112
+ ) as IProtobufSchema.IMap["key"],
113
+ value: emplaceSchema(
114
+ obj.type.properties[0]!.value,
115
+ ) as IProtobufSchema.IMap["value"],
116
+ index: ProtobufUtil.getSequence(obj.tags[0] ?? [])!,
117
+ });
118
+ else
119
+ union.push({
120
+ type: "object",
121
+ object: obj.type,
122
+ index: ProtobufUtil.getSequence(obj.tags[0] ?? [])!,
123
+ });
124
+ for (const map of prop.value.maps)
125
+ union.push({
126
+ type: "map",
127
+ map,
128
+ key: emplaceSchema(map.key) as IProtobufSchema.IMap["key"],
129
+ value: emplaceSchema(map.value) as IProtobufSchema.IMap["value"],
130
+ index: ProtobufUtil.getSequence(map.tags[0] ?? [])!,
131
+ });
132
+ prop.of_protobuf_ = {
133
+ union,
134
+ fixed: union.every((p) => p.index !== null),
135
+ };
136
+ };
137
+
138
+ const emplaceSchema = (metadata: Metadata): IProtobufSchema => {
139
+ for (const native of metadata.natives)
140
+ if (native.name === "Uint8Array")
141
+ return {
142
+ type: "bytes",
143
+ };
144
+ const atomic = emplaceAtomic(metadata);
145
+ if (atomic.size) return atomic.values().next().value!;
146
+ for (const array of metadata.arrays)
147
+ return {
148
+ type: "array",
149
+ array: array.type,
150
+ value: emplaceSchema(
151
+ array.type.value,
152
+ ) as IProtobufSchema.IArray["value"],
153
+ };
154
+ for (const obj of metadata.objects)
155
+ if (isDynamicObject(obj.type))
156
+ return {
157
+ type: "map",
158
+ map: obj.type,
159
+ key: emplaceSchema(
160
+ obj.type.properties[0]!.key,
161
+ ) as IProtobufSchema.IMap["key"],
162
+ value: emplaceSchema(
163
+ obj.type.properties[0]!.value,
164
+ ) as IProtobufSchema.IMap["value"],
165
+ };
166
+ else
167
+ return {
168
+ type: "object",
169
+ object: obj.type,
170
+ };
171
+ for (const map of metadata.maps)
172
+ return {
173
+ type: "map",
174
+ map,
175
+ key: emplaceSchema(map.key) as IProtobufSchema.IMap["key"],
176
+ value: emplaceSchema(map.value) as IProtobufSchema.IMap["value"],
177
+ };
178
+ throw new Error(
179
+ "Error on ProtobufFactory.emplaceSchema(): any type detected.",
180
+ );
181
+ };
182
+
183
+ const emplaceAtomic = (
184
+ meta: Metadata,
185
+ ): Map<ProtobufAtomic, IProtobufPropertyType> => {
186
+ const map: Map<ProtobufAtomic, IProtobufPropertyType> = new Map();
187
+
188
+ // CONSTANTS
189
+ for (const c of meta.constants)
190
+ if (c.type === "boolean")
191
+ map.set("bool", {
192
+ type: "bool",
193
+ index: getSequence(c.values[0]?.tags[0] ?? [])!,
194
+ });
195
+ else if (c.type === "bigint") {
196
+ const init: ProtobufAtomic.BigNumeric = getBigintType(
197
+ c.values.map((v) => BigInt(v.value)),
198
+ );
199
+ for (const value of c.values)
200
+ emplaceBigint({
201
+ map,
202
+ tags: value.tags,
203
+ init,
204
+ });
205
+ } else if (c.type === "number") {
206
+ const init: ProtobufAtomic.Numeric = getNumberType(
207
+ c.values.map((v) => v.value) as number[],
208
+ );
209
+ for (const value of c.values)
210
+ emplaceNumber({
211
+ map,
212
+ tags: value.tags,
213
+ init,
214
+ });
215
+ } else if (c.type === "string")
216
+ map.set("string", {
217
+ type: "string",
218
+ index: getSequence(c.values[0]?.tags[0] ?? [])!,
219
+ });
220
+
221
+ // TEMPLATE
222
+ if (meta.templates.length)
223
+ map.set("string", {
224
+ type: "string",
225
+ index: getSequence(meta.templates[0]?.tags[0] ?? [])!,
226
+ });
227
+
228
+ // ATOMICS
229
+ for (const atomic of meta.atomics)
230
+ if (atomic.type === "boolean")
231
+ map.set("bool", {
232
+ type: "bool",
233
+ index: getSequence(atomic.tags[0] ?? [])!,
234
+ });
235
+ else if (atomic.type === "bigint")
236
+ emplaceBigint({
237
+ map,
238
+ tags: atomic.tags,
239
+ init: "int64",
240
+ });
241
+ else if (atomic.type === "number")
242
+ emplaceNumber({
243
+ map,
244
+ tags: atomic.tags,
245
+ init: "double",
246
+ });
247
+ else if (atomic.type === "string")
248
+ map.set("string", {
249
+ type: "string",
250
+ index: getSequence(atomic.tags[0] ?? [])!,
251
+ });
252
+
253
+ // SORTING FOR VALIDATION REASON
254
+ return new Map(
255
+ Array.from(map).sort((x, y) => ProtobufUtil.compare(x[0], y[0])),
256
+ );
257
+ };
258
+
259
+ const emplaceBigint = (next: {
260
+ map: Map<ProtobufAtomic, IProtobufPropertyType>;
261
+ tags: IMetadataTypeTag[][];
262
+ init: ProtobufAtomic.BigNumeric;
263
+ }): void => {
264
+ if (next.tags.length === 0) {
265
+ next.map.set(next.init, {
266
+ type: "bigint",
267
+ name: next.init,
268
+ index: null!,
269
+ });
270
+ return;
271
+ }
272
+ for (const row of next.tags) {
273
+ const value: ProtobufAtomic.BigNumeric =
274
+ row.find(
275
+ (tag) =>
276
+ tag.kind === "type" &&
277
+ (tag.value === "int64" || tag.value === "uint64"),
278
+ )?.value ?? next.init;
279
+ next.map.set(next.init, {
280
+ type: "bigint",
281
+ name: value,
282
+ index: ProtobufUtil.getSequence(row)!,
283
+ });
284
+ }
285
+ };
286
+
287
+ const emplaceNumber = (next: {
288
+ map: Map<ProtobufAtomic, IProtobufPropertyType>;
289
+ tags: IMetadataTypeTag[][];
290
+ init: ProtobufAtomic.Numeric;
291
+ }): void => {
292
+ if (next.tags.length === 0) {
293
+ next.map.set(next.init, {
294
+ type: "number",
295
+ name: next.init,
296
+ index: null!,
297
+ });
298
+ return;
299
+ }
300
+ for (const row of next.tags) {
301
+ const value: ProtobufAtomic.Numeric =
302
+ row.find(
303
+ (tag) =>
304
+ tag.kind === "type" &&
305
+ (tag.value === "int32" ||
306
+ tag.value === "uint32" ||
307
+ tag.value === "int64" ||
308
+ tag.value === "uint64" ||
309
+ tag.value === "float" ||
310
+ tag.value === "double"),
311
+ )?.value ?? next.init;
312
+ next.map.set(value, {
313
+ type: "number",
314
+ name: value,
315
+ index: ProtobufUtil.getSequence(row)!,
316
+ });
317
+ }
318
+ };
319
+
320
+ const getBigintType = (values: bigint[]): ProtobufAtomic.BigNumeric =>
321
+ values.some((v) => v < 0) ? "int64" : "uint64";
322
+
323
+ const getNumberType = (values: number[]): ProtobufAtomic.Numeric =>
324
+ values.every((v) => Math.floor(v) === v)
325
+ ? values.every((v) => -2147483648 <= v && v <= 2147483647)
326
+ ? "int32"
327
+ : "int64"
328
+ : "double";
329
+
330
+ const getSequence = (tags: IMetadataTypeTag[]): number | null => {
331
+ const sequence = tags.find(
332
+ (t) =>
333
+ t.kind === "sequence" &&
334
+ typeof (t.schema as any)?.["x-protobuf-sequence"] === "number",
335
+ );
336
+ if (sequence === undefined) return null;
337
+ const value: number = Number(
338
+ (sequence.schema as any)["x-protobuf-sequence"],
339
+ );
340
+ return Number.isNaN(value) ? null : value;
341
+ };
342
+
343
+ /* -----------------------------------------------------------
344
+ VALIDATORS
345
+ ----------------------------------------------------------- */
346
+ const validate = () => {
347
+ const visited: WeakSet<MetadataObjectType> = new WeakSet();
348
+ return (meta: Metadata, explore: MetadataFactory.IExplore): string[] => {
349
+ const errors: string[] = [];
350
+ const insert = (msg: string) => errors.push(msg);
351
+
352
+ if (explore.top === true) {
353
+ const onlyObject: boolean =
354
+ meta.size() === 1 &&
355
+ meta.objects.length === 1 &&
356
+ meta.objects[0]!.type.properties.every((p) =>
357
+ p.key.isSoleLiteral(),
358
+ ) &&
359
+ meta.isRequired() === true &&
360
+ meta.nullable === false;
361
+ if (onlyObject === false)
362
+ insert("target type must be a sole and static object type");
363
+ }
364
+ for (const obj of meta.objects) {
365
+ if (visited.has(obj.type)) continue;
366
+ visited.add(obj.type);
367
+ validateObject({
368
+ object: obj.type,
369
+ errors,
370
+ });
371
+ try {
372
+ emplaceObject(obj.type);
373
+ } catch {}
374
+ }
375
+
376
+ //----
377
+ // NOT SUPPORTED TYPES
378
+ //----
379
+ const noSupport = (msg: string) => insert(`does not support ${msg}`);
380
+
381
+ // PROHIBIT ANY TYPE
382
+ if (meta.any) noSupport("any type");
383
+ // PROHIBIT FUNCTIONAL TYPE
384
+ if (meta.functions.length) noSupport("functional type");
385
+ // PROHIBIT TUPLE TYPE
386
+ if (meta.tuples.length) noSupport("tuple type");
387
+ // PROHIBIT SET TYPE
388
+ if (meta.sets.length) noSupport("Set type");
389
+ // NATIVE TYPE, BUT NOT Uint8Array
390
+ if (meta.natives.length)
391
+ for (const native of meta.natives) {
392
+ if (native.name === "Uint8Array") continue;
393
+
394
+ const instead = BANNED_NATIVE_TYPES.get(native.name);
395
+ if (instead === undefined) noSupport(`${native.name} type`);
396
+ else noSupport(`${native.name} type. Use ${instead} type instead.`);
397
+ }
398
+ //----
399
+ // ATOMIC CASES
400
+ //----
401
+ if (meta.atomics.length) {
402
+ const numbers = ProtobufUtil.getNumbers(meta);
403
+ const bigints = ProtobufUtil.getBigints(meta);
404
+
405
+ for (const type of ["int64", "uint64"])
406
+ if (numbers.has(type) && bigints.has(type))
407
+ insert(
408
+ `tags.Type<"${type}"> cannot be used in both number and bigint types. Recommend to remove from number type`,
409
+ );
410
+ }
411
+ //----
412
+ // ARRAY CASES
413
+ //----
414
+ // DO NOT ALLOW MULTI-DIMENSIONAL ARRAY
415
+ if (
416
+ meta.arrays.length &&
417
+ meta.arrays.some((array) => !!array.type.value.arrays.length)
418
+ )
419
+ noSupport("over two dimensional array type");
420
+ // CHILD OF ARRAY TYPE MUST BE REQUIRED
421
+ if (
422
+ meta.arrays.length &&
423
+ meta.arrays.some(
424
+ (array) =>
425
+ array.type.value.isRequired() === false ||
426
+ array.type.value.nullable === true,
427
+ )
428
+ )
429
+ noSupport("optional type in array");
430
+ // UNION IN ARRAY
431
+ if (
432
+ meta.arrays.length &&
433
+ meta.arrays.some(
434
+ (a) =>
435
+ a.type.value.size() > 1 &&
436
+ a.type.value.constants.length !== 1 &&
437
+ a.type.value.constants[0]?.values.length !== a.type.value.size(),
438
+ )
439
+ )
440
+ noSupport("union type in array");
441
+ // DO DYNAMIC OBJECT IN ARRAY
442
+ if (
443
+ meta.arrays.length &&
444
+ meta.arrays.some(
445
+ (a) =>
446
+ a.type.value.maps.length ||
447
+ (a.type.value.objects.length &&
448
+ a.type.value.objects.some(
449
+ (o) => ProtobufUtil.isStaticObject(o.type) === false,
450
+ )),
451
+ )
452
+ )
453
+ noSupport("dynamic object in array");
454
+ // UNION WITH ARRAY
455
+ if (meta.size() > 1 && meta.arrays.length)
456
+ noSupport("union type with array type");
457
+ //----
458
+ // OBJECT CASES
459
+ //----
460
+ // EMPTY PROPERTY
461
+ if (
462
+ meta.objects.length &&
463
+ meta.objects.some((obj) => obj.type.properties.length === 0)
464
+ )
465
+ noSupport("empty object type");
466
+ // MULTIPLE DYNAMIC KEY TYPED PROPERTIES
467
+ if (
468
+ meta.objects.length &&
469
+ meta.objects.some(
470
+ (obj) =>
471
+ obj.type.properties.filter((p) => !p.key.isSoleLiteral()).length >
472
+ 1,
473
+ )
474
+ )
475
+ noSupport(
476
+ "object type with multiple dynamic key typed properties. Keep only one.",
477
+ );
478
+ // STATIC AND DYNAMIC PROPERTIES ARE COMPATIBLE
479
+ if (
480
+ meta.objects.length &&
481
+ meta.objects.some(
482
+ (obj) =>
483
+ obj.type.properties.some((p) => p.key.isSoleLiteral()) &&
484
+ obj.type.properties.some((p) => !p.key.isSoleLiteral()),
485
+ )
486
+ )
487
+ noSupport(
488
+ "object type with mixed static and dynamic key typed properties. Keep statics or dynamic only.",
489
+ );
490
+ // DYNAMIC OBJECT, BUT PROPERTY VALUE TYPE IS ARRAY
491
+ if (
492
+ meta.objects.length &&
493
+ isDynamicObject(meta.objects[0]!.type) &&
494
+ meta.objects[0]!.type.properties.some((p) => !!p.value.arrays.length)
495
+ )
496
+ noSupport("dynamic object with array value type");
497
+ // UNION WITH DYNAMIC OBJECTTa
498
+ if (
499
+ meta.size() > 1 &&
500
+ meta.objects.length &&
501
+ isDynamicObject(meta.objects[0]!.type)
502
+ )
503
+ noSupport("union type with dynamic object type");
504
+ // UNION IN DYNAMIC PROPERTY VALUE
505
+ if (
506
+ meta.objects.length &&
507
+ meta.objects.some(
508
+ (obj) =>
509
+ isDynamicObject(obj.type) &&
510
+ obj.type.properties.some((p) => ProtobufUtil.isUnion(p.value)),
511
+ )
512
+ )
513
+ noSupport("union type in dynamic property");
514
+ //----
515
+ // MAP CASES
516
+ //----
517
+ // KEY TYPE IS UNION
518
+ if (
519
+ meta.maps.length &&
520
+ meta.maps.some((m) => ProtobufUtil.isUnion(m.key))
521
+ )
522
+ noSupport("union key typed map");
523
+ // KEY TYPE IS NOT ATOMIC
524
+ if (
525
+ meta.maps.length &&
526
+ meta.maps.some((m) => ProtobufUtil.getAtomics(m.key).size !== 1)
527
+ )
528
+ noSupport("non-atomic key typed map");
529
+ // MAP TYPE, BUT PROPERTY KEY TYPE IS OPTIONAL
530
+ if (
531
+ meta.maps.length &&
532
+ meta.maps.some((m) => m.key.isRequired() === false || m.key.nullable)
533
+ )
534
+ noSupport("optional key typed map");
535
+ // MAP TYPE, BUT VALUE TYPE IS ARRAY
536
+ if (meta.maps.length && meta.maps.some((m) => !!m.value.arrays.length))
537
+ noSupport("map type with array value type");
538
+ // UNION WITH MAP
539
+ if (meta.size() > 1 && meta.maps.length)
540
+ noSupport("union type with map type");
541
+ // UNION IN MAP
542
+ if (
543
+ meta.maps.length &&
544
+ meta.maps.some((m) => ProtobufUtil.isUnion(m.value))
545
+ )
546
+ noSupport("union type in map value type");
547
+ return errors;
548
+ };
549
+ };
550
+
551
+ /* -----------------------------------------------------------
552
+ SEQUENE VALIDATOR
553
+ ----------------------------------------------------------- */
554
+ const validateObject = (next: {
555
+ object: MetadataObjectType;
556
+ errors: string[];
557
+ }): void => {
558
+ for (const property of next.object.properties)
559
+ validateProperty({
560
+ metadata: property.value,
561
+ errors: next.errors,
562
+ });
563
+
564
+ const entire: Map<number, string> = new Map();
565
+ const visitProperty = (p: MetadataProperty) => {
566
+ const local: Set<number> = new Set();
567
+ const tagger = (matrix: IMetadataTypeTag[][]): void => {
568
+ matrix.forEach((tags) => {
569
+ const value: number | null = ProtobufUtil.getSequence(tags);
570
+ if (value !== null) local.add(value);
571
+ });
572
+ };
573
+ for (const c of p.value.constants)
574
+ for (const v of c.values) tagger(v.tags);
575
+ for (const a of p.value.atomics) tagger(a.tags);
576
+ for (const t of p.value.templates) tagger(t.tags);
577
+ for (const o of p.value.objects) tagger(o.tags);
578
+ for (const a of p.value.arrays) tagger(a.tags);
579
+ for (const s of local)
580
+ if (entire.has(s))
581
+ next.errors.push(
582
+ `The Sequence<${s}> tag is duplicated in two properties (${JSON.stringify(entire.get(s))} and ${JSON.stringify(p.key.getSoleLiteral())})`,
583
+ );
584
+ else entire.set(s, p.key.getSoleLiteral()!);
585
+ };
586
+ for (const p of next.object.properties) visitProperty(p);
587
+ };
588
+
589
+ const validateProperty = (next: {
590
+ metadata: Metadata;
591
+ errors: string[];
592
+ }): void => {
593
+ let expected: number = 0;
594
+ const sequences: Set<number> = new Set();
595
+ const add = (value: number): boolean => {
596
+ if (sequences.has(value)) return false;
597
+ sequences.add(value);
598
+ ++expected;
599
+ return true;
600
+ };
601
+
602
+ for (const validator of [
603
+ validateBooleanSequence,
604
+ validateNumericSequences({
605
+ type: "bigint",
606
+ default: "int64",
607
+ categories: BIGINT_TYPES,
608
+ }),
609
+ validateNumericSequences({
610
+ type: "number",
611
+ default: "double",
612
+ categories: NUMBER_TYPES,
613
+ }),
614
+ validateStringSequence,
615
+ ])
616
+ validator({ metadata: next.metadata, errors: next.errors, add });
617
+ for (const array of next.metadata.arrays)
618
+ validateInstanceSequence({
619
+ type: "array",
620
+ tags: array.tags,
621
+ errors: next.errors,
622
+ add,
623
+ });
624
+ for (const object of next.metadata.objects)
625
+ validateInstanceSequence({
626
+ type: "object",
627
+ tags: object.tags,
628
+ errors: next.errors,
629
+ add,
630
+ });
631
+ for (const map of next.metadata.maps)
632
+ validateInstanceSequence({
633
+ type: "map",
634
+ tags: map.tags,
635
+ errors: next.errors,
636
+ add,
637
+ });
638
+ for (const native of next.metadata.natives)
639
+ if (native.name === "Uint8Array")
640
+ validateInstanceSequence({
641
+ type: "Uint8Array",
642
+ tags: native.tags,
643
+ errors: next.errors,
644
+ add,
645
+ });
646
+ };
647
+
648
+ const validateBooleanSequence = (next: {
649
+ metadata: Metadata;
650
+ errors: string[];
651
+ add: (value: number) => boolean;
652
+ }): void => {
653
+ // PREPARE EMPLACER
654
+ const unique: Set<number> = new Set();
655
+ let expected: number = 0;
656
+ let actual: number = 0;
657
+ const emplace = (matrix: IMetadataTypeTag[][]): void => {
658
+ for (const tags of matrix)
659
+ for (const tag of tags) {
660
+ const sequence = ProtobufUtil.getSequence([tag]);
661
+ if (sequence !== null) {
662
+ unique.add(sequence);
663
+ ++actual;
664
+ }
665
+ ++expected;
666
+ }
667
+ };
668
+
669
+ // GATHER SEQUENCE TAGS
670
+ for (const atomic of next.metadata.atomics)
671
+ if (atomic.type === "boolean") emplace(atomic.tags);
672
+ for (const constant of next.metadata.constants)
673
+ if (constant.type === "boolean")
674
+ for (const value of constant.values) emplace(value.tags);
675
+
676
+ // PREDICATE
677
+ if (unique.size && actual !== expected)
678
+ next.errors.push(
679
+ `The sequence tag must be declared in every union type members`,
680
+ );
681
+ else if (unique.size > 1)
682
+ next.errors.push(
683
+ `The sequence tag value must be the same in boolean type (including literal types)`,
684
+ );
685
+ else if (unique.size === 1) {
686
+ const value: number = unique.values().next().value!;
687
+ if (next.add(value) === false)
688
+ next.errors.push(
689
+ `The sequence tag value ${value} in boolean type is duplicated with other types`,
690
+ );
691
+ }
692
+ };
693
+
694
+ const validateNumericSequences =
695
+ (config: {
696
+ type: "number" | "bigint";
697
+ default: string;
698
+ categories: Set<string>;
699
+ }) =>
700
+ (next: {
701
+ metadata: Metadata;
702
+ errors: string[];
703
+ add: (value: number) => boolean;
704
+ }): void => {
705
+ // FIND TYPE CATEGORIES
706
+ const categories: Set<string> = new Set();
707
+ const getType = (tags: IMetadataTypeTag[]): string => {
708
+ const found: IMetadataTypeTag | undefined = tags.find(
709
+ (t) => t.kind === "type" && config.categories.has(t.value),
710
+ );
711
+ return found?.value ?? config.default;
712
+ };
713
+ const exploreCategory = (matrix: IMetadataTypeTag[][]): void => {
714
+ for (const tags of matrix) categories.add(getType(tags));
715
+ };
716
+ for (const atomic of next.metadata.atomics)
717
+ if (atomic.type === config.type) exploreCategory(atomic.tags);
718
+ for (const constant of next.metadata.constants)
719
+ if (constant.type === config.type)
720
+ for (const value of constant.values) exploreCategory(value.tags);
721
+
722
+ // ITERATE TYPE CATEGORIES
723
+ for (const category of categories) {
724
+ const unique: Set<number> = new Set();
725
+ let expected: number = 0;
726
+ let actual: number = 0;
727
+ const emplace = (tags: IMetadataTypeTag[]): void => {
728
+ const sequence: number | null = ProtobufUtil.getSequence(tags);
729
+ if (sequence !== null) {
730
+ unique.add(sequence);
731
+ ++actual;
732
+ }
733
+ ++expected;
734
+ };
735
+
736
+ for (const atomic of next.metadata.atomics)
737
+ if (atomic.type === config.type)
738
+ for (const tags of atomic.tags)
739
+ if (getType(tags) === category) emplace(tags);
740
+ for (const constant of next.metadata.constants)
741
+ if (constant.type === config.type)
742
+ for (const value of constant.values)
743
+ for (const tags of value.tags)
744
+ if (getType(tags) === category) emplace(tags);
745
+
746
+ if (unique.size && actual !== expected) {
747
+ next.errors.push(
748
+ `The sequence tag must be declared in every union type members`,
749
+ );
750
+ } else if (unique.size > 1)
751
+ next.errors.push(
752
+ `The sequence tag value must be the same in ${config.type} type (including literal types)`,
753
+ );
754
+ else if (unique.size === 1) {
755
+ const value: number = unique.values().next().value!;
756
+ if (next.add(value) === false)
757
+ next.errors.push(
758
+ `The sequence tag value ${value} in ${config.type} type is duplicated with other types`,
759
+ );
760
+ }
761
+ }
762
+ };
763
+
764
+ const validateStringSequence = (next: {
765
+ metadata: Metadata;
766
+ errors: string[];
767
+ add: (value: number) => boolean;
768
+ }): void => {
769
+ const unique: Set<number> = new Set();
770
+ let expected: number = 0;
771
+ let actual: number = 0;
772
+ const emplace = (matrix: IMetadataTypeTag[][]): void => {
773
+ for (const tags of matrix)
774
+ for (const tag of tags) {
775
+ const sequence = ProtobufUtil.getSequence([tag]);
776
+ if (sequence !== null) {
777
+ unique.add(sequence);
778
+ ++actual;
779
+ }
780
+ ++expected;
781
+ }
782
+ };
783
+ for (const atomic of next.metadata.atomics)
784
+ if (atomic.type === "string") emplace(atomic.tags);
785
+ for (const constant of next.metadata.constants)
786
+ if (constant.type === "string")
787
+ for (const value of constant.values) emplace(value.tags);
788
+ for (const template of next.metadata.templates) emplace(template.tags);
789
+
790
+ if (unique.size && actual !== expected)
791
+ next.errors.push(
792
+ `The sequence tag must be declared in every union type members`,
793
+ );
794
+ else if (unique.size > 1)
795
+ next.errors.push(
796
+ `The sequence tag value must be the same in string types including literal and template types`,
797
+ );
798
+ else if (unique.size === 1) {
799
+ const value: number = unique.values().next().value!;
800
+ if (next.add(value) === false)
801
+ next.errors.push(
802
+ `The sequence tag value ${value} in string type is duplicated with other types`,
803
+ );
804
+ }
805
+ };
806
+
807
+ const validateInstanceSequence = (next: {
808
+ type: "array" | "object" | "map" | "Uint8Array";
809
+ tags: IMetadataTypeTag[][];
810
+ errors: string[];
811
+ add: (value: number) => boolean;
812
+ }): void => {
813
+ const unique: Set<number> = new Set();
814
+ let count: number = 0;
815
+ for (const tags of next.tags) {
816
+ const value: number | null = ProtobufUtil.getSequence(tags);
817
+ if (value === null) continue;
818
+ unique.add(value);
819
+ ++count;
820
+ }
821
+ if (unique.size && count !== next.tags.length)
822
+ next.errors.push(
823
+ `The sequence tag must be declared in every union type members`,
824
+ );
825
+ else if (unique.size > 1)
826
+ next.errors.push(
827
+ `The sequence tag value must be the same in ${next.type === "array" ? "an array" : "object"} type.`,
828
+ );
829
+ else if (unique.size === 1) {
830
+ const value: number = unique.values().next().value!;
831
+ if (next.add(value) === false)
832
+ next.errors.push(
833
+ `The sequence tag value ${value} in ${next.type} type is duplicated with other types`,
834
+ );
835
+ }
836
+ };
837
+ }
838
+
839
+ const isDynamicObject = (obj: MetadataObjectType): boolean =>
840
+ obj.properties[0]!.key.isSoleLiteral() === false;
841
+
842
+ const BANNED_NATIVE_TYPES: Map<string, string | null> = new Map([
843
+ ["Date", "string"],
844
+ ["Boolean", "boolean"],
845
+ ["BigInt", "bigint"],
846
+ ["Number", "number"],
847
+ ["String", "string"],
848
+ ...[
849
+ "Buffer",
850
+ "Uint8ClampedArray",
851
+ "Uint16Array",
852
+ "Uint32Array",
853
+ "BigUint64Array",
854
+ "Int8Array",
855
+ "Int16Array",
856
+ "Int32Array",
857
+ "BigInt64Array",
858
+ "Float32Array",
859
+ "Float64Array",
860
+ "DataView",
861
+ "ArrayBuffer",
862
+ "SharedArrayBuffer",
863
+ ].map((name) => [name, "Uint8Array"] as const),
864
+ ["WeakSet", "Array"],
865
+ ["WeakMap", "Map"],
866
+ ]);
867
+ const NUMBER_TYPES: Set<string> = new Set([
868
+ "int32",
869
+ "uint32",
870
+ "int64",
871
+ "uint64",
872
+ "float",
873
+ "double",
874
+ ]);
875
+ const BIGINT_TYPES = new Set(["int64", "uint64"]);