@geekmidas/cli 10.0.0-alpha.19 → 10.0.0-alpha.190

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 (436) hide show
  1. package/README.md +323 -380
  2. package/bin/adjacent-tsconfig.mjs +46 -8
  3. package/bin/gkm.mjs +11 -3
  4. package/bin/owning-tsconfig-jsx-register.mjs +18 -0
  5. package/bin/owning-tsconfig-jsx.mjs +108 -0
  6. package/dist/EndpointGenerator-CBKH87_b.mjs +1043 -0
  7. package/dist/EndpointGenerator-CBKH87_b.mjs.map +1 -0
  8. package/dist/EndpointGenerator-iyA3HkOH.cjs +1102 -0
  9. package/dist/EndpointGenerator-iyA3HkOH.cjs.map +1 -0
  10. package/dist/LegacyStateStore-CWiswz6T.mjs +124 -0
  11. package/dist/LegacyStateStore-CWiswz6T.mjs.map +1 -0
  12. package/dist/LegacyStateStore-CuSe37fl.cjs +124 -0
  13. package/dist/LegacyStateStore-CuSe37fl.cjs.map +1 -0
  14. package/dist/LocalStateStore-BciJ_DF0.cjs +178 -0
  15. package/dist/LocalStateStore-BciJ_DF0.cjs.map +1 -0
  16. package/dist/LocalStateStore-CLHasLJI.mjs +167 -0
  17. package/dist/LocalStateStore-CLHasLJI.mjs.map +1 -0
  18. package/dist/OpenApiTsGenerator-CoVA3Ykv.mjs +534 -0
  19. package/dist/OpenApiTsGenerator-CoVA3Ykv.mjs.map +1 -0
  20. package/dist/OpenApiTsGenerator-vy-fOJgs.cjs +539 -0
  21. package/dist/OpenApiTsGenerator-vy-fOJgs.cjs.map +1 -0
  22. package/dist/S3StateStore-BHLRjoj3.cjs +222 -0
  23. package/dist/S3StateStore-BHLRjoj3.cjs.map +1 -0
  24. package/dist/S3StateStore-CTiv2_ON.mjs +223 -0
  25. package/dist/S3StateStore-CTiv2_ON.mjs.map +1 -0
  26. package/dist/SSMStateStore-BqT3MXXb.cjs +204 -0
  27. package/dist/SSMStateStore-BqT3MXXb.cjs.map +1 -0
  28. package/dist/SSMStateStore-D6qqaem2.mjs +205 -0
  29. package/dist/SSMStateStore-D6qqaem2.mjs.map +1 -0
  30. package/dist/SubscriberGenerator-Cfoz8uTY.mjs +787 -0
  31. package/dist/SubscriberGenerator-Cfoz8uTY.mjs.map +1 -0
  32. package/dist/SubscriberGenerator-CxzECrfj.cjs +852 -0
  33. package/dist/SubscriberGenerator-CxzECrfj.cjs.map +1 -0
  34. package/dist/add-B2OmIQzs.cjs +712 -0
  35. package/dist/add-B2OmIQzs.cjs.map +1 -0
  36. package/dist/add-CXwL549o.mjs +710 -0
  37. package/dist/add-CXwL549o.mjs.map +1 -0
  38. package/dist/appPorts-BoXMwolc.mjs +249 -0
  39. package/dist/appPorts-BoXMwolc.mjs.map +1 -0
  40. package/dist/appPorts-IW-OZmRi.cjs +296 -0
  41. package/dist/appPorts-IW-OZmRi.cjs.map +1 -0
  42. package/dist/aws-BXfiWNbi.cjs +108 -0
  43. package/dist/aws-BXfiWNbi.cjs.map +1 -0
  44. package/dist/aws-BjvSTTcE.mjs +97 -0
  45. package/dist/aws-BjvSTTcE.mjs.map +1 -0
  46. package/dist/awsStore-BYYCmXiq.mjs +121 -0
  47. package/dist/awsStore-BYYCmXiq.mjs.map +1 -0
  48. package/dist/awsStore-DKQUElJL.cjs +138 -0
  49. package/dist/awsStore-DKQUElJL.cjs.map +1 -0
  50. package/dist/{backup-provisioner-DIVCbfee.mjs → backup-provisioner-C8DnCmxK.mjs} +2 -2
  51. package/dist/backup-provisioner-C8DnCmxK.mjs.map +1 -0
  52. package/dist/{backup-provisioner-BmhIO_Yr.cjs → backup-provisioner-oDEsPj02.cjs} +2 -2
  53. package/dist/backup-provisioner-oDEsPj02.cjs.map +1 -0
  54. package/dist/backups/runner.cjs +1007 -0
  55. package/dist/backups/runner.cjs.map +1 -0
  56. package/dist/backups/runner.d.cts +187 -0
  57. package/dist/backups/runner.d.cts.map +1 -0
  58. package/dist/backups/runner.d.mts +187 -0
  59. package/dist/backups/runner.d.mts.map +1 -0
  60. package/dist/backups/runner.mjs +984 -0
  61. package/dist/backups/runner.mjs.map +1 -0
  62. package/dist/{bundler-mwH7WOb1.mjs → bundler-CHXyJFsS.mjs} +68 -15
  63. package/dist/bundler-CHXyJFsS.mjs.map +1 -0
  64. package/dist/{bundler-mjqGAvu1.cjs → bundler-CLoVtcBi.cjs} +67 -14
  65. package/dist/bundler-CLoVtcBi.cjs.map +1 -0
  66. package/dist/cli-Bjua3PaZ.mjs +80 -0
  67. package/dist/cli-Bjua3PaZ.mjs.map +1 -0
  68. package/dist/cli-DiuUr1Am.cjs +80 -0
  69. package/dist/cli-DiuUr1Am.cjs.map +1 -0
  70. package/dist/clientTelemetry-DXuYNH-J.d.cts +10 -0
  71. package/dist/clientTelemetry-DXuYNH-J.d.cts.map +1 -0
  72. package/dist/clientTelemetry-eC8VQ6nB.d.mts +10 -0
  73. package/dist/clientTelemetry-eC8VQ6nB.d.mts.map +1 -0
  74. package/dist/compose-DUOETDhc.mjs +2855 -0
  75. package/dist/compose-DUOETDhc.mjs.map +1 -0
  76. package/dist/compose-gnNrY3NQ.cjs +2939 -0
  77. package/dist/compose-gnNrY3NQ.cjs.map +1 -0
  78. package/dist/config-1zirYXeO.d.mts +300 -0
  79. package/dist/config-1zirYXeO.d.mts.map +1 -0
  80. package/dist/config-rSlB-bXj.d.cts +300 -0
  81. package/dist/config-rSlB-bXj.d.cts.map +1 -0
  82. package/dist/config.cjs +462 -9
  83. package/dist/config.cjs.map +1 -0
  84. package/dist/config.d.cts +4 -117
  85. package/dist/config.d.mts +4 -117
  86. package/dist/config.mjs +446 -3
  87. package/dist/config.mjs.map +1 -0
  88. package/dist/credentialSchemas-D_85KW2k.mjs +236 -0
  89. package/dist/credentialSchemas-D_85KW2k.mjs.map +1 -0
  90. package/dist/credentialSchemas-DjK6xKMk.cjs +271 -0
  91. package/dist/credentialSchemas-DjK6xKMk.cjs.map +1 -0
  92. package/dist/credentials-BI52H1ad.cjs +2911 -0
  93. package/dist/credentials-BI52H1ad.cjs.map +1 -0
  94. package/dist/credentials-Cp09PIsc.cjs +1451 -0
  95. package/dist/credentials-Cp09PIsc.cjs.map +1 -0
  96. package/dist/credentials-DbjLhvix.mjs +1140 -0
  97. package/dist/credentials-DbjLhvix.mjs.map +1 -0
  98. package/dist/credentials-VLP_959f.mjs +2390 -0
  99. package/dist/credentials-VLP_959f.mjs.map +1 -0
  100. package/dist/databases-CV22HzrI.mjs +588 -0
  101. package/dist/databases-CV22HzrI.mjs.map +1 -0
  102. package/dist/databases-DwYYH2mX.cjs +703 -0
  103. package/dist/databases-DwYYH2mX.cjs.map +1 -0
  104. package/dist/dbTunnel-CLsqWr7o.mjs +153 -0
  105. package/dist/dbTunnel-CLsqWr7o.mjs.map +1 -0
  106. package/dist/dbTunnel-DQcdaaLi.cjs +153 -0
  107. package/dist/dbTunnel-DQcdaaLi.cjs.map +1 -0
  108. package/dist/define-BfrNaY82.mjs +106 -0
  109. package/dist/define-BfrNaY82.mjs.map +1 -0
  110. package/dist/define-zKgLY65H.cjs +153 -0
  111. package/dist/define-zKgLY65H.cjs.map +1 -0
  112. package/dist/deploy/public.cjs +210 -0
  113. package/dist/deploy/public.cjs.map +1 -0
  114. package/dist/deploy/public.d.cts +659 -0
  115. package/dist/deploy/public.d.cts.map +1 -0
  116. package/dist/deploy/public.d.mts +659 -0
  117. package/dist/deploy/public.d.mts.map +1 -0
  118. package/dist/deploy/public.mjs +143 -0
  119. package/dist/deploy/public.mjs.map +1 -0
  120. package/dist/deploy/sniffer-envparser-worker.cjs +54 -0
  121. package/dist/deploy/sniffer-envparser-worker.cjs.map +1 -0
  122. package/dist/deploy/sniffer-envparser-worker.d.cts +1 -0
  123. package/dist/deploy/sniffer-envparser-worker.d.mts +1 -0
  124. package/dist/deploy/sniffer-envparser-worker.mjs +55 -0
  125. package/dist/deploy/sniffer-envparser-worker.mjs.map +1 -0
  126. package/dist/deploy/sniffer-hooks.cjs +1 -1
  127. package/dist/deploy/sniffer-hooks.mjs +1 -1
  128. package/dist/deploy/sniffer-loader.cjs +2 -2
  129. package/dist/deploy/sniffer-loader.mjs +1 -1
  130. package/dist/deploy/sniffer-routes-worker.cjs +2 -2
  131. package/dist/deploy/sniffer-routes-worker.mjs +1 -1
  132. package/dist/deploy-DhIy2Ftj.mjs +3854 -0
  133. package/dist/deploy-DhIy2Ftj.mjs.map +1 -0
  134. package/dist/deploy-DpQ_4Pu1.cjs +3910 -0
  135. package/dist/deploy-DpQ_4Pu1.cjs.map +1 -0
  136. package/dist/destroy-DmTDT6V7.cjs +791 -0
  137. package/dist/destroy-DmTDT6V7.cjs.map +1 -0
  138. package/dist/destroy-wV9yNLQV.mjs +790 -0
  139. package/dist/destroy-wV9yNLQV.mjs.map +1 -0
  140. package/dist/discover-Dfmn6HQ7.mjs +940 -0
  141. package/dist/discover-Dfmn6HQ7.mjs.map +1 -0
  142. package/dist/discover-OXczlq08.cjs +1085 -0
  143. package/dist/discover-OXczlq08.cjs.map +1 -0
  144. package/dist/dokploy-B61ww4Yb.cjs +38 -0
  145. package/dist/dokploy-B61ww4Yb.cjs.map +1 -0
  146. package/dist/dokploy-Jhl3sPd4.mjs +38 -0
  147. package/dist/dokploy-Jhl3sPd4.mjs.map +1 -0
  148. package/dist/drivers-BQRb3KsL.mjs +294 -0
  149. package/dist/drivers-BQRb3KsL.mjs.map +1 -0
  150. package/dist/drivers-DP7__dJX.cjs +377 -0
  151. package/dist/drivers-DP7__dJX.cjs.map +1 -0
  152. package/dist/eas-BmvO40xS.mjs +334 -0
  153. package/dist/eas-BmvO40xS.mjs.map +1 -0
  154. package/dist/eas-X09Gz8_E.cjs +337 -0
  155. package/dist/eas-X09Gz8_E.cjs.map +1 -0
  156. package/dist/emit-C4KSXOeS.mjs +153 -0
  157. package/dist/emit-C4KSXOeS.mjs.map +1 -0
  158. package/dist/emit-DiW0kbue.cjs +164 -0
  159. package/dist/emit-DiW0kbue.cjs.map +1 -0
  160. package/dist/encryption-BBIUewnL.cjs +90 -0
  161. package/dist/encryption-BBIUewnL.cjs.map +1 -0
  162. package/dist/encryption-BOmswIgE.mjs +89 -0
  163. package/dist/encryption-BOmswIgE.mjs.map +1 -0
  164. package/dist/engine-BhjhShKf.cjs +3333 -0
  165. package/dist/engine-BhjhShKf.cjs.map +1 -0
  166. package/dist/engine-DW2H3KNa.mjs +3220 -0
  167. package/dist/engine-DW2H3KNa.mjs.map +1 -0
  168. package/dist/errors-C9uIyIDt.mjs +27 -0
  169. package/dist/errors-C9uIyIDt.mjs.map +1 -0
  170. package/dist/errors-D1x8duqI.cjs +38 -0
  171. package/dist/errors-D1x8duqI.cjs.map +1 -0
  172. package/dist/github-Ptbigbrq.mjs +986 -0
  173. package/dist/github-Ptbigbrq.mjs.map +1 -0
  174. package/dist/github-xUtu4Ur7.cjs +987 -0
  175. package/dist/github-xUtu4Ur7.cjs.map +1 -0
  176. package/dist/googlePlay-B4xhz5xT.cjs +931 -0
  177. package/dist/googlePlay-B4xhz5xT.cjs.map +1 -0
  178. package/dist/googlePlay-C9rrwN5b.mjs +931 -0
  179. package/dist/googlePlay-C9rrwN5b.mjs.map +1 -0
  180. package/dist/iam-D7mXd6by.cjs +521 -0
  181. package/dist/iam-D7mXd6by.cjs.map +1 -0
  182. package/dist/iam-DNlbVN_l.mjs +442 -0
  183. package/dist/iam-DNlbVN_l.mjs.map +1 -0
  184. package/dist/{index-RCUizGxL.d.cts → index-B1gfXH5K.d.mts} +38 -14
  185. package/dist/index-B1gfXH5K.d.mts.map +1 -0
  186. package/dist/{index-B4H4XF7A.d.mts → index-CunkOPOu.d.cts} +38 -14
  187. package/dist/index-CunkOPOu.d.cts.map +1 -0
  188. package/dist/index.cjs +15566 -13457
  189. package/dist/index.cjs.map +1 -1
  190. package/dist/index.mjs +15249 -13138
  191. package/dist/index.mjs.map +1 -1
  192. package/dist/local-CvC-z86k.mjs +224 -0
  193. package/dist/local-CvC-z86k.mjs.map +1 -0
  194. package/dist/local-DAJrhvSC.cjs +241 -0
  195. package/dist/local-DAJrhvSC.cjs.map +1 -0
  196. package/dist/migrate-0-A4BOcd.cjs +272 -0
  197. package/dist/migrate-0-A4BOcd.cjs.map +1 -0
  198. package/dist/migrate-C_36JSwV.mjs +181 -0
  199. package/dist/migrate-C_36JSwV.mjs.map +1 -0
  200. package/dist/migrate-DHbXzZIJ.mjs +267 -0
  201. package/dist/migrate-DHbXzZIJ.mjs.map +1 -0
  202. package/dist/migrate-fGWfv2DV.cjs +181 -0
  203. package/dist/migrate-fGWfv2DV.cjs.map +1 -0
  204. package/dist/next.cjs +59 -0
  205. package/dist/next.cjs.map +1 -0
  206. package/dist/next.d.cts +44 -0
  207. package/dist/next.d.cts.map +1 -0
  208. package/dist/next.d.mts +44 -0
  209. package/dist/next.d.mts.map +1 -0
  210. package/dist/next.mjs +58 -0
  211. package/dist/next.mjs.map +1 -0
  212. package/dist/openapi.cjs +213 -7
  213. package/dist/openapi.cjs.map +1 -0
  214. package/dist/openapi.d.cts +27 -8
  215. package/dist/openapi.d.cts.map +1 -1
  216. package/dist/openapi.d.mts +27 -8
  217. package/dist/openapi.d.mts.map +1 -1
  218. package/dist/openapi.mjs +208 -2
  219. package/dist/openapi.mjs.map +1 -0
  220. package/dist/projectBucket-BAoFOQtA.cjs +263 -0
  221. package/dist/projectBucket-BAoFOQtA.cjs.map +1 -0
  222. package/dist/projectBucket-Dxub09V1.mjs +222 -0
  223. package/dist/projectBucket-Dxub09V1.mjs.map +1 -0
  224. package/dist/provider-BvjDbsTR.mjs +46 -0
  225. package/dist/provider-BvjDbsTR.mjs.map +1 -0
  226. package/dist/provider-DLhgo-mB.cjs +57 -0
  227. package/dist/provider-DLhgo-mB.cjs.map +1 -0
  228. package/dist/publish-BX8_zXaf.cjs +124 -0
  229. package/dist/publish-BX8_zXaf.cjs.map +1 -0
  230. package/dist/publish-DE_yBzlz.mjs +123 -0
  231. package/dist/publish-DE_yBzlz.mjs.map +1 -0
  232. package/dist/ready-DCvnFZnJ.cjs +404 -0
  233. package/dist/ready-DCvnFZnJ.cjs.map +1 -0
  234. package/dist/ready-sSPuiZ7N.mjs +375 -0
  235. package/dist/ready-sSPuiZ7N.mjs.map +1 -0
  236. package/dist/reconcile/public.cjs +3 -5
  237. package/dist/reconcile/public.d.cts +33 -89
  238. package/dist/reconcile/public.d.cts.map +1 -1
  239. package/dist/reconcile/public.d.mts +33 -89
  240. package/dist/reconcile/public.d.mts.map +1 -1
  241. package/dist/reconcile/public.mjs +3 -3
  242. package/dist/reconcile--I7V4Klj.mjs +34 -0
  243. package/dist/reconcile--I7V4Klj.mjs.map +1 -0
  244. package/dist/reconcile-CuCQBa5-.cjs +34 -0
  245. package/dist/reconcile-CuCQBa5-.cjs.map +1 -0
  246. package/dist/resolve-CPB2jkB4.cjs +316 -0
  247. package/dist/resolve-CPB2jkB4.cjs.map +1 -0
  248. package/dist/resolve-DCPtP7-X.mjs +263 -0
  249. package/dist/resolve-DCPtP7-X.mjs.map +1 -0
  250. package/dist/rollback-sefKrjlE.mjs +137 -0
  251. package/dist/rollback-sefKrjlE.mjs.map +1 -0
  252. package/dist/rollback-ygh2qRWo.cjs +166 -0
  253. package/dist/rollback-ygh2qRWo.cjs.map +1 -0
  254. package/dist/runtime-BwiWhqkI.d.cts +82 -0
  255. package/dist/runtime-BwiWhqkI.d.cts.map +1 -0
  256. package/dist/runtime-Dx5F8-IL.d.mts +82 -0
  257. package/dist/runtime-Dx5F8-IL.d.mts.map +1 -0
  258. package/dist/s3-Bcvbg8io.cjs +240 -0
  259. package/dist/s3-Bcvbg8io.cjs.map +1 -0
  260. package/dist/s3-DK1ofU4f.mjs +240 -0
  261. package/dist/s3-DK1ofU4f.mjs.map +1 -0
  262. package/dist/sandbox/config-worker.cjs +43 -0
  263. package/dist/sandbox/config-worker.cjs.map +1 -0
  264. package/dist/sandbox/config-worker.d.cts +1 -0
  265. package/dist/sandbox/config-worker.d.mts +1 -0
  266. package/dist/sandbox/config-worker.mjs +44 -0
  267. package/dist/sandbox/config-worker.mjs.map +1 -0
  268. package/dist/sandbox/credentials-worker.cjs +53 -0
  269. package/dist/sandbox/credentials-worker.cjs.map +1 -0
  270. package/dist/sandbox/credentials-worker.d.cts +1 -0
  271. package/dist/sandbox/credentials-worker.d.mts +1 -0
  272. package/dist/sandbox/credentials-worker.mjs +54 -0
  273. package/dist/sandbox/credentials-worker.mjs.map +1 -0
  274. package/dist/sandbox/discover-worker.cjs +47 -0
  275. package/dist/sandbox/discover-worker.cjs.map +1 -0
  276. package/dist/sandbox/discover-worker.d.cts +1 -0
  277. package/dist/sandbox/discover-worker.d.mts +1 -0
  278. package/dist/sandbox/discover-worker.mjs +48 -0
  279. package/dist/sandbox/discover-worker.mjs.map +1 -0
  280. package/dist/sandbox/migrate-worker.cjs +75 -0
  281. package/dist/sandbox/migrate-worker.cjs.map +1 -0
  282. package/dist/sandbox/migrate-worker.d.cts +1 -0
  283. package/dist/sandbox/migrate-worker.d.mts +1 -0
  284. package/dist/sandbox/migrate-worker.mjs +76 -0
  285. package/dist/sandbox/migrate-worker.mjs.map +1 -0
  286. package/dist/{workspace-CRD9YinV.cjs → schemas-BCwKKA42.mjs} +399 -1179
  287. package/dist/schemas-BCwKKA42.mjs.map +1 -0
  288. package/dist/{workspace-Bu3xNCej.mjs → schemas-BQ_v0lEX.cjs} +487 -982
  289. package/dist/schemas-BQ_v0lEX.cjs.map +1 -0
  290. package/dist/secretsManager-CjTo6CRq.mjs +113 -0
  291. package/dist/secretsManager-CjTo6CRq.mjs.map +1 -0
  292. package/dist/secretsManager-CvmBGjdM.cjs +124 -0
  293. package/dist/secretsManager-CvmBGjdM.cjs.map +1 -0
  294. package/dist/seeds-Bc3niNVb.cjs +382 -0
  295. package/dist/seeds-Bc3niNVb.cjs.map +1 -0
  296. package/dist/seeds-Ccn0Ru2T.mjs +299 -0
  297. package/dist/seeds-Ccn0Ru2T.mjs.map +1 -0
  298. package/dist/serverSetup-ClU2iSeU.cjs +686 -0
  299. package/dist/serverSetup-ClU2iSeU.cjs.map +1 -0
  300. package/dist/serverSetup-D68Otrp0.mjs +686 -0
  301. package/dist/serverSetup-D68Otrp0.mjs.map +1 -0
  302. package/dist/sniffer-CFOmQQit.cjs +1997 -0
  303. package/dist/sniffer-CFOmQQit.cjs.map +1 -0
  304. package/dist/sniffer-CRF3eD_B.mjs +1824 -0
  305. package/dist/sniffer-CRF3eD_B.mjs.map +1 -0
  306. package/dist/snsSubscriptions-CwA6Ceg2.mjs +1024 -0
  307. package/dist/snsSubscriptions-CwA6Ceg2.mjs.map +1 -0
  308. package/dist/snsSubscriptions-S_CMCXqI.cjs +1149 -0
  309. package/dist/snsSubscriptions-S_CMCXqI.cjs.map +1 -0
  310. package/dist/sst-BgG7dJJu.cjs +514 -0
  311. package/dist/sst-BgG7dJJu.cjs.map +1 -0
  312. package/dist/sst-CDnHFO3U.mjs +491 -0
  313. package/dist/sst-CDnHFO3U.mjs.map +1 -0
  314. package/dist/stack-BXmLQf3K.mjs +10920 -0
  315. package/dist/stack-BXmLQf3K.mjs.map +1 -0
  316. package/dist/stack-BtnflNSa.cjs +11901 -0
  317. package/dist/stack-BtnflNSa.cjs.map +1 -0
  318. package/dist/stage-BbQidxxa.mjs +302 -0
  319. package/dist/stage-BbQidxxa.mjs.map +1 -0
  320. package/dist/stage-ssuPXLhP.cjs +331 -0
  321. package/dist/stage-ssuPXLhP.cjs.map +1 -0
  322. package/dist/stages-CQwD2QxS.cjs +190 -0
  323. package/dist/stages-CQwD2QxS.cjs.map +1 -0
  324. package/dist/stages-MA2sXnX4.mjs +190 -0
  325. package/dist/stages-MA2sXnX4.mjs.map +1 -0
  326. package/dist/target/public.cjs +15 -0
  327. package/dist/target/public.d.cts +28 -0
  328. package/dist/target/public.d.cts.map +1 -0
  329. package/dist/target/public.d.mts +28 -0
  330. package/dist/target/public.d.mts.map +1 -0
  331. package/dist/target/public.mjs +4 -0
  332. package/dist/terminal-BEGE1AEV.mjs +85 -0
  333. package/dist/terminal-BEGE1AEV.mjs.map +1 -0
  334. package/dist/terminal-BecJpgA3.cjs +85 -0
  335. package/dist/terminal-BecJpgA3.cjs.map +1 -0
  336. package/dist/{types-7R81hu0i.d.mts → types-BvokH0ya.d.cts} +2235 -459
  337. package/dist/types-BvokH0ya.d.cts.map +1 -0
  338. package/dist/{types-N7c2O2m7.d.cts → types-DmLnGeii.d.mts} +2233 -459
  339. package/dist/types-DmLnGeii.d.mts.map +1 -0
  340. package/dist/utils-CdKxD8Lt.mjs +156 -0
  341. package/dist/utils-CdKxD8Lt.mjs.map +1 -0
  342. package/dist/utils-DBqXbB8P.cjs +205 -0
  343. package/dist/utils-DBqXbB8P.cjs.map +1 -0
  344. package/dist/vitest.cjs +65 -0
  345. package/dist/vitest.cjs.map +1 -0
  346. package/dist/vitest.d.cts +29 -0
  347. package/dist/vitest.d.cts.map +1 -0
  348. package/dist/vitest.d.mts +29 -0
  349. package/dist/vitest.d.mts.map +1 -0
  350. package/dist/vitest.mjs +65 -0
  351. package/dist/vitest.mjs.map +1 -0
  352. package/dist/workerRuntime-BXfhbe13.cjs +108 -0
  353. package/dist/workerRuntime-BXfhbe13.cjs.map +1 -0
  354. package/dist/workerRuntime-CsOyBRx2.mjs +79 -0
  355. package/dist/workerRuntime-CsOyBRx2.mjs.map +1 -0
  356. package/dist/workspace/index.cjs +6 -2
  357. package/dist/workspace/index.d.cts +3 -3
  358. package/dist/workspace/index.d.mts +3 -3
  359. package/dist/workspace/index.mjs +2 -2
  360. package/dist/workspace-DEmfa9RO.cjs +3689 -0
  361. package/dist/workspace-DEmfa9RO.cjs.map +1 -0
  362. package/dist/workspace-RgU7TBgg.mjs +3133 -0
  363. package/dist/workspace-RgU7TBgg.mjs.map +1 -0
  364. package/package.json +76 -13
  365. package/dist/HostingerProvider-BY26bWwB.mjs +0 -243
  366. package/dist/HostingerProvider-BY26bWwB.mjs.map +0 -1
  367. package/dist/HostingerProvider-BZFGYYVA.cjs +0 -243
  368. package/dist/HostingerProvider-BZFGYYVA.cjs.map +0 -1
  369. package/dist/LocalStateProvider-7HR6SS2t.cjs +0 -48
  370. package/dist/LocalStateProvider-7HR6SS2t.cjs.map +0 -1
  371. package/dist/LocalStateProvider-D7QyJoLM.mjs +0 -48
  372. package/dist/LocalStateProvider-D7QyJoLM.mjs.map +0 -1
  373. package/dist/Route53Provider-Cvj40A8I.mjs +0 -209
  374. package/dist/Route53Provider-Cvj40A8I.mjs.map +0 -1
  375. package/dist/Route53Provider-DVILBsvV.cjs +0 -209
  376. package/dist/Route53Provider-DVILBsvV.cjs.map +0 -1
  377. package/dist/SSMStateProvider-B0Hu1MKZ.mjs +0 -75
  378. package/dist/SSMStateProvider-B0Hu1MKZ.mjs.map +0 -1
  379. package/dist/SSMStateProvider-VrQ-yeqd.cjs +0 -74
  380. package/dist/SSMStateProvider-VrQ-yeqd.cjs.map +0 -1
  381. package/dist/backup-provisioner-BmhIO_Yr.cjs.map +0 -1
  382. package/dist/backup-provisioner-DIVCbfee.mjs.map +0 -1
  383. package/dist/bundler-mjqGAvu1.cjs.map +0 -1
  384. package/dist/bundler-mwH7WOb1.mjs.map +0 -1
  385. package/dist/config-DSXI480r.cjs +0 -467
  386. package/dist/config-DSXI480r.cjs.map +0 -1
  387. package/dist/config-DdKkoUE1.mjs +0 -414
  388. package/dist/config-DdKkoUE1.mjs.map +0 -1
  389. package/dist/config.d.cts.map +0 -1
  390. package/dist/config.d.mts.map +0 -1
  391. package/dist/credentials-C6Pfn6GY.cjs +0 -2939
  392. package/dist/credentials-C6Pfn6GY.cjs.map +0 -1
  393. package/dist/credentials-lbv-j0Be.mjs +0 -2802
  394. package/dist/credentials-lbv-j0Be.mjs.map +0 -1
  395. package/dist/discover-BERGFg8v.cjs +0 -288
  396. package/dist/discover-BERGFg8v.cjs.map +0 -1
  397. package/dist/discover-CK-n3w6b.mjs +0 -244
  398. package/dist/discover-CK-n3w6b.mjs.map +0 -1
  399. package/dist/emit-BdoPFjZf.cjs +0 -253
  400. package/dist/emit-BdoPFjZf.cjs.map +0 -1
  401. package/dist/emit-Bzq7JsMP.mjs +0 -224
  402. package/dist/emit-Bzq7JsMP.mjs.map +0 -1
  403. package/dist/generator-LfZU7NlU.mjs +0 -247
  404. package/dist/generator-LfZU7NlU.mjs.map +0 -1
  405. package/dist/generator-Wdfp0jCS.cjs +0 -282
  406. package/dist/generator-Wdfp0jCS.cjs.map +0 -1
  407. package/dist/github-BvfpvBcW.cjs +0 -216
  408. package/dist/github-BvfpvBcW.cjs.map +0 -1
  409. package/dist/github-DW3CP-4D.mjs +0 -216
  410. package/dist/github-DW3CP-4D.mjs.map +0 -1
  411. package/dist/index-B4H4XF7A.d.mts.map +0 -1
  412. package/dist/index-RCUizGxL.d.cts.map +0 -1
  413. package/dist/openapi-B8bu_OXN.cjs +0 -2038
  414. package/dist/openapi-B8bu_OXN.cjs.map +0 -1
  415. package/dist/openapi-DfjbhrsM.mjs +0 -1991
  416. package/dist/openapi-DfjbhrsM.mjs.map +0 -1
  417. package/dist/reconcile-gb1lz1Dk.mjs +0 -113
  418. package/dist/reconcile-gb1lz1Dk.mjs.map +0 -1
  419. package/dist/reconcile-hx_vBvux.cjs +0 -136
  420. package/dist/reconcile-hx_vBvux.cjs.map +0 -1
  421. package/dist/ssm-BKN1Cg4z.mjs +0 -60
  422. package/dist/ssm-BKN1Cg4z.mjs.map +0 -1
  423. package/dist/ssm-FxeSAt35.cjs +0 -60
  424. package/dist/ssm-FxeSAt35.cjs.map +0 -1
  425. package/dist/storage-DgypfSD6.cjs +0 -351
  426. package/dist/storage-DgypfSD6.cjs.map +0 -1
  427. package/dist/storage-TP0x118M.mjs +0 -304
  428. package/dist/storage-TP0x118M.mjs.map +0 -1
  429. package/dist/transfer-DjFZRgub.mjs +0 -122
  430. package/dist/transfer-DjFZRgub.mjs.map +0 -1
  431. package/dist/transfer-SeiSeKEF.cjs +0 -151
  432. package/dist/transfer-SeiSeKEF.cjs.map +0 -1
  433. package/dist/types-7R81hu0i.d.mts.map +0 -1
  434. package/dist/types-N7c2O2m7.d.cts.map +0 -1
  435. package/dist/workspace-Bu3xNCej.mjs.map +0 -1
  436. package/dist/workspace-CRD9YinV.cjs.map +0 -1
@@ -0,0 +1,44 @@
1
+ //#region src/next.d.ts
2
+ /**
3
+ * `@geekmidas/cli/next` — what a Next.js site's `next.config.ts` builds from
4
+ * the workspace instead of from hand-kept lists.
5
+ *
6
+ * ```ts
7
+ * import { imageRemotePatterns } from '@geekmidas/cli/next';
8
+ *
9
+ * export default {
10
+ * images: { remotePatterns: [...imageRemotePatterns(), // third parties ] },
11
+ * };
12
+ * ```
13
+ *
14
+ * Read from the environment `gkm dev`, `gkm exec` and a compose or AWS site
15
+ * build hand the site, so it imports nothing of the workspace and runs
16
+ * wherever `next.config` does.
17
+ */
18
+ /**
19
+ * One entry of `images.remotePatterns`, as Next takes it. Stated here rather
20
+ * than imported, so this module needs no `next` to load.
21
+ */
22
+ export interface RemotePattern {
23
+ protocol?: 'http' | 'https';
24
+ hostname: string;
25
+ port?: string;
26
+ pathname?: string;
27
+ }
28
+ /**
29
+ * A `RemotePattern` for every origin the site's pages load files from: each
30
+ * file server it has an edge to, and the host each bucket it reaches signs
31
+ * its links on — for the stage being built, as gkm resolved them.
32
+ *
33
+ * Under `gkm dev` those are the local ones: the file server's `*.localhost`
34
+ * host and MinIO's address, on the ports this machine assigned. An empty list
35
+ * where nothing handed the site its origins (a plain `next build`), rather
36
+ * than a throw: the config still loads, and `next/image` refuses the hosts it
37
+ * was not told about, as it would have.
38
+ *
39
+ * Every path on each host: a file server answers signed paths and open ones,
40
+ * and a signed link may point at any key.
41
+ */
42
+ export declare function imageRemotePatterns(env?: Readonly<Record<string, string | undefined>>): RemotePattern[];
43
+ //#endregion
44
+ //# sourceMappingURL=next.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"next.d.mts","names":[],"sources":["../src/next.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;iBAuBiB;EAChB;EACA;EACA;EACA;;;;;;;;;;;;;;;;wBAiBe,oBACf,MAAK,SAAS,sCACZ"}
package/dist/next.mjs ADDED
@@ -0,0 +1,58 @@
1
+ import { IMAGE_ORIGINS_KEY, PUBLIC_PREFIX } from "@geekmidas/manifest";
2
+ //#region src/next.ts
3
+ /**
4
+ * `@geekmidas/cli/next` — what a Next.js site's `next.config.ts` builds from
5
+ * the workspace instead of from hand-kept lists.
6
+ *
7
+ * ```ts
8
+ * import { imageRemotePatterns } from '@geekmidas/cli/next';
9
+ *
10
+ * export default {
11
+ * images: { remotePatterns: [...imageRemotePatterns(), // third parties ] },
12
+ * };
13
+ * ```
14
+ *
15
+ * Read from the environment `gkm dev`, `gkm exec` and a compose or AWS site
16
+ * build hand the site, so it imports nothing of the workspace and runs
17
+ * wherever `next.config` does.
18
+ */
19
+ /**
20
+ * A `RemotePattern` for every origin the site's pages load files from: each
21
+ * file server it has an edge to, and the host each bucket it reaches signs
22
+ * its links on — for the stage being built, as gkm resolved them.
23
+ *
24
+ * Under `gkm dev` those are the local ones: the file server's `*.localhost`
25
+ * host and MinIO's address, on the ports this machine assigned. An empty list
26
+ * where nothing handed the site its origins (a plain `next build`), rather
27
+ * than a throw: the config still loads, and `next/image` refuses the hosts it
28
+ * was not told about, as it would have.
29
+ *
30
+ * Every path on each host: a file server answers signed paths and open ones,
31
+ * and a signed link may point at any key.
32
+ */
33
+ function imageRemotePatterns(env = process.env) {
34
+ const listed = env[`${PUBLIC_PREFIX.next}${IMAGE_ORIGINS_KEY}`] ?? env[IMAGE_ORIGINS_KEY];
35
+ if (!listed) return [];
36
+ const patterns = [];
37
+ for (const origin of listed.split(",")) {
38
+ let url;
39
+ try {
40
+ url = new URL(origin.trim());
41
+ } catch {
42
+ continue;
43
+ }
44
+ const protocol = url.protocol.slice(0, -1);
45
+ if (protocol !== "http" && protocol !== "https") continue;
46
+ patterns.push({
47
+ protocol,
48
+ hostname: url.hostname,
49
+ ...url.port ? { port: url.port } : {},
50
+ pathname: "/**"
51
+ });
52
+ }
53
+ return patterns;
54
+ }
55
+ //#endregion
56
+ export { imageRemotePatterns };
57
+
58
+ //# sourceMappingURL=next.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"next.mjs","names":[],"sources":["../src/next.ts"],"sourcesContent":["/**\n * `@geekmidas/cli/next` — what a Next.js site's `next.config.ts` builds from\n * the workspace instead of from hand-kept lists.\n *\n * ```ts\n * import { imageRemotePatterns } from '@geekmidas/cli/next';\n *\n * export default {\n * images: { remotePatterns: [...imageRemotePatterns(), // third parties ] },\n * };\n * ```\n *\n * Read from the environment `gkm dev`, `gkm exec` and a compose or AWS site\n * build hand the site, so it imports nothing of the workspace and runs\n * wherever `next.config` does.\n */\n\nimport { IMAGE_ORIGINS_KEY, PUBLIC_PREFIX } from '@geekmidas/manifest';\n\n/**\n * One entry of `images.remotePatterns`, as Next takes it. Stated here rather\n * than imported, so this module needs no `next` to load.\n */\nexport interface RemotePattern {\n\tprotocol?: 'http' | 'https';\n\thostname: string;\n\tport?: string;\n\tpathname?: string;\n}\n\n/**\n * A `RemotePattern` for every origin the site's pages load files from: each\n * file server it has an edge to, and the host each bucket it reaches signs\n * its links on — for the stage being built, as gkm resolved them.\n *\n * Under `gkm dev` those are the local ones: the file server's `*.localhost`\n * host and MinIO's address, on the ports this machine assigned. An empty list\n * where nothing handed the site its origins (a plain `next build`), rather\n * than a throw: the config still loads, and `next/image` refuses the hosts it\n * was not told about, as it would have.\n *\n * Every path on each host: a file server answers signed paths and open ones,\n * and a signed link may point at any key.\n */\nexport function imageRemotePatterns(\n\tenv: Readonly<Record<string, string | undefined>> = process.env,\n): RemotePattern[] {\n\tconst listed =\n\t\tenv[`${PUBLIC_PREFIX.next}${IMAGE_ORIGINS_KEY}`] ?? env[IMAGE_ORIGINS_KEY];\n\tif (!listed) return [];\n\n\tconst patterns: RemotePattern[] = [];\n\tfor (const origin of listed.split(',')) {\n\t\tlet url: URL;\n\t\ttry {\n\t\t\turl = new URL(origin.trim());\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tconst protocol = url.protocol.slice(0, -1);\n\t\tif (protocol !== 'http' && protocol !== 'https') continue;\n\t\tpatterns.push({\n\t\t\tprotocol,\n\t\t\thostname: url.hostname,\n\t\t\t...(url.port ? { port: url.port } : {}),\n\t\t\tpathname: '/**',\n\t\t});\n\t}\n\treturn patterns;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAgB,oBACf,MAAoD,QAAQ,KAC1C;CAClB,MAAM,SACL,IAAI,GAAG,cAAc,OAAO,wBAAwB,IAAI;CACzD,IAAI,CAAC,QAAQ,OAAO,CAAC;CAErB,MAAM,WAA4B,CAAC;CACnC,KAAK,MAAM,UAAU,OAAO,MAAM,GAAG,GAAG;EACvC,IAAI;EACJ,IAAI;GACH,MAAM,IAAI,IAAI,OAAO,KAAK,CAAC;EAC5B,QAAQ;GACP;EACD;EACA,MAAM,WAAW,IAAI,SAAS,MAAM,GAAG,EAAE;EACzC,IAAI,aAAa,UAAU,aAAa,SAAS;EACjD,SAAS,KAAK;GACb;GACA,UAAU,IAAI;GACd,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;GACrC,UAAU;EACX,CAAC;CACF;CACA,OAAO;AACR"}
package/dist/openapi.cjs CHANGED
@@ -1,9 +1,215 @@
1
1
  #!/usr/bin/env -S npx tsx
2
2
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
- const require_openapi = require("./openapi-B8bu_OXN.cjs");
4
- exports.OPENAPI_OUTPUT_PATH = require_openapi.OPENAPI_OUTPUT_PATH;
5
- exports.generateOpenApi = require_openapi.generateOpenApi;
6
- exports.generateOpenApiFrom = require_openapi.generateOpenApiFrom;
7
- exports.openApiPathFor = require_openapi.openApiPathFor;
8
- exports.openapiCommand = require_openapi.openapiCommand;
9
- exports.resolveOpenApiConfig = require_openapi.resolveOpenApiConfig;
3
+ const require_workspace = require("./workspace-DEmfa9RO.cjs");
4
+ const require_EndpointGenerator = require("./EndpointGenerator-iyA3HkOH.cjs");
5
+ const require_config = require("./config.cjs");
6
+ const require_OpenApiTsGenerator = require("./OpenApiTsGenerator-vy-fOJgs.cjs");
7
+ let node_path = require("node:path");
8
+ let node_fs_promises = require("node:fs/promises");
9
+ let node_child_process = require("node:child_process");
10
+ let _geekmidas_manifest = require("@geekmidas/manifest");
11
+ let node_url = require("node:url");
12
+ //#region src/openapi.ts
13
+ /**
14
+ * Where a surface's generated client lands, under the workspace root.
15
+ *
16
+ * Named from the surface, so `new RestApi('Webhooks')` writes
17
+ * `.gkm/client/webhooks.ts` — the same kebab form that gives it its container
18
+ * name and its `WEBHOOKS_URL` — and a site imports it as
19
+ * `@<name>/client/webhooks`, through the alias its tsconfig maps.
20
+ */
21
+ function openApiPathFor(surfaceId) {
22
+ return `./.gkm/client/${(0, _geekmidas_manifest.kebabCase)(surfaceId)}.ts`;
23
+ }
24
+ /**
25
+ * Resolve OpenAPI config from GkmConfig
26
+ */
27
+ function resolveOpenApiConfig(config) {
28
+ if (config.openapi === false) return { enabled: false };
29
+ if (config.openapi === true || config.openapi === void 0) return {
30
+ enabled: true,
31
+ title: "API Documentation",
32
+ version: "1.0.0",
33
+ description: "Auto-generated API documentation from endpoints"
34
+ };
35
+ return {
36
+ enabled: config.openapi.enabled !== false,
37
+ title: config.openapi.title || "API Documentation",
38
+ version: config.openapi.version || "1.0.0",
39
+ description: config.openapi.description || "Auto-generated API documentation from endpoints"
40
+ };
41
+ }
42
+ /**
43
+ * Load endpoints from a glob, then generate.
44
+ *
45
+ * For the callers that have no endpoints in hand — `gkm openapi`, and `gkm dev`
46
+ * regenerating on reload. The glob is the app's derived one — the conventional
47
+ * directories under it — not a `routes` field anybody wrote.
48
+ */
49
+ async function generateOpenApiFrom(routes, options = {}) {
50
+ return generateOpenApi((await new require_EndpointGenerator.EndpointGenerator().load(routes, void 0, options.bustCache)).map(({ construct }) => construct), options);
51
+ }
52
+ /**
53
+ * Generate an OpenAPI spec for each surface these endpoints name.
54
+ *
55
+ * Takes the endpoints, not a glob to find them with. The build has already
56
+ * loaded every one of them to generate handlers, so globbing again was a second
57
+ * discovery pass over the same files — and the reason this function needed a
58
+ * `routes` to be told where to look, which is how a retired config field stayed
59
+ * load-bearing.
60
+ *
61
+ * @returns What was written, or null if disabled or there were none
62
+ */
63
+ async function generateOpenApi(endpoints, options = {}) {
64
+ const root = options.root ?? process.cwd();
65
+ const logger = options.silent ? { log: () => {} } : console;
66
+ const openApiConfig = resolveOpenApiConfig({ openapi: options.openapi });
67
+ if (!openApiConfig.enabled) return null;
68
+ if (endpoints.length === 0) {
69
+ logger.log("No valid endpoints found for OpenAPI generation");
70
+ return null;
71
+ }
72
+ const bySurface = /* @__PURE__ */ new Map();
73
+ for (const endpoint of endpoints) {
74
+ const owner = endpoint.owner ?? endpoint.surface?.id;
75
+ if (!owner) continue;
76
+ const existing = bySurface.get(owner);
77
+ if (existing) existing.push(endpoint);
78
+ else bySurface.set(owner, [endpoint]);
79
+ }
80
+ if (bySurface.size === 0) {
81
+ logger.log("No endpoints named a surface, so no OpenAPI was generated");
82
+ return null;
83
+ }
84
+ const tsGenerator = new require_OpenApiTsGenerator.OpenApiTsGenerator();
85
+ const written = [];
86
+ for (const [surfaceId, surfaceEndpoints] of bySurface) {
87
+ const relative = openApiPathFor(surfaceId);
88
+ const outputPath = (0, node_path.join)(root, relative);
89
+ await (0, node_fs_promises.mkdir)((0, node_path.dirname)(outputPath), { recursive: true });
90
+ const tsContent = await tsGenerator.generate(surfaceEndpoints, {
91
+ title: openApiConfig.title ?? surfaceId,
92
+ version: openApiConfig.version,
93
+ description: openApiConfig.description,
94
+ ...options.telemetry !== void 0 ? { telemetry: options.telemetry } : {}
95
+ });
96
+ await (0, node_fs_promises.writeFile)(outputPath, tsContent);
97
+ written.push(relative);
98
+ logger.log(`📄 OpenAPI client generated: ${(0, node_path.relative)(process.cwd(), outputPath)} (${surfaceEndpoints.length} endpoints)`);
99
+ }
100
+ return {
101
+ outputPath: (0, node_path.join)(root, written[0]),
102
+ outputPaths: written.map((r) => (0, node_path.join)(root, r)),
103
+ endpointCount: endpoints.length
104
+ };
105
+ }
106
+ async function openapiCommand(options = {}) {
107
+ const logger = console;
108
+ try {
109
+ const loadedConfig = await require_config.loadWorkspaceConfig(options.cwd);
110
+ if (loadedConfig.type === "single") {
111
+ const config = loadedConfig.raw;
112
+ if (!config.openapi) config.openapi = { enabled: true };
113
+ const result = await generateOpenApiFrom(config.constructs, {
114
+ openapi: config.openapi,
115
+ root: loadedConfig.workspace.root,
116
+ ...options.telemetry !== void 0 ? { telemetry: options.telemetry } : {}
117
+ });
118
+ if (result) logger.log(`Found ${result.endpointCount} endpoints`);
119
+ } else {
120
+ const { workspace } = loadedConfig;
121
+ const workspaceRoot = workspace.root;
122
+ const backendApps = Object.entries(workspace.apps).filter(([_, app]) => app.type === "backend" && app.openapi !== false && (typeof app.openapi !== "object" || app.openapi.enabled !== false));
123
+ if (backendApps.length === 0) {
124
+ logger.log("No backend apps with OpenAPI enabled found");
125
+ return;
126
+ }
127
+ if (options.app) {
128
+ const entry = backendApps.find(([name]) => name === options.app);
129
+ if (!entry) throw new Error(`App "${options.app}" not found or has OpenAPI disabled`);
130
+ const [appName, app] = entry;
131
+ const result = await generateOpenApiForApp(workspace, appName, app, true, options.telemetry);
132
+ if (result) logger.log(`📄 [${appName}] Generated OpenAPI (${result.endpointCount} endpoints)`);
133
+ return;
134
+ }
135
+ for (const [appName, app] of backendApps) {
136
+ const appPath = (0, node_path.join)(workspaceRoot, app.path);
137
+ if ((0, node_path.resolve)(appPath) === (0, node_path.resolve)(workspaceRoot)) {
138
+ const result = await generateOpenApiForApp(workspace, appName, app, false, options.telemetry);
139
+ if (result) logger.log(`Found ${result.endpointCount} endpoints`);
140
+ continue;
141
+ }
142
+ await runOpenApiInSubprocess(appPath, appName, options.telemetry);
143
+ }
144
+ }
145
+ } catch (error) {
146
+ throw new Error(`OpenAPI generation failed: ${error.message}`);
147
+ }
148
+ }
149
+ /**
150
+ * Generate OpenAPI for a single named app within a workspace.
151
+ * Runs in-process. The caller is responsible for ensuring `process.cwd()`
152
+ * is the app's directory so tsx loads the app's tsconfig path aliases.
153
+ *
154
+ * The endpoints are found the way the app's build finds them — through the
155
+ * workspace's constructs globs — never by importing every `.ts` under the app,
156
+ * which loaded its tests and gkm's own generated files with them.
157
+ */
158
+ async function generateOpenApiForApp(workspace, appName, app, silent = true, telemetry) {
159
+ if (app.type !== "backend") return null;
160
+ return generateOpenApi((await new require_EndpointGenerator.EndpointGenerator().load(require_workspace.appConstructGlobs(workspace, appName))).map(({ construct }) => construct).filter((endpoint) => {
161
+ const owner = endpoint.owner ?? endpoint.surface?.id;
162
+ if (!owner) return false;
163
+ const key = require_workspace.appKey(owner);
164
+ return key === appName || !workspace.apps[key];
165
+ }), {
166
+ openapi: app.openapi ?? { enabled: true },
167
+ silent,
168
+ root: workspace.root,
169
+ ...telemetry !== void 0 ? { telemetry } : {}
170
+ });
171
+ }
172
+ /**
173
+ * Resolve the gkm bin path. Tests can override via `GKM_BIN_PATH` env var
174
+ * to avoid depending on the built dist.
175
+ */
176
+ function resolveGkmBinPath() {
177
+ if (process.env.GKM_BIN_PATH) return process.env.GKM_BIN_PATH;
178
+ return (0, node_url.fileURLToPath)(new URL("../bin/gkm.mjs", require("url").pathToFileURL(__filename).href));
179
+ }
180
+ /**
181
+ * Spawn a subprocess that runs `gkm openapi --app <name>` with `cwd` set to
182
+ * the app's directory. Inherits `NODE_OPTIONS` (which already contains
183
+ * `--import tsx`), so the child gets a fresh tsx instance whose tsconfig
184
+ * discovery picks up the app's tsconfig path aliases.
185
+ */
186
+ async function runOpenApiInSubprocess(appCwd, appName, telemetry) {
187
+ const binPath = resolveGkmBinPath();
188
+ await new Promise((resolve, reject) => {
189
+ const child = (0, node_child_process.spawn)(process.execPath, [
190
+ binPath,
191
+ "openapi",
192
+ "--app",
193
+ appName,
194
+ ...require_EndpointGenerator.telemetryArgs(telemetry)
195
+ ], {
196
+ cwd: appCwd,
197
+ stdio: "inherit",
198
+ env: process.env
199
+ });
200
+ child.on("error", reject);
201
+ child.on("close", (code) => {
202
+ if (code === 0) resolve();
203
+ else reject(/* @__PURE__ */ new Error(`OpenAPI generation for app "${appName}" exited with code ${code}`));
204
+ });
205
+ });
206
+ }
207
+ //#endregion
208
+ exports.generateOpenApi = generateOpenApi;
209
+ exports.generateOpenApiFrom = generateOpenApiFrom;
210
+ exports.openApiPathFor = openApiPathFor;
211
+ exports.openapiCommand = openapiCommand;
212
+ exports.parseTelemetryFlag = require_EndpointGenerator.parseTelemetryFlag;
213
+ exports.resolveOpenApiConfig = resolveOpenApiConfig;
214
+
215
+ //# sourceMappingURL=openapi.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openapi.cjs","names":["kebabCase","EndpointGenerator","OpenApiTsGenerator","join","mkdir","dirname","writeFile","relativePath","loadWorkspaceConfig","resolve","appConstructGlobs","appKey","fileURLToPath","spawn","telemetryArgs"],"sources":["../src/openapi.ts"],"sourcesContent":["#!/usr/bin/env -S npx tsx\n\nimport { spawn } from 'node:child_process';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, join, relative as relativePath, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Endpoint } from '@geekmidas/constructs/endpoints';\nimport { kebabCase } from '@geekmidas/manifest';\nimport { loadWorkspaceConfig } from './config.js';\nimport type { ClientTelemetryDefault } from './generators/clientTelemetry.js';\nimport { telemetryArgs } from './generators/clientTelemetry.js';\nimport { EndpointGenerator } from './generators/EndpointGenerator.js';\nimport { OpenApiTsGenerator } from './generators/OpenApiTsGenerator.js';\n\nexport { parseTelemetryFlag } from './generators/clientTelemetry.js';\n\nimport type { GkmConfig, OpenApiConfig, Routes } from './types.js';\nimport { appKey } from './workspace/derive.js';\nimport { appConstructGlobs } from './workspace/index.js';\nimport type {\n\tNormalizedAppConfig,\n\tNormalizedWorkspace,\n} from './workspace/types.js';\n\ninterface OpenAPIOptions {\n\tcwd?: string;\n\t/**\n\t * Workspace mode: generate for a single named backend app. When set,\n\t * generation runs in-process against the current CWD. When unset,\n\t * workspace mode spawns one subprocess per backend app so each gets a\n\t * fresh tsx that loads the app's own tsconfig (path aliases included).\n\t */\n\tapp?: string;\n\t/**\n\t * Trace propagation in the clients written, off when absent — see\n\t * {@link ClientTelemetryDefault}. `gkm openapi --telemetry [rate]`.\n\t */\n\ttelemetry?: ClientTelemetryDefault;\n}\n\n/**\n * Where a surface's generated client lands, under the workspace root.\n *\n * Named from the surface, so `new RestApi('Webhooks')` writes\n * `.gkm/client/webhooks.ts` — the same kebab form that gives it its container\n * name and its `WEBHOOKS_URL` — and a site imports it as\n * `@<name>/client/webhooks`, through the alias its tsconfig maps.\n */\nexport function openApiPathFor(surfaceId: string): string {\n\treturn `./.gkm/client/${kebabCase(surfaceId)}.ts`;\n}\n\n/**\n * Resolve OpenAPI config from GkmConfig\n */\nexport function resolveOpenApiConfig(config: {\n\topenapi?: boolean | OpenApiConfig;\n}): OpenApiConfig & { enabled: boolean } {\n\tif (config.openapi === false) {\n\t\treturn { enabled: false };\n\t}\n\n\tif (config.openapi === true || config.openapi === undefined) {\n\t\t// Enable by default when not explicitly set (undefined) or explicitly true\n\t\treturn {\n\t\t\tenabled: true,\n\t\t\ttitle: 'API Documentation',\n\t\t\tversion: '1.0.0',\n\t\t\tdescription: 'Auto-generated API documentation from endpoints',\n\t\t};\n\t}\n\n\treturn {\n\t\tenabled: config.openapi.enabled !== false,\n\t\ttitle: config.openapi.title || 'API Documentation',\n\t\tversion: config.openapi.version || '1.0.0',\n\t\tdescription:\n\t\t\tconfig.openapi.description ||\n\t\t\t'Auto-generated API documentation from endpoints',\n\t};\n}\n\n/** What a generation run wrote. */\nexport interface OpenApiResult {\n\t/** The first spec written — kept so existing callers still compile. */\n\toutputPath: string;\n\t/** Every spec written, one per surface. */\n\toutputPaths: string[];\n\t/** Endpoints across all of them. */\n\tendpointCount: number;\n}\n\n/**\n * Load endpoints from a glob, then generate.\n *\n * For the callers that have no endpoints in hand — `gkm openapi`, and `gkm dev`\n * regenerating on reload. The glob is the app's derived one — the conventional\n * directories under it — not a `routes` field anybody wrote.\n */\nexport async function generateOpenApiFrom(\n\troutes: Routes,\n\toptions: {\n\t\topenapi?: boolean | OpenApiConfig;\n\t\tsilent?: boolean;\n\t\tbustCache?: boolean;\n\t\troot?: string;\n\t\ttelemetry?: ClientTelemetryDefault;\n\t} = {},\n): Promise<OpenApiResult | null> {\n\tconst loaded = await new EndpointGenerator().load(\n\t\troutes,\n\t\tundefined,\n\t\toptions.bustCache,\n\t);\n\n\treturn generateOpenApi(\n\t\tloaded.map(({ construct }) => construct),\n\t\toptions,\n\t);\n}\n\n/**\n * Generate an OpenAPI spec for each surface these endpoints name.\n *\n * Takes the endpoints, not a glob to find them with. The build has already\n * loaded every one of them to generate handlers, so globbing again was a second\n * discovery pass over the same files — and the reason this function needed a\n * `routes` to be told where to look, which is how a retired config field stayed\n * load-bearing.\n *\n * @returns What was written, or null if disabled or there were none\n */\nexport async function generateOpenApi(\n\tendpoints: readonly Endpoint<any, any, any, any, any>[],\n\toptions: {\n\t\topenapi?: boolean | OpenApiConfig;\n\t\tsilent?: boolean;\n\t\t/**\n\t\t * The workspace root, whose `.gkm/client/` holds every surface's client.\n\t\t * The client is the application's, like its manifest — a site reaches it\n\t\t * as `@<name>/client/<surface>` — so it is written there whichever\n\t\t * directory the build happened to run in.\n\t\t */\n\t\troot?: string;\n\t\t/**\n\t\t * Whether the clients written propagate trace context by default. Off\n\t\t * when absent: the integration point for a site's edge to a\n\t\t * `Telemetry` construct, which decides it for the clients it imports.\n\t\t */\n\t\ttelemetry?: ClientTelemetryDefault;\n\t} = {},\n): Promise<OpenApiResult | null> {\n\tconst root = options.root ?? process.cwd();\n\tconst logger = options.silent ? { log: () => {} } : console;\n\tconst openApiConfig = resolveOpenApiConfig({ openapi: options.openapi });\n\n\tif (!openApiConfig.enabled) {\n\t\treturn null;\n\t}\n\n\tif (endpoints.length === 0) {\n\t\tlogger.log('No valid endpoints found for OpenAPI generation');\n\t\treturn null;\n\t}\n\n\t// One spec per surface, not one per glob.\n\t//\n\t// The glob is a directory, and a directory is not a surface: two `RestApi`s\n\t// whose endpoints live side by side produced a single spec describing both,\n\t// under a filename that named neither. Every endpoint carries the surface\n\t// that serves it, so that is what the spec is cut along — `Api` becomes\n\t// `api.ts`, `Webhooks` becomes `webhooks.ts`, by the same kebab rule that\n\t// gives the surface its container name and its environment keys.\n\tconst bySurface = new Map<string, Endpoint<any, any, any, any, any>[]>();\n\tfor (const endpoint of endpoints) {\n\t\tconst owner = endpoint.owner ?? endpoint.surface?.id;\n\t\tif (!owner) continue;\n\t\tconst existing = bySurface.get(owner);\n\t\tif (existing) existing.push(endpoint);\n\t\telse bySurface.set(owner, [endpoint]);\n\t}\n\n\tif (bySurface.size === 0) {\n\t\tlogger.log('No endpoints named a surface, so no OpenAPI was generated');\n\t\treturn null;\n\t}\n\n\tconst tsGenerator = new OpenApiTsGenerator();\n\tconst written: string[] = [];\n\n\tfor (const [surfaceId, surfaceEndpoints] of bySurface) {\n\t\tconst relative = openApiPathFor(surfaceId);\n\t\tconst outputPath = join(root, relative);\n\n\t\tawait mkdir(dirname(outputPath), { recursive: true });\n\n\t\tconst tsContent = await tsGenerator.generate(surfaceEndpoints, {\n\t\t\t// The surface's own name, so a spec says which API it describes\n\t\t\t// rather than repeating one title across all of them.\n\t\t\ttitle: openApiConfig.title ?? surfaceId,\n\t\t\tversion: openApiConfig.version!,\n\t\t\tdescription: openApiConfig.description!,\n\t\t\t...(options.telemetry !== undefined\n\t\t\t\t? { telemetry: options.telemetry }\n\t\t\t\t: {}),\n\t\t});\n\n\t\tawait writeFile(outputPath, tsContent);\n\t\twritten.push(relative);\n\t\tlogger.log(\n\t\t\t`📄 OpenAPI client generated: ${relativePath(process.cwd(), outputPath)} (${surfaceEndpoints.length} endpoints)`,\n\t\t);\n\t}\n\n\treturn {\n\t\t// The first, for a caller that wants one path. `outputPaths` has them all.\n\t\toutputPath: join(root, written[0]!),\n\t\toutputPaths: written.map((r) => join(root, r)),\n\t\tendpointCount: endpoints.length,\n\t};\n}\n\nexport async function openapiCommand(\n\toptions: OpenAPIOptions = {},\n): Promise<void> {\n\tconst logger = console;\n\n\ttry {\n\t\tconst loadedConfig = await loadWorkspaceConfig(options.cwd);\n\n\t\tif (loadedConfig.type === 'single') {\n\t\t\t// Single-app config - use existing behavior\n\t\t\tconst config = loadedConfig.raw as GkmConfig;\n\n\t\t\t// Enable openapi if not configured\n\t\t\tif (!config.openapi) {\n\t\t\t\tconfig.openapi = { enabled: true };\n\t\t\t}\n\n\t\t\tconst result = await generateOpenApiFrom(config.constructs, {\n\t\t\t\topenapi: config.openapi,\n\t\t\t\troot: loadedConfig.workspace.root,\n\t\t\t\t...(options.telemetry !== undefined\n\t\t\t\t\t? { telemetry: options.telemetry }\n\t\t\t\t\t: {}),\n\t\t\t});\n\n\t\t\tif (result) {\n\t\t\t\tlogger.log(`Found ${result.endpointCount} endpoints`);\n\t\t\t}\n\t\t} else {\n\t\t\t// Workspace config - generate for each backend app\n\t\t\tconst { workspace } = loadedConfig;\n\t\t\t// Always derive the workspace root from the loaded config rather than\n\t\t\t// CWD. Subprocesses run with CWD set to an app directory, and falling\n\t\t\t// back to CWD there causes `join(workspaceRoot, app.path)` to point at\n\t\t\t// a non-existent nested path (e.g. `apps/api/apps/api`).\n\t\t\tconst workspaceRoot = workspace.root;\n\n\t\t\t// Backend apps with openapi enabled — which is all of them that have\n\t\t\t// routes, unless one says otherwise.\n\t\t\t//\n\t\t\t// This used to require `openapi: true` written out, while the app's\n\t\t\t// own build generated a spec regardless. Two paths disagreeing about\n\t\t\t// the same flag: the app emitted `.gkm/openapi.ts` and this pass,\n\t\t\t// finding nothing \"enabled\", skipped copying it to the frontends that\n\t\t\t// consume it. A surface whose routes are declared rather than\n\t\t\t// discovered has no spec to generate, so it is not a candidate.\n\t\t\tconst backendApps = Object.entries(workspace.apps).filter(\n\t\t\t\t([_, app]) =>\n\t\t\t\t\tapp.type === 'backend' &&\n\t\t\t\t\tapp.openapi !== false &&\n\t\t\t\t\t(typeof app.openapi !== 'object' || app.openapi.enabled !== false),\n\t\t\t);\n\n\t\t\tif (backendApps.length === 0) {\n\t\t\t\tlogger.log('No backend apps with OpenAPI enabled found');\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Single-app mode: generate in-process. The caller is expected to\n\t\t\t// have CWD set to the app's directory (e.g., when invoked as a\n\t\t\t// subprocess), so tsx picks up the app's tsconfig path aliases.\n\t\t\tif (options.app) {\n\t\t\t\tconst entry = backendApps.find(([name]) => name === options.app);\n\t\t\t\tif (!entry) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`App \"${options.app}\" not found or has OpenAPI disabled`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst [appName, app] = entry;\n\t\t\t\tconst result = await generateOpenApiForApp(\n\t\t\t\t\tworkspace,\n\t\t\t\t\tappName,\n\t\t\t\t\tapp,\n\t\t\t\t\ttrue,\n\t\t\t\t\toptions.telemetry,\n\t\t\t\t);\n\t\t\t\tif (result) {\n\t\t\t\t\tlogger.log(\n\t\t\t\t\t\t`📄 [${appName}] Generated OpenAPI (${result.endpointCount} endpoints)`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Multi-app mode: spawn a subprocess per backend app. Each\n\t\t\t// subprocess starts with CWD at the app's directory so that\n\t\t\t// tsx's tsconfig discovery picks up the app's `paths` aliases\n\t\t\t// (e.g., `~/*`) instead of the workspace root's tsconfig.\n\t\t\tfor (const [appName, app] of backendApps) {\n\t\t\t\t// No `app.routes` check any more: the per-kind globs are gone, and\n\t\t\t\t// an app's code is found by one glob rather than by a field naming\n\t\t\t\t// endpoints. Guarding on `routes` here meant every app was skipped\n\t\t\t\t// the moment that field stopped existing — silently, because a loop\n\t\t\t\t// that runs zero times looks exactly like one with nothing to do.\n\t\t\t\tconst appPath = join(workspaceRoot, app.path);\n\n\t\t\t\t// A subprocess exists to put CWD inside the app, so tsx picks up\n\t\t\t\t// that app's tsconfig aliases instead of the workspace root's. When\n\t\t\t\t// the app *is* the root there is nothing to change: spawning would\n\t\t\t\t// re-enter the same directory, having paid for a process and a\n\t\t\t\t// module graph, and needing `tsx` resolvable from it.\n\t\t\t\tif (resolve(appPath) === resolve(workspaceRoot)) {\n\t\t\t\t\t// Not silent: silence is for a subprocess whose output the\n\t\t\t\t\t// parent relays, and there is no parent here to relay it. The\n\t\t\t\t\t// per-surface lines come from the generator; the count is this\n\t\t\t\t\t// command's own summary, as in the single-app path.\n\t\t\t\t\tconst result = await generateOpenApiForApp(\n\t\t\t\t\t\tworkspace,\n\t\t\t\t\t\tappName,\n\t\t\t\t\t\tapp,\n\t\t\t\t\t\tfalse,\n\t\t\t\t\t\toptions.telemetry,\n\t\t\t\t\t);\n\t\t\t\t\tif (result) {\n\t\t\t\t\t\tlogger.log(`Found ${result.endpointCount} endpoints`);\n\t\t\t\t\t}\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tawait runOpenApiInSubprocess(appPath, appName, options.telemetry);\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tthrow new Error(`OpenAPI generation failed: ${(error as Error).message}`);\n\t}\n}\n\n/**\n * Generate OpenAPI for a single named app within a workspace.\n * Runs in-process. The caller is responsible for ensuring `process.cwd()`\n * is the app's directory so tsx loads the app's tsconfig path aliases.\n *\n * The endpoints are found the way the app's build finds them — through the\n * workspace's constructs globs — never by importing every `.ts` under the app,\n * which loaded its tests and gkm's own generated files with them.\n */\nasync function generateOpenApiForApp(\n\tworkspace: NormalizedWorkspace,\n\tappName: string,\n\tapp: NormalizedAppConfig,\n\t/**\n\t * Quiet by default, because the usual caller is a subprocess whose output\n\t * the parent relays. Generating in-process there is no parent to relay to,\n\t * and silence would swallow the only report of what happened.\n\t */\n\tsilent = true,\n\ttelemetry?: ClientTelemetryDefault,\n): Promise<{ outputPath: string; endpointCount: number } | null> {\n\tif (app.type !== 'backend') {\n\t\treturn null;\n\t}\n\n\tconst loaded = await new EndpointGenerator().load(\n\t\tappConstructGlobs(workspace, appName),\n\t);\n\n\t// The workspace's globs reach every app's code, so each app writes its own\n\t// surfaces' clients and no other's. An endpoint whose surface is no app of\n\t// this workspace's has nowhere else to go, and stays.\n\tconst endpoints = loaded\n\t\t.map(({ construct }) => construct)\n\t\t.filter((endpoint) => {\n\t\t\tconst owner = endpoint.owner ?? endpoint.surface?.id;\n\t\t\tif (!owner) return false;\n\t\t\tconst key = appKey(owner);\n\t\t\treturn key === appName || !workspace.apps[key];\n\t\t});\n\n\treturn generateOpenApi(endpoints, {\n\t\t// Absent means enabled, which is what the caller's filter already decided\n\t\t// when it kept this app: it skips one that says `openapi: false` and keeps\n\t\t// every other. Passing `undefined` through let `resolveOpenApiConfig`\n\t\t// default it to *disabled*, so an app selected for generation generated\n\t\t// nothing and said nothing — two places disagreeing about one flag, which\n\t\t// is the failure the filter above was written to describe.\n\t\topenapi: app.openapi ?? { enabled: true },\n\t\tsilent,\n\t\troot: workspace.root,\n\t\t...(telemetry !== undefined ? { telemetry } : {}),\n\t});\n}\n\n/**\n * Resolve the gkm bin path. Tests can override via `GKM_BIN_PATH` env var\n * to avoid depending on the built dist.\n */\nfunction resolveGkmBinPath(): string {\n\tif (process.env.GKM_BIN_PATH) {\n\t\treturn process.env.GKM_BIN_PATH;\n\t}\n\treturn fileURLToPath(new URL('../bin/gkm.mjs', import.meta.url));\n}\n\n/**\n * Spawn a subprocess that runs `gkm openapi --app <name>` with `cwd` set to\n * the app's directory. Inherits `NODE_OPTIONS` (which already contains\n * `--import tsx`), so the child gets a fresh tsx instance whose tsconfig\n * discovery picks up the app's tsconfig path aliases.\n */\nasync function runOpenApiInSubprocess(\n\tappCwd: string,\n\tappName: string,\n\ttelemetry?: ClientTelemetryDefault,\n): Promise<void> {\n\tconst binPath = resolveGkmBinPath();\n\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst child = spawn(\n\t\t\tprocess.execPath,\n\t\t\t[binPath, 'openapi', '--app', appName, ...telemetryArgs(telemetry)],\n\t\t\t{\n\t\t\t\tcwd: appCwd,\n\t\t\t\tstdio: 'inherit',\n\t\t\t\tenv: process.env,\n\t\t\t},\n\t\t);\n\n\t\tchild.on('error', reject);\n\t\tchild.on('close', (code) => {\n\t\t\tif (code === 0) {\n\t\t\t\tresolve();\n\t\t\t} else {\n\t\t\t\treject(\n\t\t\t\t\tnew Error(\n\t\t\t\t\t\t`OpenAPI generation for app \"${appName}\" exited with code ${code}`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t});\n\t});\n}\n"],"mappings":"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"}
@@ -1,4 +1,5 @@
1
- import { a as Routes, i as OpenApiConfig } from "./types-N7c2O2m7.cjs";
1
+ import { a as Routes, i as OpenApiConfig } from "./types-BvokH0ya.cjs";
2
+ import { n as parseTelemetryFlag, t as ClientTelemetryDefault } from "./clientTelemetry-DXuYNH-J.cjs";
2
3
  import { Endpoint } from "@geekmidas/constructs/endpoints";
3
4
  //#region src/openapi.d.ts
4
5
  interface OpenAPIOptions {
@@ -10,17 +11,19 @@ interface OpenAPIOptions {
10
11
  * fresh tsx that loads the app's own tsconfig (path aliases included).
11
12
  */
12
13
  app?: string;
14
+ /**
15
+ * Trace propagation in the clients written, off when absent — see
16
+ * {@link ClientTelemetryDefault}. `gkm openapi --telemetry [rate]`.
17
+ */
18
+ telemetry?: ClientTelemetryDefault;
13
19
  }
14
20
  /**
15
- * Default output path for generated OpenAPI client (used for single-app configs)
16
- */
17
- export declare const OPENAPI_OUTPUT_PATH = "./.gkm/openapi.ts";
18
- /**
19
- * Where a surface's generated client lands.
21
+ * Where a surface's generated client lands, under the workspace root.
20
22
  *
21
23
  * Named from the surface, so `new RestApi('Webhooks')` writes
22
- * `.gkm/openapi/webhooks.ts` — the same kebab form that gives it its container
23
- * name and its `WEBHOOKS_URL`.
24
+ * `.gkm/client/webhooks.ts` — the same kebab form that gives it its container
25
+ * name and its `WEBHOOKS_URL` — and a site imports it as
26
+ * `@<name>/client/webhooks`, through the alias its tsconfig maps.
24
27
  */
25
28
  export declare function openApiPathFor(surfaceId: string): string;
26
29
  /**
@@ -51,6 +54,8 @@ export declare function generateOpenApiFrom(routes: Routes, options?: {
51
54
  openapi?: boolean | OpenApiConfig;
52
55
  silent?: boolean;
53
56
  bustCache?: boolean;
57
+ root?: string;
58
+ telemetry?: ClientTelemetryDefault;
54
59
  }): Promise<OpenApiResult | null>;
55
60
  /**
56
61
  * Generate an OpenAPI spec for each surface these endpoints name.
@@ -66,7 +71,21 @@ export declare function generateOpenApiFrom(routes: Routes, options?: {
66
71
  export declare function generateOpenApi(endpoints: readonly Endpoint<any, any, any, any, any>[], options?: {
67
72
  openapi?: boolean | OpenApiConfig;
68
73
  silent?: boolean;
74
+ /**
75
+ * The workspace root, whose `.gkm/client/` holds every surface's client.
76
+ * The client is the application's, like its manifest — a site reaches it
77
+ * as `@<name>/client/<surface>` — so it is written there whichever
78
+ * directory the build happened to run in.
79
+ */
80
+ root?: string;
81
+ /**
82
+ * Whether the clients written propagate trace context by default. Off
83
+ * when absent: the integration point for a site's edge to a
84
+ * `Telemetry` construct, which decides it for the clients it imports.
85
+ */
86
+ telemetry?: ClientTelemetryDefault;
69
87
  }): Promise<OpenApiResult | null>;
70
88
  export declare function openapiCommand(options?: OpenAPIOptions): Promise<void>;
71
89
  //#endregion
90
+ export { parseTelemetryFlag };
72
91
  //# sourceMappingURL=openapi.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"openapi.d.cts","names":[],"sources":["../src/openapi.ts"],"mappings":";;;UAeU;EACT;;;;;;;EAOA;;;;;qBAMY;;;;;;;;wBASG,eAAe;;;;wBAOf,qBAAqB;EACpC,oBAAoB;IACjB;EAAkB;;;iBA0BL;;EAEhB;;EAEA;;EAEA;;;;;;;;;wBAUqB,oBACrB,QAAQ,QACR;EACC,oBAAoB;EACpB;EACA;IAEC,QAAQ;;;;;;;;;;;;wBAwBW,gBACrB,oBAAoB,qCACpB;EACC,oBAAoB;EACpB;IAEC,QAAQ;wBAmEW,eACrB,UAAS,iBACP"}
1
+ {"version":3,"file":"openapi.d.cts","names":[],"sources":["../src/openapi.ts"],"mappings":";;;;UAwBU;EACT;;;;;;;EAOA;;;;;EAKA,YAAY;;;;;;;;;;wBAWG,eAAe;;;;wBAOf,qBAAqB;EACpC,oBAAoB;IACjB;EAAkB;;;iBA0BL;;EAEhB;;EAEA;;EAEA;;;;;;;;;wBAUqB,oBACrB,QAAQ,QACR;EACC,oBAAoB;EACpB;EACA;EACA;EACA,YAAY;IAEX,QAAQ;;;;;;;;;;;;wBAwBW,gBACrB,oBAAoB,qCACpB;EACC,oBAAoB;EACpB;;;;;;;EAOA;;;;;;EAMA,YAAY;IAEX,QAAQ;wBAuEW,eACrB,UAAS,iBACP"}
@@ -1,4 +1,5 @@
1
- import { a as Routes, i as OpenApiConfig } from "./types-7R81hu0i.mjs";
1
+ import { a as Routes, i as OpenApiConfig } from "./types-DmLnGeii.mjs";
2
+ import { n as parseTelemetryFlag, t as ClientTelemetryDefault } from "./clientTelemetry-eC8VQ6nB.mjs";
2
3
  import { Endpoint } from "@geekmidas/constructs/endpoints";
3
4
  //#region src/openapi.d.ts
4
5
  interface OpenAPIOptions {
@@ -10,17 +11,19 @@ interface OpenAPIOptions {
10
11
  * fresh tsx that loads the app's own tsconfig (path aliases included).
11
12
  */
12
13
  app?: string;
14
+ /**
15
+ * Trace propagation in the clients written, off when absent — see
16
+ * {@link ClientTelemetryDefault}. `gkm openapi --telemetry [rate]`.
17
+ */
18
+ telemetry?: ClientTelemetryDefault;
13
19
  }
14
20
  /**
15
- * Default output path for generated OpenAPI client (used for single-app configs)
16
- */
17
- export declare const OPENAPI_OUTPUT_PATH = "./.gkm/openapi.ts";
18
- /**
19
- * Where a surface's generated client lands.
21
+ * Where a surface's generated client lands, under the workspace root.
20
22
  *
21
23
  * Named from the surface, so `new RestApi('Webhooks')` writes
22
- * `.gkm/openapi/webhooks.ts` — the same kebab form that gives it its container
23
- * name and its `WEBHOOKS_URL`.
24
+ * `.gkm/client/webhooks.ts` — the same kebab form that gives it its container
25
+ * name and its `WEBHOOKS_URL` — and a site imports it as
26
+ * `@<name>/client/webhooks`, through the alias its tsconfig maps.
24
27
  */
25
28
  export declare function openApiPathFor(surfaceId: string): string;
26
29
  /**
@@ -51,6 +54,8 @@ export declare function generateOpenApiFrom(routes: Routes, options?: {
51
54
  openapi?: boolean | OpenApiConfig;
52
55
  silent?: boolean;
53
56
  bustCache?: boolean;
57
+ root?: string;
58
+ telemetry?: ClientTelemetryDefault;
54
59
  }): Promise<OpenApiResult | null>;
55
60
  /**
56
61
  * Generate an OpenAPI spec for each surface these endpoints name.
@@ -66,7 +71,21 @@ export declare function generateOpenApiFrom(routes: Routes, options?: {
66
71
  export declare function generateOpenApi(endpoints: readonly Endpoint<any, any, any, any, any>[], options?: {
67
72
  openapi?: boolean | OpenApiConfig;
68
73
  silent?: boolean;
74
+ /**
75
+ * The workspace root, whose `.gkm/client/` holds every surface's client.
76
+ * The client is the application's, like its manifest — a site reaches it
77
+ * as `@<name>/client/<surface>` — so it is written there whichever
78
+ * directory the build happened to run in.
79
+ */
80
+ root?: string;
81
+ /**
82
+ * Whether the clients written propagate trace context by default. Off
83
+ * when absent: the integration point for a site's edge to a
84
+ * `Telemetry` construct, which decides it for the clients it imports.
85
+ */
86
+ telemetry?: ClientTelemetryDefault;
69
87
  }): Promise<OpenApiResult | null>;
70
88
  export declare function openapiCommand(options?: OpenAPIOptions): Promise<void>;
71
89
  //#endregion
90
+ export { parseTelemetryFlag };
72
91
  //# sourceMappingURL=openapi.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"openapi.d.mts","names":[],"sources":["../src/openapi.ts"],"mappings":";;;UAeU;EACT;;;;;;;EAOA;;;;;qBAMY;;;;;;;;wBASG,eAAe;;;;wBAOf,qBAAqB;EACpC,oBAAoB;IACjB;EAAkB;;;iBA0BL;;EAEhB;;EAEA;;EAEA;;;;;;;;;wBAUqB,oBACrB,QAAQ,QACR;EACC,oBAAoB;EACpB;EACA;IAEC,QAAQ;;;;;;;;;;;;wBAwBW,gBACrB,oBAAoB,qCACpB;EACC,oBAAoB;EACpB;IAEC,QAAQ;wBAmEW,eACrB,UAAS,iBACP"}
1
+ {"version":3,"file":"openapi.d.mts","names":[],"sources":["../src/openapi.ts"],"mappings":";;;;UAwBU;EACT;;;;;;;EAOA;;;;;EAKA,YAAY;;;;;;;;;;wBAWG,eAAe;;;;wBAOf,qBAAqB;EACpC,oBAAoB;IACjB;EAAkB;;;iBA0BL;;EAEhB;;EAEA;;EAEA;;;;;;;;;wBAUqB,oBACrB,QAAQ,QACR;EACC,oBAAoB;EACpB;EACA;EACA;EACA,YAAY;IAEX,QAAQ;;;;;;;;;;;;wBAwBW,gBACrB,oBAAoB,qCACpB;EACC,oBAAoB;EACpB;;;;;;;EAOA;;;;;;EAMA,YAAY;IAEX,QAAQ;wBAuEW,eACrB,UAAS,iBACP"}