@marinoscar/platform-cli 0.0.0-stage → 0.1.0-next.4
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/CHANGELOG.md +100 -0
- package/LICENSE +21 -0
- package/README.md +182 -2
- package/dist/android/build.d.ts +30 -0
- package/dist/android/build.d.ts.map +1 -0
- package/dist/android/build.js +126 -0
- package/dist/android/build.js.map +1 -0
- package/dist/android/command.d.ts +21 -0
- package/dist/android/command.d.ts.map +1 -0
- package/dist/android/command.js +355 -0
- package/dist/android/command.js.map +1 -0
- package/dist/android/deploy-step.d.ts +85 -0
- package/dist/android/deploy-step.d.ts.map +1 -0
- package/dist/android/deploy-step.js +268 -0
- package/dist/android/deploy-step.js.map +1 -0
- package/dist/android/doctor.d.ts +47 -0
- package/dist/android/doctor.d.ts.map +1 -0
- package/dist/android/doctor.js +219 -0
- package/dist/android/doctor.js.map +1 -0
- package/dist/android/exec.d.ts +42 -0
- package/dist/android/exec.d.ts.map +1 -0
- package/dist/android/exec.js +103 -0
- package/dist/android/exec.js.map +1 -0
- package/dist/android/fix-plan.d.ts +44 -0
- package/dist/android/fix-plan.d.ts.map +1 -0
- package/dist/android/fix-plan.js +86 -0
- package/dist/android/fix-plan.js.map +1 -0
- package/dist/android/git-freshness.d.ts +34 -0
- package/dist/android/git-freshness.d.ts.map +1 -0
- package/dist/android/git-freshness.js +120 -0
- package/dist/android/git-freshness.js.map +1 -0
- package/dist/android/gradle.d.ts +32 -0
- package/dist/android/gradle.d.ts.map +1 -0
- package/dist/android/gradle.js +55 -0
- package/dist/android/gradle.js.map +1 -0
- package/dist/android/identity.d.ts +27 -0
- package/dist/android/identity.d.ts.map +1 -0
- package/dist/android/identity.js +60 -0
- package/dist/android/identity.js.map +1 -0
- package/dist/android/index.d.ts +7 -0
- package/dist/android/index.d.ts.map +1 -0
- package/dist/android/index.js +8 -0
- package/dist/android/index.js.map +1 -0
- package/dist/android/installer.d.ts +28 -0
- package/dist/android/installer.d.ts.map +1 -0
- package/dist/android/installer.js +96 -0
- package/dist/android/installer.js.map +1 -0
- package/dist/android/java.d.ts +26 -0
- package/dist/android/java.d.ts.map +1 -0
- package/dist/android/java.js +65 -0
- package/dist/android/java.js.map +1 -0
- package/dist/android/keystore.d.ts +54 -0
- package/dist/android/keystore.d.ts.map +1 -0
- package/dist/android/keystore.js +159 -0
- package/dist/android/keystore.js.map +1 -0
- package/dist/android/metadata.d.ts +39 -0
- package/dist/android/metadata.d.ts.map +1 -0
- package/dist/android/metadata.js +61 -0
- package/dist/android/metadata.js.map +1 -0
- package/dist/android/operations.d.ts +42 -0
- package/dist/android/operations.d.ts.map +1 -0
- package/dist/android/operations.js +59 -0
- package/dist/android/operations.js.map +1 -0
- package/dist/android/paths.d.ts +29 -0
- package/dist/android/paths.d.ts.map +1 -0
- package/dist/android/paths.js +97 -0
- package/dist/android/paths.js.map +1 -0
- package/dist/android/publish.d.ts +37 -0
- package/dist/android/publish.d.ts.map +1 -0
- package/dist/android/publish.js +119 -0
- package/dist/android/publish.js.map +1 -0
- package/dist/android/registrations.d.ts +92 -0
- package/dist/android/registrations.d.ts.map +1 -0
- package/dist/android/registrations.js +112 -0
- package/dist/android/registrations.js.map +1 -0
- package/dist/android/release-status.d.ts +73 -0
- package/dist/android/release-status.d.ts.map +1 -0
- package/dist/android/release-status.js +161 -0
- package/dist/android/release-status.js.map +1 -0
- package/dist/android/release.d.ts +33 -0
- package/dist/android/release.d.ts.map +1 -0
- package/dist/android/release.js +59 -0
- package/dist/android/release.js.map +1 -0
- package/dist/android/screen-layout.d.ts +26 -0
- package/dist/android/screen-layout.d.ts.map +1 -0
- package/dist/android/screen-layout.js +24 -0
- package/dist/android/screen-layout.js.map +1 -0
- package/dist/android/screen-model.d.ts +56 -0
- package/dist/android/screen-model.d.ts.map +1 -0
- package/dist/android/screen-model.js +207 -0
- package/dist/android/screen-model.js.map +1 -0
- package/dist/android/screen.d.ts +8 -0
- package/dist/android/screen.d.ts.map +1 -0
- package/dist/android/screen.js +395 -0
- package/dist/android/screen.js.map +1 -0
- package/dist/android/sdk.d.ts +48 -0
- package/dist/android/sdk.d.ts.map +1 -0
- package/dist/android/sdk.js +82 -0
- package/dist/android/sdk.js.map +1 -0
- package/dist/android/server-url.d.ts +19 -0
- package/dist/android/server-url.d.ts.map +1 -0
- package/dist/android/server-url.js +36 -0
- package/dist/android/server-url.js.map +1 -0
- package/dist/android/upload-progress.d.ts +3 -0
- package/dist/android/upload-progress.d.ts.map +1 -0
- package/dist/android/upload-progress.js +47 -0
- package/dist/android/upload-progress.js.map +1 -0
- package/dist/android/version.d.ts +47 -0
- package/dist/android/version.d.ts.map +1 -0
- package/dist/android/version.js +136 -0
- package/dist/android/version.js.map +1 -0
- package/dist/api-client/index.d.ts +3 -0
- package/dist/api-client/index.d.ts.map +1 -0
- package/dist/api-client/index.js +5 -0
- package/dist/api-client/index.js.map +1 -0
- package/dist/commands/index.d.ts +52 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/index.js +63 -0
- package/dist/commands/index.js.map +1 -0
- package/dist/core/cli-registry.d.ts +41 -0
- package/dist/core/cli-registry.d.ts.map +1 -0
- package/dist/core/cli-registry.js +49 -0
- package/dist/core/cli-registry.js.map +1 -0
- package/dist/core/command-registry.d.ts +60 -0
- package/dist/core/command-registry.d.ts.map +1 -0
- package/dist/core/command-registry.js +114 -0
- package/dist/core/command-registry.js.map +1 -0
- package/dist/core/env-annotation-registry.d.ts +58 -0
- package/dist/core/env-annotation-registry.d.ts.map +1 -0
- package/dist/core/env-annotation-registry.js +80 -0
- package/dist/core/env-annotation-registry.js.map +1 -0
- package/dist/core/env-generator-registry.d.ts +59 -0
- package/dist/core/env-generator-registry.d.ts.map +1 -0
- package/dist/core/env-generator-registry.js +102 -0
- package/dist/core/env-generator-registry.js.map +1 -0
- package/dist/core/env-group-registry.d.ts +65 -0
- package/dist/core/env-group-registry.d.ts.map +1 -0
- package/dist/core/env-group-registry.js +77 -0
- package/dist/core/env-group-registry.js.map +1 -0
- package/dist/core/env-spec-registry.d.ts +133 -0
- package/dist/core/env-spec-registry.d.ts.map +1 -0
- package/dist/core/env-spec-registry.js +103 -0
- package/dist/core/env-spec-registry.js.map +1 -0
- package/dist/core/env-values.d.ts +76 -0
- package/dist/core/env-values.d.ts.map +1 -0
- package/dist/core/env-values.js +125 -0
- package/dist/core/env-values.js.map +1 -0
- package/dist/core/index.d.ts +14 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +10 -0
- package/dist/core/index.js.map +1 -0
- package/dist/deploy/index.d.ts +3 -0
- package/dist/deploy/index.d.ts.map +1 -0
- package/dist/deploy/index.js +5 -0
- package/dist/deploy/index.js.map +1 -0
- package/dist/engine/api-client.d.ts +211 -0
- package/dist/engine/api-client.d.ts.map +1 -0
- package/dist/engine/api-client.js +350 -0
- package/dist/engine/api-client.js.map +1 -0
- package/dist/engine/browser.d.ts +18 -0
- package/dist/engine/browser.d.ts.map +1 -0
- package/dist/engine/browser.js +115 -0
- package/dist/engine/browser.js.map +1 -0
- package/dist/engine/builtin-registrations.d.ts +20 -0
- package/dist/engine/builtin-registrations.d.ts.map +1 -0
- package/dist/engine/builtin-registrations.js +86 -0
- package/dist/engine/builtin-registrations.js.map +1 -0
- package/dist/engine/commands/api.d.ts +88 -0
- package/dist/engine/commands/api.d.ts.map +1 -0
- package/dist/engine/commands/api.js +398 -0
- package/dist/engine/commands/api.js.map +1 -0
- package/dist/engine/commands/config.d.ts +5 -0
- package/dist/engine/commands/config.d.ts.map +1 -0
- package/dist/engine/commands/config.js +83 -0
- package/dist/engine/commands/config.js.map +1 -0
- package/dist/engine/commands/deploy.d.ts +243 -0
- package/dist/engine/commands/deploy.d.ts.map +1 -0
- package/dist/engine/commands/deploy.js +1159 -0
- package/dist/engine/commands/deploy.js.map +1 -0
- package/dist/engine/commands/init.d.ts +18 -0
- package/dist/engine/commands/init.d.ts.map +1 -0
- package/dist/engine/commands/init.js +50 -0
- package/dist/engine/commands/init.js.map +1 -0
- package/dist/engine/commands/login.d.ts +4 -0
- package/dist/engine/commands/login.d.ts.map +1 -0
- package/dist/engine/commands/login.js +205 -0
- package/dist/engine/commands/login.js.map +1 -0
- package/dist/engine/commands/node.d.ts +21 -0
- package/dist/engine/commands/node.d.ts.map +1 -0
- package/dist/engine/commands/node.js +436 -0
- package/dist/engine/commands/node.js.map +1 -0
- package/dist/engine/config.d.ts +246 -0
- package/dist/engine/config.d.ts.map +1 -0
- package/dist/engine/config.js +414 -0
- package/dist/engine/config.js.map +1 -0
- package/dist/engine/conformance.d.ts +187 -0
- package/dist/engine/conformance.d.ts.map +1 -0
- package/dist/engine/conformance.js +227 -0
- package/dist/engine/conformance.js.map +1 -0
- package/dist/engine/create-cli.d.ts +94 -0
- package/dist/engine/create-cli.d.ts.map +1 -0
- package/dist/engine/create-cli.js +60 -0
- package/dist/engine/create-cli.js.map +1 -0
- package/dist/engine/deploy/about.d.ts +12 -0
- package/dist/engine/deploy/about.d.ts.map +1 -0
- package/dist/engine/deploy/about.js +110 -0
- package/dist/engine/deploy/about.js.map +1 -0
- package/dist/engine/deploy/adopt.d.ts +21 -0
- package/dist/engine/deploy/adopt.d.ts.map +1 -0
- package/dist/engine/deploy/adopt.js +78 -0
- package/dist/engine/deploy/adopt.js.map +1 -0
- package/dist/engine/deploy/answers-file.d.ts +7 -0
- package/dist/engine/deploy/answers-file.d.ts.map +1 -0
- package/dist/engine/deploy/answers-file.js +49 -0
- package/dist/engine/deploy/answers-file.js.map +1 -0
- package/dist/engine/deploy/app-role.d.ts +278 -0
- package/dist/engine/deploy/app-role.d.ts.map +1 -0
- package/dist/engine/deploy/app-role.js +826 -0
- package/dist/engine/deploy/app-role.js.map +1 -0
- package/dist/engine/deploy/app-version.d.ts +47 -0
- package/dist/engine/deploy/app-version.d.ts.map +1 -0
- package/dist/engine/deploy/app-version.js +232 -0
- package/dist/engine/deploy/app-version.js.map +1 -0
- package/dist/engine/deploy/checks/database.d.ts +83 -0
- package/dist/engine/deploy/checks/database.d.ts.map +1 -0
- package/dist/engine/deploy/checks/database.js +455 -0
- package/dist/engine/deploy/checks/database.js.map +1 -0
- package/dist/engine/deploy/checks/dns.d.ts +3 -0
- package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
- package/dist/engine/deploy/checks/dns.js +85 -0
- package/dist/engine/deploy/checks/dns.js.map +1 -0
- package/dist/engine/deploy/checks/host.d.ts +19 -0
- package/dist/engine/deploy/checks/host.d.ts.map +1 -0
- package/dist/engine/deploy/checks/host.js +530 -0
- package/dist/engine/deploy/checks/host.js.map +1 -0
- package/dist/engine/deploy/checks/index.d.ts +33 -0
- package/dist/engine/deploy/checks/index.d.ts.map +1 -0
- package/dist/engine/deploy/checks/index.js +67 -0
- package/dist/engine/deploy/checks/index.js.map +1 -0
- package/dist/engine/deploy/checks/registry.d.ts +102 -0
- package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
- package/dist/engine/deploy/checks/registry.js +103 -0
- package/dist/engine/deploy/checks/registry.js.map +1 -0
- package/dist/engine/deploy/checks/source.d.ts +45 -0
- package/dist/engine/deploy/checks/source.d.ts.map +1 -0
- package/dist/engine/deploy/checks/source.js +175 -0
- package/dist/engine/deploy/checks/source.js.map +1 -0
- package/dist/engine/deploy/checks/tls.d.ts +87 -0
- package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
- package/dist/engine/deploy/checks/tls.js +552 -0
- package/dist/engine/deploy/checks/tls.js.map +1 -0
- package/dist/engine/deploy/checks/types.d.ts +178 -0
- package/dist/engine/deploy/checks/types.d.ts.map +1 -0
- package/dist/engine/deploy/checks/types.js +199 -0
- package/dist/engine/deploy/checks/types.js.map +1 -0
- package/dist/engine/deploy/compose-files.d.ts +29 -0
- package/dist/engine/deploy/compose-files.d.ts.map +1 -0
- package/dist/engine/deploy/compose-files.js +118 -0
- package/dist/engine/deploy/compose-files.js.map +1 -0
- package/dist/engine/deploy/consent.d.ts +29 -0
- package/dist/engine/deploy/consent.d.ts.map +1 -0
- package/dist/engine/deploy/consent.js +35 -0
- package/dist/engine/deploy/consent.js.map +1 -0
- package/dist/engine/deploy/database-drop.d.ts +22 -0
- package/dist/engine/deploy/database-drop.d.ts.map +1 -0
- package/dist/engine/deploy/database-drop.js +135 -0
- package/dist/engine/deploy/database-drop.js.map +1 -0
- package/dist/engine/deploy/database.d.ts +116 -0
- package/dist/engine/deploy/database.d.ts.map +1 -0
- package/dist/engine/deploy/database.js +252 -0
- package/dist/engine/deploy/database.js.map +1 -0
- package/dist/engine/deploy/deploy-info.d.ts +48 -0
- package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
- package/dist/engine/deploy/deploy-info.js +163 -0
- package/dist/engine/deploy/deploy-info.js.map +1 -0
- package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
- package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
- package/dist/engine/deploy/deployment-evidence.js +92 -0
- package/dist/engine/deploy/deployment-evidence.js.map +1 -0
- package/dist/engine/deploy/edge-config.d.ts +103 -0
- package/dist/engine/deploy/edge-config.d.ts.map +1 -0
- package/dist/engine/deploy/edge-config.js +170 -0
- package/dist/engine/deploy/edge-config.js.map +1 -0
- package/dist/engine/deploy/env-absence.d.ts +61 -0
- package/dist/engine/deploy/env-absence.d.ts.map +1 -0
- package/dist/engine/deploy/env-absence.js +33 -0
- package/dist/engine/deploy/env-absence.js.map +1 -0
- package/dist/engine/deploy/env-file.d.ts +14 -0
- package/dist/engine/deploy/env-file.d.ts.map +1 -0
- package/dist/engine/deploy/env-file.js +58 -0
- package/dist/engine/deploy/env-file.js.map +1 -0
- package/dist/engine/deploy/env-fragments.d.ts +29 -0
- package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
- package/dist/engine/deploy/env-fragments.js +73 -0
- package/dist/engine/deploy/env-fragments.js.map +1 -0
- package/dist/engine/deploy/env-metadata.d.ts +73 -0
- package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
- package/dist/engine/deploy/env-metadata.js +227 -0
- package/dist/engine/deploy/env-metadata.js.map +1 -0
- package/dist/engine/deploy/env-spec.d.ts +75 -0
- package/dist/engine/deploy/env-spec.d.ts.map +1 -0
- package/dist/engine/deploy/env-spec.js +239 -0
- package/dist/engine/deploy/env-spec.js.map +1 -0
- package/dist/engine/deploy/env-wizard.d.ts +56 -0
- package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
- package/dist/engine/deploy/env-wizard.js +235 -0
- package/dist/engine/deploy/env-wizard.js.map +1 -0
- package/dist/engine/deploy/executor.d.ts +81 -0
- package/dist/engine/deploy/executor.d.ts.map +1 -0
- package/dist/engine/deploy/executor.js +247 -0
- package/dist/engine/deploy/executor.js.map +1 -0
- package/dist/engine/deploy/health.d.ts +146 -0
- package/dist/engine/deploy/health.d.ts.map +1 -0
- package/dist/engine/deploy/health.js +323 -0
- package/dist/engine/deploy/health.js.map +1 -0
- package/dist/engine/deploy/hooks.d.ts +66 -0
- package/dist/engine/deploy/hooks.d.ts.map +1 -0
- package/dist/engine/deploy/hooks.js +19 -0
- package/dist/engine/deploy/hooks.js.map +1 -0
- package/dist/engine/deploy/host-facts.d.ts +23 -0
- package/dist/engine/deploy/host-facts.d.ts.map +1 -0
- package/dist/engine/deploy/host-facts.js +67 -0
- package/dist/engine/deploy/host-facts.js.map +1 -0
- package/dist/engine/deploy/install.d.ts +233 -0
- package/dist/engine/deploy/install.d.ts.map +1 -0
- package/dist/engine/deploy/install.js +1304 -0
- package/dist/engine/deploy/install.js.map +1 -0
- package/dist/engine/deploy/inventory.d.ts +30 -0
- package/dist/engine/deploy/inventory.d.ts.map +1 -0
- package/dist/engine/deploy/inventory.js +122 -0
- package/dist/engine/deploy/inventory.js.map +1 -0
- package/dist/engine/deploy/journal.d.ts +77 -0
- package/dist/engine/deploy/journal.d.ts.map +1 -0
- package/dist/engine/deploy/journal.js +221 -0
- package/dist/engine/deploy/journal.js.map +1 -0
- package/dist/engine/deploy/layout.d.ts +77 -0
- package/dist/engine/deploy/layout.d.ts.map +1 -0
- package/dist/engine/deploy/layout.js +191 -0
- package/dist/engine/deploy/layout.js.map +1 -0
- package/dist/engine/deploy/oauth-check.d.ts +58 -0
- package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
- package/dist/engine/deploy/oauth-check.js +213 -0
- package/dist/engine/deploy/oauth-check.js.map +1 -0
- package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
- package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
- package/dist/engine/deploy/proxy-bootstrap.js +416 -0
- package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
- package/dist/engine/deploy/proxy-streams.d.ts +110 -0
- package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
- package/dist/engine/deploy/proxy-streams.js +208 -0
- package/dist/engine/deploy/proxy-streams.js.map +1 -0
- package/dist/engine/deploy/proxy.d.ts +375 -0
- package/dist/engine/deploy/proxy.d.ts.map +1 -0
- package/dist/engine/deploy/proxy.js +758 -0
- package/dist/engine/deploy/proxy.js.map +1 -0
- package/dist/engine/deploy/renewal.d.ts +54 -0
- package/dist/engine/deploy/renewal.d.ts.map +1 -0
- package/dist/engine/deploy/renewal.js +169 -0
- package/dist/engine/deploy/renewal.js.map +1 -0
- package/dist/engine/deploy/repo.d.ts +101 -0
- package/dist/engine/deploy/repo.d.ts.map +1 -0
- package/dist/engine/deploy/repo.js +250 -0
- package/dist/engine/deploy/repo.js.map +1 -0
- package/dist/engine/deploy/run-record.d.ts +28 -0
- package/dist/engine/deploy/run-record.d.ts.map +1 -0
- package/dist/engine/deploy/run-record.js +44 -0
- package/dist/engine/deploy/run-record.js.map +1 -0
- package/dist/engine/deploy/state.d.ts +262 -0
- package/dist/engine/deploy/state.d.ts.map +1 -0
- package/dist/engine/deploy/state.js +163 -0
- package/dist/engine/deploy/state.js.map +1 -0
- package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
- package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
- package/dist/engine/deploy/steps/app-step-context.js +45 -0
- package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
- package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
- package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
- package/dist/engine/deploy/steps/pipeline.js +73 -0
- package/dist/engine/deploy/steps/pipeline.js.map +1 -0
- package/dist/engine/deploy/steps/plan.d.ts +28 -0
- package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
- package/dist/engine/deploy/steps/plan.js +32 -0
- package/dist/engine/deploy/steps/plan.js.map +1 -0
- package/dist/engine/deploy/steps/registry.d.ts +182 -0
- package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
- package/dist/engine/deploy/steps/registry.js +212 -0
- package/dist/engine/deploy/steps/registry.js.map +1 -0
- package/dist/engine/deploy/steps/step-values.d.ts +28 -0
- package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
- package/dist/engine/deploy/steps/step-values.js +33 -0
- package/dist/engine/deploy/steps/step-values.js.map +1 -0
- package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
- package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
- package/dist/engine/deploy/testing/fake-postgres.js +236 -0
- package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
- package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
- package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
- package/dist/engine/deploy/testing/fake-vps.js +365 -0
- package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
- package/dist/engine/deploy/uninstall.d.ts +87 -0
- package/dist/engine/deploy/uninstall.d.ts.map +1 -0
- package/dist/engine/deploy/uninstall.js +320 -0
- package/dist/engine/deploy/uninstall.js.map +1 -0
- package/dist/engine/deploy/update.d.ts +111 -0
- package/dist/engine/deploy/update.d.ts.map +1 -0
- package/dist/engine/deploy/update.js +1228 -0
- package/dist/engine/deploy/update.js.map +1 -0
- package/dist/engine/deploy/version-step.d.ts +65 -0
- package/dist/engine/deploy/version-step.d.ts.map +1 -0
- package/dist/engine/deploy/version-step.js +176 -0
- package/dist/engine/deploy/version-step.js.map +1 -0
- package/dist/engine/device-auth.d.ts +240 -0
- package/dist/engine/device-auth.d.ts.map +1 -0
- package/dist/engine/device-auth.js +442 -0
- package/dist/engine/device-auth.js.map +1 -0
- package/dist/engine/device-login.d.ts +126 -0
- package/dist/engine/device-login.d.ts.map +1 -0
- package/dist/engine/device-login.js +164 -0
- package/dist/engine/device-login.js.map +1 -0
- package/dist/engine/errors.d.ts +314 -0
- package/dist/engine/errors.d.ts.map +1 -0
- package/dist/engine/errors.js +561 -0
- package/dist/engine/errors.js.map +1 -0
- package/dist/engine/identity.d.ts +169 -0
- package/dist/engine/identity.d.ts.map +1 -0
- package/dist/engine/identity.js +227 -0
- package/dist/engine/identity.js.map +1 -0
- package/dist/engine/index.d.ts +104 -0
- package/dist/engine/index.d.ts.map +1 -0
- package/dist/engine/index.js +126 -0
- package/dist/engine/index.js.map +1 -0
- package/dist/engine/init/local-profile.d.ts +93 -0
- package/dist/engine/init/local-profile.d.ts.map +1 -0
- package/dist/engine/init/local-profile.js +295 -0
- package/dist/engine/init/local-profile.js.map +1 -0
- package/dist/engine/init/run-init.d.ts +41 -0
- package/dist/engine/init/run-init.d.ts.map +1 -0
- package/dist/engine/init/run-init.js +297 -0
- package/dist/engine/init/run-init.js.map +1 -0
- package/dist/engine/node/capabilities.d.ts +238 -0
- package/dist/engine/node/capabilities.d.ts.map +1 -0
- package/dist/engine/node/capabilities.js +316 -0
- package/dist/engine/node/capabilities.js.map +1 -0
- package/dist/engine/node/daemon.d.ts +63 -0
- package/dist/engine/node/daemon.d.ts.map +1 -0
- package/dist/engine/node/daemon.js +227 -0
- package/dist/engine/node/daemon.js.map +1 -0
- package/dist/engine/node/doctor.d.ts +58 -0
- package/dist/engine/node/doctor.d.ts.map +1 -0
- package/dist/engine/node/doctor.js +394 -0
- package/dist/engine/node/doctor.js.map +1 -0
- package/dist/engine/node/enrollment.d.ts +98 -0
- package/dist/engine/node/enrollment.d.ts.map +1 -0
- package/dist/engine/node/enrollment.js +189 -0
- package/dist/engine/node/enrollment.js.map +1 -0
- package/dist/engine/node/env-flags.d.ts +5 -0
- package/dist/engine/node/env-flags.d.ts.map +1 -0
- package/dist/engine/node/env-flags.js +22 -0
- package/dist/engine/node/env-flags.js.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.js +189 -0
- package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
- package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
- package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
- package/dist/engine/node/executors/db-backup-run.js +362 -0
- package/dist/engine/node/executors/db-backup-run.js.map +1 -0
- package/dist/engine/node/executors/example-checksum.d.ts +30 -0
- package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
- package/dist/engine/node/executors/example-checksum.js +56 -0
- package/dist/engine/node/executors/example-checksum.js.map +1 -0
- package/dist/engine/node/executors/index.d.ts +168 -0
- package/dist/engine/node/executors/index.d.ts.map +1 -0
- package/dist/engine/node/executors/index.js +44 -0
- package/dist/engine/node/executors/index.js.map +1 -0
- package/dist/engine/node/executors/registry.d.ts +38 -0
- package/dist/engine/node/executors/registry.d.ts.map +1 -0
- package/dist/engine/node/executors/registry.js +92 -0
- package/dist/engine/node/executors/registry.js.map +1 -0
- package/dist/engine/node/heap-snapshot.d.ts +37 -0
- package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
- package/dist/engine/node/heap-snapshot.js +160 -0
- package/dist/engine/node/heap-snapshot.js.map +1 -0
- package/dist/engine/node/install-deps.d.ts +73 -0
- package/dist/engine/node/install-deps.d.ts.map +1 -0
- package/dist/engine/node/install-deps.js +150 -0
- package/dist/engine/node/install-deps.js.map +1 -0
- package/dist/engine/node/ipc-protocol.d.ts +67 -0
- package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
- package/dist/engine/node/ipc-protocol.js +83 -0
- package/dist/engine/node/ipc-protocol.js.map +1 -0
- package/dist/engine/node/lifecycle.d.ts +103 -0
- package/dist/engine/node/lifecycle.d.ts.map +1 -0
- package/dist/engine/node/lifecycle.js +259 -0
- package/dist/engine/node/lifecycle.js.map +1 -0
- package/dist/engine/node/logger.d.ts +82 -0
- package/dist/engine/node/logger.d.ts.map +1 -0
- package/dist/engine/node/logger.js +241 -0
- package/dist/engine/node/logger.js.map +1 -0
- package/dist/engine/node/memory-watchdog.d.ts +78 -0
- package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
- package/dist/engine/node/memory-watchdog.js +224 -0
- package/dist/engine/node/memory-watchdog.js.map +1 -0
- package/dist/engine/node/node-api.d.ts +391 -0
- package/dist/engine/node/node-api.d.ts.map +1 -0
- package/dist/engine/node/node-api.js +123 -0
- package/dist/engine/node/node-api.js.map +1 -0
- package/dist/engine/node/node-config.d.ts +128 -0
- package/dist/engine/node/node-config.d.ts.map +1 -0
- package/dist/engine/node/node-config.js +237 -0
- package/dist/engine/node/node-config.js.map +1 -0
- package/dist/engine/node/node-dashboard-source.d.ts +56 -0
- package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
- package/dist/engine/node/node-dashboard-source.js +213 -0
- package/dist/engine/node/node-dashboard-source.js.map +1 -0
- package/dist/engine/node/node-engine.d.ts +229 -0
- package/dist/engine/node/node-engine.d.ts.map +1 -0
- package/dist/engine/node/node-engine.js +723 -0
- package/dist/engine/node/node-engine.js.map +1 -0
- package/dist/engine/node/node-errors.d.ts +54 -0
- package/dist/engine/node/node-errors.d.ts.map +1 -0
- package/dist/engine/node/node-errors.js +71 -0
- package/dist/engine/node/node-errors.js.map +1 -0
- package/dist/engine/node/node-events.d.ts +132 -0
- package/dist/engine/node/node-events.d.ts.map +1 -0
- package/dist/engine/node/node-events.js +2 -0
- package/dist/engine/node/node-events.js.map +1 -0
- package/dist/engine/node/node-vitals.d.ts +123 -0
- package/dist/engine/node/node-vitals.d.ts.map +1 -0
- package/dist/engine/node/node-vitals.js +266 -0
- package/dist/engine/node/node-vitals.js.map +1 -0
- package/dist/engine/node/paths.d.ts +39 -0
- package/dist/engine/node/paths.d.ts.map +1 -0
- package/dist/engine/node/paths.js +60 -0
- package/dist/engine/node/paths.js.map +1 -0
- package/dist/engine/node/pg-dump.d.ts +126 -0
- package/dist/engine/node/pg-dump.d.ts.map +1 -0
- package/dist/engine/node/pg-dump.js +223 -0
- package/dist/engine/node/pg-dump.js.map +1 -0
- package/dist/engine/node/pidfile.d.ts +38 -0
- package/dist/engine/node/pidfile.d.ts.map +1 -0
- package/dist/engine/node/pidfile.js +156 -0
- package/dist/engine/node/pidfile.js.map +1 -0
- package/dist/engine/node/runtime-tuning.d.ts +65 -0
- package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
- package/dist/engine/node/runtime-tuning.js +198 -0
- package/dist/engine/node/runtime-tuning.js.map +1 -0
- package/dist/engine/node/service.d.ts +39 -0
- package/dist/engine/node/service.d.ts.map +1 -0
- package/dist/engine/node/service.js +211 -0
- package/dist/engine/node/service.js.map +1 -0
- package/dist/engine/node/start.d.ts +62 -0
- package/dist/engine/node/start.d.ts.map +1 -0
- package/dist/engine/node/start.js +245 -0
- package/dist/engine/node/start.js.map +1 -0
- package/dist/engine/node/worker-env-table.d.ts +15 -0
- package/dist/engine/node/worker-env-table.d.ts.map +1 -0
- package/dist/engine/node/worker-env-table.js +97 -0
- package/dist/engine/node/worker-env-table.js.map +1 -0
- package/dist/engine/node/worker-env.d.ts +50 -0
- package/dist/engine/node/worker-env.d.ts.map +1 -0
- package/dist/engine/node/worker-env.js +101 -0
- package/dist/engine/node/worker-env.js.map +1 -0
- package/dist/engine/output.d.ts +97 -0
- package/dist/engine/output.d.ts.map +1 -0
- package/dist/engine/output.js +274 -0
- package/dist/engine/output.js.map +1 -0
- package/dist/engine/package-info.d.ts +7 -0
- package/dist/engine/package-info.d.ts.map +1 -0
- package/dist/engine/package-info.js +38 -0
- package/dist/engine/package-info.js.map +1 -0
- package/dist/engine/program.d.ts +50 -0
- package/dist/engine/program.d.ts.map +1 -0
- package/dist/engine/program.js +197 -0
- package/dist/engine/program.js.map +1 -0
- package/dist/engine/prompt.d.ts +69 -0
- package/dist/engine/prompt.d.ts.map +1 -0
- package/dist/engine/prompt.js +205 -0
- package/dist/engine/prompt.js.map +1 -0
- package/dist/engine/registries.d.ts +5 -0
- package/dist/engine/registries.d.ts.map +1 -0
- package/dist/engine/registries.js +52 -0
- package/dist/engine/registries.js.map +1 -0
- package/dist/engine/request-body.d.ts +31 -0
- package/dist/engine/request-body.d.ts.map +1 -0
- package/dist/engine/request-body.js +156 -0
- package/dist/engine/request-body.js.map +1 -0
- package/dist/engine/test-support.d.ts +50 -0
- package/dist/engine/test-support.d.ts.map +1 -0
- package/dist/engine/test-support.js +86 -0
- package/dist/engine/test-support.js.map +1 -0
- package/dist/engine/tui/app.d.ts +3 -0
- package/dist/engine/tui/app.d.ts.map +1 -0
- package/dist/engine/tui/app.js +100 -0
- package/dist/engine/tui/app.js.map +1 -0
- package/dist/engine/tui/builtin-screens.d.ts +6 -0
- package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
- package/dist/engine/tui/builtin-screens.js +54 -0
- package/dist/engine/tui/builtin-screens.js.map +1 -0
- package/dist/engine/tui/index.d.ts +23 -0
- package/dist/engine/tui/index.d.ts.map +1 -0
- package/dist/engine/tui/index.js +71 -0
- package/dist/engine/tui/index.js.map +1 -0
- package/dist/engine/tui/layout.d.ts +132 -0
- package/dist/engine/tui/layout.d.ts.map +1 -0
- package/dist/engine/tui/layout.js +200 -0
- package/dist/engine/tui/layout.js.map +1 -0
- package/dist/engine/tui/routes.d.ts +5 -0
- package/dist/engine/tui/routes.d.ts.map +1 -0
- package/dist/engine/tui/routes.js +16 -0
- package/dist/engine/tui/routes.js.map +1 -0
- package/dist/engine/tui/screen-registry.d.ts +100 -0
- package/dist/engine/tui/screen-registry.d.ts.map +1 -0
- package/dist/engine/tui/screen-registry.js +96 -0
- package/dist/engine/tui/screen-registry.js.map +1 -0
- package/dist/engine/tui/screen-sections.d.ts +9 -0
- package/dist/engine/tui/screen-sections.d.ts.map +1 -0
- package/dist/engine/tui/screen-sections.js +45 -0
- package/dist/engine/tui/screen-sections.js.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.js +153 -0
- package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.js +202 -0
- package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
- package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
- package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/index.js +83 -0
- package/dist/engine/tui/screens/deploy/index.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.js +319 -0
- package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install.js +361 -0
- package/dist/engine/tui/screens/deploy/install.js.map +1 -0
- package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
- package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/model.js +59 -0
- package/dist/engine/tui/screens/deploy/model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.js +117 -0
- package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
- package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run.js +201 -0
- package/dist/engine/tui/screens/deploy/run.js.map +1 -0
- package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
- package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/status.js +107 -0
- package/dist/engine/tui/screens/deploy/status.js.map +1 -0
- package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
- package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/update.js +175 -0
- package/dist/engine/tui/screens/deploy/update.js.map +1 -0
- package/dist/engine/tui/screens/deploy.d.ts +12 -0
- package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy.js +23 -0
- package/dist/engine/tui/screens/deploy.js.map +1 -0
- package/dist/engine/tui/screens/invoke.d.ts +6 -0
- package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
- package/dist/engine/tui/screens/invoke.js +193 -0
- package/dist/engine/tui/screens/invoke.js.map +1 -0
- package/dist/engine/tui/screens/login.d.ts +6 -0
- package/dist/engine/tui/screens/login.d.ts.map +1 -0
- package/dist/engine/tui/screens/login.js +255 -0
- package/dist/engine/tui/screens/login.js.map +1 -0
- package/dist/engine/tui/screens/logout.d.ts +6 -0
- package/dist/engine/tui/screens/logout.d.ts.map +1 -0
- package/dist/engine/tui/screens/logout.js +142 -0
- package/dist/engine/tui/screens/logout.js.map +1 -0
- package/dist/engine/tui/screens/menu.d.ts +22 -0
- package/dist/engine/tui/screens/menu.d.ts.map +1 -0
- package/dist/engine/tui/screens/menu.js +84 -0
- package/dist/engine/tui/screens/menu.js.map +1 -0
- package/dist/engine/tui/screens/node.d.ts +6 -0
- package/dist/engine/tui/screens/node.d.ts.map +1 -0
- package/dist/engine/tui/screens/node.js +228 -0
- package/dist/engine/tui/screens/node.js.map +1 -0
- package/dist/engine/tui/screens/status.d.ts +6 -0
- package/dist/engine/tui/screens/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/status.js +134 -0
- package/dist/engine/tui/screens/status.js.map +1 -0
- package/dist/engine/tui/scroll-box.d.ts +27 -0
- package/dist/engine/tui/scroll-box.d.ts.map +1 -0
- package/dist/engine/tui/scroll-box.js +52 -0
- package/dist/engine/tui/scroll-box.js.map +1 -0
- package/dist/engine/tui/section-registry.d.ts +65 -0
- package/dist/engine/tui/section-registry.d.ts.map +1 -0
- package/dist/engine/tui/section-registry.js +90 -0
- package/dist/engine/tui/section-registry.js.map +1 -0
- package/dist/engine/tui/terminal.d.ts +31 -0
- package/dist/engine/tui/terminal.d.ts.map +1 -0
- package/dist/engine/tui/terminal.js +142 -0
- package/dist/engine/tui/terminal.js.map +1 -0
- package/dist/engine/tui/tty.d.ts +49 -0
- package/dist/engine/tui/tty.d.ts.map +1 -0
- package/dist/engine/tui/tty.js +139 -0
- package/dist/engine/tui/tty.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- package/dist/node/index.d.ts +3 -0
- package/dist/node/index.d.ts.map +1 -0
- package/dist/node/index.js +5 -0
- package/dist/node/index.js.map +1 -0
- package/dist/telemetry/env-fragment.d.ts +47 -0
- package/dist/telemetry/env-fragment.d.ts.map +1 -0
- package/dist/telemetry/env-fragment.js +73 -0
- package/dist/telemetry/env-fragment.js.map +1 -0
- package/dist/telemetry/index.d.ts +7 -0
- package/dist/telemetry/index.d.ts.map +1 -0
- package/dist/telemetry/index.js +7 -0
- package/dist/telemetry/index.js.map +1 -0
- package/dist/telemetry/node-span-relay.d.ts +107 -0
- package/dist/telemetry/node-span-relay.d.ts.map +1 -0
- package/dist/telemetry/node-span-relay.js +314 -0
- package/dist/telemetry/node-span-relay.js.map +1 -0
- package/dist/telemetry/node-span.d.ts +92 -0
- package/dist/telemetry/node-span.d.ts.map +1 -0
- package/dist/telemetry/node-span.js +28 -0
- package/dist/telemetry/node-span.js.map +1 -0
- package/dist/testing/index.d.ts +3 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +4 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/tui/index.d.ts +3 -0
- package/dist/tui/index.d.ts.map +1 -0
- package/dist/tui/index.js +5 -0
- package/dist/tui/index.js.map +1 -0
- package/package.json +102 -4
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
import { hostname, userInfo } from 'node:os';
|
|
2
|
+
import { ApiClient, resolveApiBaseUrl } from './api-client.js';
|
|
3
|
+
import { openInBrowser } from './browser.js';
|
|
4
|
+
import { cliDisplayName, cliName, cliVersion } from './identity.js';
|
|
5
|
+
import { saveCredentials } from './config.js';
|
|
6
|
+
import { DeviceLoginError, pollForDeviceToken, requestDeviceCode, } from './device-auth.js';
|
|
7
|
+
import { ApiError } from './errors.js';
|
|
8
|
+
/**
|
|
9
|
+
* Per-poll HTTP timeout.
|
|
10
|
+
*
|
|
11
|
+
* Much shorter than the client's 30s default, deliberately. A poll is a
|
|
12
|
+
* sub-second request repeated every few seconds; if one hangs, the right
|
|
13
|
+
* answer is to abandon it and poll again on schedule, not to stall the whole
|
|
14
|
+
* flow for half a minute and let the interval collapse. It must stay
|
|
15
|
+
* comfortably below the poll interval times a small factor so a stuck request
|
|
16
|
+
* cannot pile up behind the next one.
|
|
17
|
+
*/
|
|
18
|
+
const POLL_REQUEST_TIMEOUT_MS = 10_000;
|
|
19
|
+
/**
|
|
20
|
+
* Run the device flow and return the issued credential. Does NOT save.
|
|
21
|
+
*
|
|
22
|
+
* Saving is separate because the two entry points (`login` and
|
|
23
|
+
* `login --token`) converge only at `completeLogin`, and because a caller that wants
|
|
24
|
+
* the credential without touching the user's config — a test, a future
|
|
25
|
+
* `--print-token`-free integration — should not have to opt out of a side
|
|
26
|
+
* effect.
|
|
27
|
+
*/
|
|
28
|
+
export async function runDeviceLogin(options) {
|
|
29
|
+
const apiBaseUrl = resolveApiBaseUrl(options.serverUrl);
|
|
30
|
+
const hooks = options.hooks;
|
|
31
|
+
// No token: `/auth/device/code` and `/auth/device/token` are both @Public(),
|
|
32
|
+
// and the entire purpose of the flow is that we do not have one yet.
|
|
33
|
+
const client = options.createClient?.(apiBaseUrl) ??
|
|
34
|
+
new ApiClient({ baseUrl: apiBaseUrl, timeoutMs: POLL_REQUEST_TIMEOUT_MS });
|
|
35
|
+
const grant = await requestDeviceCode(client, {
|
|
36
|
+
deviceName: options.deviceName ?? defaultDeviceName(),
|
|
37
|
+
userAgent: `${cliName()}/${cliVersion()} (node ${process.version})`,
|
|
38
|
+
signal: options.signal,
|
|
39
|
+
});
|
|
40
|
+
// Emitted BEFORE the browser attempt, always. The user code is the one thing
|
|
41
|
+
// the flow cannot proceed without, so it must be on screen even if the
|
|
42
|
+
// browser launch hangs for its full timeout, and even if it succeeds — the
|
|
43
|
+
// browser may open on a different machine's display, or behind other
|
|
44
|
+
// windows.
|
|
45
|
+
hooks?.onCodeIssued?.(grant);
|
|
46
|
+
if (options.openBrowser !== false) {
|
|
47
|
+
const result = await openInBrowser(grant.verificationUriComplete);
|
|
48
|
+
hooks?.onBrowserOpen?.({ ...result, url: grant.verificationUriComplete });
|
|
49
|
+
}
|
|
50
|
+
const credential = await pollForDeviceToken({
|
|
51
|
+
client,
|
|
52
|
+
deviceCode: grant.deviceCode,
|
|
53
|
+
intervalSeconds: grant.interval,
|
|
54
|
+
expiresInSeconds: grant.expiresIn,
|
|
55
|
+
signal: options.signal,
|
|
56
|
+
onState: hooks?.onPollState,
|
|
57
|
+
onUnclassified: hooks?.onUnclassified,
|
|
58
|
+
sleep: options.sleep,
|
|
59
|
+
});
|
|
60
|
+
return { grant, credential, apiBaseUrl };
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Validate a token against `GET /api/auth/me`.
|
|
64
|
+
*
|
|
65
|
+
* WHY VALIDATE AT ALL when the device flow just minted the token: because the
|
|
66
|
+
* headless `--token` path did not, and both paths must fail in the same place
|
|
67
|
+
* for the same reason. A pasted token that is mistyped, expired, revoked, or
|
|
68
|
+
* from a different server is the common case there, and the difference between
|
|
69
|
+
* catching it here and not catching it is the difference between "that token
|
|
70
|
+
* is not valid on this server" at login and a mystifying 401 from an unrelated
|
|
71
|
+
* command three days later — by which time nobody remembers what was pasted.
|
|
72
|
+
*
|
|
73
|
+
* It is also the only check that the account is USABLE. `JwtAuthGuard` rejects
|
|
74
|
+
* a disabled user, so a token belonging to a deactivated account fails here
|
|
75
|
+
* rather than after being written to disk as if it worked.
|
|
76
|
+
*/
|
|
77
|
+
export async function validateToken(serverUrl, token, options) {
|
|
78
|
+
const apiBaseUrl = resolveApiBaseUrl(serverUrl);
|
|
79
|
+
const client = options?.createClient?.(apiBaseUrl, token) ?? new ApiClient({ baseUrl: apiBaseUrl, token });
|
|
80
|
+
try {
|
|
81
|
+
return await client.get('/auth/me', options?.signal === undefined ? undefined : { signal: options.signal });
|
|
82
|
+
}
|
|
83
|
+
catch (error) {
|
|
84
|
+
if (error instanceof ApiError && error.status === 401) {
|
|
85
|
+
// Rewritten, because the server's own 401 message ("Unauthorized") is
|
|
86
|
+
// true and useless. The message must NOT echo the token — not even a
|
|
87
|
+
// prefix of it — since this error is printed and ends up in scrollback,
|
|
88
|
+
// screenshots and pasted bug reports.
|
|
89
|
+
throw new ApiError({
|
|
90
|
+
status: error.status,
|
|
91
|
+
serverMessage: `the server rejected this token. It may be expired, revoked, or issued by a different server. Check the Access Tokens page on ${serverUrl}, or run \`${cliName()} login\` to get a new one.`,
|
|
92
|
+
code: error.code,
|
|
93
|
+
details: undefined,
|
|
94
|
+
method: error.method,
|
|
95
|
+
url: error.url,
|
|
96
|
+
structured: error.structured,
|
|
97
|
+
});
|
|
98
|
+
}
|
|
99
|
+
throw error;
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Validate, THEN save. The final step of both login paths.
|
|
104
|
+
*
|
|
105
|
+
* THE ORDER IS THE POINT. Saving first and validating afterwards leaves a
|
|
106
|
+
* token that does not work sitting in the config on every failure, and the
|
|
107
|
+
* next command reports a 401 that looks like a revoked credential rather than
|
|
108
|
+
* a login that never succeeded. Validating first means a failed login changes
|
|
109
|
+
* nothing on disk — the previous, working credential survives an attempt to
|
|
110
|
+
* replace it with a bad one, which is the behaviour a user assumes and would
|
|
111
|
+
* not think to check.
|
|
112
|
+
*/
|
|
113
|
+
export async function completeLogin(input) {
|
|
114
|
+
const user = await validateToken(input.serverUrl, input.token, {
|
|
115
|
+
signal: input.signal,
|
|
116
|
+
createClient: input.createClient,
|
|
117
|
+
});
|
|
118
|
+
const path = saveCredentials({
|
|
119
|
+
// The URL as the user gave it, NOT the resolved `/api` root. #143 stores
|
|
120
|
+
// "the server", and re-deriving the API root on read keeps the stored
|
|
121
|
+
// value meaningful if the prefix ever changes.
|
|
122
|
+
serverUrl: input.serverUrl,
|
|
123
|
+
token: input.token,
|
|
124
|
+
expiresAt: input.expiresAt,
|
|
125
|
+
tokenId: input.tokenId,
|
|
126
|
+
tokenName: input.tokenName,
|
|
127
|
+
}, input.configContext);
|
|
128
|
+
return { user, path };
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* A name the user will recognise in the Access Tokens page.
|
|
132
|
+
*
|
|
133
|
+
* `user@host` is the string that answers the only question that page asks —
|
|
134
|
+
* "which machine is this, and should it still have access?" — and it is what
|
|
135
|
+
* makes revocation possible in practice. A generic "CLI" on four rows tells
|
|
136
|
+
* nobody which laptop was lost.
|
|
137
|
+
*
|
|
138
|
+
* `userInfo()` throws when the uid has no passwd entry, which happens in
|
|
139
|
+
* containers running as an arbitrary uid — a routine setup, not an exotic one
|
|
140
|
+
* — so both halves degrade rather than taking the login down over a label.
|
|
141
|
+
* The server sanitises this before it becomes a token name
|
|
142
|
+
* (`DeviceAuthService.buildPatName`), which matters because it is
|
|
143
|
+
* attacker-supplied from the API's point of view.
|
|
144
|
+
*/
|
|
145
|
+
export function defaultDeviceName() {
|
|
146
|
+
let user;
|
|
147
|
+
try {
|
|
148
|
+
user = userInfo().username;
|
|
149
|
+
}
|
|
150
|
+
catch {
|
|
151
|
+
user = 'unknown';
|
|
152
|
+
}
|
|
153
|
+
let host;
|
|
154
|
+
try {
|
|
155
|
+
host = hostname();
|
|
156
|
+
}
|
|
157
|
+
catch {
|
|
158
|
+
host = 'unknown-host';
|
|
159
|
+
}
|
|
160
|
+
return `${cliDisplayName()}: ${user}@${host}`;
|
|
161
|
+
}
|
|
162
|
+
/** Re-exported so a consumer needs one import for the whole flow. */
|
|
163
|
+
export { DeviceLoginError };
|
|
164
|
+
//# sourceMappingURL=device-login.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"device-login.js","sourceRoot":"","sources":["../../src/engine/device-login.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,314 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Process exit codes.
|
|
3
|
+
*
|
|
4
|
+
* Small integers, deliberately: values 126, 127 and 128+n are claimed by the
|
|
5
|
+
* shell (not executable / not found / killed by signal n), so a CLI that picks
|
|
6
|
+
* its own codes up there produces output a script cannot tell apart from the
|
|
7
|
+
* shell's own failures. Everything here stays well below that.
|
|
8
|
+
*
|
|
9
|
+
* These are a PUBLIC CONTRACT the moment someone writes `if [ $? -eq 4 ]`.
|
|
10
|
+
* Add new codes; do not renumber existing ones.
|
|
11
|
+
*
|
|
12
|
+
* @stability stable
|
|
13
|
+
*/
|
|
14
|
+
export declare const EXIT: {
|
|
15
|
+
/** Success. */
|
|
16
|
+
readonly OK: 0;
|
|
17
|
+
/** Anything unclassified — a bug in this CLI, most likely. */
|
|
18
|
+
readonly FAILURE: 1;
|
|
19
|
+
/** The invocation itself was wrong: unknown command, missing argument. */
|
|
20
|
+
readonly USAGE: 2;
|
|
21
|
+
/** The server was reached and answered with a non-2xx status. */
|
|
22
|
+
readonly API: 3;
|
|
23
|
+
/** The server was never reached: DNS, refused, TLS, timeout. */
|
|
24
|
+
readonly NETWORK: 4;
|
|
25
|
+
/**
|
|
26
|
+
* 401 specifically — no credential, or one that expired or was revoked.
|
|
27
|
+
*
|
|
28
|
+
* Split out from API because it is the one failure with a known remedy that
|
|
29
|
+
* a script can automate: re-run `login`. 403 deliberately stays API — a
|
|
30
|
+
* permission the account does not have is not fixed by logging in again,
|
|
31
|
+
* and telling someone to re-authenticate when their role is the problem
|
|
32
|
+
* sends them round a loop.
|
|
33
|
+
*/
|
|
34
|
+
readonly AUTH: 5;
|
|
35
|
+
/**
|
|
36
|
+
* A prerequisite is not met, so nothing was attempted (#178, epic #168).
|
|
37
|
+
*
|
|
38
|
+
* SPLIT OUT FROM FAILURE because it is the one a script can act on:
|
|
39
|
+
* `appctl deploy doctor || provision-the-box` is the intended shape, and
|
|
40
|
+
* "this server is not ready" has to be distinguishable from "appctl itself
|
|
41
|
+
* broke". Additive, like every code above it - never renumber.
|
|
42
|
+
*/
|
|
43
|
+
readonly PRECONDITION: 6;
|
|
44
|
+
};
|
|
45
|
+
/**
|
|
46
|
+
* One of the documented exit codes in {@link EXIT}.
|
|
47
|
+
*
|
|
48
|
+
* @stability stable
|
|
49
|
+
*/
|
|
50
|
+
export type ExitCode = (typeof EXIT)[keyof typeof EXIT];
|
|
51
|
+
/**
|
|
52
|
+
* Base for every error this CLI raises on purpose.
|
|
53
|
+
*
|
|
54
|
+
* The `exitCode` lives on the error rather than in a switch at the top level
|
|
55
|
+
* so that a new error type cannot be added without deciding what it does to
|
|
56
|
+
* the process — the compiler asks the question.
|
|
57
|
+
*
|
|
58
|
+
* @stability stable
|
|
59
|
+
*/
|
|
60
|
+
export declare abstract class CliError extends Error {
|
|
61
|
+
/** The process exit code this error maps to. */
|
|
62
|
+
abstract readonly exitCode: ExitCode;
|
|
63
|
+
constructor(message: string, options?: ErrorOptions);
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* The invocation was malformed. Exists so #144 can reject a bad method/path.
|
|
67
|
+
*
|
|
68
|
+
* @stability stable
|
|
69
|
+
*/
|
|
70
|
+
export declare class UsageError extends CliError {
|
|
71
|
+
/** `EXIT.USAGE`. */
|
|
72
|
+
readonly exitCode: 2;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* There is no credential to use, so the request was never attempted (#143).
|
|
76
|
+
*
|
|
77
|
+
* EXIT.AUTH, the same code a 401 produces, ON PURPOSE: from a script's point
|
|
78
|
+
* of view "the stored token was revoked" and "there was never a stored token"
|
|
79
|
+
* have the identical remedy — run `login` — and a script that branches on the
|
|
80
|
+
* exit code should not have to know which of the two happened. What must
|
|
81
|
+
* differ is the MESSAGE, and that is the whole reason this class exists: the
|
|
82
|
+
* naive implementation sends `Authorization: Bearer undefined`, gets a 401,
|
|
83
|
+
* and tells the user their credentials were rejected. They were not; there
|
|
84
|
+
* were none. That misdirection sends people to revoke and re-issue tokens
|
|
85
|
+
* that were never the problem.
|
|
86
|
+
*
|
|
87
|
+
* @stability experimental
|
|
88
|
+
*/
|
|
89
|
+
export declare class AuthRequiredError extends CliError {
|
|
90
|
+
/** `EXIT.AUTH`. */
|
|
91
|
+
readonly exitCode: 5;
|
|
92
|
+
constructor(message?: string);
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* A required prerequisite failed, so the command did not proceed (#178).
|
|
96
|
+
*
|
|
97
|
+
* The message names what failed; the remedy belongs to the check that
|
|
98
|
+
* produced it and is rendered beside it, not folded in here.
|
|
99
|
+
*
|
|
100
|
+
* @stability experimental
|
|
101
|
+
*/
|
|
102
|
+
export declare class PreconditionError extends CliError {
|
|
103
|
+
/** `EXIT.PRECONDITION`. */
|
|
104
|
+
readonly exitCode: 6;
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* The config file exists but cannot be used (#143).
|
|
108
|
+
*
|
|
109
|
+
* NOT EXIT.AUTH: "your config is corrupt" is not fixed by logging in against
|
|
110
|
+
* whatever server the corrupt file names, and a script retrying `login` on
|
|
111
|
+
* an AUTH code would loop. FAILURE is honest — something is wrong that the
|
|
112
|
+
* CLI cannot resolve on its own — and the message always names the path so
|
|
113
|
+
* the fix (delete it, or fix the JSON) needs no further investigation.
|
|
114
|
+
*
|
|
115
|
+
* @stability experimental
|
|
116
|
+
*/
|
|
117
|
+
export declare class ConfigError extends CliError {
|
|
118
|
+
/** `EXIT.FAILURE`. */
|
|
119
|
+
readonly exitCode: 1;
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* Everything the server may have told us about a failed request.
|
|
123
|
+
*
|
|
124
|
+
* @stability experimental
|
|
125
|
+
*/
|
|
126
|
+
export interface ApiErrorFields {
|
|
127
|
+
/** HTTP status. 0 is never used here — that is NetworkError's territory. */
|
|
128
|
+
readonly status: number;
|
|
129
|
+
/** The server's own sentence, already extracted from the body. */
|
|
130
|
+
readonly serverMessage: string;
|
|
131
|
+
/** `code` from the API error envelope, e.g. `FORBIDDEN`. */
|
|
132
|
+
readonly code: string | undefined;
|
|
133
|
+
/** `details` from the envelope. Absent in production — see below. */
|
|
134
|
+
readonly details: unknown;
|
|
135
|
+
/** Request method, for the message. */
|
|
136
|
+
readonly method: string;
|
|
137
|
+
/** Request URL, for the message. Never contains the token. */
|
|
138
|
+
readonly url: string;
|
|
139
|
+
/**
|
|
140
|
+
* True when the body parsed as the API's documented error envelope. False
|
|
141
|
+
* means the message below was salvaged from something else — an nginx error
|
|
142
|
+
* page, an empty body, a proxy's HTML.
|
|
143
|
+
*/
|
|
144
|
+
readonly structured: boolean;
|
|
145
|
+
/**
|
|
146
|
+
* The response body EXACTLY as it arrived, before this module distilled a
|
|
147
|
+
* message out of it. OPTIONAL, so adding it did not change the shape every
|
|
148
|
+
* existing caller of this constructor already passes.
|
|
149
|
+
*
|
|
150
|
+
* WHY KEEP IT, given that `serverMessage`, `code` and `details` are meant to
|
|
151
|
+
* BE the useful distillation: because a caller can need a field this module
|
|
152
|
+
* deliberately does not model. The concrete case is #142's RFC 8628 polling.
|
|
153
|
+
* `POST /api/auth/device/token` signals four COMPLETELY DIFFERENT outcomes —
|
|
154
|
+
* keep waiting, back off, the code expired, the user pressed Deny — in an
|
|
155
|
+
* `error` field that is neither `message` nor `code` nor `details`. So
|
|
156
|
+
* `extractServerMessage` throws it away, and the client is left unable to
|
|
157
|
+
* tell "still waiting" from "denied". Rather than teach this generic error
|
|
158
|
+
* model one endpoint's vocabulary, the raw body is kept and the device-flow
|
|
159
|
+
* classifier reads it.
|
|
160
|
+
*
|
|
161
|
+
* SAFE TO KEEP, NOT SAFE TO PRINT. It is an ERROR body, so it can never
|
|
162
|
+
* contain an issued token — a credential only ever appears in a 2xx — but it
|
|
163
|
+
* CAN carry a stack trace when the API runs with NODE_ENV !== 'production'
|
|
164
|
+
* (see the filter's `details` handling). `formatError` prints `message` and
|
|
165
|
+
* nothing else; nothing else should either.
|
|
166
|
+
*/
|
|
167
|
+
readonly rawBody?: string | undefined;
|
|
168
|
+
}
|
|
169
|
+
/**
|
|
170
|
+
* The server responded, and the response was not a success.
|
|
171
|
+
*
|
|
172
|
+
* `message` is built as `<status>: <server message>` so that the default
|
|
173
|
+
* `console.error(err.message)` at the top level is already the useful line.
|
|
174
|
+
*
|
|
175
|
+
* @stability experimental
|
|
176
|
+
*/
|
|
177
|
+
export declare class ApiError extends CliError implements ApiErrorFields {
|
|
178
|
+
readonly status: number;
|
|
179
|
+
readonly serverMessage: string;
|
|
180
|
+
readonly code: string | undefined;
|
|
181
|
+
readonly details: unknown;
|
|
182
|
+
readonly method: string;
|
|
183
|
+
readonly url: string;
|
|
184
|
+
readonly structured: boolean;
|
|
185
|
+
readonly rawBody: string | undefined;
|
|
186
|
+
constructor(fields: ApiErrorFields);
|
|
187
|
+
/** `EXIT.AUTH` for a 401, `EXIT.API` otherwise. */
|
|
188
|
+
get exitCode(): ExitCode;
|
|
189
|
+
/**
|
|
190
|
+
* Build an ApiError from a raw response body.
|
|
191
|
+
*
|
|
192
|
+
* TAKES THE BODY AS TEXT, NOT AS A RESPONSE TO `.json()`. That is the whole
|
|
193
|
+
* defence against the failure this issue calls out: calling `response.json()`
|
|
194
|
+
* on an nginx 502 page throws `SyntaxError: Unexpected token '<'`, which
|
|
195
|
+
* escapes as a completely unrelated error and buries the fact that the
|
|
196
|
+
* gateway is down. The caller reads `.text()` (which cannot throw on
|
|
197
|
+
* content) and hands the string here, so a non-JSON body is a case we handle
|
|
198
|
+
* rather than an exception we suffer.
|
|
199
|
+
*/
|
|
200
|
+
static fromBody(args: {
|
|
201
|
+
status: number;
|
|
202
|
+
statusText: string;
|
|
203
|
+
rawBody: string;
|
|
204
|
+
method: string;
|
|
205
|
+
url: string;
|
|
206
|
+
}): ApiError;
|
|
207
|
+
}
|
|
208
|
+
/**
|
|
209
|
+
* How the connection failed, in the terms a user can act on.
|
|
210
|
+
*
|
|
211
|
+
* @stability experimental
|
|
212
|
+
*/
|
|
213
|
+
export type NetworkFailureKind = 'dns' | 'refused' | 'reset' | 'tls' | 'timeout' | 'aborted' | 'unknown';
|
|
214
|
+
/**
|
|
215
|
+
* The request never produced a response.
|
|
216
|
+
*
|
|
217
|
+
* Carries no status, because there is none — that absence is the point, and it
|
|
218
|
+
* is why this is a separate class rather than an ApiError with `status: 0`. A
|
|
219
|
+
* `status: 0` sentinel invites `if (err.status >= 500)` to quietly do the
|
|
220
|
+
* wrong thing.
|
|
221
|
+
*
|
|
222
|
+
* @stability experimental
|
|
223
|
+
*/
|
|
224
|
+
export declare class NetworkError extends CliError {
|
|
225
|
+
/** `EXIT.NETWORK`. */
|
|
226
|
+
readonly exitCode: 4;
|
|
227
|
+
/** How the connection failed. */
|
|
228
|
+
readonly kind: NetworkFailureKind;
|
|
229
|
+
/** The request method. */
|
|
230
|
+
readonly method: string;
|
|
231
|
+
/** The request URL. Never contains the token. */
|
|
232
|
+
readonly url: string;
|
|
233
|
+
constructor(fields: {
|
|
234
|
+
kind: NetworkFailureKind;
|
|
235
|
+
method: string;
|
|
236
|
+
url: string;
|
|
237
|
+
message: string;
|
|
238
|
+
cause?: unknown;
|
|
239
|
+
});
|
|
240
|
+
/**
|
|
241
|
+
* Classify whatever `fetch` threw.
|
|
242
|
+
*
|
|
243
|
+
* Node's `fetch` rejects with a flat `TypeError: fetch failed` for every
|
|
244
|
+
* transport problem — DNS, refused, TLS, reset are all the same two words —
|
|
245
|
+
* and puts the real diagnosis in `.cause.code`. Printing the TypeError alone
|
|
246
|
+
* gives the user nothing; reading the cause turns it into "no such host" vs
|
|
247
|
+
* "connection refused", which are different problems with different fixes.
|
|
248
|
+
*/
|
|
249
|
+
static fromCause(args: {
|
|
250
|
+
cause: unknown;
|
|
251
|
+
method: string;
|
|
252
|
+
url: string;
|
|
253
|
+
timeoutMs: number;
|
|
254
|
+
/** True when the caller's own AbortSignal fired, not our timeout. */
|
|
255
|
+
callerAborted: boolean;
|
|
256
|
+
}): NetworkError;
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* Map any thrown value to an exit code.
|
|
260
|
+
*
|
|
261
|
+
* The `unknown` parameter is honest rather than defensive: JavaScript lets any
|
|
262
|
+
* value be thrown, and the top-level handler runs after user-supplied config,
|
|
263
|
+
* JSON parsing and third-party code have all had a turn.
|
|
264
|
+
*
|
|
265
|
+
* @stability stable
|
|
266
|
+
*/
|
|
267
|
+
export declare function exitCodeFor(error: unknown): ExitCode;
|
|
268
|
+
/**
|
|
269
|
+
* The one line printed to stderr when a command fails.
|
|
270
|
+
*
|
|
271
|
+
* Prefixed with the binary name because this output usually arrives in the
|
|
272
|
+
* middle of a CI log next to a dozen other tools' output, and an unattributed
|
|
273
|
+
* "403: ..." belongs to nobody.
|
|
274
|
+
*
|
|
275
|
+
* NO STACK TRACE. A stack is noise for the person who mistyped a URL, and the
|
|
276
|
+
* `cause` chain behind a fetch failure can contain request details. #144 can
|
|
277
|
+
* add a `--verbose` that opts into it.
|
|
278
|
+
*
|
|
279
|
+
* @stability stable
|
|
280
|
+
*/
|
|
281
|
+
export declare function formatError(error: unknown): string;
|
|
282
|
+
interface ExtractedError {
|
|
283
|
+
message: string;
|
|
284
|
+
code: string | undefined;
|
|
285
|
+
details: unknown;
|
|
286
|
+
structured: boolean;
|
|
287
|
+
}
|
|
288
|
+
/**
|
|
289
|
+
* Pull a usable sentence out of an error body, whatever shape it turns out to
|
|
290
|
+
* have.
|
|
291
|
+
*
|
|
292
|
+
* The happy path is the API's own envelope from
|
|
293
|
+
* `HttpExceptionFilter` in `@marinoscar/platform-api/core`:
|
|
294
|
+
*
|
|
295
|
+
* \{ statusCode, code, message, details?, timestamp, path \}
|
|
296
|
+
*
|
|
297
|
+
* with two documented wrinkles:
|
|
298
|
+
*
|
|
299
|
+
* - `details` is ABSENT IN PRODUCTION for unhandled errors (the filter only
|
|
300
|
+
* attaches a stack when NODE_ENV !== 'production'), so nothing here may
|
|
301
|
+
* depend on it being present.
|
|
302
|
+
*
|
|
303
|
+
* - `message` is NOT ALWAYS A STRING. The filter copies it straight out of
|
|
304
|
+
* the HttpException response, and a validation failure (ValidationPipe /
|
|
305
|
+
* nestjs-zod) puts an ARRAY of messages there. Rendering that with string
|
|
306
|
+
* concatenation yields `400: [object Object]`, which is the exact failure
|
|
307
|
+
* mode this issue exists to prevent.
|
|
308
|
+
*
|
|
309
|
+
* Everything else — an HTML proxy page, an empty body, a JSON array, a plain
|
|
310
|
+
* string — falls back to a snippet, never to a throw.
|
|
311
|
+
*/
|
|
312
|
+
export declare function extractServerMessage(rawBody: string, status: number, statusText: string): ExtractedError;
|
|
313
|
+
export {};
|
|
314
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/engine/errors.ts"],"names":[],"mappings":"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"}
|