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