@dreamlake/dreamlake-cli 0.88.1 → 0.90.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/api/access.d.ts +83 -0
- package/dist/api/access.js +77 -0
- package/dist/api/agent.d.ts +156 -0
- package/dist/api/agent.js +111 -0
- package/dist/api/browser.d.ts +90 -0
- package/dist/api/browser.js +102 -0
- package/dist/api/client.d.ts +54 -0
- package/dist/api/client.js +102 -0
- package/dist/api/common.d.ts +28 -0
- package/dist/api/common.js +16 -0
- package/dist/api/content.d.ts +195 -0
- package/dist/api/content.js +147 -0
- package/dist/api/execution.d.ts +84 -0
- package/dist/api/execution.js +73 -0
- package/dist/api/http.d.ts +19 -0
- package/dist/api/http.js +66 -0
- package/dist/api/index.d.ts +2362 -0
- package/dist/api/index.js +116 -0
- package/dist/api/infra.d.ts +2 -0
- package/dist/api/infra.js +2 -0
- package/dist/api/jobs.d.ts +2 -0
- package/dist/api/jobs.js +2 -0
- package/dist/api/layout.d.ts +2 -0
- package/dist/api/layout.js +2 -0
- package/dist/api/library-edit.d.ts +3 -0
- package/dist/api/library-edit.js +3 -0
- package/dist/api/library-manifest.d.ts +2 -0
- package/dist/api/library-manifest.js +2 -0
- package/dist/api/note-character-plan.d.ts +2 -0
- package/dist/api/note-character-plan.js +2 -0
- package/dist/api/note-editing.d.ts +2 -0
- package/dist/api/note-editing.js +2 -0
- package/dist/api/note-edits.d.ts +21 -0
- package/dist/api/note-edits.js +10 -0
- package/dist/api/note-events.d.ts +5 -0
- package/dist/api/note-events.js +11 -0
- package/dist/api/note-files.d.ts +102 -0
- package/dist/api/note-files.js +107 -0
- package/dist/api/note-html-read.d.ts +2 -0
- package/dist/api/note-html-read.js +2 -0
- package/dist/api/note-html.d.ts +2 -0
- package/dist/api/note-html.js +2 -0
- package/dist/api/note-linger.d.ts +83 -0
- package/dist/api/note-linger.js +270 -0
- package/dist/api/note-presence.d.ts +82 -0
- package/dist/api/note-presence.js +72 -0
- package/dist/api/note-toc.d.ts +2 -0
- package/dist/api/note-toc.js +2 -0
- package/dist/api/notes.d.ts +329 -0
- package/dist/api/notes.js +209 -0
- package/dist/api/open-resources.d.ts +27 -0
- package/dist/api/open-resources.js +102 -0
- package/dist/api/ownership.d.ts +12 -0
- package/dist/api/ownership.js +24 -0
- package/dist/api/platform.d.ts +83 -0
- package/dist/api/platform.js +56 -0
- package/dist/api/presigned-transfer.d.ts +2 -0
- package/dist/api/presigned-transfer.js +2 -0
- package/dist/api/registered-runs.d.ts +48 -0
- package/dist/api/registered-runs.js +33 -0
- package/dist/api/sessions.d.ts +299 -0
- package/dist/api/sessions.js +105 -0
- package/dist/api/storage.d.ts +46 -0
- package/dist/api/storage.js +34 -0
- package/dist/api/streams.d.ts +18 -0
- package/dist/api/streams.js +70 -0
- package/dist/api/vault.d.ts +93 -0
- package/dist/api/vault.js +79 -0
- package/dist/api/workspace.d.ts +180 -0
- package/dist/api/workspace.js +146 -0
- package/dist/cli/agent-identity.d.ts +4 -0
- package/dist/cli/agent-identity.js +21 -0
- package/dist/cli/agents/identity.d.ts +50 -0
- package/dist/cli/agents/identity.js +105 -0
- package/dist/cli/agents/index.d.ts +31 -0
- package/dist/cli/agents/index.js +580 -0
- package/dist/cli/agents/manage.d.ts +43 -0
- package/dist/cli/agents/manage.js +376 -0
- package/dist/cli/agents/spec.d.ts +104 -0
- package/dist/cli/agents/spec.js +280 -0
- package/dist/cli/agents/web.d.ts +7 -0
- package/dist/cli/agents/web.js +109 -0
- package/dist/cli/artifact/incremental.d.ts +21 -0
- package/dist/cli/artifact/incremental.js +80 -0
- package/dist/cli/artifact/index.d.ts +52 -0
- package/dist/cli/artifact/index.js +405 -0
- package/dist/cli/artifact/meta.d.ts +69 -0
- package/dist/cli/artifact/meta.js +189 -0
- package/dist/cli/auth/commands.d.ts +29 -0
- package/dist/cli/auth/commands.js +327 -0
- package/dist/cli/auth/constants.d.ts +13 -0
- package/dist/cli/auth/constants.js +18 -0
- package/dist/cli/auth/credentials.d.ts +37 -0
- package/dist/cli/auth/credentials.js +155 -0
- package/dist/cli/auth/device-flow.d.ts +32 -0
- package/dist/cli/auth/device-flow.js +154 -0
- package/dist/cli/auth/device-secret.d.ts +6 -0
- package/dist/cli/auth/device-secret.js +26 -0
- package/dist/cli/auth/machine.d.ts +15 -0
- package/dist/cli/auth/machine.js +126 -0
- package/dist/cli/auth/materialized.d.ts +32 -0
- package/dist/cli/auth/materialized.js +102 -0
- package/dist/cli/auth/migrate.d.ts +10 -0
- package/dist/cli/auth/migrate.js +75 -0
- package/dist/cli/client.d.ts +102 -0
- package/dist/cli/client.js +206 -0
- package/dist/cli/collection-list.d.ts +3 -0
- package/dist/cli/collection-list.js +25 -0
- package/dist/cli/compat/ctx.d.ts +26 -0
- package/dist/cli/compat/ctx.js +76 -0
- package/dist/cli/compat/dreamdb-wasm-embedded.d.ts +2 -0
- package/dist/cli/compat/dreamdb-wasm-embedded.js +8 -0
- package/dist/cli/compat/dreamdb-wasm.d.ts +1 -0
- package/dist/cli/compat/dreamdb-wasm.js +26 -0
- package/dist/cli/compat/dreamdb.d.ts +112 -0
- package/dist/cli/compat/dreamdb.js +219 -0
- package/dist/cli/compat/flags.d.ts +2 -0
- package/dist/cli/compat/flags.js +13 -0
- package/dist/cli/compat/http.d.ts +23 -0
- package/dist/cli/compat/http.js +137 -0
- package/dist/cli/compat/presignedTransfer.d.ts +139 -0
- package/dist/cli/compat/presignedTransfer.js +580 -0
- package/dist/cli/compat/s3-backend.d.ts +73 -0
- package/dist/cli/compat/s3-backend.js +132 -0
- package/dist/cli/config.d.ts +22 -0
- package/dist/cli/config.js +96 -0
- package/dist/cli/connection/dto.d.ts +159 -0
- package/dist/cli/connection/dto.js +497 -0
- package/dist/cli/connection/index.d.ts +50 -0
- package/dist/cli/connection/index.js +413 -0
- package/dist/cli/connection/oauth.d.ts +23 -0
- package/dist/cli/connection/oauth.js +290 -0
- package/dist/cli/connection/write.d.ts +47 -0
- package/dist/cli/connection/write.js +573 -0
- package/dist/cli/create/index.d.ts +19 -0
- package/dist/cli/create/index.js +209 -0
- package/dist/cli/declare/index.d.ts +29 -0
- package/dist/cli/declare/index.js +304 -0
- package/dist/cli/delete/index.d.ts +18 -0
- package/dist/cli/delete/index.js +232 -0
- package/dist/cli/download/index.d.ts +9 -0
- package/dist/cli/download/index.js +128 -0
- package/dist/cli/env/compose.d.ts +88 -0
- package/dist/cli/env/compose.js +402 -0
- package/dist/cli/env/index.d.ts +176 -0
- package/dist/cli/env/index.js +1011 -0
- package/dist/cli/experiments/index.d.ts +11 -0
- package/dist/cli/experiments/index.js +168 -0
- package/dist/cli/glob.d.ts +1 -0
- package/dist/cli/glob.js +45 -0
- package/dist/cli/graphql-helpers.d.ts +23 -0
- package/dist/cli/graphql-helpers.js +42 -0
- package/dist/cli/graphql.d.ts +10 -0
- package/dist/cli/graphql.js +47 -0
- package/dist/cli/help-examples.generated.d.ts +1 -0
- package/dist/cli/help-examples.generated.js +192 -0
- package/dist/cli/helpers.d.ts +8 -0
- package/dist/cli/helpers.js +106 -0
- package/dist/cli/hosts/api.d.ts +29 -0
- package/dist/cli/hosts/api.js +54 -0
- package/dist/cli/hosts/bootstrap-source.d.ts +1 -0
- package/dist/cli/hosts/bootstrap-source.js +2 -0
- package/dist/cli/hosts/catalog.d.ts +26 -0
- package/dist/cli/hosts/catalog.js +55 -0
- package/dist/cli/hosts/config.d.ts +45 -0
- package/dist/cli/hosts/config.js +179 -0
- package/dist/cli/hosts/credentials.d.ts +19 -0
- package/dist/cli/hosts/credentials.js +173 -0
- package/dist/cli/hosts/enroll.d.ts +17 -0
- package/dist/cli/hosts/enroll.js +109 -0
- package/dist/cli/hosts/enrollments.d.ts +25 -0
- package/dist/cli/hosts/enrollments.js +54 -0
- package/dist/cli/hosts/index.d.ts +6 -0
- package/dist/cli/hosts/index.js +279 -0
- package/dist/cli/hosts/inventory.d.ts +40 -0
- package/dist/cli/hosts/inventory.js +91 -0
- package/dist/cli/hosts/lifecycle.d.ts +15 -0
- package/dist/cli/hosts/lifecycle.js +108 -0
- package/dist/cli/hosts/metrics-source.d.ts +12 -0
- package/dist/cli/hosts/metrics-source.js +89 -0
- package/dist/cli/hosts/observations.d.ts +39 -0
- package/dist/cli/hosts/observations.js +102 -0
- package/dist/cli/hosts/remote.d.ts +5 -0
- package/dist/cli/hosts/remote.js +66 -0
- package/dist/cli/hosts/ssh.d.ts +63 -0
- package/dist/cli/hosts/ssh.js +276 -0
- package/dist/cli/index.d.ts +1 -0
- package/dist/cli/index.js +288 -0
- package/dist/cli/infra/api.d.ts +95 -0
- package/dist/cli/infra/api.js +291 -0
- package/dist/cli/infra/index.d.ts +5 -0
- package/dist/cli/infra/index.js +102 -0
- package/dist/cli/infra/move.d.ts +15 -0
- package/dist/cli/infra/move.js +123 -0
- package/dist/cli/infra/transfer.d.ts +15 -0
- package/dist/cli/infra/transfer.js +280 -0
- package/dist/cli/jobs/api.d.ts +69 -0
- package/dist/cli/jobs/api.js +121 -0
- package/dist/cli/jobs/index.d.ts +5 -0
- package/dist/cli/jobs/index.js +140 -0
- package/dist/cli/lakeshore/index.d.ts +98 -0
- package/dist/cli/lakeshore/index.js +502 -0
- package/dist/cli/launch/index.d.ts +43 -0
- package/dist/cli/launch/index.js +270 -0
- package/dist/cli/layout/index.d.ts +2 -0
- package/dist/cli/layout/index.js +44 -0
- package/dist/cli/layout/transport.d.ts +12 -0
- package/dist/cli/layout/transport.js +70 -0
- package/dist/cli/library/add.d.ts +60 -0
- package/dist/cli/library/add.js +348 -0
- package/dist/cli/library/cache.d.ts +26 -0
- package/dist/cli/library/cache.js +88 -0
- package/dist/cli/library/config.d.ts +75 -0
- package/dist/cli/library/config.js +198 -0
- package/dist/cli/library/digest.d.ts +5 -0
- package/dist/cli/library/digest.js +19 -0
- package/dist/cli/library/discover.d.ts +87 -0
- package/dist/cli/library/discover.js +534 -0
- package/dist/cli/library/freshness.d.ts +35 -0
- package/dist/cli/library/freshness.js +109 -0
- package/dist/cli/library/generation.d.ts +35 -0
- package/dist/cli/library/generation.js +211 -0
- package/dist/cli/library/index.d.ts +2 -0
- package/dist/cli/library/index.js +36 -0
- package/dist/cli/library/info.d.ts +69 -0
- package/dist/cli/library/info.js +311 -0
- package/dist/cli/library/list.d.ts +33 -0
- package/dist/cli/library/list.js +86 -0
- package/dist/cli/library/manifest.d.ts +81 -0
- package/dist/cli/library/manifest.js +200 -0
- package/dist/cli/library/manifestCache.d.ts +45 -0
- package/dist/cli/library/manifestCache.js +169 -0
- package/dist/cli/library/pull.d.ts +30 -0
- package/dist/cli/library/pull.js +438 -0
- package/dist/cli/library/push.d.ts +72 -0
- package/dist/cli/library/push.js +642 -0
- package/dist/cli/library/rm.d.ts +31 -0
- package/dist/cli/library/rm.js +200 -0
- package/dist/cli/library/search.d.ts +18 -0
- package/dist/cli/library/search.js +181 -0
- package/dist/cli/library/stat.d.ts +15 -0
- package/dist/cli/library/stat.js +127 -0
- package/dist/cli/library/tools.d.ts +104 -0
- package/dist/cli/library/tools.js +163 -0
- package/dist/cli/library/wire.d.ts +47 -0
- package/dist/cli/library/wire.js +120 -0
- package/dist/cli/list/index.d.ts +26 -0
- package/dist/cli/list/index.js +256 -0
- package/dist/cli/notes/api-transport.d.ts +5 -0
- package/dist/cli/notes/api-transport.js +20 -0
- package/dist/cli/notes/character-plan.d.ts +22 -0
- package/dist/cli/notes/character-plan.js +232 -0
- package/dist/cli/notes/document.d.ts +73 -0
- package/dist/cli/notes/document.js +306 -0
- package/dist/cli/notes/edit-commands.d.ts +106 -0
- package/dist/cli/notes/edit-commands.js +623 -0
- package/dist/cli/notes/editing.d.ts +81 -0
- package/dist/cli/notes/editing.js +305 -0
- package/dist/cli/notes/events.d.ts +36 -0
- package/dist/cli/notes/events.js +54 -0
- package/dist/cli/notes/files-commands.d.ts +97 -0
- package/dist/cli/notes/files-commands.js +548 -0
- package/dist/cli/notes/html-read.d.ts +9 -0
- package/dist/cli/notes/html-read.js +90 -0
- package/dist/cli/notes/html.d.ts +73 -0
- package/dist/cli/notes/html.js +381 -0
- package/dist/cli/notes/index.d.ts +123 -0
- package/dist/cli/notes/index.js +1300 -0
- package/dist/cli/notes/linger.d.ts +4 -0
- package/dist/cli/notes/linger.js +96 -0
- package/dist/cli/notes/media-commands.d.ts +5 -0
- package/dist/cli/notes/media-commands.js +51 -0
- package/dist/cli/notes/move-command.d.ts +83 -0
- package/dist/cli/notes/move-command.js +259 -0
- package/dist/cli/notes/rm-command.d.ts +22 -0
- package/dist/cli/notes/rm-command.js +110 -0
- package/dist/cli/notes/select-command.d.ts +12 -0
- package/dist/cli/notes/select-command.js +63 -0
- package/dist/cli/notes/suggest-diff.d.ts +56 -0
- package/dist/cli/notes/suggest-diff.js +311 -0
- package/dist/cli/notes/toc.d.ts +38 -0
- package/dist/cli/notes/toc.js +144 -0
- package/dist/cli/notes/transfer-command.d.ts +6 -0
- package/dist/cli/notes/transfer-command.js +9 -0
- package/dist/cli/notes/version-commands.d.ts +19 -0
- package/dist/cli/notes/version-commands.js +178 -0
- package/dist/cli/nymph/index.d.ts +74 -0
- package/dist/cli/nymph/index.js +349 -0
- package/dist/cli/org/index.d.ts +34 -0
- package/dist/cli/org/index.js +341 -0
- package/dist/cli/ownership/index.d.ts +12 -0
- package/dist/cli/ownership/index.js +122 -0
- package/dist/cli/ownership/metadata-transfer.d.ts +20 -0
- package/dist/cli/ownership/metadata-transfer.js +159 -0
- package/dist/cli/page/index.d.ts +58 -0
- package/dist/cli/page/index.js +387 -0
- package/dist/cli/pipeline/index.d.ts +69 -0
- package/dist/cli/pipeline/index.js +604 -0
- package/dist/cli/progress.d.ts +60 -0
- package/dist/cli/progress.js +276 -0
- package/dist/cli/project/attachments.d.ts +10 -0
- package/dist/cli/project/attachments.js +39 -0
- package/dist/cli/project/grants.d.ts +10 -0
- package/dist/cli/project/grants.js +39 -0
- package/dist/cli/project/index.d.ts +8 -0
- package/dist/cli/project/index.js +92 -0
- package/dist/cli/project/move.d.ts +57 -0
- package/dist/cli/project/move.js +242 -0
- package/dist/cli/project/output.d.ts +2 -0
- package/dist/cli/project/output.js +29 -0
- package/dist/cli/project/stream.d.ts +55 -0
- package/dist/cli/project/stream.js +207 -0
- package/dist/cli/project/transfer-preview.d.ts +8 -0
- package/dist/cli/project/transfer-preview.js +10 -0
- package/dist/cli/prompt.d.ts +1 -0
- package/dist/cli/prompt.js +17 -0
- package/dist/cli/provider/dreamdir.d.ts +52 -0
- package/dist/cli/provider/dreamdir.js +138 -0
- package/dist/cli/provider/index.d.ts +4 -0
- package/dist/cli/provider/index.js +419 -0
- package/dist/cli/provider/jump-worker.d.ts +9 -0
- package/dist/cli/provider/jump-worker.js +141 -0
- package/dist/cli/provider/lifecycle.d.ts +149 -0
- package/dist/cli/provider/lifecycle.js +1390 -0
- package/dist/cli/provider/machine.d.ts +17 -0
- package/dist/cli/provider/machine.js +116 -0
- package/dist/cli/provider/ssh.d.ts +105 -0
- package/dist/cli/provider/ssh.js +305 -0
- package/dist/cli/provider/terraform.d.ts +140 -0
- package/dist/cli/provider/terraform.js +288 -0
- package/dist/cli/providers/index.d.ts +18 -0
- package/dist/cli/providers/index.js +422 -0
- package/dist/cli/python.d.ts +61 -0
- package/dist/cli/python.js +255 -0
- package/dist/cli/queues/index.d.ts +33 -0
- package/dist/cli/queues/index.js +248 -0
- package/dist/cli/queues/slurm.d.ts +10 -0
- package/dist/cli/queues/slurm.js +134 -0
- package/dist/cli/resources.d.ts +72 -0
- package/dist/cli/resources.js +137 -0
- package/dist/cli/run/index.d.ts +15 -0
- package/dist/cli/run/index.js +163 -0
- package/dist/cli/run/input.d.ts +34 -0
- package/dist/cli/run/input.js +135 -0
- package/dist/cli/run/recovery.d.ts +2 -0
- package/dist/cli/run/recovery.js +18 -0
- package/dist/cli/run/setup.d.ts +3 -0
- package/dist/cli/run/setup.js +62 -0
- package/dist/cli/runconfig/index.d.ts +12 -0
- package/dist/cli/runconfig/index.js +130 -0
- package/dist/cli/runnable/index.d.ts +35 -0
- package/dist/cli/runnable/index.js +575 -0
- package/dist/cli/runnable/path.d.ts +115 -0
- package/dist/cli/runnable/path.js +288 -0
- package/dist/cli/runnable/run.d.ts +91 -0
- package/dist/cli/runnable/run.js +239 -0
- package/dist/cli/runnable/upload.d.ts +43 -0
- package/dist/cli/runnable/upload.js +342 -0
- package/dist/cli/runnable/worker.d.ts +1 -0
- package/dist/cli/runnable/worker.js +44 -0
- package/dist/cli/schemas/workflow-spec.schema.json +335 -0
- package/dist/cli/self-update/index.d.ts +5 -0
- package/dist/cli/self-update/index.js +107 -0
- package/dist/cli/self-update/install.d.ts +60 -0
- package/dist/cli/self-update/install.js +428 -0
- package/dist/cli/self-update/paths.d.ts +40 -0
- package/dist/cli/self-update/paths.js +87 -0
- package/dist/cli/self-update/releases.d.ts +41 -0
- package/dist/cli/self-update/releases.js +153 -0
- package/dist/cli/self-update/settings.d.ts +16 -0
- package/dist/cli/self-update/settings.js +68 -0
- package/dist/cli/self-update/update.d.ts +18 -0
- package/dist/cli/self-update/update.js +241 -0
- package/dist/cli/service-accounts/index.d.ts +3 -0
- package/dist/cli/service-accounts/index.js +149 -0
- package/dist/cli/session-affiliation.d.ts +26 -0
- package/dist/cli/session-affiliation.js +135 -0
- package/dist/cli/sessions/affiliation.d.ts +8 -0
- package/dist/cli/sessions/affiliation.js +66 -0
- package/dist/cli/sessions/api.d.ts +55 -0
- package/dist/cli/sessions/api.js +88 -0
- package/dist/cli/sessions/control.d.ts +6 -0
- package/dist/cli/sessions/control.js +159 -0
- package/dist/cli/sessions/conversation.d.ts +15 -0
- package/dist/cli/sessions/conversation.js +118 -0
- package/dist/cli/sessions/index.d.ts +2 -0
- package/dist/cli/sessions/index.js +209 -0
- package/dist/cli/sessions/managed.d.ts +39 -0
- package/dist/cli/sessions/managed.js +63 -0
- package/dist/cli/sessions/redaction.d.ts +2 -0
- package/dist/cli/sessions/redaction.js +11 -0
- package/dist/cli/sessions/runner/exec.d.ts +108 -0
- package/dist/cli/sessions/runner/exec.js +335 -0
- package/dist/cli/sessions/runner/journal.d.ts +26 -0
- package/dist/cli/sessions/runner/journal.js +49 -0
- package/dist/cli/sessions/runner/native.d.ts +48 -0
- package/dist/cli/sessions/runner/native.js +170 -0
- package/dist/cli/sessions/runner/pod.d.ts +30 -0
- package/dist/cli/sessions/runner/pod.js +129 -0
- package/dist/cli/sessions/runner/serve.d.ts +85 -0
- package/dist/cli/sessions/runner/serve.js +558 -0
- package/dist/cli/sessions/sync.d.ts +47 -0
- package/dist/cli/sessions/sync.js +80 -0
- package/dist/cli/sessions/transport.d.ts +14 -0
- package/dist/cli/sessions/transport.js +116 -0
- package/dist/cli/share.d.ts +15 -0
- package/dist/cli/share.js +139 -0
- package/dist/cli/skill/catalog.d.ts +141 -0
- package/dist/cli/skill/catalog.js +442 -0
- package/dist/cli/skill/files.d.ts +89 -0
- package/dist/cli/skill/files.js +264 -0
- package/dist/cli/skill/index.d.ts +268 -0
- package/dist/cli/skill/index.js +1216 -0
- package/dist/cli/skill/manifest.d.ts +30 -0
- package/dist/cli/skill/manifest.js +101 -0
- package/dist/cli/skill/prefs.d.ts +9 -0
- package/dist/cli/skill/prefs.js +32 -0
- package/dist/cli/skill/reminders.d.ts +15 -0
- package/dist/cli/skill/reminders.js +105 -0
- package/dist/cli/skill/tar.d.ts +17 -0
- package/dist/cli/skill/tar.js +195 -0
- package/dist/cli/snapshot/index.d.ts +24 -0
- package/dist/cli/snapshot/index.js +146 -0
- package/dist/cli/source/access.d.ts +45 -0
- package/dist/cli/source/access.js +563 -0
- package/dist/cli/source/control.d.ts +103 -0
- package/dist/cli/source/control.js +546 -0
- package/dist/cli/source/delete.d.ts +89 -0
- package/dist/cli/source/delete.js +463 -0
- package/dist/cli/source/index.d.ts +288 -0
- package/dist/cli/source/index.js +1348 -0
- package/dist/cli/source/share.d.ts +65 -0
- package/dist/cli/source/share.js +530 -0
- package/dist/cli/source/upload.d.ts +62 -0
- package/dist/cli/source/upload.js +258 -0
- package/dist/cli/source/write.d.ts +77 -0
- package/dist/cli/source/write.js +335 -0
- package/dist/cli/spawn.d.ts +28 -0
- package/dist/cli/spawn.js +81 -0
- package/dist/cli/target.d.ts +22 -0
- package/dist/cli/target.js +85 -0
- package/dist/cli/tasks/index.d.ts +38 -0
- package/dist/cli/tasks/index.js +365 -0
- package/dist/cli/team/index.d.ts +37 -0
- package/dist/cli/team/index.js +407 -0
- package/dist/cli/telemetry.d.ts +23 -0
- package/dist/cli/telemetry.js +262 -0
- package/dist/cli/telemetryJournal.d.ts +26 -0
- package/dist/cli/telemetryJournal.js +104 -0
- package/dist/cli/update/index.d.ts +21 -0
- package/dist/cli/update/index.js +284 -0
- package/dist/cli/upload/index.d.ts +11 -0
- package/dist/cli/upload/index.js +261 -0
- package/dist/cli/upload/kinds.d.ts +10 -0
- package/dist/cli/upload/kinds.js +85 -0
- package/dist/cli/upload/multipart.d.ts +21 -0
- package/dist/cli/upload/multipart.js +248 -0
- package/dist/cli/vault/affected-preview.d.ts +15 -0
- package/dist/cli/vault/affected-preview.js +38 -0
- package/dist/cli/vault/cloud.d.ts +55 -0
- package/dist/cli/vault/cloud.js +287 -0
- package/dist/cli/vault/format.d.ts +18 -0
- package/dist/cli/vault/format.js +104 -0
- package/dist/cli/vault/hostCredentials.d.ts +21 -0
- package/dist/cli/vault/hostCredentials.js +71 -0
- package/dist/cli/vault/hostSupersessions.d.ts +18 -0
- package/dist/cli/vault/hostSupersessions.js +68 -0
- package/dist/cli/vault/import.d.ts +3 -0
- package/dist/cli/vault/import.js +79 -0
- package/dist/cli/vault/index.d.ts +14 -0
- package/dist/cli/vault/index.js +225 -0
- package/dist/cli/vault/keys.d.ts +5 -0
- package/dist/cli/vault/keys.js +165 -0
- package/dist/cli/vault/kms.d.ts +6 -0
- package/dist/cli/vault/kms.js +169 -0
- package/dist/cli/vault/list.d.ts +13 -0
- package/dist/cli/vault/list.js +60 -0
- package/dist/cli/vault/listView.d.ts +21 -0
- package/dist/cli/vault/listView.js +123 -0
- package/dist/cli/vault/managementMetadata.d.ts +2 -0
- package/dist/cli/vault/managementMetadata.js +23 -0
- package/dist/cli/vault/mutations.d.ts +8 -0
- package/dist/cli/vault/mutations.js +151 -0
- package/dist/cli/vault/otp.d.ts +6 -0
- package/dist/cli/vault/otp.js +62 -0
- package/dist/cli/vault/otpIntent.d.ts +23 -0
- package/dist/cli/vault/otpIntent.js +76 -0
- package/dist/cli/vault/passImport.d.ts +25 -0
- package/dist/cli/vault/passImport.js +129 -0
- package/dist/cli/vault/passOtp.d.ts +51 -0
- package/dist/cli/vault/passOtp.js +101 -0
- package/dist/cli/vault/passStore.d.ts +26 -0
- package/dist/cli/vault/passStore.js +134 -0
- package/dist/cli/vault/passwordCommand.d.ts +39 -0
- package/dist/cli/vault/passwordCommand.js +101 -0
- package/dist/cli/vault/passwordProbe.d.ts +27 -0
- package/dist/cli/vault/passwordProbe.js +282 -0
- package/dist/cli/vault/passwordRotation.d.ts +9 -0
- package/dist/cli/vault/passwordRotation.js +273 -0
- package/dist/cli/vault/rotationApi.d.ts +13 -0
- package/dist/cli/vault/rotationApi.js +58 -0
- package/dist/cli/vault/rotationCommand.d.ts +2 -0
- package/dist/cli/vault/rotationCommand.js +75 -0
- package/dist/cli/vault/rotationEngine.d.ts +19 -0
- package/dist/cli/vault/rotationEngine.js +65 -0
- package/dist/cli/vault/rotationHelperSource.d.ts +2 -0
- package/dist/cli/vault/rotationHelperSource.js +3 -0
- package/dist/cli/vault/rotationInput.d.ts +11 -0
- package/dist/cli/vault/rotationInput.js +48 -0
- package/dist/cli/vault/rotationJournal.d.ts +16 -0
- package/dist/cli/vault/rotationJournal.js +183 -0
- package/dist/cli/vault/rotationKeys.d.ts +4 -0
- package/dist/cli/vault/rotationKeys.js +48 -0
- package/dist/cli/vault/rotationPrepare.d.ts +17 -0
- package/dist/cli/vault/rotationPrepare.js +108 -0
- package/dist/cli/vault/rotationRemote.d.ts +33 -0
- package/dist/cli/vault/rotationRemote.js +156 -0
- package/dist/cli/vault/rotationState.d.ts +42 -0
- package/dist/cli/vault/rotationState.js +115 -0
- package/dist/cli/vault/rotationTransport.d.ts +18 -0
- package/dist/cli/vault/rotationTransport.js +71 -0
- package/dist/cli/vault/sshSource.d.ts +18 -0
- package/dist/cli/vault/sshSource.js +196 -0
- package/dist/cli/vault/sshSync.d.ts +17 -0
- package/dist/cli/vault/sshSync.js +224 -0
- package/dist/cli/vault/sshTransfer.d.ts +22 -0
- package/dist/cli/vault/sshTransfer.js +140 -0
- package/dist/cli/vault/terraformState.d.ts +66 -0
- package/dist/cli/vault/terraformState.js +252 -0
- package/dist/cli/vault/terraformStateCommand.d.ts +2 -0
- package/dist/cli/vault/terraformStateCommand.js +61 -0
- package/dist/cli/vault/tree.d.ts +43 -0
- package/dist/cli/vault/tree.js +292 -0
- package/dist/cli/version.d.ts +1 -0
- package/dist/cli/version.js +9 -0
- package/dist/cli/workflow/index.d.ts +76 -0
- package/dist/cli/workflow/index.js +826 -0
- package/dist/cli/workflow/validate.d.ts +19 -0
- package/dist/cli/workflow/validate.js +353 -0
- package/dist/package.json +1 -0
- package/package.json +28 -10
|
@@ -0,0 +1,573 @@
|
|
|
1
|
+
// The mutating half of `dreamlake connection …`.
|
|
2
|
+
//
|
|
3
|
+
// Two rules shape almost everything here.
|
|
4
|
+
//
|
|
5
|
+
// A credential never appears in argv. There is no `--credential '{"key":"…"}'`
|
|
6
|
+
// and there will not be one: an argument is visible in `ps` to every other user
|
|
7
|
+
// on the machine for as long as the process runs, and it lands in the shell
|
|
8
|
+
// history file afterwards. Credentials are read from a file or from stdin, both
|
|
9
|
+
// of which stay between the caller and this process.
|
|
10
|
+
//
|
|
11
|
+
// The server owns the schema. This module never checks a connector kind, an
|
|
12
|
+
// auth kind, or the shape of a credential against a local list. It checks that
|
|
13
|
+
// a credential parsed as a JSON object — which the wire contract requires — and
|
|
14
|
+
// forwards it. A connector added to the server last week works here today.
|
|
15
|
+
import { readFileSync } from "node:fs";
|
|
16
|
+
import { randomUUID } from "node:crypto";
|
|
17
|
+
import { HttpError, requestJson } from "../client.js";
|
|
18
|
+
import { emitJson, fail, ok } from "../helpers.js";
|
|
19
|
+
import { parseCheck, parseDetail } from "./dto.js";
|
|
20
|
+
import { connectionPath, ctx, explain, fetchConnection, seg, strictArgs, } from "./index.js";
|
|
21
|
+
// ─── idempotency ──────────────────────────────────────────────────────────────
|
|
22
|
+
/*
|
|
23
|
+
* The same semantics the Source write plane uses, deliberately restated rather
|
|
24
|
+
* than imported.
|
|
25
|
+
*
|
|
26
|
+
* Sharing the function would mean this module importing from `source/`, and the
|
|
27
|
+
* boundary between Connections and Sources is one the server enforces with a
|
|
28
|
+
* named test. The rule itself is frozen by ruling and pinned by tests on both
|
|
29
|
+
* sides; what is not shared is the dependency.
|
|
30
|
+
*
|
|
31
|
+
* The key is random per invocation and never derived from a label, a namespace
|
|
32
|
+
* or a connector identity. A derived key would collide across two Connections
|
|
33
|
+
* that differ only in a field the derivation ignores, and it would make a
|
|
34
|
+
* deliberate second Connection to the same place impossible to express.
|
|
35
|
+
*/
|
|
36
|
+
const MAX_IDEMPOTENCY_KEY = 255;
|
|
37
|
+
function idempotencyKey(override) {
|
|
38
|
+
/*
|
|
39
|
+
* Absent and empty are different requests. Absent means "new command, invent
|
|
40
|
+
* an identity". An explicit empty string — or a shell variable that expanded
|
|
41
|
+
* to nothing — means "the same command as before", and quietly inventing a
|
|
42
|
+
* fresh key for it creates a second Connection out of what the caller
|
|
43
|
+
* believed was a retry.
|
|
44
|
+
*/
|
|
45
|
+
if (override === undefined)
|
|
46
|
+
return { ok: true, key: randomUUID() };
|
|
47
|
+
const key = override.trim();
|
|
48
|
+
if (key === "") {
|
|
49
|
+
fail("--idempotency-key is empty — omit it to start a new command");
|
|
50
|
+
return { ok: false };
|
|
51
|
+
}
|
|
52
|
+
if (key.length > MAX_IDEMPOTENCY_KEY) {
|
|
53
|
+
fail(`--idempotency-key is longer than ${MAX_IDEMPOTENCY_KEY} characters`);
|
|
54
|
+
return { ok: false };
|
|
55
|
+
}
|
|
56
|
+
return { ok: true, key };
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* What to say when the request left and no answer came back.
|
|
60
|
+
*
|
|
61
|
+
* The server records these commands under the key, so the honest instruction is
|
|
62
|
+
* to repeat the command with the SAME key — which is the one thing the caller
|
|
63
|
+
* cannot reconstruct unless it is printed here.
|
|
64
|
+
*
|
|
65
|
+
* Only ever called for the MUTATION itself. See `readRevision`.
|
|
66
|
+
*/
|
|
67
|
+
function ambiguous(what, key, err) {
|
|
68
|
+
fail(`${what}: the request was sent but the response never arrived.\n` +
|
|
69
|
+
` The server may or may not have applied it. Retry with the SAME key:\n` +
|
|
70
|
+
` --idempotency-key ${key}\n` +
|
|
71
|
+
` Reusing that key returns the original result instead of acting twice.\n` +
|
|
72
|
+
` (${err.message})`);
|
|
73
|
+
}
|
|
74
|
+
/** A transport failure that left the outcome unknown, as opposed to a refusal. */
|
|
75
|
+
function isAmbiguous(err) {
|
|
76
|
+
return !(err instanceof HttpError);
|
|
77
|
+
}
|
|
78
|
+
// ─── credential input ─────────────────────────────────────────────────────────
|
|
79
|
+
function readStdin() {
|
|
80
|
+
try {
|
|
81
|
+
return readFileSync(0, "utf8");
|
|
82
|
+
}
|
|
83
|
+
catch (err) {
|
|
84
|
+
fail(`could not read stdin: ${err.message}`);
|
|
85
|
+
return "";
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
function parseObject(raw, where) {
|
|
89
|
+
let parsed;
|
|
90
|
+
try {
|
|
91
|
+
parsed = JSON.parse(raw);
|
|
92
|
+
}
|
|
93
|
+
catch (err) {
|
|
94
|
+
fail(`${where}: not valid JSON — ${err.message}`);
|
|
95
|
+
return { ok: false };
|
|
96
|
+
}
|
|
97
|
+
if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
|
|
98
|
+
fail(`${where}: must be a JSON object`);
|
|
99
|
+
return { ok: false };
|
|
100
|
+
}
|
|
101
|
+
/*
|
|
102
|
+
* Deliberately the only check. What belongs inside a credential is the
|
|
103
|
+
* connector descriptor's business, and a CLI that also had an opinion would
|
|
104
|
+
* reject a field the server had just started accepting.
|
|
105
|
+
*/
|
|
106
|
+
return { ok: true, value: parsed };
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* A credential, from a file or from stdin — never from an argument.
|
|
110
|
+
*
|
|
111
|
+
* `null` means "none was offered", which each caller interprets for itself.
|
|
112
|
+
*/
|
|
113
|
+
function readCredential(opts) {
|
|
114
|
+
const fromFile = opts.credentialFile !== undefined;
|
|
115
|
+
const fromStdin = opts.credentialStdin === true;
|
|
116
|
+
if (fromFile && fromStdin) {
|
|
117
|
+
fail("pass either --credential-file or --credential-stdin, not both");
|
|
118
|
+
return { ok: false };
|
|
119
|
+
}
|
|
120
|
+
if (!fromFile && !fromStdin)
|
|
121
|
+
return null;
|
|
122
|
+
if (fromStdin) {
|
|
123
|
+
const raw = readStdin();
|
|
124
|
+
if (raw === "") {
|
|
125
|
+
fail("--credential-stdin: nothing was read from stdin");
|
|
126
|
+
return { ok: false };
|
|
127
|
+
}
|
|
128
|
+
return parseObject(raw, "credential");
|
|
129
|
+
}
|
|
130
|
+
let raw;
|
|
131
|
+
try {
|
|
132
|
+
raw = readFileSync(opts.credentialFile, "utf8");
|
|
133
|
+
}
|
|
134
|
+
catch (err) {
|
|
135
|
+
fail(`--credential-file: ${err.message}`);
|
|
136
|
+
return { ok: false };
|
|
137
|
+
}
|
|
138
|
+
return parseObject(raw, "credential");
|
|
139
|
+
}
|
|
140
|
+
function readPrivateConfig(path) {
|
|
141
|
+
if (path === undefined)
|
|
142
|
+
return null;
|
|
143
|
+
let raw;
|
|
144
|
+
try {
|
|
145
|
+
raw = readFileSync(path, "utf8");
|
|
146
|
+
}
|
|
147
|
+
catch (err) {
|
|
148
|
+
fail(`--private-config-file: ${err.message}`);
|
|
149
|
+
return { ok: false };
|
|
150
|
+
}
|
|
151
|
+
return parseObject(raw, "private config");
|
|
152
|
+
}
|
|
153
|
+
// ─── reporting ────────────────────────────────────────────────────────────────
|
|
154
|
+
/*
|
|
155
|
+
* Only the validated projection is ever printed — the object `parseDetail`
|
|
156
|
+
* built, not the response that arrived. The credential that was just sent is
|
|
157
|
+
* not echoed back in any form, including under --json: a caller piping this
|
|
158
|
+
* into a log would otherwise write the secret they were careful to keep out of
|
|
159
|
+
* their shell history.
|
|
160
|
+
*/
|
|
161
|
+
function report(one, json, verb) {
|
|
162
|
+
if (json) {
|
|
163
|
+
emitJson(one);
|
|
164
|
+
return;
|
|
165
|
+
}
|
|
166
|
+
ok(`${verb} ${one.label} (${one.id}) — ${one.lifecycle}, revision ${one.settingsRevision}`);
|
|
167
|
+
}
|
|
168
|
+
/**
|
|
169
|
+
* Read the current revision, validating it before it is handed back as CAS.
|
|
170
|
+
*
|
|
171
|
+
* Deliberately NOT inside the mutation's try block, and it reports its own
|
|
172
|
+
* failures. A dropped socket on this request is an ordinary read failure —
|
|
173
|
+
* nothing was written, and nothing can have been, because the write has not
|
|
174
|
+
* been composed yet. Letting it fall into the mutation's catch would print
|
|
175
|
+
* "the server may or may not have applied it; retry with this key" about a
|
|
176
|
+
* request that never left the process, and send the caller to reuse a key
|
|
177
|
+
* against a command that was never issued.
|
|
178
|
+
*/
|
|
179
|
+
async function readRevision(c, id) {
|
|
180
|
+
try {
|
|
181
|
+
const one = await fetchConnection(c, id);
|
|
182
|
+
return one === null ? null : one.settingsRevision;
|
|
183
|
+
}
|
|
184
|
+
catch (err) {
|
|
185
|
+
fail(explain(err));
|
|
186
|
+
return null;
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
// ─── create ───────────────────────────────────────────────────────────────────
|
|
190
|
+
export async function runConnectionCreate(opts) {
|
|
191
|
+
const withoutCredential = opts.credential === false;
|
|
192
|
+
/*
|
|
193
|
+
* Refused here rather than sorted out by precedence. Someone who passed both
|
|
194
|
+
* a credential and "send none" has two incompatible intentions, and silently
|
|
195
|
+
* honouring either one sends a request they did not ask for.
|
|
196
|
+
*/
|
|
197
|
+
if (withoutCredential && (opts.credentialFile !== undefined || opts.credentialStdin === true)) {
|
|
198
|
+
fail("--no-credential cannot be combined with --credential-file or --credential-stdin");
|
|
199
|
+
return 1;
|
|
200
|
+
}
|
|
201
|
+
/*
|
|
202
|
+
* Read only when one is expected, and narrowed here rather than at the
|
|
203
|
+
* request — so the payload below cannot reach for a value that was never
|
|
204
|
+
* parsed.
|
|
205
|
+
*/
|
|
206
|
+
let credentialValue;
|
|
207
|
+
if (!withoutCredential) {
|
|
208
|
+
const credential = readCredential(opts);
|
|
209
|
+
if (credential === null) {
|
|
210
|
+
fail("a credential is required — pass --credential-file <path> or --credential-stdin");
|
|
211
|
+
return 1;
|
|
212
|
+
}
|
|
213
|
+
if (!credential.ok)
|
|
214
|
+
return 1;
|
|
215
|
+
credentialValue = credential.value;
|
|
216
|
+
}
|
|
217
|
+
const privateConfig = readPrivateConfig(opts.privateConfigFile);
|
|
218
|
+
if (privateConfig !== null && !privateConfig.ok)
|
|
219
|
+
return 1;
|
|
220
|
+
const key = idempotencyKey(opts.idempotencyKey);
|
|
221
|
+
if (!key.ok)
|
|
222
|
+
return 1;
|
|
223
|
+
const c = await ctx(opts.namespace);
|
|
224
|
+
if (!c)
|
|
225
|
+
return 1;
|
|
226
|
+
try {
|
|
227
|
+
const res = await requestJson(c.remote, `/namespaces/${seg(c.ns)}/connections`, {
|
|
228
|
+
method: "POST",
|
|
229
|
+
token: c.token,
|
|
230
|
+
headers: { "Idempotency-Key": key.key },
|
|
231
|
+
json: {
|
|
232
|
+
label: opts.label,
|
|
233
|
+
/*
|
|
234
|
+
* Both forwarded exactly as given. This client does not know which auth
|
|
235
|
+
* kinds may go without a credential — the server declares that, and is
|
|
236
|
+
* the only thing entitled to decide it.
|
|
237
|
+
*/
|
|
238
|
+
connectorKind: opts.connector,
|
|
239
|
+
authKind: opts.authKind,
|
|
240
|
+
/*
|
|
241
|
+
* The key is OMITTED, not sent empty. `{}` would assert that a
|
|
242
|
+
* credential exists and is blank — something the server has to store,
|
|
243
|
+
* with the revoke, rotation and audit meaning that carries. Absent says
|
|
244
|
+
* there is none.
|
|
245
|
+
*/
|
|
246
|
+
...(withoutCredential ? {} : { credential: credentialValue }),
|
|
247
|
+
...(privateConfig ? { privateConfig: privateConfig.value } : {}),
|
|
248
|
+
},
|
|
249
|
+
});
|
|
250
|
+
const one = parseDetail(res, "create");
|
|
251
|
+
if (!one)
|
|
252
|
+
return 1;
|
|
253
|
+
report(one, opts.json === true, "Created");
|
|
254
|
+
return 0;
|
|
255
|
+
}
|
|
256
|
+
catch (err) {
|
|
257
|
+
if (isAmbiguous(err))
|
|
258
|
+
ambiguous("create", key.key, err);
|
|
259
|
+
else
|
|
260
|
+
fail(explain(err));
|
|
261
|
+
return 1;
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
// ─── rename ───────────────────────────────────────────────────────────────────
|
|
265
|
+
export async function runConnectionRename(id, opts) {
|
|
266
|
+
const key = idempotencyKey(opts.idempotencyKey);
|
|
267
|
+
if (!key.ok)
|
|
268
|
+
return 1;
|
|
269
|
+
const c = await ctx(opts.namespace);
|
|
270
|
+
if (!c)
|
|
271
|
+
return 1;
|
|
272
|
+
const revision = await readRevision(c, id);
|
|
273
|
+
if (revision === null)
|
|
274
|
+
return 1;
|
|
275
|
+
try {
|
|
276
|
+
const res = await requestJson(c.remote, connectionPath(c, id), {
|
|
277
|
+
method: "PATCH",
|
|
278
|
+
token: c.token,
|
|
279
|
+
headers: { "Idempotency-Key": key.key },
|
|
280
|
+
json: { expectedSettingsRevision: revision, label: opts.label },
|
|
281
|
+
});
|
|
282
|
+
const one = parseDetail(res, "rename");
|
|
283
|
+
if (!one)
|
|
284
|
+
return 1;
|
|
285
|
+
report(one, opts.json === true, "Renamed");
|
|
286
|
+
return 0;
|
|
287
|
+
}
|
|
288
|
+
catch (err) {
|
|
289
|
+
if (isAmbiguous(err))
|
|
290
|
+
ambiguous("rename", key.key, err);
|
|
291
|
+
else
|
|
292
|
+
fail(explain(err));
|
|
293
|
+
return 1;
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
// ─── check ────────────────────────────────────────────────────────────────────
|
|
297
|
+
/*
|
|
298
|
+
* A probe, and only a probe.
|
|
299
|
+
*
|
|
300
|
+
* `unavailable` is a fact this command successfully established, so it exits 0.
|
|
301
|
+
* Exiting non-zero would make every wrapper script treat a correctly reported
|
|
302
|
+
* outage as a broken command. And nothing is disabled as a consequence: a
|
|
303
|
+
* network blip would otherwise take a working Connection offline, and only a
|
|
304
|
+
* person can decide that.
|
|
305
|
+
*/
|
|
306
|
+
export async function runConnectionCheck(id, opts) {
|
|
307
|
+
const c = await ctx(opts.namespace);
|
|
308
|
+
if (!c)
|
|
309
|
+
return 1;
|
|
310
|
+
try {
|
|
311
|
+
const res = await requestJson(c.remote, `${connectionPath(c, id)}:check`, {
|
|
312
|
+
method: "POST",
|
|
313
|
+
token: c.token,
|
|
314
|
+
// The action takes no body fields at all; the server rejects any.
|
|
315
|
+
json: {},
|
|
316
|
+
});
|
|
317
|
+
const result = parseCheck(res, "check");
|
|
318
|
+
if (!result)
|
|
319
|
+
return 1;
|
|
320
|
+
if (opts.json) {
|
|
321
|
+
emitJson(result);
|
|
322
|
+
return 0;
|
|
323
|
+
}
|
|
324
|
+
process.stdout.write(` status: ${result.status}\n`);
|
|
325
|
+
if (result.detectedAccess)
|
|
326
|
+
process.stdout.write(` access: ${result.detectedAccess}\n`);
|
|
327
|
+
if (result.reason)
|
|
328
|
+
process.stdout.write(` reason: ${result.reason}\n`);
|
|
329
|
+
process.stdout.write(` retry: ${result.retryable ? "may help" : "would not help"}\n`);
|
|
330
|
+
process.stdout.write(` checked: ${result.checkedAt}\n`);
|
|
331
|
+
if (result.managementHint)
|
|
332
|
+
process.stdout.write(` hint: ${result.managementHint}\n`);
|
|
333
|
+
/*
|
|
334
|
+
* Three outcomes, three sentences. What they have in common is that the
|
|
335
|
+
* probe SUCCEEDED — all three exit 0, and none of them changes anything.
|
|
336
|
+
*
|
|
337
|
+
* `unverified` is the one that is easiest to get wrong, and this client did
|
|
338
|
+
* get it wrong: it means the credential cannot be judged at this layer at
|
|
339
|
+
* all, because the connector binds validation to a target and the target
|
|
340
|
+
* belongs to a Source. Nothing is wrong with the credential, so there is
|
|
341
|
+
* nothing to disable and nothing to re-enter — the answer is to point it at
|
|
342
|
+
* something, which happens in `source import`. Telling a manager to replace
|
|
343
|
+
* a working credential is exactly the reaction §3.1 separates this status
|
|
344
|
+
* from `unavailable` to prevent.
|
|
345
|
+
*
|
|
346
|
+
* `connection-disabled` is not an outage either: the Connection is already
|
|
347
|
+
* off, and offering to disable it would name the command already in effect.
|
|
348
|
+
* Every other `unavailable` leaves it enabled, and there the offer is real.
|
|
349
|
+
*/
|
|
350
|
+
if (result.status === "unverified") {
|
|
351
|
+
process.stdout.write("\n Nothing was changed, and nothing is wrong with this credential.\n" +
|
|
352
|
+
" This connector can only be verified against a target, which belongs\n" +
|
|
353
|
+
" to a Source rather than to the Connection — so this layer cannot ask\n" +
|
|
354
|
+
" the provider anything. It gets exercised when a Source uses it:\n" +
|
|
355
|
+
` dreamlake source import --connector <kind> --connection ${id} --target <json>\n`);
|
|
356
|
+
}
|
|
357
|
+
else if (result.status === "unavailable") {
|
|
358
|
+
process.stdout.write(result.reason === "connection-disabled"
|
|
359
|
+
? "\n Nothing was changed. This connection is already disabled;\n" +
|
|
360
|
+
` enable it when you want to use it: dreamlake connection enable ${id}\n`
|
|
361
|
+
: "\n Nothing was changed. This connection is still enabled; disable it\n" +
|
|
362
|
+
` yourself if that is what you want: dreamlake connection disable ${id}\n`);
|
|
363
|
+
}
|
|
364
|
+
return 0;
|
|
365
|
+
}
|
|
366
|
+
catch (err) {
|
|
367
|
+
fail(explain(err));
|
|
368
|
+
return 1;
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
// ─── reconnect ────────────────────────────────────────────────────────────────
|
|
372
|
+
export async function runConnectionReconnect(id, opts) {
|
|
373
|
+
const credential = readCredential(opts);
|
|
374
|
+
if (credential === null) {
|
|
375
|
+
fail("a credential is required — pass --credential-file <path> or --credential-stdin");
|
|
376
|
+
return 1;
|
|
377
|
+
}
|
|
378
|
+
if (!credential.ok)
|
|
379
|
+
return 1;
|
|
380
|
+
const privateConfig = readPrivateConfig(opts.privateConfigFile);
|
|
381
|
+
if (privateConfig !== null && !privateConfig.ok)
|
|
382
|
+
return 1;
|
|
383
|
+
const key = idempotencyKey(opts.idempotencyKey);
|
|
384
|
+
if (!key.ok)
|
|
385
|
+
return 1;
|
|
386
|
+
const c = await ctx(opts.namespace);
|
|
387
|
+
if (!c)
|
|
388
|
+
return 1;
|
|
389
|
+
const revision = await readRevision(c, id);
|
|
390
|
+
if (revision === null)
|
|
391
|
+
return 1;
|
|
392
|
+
try {
|
|
393
|
+
const res = await requestJson(c.remote, `${connectionPath(c, id)}:reconnect`, {
|
|
394
|
+
method: "POST",
|
|
395
|
+
token: c.token,
|
|
396
|
+
headers: { "Idempotency-Key": key.key },
|
|
397
|
+
json: {
|
|
398
|
+
expectedSettingsRevision: revision,
|
|
399
|
+
credential: credential.value,
|
|
400
|
+
...(privateConfig ? { privateConfig: privateConfig.value } : {}),
|
|
401
|
+
...(opts.enableAfterSuccess ? { enableAfterSuccess: true } : {}),
|
|
402
|
+
},
|
|
403
|
+
});
|
|
404
|
+
const one = parseDetail(res, "reconnect");
|
|
405
|
+
if (!one)
|
|
406
|
+
return 1;
|
|
407
|
+
report(one, opts.json === true, "Reconnected");
|
|
408
|
+
return 0;
|
|
409
|
+
}
|
|
410
|
+
catch (err) {
|
|
411
|
+
if (isAmbiguous(err))
|
|
412
|
+
ambiguous("reconnect", key.key, err);
|
|
413
|
+
else
|
|
414
|
+
fail(explain(err));
|
|
415
|
+
return 1;
|
|
416
|
+
}
|
|
417
|
+
}
|
|
418
|
+
// ─── enable / disable ─────────────────────────────────────────────────────────
|
|
419
|
+
async function lifecycle(id, action, opts) {
|
|
420
|
+
const key = idempotencyKey(opts.idempotencyKey);
|
|
421
|
+
if (!key.ok)
|
|
422
|
+
return 1;
|
|
423
|
+
const c = await ctx(opts.namespace);
|
|
424
|
+
if (!c)
|
|
425
|
+
return 1;
|
|
426
|
+
const revision = await readRevision(c, id);
|
|
427
|
+
if (revision === null)
|
|
428
|
+
return 1;
|
|
429
|
+
try {
|
|
430
|
+
const res = await requestJson(c.remote, `${connectionPath(c, id)}:${action}`, {
|
|
431
|
+
method: "POST",
|
|
432
|
+
token: c.token,
|
|
433
|
+
headers: { "Idempotency-Key": key.key },
|
|
434
|
+
json: { expectedSettingsRevision: revision },
|
|
435
|
+
});
|
|
436
|
+
const one = parseDetail(res, action);
|
|
437
|
+
if (!one)
|
|
438
|
+
return 1;
|
|
439
|
+
report(one, opts.json === true, action === "enable" ? "Enabled" : "Disabled");
|
|
440
|
+
return 0;
|
|
441
|
+
}
|
|
442
|
+
catch (err) {
|
|
443
|
+
if (isAmbiguous(err))
|
|
444
|
+
ambiguous(action, key.key, err);
|
|
445
|
+
else
|
|
446
|
+
fail(explain(err));
|
|
447
|
+
return 1;
|
|
448
|
+
}
|
|
449
|
+
}
|
|
450
|
+
export const runConnectionEnable = (id, o) => lifecycle(id, "enable", o);
|
|
451
|
+
export const runConnectionDisable = (id, o) => lifecycle(id, "disable", o);
|
|
452
|
+
// ─── delete ───────────────────────────────────────────────────────────────────
|
|
453
|
+
export async function runConnectionDelete(id, opts) {
|
|
454
|
+
const key = idempotencyKey(opts.idempotencyKey);
|
|
455
|
+
if (!key.ok)
|
|
456
|
+
return 1;
|
|
457
|
+
const c = await ctx(opts.namespace);
|
|
458
|
+
if (!c)
|
|
459
|
+
return 1;
|
|
460
|
+
const revision = await readRevision(c, id);
|
|
461
|
+
if (revision === null)
|
|
462
|
+
return 1;
|
|
463
|
+
try {
|
|
464
|
+
await requestJson(c.remote, connectionPath(c, id), {
|
|
465
|
+
method: "DELETE",
|
|
466
|
+
token: c.token,
|
|
467
|
+
headers: { "Idempotency-Key": key.key },
|
|
468
|
+
json: { expectedSettingsRevision: revision },
|
|
469
|
+
});
|
|
470
|
+
if (opts.json) {
|
|
471
|
+
emitJson({ id, deleted: true });
|
|
472
|
+
return 0;
|
|
473
|
+
}
|
|
474
|
+
ok(`Deleted connection ${id}`);
|
|
475
|
+
return 0;
|
|
476
|
+
}
|
|
477
|
+
catch (err) {
|
|
478
|
+
/*
|
|
479
|
+
* A Connection still in use is refused, and it stays refused. Detaching the
|
|
480
|
+
* Sources first would be this command silently doing something far larger
|
|
481
|
+
* than "delete a connection" — every one of them loses its credential, and
|
|
482
|
+
* nothing here knows whether that is acceptable.
|
|
483
|
+
*
|
|
484
|
+
* Branched on `code`, which is the envelope's stable identity for the
|
|
485
|
+
* refusal. The earlier version matched the CODE against the human MESSAGE,
|
|
486
|
+
* and the server's actual message is "This Connection is still used by one
|
|
487
|
+
* or more Sources." — the code appears nowhere in it. That test passed only
|
|
488
|
+
* because its fixture put the code in the message, which no server does.
|
|
489
|
+
*/
|
|
490
|
+
if (err instanceof HttpError && err.code === "CONNECTION_IN_USE") {
|
|
491
|
+
fail(`${err.message}\n` +
|
|
492
|
+
` Nothing was deleted and no source was changed. See what still uses it:\n` +
|
|
493
|
+
` dreamlake connection affected-sources ${id}`);
|
|
494
|
+
return 1;
|
|
495
|
+
}
|
|
496
|
+
if (isAmbiguous(err))
|
|
497
|
+
ambiguous("delete", key.key, err);
|
|
498
|
+
else
|
|
499
|
+
fail(explain(err));
|
|
500
|
+
return 1;
|
|
501
|
+
}
|
|
502
|
+
}
|
|
503
|
+
// ─── registration ─────────────────────────────────────────────────────────────
|
|
504
|
+
const CREDENTIAL_HELP = "A credential is never taken as an argument: argv is visible in `ps` and is " +
|
|
505
|
+
"saved to your shell history. Use --credential-file, or pipe it in with " +
|
|
506
|
+
"--credential-stdin.";
|
|
507
|
+
export function registerConnectionWriteCommands(connection) {
|
|
508
|
+
const credentialOpts = (cmd) => cmd
|
|
509
|
+
.option("--credential-file <path>", "JSON file holding the credential")
|
|
510
|
+
.option("--credential-stdin", "read the credential as JSON from stdin")
|
|
511
|
+
.option("--private-config-file <path>", "JSON file holding non-secret connector config")
|
|
512
|
+
.addHelpText("after", `\n${CREDENTIAL_HELP}\n`);
|
|
513
|
+
const idempotent = (cmd) => cmd.option("--idempotency-key <key>", "reuse a key from a previous attempt that never answered");
|
|
514
|
+
idempotent(credentialOpts(strictArgs(connection.command("create"))
|
|
515
|
+
.description("create a connection from a credential you supply")
|
|
516
|
+
.requiredOption("--label <text>", "human label")
|
|
517
|
+
.requiredOption("--connector <kind>", "connector kind (the server defines these)")
|
|
518
|
+
.requiredOption("--auth-kind <kind>", "auth kind (the server defines these)")
|
|
519
|
+
/*
|
|
520
|
+
* Create only — deliberately not on `credentialOpts`, which reconnect
|
|
521
|
+
* shares. Reconnect exists to REPLACE a credential; "replace it with
|
|
522
|
+
* none" is not that operation, and a Connection that needs none has
|
|
523
|
+
* nothing to replace.
|
|
524
|
+
*
|
|
525
|
+
* Commander reads `--no-credential` as the NEGATION of a boolean
|
|
526
|
+
* `credential`, so it arrives as `opts.credential === false` and
|
|
527
|
+
* defaults to `true` — there is no `noCredential` field. That is worth
|
|
528
|
+
* writing down: reading the wrong one silently never fires.
|
|
529
|
+
*/
|
|
530
|
+
.option("--no-credential", "send no credential at all — only for an auth kind the server says needs none")
|
|
531
|
+
.addHelpText("after", "\n--no-credential omits the credential from the request entirely. The server " +
|
|
532
|
+
"decides whether that auth kind is allowed to have none, and refuses the " +
|
|
533
|
+
"request if it is not.\n")))
|
|
534
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
535
|
+
.option("--json", "emit JSON")
|
|
536
|
+
.action(async (opts) => process.exit(await runConnectionCreate(opts)));
|
|
537
|
+
idempotent(strictArgs(connection.command("rename")))
|
|
538
|
+
.description("change a connection's label")
|
|
539
|
+
.argument("<id>", "connection id (see 'dreamlake connection list')")
|
|
540
|
+
.requiredOption("--label <text>", "the new label")
|
|
541
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
542
|
+
.option("--json", "emit JSON")
|
|
543
|
+
.action(async (id, opts) => process.exit(await runConnectionRename(id, opts)));
|
|
544
|
+
strictArgs(connection.command("check"))
|
|
545
|
+
.description("probe a connection; reports status without changing anything")
|
|
546
|
+
.argument("<id>", "connection id")
|
|
547
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
548
|
+
.option("--json", "emit JSON")
|
|
549
|
+
.action(async (id, opts) => process.exit(await runConnectionCheck(id, opts)));
|
|
550
|
+
idempotent(credentialOpts(strictArgs(connection.command("reconnect"))
|
|
551
|
+
.description("replace a connection's credential")
|
|
552
|
+
.argument("<id>", "connection id")
|
|
553
|
+
.option("--enable-after-success", "enable the connection if the new credential works")))
|
|
554
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
555
|
+
.option("--json", "emit JSON")
|
|
556
|
+
.action(async (id, opts) => process.exit(await runConnectionReconnect(id, opts)));
|
|
557
|
+
for (const action of ["enable", "disable"]) {
|
|
558
|
+
idempotent(strictArgs(connection.command(action)))
|
|
559
|
+
.description(`${action} a connection`)
|
|
560
|
+
.argument("<id>", "connection id")
|
|
561
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
562
|
+
.option("--json", "emit JSON")
|
|
563
|
+
.action(async (id, opts) => process.exit(await (action === "enable"
|
|
564
|
+
? runConnectionEnable(id, opts)
|
|
565
|
+
: runConnectionDisable(id, opts))));
|
|
566
|
+
}
|
|
567
|
+
idempotent(strictArgs(connection.command("delete")))
|
|
568
|
+
.description("delete a connection; refused while a source still uses it")
|
|
569
|
+
.argument("<id>", "connection id")
|
|
570
|
+
.option("--namespace <slug>", "namespace slug (default: active login)")
|
|
571
|
+
.option("--json", "emit JSON")
|
|
572
|
+
.action(async (id, opts) => process.exit(await runConnectionDelete(id, opts)));
|
|
573
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { Command } from "commander";
|
|
2
|
+
interface CreateOpts {
|
|
3
|
+
project?: string;
|
|
4
|
+
episode?: string;
|
|
5
|
+
description?: string;
|
|
6
|
+
tags?: string;
|
|
7
|
+
}
|
|
8
|
+
export declare function runCreateBindr(name: string, opts: CreateOpts): Promise<number>;
|
|
9
|
+
export declare function runCreateDataset(name: string, opts: CreateOpts): Promise<number>;
|
|
10
|
+
interface CreateProjectOpts {
|
|
11
|
+
namespace?: string;
|
|
12
|
+
slug?: string;
|
|
13
|
+
description?: string;
|
|
14
|
+
visibility?: string;
|
|
15
|
+
tags?: string;
|
|
16
|
+
}
|
|
17
|
+
export declare function runCreateProject(name: string, opts: CreateProjectOpts): Promise<number>;
|
|
18
|
+
export declare function registerCreateCommand(program: Command): void;
|
|
19
|
+
export {};
|