@glion/mllp-client 0.19.0 → 0.21.0

package/dist/runtime/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../src/runtime/workers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AAIxD,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,UAAU,CAoDpE"}

package/dist/runtime/workers.js

@@ -0,0 +1,70 @@
+import { t as MllpInvalidOptionError } from "../chunks/mllp-invalid-option-error.js";
+import { connect } from "cloudflare:sockets";
+//#region src/runtime/workers.ts
+/**
+* Cloudflare Workers runtime adapter for `MllpClient`: one socket over
+* `cloudflare:sockets`. Framing and stream ownership belong to the layer
+* above.
+*
+* @module
+*/
+/**
+* A TCP socket to one remote system, over `cloudflare:sockets`.
+*
+* Each `connect()` opens a fresh socket.
+*
+* @throws {MllpInvalidOptionError} `tls` is not a boolean.
+*/
+function workersSocket(opts) {
+	const { tls = false } = opts;
+	if (typeof tls !== "boolean") throw new MllpInvalidOptionError("tls must be true or false on Workers, which applies no CA, client certificate, or server name.");
+	let open;
+	return {
+		async close() {
+			const socket = open;
+			open = void 0;
+			await socket?.close();
+		},
+		async connect(signal) {
+			signal.throwIfAborted();
+			const socket = connect({
+				hostname: opts.host,
+				port: opts.port
+			}, {
+				allowHalfOpen: false,
+				secureTransport: tls ? "on" : "off"
+			});
+			const listener = new AbortController();
+			try {
+				await Promise.race([socket.opened, aborted(signal, listener.signal)]);
+			} catch (error) {
+				if (!signal.aborted) throw error;
+				socket.close().catch(() => {});
+				throw signal.reason;
+			} finally {
+				listener.abort();
+			}
+			open = socket;
+			return {
+				readable: socket.readable,
+				writable: socket.writable
+			};
+		}
+	};
+}
+/**
+* Rejects with `signal.reason` once `signal` aborts, unless `until` aborts
+* first.
+*/
+function aborted(signal, until) {
+	return new Promise((_resolve, reject) => {
+		signal.addEventListener("abort", () => reject(signal.reason), {
+			once: true,
+			signal: until
+		});
+	});
+}
+//#endregion
+export { workersSocket };
+
+//# sourceMappingURL=workers.js.map

package/dist/runtime/workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.js","names":[],"sources":["../../src/runtime/workers.ts"],"sourcesContent":["/**\n * Cloudflare Workers runtime adapter for `MllpClient`: one socket over\n * `cloudflare:sockets`. Framing and stream ownership belong to the layer\n * above.\n *\n * @module\n */\n\nimport { connect } from \"cloudflare:sockets\";\n\nimport { MllpInvalidOptionError } from \"../errors/mllp-invalid-option-error\";\nimport type { MllpSocket, MllpStreams } from \"../types\";\n\ntype Socket = ReturnType<typeof connect>;\n\nexport interface WorkersSocketOptions {\n  /** Host name or address of the remote system. */\n  readonly host: string;\n  /** TCP port of the remote system. */\n  readonly port: number;\n  /**\n   * TLS for the connection. `true`: verify the remote system's certificate\n   * against the public CAs Workers trusts, for `host`. `false`: plain TCP.\n   *\n   * Workers takes no CA, client certificate, or server name. A remote system\n   * MUST present a publicly trusted certificate for `host`.\n   *\n   * @default false\n   */\n  readonly tls?: boolean;\n}\n\n/**\n * A TCP socket to one remote system, over `cloudflare:sockets`.\n *\n * Each `connect()` opens a fresh socket.\n *\n * @throws {MllpInvalidOptionError} `tls` is not a boolean.\n */\nexport function workersSocket(opts: WorkersSocketOptions): MllpSocket {\n  const { tls = false } = opts;\n  if (typeof tls !== \"boolean\") {\n    throw new MllpInvalidOptionError(\n      \"tls must be true or false on Workers, which applies no CA, client certificate, or server name.\"\n    );\n  }\n  let open: Socket | undefined;\n\n  return {\n    async close(): Promise<void> {\n      const socket = open;\n      open = undefined;\n      await socket?.close();\n    },\n\n    async connect(signal: AbortSignal): Promise<MllpStreams> {\n      signal.throwIfAborted();\n      // `connect()` returns at once with the dial in progress; `opened`\n      // settles when the handshake does.\n      const socket = connect(\n        { hostname: opts.host, port: opts.port },\n        { allowHalfOpen: false, secureTransport: tls ? \"on\" : \"off\" }\n      );\n      // Raced, not awaited: `opened` alone would hold a cancelled attempt\n      // until the dial times out. `listener` is the abort listener's\n      // lifetime: aborting it removes the listener once the race is decided,\n      // so nothing stays subscribed to `signal`.\n      const listener = new AbortController();\n      try {\n        await Promise.race([socket.opened, aborted(signal, listener.signal)]);\n      } catch (error) {\n        // Two ways here: the dial failed (`opened` rejected), or the caller\n        // cancelled. A failed dial is reported as it is. A cancelled one is\n        // reported as the cancellation; its socket is closed without waiting,\n        // since workerd settles that close only once the dial does, and then\n        // with the dial's own failure, which nobody is left to act on.\n        if (!signal.aborted) {\n          throw error;\n        }\n        // oxlint-disable-next-line promise/prefer-await-to-then -- awaiting would wait out the dial\n        socket.close().catch(() => {});\n        throw signal.reason;\n      } finally {\n        listener.abort();\n      }\n      // Only an opened socket is held, so `close()` has something to end\n      // exactly when `connect()` fulfilled.\n      open = socket;\n      return { readable: socket.readable, writable: socket.writable };\n    },\n  };\n}\n\n/**\n * Rejects with `signal.reason` once `signal` aborts, unless `until` aborts\n * first.\n */\nfunction aborted(signal: AbortSignal, until: AbortSignal): Promise<never> {\n  // oxlint-disable-next-line promise/avoid-new -- wrapping an abort event\n  return new Promise((_resolve, reject) => {\n    signal.addEventListener(\"abort\", () => reject(signal.reason), {\n      once: true,\n      signal: until,\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAuCA,SAAgB,cAAc,MAAwC;CACpE,MAAM,EAAE,MAAM,UAAU;AACxB,KAAI,OAAO,QAAQ,UACjB,OAAM,IAAI,uBACR,iGACD;CAEH,IAAI;AAEJ,QAAO;EACL,MAAM,QAAuB;GAC3B,MAAM,SAAS;AACf,UAAO,KAAA;AACP,SAAM,QAAQ,OAAO;;EAGvB,MAAM,QAAQ,QAA2C;AACvD,UAAO,gBAAgB;GAGvB,MAAM,SAAS,QACb;IAAE,UAAU,KAAK;IAAM,MAAM,KAAK;IAAM,EACxC;IAAE,eAAe;IAAO,iBAAiB,MAAM,OAAO;IAAO,CAC9D;GAKD,MAAM,WAAW,IAAI,iBAAiB;AACtC,OAAI;AACF,UAAM,QAAQ,KAAK,CAAC,OAAO,QAAQ,QAAQ,QAAQ,SAAS,OAAO,CAAC,CAAC;YAC9D,OAAO;AAMd,QAAI,CAAC,OAAO,QACV,OAAM;AAGR,WAAO,OAAO,CAAC,YAAY,GAAG;AAC9B,UAAM,OAAO;aACL;AACR,aAAS,OAAO;;AAIlB,UAAO;AACP,UAAO;IAAE,UAAU,OAAO;IAAU,UAAU,OAAO;IAAU;;EAElE;;;;;;AAOH,SAAS,QAAQ,QAAqB,OAAoC;AAExE,QAAO,IAAI,SAAS,UAAU,WAAW;AACvC,SAAO,iBAAiB,eAAe,OAAO,OAAO,OAAO,EAAE;GAC5D,MAAM;GACN,QAAQ;GACT,CAAC;GACF"}

package/dist/state.d.ts

@@ -22,18 +22,21 @@ export type State = {
 } | {
     readonly phase: "sending";
     readonly session: MllpSession;
-    /** MSH-10 of the message waiting for its acknowledgment. */
-    readonly controlId: string;
-    /** Settles when the send is over, however it ended. */
-    readonly done: Promise<unknown>;
 } | {
     readonly phase: "closing";
-    readonly session: MllpSession;
-    /** The send `close()` is waiting out. */
-    readonly done: Promise<unknown>;
+    /** The failure the client is closing on, or `null` when the owner is. */
+    readonly reason: MllpClientError | null;
+    /** The session being ended, or `null` when it is the dial. */
+    readonly session: MllpSession | null;
+    /** Settles once the client is `closed`. */
+    readonly closed: Promise<unknown>;
 } | {
     readonly phase: "closed";
     /** The failure that closed the client, or `null` when the owner did. */
     readonly reason: MllpClientError | null;
 };
+/** The phases with something open: the dial, or the session. */
+export type Open = Extract<State, {
+    phase: "connecting" | "connected" | "sending";
+}>;
 //# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,KAAK,GACb;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B;IACE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CACzC,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,KAAK,GACb;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B;IACE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CACzC,CAAC;AAEN,gEAAgE;AAChE,MAAM,MAAM,IAAI,GAAG,OAAO,CACxB,KAAK,EACL;IAAE,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS,CAAA;CAAE,CAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glion/mllp-client",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "Persistent, single-flight MLLP client for HL7v2",
   "keywords": [
     "health",
@@ -29,24 +29,30 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
-    "./node": "./dist/runtime/node.js"
+    "./node": "./dist/runtime/node.js",
+    "./workers": "./dist/runtime/workers.js"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@glion/ack": "0.19.0",
-    "@glion/ast": "0.19.0",
-    "@glion/mllp-codec": "0.19.0",
-    "@glion/to-hl7v2": "0.19.0",
-    "@glion/util-charset": "0.19.0",
-    "@glion/parser": "0.19.0",
-    "@glion/util-query": "0.19.0"
+    "@glion/ack": "0.21.0",
+    "@glion/ast": "0.21.0",
+    "@glion/mllp-codec": "0.21.0",
+    "@glion/parser": "0.21.0",
+    "@glion/to-hl7v2": "0.21.0",
+    "@glion/util-charset": "0.21.0",
+    "@glion/util-query": "0.21.0"
   },
   "devDependencies": {
+    "@cloudflare/vitest-plugin": "1.3.7",
+    "@cloudflare/workers-types": "5.20261007.1",
+    "@stryker-mutator/core": "10.0.0",
+    "@stryker-mutator/vitest-runner": "10.0.0",
     "@types/node": "25.6.0",
     "@vitest/coverage-v8": "4.1.11",
     "publint": "0.3.18",
+    "selfsigned": "5.5.0",
     "tsdown": "0.21.10",
     "typescript": "6.0.3",
     "vitest": "4.1.11",
@@ -54,16 +60,27 @@
     "@glion/testing": "0.18.0",
     "@glion/tsconfig": "0.18.0"
   },
+  "peerDependencies": {
+    "@types/node": ">=22"
+  },
+  "peerDependenciesMeta": {
+    "@types/node": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=22"
   },
   "scripts": {
     "build": "tsdown && tsc --emitDeclarationOnly",
-    "check-types": "tsc --noEmit && tsc --noEmit -p tests/tsconfig.json",
+    "check-types": "tsc --noEmit && tsc --noEmit -p tests/tsconfig.json && tsc -p tsconfig.cloudflare.json",
     "check:readme": "glion-check-readme",
+    "mutate": "stryker run",
+    "publint": "publint --strict",
     "test": "vitest run",
+    "test:cf": "vitest run --config vitest.workers.config.ts",
     "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest",
-    "publint": "publint --strict"
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:watch": "vitest"
   }
 }

package/dist/errors/mllp-already-sending-error.d.ts

@@ -1,14 +0,0 @@
-import { MllpClientError } from "./base";
-/**
- * `send()` was called while another message was still waiting for its
- * acknowledgment. The client sends one message at a time.
- */
-export declare class MllpAlreadySendingError extends MllpClientError {
-    readonly name = "MllpAlreadySendingError";
-    readonly code: "ALREADY_SENDING";
-    readonly delivery = "not-sent";
-    /** MSH-10 of the message that is still waiting. */
-    readonly controlId: string;
-    constructor(controlId: string);
-}
-//# sourceMappingURL=mllp-already-sending-error.d.ts.map

package/dist/errors/mllp-already-sending-error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mllp-already-sending-error.d.ts","sourceRoot":"","sources":["../../src/errors/mllp-already-sending-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAiB,MAAM,QAAQ,CAAC;AAExD;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,SAAkB,IAAI,6BAA6B;IACnD,QAAQ,CAAC,IAAI,oBAAiC;IAC9C,QAAQ,CAAC,QAAQ,cAAc;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAM9B"}