@redocly/openapi-core 1.18.1 → 1.20.0

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 (411) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/__tests__/utils.ts +14 -7
  3. package/lib/benchmark/benches/lint-with-many-rules.bench.d.ts +1 -0
  4. package/lib/benchmark/benches/lint-with-many-rules.bench.js +7 -3
  5. package/lib/benchmark/benches/lint-with-nested-rule.bench.d.ts +1 -0
  6. package/lib/benchmark/benches/lint-with-nested-rule.bench.js +7 -3
  7. package/lib/benchmark/benches/lint-with-no-rules.bench.d.ts +1 -0
  8. package/lib/benchmark/benches/lint-with-no-rules.bench.js +7 -3
  9. package/lib/benchmark/benches/lint-with-top-level-rule-report.bench.d.ts +1 -0
  10. package/lib/benchmark/benches/lint-with-top-level-rule-report.bench.js +19 -15
  11. package/lib/benchmark/benches/lint-with-top-level-rule.bench.d.ts +1 -0
  12. package/lib/benchmark/benches/lint-with-top-level-rule.bench.js +18 -14
  13. package/lib/benchmark/benches/recommended-oas3.bench.js +2 -2
  14. package/lib/benchmark/benches/resolve-with-no-external.bench.js +2 -2
  15. package/lib/benchmark/utils.d.ts +3 -3
  16. package/lib/benchmark/utils.js +10 -7
  17. package/lib/bundle.d.ts +2 -2
  18. package/lib/bundle.js +127 -120
  19. package/lib/config/all.js +13 -1
  20. package/lib/config/builtIn.js +18 -17
  21. package/lib/config/config-resolvers.d.ts +1 -1
  22. package/lib/config/config-resolvers.js +241 -158
  23. package/lib/config/config.d.ts +4 -3
  24. package/lib/config/config.js +53 -34
  25. package/lib/config/load.d.ts +1 -1
  26. package/lib/config/load.js +105 -117
  27. package/lib/config/minimal.js +13 -0
  28. package/lib/config/recommended-strict.js +14 -1
  29. package/lib/config/recommended.js +14 -1
  30. package/lib/config/rules.d.ts +3 -3
  31. package/lib/config/rules.js +1 -2
  32. package/lib/config/types.d.ts +17 -4
  33. package/lib/config/utils.d.ts +3 -1
  34. package/lib/config/utils.js +78 -49
  35. package/lib/decorators/async3/index.d.ts +1 -0
  36. package/lib/decorators/async3/index.js +4 -0
  37. package/lib/decorators/common/filters/filter-helper.d.ts +1 -1
  38. package/lib/decorators/common/filters/filter-helper.js +2 -3
  39. package/lib/decorators/common/filters/filter-in.d.ts +1 -1
  40. package/lib/decorators/common/filters/filter-in.js +1 -1
  41. package/lib/decorators/common/filters/filter-out.d.ts +1 -1
  42. package/lib/decorators/common/filters/filter-out.js +1 -1
  43. package/lib/decorators/common/info-description-override.d.ts +1 -1
  44. package/lib/decorators/common/info-override.d.ts +1 -1
  45. package/lib/decorators/common/info-override.js +1 -12
  46. package/lib/decorators/common/media-type-examples-override.d.ts +1 -1
  47. package/lib/decorators/common/media-type-examples-override.js +8 -2
  48. package/lib/decorators/common/operation-description-override.d.ts +1 -1
  49. package/lib/decorators/common/registry-dependencies.d.ts +1 -1
  50. package/lib/decorators/common/remove-x-internal.d.ts +1 -1
  51. package/lib/decorators/common/remove-x-internal.js +4 -5
  52. package/lib/decorators/common/tag-description-override.d.ts +1 -1
  53. package/lib/decorators/oas2/index.d.ts +1 -1
  54. package/lib/decorators/oas2/remove-unused-components.js +1 -2
  55. package/lib/decorators/oas3/index.d.ts +1 -1
  56. package/lib/decorators/oas3/remove-unused-components.js +1 -2
  57. package/lib/env.d.ts +0 -1
  58. package/lib/env.js +1 -1
  59. package/lib/format/codeframes.d.ts +1 -1
  60. package/lib/format/codeframes.js +10 -8
  61. package/lib/format/format.d.ts +1 -1
  62. package/lib/format/format.js +24 -16
  63. package/lib/index.d.ts +2 -1
  64. package/lib/index.js +6 -4
  65. package/lib/js-yaml/index.d.ts +1 -1
  66. package/lib/js-yaml/index.js +1 -1
  67. package/lib/lint.d.ts +3 -1
  68. package/lib/lint.js +92 -99
  69. package/lib/logger.js +2 -2
  70. package/lib/oas-types.d.ts +9 -5
  71. package/lib/oas-types.js +22 -12
  72. package/lib/redocly/domains.d.ts +1 -1
  73. package/lib/redocly/domains.js +6 -6
  74. package/lib/redocly/index.d.ts +1 -1
  75. package/lib/redocly/index.js +60 -73
  76. package/lib/redocly/registry-api.js +64 -82
  77. package/lib/ref-utils.d.ts +2 -2
  78. package/lib/ref-utils.js +14 -13
  79. package/lib/resolve.d.ts +2 -2
  80. package/lib/resolve.js +186 -205
  81. package/lib/rules/ajv.d.ts +1 -1
  82. package/lib/rules/ajv.js +10 -8
  83. package/lib/rules/arazzo/index.js +2 -0
  84. package/lib/rules/async2/channels-kebab-case.d.ts +1 -1
  85. package/lib/rules/async2/index.js +2 -0
  86. package/lib/rules/async2/no-channel-trailing-slash.d.ts +1 -1
  87. package/lib/rules/async3/channels-kebab-case.d.ts +2 -0
  88. package/lib/rules/async3/channels-kebab-case.js +19 -0
  89. package/lib/rules/async3/index.d.ts +3 -0
  90. package/lib/rules/async3/index.js +24 -0
  91. package/lib/rules/async3/no-channel-trailing-slash.d.ts +2 -0
  92. package/lib/rules/async3/no-channel-trailing-slash.js +16 -0
  93. package/lib/rules/common/assertions/asserts.d.ts +2 -2
  94. package/lib/rules/common/assertions/asserts.js +5 -5
  95. package/lib/rules/common/assertions/index.d.ts +4 -4
  96. package/lib/rules/common/assertions/utils.d.ts +1 -1
  97. package/lib/rules/common/assertions/utils.js +43 -28
  98. package/lib/rules/common/info-contact.d.ts +1 -1
  99. package/lib/rules/common/info-license-strict.d.ts +2 -0
  100. package/lib/rules/common/info-license-strict.js +26 -0
  101. package/lib/rules/common/info-license-url.d.ts +1 -1
  102. package/lib/rules/common/info-license.d.ts +1 -1
  103. package/lib/rules/common/no-ambiguous-paths.d.ts +1 -1
  104. package/lib/rules/common/no-enum-type-mismatch.d.ts +1 -1
  105. package/lib/rules/common/no-http-verbs-in-paths.d.ts +1 -1
  106. package/lib/rules/common/no-identical-paths.d.ts +1 -1
  107. package/lib/rules/common/no-invalid-parameter-examples.js +1 -2
  108. package/lib/rules/common/no-invalid-schema-examples.js +1 -2
  109. package/lib/rules/common/no-path-trailing-slash.d.ts +1 -1
  110. package/lib/rules/common/no-required-schema-properties-undefined.d.ts +1 -1
  111. package/lib/rules/common/no-required-schema-properties-undefined.js +1 -2
  112. package/lib/rules/common/operation-2xx-response.d.ts +1 -1
  113. package/lib/rules/common/operation-4xx-response.d.ts +1 -1
  114. package/lib/rules/common/operation-description.d.ts +1 -1
  115. package/lib/rules/common/operation-operationId-unique.d.ts +1 -1
  116. package/lib/rules/common/operation-operationId-url-safe.d.ts +1 -1
  117. package/lib/rules/common/operation-operationId-url-safe.js +1 -0
  118. package/lib/rules/common/operation-operationId.d.ts +1 -1
  119. package/lib/rules/common/operation-parameters-unique.d.ts +1 -1
  120. package/lib/rules/common/operation-singular-tag.d.ts +1 -1
  121. package/lib/rules/common/operation-summary.d.ts +1 -1
  122. package/lib/rules/common/operation-tag-defined.d.ts +1 -1
  123. package/lib/rules/common/operation-tag-defined.js +1 -2
  124. package/lib/rules/common/parameter-description.d.ts +1 -1
  125. package/lib/rules/common/path-declaration-must-exist.d.ts +1 -1
  126. package/lib/rules/common/path-excludes-patterns.d.ts +1 -1
  127. package/lib/rules/common/path-http-verbs-order.d.ts +1 -1
  128. package/lib/rules/common/path-http-verbs-order.js +1 -1
  129. package/lib/rules/common/path-not-include-query.d.ts +1 -1
  130. package/lib/rules/common/path-params-defined.d.ts +1 -1
  131. package/lib/rules/common/path-segment-plural.d.ts +1 -1
  132. package/lib/rules/common/paths-kebab-case.d.ts +1 -1
  133. package/lib/rules/common/required-string-property-missing-min-length.d.ts +1 -1
  134. package/lib/rules/common/required-string-property-missing-min-length.js +2 -2
  135. package/lib/rules/common/response-contains-header.d.ts +1 -1
  136. package/lib/rules/common/response-contains-header.js +2 -2
  137. package/lib/rules/common/security-defined.d.ts +1 -1
  138. package/lib/rules/common/security-defined.js +3 -7
  139. package/lib/rules/common/spec-strict-refs.d.ts +1 -1
  140. package/lib/rules/common/spec.d.ts +2 -2
  141. package/lib/rules/common/spec.js +6 -7
  142. package/lib/rules/common/tag-description.d.ts +1 -1
  143. package/lib/rules/common/tags-alphabetical.d.ts +1 -1
  144. package/lib/rules/no-unresolved-refs.d.ts +3 -3
  145. package/lib/rules/no-unresolved-refs.js +3 -4
  146. package/lib/rules/oas2/boolean-parameter-prefixes.d.ts +1 -1
  147. package/lib/rules/oas2/index.d.ts +1 -1
  148. package/lib/rules/oas2/index.js +2 -0
  149. package/lib/rules/oas2/response-contains-property.d.ts +1 -1
  150. package/lib/rules/oas2/response-contains-property.js +1 -2
  151. package/lib/rules/oas3/array-parameter-serialization.d.ts +1 -1
  152. package/lib/rules/oas3/array-parameter-serialization.js +1 -2
  153. package/lib/rules/oas3/boolean-parameter-prefixes.d.ts +1 -1
  154. package/lib/rules/oas3/component-name-unique.d.ts +1 -1
  155. package/lib/rules/oas3/component-name-unique.js +2 -4
  156. package/lib/rules/oas3/index.d.ts +1 -1
  157. package/lib/rules/oas3/index.js +2 -0
  158. package/lib/rules/oas3/no-empty-servers.d.ts +1 -1
  159. package/lib/rules/oas3/no-example-value-and-externalValue.d.ts +1 -1
  160. package/lib/rules/oas3/no-invalid-media-type-examples.d.ts +1 -1
  161. package/lib/rules/oas3/no-invalid-media-type-examples.js +1 -2
  162. package/lib/rules/oas3/no-server-example.com.d.ts +1 -1
  163. package/lib/rules/oas3/no-server-example.com.js +1 -0
  164. package/lib/rules/oas3/no-server-trailing-slash.d.ts +1 -1
  165. package/lib/rules/oas3/no-server-variables-empty-enum.d.ts +1 -1
  166. package/lib/rules/oas3/no-server-variables-empty-enum.js +1 -2
  167. package/lib/rules/oas3/no-undefined-server-variable.d.ts +1 -1
  168. package/lib/rules/oas3/no-undefined-server-variable.js +2 -3
  169. package/lib/rules/oas3/no-unused-components.d.ts +1 -1
  170. package/lib/rules/oas3/no-unused-components.js +1 -2
  171. package/lib/rules/oas3/response-contains-property.d.ts +1 -1
  172. package/lib/rules/oas3/response-contains-property.js +1 -2
  173. package/lib/rules/oas3/spec-components-invalid-map-name.d.ts +1 -1
  174. package/lib/rules/other/stats.d.ts +3 -3
  175. package/lib/rules/other/stats.js +5 -3
  176. package/lib/rules/spot/parameters-no-body-inside-in.d.ts +2 -0
  177. package/lib/rules/spot/parameters-no-body-inside-in.js +18 -0
  178. package/lib/rules/utils.d.ts +4 -2
  179. package/lib/rules/utils.js +41 -13
  180. package/lib/types/arazzo.d.ts +1 -2275
  181. package/lib/types/arazzo.js +246 -309
  182. package/lib/types/asyncapi2.d.ts +17 -0
  183. package/lib/types/{asyncapi.js → asyncapi2.js} +59 -53
  184. package/lib/types/asyncapi3.d.ts +2 -0
  185. package/lib/types/asyncapi3.js +347 -0
  186. package/lib/types/index.js +19 -10
  187. package/lib/types/json-schema-adapter.d.ts +1 -1
  188. package/lib/types/json-schema-adapter.js +4 -18
  189. package/lib/types/oas2.js +6 -6
  190. package/lib/types/oas3.d.ts +4 -0
  191. package/lib/types/oas3.js +19 -19
  192. package/lib/types/oas3_1.d.ts +3 -0
  193. package/lib/types/oas3_1.js +20 -14
  194. package/lib/types/redocly-yaml.d.ts +8 -6
  195. package/lib/types/redocly-yaml.js +135 -36
  196. package/lib/typings/arazzo.d.ts +145 -27
  197. package/lib/typings/asyncapi3.d.ts +53 -0
  198. package/lib/typings/asyncapi3.js +2 -0
  199. package/lib/typings/common.d.ts +1 -1
  200. package/lib/typings/swagger.d.ts +2 -2
  201. package/lib/utils.d.ts +4 -3
  202. package/lib/utils.js +55 -72
  203. package/lib/visitors.d.ts +29 -1
  204. package/lib/visitors.js +21 -8
  205. package/lib/walk.d.ts +3 -3
  206. package/lib/walk.js +30 -23
  207. package/package.json +3 -3
  208. package/src/__tests__/bundle.test.ts +144 -2
  209. package/src/__tests__/lint.test.ts +29 -21
  210. package/src/__tests__/walk.test.ts +25 -25
  211. package/src/benchmark/benches/lint-with-many-rules.bench.ts +7 -1
  212. package/src/benchmark/benches/lint-with-nested-rule.bench.ts +7 -1
  213. package/src/benchmark/benches/lint-with-no-rules.bench.ts +8 -1
  214. package/src/benchmark/benches/lint-with-top-level-rule-report.bench.ts +18 -13
  215. package/src/benchmark/benches/lint-with-top-level-rule.bench.ts +17 -11
  216. package/src/benchmark/fork.js +4 -0
  217. package/src/benchmark/utils.ts +6 -5
  218. package/src/bundle.ts +19 -4
  219. package/src/config/__tests__/__snapshots__/config-resolvers.test.ts.snap +32 -2
  220. package/src/config/__tests__/__snapshots__/config.test.ts.snap +24 -0
  221. package/src/config/__tests__/config-resolvers.test.ts +82 -0
  222. package/src/config/__tests__/config.test.ts +11 -0
  223. package/src/config/__tests__/fixtures/resolve-config/local-config-with-commonjs-export-function.yaml +2 -0
  224. package/src/config/__tests__/fixtures/resolve-config/local-config-with-esm.yaml +2 -0
  225. package/src/config/__tests__/fixtures/resolve-config/plugin-esm.mjs +10 -0
  226. package/src/config/__tests__/fixtures/resolve-config/plugin-with-export-function.cjs +10 -0
  227. package/src/config/__tests__/resolve-plugins.test.ts +4 -1
  228. package/src/config/all.ts +13 -1
  229. package/src/config/builtIn.ts +9 -8
  230. package/src/config/config-resolvers.ts +92 -21
  231. package/src/config/config.ts +31 -13
  232. package/src/config/load.ts +2 -2
  233. package/src/config/minimal.ts +13 -0
  234. package/src/config/recommended-strict.ts +14 -1
  235. package/src/config/recommended.ts +14 -1
  236. package/src/config/rules.ts +12 -4
  237. package/src/config/types.ts +34 -5
  238. package/src/config/utils.ts +28 -2
  239. package/src/decorators/__tests__/filter-in.test.ts +29 -26
  240. package/src/decorators/__tests__/filter-out.test.ts +32 -23
  241. package/src/decorators/__tests__/media-type-examples-override.test.ts +45 -45
  242. package/src/decorators/__tests__/remove-x-internal.test.ts +8 -5
  243. package/src/decorators/async3/index.ts +1 -0
  244. package/src/decorators/common/filters/filter-helper.ts +2 -1
  245. package/src/decorators/common/filters/filter-in.ts +2 -1
  246. package/src/decorators/common/filters/filter-out.ts +2 -1
  247. package/src/decorators/common/info-description-override.ts +3 -2
  248. package/src/decorators/common/info-override.ts +1 -1
  249. package/src/decorators/common/media-type-examples-override.ts +4 -3
  250. package/src/decorators/common/operation-description-override.ts +5 -4
  251. package/src/decorators/common/registry-dependencies.ts +2 -2
  252. package/src/decorators/common/remove-x-internal.ts +5 -4
  253. package/src/decorators/common/tag-description-override.ts +3 -2
  254. package/src/decorators/oas2/__tests__/remove-unused-components.test.ts +3 -3
  255. package/src/decorators/oas2/index.ts +2 -1
  256. package/src/decorators/oas2/remove-unused-components.ts +1 -1
  257. package/src/decorators/oas3/__tests__/remove-unused-components.test.ts +4 -4
  258. package/src/decorators/oas3/index.ts +2 -1
  259. package/src/decorators/oas3/remove-unused-components.ts +1 -1
  260. package/src/format/codeframes.ts +2 -1
  261. package/src/format/format.ts +9 -4
  262. package/src/index.ts +2 -1
  263. package/src/js-yaml/index.ts +3 -1
  264. package/src/lint.ts +28 -4
  265. package/src/logger.ts +2 -2
  266. package/src/oas-types.ts +41 -22
  267. package/src/redocly/domains.ts +1 -1
  268. package/src/redocly/index.ts +3 -3
  269. package/src/redocly/registry-api.ts +5 -3
  270. package/src/ref-utils.ts +4 -2
  271. package/src/resolve.ts +6 -4
  272. package/src/rules/__tests__/no-unresolved-refs.test.ts +21 -7
  273. package/src/rules/ajv.ts +2 -1
  274. package/src/rules/arazzo/__tests__/parameters-no-body-inside-in.test.ts +76 -0
  275. package/src/rules/arazzo/index.ts +6 -3
  276. package/src/rules/async2/__tests__/channels-kebab-case.test.ts +9 -5
  277. package/src/rules/async2/__tests__/no-channel-trailing-slash.test.ts +3 -3
  278. package/src/rules/async2/channels-kebab-case.ts +2 -2
  279. package/src/rules/async2/index.ts +9 -6
  280. package/src/rules/async2/no-channel-trailing-slash.ts +2 -2
  281. package/src/rules/async3/__tests__/channels-kebab-case.test.ts +145 -0
  282. package/src/rules/async3/__tests__/no-channel-trailing-slash.test.ts +96 -0
  283. package/src/rules/async3/channels-kebab-case.ts +19 -0
  284. package/src/rules/async3/index.ts +26 -0
  285. package/src/rules/async3/no-channel-trailing-slash.ts +16 -0
  286. package/src/rules/common/__tests__/info-license-strict.test.ts +141 -0
  287. package/src/rules/common/__tests__/info-license.test.ts +2 -2
  288. package/src/rules/common/__tests__/license-url.test.ts +2 -2
  289. package/src/rules/common/__tests__/no-ambiguous-paths.test.ts +1 -1
  290. package/src/rules/common/__tests__/no-enum-type-mismatch.test.ts +5 -5
  291. package/src/rules/common/__tests__/no-identical-paths.test.ts +1 -1
  292. package/src/rules/common/__tests__/no-invalid-parameter-examples.test.ts +1 -1
  293. package/src/rules/common/__tests__/no-invalid-schema-examples.test.ts +1 -1
  294. package/src/rules/common/__tests__/no-path-trailing-slash.test.ts +4 -4
  295. package/src/rules/common/__tests__/no-required-schema-properties-undefined.test.ts +11 -11
  296. package/src/rules/common/__tests__/operation-2xx-response.test.ts +8 -6
  297. package/src/rules/common/__tests__/operation-4xx-response.test.ts +9 -7
  298. package/src/rules/common/__tests__/operation-operationId-unique.test.ts +2 -2
  299. package/src/rules/common/__tests__/operation-operationId-url-safe.test.ts +1 -1
  300. package/src/rules/common/__tests__/operation-parameters-unique.test.ts +4 -4
  301. package/src/rules/common/__tests__/operation-singular-tag.test.ts +2 -2
  302. package/src/rules/common/__tests__/path-http-verbs-order.test.ts +2 -2
  303. package/src/rules/common/__tests__/path-not-include-query.test.ts +2 -2
  304. package/src/rules/common/__tests__/path-params-defined.test.ts +5 -5
  305. package/src/rules/common/__tests__/paths-kebab-case.test.ts +6 -4
  306. package/src/rules/common/__tests__/scalar-property-missing-example.test.ts +8 -8
  307. package/src/rules/common/__tests__/security-defined.test.ts +14 -8
  308. package/src/rules/common/__tests__/spec-strict-refs.test.ts +1 -1
  309. package/src/rules/common/__tests__/spec.test.ts +10 -10
  310. package/src/rules/common/__tests__/tag-description.test.ts +2 -2
  311. package/src/rules/common/__tests__/tags-alphabetical.test.ts +6 -4
  312. package/src/rules/common/assertions/asserts.ts +5 -9
  313. package/src/rules/common/assertions/index.ts +12 -4
  314. package/src/rules/common/assertions/utils.ts +4 -2
  315. package/src/rules/common/info-contact.ts +2 -1
  316. package/src/rules/common/info-license-strict.ts +24 -0
  317. package/src/rules/common/info-license-url.ts +2 -1
  318. package/src/rules/common/info-license.ts +2 -1
  319. package/src/rules/common/no-ambiguous-paths.ts +4 -4
  320. package/src/rules/common/no-enum-type-mismatch.ts +5 -4
  321. package/src/rules/common/no-http-verbs-in-paths.ts +5 -4
  322. package/src/rules/common/no-identical-paths.ts +4 -4
  323. package/src/rules/common/no-invalid-parameter-examples.ts +3 -2
  324. package/src/rules/common/no-path-trailing-slash.ts +2 -2
  325. package/src/rules/common/no-required-schema-properties-undefined.ts +5 -4
  326. package/src/rules/common/operation-2xx-response.ts +3 -2
  327. package/src/rules/common/operation-4xx-response.ts +3 -2
  328. package/src/rules/common/operation-description.ts +5 -4
  329. package/src/rules/common/operation-operationId-unique.ts +4 -4
  330. package/src/rules/common/operation-operationId-url-safe.ts +5 -4
  331. package/src/rules/common/operation-operationId.ts +5 -4
  332. package/src/rules/common/operation-parameters-unique.ts +4 -4
  333. package/src/rules/common/operation-singular-tag.ts +4 -4
  334. package/src/rules/common/operation-summary.ts +5 -4
  335. package/src/rules/common/operation-tag-defined.ts +4 -4
  336. package/src/rules/common/parameter-description.ts +4 -4
  337. package/src/rules/common/path-declaration-must-exist.ts +2 -2
  338. package/src/rules/common/path-excludes-patterns.ts +4 -4
  339. package/src/rules/common/path-http-verbs-order.ts +4 -4
  340. package/src/rules/common/path-not-include-query.ts +2 -2
  341. package/src/rules/common/path-params-defined.ts +4 -4
  342. package/src/rules/common/path-segment-plural.ts +3 -2
  343. package/src/rules/common/paths-kebab-case.ts +2 -2
  344. package/src/rules/common/required-string-property-missing-min-length.ts +4 -4
  345. package/src/rules/common/response-contains-header.ts +5 -4
  346. package/src/rules/common/scalar-property-missing-example.ts +2 -1
  347. package/src/rules/common/security-defined.ts +5 -5
  348. package/src/rules/common/spec-strict-refs.ts +2 -1
  349. package/src/rules/common/spec.ts +4 -3
  350. package/src/rules/common/tag-description.ts +2 -1
  351. package/src/rules/common/tags-alphabetical.ts +4 -4
  352. package/src/rules/no-unresolved-refs.ts +4 -3
  353. package/src/rules/oas2/__tests__/boolean-parameter-prefixes.test.ts +7 -5
  354. package/src/rules/oas2/__tests__/response-contains-header.test.ts +14 -8
  355. package/src/rules/oas2/__tests__/response-contains-property.test.ts +14 -8
  356. package/src/rules/oas2/__tests__/spec/referenceableScalars.test.ts +3 -1
  357. package/src/rules/oas2/boolean-parameter-prefixes.ts +1 -1
  358. package/src/rules/oas2/index.ts +8 -6
  359. package/src/rules/oas2/request-mime-type.ts +2 -1
  360. package/src/rules/oas2/response-contains-property.ts +3 -2
  361. package/src/rules/oas2/response-mime-type.ts +2 -1
  362. package/src/rules/oas3/__tests__/array-parameter-serialization.test.ts +18 -6
  363. package/src/rules/oas3/__tests__/boolean-parameter-prefixes.test.ts +7 -5
  364. package/src/rules/oas3/__tests__/no-empty-enum-servers.com.test.ts +6 -6
  365. package/src/rules/oas3/__tests__/no-example-value-and-externalValue.test.ts +2 -2
  366. package/src/rules/oas3/__tests__/no-invalid-media-type-examples.test.ts +34 -24
  367. package/src/rules/oas3/__tests__/no-server-example.com.test.ts +3 -3
  368. package/src/rules/oas3/__tests__/no-server-trailing-slash.test.ts +3 -3
  369. package/src/rules/oas3/__tests__/no-unused-components.test.ts +1 -1
  370. package/src/rules/oas3/__tests__/operation-4xx-problem-details-rfc7807.test.ts +3 -3
  371. package/src/rules/oas3/__tests__/response-contains-header.test.ts +34 -22
  372. package/src/rules/oas3/__tests__/response-contains-property.test.ts +34 -20
  373. package/src/rules/oas3/__tests__/spec/spec.test.ts +12 -3
  374. package/src/rules/oas3/__tests__/spec-components-invalid-map-name.test.ts +9 -3
  375. package/src/rules/oas3/__tests__/utils/lint-document-for-test.ts +1 -1
  376. package/src/rules/oas3/array-parameter-serialization.ts +3 -2
  377. package/src/rules/oas3/boolean-parameter-prefixes.ts +1 -1
  378. package/src/rules/oas3/component-name-unique.ts +3 -3
  379. package/src/rules/oas3/index.ts +42 -38
  380. package/src/rules/oas3/no-empty-servers.ts +1 -1
  381. package/src/rules/oas3/no-example-value-and-externalValue.ts +1 -1
  382. package/src/rules/oas3/no-invalid-media-type-examples.ts +6 -4
  383. package/src/rules/oas3/no-server-example.com.ts +2 -1
  384. package/src/rules/oas3/no-server-trailing-slash.ts +1 -1
  385. package/src/rules/oas3/no-server-variables-empty-enum.ts +2 -2
  386. package/src/rules/oas3/no-undefined-server-variable.ts +1 -1
  387. package/src/rules/oas3/no-unused-components.ts +2 -2
  388. package/src/rules/oas3/operation-4xx-problem-details-rfc7807.ts +2 -1
  389. package/src/rules/oas3/request-mime-type.ts +2 -1
  390. package/src/rules/oas3/response-contains-property.ts +3 -2
  391. package/src/rules/oas3/response-mime-type.ts +2 -1
  392. package/src/rules/oas3/spec-components-invalid-map-name.ts +3 -3
  393. package/src/rules/other/stats.ts +8 -6
  394. package/src/rules/spot/parameters-no-body-inside-in.ts +17 -0
  395. package/src/rules/utils.ts +41 -4
  396. package/src/types/arazzo.ts +257 -334
  397. package/src/types/{asyncapi.ts → asyncapi2.ts} +41 -35
  398. package/src/types/asyncapi3.ts +383 -0
  399. package/src/types/json-schema-adapter.ts +2 -2
  400. package/src/types/oas3.ts +4 -4
  401. package/src/types/oas3_1.ts +5 -4
  402. package/src/types/redocly-yaml.ts +21 -4
  403. package/src/typings/arazzo.ts +169 -41
  404. package/src/typings/asyncapi3.ts +61 -0
  405. package/src/typings/common.ts +1 -0
  406. package/src/typings/swagger.ts +2 -2
  407. package/src/utils.ts +5 -3
  408. package/src/visitors.ts +58 -1
  409. package/src/walk.ts +3 -3
  410. package/tsconfig.tsbuildinfo +1 -1
  411. package/lib/types/asyncapi.d.ts +0 -2
@@ -1,13 +1,4 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
2
  Object.defineProperty(exports, "__esModule", { value: true });
12
3
  exports.RedoclyClient = exports.TOKEN_FILENAME = void 0;
13
4
  const fs_1 = require("fs");
@@ -47,10 +38,8 @@ class RedoclyClient {
47
38
  hasToken() {
48
39
  return !!this.accessTokens[this.region];
49
40
  }
50
- getAuthorizationHeader() {
51
- return __awaiter(this, void 0, void 0, function* () {
52
- return this.accessTokens[this.region];
53
- });
41
+ async getAuthorizationHeader() {
42
+ return this.accessTokens[this.region];
54
43
  }
55
44
  // </backward compatibility: portal>
56
45
  setAccessTokens(accessTokens) {
@@ -60,13 +49,19 @@ class RedoclyClient {
60
49
  const credentialsPath = (0, path_1.resolve)((0, os_1.homedir)(), exports.TOKEN_FILENAME);
61
50
  const credentials = this.readCredentialsFile(credentialsPath);
62
51
  if ((0, utils_1.isNotEmptyObject)(credentials)) {
63
- this.setAccessTokens(Object.assign(Object.assign({}, credentials), (credentials.token &&
64
- !credentials[this.region] && {
65
- [this.region]: credentials.token,
66
- })));
52
+ this.setAccessTokens({
53
+ ...credentials,
54
+ ...(credentials.token &&
55
+ !credentials[this.region] && {
56
+ [this.region]: credentials.token,
57
+ }),
58
+ });
67
59
  }
68
60
  if (env_1.env.REDOCLY_AUTHORIZATION) {
69
- this.setAccessTokens(Object.assign(Object.assign({}, this.accessTokens), { [this.region]: env_1.env.REDOCLY_AUTHORIZATION }));
61
+ this.setAccessTokens({
62
+ ...this.accessTokens,
63
+ [this.region]: env_1.env.REDOCLY_AUTHORIZATION,
64
+ });
70
65
  }
71
66
  }
72
67
  getAllTokens() {
@@ -74,65 +69,57 @@ class RedoclyClient {
74
69
  .filter(([region]) => domains_1.AVAILABLE_REGIONS.includes(region))
75
70
  .map(([region, token]) => ({ region, token }));
76
71
  }
77
- getValidTokens() {
78
- return __awaiter(this, void 0, void 0, function* () {
79
- const allTokens = this.getAllTokens();
80
- const verifiedTokens = yield Promise.allSettled(allTokens.map(({ token }) => this.verifyToken(token)));
81
- return allTokens
82
- .filter((_, index) => verifiedTokens[index].status === 'fulfilled')
83
- .map(({ token, region }) => ({ token, region, valid: true }));
84
- });
85
- }
86
- getTokens() {
87
- return __awaiter(this, void 0, void 0, function* () {
88
- return this.hasTokens() ? yield this.getValidTokens() : [];
89
- });
90
- }
91
- isAuthorizedWithRedoclyByRegion() {
92
- return __awaiter(this, void 0, void 0, function* () {
93
- if (!this.hasTokens()) {
94
- return false;
95
- }
96
- const accessToken = this.accessTokens[this.region];
97
- if (!accessToken) {
98
- return false;
99
- }
100
- try {
101
- yield this.verifyToken(accessToken);
102
- return true;
103
- }
104
- catch (err) {
105
- return false;
106
- }
107
- });
108
- }
109
- isAuthorizedWithRedocly() {
110
- return __awaiter(this, void 0, void 0, function* () {
111
- return this.hasTokens() && (0, utils_1.isNotEmptyObject)(yield this.getValidTokens());
112
- });
72
+ async getValidTokens() {
73
+ const allTokens = this.getAllTokens();
74
+ const verifiedTokens = await Promise.allSettled(allTokens.map(({ token }) => this.verifyToken(token)));
75
+ return allTokens
76
+ .filter((_, index) => verifiedTokens[index].status === 'fulfilled')
77
+ .map(({ token, region }) => ({ token, region, valid: true }));
78
+ }
79
+ async getTokens() {
80
+ return this.hasTokens() ? await this.getValidTokens() : [];
81
+ }
82
+ async isAuthorizedWithRedoclyByRegion() {
83
+ if (!this.hasTokens()) {
84
+ return false;
85
+ }
86
+ const accessToken = this.accessTokens[this.region];
87
+ if (!accessToken) {
88
+ return false;
89
+ }
90
+ try {
91
+ await this.verifyToken(accessToken);
92
+ return true;
93
+ }
94
+ catch (err) {
95
+ return false;
96
+ }
97
+ }
98
+ async isAuthorizedWithRedocly() {
99
+ return this.hasTokens() && (0, utils_1.isNotEmptyObject)(await this.getValidTokens());
113
100
  }
114
101
  readCredentialsFile(credentialsPath) {
115
102
  return (0, fs_1.existsSync)(credentialsPath) ? JSON.parse((0, fs_1.readFileSync)(credentialsPath, 'utf-8')) : {};
116
103
  }
117
- verifyToken(accessToken, verbose = false) {
118
- return __awaiter(this, void 0, void 0, function* () {
119
- return this.registryApi.authStatus(accessToken, verbose);
120
- });
121
- }
122
- login(accessToken, verbose = false) {
123
- return __awaiter(this, void 0, void 0, function* () {
124
- const credentialsPath = (0, path_1.resolve)((0, os_1.homedir)(), exports.TOKEN_FILENAME);
125
- try {
126
- yield this.verifyToken(accessToken, verbose);
127
- }
128
- catch (err) {
129
- throw new Error('Authorization failed. Please check if you entered a valid API key.');
130
- }
131
- const credentials = Object.assign(Object.assign({}, this.readCredentialsFile(credentialsPath)), { [this.region]: accessToken, token: accessToken });
132
- this.accessTokens = credentials;
133
- this.registryApi.setAccessTokens(credentials);
134
- (0, fs_1.writeFileSync)(credentialsPath, JSON.stringify(credentials, null, 2));
135
- });
104
+ async verifyToken(accessToken, verbose = false) {
105
+ return this.registryApi.authStatus(accessToken, verbose);
106
+ }
107
+ async login(accessToken, verbose = false) {
108
+ const credentialsPath = (0, path_1.resolve)((0, os_1.homedir)(), exports.TOKEN_FILENAME);
109
+ try {
110
+ await this.verifyToken(accessToken, verbose);
111
+ }
112
+ catch (err) {
113
+ throw new Error('Authorization failed. Please check if you entered a valid API key.');
114
+ }
115
+ const credentials = {
116
+ ...this.readCredentialsFile(credentialsPath),
117
+ [this.region]: accessToken,
118
+ token: accessToken, // FIXME: backward compatibility, remove on 1.0.0
119
+ };
120
+ this.accessTokens = credentials;
121
+ this.registryApi.setAccessTokens(credentials);
122
+ (0, fs_1.writeFileSync)(credentialsPath, JSON.stringify(credentials, null, 2));
136
123
  }
137
124
  logout() {
138
125
  const credentialsPath = (0, path_1.resolve)((0, os_1.homedir)(), exports.TOKEN_FILENAME);
@@ -1,13 +1,4 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
2
  Object.defineProperty(exports, "__esModule", { value: true });
12
3
  exports.RegistryApi = void 0;
13
4
  const node_fetch_1 = require("node-fetch");
@@ -29,86 +20,77 @@ class RegistryApi {
29
20
  this.accessTokens = accessTokens;
30
21
  return this;
31
22
  }
32
- request(path = '', options = {}) {
33
- var _a, _b;
34
- return __awaiter(this, void 0, void 0, function* () {
35
- const currentCommand = typeof process !== 'undefined' ? ((_a = process.env) === null || _a === void 0 ? void 0 : _a.REDOCLY_CLI_COMMAND) || '' : '';
36
- const redoclyEnv = typeof process !== 'undefined' ? ((_b = process.env) === null || _b === void 0 ? void 0 : _b.REDOCLY_ENVIRONMENT) || '' : '';
37
- const headers = Object.assign({}, options.headers || {}, {
38
- 'x-redocly-cli-version': version,
39
- 'user-agent': `redocly-cli / ${version} ${currentCommand} ${redoclyEnv}`,
40
- });
41
- if (!headers.hasOwnProperty('authorization')) {
42
- throw new Error('Unauthorized');
43
- }
44
- const response = yield (0, node_fetch_1.default)(`${this.getBaseUrl()}${path}`, Object.assign({}, options, { headers, agent: (0, utils_1.getProxyAgent)() }));
45
- if (response.status === 401) {
46
- throw new Error('Unauthorized');
47
- }
48
- if (response.status === 404) {
49
- const body = yield response.json();
50
- throw new Error(body.code);
51
- }
52
- return response;
23
+ async request(path = '', options = {}) {
24
+ const currentCommand = typeof process !== 'undefined' ? process.env?.REDOCLY_CLI_COMMAND || '' : '';
25
+ const redoclyEnv = typeof process !== 'undefined' ? process.env?.REDOCLY_ENVIRONMENT || '' : '';
26
+ const headers = Object.assign({}, options.headers || {}, {
27
+ 'x-redocly-cli-version': version,
28
+ 'user-agent': `redocly-cli / ${version} ${currentCommand} ${redoclyEnv}`,
53
29
  });
30
+ if (!headers.hasOwnProperty('authorization')) {
31
+ throw new Error('Unauthorized');
32
+ }
33
+ const response = await (0, node_fetch_1.default)(`${this.getBaseUrl()}${path}`, Object.assign({}, options, { headers, agent: (0, utils_1.getProxyAgent)() }));
34
+ if (response.status === 401) {
35
+ throw new Error('Unauthorized');
36
+ }
37
+ if (response.status === 404) {
38
+ const body = await response.json();
39
+ throw new Error(body.code);
40
+ }
41
+ return response;
54
42
  }
55
- authStatus(accessToken, verbose = false) {
56
- return __awaiter(this, void 0, void 0, function* () {
57
- try {
58
- const response = yield this.request('', { headers: { authorization: accessToken } });
59
- return yield response.json();
60
- }
61
- catch (error) {
62
- if (verbose) {
63
- console.log(error);
64
- }
65
- throw error;
43
+ async authStatus(accessToken, verbose = false) {
44
+ try {
45
+ const response = await this.request('', { headers: { authorization: accessToken } });
46
+ return await response.json();
47
+ }
48
+ catch (error) {
49
+ if (verbose) {
50
+ console.log(error);
66
51
  }
67
- });
52
+ throw error;
53
+ }
68
54
  }
69
- prepareFileUpload({ organizationId, name, version, filesHash, filename, isUpsert, }) {
70
- return __awaiter(this, void 0, void 0, function* () {
71
- const response = yield this.request(`/${organizationId}/${name}/${version}/prepare-file-upload`, {
72
- method: 'POST',
73
- headers: {
74
- 'content-type': 'application/json',
75
- authorization: this.accessToken,
76
- },
77
- body: JSON.stringify({
78
- filesHash,
79
- filename,
80
- isUpsert,
81
- }),
82
- });
83
- if (response.ok) {
84
- return response.json();
85
- }
86
- throw new Error('Could not prepare file upload');
55
+ async prepareFileUpload({ organizationId, name, version, filesHash, filename, isUpsert, }) {
56
+ const response = await this.request(`/${organizationId}/${name}/${version}/prepare-file-upload`, {
57
+ method: 'POST',
58
+ headers: {
59
+ 'content-type': 'application/json',
60
+ authorization: this.accessToken,
61
+ },
62
+ body: JSON.stringify({
63
+ filesHash,
64
+ filename,
65
+ isUpsert,
66
+ }),
87
67
  });
68
+ if (response.ok) {
69
+ return response.json();
70
+ }
71
+ throw new Error('Could not prepare file upload');
88
72
  }
89
- pushApi({ organizationId, name, version, rootFilePath, filePaths, branch, isUpsert, isPublic, batchId, batchSize, }) {
90
- return __awaiter(this, void 0, void 0, function* () {
91
- const response = yield this.request(`/${organizationId}/${name}/${version}`, {
92
- method: 'PUT',
93
- headers: {
94
- 'content-type': 'application/json',
95
- authorization: this.accessToken,
96
- },
97
- body: JSON.stringify({
98
- rootFilePath,
99
- filePaths,
100
- branch,
101
- isUpsert,
102
- isPublic,
103
- batchId,
104
- batchSize,
105
- }),
106
- });
107
- if (response.ok) {
108
- return;
109
- }
110
- throw new Error('Could not push api');
73
+ async pushApi({ organizationId, name, version, rootFilePath, filePaths, branch, isUpsert, isPublic, batchId, batchSize, }) {
74
+ const response = await this.request(`/${organizationId}/${name}/${version}`, {
75
+ method: 'PUT',
76
+ headers: {
77
+ 'content-type': 'application/json',
78
+ authorization: this.accessToken,
79
+ },
80
+ body: JSON.stringify({
81
+ rootFilePath,
82
+ filePaths,
83
+ branch,
84
+ isUpsert,
85
+ isPublic,
86
+ batchId,
87
+ batchSize,
88
+ }),
111
89
  });
90
+ if (response.ok) {
91
+ return;
92
+ }
93
+ throw new Error('Could not push api');
112
94
  }
113
95
  }
114
96
  exports.RegistryApi = RegistryApi;
@@ -1,5 +1,5 @@
1
- import { Source } from './resolve';
2
- import { OasRef } from './typings/openapi';
1
+ import type { Source } from './resolve';
2
+ import type { OasRef } from './typings/openapi';
3
3
  export declare function joinPointer(base: string, key: string | number): string;
4
4
  export declare function isRef(node: any): node is OasRef;
5
5
  export declare class Location {
package/lib/ref-utils.js CHANGED
@@ -1,17 +1,26 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.isAnchor = exports.isMappingRef = exports.isAbsoluteUrl = exports.refBaseName = exports.pointerBaseName = exports.parsePointer = exports.parseRef = exports.escapePointer = exports.unescapePointer = exports.Location = exports.isRef = exports.joinPointer = void 0;
3
+ exports.Location = void 0;
4
+ exports.joinPointer = joinPointer;
5
+ exports.isRef = isRef;
6
+ exports.unescapePointer = unescapePointer;
7
+ exports.escapePointer = escapePointer;
8
+ exports.parseRef = parseRef;
9
+ exports.parsePointer = parsePointer;
10
+ exports.pointerBaseName = pointerBaseName;
11
+ exports.refBaseName = refBaseName;
12
+ exports.isAbsoluteUrl = isAbsoluteUrl;
13
+ exports.isMappingRef = isMappingRef;
14
+ exports.isAnchor = isAnchor;
4
15
  const utils_1 = require("./utils");
5
16
  function joinPointer(base, key) {
6
17
  if (base === '')
7
18
  base = '#/';
8
19
  return base[base.length - 1] === '/' ? base + key : base + '/' + key;
9
20
  }
10
- exports.joinPointer = joinPointer;
11
21
  function isRef(node) {
12
22
  return node && typeof node.$ref === 'string';
13
23
  }
14
- exports.isRef = isRef;
15
24
  class Location {
16
25
  constructor(source, pointer) {
17
26
  this.source = source;
@@ -21,7 +30,7 @@ class Location {
21
30
  return new Location(this.source, joinPointer(this.pointer, (Array.isArray(components) ? components : [components]).map(escapePointer).join('/')));
22
31
  }
23
32
  key() {
24
- return Object.assign(Object.assign({}, this), { reportOnKey: true });
33
+ return { ...this, reportOnKey: true };
25
34
  }
26
35
  get absolutePointer() {
27
36
  return this.source.absoluteRef + (this.pointer === '#/' ? '' : this.pointer);
@@ -31,13 +40,11 @@ exports.Location = Location;
31
40
  function unescapePointer(fragment) {
32
41
  return decodeURIComponent(fragment.replace(/~1/g, '/').replace(/~0/g, '~'));
33
42
  }
34
- exports.unescapePointer = unescapePointer;
35
43
  function escapePointer(fragment) {
36
44
  if (typeof fragment === 'number')
37
45
  return fragment;
38
46
  return fragment.replace(/~/g, '~0').replace(/\//g, '~1');
39
47
  }
40
- exports.escapePointer = escapePointer;
41
48
  function parseRef(ref) {
42
49
  const [uri, pointer = ''] = ref.split('#/');
43
50
  return {
@@ -45,25 +52,21 @@ function parseRef(ref) {
45
52
  pointer: parsePointer(pointer),
46
53
  };
47
54
  }
48
- exports.parseRef = parseRef;
49
55
  function parsePointer(pointer) {
50
56
  return pointer.split('/').map(unescapePointer).filter(utils_1.isTruthy);
51
57
  }
52
- exports.parsePointer = parsePointer;
53
58
  function pointerBaseName(pointer) {
54
59
  const parts = pointer.split('/');
55
60
  return parts[parts.length - 1];
56
61
  }
57
- exports.pointerBaseName = pointerBaseName;
58
62
  function refBaseName(ref) {
63
+ // eslint-disable-next-line no-useless-escape
59
64
  const parts = ref.split(/[\/\\]/); // split by '\' and '/'
60
65
  return parts[parts.length - 1].replace(/\.[^.]+$/, ''); // replace extension with empty string
61
66
  }
62
- exports.refBaseName = refBaseName;
63
67
  function isAbsoluteUrl(ref) {
64
68
  return ref.startsWith('http://') || ref.startsWith('https://');
65
69
  }
66
- exports.isAbsoluteUrl = isAbsoluteUrl;
67
70
  function isMappingRef(mapping) {
68
71
  // TODO: proper detection of mapping refs
69
72
  return (mapping.startsWith('#') ||
@@ -73,8 +76,6 @@ function isMappingRef(mapping) {
73
76
  mapping.startsWith('../') ||
74
77
  mapping.indexOf('/') > -1);
75
78
  }
76
- exports.isMappingRef = isMappingRef;
77
79
  function isAnchor(ref) {
78
80
  return /^#[A-Za-z][A-Za-z0-9\-_:.]*$/.test(ref);
79
81
  }
80
- exports.isAnchor = isAnchor;
package/lib/resolve.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import type { YAMLNode, LoadOptions } from 'yaml-ast-parser';
2
- import { NormalizedNodeType } from './types';
3
- import { ResolveConfig } from './config/types';
2
+ import type { NormalizedNodeType } from './types';
3
+ import type { ResolveConfig } from './config/types';
4
4
  export type CollectedRefs = Map<string, Document>;
5
5
  export declare class Source {
6
6
  absoluteRef: string;