@glion/lint-message-version

Lint rule that checks an HL7v2 message's MSH-12 version satisfies a semver range expression.

What it does

Reads MSH-12.1 from the tree and evaluates it against the configured expression using @glion/util-semver. Reports a message when MSH-12 is missing or empty, when the value is not a valid semver-like version, or when it falls outside the allowed range. The default expression ("<3.0.0 >=2.3") accepts HL7v2 versions 2.3 through 2.9 and excludes future v3 values.

Install

npm install @glion/lint-message-version

Use

import { hl7v2Parser } from "@glion/parser";
import hl7v2LintMessageVersion from "@glion/lint-message-version";
import { unified } from "unified";
import { reporter } from "vfile-reporter";

const message =
  "MSH|^~\\&|SENDER|FAC|RCVR|FAC|20250101010101||ADT^A01^ADT_A01|MSG00001|P|2.5";

const file = await unified()
  .use(hl7v2Parser)
  .use(hl7v2LintMessageVersion, { expression: "<3.0.0 >=2.3" })
  .process(message);

console.error(reporter([file]));

API

unified().use(hl7v2LintMessageVersion[, options])

A unified lint rule plugin.

import type { Plugin } from "unified";
import type { Root } from "@glion/ast";

export interface MessageVersionLintOptions {
  /** Semver range expression to evaluate against `MSH-12.1`. Default: "<3.0.0 >=2.3". */
  expression: string;
}

declare const hl7v2LintMessageVersion: Plugin<
  [MessageVersionLintOptions?],
  Root
>;
export default hl7v2LintMessageVersion;

Expressions are parsed and evaluated by @glion/util-semver.

What it checks

The value of MSH-12.1 must be present and must satisfy the configured semver expression.

Valid

MSH-12 is 2.5, within the default range <3.0.0 >=2.3:

MSH|^~\&|SENDER|FAC|RCVR|FAC|20250101010101||ADT^A01^ADT_A01|MSG00001|P|2.5

Invalid

MSH-12 is 2.2, below the default minimum:

MSH|^~\&|SENDER|FAC|RCVR|FAC|20250101010101||ADT^A01^ADT_A01|MSG00001|P|2.2

Reported message:

MSH-12 (version) field value '2.2' does not satisfy expression '<3.0.0 >=2.3'

MSH-12 is missing:

Required MSH-12 (version) field is missing or empty

MSH-12 contains a value that cannot be parsed as semver:

MSH-12 (version) field value 'abc' is not valid

Both the offending value and the configured expression are interpolated into the message. The rule reports at most one message per tree and exits as soon as the first problem is detected.

Part of Glion

@glion/lint-message-version is part of Glion, the application framework for HL7v2. See the Glion README for the full package catalog and architecture.