@redocly/openapi-core 1.0.0-beta.98 → 1.0.0-rc.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 (380) hide show
  1. package/README.md +6 -6
  2. package/lib/benchmark/benches/lint-with-top-level-rule-report.bench.js +0 -1
  3. package/lib/benchmark/benches/recommended-oas3.bench.js +1 -1
  4. package/lib/benchmark/benches/resolve-with-no-external.bench.js +1 -1
  5. package/lib/benchmark/utils.d.ts +2 -2
  6. package/lib/benchmark/utils.js +2 -2
  7. package/lib/bundle.d.ts +12 -15
  8. package/lib/bundle.js +38 -15
  9. package/lib/config/all.d.ts +2 -2
  10. package/lib/config/all.js +17 -6
  11. package/lib/config/builtIn.d.ts +2 -2
  12. package/lib/config/builtIn.js +2 -2
  13. package/lib/config/config-resolvers.d.ts +5 -5
  14. package/lib/config/config-resolvers.js +121 -66
  15. package/lib/config/config.d.ts +12 -18
  16. package/lib/config/config.js +42 -26
  17. package/lib/config/load.d.ts +16 -3
  18. package/lib/config/load.js +36 -14
  19. package/lib/config/minimal.d.ts +2 -2
  20. package/lib/config/minimal.js +10 -6
  21. package/lib/config/recommended.d.ts +2 -2
  22. package/lib/config/recommended.js +10 -6
  23. package/lib/config/rules.d.ts +7 -4
  24. package/lib/config/rules.js +5 -4
  25. package/lib/config/types.d.ts +72 -23
  26. package/lib/config/types.js +13 -0
  27. package/lib/config/utils.d.ts +6 -5
  28. package/lib/config/utils.js +110 -32
  29. package/lib/decorators/common/filters/filter-helper.d.ts +3 -0
  30. package/lib/decorators/common/filters/filter-helper.js +67 -0
  31. package/lib/decorators/common/filters/filter-in.d.ts +2 -0
  32. package/lib/decorators/common/filters/filter-in.js +17 -0
  33. package/lib/decorators/common/filters/filter-out.d.ts +2 -0
  34. package/lib/decorators/common/filters/filter-out.js +17 -0
  35. package/lib/decorators/common/info-override.d.ts +2 -0
  36. package/lib/decorators/common/info-override.js +28 -0
  37. package/lib/decorators/common/media-type-examples-override.d.ts +2 -0
  38. package/lib/decorators/common/media-type-examples-override.js +53 -0
  39. package/lib/decorators/common/registry-dependencies.js +2 -2
  40. package/lib/decorators/common/remove-x-internal.js +2 -2
  41. package/lib/decorators/oas2/index.d.ts +3 -0
  42. package/lib/decorators/oas2/index.js +7 -1
  43. package/lib/decorators/oas3/index.d.ts +4 -0
  44. package/lib/decorators/oas3/index.js +9 -1
  45. package/lib/env.d.ts +3 -0
  46. package/lib/env.js +8 -0
  47. package/lib/format/codeframes.js +16 -10
  48. package/lib/format/format.d.ts +1 -1
  49. package/lib/format/format.js +64 -32
  50. package/lib/index.d.ts +6 -6
  51. package/lib/index.js +7 -2
  52. package/lib/js-yaml/index.js +2 -6
  53. package/lib/lint.d.ts +4 -2
  54. package/lib/lint.js +36 -11
  55. package/lib/logger.d.ts +10 -0
  56. package/lib/logger.js +31 -0
  57. package/lib/output.d.ts +3 -0
  58. package/lib/output.js +9 -0
  59. package/lib/redocly/index.js +10 -9
  60. package/lib/redocly/registry-api-types.d.ts +28 -28
  61. package/lib/redocly/registry-api.d.ts +3 -3
  62. package/lib/redocly/registry-api.js +10 -2
  63. package/lib/ref-utils.d.ts +1 -0
  64. package/lib/ref-utils.js +8 -2
  65. package/lib/resolve.d.ts +1 -1
  66. package/lib/resolve.js +33 -3
  67. package/lib/rules/ajv.d.ts +2 -2
  68. package/lib/rules/ajv.js +12 -12
  69. package/lib/rules/common/assertions/asserts.d.ts +29 -4
  70. package/lib/rules/common/assertions/asserts.js +227 -97
  71. package/lib/rules/common/assertions/index.d.ts +27 -2
  72. package/lib/rules/common/assertions/index.js +9 -37
  73. package/lib/rules/common/assertions/utils.d.ts +16 -8
  74. package/lib/rules/common/assertions/utils.js +160 -76
  75. package/lib/rules/common/info-license-url.d.ts +1 -1
  76. package/lib/rules/common/info-license-url.js +5 -10
  77. package/lib/rules/common/info-license.d.ts +2 -0
  78. package/lib/rules/common/info-license.js +17 -0
  79. package/lib/rules/common/no-ambiguous-paths.js +1 -1
  80. package/lib/rules/common/no-enum-type-mismatch.js +1 -3
  81. package/lib/rules/common/no-identical-paths.js +4 -4
  82. package/lib/rules/common/no-invalid-parameter-examples.js +3 -3
  83. package/lib/rules/common/no-invalid-schema-examples.js +3 -3
  84. package/lib/rules/common/operation-2xx-response.js +15 -9
  85. package/lib/rules/common/operation-4xx-response.js +15 -9
  86. package/lib/rules/common/operation-operationId.js +2 -2
  87. package/lib/rules/common/operation-tag-defined.js +1 -1
  88. package/lib/rules/common/path-not-include-query.js +2 -2
  89. package/lib/rules/common/path-params-defined.js +7 -2
  90. package/lib/rules/common/paths-kebab-case.js +4 -1
  91. package/lib/rules/common/required-string-property-missing-min-length.d.ts +2 -0
  92. package/lib/rules/common/required-string-property-missing-min-length.js +37 -0
  93. package/lib/rules/common/response-contains-header.d.ts +2 -0
  94. package/lib/rules/common/response-contains-header.js +29 -0
  95. package/lib/rules/common/scalar-property-missing-example.d.ts +2 -0
  96. package/lib/rules/common/scalar-property-missing-example.js +42 -0
  97. package/lib/rules/common/security-defined.d.ts +2 -0
  98. package/lib/rules/common/{operation-security-defined.js → security-defined.js} +25 -6
  99. package/lib/rules/common/spec-strict-refs.d.ts +2 -0
  100. package/lib/rules/common/spec-strict-refs.js +30 -0
  101. package/lib/rules/common/spec.js +41 -18
  102. package/lib/rules/common/tags-alphabetical.js +1 -1
  103. package/lib/rules/oas2/index.d.ts +6 -2
  104. package/lib/rules/oas2/index.js +16 -8
  105. package/lib/rules/oas2/remove-unused-components.js +6 -6
  106. package/lib/rules/oas2/request-mime-type.d.ts +1 -1
  107. package/lib/rules/oas2/request-mime-type.js +1 -1
  108. package/lib/rules/oas2/response-contains-property.d.ts +2 -0
  109. package/lib/rules/oas2/response-contains-property.js +38 -0
  110. package/lib/rules/oas2/response-mime-type.d.ts +1 -1
  111. package/lib/rules/oas2/response-mime-type.js +1 -1
  112. package/lib/rules/oas3/component-name-unique.d.ts +2 -0
  113. package/lib/rules/oas3/component-name-unique.js +124 -0
  114. package/lib/rules/oas3/index.js +24 -10
  115. package/lib/rules/oas3/no-empty-servers.js +2 -2
  116. package/lib/rules/oas3/no-invalid-media-type-examples.js +2 -2
  117. package/lib/rules/oas3/no-server-variables-empty-enum.d.ts +2 -0
  118. package/lib/rules/oas3/{no-servers-empty-enum.js → no-server-variables-empty-enum.js} +5 -5
  119. package/lib/rules/oas3/no-unused-components.js +2 -2
  120. package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.d.ts +5 -0
  121. package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.js +36 -0
  122. package/lib/rules/oas3/remove-unused-components.js +6 -6
  123. package/lib/rules/oas3/request-mime-type.d.ts +1 -1
  124. package/lib/rules/oas3/request-mime-type.js +1 -1
  125. package/lib/rules/oas3/response-contains-property.d.ts +2 -0
  126. package/lib/rules/oas3/response-contains-property.js +40 -0
  127. package/lib/rules/oas3/response-mime-type.d.ts +1 -1
  128. package/lib/rules/oas3/response-mime-type.js +1 -1
  129. package/lib/rules/oas3/spec-components-invalid-map-name.d.ts +2 -0
  130. package/lib/rules/oas3/spec-components-invalid-map-name.js +62 -0
  131. package/lib/rules/other/stats.d.ts +2 -2
  132. package/lib/rules/other/stats.js +45 -16
  133. package/lib/rules/utils.d.ts +5 -2
  134. package/lib/rules/utils.js +54 -6
  135. package/lib/types/config-external-schemas.d.ts +2193 -0
  136. package/lib/types/config-external-schemas.js +805 -0
  137. package/lib/types/index.d.ts +3 -2
  138. package/lib/types/index.js +9 -1
  139. package/lib/types/oas2.js +91 -15
  140. package/lib/types/oas3.js +139 -49
  141. package/lib/types/oas3_1.js +32 -26
  142. package/lib/types/redocly-yaml.js +414 -58
  143. package/lib/typings/openapi.d.ts +3 -2
  144. package/lib/utils.d.ts +15 -3
  145. package/lib/utils.js +73 -7
  146. package/lib/visitors.d.ts +20 -16
  147. package/lib/visitors.js +28 -3
  148. package/lib/walk.d.ts +11 -19
  149. package/lib/walk.js +74 -53
  150. package/package.json +5 -6
  151. package/__tests__/__snapshots__/bundle.test.ts.snap +0 -229
  152. package/__tests__/bundle.test.ts +0 -132
  153. package/__tests__/codeframes.test.ts +0 -531
  154. package/__tests__/fixtures/extension.js +0 -24
  155. package/__tests__/fixtures/refs/definitions.yaml +0 -3
  156. package/__tests__/fixtures/refs/examples.yaml +0 -8
  157. package/__tests__/fixtures/refs/external-request-body.yaml +0 -13
  158. package/__tests__/fixtures/refs/externalref.yaml +0 -35
  159. package/__tests__/fixtures/refs/hosted.yaml +0 -35
  160. package/__tests__/fixtures/refs/openapi-with-external-refs-conflicting-names.yaml +0 -21
  161. package/__tests__/fixtures/refs/openapi-with-external-refs.yaml +0 -33
  162. package/__tests__/fixtures/refs/param-b.yaml +0 -1
  163. package/__tests__/fixtures/refs/param-c.yaml +0 -1
  164. package/__tests__/fixtures/refs/rename.yaml +0 -1
  165. package/__tests__/fixtures/refs/requestBody.yaml +0 -9
  166. package/__tests__/fixtures/refs/schema-a.yaml +0 -1
  167. package/__tests__/fixtures/refs/simple.yaml +0 -1
  168. package/__tests__/fixtures/refs/vendor.schema.yaml +0 -20
  169. package/__tests__/fixtures/resolve/External.yaml +0 -10
  170. package/__tests__/fixtures/resolve/External2.yaml +0 -4
  171. package/__tests__/fixtures/resolve/description.md +0 -3
  172. package/__tests__/fixtures/resolve/externalInfo.yaml +0 -4
  173. package/__tests__/fixtures/resolve/externalLicense.yaml +0 -1
  174. package/__tests__/fixtures/resolve/openapi-with-back.yaml +0 -13
  175. package/__tests__/fixtures/resolve/openapi-with-md-description.yaml +0 -5
  176. package/__tests__/fixtures/resolve/openapi.yaml +0 -28
  177. package/__tests__/fixtures/resolve/schemas/type-a.yaml +0 -10
  178. package/__tests__/fixtures/resolve/schemas/type-b.yaml +0 -6
  179. package/__tests__/fixtures/resolve/transitive/a.yaml +0 -1
  180. package/__tests__/fixtures/resolve/transitive/components.yaml +0 -5
  181. package/__tests__/fixtures/resolve/transitive/schemas.yaml +0 -3
  182. package/__tests__/lint.test.ts +0 -17
  183. package/__tests__/login.test.ts +0 -17
  184. package/__tests__/normalizeVisitors.test.ts +0 -151
  185. package/__tests__/ref-utils.test.ts +0 -120
  186. package/__tests__/resolve-http.test.ts +0 -77
  187. package/__tests__/resolve.test.ts +0 -405
  188. package/__tests__/utils.ts +0 -86
  189. package/__tests__/walk.test.ts +0 -1485
  190. package/lib/rules/common/info-description.d.ts +0 -2
  191. package/lib/rules/common/info-description.js +0 -12
  192. package/lib/rules/common/license-url.d.ts +0 -2
  193. package/lib/rules/common/license-url.js +0 -12
  194. package/lib/rules/common/operation-security-defined.d.ts +0 -2
  195. package/lib/rules/oas3/no-servers-empty-enum.d.ts +0 -2
  196. package/src/__tests__/js-yaml.test.ts +0 -71
  197. package/src/__tests__/lint.test.ts +0 -182
  198. package/src/__tests__/utils.test.ts +0 -74
  199. package/src/benchmark/benches/lint-with-many-rules.bench.ts +0 -35
  200. package/src/benchmark/benches/lint-with-nested-rule.bench.ts +0 -39
  201. package/src/benchmark/benches/lint-with-no-rules.bench.ts +0 -20
  202. package/src/benchmark/benches/lint-with-top-level-rule-report.bench.ts +0 -36
  203. package/src/benchmark/benches/lint-with-top-level-rule.bench.ts +0 -32
  204. package/src/benchmark/benches/rebilly.yaml +0 -32267
  205. package/src/benchmark/benches/recommended-oas3.bench.ts +0 -22
  206. package/src/benchmark/benches/resolve-with-no-external.bench.ts +0 -23
  207. package/src/benchmark/benchmark.js +0 -307
  208. package/src/benchmark/colors.js +0 -29
  209. package/src/benchmark/fork.js +0 -83
  210. package/src/benchmark/utils.ts +0 -36
  211. package/src/bundle.ts +0 -371
  212. package/src/config/__tests__/__snapshots__/config-resolvers.test.ts.snap +0 -157
  213. package/src/config/__tests__/config-resolvers.test.ts +0 -429
  214. package/src/config/__tests__/config.test.ts +0 -244
  215. package/src/config/__tests__/fixtures/plugin-config.yaml +0 -3
  216. package/src/config/__tests__/fixtures/plugin.js +0 -56
  217. package/src/config/__tests__/fixtures/resolve-config/api/nested-config.yaml +0 -12
  218. package/src/config/__tests__/fixtures/resolve-config/api/plugin.js +0 -67
  219. package/src/config/__tests__/fixtures/resolve-config/local-config-with-circular.yaml +0 -8
  220. package/src/config/__tests__/fixtures/resolve-config/local-config-with-file.yaml +0 -19
  221. package/src/config/__tests__/fixtures/resolve-config/local-config.yaml +0 -10
  222. package/src/config/__tests__/fixtures/resolve-config/plugin.js +0 -66
  223. package/src/config/__tests__/fixtures/resolve-remote-configs/nested-remote-config.yaml +0 -4
  224. package/src/config/__tests__/fixtures/resolve-remote-configs/remote-config.yaml +0 -5
  225. package/src/config/__tests__/load.test.ts +0 -83
  226. package/src/config/__tests__/resolve-plugins.test.ts +0 -27
  227. package/src/config/all.ts +0 -65
  228. package/src/config/builtIn.ts +0 -37
  229. package/src/config/config-resolvers.ts +0 -359
  230. package/src/config/config.ts +0 -312
  231. package/src/config/index.ts +0 -7
  232. package/src/config/load.ts +0 -84
  233. package/src/config/minimal.ts +0 -58
  234. package/src/config/recommended.ts +0 -58
  235. package/src/config/rules.ts +0 -46
  236. package/src/config/types.ts +0 -168
  237. package/src/config/utils.ts +0 -208
  238. package/src/decorators/__tests__/remove-x-internal.test.ts +0 -316
  239. package/src/decorators/common/info-description-override.ts +0 -24
  240. package/src/decorators/common/operation-description-override.ts +0 -30
  241. package/src/decorators/common/registry-dependencies.ts +0 -25
  242. package/src/decorators/common/remove-x-internal.ts +0 -59
  243. package/src/decorators/common/tag-description-override.ts +0 -25
  244. package/src/decorators/oas2/index.ts +0 -14
  245. package/src/decorators/oas3/index.ts +0 -14
  246. package/src/format/codeframes.ts +0 -210
  247. package/src/format/format.ts +0 -339
  248. package/src/index.ts +0 -68
  249. package/src/js-yaml/index.ts +0 -18
  250. package/src/lint.ts +0 -125
  251. package/src/oas-types.ts +0 -62
  252. package/src/redocly/__tests__/redocly-client.test.ts +0 -140
  253. package/src/redocly/index.ts +0 -182
  254. package/src/redocly/redocly-client-types.ts +0 -10
  255. package/src/redocly/registry-api-types.ts +0 -32
  256. package/src/redocly/registry-api.ts +0 -134
  257. package/src/ref-utils.ts +0 -79
  258. package/src/resolve.ts +0 -378
  259. package/src/rules/__tests__/fixtures/invalid-yaml.yaml +0 -1
  260. package/src/rules/__tests__/fixtures/ref.yaml +0 -1
  261. package/src/rules/__tests__/no-unresolved-refs.test.ts +0 -168
  262. package/src/rules/ajv.ts +0 -103
  263. package/src/rules/common/__tests__/info-description.test.ts +0 -102
  264. package/src/rules/common/__tests__/info-license.test.ts +0 -62
  265. package/src/rules/common/__tests__/license-url.test.ts +0 -63
  266. package/src/rules/common/__tests__/no-ambiguous-paths.test.ts +0 -96
  267. package/src/rules/common/__tests__/no-enum-type-mismatch.test.ts +0 -209
  268. package/src/rules/common/__tests__/no-identical-paths.test.ts +0 -58
  269. package/src/rules/common/__tests__/no-path-trailing-slash.test.ts +0 -85
  270. package/src/rules/common/__tests__/operation-2xx-response.test.ts +0 -91
  271. package/src/rules/common/__tests__/operation-4xx-response.test.ts +0 -107
  272. package/src/rules/common/__tests__/operation-operationId-unique.test.ts +0 -76
  273. package/src/rules/common/__tests__/operation-operationId-url-safe.test.ts +0 -45
  274. package/src/rules/common/__tests__/operation-parameters-unique.test.ts +0 -167
  275. package/src/rules/common/__tests__/operation-security-defined.test.ts +0 -69
  276. package/src/rules/common/__tests__/operation-singular-tag.test.ts +0 -72
  277. package/src/rules/common/__tests__/path-http-verbs-order.test.ts +0 -95
  278. package/src/rules/common/__tests__/path-not-include-query.test.ts +0 -64
  279. package/src/rules/common/__tests__/path-params-defined.test.ts +0 -133
  280. package/src/rules/common/__tests__/paths-kebab-case.test.ts +0 -108
  281. package/src/rules/common/__tests__/spec.test.ts +0 -62
  282. package/src/rules/common/__tests__/tag-description.test.ts +0 -65
  283. package/src/rules/common/__tests__/tags-alphabetical.test.ts +0 -64
  284. package/src/rules/common/assertions/__tests__/asserts.test.ts +0 -231
  285. package/src/rules/common/assertions/__tests__/index.test.ts +0 -65
  286. package/src/rules/common/assertions/__tests__/utils.test.ts +0 -89
  287. package/src/rules/common/assertions/asserts.ts +0 -137
  288. package/src/rules/common/assertions/index.ts +0 -75
  289. package/src/rules/common/assertions/utils.ts +0 -167
  290. package/src/rules/common/info-contact.ts +0 -15
  291. package/src/rules/common/info-description.ts +0 -10
  292. package/src/rules/common/info-license-url.ts +0 -15
  293. package/src/rules/common/license-url.ts +0 -10
  294. package/src/rules/common/no-ambiguous-paths.ts +0 -50
  295. package/src/rules/common/no-enum-type-mismatch.ts +0 -49
  296. package/src/rules/common/no-http-verbs-in-paths.ts +0 -36
  297. package/src/rules/common/no-identical-paths.ts +0 -24
  298. package/src/rules/common/no-invalid-parameter-examples.ts +0 -36
  299. package/src/rules/common/no-invalid-schema-examples.ts +0 -27
  300. package/src/rules/common/no-path-trailing-slash.ts +0 -15
  301. package/src/rules/common/operation-2xx-response.ts +0 -16
  302. package/src/rules/common/operation-4xx-response.ts +0 -17
  303. package/src/rules/common/operation-description.ts +0 -13
  304. package/src/rules/common/operation-operationId-unique.ts +0 -21
  305. package/src/rules/common/operation-operationId-url-safe.ts +0 -19
  306. package/src/rules/common/operation-operationId.ts +0 -17
  307. package/src/rules/common/operation-parameters-unique.ts +0 -48
  308. package/src/rules/common/operation-security-defined.ts +0 -45
  309. package/src/rules/common/operation-singular-tag.ts +0 -17
  310. package/src/rules/common/operation-summary.ts +0 -13
  311. package/src/rules/common/operation-tag-defined.ts +0 -26
  312. package/src/rules/common/parameter-description.ts +0 -22
  313. package/src/rules/common/path-declaration-must-exist.ts +0 -15
  314. package/src/rules/common/path-excludes-patterns.ts +0 -23
  315. package/src/rules/common/path-http-verbs-order.ts +0 -30
  316. package/src/rules/common/path-not-include-query.ts +0 -17
  317. package/src/rules/common/path-params-defined.ts +0 -58
  318. package/src/rules/common/path-segment-plural.ts +0 -31
  319. package/src/rules/common/paths-kebab-case.ts +0 -16
  320. package/src/rules/common/spec.ts +0 -143
  321. package/src/rules/common/tag-description.ts +0 -10
  322. package/src/rules/common/tags-alphabetical.ts +0 -20
  323. package/src/rules/no-unresolved-refs.ts +0 -51
  324. package/src/rules/oas2/__tests__/boolean-parameter-prefixes.test.ts +0 -110
  325. package/src/rules/oas2/__tests__/spec/fixtures/description.md +0 -1
  326. package/src/rules/oas2/__tests__/spec/info.test.ts +0 -355
  327. package/src/rules/oas2/__tests__/spec/operation.test.ts +0 -123
  328. package/src/rules/oas2/__tests__/spec/paths.test.ts +0 -245
  329. package/src/rules/oas2/__tests__/spec/referenceableScalars.test.ts +0 -31
  330. package/src/rules/oas2/__tests__/spec/utils.ts +0 -32
  331. package/src/rules/oas2/boolean-parameter-prefixes.ts +0 -26
  332. package/src/rules/oas2/index.ts +0 -83
  333. package/src/rules/oas2/remove-unused-components.ts +0 -76
  334. package/src/rules/oas2/request-mime-type.ts +0 -17
  335. package/src/rules/oas2/response-mime-type.ts +0 -17
  336. package/src/rules/oas3/__tests__/boolean-parameter-prefixes.test.ts +0 -111
  337. package/src/rules/oas3/__tests__/fixtures/common.yaml +0 -11
  338. package/src/rules/oas3/__tests__/no-empty-enum-servers.com.test.ts +0 -205
  339. package/src/rules/oas3/__tests__/no-example-value-and-externalValue.test.ts +0 -65
  340. package/src/rules/oas3/__tests__/no-invalid-media-type-examples.test.ts +0 -392
  341. package/src/rules/oas3/__tests__/no-server-example.com.test.ts +0 -60
  342. package/src/rules/oas3/__tests__/no-server-trailing-slash.test.ts +0 -79
  343. package/src/rules/oas3/__tests__/no-unused-components.test.ts +0 -131
  344. package/src/rules/oas3/__tests__/spec/callbacks.test.ts +0 -41
  345. package/src/rules/oas3/__tests__/spec/fixtures/description.md +0 -1
  346. package/src/rules/oas3/__tests__/spec/info.test.ts +0 -391
  347. package/src/rules/oas3/__tests__/spec/operation.test.ts +0 -253
  348. package/src/rules/oas3/__tests__/spec/paths.test.ts +0 -284
  349. package/src/rules/oas3/__tests__/spec/referenceableScalars.test.ts +0 -77
  350. package/src/rules/oas3/__tests__/spec/servers.test.ts +0 -499
  351. package/src/rules/oas3/__tests__/spec/spec.test.ts +0 -288
  352. package/src/rules/oas3/__tests__/spec/utils.ts +0 -32
  353. package/src/rules/oas3/boolean-parameter-prefixes.ts +0 -28
  354. package/src/rules/oas3/index.ts +0 -99
  355. package/src/rules/oas3/no-empty-servers.ts +0 -22
  356. package/src/rules/oas3/no-example-value-and-externalValue.ts +0 -14
  357. package/src/rules/oas3/no-invalid-media-type-examples.ts +0 -41
  358. package/src/rules/oas3/no-server-example.com.ts +0 -14
  359. package/src/rules/oas3/no-server-trailing-slash.ts +0 -15
  360. package/src/rules/oas3/no-servers-empty-enum.ts +0 -67
  361. package/src/rules/oas3/no-undefined-server-variable.ts +0 -30
  362. package/src/rules/oas3/no-unused-components.ts +0 -75
  363. package/src/rules/oas3/remove-unused-components.ts +0 -84
  364. package/src/rules/oas3/request-mime-type.ts +0 -31
  365. package/src/rules/oas3/response-mime-type.ts +0 -31
  366. package/src/rules/other/stats.ts +0 -44
  367. package/src/rules/utils.ts +0 -123
  368. package/src/types/index.ts +0 -138
  369. package/src/types/oas2.ts +0 -397
  370. package/src/types/oas3.ts +0 -506
  371. package/src/types/oas3_1.ts +0 -251
  372. package/src/types/redocly-yaml.ts +0 -637
  373. package/src/typings/common.ts +0 -9
  374. package/src/typings/openapi.ts +0 -297
  375. package/src/typings/swagger.ts +0 -236
  376. package/src/utils.ts +0 -190
  377. package/src/visitors.ts +0 -448
  378. package/src/walk.ts +0 -416
  379. package/tsconfig.json +0 -8
  380. package/tsconfig.tsbuildinfo +0 -1
@@ -1,392 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { lintDocument } from '../../../lint';
3
- import { parseYamlToDocument, replaceSourceWithRef, makeConfig } from '../../../../__tests__/utils';
4
- import { BaseResolver } from '../../../resolve';
5
-
6
- describe('no-invalid-media-type-examples', () => {
7
- it('should report on invalid example', async () => {
8
- const document = parseYamlToDocument(
9
- outdent`
10
- openapi: 3.0.0
11
- paths:
12
- /pet:
13
- get:
14
- responses:
15
- 200:
16
- content:
17
- application/json:
18
- example:
19
- a: 13
20
- b: "string"
21
- schema:
22
- type: object
23
- properties:
24
- a:
25
- type: string
26
- b:
27
- type: number
28
-
29
- `,
30
- 'foobar.yaml',
31
- );
32
-
33
- const results = await lintDocument({
34
- externalRefResolver: new BaseResolver(),
35
- document,
36
- config: await makeConfig({ 'no-invalid-media-type-examples': 'error' }),
37
- });
38
-
39
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`
40
- Array [
41
- Object {
42
- "from": Object {
43
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json",
44
- "source": "foobar.yaml",
45
- },
46
- "location": Array [
47
- Object {
48
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json/example/a",
49
- "reportOnKey": false,
50
- "source": "foobar.yaml",
51
- },
52
- ],
53
- "message": "Example value must conform to the schema: \`a\` property type must be string.",
54
- "ruleId": "no-invalid-media-type-examples",
55
- "severity": "error",
56
- "suggest": Array [],
57
- },
58
- Object {
59
- "from": Object {
60
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json",
61
- "source": "foobar.yaml",
62
- },
63
- "location": Array [
64
- Object {
65
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json/example/b",
66
- "reportOnKey": false,
67
- "source": "foobar.yaml",
68
- },
69
- ],
70
- "message": "Example value must conform to the schema: \`b\` property type must be number.",
71
- "ruleId": "no-invalid-media-type-examples",
72
- "severity": "error",
73
- "suggest": Array [],
74
- },
75
- ]
76
- `);
77
- });
78
-
79
- it('should report on invalid example with disallowAdditionalProperties', async () => {
80
- const document = parseYamlToDocument(
81
- outdent`
82
- openapi: 3.0.0
83
- paths:
84
- /pet:
85
- get:
86
- responses:
87
- 200:
88
- content:
89
- application/json:
90
- example:
91
- a: "string"
92
- b: 13
93
- c: unknown
94
- schema:
95
- type: object
96
- properties:
97
- a:
98
- type: string
99
- b:
100
- type: number
101
-
102
- `,
103
- 'foobar.yaml',
104
- );
105
-
106
- const results = await lintDocument({
107
- externalRefResolver: new BaseResolver(),
108
- document,
109
- config: await makeConfig({
110
- 'no-invalid-media-type-examples': {
111
- severity: 'error',
112
- disallowAdditionalProperties: true,
113
- },
114
- }),
115
- });
116
-
117
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`
118
- Array [
119
- Object {
120
- "from": Object {
121
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json",
122
- "source": "foobar.yaml",
123
- },
124
- "location": Array [
125
- Object {
126
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json/example/c",
127
- "reportOnKey": true,
128
- "source": "foobar.yaml",
129
- },
130
- ],
131
- "message": "Example value must conform to the schema: must NOT have additional properties \`c\`.",
132
- "ruleId": "no-invalid-media-type-examples",
133
- "severity": "error",
134
- "suggest": Array [],
135
- },
136
- ]
137
- `);
138
- });
139
-
140
- it('should not on invalid example with disallowAdditionalProperties', async () => {
141
- const document = parseYamlToDocument(
142
- outdent`
143
- openapi: 3.0.0
144
- paths:
145
- /pet:
146
- get:
147
- responses:
148
- 200:
149
- content:
150
- application/json:
151
- example:
152
- a: "string"
153
- b: 13
154
- schema:
155
- type: object
156
- properties:
157
- a:
158
- type: string
159
- b:
160
- type: number
161
-
162
- `,
163
- 'foobar.yaml',
164
- );
165
-
166
- const results = await lintDocument({
167
- externalRefResolver: new BaseResolver(),
168
- document,
169
- config: await makeConfig({
170
- 'no-invalid-media-type-examples': {
171
- severity: 'error',
172
- disallowAdditionalProperties: true,
173
- },
174
- }),
175
- });
176
-
177
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`Array []`);
178
- });
179
-
180
- it('should not on invalid examples', async () => {
181
- const document = parseYamlToDocument(
182
- outdent`
183
- openapi: 3.0.0
184
- components:
185
- examples:
186
- test:
187
- value:
188
- a: 23
189
- b: 25
190
- paths:
191
- /pet:
192
- get:
193
- responses:
194
- 200:
195
- content:
196
- application/json:
197
- examples:
198
- test:
199
- $ref: '#/components/examples/test'
200
- test2:
201
- value:
202
- a: test
203
- b: 35
204
- schema:
205
- type: object
206
- properties:
207
- a:
208
- type: string
209
- b:
210
- type: number
211
-
212
- `,
213
- 'foobar.yaml',
214
- );
215
-
216
- const results = await lintDocument({
217
- externalRefResolver: new BaseResolver(),
218
- document,
219
- config: await makeConfig({
220
- 'no-invalid-media-type-examples': {
221
- severity: 'error',
222
- disallowAdditionalProperties: true,
223
- },
224
- }),
225
- });
226
-
227
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`
228
- Array [
229
- Object {
230
- "from": Object {
231
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json",
232
- "source": "foobar.yaml",
233
- },
234
- "location": Array [
235
- Object {
236
- "pointer": "#/components/examples/test/value/a",
237
- "reportOnKey": false,
238
- "source": "foobar.yaml",
239
- },
240
- ],
241
- "message": "Example value must conform to the schema: \`a\` property type must be string.",
242
- "ruleId": "no-invalid-media-type-examples",
243
- "severity": "error",
244
- "suggest": Array [],
245
- },
246
- ]
247
- `);
248
- });
249
-
250
- it('should not report if no examples', async () => {
251
- const document = parseYamlToDocument(
252
- outdent`
253
- openapi: 3.0.0
254
- paths:
255
- /pet:
256
- get:
257
- responses:
258
- 200:
259
- content:
260
- application/json:
261
- example:
262
- a: test
263
- b: 35
264
-
265
- `,
266
- 'foobar.yaml',
267
- );
268
-
269
- const results = await lintDocument({
270
- externalRefResolver: new BaseResolver(),
271
- document,
272
- config: await makeConfig({ 'no-invalid-media-type-examples': 'error' }),
273
- });
274
-
275
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`Array []`);
276
- });
277
-
278
- it('should not report if no schema', async () => {
279
- const document = parseYamlToDocument(
280
- outdent`
281
- openapi: 3.0.0
282
- paths:
283
- /pet:
284
- get:
285
- responses:
286
- 200:
287
- content:
288
- application/json:
289
- schema:
290
- type: object
291
- properties:
292
- a:
293
- type: string
294
- b:
295
- type: number
296
-
297
- `,
298
- 'foobar.yaml',
299
- );
300
-
301
- const results = await lintDocument({
302
- externalRefResolver: new BaseResolver(),
303
- document,
304
- config: await makeConfig({ 'no-invalid-media-type-examples': 'error' }),
305
- });
306
-
307
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`Array []`);
308
- });
309
-
310
- it('should work with cross-file $ref', async () => {
311
- const document = parseYamlToDocument(
312
- outdent`
313
- openapi: 3.0.0
314
- components:
315
- schemas:
316
- C:
317
- $ref: './fixtures/common.yaml#/components/schemas/A'
318
- paths:
319
- /pet:
320
- get:
321
- responses:
322
- 200:
323
- content:
324
- application/json:
325
- example: {
326
- "a": "test",
327
- "b": "test"
328
- }
329
- schema:
330
- $ref: '#/components/schemas/C'
331
-
332
- `,
333
- __dirname + '/foobar.yaml',
334
- );
335
-
336
- const results = await lintDocument({
337
- externalRefResolver: new BaseResolver(),
338
- document,
339
- config: await makeConfig({ 'no-invalid-media-type-examples': 'error' }),
340
- });
341
-
342
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`Array []`);
343
- });
344
-
345
- it('should not throw for ajv throw', async () => {
346
- const document = parseYamlToDocument(
347
- outdent`
348
- openapi: 3.0.0
349
- paths:
350
- /pet:
351
- get:
352
- responses:
353
- 200:
354
- content:
355
- application/json:
356
- example: {}
357
- schema:
358
- nullable: true
359
-
360
- `,
361
- 'foobar.yaml',
362
- );
363
-
364
- const results = await lintDocument({
365
- externalRefResolver: new BaseResolver(),
366
- document,
367
- config: await makeConfig({ 'no-invalid-media-type-examples': 'error' }),
368
- });
369
-
370
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`
371
- Array [
372
- Object {
373
- "from": Object {
374
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json",
375
- "source": "foobar.yaml",
376
- },
377
- "location": Array [
378
- Object {
379
- "pointer": "#/paths/~1pet/get/responses/200/content/application~1json/schema",
380
- "reportOnKey": false,
381
- "source": "foobar.yaml",
382
- },
383
- ],
384
- "message": "Example validation errored: \\"nullable\\" cannot be used without \\"type\\".",
385
- "ruleId": "no-invalid-media-type-examples",
386
- "severity": "error",
387
- "suggest": Array [],
388
- },
389
- ]
390
- `);
391
- });
392
- });
@@ -1,60 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { lintDocument } from '../../../lint';
3
- import { parseYamlToDocument, replaceSourceWithRef, makeConfig } from '../../../../__tests__/utils';
4
- import { BaseResolver } from '../../../resolve';
5
-
6
- describe('Oas3 oas3-no-server-example.com', () => {
7
- it('oas3-no-server-example.com: should report on server object with "example.com" url', async () => {
8
- const document = parseYamlToDocument(
9
- outdent`
10
- openapi: 3.0.0
11
- servers:
12
- - url: example.com
13
- `,
14
- 'foobar.yaml',
15
- );
16
-
17
- const results = await lintDocument({
18
- externalRefResolver: new BaseResolver(),
19
- document,
20
- config: await makeConfig({ 'no-server-example.com': 'error' }),
21
- });
22
-
23
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`
24
- Array [
25
- Object {
26
- "location": Array [
27
- Object {
28
- "pointer": "#/servers/0/url",
29
- "reportOnKey": false,
30
- "source": "foobar.yaml",
31
- },
32
- ],
33
- "message": "Server \`url\` should not point at example.com.",
34
- "ruleId": "no-server-example.com",
35
- "severity": "error",
36
- "suggest": Array [],
37
- },
38
- ]
39
- `);
40
- });
41
-
42
- it('oas3-no-server-example.com: should not report on server object with not "example.com" url', async () => {
43
- const document = parseYamlToDocument(
44
- outdent`
45
- openapi: 3.0.0
46
- servers:
47
- - url: not-example.com
48
- `,
49
- 'foobar.yaml',
50
- );
51
-
52
- const results = await lintDocument({
53
- externalRefResolver: new BaseResolver(),
54
- document,
55
- config: await makeConfig({ 'no-server-example.com': 'error' }),
56
- });
57
-
58
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`Array []`);
59
- });
60
- });
@@ -1,79 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { lintDocument } from '../../../lint';
3
- import { parseYamlToDocument, replaceSourceWithRef, makeConfig } from '../../../../__tests__/utils';
4
- import { BaseResolver } from '../../../resolve';
5
-
6
- describe('Oas3 oas3-no-server-trailing-slash', () => {
7
- it('oas3-no-server-trailing-slash: should report on server object with trailing slash', async () => {
8
- const document = parseYamlToDocument(
9
- outdent`
10
- openapi: 3.0.0
11
- servers:
12
- - url: https://somedomain.com/
13
- `,
14
- 'foobar.yaml',
15
- );
16
-
17
- const results = await lintDocument({
18
- externalRefResolver: new BaseResolver(),
19
- document,
20
- config: await makeConfig({ 'no-server-trailing-slash': 'error' }),
21
- });
22
-
23
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`
24
- Array [
25
- Object {
26
- "location": Array [
27
- Object {
28
- "pointer": "#/servers/0/url",
29
- "reportOnKey": false,
30
- "source": "foobar.yaml",
31
- },
32
- ],
33
- "message": "Server \`url\` should not have a trailing slash.",
34
- "ruleId": "no-server-trailing-slash",
35
- "severity": "error",
36
- "suggest": Array [],
37
- },
38
- ]
39
- `);
40
- });
41
-
42
- it('oas3-no-server-trailing-slash: should not report on server object with no trailing slash', async () => {
43
- const document = parseYamlToDocument(
44
- outdent`
45
- openapi: 3.0.0
46
- servers:
47
- - url: https://somedomain.com
48
- `,
49
- 'foobar.yaml',
50
- );
51
-
52
- const results = await lintDocument({
53
- externalRefResolver: new BaseResolver(),
54
- document,
55
- config: await makeConfig({ 'no-server-trailing-slash': 'error' }),
56
- });
57
-
58
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`Array []`);
59
- });
60
-
61
- it('oas3-no-server-trailing-slash: should not report on server object with no trailing slash if the url is root', async () => {
62
- const document = parseYamlToDocument(
63
- outdent`
64
- openapi: 3.0.0
65
- servers:
66
- - url: /
67
- `,
68
- 'foobar.yaml',
69
- );
70
-
71
- const results = await lintDocument({
72
- externalRefResolver: new BaseResolver(),
73
- document,
74
- config: await makeConfig({ 'no-server-trailing-slash': 'error' }),
75
- });
76
-
77
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`Array []`);
78
- });
79
- });
@@ -1,131 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { lintDocument } from '../../../lint';
3
- import { parseYamlToDocument, replaceSourceWithRef, makeConfig } from '../../../../__tests__/utils';
4
- import { BaseResolver } from '../../../resolve';
5
-
6
- describe('Oas3 no-unused-components', () => {
7
- it('should report unused components', async () => {
8
- const document = parseYamlToDocument(
9
- outdent`
10
- openapi: "3.0.0"
11
- paths:
12
- /pets:
13
- get:
14
- summary: List all pets
15
- operationId: listPets
16
- parameters:
17
- - $ref: '#/components/parameters/used'
18
- components:
19
- parameters:
20
- used:
21
- name: used
22
- unused:
23
- name: unused
24
- responses:
25
- unused: {}
26
- examples:
27
- unused: {}
28
- requestBodies:
29
- unused: {}
30
- headers:
31
- unused: {}
32
- schemas:
33
- Unused:
34
- type: integer
35
- enum:
36
- - 1
37
- - 2
38
- `,
39
- 'foobar.yaml',
40
- );
41
-
42
- const results = await lintDocument({
43
- externalRefResolver: new BaseResolver(),
44
- document,
45
- config: await makeConfig({ 'no-unused-components': 'error' }),
46
- });
47
-
48
- expect(replaceSourceWithRef(results)).toMatchInlineSnapshot(`
49
- Array [
50
- Object {
51
- "location": Array [
52
- Object {
53
- "pointer": "#/components/parameters/unused",
54
- "reportOnKey": true,
55
- "source": "foobar.yaml",
56
- },
57
- ],
58
- "message": "Component: \\"unused\\" is never used.",
59
- "ruleId": "no-unused-components",
60
- "severity": "error",
61
- "suggest": Array [],
62
- },
63
- Object {
64
- "location": Array [
65
- Object {
66
- "pointer": "#/components/schemas/Unused",
67
- "reportOnKey": true,
68
- "source": "foobar.yaml",
69
- },
70
- ],
71
- "message": "Component: \\"Unused\\" is never used.",
72
- "ruleId": "no-unused-components",
73
- "severity": "error",
74
- "suggest": Array [],
75
- },
76
- Object {
77
- "location": Array [
78
- Object {
79
- "pointer": "#/components/responses/unused",
80
- "reportOnKey": true,
81
- "source": "foobar.yaml",
82
- },
83
- ],
84
- "message": "Component: \\"unused\\" is never used.",
85
- "ruleId": "no-unused-components",
86
- "severity": "error",
87
- "suggest": Array [],
88
- },
89
- Object {
90
- "location": Array [
91
- Object {
92
- "pointer": "#/components/examples/unused",
93
- "reportOnKey": true,
94
- "source": "foobar.yaml",
95
- },
96
- ],
97
- "message": "Component: \\"unused\\" is never used.",
98
- "ruleId": "no-unused-components",
99
- "severity": "error",
100
- "suggest": Array [],
101
- },
102
- Object {
103
- "location": Array [
104
- Object {
105
- "pointer": "#/components/requestBodies/unused",
106
- "reportOnKey": true,
107
- "source": "foobar.yaml",
108
- },
109
- ],
110
- "message": "Component: \\"unused\\" is never used.",
111
- "ruleId": "no-unused-components",
112
- "severity": "error",
113
- "suggest": Array [],
114
- },
115
- Object {
116
- "location": Array [
117
- Object {
118
- "pointer": "#/components/headers/unused",
119
- "reportOnKey": true,
120
- "source": "foobar.yaml",
121
- },
122
- ],
123
- "message": "Component: \\"unused\\" is never used.",
124
- "ruleId": "no-unused-components",
125
- "severity": "error",
126
- "suggest": Array [],
127
- },
128
- ]
129
- `);
130
- });
131
- });
@@ -1,41 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { validateDoc } from './utils';
3
-
4
- it('should not fail on valid callbacks object', async () => {
5
- const source = outdent`
6
- openapi: 3.0.2
7
- info:
8
- title: Test
9
- version: '1.0'
10
-
11
- servers:
12
- - url: http://google.com
13
-
14
- paths:
15
- '/ping':
16
- summary: test
17
- get:
18
- callbacks:
19
- test:
20
- 'http://notificationServer.com?transactionId={$request.body#/id}&email={$request.body#/email}':
21
- post:
22
- requestBody:
23
- description: Callback payload
24
- content:
25
- 'application/json':
26
- schema:
27
- $ref: '#/components/schemas/SomePayload'
28
- responses:
29
- '200':
30
- description: webhook successfully processed and no retries will be performed
31
- responses:
32
- '200':
33
- description: example description
34
- `;
35
-
36
- expect(
37
- await validateDoc(source, {
38
- spec: 'error',
39
- }),
40
- ).toMatchInlineSnapshot(`Array []`);
41
- });