@glion/mllp-client 0.16.0 → 0.20.0

package/dist/state.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The client's phases, and what each one is holding: the session, the message
+ * in flight, and the close.
+ *
+ * Types only. A phase changes by replacing the object, never by mutating it.
+ *
+ * @module
+ */
+import type { MllpClientError } from "./errors";
+import type { MllpSession } from "./session";
+export type State = {
+    readonly phase: "idle";
+} | {
+    readonly phase: "connecting";
+    /** The dialing. Settles as `connect()` does. */
+    readonly opening: Promise<void>;
+    /** Aborted by `close()` and `destroy()`. Stops the dialing. */
+    readonly abort: AbortController;
+} | {
+    readonly phase: "connected";
+    readonly session: MllpSession;
+} | {
+    readonly phase: "sending";
+    readonly session: MllpSession;
+} | {
+    readonly phase: "closing";
+    /** 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

@@ -0,0 +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;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/dist/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * The public types of `@glion/mllp-client`. Types only — no runtime values.
+ *
+ * @module
+ */
+import type { AckSuccessCode } from "@glion/ack";
+import type { Root } from "@glion/ast";
+/** The byte streams an open socket carries. */
+export interface MllpStreams {
+    /** Bytes from the remote system. */
+    readonly readable: ReadableStream<Uint8Array>;
+    /** Bytes to the remote system. */
+    readonly writable: WritableStream<Uint8Array>;
+}
+/** A socket to one remote system. */
+export interface MllpSocket {
+    /**
+     * Opens the socket and returns its byte streams.
+     *
+     * Rejects with `signal.reason` when cancelled. A rejection leaves nothing
+     * open. Called again only after `close()`.
+     */
+    connect(signal: AbortSignal): Promise<MllpStreams>;
+    /**
+     * Ends the socket `connect()` opened, and resolves once it is down.
+     *
+     * Never rejects. Idempotent. Bounded, even when the remote system does not
+     * answer. An attempt still in flight is cancelled through its signal.
+     */
+    close(): Promise<void>;
+}
+/** The client's phase. */
+export type MllpClientState = "closed" | "closing" | "connected" | "connecting" | "idle" | "sending";
+export interface MllpReconnectOptions {
+    /**
+     * Attempts after a failed one before the client closes. `Infinity` for no
+     * limit.
+     *
+     * @default 5
+     */
+    readonly attempts?: number;
+    /**
+     * Time to wait before `attempt` in milliseconds.
+     *
+     * @default full-jitter exponential backoff from 1 s, capped at 30 s
+     */
+    readonly delay?: (attempt: number) => number;
+}
+export interface MllpSendOptions {
+    /** Overrides the default send deadline: write plus acknowledgment wait. */
+    readonly timeoutMs?: number;
+}
+export interface MllpClientOptions {
+    /** Runtime adapter; e.g. `nodeSocket` from `@glion/mllp-client/node`. */
+    readonly socket: MllpSocket;
+    /**
+     * Time to wait for the connection to open, in milliseconds.
+     *
+     * @default 10_000
+     */
+    readonly connectTimeoutMs?: number;
+    /**
+     * Time to wait for an acknowledgment after sending, in milliseconds.
+     *
+     * @default 30_000
+     */
+    readonly sendTimeoutMs?: number;
+    /**
+     * Maximum bytes buffered while receiving one message. A remote system that
+     * never finishes one is dropped once it exceeds this.
+     *
+     * @default 16 MiB
+     */
+    readonly maxBufferedBytes?: number;
+    /**
+     * How the client dials again after a connection attempt fails. `false`: it
+     * dials once.
+     *
+     * @default 5 attempts with full-jitter backoff, about 30 seconds in all
+     */
+    readonly reconnect?: MllpReconnectOptions | false;
+}
+/**
+ * An acknowledgment that accepted the message: MSA-1 is `AA` or `CA`.
+ *
+ * A NAK never reaches here — `send()` throws the matching `@glion/ack`
+ * exception instead.
+ */
+export interface MllpClientResponse {
+    /**
+     * MSH-10 of the acknowledgment itself, for tracing. MUST NOT be used for
+     * correlation; see `controlId`.
+     */
+    readonly id: string;
+    /**
+     * MSA-2: the MSH-10 of the message this one answers. HL7v2 names both
+     * fields Message Control ID. The only field correlation may use.
+     */
+    readonly controlId: string;
+    /** The acknowledgment, parsed. */
+    readonly tree: Root;
+    /** The acknowledgment as received, decoded to text. */
+    readonly raw: string;
+    /** MSA-3: the remote system's own diagnostic, when it gave one. */
+    readonly text?: string;
+    /** MSA-1: `AA` or `CA`. */
+    readonly code: AckSuccessCode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9C,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CAC/C;AAED,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnD;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID,0BAA0B;AAC1B,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,YAAY,GACZ,MAAM,GACN,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B"}

package/dist/utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reading a single value out of an HL7v2 tree.
+ *
+ * @module
+ */
+import type { Root } from "@glion/ast";
+/** The value at `path`, or `""` when the field is absent. */
+export declare function read(tree: Root, path: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,6DAA6D;AAC7D,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@glion/mllp-client",
-  "version": "0.16.0",
-  "description": "MLLP client for sending HL7v2 messages and receiving acknowledgments",
+  "version": "0.20.0",
+  "description": "Persistent, single-flight MLLP client for HL7v2",
   "keywords": [
-    "client",
     "health",
     "healthcare",
     "hl7",
@@ -29,67 +28,59 @@
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": {
-      "workerd": {
-        "types": "./dist/runtimes/workers.d.ts",
-        "import": "./dist/runtimes/workers.js"
-      },
-      "default": {
-        "types": "./dist/index.d.ts",
-        "import": "./dist/index.js"
-      }
-    },
-    "./core": {
-      "types": "./dist/core/index.d.ts",
-      "import": "./dist/core/index.js"
-    },
-    "./node": {
-      "types": "./dist/runtimes/node.d.ts",
-      "import": "./dist/runtimes/node.js"
-    },
-    "./workers": {
-      "types": "./dist/runtimes/workers.d.ts",
-      "import": "./dist/runtimes/workers.js"
-    }
+    ".": "./dist/index.js",
+    "./node": "./dist/runtime/node.js",
+    "./workers": "./dist/runtime/workers.js"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@glion/ack": "0.16.0",
-    "@glion/ast": "0.16.0",
-    "@glion/mllp-transport": "0.16.0",
-    "@glion/util-query": "0.16.0",
-    "@glion/parser": "0.16.0"
+    "@glion/ack": "0.20.0",
+    "@glion/ast": "0.20.0",
+    "@glion/mllp-codec": "0.20.0",
+    "@glion/to-hl7v2": "0.20.0",
+    "@glion/util-query": "0.20.0",
+    "@glion/parser": "0.20.0",
+    "@glion/util-charset": "0.20.0"
   },
   "devDependencies": {
+    "@cloudflare/vitest-plugin": "1.1.13",
+    "@cloudflare/workers-types": "5.20260915.1",
+    "@stryker-mutator/core": "10.0.0",
+    "@stryker-mutator/vitest-runner": "10.0.0",
     "@types/node": "25.6.0",
-    "@vitest/coverage-v8": "4.1.5",
+    "@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.5",
-    "wrangler": "^4.86.0",
-    "@glion/hl7v2": "0.16.0",
-    "@glion/mllp": "0.16.0",
-    "@glion/mllp-ack": "0.16.0",
-    "@glion/testing": "0.16.0",
-    "@glion/tsconfig": "0.16.0",
-    "@glion/check-readme": "0.16.0"
+    "vitest": "4.1.11",
+    "@glion/check-readme": "0.18.0",
+    "@glion/testing": "0.18.0",
+    "@glion/tsconfig": "0.18.0"
+  },
+  "peerDependencies": {
+    "@types/node": ">=22"
+  },
+  "peerDependenciesMeta": {
+    "@types/node": {
+      "optional": true
+    }
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "scripts": {
     "build": "tsdown && tsc --emitDeclarationOnly",
-    "check-types": "tsc --noEmit",
+    "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 --project 'hl7v2-mllp-client (node)'",
-    "test:bun": "bun --bun test test/core.test.ts",
-    "test:cf": "vitest run --project 'hl7v2-mllp-client (workerd)'",
-    "test:coverage": "vitest run --coverage --project 'hl7v2-mllp-client (node)'",
-    "test:node": "vitest run --project 'hl7v2-mllp-client (node)'",
+    "test": "vitest run",
+    "test:cf": "vitest run --config vitest.workers.config.ts",
+    "test:coverage": "vitest run --coverage",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
     "test:watch": "vitest"
   }
 }