@cosyte/x12 0.0.7 → 0.0.9

package/dist/index.d.cts

@@ -2002,12 +2002,37 @@ declare function unescapeRelease(input: string, delimiters: Delimiters, emit: (w
  * delimiters (or the release character itself) is preceded by `?`; other
  * bytes pass through verbatim. The companion to {@link unescapeRelease}.
  *
+ * **Throws `TypeError` on a non-string, and the previous behaviour was the
+ * defect.** This function is declared over `string`, but a JavaScript or
+ * JSON-driven caller is not held to that. Reading `value.length` gave three
+ * different wrong answers depending on what arrived: a `number`, a `boolean`
+ * or a plain object has no `.length`, so `undefined === 0` was false, `i <
+ * undefined` was false, and the function **returned the empty accumulator** -
+ * the value vanished with no error and no warning; `null` and `undefined` threw
+ * on the property read; an array or an array-like threw on `charAt`. The silent
+ * one was by far the worst: `build835` emitted `CLP**1*500.00*…` with
+ * `warnings.length === 0`, dropping the CLP-01 reassociation key TR3
+ * 005010X221A1 requires. All three now terminate the same way.
+ *
+ * `TypeError` and not a code-tagged library error is deliberate, and it is not
+ * the untyped-refusal defect this package has fixed elsewhere. This is a pure
+ * text utility with no spec, no element and no caller context to name, so
+ * `TypeError` is the accurate answer for a wrong-typed argument. **Nothing
+ * inside this library can reach it**: all nine builders route every element
+ * through `src/builder/caller-string.ts`, which refuses first with the calling
+ * builder's own typed, code-tagged error. This throw is the backstop for a
+ * consumer calling the export directly, where the alternative was silent data
+ * loss.
+ *
+ * @throws TypeError if `value` is not a string
+ *
  * @example
  * ```ts
  * import { escapeRelease } from "@cosyte/x12";
  * const d = { element: "*", repetition: "^", component: ":", segment: "~" };
  * escapeRelease("ab~cd*ef:gh", d); // "ab?~cd?*ef?:gh"
  * escapeRelease("a?b", d);          // "a??b"
+ * escapeRelease(1 as unknown as string, d); // TypeError (was "")
  * ```
  */
 declare function escapeRelease(value: string, delimiters: Delimiters): string;

package/dist/index.d.ts

@@ -2002,12 +2002,37 @@ declare function unescapeRelease(input: string, delimiters: Delimiters, emit: (w
  * delimiters (or the release character itself) is preceded by `?`; other
  * bytes pass through verbatim. The companion to {@link unescapeRelease}.
  *
+ * **Throws `TypeError` on a non-string, and the previous behaviour was the
+ * defect.** This function is declared over `string`, but a JavaScript or
+ * JSON-driven caller is not held to that. Reading `value.length` gave three
+ * different wrong answers depending on what arrived: a `number`, a `boolean`
+ * or a plain object has no `.length`, so `undefined === 0` was false, `i <
+ * undefined` was false, and the function **returned the empty accumulator** -
+ * the value vanished with no error and no warning; `null` and `undefined` threw
+ * on the property read; an array or an array-like threw on `charAt`. The silent
+ * one was by far the worst: `build835` emitted `CLP**1*500.00*…` with
+ * `warnings.length === 0`, dropping the CLP-01 reassociation key TR3
+ * 005010X221A1 requires. All three now terminate the same way.
+ *
+ * `TypeError` and not a code-tagged library error is deliberate, and it is not
+ * the untyped-refusal defect this package has fixed elsewhere. This is a pure
+ * text utility with no spec, no element and no caller context to name, so
+ * `TypeError` is the accurate answer for a wrong-typed argument. **Nothing
+ * inside this library can reach it**: all nine builders route every element
+ * through `src/builder/caller-string.ts`, which refuses first with the calling
+ * builder's own typed, code-tagged error. This throw is the backstop for a
+ * consumer calling the export directly, where the alternative was silent data
+ * loss.
+ *
+ * @throws TypeError if `value` is not a string
+ *
  * @example
  * ```ts
  * import { escapeRelease } from "@cosyte/x12";
  * const d = { element: "*", repetition: "^", component: ":", segment: "~" };
  * escapeRelease("ab~cd*ef:gh", d); // "ab?~cd?*ef?:gh"
  * escapeRelease("a?b", d);          // "a??b"
+ * escapeRelease(1 as unknown as string, d); // TypeError (was "")
  * ```
  */
 declare function escapeRelease(value: string, delimiters: Delimiters): string;

package/dist/index.mjs

@@ -424,6 +424,9 @@ function unescapeRelease(input, delimiters, emit, position) {
   return out;
 }
 function escapeRelease(value, delimiters) {
+  if (typeof value !== "string") {
+    throw new TypeError(`escapeRelease: value must be a string, received ${typeof value}.`);
+  }
   if (value.length === 0) return value;
   let out = "";
   for (let i = 0; i < value.length; i++) {
@@ -2506,6 +2509,25 @@ function isRealArray(value) {
   return Array.isArray(value);
 }
 
+// src/builder/caller-string.ts
+function describeCallerValue(value) {
+  if (value === null) return "null";
+  if (value === void 0) return "undefined";
+  const type = typeof value;
+  if (type === "object") return Array.isArray(value) ? "an array" : "an object";
+  if (type === "function") return "a function";
+  return `a ${type} (${renderCallerValue(value)})`;
+}
+function requireCallerString(value, at, refuse) {
+  if (typeof value === "string") return value;
+  refuse(
+    `${at}: every element value must be a string, but received ${describeCallerValue(value)}. Values are never coerced - a JavaScript number cannot carry a leading-zero identifier, so converting here could emit a different value than the caller sent. Convert at the call site.`
+  );
+}
+function makeCallerEscaper(delimiters, at, refuse) {
+  return (value) => escapeRelease(requireCallerString(value, at, refuse), delimiters);
+}
+
 // src/transactions/remit/build-835.ts
 function refuseSpec(message) {
   throw new Remit835BuildError(REMIT_835_BUILD_ERROR_CODES.X12_835_BUILD_INVALID_SPEC, message);
@@ -2531,7 +2553,7 @@ function build835(spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "build835", refuseSpec);
   const seg = (parts) => {
     let end = parts.length;
     while (end > 1 && parts[end - 1] === "") end -= 1;
@@ -4208,7 +4230,7 @@ function buildClaim837(variant, spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "build837", refuseSpec2);
   const seg = (parts) => {
     let end = parts.length;
     while (end > 1 && parts[end - 1] === "") end -= 1;
@@ -5349,6 +5371,12 @@ function refuseHierarchy2(message) {
     message
   );
 }
+function refuseSpec3(message) {
+  throw new Eligibility271BuildError(
+    ELIGIBILITY_271_BUILD_ERROR_CODES.X12_271_BUILD_INVALID_SPEC,
+    message
+  );
+}
 var X279A1_VERSION_RELEASE = "005010X279A1";
 var X12_271_FUNCTIONAL_ID = "HB";
 var X12_AGENCY_CODE3 = "X";
@@ -5366,7 +5394,7 @@ function build271(spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "build271", refuseSpec3);
   const seg = (parts) => {
     let end = parts.length;
     while (end > 1 && parts[end - 1] === "") end -= 1;
@@ -6041,7 +6069,7 @@ function refuseHierarchy3(message) {
     message
   );
 }
-function refuseSpec3(message) {
+function refuseSpec4(message) {
   throw new ClaimStatus277BuildError(
     CLAIM_STATUS_277_BUILD_ERROR_CODES.X12_277_BUILD_INVALID_SPEC,
     message
@@ -6075,7 +6103,7 @@ function buildClaimStatus(version, spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "build277", refuseSpec4);
   const seg = (parts) => {
     let end = parts.length;
     while (end > 1 && parts[end - 1] === "") end -= 1;
@@ -6250,12 +6278,12 @@ function enforceClaim2(claim, locator, isFirst) {
   const statuses = requireCallerArray(
     claim.statuses,
     `build277: claim at ${locator}: statuses`,
-    refuseSpec3
+    refuseSpec4
   );
   const serviceLines = requireCallerArray(
     claim.serviceLines,
     `build277: claim at ${locator}: serviceLines`,
-    refuseSpec3
+    refuseSpec4
   );
   if (claim.trace === void 0 && statuses.length === 0 && serviceLines.length === 0) {
     throw new ClaimStatus277BuildError(
@@ -6278,7 +6306,7 @@ function enforceClaim2(claim, locator, isFirst) {
     const lineStatuses = requireCallerArray(
       line.statuses,
       `build277: claim at ${locator}.line[${String(l)}]: statuses`,
-      refuseSpec3
+      refuseSpec4
     );
     for (let i = 0; i < lineStatuses.length; i += 1) {
       enforceStatus(lineStatuses[i], `${locator}.line[${String(l)}].status[${String(i)}]`);
@@ -6829,7 +6857,7 @@ var Premium820BuildError = class extends Error {
 };
 
 // src/transactions/premium/build-820.ts
-function refuseSpec4(message) {
+function refuseSpec5(message) {
   throw new Premium820BuildError(PREMIUM_820_BUILD_ERROR_CODES.X12_820_BUILD_INVALID_SPEC, message);
 }
 var X218_VERSION_RELEASE = "005010X218";
@@ -6848,7 +6876,7 @@ function build820(spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "build820", refuseSpec5);
   const seg = (parts) => {
     let end = parts.length;
     while (end > 1 && parts[end - 1] === "") end -= 1;
@@ -6975,7 +7003,7 @@ function build820(spec) {
   return parseX12(raw);
 }
 function enforceStructuralSpec5(spec) {
-  const traces = requireCallerArray(spec.traces, "build820: spec.traces", refuseSpec4);
+  const traces = requireCallerArray(spec.traces, "build820: spec.traces", refuseSpec5);
   if (traces.length === 0) {
     throw new Premium820BuildError(
       PREMIUM_820_BUILD_ERROR_CODES.X12_820_BUILD_INVALID_SPEC,
@@ -6985,7 +7013,7 @@ function enforceStructuralSpec5(spec) {
   const remittances = requireCallerArray(
     spec.remittances,
     "build820: spec.remittances",
-    refuseSpec4
+    refuseSpec5
   );
   if (remittances.length === 0) {
     throw new Premium820BuildError(
@@ -7005,7 +7033,7 @@ function enforceStructuralSpec5(spec) {
     const openItems = requireCallerArray(
       remittance.openItems,
       `build820: spec.remittances[${String(r)}].openItems`,
-      refuseSpec4
+      refuseSpec5
     );
     if (openItems.length === 0) {
       throw new Premium820BuildError(
@@ -7525,7 +7553,7 @@ var Enrollment834BuildError = class extends Error {
 };
 
 // src/transactions/enrollment/build-834.ts
-function refuseSpec5(message) {
+function refuseSpec6(message) {
   throw new Enrollment834BuildError(
     ENROLLMENT_834_BUILD_ERROR_CODES.X12_834_BUILD_INVALID_SPEC,
     message
@@ -7549,7 +7577,7 @@ function build834(spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "build834", refuseSpec6);
   const seg = (parts) => {
     let end = parts.length;
     while (end > 1 && parts[end - 1] === "") end -= 1;
@@ -7630,7 +7658,7 @@ function build834(spec) {
   return parseX12(raw);
 }
 function enforceStructuralSpec6(spec) {
-  const members = requireCallerArray(spec.members, "build834: spec.members", refuseSpec5);
+  const members = requireCallerArray(spec.members, "build834: spec.members", refuseSpec6);
   if (members.length === 0) {
     throw new Enrollment834BuildError(
       ENROLLMENT_834_BUILD_ERROR_CODES.X12_834_BUILD_INVALID_SPEC,
@@ -7655,7 +7683,7 @@ function enforceStructuralSpec6(spec) {
     const coverages = requireCallerArray(
       member.healthCoverages,
       `build834: spec.members[${String(m)}].healthCoverages`,
-      refuseSpec5
+      refuseSpec6
     );
     for (let c = 0; c < coverages.length; c += 1) {
       const coverage = coverages[c];
@@ -8182,6 +8210,12 @@ function refuseHierarchy4(message) {
     message
   );
 }
+function refuseSpec7(message) {
+  throw new ServicesReview278BuildError(
+    AUTH_278_BUILD_ERROR_CODES.X12_278_BUILD_INVALID_SPEC,
+    message
+  );
+}
 var X12_278_FUNCTIONAL_ID = "HI";
 var X12_AGENCY_CODE7 = "X";
 var HL_LEVEL4 = {
@@ -8210,7 +8244,7 @@ function buildServicesReview(version, direction, spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "build278", refuseSpec7);
   const seg = (parts) => {
     let end = parts.length;
     while (end > 1 && parts[end - 1] === "") end -= 1;
@@ -8961,6 +8995,9 @@ function narrowNoteCode(value) {
 }
 
 // src/transactions/ack/build-999.ts
+function refuseSpec8(message) {
+  throw new AckBuildError(ACK_BUILD_ERROR_CODES.X12_ACK_INVALID_SPEC, message);
+}
 var X231A1_VERSION_RELEASE = "005010X231A1";
 var X12_AGENCY_CODE8 = "X";
 function build999(spec) {
@@ -8977,7 +9014,7 @@ function build999(spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "build999", refuseSpec8);
   const senderQualifier = envelope.senderQualifier ?? "ZZ";
   const receiverQualifier = envelope.receiverQualifier ?? "ZZ";
   const usageIndicator = envelope.usageIndicator ?? "P";
@@ -9457,6 +9494,9 @@ var X12BuildError = class extends Error {
 };
 
 // src/builder/build-interchange.ts
+function refuseSpec9(message) {
+  throw new X12BuildError(X12_BUILD_ERROR_CODES.X12_BUILD_INVALID_SPEC, message);
+}
 function buildInterchange(spec) {
   const elementSeparator = spec.elementSeparator ?? "*";
   const repetitionSeparator = spec.repetitionSeparator ?? "^";
@@ -9468,7 +9508,7 @@ function buildInterchange(spec) {
     component: componentSeparator,
     segment: segmentTerminator
   };
-  const esc = (value) => escapeRelease(value, delimiters);
+  const esc = makeCallerEscaper(delimiters, "buildInterchange", refuseSpec9);
   const senderQualifier = spec.senderQualifier ?? "ZZ";
   const receiverQualifier = spec.receiverQualifier ?? "ZZ";
   const usageIndicator = spec.usageIndicator ?? "P";
@@ -9890,7 +9930,7 @@ var profiles = Object.freeze({
 });
 
 // src/index.ts
-var VERSION = "0.0.7";
+var VERSION = "0.0.9";
 
 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