@cosyte/synth 0.1.4 → 0.1.6

package/dist/ccda/index.d.cts

@@ -362,6 +362,12 @@ interface CcdaCorpusOptions {
     readonly count?: number;
     /** The document types to cycle through. Defaults to one CCD + one Referral Note. */
     readonly mix?: readonly CcdaCorpusKind[];
+    /**
+     * 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 C-CDA documents. Each document is generated from a

package/dist/ccda/index.d.ts

@@ -362,6 +362,12 @@ interface CcdaCorpusOptions {
     readonly count?: number;
     /** The document types to cycle through. Defaults to one CCD + one Referral Note. */
     readonly mix?: readonly CcdaCorpusKind[];
+    /**
+     * 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 C-CDA documents. Each document is generated from a

package/dist/ccda/index.mjs

@@ -1,4 +1,12 @@
-import { SNOMED_CT, NCI_ROUTE, buildCcda, serializeCcda, parseCcda, CVX, RXNORM, LOINC, ccdaProfiles } from '@cosyte/ccda';
+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,7 +38,16 @@ 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.
@@ -49,6 +66,8 @@ var SYNTH_FATAL_CODES = {
   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. */
@@ -61,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).",
@@ -127,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();
@@ -737,6 +767,16 @@ Object.freeze([
 ]);
 
 // src/ccda/example-codes.ts
+var LOINC_OID = "2.16.840.1.113883.6.1";
+var SNOMED_CT_OID = "2.16.840.1.113883.6.96";
+var RXNORM_OID = "2.16.840.1.113883.6.88";
+var CVX_OID = "2.16.840.1.113883.12.292";
+var NCI_ROUTE_OID = "2.16.840.1.113883.3.26.1.1";
+var LOINC = LOINC_OID;
+var SNOMED_CT = SNOMED_CT_OID;
+var RXNORM = RXNORM_OID;
+var CVX = CVX_OID;
+var NCI_ROUTE = NCI_ROUTE_OID;
 var URI_TO_OID = Object.freeze({
   "http://loinc.org": LOINC,
   "http://snomed.info/sct": SNOMED_CT,
@@ -813,6 +853,28 @@ function resolveMix(allowed, requested, fallback) {
   if (requested === void 0) return fallback;
   return requested.map((entry) => resolveKind(allowed, entry));
 }
+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 ccdaPeer = lazyPeer("@cosyte/ccda");
 
 // src/ccda/ccd.ts
 var CCDA_DOCUMENT_TYPES = Object.freeze(["ccd", "referralNote"]);
@@ -901,7 +963,7 @@ function generateCcda(options = {}) {
   const { seed = 0 } = options;
   const documentType = resolveKind(CCDA_DOCUMENT_TYPES, options.documentType ?? "ccd");
   const rng = createRng(seed);
-  return buildCcda(buildInit(rng, documentType));
+  return ccdaPeer().buildCcda(buildInit(rng, documentType));
 }
 function generateCcd(options = {}) {
   return generateCcda({ ...options, documentType: "ccd" });
@@ -909,11 +971,13 @@ function generateCcd(options = {}) {
 function generateReferralNote(options = {}) {
   return generateCcda({ ...options, documentType: "referralNote" });
 }
+
+// src/ccda/round-trip.ts
 function roundTrip(doc) {
-  const content = serializeCcda(doc);
-  const reparsed = parseCcda(content);
+  const content = ccdaPeer().serializeCcda(doc);
+  const reparsed = ccdaPeer().parseCcda(content);
   const warnings = reparsed.warnings.map((w) => String(w.code));
-  const byteStable = serializeCcda(reparsed) === content;
+  const byteStable = ccdaPeer().serializeCcda(reparsed) === content;
   return {
     content,
     warnings,
@@ -921,6 +985,14 @@ function roundTrip(doc) {
     specClean: warnings.length === 0 && byteStable
   };
 }
+function ccdaCorpusArtifact(doc, verify) {
+  const content = ccdaPeer().serializeCcda(doc);
+  if (!verify) return { content, warnings: UNCHECKED };
+  return {
+    content,
+    warnings: ccdaPeer().parseCcda(content).warnings.map((w) => String(w.code))
+  };
+}
 
 // src/profile.ts
 function defineSynthProfile(spec) {
@@ -1005,7 +1077,7 @@ var CCDA_QUIRKS = Object.freeze({
   })
 });
 function toleratingProfile(quirk) {
-  return quirk === "template-extension-absent" ? ccdaProfiles.legacyR11 : ccdaProfiles.smartScorecard;
+  return quirk === "template-extension-absent" ? ccdaPeer().ccdaProfiles.legacyR11 : ccdaPeer().ccdaProfiles.smartScorecard;
 }
 var DOC_TEMPLATE_ROOTS = [
   "2.16.840.1.113883.10.20.22.1.1",
@@ -1045,11 +1117,11 @@ function generateCcdaQuirk(options) {
   const seed = options.seed ?? 0;
   const documentType = options.documentType ?? "ccd";
   const descriptor = resolveQuirk(CCDA_QUIRKS, "ccda", options.quirk);
-  const clean = serializeCcda(generateCcda({ seed, documentType }));
+  const clean = ccdaPeer().serializeCcda(generateCcda({ seed, documentType }));
   const content = injectCcdaQuirk(options.quirk, clean);
   assertIntendedWarnings(
     descriptor.intendedWarnings,
-    parseCcda(content).warnings.map((w) => String(w.code))
+    ccdaPeer().parseCcda(content).warnings.map((w) => String(w.code))
   );
   return Object.freeze({
     format: "ccda",
@@ -1062,17 +1134,16 @@ function generateCcdaQuirk(options) {
 function ccdaQuirkRoundTrip(artifact) {
   const quirk = artifact.quirk;
   const descriptor = resolveQuirk(CCDA_QUIRKS, "ccda", quirk);
-  const bare = parseCcda(artifact.content).warnings.map((w) => String(w.code));
+  const bare = ccdaPeer().parseCcda(artifact.content).warnings.map((w) => String(w.code));
   const profile = toleratingProfile(quirk);
-  const profiledWarnings = parseCcda(artifact.content, { profile }).warnings.map(
-    (w) => String(w.code)
-  );
+  const profiledWarnings = ccdaPeer().parseCcda(artifact.content, { profile }).warnings.map((w) => String(w.code));
   return {
     content: artifact.content,
     warnings: bare,
     intendedWarnings: artifact.intendedWarnings,
     intendedWarningHeld: sameCodeSet(bare, artifact.intendedWarnings),
     withProfile: {
+      /* v8 ignore next -- the `?? profile.name` is unreachable: every descriptor in the frozen CCDA_QUIRKS names its toleratingProfile */
       profileName: descriptor.toleratingProfile ?? profile.name,
       disposition: descriptor.disposition,
       warnings: profiledWarnings,
@@ -1116,13 +1187,13 @@ var ccdaQuirkProfile = defineSynthProfile({
 var ALL_KINDS = Object.freeze(["ccd", "referralNote"]);
 var DEFAULT_MIX = ALL_KINDS;
 function ccdaCorpus(options) {
-  const { seed, count = 1 } = options;
+  const { seed, count = 1, verify = true } = options;
   const mix = resolveMix(ALL_KINDS, options.mix, DEFAULT_MIX);
   const seedStream = createRng(seed);
   const artifacts = Array.from({ length: count }, (_unused, i) => {
     const documentType = mix[i % mix.length] ?? "ccd";
     const docSeed = seedStream.nextUint32();
-    const rt = roundTrip(generateCcda({ seed: docSeed, documentType }));
+    const rt = ccdaCorpusArtifact(generateCcda({ seed: docSeed, documentType }), verify);
     return {
       format: "ccda",
       kind: documentType,