@cosyte/x12 0.0.14 → 0.0.15

package/dist/index.mjs

@@ -1095,7 +1095,10 @@ function splitSegments(text, start, delimiters) {
   return { segments, endIndex: lastEnd };
 }
 function splitElements(segment, delimiters) {
-  return Object.freeze(segment.split(delimiters.element));
+  if (delimiters.element === RELEASE_CHAR) {
+    return Object.freeze(segment.split(delimiters.element));
+  }
+  return Object.freeze(splitWithRelease(segment, delimiters.element));
 }
 function el(elements, index) {
   return elements[index] ?? "";
@@ -4567,6 +4570,29 @@ var VERSION_BY_VARIANT = {
   I: "005010X223A3",
   D: "005010X224A2"
 };
+function resolveVersionRelease(variant, reference, esc) {
+  if (reference === void 0) return VERSION_BY_VARIANT[variant];
+  if (reference === "") {
+    throw new Claim837BuildError(
+      CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_SPEC,
+      "build837: envelope.implementationConventionReference is empty. ST-03 and GS-08 are required elements and a trailing empty element is not emitted, so an empty reference would remove them rather than send them empty. Omit the field to take the builder's default."
+    );
+  }
+  if (esc(reference) !== reference) {
+    throw new Claim837BuildError(
+      CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_SPEC,
+      "build837: envelope.implementationConventionReference carries an active delimiter or the release character. Escaping does not make it safe here: the ST and GS segments are read by a splitter that is not release-aware, so a released delimiter still splits the segment and the declaration silently becomes two elements. State a reference that carries neither, or choose different delimiters."
+    );
+  }
+  const named = Object.hasOwn(VARIANT_BY_ICR, reference) ? VARIANT_BY_ICR[reference] : void 0;
+  if (named !== void 0 && named !== variant) {
+    throw new Claim837BuildError(
+      CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_SPEC,
+      `build837: envelope.implementationConventionReference names an implementation guide this library reads as a DIFFERENT 837 variant, but this is build837${variant}. The emitted file would declare one variant and carry another's service segments, and this library's own reader would then decode none of its service lines. State a reference for the ${variant} 837, or build with the entry point that matches the reference.`
+    );
+  }
+  return reference;
+}
 var X12_837_FUNCTIONAL_ID = "HC";
 var X12_AGENCY_CODE2 = "X";
 var HL_LEVEL = { BILLING: "20", SUBSCRIBER: "22", PATIENT: "23" };
@@ -4581,7 +4607,6 @@ function build837D(spec) {
 }
 function buildClaim837(variant, spec) {
   const { envelope } = spec;
-  const versionRelease = VERSION_BY_VARIANT[variant];
   enforceStructuralSpec2(variant, spec);
   const elementSeparator = envelope.elementSeparator ?? "*";
   const repetitionSeparator = envelope.repetitionSeparator ?? "^";
@@ -4607,6 +4632,11 @@ function buildClaim837(variant, spec) {
     return escaped.slice(0, end).join(componentSeparator);
   };
   const ctx = { seg, esc, comp };
+  const versionRelease = resolveVersionRelease(
+    variant,
+    envelope.implementationConventionReference,
+    esc
+  );
   const senderQualifier = envelope.senderQualifier ?? "ZZ";
   const receiverQualifier = envelope.receiverQualifier ?? "ZZ";
   const usageIndicator = envelope.usageIndicator ?? "P";
@@ -9731,18 +9761,27 @@ function expandYY8(yymmdd) {
 // src/transactions/ack/build-ta1.ts
 function buildTA1(spec, options = {}) {
   enforceAcceptIsClean2(spec);
-  const elementSeparator = options.elementSeparator ?? "*";
+  const delimiters = {
+    element: options.elementSeparator ?? "*",
+    repetition: options.repetitionSeparator ?? "^",
+    component: options.componentSeparator ?? ":",
+    segment: options.segmentTerminator ?? "~"
+  };
+  const esc = makeCallerEscaper(delimiters, "buildTA1", refuseSpec9);
   const elements = Object.freeze([
     "TA1",
-    spec.interchangeControlNumber,
-    spec.interchangeDate,
-    spec.interchangeTime,
-    spec.ackCode,
-    spec.noteCode
+    esc(spec.interchangeControlNumber),
+    esc(spec.interchangeDate),
+    esc(spec.interchangeTime),
+    esc(spec.ackCode),
+    esc(spec.noteCode)
   ]);
-  const raw = elements.join(elementSeparator);
+  const raw = elements.join(delimiters.element);
   return Object.freeze({ raw, elements });
 }
+function refuseSpec9(message) {
+  throw new AckBuildError(ACK_BUILD_ERROR_CODES.X12_ACK_INVALID_SPEC, message);
+}
 function enforceAcceptIsClean2(spec) {
   if (spec.ackCode === TA1_ACK_CODES.A && spec.noteCode !== "000") {
     throw new AckBuildError(
@@ -9931,7 +9970,7 @@ var X12BuildError = class extends Error {
 };
 
 // src/builder/build-interchange.ts
-function refuseSpec9(message) {
+function refuseSpec10(message) {
   throw new X12BuildError(X12_BUILD_ERROR_CODES.X12_BUILD_INVALID_SPEC, message);
 }
 function buildInterchange(spec) {
@@ -9945,7 +9984,7 @@ function buildInterchange(spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = makeCallerEscaper(delimiters, "buildInterchange", refuseSpec9);
+  const esc = makeCallerEscaper(delimiters, "buildInterchange", refuseSpec10);
   const senderQualifier = spec.senderQualifier ?? "ZZ";
   const receiverQualifier = spec.receiverQualifier ?? "ZZ";
   const usageIndicator = spec.usageIndicator ?? "P";
@@ -10059,7 +10098,7 @@ function buildTransaction(tx, esc, elementSeparator, segmentTerminator) {
   return st + bodySegments + se;
 }
 function joinSeg2(parts, elementSeparator, segmentTerminator) {
-  requireCallerSegment(parts, "buildInterchange", refuseSpec9);
+  requireCallerSegment(parts, "buildInterchange", refuseSpec10);
   return parts.join(elementSeparator) + segmentTerminator;
 }
 function pad9(value, width) {
@@ -10368,7 +10407,7 @@ var profiles = Object.freeze({
 });
 
 // src/index.ts
-var VERSION = "0.0.14";
+var VERSION = "0.0.15";
 
 export { ACK_BUILD_ERROR_CODES, ALL_WARNING_MESSAGES, AUTH_278_BUILD_ERROR_CODES, AUTH_278_LOOP_2000A, AUTH_278_LOOP_2000B, AUTH_278_LOOP_2000C, AUTH_278_LOOP_2000D, AUTH_278_LOOP_2000E, AUTH_278_LOOP_2000F, AckBuildError, BALANCE_INVARIANTS, BUILD_REFUSAL_VALUE_MAX_LENGTH, BUILD_REFUSAL_VALUE_MAX_RENDERED, CARC, CLAIM_837D_LOOP_2000A, CLAIM_837D_LOOP_2300, CLAIM_837D_LOOP_2400, CLAIM_837I_LOOP_2000A, CLAIM_837I_LOOP_2300, CLAIM_837I_LOOP_2400, CLAIM_837P_LOOP_2000A, CLAIM_837P_LOOP_2300, CLAIM_837P_LOOP_2400, CLAIM_837P_LOOP_2410, CLAIM_837_BUILD_ERROR_CODES, CLAIM_837_LOOP_1000A, CLAIM_837_LOOP_1000B, CLAIM_837_LOOP_2010AA, CLAIM_837_LOOP_2010BA, CLAIM_837_LOOP_2010BB, CLAIM_837_LOOP_2010CA, CLAIM_837_LOOP_2430, CLAIM_ADJUSTMENT_GROUP_CODES, CLAIM_STATUS_277_BUILD_ERROR_CODES, CLAIM_STATUS_CATEGORY_CODES, CLAIM_STATUS_CODES, CLP_STATUS, CONTROL_NUMBER_PAIRS, Claim837BuildError, ClaimStatus277BuildError, DELIMITER_POSITIONS, ELIGIBILITY_271_BUILD_ERROR_CODES, ELIGIBILITY_271_LOOP_2000A, ELIGIBILITY_271_LOOP_2000B, ELIGIBILITY_271_LOOP_2000C, ELIGIBILITY_271_LOOP_2000D, ELIGIBILITY_271_LOOP_2100C, ELIGIBILITY_271_LOOP_2100D, ELIGIBILITY_271_LOOP_2110, ENROLLMENT_834_BUILD_ERROR_CODES, ENROLLMENT_834_LOOP_1000A, ENROLLMENT_834_LOOP_1000B, ENROLLMENT_834_LOOP_2000, ENROLLMENT_834_LOOP_2100A, ENROLLMENT_834_LOOP_2300, ENROLLMENT_834_LOOP_2320, Eligibility271BuildError, Enrollment834BuildError, FATAL_CODES, HI_QUALIFIERS, HL_LEVEL_CODES, IK3_SYNTAX_ERROR_CODES, IK4_SYNTAX_ERROR_CODES, ISA_MIN_LENGTH, LoopSpecDefinitionError, MAINTENANCE_TYPE_CODES, NM1_QUALIFIERS, NON_SPEC_SEGMENT_ID, PREMIUM_820_BUILD_ERROR_CODES, PREMIUM_820_LOOP_1000A, PREMIUM_820_LOOP_1000B, PREMIUM_820_LOOP_2000A, PREMIUM_820_LOOP_2100A, PREMIUM_820_LOOP_2300A, PREMIUM_820_LOOP_2310A, Premium820BuildError, RARC, RELEASE_CHAR, REMIT_835_BUILD_ERROR_CODES, REMIT_835_LOOP_1000A, REMIT_835_LOOP_1000B, REMIT_835_LOOP_2000, REMIT_835_LOOP_2100, REMIT_835_LOOP_2110, REQUIRED_LOOPS, Remit835BuildError, SERVICE_TYPE_CODES, STATUS_277_LOOP_2000A, STATUS_277_LOOP_2000B, STATUS_277_LOOP_2000C, STATUS_277_LOOP_2000D, STATUS_277_LOOP_2000E, STATUS_277_LOOP_2200, STATUS_277_LOOP_2220, ServicesReview278BuildError, TA1_ACK_CODES, TA1_NOTE_CODES, UNEXPECTED_SEGMENT_CONTEXTS, VERSION, WARNING_CODES, X12BuildError, X12Decimal, X12ParseError, X12ProfileError, X12_ACK_DISPOSITION_CODES, X12_BUILD_ERROR_CODES, ambiguous837Variant, amountRowDropped, balanceNotEvaluable, build271, build277, build277CA, build278Request, build278Response, build820, build834, build835, build837D, build837I, build837P, build999, buildInterchange, buildTA1, checkClaimBalance, checkRemitTotalBalance, checkServiceLineBalance, collectElementValues, componentOptional, controlNumberMismatch, danglingReleaseChar, decodeSegment, defineLoopSpec, defineProfile, detectDelimiters, elementDecimal, elementDecimalOrZero, elementOptional, elementValue, entitySegmentDiscardedAfterLx, escapeRelease, get271Eligibility, get277CADisposition, get277Status, get278Request, get278Response, get820Payments, get834Enrollments, get834Header, get835, get837Claims, getAllSegmentValues, getDefaultProfile, getSegmentValue, groupCountMismatch, hlParentLevelInvalid, hlParentMismatch, isAcceptDisposition, isClaimAdjustmentGroupCode, isDiagnosisQualifier, isProcedureQualifier, lookupCarc, lookupClaimStatus, lookupClaimStatusCategory, lookupClpStatus, lookupMaintenanceType, lookupRarc, lookupServiceType, missingGe, missingIea, missingRequiredLoop, missingSe, parse999, parseTA1, parseX12, partitionWarnings, payToAddressRepeated, pre005010, profiles, readElementDecimal, remitBalanceMismatch, renderCallerValue, resolveHiQualifier, segmentCountMismatch, serializeX12, serviceLineDropped, serviceLineNotDecoded, serviceSegmentRepeated, serviceSegmentWithoutLx, setDefaultProfile, statedAmountDiscarded, trailingGarbage, transactionCountMismatch, unescapeRelease, unexpectedSegment, unknown837Variant, unknownCarc, unknownClaimStatus, unknownClaimStatusCategory, unknownHiQualifier, unknownMaintenanceType, unknownRarc, unparseableDecimal };
 //# sourceMappingURL=index.mjs.map