@geekmidas/cli 10.0.0-alpha.98 → 10.0.0

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 (684) hide show
  1. package/CHANGELOG.md +667 -0
  2. package/FUNCTION_CRON_SUPPORT.md +266 -0
  3. package/README.md +533 -382
  4. package/bin/gkm.mjs +2 -16
  5. package/dist/CachedStateProvider-BdX7klRc.cjs +3 -0
  6. package/dist/CachedStateProvider-CzyFct42.mjs +54 -0
  7. package/dist/CachedStateProvider-CzyFct42.mjs.map +1 -0
  8. package/dist/CachedStateProvider-GcGziXh1.mjs +3 -0
  9. package/dist/CachedStateProvider-klLWZXWF.cjs +60 -0
  10. package/dist/CachedStateProvider-klLWZXWF.cjs.map +1 -0
  11. package/dist/{HostingerProvider-BNpS9aRJ.mjs → HostingerProvider-B2ZYz7Yc.mjs} +26 -31
  12. package/dist/HostingerProvider-B2ZYz7Yc.mjs.map +1 -0
  13. package/dist/{HostingerProvider-DR1iws1P.cjs → HostingerProvider-CrHfsgz9.cjs} +26 -31
  14. package/dist/HostingerProvider-CrHfsgz9.cjs.map +1 -0
  15. package/dist/LocalStateProvider-CP49rjzt.mjs +42 -0
  16. package/dist/LocalStateProvider-CP49rjzt.mjs.map +1 -0
  17. package/dist/LocalStateProvider-CalzNfNA.cjs +43 -0
  18. package/dist/LocalStateProvider-CalzNfNA.cjs.map +1 -0
  19. package/dist/{Route53Provider-Bllus2NR.cjs → Route53Provider-DwgXiLxt.cjs} +22 -21
  20. package/dist/Route53Provider-DwgXiLxt.cjs.map +1 -0
  21. package/dist/{Route53Provider-QXxjkZO1.mjs → Route53Provider-tlgBzrRQ.mjs} +13 -13
  22. package/dist/Route53Provider-tlgBzrRQ.mjs.map +1 -0
  23. package/dist/SSMStateProvider-BlrTiV5m.mjs +66 -0
  24. package/dist/SSMStateProvider-BlrTiV5m.mjs.map +1 -0
  25. package/dist/SSMStateProvider-Bt6r8CTL.cjs +66 -0
  26. package/dist/SSMStateProvider-Bt6r8CTL.cjs.map +1 -0
  27. package/dist/{backup-provisioner-oDEsPj02.cjs → backup-provisioner-B3HBN-2k.cjs} +20 -22
  28. package/dist/backup-provisioner-B3HBN-2k.cjs.map +1 -0
  29. package/dist/{backup-provisioner-C8DnCmxK.mjs → backup-provisioner-Xunq-p_8.mjs} +9 -12
  30. package/dist/backup-provisioner-Xunq-p_8.mjs.map +1 -0
  31. package/dist/bundler-DkA4qzUD.mjs +135 -0
  32. package/dist/bundler-DkA4qzUD.mjs.map +1 -0
  33. package/dist/bundler-Dufq3uvI.cjs +136 -0
  34. package/dist/bundler-Dufq3uvI.cjs.map +1 -0
  35. package/dist/{rolldown-runtime-C0BPl7ul.cjs → chunk-CUT6urMc.cjs} +10 -23
  36. package/dist/chunk-Duj1WY3L.mjs +7 -0
  37. package/dist/config-Bbu1JKvf.mjs +211 -0
  38. package/dist/config-Bbu1JKvf.mjs.map +1 -0
  39. package/dist/config-DujV8DbR.cjs +253 -0
  40. package/dist/config-DujV8DbR.cjs.map +1 -0
  41. package/dist/config.cjs +10 -421
  42. package/dist/config.d.cts +120 -4
  43. package/dist/config.d.cts.map +1 -0
  44. package/dist/config.d.mts +120 -4
  45. package/dist/config.d.mts.map +1 -0
  46. package/dist/config.mjs +3 -405
  47. package/dist/credentials-C8DWtnMY.cjs +174 -0
  48. package/dist/credentials-C8DWtnMY.cjs.map +1 -0
  49. package/dist/credentials-s1kLcIzK.mjs +126 -0
  50. package/dist/credentials-s1kLcIzK.mjs.map +1 -0
  51. package/dist/deploy/sniffer-envkit-patch.cjs +10 -18
  52. package/dist/deploy/sniffer-envkit-patch.cjs.map +1 -1
  53. package/dist/deploy/sniffer-envkit-patch.d.cts +2 -0
  54. package/dist/deploy/sniffer-envkit-patch.d.cts.map +1 -1
  55. package/dist/deploy/sniffer-envkit-patch.d.mts +2 -0
  56. package/dist/deploy/sniffer-envkit-patch.d.mts.map +1 -1
  57. package/dist/deploy/sniffer-envkit-patch.mjs +2 -10
  58. package/dist/deploy/sniffer-envkit-patch.mjs.map +1 -1
  59. package/dist/deploy/sniffer-hooks.cjs +7 -13
  60. package/dist/deploy/sniffer-hooks.cjs.map +1 -1
  61. package/dist/deploy/sniffer-hooks.d.cts +2 -1
  62. package/dist/deploy/sniffer-hooks.d.cts.map +1 -1
  63. package/dist/deploy/sniffer-hooks.d.mts +2 -1
  64. package/dist/deploy/sniffer-hooks.d.mts.map +1 -1
  65. package/dist/deploy/sniffer-hooks.mjs +3 -10
  66. package/dist/deploy/sniffer-hooks.mjs.map +1 -1
  67. package/dist/deploy/sniffer-loader.cjs +7 -16
  68. package/dist/deploy/sniffer-loader.cjs.map +1 -1
  69. package/dist/deploy/sniffer-loader.d.cts +1 -1
  70. package/dist/deploy/sniffer-loader.d.mts +1 -1
  71. package/dist/deploy/sniffer-loader.mjs +3 -14
  72. package/dist/deploy/sniffer-loader.mjs.map +1 -1
  73. package/dist/deploy/sniffer-routes-worker.cjs +13 -17
  74. package/dist/deploy/sniffer-routes-worker.cjs.map +1 -1
  75. package/dist/deploy/sniffer-routes-worker.d.cts +1 -1
  76. package/dist/deploy/sniffer-routes-worker.d.mts +1 -1
  77. package/dist/deploy/sniffer-routes-worker.mjs +6 -10
  78. package/dist/deploy/sniffer-routes-worker.mjs.map +1 -1
  79. package/dist/deploy/sniffer-worker.cjs +6 -15
  80. package/dist/deploy/sniffer-worker.cjs.map +1 -1
  81. package/dist/deploy/sniffer-worker.d.cts +3 -1
  82. package/dist/deploy/sniffer-worker.d.cts.map +1 -1
  83. package/dist/deploy/sniffer-worker.d.mts +3 -1
  84. package/dist/deploy/sniffer-worker.d.mts.map +1 -1
  85. package/dist/deploy/sniffer-worker.mjs +4 -15
  86. package/dist/deploy/sniffer-worker.mjs.map +1 -1
  87. package/dist/dokploy-api-BPYkG-ZZ.cjs +3 -0
  88. package/dist/dokploy-api-BiSzWM4v.mjs +3 -0
  89. package/dist/dokploy-api-CqOIKHme.cjs +609 -0
  90. package/dist/dokploy-api-CqOIKHme.cjs.map +1 -0
  91. package/dist/dokploy-api-sfZFlWuE.mjs +597 -0
  92. package/dist/dokploy-api-sfZFlWuE.mjs.map +1 -0
  93. package/dist/encryption-BVS7Vmzs.cjs +4 -0
  94. package/dist/encryption-Bd_m4q3g.mjs +3 -0
  95. package/dist/encryption-CO5Q4Bhf.mjs +42 -0
  96. package/dist/encryption-CO5Q4Bhf.mjs.map +1 -0
  97. package/dist/encryption-MfXAiFTm.cjs +54 -0
  98. package/dist/encryption-MfXAiFTm.cjs.map +1 -0
  99. package/dist/fullstack-secrets-BYzi6Hwl.cjs +402 -0
  100. package/dist/fullstack-secrets-BYzi6Hwl.cjs.map +1 -0
  101. package/dist/fullstack-secrets-l8s3II_H.mjs +336 -0
  102. package/dist/fullstack-secrets-l8s3II_H.mjs.map +1 -0
  103. package/dist/index-CoVW_fFS.d.cts +1737 -0
  104. package/dist/index-CoVW_fFS.d.cts.map +1 -0
  105. package/dist/index-oWibAYQY.d.mts +1737 -0
  106. package/dist/index-oWibAYQY.d.mts.map +1 -0
  107. package/dist/index.cjs +11337 -10263
  108. package/dist/index.cjs.map +1 -1
  109. package/dist/index.d.cts +1 -1
  110. package/dist/index.d.mts +1 -1
  111. package/dist/index.mjs +11303 -10217
  112. package/dist/index.mjs.map +1 -1
  113. package/dist/openapi-BzNOC7_i.cjs +1931 -0
  114. package/dist/openapi-BzNOC7_i.cjs.map +1 -0
  115. package/dist/openapi-Cfwi0fqF.mjs +1883 -0
  116. package/dist/openapi-Cfwi0fqF.mjs.map +1 -0
  117. package/dist/openapi-react-query-C4iIvpPf.mjs +167 -0
  118. package/dist/openapi-react-query-C4iIvpPf.mjs.map +1 -0
  119. package/dist/openapi-react-query-CYWik72n.cjs +173 -0
  120. package/dist/openapi-react-query-CYWik72n.cjs.map +1 -0
  121. package/dist/openapi-react-query.cjs +4 -0
  122. package/dist/openapi-react-query.d.cts +11 -0
  123. package/dist/openapi-react-query.d.cts.map +1 -0
  124. package/dist/openapi-react-query.d.mts +11 -0
  125. package/dist/openapi-react-query.d.mts.map +1 -0
  126. package/dist/openapi-react-query.mjs +4 -0
  127. package/dist/openapi.cjs +7 -214
  128. package/dist/openapi.d.cts +15 -72
  129. package/dist/openapi.d.cts.map +1 -1
  130. package/dist/openapi.d.mts +15 -72
  131. package/dist/openapi.d.mts.map +1 -1
  132. package/dist/openapi.mjs +4 -208
  133. package/dist/{reconcile--I7V4Klj.mjs → reconcile-B2FoJE0a.mjs} +8 -6
  134. package/dist/reconcile-B2FoJE0a.mjs.map +1 -0
  135. package/dist/{reconcile-CuCQBa5-.cjs → reconcile-BzqKJ2Rt.cjs} +8 -6
  136. package/dist/reconcile-BzqKJ2Rt.cjs.map +1 -0
  137. package/dist/setup-DDXUXzzl.mjs +765 -0
  138. package/dist/setup-DDXUXzzl.mjs.map +1 -0
  139. package/dist/setup-DLwhfyt-.cjs +8 -0
  140. package/dist/setup-Dh-B7YTX.mjs +8 -0
  141. package/dist/setup-WZ-xqAQO.cjs +849 -0
  142. package/dist/setup-WZ-xqAQO.cjs.map +1 -0
  143. package/dist/storage-B1wvztiJ.cjs +363 -0
  144. package/dist/storage-B1wvztiJ.cjs.map +1 -0
  145. package/dist/storage-Cs4WBsc4.mjs +3 -0
  146. package/dist/storage-DOEtT2Hr.cjs +7 -0
  147. package/dist/storage-dbb9RyBl.mjs +297 -0
  148. package/dist/storage-dbb9RyBl.mjs.map +1 -0
  149. package/dist/sync-B5UHXwRM.mjs +3 -0
  150. package/dist/sync-BLA94rgC.cjs +4 -0
  151. package/dist/sync-CSooqRQ8.mjs +76 -0
  152. package/dist/sync-CSooqRQ8.mjs.map +1 -0
  153. package/dist/sync-o_CtEbvR.cjs +93 -0
  154. package/dist/sync-o_CtEbvR.cjs.map +1 -0
  155. package/dist/types-B3GQUg3k.d.mts +280 -0
  156. package/dist/types-B3GQUg3k.d.mts.map +1 -0
  157. package/dist/types-BWQDiooe.d.cts +280 -0
  158. package/dist/types-BWQDiooe.d.cts.map +1 -0
  159. package/dist/workspace/index.cjs +4 -12
  160. package/dist/workspace/index.d.cts +3 -3
  161. package/dist/workspace/index.d.mts +3 -3
  162. package/dist/workspace/index.mjs +3 -2
  163. package/dist/workspace-CQTT7HJQ.cjs +4361 -0
  164. package/dist/workspace-CQTT7HJQ.cjs.map +1 -0
  165. package/dist/workspace-D-37Ylqo.mjs +4236 -0
  166. package/dist/workspace-D-37Ylqo.mjs.map +1 -0
  167. package/docs/OPENAPI_TYPESCRIPT_DESIGN.md +408 -0
  168. package/docs/dev-server-resilience-design.md +189 -0
  169. package/docs/manifest-refactor-design.md +287 -0
  170. package/examples/cron-example.ts +45 -0
  171. package/examples/env.ts +33 -0
  172. package/examples/function-example.ts +40 -0
  173. package/examples/gkm.config.json +22 -0
  174. package/examples/gkm.config.ts +14 -0
  175. package/examples/gkm.minimal.config.json +7 -0
  176. package/examples/gkm.production.config.json +27 -0
  177. package/examples/logger.ts +10 -0
  178. package/package.json +37 -87
  179. package/scripts/sync-versions.ts +108 -0
  180. package/src/__tests__/EndpointGenerator.hooks.spec.ts +204 -0
  181. package/src/__tests__/config.spec.ts +422 -0
  182. package/src/__tests__/loadEnvFiles.spec.ts +131 -0
  183. package/src/__tests__/normalizeHooksConfig.spec.ts +63 -0
  184. package/src/__tests__/openapi-react-query.spec.ts +506 -0
  185. package/src/__tests__/openapi.spec.ts +625 -0
  186. package/src/__tests__/test-helpers.ts +180 -0
  187. package/src/auth/__tests__/credentials.spec.ts +331 -0
  188. package/src/auth/__tests__/index.spec.ts +237 -0
  189. package/src/auth/credentials.ts +286 -0
  190. package/src/auth/index.ts +233 -0
  191. package/src/build/__tests__/bundler.spec.ts +446 -0
  192. package/src/build/__tests__/endpoint-analyzer.spec.ts +623 -0
  193. package/src/build/__tests__/handler-templates.spec.ts +1287 -0
  194. package/src/build/__tests__/index-new.spec.ts +550 -0
  195. package/src/build/__tests__/manifests.spec.ts +583 -0
  196. package/src/build/__tests__/partitions.spec.ts +110 -0
  197. package/src/build/__tests__/workspace-build.spec.ts +215 -0
  198. package/src/build/bundler.ts +256 -0
  199. package/src/build/endpoint-analyzer.ts +236 -0
  200. package/src/build/handler-templates.ts +1253 -0
  201. package/src/build/index.ts +616 -0
  202. package/src/build/manifests.ts +285 -0
  203. package/src/build/partitions.ts +58 -0
  204. package/src/build/providerResolver.ts +184 -0
  205. package/src/build/types.ts +104 -0
  206. package/src/config.ts +330 -0
  207. package/src/credentials/__tests__/fullDockerPorts.spec.ts +144 -0
  208. package/src/credentials/__tests__/helpers.ts +112 -0
  209. package/src/credentials/__tests__/prepareEntryCredentials.spec.ts +125 -0
  210. package/src/credentials/__tests__/readonlyDockerPorts.spec.ts +190 -0
  211. package/src/credentials/__tests__/workspaceCredentials.spec.ts +209 -0
  212. package/src/credentials/index.ts +843 -0
  213. package/src/debug.ts +68 -0
  214. package/src/deploy/CachedStateProvider.ts +86 -0
  215. package/src/deploy/LocalStateProvider.ts +57 -0
  216. package/src/deploy/SSMStateProvider.ts +117 -0
  217. package/src/deploy/StateProvider.ts +175 -0
  218. package/src/deploy/__tests__/CachedStateProvider.spec.ts +235 -0
  219. package/src/deploy/__tests__/HostingerProvider.spec.ts +347 -0
  220. package/src/deploy/__tests__/LocalStateProvider.spec.ts +130 -0
  221. package/src/deploy/__tests__/Route53Provider.spec.ts +425 -0
  222. package/src/deploy/__tests__/SSMStateProvider.spec.ts +201 -0
  223. package/src/deploy/__tests__/__fixtures__/entry-apps/async-entry.ts +24 -0
  224. package/src/deploy/__tests__/__fixtures__/entry-apps/nested-config-entry.ts +24 -0
  225. package/src/deploy/__tests__/__fixtures__/entry-apps/no-env-entry.ts +12 -0
  226. package/src/deploy/__tests__/__fixtures__/entry-apps/simple-entry.ts +14 -0
  227. package/src/deploy/__tests__/__fixtures__/entry-apps/throwing-entry.ts +16 -0
  228. package/src/deploy/__tests__/__fixtures__/env-parsers/non-function-export.ts +10 -0
  229. package/src/deploy/__tests__/__fixtures__/env-parsers/optional-env-parser.ts +21 -0
  230. package/src/deploy/__tests__/__fixtures__/env-parsers/parseable-env-parser.ts +18 -0
  231. package/src/deploy/__tests__/__fixtures__/env-parsers/throwing-env-parser.ts +16 -0
  232. package/src/deploy/__tests__/__fixtures__/env-parsers/valid-env-parser.ts +16 -0
  233. package/src/deploy/__tests__/__fixtures__/route-apps/endpoints/auth.ts +16 -0
  234. package/src/deploy/__tests__/__fixtures__/route-apps/endpoints/health.ts +13 -0
  235. package/src/deploy/__tests__/__fixtures__/route-apps/endpoints/users.ts +15 -0
  236. package/src/deploy/__tests__/__fixtures__/route-apps/services.ts +55 -0
  237. package/src/deploy/__tests__/backup-provisioner.spec.ts +428 -0
  238. package/src/deploy/__tests__/createDnsProvider.spec.ts +195 -0
  239. package/src/deploy/__tests__/createStateProvider.spec.ts +126 -0
  240. package/src/deploy/__tests__/dns-orchestration.spec.ts +192 -0
  241. package/src/deploy/__tests__/dns-verification.spec.ts +229 -0
  242. package/src/deploy/__tests__/docker.spec.ts +149 -0
  243. package/src/deploy/__tests__/dokploy-api.spec.ts +697 -0
  244. package/src/deploy/__tests__/dokploy.spec.ts +435 -0
  245. package/src/deploy/__tests__/domain.spec.ts +235 -0
  246. package/src/deploy/__tests__/env-resolver.spec.ts +903 -0
  247. package/src/deploy/__tests__/index.spec.ts +1091 -0
  248. package/src/deploy/__tests__/init.spec.ts +793 -0
  249. package/src/deploy/__tests__/secrets.spec.ts +303 -0
  250. package/src/deploy/__tests__/sniffer.spec.ts +838 -0
  251. package/src/deploy/__tests__/state-e2e.spec.ts +387 -0
  252. package/src/deploy/__tests__/state.spec.ts +876 -0
  253. package/src/deploy/__tests__/undeploy.spec.ts +758 -0
  254. package/src/deploy/backup-provisioner.ts +316 -0
  255. package/src/deploy/dns/DnsProvider.ts +201 -0
  256. package/src/deploy/dns/HostingerProvider.ts +174 -0
  257. package/src/deploy/dns/Route53Provider.ts +340 -0
  258. package/src/deploy/dns/hostinger-api.ts +261 -0
  259. package/src/deploy/dns/index.ts +627 -0
  260. package/src/deploy/docker.ts +260 -0
  261. package/src/deploy/dokploy-api.ts +1101 -0
  262. package/src/deploy/dokploy.ts +177 -0
  263. package/src/deploy/domain.ts +134 -0
  264. package/src/deploy/env-resolver.ts +305 -0
  265. package/src/deploy/index.ts +2094 -0
  266. package/src/deploy/init.ts +427 -0
  267. package/src/deploy/secrets.ts +187 -0
  268. package/src/deploy/sniffer-envkit-patch.ts +61 -0
  269. package/src/deploy/sniffer-hooks.ts +57 -0
  270. package/src/deploy/sniffer-loader.ts +28 -0
  271. package/src/deploy/sniffer-routes-worker.ts +104 -0
  272. package/src/deploy/sniffer-worker.ts +75 -0
  273. package/src/deploy/sniffer.ts +578 -0
  274. package/src/deploy/state-commands.ts +274 -0
  275. package/src/deploy/state.ts +482 -0
  276. package/src/deploy/types.ts +102 -0
  277. package/src/deploy/undeploy.ts +407 -0
  278. package/src/dev/__tests__/entry-integration.spec.ts +347 -0
  279. package/src/dev/__tests__/entry.spec.ts +144 -0
  280. package/src/dev/__tests__/index.spec.ts +2084 -0
  281. package/src/dev/index.ts +1649 -0
  282. package/src/docker/__tests__/compose.spec.ts +1142 -0
  283. package/src/docker/__tests__/templates.spec.ts +694 -0
  284. package/src/docker/compose.ts +812 -0
  285. package/src/docker/index.ts +523 -0
  286. package/src/docker/templates.ts +1067 -0
  287. package/src/exec/index.ts +118 -0
  288. package/src/generators/CronGenerator.ts +105 -0
  289. package/src/generators/EndpointGenerator.ts +954 -0
  290. package/src/generators/FunctionGenerator.ts +117 -0
  291. package/src/generators/Generator.ts +147 -0
  292. package/src/generators/OpenApiTsGenerator.ts +821 -0
  293. package/src/generators/QueueGenerator.ts +245 -0
  294. package/src/generators/SubscriberGenerator.ts +282 -0
  295. package/src/generators/TopicGenerator.ts +45 -0
  296. package/src/generators/__tests__/CronGenerator.spec.ts +445 -0
  297. package/src/generators/__tests__/EndpointGenerator.spec.ts +544 -0
  298. package/src/generators/__tests__/FunctionGenerator.spec.ts +256 -0
  299. package/src/generators/__tests__/Generator.bustCache.spec.ts +72 -0
  300. package/src/generators/__tests__/OpenApiTsGenerator.registry.spec.ts +98 -0
  301. package/src/generators/__tests__/OpenApiTsGenerator.responseType.spec.ts +56 -0
  302. package/src/generators/__tests__/QueueGenerator.spec.ts +141 -0
  303. package/src/generators/__tests__/SubscriberGenerator.spec.ts +410 -0
  304. package/src/generators/index.ts +11 -0
  305. package/src/index.ts +972 -0
  306. package/src/init/__tests__/generators.spec.ts +1072 -0
  307. package/src/init/__tests__/init.spec.ts +577 -0
  308. package/src/init/__tests__/utils.spec.ts +104 -0
  309. package/src/init/generators/auth.ts +225 -0
  310. package/src/init/generators/config.ts +316 -0
  311. package/src/init/generators/docker.ts +388 -0
  312. package/src/init/generators/env.ts +62 -0
  313. package/src/init/generators/index.ts +6 -0
  314. package/src/init/generators/mobile-expo.ts +576 -0
  315. package/src/init/generators/models.ts +153 -0
  316. package/src/init/generators/monorepo.ts +475 -0
  317. package/src/init/generators/package.ts +95 -0
  318. package/src/init/generators/source.ts +15 -0
  319. package/src/init/generators/test.ts +178 -0
  320. package/src/init/generators/ui.ts +1473 -0
  321. package/src/init/generators/web-tanstack.ts +348 -0
  322. package/src/init/generators/web.ts +363 -0
  323. package/src/init/index.ts +542 -0
  324. package/src/init/templates/api.ts +404 -0
  325. package/src/init/templates/index.ts +342 -0
  326. package/src/init/templates/minimal.ts +207 -0
  327. package/src/init/templates/serverless.ts +148 -0
  328. package/src/init/templates/worker.ts +216 -0
  329. package/src/init/utils.ts +197 -0
  330. package/src/init/versions.ts +52 -0
  331. package/src/openapi-react-query.ts +288 -0
  332. package/src/openapi.ts +259 -0
  333. package/src/secrets/__tests__/encryption.spec.ts +226 -0
  334. package/src/secrets/__tests__/generator.spec.ts +575 -0
  335. package/src/secrets/__tests__/index.spec.ts +91 -0
  336. package/src/secrets/__tests__/reconcile.spec.ts +123 -0
  337. package/src/secrets/__tests__/storage.spec.ts +645 -0
  338. package/src/secrets/encryption.ts +91 -0
  339. package/src/secrets/generator.ts +329 -0
  340. package/src/secrets/index.ts +417 -0
  341. package/src/secrets/keystore.ts +144 -0
  342. package/src/secrets/reconcile.ts +53 -0
  343. package/src/secrets/storage.ts +337 -0
  344. package/src/secrets/sync.ts +136 -0
  345. package/src/secrets/types.ts +70 -0
  346. package/src/setup/__tests__/auto-setup.spec.ts +147 -0
  347. package/src/setup/__tests__/reconcile-secrets.spec.ts +439 -0
  348. package/src/setup/fullstack-secrets.ts +140 -0
  349. package/src/setup/index.ts +411 -0
  350. package/src/test/__tests__/__fixtures__/workspace.ts +104 -0
  351. package/src/test/__tests__/api.spec.ts +199 -0
  352. package/src/test/__tests__/auth.spec.ts +162 -0
  353. package/src/test/__tests__/index.spec.ts +502 -0
  354. package/src/test/__tests__/web.spec.ts +210 -0
  355. package/src/test/index.ts +198 -0
  356. package/src/types.ts +363 -0
  357. package/src/upgrade/__tests__/index.spec.ts +354 -0
  358. package/src/upgrade/index.ts +253 -0
  359. package/src/workspace/__tests__/client-generator.spec.ts +326 -0
  360. package/src/workspace/__tests__/index.spec.ts +766 -0
  361. package/src/workspace/__tests__/publicEnv.spec.ts +64 -0
  362. package/src/workspace/__tests__/schema.spec.ts +737 -0
  363. package/src/workspace/__tests__/type-inference.spec.ts +251 -0
  364. package/src/workspace/client-generator.ts +109 -0
  365. package/src/workspace/index.ts +433 -0
  366. package/src/workspace/publicEnv.ts +57 -0
  367. package/src/workspace/schema.ts +861 -0
  368. package/src/workspace/types.ts +943 -0
  369. package/tsconfig.json +9 -0
  370. package/tsdown.config.ts +22 -0
  371. package/bin/adjacent-tsconfig.mjs +0 -97
  372. package/bin/owning-tsconfig-jsx-register.mjs +0 -18
  373. package/bin/owning-tsconfig-jsx.mjs +0 -108
  374. package/dist/EndpointGenerator-Bor2tZCm.mjs +0 -1031
  375. package/dist/EndpointGenerator-Bor2tZCm.mjs.map +0 -1
  376. package/dist/EndpointGenerator-De03t1hd.cjs +0 -1090
  377. package/dist/EndpointGenerator-De03t1hd.cjs.map +0 -1
  378. package/dist/GoDaddyProvider-C2fK-zeQ.mjs +0 -388
  379. package/dist/GoDaddyProvider-C2fK-zeQ.mjs.map +0 -1
  380. package/dist/GoDaddyProvider-SLlyDwD1.cjs +0 -388
  381. package/dist/GoDaddyProvider-SLlyDwD1.cjs.map +0 -1
  382. package/dist/HostingerProvider-BNpS9aRJ.mjs.map +0 -1
  383. package/dist/HostingerProvider-DR1iws1P.cjs.map +0 -1
  384. package/dist/LegacyStateStore-CAvxM8U5.cjs +0 -124
  385. package/dist/LegacyStateStore-CAvxM8U5.cjs.map +0 -1
  386. package/dist/LegacyStateStore-D9QDWCst.mjs +0 -124
  387. package/dist/LegacyStateStore-D9QDWCst.mjs.map +0 -1
  388. package/dist/LocalStateStore-DPQSqkSb.mjs +0 -167
  389. package/dist/LocalStateStore-DPQSqkSb.mjs.map +0 -1
  390. package/dist/LocalStateStore-QcrdjCl6.cjs +0 -178
  391. package/dist/LocalStateStore-QcrdjCl6.cjs.map +0 -1
  392. package/dist/OpenApiTsGenerator-CS_RtWOz.cjs +0 -541
  393. package/dist/OpenApiTsGenerator-CS_RtWOz.cjs.map +0 -1
  394. package/dist/OpenApiTsGenerator-DWAF-7Fu.mjs +0 -536
  395. package/dist/OpenApiTsGenerator-DWAF-7Fu.mjs.map +0 -1
  396. package/dist/Route53Provider-Bllus2NR.cjs.map +0 -1
  397. package/dist/Route53Provider-QXxjkZO1.mjs.map +0 -1
  398. package/dist/S3StateStore-C16tVikU.cjs +0 -222
  399. package/dist/S3StateStore-C16tVikU.cjs.map +0 -1
  400. package/dist/S3StateStore-jorgKaee.mjs +0 -223
  401. package/dist/S3StateStore-jorgKaee.mjs.map +0 -1
  402. package/dist/SSMStateStore-Dvjt_INw.mjs +0 -205
  403. package/dist/SSMStateStore-Dvjt_INw.mjs.map +0 -1
  404. package/dist/SSMStateStore-mPAEr2P2.cjs +0 -204
  405. package/dist/SSMStateStore-mPAEr2P2.cjs.map +0 -1
  406. package/dist/SubscriberGenerator-CyN2VF5X.mjs +0 -449
  407. package/dist/SubscriberGenerator-CyN2VF5X.mjs.map +0 -1
  408. package/dist/SubscriberGenerator-Dvz7EzqK.cjs +0 -490
  409. package/dist/SubscriberGenerator-Dvz7EzqK.cjs.map +0 -1
  410. package/dist/add-CZIIsTcv.mjs +0 -718
  411. package/dist/add-CZIIsTcv.mjs.map +0 -1
  412. package/dist/add-SRk65Udu.cjs +0 -720
  413. package/dist/add-SRk65Udu.cjs.map +0 -1
  414. package/dist/appPorts-C9z9Pzn9.mjs +0 -223
  415. package/dist/appPorts-C9z9Pzn9.mjs.map +0 -1
  416. package/dist/appPorts-Cu79hJF6.cjs +0 -264
  417. package/dist/appPorts-Cu79hJF6.cjs.map +0 -1
  418. package/dist/aws-8QQ8n-t6.mjs +0 -89
  419. package/dist/aws-8QQ8n-t6.mjs.map +0 -1
  420. package/dist/aws-DY9NqQIT.cjs +0 -100
  421. package/dist/aws-DY9NqQIT.cjs.map +0 -1
  422. package/dist/awsStore-Bx5nCFnS.mjs +0 -121
  423. package/dist/awsStore-Bx5nCFnS.mjs.map +0 -1
  424. package/dist/awsStore-u3ehhMoY.cjs +0 -138
  425. package/dist/awsStore-u3ehhMoY.cjs.map +0 -1
  426. package/dist/backup-provisioner-C8DnCmxK.mjs.map +0 -1
  427. package/dist/backup-provisioner-oDEsPj02.cjs.map +0 -1
  428. package/dist/bundler-B0Pj5FXT.cjs +0 -169
  429. package/dist/bundler-B0Pj5FXT.cjs.map +0 -1
  430. package/dist/bundler-DxJ-cIEt.mjs +0 -169
  431. package/dist/bundler-DxJ-cIEt.mjs.map +0 -1
  432. package/dist/cli-CRDJWWmZ.cjs +0 -73
  433. package/dist/cli-CRDJWWmZ.cjs.map +0 -1
  434. package/dist/cli-CV85bY3-.mjs +0 -73
  435. package/dist/cli-CV85bY3-.mjs.map +0 -1
  436. package/dist/compose-CQQRRJC3.mjs +0 -1511
  437. package/dist/compose-CQQRRJC3.mjs.map +0 -1
  438. package/dist/compose-DMY4ouEk.cjs +0 -1558
  439. package/dist/compose-DMY4ouEk.cjs.map +0 -1
  440. package/dist/config-CS76CzXM.d.cts +0 -269
  441. package/dist/config-CS76CzXM.d.cts.map +0 -1
  442. package/dist/config-pBzLfNef.d.mts +0 -269
  443. package/dist/config-pBzLfNef.d.mts.map +0 -1
  444. package/dist/config.cjs.map +0 -1
  445. package/dist/config.mjs.map +0 -1
  446. package/dist/credentialSchemas-BJFvfkaz.mjs +0 -237
  447. package/dist/credentialSchemas-BJFvfkaz.mjs.map +0 -1
  448. package/dist/credentialSchemas-CAPKFkrG.cjs +0 -272
  449. package/dist/credentialSchemas-CAPKFkrG.cjs.map +0 -1
  450. package/dist/credentials-B5N5yKk6.mjs +0 -267
  451. package/dist/credentials-B5N5yKk6.mjs.map +0 -1
  452. package/dist/credentials-Zqr3QQYB.cjs +0 -350
  453. package/dist/credentials-Zqr3QQYB.cjs.map +0 -1
  454. package/dist/databases-BeGP5eDh.mjs +0 -495
  455. package/dist/databases-BeGP5eDh.mjs.map +0 -1
  456. package/dist/databases-DGALFDG3.cjs +0 -598
  457. package/dist/databases-DGALFDG3.cjs.map +0 -1
  458. package/dist/define-6poNqm5O.mjs +0 -106
  459. package/dist/define-6poNqm5O.mjs.map +0 -1
  460. package/dist/define-crmMcXFS.cjs +0 -153
  461. package/dist/define-crmMcXFS.cjs.map +0 -1
  462. package/dist/deploy/public.cjs +0 -211
  463. package/dist/deploy/public.cjs.map +0 -1
  464. package/dist/deploy/public.d.cts +0 -664
  465. package/dist/deploy/public.d.cts.map +0 -1
  466. package/dist/deploy/public.d.mts +0 -664
  467. package/dist/deploy/public.d.mts.map +0 -1
  468. package/dist/deploy/public.mjs +0 -144
  469. package/dist/deploy/public.mjs.map +0 -1
  470. package/dist/deploy/sniffer-envparser-worker.cjs +0 -54
  471. package/dist/deploy/sniffer-envparser-worker.cjs.map +0 -1
  472. package/dist/deploy/sniffer-envparser-worker.d.cts +0 -1
  473. package/dist/deploy/sniffer-envparser-worker.d.mts +0 -1
  474. package/dist/deploy/sniffer-envparser-worker.mjs +0 -55
  475. package/dist/deploy/sniffer-envparser-worker.mjs.map +0 -1
  476. package/dist/deploy-277jek46.cjs +0 -2068
  477. package/dist/deploy-277jek46.cjs.map +0 -1
  478. package/dist/deploy-Dw8g3sLY.mjs +0 -2019
  479. package/dist/deploy-Dw8g3sLY.mjs.map +0 -1
  480. package/dist/derive-B4vDpzgP.mjs +0 -150
  481. package/dist/derive-B4vDpzgP.mjs.map +0 -1
  482. package/dist/derive-DAbo49sm.cjs +0 -161
  483. package/dist/derive-DAbo49sm.cjs.map +0 -1
  484. package/dist/discover-CU1LjCOf.d.cts +0 -108
  485. package/dist/discover-CU1LjCOf.d.cts.map +0 -1
  486. package/dist/discover-DJCCgimv.d.mts +0 -108
  487. package/dist/discover-DJCCgimv.d.mts.map +0 -1
  488. package/dist/discover-DPgu-ScS.cjs +0 -600
  489. package/dist/discover-DPgu-ScS.cjs.map +0 -1
  490. package/dist/discover-qjFapetL.mjs +0 -527
  491. package/dist/discover-qjFapetL.mjs.map +0 -1
  492. package/dist/dns-4RAiVFa7.cjs +0 -55
  493. package/dist/dns-4RAiVFa7.cjs.map +0 -1
  494. package/dist/dns-CU22K_i0.mjs +0 -44
  495. package/dist/dns-CU22K_i0.mjs.map +0 -1
  496. package/dist/dns-Dhjbnjgl.cjs +0 -663
  497. package/dist/dns-Dhjbnjgl.cjs.map +0 -1
  498. package/dist/dns-LqWzPb8l.mjs +0 -610
  499. package/dist/dns-LqWzPb8l.mjs.map +0 -1
  500. package/dist/dokploy-D_uCbZQ7.mjs +0 -38
  501. package/dist/dokploy-D_uCbZQ7.mjs.map +0 -1
  502. package/dist/dokploy-Dw4oCXqR.cjs +0 -38
  503. package/dist/dokploy-Dw4oCXqR.cjs.map +0 -1
  504. package/dist/drivers-CTaWrA_L.mjs +0 -177
  505. package/dist/drivers-CTaWrA_L.mjs.map +0 -1
  506. package/dist/drivers-DDojgzz0.cjs +0 -200
  507. package/dist/drivers-DDojgzz0.cjs.map +0 -1
  508. package/dist/emit-C1e8qD08.mjs +0 -193
  509. package/dist/emit-C1e8qD08.mjs.map +0 -1
  510. package/dist/emit-Dmc1nvdS.cjs +0 -210
  511. package/dist/emit-Dmc1nvdS.cjs.map +0 -1
  512. package/dist/encryption-C0uKYE9v.mjs +0 -89
  513. package/dist/encryption-C0uKYE9v.mjs.map +0 -1
  514. package/dist/encryption-CtVPHWWq.cjs +0 -90
  515. package/dist/encryption-CtVPHWWq.cjs.map +0 -1
  516. package/dist/engine-BE5PdE8S.mjs +0 -3080
  517. package/dist/engine-BE5PdE8S.mjs.map +0 -1
  518. package/dist/engine-HI8aLw1M.cjs +0 -3193
  519. package/dist/engine-HI8aLw1M.cjs.map +0 -1
  520. package/dist/errors-D8Gwp5kU.mjs +0 -23
  521. package/dist/errors-D8Gwp5kU.mjs.map +0 -1
  522. package/dist/errors-DMC4Umsb.cjs +0 -34
  523. package/dist/errors-DMC4Umsb.cjs.map +0 -1
  524. package/dist/github-BCdfZ9zO.cjs +0 -818
  525. package/dist/github-BCdfZ9zO.cjs.map +0 -1
  526. package/dist/github-CT3X720_.mjs +0 -818
  527. package/dist/github-CT3X720_.mjs.map +0 -1
  528. package/dist/index-DKtB01YC.d.cts +0 -190
  529. package/dist/index-DKtB01YC.d.cts.map +0 -1
  530. package/dist/index-ZAUrXH6Q.d.mts +0 -190
  531. package/dist/index-ZAUrXH6Q.d.mts.map +0 -1
  532. package/dist/local-BwC2v2Y8.mjs +0 -224
  533. package/dist/local-BwC2v2Y8.mjs.map +0 -1
  534. package/dist/local-DNhnkugT.cjs +0 -241
  535. package/dist/local-DNhnkugT.cjs.map +0 -1
  536. package/dist/migrate-CCZUgxMK.mjs +0 -266
  537. package/dist/migrate-CCZUgxMK.mjs.map +0 -1
  538. package/dist/migrate-Cs7kQxD5.cjs +0 -271
  539. package/dist/migrate-Cs7kQxD5.cjs.map +0 -1
  540. package/dist/migrate-DBGyoBvZ.cjs +0 -181
  541. package/dist/migrate-DBGyoBvZ.cjs.map +0 -1
  542. package/dist/migrate-DH-lOK3j.mjs +0 -181
  543. package/dist/migrate-DH-lOK3j.mjs.map +0 -1
  544. package/dist/openapi.cjs.map +0 -1
  545. package/dist/openapi.mjs.map +0 -1
  546. package/dist/projectBucket-BjeDcAYy.cjs +0 -206
  547. package/dist/projectBucket-BjeDcAYy.cjs.map +0 -1
  548. package/dist/projectBucket-DrkEht-j.mjs +0 -177
  549. package/dist/projectBucket-DrkEht-j.mjs.map +0 -1
  550. package/dist/provider-BqpjG9QM.cjs +0 -57
  551. package/dist/provider-BqpjG9QM.cjs.map +0 -1
  552. package/dist/provider-CEOKk8NS.mjs +0 -46
  553. package/dist/provider-CEOKk8NS.mjs.map +0 -1
  554. package/dist/ready-D3PIjx3S.cjs +0 -403
  555. package/dist/ready-D3PIjx3S.cjs.map +0 -1
  556. package/dist/ready-naOSJpeJ.mjs +0 -374
  557. package/dist/ready-naOSJpeJ.mjs.map +0 -1
  558. package/dist/reconcile/public.cjs +0 -7
  559. package/dist/reconcile/public.d.cts +0 -49
  560. package/dist/reconcile/public.d.cts.map +0 -1
  561. package/dist/reconcile/public.d.mts +0 -49
  562. package/dist/reconcile/public.d.mts.map +0 -1
  563. package/dist/reconcile/public.mjs +0 -3
  564. package/dist/reconcile--I7V4Klj.mjs.map +0 -1
  565. package/dist/reconcile-CuCQBa5-.cjs.map +0 -1
  566. package/dist/resolve-CScrqgdC.cjs +0 -316
  567. package/dist/resolve-CScrqgdC.cjs.map +0 -1
  568. package/dist/resolve-OfLaxaxY.mjs +0 -263
  569. package/dist/resolve-OfLaxaxY.mjs.map +0 -1
  570. package/dist/rollback-D7p4wJNO.cjs +0 -165
  571. package/dist/rollback-D7p4wJNO.cjs.map +0 -1
  572. package/dist/rollback-DQBSN-i7.mjs +0 -136
  573. package/dist/rollback-DQBSN-i7.mjs.map +0 -1
  574. package/dist/rolldown-runtime-BhDjJH2R.mjs +0 -15
  575. package/dist/run-BJLIerMM.mjs +0 -133
  576. package/dist/run-BJLIerMM.mjs.map +0 -1
  577. package/dist/run-fVZ-rLnc.cjs +0 -174
  578. package/dist/run-fVZ-rLnc.cjs.map +0 -1
  579. package/dist/runtime-BlHOVx8L.d.cts +0 -82
  580. package/dist/runtime-BlHOVx8L.d.cts.map +0 -1
  581. package/dist/runtime-DMq9C3KB.d.mts +0 -82
  582. package/dist/runtime-DMq9C3KB.d.mts.map +0 -1
  583. package/dist/s3-CUKzBBae.mjs +0 -215
  584. package/dist/s3-CUKzBBae.mjs.map +0 -1
  585. package/dist/s3-QQi4sNOQ.cjs +0 -215
  586. package/dist/s3-QQi4sNOQ.cjs.map +0 -1
  587. package/dist/sandbox/config-worker.cjs +0 -43
  588. package/dist/sandbox/config-worker.cjs.map +0 -1
  589. package/dist/sandbox/config-worker.d.cts +0 -1
  590. package/dist/sandbox/config-worker.d.mts +0 -1
  591. package/dist/sandbox/config-worker.mjs +0 -44
  592. package/dist/sandbox/config-worker.mjs.map +0 -1
  593. package/dist/sandbox/credentials-worker.cjs +0 -54
  594. package/dist/sandbox/credentials-worker.cjs.map +0 -1
  595. package/dist/sandbox/credentials-worker.d.cts +0 -1
  596. package/dist/sandbox/credentials-worker.d.mts +0 -1
  597. package/dist/sandbox/credentials-worker.mjs +0 -55
  598. package/dist/sandbox/credentials-worker.mjs.map +0 -1
  599. package/dist/sandbox/discover-worker.cjs +0 -47
  600. package/dist/sandbox/discover-worker.cjs.map +0 -1
  601. package/dist/sandbox/discover-worker.d.cts +0 -1
  602. package/dist/sandbox/discover-worker.d.mts +0 -1
  603. package/dist/sandbox/discover-worker.mjs +0 -48
  604. package/dist/sandbox/discover-worker.mjs.map +0 -1
  605. package/dist/sandbox/migrate-worker.cjs +0 -75
  606. package/dist/sandbox/migrate-worker.cjs.map +0 -1
  607. package/dist/sandbox/migrate-worker.d.cts +0 -1
  608. package/dist/sandbox/migrate-worker.d.mts +0 -1
  609. package/dist/sandbox/migrate-worker.mjs +0 -76
  610. package/dist/sandbox/migrate-worker.mjs.map +0 -1
  611. package/dist/sandbox-ArJ_hEKk.d.cts +0 -104
  612. package/dist/sandbox-ArJ_hEKk.d.cts.map +0 -1
  613. package/dist/sandbox-CHv3OYXg.cjs +0 -165
  614. package/dist/sandbox-CHv3OYXg.cjs.map +0 -1
  615. package/dist/sandbox-CbVB7uOD.mjs +0 -118
  616. package/dist/sandbox-CbVB7uOD.mjs.map +0 -1
  617. package/dist/sandbox-Cm4X6HRh.d.mts +0 -104
  618. package/dist/sandbox-Cm4X6HRh.d.mts.map +0 -1
  619. package/dist/schemas-BObwxB_t.cjs +0 -6017
  620. package/dist/schemas-BObwxB_t.cjs.map +0 -1
  621. package/dist/schemas-D-xeKJDD.mjs +0 -5916
  622. package/dist/schemas-D-xeKJDD.mjs.map +0 -1
  623. package/dist/secrets-AA_tQUl-.mjs +0 -36
  624. package/dist/secrets-AA_tQUl-.mjs.map +0 -1
  625. package/dist/secrets-B_biKsKx.cjs +0 -47
  626. package/dist/secrets-B_biKsKx.cjs.map +0 -1
  627. package/dist/secretsManager-CQORubp9.mjs +0 -97
  628. package/dist/secretsManager-CQORubp9.mjs.map +0 -1
  629. package/dist/secretsManager-RAGcEDX1.cjs +0 -108
  630. package/dist/secretsManager-RAGcEDX1.cjs.map +0 -1
  631. package/dist/seeds-BvxWUGKJ.mjs +0 -8263
  632. package/dist/seeds-BvxWUGKJ.mjs.map +0 -1
  633. package/dist/seeds-Df4BI-T3.cjs +0 -9266
  634. package/dist/seeds-Df4BI-T3.cjs.map +0 -1
  635. package/dist/sniffer-BqjXvcaK.mjs +0 -1825
  636. package/dist/sniffer-BqjXvcaK.mjs.map +0 -1
  637. package/dist/sniffer-DZeQJKty.cjs +0 -1998
  638. package/dist/sniffer-DZeQJKty.cjs.map +0 -1
  639. package/dist/sst-CGdjHn2A.mjs +0 -441
  640. package/dist/sst-CGdjHn2A.mjs.map +0 -1
  641. package/dist/sst-DGuHDxVU.cjs +0 -464
  642. package/dist/sst-DGuHDxVU.cjs.map +0 -1
  643. package/dist/stack-A6MAFZ6u.mjs +0 -1201
  644. package/dist/stack-A6MAFZ6u.mjs.map +0 -1
  645. package/dist/stack-BpkZEEfB.cjs +0 -1308
  646. package/dist/stack-BpkZEEfB.cjs.map +0 -1
  647. package/dist/stages-6SEoRA4x.mjs +0 -190
  648. package/dist/stages-6SEoRA4x.mjs.map +0 -1
  649. package/dist/stages-DH5z89eT.cjs +0 -190
  650. package/dist/stages-DH5z89eT.cjs.map +0 -1
  651. package/dist/target/public.cjs +0 -15
  652. package/dist/target/public.d.cts +0 -28
  653. package/dist/target/public.d.cts.map +0 -1
  654. package/dist/target/public.d.mts +0 -28
  655. package/dist/target/public.d.mts.map +0 -1
  656. package/dist/target/public.mjs +0 -4
  657. package/dist/terminal-CPHuH4S1.cjs +0 -85
  658. package/dist/terminal-CPHuH4S1.cjs.map +0 -1
  659. package/dist/terminal-iNmAXXjs.mjs +0 -85
  660. package/dist/terminal-iNmAXXjs.mjs.map +0 -1
  661. package/dist/types-DipUP9zp.d.cts +0 -7606
  662. package/dist/types-DipUP9zp.d.cts.map +0 -1
  663. package/dist/types-Drpl9HX9.d.mts +0 -7605
  664. package/dist/types-Drpl9HX9.d.mts.map +0 -1
  665. package/dist/utils-D2Nk1Nv2.cjs +0 -205
  666. package/dist/utils-D2Nk1Nv2.cjs.map +0 -1
  667. package/dist/utils-D_fxUqvU.mjs +0 -156
  668. package/dist/utils-D_fxUqvU.mjs.map +0 -1
  669. package/dist/vitest.cjs +0 -65
  670. package/dist/vitest.cjs.map +0 -1
  671. package/dist/vitest.d.cts +0 -29
  672. package/dist/vitest.d.cts.map +0 -1
  673. package/dist/vitest.d.mts +0 -29
  674. package/dist/vitest.d.mts.map +0 -1
  675. package/dist/vitest.mjs +0 -65
  676. package/dist/vitest.mjs.map +0 -1
  677. package/dist/workerRuntime-BXfhbe13.cjs +0 -108
  678. package/dist/workerRuntime-BXfhbe13.cjs.map +0 -1
  679. package/dist/workerRuntime-CsOyBRx2.mjs +0 -79
  680. package/dist/workerRuntime-CsOyBRx2.mjs.map +0 -1
  681. package/dist/workspace-BBeT6Pil.mjs +0 -2088
  682. package/dist/workspace-BBeT6Pil.mjs.map +0 -1
  683. package/dist/workspace-BJ78Bgvm.cjs +0 -2494
  684. package/dist/workspace-BJ78Bgvm.cjs.map +0 -1
@@ -1,1090 +0,0 @@
1
- const require_errors = require("./errors-DMC4Umsb.cjs");
2
- const require_discover = require("./discover-DPgu-ScS.cjs");
3
- let node_path = require("node:path");
4
- let node_fs = require("node:fs");
5
- let node_fs_promises = require("node:fs/promises");
6
- let _geekmidas_constructs_endpoints = require("@geekmidas/constructs/endpoints");
7
- //#region src/generators/telemetry.ts
8
- /** Each endpoint's own `.telemetry({ ignore, attributes })`, as routes. */
9
- function routeTelemetry(endpoints) {
10
- return endpoints.flatMap((endpoint) => endpoint.telemetry ? [{
11
- method: endpoint.method,
12
- path: endpoint.route,
13
- ...endpoint.telemetry
14
- }] : []);
15
- }
16
- /**
17
- * Every package `@geekmidas/telescope/instrumentation` loads at runtime.
18
- *
19
- * All of them, rather than one as a proxy: the production bundle follows each
20
- * import, and a single missing one fails the build rather than the telemetry.
21
- */
22
- const TELEMETRY_PACKAGES = [
23
- "@opentelemetry/api",
24
- "@opentelemetry/auto-instrumentations-node",
25
- "@opentelemetry/exporter-logs-otlp-http",
26
- "@opentelemetry/exporter-trace-otlp-http",
27
- "@opentelemetry/instrumentation-pino",
28
- "@opentelemetry/resources",
29
- "@opentelemetry/sdk-logs",
30
- "@opentelemetry/sdk-node",
31
- "@opentelemetry/sdk-trace-base",
32
- "@opentelemetry/sdk-trace-node",
33
- "@opentelemetry/semantic-conventions"
34
- ];
35
- /**
36
- * The directory of `name` as `node_modules` lookup finds it from `fromDir`,
37
- * symlinks resolved — or undefined.
38
- *
39
- * The directory walk alone, not `require.resolve`: that also searches
40
- * `NODE_PATH`, which a package manager's bin shim sets to its own store, so a
41
- * `gkm build` run through one would find packages the app never installed —
42
- * and the bundler, which does not look there, would then fail on them.
43
- */
44
- function packageDir(fromDir, name) {
45
- for (let dir = (0, node_path.resolve)(fromDir);; dir = (0, node_path.dirname)(dir)) {
46
- const candidate = (0, node_path.join)(dir, "node_modules", name);
47
- if ((0, node_fs.existsSync)((0, node_path.join)(candidate, "package.json"))) return (0, node_fs.realpathSync)(candidate);
48
- if ((0, node_path.dirname)(dir) === dir) return void 0;
49
- }
50
- }
51
- /**
52
- * The telemetry packages that do not resolve the way the bundler will resolve
53
- * them — telescope from the app, and the OpenTelemetry packages from
54
- * telescope, where a peer is linked under pnpm, which need not be where the
55
- * app sees it. Empty when every one does.
56
- */
57
- function missingTelemetryPackages(appRoot) {
58
- const telescope = packageDir(appRoot, "@geekmidas/telescope");
59
- if (!telescope) return ["@geekmidas/telescope", ...TELEMETRY_PACKAGES];
60
- return TELEMETRY_PACKAGES.filter((pkg) => !packageDir(telescope, pkg));
61
- }
62
- /**
63
- * An app uses a `Telemetry` construct and cannot load what it needs to.
64
- *
65
- * Failed at build, not at startup: a process that was given telemetry and
66
- * quietly ran without it is an outage nobody can see into.
67
- */
68
- var TelemetryPackagesMissing = class extends require_errors.GkmError {
69
- app;
70
- missing;
71
- dir;
72
- command;
73
- constructor(app, missing, dir) {
74
- const command = `pnpm --dir ${dir || "."} add ${missing.join(" ")}`;
75
- super(`'${app}' uses a Telemetry construct, and ${missing.join(", ")} ${missing.length === 1 ? "does" : "do"} not resolve from it — its server would start without exporting a span. Add them to the app and build again:\n\n ${command}\n`);
76
- this.app = app;
77
- this.missing = missing;
78
- this.dir = dir;
79
- this.name = "TelemetryPackagesMissing";
80
- this.command = command;
81
- }
82
- };
83
- /**
84
- * The telemetry half of a build context: undefined for a process with no
85
- * edge to a `Telemetry` node, and — for one with an edge — what its entry
86
- * starts with, once every package it needs resolves.
87
- */
88
- function telemetryFor(options) {
89
- const { node } = options;
90
- if (!node) return void 0;
91
- const missing = missingTelemetryPackages(options.appRoot);
92
- if (missing.length > 0) throw new TelemetryPackagesMissing(options.app, missing, (0, node_path.relative)(options.cwd ?? process.cwd(), options.appRoot));
93
- return {
94
- serviceName: options.serviceName,
95
- ...options.workspaceName && { serviceNamespace: options.workspaceName },
96
- ignorePaths: [...node.ignorePaths ?? []],
97
- attributes: { ...node.attributes },
98
- routes: [...options.routes ?? []]
99
- };
100
- }
101
- const HEADER = `/**
102
- * Generated by gkm, for the production entry and the \`gkm dev\` one alike.
103
- *
104
- * Starts OpenTelemetry when OTEL_EXPORTER_OTLP_ENDPOINT names a collector, and
105
- * does nothing otherwise: without it, the telemetry packages are not loaded.
106
- * The standard OTEL_* variables (OTEL_TRACES_SAMPLER, OTEL_TRACES_SAMPLER_ARG,
107
- * OTEL_EXPORTER_OTLP_HEADERS, OTEL_RESOURCE_ATTRIBUTES, OTEL_SERVICE_NAME)
108
- * configure the rest.
109
- */
110
-
111
- import type { MiddlewareHandler } from 'hono';
112
-
113
- export interface StartTelemetryOptions {
114
- /** Requests whose spans would only be noise: health checks, by default. */
115
- ignorePaths?: string[];
116
- /**
117
- * The API's own sites — the origins its CORS allows — read on each request.
118
- * Their \`traceparent\` is continued, as is an internal caller's; anyone
119
- * else's starts a new trace linked to the one it claimed.
120
- */
121
- trustedOrigins?: () => readonly string[];
122
- }
123
- `;
124
- /** `/users/:id` as a pattern over a request's path. */
125
- function routePattern(path) {
126
- return `^${path.split("/").map((segment) => {
127
- if (segment.startsWith(":")) return "[^/]+";
128
- if (segment === "*") return ".*";
129
- return segment.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
130
- }).join("/")}/?$`;
131
- }
132
- /**
133
- * The entry's `telemetry.ts`: a `startTelemetry()` the server awaits before it
134
- * imports the app, so the libraries the app loads are instrumented. It returns
135
- * the Hono middleware that traces each request, or undefined when telemetry is
136
- * off — the server mounts it ahead of every route.
137
- *
138
- * Without a context — a process with no edge to a `Telemetry` node — it is a
139
- * stub that loads nothing and says nothing: telemetry is not something that
140
- * process was given.
141
- *
142
- * Failing to start telemetry warns (a named `TelemetryUnavailable`, through
143
- * `process.emitWarning`) and never stops the server: an outage in observability
144
- * is not a reason to have an outage in the service.
145
- */
146
- function generateTelemetryModule(telemetry) {
147
- if (!telemetry) return `${HEADER}
148
- // This process has no Telemetry construct, so there is nothing to start.
149
- export async function startTelemetry(
150
- _options: StartTelemetryOptions = {},
151
- ): Promise<MiddlewareHandler | undefined> {
152
- return undefined;
153
- }
154
- `;
155
- const options = [
156
- `serviceName: ${JSON.stringify(telemetry.serviceName)},`,
157
- ...telemetry.serviceNamespace ? [`serviceNamespace: ${JSON.stringify(telemetry.serviceNamespace)},`] : [],
158
- "deploymentEnvironment: process.env.STAGE,",
159
- ...Object.keys(telemetry.attributes).length ? [`resourceAttributes: ${JSON.stringify(telemetry.attributes)},`] : [],
160
- "handleSignals: false,",
161
- "instrumentPino: false,",
162
- "incomingHttpSpans: false,"
163
- ];
164
- const routes = telemetry.routes.map((route) => ({
165
- method: route.method.toUpperCase(),
166
- pattern: routePattern(route.path),
167
- ...route.ignore ? { ignore: true } : {},
168
- ...route.attributes && Object.keys(route.attributes).length ? { attributes: route.attributes } : {}
169
- }));
170
- const withAttributes = routes.some((route) => "attributes" in route);
171
- return `${HEADER}
172
- /** Telemetry was asked for and cannot start. The server runs without it. */
173
- export class TelemetryUnavailable extends Error {
174
- constructor(readonly reason: string, options?: { cause?: unknown }) {
175
- super(
176
- \`OTEL_EXPORTER_OTLP_ENDPOINT is set, but \${reason} This server exports no traces or logs until that is fixed.\`,
177
- options,
178
- );
179
- this.name = 'TelemetryUnavailable';
180
- }
181
- }
182
-
183
- /** The Telemetry construct's own ignored paths, beside the entry's. */
184
- const IGNORE_PATHS: string[] = ${JSON.stringify(telemetry.ignorePaths)};
185
-
186
- /** Each route's own .telemetry({ ignore, attributes }). */
187
- const ROUTES: {
188
- method: string;
189
- pattern: string;
190
- ignore?: boolean;
191
- attributes?: Record<string, string>;
192
- }[] = ${JSON.stringify(routes)};
193
-
194
- const MATCHERS = ROUTES.map((route) => ({ ...route, regex: new RegExp(route.pattern) }));
195
-
196
- function routeOf(method: string, path: string) {
197
- return MATCHERS.find(
198
- (route) => (route.method === method || route.method === 'ALL' || route.method === 'ANY') && route.regex.test(path),
199
- );
200
- }
201
-
202
- export async function startTelemetry(
203
- options: StartTelemetryOptions = {},
204
- ): Promise<MiddlewareHandler | undefined> {
205
- if (!process.env.OTEL_EXPORTER_OTLP_ENDPOINT) return undefined;
206
-
207
- let instrumentation;
208
- try {
209
- instrumentation = await import('@geekmidas/telescope/instrumentation');
210
- } catch (cause) {
211
- process.emitWarning(
212
- new TelemetryUnavailable(
213
- '@geekmidas/telescope/instrumentation or an @opentelemetry package it needs could not be loaded. Install them in the app and rebuild.',
214
- { cause },
215
- ),
216
- );
217
- return undefined;
218
- }
219
-
220
- instrumentation.setupTelemetry({
221
- ${options.join("\n ")}
222
- });
223
-
224
- // Flush what is buffered when the process is told to stop. When nothing
225
- // else handles the signal, re-raise it once flushed, so the process still
226
- // stops the way it would have without this listener.
227
- for (const signal of ['SIGTERM', 'SIGINT'] as const) {
228
- process.once(signal, () => {
229
- void instrumentation.flushTelemetry().finally(() => {
230
- if (process.listenerCount(signal) === 0) process.kill(process.pid, signal);
231
- });
232
- });
233
- }
234
-
235
- // A SERVER span per request, opened by the app itself rather than by
236
- // hooking node:http: \`GET /users/:id\`, continuing an incoming traceparent
237
- // from the API's own sites and internal callers (a new, linked trace from
238
- // anyone else), with the handler — its logs, fetches and queries — running
239
- // inside it.
240
- const spans = instrumentation.honoTelemetryMiddleware({
241
- ignorePaths: [...(options.ignorePaths ?? []), ...IGNORE_PATHS],
242
- trustedOrigins: options.trustedOrigins,
243
- ...(MATCHERS.some((route) => route.ignore)
244
- ? { shouldSkip: (c) => routeOf(c.req.method, c.req.path)?.ignore === true }
245
- : {}),
246
- });
247
- ${withAttributes ? `
248
- // A route's own attributes, on the span the middleware just opened.
249
- const { trace } = await import('@opentelemetry/api');
250
- return (c, next) =>
251
- spans(c, async () => {
252
- const attributes = routeOf(c.req.method, c.req.path)?.attributes;
253
- if (attributes) trace.getActiveSpan()?.setAttributes(attributes);
254
- await next();
255
- });
256
- ` : ` return spans;
257
- `}}
258
- `;
259
- }
260
- /**
261
- * What an entry starts telemetry with, before it imports the app — shared by
262
- * the production server, a self-serving surface's server and the `gkm dev`
263
- * entry, so the three cannot start it differently. Defines `requestSpans`.
264
- */
265
- function startTelemetryCode(ignorePaths) {
266
- return `// The API's own sites, known once the app has read its configuration: the
267
- // origins its CORS allows are the ones whose trace context is continued.
268
- let trustedOrigins: readonly string[] = [];
269
-
270
- // Before the app is imported, so the libraries it loads are instrumented.
271
- const { startTelemetry } = await import('./telemetry.js');
272
- const requestSpans = await startTelemetry({
273
- ignorePaths: ${JSON.stringify(ignorePaths)},
274
- trustedOrigins: () => trustedOrigins,
275
- });
276
- `;
277
- }
278
- /** Mounts `requestSpans` on `app` ahead of every route. */
279
- function mountRequestSpansCode(app) {
280
- return `// The span middleware goes on before any route, so every request runs in it.
281
- if (requestSpans) ${app}.use('*', requestSpans);
282
- `;
283
- }
284
- /** Writes the entry's `telemetry.ts` beside it. */
285
- async function writeTelemetryModule(outputDir, telemetry) {
286
- await (0, node_fs_promises.mkdir)(outputDir, { recursive: true });
287
- await (0, node_fs_promises.writeFile)((0, node_path.join)(outputDir, "telemetry.ts"), generateTelemetryModule(telemetry));
288
- }
289
- //#endregion
290
- //#region src/generators/clientTelemetry.ts
291
- /**
292
- * Whether a generated client propagates trace context by default.
293
- *
294
- * `false` (the default) prints a client that sends no trace headers unless
295
- * its caller passes `telemetry`. Anything else prints that default into
296
- * `createApi`: `true`, or `{ sampleRate }` — the stage's rate, for the page
297
- * views no OpenTelemetry SDK is tracing. A caller's own `telemetry` option
298
- * still wins.
299
- */
300
- /** A `sampleRate` outside 0–1, which no sampler can honour. */
301
- var InvalidClientTelemetrySampleRate = class extends require_errors.GkmError {
302
- sampleRate;
303
- constructor(sampleRate) {
304
- super(`The client's telemetry sample rate must be a number from 0 to 1, got ${sampleRate}. Pass the stage's rate, such as 0.1, or leave it out for 1.`);
305
- this.sampleRate = sampleRate;
306
- this.name = "InvalidClientTelemetrySampleRate";
307
- }
308
- };
309
- /** The `telemetry` default as the generated module prints it. */
310
- function printTelemetryDefault(telemetry) {
311
- if (typeof telemetry === "boolean") return String(telemetry);
312
- const { sampleRate } = telemetry;
313
- if (!Number.isFinite(sampleRate) || sampleRate < 0 || sampleRate > 1) throw new InvalidClientTelemetrySampleRate(sampleRate);
314
- return `{ sampleRate: ${sampleRate} }`;
315
- }
316
- /**
317
- * `--telemetry [rate]` for a client default, as `gkm openapi` takes it — and
318
- * as a site's Dockerfile passes it to the `gkm openapi --app` it runs.
319
- */
320
- function telemetryArgs(telemetry) {
321
- if (!telemetry) return [];
322
- if (telemetry === true) return ["--telemetry"];
323
- return ["--telemetry", String(telemetry.sampleRate)];
324
- }
325
- /** What `--telemetry [rate]` parsed to: on, at a rate when one was given. */
326
- function parseTelemetryFlag(value) {
327
- if (value === void 0 || value === false) return void 0;
328
- if (value === true) return true;
329
- return { sampleRate: Number(value) };
330
- }
331
- //#endregion
332
- //#region src/generators/EndpointGenerator.ts
333
- /**
334
- * How a generated entry gets its logger and environment parser.
335
- *
336
- * From the surface it serves, when there is one: the surface holds both as
337
- * *objects*, and discovery already recorded which module declares it, so the
338
- * entry imports that module and reads them off it.
339
- *
340
- * The alternative — the shape this replaces — was naming both in config as
341
- * module paths, `envParser: './config/env#envParser'`, and printing an import
342
- * for each. Two strings per app, checked by nothing, describing files the
343
- * surface was already holding the contents of.
344
- *
345
- * Falls back to the configured paths for an app that declares no surface.
346
- */
347
- function runtimeFor(context, fromDir, owner) {
348
- const module = owner ? context.owners?.[owner] ?? context.surface?.module : context.surface?.module;
349
- if (module) {
350
- const specifier = importSpecifier(fromDir, module.specifier);
351
- return {
352
- imports: `import { ${module.exportName} as __surface } from '${specifier}';`,
353
- bindings: [
354
- "// What this construct was declared with. Objects, not module paths:",
355
- "// the entry imports the owner, so there is nothing to print.",
356
- "const envParser = __surface.envParser;",
357
- "const logger = __surface.logger;"
358
- ].join("\n")
359
- };
360
- }
361
- throw new Error(`No owner to take a logger and an environment parser from${owner ? ` for "${owner}"` : ""}. Build it from a \`RestApi\` or a \`Worker\`.`);
362
- }
363
- /** A relative specifier ESM will accept: always prefixed, never bare. */
364
- function importSpecifier(fromDir, target) {
365
- const rel = (0, node_path.relative)(fromDir, target).replace(/\.ts$/, ".js");
366
- return rel.startsWith(".") ? rel : `./${rel}`;
367
- }
368
- /**
369
- * CORS for a surface, derived rather than hand-written.
370
- *
371
- * Who may call a surface is already in the graph — every construct that
372
- * declared an edge to it — and reaches the process as one comma-separated
373
- * value. An application that maintained this by hand maintained a list that was
374
- * wrong in two directions at once: it trusted origins nothing was serving, and
375
- * it could not name hosts a deploy had not chosen yet.
376
- *
377
- * Only the parts a graph cannot answer are configurable, and every one has a
378
- * default: a surface that says nothing about CORS still gets it.
379
- */
380
- function corsFor(surface) {
381
- if (!surface) return {
382
- imports: "",
383
- setup: ""
384
- };
385
- const cors = surface.cors ?? {};
386
- const allowHeaders = [.../* @__PURE__ */ new Set([
387
- "content-type",
388
- "authorization",
389
- "traceparent",
390
- "tracestate",
391
- ...cors.allowHeaders ?? []
392
- ])];
393
- return {
394
- imports: `import { cors } from 'hono/cors';`,
395
- setup: `
396
- // Who may call ${surface.id}, read off the graph rather than listed here.
397
- {
398
- const { origins } = envParser
399
- .create((get) => ({
400
- origins: get('${surface.trustedOriginsKey}')
401
- .string()
402
- .default('')
403
- .transform((value: string) =>
404
- value.split(',').map((origin) => origin.trim()).filter(Boolean),
405
- ),
406
- }))
407
- .parse();
408
-
409
- // The same origins are the ones whose trace context the request spans
410
- // continue — the server reads them back from \`createApp\`.
411
- trustedOrigins.push(...origins);
412
-
413
- honoApp.use('*', cors({
414
- origin: origins,
415
- allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS'],
416
- allowHeaders: ${JSON.stringify(allowHeaders)},${cors.exposeHeaders ? `\n exposeHeaders: ${JSON.stringify(cors.exposeHeaders)},` : ""}
417
- credentials: ${cors.credentials ?? true},
418
- maxAge: ${cors.maxAge ?? 86400},
419
- }));
420
- }
421
- `
422
- };
423
- }
424
- var EndpointGenerator = class extends require_discover.ConstructGenerator {
425
- isConstruct(value) {
426
- return _geekmidas_constructs_endpoints.Endpoint.isEndpoint(value);
427
- }
428
- async build(context, constructs, outputDir, options) {
429
- const target = options?.target ?? "aws";
430
- const root = options?.root ?? process.cwd();
431
- const enableOpenApi = options?.enableOpenApi || false;
432
- const logger = console;
433
- const routes = [];
434
- if (constructs.length === 0) return routes;
435
- if (target === "server") {
436
- await this.generateEndpointsFile(outputDir, constructs);
437
- const appFile = await this.generateAppFile(outputDir, context);
438
- routes.push({
439
- path: "*",
440
- method: "ALL",
441
- handler: (0, node_path.relative)(root, appFile),
442
- authorizer: "none"
443
- });
444
- logger.log(`Generated server with ${constructs.length} endpoints${enableOpenApi ? " (OpenAPI enabled)" : ""}`);
445
- return routes;
446
- }
447
- const routesDir = (0, node_path.join)(outputDir, "routes");
448
- await (0, node_fs_promises.mkdir)(routesDir, { recursive: true });
449
- for (const { key, construct, path } of constructs) {
450
- const handlerFile = await this.generateHandlerFile(routesDir, path.relative, key, context);
451
- const routeInfo = {
452
- path: construct._path,
453
- method: construct.method,
454
- handler: (0, node_path.relative)(root, handlerFile).replace(/\.ts$/, ".handler"),
455
- timeout: construct.timeout,
456
- memorySize: construct.memorySize,
457
- environment: await construct.getEnvironment({ markOptional: context.markOptional }),
458
- dependencies: construct.constructs,
459
- authorizer: construct.authorizer?.name ?? "none"
460
- };
461
- routes.push(routeInfo);
462
- logger.log(`Generated handler for ${routeInfo.method} ${routeInfo.path}`);
463
- }
464
- return routes;
465
- }
466
- async generateHandlerFile(outputDir, sourceFile, exportName, context) {
467
- const handlerPath = (0, node_path.join)(outputDir, `${exportName}.ts`);
468
- const importPath = (0, node_path.relative)((0, node_path.dirname)(handlerPath), sourceFile).replace(/\.ts$/, ".js");
469
- await (0, node_fs_promises.writeFile)(handlerPath, this.generateAWSApiGatewayV2Handler(importPath, exportName, context.storageDrivers));
470
- return handlerPath;
471
- }
472
- async generateEndpointsFile(outputDir, endpoints) {
473
- const endpointsPath = (0, node_path.join)(outputDir, "endpoints.ts");
474
- const importsByFile = /* @__PURE__ */ new Map();
475
- for (const { path, key } of endpoints) {
476
- const importPath = (0, node_path.relative)((0, node_path.dirname)(endpointsPath), path.relative).replace(/\.ts$/, ".js");
477
- if (!importsByFile.has(importPath)) importsByFile.set(importPath, []);
478
- importsByFile.get(importPath)?.push(key);
479
- }
480
- const content = `import type { EnvironmentParser } from '@geekmidas/envkit';
481
- import type { Logger } from '@geekmidas/logger';
482
- import { HonoEndpoint } from '@geekmidas/constructs/hono';
483
- import { Endpoint } from '@geekmidas/constructs/endpoints';
484
- import { ServiceDiscovery } from '@geekmidas/services';
485
- import type { Hono } from 'hono';
486
- ${Array.from(importsByFile.entries()).map(([importPath, exports]) => `import { ${exports.join(", ")} } from '${importPath}';`).join("\n")}
487
-
488
- export const endpoints: Endpoint<any, any, any, any, any, any, any, any, any, any, any, any>[] = [
489
- ${endpoints.map(({ key }) => key).join(",\n ")}
490
- ];
491
-
492
- export async function setupEndpoints(
493
- app: Hono,
494
- envParser: EnvironmentParser<any>,
495
- logger: Logger,
496
- enableOpenApi: boolean = true,
497
- ): Promise<void> {
498
- const serviceDiscovery = ServiceDiscovery.getInstance(envParser);
499
-
500
- // Configure OpenAPI options based on enableOpenApi flag
501
- const openApiOptions: any = enableOpenApi ? {
502
- docsPath: '/__docs',
503
- openApiOptions: {
504
- title: 'API Documentation',
505
- version: '1.0.0',
506
- description: 'Generated API documentation'
507
- }
508
- } : { docsPath: false };
509
-
510
- HonoEndpoint.addRoutes(endpoints, serviceDiscovery, app, openApiOptions);
511
-
512
- // Add Swagger UI if OpenAPI is enabled
513
- if (enableOpenApi) {
514
- try {
515
- const { swaggerUI } = await import('@hono/swagger-ui');
516
- app.get('/__docs/ui', swaggerUI({ url: '/__docs' }));
517
- } catch {
518
- // @hono/swagger-ui not installed, skip Swagger UI
519
- }
520
- }
521
- }
522
- `;
523
- await (0, node_fs_promises.writeFile)(endpointsPath, content);
524
- return endpointsPath;
525
- }
526
- async generateAppFile(outputDir, context) {
527
- await writeTelemetryModule(outputDir, context.telemetry);
528
- if (context.production?.enabled) return this.generateProductionAppFile(outputDir, context);
529
- const appPath = (0, node_path.join)(outputDir, "app.ts");
530
- const runtime = runtimeFor(context, (0, node_path.dirname)(appPath));
531
- const telescopeEnabled = context.telescope?.enabled;
532
- const telescopeWebSocketEnabled = context.telescope?.websocket;
533
- const usesExternalTelescope = !!context.telescope?.telescopePath;
534
- const telescopeFromSurface = !!context.surface?.module && !usesExternalTelescope;
535
- let telescopeImports = "";
536
- if (telescopeEnabled) {
537
- if (telescopeFromSurface) telescopeImports = `import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
538
- import { createApi, createMiddleware } from '@geekmidas/telescope/hono';`;
539
- else if (usesExternalTelescope) {
540
- const relativeTelescopePath = (0, node_path.relative)((0, node_path.dirname)(appPath), context.telescope?.telescopePath);
541
- telescopeImports = `import ${context.telescope?.telescopeImportPattern} from '${relativeTelescopePath}';
542
- import { createApi, createMiddleware } from '@geekmidas/telescope/hono';`;
543
- } else telescopeImports = `import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
544
- import { createApi, createMiddleware } from '@geekmidas/telescope/hono';`;
545
- }
546
- const databaseApi = context.databaseApi;
547
- const databaseApiImports = databaseApi ? `import { snifferContext } from '@geekmidas/constructs';
548
- import { createIntrospectionHandler } from '@geekmidas/db/introspect';
549
- import { ${databaseApi.database.exportName} as __introspectedDb } from '${importSpecifier((0, node_path.dirname)(appPath), databaseApi.database.specifier)}';` : "";
550
- const cors = corsFor(context.surface);
551
- let hooksImports = "";
552
- let beforeSetupCall = "";
553
- let afterSetupCall = "";
554
- if (context.hooks?.serverHooksPath) {
555
- hooksImports = `import * as serverHooks from '${(0, node_path.relative)((0, node_path.dirname)(appPath), context.hooks.serverHooksPath)}';`;
556
- beforeSetupCall = `
557
- // Call beforeSetup hook if defined
558
- if (typeof serverHooks.beforeSetup === 'function') {
559
- await serverHooks.beforeSetup(honoApp, { envParser, logger });
560
- }
561
- `;
562
- afterSetupCall = `
563
- // Call afterSetup hook if defined
564
- if (typeof serverHooks.afterSetup === 'function') {
565
- await serverHooks.afterSetup(honoApp, { envParser, logger });
566
- }
567
- `;
568
- }
569
- const telescopeWebSocketSetupCode = telescopeWebSocketEnabled ? `
570
- // Setup WebSocket for real-time telescope updates
571
- try {
572
- const { createNodeWebSocket } = await import('@hono/node-ws');
573
- const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app: honoApp });
574
- // Add WebSocket route directly to main app (sub-app routes don't support WS upgrade)
575
- honoApp.get('${context.telescope?.path}/ws', upgradeWebSocket(() => ({
576
- onOpen: (_event: Event, ws: any) => {
577
- telescope.addWsClient(ws);
578
- },
579
- onClose: (_event: Event, ws: any) => {
580
- telescope.removeWsClient(ws);
581
- },
582
- onMessage: (event: MessageEvent, ws: any) => {
583
- try {
584
- const data = JSON.parse(event.data);
585
- if (data.type === 'ping') {
586
- ws.send(JSON.stringify({ type: 'pong' }));
587
- }
588
- } catch {
589
- // Ignore invalid messages
590
- }
591
- },
592
- })));
593
- // Store injectWebSocket for server entry to call after serve()
594
- (honoApp as any).__injectWebSocket = injectWebSocket;
595
- logger.info('Telescope WebSocket enabled');
596
- } catch (e) {
597
- logger.warn({ err: e }, 'WebSocket support not available - install @hono/node-ws for real-time updates');
598
- }
599
- ` : "";
600
- let telescopeSetup = "";
601
- if (telescopeEnabled) {
602
- if (telescopeFromSurface || usesExternalTelescope) telescopeSetup = `
603
- ${telescopeWebSocketSetupCode}
604
- // Add telescope middleware (before endpoints to capture all requests)
605
- honoApp.use('*', createMiddleware(telescope));
606
-
607
- // Mount Telescope's JSON API
608
- const telescopeApi = createApi(telescope);
609
- honoApp.route('${context.telescope?.path}', telescopeApi);
610
- `;
611
- else telescopeSetup = `
612
- // Setup Telescope for debugging/monitoring
613
- const telescopeStorage = new InMemoryStorage({ maxEntries: ${context.telescope?.maxEntries} });
614
- const telescope = new Telescope({
615
- enabled: true,
616
- path: '${context.telescope?.path}',
617
- ignorePatterns: ${JSON.stringify(context.telescope?.ignore)},
618
- recordBody: ${context.telescope?.recordBody},
619
- storage: telescopeStorage,
620
- });
621
- ${telescopeWebSocketSetupCode}
622
- // Add telescope middleware (before endpoints to capture all requests)
623
- honoApp.use('*', createMiddleware(telescope));
624
-
625
- // Mount Telescope's JSON API
626
- const telescopeApi = createApi(telescope);
627
- honoApp.route('${context.telescope?.path}', telescopeApi);
628
- `;
629
- }
630
- const databaseApiSetup = databaseApi ? `
631
- // The database's structure and rows as JSON, read-only, for whatever tool
632
- // the developer points at it. Dev only: it answers anyone who can reach the
633
- // port.
634
- const databaseApi = createIntrospectionHandler({
635
- db: await __introspectedDb.service.register({ envParser, context: snifferContext }),
636
- basePath: '${databaseApi.path}',
637
- });
638
- honoApp.all('${databaseApi.path}/*', (c) => databaseApi(c.req.raw));
639
- ` : "";
640
- const content = `/**
641
- * Generated server application
642
- *
643
- * ⚠️ WARNING: This is for LOCAL DEVELOPMENT ONLY
644
- * The subscriber polling mechanism is not production-ready.
645
- * For production, use AWS Lambda with SQS/SNS event sources.
646
- */
647
- import { Hono } from 'hono';
648
- import type { Hono as HonoType } from 'hono';
649
- import { setupEndpoints } from './endpoints.js';
650
- import { setupSubscribers } from './subscribers.js';
651
- import { setupQueues } from './queues.js';
652
- import { setupCrons } from './crons.js';
653
- ${runtime.imports}
654
- ${telescopeImports}
655
- ${databaseApiImports}
656
- ${hooksImports}
657
- ${cors.imports}
658
- ${context.storageDrivers?.imports ?? ""}
659
-
660
- ${runtime.bindings}
661
- ${telescopeEnabled && telescopeFromSurface ? `// The surface's own Telescope, or the one \`telescope\` config describes.
662
- const telescope =
663
- __surface.telescope ??
664
- new Telescope({
665
- enabled: true,
666
- path: '${context.telescope?.path}',
667
- ignorePatterns: ${JSON.stringify(context.telescope?.ignore)},
668
- recordBody: ${context.telescope?.recordBody},
669
- storage: new InMemoryStorage({ maxEntries: ${context.telescope?.maxEntries} }),
670
- });` : ""}
671
-
672
- ${context.storageDrivers?.setup ? `// Which drivers exist — storage, cache, events — is the entry point's
673
- // decision: the scheme in each injected URL picks one, so no construct and no
674
- // application module names a provider.
675
- ${context.storageDrivers.setup}
676
- ` : ""}
677
- ${context.surface ? `// Who this server is to Postgres: application_name on every connection.
678
- process.env.GKM_APP_NAME ??= ${JSON.stringify(context.surface.id)};
679
-
680
- ` : ""}export interface ServerApp {
681
- app: HonoType;
682
- /** The origins this API's CORS allows: its own sites. */
683
- trustedOrigins: readonly string[];
684
- start: (options?: {
685
- port?: number;
686
- /** Returns the server, so a shutdown can stop it taking requests. */
687
- serve: (app: HonoType, port: number) => unknown;
688
- }) => Promise<void>;
689
- }
690
-
691
- /**
692
- * Create and configure the Hono application
693
- *
694
- * @param app - Optional Hono app instance to configure (creates new one if not provided)
695
- * @param enableOpenApi - Enable OpenAPI documentation (default: true)
696
- * @returns Server app with configured Hono app and start function
697
- *
698
- * @example
699
- * // With Bun
700
- * import { createApp } from './.gkm/server/app.js';
701
- *
702
- * const { app, start } = await createApp();
703
- *
704
- * await start({
705
- * port: 3000,
706
- * serve: (app, port) => {
707
- * Bun.serve({ port, fetch: app.fetch });
708
- * }
709
- * });
710
- *
711
- * @example
712
- * // With Node.js (using @hono/node-server)
713
- * import { serve } from '@hono/node-server';
714
- * import { createApp } from './.gkm/server/app.js';
715
- *
716
- * const { app, start } = await createApp();
717
- *
718
- * await start({
719
- * port: 3000,
720
- * serve: (app, port) => {
721
- * serve({ fetch: app.fetch, port });
722
- * }
723
- * });
724
- */
725
- export async function createApp(app?: HonoType, enableOpenApi: boolean = true): Promise<ServerApp> {
726
- const honoApp = app || new Hono();
727
- const trustedOrigins: string[] = [];
728
- ${telescopeSetup}${cors.setup}${beforeSetupCall}${databaseApiSetup}
729
- // Setup HTTP endpoints
730
- await setupEndpoints(honoApp, envParser, logger, enableOpenApi);
731
- ${afterSetupCall}
732
-
733
- return {
734
- app: honoApp,
735
- trustedOrigins,
736
- async start(options) {
737
- if (!options?.serve) {
738
- throw new Error(
739
- 'serve function is required. Pass a serve function for your runtime:\\n' +
740
- ' - Bun: (app, port) => Bun.serve({ port, fetch: app.fetch })\\n' +
741
- ' - Node: (app, port) => serve({ fetch: app.fetch, port })'
742
- );
743
- }
744
-
745
- const port = options.port ?? 3000;
746
-
747
- // Mount pushed subscribers' routes and start polled ones. What comes
748
- // back subscribes the routes, once the server can answer them.
749
- const subscribeForPush = await setupSubscribers(honoApp, envParser, logger).catch((error) => {
750
- logger.error({ err: error }, 'Failed to start subscribers');
751
- return async (_port: number) => {};
752
- });
753
-
754
- // Start queue workers in background (non-blocking, local development only)
755
- await setupQueues(envParser, logger).catch((error) => {
756
- logger.error({ err: error }, 'Failed to start queue workers');
757
- });
758
-
759
- // Schedule this app's crons. Caught like the others: a scheduler that
760
- // cannot start is not a reason for the HTTP server not to.
761
- await setupCrons(envParser, logger).catch((error) => {
762
- logger.error({ err: error }, 'Failed to schedule crons');
763
- });
764
-
765
- logger.info({ port }, 'Starting server');
766
-
767
- // Start HTTP server using provided serve function
768
- await options.serve(honoApp, port);
769
-
770
- logger.info({ port }, 'Server started');
771
-
772
- await subscribeForPush(port);
773
- }
774
- };
775
- }
776
-
777
- // Default export for convenience
778
- export default createApp;
779
- `;
780
- await (0, node_fs_promises.writeFile)(appPath, content);
781
- return appPath;
782
- }
783
- /**
784
- * One Lambda, one endpoint — and no environment import.
785
- *
786
- * The endpoint was built from its surface, so it carries the parser the
787
- * adaptor needs. This used to read
788
- * `import { envParser } from '../../config/env'`, a line the build wrote
789
- * because a generator can print a module specifier and cannot print an
790
- * object. Nothing has to be printed now, which is also why nothing has to be
791
- * named in config.
792
- */
793
- generateAWSApiGatewayV2Handler(importPath, exportName, drivers) {
794
- return `import { AmazonApiGatewayV2Endpoint } from '@geekmidas/constructs/aws';
795
- import { ${exportName} } from '${importPath}';
796
- ${drivers?.imports ?? ""}
797
- ${drivers?.setup ? `\n// The handler registers the drivers its target needs.\n${drivers.setup}\n` : ""}
798
- const adapter = new AmazonApiGatewayV2Endpoint(${exportName});
799
-
800
- export const handler = adapter.handler;
801
- `;
802
- }
803
- /**
804
- * Generate a production-optimized app.ts file
805
- * No dev tools (Telescope, Studio, WebSocket), includes health checks and graceful shutdown
806
- */
807
- async generateProductionAppFile(outputDir, context) {
808
- const appPath = (0, node_path.join)(outputDir, "app.ts");
809
- const runtime = runtimeFor(context, (0, node_path.dirname)(appPath));
810
- const production = context.production;
811
- const healthCheckPath = production.healthCheck;
812
- const enableGracefulShutdown = production.gracefulShutdown;
813
- const enableOpenApi = production.openapi;
814
- const includeSubscribers = production.subscribers === "include";
815
- const cors = corsFor(context.surface);
816
- let hooksImports = "";
817
- let beforeSetupCall = "";
818
- let afterSetupCall = "";
819
- if (context.hooks?.serverHooksPath) {
820
- hooksImports = `import * as serverHooks from '${(0, node_path.relative)((0, node_path.dirname)(appPath), context.hooks.serverHooksPath)}';`;
821
- beforeSetupCall = `
822
- // Call beforeSetup hook if defined
823
- if (typeof serverHooks.beforeSetup === 'function') {
824
- await serverHooks.beforeSetup(honoApp, { envParser, logger });
825
- }
826
- `;
827
- afterSetupCall = `
828
- // Call afterSetup hook if defined
829
- if (typeof serverHooks.afterSetup === 'function') {
830
- await serverHooks.afterSetup(honoApp, { envParser, logger });
831
- }
832
- `;
833
- }
834
- const subscriberSetup = includeSubscribers ? `
835
- // Mount pushed subscribers' routes and start polled ones. What comes
836
- // back subscribes the routes, once the server can answer them.
837
- const subscribeForPush = await setupSubscribers(honoApp, envParser, logger).catch((error) => {
838
- logger.error({ err: error }, 'Failed to start subscribers');
839
- return async (_port: number) => {};
840
- });
841
-
842
- // Start queue workers in background
843
- await setupQueues(envParser, logger).catch((error) => {
844
- logger.error({ err: error }, 'Failed to start queue workers');
845
- });
846
-
847
- // Schedule this app's crons. Caught like the others: a scheduler that
848
- // cannot start is not a reason for the HTTP server not to.
849
- await setupCrons(envParser, logger).catch((error) => {
850
- logger.error({ err: error }, 'Failed to schedule crons');
851
- });
852
- ` : "";
853
- const subscriberImport = includeSubscribers ? `import { setupSubscribers } from './subscribers.js';
854
- import { setupQueues } from './queues.js';
855
- import { setupCrons } from './crons.js';` : "";
856
- const gracefulShutdownCode = enableGracefulShutdown ? `
857
- // Graceful shutdown: stop taking requests, let in-flight ones finish, then
858
- // close what constructs opened (database pools) — so a rolling deploy does
859
- // not leave the old task holding connections. Bounded by
860
- // GKM_SHUTDOWN_TIMEOUT_MS, 8s by default: under Docker's 10s stop timeout,
861
- // so the process exits on its own terms rather than being killed mid-drain.
862
- let isShuttingDown = false;
863
-
864
- const shutdown = async () => {
865
- if (isShuttingDown) return;
866
- isShuttingDown = true;
867
- const deadline = Number(process.env.GKM_SHUTDOWN_TIMEOUT_MS) || 8000;
868
- logger.info({ deadline }, 'Graceful shutdown initiated');
869
- setTimeout(() => {
870
- logger.warn({ deadline }, 'Shutdown deadline reached, exiting');
871
- process.exit(1);
872
- }, deadline).unref();
873
- await new Promise<void>((resolve) => {
874
- const close = (server as { close?: (done: () => void) => void } | undefined)?.close;
875
- if (typeof close === 'function') close.call(server, () => resolve());
876
- else resolve();
877
- });
878
- await runShutdownHooks((error) => logger.error({ err: error }, 'Shutdown hook failed'));
879
- process.exit(0);
880
- };
881
-
882
- process.on('SIGTERM', shutdown);
883
- process.on('SIGINT', shutdown);
884
- ` : "";
885
- const content = `/**
886
- * Generated production server application
887
- *
888
- * This is a production-optimized build without dev tools.
889
- * - No Telescope debugging dashboard
890
- * - No Studio database browser
891
- * - No WebSocket updates
892
- * - Includes health checks and graceful shutdown
893
- */
894
- import { Hono } from 'hono';
895
- import type { Hono as HonoType } from 'hono';
896
- ${enableGracefulShutdown ? "import { runShutdownHooks } from '@geekmidas/constructs';\n" : ""}import { setupEndpoints } from './endpoints.js';
897
- ${subscriberImport}
898
- ${runtime.imports}
899
- ${runtime.bindings}
900
- ${hooksImports}
901
- ${cors.imports}
902
- ${context.storageDrivers?.imports ?? ""}
903
-
904
- ${context.storageDrivers?.setup ? `// The entry point registers the drivers its target needs.
905
- ${context.storageDrivers.setup}
906
- ` : ""}
907
- ${context.surface ? `// Who this server is to Postgres: application_name on every connection.
908
- process.env.GKM_APP_NAME ??= ${JSON.stringify(context.surface.id)};
909
-
910
- ` : ""}export interface ServerApp {
911
- app: HonoType;
912
- /** The origins this API's CORS allows: its own sites. */
913
- trustedOrigins: readonly string[];
914
- start: (options?: {
915
- port?: number;
916
- serve: (app: HonoType, port: number) => void | Promise<void>;
917
- }) => Promise<void>;
918
- }
919
-
920
- /**
921
- * Create and configure the production Hono application
922
- */
923
- export async function createApp(app?: HonoType): Promise<ServerApp> {
924
- const honoApp = app || new Hono();
925
- const trustedOrigins: string[] = [];
926
-
927
- // Health check endpoint (always first)
928
- honoApp.get('${healthCheckPath}', (c) => c.json({ status: 'ok', timestamp: Date.now() }));
929
- honoApp.get('/ready', (c) => c.json({ ready: true }));
930
-
931
- // An HttpError a handler or a session callback throws — a 401, a 404 —
932
- // answers with its own status, as it does under gkm dev. The optimized
933
- // handlers do not catch, so without this every one of them was a 500.
934
- // Anything else is a 500 that says nothing about why, and is logged.
935
- honoApp.onError((error, c) => {
936
- const http = error as {
937
- isHttpError?: boolean;
938
- statusCode?: number;
939
- statusMessage?: string;
940
- code?: string;
941
- details?: unknown;
942
- };
943
- if (http.isHttpError === true && typeof http.statusCode === 'number') {
944
- return c.json(
945
- {
946
- name: error.name,
947
- message: error.message,
948
- statusCode: http.statusCode,
949
- statusMessage: http.statusMessage,
950
- code: http.code,
951
- details: http.details,
952
- },
953
- http.statusCode as 500,
954
- );
955
- }
956
- logger.error({ err: error }, 'Unhandled error');
957
- return c.json({ message: 'Internal Server Error' }, 500);
958
- });
959
- ${cors.setup}${beforeSetupCall}
960
- // Setup HTTP endpoints (OpenAPI: ${enableOpenApi})
961
- await setupEndpoints(honoApp, envParser, logger, ${enableOpenApi});
962
- ${afterSetupCall}
963
- return {
964
- app: honoApp,
965
- trustedOrigins,
966
- async start(options) {
967
- if (!options?.serve) {
968
- throw new Error(
969
- 'serve function is required. Pass a serve function for your runtime:\\n' +
970
- ' - Bun: (app, port) => Bun.serve({ port, fetch: app.fetch })\\n' +
971
- ' - Node: (app, port) => serve({ fetch: app.fetch, port })'
972
- );
973
- }
974
-
975
- const port = options.port ?? Number(process.env.PORT) ?? 3000;
976
- let server: unknown;
977
- ${gracefulShutdownCode}${subscriberSetup}
978
- logger.info({ port }, 'Starting production server');
979
-
980
- // Start HTTP server using provided serve function
981
- server = await options.serve(honoApp, port);
982
-
983
- logger.info({ port }, 'Production server started');
984
- ${includeSubscribers ? "\n await subscribeForPush(port);" : ""}
985
- }
986
- };
987
- }
988
-
989
- // Default export for convenience
990
- export default createApp;
991
- `;
992
- await (0, node_fs_promises.writeFile)(appPath, content);
993
- await this.generateProductionServerEntry(outputDir, context);
994
- return appPath;
995
- }
996
- /**
997
- * Generate production server.ts entry point
998
- */
999
- async generateProductionServerEntry(outputDir, context) {
1000
- const serverPath = (0, node_path.join)(outputDir, "server.ts");
1001
- const content = `#!/usr/bin/env node
1002
- /**
1003
- * Production server entry point
1004
- * Generated by 'gkm build --production'
1005
- */
1006
- import { serve } from '@hono/node-server';
1007
- import { Hono } from 'hono';
1008
-
1009
- ${startTelemetryCode([context.production?.healthCheck ?? "/health", "/ready"])}
1010
- const { createApp } = await import('./app.js');
1011
-
1012
- const port = Number(process.env.PORT) || 3000;
1013
-
1014
- const app = new Hono();
1015
- ${mountRequestSpansCode("app")}
1016
- const created = await createApp(app);
1017
- trustedOrigins = created.trustedOrigins;
1018
- const { start } = created;
1019
-
1020
- await start({
1021
- port,
1022
- serve: (app, port) => serve({ fetch: app.fetch, port }),
1023
- });
1024
- `;
1025
- await (0, node_fs_promises.writeFile)(serverPath, content);
1026
- }
1027
- };
1028
- //#endregion
1029
- Object.defineProperty(exports, "EndpointGenerator", {
1030
- enumerable: true,
1031
- get: function() {
1032
- return EndpointGenerator;
1033
- }
1034
- });
1035
- Object.defineProperty(exports, "mountRequestSpansCode", {
1036
- enumerable: true,
1037
- get: function() {
1038
- return mountRequestSpansCode;
1039
- }
1040
- });
1041
- Object.defineProperty(exports, "parseTelemetryFlag", {
1042
- enumerable: true,
1043
- get: function() {
1044
- return parseTelemetryFlag;
1045
- }
1046
- });
1047
- Object.defineProperty(exports, "printTelemetryDefault", {
1048
- enumerable: true,
1049
- get: function() {
1050
- return printTelemetryDefault;
1051
- }
1052
- });
1053
- Object.defineProperty(exports, "routeTelemetry", {
1054
- enumerable: true,
1055
- get: function() {
1056
- return routeTelemetry;
1057
- }
1058
- });
1059
- Object.defineProperty(exports, "runtimeFor", {
1060
- enumerable: true,
1061
- get: function() {
1062
- return runtimeFor;
1063
- }
1064
- });
1065
- Object.defineProperty(exports, "startTelemetryCode", {
1066
- enumerable: true,
1067
- get: function() {
1068
- return startTelemetryCode;
1069
- }
1070
- });
1071
- Object.defineProperty(exports, "telemetryArgs", {
1072
- enumerable: true,
1073
- get: function() {
1074
- return telemetryArgs;
1075
- }
1076
- });
1077
- Object.defineProperty(exports, "telemetryFor", {
1078
- enumerable: true,
1079
- get: function() {
1080
- return telemetryFor;
1081
- }
1082
- });
1083
- Object.defineProperty(exports, "writeTelemetryModule", {
1084
- enumerable: true,
1085
- get: function() {
1086
- return writeTelemetryModule;
1087
- }
1088
- });
1089
-
1090
- //# sourceMappingURL=EndpointGenerator-De03t1hd.cjs.map