@dreamlake/dreamlake-cli 0.88.1 → 0.89.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 (535) hide show
  1. package/dist/api/access.d.ts +83 -0
  2. package/dist/api/access.js +77 -0
  3. package/dist/api/agent.d.ts +156 -0
  4. package/dist/api/agent.js +111 -0
  5. package/dist/api/browser.d.ts +90 -0
  6. package/dist/api/browser.js +102 -0
  7. package/dist/api/client.d.ts +53 -0
  8. package/dist/api/client.js +102 -0
  9. package/dist/api/common.d.ts +28 -0
  10. package/dist/api/common.js +16 -0
  11. package/dist/api/content.d.ts +195 -0
  12. package/dist/api/content.js +147 -0
  13. package/dist/api/execution.d.ts +84 -0
  14. package/dist/api/execution.js +73 -0
  15. package/dist/api/http.d.ts +19 -0
  16. package/dist/api/http.js +66 -0
  17. package/dist/api/index.d.ts +2330 -0
  18. package/dist/api/index.js +114 -0
  19. package/dist/api/infra.d.ts +2 -0
  20. package/dist/api/infra.js +2 -0
  21. package/dist/api/jobs.d.ts +2 -0
  22. package/dist/api/jobs.js +2 -0
  23. package/dist/api/layout.d.ts +2 -0
  24. package/dist/api/layout.js +2 -0
  25. package/dist/api/library-edit.d.ts +3 -0
  26. package/dist/api/library-edit.js +3 -0
  27. package/dist/api/library-manifest.d.ts +2 -0
  28. package/dist/api/library-manifest.js +2 -0
  29. package/dist/api/note-character-plan.d.ts +2 -0
  30. package/dist/api/note-character-plan.js +2 -0
  31. package/dist/api/note-editing.d.ts +2 -0
  32. package/dist/api/note-editing.js +2 -0
  33. package/dist/api/note-edits.d.ts +21 -0
  34. package/dist/api/note-edits.js +10 -0
  35. package/dist/api/note-events.d.ts +5 -0
  36. package/dist/api/note-events.js +11 -0
  37. package/dist/api/note-files.d.ts +75 -0
  38. package/dist/api/note-files.js +65 -0
  39. package/dist/api/note-html-read.d.ts +2 -0
  40. package/dist/api/note-html-read.js +2 -0
  41. package/dist/api/note-html.d.ts +2 -0
  42. package/dist/api/note-html.js +2 -0
  43. package/dist/api/note-toc.d.ts +2 -0
  44. package/dist/api/note-toc.js +2 -0
  45. package/dist/api/notes.d.ts +304 -0
  46. package/dist/api/notes.js +181 -0
  47. package/dist/api/open-resources.d.ts +27 -0
  48. package/dist/api/open-resources.js +102 -0
  49. package/dist/api/ownership.d.ts +12 -0
  50. package/dist/api/ownership.js +24 -0
  51. package/dist/api/platform.d.ts +83 -0
  52. package/dist/api/platform.js +56 -0
  53. package/dist/api/presigned-transfer.d.ts +2 -0
  54. package/dist/api/presigned-transfer.js +2 -0
  55. package/dist/api/registered-runs.d.ts +48 -0
  56. package/dist/api/registered-runs.js +33 -0
  57. package/dist/api/sessions.d.ts +299 -0
  58. package/dist/api/sessions.js +105 -0
  59. package/dist/api/storage.d.ts +46 -0
  60. package/dist/api/storage.js +34 -0
  61. package/dist/api/streams.d.ts +18 -0
  62. package/dist/api/streams.js +70 -0
  63. package/dist/api/vault.d.ts +93 -0
  64. package/dist/api/vault.js +79 -0
  65. package/dist/api/workspace.d.ts +180 -0
  66. package/dist/api/workspace.js +146 -0
  67. package/dist/cli/agent-identity.d.ts +4 -0
  68. package/dist/cli/agent-identity.js +21 -0
  69. package/dist/cli/agents/identity.d.ts +50 -0
  70. package/dist/cli/agents/identity.js +105 -0
  71. package/dist/cli/agents/index.d.ts +31 -0
  72. package/dist/cli/agents/index.js +580 -0
  73. package/dist/cli/agents/manage.d.ts +43 -0
  74. package/dist/cli/agents/manage.js +376 -0
  75. package/dist/cli/agents/spec.d.ts +104 -0
  76. package/dist/cli/agents/spec.js +280 -0
  77. package/dist/cli/agents/web.d.ts +7 -0
  78. package/dist/cli/agents/web.js +109 -0
  79. package/dist/cli/artifact/incremental.d.ts +21 -0
  80. package/dist/cli/artifact/incremental.js +80 -0
  81. package/dist/cli/artifact/index.d.ts +52 -0
  82. package/dist/cli/artifact/index.js +405 -0
  83. package/dist/cli/artifact/meta.d.ts +69 -0
  84. package/dist/cli/artifact/meta.js +189 -0
  85. package/dist/cli/auth/commands.d.ts +29 -0
  86. package/dist/cli/auth/commands.js +327 -0
  87. package/dist/cli/auth/constants.d.ts +13 -0
  88. package/dist/cli/auth/constants.js +18 -0
  89. package/dist/cli/auth/credentials.d.ts +37 -0
  90. package/dist/cli/auth/credentials.js +155 -0
  91. package/dist/cli/auth/device-flow.d.ts +32 -0
  92. package/dist/cli/auth/device-flow.js +154 -0
  93. package/dist/cli/auth/device-secret.d.ts +6 -0
  94. package/dist/cli/auth/device-secret.js +26 -0
  95. package/dist/cli/auth/machine.d.ts +15 -0
  96. package/dist/cli/auth/machine.js +126 -0
  97. package/dist/cli/auth/materialized.d.ts +32 -0
  98. package/dist/cli/auth/materialized.js +102 -0
  99. package/dist/cli/auth/migrate.d.ts +10 -0
  100. package/dist/cli/auth/migrate.js +75 -0
  101. package/dist/cli/client.d.ts +102 -0
  102. package/dist/cli/client.js +206 -0
  103. package/dist/cli/collection-list.d.ts +3 -0
  104. package/dist/cli/collection-list.js +25 -0
  105. package/dist/cli/compat/ctx.d.ts +26 -0
  106. package/dist/cli/compat/ctx.js +76 -0
  107. package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
  108. package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
  109. package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
  110. package/dist/cli/compat/dreamdb-wasm.js +26 -0
  111. package/dist/cli/compat/dreamdb.d.ts +112 -0
  112. package/dist/cli/compat/dreamdb.js +219 -0
  113. package/dist/cli/compat/flags.d.ts +2 -0
  114. package/dist/cli/compat/flags.js +13 -0
  115. package/dist/cli/compat/http.d.ts +23 -0
  116. package/dist/cli/compat/http.js +137 -0
  117. package/dist/cli/compat/presignedTransfer.d.ts +139 -0
  118. package/dist/cli/compat/presignedTransfer.js +580 -0
  119. package/dist/cli/compat/s3-backend.d.ts +73 -0
  120. package/dist/cli/compat/s3-backend.js +132 -0
  121. package/dist/cli/config.d.ts +22 -0
  122. package/dist/cli/config.js +96 -0
  123. package/dist/cli/connection/dto.d.ts +159 -0
  124. package/dist/cli/connection/dto.js +497 -0
  125. package/dist/cli/connection/index.d.ts +50 -0
  126. package/dist/cli/connection/index.js +413 -0
  127. package/dist/cli/connection/oauth.d.ts +23 -0
  128. package/dist/cli/connection/oauth.js +290 -0
  129. package/dist/cli/connection/write.d.ts +47 -0
  130. package/dist/cli/connection/write.js +573 -0
  131. package/dist/cli/create/index.d.ts +19 -0
  132. package/dist/cli/create/index.js +209 -0
  133. package/dist/cli/declare/index.d.ts +29 -0
  134. package/dist/cli/declare/index.js +304 -0
  135. package/dist/cli/delete/index.d.ts +18 -0
  136. package/dist/cli/delete/index.js +232 -0
  137. package/dist/cli/download/index.d.ts +9 -0
  138. package/dist/cli/download/index.js +128 -0
  139. package/dist/cli/env/compose.d.ts +88 -0
  140. package/dist/cli/env/compose.js +402 -0
  141. package/dist/cli/env/index.d.ts +176 -0
  142. package/dist/cli/env/index.js +1011 -0
  143. package/dist/cli/experiments/index.d.ts +11 -0
  144. package/dist/cli/experiments/index.js +168 -0
  145. package/dist/cli/glob.d.ts +1 -0
  146. package/dist/cli/glob.js +45 -0
  147. package/dist/cli/graphql-helpers.d.ts +23 -0
  148. package/dist/cli/graphql-helpers.js +42 -0
  149. package/dist/cli/graphql.d.ts +10 -0
  150. package/dist/cli/graphql.js +47 -0
  151. package/dist/cli/help-examples.generated.d.ts +1 -0
  152. package/dist/cli/help-examples.generated.js +192 -0
  153. package/dist/cli/helpers.d.ts +8 -0
  154. package/dist/cli/helpers.js +106 -0
  155. package/dist/cli/hosts/api.d.ts +29 -0
  156. package/dist/cli/hosts/api.js +54 -0
  157. package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
  158. package/dist/cli/hosts/bootstrap-source.js +2 -0
  159. package/dist/cli/hosts/catalog.d.ts +26 -0
  160. package/dist/cli/hosts/catalog.js +55 -0
  161. package/dist/cli/hosts/config.d.ts +45 -0
  162. package/dist/cli/hosts/config.js +179 -0
  163. package/dist/cli/hosts/credentials.d.ts +19 -0
  164. package/dist/cli/hosts/credentials.js +173 -0
  165. package/dist/cli/hosts/enroll.d.ts +17 -0
  166. package/dist/cli/hosts/enroll.js +109 -0
  167. package/dist/cli/hosts/enrollments.d.ts +25 -0
  168. package/dist/cli/hosts/enrollments.js +54 -0
  169. package/dist/cli/hosts/index.d.ts +6 -0
  170. package/dist/cli/hosts/index.js +279 -0
  171. package/dist/cli/hosts/inventory.d.ts +40 -0
  172. package/dist/cli/hosts/inventory.js +91 -0
  173. package/dist/cli/hosts/lifecycle.d.ts +15 -0
  174. package/dist/cli/hosts/lifecycle.js +108 -0
  175. package/dist/cli/hosts/metrics-source.d.ts +12 -0
  176. package/dist/cli/hosts/metrics-source.js +89 -0
  177. package/dist/cli/hosts/observations.d.ts +39 -0
  178. package/dist/cli/hosts/observations.js +102 -0
  179. package/dist/cli/hosts/remote.d.ts +5 -0
  180. package/dist/cli/hosts/remote.js +66 -0
  181. package/dist/cli/hosts/ssh.d.ts +63 -0
  182. package/dist/cli/hosts/ssh.js +276 -0
  183. package/dist/cli/index.d.ts +1 -0
  184. package/dist/cli/index.js +288 -0
  185. package/dist/cli/infra/api.d.ts +95 -0
  186. package/dist/cli/infra/api.js +291 -0
  187. package/dist/cli/infra/index.d.ts +5 -0
  188. package/dist/cli/infra/index.js +102 -0
  189. package/dist/cli/infra/move.d.ts +15 -0
  190. package/dist/cli/infra/move.js +123 -0
  191. package/dist/cli/infra/transfer.d.ts +15 -0
  192. package/dist/cli/infra/transfer.js +280 -0
  193. package/dist/cli/jobs/api.d.ts +69 -0
  194. package/dist/cli/jobs/api.js +121 -0
  195. package/dist/cli/jobs/index.d.ts +5 -0
  196. package/dist/cli/jobs/index.js +140 -0
  197. package/dist/cli/lakeshore/index.d.ts +98 -0
  198. package/dist/cli/lakeshore/index.js +502 -0
  199. package/dist/cli/launch/index.d.ts +43 -0
  200. package/dist/cli/launch/index.js +270 -0
  201. package/dist/cli/layout/index.d.ts +2 -0
  202. package/dist/cli/layout/index.js +44 -0
  203. package/dist/cli/layout/transport.d.ts +12 -0
  204. package/dist/cli/layout/transport.js +70 -0
  205. package/dist/cli/library/add.d.ts +60 -0
  206. package/dist/cli/library/add.js +348 -0
  207. package/dist/cli/library/cache.d.ts +26 -0
  208. package/dist/cli/library/cache.js +88 -0
  209. package/dist/cli/library/config.d.ts +75 -0
  210. package/dist/cli/library/config.js +198 -0
  211. package/dist/cli/library/digest.d.ts +5 -0
  212. package/dist/cli/library/digest.js +19 -0
  213. package/dist/cli/library/discover.d.ts +87 -0
  214. package/dist/cli/library/discover.js +534 -0
  215. package/dist/cli/library/freshness.d.ts +35 -0
  216. package/dist/cli/library/freshness.js +109 -0
  217. package/dist/cli/library/generation.d.ts +35 -0
  218. package/dist/cli/library/generation.js +211 -0
  219. package/dist/cli/library/index.d.ts +2 -0
  220. package/dist/cli/library/index.js +36 -0
  221. package/dist/cli/library/info.d.ts +69 -0
  222. package/dist/cli/library/info.js +311 -0
  223. package/dist/cli/library/list.d.ts +33 -0
  224. package/dist/cli/library/list.js +86 -0
  225. package/dist/cli/library/manifest.d.ts +81 -0
  226. package/dist/cli/library/manifest.js +200 -0
  227. package/dist/cli/library/manifestCache.d.ts +45 -0
  228. package/dist/cli/library/manifestCache.js +169 -0
  229. package/dist/cli/library/pull.d.ts +30 -0
  230. package/dist/cli/library/pull.js +438 -0
  231. package/dist/cli/library/push.d.ts +72 -0
  232. package/dist/cli/library/push.js +642 -0
  233. package/dist/cli/library/rm.d.ts +31 -0
  234. package/dist/cli/library/rm.js +200 -0
  235. package/dist/cli/library/search.d.ts +18 -0
  236. package/dist/cli/library/search.js +181 -0
  237. package/dist/cli/library/stat.d.ts +15 -0
  238. package/dist/cli/library/stat.js +127 -0
  239. package/dist/cli/library/tools.d.ts +104 -0
  240. package/dist/cli/library/tools.js +163 -0
  241. package/dist/cli/library/wire.d.ts +47 -0
  242. package/dist/cli/library/wire.js +120 -0
  243. package/dist/cli/list/index.d.ts +26 -0
  244. package/dist/cli/list/index.js +256 -0
  245. package/dist/cli/notes/character-plan.d.ts +22 -0
  246. package/dist/cli/notes/character-plan.js +232 -0
  247. package/dist/cli/notes/document.d.ts +73 -0
  248. package/dist/cli/notes/document.js +306 -0
  249. package/dist/cli/notes/edit-commands.d.ts +106 -0
  250. package/dist/cli/notes/edit-commands.js +623 -0
  251. package/dist/cli/notes/editing.d.ts +81 -0
  252. package/dist/cli/notes/editing.js +305 -0
  253. package/dist/cli/notes/events.d.ts +36 -0
  254. package/dist/cli/notes/events.js +54 -0
  255. package/dist/cli/notes/files-commands.d.ts +120 -0
  256. package/dist/cli/notes/files-commands.js +554 -0
  257. package/dist/cli/notes/html-read.d.ts +9 -0
  258. package/dist/cli/notes/html-read.js +90 -0
  259. package/dist/cli/notes/html.d.ts +73 -0
  260. package/dist/cli/notes/html.js +381 -0
  261. package/dist/cli/notes/index.d.ts +123 -0
  262. package/dist/cli/notes/index.js +1303 -0
  263. package/dist/cli/notes/linger.d.ts +59 -0
  264. package/dist/cli/notes/linger.js +339 -0
  265. package/dist/cli/notes/media-commands.d.ts +5 -0
  266. package/dist/cli/notes/media-commands.js +51 -0
  267. package/dist/cli/notes/move-command.d.ts +83 -0
  268. package/dist/cli/notes/move-command.js +259 -0
  269. package/dist/cli/notes/rm-command.d.ts +22 -0
  270. package/dist/cli/notes/rm-command.js +110 -0
  271. package/dist/cli/notes/select-command.d.ts +12 -0
  272. package/dist/cli/notes/select-command.js +84 -0
  273. package/dist/cli/notes/suggest-diff.d.ts +56 -0
  274. package/dist/cli/notes/suggest-diff.js +311 -0
  275. package/dist/cli/notes/toc.d.ts +38 -0
  276. package/dist/cli/notes/toc.js +144 -0
  277. package/dist/cli/notes/transfer-command.d.ts +6 -0
  278. package/dist/cli/notes/transfer-command.js +9 -0
  279. package/dist/cli/notes/version-commands.d.ts +19 -0
  280. package/dist/cli/notes/version-commands.js +178 -0
  281. package/dist/cli/nymph/index.d.ts +74 -0
  282. package/dist/cli/nymph/index.js +349 -0
  283. package/dist/cli/org/index.d.ts +34 -0
  284. package/dist/cli/org/index.js +341 -0
  285. package/dist/cli/ownership/index.d.ts +12 -0
  286. package/dist/cli/ownership/index.js +122 -0
  287. package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
  288. package/dist/cli/ownership/metadata-transfer.js +159 -0
  289. package/dist/cli/page/index.d.ts +58 -0
  290. package/dist/cli/page/index.js +387 -0
  291. package/dist/cli/pipeline/index.d.ts +69 -0
  292. package/dist/cli/pipeline/index.js +604 -0
  293. package/dist/cli/progress.d.ts +60 -0
  294. package/dist/cli/progress.js +276 -0
  295. package/dist/cli/project/attachments.d.ts +10 -0
  296. package/dist/cli/project/attachments.js +39 -0
  297. package/dist/cli/project/grants.d.ts +10 -0
  298. package/dist/cli/project/grants.js +39 -0
  299. package/dist/cli/project/index.d.ts +8 -0
  300. package/dist/cli/project/index.js +92 -0
  301. package/dist/cli/project/move.d.ts +57 -0
  302. package/dist/cli/project/move.js +242 -0
  303. package/dist/cli/project/output.d.ts +2 -0
  304. package/dist/cli/project/output.js +29 -0
  305. package/dist/cli/project/stream.d.ts +55 -0
  306. package/dist/cli/project/stream.js +207 -0
  307. package/dist/cli/project/transfer-preview.d.ts +8 -0
  308. package/dist/cli/project/transfer-preview.js +10 -0
  309. package/dist/cli/prompt.d.ts +1 -0
  310. package/dist/cli/prompt.js +17 -0
  311. package/dist/cli/provider/dreamdir.d.ts +52 -0
  312. package/dist/cli/provider/dreamdir.js +138 -0
  313. package/dist/cli/provider/index.d.ts +4 -0
  314. package/dist/cli/provider/index.js +419 -0
  315. package/dist/cli/provider/jump-worker.d.ts +9 -0
  316. package/dist/cli/provider/jump-worker.js +141 -0
  317. package/dist/cli/provider/lifecycle.d.ts +149 -0
  318. package/dist/cli/provider/lifecycle.js +1390 -0
  319. package/dist/cli/provider/machine.d.ts +17 -0
  320. package/dist/cli/provider/machine.js +116 -0
  321. package/dist/cli/provider/ssh.d.ts +105 -0
  322. package/dist/cli/provider/ssh.js +305 -0
  323. package/dist/cli/provider/terraform.d.ts +140 -0
  324. package/dist/cli/provider/terraform.js +288 -0
  325. package/dist/cli/providers/index.d.ts +18 -0
  326. package/dist/cli/providers/index.js +422 -0
  327. package/dist/cli/python.d.ts +61 -0
  328. package/dist/cli/python.js +255 -0
  329. package/dist/cli/queues/index.d.ts +33 -0
  330. package/dist/cli/queues/index.js +248 -0
  331. package/dist/cli/queues/slurm.d.ts +10 -0
  332. package/dist/cli/queues/slurm.js +134 -0
  333. package/dist/cli/resources.d.ts +72 -0
  334. package/dist/cli/resources.js +137 -0
  335. package/dist/cli/run/index.d.ts +15 -0
  336. package/dist/cli/run/index.js +163 -0
  337. package/dist/cli/run/input.d.ts +34 -0
  338. package/dist/cli/run/input.js +135 -0
  339. package/dist/cli/run/recovery.d.ts +2 -0
  340. package/dist/cli/run/recovery.js +18 -0
  341. package/dist/cli/run/setup.d.ts +3 -0
  342. package/dist/cli/run/setup.js +62 -0
  343. package/dist/cli/runconfig/index.d.ts +12 -0
  344. package/dist/cli/runconfig/index.js +130 -0
  345. package/dist/cli/runnable/index.d.ts +35 -0
  346. package/dist/cli/runnable/index.js +575 -0
  347. package/dist/cli/runnable/path.d.ts +115 -0
  348. package/dist/cli/runnable/path.js +288 -0
  349. package/dist/cli/runnable/run.d.ts +91 -0
  350. package/dist/cli/runnable/run.js +239 -0
  351. package/dist/cli/runnable/upload.d.ts +43 -0
  352. package/dist/cli/runnable/upload.js +342 -0
  353. package/dist/cli/runnable/worker.d.ts +1 -0
  354. package/dist/cli/runnable/worker.js +44 -0
  355. package/dist/cli/schemas/workflow-spec.schema.json +335 -0
  356. package/dist/cli/self-update/index.d.ts +5 -0
  357. package/dist/cli/self-update/index.js +107 -0
  358. package/dist/cli/self-update/install.d.ts +60 -0
  359. package/dist/cli/self-update/install.js +428 -0
  360. package/dist/cli/self-update/paths.d.ts +40 -0
  361. package/dist/cli/self-update/paths.js +87 -0
  362. package/dist/cli/self-update/releases.d.ts +41 -0
  363. package/dist/cli/self-update/releases.js +153 -0
  364. package/dist/cli/self-update/settings.d.ts +16 -0
  365. package/dist/cli/self-update/settings.js +68 -0
  366. package/dist/cli/self-update/update.d.ts +18 -0
  367. package/dist/cli/self-update/update.js +241 -0
  368. package/dist/cli/service-accounts/index.d.ts +3 -0
  369. package/dist/cli/service-accounts/index.js +149 -0
  370. package/dist/cli/session-affiliation.d.ts +26 -0
  371. package/dist/cli/session-affiliation.js +135 -0
  372. package/dist/cli/sessions/affiliation.d.ts +8 -0
  373. package/dist/cli/sessions/affiliation.js +66 -0
  374. package/dist/cli/sessions/api.d.ts +55 -0
  375. package/dist/cli/sessions/api.js +88 -0
  376. package/dist/cli/sessions/control.d.ts +6 -0
  377. package/dist/cli/sessions/control.js +159 -0
  378. package/dist/cli/sessions/conversation.d.ts +15 -0
  379. package/dist/cli/sessions/conversation.js +118 -0
  380. package/dist/cli/sessions/index.d.ts +2 -0
  381. package/dist/cli/sessions/index.js +209 -0
  382. package/dist/cli/sessions/managed.d.ts +39 -0
  383. package/dist/cli/sessions/managed.js +63 -0
  384. package/dist/cli/sessions/redaction.d.ts +2 -0
  385. package/dist/cli/sessions/redaction.js +11 -0
  386. package/dist/cli/sessions/runner/exec.d.ts +108 -0
  387. package/dist/cli/sessions/runner/exec.js +335 -0
  388. package/dist/cli/sessions/runner/journal.d.ts +26 -0
  389. package/dist/cli/sessions/runner/journal.js +49 -0
  390. package/dist/cli/sessions/runner/native.d.ts +48 -0
  391. package/dist/cli/sessions/runner/native.js +170 -0
  392. package/dist/cli/sessions/runner/pod.d.ts +30 -0
  393. package/dist/cli/sessions/runner/pod.js +129 -0
  394. package/dist/cli/sessions/runner/serve.d.ts +85 -0
  395. package/dist/cli/sessions/runner/serve.js +558 -0
  396. package/dist/cli/sessions/sync.d.ts +47 -0
  397. package/dist/cli/sessions/sync.js +80 -0
  398. package/dist/cli/sessions/transport.d.ts +14 -0
  399. package/dist/cli/sessions/transport.js +116 -0
  400. package/dist/cli/share.d.ts +15 -0
  401. package/dist/cli/share.js +139 -0
  402. package/dist/cli/skill/catalog.d.ts +141 -0
  403. package/dist/cli/skill/catalog.js +442 -0
  404. package/dist/cli/skill/files.d.ts +89 -0
  405. package/dist/cli/skill/files.js +264 -0
  406. package/dist/cli/skill/index.d.ts +268 -0
  407. package/dist/cli/skill/index.js +1216 -0
  408. package/dist/cli/skill/manifest.d.ts +30 -0
  409. package/dist/cli/skill/manifest.js +101 -0
  410. package/dist/cli/skill/prefs.d.ts +9 -0
  411. package/dist/cli/skill/prefs.js +32 -0
  412. package/dist/cli/skill/reminders.d.ts +15 -0
  413. package/dist/cli/skill/reminders.js +105 -0
  414. package/dist/cli/skill/tar.d.ts +17 -0
  415. package/dist/cli/skill/tar.js +195 -0
  416. package/dist/cli/snapshot/index.d.ts +24 -0
  417. package/dist/cli/snapshot/index.js +146 -0
  418. package/dist/cli/source/access.d.ts +45 -0
  419. package/dist/cli/source/access.js +563 -0
  420. package/dist/cli/source/control.d.ts +103 -0
  421. package/dist/cli/source/control.js +546 -0
  422. package/dist/cli/source/delete.d.ts +89 -0
  423. package/dist/cli/source/delete.js +463 -0
  424. package/dist/cli/source/index.d.ts +288 -0
  425. package/dist/cli/source/index.js +1348 -0
  426. package/dist/cli/source/share.d.ts +65 -0
  427. package/dist/cli/source/share.js +530 -0
  428. package/dist/cli/source/upload.d.ts +62 -0
  429. package/dist/cli/source/upload.js +258 -0
  430. package/dist/cli/source/write.d.ts +77 -0
  431. package/dist/cli/source/write.js +335 -0
  432. package/dist/cli/spawn.d.ts +28 -0
  433. package/dist/cli/spawn.js +81 -0
  434. package/dist/cli/target.d.ts +22 -0
  435. package/dist/cli/target.js +85 -0
  436. package/dist/cli/tasks/index.d.ts +38 -0
  437. package/dist/cli/tasks/index.js +365 -0
  438. package/dist/cli/team/index.d.ts +37 -0
  439. package/dist/cli/team/index.js +407 -0
  440. package/dist/cli/telemetry.d.ts +23 -0
  441. package/dist/cli/telemetry.js +262 -0
  442. package/dist/cli/telemetryJournal.d.ts +26 -0
  443. package/dist/cli/telemetryJournal.js +104 -0
  444. package/dist/cli/update/index.d.ts +21 -0
  445. package/dist/cli/update/index.js +284 -0
  446. package/dist/cli/upload/index.d.ts +11 -0
  447. package/dist/cli/upload/index.js +261 -0
  448. package/dist/cli/upload/kinds.d.ts +10 -0
  449. package/dist/cli/upload/kinds.js +85 -0
  450. package/dist/cli/upload/multipart.d.ts +21 -0
  451. package/dist/cli/upload/multipart.js +248 -0
  452. package/dist/cli/vault/affected-preview.d.ts +15 -0
  453. package/dist/cli/vault/affected-preview.js +38 -0
  454. package/dist/cli/vault/cloud.d.ts +55 -0
  455. package/dist/cli/vault/cloud.js +287 -0
  456. package/dist/cli/vault/format.d.ts +18 -0
  457. package/dist/cli/vault/format.js +104 -0
  458. package/dist/cli/vault/hostCredentials.d.ts +21 -0
  459. package/dist/cli/vault/hostCredentials.js +71 -0
  460. package/dist/cli/vault/hostSupersessions.d.ts +18 -0
  461. package/dist/cli/vault/hostSupersessions.js +68 -0
  462. package/dist/cli/vault/import.d.ts +3 -0
  463. package/dist/cli/vault/import.js +79 -0
  464. package/dist/cli/vault/index.d.ts +14 -0
  465. package/dist/cli/vault/index.js +225 -0
  466. package/dist/cli/vault/keys.d.ts +5 -0
  467. package/dist/cli/vault/keys.js +165 -0
  468. package/dist/cli/vault/kms.d.ts +6 -0
  469. package/dist/cli/vault/kms.js +169 -0
  470. package/dist/cli/vault/list.d.ts +13 -0
  471. package/dist/cli/vault/list.js +60 -0
  472. package/dist/cli/vault/listView.d.ts +21 -0
  473. package/dist/cli/vault/listView.js +123 -0
  474. package/dist/cli/vault/managementMetadata.d.ts +2 -0
  475. package/dist/cli/vault/managementMetadata.js +23 -0
  476. package/dist/cli/vault/mutations.d.ts +8 -0
  477. package/dist/cli/vault/mutations.js +151 -0
  478. package/dist/cli/vault/otp.d.ts +6 -0
  479. package/dist/cli/vault/otp.js +62 -0
  480. package/dist/cli/vault/otpIntent.d.ts +23 -0
  481. package/dist/cli/vault/otpIntent.js +76 -0
  482. package/dist/cli/vault/passImport.d.ts +25 -0
  483. package/dist/cli/vault/passImport.js +129 -0
  484. package/dist/cli/vault/passOtp.d.ts +51 -0
  485. package/dist/cli/vault/passOtp.js +101 -0
  486. package/dist/cli/vault/passStore.d.ts +26 -0
  487. package/dist/cli/vault/passStore.js +134 -0
  488. package/dist/cli/vault/passwordCommand.d.ts +39 -0
  489. package/dist/cli/vault/passwordCommand.js +101 -0
  490. package/dist/cli/vault/passwordProbe.d.ts +27 -0
  491. package/dist/cli/vault/passwordProbe.js +282 -0
  492. package/dist/cli/vault/passwordRotation.d.ts +9 -0
  493. package/dist/cli/vault/passwordRotation.js +273 -0
  494. package/dist/cli/vault/rotationApi.d.ts +13 -0
  495. package/dist/cli/vault/rotationApi.js +58 -0
  496. package/dist/cli/vault/rotationCommand.d.ts +2 -0
  497. package/dist/cli/vault/rotationCommand.js +75 -0
  498. package/dist/cli/vault/rotationEngine.d.ts +19 -0
  499. package/dist/cli/vault/rotationEngine.js +65 -0
  500. package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
  501. package/dist/cli/vault/rotationHelperSource.js +3 -0
  502. package/dist/cli/vault/rotationInput.d.ts +11 -0
  503. package/dist/cli/vault/rotationInput.js +48 -0
  504. package/dist/cli/vault/rotationJournal.d.ts +16 -0
  505. package/dist/cli/vault/rotationJournal.js +183 -0
  506. package/dist/cli/vault/rotationKeys.d.ts +4 -0
  507. package/dist/cli/vault/rotationKeys.js +48 -0
  508. package/dist/cli/vault/rotationPrepare.d.ts +17 -0
  509. package/dist/cli/vault/rotationPrepare.js +108 -0
  510. package/dist/cli/vault/rotationRemote.d.ts +33 -0
  511. package/dist/cli/vault/rotationRemote.js +156 -0
  512. package/dist/cli/vault/rotationState.d.ts +42 -0
  513. package/dist/cli/vault/rotationState.js +115 -0
  514. package/dist/cli/vault/rotationTransport.d.ts +18 -0
  515. package/dist/cli/vault/rotationTransport.js +71 -0
  516. package/dist/cli/vault/sshSource.d.ts +18 -0
  517. package/dist/cli/vault/sshSource.js +196 -0
  518. package/dist/cli/vault/sshSync.d.ts +17 -0
  519. package/dist/cli/vault/sshSync.js +224 -0
  520. package/dist/cli/vault/sshTransfer.d.ts +22 -0
  521. package/dist/cli/vault/sshTransfer.js +140 -0
  522. package/dist/cli/vault/terraformState.d.ts +66 -0
  523. package/dist/cli/vault/terraformState.js +252 -0
  524. package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
  525. package/dist/cli/vault/terraformStateCommand.js +61 -0
  526. package/dist/cli/vault/tree.d.ts +43 -0
  527. package/dist/cli/vault/tree.js +292 -0
  528. package/dist/cli/version.d.ts +1 -0
  529. package/dist/cli/version.js +9 -0
  530. package/dist/cli/workflow/index.d.ts +76 -0
  531. package/dist/cli/workflow/index.js +826 -0
  532. package/dist/cli/workflow/validate.d.ts +19 -0
  533. package/dist/cli/workflow/validate.js +353 -0
  534. package/dist/package.json +1 -0
  535. package/package.json +28 -10
@@ -0,0 +1,573 @@
1
+ // The mutating half of `dreamlake connection …`.
2
+ //
3
+ // Two rules shape almost everything here.
4
+ //
5
+ // A credential never appears in argv. There is no `--credential '{"key":"…"}'`
6
+ // and there will not be one: an argument is visible in `ps` to every other user
7
+ // on the machine for as long as the process runs, and it lands in the shell
8
+ // history file afterwards. Credentials are read from a file or from stdin, both
9
+ // of which stay between the caller and this process.
10
+ //
11
+ // The server owns the schema. This module never checks a connector kind, an
12
+ // auth kind, or the shape of a credential against a local list. It checks that
13
+ // a credential parsed as a JSON object — which the wire contract requires — and
14
+ // forwards it. A connector added to the server last week works here today.
15
+ import { readFileSync } from "node:fs";
16
+ import { randomUUID } from "node:crypto";
17
+ import { HttpError, requestJson } from "../client.js";
18
+ import { emitJson, fail, ok } from "../helpers.js";
19
+ import { parseCheck, parseDetail } from "./dto.js";
20
+ import { connectionPath, ctx, explain, fetchConnection, seg, strictArgs, } from "./index.js";
21
+ // ─── idempotency ──────────────────────────────────────────────────────────────
22
+ /*
23
+ * The same semantics the Source write plane uses, deliberately restated rather
24
+ * than imported.
25
+ *
26
+ * Sharing the function would mean this module importing from `source/`, and the
27
+ * boundary between Connections and Sources is one the server enforces with a
28
+ * named test. The rule itself is frozen by ruling and pinned by tests on both
29
+ * sides; what is not shared is the dependency.
30
+ *
31
+ * The key is random per invocation and never derived from a label, a namespace
32
+ * or a connector identity. A derived key would collide across two Connections
33
+ * that differ only in a field the derivation ignores, and it would make a
34
+ * deliberate second Connection to the same place impossible to express.
35
+ */
36
+ const MAX_IDEMPOTENCY_KEY = 255;
37
+ function idempotencyKey(override) {
38
+ /*
39
+ * Absent and empty are different requests. Absent means "new command, invent
40
+ * an identity". An explicit empty string — or a shell variable that expanded
41
+ * to nothing — means "the same command as before", and quietly inventing a
42
+ * fresh key for it creates a second Connection out of what the caller
43
+ * believed was a retry.
44
+ */
45
+ if (override === undefined)
46
+ return { ok: true, key: randomUUID() };
47
+ const key = override.trim();
48
+ if (key === "") {
49
+ fail("--idempotency-key is empty — omit it to start a new command");
50
+ return { ok: false };
51
+ }
52
+ if (key.length > MAX_IDEMPOTENCY_KEY) {
53
+ fail(`--idempotency-key is longer than ${MAX_IDEMPOTENCY_KEY} characters`);
54
+ return { ok: false };
55
+ }
56
+ return { ok: true, key };
57
+ }
58
+ /**
59
+ * What to say when the request left and no answer came back.
60
+ *
61
+ * The server records these commands under the key, so the honest instruction is
62
+ * to repeat the command with the SAME key — which is the one thing the caller
63
+ * cannot reconstruct unless it is printed here.
64
+ *
65
+ * Only ever called for the MUTATION itself. See `readRevision`.
66
+ */
67
+ function ambiguous(what, key, err) {
68
+ fail(`${what}: the request was sent but the response never arrived.\n` +
69
+ ` The server may or may not have applied it. Retry with the SAME key:\n` +
70
+ ` --idempotency-key ${key}\n` +
71
+ ` Reusing that key returns the original result instead of acting twice.\n` +
72
+ ` (${err.message})`);
73
+ }
74
+ /** A transport failure that left the outcome unknown, as opposed to a refusal. */
75
+ function isAmbiguous(err) {
76
+ return !(err instanceof HttpError);
77
+ }
78
+ // ─── credential input ─────────────────────────────────────────────────────────
79
+ function readStdin() {
80
+ try {
81
+ return readFileSync(0, "utf8");
82
+ }
83
+ catch (err) {
84
+ fail(`could not read stdin: ${err.message}`);
85
+ return "";
86
+ }
87
+ }
88
+ function parseObject(raw, where) {
89
+ let parsed;
90
+ try {
91
+ parsed = JSON.parse(raw);
92
+ }
93
+ catch (err) {
94
+ fail(`${where}: not valid JSON — ${err.message}`);
95
+ return { ok: false };
96
+ }
97
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
98
+ fail(`${where}: must be a JSON object`);
99
+ return { ok: false };
100
+ }
101
+ /*
102
+ * Deliberately the only check. What belongs inside a credential is the
103
+ * connector descriptor's business, and a CLI that also had an opinion would
104
+ * reject a field the server had just started accepting.
105
+ */
106
+ return { ok: true, value: parsed };
107
+ }
108
+ /**
109
+ * A credential, from a file or from stdin — never from an argument.
110
+ *
111
+ * `null` means "none was offered", which each caller interprets for itself.
112
+ */
113
+ function readCredential(opts) {
114
+ const fromFile = opts.credentialFile !== undefined;
115
+ const fromStdin = opts.credentialStdin === true;
116
+ if (fromFile && fromStdin) {
117
+ fail("pass either --credential-file or --credential-stdin, not both");
118
+ return { ok: false };
119
+ }
120
+ if (!fromFile && !fromStdin)
121
+ return null;
122
+ if (fromStdin) {
123
+ const raw = readStdin();
124
+ if (raw === "") {
125
+ fail("--credential-stdin: nothing was read from stdin");
126
+ return { ok: false };
127
+ }
128
+ return parseObject(raw, "credential");
129
+ }
130
+ let raw;
131
+ try {
132
+ raw = readFileSync(opts.credentialFile, "utf8");
133
+ }
134
+ catch (err) {
135
+ fail(`--credential-file: ${err.message}`);
136
+ return { ok: false };
137
+ }
138
+ return parseObject(raw, "credential");
139
+ }
140
+ function readPrivateConfig(path) {
141
+ if (path === undefined)
142
+ return null;
143
+ let raw;
144
+ try {
145
+ raw = readFileSync(path, "utf8");
146
+ }
147
+ catch (err) {
148
+ fail(`--private-config-file: ${err.message}`);
149
+ return { ok: false };
150
+ }
151
+ return parseObject(raw, "private config");
152
+ }
153
+ // ─── reporting ────────────────────────────────────────────────────────────────
154
+ /*
155
+ * Only the validated projection is ever printed — the object `parseDetail`
156
+ * built, not the response that arrived. The credential that was just sent is
157
+ * not echoed back in any form, including under --json: a caller piping this
158
+ * into a log would otherwise write the secret they were careful to keep out of
159
+ * their shell history.
160
+ */
161
+ function report(one, json, verb) {
162
+ if (json) {
163
+ emitJson(one);
164
+ return;
165
+ }
166
+ ok(`${verb} ${one.label} (${one.id}) — ${one.lifecycle}, revision ${one.settingsRevision}`);
167
+ }
168
+ /**
169
+ * Read the current revision, validating it before it is handed back as CAS.
170
+ *
171
+ * Deliberately NOT inside the mutation's try block, and it reports its own
172
+ * failures. A dropped socket on this request is an ordinary read failure —
173
+ * nothing was written, and nothing can have been, because the write has not
174
+ * been composed yet. Letting it fall into the mutation's catch would print
175
+ * "the server may or may not have applied it; retry with this key" about a
176
+ * request that never left the process, and send the caller to reuse a key
177
+ * against a command that was never issued.
178
+ */
179
+ async function readRevision(c, id) {
180
+ try {
181
+ const one = await fetchConnection(c, id);
182
+ return one === null ? null : one.settingsRevision;
183
+ }
184
+ catch (err) {
185
+ fail(explain(err));
186
+ return null;
187
+ }
188
+ }
189
+ // ─── create ───────────────────────────────────────────────────────────────────
190
+ export async function runConnectionCreate(opts) {
191
+ const withoutCredential = opts.credential === false;
192
+ /*
193
+ * Refused here rather than sorted out by precedence. Someone who passed both
194
+ * a credential and "send none" has two incompatible intentions, and silently
195
+ * honouring either one sends a request they did not ask for.
196
+ */
197
+ if (withoutCredential && (opts.credentialFile !== undefined || opts.credentialStdin === true)) {
198
+ fail("--no-credential cannot be combined with --credential-file or --credential-stdin");
199
+ return 1;
200
+ }
201
+ /*
202
+ * Read only when one is expected, and narrowed here rather than at the
203
+ * request — so the payload below cannot reach for a value that was never
204
+ * parsed.
205
+ */
206
+ let credentialValue;
207
+ if (!withoutCredential) {
208
+ const credential = readCredential(opts);
209
+ if (credential === null) {
210
+ fail("a credential is required — pass --credential-file <path> or --credential-stdin");
211
+ return 1;
212
+ }
213
+ if (!credential.ok)
214
+ return 1;
215
+ credentialValue = credential.value;
216
+ }
217
+ const privateConfig = readPrivateConfig(opts.privateConfigFile);
218
+ if (privateConfig !== null && !privateConfig.ok)
219
+ return 1;
220
+ const key = idempotencyKey(opts.idempotencyKey);
221
+ if (!key.ok)
222
+ return 1;
223
+ const c = await ctx(opts.namespace);
224
+ if (!c)
225
+ return 1;
226
+ try {
227
+ const res = await requestJson(c.remote, `/namespaces/${seg(c.ns)}/connections`, {
228
+ method: "POST",
229
+ token: c.token,
230
+ headers: { "Idempotency-Key": key.key },
231
+ json: {
232
+ label: opts.label,
233
+ /*
234
+ * Both forwarded exactly as given. This client does not know which auth
235
+ * kinds may go without a credential — the server declares that, and is
236
+ * the only thing entitled to decide it.
237
+ */
238
+ connectorKind: opts.connector,
239
+ authKind: opts.authKind,
240
+ /*
241
+ * The key is OMITTED, not sent empty. `{}` would assert that a
242
+ * credential exists and is blank — something the server has to store,
243
+ * with the revoke, rotation and audit meaning that carries. Absent says
244
+ * there is none.
245
+ */
246
+ ...(withoutCredential ? {} : { credential: credentialValue }),
247
+ ...(privateConfig ? { privateConfig: privateConfig.value } : {}),
248
+ },
249
+ });
250
+ const one = parseDetail(res, "create");
251
+ if (!one)
252
+ return 1;
253
+ report(one, opts.json === true, "Created");
254
+ return 0;
255
+ }
256
+ catch (err) {
257
+ if (isAmbiguous(err))
258
+ ambiguous("create", key.key, err);
259
+ else
260
+ fail(explain(err));
261
+ return 1;
262
+ }
263
+ }
264
+ // ─── rename ───────────────────────────────────────────────────────────────────
265
+ export async function runConnectionRename(id, opts) {
266
+ const key = idempotencyKey(opts.idempotencyKey);
267
+ if (!key.ok)
268
+ return 1;
269
+ const c = await ctx(opts.namespace);
270
+ if (!c)
271
+ return 1;
272
+ const revision = await readRevision(c, id);
273
+ if (revision === null)
274
+ return 1;
275
+ try {
276
+ const res = await requestJson(c.remote, connectionPath(c, id), {
277
+ method: "PATCH",
278
+ token: c.token,
279
+ headers: { "Idempotency-Key": key.key },
280
+ json: { expectedSettingsRevision: revision, label: opts.label },
281
+ });
282
+ const one = parseDetail(res, "rename");
283
+ if (!one)
284
+ return 1;
285
+ report(one, opts.json === true, "Renamed");
286
+ return 0;
287
+ }
288
+ catch (err) {
289
+ if (isAmbiguous(err))
290
+ ambiguous("rename", key.key, err);
291
+ else
292
+ fail(explain(err));
293
+ return 1;
294
+ }
295
+ }
296
+ // ─── check ────────────────────────────────────────────────────────────────────
297
+ /*
298
+ * A probe, and only a probe.
299
+ *
300
+ * `unavailable` is a fact this command successfully established, so it exits 0.
301
+ * Exiting non-zero would make every wrapper script treat a correctly reported
302
+ * outage as a broken command. And nothing is disabled as a consequence: a
303
+ * network blip would otherwise take a working Connection offline, and only a
304
+ * person can decide that.
305
+ */
306
+ export async function runConnectionCheck(id, opts) {
307
+ const c = await ctx(opts.namespace);
308
+ if (!c)
309
+ return 1;
310
+ try {
311
+ const res = await requestJson(c.remote, `${connectionPath(c, id)}:check`, {
312
+ method: "POST",
313
+ token: c.token,
314
+ // The action takes no body fields at all; the server rejects any.
315
+ json: {},
316
+ });
317
+ const result = parseCheck(res, "check");
318
+ if (!result)
319
+ return 1;
320
+ if (opts.json) {
321
+ emitJson(result);
322
+ return 0;
323
+ }
324
+ process.stdout.write(` status: ${result.status}\n`);
325
+ if (result.detectedAccess)
326
+ process.stdout.write(` access: ${result.detectedAccess}\n`);
327
+ if (result.reason)
328
+ process.stdout.write(` reason: ${result.reason}\n`);
329
+ process.stdout.write(` retry: ${result.retryable ? "may help" : "would not help"}\n`);
330
+ process.stdout.write(` checked: ${result.checkedAt}\n`);
331
+ if (result.managementHint)
332
+ process.stdout.write(` hint: ${result.managementHint}\n`);
333
+ /*
334
+ * Three outcomes, three sentences. What they have in common is that the
335
+ * probe SUCCEEDED — all three exit 0, and none of them changes anything.
336
+ *
337
+ * `unverified` is the one that is easiest to get wrong, and this client did
338
+ * get it wrong: it means the credential cannot be judged at this layer at
339
+ * all, because the connector binds validation to a target and the target
340
+ * belongs to a Source. Nothing is wrong with the credential, so there is
341
+ * nothing to disable and nothing to re-enter — the answer is to point it at
342
+ * something, which happens in `source import`. Telling a manager to replace
343
+ * a working credential is exactly the reaction §3.1 separates this status
344
+ * from `unavailable` to prevent.
345
+ *
346
+ * `connection-disabled` is not an outage either: the Connection is already
347
+ * off, and offering to disable it would name the command already in effect.
348
+ * Every other `unavailable` leaves it enabled, and there the offer is real.
349
+ */
350
+ if (result.status === "unverified") {
351
+ process.stdout.write("\n Nothing was changed, and nothing is wrong with this credential.\n" +
352
+ " This connector can only be verified against a target, which belongs\n" +
353
+ " to a Source rather than to the Connection — so this layer cannot ask\n" +
354
+ " the provider anything. It gets exercised when a Source uses it:\n" +
355
+ ` dreamlake source import --connector <kind> --connection ${id} --target <json>\n`);
356
+ }
357
+ else if (result.status === "unavailable") {
358
+ process.stdout.write(result.reason === "connection-disabled"
359
+ ? "\n Nothing was changed. This connection is already disabled;\n" +
360
+ ` enable it when you want to use it: dreamlake connection enable ${id}\n`
361
+ : "\n Nothing was changed. This connection is still enabled; disable it\n" +
362
+ ` yourself if that is what you want: dreamlake connection disable ${id}\n`);
363
+ }
364
+ return 0;
365
+ }
366
+ catch (err) {
367
+ fail(explain(err));
368
+ return 1;
369
+ }
370
+ }
371
+ // ─── reconnect ────────────────────────────────────────────────────────────────
372
+ export async function runConnectionReconnect(id, opts) {
373
+ const credential = readCredential(opts);
374
+ if (credential === null) {
375
+ fail("a credential is required — pass --credential-file <path> or --credential-stdin");
376
+ return 1;
377
+ }
378
+ if (!credential.ok)
379
+ return 1;
380
+ const privateConfig = readPrivateConfig(opts.privateConfigFile);
381
+ if (privateConfig !== null && !privateConfig.ok)
382
+ return 1;
383
+ const key = idempotencyKey(opts.idempotencyKey);
384
+ if (!key.ok)
385
+ return 1;
386
+ const c = await ctx(opts.namespace);
387
+ if (!c)
388
+ return 1;
389
+ const revision = await readRevision(c, id);
390
+ if (revision === null)
391
+ return 1;
392
+ try {
393
+ const res = await requestJson(c.remote, `${connectionPath(c, id)}:reconnect`, {
394
+ method: "POST",
395
+ token: c.token,
396
+ headers: { "Idempotency-Key": key.key },
397
+ json: {
398
+ expectedSettingsRevision: revision,
399
+ credential: credential.value,
400
+ ...(privateConfig ? { privateConfig: privateConfig.value } : {}),
401
+ ...(opts.enableAfterSuccess ? { enableAfterSuccess: true } : {}),
402
+ },
403
+ });
404
+ const one = parseDetail(res, "reconnect");
405
+ if (!one)
406
+ return 1;
407
+ report(one, opts.json === true, "Reconnected");
408
+ return 0;
409
+ }
410
+ catch (err) {
411
+ if (isAmbiguous(err))
412
+ ambiguous("reconnect", key.key, err);
413
+ else
414
+ fail(explain(err));
415
+ return 1;
416
+ }
417
+ }
418
+ // ─── enable / disable ─────────────────────────────────────────────────────────
419
+ async function lifecycle(id, action, opts) {
420
+ const key = idempotencyKey(opts.idempotencyKey);
421
+ if (!key.ok)
422
+ return 1;
423
+ const c = await ctx(opts.namespace);
424
+ if (!c)
425
+ return 1;
426
+ const revision = await readRevision(c, id);
427
+ if (revision === null)
428
+ return 1;
429
+ try {
430
+ const res = await requestJson(c.remote, `${connectionPath(c, id)}:${action}`, {
431
+ method: "POST",
432
+ token: c.token,
433
+ headers: { "Idempotency-Key": key.key },
434
+ json: { expectedSettingsRevision: revision },
435
+ });
436
+ const one = parseDetail(res, action);
437
+ if (!one)
438
+ return 1;
439
+ report(one, opts.json === true, action === "enable" ? "Enabled" : "Disabled");
440
+ return 0;
441
+ }
442
+ catch (err) {
443
+ if (isAmbiguous(err))
444
+ ambiguous(action, key.key, err);
445
+ else
446
+ fail(explain(err));
447
+ return 1;
448
+ }
449
+ }
450
+ export const runConnectionEnable = (id, o) => lifecycle(id, "enable", o);
451
+ export const runConnectionDisable = (id, o) => lifecycle(id, "disable", o);
452
+ // ─── delete ───────────────────────────────────────────────────────────────────
453
+ export async function runConnectionDelete(id, opts) {
454
+ const key = idempotencyKey(opts.idempotencyKey);
455
+ if (!key.ok)
456
+ return 1;
457
+ const c = await ctx(opts.namespace);
458
+ if (!c)
459
+ return 1;
460
+ const revision = await readRevision(c, id);
461
+ if (revision === null)
462
+ return 1;
463
+ try {
464
+ await requestJson(c.remote, connectionPath(c, id), {
465
+ method: "DELETE",
466
+ token: c.token,
467
+ headers: { "Idempotency-Key": key.key },
468
+ json: { expectedSettingsRevision: revision },
469
+ });
470
+ if (opts.json) {
471
+ emitJson({ id, deleted: true });
472
+ return 0;
473
+ }
474
+ ok(`Deleted connection ${id}`);
475
+ return 0;
476
+ }
477
+ catch (err) {
478
+ /*
479
+ * A Connection still in use is refused, and it stays refused. Detaching the
480
+ * Sources first would be this command silently doing something far larger
481
+ * than "delete a connection" — every one of them loses its credential, and
482
+ * nothing here knows whether that is acceptable.
483
+ *
484
+ * Branched on `code`, which is the envelope's stable identity for the
485
+ * refusal. The earlier version matched the CODE against the human MESSAGE,
486
+ * and the server's actual message is "This Connection is still used by one
487
+ * or more Sources." — the code appears nowhere in it. That test passed only
488
+ * because its fixture put the code in the message, which no server does.
489
+ */
490
+ if (err instanceof HttpError && err.code === "CONNECTION_IN_USE") {
491
+ fail(`${err.message}\n` +
492
+ ` Nothing was deleted and no source was changed. See what still uses it:\n` +
493
+ ` dreamlake connection affected-sources ${id}`);
494
+ return 1;
495
+ }
496
+ if (isAmbiguous(err))
497
+ ambiguous("delete", key.key, err);
498
+ else
499
+ fail(explain(err));
500
+ return 1;
501
+ }
502
+ }
503
+ // ─── registration ─────────────────────────────────────────────────────────────
504
+ const CREDENTIAL_HELP = "A credential is never taken as an argument: argv is visible in `ps` and is " +
505
+ "saved to your shell history. Use --credential-file, or pipe it in with " +
506
+ "--credential-stdin.";
507
+ export function registerConnectionWriteCommands(connection) {
508
+ const credentialOpts = (cmd) => cmd
509
+ .option("--credential-file <path>", "JSON file holding the credential")
510
+ .option("--credential-stdin", "read the credential as JSON from stdin")
511
+ .option("--private-config-file <path>", "JSON file holding non-secret connector config")
512
+ .addHelpText("after", `\n${CREDENTIAL_HELP}\n`);
513
+ const idempotent = (cmd) => cmd.option("--idempotency-key <key>", "reuse a key from a previous attempt that never answered");
514
+ idempotent(credentialOpts(strictArgs(connection.command("create"))
515
+ .description("create a connection from a credential you supply")
516
+ .requiredOption("--label <text>", "human label")
517
+ .requiredOption("--connector <kind>", "connector kind (the server defines these)")
518
+ .requiredOption("--auth-kind <kind>", "auth kind (the server defines these)")
519
+ /*
520
+ * Create only — deliberately not on `credentialOpts`, which reconnect
521
+ * shares. Reconnect exists to REPLACE a credential; "replace it with
522
+ * none" is not that operation, and a Connection that needs none has
523
+ * nothing to replace.
524
+ *
525
+ * Commander reads `--no-credential` as the NEGATION of a boolean
526
+ * `credential`, so it arrives as `opts.credential === false` and
527
+ * defaults to `true` — there is no `noCredential` field. That is worth
528
+ * writing down: reading the wrong one silently never fires.
529
+ */
530
+ .option("--no-credential", "send no credential at all — only for an auth kind the server says needs none")
531
+ .addHelpText("after", "\n--no-credential omits the credential from the request entirely. The server " +
532
+ "decides whether that auth kind is allowed to have none, and refuses the " +
533
+ "request if it is not.\n")))
534
+ .option("--namespace <slug>", "namespace slug (default: active login)")
535
+ .option("--json", "emit JSON")
536
+ .action(async (opts) => process.exit(await runConnectionCreate(opts)));
537
+ idempotent(strictArgs(connection.command("rename")))
538
+ .description("change a connection's label")
539
+ .argument("<id>", "connection id (see 'dreamlake connection list')")
540
+ .requiredOption("--label <text>", "the new label")
541
+ .option("--namespace <slug>", "namespace slug (default: active login)")
542
+ .option("--json", "emit JSON")
543
+ .action(async (id, opts) => process.exit(await runConnectionRename(id, opts)));
544
+ strictArgs(connection.command("check"))
545
+ .description("probe a connection; reports status without changing anything")
546
+ .argument("<id>", "connection id")
547
+ .option("--namespace <slug>", "namespace slug (default: active login)")
548
+ .option("--json", "emit JSON")
549
+ .action(async (id, opts) => process.exit(await runConnectionCheck(id, opts)));
550
+ idempotent(credentialOpts(strictArgs(connection.command("reconnect"))
551
+ .description("replace a connection's credential")
552
+ .argument("<id>", "connection id")
553
+ .option("--enable-after-success", "enable the connection if the new credential works")))
554
+ .option("--namespace <slug>", "namespace slug (default: active login)")
555
+ .option("--json", "emit JSON")
556
+ .action(async (id, opts) => process.exit(await runConnectionReconnect(id, opts)));
557
+ for (const action of ["enable", "disable"]) {
558
+ idempotent(strictArgs(connection.command(action)))
559
+ .description(`${action} a connection`)
560
+ .argument("<id>", "connection id")
561
+ .option("--namespace <slug>", "namespace slug (default: active login)")
562
+ .option("--json", "emit JSON")
563
+ .action(async (id, opts) => process.exit(await (action === "enable"
564
+ ? runConnectionEnable(id, opts)
565
+ : runConnectionDisable(id, opts))));
566
+ }
567
+ idempotent(strictArgs(connection.command("delete")))
568
+ .description("delete a connection; refused while a source still uses it")
569
+ .argument("<id>", "connection id")
570
+ .option("--namespace <slug>", "namespace slug (default: active login)")
571
+ .option("--json", "emit JSON")
572
+ .action(async (id, opts) => process.exit(await runConnectionDelete(id, opts)));
573
+ }
@@ -0,0 +1,19 @@
1
+ import type { Command } from "commander";
2
+ interface CreateOpts {
3
+ project?: string;
4
+ episode?: string;
5
+ description?: string;
6
+ tags?: string;
7
+ }
8
+ export declare function runCreateBindr(name: string, opts: CreateOpts): Promise<number>;
9
+ export declare function runCreateDataset(name: string, opts: CreateOpts): Promise<number>;
10
+ interface CreateProjectOpts {
11
+ namespace?: string;
12
+ slug?: string;
13
+ description?: string;
14
+ visibility?: string;
15
+ tags?: string;
16
+ }
17
+ export declare function runCreateProject(name: string, opts: CreateProjectOpts): Promise<number>;
18
+ export declare function registerCreateCommand(program: Command): void;
19
+ export {};