@cparra/apexdocs 2.24.0 → 2.25.0-alpha.1

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 (375) hide show
  1. package/.github/workflows/ci.yaml +22 -0
  2. package/.github/workflows/close_stale.yml +22 -22
  3. package/.prettierrc.js +7 -7
  4. package/LICENSE +21 -21
  5. package/README.md +742 -718
  6. package/__mocks__/chalk.js +12 -0
  7. package/__mocks__/log-update.js +6 -0
  8. package/apexdocs.config.ts +13 -13
  9. package/docs/{README.md → __old/README.md} +1 -1
  10. package/docs/{restapi.json → __old/restapi.json} +589 -589
  11. package/docs/{types → __old/types}/Classes/nspc.ChildClass.md +97 -97
  12. package/docs/{types → __old/types}/Main/nspc.SampleClass.md +189 -189
  13. package/eslint.config.mjs +10 -0
  14. package/examples/force-app/main/default/classes/AnotherInterface.cls +16 -16
  15. package/examples/force-app/main/default/classes/ChildClass.cls +42 -42
  16. package/examples/force-app/main/default/classes/EscapedAnnotations.cls +5 -5
  17. package/examples/force-app/main/default/classes/GrandparentClass.cls +4 -4
  18. package/examples/force-app/main/default/classes/GroupedClass.cls +8 -8
  19. package/examples/force-app/main/default/classes/MemberGrouping.cls +17 -17
  20. package/examples/force-app/main/default/classes/ParentClass.cls +16 -16
  21. package/examples/force-app/main/default/classes/SampleClass.cls +166 -166
  22. package/examples/force-app/main/default/classes/SampleClass.cls-meta.xml +5 -5
  23. package/examples/force-app/main/default/classes/SampleClassWithoutModifier.cls +9 -9
  24. package/examples/force-app/main/default/classes/SampleInterface.cls +16 -16
  25. package/examples/force-app/main/default/restapi/SampleRestResource.cls +195 -195
  26. package/examples/force-app/main/default/restapi/SampleRestResourceToSkip.cls +35 -35
  27. package/examples/force-app/main/default/restapi/SampleRestResourceWithInnerClass.cls +24 -24
  28. package/examples/force-app/main/default/restapi/SampleRestResourceWithoutApexDocs.cls +15 -15
  29. package/examples/force-app/main/default/restapi/references/Reference1.cls +9 -9
  30. package/examples/force-app/main/default/restapi/references/Reference2.cls +9 -9
  31. package/examples/force-app/main/default/restapi/references/Reference3.cls +3 -3
  32. package/examples/force-app/main/default/restapi/references/Reference4.cls +3 -3
  33. package/examples/force-app/main/default/restapi/references/Reference5.cls +3 -3
  34. package/examples/force-app/main/default/restapi/references/Reference6.cls +6 -6
  35. package/examples/force-app/main/default/restapi/references/Reference7.cls +3 -3
  36. package/examples/includes/header.md +3 -3
  37. package/examples/plain-markdown/.forceignore +12 -0
  38. package/examples/plain-markdown/config/project-scratch-def.json +5 -0
  39. package/examples/plain-markdown/docs/Miscellaneous/ns.BaseClass.md +16 -0
  40. package/examples/plain-markdown/docs/Miscellaneous/ns.ParentInterface.md +15 -0
  41. package/examples/plain-markdown/docs/Miscellaneous/ns.ReferencedEnum.md +8 -0
  42. package/examples/plain-markdown/docs/Miscellaneous/ns.SampleException.md +7 -0
  43. package/examples/plain-markdown/docs/Miscellaneous/ns.SampleInterface.md +115 -0
  44. package/examples/plain-markdown/docs/Sample-Enums/ns.SampleEnum.md +36 -0
  45. package/examples/plain-markdown/docs/SampleGroup/ns.SampleClass.md +173 -0
  46. package/examples/plain-markdown/docs/index.md +36 -0
  47. package/examples/plain-markdown/force-app/classes/BaseClass.cls +3 -0
  48. package/examples/plain-markdown/force-app/classes/ParentInterface.cls +3 -0
  49. package/examples/plain-markdown/force-app/classes/ReferencedEnum.cls +3 -0
  50. package/examples/plain-markdown/force-app/classes/SampleClass.cls +72 -0
  51. package/examples/plain-markdown/force-app/classes/SampleEnum.cls +30 -0
  52. package/examples/plain-markdown/force-app/classes/SampleException.cls +1 -0
  53. package/examples/plain-markdown/force-app/classes/SampleInterface.cls +46 -0
  54. package/examples/plain-markdown/package-lock.json +665 -0
  55. package/examples/plain-markdown/package.json +20 -0
  56. package/examples/plain-markdown/sfdx-project.json +12 -0
  57. package/examples/plain-markdown/template.md +3 -0
  58. package/jest.config.js +9 -5
  59. package/jest.d.ts +7 -0
  60. package/lib/__spec__/core/expect-extensions.d.ts +3 -0
  61. package/lib/__spec__/core/expect-extensions.js +54 -0
  62. package/lib/__spec__/core/expect-extensions.js.map +1 -0
  63. package/lib/__spec__/core/generating-class-docs.spec.d.ts +1 -0
  64. package/lib/__spec__/core/generating-class-docs.spec.js +427 -0
  65. package/lib/__spec__/core/generating-class-docs.spec.js.map +1 -0
  66. package/lib/__spec__/core/generating-enum-docs.spec.d.ts +1 -0
  67. package/lib/__spec__/core/generating-enum-docs.spec.js +303 -0
  68. package/lib/__spec__/core/generating-enum-docs.spec.js.map +1 -0
  69. package/lib/__spec__/core/generating-interface-docs.spec.d.ts +1 -0
  70. package/lib/__spec__/core/generating-interface-docs.spec.js +361 -0
  71. package/lib/__spec__/core/generating-interface-docs.spec.js.map +1 -0
  72. package/lib/__spec__/core/generating-reference-guide.spec.d.ts +1 -0
  73. package/lib/__spec__/core/generating-reference-guide.spec.js +161 -0
  74. package/lib/__spec__/core/generating-reference-guide.spec.js.map +1 -0
  75. package/lib/adapters/apex-types.d.ts +7 -0
  76. package/lib/adapters/apex-types.js +112 -0
  77. package/lib/adapters/apex-types.js.map +1 -0
  78. package/lib/adapters/documentables.d.ts +7 -0
  79. package/lib/adapters/documentables.js +56 -0
  80. package/lib/adapters/documentables.js.map +1 -0
  81. package/lib/adapters/fields-and-properties.d.ts +4 -0
  82. package/lib/adapters/fields-and-properties.js +32 -0
  83. package/lib/adapters/fields-and-properties.js.map +1 -0
  84. package/lib/adapters/methods-and-constructors.d.ts +5 -0
  85. package/lib/adapters/methods-and-constructors.js +92 -0
  86. package/lib/adapters/methods-and-constructors.js.map +1 -0
  87. package/lib/adapters/references.d.ts +5 -0
  88. package/lib/adapters/references.js +82 -0
  89. package/lib/adapters/references.js.map +1 -0
  90. package/lib/adapters/type-utils.d.ts +2 -0
  91. package/lib/adapters/type-utils.js +7 -0
  92. package/lib/adapters/type-utils.js.map +1 -0
  93. package/lib/application/Apexdocs.d.ts +13 -13
  94. package/lib/application/Apexdocs.js +79 -76
  95. package/lib/application/Apexdocs.js.map +1 -1
  96. package/lib/cli/generate.d.ts +2 -2
  97. package/lib/cli/generate.js +156 -130
  98. package/lib/cli/generate.js.map +1 -1
  99. package/lib/core/generate-docs.d.ts +23 -0
  100. package/lib/core/generate-docs.js +241 -0
  101. package/lib/core/generate-docs.js.map +1 -0
  102. package/lib/core/template.d.ts +10 -0
  103. package/lib/core/template.js +92 -0
  104. package/lib/core/template.js.map +1 -0
  105. package/lib/core/templates/reference-guide.d.ts +1 -0
  106. package/lib/core/templates/reference-guide.js +18 -0
  107. package/lib/core/templates/reference-guide.js.map +1 -0
  108. package/lib/index.d.ts +2 -1
  109. package/lib/index.js +28 -17
  110. package/lib/index.js.map +1 -1
  111. package/lib/model/apex-bundle.d.ts +6 -6
  112. package/lib/model/apex-bundle.js +10 -10
  113. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.d.ts +7 -7
  114. package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js +13 -13
  115. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.d.ts +7 -7
  116. package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js +11 -11
  117. package/lib/model/inheritance.d.ts +8 -8
  118. package/lib/model/inheritance.js +2 -2
  119. package/lib/model/manifest.d.ts +22 -22
  120. package/lib/model/manifest.js +52 -46
  121. package/lib/model/manifest.js.map +1 -1
  122. package/lib/model/markdown-file.d.ts +16 -16
  123. package/lib/model/markdown-file.js +110 -106
  124. package/lib/model/markdown-file.js.map +1 -1
  125. package/lib/model/markdown-generation-util/doc-comment-annotation-util.d.ts +8 -8
  126. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js +45 -43
  127. package/lib/model/markdown-generation-util/doc-comment-annotation-util.js.map +1 -1
  128. package/lib/model/markdown-generation-util/field-declaration-util.d.ts +3 -3
  129. package/lib/model/markdown-generation-util/field-declaration-util.js +53 -54
  130. package/lib/model/markdown-generation-util/field-declaration-util.js.map +1 -1
  131. package/lib/model/markdown-generation-util/index.d.ts +3 -3
  132. package/lib/model/markdown-generation-util/index.js +19 -19
  133. package/lib/model/markdown-generation-util/method-declaration-util.d.ts +4 -4
  134. package/lib/model/markdown-generation-util/method-declaration-util.js +113 -114
  135. package/lib/model/markdown-generation-util/method-declaration-util.js.map +1 -1
  136. package/lib/model/markdown-generation-util/type-declaration-util.d.ts +3 -3
  137. package/lib/model/markdown-generation-util/type-declaration-util.js +80 -81
  138. package/lib/model/markdown-generation-util/type-declaration-util.js.map +1 -1
  139. package/lib/model/markdown-home-file.d.ts +11 -11
  140. package/lib/model/markdown-home-file.js +56 -53
  141. package/lib/model/markdown-home-file.js.map +1 -1
  142. package/lib/model/markdown-type-file.d.ts +26 -26
  143. package/lib/model/markdown-type-file.js +136 -133
  144. package/lib/model/markdown-type-file.js.map +1 -1
  145. package/lib/model/openapi/apex-doc-types.d.ts +19 -19
  146. package/lib/model/openapi/apex-doc-types.js +4 -4
  147. package/lib/model/openapi/open-api-types.d.ts +93 -93
  148. package/lib/model/openapi/open-api-types.js +2 -2
  149. package/lib/model/openapi/open-api.d.ts +16 -16
  150. package/lib/model/openapi/open-api.js +33 -33
  151. package/lib/model/openapi/open-api.js.map +1 -1
  152. package/lib/model/openapi/openapi-type-file.d.ts +7 -7
  153. package/lib/model/openapi/openapi-type-file.js +16 -16
  154. package/lib/model/outputFile.d.ts +10 -10
  155. package/lib/model/outputFile.js +21 -28
  156. package/lib/model/outputFile.js.map +1 -1
  157. package/lib/model/types-repository.d.ts +16 -16
  158. package/lib/model/types-repository.js +53 -53
  159. package/lib/model/types-repository.js.map +1 -1
  160. package/lib/service/apex-file-reader.d.ts +14 -14
  161. package/lib/service/apex-file-reader.js +48 -45
  162. package/lib/service/apex-file-reader.js.map +1 -1
  163. package/lib/service/file-system.d.ts +14 -14
  164. package/lib/service/file-system.js +47 -24
  165. package/lib/service/file-system.js.map +1 -1
  166. package/lib/service/file-writer.d.ts +6 -6
  167. package/lib/service/file-writer.js +56 -33
  168. package/lib/service/file-writer.js.map +1 -1
  169. package/lib/service/manifest-factory.d.ts +10 -10
  170. package/lib/service/manifest-factory.js +15 -13
  171. package/lib/service/manifest-factory.js.map +1 -1
  172. package/lib/service/metadata-processor.d.ts +3 -3
  173. package/lib/service/metadata-processor.js +16 -16
  174. package/lib/service/metadata-processor.js.map +1 -1
  175. package/lib/service/parser.d.ts +21 -21
  176. package/lib/service/parser.js +137 -134
  177. package/lib/service/parser.js.map +1 -1
  178. package/lib/service/state.d.ts +9 -9
  179. package/lib/service/state.js +19 -19
  180. package/lib/service/state.js.map +1 -1
  181. package/lib/service/walkers/class-walker.d.ts +4 -4
  182. package/lib/service/walkers/class-walker.js +32 -32
  183. package/lib/service/walkers/class-walker.js.map +1 -1
  184. package/lib/service/walkers/enum-walker.d.ts +4 -4
  185. package/lib/service/walkers/enum-walker.js +10 -10
  186. package/lib/service/walkers/interface-walker.d.ts +4 -4
  187. package/lib/service/walkers/interface-walker.js +14 -14
  188. package/lib/service/walkers/interface-walker.js.map +1 -1
  189. package/lib/service/walkers/walker-factory.d.ts +5 -5
  190. package/lib/service/walkers/walker-factory.js +20 -20
  191. package/lib/service/walkers/walker-factory.js.map +1 -1
  192. package/lib/service/walkers/walker.d.ts +19 -19
  193. package/lib/service/walkers/walker.js +16 -16
  194. package/lib/service/walkers/walker.js.map +1 -1
  195. package/lib/settings.d.ts +64 -64
  196. package/lib/settings.js +88 -88
  197. package/lib/settings.js.map +1 -1
  198. package/lib/test-helpers/AnnotationBuilder.d.ts +12 -12
  199. package/lib/test-helpers/AnnotationBuilder.js +30 -30
  200. package/lib/test-helpers/ClassMirrorBuilder.d.ts +18 -18
  201. package/lib/test-helpers/ClassMirrorBuilder.js +53 -53
  202. package/lib/test-helpers/DocCommentAnnotationBuilder.d.ts +8 -8
  203. package/lib/test-helpers/DocCommentAnnotationBuilder.js +25 -25
  204. package/lib/test-helpers/DocCommentBuilder.d.ts +12 -12
  205. package/lib/test-helpers/DocCommentBuilder.js +37 -37
  206. package/lib/test-helpers/FieldMirrorBuilder.d.ts +18 -18
  207. package/lib/test-helpers/FieldMirrorBuilder.js +53 -53
  208. package/lib/test-helpers/InterfaceMirrorBuilder.d.ts +16 -0
  209. package/lib/test-helpers/InterfaceMirrorBuilder.js +43 -0
  210. package/lib/test-helpers/InterfaceMirrorBuilder.js.map +1 -0
  211. package/lib/test-helpers/MethodMirrorBuilder.d.ts +29 -10
  212. package/lib/test-helpers/MethodMirrorBuilder.js +71 -36
  213. package/lib/test-helpers/MethodMirrorBuilder.js.map +1 -1
  214. package/lib/test-helpers/SettingsBuilder.d.ts +8 -8
  215. package/lib/test-helpers/SettingsBuilder.js +26 -26
  216. package/lib/transpiler/factory.d.ts +6 -6
  217. package/lib/transpiler/factory.js +34 -31
  218. package/lib/transpiler/factory.js.map +1 -1
  219. package/lib/transpiler/file-container.d.ts +6 -6
  220. package/lib/transpiler/file-container.js +15 -15
  221. package/lib/transpiler/generator-choices.d.ts +1 -1
  222. package/lib/transpiler/generator-choices.js +2 -2
  223. package/lib/transpiler/markdown/class-file-generatorHelper.d.ts +11 -8
  224. package/lib/transpiler/markdown/class-file-generatorHelper.js +74 -55
  225. package/lib/transpiler/markdown/class-file-generatorHelper.js.map +1 -1
  226. package/lib/transpiler/markdown/docsify/docsify-docs-processor.d.ts +6 -6
  227. package/lib/transpiler/markdown/docsify/docsify-docs-processor.js +12 -12
  228. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.d.ts +11 -11
  229. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js +50 -50
  230. package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js.map +1 -1
  231. package/lib/transpiler/markdown/markdown-transpiler-base.d.ts +11 -11
  232. package/lib/transpiler/markdown/markdown-transpiler-base.js +26 -23
  233. package/lib/transpiler/markdown/markdown-transpiler-base.js.map +1 -1
  234. package/lib/transpiler/markdown/plain-markdown/class-template.d.ts +1 -0
  235. package/lib/transpiler/markdown/plain-markdown/class-template.js +77 -0
  236. package/lib/transpiler/markdown/plain-markdown/class-template.js.map +1 -0
  237. package/lib/transpiler/markdown/plain-markdown/constructors-partial-template.d.ts +1 -0
  238. package/lib/transpiler/markdown/plain-markdown/constructors-partial-template.js +36 -0
  239. package/lib/transpiler/markdown/plain-markdown/constructors-partial-template.js.map +1 -0
  240. package/lib/transpiler/markdown/plain-markdown/documentable-partial-template.d.ts +1 -0
  241. package/lib/transpiler/markdown/plain-markdown/documentable-partial-template.js +28 -0
  242. package/lib/transpiler/markdown/plain-markdown/documentable-partial-template.js.map +1 -0
  243. package/lib/transpiler/markdown/plain-markdown/enum-template.d.ts +1 -0
  244. package/lib/transpiler/markdown/plain-markdown/enum-template.js +16 -0
  245. package/lib/transpiler/markdown/plain-markdown/enum-template.js.map +1 -0
  246. package/lib/transpiler/markdown/plain-markdown/fieldsPartialTemplate.d.ts +1 -0
  247. package/lib/transpiler/markdown/plain-markdown/fieldsPartialTemplate.js +27 -0
  248. package/lib/transpiler/markdown/plain-markdown/fieldsPartialTemplate.js.map +1 -0
  249. package/lib/transpiler/markdown/plain-markdown/grouped-members-partial-template.d.ts +1 -0
  250. package/lib/transpiler/markdown/plain-markdown/grouped-members-partial-template.js +10 -0
  251. package/lib/transpiler/markdown/plain-markdown/grouped-members-partial-template.js.map +1 -0
  252. package/lib/transpiler/markdown/plain-markdown/interface-template.d.ts +1 -0
  253. package/lib/transpiler/markdown/plain-markdown/interface-template.js +20 -0
  254. package/lib/transpiler/markdown/plain-markdown/interface-template.js.map +1 -0
  255. package/lib/transpiler/markdown/plain-markdown/methods-partial-template.d.ts +1 -0
  256. package/lib/transpiler/markdown/plain-markdown/methods-partial-template.js +47 -0
  257. package/lib/transpiler/markdown/plain-markdown/methods-partial-template.js.map +1 -0
  258. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.d.ts +9 -6
  259. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js +41 -13
  260. package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js.map +1 -1
  261. package/lib/transpiler/markdown/plain-markdown/type-doc-partial.d.ts +1 -0
  262. package/lib/transpiler/markdown/plain-markdown/type-doc-partial.js +31 -0
  263. package/lib/transpiler/markdown/plain-markdown/type-doc-partial.js.map +1 -0
  264. package/lib/transpiler/openapi/open-api-docs-processor.d.ts +13 -13
  265. package/lib/transpiler/openapi/open-api-docs-processor.js +77 -74
  266. package/lib/transpiler/openapi/open-api-docs-processor.js.map +1 -1
  267. package/lib/transpiler/openapi/parsers/Builder.d.ts +16 -16
  268. package/lib/transpiler/openapi/parsers/Builder.js +29 -29
  269. package/lib/transpiler/openapi/parsers/Builder.js.map +1 -1
  270. package/lib/transpiler/openapi/parsers/MethodParser.d.ts +20 -20
  271. package/lib/transpiler/openapi/parsers/MethodParser.js +189 -166
  272. package/lib/transpiler/openapi/parsers/MethodParser.js.map +1 -1
  273. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.d.ts +7 -7
  274. package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js +10 -10
  275. package/lib/transpiler/openapi/parsers/ReferenceBuilder.d.ts +39 -39
  276. package/lib/transpiler/openapi/parsers/ReferenceBuilder.js +249 -225
  277. package/lib/transpiler/openapi/parsers/ReferenceBuilder.js.map +1 -1
  278. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.d.ts +10 -10
  279. package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js +19 -19
  280. package/lib/transpiler/openapi/parsers/ResponsesBuilder.d.ts +7 -7
  281. package/lib/transpiler/openapi/parsers/ResponsesBuilder.js +21 -21
  282. package/lib/transpiler/openapi/parsers/ResponsesBuilder.js.map +1 -1
  283. package/lib/transpiler/processor-type-transpiler.d.ts +10 -10
  284. package/lib/transpiler/processor-type-transpiler.js +8 -8
  285. package/lib/transpiler/transpiler.d.ts +5 -5
  286. package/lib/transpiler/transpiler.js +29 -26
  287. package/lib/transpiler/transpiler.js.map +1 -1
  288. package/lib/util/error-logger.d.ts +8 -8
  289. package/lib/util/error-logger.js +89 -89
  290. package/lib/util/error-logger.js.map +1 -1
  291. package/lib/util/logger.d.ts +21 -21
  292. package/lib/util/logger.js +60 -57
  293. package/lib/util/logger.js.map +1 -1
  294. package/lib/util/string-utils.d.ts +2 -2
  295. package/lib/util/string-utils.js +14 -14
  296. package/lib/util/string-utils.js.map +1 -1
  297. package/package.json +79 -78
  298. package/src/__spec__/core/expect-extensions.ts +32 -0
  299. package/src/__spec__/core/generating-class-docs.spec.ts +511 -0
  300. package/src/__spec__/core/generating-enum-docs.spec.ts +355 -0
  301. package/src/__spec__/core/generating-interface-docs.spec.ts +431 -0
  302. package/src/__spec__/core/generating-reference-guide.spec.ts +163 -0
  303. package/src/adapters/__tests__/interface-adapter.spec.ts +80 -0
  304. package/src/adapters/__tests__/references.spec.ts +115 -0
  305. package/src/adapters/apex-types.ts +224 -0
  306. package/src/adapters/documentables.ts +93 -0
  307. package/src/adapters/fields-and-properties.ts +38 -0
  308. package/src/adapters/methods-and-constructors.ts +117 -0
  309. package/src/adapters/references.ts +113 -0
  310. package/src/adapters/type-utils.ts +5 -0
  311. package/src/adapters/types.d.ts +8 -0
  312. package/src/cli/generate.ts +96 -93
  313. package/src/core/generate-docs.ts +357 -0
  314. package/src/core/renderable/types.d.ts +131 -0
  315. package/src/core/template.ts +108 -0
  316. package/src/core/templates/reference-guide.ts +14 -0
  317. package/src/index.ts +3 -1
  318. package/src/model/__tests__/manifest.spec.ts +1 -0
  319. package/src/model/manifest.ts +15 -5
  320. package/src/model/markdown-file.ts +6 -5
  321. package/src/model/markdown-generation-util/doc-comment-annotation-util.ts +1 -1
  322. package/src/model/markdown-generation-util/method-declaration-util.ts +1 -1
  323. package/src/model/openapi/open-api-types.ts +2 -2
  324. package/src/model/outputFile.ts +2 -11
  325. package/src/service/__tests__/apex-file-reader.spec.ts +4 -4
  326. package/src/service/__tests__/manifest-factory.spec.ts +1 -2
  327. package/src/service/parser.ts +1 -1
  328. package/src/test-helpers/FieldMirrorBuilder.ts +1 -1
  329. package/src/test-helpers/InterfaceMirrorBuilder.ts +44 -0
  330. package/src/test-helpers/MethodMirrorBuilder.ts +46 -6
  331. package/src/transpiler/markdown/class-file-generatorHelper.ts +22 -2
  332. package/src/transpiler/markdown/plain-markdown/class-template.ts +73 -0
  333. package/src/transpiler/markdown/plain-markdown/constructors-partial-template.ts +32 -0
  334. package/src/transpiler/markdown/plain-markdown/documentable-partial-template.ts +24 -0
  335. package/src/transpiler/markdown/plain-markdown/enum-template.ts +12 -0
  336. package/src/transpiler/markdown/plain-markdown/fieldsPartialTemplate.ts +23 -0
  337. package/src/transpiler/markdown/plain-markdown/grouped-members-partial-template.ts +6 -0
  338. package/src/transpiler/markdown/plain-markdown/interface-template.ts +16 -0
  339. package/src/transpiler/markdown/plain-markdown/methods-partial-template.ts +43 -0
  340. package/src/transpiler/markdown/plain-markdown/plain-docsProcessor.ts +30 -0
  341. package/src/transpiler/markdown/plain-markdown/type-doc-partial.ts +27 -0
  342. package/src/transpiler/openapi/parsers/Builder.ts +1 -1
  343. package/src/transpiler/openapi/parsers/MethodParser.ts +1 -1
  344. package/src/transpiler/openapi/parsers/ReferenceBuilder.ts +4 -3
  345. package/src/util/error-logger.ts +4 -4
  346. package/src/util/logger.ts +3 -3
  347. package/tsconfig.json +21 -20
  348. package/tslint.json +5 -5
  349. package/.eslintrc.js +0 -12
  350. package/lib/model/manifest-diff.d.ts +0 -27
  351. package/lib/model/manifest-diff.js +0 -69
  352. package/lib/model/manifest-diff.js.map +0 -1
  353. package/src/model/__tests__/manifest-diff.spec.ts +0 -139
  354. package/src/model/manifest-diff.ts +0 -94
  355. /package/docs/{index.html → __old/index.html} +0 -0
  356. /package/docs/{types → __old/types}/Classes/nspc.AnotherInterface.md +0 -0
  357. /package/docs/{types → __old/types}/Main/nspc.GroupedClass.md +0 -0
  358. /package/docs/{types → __old/types}/Misc-Group/nspc.EscapedAnnotations.md +0 -0
  359. /package/docs/{types → __old/types}/Misc-Group/nspc.GrandparentClass.md +0 -0
  360. /package/docs/{types → __old/types}/Misc-Group/nspc.InterfaceWithInheritance.md +0 -0
  361. /package/docs/{types → __old/types}/Misc-Group/nspc.MemberGrouping.md +0 -0
  362. /package/docs/{types → __old/types}/Misc-Group/nspc.ParentClass.md +0 -0
  363. /package/docs/{types → __old/types}/Misc-Group/nspc.Reference1.md +0 -0
  364. /package/docs/{types → __old/types}/Misc-Group/nspc.Reference2.md +0 -0
  365. /package/docs/{types → __old/types}/Misc-Group/nspc.Reference3.md +0 -0
  366. /package/docs/{types → __old/types}/Misc-Group/nspc.Reference4.md +0 -0
  367. /package/docs/{types → __old/types}/Misc-Group/nspc.Reference5.md +0 -0
  368. /package/docs/{types → __old/types}/Misc-Group/nspc.Reference6.md +0 -0
  369. /package/docs/{types → __old/types}/Misc-Group/nspc.Reference7.md +0 -0
  370. /package/docs/{types → __old/types}/Misc-Group/nspc.SampleClassWithoutModifier.md +0 -0
  371. /package/docs/{types → __old/types}/Misc-Group/nspc.SampleRestResource.md +0 -0
  372. /package/docs/{types → __old/types}/Misc-Group/nspc.SampleRestResourceWithInnerClass.md +0 -0
  373. /package/docs/{types → __old/types}/Misc-Group/nspc.SampleRestResourceWithoutApexDocs.md +0 -0
  374. /package/docs/{types → __old/types}/README.md +0 -0
  375. /package/docs/{types → __old/types}/Sample-Interfaces/nspc.SampleInterface.md +0 -0
@@ -1,589 +1,589 @@
1
- {
2
- "openapi": "3.1.0",
3
- "info": {
4
- "title": "Sample REST Api",
5
- "version": "1.0.0"
6
- },
7
- "servers": [
8
- {
9
- "url": "/services/apexrest/nspc/"
10
- }
11
- ],
12
- "paths": {
13
- "AccountService/": {
14
- "description": "Account related operations",
15
- "get": {
16
- "tags": [
17
- "Account Service"
18
- ],
19
- "description": "This is a sample HTTP Get method",
20
- "parameters": [
21
- {
22
- "name": "limit",
23
- "in": "query",
24
- "required": true,
25
- "description": "Limits the number of items on a page",
26
- "schema": {
27
- "type": "integer"
28
- }
29
- },
30
- {
31
- "name": "complex",
32
- "in": "cookie",
33
- "description": "A more complex schema",
34
- "schema": {
35
- "type": "array",
36
- "items": {
37
- "type": "object",
38
- "properties": {
39
- "name": {
40
- "type": "string"
41
- }
42
- }
43
- }
44
- }
45
- }
46
- ],
47
- "responses": {
48
- "100": {
49
- "description": "Status code 100",
50
- "content": {
51
- "application/json": {
52
- "schema": {
53
- "type": "object",
54
- "properties": {
55
- "anotherObject": {
56
- "description": "An object inside of an object",
57
- "type": "object",
58
- "properties": {
59
- "message": {
60
- "type": "string"
61
- },
62
- "somethingElse": {
63
- "type": "number"
64
- }
65
- }
66
- }
67
- }
68
- }
69
- }
70
- }
71
- },
72
- "200": {
73
- "description": "Status code 200",
74
- "content": {
75
- "application/json": {
76
- "schema": {
77
- "type": "object",
78
- "properties": {
79
- "id": {
80
- "type": "string",
81
- "description": "The super Id."
82
- },
83
- "name": {
84
- "type": "string"
85
- },
86
- "phone": {
87
- "type": "string",
88
- "format": "byte"
89
- }
90
- }
91
- }
92
- }
93
- }
94
- },
95
- "304": {
96
- "description": "Status code 304",
97
- "content": {
98
- "application/json": {
99
- "schema": {
100
- "type": "object",
101
- "properties": {
102
- "error": {
103
- "type": "string"
104
- }
105
- }
106
- }
107
- }
108
- }
109
- },
110
- "400": {
111
- "description": "Status code 400",
112
- "content": {
113
- "application/json": {
114
- "schema": {
115
- "type": "array",
116
- "items": {
117
- "type": "object",
118
- "properties": {
119
- "name": {
120
- "type": "string"
121
- }
122
- }
123
- }
124
- }
125
- }
126
- }
127
- },
128
- "500": {
129
- "description": "Status code 500",
130
- "content": {
131
- "application/json": {
132
- "schema": {
133
- "type": "string"
134
- }
135
- }
136
- }
137
- }
138
- }
139
- },
140
- "post": {
141
- "tags": [
142
- "Account Service"
143
- ],
144
- "description": "This is a sample HTTP Post method",
145
- "summary": "Posts an Account 2",
146
- "requestBody": {
147
- "description": "This is an example of a request body",
148
- "content": {
149
- "application/json": {
150
- "schema": {
151
- "type": "array",
152
- "items": {
153
- "type": "object",
154
- "properties": {
155
- "name": {
156
- "type": "string"
157
- }
158
- }
159
- }
160
- }
161
- }
162
- },
163
- "required": true
164
- },
165
- "parameters": [
166
- {
167
- "name": "limit",
168
- "in": "query",
169
- "required": true,
170
- "description": "Limits the number of items on a page",
171
- "schema": {
172
- "type": "integer"
173
- }
174
- },
175
- {
176
- "name": "complex",
177
- "in": "cookie",
178
- "description": "A more complex schema",
179
- "schema": {
180
- "type": "array",
181
- "items": {
182
- "type": "object",
183
- "properties": {
184
- "name": {
185
- "type": "string"
186
- }
187
- }
188
- }
189
- }
190
- }
191
- ],
192
- "responses": {
193
- "200": {
194
- "description": "Status code 200",
195
- "content": {
196
- "application/json": {
197
- "schema": {
198
- "type": "object",
199
- "properties": {
200
- "id": {
201
- "type": "string",
202
- "description": "The super Id."
203
- },
204
- "name": {
205
- "type": "string"
206
- },
207
- "phone": {
208
- "type": "string",
209
- "format": "byte"
210
- }
211
- }
212
- }
213
- }
214
- }
215
- },
216
- "304": {
217
- "description": "Status code 304",
218
- "content": {
219
- "application/json": {
220
- "schema": {
221
- "type": "object",
222
- "properties": {
223
- "error": {
224
- "type": "string"
225
- }
226
- }
227
- }
228
- }
229
- }
230
- },
231
- "400": {
232
- "description": "Status code 400",
233
- "content": {
234
- "application/json": {
235
- "schema": {
236
- "type": "array",
237
- "items": {
238
- "type": "object",
239
- "properties": {
240
- "name": {
241
- "type": "string"
242
- }
243
- }
244
- }
245
- }
246
- }
247
- }
248
- },
249
- "500": {
250
- "description": "Status code 500",
251
- "content": {
252
- "application/json": {
253
- "schema": {
254
- "type": "string"
255
- }
256
- }
257
- }
258
- }
259
- }
260
- },
261
- "delete": {
262
- "tags": [
263
- "Account Service"
264
- ],
265
- "description": "Sample HTTP Delete method with references to other types.",
266
- "parameters": [
267
- {
268
- "name": "limit",
269
- "in": "header",
270
- "required": true,
271
- "description": "My sample description.",
272
- "schema": {
273
- "$ref": "#/components/schemas/SampleClass"
274
- }
275
- }
276
- ],
277
- "responses": {
278
- "200": {
279
- "description": "Status code 200",
280
- "content": {
281
- "application/json": {
282
- "schema": {
283
- "$ref": "#/components/schemas/SampleClass"
284
- }
285
- }
286
- }
287
- },
288
- "304": {
289
- "description": "Status code 304",
290
- "content": {
291
- "application/json": {
292
- "schema": {
293
- "$ref": "#/components/schemas/ChildClass"
294
- }
295
- }
296
- }
297
- },
298
- "305": {
299
- "description": "Status code 305",
300
- "content": {
301
- "application/json": {
302
- "schema": {
303
- "$ref": "#/components/schemas/Reference1"
304
- }
305
- }
306
- }
307
- },
308
- "306": {
309
- "description": "Status code 306",
310
- "content": {
311
- "application/json": {
312
- "schema": {
313
- "$ref": "#/components/schemas/Reference1_array"
314
- }
315
- }
316
- }
317
- },
318
- "307": {
319
- "description": "Status code 307",
320
- "content": {
321
- "application/json": {
322
- "schema": {
323
- "$ref": "#/components/schemas/Reference7_Reference7[untypedObject:Reference2]"
324
- }
325
- }
326
- }
327
- },
328
- "500": {
329
- "description": "Status code 500",
330
- "content": {
331
- "application/json": {
332
- "schema": {
333
- "$ref": "#/components/schemas/SampleClass"
334
- }
335
- }
336
- }
337
- }
338
- }
339
- }
340
- },
341
- "Contact/": {
342
- "description": "Contact related operations",
343
- "get": {
344
- "tags": [
345
- "Contact"
346
- ],
347
- "description": "This is a sample HTTP Get method",
348
- "responses": {
349
- "200": {
350
- "description": "Status code 200",
351
- "content": {
352
- "application/json": {
353
- "schema": {
354
- "$ref": "#/components/schemas/SampleRestResourceWithInnerClass.InnerClass"
355
- }
356
- }
357
- }
358
- }
359
- }
360
- }
361
- },
362
- "Order/": {
363
- "description": "Order related operations",
364
- "get": {
365
- "tags": [
366
- "Order"
367
- ],
368
- "requestBody": {
369
- "content": {
370
- "application/json": {
371
- "schema": {
372
- "type": "object",
373
- "properties": {
374
- "param1": {
375
- "type": "string"
376
- },
377
- "param2": {
378
- "$ref": "#/components/schemas/Reference1"
379
- }
380
- }
381
- }
382
- }
383
- }
384
- },
385
- "responses": {
386
- "200": {
387
- "description": "Status code 200",
388
- "content": {
389
- "application/json": {
390
- "schema": {
391
- "type": "string"
392
- }
393
- }
394
- }
395
- }
396
- }
397
- },
398
- "patch": {
399
- "tags": [
400
- "Order"
401
- ],
402
- "requestBody": {
403
- "content": {
404
- "application/json": {
405
- "schema": {
406
- "type": "object",
407
- "properties": {
408
- "param1": {
409
- "type": "string"
410
- },
411
- "param2": {
412
- "$ref": "#/components/schemas/Reference1"
413
- }
414
- }
415
- }
416
- }
417
- }
418
- },
419
- "responses": {
420
- "200": {
421
- "description": "Status code 200",
422
- "content": {
423
- "application/json": {
424
- "schema": {
425
- "type": "string"
426
- }
427
- }
428
- }
429
- }
430
- }
431
- }
432
- }
433
- },
434
- "tags": [
435
- {
436
- "name": "Account Service",
437
- "description": "Account related operations"
438
- },
439
- {
440
- "name": "Contact",
441
- "description": "Contact related operations"
442
- },
443
- {
444
- "name": "Order",
445
- "description": "Order related operations"
446
- }
447
- ],
448
- "components": {
449
- "schemas": {
450
- "SampleClass": {
451
- "type": "object",
452
- "properties": {
453
- "MyProp": {
454
- "type": "string",
455
- "description": "This is a String property."
456
- },
457
- "AnotherProp": {
458
- "type": "number",
459
- "description": "This is a Decimal property."
460
- },
461
- "listOfStrings": {
462
- "type": "array",
463
- "items": {
464
- "type": "string"
465
- }
466
- },
467
- "someVariable": {
468
- "type": "string"
469
- }
470
- }
471
- },
472
- "ChildClass": {
473
- "type": "object",
474
- "properties": {
475
- "AProp": {
476
- "type": "string"
477
- },
478
- "privateStringFromChild": {
479
- "type": "string"
480
- },
481
- "protectedStringFromParent": {
482
- "type": "string",
483
- "description": "This is a protected string, use carefully."
484
- },
485
- "publicStringFromParent": {
486
- "type": "string"
487
- },
488
- "protectedGrandParentField": {
489
- "type": "string"
490
- }
491
- }
492
- },
493
- "Reference1": {
494
- "type": "object",
495
- "properties": {
496
- "reference2Member": {
497
- "$ref": "#/components/schemas/Reference2",
498
- "description": "This is a reference 2 member. Lorem."
499
- },
500
- "reference3Member": {
501
- "$ref": "#/components/schemas/Reference3"
502
- },
503
- "reference4Collection": {
504
- "type": "array",
505
- "items": {
506
- "$ref": "#/components/schemas/Reference4"
507
- }
508
- },
509
- "reference5Member": {
510
- "$ref": "#/components/schemas/Reference5"
511
- }
512
- }
513
- },
514
- "Reference2": {
515
- "type": "object",
516
- "properties": {
517
- "stringMember": {
518
- "type": "string"
519
- },
520
- "objectReference": {
521
- "$ref": "#/components/schemas/Reference3_array",
522
- "description": "This is an object reference."
523
- }
524
- }
525
- },
526
- "Reference3_array": {
527
- "type": "array",
528
- "items": {
529
- "$ref": "#/components/schemas/Reference3"
530
- }
531
- },
532
- "Reference3": {
533
- "type": "object",
534
- "properties": {
535
- "someBoolean": {
536
- "type": "boolean"
537
- }
538
- }
539
- },
540
- "Reference4": {
541
- "type": "object",
542
- "properties": {
543
- "someString": {
544
- "type": "string"
545
- }
546
- }
547
- },
548
- "Reference5": {
549
- "type": "object",
550
- "properties": {
551
- "reference6Member": {
552
- "$ref": "#/components/schemas/Reference6"
553
- }
554
- }
555
- },
556
- "Reference6": {
557
- "type": "object",
558
- "properties": {
559
- "grandChildString": {
560
- "type": "string",
561
- "description": "This is the grandchild description."
562
- }
563
- }
564
- },
565
- "Reference1_array": {
566
- "type": "array",
567
- "items": {
568
- "$ref": "#/components/schemas/Reference1"
569
- }
570
- },
571
- "Reference7_Reference7[untypedObject:Reference2]": {
572
- "type": "object",
573
- "properties": {
574
- "untypedObject": {
575
- "$ref": "#/components/schemas/Reference2"
576
- }
577
- }
578
- },
579
- "SampleRestResourceWithInnerClass.InnerClass": {
580
- "type": "object",
581
- "properties": {
582
- "stringMember": {
583
- "type": "string"
584
- }
585
- }
586
- }
587
- }
588
- }
589
- }
1
+ {
2
+ "openapi": "3.1.0",
3
+ "info": {
4
+ "title": "Sample REST Api",
5
+ "version": "1.0.0"
6
+ },
7
+ "servers": [
8
+ {
9
+ "url": "/services/apexrest/nspc/"
10
+ }
11
+ ],
12
+ "paths": {
13
+ "AccountService/": {
14
+ "description": "Account related operations",
15
+ "get": {
16
+ "tags": [
17
+ "Account Service"
18
+ ],
19
+ "description": "This is a sample HTTP Get method",
20
+ "parameters": [
21
+ {
22
+ "name": "limit",
23
+ "in": "query",
24
+ "required": true,
25
+ "description": "Limits the number of items on a page",
26
+ "schema": {
27
+ "type": "integer"
28
+ }
29
+ },
30
+ {
31
+ "name": "complex",
32
+ "in": "cookie",
33
+ "description": "A more complex schema",
34
+ "schema": {
35
+ "type": "array",
36
+ "items": {
37
+ "type": "object",
38
+ "properties": {
39
+ "name": {
40
+ "type": "string"
41
+ }
42
+ }
43
+ }
44
+ }
45
+ }
46
+ ],
47
+ "responses": {
48
+ "100": {
49
+ "description": "Status code 100",
50
+ "content": {
51
+ "application/json": {
52
+ "schema": {
53
+ "type": "object",
54
+ "properties": {
55
+ "anotherObject": {
56
+ "description": "An object inside of an object",
57
+ "type": "object",
58
+ "properties": {
59
+ "message": {
60
+ "type": "string"
61
+ },
62
+ "somethingElse": {
63
+ "type": "number"
64
+ }
65
+ }
66
+ }
67
+ }
68
+ }
69
+ }
70
+ }
71
+ },
72
+ "200": {
73
+ "description": "Status code 200",
74
+ "content": {
75
+ "application/json": {
76
+ "schema": {
77
+ "type": "object",
78
+ "properties": {
79
+ "id": {
80
+ "type": "string",
81
+ "description": "The super Id."
82
+ },
83
+ "name": {
84
+ "type": "string"
85
+ },
86
+ "phone": {
87
+ "type": "string",
88
+ "format": "byte"
89
+ }
90
+ }
91
+ }
92
+ }
93
+ }
94
+ },
95
+ "304": {
96
+ "description": "Status code 304",
97
+ "content": {
98
+ "application/json": {
99
+ "schema": {
100
+ "type": "object",
101
+ "properties": {
102
+ "error": {
103
+ "type": "string"
104
+ }
105
+ }
106
+ }
107
+ }
108
+ }
109
+ },
110
+ "400": {
111
+ "description": "Status code 400",
112
+ "content": {
113
+ "application/json": {
114
+ "schema": {
115
+ "type": "array",
116
+ "items": {
117
+ "type": "object",
118
+ "properties": {
119
+ "name": {
120
+ "type": "string"
121
+ }
122
+ }
123
+ }
124
+ }
125
+ }
126
+ }
127
+ },
128
+ "500": {
129
+ "description": "Status code 500",
130
+ "content": {
131
+ "application/json": {
132
+ "schema": {
133
+ "type": "string"
134
+ }
135
+ }
136
+ }
137
+ }
138
+ }
139
+ },
140
+ "post": {
141
+ "tags": [
142
+ "Account Service"
143
+ ],
144
+ "description": "This is a sample HTTP Post method",
145
+ "summary": "Posts an Account 2",
146
+ "requestBody": {
147
+ "description": "This is an example of a request body",
148
+ "content": {
149
+ "application/json": {
150
+ "schema": {
151
+ "type": "array",
152
+ "items": {
153
+ "type": "object",
154
+ "properties": {
155
+ "name": {
156
+ "type": "string"
157
+ }
158
+ }
159
+ }
160
+ }
161
+ }
162
+ },
163
+ "required": true
164
+ },
165
+ "parameters": [
166
+ {
167
+ "name": "limit",
168
+ "in": "query",
169
+ "required": true,
170
+ "description": "Limits the number of items on a page",
171
+ "schema": {
172
+ "type": "integer"
173
+ }
174
+ },
175
+ {
176
+ "name": "complex",
177
+ "in": "cookie",
178
+ "description": "A more complex schema",
179
+ "schema": {
180
+ "type": "array",
181
+ "items": {
182
+ "type": "object",
183
+ "properties": {
184
+ "name": {
185
+ "type": "string"
186
+ }
187
+ }
188
+ }
189
+ }
190
+ }
191
+ ],
192
+ "responses": {
193
+ "200": {
194
+ "description": "Status code 200",
195
+ "content": {
196
+ "application/json": {
197
+ "schema": {
198
+ "type": "object",
199
+ "properties": {
200
+ "id": {
201
+ "type": "string",
202
+ "description": "The super Id."
203
+ },
204
+ "name": {
205
+ "type": "string"
206
+ },
207
+ "phone": {
208
+ "type": "string",
209
+ "format": "byte"
210
+ }
211
+ }
212
+ }
213
+ }
214
+ }
215
+ },
216
+ "304": {
217
+ "description": "Status code 304",
218
+ "content": {
219
+ "application/json": {
220
+ "schema": {
221
+ "type": "object",
222
+ "properties": {
223
+ "error": {
224
+ "type": "string"
225
+ }
226
+ }
227
+ }
228
+ }
229
+ }
230
+ },
231
+ "400": {
232
+ "description": "Status code 400",
233
+ "content": {
234
+ "application/json": {
235
+ "schema": {
236
+ "type": "array",
237
+ "items": {
238
+ "type": "object",
239
+ "properties": {
240
+ "name": {
241
+ "type": "string"
242
+ }
243
+ }
244
+ }
245
+ }
246
+ }
247
+ }
248
+ },
249
+ "500": {
250
+ "description": "Status code 500",
251
+ "content": {
252
+ "application/json": {
253
+ "schema": {
254
+ "type": "string"
255
+ }
256
+ }
257
+ }
258
+ }
259
+ }
260
+ },
261
+ "delete": {
262
+ "tags": [
263
+ "Account Service"
264
+ ],
265
+ "description": "Sample HTTP Delete method with references to other types.",
266
+ "parameters": [
267
+ {
268
+ "name": "limit",
269
+ "in": "header",
270
+ "required": true,
271
+ "description": "My sample description.",
272
+ "schema": {
273
+ "$ref": "#/components/schemas/SampleClass"
274
+ }
275
+ }
276
+ ],
277
+ "responses": {
278
+ "200": {
279
+ "description": "Status code 200",
280
+ "content": {
281
+ "application/json": {
282
+ "schema": {
283
+ "$ref": "#/components/schemas/SampleClass"
284
+ }
285
+ }
286
+ }
287
+ },
288
+ "304": {
289
+ "description": "Status code 304",
290
+ "content": {
291
+ "application/json": {
292
+ "schema": {
293
+ "$ref": "#/components/schemas/ChildClass"
294
+ }
295
+ }
296
+ }
297
+ },
298
+ "305": {
299
+ "description": "Status code 305",
300
+ "content": {
301
+ "application/json": {
302
+ "schema": {
303
+ "$ref": "#/components/schemas/Reference1"
304
+ }
305
+ }
306
+ }
307
+ },
308
+ "306": {
309
+ "description": "Status code 306",
310
+ "content": {
311
+ "application/json": {
312
+ "schema": {
313
+ "$ref": "#/components/schemas/Reference1_array"
314
+ }
315
+ }
316
+ }
317
+ },
318
+ "307": {
319
+ "description": "Status code 307",
320
+ "content": {
321
+ "application/json": {
322
+ "schema": {
323
+ "$ref": "#/components/schemas/Reference7_Reference7[untypedObject:Reference2]"
324
+ }
325
+ }
326
+ }
327
+ },
328
+ "500": {
329
+ "description": "Status code 500",
330
+ "content": {
331
+ "application/json": {
332
+ "schema": {
333
+ "$ref": "#/components/schemas/SampleClass"
334
+ }
335
+ }
336
+ }
337
+ }
338
+ }
339
+ }
340
+ },
341
+ "Contact/": {
342
+ "description": "Contact related operations",
343
+ "get": {
344
+ "tags": [
345
+ "Contact"
346
+ ],
347
+ "description": "This is a sample HTTP Get method",
348
+ "responses": {
349
+ "200": {
350
+ "description": "Status code 200",
351
+ "content": {
352
+ "application/json": {
353
+ "schema": {
354
+ "$ref": "#/components/schemas/SampleRestResourceWithInnerClass.InnerClass"
355
+ }
356
+ }
357
+ }
358
+ }
359
+ }
360
+ }
361
+ },
362
+ "Order/": {
363
+ "description": "Order related operations",
364
+ "get": {
365
+ "tags": [
366
+ "Order"
367
+ ],
368
+ "requestBody": {
369
+ "content": {
370
+ "application/json": {
371
+ "schema": {
372
+ "type": "object",
373
+ "properties": {
374
+ "param1": {
375
+ "type": "string"
376
+ },
377
+ "param2": {
378
+ "$ref": "#/components/schemas/Reference1"
379
+ }
380
+ }
381
+ }
382
+ }
383
+ }
384
+ },
385
+ "responses": {
386
+ "200": {
387
+ "description": "Status code 200",
388
+ "content": {
389
+ "application/json": {
390
+ "schema": {
391
+ "type": "string"
392
+ }
393
+ }
394
+ }
395
+ }
396
+ }
397
+ },
398
+ "patch": {
399
+ "tags": [
400
+ "Order"
401
+ ],
402
+ "requestBody": {
403
+ "content": {
404
+ "application/json": {
405
+ "schema": {
406
+ "type": "object",
407
+ "properties": {
408
+ "param1": {
409
+ "type": "string"
410
+ },
411
+ "param2": {
412
+ "$ref": "#/components/schemas/Reference1"
413
+ }
414
+ }
415
+ }
416
+ }
417
+ }
418
+ },
419
+ "responses": {
420
+ "200": {
421
+ "description": "Status code 200",
422
+ "content": {
423
+ "application/json": {
424
+ "schema": {
425
+ "type": "string"
426
+ }
427
+ }
428
+ }
429
+ }
430
+ }
431
+ }
432
+ }
433
+ },
434
+ "tags": [
435
+ {
436
+ "name": "Account Service",
437
+ "description": "Account related operations"
438
+ },
439
+ {
440
+ "name": "Contact",
441
+ "description": "Contact related operations"
442
+ },
443
+ {
444
+ "name": "Order",
445
+ "description": "Order related operations"
446
+ }
447
+ ],
448
+ "components": {
449
+ "schemas": {
450
+ "SampleClass": {
451
+ "type": "object",
452
+ "properties": {
453
+ "MyProp": {
454
+ "type": "string",
455
+ "description": "This is a String property."
456
+ },
457
+ "AnotherProp": {
458
+ "type": "number",
459
+ "description": "This is a Decimal property."
460
+ },
461
+ "listOfStrings": {
462
+ "type": "array",
463
+ "items": {
464
+ "type": "string"
465
+ }
466
+ },
467
+ "someVariable": {
468
+ "type": "string"
469
+ }
470
+ }
471
+ },
472
+ "ChildClass": {
473
+ "type": "object",
474
+ "properties": {
475
+ "AProp": {
476
+ "type": "string"
477
+ },
478
+ "privateStringFromChild": {
479
+ "type": "string"
480
+ },
481
+ "protectedStringFromParent": {
482
+ "type": "string",
483
+ "description": "This is a protected string, use carefully."
484
+ },
485
+ "publicStringFromParent": {
486
+ "type": "string"
487
+ },
488
+ "protectedGrandParentField": {
489
+ "type": "string"
490
+ }
491
+ }
492
+ },
493
+ "Reference1": {
494
+ "type": "object",
495
+ "properties": {
496
+ "reference2Member": {
497
+ "$ref": "#/components/schemas/Reference2",
498
+ "description": "This is a reference 2 member. Lorem."
499
+ },
500
+ "reference3Member": {
501
+ "$ref": "#/components/schemas/Reference3"
502
+ },
503
+ "reference4Collection": {
504
+ "type": "array",
505
+ "items": {
506
+ "$ref": "#/components/schemas/Reference4"
507
+ }
508
+ },
509
+ "reference5Member": {
510
+ "$ref": "#/components/schemas/Reference5"
511
+ }
512
+ }
513
+ },
514
+ "Reference2": {
515
+ "type": "object",
516
+ "properties": {
517
+ "stringMember": {
518
+ "type": "string"
519
+ },
520
+ "objectReference": {
521
+ "$ref": "#/components/schemas/Reference3_array",
522
+ "description": "This is an object reference."
523
+ }
524
+ }
525
+ },
526
+ "Reference3_array": {
527
+ "type": "array",
528
+ "items": {
529
+ "$ref": "#/components/schemas/Reference3"
530
+ }
531
+ },
532
+ "Reference3": {
533
+ "type": "object",
534
+ "properties": {
535
+ "someBoolean": {
536
+ "type": "boolean"
537
+ }
538
+ }
539
+ },
540
+ "Reference4": {
541
+ "type": "object",
542
+ "properties": {
543
+ "someString": {
544
+ "type": "string"
545
+ }
546
+ }
547
+ },
548
+ "Reference5": {
549
+ "type": "object",
550
+ "properties": {
551
+ "reference6Member": {
552
+ "$ref": "#/components/schemas/Reference6"
553
+ }
554
+ }
555
+ },
556
+ "Reference6": {
557
+ "type": "object",
558
+ "properties": {
559
+ "grandChildString": {
560
+ "type": "string",
561
+ "description": "This is the grandchild description."
562
+ }
563
+ }
564
+ },
565
+ "Reference1_array": {
566
+ "type": "array",
567
+ "items": {
568
+ "$ref": "#/components/schemas/Reference1"
569
+ }
570
+ },
571
+ "Reference7_Reference7[untypedObject:Reference2]": {
572
+ "type": "object",
573
+ "properties": {
574
+ "untypedObject": {
575
+ "$ref": "#/components/schemas/Reference2"
576
+ }
577
+ }
578
+ },
579
+ "SampleRestResourceWithInnerClass.InnerClass": {
580
+ "type": "object",
581
+ "properties": {
582
+ "stringMember": {
583
+ "type": "string"
584
+ }
585
+ }
586
+ }
587
+ }
588
+ }
589
+ }