@redocly/client-generator 0.0.0-snapshot.1787213166 → 0.0.0-snapshot.1787656839

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 (581) hide show
  1. package/README.md +8 -22
  2. package/eject-assets/AGENTS.md +28 -22
  3. package/eject-assets/generators/cli/docs.ts +224 -0
  4. package/eject-assets/generators/cli/engine-source.ts +21 -0
  5. package/eject-assets/generators/cli/index.ts +90 -0
  6. package/eject-assets/generators/cli/render.ts +348 -0
  7. package/eject-assets/generators/go/client.ts +57 -0
  8. package/eject-assets/generators/go/descriptor.ts +41 -0
  9. package/eject-assets/generators/go/index.ts +336 -0
  10. package/eject-assets/generators/go/models.ts +179 -0
  11. package/eject-assets/generators/go/naming.ts +49 -0
  12. package/eject-assets/generators/go/operations.ts +296 -0
  13. package/eject-assets/generators/go/pagination.ts +194 -0
  14. package/eject-assets/generators/go/types.ts +60 -0
  15. package/eject-assets/generators/mock/faker.ts +214 -0
  16. package/eject-assets/generators/mock/index.ts +35 -0
  17. package/eject-assets/generators/mock/render.ts +282 -0
  18. package/eject-assets/generators/mock/sample.ts +316 -0
  19. package/eject-assets/generators/mock/values.ts +63 -0
  20. package/eject-assets/generators/php/client.ts +63 -0
  21. package/eject-assets/generators/php/descriptor.ts +58 -0
  22. package/eject-assets/generators/php/index.ts +237 -0
  23. package/eject-assets/generators/php/models.ts +275 -0
  24. package/eject-assets/generators/php/naming.ts +51 -0
  25. package/eject-assets/generators/php/operations.ts +232 -0
  26. package/eject-assets/generators/php/pagination.ts +133 -0
  27. package/eject-assets/generators/php/types.ts +148 -0
  28. package/eject-assets/generators/python/client.ts +123 -0
  29. package/eject-assets/generators/python/descriptor.ts +52 -0
  30. package/eject-assets/generators/python/index.ts +251 -0
  31. package/eject-assets/generators/python/models.ts +242 -0
  32. package/eject-assets/generators/python/naming.ts +46 -0
  33. package/eject-assets/generators/python/operations.ts +147 -0
  34. package/eject-assets/generators/python/pagination.ts +128 -0
  35. package/eject-assets/generators/python/types.ts +54 -0
  36. package/eject-assets/generators/swr/index.ts +37 -0
  37. package/eject-assets/generators/swr/render.ts +78 -0
  38. package/eject-assets/generators/tanstack-query/index.ts +48 -0
  39. package/eject-assets/generators/tanstack-query/render.ts +346 -0
  40. package/eject-assets/generators/transformers/index.ts +46 -0
  41. package/eject-assets/generators/transformers/render.ts +506 -0
  42. package/eject-assets/generators/typescript/banner.ts +35 -0
  43. package/eject-assets/generators/typescript/client.ts +254 -0
  44. package/eject-assets/generators/typescript/descriptor.ts +137 -0
  45. package/eject-assets/generators/typescript/index.ts +101 -0
  46. package/eject-assets/generators/typescript/inline-runtime.ts +135 -0
  47. package/eject-assets/generators/typescript/operation-signature.ts +62 -0
  48. package/eject-assets/generators/typescript/operation-types.ts +17 -0
  49. package/eject-assets/generators/typescript/operations.ts +524 -0
  50. package/eject-assets/generators/typescript/response-headers.ts +74 -0
  51. package/eject-assets/generators/typescript/type-guards.ts +159 -0
  52. package/eject-assets/generators/typescript/types.ts +172 -0
  53. package/eject-assets/generators/zod/index.ts +32 -0
  54. package/eject-assets/generators/{zod.mjs → zod/schemas.ts} +209 -273
  55. package/eject-assets/skills/cli-generator/SKILL.md +18 -9
  56. package/eject-assets/skills/client-generators/SKILL.md +28 -22
  57. package/eject-assets/skills/go-generator/SKILL.md +7 -5
  58. package/eject-assets/skills/mock-generator/SKILL.md +14 -9
  59. package/eject-assets/skills/php-generator/SKILL.md +7 -5
  60. package/eject-assets/skills/python-generator/SKILL.md +7 -5
  61. package/eject-assets/skills/swr-generator/SKILL.md +15 -9
  62. package/eject-assets/skills/tanstack-query-generator/SKILL.md +16 -9
  63. package/eject-assets/skills/transformers-generator/SKILL.md +13 -9
  64. package/eject-assets/skills/typescript-generator/SKILL.md +34 -19
  65. package/eject-assets/skills/zod-generator/SKILL.md +14 -9
  66. package/lib/authoring/index.d.ts +3 -2
  67. package/lib/authoring/index.d.ts.map +1 -1
  68. package/lib/authoring/index.js +9 -1
  69. package/lib/authoring/index.js.map +1 -1
  70. package/lib/authoring/naming.js +1 -1
  71. package/lib/authoring/operation.d.ts +47 -0
  72. package/lib/authoring/operation.d.ts.map +1 -0
  73. package/lib/authoring/operation.js +86 -0
  74. package/lib/authoring/operation.js.map +1 -0
  75. package/lib/authoring/pagination.d.ts +2 -2
  76. package/lib/authoring/pagination.d.ts.map +1 -1
  77. package/lib/authoring/pagination.js +1 -1
  78. package/lib/authoring/pagination.js.map +1 -1
  79. package/lib/authoring/reference-page.d.ts +2 -0
  80. package/lib/authoring/reference-page.d.ts.map +1 -1
  81. package/lib/authoring/reference-page.js +4 -1
  82. package/lib/authoring/reference-page.js.map +1 -1
  83. package/lib/authoring/schema.d.ts +2 -0
  84. package/lib/authoring/schema.d.ts.map +1 -1
  85. package/lib/authoring/schema.js +8 -3
  86. package/lib/authoring/schema.js.map +1 -1
  87. package/lib/{runtime/cli.d.ts → cli-contract.d.ts} +1 -31
  88. package/lib/cli-contract.d.ts.map +1 -0
  89. package/lib/cli-contract.js +25 -0
  90. package/lib/cli-contract.js.map +1 -0
  91. package/lib/{emitters/wrapper-support.d.ts → contracts/typescript.d.ts} +3 -1
  92. package/lib/contracts/typescript.d.ts.map +1 -0
  93. package/lib/{emitters/wrapper-support.js → contracts/typescript.js} +15 -12
  94. package/lib/contracts/typescript.js.map +1 -0
  95. package/lib/generate.d.ts +8 -9
  96. package/lib/generate.d.ts.map +1 -1
  97. package/lib/generate.js +6 -6
  98. package/lib/generate.js.map +1 -1
  99. package/lib/{emitters/cli-docs.d.ts → generators/cli/docs.d.ts} +2 -2
  100. package/lib/{emitters/cli-docs.d.ts.map → generators/cli/docs.d.ts.map} +1 -1
  101. package/lib/{emitters/cli-docs.js → generators/cli/docs.js} +2 -3
  102. package/lib/generators/cli/docs.js.map +1 -0
  103. package/lib/generators/cli/engine-source.d.ts +5 -0
  104. package/lib/generators/cli/engine-source.d.ts.map +1 -0
  105. package/lib/generators/cli/engine-source.js +12 -0
  106. package/lib/generators/cli/engine-source.js.map +1 -0
  107. package/lib/generators/cli/index.d.ts +1 -2
  108. package/lib/generators/cli/index.d.ts.map +1 -1
  109. package/lib/generators/cli/index.js +24 -16
  110. package/lib/generators/cli/index.js.map +1 -1
  111. package/lib/{emitters/cli.d.ts → generators/cli/render.d.ts} +6 -7
  112. package/lib/generators/cli/render.d.ts.map +1 -0
  113. package/lib/{emitters/cli.js → generators/cli/render.js} +16 -20
  114. package/lib/generators/cli/render.js.map +1 -0
  115. package/lib/generators/cli/runtime/cli.d.ts +42 -0
  116. package/lib/generators/cli/runtime/cli.d.ts.map +1 -0
  117. package/lib/{runtime → generators/cli/runtime}/cli.js +3 -19
  118. package/lib/generators/cli/runtime/cli.js.map +1 -0
  119. package/lib/generators/go/client.d.ts +5 -0
  120. package/lib/generators/go/client.d.ts.map +1 -0
  121. package/lib/generators/go/client.js +34 -0
  122. package/lib/generators/go/client.js.map +1 -0
  123. package/lib/generators/go/descriptor.d.ts +6 -0
  124. package/lib/generators/go/descriptor.d.ts.map +1 -0
  125. package/lib/generators/go/descriptor.js +26 -0
  126. package/lib/generators/go/descriptor.js.map +1 -0
  127. package/lib/generators/go/index.d.ts +3 -7
  128. package/lib/generators/go/index.d.ts.map +1 -1
  129. package/lib/generators/go/index.js +114 -722
  130. package/lib/generators/go/index.js.map +1 -1
  131. package/lib/generators/go/models.d.ts +4 -0
  132. package/lib/generators/go/models.d.ts.map +1 -0
  133. package/lib/generators/go/models.js +125 -0
  134. package/lib/generators/go/models.js.map +1 -0
  135. package/lib/generators/go/naming.d.ts +15 -0
  136. package/lib/generators/go/naming.d.ts.map +1 -0
  137. package/lib/generators/go/naming.js +36 -0
  138. package/lib/generators/go/naming.js.map +1 -0
  139. package/lib/generators/go/operations.d.ts +16 -0
  140. package/lib/generators/go/operations.d.ts.map +1 -0
  141. package/lib/generators/go/operations.js +200 -0
  142. package/lib/generators/go/operations.js.map +1 -0
  143. package/lib/generators/go/pagination.d.ts +5 -0
  144. package/lib/generators/go/pagination.d.ts.map +1 -0
  145. package/lib/generators/go/pagination.js +93 -0
  146. package/lib/generators/go/pagination.js.map +1 -0
  147. package/lib/generators/go/types.d.ts +4 -0
  148. package/lib/generators/go/types.d.ts.map +1 -0
  149. package/lib/generators/go/types.js +48 -0
  150. package/lib/generators/go/types.js.map +1 -0
  151. package/lib/generators/index.d.ts +1 -2
  152. package/lib/generators/index.d.ts.map +1 -1
  153. package/lib/generators/index.js.map +1 -1
  154. package/lib/generators/meta.d.ts +1 -2
  155. package/lib/generators/meta.d.ts.map +1 -1
  156. package/lib/generators/meta.js +0 -4
  157. package/lib/generators/meta.js.map +1 -1
  158. package/lib/{emitters → generators/mock}/faker.d.ts +2 -3
  159. package/lib/generators/mock/faker.d.ts.map +1 -0
  160. package/lib/{emitters → generators/mock}/faker.js +5 -5
  161. package/lib/generators/mock/faker.js.map +1 -0
  162. package/lib/generators/mock/index.d.ts +1 -1
  163. package/lib/generators/mock/index.d.ts.map +1 -1
  164. package/lib/generators/mock/index.js +7 -7
  165. package/lib/generators/mock/index.js.map +1 -1
  166. package/lib/{emitters/mock.d.ts → generators/mock/render.d.ts} +2 -3
  167. package/lib/generators/mock/render.d.ts.map +1 -0
  168. package/lib/{emitters/mock.js → generators/mock/render.js} +6 -8
  169. package/lib/generators/mock/render.js.map +1 -0
  170. package/lib/{emitters → generators/mock}/sample.d.ts +1 -2
  171. package/lib/generators/mock/sample.d.ts.map +1 -0
  172. package/lib/generators/mock/sample.js.map +1 -0
  173. package/lib/{emitters/mock-value.d.ts → generators/mock/values.d.ts} +1 -1
  174. package/lib/generators/mock/values.d.ts.map +1 -0
  175. package/lib/{emitters/mock-value.js → generators/mock/values.js} +2 -3
  176. package/lib/generators/mock/values.js.map +1 -0
  177. package/lib/generators/php/client.d.ts +5 -0
  178. package/lib/generators/php/client.d.ts.map +1 -0
  179. package/lib/generators/php/client.js +38 -0
  180. package/lib/generators/php/client.js.map +1 -0
  181. package/lib/generators/php/descriptor.d.ts +7 -0
  182. package/lib/generators/php/descriptor.d.ts.map +1 -0
  183. package/lib/generators/php/descriptor.js +42 -0
  184. package/lib/generators/php/descriptor.js.map +1 -0
  185. package/lib/generators/php/index.d.ts +3 -7
  186. package/lib/generators/php/index.d.ts.map +1 -1
  187. package/lib/generators/php/index.js +56 -712
  188. package/lib/generators/php/index.js.map +1 -1
  189. package/lib/generators/php/models.d.ts +8 -0
  190. package/lib/generators/php/models.d.ts.map +1 -0
  191. package/lib/generators/php/models.js +200 -0
  192. package/lib/generators/php/models.js.map +1 -0
  193. package/lib/generators/php/naming.d.ts +16 -0
  194. package/lib/generators/php/naming.d.ts.map +1 -0
  195. package/lib/generators/php/naming.js +31 -0
  196. package/lib/generators/php/naming.js.map +1 -0
  197. package/lib/generators/php/operations.d.ts +21 -0
  198. package/lib/generators/php/operations.d.ts.map +1 -0
  199. package/lib/generators/php/operations.js +156 -0
  200. package/lib/generators/php/operations.js.map +1 -0
  201. package/lib/generators/php/pagination.d.ts +5 -0
  202. package/lib/generators/php/pagination.d.ts.map +1 -0
  203. package/lib/generators/php/pagination.js +68 -0
  204. package/lib/generators/php/pagination.js.map +1 -0
  205. package/lib/generators/php/types.d.ts +27 -0
  206. package/lib/generators/php/types.d.ts.map +1 -0
  207. package/lib/generators/php/types.js +128 -0
  208. package/lib/generators/php/types.js.map +1 -0
  209. package/lib/generators/python/client.d.ts +6 -0
  210. package/lib/generators/python/client.d.ts.map +1 -0
  211. package/lib/generators/python/client.js +80 -0
  212. package/lib/generators/python/client.js.map +1 -0
  213. package/lib/generators/python/descriptor.d.ts +9 -0
  214. package/lib/generators/python/descriptor.d.ts.map +1 -0
  215. package/lib/generators/python/descriptor.js +38 -0
  216. package/lib/generators/python/descriptor.js.map +1 -0
  217. package/lib/generators/python/index.d.ts +3 -9
  218. package/lib/generators/python/index.d.ts.map +1 -1
  219. package/lib/generators/python/index.js +64 -673
  220. package/lib/generators/python/index.js.map +1 -1
  221. package/lib/generators/python/models.d.ts +31 -0
  222. package/lib/generators/python/models.d.ts.map +1 -0
  223. package/lib/generators/python/models.js +203 -0
  224. package/lib/generators/python/models.js.map +1 -0
  225. package/lib/generators/python/naming.d.ts +22 -0
  226. package/lib/generators/python/naming.d.ts.map +1 -0
  227. package/lib/generators/python/naming.js +28 -0
  228. package/lib/generators/python/naming.js.map +1 -0
  229. package/lib/generators/python/operations.d.ts +4 -0
  230. package/lib/generators/python/operations.d.ts.map +1 -0
  231. package/lib/generators/python/operations.js +108 -0
  232. package/lib/generators/python/operations.js.map +1 -0
  233. package/lib/generators/python/pagination.d.ts +5 -0
  234. package/lib/generators/python/pagination.d.ts.map +1 -0
  235. package/lib/generators/python/pagination.js +95 -0
  236. package/lib/generators/python/pagination.js.map +1 -0
  237. package/lib/generators/python/types.d.ts +4 -0
  238. package/lib/generators/python/types.d.ts.map +1 -0
  239. package/lib/generators/python/types.js +45 -0
  240. package/lib/generators/python/types.js.map +1 -0
  241. package/lib/generators/resolve.js +19 -2
  242. package/lib/generators/resolve.js.map +1 -1
  243. package/lib/generators/swr/index.d.ts +1 -1
  244. package/lib/generators/swr/index.d.ts.map +1 -1
  245. package/lib/generators/swr/index.js +5 -7
  246. package/lib/generators/swr/index.js.map +1 -1
  247. package/lib/{emitters/swr.d.ts → generators/swr/render.d.ts} +2 -2
  248. package/lib/generators/swr/render.d.ts.map +1 -0
  249. package/lib/{emitters/swr.js → generators/swr/render.js} +3 -3
  250. package/lib/generators/swr/render.js.map +1 -0
  251. package/lib/generators/tanstack-query/index.d.ts +1 -1
  252. package/lib/generators/tanstack-query/index.d.ts.map +1 -1
  253. package/lib/generators/tanstack-query/index.js +8 -8
  254. package/lib/generators/tanstack-query/index.js.map +1 -1
  255. package/lib/{emitters/tanstack-query.d.ts → generators/tanstack-query/render.d.ts} +4 -5
  256. package/lib/generators/tanstack-query/render.d.ts.map +1 -0
  257. package/lib/{emitters/tanstack-query.js → generators/tanstack-query/render.js} +5 -5
  258. package/lib/generators/tanstack-query/render.js.map +1 -0
  259. package/lib/generators/transformers/index.d.ts +1 -1
  260. package/lib/generators/transformers/index.d.ts.map +1 -1
  261. package/lib/generators/transformers/index.js +10 -7
  262. package/lib/generators/transformers/index.js.map +1 -1
  263. package/lib/{emitters/transformers.d.ts → generators/transformers/render.d.ts} +2 -2
  264. package/lib/generators/transformers/render.d.ts.map +1 -0
  265. package/lib/{emitters/transformers.js → generators/transformers/render.js} +2 -3
  266. package/lib/generators/transformers/render.js.map +1 -0
  267. package/lib/generators/types.d.ts +108 -8
  268. package/lib/generators/types.d.ts.map +1 -1
  269. package/lib/generators/typescript/banner.d.ts +12 -0
  270. package/lib/generators/typescript/banner.d.ts.map +1 -0
  271. package/lib/{emitters/emit-options.js → generators/typescript/banner.js} +2 -3
  272. package/lib/generators/typescript/banner.js.map +1 -0
  273. package/lib/generators/typescript/client.d.ts +25 -0
  274. package/lib/generators/typescript/client.d.ts.map +1 -0
  275. package/lib/{emitters/client-assembly.js → generators/typescript/client.js} +69 -79
  276. package/lib/generators/typescript/client.js.map +1 -0
  277. package/lib/{emitters → generators/typescript}/descriptor.d.ts +1 -4
  278. package/lib/generators/typescript/descriptor.d.ts.map +1 -0
  279. package/lib/{emitters → generators/typescript}/descriptor.js +9 -28
  280. package/lib/generators/typescript/descriptor.js.map +1 -0
  281. package/lib/generators/typescript/index.d.ts +1 -2
  282. package/lib/generators/typescript/index.d.ts.map +1 -1
  283. package/lib/generators/typescript/index.js +17 -12
  284. package/lib/generators/typescript/index.js.map +1 -1
  285. package/lib/generators/typescript/inline-runtime.d.ts +21 -0
  286. package/lib/generators/typescript/inline-runtime.d.ts.map +1 -0
  287. package/lib/{emitters → generators/typescript}/inline-runtime.js +55 -9
  288. package/lib/generators/typescript/inline-runtime.js.map +1 -0
  289. package/lib/{emitters → generators/typescript}/operation-signature.d.ts +1 -1
  290. package/lib/generators/typescript/operation-signature.d.ts.map +1 -0
  291. package/lib/{emitters → generators/typescript}/operation-signature.js +1 -1
  292. package/lib/generators/typescript/operation-signature.js.map +1 -0
  293. package/lib/{emitters → generators/typescript}/operation-types.d.ts +1 -1
  294. package/lib/generators/typescript/operation-types.d.ts.map +1 -0
  295. package/lib/generators/typescript/operation-types.js.map +1 -0
  296. package/lib/{emitters/render-client.d.ts → generators/typescript/operations.d.ts} +20 -4
  297. package/lib/generators/typescript/operations.d.ts.map +1 -0
  298. package/lib/{emitters/render-client.js → generators/typescript/operations.js} +10 -12
  299. package/lib/generators/typescript/operations.js.map +1 -0
  300. package/lib/{emitters → generators/typescript}/response-headers.d.ts +1 -2
  301. package/lib/generators/typescript/response-headers.d.ts.map +1 -0
  302. package/lib/{emitters → generators/typescript}/response-headers.js +2 -3
  303. package/lib/generators/typescript/response-headers.js.map +1 -0
  304. package/lib/generators/typescript/runtime/auth.d.ts.map +1 -0
  305. package/lib/generators/typescript/runtime/auth.js.map +1 -0
  306. package/lib/generators/typescript/runtime/create-client.d.ts.map +1 -0
  307. package/lib/generators/typescript/runtime/create-client.js.map +1 -0
  308. package/lib/generators/typescript/runtime/errors.d.ts.map +1 -0
  309. package/lib/generators/typescript/runtime/errors.js.map +1 -0
  310. package/lib/generators/typescript/runtime/index.d.ts.map +1 -0
  311. package/lib/generators/typescript/runtime/index.js.map +1 -0
  312. package/lib/generators/typescript/runtime/multipart.d.ts.map +1 -0
  313. package/lib/generators/typescript/runtime/multipart.js.map +1 -0
  314. package/lib/generators/typescript/runtime/paginate.d.ts.map +1 -0
  315. package/lib/generators/typescript/runtime/paginate.js.map +1 -0
  316. package/lib/generators/typescript/runtime/parse.d.ts.map +1 -0
  317. package/lib/generators/typescript/runtime/parse.js.map +1 -0
  318. package/lib/generators/typescript/runtime/retry.d.ts.map +1 -0
  319. package/lib/generators/typescript/runtime/retry.js.map +1 -0
  320. package/lib/generators/typescript/runtime/send.d.ts.map +1 -0
  321. package/lib/generators/typescript/runtime/send.js.map +1 -0
  322. package/lib/generators/typescript/runtime/setup.d.ts.map +1 -0
  323. package/lib/generators/typescript/runtime/setup.js.map +1 -0
  324. package/lib/generators/typescript/runtime/sse.d.ts.map +1 -0
  325. package/lib/generators/typescript/runtime/sse.js.map +1 -0
  326. package/lib/{runtime → generators/typescript/runtime}/types.d.ts +5 -95
  327. package/lib/generators/typescript/runtime/types.d.ts.map +1 -0
  328. package/lib/generators/typescript/runtime/types.js.map +1 -0
  329. package/lib/generators/typescript/runtime/url.d.ts.map +1 -0
  330. package/lib/generators/typescript/runtime/url.js.map +1 -0
  331. package/lib/{emitters → generators/typescript}/type-guards.d.ts +1 -1
  332. package/lib/generators/typescript/type-guards.d.ts.map +1 -0
  333. package/lib/generators/typescript/type-guards.js.map +1 -0
  334. package/lib/{emitters/ts-type.d.ts → generators/typescript/types.d.ts} +2 -3
  335. package/lib/generators/typescript/types.d.ts.map +1 -0
  336. package/lib/{emitters/ts-type.js → generators/typescript/types.js} +2 -3
  337. package/lib/generators/typescript/types.js.map +1 -0
  338. package/lib/generators/zod/index.d.ts +1 -1
  339. package/lib/generators/zod/index.d.ts.map +1 -1
  340. package/lib/generators/zod/index.js +4 -6
  341. package/lib/generators/zod/index.js.map +1 -1
  342. package/lib/{emitters/zod.d.ts → generators/zod/schemas.d.ts} +2 -2
  343. package/lib/generators/zod/schemas.d.ts.map +1 -0
  344. package/lib/{emitters/zod.js → generators/zod/schemas.js} +6 -9
  345. package/lib/generators/zod/schemas.js.map +1 -0
  346. package/lib/index.d.ts +7 -5
  347. package/lib/index.d.ts.map +1 -1
  348. package/lib/index.js +15 -13
  349. package/lib/index.js.map +1 -1
  350. package/lib/intermediate-representation/build.d.ts +8 -1
  351. package/lib/intermediate-representation/build.d.ts.map +1 -1
  352. package/lib/intermediate-representation/build.js +27 -0
  353. package/lib/intermediate-representation/build.js.map +1 -1
  354. package/lib/intermediate-representation/model.d.ts +13 -0
  355. package/lib/intermediate-representation/model.d.ts.map +1 -1
  356. package/lib/intermediate-representation/model.js.map +1 -1
  357. package/lib/intermediate-representation/sanitize-identifiers.d.ts.map +1 -1
  358. package/lib/intermediate-representation/sanitize-identifiers.js +2 -3
  359. package/lib/intermediate-representation/sanitize-identifiers.js.map +1 -1
  360. package/lib/{emitters/pagination.d.ts → pagination.d.ts} +34 -3
  361. package/lib/pagination.d.ts.map +1 -0
  362. package/lib/{emitters/pagination.js → pagination.js} +4 -5
  363. package/lib/pagination.js.map +1 -0
  364. package/lib/pipeline.d.ts +4 -7
  365. package/lib/pipeline.d.ts.map +1 -1
  366. package/lib/pipeline.js +23 -7
  367. package/lib/pipeline.js.map +1 -1
  368. package/lib/plugin.d.ts +3 -4
  369. package/lib/plugin.d.ts.map +1 -1
  370. package/lib/plugin.js +5 -3
  371. package/lib/plugin.js.map +1 -1
  372. package/lib/printers/go.d.ts +33 -0
  373. package/lib/printers/go.d.ts.map +1 -0
  374. package/lib/printers/go.js +209 -0
  375. package/lib/printers/go.js.map +1 -0
  376. package/lib/printers/index.d.ts +5 -0
  377. package/lib/printers/index.d.ts.map +1 -0
  378. package/lib/printers/index.js +9 -0
  379. package/lib/printers/index.js.map +1 -0
  380. package/lib/printers/php.d.ts +21 -0
  381. package/lib/printers/php.d.ts.map +1 -0
  382. package/lib/printers/php.js +68 -0
  383. package/lib/printers/php.js.map +1 -0
  384. package/lib/printers/python.d.ts +31 -0
  385. package/lib/printers/python.d.ts.map +1 -0
  386. package/lib/printers/python.js +101 -0
  387. package/lib/printers/python.js.map +1 -0
  388. package/lib/printers/typescript.d.ts +82 -0
  389. package/lib/printers/typescript.d.ts.map +1 -0
  390. package/lib/printers/typescript.js +268 -0
  391. package/lib/printers/typescript.js.map +1 -0
  392. package/lib/reserved-names.d.ts.map +1 -0
  393. package/lib/{emitters/reserved-names.js → reserved-names.js} +1 -1
  394. package/lib/reserved-names.js.map +1 -0
  395. package/lib/runtime-contract.d.ts +62 -2
  396. package/lib/runtime-contract.d.ts.map +1 -1
  397. package/lib/runtime-contract.js +3 -3
  398. package/lib/runtime-contract.js.map +1 -1
  399. package/lib/{emitters/go-runtime-sources.d.ts → runtime-sources/go.d.ts} +1 -1
  400. package/lib/runtime-sources/go.d.ts.map +1 -0
  401. package/lib/{emitters/go-runtime-sources.js → runtime-sources/go.js} +1 -1
  402. package/lib/runtime-sources/go.js.map +1 -0
  403. package/lib/{emitters/php-runtime-sources.d.ts → runtime-sources/php.d.ts} +1 -1
  404. package/lib/runtime-sources/php.d.ts.map +1 -0
  405. package/lib/{emitters/php-runtime-sources.js → runtime-sources/php.js} +1 -1
  406. package/lib/runtime-sources/php.js.map +1 -0
  407. package/lib/{emitters/python-runtime-sources.d.ts → runtime-sources/python.d.ts} +1 -1
  408. package/lib/runtime-sources/python.d.ts.map +1 -0
  409. package/lib/{emitters/python-runtime-sources.js → runtime-sources/python.js} +1 -1
  410. package/lib/runtime-sources/python.js.map +1 -0
  411. package/lib/{emitters/runtime-sources.d.ts → runtime-sources/typescript.d.ts} +1 -1
  412. package/lib/runtime-sources/typescript.d.ts.map +1 -0
  413. package/lib/{emitters/runtime-sources.js → runtime-sources/typescript.js} +1 -1
  414. package/lib/runtime-sources/typescript.js.map +1 -0
  415. package/lib/runtime-sources.d.ts +4 -3
  416. package/lib/runtime-sources.d.ts.map +1 -1
  417. package/lib/runtime-sources.js +5 -4
  418. package/lib/runtime-sources.js.map +1 -1
  419. package/lib/setup-bake.d.ts.map +1 -0
  420. package/lib/{emitters/setup-bake.js → setup-bake.js} +1 -1
  421. package/lib/setup-bake.js.map +1 -0
  422. package/lib/types.d.ts +5 -5
  423. package/lib/types.d.ts.map +1 -1
  424. package/package.json +32 -2
  425. package/eject-assets/generators/cli.mjs +0 -796
  426. package/eject-assets/generators/go.mjs +0 -866
  427. package/eject-assets/generators/mock.mjs +0 -689
  428. package/eject-assets/generators/php.mjs +0 -840
  429. package/eject-assets/generators/python.mjs +0 -823
  430. package/eject-assets/generators/swr.mjs +0 -193
  431. package/eject-assets/generators/tanstack-query.mjs +0 -626
  432. package/eject-assets/generators/transformers.mjs +0 -403
  433. package/eject-assets/generators/typescript.mjs +0 -1821
  434. package/lib/emitters/cli-docs.js.map +0 -1
  435. package/lib/emitters/cli.d.ts.map +0 -1
  436. package/lib/emitters/cli.js.map +0 -1
  437. package/lib/emitters/client-assembly.d.ts +0 -15
  438. package/lib/emitters/client-assembly.d.ts.map +0 -1
  439. package/lib/emitters/client-assembly.js.map +0 -1
  440. package/lib/emitters/descriptor.d.ts.map +0 -1
  441. package/lib/emitters/descriptor.js.map +0 -1
  442. package/lib/emitters/emit-options.d.ts +0 -81
  443. package/lib/emitters/emit-options.d.ts.map +0 -1
  444. package/lib/emitters/emit-options.js.map +0 -1
  445. package/lib/emitters/faker.d.ts.map +0 -1
  446. package/lib/emitters/faker.js.map +0 -1
  447. package/lib/emitters/go-runtime-sources.d.ts.map +0 -1
  448. package/lib/emitters/go-runtime-sources.js.map +0 -1
  449. package/lib/emitters/identifier.d.ts +0 -34
  450. package/lib/emitters/identifier.d.ts.map +0 -1
  451. package/lib/emitters/identifier.js +0 -114
  452. package/lib/emitters/identifier.js.map +0 -1
  453. package/lib/emitters/inline-runtime.d.ts +0 -13
  454. package/lib/emitters/inline-runtime.d.ts.map +0 -1
  455. package/lib/emitters/inline-runtime.js.map +0 -1
  456. package/lib/emitters/jsdoc.d.ts +0 -11
  457. package/lib/emitters/jsdoc.d.ts.map +0 -1
  458. package/lib/emitters/jsdoc.js +0 -86
  459. package/lib/emitters/jsdoc.js.map +0 -1
  460. package/lib/emitters/mock-value.d.ts.map +0 -1
  461. package/lib/emitters/mock-value.js.map +0 -1
  462. package/lib/emitters/mock.d.ts.map +0 -1
  463. package/lib/emitters/mock.js.map +0 -1
  464. package/lib/emitters/operation-signature.d.ts.map +0 -1
  465. package/lib/emitters/operation-signature.js.map +0 -1
  466. package/lib/emitters/operation-types.d.ts.map +0 -1
  467. package/lib/emitters/operation-types.js.map +0 -1
  468. package/lib/emitters/operations.d.ts +0 -33
  469. package/lib/emitters/operations.d.ts.map +0 -1
  470. package/lib/emitters/operations.js +0 -2
  471. package/lib/emitters/operations.js.map +0 -1
  472. package/lib/emitters/pagination.d.ts.map +0 -1
  473. package/lib/emitters/pagination.js.map +0 -1
  474. package/lib/emitters/php-runtime-sources.d.ts.map +0 -1
  475. package/lib/emitters/php-runtime-sources.js.map +0 -1
  476. package/lib/emitters/python-runtime-sources.d.ts.map +0 -1
  477. package/lib/emitters/python-runtime-sources.js.map +0 -1
  478. package/lib/emitters/render-client.d.ts.map +0 -1
  479. package/lib/emitters/render-client.js.map +0 -1
  480. package/lib/emitters/reserved-names.d.ts.map +0 -1
  481. package/lib/emitters/reserved-names.js.map +0 -1
  482. package/lib/emitters/response-headers.d.ts.map +0 -1
  483. package/lib/emitters/response-headers.js.map +0 -1
  484. package/lib/emitters/runtime-sources.d.ts.map +0 -1
  485. package/lib/emitters/runtime-sources.js.map +0 -1
  486. package/lib/emitters/sample.d.ts.map +0 -1
  487. package/lib/emitters/sample.js.map +0 -1
  488. package/lib/emitters/setup-bake.d.ts.map +0 -1
  489. package/lib/emitters/setup-bake.js.map +0 -1
  490. package/lib/emitters/sse.d.ts +0 -8
  491. package/lib/emitters/sse.d.ts.map +0 -1
  492. package/lib/emitters/sse.js +0 -36
  493. package/lib/emitters/sse.js.map +0 -1
  494. package/lib/emitters/support.d.ts +0 -18
  495. package/lib/emitters/support.d.ts.map +0 -1
  496. package/lib/emitters/support.js +0 -37
  497. package/lib/emitters/support.js.map +0 -1
  498. package/lib/emitters/swr.d.ts.map +0 -1
  499. package/lib/emitters/swr.js.map +0 -1
  500. package/lib/emitters/tanstack-query.d.ts.map +0 -1
  501. package/lib/emitters/tanstack-query.js.map +0 -1
  502. package/lib/emitters/transformers.d.ts.map +0 -1
  503. package/lib/emitters/transformers.js.map +0 -1
  504. package/lib/emitters/ts-literal.d.ts +0 -5
  505. package/lib/emitters/ts-literal.d.ts.map +0 -1
  506. package/lib/emitters/ts-literal.js +0 -35
  507. package/lib/emitters/ts-literal.js.map +0 -1
  508. package/lib/emitters/ts-type.d.ts.map +0 -1
  509. package/lib/emitters/ts-type.js.map +0 -1
  510. package/lib/emitters/type-guards.d.ts.map +0 -1
  511. package/lib/emitters/type-guards.js.map +0 -1
  512. package/lib/emitters/types.d.ts +0 -2
  513. package/lib/emitters/types.d.ts.map +0 -1
  514. package/lib/emitters/types.js +0 -5
  515. package/lib/emitters/types.js.map +0 -1
  516. package/lib/emitters/wrapper-support.d.ts.map +0 -1
  517. package/lib/emitters/wrapper-support.js.map +0 -1
  518. package/lib/emitters/zod.d.ts.map +0 -1
  519. package/lib/emitters/zod.js.map +0 -1
  520. package/lib/generators/anchor.d.ts +0 -9
  521. package/lib/generators/anchor.d.ts.map +0 -1
  522. package/lib/generators/anchor.js +0 -10
  523. package/lib/generators/anchor.js.map +0 -1
  524. package/lib/runtime/auth.d.ts.map +0 -1
  525. package/lib/runtime/auth.js.map +0 -1
  526. package/lib/runtime/cli.d.ts.map +0 -1
  527. package/lib/runtime/cli.js.map +0 -1
  528. package/lib/runtime/create-client.d.ts.map +0 -1
  529. package/lib/runtime/create-client.js.map +0 -1
  530. package/lib/runtime/errors.d.ts.map +0 -1
  531. package/lib/runtime/errors.js.map +0 -1
  532. package/lib/runtime/index.d.ts.map +0 -1
  533. package/lib/runtime/index.js.map +0 -1
  534. package/lib/runtime/multipart.d.ts.map +0 -1
  535. package/lib/runtime/multipart.js.map +0 -1
  536. package/lib/runtime/paginate.d.ts.map +0 -1
  537. package/lib/runtime/paginate.js.map +0 -1
  538. package/lib/runtime/parse.d.ts.map +0 -1
  539. package/lib/runtime/parse.js.map +0 -1
  540. package/lib/runtime/retry.d.ts.map +0 -1
  541. package/lib/runtime/retry.js.map +0 -1
  542. package/lib/runtime/send.d.ts.map +0 -1
  543. package/lib/runtime/send.js.map +0 -1
  544. package/lib/runtime/setup.d.ts.map +0 -1
  545. package/lib/runtime/setup.js.map +0 -1
  546. package/lib/runtime/sse.d.ts.map +0 -1
  547. package/lib/runtime/sse.js.map +0 -1
  548. package/lib/runtime/types.d.ts.map +0 -1
  549. package/lib/runtime/types.js.map +0 -1
  550. package/lib/runtime/url.d.ts.map +0 -1
  551. package/lib/runtime/url.js.map +0 -1
  552. /package/lib/{emitters → generators/mock}/sample.js +0 -0
  553. /package/lib/{emitters → generators/typescript}/operation-types.js +0 -0
  554. /package/lib/{runtime → generators/typescript/runtime}/auth.d.ts +0 -0
  555. /package/lib/{runtime → generators/typescript/runtime}/auth.js +0 -0
  556. /package/lib/{runtime → generators/typescript/runtime}/create-client.d.ts +0 -0
  557. /package/lib/{runtime → generators/typescript/runtime}/create-client.js +0 -0
  558. /package/lib/{runtime → generators/typescript/runtime}/errors.d.ts +0 -0
  559. /package/lib/{runtime → generators/typescript/runtime}/errors.js +0 -0
  560. /package/lib/{runtime → generators/typescript/runtime}/index.d.ts +0 -0
  561. /package/lib/{runtime → generators/typescript/runtime}/index.js +0 -0
  562. /package/lib/{runtime → generators/typescript/runtime}/multipart.d.ts +0 -0
  563. /package/lib/{runtime → generators/typescript/runtime}/multipart.js +0 -0
  564. /package/lib/{runtime → generators/typescript/runtime}/paginate.d.ts +0 -0
  565. /package/lib/{runtime → generators/typescript/runtime}/paginate.js +0 -0
  566. /package/lib/{runtime → generators/typescript/runtime}/parse.d.ts +0 -0
  567. /package/lib/{runtime → generators/typescript/runtime}/parse.js +0 -0
  568. /package/lib/{runtime → generators/typescript/runtime}/retry.d.ts +0 -0
  569. /package/lib/{runtime → generators/typescript/runtime}/retry.js +0 -0
  570. /package/lib/{runtime → generators/typescript/runtime}/send.d.ts +0 -0
  571. /package/lib/{runtime → generators/typescript/runtime}/send.js +0 -0
  572. /package/lib/{runtime → generators/typescript/runtime}/setup.d.ts +0 -0
  573. /package/lib/{runtime → generators/typescript/runtime}/setup.js +0 -0
  574. /package/lib/{runtime → generators/typescript/runtime}/sse.d.ts +0 -0
  575. /package/lib/{runtime → generators/typescript/runtime}/sse.js +0 -0
  576. /package/lib/{runtime → generators/typescript/runtime}/types.js +0 -0
  577. /package/lib/{runtime → generators/typescript/runtime}/url.d.ts +0 -0
  578. /package/lib/{runtime → generators/typescript/runtime}/url.js +0 -0
  579. /package/lib/{emitters → generators/typescript}/type-guards.js +0 -0
  580. /package/lib/{emitters/reserved-names.d.ts → reserved-names.d.ts} +0 -0
  581. /package/lib/{emitters/setup-bake.d.ts → setup-bake.d.ts} +0 -0
package/README.md CHANGED
@@ -11,7 +11,7 @@ See https://github.com/Redocly/redocly-cli for the full project.
11
11
  The generated client uses only web-standard APIs (`fetch`, `AbortController`, `URLSearchParams`), so by default it is a single self-contained file with zero runtime dependencies that runs in browsers, Node ≥ 18, Bun, Deno, and edge runtimes.
12
12
  (Running the generator itself requires the Node version in this package's `engines` field.)
13
13
  Code is produced through the TypeScript compiler AST, not string templates; `typescript` is the only peer dependency — optional, needed only when you run generation, and it must be 6.x there (TypeScript 7's native compiler has no compiler API).
14
- Apps that only consume a package-runtime client don't need it at all, and can compile the generated code with any TypeScript, including 7.
14
+ Apps that only consume a generated client don't need it at all, and can compile the generated code with any TypeScript, including 7.
15
15
 
16
16
  This package is the engine behind the [`generate-client` command](https://redocly.com/docs/cli/commands/generate-client) — install [`@redocly/cli`](https://www.npmjs.com/package/@redocly/cli) to run it from the command line or `redocly.yaml`.
17
17
  How to use the generated client — auth, middleware, retries, pagination, Server-Sent Events, and the add-on generators (`zod`, `tanstack-query`, `swr`, `mock`, `transformers`) — is documented in [Use the generated client](https://redocly.com/docs/cli/guides/use-generated-client).
@@ -41,8 +41,7 @@ For type-safe authoring of a standalone options object, annotate it with `satisf
41
41
  The generated module exports its operation descriptors, so an app can build additional instances with independent configuration and credentials over the same generated code:
42
42
 
43
43
  ```ts
44
- import { createClient } from '@redocly/client-generator';
45
- import { OPERATIONS, type Ops } from './client.ts';
44
+ import { createClient, OPERATIONS, type Ops } from './client.ts';
46
45
 
47
46
  const internal = createClient<Ops>(OPERATIONS, {
48
47
  serverUrl: 'https://api.example.com',
@@ -50,8 +49,6 @@ const internal = createClient<Ops>(OPERATIONS, {
50
49
  });
51
50
  ```
52
51
 
53
- With `runtime: 'package'` the generated client also imports its whole engine from this package (instead of embedding it), so engine fixes arrive via `npm update` — install this package as a regular dependency of the consuming app.
54
-
55
52
  ### Write a custom generator
56
53
 
57
54
  A custom generator reads the same API model the built-ins consume, runs in the same pass, and returns files.
@@ -65,7 +62,7 @@ import { tsType } from '@redocly/client-generator/generate';
65
62
  export default defineGenerator({
66
63
  name: 'response-map',
67
64
  requires: ['typescript'],
68
- run({ model, outputPath }) {
65
+ run({ model, output }) {
69
66
  const printer = new Printer();
70
67
  // One `ResponseShapes` entry per operation with a JSON success body.
71
68
  printer.block(
@@ -80,7 +77,7 @@ export default defineGenerator({
80
77
  },
81
78
  '};'
82
79
  );
83
- return [{ path: outputPath.replace(/\.ts$/, '.responses.ts'), content: printer.toString() }];
80
+ return [{ path: output.path.replace(/\.ts$/, '.responses.ts'), content: printer.toString() }];
84
81
  },
85
82
  });
86
83
  ```
@@ -116,7 +113,7 @@ type GenerateClientResult = {
116
113
  ### `collectGeneratedFiles`
117
114
 
118
115
  Runs the configured generators against a built model and returns the files in memory, without writing to disk.
119
- Imported from `@redocly/client-generator/generate` — the generation-time entry; the package root stays runtime-only so package-mode clients never load the generator stack:
116
+ Imported from `@redocly/client-generator/generate` — the generation-time entry; the package root stays a small authoring surface:
120
117
 
121
118
  ```ts
122
119
  function collectGeneratedFiles(
@@ -133,7 +130,7 @@ function collectGeneratedFiles(
133
130
 
134
131
  ### `defineGenerator`
135
132
 
136
- Authors a custom generator (`{ name, run }` plus optional `requires`/`errorModes`/`dateTypes`/`runtimes` compatibility metadata, validated up front):
133
+ Authors a custom generator (`{ name, run }` plus optional `requires`/`errorModes`/`dateTypes` compatibility metadata, validated up front):
137
134
 
138
135
  ```ts
139
136
  function defineGenerator(generator: CustomGenerator): CustomGenerator;
@@ -157,20 +154,9 @@ function defineClientSetup(setup: {
157
154
 
158
155
  A setup module may import only from `@redocly/client-generator`, so it never adds a dependency to the client (the import is stripped at generation time).
159
156
 
160
- ### `createClient`
161
-
162
- The runtime factory that `runtime: 'package'` clients import, also usable directly to build extra instances over generated descriptors (see [Basic usage](#build-extra-client-instances)):
163
-
164
- ```ts
165
- function createClient<Ops>(
166
- operations: Record<string, OperationDescriptor>,
167
- config?: ClientConfig
168
- ): Client<Ops>;
169
- ```
170
-
171
157
  ## Examples
172
158
 
173
- Runnable examples — from a zero-install quickstart to middleware, publisher setup, SSE streaming, pagination, custom generators, and the package runtime — live in [`tests/e2e/generate-client/examples`](https://github.com/Redocly/redocly-cli/tree/main/tests/e2e/generate-client/examples).
159
+ Runnable examples — from a zero-install quickstart to middleware, publisher setup, SSE streaming, pagination, and custom generators — live in [`tests/e2e/generate-client/examples`](https://github.com/Redocly/redocly-cli/tree/main/tests/e2e/generate-client/examples).
174
160
  Each is a standalone Vite app with a checked-in, drift-checked generated client.
175
161
 
176
162
  ## Documentation
@@ -191,4 +177,4 @@ npm run unit # unit tests (this package is held at 100% cover
191
177
  VITEST_SUITE=e2e npx vitest run tests/e2e/generate-client/ # behavioral e2e
192
178
  ```
193
179
 
194
- The client runtime lives in `src/runtime/` (real, unit-testable modules; package mode imports them, inline mode embeds them), the structural emitters in `src/emitters/`, the IR in `src/intermediate-representation/`, the generators in `src/generators/`, and the file-layout writers in `src/writers/`.
180
+ Each generator that embeds a runtime keeps its sources in its own folder (`src/generators/<name>/runtime/` — real, unit-testable modules that generation embeds), the IR lives in `src/intermediate-representation/`, and the generators in `src/generators/`.
@@ -15,8 +15,8 @@ client:
15
15
  /** @type {import('@redocly/client-generator').CustomGenerator} */
16
16
  export default {
17
17
  name: 'my-generator',
18
- run({ model, outputPath, outputMode, emit }) {
19
- return [{ path: outputPath.replace(/\.ts$/, '.mine.txt'), content: '…' }];
18
+ run({ model, output, outputMode, emit }) {
19
+ return [{ path: output.path.replace(/\.ts$/, '.mine.txt'), content: '…' }];
20
20
  },
21
21
  // Optional: one idiomatic call snippet per operation for docs (x-codeSamples),
22
22
  // collected into an overlay file when `client.codeSamples: true` is set.
@@ -26,8 +26,8 @@ export default {
26
26
  // Optional: the reference page for what `run` emits, written when `client.docs` (or
27
27
  // --docs) is on. Same `{ path, content }` shape as `run`; `renderReferencePage` gives
28
28
  // the standard layout and takes `sample` for its snippets. A generator documents itself.
29
- docs({ model, outputPath, emit }) {
30
- return [{ path: outputPath.replace(/\.ts$/, '.mine.md'), content: '…' }];
29
+ docs({ model, output, emit }) {
30
+ return [{ path: output.path.replace(/\.ts$/, '.mine.md'), content: '…' }];
31
31
  },
32
32
  };
33
33
  ```
@@ -45,9 +45,9 @@ export default {
45
45
  properties: { groupBy: { enum: ['tag', 'path'], default: 'tag' } },
46
46
  additionalProperties: false,
47
47
  },
48
- run({ model, outputPath, options }) {
48
+ run({ model, output, options }) {
49
49
  return [
50
- { path: outputPath.replace(/\.ts$/, '.permissions.md'), content: render(options.groupBy) },
50
+ { path: output.path.replace(/\.ts$/, '.permissions.md'), content: render(options.groupBy) },
51
51
  ];
52
52
  },
53
53
  };
@@ -91,22 +91,28 @@ discriminated union on `kind`: `scalar`, `array`, `object`, `record`, `ref`,
91
91
 
92
92
  ## Helpers (import from '@redocly/client-generator')
93
93
 
94
- | Helper | Use |
95
- | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
96
- | `flattenAllOf(schema, model)` | The merged property view of allOf compositions — languages without intersection types render this. |
97
- | `discriminatorCases(schema, model)` | `{ property, cases }` dispatch table for discriminated unions. |
98
- | `isNullable(schema)` / `unwrapNullable(schema)` | Detect and strip `null` union members (`Optional[T]`, pointers, `Option<T>`). |
99
- | `enumValues(schema)` | Values plus SCREAMING_SNAKE member-name suggestions. |
100
- | `headerCoerceType(schema, model)` | Response-header coerce hint (`integer`/`number`/`boolean`/`string`) through refs, nullables, and allOf wrappers. |
101
- | `casing` / `identifierFor(name, { style, reserved })` | camel/pascal/snake/screaming; keyword-safe identifiers (`RESERVED_WORDS.python/go/typescript` shipped). |
102
- | `uniqueIdentifiers(names, { style, reserved, taken })` | The same, made unique among themselves and among names you already took — for a signature that takes one argument per parameter. |
103
- | `Printer` | Indentation-aware text builder — no manual whitespace bookkeeping. |
104
- | `docText(description)` | Description as trimmed lines for any comment syntax. |
105
- | `schemaAtPointer(schema, pointer, model)` | Resolve an RFC 6901 JSON pointer over a schema (through refs and allOf) — e.g. a pagination `items` pointer to its element type. |
106
- | `paginationRuleFor(op, config)` | The pagination rule that applies to an operation (per-op config > extension > fitting convention), normalized. |
107
- | `renderReferencePage(model, options)` | The Markdown reference page a generator's `docs` hook returns — your `sample` hook supplies its call snippets. |
108
- | `NotSupportedError` | Throw it to reject an option the generator can't honor — the CLI prints the message as a user error, not a crash. |
109
- | `AUTHORING_HELPER_NAMES` | The list of the above (introspection). |
94
+ | Helper | Use |
95
+ | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
96
+ | `flattenAllOf(schema, model)` | The merged property view of allOf compositions — languages without intersection types render this. |
97
+ | `deref(schema, model)` | Follow a `ref` chain to the schema it names (cycle-guarded). |
98
+ | `jsonSuccessSchema(op)` / `sseResponse(op)` | The primary JSON success schema; the `text/event-stream` response when the operation streams. |
99
+ | `isMultipartBody(op)` | Whether the request body is multipart. |
100
+ | `serverUrlParts(server)` | A server-URL template as literal/variable parts, ready for any concatenation syntax. |
101
+ | `securityRequirements(op, model)` | The operation's security as OR-alternatives of AND-sets, denormalized against the declared schemes. |
102
+ | `paginationItemSchema(pageSchema, itemsPointer, model)` | The raw element schema behind a pagination rule's `items` pointer — a `ref` element keeps its name. |
103
+ | `discriminatorCases(schema, model)` | `{ property, cases }` dispatch table for discriminated unions. |
104
+ | `isNullable(schema)` / `unwrapNullable(schema)` | Detect and strip `null` union members (`Optional[T]`, pointers, `Option<T>`). |
105
+ | `enumValues(schema)` | Values plus SCREAMING_SNAKE member-name suggestions. |
106
+ | `headerCoerceType(schema, model)` | Response-header coerce hint (`integer`/`number`/`boolean`/`string`) through refs, nullables, and allOf wrappers. |
107
+ | `casing` / `identifierFor(name, { style, reserved })` | camel/pascal/snake/screaming; keyword-safe identifiers (`RESERVED_WORDS.python/go/typescript` shipped). |
108
+ | `uniqueIdentifiers(names, { style, reserved, taken })` | The same, made unique among themselves and among names you already took — for a signature that takes one argument per parameter. |
109
+ | `Printer` | Indentation-aware text builder — no manual whitespace bookkeeping. |
110
+ | `docText(description)` | Description as trimmed lines for any comment syntax. |
111
+ | `schemaAtPointer(schema, pointer, model)` | Resolve an RFC 6901 JSON pointer over a schema (through refs and allOf) — e.g. a pagination `items` pointer to its element type. |
112
+ | `paginationRuleFor(op, config)` | The pagination rule that applies to an operation (per-op config > extension > fitting convention), normalized. |
113
+ | `renderReferencePage(model, options)` | The Markdown reference page a generator's `docs` hook returns — your `sample` hook supplies its call snippets. |
114
+ | `NotSupportedError` | Throw it to reject an option the generator can't honor — the CLI prints the message as a user error, not a crash. |
115
+ | `AUTHORING_HELPER_NAMES` | The list of the above (introspection). |
110
116
 
111
117
  Worked example: the built-in `python` generator
112
118
  (`packages/client-generator/src/generators/python/index.ts` in the Redocly CLI repo) is
@@ -0,0 +1,224 @@
1
+ // Ejected from @redocly/client-generator@0.0.0-snapshot.1787656839 — the built-in "cli" generator.
2
+ // This file is yours: edit freely; the generated client stays machine-owned and is
3
+ // rebuilt by `redocly generate-client`. Newer generator versions merge in with
4
+ // `redocly eject-generator cli --update`.
5
+ // The cli-docs emitter: renders the Markdown reference for the generated CLI from the
6
+ // SAME command table `runCli` dispatches on, and the same `groupSlug`/`constantCase` the
7
+ // runtime addresses groups and reads credentials with. A second model would drift from
8
+ // the tool the first time either side changed.
9
+
10
+ import {
11
+ type CliCommand,
12
+ type CliFlag,
13
+ constantCase,
14
+ groupSlug,
15
+ Printer,
16
+ } from '@redocly/client-generator';
17
+
18
+ export type CliDocsOptions = {
19
+ /** Page heading. */
20
+ title: string;
21
+ /** Emit YAML front matter carrying the title, for docs sites that expect it. */
22
+ frontmatter: boolean;
23
+ /** The generated file's stem: what the page calls the command, and what its credential
24
+ * variables derive from. A reader who installs it under another bin name renames only
25
+ * the command — the variables are fixed at generation. */
26
+ name: string;
27
+ /** Auth schemes the description declares, in the order the CLI resolves them. */
28
+ schemes: Array<{ key: string; kind: 'bearer' | 'basic' | 'apiKey' }>;
29
+ };
30
+
31
+ /** Table-cell-safe text: one line, and pipes/backslashes escaped so they don't alter columns/escaping. */
32
+ function cell(text: string | undefined): string {
33
+ return (text ?? '').replace(/\s+/g, ' ').trim().replace(/\\/g, '\\\\').replace(/\|/g, '\\|');
34
+ }
35
+
36
+ /** How a command is typed at the prompt: `<group-slug> <name>`, or just `<name>`. */
37
+ function address(command: CliCommand): string {
38
+ return [command.group === undefined ? undefined : groupSlug(command.group), command.name]
39
+ .filter(Boolean)
40
+ .join(' ');
41
+ }
42
+
43
+ function usageLine(name: string, command: CliCommand): string {
44
+ const words = [
45
+ name,
46
+ address(command),
47
+ ...command.positionals.map((positional) => `<${positional.name}>`),
48
+ ...command.flags.filter((flag) => flag.required).map((flag) => `--${flag.name} <${flag.type}>`),
49
+ ...(command.body ? [command.body.required ? "--json '<json>'" : "[--json '<json>']"] : []),
50
+ ];
51
+ return words.filter((word) => word !== '').join(' ');
52
+ }
53
+
54
+ function writeFlagTable(printer: Printer, flags: CliFlag[]): void {
55
+ printer.line('| Flag | Type | Required | Description |');
56
+ printer.line('| ---- | ---- | -------- | ----------- |');
57
+ for (const flag of flags) {
58
+ const description = [
59
+ cell(flag.description),
60
+ flag.enum === undefined
61
+ ? ''
62
+ : `One of ${flag.enum.map((value) => `\`${value}\``).join(', ')}.`,
63
+ flag.type === 'array' ? 'Repeat the flag for multiple values.' : '',
64
+ ]
65
+ .filter((part) => part !== '')
66
+ .join(' ');
67
+ printer.line(
68
+ `| \`--${flag.name}\` | ${flag.type} | ${flag.required ? 'yes' : 'no'} | ${description} |`
69
+ );
70
+ }
71
+ printer.blank();
72
+ }
73
+
74
+ function writeCommand(printer: Printer, command: CliCommand, options: CliDocsOptions): void {
75
+ printer.line(`### \`${address(command)}\``);
76
+ printer.blank();
77
+ if (command.summary !== undefined) {
78
+ printer.line(cell(command.summary));
79
+ printer.blank();
80
+ }
81
+ printer.line(`\`${command.method} ${command.path}\``);
82
+ printer.blank();
83
+ printer.line('```sh');
84
+ printer.line(usageLine(options.name, command));
85
+ printer.line('```');
86
+ printer.blank();
87
+ if (command.positionals.length > 0) {
88
+ printer.line('| Argument | Description |');
89
+ printer.line('| -------- | ----------- |');
90
+ for (const positional of command.positionals) {
91
+ printer.line(`| \`<${positional.name}>\` | ${cell(positional.description)} |`);
92
+ }
93
+ printer.blank();
94
+ }
95
+ if (command.flags.length > 0) writeFlagTable(printer, command.flags);
96
+ const notes = [
97
+ command.body === undefined
98
+ ? ''
99
+ : `Takes a JSON body${command.body.required ? ' (required)' : ''}: \`--json '<json>'\`, \`--json @file.json\`, or \`--json @-\` for stdin.`,
100
+ command.unsupportedBody === undefined
101
+ ? ''
102
+ : `Takes a \`${command.unsupportedBody}\` body, which the CLI cannot build — call this operation through the generated client instead.`,
103
+ command.paginated === true
104
+ ? 'Paginated: `--page-all` follows every page, printing one JSON page per line.'
105
+ : '',
106
+ command.sse === true ? 'Streams server-sent events as one JSON object per line.' : '',
107
+ command.blob === true ? 'Returns binary content, so `--output <path>` is required.' : '',
108
+ ].filter((note) => note !== '');
109
+ for (const note of notes) printer.line(note);
110
+ if (notes.length > 0) printer.blank();
111
+ }
112
+
113
+ /** The whole page: heading, global flags, credentials, exit codes, then every command. */
114
+ export function renderCliDocs(commands: CliCommand[], options: CliDocsOptions): string {
115
+ const printer = new Printer();
116
+ if (options.frontmatter) {
117
+ printer.line('---');
118
+ printer.line(`title: ${options.title}`);
119
+ printer.line('---');
120
+ printer.blank();
121
+ }
122
+ printer.line(`# ${options.title}`);
123
+ printer.blank();
124
+ printer.line(
125
+ `Generated command-line reference for \`${options.name}\`, produced from the API description by \`redocly generate-client\`.`
126
+ );
127
+ printer.line('Re-run generation to update it — this file is not hand-edited.');
128
+ printer.blank();
129
+
130
+ printer.line('## Usage');
131
+ printer.blank();
132
+ printer.line('```sh');
133
+ printer.line(`${options.name} <command> [flags]`);
134
+ printer.line(`${options.name} --help`);
135
+ printer.line(`${options.name} schema <command> # request/response schemas`);
136
+ printer.line('```');
137
+ printer.blank();
138
+ printer.line(
139
+ 'Install the file under any `bin` name: the command takes that name, and the credential variables below do not change.'
140
+ );
141
+ printer.blank();
142
+
143
+ printer.line('## Global flags');
144
+ printer.blank();
145
+ printer.line('| Flag | Description |');
146
+ printer.line('| ---- | ----------- |');
147
+ // `--token` mirrors the CLI itself: without a bearer scheme the tool rejects the flag,
148
+ // so the reference must not list it.
149
+ const hasBearer = options.schemes.some((scheme) => scheme.kind === 'bearer');
150
+ for (const [flag, description] of [
151
+ ['--server-url <url>', 'Override the server URL included in the client.'],
152
+ ['--format <json\\|ndjson>', 'Output format.'],
153
+ ['--dry-run', 'Print the prepared request, credentials redacted, without sending it.'],
154
+ ['--page-all', 'Follow pagination, printing one JSON page per line.'],
155
+ ['--output <path>', 'Write the response body to a file. Required for binary responses.'],
156
+ ...(hasBearer ? [['--token <token>', 'Bearer token, overriding the environment.']] : []),
157
+ ['--json <json\\|@file\\|@->', 'Request body, inline or from a file or stdin.'],
158
+ ] as const) {
159
+ printer.line(`| \`${flag}\` | ${description} |`);
160
+ }
161
+ printer.blank();
162
+
163
+ const prefix = constantCase(options.name);
164
+ printer.line('## Credentials');
165
+ printer.blank();
166
+ if (options.schemes.length === 0) {
167
+ printer.line('The description declares no security schemes, so no credentials are read.');
168
+ } else {
169
+ printer.line('Credentials come from the environment:');
170
+ printer.blank();
171
+ printer.line('| Scheme | Variable |');
172
+ printer.line('| ------ | -------- |');
173
+ for (const scheme of options.schemes) {
174
+ const variable =
175
+ scheme.kind === 'bearer'
176
+ ? `\`${prefix}_TOKEN\` (or \`--token\`)`
177
+ : scheme.kind === 'basic'
178
+ ? `\`${prefix}_USERNAME\` and \`${prefix}_PASSWORD\``
179
+ : `\`${prefix}_API_KEY_${constantCase(scheme.key)}\``;
180
+ printer.line(`| ${scheme.kind} (\`${scheme.key}\`) | ${variable} |`);
181
+ }
182
+ }
183
+ printer.blank();
184
+
185
+ printer.line('## Exit codes');
186
+ printer.blank();
187
+ printer.line('| Code | Meaning |');
188
+ printer.line('| ---- | ------- |');
189
+ for (const [code, meaning] of [
190
+ [0, 'success'],
191
+ [1, 'API error (status other than 401 or 403)'],
192
+ [2, 'auth error (401 or 403)'],
193
+ [3, 'validation error'],
194
+ [4, 'usage error (unknown command or flag, bad `--json`)'],
195
+ ] as const) {
196
+ printer.line(`| ${code} | ${meaning} |`);
197
+ }
198
+ printer.blank();
199
+ printer.line('Errors print one JSON object to stderr, so stdout stays clean for piping.');
200
+ printer.blank();
201
+
202
+ // One section per tag, in the order the description declares them, then the untagged
203
+ // commands — the same order `--help` lists them in.
204
+ const groups = [...new Set(commands.map((command) => command.group))];
205
+ for (const group of groups) {
206
+ const inGroup = commands.filter((command) => command.group === group);
207
+ if (group === undefined) {
208
+ printer.line('## Commands');
209
+ printer.blank();
210
+ } else {
211
+ printer.line(`## ${group}`);
212
+ printer.blank();
213
+ printer.line(`Addressed as \`${options.name} ${groupSlug(group)} <command>\`.`);
214
+ printer.blank();
215
+ }
216
+ for (const command of inGroup) writeCommand(printer, command, options);
217
+ }
218
+ return (
219
+ printer
220
+ .toString()
221
+ .replace(/\n{3,}/g, '\n\n')
222
+ .trimEnd() + '\n'
223
+ );
224
+ }
@@ -0,0 +1,21 @@
1
+ // Ejected from @redocly/client-generator@0.0.0-snapshot.1787656839 — the built-in "cli" generator.
2
+ // This file is yours: edit freely; the generated client stays machine-owned and is
3
+ // rebuilt by `redocly generate-client`. Newer generator versions merge in with
4
+ // `redocly eject-generator cli --update`.
5
+ // The cli engine's embeddable source, snapshotted at prepare time (see
6
+ // scripts/generate-runtime-sources.mjs).
7
+
8
+ import {
9
+ RUNTIME_SOURCES,
10
+ RUNTIME_SOURCES_STRIPPED,
11
+ } from '@redocly/client-generator/runtime-sources';
12
+
13
+ /** The cli engine (`runCli` + types) stripped for embedding into `<stem>.cli.ts`. */
14
+ export function embedCliRuntime(): string {
15
+ return RUNTIME_SOURCES_STRIPPED['cli.ts'];
16
+ }
17
+
18
+ /** The cli engine RAW, for `runtime: 'module'` (written as `runtime/cli.ts`). */
19
+ export function cliRuntimeSource(): string {
20
+ return RUNTIME_SOURCES['cli.ts'];
21
+ }
@@ -0,0 +1,90 @@
1
+ // Ejected from @redocly/client-generator@0.0.0-snapshot.1787656839 — the built-in "cli" generator.
2
+ // This file is yours: edit freely; the generated client stays machine-owned and is
3
+ // rebuilt by `redocly generate-client`. Newer generator versions merge in with
4
+ // `redocly eject-generator cli --update`.
5
+ import {
6
+ type CodeSample,
7
+ type Generator,
8
+ groupSlug,
9
+ type OperationModel,
10
+ type SampleContext,
11
+ } from '@redocly/client-generator';
12
+ import { join } from 'node:path';
13
+
14
+ import { renderCliDocs } from './docs.ts';
15
+ import { cliRuntimeSource } from './engine-source.ts';
16
+ import { cliAuthSchemes, commandData, renderCliModule } from './render.ts';
17
+
18
+ /**
19
+ * The cli generator: a bin-ready `<stem>.cli.ts` — a zero-dependency, typed
20
+ * command-line interface over the sibling client (typed flags, `--json`
21
+ * bodies, env auth, `--page-all`, SSE/blob output, a documented exit-code
22
+ * contract). Requires `typescript` (throw mode); wires zod validation when co-selected.
23
+ */
24
+ export const cliGenerator: Generator = ({ model, output, banner, emit, selected, pagination }) => {
25
+ const content = renderCliModule(model, {
26
+ stem: output.stem,
27
+ importExt: emit.importExt ?? 'js',
28
+ zodSelected: selected?.includes('zod') ?? false,
29
+ pagination,
30
+ argsStyle: emit.argsStyle ?? 'grouped',
31
+ runtime: emit.runtime ?? 'inline',
32
+ });
33
+ const entry = { path: join(output.dir, `${output.stem}.cli.ts`), content };
34
+ if (emit.runtime !== 'module') return [entry];
35
+ const header = banner.map((line) => `// ${line}`).join('\n');
36
+ return [
37
+ entry,
38
+ {
39
+ path: join(output.dir, 'runtime', 'cli.ts'),
40
+ content: `${header}\n\n${cliRuntimeSource().trim()}\n`,
41
+ },
42
+ ];
43
+ };
44
+
45
+ /**
46
+ * The CLI's own reference page, written when `client.docs` is on: the usage line, the
47
+ * global flags, the credential variables, the exit codes, and one section per command.
48
+ * It renders from `commandData` — the same table `runCli` dispatches on — so the page
49
+ * cannot describe a tool other than the one beside it.
50
+ */
51
+ export const cliDocs: Generator = ({ model, output, emit, pagination }) => {
52
+ const content = renderCliDocs(commandData(model, { pagination }), {
53
+ title: `${model.title} command-line reference`,
54
+ frontmatter: emit.docsFrontmatter === true,
55
+ name: output.stem,
56
+ schemes: cliAuthSchemes(model),
57
+ });
58
+ return [{ path: join(output.dir, `${output.stem}.cli.md`), content }];
59
+ };
60
+
61
+ /** One shell invocation per operation — feeds `x-codeSamples` for docs. */
62
+ export function cliSample(op: OperationModel, ctx: SampleContext): CodeSample | undefined {
63
+ const command = commandData(ctx.model, { pagination: ctx.pagination }).find(
64
+ (candidate) => candidate.name === op.name
65
+ );
66
+ if (command === undefined) return undefined;
67
+ const words = [
68
+ 'client',
69
+ ...(command.group ? [groupSlug(command.group)] : []),
70
+ command.name,
71
+ ...command.positionals.map((positional) => `<${positional.name}>`),
72
+ ...command.flags.filter((flag) => flag.required).map((flag) => `--${flag.name} <${flag.type}>`),
73
+ ...(command.body ? ["--json '<json>'"] : []),
74
+ ];
75
+ return {
76
+ lang: 'shell',
77
+ label: 'CLI',
78
+ source: `npx tsx client.cli.ts ${words.slice(1).join(' ')}\n`,
79
+ };
80
+ }
81
+
82
+ export default {
83
+ name: 'cli',
84
+ run: cliGenerator,
85
+ sample: cliSample,
86
+ docs: cliDocs,
87
+ requires: ["typescript","zod"],
88
+ errorModes: ["throw"],
89
+ requiresGenerator: '^0.0.0-snapshot.1787656839',
90
+ };