@haakco/hostingctl 1.0.523 → 1.0.525

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/README.md CHANGED
@@ -704,8 +704,10 @@ hostingctl application remove <environment-uuid> <workload-uuid> --company acme
704
704
  ```
705
705
 
706
706
  `deployment` reports the running, requested and interrupted builds and releases, the bound source and whether
707
- a push would deploy. `build` queues a build of the application's applied configuration from `--source` (or the
708
- bound selection), resolved to an exact commit by the source service rather than named here. `deploy` makes an
707
+ a push would deploy. `build` queues a build of the application's applied configuration from exactly one of
708
+ `--source <selection-uuid>`, `--source-upload <upload-uuid>` or `--ssh-source <connection-uuid>` (or the
709
+ recorded binding when none is named), resolved to an exact commit or measured archive digest by the source
710
+ service rather than named here. `deploy` makes an
709
711
  existing release the one the application runs. `runs` and `run-log` read the process run history and one run's
710
712
  own output, which may report `unavailable` when the cluster cannot answer rather than an empty body.
711
713
  `schedule-run` runs a **declared** schedule once, now, beside the schedule's own runs; it does not execute an
@@ -723,6 +725,42 @@ generation makes a stale review a conflict. Removal withdraws the runtime throug
723
725
  deletes no retained data; retiring an environment-owned database's data is a separate decision. Every write
724
726
  needs `--confirm`; `--dry-run` describes the change and sends nothing.
725
727
 
728
+ ### Uploaded and Git-over-SSH source
729
+
730
+ Both the Rust binary and the TypeScript CLI support these commands. All writes need `--confirm`;
731
+ `--dry-run` sends nothing, and a dry-run upload does not open the file.
732
+
733
+ ```text
734
+ hostingctl application source-upload <environment-uuid> <workload-uuid> --company acme --file project.zip --confirm
735
+ hostingctl application source-uploads <environment-uuid> <workload-uuid> --company acme
736
+ hostingctl application source-upload-show <environment-uuid> <workload-uuid> <upload-uuid> --company acme
737
+ hostingctl application source-upload-discard <environment-uuid> <workload-uuid> <upload-uuid> --company acme --confirm
738
+ hostingctl application build <environment-uuid> <workload-uuid> --company acme --source-upload <upload-uuid> --confirm
739
+ hostingctl application source-ssh-list --company acme
740
+ hostingctl application source-ssh-show <connection-uuid> --company acme
741
+ hostingctl application source-ssh-create --company acme --name Project \
742
+ --repo git@git.example.com:team/project.git --ref main --confirm
743
+ hostingctl application source-ssh-confirm-host-key <connection-uuid> --company acme \
744
+ --fingerprint SHA256:verified-out-of-band --confirm
745
+ hostingctl application source-ssh-verify <connection-uuid> --company acme --confirm
746
+ hostingctl application source-ssh-update <connection-uuid> --company acme --ref v1.2.0 --ref-kind tag --confirm
747
+ hostingctl application source-ssh-rotate-key <connection-uuid> --company acme --confirm
748
+ hostingctl application source-ssh-revoke <connection-uuid> --company acme --confirm
749
+ hostingctl application source-bind <environment-uuid> <workload-uuid> --company acme --ssh-source <connection-uuid> --confirm
750
+ hostingctl application build <environment-uuid> <workload-uuid> --company acme --ssh-source <connection-uuid> --confirm
751
+ ```
752
+
753
+ An upload is staged and reviewed, not built or deployed. ZIP bytes are streamed with their original filename;
754
+ review, expiry and digest come from the API. Build explicitly, then deploy the candidate with
755
+ `application deploy`. Discarding staging does not remove source already copied into a build.
756
+
757
+ Creating an SSH source returns its **public** deploy key and the discovered server fingerprint. Install the
758
+ public key on the Git server, compare the host fingerprint independently, confirm that fingerprint, then
759
+ verify access. No private key leaves the platform. An update changes only the label or branch/tag ref;
760
+ rotation clears verification and requires installing the replacement public key. Revocation stops future
761
+ fetches and candidate promotion, not the serving release. SSH sources are company-scoped, so their commands
762
+ need no environment or application UUID. `source-bind` accepts exactly one of `--selection` or `--ssh-source`.
763
+
726
764
  ## Retained log history
727
765
 
728
766
  Read the platform's bounded history for one of your resources. This is retained, sanitized operational
package/dist/main.js CHANGED
@@ -40030,7 +40030,9 @@ async function applicationSourceUploads(context, action, path, rest) {
40030
40030
  kind: "source-upload",
40031
40031
  upload: (await hostingSourceUploadsShow({ path: uploadPath })).data
40032
40032
  };
40033
- if (action === "source-upload-discard") return await written$3(confirmableWrite(context, [`Discard the staged source upload ${uploadUuid}.`, "A build that already used it keeps the copy it was handed, so nothing that is serving changes."].join("\n"), async () => (await hostingSourceUploadsDestroy({ path: uploadPath })).data));
40033
+ if (action === "source-upload-discard") return await written$3(confirmableWrite(context, [`Discard the staged source upload ${uploadUuid}.`, "A build that already used it keeps the copy it was handed, so nothing that is serving changes."].join("\n"), async () => {
40034
+ await hostingSourceUploadsDestroy({ path: uploadPath });
40035
+ }));
40034
40036
  throw new UsageError(USAGE$38);
40035
40037
  }
40036
40038
  /**
@@ -56180,7 +56182,7 @@ var createHostingEnvironmentRequestSchema = object({
56180
56182
  mariadbConfigCustom: string().max(16384).nullish(),
56181
56183
  reset: boolean().optional()
56182
56184
  }).optional()
56183
- })).min(1).max(20).optional(),
56185
+ })).min(1).optional(),
56184
56186
  volumes: array(object({
56185
56187
  type: string(),
56186
56188
  name: string().max(100),
@@ -56189,7 +56191,7 @@ var createHostingEnvironmentRequestSchema = object({
56189
56191
  databases: array(object({
56190
56192
  application: string().max(100),
56191
56193
  server: string().max(100)
56192
- })).max(20).optional(),
56194
+ })).optional(),
56193
56195
  postgresRestoreSource: object({ sourceEnvironmentUuid: uuid().optional() }).optional()
56194
56196
  }).describe("The submitted desired state of a new environment.\n\nField-level rules live here: shape, type, range, catalog membership and the\nname uniqueness within the company that the database also enforces through a\npartial unique index on active rows. Everything that needs to compare one\nsubmitted value with another, or with stored rows, belongs to\n`HostingResourceService`.");
56195
56197
  var createHostingExternalSecretConnectionRequestSchema = object({
@@ -60548,7 +60550,7 @@ var updateHostingEnvironmentRequestSchema = object({
60548
60550
  mariadbConfigCustom: string().max(16384).nullish(),
60549
60551
  reset: boolean().optional()
60550
60552
  }).optional()
60551
- })).min(1).max(20),
60553
+ })).min(1),
60552
60554
  volumes: array(object({
60553
60555
  type: string(),
60554
60556
  name: string().max(100),
@@ -68639,7 +68641,7 @@ function writeUpdateState(state, env = process.env) {
68639
68641
  }
68640
68642
  //#endregion
68641
68643
  //#region src/version.ts
68642
- var VERSION = "1.0.523";
68644
+ var VERSION = "1.0.525";
68643
68645
  //#endregion
68644
68646
  //#region src/commands/update.ts
68645
68647
  /**
@@ -68714,7 +68716,7 @@ var update = {
68714
68716
  }, process.env);
68715
68717
  return {
68716
68718
  ...known,
68717
- current: after ?? "1.0.523",
68719
+ current: after ?? "1.0.525",
68718
68720
  latest: after ?? latest,
68719
68721
  upToDate: after !== null && (latest === null || !isNewerVersion(latest, after)),
68720
68722
  action: "run",
@@ -68990,7 +68992,7 @@ async function printUpdateNotice(options) {
68990
68992
  }, env, { waitMs: NOTICE_LOCK_WAIT_MS });
68991
68993
  } catch {}
68992
68994
  if (latest === null) return;
68993
- if (!isNewerVersion(latest, "1.0.523")) return;
68995
+ if (!isNewerVersion(latest, "1.0.525")) return;
68994
68996
  process.stderr.write(`A newer hostingctl is published: ${latest} (this copy is ${VERSION}). Run \`hostingctl update\` to update.\n`);
68995
68997
  }
68996
68998
  /** Whether an environment variable is set to something, which is how CI and the opt-out are read. */