@marinoscar/platform-cli 0.1.0-next.3 → 0.1.0-next.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +80 -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,350 @@
|
|
|
1
|
+
import { API_PATH_PREFIX, cliName, cliVersion } from './identity.js';
|
|
2
|
+
import { ApiError, NetworkError, UsageError } from './errors.js';
|
|
3
|
+
/**
|
|
4
|
+
* 30 seconds.
|
|
5
|
+
*
|
|
6
|
+
* A default timeout is not a nicety. Node's `fetch` has NO timeout of its own:
|
|
7
|
+
* a connection to a host that accepts and then says nothing — a hung load
|
|
8
|
+
* balancer, a suspended container, a firewall that blackholes instead of
|
|
9
|
+
* rejecting — hangs forever. In an interactive shell that is annoying; in CI
|
|
10
|
+
* it burns the entire job budget and reports as a timeout of the whole
|
|
11
|
+
* pipeline rather than as an unreachable API.
|
|
12
|
+
*
|
|
13
|
+
* Generous enough for a cold-started server behind a proxy, short enough to
|
|
14
|
+
* fail inside anybody's CI step limit. #142's polling passes its own value.
|
|
15
|
+
*
|
|
16
|
+
* @stability experimental
|
|
17
|
+
*/
|
|
18
|
+
export const DEFAULT_TIMEOUT_MS = 30_000;
|
|
19
|
+
/**
|
|
20
|
+
* The CLI's HTTP client for the platform API: bearer auth, the response
|
|
21
|
+
* envelope, a timeout on every call, and `ApiError` / `NetworkError` on
|
|
22
|
+
* failure, never a raw `fetch` exception.
|
|
23
|
+
*
|
|
24
|
+
* @stability experimental
|
|
25
|
+
*/
|
|
26
|
+
export class ApiClient {
|
|
27
|
+
baseUrl;
|
|
28
|
+
token;
|
|
29
|
+
timeoutMs;
|
|
30
|
+
fetchImpl;
|
|
31
|
+
constructor(options) {
|
|
32
|
+
// Trailing slashes are stripped ONCE, here, rather than defended against
|
|
33
|
+
// at every call site. `http://h/api/` + `/auth/me` naively concatenated is
|
|
34
|
+
// `http://h/api//auth/me`, and a double slash is not cosmetic — Fastify
|
|
35
|
+
// treats it as a distinct path and answers 404, which reads to the user as
|
|
36
|
+
// "that endpoint does not exist" rather than "your base URL had a slash".
|
|
37
|
+
this.baseUrl = options.baseUrl.replace(/\/+$/, '');
|
|
38
|
+
if (this.baseUrl.length === 0) {
|
|
39
|
+
throw new UsageError('A server base URL is required.');
|
|
40
|
+
}
|
|
41
|
+
this.token = options.token;
|
|
42
|
+
this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
|
|
43
|
+
// Bound to `globalThis`. An unbound `globalThis.fetch` passed around as a
|
|
44
|
+
// value throws "Illegal invocation" when called with the wrong receiver.
|
|
45
|
+
this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
|
|
46
|
+
}
|
|
47
|
+
/** GET. */
|
|
48
|
+
get(path, options) {
|
|
49
|
+
return this.request('GET', path, options);
|
|
50
|
+
}
|
|
51
|
+
/** POST with a JSON body. */
|
|
52
|
+
post(path, body, options) {
|
|
53
|
+
return this.request('POST', path, { ...options, body });
|
|
54
|
+
}
|
|
55
|
+
/** PATCH — the API's JSON Merge Patch endpoints. */
|
|
56
|
+
patch(path, body, options) {
|
|
57
|
+
return this.request('PATCH', path, { ...options, body });
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* PUT. Not named in #140, included because the settings endpoints are
|
|
61
|
+
* replace-semantics PUTs and a client that cannot express them would force
|
|
62
|
+
* the first caller to reach for `send()` and reinvent the header handling.
|
|
63
|
+
*/
|
|
64
|
+
put(path, body, options) {
|
|
65
|
+
return this.request('PUT', path, { ...options, body });
|
|
66
|
+
}
|
|
67
|
+
/** DELETE. Most of the API's DELETEs answer 204, so `T` is usually void. */
|
|
68
|
+
delete(path, options) {
|
|
69
|
+
return this.request('DELETE', path, options);
|
|
70
|
+
}
|
|
71
|
+
/** Any method, returning just the unwrapped payload. */
|
|
72
|
+
async request(method, path, options = {}) {
|
|
73
|
+
const response = await this.send(method, path, options);
|
|
74
|
+
return response.data;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* The real implementation: any method, returning status, headers, the
|
|
78
|
+
* unwrapped payload AND the untouched body.
|
|
79
|
+
*/
|
|
80
|
+
async send(method, path, options = {}) {
|
|
81
|
+
const url = buildUrl(this.baseUrl, path, options.query);
|
|
82
|
+
const timeoutMs = options.timeoutMs ?? this.timeoutMs;
|
|
83
|
+
const upperMethod = method.toUpperCase();
|
|
84
|
+
if (options.formData !== undefined && options.body !== undefined) {
|
|
85
|
+
throw new UsageError(`Request for ${upperMethod} ${path} has both a JSON body and form data.`);
|
|
86
|
+
}
|
|
87
|
+
const hasBody = options.body !== undefined;
|
|
88
|
+
const init = {
|
|
89
|
+
method: upperMethod,
|
|
90
|
+
headers: this.buildHeaders(hasBody, options.headers),
|
|
91
|
+
signal: withTimeout(options.signal, timeoutMs),
|
|
92
|
+
};
|
|
93
|
+
if (options.formData !== undefined) {
|
|
94
|
+
init.body = options.formData;
|
|
95
|
+
}
|
|
96
|
+
if (hasBody) {
|
|
97
|
+
// JSON.stringify can throw on a circular structure or a BigInt. That is
|
|
98
|
+
// the caller's mistake, not the server's, so it surfaces as a usage
|
|
99
|
+
// error rather than escaping as a raw TypeError from inside the client.
|
|
100
|
+
try {
|
|
101
|
+
init.body = JSON.stringify(options.body);
|
|
102
|
+
}
|
|
103
|
+
catch (cause) {
|
|
104
|
+
throw new UsageError(`Request body for ${upperMethod} ${path} could not be serialised as JSON.`, { cause });
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
let response;
|
|
108
|
+
try {
|
|
109
|
+
response = await this.fetchImpl(url, init);
|
|
110
|
+
}
|
|
111
|
+
catch (cause) {
|
|
112
|
+
// The one place "could not reach the server" is decided. Everything
|
|
113
|
+
// after this line knows a response exists.
|
|
114
|
+
throw NetworkError.fromCause({
|
|
115
|
+
cause,
|
|
116
|
+
method: upperMethod,
|
|
117
|
+
url,
|
|
118
|
+
timeoutMs,
|
|
119
|
+
callerAborted: options.signal?.aborted === true,
|
|
120
|
+
});
|
|
121
|
+
}
|
|
122
|
+
// `.text()` rather than `.json()`, ALWAYS, for both success and failure.
|
|
123
|
+
// On an error path it is what stops an HTML 502 becoming a SyntaxError
|
|
124
|
+
// (see ApiError.fromBody); on the success path it lets an empty 200 —
|
|
125
|
+
// which some proxies produce — be handled rather than thrown on.
|
|
126
|
+
//
|
|
127
|
+
// Reading the body is itself a network operation and can fail after the
|
|
128
|
+
// headers arrived (a truncated response, a connection dropped mid-stream),
|
|
129
|
+
// so it gets the same NetworkError treatment.
|
|
130
|
+
let rawBody;
|
|
131
|
+
try {
|
|
132
|
+
rawBody = await response.text();
|
|
133
|
+
}
|
|
134
|
+
catch (cause) {
|
|
135
|
+
throw NetworkError.fromCause({
|
|
136
|
+
cause,
|
|
137
|
+
method: upperMethod,
|
|
138
|
+
url,
|
|
139
|
+
timeoutMs,
|
|
140
|
+
callerAborted: options.signal?.aborted === true,
|
|
141
|
+
});
|
|
142
|
+
}
|
|
143
|
+
if (!response.ok) {
|
|
144
|
+
throw ApiError.fromBody({
|
|
145
|
+
status: response.status,
|
|
146
|
+
statusText: response.statusText,
|
|
147
|
+
rawBody,
|
|
148
|
+
method: upperMethod,
|
|
149
|
+
url,
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
// 204 No Content, and an empty body on any status, are legitimate
|
|
153
|
+
// successes. `JSON.parse('')` throws, so this check must come first.
|
|
154
|
+
if (rawBody.trim().length === 0) {
|
|
155
|
+
return {
|
|
156
|
+
status: response.status,
|
|
157
|
+
headers: response.headers,
|
|
158
|
+
data: undefined,
|
|
159
|
+
meta: undefined,
|
|
160
|
+
body: undefined,
|
|
161
|
+
};
|
|
162
|
+
}
|
|
163
|
+
let parsed;
|
|
164
|
+
try {
|
|
165
|
+
parsed = JSON.parse(rawBody);
|
|
166
|
+
}
|
|
167
|
+
catch {
|
|
168
|
+
// A 2xx that is not JSON. Almost always a proxy or an auth portal
|
|
169
|
+
// answering with a login page and a 200, which is worse than an error
|
|
170
|
+
// status because everything downstream assumes success. Reported as an
|
|
171
|
+
// ApiError (the server DID respond) with `structured: false`.
|
|
172
|
+
throw ApiError.fromBody({
|
|
173
|
+
status: response.status,
|
|
174
|
+
statusText: 'Malformed response',
|
|
175
|
+
rawBody,
|
|
176
|
+
method: upperMethod,
|
|
177
|
+
url,
|
|
178
|
+
});
|
|
179
|
+
}
|
|
180
|
+
return {
|
|
181
|
+
status: response.status,
|
|
182
|
+
headers: response.headers,
|
|
183
|
+
data: unwrapEnvelope(parsed),
|
|
184
|
+
meta: extractMeta(parsed),
|
|
185
|
+
body: parsed,
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Headers for one request.
|
|
190
|
+
*
|
|
191
|
+
* `Accept: application/json` is unconditional — without it a
|
|
192
|
+
* content-negotiating proxy is free to hand back HTML, and the failure
|
|
193
|
+
* appears as a parse error rather than as the misconfiguration it is.
|
|
194
|
+
*
|
|
195
|
+
* `Content-Type` is set ONLY when there is a body. Fastify 5 is strict here:
|
|
196
|
+
* declaring a JSON content type on a body-less request makes it try to parse
|
|
197
|
+
* nothing and answer 400. apps/web's client carries the same rule and the
|
|
198
|
+
* same comment; it is a property of the server, not of either client.
|
|
199
|
+
*
|
|
200
|
+
* Caller headers are merged FIRST so Authorization and Accept cannot be
|
|
201
|
+
* clobbered by a caller passing `{ Authorization: ... }` — a device-flow
|
|
202
|
+
* poll that accidentally attached a half-issued token would be an
|
|
203
|
+
* authentication bug that only shows up under load.
|
|
204
|
+
*/
|
|
205
|
+
buildHeaders(hasBody, extra) {
|
|
206
|
+
const headers = {
|
|
207
|
+
...extra,
|
|
208
|
+
Accept: 'application/json',
|
|
209
|
+
// Identifies the client in the API's request logs and, later, in the
|
|
210
|
+
// device-flow `clientInfo.userAgent` (#141) — so a user looking at their
|
|
211
|
+
// Access Tokens page can tell which tool created a token.
|
|
212
|
+
'User-Agent': `${cliName()}/${cliVersion()} (node ${process.version})`,
|
|
213
|
+
};
|
|
214
|
+
if (hasBody) {
|
|
215
|
+
headers['Content-Type'] = 'application/json';
|
|
216
|
+
}
|
|
217
|
+
if (this.token !== undefined && this.token.length > 0) {
|
|
218
|
+
headers['Authorization'] = `Bearer ${this.token}`;
|
|
219
|
+
}
|
|
220
|
+
return headers;
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
/**
|
|
224
|
+
* Remove the response envelope added by
|
|
225
|
+
* the API host core's `TransformInterceptor` (`@marinoscar/platform-api/host`), which wraps a
|
|
226
|
+
* handler's return value as `{ data, meta: { timestamp } }`.
|
|
227
|
+
*
|
|
228
|
+
* THE SUBTLETY, and the reason `ApiResponse.body` exists alongside this: the
|
|
229
|
+
* interceptor PASSES THROUGH anything that already has a `data` key. A
|
|
230
|
+
* paginated endpoint returning `{ data: [...], pagination: {...} }` is
|
|
231
|
+
* therefore never wrapped, and unwrapping it here yields the array while
|
|
232
|
+
* silently dropping the page count. That is correct for a typed caller that
|
|
233
|
+
* asked for the items, and wrong for anything that needs the pagination — so
|
|
234
|
+
* the untouched body is always kept, and #144's `--raw` prints that instead.
|
|
235
|
+
*
|
|
236
|
+
* Arrays and primitives are returned untouched: only an object with a `data`
|
|
237
|
+
* key can be an envelope.
|
|
238
|
+
*
|
|
239
|
+
* @stability experimental
|
|
240
|
+
*/
|
|
241
|
+
export function unwrapEnvelope(body) {
|
|
242
|
+
if (body !== null && typeof body === 'object' && !Array.isArray(body) && 'data' in body) {
|
|
243
|
+
return body.data;
|
|
244
|
+
}
|
|
245
|
+
return body;
|
|
246
|
+
}
|
|
247
|
+
/** `meta` from the envelope, when the body is one and `meta` is an object. */
|
|
248
|
+
function extractMeta(body) {
|
|
249
|
+
if (body === null || typeof body !== 'object' || Array.isArray(body))
|
|
250
|
+
return undefined;
|
|
251
|
+
const meta = body.meta;
|
|
252
|
+
if (meta === null || typeof meta !== 'object' || Array.isArray(meta))
|
|
253
|
+
return undefined;
|
|
254
|
+
return meta;
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* Join a base URL and a path, then append the query string.
|
|
258
|
+
*
|
|
259
|
+
* WHY NOT `new URL(path, baseUrl)`: it applies web resolution rules, and an
|
|
260
|
+
* absolute path REPLACES the base's path.
|
|
261
|
+
* `new URL('/auth/me', 'http://h/api')` is `http://h/auth/me` — the `/api` prefix silently gone,
|
|
262
|
+
* and every request 404s while the base URL looks perfectly correct in the
|
|
263
|
+
* error message. String joining is the boring, right answer here.
|
|
264
|
+
*
|
|
265
|
+
* Exported for tests: the slash handling above is exactly the sort of thing
|
|
266
|
+
* that regresses.
|
|
267
|
+
*
|
|
268
|
+
* @stability experimental
|
|
269
|
+
*/
|
|
270
|
+
export function buildUrl(baseUrl, path, query) {
|
|
271
|
+
const trimmedBase = baseUrl.replace(/\/+$/, '');
|
|
272
|
+
const trimmedPath = path.replace(/^\/+/, '');
|
|
273
|
+
const joined = trimmedPath.length > 0 ? `${trimmedBase}/${trimmedPath}` : trimmedBase;
|
|
274
|
+
if (query === undefined)
|
|
275
|
+
return joined;
|
|
276
|
+
const params = new URLSearchParams();
|
|
277
|
+
for (const [key, value] of Object.entries(query)) {
|
|
278
|
+
// `undefined` and `null` are DROPPED rather than stringified. Otherwise an
|
|
279
|
+
// unset optional filter becomes `?status=undefined`, which the server
|
|
280
|
+
// dutifully validates and rejects with a 400 that blames the user for a
|
|
281
|
+
// parameter they never set.
|
|
282
|
+
if (value === undefined || value === null)
|
|
283
|
+
continue;
|
|
284
|
+
params.append(key, String(value));
|
|
285
|
+
}
|
|
286
|
+
const queryString = params.toString();
|
|
287
|
+
return queryString.length > 0 ? `${joined}?${queryString}` : joined;
|
|
288
|
+
}
|
|
289
|
+
/**
|
|
290
|
+
* Turn a server URL a human typed into the API root this client wants.
|
|
291
|
+
*
|
|
292
|
+
* localhost:3535 -\> http://localhost:3535/api
|
|
293
|
+
* https://app.example.com -\> https://app.example.com/api
|
|
294
|
+
* https://app.example.com/api -\> https://app.example.com/api (idempotent)
|
|
295
|
+
*
|
|
296
|
+
* Exists because #143 stores a SERVER url (what the user knows) while this
|
|
297
|
+
* client needs an API root (what the routing requires), and the `/api` prefix
|
|
298
|
+
* is an implementation detail of apps/api/src/main.ts that a user should never
|
|
299
|
+
* have to know. Idempotent so that a user who pastes the full API URL — which
|
|
300
|
+
* they will, because it is what the docs show — is not punished with
|
|
301
|
+
* `/api/api`.
|
|
302
|
+
*
|
|
303
|
+
* The scheme guess is deliberately asymmetric: a bare `localhost` or loopback
|
|
304
|
+
* address gets `http`, everything else gets `https`. Defaulting a public
|
|
305
|
+
* hostname to http would send a bearer token over the wire in plaintext, and
|
|
306
|
+
* silently downgrading a credential is not an acceptable convenience.
|
|
307
|
+
*
|
|
308
|
+
* @stability experimental
|
|
309
|
+
*/
|
|
310
|
+
export function resolveApiBaseUrl(serverUrl) {
|
|
311
|
+
const trimmed = serverUrl.trim();
|
|
312
|
+
if (trimmed.length === 0) {
|
|
313
|
+
throw new UsageError('A server URL is required (for example: https://app.example.com).');
|
|
314
|
+
}
|
|
315
|
+
const withScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed)
|
|
316
|
+
? trimmed
|
|
317
|
+
: `${isLoopbackAuthority(trimmed) ? 'http' : 'https'}://${trimmed}`;
|
|
318
|
+
let parsed;
|
|
319
|
+
try {
|
|
320
|
+
parsed = new URL(withScheme);
|
|
321
|
+
}
|
|
322
|
+
catch {
|
|
323
|
+
throw new UsageError(`"${serverUrl}" is not a valid server URL.`);
|
|
324
|
+
}
|
|
325
|
+
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
|
|
326
|
+
throw new UsageError(`Server URL must use http or https, not "${parsed.protocol.replace(':', '')}".`);
|
|
327
|
+
}
|
|
328
|
+
const path = parsed.pathname.replace(/\/+$/, '');
|
|
329
|
+
const base = `${parsed.origin}${path}`;
|
|
330
|
+
return path.endsWith(API_PATH_PREFIX) ? base : `${base}${API_PATH_PREFIX}`;
|
|
331
|
+
}
|
|
332
|
+
/** `localhost`, `127.x`, `[::1]` — with or without a port or a path. */
|
|
333
|
+
function isLoopbackAuthority(value) {
|
|
334
|
+
const authority = value.split('/')[0] ?? '';
|
|
335
|
+
const host = authority.replace(/:\d+$/, '').toLowerCase();
|
|
336
|
+
return host === 'localhost' || host === '127.0.0.1' || host === '[::1]' || host === '::1';
|
|
337
|
+
}
|
|
338
|
+
/**
|
|
339
|
+
* Combine the caller's cancellation with our own deadline.
|
|
340
|
+
*
|
|
341
|
+
* `AbortSignal.any` (Node 20.3+) is what makes both work at once: without it,
|
|
342
|
+
* passing the caller's signal drops the timeout and passing the timeout drops
|
|
343
|
+
* the caller's Ctrl-C. Both matter — #142 polls with its own signal AND still
|
|
344
|
+
* needs each individual poll to time out.
|
|
345
|
+
*/
|
|
346
|
+
function withTimeout(signal, timeoutMs) {
|
|
347
|
+
const timeout = AbortSignal.timeout(timeoutMs);
|
|
348
|
+
return signal === undefined ? timeout : AbortSignal.any([signal, timeout]);
|
|
349
|
+
}
|
|
350
|
+
//# sourceMappingURL=api-client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/engine/api-client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/** What happened, so the caller can word its next line accordingly. */
|
|
2
|
+
export interface BrowserOpenResult {
|
|
3
|
+
opened: boolean;
|
|
4
|
+
/** Why not, when `opened` is false. For a `--verbose`, not for the user. */
|
|
5
|
+
reason?: 'unsupported-scheme' | 'headless' | 'spawn-failed' | 'no-opener';
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* Open `url` in the user's browser. Resolves `false` rather than throwing.
|
|
9
|
+
*
|
|
10
|
+
* Only `http:` and `https:` are accepted. That check is a security control,
|
|
11
|
+
* not tidiness: this hands a string to a platform opener that will dispatch on
|
|
12
|
+
* scheme, and `file:` would open a local file while schemes registered by
|
|
13
|
+
* other applications can invoke them with arguments. The URL comes from the
|
|
14
|
+
* server's `verificationUriComplete` — i.e. from a host the user named but
|
|
15
|
+
* which is not otherwise trusted to choose what runs on their machine.
|
|
16
|
+
*/
|
|
17
|
+
export declare function openInBrowser(url: string): Promise<BrowserOpenResult>;
|
|
18
|
+
//# sourceMappingURL=browser.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/engine/browser.ts"],"names":[],"mappings":"AAsBA,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,oBAAoB,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,CAAC;CAC3E;AAYD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6D3E"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { spawn } from 'node:child_process';
|
|
2
|
+
import { platform } from 'node:process';
|
|
3
|
+
/**
|
|
4
|
+
* How long to wait for the child to start before giving up on it.
|
|
5
|
+
*
|
|
6
|
+
* We wait for `spawn`/`error`, NOT for the process to exit. A browser launcher
|
|
7
|
+
* either execs immediately or fails immediately; waiting for exit would block
|
|
8
|
+
* for as long as the browser runs, which on most Linux setups means until the
|
|
9
|
+
* user closes it — i.e. forever, in the middle of a login.
|
|
10
|
+
*/
|
|
11
|
+
const SPAWN_TIMEOUT_MS = 2_000;
|
|
12
|
+
/**
|
|
13
|
+
* Open `url` in the user's browser. Resolves `false` rather than throwing.
|
|
14
|
+
*
|
|
15
|
+
* Only `http:` and `https:` are accepted. That check is a security control,
|
|
16
|
+
* not tidiness: this hands a string to a platform opener that will dispatch on
|
|
17
|
+
* scheme, and `file:` would open a local file while schemes registered by
|
|
18
|
+
* other applications can invoke them with arguments. The URL comes from the
|
|
19
|
+
* server's `verificationUriComplete` — i.e. from a host the user named but
|
|
20
|
+
* which is not otherwise trusted to choose what runs on their machine.
|
|
21
|
+
*/
|
|
22
|
+
export async function openInBrowser(url) {
|
|
23
|
+
let parsed;
|
|
24
|
+
try {
|
|
25
|
+
parsed = new URL(url);
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
return { opened: false, reason: 'unsupported-scheme' };
|
|
29
|
+
}
|
|
30
|
+
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
|
|
31
|
+
return { opened: false, reason: 'unsupported-scheme' };
|
|
32
|
+
}
|
|
33
|
+
if (isHeadless()) {
|
|
34
|
+
// Detected rather than attempted. Running `xdg-open` with no display does
|
|
35
|
+
// not fail quietly — it prints its own error to the terminal, which lands
|
|
36
|
+
// in the middle of the instructions the user is trying to read, and on
|
|
37
|
+
// some systems it hangs waiting for a session bus that is not there.
|
|
38
|
+
return { opened: false, reason: 'headless' };
|
|
39
|
+
}
|
|
40
|
+
const command = openerFor(url);
|
|
41
|
+
if (command === undefined)
|
|
42
|
+
return { opened: false, reason: 'no-opener' };
|
|
43
|
+
return new Promise((resolve) => {
|
|
44
|
+
let settled = false;
|
|
45
|
+
const finish = (result) => {
|
|
46
|
+
if (settled)
|
|
47
|
+
return;
|
|
48
|
+
settled = true;
|
|
49
|
+
clearTimeout(timer);
|
|
50
|
+
resolve(result);
|
|
51
|
+
};
|
|
52
|
+
const timer = setTimeout(() => finish({ opened: false, reason: 'spawn-failed' }), SPAWN_TIMEOUT_MS);
|
|
53
|
+
// The timer must not itself hold the process open if everything else is
|
|
54
|
+
// done — a login that has otherwise finished should not wait on it.
|
|
55
|
+
timer.unref?.();
|
|
56
|
+
try {
|
|
57
|
+
const child = spawn(command.file, command.args, {
|
|
58
|
+
// `detached` + `unref` so the CLI can exit while the browser lives on.
|
|
59
|
+
// Without them, a launcher that keeps a handle on the browser process
|
|
60
|
+
// keeps this process's event loop alive after `login` has finished.
|
|
61
|
+
detached: true,
|
|
62
|
+
// Everything ignored, so the browser's own diagnostics — GTK warnings,
|
|
63
|
+
// profile-lock complaints, X11 noise — cannot interleave with the
|
|
64
|
+
// device code we just printed.
|
|
65
|
+
stdio: 'ignore',
|
|
66
|
+
// No shell. The URL is attacker-influenced (see above) and a shell
|
|
67
|
+
// would give `&`, `;` and backticks in it meaning.
|
|
68
|
+
shell: false,
|
|
69
|
+
});
|
|
70
|
+
child.once('error', () => finish({ opened: false, reason: 'spawn-failed' }));
|
|
71
|
+
child.once('spawn', () => {
|
|
72
|
+
child.unref();
|
|
73
|
+
finish({ opened: true });
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
catch {
|
|
77
|
+
finish({ opened: false, reason: 'spawn-failed' });
|
|
78
|
+
}
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* There is no display to open a browser on.
|
|
83
|
+
*
|
|
84
|
+
* Linux/BSD only. macOS and Windows always have a window server when a user is
|
|
85
|
+
* logged in, and `DISPLAY` means nothing there — testing it would wrongly skip
|
|
86
|
+
* the open on every mac.
|
|
87
|
+
*/
|
|
88
|
+
function isHeadless() {
|
|
89
|
+
if (platform === 'darwin' || platform === 'win32')
|
|
90
|
+
return false;
|
|
91
|
+
return ((process.env.DISPLAY ?? '') === '' &&
|
|
92
|
+
(process.env.WAYLAND_DISPLAY ?? '') === '' &&
|
|
93
|
+
// A macOS-style variable that some remote-desktop setups export; cheap to
|
|
94
|
+
// honour and it prevents a false "headless" on those.
|
|
95
|
+
(process.env.XDG_SESSION_TYPE ?? '') !== 'x11');
|
|
96
|
+
}
|
|
97
|
+
/** The platform's "open this URL" command. */
|
|
98
|
+
function openerFor(url) {
|
|
99
|
+
switch (platform) {
|
|
100
|
+
case 'darwin':
|
|
101
|
+
// `--` so a URL that begins with a hyphen cannot be read as a flag.
|
|
102
|
+
return { file: 'open', args: ['--', url] };
|
|
103
|
+
case 'win32':
|
|
104
|
+
// `start` is a cmd.exe BUILTIN, so cmd has to run it — there is no
|
|
105
|
+
// `start.exe`. The empty string is the window TITLE argument: without
|
|
106
|
+
// it, `start "https://..."` treats the quoted URL as the title and opens
|
|
107
|
+
// nothing at all, which is the classic Windows bug in this function.
|
|
108
|
+
return { file: 'cmd.exe', args: ['/d', '/s', '/c', 'start', '""', url] };
|
|
109
|
+
default:
|
|
110
|
+
// xdg-open on Linux and the BSDs. Absent on a minimal container, which
|
|
111
|
+
// surfaces as an ENOENT `error` event and a clean `false`.
|
|
112
|
+
return { file: 'xdg-open', args: [url] };
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=browser.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/engine/browser.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { type EnvGroupRegistration } from '../core/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* The fragment id of the platform's own env-key map. It is a fragment like any
|
|
4
|
+
* other so that "one owner per key" is one rule: a key in this map AND in an
|
|
5
|
+
* app's fragment throws, naming both.
|
|
6
|
+
*/
|
|
7
|
+
export declare const PLATFORM_ENV_FRAGMENT_ID = "platform";
|
|
8
|
+
/**
|
|
9
|
+
* The platform's feature groups, registered through the same function an app
|
|
10
|
+
* uses. `observability` is on for every deployment (#567); the rest are opt-in.
|
|
11
|
+
*/
|
|
12
|
+
export declare const PLATFORM_ENV_GROUPS: readonly EnvGroupRegistration[];
|
|
13
|
+
/**
|
|
14
|
+
* Registers the platform's env-spec fragments exactly once per process. Safe
|
|
15
|
+
* to call any number of times.
|
|
16
|
+
*/
|
|
17
|
+
export declare function ensurePlatformRegistrations(): void;
|
|
18
|
+
/** Empties both core registries and forgets the registration. Tests only. */
|
|
19
|
+
export declare function resetPlatformRegistrationsForTests(): void;
|
|
20
|
+
//# sourceMappingURL=builtin-registrations.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"builtin-registrations.d.ts","sourceRoot":"","sources":["../../src/engine/builtin-registrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AA0B1B;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAKnD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,oBAAoB,EAc7D,CAAC;AAWH;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAUlD;AAED,6EAA6E;AAC7E,wBAAgB,kCAAkC,IAAI,IAAI,CAMzD"}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { registerEnvGroup, registerEnvSpecFragment, resetCommandRegistryForTests, resetEnvGroupRegistryForTests, resetEnvSpecRegistryForTests, } from '../core/index.js';
|
|
2
|
+
import { telemetryEnvSpecFragment } from '../telemetry/index.js';
|
|
3
|
+
import { ENV_METADATA } from './deploy/env-metadata.js';
|
|
4
|
+
// =============================================================================
|
|
5
|
+
// The platform's built-in registrations (PP-4.5 #706, PP-8.9 #715)
|
|
6
|
+
// =============================================================================
|
|
7
|
+
//
|
|
8
|
+
// The env-spec fragments every app gets, in the order they contribute:
|
|
9
|
+
//
|
|
10
|
+
// 1. the platform base (`ENV_METADATA`, the keys of
|
|
11
|
+
// @marinoscar/platform-infra's env/base.env.example);
|
|
12
|
+
// 2. each enabled slice (`telemetry`).
|
|
13
|
+
//
|
|
14
|
+
// The app's own fragments (`createCli({ envSpecFragments })`) come after
|
|
15
|
+
// them, for the keys of its `infra/compose/app.env.example`, which sync
|
|
16
|
+
// appends after the platform's in `.env.example`: one order, three layers.
|
|
17
|
+
//
|
|
18
|
+
// LAZY, NEVER ON IMPORT: this runs from the places that read the registries,
|
|
19
|
+
// `metadataFor()` (deploy/env-metadata.ts) and `buildProgram()`, and from
|
|
20
|
+
// `createCli`. IDEMPOTENT: the first call registers, later calls return at
|
|
21
|
+
// once. A first call that THROWS (a key owned twice) is remembered and
|
|
22
|
+
// rethrown: a half-registered CLI must not start working on a second try.
|
|
23
|
+
// =============================================================================
|
|
24
|
+
/**
|
|
25
|
+
* The fragment id of the platform's own env-key map. It is a fragment like any
|
|
26
|
+
* other so that "one owner per key" is one rule: a key in this map AND in an
|
|
27
|
+
* app's fragment throws, naming both.
|
|
28
|
+
*/
|
|
29
|
+
export const PLATFORM_ENV_FRAGMENT_ID = 'platform';
|
|
30
|
+
let registered = false;
|
|
31
|
+
let failure;
|
|
32
|
+
/**
|
|
33
|
+
* The platform's feature groups, registered through the same function an app
|
|
34
|
+
* uses. `observability` is on for every deployment (#567); the rest are opt-in.
|
|
35
|
+
*/
|
|
36
|
+
export const PLATFORM_ENV_GROUPS = Object.freeze([
|
|
37
|
+
{
|
|
38
|
+
id: 'observability',
|
|
39
|
+
label: 'Observability',
|
|
40
|
+
description: 'The telemetry stack: OpenTelemetry collector and GreptimeDB. On for every deployment.',
|
|
41
|
+
defaultEnabled: true,
|
|
42
|
+
},
|
|
43
|
+
{ id: 'email', label: 'Email', description: 'Outbound email through Amazon SES.', defaultEnabled: false },
|
|
44
|
+
{
|
|
45
|
+
id: 'microsoft-oauth',
|
|
46
|
+
label: 'Microsoft sign-in',
|
|
47
|
+
description: 'Sign in with a Microsoft account.',
|
|
48
|
+
defaultEnabled: false,
|
|
49
|
+
},
|
|
50
|
+
]);
|
|
51
|
+
function registerAll() {
|
|
52
|
+
// Groups before fragments: a fragment's `group` is checked against them.
|
|
53
|
+
for (const group of PLATFORM_ENV_GROUPS)
|
|
54
|
+
registerEnvGroup(group);
|
|
55
|
+
// The platform base first, so a collision always names it as the owner.
|
|
56
|
+
registerEnvSpecFragment({ id: PLATFORM_ENV_FRAGMENT_ID, metadata: ENV_METADATA });
|
|
57
|
+
// Slice fragments, in slice order.
|
|
58
|
+
registerEnvSpecFragment(telemetryEnvSpecFragment);
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* Registers the platform's env-spec fragments exactly once per process. Safe
|
|
62
|
+
* to call any number of times.
|
|
63
|
+
*/
|
|
64
|
+
export function ensurePlatformRegistrations() {
|
|
65
|
+
if (registered)
|
|
66
|
+
return;
|
|
67
|
+
if (failure !== undefined)
|
|
68
|
+
throw failure;
|
|
69
|
+
try {
|
|
70
|
+
registerAll();
|
|
71
|
+
registered = true;
|
|
72
|
+
}
|
|
73
|
+
catch (error) {
|
|
74
|
+
failure = error;
|
|
75
|
+
throw error;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
/** Empties both core registries and forgets the registration. Tests only. */
|
|
79
|
+
export function resetPlatformRegistrationsForTests() {
|
|
80
|
+
resetEnvSpecRegistryForTests();
|
|
81
|
+
resetEnvGroupRegistryForTests();
|
|
82
|
+
resetCommandRegistryForTests();
|
|
83
|
+
registered = false;
|
|
84
|
+
failure = undefined;
|
|
85
|
+
}
|
|
86
|
+
//# sourceMappingURL=builtin-registrations.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"builtin-registrations.js","sourceRoot":"","sources":["../../src/engine/builtin-registrations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,GAE7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,gFAAgF;AAChF,oEAAoE;AACpE,gFAAgF;AAChF,EAAE;AACF,uEAAuE;AACvE,EAAE;AACF,sDAAsD;AACtD,2DAA2D;AAC3D,yCAAyC;AACzC,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,uEAAuE;AACvE,0EAA0E;AAC1E,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAEnD,IAAI,UAAU,GAAG,KAAK,CAAC;AACvB,IAAI,OAAgB,CAAC;AAErB;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAoC,MAAM,CAAC,MAAM,CAAC;IAChF;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,uFAAuF;QACpG,cAAc,EAAE,IAAI;KACrB;IACD,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,oCAAoC,EAAE,cAAc,EAAE,KAAK,EAAE;IACzG;QACE,EAAE,EAAE,iBAAiB;QACrB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,mCAAmC;QAChD,cAAc,EAAE,KAAK;KACtB;CACF,CAAC,CAAC;AAEH,SAAS,WAAW;IAClB,yEAAyE;IACzE,KAAK,MAAM,KAAK,IAAI,mBAAmB;QAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACjE,wEAAwE;IACxE,uBAAuB,CAAC,EAAE,EAAE,EAAE,wBAAwB,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;IAClF,mCAAmC;IACnC,uBAAuB,CAAC,wBAAwB,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,IAAI,UAAU;QAAE,OAAO;IACvB,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC;IACzC,IAAI,CAAC;QACH,WAAW,EAAE,CAAC;QACd,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,KAAK,CAAC;QAChB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,kCAAkC;IAChD,4BAA4B,EAAE,CAAC;IAC/B,6BAA6B,EAAE,CAAC;IAChC,4BAA4B,EAAE,CAAC;IAC/B,UAAU,GAAG,KAAK,CAAC;IACnB,OAAO,GAAG,SAAS,CAAC;AACtB,CAAC"}
|