@haste-health/hl7v2-parsing 0.1.1

package/README.md

@@ -0,0 +1 @@
+# hl7v2-parsing

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+export type Hl7V2Component = string | string[];
+export type Hl7V2Field = Hl7V2Component | Hl7V2Component[];
+export type Hl7V2Segment = {
+    name: string;
+    fields: (Hl7V2Field | Hl7V2Field[])[];
+};
+export type Hl7V2Message = Record<Hl7V2Segment["name"], Hl7V2Segment["fields"]>;
+export default function parseHl7V2Message(hl7v2Message: string): Hl7V2Message;

package/lib/index.js

@@ -0,0 +1,79 @@
+import { OperationError, outcomeFatal } from "@haste-health/operation-outcomes";
+function parseComponent(specialCharacters, component) {
+    const subCompoenents = component.split(specialCharacters.subComponentSeperatorCharacter);
+    return subCompoenents.length === 1 ? subCompoenents[0] : subCompoenents;
+}
+function parseField(specialCharacters, field) {
+    const repititions = field
+        .split(specialCharacters.repetitionCharacter)
+        .map((repitition) => {
+        const components = repitition.split(specialCharacters.seperatorCharacter);
+        return components.length === 1
+            ? parseComponent(specialCharacters, components[0])
+            : components.map((c) => parseComponent(specialCharacters, c));
+    });
+    return repititions.length === 1 ? repititions[0] : repititions;
+}
+function parseSegment(specialCharacters, segment) {
+    const [name, ...fields] = segment.split(specialCharacters.fieldSeperator);
+    return { name, fields: fields.map((f) => parseField(specialCharacters, f)) };
+}
+const SegmentEnd = /\r?\n|\r|\n/;
+/**
+ *
+ */
+function parseSingleMessage(hl7v2Message) {
+    const mshEnd = hl7v2Message.search(SegmentEnd);
+    const mshSegment = hl7v2Message.slice(0, mshEnd);
+    if (!mshSegment.startsWith("MSH")) {
+        throw new OperationError(outcomeFatal("invalid", "Invalid MSH Segment"));
+    }
+    const fieldSeperator = mshSegment[3];
+    //  component separator, repetition separator, escape character, subcomponent separator, and truncation character.
+    // Recommneded Characters: ^~\& #
+    const specialCharEndIndex = mshSegment.indexOf(fieldSeperator, 4);
+    const specialCharString = mshSegment.slice(4, specialCharEndIndex);
+    const [seperatorCharacter, repetitionCharacter, escapeCharacter, subComponentSeperatorCharacter, truncationCharacter,] = specialCharString.split("");
+    const specialCharacters = {
+        fieldSeperator,
+        seperatorCharacter,
+        repetitionCharacter,
+        escapeCharacter,
+        subComponentSeperatorCharacter,
+        truncationCharacter,
+    };
+    // Special handling of MSH segment
+    const hl7v2MessageParsed = {
+        MSH: [
+            fieldSeperator,
+            specialCharString,
+            ...mshSegment
+                .slice(specialCharEndIndex + 1)
+                .split(fieldSeperator)
+                .map((f) => parseField(specialCharacters, f)),
+        ],
+    };
+    const segments = hl7v2Message
+        .slice(mshEnd + 1)
+        .split(SegmentEnd)
+        .map((segment) => parseSegment(specialCharacters, segment));
+    return segments.reduce((acc, segment) => {
+        acc[segment.name] = segment.fields;
+        return acc;
+    }, hl7v2MessageParsed);
+}
+export default function parseHl7V2Message(hl7v2Message) {
+    switch (true) {
+        case hl7v2Message.startsWith("MSH"): {
+            return parseSingleMessage(hl7v2Message);
+        }
+        // Batch messages
+        case hl7v2Message.startsWith("FHS"): {
+            throw new OperationError(outcomeFatal("invalid", "FHS not supported"));
+        }
+        default: {
+            throw new OperationError(outcomeFatal("invalid", "Invalid Message"));
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@haste-health/hl7v2-parsing",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "lib/index.js",
+  "scripts": {
+    "build": "tsc",
+    "test": "pnpm node --experimental-vm-modules $(pnpm bin jest)",
+    "publish": "pnpm build && pnpm npm publish --access public --tolerate-republish"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.7.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.3.2",
+    "typescript": "5.9.2"
+  },
+  "files": [
+    "README.md",
+    "lib/**"
+  ],
+  "dependencies": {
+    "@haste-health/operation-outcomes": "workspace:^"
+  }
+}