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