@dreamlake/dreamlake-cli 0.88.1 → 0.90.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.
- package/dist/api/access.d.ts +83 -0
- package/dist/api/access.js +77 -0
- package/dist/api/agent.d.ts +156 -0
- package/dist/api/agent.js +111 -0
- package/dist/api/browser.d.ts +90 -0
- package/dist/api/browser.js +102 -0
- package/dist/api/client.d.ts +54 -0
- package/dist/api/client.js +102 -0
- package/dist/api/common.d.ts +28 -0
- package/dist/api/common.js +16 -0
- package/dist/api/content.d.ts +195 -0
- package/dist/api/content.js +147 -0
- package/dist/api/execution.d.ts +84 -0
- package/dist/api/execution.js +73 -0
- package/dist/api/http.d.ts +19 -0
- package/dist/api/http.js +66 -0
- package/dist/api/index.d.ts +2362 -0
- package/dist/api/index.js +116 -0
- package/dist/api/infra.d.ts +2 -0
- package/dist/api/infra.js +2 -0
- package/dist/api/jobs.d.ts +2 -0
- package/dist/api/jobs.js +2 -0
- package/dist/api/layout.d.ts +2 -0
- package/dist/api/layout.js +2 -0
- package/dist/api/library-edit.d.ts +3 -0
- package/dist/api/library-edit.js +3 -0
- package/dist/api/library-manifest.d.ts +2 -0
- package/dist/api/library-manifest.js +2 -0
- package/dist/api/note-character-plan.d.ts +2 -0
- package/dist/api/note-character-plan.js +2 -0
- package/dist/api/note-editing.d.ts +2 -0
- package/dist/api/note-editing.js +2 -0
- package/dist/api/note-edits.d.ts +21 -0
- package/dist/api/note-edits.js +10 -0
- package/dist/api/note-events.d.ts +5 -0
- package/dist/api/note-events.js +11 -0
- package/dist/api/note-files.d.ts +102 -0
- package/dist/api/note-files.js +107 -0
- package/dist/api/note-html-read.d.ts +2 -0
- package/dist/api/note-html-read.js +2 -0
- package/dist/api/note-html.d.ts +2 -0
- package/dist/api/note-html.js +2 -0
- package/dist/api/note-linger.d.ts +83 -0
- package/dist/api/note-linger.js +270 -0
- package/dist/api/note-presence.d.ts +82 -0
- package/dist/api/note-presence.js +72 -0
- package/dist/api/note-toc.d.ts +2 -0
- package/dist/api/note-toc.js +2 -0
- package/dist/api/notes.d.ts +329 -0
- package/dist/api/notes.js +209 -0
- package/dist/api/open-resources.d.ts +27 -0
- package/dist/api/open-resources.js +102 -0
- package/dist/api/ownership.d.ts +12 -0
- package/dist/api/ownership.js +24 -0
- package/dist/api/platform.d.ts +83 -0
- package/dist/api/platform.js +56 -0
- package/dist/api/presigned-transfer.d.ts +2 -0
- package/dist/api/presigned-transfer.js +2 -0
- package/dist/api/registered-runs.d.ts +48 -0
- package/dist/api/registered-runs.js +33 -0
- package/dist/api/sessions.d.ts +299 -0
- package/dist/api/sessions.js +105 -0
- package/dist/api/storage.d.ts +46 -0
- package/dist/api/storage.js +34 -0
- package/dist/api/streams.d.ts +18 -0
- package/dist/api/streams.js +70 -0
- package/dist/api/vault.d.ts +93 -0
- package/dist/api/vault.js +79 -0
- package/dist/api/workspace.d.ts +180 -0
- package/dist/api/workspace.js +146 -0
- package/dist/cli/agent-identity.d.ts +4 -0
- package/dist/cli/agent-identity.js +21 -0
- package/dist/cli/agents/identity.d.ts +50 -0
- package/dist/cli/agents/identity.js +105 -0
- package/dist/cli/agents/index.d.ts +31 -0
- package/dist/cli/agents/index.js +580 -0
- package/dist/cli/agents/manage.d.ts +43 -0
- package/dist/cli/agents/manage.js +376 -0
- package/dist/cli/agents/spec.d.ts +104 -0
- package/dist/cli/agents/spec.js +280 -0
- package/dist/cli/agents/web.d.ts +7 -0
- package/dist/cli/agents/web.js +109 -0
- package/dist/cli/artifact/incremental.d.ts +21 -0
- package/dist/cli/artifact/incremental.js +80 -0
- package/dist/cli/artifact/index.d.ts +52 -0
- package/dist/cli/artifact/index.js +405 -0
- package/dist/cli/artifact/meta.d.ts +69 -0
- package/dist/cli/artifact/meta.js +189 -0
- package/dist/cli/auth/commands.d.ts +29 -0
- package/dist/cli/auth/commands.js +327 -0
- package/dist/cli/auth/constants.d.ts +13 -0
- package/dist/cli/auth/constants.js +18 -0
- package/dist/cli/auth/credentials.d.ts +37 -0
- package/dist/cli/auth/credentials.js +155 -0
- package/dist/cli/auth/device-flow.d.ts +32 -0
- package/dist/cli/auth/device-flow.js +154 -0
- package/dist/cli/auth/device-secret.d.ts +6 -0
- package/dist/cli/auth/device-secret.js +26 -0
- package/dist/cli/auth/machine.d.ts +15 -0
- package/dist/cli/auth/machine.js +126 -0
- package/dist/cli/auth/materialized.d.ts +32 -0
- package/dist/cli/auth/materialized.js +102 -0
- package/dist/cli/auth/migrate.d.ts +10 -0
- package/dist/cli/auth/migrate.js +75 -0
- package/dist/cli/client.d.ts +102 -0
- package/dist/cli/client.js +206 -0
- package/dist/cli/collection-list.d.ts +3 -0
- package/dist/cli/collection-list.js +25 -0
- package/dist/cli/compat/ctx.d.ts +26 -0
- package/dist/cli/compat/ctx.js +76 -0
- package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
- package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
- package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
- package/dist/cli/compat/dreamdb-wasm.js +26 -0
- package/dist/cli/compat/dreamdb.d.ts +112 -0
- package/dist/cli/compat/dreamdb.js +219 -0
- package/dist/cli/compat/flags.d.ts +2 -0
- package/dist/cli/compat/flags.js +13 -0
- package/dist/cli/compat/http.d.ts +23 -0
- package/dist/cli/compat/http.js +137 -0
- package/dist/cli/compat/presignedTransfer.d.ts +139 -0
- package/dist/cli/compat/presignedTransfer.js +580 -0
- package/dist/cli/compat/s3-backend.d.ts +73 -0
- package/dist/cli/compat/s3-backend.js +132 -0
- package/dist/cli/config.d.ts +22 -0
- package/dist/cli/config.js +96 -0
- package/dist/cli/connection/dto.d.ts +159 -0
- package/dist/cli/connection/dto.js +497 -0
- package/dist/cli/connection/index.d.ts +50 -0
- package/dist/cli/connection/index.js +413 -0
- package/dist/cli/connection/oauth.d.ts +23 -0
- package/dist/cli/connection/oauth.js +290 -0
- package/dist/cli/connection/write.d.ts +47 -0
- package/dist/cli/connection/write.js +573 -0
- package/dist/cli/create/index.d.ts +19 -0
- package/dist/cli/create/index.js +209 -0
- package/dist/cli/declare/index.d.ts +29 -0
- package/dist/cli/declare/index.js +304 -0
- package/dist/cli/delete/index.d.ts +18 -0
- package/dist/cli/delete/index.js +232 -0
- package/dist/cli/download/index.d.ts +9 -0
- package/dist/cli/download/index.js +128 -0
- package/dist/cli/env/compose.d.ts +88 -0
- package/dist/cli/env/compose.js +402 -0
- package/dist/cli/env/index.d.ts +176 -0
- package/dist/cli/env/index.js +1011 -0
- package/dist/cli/experiments/index.d.ts +11 -0
- package/dist/cli/experiments/index.js +168 -0
- package/dist/cli/glob.d.ts +1 -0
- package/dist/cli/glob.js +45 -0
- package/dist/cli/graphql-helpers.d.ts +23 -0
- package/dist/cli/graphql-helpers.js +42 -0
- package/dist/cli/graphql.d.ts +10 -0
- package/dist/cli/graphql.js +47 -0
- package/dist/cli/help-examples.generated.d.ts +1 -0
- package/dist/cli/help-examples.generated.js +192 -0
- package/dist/cli/helpers.d.ts +8 -0
- package/dist/cli/helpers.js +106 -0
- package/dist/cli/hosts/api.d.ts +29 -0
- package/dist/cli/hosts/api.js +54 -0
- package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
- package/dist/cli/hosts/bootstrap-source.js +2 -0
- package/dist/cli/hosts/catalog.d.ts +26 -0
- package/dist/cli/hosts/catalog.js +55 -0
- package/dist/cli/hosts/config.d.ts +45 -0
- package/dist/cli/hosts/config.js +179 -0
- package/dist/cli/hosts/credentials.d.ts +19 -0
- package/dist/cli/hosts/credentials.js +173 -0
- package/dist/cli/hosts/enroll.d.ts +17 -0
- package/dist/cli/hosts/enroll.js +109 -0
- package/dist/cli/hosts/enrollments.d.ts +25 -0
- package/dist/cli/hosts/enrollments.js +54 -0
- package/dist/cli/hosts/index.d.ts +6 -0
- package/dist/cli/hosts/index.js +279 -0
- package/dist/cli/hosts/inventory.d.ts +40 -0
- package/dist/cli/hosts/inventory.js +91 -0
- package/dist/cli/hosts/lifecycle.d.ts +15 -0
- package/dist/cli/hosts/lifecycle.js +108 -0
- package/dist/cli/hosts/metrics-source.d.ts +12 -0
- package/dist/cli/hosts/metrics-source.js +89 -0
- package/dist/cli/hosts/observations.d.ts +39 -0
- package/dist/cli/hosts/observations.js +102 -0
- package/dist/cli/hosts/remote.d.ts +5 -0
- package/dist/cli/hosts/remote.js +66 -0
- package/dist/cli/hosts/ssh.d.ts +63 -0
- package/dist/cli/hosts/ssh.js +276 -0
- package/dist/cli/index.d.ts +1 -0
- package/dist/cli/index.js +288 -0
- package/dist/cli/infra/api.d.ts +95 -0
- package/dist/cli/infra/api.js +291 -0
- package/dist/cli/infra/index.d.ts +5 -0
- package/dist/cli/infra/index.js +102 -0
- package/dist/cli/infra/move.d.ts +15 -0
- package/dist/cli/infra/move.js +123 -0
- package/dist/cli/infra/transfer.d.ts +15 -0
- package/dist/cli/infra/transfer.js +280 -0
- package/dist/cli/jobs/api.d.ts +69 -0
- package/dist/cli/jobs/api.js +121 -0
- package/dist/cli/jobs/index.d.ts +5 -0
- package/dist/cli/jobs/index.js +140 -0
- package/dist/cli/lakeshore/index.d.ts +98 -0
- package/dist/cli/lakeshore/index.js +502 -0
- package/dist/cli/launch/index.d.ts +43 -0
- package/dist/cli/launch/index.js +270 -0
- package/dist/cli/layout/index.d.ts +2 -0
- package/dist/cli/layout/index.js +44 -0
- package/dist/cli/layout/transport.d.ts +12 -0
- package/dist/cli/layout/transport.js +70 -0
- package/dist/cli/library/add.d.ts +60 -0
- package/dist/cli/library/add.js +348 -0
- package/dist/cli/library/cache.d.ts +26 -0
- package/dist/cli/library/cache.js +88 -0
- package/dist/cli/library/config.d.ts +75 -0
- package/dist/cli/library/config.js +198 -0
- package/dist/cli/library/digest.d.ts +5 -0
- package/dist/cli/library/digest.js +19 -0
- package/dist/cli/library/discover.d.ts +87 -0
- package/dist/cli/library/discover.js +534 -0
- package/dist/cli/library/freshness.d.ts +35 -0
- package/dist/cli/library/freshness.js +109 -0
- package/dist/cli/library/generation.d.ts +35 -0
- package/dist/cli/library/generation.js +211 -0
- package/dist/cli/library/index.d.ts +2 -0
- package/dist/cli/library/index.js +36 -0
- package/dist/cli/library/info.d.ts +69 -0
- package/dist/cli/library/info.js +311 -0
- package/dist/cli/library/list.d.ts +33 -0
- package/dist/cli/library/list.js +86 -0
- package/dist/cli/library/manifest.d.ts +81 -0
- package/dist/cli/library/manifest.js +200 -0
- package/dist/cli/library/manifestCache.d.ts +45 -0
- package/dist/cli/library/manifestCache.js +169 -0
- package/dist/cli/library/pull.d.ts +30 -0
- package/dist/cli/library/pull.js +438 -0
- package/dist/cli/library/push.d.ts +72 -0
- package/dist/cli/library/push.js +642 -0
- package/dist/cli/library/rm.d.ts +31 -0
- package/dist/cli/library/rm.js +200 -0
- package/dist/cli/library/search.d.ts +18 -0
- package/dist/cli/library/search.js +181 -0
- package/dist/cli/library/stat.d.ts +15 -0
- package/dist/cli/library/stat.js +127 -0
- package/dist/cli/library/tools.d.ts +104 -0
- package/dist/cli/library/tools.js +163 -0
- package/dist/cli/library/wire.d.ts +47 -0
- package/dist/cli/library/wire.js +120 -0
- package/dist/cli/list/index.d.ts +26 -0
- package/dist/cli/list/index.js +256 -0
- package/dist/cli/notes/api-transport.d.ts +5 -0
- package/dist/cli/notes/api-transport.js +20 -0
- package/dist/cli/notes/character-plan.d.ts +22 -0
- package/dist/cli/notes/character-plan.js +232 -0
- package/dist/cli/notes/document.d.ts +73 -0
- package/dist/cli/notes/document.js +306 -0
- package/dist/cli/notes/edit-commands.d.ts +106 -0
- package/dist/cli/notes/edit-commands.js +623 -0
- package/dist/cli/notes/editing.d.ts +81 -0
- package/dist/cli/notes/editing.js +305 -0
- package/dist/cli/notes/events.d.ts +36 -0
- package/dist/cli/notes/events.js +54 -0
- package/dist/cli/notes/files-commands.d.ts +97 -0
- package/dist/cli/notes/files-commands.js +548 -0
- package/dist/cli/notes/html-read.d.ts +9 -0
- package/dist/cli/notes/html-read.js +90 -0
- package/dist/cli/notes/html.d.ts +73 -0
- package/dist/cli/notes/html.js +381 -0
- package/dist/cli/notes/index.d.ts +123 -0
- package/dist/cli/notes/index.js +1300 -0
- package/dist/cli/notes/linger.d.ts +4 -0
- package/dist/cli/notes/linger.js +96 -0
- package/dist/cli/notes/media-commands.d.ts +5 -0
- package/dist/cli/notes/media-commands.js +51 -0
- package/dist/cli/notes/move-command.d.ts +83 -0
- package/dist/cli/notes/move-command.js +259 -0
- package/dist/cli/notes/rm-command.d.ts +22 -0
- package/dist/cli/notes/rm-command.js +110 -0
- package/dist/cli/notes/select-command.d.ts +12 -0
- package/dist/cli/notes/select-command.js +63 -0
- package/dist/cli/notes/suggest-diff.d.ts +56 -0
- package/dist/cli/notes/suggest-diff.js +311 -0
- package/dist/cli/notes/toc.d.ts +38 -0
- package/dist/cli/notes/toc.js +144 -0
- package/dist/cli/notes/transfer-command.d.ts +6 -0
- package/dist/cli/notes/transfer-command.js +9 -0
- package/dist/cli/notes/version-commands.d.ts +19 -0
- package/dist/cli/notes/version-commands.js +178 -0
- package/dist/cli/nymph/index.d.ts +74 -0
- package/dist/cli/nymph/index.js +349 -0
- package/dist/cli/org/index.d.ts +34 -0
- package/dist/cli/org/index.js +341 -0
- package/dist/cli/ownership/index.d.ts +12 -0
- package/dist/cli/ownership/index.js +122 -0
- package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
- package/dist/cli/ownership/metadata-transfer.js +159 -0
- package/dist/cli/page/index.d.ts +58 -0
- package/dist/cli/page/index.js +387 -0
- package/dist/cli/pipeline/index.d.ts +69 -0
- package/dist/cli/pipeline/index.js +604 -0
- package/dist/cli/progress.d.ts +60 -0
- package/dist/cli/progress.js +276 -0
- package/dist/cli/project/attachments.d.ts +10 -0
- package/dist/cli/project/attachments.js +39 -0
- package/dist/cli/project/grants.d.ts +10 -0
- package/dist/cli/project/grants.js +39 -0
- package/dist/cli/project/index.d.ts +8 -0
- package/dist/cli/project/index.js +92 -0
- package/dist/cli/project/move.d.ts +57 -0
- package/dist/cli/project/move.js +242 -0
- package/dist/cli/project/output.d.ts +2 -0
- package/dist/cli/project/output.js +29 -0
- package/dist/cli/project/stream.d.ts +55 -0
- package/dist/cli/project/stream.js +207 -0
- package/dist/cli/project/transfer-preview.d.ts +8 -0
- package/dist/cli/project/transfer-preview.js +10 -0
- package/dist/cli/prompt.d.ts +1 -0
- package/dist/cli/prompt.js +17 -0
- package/dist/cli/provider/dreamdir.d.ts +52 -0
- package/dist/cli/provider/dreamdir.js +138 -0
- package/dist/cli/provider/index.d.ts +4 -0
- package/dist/cli/provider/index.js +419 -0
- package/dist/cli/provider/jump-worker.d.ts +9 -0
- package/dist/cli/provider/jump-worker.js +141 -0
- package/dist/cli/provider/lifecycle.d.ts +149 -0
- package/dist/cli/provider/lifecycle.js +1390 -0
- package/dist/cli/provider/machine.d.ts +17 -0
- package/dist/cli/provider/machine.js +116 -0
- package/dist/cli/provider/ssh.d.ts +105 -0
- package/dist/cli/provider/ssh.js +305 -0
- package/dist/cli/provider/terraform.d.ts +140 -0
- package/dist/cli/provider/terraform.js +288 -0
- package/dist/cli/providers/index.d.ts +18 -0
- package/dist/cli/providers/index.js +422 -0
- package/dist/cli/python.d.ts +61 -0
- package/dist/cli/python.js +255 -0
- package/dist/cli/queues/index.d.ts +33 -0
- package/dist/cli/queues/index.js +248 -0
- package/dist/cli/queues/slurm.d.ts +10 -0
- package/dist/cli/queues/slurm.js +134 -0
- package/dist/cli/resources.d.ts +72 -0
- package/dist/cli/resources.js +137 -0
- package/dist/cli/run/index.d.ts +15 -0
- package/dist/cli/run/index.js +163 -0
- package/dist/cli/run/input.d.ts +34 -0
- package/dist/cli/run/input.js +135 -0
- package/dist/cli/run/recovery.d.ts +2 -0
- package/dist/cli/run/recovery.js +18 -0
- package/dist/cli/run/setup.d.ts +3 -0
- package/dist/cli/run/setup.js +62 -0
- package/dist/cli/runconfig/index.d.ts +12 -0
- package/dist/cli/runconfig/index.js +130 -0
- package/dist/cli/runnable/index.d.ts +35 -0
- package/dist/cli/runnable/index.js +575 -0
- package/dist/cli/runnable/path.d.ts +115 -0
- package/dist/cli/runnable/path.js +288 -0
- package/dist/cli/runnable/run.d.ts +91 -0
- package/dist/cli/runnable/run.js +239 -0
- package/dist/cli/runnable/upload.d.ts +43 -0
- package/dist/cli/runnable/upload.js +342 -0
- package/dist/cli/runnable/worker.d.ts +1 -0
- package/dist/cli/runnable/worker.js +44 -0
- package/dist/cli/schemas/workflow-spec.schema.json +335 -0
- package/dist/cli/self-update/index.d.ts +5 -0
- package/dist/cli/self-update/index.js +107 -0
- package/dist/cli/self-update/install.d.ts +60 -0
- package/dist/cli/self-update/install.js +428 -0
- package/dist/cli/self-update/paths.d.ts +40 -0
- package/dist/cli/self-update/paths.js +87 -0
- package/dist/cli/self-update/releases.d.ts +41 -0
- package/dist/cli/self-update/releases.js +153 -0
- package/dist/cli/self-update/settings.d.ts +16 -0
- package/dist/cli/self-update/settings.js +68 -0
- package/dist/cli/self-update/update.d.ts +18 -0
- package/dist/cli/self-update/update.js +241 -0
- package/dist/cli/service-accounts/index.d.ts +3 -0
- package/dist/cli/service-accounts/index.js +149 -0
- package/dist/cli/session-affiliation.d.ts +26 -0
- package/dist/cli/session-affiliation.js +135 -0
- package/dist/cli/sessions/affiliation.d.ts +8 -0
- package/dist/cli/sessions/affiliation.js +66 -0
- package/dist/cli/sessions/api.d.ts +55 -0
- package/dist/cli/sessions/api.js +88 -0
- package/dist/cli/sessions/control.d.ts +6 -0
- package/dist/cli/sessions/control.js +159 -0
- package/dist/cli/sessions/conversation.d.ts +15 -0
- package/dist/cli/sessions/conversation.js +118 -0
- package/dist/cli/sessions/index.d.ts +2 -0
- package/dist/cli/sessions/index.js +209 -0
- package/dist/cli/sessions/managed.d.ts +39 -0
- package/dist/cli/sessions/managed.js +63 -0
- package/dist/cli/sessions/redaction.d.ts +2 -0
- package/dist/cli/sessions/redaction.js +11 -0
- package/dist/cli/sessions/runner/exec.d.ts +108 -0
- package/dist/cli/sessions/runner/exec.js +335 -0
- package/dist/cli/sessions/runner/journal.d.ts +26 -0
- package/dist/cli/sessions/runner/journal.js +49 -0
- package/dist/cli/sessions/runner/native.d.ts +48 -0
- package/dist/cli/sessions/runner/native.js +170 -0
- package/dist/cli/sessions/runner/pod.d.ts +30 -0
- package/dist/cli/sessions/runner/pod.js +129 -0
- package/dist/cli/sessions/runner/serve.d.ts +85 -0
- package/dist/cli/sessions/runner/serve.js +558 -0
- package/dist/cli/sessions/sync.d.ts +47 -0
- package/dist/cli/sessions/sync.js +80 -0
- package/dist/cli/sessions/transport.d.ts +14 -0
- package/dist/cli/sessions/transport.js +116 -0
- package/dist/cli/share.d.ts +15 -0
- package/dist/cli/share.js +139 -0
- package/dist/cli/skill/catalog.d.ts +141 -0
- package/dist/cli/skill/catalog.js +442 -0
- package/dist/cli/skill/files.d.ts +89 -0
- package/dist/cli/skill/files.js +264 -0
- package/dist/cli/skill/index.d.ts +268 -0
- package/dist/cli/skill/index.js +1216 -0
- package/dist/cli/skill/manifest.d.ts +30 -0
- package/dist/cli/skill/manifest.js +101 -0
- package/dist/cli/skill/prefs.d.ts +9 -0
- package/dist/cli/skill/prefs.js +32 -0
- package/dist/cli/skill/reminders.d.ts +15 -0
- package/dist/cli/skill/reminders.js +105 -0
- package/dist/cli/skill/tar.d.ts +17 -0
- package/dist/cli/skill/tar.js +195 -0
- package/dist/cli/snapshot/index.d.ts +24 -0
- package/dist/cli/snapshot/index.js +146 -0
- package/dist/cli/source/access.d.ts +45 -0
- package/dist/cli/source/access.js +563 -0
- package/dist/cli/source/control.d.ts +103 -0
- package/dist/cli/source/control.js +546 -0
- package/dist/cli/source/delete.d.ts +89 -0
- package/dist/cli/source/delete.js +463 -0
- package/dist/cli/source/index.d.ts +288 -0
- package/dist/cli/source/index.js +1348 -0
- package/dist/cli/source/share.d.ts +65 -0
- package/dist/cli/source/share.js +530 -0
- package/dist/cli/source/upload.d.ts +62 -0
- package/dist/cli/source/upload.js +258 -0
- package/dist/cli/source/write.d.ts +77 -0
- package/dist/cli/source/write.js +335 -0
- package/dist/cli/spawn.d.ts +28 -0
- package/dist/cli/spawn.js +81 -0
- package/dist/cli/target.d.ts +22 -0
- package/dist/cli/target.js +85 -0
- package/dist/cli/tasks/index.d.ts +38 -0
- package/dist/cli/tasks/index.js +365 -0
- package/dist/cli/team/index.d.ts +37 -0
- package/dist/cli/team/index.js +407 -0
- package/dist/cli/telemetry.d.ts +23 -0
- package/dist/cli/telemetry.js +262 -0
- package/dist/cli/telemetryJournal.d.ts +26 -0
- package/dist/cli/telemetryJournal.js +104 -0
- package/dist/cli/update/index.d.ts +21 -0
- package/dist/cli/update/index.js +284 -0
- package/dist/cli/upload/index.d.ts +11 -0
- package/dist/cli/upload/index.js +261 -0
- package/dist/cli/upload/kinds.d.ts +10 -0
- package/dist/cli/upload/kinds.js +85 -0
- package/dist/cli/upload/multipart.d.ts +21 -0
- package/dist/cli/upload/multipart.js +248 -0
- package/dist/cli/vault/affected-preview.d.ts +15 -0
- package/dist/cli/vault/affected-preview.js +38 -0
- package/dist/cli/vault/cloud.d.ts +55 -0
- package/dist/cli/vault/cloud.js +287 -0
- package/dist/cli/vault/format.d.ts +18 -0
- package/dist/cli/vault/format.js +104 -0
- package/dist/cli/vault/hostCredentials.d.ts +21 -0
- package/dist/cli/vault/hostCredentials.js +71 -0
- package/dist/cli/vault/hostSupersessions.d.ts +18 -0
- package/dist/cli/vault/hostSupersessions.js +68 -0
- package/dist/cli/vault/import.d.ts +3 -0
- package/dist/cli/vault/import.js +79 -0
- package/dist/cli/vault/index.d.ts +14 -0
- package/dist/cli/vault/index.js +225 -0
- package/dist/cli/vault/keys.d.ts +5 -0
- package/dist/cli/vault/keys.js +165 -0
- package/dist/cli/vault/kms.d.ts +6 -0
- package/dist/cli/vault/kms.js +169 -0
- package/dist/cli/vault/list.d.ts +13 -0
- package/dist/cli/vault/list.js +60 -0
- package/dist/cli/vault/listView.d.ts +21 -0
- package/dist/cli/vault/listView.js +123 -0
- package/dist/cli/vault/managementMetadata.d.ts +2 -0
- package/dist/cli/vault/managementMetadata.js +23 -0
- package/dist/cli/vault/mutations.d.ts +8 -0
- package/dist/cli/vault/mutations.js +151 -0
- package/dist/cli/vault/otp.d.ts +6 -0
- package/dist/cli/vault/otp.js +62 -0
- package/dist/cli/vault/otpIntent.d.ts +23 -0
- package/dist/cli/vault/otpIntent.js +76 -0
- package/dist/cli/vault/passImport.d.ts +25 -0
- package/dist/cli/vault/passImport.js +129 -0
- package/dist/cli/vault/passOtp.d.ts +51 -0
- package/dist/cli/vault/passOtp.js +101 -0
- package/dist/cli/vault/passStore.d.ts +26 -0
- package/dist/cli/vault/passStore.js +134 -0
- package/dist/cli/vault/passwordCommand.d.ts +39 -0
- package/dist/cli/vault/passwordCommand.js +101 -0
- package/dist/cli/vault/passwordProbe.d.ts +27 -0
- package/dist/cli/vault/passwordProbe.js +282 -0
- package/dist/cli/vault/passwordRotation.d.ts +9 -0
- package/dist/cli/vault/passwordRotation.js +273 -0
- package/dist/cli/vault/rotationApi.d.ts +13 -0
- package/dist/cli/vault/rotationApi.js +58 -0
- package/dist/cli/vault/rotationCommand.d.ts +2 -0
- package/dist/cli/vault/rotationCommand.js +75 -0
- package/dist/cli/vault/rotationEngine.d.ts +19 -0
- package/dist/cli/vault/rotationEngine.js +65 -0
- package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
- package/dist/cli/vault/rotationHelperSource.js +3 -0
- package/dist/cli/vault/rotationInput.d.ts +11 -0
- package/dist/cli/vault/rotationInput.js +48 -0
- package/dist/cli/vault/rotationJournal.d.ts +16 -0
- package/dist/cli/vault/rotationJournal.js +183 -0
- package/dist/cli/vault/rotationKeys.d.ts +4 -0
- package/dist/cli/vault/rotationKeys.js +48 -0
- package/dist/cli/vault/rotationPrepare.d.ts +17 -0
- package/dist/cli/vault/rotationPrepare.js +108 -0
- package/dist/cli/vault/rotationRemote.d.ts +33 -0
- package/dist/cli/vault/rotationRemote.js +156 -0
- package/dist/cli/vault/rotationState.d.ts +42 -0
- package/dist/cli/vault/rotationState.js +115 -0
- package/dist/cli/vault/rotationTransport.d.ts +18 -0
- package/dist/cli/vault/rotationTransport.js +71 -0
- package/dist/cli/vault/sshSource.d.ts +18 -0
- package/dist/cli/vault/sshSource.js +196 -0
- package/dist/cli/vault/sshSync.d.ts +17 -0
- package/dist/cli/vault/sshSync.js +224 -0
- package/dist/cli/vault/sshTransfer.d.ts +22 -0
- package/dist/cli/vault/sshTransfer.js +140 -0
- package/dist/cli/vault/terraformState.d.ts +66 -0
- package/dist/cli/vault/terraformState.js +252 -0
- package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
- package/dist/cli/vault/terraformStateCommand.js +61 -0
- package/dist/cli/vault/tree.d.ts +43 -0
- package/dist/cli/vault/tree.js +292 -0
- package/dist/cli/version.d.ts +1 -0
- package/dist/cli/version.js +9 -0
- package/dist/cli/workflow/index.d.ts +76 -0
- package/dist/cli/workflow/index.js +826 -0
- package/dist/cli/workflow/validate.d.ts +19 -0
- package/dist/cli/workflow/validate.js +353 -0
- package/dist/package.json +1 -0
- package/package.json +28 -10
|
@@ -0,0 +1,548 @@
|
|
|
1
|
+
import { noteFilesApi, noteFileOperationId, validateNoteFileKey } from '../../api/note-files.js';
|
|
2
|
+
import { noteTransport } from './api-transport.js';
|
|
3
|
+
/**
|
|
4
|
+
* `dreamlake notes files …` — list, upload, download, move, copy, trash.
|
|
5
|
+
*
|
|
6
|
+
* Bytes are never decoded on this path. Upload reads the local file as a
|
|
7
|
+
* Buffer and sends it raw; download writes the response body straight out.
|
|
8
|
+
* Only `--text` touches a string, and the server refuses that for anything not
|
|
9
|
+
* text-typed rather than round-tripping it through UTF-8.
|
|
10
|
+
*
|
|
11
|
+
* Downloads refuse to replace a local file unless asked. Everything else here
|
|
12
|
+
* goes to a recoverable trash; something overwritten on the caller's disk does
|
|
13
|
+
* not come back.
|
|
14
|
+
*/
|
|
15
|
+
import { createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, } from "node:fs";
|
|
16
|
+
import { pipeline } from "node:stream/promises";
|
|
17
|
+
import { Readable } from "node:stream";
|
|
18
|
+
import path from "node:path";
|
|
19
|
+
import { ctx, report, resolveNote, seg } from "./index.js";
|
|
20
|
+
import { emitJson, fail } from "../helpers.js";
|
|
21
|
+
import { requestJson, requestRaw } from "../client.js";
|
|
22
|
+
/** Exit code for "the file or path was wrong", distinct from a transport failure. */
|
|
23
|
+
export const EXIT_NO_FILE = 6;
|
|
24
|
+
/** Exit code for a refused overwrite — a script can branch on it and retry. */
|
|
25
|
+
export const EXIT_EXISTS = 7;
|
|
26
|
+
function filesBase(c, id) {
|
|
27
|
+
return `/namespaces/${seg(c.ns)}/notes/${seg(id)}/files`;
|
|
28
|
+
}
|
|
29
|
+
/** Resolve the note every file command needs. */
|
|
30
|
+
async function target(opts) {
|
|
31
|
+
if (!opts.note) {
|
|
32
|
+
fail("say which note: --note <id-or-slug>");
|
|
33
|
+
return null;
|
|
34
|
+
}
|
|
35
|
+
const c = await ctx(opts);
|
|
36
|
+
if (!c)
|
|
37
|
+
return null;
|
|
38
|
+
const id = await resolveNote(c, opts.note);
|
|
39
|
+
if (!id)
|
|
40
|
+
return null;
|
|
41
|
+
return { c, id };
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Map a server refusal onto an exit code a script can branch on.
|
|
45
|
+
*
|
|
46
|
+
* The server's own sentence is preferred over the transport's. HttpError's
|
|
47
|
+
* `message` is about the status; the reason lives in the JSON body, and it is
|
|
48
|
+
* the reason that tells a person what to do — "a.zip is application/zip, which
|
|
49
|
+
* has no rendered form" against "Request failed with status 400".
|
|
50
|
+
*/
|
|
51
|
+
function reportFile(err, recovery) {
|
|
52
|
+
if (recovery) {
|
|
53
|
+
let operationId = recovery.operationId;
|
|
54
|
+
try {
|
|
55
|
+
operationId ??= operationIdOf(JSON.parse(err.body ?? "").operationId);
|
|
56
|
+
}
|
|
57
|
+
catch { }
|
|
58
|
+
if (operationId)
|
|
59
|
+
process.stderr.write(`operation ${operationId} — inspect with notes files status ${operationId} --note ${recovery.note}${recovery.namespace ? ` --namespace ${JSON.stringify(recovery.namespace)}` : ""}\n`);
|
|
60
|
+
process.stderr.write("Do not resend attachment bytes after an uncertain result; inspect the original operation first.\n");
|
|
61
|
+
}
|
|
62
|
+
const status = err?.status;
|
|
63
|
+
const body = err?.body;
|
|
64
|
+
let detail = err?.message ?? String(err);
|
|
65
|
+
if (body) {
|
|
66
|
+
try {
|
|
67
|
+
const parsed = JSON.parse(body);
|
|
68
|
+
if (parsed.message)
|
|
69
|
+
detail = parsed.message;
|
|
70
|
+
}
|
|
71
|
+
catch {
|
|
72
|
+
// Not JSON; the transport message is all there is.
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
if (status === 503 && recovery) {
|
|
76
|
+
// Preserve the existing busy exit code without the Notes body helper
|
|
77
|
+
// falsely diagnosing RTC or suggesting that attachment bytes be resent.
|
|
78
|
+
fail(detail);
|
|
79
|
+
return 4;
|
|
80
|
+
}
|
|
81
|
+
if (status === 409) {
|
|
82
|
+
fail(detail);
|
|
83
|
+
return EXIT_EXISTS;
|
|
84
|
+
}
|
|
85
|
+
if (status === 404 || status === 400 || status === 403) {
|
|
86
|
+
fail(detail);
|
|
87
|
+
return EXIT_NO_FILE;
|
|
88
|
+
}
|
|
89
|
+
return report(err);
|
|
90
|
+
}
|
|
91
|
+
function operationIdOf(value) {
|
|
92
|
+
return noteFileOperationId(value);
|
|
93
|
+
}
|
|
94
|
+
function keyValid(key) {
|
|
95
|
+
try {
|
|
96
|
+
validateNoteFileKey(key);
|
|
97
|
+
return true;
|
|
98
|
+
}
|
|
99
|
+
catch (error) {
|
|
100
|
+
fail(error.message);
|
|
101
|
+
return false;
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
function requireFileResult(row) {
|
|
105
|
+
if (!row || typeof row !== "object" || typeof row.id !== "string" || typeof row.path !== "string") {
|
|
106
|
+
throw new Error("Attachment response is unreadable; retain the original operation before recovery");
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
function showOperation(operationId) {
|
|
110
|
+
if (operationId)
|
|
111
|
+
process.stderr.write(`operation ${operationId}\n`);
|
|
112
|
+
}
|
|
113
|
+
/** Human-readable size, so a listing is scannable. */
|
|
114
|
+
function human(bytes) {
|
|
115
|
+
if (bytes < 1024)
|
|
116
|
+
return `${bytes}B`;
|
|
117
|
+
const units = ["K", "M", "G"];
|
|
118
|
+
let n = bytes / 1024;
|
|
119
|
+
let i = 0;
|
|
120
|
+
while (n >= 1024 && i < units.length - 1) {
|
|
121
|
+
n /= 1024;
|
|
122
|
+
i++;
|
|
123
|
+
}
|
|
124
|
+
return `${n < 10 ? n.toFixed(1) : Math.round(n)}${units[i]}`;
|
|
125
|
+
}
|
|
126
|
+
// ── list ─────────────────────────────────────────────────────────────────────
|
|
127
|
+
export async function runFilesList(glob, opts) {
|
|
128
|
+
const t = await target(opts);
|
|
129
|
+
if (!t)
|
|
130
|
+
return 1;
|
|
131
|
+
try {
|
|
132
|
+
const qs = new URLSearchParams();
|
|
133
|
+
if (glob)
|
|
134
|
+
qs.set("glob", glob);
|
|
135
|
+
if (opts.trashed)
|
|
136
|
+
qs.set("trashed", "true");
|
|
137
|
+
if (opts.contentType)
|
|
138
|
+
qs.set("contentType", opts.contentType);
|
|
139
|
+
if (opts.limit)
|
|
140
|
+
qs.set("limit", opts.limit);
|
|
141
|
+
if (opts.offset)
|
|
142
|
+
qs.set("offset", opts.offset);
|
|
143
|
+
const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}${qs.toString() ? `?${qs}` : ""}`, { token: t.c.token });
|
|
144
|
+
if (opts.json)
|
|
145
|
+
return emitJson(res), 0;
|
|
146
|
+
if (!res.files.length) {
|
|
147
|
+
process.stderr.write(opts.trashed ? "the trash is empty\n" : "no files\n");
|
|
148
|
+
return 0;
|
|
149
|
+
}
|
|
150
|
+
// Said when a page is not the whole set, on stderr so a piped listing is
|
|
151
|
+
// still only files. A caller that took a truncated list for everything
|
|
152
|
+
// would conclude a file is not there.
|
|
153
|
+
const shown = Number(opts.offset ?? 0) + res.files.length;
|
|
154
|
+
if (shown < res.total) {
|
|
155
|
+
process.stderr.write(`showing ${res.files.length} of ${res.total} — pass --offset ${shown} for the rest\n`);
|
|
156
|
+
}
|
|
157
|
+
const width = Math.max(...res.files.map((f) => f.path.length));
|
|
158
|
+
for (const f of res.files) {
|
|
159
|
+
// The id is printed because every other command takes one, and the
|
|
160
|
+
// preview kind because it is what decides whether a file can be shown
|
|
161
|
+
// at all — neither is derivable from the path.
|
|
162
|
+
process.stdout.write(`${f.path.padEnd(width)} ${human(f.sizeBytes).padStart(6)} ${f.contentType.padEnd(24)}` +
|
|
163
|
+
` ${f.previewKind ?? "-"} ${f.id}\n`);
|
|
164
|
+
}
|
|
165
|
+
return 0;
|
|
166
|
+
}
|
|
167
|
+
catch (e) {
|
|
168
|
+
return reportFile(e);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
// ── upload ───────────────────────────────────────────────────────────────────
|
|
172
|
+
export async function runFilesUpload(localPath, opts) {
|
|
173
|
+
const t = await target(opts);
|
|
174
|
+
if (!t)
|
|
175
|
+
return 1;
|
|
176
|
+
if (!existsSync(localPath)) {
|
|
177
|
+
fail(`no such file: ${localPath}`);
|
|
178
|
+
return EXIT_NO_FILE;
|
|
179
|
+
}
|
|
180
|
+
try {
|
|
181
|
+
// Streamed from disk, not read into memory. A large attachment should
|
|
182
|
+
// cost a buffer rather than its own size in resident memory, and a file
|
|
183
|
+
// bigger than the heap cannot be read at all.
|
|
184
|
+
//
|
|
185
|
+
// Never through a string on the way: that would corrupt every upload that
|
|
186
|
+
// is not valid UTF-8, silently.
|
|
187
|
+
// The two runtimes disagree about how a streamed body is sent. Node's
|
|
188
|
+
// fetch needs an explicit Content-Length (without one it falls back to
|
|
189
|
+
// chunked, which some proxies reject on a PUT). Bun's fetch *hangs* on a
|
|
190
|
+
// stream paired with one, over HTTP/2 — the request is never sent and the
|
|
191
|
+
// upload dies on the timeout. 0.23.0's fix was Bun.file(), a streamed
|
|
192
|
+
// body Bun does handle, which leaves an explicit Content-Type alone and
|
|
193
|
+
// still does not read the file into memory.
|
|
194
|
+
//
|
|
195
|
+
// This shipped broken in 0.23.0 because the published CLI is a compiled
|
|
196
|
+
// Bun binary while the npm package and the test suite run on Node, and
|
|
197
|
+
// api.dreamlake.ai is the HTTP/2 endpoint no local server imitates — so
|
|
198
|
+
// every check was green and every real upload timed out.
|
|
199
|
+
//
|
|
200
|
+
// The BunFile itself must not be the body. Observed on Bun 1.3.14, Linux,
|
|
201
|
+
// compiled standalone binary: a PUT carrying one crashes the runtime
|
|
202
|
+
// (SIGSEGV, varying address) once the response is in, when a GET on the
|
|
203
|
+
// same host preceded it — the shape the upload path takes, since resolving
|
|
204
|
+
// the note comes first. Whether every upload or another runtime, platform
|
|
205
|
+
// or build mode hits it was not established. `.stream()` reads the same
|
|
206
|
+
// file lazily, without loading it into memory, and did not crash.
|
|
207
|
+
// This code sets no Content-Length under Bun, unchanged from 0.24.5.
|
|
208
|
+
// Whether the HTTP/2 hang above can recur is a separate protocol
|
|
209
|
+
// question, not validated by this change.
|
|
210
|
+
const bun = globalThis.Bun;
|
|
211
|
+
const data = bun ? bun.file(localPath).stream() : createReadStream(localPath);
|
|
212
|
+
const remote = opts.path ?? path.basename(localPath);
|
|
213
|
+
const qs = new URLSearchParams({ path: remote });
|
|
214
|
+
if (opts.contentType)
|
|
215
|
+
qs.set("contentType", opts.contentType);
|
|
216
|
+
if (opts.overwrite)
|
|
217
|
+
qs.set("overwrite", "true");
|
|
218
|
+
const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/content?${qs}`, {
|
|
219
|
+
method: "PUT",
|
|
220
|
+
token: t.c.token,
|
|
221
|
+
body: data,
|
|
222
|
+
headers: {
|
|
223
|
+
"Content-Type": opts.contentType ?? "application/octet-stream",
|
|
224
|
+
...(bun ? {} : { "Content-Length": String(statSync(localPath).size) }),
|
|
225
|
+
},
|
|
226
|
+
});
|
|
227
|
+
if (opts.json)
|
|
228
|
+
return emitJson(res), 0;
|
|
229
|
+
process.stdout.write(`✓ ${res.path} (${human(res.sizeBytes)}, ${res.contentType})\n id ${res.id}\n`);
|
|
230
|
+
return 0;
|
|
231
|
+
}
|
|
232
|
+
catch (e) {
|
|
233
|
+
return reportFile(e);
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
// ── download ─────────────────────────────────────────────────────────────────
|
|
237
|
+
export async function runFilesDownload(ref, opts) {
|
|
238
|
+
const t = await target(opts);
|
|
239
|
+
if (!t)
|
|
240
|
+
return 1;
|
|
241
|
+
try {
|
|
242
|
+
const row = await resolveFile(t.c, t.id, ref);
|
|
243
|
+
if (!row)
|
|
244
|
+
return EXIT_NO_FILE;
|
|
245
|
+
// Destination decided BEFORE the transfer: refusing an overwrite after
|
|
246
|
+
// downloading the whole file wastes the transfer, and refusing it after
|
|
247
|
+
// opening the file for writing has already truncated it.
|
|
248
|
+
let dest = opts.output;
|
|
249
|
+
if (dest && dest !== "-") {
|
|
250
|
+
if (existsSync(dest) && statSync(dest).isDirectory()) {
|
|
251
|
+
dest = path.join(dest, row.path.split("/").pop());
|
|
252
|
+
}
|
|
253
|
+
if (existsSync(dest) && !opts.overwrite) {
|
|
254
|
+
// The one thing here DreamLake cannot undo.
|
|
255
|
+
fail(`${dest} already exists; pass --overwrite to replace it`);
|
|
256
|
+
return EXIT_EXISTS;
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
const res = await requestRaw(`${t.c.remote}${filesBase(t.c, t.id)}/${seg(row.id)}/content?redirect=false`, { token: t.c.token });
|
|
260
|
+
const body = res.body ? Readable.fromWeb(res.body) : Readable.from([]);
|
|
261
|
+
if (!dest || dest === "-") {
|
|
262
|
+
// To stdout, so it can be piped. Binary is fine; decoding it is not.
|
|
263
|
+
//
|
|
264
|
+
// `{end: false}` matters: pipeline closes its destination when the
|
|
265
|
+
// source finishes, and closing process.stdout silences everything the
|
|
266
|
+
// process prints afterwards — including, in a test runner sharing the
|
|
267
|
+
// process, every other test's output.
|
|
268
|
+
await pipeline(body, process.stdout, { end: false });
|
|
269
|
+
return 0;
|
|
270
|
+
}
|
|
271
|
+
mkdirSync(path.dirname(path.resolve(dest)), { recursive: true });
|
|
272
|
+
// Written beside the target and moved into place, so an interrupted
|
|
273
|
+
// download leaves the destination untouched rather than half a file that
|
|
274
|
+
// looks complete.
|
|
275
|
+
const partial = `${dest}.part`;
|
|
276
|
+
try {
|
|
277
|
+
await pipeline(body, createWriteStream(partial));
|
|
278
|
+
renameSync(partial, dest);
|
|
279
|
+
}
|
|
280
|
+
catch (e) {
|
|
281
|
+
rmSync(partial, { force: true });
|
|
282
|
+
throw e;
|
|
283
|
+
}
|
|
284
|
+
process.stderr.write(`✓ wrote ${dest} (${human(statSync(dest).size)})\n`);
|
|
285
|
+
return 0;
|
|
286
|
+
}
|
|
287
|
+
catch (e) {
|
|
288
|
+
return reportFile(e);
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
// ── read as text ─────────────────────────────────────────────────────────────
|
|
292
|
+
export async function runFilesCat(ref, opts) {
|
|
293
|
+
const t = await target(opts);
|
|
294
|
+
if (!t)
|
|
295
|
+
return 1;
|
|
296
|
+
try {
|
|
297
|
+
const row = await resolveFile(t.c, t.id, ref);
|
|
298
|
+
if (!row)
|
|
299
|
+
return EXIT_NO_FILE;
|
|
300
|
+
if (!row.text) {
|
|
301
|
+
// Refused here rather than at the server, so the reason names the local
|
|
302
|
+
// alternative instead of an HTTP status.
|
|
303
|
+
fail(`${row.path} is ${row.contentType}; printing it as text would corrupt it — ` +
|
|
304
|
+
"use 'notes files download' instead");
|
|
305
|
+
return EXIT_NO_FILE;
|
|
306
|
+
}
|
|
307
|
+
const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}/text`, { token: t.c.token });
|
|
308
|
+
if (opts.json)
|
|
309
|
+
return emitJson(res), 0;
|
|
310
|
+
process.stdout.write(res.text);
|
|
311
|
+
return 0;
|
|
312
|
+
}
|
|
313
|
+
catch (e) {
|
|
314
|
+
return reportFile(e);
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
// ── write text ───────────────────────────────────────────────────────────────
|
|
318
|
+
export async function runFilesWrite(remotePath, opts) {
|
|
319
|
+
if (!keyValid(opts.idempotencyKey))
|
|
320
|
+
return 1;
|
|
321
|
+
const t = await target(opts);
|
|
322
|
+
if (!t)
|
|
323
|
+
return 1;
|
|
324
|
+
const text = opts.text !== undefined
|
|
325
|
+
? opts.text
|
|
326
|
+
: opts.file
|
|
327
|
+
? readFileSync(opts.file, "utf-8")
|
|
328
|
+
: undefined;
|
|
329
|
+
if (text === undefined) {
|
|
330
|
+
fail("say what to write: --text or --file");
|
|
331
|
+
return 1;
|
|
332
|
+
}
|
|
333
|
+
let operationId;
|
|
334
|
+
try {
|
|
335
|
+
const res = await requestJson(t.c.remote, filesBase(t.c, t.id), {
|
|
336
|
+
method: "POST",
|
|
337
|
+
token: t.c.token,
|
|
338
|
+
json: {
|
|
339
|
+
path: remotePath,
|
|
340
|
+
text,
|
|
341
|
+
overwrite: Boolean(opts.overwrite),
|
|
342
|
+
...(opts.contentType ? { contentType: opts.contentType } : {}),
|
|
343
|
+
},
|
|
344
|
+
headers: { ...(opts.ifMatch ? { "If-Match": opts.ifMatch } : {}),
|
|
345
|
+
...(opts.idempotencyKey !== undefined ? { "Idempotency-Key": opts.idempotencyKey } : {}) },
|
|
346
|
+
redirect: "manual",
|
|
347
|
+
onHeaders: headers => { operationId = operationIdOf(headers.get("Note-File-Operation-Id")); },
|
|
348
|
+
});
|
|
349
|
+
requireFileResult(res);
|
|
350
|
+
if (opts.json)
|
|
351
|
+
return emitJson({ ...res, ...(operationId ? { operationId } : {}) }), 0;
|
|
352
|
+
showOperation(operationId);
|
|
353
|
+
process.stdout.write(`✓ ${res.path} (${human(res.sizeBytes)})\n etag ${res.etag}\n`);
|
|
354
|
+
return 0;
|
|
355
|
+
}
|
|
356
|
+
catch (e) {
|
|
357
|
+
return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
// ── move / copy ──────────────────────────────────────────────────────────────
|
|
361
|
+
export async function runFilesMove(ref, to, opts) {
|
|
362
|
+
const t = await target(opts);
|
|
363
|
+
if (!t)
|
|
364
|
+
return 1;
|
|
365
|
+
try {
|
|
366
|
+
const row = await resolveFile(t.c, t.id, ref);
|
|
367
|
+
if (!row)
|
|
368
|
+
return EXIT_NO_FILE;
|
|
369
|
+
const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}`, {
|
|
370
|
+
method: "PATCH",
|
|
371
|
+
token: t.c.token,
|
|
372
|
+
json: { path: to, overwrite: Boolean(opts.overwrite) },
|
|
373
|
+
headers: opts.ifMatch ? { "If-Match": opts.ifMatch } : {},
|
|
374
|
+
});
|
|
375
|
+
if (opts.json)
|
|
376
|
+
return emitJson(res), 0;
|
|
377
|
+
process.stdout.write(`✓ ${row.path} -> ${res.path}\n`);
|
|
378
|
+
return 0;
|
|
379
|
+
}
|
|
380
|
+
catch (e) {
|
|
381
|
+
return reportFile(e);
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
export async function runFilesCopy(ref, to, opts) {
|
|
385
|
+
if (!keyValid(opts.idempotencyKey))
|
|
386
|
+
return 1;
|
|
387
|
+
const t = await target(opts);
|
|
388
|
+
if (!t)
|
|
389
|
+
return 1;
|
|
390
|
+
let operationId;
|
|
391
|
+
try {
|
|
392
|
+
const row = await resolveFile(t.c, t.id, ref);
|
|
393
|
+
if (!row)
|
|
394
|
+
return EXIT_NO_FILE;
|
|
395
|
+
const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}/copy`, {
|
|
396
|
+
method: "POST",
|
|
397
|
+
token: t.c.token,
|
|
398
|
+
json: { path: to, overwrite: Boolean(opts.overwrite) },
|
|
399
|
+
headers: opts.idempotencyKey !== undefined ? { "Idempotency-Key": opts.idempotencyKey } : {},
|
|
400
|
+
redirect: "manual",
|
|
401
|
+
onHeaders: headers => { operationId = operationIdOf(headers.get("Note-File-Operation-Id")); },
|
|
402
|
+
});
|
|
403
|
+
requireFileResult(res);
|
|
404
|
+
if (opts.json)
|
|
405
|
+
return emitJson({ ...res, ...(operationId ? { operationId } : {}) }), 0;
|
|
406
|
+
showOperation(operationId);
|
|
407
|
+
process.stdout.write(`✓ copied to ${res.path}\n id ${res.id}\n`);
|
|
408
|
+
return 0;
|
|
409
|
+
}
|
|
410
|
+
catch (e) {
|
|
411
|
+
return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
|
|
412
|
+
}
|
|
413
|
+
}
|
|
414
|
+
// ── publication recovery ────────────────────────────────────────────────────
|
|
415
|
+
export async function runFilesOperation(action, operationId, opts) {
|
|
416
|
+
if (!operationIdOf(operationId)) {
|
|
417
|
+
fail("operation must be a 24-character hexadecimal ID");
|
|
418
|
+
return EXIT_NO_FILE;
|
|
419
|
+
}
|
|
420
|
+
const t = await target(opts);
|
|
421
|
+
if (!t)
|
|
422
|
+
return 1;
|
|
423
|
+
try {
|
|
424
|
+
const suffix = action === "status" ? "" : action === "cancel" ? "/abort" : "/reconcile";
|
|
425
|
+
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" });
|
|
426
|
+
if (!result || !operationIdOf(result.operationId) || result.operationId.toLowerCase() !== operationId.toLowerCase() ||
|
|
427
|
+
!["admitted", "write-started", "published", "aborted-before-write"].includes(result.state) ||
|
|
428
|
+
typeof result.historicalResult !== "boolean")
|
|
429
|
+
throw new Error("Attachment operation response is unreadable");
|
|
430
|
+
if (opts.json)
|
|
431
|
+
return emitJson(result), 0;
|
|
432
|
+
process.stdout.write(`${result.operationId} ${result.state}${result.historicalResult ? " (historical receipt)" : ""}\n`);
|
|
433
|
+
return 0;
|
|
434
|
+
}
|
|
435
|
+
catch (e) {
|
|
436
|
+
return reportFile(e, { operationId, note: t.id, namespace: t.c.ns });
|
|
437
|
+
}
|
|
438
|
+
}
|
|
439
|
+
// ── trash / restore ──────────────────────────────────────────────────────────
|
|
440
|
+
export async function runFilesRm(ref, opts) {
|
|
441
|
+
const t = await target(opts);
|
|
442
|
+
if (!t)
|
|
443
|
+
return 1;
|
|
444
|
+
try {
|
|
445
|
+
const row = await resolveFile(t.c, t.id, ref, { includeTrashed: true });
|
|
446
|
+
if (!row)
|
|
447
|
+
return EXIT_NO_FILE;
|
|
448
|
+
const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(row.id)}?purge=${opts.purge ? "true" : "false"}`, {
|
|
449
|
+
method: "DELETE",
|
|
450
|
+
token: t.c.token,
|
|
451
|
+
headers: opts.ifMatch ? { "If-Match": opts.ifMatch } : {},
|
|
452
|
+
});
|
|
453
|
+
if (opts.json)
|
|
454
|
+
return emitJson(res), 0;
|
|
455
|
+
process.stdout.write(res.purged
|
|
456
|
+
? `✓ purged ${row.path} — the bytes are gone\n`
|
|
457
|
+
: `✓ trashed ${row.path} — restore with 'notes files restore ${row.id}'\n`);
|
|
458
|
+
return 0;
|
|
459
|
+
}
|
|
460
|
+
catch (e) {
|
|
461
|
+
return reportFile(e);
|
|
462
|
+
}
|
|
463
|
+
}
|
|
464
|
+
export async function runFilesRestore(ref, opts) {
|
|
465
|
+
const t = await target(opts);
|
|
466
|
+
if (!t)
|
|
467
|
+
return 1;
|
|
468
|
+
try {
|
|
469
|
+
const res = await requestJson(t.c.remote, `${filesBase(t.c, t.id)}/${seg(ref)}/restore`, {
|
|
470
|
+
method: "POST",
|
|
471
|
+
token: t.c.token,
|
|
472
|
+
json: opts.path ? { path: opts.path } : {},
|
|
473
|
+
});
|
|
474
|
+
if (opts.json)
|
|
475
|
+
return emitJson(res), 0;
|
|
476
|
+
process.stdout.write(`✓ restored ${res.path}\n`);
|
|
477
|
+
return 0;
|
|
478
|
+
}
|
|
479
|
+
catch (e) {
|
|
480
|
+
return reportFile(e);
|
|
481
|
+
}
|
|
482
|
+
}
|
|
483
|
+
// ── shared ───────────────────────────────────────────────────────────────────
|
|
484
|
+
/**
|
|
485
|
+
* Accept an id OR a path, because both are things a person has in hand.
|
|
486
|
+
*
|
|
487
|
+
* A path is looked up in the listing; an id is used as it is. An ambiguous
|
|
488
|
+
* input cannot happen — an id is an ObjectId and a path is not — so this never
|
|
489
|
+
* has to guess.
|
|
490
|
+
*/
|
|
491
|
+
export async function resolveFile(c, noteId, ref, opts = {}) {
|
|
492
|
+
try {
|
|
493
|
+
return await noteFilesApi(noteTransport(c), `/namespaces/${seg(c.ns)}/notes/${seg(noteId)}`).resolve(ref, opts.includeTrashed);
|
|
494
|
+
}
|
|
495
|
+
catch (error) {
|
|
496
|
+
if (error.status !== 404)
|
|
497
|
+
throw error;
|
|
498
|
+
fail(/^[a-f0-9]{24}$/i.test(ref) ? `no file with id ${ref}` : `no file at '${ref}' — 'notes files list --note …' shows what is there`);
|
|
499
|
+
return null;
|
|
500
|
+
}
|
|
501
|
+
}
|
|
502
|
+
/**
|
|
503
|
+
* `dreamlake notes files preview <file> --note N [--share] [--open]`
|
|
504
|
+
*
|
|
505
|
+
* Prints a link that renders the file. The default needs the reader signed in
|
|
506
|
+
* and grants nothing by itself; `--share` returns one that works without
|
|
507
|
+
* signing in and lasts until `--revoke` withdraws it.
|
|
508
|
+
*
|
|
509
|
+
* The URL goes to stdout alone so it can be piped or copied; everything else
|
|
510
|
+
* is on stderr.
|
|
511
|
+
*/
|
|
512
|
+
export async function runFilesPreview(ref, opts) {
|
|
513
|
+
const t = await target(opts);
|
|
514
|
+
if (!t)
|
|
515
|
+
return 1;
|
|
516
|
+
try {
|
|
517
|
+
const row = await resolveFile(t.c, t.id, ref);
|
|
518
|
+
if (!row)
|
|
519
|
+
return EXIT_NO_FILE;
|
|
520
|
+
const base = `${filesBase(t.c, t.id)}/${seg(row.id)}/preview`;
|
|
521
|
+
if (opts.revoke) {
|
|
522
|
+
await requestJson(t.c.remote, base, {
|
|
523
|
+
method: "DELETE",
|
|
524
|
+
token: t.c.token,
|
|
525
|
+
});
|
|
526
|
+
process.stderr.write(`✓ withdrew the shared link for ${row.path}\n`);
|
|
527
|
+
return 0;
|
|
528
|
+
}
|
|
529
|
+
const res = await requestJson(t.c.remote, `${base}${opts.share ? "?share=true" : ""}`, { token: t.c.token });
|
|
530
|
+
if (opts.json)
|
|
531
|
+
return emitJson(res), 0;
|
|
532
|
+
process.stdout.write(`${res.url}\n`);
|
|
533
|
+
// Which kind of link this is decides what the reader has to do, so it is
|
|
534
|
+
// said rather than left to be discovered by sending the wrong one.
|
|
535
|
+
process.stderr.write(res.kind === "shared"
|
|
536
|
+
? "shared link — opens without signing in, until you revoke it\n"
|
|
537
|
+
: "session link — whoever opens it must be signed in and able to read the note\n");
|
|
538
|
+
if (opts.open) {
|
|
539
|
+
const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
|
|
540
|
+
const { spawn } = await import("node:child_process");
|
|
541
|
+
spawn(cmd, [res.url], { stdio: "ignore", detached: true }).unref();
|
|
542
|
+
}
|
|
543
|
+
return 0;
|
|
544
|
+
}
|
|
545
|
+
catch (e) {
|
|
546
|
+
return reportFile(e);
|
|
547
|
+
}
|
|
548
|
+
}
|
|
@@ -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 = { "&": "&", "<": "<", ">": ">", """: '"', "'": "'" };
|
|
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
|
+
}
|