@redocly/openapi-core 1.0.0-beta.125 → 1.0.0-beta.127

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 (281) hide show
  1. package/lib/bundle.js +5 -2
  2. package/lib/config/all.js +8 -1
  3. package/lib/resolve.js +5 -1
  4. package/lib/rules/common/required-string-property-missing-min-length.d.ts +1 -1
  5. package/lib/rules/common/required-string-property-missing-min-length.js +3 -3
  6. package/lib/rules/common/spec.js +1 -0
  7. package/lib/rules/oas2/index.js +1 -1
  8. package/lib/rules/oas2/request-mime-type.d.ts +1 -1
  9. package/lib/rules/oas2/response-mime-type.d.ts +1 -1
  10. package/lib/rules/oas3/index.js +1 -1
  11. package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.d.ts +2 -2
  12. package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.js +3 -3
  13. package/lib/rules/oas3/request-mime-type.d.ts +1 -1
  14. package/lib/rules/oas3/response-mime-type.d.ts +1 -1
  15. package/lib/walk.d.ts +6 -5
  16. package/lib/walk.js +23 -27
  17. package/package.json +1 -1
  18. package/__tests__/utils.ts +0 -88
  19. package/src/__tests__/__snapshots__/bundle.test.ts.snap +0 -437
  20. package/src/__tests__/bundle.test.ts +0 -236
  21. package/src/__tests__/codeframes.test.ts +0 -530
  22. package/src/__tests__/fixtures/.redocly.lint-ignore.yaml +0 -5
  23. package/src/__tests__/fixtures/extension.js +0 -24
  24. package/src/__tests__/fixtures/refs/definitions.yaml +0 -3
  25. package/src/__tests__/fixtures/refs/examples.yaml +0 -8
  26. package/src/__tests__/fixtures/refs/external-request-body.yaml +0 -13
  27. package/src/__tests__/fixtures/refs/externalref.yaml +0 -35
  28. package/src/__tests__/fixtures/refs/hosted.yaml +0 -35
  29. package/src/__tests__/fixtures/refs/openapi-with-external-refs-conflicting-names.yaml +0 -21
  30. package/src/__tests__/fixtures/refs/openapi-with-external-refs.yaml +0 -33
  31. package/src/__tests__/fixtures/refs/openapi-with-url-refs.yaml +0 -18
  32. package/src/__tests__/fixtures/refs/param-b.yaml +0 -1
  33. package/src/__tests__/fixtures/refs/param-c.yaml +0 -1
  34. package/src/__tests__/fixtures/refs/rename.yaml +0 -1
  35. package/src/__tests__/fixtures/refs/requestBody.yaml +0 -9
  36. package/src/__tests__/fixtures/refs/schema-a.yaml +0 -1
  37. package/src/__tests__/fixtures/refs/simple.yaml +0 -1
  38. package/src/__tests__/fixtures/refs/vendor.schema.yaml +0 -20
  39. package/src/__tests__/fixtures/resolve/External.yaml +0 -10
  40. package/src/__tests__/fixtures/resolve/External2.yaml +0 -4
  41. package/src/__tests__/fixtures/resolve/description.md +0 -3
  42. package/src/__tests__/fixtures/resolve/externalInfo.yaml +0 -4
  43. package/src/__tests__/fixtures/resolve/externalLicense.yaml +0 -1
  44. package/src/__tests__/fixtures/resolve/openapi-with-back.yaml +0 -13
  45. package/src/__tests__/fixtures/resolve/openapi-with-md-description.yaml +0 -5
  46. package/src/__tests__/fixtures/resolve/openapi.yaml +0 -28
  47. package/src/__tests__/fixtures/resolve/schemas/type-a.yaml +0 -10
  48. package/src/__tests__/fixtures/resolve/schemas/type-b.yaml +0 -6
  49. package/src/__tests__/fixtures/resolve/transitive/a.yaml +0 -1
  50. package/src/__tests__/fixtures/resolve/transitive/components.yaml +0 -5
  51. package/src/__tests__/fixtures/resolve/transitive/schemas.yaml +0 -3
  52. package/src/__tests__/format.test.ts +0 -76
  53. package/src/__tests__/js-yaml.test.ts +0 -73
  54. package/src/__tests__/lint.test.ts +0 -388
  55. package/src/__tests__/logger-browser.test.ts +0 -53
  56. package/src/__tests__/logger.test.ts +0 -47
  57. package/src/__tests__/login.test.ts +0 -17
  58. package/src/__tests__/normalizeVisitors.test.ts +0 -151
  59. package/src/__tests__/output-browser.test.ts +0 -18
  60. package/src/__tests__/output.test.ts +0 -15
  61. package/src/__tests__/ref-utils.test.ts +0 -120
  62. package/src/__tests__/resolve-http.test.ts +0 -77
  63. package/src/__tests__/resolve.test.ts +0 -408
  64. package/src/__tests__/utils-browser.test.ts +0 -11
  65. package/src/__tests__/utils.test.ts +0 -144
  66. package/src/__tests__/walk.test.ts +0 -1545
  67. package/src/benchmark/benches/lint-with-many-rules.bench.ts +0 -35
  68. package/src/benchmark/benches/lint-with-nested-rule.bench.ts +0 -39
  69. package/src/benchmark/benches/lint-with-no-rules.bench.ts +0 -20
  70. package/src/benchmark/benches/lint-with-top-level-rule-report.bench.ts +0 -35
  71. package/src/benchmark/benches/lint-with-top-level-rule.bench.ts +0 -32
  72. package/src/benchmark/benches/rebilly.yaml +0 -32275
  73. package/src/benchmark/benches/recommended-oas3.bench.ts +0 -22
  74. package/src/benchmark/benches/resolve-with-no-external.bench.ts +0 -23
  75. package/src/benchmark/benchmark.js +0 -311
  76. package/src/benchmark/colors.js +0 -29
  77. package/src/benchmark/fork.js +0 -83
  78. package/src/benchmark/utils.ts +0 -36
  79. package/src/bundle.ts +0 -399
  80. package/src/config/__tests__/__snapshots__/config-resolvers.test.ts.snap +0 -161
  81. package/src/config/__tests__/__snapshots__/config.test.ts.snap +0 -144
  82. package/src/config/__tests__/config-resolvers.test.ts +0 -491
  83. package/src/config/__tests__/config.test.ts +0 -307
  84. package/src/config/__tests__/fixtures/ingore-file.ts +0 -8
  85. package/src/config/__tests__/fixtures/load-redocly.yaml +0 -2
  86. package/src/config/__tests__/fixtures/plugin-config.yaml +0 -2
  87. package/src/config/__tests__/fixtures/plugin.js +0 -56
  88. package/src/config/__tests__/fixtures/resolve-config/api/nested-config.yaml +0 -11
  89. package/src/config/__tests__/fixtures/resolve-config/api/plugin.js +0 -69
  90. package/src/config/__tests__/fixtures/resolve-config/local-config-with-circular.yaml +0 -7
  91. package/src/config/__tests__/fixtures/resolve-config/local-config-with-custom-function.yaml +0 -17
  92. package/src/config/__tests__/fixtures/resolve-config/local-config-with-file.yaml +0 -18
  93. package/src/config/__tests__/fixtures/resolve-config/local-config-with-wrong-custom-function.yaml +0 -15
  94. package/src/config/__tests__/fixtures/resolve-config/local-config.yaml +0 -9
  95. package/src/config/__tests__/fixtures/resolve-config/plugin.js +0 -80
  96. package/src/config/__tests__/fixtures/resolve-remote-configs/nested-remote-config.yaml +0 -3
  97. package/src/config/__tests__/fixtures/resolve-remote-configs/remote-config.yaml +0 -4
  98. package/src/config/__tests__/load.test.ts +0 -167
  99. package/src/config/__tests__/resolve-plugins.test.ts +0 -27
  100. package/src/config/__tests__/utils.test.ts +0 -204
  101. package/src/config/all.ts +0 -66
  102. package/src/config/builtIn.ts +0 -37
  103. package/src/config/config-resolvers.ts +0 -465
  104. package/src/config/config.ts +0 -330
  105. package/src/config/index.ts +0 -7
  106. package/src/config/load.ts +0 -144
  107. package/src/config/minimal.ts +0 -60
  108. package/src/config/recommended.ts +0 -60
  109. package/src/config/rules.ts +0 -54
  110. package/src/config/types.ts +0 -216
  111. package/src/config/utils.ts +0 -333
  112. package/src/decorators/__tests__/filter-in.test.ts +0 -310
  113. package/src/decorators/__tests__/filter-out.test.ts +0 -335
  114. package/src/decorators/__tests__/media-type-examples-override.test.ts +0 -665
  115. package/src/decorators/__tests__/remove-x-internal.test.ts +0 -316
  116. package/src/decorators/__tests__/resources/request.yaml +0 -3
  117. package/src/decorators/__tests__/resources/response.yaml +0 -3
  118. package/src/decorators/common/filters/filter-helper.ts +0 -72
  119. package/src/decorators/common/filters/filter-in.ts +0 -18
  120. package/src/decorators/common/filters/filter-out.ts +0 -18
  121. package/src/decorators/common/info-description-override.ts +0 -24
  122. package/src/decorators/common/info-override.ts +0 -15
  123. package/src/decorators/common/media-type-examples-override.ts +0 -79
  124. package/src/decorators/common/operation-description-override.ts +0 -30
  125. package/src/decorators/common/registry-dependencies.ts +0 -25
  126. package/src/decorators/common/remove-x-internal.ts +0 -59
  127. package/src/decorators/common/tag-description-override.ts +0 -25
  128. package/src/decorators/oas2/index.ts +0 -20
  129. package/src/decorators/oas3/index.ts +0 -22
  130. package/src/env.ts +0 -5
  131. package/src/format/codeframes.ts +0 -216
  132. package/src/format/format.ts +0 -375
  133. package/src/index.ts +0 -71
  134. package/src/js-yaml/index.ts +0 -14
  135. package/src/lint.ts +0 -130
  136. package/src/logger.ts +0 -34
  137. package/src/oas-types.ts +0 -57
  138. package/src/output.ts +0 -7
  139. package/src/redocly/__tests__/redocly-client.test.ts +0 -146
  140. package/src/redocly/index.ts +0 -187
  141. package/src/redocly/redocly-client-types.ts +0 -10
  142. package/src/redocly/registry-api-types.ts +0 -32
  143. package/src/redocly/registry-api.ts +0 -149
  144. package/src/ref-utils.ts +0 -85
  145. package/src/resolve.ts +0 -412
  146. package/src/rules/__tests__/fixtures/code-sample.php +0 -9
  147. package/src/rules/__tests__/fixtures/invalid-yaml.yaml +0 -1
  148. package/src/rules/__tests__/fixtures/ref.yaml +0 -1
  149. package/src/rules/__tests__/no-unresolved-refs.test.ts +0 -257
  150. package/src/rules/__tests__/utils.test.ts +0 -160
  151. package/src/rules/ajv.ts +0 -102
  152. package/src/rules/common/__tests__/info-license.test.ts +0 -62
  153. package/src/rules/common/__tests__/license-url.test.ts +0 -63
  154. package/src/rules/common/__tests__/no-ambiguous-paths.test.ts +0 -96
  155. package/src/rules/common/__tests__/no-enum-type-mismatch.test.ts +0 -210
  156. package/src/rules/common/__tests__/no-identical-paths.test.ts +0 -58
  157. package/src/rules/common/__tests__/no-path-trailing-slash.test.ts +0 -85
  158. package/src/rules/common/__tests__/operation-2xx-response.test.ts +0 -192
  159. package/src/rules/common/__tests__/operation-4xx-response.test.ts +0 -231
  160. package/src/rules/common/__tests__/operation-operationId-unique.test.ts +0 -76
  161. package/src/rules/common/__tests__/operation-operationId-url-safe.test.ts +0 -45
  162. package/src/rules/common/__tests__/operation-parameters-unique.test.ts +0 -167
  163. package/src/rules/common/__tests__/operation-singular-tag.test.ts +0 -72
  164. package/src/rules/common/__tests__/path-http-verbs-order.test.ts +0 -95
  165. package/src/rules/common/__tests__/path-not-include-query.test.ts +0 -64
  166. package/src/rules/common/__tests__/path-params-defined.test.ts +0 -202
  167. package/src/rules/common/__tests__/paths-kebab-case.test.ts +0 -108
  168. package/src/rules/common/__tests__/scalar-property-missing-example.test.ts +0 -264
  169. package/src/rules/common/__tests__/security-defined.test.ts +0 -175
  170. package/src/rules/common/__tests__/spec.test.ts +0 -555
  171. package/src/rules/common/__tests__/tag-description.test.ts +0 -65
  172. package/src/rules/common/__tests__/tags-alphabetical.test.ts +0 -64
  173. package/src/rules/common/assertions/__tests__/asserts.test.ts +0 -869
  174. package/src/rules/common/assertions/__tests__/index.test.ts +0 -100
  175. package/src/rules/common/assertions/__tests__/utils.test.ts +0 -236
  176. package/src/rules/common/assertions/asserts.ts +0 -357
  177. package/src/rules/common/assertions/index.ts +0 -56
  178. package/src/rules/common/assertions/utils.ts +0 -331
  179. package/src/rules/common/info-contact.ts +0 -15
  180. package/src/rules/common/info-license-url.ts +0 -10
  181. package/src/rules/common/info-license.ts +0 -15
  182. package/src/rules/common/no-ambiguous-paths.ts +0 -50
  183. package/src/rules/common/no-enum-type-mismatch.ts +0 -52
  184. package/src/rules/common/no-http-verbs-in-paths.ts +0 -36
  185. package/src/rules/common/no-identical-paths.ts +0 -24
  186. package/src/rules/common/no-invalid-parameter-examples.ts +0 -36
  187. package/src/rules/common/no-invalid-schema-examples.ts +0 -27
  188. package/src/rules/common/no-path-trailing-slash.ts +0 -15
  189. package/src/rules/common/operation-2xx-response.ts +0 -24
  190. package/src/rules/common/operation-4xx-response.ts +0 -24
  191. package/src/rules/common/operation-description.ts +0 -13
  192. package/src/rules/common/operation-operationId-unique.ts +0 -21
  193. package/src/rules/common/operation-operationId-url-safe.ts +0 -19
  194. package/src/rules/common/operation-operationId.ts +0 -17
  195. package/src/rules/common/operation-parameters-unique.ts +0 -48
  196. package/src/rules/common/operation-singular-tag.ts +0 -17
  197. package/src/rules/common/operation-summary.ts +0 -13
  198. package/src/rules/common/operation-tag-defined.ts +0 -26
  199. package/src/rules/common/parameter-description.ts +0 -22
  200. package/src/rules/common/path-declaration-must-exist.ts +0 -15
  201. package/src/rules/common/path-excludes-patterns.ts +0 -23
  202. package/src/rules/common/path-http-verbs-order.ts +0 -30
  203. package/src/rules/common/path-not-include-query.ts +0 -17
  204. package/src/rules/common/path-params-defined.ts +0 -65
  205. package/src/rules/common/path-segment-plural.ts +0 -31
  206. package/src/rules/common/paths-kebab-case.ts +0 -19
  207. package/src/rules/common/required-string-property-missing-min-length.ts +0 -44
  208. package/src/rules/common/response-contains-header.ts +0 -35
  209. package/src/rules/common/scalar-property-missing-example.ts +0 -58
  210. package/src/rules/common/security-defined.ts +0 -65
  211. package/src/rules/common/spec.ts +0 -174
  212. package/src/rules/common/tag-description.ts +0 -10
  213. package/src/rules/common/tags-alphabetical.ts +0 -20
  214. package/src/rules/no-unresolved-refs.ts +0 -51
  215. package/src/rules/oas2/__tests__/boolean-parameter-prefixes.test.ts +0 -110
  216. package/src/rules/oas2/__tests__/response-contains-header.test.ts +0 -174
  217. package/src/rules/oas2/__tests__/response-contains-property.test.ts +0 -155
  218. package/src/rules/oas2/__tests__/spec/fixtures/description.md +0 -1
  219. package/src/rules/oas2/__tests__/spec/info.test.ts +0 -355
  220. package/src/rules/oas2/__tests__/spec/operation.test.ts +0 -123
  221. package/src/rules/oas2/__tests__/spec/paths.test.ts +0 -245
  222. package/src/rules/oas2/__tests__/spec/referenceableScalars.test.ts +0 -35
  223. package/src/rules/oas2/__tests__/spec/utils.ts +0 -32
  224. package/src/rules/oas2/boolean-parameter-prefixes.ts +0 -26
  225. package/src/rules/oas2/index.ts +0 -89
  226. package/src/rules/oas2/remove-unused-components.ts +0 -81
  227. package/src/rules/oas2/request-mime-type.ts +0 -17
  228. package/src/rules/oas2/response-contains-property.ts +0 -36
  229. package/src/rules/oas2/response-mime-type.ts +0 -17
  230. package/src/rules/oas3/__tests__/boolean-parameter-prefixes.test.ts +0 -111
  231. package/src/rules/oas3/__tests__/fixtures/common.yaml +0 -11
  232. package/src/rules/oas3/__tests__/no-empty-enum-servers.com.test.ts +0 -205
  233. package/src/rules/oas3/__tests__/no-example-value-and-externalValue.test.ts +0 -65
  234. package/src/rules/oas3/__tests__/no-invalid-media-type-examples.test.ts +0 -473
  235. package/src/rules/oas3/__tests__/no-server-example.com.test.ts +0 -60
  236. package/src/rules/oas3/__tests__/no-server-trailing-slash.test.ts +0 -79
  237. package/src/rules/oas3/__tests__/no-unused-components.test.ts +0 -131
  238. package/src/rules/oas3/__tests__/operation-4xx-problem-details-rfc7807.test.ts +0 -145
  239. package/src/rules/oas3/__tests__/response-contains-header.test.ts +0 -389
  240. package/src/rules/oas3/__tests__/response-contains-property.test.ts +0 -403
  241. package/src/rules/oas3/__tests__/spec/callbacks.test.ts +0 -41
  242. package/src/rules/oas3/__tests__/spec/fixtures/description.md +0 -1
  243. package/src/rules/oas3/__tests__/spec/info.test.ts +0 -391
  244. package/src/rules/oas3/__tests__/spec/operation.test.ts +0 -253
  245. package/src/rules/oas3/__tests__/spec/paths.test.ts +0 -284
  246. package/src/rules/oas3/__tests__/spec/referenceableScalars.test.ts +0 -77
  247. package/src/rules/oas3/__tests__/spec/servers.test.ts +0 -505
  248. package/src/rules/oas3/__tests__/spec/spec.test.ts +0 -298
  249. package/src/rules/oas3/__tests__/spec/utils.ts +0 -32
  250. package/src/rules/oas3/__tests__/spec-components-invalid-map-name.test.ts +0 -305
  251. package/src/rules/oas3/boolean-parameter-prefixes.ts +0 -28
  252. package/src/rules/oas3/index.ts +0 -109
  253. package/src/rules/oas3/no-empty-servers.ts +0 -22
  254. package/src/rules/oas3/no-example-value-and-externalValue.ts +0 -14
  255. package/src/rules/oas3/no-invalid-media-type-examples.ts +0 -49
  256. package/src/rules/oas3/no-server-example.com.ts +0 -14
  257. package/src/rules/oas3/no-server-trailing-slash.ts +0 -15
  258. package/src/rules/oas3/no-server-variables-empty-enum.ts +0 -66
  259. package/src/rules/oas3/no-undefined-server-variable.ts +0 -30
  260. package/src/rules/oas3/no-unused-components.ts +0 -75
  261. package/src/rules/oas3/operation-4xx-problem-details-rfc7807.ts +0 -36
  262. package/src/rules/oas3/remove-unused-components.ts +0 -95
  263. package/src/rules/oas3/request-mime-type.ts +0 -31
  264. package/src/rules/oas3/response-contains-property.ts +0 -38
  265. package/src/rules/oas3/response-mime-type.ts +0 -31
  266. package/src/rules/oas3/spec-components-invalid-map-name.ts +0 -74
  267. package/src/rules/other/stats.ts +0 -73
  268. package/src/rules/utils.ts +0 -191
  269. package/src/types/index.ts +0 -149
  270. package/src/types/oas2.ts +0 -478
  271. package/src/types/oas3.ts +0 -597
  272. package/src/types/oas3_1.ts +0 -258
  273. package/src/types/redocly-yaml.ts +0 -1010
  274. package/src/typings/common.ts +0 -17
  275. package/src/typings/openapi.ts +0 -298
  276. package/src/typings/swagger.ts +0 -236
  277. package/src/utils.ts +0 -276
  278. package/src/visitors.ts +0 -491
  279. package/src/walk.ts +0 -453
  280. package/tsconfig.json +0 -8
  281. 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
- });