Recommended profile preset

Preset bundling every profile-based HL7v2 lint rule for validating messages against their version-specific profiles.

What it does

This preset wires the eight profile lint rules plus the annotate-profile-context loader into a single unified plugin. One .use(...) call enables required-field, field-length, field-repetition, required-component, table-value, extra-field, extra-component, and segment-order validation — all driven by the HL7v2 profile loaded for the message's MSH-12 version.

Install

npm install @glion/preset-lint-profile-recommended

Use

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

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

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

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

API

unified().use(hl7v2PresetLintProfileRecommended)

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 plugins in order. annotate-profile-context runs first so every subsequent rule sees the resolved profile on file.data.profile.

The companion @glion/preset-lint-recommended covers the core (version-independent) lint rules; use both together for comprehensive validation.