Recommended preset

Preset bundling the core (version-independent) HL7v2 lint rules.

What it does

This preset wires the core HL7v2 lint rules into a single unified plugin. One .use(...) call enables structural checks that apply to every HL7v2 message regardless of version or profile: segment header shape, message header presence, version range, and trailing field hygiene.

Install

npm install @glion/preset-lint-recommended

Use

import hl7v2PresetLintRecommended from "@glion/preset-lint-recommended";
import { hl7v2Parser } from "@glion/parser";
import { unified } from "unified";

const processor = unified().use(hl7v2Parser).use(hl7v2PresetLintRecommended);

const file = await processor.process(
  "MSH|^~\\&|SENDER||RECEIVER||20250601120000||ADT^A01|MSG00001|P|2.5"
);

for (const message of file.messages) {
  console.log(`${message.ruleId}: ${message.reason}`);
}

API

unified().use(hl7v2PresetLintRecommended)

Default export is a Preset (unified's { plugins: [...] } shape). No options — to configure individual rules, compose them directly from their own packages instead of using the preset.

What's bundled

The preset applies these rules in order. Three are configured at error severity; no-trailing-empty-field uses its default severity.

The companion @glion/preset-lint-profile-recommended covers profile-driven, version-specific lint rules; use both together for comprehensive validation.