@mark1russell7/harness 0.11.2 → 0.11.3

package/build/schema.d.ts

@@ -0,0 +1,19 @@
+import { J as Subject, _ as ImageSource, i as ClientImage, r as Client } from "./cell-BmSnJJtn.js";
+import { z } from "zod";
+//#region src/schema.d.ts
+/**
+ * This schema accepts the source of an image (`ImageSource`). It is a pinned image with its digest,
+ * a build context whose paths stay in it, or an image that the harness ships.
+ */
+export declare const imageSourceSchema: z.ZodType<ImageSource>;
+/** This schema accepts a client image (`ClientImage`): a stock image by its name or the source of an image, and its command. */
+export declare const clientImageSchema: z.ZodType<ClientImage>;
+/** This schema accepts the client of a cell (`Cell.client`): a client that the harness ships by its name, or a client image. */
+export declare const clientSchema: z.ZodType<Client | ClientImage>;
+/**
+ * This schema accepts a subject (`Subject`): its name, the source of its image and its stock base.
+ * It also accepts the command of each of its programs.
+ */
+export declare const subjectSchema: z.ZodType<Subject>;
+//#endregion
+//# sourceMappingURL=schema.d.ts.map

package/build/schema.js

@@ -0,0 +1,56 @@
+import { a as SHIPPED_NAMES, t as CLIENT_NAMES, u as imageProblems, x as subjectProblems } from "./image-Q_fs3rCC.js";
+import { z } from "zod";
+//#region src/schema.ts
+/** This function adds each problem that a check finds as an issue of a schema. */
+const issues = (check) => (value, ctx) => {
+	for (const message of check(value)) ctx.addIssue({
+		code: "custom",
+		message
+	});
+};
+/** This schema accepts a command: argv of one text or more. */
+const command = z.array(z.string().min(1)).min(1);
+/** This schema accepts the shape of each kind of image source. The checks of its values come after it. */
+const sourceShape = z.discriminatedUnion("kind", [
+	z.strictObject({
+		kind: z.literal("pinned"),
+		image: z.string()
+	}),
+	z.strictObject({
+		kind: z.literal("build"),
+		name: z.string(),
+		context: z.string(),
+		dockerfile: z.string().optional(),
+		files: z.array(z.string()).optional()
+	}),
+	z.strictObject({
+		kind: z.literal("shipped"),
+		name: z.enum(SHIPPED_NAMES)
+	})
+]);
+/**
+* This schema accepts the source of an image (`ImageSource`). It is a pinned image with its digest,
+* a build context whose paths stay in it, or an image that the harness ships.
+*/
+const imageSourceSchema = sourceShape.superRefine(issues(imageProblems));
+/** This schema accepts a client image (`ClientImage`): a stock image by its name or the source of an image, and its command. */
+const clientImageSchema = z.strictObject({
+	image: z.union([z.string().min(1), imageSourceSchema]),
+	command
+});
+/** This schema accepts the client of a cell (`Cell.client`): a client that the harness ships by its name, or a client image. */
+const clientSchema = z.union([z.enum(CLIENT_NAMES), clientImageSchema]);
+/**
+* This schema accepts a subject (`Subject`): its name, the source of its image and its stock base.
+* It also accepts the command of each of its programs.
+*/
+const subjectSchema = z.strictObject({
+	name: z.string().min(1),
+	image: sourceShape,
+	base: z.string(),
+	programs: z.record(z.string(), command)
+}).superRefine(issues(subjectProblems));
+//#endregion
+export { clientImageSchema, clientSchema, imageSourceSchema, subjectSchema };
+
+//# sourceMappingURL=schema.js.map

package/build/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../src/schema.ts"],"sourcesContent":["// The entry \"@mark1russell7/harness/schema\": the zod schemas of the data that a caller gives the\n// harness as JSON. These are the source of an image, a client and a subject. The root entry of\n// the package does not import zod.\nimport { z } from \"zod\";\nimport type { Client, ClientImage, ImageSource, Subject } from \"./cell.ts\";\nimport { CLIENT_NAMES, SHIPPED_NAMES, imageProblems, subjectProblems } from \"./image.ts\";\n\n/** This function adds each problem that a check finds as an issue of a schema. */\nconst issues =\n  <T>(check: (value: T) => string[]) =>\n  (value: T, ctx: z.RefinementCtx): void => {\n    for (const message of check(value)) ctx.addIssue({ code: \"custom\", message });\n  };\n\n/** This schema accepts a command: argv of one text or more. */\nconst command = z.array(z.string().min(1)).min(1);\n\n/** This schema accepts the shape of each kind of image source. The checks of its values come after it. */\nconst sourceShape = z.discriminatedUnion(\"kind\", [\n  z.strictObject({ kind: z.literal(\"pinned\"), image: z.string() }),\n  z.strictObject({\n    kind: z.literal(\"build\"),\n    name: z.string(),\n    context: z.string(),\n    dockerfile: z.string().optional(),\n    files: z.array(z.string()).optional(),\n  }),\n  z.strictObject({ kind: z.literal(\"shipped\"), name: z.enum(SHIPPED_NAMES) }),\n]);\n\n/**\n * This schema accepts the source of an image (`ImageSource`). It is a pinned image with its digest,\n * a build context whose paths stay in it, or an image that the harness ships.\n */\nexport const imageSourceSchema: z.ZodType<ImageSource> = sourceShape.superRefine(issues(imageProblems));\n\n/** This schema accepts a client image (`ClientImage`): a stock image by its name or the source of an image, and its command. */\nexport const clientImageSchema: z.ZodType<ClientImage> = z.strictObject({\n  image: z.union([z.string().min(1), imageSourceSchema]),\n  command,\n});\n\n/** This schema accepts the client of a cell (`Cell.client`): a client that the harness ships by its name, or a client image. */\nexport const clientSchema: z.ZodType<Client | ClientImage> = z.union([z.enum(CLIENT_NAMES), clientImageSchema]);\n\n/**\n * This schema accepts a subject (`Subject`): its name, the source of its image and its stock base.\n * It also accepts the command of each of its programs.\n */\nexport const subjectSchema: z.ZodType<Subject> = z\n  .strictObject({\n    name: z.string().min(1),\n    image: sourceShape,\n    base: z.string(),\n    programs: z.record(z.string(), command),\n  })\n  .superRefine(issues(subjectProblems));\n"],"mappings":";;;;AAQA,MAAM,UACA,WACH,OAAU,QAA+B;CACxC,KAAK,MAAM,WAAW,MAAM,KAAK,GAAG,IAAI,SAAS;EAAE,MAAM;EAAU;CAAQ,CAAC;AAC9E;;AAGF,MAAM,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;;AAGhD,MAAM,cAAc,EAAE,mBAAmB,QAAQ;CAC/C,EAAE,aAAa;EAAE,MAAM,EAAE,QAAQ,QAAQ;EAAG,OAAO,EAAE,OAAO;CAAE,CAAC;CAC/D,EAAE,aAAa;EACb,MAAM,EAAE,QAAQ,OAAO;EACvB,MAAM,EAAE,OAAO;EACf,SAAS,EAAE,OAAO;EAClB,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS;EAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS;CACtC,CAAC;CACD,EAAE,aAAa;EAAE,MAAM,EAAE,QAAQ,SAAS;EAAG,MAAM,EAAE,KAAK,aAAa;CAAE,CAAC;AAC5E,CAAC;;;;;AAMD,MAAa,oBAA4C,YAAY,YAAY,OAAO,aAAa,CAAC;;AAGtG,MAAa,oBAA4C,EAAE,aAAa;CACtE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC;CACrD;AACF,CAAC;;AAGD,MAAa,eAAgD,EAAE,MAAM,CAAC,EAAE,KAAK,YAAY,GAAG,iBAAiB,CAAC;;;;;AAM9G,MAAa,gBAAoC,EAC9C,aAAa;CACZ,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,OAAO;CACP,MAAM,EAAE,OAAO;CACf,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;AACxC,CAAC,CAAC,CACD,YAAY,OAAO,eAAe,CAAC"}

package/image/pg/client-pg.mjs

@@ -8,6 +8,8 @@
 //
 // The lines:
 // - start: the versions of pg, pg-pool and Node, the mode and the options of the pool.
+// - connecting: the first query, which makes the first connection of the pool. Its stamp is the
+//   stamp of the first sent line. The pool arms its connect timer in that call.
 // - socket, socket-end, socket-error: each socket of the pool, with its local address.
 // - connected: the first socket. The TCP client of the harness names its own socket so.
 // - pool: each event of the pool: connect, acquire, release, remove, and error with its errno.
@@ -118,6 +120,8 @@ setTimeout(() => {
 const operate = async (n) => {
   const at = now();
   const reply = pool.query(query);
+  // a band of a cell that starts into a fault counts from the start of the first connect
+  if (n === 1) emit("connecting", { at: `${host}:${port}` }, at);
   emit("sent", { n }, at);
   try {
     const result = await reply;

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@mark1russell7/harness",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "description": "A fault-injection harness for connection timers: a cell runs a client against a stock target in Docker, through a topology of routers and proxies, a replicated group under Sentinels or a replica set, injects a fault, measures the kernel's own records and judges a prediction. HTTP clients of Go, Node and undici race the keep-alive of a Node server, and the MongoDB driver meets the faults of a replica set. The WebSocket client of @procedures/client drops a silent connection on its own heartbeat, and the harness times that detection and the reconnect from the program's lines and the kernel's stamps.",
   "keywords": [
     "fault-injection",
@@ -33,6 +33,10 @@
       "types": "./build/index.d.ts",
       "default": "./build/index.js"
     },
+    "./schema": {
+      "types": "./build/schema.d.ts",
+      "default": "./build/schema.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [