@cosyte/synth 0.0.1

package/dist/hl7/index.mjs

@@ -0,0 +1,990 @@
+import { buildMessage, parseHL7, profiles } from '@cosyte/hl7';
+
+// src/rng/splitmix32.ts
+function splitmix32(seed) {
+  let a = seed | 0;
+  return function next() {
+    a = a + 2654435769 | 0;
+    let t = a ^ a >>> 16;
+    t = Math.imul(t, 569420461);
+    t = t ^ t >>> 15;
+    t = Math.imul(t, 1935289751);
+    t = t ^ t >>> 15;
+    return t >>> 0;
+  };
+}
+
+// src/rng/sfc32.ts
+function sfc32Next(s) {
+  s.a |= 0;
+  s.b |= 0;
+  s.c |= 0;
+  s.d |= 0;
+  const t = (s.a + s.b | 0) + s.d | 0;
+  s.d = s.d + 1 | 0;
+  s.a = s.b ^ s.b >>> 9;
+  s.b = s.c + (s.c << 3) | 0;
+  s.c = s.c << 21 | s.c >>> 11;
+  s.c = s.c + t | 0;
+  return t >>> 0;
+}
+
+// src/rng/rng.ts
+var Sfc32Rng = class {
+  seed;
+  #state;
+  constructor(seed) {
+    this.seed = seed | 0;
+    const mix = splitmix32(this.seed);
+    this.#state = { a: mix(), b: mix(), c: mix(), d: mix() };
+    for (let i = 0; i < 8; i += 1) sfc32Next(this.#state);
+  }
+  nextUint32() {
+    return sfc32Next(this.#state);
+  }
+  float() {
+    return this.nextUint32() / 4294967296;
+  }
+  int(min, max) {
+    if (max < min) throw new RangeError(`Rng.int: max (${String(max)}) < min (${String(min)})`);
+    const span = max - min + 1;
+    return min + Math.floor(this.float() * span);
+  }
+  bool(p = 0.5) {
+    return this.float() < p;
+  }
+  pick(items) {
+    if (items.length === 0) throw new RangeError("Rng.pick: empty array");
+    return items[this.int(0, items.length - 1)];
+  }
+  digits(n) {
+    let out = "";
+    for (let i = 0; i < n; i += 1) out += String(this.int(0, 9));
+    return out;
+  }
+};
+function createRng(seed) {
+  return new Sfc32Rng(seed);
+}
+
+// src/corpus.ts
+function makeCorpus(seed, artifacts, quirks = []) {
+  const counts = {};
+  const formats = /* @__PURE__ */ new Set();
+  const frozenArtifacts = artifacts.map((a) => {
+    counts[a.kind] = (counts[a.kind] ?? 0) + 1;
+    formats.add(a.format);
+    return Object.freeze({ ...a, warnings: Object.freeze([...a.warnings]) });
+  });
+  const manifest = Object.freeze({
+    formats: Object.freeze([...formats]),
+    counts: Object.freeze(counts),
+    quirks: Object.freeze([...quirks])
+  });
+  return Object.freeze({
+    seed,
+    manifest,
+    artifacts: Object.freeze(frozenArtifacts)
+  });
+}
+
+// src/hl7/field.ts
+function componentsField(components) {
+  return {
+    repetitions: [{ components: components.map((c) => ({ subcomponents: [c] })) }],
+    isNull: false
+  };
+}
+
+// src/safe/reserved.ts
+var SYNTHETIC_ASSIGNING_AUTHORITY = Object.freeze({
+  /** The human-readable assigning-authority namespace id (HL7 HD.1). */
+  namespaceId: "COSYTE-SYNTH",
+  /** The universal id — an OID under HL7's example arc `2.16.840.1.113883.19` (HD.2). */
+  universalId: "2.16.840.1.113883.19.999",
+  /** The universal id type (HD.3). */
+  universalIdType: "ISO"
+});
+var RESERVED_EMAIL_DOMAINS = Object.freeze([
+  "example.com",
+  "example.org",
+  "example.net"
+]);
+var TEST_NET_V4_PREFIXES = Object.freeze([
+  "192.0.2",
+  // TEST-NET-1
+  "198.51.100",
+  // TEST-NET-2
+  "203.0.113"
+  // TEST-NET-3
+]);
+var DOC_V6_PREFIX = "2001:db8";
+var NPI_LUHN_PREFIX = "80840";
+function luhnMod10(digits) {
+  let sum = 0;
+  let double = false;
+  for (let i = digits.length - 1; i >= 0; i -= 1) {
+    let d = digits.charCodeAt(i) - 48;
+    if (d < 0 || d > 9) continue;
+    if (double) {
+      d *= 2;
+      if (d > 9) d -= 9;
+    }
+    sum += d;
+    double = !double;
+  }
+  return sum % 10;
+}
+function npiCheckDigit(base9) {
+  const partial = luhnMod10(`${NPI_LUHN_PREFIX}${base9}0`);
+  return (10 - partial) % 10;
+}
+var DEA_REGISTRANT_TYPES = Object.freeze([
+  "A",
+  "B",
+  "F",
+  "G",
+  "M",
+  "P",
+  "R",
+  "X"
+]);
+function deaCheckDigit(base6) {
+  let odd = 0;
+  let even = 0;
+  for (let i = 0; i < 6; i += 1) {
+    const digit = base6.charCodeAt(i) - 48;
+    if (i % 2 === 0) odd += digit;
+    else even += digit;
+  }
+  return (odd + 2 * even) % 10;
+}
+
+// src/safe/names-pool.ts
+var SYNTHETIC_GIVEN_NAMES = Object.freeze([
+  "Testina",
+  "Fixtura",
+  "Synthos",
+  "Placeholda",
+  "Sampleton",
+  "Prototius",
+  "Stubbina",
+  "Exampla",
+  "Quilliam",
+  "Fabrica",
+  "Simula",
+  "Testry",
+  "Seedwin",
+  "Corpora",
+  "Reprodo",
+  "Mocktavia",
+  "Dummett",
+  "Voidwin",
+  "Deteria",
+  "Randomir"
+]);
+var SYNTHETIC_FAMILY_NAMES = Object.freeze([
+  "Testerson",
+  "Fauxman",
+  "Placeholt",
+  "Mockridge",
+  "Fixtingham",
+  "Synthwell",
+  "Dummerton",
+  "Examplewood",
+  "Fabricant",
+  "Simulacre",
+  "Nonesuch",
+  "Seedman",
+  "Corpusworth",
+  "Reprodus",
+  "Voidmark",
+  "Deterwood",
+  "Randomson",
+  "Quillfeather",
+  "Notreal",
+  "Genfield"
+]);
+var SYNTHETIC_STREET_NAMES = Object.freeze([
+  "Fixture Lane",
+  "Sample Street",
+  "Placeholder Avenue",
+  "Synthetic Way",
+  "Example Boulevard",
+  "Testing Terrace",
+  "Mock Road",
+  "Prototype Court"
+]);
+var SYNTHETIC_CITY_NAMES = Object.freeze([
+  "Faketon",
+  "Synthville",
+  "Exampleburg",
+  "Testford",
+  "Mockhaven",
+  "Fixtureton"
+]);
+
+// src/safe/providers.ts
+function ssn(rng, block = "never-issued") {
+  if (block === "advertising") {
+    return `987-65-432${String(rng.int(0, 9))}`;
+  }
+  const area = rng.int(900, 999);
+  const group = rng.digits(2);
+  const serial = rng.digits(4);
+  return `${String(area)}-${group}-${serial}`;
+}
+function phone(rng) {
+  const area = `${String(rng.int(2, 9))}${rng.digits(2)}`;
+  const line = `01${rng.digits(2)}`;
+  return `(${area}) 555-${line}`;
+}
+function name(rng) {
+  return { given: rng.pick(SYNTHETIC_GIVEN_NAMES), family: rng.pick(SYNTHETIC_FAMILY_NAMES) };
+}
+function email(rng, person) {
+  const domain = rng.pick(RESERVED_EMAIL_DOMAINS);
+  const slug = person ? `${person.given}.${person.family}`.toLowerCase() : `synth${rng.digits(6)}`;
+  return `${slug}@${domain}`;
+}
+function ipv4(rng) {
+  return `${rng.pick(TEST_NET_V4_PREFIXES)}.${String(rng.int(1, 254))}`;
+}
+function ipv6(rng) {
+  const tail = rng.nextUint32().toString(16).padStart(4, "0").slice(-4);
+  return `${DOC_V6_PREFIX}::${tail}`;
+}
+function uuid(rng) {
+  const bytes = new Uint8Array(16);
+  for (let i = 0; i < 16; i += 1) bytes[i] = rng.int(0, 255);
+  bytes[6] = (bytes[6] ?? 0) & 15 | 64;
+  bytes[8] = (bytes[8] ?? 0) & 63 | 128;
+  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, "0"));
+  return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10, 16).join("")}`;
+}
+function npi(rng) {
+  const base9 = rng.digits(9);
+  const wrongCheck = (npiCheckDigit(base9) + 1) % 10;
+  return `${base9}${String(wrongCheck)}`;
+}
+function dea(rng, person) {
+  const type = rng.pick(DEA_REGISTRANT_TYPES);
+  const initialSource = person?.family ?? rng.pick(SYNTHETIC_FAMILY_NAMES);
+  const initial = initialSource.slice(0, 1).toUpperCase();
+  const base6 = rng.digits(6);
+  const wrongCheck = (deaCheckDigit(base6) + 1) % 10;
+  return `${type}${initial}${base6}${String(wrongCheck)}`;
+}
+function identifier(rng, typeCode = "MR") {
+  return {
+    value: rng.digits(8),
+    typeCode,
+    assigningAuthority: SYNTHETIC_ASSIGNING_AUTHORITY.namespaceId,
+    assigningAuthorityOid: SYNTHETIC_ASSIGNING_AUTHORITY.universalId
+  };
+}
+function address(rng) {
+  const number = rng.int(1, 9999);
+  return {
+    street: `${String(number)} ${rng.pick(SYNTHETIC_STREET_NAMES)}`,
+    city: rng.pick(SYNTHETIC_CITY_NAMES),
+    state: rng.pick(US_STATES),
+    zip: "00000"
+  };
+}
+function dateYmd(rng, minYear = 1930, maxYear = 2010) {
+  const year = rng.int(minYear, maxYear);
+  const month = rng.int(1, 12);
+  const daysInMonth = new Date(Date.UTC(year, month, 0)).getUTCDate();
+  const day = rng.int(1, daysInMonth);
+  return `${String(year).padStart(4, "0")}${String(month).padStart(2, "0")}${String(day).padStart(2, "0")}`;
+}
+var US_STATES = Object.freeze([
+  "AL",
+  "AK",
+  "AZ",
+  "AR",
+  "CA",
+  "CO",
+  "CT",
+  "DE",
+  "FL",
+  "GA",
+  "HI",
+  "ID",
+  "IL",
+  "IN",
+  "IA",
+  "KS",
+  "KY",
+  "LA",
+  "ME",
+  "MD",
+  "MA",
+  "MI",
+  "MN",
+  "MS",
+  "MO",
+  "MT",
+  "NE",
+  "NV",
+  "NH",
+  "NJ",
+  "NM",
+  "NY",
+  "NC",
+  "ND",
+  "OH",
+  "OK",
+  "OR",
+  "PA",
+  "RI",
+  "SC",
+  "SD",
+  "TN",
+  "TX",
+  "UT",
+  "VT",
+  "VA",
+  "WA",
+  "WV",
+  "WI",
+  "WY"
+]);
+
+// src/safe/index.ts
+var safe = Object.freeze({
+  ssn,
+  phone,
+  name,
+  email,
+  ipv4,
+  ipv6,
+  uuid,
+  identifier,
+  address,
+  dateYmd,
+  npi,
+  dea
+});
+
+// src/hl7/common.ts
+function seededTimestamp(rng) {
+  const date = safe.dateYmd(rng, 2020, 2025);
+  const hh = String(rng.int(0, 23)).padStart(2, "0");
+  const mm = String(rng.int(0, 59)).padStart(2, "0");
+  const ss = String(rng.int(0, 59)).padStart(2, "0");
+  return `${date}${hh}${mm}${ss}`;
+}
+function mshScaffold(rng, type) {
+  const timestamp = seededTimestamp(rng);
+  const controlId = `SYNTH${rng.digits(10)}`;
+  const message = buildMessage({
+    type,
+    sendingApp: "COSYTE-SYNTH",
+    sendingFacility: "SYNTH-FAC",
+    receivingApp: "RECEIVER",
+    receivingFacility: "RECV-FAC",
+    controlId,
+    timestamp,
+    version: "2.5",
+    processingId: "P"
+  });
+  return { message, timestamp, controlId };
+}
+function patientIdentity(rng) {
+  const person = safe.name(rng);
+  const mrn = safe.identifier(rng, "MR");
+  const dob = safe.dateYmd(rng, 1930, 2010);
+  const sex = rng.pick(["M", "F"]);
+  const address2 = safe.address(rng);
+  const phone2 = safe.phone(rng);
+  const ssnDigits = safe.ssn(rng).replace(/-/g, "");
+  return { person, mrn, dob, sex, address: address2, phone: phone2, ssnDigits };
+}
+function pidSegment(id) {
+  return [
+    "1",
+    // PID-1 set id
+    "",
+    // PID-2 (legacy, absent)
+    componentsField([id.mrn.value, "", "", id.mrn.assigningAuthority, id.mrn.typeCode]),
+    // PID-3 CX
+    "",
+    // PID-4
+    componentsField([id.person.family, id.person.given]),
+    // PID-5 XPN
+    "",
+    // PID-6
+    id.dob,
+    // PID-7 DOB
+    id.sex,
+    // PID-8 sex
+    "",
+    // PID-9
+    "",
+    // PID-10
+    componentsField([id.address.street, "", id.address.city, id.address.state, id.address.zip]),
+    // PID-11 XAD
+    "",
+    // PID-12
+    id.phone,
+    // PID-13 phone
+    "",
+    // PID-14
+    "",
+    // PID-15
+    "",
+    // PID-16
+    "",
+    // PID-17
+    "",
+    // PID-18
+    id.ssnDigits
+    // PID-19 SSN (digits)
+  ];
+}
+
+// src/hl7/adt.ts
+function generateAdt(options = {}) {
+  const seed = options.seed ?? 0;
+  const trigger = options.trigger ?? "A01";
+  const rng = createRng(seed);
+  const { message, timestamp } = mshScaffold(rng, `ADT^${trigger}`);
+  message.addSegment("EVN", [trigger, timestamp]);
+  message.addSegment("PID", pidSegment(patientIdentity(rng)));
+  const patientClass = rng.pick(["I", "O", "E"]);
+  message.addSegment("PV1", [
+    "1",
+    // PV1-1 set id
+    patientClass,
+    // PV1-2 patient class
+    componentsField(["SYNTHWARD", String(rng.int(1, 999)).padStart(3, "0"), "01"])
+    // PV1-3 PL
+  ]);
+  return message;
+}
+
+// src/hl7/example-codes.ts
+var EXAMPLE_LAB_OBSERVATIONS = Object.freeze([
+  Object.freeze({ code: "4548-4", text: "Hemoglobin A1c", system: "LN", units: "%" }),
+  Object.freeze({ code: "718-7", text: "Hemoglobin", system: "LN", units: "g/dL" }),
+  Object.freeze({ code: "2345-7", text: "Glucose", system: "LN", units: "mg/dL" }),
+  Object.freeze({ code: "2951-2", text: "Sodium", system: "LN", units: "mmol/L" }),
+  Object.freeze({ code: "2823-3", text: "Potassium", system: "LN", units: "mmol/L" }),
+  Object.freeze({ code: "789-8", text: "Erythrocytes", system: "LN", units: "10*6/uL" })
+]);
+var EXAMPLE_ORDER_SERVICES = Object.freeze([
+  Object.freeze({ code: "24323-8", text: "Comprehensive metabolic panel", system: "LN" }),
+  Object.freeze({ code: "58410-2", text: "CBC panel", system: "LN" }),
+  Object.freeze({ code: "24356-8", text: "Urinalysis panel", system: "LN" }),
+  Object.freeze({ code: "24331-1", text: "Lipid panel", system: "LN" })
+]);
+var EXAMPLE_VACCINES = Object.freeze([
+  Object.freeze({ code: "08", text: "Hep B, adolescent or pediatric", system: "CVX" }),
+  Object.freeze({ code: "20", text: "DTaP", system: "CVX" }),
+  Object.freeze({ code: "03", text: "MMR", system: "CVX" }),
+  Object.freeze({ code: "10", text: "IPV", system: "CVX" }),
+  Object.freeze({ code: "141", text: "Influenza, seasonal, injectable", system: "CVX" }),
+  Object.freeze({ code: "21", text: "Varicella", system: "CVX" })
+]);
+
+// src/hl7/oru.ts
+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);
+  return [
+    String(setId),
+    // OBX-1 set id
+    "NM",
+    // OBX-2 value type (numeric)
+    componentsField([obs.code, obs.text, obs.system]),
+    // OBX-3 observation identifier (CE)
+    "",
+    // OBX-4 observation sub-id
+    value,
+    // OBX-5 observation value
+    obs.units ?? "",
+    // OBX-6 units
+    "",
+    // OBX-7 reference range
+    "N",
+    // OBX-8 abnormal flags (normal)
+    "",
+    // OBX-9
+    "",
+    // OBX-10
+    "F",
+    // OBX-11 observation result status (final)
+    "",
+    // OBX-12
+    "",
+    // OBX-13
+    observedAt
+    // OBX-14 date/time of the observation
+  ];
+}
+function generateOru(options = {}) {
+  const seed = options.seed ?? 0;
+  const rng = createRng(seed);
+  const { message } = mshScaffold(rng, "ORU^R01");
+  message.addSegment("PID", pidSegment(patientIdentity(rng)));
+  const service = rng.pick(EXAMPLE_ORDER_SERVICES);
+  const placer = rng.digits(8);
+  const filler = rng.digits(8);
+  message.addSegment("OBR", [
+    "1",
+    // OBR-1 set id
+    placer,
+    // OBR-2 placer order number
+    filler,
+    // OBR-3 filler order number
+    componentsField([service.code, service.text, service.system]),
+    // OBR-4 universal service id (CE)
+    "",
+    // OBR-5
+    "",
+    // OBR-6
+    seededTimestamp(rng)
+    // OBR-7 observation date/time
+  ]);
+  const obxCount = rng.int(1, 3);
+  for (let i = 1; i <= obxCount; i += 1) {
+    message.addSegment("OBX", obxSegment(rng, i));
+  }
+  return message;
+}
+
+// src/hl7/orm.ts
+function generateOrm(options = {}) {
+  const seed = options.seed ?? 0;
+  const rng = createRng(seed);
+  const { message } = mshScaffold(rng, "ORM^O01");
+  message.addSegment("PID", pidSegment(patientIdentity(rng)));
+  const service = rng.pick(EXAMPLE_ORDER_SERVICES);
+  const placer = rng.digits(8);
+  const filler = rng.digits(8);
+  const orderedAt = seededTimestamp(rng);
+  message.addSegment("ORC", [
+    "NW",
+    // ORC-1 order control (new order)
+    placer,
+    // ORC-2 placer order number
+    filler,
+    // ORC-3 filler order number
+    "",
+    // ORC-4 placer group number
+    "",
+    // ORC-5 order status
+    "",
+    // ORC-6
+    "",
+    // ORC-7 quantity/timing
+    "",
+    // ORC-8
+    orderedAt
+    // ORC-9 date/time of transaction
+  ]);
+  message.addSegment("OBR", [
+    "1",
+    // OBR-1 set id
+    placer,
+    // OBR-2 placer order number (matches ORC)
+    filler,
+    // OBR-3 filler order number (matches ORC)
+    componentsField([service.code, service.text, service.system])
+    // OBR-4 universal service id (CE)
+  ]);
+  return message;
+}
+
+// src/hl7/siu.ts
+function generateSiu(options = {}) {
+  const seed = options.seed ?? 0;
+  const rng = createRng(seed);
+  const { message } = mshScaffold(rng, "SIU^S12");
+  const placerAppt = rng.digits(8);
+  const fillerAppt = rng.digits(8);
+  const startAt = seededTimestamp(rng);
+  const durationMinutes = String(rng.int(15, 90));
+  message.addSegment("SCH", [
+    placerAppt,
+    // SCH-1 placer appointment id
+    fillerAppt,
+    // SCH-2 filler appointment id
+    "",
+    // SCH-3 occurrence number
+    "",
+    // SCH-4 placer group number
+    "",
+    // SCH-5 schedule id
+    "",
+    // SCH-6 event reason
+    componentsField(["ROUTINE", "Routine appointment", "L"]),
+    // SCH-7 appointment reason (CE)
+    "",
+    // SCH-8 appointment type
+    durationMinutes,
+    // SCH-9 appointment duration
+    componentsField(["min", "minutes", "UCUM"]),
+    // SCH-10 appointment duration units (CE)
+    componentsField(["1", "", startAt, "", "", "", durationMinutes])
+    // SCH-11 appointment timing quantity (TQ)
+  ]);
+  message.addSegment("PID", pidSegment(patientIdentity(rng)));
+  message.addSegment("RGS", [
+    "1",
+    // RGS-1 set id
+    "A"
+    // RGS-2 segment action code (add)
+  ]);
+  message.addSegment("AIL", [
+    "1",
+    // AIL-1 set id
+    "A",
+    // AIL-2 segment action code
+    componentsField(["SYNTHCLINIC", "Synthetic Clinic", "COSYTE-SYNTH"])
+    // AIL-3 location resource id
+  ]);
+  return message;
+}
+
+// src/hl7/vxu.ts
+function generateVxu(options = {}) {
+  const seed = options.seed ?? 0;
+  const rng = createRng(seed);
+  const { message } = mshScaffold(rng, "VXU^V04");
+  message.addSegment("PID", pidSegment(patientIdentity(rng)));
+  const placer = rng.digits(8);
+  const filler = rng.digits(8);
+  message.addSegment("ORC", [
+    "RE",
+    // ORC-1 order control (observation to follow / record)
+    placer,
+    // ORC-2 placer order number
+    filler
+    // ORC-3 filler order number
+  ]);
+  const vaccine = rng.pick(EXAMPLE_VACCINES);
+  const administeredAt = seededTimestamp(rng);
+  const doseAmount = String(rng.int(1, 5) / 10);
+  message.addSegment("RXA", [
+    "0",
+    // RXA-1 give sub-id counter
+    "1",
+    // RXA-2 administration sub-id counter
+    administeredAt,
+    // RXA-3 date/time start of administration
+    administeredAt,
+    // RXA-4 date/time end of administration
+    componentsField([vaccine.code, vaccine.text, vaccine.system]),
+    // RXA-5 administered code (CE)
+    doseAmount,
+    // RXA-6 administered amount
+    componentsField(["mL", "milliliters", "UCUM"]),
+    // RXA-7 administered units (CE)
+    "",
+    // RXA-8
+    "",
+    // RXA-9 administration notes
+    "",
+    // RXA-10
+    "",
+    // RXA-11
+    "",
+    // RXA-12
+    "",
+    // RXA-13
+    "",
+    // RXA-14
+    "",
+    // RXA-15 substance lot number
+    "",
+    // RXA-16
+    "",
+    // RXA-17
+    "",
+    // RXA-18
+    "",
+    // RXA-19
+    "CP"
+    // RXA-20 completion status (complete)
+  ]);
+  message.addSegment("RXR", [
+    componentsField(["IM", "Intramuscular", "HL70162"]),
+    // RXR-1 route (CE)
+    componentsField(["LD", "Left Deltoid", "HL70163"])
+    // RXR-2 administration site (CE)
+  ]);
+  return message;
+}
+function roundTrip(message) {
+  const content = message.toString();
+  const reparsed = parseHL7(content);
+  const warnings = reparsed.warnings.map((w) => String(w.code));
+  const byteStable = reparsed.toString() === content;
+  return {
+    content,
+    warnings,
+    byteStable,
+    specClean: warnings.length === 0 && byteStable
+  };
+}
+
+// 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.");
+  }
+  return Object.freeze({
+    name: spec.name,
+    ...spec.givenNames ? { givenNames: Object.freeze([...spec.givenNames]) } : {},
+    ...spec.familyNames ? { familyNames: Object.freeze([...spec.familyNames]) } : {},
+    quirks: Object.freeze([...spec.quirks ?? []])
+  });
+}
+
+// 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) {
+  if (a.length !== b.length) return false;
+  const counts = /* @__PURE__ */ new Map();
+  for (const c of a) counts.set(c, (counts.get(c) ?? 0) + 1);
+  for (const c of b) {
+    const n = counts.get(c);
+    if (n === void 0) return false;
+    if (n === 1) counts.delete(c);
+    else counts.set(c, n - 1);
+  }
+  return counts.size === 0;
+}
+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}.`
+    );
+  }
+  return descriptor;
+}
+function profileTolerated(disposition, intendedWarnings, warningsUnderProfile) {
+  const stillHasIntended = intendedWarnings.some((c) => warningsUnderProfile.includes(c));
+  switch (disposition) {
+    case "suppressed":
+      return !stillHasIntended;
+    case "rebadged":
+      return !stillHasIntended && warningsUnderProfile.includes(PROFILE_QUIRK_APPLIED);
+    case "bare":
+      return false;
+  }
+}
+function assertIntendedWarnings(quirk, 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.`
+    );
+  }
+}
+function validateProfileQuirks(profile, registry, format) {
+  for (const name2 of profile.quirks) resolveQuirk(registry, format, name2);
+  return profile.quirks;
+}
+
+// src/hl7/quirk.ts
+var HL7_QUIRKS = Object.freeze({
+  "unknown-zsegment": Object.freeze({
+    name: "unknown-zsegment",
+    format: "hl7v2",
+    intendedWarnings: Object.freeze(["UNKNOWN_SEGMENT"]),
+    grounding: "HL7 v2.x \xA72.5 site-defined Z-segments; grounded on @cosyte/hl7's public imaging/PACS profiles (Visage 7 / Philips Vue PACS / VA Radiology interface specs) which declare the ZDS segment.",
+    toleratingProfile: "visage",
+    disposition: "suppressed"
+  }),
+  "unknown-escape": Object.freeze({
+    name: "unknown-escape",
+    format: "hl7v2",
+    intendedWarnings: Object.freeze(["UNKNOWN_ESCAPE_SEQUENCE"]),
+    grounding: "HL7 v2.x \xA72.7 escaping \u2014 a locally-defined \\Z..\\ escape is preserved verbatim and flagged. HL7 v2 has no profile re-badge, so no built-in profile downgrades it.",
+    disposition: "bare"
+  })
+});
+function toleratingProfile(quirk) {
+  return quirk === "unknown-zsegment" ? profiles.visage : void 0;
+}
+function segmentsOf(wire) {
+  return wire.split(/\r\n|\r|\n/).filter((s) => s.length > 0);
+}
+function applyQuirk(quirk, wire) {
+  const segments = segmentsOf(wire);
+  switch (quirk) {
+    case "unknown-zsegment":
+      return [...segments, "ZDS|1|SYNTHETIC-Z-SEGMENT^COSYTE-SYNTH"].join("\r");
+    case "unknown-escape":
+      return [...segments, "NTE|1||\\Zff\\"].join("\r");
+  }
+}
+function baseMessage(kind, seed) {
+  switch (kind) {
+    case "ADT^A01":
+      return generateAdt({ seed, trigger: "A01" });
+    case "ADT^A04":
+      return generateAdt({ seed, trigger: "A04" });
+    case "ADT^A08":
+      return generateAdt({ seed, trigger: "A08" });
+    case "ORU^R01":
+      return generateOru({ seed });
+    case "ORM^O01":
+      return generateOrm({ seed });
+    case "SIU^S12":
+      return generateSiu({ seed });
+    case "VXU^V04":
+      return generateVxu({ seed });
+  }
+}
+function generateHl7Quirk(options) {
+  const seed = options.seed ?? 0;
+  const kind = options.kind ?? "ORU^R01";
+  const descriptor = resolveQuirk(HL7_QUIRKS, "hl7v2", options.quirk);
+  const content = applyQuirk(options.quirk, baseMessage(kind, seed).toString());
+  assertIntendedWarnings(
+    descriptor.name,
+    descriptor.intendedWarnings,
+    parseHL7(content).warnings.map((w) => String(w.code))
+  );
+  return Object.freeze({
+    format: "hl7v2",
+    quirk: descriptor.name,
+    kind,
+    content,
+    intendedWarnings: descriptor.intendedWarnings
+  });
+}
+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 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)),
+    tolerated: false
+  } : void 0;
+  return {
+    content: artifact.content,
+    warnings: bare,
+    intendedWarnings: artifact.intendedWarnings,
+    intendedWarningHeld: sameCodeSet(bare, artifact.intendedWarnings),
+    ...withProfile ? {
+      withProfile: {
+        ...withProfile,
+        tolerated: profileTolerated(
+          descriptor.disposition,
+          artifact.intendedWarnings,
+          withProfile.warnings
+        )
+      }
+    } : {}
+  };
+}
+var ALL_HL7_QUIRKS = Object.freeze(
+  Object.keys(HL7_QUIRKS)
+);
+function hl7QuirkCorpus(options) {
+  const quirks = options.profile ? validateProfileQuirks(options.profile, HL7_QUIRKS, "hl7v2") : options.quirks ?? ALL_HL7_QUIRKS;
+  const names = quirks.length > 0 ? quirks : ALL_HL7_QUIRKS;
+  const kind = options.kind ?? "ORU^R01";
+  const count = options.count ?? names.length;
+  const seedStream = createRng(options.seed);
+  const artifacts = Array.from({ length: count }, (_unused, i) => {
+    const quirk = names[i % names.length];
+    const artifactSeed = seedStream.nextUint32();
+    const artifact = generateHl7Quirk({ seed: artifactSeed, quirk, kind });
+    return {
+      format: "hl7v2",
+      kind: `${kind}~${quirk}`,
+      content: artifact.content,
+      warnings: artifact.intendedWarnings
+    };
+  });
+  return makeCorpus(options.seed, artifacts, [...new Set(names)]);
+}
+var hl7QuirkProfile = defineSynthProfile({
+  name: "cosyte-hl7-quirks",
+  quirks: [...ALL_HL7_QUIRKS]
+});
+
+// src/hl7/index.ts
+var DEFAULT_MIX = Object.freeze([
+  "ADT^A01",
+  "ADT^A04",
+  "ADT^A08",
+  "ORU^R01",
+  "ORM^O01",
+  "SIU^S12",
+  "VXU^V04"
+]);
+function generateHl7(kind, seed) {
+  switch (kind) {
+    case "ADT^A01":
+      return generateAdt({ seed, trigger: "A01" });
+    case "ADT^A04":
+      return generateAdt({ seed, trigger: "A04" });
+    case "ADT^A08":
+      return generateAdt({ seed, trigger: "A08" });
+    case "ORU^R01":
+      return generateOru({ seed });
+    case "ORM^O01":
+      return generateOrm({ seed });
+    case "SIU^S12":
+      return generateSiu({ seed });
+    case "VXU^V04":
+      return generateVxu({ seed });
+  }
+}
+function hl7Corpus(options) {
+  const { seed, count = 1 } = options;
+  const kinds = options.triggers !== void 0 ? options.triggers.map((t) => `ADT^${t}`) : options.mix ?? DEFAULT_MIX;
+  const seedStream = createRng(seed);
+  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));
+    return {
+      format: "hl7v2",
+      kind,
+      content: rt.content,
+      warnings: rt.warnings
+    };
+  });
+  return makeCorpus(seed, artifacts);
+}
+
+export { EXAMPLE_LAB_OBSERVATIONS, EXAMPLE_ORDER_SERVICES, EXAMPLE_VACCINES, HL7_QUIRKS, componentsField, generateAdt, generateHl7, generateHl7Quirk, generateOrm, generateOru, generateSiu, generateVxu, hl7Corpus, hl7QuirkCorpus, hl7QuirkProfile, hl7QuirkRoundTrip, mshScaffold, patientIdentity, pidSegment, roundTrip, seededTimestamp };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map