@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,1101 @@
1
+ /**
2
+ * Centralized Dokploy API client
3
+ *
4
+ * Handles authentication, error handling, and provides typed methods for all Dokploy API endpoints.
5
+ */
6
+
7
+ export interface DokployApiOptions {
8
+ /** Dokploy server URL (e.g., https://dokploy.example.com) */
9
+ baseUrl: string;
10
+ /** API token for authentication */
11
+ token: string;
12
+ }
13
+
14
+ export interface DokployErrorResponse {
15
+ message?: string;
16
+ issues?: Array<{ message: string }>;
17
+ }
18
+
19
+ export class DokployApiError extends Error {
20
+ constructor(
21
+ message: string,
22
+ public status: number,
23
+ public statusText: string,
24
+ public issues?: Array<{ message: string }>,
25
+ ) {
26
+ super(message);
27
+ this.name = 'DokployApiError';
28
+ }
29
+ }
30
+
31
+ /**
32
+ * Dokploy API client
33
+ */
34
+ export class DokployApi {
35
+ private baseUrl: string;
36
+ private token: string;
37
+
38
+ constructor(options: DokployApiOptions) {
39
+ this.baseUrl = options.baseUrl.replace(/\/$/, ''); // Remove trailing slash
40
+ this.token = options.token;
41
+ }
42
+
43
+ /**
44
+ * Make a GET request to the Dokploy API
45
+ */
46
+ async get<T>(endpoint: string): Promise<T> {
47
+ return this.request<T>('GET', endpoint);
48
+ }
49
+
50
+ /**
51
+ * Make a POST request to the Dokploy API
52
+ */
53
+ async post<T>(endpoint: string, body?: Record<string, unknown>): Promise<T> {
54
+ return this.request<T>('POST', endpoint, body);
55
+ }
56
+
57
+ /**
58
+ * Make a request to the Dokploy API
59
+ */
60
+ private async request<T>(
61
+ method: 'GET' | 'POST' | 'PUT' | 'DELETE',
62
+ endpoint: string,
63
+ body?: Record<string, unknown>,
64
+ ): Promise<T> {
65
+ const url = `${this.baseUrl}/api/${endpoint}`;
66
+
67
+ const response = await fetch(url, {
68
+ method,
69
+ headers: {
70
+ 'Content-Type': 'application/json',
71
+ 'x-api-key': this.token,
72
+ },
73
+ body: body ? JSON.stringify(body) : undefined,
74
+ });
75
+
76
+ if (!response.ok) {
77
+ let errorMessage = `Dokploy API error: ${response.status} ${response.statusText}`;
78
+ let issues: Array<{ message: string }> | undefined;
79
+
80
+ try {
81
+ const errorBody = (await response.json()) as DokployErrorResponse;
82
+ if (errorBody.message) {
83
+ errorMessage = `Dokploy API error: ${errorBody.message}`;
84
+ }
85
+ if (errorBody.issues?.length) {
86
+ issues = errorBody.issues;
87
+ errorMessage += `\n Issues: ${errorBody.issues.map((i) => i.message).join(', ')}`;
88
+ }
89
+ } catch {
90
+ // Ignore JSON parse errors
91
+ }
92
+
93
+ throw new DokployApiError(
94
+ errorMessage,
95
+ response.status,
96
+ response.statusText,
97
+ issues,
98
+ );
99
+ }
100
+
101
+ // Handle empty responses (204 No Content or empty body)
102
+ const text = await response.text();
103
+ if (!text || text.trim() === '') {
104
+ return undefined as T;
105
+ }
106
+ return JSON.parse(text) as T;
107
+ }
108
+
109
+ /**
110
+ * Validate the API token by making a test request
111
+ */
112
+ async validateToken(): Promise<boolean> {
113
+ try {
114
+ await this.get('project.all');
115
+ return true;
116
+ } catch {
117
+ return false;
118
+ }
119
+ }
120
+
121
+ // ============================================
122
+ // Project endpoints
123
+ // ============================================
124
+
125
+ /**
126
+ * List all projects
127
+ */
128
+ async listProjects(): Promise<DokployProject[]> {
129
+ return this.get<DokployProject[]>('project.all');
130
+ }
131
+
132
+ /**
133
+ * Get a single project by ID
134
+ */
135
+ async getProject(projectId: string): Promise<DokployProjectDetails> {
136
+ return this.get<DokployProjectDetails>(
137
+ `project.one?projectId=${projectId}`,
138
+ );
139
+ }
140
+
141
+ /**
142
+ * Create a new project
143
+ */
144
+ async createProject(
145
+ name: string,
146
+ description?: string,
147
+ ): Promise<{ project: DokployProject; environment: DokployEnvironment }> {
148
+ return this.post<{
149
+ project: DokployProject;
150
+ environment: DokployEnvironment;
151
+ }>('project.create', {
152
+ name,
153
+ description: description ?? `Created by gkm CLI`,
154
+ });
155
+ }
156
+
157
+ /**
158
+ * Delete a project and all its resources
159
+ */
160
+ async deleteProject(projectId: string): Promise<void> {
161
+ await this.post('project.remove', { projectId });
162
+ }
163
+
164
+ // ============================================
165
+ // Environment endpoints
166
+ // ============================================
167
+
168
+ /**
169
+ * Create an environment in a project
170
+ */
171
+ async createEnvironment(
172
+ projectId: string,
173
+ name: string,
174
+ description?: string,
175
+ ): Promise<DokployEnvironment> {
176
+ return this.post<DokployEnvironment>('environment.create', {
177
+ projectId,
178
+ name,
179
+ description: description ?? `${name} environment`,
180
+ });
181
+ }
182
+
183
+ // ============================================
184
+ // Application endpoints
185
+ // ============================================
186
+
187
+ /**
188
+ * List all applications in a project
189
+ */
190
+ async listApplications(projectId: string): Promise<DokployApplication[]> {
191
+ try {
192
+ return await this.get<DokployApplication[]>(
193
+ `application.all?projectId=${projectId}`,
194
+ );
195
+ } catch {
196
+ // Fallback: endpoint might not exist in older Dokploy versions
197
+ return [];
198
+ }
199
+ }
200
+
201
+ /**
202
+ * Find an application by name in a project
203
+ */
204
+ async findApplicationByName(
205
+ projectId: string,
206
+ name: string,
207
+ ): Promise<DokployApplication | undefined> {
208
+ const applications = await this.listApplications(projectId);
209
+ const normalizedName = name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
210
+ return applications.find(
211
+ (app) => app.name === name || app.appName === normalizedName,
212
+ );
213
+ }
214
+
215
+ /**
216
+ * Create a new application
217
+ */
218
+ async createApplication(
219
+ name: string,
220
+ projectId: string,
221
+ environmentId: string,
222
+ ): Promise<DokployApplication> {
223
+ return this.post<DokployApplication>('application.create', {
224
+ name,
225
+ projectId,
226
+ environmentId,
227
+ appName: name.toLowerCase().replace(/[^a-z0-9-]/g, '-'),
228
+ });
229
+ }
230
+
231
+ /**
232
+ * Find or create an application by name
233
+ */
234
+ async findOrCreateApplication(
235
+ name: string,
236
+ projectId: string,
237
+ environmentId: string,
238
+ ): Promise<{ application: DokployApplication; created: boolean }> {
239
+ const existing = await this.findApplicationByName(projectId, name);
240
+ if (existing) {
241
+ return { application: existing, created: false };
242
+ }
243
+ const application = await this.createApplication(
244
+ name,
245
+ projectId,
246
+ environmentId,
247
+ );
248
+ return { application, created: true };
249
+ }
250
+
251
+ /**
252
+ * Get an application by ID
253
+ */
254
+ async getApplication(
255
+ applicationId: string,
256
+ ): Promise<DokployApplication | null> {
257
+ try {
258
+ return await this.get<DokployApplication>(
259
+ `application.one?applicationId=${applicationId}`,
260
+ );
261
+ } catch {
262
+ // Application not found
263
+ return null;
264
+ }
265
+ }
266
+
267
+ /**
268
+ * Update an application
269
+ */
270
+ async updateApplication(
271
+ applicationId: string,
272
+ updates: Partial<DokployApplicationUpdate>,
273
+ ): Promise<void> {
274
+ await this.post('application.update', {
275
+ applicationId,
276
+ ...updates,
277
+ });
278
+ }
279
+
280
+ /**
281
+ * Save environment variables for an application
282
+ */
283
+ async saveApplicationEnv(applicationId: string, env: string): Promise<void> {
284
+ await this.post('application.saveEnvironment', {
285
+ applicationId,
286
+ env,
287
+ });
288
+ }
289
+
290
+ /**
291
+ * Configure application to use Docker provider (pull from registry)
292
+ *
293
+ * For private registries, either:
294
+ * - Use `registryId` if the registry is configured in Dokploy
295
+ * - Or provide `username`, `password`, and `registryUrl` directly
296
+ */
297
+ async saveDockerProvider(
298
+ applicationId: string,
299
+ dockerImage: string,
300
+ options?: {
301
+ /** Registry ID in Dokploy (for pre-configured registries) */
302
+ registryId?: string;
303
+ /** Registry username (for direct auth) */
304
+ username?: string;
305
+ /** Registry password (for direct auth) */
306
+ password?: string;
307
+ /** Registry URL (for direct auth, e.g., ghcr.io) */
308
+ registryUrl?: string;
309
+ },
310
+ ): Promise<void> {
311
+ await this.post('application.saveDockerProvider', {
312
+ applicationId,
313
+ dockerImage,
314
+ ...options,
315
+ });
316
+ }
317
+
318
+ /**
319
+ * Deploy an application
320
+ */
321
+ async deployApplication(applicationId: string): Promise<void> {
322
+ await this.post('application.deploy', { applicationId });
323
+ }
324
+
325
+ /**
326
+ * Delete an application
327
+ */
328
+ async deleteApplication(applicationId: string): Promise<void> {
329
+ await this.post('application.remove', { applicationId });
330
+ }
331
+
332
+ // ============================================
333
+ // Registry endpoints
334
+ // ============================================
335
+
336
+ /**
337
+ * List all registries
338
+ */
339
+ async listRegistries(): Promise<DokployRegistry[]> {
340
+ return this.get<DokployRegistry[]>('registry.all');
341
+ }
342
+
343
+ /**
344
+ * Create a new registry
345
+ */
346
+ async createRegistry(
347
+ registryName: string,
348
+ registryUrl: string,
349
+ username: string,
350
+ password: string,
351
+ options?: {
352
+ imagePrefix?: string;
353
+ },
354
+ ): Promise<DokployRegistry> {
355
+ return this.post<DokployRegistry>('registry.create', {
356
+ registryName,
357
+ registryUrl,
358
+ username,
359
+ password,
360
+ imagePrefix: options?.imagePrefix,
361
+ });
362
+ }
363
+
364
+ /**
365
+ * Get a registry by ID
366
+ */
367
+ async getRegistry(registryId: string): Promise<DokployRegistry> {
368
+ return this.get<DokployRegistry>(`registry.one?registryId=${registryId}`);
369
+ }
370
+
371
+ /**
372
+ * Update a registry
373
+ */
374
+ async updateRegistry(
375
+ registryId: string,
376
+ updates: Partial<{
377
+ registryName: string;
378
+ registryUrl: string;
379
+ username: string;
380
+ password: string;
381
+ imagePrefix: string;
382
+ }>,
383
+ ): Promise<void> {
384
+ await this.post('registry.update', { registryId, ...updates });
385
+ }
386
+
387
+ /**
388
+ * Delete a registry
389
+ */
390
+ async deleteRegistry(registryId: string): Promise<void> {
391
+ await this.post('registry.remove', { registryId });
392
+ }
393
+
394
+ // ============================================
395
+ // Postgres endpoints
396
+ // ============================================
397
+
398
+ /**
399
+ * List all Postgres databases in a project
400
+ */
401
+ async listPostgres(projectId: string): Promise<DokployPostgres[]> {
402
+ try {
403
+ return await this.get<DokployPostgres[]>(
404
+ `postgres.all?projectId=${projectId}`,
405
+ );
406
+ } catch {
407
+ // Fallback: endpoint might not exist in older Dokploy versions
408
+ return [];
409
+ }
410
+ }
411
+
412
+ /**
413
+ * Find a Postgres database by name in a project
414
+ */
415
+ async findPostgresByName(
416
+ projectId: string,
417
+ name: string,
418
+ ): Promise<DokployPostgres | undefined> {
419
+ const databases = await this.listPostgres(projectId);
420
+ const normalizedName = name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
421
+ return databases.find(
422
+ (db) => db.name === name || db.appName === normalizedName,
423
+ );
424
+ }
425
+
426
+ /**
427
+ * Create a new Postgres database
428
+ */
429
+ async createPostgres(
430
+ name: string,
431
+ projectId: string,
432
+ environmentId: string,
433
+ options?: {
434
+ appName?: string;
435
+ databaseName?: string;
436
+ databaseUser?: string;
437
+ databasePassword?: string;
438
+ dockerImage?: string;
439
+ description?: string;
440
+ },
441
+ ): Promise<DokployPostgres> {
442
+ return this.post<DokployPostgres>('postgres.create', {
443
+ name,
444
+ projectId,
445
+ environmentId,
446
+ appName:
447
+ options?.appName ?? name.toLowerCase().replace(/[^a-z0-9-]/g, '-'),
448
+ databaseName: options?.databaseName,
449
+ databaseUser: options?.databaseUser ?? 'postgres',
450
+ databasePassword: options?.databasePassword,
451
+ dockerImage: options?.dockerImage ?? 'postgres:18',
452
+ description: options?.description ?? `Postgres database for ${name}`,
453
+ });
454
+ }
455
+
456
+ /**
457
+ * Find or create a Postgres database by name
458
+ */
459
+ async findOrCreatePostgres(
460
+ name: string,
461
+ projectId: string,
462
+ environmentId: string,
463
+ options?: {
464
+ databaseName?: string;
465
+ databasePassword?: string;
466
+ },
467
+ ): Promise<{ postgres: DokployPostgres; created: boolean }> {
468
+ const existing = await this.findPostgresByName(projectId, name);
469
+ if (existing) {
470
+ return { postgres: existing, created: false };
471
+ }
472
+ const postgres = await this.createPostgres(
473
+ name,
474
+ projectId,
475
+ environmentId,
476
+ options,
477
+ );
478
+ return { postgres, created: true };
479
+ }
480
+
481
+ /**
482
+ * Get a Postgres database by ID
483
+ */
484
+ async getPostgres(postgresId: string): Promise<DokployPostgres> {
485
+ return this.get<DokployPostgres>(`postgres.one?postgresId=${postgresId}`);
486
+ }
487
+
488
+ /**
489
+ * Deploy a Postgres database
490
+ */
491
+ async deployPostgres(postgresId: string): Promise<void> {
492
+ await this.post('postgres.deploy', { postgresId });
493
+ }
494
+
495
+ /**
496
+ * Save environment variables for Postgres
497
+ */
498
+ async savePostgresEnv(postgresId: string, env: string): Promise<void> {
499
+ await this.post('postgres.saveEnvironment', { postgresId, env });
500
+ }
501
+
502
+ /**
503
+ * Set external port for Postgres (for external access)
504
+ */
505
+ async savePostgresExternalPort(
506
+ postgresId: string,
507
+ externalPort: number | null,
508
+ ): Promise<void> {
509
+ await this.post('postgres.saveExternalPort', { postgresId, externalPort });
510
+ }
511
+
512
+ /**
513
+ * Update Postgres configuration
514
+ */
515
+ async updatePostgres(
516
+ postgresId: string,
517
+ updates: Partial<DokployPostgresUpdate>,
518
+ ): Promise<void> {
519
+ await this.post('postgres.update', { postgresId, ...updates });
520
+ }
521
+
522
+ /**
523
+ * Delete a Postgres database
524
+ */
525
+ async deletePostgres(postgresId: string): Promise<void> {
526
+ await this.post('postgres.remove', { postgresId });
527
+ }
528
+
529
+ // ============================================
530
+ // Redis endpoints
531
+ // ============================================
532
+
533
+ /**
534
+ * List all Redis instances in a project
535
+ */
536
+ async listRedis(projectId: string): Promise<DokployRedis[]> {
537
+ try {
538
+ return await this.get<DokployRedis[]>(`redis.all?projectId=${projectId}`);
539
+ } catch {
540
+ // Fallback: endpoint might not exist in older Dokploy versions
541
+ return [];
542
+ }
543
+ }
544
+
545
+ /**
546
+ * Find a Redis instance by name in a project
547
+ */
548
+ async findRedisByName(
549
+ projectId: string,
550
+ name: string,
551
+ ): Promise<DokployRedis | undefined> {
552
+ const instances = await this.listRedis(projectId);
553
+ const normalizedName = name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
554
+ return instances.find(
555
+ (redis) => redis.name === name || redis.appName === normalizedName,
556
+ );
557
+ }
558
+
559
+ /**
560
+ * Create a new Redis instance
561
+ */
562
+ async createRedis(
563
+ name: string,
564
+ projectId: string,
565
+ environmentId: string,
566
+ options?: {
567
+ appName?: string;
568
+ databasePassword?: string;
569
+ dockerImage?: string;
570
+ description?: string;
571
+ },
572
+ ): Promise<DokployRedis> {
573
+ return this.post<DokployRedis>('redis.create', {
574
+ name,
575
+ projectId,
576
+ environmentId,
577
+ appName:
578
+ options?.appName ?? name.toLowerCase().replace(/[^a-z0-9-]/g, '-'),
579
+ databasePassword: options?.databasePassword,
580
+ dockerImage: options?.dockerImage ?? 'redis:8',
581
+ description: options?.description ?? `Redis instance for ${name}`,
582
+ });
583
+ }
584
+
585
+ /**
586
+ * Find or create a Redis instance by name
587
+ */
588
+ async findOrCreateRedis(
589
+ name: string,
590
+ projectId: string,
591
+ environmentId: string,
592
+ options?: {
593
+ databasePassword?: string;
594
+ },
595
+ ): Promise<{ redis: DokployRedis; created: boolean }> {
596
+ const existing = await this.findRedisByName(projectId, name);
597
+ if (existing) {
598
+ return { redis: existing, created: false };
599
+ }
600
+ const redis = await this.createRedis(
601
+ name,
602
+ projectId,
603
+ environmentId,
604
+ options,
605
+ );
606
+ return { redis, created: true };
607
+ }
608
+
609
+ /**
610
+ * Get a Redis instance by ID
611
+ */
612
+ async getRedis(redisId: string): Promise<DokployRedis> {
613
+ return this.get<DokployRedis>(`redis.one?redisId=${redisId}`);
614
+ }
615
+
616
+ /**
617
+ * Deploy a Redis instance
618
+ */
619
+ async deployRedis(redisId: string): Promise<void> {
620
+ await this.post('redis.deploy', { redisId });
621
+ }
622
+
623
+ /**
624
+ * Save environment variables for Redis
625
+ */
626
+ async saveRedisEnv(redisId: string, env: string): Promise<void> {
627
+ await this.post('redis.saveEnvironment', { redisId, env });
628
+ }
629
+
630
+ /**
631
+ * Set external port for Redis (for external access)
632
+ */
633
+ async saveRedisExternalPort(
634
+ redisId: string,
635
+ externalPort: number | null,
636
+ ): Promise<void> {
637
+ await this.post('redis.saveExternalPort', { redisId, externalPort });
638
+ }
639
+
640
+ /**
641
+ * Update Redis configuration
642
+ */
643
+ async updateRedis(
644
+ redisId: string,
645
+ updates: Partial<DokployRedisUpdate>,
646
+ ): Promise<void> {
647
+ await this.post('redis.update', { redisId, ...updates });
648
+ }
649
+
650
+ /**
651
+ * Delete a Redis instance
652
+ */
653
+ async deleteRedis(redisId: string): Promise<void> {
654
+ await this.post('redis.remove', { redisId });
655
+ }
656
+
657
+ // ============================================
658
+ // Domain endpoints
659
+ // ============================================
660
+
661
+ /**
662
+ * Create a new domain for an application
663
+ */
664
+ async createDomain(options: DokployDomainCreate): Promise<DokployDomain> {
665
+ return this.post<DokployDomain>(
666
+ 'domain.create',
667
+ options as unknown as Record<string, unknown>,
668
+ );
669
+ }
670
+
671
+ /**
672
+ * Update an existing domain
673
+ */
674
+ async updateDomain(
675
+ domainId: string,
676
+ updates: Partial<DokployDomainCreate>,
677
+ ): Promise<void> {
678
+ await this.post('domain.update', { domainId, ...updates });
679
+ }
680
+
681
+ /**
682
+ * Delete a domain
683
+ */
684
+ async deleteDomain(domainId: string): Promise<void> {
685
+ await this.post('domain.delete', { domainId });
686
+ }
687
+
688
+ /**
689
+ * Get a domain by ID
690
+ */
691
+ async getDomain(domainId: string): Promise<DokployDomain> {
692
+ return this.get<DokployDomain>(`domain.one?domainId=${domainId}`);
693
+ }
694
+
695
+ /**
696
+ * Get all domains for an application
697
+ */
698
+ async getDomainsByApplicationId(
699
+ applicationId: string,
700
+ ): Promise<DokployDomain[]> {
701
+ return this.get<DokployDomain[]>(
702
+ `domain.byApplicationId?applicationId=${applicationId}`,
703
+ );
704
+ }
705
+
706
+ /**
707
+ * Validate a domain and trigger SSL certificate generation
708
+ *
709
+ * This should be called after DNS records are created and propagated.
710
+ * It triggers Let's Encrypt certificate generation for HTTPS domains.
711
+ *
712
+ * @param domain - The domain hostname to validate (e.g., 'api.example.com')
713
+ */
714
+ async validateDomain(
715
+ domain: string,
716
+ ): Promise<{ isValid: boolean; resolvedIp: string }> {
717
+ return this.post<{ isValid: boolean; resolvedIp: string }>(
718
+ 'domain.validateDomain',
719
+ { domain },
720
+ );
721
+ }
722
+
723
+ /**
724
+ * Auto-generate a domain name for an application
725
+ */
726
+ async generateDomain(
727
+ appName: string,
728
+ serverId?: string,
729
+ ): Promise<{ domain: string }> {
730
+ return this.post<{ domain: string }>('domain.generateDomain', {
731
+ appName,
732
+ serverId,
733
+ });
734
+ }
735
+
736
+ // ============================================
737
+ // Destination endpoints (backup storage)
738
+ // ============================================
739
+
740
+ /**
741
+ * List all backup destinations
742
+ */
743
+ async listDestinations(): Promise<DokployDestination[]> {
744
+ return this.get<DokployDestination[]>('destination.all');
745
+ }
746
+
747
+ /**
748
+ * Get a destination by ID
749
+ */
750
+ async getDestination(destinationId: string): Promise<DokployDestination> {
751
+ return this.get<DokployDestination>(
752
+ `destination.one?destinationId=${destinationId}`,
753
+ );
754
+ }
755
+
756
+ /**
757
+ * Create a new S3 backup destination
758
+ */
759
+ async createDestination(
760
+ options: DokployDestinationCreate,
761
+ ): Promise<DokployDestination> {
762
+ return this.post<DokployDestination>('destination.create', { ...options });
763
+ }
764
+
765
+ /**
766
+ * Find a destination by name
767
+ */
768
+ async findDestinationByName(
769
+ name: string,
770
+ ): Promise<DokployDestination | undefined> {
771
+ const destinations = await this.listDestinations();
772
+ return destinations.find((d) => d.name === name);
773
+ }
774
+
775
+ /**
776
+ * Find or create a destination by name
777
+ */
778
+ async findOrCreateDestination(
779
+ name: string,
780
+ options: Omit<DokployDestinationCreate, 'name'>,
781
+ ): Promise<{ destination: DokployDestination; created: boolean }> {
782
+ const existing = await this.findDestinationByName(name);
783
+ if (existing) {
784
+ return { destination: existing, created: false };
785
+ }
786
+ const destination = await this.createDestination({ name, ...options });
787
+ return { destination, created: true };
788
+ }
789
+
790
+ /**
791
+ * Update a destination
792
+ */
793
+ async updateDestination(
794
+ destinationId: string,
795
+ updates: Partial<DokployDestinationCreate>,
796
+ ): Promise<void> {
797
+ await this.post('destination.update', { destinationId, ...updates });
798
+ }
799
+
800
+ /**
801
+ * Delete a destination
802
+ */
803
+ async deleteDestination(destinationId: string): Promise<void> {
804
+ await this.post('destination.remove', { destinationId });
805
+ }
806
+
807
+ /**
808
+ * Test connection to a destination
809
+ */
810
+ async testDestinationConnection(
811
+ destinationId: string,
812
+ ): Promise<{ success: boolean }> {
813
+ return this.post<{ success: boolean }>('destination.testConnection', {
814
+ destinationId,
815
+ });
816
+ }
817
+
818
+ // ============================================
819
+ // Backup endpoints (scheduled backups)
820
+ // ============================================
821
+
822
+ /**
823
+ * Create a backup schedule for postgres
824
+ */
825
+ async createPostgresBackup(
826
+ options: DokployBackupCreate,
827
+ ): Promise<DokployBackup> {
828
+ return this.post<DokployBackup>('backup.create', {
829
+ ...options,
830
+ databaseType: 'postgres',
831
+ });
832
+ }
833
+
834
+ /**
835
+ * List backups for a postgres database
836
+ */
837
+ async listPostgresBackups(postgresId: string): Promise<DokployBackup[]> {
838
+ return this.get<DokployBackup[]>(
839
+ `backup.all?postgresId=${postgresId}&databaseType=postgres`,
840
+ );
841
+ }
842
+
843
+ /**
844
+ * Get a backup by ID
845
+ */
846
+ async getBackup(backupId: string): Promise<DokployBackup> {
847
+ return this.get<DokployBackup>(`backup.one?backupId=${backupId}`);
848
+ }
849
+
850
+ /**
851
+ * Update a backup schedule
852
+ */
853
+ async updateBackup(
854
+ backupId: string,
855
+ updates: Partial<DokployBackupUpdate>,
856
+ ): Promise<void> {
857
+ await this.post('backup.update', { backupId, ...updates });
858
+ }
859
+
860
+ /**
861
+ * Delete a backup schedule
862
+ */
863
+ async deleteBackup(backupId: string): Promise<void> {
864
+ await this.post('backup.remove', { backupId });
865
+ }
866
+
867
+ /**
868
+ * Trigger a manual backup run
869
+ */
870
+ async runBackupManually(backupId: string): Promise<void> {
871
+ await this.post('backup.manualBackup', { backupId });
872
+ }
873
+ }
874
+
875
+ // ============================================
876
+ // Type definitions for Dokploy API responses
877
+ // ============================================
878
+
879
+ export interface DokployProject {
880
+ projectId: string;
881
+ name: string;
882
+ description: string | null;
883
+ createdAt?: string;
884
+ adminId?: string;
885
+ }
886
+
887
+ export interface DokployEnvironment {
888
+ environmentId: string;
889
+ name: string;
890
+ description: string | null;
891
+ }
892
+
893
+ export interface DokployProjectDetails extends DokployProject {
894
+ environments: DokployEnvironment[];
895
+ }
896
+
897
+ export interface DokployApplication {
898
+ applicationId: string;
899
+ name: string;
900
+ appName: string;
901
+ projectId: string;
902
+ environmentId?: string;
903
+ }
904
+
905
+ export interface DokployApplicationUpdate {
906
+ registryId: string;
907
+ dockerImage: string;
908
+ sourceType: 'docker';
909
+ }
910
+
911
+ export interface DokployRegistry {
912
+ registryId: string;
913
+ registryName: string;
914
+ registryUrl: string;
915
+ username: string;
916
+ imagePrefix: string | null;
917
+ }
918
+
919
+ export interface DokployPostgres {
920
+ postgresId: string;
921
+ name: string;
922
+ appName: string;
923
+ databaseName: string;
924
+ databaseUser: string;
925
+ databasePassword: string;
926
+ dockerImage: string;
927
+ description: string | null;
928
+ projectId: string;
929
+ environmentId: string;
930
+ applicationStatus: 'idle' | 'running' | 'done' | 'error';
931
+ externalPort: number | null;
932
+ createdAt?: string;
933
+ }
934
+
935
+ export interface DokployPostgresUpdate {
936
+ name: string;
937
+ appName: string;
938
+ databaseName: string;
939
+ databaseUser: string;
940
+ databasePassword: string;
941
+ dockerImage: string;
942
+ description: string;
943
+ }
944
+
945
+ export interface DokployRedis {
946
+ redisId: string;
947
+ name: string;
948
+ appName: string;
949
+ databasePassword: string;
950
+ dockerImage: string;
951
+ description: string | null;
952
+ projectId: string;
953
+ environmentId: string;
954
+ applicationStatus: 'idle' | 'running' | 'done' | 'error';
955
+ externalPort: number | null;
956
+ createdAt?: string;
957
+ }
958
+
959
+ export interface DokployRedisUpdate {
960
+ name: string;
961
+ appName: string;
962
+ databasePassword: string;
963
+ dockerImage: string;
964
+ description: string;
965
+ }
966
+
967
+ export type DokployCertificateType = 'letsencrypt' | 'none' | 'custom';
968
+ export type DokployDomainType = 'application' | 'compose' | 'preview';
969
+
970
+ export interface DokployDomainCreate {
971
+ /** Domain hostname (e.g., 'api.example.com') */
972
+ host: string;
973
+ /** URL path (optional, e.g., '/api') */
974
+ path?: string | null;
975
+ /** Container port to route to (1-65535) */
976
+ port?: number | null;
977
+ /** Enable HTTPS */
978
+ https?: boolean;
979
+ /** Associated application ID */
980
+ applicationId?: string | null;
981
+ /** Certificate type for HTTPS */
982
+ certificateType?: DokployCertificateType;
983
+ /** Custom certificate resolver name */
984
+ customCertResolver?: string | null;
985
+ /** Docker Compose service ID */
986
+ composeId?: string | null;
987
+ /** Service name for compose */
988
+ serviceName?: string | null;
989
+ /** Domain type */
990
+ domainType?: DokployDomainType | null;
991
+ /** Preview deployment ID */
992
+ previewDeploymentId?: string | null;
993
+ /** Internal routing path */
994
+ internalPath?: string | null;
995
+ /** Strip path from forwarded requests */
996
+ stripPath?: boolean;
997
+ }
998
+
999
+ export interface DokployDomain extends DokployDomainCreate {
1000
+ domainId: string;
1001
+ createdAt?: string;
1002
+ }
1003
+
1004
+ // ============================================
1005
+ // Destination types (backup storage)
1006
+ // ============================================
1007
+
1008
+ export interface DokployDestination {
1009
+ destinationId: string;
1010
+ name: string;
1011
+ accessKey: string;
1012
+ bucket: string;
1013
+ region: string;
1014
+ endpoint: string | null;
1015
+ createdAt?: string;
1016
+ }
1017
+
1018
+ export interface DokployDestinationCreate {
1019
+ /** User-friendly name for the destination */
1020
+ name: string;
1021
+ /** S3 access key ID */
1022
+ accessKey: string;
1023
+ /** S3 secret access key */
1024
+ secretAccessKey: string;
1025
+ /** S3 bucket name */
1026
+ bucket: string;
1027
+ /** AWS region (e.g., 'us-east-1') */
1028
+ region: string;
1029
+ /** Optional endpoint for S3-compatible services */
1030
+ endpoint?: string;
1031
+ }
1032
+
1033
+ // ============================================
1034
+ // Backup types (scheduled backups)
1035
+ // ============================================
1036
+
1037
+ export type DokployDatabaseType = 'postgres' | 'mysql' | 'mariadb' | 'mongo';
1038
+
1039
+ export interface DokployBackup {
1040
+ backupId: string;
1041
+ schedule: string;
1042
+ prefix: string;
1043
+ enabled: boolean;
1044
+ destinationId: string;
1045
+ postgresId?: string;
1046
+ databaseType: DokployDatabaseType;
1047
+ keepLatestCount: number | null;
1048
+ createdAt?: string;
1049
+ }
1050
+
1051
+ export interface DokployBackupCreate {
1052
+ /** Cron schedule (e.g., '0 2 * * *' for 2 AM daily) */
1053
+ schedule: string;
1054
+ /** Backup file prefix (e.g., 'production/postgres') */
1055
+ prefix: string;
1056
+ /** Destination ID for backup storage */
1057
+ destinationId: string;
1058
+ /** Database name to backup */
1059
+ database: string;
1060
+ /** Postgres instance ID */
1061
+ postgresId: string;
1062
+ /** Enable/disable backup (default: true) */
1063
+ enabled?: boolean;
1064
+ /** Number of backups to keep (default: keep all) */
1065
+ keepLatestCount?: number;
1066
+ }
1067
+
1068
+ export interface DokployBackupUpdate {
1069
+ schedule?: string;
1070
+ prefix?: string;
1071
+ enabled?: boolean;
1072
+ keepLatestCount?: number;
1073
+ }
1074
+
1075
+ /**
1076
+ * Create a Dokploy API client from stored credentials or environment
1077
+ */
1078
+ export async function createDokployApi(
1079
+ endpoint?: string,
1080
+ ): Promise<DokployApi | null> {
1081
+ const { getDokployCredentials } = await import('../auth/credentials');
1082
+
1083
+ // Try environment variable first
1084
+ const envToken = process.env.DOKPLOY_API_TOKEN;
1085
+ const envEndpoint = endpoint || process.env.DOKPLOY_ENDPOINT;
1086
+
1087
+ if (envToken && envEndpoint) {
1088
+ return new DokployApi({ baseUrl: envEndpoint, token: envToken });
1089
+ }
1090
+
1091
+ // Fall back to stored credentials
1092
+ const creds = await getDokployCredentials();
1093
+ if (creds) {
1094
+ return new DokployApi({
1095
+ baseUrl: endpoint || creds.endpoint,
1096
+ token: creds.token,
1097
+ });
1098
+ }
1099
+
1100
+ return null;
1101
+ }