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