@cosyte/synth 0.1.4 → 0.1.6

package/dist/x12/index.d.cts

@@ -465,6 +465,12 @@ interface X12CorpusOptions {
     readonly count?: number;
     /** The transaction kinds to cycle through. Defaults to one of each. */
     readonly mix?: readonly X12CorpusKind[];
+    /**
+     * 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 X12 transactions. Each transaction is generated from

package/dist/x12/index.d.ts

@@ -465,6 +465,12 @@ interface X12CorpusOptions {
     readonly count?: number;
     /** The transaction kinds to cycle through. Defaults to one of each. */
     readonly mix?: readonly X12CorpusKind[];
+    /**
+     * 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 X12 transactions. Each transaction is generated from

package/dist/x12/index.mjs

@@ -1,4 +1,12 @@
-import { X12Decimal, build837D, build837I, build837P, build835, build271, serializeX12, parseX12 } from '@cosyte/x12';
+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,20 +38,59 @@ 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. */
   SYNTH_EMPTY_POOL: "SYNTH_EMPTY_POOL",
+  /** A `defineSynthProfile` spec was not usable (a missing or blank `name`). Fatal. */
+  SYNTH_INVALID_PROFILE: "SYNTH_INVALID_PROFILE",
   /**
    * A caller-supplied selector (a message kind, a document type, a corpus mix entry, a claim
    * variant, a Bundle type, a resource profile) is not in the closed set that governs it. Fatal:
    * 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).",
@@ -109,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();
@@ -128,8 +176,32 @@ function makeCorpus(seed, artifacts, quirks = []) {
     artifacts: Object.freeze(frozenArtifacts)
   });
 }
+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());
+}
+var x12Peer = lazyPeer("@cosyte/x12");
+
+// src/x12/money.ts
 function dec(value) {
-  const d = X12Decimal.fromString(value);
+  const d = x12Peer().X12Decimal.fromString(value);
   if (d === void 0) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INVALID_DECIMAL);
   return d;
 }
@@ -482,39 +554,49 @@ function x12EnvelopeTiming(rng) {
 }
 
 // src/x12/example-codes.ts
-var PROFESSIONAL_PROCEDURES = Object.freeze([
-  { code: "99213", label: "office/outpatient visit, established patient" },
-  { code: "99214", label: "office/outpatient visit, established patient, moderate" },
-  { code: "99203", label: "office/outpatient visit, new patient" },
-  { code: "85025", label: "complete blood count with differential" },
-  { code: "80053", label: "comprehensive metabolic panel" },
-  { code: "93000", label: "electrocardiogram, routine" }
-]);
+var PROFESSIONAL_PROCEDURES = Object.freeze(
+  [
+    { code: "99213", label: "office/outpatient visit, established patient" },
+    { code: "99214", label: "office/outpatient visit, established patient, moderate" },
+    { code: "99203", label: "office/outpatient visit, new patient" },
+    { code: "85025", label: "complete blood count with differential" },
+    { code: "80053", label: "comprehensive metabolic panel" },
+    { code: "93000", label: "electrocardiogram, routine" }
+  ].map((entry) => Object.freeze(entry))
+);
 var PROCEDURE_MODIFIERS = Object.freeze(["25", "59", "76", "GT"]);
 var PLACES_OF_SERVICE = Object.freeze(["11", "22", "21", "12", "49"]);
-var DIAGNOSES = Object.freeze([
-  { code: "J20.9", label: "acute bronchitis, unspecified" },
-  { code: "E11.9", label: "type 2 diabetes mellitus without complications" },
-  { code: "I10", label: "essential (primary) hypertension" },
-  { code: "M54.5", label: "low back pain" },
-  { code: "R07.9", label: "chest pain, unspecified" },
-  { code: "Z00.00", label: "general adult medical exam without abnormal findings" }
-]);
-var REVENUE_CODES = Object.freeze([
-  { code: "0120", label: "room & board, semi-private" },
-  { code: "0300", label: "laboratory, general" },
-  { code: "0450", label: "emergency room, general" },
-  { code: "0636", label: "drugs requiring detailed coding" }
-]);
-var INSTITUTIONAL_PROCEDURES = Object.freeze([
-  { code: "99221", label: "initial hospital care, per day" },
-  { code: "99231", label: "subsequent hospital care, per day" }
-]);
-var DENTAL_PROCEDURES = Object.freeze([
-  { code: "D2391", label: "resin-based composite, one surface, posterior" },
-  { code: "D1110", label: "prophylaxis, adult" },
-  { code: "D0120", label: "periodic oral evaluation" }
-]);
+var DIAGNOSES = Object.freeze(
+  [
+    { code: "J20.9", label: "acute bronchitis, unspecified" },
+    { code: "E11.9", label: "type 2 diabetes mellitus without complications" },
+    { code: "I10", label: "essential (primary) hypertension" },
+    { code: "M54.5", label: "low back pain" },
+    { code: "R07.9", label: "chest pain, unspecified" },
+    { code: "Z00.00", label: "general adult medical exam without abnormal findings" }
+  ].map((entry) => Object.freeze(entry))
+);
+var REVENUE_CODES = Object.freeze(
+  [
+    { code: "0120", label: "room & board, semi-private" },
+    { code: "0300", label: "laboratory, general" },
+    { code: "0450", label: "emergency room, general" },
+    { code: "0636", label: "drugs requiring detailed coding" }
+  ].map((entry) => Object.freeze(entry))
+);
+var INSTITUTIONAL_PROCEDURES = Object.freeze(
+  [
+    { code: "99221", label: "initial hospital care, per day" },
+    { code: "99231", label: "subsequent hospital care, per day" }
+  ].map((entry) => Object.freeze(entry))
+);
+var DENTAL_PROCEDURES = Object.freeze(
+  [
+    { code: "D2391", label: "resin-based composite, one surface, posterior" },
+    { code: "D1110", label: "prophylaxis, adult" },
+    { code: "D0120", label: "periodic oral evaluation" }
+  ].map((entry) => Object.freeze(entry))
+);
 var TOOTH_CODES = Object.freeze(["14", "3", "19", "30"]);
 var TOOTH_SURFACES = Object.freeze(["M", "O", "D", "B", "L"]);
 var CARC_CODES = Object.freeze(["1", "2", "3", "45", "96", "197"]);
@@ -720,11 +802,11 @@ function generate837(variant, options) {
   const spec = specOf(rng, resolved);
   switch (resolved) {
     case "P":
-      return build837P(spec);
+      return x12Peer().build837P(spec);
     case "I":
-      return build837I(spec);
+      return x12Peer().build837I(spec);
     case "D":
-      return build837D(spec);
+      return x12Peer().build837D(spec);
   }
 }
 function generate837P(options) {
@@ -736,6 +818,8 @@ function generate837I(options) {
 function generate837D(options) {
   return generate837("D", options);
 }
+
+// src/x12/remit-835.ts
 function generate835(options) {
   const rng = createRng(options.seed);
   const partners = x12TradingPartners(rng);
@@ -836,8 +920,10 @@ function generate835(options) {
     },
     claims: [claim]
   };
-  return build835(spec);
+  return x12Peer().build835(spec);
 }
+
+// src/x12/eligibility-271.ts
 function generate271(options) {
   const rng = createRng(options.seed);
   const partners = x12TradingPartners(rng);
@@ -917,13 +1003,15 @@ function generate271(options) {
       }
     ]
   };
-  return build271(spec);
+  return x12Peer().build271(spec);
 }
+
+// src/x12/round-trip.ts
 function roundTrip(interchange) {
-  const content = serializeX12(interchange);
-  const reparsed = parseX12(content);
+  const content = x12Peer().serializeX12(interchange);
+  const reparsed = x12Peer().parseX12(content);
   const warnings = reparsed.warnings.map((w) => String(w.code));
-  const byteStable = serializeX12(reparsed) === content;
+  const byteStable = x12Peer().serializeX12(reparsed) === content;
   return {
     content,
     warnings,
@@ -931,6 +1019,14 @@ function roundTrip(interchange) {
     specClean: warnings.length === 0 && byteStable
   };
 }
+function x12CorpusArtifact(interchange, verify) {
+  const content = x12Peer().serializeX12(interchange);
+  if (!verify) return { content, warnings: UNCHECKED };
+  return {
+    content,
+    warnings: x12Peer().parseX12(content).warnings.map((w) => String(w.code))
+  };
+}
 
 // src/x12/index.ts
 var ALL_KINDS = Object.freeze(["837P", "837I", "837D", "835", "271"]);
@@ -938,26 +1034,26 @@ var DEFAULT_MIX = ALL_KINDS;
 function generateKind(kind, seed) {
   switch (kind) {
     case "835":
-      return roundTrip(generate835({ seed }));
+      return generate835({ seed });
     case "271":
-      return roundTrip(generate271({ seed }));
+      return generate271({ seed });
     case "837P":
-      return roundTrip(generate837("P", { seed }));
+      return generate837("P", { seed });
     case "837I":
-      return roundTrip(generate837("I", { seed }));
+      return generate837("I", { seed });
     case "837D":
-      return roundTrip(generate837("D", { seed }));
+      return generate837("D", { seed });
   }
 }
 function x12Corpus(options) {
-  const { seed } = options;
+  const { seed, verify = true } = options;
   const mix = resolveMix(ALL_KINDS, options.mix, DEFAULT_MIX);
   const count = options.count ?? mix.length;
   const seedStream = createRng(seed);
   const artifacts = Array.from({ length: count }, (_unused, i) => {
     const kind = mix[i % mix.length] ?? "837P";
     const txSeed = seedStream.nextUint32();
-    const rt = generateKind(kind, txSeed);
+    const rt = x12CorpusArtifact(generateKind(kind, txSeed), verify);
     return {
       format: "x12",
       kind,