Message version

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

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.

Message version

On this page