@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,463 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Deleting managed objects and managed prefixes.
|
|
3
|
+
*
|
|
4
|
+
* Contract: api-contract §10. Two endpoints with genuinely different execution
|
|
5
|
+
* models, so two commands rather than one with `-r`:
|
|
6
|
+
*
|
|
7
|
+
* - `delete-object` is synchronous and physical. One object, `204`, done.
|
|
8
|
+
* - `delete-prefix` queues an operation and returns its id. It is not atomic,
|
|
9
|
+
* it records failure so it can be retried, and the retry reuses the same
|
|
10
|
+
* operation record rather than making a second one.
|
|
11
|
+
*
|
|
12
|
+
* A flag would have implied those are the same thing with a different scope.
|
|
13
|
+
* They are not: one returns a result, the other returns a handle.
|
|
14
|
+
*
|
|
15
|
+
* What deletion does NOT let this command claim is as important as what it
|
|
16
|
+
* does. Removing an internal object can uncover an external one at the same
|
|
17
|
+
* path, so "deleted" does not mean "gone" and a listing may be the same length
|
|
18
|
+
* afterwards. The server does not report whether anything reappeared, so
|
|
19
|
+
* neither does this.
|
|
20
|
+
*/
|
|
21
|
+
import { randomUUID } from "node:crypto";
|
|
22
|
+
import { requestJson } from "../client.js";
|
|
23
|
+
import { emitJson, fail } from "../helpers.js";
|
|
24
|
+
import { bad, ctx, isObject, resolveSource, strictArgs, seg, } from "./index.js";
|
|
25
|
+
import { explainWrite } from "./write.js";
|
|
26
|
+
const MAX_IDEMPOTENCY_KEY = 255;
|
|
27
|
+
const STATES = ["queued", "running", "failed", "succeeded"];
|
|
28
|
+
/**
|
|
29
|
+
* The 202 from `managed-directory-deletions`.
|
|
30
|
+
*
|
|
31
|
+
* Two fields, and neither of them is `id`. Validating this with the full
|
|
32
|
+
* operation shape rejects every real response — the endpoint does not send
|
|
33
|
+
* `id`, `path` or `sourceId` — so the command would fail on a server that
|
|
34
|
+
* behaved exactly as specified.
|
|
35
|
+
*/
|
|
36
|
+
export function assertCreatedOperation(res, where) {
|
|
37
|
+
if (!isObject(res))
|
|
38
|
+
bad(`${where}: expected an object`);
|
|
39
|
+
if (typeof res.operationId !== "string" || res.operationId === "") {
|
|
40
|
+
bad(`${where}: missing operationId`);
|
|
41
|
+
}
|
|
42
|
+
// The contract fixes this literal. A different state here would mean the
|
|
43
|
+
// server did something other than queue the deletion.
|
|
44
|
+
if (res.state !== "queued")
|
|
45
|
+
bad(`${where}: expected state 'queued'`);
|
|
46
|
+
return res;
|
|
47
|
+
}
|
|
48
|
+
function isNonNegativeInteger(v) {
|
|
49
|
+
return typeof v === "number" && Number.isSafeInteger(v) && v >= 0;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* A full operation, as `GET` and `:retry` return it.
|
|
53
|
+
*
|
|
54
|
+
* `expectedId` is required rather than optional: both callers know which
|
|
55
|
+
* operation they asked about, and an answer describing a different one is not
|
|
56
|
+
* an answer to their question. Accepting it would let a poll silently follow
|
|
57
|
+
* the server to another record — and from `:retry` it would mean a second
|
|
58
|
+
* operation was created, which §10 says never happens and which is where the
|
|
59
|
+
* fencing token comes from.
|
|
60
|
+
*/
|
|
61
|
+
export function assertOperation(res, where, expectedId) {
|
|
62
|
+
if (!isObject(res))
|
|
63
|
+
bad(`${where}: expected an object`);
|
|
64
|
+
if (typeof res.id !== "string" || res.id === "")
|
|
65
|
+
bad(`${where}: missing id`);
|
|
66
|
+
if (res.id !== expectedId)
|
|
67
|
+
bad(`${where}: answered about ${res.id}, not ${expectedId}`);
|
|
68
|
+
if (typeof res.path !== "string")
|
|
69
|
+
bad(`${where}: missing path`);
|
|
70
|
+
if (!STATES.includes(res.state))
|
|
71
|
+
bad(`${where}: unknown state`);
|
|
72
|
+
/*
|
|
73
|
+
* Counts are non-negative integers (§4's identical rule for lifecycle
|
|
74
|
+
* counts, and for the same reason): a count comes from counting, and
|
|
75
|
+
* counting produces neither negatives nor fractions. A value that did would
|
|
76
|
+
* be printed to the caller as though someone had counted it.
|
|
77
|
+
*/
|
|
78
|
+
if (res.deletedCount !== undefined && !isNonNegativeInteger(res.deletedCount)) {
|
|
79
|
+
bad(`${where}: deletedCount must be a non-negative integer`);
|
|
80
|
+
}
|
|
81
|
+
// Validated because it is PRINTED. An error object missing its code is not
|
|
82
|
+
// something to render half of.
|
|
83
|
+
if (res.safeError !== undefined) {
|
|
84
|
+
const e = res.safeError;
|
|
85
|
+
if (!isObject(e))
|
|
86
|
+
bad(`${where}.safeError: expected an object`);
|
|
87
|
+
if (typeof e.code !== "string" || e.code === "")
|
|
88
|
+
bad(`${where}.safeError: missing code`);
|
|
89
|
+
if (typeof e.message !== "string")
|
|
90
|
+
bad(`${where}.safeError: missing message`);
|
|
91
|
+
if (typeof e.retryable !== "boolean")
|
|
92
|
+
bad(`${where}.safeError: missing retryable`);
|
|
93
|
+
if (typeof e.requestId !== "string")
|
|
94
|
+
bad(`${where}.safeError: missing requestId`);
|
|
95
|
+
}
|
|
96
|
+
return res;
|
|
97
|
+
}
|
|
98
|
+
function idempotencyKey(override) {
|
|
99
|
+
// Absent means "a new command, invent an identity". An explicit empty value
|
|
100
|
+
// means "the same command as before", and inventing one there turns what the
|
|
101
|
+
// caller believed was a retry into a second request.
|
|
102
|
+
if (override === undefined)
|
|
103
|
+
return { ok: true, key: randomUUID() };
|
|
104
|
+
const key = override.trim();
|
|
105
|
+
if (key === "") {
|
|
106
|
+
fail("--idempotency-key is empty — omit it to start a new command");
|
|
107
|
+
return { ok: false };
|
|
108
|
+
}
|
|
109
|
+
if (key.length > MAX_IDEMPOTENCY_KEY) {
|
|
110
|
+
fail(`--idempotency-key is longer than ${MAX_IDEMPOTENCY_KEY} characters`);
|
|
111
|
+
return { ok: false };
|
|
112
|
+
}
|
|
113
|
+
return { ok: true, key };
|
|
114
|
+
}
|
|
115
|
+
function neverAnswered(err) {
|
|
116
|
+
if (err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError")) {
|
|
117
|
+
return true;
|
|
118
|
+
}
|
|
119
|
+
return err instanceof TypeError;
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* What a caller can conclude from a successful delete, and what they cannot.
|
|
123
|
+
*
|
|
124
|
+
* §10: "删除后下层external可显露". So the object is gone and the PATH may not
|
|
125
|
+
* be. Saying "deleted" alone invites someone to browse, still see the name, and
|
|
126
|
+
* conclude the command failed. Saying external content HAS appeared would be
|
|
127
|
+
* inventing a fact the server never reported — it returns `204` and nothing
|
|
128
|
+
* else.
|
|
129
|
+
*/
|
|
130
|
+
const UNCOVER_NOTE = " The path may still resolve: deleting a managed object can uncover external\n" +
|
|
131
|
+
" content that was hidden underneath it.";
|
|
132
|
+
// ── source delete-object ──────────────────────────────────────────────────────
|
|
133
|
+
export async function runDeleteObject(path, opts) {
|
|
134
|
+
const c = await ctx(opts.namespace);
|
|
135
|
+
if (!c)
|
|
136
|
+
return 1;
|
|
137
|
+
const key = idempotencyKey(opts.idempotencyKey);
|
|
138
|
+
if (!key.ok)
|
|
139
|
+
return 1;
|
|
140
|
+
try {
|
|
141
|
+
const source = await resolveSource(c, opts.source);
|
|
142
|
+
// `requestJson` returns undefined for an empty body, which is what a 204
|
|
143
|
+
// is. `requestRaw` is for signed capability reads and only speaks GET/HEAD.
|
|
144
|
+
await requestJson(c.remote, `/namespaces/${seg(c.ns)}/sources/${seg(source.id)}/managed-object`, {
|
|
145
|
+
method: "DELETE",
|
|
146
|
+
token: c.token,
|
|
147
|
+
query: { path },
|
|
148
|
+
headers: { "Idempotency-Key": key.key },
|
|
149
|
+
});
|
|
150
|
+
if (opts.json) {
|
|
151
|
+
// The same fact the directory JSON carries, and the same fact the human
|
|
152
|
+
// line carries. A reader should not have to know which command produced
|
|
153
|
+
// the object to learn whether the path might still resolve.
|
|
154
|
+
emitJson({ deleted: path, pathMayStillResolve: true });
|
|
155
|
+
}
|
|
156
|
+
else
|
|
157
|
+
process.stdout.write(`Deleted managed object '${path}'\n${UNCOVER_NOTE}\n`);
|
|
158
|
+
return 0;
|
|
159
|
+
}
|
|
160
|
+
catch (err) {
|
|
161
|
+
if (neverAnswered(err)) {
|
|
162
|
+
/*
|
|
163
|
+
* §10 is explicit that this command is not exactly-once: it spans MongoDB
|
|
164
|
+
* and object storage, and in the residual window a repeat with the same
|
|
165
|
+
* key can flip from success to `SOURCE_EXTERNAL_READ_ONLY` because the
|
|
166
|
+
* external layer has re-emerged. So the key is offered, and nothing is
|
|
167
|
+
* retried automatically.
|
|
168
|
+
*/
|
|
169
|
+
fail(`${explainWrite(err)}\n` +
|
|
170
|
+
` The server may or may not have deleted it. Retry with the SAME key:\n` +
|
|
171
|
+
` --idempotency-key ${key.key}`);
|
|
172
|
+
return 1;
|
|
173
|
+
}
|
|
174
|
+
/*
|
|
175
|
+
* The server's own words, and no second attempt.
|
|
176
|
+
*
|
|
177
|
+
* `SOURCE_EXTERNAL_READ_ONLY` says this path is not deletable by this
|
|
178
|
+
* product at all — not that a different endpoint would work — and §10 fixes
|
|
179
|
+
* the decision order so that answer is never a mis-classified kind
|
|
180
|
+
* conflict. Repeating it, or reaching for the directory endpoint on the
|
|
181
|
+
* caller's behalf, would act on a guess about which one they meant.
|
|
182
|
+
*/
|
|
183
|
+
fail(explainWrite(err));
|
|
184
|
+
return 1;
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
// ── source delete-prefix ──────────────────────────────────────────────────────
|
|
188
|
+
/**
|
|
189
|
+
* `pathMayStillResolve` is a field, not a sentence.
|
|
190
|
+
*
|
|
191
|
+
* The human branch has always said it; a script reading `--json` had no way to
|
|
192
|
+
* learn it, and `delete-status` on a finished operation did not say it at all.
|
|
193
|
+
* It is true of every SUCCESSFUL managed deletion — §10: the external layer
|
|
194
|
+
* underneath can re-emerge — and false of one that did not delete anything, so
|
|
195
|
+
* it is derived from the state rather than pasted onto every response.
|
|
196
|
+
*/
|
|
197
|
+
function operationJson(op, extra = {}) {
|
|
198
|
+
return {
|
|
199
|
+
operationId: op.id,
|
|
200
|
+
path: op.path,
|
|
201
|
+
state: op.state,
|
|
202
|
+
...(op.deletedCount === undefined ? {} : { deletedCount: op.deletedCount }),
|
|
203
|
+
/*
|
|
204
|
+
* Projected, not forwarded.
|
|
205
|
+
*
|
|
206
|
+
* The validator checks four fields; spreading the object publishes whatever
|
|
207
|
+
* else the server attached — a provider URL, an upstream detail — through a
|
|
208
|
+
* client that never decided to. Only what was verified is emitted, so a new
|
|
209
|
+
* field arrives by someone adding it here rather than by nobody noticing.
|
|
210
|
+
*/
|
|
211
|
+
...(op.safeError === undefined
|
|
212
|
+
? {}
|
|
213
|
+
: {
|
|
214
|
+
error: {
|
|
215
|
+
code: op.safeError.code,
|
|
216
|
+
message: op.safeError.message,
|
|
217
|
+
retryable: op.safeError.retryable,
|
|
218
|
+
requestId: op.safeError.requestId,
|
|
219
|
+
},
|
|
220
|
+
}),
|
|
221
|
+
...(op.state === "succeeded" ? { pathMayStillResolve: true } : {}),
|
|
222
|
+
...extra,
|
|
223
|
+
};
|
|
224
|
+
}
|
|
225
|
+
function reportOperation(op, json, prefix) {
|
|
226
|
+
if (json) {
|
|
227
|
+
emitJson(operationJson(op));
|
|
228
|
+
return;
|
|
229
|
+
}
|
|
230
|
+
process.stdout.write(`${prefix} ${op.id}\n path ${op.path}\n state ${op.state}\n`);
|
|
231
|
+
if (op.deletedCount !== undefined) {
|
|
232
|
+
process.stdout.write(` deleted ${op.deletedCount} object(s)\n`);
|
|
233
|
+
}
|
|
234
|
+
if (op.safeError) {
|
|
235
|
+
process.stdout.write(` error ${op.safeError.code} ${op.safeError.message}\n`);
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
/** How long `--wait` will watch before handing the operation back. */
|
|
239
|
+
export const WAIT_TIMEOUT_MS = 10 * 60 * 1000;
|
|
240
|
+
const POLL_MS = 2_000;
|
|
241
|
+
async function readOperation(c, operationId) {
|
|
242
|
+
return assertOperation(await requestJson(c.remote, `/namespaces/${seg(c.ns)}/managed-directory-delete-operations/${seg(operationId)}`, { token: c.token }), "operation", operationId);
|
|
243
|
+
}
|
|
244
|
+
export async function runDeletePrefix(path, opts) {
|
|
245
|
+
const c = await ctx(opts.namespace);
|
|
246
|
+
if (!c)
|
|
247
|
+
return 1;
|
|
248
|
+
const key = idempotencyKey(opts.idempotencyKey);
|
|
249
|
+
if (!key.ok)
|
|
250
|
+
return 1;
|
|
251
|
+
let created;
|
|
252
|
+
try {
|
|
253
|
+
const source = await resolveSource(c, opts.source);
|
|
254
|
+
created = assertCreatedOperation(await requestJson(c.remote, `/namespaces/${seg(c.ns)}/sources/${seg(source.id)}/managed-directory-deletions`, {
|
|
255
|
+
method: "POST",
|
|
256
|
+
token: c.token,
|
|
257
|
+
headers: { "Idempotency-Key": key.key },
|
|
258
|
+
json: { path },
|
|
259
|
+
}), "managed-directory-deletions");
|
|
260
|
+
}
|
|
261
|
+
catch (err) {
|
|
262
|
+
if (neverAnswered(err)) {
|
|
263
|
+
fail(`${explainWrite(err)}\n` +
|
|
264
|
+
` The server may or may not have queued it. Retry with the SAME key:\n` +
|
|
265
|
+
` --idempotency-key ${key.key}`);
|
|
266
|
+
return 1;
|
|
267
|
+
}
|
|
268
|
+
// An external winner returns this and creates NO operation (§10), so there
|
|
269
|
+
// is no handle to report and nothing was started.
|
|
270
|
+
fail(explainWrite(err));
|
|
271
|
+
return 1;
|
|
272
|
+
}
|
|
273
|
+
/*
|
|
274
|
+
* The handle, before anything that can be interrupted — on stderr under
|
|
275
|
+
* `--json`.
|
|
276
|
+
*
|
|
277
|
+
* `--wait` polls, and a caller who presses Ctrl-C during the poll must still
|
|
278
|
+
* be holding the operation id, or the command started work they can no longer
|
|
279
|
+
* name, check, or retry. Under `--json` that line cannot go to stdout: the
|
|
280
|
+
* promise there is that stdout parses whole, and a handle printed beside the
|
|
281
|
+
* final object would break every reader of it.
|
|
282
|
+
*/
|
|
283
|
+
const announce = `Queued directory deletion ${created.operationId}\n path ${path}\n`;
|
|
284
|
+
/*
|
|
285
|
+
* Only the WAITING JSON caller needs this on stderr.
|
|
286
|
+
*
|
|
287
|
+
* Without `--wait` the id is already in the object on stdout, and there is
|
|
288
|
+
* nothing to interrupt — a second copy on stderr would be noise the caller
|
|
289
|
+
* has to explain to their own logs.
|
|
290
|
+
*/
|
|
291
|
+
if (!opts.json)
|
|
292
|
+
process.stdout.write(announce);
|
|
293
|
+
else if (opts.wait)
|
|
294
|
+
process.stderr.write(announce);
|
|
295
|
+
if (!opts.wait) {
|
|
296
|
+
if (opts.json) {
|
|
297
|
+
emitJson({ operationId: created.operationId, path, state: created.state });
|
|
298
|
+
}
|
|
299
|
+
else {
|
|
300
|
+
process.stdout.write(` state ${created.state}\n` +
|
|
301
|
+
` Check it with:\n` +
|
|
302
|
+
` dreamlake source delete-status ${created.operationId}\n${UNCOVER_NOTE}\n`);
|
|
303
|
+
}
|
|
304
|
+
return 0;
|
|
305
|
+
}
|
|
306
|
+
const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
|
|
307
|
+
const now = opts.now ?? (() => Date.now());
|
|
308
|
+
const deadline = now() + WAIT_TIMEOUT_MS;
|
|
309
|
+
let latest = null;
|
|
310
|
+
let state = created.state;
|
|
311
|
+
while (state === "queued" || state === "running") {
|
|
312
|
+
if (now() >= deadline) {
|
|
313
|
+
/*
|
|
314
|
+
* A bounded wait, and the handle again on the way out.
|
|
315
|
+
*
|
|
316
|
+
* Waiting forever turns a command that succeeded into one that appears
|
|
317
|
+
* hung, and the operation is still perfectly checkable — so the timeout
|
|
318
|
+
* hands the handle back rather than failing the deletion. Under `--json`
|
|
319
|
+
* that has to be the one object on stdout, with the fact that the wait
|
|
320
|
+
* gave up stated as a field rather than as prose nobody can parse.
|
|
321
|
+
*/
|
|
322
|
+
if (opts.json) {
|
|
323
|
+
emitJson(latest
|
|
324
|
+
? operationJson(latest, { waitTimedOut: true })
|
|
325
|
+
: { operationId: created.operationId, path, state, waitTimedOut: true });
|
|
326
|
+
}
|
|
327
|
+
else {
|
|
328
|
+
process.stdout.write(` still ${state} after ${Math.round(WAIT_TIMEOUT_MS / 1000)}s — check it with:\n` +
|
|
329
|
+
` dreamlake source delete-status ${created.operationId}\n`);
|
|
330
|
+
}
|
|
331
|
+
return 0;
|
|
332
|
+
}
|
|
333
|
+
await sleep(POLL_MS);
|
|
334
|
+
try {
|
|
335
|
+
latest = await readOperation(c, created.operationId);
|
|
336
|
+
state = latest.state;
|
|
337
|
+
}
|
|
338
|
+
catch (err) {
|
|
339
|
+
// The deletion is running regardless of whether this poll worked.
|
|
340
|
+
fail(`${explainWrite(err)}\n` +
|
|
341
|
+
` The deletion is still ${state}. Check it with:\n` +
|
|
342
|
+
` dreamlake source delete-status ${created.operationId}`);
|
|
343
|
+
return 1;
|
|
344
|
+
}
|
|
345
|
+
}
|
|
346
|
+
// The loop only exits on a terminal state, which only a poll can produce.
|
|
347
|
+
if (!latest)
|
|
348
|
+
return 0;
|
|
349
|
+
reportOperation(latest, opts.json === true, "Directory deletion");
|
|
350
|
+
if (!opts.json && latest.state === "succeeded")
|
|
351
|
+
process.stdout.write(`${UNCOVER_NOTE}\n`);
|
|
352
|
+
// A failed operation is a real failure, and Retry is the way forward — the
|
|
353
|
+
// command does not start a second one.
|
|
354
|
+
if (latest.state === "failed") {
|
|
355
|
+
if (!opts.json) {
|
|
356
|
+
process.stdout.write(` Retry it with:\n dreamlake source delete-retry ${latest.id}\n`);
|
|
357
|
+
}
|
|
358
|
+
return 1;
|
|
359
|
+
}
|
|
360
|
+
return 0;
|
|
361
|
+
}
|
|
362
|
+
// ── source delete-status ──────────────────────────────────────────────────────
|
|
363
|
+
export async function runDeleteStatus(operationId, opts) {
|
|
364
|
+
const c = await ctx(opts.namespace);
|
|
365
|
+
if (!c)
|
|
366
|
+
return 1;
|
|
367
|
+
try {
|
|
368
|
+
const op = await readOperation(c, operationId);
|
|
369
|
+
reportOperation(op, opts.json === true, "Directory deletion");
|
|
370
|
+
// Reading the state and waiting for it should teach the same thing: the
|
|
371
|
+
// managed content is gone and the path may not be.
|
|
372
|
+
if (!opts.json && op.state === "succeeded")
|
|
373
|
+
process.stdout.write(`${UNCOVER_NOTE}\n`);
|
|
374
|
+
return op.state === "failed" ? 1 : 0;
|
|
375
|
+
}
|
|
376
|
+
catch (err) {
|
|
377
|
+
fail(explainWrite(err));
|
|
378
|
+
return 1;
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
// ── source delete-retry ───────────────────────────────────────────────────────
|
|
382
|
+
export async function runDeleteRetry(operationId, opts) {
|
|
383
|
+
const c = await ctx(opts.namespace);
|
|
384
|
+
if (!c)
|
|
385
|
+
return 1;
|
|
386
|
+
const key = idempotencyKey(opts.idempotencyKey);
|
|
387
|
+
if (!key.ok)
|
|
388
|
+
return 1;
|
|
389
|
+
try {
|
|
390
|
+
/*
|
|
391
|
+
* The server's retry, not a new deletion.
|
|
392
|
+
*
|
|
393
|
+
* §10: this never creates a second operation record — the same one goes
|
|
394
|
+
* from `failed` back to `queued` with its attempt incremented, and that
|
|
395
|
+
* counter is the fencing token that stops two workers deleting one prefix.
|
|
396
|
+
* Posting `managed-directory-deletions` again would defeat exactly that.
|
|
397
|
+
*/
|
|
398
|
+
const op = assertOperation(await requestJson(c.remote, `/namespaces/${seg(c.ns)}/managed-directory-delete-operations/${seg(operationId)}:retry`, { method: "POST", token: c.token, headers: { "Idempotency-Key": key.key } }), "retry",
|
|
399
|
+
/*
|
|
400
|
+
* The same record has to come back.
|
|
401
|
+
*
|
|
402
|
+
* A different id means a second operation exists, which is the one thing
|
|
403
|
+
* §10 says retry never does — and the attempt counter that fences two
|
|
404
|
+
* workers off one prefix belongs to the first record, so the new one
|
|
405
|
+
* carries no protection at all.
|
|
406
|
+
*/
|
|
407
|
+
operationId);
|
|
408
|
+
reportOperation(op, opts.json === true, "Retrying directory deletion");
|
|
409
|
+
return 0;
|
|
410
|
+
}
|
|
411
|
+
catch (err) {
|
|
412
|
+
if (neverAnswered(err)) {
|
|
413
|
+
/*
|
|
414
|
+
* The request may already have moved the operation back to `queued`.
|
|
415
|
+
*
|
|
416
|
+
* Without the key the caller cannot repeat this attempt safely — and
|
|
417
|
+
* repeating it without one asks the server to reschedule an operation
|
|
418
|
+
* that may already be running again.
|
|
419
|
+
*/
|
|
420
|
+
fail(`${explainWrite(err)}\n` +
|
|
421
|
+
` The server may or may not have rescheduled it. Retry with the SAME key:\n` +
|
|
422
|
+
` --idempotency-key ${key.key}`);
|
|
423
|
+
return 1;
|
|
424
|
+
}
|
|
425
|
+
// Retry requires `failed`. Anything else is a state this command must not
|
|
426
|
+
// move, so the server's own message is what the caller gets.
|
|
427
|
+
fail(explainWrite(err));
|
|
428
|
+
return 1;
|
|
429
|
+
}
|
|
430
|
+
}
|
|
431
|
+
// ── registration ──────────────────────────────────────────────────────────────
|
|
432
|
+
export function registerSourceDeleteCommands(source) {
|
|
433
|
+
strictArgs(source.command("delete-object"))
|
|
434
|
+
.description("delete one managed object (immediate, physical)")
|
|
435
|
+
.argument("<path>", "path within the source")
|
|
436
|
+
.requiredOption("--source <name>", "source name (see 'dreamlake source list')")
|
|
437
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
438
|
+
.option("--idempotency-key <key>", "reuse a key from an attempt that never answered")
|
|
439
|
+
.option("--json", "emit JSON")
|
|
440
|
+
.action(async (path, opts) => process.exit(await runDeleteObject(path, opts)));
|
|
441
|
+
strictArgs(source.command("delete-prefix"))
|
|
442
|
+
.description("queue a recursive delete of one managed directory")
|
|
443
|
+
.argument("<path>", "directory path within the source")
|
|
444
|
+
.requiredOption("--source <name>", "source name (see 'dreamlake source list')")
|
|
445
|
+
.option("--wait", "watch until the operation finishes")
|
|
446
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
447
|
+
.option("--idempotency-key <key>", "reuse a key from an attempt that never answered")
|
|
448
|
+
.option("--json", "emit JSON")
|
|
449
|
+
.action(async (path, opts) => process.exit(await runDeletePrefix(path, opts)));
|
|
450
|
+
strictArgs(source.command("delete-status"))
|
|
451
|
+
.description("read a directory-deletion operation")
|
|
452
|
+
.argument("<operationId>", "operation id from 'source delete-prefix'")
|
|
453
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
454
|
+
.option("--json", "emit JSON")
|
|
455
|
+
.action(async (id, opts) => process.exit(await runDeleteStatus(id, opts)));
|
|
456
|
+
strictArgs(source.command("delete-retry"))
|
|
457
|
+
.description("retry a failed directory-deletion operation")
|
|
458
|
+
.argument("<operationId>", "operation id from 'source delete-prefix'")
|
|
459
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
460
|
+
.option("--idempotency-key <key>", "reuse a key from an attempt that never answered")
|
|
461
|
+
.option("--json", "emit JSON")
|
|
462
|
+
.action(async (id, opts) => process.exit(await runDeleteRetry(id, opts)));
|
|
463
|
+
}
|