@opra/common 0.33.13 → 1.0.0-alpha.1

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 (582) hide show
  1. package/browser.js +4657 -3899
  2. package/cjs/document/api-document.js +112 -23
  3. package/cjs/document/common/api-base.js +27 -0
  4. package/cjs/document/common/data-type-map.js +66 -0
  5. package/cjs/document/common/document-element.js +31 -0
  6. package/cjs/document/common/document-init-context.js +69 -0
  7. package/cjs/document/common/document-node.js +124 -0
  8. package/cjs/document/common/opra-document-error.js +15 -0
  9. package/cjs/document/common/value.js +33 -0
  10. package/cjs/document/constants.js +13 -7
  11. package/cjs/document/data-type/api-field.js +64 -0
  12. package/cjs/document/data-type/complex-type-base.js +183 -0
  13. package/cjs/document/data-type/complex-type.js +89 -13
  14. package/cjs/document/data-type/data-type.js +32 -25
  15. package/cjs/document/data-type/decorators/api-field-decorator.js +26 -0
  16. package/cjs/document/data-type/decorators/complex-type.decorator.js +33 -0
  17. package/cjs/document/data-type/decorators/simple-type.decorator.js +67 -0
  18. package/cjs/document/data-type/enum-type.js +92 -36
  19. package/cjs/document/data-type/{builtin → extended-types}/base64.type.js +11 -2
  20. package/cjs/document/data-type/extended-types/date-string.type.js +44 -0
  21. package/cjs/document/data-type/extended-types/date-time-string.type.js +47 -0
  22. package/cjs/document/data-type/extended-types/date-time.type.js +58 -0
  23. package/cjs/document/data-type/extended-types/date.type.js +55 -0
  24. package/cjs/document/data-type/extended-types/email.type.js +80 -0
  25. package/cjs/document/data-type/extended-types/field-path.type.js +53 -0
  26. package/cjs/document/data-type/extended-types/filter.type.js +74 -0
  27. package/cjs/document/data-type/extended-types/index.js +16 -0
  28. package/cjs/document/data-type/{builtin → extended-types}/object-id.type.js +11 -2
  29. package/cjs/document/data-type/extended-types/operation-result.type.js +56 -0
  30. package/cjs/document/data-type/extended-types/time.type.js +47 -0
  31. package/cjs/document/data-type/{builtin → extended-types}/url.type.js +12 -3
  32. package/cjs/document/data-type/extended-types/uuid.type.js +30 -0
  33. package/cjs/document/data-type/mapped-type.js +77 -61
  34. package/cjs/document/data-type/mixin-type.js +78 -23
  35. package/cjs/document/data-type/omit-type.js +11 -0
  36. package/cjs/document/data-type/partial-type.js +13 -0
  37. package/cjs/document/data-type/pick-type.js +11 -0
  38. package/cjs/document/data-type/primitive-types/any.type.js +25 -0
  39. package/cjs/document/data-type/primitive-types/bigint.type.js +30 -0
  40. package/cjs/document/data-type/{builtin → primitive-types}/boolean.type.js +11 -2
  41. package/cjs/document/data-type/primitive-types/index.js +11 -0
  42. package/cjs/document/data-type/primitive-types/integer.type.js +30 -0
  43. package/cjs/document/data-type/{builtin → primitive-types}/null.type.js +11 -2
  44. package/cjs/document/data-type/primitive-types/number.type.js +40 -0
  45. package/cjs/document/data-type/{builtin → primitive-types}/object.type.js +7 -1
  46. package/cjs/document/data-type/primitive-types/string.type.js +58 -0
  47. package/cjs/document/data-type/required-type.js +13 -0
  48. package/cjs/document/data-type/simple-type.js +93 -14
  49. package/cjs/document/data-type/utils/create-mapped-class.js +54 -0
  50. package/cjs/document/data-type/utils/get-is-inherited-predicate-fn.js +15 -0
  51. package/cjs/document/{data-type/field-decorator.js → decorators/api-field-decorator.js} +7 -7
  52. package/cjs/document/{data-type → decorators}/complex-type.decorator.js +11 -1
  53. package/cjs/document/decorators/http-controller.decorator.js +117 -0
  54. package/cjs/document/decorators/http-operation-entity.decorator.js +462 -0
  55. package/cjs/document/decorators/http-operation.decorator.js +183 -0
  56. package/cjs/document/decorators/simple-type.decorator.js +67 -0
  57. package/cjs/document/factory/api-document.factory.js +178 -0
  58. package/cjs/document/factory/data-type.factory.js +498 -0
  59. package/cjs/document/factory/http-api.factory.js +315 -0
  60. package/cjs/document/http/decorators/http-controller.decorator.js +117 -0
  61. package/cjs/document/http/decorators/http-operation-entity.decorator.js +461 -0
  62. package/cjs/document/http/decorators/http-operation.decorator.js +183 -0
  63. package/cjs/document/http/http-api.js +40 -0
  64. package/cjs/document/http/http-controller.js +145 -0
  65. package/cjs/document/http/http-media-type.js +68 -0
  66. package/cjs/document/http/http-multipart-field.js +33 -0
  67. package/cjs/document/http/http-operation-response.js +42 -0
  68. package/cjs/document/http/http-operation.js +93 -0
  69. package/cjs/document/http/http-parameter.js +44 -0
  70. package/cjs/document/http/http-request-body.js +25 -0
  71. package/cjs/document/http/http-status-range.js +41 -0
  72. package/cjs/document/index.js +35 -22
  73. package/cjs/document/utils/inspect.util.js +3 -3
  74. package/cjs/document/utils/parse-regexp.util.js +22 -0
  75. package/cjs/exception/http-errors/bad-request.error.js +3 -3
  76. package/cjs/exception/http-errors/conflict.error.js +3 -3
  77. package/cjs/exception/http-errors/failed-dependency.error.js +3 -3
  78. package/cjs/exception/http-errors/forbidden.error.js +3 -3
  79. package/cjs/exception/http-errors/internal-server.error.js +3 -3
  80. package/cjs/exception/http-errors/method-not-allowed.error.js +3 -3
  81. package/cjs/exception/http-errors/not-acceptable.error.js +3 -3
  82. package/cjs/exception/http-errors/not-found.error.js +3 -3
  83. package/cjs/exception/{resource-errors → http-errors}/permission.error.js +2 -2
  84. package/cjs/exception/{resource-errors → http-errors}/resource-conflict.error.js +3 -3
  85. package/cjs/exception/{resource-errors → http-errors}/resource-not.available.error.js +5 -5
  86. package/cjs/exception/http-errors/unauthorized.error.js +3 -3
  87. package/cjs/exception/http-errors/unprocessable-entity.error.js +3 -3
  88. package/cjs/exception/index.js +4 -4
  89. package/cjs/exception/issue-severity.enum.js +1 -1
  90. package/cjs/exception/opra-exception.js +5 -16
  91. package/cjs/exception/opra-http-error.js +25 -0
  92. package/cjs/filter/antlr/OpraFilterLexer.js +259 -193
  93. package/cjs/filter/antlr/OpraFilterParser.js +137 -84
  94. package/cjs/filter/ast/expressions/arithmetic-expression.js +1 -1
  95. package/cjs/filter/ast/expressions/logical-expression.js +1 -3
  96. package/cjs/filter/ast/terms/number-literal.js +1 -3
  97. package/cjs/filter/ast/terms/time-literal.js +6 -4
  98. package/cjs/filter/build.js +1 -3
  99. package/cjs/filter/filter-rules.js +93 -0
  100. package/cjs/filter/filter-tree-visitor.js +4 -7
  101. package/cjs/filter/parse.js +2 -2
  102. package/cjs/filter/utils.js +1 -3
  103. package/cjs/helpers/function-utils.js +2 -11
  104. package/cjs/helpers/get-stack-filename.js +28 -4
  105. package/cjs/helpers/index.js +2 -2
  106. package/cjs/helpers/is-url-string.js +1 -2
  107. package/cjs/helpers/mixin-utils.js +5 -8
  108. package/cjs/helpers/monkey-patches.js +12 -0
  109. package/cjs/helpers/object-utils.js +4 -5
  110. package/cjs/helpers/parse-fields-projection.js +67 -0
  111. package/cjs/helpers/responsive-map.js +93 -117
  112. package/cjs/helpers/type-guards.js +22 -29
  113. package/cjs/http/enums/http-status-messages.js +63 -63
  114. package/cjs/http/enums/mime-types.enum.js +17 -0
  115. package/cjs/http/index.js +1 -2
  116. package/cjs/http/opra-url-path.js +14 -9
  117. package/cjs/http/opra-url.js +18 -15
  118. package/cjs/i18n/i18n.js +9 -5
  119. package/cjs/i18n/translate.js +2 -2
  120. package/cjs/index.js +1 -1
  121. package/cjs/schema/http/http-controller.interface.js +11 -0
  122. package/cjs/schema/http/http-operation.interface.js +7 -0
  123. package/cjs/schema/index.js +27 -2
  124. package/cjs/schema/type-guards.js +8 -30
  125. package/cjs/schema/value.interface.js +2 -0
  126. package/esm/document/api-document.js +112 -23
  127. package/esm/document/common/api-base.js +23 -0
  128. package/esm/document/common/data-type-map.js +62 -0
  129. package/esm/document/common/document-element.js +28 -0
  130. package/esm/document/common/document-init-context.js +65 -0
  131. package/esm/document/common/document-node.js +120 -0
  132. package/esm/document/common/opra-document-error.js +11 -0
  133. package/esm/document/common/value.js +30 -0
  134. package/esm/document/constants.js +12 -6
  135. package/esm/document/data-type/api-field.js +61 -0
  136. package/esm/document/data-type/complex-type-base.js +180 -0
  137. package/esm/document/data-type/complex-type.js +88 -11
  138. package/esm/document/data-type/data-type.js +32 -24
  139. package/esm/document/data-type/decorators/api-field-decorator.js +22 -0
  140. package/esm/document/data-type/decorators/complex-type.decorator.js +28 -0
  141. package/esm/document/data-type/decorators/simple-type.decorator.js +61 -0
  142. package/esm/document/data-type/enum-type.js +93 -36
  143. package/esm/document/data-type/extended-types/base64.type.js +22 -0
  144. package/esm/document/data-type/extended-types/date-string.type.js +41 -0
  145. package/esm/document/data-type/extended-types/date-time-string.type.js +44 -0
  146. package/esm/document/data-type/extended-types/date-time.type.js +55 -0
  147. package/esm/document/data-type/extended-types/date.type.js +52 -0
  148. package/esm/document/data-type/extended-types/email.type.js +77 -0
  149. package/esm/document/data-type/extended-types/field-path.type.js +50 -0
  150. package/esm/document/data-type/extended-types/filter.type.js +71 -0
  151. package/esm/document/data-type/extended-types/index.js +13 -0
  152. package/esm/document/data-type/extended-types/object-id.type.js +22 -0
  153. package/esm/document/{resource/types → data-type/extended-types}/operation-result.type.js +25 -14
  154. package/esm/document/data-type/extended-types/time.type.js +44 -0
  155. package/esm/document/data-type/extended-types/url.type.js +22 -0
  156. package/esm/document/data-type/extended-types/uuid.type.js +27 -0
  157. package/esm/document/data-type/mapped-type.js +76 -56
  158. package/esm/document/data-type/mixin-type.js +80 -24
  159. package/esm/document/data-type/omit-type.js +7 -0
  160. package/esm/document/data-type/partial-type.js +9 -0
  161. package/esm/document/data-type/pick-type.js +7 -0
  162. package/esm/document/data-type/primitive-types/any.type.js +22 -0
  163. package/esm/document/data-type/primitive-types/bigint.type.js +27 -0
  164. package/esm/document/data-type/primitive-types/boolean.type.js +22 -0
  165. package/esm/document/data-type/primitive-types/index.js +8 -0
  166. package/esm/document/data-type/primitive-types/integer.type.js +27 -0
  167. package/esm/document/data-type/{builtin → primitive-types}/null.type.js +11 -2
  168. package/esm/document/data-type/primitive-types/number.type.js +37 -0
  169. package/esm/document/data-type/{builtin → primitive-types}/object.type.js +7 -1
  170. package/esm/document/data-type/primitive-types/string.type.js +55 -0
  171. package/esm/document/data-type/required-type.js +9 -0
  172. package/esm/document/data-type/simple-type.js +92 -12
  173. package/esm/document/data-type/utils/create-mapped-class.js +50 -0
  174. package/esm/document/data-type/utils/get-is-inherited-predicate-fn.js +11 -0
  175. package/esm/document/{data-type/field-decorator.js → decorators/api-field-decorator.js} +5 -5
  176. package/esm/document/{data-type → decorators}/complex-type.decorator.js +12 -2
  177. package/esm/document/decorators/http-controller.decorator.js +112 -0
  178. package/esm/document/decorators/http-operation-entity.decorator.js +460 -0
  179. package/esm/document/decorators/http-operation.decorator.js +178 -0
  180. package/esm/document/decorators/simple-type.decorator.js +61 -0
  181. package/esm/document/factory/api-document.factory.js +174 -0
  182. package/esm/document/factory/data-type.factory.js +494 -0
  183. package/esm/document/factory/http-api.factory.js +311 -0
  184. package/esm/document/http/decorators/http-controller.decorator.js +112 -0
  185. package/esm/document/http/decorators/http-operation-entity.decorator.js +459 -0
  186. package/esm/document/http/decorators/http-operation.decorator.js +178 -0
  187. package/esm/document/http/http-api.js +36 -0
  188. package/esm/document/http/http-controller.js +142 -0
  189. package/esm/document/http/http-media-type.js +65 -0
  190. package/esm/document/http/http-multipart-field.js +29 -0
  191. package/esm/document/http/http-operation-response.js +38 -0
  192. package/esm/document/http/http-operation.js +90 -0
  193. package/esm/document/http/http-parameter.js +41 -0
  194. package/esm/document/http/http-request-body.js +21 -0
  195. package/esm/document/http/http-status-range.js +37 -0
  196. package/esm/document/index.js +34 -22
  197. package/esm/document/utils/inspect.util.js +3 -3
  198. package/esm/document/utils/parse-regexp.util.js +18 -0
  199. package/esm/exception/http-errors/bad-request.error.js +3 -3
  200. package/esm/exception/http-errors/conflict.error.js +3 -3
  201. package/esm/exception/http-errors/failed-dependency.error.js +3 -3
  202. package/esm/exception/http-errors/forbidden.error.js +3 -3
  203. package/esm/exception/http-errors/internal-server.error.js +3 -3
  204. package/esm/exception/http-errors/method-not-allowed.error.js +3 -3
  205. package/esm/exception/http-errors/not-acceptable.error.js +3 -3
  206. package/esm/exception/http-errors/not-found.error.js +3 -3
  207. package/esm/exception/{resource-errors → http-errors}/permission.error.js +2 -2
  208. package/esm/exception/{resource-errors → http-errors}/resource-conflict.error.js +3 -3
  209. package/esm/exception/{resource-errors → http-errors}/resource-not.available.error.js +5 -5
  210. package/esm/exception/http-errors/unauthorized.error.js +3 -3
  211. package/esm/exception/http-errors/unprocessable-entity.error.js +3 -3
  212. package/esm/exception/index.js +4 -4
  213. package/esm/exception/issue-severity.enum.js +1 -1
  214. package/esm/exception/opra-exception.js +5 -16
  215. package/esm/exception/opra-http-error.js +21 -0
  216. package/esm/filter/antlr/OpraFilterLexer.js +260 -194
  217. package/esm/filter/antlr/OpraFilterListener.js +1 -1
  218. package/esm/filter/antlr/OpraFilterParser.js +138 -85
  219. package/esm/filter/ast/expressions/arithmetic-expression.js +1 -1
  220. package/esm/filter/ast/expressions/logical-expression.js +1 -3
  221. package/esm/filter/ast/terms/number-literal.js +1 -3
  222. package/esm/filter/ast/terms/time-literal.js +6 -4
  223. package/esm/filter/build.js +2 -4
  224. package/esm/filter/filter-rules.js +89 -0
  225. package/esm/filter/filter-tree-visitor.js +4 -6
  226. package/esm/filter/parse.js +2 -2
  227. package/esm/filter/utils.js +1 -3
  228. package/esm/helpers/function-utils.js +1 -9
  229. package/esm/helpers/get-stack-filename.js +26 -3
  230. package/esm/helpers/index.js +2 -2
  231. package/esm/helpers/is-url-string.js +1 -2
  232. package/esm/helpers/mixin-utils.js +5 -8
  233. package/esm/helpers/monkey-patches.js +12 -0
  234. package/esm/helpers/object-utils.js +4 -5
  235. package/esm/helpers/parse-fields-projection.js +61 -0
  236. package/esm/helpers/responsive-map.js +93 -117
  237. package/esm/helpers/type-guards.js +22 -29
  238. package/esm/http/enums/http-status-messages.js +63 -63
  239. package/esm/http/enums/mime-types.enum.js +14 -0
  240. package/esm/http/index.js +1 -2
  241. package/esm/http/opra-url-path.js +14 -9
  242. package/esm/http/opra-url.js +18 -15
  243. package/esm/i18n/i18n.js +9 -5
  244. package/esm/i18n/translate.js +2 -2
  245. package/esm/index.js +1 -1
  246. package/esm/schema/http/http-controller.interface.js +8 -0
  247. package/esm/schema/http/http-operation.interface.js +4 -0
  248. package/esm/schema/index.js +27 -2
  249. package/esm/schema/type-guards.js +6 -24
  250. package/esm/schema/value.interface.js +1 -0
  251. package/package.json +14 -13
  252. package/types/document/api-document.d.ts +31 -51
  253. package/types/document/common/api-base.d.ts +17 -0
  254. package/types/document/common/data-type-map.d.ts +23 -0
  255. package/types/document/common/document-element.d.ts +23 -0
  256. package/types/document/common/document-init-context.d.ts +17 -0
  257. package/types/document/common/document-node.d.ts +65 -0
  258. package/types/document/common/opra-document-error.d.ts +12 -0
  259. package/types/document/common/value.d.ts +48 -0
  260. package/types/document/constants.d.ts +9 -3
  261. package/types/document/data-type/api-field.d.ts +65 -0
  262. package/types/document/data-type/complex-type-base.d.ts +80 -0
  263. package/types/document/data-type/complex-type.d.ts +61 -35
  264. package/types/document/data-type/data-type.d.ts +49 -46
  265. package/types/document/data-type/decorators/api-field-decorator.d.ts +5 -0
  266. package/types/document/data-type/decorators/complex-type.decorator.d.ts +2 -0
  267. package/types/document/data-type/decorators/simple-type.decorator.d.ts +20 -0
  268. package/types/document/data-type/enum-type.d.ts +59 -23
  269. package/types/document/data-type/extended-types/base64.type.d.ts +7 -0
  270. package/types/document/data-type/extended-types/date-string.type.d.ts +9 -0
  271. package/types/document/data-type/extended-types/date-time-string.type.d.ts +9 -0
  272. package/types/document/data-type/extended-types/date-time.type.d.ts +9 -0
  273. package/types/document/data-type/extended-types/date.type.d.ts +9 -0
  274. package/types/document/data-type/extended-types/email.type.d.ts +16 -0
  275. package/types/document/data-type/extended-types/field-path.type.d.ts +15 -0
  276. package/types/document/data-type/extended-types/filter.type.d.ts +16 -0
  277. package/types/document/data-type/extended-types/index.d.ts +13 -0
  278. package/types/document/data-type/extended-types/object-id.type.d.ts +7 -0
  279. package/types/document/{resource/types → data-type/extended-types}/operation-result.type.d.ts +7 -6
  280. package/types/document/data-type/extended-types/time.type.d.ts +9 -0
  281. package/types/document/data-type/extended-types/url.type.d.ts +7 -0
  282. package/types/document/data-type/extended-types/uuid.type.d.ts +8 -0
  283. package/types/document/data-type/mapped-type.d.ts +55 -44
  284. package/types/document/data-type/mixin-type.d.ts +65 -26
  285. package/types/document/data-type/omit-type.d.ts +15 -0
  286. package/types/document/data-type/partial-type.d.ts +28 -0
  287. package/types/document/data-type/pick-type.d.ts +16 -0
  288. package/types/document/data-type/primitive-types/any.type.d.ts +7 -0
  289. package/types/document/data-type/primitive-types/bigint.type.d.ts +8 -0
  290. package/types/document/data-type/primitive-types/boolean.type.d.ts +7 -0
  291. package/types/document/data-type/primitive-types/index.d.ts +8 -0
  292. package/types/document/data-type/primitive-types/integer.type.d.ts +8 -0
  293. package/types/document/data-type/primitive-types/null.type.d.ts +7 -0
  294. package/types/document/data-type/primitive-types/number.type.d.ts +9 -0
  295. package/types/document/data-type/primitive-types/object.type.d.ts +3 -0
  296. package/types/document/data-type/primitive-types/string.type.d.ts +11 -0
  297. package/types/document/data-type/required-type.d.ts +22 -0
  298. package/types/document/data-type/simple-type.d.ts +63 -24
  299. package/types/document/data-type/utils/create-mapped-class.d.ts +3 -0
  300. package/types/document/data-type/utils/get-is-inherited-predicate-fn.d.ts +1 -0
  301. package/types/document/decorators/api-field-decorator.d.ts +5 -0
  302. package/types/document/decorators/complex-type.decorator.d.ts +2 -0
  303. package/types/document/decorators/http-controller.decorator.d.ts +14 -0
  304. package/types/document/decorators/http-operation-entity.decorator.d.ts +100 -0
  305. package/types/document/decorators/http-operation.decorator.d.ts +30 -0
  306. package/types/document/decorators/simple-type.decorator.d.ts +20 -0
  307. package/types/document/factory/api-document.factory.d.ts +35 -0
  308. package/types/document/factory/data-type.factory.d.ts +103 -0
  309. package/types/document/factory/http-api.factory.d.ts +60 -0
  310. package/types/document/http/decorators/http-controller.decorator.d.ts +14 -0
  311. package/types/document/http/decorators/http-operation-entity.decorator.d.ts +100 -0
  312. package/types/document/http/decorators/http-operation.decorator.d.ts +30 -0
  313. package/types/document/http/http-api.d.ts +23 -0
  314. package/types/document/http/http-controller.d.ts +92 -0
  315. package/types/document/http/http-media-type.d.ts +59 -0
  316. package/types/document/http/http-multipart-field.d.ts +26 -0
  317. package/types/document/http/http-operation-response.d.ts +36 -0
  318. package/types/document/http/http-operation.d.ts +84 -0
  319. package/types/document/http/http-parameter.d.ts +50 -0
  320. package/types/document/http/http-request-body.d.ts +31 -0
  321. package/types/document/http/http-status-range.d.ts +14 -0
  322. package/types/document/index.d.ts +33 -22
  323. package/types/document/utils/parse-regexp.util.d.ts +4 -0
  324. package/types/exception/http-errors/bad-request.error.d.ts +2 -2
  325. package/types/exception/http-errors/conflict.error.d.ts +2 -2
  326. package/types/exception/http-errors/failed-dependency.error.d.ts +2 -2
  327. package/types/exception/http-errors/forbidden.error.d.ts +2 -2
  328. package/types/exception/http-errors/internal-server.error.d.ts +2 -2
  329. package/types/exception/http-errors/method-not-allowed.error.d.ts +2 -2
  330. package/types/exception/http-errors/not-acceptable.error.d.ts +2 -2
  331. package/types/exception/http-errors/not-found.error.d.ts +2 -2
  332. package/types/exception/{resource-errors → http-errors}/permission.error.d.ts +1 -1
  333. package/types/exception/http-errors/resource-conflict.error.d.ts +5 -0
  334. package/types/exception/{resource-errors → http-errors}/resource-not.available.error.d.ts +2 -2
  335. package/types/exception/http-errors/unauthorized.error.d.ts +2 -2
  336. package/types/exception/http-errors/unprocessable-entity.error.d.ts +2 -2
  337. package/types/exception/index.d.ts +4 -4
  338. package/types/exception/opra-exception.d.ts +1 -5
  339. package/types/exception/opra-http-error.d.ts +13 -0
  340. package/types/filter/antlr/OpraFilterLexer.d.ts +1 -1
  341. package/types/filter/antlr/OpraFilterListener.d.ts +2 -2
  342. package/types/filter/antlr/OpraFilterParser.d.ts +2 -2
  343. package/types/filter/antlr/OpraFilterVisitor.d.ts +1 -1
  344. package/types/filter/ast/terms/qualified-identifier.d.ts +1 -1
  345. package/types/filter/filter-rules.d.ts +24 -0
  346. package/types/filter/filter-tree-visitor.d.ts +1 -3
  347. package/types/helpers/function-utils.d.ts +2 -4
  348. package/types/helpers/get-stack-filename.d.ts +1 -0
  349. package/types/helpers/index.d.ts +2 -2
  350. package/types/helpers/monkey-patches.d.ts +0 -0
  351. package/types/helpers/parse-fields-projection.d.ts +11 -0
  352. package/types/helpers/responsive-map.d.ts +8 -4
  353. package/types/helpers/type-guards.d.ts +2 -2
  354. package/types/http/enums/http-status-messages.d.ts +63 -63
  355. package/types/http/enums/mime-types.enum.d.ts +12 -0
  356. package/types/http/index.d.ts +1 -2
  357. package/types/i18n/i18n.d.ts +2 -1
  358. package/types/schema/data-type/complex-type.interface.d.ts +3 -3
  359. package/types/schema/data-type/data-type.interface.d.ts +6 -0
  360. package/types/schema/data-type/enum-type.interface.d.ts +3 -4
  361. package/types/schema/data-type/field.interface.d.ts +2 -10
  362. package/types/schema/data-type/mapped-type.interface.d.ts +7 -3
  363. package/types/schema/data-type/mixin-type.interface.d.ts +2 -2
  364. package/types/schema/data-type/simple-type.interface.d.ts +35 -7
  365. package/types/schema/data-type-container.interface.d.ts +7 -0
  366. package/types/schema/document.interface.d.ts +55 -0
  367. package/types/schema/http/http-controller.interface.d.ts +24 -0
  368. package/types/schema/http/http-media-type.interface.d.ts +65 -0
  369. package/types/schema/http/http-multipart-field.interface.d.ts +7 -0
  370. package/types/schema/http/http-operation-response.interface.d.ts +24 -0
  371. package/types/schema/http/http-operation.interface.d.ts +23 -0
  372. package/types/schema/http/http-parameter.interface.d.ts +28 -0
  373. package/types/schema/http/http-request-body.interface.d.ts +29 -0
  374. package/types/schema/http/http-status-range.interface.d.ts +4 -0
  375. package/types/schema/index.d.ts +61 -2
  376. package/types/schema/type-guards.d.ts +2 -10
  377. package/types/schema/types.d.ts +3 -0
  378. package/types/schema/value.interface.d.ts +23 -0
  379. package/types/types.d.ts +1 -14
  380. package/cjs/document/data-type/builtin/any.type.js +0 -13
  381. package/cjs/document/data-type/builtin/approx-date.type.js +0 -21
  382. package/cjs/document/data-type/builtin/approx-datetime.type.js +0 -24
  383. package/cjs/document/data-type/builtin/bigint.type.js +0 -16
  384. package/cjs/document/data-type/builtin/date.type.js +0 -17
  385. package/cjs/document/data-type/builtin/datetime.type.js +0 -21
  386. package/cjs/document/data-type/builtin/email.type.js +0 -16
  387. package/cjs/document/data-type/builtin/index.js +0 -21
  388. package/cjs/document/data-type/builtin/integer.type.js +0 -16
  389. package/cjs/document/data-type/builtin/number.type.js +0 -16
  390. package/cjs/document/data-type/builtin/string.type.js +0 -16
  391. package/cjs/document/data-type/builtin/time.type.js +0 -23
  392. package/cjs/document/data-type/builtin/uuid.type.js +0 -16
  393. package/cjs/document/data-type/complex-type-class.js +0 -274
  394. package/cjs/document/data-type/enum-type-class.js +0 -39
  395. package/cjs/document/data-type/field-class.js +0 -67
  396. package/cjs/document/data-type/field.js +0 -25
  397. package/cjs/document/data-type/mapped-type-class.js +0 -53
  398. package/cjs/document/data-type/mixin-type-class.js +0 -38
  399. package/cjs/document/data-type/simple-type-class.js +0 -37
  400. package/cjs/document/data-type/simple-type.decorator.js +0 -20
  401. package/cjs/document/document-base.js +0 -24
  402. package/cjs/document/factory/api-document-factory.js +0 -262
  403. package/cjs/document/factory/type-document-factory.js +0 -326
  404. package/cjs/document/resource/action-decorator.js +0 -33
  405. package/cjs/document/resource/action.js +0 -34
  406. package/cjs/document/resource/collection-class.js +0 -257
  407. package/cjs/document/resource/collection-decorator.js +0 -211
  408. package/cjs/document/resource/collection.js +0 -25
  409. package/cjs/document/resource/container-class.js +0 -84
  410. package/cjs/document/resource/container-decorator.js +0 -24
  411. package/cjs/document/resource/container.js +0 -29
  412. package/cjs/document/resource/crud-operation-decorator.js +0 -28
  413. package/cjs/document/resource/crud-operation.js +0 -49
  414. package/cjs/document/resource/crud-resource.js +0 -34
  415. package/cjs/document/resource/endpoint.js +0 -59
  416. package/cjs/document/resource/enums/metadata-mode.enum.js +0 -19
  417. package/cjs/document/resource/parameter.js +0 -50
  418. package/cjs/document/resource/resource-decorator.js +0 -33
  419. package/cjs/document/resource/resource.js +0 -60
  420. package/cjs/document/resource/singleton-class.js +0 -83
  421. package/cjs/document/resource/singleton-decorator.js +0 -57
  422. package/cjs/document/resource/singleton.js +0 -25
  423. package/cjs/document/resource/storage-class.js +0 -18
  424. package/cjs/document/resource/storage-decorator.js +0 -70
  425. package/cjs/document/resource/storage.js +0 -25
  426. package/cjs/document/resource/types/operation-result.type.js +0 -45
  427. package/cjs/document/type-document.js +0 -204
  428. package/cjs/exception/wrap-exception.js +0 -43
  429. package/cjs/helpers/path-to-object-tree.js +0 -28
  430. package/cjs/schema/opra-schema.ns.js +0 -22
  431. package/cjs/schema/resource/collection.interface.js +0 -7
  432. package/cjs/schema/resource/container.interface.js +0 -7
  433. package/cjs/schema/resource/singleton.interface.js +0 -7
  434. package/cjs/schema/resource/storage.interface.js +0 -7
  435. package/esm/document/data-type/builtin/any.type.js +0 -10
  436. package/esm/document/data-type/builtin/approx-date.type.js +0 -18
  437. package/esm/document/data-type/builtin/approx-datetime.type.js +0 -21
  438. package/esm/document/data-type/builtin/base64.type.js +0 -13
  439. package/esm/document/data-type/builtin/bigint.type.js +0 -13
  440. package/esm/document/data-type/builtin/boolean.type.js +0 -13
  441. package/esm/document/data-type/builtin/date.type.js +0 -14
  442. package/esm/document/data-type/builtin/datetime.type.js +0 -18
  443. package/esm/document/data-type/builtin/email.type.js +0 -13
  444. package/esm/document/data-type/builtin/index.js +0 -18
  445. package/esm/document/data-type/builtin/integer.type.js +0 -13
  446. package/esm/document/data-type/builtin/number.type.js +0 -13
  447. package/esm/document/data-type/builtin/object-id.type.js +0 -13
  448. package/esm/document/data-type/builtin/string.type.js +0 -13
  449. package/esm/document/data-type/builtin/time.type.js +0 -20
  450. package/esm/document/data-type/builtin/url.type.js +0 -13
  451. package/esm/document/data-type/builtin/uuid.type.js +0 -13
  452. package/esm/document/data-type/complex-type-class.js +0 -270
  453. package/esm/document/data-type/enum-type-class.js +0 -35
  454. package/esm/document/data-type/field-class.js +0 -63
  455. package/esm/document/data-type/field.js +0 -21
  456. package/esm/document/data-type/mapped-type-class.js +0 -48
  457. package/esm/document/data-type/mixin-type-class.js +0 -34
  458. package/esm/document/data-type/simple-type-class.js +0 -33
  459. package/esm/document/data-type/simple-type.decorator.js +0 -15
  460. package/esm/document/document-base.js +0 -20
  461. package/esm/document/factory/api-document-factory.js +0 -258
  462. package/esm/document/factory/type-document-factory.js +0 -322
  463. package/esm/document/resource/action-decorator.js +0 -29
  464. package/esm/document/resource/action.js +0 -30
  465. package/esm/document/resource/collection-class.js +0 -253
  466. package/esm/document/resource/collection-decorator.js +0 -207
  467. package/esm/document/resource/collection.js +0 -21
  468. package/esm/document/resource/container-class.js +0 -80
  469. package/esm/document/resource/container-decorator.js +0 -20
  470. package/esm/document/resource/container.js +0 -25
  471. package/esm/document/resource/crud-operation-decorator.js +0 -24
  472. package/esm/document/resource/crud-operation.js +0 -45
  473. package/esm/document/resource/crud-resource.js +0 -30
  474. package/esm/document/resource/endpoint.js +0 -55
  475. package/esm/document/resource/enums/metadata-mode.enum.js +0 -16
  476. package/esm/document/resource/parameter.js +0 -46
  477. package/esm/document/resource/resource-decorator.js +0 -28
  478. package/esm/document/resource/resource.js +0 -56
  479. package/esm/document/resource/singleton-class.js +0 -79
  480. package/esm/document/resource/singleton-decorator.js +0 -53
  481. package/esm/document/resource/singleton.js +0 -21
  482. package/esm/document/resource/storage-class.js +0 -14
  483. package/esm/document/resource/storage-decorator.js +0 -66
  484. package/esm/document/resource/storage.js +0 -21
  485. package/esm/document/type-document.js +0 -200
  486. package/esm/exception/wrap-exception.js +0 -39
  487. package/esm/helpers/path-to-object-tree.js +0 -24
  488. package/esm/schema/opra-schema.ns.js +0 -19
  489. package/esm/schema/resource/collection.interface.js +0 -4
  490. package/esm/schema/resource/container.interface.js +0 -4
  491. package/esm/schema/resource/singleton.interface.js +0 -4
  492. package/esm/schema/resource/storage.interface.js +0 -4
  493. package/types/document/data-type/builtin/any.type.d.ts +0 -2
  494. package/types/document/data-type/builtin/approx-date.type.d.ts +0 -2
  495. package/types/document/data-type/builtin/approx-datetime.type.d.ts +0 -2
  496. package/types/document/data-type/builtin/base64.type.d.ts +0 -2
  497. package/types/document/data-type/builtin/bigint.type.d.ts +0 -2
  498. package/types/document/data-type/builtin/boolean.type.d.ts +0 -2
  499. package/types/document/data-type/builtin/date.type.d.ts +0 -2
  500. package/types/document/data-type/builtin/datetime.type.d.ts +0 -2
  501. package/types/document/data-type/builtin/email.type.d.ts +0 -2
  502. package/types/document/data-type/builtin/index.d.ts +0 -18
  503. package/types/document/data-type/builtin/integer.type.d.ts +0 -2
  504. package/types/document/data-type/builtin/null.type.d.ts +0 -2
  505. package/types/document/data-type/builtin/number.type.d.ts +0 -2
  506. package/types/document/data-type/builtin/object-id.type.d.ts +0 -2
  507. package/types/document/data-type/builtin/object.type.d.ts +0 -2
  508. package/types/document/data-type/builtin/string.type.d.ts +0 -2
  509. package/types/document/data-type/builtin/time.type.d.ts +0 -2
  510. package/types/document/data-type/builtin/url.type.d.ts +0 -2
  511. package/types/document/data-type/builtin/uuid.type.d.ts +0 -2
  512. package/types/document/data-type/complex-type-class.d.ts +0 -36
  513. package/types/document/data-type/complex-type.decorator.d.ts +0 -2
  514. package/types/document/data-type/enum-type-class.d.ts +0 -18
  515. package/types/document/data-type/field-class.d.ts +0 -31
  516. package/types/document/data-type/field-decorator.d.ts +0 -5
  517. package/types/document/data-type/field.d.ts +0 -46
  518. package/types/document/data-type/mapped-type-class.d.ts +0 -18
  519. package/types/document/data-type/mixin-type-class.d.ts +0 -12
  520. package/types/document/data-type/simple-type-class.d.ts +0 -19
  521. package/types/document/data-type/simple-type.decorator.d.ts +0 -2
  522. package/types/document/document-base.d.ts +0 -10
  523. package/types/document/factory/api-document-factory.d.ts +0 -49
  524. package/types/document/factory/type-document-factory.d.ts +0 -57
  525. package/types/document/interfaces/collection.interface.d.ts +0 -10
  526. package/types/document/interfaces/singleton.interface.d.ts +0 -7
  527. package/types/document/interfaces/storage.interface.d.ts +0 -8
  528. package/types/document/resource/action-decorator.d.ts +0 -8
  529. package/types/document/resource/action.d.ts +0 -30
  530. package/types/document/resource/collection-class.d.ts +0 -20
  531. package/types/document/resource/collection-decorator.d.ts +0 -204
  532. package/types/document/resource/collection.d.ts +0 -62
  533. package/types/document/resource/container-class.d.ts +0 -66
  534. package/types/document/resource/container-decorator.d.ts +0 -37
  535. package/types/document/resource/container.d.ts +0 -27
  536. package/types/document/resource/crud-operation-decorator.d.ts +0 -6
  537. package/types/document/resource/crud-operation.d.ts +0 -32
  538. package/types/document/resource/crud-resource.d.ts +0 -16
  539. package/types/document/resource/endpoint.d.ts +0 -32
  540. package/types/document/resource/enums/metadata-mode.enum.d.ts +0 -5
  541. package/types/document/resource/parameter.d.ts +0 -35
  542. package/types/document/resource/resource-decorator.d.ts +0 -40
  543. package/types/document/resource/resource.d.ts +0 -35
  544. package/types/document/resource/singleton-class.d.ts +0 -21
  545. package/types/document/resource/singleton-decorator.d.ts +0 -131
  546. package/types/document/resource/singleton.d.ts +0 -49
  547. package/types/document/resource/storage-class.d.ts +0 -17
  548. package/types/document/resource/storage-decorator.d.ts +0 -100
  549. package/types/document/resource/storage.d.ts +0 -39
  550. package/types/document/type-document.d.ts +0 -79
  551. package/types/exception/resource-errors/resource-conflict.error.d.ts +0 -5
  552. package/types/exception/wrap-exception.d.ts +0 -2
  553. package/types/helpers/path-to-object-tree.d.ts +0 -4
  554. package/types/schema/document/api-document.interface.d.ts +0 -11
  555. package/types/schema/document/document-base.interface.d.ts +0 -24
  556. package/types/schema/document/type-document.interface.d.ts +0 -6
  557. package/types/schema/opra-schema.ns.d.ts +0 -19
  558. package/types/schema/resource/action.interface.d.ts +0 -6
  559. package/types/schema/resource/collection.interface.d.ts +0 -55
  560. package/types/schema/resource/container.interface.d.ts +0 -10
  561. package/types/schema/resource/endpoint.interface.d.ts +0 -13
  562. package/types/schema/resource/resource.interface.d.ts +0 -15
  563. package/types/schema/resource/singleton.interface.d.ts +0 -25
  564. package/types/schema/resource/storage.interface.d.ts +0 -61
  565. /package/cjs/{document/interfaces/collection.interface.js → schema/data-type-container.interface.js} +0 -0
  566. /package/cjs/{document/interfaces/singleton.interface.js → schema/document.interface.js} +0 -0
  567. /package/cjs/{document/interfaces/storage.interface.js → schema/http/http-media-type.interface.js} +0 -0
  568. /package/cjs/schema/{document/api-document.interface.js → http/http-multipart-field.interface.js} +0 -0
  569. /package/cjs/schema/{document/document-base.interface.js → http/http-operation-response.interface.js} +0 -0
  570. /package/cjs/schema/{document/type-document.interface.js → http/http-parameter.interface.js} +0 -0
  571. /package/cjs/schema/{resource/action.interface.js → http/http-request-body.interface.js} +0 -0
  572. /package/cjs/schema/{resource/endpoint.interface.js → http/http-status-range.interface.js} +0 -0
  573. /package/cjs/schema/{resource/resource.interface.js → types.js} +0 -0
  574. /package/esm/{document/interfaces/collection.interface.js → schema/data-type-container.interface.js} +0 -0
  575. /package/esm/{document/interfaces/singleton.interface.js → schema/document.interface.js} +0 -0
  576. /package/esm/{document/interfaces/storage.interface.js → schema/http/http-media-type.interface.js} +0 -0
  577. /package/esm/schema/{document/api-document.interface.js → http/http-multipart-field.interface.js} +0 -0
  578. /package/esm/schema/{document/document-base.interface.js → http/http-operation-response.interface.js} +0 -0
  579. /package/esm/schema/{document/type-document.interface.js → http/http-parameter.interface.js} +0 -0
  580. /package/esm/schema/{resource/action.interface.js → http/http-request-body.interface.js} +0 -0
  581. /package/esm/schema/{resource/endpoint.interface.js → http/http-status-range.interface.js} +0 -0
  582. /package/esm/schema/{resource/resource.interface.js → types.js} +0 -0
@@ -0,0 +1,120 @@
1
+ import { OpraSchema } from '../../schema/index.js';
2
+ import { DATATYPE_METADATA, kDataTypeMap, kTypeNSMap } from '../constants.js';
3
+ /**
4
+ * @class DocumentNode
5
+ */
6
+ export class DocumentNode {
7
+ constructor(element, parent) {
8
+ this.element = element;
9
+ this.parent = parent;
10
+ }
11
+ getDocument() {
12
+ if (this._document)
13
+ return this._document;
14
+ if (this.element[kTypeNSMap])
15
+ return this.element;
16
+ if (this.parent)
17
+ return (this._document = this.parent.getDocument());
18
+ // istanbul ignore next
19
+ throw new Error('ApiDocument not found in document tree');
20
+ }
21
+ hasDataType(nameOrCtor) {
22
+ const result = this[kDataTypeMap]?.has(nameOrCtor);
23
+ if (result)
24
+ return result;
25
+ return this.parent ? this.parent.hasDataType(nameOrCtor) : false;
26
+ }
27
+ findDataType(nameOrCtor) {
28
+ const result = this[kDataTypeMap]?.get(nameOrCtor);
29
+ if (result)
30
+ return result;
31
+ return this.parent ? this.parent.findDataType(nameOrCtor) : undefined;
32
+ }
33
+ /**
34
+ * Returns DataType instance by name or Constructor. Returns undefined if not found
35
+ * @param nameOrCtor
36
+ */
37
+ getDataType(nameOrCtor) {
38
+ const dt = this.findDataType(nameOrCtor);
39
+ if (dt)
40
+ return dt;
41
+ let name = '';
42
+ if (typeof nameOrCtor === 'function') {
43
+ const metadata = Reflect.getMetadata(DATATYPE_METADATA, nameOrCtor);
44
+ name = metadata.name;
45
+ }
46
+ else if (typeof nameOrCtor === 'object') {
47
+ const metadata = nameOrCtor[DATATYPE_METADATA];
48
+ name = metadata?.name;
49
+ }
50
+ if (typeof nameOrCtor === 'string')
51
+ name = nameOrCtor;
52
+ throw new TypeError(`Unknown data type` + (name ? ' (' + name + ')' : ''));
53
+ }
54
+ getDataTypeNameWithNs(dataType) {
55
+ if (!dataType.name)
56
+ return;
57
+ const ns = this.getDocument().getDataTypeNs(dataType);
58
+ return ns ? ns + ':' + dataType.name : dataType.name;
59
+ }
60
+ /**
61
+ * Returns ComplexType instance by name or Constructor.
62
+ * Returns undefined if not found
63
+ * Throws error if data type is not a ComplexType
64
+ * @param nameOrCtor
65
+ */
66
+ getComplexType(nameOrCtor) {
67
+ const t = this.getDataType(nameOrCtor);
68
+ if (t.kind === OpraSchema.ComplexType.Kind)
69
+ return t;
70
+ throw new TypeError(`Data type "${t.name}" is not a ComplexType`);
71
+ }
72
+ /**
73
+ * Returns SimpleType instance by name or Constructor.
74
+ * Returns undefined if not found
75
+ * Throws error if data type is not a SimpleType
76
+ * @param nameOrCtor
77
+ */
78
+ getSimpleType(nameOrCtor) {
79
+ const t = this.getDataType(nameOrCtor);
80
+ if (t.kind === OpraSchema.SimpleType.Kind)
81
+ return t;
82
+ throw new TypeError(`Data type "${t.name || t}" is not a SimpleType`);
83
+ }
84
+ /**
85
+ * Returns EnumType instance by name or Constructor.
86
+ * Returns undefined if not found
87
+ * Throws error if data type is not a EnumType
88
+ * @param nameOrCtor
89
+ */
90
+ getEnumType(nameOrCtor) {
91
+ const t = this.getDataType(nameOrCtor);
92
+ if (t.kind === OpraSchema.EnumType.Kind)
93
+ return t;
94
+ throw new TypeError(`Data type "${t.name || t}" is not a EnumType`);
95
+ }
96
+ /**
97
+ * Returns EnumType instance by name or Constructor.
98
+ * Returns undefined if not found
99
+ * Throws error if data type is not a MappedType
100
+ * @param nameOrCtor
101
+ */
102
+ getMappedType(nameOrCtor) {
103
+ const t = this.getDataType(nameOrCtor);
104
+ if (t.kind === OpraSchema.MappedType.Kind)
105
+ return t;
106
+ throw new TypeError(`Data type "${t.name || t}" is not a MappedType`);
107
+ }
108
+ /**
109
+ * Returns EnumType instance by name or Constructor.
110
+ * Returns undefined if not found
111
+ * Throws error if data type is not a MixinType
112
+ * @param nameOrCtor
113
+ */
114
+ getMixinType(nameOrCtor) {
115
+ const t = this.getDataType(nameOrCtor);
116
+ if (t.kind === OpraSchema.MixinType.Kind)
117
+ return t;
118
+ throw new TypeError(`Data type "${t.name || t}" is not a MixinType`);
119
+ }
120
+ }
@@ -0,0 +1,11 @@
1
+ import { OpraException } from '../../exception/opra-exception.js';
2
+ export class OpraDocumentError extends OpraException {
3
+ constructor() {
4
+ super('');
5
+ this.details = [];
6
+ }
7
+ add(detail) {
8
+ this.details.push(detail);
9
+ return this;
10
+ }
11
+ }
@@ -0,0 +1,30 @@
1
+ import { asMutable } from 'ts-gems';
2
+ import { omitUndefined } from '../../helpers/index.js';
3
+ import { DocumentElement } from './document-element.js';
4
+ export const Value = function (owner, initArgs) {
5
+ if (!this)
6
+ throw new TypeError('"this" should be passed to call class constructor');
7
+ DocumentElement.call(this, owner);
8
+ // if (args.name && !PARAMETER_NAME_PATTERN.test(args.name))
9
+ // throw new TypeError(`"${args.name}" is not a valid parameter name`);
10
+ const _this = asMutable(this);
11
+ _this.description = initArgs.description;
12
+ _this.type = initArgs.type;
13
+ _this.examples = initArgs.examples;
14
+ _this.isArray = initArgs.isArray;
15
+ };
16
+ /**
17
+ * @class Value
18
+ */
19
+ class ValueClass extends DocumentElement {
20
+ toJSON() {
21
+ const typeName = this.type ? this.node.getDataTypeNameWithNs(this.type) : undefined;
22
+ return omitUndefined({
23
+ type: this.type ? (typeName ? typeName : this.type.toJSON()) : 'any',
24
+ description: this.description,
25
+ isArray: this.isArray,
26
+ examples: this.examples,
27
+ });
28
+ }
29
+ }
30
+ Value.prototype = ValueClass.prototype;
@@ -1,6 +1,12 @@
1
- export const DATATYPE_METADATA = Symbol('DATATYPE_METADATA');
2
- export const RESOURCE_METADATA = Symbol('RESOURCE_METADATA');
3
- export const DECORATOR = Symbol('DECORATOR');
4
- export const NAMESPACE_PATTERN = /([a-z$_]\w+)(?::.+)?/i;
5
- export const TYPENAME_PATTERN = /^(.*)Type(\d*)$/;
6
- export const SORT_FIELD_PATTERN = /^([+-])?([a-z$_][\w.]+)$/;
1
+ export const DATATYPE_METADATA = Symbol.for('opra.type.metadata');
2
+ export const HTTP_CONTROLLER_METADATA = Symbol('opra.http-controller.metadata');
3
+ export const DECODER = Symbol.for('opra.type.decoder');
4
+ export const ENCODER = Symbol('opra.type.encoder');
5
+ export const DECORATOR = Symbol.for('DECORATOR');
6
+ export const BUILTIN = Symbol.for('BUILTIN');
7
+ export const NAMESPACE_PATTERN = /([a-z$_]\w+)(:.+)/i;
8
+ export const CLASS_NAME_PATTERN = /^[a-z][\w_]*$/i;
9
+ export const EXTRACT_TYPENAME_PATTERN = /^(.*)Type(\d*)$/;
10
+ export const kDataTypeMap = Symbol.for('kDataTypeMap');
11
+ export const kCtorMap = Symbol.for('kCtorMap');
12
+ export const kTypeNSMap = Symbol.for('kTypeNSMap');
@@ -0,0 +1,61 @@
1
+ import { asMutable } from 'ts-gems';
2
+ import { omitUndefined } from '../../helpers/index.js';
3
+ import { DocumentElement } from '../common/document-element.js';
4
+ import { DECORATOR } from '../constants.js';
5
+ import { ApiFieldDecorator } from '../decorators/api-field-decorator.js';
6
+ import { ComplexTypeBase } from './complex-type-base.js';
7
+ /**
8
+ * @constructor ApiField
9
+ * @decorator ApiField
10
+ */
11
+ export const ApiField = function (...args) {
12
+ // Decorator
13
+ if (!this) {
14
+ const [options] = args;
15
+ return ApiField[DECORATOR](options);
16
+ }
17
+ // Constructor
18
+ const [owner, initArgs] = args;
19
+ DocumentElement.call(this, owner);
20
+ const _this = asMutable(this);
21
+ _this.name = initArgs.name;
22
+ const origin = initArgs.origin || owner;
23
+ /* istanbul ignore next */
24
+ if (!(origin instanceof ComplexTypeBase))
25
+ throw new Error('Field origin should be one of ComplexType, MappedType or MixinType');
26
+ _this.origin = origin;
27
+ _this.type = initArgs.type || owner.node.getDataType('any');
28
+ _this.description = initArgs.description;
29
+ _this.isArray = initArgs.isArray;
30
+ _this.default = initArgs.default;
31
+ _this.fixed = initArgs.fixed;
32
+ _this.required = initArgs.required;
33
+ _this.exclusive = initArgs.exclusive;
34
+ _this.translatable = initArgs.translatable;
35
+ _this.deprecated = initArgs.deprecated;
36
+ _this.examples = initArgs.examples;
37
+ };
38
+ /**
39
+ *
40
+ * @class ApiField
41
+ */
42
+ class ApiFieldClass extends DocumentElement {
43
+ toJSON() {
44
+ const typeName = this.type ? this.node.getDataTypeNameWithNs(this.type) : undefined;
45
+ return omitUndefined({
46
+ type: this.type ? (typeName ? typeName : this.type?.toJSON()) : undefined,
47
+ description: this.description,
48
+ isArray: this.isArray,
49
+ default: this.default,
50
+ fixed: this.fixed,
51
+ required: this.required,
52
+ exclusive: this.exclusive,
53
+ translatable: this.translatable,
54
+ deprecated: this.deprecated,
55
+ examples: this.examples,
56
+ });
57
+ }
58
+ }
59
+ ApiField.prototype = ApiFieldClass.prototype;
60
+ Object.assign(ApiField, ApiFieldDecorator);
61
+ ApiField[DECORATOR] = ApiFieldDecorator;
@@ -0,0 +1,180 @@
1
+ import { asMutable } from 'ts-gems';
2
+ import { validator, vg } from 'valgen';
3
+ import { parseFieldsProjection, ResponsiveMap } from '../../helpers/index.js';
4
+ import { translate } from '../../i18n/index.js';
5
+ import { DataType } from './data-type.js';
6
+ export const FIELD_PATH_PATTERN = /^([+-])?([a-z$_][\w.]*)$/i;
7
+ /**
8
+ *
9
+ * @constructor
10
+ */
11
+ export const ComplexTypeBase = function (...args) {
12
+ if (!this)
13
+ throw new TypeError('"this" should be passed to call class constructor');
14
+ // Constructor
15
+ const [owner, initArgs, context] = args;
16
+ DataType.call(this, owner, initArgs, context);
17
+ const _this = asMutable(this);
18
+ _this.fields = new ResponsiveMap();
19
+ };
20
+ /**
21
+ *
22
+ */
23
+ class ComplexTypeBaseClass extends DataType {
24
+ /**
25
+ *
26
+ */
27
+ findField(nameOrPath) {
28
+ if (nameOrPath.includes('.')) {
29
+ const fieldPath = this.parseFieldPath(nameOrPath);
30
+ const lastItem = fieldPath.pop();
31
+ return lastItem?.field;
32
+ }
33
+ return this.fields.get(nameOrPath);
34
+ }
35
+ /**
36
+ *
37
+ */
38
+ getField(nameOrPath) {
39
+ const field = this.findField(nameOrPath);
40
+ if (!field)
41
+ throw new Error(translate('error:UNKNOWN_FIELD', { field: nameOrPath }));
42
+ return field;
43
+ }
44
+ /**
45
+ *
46
+ */
47
+ parseFieldPath(fieldPath, options) {
48
+ let dataType = this;
49
+ let field;
50
+ const arr = fieldPath.split('.');
51
+ const len = arr.length;
52
+ const out = [];
53
+ const objectType = this.owner.node.getDataType('object');
54
+ const allowSigns = options?.allowSigns;
55
+ const getStrPath = () => out.map(x => x.fieldName).join('.');
56
+ for (let i = 0; i < len; i++) {
57
+ const item = {
58
+ fieldName: arr[i],
59
+ dataType: objectType,
60
+ };
61
+ out.push(item);
62
+ const m = FIELD_PATH_PATTERN.exec(arr[i]);
63
+ if (!m)
64
+ throw new TypeError(`Invalid field name (${getStrPath()})`);
65
+ if (m[1]) {
66
+ if ((i === 0 && allowSigns === 'first') || allowSigns === 'each')
67
+ item.sign = m[1];
68
+ item.fieldName = m[2];
69
+ }
70
+ if (dataType) {
71
+ if (dataType instanceof ComplexTypeBase) {
72
+ field = dataType.fields.get(item.fieldName);
73
+ if (field) {
74
+ item.fieldName = field.name;
75
+ item.field = field;
76
+ item.dataType = field.type;
77
+ dataType = field.type;
78
+ continue;
79
+ }
80
+ if (dataType.additionalFields?.[0] === true) {
81
+ item.additionalField = true;
82
+ item.dataType = objectType;
83
+ dataType = undefined;
84
+ continue;
85
+ }
86
+ if (dataType.additionalFields?.[0] === 'type' && dataType.additionalFields?.[1] instanceof DataType) {
87
+ item.additionalField = true;
88
+ item.dataType = dataType.additionalFields[1];
89
+ dataType = dataType.additionalFields[1];
90
+ continue;
91
+ }
92
+ throw new Error(`Unknown field (${out.map(x => x.fieldName).join('.')})`);
93
+ }
94
+ throw new TypeError(`"${out.map(x => x.fieldName).join('.')}" field is not a complex type and has no child fields`);
95
+ }
96
+ item.additionalField = true;
97
+ item.dataType = objectType;
98
+ }
99
+ return out;
100
+ }
101
+ /**
102
+ *
103
+ */
104
+ normalizeFieldPath(fieldPath, options) {
105
+ return this.parseFieldPath(fieldPath, options)
106
+ .map(x => (x.sign || '') + x.fieldName)
107
+ .join('.');
108
+ }
109
+ /**
110
+ *
111
+ */
112
+ generateCodec(codec, options) {
113
+ const projection = Array.isArray(options?.projection)
114
+ ? parseFieldsProjection(options.projection)
115
+ : options?.projection;
116
+ const schema = this._generateSchema(codec, { ...options, projection, currentPath: '' });
117
+ let additionalFields;
118
+ if (this.additionalFields instanceof DataType)
119
+ additionalFields = this.additionalFields.generateCodec(codec, options);
120
+ else if (typeof this.additionalFields === 'boolean')
121
+ additionalFields = this.additionalFields;
122
+ else if (Array.isArray(this.additionalFields)) {
123
+ if (this.additionalFields.length < 2)
124
+ additionalFields = 'error';
125
+ else {
126
+ const message = additionalFields[1];
127
+ additionalFields = validator((input, context, _this) => context.fail(_this, message, input));
128
+ }
129
+ }
130
+ return vg.isObject(schema, {
131
+ ctor: this.ctor,
132
+ additionalFields,
133
+ name: this.name,
134
+ coerce: true,
135
+ caseInSensitive: options?.caseInSensitive,
136
+ onFail: options?.onFail,
137
+ });
138
+ }
139
+ _generateSchema(codec, context) {
140
+ const schema = {};
141
+ const { currentPath, projection } = context;
142
+ const pickList = !!(projection && Object.values(projection).find(p => !p.sign));
143
+ // Process fields
144
+ let fieldName;
145
+ for (const field of this.fields.values()) {
146
+ fieldName = field.name;
147
+ let p;
148
+ if (projection !== '*') {
149
+ p = projection?.[fieldName.toLowerCase()];
150
+ if (
151
+ /** Ignore if field is omitted */
152
+ p?.sign === '-' ||
153
+ /** Ignore if default fields ignored and field is not in projection */
154
+ (pickList && !p) ||
155
+ /** Ignore if default fields enabled and fields is exclusive */
156
+ (!pickList && field.exclusive && !p)) {
157
+ schema[field.name] = vg.isUndefined({ coerce: true });
158
+ continue;
159
+ }
160
+ }
161
+ const fn = this._generateFieldCodec(codec, field, {
162
+ ...context,
163
+ partial: context.partial === 'deep' ? context.partial : undefined,
164
+ projection: projection !== '*' ? projection : p?.projection,
165
+ currentPath: currentPath + (currentPath ? '.' : '') + fieldName,
166
+ });
167
+ schema[fieldName] = context.partial || !field.required ? vg.optional(fn) : vg.required(fn);
168
+ }
169
+ return schema;
170
+ }
171
+ _generateFieldCodec(codec, field, context) {
172
+ let fn = field.type.generateCodec(codec, context);
173
+ if (field.fixed)
174
+ fn = vg.isEnum([field.fixed]);
175
+ if (field.isArray)
176
+ fn = vg.isArray(fn);
177
+ return fn;
178
+ }
179
+ }
180
+ ComplexTypeBase.prototype = ComplexTypeBaseClass.prototype;
@@ -1,22 +1,99 @@
1
1
  import 'reflect-metadata';
2
- import merge from 'putil-merge';
2
+ import { asMutable } from 'ts-gems';
3
+ import { omitUndefined } from '../../helpers/index.js';
4
+ import { OpraSchema } from '../../schema/index.js';
5
+ import { DocumentInitContext } from '../common/document-init-context.js';
3
6
  import { DECORATOR } from '../constants.js';
4
- import { ComplexTypeDecorator } from './complex-type.decorator.js';
5
- import { ComplexTypeClass } from './complex-type-class.js';
7
+ import { ComplexTypeDecorator } from '../decorators/complex-type.decorator.js';
8
+ import { ApiField } from './api-field.js';
9
+ import { ComplexTypeBase } from './complex-type-base.js';
10
+ import { DataType } from './data-type.js';
6
11
  /**
7
- * @class ComplexType
8
- * @decorator ComplexType
12
+ * ComplexType constructor
9
13
  */
10
14
  export const ComplexType = function (...args) {
11
15
  // Decorator
12
- if (!this) {
13
- const [options] = args;
14
- return ComplexType[DECORATOR](options);
15
- }
16
+ if (!this)
17
+ return ComplexType[DECORATOR].apply(undefined, args);
16
18
  // Constructor
17
- const [document, init] = args;
18
- merge(this, new ComplexTypeClass(document, init), { descriptor: true });
19
+ const [owner, initArgs] = args;
20
+ const context = args[2] || new DocumentInitContext({ maxErrors: 0 });
21
+ ComplexTypeBase.call(this, owner, initArgs, context);
22
+ const _this = asMutable(this);
23
+ _this.kind = OpraSchema.ComplexType.Kind;
24
+ _this.additionalFields = initArgs.additionalFields;
25
+ _this.keyField = initArgs.keyField;
26
+ if (initArgs.base) {
27
+ context.enter('.base', () => {
28
+ // noinspection SuspiciousTypeOfGuard
29
+ if (!(initArgs.base instanceof ComplexTypeBase))
30
+ throw new TypeError(`"${initArgs.base.kind}" can't be set as base for a "${this.kind}"`);
31
+ _this.base = initArgs.base;
32
+ if (_this.additionalFields == null && _this.base.additionalFields)
33
+ _this.additionalFields = _this.base.additionalFields;
34
+ /** Copy fields from base */
35
+ for (const v of _this.base.fields.values()) {
36
+ this.fields.set(v.name, new ApiField(this, v));
37
+ }
38
+ });
39
+ }
40
+ _this.ctor = initArgs.ctor || _this.base?.ctor;
41
+ /** Add own fields */
42
+ if (initArgs.fields) {
43
+ context.enter('.fields', () => {
44
+ for (const [k, v] of Object.entries(initArgs.fields)) {
45
+ const field = new ApiField(this, {
46
+ ...v,
47
+ name: k,
48
+ });
49
+ this.fields.set(field.name, field);
50
+ }
51
+ });
52
+ }
19
53
  };
54
+ /**
55
+ *
56
+ * @class ComplexType
57
+ */
58
+ class ComplexTypeClass extends ComplexTypeBase {
59
+ extendsFrom(baseType) {
60
+ if (!(baseType instanceof ComplexTypeBase))
61
+ return false;
62
+ if (baseType === this)
63
+ return true;
64
+ return !!this.base?.extendsFrom(baseType);
65
+ }
66
+ toJSON() {
67
+ const baseName = this.base ? this.node.getDataTypeNameWithNs(this.base) : undefined;
68
+ const out = omitUndefined({
69
+ ...ComplexTypeBase.prototype.toJSON.call(this),
70
+ kind: this.kind,
71
+ base: this.base ? (baseName ? baseName : this.base.toJSON()) : undefined,
72
+ });
73
+ if (this.additionalFields) {
74
+ if (this.additionalFields instanceof DataType) {
75
+ out.additionalFields = this.additionalFields[1].name
76
+ ? this.additionalFields[1].name
77
+ : this.additionalFields[1].toJSON();
78
+ }
79
+ else
80
+ out.additionalFields = this.additionalFields;
81
+ }
82
+ if (this.fields.size) {
83
+ const fields = {};
84
+ let i = 0;
85
+ for (const field of this.fields.values()) {
86
+ if (field.origin === this) {
87
+ fields[field.name] = field.toJSON();
88
+ i++;
89
+ }
90
+ }
91
+ if (i)
92
+ out.fields = fields;
93
+ }
94
+ return omitUndefined(out);
95
+ }
96
+ }
20
97
  ComplexType.prototype = ComplexTypeClass.prototype;
21
98
  Object.assign(ComplexType, ComplexTypeDecorator);
22
99
  ComplexType[DECORATOR] = ComplexTypeDecorator;
@@ -1,40 +1,48 @@
1
+ import { asMutable } from 'ts-gems';
1
2
  import { omitUndefined } from '../../helpers/index.js';
3
+ import { DocumentElement } from '../common/document-element.js';
4
+ import { CLASS_NAME_PATTERN } from '../constants.js';
2
5
  import { colorFgMagenta, colorFgYellow, colorReset, nodeInspectCustom } from '../utils/inspect.util.js';
3
6
  /**
7
+ * DataType constructor
8
+ */
9
+ export const DataType = function (owner, initArgs,
10
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
11
+ context) {
12
+ if (!this)
13
+ throw new TypeError('"this" should be passed to call class constructor');
14
+ if (initArgs?.name && !CLASS_NAME_PATTERN.test(initArgs.name))
15
+ throw new TypeError(`"${initArgs.name}" is not a valid DataType name`);
16
+ DocumentElement.call(this, owner);
17
+ const _this = asMutable(this);
18
+ _this.kind = initArgs.kind;
19
+ _this.name = initArgs.name;
20
+ _this.description = initArgs.description;
21
+ _this.abstract = initArgs.abstract;
22
+ _this.examples = initArgs.examples;
23
+ };
24
+ /**
25
+ *
4
26
  * @class DataType
5
- * @abstract
6
27
  */
7
- export class DataType {
8
- constructor(document, init) {
9
- this.document = document;
10
- this.name = init?.name;
11
- this.own = {};
12
- this.description = init?.description;
13
- if (!this.name)
14
- this.isEmbedded = true;
28
+ class DataTypeClass extends DocumentElement {
29
+ get embedded() {
30
+ return !this.name;
15
31
  }
16
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
17
- exportSchema(options) {
32
+ toJSON() {
18
33
  return omitUndefined({
19
34
  kind: this.kind,
20
- description: this.description
35
+ description: this.description,
36
+ abstract: this.abstract,
37
+ examples: this.examples,
21
38
  });
22
39
  }
23
- extendsFrom(type) {
24
- const dataType = type instanceof DataType ? type : this.document.getDataType(type);
25
- let t = this;
26
- while (t) {
27
- if (t === dataType)
28
- return true;
29
- t = t.base;
30
- }
31
- return false;
32
- }
33
40
  toString() {
34
41
  return `[${Object.getPrototypeOf(this).constructor.name} ${this.name || '#Embedded'}]`;
35
42
  }
36
43
  [nodeInspectCustom]() {
37
- return `[${colorFgYellow + Object.getPrototypeOf(this).constructor.name + colorReset}` +
38
- ` ${colorFgMagenta + this.name + colorReset}]`;
44
+ return (`[${colorFgYellow + Object.getPrototypeOf(this).constructor.name + colorReset}` +
45
+ ` ${colorFgMagenta + this.name + colorReset}]`);
39
46
  }
40
47
  }
48
+ DataType.prototype = DataTypeClass.prototype;
@@ -0,0 +1,22 @@
1
+ import { omitUndefined } from '../../../helpers/index.js';
2
+ import { OpraSchema } from '../../../schema/index.js';
3
+ import { DATATYPE_METADATA } from '../../constants.js';
4
+ export function ApiFieldDecorator(options) {
5
+ return function (target, propertyKey) {
6
+ if (typeof propertyKey !== 'string')
7
+ throw new TypeError(`Symbol properties can't be used as a field`);
8
+ const metadata = Reflect.getOwnMetadata(DATATYPE_METADATA, target.constructor) || {};
9
+ metadata.kind = OpraSchema.ComplexType.Kind;
10
+ metadata.fields = metadata.fields || {};
11
+ const designType = Reflect.getMetadata('design:type', target, propertyKey);
12
+ const elemMeta = (metadata.fields[propertyKey] = {
13
+ ...options,
14
+ });
15
+ if (designType === Array) {
16
+ elemMeta.isArray = true;
17
+ }
18
+ else
19
+ elemMeta.type = elemMeta.type || designType;
20
+ Reflect.defineMetadata(DATATYPE_METADATA, omitUndefined(metadata), target.constructor);
21
+ };
22
+ }
@@ -0,0 +1,28 @@
1
+ import omit from 'lodash.omit';
2
+ import { OpraSchema } from '../../../schema/index.js';
3
+ import { CLASS_NAME_PATTERN, DATATYPE_METADATA, EXTRACT_TYPENAME_PATTERN } from '../../constants.js';
4
+ export function ComplexTypeDecorator(options) {
5
+ return function (target) {
6
+ let name;
7
+ if (!options?.embedded) {
8
+ if (options?.name) {
9
+ if (!CLASS_NAME_PATTERN.test(options.name))
10
+ throw new TypeError(`"${options.name}" is not a valid type name`);
11
+ name = options.name;
12
+ }
13
+ else {
14
+ name = target.name.match(EXTRACT_TYPENAME_PATTERN)?.[1] || target.name;
15
+ }
16
+ }
17
+ let metadata = Reflect.getOwnMetadata(DATATYPE_METADATA, target);
18
+ if (!metadata) {
19
+ metadata = {};
20
+ Reflect.defineMetadata(DATATYPE_METADATA, metadata, target);
21
+ }
22
+ metadata.kind = OpraSchema.ComplexType.Kind;
23
+ metadata.name = name;
24
+ // Merge options
25
+ if (options)
26
+ Object.assign(metadata, omit(options, ['kind', 'name', 'base', 'fields']));
27
+ };
28
+ }