@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,362 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { execFile } from 'node:child_process';
|
|
3
|
+
import { Transform } from 'node:stream';
|
|
4
|
+
import { promisify } from 'node:util';
|
|
5
|
+
import { PG_DUMP_COMMAND, PSQL_COMMAND, spawnPgDump } from '../pg-dump.js';
|
|
6
|
+
// =============================================================================
|
|
7
|
+
// `db.backup.run` — taking the database dump on a worker node (issue #352)
|
|
8
|
+
// =============================================================================
|
|
9
|
+
//
|
|
10
|
+
// The node counterpart of `DatabaseBackupRunHandler`, and the first executor in
|
|
11
|
+
// this repository that holds a CREDENTIAL. Everything unusual about it follows
|
|
12
|
+
// from that one fact, so the rules are worth stating before the code:
|
|
13
|
+
//
|
|
14
|
+
// -----------------------------------------------------------------------------
|
|
15
|
+
// ⚠ THE SECRET LIVES IN ONE LOCAL CONSTANT, FOR THE LIFE OF ONE FUNCTION CALL
|
|
16
|
+
// -----------------------------------------------------------------------------
|
|
17
|
+
//
|
|
18
|
+
// It is fetched inside `execute`, held in a `const`, handed to ONE child
|
|
19
|
+
// process through its environment, and dropped when the call returns. It must
|
|
20
|
+
// never reach:
|
|
21
|
+
//
|
|
22
|
+
// * `node-config.ts` or anything that writes it — the config file is a
|
|
23
|
+
// durable, world-readable-if-you-are-root artifact on a machine this
|
|
24
|
+
// deployment may not own, and epic #345's founding rule is that A NODE
|
|
25
|
+
// NEVER PERSISTS CREDENTIALS. `db-backup-run.test.ts` asserts that no
|
|
26
|
+
// config writer is ever called from this path; that assertion is the
|
|
27
|
+
// acceptance test for the rule, not a nicety.
|
|
28
|
+
// * the state directory (`paths.ts`) — same argument, plus it survives
|
|
29
|
+
// restarts.
|
|
30
|
+
// * a log line. `logger.ts` redacts `PGPASSWORD` and the broker's material
|
|
31
|
+
// shape, and this file additionally never puts the material in a message.
|
|
32
|
+
// Two independent mechanisms, because "nothing logs it" is a property of
|
|
33
|
+
// the whole pipeline and not of any one call site.
|
|
34
|
+
// * a child process that outlives the job. `pg_dump` is awaited; `psql` (the
|
|
35
|
+
// provenance probes) is awaited with a short timeout.
|
|
36
|
+
//
|
|
37
|
+
// The credential expires with the job's LEASE, so even a leak is bounded — but
|
|
38
|
+
// "bounded" is not the design, it is the backstop.
|
|
39
|
+
//
|
|
40
|
+
// -----------------------------------------------------------------------------
|
|
41
|
+
// THE ARCHIVE NEVER TOUCHES THIS MACHINE'S DISK OR HEAP
|
|
42
|
+
// -----------------------------------------------------------------------------
|
|
43
|
+
//
|
|
44
|
+
// `pg_dump` writes to stdout, which is piped through a hashing/metering
|
|
45
|
+
// `Transform` straight into a SINGLE-SHOT `PUT` at the presigned URL. Nothing
|
|
46
|
+
// buffers, nothing spools to a temp file: a 200 GB dump costs a hash context
|
|
47
|
+
// and a socket. That is the same streaming contract
|
|
48
|
+
// `db-backup-runner.service.ts` states at length for the server path, and it
|
|
49
|
+
// is what makes moving this work to a node worth doing at all — the bytes go
|
|
50
|
+
// from the database to object storage without transiting the API.
|
|
51
|
+
//
|
|
52
|
+
// ⚠ `fetch` WITH A `Readable` BODY REQUIRES `duplex: 'half'`. Without it
|
|
53
|
+
// undici refuses the request outright ("RequestInit: duplex option is required
|
|
54
|
+
// when sending a body"), and the failure is at call time rather than in the
|
|
55
|
+
// transfer, which makes it look like a bad URL.
|
|
56
|
+
//
|
|
57
|
+
// ⚠ BOTH HALVES ARE AWAITED, and neither one alone is evidence. A dump that
|
|
58
|
+
// dies mid-archive simply ENDS its stdout, so the upload reports a perfectly
|
|
59
|
+
// successful transfer of a TRUNCATED file; only `pg_dump`'s exit code tells
|
|
60
|
+
// the two apart. Equally, a dump that exits 0 says nothing about whether the
|
|
61
|
+
// PUT was accepted. The server then verifies what actually landed in the
|
|
62
|
+
// bucket — see `persistNodeResult` — because neither of these two checks is
|
|
63
|
+
// performed by a party the server has any reason to trust.
|
|
64
|
+
//
|
|
65
|
+
// -----------------------------------------------------------------------------
|
|
66
|
+
// PROVENANCE IS BEST-EFFORT AND NEVER FAILS THE BACKUP
|
|
67
|
+
// -----------------------------------------------------------------------------
|
|
68
|
+
//
|
|
69
|
+
// `pgDumpVersion`, `dbVersion` and `migrationName` are read with `--version`
|
|
70
|
+
// and two `psql` queries, each with a short timeout, each returning `null` on
|
|
71
|
+
// any failure at all. `psql` is a DEGRADABLE capability in
|
|
72
|
+
// `capabilities.ts` for exactly this reason: without it the node still takes a
|
|
73
|
+
// perfectly good backup and reports two nulls. An unreadable version string
|
|
74
|
+
// must never be the reason a database is not backed up — the same rule
|
|
75
|
+
// `pg-version.util.ts` states on the server.
|
|
76
|
+
// =============================================================================
|
|
77
|
+
const execFileAsync = promisify(execFile);
|
|
78
|
+
/** How long a provenance probe may take before it is abandoned as `null`. */
|
|
79
|
+
export const PROVENANCE_TIMEOUT_MS = 10_000;
|
|
80
|
+
/** What the archive is uploaded as. Matches the server's `BACKUP_CONTENT_TYPE`. */
|
|
81
|
+
export const BACKUP_CONTENT_TYPE = 'application/octet-stream';
|
|
82
|
+
export class DatabaseBackupRunExecutor {
|
|
83
|
+
options;
|
|
84
|
+
type = 'db.backup.run';
|
|
85
|
+
/**
|
|
86
|
+
* ⚠ FALSE, AND THE ONE THING NOT TO "FIX". Every other node-eligible type so
|
|
87
|
+
* far reads an input object the server resolves for it; this one's input is
|
|
88
|
+
* the DATABASE, reached through a credential it fetches itself. Setting this
|
|
89
|
+
* true would make the engine ask for a download URL for a job that has no
|
|
90
|
+
* input object, and the request would fail with a 422 before `pg_dump` ever
|
|
91
|
+
* ran.
|
|
92
|
+
*/
|
|
93
|
+
requiresInput = false;
|
|
94
|
+
constructor(options = {}) {
|
|
95
|
+
this.options = options;
|
|
96
|
+
}
|
|
97
|
+
async execute(context) {
|
|
98
|
+
const { job, nodeId, api, claimToken } = context;
|
|
99
|
+
// -------------------------------------------------------------------------
|
|
100
|
+
// 1. The credential. ONE LOCAL CONST — see the file header.
|
|
101
|
+
// -------------------------------------------------------------------------
|
|
102
|
+
// `claimToken` on both held-job calls below (#364): a credential and a
|
|
103
|
+
// signed PUT are the two most consequential things a stale slot could ask
|
|
104
|
+
// for, and quoting the claim is what makes the server refuse them once
|
|
105
|
+
// this slot's claim has been superseded.
|
|
106
|
+
const secret = await api.jobSecret(nodeId, job.id, claimToken);
|
|
107
|
+
const connection = readPgMaterial(secret.material);
|
|
108
|
+
// -------------------------------------------------------------------------
|
|
109
|
+
// 2. Where to write. THE SERVER CHOOSES THE KEY, always: this asks for it
|
|
110
|
+
// and reports it back verbatim in the result, and the server refuses a
|
|
111
|
+
// result naming anything else.
|
|
112
|
+
// -------------------------------------------------------------------------
|
|
113
|
+
const target = await api.uploadUrl(nodeId, job.id, BACKUP_CONTENT_TYPE, claimToken);
|
|
114
|
+
if (typeof target.url !== 'string' || target.url.length === 0) {
|
|
115
|
+
throw new Error(`The server returned no upload URL for job ${job.id}; nothing was dumped.`);
|
|
116
|
+
}
|
|
117
|
+
const startedAt = new Date().toISOString();
|
|
118
|
+
// Read BEFORE the dump, deliberately: the credential is alive now, the
|
|
119
|
+
// probes are cheap, and doing them afterwards would run them against a
|
|
120
|
+
// role that may have just been revoked by the job settling.
|
|
121
|
+
const pgDumpVersion = await this.readClientVersion();
|
|
122
|
+
const dbVersion = await this.probeValue(['-c', 'SELECT version()'], connection);
|
|
123
|
+
const migrationName = await this.probeValue([
|
|
124
|
+
'-c',
|
|
125
|
+
'SELECT migration_name FROM _prisma_migrations ' +
|
|
126
|
+
'WHERE finished_at IS NOT NULL ORDER BY finished_at DESC LIMIT 1',
|
|
127
|
+
], connection);
|
|
128
|
+
// -------------------------------------------------------------------------
|
|
129
|
+
// 3. Dump → hash/meter → PUT, as one stream.
|
|
130
|
+
// -------------------------------------------------------------------------
|
|
131
|
+
const dump = spawnPgDump({
|
|
132
|
+
connection,
|
|
133
|
+
...(this.options.spawnFn !== undefined ? { spawnFn: this.options.spawnFn } : {}),
|
|
134
|
+
...(this.options.pgDumpCommand !== undefined ? { command: this.options.pgDumpCommand } : {}),
|
|
135
|
+
});
|
|
136
|
+
const hash = createHash('sha256');
|
|
137
|
+
let bytes = 0n;
|
|
138
|
+
const meter = new Transform({
|
|
139
|
+
transform(chunk, _encoding, callback) {
|
|
140
|
+
hash.update(chunk);
|
|
141
|
+
bytes += BigInt(chunk.length);
|
|
142
|
+
// Forwarded UNCHANGED and NOT retained: a tap, not a buffer.
|
|
143
|
+
callback(null, chunk);
|
|
144
|
+
},
|
|
145
|
+
});
|
|
146
|
+
// ⚠ NO-OP `error` LISTENERS, AND THEY ARE NOT DECORATION. A Node stream
|
|
147
|
+
// that emits `error` with nothing listening throws it as an UNCAUGHT
|
|
148
|
+
// EXCEPTION and takes the worker down — taking every other job on this
|
|
149
|
+
// node with it. Both of these are destroyed on purpose below (a dead dump,
|
|
150
|
+
// an aborted job), at a moment when the upload may already have stopped
|
|
151
|
+
// reading. The error is not lost: it travels to the caller through the
|
|
152
|
+
// `Promise.all`.
|
|
153
|
+
meter.on('error', () => undefined);
|
|
154
|
+
dump.stdout.on('error', () => undefined);
|
|
155
|
+
// Cooperative cancellation: a drain or a lost lease must stop a
|
|
156
|
+
// multi-hour dump rather than finish work nobody will accept. The abort
|
|
157
|
+
// tears down the child AND the pipe, so the upload fails too.
|
|
158
|
+
const onAbort = () => {
|
|
159
|
+
dump.kill();
|
|
160
|
+
meter.destroy(new Error(`Backup of job ${job.id} was aborted`));
|
|
161
|
+
};
|
|
162
|
+
context.signal.addEventListener('abort', onAbort, { once: true });
|
|
163
|
+
// ⚠ AND THE FLAG IS RE-READ, because a listener added AFTER the event has
|
|
164
|
+
// already fired is never called. The engine aborts on drain and on lease
|
|
165
|
+
// loss, and both can land while the credential fetch and the two
|
|
166
|
+
// provenance probes above are in flight — a window of seconds, on the one
|
|
167
|
+
// job type that then reads an entire database for nobody. Same defence
|
|
168
|
+
// `db-backup-runner.service.ts` states for a cancel that arrives during
|
|
169
|
+
// its version check.
|
|
170
|
+
if (context.signal.aborted)
|
|
171
|
+
onAbort();
|
|
172
|
+
// A DEAD DUMP MUST TEAR THE UPLOAD DOWN, or the PUT sits waiting on a
|
|
173
|
+
// stream that will never end. `.catch()` returns a NEW promise, so
|
|
174
|
+
// `dump.done` still rejects into the `Promise.all` below.
|
|
175
|
+
dump.done.catch((error) => {
|
|
176
|
+
meter.destroy(error instanceof Error ? error : new Error(String(error)));
|
|
177
|
+
});
|
|
178
|
+
dump.stdout.pipe(meter);
|
|
179
|
+
const fetchImpl = this.options.fetchImpl ?? globalThis.fetch;
|
|
180
|
+
const putArchive = async () => {
|
|
181
|
+
const response = await fetchImpl(target.url, {
|
|
182
|
+
method: 'PUT',
|
|
183
|
+
headers: { 'content-type': BACKUP_CONTENT_TYPE },
|
|
184
|
+
// Cast: `RequestInit.body` does not name Node's `Readable`, which
|
|
185
|
+
// undici accepts natively. `duplex` is likewise not in the DOM lib and
|
|
186
|
+
// is REQUIRED for a streaming body.
|
|
187
|
+
body: meter,
|
|
188
|
+
duplex: 'half',
|
|
189
|
+
});
|
|
190
|
+
if (!response.ok) {
|
|
191
|
+
throw new Error(`Uploading the backup for job ${job.id} failed with HTTP ${response.status}.`);
|
|
192
|
+
}
|
|
193
|
+
};
|
|
194
|
+
// Timed as the relayed `job.upload` phase (#608) when the engine offers
|
|
195
|
+
// it. The byte count is read when the PUT completes, by which point the
|
|
196
|
+
// meter has seen the whole archive; past 2^53 it is omitted rather than
|
|
197
|
+
// rounded.
|
|
198
|
+
const upload = context.phase !== undefined
|
|
199
|
+
? context.phase('job.upload', putArchive, () => bytes <= BigInt(Number.MAX_SAFE_INTEGER) ? { bytes: Number(bytes) } : undefined)
|
|
200
|
+
: putArchive();
|
|
201
|
+
// ...AND A DEAD UPLOAD MUST TEAR THE DUMP DOWN, or `pg_dump` reads a whole
|
|
202
|
+
// database to produce an archive nobody is storing.
|
|
203
|
+
upload.catch(() => {
|
|
204
|
+
dump.kill();
|
|
205
|
+
});
|
|
206
|
+
try {
|
|
207
|
+
// BOTH HALVES. See the file header for why neither alone is evidence.
|
|
208
|
+
await Promise.all([upload, dump.done]);
|
|
209
|
+
}
|
|
210
|
+
finally {
|
|
211
|
+
context.signal.removeEventListener('abort', onAbort);
|
|
212
|
+
}
|
|
213
|
+
const result = {
|
|
214
|
+
// Reported back, never chosen: the server refuses a key it did not hand
|
|
215
|
+
// out, which is what stops a node pointing a restore at other bytes.
|
|
216
|
+
storageKey: target.key,
|
|
217
|
+
// ⚠ A DECIMAL STRING. A dump past 2 GiB is ordinary and a JSON number
|
|
218
|
+
// stops being exact above 2^53, so the corruption would land on exactly
|
|
219
|
+
// the largest backups. See the contract's header.
|
|
220
|
+
bytes: bytes.toString(),
|
|
221
|
+
sha256: hash.digest('hex'),
|
|
222
|
+
pgDumpVersion,
|
|
223
|
+
dbVersion,
|
|
224
|
+
migrationName,
|
|
225
|
+
startedAt,
|
|
226
|
+
finishedAt: new Date().toISOString(),
|
|
227
|
+
};
|
|
228
|
+
// ⚠ THE LOG LINE NAMES NOTHING FROM `secret`. Size, digest and key are the
|
|
229
|
+
// useful facts; the credential is not one of them.
|
|
230
|
+
context.log('database backup uploaded', {
|
|
231
|
+
jobId: job.id,
|
|
232
|
+
bytes: result.bytes,
|
|
233
|
+
sha256: result.sha256,
|
|
234
|
+
key: result.storageKey,
|
|
235
|
+
});
|
|
236
|
+
return result;
|
|
237
|
+
}
|
|
238
|
+
/** `pg_dump --version`, or `null`. Never throws — see the file header. */
|
|
239
|
+
async readClientVersion() {
|
|
240
|
+
if (this.options.readClientVersion !== undefined) {
|
|
241
|
+
return this.options.readClientVersion();
|
|
242
|
+
}
|
|
243
|
+
try {
|
|
244
|
+
const { stdout } = await execFileAsync(this.options.pgDumpCommand ?? PG_DUMP_COMMAND, ['--version'], {
|
|
245
|
+
timeout: PROVENANCE_TIMEOUT_MS,
|
|
246
|
+
});
|
|
247
|
+
return firstLine(stdout);
|
|
248
|
+
}
|
|
249
|
+
catch {
|
|
250
|
+
return null;
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
/**
|
|
254
|
+
* One `psql` scalar, or `null`.
|
|
255
|
+
*
|
|
256
|
+
* ⚠ THE QUERIES ARE CONSTANTS, NOT BUILT FROM ANYTHING. Nothing
|
|
257
|
+
* caller-supplied reaches SQL here: the connection travels as flags and the
|
|
258
|
+
* password as an environment variable, so there is no interpolation to get
|
|
259
|
+
* wrong. `-X` skips `~/.psqlrc` (a worker node is a machine somebody has
|
|
260
|
+
* used by hand), `-A -t` give a bare value with no alignment or header.
|
|
261
|
+
*/
|
|
262
|
+
async probeValue(args, connection) {
|
|
263
|
+
if (this.options.probe !== undefined) {
|
|
264
|
+
return this.options.probe(args, connection);
|
|
265
|
+
}
|
|
266
|
+
try {
|
|
267
|
+
const { stdout } = await execFileAsync(this.options.psqlCommand ?? PSQL_COMMAND, [
|
|
268
|
+
'--host',
|
|
269
|
+
connection.host,
|
|
270
|
+
'--port',
|
|
271
|
+
connection.port,
|
|
272
|
+
'--username',
|
|
273
|
+
connection.user,
|
|
274
|
+
'--dbname',
|
|
275
|
+
connection.database,
|
|
276
|
+
'--no-password',
|
|
277
|
+
'-X',
|
|
278
|
+
'-A',
|
|
279
|
+
'-t',
|
|
280
|
+
...args,
|
|
281
|
+
], {
|
|
282
|
+
timeout: PROVENANCE_TIMEOUT_MS,
|
|
283
|
+
env: pgProbeEnv(connection),
|
|
284
|
+
});
|
|
285
|
+
return firstLine(stdout);
|
|
286
|
+
}
|
|
287
|
+
catch {
|
|
288
|
+
// A missing `psql`, a permission denied on `_prisma_migrations`, a
|
|
289
|
+
// timeout: all of them mean "this fact was not readable", which is a
|
|
290
|
+
// `null` column and never a failed backup.
|
|
291
|
+
return null;
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
}
|
|
295
|
+
/**
|
|
296
|
+
* Narrows the broker's opaque `material` into a connection, or throws.
|
|
297
|
+
*
|
|
298
|
+
* ⚠ VALIDATED RATHER THAN CAST, and the failure is a NAMED error. `material`
|
|
299
|
+
* is `Record<string, unknown>` by contract — the API passes it through without
|
|
300
|
+
* interpreting it — so a broker change, a version skew, or a fork's own
|
|
301
|
+
* `postgres`-kind broker returning a DSN would otherwise surface as
|
|
302
|
+
* `undefined` inside an argv and a `pg_dump` that connects to the wrong place
|
|
303
|
+
* (or to localhost) with an unhelpful error.
|
|
304
|
+
*
|
|
305
|
+
* ⚠ THE ERROR MESSAGE NAMES THE MISSING FIELDS AND NOTHING ELSE. It must never
|
|
306
|
+
* include the material itself: this string becomes `Job.lastError` on the
|
|
307
|
+
* server and a line in this node's log.
|
|
308
|
+
*/
|
|
309
|
+
export function readPgMaterial(material) {
|
|
310
|
+
const read = (key) => {
|
|
311
|
+
const value = material[key];
|
|
312
|
+
if (typeof value === 'string' && value.length > 0)
|
|
313
|
+
return value;
|
|
314
|
+
if (typeof value === 'number' && Number.isFinite(value))
|
|
315
|
+
return String(value);
|
|
316
|
+
return undefined;
|
|
317
|
+
};
|
|
318
|
+
const host = read('host');
|
|
319
|
+
const port = read('port');
|
|
320
|
+
const user = read('user');
|
|
321
|
+
const password = read('password');
|
|
322
|
+
const database = read('database');
|
|
323
|
+
const missing = Object.entries({ host, port, user, password, database })
|
|
324
|
+
.filter(([, value]) => value === undefined)
|
|
325
|
+
.map(([key]) => key);
|
|
326
|
+
if (missing.length > 0) {
|
|
327
|
+
throw new Error(`The credential this server issued is missing: ${missing.join(', ')}. This node cannot ` +
|
|
328
|
+
'build a PostgreSQL connection from it; nothing was dumped.');
|
|
329
|
+
}
|
|
330
|
+
const sslMode = read('sslMode');
|
|
331
|
+
return {
|
|
332
|
+
host: host,
|
|
333
|
+
port: port,
|
|
334
|
+
user: user,
|
|
335
|
+
password: password,
|
|
336
|
+
database: database,
|
|
337
|
+
sslMode: sslMode ?? null,
|
|
338
|
+
};
|
|
339
|
+
}
|
|
340
|
+
/**
|
|
341
|
+
* The provenance probe's environment.
|
|
342
|
+
*
|
|
343
|
+
* The same rule as the dump's — see `pgClientEnv` in `pg-dump.ts` — and it is
|
|
344
|
+
* built here rather than imported wholesale because `execFile`'s `env` also
|
|
345
|
+
* replaces the child's environment entirely.
|
|
346
|
+
*/
|
|
347
|
+
function pgProbeEnv(connection) {
|
|
348
|
+
const env = { ...process.env };
|
|
349
|
+
delete env.PGSERVICE;
|
|
350
|
+
delete env.PGSERVICEFILE;
|
|
351
|
+
delete env.PGPASSFILE;
|
|
352
|
+
env.PGPASSWORD = connection.password;
|
|
353
|
+
if (connection.sslMode !== null)
|
|
354
|
+
env.PGSSLMODE = connection.sslMode;
|
|
355
|
+
return env;
|
|
356
|
+
}
|
|
357
|
+
/** First non-empty line, trimmed and bounded — the columns are 128/255 wide. */
|
|
358
|
+
function firstLine(value) {
|
|
359
|
+
const line = value.split('\n').map((entry) => entry.trim()).find((entry) => entry.length > 0);
|
|
360
|
+
return line === undefined ? null : line.slice(0, 128);
|
|
361
|
+
}
|
|
362
|
+
//# sourceMappingURL=db-backup-run.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"db-backup-run.js","sourceRoot":"","sources":["../../../../src/engine/node/executors/db-backup-run.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { JobExecutionContext, JobExecutor } from './index.js';
|
|
2
|
+
/** Mirrors `ExampleChecksumResult` in `apps/api/src/jobs/contracts/`. */
|
|
3
|
+
export interface ExampleChecksumResult {
|
|
4
|
+
sha256: string;
|
|
5
|
+
bytes: number;
|
|
6
|
+
computedAt: string;
|
|
7
|
+
computedBy: 'node';
|
|
8
|
+
}
|
|
9
|
+
export declare class ExampleChecksumExecutor implements JobExecutor {
|
|
10
|
+
readonly type = "example.checksum";
|
|
11
|
+
/** The input IS the work. Without it there is nothing to hash. */
|
|
12
|
+
readonly requiresInput = true;
|
|
13
|
+
execute(context: JobExecutionContext): Promise<ExampleChecksumResult>;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Every executor this template ships. A fork appends to this list.
|
|
17
|
+
*
|
|
18
|
+
* ⚠ REGISTERED IS NOT THE SAME AS RUN. `db.backup.run` (#352) is here because
|
|
19
|
+
* this CLI knows HOW to take a database dump; whether it ever gets one is
|
|
20
|
+
* decided entirely by the server — the type is offered to a node only when the
|
|
21
|
+
* deployment has enabled both `nodes.jobSecretBrokerEnabled` and
|
|
22
|
+
* `databaseBackup.nodeOffloadEnabled` AND the credential broker reports itself
|
|
23
|
+
* usable. A node also declares the type only if `evaluateCapabilities` finds
|
|
24
|
+
* `pg_dump` on this machine. Listing the executor unconditionally is what lets
|
|
25
|
+
* all three of those decisions live where they belong.
|
|
26
|
+
*
|
|
27
|
+
* @stability experimental
|
|
28
|
+
*/
|
|
29
|
+
export declare function defaultExecutors(): JobExecutor[];
|
|
30
|
+
//# sourceMappingURL=example-checksum.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"example-checksum.d.ts","sourceRoot":"","sources":["../../../../src/engine/node/executors/example-checksum.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBnE,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,uBAAwB,YAAW,WAAW;IACzD,QAAQ,CAAC,IAAI,sBAAsB;IAEnC,kEAAkE;IAClE,QAAQ,CAAC,aAAa,QAAQ;IAExB,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAiC5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { createReadStream } from 'node:fs';
|
|
3
|
+
import { MissingJobInputError } from '../node-errors.js';
|
|
4
|
+
import { DatabaseBackupRunExecutor } from './db-backup-run.js';
|
|
5
|
+
export class ExampleChecksumExecutor {
|
|
6
|
+
type = 'example.checksum';
|
|
7
|
+
/** The input IS the work. Without it there is nothing to hash. */
|
|
8
|
+
requiresInput = true;
|
|
9
|
+
async execute(context) {
|
|
10
|
+
// Belt and braces: the engine already refuses a `requiresInput` job with
|
|
11
|
+
// no download URL. Asserting it here too means the executor is safe to
|
|
12
|
+
// call directly — which #279's TUI and a fork's own tests will do.
|
|
13
|
+
if (context.inputPath === undefined || context.inputPath.length === 0) {
|
|
14
|
+
throw new MissingJobInputError(context.job.id, this.type);
|
|
15
|
+
}
|
|
16
|
+
const hash = createHash('sha256');
|
|
17
|
+
let bytes = 0;
|
|
18
|
+
const stream = createReadStream(context.inputPath);
|
|
19
|
+
for await (const chunk of stream) {
|
|
20
|
+
const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
|
|
21
|
+
hash.update(buffer);
|
|
22
|
+
bytes += buffer.length;
|
|
23
|
+
// Cooperative cancellation: a drain or a lost lease should stop a
|
|
24
|
+
// multi-gigabyte hash rather than finishing work nobody will accept.
|
|
25
|
+
if (context.signal.aborted) {
|
|
26
|
+
stream.destroy();
|
|
27
|
+
throw new Error(`Checksum of job ${context.job.id} was aborted after ${bytes} bytes`);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
context.log('checksum computed', { jobId: context.job.id, bytes });
|
|
31
|
+
return {
|
|
32
|
+
sha256: hash.digest('hex'),
|
|
33
|
+
bytes,
|
|
34
|
+
computedAt: new Date().toISOString(),
|
|
35
|
+
computedBy: 'node',
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Every executor this template ships. A fork appends to this list.
|
|
41
|
+
*
|
|
42
|
+
* ⚠ REGISTERED IS NOT THE SAME AS RUN. `db.backup.run` (#352) is here because
|
|
43
|
+
* this CLI knows HOW to take a database dump; whether it ever gets one is
|
|
44
|
+
* decided entirely by the server — the type is offered to a node only when the
|
|
45
|
+
* deployment has enabled both `nodes.jobSecretBrokerEnabled` and
|
|
46
|
+
* `databaseBackup.nodeOffloadEnabled` AND the credential broker reports itself
|
|
47
|
+
* usable. A node also declares the type only if `evaluateCapabilities` finds
|
|
48
|
+
* `pg_dump` on this machine. Listing the executor unconditionally is what lets
|
|
49
|
+
* all three of those decisions live where they belong.
|
|
50
|
+
*
|
|
51
|
+
* @stability experimental
|
|
52
|
+
*/
|
|
53
|
+
export function defaultExecutors() {
|
|
54
|
+
return [new ExampleChecksumExecutor(), new DatabaseBackupRunExecutor()];
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=example-checksum.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"example-checksum.js","sourceRoot":"","sources":["../../../../src/engine/node/executors/example-checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AA2B/D,MAAM,OAAO,uBAAuB;IACzB,IAAI,GAAG,kBAAkB,CAAC;IAEnC,kEAAkE;IACzD,aAAa,GAAG,IAAI,CAAC;IAE9B,KAAK,CAAC,OAAO,CAAC,OAA4B;QACxC,yEAAyE;QACzE,uEAAuE;QACvE,mEAAmE;QACnE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;YAC7E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpB,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;YACvB,kEAAkE;YAClE,qEAAqE;YACrE,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,GAAG,CAAC,EAAE,sBAAsB,KAAK,QAAQ,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAEnE,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAC1B,KAAK;YACL,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,IAAI,uBAAuB,EAAE,EAAE,IAAI,yBAAyB,EAAE,CAAC,CAAC;AAC1E,CAAC"}
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
import type { ClaimToken, DownloadUrlResult, JobSecret, NodeJob, NodeSpanAttributes, NodeSpanName, UploadUrlResult } from '../node-api.js';
|
|
2
|
+
/**
|
|
3
|
+
* The part of the node API an executor may call, all of it for the job it
|
|
4
|
+
* holds. The engine passes its whole `NodeApi`; an executor is typed against
|
|
5
|
+
* this so it cannot settle, renew or claim behind the engine's back.
|
|
6
|
+
*
|
|
7
|
+
* @stability experimental
|
|
8
|
+
*/
|
|
9
|
+
export interface ExecutorNodeApi {
|
|
10
|
+
/**
|
|
11
|
+
* Mints this job's credential: job-scoped, bounded by the lease, held in
|
|
12
|
+
* memory for the job and never written or logged (CLAUDE.md queue rule 3).
|
|
13
|
+
*
|
|
14
|
+
* @param nodeId - `context.nodeId`.
|
|
15
|
+
* @param jobId - `context.job.id`.
|
|
16
|
+
* @param claimToken - `context.claimToken`, passed through unchanged.
|
|
17
|
+
*/
|
|
18
|
+
jobSecret(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<JobSecret>;
|
|
19
|
+
/**
|
|
20
|
+
* A presigned PUT for the job's output; the SERVER chooses the key.
|
|
21
|
+
*
|
|
22
|
+
* @param nodeId - `context.nodeId`.
|
|
23
|
+
* @param jobId - `context.job.id`.
|
|
24
|
+
* @param contentType - The upload's MIME type.
|
|
25
|
+
* @param claimToken - `context.claimToken`, passed through unchanged.
|
|
26
|
+
*/
|
|
27
|
+
uploadUrl(nodeId: string, jobId: string, contentType?: string, claimToken?: ClaimToken): Promise<UploadUrlResult>;
|
|
28
|
+
/**
|
|
29
|
+
* A presigned GET for the job's input object (the engine already streams it
|
|
30
|
+
* to `inputPath` when `requiresInput` is true).
|
|
31
|
+
*
|
|
32
|
+
* @param nodeId - `context.nodeId`.
|
|
33
|
+
* @param jobId - `context.job.id`.
|
|
34
|
+
* @param claimToken - `context.claimToken`, passed through unchanged.
|
|
35
|
+
*/
|
|
36
|
+
downloadUrl(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<DownloadUrlResult>;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Everything an executor is given. Nothing is reachable except through this.
|
|
40
|
+
*
|
|
41
|
+
* @stability experimental
|
|
42
|
+
*/
|
|
43
|
+
export interface JobExecutionContext {
|
|
44
|
+
/** The job row as the server leased it. */
|
|
45
|
+
job: NodeJob;
|
|
46
|
+
/** The handler's own parameters, straight from `Job.payload`. */
|
|
47
|
+
params: Record<string, unknown>;
|
|
48
|
+
/**
|
|
49
|
+
* Where the input object was streamed to, when `requiresInput` is true.
|
|
50
|
+
* Guaranteed non-empty for such a type: the engine refuses the job with a
|
|
51
|
+
* NAMED error rather than passing an empty path through.
|
|
52
|
+
*/
|
|
53
|
+
inputPath: string | undefined;
|
|
54
|
+
/** The input object's metadata, when there was one. */
|
|
55
|
+
input: {
|
|
56
|
+
/** The input object's id. */
|
|
57
|
+
objectId: string;
|
|
58
|
+
/** Its size in bytes, as a decimal string. */
|
|
59
|
+
size: string;
|
|
60
|
+
/** Its MIME type. */
|
|
61
|
+
mimeType: string;
|
|
62
|
+
} | undefined;
|
|
63
|
+
/** For a type that needs its credential or must upload its output. */
|
|
64
|
+
api: ExecutorNodeApi;
|
|
65
|
+
/** This node's id, for every `api` call. */
|
|
66
|
+
nodeId: string;
|
|
67
|
+
/**
|
|
68
|
+
* Which claim of this job the engine is executing (#364).
|
|
69
|
+
*
|
|
70
|
+
* Pass it to EVERY `api` call made against `job.id` — an upload target, a
|
|
71
|
+
* job credential — exactly as the engine passes it to the renewal ticker,
|
|
72
|
+
* the result and the failure. `nodeId` says which machine is calling;
|
|
73
|
+
* without this, a slot that stalled and was re-claimed is indistinguishable
|
|
74
|
+
* from the slot now running the job, and can mint a signed PUT or a database
|
|
75
|
+
* credential against a lease it no longer holds.
|
|
76
|
+
*
|
|
77
|
+
* `undefined` is ordinary, not a fault: an older control plane sends no
|
|
78
|
+
* token, and a row claimed before the column existed sends `null`. Pass the
|
|
79
|
+
* value through unchanged either way — `claimTokenBody` is what decides that
|
|
80
|
+
* the key is omitted rather than sent as `null`, and it is the only place
|
|
81
|
+
* that decision should be made.
|
|
82
|
+
*/
|
|
83
|
+
claimToken: ClaimToken;
|
|
84
|
+
/** Aborted on drain and on lease loss. Long work should honour it. */
|
|
85
|
+
signal: AbortSignal;
|
|
86
|
+
/** Structured logging that goes through the daemon's redaction (#275). */
|
|
87
|
+
log(message: string, fields?: Record<string, unknown>): void;
|
|
88
|
+
/**
|
|
89
|
+
* Times `work` as a relayed phase span (#608) — for a phase only the
|
|
90
|
+
* executor can see, such as an upload streamed from inside `execute`.
|
|
91
|
+
* Returns (or rethrows) exactly what `work` does; recording never fails the
|
|
92
|
+
* job. Optional so a hand-built test context need not supply it.
|
|
93
|
+
*/
|
|
94
|
+
phase?<T>(name: NodeSpanName, work: () => Promise<T>, attributes?: NodeSpanAttributes | ((result: T) => NodeSpanAttributes | undefined)): Promise<T>;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* One job type this machine can run.
|
|
98
|
+
*
|
|
99
|
+
* @stability experimental
|
|
100
|
+
*
|
|
101
|
+
* `execute` RETURNS the result and THROWS to fail — the same contract the
|
|
102
|
+
* server's handlers use, for the same reason: every provider error, missing
|
|
103
|
+
* file and truncated stream becomes a reported failure with the real message,
|
|
104
|
+
* and nobody has to remember to check a return code.
|
|
105
|
+
*
|
|
106
|
+
* Throw `ProviderRateLimitError` to route a throttle through the server's
|
|
107
|
+
* deferral path instead of burning an attempt.
|
|
108
|
+
*/
|
|
109
|
+
export interface JobExecutor {
|
|
110
|
+
/** The job type, as the server's handler declares it (permanent once jobs exist). */
|
|
111
|
+
readonly type: string;
|
|
112
|
+
/**
|
|
113
|
+
* Whether the engine should fetch a download URL and stream the input to a
|
|
114
|
+
* temp file before calling `execute`.
|
|
115
|
+
*
|
|
116
|
+
* Declared rather than inferred, so a type that needs an input and did not
|
|
117
|
+
* get one fails with a named error at the top of the job instead of an
|
|
118
|
+
* opaque filesystem error somewhere inside it.
|
|
119
|
+
*/
|
|
120
|
+
readonly requiresInput: boolean;
|
|
121
|
+
/**
|
|
122
|
+
* Runs the job: returns the result the server's `nodeResultSchema` expects,
|
|
123
|
+
* throws to fail it.
|
|
124
|
+
*
|
|
125
|
+
* @param context - The job, its params and the node API.
|
|
126
|
+
*/
|
|
127
|
+
execute(context: JobExecutionContext): Promise<unknown>;
|
|
128
|
+
/**
|
|
129
|
+
* App-defined numeric vitals this executor reports on every heartbeat, merged
|
|
130
|
+
* with the other executors' into the heartbeat's `vitals.extra` (the fleet
|
|
131
|
+
* page labels a key through `registerNodeVital`). Optional; read at heartbeat
|
|
132
|
+
* time, so it MUST be cheap, synchronous and must not spawn a process. At
|
|
133
|
+
* most 16 keys fleet-wide, each `^[a-z][a-z0-9_.]{1,47}$`, each a finite
|
|
134
|
+
* number: `sanitizeExtraVitals` drops the rest, and a throw here is swallowed.
|
|
135
|
+
*
|
|
136
|
+
* @returns a record of key to number, or `undefined` for none.
|
|
137
|
+
*/
|
|
138
|
+
vitals?(): Record<string, number> | undefined;
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
* A mutable registry. One instance per engine, so tests never share state.
|
|
142
|
+
*
|
|
143
|
+
* @stability experimental
|
|
144
|
+
*/
|
|
145
|
+
export declare class ExecutorRegistry {
|
|
146
|
+
private readonly executors;
|
|
147
|
+
/**
|
|
148
|
+
* Adds (or replaces) the executor for its type.
|
|
149
|
+
*
|
|
150
|
+
* @param executor - The executor.
|
|
151
|
+
* @returns This registry, for chaining.
|
|
152
|
+
*/
|
|
153
|
+
register(executor: JobExecutor): this;
|
|
154
|
+
/** Every registered executor, in type order. */
|
|
155
|
+
list(): JobExecutor[];
|
|
156
|
+
/** Every type this node can run. What `register`/`claim` advertise. */
|
|
157
|
+
types(): string[];
|
|
158
|
+
/**
|
|
159
|
+
* Whether this node can run `type`.
|
|
160
|
+
*
|
|
161
|
+
* @param type - A job type.
|
|
162
|
+
* @returns `true` when an executor is registered for it.
|
|
163
|
+
*/
|
|
164
|
+
has(type: string): boolean;
|
|
165
|
+
/** Throws `UnknownJobTypeError`, naming what this node CAN run. */
|
|
166
|
+
require(type: string): JobExecutor;
|
|
167
|
+
}
|
|
168
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/node/executors/index.ts"],"names":[],"mappings":"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"}
|