@marinoscar/platform-cli 0.0.0-stage → 0.1.0-next.10
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 +149 -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 +1164 -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/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 +1315 -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 +1279 -0
- package/dist/engine/deploy/update.js.map +1 -0
- package/dist/engine/deploy/version-step.d.ts +65 -0
- package/dist/engine/deploy/version-step.d.ts.map +1 -0
- package/dist/engine/deploy/version-step.js +176 -0
- package/dist/engine/deploy/version-step.js.map +1 -0
- package/dist/engine/device-auth.d.ts +240 -0
- package/dist/engine/device-auth.d.ts.map +1 -0
- package/dist/engine/device-auth.js +442 -0
- package/dist/engine/device-auth.js.map +1 -0
- package/dist/engine/device-login.d.ts +126 -0
- package/dist/engine/device-login.d.ts.map +1 -0
- package/dist/engine/device-login.js +164 -0
- package/dist/engine/device-login.js.map +1 -0
- package/dist/engine/errors.d.ts +314 -0
- package/dist/engine/errors.d.ts.map +1 -0
- package/dist/engine/errors.js +561 -0
- package/dist/engine/errors.js.map +1 -0
- package/dist/engine/identity.d.ts +169 -0
- package/dist/engine/identity.d.ts.map +1 -0
- package/dist/engine/identity.js +227 -0
- package/dist/engine/identity.js.map +1 -0
- package/dist/engine/index.d.ts +104 -0
- package/dist/engine/index.d.ts.map +1 -0
- package/dist/engine/index.js +126 -0
- package/dist/engine/index.js.map +1 -0
- package/dist/engine/init/local-profile.d.ts +93 -0
- package/dist/engine/init/local-profile.d.ts.map +1 -0
- package/dist/engine/init/local-profile.js +295 -0
- package/dist/engine/init/local-profile.js.map +1 -0
- package/dist/engine/init/run-init.d.ts +41 -0
- package/dist/engine/init/run-init.d.ts.map +1 -0
- package/dist/engine/init/run-init.js +297 -0
- package/dist/engine/init/run-init.js.map +1 -0
- package/dist/engine/node/capabilities.d.ts +238 -0
- package/dist/engine/node/capabilities.d.ts.map +1 -0
- package/dist/engine/node/capabilities.js +316 -0
- package/dist/engine/node/capabilities.js.map +1 -0
- package/dist/engine/node/daemon.d.ts +63 -0
- package/dist/engine/node/daemon.d.ts.map +1 -0
- package/dist/engine/node/daemon.js +227 -0
- package/dist/engine/node/daemon.js.map +1 -0
- package/dist/engine/node/doctor.d.ts +58 -0
- package/dist/engine/node/doctor.d.ts.map +1 -0
- package/dist/engine/node/doctor.js +394 -0
- package/dist/engine/node/doctor.js.map +1 -0
- package/dist/engine/node/enrollment.d.ts +98 -0
- package/dist/engine/node/enrollment.d.ts.map +1 -0
- package/dist/engine/node/enrollment.js +189 -0
- package/dist/engine/node/enrollment.js.map +1 -0
- package/dist/engine/node/env-flags.d.ts +5 -0
- package/dist/engine/node/env-flags.d.ts.map +1 -0
- package/dist/engine/node/env-flags.js +22 -0
- package/dist/engine/node/env-flags.js.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.js +189 -0
- package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
- package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
- package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
- package/dist/engine/node/executors/db-backup-run.js +362 -0
- package/dist/engine/node/executors/db-backup-run.js.map +1 -0
- package/dist/engine/node/executors/example-checksum.d.ts +30 -0
- package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
- package/dist/engine/node/executors/example-checksum.js +56 -0
- package/dist/engine/node/executors/example-checksum.js.map +1 -0
- package/dist/engine/node/executors/index.d.ts +168 -0
- package/dist/engine/node/executors/index.d.ts.map +1 -0
- package/dist/engine/node/executors/index.js +44 -0
- package/dist/engine/node/executors/index.js.map +1 -0
- package/dist/engine/node/executors/registry.d.ts +38 -0
- package/dist/engine/node/executors/registry.d.ts.map +1 -0
- package/dist/engine/node/executors/registry.js +92 -0
- package/dist/engine/node/executors/registry.js.map +1 -0
- package/dist/engine/node/heap-snapshot.d.ts +37 -0
- package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
- package/dist/engine/node/heap-snapshot.js +160 -0
- package/dist/engine/node/heap-snapshot.js.map +1 -0
- package/dist/engine/node/install-deps.d.ts +73 -0
- package/dist/engine/node/install-deps.d.ts.map +1 -0
- package/dist/engine/node/install-deps.js +150 -0
- package/dist/engine/node/install-deps.js.map +1 -0
- package/dist/engine/node/ipc-protocol.d.ts +67 -0
- package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
- package/dist/engine/node/ipc-protocol.js +83 -0
- package/dist/engine/node/ipc-protocol.js.map +1 -0
- package/dist/engine/node/lifecycle.d.ts +103 -0
- package/dist/engine/node/lifecycle.d.ts.map +1 -0
- package/dist/engine/node/lifecycle.js +259 -0
- package/dist/engine/node/lifecycle.js.map +1 -0
- package/dist/engine/node/logger.d.ts +82 -0
- package/dist/engine/node/logger.d.ts.map +1 -0
- package/dist/engine/node/logger.js +241 -0
- package/dist/engine/node/logger.js.map +1 -0
- package/dist/engine/node/memory-watchdog.d.ts +78 -0
- package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
- package/dist/engine/node/memory-watchdog.js +224 -0
- package/dist/engine/node/memory-watchdog.js.map +1 -0
- package/dist/engine/node/node-api.d.ts +391 -0
- package/dist/engine/node/node-api.d.ts.map +1 -0
- package/dist/engine/node/node-api.js +123 -0
- package/dist/engine/node/node-api.js.map +1 -0
- package/dist/engine/node/node-config.d.ts +128 -0
- package/dist/engine/node/node-config.d.ts.map +1 -0
- package/dist/engine/node/node-config.js +237 -0
- package/dist/engine/node/node-config.js.map +1 -0
- package/dist/engine/node/node-dashboard-source.d.ts +56 -0
- package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
- package/dist/engine/node/node-dashboard-source.js +213 -0
- package/dist/engine/node/node-dashboard-source.js.map +1 -0
- package/dist/engine/node/node-engine.d.ts +229 -0
- package/dist/engine/node/node-engine.d.ts.map +1 -0
- package/dist/engine/node/node-engine.js +723 -0
- package/dist/engine/node/node-engine.js.map +1 -0
- package/dist/engine/node/node-errors.d.ts +54 -0
- package/dist/engine/node/node-errors.d.ts.map +1 -0
- package/dist/engine/node/node-errors.js +71 -0
- package/dist/engine/node/node-errors.js.map +1 -0
- package/dist/engine/node/node-events.d.ts +132 -0
- package/dist/engine/node/node-events.d.ts.map +1 -0
- package/dist/engine/node/node-events.js +2 -0
- package/dist/engine/node/node-events.js.map +1 -0
- package/dist/engine/node/node-vitals.d.ts +123 -0
- package/dist/engine/node/node-vitals.d.ts.map +1 -0
- package/dist/engine/node/node-vitals.js +266 -0
- package/dist/engine/node/node-vitals.js.map +1 -0
- package/dist/engine/node/paths.d.ts +39 -0
- package/dist/engine/node/paths.d.ts.map +1 -0
- package/dist/engine/node/paths.js +60 -0
- package/dist/engine/node/paths.js.map +1 -0
- package/dist/engine/node/pg-dump.d.ts +126 -0
- package/dist/engine/node/pg-dump.d.ts.map +1 -0
- package/dist/engine/node/pg-dump.js +223 -0
- package/dist/engine/node/pg-dump.js.map +1 -0
- package/dist/engine/node/pidfile.d.ts +38 -0
- package/dist/engine/node/pidfile.d.ts.map +1 -0
- package/dist/engine/node/pidfile.js +156 -0
- package/dist/engine/node/pidfile.js.map +1 -0
- package/dist/engine/node/runtime-tuning.d.ts +65 -0
- package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
- package/dist/engine/node/runtime-tuning.js +198 -0
- package/dist/engine/node/runtime-tuning.js.map +1 -0
- package/dist/engine/node/service.d.ts +39 -0
- package/dist/engine/node/service.d.ts.map +1 -0
- package/dist/engine/node/service.js +211 -0
- package/dist/engine/node/service.js.map +1 -0
- package/dist/engine/node/start.d.ts +62 -0
- package/dist/engine/node/start.d.ts.map +1 -0
- package/dist/engine/node/start.js +245 -0
- package/dist/engine/node/start.js.map +1 -0
- package/dist/engine/node/worker-env-table.d.ts +15 -0
- package/dist/engine/node/worker-env-table.d.ts.map +1 -0
- package/dist/engine/node/worker-env-table.js +97 -0
- package/dist/engine/node/worker-env-table.js.map +1 -0
- package/dist/engine/node/worker-env.d.ts +50 -0
- package/dist/engine/node/worker-env.d.ts.map +1 -0
- package/dist/engine/node/worker-env.js +101 -0
- package/dist/engine/node/worker-env.js.map +1 -0
- package/dist/engine/output.d.ts +97 -0
- package/dist/engine/output.d.ts.map +1 -0
- package/dist/engine/output.js +274 -0
- package/dist/engine/output.js.map +1 -0
- package/dist/engine/package-info.d.ts +7 -0
- package/dist/engine/package-info.d.ts.map +1 -0
- package/dist/engine/package-info.js +38 -0
- package/dist/engine/package-info.js.map +1 -0
- package/dist/engine/program.d.ts +50 -0
- package/dist/engine/program.d.ts.map +1 -0
- package/dist/engine/program.js +197 -0
- package/dist/engine/program.js.map +1 -0
- package/dist/engine/prompt.d.ts +69 -0
- package/dist/engine/prompt.d.ts.map +1 -0
- package/dist/engine/prompt.js +205 -0
- package/dist/engine/prompt.js.map +1 -0
- package/dist/engine/registries.d.ts +5 -0
- package/dist/engine/registries.d.ts.map +1 -0
- package/dist/engine/registries.js +52 -0
- package/dist/engine/registries.js.map +1 -0
- package/dist/engine/request-body.d.ts +31 -0
- package/dist/engine/request-body.d.ts.map +1 -0
- package/dist/engine/request-body.js +156 -0
- package/dist/engine/request-body.js.map +1 -0
- package/dist/engine/test-support.d.ts +50 -0
- package/dist/engine/test-support.d.ts.map +1 -0
- package/dist/engine/test-support.js +86 -0
- package/dist/engine/test-support.js.map +1 -0
- package/dist/engine/tui/app.d.ts +3 -0
- package/dist/engine/tui/app.d.ts.map +1 -0
- package/dist/engine/tui/app.js +100 -0
- package/dist/engine/tui/app.js.map +1 -0
- package/dist/engine/tui/builtin-screens.d.ts +6 -0
- package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
- package/dist/engine/tui/builtin-screens.js +54 -0
- package/dist/engine/tui/builtin-screens.js.map +1 -0
- package/dist/engine/tui/index.d.ts +23 -0
- package/dist/engine/tui/index.d.ts.map +1 -0
- package/dist/engine/tui/index.js +71 -0
- package/dist/engine/tui/index.js.map +1 -0
- package/dist/engine/tui/layout.d.ts +132 -0
- package/dist/engine/tui/layout.d.ts.map +1 -0
- package/dist/engine/tui/layout.js +200 -0
- package/dist/engine/tui/layout.js.map +1 -0
- package/dist/engine/tui/routes.d.ts +5 -0
- package/dist/engine/tui/routes.d.ts.map +1 -0
- package/dist/engine/tui/routes.js +16 -0
- package/dist/engine/tui/routes.js.map +1 -0
- package/dist/engine/tui/screen-registry.d.ts +100 -0
- package/dist/engine/tui/screen-registry.d.ts.map +1 -0
- package/dist/engine/tui/screen-registry.js +96 -0
- package/dist/engine/tui/screen-registry.js.map +1 -0
- package/dist/engine/tui/screen-sections.d.ts +9 -0
- package/dist/engine/tui/screen-sections.d.ts.map +1 -0
- package/dist/engine/tui/screen-sections.js +45 -0
- package/dist/engine/tui/screen-sections.js.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.js +153 -0
- package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.js +202 -0
- package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
- package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
- package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/index.js +83 -0
- package/dist/engine/tui/screens/deploy/index.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.js +319 -0
- package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install.js +361 -0
- package/dist/engine/tui/screens/deploy/install.js.map +1 -0
- package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
- package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/model.js +59 -0
- package/dist/engine/tui/screens/deploy/model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.js +117 -0
- package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
- package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run.js +201 -0
- package/dist/engine/tui/screens/deploy/run.js.map +1 -0
- package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
- package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/status.js +107 -0
- package/dist/engine/tui/screens/deploy/status.js.map +1 -0
- package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
- package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/update.js +175 -0
- package/dist/engine/tui/screens/deploy/update.js.map +1 -0
- package/dist/engine/tui/screens/deploy.d.ts +12 -0
- package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy.js +23 -0
- package/dist/engine/tui/screens/deploy.js.map +1 -0
- package/dist/engine/tui/screens/invoke.d.ts +6 -0
- package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
- package/dist/engine/tui/screens/invoke.js +193 -0
- package/dist/engine/tui/screens/invoke.js.map +1 -0
- package/dist/engine/tui/screens/login.d.ts +6 -0
- package/dist/engine/tui/screens/login.d.ts.map +1 -0
- package/dist/engine/tui/screens/login.js +255 -0
- package/dist/engine/tui/screens/login.js.map +1 -0
- package/dist/engine/tui/screens/logout.d.ts +6 -0
- package/dist/engine/tui/screens/logout.d.ts.map +1 -0
- package/dist/engine/tui/screens/logout.js +142 -0
- package/dist/engine/tui/screens/logout.js.map +1 -0
- package/dist/engine/tui/screens/menu.d.ts +22 -0
- package/dist/engine/tui/screens/menu.d.ts.map +1 -0
- package/dist/engine/tui/screens/menu.js +84 -0
- package/dist/engine/tui/screens/menu.js.map +1 -0
- package/dist/engine/tui/screens/node.d.ts +6 -0
- package/dist/engine/tui/screens/node.d.ts.map +1 -0
- package/dist/engine/tui/screens/node.js +228 -0
- package/dist/engine/tui/screens/node.js.map +1 -0
- package/dist/engine/tui/screens/status.d.ts +6 -0
- package/dist/engine/tui/screens/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/status.js +134 -0
- package/dist/engine/tui/screens/status.js.map +1 -0
- package/dist/engine/tui/scroll-box.d.ts +27 -0
- package/dist/engine/tui/scroll-box.d.ts.map +1 -0
- package/dist/engine/tui/scroll-box.js +52 -0
- package/dist/engine/tui/scroll-box.js.map +1 -0
- package/dist/engine/tui/section-registry.d.ts +65 -0
- package/dist/engine/tui/section-registry.d.ts.map +1 -0
- package/dist/engine/tui/section-registry.js +90 -0
- package/dist/engine/tui/section-registry.js.map +1 -0
- package/dist/engine/tui/terminal.d.ts +31 -0
- package/dist/engine/tui/terminal.d.ts.map +1 -0
- package/dist/engine/tui/terminal.js +142 -0
- package/dist/engine/tui/terminal.js.map +1 -0
- package/dist/engine/tui/tty.d.ts +49 -0
- package/dist/engine/tui/tty.d.ts.map +1 -0
- package/dist/engine/tui/tty.js +139 -0
- package/dist/engine/tui/tty.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- package/dist/node/index.d.ts +3 -0
- package/dist/node/index.d.ts.map +1 -0
- package/dist/node/index.js +5 -0
- package/dist/node/index.js.map +1 -0
- package/dist/telemetry/env-fragment.d.ts +47 -0
- package/dist/telemetry/env-fragment.d.ts.map +1 -0
- package/dist/telemetry/env-fragment.js +73 -0
- package/dist/telemetry/env-fragment.js.map +1 -0
- package/dist/telemetry/index.d.ts +7 -0
- package/dist/telemetry/index.d.ts.map +1 -0
- package/dist/telemetry/index.js +7 -0
- package/dist/telemetry/index.js.map +1 -0
- package/dist/telemetry/node-span-relay.d.ts +107 -0
- package/dist/telemetry/node-span-relay.d.ts.map +1 -0
- package/dist/telemetry/node-span-relay.js +314 -0
- package/dist/telemetry/node-span-relay.js.map +1 -0
- package/dist/telemetry/node-span.d.ts +92 -0
- package/dist/telemetry/node-span.d.ts.map +1 -0
- package/dist/telemetry/node-span.js +28 -0
- package/dist/telemetry/node-span.js.map +1 -0
- package/dist/testing/index.d.ts +3 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +4 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/tui/index.d.ts +3 -0
- package/dist/tui/index.d.ts.map +1 -0
- package/dist/tui/index.js +5 -0
- package/dist/tui/index.js.map +1 -0
- package/package.json +102 -4
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
import { createCliRegistry } from '../../core/index.js';
|
|
2
|
+
// =============================================================================
|
|
3
|
+
// TUI screen sections (PP-14.22)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// The platform's `node` and `deploy` screens are closed components: an app that
|
|
7
|
+
// wants one more line on them (its own fleet note under the worker-node list,
|
|
8
|
+
// a deploy hint under the deploy actions) had to fork the screen. A SECTION is
|
|
9
|
+
// an ink component the app registers for one of those screens; the screen
|
|
10
|
+
// renders every registered section below its own content, in registration
|
|
11
|
+
// order, on its top-level list. A section is read-only presentation: it does
|
|
12
|
+
// not receive the screen's state, cannot add a menu action and cannot take over
|
|
13
|
+
// the keyboard on the platform's behalf (it may use `useInput` like any ink
|
|
14
|
+
// component, which is its own responsibility).
|
|
15
|
+
//
|
|
16
|
+
// PURE ON PURPOSE, like screen-registry.ts: React is imported as a type only,
|
|
17
|
+
// so registering a section from `createCli` never loads ink. The component is
|
|
18
|
+
// either given directly or loaded when the screen opens (`load`).
|
|
19
|
+
// =============================================================================
|
|
20
|
+
/**
|
|
21
|
+
* The screens that render registered sections.
|
|
22
|
+
*
|
|
23
|
+
* @stability experimental
|
|
24
|
+
*/
|
|
25
|
+
export const TUI_SECTION_SCREENS = Object.freeze(['node', 'deploy']);
|
|
26
|
+
const ID_PATTERN = /^[a-z][a-z0-9-]*$/;
|
|
27
|
+
const registry = createCliRegistry({
|
|
28
|
+
name: 'TUI screen section',
|
|
29
|
+
registerFn: 'registerTuiScreenSection',
|
|
30
|
+
idOf: (entry) => entry.key,
|
|
31
|
+
validate: (entry) => {
|
|
32
|
+
if (!TUI_SECTION_SCREENS.includes(entry.screen)) {
|
|
33
|
+
throw new Error(`TUI screen "${String(entry.screen)}" has no section slot. Screens with one: ${TUI_SECTION_SCREENS.join(', ')}. ` +
|
|
34
|
+
'An app screen composes its own content.');
|
|
35
|
+
}
|
|
36
|
+
if (typeof entry.id !== 'string' || !ID_PATTERN.test(entry.id)) {
|
|
37
|
+
throw new Error(`TUI section id "${String(entry.id)}" is invalid: use lowercase letters, digits and hyphens.`);
|
|
38
|
+
}
|
|
39
|
+
const hasComponent = typeof entry.component === 'function' || (typeof entry.component === 'object' && entry.component !== null);
|
|
40
|
+
if (hasComponent === (typeof entry.load === 'function')) {
|
|
41
|
+
throw new Error(`TUI section "${entry.screen}:${entry.id}" needs exactly one of component or load.`);
|
|
42
|
+
}
|
|
43
|
+
},
|
|
44
|
+
});
|
|
45
|
+
/**
|
|
46
|
+
* Adds a section to the `node` or `deploy` TUI screen.
|
|
47
|
+
*
|
|
48
|
+
* @param screenId - `node` or `deploy`.
|
|
49
|
+
* @param section - The component, or `{ id, load }` to load it when the screen opens.
|
|
50
|
+
* @param options - `id`, unique within the screen (default: the component's name).
|
|
51
|
+
* @throws Error when the screen has no slot, the id is malformed or taken, or `createCli` has already built the CLI.
|
|
52
|
+
* @stability experimental
|
|
53
|
+
* @extensionPoint registry
|
|
54
|
+
* @example
|
|
55
|
+
* ```ts
|
|
56
|
+
* registerTuiScreenSection('node', FleetNote, { id: 'fleet-note' });
|
|
57
|
+
* registerTuiScreenSection('deploy', { id: 'release-hint', load: async () => (await import('./hint.js')).Hint });
|
|
58
|
+
* ```
|
|
59
|
+
*/
|
|
60
|
+
export function registerTuiScreenSection(screenId, section, options = {}) {
|
|
61
|
+
const lazy = typeof section === 'object' && section !== null && 'load' in section;
|
|
62
|
+
const id = options.id ?? (lazy ? section.id : (section.displayName ?? section.name ?? ''))
|
|
63
|
+
.replace(/([a-z0-9])([A-Z])/g, '$1-$2')
|
|
64
|
+
.toLowerCase();
|
|
65
|
+
registry.register({
|
|
66
|
+
key: `${screenId}:${id}`,
|
|
67
|
+
screen: screenId,
|
|
68
|
+
id,
|
|
69
|
+
...(lazy ? { load: section.load } : { component: section }),
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* The sections registered for a screen, in registration order.
|
|
74
|
+
*
|
|
75
|
+
* @param screenId - `node` or `deploy`.
|
|
76
|
+
* @returns A frozen copy.
|
|
77
|
+
* @stability experimental
|
|
78
|
+
*/
|
|
79
|
+
export function listTuiScreenSections(screenId) {
|
|
80
|
+
return Object.freeze(registry.list().filter((entry) => entry.screen === screenId));
|
|
81
|
+
}
|
|
82
|
+
/** Refuses later registrations; `createCli` calls it. */
|
|
83
|
+
export function freezeTuiSectionRegistry(by) {
|
|
84
|
+
registry.freeze(by);
|
|
85
|
+
}
|
|
86
|
+
/** Empties the registry. Tests only. */
|
|
87
|
+
export function resetTuiSectionRegistryForTests() {
|
|
88
|
+
registry.reset();
|
|
89
|
+
}
|
|
90
|
+
//# sourceMappingURL=section-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"section-registry.js","sourceRoot":"","sources":["../../../src/engine/tui/section-registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
export interface TerminalRestoreContext {
|
|
2
|
+
stdout?: NodeJS.WriteStream | undefined;
|
|
3
|
+
stdin?: NodeJS.ReadStream | undefined;
|
|
4
|
+
/** Injected so a test can assert the handlers without killing its own runner. */
|
|
5
|
+
process?: NodeJS.Process | undefined;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Register the safety net. Returns the function that removes it.
|
|
9
|
+
*
|
|
10
|
+
* THE DISPOSER IS NOT OPTIONAL HOUSEKEEPING. Node warns (and then leaks) past
|
|
11
|
+
* ten listeners on an emitter, and `process` is a single long-lived emitter
|
|
12
|
+
* shared with everything else in the runtime. More importantly, leaving a
|
|
13
|
+
* SIGINT listener installed after the TUI has exited would keep suppressing
|
|
14
|
+
* node's default disposition for the rest of the process's life — so a Ctrl-C
|
|
15
|
+
* during whatever runs next would be handled by dead UI code.
|
|
16
|
+
*/
|
|
17
|
+
export declare function installTerminalRestore(ctx?: TerminalRestoreContext): () => void;
|
|
18
|
+
/**
|
|
19
|
+
* Put the cursor back and take stdin out of raw mode. Safe to call any number
|
|
20
|
+
* of times, and safe to call when neither was ever changed.
|
|
21
|
+
*
|
|
22
|
+
* Every step is wrapped, because this runs on the failure path by definition:
|
|
23
|
+
* the stream may already be destroyed (a closed terminal, a killed parent), and
|
|
24
|
+
* a throw from here would replace the error the user actually needs to see with
|
|
25
|
+
* an EPIPE from the cleanup.
|
|
26
|
+
*/
|
|
27
|
+
export declare function restoreTerminal(ctx?: {
|
|
28
|
+
stdout?: NodeJS.WriteStream | undefined;
|
|
29
|
+
stdin?: NodeJS.ReadStream | undefined;
|
|
30
|
+
}): void;
|
|
31
|
+
//# sourceMappingURL=terminal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/engine/tui/terminal.ts"],"names":[],"mappings":"AAwEA,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACtC,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,CAAC,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAmC/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;CACvC,GAAG,IAAI,CAsBP"}
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// Leaving the terminal usable (issue #145, epic #110)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// A TUI borrows two pieces of global, PROCESS-OUTLIVING state from the user's
|
|
6
|
+
// terminal, and if it dies without giving them back the damage lands on the
|
|
7
|
+
// shell the user returns to — not on this process, which is already gone:
|
|
8
|
+
//
|
|
9
|
+
// 1. THE CURSOR IS HIDDEN. ink hides it while it draws, because a cursor
|
|
10
|
+
// parked wherever the last write ended flickers across the frame on every
|
|
11
|
+
// redraw. Left hidden, the user's next shell prompt has no visible cursor
|
|
12
|
+
// at all. Typing works; nothing shows where. It survives every subsequent
|
|
13
|
+
// command and is fixed only by `reset` or `tput cnorm`, which is knowledge
|
|
14
|
+
// the person staring at the invisible cursor does not have.
|
|
15
|
+
//
|
|
16
|
+
// 2. STDIN IS IN RAW MODE. This is the serious one. Raw mode turns off line
|
|
17
|
+
// buffering, local echo AND the terminal's own signal generation. A shell
|
|
18
|
+
// inheriting a raw stdin does not echo what is typed and DOES NOT RESPOND
|
|
19
|
+
// TO CTRL-C, because in raw mode the terminal no longer converts ^C into
|
|
20
|
+
// SIGINT — it just hands the byte to whoever is reading, and nobody is.
|
|
21
|
+
// The terminal looks hung. It is a `reset` away from working and looks
|
|
22
|
+
// like a crashed machine.
|
|
23
|
+
//
|
|
24
|
+
// ink restores both on a clean unmount, and registers `signal-exit` to cover
|
|
25
|
+
// most of the rest. This module is the BELT-AND-BRACES layer under that, for
|
|
26
|
+
// the paths ink cannot see: a throw in our own async code between mounting and
|
|
27
|
+
// ink's own teardown, a SIGTERM from another terminal, a SIGHUP when the
|
|
28
|
+
// terminal window is closed.
|
|
29
|
+
//
|
|
30
|
+
// The restore itself is deliberately IDEMPOTENT and SYNCHRONOUS. Idempotent
|
|
31
|
+
// because ink will also do it and double-restoring must be harmless;
|
|
32
|
+
// synchronous because a `process.on('exit')` handler is the last code that
|
|
33
|
+
// runs and an async write there is simply dropped.
|
|
34
|
+
// =============================================================================
|
|
35
|
+
/**
|
|
36
|
+
* DECTCEM show-cursor. Written as an escape literal rather than pulled from
|
|
37
|
+
* `ansi-escapes` (an ink dependency, not one of ours) so this file has no
|
|
38
|
+
* imports at all and can therefore run from an `exit` handler with no risk of
|
|
39
|
+
* touching a half-initialised module graph.
|
|
40
|
+
*/
|
|
41
|
+
const SHOW_CURSOR = '\u001B[?25h';
|
|
42
|
+
/**
|
|
43
|
+
* Signals that terminate the process WITHOUT running `exit` handlers.
|
|
44
|
+
*
|
|
45
|
+
* That is the whole reason they are listened for. Node's default disposition
|
|
46
|
+
* for a signal is to die immediately; `process.on('exit')` never fires, so the
|
|
47
|
+
* cursor stays hidden and stdin stays raw. Handling them lets us restore and
|
|
48
|
+
* then exit with the conventional 128+n code, which preserves "this process
|
|
49
|
+
* was killed by a signal" for any wrapping script.
|
|
50
|
+
*
|
|
51
|
+
* SIGINT IS ON THIS LIST, and it needs the caveat: adding a listener for it
|
|
52
|
+
* SUPPRESSES NODE'S DEFAULT, so a handler that forgot to exit would make Ctrl-C
|
|
53
|
+
* do nothing — a worse bug than the one being fixed. The handler below always
|
|
54
|
+
* exits, so the observable behaviour is unchanged (the process still dies on
|
|
55
|
+
* Ctrl-C, with the same code a shell reports) and the terminal is restored on
|
|
56
|
+
* the way out. In practice this listener rarely fires at all: while ink holds
|
|
57
|
+
* stdin in raw mode the terminal does not generate SIGINT, and ink reads the
|
|
58
|
+
* literal ^C byte instead. It exists for the window after unmount and before
|
|
59
|
+
* the process actually ends.
|
|
60
|
+
*/
|
|
61
|
+
const FATAL_SIGNALS = ['SIGINT', 'SIGTERM', 'SIGHUP'];
|
|
62
|
+
const SIGNAL_NUMBERS = {
|
|
63
|
+
SIGINT: 2,
|
|
64
|
+
SIGTERM: 15,
|
|
65
|
+
SIGHUP: 1,
|
|
66
|
+
};
|
|
67
|
+
/**
|
|
68
|
+
* Register the safety net. Returns the function that removes it.
|
|
69
|
+
*
|
|
70
|
+
* THE DISPOSER IS NOT OPTIONAL HOUSEKEEPING. Node warns (and then leaks) past
|
|
71
|
+
* ten listeners on an emitter, and `process` is a single long-lived emitter
|
|
72
|
+
* shared with everything else in the runtime. More importantly, leaving a
|
|
73
|
+
* SIGINT listener installed after the TUI has exited would keep suppressing
|
|
74
|
+
* node's default disposition for the rest of the process's life — so a Ctrl-C
|
|
75
|
+
* during whatever runs next would be handled by dead UI code.
|
|
76
|
+
*/
|
|
77
|
+
export function installTerminalRestore(ctx) {
|
|
78
|
+
const proc = ctx?.process ?? process;
|
|
79
|
+
const stdout = ctx?.stdout ?? proc.stdout;
|
|
80
|
+
const stdin = ctx?.stdin ?? proc.stdin;
|
|
81
|
+
const restore = () => {
|
|
82
|
+
restoreTerminal({ stdout, stdin });
|
|
83
|
+
};
|
|
84
|
+
const signalHandlers = new Map();
|
|
85
|
+
for (const signal of FATAL_SIGNALS) {
|
|
86
|
+
const handler = () => {
|
|
87
|
+
restore();
|
|
88
|
+
// 128+n is the convention every shell reports for "killed by signal n",
|
|
89
|
+
// and scripts branch on it. Re-raising the signal after removing the
|
|
90
|
+
// handler would be more faithful still, but it races with the exit we
|
|
91
|
+
// are already committed to; the code is what callers actually observe.
|
|
92
|
+
proc.exit(128 + SIGNAL_NUMBERS[signal]);
|
|
93
|
+
};
|
|
94
|
+
signalHandlers.set(signal, handler);
|
|
95
|
+
proc.on(signal, handler);
|
|
96
|
+
}
|
|
97
|
+
// Covers the ordinary paths: a returned exit code, an explicit
|
|
98
|
+
// `process.exit()`, and an uncaught exception (node runs `exit` handlers
|
|
99
|
+
// after printing the stack). Synchronous by necessity — see the header.
|
|
100
|
+
proc.on('exit', restore);
|
|
101
|
+
return () => {
|
|
102
|
+
proc.removeListener('exit', restore);
|
|
103
|
+
for (const [signal, handler] of signalHandlers) {
|
|
104
|
+
proc.removeListener(signal, handler);
|
|
105
|
+
}
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* Put the cursor back and take stdin out of raw mode. Safe to call any number
|
|
110
|
+
* of times, and safe to call when neither was ever changed.
|
|
111
|
+
*
|
|
112
|
+
* Every step is wrapped, because this runs on the failure path by definition:
|
|
113
|
+
* the stream may already be destroyed (a closed terminal, a killed parent), and
|
|
114
|
+
* a throw from here would replace the error the user actually needs to see with
|
|
115
|
+
* an EPIPE from the cleanup.
|
|
116
|
+
*/
|
|
117
|
+
export function restoreTerminal(ctx) {
|
|
118
|
+
const stdout = ctx?.stdout ?? process.stdout;
|
|
119
|
+
const stdin = ctx?.stdin ?? process.stdin;
|
|
120
|
+
try {
|
|
121
|
+
// Only on a real terminal. The sequence is meaningless in a file and would
|
|
122
|
+
// be five stray bytes at the end of any redirected output — the gate in
|
|
123
|
+
// tty.ts should have prevented us getting here at all, but this function is
|
|
124
|
+
// the last line of defence and must not itself corrupt a stream.
|
|
125
|
+
if (stdout.isTTY === true)
|
|
126
|
+
stdout.write(SHOW_CURSOR);
|
|
127
|
+
}
|
|
128
|
+
catch {
|
|
129
|
+
// The terminal is gone. Nothing left to restore it for.
|
|
130
|
+
}
|
|
131
|
+
try {
|
|
132
|
+
// `setRawMode` exists ONLY on a TTY stdin, hence the guard rather than an
|
|
133
|
+
// optional call: on a pipe the property is absent and `stdin.setRawMode` is
|
|
134
|
+
// undefined, which would throw.
|
|
135
|
+
if (stdin.isTTY === true)
|
|
136
|
+
stdin.setRawMode(false);
|
|
137
|
+
}
|
|
138
|
+
catch {
|
|
139
|
+
// Same.
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
//# sourceMappingURL=terminal.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../../src/engine/tui/terminal.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/** `APPCTL_NO_TUI` — an escape hatch for a terminal we wrongly believe is one. */
|
|
2
|
+
export declare function noTuiEnvVar(): string;
|
|
3
|
+
/**
|
|
4
|
+
* The one property this gate needs from a stream. Structural, so a test can fake it.
|
|
5
|
+
*
|
|
6
|
+
* @stability experimental
|
|
7
|
+
*/
|
|
8
|
+
export interface TtyLike {
|
|
9
|
+
/** Whether the stream is a terminal. */
|
|
10
|
+
isTTY?: boolean | undefined;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Injection seam, matching `ConfigContext` in config.ts.
|
|
14
|
+
*
|
|
15
|
+
* Every field defaults to the real process. A test that had to mutate
|
|
16
|
+
* `process.stdout.isTTY` to exercise this would be mutating a global that the
|
|
17
|
+
* test runner itself reads, and the failure would depend on file execution
|
|
18
|
+
* order.
|
|
19
|
+
*
|
|
20
|
+
* @stability experimental
|
|
21
|
+
*/
|
|
22
|
+
export interface TtyContext {
|
|
23
|
+
/** Defaults to `process.stdout`. */
|
|
24
|
+
stdout?: TtyLike | undefined;
|
|
25
|
+
/** Defaults to `process.stdin`. */
|
|
26
|
+
stdin?: TtyLike | undefined;
|
|
27
|
+
/** Defaults to `process.env` (`CI`, `TERM`, the no-TUI variable). */
|
|
28
|
+
env?: NodeJS.ProcessEnv | undefined;
|
|
29
|
+
}
|
|
30
|
+
/** Why the TUI was refused. Distinct values so a test asserts the cause, not the prose. */
|
|
31
|
+
export type TuiRefusal = 'disabled' | 'stdout-not-a-tty' | 'stdin-not-a-tty' | 'dumb-terminal' | 'ci';
|
|
32
|
+
export type TuiGateDecision = {
|
|
33
|
+
engage: true;
|
|
34
|
+
} | {
|
|
35
|
+
engage: false;
|
|
36
|
+
refusal: TuiRefusal;
|
|
37
|
+
/** One sentence naming the cause AND the thing to do instead. */
|
|
38
|
+
reason: string;
|
|
39
|
+
};
|
|
40
|
+
/**
|
|
41
|
+
* Decide whether a full-screen UI may be mounted.
|
|
42
|
+
*
|
|
43
|
+
* FIVE CHECKS, ORDERED BY HOW SPECIFIC THE RESULTING ADVICE IS — the first one
|
|
44
|
+
* that fires produces the message, so the most actionable diagnosis must come
|
|
45
|
+
* first. "You set APPCTL_NO_TUI" is a better answer than "stdout is not a
|
|
46
|
+
* terminal" even when both are true.
|
|
47
|
+
*/
|
|
48
|
+
export declare function evaluateTuiGate(ctx?: TtyContext): TuiGateDecision;
|
|
49
|
+
//# sourceMappingURL=tty.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../../src/engine/tui/tty.ts"],"names":[],"mappings":"AA+CA,kFAAkF;AAClF,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,IAAI,CAAC;AAET,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAChB;IACE,MAAM,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,UAAU,CAAC;IACpB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,eAAe,CAoFjE"}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import { cliName, envVar } from '../identity.js';
|
|
2
|
+
// =============================================================================
|
|
3
|
+
// The TTY gate (issue #145, epic #110 success criterion 7)
|
|
4
|
+
// =============================================================================
|
|
5
|
+
//
|
|
6
|
+
// THIS IS THE MOST IMPORTANT FILE IN THE TUI, and it contains no UI at all.
|
|
7
|
+
//
|
|
8
|
+
// A full-screen renderer is a program that writes cursor-movement escape
|
|
9
|
+
// sequences and reads keystrokes. Both halves fail catastrophically and
|
|
10
|
+
// SILENTLY when the other end is not a terminal:
|
|
11
|
+
//
|
|
12
|
+
// - WRITING. ink redraws its whole frame on every state change. Into a
|
|
13
|
+
// terminal that is a repaint; into a pipe or a CI log file it is the entire
|
|
14
|
+
// frame appended AGAIN, escape sequences and all, several times a second
|
|
15
|
+
// for as long as the app runs. A device-flow login polls for up to fifteen
|
|
16
|
+
// minutes. The result is a multi-megabyte log of ESC-bracket noise wrapped
|
|
17
|
+
// around output nobody can read, and some log viewers refuse to render it
|
|
18
|
+
// at all.
|
|
19
|
+
//
|
|
20
|
+
// - READING. The menu waits for a keypress. A non-TTY stdin never produces
|
|
21
|
+
// one, so the app waits forever: the CI job hangs until the runner's own
|
|
22
|
+
// timeout kills it, tens of minutes later, with a log that says nothing
|
|
23
|
+
// about why. That is the single worst failure mode a CLI can have, because
|
|
24
|
+
// the symptom (a timeout) points nowhere near the cause.
|
|
25
|
+
//
|
|
26
|
+
// Neither failure raises an error. Neither is visible in a passing local test.
|
|
27
|
+
// Both are certain the first time somebody runs the bare command from a script.
|
|
28
|
+
// So the gate is a hard precondition evaluated BEFORE anything is rendered, and
|
|
29
|
+
// it is deliberately kept in a module that imports NEITHER react NOR ink — see
|
|
30
|
+
// `program.ts`, which consults it and only then `await import()`s the renderer.
|
|
31
|
+
// A top-level ink import here would drag the reconciler, yoga (a WASM module)
|
|
32
|
+
// and two dozen transitive packages into the startup path of every
|
|
33
|
+
// `appctl api GET ...` in every pipeline, which is both slow and exactly the
|
|
34
|
+
// coupling this gate exists to prevent.
|
|
35
|
+
//
|
|
36
|
+
// -----------------------------------------------------------------------------
|
|
37
|
+
// WHY THE GATE IS ON "NO ARGUMENTS", NOT ON A `--tui` FLAG OR A MODE
|
|
38
|
+
// -----------------------------------------------------------------------------
|
|
39
|
+
// The TUI is the no-argument experience and nothing else. `appctl api GET
|
|
40
|
+
// /api/auth/me` must behave identically whether it runs in a terminal, in a
|
|
41
|
+
// cron job, or under `set -e` in a pipeline — so an explicit subcommand NEVER
|
|
42
|
+
// consults this file, TTY or not. The check lives at the one branch in `run()`
|
|
43
|
+
// where argv is empty, which is the only invocation that has no scripted
|
|
44
|
+
// meaning to capture.
|
|
45
|
+
// =============================================================================
|
|
46
|
+
/** `APPCTL_NO_TUI` — an escape hatch for a terminal we wrongly believe is one. */
|
|
47
|
+
export function noTuiEnvVar() {
|
|
48
|
+
return envVar('NO_TUI');
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Decide whether a full-screen UI may be mounted.
|
|
52
|
+
*
|
|
53
|
+
* FIVE CHECKS, ORDERED BY HOW SPECIFIC THE RESULTING ADVICE IS — the first one
|
|
54
|
+
* that fires produces the message, so the most actionable diagnosis must come
|
|
55
|
+
* first. "You set APPCTL_NO_TUI" is a better answer than "stdout is not a
|
|
56
|
+
* terminal" even when both are true.
|
|
57
|
+
*/
|
|
58
|
+
export function evaluateTuiGate(ctx) {
|
|
59
|
+
const env = ctx?.env ?? process.env;
|
|
60
|
+
const stdout = ctx?.stdout ?? process.stdout;
|
|
61
|
+
const stdin = ctx?.stdin ?? process.stdin;
|
|
62
|
+
// 1. The user said no. Honoured unconditionally and reported plainly, so
|
|
63
|
+
// "why do I get usage instead of the menu?" has a one-line answer instead
|
|
64
|
+
// of sending somebody to check their terminal emulator.
|
|
65
|
+
if (isEnvFlagSet(env[noTuiEnvVar()])) {
|
|
66
|
+
return refuse('disabled', `${noTuiEnvVar()} is set, so the interactive interface is disabled. Run a subcommand, or unset it.`);
|
|
67
|
+
}
|
|
68
|
+
// 2. WHERE THE FRAME WOULD GO. `isTTY` is `undefined` — not `false` — on a
|
|
69
|
+
// pipe, which is why every comparison in this file is `!== true` rather
|
|
70
|
+
// than `=== false`. A `=== false` test would pass on a pipe and mount the
|
|
71
|
+
// TUI into it, which is the exact failure this module exists to prevent.
|
|
72
|
+
if (stdout.isTTY !== true) {
|
|
73
|
+
return refuse('stdout-not-a-tty', `stdout is not a terminal, so the interactive interface was not started (it would write escape sequences into your log). Run \`${cliName()} --help\` to see the commands.`);
|
|
74
|
+
}
|
|
75
|
+
// 3. WHERE THE KEYSTROKES WOULD COME FROM. Checked SEPARATELY from stdout
|
|
76
|
+
// because the two are independently redirectable and the interesting case
|
|
77
|
+
// is real: `echo | appctl` and `appctl < /dev/null` both leave stdout a
|
|
78
|
+
// terminal while stdin is not. ink cannot put a non-TTY stdin into raw
|
|
79
|
+
// mode (`setRawMode` does not exist on it), so it would draw a menu that
|
|
80
|
+
// can never be answered and never exited — a hang in front of a user who
|
|
81
|
+
// can SEE the UI, which is worse than not drawing it.
|
|
82
|
+
if (stdin.isTTY !== true) {
|
|
83
|
+
return refuse('stdin-not-a-tty', `stdin is not a terminal, so there is no way to answer the interactive interface. Run \`${cliName()} --help\` to see the commands.`);
|
|
84
|
+
}
|
|
85
|
+
// 4. `TERM=dumb` is a terminal that has TOLD US it cannot do cursor
|
|
86
|
+
// addressing — Emacs' shell-mode, some editors' embedded terminals, a few
|
|
87
|
+
// CI shells. It IS a TTY, so checks 2 and 3 pass, and every redraw would
|
|
88
|
+
// append instead of overwriting: the same unbounded-scrollback failure as
|
|
89
|
+
// a pipe, on a device that reports itself as interactive.
|
|
90
|
+
//
|
|
91
|
+
// An ABSENT or EMPTY TERM is treated the same way, and absent is the case
|
|
92
|
+
// that actually occurs: `env.TERM` is `undefined` when nothing exported
|
|
93
|
+
// it, so this must test falsiness, NOT `=== ''`. (`undefined === ''` is
|
|
94
|
+
// false — an earlier version of this check compared against the empty
|
|
95
|
+
// string alone and let every no-TERM process straight through.) Some
|
|
96
|
+
// service managers and minimal init systems hand a process two real
|
|
97
|
+
// pseudo-terminals and no TERM at all; with no terminfo resolved there is
|
|
98
|
+
// no capability to assume, so we decline rather than guess. Declining is
|
|
99
|
+
// the recoverable direction — the user still gets usage and every
|
|
100
|
+
// subcommand, and the message below names TERM as the thing to set.
|
|
101
|
+
const term = env.TERM?.trim().toLowerCase();
|
|
102
|
+
if (term === 'dumb' || !term) {
|
|
103
|
+
const cause = term === 'dumb'
|
|
104
|
+
? `TERM is "${env.TERM}", which cannot redraw a full-screen interface`
|
|
105
|
+
: `TERM is ${env.TERM === undefined ? 'not set' : 'empty'}, so this terminal's capabilities are unknown`;
|
|
106
|
+
return refuse('dumb-terminal', `${cause}. Run \`${cliName()} --help\` to see the commands, or set TERM if this terminal can redraw.`);
|
|
107
|
+
}
|
|
108
|
+
// 5. CI, LAST AND STILL NECESSARY. Most CI systems give a process no TTY at
|
|
109
|
+
// all and are caught above — but a step running under `docker run -t`, a
|
|
110
|
+
// Jenkins job with the pty plugin, or a runner using `script(1)` to force
|
|
111
|
+
// colour has a REAL pseudo-terminal on both descriptors and passes every
|
|
112
|
+
// check so far. There is no human at that terminal, so the menu would
|
|
113
|
+
// still wait for a keypress that never comes. Declining here converts a
|
|
114
|
+
// job that hangs until its timeout into one that fails in a second with
|
|
115
|
+
// printed usage.
|
|
116
|
+
if (isEnvFlagSet(env.CI) || isEnvFlagSet(env.CONTINUOUS_INTEGRATION)) {
|
|
117
|
+
return refuse('ci', `CI is set, so the interactive interface was not started — nothing would answer it. Run a subcommand, or unset CI if this is a developer machine.`);
|
|
118
|
+
}
|
|
119
|
+
return { engage: true };
|
|
120
|
+
}
|
|
121
|
+
function refuse(refusal, reason) {
|
|
122
|
+
return { engage: false, refusal, reason };
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Is an environment variable set to something meaning "yes"?
|
|
126
|
+
*
|
|
127
|
+
* `CI=false` and `CI=0` are set by people trying to turn CI mode OFF, and a
|
|
128
|
+
* bare `!== undefined` test would read both as "yes, this is CI" — refusing
|
|
129
|
+
* the TUI to a developer who explicitly asked not to be treated as one. An
|
|
130
|
+
* empty value is likewise an unset variable that a shell happens to export,
|
|
131
|
+
* the same reading config.ts gives `APPCTL_TOKEN=`.
|
|
132
|
+
*/
|
|
133
|
+
function isEnvFlagSet(value) {
|
|
134
|
+
if (value === undefined)
|
|
135
|
+
return false;
|
|
136
|
+
const normalised = value.trim().toLowerCase();
|
|
137
|
+
return (normalised.length > 0 && normalised !== '0' && normalised !== 'false' && normalised !== 'no');
|
|
138
|
+
}
|
|
139
|
+
//# sourceMappingURL=tty.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tty.js","sourceRoot":"","sources":["../../../src/engine/tui/tty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEjD,gFAAgF;AAChF,4DAA4D;AAC5D,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,iDAAiD;AACjD,EAAE;AACF,yEAAyE;AACzE,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,cAAc;AACd,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,+EAA+E;AAC/E,6DAA6D;AAC7D,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,mEAAmE;AACnE,6EAA6E;AAC7E,wCAAwC;AACxC,EAAE;AACF,gFAAgF;AAChF,qEAAqE;AACrE,gFAAgF;AAChF,0EAA0E;AAC1E,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,yEAAyE;AACzE,sBAAsB;AACtB,gFAAgF;AAEhF,kFAAkF;AAClF,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAgDD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,MAAM,GAAG,GAAG,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAE1C,yEAAyE;IACzE,6EAA6E;IAC7E,2DAA2D;IAC3D,IAAI,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CACX,UAAU,EACV,GAAG,WAAW,EAAE,mFAAmF,CACpG,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,2EAA2E;IAC3E,6EAA6E;IAC7E,4EAA4E;IAC5E,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,MAAM,CACX,kBAAkB,EAClB,iIAAiI,OAAO,EAAE,gCAAgC,CAC3K,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,6EAA6E;IAC7E,2EAA2E;IAC3E,0EAA0E;IAC1E,4EAA4E;IAC5E,4EAA4E;IAC5E,yDAAyD;IACzD,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,MAAM,CACX,iBAAiB,EACjB,0FAA0F,OAAO,EAAE,gCAAgC,CACpI,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,6DAA6D;IAC7D,EAAE;IACF,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,6EAA6E;IAC7E,4EAA4E;IAC5E,qEAAqE;IACrE,uEAAuE;IACvE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,KAAK,GACT,IAAI,KAAK,MAAM;YACb,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,gDAAgD;YACtE,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,+CAA+C,CAAC;QAC7G,OAAO,MAAM,CACX,eAAe,EACf,GAAG,KAAK,WAAW,OAAO,EAAE,yEAAyE,CACtG,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,yEAAyE;IACzE,2EAA2E;IAC3E,2EAA2E;IAC3E,oBAAoB;IACpB,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACrE,OAAO,MAAM,CACX,IAAI,EACJ,kJAAkJ,CACnJ,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,MAAM,CAAC,OAAmB,EAAE,MAAc;IACjD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,YAAY,CAAC,KAAyB;IAC7C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,CACL,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,IAAI,CAC7F,CAAC;AACJ,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The npm name of this package, which holds the platform's CLI: its commands,
|
|
3
|
+
* TUI, deploy pipeline and worker-node engine.
|
|
4
|
+
*
|
|
5
|
+
* @stability experimental
|
|
6
|
+
*/
|
|
7
|
+
export declare const PLATFORM_PACKAGE: "@marinoscar/platform-cli";
|
|
8
|
+
export { API_PATH_PREFIX, EXIT, PLATFORM_CLI_VERSION, cliDisplayName, cliIdentity, cliName, cliVersion, configDirName, configFileName, createCli, envPrefix, envVar, exitCodeFor, formatError, hasCliIdentity, resolveCliIdentity, run, setCliIdentity, toEnvPrefix, versionText, } from './engine/index.js';
|
|
9
|
+
export type { CliIdentity, CliInstance, CreateCliOptions, CreateCliProxyOptions, ExitCode, ResolvedCliIdentity, RunOptions, TtyContext, TtyLike, } from './engine/index.js';
|
|
10
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAG,0BAAmC,CAAC;AAIpE,OAAO,EACL,eAAe,EACf,IAAI,EACJ,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,OAAO,EACP,UAAU,EACV,aAAa,EACb,cAAc,EACd,SAAS,EACT,SAAS,EACT,MAAM,EACN,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,GAAG,EACH,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,OAAO,GACR,MAAM,mBAAmB,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The npm name of this package, which holds the platform's CLI: its commands,
|
|
3
|
+
* TUI, deploy pipeline and worker-node engine.
|
|
4
|
+
*
|
|
5
|
+
* @stability experimental
|
|
6
|
+
*/
|
|
7
|
+
export const PLATFORM_PACKAGE = '@marinoscar/platform-cli';
|
|
8
|
+
// `@marinoscar/platform-cli`: build an app's CLI (#715). The app's
|
|
9
|
+
// `src/cli.ts` calls `createCli({ identity, version, ... })` and runs it.
|
|
10
|
+
export { API_PATH_PREFIX, EXIT, PLATFORM_CLI_VERSION, cliDisplayName, cliIdentity, cliName, cliVersion, configDirName, configFileName, createCli, envPrefix, envVar, exitCodeFor, formatError, hasCliIdentity, resolveCliIdentity, run, setCliIdentity, toEnvPrefix, versionText, } from './engine/index.js';
|
|
11
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAAmC,CAAC;AAEpE,mEAAmE;AACnE,0EAA0E;AAC1E,OAAO,EACL,eAAe,EACf,IAAI,EACJ,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,OAAO,EACP,UAAU,EACV,aAAa,EACb,cAAc,EACd,SAAS,EACT,SAAS,EACT,MAAM,EACN,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,GAAG,EACH,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC"}
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
export { ExecutorRegistry, NODE_APP_SPAN_NAME_PATTERN, binaryCapability, evaluateCapabilities, isNodeSpanName, probeCapabilities, registerJobRequirement, registerProbedBinary, runStartupSelfTest, sanitizeExtraVitals, defaultExecutorRegistry, defaultExecutors, listRegisteredNodeExecutors, registerNodeExecutor, } from '../engine/index.js';
|
|
2
|
+
export type { Capability, CapabilityGap, CapabilityProbe, JobRequirementInput, JobTypeRequirements, SelfTestOptions, SelfTestResult, NodeSpanAttributes, NodeSpanName, ProbedBinaryOptions, ClaimToken, DownloadUrlResult, ExecutorNodeApi, JobExecutionContext, JobExecutor, JobSecret, NodeJob, UploadUrlResult, } from '../engine/index.js';
|
|
3
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,OAAO,EACP,eAAe,GAChB,MAAM,oBAAoB,CAAC"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
// `@marinoscar/platform-cli/node`: the worker node's executor contract and
|
|
2
|
+
// registry (#715). An app adds a node-eligible job type with
|
|
3
|
+
// `registerNodeExecutor` (or `createCli({ nodeExecutors })`).
|
|
4
|
+
export { ExecutorRegistry, NODE_APP_SPAN_NAME_PATTERN, binaryCapability, evaluateCapabilities, isNodeSpanName, probeCapabilities, registerJobRequirement, registerProbedBinary, runStartupSelfTest, sanitizeExtraVitals, defaultExecutorRegistry, defaultExecutors, listRegisteredNodeExecutors, registerNodeExecutor, } from '../engine/index.js';
|
|
5
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6DAA6D;AAC7D,8DAA8D;AAC9D,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import type { EnvSpecFragment, EnvVarMetadata } from '../core/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* The feature group every telemetry key belongs to. A host CLI that gates
|
|
4
|
+
* keys by group must know it.
|
|
5
|
+
*
|
|
6
|
+
* @stability experimental
|
|
7
|
+
*/
|
|
8
|
+
export type TelemetryEnvGroup = 'observability';
|
|
9
|
+
/**
|
|
10
|
+
* One telemetry key's annotation: the platform's `EnvVarMetadata`, always in
|
|
11
|
+
* {@link TelemetryEnvGroup}.
|
|
12
|
+
*
|
|
13
|
+
* @stability experimental
|
|
14
|
+
*/
|
|
15
|
+
export interface TelemetryEnvVarMetadata extends EnvVarMetadata {
|
|
16
|
+
/** Always `observability`. */
|
|
17
|
+
group: TelemetryEnvGroup;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* The shape of {@link telemetryEnvSpecFragment}: an `EnvSpecFragment` whose
|
|
21
|
+
* entries all name {@link TelemetryEnvGroup}, so a host can check at compile
|
|
22
|
+
* time that it knows the group.
|
|
23
|
+
*
|
|
24
|
+
* @stability experimental
|
|
25
|
+
*/
|
|
26
|
+
export interface TelemetryEnvSpecFragment extends EnvSpecFragment {
|
|
27
|
+
/** Always `telemetry`. */
|
|
28
|
+
readonly id: 'telemetry';
|
|
29
|
+
/** Annotations by key; every entry carries `group: 'observability'`. */
|
|
30
|
+
readonly metadata: Readonly<Record<string, TelemetryEnvVarMetadata>>;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* The env-spec fragment for the telemetry stack: the PostgreSQL monitor login,
|
|
34
|
+
* the OpenTelemetry exporter settings and the GreptimeDB store.
|
|
35
|
+
*
|
|
36
|
+
* Register it once with `registerEnvSpecFragment(telemetryEnvSpecFragment)`.
|
|
37
|
+
*
|
|
38
|
+
* @example
|
|
39
|
+
* ```ts
|
|
40
|
+
* registerEnvSpecFragment(telemetryEnvSpecFragment); // the reference CLI: platform-host/register.ts
|
|
41
|
+
* ```
|
|
42
|
+
*
|
|
43
|
+
* @extensionPoint option
|
|
44
|
+
* @stability experimental
|
|
45
|
+
*/
|
|
46
|
+
export declare const telemetryEnvSpecFragment: TelemetryEnvSpecFragment;
|
|
47
|
+
//# sourceMappingURL=env-fragment.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-fragment.d.ts","sourceRoot":"","sources":["../../src/telemetry/env-fragment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYxE;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC7D,8BAA8B;IAC9B,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;CACtE;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,EAAE,wBA2DtC,CAAC"}
|