@dreamlake/dreamlake-cli 0.88.0 → 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,65 @@
1
+ import type { Command } from "commander";
2
+ export interface ShareOptions {
3
+ source: string;
4
+ role: string;
5
+ namespace?: string;
6
+ json?: boolean;
7
+ }
8
+ /**
9
+ * Turn the link on, or change its role, and print it once.
10
+ *
11
+ * The token is MINTED the first time and REUSED afterwards. That is a
12
+ * normative requirement, not an optimization: a read→write upgrade that
13
+ * re-minted would silently invalidate every link already handed out, and the
14
+ * person who ran it would have no way to know. The output says so, because a
15
+ * user who expected rotation would otherwise assume the old links died.
16
+ */
17
+ export declare function runSourceShare(opts: ShareOptions): Promise<number>;
18
+ export interface ShareOffOptions {
19
+ source: string;
20
+ forget?: boolean;
21
+ namespace?: string;
22
+ json?: boolean;
23
+ }
24
+ /**
25
+ * Turn the link off for everyone the link admitted, at once.
26
+ *
27
+ * `--forget` does not change what happens NOW — both spellings withdraw
28
+ * link-derived access immediately, and both clear the token, so the URL people
29
+ * hold stops working either way. It changes what happens at RE-ENABLE, and the
30
+ * mechanism is worth stating because it is not the obvious one: a retained
31
+ * admission authorizes on its own (`resolveShareAuthority` requires only that
32
+ * `shareToken` be SET, and never compares it against the admission), so those
33
+ * people come straight back with no link at all. A forgotten one has to redeem
34
+ * a token again — and since re-enabling mints a FRESH one, that means the link
35
+ * the next `source share` prints, not the one they kept. That is the whole
36
+ * difference, and it is the only thing a caller can use to choose, so it is in
37
+ * the help text and in the output.
38
+ */
39
+ export declare function runSourceShareOff(opts: ShareOffOptions): Promise<number>;
40
+ export interface SharesOptions {
41
+ source: string;
42
+ limit?: string;
43
+ cursor?: string;
44
+ namespace?: string;
45
+ json?: boolean;
46
+ }
47
+ /** Who the link admitted, oldest first. */
48
+ export declare function runSourceShares(opts: SharesOptions): Promise<number>;
49
+ export interface SharesRemoveOptions {
50
+ source: string;
51
+ user: string;
52
+ namespace?: string;
53
+ json?: boolean;
54
+ }
55
+ /**
56
+ * Return one person to "has not been admitted".
57
+ *
58
+ * Not a block, not a ban, not a per-person revoke — and the wording here is as
59
+ * load-bearing as the request. The link that person holds re-admits them on
60
+ * their next exchange; durably excluding one person while leaving the link open
61
+ * is not supported at all. `share-off` is the only exclusion, and it excludes
62
+ * everyone.
63
+ */
64
+ export declare function runSourceSharesRemove(opts: SharesRemoveOptions): Promise<number>;
65
+ export declare function registerSourceShareCommands(source: Command): void;
@@ -0,0 +1,530 @@
1
+ // `dreamlake source share | share-off | shares | shares-remove`
2
+ //
3
+ // The share link: one token per Source that lets a signed-in person who is not
4
+ // a member of the owning namespace read — or, at `--role write`, also write the
5
+ // managed layer. Four commands, all ADMIN-only, mirroring the `source editors`
6
+ // family next door because share and Editor are the two PARALLEL admission
7
+ // channels and an operator reaches for them in the same breath.
8
+ //
9
+ // share turn the link on (or change its role) and print it once
10
+ // share-off turn the link off for everyone, at once
11
+ // shares who the link admitted, when they first came in, when last seen
12
+ // shares-remove return one person to "not admitted" (NOT a block)
13
+ //
14
+ // Server endpoints — Source v1 §11.1, all five ADMIN:
15
+ // PUT /namespaces/:ns/sources/:id/share {role} → {shared, role, token}
16
+ // DELETE /namespaces/:ns/sources/:id/share {forget?} → 204
17
+ // GET /namespaces/:ns/sources/:id/share/access → {items, nextCursor, removalIsNotABlock}
18
+ // DELETE /namespaces/:ns/sources/:id/share/access/:userId → 204, idempotent
19
+ //
20
+ // `GET .../share` is deliberately NOT exposed. It is the second endpoint that
21
+ // returns the token, the contract marks it `no-store` for that reason, and a
22
+ // terminal command whose whole output is a live credential invites exactly the
23
+ // re-reading this surface is designed to avoid: `share` already prints the link
24
+ // at the moment the operator asked for one.
25
+ //
26
+ // THREE RULES THIS FILE EXISTS TO KEEP, each of which was a behaviour decision
27
+ // before it was code:
28
+ //
29
+ // 1. The token is printed and then forgotten. It is a bearer credential with
30
+ // no expiry — it lives until an Owner turns the link off — so it is written
31
+ // to no config, no cache, no state file and no log this CLI controls. Not
32
+ // even a "last link" convenience: a file holding it would outlive the
33
+ // terminal scrollback and hand the Source to whoever reads that file.
34
+ //
35
+ // 2. NO `--idempotency-key`, and no revision CAS. Every neighbouring Source
36
+ // mutation takes a key; these four take none, because the server accepts
37
+ // none (§11.1) — sharing bumps neither `settingsRevision` nor
38
+ // `compositionRevision`, so there is nothing to CAS against. Copying the
39
+ // option across "for symmetry" would send a header the closed schema
40
+ // ignores and promise a replay guarantee that does not exist.
41
+ //
42
+ // 3. Removal is NOT a block, and nothing here may call it one. `shares-remove`
43
+ // returns someone to "has not been admitted" and the link they still hold
44
+ // re-admits them on their next use. The server states this on the LISTING
45
+ // (`removalIsNotABlock: true`) precisely so a client labels the control
46
+ // correctly BEFORE anyone clicks it. The only way to exclude one person is
47
+ // `share-off`, which excludes everyone.
48
+ import { requestJson } from "../client.js";
49
+ import { emitJson, fail, ok, renderTable } from "../helpers.js";
50
+ import { webBase } from "../workflow/index.js";
51
+ import { bad, ctx, isObject, nullableString, resolveSource, seg, strictArgs } from "./index.js";
52
+ import { explainWrite } from "./write.js";
53
+ // ─── shapes ───────────────────────────────────────────────────────────────────
54
+ /** The two roles a link can carry. The server's enum, from one list. */
55
+ const SHARE_ROLES = ["read", "write"];
56
+ /**
57
+ * The share surface carries NO `apiVersion` — on any of its responses.
58
+ *
59
+ * Recorded as a guard rather than a comment because §3 of the design note
60
+ * printed one by analogy with the ownership plane and the contract then struck
61
+ * it as a transcription error (§11.1). A client that required it would refuse
62
+ * every compliant answer.
63
+ */
64
+ function assertShareState(res, where) {
65
+ if (!isObject(res))
66
+ bad(`${where} was not an object`);
67
+ if (typeof res.shared !== "boolean")
68
+ bad(`${where} is missing 'shared'`);
69
+ if (!("role" in res) || !(res.role === null || SHARE_ROLES.includes(res.role))) {
70
+ bad(`${where} has no usable 'role'`);
71
+ }
72
+ if (!("token" in res) || !nullableString(res.token))
73
+ bad(`${where} is missing 'token'`);
74
+ return {
75
+ shared: res.shared,
76
+ role: res.role,
77
+ token: res.token,
78
+ };
79
+ }
80
+ function assertAdmission(raw, where) {
81
+ if (!isObject(raw))
82
+ bad(`${where} was not an object`);
83
+ for (const k of ["userId", "firstSeenAt", "lastSeenAt"]) {
84
+ if (typeof raw[k] !== "string" || raw[k] === "")
85
+ bad(`${where} is missing '${k}'`);
86
+ }
87
+ /*
88
+ * Required AND nullable, and the asymmetry with the shared-with-me listing's
89
+ * `owner.displayName` is deliberate rather than an inconsistency: that row
90
+ * names a NAMESPACE and can fall back to its slug, which always exists. This
91
+ * row names a person, there is no slug to fall back to, and `null` is the
92
+ * only honest answer for a user row that is missing or soft-deleted. A
93
+ * fabricated placeholder here would read as someone's actual name.
94
+ */
95
+ if (!("displayName" in raw) || !nullableString(raw.displayName)) {
96
+ bad(`${where} has a 'displayName' that is neither a string nor null`);
97
+ }
98
+ return {
99
+ userId: raw.userId,
100
+ displayName: raw.displayName,
101
+ firstSeenAt: raw.firstSeenAt,
102
+ lastSeenAt: raw.lastSeenAt,
103
+ };
104
+ }
105
+ // ─── the link's address ───────────────────────────────────────────────────────
106
+ /**
107
+ * The URL a recipient opens, built from the namespace slug and the Source name.
108
+ *
109
+ * Not hardcoded: `webBase` is the one place this CLI decides which dashboard
110
+ * origin belongs to a given API origin (`DREAMLAKE_WEB_URL`, then the known
111
+ * staging pair, then stripping a leading `api.`), and every other command that
112
+ * prints a page URL goes through it. A host spelled locally would be wrong on
113
+ * staging and on every self-hosted deployment.
114
+ *
115
+ * `?share=<token>` is the shape the Web landing route reads: it posts the token
116
+ * to the exchange and then replaces the URL with the canonical one. The Source
117
+ * is addressed by NAME because that is what the canonical page is keyed on —
118
+ * which also means renaming the Source breaks a link already handed out, with
119
+ * no alias and no redirect. That is specified behaviour, not a defect.
120
+ */
121
+ function shareUrl(remote, ns, name, token) {
122
+ return (`${webBase(remote)}/${encodeURIComponent(ns)}/sources/${encodeURIComponent(name)}` +
123
+ `?share=${encodeURIComponent(token)}`);
124
+ }
125
+ function checkRole(role) {
126
+ if (SHARE_ROLES.includes(role))
127
+ return true;
128
+ fail(`--role must be one of: ${SHARE_ROLES.join(", ")}`);
129
+ return false;
130
+ }
131
+ /**
132
+ * The pre-read, with its own error handling — same split as the Editor
133
+ * mutations, for the same reason: `resolveSource` is a plain list read, so a
134
+ * failure there means nothing was written and nothing could have been, and
135
+ * letting it fall into a mutation's catch would attribute a read failure to a
136
+ * write that never left the process.
137
+ */
138
+ async function resolveForShare(c, name) {
139
+ try {
140
+ return await resolveSource(c, name);
141
+ }
142
+ catch (err) {
143
+ fail(explainWrite(err));
144
+ return null;
145
+ }
146
+ }
147
+ /**
148
+ * Turn the link on, or change its role, and print it once.
149
+ *
150
+ * The token is MINTED the first time and REUSED afterwards. That is a
151
+ * normative requirement, not an optimization: a read→write upgrade that
152
+ * re-minted would silently invalidate every link already handed out, and the
153
+ * person who ran it would have no way to know. The output says so, because a
154
+ * user who expected rotation would otherwise assume the old links died.
155
+ */
156
+ export async function runSourceShare(opts) {
157
+ if (!checkRole(opts.role))
158
+ return 1;
159
+ const c = await ctx(opts.namespace);
160
+ if (!c)
161
+ return 1;
162
+ const source = await resolveForShare(c, opts.source);
163
+ if (!source)
164
+ return 1;
165
+ try {
166
+ const state = assertShareState(await requestJson(c.remote, `/namespaces/${seg(c.ns)}/sources/${seg(source.id)}/share`, {
167
+ method: "PUT",
168
+ token: c.token,
169
+ json: { role: opts.role },
170
+ }), "the share response");
171
+ /*
172
+ * A successful `PUT` of a role this build sent cannot answer "not shared".
173
+ * `shared: false` is the server's way of saying a holder could not actually
174
+ * get in — it happens for a persisted role the server does not recognize —
175
+ * and printing a link from that state would show an Owner a live
176
+ * invitation that admits nobody.
177
+ */
178
+ if (!state.shared || state.token === null || state.token === "" || state.role === null) {
179
+ bad("the share response says the link was not turned on");
180
+ }
181
+ const url = shareUrl(c.remote, c.ns, source.name, state.token);
182
+ if (opts.json) {
183
+ /*
184
+ * The token is emitted alongside the URL rather than only inside it: the
185
+ * exchange takes it in a request BODY, never on a URL, so a script that
186
+ * admits itself needs the bare value. Both are the same secret, and
187
+ * stdout is the caller's to direct.
188
+ */
189
+ emitJson({ source: source.name, shared: true, role: state.role, url, token: state.token });
190
+ return 0;
191
+ }
192
+ ok(`'${source.name}' is shared — anyone signed in who opens this link can ${state.role}`);
193
+ process.stdout.write(` ${url}\n`);
194
+ /*
195
+ * Said at the moment the link exists, because both facts are invisible
196
+ * afterwards: this CLI keeps no copy to re-read, and a role change does not
197
+ * rotate the token.
198
+ */
199
+ process.stdout.write("\n Nothing here stores it — re-run this command to print the same link again.\n");
200
+ process.stdout.write(` Changing the role later reuses this same token, so links already handed out keep working.\n`);
201
+ process.stdout.write(` Turn it off for everyone: dreamlake source share-off --source ${source.name} --namespace ${c.ns}\n`);
202
+ return 0;
203
+ }
204
+ catch (err) {
205
+ fail(explainWrite(err));
206
+ return 1;
207
+ }
208
+ }
209
+ /**
210
+ * Turn the link off for everyone the link admitted, at once.
211
+ *
212
+ * `--forget` does not change what happens NOW — both spellings withdraw
213
+ * link-derived access immediately, and both clear the token, so the URL people
214
+ * hold stops working either way. It changes what happens at RE-ENABLE, and the
215
+ * mechanism is worth stating because it is not the obvious one: a retained
216
+ * admission authorizes on its own (`resolveShareAuthority` requires only that
217
+ * `shareToken` be SET, and never compares it against the admission), so those
218
+ * people come straight back with no link at all. A forgotten one has to redeem
219
+ * a token again — and since re-enabling mints a FRESH one, that means the link
220
+ * the next `source share` prints, not the one they kept. That is the whole
221
+ * difference, and it is the only thing a caller can use to choose, so it is in
222
+ * the help text and in the output.
223
+ */
224
+ export async function runSourceShareOff(opts) {
225
+ const c = await ctx(opts.namespace);
226
+ if (!c)
227
+ return 1;
228
+ const source = await resolveForShare(c, opts.source);
229
+ if (!source)
230
+ return 1;
231
+ const forget = opts.forget === true;
232
+ try {
233
+ /*
234
+ * The flag travels in the BODY. The route declares a CLOSED and empty
235
+ * querystring on purpose: `forget` is the one field whose silent loss
236
+ * changes what happens next, so `?forget=true` is refused rather than
237
+ * quietly served the other behaviour. Sent explicitly in both spellings —
238
+ * `{forget: false}` rather than no body — so a request log says which of
239
+ * the two a caller chose instead of leaving it to be inferred from silence.
240
+ */
241
+ await requestJson(c.remote, `/namespaces/${seg(c.ns)}/sources/${seg(source.id)}/share`, {
242
+ method: "DELETE",
243
+ token: c.token,
244
+ json: { forget },
245
+ });
246
+ if (opts.json) {
247
+ emitJson({ source: source.name, shared: false, forgotten: forget });
248
+ return 0;
249
+ }
250
+ /*
251
+ * "is off", not "was turned off". The call is idempotent — a Source that
252
+ * had no link answers 204 too — so a retry after a lost response states
253
+ * where things stand rather than claiming to have found something.
254
+ */
255
+ ok(`the share link on '${source.name}' is off — it admits no one`);
256
+ process.stdout.write(forget
257
+ ? " Admissions forgotten: turning the link back on mints a NEW token — the link everyone\n" +
258
+ " holds is dead, and you have to hand out the one the next 'source share' prints.\n"
259
+ : " Admissions kept: turning the link back on lets everyone already admitted straight\n" +
260
+ " back in with no link at all — their admission is what authorizes them.\n" +
261
+ " Pass --forget to delete the records instead.\n");
262
+ /*
263
+ * Bounded, not instant — mentioned here because this is the one command
264
+ * whose name invites the opposite reading. The per-connector table lives in
265
+ * `--help`, not in every invocation.
266
+ */
267
+ process.stdout.write(" New access stops now. A read or write URL already issued keeps working until it expires\n" +
268
+ " (up to 1 hour for a write) — `dreamlake source share-off --help` has the per-connector bounds.\n");
269
+ return 0;
270
+ }
271
+ catch (err) {
272
+ fail(explainWrite(err));
273
+ return 1;
274
+ }
275
+ }
276
+ /** Who the link admitted, oldest first. */
277
+ export async function runSourceShares(opts) {
278
+ let limit;
279
+ if (opts.limit !== undefined) {
280
+ limit = Number(opts.limit);
281
+ if (!Number.isSafeInteger(limit) || limit < 1) {
282
+ fail("--limit must be a positive integer");
283
+ return 1;
284
+ }
285
+ /*
286
+ * No local ceiling, exactly as `references` has none: §11.1 CLAMPS an
287
+ * over-large limit rather than rejecting it, so a caller never discovers
288
+ * the maximum by failing. A cap invented here would put that failure back.
289
+ */
290
+ }
291
+ const c = await ctx(opts.namespace);
292
+ if (!c)
293
+ return 1;
294
+ try {
295
+ const source = await resolveSource(c, opts.source);
296
+ const res = await requestJson(c.remote, `/namespaces/${seg(c.ns)}/sources/${seg(source.id)}/share/access`, { token: c.token, query: { limit, cursor: opts.cursor } });
297
+ if (!isObject(res) || !Array.isArray(res.items))
298
+ bad("the admission list is missing 'items'");
299
+ if (!("nextCursor" in res) || !nullableString(res.nextCursor)) {
300
+ bad("the admission list is missing 'nextCursor'");
301
+ }
302
+ /*
303
+ * Required, and required to be `true`. It is the server's own statement
304
+ * that removal is not a block, and the contract puts it on THIS response —
305
+ * not on the DELETE — because a client has to label the control before
306
+ * anyone clicks it. A server that does not say it is not a server whose
307
+ * removal semantics this client can describe, so it is refused rather than
308
+ * narrated from memory.
309
+ */
310
+ if (res.removalIsNotABlock !== true) {
311
+ bad("the admission list is missing 'removalIsNotABlock'");
312
+ }
313
+ const items = res.items.map((x, i) => assertAdmission(x, `admission ${i + 1}`));
314
+ const nextCursor = res.nextCursor;
315
+ if (opts.json) {
316
+ emitJson({ items, nextCursor, removalIsNotABlock: true });
317
+ return 0;
318
+ }
319
+ if (items.length === 0) {
320
+ if (nextCursor !== null) {
321
+ process.stdout.write(" Nothing on this page — but this is not the last one.\n");
322
+ }
323
+ else {
324
+ /*
325
+ * An empty list is not "the link is off" and not "nobody can read
326
+ * this" — members reach the Source through their membership and are
327
+ * counted nowhere here. It is NOT, however, a list of non-members: the
328
+ * exchange records an admission for whoever redeems a link without
329
+ * checking membership first, so a member who clicks one gets a row like
330
+ * anybody else.
331
+ */
332
+ process.stdout.write(`The share link on '${source.name}' has admitted no one yet.\n`);
333
+ process.stdout.write(" (An empty list does not mean the link is off, and members can read the source without it.)\n");
334
+ return 0;
335
+ }
336
+ }
337
+ else {
338
+ process.stdout.write(renderTable(items.map((x) => ({
339
+ user: x.userId,
340
+ // A missing or soft-deleted user row has no name, and no slug to
341
+ // fall back to. "-" says that; a made-up name would not.
342
+ name: x.displayName ?? "-",
343
+ "first seen": x.firstSeenAt,
344
+ "last seen": x.lastSeenAt,
345
+ })), ["user", "name", "first seen", "last seen"]));
346
+ process.stdout.write(`\n ${items.length} admission(s) on this page\n`);
347
+ /*
348
+ * The server said `removalIsNotABlock`, so this says it too — before the
349
+ * reader goes looking for a way to remove one of these rows.
350
+ */
351
+ process.stdout.write(" Removing one of these is not a block: the link they still hold re-admits them next time\n" +
352
+ " they open it. To exclude someone, turn the link off for everyone with 'source share-off'.\n");
353
+ }
354
+ if (nextCursor !== null) {
355
+ process.stdout.write(`\n More to come. Next page:\n dreamlake source shares --source ${source.name}` +
356
+ ` --namespace ${c.ns} --cursor ${nextCursor}\n`);
357
+ }
358
+ return 0;
359
+ }
360
+ catch (err) {
361
+ fail(explainWrite(err));
362
+ return 1;
363
+ }
364
+ }
365
+ /**
366
+ * Return one person to "has not been admitted".
367
+ *
368
+ * Not a block, not a ban, not a per-person revoke — and the wording here is as
369
+ * load-bearing as the request. The link that person holds re-admits them on
370
+ * their next exchange; durably excluding one person while leaving the link open
371
+ * is not supported at all. `share-off` is the only exclusion, and it excludes
372
+ * everyone.
373
+ */
374
+ export async function runSourceSharesRemove(opts) {
375
+ if (opts.user === undefined || opts.user === "") {
376
+ fail("--user <id> is required (the user id from 'dreamlake source shares')");
377
+ return 1;
378
+ }
379
+ const c = await ctx(opts.namespace);
380
+ if (!c)
381
+ return 1;
382
+ const source = await resolveForShare(c, opts.source);
383
+ if (!source)
384
+ return 1;
385
+ try {
386
+ await requestJson(c.remote, `/namespaces/${seg(c.ns)}/sources/${seg(source.id)}/share/access/${seg(opts.user)}`, { method: "DELETE", token: c.token });
387
+ if (opts.json) {
388
+ emitJson({ source: source.name, userId: opts.user, admitted: false });
389
+ return 0;
390
+ }
391
+ /*
392
+ * "is no longer admitted", not "was removed". Removal is idempotent — an
393
+ * admission that was not there answers 204 as well — so a retry after a
394
+ * lost response must not read as a failure, and this sentence is true in
395
+ * both cases.
396
+ */
397
+ ok(`${opts.user} is no longer admitted to '${source.name}'`);
398
+ process.stdout.write(" This is not a block. The link they hold re-admits them the next time they open it;\n" +
399
+ ` to exclude them, turn the link off for everyone: dreamlake source share-off --source ${source.name}\n`);
400
+ return 0;
401
+ }
402
+ catch (err) {
403
+ fail(explainWrite(err));
404
+ return 1;
405
+ }
406
+ }
407
+ // ─── registration ─────────────────────────────────────────────────────────────
408
+ /**
409
+ * The per-connector revocation bounds, in `--help` rather than in every
410
+ * invocation of `share-off`.
411
+ *
412
+ * Stated because a user who reads "off" as "instant" is misled: reads and
413
+ * writes are served by short-lived URLs the client uses directly against
414
+ * storage, and turning the link off cannot recall one already minted. Hugging
415
+ * Face has no bound AND needs none — v1 serves only public, ungated files and
416
+ * hands back the Hub's own unsigned URL, so those bytes are reachable without
417
+ * DreamLake and a revocation would be taking away nothing.
418
+ */
419
+ const REVOCATION_BOUNDS = `
420
+ Turning the link off stops NEW access immediately. A capability already issued
421
+ keeps working until it expires, and storage does not re-check expiry
422
+ mid-transfer, so a download that started inside the window runs to completion:
423
+
424
+ managed-layer read 5 minutes
425
+ S3 read 5 minutes
426
+ any write 1 hour
427
+ Dropbox read 4 hours (the duration Dropbox documents; it returns no
428
+ per-link expiry, so we cannot observe it)
429
+ Hugging Face read no bound, and none is needed — v1 serves only public,
430
+ ungated files and returns the Hub's own unsigned URL
431
+
432
+ Revocation is bounded, not instant, and it is not a way to recall data: anyone
433
+ who had read access could already have copied everything.`;
434
+ export function registerSourceShareCommands(source) {
435
+ /*
436
+ * `--source <name>`, REQUIRED, and no bare-argument alternative — the
437
+ * spelling every sibling that addresses an existing Source uses (`editors`,
438
+ * `editor-add`, `editor-remove`, `stat`, `disable`, `delete-source`). A
439
+ * family where `source share my-s3` worked but `source editor-add my-s3` did
440
+ * not is a papercut a user hits on their second command, and they hit it on
441
+ * whichever one is inconsistent. If bare arguments are worth having here,
442
+ * they are worth having family-wide, which is a different change.
443
+ *
444
+ * No `--idempotency-key` anywhere below. The server accepts none on this
445
+ * surface and there is no revision to CAS against; the option exists two
446
+ * commands away on `editor-add` and must not be copied here.
447
+ */
448
+ const addressed = (cmd) => cmd
449
+ .requiredOption("--source <name>", "source name (see 'dreamlake source list')")
450
+ .option("--namespace <slug>", "namespace slug (default: active login)")
451
+ .option("--json", "emit JSON");
452
+ addressed(strictArgs(source.command("share")))
453
+ .description("turn on a source's share link and print it (Owner/Admin only)")
454
+ .requiredOption("--role <role>", `what the link grants: ${SHARE_ROLES.join(" or ")}`)
455
+ .addHelpText("after", `
456
+ Anyone signed in who opens the link can read the whole source — or also write
457
+ its managed layer at --role write. The external layer stays read-only for
458
+ everyone, including the owner. Members of the namespace are unaffected: a share
459
+ is a second, independent way in, and whoever has both gets the stronger of them.
460
+
461
+ Nothing in this CLI stores the link: the token is a bearer credential with no
462
+ expiry, so it is kept out of every config, cache and log here. Re-running this
463
+ command is how you get it back — on an already-shared source the token is
464
+ REUSED, not rotated, so a second run reprints the SAME link and changing the
465
+ role from read to write does not invalidate links you already handed out. This
466
+ command is the only way to recover it: no other response carries the token.
467
+
468
+ A retried 'share' whose first answer was lost can re-enable a link that was
469
+ turned off in between. That window is accepted and documented rather than
470
+ engineered away — there is no idempotency key on this surface.
471
+ `)
472
+ .action(async (opts) => process.exit(await runSourceShare(opts)));
473
+ addressed(strictArgs(source.command("share-off")))
474
+ .description("turn off a source's share link for everyone (Owner/Admin only)")
475
+ .option("--forget", "also delete the admission records (changes what RE-ENABLING requires)")
476
+ .addHelpText("after", `
477
+ Withdraws link-derived access from everyone the link admitted, at once. Idempotent:
478
+ a source with no link answers the same way.
479
+
480
+ --forget changes nothing about turning the link OFF. It changes what happens if
481
+ you turn it back ON:
482
+
483
+ without --forget the admission records are kept, and re-enabling lets
484
+ everyone who was already admitted straight back in with no
485
+ link at all — the admission is what authorizes them, so
486
+ nothing has to be redistributed
487
+ with --forget the records are deleted, so everyone has to redeem a link
488
+ again — and turning sharing back on mints a FRESH token,
489
+ so the link they still hold is dead and you must hand out
490
+ the one the next 'source share' prints
491
+
492
+ Turning the link off clears the token either way, so the old URL stops working
493
+ in both spellings. The difference is whether anyone needs a URL at all to come
494
+ back.
495
+ ${REVOCATION_BOUNDS}
496
+ `)
497
+ .action(async (opts) => process.exit(await runSourceShareOff(opts)));
498
+ addressed(strictArgs(source.command("shares")))
499
+ .description("who the share link admitted (Owner/Admin only)")
500
+ .option("--limit <n>", "page size (the server clamps an over-large value)")
501
+ .option("--cursor <cursor>", "continue from the cursor printed by the previous page")
502
+ .addHelpText("after", `
503
+ Oldest first, by when each person first came in. A new admission lands at the
504
+ END, so paging is stable while you walk it.
505
+
506
+ This is a list of who redeemed the link, not a list of outsiders. Redeeming
507
+ records an admission for whoever presented the token, members included, so a
508
+ member or an Editor who clicks a link appears here like anybody else — and the
509
+ row grants them nothing they did not already have, because membership and the
510
+ link are independent and the stronger one wins.
511
+
512
+ An empty list therefore does not mean nobody can read the source — members
513
+ reach it through their membership — and it does not mean the link is off.
514
+ `)
515
+ .action(async (opts) => process.exit(await runSourceShares(opts)));
516
+ addressed(strictArgs(source.command("shares-remove")))
517
+ .description("return one admitted person to 'not admitted' (Owner/Admin only)")
518
+ .requiredOption("--user <id>", "user id from 'dreamlake source shares'")
519
+ .addHelpText("after", `
520
+ NOT a block. This clears one admission record; the link that person still holds
521
+ re-admits them the next time they open it. Keeping the link open while durably
522
+ excluding one person is not supported — the link's three states (off, read,
523
+ write) are the whole model. To exclude someone, run 'source share-off', which
524
+ excludes everyone.
525
+
526
+ Idempotent: removing an admission that is not there succeeds, so retrying after
527
+ a lost response is safe.
528
+ `)
529
+ .action(async (opts) => process.exit(await runSourceSharesRemove(opts)));
530
+ }
@@ -0,0 +1,62 @@
1
+ /**
2
+ * Uploading into a Source's managed layer.
3
+ *
4
+ * Contract: api-contract §9 and RFC 0003. The CLI authorizes a batch, then PUTs
5
+ * the bytes straight at storage — the payload never passes through the server,
6
+ * and there is no finalize call.
7
+ *
8
+ * The transfer executor itself — streamed single-puts, positioned multipart
9
+ * reads, Complete via the XML body, whole-batch abandonment on failure — lives
10
+ * in ../compat/presignedTransfer.ts, shared with `dreamlake library push`,
11
+ * whose server answers the same transfer shape. What stays HERE is §9's own
12
+ * envelope: the canonicalPath computation, the positional binding of answer to
13
+ * request, the idempotency key, and the limits.
14
+ *
15
+ * The hash handshake could NOT be carried over from BSS: it took a
16
+ * `sha256[:16]` with its init call and checked it. §9 has no checksum field,
17
+ * and nothing here infers one — an ETag is an opaque token, passed to Complete
18
+ * and never interpreted.
19
+ */
20
+ import type { Command } from "commander";
21
+ import { type PresignedTransfer } from "../compat/presignedTransfer.js";
22
+ export { xmlRootElement } from "../compat/presignedTransfer.js";
23
+ /** §9's limits, enforced here so a doomed batch is refused before it is sent. */
24
+ export declare const MAX_FILES = 1000;
25
+ export declare const MAX_TOTAL_BYTES: number;
26
+ interface AuthorizedFile {
27
+ relativePath: string;
28
+ canonicalPath: string;
29
+ size: number;
30
+ transfer: PresignedTransfer;
31
+ }
32
+ interface Authorization {
33
+ mode: string;
34
+ expiresAt: string;
35
+ files: AuthorizedFile[];
36
+ }
37
+ /** The canonical path an object occupies. Joins, and repairs nothing. */
38
+ export declare function canonicalPath(targetPrefix: string, relativePath: string): string;
39
+ /**
40
+ * Check the authorization against the request it answers, before a byte moves.
41
+ *
42
+ * The envelope checks are §9's; each file's transfer plan is handed to the
43
+ * shared validator, which refuses gaps, duplicates and short part plans — the
44
+ * failures where every PUT succeeds and the object exists holding bytes nobody
45
+ * checked.
46
+ */
47
+ export declare function assertAuthorization(res: unknown, request: {
48
+ targetPrefix: string;
49
+ files: Array<{
50
+ relativePath: string;
51
+ size: number;
52
+ }>;
53
+ }): Authorization;
54
+ export declare function runSourceUpload(localPath: string, opts: {
55
+ source: string;
56
+ to?: string;
57
+ namespace?: string;
58
+ recursive?: boolean;
59
+ idempotencyKey?: string;
60
+ json?: boolean;
61
+ }): Promise<number>;
62
+ export declare function registerSourceUploadCommand(source: Command): void;