@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,943 @@
1
+ import type { AwsRegion, StateConfig } from '../deploy/StateProvider.js';
2
+
3
+ export type { AwsRegion };
4
+
5
+ import type {
6
+ GkmConfig,
7
+ HooksConfig,
8
+ OpenApiConfig,
9
+ ProvidersConfig,
10
+ Routes,
11
+ Runtime,
12
+ StudioConfig,
13
+ TelescopeConfig,
14
+ } from '../types.js';
15
+ import type {
16
+ BackendFramework,
17
+ BackupsConfig,
18
+ DnsConfig,
19
+ DnsProvider,
20
+ Framework,
21
+ FrontendFramework,
22
+ MobileFramework,
23
+ } from './schema.js';
24
+
25
+ export type {
26
+ BackendFramework,
27
+ BackupsConfig,
28
+ DnsConfig,
29
+ DnsProvider,
30
+ Framework,
31
+ FrontendFramework,
32
+ MobileFramework,
33
+ };
34
+
35
+ /**
36
+ * Deploy target for an app.
37
+ *
38
+ * Specifies where the app will be deployed.
39
+ *
40
+ * @example
41
+ * ```ts
42
+ * // Currently supported
43
+ * deploy: 'dokploy'
44
+ *
45
+ * // Future support (not yet implemented)
46
+ * deploy: 'vercel'
47
+ * deploy: 'cloudflare'
48
+ * ```
49
+ */
50
+ export type DeployTarget = 'dokploy' | 'vercel' | 'cloudflare';
51
+
52
+ /**
53
+ * Service image configuration for custom Docker images.
54
+ *
55
+ * @example
56
+ * ```ts
57
+ * // Use specific version
58
+ * db: { version: '18-alpine' }
59
+ *
60
+ * // Use custom image
61
+ * db: { image: 'timescale/timescaledb:latest-pg16' }
62
+ * ```
63
+ */
64
+ export interface ServiceImageConfig {
65
+ /** Docker image version/tag (e.g., '18-alpine') */
66
+ version?: string;
67
+ /** Full Docker image reference (overrides version) */
68
+ image?: string;
69
+ }
70
+
71
+ /**
72
+ * Mail service configuration.
73
+ *
74
+ * In development, uses Mailpit for email testing.
75
+ * In production, uses SMTP configuration.
76
+ *
77
+ * @example
78
+ * ```ts
79
+ * services: {
80
+ * mail: {
81
+ * smtp: {
82
+ * host: 'smtp.sendgrid.net',
83
+ * port: 587,
84
+ * user: 'apikey',
85
+ * pass: process.env.SENDGRID_API_KEY,
86
+ * }
87
+ * }
88
+ * }
89
+ * ```
90
+ */
91
+ export interface MailServiceConfig extends ServiceImageConfig {
92
+ /** SMTP configuration for production */
93
+ smtp?: {
94
+ host: string;
95
+ port: number;
96
+ user?: string;
97
+ pass?: string;
98
+ };
99
+ }
100
+
101
+ /**
102
+ * Development services configuration.
103
+ *
104
+ * Configures shared infrastructure services like databases and caches.
105
+ * These are automatically provisioned in Dokploy during deployment.
106
+ *
107
+ * @example
108
+ * ```ts
109
+ * // Enable with defaults
110
+ * services: {
111
+ * db: true, // postgres:18-alpine
112
+ * cache: true, // redis:8-alpine
113
+ * }
114
+ *
115
+ * // Custom versions
116
+ * services: {
117
+ * db: { version: '18-alpine' },
118
+ * cache: { version: '7-alpine' },
119
+ * }
120
+ *
121
+ * // Custom images
122
+ * services: {
123
+ * db: { image: 'timescale/timescaledb:latest-pg16' },
124
+ * }
125
+ *
126
+ * // With mail service
127
+ * services: {
128
+ * db: true,
129
+ * cache: true,
130
+ * mail: true, // Mailpit in dev
131
+ * }
132
+ *
133
+ * // With event backend
134
+ * services: {
135
+ * db: true,
136
+ * cache: true,
137
+ * events: 'pgboss', // reuses postgres (auto-enables db)
138
+ * // events: 'sns', // adds LocalStack container
139
+ * // events: 'rabbitmq', // adds RabbitMQ container
140
+ * }
141
+ * ```
142
+ */
143
+ export interface ServicesConfig {
144
+ /** PostgreSQL database (default: postgres:18-alpine) */
145
+ db?: boolean | ServiceImageConfig;
146
+ /** Redis cache (default: redis:8-alpine) */
147
+ cache?: boolean | ServiceImageConfig;
148
+ /** Mail service (mailpit for dev) */
149
+ mail?: boolean | MailServiceConfig;
150
+ /** MinIO S3-compatible object storage (default: pgsty/minio:RELEASE.2026-08-04T00-00-00Z) */
151
+ storage?: boolean | ServiceImageConfig;
152
+ /** Event backend: pgboss (reuses postgres), sns (LocalStack), or rabbitmq */
153
+ events?: import('../types.js').EventsBackend;
154
+ }
155
+
156
+ /**
157
+ * Stage-based domain configuration.
158
+ *
159
+ * Maps deployment stages to base domains. The main frontend app
160
+ * gets the base domain, other apps get `{appName}.{baseDomain}`.
161
+ *
162
+ * @example
163
+ * ```ts
164
+ * domains: {
165
+ * development: 'dev.myapp.com',
166
+ * staging: 'staging.myapp.com',
167
+ * production: 'myapp.com',
168
+ * }
169
+ *
170
+ * // Result for production stage:
171
+ * // - web (main frontend): myapp.com
172
+ * // - api: api.myapp.com
173
+ * // - auth: auth.myapp.com
174
+ * ```
175
+ */
176
+ export type DokployDomainsConfig = Record<string, string>;
177
+
178
+ /**
179
+ * Per-app domain override configuration.
180
+ *
181
+ * Can be a single domain string (used for all stages) or
182
+ * stage-specific domains.
183
+ *
184
+ * @example
185
+ * ```ts
186
+ * // Single domain for all stages
187
+ * domain: 'api.custom.com'
188
+ *
189
+ * // Stage-specific domains
190
+ * domain: {
191
+ * development: 'api.dev.custom.com',
192
+ * staging: 'api.staging.custom.com',
193
+ * production: 'api.custom.com',
194
+ * }
195
+ * ```
196
+ */
197
+ export type AppDomainConfig = string | Record<string, string>;
198
+
199
+ /**
200
+ * Dokploy workspace deployment configuration.
201
+ *
202
+ * Configures how the workspace is deployed to a Dokploy server.
203
+ * One workspace maps to one Dokploy project with stage-based environments.
204
+ * Project IDs are stored in deploy state (not config) and created on first deploy.
205
+ *
206
+ * @example Single endpoint for all stages:
207
+ * ```ts
208
+ * deploy: {
209
+ * default: 'dokploy',
210
+ * dokploy: {
211
+ * endpoint: 'https://dokploy.myserver.com',
212
+ * registry: 'ghcr.io/myorg',
213
+ * },
214
+ * }
215
+ * ```
216
+ *
217
+ * @example Per-stage endpoints (different Dokploy servers):
218
+ * ```ts
219
+ * deploy: {
220
+ * default: 'dokploy',
221
+ * dokploy: {
222
+ * endpoints: {
223
+ * development: 'https://dev-dokploy.myserver.com',
224
+ * production: 'https://dokploy.myserver.com',
225
+ * },
226
+ * registry: 'ghcr.io/myorg',
227
+ * },
228
+ * }
229
+ * ```
230
+ */
231
+ export interface DokployWorkspaceConfig {
232
+ /** Dokploy API endpoint for all stages */
233
+ endpoint?: string;
234
+ /** Per-stage Dokploy API endpoints (overrides endpoint) */
235
+ endpoints?: Record<string, string>;
236
+ /** Container registry for Docker images (e.g., 'ghcr.io/myorg') */
237
+ registry?: string;
238
+ /** Registry ID in Dokploy (auto-configured) */
239
+ registryId?: string;
240
+ /**
241
+ * Stage-based domain configuration.
242
+ * The main frontend app gets the base domain.
243
+ * Other apps get {appName}.{baseDomain} by default.
244
+ */
245
+ domains?: DokployDomainsConfig;
246
+ }
247
+
248
+ /**
249
+ * DNS provider types for automatic DNS record creation.
250
+ */
251
+ export type DnsProviderType = 'hostinger' | 'route53' | 'cloudflare' | 'manual';
252
+
253
+ /**
254
+ * Deployment configuration for the workspace.
255
+ *
256
+ * @example
257
+ * ```ts
258
+ * // Minimal - just set default target
259
+ * deploy: {
260
+ * default: 'dokploy',
261
+ * }
262
+ *
263
+ * // Full configuration with DNS and backups
264
+ * deploy: {
265
+ * default: 'dokploy',
266
+ * dokploy: {
267
+ * endpoint: 'https://dokploy.myserver.com',
268
+ * projectId: 'proj_abc123',
269
+ * registry: 'ghcr.io/myorg',
270
+ * domains: {
271
+ * production: 'myapp.com',
272
+ * },
273
+ * },
274
+ * dns: {
275
+ * provider: 'hostinger',
276
+ * domain: 'myapp.com',
277
+ * },
278
+ * backups: {
279
+ * type: 's3',
280
+ * region: 'us-east-1',
281
+ * },
282
+ * }
283
+ * ```
284
+ */
285
+ export interface DeployConfig {
286
+ /** Default deploy target for all apps (default: 'dokploy') */
287
+ default?: DeployTarget;
288
+ /** Dokploy-specific configuration */
289
+ dokploy?: DokployWorkspaceConfig;
290
+ /** DNS configuration for automatic record creation */
291
+ dns?: DnsConfig;
292
+ /** Backup destination configuration for database services */
293
+ backups?: BackupsConfig;
294
+ }
295
+
296
+ /**
297
+ * Models package configuration for shared schemas.
298
+ *
299
+ * Configures a shared models package containing Zod schemas
300
+ * that can be used across backend and frontend apps.
301
+ *
302
+ * @example
303
+ * ```ts
304
+ * shared: {
305
+ * models: {
306
+ * path: 'packages/models',
307
+ * schema: 'zod',
308
+ * },
309
+ * }
310
+ * ```
311
+ */
312
+ export interface ModelsConfig {
313
+ /** Path to models package relative to workspace root (default: 'packages/models') */
314
+ path?: string;
315
+ /**
316
+ * Schema library to use (default: 'zod').
317
+ * Currently only 'zod' is supported.
318
+ * Future: any StandardSchema-compatible library
319
+ */
320
+ schema?: 'zod';
321
+ }
322
+
323
+ /**
324
+ * Shared packages configuration.
325
+ *
326
+ * Configures shared packages in the monorepo that are
327
+ * used by multiple apps.
328
+ *
329
+ * @example
330
+ * ```ts
331
+ * shared: {
332
+ * packages: ['packages/*', 'libs/*'],
333
+ * models: {
334
+ * path: 'packages/models',
335
+ * schema: 'zod',
336
+ * },
337
+ * }
338
+ * ```
339
+ */
340
+ export interface SharedConfig {
341
+ /** Glob patterns for shared packages (default: ['packages/*']) */
342
+ packages?: string[];
343
+ /** Models package configuration */
344
+ models?: ModelsConfig;
345
+ }
346
+
347
+ /**
348
+ * Secrets encryption configuration.
349
+ *
350
+ * Configures how secrets are encrypted for deployment.
351
+ * Secrets are stored encrypted in `.gkm/secrets/{stage}.json`
352
+ * with keys stored separately in `~/.gkm/{project}/{stage}.key`.
353
+ *
354
+ * @example
355
+ * ```ts
356
+ * secrets: {
357
+ * enabled: true,
358
+ * algorithm: 'aes-256-gcm',
359
+ * kdf: 'scrypt',
360
+ * }
361
+ * ```
362
+ */
363
+ export interface SecretsConfig {
364
+ /** Enable encrypted secrets (default: true) */
365
+ enabled?: boolean;
366
+ /** Encryption algorithm (default: 'aes-256-gcm') */
367
+ algorithm?: string;
368
+ /** Key derivation function (default: 'scrypt') */
369
+ kdf?: 'scrypt' | 'pbkdf2';
370
+ }
371
+
372
+ /**
373
+ * Base app configuration properties (shared between input and normalized).
374
+ *
375
+ * @example
376
+ * ```ts
377
+ * // Backend app with gkm routes
378
+ * api: {
379
+ * type: 'backend',
380
+ * path: 'apps/api',
381
+ * port: 3000,
382
+ * routes: './src/endpoints/**\/*.ts',
383
+ * envParser: './src/config/env',
384
+ * logger: './src/config/logger',
385
+ * }
386
+ *
387
+ * // Backend app with entry point (e.g., Better Auth)
388
+ * auth: {
389
+ * type: 'backend',
390
+ * path: 'apps/auth',
391
+ * port: 3001,
392
+ * entry: './src/index.ts',
393
+ * framework: 'better-auth',
394
+ * requiredEnv: ['DATABASE_URL', 'BETTER_AUTH_SECRET'],
395
+ * }
396
+ *
397
+ * // Frontend app
398
+ * web: {
399
+ * type: 'web',
400
+ * path: 'apps/web',
401
+ * port: 3002,
402
+ * framework: 'nextjs',
403
+ * dependencies: ['api', 'auth'],
404
+ * }
405
+ * ```
406
+ */
407
+ interface AppConfigBase {
408
+ /**
409
+ * App type.
410
+ * - 'backend': Server-side app (API, auth service, etc.)
411
+ * - 'web': Client-side web app (Next.js, Vite, TanStack Start, etc.)
412
+ * - 'mobile': Native mobile app (Expo). Built/deployed via its own
413
+ * toolchain (e.g. EAS Build) — Docker/Dokploy steps are skipped.
414
+ * @default 'backend'
415
+ */
416
+ type?: 'backend' | 'web' | 'mobile';
417
+
418
+ /**
419
+ * Path to the app relative to workspace root.
420
+ * @example 'apps/api', 'apps/web', 'services/auth'
421
+ */
422
+ path: string;
423
+
424
+ /**
425
+ * Development server port.
426
+ * Must be unique across all apps in the workspace.
427
+ * @example 3000, 3001, 3002
428
+ */
429
+ port: number;
430
+
431
+ /**
432
+ * Per-app deploy target override.
433
+ * Overrides `deploy.default` for this specific app.
434
+ * @example 'dokploy', 'vercel'
435
+ */
436
+ deploy?: DeployTarget;
437
+
438
+ // ─────────────────────────────────────────────────────────────────
439
+ // Backend-specific (gkm routes mode)
440
+ // ─────────────────────────────────────────────────────────────────
441
+
442
+ /**
443
+ * Routes glob pattern for gkm endpoints.
444
+ * @example './src/endpoints/**\/*.ts'
445
+ */
446
+ routes?: Routes;
447
+
448
+ /**
449
+ * Functions glob pattern for Lambda functions.
450
+ * @example './src/functions/**\/*.ts'
451
+ */
452
+ functions?: Routes;
453
+
454
+ /**
455
+ * Crons glob pattern for scheduled tasks.
456
+ * @example './src/crons/**\/*.ts'
457
+ */
458
+ crons?: Routes;
459
+
460
+ /**
461
+ * Subscribers glob pattern for event handlers.
462
+ * @example './src/subscribers/**\/*.ts'
463
+ */
464
+ subscribers?: Routes;
465
+
466
+ /**
467
+ * Path to environment parser module.
468
+ * @example './src/config/env'
469
+ */
470
+ envParser?: string;
471
+
472
+ /**
473
+ * Path to logger module.
474
+ * @example './src/config/logger'
475
+ */
476
+ logger?: string;
477
+
478
+ /** Provider configuration (AWS, Docker, etc.) */
479
+ providers?: ProvidersConfig;
480
+
481
+ /**
482
+ * Server lifecycle hooks.
483
+ * @example { beforeSetup: './src/hooks/setup.ts' }
484
+ */
485
+ hooks?: HooksConfig;
486
+
487
+ /**
488
+ * Telescope debugging dashboard configuration.
489
+ * @example true, './src/config/telescope', { enabled: true, path: '/__telescope' }
490
+ */
491
+ telescope?: string | boolean | TelescopeConfig;
492
+
493
+ /**
494
+ * Studio admin panel configuration.
495
+ * @example true, './src/config/studio'
496
+ */
497
+ studio?: string | boolean | StudioConfig;
498
+
499
+ /**
500
+ * OpenAPI documentation configuration.
501
+ * @example true, { output: './src/openapi.ts' }
502
+ */
503
+ openapi?: boolean | OpenApiConfig;
504
+
505
+ /**
506
+ * Runtime environment.
507
+ * @default 'node'
508
+ */
509
+ runtime?: Runtime;
510
+
511
+ /**
512
+ * Environment file(s) to load during development.
513
+ * @example '.env', ['.env', '.env.local']
514
+ */
515
+ env?: string | string[];
516
+
517
+ // ─────────────────────────────────────────────────────────────────
518
+ // Entry point mode (non-gkm apps)
519
+ // ─────────────────────────────────────────────────────────────────
520
+
521
+ /**
522
+ * Entry file path for apps that don't use gkm routes.
523
+ *
524
+ * When specified, the app is run directly with tsx in development
525
+ * and bundled with esbuild for production Docker builds.
526
+ *
527
+ * Use this for:
528
+ * - Better Auth servers
529
+ * - Custom Hono/Express apps
530
+ * - Any backend that doesn't use gkm's endpoint builder
531
+ *
532
+ * @example './src/index.ts', './src/server.ts'
533
+ */
534
+ entry?: string;
535
+
536
+ // ─────────────────────────────────────────────────────────────────
537
+ // Frontend-specific
538
+ // ─────────────────────────────────────────────────────────────────
539
+
540
+ /**
541
+ * Framework for the app.
542
+ *
543
+ * Backend frameworks: 'hono', 'better-auth', 'express', 'fastify'
544
+ * Frontend frameworks: 'nextjs', 'remix', 'vite', 'tanstack-start'
545
+ * Mobile frameworks: 'expo'
546
+ *
547
+ * @example 'nextjs', 'better-auth', 'hono', 'expo'
548
+ */
549
+ framework?: Framework;
550
+
551
+ /**
552
+ * Config file paths for frontend environment sniffing.
553
+ *
554
+ * Points to file(s) that call EnvironmentParser.parse() at import time.
555
+ * The sniffer imports these files and captures all env vars accessed.
556
+ *
557
+ * Dependencies are auto-generated as public-prefixed URL vars based on
558
+ * the app's framework (e.g. `NEXT_PUBLIC_{DEP}_URL` for Next.js,
559
+ * `VITE_{DEP}_URL` for Vite/TanStack Start, `EXPO_PUBLIC_{DEP}_URL`
560
+ * for Expo).
561
+ *
562
+ * @example
563
+ * ```ts
564
+ * config: {
565
+ * client: './src/config/client.ts', // public-prefixed vars for browser
566
+ * server: './src/config/server.ts', // server-only vars for SSR
567
+ * }
568
+ * ```
569
+ */
570
+ config?: {
571
+ /** Client-side config (public-prefixed vars, available in browser/device) */
572
+ client?: string;
573
+ /** Server-side config (all env vars, for SSR/API routes) */
574
+ server?: string;
575
+ };
576
+
577
+ // ─────────────────────────────────────────────────────────────────
578
+ // Deployment
579
+ // ─────────────────────────────────────────────────────────────────
580
+
581
+ /**
582
+ * Override domain for this app.
583
+ *
584
+ * By default, apps get `{appName}.{baseDomain}` (or just `{baseDomain}`
585
+ * for the main frontend). Use this to specify a custom domain.
586
+ *
587
+ * @example
588
+ * ```ts
589
+ * // Single domain for all stages
590
+ * domain: 'api.custom.com'
591
+ *
592
+ * // Stage-specific domains
593
+ * domain: {
594
+ * production: 'api.custom.com',
595
+ * staging: 'api.staging.custom.com',
596
+ * }
597
+ * ```
598
+ */
599
+ domain?: AppDomainConfig;
600
+
601
+ /**
602
+ * Required environment variables for entry-based apps.
603
+ *
604
+ * Use this instead of envParser for apps that don't use gkm routes.
605
+ * The deploy command uses this list to filter which secrets to embed
606
+ * in the Docker image.
607
+ *
608
+ * @example ['DATABASE_URL', 'BETTER_AUTH_SECRET', 'REDIS_URL']
609
+ */
610
+ requiredEnv?: string[];
611
+ }
612
+
613
+ /**
614
+ * App configuration input with type-safe dependencies.
615
+ *
616
+ * @template TAppNames - Union of valid app names in the workspace (auto-inferred)
617
+ *
618
+ * @example
619
+ * ```ts
620
+ * // Dependencies are type-checked against app names
621
+ * apps: {
622
+ * api: { path: 'apps/api', port: 3000 },
623
+ * auth: { path: 'apps/auth', port: 3001 },
624
+ * web: {
625
+ * path: 'apps/web',
626
+ * port: 3002,
627
+ * type: 'web',
628
+ * dependencies: ['api', 'auth'], // ✓ Valid
629
+ * // dependencies: ['invalid'], // ✗ Type error
630
+ * },
631
+ * }
632
+ * ```
633
+ */
634
+ export interface AppConfigInput<TAppNames extends string = string>
635
+ extends AppConfigBase {
636
+ /** Dependencies on other apps in the workspace (type-safe) */
637
+ dependencies?: TAppNames[];
638
+ }
639
+
640
+ /**
641
+ * App configuration (legacy, for backwards compatibility).
642
+ * @deprecated Use AppConfigInput for new code
643
+ */
644
+ export interface AppConfig extends AppConfigBase {
645
+ /** Dependencies on other apps in the workspace */
646
+ dependencies?: string[];
647
+ }
648
+
649
+ /**
650
+ * Base app input type for type inference.
651
+ */
652
+ export type AppInput = AppConfigBase & {
653
+ dependencies?: readonly string[];
654
+ };
655
+
656
+ /**
657
+ * Apps record type for workspace configuration.
658
+ */
659
+ export type AppsRecord = Record<string, AppInput>;
660
+
661
+ /**
662
+ * Constrain apps so dependencies only reference valid app names.
663
+ * Dependencies must be an array of valid app names from the workspace.
664
+ */
665
+ export type ConstrainedApps<TApps extends AppsRecord> = {
666
+ [K in keyof TApps]: Omit<TApps[K], 'dependencies'> & {
667
+ dependencies?: readonly (keyof TApps & string)[];
668
+ };
669
+ };
670
+
671
+ /**
672
+ * Full workspace input type with constrained dependencies.
673
+ *
674
+ * @example
675
+ * ```ts
676
+ * import { defineWorkspace } from '@geekmidas/cli';
677
+ *
678
+ * export default defineWorkspace({
679
+ * name: 'my-app',
680
+ * apps: {
681
+ * api: {
682
+ * path: 'apps/api',
683
+ * port: 3000,
684
+ * routes: './src/endpoints/**\/*.ts',
685
+ * },
686
+ * web: {
687
+ * type: 'web',
688
+ * path: 'apps/web',
689
+ * port: 3001,
690
+ * framework: 'nextjs',
691
+ * dependencies: ['api'],
692
+ * },
693
+ * },
694
+ * services: {
695
+ * db: true,
696
+ * cache: true,
697
+ * },
698
+ * deploy: {
699
+ * default: 'dokploy',
700
+ * },
701
+ * });
702
+ * ```
703
+ */
704
+ export type WorkspaceInput<TApps extends AppsRecord> = {
705
+ /** Workspace name (defaults to root package.json name) */
706
+ name?: string;
707
+ /** App definitions */
708
+ apps: ConstrainedApps<TApps>;
709
+ /** Shared packages configuration */
710
+ shared?: SharedConfig;
711
+ /** Deployment configuration */
712
+ deploy?: DeployConfig;
713
+ /** Development services (db, cache, mail, storage, events) */
714
+ services?: ServicesConfig;
715
+ /** Encrypted secrets configuration */
716
+ secrets?: SecretsConfig;
717
+ /** State provider configuration (local filesystem by default, or SSM for team collaboration) */
718
+ state?: StateConfig;
719
+ };
720
+
721
+ /**
722
+ * Extract app names from apps record.
723
+ */
724
+ export type InferAppNames<TApps extends AppsRecord> = keyof TApps & string;
725
+
726
+ /**
727
+ * Inferred workspace config with proper app name types.
728
+ */
729
+ export type InferredWorkspaceConfig<TApps extends AppsRecord> = {
730
+ name?: string;
731
+ apps: {
732
+ [K in keyof TApps]: Omit<TApps[K], 'dependencies'> & {
733
+ dependencies?: InferAppNames<TApps>[];
734
+ };
735
+ };
736
+ shared?: SharedConfig;
737
+ deploy?: DeployConfig;
738
+ services?: ServicesConfig;
739
+ secrets?: SecretsConfig;
740
+ state?: StateConfig;
741
+ };
742
+
743
+ // Legacy types for backwards compatibility
744
+ /** @deprecated Use WorkspaceInput */
745
+ export type RawWorkspaceInput = {
746
+ name?: string;
747
+ apps: AppsRecord;
748
+ shared?: SharedConfig;
749
+ deploy?: DeployConfig;
750
+ services?: ServicesConfig;
751
+ secrets?: SecretsConfig;
752
+ state?: StateConfig;
753
+ };
754
+
755
+ /** @deprecated Use WorkspaceInput */
756
+ export type WorkspaceConfigInput<
757
+ T extends RawWorkspaceInput = RawWorkspaceInput,
758
+ > = WorkspaceInput<T['apps']>;
759
+
760
+ /**
761
+ * Workspace configuration for multi-app monorepos.
762
+ *
763
+ * Use `defineWorkspace()` helper for type-safe configuration with
764
+ * auto-completion and dependency validation.
765
+ *
766
+ * @example
767
+ * ```ts
768
+ * // gkm.config.ts
769
+ * import { defineWorkspace } from '@geekmidas/cli';
770
+ *
771
+ * export default defineWorkspace({
772
+ * name: 'my-saas',
773
+ *
774
+ * // App definitions
775
+ * apps: {
776
+ * // Backend API with gkm routes
777
+ * api: {
778
+ * path: 'apps/api',
779
+ * port: 3000,
780
+ * routes: './src/endpoints/**\/*.ts',
781
+ * envParser: './src/config/env',
782
+ * logger: './src/config/logger',
783
+ * telescope: true,
784
+ * },
785
+ *
786
+ * // Better Auth service
787
+ * auth: {
788
+ * path: 'apps/auth',
789
+ * port: 3001,
790
+ * entry: './src/index.ts',
791
+ * framework: 'better-auth',
792
+ * requiredEnv: ['DATABASE_URL', 'BETTER_AUTH_SECRET'],
793
+ * },
794
+ *
795
+ * // Next.js frontend
796
+ * web: {
797
+ * type: 'web',
798
+ * path: 'apps/web',
799
+ * port: 3002,
800
+ * framework: 'nextjs',
801
+ * dependencies: ['api', 'auth'],
802
+ * },
803
+ * },
804
+ *
805
+ * // Infrastructure services
806
+ * services: {
807
+ * db: true, // PostgreSQL
808
+ * cache: true, // Redis
809
+ * },
810
+ *
811
+ * // Deployment configuration
812
+ * deploy: {
813
+ * default: 'dokploy',
814
+ * dokploy: {
815
+ * endpoint: 'https://dokploy.myserver.com',
816
+ * projectId: 'proj_abc123',
817
+ * registry: 'ghcr.io/myorg',
818
+ * domains: {
819
+ * production: 'myapp.com',
820
+ * staging: 'staging.myapp.com',
821
+ * },
822
+ * },
823
+ * },
824
+ *
825
+ * // Shared packages
826
+ * shared: {
827
+ * packages: ['packages/*'],
828
+ * models: { path: 'packages/models' },
829
+ * },
830
+ * });
831
+ * ```
832
+ *
833
+ * @deprecated Use WorkspaceInput with defineWorkspace for type inference
834
+ */
835
+ export interface WorkspaceConfig {
836
+ /** Workspace name (defaults to root package.json name) */
837
+ name?: string;
838
+
839
+ /** App definitions */
840
+ apps: Record<string, AppConfig>;
841
+
842
+ /** Shared packages configuration */
843
+ shared?: SharedConfig;
844
+
845
+ /** Default deployment configuration */
846
+ deploy?: DeployConfig;
847
+
848
+ /** Development services (db, cache, mail, storage, events) */
849
+ services?: ServicesConfig;
850
+
851
+ /** Encrypted secrets configuration */
852
+ secrets?: SecretsConfig;
853
+
854
+ /** State provider configuration (local filesystem by default, or SSM for team collaboration) */
855
+ state?: StateConfig;
856
+ }
857
+
858
+ /**
859
+ * Normalized app configuration with resolved defaults.
860
+ *
861
+ * This is the internal representation after processing user input.
862
+ * All optional fields have been resolved to their defaults.
863
+ */
864
+ export interface NormalizedAppConfig extends Omit<AppConfigBase, 'type'> {
865
+ /** App type (always defined after normalization) */
866
+ type: 'backend' | 'web' | 'mobile';
867
+ /** Path to the app */
868
+ path: string;
869
+ /** Development server port */
870
+ port: number;
871
+ /** Resolved dependencies array (empty array if none) */
872
+ dependencies: string[];
873
+ /** Resolved deploy target (app.deploy > deploy.default > 'dokploy') */
874
+ resolvedDeployTarget: DeployTarget;
875
+ /** Entry file path for non-gkm apps */
876
+ entry?: string;
877
+ /** Framework for the app */
878
+ framework?: Framework;
879
+ /** Override domain for this app */
880
+ domain?: AppDomainConfig;
881
+ /** Required environment variables for entry-based apps */
882
+ requiredEnv?: string[];
883
+ }
884
+
885
+ /**
886
+ * Normalized workspace configuration with resolved defaults.
887
+ *
888
+ * This is the internal representation after processing user input.
889
+ * All optional fields have been resolved to their defaults.
890
+ */
891
+ export interface NormalizedWorkspace {
892
+ /** Workspace name (resolved from package.json if not specified) */
893
+ name: string;
894
+ /** Absolute path to workspace root */
895
+ root: string;
896
+ /** Normalized app configurations */
897
+ apps: Record<string, NormalizedAppConfig>;
898
+ /** Services configuration (empty object if not specified) */
899
+ services: ServicesConfig;
900
+ /** Deploy configuration (empty object if not specified) */
901
+ deploy: DeployConfig;
902
+ /** Shared packages configuration (empty object if not specified) */
903
+ shared: SharedConfig;
904
+ /** Secrets configuration (empty object if not specified) */
905
+ secrets: SecretsConfig;
906
+ /** State provider configuration (undefined = local filesystem) */
907
+ state?: StateConfig;
908
+ }
909
+
910
+ /**
911
+ * Result of loading and processing a configuration.
912
+ */
913
+ export interface LoadedConfig {
914
+ /** Whether this is a single-app or workspace config */
915
+ type: 'single' | 'workspace';
916
+ /** The raw configuration as loaded */
917
+ raw: GkmConfig | WorkspaceConfig;
918
+ /** Normalized workspace (always available) */
919
+ workspace: NormalizedWorkspace;
920
+ }
921
+
922
+ /**
923
+ * Type guard to check if a config is a WorkspaceConfig.
924
+ *
925
+ * @example
926
+ * ```ts
927
+ * const config = await loadConfig();
928
+ * if (isWorkspaceConfig(config)) {
929
+ * // config.apps is available
930
+ * console.log(Object.keys(config.apps));
931
+ * }
932
+ * ```
933
+ */
934
+ export function isWorkspaceConfig(
935
+ config: GkmConfig | WorkspaceConfig,
936
+ ): config is WorkspaceConfig {
937
+ return (
938
+ typeof config === 'object' &&
939
+ config !== null &&
940
+ 'apps' in config &&
941
+ typeof config.apps === 'object'
942
+ );
943
+ }