@marinoscar/platform-cli 0.1.0-next.3 → 0.1.0-next.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +88 -0
- package/README.md +126 -31
- package/dist/android/build.d.ts +30 -0
- package/dist/android/build.d.ts.map +1 -0
- package/dist/android/build.js +126 -0
- package/dist/android/build.js.map +1 -0
- package/dist/android/command.d.ts +21 -0
- package/dist/android/command.d.ts.map +1 -0
- package/dist/android/command.js +355 -0
- package/dist/android/command.js.map +1 -0
- package/dist/android/deploy-step.d.ts +85 -0
- package/dist/android/deploy-step.d.ts.map +1 -0
- package/dist/android/deploy-step.js +268 -0
- package/dist/android/deploy-step.js.map +1 -0
- package/dist/android/doctor.d.ts +47 -0
- package/dist/android/doctor.d.ts.map +1 -0
- package/dist/android/doctor.js +219 -0
- package/dist/android/doctor.js.map +1 -0
- package/dist/android/exec.d.ts +42 -0
- package/dist/android/exec.d.ts.map +1 -0
- package/dist/android/exec.js +103 -0
- package/dist/android/exec.js.map +1 -0
- package/dist/android/fix-plan.d.ts +44 -0
- package/dist/android/fix-plan.d.ts.map +1 -0
- package/dist/android/fix-plan.js +86 -0
- package/dist/android/fix-plan.js.map +1 -0
- package/dist/android/git-freshness.d.ts +34 -0
- package/dist/android/git-freshness.d.ts.map +1 -0
- package/dist/android/git-freshness.js +120 -0
- package/dist/android/git-freshness.js.map +1 -0
- package/dist/android/gradle.d.ts +32 -0
- package/dist/android/gradle.d.ts.map +1 -0
- package/dist/android/gradle.js +55 -0
- package/dist/android/gradle.js.map +1 -0
- package/dist/android/identity.d.ts +27 -0
- package/dist/android/identity.d.ts.map +1 -0
- package/dist/android/identity.js +60 -0
- package/dist/android/identity.js.map +1 -0
- package/dist/android/index.d.ts +7 -0
- package/dist/android/index.d.ts.map +1 -0
- package/dist/android/index.js +8 -0
- package/dist/android/index.js.map +1 -0
- package/dist/android/installer.d.ts +28 -0
- package/dist/android/installer.d.ts.map +1 -0
- package/dist/android/installer.js +96 -0
- package/dist/android/installer.js.map +1 -0
- package/dist/android/java.d.ts +26 -0
- package/dist/android/java.d.ts.map +1 -0
- package/dist/android/java.js +65 -0
- package/dist/android/java.js.map +1 -0
- package/dist/android/keystore.d.ts +54 -0
- package/dist/android/keystore.d.ts.map +1 -0
- package/dist/android/keystore.js +159 -0
- package/dist/android/keystore.js.map +1 -0
- package/dist/android/metadata.d.ts +39 -0
- package/dist/android/metadata.d.ts.map +1 -0
- package/dist/android/metadata.js +61 -0
- package/dist/android/metadata.js.map +1 -0
- package/dist/android/operations.d.ts +42 -0
- package/dist/android/operations.d.ts.map +1 -0
- package/dist/android/operations.js +59 -0
- package/dist/android/operations.js.map +1 -0
- package/dist/android/paths.d.ts +29 -0
- package/dist/android/paths.d.ts.map +1 -0
- package/dist/android/paths.js +97 -0
- package/dist/android/paths.js.map +1 -0
- package/dist/android/publish.d.ts +37 -0
- package/dist/android/publish.d.ts.map +1 -0
- package/dist/android/publish.js +119 -0
- package/dist/android/publish.js.map +1 -0
- package/dist/android/registrations.d.ts +92 -0
- package/dist/android/registrations.d.ts.map +1 -0
- package/dist/android/registrations.js +112 -0
- package/dist/android/registrations.js.map +1 -0
- package/dist/android/release-status.d.ts +73 -0
- package/dist/android/release-status.d.ts.map +1 -0
- package/dist/android/release-status.js +161 -0
- package/dist/android/release-status.js.map +1 -0
- package/dist/android/release.d.ts +33 -0
- package/dist/android/release.d.ts.map +1 -0
- package/dist/android/release.js +59 -0
- package/dist/android/release.js.map +1 -0
- package/dist/android/screen-layout.d.ts +26 -0
- package/dist/android/screen-layout.d.ts.map +1 -0
- package/dist/android/screen-layout.js +24 -0
- package/dist/android/screen-layout.js.map +1 -0
- package/dist/android/screen-model.d.ts +56 -0
- package/dist/android/screen-model.d.ts.map +1 -0
- package/dist/android/screen-model.js +207 -0
- package/dist/android/screen-model.js.map +1 -0
- package/dist/android/screen.d.ts +8 -0
- package/dist/android/screen.d.ts.map +1 -0
- package/dist/android/screen.js +395 -0
- package/dist/android/screen.js.map +1 -0
- package/dist/android/sdk.d.ts +48 -0
- package/dist/android/sdk.d.ts.map +1 -0
- package/dist/android/sdk.js +82 -0
- package/dist/android/sdk.js.map +1 -0
- package/dist/android/server-url.d.ts +19 -0
- package/dist/android/server-url.d.ts.map +1 -0
- package/dist/android/server-url.js +36 -0
- package/dist/android/server-url.js.map +1 -0
- package/dist/android/upload-progress.d.ts +3 -0
- package/dist/android/upload-progress.d.ts.map +1 -0
- package/dist/android/upload-progress.js +47 -0
- package/dist/android/upload-progress.js.map +1 -0
- package/dist/android/version.d.ts +47 -0
- package/dist/android/version.d.ts.map +1 -0
- package/dist/android/version.js +136 -0
- package/dist/android/version.js.map +1 -0
- package/dist/api-client/index.d.ts +3 -0
- package/dist/api-client/index.d.ts.map +1 -0
- package/dist/api-client/index.js +5 -0
- package/dist/api-client/index.js.map +1 -0
- package/dist/commands/index.d.ts +52 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/index.js +63 -0
- package/dist/commands/index.js.map +1 -0
- package/dist/core/cli-registry.d.ts +41 -0
- package/dist/core/cli-registry.d.ts.map +1 -0
- package/dist/core/cli-registry.js +49 -0
- package/dist/core/cli-registry.js.map +1 -0
- package/dist/core/command-registry.d.ts +10 -0
- package/dist/core/command-registry.d.ts.map +1 -1
- package/dist/core/command-registry.js +17 -0
- package/dist/core/command-registry.js.map +1 -1
- package/dist/core/env-annotation-registry.d.ts +58 -0
- package/dist/core/env-annotation-registry.d.ts.map +1 -0
- package/dist/core/env-annotation-registry.js +80 -0
- package/dist/core/env-annotation-registry.js.map +1 -0
- package/dist/core/env-generator-registry.d.ts +59 -0
- package/dist/core/env-generator-registry.d.ts.map +1 -0
- package/dist/core/env-generator-registry.js +102 -0
- package/dist/core/env-generator-registry.js.map +1 -0
- package/dist/core/env-group-registry.d.ts +65 -0
- package/dist/core/env-group-registry.d.ts.map +1 -0
- package/dist/core/env-group-registry.js +77 -0
- package/dist/core/env-group-registry.js.map +1 -0
- package/dist/core/env-spec-registry.d.ts +16 -2
- package/dist/core/env-spec-registry.d.ts.map +1 -1
- package/dist/core/env-spec-registry.js +15 -0
- package/dist/core/env-spec-registry.js.map +1 -1
- package/dist/core/env-values.d.ts +3 -2
- package/dist/core/env-values.d.ts.map +1 -1
- package/dist/core/env-values.js +5 -3
- package/dist/core/env-values.js.map +1 -1
- package/dist/core/index.d.ts +10 -2
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +6 -2
- package/dist/core/index.js.map +1 -1
- package/dist/deploy/index.d.ts +3 -0
- package/dist/deploy/index.d.ts.map +1 -0
- package/dist/deploy/index.js +5 -0
- package/dist/deploy/index.js.map +1 -0
- package/dist/engine/api-client.d.ts +211 -0
- package/dist/engine/api-client.d.ts.map +1 -0
- package/dist/engine/api-client.js +350 -0
- package/dist/engine/api-client.js.map +1 -0
- package/dist/engine/browser.d.ts +18 -0
- package/dist/engine/browser.d.ts.map +1 -0
- package/dist/engine/browser.js +115 -0
- package/dist/engine/browser.js.map +1 -0
- package/dist/engine/builtin-registrations.d.ts +20 -0
- package/dist/engine/builtin-registrations.d.ts.map +1 -0
- package/dist/engine/builtin-registrations.js +86 -0
- package/dist/engine/builtin-registrations.js.map +1 -0
- package/dist/engine/commands/api.d.ts +88 -0
- package/dist/engine/commands/api.d.ts.map +1 -0
- package/dist/engine/commands/api.js +398 -0
- package/dist/engine/commands/api.js.map +1 -0
- package/dist/engine/commands/config.d.ts +5 -0
- package/dist/engine/commands/config.d.ts.map +1 -0
- package/dist/engine/commands/config.js +83 -0
- package/dist/engine/commands/config.js.map +1 -0
- package/dist/engine/commands/deploy.d.ts +243 -0
- package/dist/engine/commands/deploy.d.ts.map +1 -0
- package/dist/engine/commands/deploy.js +1159 -0
- package/dist/engine/commands/deploy.js.map +1 -0
- package/dist/engine/commands/init.d.ts +18 -0
- package/dist/engine/commands/init.d.ts.map +1 -0
- package/dist/engine/commands/init.js +50 -0
- package/dist/engine/commands/init.js.map +1 -0
- package/dist/engine/commands/login.d.ts +4 -0
- package/dist/engine/commands/login.d.ts.map +1 -0
- package/dist/engine/commands/login.js +205 -0
- package/dist/engine/commands/login.js.map +1 -0
- package/dist/engine/commands/node.d.ts +21 -0
- package/dist/engine/commands/node.d.ts.map +1 -0
- package/dist/engine/commands/node.js +436 -0
- package/dist/engine/commands/node.js.map +1 -0
- package/dist/engine/config.d.ts +246 -0
- package/dist/engine/config.d.ts.map +1 -0
- package/dist/engine/config.js +414 -0
- package/dist/engine/config.js.map +1 -0
- package/dist/engine/conformance.d.ts +187 -0
- package/dist/engine/conformance.d.ts.map +1 -0
- package/dist/engine/conformance.js +227 -0
- package/dist/engine/conformance.js.map +1 -0
- package/dist/engine/create-cli.d.ts +94 -0
- package/dist/engine/create-cli.d.ts.map +1 -0
- package/dist/engine/create-cli.js +60 -0
- package/dist/engine/create-cli.js.map +1 -0
- package/dist/engine/deploy/about.d.ts +12 -0
- package/dist/engine/deploy/about.d.ts.map +1 -0
- package/dist/engine/deploy/about.js +110 -0
- package/dist/engine/deploy/about.js.map +1 -0
- package/dist/engine/deploy/adopt.d.ts +21 -0
- package/dist/engine/deploy/adopt.d.ts.map +1 -0
- package/dist/engine/deploy/adopt.js +78 -0
- package/dist/engine/deploy/adopt.js.map +1 -0
- package/dist/engine/deploy/answers-file.d.ts +7 -0
- package/dist/engine/deploy/answers-file.d.ts.map +1 -0
- package/dist/engine/deploy/answers-file.js +49 -0
- package/dist/engine/deploy/answers-file.js.map +1 -0
- package/dist/engine/deploy/app-role.d.ts +278 -0
- package/dist/engine/deploy/app-role.d.ts.map +1 -0
- package/dist/engine/deploy/app-role.js +826 -0
- package/dist/engine/deploy/app-role.js.map +1 -0
- package/dist/engine/deploy/app-version.d.ts +47 -0
- package/dist/engine/deploy/app-version.d.ts.map +1 -0
- package/dist/engine/deploy/app-version.js +232 -0
- package/dist/engine/deploy/app-version.js.map +1 -0
- package/dist/engine/deploy/checks/database.d.ts +83 -0
- package/dist/engine/deploy/checks/database.d.ts.map +1 -0
- package/dist/engine/deploy/checks/database.js +455 -0
- package/dist/engine/deploy/checks/database.js.map +1 -0
- package/dist/engine/deploy/checks/dns.d.ts +3 -0
- package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
- package/dist/engine/deploy/checks/dns.js +85 -0
- package/dist/engine/deploy/checks/dns.js.map +1 -0
- package/dist/engine/deploy/checks/host.d.ts +19 -0
- package/dist/engine/deploy/checks/host.d.ts.map +1 -0
- package/dist/engine/deploy/checks/host.js +530 -0
- package/dist/engine/deploy/checks/host.js.map +1 -0
- package/dist/engine/deploy/checks/index.d.ts +33 -0
- package/dist/engine/deploy/checks/index.d.ts.map +1 -0
- package/dist/engine/deploy/checks/index.js +67 -0
- package/dist/engine/deploy/checks/index.js.map +1 -0
- package/dist/engine/deploy/checks/registry.d.ts +102 -0
- package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
- package/dist/engine/deploy/checks/registry.js +103 -0
- package/dist/engine/deploy/checks/registry.js.map +1 -0
- package/dist/engine/deploy/checks/source.d.ts +45 -0
- package/dist/engine/deploy/checks/source.d.ts.map +1 -0
- package/dist/engine/deploy/checks/source.js +175 -0
- package/dist/engine/deploy/checks/source.js.map +1 -0
- package/dist/engine/deploy/checks/tls.d.ts +87 -0
- package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
- package/dist/engine/deploy/checks/tls.js +552 -0
- package/dist/engine/deploy/checks/tls.js.map +1 -0
- package/dist/engine/deploy/checks/types.d.ts +178 -0
- package/dist/engine/deploy/checks/types.d.ts.map +1 -0
- package/dist/engine/deploy/checks/types.js +199 -0
- package/dist/engine/deploy/checks/types.js.map +1 -0
- package/dist/engine/deploy/compose-files.d.ts +29 -0
- package/dist/engine/deploy/compose-files.d.ts.map +1 -0
- package/dist/engine/deploy/compose-files.js +118 -0
- package/dist/engine/deploy/compose-files.js.map +1 -0
- package/dist/engine/deploy/consent.d.ts +29 -0
- package/dist/engine/deploy/consent.d.ts.map +1 -0
- package/dist/engine/deploy/consent.js +35 -0
- package/dist/engine/deploy/consent.js.map +1 -0
- package/dist/engine/deploy/database-drop.d.ts +22 -0
- package/dist/engine/deploy/database-drop.d.ts.map +1 -0
- package/dist/engine/deploy/database-drop.js +135 -0
- package/dist/engine/deploy/database-drop.js.map +1 -0
- package/dist/engine/deploy/database.d.ts +116 -0
- package/dist/engine/deploy/database.d.ts.map +1 -0
- package/dist/engine/deploy/database.js +252 -0
- package/dist/engine/deploy/database.js.map +1 -0
- package/dist/engine/deploy/deploy-info.d.ts +48 -0
- package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
- package/dist/engine/deploy/deploy-info.js +163 -0
- package/dist/engine/deploy/deploy-info.js.map +1 -0
- package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
- package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
- package/dist/engine/deploy/deployment-evidence.js +92 -0
- package/dist/engine/deploy/deployment-evidence.js.map +1 -0
- package/dist/engine/deploy/edge-config.d.ts +103 -0
- package/dist/engine/deploy/edge-config.d.ts.map +1 -0
- package/dist/engine/deploy/edge-config.js +170 -0
- package/dist/engine/deploy/edge-config.js.map +1 -0
- package/dist/engine/deploy/env-absence.d.ts +61 -0
- package/dist/engine/deploy/env-absence.d.ts.map +1 -0
- package/dist/engine/deploy/env-absence.js +33 -0
- package/dist/engine/deploy/env-absence.js.map +1 -0
- package/dist/engine/deploy/env-file.d.ts +14 -0
- package/dist/engine/deploy/env-file.d.ts.map +1 -0
- package/dist/engine/deploy/env-file.js +58 -0
- package/dist/engine/deploy/env-file.js.map +1 -0
- package/dist/engine/deploy/env-fragments.d.ts +29 -0
- package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
- package/dist/engine/deploy/env-fragments.js +73 -0
- package/dist/engine/deploy/env-fragments.js.map +1 -0
- package/dist/engine/deploy/env-metadata.d.ts +73 -0
- package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
- package/dist/engine/deploy/env-metadata.js +227 -0
- package/dist/engine/deploy/env-metadata.js.map +1 -0
- package/dist/engine/deploy/env-spec.d.ts +75 -0
- package/dist/engine/deploy/env-spec.d.ts.map +1 -0
- package/dist/engine/deploy/env-spec.js +239 -0
- package/dist/engine/deploy/env-spec.js.map +1 -0
- package/dist/engine/deploy/env-wizard.d.ts +56 -0
- package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
- package/dist/engine/deploy/env-wizard.js +235 -0
- package/dist/engine/deploy/env-wizard.js.map +1 -0
- package/dist/engine/deploy/executor.d.ts +81 -0
- package/dist/engine/deploy/executor.d.ts.map +1 -0
- package/dist/engine/deploy/executor.js +247 -0
- package/dist/engine/deploy/executor.js.map +1 -0
- package/dist/engine/deploy/health.d.ts +146 -0
- package/dist/engine/deploy/health.d.ts.map +1 -0
- package/dist/engine/deploy/health.js +323 -0
- package/dist/engine/deploy/health.js.map +1 -0
- package/dist/engine/deploy/hooks.d.ts +66 -0
- package/dist/engine/deploy/hooks.d.ts.map +1 -0
- package/dist/engine/deploy/hooks.js +19 -0
- package/dist/engine/deploy/hooks.js.map +1 -0
- package/dist/engine/deploy/host-facts.d.ts +23 -0
- package/dist/engine/deploy/host-facts.d.ts.map +1 -0
- package/dist/engine/deploy/host-facts.js +67 -0
- package/dist/engine/deploy/host-facts.js.map +1 -0
- package/dist/engine/deploy/install.d.ts +233 -0
- package/dist/engine/deploy/install.d.ts.map +1 -0
- package/dist/engine/deploy/install.js +1304 -0
- package/dist/engine/deploy/install.js.map +1 -0
- package/dist/engine/deploy/inventory.d.ts +30 -0
- package/dist/engine/deploy/inventory.d.ts.map +1 -0
- package/dist/engine/deploy/inventory.js +122 -0
- package/dist/engine/deploy/inventory.js.map +1 -0
- package/dist/engine/deploy/journal.d.ts +77 -0
- package/dist/engine/deploy/journal.d.ts.map +1 -0
- package/dist/engine/deploy/journal.js +221 -0
- package/dist/engine/deploy/journal.js.map +1 -0
- package/dist/engine/deploy/layout.d.ts +77 -0
- package/dist/engine/deploy/layout.d.ts.map +1 -0
- package/dist/engine/deploy/layout.js +191 -0
- package/dist/engine/deploy/layout.js.map +1 -0
- package/dist/engine/deploy/oauth-check.d.ts +58 -0
- package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
- package/dist/engine/deploy/oauth-check.js +213 -0
- package/dist/engine/deploy/oauth-check.js.map +1 -0
- package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
- package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
- package/dist/engine/deploy/proxy-bootstrap.js +416 -0
- package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
- package/dist/engine/deploy/proxy-streams.d.ts +110 -0
- package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
- package/dist/engine/deploy/proxy-streams.js +208 -0
- package/dist/engine/deploy/proxy-streams.js.map +1 -0
- package/dist/engine/deploy/proxy.d.ts +375 -0
- package/dist/engine/deploy/proxy.d.ts.map +1 -0
- package/dist/engine/deploy/proxy.js +758 -0
- package/dist/engine/deploy/proxy.js.map +1 -0
- package/dist/engine/deploy/renewal.d.ts +54 -0
- package/dist/engine/deploy/renewal.d.ts.map +1 -0
- package/dist/engine/deploy/renewal.js +169 -0
- package/dist/engine/deploy/renewal.js.map +1 -0
- package/dist/engine/deploy/repo.d.ts +101 -0
- package/dist/engine/deploy/repo.d.ts.map +1 -0
- package/dist/engine/deploy/repo.js +250 -0
- package/dist/engine/deploy/repo.js.map +1 -0
- package/dist/engine/deploy/run-record.d.ts +28 -0
- package/dist/engine/deploy/run-record.d.ts.map +1 -0
- package/dist/engine/deploy/run-record.js +44 -0
- package/dist/engine/deploy/run-record.js.map +1 -0
- package/dist/engine/deploy/state.d.ts +262 -0
- package/dist/engine/deploy/state.d.ts.map +1 -0
- package/dist/engine/deploy/state.js +163 -0
- package/dist/engine/deploy/state.js.map +1 -0
- package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
- package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
- package/dist/engine/deploy/steps/app-step-context.js +45 -0
- package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
- package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
- package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
- package/dist/engine/deploy/steps/pipeline.js +73 -0
- package/dist/engine/deploy/steps/pipeline.js.map +1 -0
- package/dist/engine/deploy/steps/plan.d.ts +28 -0
- package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
- package/dist/engine/deploy/steps/plan.js +32 -0
- package/dist/engine/deploy/steps/plan.js.map +1 -0
- package/dist/engine/deploy/steps/registry.d.ts +182 -0
- package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
- package/dist/engine/deploy/steps/registry.js +212 -0
- package/dist/engine/deploy/steps/registry.js.map +1 -0
- package/dist/engine/deploy/steps/step-values.d.ts +28 -0
- package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
- package/dist/engine/deploy/steps/step-values.js +33 -0
- package/dist/engine/deploy/steps/step-values.js.map +1 -0
- package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
- package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
- package/dist/engine/deploy/testing/fake-postgres.js +236 -0
- package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
- package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
- package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
- package/dist/engine/deploy/testing/fake-vps.js +365 -0
- package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
- package/dist/engine/deploy/uninstall.d.ts +87 -0
- package/dist/engine/deploy/uninstall.d.ts.map +1 -0
- package/dist/engine/deploy/uninstall.js +320 -0
- package/dist/engine/deploy/uninstall.js.map +1 -0
- package/dist/engine/deploy/update.d.ts +111 -0
- package/dist/engine/deploy/update.d.ts.map +1 -0
- package/dist/engine/deploy/update.js +1228 -0
- package/dist/engine/deploy/update.js.map +1 -0
- package/dist/engine/deploy/version-step.d.ts +65 -0
- package/dist/engine/deploy/version-step.d.ts.map +1 -0
- package/dist/engine/deploy/version-step.js +176 -0
- package/dist/engine/deploy/version-step.js.map +1 -0
- package/dist/engine/device-auth.d.ts +240 -0
- package/dist/engine/device-auth.d.ts.map +1 -0
- package/dist/engine/device-auth.js +442 -0
- package/dist/engine/device-auth.js.map +1 -0
- package/dist/engine/device-login.d.ts +126 -0
- package/dist/engine/device-login.d.ts.map +1 -0
- package/dist/engine/device-login.js +164 -0
- package/dist/engine/device-login.js.map +1 -0
- package/dist/engine/errors.d.ts +314 -0
- package/dist/engine/errors.d.ts.map +1 -0
- package/dist/engine/errors.js +561 -0
- package/dist/engine/errors.js.map +1 -0
- package/dist/engine/identity.d.ts +169 -0
- package/dist/engine/identity.d.ts.map +1 -0
- package/dist/engine/identity.js +227 -0
- package/dist/engine/identity.js.map +1 -0
- package/dist/engine/index.d.ts +104 -0
- package/dist/engine/index.d.ts.map +1 -0
- package/dist/engine/index.js +126 -0
- package/dist/engine/index.js.map +1 -0
- package/dist/engine/init/local-profile.d.ts +93 -0
- package/dist/engine/init/local-profile.d.ts.map +1 -0
- package/dist/engine/init/local-profile.js +295 -0
- package/dist/engine/init/local-profile.js.map +1 -0
- package/dist/engine/init/run-init.d.ts +41 -0
- package/dist/engine/init/run-init.d.ts.map +1 -0
- package/dist/engine/init/run-init.js +297 -0
- package/dist/engine/init/run-init.js.map +1 -0
- package/dist/engine/node/capabilities.d.ts +238 -0
- package/dist/engine/node/capabilities.d.ts.map +1 -0
- package/dist/engine/node/capabilities.js +316 -0
- package/dist/engine/node/capabilities.js.map +1 -0
- package/dist/engine/node/daemon.d.ts +63 -0
- package/dist/engine/node/daemon.d.ts.map +1 -0
- package/dist/engine/node/daemon.js +227 -0
- package/dist/engine/node/daemon.js.map +1 -0
- package/dist/engine/node/doctor.d.ts +58 -0
- package/dist/engine/node/doctor.d.ts.map +1 -0
- package/dist/engine/node/doctor.js +394 -0
- package/dist/engine/node/doctor.js.map +1 -0
- package/dist/engine/node/enrollment.d.ts +98 -0
- package/dist/engine/node/enrollment.d.ts.map +1 -0
- package/dist/engine/node/enrollment.js +189 -0
- package/dist/engine/node/enrollment.js.map +1 -0
- package/dist/engine/node/env-flags.d.ts +5 -0
- package/dist/engine/node/env-flags.d.ts.map +1 -0
- package/dist/engine/node/env-flags.js +22 -0
- package/dist/engine/node/env-flags.js.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.js +189 -0
- package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
- package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
- package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
- package/dist/engine/node/executors/db-backup-run.js +362 -0
- package/dist/engine/node/executors/db-backup-run.js.map +1 -0
- package/dist/engine/node/executors/example-checksum.d.ts +30 -0
- package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
- package/dist/engine/node/executors/example-checksum.js +56 -0
- package/dist/engine/node/executors/example-checksum.js.map +1 -0
- package/dist/engine/node/executors/index.d.ts +168 -0
- package/dist/engine/node/executors/index.d.ts.map +1 -0
- package/dist/engine/node/executors/index.js +44 -0
- package/dist/engine/node/executors/index.js.map +1 -0
- package/dist/engine/node/executors/registry.d.ts +38 -0
- package/dist/engine/node/executors/registry.d.ts.map +1 -0
- package/dist/engine/node/executors/registry.js +92 -0
- package/dist/engine/node/executors/registry.js.map +1 -0
- package/dist/engine/node/heap-snapshot.d.ts +37 -0
- package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
- package/dist/engine/node/heap-snapshot.js +160 -0
- package/dist/engine/node/heap-snapshot.js.map +1 -0
- package/dist/engine/node/install-deps.d.ts +73 -0
- package/dist/engine/node/install-deps.d.ts.map +1 -0
- package/dist/engine/node/install-deps.js +150 -0
- package/dist/engine/node/install-deps.js.map +1 -0
- package/dist/engine/node/ipc-protocol.d.ts +67 -0
- package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
- package/dist/engine/node/ipc-protocol.js +83 -0
- package/dist/engine/node/ipc-protocol.js.map +1 -0
- package/dist/engine/node/lifecycle.d.ts +103 -0
- package/dist/engine/node/lifecycle.d.ts.map +1 -0
- package/dist/engine/node/lifecycle.js +259 -0
- package/dist/engine/node/lifecycle.js.map +1 -0
- package/dist/engine/node/logger.d.ts +82 -0
- package/dist/engine/node/logger.d.ts.map +1 -0
- package/dist/engine/node/logger.js +241 -0
- package/dist/engine/node/logger.js.map +1 -0
- package/dist/engine/node/memory-watchdog.d.ts +78 -0
- package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
- package/dist/engine/node/memory-watchdog.js +224 -0
- package/dist/engine/node/memory-watchdog.js.map +1 -0
- package/dist/engine/node/node-api.d.ts +391 -0
- package/dist/engine/node/node-api.d.ts.map +1 -0
- package/dist/engine/node/node-api.js +123 -0
- package/dist/engine/node/node-api.js.map +1 -0
- package/dist/engine/node/node-config.d.ts +128 -0
- package/dist/engine/node/node-config.d.ts.map +1 -0
- package/dist/engine/node/node-config.js +237 -0
- package/dist/engine/node/node-config.js.map +1 -0
- package/dist/engine/node/node-dashboard-source.d.ts +56 -0
- package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
- package/dist/engine/node/node-dashboard-source.js +213 -0
- package/dist/engine/node/node-dashboard-source.js.map +1 -0
- package/dist/engine/node/node-engine.d.ts +229 -0
- package/dist/engine/node/node-engine.d.ts.map +1 -0
- package/dist/engine/node/node-engine.js +723 -0
- package/dist/engine/node/node-engine.js.map +1 -0
- package/dist/engine/node/node-errors.d.ts +54 -0
- package/dist/engine/node/node-errors.d.ts.map +1 -0
- package/dist/engine/node/node-errors.js +71 -0
- package/dist/engine/node/node-errors.js.map +1 -0
- package/dist/engine/node/node-events.d.ts +132 -0
- package/dist/engine/node/node-events.d.ts.map +1 -0
- package/dist/engine/node/node-events.js +2 -0
- package/dist/engine/node/node-events.js.map +1 -0
- package/dist/engine/node/node-vitals.d.ts +123 -0
- package/dist/engine/node/node-vitals.d.ts.map +1 -0
- package/dist/engine/node/node-vitals.js +266 -0
- package/dist/engine/node/node-vitals.js.map +1 -0
- package/dist/engine/node/paths.d.ts +39 -0
- package/dist/engine/node/paths.d.ts.map +1 -0
- package/dist/engine/node/paths.js +60 -0
- package/dist/engine/node/paths.js.map +1 -0
- package/dist/engine/node/pg-dump.d.ts +126 -0
- package/dist/engine/node/pg-dump.d.ts.map +1 -0
- package/dist/engine/node/pg-dump.js +223 -0
- package/dist/engine/node/pg-dump.js.map +1 -0
- package/dist/engine/node/pidfile.d.ts +38 -0
- package/dist/engine/node/pidfile.d.ts.map +1 -0
- package/dist/engine/node/pidfile.js +156 -0
- package/dist/engine/node/pidfile.js.map +1 -0
- package/dist/engine/node/runtime-tuning.d.ts +65 -0
- package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
- package/dist/engine/node/runtime-tuning.js +198 -0
- package/dist/engine/node/runtime-tuning.js.map +1 -0
- package/dist/engine/node/service.d.ts +39 -0
- package/dist/engine/node/service.d.ts.map +1 -0
- package/dist/engine/node/service.js +211 -0
- package/dist/engine/node/service.js.map +1 -0
- package/dist/engine/node/start.d.ts +62 -0
- package/dist/engine/node/start.d.ts.map +1 -0
- package/dist/engine/node/start.js +245 -0
- package/dist/engine/node/start.js.map +1 -0
- package/dist/engine/node/worker-env-table.d.ts +15 -0
- package/dist/engine/node/worker-env-table.d.ts.map +1 -0
- package/dist/engine/node/worker-env-table.js +97 -0
- package/dist/engine/node/worker-env-table.js.map +1 -0
- package/dist/engine/node/worker-env.d.ts +50 -0
- package/dist/engine/node/worker-env.d.ts.map +1 -0
- package/dist/engine/node/worker-env.js +101 -0
- package/dist/engine/node/worker-env.js.map +1 -0
- package/dist/engine/output.d.ts +97 -0
- package/dist/engine/output.d.ts.map +1 -0
- package/dist/engine/output.js +274 -0
- package/dist/engine/output.js.map +1 -0
- package/dist/engine/package-info.d.ts +7 -0
- package/dist/engine/package-info.d.ts.map +1 -0
- package/dist/engine/package-info.js +38 -0
- package/dist/engine/package-info.js.map +1 -0
- package/dist/engine/program.d.ts +50 -0
- package/dist/engine/program.d.ts.map +1 -0
- package/dist/engine/program.js +197 -0
- package/dist/engine/program.js.map +1 -0
- package/dist/engine/prompt.d.ts +69 -0
- package/dist/engine/prompt.d.ts.map +1 -0
- package/dist/engine/prompt.js +205 -0
- package/dist/engine/prompt.js.map +1 -0
- package/dist/engine/registries.d.ts +5 -0
- package/dist/engine/registries.d.ts.map +1 -0
- package/dist/engine/registries.js +52 -0
- package/dist/engine/registries.js.map +1 -0
- package/dist/engine/request-body.d.ts +31 -0
- package/dist/engine/request-body.d.ts.map +1 -0
- package/dist/engine/request-body.js +156 -0
- package/dist/engine/request-body.js.map +1 -0
- package/dist/engine/test-support.d.ts +50 -0
- package/dist/engine/test-support.d.ts.map +1 -0
- package/dist/engine/test-support.js +86 -0
- package/dist/engine/test-support.js.map +1 -0
- package/dist/engine/tui/app.d.ts +3 -0
- package/dist/engine/tui/app.d.ts.map +1 -0
- package/dist/engine/tui/app.js +100 -0
- package/dist/engine/tui/app.js.map +1 -0
- package/dist/engine/tui/builtin-screens.d.ts +6 -0
- package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
- package/dist/engine/tui/builtin-screens.js +54 -0
- package/dist/engine/tui/builtin-screens.js.map +1 -0
- package/dist/engine/tui/index.d.ts +23 -0
- package/dist/engine/tui/index.d.ts.map +1 -0
- package/dist/engine/tui/index.js +71 -0
- package/dist/engine/tui/index.js.map +1 -0
- package/dist/engine/tui/layout.d.ts +132 -0
- package/dist/engine/tui/layout.d.ts.map +1 -0
- package/dist/engine/tui/layout.js +200 -0
- package/dist/engine/tui/layout.js.map +1 -0
- package/dist/engine/tui/routes.d.ts +5 -0
- package/dist/engine/tui/routes.d.ts.map +1 -0
- package/dist/engine/tui/routes.js +16 -0
- package/dist/engine/tui/routes.js.map +1 -0
- package/dist/engine/tui/screen-registry.d.ts +100 -0
- package/dist/engine/tui/screen-registry.d.ts.map +1 -0
- package/dist/engine/tui/screen-registry.js +96 -0
- package/dist/engine/tui/screen-registry.js.map +1 -0
- package/dist/engine/tui/screen-sections.d.ts +9 -0
- package/dist/engine/tui/screen-sections.d.ts.map +1 -0
- package/dist/engine/tui/screen-sections.js +45 -0
- package/dist/engine/tui/screen-sections.js.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.js +153 -0
- package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.js +202 -0
- package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
- package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
- package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/index.js +83 -0
- package/dist/engine/tui/screens/deploy/index.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.js +319 -0
- package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install.js +361 -0
- package/dist/engine/tui/screens/deploy/install.js.map +1 -0
- package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
- package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/model.js +59 -0
- package/dist/engine/tui/screens/deploy/model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.js +117 -0
- package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
- package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run.js +201 -0
- package/dist/engine/tui/screens/deploy/run.js.map +1 -0
- package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
- package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/status.js +107 -0
- package/dist/engine/tui/screens/deploy/status.js.map +1 -0
- package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
- package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/update.js +175 -0
- package/dist/engine/tui/screens/deploy/update.js.map +1 -0
- package/dist/engine/tui/screens/deploy.d.ts +12 -0
- package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy.js +23 -0
- package/dist/engine/tui/screens/deploy.js.map +1 -0
- package/dist/engine/tui/screens/invoke.d.ts +6 -0
- package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
- package/dist/engine/tui/screens/invoke.js +193 -0
- package/dist/engine/tui/screens/invoke.js.map +1 -0
- package/dist/engine/tui/screens/login.d.ts +6 -0
- package/dist/engine/tui/screens/login.d.ts.map +1 -0
- package/dist/engine/tui/screens/login.js +255 -0
- package/dist/engine/tui/screens/login.js.map +1 -0
- package/dist/engine/tui/screens/logout.d.ts +6 -0
- package/dist/engine/tui/screens/logout.d.ts.map +1 -0
- package/dist/engine/tui/screens/logout.js +142 -0
- package/dist/engine/tui/screens/logout.js.map +1 -0
- package/dist/engine/tui/screens/menu.d.ts +22 -0
- package/dist/engine/tui/screens/menu.d.ts.map +1 -0
- package/dist/engine/tui/screens/menu.js +84 -0
- package/dist/engine/tui/screens/menu.js.map +1 -0
- package/dist/engine/tui/screens/node.d.ts +6 -0
- package/dist/engine/tui/screens/node.d.ts.map +1 -0
- package/dist/engine/tui/screens/node.js +228 -0
- package/dist/engine/tui/screens/node.js.map +1 -0
- package/dist/engine/tui/screens/status.d.ts +6 -0
- package/dist/engine/tui/screens/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/status.js +134 -0
- package/dist/engine/tui/screens/status.js.map +1 -0
- package/dist/engine/tui/scroll-box.d.ts +27 -0
- package/dist/engine/tui/scroll-box.d.ts.map +1 -0
- package/dist/engine/tui/scroll-box.js +52 -0
- package/dist/engine/tui/scroll-box.js.map +1 -0
- package/dist/engine/tui/section-registry.d.ts +65 -0
- package/dist/engine/tui/section-registry.d.ts.map +1 -0
- package/dist/engine/tui/section-registry.js +90 -0
- package/dist/engine/tui/section-registry.js.map +1 -0
- package/dist/engine/tui/terminal.d.ts +31 -0
- package/dist/engine/tui/terminal.d.ts.map +1 -0
- package/dist/engine/tui/terminal.js +142 -0
- package/dist/engine/tui/terminal.js.map +1 -0
- package/dist/engine/tui/tty.d.ts +49 -0
- package/dist/engine/tui/tty.d.ts.map +1 -0
- package/dist/engine/tui/tty.js +139 -0
- package/dist/engine/tui/tty.js.map +1 -0
- package/dist/index.d.ts +4 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -5
- package/dist/index.js.map +1 -1
- package/dist/node/index.d.ts +3 -0
- package/dist/node/index.d.ts.map +1 -0
- package/dist/node/index.js +5 -0
- package/dist/node/index.js.map +1 -0
- package/dist/telemetry/index.d.ts +2 -1
- package/dist/telemetry/index.d.ts.map +1 -1
- package/dist/telemetry/index.js +1 -0
- package/dist/telemetry/index.js.map +1 -1
- package/dist/telemetry/node-span-relay.d.ts +1 -1
- package/dist/telemetry/node-span-relay.d.ts.map +1 -1
- package/dist/telemetry/node-span-relay.js +39 -6
- package/dist/telemetry/node-span-relay.js.map +1 -1
- package/dist/telemetry/node-span.d.ts +39 -7
- package/dist/telemetry/node-span.d.ts.map +1 -1
- package/dist/telemetry/node-span.js +19 -1
- package/dist/telemetry/node-span.js.map +1 -1
- package/dist/testing/index.d.ts +3 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +4 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/tui/index.d.ts +3 -0
- package/dist/tui/index.d.ts.map +1 -0
- package/dist/tui/index.js +5 -0
- package/dist/tui/index.js.map +1 -0
- package/package.json +43 -5
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { registerApiCommand as registerApi, registerConfigCommand as registerConfig, registerDeployCommand as registerDeploy, registerInitCommand as registerInit, registerLoginCommand as registerLogin, registerNodeCommand as registerNode, } from '../engine/index.js';
|
|
2
|
+
export { BUILTIN_COMMAND_NAMES, CliError, ConfigError, EXIT, PreconditionError, UsageError, exitCodeFor, formatError, } from '../engine/index.js';
|
|
3
|
+
/**
|
|
4
|
+
* Adds `init`: creates `infra/compose/.env` so a fresh checkout can start.
|
|
5
|
+
*
|
|
6
|
+
* @param program - The host program.
|
|
7
|
+
* @returns The `init` command.
|
|
8
|
+
* @stability stable
|
|
9
|
+
*/
|
|
10
|
+
export function registerInitCommand(program) {
|
|
11
|
+
return registerInit(program);
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Adds `login`: authorizes this machine (device flow, or `--token`) and stores the token.
|
|
15
|
+
*
|
|
16
|
+
* @param program - The host program.
|
|
17
|
+
* @returns The `login` command.
|
|
18
|
+
* @stability stable
|
|
19
|
+
*/
|
|
20
|
+
export function registerLoginCommand(program) {
|
|
21
|
+
return registerLogin(program);
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Adds `api <method> <path>`: calls any API endpoint and prints the response.
|
|
25
|
+
*
|
|
26
|
+
* @param program - The host program.
|
|
27
|
+
* @returns The `api` command.
|
|
28
|
+
* @stability stable
|
|
29
|
+
*/
|
|
30
|
+
export function registerApiCommand(program) {
|
|
31
|
+
return registerApi(program);
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Adds `config`: shows the stored server URL and a masked token hint.
|
|
35
|
+
*
|
|
36
|
+
* @param program - The host program.
|
|
37
|
+
* @returns The `config` command.
|
|
38
|
+
* @stability stable
|
|
39
|
+
*/
|
|
40
|
+
export function registerConfigCommand(program) {
|
|
41
|
+
return registerConfig(program);
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Adds `node`: runs this machine as a worker node for the job queue.
|
|
45
|
+
*
|
|
46
|
+
* @param program - The host program.
|
|
47
|
+
* @returns The `node` command group.
|
|
48
|
+
* @stability stable
|
|
49
|
+
*/
|
|
50
|
+
export function registerNodeCommand(program) {
|
|
51
|
+
return registerNode(program);
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Adds `deploy`: checks, installs and updates the application on a server.
|
|
55
|
+
*
|
|
56
|
+
* @param program - The host program.
|
|
57
|
+
* @returns The `deploy` command group.
|
|
58
|
+
* @stability stable
|
|
59
|
+
*/
|
|
60
|
+
export function registerDeployCommand(program) {
|
|
61
|
+
return registerDeploy(program);
|
|
62
|
+
}
|
|
63
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,kBAAkB,IAAI,WAAW,EACjC,qBAAqB,IAAI,cAAc,EACvC,qBAAqB,IAAI,cAAc,EACvC,mBAAmB,IAAI,YAAY,EACnC,oBAAoB,IAAI,aAAa,EACrC,mBAAmB,IAAI,YAAY,GACpC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAG5B;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* An id-keyed registry with the CLI's freeze-after-build rule.
|
|
3
|
+
*
|
|
4
|
+
* @stability experimental
|
|
5
|
+
*/
|
|
6
|
+
export interface CliRegistry<T> {
|
|
7
|
+
/** Adds an entry; throws on a duplicate id, a failed validation or after the freeze. */
|
|
8
|
+
register(entry: T): void;
|
|
9
|
+
/** Every entry, in registration order. A frozen copy. */
|
|
10
|
+
list(): readonly T[];
|
|
11
|
+
/** The entry with this id, or undefined. */
|
|
12
|
+
get(id: string): T | undefined;
|
|
13
|
+
/** Refuses every later registration; `createCli` calls it. */
|
|
14
|
+
freeze(by: string): void;
|
|
15
|
+
/** Empties and unfreezes. Tests only. */
|
|
16
|
+
reset(): void;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Options of {@link createCliRegistry}.
|
|
20
|
+
*
|
|
21
|
+
* @stability experimental
|
|
22
|
+
*/
|
|
23
|
+
export interface CliRegistryOptions<T> {
|
|
24
|
+
/** What the entries are called in errors, e.g. `deploy check`. */
|
|
25
|
+
name: string;
|
|
26
|
+
/** The registration function's name, named in the late-registration error. */
|
|
27
|
+
registerFn: string;
|
|
28
|
+
/** The entry's unique id. */
|
|
29
|
+
idOf: (entry: T) => string;
|
|
30
|
+
/** Throws (with a clear message) when the entry is unusable. */
|
|
31
|
+
validate?: ((entry: T) => void) | undefined;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Builds a {@link CliRegistry}.
|
|
35
|
+
*
|
|
36
|
+
* @param options - The entry name, the register function's name, the id and the validator.
|
|
37
|
+
* @returns The registry.
|
|
38
|
+
* @stability experimental
|
|
39
|
+
*/
|
|
40
|
+
export declare function createCliRegistry<T>(options: CliRegistryOptions<T>): CliRegistry<T>;
|
|
41
|
+
//# sourceMappingURL=cli-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-registry.d.ts","sourceRoot":"","sources":["../../src/core/cli-registry.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACzB,yDAAyD;IACzD,IAAI,IAAI,SAAS,CAAC,EAAE,CAAC;IACrB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC/B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CA8BnF"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
// =============================================================================
|
|
2
|
+
// A small id-keyed registry for the CLI's extension points (PP-14.22)
|
|
3
|
+
// =============================================================================
|
|
4
|
+
//
|
|
5
|
+
// The CLI's registries (commands, env-spec fragments, TUI screens, deploy
|
|
6
|
+
// steps, node executors) are module-level lists that `createCli` freezes once
|
|
7
|
+
// the CLI is built. The extension points added by PP-14.22 (env groups, deploy
|
|
8
|
+
// checks, proxy stream paths, edge-config files, compose modes, TUI sections,
|
|
9
|
+
// env generators, CLI conformance suites) share this one shape instead of
|
|
10
|
+
// repeating it eight times: string ids, a duplicate-id error, registration
|
|
11
|
+
// order, a freeze and a test reset.
|
|
12
|
+
// =============================================================================
|
|
13
|
+
/**
|
|
14
|
+
* Builds a {@link CliRegistry}.
|
|
15
|
+
*
|
|
16
|
+
* @param options - The entry name, the register function's name, the id and the validator.
|
|
17
|
+
* @returns The registry.
|
|
18
|
+
* @stability experimental
|
|
19
|
+
*/
|
|
20
|
+
export function createCliRegistry(options) {
|
|
21
|
+
const entries = [];
|
|
22
|
+
let frozenBy;
|
|
23
|
+
return {
|
|
24
|
+
register(entry) {
|
|
25
|
+
options.validate?.(entry);
|
|
26
|
+
const id = options.idOf(entry);
|
|
27
|
+
if (frozenBy !== undefined) {
|
|
28
|
+
throw new Error(`${options.registerFn}("${String(id)}") was called after ${frozenBy}; register the ${options.name} before (or pass it to createCli).`);
|
|
29
|
+
}
|
|
30
|
+
if (typeof id !== 'string' || id === '') {
|
|
31
|
+
throw new Error(`A ${options.name} needs a non-empty id.`);
|
|
32
|
+
}
|
|
33
|
+
if (entries.some((existing) => options.idOf(existing) === id)) {
|
|
34
|
+
throw new Error(`The ${options.name} "${id}" is already registered.`);
|
|
35
|
+
}
|
|
36
|
+
entries.push(entry);
|
|
37
|
+
},
|
|
38
|
+
list: () => Object.freeze([...entries]),
|
|
39
|
+
get: (id) => entries.find((entry) => options.idOf(entry) === id),
|
|
40
|
+
freeze(by) {
|
|
41
|
+
frozenBy = by;
|
|
42
|
+
},
|
|
43
|
+
reset() {
|
|
44
|
+
entries.length = 0;
|
|
45
|
+
frozenBy = undefined;
|
|
46
|
+
},
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=cli-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-registry.js","sourceRoot":"","sources":["../../src/core/cli-registry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uEAAuE;AACvE,gFAAgF;AAChF,EAAE;AACF,0EAA0E;AAC1E,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,0EAA0E;AAC1E,2EAA2E;AAC3E,oCAAoC;AACpC,gFAAgF;AAoChF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAI,OAA8B;IACjE,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,IAAI,QAA4B,CAAC;IACjC,OAAO;QACL,QAAQ,CAAC,KAAK;YACZ,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,EAAE,CAAC,uBAAuB,QAAQ,kBAAkB,OAAO,CAAC,IAAI,oCAAoC,CACtI,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,wBAAwB,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,KAAK,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,EAAE,0BAA0B,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;QACvC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChE,MAAM,CAAC,EAAE;YACP,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,KAAK;YACH,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -47,4 +47,14 @@ export declare function listRegisteredCommands(): readonly CliCommandRegistratio
|
|
|
47
47
|
* @stability experimental
|
|
48
48
|
*/
|
|
49
49
|
export declare function resetCommandRegistryForTests(): void;
|
|
50
|
+
/**
|
|
51
|
+
* Refuses every later registration. `createCli` calls it once the CLI is
|
|
52
|
+
* built, so a command registered too late fails loudly instead of silently
|
|
53
|
+
* missing from `--help`.
|
|
54
|
+
*
|
|
55
|
+
* @param by - Who froze it, named in the error a late registration gets.
|
|
56
|
+
* @internal
|
|
57
|
+
* @stability experimental
|
|
58
|
+
*/
|
|
59
|
+
export declare function freezeCommandRegistry(by: string): void;
|
|
50
60
|
//# sourceMappingURL=command-registry.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;
|
|
1
|
+
{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAQhE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAQzE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAgCjE;AAUD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,sBAAsB,EAAE,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtD"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
/** Commander's implicit help command; an app must never shadow it. */
|
|
2
2
|
const RESERVED_NAMES = ['help'];
|
|
3
3
|
const registrations = [];
|
|
4
|
+
let frozenBy;
|
|
4
5
|
/**
|
|
5
6
|
* Registers a function that adds commands to the host CLI.
|
|
6
7
|
*
|
|
@@ -19,6 +20,9 @@ export function registerCliCommand(register) {
|
|
|
19
20
|
if (typeof register !== 'function') {
|
|
20
21
|
throw new TypeError('registerCliCommand expects a function (program) => void.');
|
|
21
22
|
}
|
|
23
|
+
if (frozenBy !== undefined) {
|
|
24
|
+
throw new Error(`registerCliCommand was called after ${frozenBy}; register app commands before it (or pass them to createCli).`);
|
|
25
|
+
}
|
|
22
26
|
registrations.push(register);
|
|
23
27
|
}
|
|
24
28
|
function namesOf(command) {
|
|
@@ -93,5 +97,18 @@ export function listRegisteredCommands() {
|
|
|
93
97
|
*/
|
|
94
98
|
export function resetCommandRegistryForTests() {
|
|
95
99
|
registrations.length = 0;
|
|
100
|
+
frozenBy = undefined;
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Refuses every later registration. `createCli` calls it once the CLI is
|
|
104
|
+
* built, so a command registered too late fails loudly instead of silently
|
|
105
|
+
* missing from `--help`.
|
|
106
|
+
*
|
|
107
|
+
* @param by - Who froze it, named in the error a late registration gets.
|
|
108
|
+
* @internal
|
|
109
|
+
* @stability experimental
|
|
110
|
+
*/
|
|
111
|
+
export function freezeCommandRegistry(by) {
|
|
112
|
+
frozenBy = by;
|
|
96
113
|
}
|
|
97
114
|
//# sourceMappingURL=command-registry.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":"AA6BA,sEAAsE;AACtE,MAAM,cAAc,GAAsB,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,aAAa,GAA6B,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What an app may set on a key it does not own.
|
|
3
|
+
*
|
|
4
|
+
* @stability experimental
|
|
5
|
+
*/
|
|
6
|
+
export interface EnvKeyAnnotation {
|
|
7
|
+
/** Forced for a VPS deployment: not offered, not overridable by a prompt. Replaces the owner's `fixed`. */
|
|
8
|
+
fixed?: string | undefined;
|
|
9
|
+
/** Shown instead of the template's comment when the wizard asks. Plain text. */
|
|
10
|
+
help?: string | undefined;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Overrides the `fixed` value and/or the `help` text of an environment key,
|
|
14
|
+
* including one a platform fragment owns. The app's value wins; see the module
|
|
15
|
+
* notes for what an annotation cannot change.
|
|
16
|
+
*
|
|
17
|
+
* @param key - The environment variable name.
|
|
18
|
+
* @param annotation - `fixed` and/or `help`.
|
|
19
|
+
* @throws Error on a bad key or value, a key annotated twice, or after `createCli` built the CLI.
|
|
20
|
+
* @stability experimental
|
|
21
|
+
* @extensionPoint registry
|
|
22
|
+
* @example
|
|
23
|
+
* ```ts
|
|
24
|
+
* annotateEnvKey('OTEL_SERVICE_NAME', { fixed: 'coach-api' });
|
|
25
|
+
* annotateEnvKey('EMAIL_FROM', { help: 'The address coaching reminders are sent from.' });
|
|
26
|
+
* ```
|
|
27
|
+
*/
|
|
28
|
+
export declare function annotateEnvKey(key: string, annotation: EnvKeyAnnotation): void;
|
|
29
|
+
/**
|
|
30
|
+
* The app's annotation of `key`, if it made one.
|
|
31
|
+
*
|
|
32
|
+
* @param key - An environment variable name.
|
|
33
|
+
* @stability experimental
|
|
34
|
+
*/
|
|
35
|
+
export declare function getEnvAnnotation(key: string): EnvKeyAnnotation | undefined;
|
|
36
|
+
/**
|
|
37
|
+
* Every annotated key, in registration order.
|
|
38
|
+
*
|
|
39
|
+
* @returns A frozen list of keys.
|
|
40
|
+
* @stability experimental
|
|
41
|
+
*/
|
|
42
|
+
export declare function listEnvAnnotations(): readonly string[];
|
|
43
|
+
/**
|
|
44
|
+
* Refuses later registrations; `createCli` calls it.
|
|
45
|
+
*
|
|
46
|
+
* @param by - Who froze it, named in the error a late registration gets.
|
|
47
|
+
* @internal
|
|
48
|
+
* @stability experimental
|
|
49
|
+
*/
|
|
50
|
+
export declare function freezeEnvAnnotationRegistry(by: string): void;
|
|
51
|
+
/**
|
|
52
|
+
* Empties the registry. Tests only.
|
|
53
|
+
*
|
|
54
|
+
* @internal
|
|
55
|
+
* @stability experimental
|
|
56
|
+
*/
|
|
57
|
+
export declare function resetEnvAnnotationRegistryForTests(): void;
|
|
58
|
+
//# sourceMappingURL=env-annotation-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-annotation-registry.d.ts","sourceRoot":"","sources":["../../src/core/env-annotation-registry.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2GAA2G;IAC3G,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AA+BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { createCliRegistry } from './cli-registry.js';
|
|
2
|
+
const KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
3
|
+
const CONTROL = /[\u0000-\u0008\u000B-\u001F\u007F]/;
|
|
4
|
+
const registry = createCliRegistry({
|
|
5
|
+
name: 'env key annotation',
|
|
6
|
+
registerFn: 'annotateEnvKey',
|
|
7
|
+
idOf: (entry) => entry.key,
|
|
8
|
+
validate: (entry) => {
|
|
9
|
+
if (typeof entry.key !== 'string' || !KEY_PATTERN.test(entry.key)) {
|
|
10
|
+
throw new Error(`Env key ${JSON.stringify(entry.key)} is not a valid environment variable name.`);
|
|
11
|
+
}
|
|
12
|
+
const { fixed, help } = entry.annotation ?? {};
|
|
13
|
+
if (fixed === undefined && help === undefined) {
|
|
14
|
+
throw new Error(`annotateEnvKey("${entry.key}") sets neither fixed nor help.`);
|
|
15
|
+
}
|
|
16
|
+
if (fixed !== undefined && (typeof fixed !== 'string' || /[\r\n\u0000]/.test(fixed) || fixed.length > 1024)) {
|
|
17
|
+
throw new Error(`annotateEnvKey("${entry.key}"): fixed must be a single-line string of at most 1024 characters.`);
|
|
18
|
+
}
|
|
19
|
+
if (help !== undefined && (typeof help !== 'string' || CONTROL.test(help) || help.length > 2000)) {
|
|
20
|
+
throw new Error(`annotateEnvKey("${entry.key}"): help must be plain text (no control characters) of at most 2000 characters.`);
|
|
21
|
+
}
|
|
22
|
+
},
|
|
23
|
+
});
|
|
24
|
+
/**
|
|
25
|
+
* Overrides the `fixed` value and/or the `help` text of an environment key,
|
|
26
|
+
* including one a platform fragment owns. The app's value wins; see the module
|
|
27
|
+
* notes for what an annotation cannot change.
|
|
28
|
+
*
|
|
29
|
+
* @param key - The environment variable name.
|
|
30
|
+
* @param annotation - `fixed` and/or `help`.
|
|
31
|
+
* @throws Error on a bad key or value, a key annotated twice, or after `createCli` built the CLI.
|
|
32
|
+
* @stability experimental
|
|
33
|
+
* @extensionPoint registry
|
|
34
|
+
* @example
|
|
35
|
+
* ```ts
|
|
36
|
+
* annotateEnvKey('OTEL_SERVICE_NAME', { fixed: 'coach-api' });
|
|
37
|
+
* annotateEnvKey('EMAIL_FROM', { help: 'The address coaching reminders are sent from.' });
|
|
38
|
+
* ```
|
|
39
|
+
*/
|
|
40
|
+
export function annotateEnvKey(key, annotation) {
|
|
41
|
+
registry.register(Object.freeze({ key, annotation: Object.freeze({ ...annotation }) }));
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* The app's annotation of `key`, if it made one.
|
|
45
|
+
*
|
|
46
|
+
* @param key - An environment variable name.
|
|
47
|
+
* @stability experimental
|
|
48
|
+
*/
|
|
49
|
+
export function getEnvAnnotation(key) {
|
|
50
|
+
return registry.get(key)?.annotation;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Every annotated key, in registration order.
|
|
54
|
+
*
|
|
55
|
+
* @returns A frozen list of keys.
|
|
56
|
+
* @stability experimental
|
|
57
|
+
*/
|
|
58
|
+
export function listEnvAnnotations() {
|
|
59
|
+
return Object.freeze(registry.list().map((entry) => entry.key));
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Refuses later registrations; `createCli` calls it.
|
|
63
|
+
*
|
|
64
|
+
* @param by - Who froze it, named in the error a late registration gets.
|
|
65
|
+
* @internal
|
|
66
|
+
* @stability experimental
|
|
67
|
+
*/
|
|
68
|
+
export function freezeEnvAnnotationRegistry(by) {
|
|
69
|
+
registry.freeze(by);
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Empties the registry. Tests only.
|
|
73
|
+
*
|
|
74
|
+
* @internal
|
|
75
|
+
* @stability experimental
|
|
76
|
+
*/
|
|
77
|
+
export function resetEnvAnnotationRegistryForTests() {
|
|
78
|
+
registry.reset();
|
|
79
|
+
}
|
|
80
|
+
//# sourceMappingURL=env-annotation-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-annotation-registry.js","sourceRoot":"","sources":["../../src/core/env-annotation-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAoCtD,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAC/C,MAAM,OAAO,GAAG,oCAAoC,CAAC;AAErD,MAAM,QAAQ,GAAG,iBAAiB,CAAQ;IACxC,IAAI,EAAE,oBAAoB;IAC1B,UAAU,EAAE,gBAAgB;IAC5B,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG;IAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QAClB,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,GAAG,iCAAiC,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YAC5G,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,GAAG,oEAAoE,CAAC,CAAC;QACpH,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YACjG,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,GAAG,iFAAiF,CAAC,CAAC;QACjI,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,UAA4B;IACtE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,EAAU;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kCAAkC;IAChD,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A way to make a value.
|
|
3
|
+
*
|
|
4
|
+
* @stability experimental
|
|
5
|
+
*/
|
|
6
|
+
export interface EnvGeneratorRegistration {
|
|
7
|
+
/** Lowercase letters, digits and hyphens: what `EnvVarMetadata.generate` names. */
|
|
8
|
+
kind: string;
|
|
9
|
+
/** Returns a fresh value. Synchronous; draw randomness from `node:crypto`, never `Math.random`. */
|
|
10
|
+
generate(): string;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Registers a kind of generated value for `EnvVarMetadata.generate`.
|
|
14
|
+
*
|
|
15
|
+
* @param generator - The kind and a synchronous function returning a fresh value.
|
|
16
|
+
* @throws Error on a malformed or taken kind (the built-ins `base64-32` and
|
|
17
|
+
* `hex-32` included), or after `createCli` built the CLI.
|
|
18
|
+
* @stability experimental
|
|
19
|
+
* @extensionPoint registry
|
|
20
|
+
* @example
|
|
21
|
+
* ```ts
|
|
22
|
+
* registerEnvGenerator({ kind: 'token-24', generate: () => randomBytes(18).toString('base64url') });
|
|
23
|
+
* registerEnvSpecFragment({ id: 'coach', metadata: { COACH_TOKEN: { secret: true, generate: 'token-24' } } });
|
|
24
|
+
* ```
|
|
25
|
+
*/
|
|
26
|
+
export declare function registerEnvGenerator(generator: EnvGeneratorRegistration): void;
|
|
27
|
+
/**
|
|
28
|
+
* The registered generator kinds, the built-ins first.
|
|
29
|
+
*
|
|
30
|
+
* @returns A frozen copy.
|
|
31
|
+
* @stability experimental
|
|
32
|
+
*/
|
|
33
|
+
export declare function listEnvGenerators(): readonly EnvGeneratorRegistration[];
|
|
34
|
+
/**
|
|
35
|
+
* Makes a value with a registered kind, and checks what came back.
|
|
36
|
+
*
|
|
37
|
+
* @param kind - A registered kind.
|
|
38
|
+
* @returns The generated value.
|
|
39
|
+
* @throws Error when the kind is unknown (naming the registered ones), or the
|
|
40
|
+
* generator returned something that is not a plain value of the safe set.
|
|
41
|
+
* @stability experimental
|
|
42
|
+
*/
|
|
43
|
+
export declare function generateWithKind(kind: string): string;
|
|
44
|
+
/**
|
|
45
|
+
* Refuses later registrations; `createCli` calls it.
|
|
46
|
+
*
|
|
47
|
+
* @param by - Who froze it, named in the error a late registration gets.
|
|
48
|
+
* @internal
|
|
49
|
+
* @stability experimental
|
|
50
|
+
*/
|
|
51
|
+
export declare function freezeEnvGeneratorRegistry(by: string): void;
|
|
52
|
+
/**
|
|
53
|
+
* Restores the built-ins only and unfreezes. Tests only.
|
|
54
|
+
*
|
|
55
|
+
* @internal
|
|
56
|
+
* @stability experimental
|
|
57
|
+
*/
|
|
58
|
+
export declare function resetEnvGeneratorRegistryForTests(): void;
|
|
59
|
+
//# sourceMappingURL=env-generator-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-generator-registry.d.ts","sourceRoot":"","sources":["../../src/core/env-generator-registry.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,QAAQ,IAAI,MAAM,CAAC;CACpB;AAkCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,wBAAwB,EAAE,CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBrD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAGxD"}
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
import { randomBytes } from 'node:crypto';
|
|
2
|
+
import { createCliRegistry } from './cli-registry.js';
|
|
3
|
+
const KIND_PATTERN = /^[a-z][a-z0-9-]*$/;
|
|
4
|
+
/** What a generated value may contain: it lands in a `.env` file and in Compose interpolation. */
|
|
5
|
+
const SAFE_VALUE = /^[A-Za-z0-9+/=_.:@-]{1,512}$/;
|
|
6
|
+
const BUILTIN = Object.freeze([
|
|
7
|
+
{
|
|
8
|
+
kind: 'base64-32',
|
|
9
|
+
// 32 random bytes, standard base64 (AES-256 keys, JWT secrets).
|
|
10
|
+
generate: () => randomBytes(32).toString('base64'),
|
|
11
|
+
},
|
|
12
|
+
{
|
|
13
|
+
kind: 'hex-32',
|
|
14
|
+
// 32 random bytes as lowercase hex: for syntaxes that reserve base64's characters.
|
|
15
|
+
generate: () => randomBytes(32).toString('hex'),
|
|
16
|
+
},
|
|
17
|
+
]);
|
|
18
|
+
const registry = createCliRegistry({
|
|
19
|
+
name: 'env generator',
|
|
20
|
+
registerFn: 'registerEnvGenerator',
|
|
21
|
+
idOf: (generator) => generator.kind,
|
|
22
|
+
validate: (generator) => {
|
|
23
|
+
if (typeof generator?.kind !== 'string' || !KIND_PATTERN.test(generator.kind)) {
|
|
24
|
+
throw new Error(`Env generator kind ${JSON.stringify(generator?.kind)} is invalid: use lowercase letters, digits and hyphens.`);
|
|
25
|
+
}
|
|
26
|
+
if (typeof generator.generate !== 'function') {
|
|
27
|
+
throw new Error(`Env generator "${generator.kind}" needs a generate function returning a string.`);
|
|
28
|
+
}
|
|
29
|
+
},
|
|
30
|
+
});
|
|
31
|
+
for (const generator of BUILTIN)
|
|
32
|
+
registry.register(generator);
|
|
33
|
+
/**
|
|
34
|
+
* Registers a kind of generated value for `EnvVarMetadata.generate`.
|
|
35
|
+
*
|
|
36
|
+
* @param generator - The kind and a synchronous function returning a fresh value.
|
|
37
|
+
* @throws Error on a malformed or taken kind (the built-ins `base64-32` and
|
|
38
|
+
* `hex-32` included), or after `createCli` built the CLI.
|
|
39
|
+
* @stability experimental
|
|
40
|
+
* @extensionPoint registry
|
|
41
|
+
* @example
|
|
42
|
+
* ```ts
|
|
43
|
+
* registerEnvGenerator({ kind: 'token-24', generate: () => randomBytes(18).toString('base64url') });
|
|
44
|
+
* registerEnvSpecFragment({ id: 'coach', metadata: { COACH_TOKEN: { secret: true, generate: 'token-24' } } });
|
|
45
|
+
* ```
|
|
46
|
+
*/
|
|
47
|
+
export function registerEnvGenerator(generator) {
|
|
48
|
+
registry.register(Object.freeze({ kind: generator.kind, generate: generator.generate }));
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* The registered generator kinds, the built-ins first.
|
|
52
|
+
*
|
|
53
|
+
* @returns A frozen copy.
|
|
54
|
+
* @stability experimental
|
|
55
|
+
*/
|
|
56
|
+
export function listEnvGenerators() {
|
|
57
|
+
return registry.list();
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Makes a value with a registered kind, and checks what came back.
|
|
61
|
+
*
|
|
62
|
+
* @param kind - A registered kind.
|
|
63
|
+
* @returns The generated value.
|
|
64
|
+
* @throws Error when the kind is unknown (naming the registered ones), or the
|
|
65
|
+
* generator returned something that is not a plain value of the safe set.
|
|
66
|
+
* @stability experimental
|
|
67
|
+
*/
|
|
68
|
+
export function generateWithKind(kind) {
|
|
69
|
+
const generator = registry.get(kind);
|
|
70
|
+
if (generator === undefined) {
|
|
71
|
+
throw new Error(`Unknown env generator kind "${kind}". Registered: ${registry.list().map((entry) => entry.kind).join(', ')}. ` +
|
|
72
|
+
'Register it with registerEnvGenerator (before createCli).');
|
|
73
|
+
}
|
|
74
|
+
const value = generator.generate();
|
|
75
|
+
if (typeof value !== 'string' || !SAFE_VALUE.test(value)) {
|
|
76
|
+
throw new Error(`Env generator "${kind}" returned a value that cannot be written to a .env file: ` +
|
|
77
|
+
'use 1 to 512 characters from letters, digits and + / = _ . : @ - only.');
|
|
78
|
+
}
|
|
79
|
+
return value;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Refuses later registrations; `createCli` calls it.
|
|
83
|
+
*
|
|
84
|
+
* @param by - Who froze it, named in the error a late registration gets.
|
|
85
|
+
* @internal
|
|
86
|
+
* @stability experimental
|
|
87
|
+
*/
|
|
88
|
+
export function freezeEnvGeneratorRegistry(by) {
|
|
89
|
+
registry.freeze(by);
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Restores the built-ins only and unfreezes. Tests only.
|
|
93
|
+
*
|
|
94
|
+
* @internal
|
|
95
|
+
* @stability experimental
|
|
96
|
+
*/
|
|
97
|
+
export function resetEnvGeneratorRegistryForTests() {
|
|
98
|
+
registry.reset();
|
|
99
|
+
for (const generator of BUILTIN)
|
|
100
|
+
registry.register(generator);
|
|
101
|
+
}
|
|
102
|
+
//# sourceMappingURL=env-generator-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-generator-registry.js","sourceRoot":"","sources":["../../src/core/env-generator-registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One feature group of env keys.
|
|
3
|
+
*
|
|
4
|
+
* @stability experimental
|
|
5
|
+
*/
|
|
6
|
+
export interface EnvGroupRegistration {
|
|
7
|
+
/** Lowercase letters, digits and hyphens. What `--group` and `EnvVarMetadata.group` name. */
|
|
8
|
+
id: string;
|
|
9
|
+
/** Short name shown by the wizard. */
|
|
10
|
+
label: string;
|
|
11
|
+
/** One sentence: what turning the group on adds. */
|
|
12
|
+
description: string;
|
|
13
|
+
/**
|
|
14
|
+
* Enabled for every deployment unless the group is not wanted: added to the
|
|
15
|
+
* requested or recorded groups by `effectiveGroups`, like the telemetry
|
|
16
|
+
* group. `false` makes the group opt-in.
|
|
17
|
+
*/
|
|
18
|
+
defaultEnabled: boolean;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Registers an opt-in group of env keys. The deploy wizard (and the TUI's
|
|
22
|
+
* install form) lists it, `--group <id>` enables it, and an env-spec fragment
|
|
23
|
+
* puts keys in it with `group: '<id>'`.
|
|
24
|
+
*
|
|
25
|
+
* @param group - The id, label, description and whether it is on by default.
|
|
26
|
+
* @throws Error on a malformed or duplicate id, or after `createCli` built the CLI.
|
|
27
|
+
* @stability experimental
|
|
28
|
+
* @extensionPoint registry
|
|
29
|
+
* @example
|
|
30
|
+
* ```ts
|
|
31
|
+
* registerEnvGroup({ id: 'coach', label: 'Coach', description: 'The coaching assistant.', defaultEnabled: false });
|
|
32
|
+
* registerEnvSpecFragment({ id: 'coach', metadata: { COACH_API_TOKEN: { group: 'coach', secret: true } } });
|
|
33
|
+
* ```
|
|
34
|
+
*/
|
|
35
|
+
export declare function registerEnvGroup(group: EnvGroupRegistration): void;
|
|
36
|
+
/**
|
|
37
|
+
* The registered groups, built-ins first, then in registration order.
|
|
38
|
+
*
|
|
39
|
+
* @returns A frozen copy.
|
|
40
|
+
* @stability experimental
|
|
41
|
+
*/
|
|
42
|
+
export declare function listEnvGroups(): readonly EnvGroupRegistration[];
|
|
43
|
+
/**
|
|
44
|
+
* A registered group, or undefined.
|
|
45
|
+
*
|
|
46
|
+
* @param id - The group id.
|
|
47
|
+
* @stability experimental
|
|
48
|
+
*/
|
|
49
|
+
export declare function getEnvGroup(id: string): EnvGroupRegistration | undefined;
|
|
50
|
+
/**
|
|
51
|
+
* Refuses later registrations; `createCli` calls it.
|
|
52
|
+
*
|
|
53
|
+
* @param by - Who froze it, named in the error a late registration gets.
|
|
54
|
+
* @internal
|
|
55
|
+
* @stability experimental
|
|
56
|
+
*/
|
|
57
|
+
export declare function freezeEnvGroupRegistry(by: string): void;
|
|
58
|
+
/**
|
|
59
|
+
* Empties the registry. Tests only.
|
|
60
|
+
*
|
|
61
|
+
* @internal
|
|
62
|
+
* @stability experimental
|
|
63
|
+
*/
|
|
64
|
+
export declare function resetEnvGroupRegistryForTests(): void;
|
|
65
|
+
//# sourceMappingURL=env-group-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"env-group-registry.d.ts","sourceRoot":"","sources":["../../src/core/env-group-registry.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,6FAA6F;IAC7F,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAwBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,SAAS,oBAAoB,EAAE,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}
|