@olivervea/pipelines 2.0.0-beta.22 → 2.0.0-beta.23

package/README.md

@@ -166,7 +166,7 @@ Library steps carry their own implementation and image; they take typed settings
 | `httpHealthCheck(ctx, url, { attempts?, delaySeconds?, headers? })` | GETs `url` until it returns 2xx (redirects followed), retrying network errors and non-2xx statuses; defaults 5 attempts, 5 s apart. Throws the last error when the attempts run out. Runs in the harness, so the image needs no curl. `helmDeployOverSsh`'s `healthUrl` uses it. |
 | `serviceUrl(release)` | `http://<release>.<namespace>.svc.cluster.local` for a `HelmRelease` (charts that name the Service after the release). |
 | `checkSpa(ctx, url)` | `GET <url>/` must reference an `/assets/*.js` bundle (Vite's layout) and the bundle must be served as JavaScript; returns `{ html, bundle }` for app-specific checks. |
-| `sshSession(ctx, { host, key })` | Installs openssh-client when the image has no ssh (apk or apt-get), writes the key to `<tmpDir>/ssh/id` (trailing newline, mode 600; host key not verified) and returns `{ run(remote), text(remote), copy(local, remote), shell(remote) }`; `shell` is the quoted ssh command for pipes (`ctx.sh(`printf '%s' "$V" \| ${s.shell("kubectl apply -f -")}`)`). `helmDeployOverSsh` uses it. |
+| `sshSession(ctx, { host, key })` | Installs openssh-client when the image has no ssh (apk or apt-get), writes the key to `<tmpDir>/ssh/id` (trailing newline, mode 600; host key not verified) and returns `{ run(remote, { tty? }), text(remote), copy(local, remote), shell(remote) }`; `shell` is the quoted ssh command for pipes (`ctx.sh(`printf '%s' "$V" \| ${s.shell("kubectl apply -f -")}`)`). `helmDeployOverSsh` uses it. |
 
 ```ts
 import { httpHealthCheck, implement, step } from "@olivervea/pipelines";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olivervea/pipelines",
-  "version": "2.0.0-beta.22",
+  "version": "2.0.0-beta.23",
   "description": "Olve.Pipelines v2 SDK: typed pipeline authoring, the step harness, and the build tool.",
   "type": "module",
   "license": "MIT",

package/src/library/ssh.ts

@@ -16,8 +16,11 @@ export const SSH_CLIENT_INSTALL =
 
 export interface SshSession {
   readonly host: string;
-  /** Runs a remote command; a non-zero exit throws. */
-  run(remote: string): Promise<void>;
+  /**
+   * Runs a remote command; a non-zero exit throws. With `tty`, the command gets a terminal, so a client that
+   * dies (a cancelled step) hangs it up: without one, the command gets no signal and carries on.
+   */
+  run(remote: string, options?: { tty?: boolean }): Promise<void>;
   /** Runs a remote command and returns its stdout. */
   text(remote: string): Promise<string>;
   /** `scp -r` a local file or directory to a remote path. */
@@ -58,7 +61,8 @@ export async function sshSession(
   const argv = (remote: string) => ['ssh', ...sshOpts, opts.host, remote];
   return {
     host: opts.host,
-    run: (remote) => ctx.exec(argv(remote)),
+    run: (remote, options) =>
+      ctx.exec(options?.tty ? ['ssh', '-tt', ...argv(remote).slice(1)] : argv(remote)),
     text: (remote) => ctx.sh.text(argv(remote).map(shq).join(' ')),
     copy: (local, remote) =>
       ctx.exec(['scp', ...sshOpts, '-r', local, `${opts.host}:${remote}`]),