@cosyte/synth 0.0.3 → 0.0.4

package/dist/deid/index.d.cts

@@ -2,7 +2,7 @@ import { Hl7MessageKind } from '../hl7/index.cjs';
 import { DeidPolicy, GenericLocus } from '@cosyte/deid';
 import '@cosyte/hl7';
 import '../providers-OLz3zAc-.cjs';
-import '../quirk-DmkgoZdh.cjs';
+import '../quirk-DYMDojVw.cjs';
 
 /**
  * The format-agnostic core of the **`@cosyte/deid` pairing loop** — a **closed-loop

package/dist/deid/index.d.ts

@@ -2,7 +2,7 @@ import { Hl7MessageKind } from '../hl7/index.js';
 import { DeidPolicy, GenericLocus } from '@cosyte/deid';
 import '@cosyte/hl7';
 import '../providers-OLz3zAc-.js';
-import '../quirk-JLyO1Ncj.js';
+import '../quirk-C9t9CkPS.js';
 
 /**
  * The format-agnostic core of the **`@cosyte/deid` pairing loop** — a **closed-loop

package/dist/deid/index.mjs

@@ -4,7 +4,7 @@ import { extractX12Loci, deidentifyX12 } from '@cosyte/deid/x12';
 import { extractTelecomLoci, deidentifyTelecom } from '@cosyte/deid/ncpdp';
 import { deidentifyCcda } from '@cosyte/deid/ccda';
 import { serializeResource, complex, list, primitive, decimal } from '@cosyte/fhir';
-import { serializeX12, parseX12, build835, build271, X12Decimal, build837P, build837I, build837D } from '@cosyte/x12';
+import { serializeX12, parseX12, build835, build271, X12Decimal, build837D, build837I, build837P } from '@cosyte/x12';
 import { serializeCcda, buildCcda, NCI_ROUTE, SNOMED_CT, CVX, RXNORM, LOINC } from '@cosyte/ccda';
 import { parseTelecom, serializeTelecom, buildTelecomRequest } from '@cosyte/ncpdp/telecom';
 import { buildMessage } from '@cosyte/hl7';
@@ -41,6 +41,49 @@ function sfc32Next(s) {
   return t >>> 0;
 }
 
+// src/codes.ts
+var SYNTH_FATAL_CODES = {
+  /** 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 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;
@@ -58,7 +101,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);
   }
@@ -66,7 +109,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) {
@@ -436,10 +479,18 @@ function pidSegment(id) {
   ];
 }
 
+// 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;
+}
+
 // src/hl7/adt.ts
+var ADT_TRIGGERS = Object.freeze(["A01", "A04", "A08"]);
 function generateAdt(options = {}) {
   const seed = options.seed ?? 0;
-  const trigger = options.trigger ?? "A01";
+  const trigger = resolveKind(ADT_TRIGGERS, options.trigger ?? "A01");
   const rng = createRng(seed);
   const { message, timestamp } = mshScaffold(rng, `ADT^${trigger}`);
   message.addSegment("EVN", [trigger, timestamp]);
@@ -710,8 +761,19 @@ function generateVxu(options = {}) {
   ]);
   return message;
 }
+
+// src/hl7/index.ts
+var ALL_KINDS = Object.freeze([
+  "ADT^A01",
+  "ADT^A04",
+  "ADT^A08",
+  "ORU^R01",
+  "ORM^O01",
+  "SIU^S12",
+  "VXU^V04"
+]);
 function generateHl7(kind, seed) {
-  switch (kind) {
+  switch (resolveKind(ALL_KINDS, kind)) {
     case "ADT^A01":
       return generateAdt({ seed, trigger: "A01" });
     case "ADT^A04":
@@ -1130,6 +1192,7 @@ var EXAMPLE_ENCOUNTER_CLASSES = Object.freeze([
 ]);
 
 // src/fhir/patient.ts
+var PATIENT_PROFILES = Object.freeze(["base", "us-core"]);
 function ombExtension(url, category) {
   return complex([
     prop("url", str(url)),
@@ -1143,7 +1206,8 @@ function ombExtension(url, category) {
   ]);
 }
 function generatePatient(options = {}) {
-  const { seed = 0, profile = "base" } = options;
+  const { seed = 0 } = options;
+  const profile = resolveKind(PATIENT_PROFILES, options.profile ?? "base");
   const rng = createRng(seed);
   const id = fhirPatientIdentity(rng);
   const usCore = profile === "us-core";
@@ -1526,6 +1590,11 @@ function buildComposition(rng, input) {
 }
 
 // src/fhir/bundle.ts
+var BUNDLE_TYPES = Object.freeze([
+  "collection",
+  "transaction",
+  "document"
+]);
 function resourceTypeOf(resource) {
   const rt = resource.properties.find((p) => p.name === "resourceType");
   return rt !== void 0 && rt.value.kind === "primitive" ? String(rt.value.value) : "Resource";
@@ -1627,7 +1696,8 @@ function documentSections(urls) {
   ];
 }
 function generateBundle(options = {}) {
-  const { seed = 0, type = "collection" } = options;
+  const { seed = 0 } = options;
+  const type = resolveKind(BUNDLE_TYPES, options.type ?? "collection");
   const rng = createRng(seed);
   const spine = buildSpine(rng);
   const members = type === "document" ? [
@@ -1680,7 +1750,7 @@ function generateBundle(options = {}) {
 }
 function dec2(value) {
   const d = X12Decimal.fromString(value);
-  if (d === void 0) throw new Error(`invalid synthetic decimal: ${value}`);
+  if (d === void 0) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_INVALID_DECIMAL);
   return d;
 }
 function money(n) {
@@ -1786,6 +1856,7 @@ var TOOTH_SURFACES = Object.freeze(["M", "O", "D", "B", "L"]);
 var SERVICE_TYPE_CODES = Object.freeze(["30", "1", "35", "88", "98"]);
 
 // src/x12/claim-837.ts
+var CLAIM_837_VARIANTS = Object.freeze(["P", "I", "D"]);
 function serviceDtp(serviceDate2) {
   return { qualifier: "472", formatQualifier: "D8", value: serviceDate2 };
 }
@@ -1968,11 +2039,17 @@ function specOf(rng, variant) {
   };
 }
 function generate837(variant, options) {
+  const resolved = resolveKind(CLAIM_837_VARIANTS, variant);
   const rng = createRng(options.seed);
-  const spec = specOf(rng, variant);
-  if (variant === "P") return build837P(spec);
-  if (variant === "I") return build837I(spec);
-  return build837D(spec);
+  const spec = specOf(rng, resolved);
+  switch (resolved) {
+    case "P":
+      return build837P(spec);
+    case "I":
+      return build837I(spec);
+    case "D":
+      return build837D(spec);
+  }
 }
 function generate837P(options) {
   return generate837("P", options);
@@ -2337,7 +2414,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 };
 }
@@ -2395,6 +2472,7 @@ function ccdaPatientIdentity(rng) {
 }
 
 // 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);
@@ -2477,7 +2555,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));
 }