@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,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
- });