@cosyte/synth 0.1.4 → 0.1.6

package/dist/hl7/index.d.cts

@@ -527,6 +527,12 @@ interface Hl7CorpusOptions {
      * supplied it takes precedence over `mix` and restricts the corpus to `ADT` messages.
      */
     readonly triggers?: readonly AdtTrigger[];
+    /**
+     * Whether each artifact is read back through its parser and the parser's findings recorded as its
+     * `warnings`. Defaults to `true`. `false` skips the read, a large share of a corpus's time; every
+     * artifact's `warnings` is then empty without having been checked.
+     */
+    readonly verify?: boolean;
 }
 /**
  * Build a reproducible {@link Corpus} of spec-clean HL7 messages across the families. Each

package/dist/hl7/index.d.ts

@@ -527,6 +527,12 @@ interface Hl7CorpusOptions {
      * supplied it takes precedence over `mix` and restricts the corpus to `ADT` messages.
      */
     readonly triggers?: readonly AdtTrigger[];
+    /**
+     * Whether each artifact is read back through its parser and the parser's findings recorded as its
+     * `warnings`. Defaults to `true`. `false` skips the read, a large share of a corpus's time; every
+     * artifact's `warnings` is then empty without having been checked.
+     */
+    readonly verify?: boolean;
 }
 /**
  * Build a reproducible {@link Corpus} of spec-clean HL7 messages across the families. Each

package/dist/hl7/index.mjs

@@ -1,4 +1,12 @@
-import { buildMessage, parseHL7, profiles } from '@cosyte/hl7';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 
 // src/rng/splitmix32.ts
 function splitmix32(seed) {
@@ -30,17 +38,36 @@ function sfc32Next(s) {
 }
 
 // src/codes.ts
-var SYNTH_FATAL_CODES = {
+var SYNTH_FATAL_CODES = Object.freeze({
+  /**
+   * A format was requested that this build cannot generate through a real parser builder/serializer.
+   * Fatal, never a hand-written byte fallback.
+   *
+   * **No code path in this build raises it.** All six formats generate, so it is reserved for a
+   * future format that does not, and is kept because removing a published code is a breaking change.
+   * An unsupported *kind* within a format that does generate is `SYNTH_UNSUPPORTED_KIND`.
+   */
+  SYNTH_UNSUPPORTED_FORMAT: "SYNTH_UNSUPPORTED_FORMAT",
   /**
    * A vendor quirk was requested that the target format's profile system does not support. Fatal,
    * never a silent no-op and never a fabricated quirk.
    */
   SYNTH_UNSUPPORTED_QUIRK: "SYNTH_UNSUPPORTED_QUIRK",
+  /**
+   * A quirk transform found no structural anchor to mutate, so the fixture would not carry the
+   * deviation it is labelled with. Fatal: a golden file that lies about its parser verdict is worse
+   * than no golden file.
+   */
+  SYNTH_QUIRK_ANCHOR_ABSENT: "SYNTH_QUIRK_ANCHOR_ABSENT",
   /**
    * A bare parse of a freshly-generated quirk artifact did not produce exactly the declared intended
    * warning code(s). Fatal, never emit a mislabeled fixture.
    */
   SYNTH_INTENDED_WARNING_MISMATCH: "SYNTH_INTENDED_WARNING_MISMATCH",
+  /** A concept's code-system URI has no OID mapping in the C-CDA example-code table. Fatal. */
+  SYNTH_UNMAPPED_CODE_SYSTEM: "SYNTH_UNMAPPED_CODE_SYSTEM",
+  /** A money value could not be read as an X12 decimal. Fatal: a generator never rounds to a float. */
+  SYNTH_INVALID_DECIMAL: "SYNTH_INVALID_DECIMAL",
   /** An integer range was requested with its maximum below its minimum. Fatal. */
   SYNTH_INVALID_RANGE: "SYNTH_INVALID_RANGE",
   /** A value was drawn from an empty pool. Fatal, never a fabricated substitute. */
@@ -53,7 +80,17 @@ var SYNTH_FATAL_CODES = {
    * see `resolveKind`: a selector union is erased at run time, and a selector that falls through
    * either mislabels the fixture or hands the value to a peer builder that quotes it back.
    */
-  SYNTH_UNSUPPORTED_KIND: "SYNTH_UNSUPPORTED_KIND"};
+  SYNTH_UNSUPPORTED_KIND: "SYNTH_UNSUPPORTED_KIND",
+  /**
+   * A requested profile IS published by the adopted implementation guide, and this build does not
+   * generate it. Deliberately distinct from `SYNTH_UNSUPPORTED_KIND`, which says the name is not in
+   * the adopted set at all: "the guide does not publish this" and "we do not generate this yet" are
+   * different answers, and a caller building to a regulatory profile set has to be able to tell them
+   * apart without matching message text. Fatal, and raised **before** anything is generated: a
+   * mislabelled artifact is worse than no artifact.
+   */
+  SYNTH_PROFILE_NOT_GENERATED: "SYNTH_PROFILE_NOT_GENERATED"
+});
 var SYNTH_FATAL_MESSAGES = Object.freeze({
   SYNTH_UNSUPPORTED_FORMAT: "The requested format is not generable by this build. A generator has no byte fallback: it builds through a parser's own serializer or it refuses.",
   SYNTH_UNSUPPORTED_QUIRK: "The requested vendor quirk is not in the target format's quirk registry. Compare the request against that format's exported registry (HL7_QUIRKS, CCDA_QUIRKS, ASTM_QUIRKS).",
@@ -119,6 +156,7 @@ function createRng(seed) {
 }
 
 // src/corpus.ts
+var UNCHECKED = Object.freeze([]);
 function makeCorpus(seed, artifacts, quirks = []) {
   const counts = {};
   const formats = /* @__PURE__ */ new Set();
@@ -430,6 +468,30 @@ var safe = Object.freeze({
   npi,
   dea
 });
+function defaultHost() {
+  if (typeof import.meta.resolve !== "function") return { require: __require, resolve: void 0 };
+  return { require: createRequire(import.meta.url), resolve: (s) => import.meta.resolve(s) };
+}
+function isRequireEsmRefusal(error) {
+  return error?.code === "ERR_REQUIRE_ESM";
+}
+function loadPeer(specifier, host) {
+  if (host.resolve === void 0) return host.require(specifier);
+  const entry = fileURLToPath(host.resolve(specifier));
+  try {
+    return host.require(entry);
+  } catch (error) {
+    if (!isRequireEsmRefusal(error)) throw error;
+    return host.require(specifier);
+  }
+}
+function lazyPeer(specifier, host) {
+  let loaded;
+  return () => loaded ??= loadPeer(specifier, defaultHost());
+}
+
+// src/peers.ts
+var hl7Peer = lazyPeer("@cosyte/hl7");
 
 // src/hl7/common.ts
 function seededTimestamp(rng) {
@@ -442,7 +504,7 @@ function seededTimestamp(rng) {
 function mshScaffold(rng, type) {
   const timestamp = seededTimestamp(rng);
   const controlId = `SYNTH${rng.digits(10)}`;
-  const message = buildMessage({
+  const message = hl7Peer().buildMessage({
     type,
     sendingApp: "COSYTE-SYNTH",
     sendingFacility: "SYNTH-FAC",
@@ -569,6 +631,7 @@ function obxSegment(rng, setId) {
   const obs = rng.pick(EXAMPLE_LAB_OBSERVATIONS);
   const value = `${String(rng.int(1, 300))}.${String(rng.int(0, 9))}`;
   const observedAt = seededTimestamp(rng);
+  const units = obs.units ?? "";
   return [
     String(setId),
     // OBX-1 set id
@@ -580,7 +643,7 @@ function obxSegment(rng, setId) {
     // OBX-4 observation sub-id
     value,
     // OBX-5 observation value
-    obs.units ?? "",
+    units,
     // OBX-6 units
     "",
     // OBX-7 reference range
@@ -794,9 +857,11 @@ function generateVxu(options = {}) {
   ]);
   return message;
 }
+
+// src/hl7/round-trip.ts
 function roundTrip(message) {
   const content = message.toString();
-  const reparsed = parseHL7(content);
+  const reparsed = hl7Peer().parseHL7(content);
   const warnings = reparsed.warnings.map((w) => String(w.code));
   const byteStable = reparsed.toString() === content;
   return {
@@ -806,6 +871,14 @@ function roundTrip(message) {
     specClean: warnings.length === 0 && byteStable
   };
 }
+function hl7CorpusArtifact(message, verify) {
+  const content = message.toString();
+  if (!verify) return { content, warnings: UNCHECKED };
+  return {
+    content,
+    warnings: hl7Peer().parseHL7(content).warnings.map((w) => String(w.code))
+  };
+}
 
 // src/profile.ts
 function defineSynthProfile(spec) {
@@ -881,7 +954,7 @@ var HL7_QUIRKS = Object.freeze({
   })
 });
 function toleratingProfile(quirk) {
-  return quirk === "unknown-zsegment" ? profiles.visage : void 0;
+  return quirk === "unknown-zsegment" ? hl7Peer().profiles.visage : void 0;
 }
 function segmentsOf(wire) {
   return wire.split(/\r\n|\r|\n/).filter((s) => s.length > 0);
@@ -929,7 +1002,7 @@ function generateHl7Quirk(options) {
   const content = applyQuirk(options.quirk, baseMessage(kind, seed).toString());
   assertIntendedWarnings(
     descriptor.intendedWarnings,
-    parseHL7(content).warnings.map((w) => String(w.code))
+    hl7Peer().parseHL7(content).warnings.map((w) => String(w.code))
   );
   return Object.freeze({
     format: "hl7v2",
@@ -942,12 +1015,12 @@ function generateHl7Quirk(options) {
 function hl7QuirkRoundTrip(artifact) {
   const quirk = artifact.quirk;
   const descriptor = resolveQuirk(HL7_QUIRKS, "hl7v2", quirk);
-  const bare = parseHL7(artifact.content).warnings.map((w) => String(w.code));
+  const bare = hl7Peer().parseHL7(artifact.content).warnings.map((w) => String(w.code));
   const profile = toleratingProfile(quirk);
   const withProfile = profile !== void 0 && descriptor.toleratingProfile !== void 0 ? {
     profileName: descriptor.toleratingProfile,
     disposition: descriptor.disposition,
-    warnings: parseHL7(artifact.content, profile).warnings.map((w) => String(w.code)),
+    warnings: hl7Peer().parseHL7(artifact.content, profile).warnings.map((w) => String(w.code)),
     tolerated: false
   } : void 0;
   return {
@@ -1026,7 +1099,7 @@ function generateHl7(kind, seed) {
   }
 }
 function hl7Corpus(options) {
-  const { seed, count = 1 } = options;
+  const { seed, count = 1, verify = true } = options;
   const kinds = options.triggers !== void 0 ? options.triggers.map(
     (t) => `ADT^${resolveKind(ADT_TRIGGERS2, t)}`
   ) : resolveMix(ALL_KINDS, options.mix, DEFAULT_MIX);
@@ -1034,7 +1107,7 @@ function hl7Corpus(options) {
   const artifacts = Array.from({ length: count }, (_unused, i) => {
     const kind = kinds[i % kinds.length] ?? "ADT^A01";
     const messageSeed = seedStream.nextUint32();
-    const rt = roundTrip(generateHl7(kind, messageSeed));
+    const rt = hl7CorpusArtifact(generateHl7(kind, messageSeed), verify);
     return {
       format: "hl7v2",
       kind,