@cosyte/astm 0.0.7 → 0.0.8

package/dist/index.mjs

@@ -119,7 +119,11 @@ function primaryCode(u) {
 
 // src/common/warnings.ts
 var WARNING_CODES = {
-  /** A record's type letter is not one of the modeled types: surfaced as an unsupported record. */
+  /**
+   * A record's type letter is not one of the modeled types: surfaced as an unsupported record,
+   * never dropped. Treat it as a possible lost message boundary, because a header the reader did
+   * not recognize as one does not open a new message.
+   */
   ASTM_RECORD_UNKNOWN_TYPE: "ASTM_RECORD_UNKNOWN_TYPE",
   /** The header declared delimiters other than the canonical `H|\^&`: tolerated, noted. */
   ASTM_NONSTANDARD_DELIMITERS: "ASTM_NONSTANDARD_DELIMITERS",
@@ -212,7 +216,7 @@ var WARNING_CODES = {
 function unknownRecordType(position) {
   return {
     code: WARNING_CODES.ASTM_RECORD_UNKNOWN_TYPE,
-    message: "Unrecognized record type, surfaced verbatim as an unsupported record.",
+    message: "Unrecognized record type, surfaced verbatim as an unsupported record. If this record was a header, message grouping did not open a new message here.",
     position
   };
 }
@@ -425,6 +429,135 @@ function classifyMessage(records) {
   return { kind, hasQuery, hasResults, hasOrders, isHostQueryRequest: kind === "host-query" };
 }
 
+// src/frames/warnings.ts
+var FRAME_WARNING_CODES = {
+  /**
+   * A frame's two-hex-char checksum did not match the modulo-256 sum recomputed over its bytes. The
+   * frame is surfaced with `trusted: false` and its text is **never merged** into a reassembled
+   * record (default **warn** in lenient mode, escalated to a thrown error in `strict`). Corruption is
+   * never silently trusted: the "checksums are routinely not validated" claim was refuted; we
+   * validate.
+   */
+  ASTM_FRAME_BAD_CHECKSUM: "ASTM_FRAME_BAD_CHECKSUM",
+  /**
+   * A frame's sequence number was not the expected next value (`1 → … → 7 → 0 → …`): a frame was
+   * possibly dropped. The stream is **never silently concatenated across the gap** as if contiguous;
+   * the in-progress record is tainted and not emitted as a clean reassembly.
+   */
+  ASTM_FRAME_SEQUENCE_GAP: "ASTM_FRAME_SEQUENCE_GAP",
+  /**
+   * A frame opened with `STX` but no valid terminator + checksum was found before the stream ended
+   * (or before the next `STX`), or a record's frames ended on an intermediate `ETB` with no final
+   * `ETX`. The partial bytes are surfaced flagged untrusted and **no partial record is invented**
+   * (warn in lenient, thrown in `strict`).
+   */
+  ASTM_FRAME_UNTERMINATED: "ASTM_FRAME_UNTERMINATED",
+  /**
+   * A frame's record text exceeded the 240-byte limit without a split. The frame is still surfaced
+   * (and, if its checksum validates, reassembled): the deviation is flagged, not silently dropped
+   * (warn in lenient, thrown in `strict`).
+   */
+  ASTM_FRAME_OVERSIZE: "ASTM_FRAME_OVERSIZE"
+};
+function frameBadChecksum(position) {
+  return {
+    code: FRAME_WARNING_CODES.ASTM_FRAME_BAD_CHECKSUM,
+    message: "Frame checksum mismatch, surfaced untrusted, never merged into a record.",
+    position
+  };
+}
+function frameSequenceGap(position) {
+  return {
+    code: FRAME_WARNING_CODES.ASTM_FRAME_SEQUENCE_GAP,
+    message: "Frame number out of sequence, possible dropped frame, never silently bridged.",
+    position
+  };
+}
+function frameUnterminated(position) {
+  return {
+    code: FRAME_WARNING_CODES.ASTM_FRAME_UNTERMINATED,
+    message: "Unterminated frame, partial bytes surfaced untrusted, no partial record invented.",
+    position
+  };
+}
+function frameOversize(position) {
+  return {
+    code: FRAME_WARNING_CODES.ASTM_FRAME_OVERSIZE,
+    message: "Frame text exceeded the 240-byte limit without a split, flagged, never dropped.",
+    position
+  };
+}
+
+// src/ltp/warnings.ts
+var LTP_WARNING_CODES = {
+  /**
+   * The transport detector could not tell a framed stream from a raw (unframed) one from its leading
+   * byte: it was neither `STX`/`ENQ` nor a bare record letter. It **defaults to framed** and warns,
+   * never guessing silently into data loss; a profile override forces the mode. (cobas b121 drops
+   * framing over TCP; cobas 4800 / Iguana retain it, both realities exist, so an unrecognizable lead
+   * is defaulted, not assumed.)
+   */
+  ASTM_LTP_AMBIGUOUS_TRANSPORT: "ASTM_LTP_AMBIGUOUS_TRANSPORT",
+  /**
+   * A control event arrived in a protocol state that did not expect it: e.g. an inbound `ACK`/`NAK`
+   * at a receiver (which sends, never receives, those), or an `ENQ` mid-transfer. The event is
+   * surfaced and handled defensively (an unexpected `ACK`/`NAK` is **never** read as acceptance of
+   * data); it never advances the transfer as if valid.
+   */
+  ASTM_LTP_UNEXPECTED_EVENT: "ASTM_LTP_UNEXPECTED_EVENT",
+  /**
+   * The receiver rejected a received frame with a `NAK` instead of accepting it: because its
+   * checksum failed, it was unterminated, or its frame number was out of sequence. The frame's text
+   * is **never** appended to the record and the transfer does **not** advance; the receiver awaits the
+   * sender's retransmit. This is the protocol-level face of the frame codec's fail-safe: a bad frame
+   * drives retransmit, not acceptance.
+   */
+  ASTM_LTP_FRAME_REJECTED: "ASTM_LTP_FRAME_REJECTED"
+};
+function ltpAmbiguousTransport() {
+  return {
+    code: LTP_WARNING_CODES.ASTM_LTP_AMBIGUOUS_TRANSPORT,
+    message: "Leading byte was neither a frame start (STX/ENQ) nor a record letter, defaulted to framed; override with a profile to force raw."
+  };
+}
+function ltpUnexpectedEvent(frameNumber) {
+  return {
+    code: LTP_WARNING_CODES.ASTM_LTP_UNEXPECTED_EVENT,
+    message: "Control event arrived in a state that did not expect it, handled defensively, never read as acceptance.",
+    ...frameNumber !== void 0 ? { frameNumber } : {}
+  };
+}
+function ltpFrameRejected(frameNumber) {
+  return {
+    code: LTP_WARNING_CODES.ASTM_LTP_FRAME_REJECTED,
+    message: "Frame rejected (bad checksum, unterminated, or out of sequence), NAK sent, retransmit expected, never accepted.",
+    ...frameNumber !== void 0 ? { frameNumber } : {}
+  };
+}
+
+// src/profiles/safety.ts
+var TOLERABLE_CODES = Object.freeze(
+  /* @__PURE__ */ new Set([
+    WARNING_CODES.ASTM_NONSTANDARD_DELIMITERS,
+    WARNING_CODES.ASTM_UNKNOWN_ESCAPE_SEQUENCE,
+    WARNING_CODES.ASTM_RECORD_UNINTERPRETED_QUERY_STATUS
+  ])
+);
+var ALL_WARNING_CODES = [
+  ...Object.values(WARNING_CODES),
+  ...Object.values(FRAME_WARNING_CODES),
+  ...Object.values(LTP_WARNING_CODES)
+];
+var ALL_ASTM_WARNING_CODES = Object.freeze(
+  new Set(ALL_WARNING_CODES)
+);
+var SAFETY_CRITICAL_CODES = Object.freeze(
+  new Set(ALL_WARNING_CODES.filter((c) => !TOLERABLE_CODES.has(c)))
+);
+function isSafetyCriticalCode(code) {
+  return SAFETY_CRITICAL_CODES.has(code);
+}
+
 // src/profiles/apply.ts
 function toleranceApplies(tolerance, warning) {
   if (tolerance.code !== warning.code) return false;
@@ -440,6 +573,7 @@ function toleranceApplies(tolerance, warning) {
 }
 function applyAstmProfile(profile, warning) {
   if (warning.expected === true) return warning;
+  if (isSafetyCriticalCode(warning.code)) return warning;
   for (const tolerance of profile.tolerate) {
     if (toleranceApplies(tolerance, warning)) {
       return profileQuirkApplied(warning, profile.name);
@@ -561,136 +695,6 @@ var AstmProfileDefinitionError = class extends Error {
   }
 };
 
-// src/frames/warnings.ts
-var FRAME_WARNING_CODES = {
-  /**
-   * A frame's two-hex-char checksum did not match the modulo-256 sum recomputed over its bytes. The
-   * frame is surfaced with `trusted: false` and its text is **never merged** into a reassembled
-   * record (default **warn** in lenient mode, escalated to a thrown error in `strict`). Corruption is
-   * never silently trusted: the "checksums are routinely not validated" claim was refuted; we
-   * validate.
-   */
-  ASTM_FRAME_BAD_CHECKSUM: "ASTM_FRAME_BAD_CHECKSUM",
-  /**
-   * A frame's sequence number was not the expected next value (`1 → … → 7 → 0 → …`): a frame was
-   * possibly dropped. The stream is **never silently concatenated across the gap** as if contiguous;
-   * the in-progress record is tainted and not emitted as a clean reassembly.
-   */
-  ASTM_FRAME_SEQUENCE_GAP: "ASTM_FRAME_SEQUENCE_GAP",
-  /**
-   * A frame opened with `STX` but no valid terminator + checksum was found before the stream ended
-   * (or before the next `STX`), or a record's frames ended on an intermediate `ETB` with no final
-   * `ETX`. The partial bytes are surfaced flagged untrusted and **no partial record is invented**
-   * (warn in lenient, thrown in `strict`).
-   */
-  ASTM_FRAME_UNTERMINATED: "ASTM_FRAME_UNTERMINATED",
-  /**
-   * A frame's record text exceeded the 240-byte limit without a split. The frame is still surfaced
-   * (and, if its checksum validates, reassembled): the deviation is flagged, not silently dropped
-   * (warn in lenient, thrown in `strict`).
-   */
-  ASTM_FRAME_OVERSIZE: "ASTM_FRAME_OVERSIZE"
-};
-function frameBadChecksum(position) {
-  return {
-    code: FRAME_WARNING_CODES.ASTM_FRAME_BAD_CHECKSUM,
-    message: "Frame checksum mismatch, surfaced untrusted, never merged into a record.",
-    position
-  };
-}
-function frameSequenceGap(position) {
-  return {
-    code: FRAME_WARNING_CODES.ASTM_FRAME_SEQUENCE_GAP,
-    message: "Frame number out of sequence, possible dropped frame, never silently bridged.",
-    position
-  };
-}
-function frameUnterminated(position) {
-  return {
-    code: FRAME_WARNING_CODES.ASTM_FRAME_UNTERMINATED,
-    message: "Unterminated frame, partial bytes surfaced untrusted, no partial record invented.",
-    position
-  };
-}
-function frameOversize(position) {
-  return {
-    code: FRAME_WARNING_CODES.ASTM_FRAME_OVERSIZE,
-    message: "Frame text exceeded the 240-byte limit without a split, flagged, never dropped.",
-    position
-  };
-}
-
-// src/ltp/warnings.ts
-var LTP_WARNING_CODES = {
-  /**
-   * The transport detector could not tell a framed stream from a raw (unframed) one from its leading
-   * byte: it was neither `STX`/`ENQ` nor a bare record letter. It **defaults to framed** and warns,
-   * never guessing silently into data loss; a profile override forces the mode. (cobas b121 drops
-   * framing over TCP; cobas 4800 / Iguana retain it, both realities exist, so an unrecognizable lead
-   * is defaulted, not assumed.)
-   */
-  ASTM_LTP_AMBIGUOUS_TRANSPORT: "ASTM_LTP_AMBIGUOUS_TRANSPORT",
-  /**
-   * A control event arrived in a protocol state that did not expect it: e.g. an inbound `ACK`/`NAK`
-   * at a receiver (which sends, never receives, those), or an `ENQ` mid-transfer. The event is
-   * surfaced and handled defensively (an unexpected `ACK`/`NAK` is **never** read as acceptance of
-   * data); it never advances the transfer as if valid.
-   */
-  ASTM_LTP_UNEXPECTED_EVENT: "ASTM_LTP_UNEXPECTED_EVENT",
-  /**
-   * The receiver rejected a received frame with a `NAK` instead of accepting it: because its
-   * checksum failed, it was unterminated, or its frame number was out of sequence. The frame's text
-   * is **never** appended to the record and the transfer does **not** advance; the receiver awaits the
-   * sender's retransmit. This is the protocol-level face of the frame codec's fail-safe: a bad frame
-   * drives retransmit, not acceptance.
-   */
-  ASTM_LTP_FRAME_REJECTED: "ASTM_LTP_FRAME_REJECTED"
-};
-function ltpAmbiguousTransport() {
-  return {
-    code: LTP_WARNING_CODES.ASTM_LTP_AMBIGUOUS_TRANSPORT,
-    message: "Leading byte was neither a frame start (STX/ENQ) nor a record letter, defaulted to framed; override with a profile to force raw."
-  };
-}
-function ltpUnexpectedEvent(frameNumber) {
-  return {
-    code: LTP_WARNING_CODES.ASTM_LTP_UNEXPECTED_EVENT,
-    message: "Control event arrived in a state that did not expect it, handled defensively, never read as acceptance.",
-    ...frameNumber !== void 0 ? { frameNumber } : {}
-  };
-}
-function ltpFrameRejected(frameNumber) {
-  return {
-    code: LTP_WARNING_CODES.ASTM_LTP_FRAME_REJECTED,
-    message: "Frame rejected (bad checksum, unterminated, or out of sequence), NAK sent, retransmit expected, never accepted.",
-    ...frameNumber !== void 0 ? { frameNumber } : {}
-  };
-}
-
-// src/profiles/safety.ts
-var TOLERABLE_CODES = Object.freeze(
-  /* @__PURE__ */ new Set([
-    WARNING_CODES.ASTM_RECORD_UNKNOWN_TYPE,
-    WARNING_CODES.ASTM_NONSTANDARD_DELIMITERS,
-    WARNING_CODES.ASTM_UNKNOWN_ESCAPE_SEQUENCE,
-    WARNING_CODES.ASTM_RECORD_UNINTERPRETED_QUERY_STATUS
-  ])
-);
-var ALL_WARNING_CODES = [
-  ...Object.values(WARNING_CODES),
-  ...Object.values(FRAME_WARNING_CODES),
-  ...Object.values(LTP_WARNING_CODES)
-];
-var ALL_ASTM_WARNING_CODES = Object.freeze(
-  new Set(ALL_WARNING_CODES)
-);
-var SAFETY_CRITICAL_CODES = Object.freeze(
-  new Set(ALL_WARNING_CODES.filter((c) => !TOLERABLE_CODES.has(c)))
-);
-function isSafetyCriticalCode(code) {
-  return SAFETY_CRITICAL_CODES.has(code);
-}
-
 // src/profiles/validate.ts
 var KNOWN_OPTION_KEYS = [
   "name",
@@ -770,7 +774,7 @@ function validateTolerations(tolerate, profileName) {
     }
     if (isSafetyCriticalCode(t.code)) {
       throw new AstmProfileDefinitionError(
-        `Profile '${profileName}' may not tolerate '${t.code}': it is a safety-critical warning code (a result value / flag / status / range / units, patient or comment context, message-kind ambiguity, code system, or a frame / LTP integrity warning). A profile quiets benign structural noise, never a deviation that could change a clinical reading or corrupt the wire: it can never make a bad checksum "ok" or a cancelled result read "final."`,
+        `Profile '${profileName}' may not tolerate '${t.code}': it is a safety-critical warning code (a result value / flag / status / range / units, patient or comment context, message-kind ambiguity, code system, an unrecognized record type, or a frame / LTP integrity warning). A profile quiets benign structural noise, never a deviation that could change a clinical reading, report a lost message boundary, or corrupt the wire: it can never make a bad checksum "ok", a cancelled result read "final", or quiet the warning that says two messages were read as one.`,
         profileName
       );
     }
@@ -2197,7 +2201,7 @@ function concatBytes3(chunks) {
 }
 
 // src/index.ts
-var VERSION = "0.0.7";
+var VERSION = "0.0.8";
 
 export { ALL_ASTM_WARNING_CODES, AMBIGUOUS_CODES, ACK as ASTM_ACK, ENQ as ASTM_ENQ, EOT as ASTM_EOT, NAK as ASTM_NAK, AstmAmbiguousStreamError, AstmFrameEncodeError, AstmFrameStrictError, AstmParseError, AstmProfileDefinitionError, AstmSerializeError, AstmStrictError, CANONICAL_DELIMITERS, FATAL_CODES, FRAME_WARNING_CODES, LIVD_WARNING_CODES, LTP_WARNING_CODES, SAFETY_CRITICAL_CODES, TOLERABLE_CODES, VERSION, WARNING_CODES, ambiguousMessageKind, ambiguousValueSplit, applyAstmProfile, applyAstmProfileToWarnings, applyLivd, astmDateToLocalISO, astmProfiles, attachComments, buildAstmMessage, classifyMessage, comments, commentsFor, composeAstmFrames, computeChecksum, decodeAstmFrames, decodeEscapes, deepFreeze, defineAstmProfile, defineLivdCatalog, delimitersRedeclared, detectFraming, encodeComponent, fieldScalar, frameBadChecksum, frameOversize, frameSequenceGap, frameUnterminated, getAstmProfile, getDefaultAstmProfile, interpretAbnormalFlag, interpretResultStatus, isNonStandard, isSafetyCriticalCode, listAstmProfiles, livdAmbiguousMapping, livdUnmappedCode, lookupLivdForRecord, ltpAmbiguousTransport, ltpFrameRejected, ltpInitialState, ltpReduce, ltpUnexpectedEvent, messages, nonStandardDelimiters, orders, orphanComment, parseAstmDate, parseAstmRecords, parseChecksumHex, parseFramedAstm, parseReferenceRange, partialTimestamp, patient, primaryCode, profileQuirkApplied, query, readDelimiters, recognizeUniversalTestId, resolveProfileTransport, results, serializeAstmRecord, serializeAstmRecords, serializeField, serializeFramedAstm, setDefaultAstmProfile, splitEscapeAware, toChecksumHex, tokenizeHeader, tokenizeRecord, undefinedAbnormalFlag, undefinedResultStatus, uninterpretedQueryStatus, unitsAbsent, unknownEscapeSequence, unknownRecordType, unparseableReferenceRange, unreadableRedeclaration };
 //# sourceMappingURL=index.mjs.map