@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,554 @@
1
+ /**
2
+ * `dreamlake notes files …` — list, upload, download, move, copy, trash.
3
+ *
4
+ * Bytes are never decoded on this path. Upload reads the local file as a
5
+ * Buffer and sends it raw; download writes the response body straight out.
6
+ * Only `--text` touches a string, and the server refuses that for anything not
7
+ * text-typed rather than round-tripping it through UTF-8.
8
+ *
9
+ * Downloads refuse to replace a local file unless asked. Everything else here
10
+ * goes to a recoverable trash; something overwritten on the caller's disk does
11
+ * not come back.
12
+ */
13
+ import { createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, } from "node:fs";
14
+ import { pipeline } from "node:stream/promises";
15
+ import { Readable } from "node:stream";
16
+ import path from "node:path";
17
+ import { ctx, report, resolveNote, seg } from "./index.js";
18
+ import { emitJson, fail } from "../helpers.js";
19
+ import { requestJson, requestRaw } from "../client.js";
20
+ /** Exit code for "the file or path was wrong", distinct from a transport failure. */
21
+ export const EXIT_NO_FILE = 6;
22
+ /** Exit code for a refused overwrite — a script can branch on it and retry. */
23
+ export const EXIT_EXISTS = 7;
24
+ function filesBase(c, id) {
25
+ return `/namespaces/${seg(c.ns)}/notes/${seg(id)}/files`;
26
+ }
27
+ /** Resolve the note every file command needs. */
28
+ async function target(opts) {
29
+ if (!opts.note) {
30
+ fail("say which note: --note <id-or-slug>");
31
+ return null;
32
+ }
33
+ const c = await ctx(opts);
34
+ if (!c)
35
+ return null;
36
+ const id = await resolveNote(c, opts.note);
37
+ if (!id)
38
+ return null;
39
+ return { c, id };
40
+ }
41
+ /**
42
+ * Map a server refusal onto an exit code a script can branch on.
43
+ *
44
+ * The server's own sentence is preferred over the transport's. HttpError's
45
+ * `message` is about the status; the reason lives in the JSON body, and it is
46
+ * the reason that tells a person what to do — "a.zip is application/zip, which
47
+ * has no rendered form" against "Request failed with status 400".
48
+ */
49
+ function reportFile(err, recovery) {
50
+ if (recovery) {
51
+ let operationId = recovery.operationId;
52
+ try {
53
+ operationId ??= operationIdOf(JSON.parse(err.body ?? "").operationId);
54
+ }
55
+ catch { }
56
+ if (operationId)
57
+ process.stderr.write(`operation ${operationId} — inspect with notes files status ${operationId} --note ${recovery.note}${recovery.namespace ? ` --namespace ${JSON.stringify(recovery.namespace)}` : ""}\n`);
58
+ process.stderr.write("Do not resend attachment bytes after an uncertain result; inspect the original operation first.\n");
59
+ }
60
+ const status = err?.status;
61
+ const body = err?.body;
62
+ let detail = err?.message ?? String(err);
63
+ if (body) {
64
+ try {
65
+ const parsed = JSON.parse(body);
66
+ if (parsed.message)
67
+ detail = parsed.message;
68
+ }
69
+ catch {
70
+ // Not JSON; the transport message is all there is.
71
+ }
72
+ }
73
+ if (status === 503 && recovery) {
74
+ // Preserve the existing busy exit code without the Notes body helper
75
+ // falsely diagnosing RTC or suggesting that attachment bytes be resent.
76
+ fail(detail);
77
+ return 4;
78
+ }
79
+ if (status === 409) {
80
+ fail(detail);
81
+ return EXIT_EXISTS;
82
+ }
83
+ if (status === 404 || status === 400 || status === 403) {
84
+ fail(detail);
85
+ return EXIT_NO_FILE;
86
+ }
87
+ return report(err);
88
+ }
89
+ function operationIdOf(value) {
90
+ return typeof value === "string" && /^[a-f0-9]{24}$/i.test(value) ? value : undefined;
91
+ }
92
+ function keyValid(key) {
93
+ // HTTP field values cannot represent arbitrary Unicode with fetch. Never
94
+ // trim, normalize or silently replace the user's operation identity.
95
+ if (key !== undefined && (!/^[\x20-\x7e]{1,256}$/.test(key) || key.trim() !== key)) {
96
+ fail("--idempotency-key must be 1–256 printable ASCII bytes without surrounding spaces");
97
+ return false;
98
+ }
99
+ return true;
100
+ }
101
+ function requireFileResult(row) {
102
+ if (!row || typeof row !== "object" || typeof row.id !== "string" || typeof row.path !== "string") {
103
+ throw new Error("Attachment response is unreadable; retain the original operation before recovery");
104
+ }
105
+ }
106
+ function showOperation(operationId) {
107
+ if (operationId)
108
+ process.stderr.write(`operation ${operationId}\n`);
109
+ }
110
+ /** Human-readable size, so a listing is scannable. */
111
+ function human(bytes) {
112
+ if (bytes < 1024)
113
+ return `${bytes}B`;
114
+ const units = ["K", "M", "G"];
115
+ let n = bytes / 1024;
116
+ let i = 0;
117
+ while (n >= 1024 && i < units.length - 1) {
118
+ n /= 1024;
119
+ i++;
120
+ }
121
+ return `${n < 10 ? n.toFixed(1) : Math.round(n)}${units[i]}`;
122
+ }
123
+ // ── list ─────────────────────────────────────────────────────────────────────
124
+ export async function runFilesList(glob, opts) {
125
+ const t = await target(opts);
126
+ if (!t)
127
+ return 1;
128
+ try {
129
+ const qs = new URLSearchParams();
130
+ if (glob)
131
+ qs.set("glob", glob);
132
+ if (opts.trashed)
133
+ qs.set("trashed", "true");
134
+ if (opts.contentType)
135
+ qs.set("contentType", opts.contentType);
136
+ if (opts.limit)
137
+ qs.set("limit", opts.limit);
138
+ if (opts.offset)
139
+ qs.set("offset", opts.offset);
140
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}${qs.toString() ? `?${qs}` : ""}`, { token: t.c.token });
141
+ if (opts.json)
142
+ return emitJson(res), 0;
143
+ if (!res.files.length) {
144
+ process.stderr.write(opts.trashed ? "the trash is empty\n" : "no files\n");
145
+ return 0;
146
+ }
147
+ // Said when a page is not the whole set, on stderr so a piped listing is
148
+ // still only files. A caller that took a truncated list for everything
149
+ // would conclude a file is not there.
150
+ const shown = Number(opts.offset ?? 0) + res.files.length;
151
+ if (shown < res.total) {
152
+ process.stderr.write(`showing ${res.files.length} of ${res.total} — pass --offset ${shown} for the rest\n`);
153
+ }
154
+ const width = Math.max(...res.files.map((f) => f.path.length));
155
+ for (const f of res.files) {
156
+ // The id is printed because every other command takes one, and the
157
+ // preview kind because it is what decides whether a file can be shown
158
+ // at all — neither is derivable from the path.
159
+ process.stdout.write(`${f.path.padEnd(width)} ${human(f.sizeBytes).padStart(6)} ${f.contentType.padEnd(24)}` +
160
+ ` ${f.previewKind ?? "-"} ${f.id}\n`);
161
+ }
162
+ return 0;
163
+ }
164
+ catch (e) {
165
+ return reportFile(e);
166
+ }
167
+ }
168
+ // ── upload ───────────────────────────────────────────────────────────────────
169
+ export async function runFilesUpload(localPath, opts) {
170
+ const t = await target(opts);
171
+ if (!t)
172
+ return 1;
173
+ if (!existsSync(localPath)) {
174
+ fail(`no such file: ${localPath}`);
175
+ return EXIT_NO_FILE;
176
+ }
177
+ try {
178
+ // Streamed from disk, not read into memory. A large attachment should
179
+ // cost a buffer rather than its own size in resident memory, and a file
180
+ // bigger than the heap cannot be read at all.
181
+ //
182
+ // Never through a string on the way: that would corrupt every upload that
183
+ // is not valid UTF-8, silently.
184
+ // The two runtimes disagree about how a streamed body is sent. Node's
185
+ // fetch needs an explicit Content-Length (without one it falls back to
186
+ // chunked, which some proxies reject on a PUT). Bun's fetch *hangs* on a
187
+ // stream paired with one, over HTTP/2 — the request is never sent and the
188
+ // upload dies on the timeout. 0.23.0's fix was Bun.file(), a streamed
189
+ // body Bun does handle, which leaves an explicit Content-Type alone and
190
+ // still does not read the file into memory.
191
+ //
192
+ // This shipped broken in 0.23.0 because the published CLI is a compiled
193
+ // Bun binary while the npm package and the test suite run on Node, and
194
+ // api.dreamlake.ai is the HTTP/2 endpoint no local server imitates — so
195
+ // every check was green and every real upload timed out.
196
+ //
197
+ // The BunFile itself must not be the body. Observed on Bun 1.3.14, Linux,
198
+ // compiled standalone binary: a PUT carrying one crashes the runtime
199
+ // (SIGSEGV, varying address) once the response is in, when a GET on the
200
+ // same host preceded it — the shape the upload path takes, since resolving
201
+ // the note comes first. Whether every upload or another runtime, platform
202
+ // or build mode hits it was not established. `.stream()` reads the same
203
+ // file lazily, without loading it into memory, and did not crash.
204
+ // This code sets no Content-Length under Bun, unchanged from 0.24.5.
205
+ // Whether the HTTP/2 hang above can recur is a separate protocol
206
+ // question, not validated by this change.
207
+ const bun = globalThis.Bun;
208
+ const data = bun ? bun.file(localPath).stream() : createReadStream(localPath);
209
+ const remote = opts.path ?? path.basename(localPath);
210
+ const qs = new URLSearchParams({ path: remote });
211
+ if (opts.contentType)
212
+ qs.set("contentType", opts.contentType);
213
+ if (opts.overwrite)
214
+ qs.set("overwrite", "true");
215
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/content?${qs}`, {
216
+ method: "PUT",
217
+ token: t.c.token,
218
+ body: data,
219
+ headers: {
220
+ "Content-Type": opts.contentType ?? "application/octet-stream",
221
+ ...(bun ? {} : { "Content-Length": String(statSync(localPath).size) }),
222
+ },
223
+ });
224
+ if (opts.json)
225
+ return emitJson(res), 0;
226
+ process.stdout.write(`✓ ${res.path} (${human(res.sizeBytes)}, ${res.contentType})\n id ${res.id}\n`);
227
+ return 0;
228
+ }
229
+ catch (e) {
230
+ return reportFile(e);
231
+ }
232
+ }
233
+ // ── download ─────────────────────────────────────────────────────────────────
234
+ export async function runFilesDownload(ref, opts) {
235
+ const t = await target(opts);
236
+ if (!t)
237
+ return 1;
238
+ try {
239
+ const row = await resolveFile(t.c, t.id, ref);
240
+ if (!row)
241
+ return EXIT_NO_FILE;
242
+ // Destination decided BEFORE the transfer: refusing an overwrite after
243
+ // downloading the whole file wastes the transfer, and refusing it after
244
+ // opening the file for writing has already truncated it.
245
+ let dest = opts.output;
246
+ if (dest && dest !== "-") {
247
+ if (existsSync(dest) && statSync(dest).isDirectory()) {
248
+ dest = path.join(dest, row.path.split("/").pop());
249
+ }
250
+ if (existsSync(dest) && !opts.overwrite) {
251
+ // The one thing here DreamLake cannot undo.
252
+ fail(`${dest} already exists; pass --overwrite to replace it`);
253
+ return EXIT_EXISTS;
254
+ }
255
+ }
256
+ const res = await requestRaw(`${t.c.remote}${filesBase(t.c, t.id)}/${seg(row.id)}/content?redirect=false`, { token: t.c.token });
257
+ const body = res.body ? Readable.fromWeb(res.body) : Readable.from([]);
258
+ if (!dest || dest === "-") {
259
+ // To stdout, so it can be piped. Binary is fine; decoding it is not.
260
+ //
261
+ // `{end: false}` matters: pipeline closes its destination when the
262
+ // source finishes, and closing process.stdout silences everything the
263
+ // process prints afterwards — including, in a test runner sharing the
264
+ // process, every other test's output.
265
+ await pipeline(body, process.stdout, { end: false });
266
+ return 0;
267
+ }
268
+ mkdirSync(path.dirname(path.resolve(dest)), { recursive: true });
269
+ // Written beside the target and moved into place, so an interrupted
270
+ // download leaves the destination untouched rather than half a file that
271
+ // looks complete.
272
+ const partial = `${dest}.part`;
273
+ try {
274
+ await pipeline(body, createWriteStream(partial));
275
+ renameSync(partial, dest);
276
+ }
277
+ catch (e) {
278
+ rmSync(partial, { force: true });
279
+ throw e;
280
+ }
281
+ process.stderr.write(`✓ wrote ${dest} (${human(statSync(dest).size)})\n`);
282
+ return 0;
283
+ }
284
+ catch (e) {
285
+ return reportFile(e);
286
+ }
287
+ }
288
+ // ── read as text ─────────────────────────────────────────────────────────────
289
+ export async function runFilesCat(ref, opts) {
290
+ const t = await target(opts);
291
+ if (!t)
292
+ return 1;
293
+ try {
294
+ const row = await resolveFile(t.c, t.id, ref);
295
+ if (!row)
296
+ return EXIT_NO_FILE;
297
+ if (!row.text) {
298
+ // Refused here rather than at the server, so the reason names the local
299
+ // alternative instead of an HTTP status.
300
+ fail(`${row.path} is ${row.contentType}; printing it as text would corrupt it — ` +
301
+ "use 'notes files download' instead");
302
+ return EXIT_NO_FILE;
303
+ }
304
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}/text`, { token: t.c.token });
305
+ if (opts.json)
306
+ return emitJson(res), 0;
307
+ process.stdout.write(res.text);
308
+ return 0;
309
+ }
310
+ catch (e) {
311
+ return reportFile(e);
312
+ }
313
+ }
314
+ // ── write text ───────────────────────────────────────────────────────────────
315
+ export async function runFilesWrite(remotePath, opts) {
316
+ if (!keyValid(opts.idempotencyKey))
317
+ return 1;
318
+ const t = await target(opts);
319
+ if (!t)
320
+ return 1;
321
+ const text = opts.text !== undefined
322
+ ? opts.text
323
+ : opts.file
324
+ ? readFileSync(opts.file, "utf-8")
325
+ : undefined;
326
+ if (text === undefined) {
327
+ fail("say what to write: --text or --file");
328
+ return 1;
329
+ }
330
+ let operationId;
331
+ try {
332
+ const res = await requestJson(t.c.remote, filesBase(t.c, t.id), {
333
+ method: "POST",
334
+ token: t.c.token,
335
+ json: {
336
+ path: remotePath,
337
+ text,
338
+ overwrite: Boolean(opts.overwrite),
339
+ ...(opts.contentType ? { contentType: opts.contentType } : {}),
340
+ },
341
+ headers: { ...(opts.ifMatch ? { "If-Match": opts.ifMatch } : {}),
342
+ ...(opts.idempotencyKey !== undefined ? { "Idempotency-Key": opts.idempotencyKey } : {}) },
343
+ redirect: "manual",
344
+ onHeaders: headers => { operationId = operationIdOf(headers.get("Note-File-Operation-Id")); },
345
+ });
346
+ requireFileResult(res);
347
+ if (opts.json)
348
+ return emitJson({ ...res, ...(operationId ? { operationId } : {}) }), 0;
349
+ showOperation(operationId);
350
+ process.stdout.write(`✓ ${res.path} (${human(res.sizeBytes)})\n etag ${res.etag}\n`);
351
+ return 0;
352
+ }
353
+ catch (e) {
354
+ return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
355
+ }
356
+ }
357
+ // ── move / copy ──────────────────────────────────────────────────────────────
358
+ export async function runFilesMove(ref, to, opts) {
359
+ const t = await target(opts);
360
+ if (!t)
361
+ return 1;
362
+ try {
363
+ const row = await resolveFile(t.c, t.id, ref);
364
+ if (!row)
365
+ return EXIT_NO_FILE;
366
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}`, {
367
+ method: "PATCH",
368
+ token: t.c.token,
369
+ json: { path: to, overwrite: Boolean(opts.overwrite) },
370
+ headers: opts.ifMatch ? { "If-Match": opts.ifMatch } : {},
371
+ });
372
+ if (opts.json)
373
+ return emitJson(res), 0;
374
+ process.stdout.write(`✓ ${row.path} -> ${res.path}\n`);
375
+ return 0;
376
+ }
377
+ catch (e) {
378
+ return reportFile(e);
379
+ }
380
+ }
381
+ export async function runFilesCopy(ref, to, opts) {
382
+ if (!keyValid(opts.idempotencyKey))
383
+ return 1;
384
+ const t = await target(opts);
385
+ if (!t)
386
+ return 1;
387
+ let operationId;
388
+ try {
389
+ const row = await resolveFile(t.c, t.id, ref);
390
+ if (!row)
391
+ return EXIT_NO_FILE;
392
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}/copy`, {
393
+ method: "POST",
394
+ token: t.c.token,
395
+ json: { path: to, overwrite: Boolean(opts.overwrite) },
396
+ headers: opts.idempotencyKey !== undefined ? { "Idempotency-Key": opts.idempotencyKey } : {},
397
+ redirect: "manual",
398
+ onHeaders: headers => { operationId = operationIdOf(headers.get("Note-File-Operation-Id")); },
399
+ });
400
+ requireFileResult(res);
401
+ if (opts.json)
402
+ return emitJson({ ...res, ...(operationId ? { operationId } : {}) }), 0;
403
+ showOperation(operationId);
404
+ process.stdout.write(`✓ copied to ${res.path}\n id ${res.id}\n`);
405
+ return 0;
406
+ }
407
+ catch (e) {
408
+ return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
409
+ }
410
+ }
411
+ // ── publication recovery ────────────────────────────────────────────────────
412
+ export async function runFilesOperation(action, operationId, opts) {
413
+ if (!operationIdOf(operationId)) {
414
+ fail("operation must be a 24-character hexadecimal ID");
415
+ return EXIT_NO_FILE;
416
+ }
417
+ const t = await target(opts);
418
+ if (!t)
419
+ return 1;
420
+ try {
421
+ const suffix = action === "status" ? "" : action === "cancel" ? "/abort" : "/reconcile";
422
+ const result = await requestJson(t.c.remote, `${filesBase(t.c, t.id).slice(0, -6)}/file-publications/${seg(operationId)}${suffix}`, { method: action === "status" ? "GET" : "POST", token: t.c.token, redirect: "manual" });
423
+ if (!result || !operationIdOf(result.operationId) || result.operationId.toLowerCase() !== operationId.toLowerCase() ||
424
+ !["admitted", "write-started", "published", "aborted-before-write"].includes(result.state) ||
425
+ typeof result.historicalResult !== "boolean")
426
+ throw new Error("Attachment operation response is unreadable");
427
+ if (opts.json)
428
+ return emitJson(result), 0;
429
+ process.stdout.write(`${result.operationId} ${result.state}${result.historicalResult ? " (historical receipt)" : ""}\n`);
430
+ return 0;
431
+ }
432
+ catch (e) {
433
+ return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
434
+ }
435
+ }
436
+ // ── trash / restore ──────────────────────────────────────────────────────────
437
+ export async function runFilesRm(ref, opts) {
438
+ const t = await target(opts);
439
+ if (!t)
440
+ return 1;
441
+ try {
442
+ const row = await resolveFile(t.c, t.id, ref, { includeTrashed: true });
443
+ if (!row)
444
+ return EXIT_NO_FILE;
445
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}?purge=${opts.purge ? "true" : "false"}`, {
446
+ method: "DELETE",
447
+ token: t.c.token,
448
+ headers: opts.ifMatch ? { "If-Match": opts.ifMatch } : {},
449
+ });
450
+ if (opts.json)
451
+ return emitJson(res), 0;
452
+ process.stdout.write(res.purged
453
+ ? `✓ purged ${row.path} — the bytes are gone\n`
454
+ : `✓ trashed ${row.path} — restore with 'notes files restore ${row.id}'\n`);
455
+ return 0;
456
+ }
457
+ catch (e) {
458
+ return reportFile(e);
459
+ }
460
+ }
461
+ export async function runFilesRestore(ref, opts) {
462
+ const t = await target(opts);
463
+ if (!t)
464
+ return 1;
465
+ try {
466
+ const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(ref)}/restore`, {
467
+ method: "POST",
468
+ token: t.c.token,
469
+ json: opts.path ? { path: opts.path } : {},
470
+ });
471
+ if (opts.json)
472
+ return emitJson(res), 0;
473
+ process.stdout.write(`✓ restored ${res.path}\n`);
474
+ return 0;
475
+ }
476
+ catch (e) {
477
+ return reportFile(e);
478
+ }
479
+ }
480
+ // ── shared ───────────────────────────────────────────────────────────────────
481
+ /**
482
+ * Accept an id OR a path, because both are things a person has in hand.
483
+ *
484
+ * A path is looked up in the listing; an id is used as it is. An ambiguous
485
+ * input cannot happen — an id is an ObjectId and a path is not — so this never
486
+ * has to guess.
487
+ */
488
+ export async function resolveFile(c, noteId, ref, opts = {}) {
489
+ if (/^[0-9a-f]{24}$/i.test(ref)) {
490
+ try {
491
+ return await requestJson(c.remote, `${filesBase(c, noteId)}/${seg(ref)}`, { token: c.token });
492
+ }
493
+ catch {
494
+ fail(`no file with id ${ref}`);
495
+ return null;
496
+ }
497
+ }
498
+ const lists = opts.includeTrashed ? ["", "?trashed=true"] : [""];
499
+ for (const qs of lists) {
500
+ const res = await requestJson(c.remote, `${filesBase(c, noteId)}${qs}`, { token: c.token });
501
+ const hit = res.files.find((f) => f.path === ref);
502
+ if (hit)
503
+ return hit;
504
+ }
505
+ fail(`no file at '${ref}' — 'notes files list --note …' shows what is there`);
506
+ return null;
507
+ }
508
+ /**
509
+ * `dreamlake notes files preview <file> --note N [--share] [--open]`
510
+ *
511
+ * Prints a link that renders the file. The default needs the reader signed in
512
+ * and grants nothing by itself; `--share` returns one that works without
513
+ * signing in and lasts until `--revoke` withdraws it.
514
+ *
515
+ * The URL goes to stdout alone so it can be piped or copied; everything else
516
+ * is on stderr.
517
+ */
518
+ export async function runFilesPreview(ref, opts) {
519
+ const t = await target(opts);
520
+ if (!t)
521
+ return 1;
522
+ try {
523
+ const row = await resolveFile(t.c, t.id, ref);
524
+ if (!row)
525
+ return EXIT_NO_FILE;
526
+ const base = `${filesBase(t.c, t.id)}/${seg(row.id)}/preview`;
527
+ if (opts.revoke) {
528
+ await requestJson(t.c.remote, base, {
529
+ method: "DELETE",
530
+ token: t.c.token,
531
+ });
532
+ process.stderr.write(`✓ withdrew the shared link for ${row.path}\n`);
533
+ return 0;
534
+ }
535
+ const res = await requestJson(t.c.remote, `${base}${opts.share ? "?share=true" : ""}`, { token: t.c.token });
536
+ if (opts.json)
537
+ return emitJson(res), 0;
538
+ process.stdout.write(`${res.url}\n`);
539
+ // Which kind of link this is decides what the reader has to do, so it is
540
+ // said rather than left to be discovered by sending the wrong one.
541
+ process.stderr.write(res.kind === "shared"
542
+ ? "shared link — opens without signing in, until you revoke it\n"
543
+ : "session link — whoever opens it must be signed in and able to read the note\n");
544
+ if (opts.open) {
545
+ const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
546
+ const { spawn } = await import("node:child_process");
547
+ spawn(cmd, [res.url], { stdio: "ignore", detached: true }).unref();
548
+ }
549
+ return 0;
550
+ }
551
+ catch (e) {
552
+ return reportFile(e);
553
+ }
554
+ }
@@ -0,0 +1,9 @@
1
+ export declare function validateHtmlSnapshot(html: string, note: string, scope?: {
2
+ section?: string;
3
+ toc?: boolean;
4
+ tag?: string;
5
+ }): {
6
+ revision: string;
7
+ };
8
+ /** A reading view only: comments are generated hints, never canonical note source. */
9
+ export declare function annotatedMarkdown(html: string): string;
@@ -0,0 +1,90 @@
1
+ /** Validate the server snapshot without reserializing its HTML or source mappings. */
2
+ import { createHash } from "node:crypto";
3
+ function attributeValue(value) {
4
+ if (/&(?!(?:amp|lt|gt|quot|apos|#\d+|#[xX][\da-fA-F]+);)/.test(value))
5
+ throw new Error("unsupported HTML snapshot attribute entity");
6
+ return value.replace(/&(?:amp|lt|gt|quot|apos|#\d+|#[xX][\da-fA-F]+);/g, entity => {
7
+ const names = { "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": '"', "&apos;": "'" };
8
+ if (names[entity.toLowerCase()] !== undefined)
9
+ return names[entity.toLowerCase()];
10
+ const hexadecimal = /^&#x/i.test(entity);
11
+ const point = Number.parseInt(entity.slice(hexadecimal ? 3 : 2, -1), hexadecimal ? 16 : 10);
12
+ if (!Number.isInteger(point) || point < 1 || point > 0x10ffff || (point >= 0xd800 && point <= 0xdfff) || (point >= 0x80 && point <= 0x9f))
13
+ throw new Error("invalid HTML snapshot attribute character reference");
14
+ return String.fromCodePoint(point);
15
+ });
16
+ }
17
+ export function validateHtmlSnapshot(html, note, scope = {}) {
18
+ const root = /^<!doctype html>\s*<html\b([^>]*)>/i.exec(html);
19
+ if (!root || !/<\/html>\s*$/i.test(html))
20
+ throw new Error("server did not return a complete Notes HTML snapshot");
21
+ const attributes = new Map();
22
+ const pattern = /\s+([a-zA-Z][a-zA-Z0-9-]*)="([^"]*)"/g;
23
+ let end = 0;
24
+ for (const match of root[1].matchAll(pattern)) {
25
+ if (match.index !== end)
26
+ throw new Error("invalid HTML snapshot root attributes");
27
+ const name = match[1].toLowerCase();
28
+ if (attributes.has(name))
29
+ throw new Error("duplicate HTML snapshot root attribute");
30
+ attributes.set(name, attributeValue(match[2]));
31
+ end = match.index + match[0].length;
32
+ }
33
+ if (root[1].slice(end).trim())
34
+ throw new Error("invalid HTML snapshot root attributes");
35
+ const revision = attributes.get("data-revision"), hash = attributes.get("data-hash"), source = attributes.get("data-source");
36
+ if (attributes.get("data-note") !== note || !revision || /[\r\n]/.test(revision)
37
+ || !/^sha256:[a-f0-9]{64}$/.test(hash ?? "") || source === undefined
38
+ || attributes.get("data-offset-unit") !== "unicode-code-point"
39
+ || !["markdown", "html"].includes(attributes.get("data-source-type") ?? "")) {
40
+ throw new Error("server did not return the Notes HTML metadata contract; upgrade the server");
41
+ }
42
+ const returnedScope = attributes.get("data-scope");
43
+ let sourceHash = hash;
44
+ if (scope.section || scope.toc || scope.tag) {
45
+ if (!returnedScope || (scope.tag ? returnedScope !== "tag" || attributes.get("data-target-id") !== scope.tag : scope.toc ? returnedScope !== "toc" : !/^s[1-9]\d*(?:\.[1-9]\d*)*$/.test(returnedScope)))
46
+ throw new Error("server did not return the requested HTML scope");
47
+ if (scope.section?.startsWith("s") && /^s[1-9]\d*(?:\.[1-9]\d*)*$/.test(scope.section) && returnedScope !== scope.section)
48
+ throw new Error("server returned a different section");
49
+ if (scope.section && scope.section !== returnedScope && scope.section !== attributes.get("data-section-id"))
50
+ throw new Error("server returned a different section");
51
+ const start = attributes.get("data-source-start"), end = attributes.get("data-source-end");
52
+ if (!/^\d+$/.test(start ?? "") || !/^\d+$/.test(end ?? "") || !Number.isSafeInteger(Number(end)) || Number(end) - Number(start) !== Array.from(source).length)
53
+ throw new Error("invalid scoped source range");
54
+ if (scope.toc && (source !== "" || start !== "0" || end !== "0"))
55
+ throw new Error("invalid TOC source");
56
+ sourceHash = attributes.get("data-source-hash");
57
+ }
58
+ else if (returnedScope && returnedScope !== "article")
59
+ throw new Error("server returned partial HTML for a full read");
60
+ if (`sha256:${createHash("sha256").update(source, "utf8").digest("hex")}` !== sourceHash)
61
+ throw new Error("HTML canonical source does not match its returned hash");
62
+ return { revision };
63
+ }
64
+ /** A reading view only: comments are generated hints, never canonical note source. */
65
+ export function annotatedMarkdown(html) {
66
+ const attrs = (raw) => new Map(Array.from(raw.matchAll(/\s+([a-zA-Z][a-zA-Z0-9-]*)="([^"]*)"/g), m => [m[1], attributeValue(m[2])]));
67
+ const root = attrs(/^<!doctype html>\s*<html\b([^>]*)>/i.exec(html)[1]);
68
+ if (root.get('data-source-type') !== 'markdown')
69
+ throw new Error('annotated Markdown requires a Markdown note; use --view html for HTML source');
70
+ const source = root.get('data-source');
71
+ const origin = Number(root.get('data-source-start') ?? 0);
72
+ const points = Array.from(source);
73
+ const toc = root.get('data-scope') === 'toc';
74
+ const blocks = root.get('data-content-format') === 'literal-markdown'
75
+ ? JSON.parse(root.get('data-addresses') ?? '[]').map(a => new Map(Object.entries(a)))
76
+ : Array.from(html.matchAll(/<(?:h[1-6]|p|ul|ol|li)\b([^>]*)>/g)).map(m => attrs(m[1])).filter(a => a.has('id') && a.has('data-char'));
77
+ const hint = (a) => `<!-- ${a.get('id')} chars=${a.get('data-char')} lines=${a.get('data-lines')}${a.has('data-section-id') ? ` section=${a.get('data-section-id')}` : ''} -->\n`;
78
+ const header = `<!-- notes-reading-view revision=${root.get('data-revision')} hash=${root.get('data-hash')} scope=${root.get('data-scope') ?? 'article'}; generated hints are not source -->\n`;
79
+ if (toc)
80
+ return header + blocks.map(a => hint(a) + (a.get('data-source') ?? '')).join('\n');
81
+ let cursor = 0, output = header;
82
+ for (const a of blocks.sort((a, b) => Number(a.get('data-char').split(':')[0]) - Number(b.get('data-char').split(':')[0]))) {
83
+ const at = Number(a.get('data-char').split(':')[0]) - origin;
84
+ if (at < cursor || at > points.length)
85
+ continue;
86
+ output += points.slice(cursor, at).join('') + hint(a);
87
+ cursor = at;
88
+ }
89
+ return output + points.slice(cursor).join('');
90
+ }