@redocly/openapi-core 1.0.0-beta.126 → 1.0.0-beta.128

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 (289) hide show
  1. package/lib/bundle.js +21 -4
  2. package/lib/config/all.js +1 -0
  3. package/lib/config/config-resolvers.js +8 -2
  4. package/lib/config/minimal.js +1 -0
  5. package/lib/config/recommended.js +1 -0
  6. package/lib/config/types.d.ts +1 -1
  7. package/lib/config/utils.js +15 -1
  8. package/lib/lint.js +17 -2
  9. package/lib/rules/common/spec-strict-refs.d.ts +2 -0
  10. package/lib/rules/common/spec-strict-refs.js +30 -0
  11. package/lib/rules/common/spec.js +1 -0
  12. package/lib/rules/oas2/index.d.ts +1 -0
  13. package/lib/rules/oas2/index.js +2 -0
  14. package/lib/rules/oas2/request-mime-type.d.ts +1 -1
  15. package/lib/rules/oas2/response-mime-type.d.ts +1 -1
  16. package/lib/rules/oas3/index.js +2 -0
  17. package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.d.ts +2 -2
  18. package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.js +3 -3
  19. package/lib/rules/oas3/request-mime-type.d.ts +1 -1
  20. package/lib/rules/oas3/response-mime-type.d.ts +1 -1
  21. package/lib/rules/oas3/spec-components-invalid-map-name.js +0 -5
  22. package/lib/types/redocly-yaml.js +6 -1
  23. package/lib/walk.d.ts +6 -5
  24. package/lib/walk.js +26 -31
  25. package/package.json +1 -1
  26. package/__tests__/utils.ts +0 -88
  27. package/src/__tests__/__snapshots__/bundle.test.ts.snap +0 -437
  28. package/src/__tests__/bundle.test.ts +0 -236
  29. package/src/__tests__/codeframes.test.ts +0 -530
  30. package/src/__tests__/fixtures/.redocly.lint-ignore.yaml +0 -5
  31. package/src/__tests__/fixtures/extension.js +0 -24
  32. package/src/__tests__/fixtures/refs/definitions.yaml +0 -3
  33. package/src/__tests__/fixtures/refs/examples.yaml +0 -8
  34. package/src/__tests__/fixtures/refs/external-request-body.yaml +0 -13
  35. package/src/__tests__/fixtures/refs/externalref.yaml +0 -35
  36. package/src/__tests__/fixtures/refs/hosted.yaml +0 -35
  37. package/src/__tests__/fixtures/refs/openapi-with-external-refs-conflicting-names.yaml +0 -21
  38. package/src/__tests__/fixtures/refs/openapi-with-external-refs.yaml +0 -33
  39. package/src/__tests__/fixtures/refs/openapi-with-url-refs.yaml +0 -18
  40. package/src/__tests__/fixtures/refs/param-b.yaml +0 -1
  41. package/src/__tests__/fixtures/refs/param-c.yaml +0 -1
  42. package/src/__tests__/fixtures/refs/rename.yaml +0 -1
  43. package/src/__tests__/fixtures/refs/requestBody.yaml +0 -9
  44. package/src/__tests__/fixtures/refs/schema-a.yaml +0 -1
  45. package/src/__tests__/fixtures/refs/simple.yaml +0 -1
  46. package/src/__tests__/fixtures/refs/vendor.schema.yaml +0 -20
  47. package/src/__tests__/fixtures/resolve/External.yaml +0 -10
  48. package/src/__tests__/fixtures/resolve/External2.yaml +0 -4
  49. package/src/__tests__/fixtures/resolve/description.md +0 -3
  50. package/src/__tests__/fixtures/resolve/externalInfo.yaml +0 -4
  51. package/src/__tests__/fixtures/resolve/externalLicense.yaml +0 -1
  52. package/src/__tests__/fixtures/resolve/openapi-with-back.yaml +0 -13
  53. package/src/__tests__/fixtures/resolve/openapi-with-md-description.yaml +0 -5
  54. package/src/__tests__/fixtures/resolve/openapi.yaml +0 -28
  55. package/src/__tests__/fixtures/resolve/schemas/type-a.yaml +0 -10
  56. package/src/__tests__/fixtures/resolve/schemas/type-b.yaml +0 -6
  57. package/src/__tests__/fixtures/resolve/transitive/a.yaml +0 -1
  58. package/src/__tests__/fixtures/resolve/transitive/components.yaml +0 -5
  59. package/src/__tests__/fixtures/resolve/transitive/schemas.yaml +0 -3
  60. package/src/__tests__/format.test.ts +0 -76
  61. package/src/__tests__/js-yaml.test.ts +0 -73
  62. package/src/__tests__/lint.test.ts +0 -388
  63. package/src/__tests__/logger-browser.test.ts +0 -53
  64. package/src/__tests__/logger.test.ts +0 -47
  65. package/src/__tests__/login.test.ts +0 -17
  66. package/src/__tests__/normalizeVisitors.test.ts +0 -151
  67. package/src/__tests__/output-browser.test.ts +0 -18
  68. package/src/__tests__/output.test.ts +0 -15
  69. package/src/__tests__/ref-utils.test.ts +0 -120
  70. package/src/__tests__/resolve-http.test.ts +0 -77
  71. package/src/__tests__/resolve.test.ts +0 -430
  72. package/src/__tests__/utils-browser.test.ts +0 -11
  73. package/src/__tests__/utils.test.ts +0 -144
  74. package/src/__tests__/walk.test.ts +0 -1545
  75. package/src/benchmark/benches/lint-with-many-rules.bench.ts +0 -35
  76. package/src/benchmark/benches/lint-with-nested-rule.bench.ts +0 -39
  77. package/src/benchmark/benches/lint-with-no-rules.bench.ts +0 -20
  78. package/src/benchmark/benches/lint-with-top-level-rule-report.bench.ts +0 -35
  79. package/src/benchmark/benches/lint-with-top-level-rule.bench.ts +0 -32
  80. package/src/benchmark/benches/rebilly.yaml +0 -32275
  81. package/src/benchmark/benches/recommended-oas3.bench.ts +0 -22
  82. package/src/benchmark/benches/resolve-with-no-external.bench.ts +0 -23
  83. package/src/benchmark/benchmark.js +0 -311
  84. package/src/benchmark/colors.js +0 -29
  85. package/src/benchmark/fork.js +0 -83
  86. package/src/benchmark/utils.ts +0 -36
  87. package/src/bundle.ts +0 -399
  88. package/src/config/__tests__/__snapshots__/config-resolvers.test.ts.snap +0 -161
  89. package/src/config/__tests__/__snapshots__/config.test.ts.snap +0 -144
  90. package/src/config/__tests__/config-resolvers.test.ts +0 -491
  91. package/src/config/__tests__/config.test.ts +0 -307
  92. package/src/config/__tests__/fixtures/ingore-file.ts +0 -8
  93. package/src/config/__tests__/fixtures/load-redocly.yaml +0 -2
  94. package/src/config/__tests__/fixtures/plugin-config.yaml +0 -2
  95. package/src/config/__tests__/fixtures/plugin.js +0 -56
  96. package/src/config/__tests__/fixtures/resolve-config/api/nested-config.yaml +0 -11
  97. package/src/config/__tests__/fixtures/resolve-config/api/plugin.js +0 -69
  98. package/src/config/__tests__/fixtures/resolve-config/local-config-with-circular.yaml +0 -7
  99. package/src/config/__tests__/fixtures/resolve-config/local-config-with-custom-function.yaml +0 -17
  100. package/src/config/__tests__/fixtures/resolve-config/local-config-with-file.yaml +0 -18
  101. package/src/config/__tests__/fixtures/resolve-config/local-config-with-wrong-custom-function.yaml +0 -15
  102. package/src/config/__tests__/fixtures/resolve-config/local-config.yaml +0 -9
  103. package/src/config/__tests__/fixtures/resolve-config/plugin.js +0 -80
  104. package/src/config/__tests__/fixtures/resolve-remote-configs/nested-remote-config.yaml +0 -3
  105. package/src/config/__tests__/fixtures/resolve-remote-configs/remote-config.yaml +0 -4
  106. package/src/config/__tests__/load.test.ts +0 -167
  107. package/src/config/__tests__/resolve-plugins.test.ts +0 -27
  108. package/src/config/__tests__/utils.test.ts +0 -204
  109. package/src/config/all.ts +0 -73
  110. package/src/config/builtIn.ts +0 -37
  111. package/src/config/config-resolvers.ts +0 -465
  112. package/src/config/config.ts +0 -330
  113. package/src/config/index.ts +0 -7
  114. package/src/config/load.ts +0 -144
  115. package/src/config/minimal.ts +0 -60
  116. package/src/config/recommended.ts +0 -60
  117. package/src/config/rules.ts +0 -54
  118. package/src/config/types.ts +0 -216
  119. package/src/config/utils.ts +0 -333
  120. package/src/decorators/__tests__/filter-in.test.ts +0 -310
  121. package/src/decorators/__tests__/filter-out.test.ts +0 -335
  122. package/src/decorators/__tests__/media-type-examples-override.test.ts +0 -665
  123. package/src/decorators/__tests__/remove-x-internal.test.ts +0 -316
  124. package/src/decorators/__tests__/resources/request.yaml +0 -3
  125. package/src/decorators/__tests__/resources/response.yaml +0 -3
  126. package/src/decorators/common/filters/filter-helper.ts +0 -72
  127. package/src/decorators/common/filters/filter-in.ts +0 -18
  128. package/src/decorators/common/filters/filter-out.ts +0 -18
  129. package/src/decorators/common/info-description-override.ts +0 -24
  130. package/src/decorators/common/info-override.ts +0 -15
  131. package/src/decorators/common/media-type-examples-override.ts +0 -79
  132. package/src/decorators/common/operation-description-override.ts +0 -30
  133. package/src/decorators/common/registry-dependencies.ts +0 -25
  134. package/src/decorators/common/remove-x-internal.ts +0 -59
  135. package/src/decorators/common/tag-description-override.ts +0 -25
  136. package/src/decorators/oas2/index.ts +0 -20
  137. package/src/decorators/oas3/index.ts +0 -22
  138. package/src/env.ts +0 -5
  139. package/src/format/codeframes.ts +0 -216
  140. package/src/format/format.ts +0 -375
  141. package/src/index.ts +0 -71
  142. package/src/js-yaml/index.ts +0 -14
  143. package/src/lint.ts +0 -130
  144. package/src/logger.ts +0 -34
  145. package/src/oas-types.ts +0 -57
  146. package/src/output.ts +0 -7
  147. package/src/redocly/__tests__/redocly-client.test.ts +0 -146
  148. package/src/redocly/index.ts +0 -187
  149. package/src/redocly/redocly-client-types.ts +0 -10
  150. package/src/redocly/registry-api-types.ts +0 -32
  151. package/src/redocly/registry-api.ts +0 -149
  152. package/src/ref-utils.ts +0 -85
  153. package/src/resolve.ts +0 -417
  154. package/src/rules/__tests__/fixtures/code-sample.php +0 -9
  155. package/src/rules/__tests__/fixtures/invalid-yaml.yaml +0 -1
  156. package/src/rules/__tests__/fixtures/ref.yaml +0 -1
  157. package/src/rules/__tests__/no-unresolved-refs.test.ts +0 -257
  158. package/src/rules/__tests__/utils.test.ts +0 -160
  159. package/src/rules/ajv.ts +0 -102
  160. package/src/rules/common/__tests__/info-license.test.ts +0 -62
  161. package/src/rules/common/__tests__/license-url.test.ts +0 -63
  162. package/src/rules/common/__tests__/no-ambiguous-paths.test.ts +0 -96
  163. package/src/rules/common/__tests__/no-enum-type-mismatch.test.ts +0 -210
  164. package/src/rules/common/__tests__/no-identical-paths.test.ts +0 -58
  165. package/src/rules/common/__tests__/no-path-trailing-slash.test.ts +0 -85
  166. package/src/rules/common/__tests__/operation-2xx-response.test.ts +0 -192
  167. package/src/rules/common/__tests__/operation-4xx-response.test.ts +0 -231
  168. package/src/rules/common/__tests__/operation-operationId-unique.test.ts +0 -76
  169. package/src/rules/common/__tests__/operation-operationId-url-safe.test.ts +0 -45
  170. package/src/rules/common/__tests__/operation-parameters-unique.test.ts +0 -167
  171. package/src/rules/common/__tests__/operation-singular-tag.test.ts +0 -72
  172. package/src/rules/common/__tests__/path-http-verbs-order.test.ts +0 -95
  173. package/src/rules/common/__tests__/path-not-include-query.test.ts +0 -64
  174. package/src/rules/common/__tests__/path-params-defined.test.ts +0 -202
  175. package/src/rules/common/__tests__/paths-kebab-case.test.ts +0 -108
  176. package/src/rules/common/__tests__/scalar-property-missing-example.test.ts +0 -264
  177. package/src/rules/common/__tests__/security-defined.test.ts +0 -175
  178. package/src/rules/common/__tests__/spec.test.ts +0 -555
  179. package/src/rules/common/__tests__/tag-description.test.ts +0 -65
  180. package/src/rules/common/__tests__/tags-alphabetical.test.ts +0 -64
  181. package/src/rules/common/assertions/__tests__/asserts.test.ts +0 -869
  182. package/src/rules/common/assertions/__tests__/index.test.ts +0 -100
  183. package/src/rules/common/assertions/__tests__/utils.test.ts +0 -236
  184. package/src/rules/common/assertions/asserts.ts +0 -357
  185. package/src/rules/common/assertions/index.ts +0 -56
  186. package/src/rules/common/assertions/utils.ts +0 -331
  187. package/src/rules/common/info-contact.ts +0 -15
  188. package/src/rules/common/info-license-url.ts +0 -10
  189. package/src/rules/common/info-license.ts +0 -15
  190. package/src/rules/common/no-ambiguous-paths.ts +0 -50
  191. package/src/rules/common/no-enum-type-mismatch.ts +0 -52
  192. package/src/rules/common/no-http-verbs-in-paths.ts +0 -36
  193. package/src/rules/common/no-identical-paths.ts +0 -24
  194. package/src/rules/common/no-invalid-parameter-examples.ts +0 -36
  195. package/src/rules/common/no-invalid-schema-examples.ts +0 -27
  196. package/src/rules/common/no-path-trailing-slash.ts +0 -15
  197. package/src/rules/common/operation-2xx-response.ts +0 -24
  198. package/src/rules/common/operation-4xx-response.ts +0 -24
  199. package/src/rules/common/operation-description.ts +0 -13
  200. package/src/rules/common/operation-operationId-unique.ts +0 -21
  201. package/src/rules/common/operation-operationId-url-safe.ts +0 -19
  202. package/src/rules/common/operation-operationId.ts +0 -17
  203. package/src/rules/common/operation-parameters-unique.ts +0 -48
  204. package/src/rules/common/operation-singular-tag.ts +0 -17
  205. package/src/rules/common/operation-summary.ts +0 -13
  206. package/src/rules/common/operation-tag-defined.ts +0 -26
  207. package/src/rules/common/parameter-description.ts +0 -22
  208. package/src/rules/common/path-declaration-must-exist.ts +0 -15
  209. package/src/rules/common/path-excludes-patterns.ts +0 -23
  210. package/src/rules/common/path-http-verbs-order.ts +0 -30
  211. package/src/rules/common/path-not-include-query.ts +0 -17
  212. package/src/rules/common/path-params-defined.ts +0 -65
  213. package/src/rules/common/path-segment-plural.ts +0 -31
  214. package/src/rules/common/paths-kebab-case.ts +0 -19
  215. package/src/rules/common/required-string-property-missing-min-length.ts +0 -44
  216. package/src/rules/common/response-contains-header.ts +0 -35
  217. package/src/rules/common/scalar-property-missing-example.ts +0 -58
  218. package/src/rules/common/security-defined.ts +0 -65
  219. package/src/rules/common/spec.ts +0 -174
  220. package/src/rules/common/tag-description.ts +0 -10
  221. package/src/rules/common/tags-alphabetical.ts +0 -20
  222. package/src/rules/no-unresolved-refs.ts +0 -51
  223. package/src/rules/oas2/__tests__/boolean-parameter-prefixes.test.ts +0 -110
  224. package/src/rules/oas2/__tests__/response-contains-header.test.ts +0 -174
  225. package/src/rules/oas2/__tests__/response-contains-property.test.ts +0 -155
  226. package/src/rules/oas2/__tests__/spec/fixtures/description.md +0 -1
  227. package/src/rules/oas2/__tests__/spec/info.test.ts +0 -355
  228. package/src/rules/oas2/__tests__/spec/operation.test.ts +0 -123
  229. package/src/rules/oas2/__tests__/spec/paths.test.ts +0 -245
  230. package/src/rules/oas2/__tests__/spec/referenceableScalars.test.ts +0 -35
  231. package/src/rules/oas2/__tests__/spec/utils.ts +0 -32
  232. package/src/rules/oas2/boolean-parameter-prefixes.ts +0 -26
  233. package/src/rules/oas2/index.ts +0 -89
  234. package/src/rules/oas2/remove-unused-components.ts +0 -81
  235. package/src/rules/oas2/request-mime-type.ts +0 -17
  236. package/src/rules/oas2/response-contains-property.ts +0 -36
  237. package/src/rules/oas2/response-mime-type.ts +0 -17
  238. package/src/rules/oas3/__tests__/boolean-parameter-prefixes.test.ts +0 -111
  239. package/src/rules/oas3/__tests__/fixtures/common.yaml +0 -11
  240. package/src/rules/oas3/__tests__/no-empty-enum-servers.com.test.ts +0 -205
  241. package/src/rules/oas3/__tests__/no-example-value-and-externalValue.test.ts +0 -65
  242. package/src/rules/oas3/__tests__/no-invalid-media-type-examples.test.ts +0 -473
  243. package/src/rules/oas3/__tests__/no-server-example.com.test.ts +0 -60
  244. package/src/rules/oas3/__tests__/no-server-trailing-slash.test.ts +0 -79
  245. package/src/rules/oas3/__tests__/no-unused-components.test.ts +0 -131
  246. package/src/rules/oas3/__tests__/operation-4xx-problem-details-rfc7807.test.ts +0 -145
  247. package/src/rules/oas3/__tests__/response-contains-header.test.ts +0 -389
  248. package/src/rules/oas3/__tests__/response-contains-property.test.ts +0 -403
  249. package/src/rules/oas3/__tests__/spec/callbacks.test.ts +0 -41
  250. package/src/rules/oas3/__tests__/spec/fixtures/description.md +0 -1
  251. package/src/rules/oas3/__tests__/spec/info.test.ts +0 -391
  252. package/src/rules/oas3/__tests__/spec/operation.test.ts +0 -253
  253. package/src/rules/oas3/__tests__/spec/paths.test.ts +0 -284
  254. package/src/rules/oas3/__tests__/spec/referenceableScalars.test.ts +0 -77
  255. package/src/rules/oas3/__tests__/spec/servers.test.ts +0 -505
  256. package/src/rules/oas3/__tests__/spec/spec.test.ts +0 -298
  257. package/src/rules/oas3/__tests__/spec/utils.ts +0 -32
  258. package/src/rules/oas3/__tests__/spec-components-invalid-map-name.test.ts +0 -305
  259. package/src/rules/oas3/boolean-parameter-prefixes.ts +0 -28
  260. package/src/rules/oas3/index.ts +0 -109
  261. package/src/rules/oas3/no-empty-servers.ts +0 -22
  262. package/src/rules/oas3/no-example-value-and-externalValue.ts +0 -14
  263. package/src/rules/oas3/no-invalid-media-type-examples.ts +0 -49
  264. package/src/rules/oas3/no-server-example.com.ts +0 -14
  265. package/src/rules/oas3/no-server-trailing-slash.ts +0 -15
  266. package/src/rules/oas3/no-server-variables-empty-enum.ts +0 -66
  267. package/src/rules/oas3/no-undefined-server-variable.ts +0 -30
  268. package/src/rules/oas3/no-unused-components.ts +0 -75
  269. package/src/rules/oas3/operation-4xx-problem-details-rfc7807.ts +0 -36
  270. package/src/rules/oas3/remove-unused-components.ts +0 -95
  271. package/src/rules/oas3/request-mime-type.ts +0 -31
  272. package/src/rules/oas3/response-contains-property.ts +0 -38
  273. package/src/rules/oas3/response-mime-type.ts +0 -31
  274. package/src/rules/oas3/spec-components-invalid-map-name.ts +0 -74
  275. package/src/rules/other/stats.ts +0 -73
  276. package/src/rules/utils.ts +0 -191
  277. package/src/types/index.ts +0 -149
  278. package/src/types/oas2.ts +0 -478
  279. package/src/types/oas3.ts +0 -597
  280. package/src/types/oas3_1.ts +0 -258
  281. package/src/types/redocly-yaml.ts +0 -1010
  282. package/src/typings/common.ts +0 -17
  283. package/src/typings/openapi.ts +0 -298
  284. package/src/typings/swagger.ts +0 -236
  285. package/src/utils.ts +0 -276
  286. package/src/visitors.ts +0 -491
  287. package/src/walk.ts +0 -453
  288. package/tsconfig.json +0 -8
  289. package/tsconfig.tsbuildinfo +0 -1
@@ -1,505 +0,0 @@
1
- import { outdent } from 'outdent';
2
- import { validateDoc } from './utils';
3
-
4
- describe('OpenAPI Schema', () => {
5
- it('should not report on valid Server Object', async () => {
6
- const source = outdent`
7
- openapi: 3.0.2
8
- info:
9
- title: Example OpenAPI 3 definition. Valid.
10
- version: '1.0'
11
-
12
- servers:
13
- - url: https://server.com/v1
14
- description: Development server
15
-
16
- paths:
17
- '/ping':
18
- get:
19
- responses:
20
- '200':
21
- description: example description
22
- `;
23
-
24
- expect(
25
- await validateDoc(source, {
26
- spec: 'error',
27
- })
28
- ).toMatchInlineSnapshot(`Array []`);
29
- });
30
-
31
- it('should report on empty server URL', async () => {
32
- const source = outdent`
33
- openapi: 3.0.2
34
- info:
35
- title: Example OpenAPI 3 definition. Valid.
36
- version: '1.0'
37
-
38
- servers:
39
- - url:
40
-
41
- paths:
42
- '/ping':
43
- get:
44
- responses:
45
- '200':
46
- description: example description
47
- `;
48
-
49
- expect(
50
- await validateDoc(source, {
51
- spec: 'error',
52
- })
53
- ).toMatchInlineSnapshot(`
54
- Array [
55
- Object {
56
- "location": "#/servers/0/url",
57
- "message": "Expected type \`string\` but got \`null\`.",
58
- },
59
- ]
60
- `);
61
- });
62
-
63
- it('should report on missing server URL', async () => {
64
- const source = outdent`
65
- openapi: 3.0.2
66
- info:
67
- title: Example OpenAPI 3 definition. Valid.
68
- version: '1.0'
69
-
70
- servers:
71
- - description: Development server
72
-
73
- paths:
74
- '/ping':
75
- get:
76
- responses:
77
- '200':
78
- description: example description
79
- `;
80
-
81
- expect(
82
- await validateDoc(source, {
83
- spec: 'error',
84
- })
85
- ).toMatchInlineSnapshot(`
86
- Array [
87
- Object {
88
- "location": "#/servers/0",
89
- "message": "The field \`url\` must be present on this level.",
90
- },
91
- ]
92
- `);
93
- });
94
-
95
- it('should report on empty description field', async () => {
96
- const source = outdent`
97
- openapi: 3.0.2
98
- info:
99
- title: Example OpenAPI 3 definition. Valid.
100
- version: '1.0'
101
-
102
- servers:
103
- - url: https://server.com/v1
104
- description:
105
-
106
- paths:
107
- '/ping':
108
- get:
109
- responses:
110
- '200':
111
- description: example description
112
- `;
113
-
114
- expect(
115
- await validateDoc(source, {
116
- spec: 'error',
117
- })
118
- ).toMatchInlineSnapshot(`
119
- Array [
120
- Object {
121
- "location": "#/servers/0/description",
122
- "message": "Expected type \`string\` but got \`null\`.",
123
- },
124
- ]
125
- `);
126
- });
127
-
128
- it('should not report if description field is missing', async () => {
129
- const source = outdent`
130
- openapi: 3.0.2
131
- info:
132
- title: Example OpenAPI 3 definition. Valid.
133
- version: '1.0'
134
-
135
- servers:
136
- - url: https://example.com
137
-
138
- paths:
139
- '/ping':
140
- get:
141
- responses:
142
- '200':
143
- description: example description
144
- `;
145
-
146
- expect(
147
- await validateDoc(source, {
148
- spec: 'error',
149
- })
150
- ).toMatchInlineSnapshot(`Array []`);
151
- });
152
-
153
- it('should report if fields type in servers are not array', async () => {
154
- const source = outdent`
155
- openapi: 3.0.2
156
- info:
157
- title: Example OpenAPI 3 definition. Valid.
158
- version: '1.0'
159
-
160
- servers:
161
- description: Development server
162
-
163
- paths:
164
- '/ping':
165
- get:
166
- responses:
167
- '200':
168
- description: example description
169
- `;
170
-
171
- expect(
172
- await validateDoc(source, {
173
- spec: 'error',
174
- })
175
- ).toMatchInlineSnapshot(`
176
- Array [
177
- Object {
178
- "location": "#/servers",
179
- "message": "Expected type \`ServerList\` (array) but got \`object\`",
180
- },
181
- ]
182
- `);
183
- });
184
-
185
- it('should not report on multiple servers', async () => {
186
- const source = outdent`
187
- openapi: 3.0.2
188
- info:
189
- title: Example OpenAPI 3 definition. Valid.
190
- version: '1.0'
191
-
192
- servers:
193
- - url: https://development.server.com/v1
194
- description: Development server
195
- - url: https://staging.server.com/v1
196
- description: Staging server
197
- - url: https://api.server.com/v1
198
- description: Production server
199
-
200
- paths:
201
- '/ping':
202
- get:
203
- responses:
204
- '200':
205
- description: example description
206
- `;
207
-
208
- expect(
209
- await validateDoc(source, {
210
- spec: 'error',
211
- })
212
- ).toMatchInlineSnapshot(`Array []`);
213
- });
214
-
215
- it('should not report if variables are used for a server configuration', async () => {
216
- const source = outdent`
217
- openapi: 3.0.2
218
- info:
219
- title: Example OpenAPI 3 definition. Valid.
220
- version: '1.0'
221
-
222
- servers:
223
- - url: https://{username}.server.com:{port}/{basePath}
224
- variables:
225
- username:
226
- default: demo
227
- port:
228
- enum:
229
- - '8443'
230
- - '443'
231
- default: '8443'
232
- basePath:
233
- default: v2
234
-
235
- paths:
236
- '/ping':
237
- get:
238
- responses:
239
- '200':
240
- description: example description
241
- `;
242
-
243
- expect(
244
- await validateDoc(source, {
245
- spec: 'error',
246
- })
247
- ).toMatchInlineSnapshot(`Array []`);
248
- });
249
-
250
- it('should report if array in enum is empty', async () => {
251
- const source = outdent`
252
- openapi: 3.0.2
253
- info:
254
- title: Example OpenAPI 3 definition. Valid.
255
- version: '1.0'
256
-
257
- servers:
258
- - url: https://{username}.server.com:{port}/{basePath}
259
- variables:
260
- username:
261
- default: demo
262
- port:
263
- enum:
264
-
265
- default: '8443'
266
- basePath:
267
- default: v2
268
-
269
- paths:
270
- '/ping':
271
- get:
272
- responses:
273
- '200':
274
- description: example description
275
- `;
276
-
277
- expect(
278
- await validateDoc(source, {
279
- spec: 'error',
280
- })
281
- ).toMatchInlineSnapshot(`
282
- Array [
283
- Object {
284
- "location": "#/servers/0/variables/port/enum",
285
- "message": "Expected type \`array\` but got \`null\`.",
286
- },
287
- ]
288
- `);
289
- });
290
-
291
- it('should report if some variable is not defined', async () => {
292
- const source = outdent`
293
- openapi: 3.0.2
294
- info:
295
- title: Example OpenAPI 3 definition. Valid.
296
- version: '1.0'
297
-
298
- servers:
299
- - url: https://{username}.server.com:{port}/{basePath}
300
- variables:
301
- username:
302
- default: demo
303
- port:
304
- enum:
305
- - '8443'
306
- - '443'
307
- default: '8443'
308
-
309
- paths:
310
- '/ping':
311
- get:
312
- responses:
313
- '200':
314
- description: example description
315
- `;
316
-
317
- expect(
318
- await validateDoc(source, {
319
- 'no-undefined-server-variable': 'error',
320
- })
321
- ).toMatchInlineSnapshot(`
322
- Array [
323
- Object {
324
- "location": "#/servers/0/url",
325
- "message": "The \`basePath\` variable is not defined in the \`variables\` objects.",
326
- },
327
- ]
328
- `);
329
- });
330
-
331
- it('should report if default value is not provided in variables', async () => {
332
- const source = outdent`
333
- openapi: 3.0.2
334
- info:
335
- title: Example OpenAPI 3 definition. Valid.
336
- version: '1.0'
337
-
338
- servers:
339
- - url: https://{username}.server.com:{port}/{basePath}
340
- variables:
341
- username: {}
342
- port:
343
- enum:
344
- - '8443'
345
- - '443'
346
- basePath:
347
- default: v2
348
-
349
- paths:
350
- '/ping':
351
- get:
352
- responses:
353
- '200':
354
- description: example description
355
- `;
356
-
357
- expect(
358
- await validateDoc(source, {
359
- spec: 'error',
360
- })
361
- ).toMatchInlineSnapshot(`
362
- Array [
363
- Object {
364
- "location": "#/servers/0/variables/username",
365
- "message": "The field \`default\` must be present on this level.",
366
- },
367
- Object {
368
- "location": "#/servers/0/variables/port",
369
- "message": "The field \`default\` must be present on this level.",
370
- },
371
- ]
372
- `);
373
- });
374
-
375
- it('should report if default value in variables is empty', async () => {
376
- const source = outdent`
377
- openapi: 3.0.2
378
- info:
379
- title: Example OpenAPI 3 definition. Valid.
380
- version: '1.0'
381
-
382
- servers:
383
- - url: https://{username}.server.com:{port}/{basePath}
384
- variables:
385
- username:
386
- default:
387
- port:
388
- enum:
389
- - '8443'
390
- - '443'
391
- default: '8443'
392
- basePath:
393
- default: v2
394
-
395
- paths:
396
- '/ping':
397
- get:
398
- responses:
399
- '200':
400
- description: example description
401
- `;
402
-
403
- expect(
404
- await validateDoc(source, {
405
- spec: 'error',
406
- })
407
- ).toMatchInlineSnapshot(`
408
- Array [
409
- Object {
410
- "location": "#/servers/0/variables/username/default",
411
- "message": "Expected type \`string\` but got \`null\`.",
412
- },
413
- ]
414
- `);
415
- });
416
-
417
- it('should report if description in variable is not a string', async () => {
418
- const source = outdent`
419
- openapi: 3.0.2
420
- info:
421
- title: Example OpenAPI 3 definition. Valid.
422
- version: '1.0'
423
-
424
- servers:
425
- - url: https://{username}.server.com:{port}/{basePath}
426
- variables:
427
- username:
428
- default: demo
429
- description:
430
- port:
431
- enum:
432
- - '8443'
433
- - '443'
434
- default: '8443'
435
- basePath:
436
- default: v2
437
-
438
- paths:
439
- '/ping':
440
- get:
441
- responses:
442
- '200':
443
- description: example description
444
- `;
445
-
446
- expect(
447
- await validateDoc(source, {
448
- spec: 'error',
449
- })
450
- ).toMatchInlineSnapshot(`
451
- Array [
452
- Object {
453
- "location": "#/servers/0/variables/username/description",
454
- "message": "Expected type \`string\` but got \`null\`.",
455
- },
456
- ]
457
- `);
458
- });
459
-
460
- it('should not report if servers property is not provided', async () => {
461
- const source = outdent`
462
- openapi: 3.0.2
463
- info:
464
- title: Example OpenAPI 3 definition. Valid.
465
- version: '1.0'
466
-
467
- paths:
468
- '/ping':
469
- get:
470
- responses:
471
- '200':
472
- description: example description
473
- `;
474
-
475
- expect(
476
- await validateDoc(source, {
477
- spec: 'error',
478
- })
479
- ).toMatchInlineSnapshot(`Array []`);
480
- });
481
-
482
- it('should not report if servers property is an empty array', async () => {
483
- const source = outdent`
484
- openapi: 3.0.2
485
- info:
486
- title: Example OpenAPI 3 definition. Valid.
487
- version: '1.0'
488
-
489
- servers: []
490
-
491
- paths:
492
- '/ping':
493
- get:
494
- responses:
495
- '200':
496
- description: example description
497
- `;
498
-
499
- expect(
500
- await validateDoc(source, {
501
- spec: 'error',
502
- })
503
- ).toMatchInlineSnapshot(`Array []`);
504
- });
505
- });