@cosyte/synth 0.0.3 → 0.0.5

package/dist/ccda/index.d.cts

@@ -1,7 +1,7 @@
 import { S as SyntheticName, a as SyntheticIdentifier, R as Rng, C as Corpus } from '../providers-OLz3zAc-.cjs';
 import { CcdaDocument, BuildCcdaPatient, BuildCode, BuildQuantity } from '@cosyte/ccda';
 import { C as CodeConcept, Q as QuantConcept } from '../example-codes-DeXcnCSK.cjs';
-import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-DmkgoZdh.cjs';
+import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-DYMDojVw.cjs';
 
 /**
  * Synthetic **C-CDA document generation** — a spec-clean Continuity of Care Document
@@ -168,7 +168,8 @@ declare function ccdaPatientIdentity(rng: Rng): CcdaPatientIdentity;
  *
  * @param concept - The FHIR-shaped `{ system, code, display }` concept.
  * @returns The `@cosyte/ccda` `BuildCode`.
- * @throws {Error} When the concept's `system` URI has no known OID mapping.
+ * @throws SynthError `SYNTH_UNMAPPED_CODE_SYSTEM` when the concept's `system` URI has no known OID
+ *   mapping. The refusal does not quote the URI: `concept` is caller-supplied.
  * @example
  * ```ts
  * import { toBuildCode } from "@cosyte/synth/ccda";
@@ -258,7 +259,8 @@ declare const CCDA_QUIRKS: Readonly<Record<CcdaQuirkName, QuirkDescriptor>>;
  * @param quirk - The quirk to inject.
  * @param cleanXml - The spec-clean C-CDA XML.
  * @returns The quirked XML.
- * @throws Error when the quirk found no structural anchor to mutate.
+ * @throws SynthError `SYNTH_UNSUPPORTED_QUIRK` when `quirk` is not a supported C-CDA quirk.
+ * @throws SynthError `SYNTH_QUIRK_ANCHOR_ABSENT` when the quirk found no structural anchor to mutate.
  * @example
  * ```ts
  * import { injectCcdaQuirk } from "@cosyte/synth/ccda";

package/dist/ccda/index.d.ts

@@ -1,7 +1,7 @@
 import { S as SyntheticName, a as SyntheticIdentifier, R as Rng, C as Corpus } from '../providers-OLz3zAc-.js';
 import { CcdaDocument, BuildCcdaPatient, BuildCode, BuildQuantity } from '@cosyte/ccda';
 import { C as CodeConcept, Q as QuantConcept } from '../example-codes-DeXcnCSK.js';
-import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-JLyO1Ncj.js';
+import { Q as QuirkDescriptor, S as SynthProfile, a as QuirkArtifact, b as QuirkRoundTripResult } from '../quirk-C9t9CkPS.js';
 
 /**
  * Synthetic **C-CDA document generation** — a spec-clean Continuity of Care Document
@@ -168,7 +168,8 @@ declare function ccdaPatientIdentity(rng: Rng): CcdaPatientIdentity;
  *
  * @param concept - The FHIR-shaped `{ system, code, display }` concept.
  * @returns The `@cosyte/ccda` `BuildCode`.
- * @throws {Error} When the concept's `system` URI has no known OID mapping.
+ * @throws SynthError `SYNTH_UNMAPPED_CODE_SYSTEM` when the concept's `system` URI has no known OID
+ *   mapping. The refusal does not quote the URI: `concept` is caller-supplied.
  * @example
  * ```ts
  * import { toBuildCode } from "@cosyte/synth/ccda";
@@ -258,7 +259,8 @@ declare const CCDA_QUIRKS: Readonly<Record<CcdaQuirkName, QuirkDescriptor>>;
  * @param quirk - The quirk to inject.
  * @param cleanXml - The spec-clean C-CDA XML.
  * @returns The quirked XML.
- * @throws Error when the quirk found no structural anchor to mutate.
+ * @throws SynthError `SYNTH_UNSUPPORTED_QUIRK` when `quirk` is not a supported C-CDA quirk.
+ * @throws SynthError `SYNTH_QUIRK_ANCHOR_ABSENT` when the quirk found no structural anchor to mutate.
  * @example
  * ```ts
  * import { injectCcdaQuirk } from "@cosyte/synth/ccda";

package/dist/ccda/index.mjs

@@ -29,6 +29,65 @@ function sfc32Next(s) {
   return t >>> 0;
 }
 
+// src/codes.ts
+var SYNTH_FATAL_CODES = {
+  /**
+   * 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",
+  /** 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"
+};
+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).",
+  SYNTH_QUIRK_ANCHOR_ABSENT: "The quirk transform found no structural anchor to mutate, so the fixture would not carry the deviation it is labelled with. Refusing to emit a mislabeled fixture.",
+  SYNTH_INTENDED_WARNING_MISMATCH: "A bare parse of the generated quirk artifact did not produce exactly the declared intended warning code(s). Refusing to emit a mislabeled fixture.",
+  SYNTH_UNMAPPED_CODE_SYSTEM: "The concept's code-system URI has no OID mapping in the C-CDA example-code table.",
+  SYNTH_INVALID_DECIMAL: "The value could not be read as an X12 decimal.",
+  SYNTH_INVALID_RANGE: "An integer range was requested with its maximum below its minimum.",
+  SYNTH_EMPTY_POOL: "A value was drawn from an empty pool.",
+  SYNTH_INVALID_PROFILE: "defineSynthProfile requires a non-empty string name.",
+  SYNTH_UNSUPPORTED_KIND: "The requested kind, document type, corpus mix entry, variant or profile is not one this generator supports. The supported set is the exported union for that option."
+});
+var SynthError = class extends Error {
+  /** The stable fatal code. */
+  code;
+  /**
+   * @param code - The stable {@link SynthFatalCode}. The message comes from the frozen registry.
+   */
+  constructor(code) {
+    super(SYNTH_FATAL_MESSAGES[code]);
+    this.name = "SynthError";
+    this.code = code;
+  }
+};
+
 // src/rng/rng.ts
 var Sfc32Rng = class {
   seed;
@@ -46,7 +105,7 @@ var Sfc32Rng = class {
     return this.nextUint32() / 4294967296;
   }
   int(min, max) {
-    if (max < min) throw new RangeError(`Rng.int: max (${String(max)}) < min (${String(min)})`);
+    if (max < min) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INVALID_RANGE);
     const span = max - min + 1;
     return min + Math.floor(this.float() * span);
   }
@@ -54,7 +113,7 @@ var Sfc32Rng = class {
     return this.float() < p;
   }
   pick(items) {
-    if (items.length === 0) throw new RangeError("Rng.pick: empty array");
+    if (items.length === 0) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_EMPTY_POOL);
     return items[this.int(0, items.length - 1)];
   }
   digits(n) {
@@ -671,7 +730,7 @@ var URI_TO_OID = Object.freeze({
 function toBuildCode(concept) {
   const codeSystem = URI_TO_OID[concept.system];
   if (codeSystem === void 0) {
-    throw new Error(`ccda example-codes: no OID mapping for code system "${concept.system}"`);
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNMAPPED_CODE_SYSTEM);
   }
   return { code: concept.code, codeSystem, displayName: concept.display };
 }
@@ -728,7 +787,19 @@ function ccdaPatientIdentity(rng) {
   return { patient, person, mrn };
 }
 
+// src/select.ts
+function resolveKind(allowed, requested) {
+  const match = allowed.find((value) => value === requested);
+  if (match === void 0) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_KIND);
+  return match;
+}
+function resolveMix(allowed, requested, fallback) {
+  if (requested === void 0) return fallback;
+  return requested.map((entry) => resolveKind(allowed, entry));
+}
+
 // src/ccda/ccd.ts
+var CCDA_DOCUMENT_TYPES = Object.freeze(["ccd", "referralNote"]);
 function pickN(rng, pool, n) {
   const take = Math.min(n, pool.length);
   const indices = pool.map((_v, i) => i);
@@ -811,7 +882,8 @@ function buildInit(rng, documentType) {
   return base;
 }
 function generateCcda(options = {}) {
-  const { seed = 0, documentType = "ccd" } = options;
+  const { seed = 0 } = options;
+  const documentType = resolveKind(CCDA_DOCUMENT_TYPES, options.documentType ?? "ccd");
   const rng = createRng(seed);
   return buildCcda(buildInit(rng, documentType));
 }
@@ -837,7 +909,7 @@ function roundTrip(doc) {
 // src/profile.ts
 function defineSynthProfile(spec) {
   if (typeof spec.name !== "string" || spec.name.trim().length === 0) {
-    throw new TypeError("defineSynthProfile: `name` is required and must be a non-empty string.");
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INVALID_PROFILE);
   }
   return Object.freeze({
     name: spec.name,
@@ -847,28 +919,6 @@ function defineSynthProfile(spec) {
   });
 }
 
-// src/codes.ts
-var SYNTH_FATAL_CODES = {
-  /**
-   * 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"
-};
-var SynthError = class extends Error {
-  /** The stable fatal code. */
-  code;
-  /**
-   * @param code - The stable {@link SynthFatalCode}.
-   * @param message - A human-readable detail (never contains PHI — there is none).
-   */
-  constructor(code, message) {
-    super(message);
-    this.name = "SynthError";
-    this.code = code;
-  }
-};
-
 // src/quirk.ts
 var PROFILE_QUIRK_APPLIED = "PROFILE_QUIRK_APPLIED";
 function sameCodeSet(a, b) {
@@ -885,12 +935,8 @@ function sameCodeSet(a, b) {
 }
 function resolveQuirk(registry, format, name2) {
   const descriptor = registry[name2];
-  if (descriptor === void 0) {
-    const supported = Object.keys(registry).sort().join(", ");
-    throw new SynthError(
-      SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_QUIRK,
-      `${format}: unsupported quirk "${name2}". The ${format} profile system supports: ${supported}.`
-    );
+  if (descriptor === void 0 || descriptor.format !== format) {
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_UNSUPPORTED_QUIRK);
   }
   return descriptor;
 }
@@ -905,11 +951,9 @@ function profileTolerated(disposition, intendedWarnings, warningsUnderProfile) {
       return false;
   }
 }
-function assertIntendedWarnings(quirk, intendedWarnings, bareWarnings) {
+function assertIntendedWarnings(intendedWarnings, bareWarnings) {
   if (!sameCodeSet(bareWarnings, intendedWarnings)) {
-    throw new Error(
-      `quirk "${quirk}": the intended-warning contract does not hold \u2014 expected exactly [${intendedWarnings.join(", ")}] but a bare parse produced [${bareWarnings.join(", ")}]. Refusing to emit a mislabeled fixture.`
-    );
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INTENDED_WARNING_MISMATCH);
   }
 }
 function validateProfileQuirks(profile, registry, format) {
@@ -974,11 +1018,10 @@ function applyQuirk(quirk, xml) {
   }
 }
 function injectCcdaQuirk(quirk, cleanXml) {
-  const content = applyQuirk(quirk, cleanXml);
+  const descriptor = resolveQuirk(CCDA_QUIRKS, "ccda", quirk);
+  const content = applyQuirk(descriptor.name, cleanXml);
   if (content === cleanXml) {
-    throw new Error(
-      `injectCcdaQuirk: quirk "${quirk}" found no structural anchor to mutate \u2014 refusing to emit a fixture that does not carry the intended deviation.`
-    );
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_QUIRK_ANCHOR_ABSENT);
   }
   return content;
 }
@@ -989,7 +1032,6 @@ function generateCcdaQuirk(options) {
   const clean = serializeCcda(generateCcda({ seed, documentType }));
   const content = injectCcdaQuirk(options.quirk, clean);
   assertIntendedWarnings(
-    descriptor.name,
     descriptor.intendedWarnings,
     parseCcda(content).warnings.map((w) => String(w.code))
   );
@@ -1032,6 +1074,7 @@ var ALL_CCDA_QUIRKS = Object.freeze(
 function ccdaQuirkCorpus(options) {
   const quirks = options.profile ? validateProfileQuirks(options.profile, CCDA_QUIRKS, "ccda") : options.quirks ?? ALL_CCDA_QUIRKS;
   const names = quirks.length > 0 ? quirks : ALL_CCDA_QUIRKS;
+  for (const name2 of names) resolveQuirk(CCDA_QUIRKS, "ccda", name2);
   const documentType = options.documentType ?? "ccd";
   const count = options.count ?? names.length;
   const seedStream = createRng(options.seed);
@@ -1054,9 +1097,11 @@ var ccdaQuirkProfile = defineSynthProfile({
 });
 
 // src/ccda/index.ts
-var DEFAULT_MIX = Object.freeze(["ccd", "referralNote"]);
+var ALL_KINDS = Object.freeze(["ccd", "referralNote"]);
+var DEFAULT_MIX = ALL_KINDS;
 function ccdaCorpus(options) {
-  const { seed, count = 1, mix = DEFAULT_MIX } = options;
+  const { seed, count = 1 } = 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";