@geekmidas/cli 10.0.0-alpha.99 → 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 (676) 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 +11324 -10240
  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 +11327 -10231
  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-206NguW1.mjs +0 -388
  379. package/dist/GoDaddyProvider-206NguW1.mjs.map +0 -1
  380. package/dist/GoDaddyProvider-D1aQy2i1.cjs +0 -388
  381. package/dist/GoDaddyProvider-D1aQy2i1.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-CgJEr1G7.cjs +0 -124
  385. package/dist/LegacyStateStore-CgJEr1G7.cjs.map +0 -1
  386. package/dist/LegacyStateStore-wmFfdzuh.mjs +0 -124
  387. package/dist/LegacyStateStore-wmFfdzuh.mjs.map +0 -1
  388. package/dist/LocalStateStore-BD14kra9.cjs +0 -178
  389. package/dist/LocalStateStore-BD14kra9.cjs.map +0 -1
  390. package/dist/LocalStateStore-C5mNp91D.mjs +0 -167
  391. package/dist/LocalStateStore-C5mNp91D.mjs.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-CEGbsDHi.mjs +0 -223
  399. package/dist/S3StateStore-CEGbsDHi.mjs.map +0 -1
  400. package/dist/S3StateStore-Csu_kJCy.cjs +0 -222
  401. package/dist/S3StateStore-Csu_kJCy.cjs.map +0 -1
  402. package/dist/SSMStateStore-Bd62qwp4.mjs +0 -205
  403. package/dist/SSMStateStore-Bd62qwp4.mjs.map +0 -1
  404. package/dist/SSMStateStore-Rp21jtP5.cjs +0 -204
  405. package/dist/SSMStateStore-Rp21jtP5.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-DyIEYI97.mjs +0 -718
  411. package/dist/add-DyIEYI97.mjs.map +0 -1
  412. package/dist/add-Iuo3ao5E.cjs +0 -720
  413. package/dist/add-Iuo3ao5E.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-Bgoq8IyR.cjs +0 -169
  429. package/dist/bundler-Bgoq8IyR.cjs.map +0 -1
  430. package/dist/bundler-Q6Kp8b0r.mjs +0 -169
  431. package/dist/bundler-Q6Kp8b0r.mjs.map +0 -1
  432. package/dist/cli-B9BudUV0.mjs +0 -71
  433. package/dist/cli-B9BudUV0.mjs.map +0 -1
  434. package/dist/cli-W2DMRIbP.cjs +0 -71
  435. package/dist/cli-W2DMRIbP.cjs.map +0 -1
  436. package/dist/compose-CIrFNWHb.cjs +0 -3147
  437. package/dist/compose-CIrFNWHb.cjs.map +0 -1
  438. package/dist/compose-CLsRcHkA.mjs +0 -3052
  439. package/dist/compose-CLsRcHkA.mjs.map +0 -1
  440. package/dist/config-BVdHfj8b.d.cts +0 -269
  441. package/dist/config-BVdHfj8b.d.cts.map +0 -1
  442. package/dist/config-D2OqCmAM.d.mts +0 -269
  443. package/dist/config-D2OqCmAM.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 -212
  463. package/dist/deploy/public.cjs.map +0 -1
  464. package/dist/deploy/public.d.cts +0 -653
  465. package/dist/deploy/public.d.cts.map +0 -1
  466. package/dist/deploy/public.d.mts +0 -653
  467. package/dist/deploy/public.d.mts.map +0 -1
  468. package/dist/deploy/public.mjs +0 -145
  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-CbJMJsgX.cjs +0 -2032
  477. package/dist/deploy-CbJMJsgX.cjs.map +0 -1
  478. package/dist/deploy-n_IB8r6H.mjs +0 -1977
  479. package/dist/deploy-n_IB8r6H.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-Caf6Hnv1.d.cts +0 -108
  485. package/dist/discover-Caf6Hnv1.d.cts.map +0 -1
  486. package/dist/discover-Cd5M2jPv.d.mts +0 -108
  487. package/dist/discover-Cd5M2jPv.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-C_LPS3qV.mjs +0 -610
  493. package/dist/dns-C_LPS3qV.mjs.map +0 -1
  494. package/dist/dns-kp8To8Qj.cjs +0 -663
  495. package/dist/dns-kp8To8Qj.cjs.map +0 -1
  496. package/dist/dokploy-Dl_kNVeE.mjs +0 -38
  497. package/dist/dokploy-Dl_kNVeE.mjs.map +0 -1
  498. package/dist/dokploy-gRIae9Ht.cjs +0 -38
  499. package/dist/dokploy-gRIae9Ht.cjs.map +0 -1
  500. package/dist/drivers-CTaWrA_L.mjs +0 -177
  501. package/dist/drivers-CTaWrA_L.mjs.map +0 -1
  502. package/dist/drivers-DDojgzz0.cjs +0 -200
  503. package/dist/drivers-DDojgzz0.cjs.map +0 -1
  504. package/dist/emit-C1e8qD08.mjs +0 -193
  505. package/dist/emit-C1e8qD08.mjs.map +0 -1
  506. package/dist/emit-Dmc1nvdS.cjs +0 -210
  507. package/dist/emit-Dmc1nvdS.cjs.map +0 -1
  508. package/dist/encryption-C3DcVZQs.mjs +0 -89
  509. package/dist/encryption-C3DcVZQs.mjs.map +0 -1
  510. package/dist/encryption-CmQvQOSe.cjs +0 -90
  511. package/dist/encryption-CmQvQOSe.cjs.map +0 -1
  512. package/dist/engine-DBXuhHyf.mjs +0 -3081
  513. package/dist/engine-DBXuhHyf.mjs.map +0 -1
  514. package/dist/engine-Dk19Mxc4.cjs +0 -3194
  515. package/dist/engine-Dk19Mxc4.cjs.map +0 -1
  516. package/dist/errors-D8Gwp5kU.mjs +0 -23
  517. package/dist/errors-D8Gwp5kU.mjs.map +0 -1
  518. package/dist/errors-DMC4Umsb.cjs +0 -34
  519. package/dist/errors-DMC4Umsb.cjs.map +0 -1
  520. package/dist/github-Ds2RYnSU.cjs +0 -819
  521. package/dist/github-Ds2RYnSU.cjs.map +0 -1
  522. package/dist/github-RawRLERq.mjs +0 -819
  523. package/dist/github-RawRLERq.mjs.map +0 -1
  524. package/dist/identity-CBXr4wNi.mjs +0 -129
  525. package/dist/identity-CBXr4wNi.mjs.map +0 -1
  526. package/dist/identity-CbLfgQNT.cjs +0 -182
  527. package/dist/identity-CbLfgQNT.cjs.map +0 -1
  528. package/dist/index-BU4G20G6.d.cts +0 -190
  529. package/dist/index-BU4G20G6.d.cts.map +0 -1
  530. package/dist/index-yDbd1WcM.d.mts +0 -190
  531. package/dist/index-yDbd1WcM.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-CZIGT3kB.mjs +0 -266
  537. package/dist/migrate-CZIGT3kB.mjs.map +0 -1
  538. package/dist/migrate-CxZYzF_u.cjs +0 -181
  539. package/dist/migrate-CxZYzF_u.cjs.map +0 -1
  540. package/dist/migrate-DR1x96I4.mjs +0 -181
  541. package/dist/migrate-DR1x96I4.mjs.map +0 -1
  542. package/dist/migrate-DjrTwWJA.cjs +0 -271
  543. package/dist/migrate-DjrTwWJA.cjs.map +0 -1
  544. package/dist/openapi.cjs.map +0 -1
  545. package/dist/openapi.mjs.map +0 -1
  546. package/dist/projectBucket-BYOxRnHY.mjs +0 -177
  547. package/dist/projectBucket-BYOxRnHY.mjs.map +0 -1
  548. package/dist/projectBucket-CDu5rXjp.cjs +0 -206
  549. package/dist/projectBucket-CDu5rXjp.cjs.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-CNYbGH8g.mjs +0 -263
  567. package/dist/resolve-CNYbGH8g.mjs.map +0 -1
  568. package/dist/resolve-DC98Rl1t.cjs +0 -316
  569. package/dist/resolve-DC98Rl1t.cjs.map +0 -1
  570. package/dist/rollback-BkIkE8Qe.mjs +0 -136
  571. package/dist/rollback-BkIkE8Qe.mjs.map +0 -1
  572. package/dist/rollback-DBfLvC8k.cjs +0 -165
  573. package/dist/rollback-DBfLvC8k.cjs.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-CLz3bf07.d.mts +0 -82
  580. package/dist/runtime-CLz3bf07.d.mts.map +0 -1
  581. package/dist/runtime-CUWf0IUk.d.cts +0 -82
  582. package/dist/runtime-CUWf0IUk.d.cts.map +0 -1
  583. package/dist/s3-BwhQk3QM.mjs +0 -215
  584. package/dist/s3-BwhQk3QM.mjs.map +0 -1
  585. package/dist/s3-DLp0V-Ox.cjs +0 -215
  586. package/dist/s3-DLp0V-Ox.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-CHv3OYXg.cjs +0 -165
  612. package/dist/sandbox-CHv3OYXg.cjs.map +0 -1
  613. package/dist/sandbox-CbVB7uOD.mjs +0 -118
  614. package/dist/sandbox-CbVB7uOD.mjs.map +0 -1
  615. package/dist/sandbox-CfpLWTPP.d.mts +0 -104
  616. package/dist/sandbox-CfpLWTPP.d.mts.map +0 -1
  617. package/dist/sandbox-D1XeNEJ9.d.cts +0 -104
  618. package/dist/sandbox-D1XeNEJ9.d.cts.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/secretsManager-CQORubp9.mjs +0 -97
  624. package/dist/secretsManager-CQORubp9.mjs.map +0 -1
  625. package/dist/secretsManager-RAGcEDX1.cjs +0 -108
  626. package/dist/secretsManager-RAGcEDX1.cjs.map +0 -1
  627. package/dist/seeds-BNHSpjNP.cjs +0 -9096
  628. package/dist/seeds-BNHSpjNP.cjs.map +0 -1
  629. package/dist/seeds-C4bZ8L-T.mjs +0 -8141
  630. package/dist/seeds-C4bZ8L-T.mjs.map +0 -1
  631. package/dist/sniffer-BIBm9dAb.mjs +0 -1825
  632. package/dist/sniffer-BIBm9dAb.mjs.map +0 -1
  633. package/dist/sniffer-Cylp9W2D.cjs +0 -1998
  634. package/dist/sniffer-Cylp9W2D.cjs.map +0 -1
  635. package/dist/sst-CGdjHn2A.mjs +0 -441
  636. package/dist/sst-CGdjHn2A.mjs.map +0 -1
  637. package/dist/sst-DGuHDxVU.cjs +0 -464
  638. package/dist/sst-DGuHDxVU.cjs.map +0 -1
  639. package/dist/stages-CcS9vnNu.mjs +0 -176
  640. package/dist/stages-CcS9vnNu.mjs.map +0 -1
  641. package/dist/stages-DdBV7msu.cjs +0 -176
  642. package/dist/stages-DdBV7msu.cjs.map +0 -1
  643. package/dist/target/public.cjs +0 -15
  644. package/dist/target/public.d.cts +0 -28
  645. package/dist/target/public.d.cts.map +0 -1
  646. package/dist/target/public.d.mts +0 -28
  647. package/dist/target/public.d.mts.map +0 -1
  648. package/dist/target/public.mjs +0 -4
  649. package/dist/terminal-CPHuH4S1.cjs +0 -85
  650. package/dist/terminal-CPHuH4S1.cjs.map +0 -1
  651. package/dist/terminal-iNmAXXjs.mjs +0 -85
  652. package/dist/terminal-iNmAXXjs.mjs.map +0 -1
  653. package/dist/types-BhThob0H.d.mts +0 -7621
  654. package/dist/types-BhThob0H.d.mts.map +0 -1
  655. package/dist/types-DwoLHelT.d.cts +0 -7622
  656. package/dist/types-DwoLHelT.d.cts.map +0 -1
  657. package/dist/utils-D2Nk1Nv2.cjs +0 -205
  658. package/dist/utils-D2Nk1Nv2.cjs.map +0 -1
  659. package/dist/utils-D_fxUqvU.mjs +0 -156
  660. package/dist/utils-D_fxUqvU.mjs.map +0 -1
  661. package/dist/vitest.cjs +0 -65
  662. package/dist/vitest.cjs.map +0 -1
  663. package/dist/vitest.d.cts +0 -29
  664. package/dist/vitest.d.cts.map +0 -1
  665. package/dist/vitest.d.mts +0 -29
  666. package/dist/vitest.d.mts.map +0 -1
  667. package/dist/vitest.mjs +0 -65
  668. package/dist/vitest.mjs.map +0 -1
  669. package/dist/workerRuntime-BXfhbe13.cjs +0 -108
  670. package/dist/workerRuntime-BXfhbe13.cjs.map +0 -1
  671. package/dist/workerRuntime-CsOyBRx2.mjs +0 -79
  672. package/dist/workerRuntime-CsOyBRx2.mjs.map +0 -1
  673. package/dist/workspace-D5CpOp1y.mjs +0 -2108
  674. package/dist/workspace-D5CpOp1y.mjs.map +0 -1
  675. package/dist/workspace-DRjdu1OY.cjs +0 -2514
  676. package/dist/workspace-DRjdu1OY.cjs.map +0 -1
@@ -0,0 +1,843 @@
1
+ import { execSync } from 'node:child_process';
2
+ import { existsSync, readFileSync } from 'node:fs';
3
+ import { mkdir, readFile, writeFile } from 'node:fs/promises';
4
+ import { createServer } from 'node:net';
5
+ import { dirname, join, resolve } from 'node:path';
6
+ import { config as dotenvConfig } from 'dotenv';
7
+ import { parse as parseYaml } from 'yaml';
8
+ import {
9
+ getAppNameFromCwd,
10
+ loadWorkspaceAppInfo,
11
+ type WorkspaceAppInfo,
12
+ } from '../config';
13
+ import { generatePgBossUrl } from '../secrets/generator.js';
14
+ import {
15
+ readStageSecrets,
16
+ secretsExist,
17
+ toEmbeddableSecrets,
18
+ } from '../secrets/storage.js';
19
+ import { getDependencyEnvVars } from '../workspace/index.js';
20
+
21
+ const logger = console;
22
+
23
+ // ---------------------------------------------------------------------------
24
+ // Environment files
25
+ // ---------------------------------------------------------------------------
26
+
27
+ /**
28
+ * Load environment files
29
+ * @internal Exported for testing
30
+ */
31
+ export function loadEnvFiles(
32
+ envConfig: string | string[] | undefined,
33
+ cwd: string = process.cwd(),
34
+ ): { loaded: string[]; missing: string[] } {
35
+ const loaded: string[] = [];
36
+ const missing: string[] = [];
37
+
38
+ // Normalize to array
39
+ const envFiles = envConfig
40
+ ? Array.isArray(envConfig)
41
+ ? envConfig
42
+ : [envConfig]
43
+ : ['.env'];
44
+
45
+ // Load each env file in order (later files override earlier)
46
+ for (const envFile of envFiles) {
47
+ const envPath = resolve(cwd, envFile);
48
+ if (existsSync(envPath)) {
49
+ dotenvConfig({ path: envPath, override: true, quiet: true });
50
+ loaded.push(envFile);
51
+ } else if (envConfig) {
52
+ // Only report as missing if explicitly configured
53
+ missing.push(envFile);
54
+ }
55
+ }
56
+
57
+ return { loaded, missing };
58
+ }
59
+
60
+ // ---------------------------------------------------------------------------
61
+ // Port utilities
62
+ // ---------------------------------------------------------------------------
63
+
64
+ /**
65
+ * Check if a port is available
66
+ * @internal Exported for testing
67
+ */
68
+ export async function isPortAvailable(port: number): Promise<boolean> {
69
+ return new Promise((resolve) => {
70
+ const server = createServer();
71
+
72
+ server.once('error', (err: NodeJS.ErrnoException) => {
73
+ if (err.code === 'EADDRINUSE') {
74
+ resolve(false);
75
+ } else {
76
+ resolve(false);
77
+ }
78
+ });
79
+
80
+ server.once('listening', () => {
81
+ server.close();
82
+ resolve(true);
83
+ });
84
+
85
+ server.listen(port);
86
+ });
87
+ }
88
+
89
+ /**
90
+ * Find an available port starting from the preferred port
91
+ * @internal Exported for testing
92
+ */
93
+ export async function findAvailablePort(
94
+ preferredPort: number,
95
+ maxAttempts = 10,
96
+ ): Promise<number> {
97
+ for (let i = 0; i < maxAttempts; i++) {
98
+ const port = preferredPort + i;
99
+ if (await isPortAvailable(port)) {
100
+ return port;
101
+ }
102
+ logger.log(`⚠️ Port ${port} is in use, trying ${port + 1}...`);
103
+ }
104
+
105
+ throw new Error(
106
+ `Could not find an available port after trying ${maxAttempts} ports starting from ${preferredPort}`,
107
+ );
108
+ }
109
+
110
+ // ---------------------------------------------------------------------------
111
+ // Docker Compose port mapping
112
+ // ---------------------------------------------------------------------------
113
+
114
+ /**
115
+ * A port mapping extracted from docker-compose.yml.
116
+ * Only entries using env var interpolation (e.g., `${VAR:-default}:container`) are captured.
117
+ */
118
+ export interface ComposePortMapping {
119
+ service: string;
120
+ envVar: string;
121
+ defaultPort: number;
122
+ containerPort: number;
123
+ }
124
+
125
+ /** Port state persisted to .gkm/ports.json, keyed by env var name. */
126
+ export type PortState = Record<string, number>;
127
+
128
+ export interface ResolvedServicePorts {
129
+ dockerEnv: Record<string, string>;
130
+ ports: PortState;
131
+ mappings: ComposePortMapping[];
132
+ }
133
+
134
+ const PORT_STATE_PATH = '.gkm/ports.json';
135
+
136
+ /**
137
+ * Parse docker-compose.yml and extract all port mappings that use env var interpolation.
138
+ * Entries like `'${POSTGRES_HOST_PORT:-5432}:5432'` are captured.
139
+ * Fixed port mappings like `'5050:80'` are skipped.
140
+ * @internal Exported for testing
141
+ */
142
+ export function parseComposePortMappings(
143
+ composePath: string,
144
+ ): ComposePortMapping[] {
145
+ if (!existsSync(composePath)) {
146
+ return [];
147
+ }
148
+
149
+ const content = readFileSync(composePath, 'utf-8');
150
+ const compose = parseYaml(content) as {
151
+ services?: Record<string, { ports?: string[] }>;
152
+ };
153
+
154
+ if (!compose?.services) {
155
+ return [];
156
+ }
157
+
158
+ const results: ComposePortMapping[] = [];
159
+
160
+ for (const [serviceName, serviceConfig] of Object.entries(compose.services)) {
161
+ for (const portMapping of serviceConfig?.ports ?? []) {
162
+ const match = String(portMapping).match(/\$\{(\w+):-(\d+)\}:(\d+)/);
163
+ if (match?.[1] && match[2] && match[3]) {
164
+ results.push({
165
+ service: serviceName,
166
+ envVar: match[1],
167
+ defaultPort: Number(match[2]),
168
+ containerPort: Number(match[3]),
169
+ });
170
+ }
171
+ }
172
+ }
173
+
174
+ return results;
175
+ }
176
+
177
+ /**
178
+ * Load saved port state from .gkm/ports.json.
179
+ * @internal Exported for testing
180
+ */
181
+ export async function loadPortState(workspaceRoot: string): Promise<PortState> {
182
+ try {
183
+ const raw = await readFile(join(workspaceRoot, PORT_STATE_PATH), 'utf-8');
184
+ return JSON.parse(raw) as PortState;
185
+ } catch {
186
+ return {};
187
+ }
188
+ }
189
+
190
+ /**
191
+ * Save port state to .gkm/ports.json.
192
+ * @internal Exported for testing
193
+ */
194
+ export async function savePortState(
195
+ workspaceRoot: string,
196
+ ports: PortState,
197
+ ): Promise<void> {
198
+ const dir = join(workspaceRoot, '.gkm');
199
+ await mkdir(dir, { recursive: true });
200
+ await writeFile(
201
+ join(workspaceRoot, PORT_STATE_PATH),
202
+ `${JSON.stringify(ports, null, 2)}\n`,
203
+ );
204
+ }
205
+
206
+ /**
207
+ * Check if a project's own Docker container is running and return its host port.
208
+ * Uses `docker compose port` scoped to the project's compose file.
209
+ * @internal Exported for testing
210
+ */
211
+ export function getContainerHostPort(
212
+ workspaceRoot: string,
213
+ service: string,
214
+ containerPort: number,
215
+ ): number | null {
216
+ try {
217
+ const result = execSync(`docker compose port ${service} ${containerPort}`, {
218
+ cwd: workspaceRoot,
219
+ stdio: 'pipe',
220
+ })
221
+ .toString()
222
+ .trim();
223
+ const match = result.match(/:(\d+)$/);
224
+ return match ? Number(match[1]) : null;
225
+ } catch {
226
+ return null;
227
+ }
228
+ }
229
+
230
+ /**
231
+ * Resolve host ports for Docker services by parsing docker-compose.yml.
232
+ * Priority: running container → saved state → find available port.
233
+ * Persists resolved ports to .gkm/ports.json.
234
+ * @internal Exported for testing
235
+ */
236
+ export async function resolveServicePorts(
237
+ workspaceRoot: string,
238
+ ): Promise<ResolvedServicePorts> {
239
+ const composePath = join(workspaceRoot, 'docker-compose.yml');
240
+ const mappings = parseComposePortMappings(composePath);
241
+
242
+ if (mappings.length === 0) {
243
+ return { dockerEnv: {}, ports: {}, mappings: [] };
244
+ }
245
+
246
+ const savedState = await loadPortState(workspaceRoot);
247
+ const dockerEnv: Record<string, string> = {};
248
+ const ports: PortState = {};
249
+ // Track ports assigned in this cycle to avoid duplicates
250
+ const assignedPorts = new Set<number>();
251
+
252
+ logger.log('\n🔌 Resolving service ports...');
253
+
254
+ for (const mapping of mappings) {
255
+ // 1. Check if own container is already running
256
+ const containerPort = getContainerHostPort(
257
+ workspaceRoot,
258
+ mapping.service,
259
+ mapping.containerPort,
260
+ );
261
+ if (containerPort !== null) {
262
+ ports[mapping.envVar] = containerPort;
263
+ dockerEnv[mapping.envVar] = String(containerPort);
264
+ assignedPorts.add(containerPort);
265
+ logger.log(
266
+ ` 🔄 ${mapping.service}:${mapping.containerPort}: reusing existing container on port ${containerPort}`,
267
+ );
268
+ continue;
269
+ }
270
+
271
+ // 2. Check saved port state
272
+ const savedPort = savedState[mapping.envVar];
273
+ if (
274
+ savedPort &&
275
+ !assignedPorts.has(savedPort) &&
276
+ (await isPortAvailable(savedPort))
277
+ ) {
278
+ ports[mapping.envVar] = savedPort;
279
+ dockerEnv[mapping.envVar] = String(savedPort);
280
+ assignedPorts.add(savedPort);
281
+ logger.log(
282
+ ` 💾 ${mapping.service}:${mapping.containerPort}: using saved port ${savedPort}`,
283
+ );
284
+ continue;
285
+ }
286
+
287
+ // 3. Find available port (skipping ports already assigned this cycle)
288
+ let resolvedPort = await findAvailablePort(mapping.defaultPort);
289
+ while (assignedPorts.has(resolvedPort)) {
290
+ resolvedPort = await findAvailablePort(resolvedPort + 1);
291
+ }
292
+ ports[mapping.envVar] = resolvedPort;
293
+ dockerEnv[mapping.envVar] = String(resolvedPort);
294
+ assignedPorts.add(resolvedPort);
295
+
296
+ if (resolvedPort !== mapping.defaultPort) {
297
+ logger.log(
298
+ ` ⚡ ${mapping.service}:${mapping.containerPort}: port ${mapping.defaultPort} occupied, using port ${resolvedPort}`,
299
+ );
300
+ } else {
301
+ logger.log(
302
+ ` ✅ ${mapping.service}:${mapping.containerPort}: using default port ${resolvedPort}`,
303
+ );
304
+ }
305
+ }
306
+
307
+ await savePortState(workspaceRoot, ports);
308
+
309
+ return { dockerEnv, ports, mappings };
310
+ }
311
+
312
+ // ---------------------------------------------------------------------------
313
+ // URL rewriting
314
+ // ---------------------------------------------------------------------------
315
+
316
+ /**
317
+ * Replace a port in a URL string.
318
+ * Handles both `hostname:port` and `localhost:port` patterns.
319
+ * @internal Exported for testing
320
+ */
321
+ export function replacePortInUrl(
322
+ url: string,
323
+ oldPort: number,
324
+ newPort: number,
325
+ ): string {
326
+ if (oldPort === newPort) return url;
327
+ // Replace literal :port (in authority section)
328
+ let result = url.replace(
329
+ new RegExp(`:${oldPort}(?=[/?#]|$)`, 'g'),
330
+ `:${newPort}`,
331
+ );
332
+ // Replace URL-encoded :port (e.g., in query params like endpoint=http%3A%2F%2Flocalhost%3A4566)
333
+ result = result.replace(
334
+ new RegExp(`%3A${oldPort}(?=[%/?#&]|$)`, 'gi'),
335
+ `%3A${newPort}`,
336
+ );
337
+ return result;
338
+ }
339
+
340
+ /**
341
+ * Rewrite connection URLs and port vars in secrets with resolved ports.
342
+ * Uses the parsed compose mappings to determine which default ports to replace.
343
+ * Pure transform — does not modify secrets on disk.
344
+ * @internal Exported for testing
345
+ */
346
+ export function rewriteUrlsWithPorts(
347
+ secrets: Record<string, string>,
348
+ resolvedPorts: ResolvedServicePorts,
349
+ ): Record<string, string> {
350
+ const { ports, mappings } = resolvedPorts;
351
+ const result = { ...secrets };
352
+
353
+ // Build a map of defaultPort → resolvedPort for all changed ports
354
+ const portReplacements: { defaultPort: number; resolvedPort: number }[] = [];
355
+ // Collect Docker service names for hostname rewriting
356
+ const serviceNames = new Set<string>();
357
+ for (const mapping of mappings) {
358
+ serviceNames.add(mapping.service);
359
+ const resolved = ports[mapping.envVar];
360
+ if (resolved !== undefined) {
361
+ portReplacements.push({
362
+ defaultPort: mapping.defaultPort,
363
+ resolvedPort: resolved,
364
+ });
365
+ }
366
+ }
367
+
368
+ // Rewrite _HOST env vars that use Docker service names
369
+ for (const [key, value] of Object.entries(result)) {
370
+ if (!key.endsWith('_HOST')) continue;
371
+ if (serviceNames.has(value)) {
372
+ result[key] = 'localhost';
373
+ }
374
+ }
375
+
376
+ // Rewrite _PORT env vars whose values match a default port
377
+ for (const [key, value] of Object.entries(result)) {
378
+ if (!key.endsWith('_PORT')) continue;
379
+ for (const { defaultPort, resolvedPort } of portReplacements) {
380
+ if (value === String(defaultPort)) {
381
+ result[key] = String(resolvedPort);
382
+ }
383
+ }
384
+ }
385
+
386
+ // Rewrite URLs: replace Docker service hostnames with localhost and fix ports
387
+ for (const [key, value] of Object.entries(result)) {
388
+ if (
389
+ !key.endsWith('_URL') &&
390
+ !key.endsWith('_ENDPOINT') &&
391
+ !key.endsWith('_CONNECTION_STRING') &&
392
+ key !== 'DATABASE_URL'
393
+ )
394
+ continue;
395
+
396
+ let rewritten = value;
397
+ for (const name of serviceNames) {
398
+ rewritten = rewritten.replace(
399
+ new RegExp(`@${name}:`, 'g'),
400
+ '@localhost:',
401
+ );
402
+ }
403
+ for (const { defaultPort, resolvedPort } of portReplacements) {
404
+ rewritten = replacePortInUrl(rewritten, defaultPort, resolvedPort);
405
+ }
406
+ result[key] = rewritten;
407
+ }
408
+
409
+ return result;
410
+ }
411
+
412
+ // ---------------------------------------------------------------------------
413
+ // Docker Compose services
414
+ // ---------------------------------------------------------------------------
415
+
416
+ /**
417
+ * Build the environment variables to pass to `docker compose up`.
418
+ * Merges process.env, secrets, and port mappings so that Docker Compose
419
+ * can interpolate variables like ${POSTGRES_USER} correctly.
420
+ * @internal Exported for testing
421
+ */
422
+ export function buildDockerComposeEnv(
423
+ secretsEnv?: Record<string, string>,
424
+ portEnv?: Record<string, string>,
425
+ ): Record<string, string | undefined> {
426
+ return { ...process.env, ...secretsEnv, ...portEnv };
427
+ }
428
+
429
+ /**
430
+ * Parse all service names from a docker-compose.yml file.
431
+ * @internal Exported for testing
432
+ */
433
+ export function parseComposeServiceNames(composePath: string): string[] {
434
+ if (!existsSync(composePath)) {
435
+ return [];
436
+ }
437
+
438
+ const content = readFileSync(composePath, 'utf-8');
439
+ const compose = parseYaml(content) as {
440
+ services?: Record<string, unknown>;
441
+ };
442
+
443
+ return Object.keys(compose?.services ?? {});
444
+ }
445
+
446
+ /**
447
+ * Start docker-compose services for a single-app project (no workspace config).
448
+ * Starts all services defined in docker-compose.yml.
449
+ */
450
+ export async function startComposeServices(
451
+ cwd: string,
452
+ portEnv?: Record<string, string>,
453
+ secretsEnv?: Record<string, string>,
454
+ ): Promise<void> {
455
+ const composeFile = join(cwd, 'docker-compose.yml');
456
+ if (!existsSync(composeFile)) {
457
+ return;
458
+ }
459
+
460
+ const servicesToStart = parseComposeServiceNames(composeFile);
461
+ if (servicesToStart.length === 0) {
462
+ return;
463
+ }
464
+
465
+ logger.log(`🐳 Starting services: ${servicesToStart.join(', ')}`);
466
+
467
+ try {
468
+ execSync(`docker compose up -d ${servicesToStart.join(' ')}`, {
469
+ cwd,
470
+ stdio: 'inherit',
471
+ env: buildDockerComposeEnv(secretsEnv, portEnv),
472
+ });
473
+
474
+ logger.log('✅ Services started');
475
+ } catch (error) {
476
+ logger.error('❌ Failed to start services:', (error as Error).message);
477
+ throw error;
478
+ }
479
+ }
480
+
481
+ /**
482
+ * Start docker-compose services for a workspace.
483
+ * Discovers all services from docker-compose.yml and starts everything
484
+ * except app services (which are managed by turbo).
485
+ * @internal Exported for testing
486
+ */
487
+ export async function startWorkspaceServices(
488
+ workspace: { root: string; apps: Record<string, unknown> },
489
+ portEnv?: Record<string, string>,
490
+ secretsEnv?: Record<string, string>,
491
+ ): Promise<void> {
492
+ const composeFile = join(workspace.root, 'docker-compose.yml');
493
+ if (!existsSync(composeFile)) {
494
+ return;
495
+ }
496
+
497
+ // Discover all services from docker-compose.yml
498
+ const allServices = parseComposeServiceNames(composeFile);
499
+
500
+ // Exclude app services (managed by turbo, not docker)
501
+ const appNames = new Set(Object.keys(workspace.apps));
502
+ const servicesToStart = allServices.filter((name) => !appNames.has(name));
503
+
504
+ if (servicesToStart.length === 0) {
505
+ return;
506
+ }
507
+
508
+ logger.log(`🐳 Starting services: ${servicesToStart.join(', ')}`);
509
+
510
+ try {
511
+ // Start services with docker-compose, passing secrets so that
512
+ // POSTGRES_USER, POSTGRES_PASSWORD, etc. are interpolated correctly
513
+ execSync(`docker compose up -d ${servicesToStart.join(' ')}`, {
514
+ cwd: workspace.root,
515
+ stdio: 'inherit',
516
+ env: buildDockerComposeEnv(secretsEnv, portEnv),
517
+ });
518
+
519
+ logger.log('✅ Services started');
520
+ } catch (error) {
521
+ logger.error('❌ Failed to start services:', (error as Error).message);
522
+ throw error;
523
+ }
524
+ }
525
+
526
+ // ---------------------------------------------------------------------------
527
+ // Secrets loading
528
+ // ---------------------------------------------------------------------------
529
+
530
+ /**
531
+ * Load and flatten secrets for an app from encrypted storage.
532
+ * For workspace app: maps {APP}_DATABASE_URL → DATABASE_URL.
533
+ * @internal Exported for testing
534
+ */
535
+ export async function loadSecretsForApp(
536
+ secretsRoot: string,
537
+ appName?: string,
538
+ stages: string[] = ['dev', 'development'],
539
+ ): Promise<Record<string, string>> {
540
+ let secrets: Record<string, string> = {};
541
+
542
+ for (const stage of stages) {
543
+ if (secretsExist(stage, secretsRoot)) {
544
+ const stageSecrets = await readStageSecrets(stage, secretsRoot);
545
+ if (stageSecrets) {
546
+ logger.log(`🔐 Loading secrets from stage: ${stage}`);
547
+ secrets = toEmbeddableSecrets(stageSecrets);
548
+ break;
549
+ }
550
+ }
551
+ }
552
+
553
+ if (Object.keys(secrets).length === 0) {
554
+ return {};
555
+ }
556
+
557
+ // Single app mode - no mapping needed
558
+ if (!appName) {
559
+ return secrets;
560
+ }
561
+
562
+ // Workspace app mode - map {APP}_* to generic names
563
+ const prefix = appName.toUpperCase();
564
+ const mapped = { ...secrets };
565
+
566
+ // Map {APP}_DATABASE_URL → DATABASE_URL
567
+ const appDbUrl = secrets[`${prefix}_DATABASE_URL`];
568
+ if (appDbUrl) {
569
+ mapped.DATABASE_URL = appDbUrl;
570
+ }
571
+
572
+ return mapped;
573
+ }
574
+
575
+ /**
576
+ * Walk up the directory tree to find the root containing .gkm/secrets/.
577
+ * @internal Exported for testing
578
+ */
579
+ export function findSecretsRoot(startDir: string): string {
580
+ let dir = startDir;
581
+ while (dir !== '/') {
582
+ if (existsSync(join(dir, '.gkm', 'secrets'))) {
583
+ return dir;
584
+ }
585
+ const parent = dirname(dir);
586
+ if (parent === dir) break;
587
+ dir = parent;
588
+ }
589
+ return startDir;
590
+ }
591
+
592
+ // ---------------------------------------------------------------------------
593
+ // Credentials preload / injection
594
+ // ---------------------------------------------------------------------------
595
+
596
+ /**
597
+ * Generate the credentials injection code snippet.
598
+ * This is the common logic used by both entry wrapper and exec preload.
599
+ * @internal
600
+ */
601
+ function generateCredentialsInjection(secretsJsonPath: string): string {
602
+ return `import { existsSync, readFileSync } from 'node:fs';
603
+
604
+ // Inject dev secrets via globalThis and process.env
605
+ // Using globalThis.__gkm_credentials__ avoids CJS/ESM interop issues where
606
+ // Object.assign on the Credentials export only mutates one module copy.
607
+ const secretsPath = '${secretsJsonPath}';
608
+ if (existsSync(secretsPath)) {
609
+ const secrets = JSON.parse(readFileSync(secretsPath, 'utf-8'));
610
+ globalThis.__gkm_credentials__ = secrets;
611
+ Object.assign(process.env, secrets);
612
+ }
613
+ `;
614
+ }
615
+
616
+ /**
617
+ * Create a preload script that injects secrets into Credentials.
618
+ * Used by `gkm exec` to inject secrets before running any command.
619
+ * @internal Exported for testing
620
+ */
621
+ export async function createCredentialsPreload(
622
+ preloadPath: string,
623
+ secretsJsonPath: string,
624
+ ): Promise<void> {
625
+ const content = `/**
626
+ * Credentials preload generated by 'gkm exec'
627
+ * This file is loaded via NODE_OPTIONS="--import <path>"
628
+ */
629
+ ${generateCredentialsInjection(secretsJsonPath)}`;
630
+
631
+ await writeFile(preloadPath, content);
632
+ }
633
+
634
+ /**
635
+ * Create a wrapper script that injects secrets before importing the entry file.
636
+ * @internal Exported for testing
637
+ */
638
+ export async function createEntryWrapper(
639
+ wrapperPath: string,
640
+ entryPath: string,
641
+ secretsJsonPath?: string,
642
+ ): Promise<void> {
643
+ const credentialsInjection = secretsJsonPath
644
+ ? `${generateCredentialsInjection(secretsJsonPath)}
645
+ `
646
+ : '';
647
+
648
+ // Use dynamic import() to ensure secrets are assigned before the entry file loads
649
+ // Static imports are hoisted, so Object.assign would run after the entry file is loaded
650
+ const content = `#!/usr/bin/env node
651
+ /**
652
+ * Entry wrapper generated by 'gkm dev --entry'
653
+ */
654
+ ${credentialsInjection}// Import and run the user's entry file (dynamic import ensures secrets load first)
655
+ await import('${entryPath}');
656
+ `;
657
+
658
+ await writeFile(wrapperPath, content);
659
+ }
660
+
661
+ // ---------------------------------------------------------------------------
662
+ // Prepare credentials (shared by dev, exec, test)
663
+ // ---------------------------------------------------------------------------
664
+
665
+ /**
666
+ * Result of preparing credentials.
667
+ */
668
+ export interface EntryCredentialsResult {
669
+ /** Credentials to inject (secrets + PORT) */
670
+ credentials: Record<string, string>;
671
+ /** Resolved port (from --port, workspace config, or default 3000) */
672
+ resolvedPort: number;
673
+ /** Path where credentials JSON was written */
674
+ secretsJsonPath: string;
675
+ /** Resolved app name (if in workspace) */
676
+ appName: string | undefined;
677
+ /** Secrets root directory */
678
+ secretsRoot: string;
679
+ /** Workspace app info (if in a workspace) */
680
+ appInfo?: WorkspaceAppInfo;
681
+ }
682
+
683
+ /**
684
+ * Prepare credentials for dev/exec/test modes.
685
+ * Loads workspace config, secrets, resolves Docker ports, rewrites URLs,
686
+ * injects PORT, dependency URLs, and writes credentials JSON.
687
+ *
688
+ * @param options.resolveDockerPorts - How to resolve Docker ports:
689
+ * - `'full'` (default): probe running containers, saved state, then find available ports. Used by dev/test.
690
+ * - `'readonly'`: check running containers and saved state only, never probe for new ports. Used by exec.
691
+ * @param options.stages - Secret stages to try, in order. Default: ['dev', 'development'].
692
+ * @param options.startDocker - Start Docker Compose services after port resolution. Default: false.
693
+ * @param options.secretsFileName - Custom secrets JSON filename. Default: 'dev-secrets-{appName}.json' or 'dev-secrets.json'.
694
+ * @internal Exported for testing
695
+ */
696
+ export async function prepareEntryCredentials(options: {
697
+ explicitPort?: number;
698
+ cwd?: string;
699
+ resolveDockerPorts?: 'full' | 'readonly';
700
+ /** Secret stages to try, in order. Default: ['dev', 'development'] */
701
+ stages?: string[];
702
+ /** Start Docker Compose services after port resolution. Default: false */
703
+ startDocker?: boolean;
704
+ /** Custom secrets JSON filename. Default: 'dev-secrets-{appName}.json' or 'dev-secrets.json' */
705
+ secretsFileName?: string;
706
+ }): Promise<EntryCredentialsResult> {
707
+ const cwd = options.cwd ?? process.cwd();
708
+ const portMode = options.resolveDockerPorts ?? 'full';
709
+
710
+ // Try to get workspace app config for port and secrets
711
+ let workspaceAppPort: number | undefined;
712
+ let secretsRoot: string = cwd;
713
+ let appName: string | undefined;
714
+ let appInfo: WorkspaceAppInfo | undefined;
715
+
716
+ try {
717
+ appInfo = await loadWorkspaceAppInfo(cwd);
718
+ workspaceAppPort = appInfo.app.port;
719
+ secretsRoot = appInfo.workspaceRoot;
720
+ appName = appInfo.appName;
721
+ } catch {
722
+ // Not in a workspace - use defaults (expected for non-gkm apps using gkm exec)
723
+ secretsRoot = findSecretsRoot(cwd);
724
+ appName = getAppNameFromCwd(cwd) ?? undefined;
725
+ }
726
+
727
+ // Determine port: explicit --port > workspace config > default 3000
728
+ const resolvedPort = options.explicitPort ?? workspaceAppPort ?? 3000;
729
+
730
+ // Load secrets and inject PORT
731
+ const credentials = await loadSecretsForApp(
732
+ secretsRoot,
733
+ appName,
734
+ options.stages,
735
+ );
736
+
737
+ // Always inject PORT into credentials so apps can read it
738
+ credentials.PORT = String(resolvedPort);
739
+
740
+ // Resolve Docker ports and rewrite connection URLs
741
+ const composePath = join(secretsRoot, 'docker-compose.yml');
742
+ const mappings = parseComposePortMappings(composePath);
743
+ if (mappings.length > 0) {
744
+ let resolvedPorts: ResolvedServicePorts;
745
+
746
+ if (portMode === 'full') {
747
+ // Full resolution: probe containers, saved state, find available ports
748
+ resolvedPorts = await resolveServicePorts(secretsRoot);
749
+ } else {
750
+ // Readonly: check running containers and saved state only
751
+ const savedPorts = await loadPortState(secretsRoot);
752
+ const ports: PortState = {};
753
+
754
+ for (const mapping of mappings) {
755
+ const containerPort = getContainerHostPort(
756
+ secretsRoot,
757
+ mapping.service,
758
+ mapping.containerPort,
759
+ );
760
+ if (containerPort !== null) {
761
+ ports[mapping.envVar] = containerPort;
762
+ } else {
763
+ const saved = savedPorts[mapping.envVar];
764
+ if (saved !== undefined) {
765
+ ports[mapping.envVar] = saved;
766
+ }
767
+ }
768
+ }
769
+
770
+ resolvedPorts = { dockerEnv: {}, ports, mappings };
771
+ }
772
+
773
+ // Start Docker services if requested (between port resolution and URL rewriting)
774
+ // Docker needs raw secrets (POSTGRES_USER, etc.) + resolved port env for compose interpolation
775
+ if (options.startDocker) {
776
+ if (appInfo) {
777
+ await startWorkspaceServices(
778
+ appInfo.workspace,
779
+ resolvedPorts.dockerEnv,
780
+ credentials,
781
+ );
782
+ } else {
783
+ await startComposeServices(
784
+ secretsRoot,
785
+ resolvedPorts.dockerEnv,
786
+ credentials,
787
+ );
788
+ }
789
+ }
790
+
791
+ if (Object.keys(resolvedPorts.ports).length > 0) {
792
+ const rewritten = rewriteUrlsWithPorts(credentials, resolvedPorts);
793
+ Object.assign(credentials, rewritten);
794
+ logger.log(
795
+ `🔌 Applied ${Object.keys(resolvedPorts.ports).length} port mapping(s)`,
796
+ );
797
+ }
798
+ }
799
+
800
+ // Inject dependency URLs (works for both frontend and backend apps)
801
+ if (appInfo?.appName) {
802
+ const depEnv = getDependencyEnvVars(appInfo.workspace, appInfo.appName);
803
+ Object.assign(credentials, depEnv);
804
+ }
805
+
806
+ // Default event connection strings to pgboss when postgres is available.
807
+ // Normally these come from secrets (gkm setup always creates pgboss credentials),
808
+ // but this handles old secrets files that predate the pgboss default.
809
+ if (
810
+ !credentials.EVENT_PUBLISHER_CONNECTION_STRING &&
811
+ !credentials.EVENT_SUBSCRIBER_CONNECTION_STRING &&
812
+ credentials.PGBOSS_DB_USER
813
+ ) {
814
+ const pgbossUrl = generatePgBossUrl({
815
+ username: credentials.PGBOSS_DB_USER,
816
+ password: credentials.PGBOSS_DB_PASSWORD ?? '',
817
+ host: credentials.POSTGRES_HOST ?? 'localhost',
818
+ port: Number(credentials.POSTGRES_PORT ?? '5432'),
819
+ database: credentials.POSTGRES_DB ?? 'app',
820
+ });
821
+ credentials.EVENT_PUBLISHER_CONNECTION_STRING = pgbossUrl;
822
+ credentials.EVENT_SUBSCRIBER_CONNECTION_STRING = pgbossUrl;
823
+ }
824
+
825
+ // Write secrets to temp JSON file (always write since we have PORT)
826
+ // Use app-specific filename to avoid race conditions when running multiple apps via turbo
827
+ const secretsDir = join(secretsRoot, '.gkm');
828
+ await mkdir(secretsDir, { recursive: true });
829
+ const secretsFileName =
830
+ options.secretsFileName ??
831
+ (appName ? `dev-secrets-${appName}.json` : 'dev-secrets.json');
832
+ const secretsJsonPath = join(secretsDir, secretsFileName);
833
+ await writeFile(secretsJsonPath, JSON.stringify(credentials, null, 2));
834
+
835
+ return {
836
+ credentials,
837
+ resolvedPort,
838
+ secretsJsonPath,
839
+ appName,
840
+ secretsRoot,
841
+ appInfo,
842
+ };
843
+ }