@cosyte/x12 0.0.4 → 0.0.6

package/dist/index.mjs

@@ -1886,6 +1886,7 @@ function get835(delimiters, tx) {
   const warnings = [];
   const body = tx.se === void 0 ? tx.segments.slice(1) : tx.segments.slice(1, -1);
   let payment = EMPTY_HEADER;
+  let bprSegmentIndex = 0;
   const traces = [];
   let payer;
   let payee;
@@ -1914,6 +1915,7 @@ function get835(delimiters, tx) {
     switch (seg.id) {
       case "BPR": {
         payment = decodeBpr(seg, delimiters);
+        bprSegmentIndex = position.segmentIndex;
         break;
       }
       case "TRN": {
@@ -2081,7 +2083,7 @@ function get835(delimiters, tx) {
     payment.totalActualPayment,
     finalClaims,
     providerAdjustments,
-    { segmentIndex: 0, transactionIndex: 0 }
+    { segmentIndex: bprSegmentIndex, transactionIndex: 0 }
   );
   if (remitTotalWarn !== void 0) warnings.push(remitTotalWarn);
   return Object.freeze({
@@ -2442,10 +2444,79 @@ var Remit835BuildError = class extends Error {
   }
 };
 
+// src/builder/caller-value.ts
+var BUILD_REFUSAL_VALUE_MAX_LENGTH = 63;
+var MAX_LENGTH_DIGITS = 10;
+var BUILD_REFUSAL_VALUE_MAX_RENDERED = BUILD_REFUSAL_VALUE_MAX_LENGTH + 2 + 1 + " ( characters)".length + MAX_LENGTH_DIGITS;
+function renderCallerValue(value) {
+  const text = coerce(value);
+  if (text.length <= BUILD_REFUSAL_VALUE_MAX_LENGTH) return `"${text}"`;
+  return `"${text.slice(0, BUILD_REFUSAL_VALUE_MAX_LENGTH)}\u2026" (${String(text.length)} characters)`;
+}
+function coerce(value) {
+  if (typeof value === "string") return value;
+  try {
+    return String(value);
+  } catch {
+    return "[unrenderable value]";
+  }
+}
+function renderCallerJson(value) {
+  let text;
+  try {
+    text = JSON.stringify(value) ?? "undefined";
+  } catch {
+    return "[unrenderable value]";
+  }
+  if (text.length <= BUILD_REFUSAL_VALUE_MAX_LENGTH) return text;
+  return `${text.slice(0, BUILD_REFUSAL_VALUE_MAX_LENGTH)}\u2026 (${String(text.length)} characters)`;
+}
+
+// src/builder/caller-array.ts
+var NONE = Object.freeze([]);
+function describeShape(value) {
+  if (typeof value !== "object") {
+    return `a ${typeof value} (${renderCallerValue(value)})`;
+  }
+  let length;
+  try {
+    length = value.length;
+  } catch {
+    return "an object whose 'length' getter threw";
+  }
+  if (length !== void 0) {
+    return `an array-like object with length ${renderCallerValue(length)}`;
+  }
+  let tag;
+  try {
+    tag = Object.prototype.toString.call(value);
+  } catch {
+    tag = "[object Unknown]";
+  }
+  return `a non-array ${renderCallerValue(tag)}`;
+}
+function requireCallerArray(value, at, refuse) {
+  if (value === void 0 || value === null) return NONE;
+  if (!isRealArray(value)) {
+    refuse(`${at} must be an array. Received ${describeShape(value)}.`);
+  }
+  return value;
+}
+function isRealArray(value) {
+  return Array.isArray(value);
+}
+
 // src/transactions/remit/build-835.ts
+function refuseSpec(message) {
+  throw new Remit835BuildError(REMIT_835_BUILD_ERROR_CODES.X12_835_BUILD_INVALID_SPEC, message);
+}
 var X221A1_VERSION_RELEASE = "005010X221A1";
 var X12_835_FUNCTIONAL_ID = "HP";
 var X12_AGENCY_CODE = "X";
+var UNANCHORED_BUILD_POSITION = Object.freeze({
+  segmentIndex: 0,
+  transactionIndex: 0
+});
 function build835(spec) {
   const { envelope } = spec;
   enforceStructuralSpec(spec);
@@ -2592,7 +2663,14 @@ function build835(spec) {
       emitClaim(claim, body, seg, esc, comp);
     }
   }
-  emitProviderAdjustments(spec.providerAdjustments ?? [], body, seg, esc, comp);
+  emitProviderAdjustments(
+    spec.providerAdjustments,
+    "build835: spec.providerAdjustments",
+    body,
+    seg,
+    esc,
+    comp
+  );
   const seCount = body.length + 2;
   const se = seg(["SE", String(seCount), esc(stControlNumber)]);
   const ge = seg(["GE", "1", esc(envelope.groupControlNumber)]);
@@ -2601,14 +2679,16 @@ function build835(spec) {
   return parseX12(raw);
 }
 function enforceStructuralSpec(spec) {
-  if (spec.traces.length === 0) {
+  const traces = requireCallerArray(spec.traces, "build835: spec.traces", refuseSpec);
+  if (traces.length === 0) {
     throw new Remit835BuildError(
       REMIT_835_BUILD_ERROR_CODES.X12_835_BUILD_INVALID_SPEC,
       "build835: at least one TRN trace is required (TR3 005010X221A1 Loop header)."
     );
   }
-  for (let i = 0; i < spec.claims.length; i += 1) {
-    const claim = spec.claims[i];
+  const claims = requireCallerArray(spec.claims, "build835: spec.claims", refuseSpec);
+  for (let i = 0; i < claims.length; i += 1) {
+    const claim = claims[i];
     if (claim === void 0) continue;
     if (claim.patientControlNumber === "") {
       throw new Remit835BuildError(
@@ -2619,7 +2699,7 @@ function enforceStructuralSpec(spec) {
   }
 }
 function enforceBalance(spec) {
-  const position = { segmentIndex: 0, transactionIndex: 0 };
+  const position = UNANCHORED_BUILD_POSITION;
   const claims = spec.claims.map(materializeClaim);
   for (const claim of claims) {
     const claimWarn = checkClaimBalance(claim, position);
@@ -2770,7 +2850,7 @@ function emitClaim(claim, body, seg, esc, comp) {
       comp([claim.facilityTypeCode ?? "", "", claim.claimFrequencyCode ?? ""])
     ])
   );
-  emitCasGroup(claim.adjustments ?? [], body, seg, esc);
+  emitCasGroup(claim.adjustments, "build835: claim.adjustments", body, seg, esc);
   if (claim.patient !== void 0) body.push(emitPerson(claim.patient, seg, esc));
   if (claim.subscriber !== void 0) body.push(emitPerson(claim.subscriber, seg, esc));
   if (claim.correctedPatient !== void 0) body.push(emitPerson(claim.correctedPatient, seg, esc));
@@ -2816,7 +2896,7 @@ function emitServiceLine(line, body, seg, esc, comp) {
     ])
   );
   emitServiceLineDtm(line, body, seg, esc);
-  emitCasGroup(line.adjustments ?? [], body, seg, esc);
+  emitCasGroup(line.adjustments, "build835: serviceLine.adjustments", body, seg, esc);
   for (const ref of line.references ?? []) body.push(emitRef(ref, seg, esc));
   for (const amt of line.amounts ?? []) {
     body.push(seg(["AMT", esc(amt.qualifier), esc(amt.amount.toString())]));
@@ -2834,7 +2914,8 @@ function emitServiceLineDtm(line, body, seg, esc) {
   if (start !== void 0) body.push(seg(["DTM", "150", esc(start)]));
   if (end !== void 0) body.push(seg(["DTM", "151", esc(end)]));
 }
-function emitCasGroup(adjustments, body, seg, esc) {
+function emitCasGroup(raw, at, body, seg, esc) {
+  const adjustments = requireCallerArray(raw, at, refuseSpec);
   let i = 0;
   while (i < adjustments.length) {
     const first = adjustments[i];
@@ -2892,7 +2973,8 @@ function emitProvider(provider, seg, esc) {
     esc(provider.idCode ?? "")
   ]);
 }
-function emitProviderAdjustments(adjustments, body, seg, esc, comp) {
+function emitProviderAdjustments(raw, at, body, seg, esc, comp) {
+  const adjustments = requireCallerArray(raw, at, refuseSpec);
   let i = 0;
   while (i < adjustments.length) {
     const first = adjustments[i];
@@ -2925,7 +3007,7 @@ function padControl(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new Remit835BuildError(
     REMIT_835_BUILD_ERROR_CODES.X12_835_BUILD_INVALID_SPEC,
-    `build835: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `build835: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY(yymmdd) {
@@ -4086,6 +4168,15 @@ var Claim837BuildError = class extends Error {
 };
 
 // src/transactions/claim/build-837.ts
+function refuseHierarchy(message) {
+  throw new Claim837BuildError(
+    CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_HIERARCHY,
+    message
+  );
+}
+function refuseSpec2(message) {
+  throw new Claim837BuildError(CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_SPEC, message);
+}
 var VERSION_BY_VARIANT = {
   P: "005010X222A2",
   I: "005010X223A3",
@@ -4196,26 +4287,45 @@ function buildClaim837(variant, spec) {
   return parseX12(raw);
 }
 function enforceStructuralSpec2(variant, spec) {
-  if (spec.billingProviders.length === 0) {
+  const billingProviders = requireCallerArray(
+    spec.billingProviders,
+    "build837: spec.billingProviders",
+    refuseHierarchy
+  );
+  if (billingProviders.length === 0) {
     throw new Claim837BuildError(
       CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_HIERARCHY,
       "build837: at least one billing provider (HL level 20) is required."
     );
   }
-  for (let b = 0; b < spec.billingProviders.length; b += 1) {
-    const billing = spec.billingProviders[b];
+  for (let b = 0; b < billingProviders.length; b += 1) {
+    const billing = billingProviders[b];
     if (billing === void 0) continue;
-    if (billing.subscribers.length === 0) {
+    const subscribers = requireCallerArray(
+      billing.subscribers,
+      `build837: spec.billingProviders[${String(b)}].subscribers`,
+      refuseHierarchy
+    );
+    if (subscribers.length === 0) {
       throw new Claim837BuildError(
         CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_HIERARCHY,
         `build837: billing provider at index ${String(b)} has no subscriber (HL level 22) child.`
       );
     }
-    for (let s = 0; s < billing.subscribers.length; s += 1) {
-      const subscriber = billing.subscribers[s];
+    for (let s = 0; s < subscribers.length; s += 1) {
+      const subscriber = subscribers[s];
       if (subscriber === void 0) continue;
-      const directClaims = subscriber.claims ?? [];
-      const patients = subscriber.patients ?? [];
+      const locator = `spec.billingProviders[${String(b)}].subscribers[${String(s)}]`;
+      const directClaims = requireCallerArray(
+        subscriber.claims,
+        `build837: ${locator}.claims`,
+        refuseHierarchy
+      );
+      const patients = requireCallerArray(
+        subscriber.patients,
+        `build837: ${locator}.patients`,
+        refuseHierarchy
+      );
       if (directClaims.length === 0 && patients.length === 0) {
         throw new Claim837BuildError(
           CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_HIERARCHY,
@@ -4235,14 +4345,19 @@ function enforceStructuralSpec2(variant, spec) {
       for (let p = 0; p < patients.length; p += 1) {
         const patient = patients[p];
         if (patient === void 0) continue;
-        if (patient.claims.length === 0) {
+        const patientClaims = requireCallerArray(
+          patient.claims,
+          `build837: ${locator}.patients[${String(p)}].claims`,
+          refuseHierarchy
+        );
+        if (patientClaims.length === 0) {
           throw new Claim837BuildError(
             CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_HIERARCHY,
             `build837: dependent patient at billing[${String(b)}].subscriber[${String(s)}].patient[${String(p)}] has no claim.`
           );
         }
-        for (let c = 0; c < patient.claims.length; c += 1) {
-          const claim = patient.claims[c];
+        for (let c = 0; c < patientClaims.length; c += 1) {
+          const claim = patientClaims[c];
           if (claim !== void 0) {
             enforceClaim(
               variant,
@@ -4262,19 +4377,24 @@ function enforceClaim(variant, claim, locator) {
       `build837: claim at ${locator} has an empty claimId (CLM-01 is required).`
     );
   }
-  if (claim.serviceLines.length === 0) {
+  const serviceLines = requireCallerArray(
+    claim.serviceLines,
+    `build837: claim at ${locator}: serviceLines`,
+    refuseSpec2
+  );
+  if (serviceLines.length === 0) {
     throw new Claim837BuildError(
       CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_SPEC,
       `build837: claim at ${locator} has no service line (a CLM requires at least one LX/SVx loop).`
     );
   }
-  for (let l = 0; l < claim.serviceLines.length; l += 1) {
-    const line = claim.serviceLines[l];
+  for (let l = 0; l < serviceLines.length; l += 1) {
+    const line = serviceLines[l];
     if (line === void 0) continue;
     if (line.variant !== variant) {
       throw new Claim837BuildError(
         CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_SPEC,
-        `build837${variant}: claim at ${locator} has a "${line.variant}" service line at index ${String(l)}; every line must be "${variant}".`
+        `build837${variant}: claim at ${locator} has a ${renderCallerValue(line.variant)} service line at index ${String(l)}; every line must be "${variant}".`
       );
     }
     const code = line.variant === "I" ? line.revenueCode : line.procedureCode;
@@ -4499,12 +4619,13 @@ function emitAdjudication(adj, body, ctx) {
       adj.paidUnits === void 0 ? "" : ctx.esc(adj.paidUnits.toString())
     ])
   );
-  emitCasGroup2(adj.adjustments ?? [], body, ctx);
+  emitCasGroup2(adj.adjustments, "build837: adjudication.adjustments", body, ctx);
   if (adj.dateAdjudicated !== void 0) {
     body.push(ctx.seg(["DTP", "573", "D8", ctx.esc(adj.dateAdjudicated)]));
   }
 }
-function emitCasGroup2(adjustments, body, ctx) {
+function emitCasGroup2(raw, at, body, ctx) {
+  const adjustments = requireCallerArray(raw, at, refuseSpec2);
   let i = 0;
   while (i < adjustments.length) {
     const first = adjustments[i];
@@ -4618,7 +4739,7 @@ function padControl2(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new Claim837BuildError(
     CLAIM_837_BUILD_ERROR_CODES.X12_837_BUILD_INVALID_SPEC,
-    `build837: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `build837: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY2(yymmdd) {
@@ -5222,6 +5343,12 @@ var Eligibility271BuildError = class extends Error {
 };
 
 // src/transactions/eligibility/build-271.ts
+function refuseHierarchy2(message) {
+  throw new Eligibility271BuildError(
+    ELIGIBILITY_271_BUILD_ERROR_CODES.X12_271_BUILD_INVALID_HIERARCHY,
+    message
+  );
+}
 var X279A1_VERSION_RELEASE = "005010X279A1";
 var X12_271_FUNCTIONAL_ID = "HB";
 var X12_AGENCY_CODE3 = "X";
@@ -5299,25 +5426,40 @@ function build271(spec) {
   return parseX12(raw);
 }
 function enforceStructuralSpec3(spec) {
-  if (spec.informationSources.length === 0) {
+  const sources = requireCallerArray(
+    spec.informationSources,
+    "build271: spec.informationSources",
+    refuseHierarchy2
+  );
+  if (sources.length === 0) {
     throw new Eligibility271BuildError(
       ELIGIBILITY_271_BUILD_ERROR_CODES.X12_271_BUILD_INVALID_HIERARCHY,
       "build271: at least one information source (HL level 20) is required."
     );
   }
-  for (let s = 0; s < spec.informationSources.length; s += 1) {
-    const source = spec.informationSources[s];
+  for (let s = 0; s < sources.length; s += 1) {
+    const source = sources[s];
     if (source === void 0) continue;
-    if (source.receivers.length === 0) {
+    const receivers = requireCallerArray(
+      source.receivers,
+      `build271: spec.informationSources[${String(s)}].receivers`,
+      refuseHierarchy2
+    );
+    if (receivers.length === 0) {
       throw new Eligibility271BuildError(
         ELIGIBILITY_271_BUILD_ERROR_CODES.X12_271_BUILD_INVALID_HIERARCHY,
         `build271: information source at index ${String(s)} has no receiver (HL level 21) child.`
       );
     }
-    for (let r = 0; r < source.receivers.length; r += 1) {
-      const receiver = source.receivers[r];
+    for (let r = 0; r < receivers.length; r += 1) {
+      const receiver = receivers[r];
       if (receiver === void 0) continue;
-      if (receiver.subscribers.length === 0) {
+      const subscribers = requireCallerArray(
+        receiver.subscribers,
+        `build271: spec.informationSources[${String(s)}].receivers[${String(r)}].subscribers`,
+        refuseHierarchy2
+      );
+      if (subscribers.length === 0) {
         throw new Eligibility271BuildError(
           ELIGIBILITY_271_BUILD_ERROR_CODES.X12_271_BUILD_INVALID_HIERARCHY,
           `build271: receiver at source[${String(s)}].receiver[${String(r)}] has no subscriber (HL level 22) child.`
@@ -5483,7 +5625,7 @@ function padControl3(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new Eligibility271BuildError(
     ELIGIBILITY_271_BUILD_ERROR_CODES.X12_271_BUILD_INVALID_SPEC,
-    `build271: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `build271: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY3(yymmdd) {
@@ -5893,6 +6035,18 @@ var ClaimStatus277BuildError = class extends Error {
 };
 
 // src/transactions/status/build-277.ts
+function refuseHierarchy3(message) {
+  throw new ClaimStatus277BuildError(
+    CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_HIERARCHY,
+    message
+  );
+}
+function refuseSpec3(message) {
+  throw new ClaimStatus277BuildError(
+    CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_SPEC,
+    message
+  );
+}
 var X12_277_FUNCTIONAL_ID = "HN";
 var X12_AGENCY_CODE4 = "X";
 var HL_LEVEL3 = {
@@ -5987,42 +6141,62 @@ function buildClaimStatus(version, spec) {
   return parseX12(raw);
 }
 function enforceStructuralSpec4(spec) {
-  if (spec.informationSources.length === 0) {
+  const sources = requireCallerArray(
+    spec.informationSources,
+    "build277: spec.informationSources",
+    refuseHierarchy3
+  );
+  if (sources.length === 0) {
     throw new ClaimStatus277BuildError(
       CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_HIERARCHY,
       "build277: at least one information source (HL level 20) is required."
     );
   }
-  for (let s = 0; s < spec.informationSources.length; s += 1) {
-    const source = spec.informationSources[s];
+  for (let s = 0; s < sources.length; s += 1) {
+    const source = sources[s];
     if (source === void 0) continue;
-    if (source.receivers.length === 0) {
+    const receivers = requireCallerArray(
+      source.receivers,
+      `build277: spec.informationSources[${String(s)}].receivers`,
+      refuseHierarchy3
+    );
+    if (receivers.length === 0) {
       throw new ClaimStatus277BuildError(
         CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_HIERARCHY,
         `build277: information source at index ${String(s)} has no receiver (HL level 21) child.`
       );
     }
-    for (let r = 0; r < source.receivers.length; r += 1) {
-      const receiver = source.receivers[r];
+    for (let r = 0; r < receivers.length; r += 1) {
+      const receiver = receivers[r];
       if (receiver === void 0) continue;
-      if (receiver.providers.length === 0) {
+      const providers = requireCallerArray(
+        receiver.providers,
+        `build277: spec.informationSources[${String(s)}].receivers[${String(r)}].providers`,
+        refuseHierarchy3
+      );
+      if (providers.length === 0) {
         throw new ClaimStatus277BuildError(
           CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_HIERARCHY,
           `build277: receiver at source[${String(s)}].receiver[${String(r)}] has no provider (HL level 19) child.`
         );
       }
-      for (let p = 0; p < receiver.providers.length; p += 1) {
-        const provider = receiver.providers[p];
+      for (let p = 0; p < providers.length; p += 1) {
+        const provider = providers[p];
         if (provider === void 0) continue;
         const locator = `source[${String(s)}].receiver[${String(r)}].provider[${String(p)}]`;
-        if (provider.subscribers.length === 0) {
+        const subscribers = requireCallerArray(
+          provider.subscribers,
+          `build277: ${locator}.subscribers`,
+          refuseHierarchy3
+        );
+        if (subscribers.length === 0) {
           throw new ClaimStatus277BuildError(
             CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_HIERARCHY,
             `build277: provider at ${locator} has no subscriber (HL level 22) child.`
           );
         }
-        for (let u = 0; u < provider.subscribers.length; u += 1) {
-          const subscriber = provider.subscribers[u];
+        for (let u = 0; u < subscribers.length; u += 1) {
+          const subscriber = subscribers[u];
           if (subscriber === void 0) continue;
           enforceSubscriber(subscriber, `${locator}.subscriber[${String(u)}]`);
         }
@@ -6031,8 +6205,16 @@ function enforceStructuralSpec4(spec) {
   }
 }
 function enforceSubscriber(subscriber, locator) {
-  const claims = subscriber.claims ?? [];
-  const dependents = subscriber.dependents ?? [];
+  const claims = requireCallerArray(
+    subscriber.claims,
+    `build277: subscriber at ${locator}: claims`,
+    refuseHierarchy3
+  );
+  const dependents = requireCallerArray(
+    subscriber.dependents,
+    `build277: subscriber at ${locator}: dependents`,
+    refuseHierarchy3
+  );
   if (claims.length === 0 && dependents.length === 0) {
     throw new ClaimStatus277BuildError(
       CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_HIERARCHY,
@@ -6047,21 +6229,34 @@ function enforceSubscriber(subscriber, locator) {
     const dependent = dependents[d];
     if (dependent === void 0) continue;
     const depLocator = `${locator}.dependent[${String(d)}]`;
-    if (dependent.claims.length === 0) {
+    const depClaims = requireCallerArray(
+      dependent.claims,
+      `build277: dependent at ${depLocator}: claims`,
+      refuseHierarchy3
+    );
+    if (depClaims.length === 0) {
       throw new ClaimStatus277BuildError(
         CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_HIERARCHY,
         `build277: dependent at ${depLocator} has no claim.`
       );
     }
-    for (let c = 0; c < dependent.claims.length; c += 1) {
-      const claim = dependent.claims[c];
+    for (let c = 0; c < depClaims.length; c += 1) {
+      const claim = depClaims[c];
       if (claim !== void 0) enforceClaim2(claim, `${depLocator}.claim[${String(c)}]`, c === 0);
     }
   }
 }
 function enforceClaim2(claim, locator, isFirst) {
-  const statuses = claim.statuses ?? [];
-  const serviceLines = claim.serviceLines ?? [];
+  const statuses = requireCallerArray(
+    claim.statuses,
+    `build277: claim at ${locator}: statuses`,
+    refuseSpec3
+  );
+  const serviceLines = requireCallerArray(
+    claim.serviceLines,
+    `build277: claim at ${locator}: serviceLines`,
+    refuseSpec3
+  );
   if (claim.trace === void 0 && statuses.length === 0 && serviceLines.length === 0) {
     throw new ClaimStatus277BuildError(
       CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_SPEC,
@@ -6080,7 +6275,11 @@ function enforceClaim2(claim, locator, isFirst) {
   for (let l = 0; l < serviceLines.length; l += 1) {
     const line = serviceLines[l];
     if (line === void 0) continue;
-    const lineStatuses = line.statuses ?? [];
+    const lineStatuses = requireCallerArray(
+      line.statuses,
+      `build277: claim at ${locator}.line[${String(l)}]: statuses`,
+      refuseSpec3
+    );
     for (let i = 0; i < lineStatuses.length; i += 1) {
       enforceStatus(lineStatuses[i], `${locator}.line[${String(l)}].status[${String(i)}]`);
     }
@@ -6257,7 +6456,7 @@ function padControl4(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new ClaimStatus277BuildError(
     CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_SPEC,
-    `build277: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `build277: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY4(yymmdd) {
@@ -6630,6 +6829,9 @@ var Premium820BuildError = class extends Error {
 };
 
 // src/transactions/premium/build-820.ts
+function refuseSpec4(message) {
+  throw new Premium820BuildError(PREMIUM_820_BUILD_ERROR_CODES.X12_820_BUILD_INVALID_SPEC, message);
+}
 var X218_VERSION_RELEASE = "005010X218";
 var X12_820_FUNCTIONAL_ID = "RA";
 var X12_AGENCY_CODE5 = "X";
@@ -6773,20 +6975,26 @@ function build820(spec) {
   return parseX12(raw);
 }
 function enforceStructuralSpec5(spec) {
-  if (spec.traces.length === 0) {
+  const traces = requireCallerArray(spec.traces, "build820: spec.traces", refuseSpec4);
+  if (traces.length === 0) {
     throw new Premium820BuildError(
       PREMIUM_820_BUILD_ERROR_CODES.X12_820_BUILD_INVALID_SPEC,
       "build820: at least one TRN trace is required (TR3 005010X218 header)."
     );
   }
-  if (spec.remittances.length === 0) {
+  const remittances = requireCallerArray(
+    spec.remittances,
+    "build820: spec.remittances",
+    refuseSpec4
+  );
+  if (remittances.length === 0) {
     throw new Premium820BuildError(
       PREMIUM_820_BUILD_ERROR_CODES.X12_820_BUILD_INVALID_SPEC,
       "build820: at least one remittance (Loop 2000) is required."
     );
   }
-  for (let r = 0; r < spec.remittances.length; r += 1) {
-    const remittance = spec.remittances[r];
+  for (let r = 0; r < remittances.length; r += 1) {
+    const remittance = remittances[r];
     if (remittance === void 0) continue;
     if (remittance.entity === void 0 && remittance.individual === void 0) {
       throw new Premium820BuildError(
@@ -6794,14 +7002,19 @@ function enforceStructuralSpec5(spec) {
         `build820: remittance at index ${String(r)} has neither an entity (ENT) nor an individual (NM1) to open its loop.`
       );
     }
-    if (remittance.openItems.length === 0) {
+    const openItems = requireCallerArray(
+      remittance.openItems,
+      `build820: spec.remittances[${String(r)}].openItems`,
+      refuseSpec4
+    );
+    if (openItems.length === 0) {
       throw new Premium820BuildError(
         PREMIUM_820_BUILD_ERROR_CODES.X12_820_BUILD_INVALID_SPEC,
         `build820: remittance at index ${String(r)} has no RMR open item.`
       );
     }
-    for (let o = 0; o < remittance.openItems.length; o += 1) {
-      const item = remittance.openItems[o];
+    for (let o = 0; o < openItems.length; o += 1) {
+      const item = openItems[o];
       if (item === void 0) continue;
       if (item.qualifier === "" && item.referenceId === "") {
         throw new Premium820BuildError(
@@ -6914,7 +7127,7 @@ function padControl5(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new Premium820BuildError(
     PREMIUM_820_BUILD_ERROR_CODES.X12_820_BUILD_INVALID_SPEC,
-    `build820: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `build820: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY5(yymmdd) {
@@ -7312,6 +7525,12 @@ var Enrollment834BuildError = class extends Error {
 };
 
 // src/transactions/enrollment/build-834.ts
+function refuseSpec5(message) {
+  throw new Enrollment834BuildError(
+    ENROLLMENT_834_BUILD_ERROR_CODES.X12_834_BUILD_INVALID_SPEC,
+    message
+  );
+}
 var X220A1_VERSION_RELEASE = "005010X220A1";
 var X12_834_FUNCTIONAL_ID = "BE";
 var X12_AGENCY_CODE6 = "X";
@@ -7411,14 +7630,15 @@ function build834(spec) {
   return parseX12(raw);
 }
 function enforceStructuralSpec6(spec) {
-  if (spec.members.length === 0) {
+  const members = requireCallerArray(spec.members, "build834: spec.members", refuseSpec5);
+  if (members.length === 0) {
     throw new Enrollment834BuildError(
       ENROLLMENT_834_BUILD_ERROR_CODES.X12_834_BUILD_INVALID_SPEC,
       "build834: at least one member loop (INS) is required."
     );
   }
-  for (let m = 0; m < spec.members.length; m += 1) {
-    const member = spec.members[m];
+  for (let m = 0; m < members.length; m += 1) {
+    const member = members[m];
     if (member === void 0) continue;
     if (member.maintenanceTypeCode === "") {
       throw new Enrollment834BuildError(
@@ -7429,17 +7649,22 @@ function enforceStructuralSpec6(spec) {
     if (lookupMaintenanceType(member.maintenanceTypeCode) === void 0) {
       throw new Enrollment834BuildError(
         ENROLLMENT_834_BUILD_ERROR_CODES.X12_834_BUILD_UNKNOWN_MAINTENANCE_TYPE,
-        `build834: member at index ${String(m)} has an unknown INS-03 maintenance type code "${member.maintenanceTypeCode}" (outside X12 Code Source 875).`
+        `build834: member at index ${String(m)} has an unknown INS-03 maintenance type code ${renderCallerValue(member.maintenanceTypeCode)} (outside X12 Code Source 875).`
       );
     }
-    for (let c = 0; c < (member.healthCoverages ?? []).length; c += 1) {
-      const coverage = member.healthCoverages?.[c];
+    const coverages = requireCallerArray(
+      member.healthCoverages,
+      `build834: spec.members[${String(m)}].healthCoverages`,
+      refuseSpec5
+    );
+    for (let c = 0; c < coverages.length; c += 1) {
+      const coverage = coverages[c];
       if (coverage === void 0) continue;
       const hd01 = coverage.maintenanceTypeCode;
       if (hd01 !== void 0 && hd01 !== "" && lookupMaintenanceType(hd01) === void 0) {
         throw new Enrollment834BuildError(
           ENROLLMENT_834_BUILD_ERROR_CODES.X12_834_BUILD_UNKNOWN_MAINTENANCE_TYPE,
-          `build834: coverage at member[${String(m)}].healthCoverages[${String(c)}] has an unknown HD-01 maintenance type code "${hd01}" (outside X12 Code Source 875).`
+          `build834: coverage at member[${String(m)}].healthCoverages[${String(c)}] has an unknown HD-01 maintenance type code ${renderCallerValue(hd01)} (outside X12 Code Source 875).`
         );
       }
     }
@@ -7588,7 +7813,7 @@ function padControl6(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new Enrollment834BuildError(
     ENROLLMENT_834_BUILD_ERROR_CODES.X12_834_BUILD_INVALID_SPEC,
-    `build834: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `build834: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY6(yymmdd) {
@@ -7951,6 +8176,12 @@ var ServicesReview278BuildError = class extends Error {
 };
 
 // src/transactions/auth/build-278.ts
+function refuseHierarchy4(message) {
+  throw new ServicesReview278BuildError(
+    AUTH_278_BUILD_ERROR_CODES.X12_278_BUILD_INVALID_HIERARCHY,
+    message
+  );
+}
 var X12_278_FUNCTIONAL_ID = "HI";
 var X12_AGENCY_CODE7 = "X";
 var HL_LEVEL4 = {
@@ -8062,7 +8293,11 @@ function buildServicesReview(version, direction, spec) {
 }
 function enforceStructuralSpec7(spec, direction) {
   const subscriber = spec.subscriber;
-  const subscriberReviews = subscriber.reviews ?? [];
+  const subscriberReviews = requireCallerArray(
+    subscriber.reviews,
+    "build278: spec.subscriber.reviews",
+    refuseHierarchy4
+  );
   if (subscriberReviews.length === 0 && subscriber.dependent === void 0) {
     throw new ServicesReview278BuildError(
       AUTH_278_BUILD_ERROR_CODES.X12_278_BUILD_INVALID_HIERARCHY,
@@ -8075,14 +8310,19 @@ function enforceStructuralSpec7(spec, direction) {
   }
   const dependent = subscriber.dependent;
   if (dependent !== void 0) {
-    if (dependent.reviews.length === 0) {
+    const dependentReviews = requireCallerArray(
+      dependent.reviews,
+      "build278: spec.subscriber.dependent.reviews",
+      refuseHierarchy4
+    );
+    if (dependentReviews.length === 0) {
       throw new ServicesReview278BuildError(
         AUTH_278_BUILD_ERROR_CODES.X12_278_BUILD_INVALID_HIERARCHY,
         "build278: dependent has no review (HL level EV/SS) child."
       );
     }
-    for (let r = 0; r < dependent.reviews.length; r += 1) {
-      const review = dependent.reviews[r];
+    for (let r = 0; r < dependentReviews.length; r += 1) {
+      const review = dependentReviews[r];
       if (review !== void 0) enforceReview(review, `dependent.review[${String(r)}]`, direction);
     }
   }
@@ -8108,7 +8348,11 @@ function enforceReview(review, locator, direction) {
       );
     }
   }
-  const nested = review.reviews ?? [];
+  const nested = requireCallerArray(
+    review.reviews,
+    `build278: review at ${locator}: reviews`,
+    refuseHierarchy4
+  );
   for (let r = 0; r < nested.length; r += 1) {
     const child = nested[r];
     if (child !== void 0) enforceReview(child, `${locator}.review[${String(r)}]`, direction);
@@ -8244,7 +8488,7 @@ function padControl7(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new ServicesReview278BuildError(
     AUTH_278_BUILD_ERROR_CODES.X12_278_BUILD_INVALID_SPEC,
-    `build278: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `build278: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY7(yymmdd) {
@@ -8846,7 +9090,7 @@ function enforceAcceptIsClean(group) {
   if (functionalIsAccept && functionalHasErrorCodes) {
     throw new AckBuildError(
       ACK_BUILD_ERROR_CODES.X12_ACK_ACCEPT_WITH_ERRORS,
-      `build999: AK9-01 was 'A' (Accept) but AK9-05..AK9-09 carried ${String(
+      `build999: AK9-01 was 'A' (Accept) but AK9-05..AK9-09 carried ${renderCallerValue(
         (group.syntaxErrorCodes ?? []).length
       )} syntax error code(s). Use 'E' (Accept, with errors noted) or a reject disposition instead.`
     );
@@ -8857,13 +9101,13 @@ function enforceAcceptIsClean(group) {
     if (responseIsAccept && responseHasErrors) {
       throw new AckBuildError(
         ACK_BUILD_ERROR_CODES.X12_ACK_ACCEPT_WITH_ERRORS,
-        `build999: AK2 (ST-02 ${response.transactionSetControlNumber}) IK5-01 was 'A' (Accept) but the response carried error payload. Use 'E' (Accept, with errors noted) or a reject disposition instead.`
+        `build999: AK2 (ST-02 ${renderCallerValue(response.transactionSetControlNumber)}) IK5-01 was 'A' (Accept) but the response carried error payload. Use 'E' (Accept, with errors noted) or a reject disposition instead.`
       );
     }
     if (functionalIsAccept && (!responseIsAccept || responseHasErrors)) {
       throw new AckBuildError(
         ACK_BUILD_ERROR_CODES.X12_ACK_ACCEPT_WITH_ERRORS,
-        `build999: AK9-01 was 'A' (Accept) but transaction response (ST-02 ${response.transactionSetControlNumber}) reported a non-accept disposition or carried errors. Lift the functional disposition to 'P' (Partial), 'E' (Accept, errors noted), or a reject.`
+        `build999: AK9-01 was 'A' (Accept) but transaction response (ST-02 ${renderCallerValue(response.transactionSetControlNumber)}) reported a non-accept disposition or carried errors. Lift the functional disposition to 'P' (Partial), 'E' (Accept, errors noted), or a reject.`
       );
     }
   }
@@ -8875,25 +9119,25 @@ function enforceCountInvariants(group) {
   if (declared < 0 || received < 0 || accepted < 0) {
     throw new AckBuildError(
       ACK_BUILD_ERROR_CODES.X12_ACK_COUNT_MISMATCH,
-      `build999: AK9 counts must be non-negative (declared=${String(declared)}, received=${String(received)}, accepted=${String(accepted)}).`
+      `build999: AK9 counts must be non-negative (declared=${renderCallerValue(declared)}, received=${renderCallerValue(received)}, accepted=${renderCallerValue(accepted)}).`
     );
   }
   if (accepted > received) {
     throw new AckBuildError(
       ACK_BUILD_ERROR_CODES.X12_ACK_COUNT_MISMATCH,
-      `build999: AK9-04 accepted (${String(accepted)}) cannot exceed AK9-03 received (${String(received)}).`
+      `build999: AK9-04 accepted (${renderCallerValue(accepted)}) cannot exceed AK9-03 received (${renderCallerValue(received)}).`
     );
   }
   if (received > declared) {
     throw new AckBuildError(
       ACK_BUILD_ERROR_CODES.X12_ACK_COUNT_MISMATCH,
-      `build999: AK9-03 received (${String(received)}) cannot exceed AK9-02 declared (${String(declared)}).`
+      `build999: AK9-03 received (${renderCallerValue(received)}) cannot exceed AK9-02 declared (${renderCallerValue(declared)}).`
     );
   }
   if (group.transactionResponses.length !== received) {
     throw new AckBuildError(
       ACK_BUILD_ERROR_CODES.X12_ACK_COUNT_MISMATCH,
-      `build999: AK9-03 received (${String(received)}) must equal the number of supplied transaction responses (${String(group.transactionResponses.length)}).`
+      `build999: AK9-03 received (${renderCallerValue(received)}) must equal the number of supplied transaction responses (${renderCallerValue(group.transactionResponses.length)}).`
     );
   }
 }
@@ -8962,7 +9206,7 @@ function buildIk5(response, esc, elementSeparator, segmentTerminator) {
   if (codes.length > 5) {
     throw new AckBuildError(
       ACK_BUILD_ERROR_CODES.X12_ACK_COUNT_MISMATCH,
-      `build999: IK5 accepts up to 5 syntax error codes (IK5-02..IK5-06); ${String(codes.length)} supplied.`
+      `build999: IK5 accepts up to 5 syntax error codes (IK5-02..IK5-06); ${renderCallerValue(codes.length)} supplied.`
     );
   }
   for (const code of codes) parts.push(esc(code));
@@ -8980,7 +9224,7 @@ function buildAk9(group, esc, elementSeparator, segmentTerminator) {
   if (codes.length > 5) {
     throw new AckBuildError(
       ACK_BUILD_ERROR_CODES.X12_ACK_COUNT_MISMATCH,
-      `build999: AK9 accepts up to 5 syntax error codes (AK9-05..AK9-09); ${String(codes.length)} supplied.`
+      `build999: AK9 accepts up to 5 syntax error codes (AK9-05..AK9-09); ${renderCallerValue(codes.length)} supplied.`
     );
   }
   for (const code of codes) parts.push(esc(code));
@@ -8999,7 +9243,7 @@ function padControl8(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new AckBuildError(
     ACK_BUILD_ERROR_CODES.X12_ACK_INVALID_SPEC,
-    `build999: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `build999: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY8(yymmdd) {
@@ -9029,7 +9273,7 @@ function enforceAcceptIsClean2(spec) {
   if (spec.ackCode === TA1_ACK_CODES.A && spec.noteCode !== "000") {
     throw new AckBuildError(
       ACK_BUILD_ERROR_CODES.X12_TA1_ACCEPT_WITH_NOTE,
-      `buildTA1: TA1-04 was "A" (Accept) but TA1-05 carried note "${spec.noteCode}". An accept must cite "000" (no error). Use ackCode "E" (accept, errors noted) when the inbound had defects you elected to ignore.`
+      `buildTA1: TA1-04 was "A" (Accept) but TA1-05 carried note ${renderCallerValue(spec.noteCode)}. An accept must cite "000" (no error). Use ackCode "E" (accept, errors noted) when the inbound had defects you elected to ignore.`
     );
   }
 }
@@ -9320,7 +9564,11 @@ function buildTransaction(tx, esc, elementSeparator, segmentTerminator) {
     if (segment.length === 0 || (segment[0] ?? "") === "") {
       throw new X12BuildError(
         X12_BUILD_ERROR_CODES.X12_BUILD_INVALID_SPEC,
-        `buildInterchange: a segment spec in transaction "${esc(tx.transactionSetIdCode)}" has no segment id.`
+        // Rendered from the RAW id, not the `?`-escaped one. `esc` can double
+        // the length, so escaping first made the reported "(N characters)" the
+        // escaped length rather than the caller's: a 100-character all-`?` id
+        // reported 200. The escape exists for the wire, and this is a message.
+        `buildInterchange: a segment spec in transaction ${renderCallerValue(tx.transactionSetIdCode)} has no segment id.`
       );
     }
     bodySegments += joinSeg2(segment.map(esc), elementSeparator, segmentTerminator);
@@ -9346,7 +9594,7 @@ function padControl9(value, width) {
   if (value.length < width) return "0".repeat(width - value.length) + value;
   throw new X12BuildError(
     X12_BUILD_ERROR_CODES.X12_BUILD_INVALID_SPEC,
-    `buildInterchange: control number "${value}" exceeds the ${String(width)}-char spec limit.`
+    `buildInterchange: control number ${renderCallerValue(value)} exceeds the ${String(width)}-char spec limit.`
   );
 }
 function expandYY9(yymmdd) {
@@ -9398,17 +9646,17 @@ function levenshtein(a, b) {
 function validateProfileName(opts) {
   if (opts === null || opts === void 0) {
     throw new X12ProfileError(
-      `defineProfile: options is required and must be an object. Received: ${String(opts)}.`
+      `defineProfile: options is required and must be an object. Received: ${renderCallerJson(opts)}.`
     );
   }
   if (typeof opts.name !== "string") {
     throw new X12ProfileError(
-      `defineProfile: 'name' is required and must be a non-empty string. Received: ${JSON.stringify(opts.name)}.`
+      `defineProfile: 'name' is required and must be a non-empty string. Received: ${renderCallerJson(opts.name)}.`
     );
   }
   if (opts.name.trim().length === 0) {
     throw new X12ProfileError(
-      `defineProfile: 'name' is required and must be a non-empty string. Received: ${JSON.stringify(opts.name)}.`,
+      `defineProfile: 'name' is required and must be a non-empty string. Received: ${renderCallerJson(opts.name)}.`,
       opts.name
     );
   }
@@ -9424,7 +9672,7 @@ function validateOptionKeys(opts) {
       }
     }
     throw new X12ProfileError(
-      `Profile '${opts.name}' has unknown option key '${key}'. ` + (hint !== void 0 ? `Did you mean '${hint}'? ` : "") + `Known keys: ${KNOWN_OPTION_KEYS.join(", ")}.`,
+      `Profile ${renderCallerValue(opts.name)} has unknown option key ${renderCallerValue(key)}. ` + (hint !== void 0 ? `Did you mean '${hint}'? ` : "") + `Known keys: ${KNOWN_OPTION_KEYS.join(", ")}.`,
       opts.name
     );
   }
@@ -9433,44 +9681,46 @@ function validateQuirks(quirks, profileName) {
   const seenIds = /* @__PURE__ */ new Set();
   for (let i = 0; i < quirks.length; i++) {
     const q = quirks[i];
-    const at = `quirks[${String(i)}]`;
     if (q === void 0 || q === null || typeof q !== "object") {
-      throw new X12ProfileError(`Profile '${profileName}' ${at} must be an object.`, profileName);
+      throw new X12ProfileError(
+        `Profile ${renderCallerValue(profileName)} quirks[${String(i)}] must be an object.`,
+        profileName
+      );
     }
     if (typeof q.id !== "string" || !QUIRK_ID_RE.test(q.id)) {
       throw new X12ProfileError(
-        `Profile '${profileName}' ${at}.id must be a kebab-case string (e.g. "payer-loop-ref-2u"). Received: ${JSON.stringify(q.id)}.`,
+        `Profile ${renderCallerValue(profileName)} quirks[${String(i)}].id must be a kebab-case string (e.g. "payer-loop-ref-2u"). Received: ${renderCallerJson(q.id)}.`,
         profileName
       );
     }
     if (seenIds.has(q.id)) {
       throw new X12ProfileError(
-        `Profile '${profileName}' declares duplicate quirk id '${q.id}'. Each quirk id must be unique within a profile.`,
+        `Profile ${renderCallerValue(profileName)} declares duplicate quirk id ${renderCallerValue(q.id)}. Each quirk id must be unique within a profile.`,
         profileName
       );
     }
     seenIds.add(q.id);
     if (typeof q.effect !== "string" || !KNOWN_EFFECTS.includes(q.effect)) {
       throw new X12ProfileError(
-        `Profile '${profileName}' quirk '${q.id}' has invalid effect ${JSON.stringify(q.effect)} - must be one of ${KNOWN_EFFECTS.join(" / ")}.`,
+        `Profile ${renderCallerValue(profileName)} quirk ${renderCallerValue(q.id)} has invalid effect ${renderCallerJson(q.effect)} - must be one of ${KNOWN_EFFECTS.join(" / ")}.`,
         profileName
       );
     }
     if (typeof q.summary !== "string" || q.summary.trim().length === 0) {
       throw new X12ProfileError(
-        `Profile '${profileName}' quirk '${q.id}' must have a non-empty summary.`,
+        `Profile ${renderCallerValue(profileName)} quirk ${renderCallerValue(q.id)} must have a non-empty summary.`,
         profileName
       );
     }
     if (typeof q.fixture !== "string" || !FIXTURE_PATH_RE.test(q.fixture)) {
       throw new X12ProfileError(
-        `Profile '${profileName}' quirk '${q.id}' must cite a 'fixture' - a relative path under test/fixtures/ (e.g. "remit/835-availity-quirk.edi") demonstrating the deviation. No invented quirks. Received: ${JSON.stringify(q.fixture)}.`,
+        `Profile ${renderCallerValue(profileName)} quirk ${renderCallerValue(q.id)} must cite a 'fixture' - a relative path under test/fixtures/ (e.g. "remit/835-availity-quirk.edi") demonstrating the deviation. No invented quirks. Received: ${renderCallerJson(q.fixture)}.`,
         profileName
       );
     }
     if (typeof q.sourceCategory !== "string" || q.sourceCategory.trim().length === 0) {
       throw new X12ProfileError(
-        `Profile '${profileName}' quirk '${q.id}' must have a non-empty sourceCategory (where the deviation was observed).`,
+        `Profile ${renderCallerValue(profileName)} quirk ${renderCallerValue(q.id)} must have a non-empty sourceCategory (where the deviation was observed).`,
         profileName
       );
     }
@@ -9478,7 +9728,7 @@ function validateQuirks(quirks, profileName) {
       for (const code of q.expectedWarnings) {
         if (!WARNING_CODE_SET.has(code)) {
           throw new X12ProfileError(
-            `Profile '${profileName}' quirk '${q.id}' lists unknown expected warning ${JSON.stringify(code)} - must be a member of WARNING_CODES.`,
+            `Profile ${renderCallerValue(profileName)} quirk ${renderCallerValue(q.id)} lists unknown expected warning ${renderCallerJson(code)} - must be a member of WARNING_CODES.`,
             profileName
           );
         }
@@ -9640,8 +9890,8 @@ var profiles = Object.freeze({
 });
 
 // src/index.ts
-var VERSION = "0.0.4";
+var VERSION = "0.0.6";
 
-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, 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, 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, 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, pre005010, profiles, remitBalanceMismatch, resolveHiQualifier, segmentCountMismatch, serializeX12, setDefaultProfile, trailingGarbage, transactionCountMismatch, unescapeRelease, unexpectedSegment, unknown837Variant, unknownCarc, unknownClaimStatus, unknownClaimStatusCategory, unknownHiQualifier, unknownMaintenanceType, unknownRarc };
+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, 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, 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, pre005010, profiles, remitBalanceMismatch, renderCallerValue, resolveHiQualifier, segmentCountMismatch, serializeX12, setDefaultProfile, trailingGarbage, transactionCountMismatch, unescapeRelease, unexpectedSegment, unknown837Variant, unknownCarc, unknownClaimStatus, unknownClaimStatusCategory, unknownHiQualifier, unknownMaintenanceType, unknownRarc };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map