@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,491 +0,0 @@
1
- import { colorize } from '../../logger';
2
- import { Asserts, asserts } from '../../rules/common/assertions/asserts';
3
- import { resolveStyleguideConfig, resolveApis, resolveConfig } from '../config-resolvers';
4
- const path = require('path');
5
-
6
- import type { StyleguideRawConfig, RawConfig } from '../types';
7
-
8
- const configPath = path.join(__dirname, 'fixtures/resolve-config/.redocly.yaml');
9
- const baseStyleguideConfig: StyleguideRawConfig = {
10
- rules: {
11
- 'operation-2xx-response': 'warn',
12
- },
13
- };
14
-
15
- const minimalStyleguidePreset = resolveStyleguideConfig({
16
- styleguideConfig: { ...baseStyleguideConfig, extends: ['minimal'] },
17
- });
18
-
19
- const recommendedStyleguidePreset = resolveStyleguideConfig({
20
- styleguideConfig: { ...baseStyleguideConfig, extends: ['recommended'] },
21
- });
22
-
23
- const removeAbsolutePath = (item: string) =>
24
- item.match(/^.*\/packages\/core\/src\/config\/__tests__\/fixtures\/(.*)$/)![1];
25
-
26
- describe('resolveStyleguideConfig', () => {
27
- it('should return the config with no recommended', async () => {
28
- const styleguide = await resolveStyleguideConfig({ styleguideConfig: baseStyleguideConfig });
29
- expect(styleguide.plugins?.length).toEqual(1);
30
- expect(styleguide.plugins?.[0].id).toEqual('');
31
- expect(styleguide.rules).toEqual({
32
- 'operation-2xx-response': 'warn',
33
- });
34
- });
35
-
36
- it('should return the config with correct order by preset', async () => {
37
- expect(
38
- await resolveStyleguideConfig({
39
- styleguideConfig: { ...baseStyleguideConfig, extends: ['minimal', 'recommended'] },
40
- })
41
- ).toEqual(await recommendedStyleguidePreset);
42
- expect(
43
- await resolveStyleguideConfig({
44
- styleguideConfig: { ...baseStyleguideConfig, extends: ['recommended', 'minimal'] },
45
- })
46
- ).toEqual(await minimalStyleguidePreset);
47
- });
48
-
49
- it('should return the same styleguideConfig when extends is empty array', async () => {
50
- const configWithEmptyExtends = await resolveStyleguideConfig({
51
- styleguideConfig: { ...baseStyleguideConfig, extends: [] },
52
- });
53
- expect(configWithEmptyExtends.plugins?.length).toEqual(1);
54
- expect(configWithEmptyExtends.plugins?.[0].id).toEqual('');
55
- expect(configWithEmptyExtends.rules).toEqual({
56
- 'operation-2xx-response': 'warn',
57
- });
58
- });
59
-
60
- it('should resolve extends with local file config', async () => {
61
- const config = {
62
- ...baseStyleguideConfig,
63
- extends: ['local-config.yaml'],
64
- };
65
-
66
- const { plugins, ...styleguide } = await resolveStyleguideConfig({
67
- styleguideConfig: config,
68
- configPath,
69
- });
70
-
71
- expect(styleguide?.rules?.['operation-2xx-response']).toEqual('warn');
72
- expect(plugins).toBeDefined();
73
- expect(plugins?.length).toBe(2);
74
-
75
- expect(styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
76
- 'resolve-config/.redocly.yaml',
77
- 'resolve-config/local-config.yaml',
78
- 'resolve-config/.redocly.yaml',
79
- ]);
80
- expect(styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual(['resolve-config/plugin.js']);
81
-
82
- expect(styleguide.rules).toEqual({
83
- 'boolean-parameter-prefixes': 'error',
84
- 'local/operation-id-not-test': 'error',
85
- 'no-invalid-media-type-examples': 'error',
86
- 'operation-2xx-response': 'warn',
87
- 'operation-description': 'error',
88
- 'path-http-verbs-order': 'error',
89
- });
90
- });
91
-
92
- // TODO: fix circular test
93
- it.skip('should throw circular error', () => {
94
- const config = {
95
- ...baseStyleguideConfig,
96
- extends: ['local-config-with-circular.yaml'],
97
- };
98
- expect(() => {
99
- resolveStyleguideConfig({ styleguideConfig: config, configPath });
100
- }).toThrow('Circular dependency in config file');
101
- });
102
-
103
- it('should resolve extends with local file config which contains path to nested config', async () => {
104
- const styleguideConfig = {
105
- extends: ['local-config-with-file.yaml'],
106
- };
107
- const { plugins, ...styleguide } = await resolveStyleguideConfig({
108
- styleguideConfig,
109
- configPath,
110
- });
111
-
112
- expect(styleguide?.rules?.['no-invalid-media-type-examples']).toEqual('warn');
113
- expect(styleguide?.rules?.['operation-4xx-response']).toEqual('off');
114
- expect(styleguide?.rules?.['operation-2xx-response']).toEqual('error');
115
- expect(plugins).toBeDefined();
116
- expect(plugins?.length).toBe(3);
117
-
118
- expect(styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
119
- 'resolve-config/.redocly.yaml',
120
- 'resolve-config/local-config-with-file.yaml',
121
- 'resolve-config/api/nested-config.yaml',
122
- 'resolve-config/.redocly.yaml',
123
- ]);
124
- expect(styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual([
125
- 'resolve-config/api/plugin.js',
126
- 'resolve-config/plugin.js',
127
- 'resolve-config/api/plugin.js',
128
- ]);
129
-
130
- delete styleguide.extendPaths;
131
- delete styleguide.pluginPaths;
132
- expect(styleguide).toMatchSnapshot();
133
- });
134
-
135
- it('should resolve custom assertion from plugin', async () => {
136
- const styleguideConfig = {
137
- extends: ['local-config-with-custom-function.yaml'],
138
- };
139
- const { plugins } = await resolveStyleguideConfig({
140
- styleguideConfig,
141
- configPath,
142
- });
143
-
144
- expect(plugins).toBeDefined();
145
- expect(plugins?.length).toBe(2);
146
- expect(asserts['test-plugin/checkWordsCount' as keyof Asserts]).toBeDefined();
147
- });
148
-
149
- it('should throw error when custom assertion load not exist plugin', async () => {
150
- const styleguideConfig = {
151
- extends: ['local-config-with-wrong-custom-function.yaml'],
152
- };
153
- try {
154
- await resolveStyleguideConfig({
155
- styleguideConfig,
156
- configPath,
157
- });
158
- } catch (e) {
159
- expect(e.message.toString()).toContain(
160
- `Plugin ${colorize.red(
161
- 'test-plugin'
162
- )} doesn't export assertions function with name ${colorize.red('checkWordsCount2')}.`
163
- );
164
- }
165
-
166
- expect(asserts['test-plugin/checkWordsCount' as keyof Asserts]).toBeDefined();
167
- });
168
-
169
- it('should correctly merge assertions from nested config', async () => {
170
- const styleguideConfig = {
171
- extends: ['local-config-with-file.yaml'],
172
- };
173
-
174
- const styleguide = await resolveStyleguideConfig({
175
- styleguideConfig,
176
- configPath,
177
- });
178
-
179
- expect(Array.isArray(styleguide.rules?.assertions)).toEqual(true);
180
- expect(styleguide.rules?.assertions).toMatchObject([
181
- {
182
- subject: 'PathItem',
183
- property: 'get',
184
- message: 'Every path item must have a GET operation.',
185
- defined: true,
186
- assertionId: 'path-item-get-defined',
187
- },
188
- {
189
- subject: 'Tag',
190
- property: 'description',
191
- message: 'Tag description must be at least 13 characters and end with a full stop.',
192
- severity: 'error',
193
- minLength: 13,
194
- pattern: '/\\.$/',
195
- assertionId: 'tag-description',
196
- },
197
- ]);
198
- });
199
-
200
- it('should resolve extends with url file config which contains path to nested config', async () => {
201
- const styleguideConfig = {
202
- // This points to ./fixtures/resolve-remote-configs/remote-config.yaml
203
- extends: [
204
- 'https://raw.githubusercontent.com/Redocly/redocly-cli/main/packages/core/src/config/__tests__/fixtures/resolve-remote-configs/remote-config.yaml',
205
- ],
206
- };
207
-
208
- const { plugins, ...styleguide } = await resolveStyleguideConfig({
209
- styleguideConfig,
210
- configPath,
211
- });
212
-
213
- expect(styleguide?.rules?.['operation-4xx-response']).toEqual('error');
214
- expect(styleguide?.rules?.['operation-2xx-response']).toEqual('error');
215
- expect(Object.keys(styleguide.rules || {}).length).toBe(2);
216
-
217
- expect(styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
218
- 'resolve-config/.redocly.yaml',
219
- 'resolve-config/.redocly.yaml',
220
- ]);
221
- expect(styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual([]);
222
- });
223
- });
224
-
225
- describe('resolveApis', () => {
226
- it('should resolve apis styleguideConfig and merge minimal extends', async () => {
227
- const rawConfig: RawConfig = {
228
- apis: {
229
- petstore: {
230
- root: 'some/path',
231
- styleguide: {},
232
- },
233
- },
234
- styleguide: {
235
- extends: ['minimal'],
236
- },
237
- };
238
- const apisResult = await resolveApis({ rawConfig });
239
- expect(apisResult['petstore'].styleguide).toEqual(await minimalStyleguidePreset);
240
- });
241
-
242
- it('should not merge recommended extends by default by every level', async () => {
243
- const rawConfig: RawConfig = {
244
- apis: {
245
- petstore: {
246
- root: 'some/path',
247
- styleguide: {},
248
- },
249
- },
250
- styleguide: {},
251
- };
252
-
253
- const apisResult = await resolveApis({ rawConfig, configPath });
254
-
255
- expect(apisResult['petstore'].styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
256
- 'resolve-config/.redocly.yaml',
257
- ]);
258
- expect(apisResult['petstore'].styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual([]);
259
-
260
- expect(apisResult['petstore'].styleguide.rules).toEqual({});
261
- //@ts-ignore
262
- expect(apisResult['petstore'].styleguide.plugins.length).toEqual(1);
263
- //@ts-ignore
264
- expect(apisResult['petstore'].styleguide.plugins[0].id).toEqual('');
265
- });
266
-
267
- it('should resolve apis styleguideConfig when it contains file and not set recommended', async () => {
268
- const rawConfig: RawConfig = {
269
- apis: {
270
- petstore: {
271
- root: 'some/path',
272
- styleguide: {
273
- rules: {
274
- 'operation-4xx-response': 'error',
275
- },
276
- },
277
- },
278
- },
279
- styleguide: {
280
- rules: {
281
- 'operation-2xx-response': 'warn',
282
- },
283
- },
284
- };
285
-
286
- const apisResult = await resolveApis({ rawConfig, configPath });
287
- expect(apisResult['petstore'].styleguide.rules).toEqual({
288
- 'operation-2xx-response': 'warn',
289
- 'operation-4xx-response': 'error',
290
- });
291
- //@ts-ignore
292
- expect(apisResult['petstore'].styleguide.plugins.length).toEqual(1);
293
- //@ts-ignore
294
- expect(apisResult['petstore'].styleguide.plugins[0].id).toEqual('');
295
-
296
- expect(apisResult['petstore'].styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
297
- 'resolve-config/.redocly.yaml',
298
- ]);
299
- expect(apisResult['petstore'].styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual([]);
300
- });
301
-
302
- it('should resolve apis styleguideConfig when it contains file', async () => {
303
- const rawConfig: RawConfig = {
304
- apis: {
305
- petstore: {
306
- root: 'some/path',
307
- styleguide: {
308
- extends: ['local-config.yaml'],
309
- rules: {
310
- 'operation-4xx-response': 'error',
311
- },
312
- },
313
- },
314
- },
315
- styleguide: {
316
- extends: ['minimal'],
317
- rules: {
318
- 'operation-2xx-response': 'warn',
319
- },
320
- },
321
- };
322
-
323
- const apisResult = await resolveApis({ rawConfig, configPath });
324
- expect(apisResult['petstore'].styleguide.rules).toBeDefined();
325
- expect(apisResult['petstore'].styleguide.rules?.['operation-2xx-response']).toEqual('warn'); // think about prioritize in merge ???
326
- expect(apisResult['petstore'].styleguide.rules?.['operation-4xx-response']).toEqual('error');
327
- expect(apisResult['petstore'].styleguide.rules?.['local/operation-id-not-test']).toEqual(
328
- 'error'
329
- );
330
- //@ts-ignore
331
- expect(apisResult['petstore'].styleguide.plugins.length).toEqual(2);
332
-
333
- expect(apisResult['petstore'].styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
334
- 'resolve-config/.redocly.yaml',
335
- 'resolve-config/local-config.yaml',
336
- 'resolve-config/.redocly.yaml',
337
- ]);
338
- expect(apisResult['petstore'].styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual([
339
- 'resolve-config/plugin.js',
340
- ]);
341
- });
342
- });
343
-
344
- describe('resolveConfig', () => {
345
- it('should NOT add recommended to top level by default IF there is a config file', async () => {
346
- const rawConfig: RawConfig = {
347
- apis: {
348
- petstore: {
349
- root: 'some/path',
350
- styleguide: {
351
- rules: {
352
- 'operation-4xx-response': 'error',
353
- },
354
- },
355
- },
356
- },
357
- styleguide: {
358
- rules: {
359
- 'operation-2xx-response': 'warn',
360
- },
361
- },
362
- };
363
-
364
- const { apis } = await resolveConfig(rawConfig, configPath);
365
- //@ts-ignore
366
- expect(apis['petstore'].styleguide.plugins.length).toEqual(1);
367
- //@ts-ignore
368
- expect(apis['petstore'].styleguide.plugins[0].id).toEqual('');
369
-
370
- expect(apis['petstore'].styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
371
- 'resolve-config/.redocly.yaml',
372
- ]);
373
- expect(apis['petstore'].styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual([]);
374
-
375
- expect(apis['petstore'].styleguide.rules).toEqual({
376
- 'operation-2xx-response': 'warn',
377
- 'operation-4xx-response': 'error',
378
- });
379
- });
380
-
381
- it('should not add recommended to top level by default when apis have extends file', async () => {
382
- const rawConfig: RawConfig = {
383
- apis: {
384
- petstore: {
385
- root: 'some/path',
386
- styleguide: {
387
- extends: ['local-config.yaml'],
388
- rules: {
389
- 'operation-4xx-response': 'error',
390
- },
391
- },
392
- },
393
- },
394
- styleguide: {
395
- rules: {
396
- 'operation-2xx-response': 'warn',
397
- },
398
- },
399
- };
400
-
401
- const { apis } = await resolveConfig(rawConfig, configPath);
402
- expect(apis['petstore'].styleguide.rules).toBeDefined();
403
- expect(Object.keys(apis['petstore'].styleguide.rules || {}).length).toEqual(7);
404
- expect(apis['petstore'].styleguide.rules?.['operation-2xx-response']).toEqual('warn');
405
- expect(apis['petstore'].styleguide.rules?.['operation-4xx-response']).toEqual('error');
406
- expect(apis['petstore'].styleguide.rules?.['operation-description']).toEqual('error'); // from extends file config
407
- //@ts-ignore
408
- expect(apis['petstore'].styleguide.plugins.length).toEqual(2);
409
-
410
- expect(apis['petstore'].styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
411
- 'resolve-config/.redocly.yaml',
412
- 'resolve-config/local-config.yaml',
413
- 'resolve-config/.redocly.yaml',
414
- ]);
415
- expect(apis['petstore'].styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual([
416
- 'resolve-config/plugin.js',
417
- ]);
418
-
419
- expect(apis['petstore'].styleguide.recommendedFallback).toBe(false);
420
- });
421
-
422
- it('should ignore minimal from the root and read local file', async () => {
423
- const rawConfig: RawConfig = {
424
- apis: {
425
- petstore: {
426
- root: 'some/path',
427
- styleguide: {
428
- extends: ['recommended', 'local-config.yaml'],
429
- rules: {
430
- 'operation-4xx-response': 'error',
431
- },
432
- },
433
- },
434
- },
435
- styleguide: {
436
- extends: ['minimal'],
437
- rules: {
438
- 'operation-2xx-response': 'warn',
439
- },
440
- },
441
- };
442
-
443
- const { apis } = await resolveConfig(rawConfig, configPath);
444
- expect(apis['petstore'].styleguide.rules).toBeDefined();
445
- expect(apis['petstore'].styleguide.rules?.['operation-2xx-response']).toEqual('warn');
446
- expect(apis['petstore'].styleguide.rules?.['operation-4xx-response']).toEqual('error');
447
- expect(apis['petstore'].styleguide.rules?.['operation-description']).toEqual('error'); // from extends file config
448
- //@ts-ignore
449
- expect(apis['petstore'].styleguide.plugins.length).toEqual(2);
450
- //@ts-ignore
451
- delete apis['petstore'].styleguide.plugins;
452
-
453
- expect(apis['petstore'].styleguide.extendPaths!.map(removeAbsolutePath)).toEqual([
454
- 'resolve-config/.redocly.yaml',
455
- 'resolve-config/local-config.yaml',
456
- 'resolve-config/.redocly.yaml',
457
- ]);
458
- expect(apis['petstore'].styleguide.pluginPaths!.map(removeAbsolutePath)).toEqual([
459
- 'resolve-config/plugin.js',
460
- ]);
461
-
462
- delete apis['petstore'].styleguide.extendPaths;
463
- delete apis['petstore'].styleguide.pluginPaths;
464
- expect(apis['petstore'].styleguide).toMatchSnapshot();
465
- });
466
-
467
- it('should default to the extends from the main config if no extends defined', async () => {
468
- const rawConfig: RawConfig = {
469
- apis: {
470
- petstore: {
471
- root: 'some/path',
472
- styleguide: {
473
- rules: {
474
- 'operation-4xx-response': 'error',
475
- },
476
- },
477
- },
478
- },
479
- styleguide: {
480
- extends: ['minimal'],
481
- rules: {
482
- 'operation-2xx-response': 'warn',
483
- },
484
- },
485
- };
486
-
487
- const { apis } = await resolveConfig(rawConfig, configPath);
488
- expect(apis['petstore'].styleguide.rules).toBeDefined();
489
- expect(apis['petstore'].styleguide.rules?.['operation-2xx-response']).toEqual('warn'); // from minimal ruleset
490
- });
491
- });