@marinoscar/platform-cli 0.0.0-stage → 0.1.0-next.11
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 +157 -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 +1166 -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 +543 -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 +110 -0
- package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
- package/dist/engine/deploy/checks/registry.js +104 -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 +186 -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/compose-hints.d.ts +11 -0
- package/dist/engine/deploy/compose-hints.d.ts.map +1 -0
- package/dist/engine/deploy/compose-hints.js +70 -0
- package/dist/engine/deploy/compose-hints.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 +153 -0
- package/dist/engine/deploy/health.d.ts.map +1 -0
- package/dist/engine/deploy/health.js +335 -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 +1318 -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 +119 -0
- package/dist/engine/deploy/repo.d.ts.map +1 -0
- package/dist/engine/deploy/repo.js +277 -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 +289 -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 +321 -0
- package/dist/engine/deploy/uninstall.js.map +1 -0
- package/dist/engine/deploy/update.d.ts +112 -0
- package/dist/engine/deploy/update.d.ts.map +1 -0
- package/dist/engine/deploy/update.js +1280 -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 +155 -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,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The env-spec fragment for the telemetry stack: the PostgreSQL monitor login,
|
|
3
|
+
* the OpenTelemetry exporter settings and the GreptimeDB store.
|
|
4
|
+
*
|
|
5
|
+
* Register it once with `registerEnvSpecFragment(telemetryEnvSpecFragment)`.
|
|
6
|
+
*
|
|
7
|
+
* @example
|
|
8
|
+
* ```ts
|
|
9
|
+
* registerEnvSpecFragment(telemetryEnvSpecFragment); // the reference CLI: platform-host/register.ts
|
|
10
|
+
* ```
|
|
11
|
+
*
|
|
12
|
+
* @extensionPoint option
|
|
13
|
+
* @stability experimental
|
|
14
|
+
*/
|
|
15
|
+
export const telemetryEnvSpecFragment = {
|
|
16
|
+
id: 'telemetry',
|
|
17
|
+
metadata: {
|
|
18
|
+
// The telemetry collector's PostgreSQL login (issue #598), a pg_monitor role
|
|
19
|
+
// that must already exist on the server - so never generated, only asked.
|
|
20
|
+
// Asked as a PAIR (both `essential`) because a password asked on its own
|
|
21
|
+
// would be paired with POSTGRES_USER, which it does not belong to. Blank is
|
|
22
|
+
// a real answer for both: telemetry.compose.yml then falls back to the
|
|
23
|
+
// API's own POSTGRES_USER / POSTGRES_PASSWORD, which works on any server
|
|
24
|
+
// without a new role. `allowBlank` is what keeps that blank from failing an
|
|
25
|
+
// unattended install, and from failing `deploy update` on a deployment
|
|
26
|
+
// written before these keys existed.
|
|
27
|
+
POSTGRES_MONITOR_USER: { group: 'observability', essential: true, allowBlank: true },
|
|
28
|
+
POSTGRES_MONITOR_PASSWORD: {
|
|
29
|
+
group: 'observability',
|
|
30
|
+
essential: true,
|
|
31
|
+
secret: true,
|
|
32
|
+
allowBlank: true,
|
|
33
|
+
},
|
|
34
|
+
OTEL_ENABLED: { group: 'observability' },
|
|
35
|
+
OTEL_EXPORTER_OTLP_ENDPOINT: { group: 'observability' },
|
|
36
|
+
OTEL_SERVICE_NAME: { group: 'observability' },
|
|
37
|
+
// GreptimeDB telemetry store (telemetry.compose.yml). Three accounts with
|
|
38
|
+
// three privileges: the collector writes, the explorer / AI assistant / BI
|
|
39
|
+
// tools read, and only the retention (TTL) setting uses the admin account.
|
|
40
|
+
//
|
|
41
|
+
// The passwords are generated, never asked (#567), and as hex: they are
|
|
42
|
+
// embedded in GreptimeDB's `user=password,...` provider string, so `,`, `=`
|
|
43
|
+
// and `:` must never appear in them.
|
|
44
|
+
GREPTIME_HOST: { group: 'observability' },
|
|
45
|
+
GREPTIME_HTTP_PORT: { group: 'observability' },
|
|
46
|
+
GREPTIME_PG_PORT: { group: 'observability' },
|
|
47
|
+
// Loopback host port vps.telemetry.compose.yml publishes the PG protocol on.
|
|
48
|
+
GREPTIME_BIND_PG_PORT: { group: 'observability' },
|
|
49
|
+
GREPTIME_DB: { group: 'observability' },
|
|
50
|
+
GREPTIME_WRITER_USER: { group: 'observability' },
|
|
51
|
+
GREPTIME_WRITER_PASSWORD: {
|
|
52
|
+
group: 'observability',
|
|
53
|
+
secret: true,
|
|
54
|
+
generate: 'hex-32',
|
|
55
|
+
autoGenerate: true,
|
|
56
|
+
},
|
|
57
|
+
GREPTIME_READER_USER: { group: 'observability' },
|
|
58
|
+
GREPTIME_READER_PASSWORD: {
|
|
59
|
+
group: 'observability',
|
|
60
|
+
secret: true,
|
|
61
|
+
generate: 'hex-32',
|
|
62
|
+
autoGenerate: true,
|
|
63
|
+
},
|
|
64
|
+
GREPTIME_ADMIN_USER: { group: 'observability' },
|
|
65
|
+
GREPTIME_ADMIN_PASSWORD: {
|
|
66
|
+
group: 'observability',
|
|
67
|
+
secret: true,
|
|
68
|
+
generate: 'hex-32',
|
|
69
|
+
autoGenerate: true,
|
|
70
|
+
},
|
|
71
|
+
},
|
|
72
|
+
};
|
|
73
|
+
//# sourceMappingURL=env-fragment.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-fragment.js","sourceRoot":"","sources":["../../src/telemetry/env-fragment.ts"],"names":[],"mappings":"AA6CA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA6B;IAChE,EAAE,EAAE,WAAW;IACf,QAAQ,EAAE;QACR,6EAA6E;QAC7E,0EAA0E;QAC1E,yEAAyE;QACzE,4EAA4E;QAC5E,uEAAuE;QACvE,yEAAyE;QACzE,4EAA4E;QAC5E,uEAAuE;QACvE,qCAAqC;QACrC,qBAAqB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QACpF,yBAAyB,EAAE;YACzB,KAAK,EAAE,eAAe;YACtB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,IAAI;SACjB;QAED,YAAY,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACxC,2BAA2B,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACvD,iBAAiB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAE7C,0EAA0E;QAC1E,2EAA2E;QAC3E,2EAA2E;QAC3E,EAAE;QACF,wEAAwE;QACxE,4EAA4E;QAC5E,qCAAqC;QACrC,aAAa,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACzC,kBAAkB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAC9C,gBAAgB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAC5C,6EAA6E;QAC7E,qBAAqB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACjD,WAAW,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QACvC,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAChD,wBAAwB,EAAE;YACxB,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,IAAI;SACnB;QACD,oBAAoB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAChD,wBAAwB,EAAE;YACxB,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,IAAI;SACnB;QACD,mBAAmB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;QAC/C,uBAAuB,EAAE;YACvB,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,IAAI;SACnB;KACF;CACF,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export { DEFAULT_MAX_QUEUED_SPANS, JobSpanRecorder, MAX_SPANS_PER_BATCH, NodeSpanRelay, errorTypeOf, } from './node-span-relay.js';
|
|
2
|
+
export type { NodeSpanRelayOptions } from './node-span-relay.js';
|
|
3
|
+
export { NODE_APP_SPAN_NAME_PATTERN, isNodeSpanName } from './node-span.js';
|
|
4
|
+
export type { BuiltinNodeSpanName, NodeSpan, NodeSpanAttributes, NodeSpanName, NodeSpanSink } from './node-span.js';
|
|
5
|
+
export { telemetryEnvSpecFragment } from './env-fragment.js';
|
|
6
|
+
export type { TelemetryEnvGroup, TelemetryEnvSpecFragment, TelemetryEnvVarMetadata } from './env-fragment.js';
|
|
7
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpH,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
// `@marinoscar/platform-cli/telemetry`: the worker node's job-phase span relay
|
|
2
|
+
// and the telemetry stack's env-key metadata (PP-4.5, #706). #707 completes
|
|
3
|
+
// the slice.
|
|
4
|
+
export { DEFAULT_MAX_QUEUED_SPANS, JobSpanRecorder, MAX_SPANS_PER_BATCH, NodeSpanRelay, errorTypeOf, } from './node-span-relay.js';
|
|
5
|
+
export { NODE_APP_SPAN_NAME_PATTERN, isNodeSpanName } from './node-span.js';
|
|
6
|
+
export { telemetryEnvSpecFragment } from './env-fragment.js';
|
|
7
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,aAAa;AAEb,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC"}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import { type NodeSpan, type NodeSpanAttributes, type NodeSpanName, type NodeSpanSink } from './node-span.js';
|
|
2
|
+
/**
|
|
3
|
+
* Spans the server accepts per request. Mirrors `MAX_NODE_SPANS_PER_REQUEST`.
|
|
4
|
+
*
|
|
5
|
+
* @stability experimental
|
|
6
|
+
*/
|
|
7
|
+
export declare const MAX_SPANS_PER_BATCH = 50;
|
|
8
|
+
/**
|
|
9
|
+
* Spans held while waiting to send. Past this the OLDEST are dropped.
|
|
10
|
+
*
|
|
11
|
+
* @stability experimental
|
|
12
|
+
*/
|
|
13
|
+
export declare const DEFAULT_MAX_QUEUED_SPANS = 500;
|
|
14
|
+
/**
|
|
15
|
+
* An identifier-shaped error type for `error`: its class name, plus an HTTP
|
|
16
|
+
* status (`ApiError.409`) or a string `code` (`Error.ECONNRESET`). Never its
|
|
17
|
+
* message. Characters outside `[A-Za-z0-9_.-]` are replaced, and the result
|
|
18
|
+
* is capped at 64. Never throws.
|
|
19
|
+
*
|
|
20
|
+
* An error with a numeric `status` is an HTTP failure: the status wins over
|
|
21
|
+
* any `code` it also carries (the reference CLI's `ApiError` has both, and its
|
|
22
|
+
* `code` is the server's, not a system errno).
|
|
23
|
+
*
|
|
24
|
+
* @param error - Anything thrown.
|
|
25
|
+
* @returns An identifier such as `ApiError.409` or `Error.ECONNREFUSED`.
|
|
26
|
+
* @stability experimental
|
|
27
|
+
*/
|
|
28
|
+
export declare function errorTypeOf(error: unknown): string;
|
|
29
|
+
/**
|
|
30
|
+
* The spans of ONE job, recorded as it runs. Every method is synchronous and
|
|
31
|
+
* swallows its own faults: recording must never be the reason a job failed.
|
|
32
|
+
*
|
|
33
|
+
* @stability experimental
|
|
34
|
+
*/
|
|
35
|
+
export declare class JobSpanRecorder {
|
|
36
|
+
readonly jobId: string;
|
|
37
|
+
private readonly now;
|
|
38
|
+
private readonly spans;
|
|
39
|
+
/**
|
|
40
|
+
* @param jobId - The job every recorded span belongs to.
|
|
41
|
+
* @param now - The clock, Unix epoch milliseconds. Defaults to `Date.now`.
|
|
42
|
+
*/
|
|
43
|
+
constructor(jobId: string, now?: () => number);
|
|
44
|
+
/**
|
|
45
|
+
* Times `work` as phase `name`, recording `ok` or `error`, and returns (or
|
|
46
|
+
* rethrows) exactly what `work` did. `attributes` may be a function of the
|
|
47
|
+
* result, for a phase whose byte count is only known at the end.
|
|
48
|
+
*/
|
|
49
|
+
phase<T>(name: NodeSpanName, work: () => Promise<T>, attributes?: NodeSpanAttributes | ((result: T) => NodeSpanAttributes | undefined)): Promise<T>;
|
|
50
|
+
/** Records a phase that has already happened. Never throws. */
|
|
51
|
+
record(name: NodeSpanName, startTimeUnixMs: number, status: 'ok' | 'error', errorType?: string, attributes?: NodeSpanAttributes): void;
|
|
52
|
+
/** Everything recorded so far, in order. */
|
|
53
|
+
drain(): NodeSpan[];
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Options for {@link NodeSpanRelay}.
|
|
57
|
+
*
|
|
58
|
+
* @stability experimental
|
|
59
|
+
*/
|
|
60
|
+
export interface NodeSpanRelayOptions {
|
|
61
|
+
/** The app's API client, or anything with its optional `telemetry` method. */
|
|
62
|
+
api: NodeSpanSink;
|
|
63
|
+
/** The node the spans are relayed for. */
|
|
64
|
+
nodeId: string;
|
|
65
|
+
/** Spans held while waiting to send. Defaults to `DEFAULT_MAX_QUEUED_SPANS`. */
|
|
66
|
+
maxQueuedSpans?: number | undefined;
|
|
67
|
+
/** Called ONCE, when a 404 disables the relay for this process. */
|
|
68
|
+
onDisabled?: ((reason: string) => void) | undefined;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* The bounded, best-effort sender. One send in flight at a time; batches of at
|
|
72
|
+
* most `MAX_SPANS_PER_BATCH`; the oldest spans dropped when the queue is full.
|
|
73
|
+
*
|
|
74
|
+
* @example
|
|
75
|
+
* ```ts
|
|
76
|
+
* const relay = new NodeSpanRelay({ api: client, nodeId });
|
|
77
|
+
* const spans = new JobSpanRecorder(job.id);
|
|
78
|
+
* await spans.phase('job.execute', () => run(job));
|
|
79
|
+
* relay.enqueue(spans.drain()); // after the job settled; never awaited on its path
|
|
80
|
+
* ```
|
|
81
|
+
*
|
|
82
|
+
* @extensionPoint hook
|
|
83
|
+
* @stability experimental
|
|
84
|
+
*/
|
|
85
|
+
export declare class NodeSpanRelay {
|
|
86
|
+
private readonly api;
|
|
87
|
+
private readonly nodeId;
|
|
88
|
+
private readonly maxQueuedSpans;
|
|
89
|
+
private readonly onDisabled;
|
|
90
|
+
private readonly queue;
|
|
91
|
+
private pumping;
|
|
92
|
+
private disabled;
|
|
93
|
+
/** Spans discarded because the queue was full. For tests and diagnostics. */
|
|
94
|
+
droppedForCapacity: number;
|
|
95
|
+
/** @param options - The client, the node id and the queue bound. */
|
|
96
|
+
constructor(options: NodeSpanRelayOptions);
|
|
97
|
+
/** False once the relay is off: no `telemetry` method, or a 404 seen. */
|
|
98
|
+
get enabled(): boolean;
|
|
99
|
+
/** Spans waiting to be sent. */
|
|
100
|
+
get queued(): number;
|
|
101
|
+
/** Queues `spans` and starts sending if idle. Never throws, never awaits. */
|
|
102
|
+
enqueue(spans: NodeSpan[]): void;
|
|
103
|
+
/** Resolves once the queue is empty (or the relay disabled). Never rejects. */
|
|
104
|
+
flush(): Promise<void>;
|
|
105
|
+
private pump;
|
|
106
|
+
}
|
|
107
|
+
//# sourceMappingURL=node-span-relay.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"node-span-relay.d.ts","sourceRoot":"","sources":["../../src/telemetry/node-span-relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA+C9H;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAsB5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwBlD;AAmCD;;;;;GAKG;AACH,qBAAa,eAAe;IAQxB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IAExC;;;OAGG;gBAEQ,KAAK,EAAE,MAAM,EACL,GAAG,GAAE,MAAM,MAAiB;IAG/C;;;;OAIG;IACG,KAAK,CAAC,CAAC,EACX,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,UAAU,CAAC,EAAE,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,kBAAkB,GAAG,SAAS,CAAC,GAChF,OAAO,CAAC,CAAC,CAAC;IAmBb,+DAA+D;IAC/D,MAAM,CACJ,IAAI,EAAE,YAAY,EAClB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,IAAI,GAAG,OAAO,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,kBAAkB,GAC9B,IAAI;IAoBP,4CAA4C;IAC5C,KAAK,IAAI,QAAQ,EAAE;CAGpB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,GAAG,EAAE,YAAY,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAU;IAE1B,6EAA6E;IAC7E,kBAAkB,SAAK;IAEvB,oEAAoE;gBACxD,OAAO,EAAE,oBAAoB;IAUzC,yEAAyE;IACzE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,gCAAgC;IAChC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,6EAA6E;IAC7E,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAehC,+EAA+E;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,IAAI;CAsBnB"}
|
|
@@ -0,0 +1,314 @@
|
|
|
1
|
+
import { isNodeSpanName } from './node-span.js';
|
|
2
|
+
// =============================================================================
|
|
3
|
+
// Job phase spans, recorded here and relayed to the server (issue #608)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
// Moved from the reference CLI's `node/node-span-relay.ts` by PP-4.5 (#706).
|
|
6
|
+
// It reads an HTTP status STRUCTURALLY (a numeric `status` on the error), so it
|
|
7
|
+
// needs no app error class: the app's `ApiError` classifies exactly as before.
|
|
8
|
+
//
|
|
9
|
+
// A worker records WHEN each phase of a job ran (download, execute, upload,
|
|
10
|
+
// submit, secret) and hands those timings to `POST /api/nodes/:id/telemetry`.
|
|
11
|
+
// The server re-emits them as OpenTelemetry spans under the job's enqueuing
|
|
12
|
+
// trace. The node never talks to a collector, holds no exporter endpoint, and
|
|
13
|
+
// takes no new dependency: a span here is five numbers and a name.
|
|
14
|
+
//
|
|
15
|
+
// ⚠ TELEMETRY NEVER DELAYS OR FAILS A JOB. Recording is synchronous
|
|
16
|
+
// arithmetic that cannot throw into the job; SENDING happens after the job has
|
|
17
|
+
// settled, off the job's promise, through a bounded queue. Every failure of
|
|
18
|
+
// the relay is swallowed:
|
|
19
|
+
//
|
|
20
|
+
// - 404: the server predates the relay (or forgot this node). Span sending
|
|
21
|
+
// is DISABLED for the rest of the process and announced once — retrying a
|
|
22
|
+
// route that does not exist on every job would be a steady trickle of
|
|
23
|
+
// pointless requests.
|
|
24
|
+
// - 400 / 403 / 429 / anything else: this batch is dropped, silently. A 400
|
|
25
|
+
// is a contract mismatch no retry fixes; a 429 is the server asking for
|
|
26
|
+
// less, and resending is the opposite.
|
|
27
|
+
//
|
|
28
|
+
// ⚠ NO MESSAGE EVER LEAVES AS A SPAN. An errored phase carries `errorType` —
|
|
29
|
+
// the error's class name, plus an HTTP status or an errno-style code when
|
|
30
|
+
// there is one — sanitised to the server's identifier-only shape. Messages
|
|
31
|
+
// carry paths, hosts and signed URLs; the server would refuse them anyway,
|
|
32
|
+
// and this side does not offer.
|
|
33
|
+
//
|
|
34
|
+
// ⚠ BOUNDED, ALLOWLISTED ATTRIBUTES. `bytes`, `attempt`, `exitCode` and
|
|
35
|
+
// `httpStatus`, each range-checked, plus an executor's own attributes: a
|
|
36
|
+
// non-negative integer or a short TOKEN-SHAPED string under a key of the
|
|
37
|
+
// server's key shape, at most 16 in all (`cleanAttributes`). Anything else, and
|
|
38
|
+
// any value the server would refuse, is dropped before it is queued. A string
|
|
39
|
+
// cannot hold a space, slash, colon or quote, so no URL, path, message or
|
|
40
|
+
// credential rides along in one.
|
|
41
|
+
//
|
|
42
|
+
// ⚠ AN EXECUTOR'S SPAN NAME is `job.app.<name>` or it is dropped here
|
|
43
|
+
// (`isNodeSpanName`): a malformed name is never queued, so it cannot cost the
|
|
44
|
+
// rest of a batch even on an older server that refuses the whole body.
|
|
45
|
+
// =============================================================================
|
|
46
|
+
/**
|
|
47
|
+
* Spans the server accepts per request. Mirrors `MAX_NODE_SPANS_PER_REQUEST`.
|
|
48
|
+
*
|
|
49
|
+
* @stability experimental
|
|
50
|
+
*/
|
|
51
|
+
export const MAX_SPANS_PER_BATCH = 50;
|
|
52
|
+
/**
|
|
53
|
+
* Spans held while waiting to send. Past this the OLDEST are dropped.
|
|
54
|
+
*
|
|
55
|
+
* @stability experimental
|
|
56
|
+
*/
|
|
57
|
+
export const DEFAULT_MAX_QUEUED_SPANS = 500;
|
|
58
|
+
/** Mirrors the server's `NODE_SPAN_ERROR_TYPE_PATTERN` and length cap. */
|
|
59
|
+
const ERROR_TYPE_MAX_LENGTH = 64;
|
|
60
|
+
/** The server's `durationMs` ceiling (one day). */
|
|
61
|
+
const MAX_DURATION_MS = 24 * 60 * 60 * 1000;
|
|
62
|
+
/**
|
|
63
|
+
* The HTTP status an error carries, read structurally: a numeric `status`
|
|
64
|
+
* property, as the reference CLI's `ApiError` has. `undefined` otherwise.
|
|
65
|
+
*/
|
|
66
|
+
function httpStatusOf(error) {
|
|
67
|
+
if (typeof error !== 'object' || error === null)
|
|
68
|
+
return undefined;
|
|
69
|
+
const status = error.status;
|
|
70
|
+
return typeof status === 'number' ? status : undefined;
|
|
71
|
+
}
|
|
72
|
+
function errorClassName(error) {
|
|
73
|
+
return error.name && error.name !== 'Error' ? error.name : error.constructor?.name || 'Error';
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* An identifier-shaped error type for `error`: its class name, plus an HTTP
|
|
77
|
+
* status (`ApiError.409`) or a string `code` (`Error.ECONNRESET`). Never its
|
|
78
|
+
* message. Characters outside `[A-Za-z0-9_.-]` are replaced, and the result
|
|
79
|
+
* is capped at 64. Never throws.
|
|
80
|
+
*
|
|
81
|
+
* An error with a numeric `status` is an HTTP failure: the status wins over
|
|
82
|
+
* any `code` it also carries (the reference CLI's `ApiError` has both, and its
|
|
83
|
+
* `code` is the server's, not a system errno).
|
|
84
|
+
*
|
|
85
|
+
* @param error - Anything thrown.
|
|
86
|
+
* @returns An identifier such as `ApiError.409` or `Error.ECONNREFUSED`.
|
|
87
|
+
* @stability experimental
|
|
88
|
+
*/
|
|
89
|
+
export function errorTypeOf(error) {
|
|
90
|
+
try {
|
|
91
|
+
let name = 'Error';
|
|
92
|
+
let suffix;
|
|
93
|
+
if (error instanceof Error) {
|
|
94
|
+
name = errorClassName(error);
|
|
95
|
+
const status = httpStatusOf(error);
|
|
96
|
+
if (status !== undefined) {
|
|
97
|
+
suffix = String(status);
|
|
98
|
+
}
|
|
99
|
+
else {
|
|
100
|
+
const code = error.code;
|
|
101
|
+
if (typeof code === 'string' || typeof code === 'number')
|
|
102
|
+
suffix = String(code);
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
else {
|
|
106
|
+
name = typeof error;
|
|
107
|
+
}
|
|
108
|
+
const raw = suffix === undefined ? name : `${name}.${suffix}`;
|
|
109
|
+
const clean = raw.replace(/[^A-Za-z0-9_.-]/g, '_').slice(0, ERROR_TYPE_MAX_LENGTH);
|
|
110
|
+
return clean.length > 0 ? clean : 'Error';
|
|
111
|
+
}
|
|
112
|
+
catch {
|
|
113
|
+
return 'Error';
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
/** Mirrors the server's `NODE_SPAN_ATTRIBUTE_KEY_PATTERN`. */
|
|
117
|
+
const APP_ATTRIBUTE_KEY_PATTERN = /^[a-z][A-Za-z0-9]{1,31}$/;
|
|
118
|
+
/** Mirrors the server's `NODE_SPAN_ATTRIBUTE_STRING_PATTERN` and its 128-character ceiling. */
|
|
119
|
+
const APP_ATTRIBUTE_STRING_PATTERN = /^[A-Za-z0-9_.+-]{1,128}$/;
|
|
120
|
+
/** Mirrors the server's `MAX_NODE_SPAN_ATTRIBUTES`. */
|
|
121
|
+
const MAX_ATTRIBUTES = 16;
|
|
122
|
+
const BUILTIN_ATTRIBUTE_KEYS = ['bytes', 'attempt', 'exitCode', 'httpStatus'];
|
|
123
|
+
/**
|
|
124
|
+
* Keeps only what the server will take: the four built-in integers in range,
|
|
125
|
+
* and app attributes under a valid key as a non-negative safe integer or a
|
|
126
|
+
* token-shaped string, at most 16 in all. Never throws.
|
|
127
|
+
*/
|
|
128
|
+
function cleanAttributes(attributes) {
|
|
129
|
+
if (attributes === undefined || attributes === null || typeof attributes !== 'object')
|
|
130
|
+
return undefined;
|
|
131
|
+
const out = {};
|
|
132
|
+
const { bytes, attempt, exitCode, httpStatus } = attributes;
|
|
133
|
+
if (Number.isSafeInteger(bytes) && bytes >= 0)
|
|
134
|
+
out.bytes = bytes;
|
|
135
|
+
if (Number.isSafeInteger(attempt) && attempt >= 0 && attempt <= 10_000)
|
|
136
|
+
out.attempt = attempt;
|
|
137
|
+
if (Number.isSafeInteger(exitCode) && Math.abs(exitCode) <= 1024)
|
|
138
|
+
out.exitCode = exitCode;
|
|
139
|
+
if (Number.isSafeInteger(httpStatus) && httpStatus >= 100 && httpStatus <= 599)
|
|
140
|
+
out.httpStatus = httpStatus;
|
|
141
|
+
for (const key of Object.keys(attributes)) {
|
|
142
|
+
if (Object.keys(out).length >= MAX_ATTRIBUTES)
|
|
143
|
+
break;
|
|
144
|
+
if (BUILTIN_ATTRIBUTE_KEYS.includes(key) || !APP_ATTRIBUTE_KEY_PATTERN.test(key))
|
|
145
|
+
continue;
|
|
146
|
+
const value = attributes[key];
|
|
147
|
+
if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0)
|
|
148
|
+
out[key] = value;
|
|
149
|
+
else if (typeof value === 'string' && APP_ATTRIBUTE_STRING_PATTERN.test(value))
|
|
150
|
+
out[key] = value;
|
|
151
|
+
}
|
|
152
|
+
return Object.keys(out).length > 0 ? out : undefined;
|
|
153
|
+
}
|
|
154
|
+
/**
|
|
155
|
+
* The spans of ONE job, recorded as it runs. Every method is synchronous and
|
|
156
|
+
* swallows its own faults: recording must never be the reason a job failed.
|
|
157
|
+
*
|
|
158
|
+
* @stability experimental
|
|
159
|
+
*/
|
|
160
|
+
export class JobSpanRecorder {
|
|
161
|
+
jobId;
|
|
162
|
+
now;
|
|
163
|
+
spans = [];
|
|
164
|
+
/**
|
|
165
|
+
* @param jobId - The job every recorded span belongs to.
|
|
166
|
+
* @param now - The clock, Unix epoch milliseconds. Defaults to `Date.now`.
|
|
167
|
+
*/
|
|
168
|
+
constructor(jobId, now = Date.now) {
|
|
169
|
+
this.jobId = jobId;
|
|
170
|
+
this.now = now;
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Times `work` as phase `name`, recording `ok` or `error`, and returns (or
|
|
174
|
+
* rethrows) exactly what `work` did. `attributes` may be a function of the
|
|
175
|
+
* result, for a phase whose byte count is only known at the end.
|
|
176
|
+
*/
|
|
177
|
+
async phase(name, work, attributes) {
|
|
178
|
+
const start = this.now();
|
|
179
|
+
let result;
|
|
180
|
+
try {
|
|
181
|
+
result = await work();
|
|
182
|
+
}
|
|
183
|
+
catch (error) {
|
|
184
|
+
this.record(name, start, 'error', errorTypeOf(error), typeof attributes === 'function' ? undefined : attributes);
|
|
185
|
+
throw error;
|
|
186
|
+
}
|
|
187
|
+
let resolved;
|
|
188
|
+
try {
|
|
189
|
+
resolved = typeof attributes === 'function' ? attributes(result) : attributes;
|
|
190
|
+
}
|
|
191
|
+
catch {
|
|
192
|
+
resolved = undefined;
|
|
193
|
+
}
|
|
194
|
+
this.record(name, start, 'ok', undefined, resolved);
|
|
195
|
+
return result;
|
|
196
|
+
}
|
|
197
|
+
/** Records a phase that has already happened. Never throws. */
|
|
198
|
+
record(name, startTimeUnixMs, status, errorType, attributes) {
|
|
199
|
+
try {
|
|
200
|
+
// A name the server would not take is never queued (see the header).
|
|
201
|
+
if (!isNodeSpanName(name))
|
|
202
|
+
return;
|
|
203
|
+
const durationMs = Math.min(MAX_DURATION_MS, Math.max(0, Math.round(this.now() - startTimeUnixMs)));
|
|
204
|
+
const clean = cleanAttributes(attributes);
|
|
205
|
+
this.spans.push({
|
|
206
|
+
jobId: this.jobId,
|
|
207
|
+
name,
|
|
208
|
+
startTimeUnixMs: Math.round(startTimeUnixMs),
|
|
209
|
+
durationMs,
|
|
210
|
+
status,
|
|
211
|
+
...(status === 'error' && errorType !== undefined ? { errorType } : {}),
|
|
212
|
+
...(clean !== undefined ? { attributes: clean } : {}),
|
|
213
|
+
});
|
|
214
|
+
}
|
|
215
|
+
catch {
|
|
216
|
+
// Best-effort; see the header.
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
/** Everything recorded so far, in order. */
|
|
220
|
+
drain() {
|
|
221
|
+
return this.spans.splice(0, this.spans.length);
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
/**
|
|
225
|
+
* The bounded, best-effort sender. One send in flight at a time; batches of at
|
|
226
|
+
* most `MAX_SPANS_PER_BATCH`; the oldest spans dropped when the queue is full.
|
|
227
|
+
*
|
|
228
|
+
* @example
|
|
229
|
+
* ```ts
|
|
230
|
+
* const relay = new NodeSpanRelay({ api: client, nodeId });
|
|
231
|
+
* const spans = new JobSpanRecorder(job.id);
|
|
232
|
+
* await spans.phase('job.execute', () => run(job));
|
|
233
|
+
* relay.enqueue(spans.drain()); // after the job settled; never awaited on its path
|
|
234
|
+
* ```
|
|
235
|
+
*
|
|
236
|
+
* @extensionPoint hook
|
|
237
|
+
* @stability experimental
|
|
238
|
+
*/
|
|
239
|
+
export class NodeSpanRelay {
|
|
240
|
+
api;
|
|
241
|
+
nodeId;
|
|
242
|
+
maxQueuedSpans;
|
|
243
|
+
onDisabled;
|
|
244
|
+
queue = [];
|
|
245
|
+
pumping;
|
|
246
|
+
disabled;
|
|
247
|
+
/** Spans discarded because the queue was full. For tests and diagnostics. */
|
|
248
|
+
droppedForCapacity = 0;
|
|
249
|
+
/** @param options - The client, the node id and the queue bound. */
|
|
250
|
+
constructor(options) {
|
|
251
|
+
this.api = options.api;
|
|
252
|
+
this.nodeId = options.nodeId;
|
|
253
|
+
this.maxQueuedSpans = Math.max(1, options.maxQueuedSpans ?? DEFAULT_MAX_QUEUED_SPANS);
|
|
254
|
+
this.onDisabled = options.onDisabled;
|
|
255
|
+
// A client without the method (a test fake, an embedding that opted
|
|
256
|
+
// out) is simply a relay that is off.
|
|
257
|
+
this.disabled = typeof this.api.telemetry !== 'function';
|
|
258
|
+
}
|
|
259
|
+
/** False once the relay is off: no `telemetry` method, or a 404 seen. */
|
|
260
|
+
get enabled() {
|
|
261
|
+
return !this.disabled;
|
|
262
|
+
}
|
|
263
|
+
/** Spans waiting to be sent. */
|
|
264
|
+
get queued() {
|
|
265
|
+
return this.queue.length;
|
|
266
|
+
}
|
|
267
|
+
/** Queues `spans` and starts sending if idle. Never throws, never awaits. */
|
|
268
|
+
enqueue(spans) {
|
|
269
|
+
if (this.disabled || spans.length === 0)
|
|
270
|
+
return;
|
|
271
|
+
this.queue.push(...spans);
|
|
272
|
+
const overflow = this.queue.length - this.maxQueuedSpans;
|
|
273
|
+
if (overflow > 0) {
|
|
274
|
+
this.queue.splice(0, overflow);
|
|
275
|
+
this.droppedForCapacity += overflow;
|
|
276
|
+
}
|
|
277
|
+
if (this.pumping === undefined) {
|
|
278
|
+
this.pumping = this.pump().finally(() => {
|
|
279
|
+
this.pumping = undefined;
|
|
280
|
+
});
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
/** Resolves once the queue is empty (or the relay disabled). Never rejects. */
|
|
284
|
+
async flush() {
|
|
285
|
+
while (this.pumping !== undefined) {
|
|
286
|
+
await this.pumping;
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
async pump() {
|
|
290
|
+
while (!this.disabled && this.queue.length > 0) {
|
|
291
|
+
const batch = this.queue.splice(0, MAX_SPANS_PER_BATCH);
|
|
292
|
+
try {
|
|
293
|
+
await this.api.telemetry(this.nodeId, { spans: batch });
|
|
294
|
+
}
|
|
295
|
+
catch (error) {
|
|
296
|
+
const status = httpStatusOf(error);
|
|
297
|
+
if (status === 404) {
|
|
298
|
+
this.disabled = true;
|
|
299
|
+
this.queue.length = 0;
|
|
300
|
+
const serverMessage = error.serverMessage;
|
|
301
|
+
try {
|
|
302
|
+
this.onDisabled?.(`${status}: ${typeof serverMessage === 'string' ? serverMessage : 'Not Found'}`);
|
|
303
|
+
}
|
|
304
|
+
catch {
|
|
305
|
+
// An observer must not break the relay.
|
|
306
|
+
}
|
|
307
|
+
return;
|
|
308
|
+
}
|
|
309
|
+
// Any other failure: this batch is gone. See the header.
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
//# sourceMappingURL=node-span-relay.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"node-span-relay.js","sourceRoot":"","sources":["../../src/telemetry/node-span-relay.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The five phases a node always relays. Mirrors the server's
|
|
3
|
+
* `BUILTIN_NODE_SPAN_NAMES`.
|
|
4
|
+
*
|
|
5
|
+
* @stability experimental
|
|
6
|
+
*/
|
|
7
|
+
export type BuiltinNodeSpanName = 'job.download' | 'job.execute' | 'job.upload' | 'job.submit' | 'job.secret';
|
|
8
|
+
/**
|
|
9
|
+
* A span name a node may relay: one of the five phases, or an executor's own
|
|
10
|
+
* span under the fixed prefix `job.app.` (`job.app.transcode`). Mirrors the
|
|
11
|
+
* server's `nodeSpanNameSchema`: a name outside both shapes is dropped on this
|
|
12
|
+
* side (`isNodeSpanName`) before it is queued, and would be dropped (alone, not
|
|
13
|
+
* with its batch) on the server's.
|
|
14
|
+
*
|
|
15
|
+
* @stability experimental
|
|
16
|
+
*/
|
|
17
|
+
export type NodeSpanName = BuiltinNodeSpanName | `job.app.${string}`;
|
|
18
|
+
/**
|
|
19
|
+
* Mirrors the server's `NODE_APP_SPAN_NAME_PATTERN`: `job.app.` and then a
|
|
20
|
+
* lower-case name of 2 to 48 characters.
|
|
21
|
+
*
|
|
22
|
+
* @stability experimental
|
|
23
|
+
*/
|
|
24
|
+
export declare const NODE_APP_SPAN_NAME_PATTERN: RegExp;
|
|
25
|
+
/**
|
|
26
|
+
* Whether `name` is a span name the server takes: a built-in phase or
|
|
27
|
+
* `job.app.<name>`.
|
|
28
|
+
*
|
|
29
|
+
* @param name - a candidate span name.
|
|
30
|
+
* @returns true when it is relayable.
|
|
31
|
+
* @stability experimental
|
|
32
|
+
*/
|
|
33
|
+
export declare function isNodeSpanName(name: unknown): name is NodeSpanName;
|
|
34
|
+
/**
|
|
35
|
+
* Allowlisted span attributes. Mirrors the server's `nodeSpanAttributesSchema`:
|
|
36
|
+
* the four built-in integers, plus APP attributes under keys shaped
|
|
37
|
+
* `^[a-z][A-Za-z0-9]{1,31}$`, each a non-negative integer or a short
|
|
38
|
+
* TOKEN-SHAPED string (letters, digits and `_ . + -`, at most 128: no space,
|
|
39
|
+
* slash, colon or quote, so no URL, path or credential rides along). At most 16
|
|
40
|
+
* keys. The server emits only the app attributes its deployment registered
|
|
41
|
+
* (`registerNodeSpanAttribute`) and drops the rest, so sending one it does not
|
|
42
|
+
* know costs nothing but the bytes.
|
|
43
|
+
*
|
|
44
|
+
* @stability experimental
|
|
45
|
+
*/
|
|
46
|
+
export interface NodeSpanAttributes {
|
|
47
|
+
/** Bytes moved by the phase. Non-negative. */
|
|
48
|
+
bytes?: number | undefined;
|
|
49
|
+
/** The job's attempt number. 0 to 10,000. */
|
|
50
|
+
attempt?: number | undefined;
|
|
51
|
+
/** A child process's exit code. -1024 to 1024. */
|
|
52
|
+
exitCode?: number | undefined;
|
|
53
|
+
/** The HTTP status of the phase's request. 100 to 599. */
|
|
54
|
+
httpStatus?: number | undefined;
|
|
55
|
+
/** An app attribute: a non-negative integer or a token-shaped string. */
|
|
56
|
+
[appKey: string]: number | string | undefined;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* One phase of one job, as `POST /nodes/:id/telemetry` takes it.
|
|
60
|
+
*
|
|
61
|
+
* @stability experimental
|
|
62
|
+
*/
|
|
63
|
+
export interface NodeSpan {
|
|
64
|
+
/** The job the phase belongs to. */
|
|
65
|
+
jobId: string;
|
|
66
|
+
/** Which phase. */
|
|
67
|
+
name: NodeSpanName;
|
|
68
|
+
/** When the phase started, Unix epoch milliseconds. */
|
|
69
|
+
startTimeUnixMs: number;
|
|
70
|
+
/** How long it ran, milliseconds, capped at one day. */
|
|
71
|
+
durationMs: number;
|
|
72
|
+
/** Whether the phase succeeded. */
|
|
73
|
+
status: 'ok' | 'error';
|
|
74
|
+
/** An error CLASS or CODE (`MissingJobInputError`, `ApiError.409`), never a message. */
|
|
75
|
+
errorType?: string | undefined;
|
|
76
|
+
/** Integer-only attributes; see {@link NodeSpanAttributes}. */
|
|
77
|
+
attributes?: NodeSpanAttributes | undefined;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* What the relay needs from the app's API client: one optional method. An app
|
|
81
|
+
* client whose `telemetry` posts to `/nodes/:id/telemetry` satisfies it
|
|
82
|
+
* structurally. A client without the method is a relay that is off.
|
|
83
|
+
*
|
|
84
|
+
* @stability experimental
|
|
85
|
+
*/
|
|
86
|
+
export interface NodeSpanSink {
|
|
87
|
+
/** Sends one batch of at most `MAX_SPANS_PER_BATCH` spans for `nodeId`. */
|
|
88
|
+
telemetry?(nodeId: string, body: {
|
|
89
|
+
spans: NodeSpan[];
|
|
90
|
+
}): Promise<unknown>;
|
|
91
|
+
}
|
|
92
|
+
//# sourceMappingURL=node-span.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"node-span.d.ts","sourceRoot":"","sources":["../../src/telemetry/node-span.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,aAAa,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;AAE9G;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,WAAW,MAAM,EAAE,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAuC,CAAC;AAI/E;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAElE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,yEAAyE;IACzE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E"}
|