@redocly/openapi-core 1.0.0-beta.99 → 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 (382) 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 +10 -15
  8. package/lib/bundle.js +32 -12
  9. package/lib/config/all.d.ts +2 -2
  10. package/lib/config/all.js +16 -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 +7 -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.js +2 -2
  94. package/lib/rules/common/scalar-property-missing-example.js +2 -1
  95. package/lib/rules/common/security-defined.d.ts +2 -0
  96. package/lib/rules/common/{operation-security-defined.js → security-defined.js} +25 -6
  97. package/lib/rules/common/spec-strict-refs.d.ts +2 -0
  98. package/lib/rules/common/spec-strict-refs.js +30 -0
  99. package/lib/rules/common/spec.js +41 -18
  100. package/lib/rules/common/tags-alphabetical.js +1 -1
  101. package/lib/rules/oas2/index.d.ts +3 -2
  102. package/lib/rules/oas2/index.js +10 -8
  103. package/lib/rules/oas2/remove-unused-components.js +6 -6
  104. package/lib/rules/oas2/request-mime-type.d.ts +1 -1
  105. package/lib/rules/oas2/request-mime-type.js +1 -1
  106. package/lib/rules/oas2/response-mime-type.d.ts +1 -1
  107. package/lib/rules/oas2/response-mime-type.js +1 -1
  108. package/lib/rules/oas3/component-name-unique.d.ts +2 -0
  109. package/lib/rules/oas3/component-name-unique.js +124 -0
  110. package/lib/rules/oas3/index.js +18 -10
  111. package/lib/rules/oas3/no-empty-servers.js +2 -2
  112. package/lib/rules/oas3/no-invalid-media-type-examples.js +2 -2
  113. package/lib/rules/oas3/no-server-variables-empty-enum.d.ts +2 -0
  114. package/lib/rules/oas3/{no-servers-empty-enum.js → no-server-variables-empty-enum.js} +5 -5
  115. package/lib/rules/oas3/no-unused-components.js +2 -2
  116. package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.d.ts +5 -0
  117. package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.js +36 -0
  118. package/lib/rules/oas3/remove-unused-components.js +6 -6
  119. package/lib/rules/oas3/request-mime-type.d.ts +1 -1
  120. package/lib/rules/oas3/request-mime-type.js +1 -1
  121. package/lib/rules/oas3/response-mime-type.d.ts +1 -1
  122. package/lib/rules/oas3/response-mime-type.js +1 -1
  123. package/lib/rules/oas3/spec-components-invalid-map-name.d.ts +2 -0
  124. package/lib/rules/oas3/spec-components-invalid-map-name.js +62 -0
  125. package/lib/rules/other/stats.d.ts +2 -2
  126. package/lib/rules/other/stats.js +45 -16
  127. package/lib/rules/utils.d.ts +5 -2
  128. package/lib/rules/utils.js +54 -6
  129. package/lib/types/config-external-schemas.d.ts +2193 -0
  130. package/lib/types/config-external-schemas.js +805 -0
  131. package/lib/types/index.d.ts +3 -2
  132. package/lib/types/index.js +9 -1
  133. package/lib/types/oas2.js +91 -15
  134. package/lib/types/oas3.js +125 -46
  135. package/lib/types/oas3_1.js +23 -19
  136. package/lib/types/redocly-yaml.js +406 -60
  137. package/lib/utils.d.ts +15 -4
  138. package/lib/utils.js +72 -8
  139. package/lib/visitors.d.ts +20 -16
  140. package/lib/visitors.js +28 -3
  141. package/lib/walk.d.ts +11 -19
  142. package/lib/walk.js +74 -53
  143. package/package.json +5 -6
  144. package/__tests__/utils.ts +0 -86
  145. package/lib/rules/common/info-description.d.ts +0 -2
  146. package/lib/rules/common/info-description.js +0 -12
  147. package/lib/rules/common/license-url.d.ts +0 -2
  148. package/lib/rules/common/license-url.js +0 -12
  149. package/lib/rules/common/operation-security-defined.d.ts +0 -2
  150. package/lib/rules/oas3/no-servers-empty-enum.d.ts +0 -2
  151. package/src/__tests__/__snapshots__/bundle.test.ts.snap +0 -255
  152. package/src/__tests__/bundle.test.ts +0 -156
  153. package/src/__tests__/codeframes.test.ts +0 -531
  154. package/src/__tests__/fixtures/extension.js +0 -24
  155. package/src/__tests__/fixtures/refs/definitions.yaml +0 -3
  156. package/src/__tests__/fixtures/refs/examples.yaml +0 -8
  157. package/src/__tests__/fixtures/refs/external-request-body.yaml +0 -13
  158. package/src/__tests__/fixtures/refs/externalref.yaml +0 -35
  159. package/src/__tests__/fixtures/refs/hosted.yaml +0 -35
  160. package/src/__tests__/fixtures/refs/openapi-with-external-refs-conflicting-names.yaml +0 -21
  161. package/src/__tests__/fixtures/refs/openapi-with-external-refs.yaml +0 -33
  162. package/src/__tests__/fixtures/refs/openapi-with-url-refs.yaml +0 -18
  163. package/src/__tests__/fixtures/refs/param-b.yaml +0 -1
  164. package/src/__tests__/fixtures/refs/param-c.yaml +0 -1
  165. package/src/__tests__/fixtures/refs/rename.yaml +0 -1
  166. package/src/__tests__/fixtures/refs/requestBody.yaml +0 -9
  167. package/src/__tests__/fixtures/refs/schema-a.yaml +0 -1
  168. package/src/__tests__/fixtures/refs/simple.yaml +0 -1
  169. package/src/__tests__/fixtures/refs/vendor.schema.yaml +0 -20
  170. package/src/__tests__/fixtures/resolve/External.yaml +0 -10
  171. package/src/__tests__/fixtures/resolve/External2.yaml +0 -4
  172. package/src/__tests__/fixtures/resolve/description.md +0 -3
  173. package/src/__tests__/fixtures/resolve/externalInfo.yaml +0 -4
  174. package/src/__tests__/fixtures/resolve/externalLicense.yaml +0 -1
  175. package/src/__tests__/fixtures/resolve/openapi-with-back.yaml +0 -13
  176. package/src/__tests__/fixtures/resolve/openapi-with-md-description.yaml +0 -5
  177. package/src/__tests__/fixtures/resolve/openapi.yaml +0 -28
  178. package/src/__tests__/fixtures/resolve/schemas/type-a.yaml +0 -10
  179. package/src/__tests__/fixtures/resolve/schemas/type-b.yaml +0 -6
  180. package/src/__tests__/fixtures/resolve/transitive/a.yaml +0 -1
  181. package/src/__tests__/fixtures/resolve/transitive/components.yaml +0 -5
  182. package/src/__tests__/fixtures/resolve/transitive/schemas.yaml +0 -3
  183. package/src/__tests__/js-yaml.test.ts +0 -71
  184. package/src/__tests__/lint.test.ts +0 -195
  185. package/src/__tests__/login.test.ts +0 -17
  186. package/src/__tests__/normalizeVisitors.test.ts +0 -151
  187. package/src/__tests__/ref-utils.test.ts +0 -120
  188. package/src/__tests__/resolve-http.test.ts +0 -77
  189. package/src/__tests__/resolve.test.ts +0 -405
  190. package/src/__tests__/utils.test.ts +0 -85
  191. package/src/__tests__/walk.test.ts +0 -1485
  192. package/src/benchmark/benches/lint-with-many-rules.bench.ts +0 -35
  193. package/src/benchmark/benches/lint-with-nested-rule.bench.ts +0 -39
  194. package/src/benchmark/benches/lint-with-no-rules.bench.ts +0 -20
  195. package/src/benchmark/benches/lint-with-top-level-rule-report.bench.ts +0 -36
  196. package/src/benchmark/benches/lint-with-top-level-rule.bench.ts +0 -32
  197. package/src/benchmark/benches/rebilly.yaml +0 -32267
  198. package/src/benchmark/benches/recommended-oas3.bench.ts +0 -22
  199. package/src/benchmark/benches/resolve-with-no-external.bench.ts +0 -23
  200. package/src/benchmark/benchmark.js +0 -307
  201. package/src/benchmark/colors.js +0 -29
  202. package/src/benchmark/fork.js +0 -83
  203. package/src/benchmark/utils.ts +0 -36
  204. package/src/bundle.ts +0 -386
  205. package/src/config/__tests__/__snapshots__/config-resolvers.test.ts.snap +0 -157
  206. package/src/config/__tests__/config-resolvers.test.ts +0 -429
  207. package/src/config/__tests__/config.test.ts +0 -244
  208. package/src/config/__tests__/fixtures/plugin-config.yaml +0 -3
  209. package/src/config/__tests__/fixtures/plugin.js +0 -56
  210. package/src/config/__tests__/fixtures/resolve-config/api/nested-config.yaml +0 -12
  211. package/src/config/__tests__/fixtures/resolve-config/api/plugin.js +0 -67
  212. package/src/config/__tests__/fixtures/resolve-config/local-config-with-circular.yaml +0 -8
  213. package/src/config/__tests__/fixtures/resolve-config/local-config-with-file.yaml +0 -19
  214. package/src/config/__tests__/fixtures/resolve-config/local-config.yaml +0 -10
  215. package/src/config/__tests__/fixtures/resolve-config/plugin.js +0 -66
  216. package/src/config/__tests__/fixtures/resolve-remote-configs/nested-remote-config.yaml +0 -4
  217. package/src/config/__tests__/fixtures/resolve-remote-configs/remote-config.yaml +0 -5
  218. package/src/config/__tests__/load.test.ts +0 -83
  219. package/src/config/__tests__/resolve-plugins.test.ts +0 -27
  220. package/src/config/all.ts +0 -66
  221. package/src/config/builtIn.ts +0 -37
  222. package/src/config/config-resolvers.ts +0 -359
  223. package/src/config/config.ts +0 -312
  224. package/src/config/index.ts +0 -7
  225. package/src/config/load.ts +0 -84
  226. package/src/config/minimal.ts +0 -58
  227. package/src/config/recommended.ts +0 -58
  228. package/src/config/rules.ts +0 -46
  229. package/src/config/types.ts +0 -168
  230. package/src/config/utils.ts +0 -208
  231. package/src/decorators/__tests__/remove-x-internal.test.ts +0 -316
  232. package/src/decorators/common/info-description-override.ts +0 -24
  233. package/src/decorators/common/operation-description-override.ts +0 -30
  234. package/src/decorators/common/registry-dependencies.ts +0 -25
  235. package/src/decorators/common/remove-x-internal.ts +0 -59
  236. package/src/decorators/common/tag-description-override.ts +0 -25
  237. package/src/decorators/oas2/index.ts +0 -14
  238. package/src/decorators/oas3/index.ts +0 -14
  239. package/src/format/codeframes.ts +0 -210
  240. package/src/format/format.ts +0 -339
  241. package/src/index.ts +0 -68
  242. package/src/js-yaml/index.ts +0 -18
  243. package/src/lint.ts +0 -125
  244. package/src/oas-types.ts +0 -62
  245. package/src/redocly/__tests__/redocly-client.test.ts +0 -140
  246. package/src/redocly/index.ts +0 -182
  247. package/src/redocly/redocly-client-types.ts +0 -10
  248. package/src/redocly/registry-api-types.ts +0 -32
  249. package/src/redocly/registry-api.ts +0 -134
  250. package/src/ref-utils.ts +0 -80
  251. package/src/resolve.ts +0 -378
  252. package/src/rules/__tests__/fixtures/invalid-yaml.yaml +0 -1
  253. package/src/rules/__tests__/fixtures/ref.yaml +0 -1
  254. package/src/rules/__tests__/no-unresolved-refs.test.ts +0 -168
  255. package/src/rules/ajv.ts +0 -103
  256. package/src/rules/common/__tests__/info-description.test.ts +0 -102
  257. package/src/rules/common/__tests__/info-license.test.ts +0 -62
  258. package/src/rules/common/__tests__/license-url.test.ts +0 -63
  259. package/src/rules/common/__tests__/no-ambiguous-paths.test.ts +0 -96
  260. package/src/rules/common/__tests__/no-enum-type-mismatch.test.ts +0 -209
  261. package/src/rules/common/__tests__/no-identical-paths.test.ts +0 -58
  262. package/src/rules/common/__tests__/no-path-trailing-slash.test.ts +0 -85
  263. package/src/rules/common/__tests__/operation-2xx-response.test.ts +0 -91
  264. package/src/rules/common/__tests__/operation-4xx-response.test.ts +0 -107
  265. package/src/rules/common/__tests__/operation-operationId-unique.test.ts +0 -76
  266. package/src/rules/common/__tests__/operation-operationId-url-safe.test.ts +0 -45
  267. package/src/rules/common/__tests__/operation-parameters-unique.test.ts +0 -167
  268. package/src/rules/common/__tests__/operation-security-defined.test.ts +0 -69
  269. package/src/rules/common/__tests__/operation-singular-tag.test.ts +0 -72
  270. package/src/rules/common/__tests__/path-http-verbs-order.test.ts +0 -95
  271. package/src/rules/common/__tests__/path-not-include-query.test.ts +0 -64
  272. package/src/rules/common/__tests__/path-params-defined.test.ts +0 -133
  273. package/src/rules/common/__tests__/paths-kebab-case.test.ts +0 -108
  274. package/src/rules/common/__tests__/scalar-property-missing-example.test.ts +0 -207
  275. package/src/rules/common/__tests__/spec.test.ts +0 -62
  276. package/src/rules/common/__tests__/tag-description.test.ts +0 -65
  277. package/src/rules/common/__tests__/tags-alphabetical.test.ts +0 -64
  278. package/src/rules/common/assertions/__tests__/asserts.test.ts +0 -231
  279. package/src/rules/common/assertions/__tests__/index.test.ts +0 -65
  280. package/src/rules/common/assertions/__tests__/utils.test.ts +0 -89
  281. package/src/rules/common/assertions/asserts.ts +0 -137
  282. package/src/rules/common/assertions/index.ts +0 -75
  283. package/src/rules/common/assertions/utils.ts +0 -167
  284. package/src/rules/common/info-contact.ts +0 -15
  285. package/src/rules/common/info-description.ts +0 -10
  286. package/src/rules/common/info-license-url.ts +0 -15
  287. package/src/rules/common/license-url.ts +0 -10
  288. package/src/rules/common/no-ambiguous-paths.ts +0 -50
  289. package/src/rules/common/no-enum-type-mismatch.ts +0 -49
  290. package/src/rules/common/no-http-verbs-in-paths.ts +0 -36
  291. package/src/rules/common/no-identical-paths.ts +0 -24
  292. package/src/rules/common/no-invalid-parameter-examples.ts +0 -36
  293. package/src/rules/common/no-invalid-schema-examples.ts +0 -27
  294. package/src/rules/common/no-path-trailing-slash.ts +0 -15
  295. package/src/rules/common/operation-2xx-response.ts +0 -16
  296. package/src/rules/common/operation-4xx-response.ts +0 -17
  297. package/src/rules/common/operation-description.ts +0 -13
  298. package/src/rules/common/operation-operationId-unique.ts +0 -21
  299. package/src/rules/common/operation-operationId-url-safe.ts +0 -19
  300. package/src/rules/common/operation-operationId.ts +0 -17
  301. package/src/rules/common/operation-parameters-unique.ts +0 -48
  302. package/src/rules/common/operation-security-defined.ts +0 -45
  303. package/src/rules/common/operation-singular-tag.ts +0 -17
  304. package/src/rules/common/operation-summary.ts +0 -13
  305. package/src/rules/common/operation-tag-defined.ts +0 -26
  306. package/src/rules/common/parameter-description.ts +0 -22
  307. package/src/rules/common/path-declaration-must-exist.ts +0 -15
  308. package/src/rules/common/path-excludes-patterns.ts +0 -23
  309. package/src/rules/common/path-http-verbs-order.ts +0 -30
  310. package/src/rules/common/path-not-include-query.ts +0 -17
  311. package/src/rules/common/path-params-defined.ts +0 -58
  312. package/src/rules/common/path-segment-plural.ts +0 -31
  313. package/src/rules/common/paths-kebab-case.ts +0 -16
  314. package/src/rules/common/response-contains-header.ts +0 -30
  315. package/src/rules/common/scalar-property-missing-example.ts +0 -55
  316. package/src/rules/common/spec.ts +0 -143
  317. package/src/rules/common/tag-description.ts +0 -10
  318. package/src/rules/common/tags-alphabetical.ts +0 -20
  319. package/src/rules/no-unresolved-refs.ts +0 -51
  320. package/src/rules/oas2/__tests__/boolean-parameter-prefixes.test.ts +0 -110
  321. package/src/rules/oas2/__tests__/response-contains-header.test.ts +0 -174
  322. package/src/rules/oas2/__tests__/response-contains-property.test.ts +0 -155
  323. package/src/rules/oas2/__tests__/spec/fixtures/description.md +0 -1
  324. package/src/rules/oas2/__tests__/spec/info.test.ts +0 -355
  325. package/src/rules/oas2/__tests__/spec/operation.test.ts +0 -123
  326. package/src/rules/oas2/__tests__/spec/paths.test.ts +0 -245
  327. package/src/rules/oas2/__tests__/spec/referenceableScalars.test.ts +0 -31
  328. package/src/rules/oas2/__tests__/spec/utils.ts +0 -32
  329. package/src/rules/oas2/boolean-parameter-prefixes.ts +0 -26
  330. package/src/rules/oas2/index.ts +0 -89
  331. package/src/rules/oas2/remove-unused-components.ts +0 -76
  332. package/src/rules/oas2/request-mime-type.ts +0 -17
  333. package/src/rules/oas2/response-contains-property.ts +0 -36
  334. package/src/rules/oas2/response-mime-type.ts +0 -17
  335. package/src/rules/oas3/__tests__/boolean-parameter-prefixes.test.ts +0 -111
  336. package/src/rules/oas3/__tests__/fixtures/common.yaml +0 -11
  337. package/src/rules/oas3/__tests__/no-empty-enum-servers.com.test.ts +0 -205
  338. package/src/rules/oas3/__tests__/no-example-value-and-externalValue.test.ts +0 -65
  339. package/src/rules/oas3/__tests__/no-invalid-media-type-examples.test.ts +0 -392
  340. package/src/rules/oas3/__tests__/no-server-example.com.test.ts +0 -60
  341. package/src/rules/oas3/__tests__/no-server-trailing-slash.test.ts +0 -79
  342. package/src/rules/oas3/__tests__/no-unused-components.test.ts +0 -131
  343. package/src/rules/oas3/__tests__/response-contains-header.test.ts +0 -273
  344. package/src/rules/oas3/__tests__/response-contains-property.test.ts +0 -403
  345. package/src/rules/oas3/__tests__/spec/callbacks.test.ts +0 -41
  346. package/src/rules/oas3/__tests__/spec/fixtures/description.md +0 -1
  347. package/src/rules/oas3/__tests__/spec/info.test.ts +0 -391
  348. package/src/rules/oas3/__tests__/spec/operation.test.ts +0 -253
  349. package/src/rules/oas3/__tests__/spec/paths.test.ts +0 -284
  350. package/src/rules/oas3/__tests__/spec/referenceableScalars.test.ts +0 -77
  351. package/src/rules/oas3/__tests__/spec/servers.test.ts +0 -499
  352. package/src/rules/oas3/__tests__/spec/spec.test.ts +0 -288
  353. package/src/rules/oas3/__tests__/spec/utils.ts +0 -32
  354. package/src/rules/oas3/boolean-parameter-prefixes.ts +0 -28
  355. package/src/rules/oas3/index.ts +0 -105
  356. package/src/rules/oas3/no-empty-servers.ts +0 -22
  357. package/src/rules/oas3/no-example-value-and-externalValue.ts +0 -14
  358. package/src/rules/oas3/no-invalid-media-type-examples.ts +0 -41
  359. package/src/rules/oas3/no-server-example.com.ts +0 -14
  360. package/src/rules/oas3/no-server-trailing-slash.ts +0 -15
  361. package/src/rules/oas3/no-servers-empty-enum.ts +0 -67
  362. package/src/rules/oas3/no-undefined-server-variable.ts +0 -30
  363. package/src/rules/oas3/no-unused-components.ts +0 -75
  364. package/src/rules/oas3/remove-unused-components.ts +0 -84
  365. package/src/rules/oas3/request-mime-type.ts +0 -31
  366. package/src/rules/oas3/response-contains-property.ts +0 -38
  367. package/src/rules/oas3/response-mime-type.ts +0 -31
  368. package/src/rules/other/stats.ts +0 -44
  369. package/src/rules/utils.ts +0 -123
  370. package/src/types/index.ts +0 -138
  371. package/src/types/oas2.ts +0 -397
  372. package/src/types/oas3.ts +0 -515
  373. package/src/types/oas3_1.ts +0 -253
  374. package/src/types/redocly-yaml.ts +0 -647
  375. package/src/typings/common.ts +0 -9
  376. package/src/typings/openapi.ts +0 -298
  377. package/src/typings/swagger.ts +0 -236
  378. package/src/utils.ts +0 -193
  379. package/src/visitors.ts +0 -448
  380. package/src/walk.ts +0 -416
  381. package/tsconfig.json +0 -8
  382. package/tsconfig.tsbuildinfo +0 -1
@@ -1,355 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { lintDoc } from './utils';
3
-
4
- describe('OpenAPI Schema 2.0', () => {
5
- it('should report if the title of the API is empty ', async () => {
6
- const source = outdent`
7
- swagger: '2.0'
8
- info:
9
- title:
10
- version: '1.0'
11
-
12
- paths:
13
- '/ping':
14
- get:
15
- responses:
16
- '200':
17
- description: example description
18
- `;
19
-
20
- expect(
21
- await lintDoc(source, {
22
- spec: 'error',
23
- }),
24
- ).toMatchInlineSnapshot(`
25
- Array [
26
- Object {
27
- "location": "#/info/title",
28
- "message": "Expected type \`string\` but got \`null\`.",
29
- },
30
- ]
31
- `);
32
- });
33
-
34
- it('should report if in the description field is not string.', async () => {
35
- const source = outdent`
36
- swagger: '2.0'
37
- info:
38
- title: Example OpenAPI 3 definition.
39
- version: '1.0'
40
- description:
41
-
42
- paths:
43
- '/ping':
44
- get:
45
- responses:
46
- '200':
47
- description: example description
48
- `;
49
-
50
- expect(
51
- await lintDoc(source, {
52
- spec: 'error',
53
- }),
54
- ).toMatchInlineSnapshot(`
55
- Array [
56
- Object {
57
- "location": "#/info/description",
58
- "message": "Expected type \`string\` but got \`null\`.",
59
- },
60
- ]
61
- `);
62
- });
63
-
64
- it('should report if in the termsOfService field is not string', async () => {
65
- const source = outdent`
66
- swagger: '2.0'
67
- info:
68
- title: Example OpenAPI 3 definition. Valid.
69
- version: '1.0'
70
- termsOfService:
71
-
72
- paths:
73
- '/ping':
74
- get:
75
- responses:
76
- '200':
77
- description: example description
78
- `;
79
-
80
- expect(
81
- await lintDoc(source, {
82
- spec: 'error',
83
- }),
84
- ).toMatchInlineSnapshot(`
85
- Array [
86
- Object {
87
- "location": "#/info/termsOfService",
88
- "message": "Expected type \`string\` but got \`null\`.",
89
- },
90
- ]
91
- `);
92
- });
93
-
94
- it('should not report if the Contact Object is valid', async () => {
95
- const source = outdent`
96
- swagger: '2.0'
97
- info:
98
- title: Example OpenAPI 3 definition. Valid.
99
- version: '1.0'
100
- termsOfService: http://example.com/terms/
101
- contact:
102
- name: API Support
103
- url: http://www.example.com/support
104
- email: support@example.com
105
-
106
- paths:
107
- '/ping':
108
- get:
109
- responses:
110
- '200':
111
- description: example description
112
- `;
113
-
114
- expect(
115
- await lintDoc(source, {
116
- spec: 'error',
117
- }),
118
- ).toMatchInlineSnapshot(`Array []`);
119
- });
120
-
121
- it('should report if in the Contact Object in URL field is not string', async () => {
122
- const source = outdent`
123
- swagger: '2.0'
124
- info:
125
- title: Example OpenAPI 3 definition. Valid.
126
- version: '1.0'
127
- termsOfService: http://example.com/terms/
128
- contact:
129
- url:
130
- email: support@example.com
131
-
132
- paths:
133
- '/ping':
134
- get:
135
- responses:
136
- '200':
137
- description: example description
138
- `;
139
-
140
- expect(
141
- await lintDoc(source, {
142
- spec: 'error',
143
- }),
144
- ).toMatchInlineSnapshot(`
145
- Array [
146
- Object {
147
- "location": "#/info/contact/url",
148
- "message": "Expected type \`string\` but got \`null\`.",
149
- },
150
- ]
151
- `);
152
- });
153
-
154
- it('should report if in the Contact Object in email field is not string', async () => {
155
- const source = outdent`
156
- swagger: '2.0'
157
- info:
158
- title: Example OpenAPI 3 definition. Valid.
159
- version: '1.0'
160
- termsOfService: http://example.com/terms/
161
- contact:
162
- url: http://example.com/contact/
163
- email:
164
-
165
- paths:
166
- '/ping':
167
- get:
168
- responses:
169
- '200':
170
- description: example description
171
- `;
172
-
173
- expect(
174
- await lintDoc(source, {
175
- spec: 'error',
176
- }),
177
- ).toMatchInlineSnapshot(`
178
- Array [
179
- Object {
180
- "location": "#/info/contact/email",
181
- "message": "Expected type \`string\` but got \`null\`.",
182
- },
183
- ]
184
- `);
185
- });
186
-
187
- it('should not report if the License Object is valid', async () => {
188
- const source = outdent`
189
- swagger: '2.0'
190
- info:
191
- title: Example OpenAPI 3 definition. Valid.
192
- version: '1.0'
193
- license:
194
- name: Apache 2.0
195
- url: https://www.apache.org/licenses/LICENSE-2.0.html
196
-
197
- paths:
198
- '/ping':
199
- get:
200
- responses:
201
- '200':
202
- description: example description
203
- `;
204
-
205
- expect(
206
- await lintDoc(source, {
207
- spec: 'error',
208
- }),
209
- ).toMatchInlineSnapshot(`Array []`);
210
- });
211
-
212
- it('should report if the License Object missing field Name', async () => {
213
- const source = outdent`
214
- swagger: '2.0'
215
- info:
216
- title: Example OpenAPI 3 definition. Valid.
217
- version: '1.0'
218
- license:
219
- url: https://www.apache.org/licenses/LICENSE-2.0.html
220
-
221
- paths:
222
- '/ping':
223
- get:
224
- responses:
225
- '200':
226
- description: example description
227
- `;
228
-
229
- expect(
230
- await lintDoc(source, {
231
- spec: 'error',
232
- }),
233
- ).toMatchInlineSnapshot(`
234
- Array [
235
- Object {
236
- "location": "#/info/license",
237
- "message": "The field \`name\` must be present on this level.",
238
- },
239
- ]
240
- `);
241
- });
242
-
243
- it('should report if in the URL field of the License Object is not string', async () => {
244
- const source = outdent`
245
- swagger: '2.0'
246
- info:
247
- title: Example OpenAPI 3 definition. Valid.
248
- version: '1.0'
249
- license:
250
- name: Apache 2.0
251
- url:
252
-
253
- paths:
254
- '/ping':
255
- get:
256
- responses:
257
- '200':
258
- description: example description
259
- `;
260
-
261
- expect(
262
- await lintDoc(source, {
263
- spec: 'error',
264
- }),
265
- ).toMatchInlineSnapshot(`
266
- Array [
267
- Object {
268
- "location": "#/info/license/url",
269
- "message": "Expected type \`string\` but got \`null\`.",
270
- },
271
- ]
272
- `);
273
- });
274
-
275
- it('should not report if the URL field of the License Object is not provided', async () => {
276
- const source = outdent`
277
- swagger: '2.0'
278
- info:
279
- title: Example OpenAPI 3 definition. Valid.
280
- version: '1.0'
281
- license:
282
- name: Apache 2.0
283
-
284
- paths:
285
- '/ping':
286
- get:
287
- responses:
288
- '200':
289
- description: example description
290
- `;
291
-
292
- expect(
293
- await lintDoc(source, {
294
- spec: 'error',
295
- }),
296
- ).toMatchInlineSnapshot(`Array []`);
297
- });
298
-
299
- it('should report if the Version field is not provided', async () => {
300
- const source = outdent`
301
- swagger: '2.0'
302
- info:
303
- title: Example OpenAPI 3 definition.
304
-
305
- paths:
306
- '/ping':
307
- get:
308
- responses:
309
- '200':
310
- description: example description
311
- `;
312
-
313
- expect(
314
- await lintDoc(source, {
315
- spec: 'error',
316
- }),
317
- ).toMatchInlineSnapshot(`
318
- Array [
319
- Object {
320
- "location": "#/info",
321
- "message": "The field \`version\` must be present on this level.",
322
- },
323
- ]
324
- `);
325
- });
326
-
327
- it('should report if in the Version field is not string', async () => {
328
- const source = outdent`
329
- swagger: '2.0'
330
- info:
331
- version:
332
- title: Example OpenAPI 3 definition.
333
-
334
- paths:
335
- '/ping':
336
- get:
337
- responses:
338
- '200':
339
- description: example description
340
- `;
341
-
342
- expect(
343
- await lintDoc(source, {
344
- spec: 'error',
345
- }),
346
- ).toMatchInlineSnapshot(`
347
- Array [
348
- Object {
349
- "location": "#/info/version",
350
- "message": "Expected type \`string\` but got \`null\`.",
351
- },
352
- ]
353
- `);
354
- });
355
- });
@@ -1,123 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { lintDoc } from './utils';
3
-
4
- describe('OpenAPI Schema 2.0', () => {
5
- it('should not report of a valid GET operation object', async () => {
6
- const source = outdent`
7
- swagger: '2.0'
8
- info:
9
- title: Test
10
- version: '1.0'
11
-
12
- paths:
13
- '/ping':
14
- get:
15
- responses:
16
- '200':
17
- description: example description
18
- `;
19
-
20
- expect(
21
- await lintDoc(source, {
22
- spec: 'error',
23
- }),
24
- ).toMatchInlineSnapshot(`Array []`);
25
- });
26
-
27
- it('should not report of a valid PUT operation object', async () => {
28
- const source = outdent`
29
- swagger: '2.0'
30
- info:
31
- title: Test
32
- version: '1.0'
33
-
34
- paths:
35
- '/ping':
36
- put:
37
- tags:
38
- - pet
39
- summary: Update an existing pet
40
- description: ''
41
- operationId: updatePet
42
- responses:
43
- '400':
44
- description: Invalid ID supplied
45
- `;
46
-
47
- expect(
48
- await lintDoc(source, {
49
- spec: 'error',
50
- }),
51
- ).toMatchInlineSnapshot(`Array []`);
52
- });
53
-
54
- it('should not report of a valid Post operation object', async () => {
55
- const source = outdent`
56
- swagger: '2.0'
57
- info:
58
- title: Test
59
- version: '1.0'
60
-
61
- paths:
62
- '/ping':
63
- post:
64
- tags:
65
- - pet
66
- summary: uploads an image
67
- description: ''
68
- operationId: uploadFile
69
- parameters:
70
- - name: petId
71
- in: path
72
- description: ID of pet to update
73
- required: true
74
- type: integer
75
- format: int64
76
- responses:
77
- '200':
78
- description: successful operation
79
- `;
80
-
81
- expect(
82
- await lintDoc(source, {
83
- spec: 'error',
84
- }),
85
- ).toMatchInlineSnapshot(`Array []`);
86
- });
87
-
88
- it('should not report of a valid delete operation object', async () => {
89
- const source = outdent`
90
- swagger: '2.0'
91
- info:
92
- title: Test
93
- version: '1.0'
94
-
95
- paths:
96
- '/ping':
97
- delete:
98
- tags:
99
- - store
100
- summary: Delete purchase order by ID
101
- description: >-
102
- For valid response try integer IDs with value < 1000. Anything above
103
- 1000 or nonintegers will generate API errors
104
- operationId: deleteOrder
105
- parameters:
106
- - name: orderId
107
- in: path
108
- description: ID of the order that needs to be deleted
109
- required: true
110
- type: string
111
- minimum: 1
112
- responses:
113
- '400':
114
- description: Invalid ID supplied
115
- `;
116
-
117
- expect(
118
- await lintDoc(source, {
119
- spec: 'error',
120
- }),
121
- ).toMatchInlineSnapshot(`Array []`);
122
- });
123
- });
@@ -1,245 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { lintDoc } from './utils';
3
-
4
- describe('OpenAPI Schema', () => {
5
- it('should not report if Path object is valid ', async () => {
6
- const source = outdent`
7
- swagger: '2.0'
8
- info:
9
- title: Test
10
- version: '1.0'
11
-
12
- paths:
13
- '/ping':
14
- get:
15
- responses:
16
- '200':
17
- description: example description
18
- `;
19
-
20
- expect(
21
- await lintDoc(source, {
22
- spec: 'error',
23
- }),
24
- ).toMatchInlineSnapshot(`Array []`);
25
- });
26
-
27
- it('should not report if Path object is empty ', async () => {
28
- const source = outdent`
29
- swagger: '2.0'
30
- info:
31
- title: Test
32
- version: '1.0'
33
-
34
- paths: {}
35
- `;
36
-
37
- expect(
38
- await lintDoc(source, {
39
- spec: 'error',
40
- }),
41
- ).toMatchInlineSnapshot(`Array []`);
42
- });
43
-
44
- it('should report if Path object is not present ', async () => {
45
- const source = outdent`
46
- swagger: '2.0'
47
- info:
48
- title: Test
49
- version: '1.0'
50
- `;
51
-
52
- expect(
53
- await lintDoc(source, {
54
- spec: 'error',
55
- }),
56
- ).toMatchInlineSnapshot(`
57
- Array [
58
- Object {
59
- "location": "#/",
60
- "message": "The field \`paths\` must be present on this level.",
61
- },
62
- ]
63
- `);
64
- });
65
-
66
- it('should not report if Path object is empty ', async () => {
67
- const source = outdent`
68
- swagger: '2.0'
69
- info:
70
- title: Test
71
- version: '1.0'
72
-
73
- paths: {}
74
- `;
75
-
76
- expect(
77
- await lintDoc(source, {
78
- spec: 'error',
79
- }),
80
- ).toMatchInlineSnapshot(`Array []`);
81
- });
82
-
83
- //Check: no error
84
- it('should report if the field name is not begin with a forward slash (/) ', async () => {
85
- const source = outdent`
86
- swagger: '2.0'
87
- info:
88
- title: Test
89
- version: '1.0'
90
-
91
- paths:
92
- 'ping':
93
- get:
94
- responses:
95
- '200':
96
- description: example description
97
- `;
98
-
99
- expect(
100
- await lintDoc(source, {
101
- spec: 'error',
102
- }),
103
- ).toMatchInlineSnapshot(`
104
- Array [
105
- Object {
106
- "location": "#/paths/ping",
107
- "message": "Property \`ping\` is not expected here.",
108
- },
109
- ]
110
- `);
111
- });
112
-
113
- it('should report if paths are considered identical and invalid', async () => {
114
- const source = outdent`
115
- swagger: '2.0'
116
- info:
117
- title: Test
118
- version: '1.0'
119
-
120
- paths:
121
- /pets/{petId}:
122
- get:
123
- responses:
124
- '200':
125
- description: example description
126
- /pets/{name}:
127
- get:
128
- responses:
129
- '200':
130
- description: example description
131
- `;
132
-
133
- expect(
134
- await lintDoc(source, {
135
- 'paths-identical': 'error',
136
- }),
137
- ).toMatchInlineSnapshot(`Array []`);
138
- });
139
-
140
- it('should not report valid matching URLs', async () => {
141
- const source = outdent`
142
- swagger: '2.0'
143
- info:
144
- title: Test
145
- version: '1.0'
146
-
147
- paths:
148
- '/pets/{petId}':
149
- get:
150
- responses:
151
- '200':
152
- description: example description
153
- '/pets/mine':
154
- get:
155
- responses:
156
- '200':
157
- description: example description
158
- `;
159
-
160
- expect(
161
- await lintDoc(source, {
162
- spec: 'error',
163
- }),
164
- ).toMatchInlineSnapshot(`Array []`);
165
- });
166
-
167
- it('should not report in case of ambiguous matching ', async () => {
168
- const source = outdent`
169
- swagger: '2.0'
170
- info:
171
- title: Test
172
- version: '1.0'
173
-
174
- paths:
175
- '/{entity}/me':
176
- get:
177
- responses:
178
- '200':
179
- description: example description
180
- '/books/{id}':
181
- get:
182
- responses:
183
- '200':
184
- description: example description
185
- `;
186
-
187
- expect(
188
- await lintDoc(source, {
189
- spec: 'error',
190
- }),
191
- ).toMatchInlineSnapshot(`Array []`);
192
- });
193
-
194
- it('should not report if Path Item is empty ', async () => {
195
- const source = outdent`
196
- swagger: '2.0'
197
- info:
198
- title: Test
199
- version: '1.0'
200
-
201
- paths:
202
- '/ping': {}
203
- `;
204
-
205
- expect(
206
- await lintDoc(source, {
207
- spec: 'error',
208
- }),
209
- ).toMatchInlineSnapshot(`Array []`);
210
- });
211
-
212
- it('should not report of a valid Parameter Object', async () => {
213
- const source = outdent`
214
- swagger: '2.0'
215
- info:
216
- title: Test
217
- version: '1.0'
218
-
219
- paths:
220
- /pet:
221
- parameters:
222
- - name: Accept-Language
223
- in: header
224
- description: "test"
225
- required: false
226
- type: string
227
- default: en-AU
228
- post:
229
- tags:
230
- - pet
231
- summary: Add a new pet to the store
232
- description: Add new pet to the store inventory.
233
- operationId: addPet
234
- responses:
235
- '405':
236
- description: Invalid input
237
- `;
238
-
239
- expect(
240
- await lintDoc(source, {
241
- spec: 'error',
242
- }),
243
- ).toMatchInlineSnapshot(`Array []`);
244
- });
245
- });