@cosyte/x12 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-10-07
+
+**What 0.1.1 means for you.** The 271 now reads and builds the procedure a benefit line applies to
+(EB-13), which dental payers use for per-procedure coinsurance, frequency, age and maximum limits.
+If you build an `X12EligibilityBenefit` object literal yourself, such as a test double, add
+`procedure: undefined` to it. Code that reads benefits from `get271` needs no change.
+
+### Added
+
+- **271 EB-13 read.** Each benefit's `procedure` carries the qualifier (EB-13-1), the code
+  (EB-13-2), up to four modifiers in transmitted order (EB-13-3 to EB-13-6) and the description
+  (EB-13-7) when the sender sent one, and is `undefined` when EB-13 is absent or has no qualifier.
+  Components are split on the component separator the interchange declares in ISA-16. New
+  package-root type export: `X12EligibilityProcedure`.
+- **271 EB-13 emit.** A 271 benefit takes an optional `procedure` (`Build271ProcedureSpec`, a new
+  package-root type export) with a qualifier, a code and modifiers, written as one composite. The
+  builder refuses an empty qualifier or code, an empty modifier, and more than four modifiers: a
+  fifth would land in the description position, and an empty one would shift later modifiers on
+  read. The description is not written.
+- The 270 reader's EQ-02 procedure decodes exactly as before and now shares its decoder with the 271.
+
+## [0.1.0] - 2026-09-25
+
 **What 0.1 means for you.** This release is the first whose public API we treat as settled: the
 exported readers, builders, types and warning codes are the surface we keep stable, and the warning
 registry only ever gains codes. It covers typed read and typed emit for 270, 271, 276, 277 and

package/README.md

@@ -31,7 +31,7 @@ a stable code instead of failing or guessing.
 
 ## Status
 
-**Version 0.1.0**, published on npm from a public repository.
+**Version 0.1.1**, published on npm from a public repository.
 
 From `0.1.0` the public API is settled and safe to depend on: the exported readers, builders,
 types and warning codes are the surface we keep stable, and the warning registry only ever gains

package/dist/index.cjs

@@ -6640,6 +6640,26 @@ function validateHl2(hl, index, expectedParentLevel, position, warnings) {
   }
 }
 
+// src/transactions/shared/procedure.ts
+var FIRST_MODIFIER = 3;
+var LAST_MODIFIER = 6;
+var DESCRIPTION = 7;
+function decodeProcedure(seg, elementIndex, delimiters) {
+  const qualifier = componentOptional(seg, elementIndex, 1, delimiters);
+  if (qualifier === void 0) return void 0;
+  const modifiers = [];
+  for (let p = FIRST_MODIFIER; p <= LAST_MODIFIER; p += 1) {
+    const modifier = componentOptional(seg, elementIndex, p, delimiters);
+    if (modifier !== void 0) modifiers.push(modifier);
+  }
+  return Object.freeze({
+    qualifier,
+    code: componentOptional(seg, elementIndex, 2, delimiters),
+    modifiers: Object.freeze(modifiers),
+    description: componentOptional(seg, elementIndex, DESCRIPTION, delimiters)
+  });
+}
+
 // src/transactions/eligibility/get-270.ts
 var INQUIRY_270 = "270";
 var IMPLEMENTED_GUIDES_270 = implementedGuides(INQUIRY_270);
@@ -6968,7 +6988,7 @@ function openInquiry(seg, delimiters) {
   }
   return {
     serviceTypeCodes,
-    procedure: decodeProcedure(seg, delimiters),
+    procedure: decodeProcedure(seg, 2, delimiters),
     coverageLevelCode: elementOptional(seg, 3, delimiters),
     insuranceTypeCode: elementOptional(seg, 4, delimiters),
     diagnosisCodePointers,
@@ -6976,21 +6996,6 @@ function openInquiry(seg, delimiters) {
     dates: []
   };
 }
-function decodeProcedure(seg, delimiters) {
-  const qualifier = componentOptional(seg, 2, 1, delimiters);
-  if (qualifier === void 0) return void 0;
-  const modifiers = [];
-  for (let p = 3; p <= 6; p += 1) {
-    const modifier = componentOptional(seg, 2, p, delimiters);
-    if (modifier !== void 0) modifiers.push(modifier);
-  }
-  return Object.freeze({
-    qualifier,
-    code: componentOptional(seg, 2, 2, delimiters),
-    modifiers: Object.freeze(modifiers),
-    description: componentOptional(seg, 2, 7, delimiters)
-  });
-}
 function freezeInquiry(acc) {
   return Object.freeze({
     serviceTypeCodes: Object.freeze(acc.serviceTypeCodes.slice()),
@@ -7473,7 +7478,7 @@ function emitInquiry(inquiry, body, ctx, locator) {
     refuseHierarchy2
   ).map((s) => ctx.esc(s.code)).join(ctx.repetitionSeparator);
   const procedure = absentIfNull(inquiry.procedure);
-  const procedureElement = procedure === void 0 ? "" : trimComponents([
+  const procedureElement2 = procedure === void 0 ? "" : trimComponents([
     ctx.esc(procedure.qualifier),
     ctx.esc(procedure.code ?? ""),
     ...leafList(procedure.modifiers, `${locator}.procedure.modifiers`).map(ctx.esc),
@@ -7486,7 +7491,7 @@ function emitInquiry(inquiry, body, ctx, locator) {
     ctx.seg([
       "EQ",
       serviceTypeElement,
-      procedureElement,
+      procedureElement2,
       ctx.esc(inquiry.coverageLevelCode ?? ""),
       ctx.esc(inquiry.insuranceTypeCode ?? ""),
       pointerElement
@@ -7997,6 +8002,7 @@ function openBenefit(seg, delimiters, sink) {
     quantity: elementDecimal(seg, 10, delimiters, sink),
     authorizationRequired: elementOptional(seg, 11, delimiters),
     inPlanNetwork: elementOptional(seg, 12, delimiters),
+    procedure: decodeProcedure(seg, 13, delimiters),
     references: [],
     dates: [],
     messages: [],
@@ -8039,6 +8045,7 @@ function freezeBenefit(acc) {
     quantity: acc.quantity,
     authorizationRequired: acc.authorizationRequired,
     inPlanNetwork: acc.inPlanNetwork,
+    procedure: acc.procedure,
     references: Object.freeze(acc.references.slice()),
     dates: Object.freeze(acc.dates.slice()),
     messages: Object.freeze(acc.messages.slice()),
@@ -8104,6 +8111,7 @@ var X279A1_VERSION_RELEASE2 = "005010X279A1";
 var X12_271_FUNCTIONAL_ID = "HB";
 var X12_AGENCY_CODE4 = "X";
 var HL_LEVEL3 = { SOURCE: "20", RECEIVER: "21", SUBSCRIBER: "22", DEPENDENT: "23" };
+var MAX_PROCEDURE_MODIFIERS = 4;
 function build271(spec) {
   const { envelope } = spec;
   enforceStructuralSpec4(spec);
@@ -8124,7 +8132,7 @@ function build271(spec) {
     while (end > 1 && parts[end - 1] === "") end -= 1;
     return parts.slice(0, end).join(elementSeparator) + segmentTerminator;
   };
-  const ctx = { seg, esc, repetitionSeparator };
+  const ctx = { seg, esc, repetitionSeparator, componentSeparator };
   const senderQualifier = envelope.senderQualifier ?? "ZZ";
   const receiverQualifier = envelope.receiverQualifier ?? "ZZ";
   const usageIndicator = envelope.usageIndicator ?? "P";
@@ -8354,7 +8362,8 @@ function emitBenefit(benefit, body, ctx) {
       ctx.esc(benefit.quantityQualifier ?? ""),
       benefit.quantity === void 0 ? "" : escDec3(benefit.quantity, ctx.esc),
       ctx.esc(benefit.authorizationRequired ?? ""),
-      ctx.esc(benefit.inPlanNetwork ?? "")
+      ctx.esc(benefit.inPlanNetwork ?? ""),
+      benefit.procedure === void 0 ? "" : procedureElement(benefit.procedure, ctx)
     ])
   );
   for (const related of benefit.relatedEntities ?? []) emitEntity2(related, body, ctx);
@@ -8364,6 +8373,32 @@ function emitBenefit(benefit, body, ctx) {
     body.push(ctx.seg(["MSG", ctx.esc(message)]));
   }
 }
+function procedureElement(procedure, ctx) {
+  const qualifier = ctx.esc(procedure.qualifier);
+  const code = ctx.esc(procedure.code);
+  if (qualifier === "" || code === "") {
+    refuseSpec4("build271: a benefit procedure (EB-13) requires a non-empty qualifier and code.");
+  }
+  const modifiers = requireCallerArray(
+    procedure.modifiers,
+    "build271: benefit procedure (EB-13) modifiers",
+    refuseSpec4
+  );
+  if (modifiers.length > MAX_PROCEDURE_MODIFIERS) {
+    refuseSpec4(
+      `build271: a benefit procedure (EB-13) carries at most ${String(MAX_PROCEDURE_MODIFIERS)} modifiers; got ${String(modifiers.length)}.`
+    );
+  }
+  const escapedModifiers = [];
+  for (let i = 0; i < modifiers.length; i += 1) {
+    const modifier = ctx.esc(modifiers[i] ?? "");
+    if (modifier === "") {
+      refuseSpec4(`build271: benefit procedure (EB-13) modifier at index ${String(i)} is empty.`);
+    }
+    escapedModifiers.push(modifier);
+  }
+  return [qualifier, code, ...escapedModifiers].join(ctx.componentSeparator);
+}
 function emitTrace2(trace, body, ctx) {
   body.push(
     ctx.seg([
@@ -9347,7 +9382,7 @@ function emitClaim3(claim, body, ctx, locator) {
 }
 function emitServiceLine3(line, body, ctx, locator) {
   const procedure = absentIfNull2(line.procedure);
-  const procedureElement = procedure === void 0 ? "" : ctx.comp([
+  const procedureElement2 = procedure === void 0 ? "" : ctx.comp([
     procedure.qualifier,
     procedure.code ?? "",
     ...leafList2(procedure.modifiers, `${locator}.procedure.modifiers`),
@@ -9356,7 +9391,7 @@ function emitServiceLine3(line, body, ctx, locator) {
   body.push(
     ctx.seg([
       "SVC",
-      procedureElement,
+      procedureElement2,
       line.lineChargeAmount === void 0 ? "" : escDec4(line.lineChargeAmount, ctx.esc),
       "",
       ctx.esc(line.revenueCode ?? ""),
@@ -15360,7 +15395,7 @@ var profiles = Object.freeze({
 });
 
 // src/index.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.1";
 
 exports.AAA_CONDITION_LEVELS = AAA_CONDITION_LEVELS;
 exports.AAA_FOLLOW_UP_ACTION_CODES = AAA_FOLLOW_UP_ACTION_CODES;