@cosyte/x12 0.0.3 → 0.0.4

package/dist/index.cjs

@@ -105,7 +105,10 @@ function detectDelimiters(raw) {
     if (raw.charAt(pos) !== element) {
       throw new X12ParseError(
         FATAL_CODES.X12_INVALID_DELIMITERS,
-        `Element separator "${element}" was detected at ISA byte 4 but is missing at fixed ISA byte ${String(pos + 1)} - ISA element layout is not 005010-conformant.`,
+        // The detected separator is a single byte read out of the input, so
+        // it is not echoed: the diagnostic is which fixed ISA position broke,
+        // and the byte itself is at `raw[3]` for anyone who needs it.
+        `The element separator detected at ISA byte 4 is missing at fixed ISA byte ${String(pos + 1)} - ISA element layout is not 005010-conformant.`,
         fatalPosition,
         snip
       );
@@ -139,182 +142,256 @@ var WARNING_CODES = {
   X12_UNKNOWN_CLAIM_STATUS: "X12_UNKNOWN_CLAIM_STATUS",
   X12_834_UNKNOWN_MAINTENANCE_TYPE: "X12_834_UNKNOWN_MAINTENANCE_TYPE"
 };
-function controlNumberMismatch(position, pair, header, trailer) {
+var CONTROL_NUMBER_PAIRS = {
+  /** ISA-13 against IEA-02. */
+  INTERCHANGE: "interchange",
+  /** GS-06 against GE-02. */
+  GROUP: "group",
+  /** ST-02 against SE-02. */
+  TRANSACTION: "transaction"
+};
+var UNEXPECTED_SEGMENT_CONTEXTS = {
+  /** A `TA1` (envelope-level by spec) appeared inside an open functional group. */
+  TA1_INSIDE_GROUP: "ta1-inside-group",
+  /** A `GE` appeared with no open `GS`. */
+  GE_WITHOUT_GS: "ge-without-gs",
+  /** An `ST` appeared with no open functional group. */
+  ST_WITHOUT_GS: "st-without-gs",
+  /** An `SE` appeared with no open transaction set. */
+  SE_WITHOUT_ST: "se-without-st",
+  /** A body segment appeared outside any open transaction set. */
+  BODY_OUTSIDE_TRANSACTION: "body-outside-transaction"
+};
+var BALANCE_INVARIANTS = {
+  /** `CLP-04 + Σ(claim CAS + line CAS) == CLP-03`. */
+  CLAIM: "claim",
+  /** `SVC-03 + Σ(line CAS) == SVC-02`. */
+  SERVICE_LINE: "service-line",
+  /** `Σ(CLP-04) - Σ(PLB amounts) == BPR-02`. */
+  REMIT_TOTAL: "remit-total"
+};
+var REQUIRED_LOOPS = {
+  /** Loop 2000A, Billing Provider HL. */
+  BILLING_PROVIDER_2000A: "2000A",
+  /** Loop 2000B, Subscriber HL. */
+  SUBSCRIBER_2000B: "2000B",
+  /** Loop 2010BA, Subscriber Name. */
+  SUBSCRIBER_NAME_2010BA: "2010BA",
+  /** Loop 2010BB, Payer Name. */
+  PAYER_NAME_2010BB: "2010BB"
+};
+var WARNING_MESSAGES = {
+  X12_CONTROL_NUMBER_MISMATCH_INTERCHANGE: "Control number mismatch: ISA-13 (header) and IEA-02 (trailer) disagree. Both values are preserved verbatim on the model; neither is echoed here.",
+  X12_CONTROL_NUMBER_MISMATCH_GROUP: "Control number mismatch: GS-06 (header) and GE-02 (trailer) disagree. Both values are preserved verbatim on the model; neither is echoed here.",
+  X12_CONTROL_NUMBER_MISMATCH_TRANSACTION: "Control number mismatch: ST-02 (header) and SE-02 (trailer) disagree. Both values are preserved verbatim on the model; neither is echoed here.",
+  X12_PRE_005010: 'ISA-12 declares a version other than the HIPAA baseline "00501", so the input may diverge from 005010 semantics. The declared version is preserved verbatim on the model.',
+  X12_GROUP_COUNT_MISMATCH: "IEA-01 does not equal the number of GS..GE groups actually present in the interchange. The declared count is preserved verbatim on the model and is NEVER silently corrected.",
+  X12_TRANSACTION_COUNT_MISMATCH: "GE-01 does not equal the number of ST..SE transaction sets actually present in the group. The declared count is preserved verbatim on the model and is NEVER silently corrected.",
+  X12_SEGMENT_COUNT_MISMATCH: "SE-01 does not equal the number of segments actually present in the transaction set it closes. The declared count is preserved verbatim and is corrected only on `serializeX12(ix, { specClean: true, recomputeCounts: true })`.",
+  X12_TRAILING_GARBAGE: "Bytes followed the IEA segment terminator, preserved verbatim on `trailingBytes`. Common cause: a second interchange concatenated into the same file (multi-ISA, out of v1 scope).",
+  X12_MISSING_IEA: "Interchange has no IEA trailer - input is truncated.",
+  X12_MISSING_GE: "Functional group has no GE trailer - group is truncated.",
+  X12_MISSING_SE: "Transaction set has no SE trailer - transaction is truncated.",
+  X12_DANGLING_RELEASE_CHAR: "Release character (`?`) appears at end of element/segment with no following byte to escape - preserved verbatim.",
+  X12_UNEXPECTED_SEGMENT_TA1_INSIDE_GROUP: "Unexpected segment: TA1 is envelope-level but appeared inside an open functional group, so it is NOT captured on `ta1Segments` and `parseTA1` will not read it. It is retained verbatim on `orphanSegments` at the matching `position.segmentIndex`.",
+  X12_UNEXPECTED_SEGMENT_GE_WITHOUT_GS: "Unexpected segment: a GE appeared with no open functional group, so it closes nothing and no group is recorded for it. It is retained verbatim on `orphanSegments` at the matching `position.segmentIndex`.",
+  X12_UNEXPECTED_SEGMENT_ST_WITHOUT_GS: "Unexpected segment: an ST appeared with no open functional group (missing GS), so no transaction set is opened and nothing that follows it is bound to one. It is retained verbatim on `orphanSegments` at the matching `position.segmentIndex`.",
+  X12_UNEXPECTED_SEGMENT_SE_WITHOUT_ST: "Unexpected segment: an SE appeared with no open transaction set, so it closes nothing and no transaction is recorded for it. It is retained verbatim on `orphanSegments` at the matching `position.segmentIndex`.",
+  X12_UNEXPECTED_SEGMENT_BODY_OUTSIDE_TRANSACTION: "Unexpected segment: a body segment appeared outside any open transaction set, so it is not bound to a transaction and no `get*` reader will see it. It is retained verbatim on `orphanSegments` at the matching `position.segmentIndex`.",
+  X12_835_REMIT_BALANCE_MISMATCH_CLAIM: "835 balance invariant violated [CLP-04 + \u03A3(claim CAS + line CAS) == CLP-03]: the claim does not balance. Every amount is preserved verbatim on the model as an X12Decimal and is NEVER silently rebalanced.",
+  X12_835_REMIT_BALANCE_MISMATCH_SERVICE_LINE: "835 balance invariant violated [SVC-03 + \u03A3(line CAS) == SVC-02]: the service line does not balance. Every amount is preserved verbatim on the model as an X12Decimal and is NEVER silently rebalanced.",
+  X12_835_REMIT_BALANCE_MISMATCH_REMIT_TOTAL: "835 balance invariant violated [\u03A3(CLP-04) - \u03A3(PLB amounts) == BPR-02]: the remittance total does not balance. Every amount is preserved verbatim on the model as an X12Decimal and is NEVER silently rebalanced.",
+  X12_UNKNOWN_CARC: "Unknown CARC: the claim adjustment reason code is outside the bundled snapshot. The verbatim code is preserved on the adjustment; only its description is unavailable.",
+  X12_UNKNOWN_RARC: "Unknown RARC: the remittance advice remark code is outside the bundled snapshot. The verbatim code is preserved on the remark; only its description is unavailable.",
+  X12_HL_PARENT_MISMATCH: "HL-02 declares a parent id that no earlier HL in this transaction set emitted as its HL-01. The declared pointer is preserved verbatim and the hierarchy is NEVER silently re-numbered.",
+  X12_HL_PARENT_LEVEL_INVALID: "HL-03 is inconsistent with the declared parent's HL-03 per the TR3 hierarchy. Both level codes are preserved verbatim and the hierarchy is NEVER silently re-parented.",
+  X12_UNKNOWN_HI_QUALIFIER: 'Unknown HI qualifier: the composite qualifier is outside the bundled HI_QUALIFIERS snapshot. The verbatim qualifier and code are preserved; codeSystem resolves to "unknown".',
+  X12_MISSING_REQUIRED_LOOP_2000A: 'Missing required loop "2000A" (Billing Provider HL): no Billing Provider HL precedes the CLM.',
+  X12_MISSING_REQUIRED_LOOP_2000B: 'Missing required loop "2000B" (Subscriber HL): no Subscriber HL precedes the CLM.',
+  X12_MISSING_REQUIRED_LOOP_2010BA: 'Missing required loop "2010BA" (Subscriber Name): no Subscriber Name follows the Subscriber HL.',
+  X12_MISSING_REQUIRED_LOOP_2010BB: 'Missing required loop "2010BB" (Payer Name): no Payer Name follows the Subscriber HL.',
+  X12_837_UNKNOWN_VARIANT: `837 variant could not be resolved: ST-03's implementation convention reference is not one of "005010X222A2" / "005010X223A3" / "005010X224A2", and no SVx service-line segment was present to fall back on. The verbatim reference is preserved on the model.`,
+  X12_UNKNOWN_CLAIM_STATUS_CATEGORY: "Unknown claim status category (CSCC): the STC composite's first component is outside the bundled snapshot. The verbatim code is preserved on the status; only its description is unavailable.",
+  X12_UNKNOWN_CLAIM_STATUS: "Unknown claim status code (CSC): the STC composite's second component is outside the bundled snapshot. The verbatim code is preserved on the status; only its description is unavailable.",
+  X12_834_UNKNOWN_MAINTENANCE_TYPE: "Unknown 834 maintenance type: the INS-03/HD-01 code is outside the bundled snapshot. The verbatim code is preserved on the enrollment and the action is NEVER inferred."
+};
+var ALL_WARNING_MESSAGES = new Set(
+  Object.values(WARNING_MESSAGES)
+);
+var UNEXPECTED_SEGMENT_MESSAGES = {
+  [UNEXPECTED_SEGMENT_CONTEXTS.TA1_INSIDE_GROUP]: WARNING_MESSAGES.X12_UNEXPECTED_SEGMENT_TA1_INSIDE_GROUP,
+  [UNEXPECTED_SEGMENT_CONTEXTS.GE_WITHOUT_GS]: WARNING_MESSAGES.X12_UNEXPECTED_SEGMENT_GE_WITHOUT_GS,
+  [UNEXPECTED_SEGMENT_CONTEXTS.ST_WITHOUT_GS]: WARNING_MESSAGES.X12_UNEXPECTED_SEGMENT_ST_WITHOUT_GS,
+  [UNEXPECTED_SEGMENT_CONTEXTS.SE_WITHOUT_ST]: WARNING_MESSAGES.X12_UNEXPECTED_SEGMENT_SE_WITHOUT_ST,
+  [UNEXPECTED_SEGMENT_CONTEXTS.BODY_OUTSIDE_TRANSACTION]: WARNING_MESSAGES.X12_UNEXPECTED_SEGMENT_BODY_OUTSIDE_TRANSACTION
+};
+var CONTROL_NUMBER_PAIR_MESSAGES = {
+  [CONTROL_NUMBER_PAIRS.INTERCHANGE]: WARNING_MESSAGES.X12_CONTROL_NUMBER_MISMATCH_INTERCHANGE,
+  [CONTROL_NUMBER_PAIRS.GROUP]: WARNING_MESSAGES.X12_CONTROL_NUMBER_MISMATCH_GROUP,
+  [CONTROL_NUMBER_PAIRS.TRANSACTION]: WARNING_MESSAGES.X12_CONTROL_NUMBER_MISMATCH_TRANSACTION
+};
+var BALANCE_INVARIANT_MESSAGES = {
+  [BALANCE_INVARIANTS.CLAIM]: WARNING_MESSAGES.X12_835_REMIT_BALANCE_MISMATCH_CLAIM,
+  [BALANCE_INVARIANTS.SERVICE_LINE]: WARNING_MESSAGES.X12_835_REMIT_BALANCE_MISMATCH_SERVICE_LINE,
+  [BALANCE_INVARIANTS.REMIT_TOTAL]: WARNING_MESSAGES.X12_835_REMIT_BALANCE_MISMATCH_REMIT_TOTAL
+};
+var REQUIRED_LOOP_MESSAGES = {
+  [REQUIRED_LOOPS.BILLING_PROVIDER_2000A]: WARNING_MESSAGES.X12_MISSING_REQUIRED_LOOP_2000A,
+  [REQUIRED_LOOPS.SUBSCRIBER_2000B]: WARNING_MESSAGES.X12_MISSING_REQUIRED_LOOP_2000B,
+  [REQUIRED_LOOPS.SUBSCRIBER_NAME_2010BA]: WARNING_MESSAGES.X12_MISSING_REQUIRED_LOOP_2010BA,
+  [REQUIRED_LOOPS.PAYER_NAME_2010BB]: WARNING_MESSAGES.X12_MISSING_REQUIRED_LOOP_2010BB
+};
+function controlNumberMismatch(position, pair) {
   return {
     code: WARNING_CODES.X12_CONTROL_NUMBER_MISMATCH,
-    message: `Control number mismatch (${pair}): header="${header}", trailer="${trailer}".`,
+    message: CONTROL_NUMBER_PAIR_MESSAGES[pair],
     position
   };
 }
-function pre005010(position, declared) {
+function pre005010(position) {
   return {
     code: WARNING_CODES.X12_PRE_005010,
-    message: `ISA-12 declares version "${declared}", not the HIPAA baseline "00501".`,
+    message: WARNING_MESSAGES.X12_PRE_005010,
     position
   };
 }
-function groupCountMismatch(position, declared, actual) {
+function groupCountMismatch(position) {
   return {
     code: WARNING_CODES.X12_GROUP_COUNT_MISMATCH,
-    message: `IEA-01 declares ${declared} group(s); ${String(actual)} were present.`,
+    message: WARNING_MESSAGES.X12_GROUP_COUNT_MISMATCH,
     position
   };
 }
-function transactionCountMismatch(position, declared, actual) {
+function transactionCountMismatch(position) {
   return {
     code: WARNING_CODES.X12_TRANSACTION_COUNT_MISMATCH,
-    message: `GE-01 declares ${declared} transaction(s); ${String(actual)} were present.`,
+    message: WARNING_MESSAGES.X12_TRANSACTION_COUNT_MISMATCH,
     position
   };
 }
-function segmentCountMismatch(position, declared, actual) {
+function segmentCountMismatch(position) {
   return {
     code: WARNING_CODES.X12_SEGMENT_COUNT_MISMATCH,
-    message: `SE-01 declares ${declared} segment(s); ${String(actual)} were present.`,
+    message: WARNING_MESSAGES.X12_SEGMENT_COUNT_MISMATCH,
     position
   };
 }
-function trailingGarbage(position, byteCount) {
+function trailingGarbage(position) {
   return {
     code: WARNING_CODES.X12_TRAILING_GARBAGE,
-    message: `${String(byteCount)} byte(s) followed the IEA terminator - preserved verbatim on \`trailingBytes\`.`,
+    message: WARNING_MESSAGES.X12_TRAILING_GARBAGE,
     position
   };
 }
 function missingIea(position) {
   return {
     code: WARNING_CODES.X12_MISSING_IEA,
-    message: "Interchange has no IEA trailer - input is truncated.",
+    message: WARNING_MESSAGES.X12_MISSING_IEA,
     position
   };
 }
 function missingGe(position) {
   return {
     code: WARNING_CODES.X12_MISSING_GE,
-    message: "Functional group has no GE trailer - group is truncated.",
+    message: WARNING_MESSAGES.X12_MISSING_GE,
     position
   };
 }
 function missingSe(position) {
   return {
     code: WARNING_CODES.X12_MISSING_SE,
-    message: "Transaction set has no SE trailer - transaction is truncated.",
+    message: WARNING_MESSAGES.X12_MISSING_SE,
     position
   };
 }
 function danglingReleaseChar(position) {
   return {
     code: WARNING_CODES.X12_DANGLING_RELEASE_CHAR,
-    message: "Release character (`?`) appears at end of element/segment with no following byte to escape - preserved verbatim.",
+    message: WARNING_MESSAGES.X12_DANGLING_RELEASE_CHAR,
     position
   };
 }
-var SEGMENT_ID_SHAPE_RE = /^[A-Z][A-Z0-9]{1,2}$/u;
-function unexpectedSegment(position, segmentId, context) {
-  const safeId = SEGMENT_ID_SHAPE_RE.test(segmentId) ? segmentId : "(non-spec)";
+function unexpectedSegment(position, context) {
   return {
     code: WARNING_CODES.X12_UNEXPECTED_SEGMENT,
-    message: `Unexpected "${safeId}" segment - ${context}; segment is preserved on the prior open container if any.`,
+    message: UNEXPECTED_SEGMENT_MESSAGES[context],
     position
   };
 }
-var CODE_LIST_VALUE_SHAPE_RE = /^[A-Z0-9]{1,5}$/u;
-function remitBalanceMismatch(position, invariant, spec, computed, delta) {
+function remitBalanceMismatch(position, invariant) {
   return {
     code: WARNING_CODES.X12_835_REMIT_BALANCE_MISMATCH,
-    message: `835 balance invariant violated [${invariant}]: spec="${spec}", computed="${computed}", delta="${delta}".`,
+    message: BALANCE_INVARIANT_MESSAGES[invariant],
     position
   };
 }
-function unknownCarc(position, code) {
-  const safe = CODE_LIST_VALUE_SHAPE_RE.test(code) ? code : "(non-spec)";
+function unknownCarc(position) {
   return {
     code: WARNING_CODES.X12_UNKNOWN_CARC,
-    message: `Unknown CARC "${safe}" - code is outside the bundled snapshot; verbatim value preserved, description unavailable.`,
+    message: WARNING_MESSAGES.X12_UNKNOWN_CARC,
     position
   };
 }
-function unknownRarc(position, code) {
-  const safe = CODE_LIST_VALUE_SHAPE_RE.test(code) ? code : "(non-spec)";
+function unknownRarc(position) {
   return {
     code: WARNING_CODES.X12_UNKNOWN_RARC,
-    message: `Unknown RARC "${safe}" - code is outside the bundled snapshot; verbatim value preserved, description unavailable.`,
+    message: WARNING_MESSAGES.X12_UNKNOWN_RARC,
     position
   };
 }
-var HL_ID_SHAPE_RE = /^[0-9]{1,4}$/u;
-var HL_LEVEL_CODE_SHAPE_RE = /^[0-9]{2}$/u;
-var HI_QUALIFIER_SHAPE_RE = /^[A-Z][A-Z0-9]{1,2}$/u;
-function hlParentMismatch(position, hlId, declaredParentId) {
-  const safeHl = HL_ID_SHAPE_RE.test(hlId) ? hlId : "(non-spec)";
-  const safeParent = HL_ID_SHAPE_RE.test(declaredParentId) ? declaredParentId : "(non-spec)";
+function hlParentMismatch(position) {
   return {
     code: WARNING_CODES.X12_HL_PARENT_MISMATCH,
-    message: `HL "${safeHl}" declares parent "${safeParent}" but no earlier HL with that id was emitted - parser preserves the declared pointer verbatim and NEVER silently re-numbers.`,
+    message: WARNING_MESSAGES.X12_HL_PARENT_MISMATCH,
     position
   };
 }
-function hlParentLevelInvalid(position, hlId, hlLevel, parentHlId, parentLevel, expectedParentLevel) {
-  const safeHl = HL_ID_SHAPE_RE.test(hlId) ? hlId : "(non-spec)";
-  const safeLevel = HL_LEVEL_CODE_SHAPE_RE.test(hlLevel) ? hlLevel : "(non-spec)";
-  const safeParent = HL_ID_SHAPE_RE.test(parentHlId) ? parentHlId : "(non-spec)";
-  const safeParentLevel = HL_LEVEL_CODE_SHAPE_RE.test(parentLevel) ? parentLevel : "(non-spec)";
-  const safeExpected = HL_LEVEL_CODE_SHAPE_RE.test(expectedParentLevel) ? expectedParentLevel : "(non-spec)";
+function hlParentLevelInvalid(position) {
   return {
     code: WARNING_CODES.X12_HL_PARENT_LEVEL_INVALID,
-    message: `HL "${safeHl}" (level "${safeLevel}") declares parent "${safeParent}" with level "${safeParentLevel}" but TR3 requires parent level "${safeExpected}".`,
+    message: WARNING_MESSAGES.X12_HL_PARENT_LEVEL_INVALID,
     position
   };
 }
-function unknownHiQualifier(position, qualifier) {
-  const safe = HI_QUALIFIER_SHAPE_RE.test(qualifier) ? qualifier : "(non-spec)";
+function unknownHiQualifier(position) {
   return {
     code: WARNING_CODES.X12_UNKNOWN_HI_QUALIFIER,
-    message: `Unknown HI qualifier "${safe}" - qualifier is outside the bundled HI_QUALIFIERS snapshot; verbatim qualifier + code preserved, codeSystem resolves to "unknown".`,
+    message: WARNING_MESSAGES.X12_UNKNOWN_HI_QUALIFIER,
     position
   };
 }
-var LOOP_ID_SHAPE_RE = /^[0-9A-Z]{3,6}$/u;
-function missingRequiredLoop(position, loopId, rationale) {
-  const safe = LOOP_ID_SHAPE_RE.test(loopId) ? loopId : "(non-spec)";
+function missingRequiredLoop(position, loop) {
   return {
     code: WARNING_CODES.X12_MISSING_REQUIRED_LOOP,
-    message: `Missing required loop "${safe}": ${rationale}`,
+    message: REQUIRED_LOOP_MESSAGES[loop],
     position
   };
 }
-var ICR_SHAPE_RE = /^[0-9A-Z]{3,16}$/u;
-function unknown837Variant(position, implementationConventionReference) {
-  const safe = implementationConventionReference !== void 0 && ICR_SHAPE_RE.test(implementationConventionReference) ? implementationConventionReference : "(non-spec)";
+function unknown837Variant(position) {
   return {
     code: WARNING_CODES.X12_837_UNKNOWN_VARIANT,
-    message: `837 variant could not be resolved - ST-03 implementation convention reference "${safe}" is not one of "005010X222A2" / "X223A3" / "X224A2"; no SVx service-line segment was seen to fall back on.`,
+    message: WARNING_MESSAGES.X12_837_UNKNOWN_VARIANT,
     position
   };
 }
-var CLAIM_STATUS_CATEGORY_SHAPE_RE = /^[A-Z][0-9A-Z]{1,2}$/u;
-function unknownClaimStatusCategory(position, code) {
-  const safe = CLAIM_STATUS_CATEGORY_SHAPE_RE.test(code) ? code : "(non-spec)";
+function unknownClaimStatusCategory(position) {
   return {
     code: WARNING_CODES.X12_UNKNOWN_CLAIM_STATUS_CATEGORY,
-    message: `Unknown claim status category (CSCC) "${safe}" - code is outside the bundled snapshot; verbatim value preserved, description unavailable.`,
+    message: WARNING_MESSAGES.X12_UNKNOWN_CLAIM_STATUS_CATEGORY,
     position
   };
 }
-function unknownClaimStatus(position, code) {
-  const safe = CODE_LIST_VALUE_SHAPE_RE.test(code) ? code : "(non-spec)";
+function unknownClaimStatus(position) {
   return {
     code: WARNING_CODES.X12_UNKNOWN_CLAIM_STATUS,
-    message: `Unknown claim status code (CSC) "${safe}" - code is outside the bundled snapshot; verbatim value preserved, description unavailable.`,
+    message: WARNING_MESSAGES.X12_UNKNOWN_CLAIM_STATUS,
     position
   };
 }
-var MAINTENANCE_TYPE_SHAPE_RE = /^[0-9]{3}$/u;
-function unknownMaintenanceType(position, code) {
-  const safe = MAINTENANCE_TYPE_SHAPE_RE.test(code) ? code : "(non-spec)";
+function unknownMaintenanceType(position) {
   return {
     code: WARNING_CODES.X12_834_UNKNOWN_MAINTENANCE_TYPE,
-    message: `Unknown 834 maintenance type "${safe}" - INS-03/HD-01 code is outside the bundled snapshot; verbatim value preserved, action NOT inferred.`,
+    message: WARNING_MESSAGES.X12_834_UNKNOWN_MAINTENANCE_TYPE,
     position
   };
 }
@@ -675,6 +752,12 @@ function renderCanonical(signum, magnitude, scale) {
 }
 
 // src/parser/segment.ts
+var SEGMENT_ID_SHAPE_RE = /^[A-Z][A-Z0-9]{1,2}$/u;
+var NON_SPEC_SEGMENT_ID = "(non-spec)";
+function boundSegmentId(first) {
+  if (first.length === 0) return "";
+  return SEGMENT_ID_SHAPE_RE.test(first) ? first : NON_SPEC_SEGMENT_ID;
+}
 function decodeSegment(raw, delimiters, emit, position) {
   const elements = Object.freeze(splitWithRelease(raw, delimiters.element));
   if (raw.length > 0 && raw.endsWith(RELEASE_CHAR)) {
@@ -684,8 +767,7 @@ function decodeSegment(raw, delimiters, emit, position) {
       emit(danglingReleaseChar({ ...position, elementIndex: elements.length - 1 }));
     }
   }
-  const id = elements[0] ?? "";
-  return Object.freeze({ id, raw, elements });
+  return Object.freeze({ id: boundSegmentId(elements[0] ?? ""), raw, elements });
 }
 function parseSegmentPath(path) {
   if (path.length === 0) {
@@ -849,8 +931,11 @@ function decodeIsa(raw, delimiters) {
 }
 function stripLeadingNewlines(text, start) {
   let i = start;
-  if (text.charCodeAt(i) === 13) i++;
-  if (text.charCodeAt(i) === 10) i++;
+  while (i < text.length) {
+    const code = text.charCodeAt(i);
+    if (code !== 13 && code !== 10) break;
+    i++;
+  }
   return i;
 }
 function findUnescapedTerminator(text, from, term) {
@@ -903,15 +988,45 @@ function decodeEnvelope(raw, delimiters) {
   const isa = decodeIsa(raw, delimiters);
   const isa12 = el(isa.elements, 12);
   if (isa12 !== "00501") {
-    warnings.push(pre005010({ segmentIndex: 0, interchangeIndex: 0, elementIndex: 12 }, isa12));
+    warnings.push(pre005010({ segmentIndex: 0, interchangeIndex: 0, elementIndex: 12 }));
   }
   const { segments } = splitSegments(raw, ISA_MIN_LENGTH, delimiters);
   const groups = [];
   const ta1Segments = [];
+  const orphanSegments = [];
   let iea;
   let trailingBytes;
   let currentGroup;
   let currentTx;
+  const currentAnchor = () => {
+    if (currentGroup === void 0) {
+      return { kind: "interchange", groupIndex: groups.length };
+    }
+    if (currentTx === void 0) {
+      return {
+        kind: "group",
+        groupIndex: groups.length,
+        transactionIndex: currentGroup.transactions.length
+      };
+    }
+    return {
+      kind: "transaction",
+      groupIndex: groups.length,
+      transactionIndex: currentGroup.transactions.length,
+      segmentOffset: currentTx.rawSegments.length
+    };
+  };
+  const recordOrphan = (segmentText, position, context) => {
+    const anchor = currentAnchor();
+    warnings.push(unexpectedSegment(position, context));
+    orphanSegments.push({
+      raw: segmentText,
+      segment: decodeSegment(segmentText, delimiters, collectWarning, position),
+      segmentIndex: position.segmentIndex,
+      context,
+      anchor
+    });
+  };
   const finalizeTx = (tx, group, se) => {
     if (se === void 0) {
       warnings.push(
@@ -944,16 +1059,12 @@ function decodeEnvelope(raw, delimiters) {
       const actual = group.transactions.length;
       if (declared !== String(actual)) {
         warnings.push(
-          transactionCountMismatch(
-            {
-              segmentIndex: group.startSegIdx,
-              interchangeIndex: 0,
-              groupIndex: groups.length,
-              elementIndex: 1
-            },
-            declared,
-            actual
-          )
+          transactionCountMismatch({
+            segmentIndex: group.startSegIdx,
+            interchangeIndex: 0,
+            groupIndex: groups.length,
+            elementIndex: 1
+          })
         );
       }
       const gsControl = el(group.gs.elements, 6);
@@ -967,9 +1078,7 @@ function decodeEnvelope(raw, delimiters) {
               groupIndex: groups.length,
               elementIndex: 2
             },
-            "GS-06/GE-02",
-            gsControl,
-            geControl
+            CONTROL_NUMBER_PAIRS.GROUP
           )
         );
       }
@@ -991,16 +1100,14 @@ function decodeEnvelope(raw, delimiters) {
           ta1Segments.push({ raw: segmentText, elements });
           break;
         }
-        warnings.push(
-          unexpectedSegment(
-            {
-              segmentIndex: segIdx,
-              interchangeIndex: 0,
-              groupIndex: groups.length
-            },
-            "TA1",
-            "TA1 segment is envelope-level - appeared inside an open functional group"
-          )
+        recordOrphan(
+          segmentText,
+          {
+            segmentIndex: segIdx,
+            interchangeIndex: 0,
+            groupIndex: groups.length
+          },
+          UNEXPECTED_SEGMENT_CONTEXTS.TA1_INSIDE_GROUP
         );
         break;
       }
@@ -1021,12 +1128,10 @@ function decodeEnvelope(raw, delimiters) {
       }
       case "GE": {
         if (currentGroup === void 0) {
-          warnings.push(
-            unexpectedSegment(
-              { segmentIndex: segIdx, interchangeIndex: 0 },
-              "GE",
-              "no open functional group"
-            )
+          recordOrphan(
+            segmentText,
+            { segmentIndex: segIdx, interchangeIndex: 0 },
+            UNEXPECTED_SEGMENT_CONTEXTS.GE_WITHOUT_GS
           );
           break;
         }
@@ -1040,12 +1145,10 @@ function decodeEnvelope(raw, delimiters) {
       }
       case "ST": {
         if (currentGroup === void 0) {
-          warnings.push(
-            unexpectedSegment(
-              { segmentIndex: segIdx, interchangeIndex: 0 },
-              "ST",
-              "no open functional group (missing GS)"
-            )
+          recordOrphan(
+            segmentText,
+            { segmentIndex: segIdx, interchangeIndex: 0 },
+            UNEXPECTED_SEGMENT_CONTEXTS.ST_WITHOUT_GS
           );
           break;
         }
@@ -1068,12 +1171,10 @@ function decodeEnvelope(raw, delimiters) {
       }
       case "SE": {
         if (currentTx === void 0 || currentGroup === void 0) {
-          warnings.push(
-            unexpectedSegment(
-              { segmentIndex: segIdx, interchangeIndex: 0 },
-              "SE",
-              "no open transaction set"
-            )
+          recordOrphan(
+            segmentText,
+            { segmentIndex: segIdx, interchangeIndex: 0 },
+            UNEXPECTED_SEGMENT_CONTEXTS.SE_WITHOUT_ST
           );
           break;
         }
@@ -1098,9 +1199,7 @@ function decodeEnvelope(raw, delimiters) {
                 transactionIndex: currentGroup.transactions.length,
                 elementIndex: 2
               },
-              "ST-02/SE-02",
-              stControl,
-              seControl
+              CONTROL_NUMBER_PAIRS.TRANSACTION
             )
           );
         }
@@ -1119,11 +1218,7 @@ function decodeEnvelope(raw, delimiters) {
         const declared = el(elements, 1);
         if (declared !== String(groups.length)) {
           warnings.push(
-            groupCountMismatch(
-              { segmentIndex: segIdx, interchangeIndex: 0, elementIndex: 1 },
-              declared,
-              groups.length
-            )
+            groupCountMismatch({ segmentIndex: segIdx, interchangeIndex: 0, elementIndex: 1 })
           );
         }
         const isaControl = el(isa.elements, 13);
@@ -1132,9 +1227,7 @@ function decodeEnvelope(raw, delimiters) {
           warnings.push(
             controlNumberMismatch(
               { segmentIndex: segIdx, interchangeIndex: 0, elementIndex: 2 },
-              "ISA-13/IEA-02",
-              isaControl,
-              ieaControl
+              CONTROL_NUMBER_PAIRS.INTERCHANGE
             )
           );
         }
@@ -1142,15 +1235,14 @@ function decodeEnvelope(raw, delimiters) {
         if (tail.length > 0) {
           const joined = tail + delimiters.segment;
           trailingBytes = joined;
-          warnings.push(
-            trailingGarbage({ segmentIndex: segIdx + 1, interchangeIndex: 0 }, joined.length)
-          );
+          warnings.push(trailingGarbage({ segmentIndex: segIdx + 1, interchangeIndex: 0 }));
         }
         return {
           isa,
           groups: Object.freeze(groups.slice()),
           iea,
           ta1Segments: Object.freeze(ta1Segments.slice()),
+          orphanSegments: Object.freeze(orphanSegments.slice()),
           trailingBytes,
           warnings: Object.freeze(warnings.slice())
         };
@@ -1166,12 +1258,10 @@ function decodeEnvelope(raw, delimiters) {
           currentTx.segments.push(decoded);
           currentTx.rawSegments.push(segmentText);
         } else if (name.length > 0) {
-          warnings.push(
-            unexpectedSegment(
-              { segmentIndex: segIdx, interchangeIndex: 0 },
-              name,
-              "body segment outside any open transaction set"
-            )
+          recordOrphan(
+            segmentText,
+            { segmentIndex: segIdx, interchangeIndex: 0 },
+            UNEXPECTED_SEGMENT_CONTEXTS.BODY_OUTSIDE_TRANSACTION
           );
         }
         break;
@@ -1190,6 +1280,7 @@ function decodeEnvelope(raw, delimiters) {
     groups: Object.freeze(groups.slice()),
     iea,
     ta1Segments: Object.freeze(ta1Segments.slice()),
+    orphanSegments: Object.freeze(orphanSegments.slice()),
     trailingBytes,
     warnings: Object.freeze(warnings.slice())
   };
@@ -1215,7 +1306,7 @@ function parseX12(raw, options = {}) {
         first.code,
         first.message,
         first.position,
-        snippet(text)
+        ""
       );
     }
   }
@@ -1235,6 +1326,7 @@ function parseX12(raw, options = {}) {
     delimiters,
     groups: decoded.groups,
     ta1Segments: decoded.ta1Segments,
+    orphanSegments: decoded.orphanSegments,
     warnings: decoded.warnings,
     ...decoded.trailingBytes !== void 0 ? { trailingBytes: decoded.trailingBytes } : {},
     ...profile !== void 0 ? { profile } : {}
@@ -1751,14 +1843,7 @@ function checkClaimBalance(claim, position) {
   );
   const computed = claim.totalPaymentAmount.add(claimCasSum).add(lineCasSum);
   if (computed.equals(claim.totalChargeAmount)) return void 0;
-  const delta = computed.subtract(claim.totalChargeAmount);
-  return remitBalanceMismatch(
-    position,
-    "CLP-04 + \u03A3(claim CAS + line CAS) == CLP-03",
-    claim.totalChargeAmount.toString(),
-    computed.toString(),
-    delta.toString()
-  );
+  return remitBalanceMismatch(position, BALANCE_INVARIANTS.CLAIM);
 }
 function checkServiceLineBalance(claim, position) {
   const out = [];
@@ -1768,14 +1853,10 @@ function checkServiceLineBalance(claim, position) {
     const lineCasSum = sumAmounts(line.adjustments);
     const computed = line.paymentAmount.add(lineCasSum);
     if (computed.equals(line.chargeAmount)) continue;
-    const delta = computed.subtract(line.chargeAmount);
     out.push(
       remitBalanceMismatch(
         { ...position, segmentIndex: position.segmentIndex + i + 1 },
-        "SVC-03 + \u03A3(line CAS) == SVC-02",
-        line.chargeAmount.toString(),
-        computed.toString(),
-        delta.toString()
+        BALANCE_INVARIANTS.SERVICE_LINE
       )
     );
   }
@@ -1792,14 +1873,7 @@ function checkRemitTotalBalance(bpr02, claims, providerAdjustments, position) {
   );
   const computed = claimSum.subtract(plbSum);
   if (computed.equals(bpr02)) return void 0;
-  const delta = computed.subtract(bpr02);
-  return remitBalanceMismatch(
-    position,
-    "\u03A3(CLP-04) - \u03A3(PLB amounts) == BPR-02",
-    bpr02.toString(),
-    computed.toString(),
-    delta.toString()
-  );
+  return remitBalanceMismatch(position, BALANCE_INVARIANTS.REMIT_TOTAL);
 }
 function sumAmounts(adjustments) {
   return adjustments.reduce(
@@ -1915,7 +1989,7 @@ function get835(delimiters, tx) {
       case "CLP": {
         flushClaim();
         lastParty = void 0;
-        currentClaim = openClaim(seg, delimiters);
+        currentClaim = openClaim(seg, delimiters, position.segmentIndex);
         break;
       }
       case "CAS": {
@@ -1961,7 +2035,7 @@ function get835(delimiters, tx) {
         const remarks = seg.id === "MIA" ? collectMiaRemarks(seg, delimiters) : collectMoaRemarks(seg, delimiters);
         for (const code of remarks) {
           const entry = lookupRarc(code);
-          if (entry === void 0) warnings.push(unknownRarc(position, code));
+          if (entry === void 0) warnings.push(unknownRarc(position));
           currentClaim.remarks.push({ system: "HE", code, description: entry?.description });
         }
         break;
@@ -2099,7 +2173,7 @@ function decodeLq(seg, delimiters, warnings, position) {
   let description;
   if (system === "HE") {
     const entry = lookupRarc(code);
-    if (entry === void 0) warnings.push(unknownRarc(position, code));
+    if (entry === void 0) warnings.push(unknownRarc(position));
     description = entry?.description;
   }
   return Object.freeze({ system, code, description });
@@ -2131,7 +2205,7 @@ function decodeCasAdjustments(seg, delimiters, warnings, position) {
     if (reasonCode === void 0 && amount === void 0) continue;
     const code = reasonCode ?? "";
     const entry = code === "" ? void 0 : lookupCarc(code);
-    if (entry === void 0 && code !== "") warnings.push(unknownCarc(position, code));
+    if (entry === void 0 && code !== "") warnings.push(unknownCarc(position));
     out.push(
       Object.freeze({
         groupCode,
@@ -2171,14 +2245,13 @@ function decodeNm1(seg, delimiters) {
     })
   };
 }
-function openClaim(seg, delimiters) {
+function openClaim(seg, delimiters, clpSegmentIndex) {
   const claimStatusCode = elementValue(seg, 2, delimiters);
   const claimStatusDescription = lookupClpStatus(claimStatusCode)?.description;
   const facilityTypeCode = componentOptional(seg, 8, 1, delimiters) ?? elementOptional(seg, 8, delimiters);
   const claimFrequencyCode = componentOptional(seg, 8, 3, delimiters);
   return {
-    clpSegmentIndex: 0,
-    // populated in the future when we surface positions
+    clpSegmentIndex,
     patientControlNumber: elementValue(seg, 1, delimiters),
     claimStatusCode,
     claimStatusDescription,
@@ -2984,12 +3057,7 @@ function get837Claims(delimiters, tx, opts) {
   }
   const variant = explicitType ?? variantFromIcr ?? variantFromSegment ?? "unknown";
   if (variant === "unknown") {
-    warnings.push(
-      unknown837Variant(
-        { segmentIndex: 1, transactionIndex: 0 },
-        implementationConventionReference
-      )
-    );
+    warnings.push(unknown837Variant({ segmentIndex: 1, transactionIndex: 0 }));
   }
   const hierarchies = [];
   const hlIndex = /* @__PURE__ */ new Map();
@@ -3230,28 +3298,16 @@ function get837Claims(delimiters, tx, opts) {
         flushClaim();
         if (currentBillingHl === void 0 || currentSubscriberHl === void 0 || currentSubscriberMember === void 0 || currentPayer === void 0) {
           if (currentBillingHl === void 0) {
-            warnings.push(
-              missingRequiredLoop(position, "2000A", "no Billing Provider HL precedes the CLM")
-            );
+            warnings.push(missingRequiredLoop(position, REQUIRED_LOOPS.BILLING_PROVIDER_2000A));
           }
           if (currentSubscriberHl === void 0) {
-            warnings.push(
-              missingRequiredLoop(position, "2000B", "no Subscriber HL precedes the CLM")
-            );
+            warnings.push(missingRequiredLoop(position, REQUIRED_LOOPS.SUBSCRIBER_2000B));
           }
           if (currentSubscriberMember === void 0 && currentSubscriberHl !== void 0) {
-            warnings.push(
-              missingRequiredLoop(
-                position,
-                "2010BA",
-                "no Subscriber Name follows the Subscriber HL"
-              )
-            );
+            warnings.push(missingRequiredLoop(position, REQUIRED_LOOPS.SUBSCRIBER_NAME_2010BA));
           }
           if (currentPayer === void 0 && currentSubscriberHl !== void 0) {
-            warnings.push(
-              missingRequiredLoop(position, "2010BB", "no Payer Name follows the Subscriber HL")
-            );
+            warnings.push(missingRequiredLoop(position, REQUIRED_LOOPS.PAYER_NAME_2010BB));
           }
         }
         currentClaim = openClaim2(seg, delimiters, {
@@ -3396,30 +3452,21 @@ function validateHl(hl, index, position, warnings) {
   const expectedParent = EXPECTED_PARENT_LEVEL[hl.levelCode];
   if (expectedParent === void 0) {
     if (hl.levelCode === HL_LEVEL_CODES.INFORMATION_SOURCE && hl.parentHlId !== void 0) {
-      warnings.push(hlParentMismatch(position, hl.hlId, hl.parentHlId));
+      warnings.push(hlParentMismatch(position));
     }
     return;
   }
   if (hl.parentHlId === void 0) {
-    warnings.push(hlParentMismatch(position, hl.hlId, ""));
+    warnings.push(hlParentMismatch(position));
     return;
   }
   const parent = index.get(hl.parentHlId);
   if (parent === void 0) {
-    warnings.push(hlParentMismatch(position, hl.hlId, hl.parentHlId));
+    warnings.push(hlParentMismatch(position));
     return;
   }
   if (parent.levelCode !== expectedParent) {
-    warnings.push(
-      hlParentLevelInvalid(
-        position,
-        hl.hlId,
-        hl.levelCode,
-        parent.hlId,
-        parent.levelCode,
-        expectedParent
-      )
-    );
+    warnings.push(hlParentLevelInvalid(position));
   }
 }
 function decodeSbr(seg, delimiters) {
@@ -3520,7 +3567,7 @@ function decodeHi(seg, delimiters, warnings, position) {
     const codeSystem = resolved?.system ?? "unknown";
     const category = resolved?.category ?? "unknown";
     if (qualifier !== void 0 && resolved === void 0) {
-      warnings.push(unknownHiQualifier(position, qualifier));
+      warnings.push(unknownHiQualifier(position));
     }
     out.push(
       Object.freeze({
@@ -3563,7 +3610,7 @@ function decodeCas(seg, delimiters, warnings, position) {
     if (reasonCode === void 0 && amount === void 0) continue;
     const code = reasonCode ?? "";
     const entry = code === "" ? void 0 : lookupCarc(code);
-    if (entry === void 0 && code !== "") warnings.push(unknownCarc(position, code));
+    if (entry === void 0 && code !== "") warnings.push(unknownCarc(position));
     out.push(
       Object.freeze({
         groupCode,
@@ -4805,30 +4852,21 @@ function validateHl2(hl, index, expectedParentLevel, position, warnings) {
   const expectedParent = hasExpectation ? expectedParentLevel[hl.levelCode] : void 0;
   if (expectedParent === void 0) {
     if (hasExpectation && hl.parentHlId !== void 0) {
-      warnings.push(hlParentMismatch(position, hl.hlId, hl.parentHlId));
+      warnings.push(hlParentMismatch(position));
     }
     return;
   }
   if (hl.parentHlId === void 0) {
-    warnings.push(hlParentMismatch(position, hl.hlId, ""));
+    warnings.push(hlParentMismatch(position));
     return;
   }
   const parent = index.get(hl.parentHlId);
   if (parent === void 0) {
-    warnings.push(hlParentMismatch(position, hl.hlId, hl.parentHlId));
+    warnings.push(hlParentMismatch(position));
     return;
   }
   if (parent.levelCode !== expectedParent) {
-    warnings.push(
-      hlParentLevelInvalid(
-        position,
-        hl.hlId,
-        hl.levelCode,
-        parent.hlId,
-        parent.levelCode,
-        expectedParent
-      )
-    );
+    warnings.push(hlParentLevelInvalid(position));
   }
 }
 
@@ -5781,11 +5819,11 @@ function decodeStatusComposite(seg, n, delimiters, warnings, position) {
   if (categoryCode === void 0 && statusCode === void 0) return void 0;
   const category = categoryCode === void 0 ? void 0 : lookupClaimStatusCategory(categoryCode);
   if (categoryCode !== void 0 && category === void 0) {
-    warnings.push(unknownClaimStatusCategory(position, categoryCode));
+    warnings.push(unknownClaimStatusCategory(position));
   }
   const status = statusCode === void 0 ? void 0 : lookupClaimStatus(statusCode);
   if (statusCode !== void 0 && status === void 0) {
-    warnings.push(unknownClaimStatus(position, statusCode));
+    warnings.push(unknownClaimStatus(position));
   }
   return Object.freeze({
     categoryCode: categoryCode ?? "",
@@ -7109,7 +7147,7 @@ function openEnrollment(seg, delimiters, position) {
   const entry = maintenanceTypeCode === "" ? void 0 : lookupMaintenanceType(maintenanceTypeCode);
   const warnings = [];
   if (maintenanceTypeCode !== "" && entry === void 0) {
-    warnings.push(unknownMaintenanceType(position, maintenanceTypeCode));
+    warnings.push(unknownMaintenanceType(position));
   }
   return {
     subscriberIndicator: elementOptional(seg, 1, delimiters),
@@ -7149,7 +7187,7 @@ function openCoverage(seg, delimiters, position, warnings) {
   let maintenanceTypeDescription;
   if (maintenanceTypeCode !== void 0) {
     const entry = lookupMaintenanceType(maintenanceTypeCode);
-    if (entry === void 0) warnings.push(unknownMaintenanceType(position, maintenanceTypeCode));
+    if (entry === void 0) warnings.push(unknownMaintenanceType(position));
     maintenanceTypeDescription = entry?.description;
   }
   return {
@@ -7862,7 +7900,7 @@ function decodeHiDiagnoses(seg, delimiters, warnings, position) {
     const resolved = qualifier === void 0 ? void 0 : resolveHiQualifier(qualifier);
     const codeSystem = resolved?.system ?? "unknown";
     if (qualifier !== void 0 && resolved === void 0) {
-      warnings.push(unknownHiQualifier(position, qualifier));
+      warnings.push(unknownHiQualifier(position));
     }
     out.push(Object.freeze({ qualifier: qualifier ?? "", code: code ?? "", codeSystem }));
   }
@@ -9010,18 +9048,39 @@ function serializeX12(interchange, opts = {}) {
   };
   let out = interchange.isa.raw;
   let segIdx = 0;
+  const orphans = interchange.orphanSegments ?? [];
+  const placed = /* @__PURE__ */ new Set();
+  const flushOrphans = (slot) => {
+    let written = 0;
+    for (const [i, orphan] of orphans.entries()) {
+      if (placed.has(i)) continue;
+      if (!slot(orphan.anchor)) continue;
+      placed.add(i);
+      out += orphan.raw + term;
+      segIdx++;
+      written++;
+    }
+    return written;
+  };
   for (const ta1 of interchange.ta1Segments) {
     out += ta1.raw + term;
     segIdx++;
   }
   for (const [g, group] of interchange.groups.entries()) {
+    flushOrphans((a) => a?.kind === "interchange" && a.groupIndex === g);
     const gsSegIdx = ++segIdx;
     out += group.gs.raw + term;
     for (const [t, tx] of group.transactions.entries()) {
-      const stSegIdx = segIdx + 1;
-      const segCount = tx.rawSegments.length;
+      flushOrphans((a) => a?.kind === "group" && a.groupIndex === g && a.transactionIndex === t);
       const lastIdx = tx.rawSegments.length - 1;
+      let segCount = tx.rawSegments.length;
+      let stSegIdx = segIdx + 1;
       for (const [k, raw] of tx.rawSegments.entries()) {
+        const inside = flushOrphans(
+          (a) => a?.kind === "transaction" && a.groupIndex === g && a.transactionIndex === t && a.segmentOffset === k
+        );
+        if (k === 0) stSegIdx = segIdx + 1;
+        else segCount += inside;
         segIdx++;
         if (recompute && tx.se !== void 0 && k === lastIdx) {
           out += substituteElement(tx.se.elements, 1, String(segCount), elementSep) + term;
@@ -9029,21 +9088,20 @@ function serializeX12(interchange, opts = {}) {
           out += raw + term;
         }
       }
+      flushOrphans(
+        (a) => a?.kind === "transaction" && a.groupIndex === g && a.transactionIndex === t && a.segmentOffset === tx.rawSegments.length
+      );
       if (specClean && tx.se !== void 0) {
         const declaredSe = elementAt(tx.se.elements, 1);
         if (declaredSe !== String(segCount)) {
           emit(
-            segmentCountMismatch(
-              {
-                segmentIndex: stSegIdx,
-                interchangeIndex: 0,
-                groupIndex: g,
-                transactionIndex: t,
-                elementIndex: 1
-              },
-              declaredSe,
-              segCount
-            )
+            segmentCountMismatch({
+              segmentIndex: stSegIdx,
+              interchangeIndex: 0,
+              groupIndex: g,
+              transactionIndex: t,
+              elementIndex: 1
+            })
           );
         }
         const st02 = elementAt(tx.st.elements, 2);
@@ -9058,14 +9116,15 @@ function serializeX12(interchange, opts = {}) {
                 transactionIndex: t,
                 elementIndex: 2
               },
-              "ST-02/SE-02",
-              st02,
-              se02
+              CONTROL_NUMBER_PAIRS.TRANSACTION
             )
           );
         }
       }
     }
+    flushOrphans(
+      (a) => a?.kind === "group" && a.groupIndex === g && a.transactionIndex === group.transactions.length
+    );
     if (group.ge !== void 0) {
       const txCount = group.transactions.length;
       segIdx++;
@@ -9078,11 +9137,12 @@ function serializeX12(interchange, opts = {}) {
         const declaredGe = elementAt(group.ge.elements, 1);
         if (declaredGe !== String(txCount)) {
           emit(
-            transactionCountMismatch(
-              { segmentIndex: gsSegIdx, interchangeIndex: 0, groupIndex: g, elementIndex: 1 },
-              declaredGe,
-              txCount
-            )
+            transactionCountMismatch({
+              segmentIndex: gsSegIdx,
+              interchangeIndex: 0,
+              groupIndex: g,
+              elementIndex: 1
+            })
           );
         }
         const gs06 = elementAt(group.gs.elements, 6);
@@ -9091,15 +9151,15 @@ function serializeX12(interchange, opts = {}) {
           emit(
             controlNumberMismatch(
               { segmentIndex: gsSegIdx, interchangeIndex: 0, groupIndex: g, elementIndex: 2 },
-              "GS-06/GE-02",
-              gs06,
-              ge02
+              CONTROL_NUMBER_PAIRS.GROUP
             )
           );
         }
       }
     }
   }
+  flushOrphans((a) => a?.kind === "interchange" && a.groupIndex === interchange.groups.length);
+  flushOrphans(() => true);
   if (interchange.iea !== void 0) {
     const groupCount = interchange.groups.length;
     segIdx++;
@@ -9111,13 +9171,7 @@ function serializeX12(interchange, opts = {}) {
     if (specClean) {
       const declaredIea = elementAt(interchange.iea.elements, 1);
       if (declaredIea !== String(groupCount)) {
-        emit(
-          groupCountMismatch(
-            { segmentIndex: segIdx, interchangeIndex: 0, elementIndex: 1 },
-            declaredIea,
-            groupCount
-          )
-        );
+        emit(groupCountMismatch({ segmentIndex: segIdx, interchangeIndex: 0, elementIndex: 1 }));
       }
       const isa13 = elementAt(interchange.isa.elements, 13);
       const iea02 = elementAt(interchange.iea.elements, 2);
@@ -9125,9 +9179,7 @@ function serializeX12(interchange, opts = {}) {
         emit(
           controlNumberMismatch(
             { segmentIndex: segIdx, interchangeIndex: 0, elementIndex: 2 },
-            "ISA-13/IEA-02",
-            isa13,
-            iea02
+            CONTROL_NUMBER_PAIRS.INTERCHANGE
           )
         );
       }
@@ -9590,9 +9642,10 @@ var profiles = Object.freeze({
 });
 
 // src/index.ts
-var VERSION = "0.0.3";
+var VERSION = "0.0.4";
 
 exports.ACK_BUILD_ERROR_CODES = ACK_BUILD_ERROR_CODES;
+exports.ALL_WARNING_MESSAGES = ALL_WARNING_MESSAGES;
 exports.AUTH_278_BUILD_ERROR_CODES = AUTH_278_BUILD_ERROR_CODES;
 exports.AUTH_278_LOOP_2000A = AUTH_278_LOOP_2000A;
 exports.AUTH_278_LOOP_2000B = AUTH_278_LOOP_2000B;
@@ -9601,6 +9654,7 @@ exports.AUTH_278_LOOP_2000D = AUTH_278_LOOP_2000D;
 exports.AUTH_278_LOOP_2000E = AUTH_278_LOOP_2000E;
 exports.AUTH_278_LOOP_2000F = AUTH_278_LOOP_2000F;
 exports.AckBuildError = AckBuildError;
+exports.BALANCE_INVARIANTS = BALANCE_INVARIANTS;
 exports.CARC = CARC;
 exports.CLAIM_837D_LOOP_2000A = CLAIM_837D_LOOP_2000A;
 exports.CLAIM_837D_LOOP_2300 = CLAIM_837D_LOOP_2300;
@@ -9625,6 +9679,7 @@ exports.CLAIM_STATUS_277_BUILD_ERROR_CODES = CLAIM_STATUS_277_BUILD_ERROR_CODES;
 exports.CLAIM_STATUS_CATEGORY_CODES = CLAIM_STATUS_CATEGORY_CODES;
 exports.CLAIM_STATUS_CODES = CLAIM_STATUS_CODES;
 exports.CLP_STATUS = CLP_STATUS;
+exports.CONTROL_NUMBER_PAIRS = CONTROL_NUMBER_PAIRS;
 exports.Claim837BuildError = Claim837BuildError;
 exports.ClaimStatus277BuildError = ClaimStatus277BuildError;
 exports.DELIMITER_POSITIONS = DELIMITER_POSITIONS;
@@ -9654,6 +9709,7 @@ exports.ISA_MIN_LENGTH = ISA_MIN_LENGTH;
 exports.LoopSpecDefinitionError = LoopSpecDefinitionError;
 exports.MAINTENANCE_TYPE_CODES = MAINTENANCE_TYPE_CODES;
 exports.NM1_QUALIFIERS = NM1_QUALIFIERS;
+exports.NON_SPEC_SEGMENT_ID = NON_SPEC_SEGMENT_ID;
 exports.PREMIUM_820_BUILD_ERROR_CODES = PREMIUM_820_BUILD_ERROR_CODES;
 exports.PREMIUM_820_LOOP_1000A = PREMIUM_820_LOOP_1000A;
 exports.PREMIUM_820_LOOP_1000B = PREMIUM_820_LOOP_1000B;
@@ -9670,6 +9726,7 @@ exports.REMIT_835_LOOP_1000B = REMIT_835_LOOP_1000B;
 exports.REMIT_835_LOOP_2000 = REMIT_835_LOOP_2000;
 exports.REMIT_835_LOOP_2100 = REMIT_835_LOOP_2100;
 exports.REMIT_835_LOOP_2110 = REMIT_835_LOOP_2110;
+exports.REQUIRED_LOOPS = REQUIRED_LOOPS;
 exports.Remit835BuildError = Remit835BuildError;
 exports.SERVICE_TYPE_CODES = SERVICE_TYPE_CODES;
 exports.STATUS_277_LOOP_2000A = STATUS_277_LOOP_2000A;
@@ -9682,6 +9739,7 @@ exports.STATUS_277_LOOP_2220 = STATUS_277_LOOP_2220;
 exports.ServicesReview278BuildError = ServicesReview278BuildError;
 exports.TA1_ACK_CODES = TA1_ACK_CODES;
 exports.TA1_NOTE_CODES = TA1_NOTE_CODES;
+exports.UNEXPECTED_SEGMENT_CONTEXTS = UNEXPECTED_SEGMENT_CONTEXTS;
 exports.VERSION = VERSION;
 exports.WARNING_CODES = WARNING_CODES;
 exports.X12BuildError = X12BuildError;