@pritiranjan/hl7v2 0.1.0

package/dist/segments/index.js

@@ -0,0 +1,532 @@
+import { decodeEscapes, parseHL7DateTime } from '../chunk-Q6NISXHR.js';
+
+// src/segments/base.ts
+var TypedSegment = class {
+  constructor(seg, enc) {
+    this.seg = seg;
+    this.enc = enc;
+  }
+  /** The raw underlying {@link HL7Segment}. */
+  get raw() {
+    return this.seg;
+  }
+  /** Return the raw field structure at the given 1-based field number. */
+  field(num) {
+    return this.seg.fields[num - 1];
+  }
+  /**
+   * Extract a scalar string value from the segment.
+   * All arguments are 1-based. Missing elements return `''`.
+   * Escape sequences are decoded automatically.
+   */
+  str(fieldNum, component = 1, subComponent = 1, repetition = 1) {
+    const f = this.field(fieldNum);
+    if (!f) return "";
+    const raw = f[repetition - 1]?.[component - 1]?.[subComponent - 1] ?? "";
+    return decodeEscapes(raw, this.enc);
+  }
+  /**
+   * Extract a string value from the segment without escape decoding.
+   * Useful when you need to preserve the raw HL7 encoding.
+   */
+  rawStr(fieldNum, component = 1, subComponent = 1, repetition = 1) {
+    const f = this.field(fieldNum);
+    if (!f) return "";
+    return f[repetition - 1]?.[component - 1]?.[subComponent - 1] ?? "";
+  }
+  /** Extract a Date from an HL7 date/time field. Returns `undefined` if empty. */
+  date(fieldNum, component = 1) {
+    const raw = this.rawStr(fieldNum, component);
+    if (!raw) return void 0;
+    try {
+      return parseHL7DateTime(raw);
+    } catch {
+      return void 0;
+    }
+  }
+  /** Extract a numeric value from a field. Returns `undefined` if empty or non-numeric. */
+  num(fieldNum, component = 1) {
+    const raw = this.str(fieldNum, component);
+    if (!raw) return void 0;
+    const n = parseFloat(raw);
+    return isNaN(n) ? void 0 : n;
+  }
+  /** Return all repetitions of a field as an array of first-component strings. */
+  repetitions(fieldNum, component = 1) {
+    const f = this.field(fieldNum);
+    if (!f) return [];
+    return f.map((rep) => {
+      const raw = rep[component - 1]?.[0] ?? "";
+      return decodeEscapes(raw, this.enc);
+    }).filter((v) => v !== "");
+  }
+};
+
+// src/segments/msh.ts
+var MSH = class extends TypedSegment {
+  constructor(seg, enc) {
+    super(seg, enc);
+  }
+  /** MSH.3 — Sending Application */
+  sendingApplication() {
+    return this.str(3);
+  }
+  /** MSH.4 — Sending Facility */
+  sendingFacility() {
+    return this.str(4);
+  }
+  /** MSH.5 — Receiving Application */
+  receivingApplication() {
+    return this.str(5);
+  }
+  /** MSH.6 — Receiving Facility */
+  receivingFacility() {
+    return this.str(6);
+  }
+  /** MSH.7 — Date/Time of Message */
+  dateTimeOfMessage() {
+    return this.date(7);
+  }
+  /** MSH.9 — Message Type (e.g., `{ type: 'ADT', event: 'A01', structure: 'ADT_A01' }`). */
+  messageType() {
+    const field = this.field(9);
+    const firstRep = field?.[0] ?? [];
+    const struct = firstRep[2]?.[0];
+    return {
+      type: firstRep[0]?.[0] ?? "",
+      event: firstRep[1]?.[0] ?? "",
+      structure: struct !== void 0 && struct !== "" ? struct : void 0
+    };
+  }
+  /** MSH.10 — Message Control ID (used for ACK correlation). */
+  messageControlId() {
+    return this.str(10);
+  }
+  /**
+   * MSH.11 — Processing ID.
+   * `'P'` = Production, `'D'` = Debugging, `'T'` = Training.
+   */
+  processingId() {
+    return this.str(11);
+  }
+  /** MSH.12 — HL7 version (e.g., `'2.5.1'`). */
+  version() {
+    return this.str(12);
+  }
+  /** MSH.15 — Accept Acknowledgement Type. */
+  acceptAcknowledgementType() {
+    return this.str(15);
+  }
+  /** MSH.16 — Application Acknowledgement Type. */
+  applicationAcknowledgementType() {
+    return this.str(16);
+  }
+  /** MSH.17 — Country Code (ISO 3166). */
+  countryCode() {
+    return this.str(17);
+  }
+};
+
+// src/segments/pid.ts
+var PID = class extends TypedSegment {
+  constructor(seg, enc) {
+    super(seg, enc);
+  }
+  /** PID.1 — Set ID (1-based sequence number within the message). */
+  setId() {
+    return this.num(1);
+  }
+  /**
+   * PID.3 — Patient Identifier List.
+   *
+   * Returns all patient identifiers (MRN, SSN, national ID, etc.).
+   * Each identifier has its own type code and assigning authority.
+   *
+   * @example
+   * pid.patientIdentifiers()
+   * // [{ id: 'MRN123', assigningAuthority: 'HOSPITAL', identifierTypeCode: 'MR' }]
+   */
+  patientIdentifiers() {
+    const field = this.field(3);
+    if (!field) return [];
+    return field.map((rep) => ({
+      id: rep[0]?.[0] ?? "",
+      checkDigit: rep[1]?.[0] ?? "",
+      assigningAuthority: rep[3]?.[0] ?? "",
+      identifierTypeCode: rep[4]?.[0] ?? ""
+    }));
+  }
+  /**
+   * PID.3 — Primary patient identifier (first in the list).
+   * Returns the raw identifier string (e.g., `'MRN123'`).
+   */
+  patientId() {
+    return this.str(3, 1);
+  }
+  /**
+   * PID.5 — Patient Name (first/primary name).
+   *
+   * Patient names follow the XPN (Extended Person Name) data type.
+   * Components: family ^ given ^ middle ^ suffix ^ prefix ^ degree
+   */
+  patientName() {
+    return {
+      family: this.str(5, 1),
+      given: this.str(5, 2),
+      middle: this.str(5, 3),
+      suffix: this.str(5, 4),
+      prefix: this.str(5, 5),
+      degree: this.str(5, 6)
+    };
+  }
+  /**
+   * PID.5 — All patient names (legal, alias, display, etc.).
+   * Most messages contain a single name; some include aliases or prior names.
+   */
+  allPatientNames() {
+    const field = this.field(5);
+    if (!field) return [];
+    return field.map((rep) => ({
+      family: rep[0]?.[0] ?? "",
+      given: rep[1]?.[0] ?? "",
+      middle: rep[2]?.[0] ?? "",
+      suffix: rep[3]?.[0] ?? "",
+      prefix: rep[4]?.[0] ?? "",
+      degree: rep[5]?.[0] ?? ""
+    }));
+  }
+  /**
+   * PID.7 — Date/Time of Birth.
+   * Returns `undefined` if absent or unparseable.
+   */
+  dateOfBirth() {
+    return this.date(7);
+  }
+  /**
+   * PID.8 — Administrative Sex (HL7 table 0001).
+   * `'M'` Male · `'F'` Female · `'O'` Other · `'U'` Unknown
+   * `'A'` Ambiguous · `'N'` Not applicable · `'C'` Complex
+   */
+  sex() {
+    return this.str(8);
+  }
+  /**
+   * PID.10 — Race (HL7 table 0005, CWE data type).
+   * Returns the race code (first component).
+   */
+  race() {
+    return this.str(10, 1);
+  }
+  /**
+   * PID.11 — Patient Address (first address).
+   * Addresses follow the XAD (Extended Address) data type.
+   */
+  address() {
+    return {
+      streetAddress: this.str(11, 1),
+      otherDesignation: this.str(11, 2),
+      city: this.str(11, 3),
+      state: this.str(11, 4),
+      postalCode: this.str(11, 5),
+      country: this.str(11, 6),
+      addressType: this.str(11, 7)
+    };
+  }
+  /** PID.13 — Phone Number - Home (first number, XTN data type). */
+  homePhone() {
+    return this.str(13, 1);
+  }
+  /** PID.14 — Phone Number - Business (first number, XTN data type). */
+  workPhone() {
+    return this.str(14, 1);
+  }
+  /**
+   * PID.15 — Primary Language (CE data type).
+   * Returns the language code (e.g., `'ENG'`, `'SPA'`).
+   */
+  primaryLanguage() {
+    return this.str(15, 1);
+  }
+  /** PID.16 — Marital Status (HL7 table 0002). */
+  maritalStatus() {
+    return this.str(16, 1);
+  }
+  /** PID.17 — Religion (HL7 table 0006). */
+  religion() {
+    return this.str(17, 1);
+  }
+  /**
+   * PID.18 — Patient Account Number.
+   * The billing/visit account number (distinct from the medical record number).
+   */
+  accountNumber() {
+    return this.str(18, 1);
+  }
+  /** PID.19 — SSN Number - Patient (US Social Security Number). */
+  ssn() {
+    return this.str(19);
+  }
+  /** PID.22 — Ethnic Group (HL7 table 0189, CWE data type). */
+  ethnicGroup() {
+    return this.str(22, 1);
+  }
+  /** PID.29 — Patient Death Date and Time. `undefined` if patient is not deceased. */
+  deathDateTime() {
+    return this.date(29);
+  }
+  /**
+   * PID.30 — Patient Death Indicator.
+   * `'Y'` = deceased, `'N'` = not deceased.
+   */
+  deathIndicator() {
+    return this.str(30);
+  }
+};
+
+// src/segments/obx.ts
+var OBX = class extends TypedSegment {
+  constructor(seg, enc) {
+    super(seg, enc);
+  }
+  /** OBX.1 — Set ID (sequence number within the message, 1-based). */
+  setId() {
+    return this.num(1);
+  }
+  /**
+   * OBX.2 — Value Type.
+   * Indicates the data type of the observation value in OBX.5.
+   * Common values: `'NM'` (numeric), `'ST'` (string), `'CWE'` (coded).
+   */
+  valueType() {
+    return this.str(2);
+  }
+  /**
+   * OBX.3 — Observation Identifier.
+   * Typically a LOINC code identifying what was measured.
+   *
+   * @example
+   * obx.observationIdentifier()
+   * // { code: '718-7', description: 'Hemoglobin [Mass/volume] in Blood', codingSystem: 'LN' }
+   */
+  observationIdentifier() {
+    return {
+      code: this.str(3, 1),
+      description: this.str(3, 2),
+      codingSystem: this.str(3, 3)
+    };
+  }
+  /** OBX.4 — Observation Sub-ID (groups related OBX segments). */
+  observationSubId() {
+    return this.str(4);
+  }
+  /**
+   * OBX.5 — Observation Value (raw string).
+   *
+   * The interpretation depends on OBX.2 (value type).
+   * Use {@link numericValue} for `NM`, {@link codedValue} for `CWE`/`CE`.
+   */
+  observationValue() {
+    return this.str(5);
+  }
+  /**
+   * OBX.5 — Observation value interpreted as a number.
+   * Returns `undefined` if the value type is not `NM` or the value is absent.
+   *
+   * For structured numerics (SN type like `'>10.5'`), use {@link observationValue}.
+   */
+  numericValue() {
+    if (this.str(2) !== "NM") return void 0;
+    return this.num(5);
+  }
+  /**
+   * OBX.5 — Observation value as a coded element (CWE/CE value type).
+   * Returns `{ code, description, codingSystem }`.
+   */
+  codedValue() {
+    return {
+      code: this.str(5, 1),
+      description: this.str(5, 2),
+      codingSystem: this.str(5, 3)
+    };
+  }
+  /**
+   * OBX.6 — Units (CWE data type).
+   * Returns the unit code (e.g., `'g/dL'`, `'10*3/uL'`, `'mmHg'`).
+   */
+  units() {
+    return this.str(6, 1);
+  }
+  /**
+   * OBX.7 — References Range.
+   * The normal range as a string (e.g., `'3.5-5.0'`, `'<200'`).
+   */
+  referenceRange() {
+    return this.str(7);
+  }
+  /**
+   * OBX.8 — Interpretation Codes (formerly Abnormal Flags).
+   * Returns all flags for this result (a field can have multiple repetitions).
+   *
+   * Common values: `'H'` high, `'L'` low, `'HH'` critical high, `'LL'` critical low,
+   * `'N'` normal, `'A'` abnormal, `'POS'` positive, `'NEG'` negative.
+   */
+  abnormalFlags() {
+    return this.repetitions(8);
+  }
+  /**
+   * OBX.8 — Primary interpretation code (first flag).
+   * Returns `''` if the result has no flags (i.e., it is normal / in-range).
+   */
+  primaryAbnormalFlag() {
+    return this.str(8);
+  }
+  /** OBX.11 — Observation Result Status (HL7 table 0085). */
+  resultStatus() {
+    return this.str(11);
+  }
+  /** OBX.14 — Date/Time of Observation. */
+  observationDateTime() {
+    return this.date(14);
+  }
+  /** OBX.15 — Producer's ID (the lab or device that produced the result). */
+  producerId() {
+    return this.str(15, 1);
+  }
+  /** OBX.16 — Responsible Observer (clinician who verified the result). */
+  responsibleObserver() {
+    return this.str(16, 1);
+  }
+  /** OBX.19 — Date/Time of Analysis. */
+  analysisDateTime() {
+    return this.date(19);
+  }
+  /**
+   * Convenience: return `true` if this result has a critical abnormal flag
+   * (`'HH'` or `'LL'`).
+   */
+  isCritical() {
+    const flags = this.abnormalFlags();
+    return flags.includes("HH") || flags.includes("LL");
+  }
+  /**
+   * Convenience: return `true` if the result is finalised (`resultStatus() === 'F'`).
+   */
+  isFinal() {
+    return this.str(11) === "F";
+  }
+};
+
+// src/segments/pv1.ts
+var PV1 = class extends TypedSegment {
+  constructor(seg, enc) {
+    super(seg, enc);
+  }
+  /** PV1.1 — Set ID. */
+  setId() {
+    return this.num(1);
+  }
+  /**
+   * PV1.2 — Patient Class (HL7 table 0004).
+   * `'I'` Inpatient · `'O'` Outpatient · `'E'` Emergency · `'P'` Preadmit
+   */
+  patientClass() {
+    return this.str(2);
+  }
+  /**
+   * PV1.3 — Assigned Patient Location.
+   * The bed the patient is currently assigned to.
+   */
+  assignedLocation() {
+    return {
+      pointOfCare: this.str(3, 1),
+      room: this.str(3, 2),
+      bed: this.str(3, 3),
+      facility: this.str(3, 4),
+      buildingCode: this.str(3, 7),
+      floor: this.str(3, 8)
+    };
+  }
+  /** PV1.4 — Admission Type (e.g., `'A'` = accident, `'E'` = emergency). */
+  admissionType() {
+    return this.str(4);
+  }
+  /**
+   * PV1.7 — Attending Doctor.
+   * The physician primarily responsible for the patient's care.
+   */
+  attendingDoctor() {
+    return {
+      id: this.str(7, 1),
+      family: this.str(7, 2),
+      given: this.str(7, 3),
+      middle: this.str(7, 4),
+      credential: this.str(7, 7)
+    };
+  }
+  /**
+   * PV1.8 — Referring Doctor.
+   * The physician who referred the patient.
+   */
+  referringDoctor() {
+    return {
+      id: this.str(8, 1),
+      family: this.str(8, 2),
+      given: this.str(8, 3),
+      middle: this.str(8, 4),
+      credential: this.str(8, 7)
+    };
+  }
+  /**
+   * PV1.9 — Consulting Doctor.
+   * Returns all consulting doctors (field can repeat).
+   */
+  consultingDoctors() {
+    const field = this.field(9);
+    if (!field) return [];
+    return field.map((rep) => ({
+      id: rep[0]?.[0] ?? "",
+      family: rep[1]?.[0] ?? "",
+      given: rep[2]?.[0] ?? "",
+      middle: rep[3]?.[0] ?? "",
+      credential: rep[7]?.[0] ?? ""
+    }));
+  }
+  /** PV1.10 — Hospital Service (e.g., `'MED'`, `'SUR'`, `'CAR'`). */
+  hospitalService() {
+    return this.str(10);
+  }
+  /** PV1.14 — Admit Source (HL7 table 0023). */
+  admitSource() {
+    return this.str(14);
+  }
+  /** PV1.18 — Patient Type. */
+  patientType() {
+    return this.str(18);
+  }
+  /** PV1.19 — Visit Number (account number for this specific visit). */
+  visitNumber() {
+    return this.str(19, 1);
+  }
+  /** PV1.36 — Discharge Disposition (HL7 table 0112). */
+  dischargeDisposition() {
+    return this.str(36);
+  }
+  /**
+   * PV1.44 — Admit Date/Time.
+   * When the patient was admitted to this care setting.
+   */
+  admitDateTime() {
+    return this.date(44);
+  }
+  /**
+   * PV1.45 — Discharge Date/Time.
+   * `undefined` if the patient has not yet been discharged.
+   */
+  dischargeDateTime() {
+    return this.date(45);
+  }
+};
+
+export { MSH, OBX, PID, PV1, TypedSegment };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/segments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/segments/base.ts","../../src/segments/msh.ts","../../src/segments/pid.ts","../../src/segments/obx.ts","../../src/segments/pv1.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { decodeEscapes } from '../escape.js';\nimport { parseHL7DateTime } from '../datetime.js';\nimport type { EncodingChars, HL7Field, HL7Segment } from '../schema.js';\n\n/**\n * Base class for typed HL7 v2 segment accessors.\n *\n * Typed segments wrap an {@link HL7Segment} and provide strongly-typed,\n * documented accessor methods for each field — eliminating the need to\n * remember field numbers or component positions.\n *\n * @example\n * import { PID } from 'hl7v2/segments';\n * import { parse, segment } from 'hl7v2';\n *\n * const msg = parse(rawString);\n * const pid = new PID(segment(msg, 'PID'), msg.encoding);\n *\n * pid.patientName()   // { family: 'Doe', given: 'John', middle: 'A' }\n * pid.dateOfBirth()   // Date | undefined\n * pid.sex()           // 'M' | 'F' | 'O' | 'U' | undefined\n */\nexport abstract class TypedSegment {\n  constructor(\n    protected readonly seg: HL7Segment,\n    protected readonly enc: EncodingChars,\n  ) {}\n\n  /** The raw underlying {@link HL7Segment}. */\n  get raw(): HL7Segment {\n    return this.seg;\n  }\n\n  /** Return the raw field structure at the given 1-based field number. */\n  protected field(num: number): HL7Field | undefined {\n    return this.seg.fields[num - 1];\n  }\n\n  /**\n   * Extract a scalar string value from the segment.\n   * All arguments are 1-based. Missing elements return `''`.\n   * Escape sequences are decoded automatically.\n   */\n  protected str(\n    fieldNum: number,\n    component = 1,\n    subComponent = 1,\n    repetition = 1,\n  ): string {\n    const f = this.field(fieldNum);\n    if (!f) return '';\n    const raw = f[repetition - 1]?.[component - 1]?.[subComponent - 1] ?? '';\n    return decodeEscapes(raw, this.enc);\n  }\n\n  /**\n   * Extract a string value from the segment without escape decoding.\n   * Useful when you need to preserve the raw HL7 encoding.\n   */\n  protected rawStr(\n    fieldNum: number,\n    component = 1,\n    subComponent = 1,\n    repetition = 1,\n  ): string {\n    const f = this.field(fieldNum);\n    if (!f) return '';\n    return f[repetition - 1]?.[component - 1]?.[subComponent - 1] ?? '';\n  }\n\n  /** Extract a Date from an HL7 date/time field. Returns `undefined` if empty. */\n  protected date(fieldNum: number, component = 1): Date | undefined {\n    const raw = this.rawStr(fieldNum, component);\n    if (!raw) return undefined;\n    try {\n      return parseHL7DateTime(raw);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /** Extract a numeric value from a field. Returns `undefined` if empty or non-numeric. */\n  protected num(fieldNum: number, component = 1): number | undefined {\n    const raw = this.str(fieldNum, component);\n    if (!raw) return undefined;\n    const n = parseFloat(raw);\n    return isNaN(n) ? undefined : n;\n  }\n\n  /** Return all repetitions of a field as an array of first-component strings. */\n  protected repetitions(fieldNum: number, component = 1): string[] {\n    const f = this.field(fieldNum);\n    if (!f) return [];\n    return f.map(rep => {\n      const raw = rep[component - 1]?.[0] ?? '';\n      return decodeEscapes(raw, this.enc);\n    }).filter(v => v !== '');\n  }\n}\n","import type { EncodingChars, HL7Segment, MessageType } from '../schema.js';\nimport { TypedSegment } from './base.js';\n\n/** Processing ID values defined in HL7 v2 table 0103. */\nexport type ProcessingId = 'P' | 'D' | 'T';\n\n/**\n * Typed accessor for the MSH (Message Header) segment.\n *\n * MSH is mandatory and always the first segment in any HL7 v2 message.\n * It identifies the message type, version, sender, receiver, and timestamp.\n *\n * @example\n * import { parse, segment } from 'hl7v2';\n * import { MSH } from 'hl7v2/segments';\n *\n * const msg = parse(raw);\n * const msh = new MSH(segment(msg, 'MSH'), msg.encoding);\n *\n * msh.sendingApplication()   // 'HOSPITAL_ADT'\n * msh.messageType()          // { type: 'ADT', event: 'A01', structure: 'ADT_A01' }\n * msh.messageControlId()     // 'MSG000001'\n * msh.version()              // '2.5.1'\n */\nexport class MSH extends TypedSegment {\n  constructor(seg: HL7Segment, enc: EncodingChars) {\n    super(seg, enc);\n  }\n\n  /** MSH.3 — Sending Application */\n  sendingApplication(): string { return this.str(3); }\n\n  /** MSH.4 — Sending Facility */\n  sendingFacility(): string { return this.str(4); }\n\n  /** MSH.5 — Receiving Application */\n  receivingApplication(): string { return this.str(5); }\n\n  /** MSH.6 — Receiving Facility */\n  receivingFacility(): string { return this.str(6); }\n\n  /** MSH.7 — Date/Time of Message */\n  dateTimeOfMessage(): Date | undefined { return this.date(7); }\n\n  /** MSH.9 — Message Type (e.g., `{ type: 'ADT', event: 'A01', structure: 'ADT_A01' }`). */\n  messageType(): MessageType {\n    const field    = this.field(9);\n    const firstRep = field?.[0] ?? [];\n    const struct   = firstRep[2]?.[0];\n    return {\n      type:      firstRep[0]?.[0] ?? '',\n      event:     firstRep[1]?.[0] ?? '',\n      structure: struct !== undefined && struct !== '' ? struct : undefined,\n    };\n  }\n\n  /** MSH.10 — Message Control ID (used for ACK correlation). */\n  messageControlId(): string { return this.str(10); }\n\n  /**\n   * MSH.11 — Processing ID.\n   * `'P'` = Production, `'D'` = Debugging, `'T'` = Training.\n   */\n  processingId(): ProcessingId | string { return this.str(11); }\n\n  /** MSH.12 — HL7 version (e.g., `'2.5.1'`). */\n  version(): string { return this.str(12); }\n\n  /** MSH.15 — Accept Acknowledgement Type. */\n  acceptAcknowledgementType(): string { return this.str(15); }\n\n  /** MSH.16 — Application Acknowledgement Type. */\n  applicationAcknowledgementType(): string { return this.str(16); }\n\n  /** MSH.17 — Country Code (ISO 3166). */\n  countryCode(): string { return this.str(17); }\n}\n","import type { EncodingChars, HL7Segment } from '../schema.js';\nimport { TypedSegment } from './base.js';\n\n/** Administrative sex codes from HL7 v2 table 0001. */\nexport type AdministrativeSex = 'M' | 'F' | 'O' | 'U' | 'A' | 'N' | 'C';\n\n/** A structured patient name following HL7 XPN (Extended Person Name). */\nexport interface PersonName {\n  /** Family (last) name. */\n  family: string;\n  /** Given (first) name. */\n  given: string;\n  /** Middle name or initial. */\n  middle: string;\n  /** Name suffix (e.g., `'JR'`, `'SR'`, `'III'`). */\n  suffix: string;\n  /** Name prefix (e.g., `'DR'`, `'MR'`, `'MS'`). */\n  prefix: string;\n  /** Degree (e.g., `'MD'`, `'PHD'`). */\n  degree: string;\n}\n\n/** A structured address following HL7 XAD (Extended Address). */\nexport interface Address {\n  streetAddress: string;\n  otherDesignation: string;\n  city: string;\n  state: string;\n  postalCode: string;\n  country: string;\n  addressType: string;\n}\n\n/** A patient identifier from PID.3 (Patient Identifier List). */\nexport interface PatientIdentifier {\n  /** The identifier value (e.g., MRN, SSN). */\n  id: string;\n  /** Check digit. */\n  checkDigit: string;\n  /** Assigning authority (e.g., `'HOSPITAL'`). */\n  assigningAuthority: string;\n  /** Identifier type code (e.g., `'MR'` = Medical Record, `'PI'` = Patient Internal). */\n  identifierTypeCode: string;\n}\n\n/**\n * Typed accessor for the PID (Patient Identification) segment.\n *\n * PID carries all core patient demographic information and appears in\n * virtually every HL7 v2 message type (ADT, ORU, ORM, SIU, etc.).\n *\n * @example\n * import { parse, segment } from 'hl7v2';\n * import { PID } from 'hl7v2/segments';\n *\n * const msg = parse(raw);\n * const pid = new PID(segment(msg, 'PID'), msg.encoding);\n *\n * pid.patientName()        // { family: 'Doe', given: 'John', middle: 'A', ... }\n * pid.dateOfBirth()        // Date | undefined\n * pid.sex()                // 'M' | 'F' | ...\n * pid.patientIdentifiers() // PatientIdentifier[]\n */\nexport class PID extends TypedSegment {\n  constructor(seg: HL7Segment, enc: EncodingChars) {\n    super(seg, enc);\n  }\n\n  /** PID.1 — Set ID (1-based sequence number within the message). */\n  setId(): number | undefined { return this.num(1); }\n\n  /**\n   * PID.3 — Patient Identifier List.\n   *\n   * Returns all patient identifiers (MRN, SSN, national ID, etc.).\n   * Each identifier has its own type code and assigning authority.\n   *\n   * @example\n   * pid.patientIdentifiers()\n   * // [{ id: 'MRN123', assigningAuthority: 'HOSPITAL', identifierTypeCode: 'MR' }]\n   */\n  patientIdentifiers(): PatientIdentifier[] {\n    const field = this.field(3);\n    if (!field) return [];\n    return field.map(rep => ({\n      id:                  rep[0]?.[0] ?? '',\n      checkDigit:          rep[1]?.[0] ?? '',\n      assigningAuthority:  rep[3]?.[0] ?? '',\n      identifierTypeCode:  rep[4]?.[0] ?? '',\n    }));\n  }\n\n  /**\n   * PID.3 — Primary patient identifier (first in the list).\n   * Returns the raw identifier string (e.g., `'MRN123'`).\n   */\n  patientId(): string { return this.str(3, 1); }\n\n  /**\n   * PID.5 — Patient Name (first/primary name).\n   *\n   * Patient names follow the XPN (Extended Person Name) data type.\n   * Components: family ^ given ^ middle ^ suffix ^ prefix ^ degree\n   */\n  patientName(): PersonName {\n    return {\n      family: this.str(5, 1),\n      given:  this.str(5, 2),\n      middle: this.str(5, 3),\n      suffix: this.str(5, 4),\n      prefix: this.str(5, 5),\n      degree: this.str(5, 6),\n    };\n  }\n\n  /**\n   * PID.5 — All patient names (legal, alias, display, etc.).\n   * Most messages contain a single name; some include aliases or prior names.\n   */\n  allPatientNames(): PersonName[] {\n    const field = this.field(5);\n    if (!field) return [];\n    return field.map(rep => ({\n      family: rep[0]?.[0] ?? '',\n      given:  rep[1]?.[0] ?? '',\n      middle: rep[2]?.[0] ?? '',\n      suffix: rep[3]?.[0] ?? '',\n      prefix: rep[4]?.[0] ?? '',\n      degree: rep[5]?.[0] ?? '',\n    }));\n  }\n\n  /**\n   * PID.7 — Date/Time of Birth.\n   * Returns `undefined` if absent or unparseable.\n   */\n  dateOfBirth(): Date | undefined { return this.date(7); }\n\n  /**\n   * PID.8 — Administrative Sex (HL7 table 0001).\n   * `'M'` Male · `'F'` Female · `'O'` Other · `'U'` Unknown\n   * `'A'` Ambiguous · `'N'` Not applicable · `'C'` Complex\n   */\n  sex(): AdministrativeSex | string { return this.str(8); }\n\n  /**\n   * PID.10 — Race (HL7 table 0005, CWE data type).\n   * Returns the race code (first component).\n   */\n  race(): string { return this.str(10, 1); }\n\n  /**\n   * PID.11 — Patient Address (first address).\n   * Addresses follow the XAD (Extended Address) data type.\n   */\n  address(): Address {\n    return {\n      streetAddress:    this.str(11, 1),\n      otherDesignation: this.str(11, 2),\n      city:             this.str(11, 3),\n      state:            this.str(11, 4),\n      postalCode:       this.str(11, 5),\n      country:          this.str(11, 6),\n      addressType:      this.str(11, 7),\n    };\n  }\n\n  /** PID.13 — Phone Number - Home (first number, XTN data type). */\n  homePhone(): string { return this.str(13, 1); }\n\n  /** PID.14 — Phone Number - Business (first number, XTN data type). */\n  workPhone(): string { return this.str(14, 1); }\n\n  /**\n   * PID.15 — Primary Language (CE data type).\n   * Returns the language code (e.g., `'ENG'`, `'SPA'`).\n   */\n  primaryLanguage(): string { return this.str(15, 1); }\n\n  /** PID.16 — Marital Status (HL7 table 0002). */\n  maritalStatus(): string { return this.str(16, 1); }\n\n  /** PID.17 — Religion (HL7 table 0006). */\n  religion(): string { return this.str(17, 1); }\n\n  /**\n   * PID.18 — Patient Account Number.\n   * The billing/visit account number (distinct from the medical record number).\n   */\n  accountNumber(): string { return this.str(18, 1); }\n\n  /** PID.19 — SSN Number - Patient (US Social Security Number). */\n  ssn(): string { return this.str(19); }\n\n  /** PID.22 — Ethnic Group (HL7 table 0189, CWE data type). */\n  ethnicGroup(): string { return this.str(22, 1); }\n\n  /** PID.29 — Patient Death Date and Time. `undefined` if patient is not deceased. */\n  deathDateTime(): Date | undefined { return this.date(29); }\n\n  /**\n   * PID.30 — Patient Death Indicator.\n   * `'Y'` = deceased, `'N'` = not deceased.\n   */\n  deathIndicator(): 'Y' | 'N' | string { return this.str(30); }\n}\n","import type { EncodingChars, HL7Segment } from '../schema.js';\nimport { TypedSegment } from './base.js';\n\n/** OBX.2 — Value type codes from HL7 v2 table 0125. */\nexport type ObservationValueType =\n  | 'NM'   // Numeric\n  | 'ST'   // String\n  | 'TX'   // Text\n  | 'FT'   // Formatted text\n  | 'CWE'  // Coded with Exceptions\n  | 'CE'   // Coded Element (deprecated in v2.7+)\n  | 'DT'   // Date\n  | 'TM'   // Time\n  | 'TS'   // Time Stamp (deprecated in v2.7+)\n  | 'DTM'  // Date/Time (v2.7+)\n  | 'SN'   // Structured Numeric\n  | 'RP'   // Reference Pointer (e.g., image URL)\n  | 'ED'   // Encapsulated Data\n  | string;\n\n/** OBX.11 — Observation Result Status codes from HL7 v2 table 0085. */\nexport type ResultStatus =\n  | 'F'  // Final\n  | 'P'  // Preliminary\n  | 'C'  // Correction\n  | 'X'  // Result cannot be obtained\n  | 'I'  // Specimen in lab — results pending\n  | 'R'  // Results entered — not yet verified\n  | 'S'  // Partial results\n  | 'D'  // Deletes the OBX record\n  | 'N'  // Not asked — not reported\n  | 'W'  // Post original as wrong (in error)\n  | string;\n\n/** Abnormal flags from HL7 v2 table 0078. */\nexport type AbnormalFlag =\n  | 'H'   // Above high normal\n  | 'HH'  // Above upper panic limits\n  | 'L'   // Below low normal\n  | 'LL'  // Below lower panic limits\n  | 'A'   // Abnormal (generic)\n  | 'AA'  // Very abnormal\n  | 'N'   // Normal\n  | 'IND' // Indeterminate\n  | 'NEG' // Negative\n  | 'POS' // Positive\n  | string;\n\n/** A coded observation identifier (LOINC, SNOMED, local). */\nexport interface ObservationIdentifier {\n  /** Identifier code (e.g., LOINC code `'718-7'`). */\n  code: string;\n  /** Human-readable description (e.g., `'Hemoglobin'`). */\n  description: string;\n  /** Coding system (e.g., `'LN'` for LOINC, `'SCT'` for SNOMED CT). */\n  codingSystem: string;\n}\n\n/**\n * Typed accessor for the OBX (Observation/Result) segment.\n *\n * OBX carries a single clinical observation — a lab result, vital sign,\n * pathology finding, or any structured clinical measurement. A message\n * typically contains multiple OBX segments, one per result.\n *\n * @example\n * import { parse, segments } from 'hl7v2';\n * import { OBX } from 'hl7v2/segments';\n *\n * const msg  = parse(raw);\n * const obxs = segments(msg, 'OBX').map(s => new OBX(s, msg.encoding));\n *\n * for (const obx of obxs) {\n *   console.log(obx.observationIdentifier().description); // 'Hemoglobin'\n *   console.log(obx.numericValue());                      // 13.5\n *   console.log(obx.units());                             // 'g/dL'\n *   console.log(obx.referenceRange());                    // '13.5-17.5'\n *   console.log(obx.abnormalFlags());                     // ['H']\n *   console.log(obx.resultStatus());                      // 'F'\n * }\n */\nexport class OBX extends TypedSegment {\n  constructor(seg: HL7Segment, enc: EncodingChars) {\n    super(seg, enc);\n  }\n\n  /** OBX.1 — Set ID (sequence number within the message, 1-based). */\n  setId(): number | undefined { return this.num(1); }\n\n  /**\n   * OBX.2 — Value Type.\n   * Indicates the data type of the observation value in OBX.5.\n   * Common values: `'NM'` (numeric), `'ST'` (string), `'CWE'` (coded).\n   */\n  valueType(): ObservationValueType { return this.str(2); }\n\n  /**\n   * OBX.3 — Observation Identifier.\n   * Typically a LOINC code identifying what was measured.\n   *\n   * @example\n   * obx.observationIdentifier()\n   * // { code: '718-7', description: 'Hemoglobin [Mass/volume] in Blood', codingSystem: 'LN' }\n   */\n  observationIdentifier(): ObservationIdentifier {\n    return {\n      code:         this.str(3, 1),\n      description:  this.str(3, 2),\n      codingSystem: this.str(3, 3),\n    };\n  }\n\n  /** OBX.4 — Observation Sub-ID (groups related OBX segments). */\n  observationSubId(): string { return this.str(4); }\n\n  /**\n   * OBX.5 — Observation Value (raw string).\n   *\n   * The interpretation depends on OBX.2 (value type).\n   * Use {@link numericValue} for `NM`, {@link codedValue} for `CWE`/`CE`.\n   */\n  observationValue(): string { return this.str(5); }\n\n  /**\n   * OBX.5 — Observation value interpreted as a number.\n   * Returns `undefined` if the value type is not `NM` or the value is absent.\n   *\n   * For structured numerics (SN type like `'>10.5'`), use {@link observationValue}.\n   */\n  numericValue(): number | undefined {\n    if (this.str(2) !== 'NM') return undefined;\n    return this.num(5);\n  }\n\n  /**\n   * OBX.5 — Observation value as a coded element (CWE/CE value type).\n   * Returns `{ code, description, codingSystem }`.\n   */\n  codedValue(): ObservationIdentifier {\n    return {\n      code:         this.str(5, 1),\n      description:  this.str(5, 2),\n      codingSystem: this.str(5, 3),\n    };\n  }\n\n  /**\n   * OBX.6 — Units (CWE data type).\n   * Returns the unit code (e.g., `'g/dL'`, `'10*3/uL'`, `'mmHg'`).\n   */\n  units(): string { return this.str(6, 1); }\n\n  /**\n   * OBX.7 — References Range.\n   * The normal range as a string (e.g., `'3.5-5.0'`, `'<200'`).\n   */\n  referenceRange(): string { return this.str(7); }\n\n  /**\n   * OBX.8 — Interpretation Codes (formerly Abnormal Flags).\n   * Returns all flags for this result (a field can have multiple repetitions).\n   *\n   * Common values: `'H'` high, `'L'` low, `'HH'` critical high, `'LL'` critical low,\n   * `'N'` normal, `'A'` abnormal, `'POS'` positive, `'NEG'` negative.\n   */\n  abnormalFlags(): AbnormalFlag[] {\n    return this.repetitions(8);\n  }\n\n  /**\n   * OBX.8 — Primary interpretation code (first flag).\n   * Returns `''` if the result has no flags (i.e., it is normal / in-range).\n   */\n  primaryAbnormalFlag(): AbnormalFlag { return this.str(8); }\n\n  /** OBX.11 — Observation Result Status (HL7 table 0085). */\n  resultStatus(): ResultStatus { return this.str(11); }\n\n  /** OBX.14 — Date/Time of Observation. */\n  observationDateTime(): Date | undefined { return this.date(14); }\n\n  /** OBX.15 — Producer's ID (the lab or device that produced the result). */\n  producerId(): string { return this.str(15, 1); }\n\n  /** OBX.16 — Responsible Observer (clinician who verified the result). */\n  responsibleObserver(): string { return this.str(16, 1); }\n\n  /** OBX.19 — Date/Time of Analysis. */\n  analysisDateTime(): Date | undefined { return this.date(19); }\n\n  /**\n   * Convenience: return `true` if this result has a critical abnormal flag\n   * (`'HH'` or `'LL'`).\n   */\n  isCritical(): boolean {\n    const flags = this.abnormalFlags();\n    return flags.includes('HH') || flags.includes('LL');\n  }\n\n  /**\n   * Convenience: return `true` if the result is finalised (`resultStatus() === 'F'`).\n   */\n  isFinal(): boolean { return this.str(11) === 'F'; }\n}\n","import type { EncodingChars, HL7Segment } from '../schema.js';\nimport { TypedSegment } from './base.js';\n\n/** Patient class codes from HL7 v2 table 0004. */\nexport type PatientClass =\n  | 'E'  // Emergency\n  | 'I'  // Inpatient\n  | 'O'  // Outpatient\n  | 'P'  // Preadmit\n  | 'R'  // Recurring patient\n  | 'B'  // Obstetrics\n  | 'C'  // Commercial account\n  | 'N'  // Not applicable\n  | 'U'  // Unknown\n  | string;\n\n/** A structured provider/clinician name and identifier. */\nexport interface Provider {\n  /** Provider identifier (e.g., NPI number, employee ID). */\n  id: string;\n  /** Family (last) name. */\n  family: string;\n  /** Given (first) name. */\n  given: string;\n  /** Middle name or initial. */\n  middle: string;\n  /** Credential suffix (e.g., `'MD'`, `'DO'`, `'NP'`). */\n  credential: string;\n}\n\n/** A patient location — room, bed, facility. */\nexport interface PatientLocation {\n  pointOfCare: string;\n  room: string;\n  bed: string;\n  facility: string;\n  buildingCode: string;\n  floor: string;\n}\n\n/**\n * Typed accessor for the PV1 (Patient Visit) segment.\n *\n * PV1 describes the context of a patient's current or historical visit:\n * the patient class (inpatient/outpatient), assigned location, attending\n * and referring physicians, and admission/discharge timestamps.\n *\n * @example\n * import { parse, segment } from 'hl7v2';\n * import { PV1 } from 'hl7v2/segments';\n *\n * const msg = parse(raw);\n * const pv1 = new PV1(segment(msg, 'PV1'), msg.encoding);\n *\n * pv1.patientClass()         // 'I' (Inpatient)\n * pv1.assignedLocation()     // { pointOfCare: 'CARDIOLOGY', room: '4A', bed: '101', ... }\n * pv1.attendingDoctor()      // { id: '1234567', family: 'Smith', given: 'Richard', ... }\n * pv1.admitDateTime()        // Date | undefined\n */\nexport class PV1 extends TypedSegment {\n  constructor(seg: HL7Segment, enc: EncodingChars) {\n    super(seg, enc);\n  }\n\n  /** PV1.1 — Set ID. */\n  setId(): number | undefined { return this.num(1); }\n\n  /**\n   * PV1.2 — Patient Class (HL7 table 0004).\n   * `'I'` Inpatient · `'O'` Outpatient · `'E'` Emergency · `'P'` Preadmit\n   */\n  patientClass(): PatientClass { return this.str(2); }\n\n  /**\n   * PV1.3 — Assigned Patient Location.\n   * The bed the patient is currently assigned to.\n   */\n  assignedLocation(): PatientLocation {\n    return {\n      pointOfCare: this.str(3, 1),\n      room:        this.str(3, 2),\n      bed:         this.str(3, 3),\n      facility:    this.str(3, 4),\n      buildingCode:this.str(3, 7),\n      floor:       this.str(3, 8),\n    };\n  }\n\n  /** PV1.4 — Admission Type (e.g., `'A'` = accident, `'E'` = emergency). */\n  admissionType(): string { return this.str(4); }\n\n  /**\n   * PV1.7 — Attending Doctor.\n   * The physician primarily responsible for the patient's care.\n   */\n  attendingDoctor(): Provider {\n    return {\n      id:         this.str(7, 1),\n      family:     this.str(7, 2),\n      given:      this.str(7, 3),\n      middle:     this.str(7, 4),\n      credential: this.str(7, 7),\n    };\n  }\n\n  /**\n   * PV1.8 — Referring Doctor.\n   * The physician who referred the patient.\n   */\n  referringDoctor(): Provider {\n    return {\n      id:         this.str(8, 1),\n      family:     this.str(8, 2),\n      given:      this.str(8, 3),\n      middle:     this.str(8, 4),\n      credential: this.str(8, 7),\n    };\n  }\n\n  /**\n   * PV1.9 — Consulting Doctor.\n   * Returns all consulting doctors (field can repeat).\n   */\n  consultingDoctors(): Provider[] {\n    const field = this.field(9);\n    if (!field) return [];\n    return field.map(rep => ({\n      id:         rep[0]?.[0] ?? '',\n      family:     rep[1]?.[0] ?? '',\n      given:      rep[2]?.[0] ?? '',\n      middle:     rep[3]?.[0] ?? '',\n      credential: rep[7]?.[0] ?? '',\n    }));\n  }\n\n  /** PV1.10 — Hospital Service (e.g., `'MED'`, `'SUR'`, `'CAR'`). */\n  hospitalService(): string { return this.str(10); }\n\n  /** PV1.14 — Admit Source (HL7 table 0023). */\n  admitSource(): string { return this.str(14); }\n\n  /** PV1.18 — Patient Type. */\n  patientType(): string { return this.str(18); }\n\n  /** PV1.19 — Visit Number (account number for this specific visit). */\n  visitNumber(): string { return this.str(19, 1); }\n\n  /** PV1.36 — Discharge Disposition (HL7 table 0112). */\n  dischargeDisposition(): string { return this.str(36); }\n\n  /**\n   * PV1.44 — Admit Date/Time.\n   * When the patient was admitted to this care setting.\n   */\n  admitDateTime(): Date | undefined { return this.date(44); }\n\n  /**\n   * PV1.45 — Discharge Date/Time.\n   * `undefined` if the patient has not yet been discharged.\n   */\n  dischargeDateTime(): Date | undefined { return this.date(45); }\n}\n"]}