@lakutata/docker 3.0.0-beta.0

package/dist/cjs/docker/types/DockerOutputCallback.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/docker/types/ImageConfig.d.ts

@@ -0,0 +1,34 @@
+import { ImageExposePort } from './ImageExposePort.js';
+/**
+ * The run settings an image gives its containers by default, from its Dockerfile (`DockerImage.config`).
+ */
+export type ImageConfig = {
+    /**
+     * The containers' default host name, usually empty.
+     */
+    hostname: string;
+    /**
+     * The user the containers' processes run as (`USER`: `"node"`, `"1000:1000"`), an empty string for root.
+     */
+    user: string;
+    /**
+     * The environment variables (`ENV`), by name.
+     */
+    env: Record<string, string>;
+    /**
+     * The default command (`CMD`), as its arguments. Docker reports `null` for an image without one.
+     */
+    cmd: string[];
+    /**
+     * The entry point (`ENTRYPOINT`), as its arguments, empty when the image has none.
+     */
+    entrypoint: string[];
+    /**
+     * The container paths of the image's volumes (`VOLUME`: `/var/lib/postgresql/data`).
+     */
+    volumes: string[];
+    /**
+     * The exposed ports (`EXPOSE`).
+     */
+    ports: ImageExposePort[];
+};

package/dist/cjs/docker/types/ImageConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/docker/types/ImageExposePort.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A port exposed by an image (its Dockerfile's `EXPOSE`), with its protocols (`DockerImage.config.ports`).
+ */
+export type ImageExposePort = {
+    /**
+     * The port in the container (`80`).
+     */
+    port: number;
+    /**
+     * `true` when the port is exposed for TCP.
+     */
+    tcp: boolean;
+    /**
+     * `true` when the port is exposed for UDP.
+     */
+    udp: boolean;
+};

package/dist/cjs/docker/types/ImageExposePort.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/docker/types/NetworkInfo.d.ts

@@ -0,0 +1,59 @@
+import { Time } from '@lakutata/utils/Time';
+/**
+ * An IP address range of a Docker network (its IPAM configuration): read from a network ({@link NetworkInfo}) and given
+ * to {@link NetworkCreateOptions.NetworkIPAMConfigs}.
+ */
+export type NetworkIPAMConfig = {
+    /**
+     * The network's subnet, in CIDR notation (`172.28.0.0/16`).
+     */
+    subnet: string;
+    /**
+     * The part of the subnet Docker allocates the containers' addresses from, in CIDR notation (`172.28.5.0/24`); the
+     * whole subnet when absent.
+     */
+    range?: string;
+    /**
+     * The gateway's IP address, without a prefix length (`172.28.0.1`).
+     */
+    gateway: string;
+};
+/**
+ * A Docker network, as {@link Docker.getNetwork}, {@link Docker.listNetworks} and {@link Docker.createNetwork} return
+ * it.
+ */
+export type NetworkInfo = {
+    /**
+     * The network ID.
+     */
+    id: string;
+    /**
+     * The network name.
+     */
+    name: string;
+    /**
+     * The network driver, as Docker reports it: `'bridge'`, `'ipvlan'` or `'macvlan'` for the networks created by this
+     * component; also `'host'`, `'null'` (the `none` network), `'overlay'` or a plugin's name for the others.
+     */
+    driver: string;
+    /**
+     * `true` for the networks Docker creates itself: `bridge`, `host` and `none`.
+     */
+    reserved: boolean;
+    /**
+     * `true` when the network has no external access.
+     */
+    internal: boolean;
+    /**
+     * `true` when IPv6 is enabled on the network.
+     */
+    enableIPv6: boolean;
+    /**
+     * The network's address ranges, empty when it has none.
+     */
+    IPAMConfigs: NetworkIPAMConfig[];
+    /**
+     * When the network was created.
+     */
+    createdAt: Time;
+};

package/dist/cjs/docker/types/NetworkInfo.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/docker/types/RepositoryTag.d.ts

@@ -0,0 +1,15 @@
+/**
+ * An image reference split into its repository and its tag, as {@link parseRepositoryTag} returns it.
+ */
+export type RepositoryTag = {
+    /**
+     * The repository, with its registry when the reference has one (`alpine`,
+     * `registry.example.com:5000/team/app`).
+     */
+    repo: string;
+    /**
+     * The tag (`3.20`), or the digest when the reference has one (`sha256:…` for `alpine@sha256:…`); absent when the
+     * reference has neither.
+     */
+    tag?: string;
+};

package/dist/cjs/docker/types/RepositoryTag.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/exports/Docker.d.ts

@@ -0,0 +1,73 @@
+export * from '../docker/Docker.js';
+export * from '../docker/ConnectionOptionsBuilder.js';
+/**
+ * Lib
+ */
+export * from '../docker/lib/DockerContainer.js';
+export * from '../docker/lib/DockerContainerTTY.js';
+export * from '../docker/lib/DockerImage.js';
+export * from '../docker/lib/ParseEnvToRecord.js';
+export * from '../docker/lib/ParseRepositoryTag.js';
+/**
+ * Interfaces
+ */
+export * from '../docker/interfaces/IDockerConnectionOptions.js';
+export * from '../docker/interfaces/IDockerHttpConnectionOptions.js';
+export * from '../docker/interfaces/IDockerHttpsConnectionOptions.js';
+export * from '../docker/interfaces/IDockerKeyObject.js';
+export * from '../docker/interfaces/IDockerSocketConnectionOptions.js';
+export * from '../docker/interfaces/IDockerSSHConnectionOptions.js';
+/**
+ * Types
+ */
+export * from '../docker/types/ContainerBind.js';
+export * from '../docker/types/RepositoryTag.js';
+export * from '../docker/types/ContainerCapability.js';
+export * from '../docker/types/ContainerConfig.js';
+export * from '../docker/types/ContainerDevice.js';
+export * from '../docker/types/ContainerExecResult.js';
+export * from '../docker/types/ContainerNetwork.js';
+export * from '../docker/types/ContainerPort.js';
+export * from '../docker/types/ContainerRestartPolicy.js';
+export * from '../docker/types/ContainerState.js';
+export * from '../docker/types/ContainerStats.js';
+export * from '../docker/types/DockerOutputCallback.js';
+export * from '../docker/types/ImageConfig.js';
+export * from '../docker/types/ImageExposePort.js';
+export * from '../docker/types/NetworkInfo.js';
+/**
+ * Options
+ */
+export * from '../docker/options/DockerPruneOptions.js';
+export * from '../docker/options/auth/DockerAuthOptions.js';
+export * from '../docker/options/container/ContainerCommitOptions.js';
+export * from '../docker/options/container/ContainerCreateTTYOptions.js';
+export * from '../docker/options/container/ContainerExecOptions.js';
+export * from '../docker/options/container/ContainerKillOptions.js';
+export * from '../docker/options/container/ContainerExportDirectoryOptions.js';
+export * from '../docker/options/container/ContainerLogsOptions.js';
+export * from '../docker/options/container/ContainerRemoveOptions.js';
+export * from '../docker/options/container/ContainerSettingOptions.js';
+export * from '../docker/options/container/ContainerStopOptions.js';
+export * from '../docker/options/container/ContainerTTYConsoleSizeOptions.js';
+export * from '../docker/options/image/ImageBuildOptions.js';
+export * from '../docker/options/image/ImageExportOptions.js';
+export * from '../docker/options/image/ImageImportOptions.js';
+export * from '../docker/options/image/ImagePullOptions.js';
+export * from '../docker/options/image/ImagePushOptions.js';
+export * from '../docker/options/image/ImageRemoveOptions.js';
+export * from '../docker/options/image/ImageTagOptions.js';
+export * from '../docker/options/network/NetworkCreateOptions.js';
+/**
+ * Exceptions
+ */
+export * from '../docker/exceptions/DockerConnectionException.js';
+export * from '../docker/exceptions/DockerContainerNotFoundException.js';
+export * from '../docker/exceptions/DockerImageBuildException.js';
+export * from '../docker/exceptions/DockerImageImportException.js';
+export * from '../docker/exceptions/DockerImageNotFoundException.js';
+export * from '../docker/exceptions/DockerImagePullException.js';
+export * from '../docker/exceptions/DockerImagePushException.js';
+export * from '../docker/exceptions/DockerImageRepoTagNotFoundException.js';
+export * from '../docker/exceptions/DockerNetworkNotFoundException.js';
+export * from '../docker/exceptions/DockerRequestException.js';

package/dist/cjs/exports/Docker.js

@@ -0,0 +1,92 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../docker/Docker.js"), exports);
+__exportStar(require("../docker/ConnectionOptionsBuilder.js"), exports);
+/**
+ * Lib
+ */
+__exportStar(require("../docker/lib/DockerContainer.js"), exports);
+__exportStar(require("../docker/lib/DockerContainerTTY.js"), exports);
+__exportStar(require("../docker/lib/DockerImage.js"), exports);
+__exportStar(require("../docker/lib/ParseEnvToRecord.js"), exports);
+__exportStar(require("../docker/lib/ParseRepositoryTag.js"), exports);
+/**
+ * Interfaces
+ */
+__exportStar(require("../docker/interfaces/IDockerConnectionOptions.js"), exports);
+__exportStar(require("../docker/interfaces/IDockerHttpConnectionOptions.js"), exports);
+__exportStar(require("../docker/interfaces/IDockerHttpsConnectionOptions.js"), exports);
+__exportStar(require("../docker/interfaces/IDockerKeyObject.js"), exports);
+__exportStar(require("../docker/interfaces/IDockerSocketConnectionOptions.js"), exports);
+__exportStar(require("../docker/interfaces/IDockerSSHConnectionOptions.js"), exports);
+/**
+ * Types
+ */
+__exportStar(require("../docker/types/ContainerBind.js"), exports);
+__exportStar(require("../docker/types/RepositoryTag.js"), exports);
+__exportStar(require("../docker/types/ContainerCapability.js"), exports);
+__exportStar(require("../docker/types/ContainerConfig.js"), exports);
+__exportStar(require("../docker/types/ContainerDevice.js"), exports);
+__exportStar(require("../docker/types/ContainerExecResult.js"), exports);
+__exportStar(require("../docker/types/ContainerNetwork.js"), exports);
+__exportStar(require("../docker/types/ContainerPort.js"), exports);
+__exportStar(require("../docker/types/ContainerRestartPolicy.js"), exports);
+__exportStar(require("../docker/types/ContainerState.js"), exports);
+__exportStar(require("../docker/types/ContainerStats.js"), exports);
+__exportStar(require("../docker/types/DockerOutputCallback.js"), exports);
+__exportStar(require("../docker/types/ImageConfig.js"), exports);
+__exportStar(require("../docker/types/ImageExposePort.js"), exports);
+__exportStar(require("../docker/types/NetworkInfo.js"), exports);
+/**
+ * Options
+ */
+__exportStar(require("../docker/options/DockerPruneOptions.js"), exports);
+__exportStar(require("../docker/options/auth/DockerAuthOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerCommitOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerCreateTTYOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerExecOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerKillOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerExportDirectoryOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerLogsOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerRemoveOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerSettingOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerStopOptions.js"), exports);
+__exportStar(require("../docker/options/container/ContainerTTYConsoleSizeOptions.js"), exports);
+__exportStar(require("../docker/options/image/ImageBuildOptions.js"), exports);
+__exportStar(require("../docker/options/image/ImageExportOptions.js"), exports);
+__exportStar(require("../docker/options/image/ImageImportOptions.js"), exports);
+__exportStar(require("../docker/options/image/ImagePullOptions.js"), exports);
+__exportStar(require("../docker/options/image/ImagePushOptions.js"), exports);
+__exportStar(require("../docker/options/image/ImageRemoveOptions.js"), exports);
+__exportStar(require("../docker/options/image/ImageTagOptions.js"), exports);
+__exportStar(require("../docker/options/network/NetworkCreateOptions.js"), exports);
+/**
+ * Exceptions
+ */
+__exportStar(require("../docker/exceptions/DockerConnectionException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerContainerNotFoundException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerImageBuildException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerImageImportException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerImageNotFoundException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerImagePullException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerImagePushException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerImageRepoTagNotFoundException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerNetworkNotFoundException.js"), exports);
+__exportStar(require("../docker/exceptions/DockerRequestException.js"), exports);
+
+//The default of the entry: the entry itself (scripts/package-build/cjs-package.mjs)
+if (!Object.prototype.hasOwnProperty.call(exports, 'default')) Object.defineProperty(exports, 'default', {value: exports})

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/esm/client/BuildContext.js

@@ -0,0 +1,70 @@
+/*
+ * The context of a build: the files of a directory packed into a gzipped tar archive, as dockerode prepares it (with
+ * tar-fs and @balena/dockerignore, see THIRD_PARTY_NOTICES.md), modified: an error of the packing fails the archive
+ * (instead of ending it), and each file is packed once
+ */
+import { createReadStream } from 'node:fs';
+import { lstat, readdir, readFile, readlink } from 'node:fs/promises';
+import path from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { createGzip } from 'node:zlib';
+import { pack as TarPack } from 'tar-stream';
+import { DockerIgnore } from './DockerIgnore.js';
+/**
+ * The path of an entry of the archive ("/" separated, relative)
+ * @param entry
+ */
+function entryName(entry) {
+    return path.posix.normalize(entry.split(path.sep).join('/')).replace(/^(\.\/)+/, '').replace(/\/+$/, '');
+}
+/**
+ * Pack the context of a build: a gzipped tar stream; the files excluded by the .dockerignore of the directory are
+ * skipped. An error of the packing (a file which cannot be read, or changes while it is read) is an error of the stream
+ * @param options
+ */
+export function packBuildContext(options) {
+    const archive = TarPack();
+    const gzip = createGzip();
+    archive.once('error', (error) => gzip.destroy(error));
+    archive.pipe(gzip);
+    (async () => {
+        const root = path.resolve(options.directory);
+        let ignore = new DockerIgnore();
+        try {
+            ignore = new DockerIgnore(await readFile(path.join(root, '.dockerignore'), 'utf8'));
+        }
+        catch {
+            //No .dockerignore
+        }
+        const always = new Set((options.always ?? []).map(entryName));
+        const packed = new Set();
+        const add = async (name) => {
+            if (!name || name === '.' || name.startsWith('../') || packed.has(name))
+                return;
+            if (!always.has(name) && ignore.ignores(name))
+                return;
+            packed.add(name);
+            const file = path.join(root, name);
+            const stats = await lstat(file);
+            const header = { name: name, mode: stats.mode & 0o7777, mtime: stats.mtime, uid: stats.uid, gid: stats.gid };
+            if (stats.isDirectory()) {
+                await new Promise((resolve, reject) => archive.entry({ ...header, type: 'directory' }, (error) => error ? reject(error) : resolve()));
+                for (const child of (await readdir(file)).sort())
+                    await add(`${name}/${child}`);
+            }
+            else if (stats.isSymbolicLink()) {
+                //The links of the images are the ones of Linux: "/" separated (readlink gives backslashes on Windows)
+                const target = (await readlink(file)).split(path.sep).join('/');
+                await new Promise((resolve, reject) => archive.entry({ ...header, type: 'symlink', linkname: target }, (error) => error ? reject(error) : resolve()));
+            }
+            else if (stats.isFile()) {
+                await pipeline(createReadStream(file), archive.entry({ ...header, type: 'file', size: stats.size }));
+            }
+            //The sockets and the pipes are not packed
+        };
+        for (const entry of options.entries)
+            await add(entryName(entry));
+        archive.finalize();
+    })().catch((error) => gzip.destroy(error));
+    return gzip;
+}

package/dist/esm/client/BuildKitProgress.js

@@ -0,0 +1,190 @@
+/**
+ * The progress of the builds of BuildKit: the "aux" of the messages "moby.buildkit.trace" of a build is a StatusResponse
+ * of BuildKit (github.com/moby/buildkit, api/services/control/control.proto), encoded by protobuf then base64. Only the
+ * fields read are decoded, by their numbers in control.proto:
+ *
+ *   StatusResponse: 1 vertexes (Vertex), 2 statuses (VertexStatus), 3 logs (VertexLog), 4 warnings (VertexWarning)
+ *   Vertex: 1 digest, 3 name, 4 cached, 5 started (Timestamp), 6 completed (Timestamp), 7 error
+ *   VertexStatus: 1 ID, 2 vertex, 3 name, 4 current, 5 total, 8 completed (Timestamp)
+ *   VertexLog: 1 vertex, 3 stream, 4 msg
+ *   VertexWarning: 1 vertex, 2 level, 3 short
+ *   Timestamp (google.protobuf): 1 seconds, 2 nanos
+ */
+/**
+ * The fields of a protobuf message (the wire format: varints, 64 and 32 bits values, length-delimited values)
+ * @param buffer
+ */
+function protobufFields(buffer) {
+    const fields = [];
+    let offset = 0;
+    const varint = () => {
+        let result = 0n;
+        let shift = 0n;
+        while (offset < buffer.length) {
+            const byte = buffer[offset++];
+            result |= BigInt(byte & 0x7f) << shift;
+            if (!(byte & 0x80))
+                return result;
+            shift += 7n;
+        }
+        throw new Error('Truncated protobuf varint');
+    };
+    while (offset < buffer.length) {
+        const key = Number(varint());
+        const number = key >>> 3;
+        switch (key & 0x07) {
+            case 0:
+                fields.push({ number: number, value: varint() });
+                break;
+            case 1:
+                fields.push({ number: number, value: buffer.readBigUInt64LE(offset) });
+                offset += 8;
+                break;
+            case 2: {
+                const length = Number(varint());
+                if (offset + length > buffer.length)
+                    throw new Error('Truncated protobuf value');
+                fields.push({ number: number, value: buffer.subarray(offset, offset + length) });
+                offset += length;
+                break;
+            }
+            case 5:
+                fields.push({ number: number, value: BigInt(buffer.readUInt32LE(offset)) });
+                offset += 4;
+                break;
+            default:
+                throw new Error(`Unsupported protobuf wire type ${key & 0x07}`);
+        }
+    }
+    return fields;
+}
+const text = (value) => Buffer.isBuffer(value) ? value.toString() : '';
+const bytes = (value) => Buffer.isBuffer(value) ? value : Buffer.alloc(0);
+const integer = (value) => Buffer.isBuffer(value) ? 0 : Number(BigInt.asIntN(64, value));
+/**
+ * A google.protobuf.Timestamp, in milliseconds since the epoch
+ * @param value
+ */
+function timestamp(value) {
+    if (!Buffer.isBuffer(value))
+        return undefined;
+    let seconds = 0;
+    let nanos = 0;
+    for (const field of protobufFields(value)) {
+        if (field.number === 1)
+            seconds = integer(field.value);
+        if (field.number === 2)
+            nanos = integer(field.value);
+    }
+    //The zero timestamp is not set
+    return seconds || nanos ? seconds * 1000 + Math.floor(nanos / 1e6) : undefined;
+}
+/**
+ * Decode the progress of a build: the "aux" of a message "moby.buildkit.trace"
+ * @param aux the base64 of a StatusResponse
+ */
+export function decodeBuildKitStatus(aux) {
+    const status = { vertexes: [], statuses: [], logs: [], warnings: [] };
+    for (const field of protobufFields(Buffer.from(aux, 'base64'))) {
+        const message = protobufFields(bytes(field.value));
+        const get = (number) => message.find((candidate) => candidate.number === number)?.value;
+        switch (field.number) {
+            case 1:
+                status.vertexes.push({
+                    digest: text(get(1) ?? 0n),
+                    name: text(get(3) ?? 0n),
+                    cached: integer(get(4) ?? 0n) === 1,
+                    started: timestamp(get(5) ?? 0n),
+                    completed: timestamp(get(6) ?? 0n),
+                    error: text(get(7) ?? 0n) || undefined
+                });
+                break;
+            case 2:
+                status.statuses.push({
+                    id: text(get(1) ?? 0n),
+                    vertex: text(get(2) ?? 0n),
+                    name: text(get(3) ?? 0n),
+                    current: integer(get(4) ?? 0n),
+                    total: integer(get(5) ?? 0n),
+                    completed: timestamp(get(8) ?? 0n)
+                });
+                break;
+            case 3:
+                status.logs.push({ vertex: text(get(1) ?? 0n), stream: integer(get(3) ?? 0n), message: bytes(get(4) ?? 0n) });
+                break;
+            case 4:
+                status.warnings.push({ vertex: text(get(1) ?? 0n), level: integer(get(2) ?? 0n), short: text(get(3) ?? 0n) });
+                break;
+        }
+    }
+    return status;
+}
+/**
+ * The lines of the progress of a build, as "docker build --progress=plain" shows them: the steps are numbered in their
+ * order ("#3 [2/2] RUN npm ci"), with their output, and whether they are cached, done ("#3 DONE 1.2s") or failed
+ */
+export class BuildKitProgress {
+    #steps = new Map();
+    /**
+     * The incomplete last line of the output of each step
+     */
+    #pending = new Map();
+    /**
+     * The number of a step, given when it is first seen
+     * @param digest
+     */
+    step(digest) {
+        let step = this.#steps.get(digest);
+        if (!step)
+            this.#steps.set(digest, step = { number: this.#steps.size + 1, started: false, ended: false });
+        return step;
+    }
+    /**
+     * The lines of a status of the build
+     * @param status
+     */
+    lines(status) {
+        const lines = [];
+        for (const vertex of status.vertexes) {
+            const step = this.step(vertex.digest);
+            if (!step.started && (vertex.started || vertex.cached)) {
+                step.started = true;
+                lines.push(`#${step.number} ${vertex.name}`);
+            }
+            if (step.ended)
+                continue;
+            if (vertex.cached) {
+                step.ended = true;
+                lines.push(`#${step.number} CACHED`);
+            }
+            else if (vertex.error) {
+                step.ended = true;
+                lines.push(...this.flush(vertex.digest), `#${step.number} ERROR: ${vertex.error}`);
+            }
+            else if (vertex.completed) {
+                step.ended = true;
+                const seconds = vertex.started ? ` ${((vertex.completed - vertex.started) / 1000).toFixed(1)}s` : '';
+                lines.push(...this.flush(vertex.digest), `#${step.number} DONE${seconds}`);
+            }
+        }
+        for (const log of status.logs) {
+            const output = (this.#pending.get(log.vertex) ?? '') + log.message.toString();
+            const parts = output.split(/\r?\n/);
+            this.#pending.set(log.vertex, parts.pop());
+            const number = this.step(log.vertex).number;
+            parts.forEach((part) => lines.push(`#${number} ${part}`));
+        }
+        for (const warning of status.warnings)
+            lines.push(`#${this.step(warning.vertex).number} WARN: ${warning.short}`);
+        return lines;
+    }
+    /**
+     * The incomplete last line of the output of a step
+     * @param digest
+     */
+    flush(digest) {
+        const pending = this.#pending.get(digest);
+        this.#pending.delete(digest);
+        return pending ? [`#${this.step(digest).number} ${pending}`] : [];
+    }
+}