@mark1russell7/harness 0.11.1 → 0.11.2

package/README.md

@@ -129,6 +129,7 @@ The harness builds six images. The tag of each image comes from the content of a
 - **The Node client image** (`image/node`) is a driver client: ioredis 6.0.0 on Node 24.21.0. The digest of the image and an npm lockfile pin them. `client-ioredis.mjs` prints the lines of the TCP client on the same clock, and it adds the status changes of ioredis as `status` lines. The same image holds the client of a group in Sentinel mode (`client-sentinel.mjs`) and the observer of its Sentinels (`observer.mjs`).
 - **The Go HTTP image** (`image/go-http`) is the `http.Transport` of Go 1.27.2 at its defaults (`client-go`). The program uses the standard library only, thus the digest of the Go builder pins all of its code. The build does `gofmt` and `go vet` first. A wrapper on each connection writes what the read loop of the transport reads. The trace of the transport writes each try of a request.
 - **The Node HTTP image** (`image/node-http`) holds the `http.Agent` of Node 24.21.0 (`client-agent.mjs`) and an HTTP/1.1 `Client` of undici 8.12.2 (`client-undici.mjs`). The digest of the image and an npm lockfile pin them. It is apart from the image of ioredis, thus the cells of ioredis keep their image.
+- **The PostgreSQL client image** (`image/pg`) is node-postgres: pg 8.23.1 with pg-pool 3.14.0 on Node 24.21.0. The digest of the image and an npm lockfile pin them. `client-pg.mjs` makes one `pg.Pool` with the options of the cell (`Cell.driverOptions`), and it prints the lines of the TCP client on the same clock. The first query makes the connection, and the reply gives the client back to the pool, where it is idle. An error of the pool for that idle client is the detection of an idle cell. The probe is `{ driver: { name: "pg", query } }`, with `SELECT 1` as the query when the cell gives none.
 - **The MongoDB client image** (`image/mongo`) is the driver mongodb 7.7.0 on Node 24.21.0. The digest of the image and an npm lockfile pin them. `client-mongo.mjs` prints the lines of the TCP client on the same clock:
   - Each socket of the driver is a `socket` line with its role: `monitor`, `rtt` or `pool`. The stack of the call that makes the socket gives the role.
   - The events of the driver are `sdam` lines (the heartbeats and the changes of each server), `cmap` lines (the pools) and `command` lines (each try of an operation).

package/build/index.d.ts

@@ -566,10 +566,10 @@ type HarnessImage = "procedures";
 /**
  * A client is what the runs of a cell use: the TCP client of the harness, or a driver on its
  * socket. The HTTP clients are the `http.Transport` of Go (`go-http`), the `http.Agent` of Node
- * (`http-agent`) and an HTTP/1.1 `Client` of undici (`undici`). The MongoDB driver is `mongodb`, and the WebSocket client of
- * `@procedures/client` is `procedures-ws`.
+ * (`http-agent`) and an HTTP/1.1 `Client` of undici (`undici`). The MongoDB driver is `mongodb`, node-postgres is `pg`, and
+ * the WebSocket client of `@procedures/client` is `procedures-ws`.
  */
-type Client = "tcp" | "ioredis" | "go-http" | "http-agent" | "undici" | "mongodb" | "procedures-ws";
+type Client = "tcp" | "ioredis" | "go-http" | "http-agent" | "undici" | "mongodb" | "pg" | "procedures-ws";
 /**
  * A WebSocket probe is the workload and the settings of the WebSocket client of
  * `@procedures/client` (`procedures-ws`). The cell gives each setting, thus the client takes
@@ -683,6 +683,8 @@ interface Cell {
      * - ioredis 6 on Node, whose keepAlive is the keepalive delay of the socket.
      * - the MongoDB driver on Node, against the replica set `set`. Its operation is a write, or
      *   the read of a long document (`read-long`). `Cell.driverOptions` are its options.
+     * - node-postgres on Node, as a `pg.Pool` against one server. Its operation is `query`, or
+     *   `SELECT 1`. `Cell.driverOptions` are the options of its pool.
      */
     readonly driver?: {
       readonly name: "ioredis";
@@ -691,6 +693,9 @@ interface Cell {
       readonly name: "mongodb";
       readonly set: string;
       readonly op?: "write" | "read-long";
+    } | {
+      readonly name: "pg";
+      readonly query?: string;
     };
     /** This workload is the workload of an HTTP client (`Cell.client` is an HTTP client). The client then ignores `keepalive` and `userTimeout`. */
     readonly http?: HttpProbe;
@@ -1574,6 +1579,8 @@ export declare const goHttpImage: () => Promise<string>;
 export declare const nodeHttpImage: () => Promise<string>;
 /** This function gives the image of the MongoDB client. */
 export declare const mongoClientImage: () => Promise<string>;
+/** This function gives the image of the PostgreSQL client. */
+export declare const pgClientImage: () => Promise<string>;
 /** This function gives the image of `@procedures/client`: its WebSocket client and its server. */
 export declare const proceduresImage: () => Promise<string>;
 /** This function gives the image that a target operates: its stock image, or an image of the harness (`Target.harness`). */

package/build/index.js

@@ -1953,6 +1953,12 @@ const MONGO = {
 	dockerfile: "harness/image/mongo/Dockerfile",
 	from: ["harness/image/mongo"]
 };
+/** This image holds the PostgreSQL client: node-postgres (pg 8.23.1 with pg-pool 3.14.0) on Node 24.21.0. */
+const PG = {
+	name: "loom-harness-pg",
+	dockerfile: "harness/image/pg/Dockerfile",
+	from: ["harness/image/pg"]
+};
 /** This image holds `@procedures/client` 0.7.0 on Node 24.21.0: its WebSocket client as a client of the harness, and the script of its server. */
 const PROCEDURES = {
 	name: "loom-harness-procedures",
@@ -2031,6 +2037,8 @@ const goHttpImage = () => build(GO_HTTP);
 const nodeHttpImage = () => build(NODE_HTTP);
 /** This function gives the image of the MongoDB client. */
 const mongoClientImage = () => build(MONGO);
+/** This function gives the image of the PostgreSQL client. */
+const pgClientImage = () => build(PG);
 /** This function gives the image of `@procedures/client`: its WebSocket client and its server. */
 const proceduresImage = () => build(PROCEDURES);
 /** This function gives the image that a target operates: its stock image, or an image of the harness (`Target.harness`). */
@@ -2228,6 +2236,11 @@ const clientOf = async (kind, image) => {
 		command: ["node", "/opt/harness/mongo/client-mongo.mjs"],
 		clientKind: kind
 	};
+	if (kind === "pg") return {
+		clientImage: await pgClientImage(),
+		command: ["node", "/opt/harness/pg/client-pg.mjs"],
+		clientKind: kind
+	};
 	if (kind === "procedures-ws") return {
 		clientImage: await proceduresImage(),
 		command: ["node", "/opt/harness/procedures/client-ws.mjs"],
@@ -4236,6 +4249,13 @@ const probeArgs = (cell, lab) => {
 		args.push("--max-s", String(Math.ceil(longest * 2 + 10)));
 		return args;
 	}
+	if (probe.driver?.name === "pg") {
+		if (probe.driver.query !== void 0) args.push("--query", probe.driver.query);
+		if (cell.before === true) args.push("--before");
+		if (cell.driverOptions !== void 0) args.push("--options", JSON.stringify(cell.driverOptions));
+		args.push("--max-s", String(Math.ceil(longest * 2 + 10)));
+		return args;
+	}
 	if (probe.driver !== void 0) {
 		args.push("--keepalive-ms", String(valueIn(probe.driver.keepAlive, "ms")));
 		args.push("--max-s", String(Math.ceil(longest * 2 + 10)));
@@ -4763,6 +4783,6 @@ const runCell = async (cell, say = () => {}) => {
 	}
 };
 //#endregion
-export { CONVERGE_MS, INJECT, KEPT, LINGER_MS, LISTING, MEMBER_MARKS, NOISE, PUMP, QUIET_MS, RELATIVE, REPLICA_SET_STAGES, STAGES, STATUS_SCRIPT, STEPS, STEP_DOWN, callOf, clockOffsetOf, closeOrExit, crossingsOf, cutOf, deadlineOf, delayVoids, deviceOf, dropFinding, dropOf, endpointAfter, errorsOf, exitOf, fieldOf, fieldsOf, firstUnanswered, goHttpImage, groupOnce, groupVerdictOf, harnessImage, hzOf, infoOf, initiateScript, isHopPlace, judge, lagsOf, latestEndOf, leftAfter, matches, measure, measureDriver, measureGroup, medianInterval, memberCommand, memberConfig, memberLineOf, mongoClientImage, nodeClientImage, nodeHttpImage, noiseOf, onMonotonic, openGroupLab, openLab, openReplicaSetLab, peersOf, pingsOf, proceduresImage, programLines, quantileOf, reconnectFinding, reconnectOf, referenceOf, reorderingOf, replicaSetArgs, replicaSetOnce, replicaSetStagesOf, requestOf, requestWords, routerImage, routesOf, runCell, sentinelConfig, socketAt, socketOf, socketsOf, spread, spreadOf, stagesOf, statusViewOf, subscriptionsOf, targetImageOf, templated, toxicBody, verdictOf, viewOf, writesOf };
+export { CONVERGE_MS, INJECT, KEPT, LINGER_MS, LISTING, MEMBER_MARKS, NOISE, PUMP, QUIET_MS, RELATIVE, REPLICA_SET_STAGES, STAGES, STATUS_SCRIPT, STEPS, STEP_DOWN, callOf, clockOffsetOf, closeOrExit, crossingsOf, cutOf, deadlineOf, delayVoids, deviceOf, dropFinding, dropOf, endpointAfter, errorsOf, exitOf, fieldOf, fieldsOf, firstUnanswered, goHttpImage, groupOnce, groupVerdictOf, harnessImage, hzOf, infoOf, initiateScript, isHopPlace, judge, lagsOf, latestEndOf, leftAfter, matches, measure, measureDriver, measureGroup, medianInterval, memberCommand, memberConfig, memberLineOf, mongoClientImage, nodeClientImage, nodeHttpImage, noiseOf, onMonotonic, openGroupLab, openLab, openReplicaSetLab, peersOf, pgClientImage, pingsOf, proceduresImage, programLines, quantileOf, reconnectFinding, reconnectOf, referenceOf, reorderingOf, replicaSetArgs, replicaSetOnce, replicaSetStagesOf, requestOf, requestWords, routerImage, routesOf, runCell, sentinelConfig, socketAt, socketOf, socketsOf, spread, spreadOf, stagesOf, statusViewOf, subscriptionsOf, targetImageOf, templated, toxicBody, verdictOf, viewOf, writesOf };
 
 //# sourceMappingURL=index.js.map