@cosyte/synth 0.1.4 → 0.1.6

package/dist/ncpdp/index.d.cts

@@ -158,6 +158,7 @@ declare function generateB3(options: GenerateTelecomOptions): string;
  *
  * @module
  */
+
 /** The verdict of one round-trip through `@cosyte/ncpdp`. */
 interface RoundTripResult {
     /** The serialized NCPDP wire text (the serializer's own conservative emit). */
@@ -412,6 +413,12 @@ interface NcpdpCorpusOptions {
     readonly count?: number;
     /** The transaction kinds to cycle through. Defaults to one of each. */
     readonly mix?: readonly NcpdpCorpusKind[];
+    /**
+     * 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 NCPDP transactions. Each transaction is generated

package/dist/ncpdp/index.d.ts

@@ -158,6 +158,7 @@ declare function generateB3(options: GenerateTelecomOptions): string;
  *
  * @module
  */
+
 /** The verdict of one round-trip through `@cosyte/ncpdp`. */
 interface RoundTripResult {
     /** The serialized NCPDP wire text (the serializer's own conservative emit). */
@@ -412,6 +413,12 @@ interface NcpdpCorpusOptions {
     readonly count?: number;
     /** The transaction kinds to cycle through. Defaults to one of each. */
     readonly mix?: readonly NcpdpCorpusKind[];
+    /**
+     * 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 NCPDP transactions. Each transaction is generated

package/dist/ncpdp/index.mjs

@@ -1,6 +1,12 @@
-import { buildNewRx, serializeScript, ScriptMessage, parseScript } from '@cosyte/ncpdp/script';
-import { decimalValue, codedValue } from '@cosyte/ncpdp/common';
-import { serializeTelecom, buildTelecomRequest, parseTelecom } from '@cosyte/ncpdp/telecom';
+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) {
@@ -32,18 +38,59 @@ 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.
+   */
+  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",
+  /** 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 `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"};
+  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).",
@@ -109,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();
@@ -465,18 +513,20 @@ function ncpdpScriptRouting(rng) {
 }
 
 // src/ncpdp/example-codes.ts
-var EXAMPLE_DRUGS = Object.freeze([
-  { description: "Amoxicillin 500 MG Oral Capsule", ndc: "00000010101", form: "EA" },
-  { description: "Lisinopril 10 MG Oral Tablet", ndc: "00000020202", form: "EA" },
-  { description: "Atorvastatin 20 MG Oral Tablet", ndc: "00000030303", form: "EA" },
-  { description: "Metformin 500 MG Oral Tablet", ndc: "00000040404", form: "EA" },
-  { description: "Amlodipine 5 MG Oral Tablet", ndc: "00000050505", form: "EA" },
-  { description: "Omeprazole 20 MG Delayed Release Capsule", ndc: "00000060606", form: "EA" },
-  { description: "Levothyroxine 50 MCG Oral Tablet", ndc: "00000070707", form: "EA" },
-  { description: "Azithromycin 250 MG Oral Tablet", ndc: "00000080808", form: "EA" },
-  { description: "Sertraline 50 MG Oral Tablet", ndc: "00000090909", form: "EA" },
-  { description: "Albuterol 90 MCG Metered Dose Inhaler", ndc: "00000101010", form: "EA" }
-]);
+var EXAMPLE_DRUGS = Object.freeze(
+  [
+    { description: "Amoxicillin 500 MG Oral Capsule", ndc: "00000010101", form: "EA" },
+    { description: "Lisinopril 10 MG Oral Tablet", ndc: "00000020202", form: "EA" },
+    { description: "Atorvastatin 20 MG Oral Tablet", ndc: "00000030303", form: "EA" },
+    { description: "Metformin 500 MG Oral Tablet", ndc: "00000040404", form: "EA" },
+    { description: "Amlodipine 5 MG Oral Tablet", ndc: "00000050505", form: "EA" },
+    { description: "Omeprazole 20 MG Delayed Release Capsule", ndc: "00000060606", form: "EA" },
+    { description: "Levothyroxine 50 MCG Oral Tablet", ndc: "00000070707", form: "EA" },
+    { description: "Azithromycin 250 MG Oral Tablet", ndc: "00000080808", form: "EA" },
+    { description: "Sertraline 50 MG Oral Tablet", ndc: "00000090909", form: "EA" },
+    { description: "Albuterol 90 MCG Metered Dose Inhaler", ndc: "00000101010", form: "EA" }
+  ].map((entry) => Object.freeze(entry))
+);
 var EXAMPLE_SIG_TEXT = Object.freeze([
   "Take 1 tablet by mouth once daily",
   "Take 1 capsule by mouth twice daily with food",
@@ -485,6 +535,30 @@ var EXAMPLE_SIG_TEXT = Object.freeze([
   "Inhale 2 puffs by mouth every 4 to 6 hours as needed"
 ]);
 var DAW_CODES = Object.freeze(["0", "1", "2"]);
+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 ncpdpScriptPeer = lazyPeer("@cosyte/ncpdp/script");
+var ncpdpTelecomPeer = lazyPeer("@cosyte/ncpdp/telecom");
+var ncpdpCommonPeer = lazyPeer("@cosyte/ncpdp/common");
 
 // src/ncpdp/script.ts
 var SCRIPT_VERSION = "2017071";
@@ -515,13 +589,13 @@ function medicationModel(rng, routing) {
   const written = `${routing.date.slice(0, 4)}-${routing.date.slice(4, 6)}-${routing.date.slice(6, 8)}`;
   return {
     description: drug.description,
-    coded: { productCode: codedValue(drug.ndc, "ND") },
+    coded: { productCode: ncpdpCommonPeer().codedValue(drug.ndc, "ND") },
     quantity: {
-      value: decimalValue(String(rng.int(30, 90))),
+      value: ncpdpCommonPeer().decimalValue(String(rng.int(30, 90))),
       unitOfMeasure: drug.form,
       codeListQualifier: "38"
     },
-    daysSupply: decimalValue(String(rng.pick([30, 60, 90]))),
+    daysSupply: ncpdpCommonPeer().decimalValue(String(rng.pick([30, 60, 90]))),
     numberOfRefills: String(rng.int(0, 5)),
     substitutions: rng.pick(["0", "1"]),
     writtenDate: written,
@@ -545,14 +619,14 @@ function generateNewRx(options) {
   const pharmacy = pharmacyModel(rng);
   const prescriber = prescriberModel(rng);
   const medication = medicationModel(rng, routing);
-  const message = buildNewRx({
+  const message = ncpdpScriptPeer().buildNewRx({
     header: headerModel(routing),
     patient,
     pharmacy,
     prescriber,
     medication
   });
-  return serializeScript(message);
+  return ncpdpScriptPeer().serializeScript(message);
 }
 function lifecycleFields(rng) {
   const routing = ncpdpScriptRouting(rng);
@@ -569,14 +643,20 @@ function generateRxRenewalRequest(options) {
   const rng = createRng(options.seed);
   const { header: header2, ...fields } = lifecycleFields(rng);
   const body = { kind: "RxRenewalRequest", ...fields };
-  return serializeScript(new ScriptMessage({ header: header2, body, warnings: [] }));
+  return ncpdpScriptPeer().serializeScript(
+    new (ncpdpScriptPeer()).ScriptMessage({ header: header2, body, warnings: [] })
+  );
 }
 function generateRxChangeRequest(options) {
   const rng = createRng(options.seed);
   const { header: header2, ...fields } = lifecycleFields(rng);
   const body = { kind: "RxChangeRequest", ...fields };
-  return serializeScript(new ScriptMessage({ header: header2, body, warnings: [] }));
+  return ncpdpScriptPeer().serializeScript(
+    new (ncpdpScriptPeer()).ScriptMessage({ header: header2, body, warnings: [] })
+  );
 }
+
+// src/ncpdp/telecom.ts
 var SYNTHETIC_BIN = "999999";
 function digitsOnly(value) {
   return value.replace(/\D/g, "");
@@ -676,7 +756,9 @@ function generateTelecom(code, options) {
     prescriberSegment(rng),
     claimSegment(rng, false)
   ];
-  return serializeTelecom(buildTelecomRequest({ header: head, segments }));
+  return ncpdpTelecomPeer().serializeTelecom(
+    ncpdpTelecomPeer().buildTelecomRequest({ header: head, segments })
+  );
 }
 function generateB1(options) {
   return generateTelecom("B1", options);
@@ -687,18 +769,30 @@ function generateB2(options) {
 function generateB3(options) {
   return generateTelecom("B3", options);
 }
+
+// src/ncpdp/round-trip.ts
 function scriptRoundTrip(xml) {
-  const message = parseScript(xml);
+  const message = ncpdpScriptPeer().parseScript(xml);
   const warnings = message.warnings.map((w) => String(w.code));
-  const byteStable = serializeScript(message) === xml;
+  const byteStable = ncpdpScriptPeer().serializeScript(message) === xml;
   return { content: xml, warnings, byteStable, specClean: warnings.length === 0 && byteStable };
 }
 function telecomRoundTrip(wire) {
-  const transaction = parseTelecom(wire);
+  const transaction = ncpdpTelecomPeer().parseTelecom(wire);
   const warnings = transaction.warnings.map((w) => String(w.code));
-  const byteStable = serializeTelecom(transaction) === wire;
+  const byteStable = ncpdpTelecomPeer().serializeTelecom(transaction) === wire;
   return { content: wire, warnings, byteStable, specClean: warnings.length === 0 && byteStable };
 }
+function scriptCorpusArtifact(xml, verify) {
+  if (!verify) return { content: xml, warnings: UNCHECKED };
+  const warnings = ncpdpScriptPeer().parseScript(xml).warnings.map((w) => String(w.code));
+  return { content: xml, warnings };
+}
+function telecomCorpusArtifact(wire, verify) {
+  if (!verify) return { content: wire, warnings: UNCHECKED };
+  const warnings = ncpdpTelecomPeer().parseTelecom(wire).warnings.map((w) => String(w.code));
+  return { content: wire, warnings };
+}
 
 // src/select.ts
 function resolveKind(allowed, requested) {
@@ -721,29 +815,29 @@ var ALL_KINDS = Object.freeze([
   "B3"
 ]);
 var DEFAULT_MIX = ALL_KINDS;
-function generateKind(kind, seed) {
+function generateKind(kind, seed, verify) {
   switch (kind) {
     case "NewRx":
-      return scriptRoundTrip(generateNewRx({ seed }));
+      return scriptCorpusArtifact(generateNewRx({ seed }), verify);
     case "RxRenewalRequest":
-      return scriptRoundTrip(generateRxRenewalRequest({ seed }));
+      return scriptCorpusArtifact(generateRxRenewalRequest({ seed }), verify);
     case "RxChangeRequest":
-      return scriptRoundTrip(generateRxChangeRequest({ seed }));
+      return scriptCorpusArtifact(generateRxChangeRequest({ seed }), verify);
     case "B1":
     case "B2":
     case "B3":
-      return telecomRoundTrip(generateTelecom(kind, { seed }));
+      return telecomCorpusArtifact(generateTelecom(kind, { seed }), verify);
   }
 }
 function ncpdpCorpus(options) {
-  const { seed } = options;
+  const { seed, verify = true } = options;
   const mix = resolveMix(ALL_KINDS, options.mix, DEFAULT_MIX);
   const count = options.count ?? mix.length;
   const seedStream = createRng(seed);
   const artifacts = Array.from({ length: count }, (_unused, i) => {
     const kind = mix[i % mix.length] ?? "NewRx";
     const txSeed = seedStream.nextUint32();
-    const rt = generateKind(kind, txSeed);
+    const rt = generateKind(kind, txSeed, verify);
     return {
       format: "ncpdp",
       kind,