@cosyte/synth 0.0.9 → 0.1.0

package/dist/fhir/index.cjs

@@ -45,7 +45,16 @@ 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.",
@@ -57,7 +66,8 @@ var SYNTH_FATAL_MESSAGES = Object.freeze({
   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."
+  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.",
+  SYNTH_PROFILE_NOT_GENERATED: "The requested profile is published by the adopted implementation guide, and this build does not generate it. The coverage surface reports, per adopted profile, whether it is generated."
 });
 var SynthError = class extends Error {
   /** The stable fatal code. */
@@ -114,7 +124,7 @@ function createRng(seed) {
 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). */
+  /** The universal id, an OID this package chose under the root `2.16.840.1.113883.19` (HD.2). */
   universalId: "2.16.840.1.113883.19.999",
   /** The universal id type (HD.3). */
   universalIdType: "ISO"
@@ -133,6 +143,18 @@ var TEST_NET_V4_PREFIXES = Object.freeze([
   // TEST-NET-3
 ]);
 var DOC_V6_PREFIX = "2001:db8";
+var ITIN_GROUP_RANGES = Object.freeze([
+  Object.freeze({ min: 50, max: 65 }),
+  Object.freeze({ min: 70, max: 88 }),
+  Object.freeze({ min: 90, max: 92 }),
+  Object.freeze({ min: 94, max: 99 })
+]);
+var ITIN_EXCLUDED_GROUPS = Object.freeze([89, 93]);
+var SSN_SYNTHETIC_GROUPS = Object.freeze(
+  Array.from({ length: 100 }, (_unused, group) => group).filter(
+    (group) => !ITIN_GROUP_RANGES.some((range) => group >= range.min && group <= range.max) && !ITIN_EXCLUDED_GROUPS.includes(group)
+  ).map((group) => String(group).padStart(2, "0"))
+);
 var NPI_LUHN_PREFIX = "80840";
 function luhnMod10(digits) {
   let sum = 0;
@@ -241,10 +263,10 @@ var SYNTHETIC_CITY_NAMES = Object.freeze([
 // src/safe/providers.ts
 function ssn(rng, block = "never-issued") {
   if (block === "advertising") {
-    return `987-65-432${String(rng.int(0, 9))}`;
+    return `987-00-432${String(rng.int(0, 9))}`;
   }
   const area = rng.int(900, 999);
-  const group = rng.digits(2);
+  const group = rng.pick(SSN_SYNTHETIC_GROUPS);
   const serial = rng.digits(4);
   return `${String(area)}-${group}-${serial}`;
 }
@@ -403,8 +425,62 @@ var US_CORE_PROFILE = Object.freeze({
   /** US Core AllergyIntolerance. */
   ALLERGY_INTOLERANCE: "http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance",
   /** US Core Procedure. */
-  PROCEDURE: "http://hl7.org/fhir/us/core/StructureDefinition/us-core-procedure"
+  PROCEDURE: "http://hl7.org/fhir/us/core/StructureDefinition/us-core-procedure",
+  /** US Core Provenance. */
+  PROVENANCE: "http://hl7.org/fhir/us/core/StructureDefinition/us-core-provenance"
 });
+var US_CORE_PROFILE_BASE = "http://hl7.org/fhir/us/core/StructureDefinition/";
+var US_CORE_ADOPTED_PROFILES = Object.freeze([
+  "head-occipital-frontal-circumference-percentile",
+  "pediatric-bmi-for-age",
+  "pediatric-weight-for-height",
+  "us-core-allergyintolerance",
+  "us-core-blood-pressure",
+  "us-core-bmi",
+  "us-core-body-height",
+  "us-core-body-temperature",
+  "us-core-body-weight",
+  "us-core-careplan",
+  "us-core-careteam",
+  "us-core-condition-encounter-diagnosis",
+  "us-core-condition-problems-health-concerns",
+  "us-core-coverage",
+  "us-core-diagnosticreport-lab",
+  "us-core-diagnosticreport-note",
+  "us-core-documentreference",
+  "us-core-encounter",
+  "us-core-goal",
+  "us-core-head-circumference",
+  "us-core-heart-rate",
+  "us-core-immunization",
+  "us-core-implantable-device",
+  "us-core-location",
+  "us-core-medication",
+  "us-core-medicationdispense",
+  "us-core-medicationrequest",
+  "us-core-observation-clinical-result",
+  "us-core-observation-lab",
+  "us-core-observation-occupation",
+  "us-core-observation-pregnancyintent",
+  "us-core-observation-pregnancystatus",
+  "us-core-observation-screening-assessment",
+  "us-core-observation-sexual-orientation",
+  "us-core-organization",
+  "us-core-patient",
+  "us-core-practitioner",
+  "us-core-practitionerrole",
+  "us-core-procedure",
+  "us-core-provenance",
+  "us-core-pulse-oximetry",
+  "us-core-questionnaireresponse",
+  "us-core-relatedperson",
+  "us-core-respiratory-rate",
+  "us-core-servicerequest",
+  "us-core-simple-observation",
+  "us-core-smokingstatus",
+  "us-core-specimen",
+  "us-core-vital-signs"
+]);
 var US_CORE_RACE_EXTENSION = "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race";
 var US_CORE_ETHNICITY_EXTENSION = "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity";
 var US_CORE_BIRTHSEX_EXTENSION = "http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex";
@@ -440,7 +516,11 @@ var SYSTEM = Object.freeze({
   /** HL7 Terminology `allergyintolerance-clinical`, `AllergyIntolerance.clinicalStatus`. */
   ALLERGY_CLINICAL: "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
   /** HL7 Terminology `allergyintolerance-verification`, `AllergyIntolerance.verificationStatus`. */
-  ALLERGY_VERIFICATION: "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification"
+  ALLERGY_VERIFICATION: "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
+  /** HL7 Terminology `provenance-participant-type`, `Provenance.agent.type` (`author`). */
+  PROVENANCE_PARTICIPANT_TYPE: "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
+  /** US Core `us-core-provenance-participant-type`, `Provenance.agent.type` (`transmitter`). */
+  US_CORE_PROVENANCE_PARTICIPANT_TYPE: "http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type"
 });
 
 // src/fhir/builder.ts
@@ -1127,6 +1207,53 @@ function generateProcedure(options = {}) {
   props.push(prop("performedDateTime", str(`${performed}T10:00:00Z`)));
   return fhir.complex(props);
 }
+function generateProvenance(options = {}) {
+  const { seed = 0, target = "Patient/syn-patient-1", usCore = true } = options;
+  const rng = createRng(seed);
+  const recorded = toFhirDate(safe.dateYmd(rng, 2018, 2024));
+  const practitioner = `Practitioner/syn-practitioner-${rng.digits(8)}`;
+  const organization = `Organization/syn-org-${rng.digits(8)}`;
+  const props = [
+    prop("resourceType", str("Provenance")),
+    prop("id", str(`syn-prov-${rng.digits(8)}`))
+  ];
+  if (usCore) props.push(prop("meta", meta([US_CORE_PROFILE.PROVENANCE])));
+  props.push(prop("text", narrative("Synthetic provenance for a generated fixture.")));
+  props.push(prop("target", fhir.list([reference(target)])));
+  props.push(prop("recorded", str(`${recorded}T10:00:00Z`)));
+  props.push(
+    prop(
+      "agent",
+      fhir.list([
+        fhir.complex([
+          prop(
+            "type",
+            fhir.complex([
+              prop(
+                "coding",
+                fhir.list([
+                  coding({
+                    system: SYSTEM.PROVENANCE_PARTICIPANT_TYPE,
+                    code: "author",
+                    display: "Author"
+                  }),
+                  coding({
+                    system: SYSTEM.US_CORE_PROVENANCE_PARTICIPANT_TYPE,
+                    code: "transmitter",
+                    display: "Transmitter"
+                  })
+                ])
+              )
+            ])
+          ),
+          prop("who", reference(practitioner)),
+          prop("onBehalfOf", reference(organization))
+        ])
+      ])
+    )
+  );
+  return fhir.complex(props);
+}
 function generateDiagnosticReport(options = {}) {
   const { seed = 0, subject = "Patient/syn-patient-1", results = [], usCore = true } = options;
   const rng = createRng(seed);
@@ -1454,6 +1581,41 @@ function fhirCorpus(options) {
   return makeCorpus(seed, artifacts);
 }
 
+// src/fhir/coverage.ts
+var GENERATORS = Object.freeze({
+  "us-core-allergyintolerance": (seed) => generateAllergyIntolerance({ seed }),
+  "us-core-condition-problems-health-concerns": (seed) => generateCondition({ seed }),
+  "us-core-diagnosticreport-lab": (seed) => generateDiagnosticReport({ seed }),
+  "us-core-encounter": (seed) => generateEncounter({ seed }),
+  "us-core-immunization": (seed) => generateImmunization({ seed }),
+  "us-core-medicationrequest": (seed) => generateMedicationRequest({ seed }),
+  "us-core-observation-lab": (seed) => generateObservationLab({ seed }),
+  "us-core-patient": (seed) => generatePatient({ seed, profile: "us-core" }),
+  "us-core-procedure": (seed) => generateProcedure({ seed }),
+  "us-core-provenance": (seed) => generateProvenance({ seed }),
+  "us-core-vital-signs": (seed) => generateVitalSign({ seed })
+});
+var COVERAGE = Object.freeze(
+  US_CORE_ADOPTED_PROFILES.map(
+    (profile) => Object.freeze({
+      profile,
+      canonical: `${US_CORE_PROFILE_BASE}${profile}`,
+      generated: GENERATORS[profile] !== void 0
+    })
+  )
+);
+function usCoreCoverage() {
+  return COVERAGE;
+}
+function generateUsCoreProfile(options) {
+  const profile = resolveKind(US_CORE_ADOPTED_PROFILES, options.profile);
+  const generate = GENERATORS[profile];
+  if (generate === void 0) {
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_PROFILE_NOT_GENERATED);
+  }
+  return generate(options.seed ?? 0);
+}
+
 exports.EXAMPLE_ALLERGENS = EXAMPLE_ALLERGENS;
 exports.EXAMPLE_ALLERGY_MANIFESTATIONS = EXAMPLE_ALLERGY_MANIFESTATIONS;
 exports.EXAMPLE_CONDITIONS = EXAMPLE_CONDITIONS;
@@ -1468,9 +1630,11 @@ exports.EXAMPLE_RACE_CATEGORIES = EXAMPLE_RACE_CATEGORIES;
 exports.EXAMPLE_VACCINES = EXAMPLE_VACCINES;
 exports.EXAMPLE_VITAL_SIGNS = EXAMPLE_VITAL_SIGNS;
 exports.SYSTEM = SYSTEM;
+exports.US_CORE_ADOPTED_PROFILES = US_CORE_ADOPTED_PROFILES;
 exports.US_CORE_BIRTHSEX_EXTENSION = US_CORE_BIRTHSEX_EXTENSION;
 exports.US_CORE_ETHNICITY_EXTENSION = US_CORE_ETHNICITY_EXTENSION;
 exports.US_CORE_PROFILE = US_CORE_PROFILE;
+exports.US_CORE_PROFILE_BASE = US_CORE_PROFILE_BASE;
 exports.US_CORE_RACE_EXTENSION = US_CORE_RACE_EXTENSION;
 exports.bool = bool;
 exports.buildComposition = buildComposition;
@@ -1489,6 +1653,8 @@ exports.generateMedicationRequest = generateMedicationRequest;
 exports.generateObservationLab = generateObservationLab;
 exports.generatePatient = generatePatient;
 exports.generateProcedure = generateProcedure;
+exports.generateProvenance = generateProvenance;
+exports.generateUsCoreProfile = generateUsCoreProfile;
 exports.generateVitalSign = generateVitalSign;
 exports.meta = meta;
 exports.mrnIdentifier = mrnIdentifier;
@@ -1498,5 +1664,6 @@ exports.reference = reference;
 exports.roundTrip = roundTrip;
 exports.str = str;
 exports.toFhirDate = toFhirDate;
+exports.usCoreCoverage = usCoreCoverage;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map