@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,391 @@
|
|
|
1
|
+
import type { NodeSpan } from '../../telemetry/index.js';
|
|
2
|
+
import { ApiClient } from '../api-client.js';
|
|
3
|
+
/** A node row as the server reports it. Mirrors `WorkerNodeDto`. */
|
|
4
|
+
export interface WorkerNode {
|
|
5
|
+
id: string;
|
|
6
|
+
name: string;
|
|
7
|
+
hostname: string;
|
|
8
|
+
platform: string;
|
|
9
|
+
cliVersion: string;
|
|
10
|
+
eligibleTypes: string[];
|
|
11
|
+
concurrency: number;
|
|
12
|
+
status: string;
|
|
13
|
+
capabilities: unknown;
|
|
14
|
+
registeredAt: string;
|
|
15
|
+
lastHeartbeatAt: string | null;
|
|
16
|
+
}
|
|
17
|
+
/** `POST /nodes/register`. */
|
|
18
|
+
export interface RegisterNodeRequest {
|
|
19
|
+
name: string;
|
|
20
|
+
hostname: string;
|
|
21
|
+
platform: string;
|
|
22
|
+
cliVersion: string;
|
|
23
|
+
eligibleTypes: string[];
|
|
24
|
+
concurrency: number;
|
|
25
|
+
capabilities?: Record<string, unknown> | undefined;
|
|
26
|
+
}
|
|
27
|
+
export interface RegisterNodeResult {
|
|
28
|
+
node: WorkerNode;
|
|
29
|
+
/**
|
|
30
|
+
* True when the server matched an existing `(owner, name)` row instead of
|
|
31
|
+
* creating one. Surfaced rather than smoothed over: "reattached" and
|
|
32
|
+
* "registered" are different facts, and an operator who expected a new node
|
|
33
|
+
* and got a reattach has a name collision to resolve.
|
|
34
|
+
*/
|
|
35
|
+
reattached: boolean;
|
|
36
|
+
}
|
|
37
|
+
/** One entry of `GET /nodes/job-types`. */
|
|
38
|
+
export interface NodeJobType {
|
|
39
|
+
type: string;
|
|
40
|
+
label: string;
|
|
41
|
+
/** JSON Schema (2020-12) generated from the server's own Zod, or `null`. */
|
|
42
|
+
resultSchema: Record<string, unknown> | null;
|
|
43
|
+
}
|
|
44
|
+
/** A job the server has leased to this node. Mirrors `NodeJobAssignmentDto`. */
|
|
45
|
+
/**
|
|
46
|
+
* The job row as the server leased it to this node.
|
|
47
|
+
*
|
|
48
|
+
* @stability experimental
|
|
49
|
+
*/
|
|
50
|
+
export interface NodeJob {
|
|
51
|
+
/** The job's id. */
|
|
52
|
+
id: string;
|
|
53
|
+
/** The job type, e.g. `db.backup.run`. */
|
|
54
|
+
type: string;
|
|
55
|
+
/** What the job is about (a model name), when it is about something. */
|
|
56
|
+
subjectType: string | null;
|
|
57
|
+
/** The id of what the job is about. */
|
|
58
|
+
subjectId: string | null;
|
|
59
|
+
/** Higher runs first. */
|
|
60
|
+
priority: number;
|
|
61
|
+
/** Attempts so far, this one included. */
|
|
62
|
+
attempts: number;
|
|
63
|
+
/** ISO 8601, when this attempt started. */
|
|
64
|
+
startedAt: string | null;
|
|
65
|
+
/** ISO 8601, when the lease this node holds runs out unless renewed. */
|
|
66
|
+
leaseExpiresAt: string | null;
|
|
67
|
+
}
|
|
68
|
+
export interface NodeJobAssignment {
|
|
69
|
+
job: NodeJob;
|
|
70
|
+
params: Record<string, unknown>;
|
|
71
|
+
/**
|
|
72
|
+
* How often the server wants this job's lease renewed, in milliseconds.
|
|
73
|
+
*
|
|
74
|
+
* OPTIONAL BECAUSE THE SERVER MIGHT BE OLDER THAN THIS CLI, not because it
|
|
75
|
+
* is advisory — when it is present it is strictly better than any local
|
|
76
|
+
* default, since it is derived from the very lease this job was granted.
|
|
77
|
+
* See `NodeEngine.processJob` for the fallback.
|
|
78
|
+
*/
|
|
79
|
+
renewIntervalMs?: number;
|
|
80
|
+
/**
|
|
81
|
+
* WHICH CLAIM OF THIS JOB THIS IS (#364) — quote it back on every call that
|
|
82
|
+
* speaks for a held job, and the server can tell this claim from a later one.
|
|
83
|
+
*
|
|
84
|
+
* `claimedByNodeId` distinguishes one node from another but NOT ONE NODE FROM
|
|
85
|
+
* ITSELF: a slot that stalls past its lease, is reaped, and then re-claims
|
|
86
|
+
* the same job in a second slot still satisfies every server-side condition
|
|
87
|
+
* the first slot's renewal ticker is checked against — so the stale slot
|
|
88
|
+
* renews, or settles, the run its own newer slot is executing. The token is
|
|
89
|
+
* minted per claimed ROW, so it is the one fact that tells the two apart.
|
|
90
|
+
*
|
|
91
|
+
* ⚠ OPTIONAL, AND `null`, ARE BOTH ORDINARY. A server older than #364 sends
|
|
92
|
+
* no such field, and a row claimed before the column existed sends `null`.
|
|
93
|
+
* Either way the node simply omits the key and gets exactly the behaviour it
|
|
94
|
+
* had before — see `claimTokenBody`, which is the ONLY correct way to put
|
|
95
|
+
* this value into a request body.
|
|
96
|
+
*/
|
|
97
|
+
claimToken?: string | null;
|
|
98
|
+
/**
|
|
99
|
+
* The W3C `traceparent` of the span that ENQUEUED this job (#607), or `null`
|
|
100
|
+
* when nothing was traced at enqueue. Optional because a server older than
|
|
101
|
+
* #607 does not send it. The node does not read it: its phase spans are
|
|
102
|
+
* relayed to the server (#608), which parents them on the job's stored
|
|
103
|
+
* context itself. Correlation data only, never a credential.
|
|
104
|
+
*/
|
|
105
|
+
traceparent?: string | null;
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* A claim token as it arrives — present, `null`, or absent.
|
|
109
|
+
*
|
|
110
|
+
* Deliberately widened to include both empty cases so that the raw value off
|
|
111
|
+
* an assignment can be passed straight through without a call site ever having
|
|
112
|
+
* to normalise it (and getting that normalisation wrong). `claimTokenBody` is
|
|
113
|
+
* where the three states are resolved, once.
|
|
114
|
+
*
|
|
115
|
+
* @stability experimental
|
|
116
|
+
*/
|
|
117
|
+
export type ClaimToken = string | null | undefined;
|
|
118
|
+
/**
|
|
119
|
+
* The body fragment asserting a claim: `{ claimToken }`, or nothing at all.
|
|
120
|
+
*
|
|
121
|
+
* ⚠ THE KEY IS OMITTED, NEVER SPELLED AS `null` — which is why this is a
|
|
122
|
+
* function rather than an inline spread repeated at six call sites. The server
|
|
123
|
+
* reads THREE distinct states off this one key (#364), and they are not
|
|
124
|
+
* interchangeable:
|
|
125
|
+
*
|
|
126
|
+
* - absent → "I am not asserting a claim". The server drops the
|
|
127
|
+
* `claim_token` clause and identifies this node exactly as it did before.
|
|
128
|
+
* - a uuid → "I assert this exact claim".
|
|
129
|
+
* - `null` → "I assert this row carries NO token", which matches
|
|
130
|
+
* `claim_token IS NULL` — a real and different state, and the wrong
|
|
131
|
+
* assertion for a node that simply was not told one.
|
|
132
|
+
*
|
|
133
|
+
* `ApiClient` serialises bodies with `JSON.stringify`, which DROPS a key whose
|
|
134
|
+
* value is `undefined` but faithfully writes one whose value is `null`. So a
|
|
135
|
+
* `{ claimToken: null }` built by hand would reach the wire as the third
|
|
136
|
+
* statement above and be refused with a 400 — the server's schema is
|
|
137
|
+
* `.optional()` without `.nullable()`, on purpose, so that the mistake is loud
|
|
138
|
+
* rather than silently reinterpreted.
|
|
139
|
+
*
|
|
140
|
+
* An empty result is a STEADY STATE, not a degraded one: it is precisely the
|
|
141
|
+
* request every node made before #364, and it is what an older control plane
|
|
142
|
+
* and a pre-#361 row both legitimately produce.
|
|
143
|
+
*/
|
|
144
|
+
export declare function claimTokenBody(claimToken: ClaimToken): {
|
|
145
|
+
claimToken?: string;
|
|
146
|
+
};
|
|
147
|
+
/**
|
|
148
|
+
* Cumulative counters since this worker process started (#605). Mirrors the
|
|
149
|
+
* server's `nodeVitalsCountersSchema`, which is `.strict()`: a key not listed
|
|
150
|
+
* here is a 400 for the WHOLE heartbeat, so never add one on this side first.
|
|
151
|
+
*/
|
|
152
|
+
export interface NodeVitalsCounters {
|
|
153
|
+
claims?: number | undefined;
|
|
154
|
+
emptyPolls?: number | undefined;
|
|
155
|
+
claimFailures?: number | undefined;
|
|
156
|
+
succeeded?: number | undefined;
|
|
157
|
+
failed?: number | undefined;
|
|
158
|
+
rateLimited?: number | undefined;
|
|
159
|
+
leaseRenewals?: number | undefined;
|
|
160
|
+
leaseRenewFailures?: number | undefined;
|
|
161
|
+
heartbeatFailures?: number | undefined;
|
|
162
|
+
watchdogTrips?: number | undefined;
|
|
163
|
+
}
|
|
164
|
+
/**
|
|
165
|
+
* A health snapshot carried on the heartbeat (#604, #605). Mirrors the server's
|
|
166
|
+
* `nodeVitalsSchema` — also `.strict()`, and every value bounded. The CLI
|
|
167
|
+
* clamps or omits out-of-range values before they get here (`node-vitals.ts`);
|
|
168
|
+
* see that module for the bounds.
|
|
169
|
+
*/
|
|
170
|
+
export interface NodeVitals {
|
|
171
|
+
cpuPercent?: number | undefined;
|
|
172
|
+
rssBytes?: number | undefined;
|
|
173
|
+
heapUsedBytes?: number | undefined;
|
|
174
|
+
heapLimitBytes?: number | undefined;
|
|
175
|
+
eventLoopDelayP99Ms?: number | undefined;
|
|
176
|
+
stateDirFreeBytes?: number | undefined;
|
|
177
|
+
stateDirTotalBytes?: number | undefined;
|
|
178
|
+
slotsUsed?: number | undefined;
|
|
179
|
+
slotsTotal?: number | undefined;
|
|
180
|
+
uptimeSeconds?: number | undefined;
|
|
181
|
+
counters?: NodeVitalsCounters | undefined;
|
|
182
|
+
cliVersion?: string | undefined;
|
|
183
|
+
nodeVersion?: string | undefined;
|
|
184
|
+
pgDumpVersion?: string | undefined;
|
|
185
|
+
/**
|
|
186
|
+
* App-defined numeric vitals: at most 16 `key -> number` pairs, keys shaped
|
|
187
|
+
* `^[a-z][a-z0-9_.]{1,47}$`. Filled from the executors' `vitals()` and
|
|
188
|
+
* sanitized by `sanitizeExtraVitals` before they get here.
|
|
189
|
+
*/
|
|
190
|
+
extra?: Record<string, number> | undefined;
|
|
191
|
+
}
|
|
192
|
+
export interface HeartbeatRequest {
|
|
193
|
+
status?: 'online' | 'offline' | undefined;
|
|
194
|
+
concurrency?: number | undefined;
|
|
195
|
+
capabilities?: Record<string, unknown> | undefined;
|
|
196
|
+
/**
|
|
197
|
+
* OPTIONAL, AND DROPPED FOR GOOD AFTER ONE 400 — an older control plane may
|
|
198
|
+
* refuse a key it does not know. See `NodeEngine.beat`.
|
|
199
|
+
*/
|
|
200
|
+
vitals?: NodeVitals | undefined;
|
|
201
|
+
}
|
|
202
|
+
export interface ClaimRequest {
|
|
203
|
+
types?: string[] | undefined;
|
|
204
|
+
limit?: number | undefined;
|
|
205
|
+
}
|
|
206
|
+
/**
|
|
207
|
+
* A presigned GET for a job's input object.
|
|
208
|
+
*
|
|
209
|
+
* @stability experimental
|
|
210
|
+
*/
|
|
211
|
+
export interface DownloadUrlResult {
|
|
212
|
+
/** The presigned URL. A bearer capability: never log it. */
|
|
213
|
+
url: string;
|
|
214
|
+
/** Seconds the URL is valid for. */
|
|
215
|
+
expiresIn: number;
|
|
216
|
+
/** ISO 8601, when the URL stops working. */
|
|
217
|
+
expiresAt: string;
|
|
218
|
+
/** The input object's id. */
|
|
219
|
+
objectId: string;
|
|
220
|
+
/** A decimal STRING: the column is 64-bit and JSON has no such number. */
|
|
221
|
+
size: string;
|
|
222
|
+
/** The object's MIME type. */
|
|
223
|
+
mimeType: string;
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
* A presigned PUT for a job's output.
|
|
227
|
+
*
|
|
228
|
+
* @stability experimental
|
|
229
|
+
*/
|
|
230
|
+
export interface UploadUrlResult {
|
|
231
|
+
/** The presigned URL. A bearer capability: never log it. */
|
|
232
|
+
url: string;
|
|
233
|
+
/** The storage key the SERVER chose. A node cannot pick this. */
|
|
234
|
+
key: string;
|
|
235
|
+
/** Seconds the URL is valid for. */
|
|
236
|
+
expiresIn: number;
|
|
237
|
+
/** ISO 8601, when the URL stops working. */
|
|
238
|
+
expiresAt: string;
|
|
239
|
+
}
|
|
240
|
+
/**
|
|
241
|
+
* `POST /nodes/:id/jobs/:jobId/secret` — the ONE credential a job may need.
|
|
242
|
+
*
|
|
243
|
+
* ⚠ EVERY FIELD OF `material` IS A SECRET UNTIL PROVEN OTHERWISE, and this
|
|
244
|
+
* type is deliberately not narrowed into a `PgConnection`-shaped thing here:
|
|
245
|
+
* the shape is the BROKER's business (a DSN, a token and an endpoint, a
|
|
246
|
+
* discrete host/user/password set) and the executor that asked for it is the
|
|
247
|
+
* only thing entitled to interpret it. What every caller must obey is the rule
|
|
248
|
+
* `node-job-secret.dto.ts` states on the server side and `logger.ts` enforces
|
|
249
|
+
* on this one: hold it in a local for the life of the job, never write it to
|
|
250
|
+
* the config file or the state directory, never log it, and never hand it to
|
|
251
|
+
* a child process that outlives the job.
|
|
252
|
+
*
|
|
253
|
+
* @stability experimental
|
|
254
|
+
*/
|
|
255
|
+
export interface JobSecret {
|
|
256
|
+
/** e.g. `postgres.readonly` — which broker minted this, so a client knows how to read `material`. */
|
|
257
|
+
kind: string;
|
|
258
|
+
/** ISO 8601. Bounded by this job's LEASE; there is no second clock. */
|
|
259
|
+
expiresAt: string;
|
|
260
|
+
/** The credential itself. Passed through by the API without interpretation. */
|
|
261
|
+
material: Record<string, unknown>;
|
|
262
|
+
}
|
|
263
|
+
export interface JobSettlement {
|
|
264
|
+
jobId: string;
|
|
265
|
+
outcome: string;
|
|
266
|
+
willRetry: boolean;
|
|
267
|
+
}
|
|
268
|
+
export interface JobFailureReport {
|
|
269
|
+
error: string;
|
|
270
|
+
/** Set ONLY for a genuine provider throttle — see `node-engine.ts` (#274). */
|
|
271
|
+
rateLimited?: boolean | undefined;
|
|
272
|
+
retryAfterMs?: number | undefined;
|
|
273
|
+
willRetry?: boolean | undefined;
|
|
274
|
+
}
|
|
275
|
+
export type { NodeSpan, NodeSpanAttributes, NodeSpanName } from '../../telemetry/index.js';
|
|
276
|
+
export interface NodeTelemetryResult {
|
|
277
|
+
accepted: number;
|
|
278
|
+
dropped: number;
|
|
279
|
+
}
|
|
280
|
+
/** A minted `nod_` credential. The `token` is returned exactly once. */
|
|
281
|
+
export interface CreatedNodeCredential {
|
|
282
|
+
token: string;
|
|
283
|
+
id: string;
|
|
284
|
+
name: string;
|
|
285
|
+
tokenPrefix: string;
|
|
286
|
+
expiresAt: string | null;
|
|
287
|
+
createdAt: string;
|
|
288
|
+
}
|
|
289
|
+
/**
|
|
290
|
+
* Everything a worker does over HTTP.
|
|
291
|
+
*
|
|
292
|
+
* Deliberately NOT `ApiClient` itself. A fake implementing this interface is
|
|
293
|
+
* five lines; a fake `ApiClient` is a fetch stub plus an envelope, per test.
|
|
294
|
+
*/
|
|
295
|
+
export interface NodeApi {
|
|
296
|
+
register(body: RegisterNodeRequest): Promise<RegisterNodeResult>;
|
|
297
|
+
jobTypes(): Promise<NodeJobType[]>;
|
|
298
|
+
listNodes(): Promise<WorkerNode[]>;
|
|
299
|
+
getNode(nodeId: string): Promise<WorkerNode>;
|
|
300
|
+
deregister(nodeId: string): Promise<void>;
|
|
301
|
+
heartbeat(nodeId: string, body: HeartbeatRequest): Promise<WorkerNode>;
|
|
302
|
+
claim(nodeId: string, body: ClaimRequest): Promise<NodeJobAssignment[]>;
|
|
303
|
+
/**
|
|
304
|
+
* Every method below speaks FOR A HELD JOB, and every one of them takes the
|
|
305
|
+
* assignment's `claimToken` as a trailing optional argument (#364).
|
|
306
|
+
*
|
|
307
|
+
* Trailing and optional rather than folded into the existing bodies because
|
|
308
|
+
* the token is not part of what any of these calls is ASKING for — it is the
|
|
309
|
+
* caller identifying itself, the same fact at all six, and one uniform
|
|
310
|
+
* argument keeps "renew quotes the token but failure forgets to" from being
|
|
311
|
+
* a shape this interface can express. Pass the value straight off the
|
|
312
|
+
* assignment: `ClaimToken` admits `null` and `undefined` so that no call site
|
|
313
|
+
* has to normalise, and `claimTokenBody` resolves all three states in one
|
|
314
|
+
* place.
|
|
315
|
+
*/
|
|
316
|
+
renewLease(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<{
|
|
317
|
+
jobId: string;
|
|
318
|
+
leaseExpiresAt: string;
|
|
319
|
+
}>;
|
|
320
|
+
downloadUrl(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<DownloadUrlResult>;
|
|
321
|
+
uploadUrl(nodeId: string, jobId: string, contentType?: string, claimToken?: ClaimToken): Promise<UploadUrlResult>;
|
|
322
|
+
/**
|
|
323
|
+
* Asks for this job's credential. Beyond the claim token the request body
|
|
324
|
+
* carries NOTHING — every other field of it would be a node choosing part of
|
|
325
|
+
* a credential's shape, and every one of those is the server's choice (see
|
|
326
|
+
* the server DTO's header). The token is the exception because it is not a
|
|
327
|
+
* request for anything; it is the answer to "which claim is asking", and a
|
|
328
|
+
* credential minted for a lease a stale slot no longer holds is the exact
|
|
329
|
+
* thing #364 exists to prevent.
|
|
330
|
+
*/
|
|
331
|
+
jobSecret(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<JobSecret>;
|
|
332
|
+
submitResult(nodeId: string, jobId: string, type: string, result: unknown, claimToken?: ClaimToken): Promise<JobSettlement>;
|
|
333
|
+
reportJobFailure(nodeId: string, jobId: string, body: JobFailureReport, claimToken?: ClaimToken): Promise<JobSettlement>;
|
|
334
|
+
/**
|
|
335
|
+
* Relays this node's job phase spans (#608). OPTIONAL on the interface so a
|
|
336
|
+
* hand-written test fake need not implement it; the engine treats its
|
|
337
|
+
* absence as "span relay off". Best-effort: see `NodeSpanRelay` in
|
|
338
|
+
* `@marinoscar/platform-cli/telemetry`.
|
|
339
|
+
*/
|
|
340
|
+
telemetry?(nodeId: string, body: {
|
|
341
|
+
spans: NodeSpan[];
|
|
342
|
+
}): Promise<NodeTelemetryResult>;
|
|
343
|
+
}
|
|
344
|
+
/** The `/api/node-credentials` half. Separate because a `nod_` token CANNOT reach it. */
|
|
345
|
+
export interface NodeCredentialApi {
|
|
346
|
+
createCredential(body: {
|
|
347
|
+
name: string;
|
|
348
|
+
expiresInDays?: number | undefined;
|
|
349
|
+
}): Promise<CreatedNodeCredential>;
|
|
350
|
+
}
|
|
351
|
+
/**
|
|
352
|
+
* The real implementation, over `ApiClient`.
|
|
353
|
+
*
|
|
354
|
+
* `timeoutMs` is a constructor option rather than a per-call argument because
|
|
355
|
+
* every route here is short: even `claim` returns immediately when the queue
|
|
356
|
+
* is empty (the server does not long-poll), so a request outliving the default
|
|
357
|
+
* is a stuck connection, not a slow answer.
|
|
358
|
+
*/
|
|
359
|
+
export declare class HttpNodeApi implements NodeApi, NodeCredentialApi {
|
|
360
|
+
private readonly client;
|
|
361
|
+
constructor(client: ApiClient);
|
|
362
|
+
/** Build one from a server URL a human typed plus a bearer token. */
|
|
363
|
+
static create(serverUrl: string, token: string, options?: {
|
|
364
|
+
timeoutMs?: number | undefined;
|
|
365
|
+
fetch?: typeof globalThis.fetch | undefined;
|
|
366
|
+
}): HttpNodeApi;
|
|
367
|
+
register(body: RegisterNodeRequest): Promise<RegisterNodeResult>;
|
|
368
|
+
jobTypes(): Promise<NodeJobType[]>;
|
|
369
|
+
listNodes(): Promise<WorkerNode[]>;
|
|
370
|
+
getNode(nodeId: string): Promise<WorkerNode>;
|
|
371
|
+
deregister(nodeId: string): Promise<void>;
|
|
372
|
+
heartbeat(nodeId: string, body: HeartbeatRequest): Promise<WorkerNode>;
|
|
373
|
+
claim(nodeId: string, body: ClaimRequest): Promise<NodeJobAssignment[]>;
|
|
374
|
+
renewLease(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<{
|
|
375
|
+
jobId: string;
|
|
376
|
+
leaseExpiresAt: string;
|
|
377
|
+
}>;
|
|
378
|
+
downloadUrl(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<DownloadUrlResult>;
|
|
379
|
+
uploadUrl(nodeId: string, jobId: string, contentType?: string, claimToken?: ClaimToken): Promise<UploadUrlResult>;
|
|
380
|
+
jobSecret(nodeId: string, jobId: string, claimToken?: ClaimToken): Promise<JobSecret>;
|
|
381
|
+
submitResult(nodeId: string, jobId: string, type: string, result: unknown, claimToken?: ClaimToken): Promise<JobSettlement>;
|
|
382
|
+
reportJobFailure(nodeId: string, jobId: string, body: JobFailureReport, claimToken?: ClaimToken): Promise<JobSettlement>;
|
|
383
|
+
telemetry(nodeId: string, body: {
|
|
384
|
+
spans: NodeSpan[];
|
|
385
|
+
}): Promise<NodeTelemetryResult>;
|
|
386
|
+
createCredential(body: {
|
|
387
|
+
name: string;
|
|
388
|
+
expiresInDays?: number | undefined;
|
|
389
|
+
}): Promise<CreatedNodeCredential>;
|
|
390
|
+
}
|
|
391
|
+
//# sourceMappingURL=node-api.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"node-api.d.ts","sourceRoot":"","sources":["../../../src/engine/node/node-api.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
import { ApiClient, resolveApiBaseUrl } from '../api-client.js';
|
|
2
|
+
/**
|
|
3
|
+
* The body fragment asserting a claim: `{ claimToken }`, or nothing at all.
|
|
4
|
+
*
|
|
5
|
+
* ⚠ THE KEY IS OMITTED, NEVER SPELLED AS `null` — which is why this is a
|
|
6
|
+
* function rather than an inline spread repeated at six call sites. The server
|
|
7
|
+
* reads THREE distinct states off this one key (#364), and they are not
|
|
8
|
+
* interchangeable:
|
|
9
|
+
*
|
|
10
|
+
* - absent → "I am not asserting a claim". The server drops the
|
|
11
|
+
* `claim_token` clause and identifies this node exactly as it did before.
|
|
12
|
+
* - a uuid → "I assert this exact claim".
|
|
13
|
+
* - `null` → "I assert this row carries NO token", which matches
|
|
14
|
+
* `claim_token IS NULL` — a real and different state, and the wrong
|
|
15
|
+
* assertion for a node that simply was not told one.
|
|
16
|
+
*
|
|
17
|
+
* `ApiClient` serialises bodies with `JSON.stringify`, which DROPS a key whose
|
|
18
|
+
* value is `undefined` but faithfully writes one whose value is `null`. So a
|
|
19
|
+
* `{ claimToken: null }` built by hand would reach the wire as the third
|
|
20
|
+
* statement above and be refused with a 400 — the server's schema is
|
|
21
|
+
* `.optional()` without `.nullable()`, on purpose, so that the mistake is loud
|
|
22
|
+
* rather than silently reinterpreted.
|
|
23
|
+
*
|
|
24
|
+
* An empty result is a STEADY STATE, not a degraded one: it is precisely the
|
|
25
|
+
* request every node made before #364, and it is what an older control plane
|
|
26
|
+
* and a pre-#361 row both legitimately produce.
|
|
27
|
+
*/
|
|
28
|
+
export function claimTokenBody(claimToken) {
|
|
29
|
+
return typeof claimToken === 'string' && claimToken.length > 0 ? { claimToken } : {};
|
|
30
|
+
}
|
|
31
|
+
/** URL-encodes an id so a hand-set `NODE_ID` cannot smuggle a path segment. */
|
|
32
|
+
function seg(value) {
|
|
33
|
+
return encodeURIComponent(value);
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* The real implementation, over `ApiClient`.
|
|
37
|
+
*
|
|
38
|
+
* `timeoutMs` is a constructor option rather than a per-call argument because
|
|
39
|
+
* every route here is short: even `claim` returns immediately when the queue
|
|
40
|
+
* is empty (the server does not long-poll), so a request outliving the default
|
|
41
|
+
* is a stuck connection, not a slow answer.
|
|
42
|
+
*/
|
|
43
|
+
export class HttpNodeApi {
|
|
44
|
+
client;
|
|
45
|
+
constructor(client) {
|
|
46
|
+
this.client = client;
|
|
47
|
+
}
|
|
48
|
+
/** Build one from a server URL a human typed plus a bearer token. */
|
|
49
|
+
static create(serverUrl, token, options) {
|
|
50
|
+
return new HttpNodeApi(new ApiClient({
|
|
51
|
+
baseUrl: resolveApiBaseUrl(serverUrl),
|
|
52
|
+
token,
|
|
53
|
+
...(options?.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {}),
|
|
54
|
+
...(options?.fetch !== undefined ? { fetch: options.fetch } : {}),
|
|
55
|
+
}));
|
|
56
|
+
}
|
|
57
|
+
register(body) {
|
|
58
|
+
return this.client.post('/nodes/register', body);
|
|
59
|
+
}
|
|
60
|
+
async jobTypes() {
|
|
61
|
+
const response = await this.client.get('/nodes/job-types');
|
|
62
|
+
return response.types ?? [];
|
|
63
|
+
}
|
|
64
|
+
listNodes() {
|
|
65
|
+
return this.client.get('/nodes');
|
|
66
|
+
}
|
|
67
|
+
getNode(nodeId) {
|
|
68
|
+
return this.client.get(`/nodes/${seg(nodeId)}`);
|
|
69
|
+
}
|
|
70
|
+
async deregister(nodeId) {
|
|
71
|
+
await this.client.post(`/nodes/${seg(nodeId)}/deregister`);
|
|
72
|
+
}
|
|
73
|
+
heartbeat(nodeId, body) {
|
|
74
|
+
return this.client.post(`/nodes/${seg(nodeId)}/heartbeat`, body);
|
|
75
|
+
}
|
|
76
|
+
async claim(nodeId, body) {
|
|
77
|
+
const response = await this.client.post(`/nodes/${seg(nodeId)}/claim`, body);
|
|
78
|
+
return response.jobs ?? [];
|
|
79
|
+
}
|
|
80
|
+
renewLease(nodeId, jobId, claimToken) {
|
|
81
|
+
// An empty object, not no body at all, when there is no token to quote:
|
|
82
|
+
// the server's `renewLeaseSchema` carries a `.default({})` precisely so a
|
|
83
|
+
// body-less POST from an older node stays legal, and `{}` is the same
|
|
84
|
+
// request with a `Content-Type` the parser is happier about.
|
|
85
|
+
return this.client.post(`/nodes/${seg(nodeId)}/jobs/${seg(jobId)}/renew`, claimTokenBody(claimToken));
|
|
86
|
+
}
|
|
87
|
+
downloadUrl(nodeId, jobId, claimToken) {
|
|
88
|
+
return this.client.post(`/nodes/${seg(nodeId)}/jobs/${seg(jobId)}/download-url`, claimTokenBody(claimToken));
|
|
89
|
+
}
|
|
90
|
+
uploadUrl(nodeId, jobId, contentType, claimToken) {
|
|
91
|
+
return this.client.post(`/nodes/${seg(nodeId)}/jobs/${seg(jobId)}/upload-url`, {
|
|
92
|
+
...(contentType === undefined ? {} : { contentType }),
|
|
93
|
+
...claimTokenBody(claimToken),
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
jobSecret(nodeId, jobId, claimToken) {
|
|
97
|
+
// POST with an all-but-empty body, not GET: what comes back is a
|
|
98
|
+
// credential, and a GET's URL is what every proxy log, CDN key and APM span
|
|
99
|
+
// label writes down. The server answers `Cache-Control: no-store` for the
|
|
100
|
+
// same reason. The claim token is the only field this body may carry.
|
|
101
|
+
return this.client.post(`/nodes/${seg(nodeId)}/jobs/${seg(jobId)}/secret`, claimTokenBody(claimToken));
|
|
102
|
+
}
|
|
103
|
+
submitResult(nodeId, jobId, type, result, claimToken) {
|
|
104
|
+
return this.client.post(`/nodes/${seg(nodeId)}/jobs/${seg(jobId)}/result`, {
|
|
105
|
+
type,
|
|
106
|
+
result,
|
|
107
|
+
...claimTokenBody(claimToken),
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
reportJobFailure(nodeId, jobId, body, claimToken) {
|
|
111
|
+
return this.client.post(`/nodes/${seg(nodeId)}/jobs/${seg(jobId)}/failure`, {
|
|
112
|
+
...body,
|
|
113
|
+
...claimTokenBody(claimToken),
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
telemetry(nodeId, body) {
|
|
117
|
+
return this.client.post(`/nodes/${seg(nodeId)}/telemetry`, body);
|
|
118
|
+
}
|
|
119
|
+
createCredential(body) {
|
|
120
|
+
return this.client.post('/node-credentials', body);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
//# sourceMappingURL=node-api.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"node-api.js","sourceRoot":"","sources":["../../../src/engine/node/node-api.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { type ConfigSource } from '../config.js';
|
|
2
|
+
import { type NodePathsContext } from './paths.js';
|
|
3
|
+
/** The server's own cap — `MAX_NODE_CONCURRENCY` in `node-control-plane.dto.ts`. */
|
|
4
|
+
export declare const MAX_NODE_CONCURRENCY = 64;
|
|
5
|
+
/** The floor. Zero is not "paused", it is a node that registers and never works. */
|
|
6
|
+
export declare const MIN_NODE_CONCURRENCY = 1;
|
|
7
|
+
/** Default idle poll interval. Fast enough to feel live, slow enough to be free. */
|
|
8
|
+
export declare const DEFAULT_POLL_INTERVAL_MS = 5000;
|
|
9
|
+
/** Floor on the poll interval, so a typo cannot turn a worker into a load test. */
|
|
10
|
+
export declare const MIN_POLL_INTERVAL_MS = 250;
|
|
11
|
+
/** Ceiling — beyond this a node looks wedged rather than idle. */
|
|
12
|
+
export declare const MAX_POLL_INTERVAL_MS = 300000;
|
|
13
|
+
/**
|
|
14
|
+
* Default concurrency when nothing says otherwise.
|
|
15
|
+
*
|
|
16
|
+
* Deliberately conservative here; #277 replaces the DEFAULT with a core- and
|
|
17
|
+
* RAM-aware value by passing `defaultConcurrency` into `resolveNodeConfig`.
|
|
18
|
+
* The seam is the parameter, so that change touches no call site that does not
|
|
19
|
+
* want it.
|
|
20
|
+
*/
|
|
21
|
+
export declare const DEFAULT_NODE_CONCURRENCY = 1;
|
|
22
|
+
/** The fully-defaulted worker settings. Nothing here is optional. */
|
|
23
|
+
export interface NodeConfig {
|
|
24
|
+
name: string;
|
|
25
|
+
concurrency: number;
|
|
26
|
+
/** Empty means "everything the server says I may claim". */
|
|
27
|
+
eligibleTypes: string[];
|
|
28
|
+
pollIntervalMs: number;
|
|
29
|
+
}
|
|
30
|
+
/** Everything `node start` needs, with the environment already applied. */
|
|
31
|
+
export interface ResolvedNodeConfig {
|
|
32
|
+
serverUrl: string;
|
|
33
|
+
token: string;
|
|
34
|
+
serverUrlSource: ConfigSource;
|
|
35
|
+
tokenSource: ConfigSource;
|
|
36
|
+
/** `undefined` until `node register` has run (or `NODE_ID` is set). */
|
|
37
|
+
nodeId: string | undefined;
|
|
38
|
+
node: NodeConfig;
|
|
39
|
+
/** Drain on SIGTERM WITHOUT deregistering — the container/service mode. */
|
|
40
|
+
headless: boolean;
|
|
41
|
+
/** Absolute path of the worker's state directory. */
|
|
42
|
+
stateDir: string;
|
|
43
|
+
/** True when no config file existed and this was built from the environment. */
|
|
44
|
+
synthesised: boolean;
|
|
45
|
+
}
|
|
46
|
+
export interface ResolveNodeConfigOptions extends NodePathsContext {
|
|
47
|
+
/** Overrides `DEFAULT_NODE_CONCURRENCY`; #277 passes a RAM-aware value. */
|
|
48
|
+
defaultConcurrency?: number | undefined;
|
|
49
|
+
/**
|
|
50
|
+
* The server's advertised node-eligible types, when the caller has fetched
|
|
51
|
+
* them. Supplied by `node register` (#273); omitted at start-up, where the
|
|
52
|
+
* cost of a round trip before reading config is not worth paying.
|
|
53
|
+
*/
|
|
54
|
+
knownTypes?: readonly string[] | undefined;
|
|
55
|
+
/** Where a degraded write reports itself. Defaults to stderr. */
|
|
56
|
+
warn?: ((message: string) => void) | undefined;
|
|
57
|
+
}
|
|
58
|
+
/** Default node name: the hostname, so the common case needs no flags. */
|
|
59
|
+
export declare function defaultNodeName(ctx?: NodePathsContext): string;
|
|
60
|
+
/**
|
|
61
|
+
* Parse `--types`/`ELIGIBLE_TYPES`: a comma-separated list, trimmed, deduped,
|
|
62
|
+
* order preserved.
|
|
63
|
+
*
|
|
64
|
+
* Empty entries are dropped rather than rejected, because `a,b,` is a trailing
|
|
65
|
+
* comma somebody typed, not a request to claim a type called "".
|
|
66
|
+
*/
|
|
67
|
+
export declare function parseEligibleTypes(raw: string | undefined): string[];
|
|
68
|
+
/**
|
|
69
|
+
* Refuse an eligible type the server has never heard of, NAMING the valid set.
|
|
70
|
+
*
|
|
71
|
+
* Only enforced when the caller actually knows the valid set. Start-up does
|
|
72
|
+
* not — `node start` must work while the API is briefly unreachable, and the
|
|
73
|
+
* server re-checks every claim against its own registry anyway, so the
|
|
74
|
+
* client-side check is a usability guard rather than a security one.
|
|
75
|
+
*/
|
|
76
|
+
export declare function assertKnownTypes(types: readonly string[], knownTypes: readonly string[]): void;
|
|
77
|
+
/** Bounds-check concurrency with the server's own limits, named in the message. */
|
|
78
|
+
export declare function assertConcurrency(value: number): number;
|
|
79
|
+
/** `true`/`1`/`yes`/`on`, case-insensitively. Anything else is false. */
|
|
80
|
+
export declare function envFlag(raw: string | undefined): boolean;
|
|
81
|
+
/**
|
|
82
|
+
* The one resolver every node command calls.
|
|
83
|
+
*
|
|
84
|
+
* Credentials come from `requireCredentials()` — reused, never reimplemented —
|
|
85
|
+
* so a half-set environment produces the message that already names the
|
|
86
|
+
* missing variable, rather than a second, differently-worded version of it.
|
|
87
|
+
*/
|
|
88
|
+
export declare function resolveNodeConfig(options?: ResolveNodeConfigOptions): ResolvedNodeConfig;
|
|
89
|
+
/**
|
|
90
|
+
* Merge a patch into the stored config's node block and write it back.
|
|
91
|
+
*
|
|
92
|
+
* READ-MERGE-WRITE, because `writeConfigFile` replaces the file wholesale:
|
|
93
|
+
* writing `{ node }` alone would delete the user's token. The merge is
|
|
94
|
+
* shallow over two levels, which is all this shape has.
|
|
95
|
+
*
|
|
96
|
+
* `degradeOnFailure` is the env-only-mode contract from the header: the caller
|
|
97
|
+
* that synthesised its config from the environment passes `true`, so a
|
|
98
|
+
* read-only home directory warns and keeps working.
|
|
99
|
+
*/
|
|
100
|
+
export declare function saveNodeConfig(patch: {
|
|
101
|
+
nodeId?: string | undefined;
|
|
102
|
+
node?: Partial<NodeConfig> | undefined;
|
|
103
|
+
}, options?: ResolveNodeConfigOptions & {
|
|
104
|
+
degradeOnFailure?: boolean | undefined;
|
|
105
|
+
}): string | undefined;
|
|
106
|
+
/**
|
|
107
|
+
* Persist a freshly-minted `nod_` credential, PRESERVING the node block.
|
|
108
|
+
*
|
|
109
|
+
* `saveCredentials()` in config.ts replaces the whole file, which is right for
|
|
110
|
+
* `login` (it is establishing a new session) and wrong here: `node enroll` on
|
|
111
|
+
* a machine that has already registered would silently drop its `nodeId` and
|
|
112
|
+
* leak a second node row on the next start.
|
|
113
|
+
*
|
|
114
|
+
* ⚠ THE EXPIRY IS CLEARED, NOT CARRIED OVER. A node credential normally never
|
|
115
|
+
* expires (`expiresAt: null` — see the epic's locked decisions), and leaving a
|
|
116
|
+
* previous PAT's `expiresAt` in place would make `config` report a perfectly
|
|
117
|
+
* valid credential as expired, and `status` refuse to use it. Passing `null`
|
|
118
|
+
* is therefore meaningfully different from passing `undefined`: it means "this
|
|
119
|
+
* one has no expiry", and both land as an ABSENT field rather than a stale one.
|
|
120
|
+
*/
|
|
121
|
+
export declare function saveNodeCredentials(input: {
|
|
122
|
+
serverUrl: string;
|
|
123
|
+
token: string;
|
|
124
|
+
expiresAt?: string | null | undefined;
|
|
125
|
+
tokenId?: string | undefined;
|
|
126
|
+
tokenName?: string | undefined;
|
|
127
|
+
}, options?: ResolveNodeConfigOptions): string;
|
|
128
|
+
//# sourceMappingURL=node-config.d.ts.map
|