@dreamlake/dreamlake-cli 0.88.0 → 0.89.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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,497 @@
|
|
|
1
|
+
// The wire contract, checked field by field — and the only shape this CLI ever
|
|
2
|
+
// prints.
|
|
3
|
+
//
|
|
4
|
+
// Two rules, and they are really one rule.
|
|
5
|
+
//
|
|
6
|
+
// Nothing is printed that the contract did not declare. `--json` emits an
|
|
7
|
+
// object BUILT from validated fields, never the response that arrived. A
|
|
8
|
+
// pass-through client forwards whatever it is handed, so a response that one
|
|
9
|
+
// day carried a `credential`, a `secretRef` or a provider account id — a server
|
|
10
|
+
// bug, a middlebox, an endpoint that is not the one the caller thought — would
|
|
11
|
+
// be written straight into the log the caller was piping into. Projecting by
|
|
12
|
+
// name makes that impossible here regardless of what arrives, which is the same
|
|
13
|
+
// discipline the server applies on the way out.
|
|
14
|
+
//
|
|
15
|
+
// Nothing is defaulted. A missing `affectedSourceCount` rendered as `0` reads as
|
|
16
|
+
// "nothing uses this, it is safe to delete". The RFC declares these fields
|
|
17
|
+
// required, so an absent one is a malformed response and is reported as one.
|
|
18
|
+
//
|
|
19
|
+
// The RFC (connection-contract §5, §7) is the authority here, not the server's
|
|
20
|
+
// current JSON schema: several of those response objects do not declare
|
|
21
|
+
// `required` yet — a server gap being closed on its own line — and a client
|
|
22
|
+
// that took the looser schema as the contract would quietly accept a response
|
|
23
|
+
// the contract forbids. Failing closed against the RFC is what keeps this
|
|
24
|
+
// correct across that fix instead of dependent on it.
|
|
25
|
+
import { fail } from "../helpers.js";
|
|
26
|
+
/**
|
|
27
|
+
* §5's three statuses.
|
|
28
|
+
*
|
|
29
|
+
* `unverified` is not a flavour of `unavailable`. §3.1 requires a `target-bound`
|
|
30
|
+
* connector — `s3` is one — to answer it, because that credential cannot be
|
|
31
|
+
* validated without a target, and the bucket belongs to a Source rather than to
|
|
32
|
+
* the Connection. Reporting it as `unavailable` would send a manager to replace
|
|
33
|
+
* a credential nobody found fault with.
|
|
34
|
+
*
|
|
35
|
+
* This client enumerated two statuses for one slice, following §5's DTO before
|
|
36
|
+
* §5 was corrected to match §3.1, and `connection check` failed for every S3
|
|
37
|
+
* Connection as a result. The vocabulary is transcribed from the contract now,
|
|
38
|
+
* whole.
|
|
39
|
+
*/
|
|
40
|
+
export const CHECK_STATUSES = ["available", "unavailable", "unverified"];
|
|
41
|
+
export const CHECK_REASONS = [
|
|
42
|
+
"connection-disabled",
|
|
43
|
+
"upstream-auth-failed",
|
|
44
|
+
"upstream-forbidden",
|
|
45
|
+
"upstream-not-found",
|
|
46
|
+
"upstream-rate-limited",
|
|
47
|
+
"upstream-timeout",
|
|
48
|
+
"upstream-unavailable",
|
|
49
|
+
"target-required",
|
|
50
|
+
"unknown",
|
|
51
|
+
];
|
|
52
|
+
// ─── the checker ──────────────────────────────────────────────────────────────
|
|
53
|
+
export function isObject(v) {
|
|
54
|
+
return typeof v === "object" && v !== null && !Array.isArray(v);
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* RFC 3339, checked against the calendar — not against `Date.parse`.
|
|
58
|
+
*
|
|
59
|
+
* A pattern alone accepts `2026-02-31` and `2026-01-01T24:00:00Z`, and
|
|
60
|
+
* `Date.parse` does not save it: JavaScript NORMALISES both rather than
|
|
61
|
+
* refusing them, so the check passes and the value that gets rendered is a
|
|
62
|
+
* moment that does not exist, silently moved to March 3rd and to the next day.
|
|
63
|
+
* For an OAuth `expiresAt` that is a deadline the caller is told and cannot
|
|
64
|
+
* rely on. So the fields are extracted and range-checked, February included.
|
|
65
|
+
*
|
|
66
|
+
* RFC 3339's leap second — a literal `:60` — is deliberately NOT accepted. Every
|
|
67
|
+
* timestamp this client reads is produced by `Date#toISOString`, which cannot
|
|
68
|
+
* emit one, and accepting it would mean accepting a value `Date` quietly rolls
|
|
69
|
+
* into the following minute. Revisit if a server ever has a reason to send one.
|
|
70
|
+
*/
|
|
71
|
+
const RFC3339 = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:[Zz]|[+-](\d{2}):(\d{2}))$/;
|
|
72
|
+
function daysInMonth(year, month) {
|
|
73
|
+
if (month === 2) {
|
|
74
|
+
const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
|
|
75
|
+
return leap ? 29 : 28;
|
|
76
|
+
}
|
|
77
|
+
return [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
|
|
78
|
+
}
|
|
79
|
+
function isRfc3339(v) {
|
|
80
|
+
const m = RFC3339.exec(v);
|
|
81
|
+
if (!m)
|
|
82
|
+
return false;
|
|
83
|
+
const [year, month, day, hour, minute, second] = m.slice(1, 7).map(Number);
|
|
84
|
+
if (month < 1 || month > 12)
|
|
85
|
+
return false;
|
|
86
|
+
if (day < 1 || day > daysInMonth(year, month))
|
|
87
|
+
return false;
|
|
88
|
+
if (hour > 23 || minute > 59 || second > 59)
|
|
89
|
+
return false;
|
|
90
|
+
if (m[7] !== undefined && (Number(m[7]) > 23 || Number(m[8]) > 59))
|
|
91
|
+
return false;
|
|
92
|
+
return true;
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Collects every problem before reporting, rather than stopping at the first.
|
|
96
|
+
*
|
|
97
|
+
* A response that is wrong in four places produces one message naming four
|
|
98
|
+
* fields. Reporting them one at a time turns diagnosing a contract break into
|
|
99
|
+
* four round trips.
|
|
100
|
+
*/
|
|
101
|
+
class Fields {
|
|
102
|
+
where;
|
|
103
|
+
o;
|
|
104
|
+
bad = [];
|
|
105
|
+
constructor(where, o) {
|
|
106
|
+
this.where = where;
|
|
107
|
+
this.o = o;
|
|
108
|
+
}
|
|
109
|
+
reject(msg) {
|
|
110
|
+
this.bad.push(msg);
|
|
111
|
+
}
|
|
112
|
+
string(k) {
|
|
113
|
+
const v = this.o[k];
|
|
114
|
+
if (typeof v !== "string" || v === "") {
|
|
115
|
+
this.reject(`${k} must be a non-empty string`);
|
|
116
|
+
return "";
|
|
117
|
+
}
|
|
118
|
+
return v;
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* An `{id, label}` pair, required whole.
|
|
122
|
+
*
|
|
123
|
+
* Both halves, because half a name is not a name: without `id` there is
|
|
124
|
+
* nothing to match on, and without `label` the row prints blank. The label is
|
|
125
|
+
* judged non-blank on its TRIMMED value but returned as the server sent it —
|
|
126
|
+
* a name made of spaces renders as an empty column, which is
|
|
127
|
+
* indistinguishable from a bug, while trimming it here would make this client
|
|
128
|
+
* the author of a name the server declared.
|
|
129
|
+
*/
|
|
130
|
+
named(k) {
|
|
131
|
+
const v = this.o[k];
|
|
132
|
+
if (!isObject(v)) {
|
|
133
|
+
this.reject(`${k} must be an object`);
|
|
134
|
+
return { id: "", label: "" };
|
|
135
|
+
}
|
|
136
|
+
const id = v["id"];
|
|
137
|
+
const label = v["label"];
|
|
138
|
+
if (typeof id !== "string" || id === "") {
|
|
139
|
+
this.reject(`${k}.id must be a non-empty string`);
|
|
140
|
+
}
|
|
141
|
+
if (typeof label !== "string" || label.trim() === "") {
|
|
142
|
+
this.reject(`${k}.label must be a non-blank string`);
|
|
143
|
+
}
|
|
144
|
+
return {
|
|
145
|
+
id: typeof id === "string" ? id : "",
|
|
146
|
+
label: typeof label === "string" ? label : "",
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
oneOf(k, allowed) {
|
|
150
|
+
const v = this.o[k];
|
|
151
|
+
if (typeof v !== "string" || !allowed.includes(v)) {
|
|
152
|
+
this.reject(`${k} must be one of: ${allowed.join(", ")}`);
|
|
153
|
+
return allowed[0];
|
|
154
|
+
}
|
|
155
|
+
return v;
|
|
156
|
+
}
|
|
157
|
+
optionalOneOf(k, allowed) {
|
|
158
|
+
if (this.o[k] === undefined)
|
|
159
|
+
return undefined;
|
|
160
|
+
return this.oneOf(k, allowed);
|
|
161
|
+
}
|
|
162
|
+
optionalString(k) {
|
|
163
|
+
const v = this.o[k];
|
|
164
|
+
if (v === undefined)
|
|
165
|
+
return undefined;
|
|
166
|
+
if (typeof v !== "string") {
|
|
167
|
+
this.reject(`${k} must be a string when present`);
|
|
168
|
+
return undefined;
|
|
169
|
+
}
|
|
170
|
+
return v === "" ? undefined : v;
|
|
171
|
+
}
|
|
172
|
+
/** A non-negative safe integer — a count, or a revision about to be CAS. */
|
|
173
|
+
count(k) {
|
|
174
|
+
const v = this.o[k];
|
|
175
|
+
if (typeof v !== "number" || !Number.isSafeInteger(v) || v < 0) {
|
|
176
|
+
this.reject(`${k} must be a non-negative integer`);
|
|
177
|
+
return -1;
|
|
178
|
+
}
|
|
179
|
+
return v;
|
|
180
|
+
}
|
|
181
|
+
bool(k) {
|
|
182
|
+
const v = this.o[k];
|
|
183
|
+
if (typeof v !== "boolean") {
|
|
184
|
+
this.reject(`${k} must be a boolean`);
|
|
185
|
+
return false;
|
|
186
|
+
}
|
|
187
|
+
return v;
|
|
188
|
+
}
|
|
189
|
+
timestamp(k) {
|
|
190
|
+
const v = this.o[k];
|
|
191
|
+
if (typeof v !== "string" || !isRfc3339(v)) {
|
|
192
|
+
this.reject(`${k} must be an RFC 3339 timestamp`);
|
|
193
|
+
return "";
|
|
194
|
+
}
|
|
195
|
+
return v;
|
|
196
|
+
}
|
|
197
|
+
capabilities(k) {
|
|
198
|
+
const v = this.o[k];
|
|
199
|
+
const out = {
|
|
200
|
+
manage: true,
|
|
201
|
+
reconnect: false,
|
|
202
|
+
disable: false,
|
|
203
|
+
enable: false,
|
|
204
|
+
delete: false,
|
|
205
|
+
};
|
|
206
|
+
if (!isObject(v)) {
|
|
207
|
+
this.reject(`${k} must be an object`);
|
|
208
|
+
return out;
|
|
209
|
+
}
|
|
210
|
+
for (const name of ["disable", "enable", "delete"]) {
|
|
211
|
+
const flag = v[name];
|
|
212
|
+
if (typeof flag !== "boolean") {
|
|
213
|
+
this.reject(`${k}.${name} must be a boolean`);
|
|
214
|
+
continue;
|
|
215
|
+
}
|
|
216
|
+
out[name] = flag;
|
|
217
|
+
}
|
|
218
|
+
// `reconnect` is an ordinary boolean: a credential-less Connection has no
|
|
219
|
+
// credential to replace, so `false` is a real answer.
|
|
220
|
+
const reconnect = v["reconnect"];
|
|
221
|
+
if (typeof reconnect !== "boolean") {
|
|
222
|
+
this.reject(`${k}.reconnect must be a boolean`);
|
|
223
|
+
}
|
|
224
|
+
else {
|
|
225
|
+
out.reconnect = reconnect;
|
|
226
|
+
}
|
|
227
|
+
// Not `boolean` — `true`. See the Capabilities doc comment.
|
|
228
|
+
if (v["manage"] !== true) {
|
|
229
|
+
this.reject(`${k}.manage must be true — these DTOs only reach a manager`);
|
|
230
|
+
}
|
|
231
|
+
return out;
|
|
232
|
+
}
|
|
233
|
+
configured(k) {
|
|
234
|
+
const v = this.o[k];
|
|
235
|
+
const out = {};
|
|
236
|
+
if (!isObject(v)) {
|
|
237
|
+
this.reject(`${k} must be an object`);
|
|
238
|
+
return out;
|
|
239
|
+
}
|
|
240
|
+
for (const [name, value] of Object.entries(v)) {
|
|
241
|
+
if (value !== null &&
|
|
242
|
+
typeof value !== "string" &&
|
|
243
|
+
typeof value !== "number" &&
|
|
244
|
+
typeof value !== "boolean") {
|
|
245
|
+
// The masking guarantee, enforced on arrival. Anything structured under
|
|
246
|
+
// this key is not a presence flag.
|
|
247
|
+
this.reject(`${k}.${name} must be a string, number, boolean or null`);
|
|
248
|
+
continue;
|
|
249
|
+
}
|
|
250
|
+
out[name] = value;
|
|
251
|
+
}
|
|
252
|
+
return out;
|
|
253
|
+
}
|
|
254
|
+
/**
|
|
255
|
+
* `nextCursor` — present, and either a cursor or an explicit null.
|
|
256
|
+
*
|
|
257
|
+
* An absent key is not the same as `null`. "There is no next page" is a fact
|
|
258
|
+
* the server states; a missing field means the client is guessing, and the
|
|
259
|
+
* guess ends a paged read early and silently. That is precisely the shape of
|
|
260
|
+
* "this Connection appears to be gone".
|
|
261
|
+
*/
|
|
262
|
+
cursor(k) {
|
|
263
|
+
if (!(k in this.o)) {
|
|
264
|
+
this.reject(`${k} must be present — a cursor, or null on the last page`);
|
|
265
|
+
return null;
|
|
266
|
+
}
|
|
267
|
+
const v = this.o[k];
|
|
268
|
+
if (v === null)
|
|
269
|
+
return null;
|
|
270
|
+
if (typeof v !== "string" || v === "") {
|
|
271
|
+
this.reject(`${k} must be a non-empty string or null`);
|
|
272
|
+
return null;
|
|
273
|
+
}
|
|
274
|
+
return v;
|
|
275
|
+
}
|
|
276
|
+
/**
|
|
277
|
+
* `lifecycleCounts` — present, and either three numbers or an explicit null.
|
|
278
|
+
*
|
|
279
|
+
* Absent is not `null` here either. `null` is the server stating it could not
|
|
280
|
+
* count; an absent key would leave this client deciding what to print, and
|
|
281
|
+
* "no numbers" and "an older server" are not the same fact.
|
|
282
|
+
*/
|
|
283
|
+
counts(k) {
|
|
284
|
+
if (!(k in this.o)) {
|
|
285
|
+
this.reject(`${k} must be present — three counts, or null when uncounted`);
|
|
286
|
+
return null;
|
|
287
|
+
}
|
|
288
|
+
const v = this.o[k];
|
|
289
|
+
if (v === null)
|
|
290
|
+
return null;
|
|
291
|
+
if (!isObject(v)) {
|
|
292
|
+
this.reject(`${k} must be an object or null`);
|
|
293
|
+
return null;
|
|
294
|
+
}
|
|
295
|
+
const out = { all: -1, active: -1, disabled: -1 };
|
|
296
|
+
let usable = true;
|
|
297
|
+
for (const name of ["all", "active", "disabled"]) {
|
|
298
|
+
const n = v[name];
|
|
299
|
+
if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 0) {
|
|
300
|
+
this.reject(`${k}.${name} must be a non-negative integer`);
|
|
301
|
+
usable = false;
|
|
302
|
+
continue;
|
|
303
|
+
}
|
|
304
|
+
out[name] = n;
|
|
305
|
+
}
|
|
306
|
+
/*
|
|
307
|
+
* `all === active + disabled`, which the contract states as a guarantee
|
|
308
|
+
* rather than a hint — `all` is derived from the other two rather than
|
|
309
|
+
* queried, so a set that violates it did not come from the counting logic
|
|
310
|
+
* working. Refused rather than shown: three numbers that contradict each
|
|
311
|
+
* other are not a degraded answer, they are an answer nobody can act on,
|
|
312
|
+
* and picking which two to believe is not this client's decision.
|
|
313
|
+
*/
|
|
314
|
+
if (usable && out.all !== out.active + out.disabled) {
|
|
315
|
+
this.reject(`${k} does not add up: all=${out.all}, active=${out.active}, disabled=${out.disabled}`);
|
|
316
|
+
}
|
|
317
|
+
return out;
|
|
318
|
+
}
|
|
319
|
+
ok() {
|
|
320
|
+
if (this.bad.length === 0)
|
|
321
|
+
return true;
|
|
322
|
+
fail(`${this.where}: ${this.bad.join("; ")}`);
|
|
323
|
+
return false;
|
|
324
|
+
}
|
|
325
|
+
}
|
|
326
|
+
function fields(res, where) {
|
|
327
|
+
if (!isObject(res)) {
|
|
328
|
+
fail(`${where}: expected an object`);
|
|
329
|
+
return null;
|
|
330
|
+
}
|
|
331
|
+
return new Fields(where, res);
|
|
332
|
+
}
|
|
333
|
+
// ─── the projections ──────────────────────────────────────────────────────────
|
|
334
|
+
function summaryOf(f) {
|
|
335
|
+
return {
|
|
336
|
+
id: f.string("id"),
|
|
337
|
+
label: f.string("label"),
|
|
338
|
+
connectorKind: f.string("connectorKind"),
|
|
339
|
+
category: f.string("category"),
|
|
340
|
+
authKind: f.string("authKind"),
|
|
341
|
+
provider: f.named("provider"),
|
|
342
|
+
authentication: f.named("authentication"),
|
|
343
|
+
lifecycle: f.oneOf("lifecycle", ["active", "disabled"]),
|
|
344
|
+
settingsRevision: f.count("settingsRevision"),
|
|
345
|
+
credentialVersion: f.count("credentialVersion"),
|
|
346
|
+
affectedSourceCount: f.count("affectedSourceCount"),
|
|
347
|
+
createdAt: f.timestamp("createdAt"),
|
|
348
|
+
updatedAt: f.timestamp("updatedAt"),
|
|
349
|
+
capabilities: f.capabilities("capabilities"),
|
|
350
|
+
};
|
|
351
|
+
}
|
|
352
|
+
export function parseSummary(res, where) {
|
|
353
|
+
const f = fields(res, where);
|
|
354
|
+
if (!f)
|
|
355
|
+
return null;
|
|
356
|
+
const out = summaryOf(f);
|
|
357
|
+
return f.ok() ? out : null;
|
|
358
|
+
}
|
|
359
|
+
export function parseDetail(res, where) {
|
|
360
|
+
const f = fields(res, where);
|
|
361
|
+
if (!f)
|
|
362
|
+
return null;
|
|
363
|
+
const out = { ...summaryOf(f), configured: f.configured("configured") };
|
|
364
|
+
return f.ok() ? out : null;
|
|
365
|
+
}
|
|
366
|
+
export function parseAffected(res, where) {
|
|
367
|
+
const f = fields(res, where);
|
|
368
|
+
if (!f)
|
|
369
|
+
return null;
|
|
370
|
+
const out = {
|
|
371
|
+
sourceId: f.string("sourceId"),
|
|
372
|
+
name: f.string("name"),
|
|
373
|
+
lifecycle: f.string("lifecycle"),
|
|
374
|
+
};
|
|
375
|
+
return f.ok() ? out : null;
|
|
376
|
+
}
|
|
377
|
+
/**
|
|
378
|
+
* A page.
|
|
379
|
+
*
|
|
380
|
+
* `withCounts` is passed only where the contract declares `lifecycleCounts` —
|
|
381
|
+
* the Connection list has it, affected-sources does not — so asking for it is
|
|
382
|
+
* never a guess about which endpoint this is.
|
|
383
|
+
*/
|
|
384
|
+
export function parsePage(res, where, item, withCounts = false) {
|
|
385
|
+
const f = fields(res, where);
|
|
386
|
+
if (!f)
|
|
387
|
+
return null;
|
|
388
|
+
const raw = res.items;
|
|
389
|
+
if (!Array.isArray(raw)) {
|
|
390
|
+
fail(`${where}: items must be an array`);
|
|
391
|
+
return null;
|
|
392
|
+
}
|
|
393
|
+
const nextCursor = f.cursor("nextCursor");
|
|
394
|
+
const lifecycleCounts = withCounts ? f.counts("lifecycleCounts") : undefined;
|
|
395
|
+
if (!f.ok())
|
|
396
|
+
return null;
|
|
397
|
+
const items = [];
|
|
398
|
+
for (const one of raw) {
|
|
399
|
+
const parsed = item(one, where);
|
|
400
|
+
if (!parsed)
|
|
401
|
+
return null;
|
|
402
|
+
items.push(parsed);
|
|
403
|
+
}
|
|
404
|
+
return withCounts ? { items, nextCursor, lifecycleCounts } : { items, nextCursor };
|
|
405
|
+
}
|
|
406
|
+
export function parseCheck(res, where) {
|
|
407
|
+
const f = fields(res, where);
|
|
408
|
+
if (!f)
|
|
409
|
+
return null;
|
|
410
|
+
const out = {
|
|
411
|
+
status: f.oneOf("status", CHECK_STATUSES),
|
|
412
|
+
detectedAccess: f.optionalOneOf("detectedAccess", ["read", "read-write", "unknown"]),
|
|
413
|
+
reason: f.optionalOneOf("reason", CHECK_REASONS),
|
|
414
|
+
retryable: f.bool("retryable"),
|
|
415
|
+
checkedAt: f.timestamp("checkedAt"),
|
|
416
|
+
managementHint: f.optionalString("managementHint"),
|
|
417
|
+
};
|
|
418
|
+
return f.ok() ? out : null;
|
|
419
|
+
}
|
|
420
|
+
export function parseBegin(res, where) {
|
|
421
|
+
const f = fields(res, where);
|
|
422
|
+
if (!f)
|
|
423
|
+
return null;
|
|
424
|
+
const out = {
|
|
425
|
+
operationId: f.string("operationId"),
|
|
426
|
+
authorizationUrl: f.string("authorizationUrl"),
|
|
427
|
+
expiresAt: f.timestamp("expiresAt"),
|
|
428
|
+
};
|
|
429
|
+
if (!f.ok())
|
|
430
|
+
return null;
|
|
431
|
+
/*
|
|
432
|
+
* The URL is built by the server's adapter from the connector descriptor's
|
|
433
|
+
* declared endpoint, never from request input — but this process is about to
|
|
434
|
+
* hand it to a browser, so the one property that matters here is checked, and
|
|
435
|
+
* checked by parsing rather than by prefix. `startsWith("https://")` is a
|
|
436
|
+
* string test standing in for a scheme test, and it is wrong in both
|
|
437
|
+
* directions: it accepts the bare `"https://"`, which has no host and is not
|
|
438
|
+
* a URL at all, and it rejects `HTTPS://…`, which is the same URL with the
|
|
439
|
+
* scheme spelled in capitals. Parsing asks the question the browser will
|
|
440
|
+
* ask. A downgrade would put the authorization request, and the state token
|
|
441
|
+
* in its query string, on the wire in the clear.
|
|
442
|
+
*/
|
|
443
|
+
let parsed;
|
|
444
|
+
try {
|
|
445
|
+
parsed = new URL(out.authorizationUrl);
|
|
446
|
+
}
|
|
447
|
+
catch {
|
|
448
|
+
fail(`${where}: authorizationUrl is not a URL`);
|
|
449
|
+
return null;
|
|
450
|
+
}
|
|
451
|
+
if (parsed.protocol !== "https:") {
|
|
452
|
+
fail(`${where}: authorizationUrl must be https, got ${parsed.protocol}//`);
|
|
453
|
+
return null;
|
|
454
|
+
}
|
|
455
|
+
return out;
|
|
456
|
+
}
|
|
457
|
+
/**
|
|
458
|
+
* The operation union, with the invariant enforced at the edge.
|
|
459
|
+
*
|
|
460
|
+
* `succeeded` implies a Connection and `failed` implies an error. Checking that
|
|
461
|
+
* here — rather than in whichever branch happens to render — is what stops a
|
|
462
|
+
* `--json` consumer from being handed `{"state":"succeeded"}` with nothing in
|
|
463
|
+
* it, which is what a silently dropped `connection` looks like on the wire.
|
|
464
|
+
*
|
|
465
|
+
* The failure `code` is NOT checked against a list of known codes. A code this
|
|
466
|
+
* build has never heard of is still the server's stable identity for what went
|
|
467
|
+
* wrong, and refusing to print it would turn a new server-side failure into a
|
|
468
|
+
* client-side one.
|
|
469
|
+
*/
|
|
470
|
+
export function parseOAuthStatus(res, where) {
|
|
471
|
+
const f = fields(res, where);
|
|
472
|
+
if (!f)
|
|
473
|
+
return null;
|
|
474
|
+
const state = f.oneOf("state", ["pending", "exchanging", "succeeded", "failed"]);
|
|
475
|
+
if (!f.ok())
|
|
476
|
+
return null;
|
|
477
|
+
const o = res;
|
|
478
|
+
if (state === "succeeded") {
|
|
479
|
+
const connection = parseDetail(o.connection, `${where}: connection`);
|
|
480
|
+
if (!connection)
|
|
481
|
+
return null;
|
|
482
|
+
return { state, connection };
|
|
483
|
+
}
|
|
484
|
+
if (state === "failed") {
|
|
485
|
+
const e = fields(o.error, `${where}: error`);
|
|
486
|
+
if (!e)
|
|
487
|
+
return null;
|
|
488
|
+
const error = {
|
|
489
|
+
code: e.string("code"),
|
|
490
|
+
message: e.string("message"),
|
|
491
|
+
retryable: e.bool("retryable"),
|
|
492
|
+
requestId: e.string("requestId"),
|
|
493
|
+
};
|
|
494
|
+
return e.ok() ? { state, error } : null;
|
|
495
|
+
}
|
|
496
|
+
return { state };
|
|
497
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import type { Command } from "commander";
|
|
2
|
+
import { type ConnectionDetail } from "./dto.js";
|
|
3
|
+
export declare function ctx(nsFlag?: string): Promise<{
|
|
4
|
+
token: string;
|
|
5
|
+
remote: string;
|
|
6
|
+
ns: string;
|
|
7
|
+
} | null>;
|
|
8
|
+
export type Ctx = NonNullable<Awaited<ReturnType<typeof ctx>>>;
|
|
9
|
+
/**
|
|
10
|
+
* One path segment, encoded as one path segment.
|
|
11
|
+
*
|
|
12
|
+
* Ids are ObjectId hex and namespace slugs are constrained, but both arrive
|
|
13
|
+
* here from a command line, and a `/` or a `?` in either would not be a bad
|
|
14
|
+
* argument — it would be a DIFFERENT request. `show 'x/../../other/connections/y'`
|
|
15
|
+
* interpolated raw is a read of another namespace's object wearing a typo's
|
|
16
|
+
* clothes. Encoding is what keeps a malformed argument a 404.
|
|
17
|
+
*/
|
|
18
|
+
export declare function seg(v: string): string;
|
|
19
|
+
export declare function connectionPath(c: Ctx, id: string): string;
|
|
20
|
+
/**
|
|
21
|
+
* Every route in this module is credential-manager only, so a 403 here means
|
|
22
|
+
* something different from a 403 on the Source read plane — telling the caller
|
|
23
|
+
* they "need read access" would send them to ask for a permission that would
|
|
24
|
+
* not help. The server's own typed message is more specific than anything this
|
|
25
|
+
* layer could invent, so only 401 and 404 are rewritten.
|
|
26
|
+
*/
|
|
27
|
+
export declare function explain(err: unknown): string;
|
|
28
|
+
/** Commander's default is to ignore extra positional arguments. */
|
|
29
|
+
export declare function strictArgs(cmd: Command): Command;
|
|
30
|
+
export declare function runConnectionList(opts: {
|
|
31
|
+
namespace?: string;
|
|
32
|
+
limit?: string;
|
|
33
|
+
cursor?: string;
|
|
34
|
+
labelContains?: string;
|
|
35
|
+
lifecycle?: string;
|
|
36
|
+
json?: boolean;
|
|
37
|
+
}): Promise<number>;
|
|
38
|
+
/** Fetch one Connection. Shared with every command that needs its revision. */
|
|
39
|
+
export declare function fetchConnection(c: Ctx, id: string): Promise<ConnectionDetail | null>;
|
|
40
|
+
export declare function runConnectionShow(id: string, opts: {
|
|
41
|
+
namespace?: string;
|
|
42
|
+
json?: boolean;
|
|
43
|
+
}): Promise<number>;
|
|
44
|
+
export declare function runConnectionAffected(id: string, opts: {
|
|
45
|
+
namespace?: string;
|
|
46
|
+
limit?: string;
|
|
47
|
+
cursor?: string;
|
|
48
|
+
json?: boolean;
|
|
49
|
+
}): Promise<number>;
|
|
50
|
+
export declare function registerConnectionCommand(program: Command): void;
|