@marinoscar/platform-cli 0.1.0-next.3 → 0.1.0-next.5
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 +88 -0
- package/README.md +126 -31
- 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 +10 -0
- package/dist/core/command-registry.d.ts.map +1 -1
- package/dist/core/command-registry.js +17 -0
- package/dist/core/command-registry.js.map +1 -1
- 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 +16 -2
- package/dist/core/env-spec-registry.d.ts.map +1 -1
- package/dist/core/env-spec-registry.js +15 -0
- package/dist/core/env-spec-registry.js.map +1 -1
- package/dist/core/env-values.d.ts +3 -2
- package/dist/core/env-values.d.ts.map +1 -1
- package/dist/core/env-values.js +5 -3
- package/dist/core/env-values.js.map +1 -1
- package/dist/core/index.d.ts +10 -2
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +6 -2
- package/dist/core/index.js.map +1 -1
- 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 +4 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -5
- package/dist/index.js.map +1 -1
- 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/index.d.ts +2 -1
- package/dist/telemetry/index.d.ts.map +1 -1
- package/dist/telemetry/index.js +1 -0
- package/dist/telemetry/index.js.map +1 -1
- package/dist/telemetry/node-span-relay.d.ts +1 -1
- package/dist/telemetry/node-span-relay.d.ts.map +1 -1
- package/dist/telemetry/node-span-relay.js +39 -6
- package/dist/telemetry/node-span-relay.js.map +1 -1
- package/dist/telemetry/node-span.d.ts +39 -7
- package/dist/telemetry/node-span.d.ts.map +1 -1
- package/dist/telemetry/node-span.js +19 -1
- package/dist/telemetry/node-span.js.map +1 -1
- 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 +43 -5
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import type { runCommand } from '../executor.js';
|
|
2
|
+
import type { ProxyRuntime } from '../proxy.js';
|
|
3
|
+
export type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
|
|
4
|
+
export interface CheckResult {
|
|
5
|
+
status: CheckStatus;
|
|
6
|
+
/** One line: what was found. "Docker 27.3.1", or "not installed". */
|
|
7
|
+
detail: string;
|
|
8
|
+
/** Shown on warn/fail. A command or a path, never a category. */
|
|
9
|
+
remedy?: string | undefined;
|
|
10
|
+
}
|
|
11
|
+
/** Filesystem probes, injectable so checks are testable without a real server. */
|
|
12
|
+
export interface CheckFs {
|
|
13
|
+
exists(path: string): boolean;
|
|
14
|
+
isDirectory(path: string): boolean;
|
|
15
|
+
isWritable(path: string): boolean;
|
|
16
|
+
/** UTF-8 contents, or undefined when absent or unreadable. Never throws. */
|
|
17
|
+
readFile(path: string): string | undefined;
|
|
18
|
+
/** Entry names, or [] when absent or unreadable. Never throws. */
|
|
19
|
+
readdir(path: string): string[];
|
|
20
|
+
}
|
|
21
|
+
export declare const realFs: CheckFs;
|
|
22
|
+
/** What the certificate ON THE WIRE says, as opposed to the one on disk. */
|
|
23
|
+
export interface ServedCertificate {
|
|
24
|
+
/** The peer certificate's `valid_to`. */
|
|
25
|
+
notAfter: Date;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Reads the certificate a TLS server presents for `domain`.
|
|
29
|
+
*
|
|
30
|
+
* `rejectUnauthorized: false` because the question is WHICH certificate is
|
|
31
|
+
* served, not whether it is trusted -- an expired or staging certificate is
|
|
32
|
+
* exactly the one this has to be able to read. Nothing is sent after the
|
|
33
|
+
* handshake. Rejects on any failure; the caller decides what that means.
|
|
34
|
+
*/
|
|
35
|
+
export declare function fetchServedCertificate(domain: string, options?: {
|
|
36
|
+
port?: number;
|
|
37
|
+
timeoutMs?: number;
|
|
38
|
+
}): Promise<ServedCertificate>;
|
|
39
|
+
/**
|
|
40
|
+
* True when nothing is listening on the loopback address for `port`.
|
|
41
|
+
*
|
|
42
|
+
* Binding is used rather than parsing `ss` output: it needs no external tool,
|
|
43
|
+
* it cannot be confused by a different output format, and it answers the
|
|
44
|
+
* question that actually matters - can this deployment take the port.
|
|
45
|
+
*/
|
|
46
|
+
export declare function isLoopbackPortFree(port: number): Promise<boolean>;
|
|
47
|
+
/** True when something answers on `port` of any interface. */
|
|
48
|
+
export declare function isPortListening(port: number): Promise<boolean>;
|
|
49
|
+
export interface CheckContext {
|
|
50
|
+
runCommand: typeof runCommand;
|
|
51
|
+
/** Where the deployment lives, or will. */
|
|
52
|
+
deployRoot: string;
|
|
53
|
+
/** Loopback port the shared proxy forwards to. */
|
|
54
|
+
bindPort: number;
|
|
55
|
+
/** The shared reverse proxy's directory. */
|
|
56
|
+
proxyRoot: string;
|
|
57
|
+
/** Public hostname, when one is known. DNS and TLS checks need it. */
|
|
58
|
+
domain?: string | undefined;
|
|
59
|
+
/** The resolved environment, when one exists. Database checks need it. */
|
|
60
|
+
env?: ReadonlyMap<string, string> | undefined;
|
|
61
|
+
fs?: CheckFs | undefined;
|
|
62
|
+
totalMemoryBytes?: (() => number) | undefined;
|
|
63
|
+
portFree?: ((port: number) => Promise<boolean>) | undefined;
|
|
64
|
+
portListening?: ((port: number) => Promise<boolean>) | undefined;
|
|
65
|
+
/** Resolves DNS; injected so the DNS checks (#177) are testable. */
|
|
66
|
+
resolveHost?: ((hostname: string) => Promise<string[]>) | undefined;
|
|
67
|
+
/** This host's own public addresses, when they can be determined. */
|
|
68
|
+
ownAddresses?: (() => Promise<string[]>) | undefined;
|
|
69
|
+
/**
|
|
70
|
+
* How the shared proxy runs, resolved once by the command building this
|
|
71
|
+
* context (see `resolveProxyRuntime`). Absent means unknown, and the checks
|
|
72
|
+
* that care fall back to their historical host-mode behaviour.
|
|
73
|
+
*/
|
|
74
|
+
proxyRuntime?: ProxyRuntime | undefined;
|
|
75
|
+
/** Reads the certificate served on the wire; injected so no test opens a socket. */
|
|
76
|
+
servedCertificate?: ((domain: string) => Promise<ServedCertificate>) | undefined;
|
|
77
|
+
/**
|
|
78
|
+
* The repository this deployment clones or fetches, when it is known (a
|
|
79
|
+
* flag, the deployment record, or the checkout's `origin`). Display-safe:
|
|
80
|
+
* normalised, so it carries no embedded credential.
|
|
81
|
+
*/
|
|
82
|
+
repoUrl?: string | undefined;
|
|
83
|
+
/**
|
|
84
|
+
* Whether git can ALREADY read `repoUrl` without a prompt -- a public
|
|
85
|
+
* repository, a credential helper, a stored token. Computed ONCE by the
|
|
86
|
+
* command building this context (see `gitCredentialStateFor`), because
|
|
87
|
+
* `severityFor` must stay synchronous and cheap. Absent means "not probed":
|
|
88
|
+
* nothing is promoted on an unknown.
|
|
89
|
+
*/
|
|
90
|
+
gitCredentialed?: boolean | undefined;
|
|
91
|
+
/**
|
|
92
|
+
* True when this run will NOT publish through the shared proxy (install or
|
|
93
|
+
* update with --skip-proxy). The proxy prerequisites are then advice, not
|
|
94
|
+
* blockers. Doctor leaves it unset: it asks about a deployment in general.
|
|
95
|
+
*/
|
|
96
|
+
skipProxy?: boolean | undefined;
|
|
97
|
+
/**
|
|
98
|
+
* True when this run is authorised to BOOTSTRAP the shared proxy if it is
|
|
99
|
+
* absent (#391: `--bootstrap-proxy`, or a yes at install's prompt). A proxy
|
|
100
|
+
* container that does not exist, in a proxy root with no compose file, is
|
|
101
|
+
* then not a blocker -- install is about to create it. An existing but
|
|
102
|
+
* stopped proxy, or a root with a compose file, still fails: those belong to
|
|
103
|
+
* somebody else and are never touched.
|
|
104
|
+
*/
|
|
105
|
+
proxyBootstrap?: boolean | undefined;
|
|
106
|
+
/**
|
|
107
|
+
* True when the operator chose to run the API as a superuser or BYPASSRLS
|
|
108
|
+
* role anyway (`--allow-superuser`, recorded in the deployment state, #980).
|
|
109
|
+
* `database-role-ordinary` then reports a warning that names the consequence
|
|
110
|
+
* instead of failing.
|
|
111
|
+
*/
|
|
112
|
+
allowSuperuser?: boolean | undefined;
|
|
113
|
+
}
|
|
114
|
+
export type Severity = 'required' | 'recommended';
|
|
115
|
+
export interface Check {
|
|
116
|
+
/** Stable, kebab-case. Used by --json and by tests. */
|
|
117
|
+
id: string;
|
|
118
|
+
title: string;
|
|
119
|
+
/**
|
|
120
|
+
* The static severity: what the check is when nothing about the context
|
|
121
|
+
* says otherwise. Read it through `severityOf`, never directly, once a
|
|
122
|
+
* context exists.
|
|
123
|
+
*/
|
|
124
|
+
severity: Severity;
|
|
125
|
+
/**
|
|
126
|
+
* The severity for THIS context, when it depends on one -- `certbot-installed`
|
|
127
|
+
* is required only when the proxy runs on the host. Must be read-only and
|
|
128
|
+
* cheap; a throw falls back to `severity`.
|
|
129
|
+
*/
|
|
130
|
+
severityFor?: ((context: CheckContext) => Severity) | undefined;
|
|
131
|
+
/** Ids that must pass first; otherwise this reports `skip`. */
|
|
132
|
+
requires?: readonly string[] | undefined;
|
|
133
|
+
run(context: CheckContext): Promise<CheckResult>;
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* A check's EFFECTIVE severity in a context.
|
|
137
|
+
*
|
|
138
|
+
* ⚠ Everything that decides an exit code -- `requiredChecks`, `checksPassed`
|
|
139
|
+
* via `CompletedCheck.severity`, the doctor and preflight renderers -- goes
|
|
140
|
+
* through this, so a check promoted or demoted by its context is promoted or
|
|
141
|
+
* demoted everywhere at once rather than in whichever caller remembered.
|
|
142
|
+
*/
|
|
143
|
+
export declare function severityOf(check: Check, context: CheckContext): Severity;
|
|
144
|
+
export interface CompletedCheck extends CheckResult {
|
|
145
|
+
id: string;
|
|
146
|
+
title: string;
|
|
147
|
+
/** The EFFECTIVE severity this run evaluated it under -- see `severityOf`. */
|
|
148
|
+
severity: Severity;
|
|
149
|
+
durationMs: number;
|
|
150
|
+
}
|
|
151
|
+
export declare function contextFs(context: CheckContext): CheckFs;
|
|
152
|
+
export declare function contextMemory(context: CheckContext): number;
|
|
153
|
+
export declare function contextPortFree(context: CheckContext): (port: number) => Promise<boolean>;
|
|
154
|
+
export declare function contextServedCertificate(context: CheckContext): (domain: string) => Promise<ServedCertificate>;
|
|
155
|
+
export declare function contextPortListening(context: CheckContext): (port: number) => Promise<boolean>;
|
|
156
|
+
/**
|
|
157
|
+
* Runs the registry in order, honouring `requires`.
|
|
158
|
+
*
|
|
159
|
+
* A check that throws is reported as a failure and the run continues - rule 1.
|
|
160
|
+
* `onResult` fires as each completes so a command can stream a checklist
|
|
161
|
+
* rather than appearing to hang through a dozen subprocess calls.
|
|
162
|
+
*/
|
|
163
|
+
export declare function runChecks(checks: readonly Check[], context: CheckContext, onResult?: (result: CompletedCheck) => void): Promise<CompletedCheck[]>;
|
|
164
|
+
/**
|
|
165
|
+
* True when every required check passed. Warnings do not fail a run.
|
|
166
|
+
*
|
|
167
|
+
* Reads `CompletedCheck.severity`, which `runChecks` already set to the
|
|
168
|
+
* EFFECTIVE severity, so a context-promoted check fails the run here too.
|
|
169
|
+
*/
|
|
170
|
+
export declare function checksPassed(results: readonly CompletedCheck[]): boolean;
|
|
171
|
+
export interface CheckSummary {
|
|
172
|
+
passed: number;
|
|
173
|
+
warned: number;
|
|
174
|
+
failed: number;
|
|
175
|
+
skipped: number;
|
|
176
|
+
}
|
|
177
|
+
export declare function summarise(results: readonly CompletedCheck[]): CheckSummary;
|
|
178
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/engine/deploy/checks/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
import { accessSync, constants, readFileSync, readdirSync, statSync } from 'node:fs';
|
|
2
|
+
import { createServer } from 'node:net';
|
|
3
|
+
import { totalmem } from 'node:os';
|
|
4
|
+
import { connect as tlsConnect } from 'node:tls';
|
|
5
|
+
export const realFs = {
|
|
6
|
+
exists(path) {
|
|
7
|
+
try {
|
|
8
|
+
statSync(path);
|
|
9
|
+
return true;
|
|
10
|
+
}
|
|
11
|
+
catch {
|
|
12
|
+
return false;
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
isDirectory(path) {
|
|
16
|
+
try {
|
|
17
|
+
return statSync(path).isDirectory();
|
|
18
|
+
}
|
|
19
|
+
catch {
|
|
20
|
+
return false;
|
|
21
|
+
}
|
|
22
|
+
},
|
|
23
|
+
isWritable(path) {
|
|
24
|
+
try {
|
|
25
|
+
accessSync(path, constants.W_OK);
|
|
26
|
+
return true;
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
return false;
|
|
30
|
+
}
|
|
31
|
+
},
|
|
32
|
+
readFile(path) {
|
|
33
|
+
try {
|
|
34
|
+
return readFileSync(path, 'utf8');
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
return undefined;
|
|
38
|
+
}
|
|
39
|
+
},
|
|
40
|
+
readdir(path) {
|
|
41
|
+
try {
|
|
42
|
+
return readdirSync(path);
|
|
43
|
+
}
|
|
44
|
+
catch {
|
|
45
|
+
return [];
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
};
|
|
49
|
+
/**
|
|
50
|
+
* Reads the certificate a TLS server presents for `domain`.
|
|
51
|
+
*
|
|
52
|
+
* `rejectUnauthorized: false` because the question is WHICH certificate is
|
|
53
|
+
* served, not whether it is trusted -- an expired or staging certificate is
|
|
54
|
+
* exactly the one this has to be able to read. Nothing is sent after the
|
|
55
|
+
* handshake. Rejects on any failure; the caller decides what that means.
|
|
56
|
+
*/
|
|
57
|
+
export async function fetchServedCertificate(domain, options = {}) {
|
|
58
|
+
return await new Promise((resolve, reject) => {
|
|
59
|
+
const socket = tlsConnect({
|
|
60
|
+
host: domain,
|
|
61
|
+
port: options.port ?? 443,
|
|
62
|
+
servername: domain,
|
|
63
|
+
rejectUnauthorized: false,
|
|
64
|
+
});
|
|
65
|
+
socket.setTimeout(options.timeoutMs ?? 10_000, () => {
|
|
66
|
+
socket.destroy(new Error(`timed out reading the certificate served for ${domain}`));
|
|
67
|
+
});
|
|
68
|
+
socket.once('error', reject);
|
|
69
|
+
socket.once('secureConnect', () => {
|
|
70
|
+
const certificate = socket.getPeerCertificate();
|
|
71
|
+
socket.end();
|
|
72
|
+
const notAfter = new Date(certificate.valid_to ?? '');
|
|
73
|
+
if (Number.isNaN(notAfter.getTime())) {
|
|
74
|
+
reject(new Error(`unrecognised served expiry: ${String(certificate.valid_to)}`));
|
|
75
|
+
return;
|
|
76
|
+
}
|
|
77
|
+
resolve({ notAfter });
|
|
78
|
+
});
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* True when nothing is listening on the loopback address for `port`.
|
|
83
|
+
*
|
|
84
|
+
* Binding is used rather than parsing `ss` output: it needs no external tool,
|
|
85
|
+
* it cannot be confused by a different output format, and it answers the
|
|
86
|
+
* question that actually matters - can this deployment take the port.
|
|
87
|
+
*/
|
|
88
|
+
export async function isLoopbackPortFree(port) {
|
|
89
|
+
return await new Promise((resolve) => {
|
|
90
|
+
const server = createServer();
|
|
91
|
+
server.once('error', () => resolve(false));
|
|
92
|
+
server.once('listening', () => {
|
|
93
|
+
server.close(() => resolve(true));
|
|
94
|
+
});
|
|
95
|
+
server.listen(port, '127.0.0.1');
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
/** True when something answers on `port` of any interface. */
|
|
99
|
+
export async function isPortListening(port) {
|
|
100
|
+
return !(await new Promise((resolve) => {
|
|
101
|
+
const server = createServer();
|
|
102
|
+
server.once('error', () => resolve(false));
|
|
103
|
+
server.once('listening', () => {
|
|
104
|
+
server.close(() => resolve(true));
|
|
105
|
+
});
|
|
106
|
+
server.listen(port, '0.0.0.0');
|
|
107
|
+
}));
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* A check's EFFECTIVE severity in a context.
|
|
111
|
+
*
|
|
112
|
+
* ⚠ Everything that decides an exit code -- `requiredChecks`, `checksPassed`
|
|
113
|
+
* via `CompletedCheck.severity`, the doctor and preflight renderers -- goes
|
|
114
|
+
* through this, so a check promoted or demoted by its context is promoted or
|
|
115
|
+
* demoted everywhere at once rather than in whichever caller remembered.
|
|
116
|
+
*/
|
|
117
|
+
export function severityOf(check, context) {
|
|
118
|
+
if (check.severityFor === undefined)
|
|
119
|
+
return check.severity;
|
|
120
|
+
try {
|
|
121
|
+
return check.severityFor(context);
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
// Rule 1 extends to this: a broken severity function must not abort the
|
|
125
|
+
// run. The static severity is the documented fallback.
|
|
126
|
+
return check.severity;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
export function contextFs(context) {
|
|
130
|
+
return context.fs ?? realFs;
|
|
131
|
+
}
|
|
132
|
+
export function contextMemory(context) {
|
|
133
|
+
return (context.totalMemoryBytes ?? totalmem)();
|
|
134
|
+
}
|
|
135
|
+
export function contextPortFree(context) {
|
|
136
|
+
return context.portFree ?? isLoopbackPortFree;
|
|
137
|
+
}
|
|
138
|
+
export function contextServedCertificate(context) {
|
|
139
|
+
return context.servedCertificate ?? ((domain) => fetchServedCertificate(domain));
|
|
140
|
+
}
|
|
141
|
+
export function contextPortListening(context) {
|
|
142
|
+
return context.portListening ?? isPortListening;
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* Runs the registry in order, honouring `requires`.
|
|
146
|
+
*
|
|
147
|
+
* A check that throws is reported as a failure and the run continues - rule 1.
|
|
148
|
+
* `onResult` fires as each completes so a command can stream a checklist
|
|
149
|
+
* rather than appearing to hang through a dozen subprocess calls.
|
|
150
|
+
*/
|
|
151
|
+
export async function runChecks(checks, context, onResult) {
|
|
152
|
+
const results = [];
|
|
153
|
+
const byId = new Map();
|
|
154
|
+
for (const check of checks) {
|
|
155
|
+
const startedAt = Date.now();
|
|
156
|
+
const unmet = (check.requires ?? []).filter((id) => byId.get(id)?.status !== 'pass');
|
|
157
|
+
const result = unmet.length > 0
|
|
158
|
+
? {
|
|
159
|
+
status: 'skip',
|
|
160
|
+
// Named, so a wall of skips explains itself rather than looking
|
|
161
|
+
// like the checks silently did nothing.
|
|
162
|
+
detail: `skipped: ${unmet.join(', ')} did not pass`,
|
|
163
|
+
}
|
|
164
|
+
: await check.run(context).catch((error) => ({
|
|
165
|
+
status: 'fail',
|
|
166
|
+
detail: error instanceof Error ? error.message : String(error),
|
|
167
|
+
remedy: 'This check itself failed; the problem may be with appctl.',
|
|
168
|
+
}));
|
|
169
|
+
const completed = {
|
|
170
|
+
...result,
|
|
171
|
+
id: check.id,
|
|
172
|
+
title: check.title,
|
|
173
|
+
severity: severityOf(check, context),
|
|
174
|
+
durationMs: Date.now() - startedAt,
|
|
175
|
+
};
|
|
176
|
+
results.push(completed);
|
|
177
|
+
byId.set(check.id, completed);
|
|
178
|
+
onResult?.(completed);
|
|
179
|
+
}
|
|
180
|
+
return results;
|
|
181
|
+
}
|
|
182
|
+
/**
|
|
183
|
+
* True when every required check passed. Warnings do not fail a run.
|
|
184
|
+
*
|
|
185
|
+
* Reads `CompletedCheck.severity`, which `runChecks` already set to the
|
|
186
|
+
* EFFECTIVE severity, so a context-promoted check fails the run here too.
|
|
187
|
+
*/
|
|
188
|
+
export function checksPassed(results) {
|
|
189
|
+
return !results.some((result) => result.severity === 'required' && result.status === 'fail');
|
|
190
|
+
}
|
|
191
|
+
export function summarise(results) {
|
|
192
|
+
return {
|
|
193
|
+
passed: results.filter((result) => result.status === 'pass').length,
|
|
194
|
+
warned: results.filter((result) => result.status === 'warn').length,
|
|
195
|
+
failed: results.filter((result) => result.status === 'fail').length,
|
|
196
|
+
skipped: results.filter((result) => result.status === 'skip').length,
|
|
197
|
+
};
|
|
198
|
+
}
|
|
199
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/engine/deploy/checks/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { EnvGroup } from './env-metadata.js';
|
|
2
|
+
/** The group whose presence adds the telemetry stack. Always on; see above. */
|
|
3
|
+
export declare const TELEMETRY_GROUP: "observability";
|
|
4
|
+
/** Groups every VPS deployment has, whatever was passed or recorded. */
|
|
5
|
+
export declare const ALWAYS_ON_GROUPS: readonly EnvGroup[];
|
|
6
|
+
/**
|
|
7
|
+
* The groups a deployment actually runs with: the requested or recorded ones,
|
|
8
|
+
* plus every always-on group. Order is kept and duplicates dropped.
|
|
9
|
+
*
|
|
10
|
+
* THE ONE PLACE this is decided. Install, update, uninstall, health, the
|
|
11
|
+
* compose file list, the environment wizard and the update's drift check all
|
|
12
|
+
* route through it, so an existing deployment whose `state.groups` predates
|
|
13
|
+
* #567 gets the telemetry stack -- files and keys -- on its next update.
|
|
14
|
+
*
|
|
15
|
+
* @param groups - The requested or recorded groups.
|
|
16
|
+
* @returns Those groups plus every always-on and default-enabled one.
|
|
17
|
+
* @stability experimental
|
|
18
|
+
*/
|
|
19
|
+
export declare function effectiveGroups(groups?: readonly string[] | undefined): EnvGroup[];
|
|
20
|
+
/**
|
|
21
|
+
* The compose files for a deployment with these groups, in the order compose
|
|
22
|
+
* must apply them. File names only; callers join the directory. The telemetry
|
|
23
|
+
* files are always included (`effectiveGroups`). With `composeDir` (the
|
|
24
|
+
* checkout's infra/compose), the app's overlays found there come last.
|
|
25
|
+
*/
|
|
26
|
+
export declare function composeFilesFor(groups?: readonly string[] | undefined, composeDir?: string): string[];
|
|
27
|
+
/** `-f <file>` for each file, in order. */
|
|
28
|
+
export declare function composeFileArgs(groups?: readonly string[] | undefined, composeDir?: string): string[];
|
|
29
|
+
//# sourceMappingURL=compose-files.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compose-files.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/compose-files.ts"],"names":[],"mappings":"AA6DA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,+EAA+E;AAC/E,eAAO,MAAM,eAAe,iBAAqD,CAAC;AAiBlF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,SAAS,QAAQ,EAAsB,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,CAWlF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAGrG;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAErG"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Which compose files make up this deployment (issue #531, epic #528)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// ONE list, read by every compose invocation: install, update, uninstall and
|
|
6
|
+
// the health gate. It used to be two hard-coded copies (install.ts and
|
|
7
|
+
// health.ts), which is how a stack ends up started with one set of files and
|
|
8
|
+
// inspected -- or torn down -- with another.
|
|
9
|
+
//
|
|
10
|
+
// The list depends on the deployment's groups, and those come from the flag
|
|
11
|
+
// on this run or from `state.groups` -- NEVER from reading the `.env`, for the
|
|
12
|
+
// reason `DeployState.groups` gives -- always widened by `effectiveGroups`.
|
|
13
|
+
//
|
|
14
|
+
// TELEMETRY IS ALWAYS ON for a VPS deployment (issue #567). `observability`
|
|
15
|
+
// used to be opt-in, and a deployment installed without it had no
|
|
16
|
+
// `greptimedb` container, so the admin telemetry page failed with "host
|
|
17
|
+
// greptimedb could not be resolved" and could only be fixed from a shell.
|
|
18
|
+
// Everything telemetry-related must be doable from the admin UI, so the stack
|
|
19
|
+
// ships with every deployment. Deploying it does not force export on:
|
|
20
|
+
// collection stays gated at runtime by the admin UI's telemetry toggle.
|
|
21
|
+
// `--group observability` is still accepted, as a harmless no-op.
|
|
22
|
+
//
|
|
23
|
+
// ORDER IS LOAD-BEARING:
|
|
24
|
+
//
|
|
25
|
+
// base, prod, [telemetry], vps, [vps.telemetry]
|
|
26
|
+
//
|
|
27
|
+
// - The VPS files come LAST. Their `ports: !override` only replaces what the
|
|
28
|
+
// files BEFORE them published; applied earlier, a later file's ports would
|
|
29
|
+
// merge back in and the service would be reachable on 0.0.0.0.
|
|
30
|
+
// - telemetry.compose.yml adds services, so it sits before the VPS files and
|
|
31
|
+
// inherits their hardening.
|
|
32
|
+
// - vps.telemetry.compose.yml is separate from vps.compose.yml because a
|
|
33
|
+
// service block for `greptimedb` in vps.compose.yml would be a service
|
|
34
|
+
// with no image on every deployment WITHOUT telemetry, and compose rejects
|
|
35
|
+
// the whole project for it.
|
|
36
|
+
//
|
|
37
|
+
// THE ORDER COMES FROM THE PACKAGE (issues #705, #714). Every file above is
|
|
38
|
+
// generated into infra/compose/ by @marinoscar/platform-infra (`npm run
|
|
39
|
+
// platform:infra:sync`), and the package's `composeFilesForMode('vps')` owns
|
|
40
|
+
// the order, so the deploy and every other consumer apply the same list.
|
|
41
|
+
//
|
|
42
|
+
// APP OVERLAYS COME LAST (#714). An app changes the stack with
|
|
43
|
+
// `infra/compose/app.*.compose.yml` files, never by editing a generated one.
|
|
44
|
+
// Given the checkout's compose directory, the list ends with the overlays
|
|
45
|
+
// that apply to a VPS deployment (`app.<name>`, `app.prod.<name>`,
|
|
46
|
+
// `app.vps.<name>`), sorted by file name, so they win:
|
|
47
|
+
//
|
|
48
|
+
// base, prod, [telemetry], vps, [vps.telemetry], app.*.compose.yml
|
|
49
|
+
//
|
|
50
|
+
// A name ending in `.example.compose.yml` is documentation and never applied.
|
|
51
|
+
// Without a directory (or when it cannot be read) the list has no overlays.
|
|
52
|
+
// =============================================================================
|
|
53
|
+
import { readdirSync } from 'node:fs';
|
|
54
|
+
import { composeFilesForMode } from '@marinoscar/platform-infra';
|
|
55
|
+
import { telemetryInfraFragment } from '@marinoscar/platform-infra/telemetry';
|
|
56
|
+
import { listEnvGroups } from '../../core/index.js';
|
|
57
|
+
import { ensurePlatformRegistrations } from '../builtin-registrations.js';
|
|
58
|
+
/** The group whose presence adds the telemetry stack. Always on; see above. */
|
|
59
|
+
export const TELEMETRY_GROUP = telemetryInfraFragment.envGroup;
|
|
60
|
+
/**
|
|
61
|
+
* The file names in the checkout's compose directory, where the app's
|
|
62
|
+
* overlays live. Empty when no directory is given or it cannot be read: a
|
|
63
|
+
* missing checkout must not turn into a thrown error here, the compose call
|
|
64
|
+
* that follows reports it with the right context.
|
|
65
|
+
*/
|
|
66
|
+
function composeDirListing(composeDir) {
|
|
67
|
+
if (composeDir === undefined)
|
|
68
|
+
return [];
|
|
69
|
+
try {
|
|
70
|
+
return readdirSync(composeDir);
|
|
71
|
+
}
|
|
72
|
+
catch {
|
|
73
|
+
return [];
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
/** Groups every VPS deployment has, whatever was passed or recorded. */
|
|
77
|
+
export const ALWAYS_ON_GROUPS = [TELEMETRY_GROUP];
|
|
78
|
+
/**
|
|
79
|
+
* The groups a deployment actually runs with: the requested or recorded ones,
|
|
80
|
+
* plus every always-on group. Order is kept and duplicates dropped.
|
|
81
|
+
*
|
|
82
|
+
* THE ONE PLACE this is decided. Install, update, uninstall, health, the
|
|
83
|
+
* compose file list, the environment wizard and the update's drift check all
|
|
84
|
+
* route through it, so an existing deployment whose `state.groups` predates
|
|
85
|
+
* #567 gets the telemetry stack -- files and keys -- on its next update.
|
|
86
|
+
*
|
|
87
|
+
* @param groups - The requested or recorded groups.
|
|
88
|
+
* @returns Those groups plus every always-on and default-enabled one.
|
|
89
|
+
* @stability experimental
|
|
90
|
+
*/
|
|
91
|
+
export function effectiveGroups(groups) {
|
|
92
|
+
ensurePlatformRegistrations();
|
|
93
|
+
// Always-on first, then every other registered group that is on by default
|
|
94
|
+
// (an app's `defaultEnabled` group): the platform's own default is the
|
|
95
|
+
// telemetry group alone, so a deployment without app groups is unchanged.
|
|
96
|
+
const defaults = listEnvGroups().filter((group) => group.defaultEnabled).map((group) => group.id);
|
|
97
|
+
const result = [];
|
|
98
|
+
for (const group of [...(groups ?? []), ...ALWAYS_ON_GROUPS, ...defaults]) {
|
|
99
|
+
if (!result.includes(group))
|
|
100
|
+
result.push(group);
|
|
101
|
+
}
|
|
102
|
+
return result;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* The compose files for a deployment with these groups, in the order compose
|
|
106
|
+
* must apply them. File names only; callers join the directory. The telemetry
|
|
107
|
+
* files are always included (`effectiveGroups`). With `composeDir` (the
|
|
108
|
+
* checkout's infra/compose), the app's overlays found there come last.
|
|
109
|
+
*/
|
|
110
|
+
export function composeFilesFor(groups, composeDir) {
|
|
111
|
+
const telemetry = effectiveGroups(groups).includes(TELEMETRY_GROUP);
|
|
112
|
+
return composeFilesForMode('vps', { telemetry, overlays: composeDirListing(composeDir) });
|
|
113
|
+
}
|
|
114
|
+
/** `-f <file>` for each file, in order. */
|
|
115
|
+
export function composeFileArgs(groups, composeDir) {
|
|
116
|
+
return composeFilesFor(groups, composeDir).flatMap((file) => ['-f', file]);
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=compose-files.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compose-files.js","sourceRoot":"","sources":["../../../src/engine/deploy/compose-files.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { type PromptContext } from '../prompt.js';
|
|
2
|
+
export type ConsentOutcome =
|
|
3
|
+
/** The flag was passed. */
|
|
4
|
+
'flag'
|
|
5
|
+
/** The operator answered yes. */
|
|
6
|
+
| 'granted'
|
|
7
|
+
/** The operator answered no. */
|
|
8
|
+
| 'declined'
|
|
9
|
+
/** Nobody could be asked, and the flag was not passed. */
|
|
10
|
+
| 'unavailable';
|
|
11
|
+
export interface ConsentOptions {
|
|
12
|
+
/** The flag that gives consent in advance. */
|
|
13
|
+
flag?: boolean | undefined;
|
|
14
|
+
nonInteractive?: boolean | undefined;
|
|
15
|
+
promptContext?: PromptContext | undefined;
|
|
16
|
+
/** Replaces the terminal question; the test seam. */
|
|
17
|
+
ask?: ((question: string) => Promise<boolean>) | undefined;
|
|
18
|
+
}
|
|
19
|
+
export declare function consented(outcome: ConsentOutcome): boolean;
|
|
20
|
+
/** Asks, or does not, by the rules in the header. Never throws for want of a TTY. */
|
|
21
|
+
export declare function obtainConsent(question: string, options: ConsentOptions): Promise<ConsentOutcome>;
|
|
22
|
+
/**
|
|
23
|
+
* Whether `obtainConsent` COULD answer anything but `unavailable` -- the flag
|
|
24
|
+
* was passed, or someone can be asked -- without asking. For a gate that wants
|
|
25
|
+
* to refuse early, before anything is cloned, exactly when the later gate is
|
|
26
|
+
* bound to refuse (#396). Never prompts.
|
|
27
|
+
*/
|
|
28
|
+
export declare function canObtainConsent(options: ConsentOptions): boolean;
|
|
29
|
+
//# sourceMappingURL=consent.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../../src/engine/deploy/consent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAqBtE,MAAM,MAAM,cAAc;AACxB,2BAA2B;AACzB,MAAM;AACR,iCAAiC;GAC/B,SAAS;AACX,gCAAgC;GAC9B,UAAU;AACZ,0DAA0D;GACxD,aAAa,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,qDAAqD;IACrD,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAC5D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAE1D;AAED,qFAAqF;AACrF,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CAazB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAKjE"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { canPrompt, confirm } from '../prompt.js';
|
|
2
|
+
export function consented(outcome) {
|
|
3
|
+
return outcome === 'flag' || outcome === 'granted';
|
|
4
|
+
}
|
|
5
|
+
/** Asks, or does not, by the rules in the header. Never throws for want of a TTY. */
|
|
6
|
+
export async function obtainConsent(question, options) {
|
|
7
|
+
if (options.flag === true)
|
|
8
|
+
return 'flag';
|
|
9
|
+
if (options.nonInteractive === true)
|
|
10
|
+
return 'unavailable';
|
|
11
|
+
if (options.ask !== undefined) {
|
|
12
|
+
return (await options.ask(question)) ? 'granted' : 'declined';
|
|
13
|
+
}
|
|
14
|
+
if (!canPrompt(options.promptContext))
|
|
15
|
+
return 'unavailable';
|
|
16
|
+
// Defaults to NO: both actions this gates are hard to take back.
|
|
17
|
+
const yes = await confirm(question, { defaultValue: false }, options.promptContext);
|
|
18
|
+
return yes ? 'granted' : 'declined';
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Whether `obtainConsent` COULD answer anything but `unavailable` -- the flag
|
|
22
|
+
* was passed, or someone can be asked -- without asking. For a gate that wants
|
|
23
|
+
* to refuse early, before anything is cloned, exactly when the later gate is
|
|
24
|
+
* bound to refuse (#396). Never prompts.
|
|
25
|
+
*/
|
|
26
|
+
export function canObtainConsent(options) {
|
|
27
|
+
if (options.flag === true)
|
|
28
|
+
return true;
|
|
29
|
+
if (options.nonInteractive === true)
|
|
30
|
+
return false;
|
|
31
|
+
if (options.ask !== undefined)
|
|
32
|
+
return true;
|
|
33
|
+
return canPrompt(options.promptContext);
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=consent.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../../src/engine/deploy/consent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAsB,MAAM,cAAc,CAAC;AAwCtE,MAAM,UAAU,SAAS,CAAC,OAAuB;IAC/C,OAAO,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,SAAS,CAAC;AACrD,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,OAAuB;IAEvB,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI;QAAE,OAAO,aAAa,CAAC;IAE1D,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC;QAAE,OAAO,aAAa,CAAC;IAE5D,iEAAiE;IACjE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACpF,OAAO,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AAC1C,CAAC"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { runCommand as defaultRunCommand } from './executor.js';
|
|
2
|
+
/** PostgreSQL's `object_in_use`: "database is being accessed by other users". */
|
|
3
|
+
export declare const OBJECT_IN_USE = "55006";
|
|
4
|
+
export interface DatabaseDropOptions {
|
|
5
|
+
/** Connection parameters, read from the deployment's own `.env`. */
|
|
6
|
+
env: ReadonlyMap<string, string>;
|
|
7
|
+
/** The database to drop. Must be confirmed by the caller before we get here. */
|
|
8
|
+
database: string;
|
|
9
|
+
runCommand?: typeof defaultRunCommand | undefined;
|
|
10
|
+
/** Postgres image used for the throwaway psql client. */
|
|
11
|
+
image?: string | undefined;
|
|
12
|
+
}
|
|
13
|
+
export interface DatabaseDropResult {
|
|
14
|
+
dropped: boolean;
|
|
15
|
+
/** How many backends were terminated. Always reported, even when zero. */
|
|
16
|
+
terminated: number;
|
|
17
|
+
detail: string;
|
|
18
|
+
}
|
|
19
|
+
/** Double-quoted, with embedded quotes doubled. Never interpolated raw. */
|
|
20
|
+
export declare function quoteIdentifier(name: string): string;
|
|
21
|
+
export declare function dropDatabase(options: DatabaseDropOptions): Promise<DatabaseDropResult>;
|
|
22
|
+
//# sourceMappingURL=database-drop.d.ts.map
|