@cosyte/synth 0.1.8 → 0.1.10

package/dist/{quirk-BfObsiWV.d.ts → quirk-CzknuYUo.d.ts}

@@ -19,7 +19,9 @@ interface SynthProfileSpec {
     /**
      * The vendor quirk recipe names this profile requests. Validated against the target format's quirk
      * registry when the profile drives a quirk corpus (an unsupported quirk is a fatal
-     * `SYNTH_UNSUPPORTED_QUIRK`, never a silent no-op).
+     * `SYNTH_UNSUPPORTED_QUIRK`, never a silent no-op). Leave it out to leave the quirk selection to
+     * the corpus (every quirk by default); an empty list selects nothing, and a quirk corpus refuses it
+     * with `SYNTH_EMPTY_POOL`.
      */
     readonly quirks?: readonly string[];
 }
@@ -31,8 +33,11 @@ interface SynthProfile {
     readonly givenNames?: readonly string[];
     /** The family-name pool this profile draws from. */
     readonly familyNames?: readonly string[];
-    /** The requested quirk recipe names. */
-    readonly quirks: readonly string[];
+    /**
+     * The requested quirk recipe names, or absent when the spec left `quirks` out. Absent is not an
+     * empty list: absent leaves the quirk selection to the corpus, an empty list selects nothing.
+     */
+    readonly quirks?: readonly string[];
 }
 /**
  * Define a reusable, frozen synthetic-fixture profile.
@@ -43,7 +48,12 @@ interface SynthProfile {
  * @example
  * ```ts
  * import { defineSynthProfile } from "@cosyte/synth";
- * const acme = defineSynthProfile({ name: "acme-hospital", quirks: [] });
+ * // Name pools only: `quirks` is left out, so a quirk corpus given this profile applies every quirk.
+ * const acme = defineSynthProfile({
+ *   name: "acme-hospital",
+ *   givenNames: ["Testina"],
+ *   familyNames: ["Testerson"],
+ * });
  * ```
  */
 declare function defineSynthProfile(spec: SynthProfileSpec): SynthProfile;
@@ -235,7 +245,8 @@ declare function assertIntendedWarnings(intendedWarnings: readonly string[], bar
  * @param profile - The synth profile whose `quirks` to validate.
  * @param registry - The format's quirk descriptors.
  * @param format - The format being generated.
- * @returns The validated quirk names (the profile's, in order).
+ * @returns The validated quirk names: the profile's, in order, or every quirk in `registry` when the
+ * profile leaves `quirks` out. An empty `quirks` list comes back empty.
  * @throws SynthError `SYNTH_UNSUPPORTED_QUIRK` for the first unsupported quirk.
  * @example
  * ```ts

package/dist/{quirk-BCSs1jPt.d.cts → quirk-Q5AxzHSC.d.cts}

@@ -19,7 +19,9 @@ interface SynthProfileSpec {
     /**
      * The vendor quirk recipe names this profile requests. Validated against the target format's quirk
      * registry when the profile drives a quirk corpus (an unsupported quirk is a fatal
-     * `SYNTH_UNSUPPORTED_QUIRK`, never a silent no-op).
+     * `SYNTH_UNSUPPORTED_QUIRK`, never a silent no-op). Leave it out to leave the quirk selection to
+     * the corpus (every quirk by default); an empty list selects nothing, and a quirk corpus refuses it
+     * with `SYNTH_EMPTY_POOL`.
      */
     readonly quirks?: readonly string[];
 }
@@ -31,8 +33,11 @@ interface SynthProfile {
     readonly givenNames?: readonly string[];
     /** The family-name pool this profile draws from. */
     readonly familyNames?: readonly string[];
-    /** The requested quirk recipe names. */
-    readonly quirks: readonly string[];
+    /**
+     * The requested quirk recipe names, or absent when the spec left `quirks` out. Absent is not an
+     * empty list: absent leaves the quirk selection to the corpus, an empty list selects nothing.
+     */
+    readonly quirks?: readonly string[];
 }
 /**
  * Define a reusable, frozen synthetic-fixture profile.
@@ -43,7 +48,12 @@ interface SynthProfile {
  * @example
  * ```ts
  * import { defineSynthProfile } from "@cosyte/synth";
- * const acme = defineSynthProfile({ name: "acme-hospital", quirks: [] });
+ * // Name pools only: `quirks` is left out, so a quirk corpus given this profile applies every quirk.
+ * const acme = defineSynthProfile({
+ *   name: "acme-hospital",
+ *   givenNames: ["Testina"],
+ *   familyNames: ["Testerson"],
+ * });
  * ```
  */
 declare function defineSynthProfile(spec: SynthProfileSpec): SynthProfile;
@@ -235,7 +245,8 @@ declare function assertIntendedWarnings(intendedWarnings: readonly string[], bar
  * @param profile - The synth profile whose `quirks` to validate.
  * @param registry - The format's quirk descriptors.
  * @param format - The format being generated.
- * @returns The validated quirk names (the profile's, in order).
+ * @returns The validated quirk names: the profile's, in order, or every quirk in `registry` when the
+ * profile leaves `quirks` out. An empty `quirks` list comes back empty.
  * @throws SynthError `SYNTH_UNSUPPORTED_QUIRK` for the first unsupported quirk.
  * @example
  * ```ts

package/dist/x12/index.cjs

@@ -73,7 +73,11 @@ var SYNTH_FATAL_CODES = Object.freeze({
   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. */
+  /**
+   * A value was drawn from an empty pool. Fatal, never a fabricated substitute. A corpus given an
+   * empty `mix`, `triggers` or `quirks` list (or a profile whose `quirks` is an empty list) raises it
+   * too: there is no kind to cycle through, and an empty list is never read as the default.
+   */
   SYNTH_EMPTY_POOL: "SYNTH_EMPTY_POOL",
   /** A `defineSynthProfile` spec was not usable (a missing or blank `name`). Fatal. */
   SYNTH_INVALID_PROFILE: "SYNTH_INVALID_PROFILE",
@@ -92,7 +96,21 @@ var SYNTH_FATAL_CODES = Object.freeze({
    * 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"
+  SYNTH_PROFILE_NOT_GENERATED: "SYNTH_PROFILE_NOT_GENERATED",
+  /**
+   * The sibling parser a generator builds through is not installed. Raised on the first call that
+   * needs it, by both builds, only when the missing package is the parser itself: a missing
+   * dependency of an installed parser is thrown as Node.js raised it. The error carries the parser's
+   * package name on `peer`, a message from {@link SYNTH_PEER_MESSAGES} that names its install
+   * command, and the error Node.js raised on `cause`.
+   */
+  SYNTH_PEER_NOT_INSTALLED: "SYNTH_PEER_NOT_INSTALLED",
+  /**
+   * An HL7 v2 `ACK` was asked for an inbound message that carries no MSH-10 message control id.
+   * MSA-2 must echo that id, and an acknowledgment that cannot be matched to the message it answers
+   * is not a fixture worth having, so nothing is generated.
+   */
+  SYNTH_ACK_UNCORRELATED: "SYNTH_ACK_UNCORRELATED"
 });
 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.",
@@ -105,18 +123,38 @@ var SYNTH_FATAL_MESSAGES = Object.freeze({
   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_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."
+  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.",
+  SYNTH_PEER_NOT_INSTALLED: "A sibling @cosyte parser this generator builds through is not installed. Install it beside @cosyte/synth.",
+  SYNTH_ACK_UNCORRELATED: (
+    // Stryker disable next-line all: a module-level table runs once, at import; the docs test holds it.
+    "The inbound message has no MSH-10 control id for an ACK to echo in MSA-2."
+  )
+});
+var SYNTH_PEER_MESSAGES = Object.freeze({
+  "@cosyte/hl7": "@cosyte/hl7 is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/hl7",
+  "@cosyte/fhir": "@cosyte/fhir is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/fhir",
+  "@cosyte/ccda": "@cosyte/ccda is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/ccda",
+  "@cosyte/x12": "@cosyte/x12 is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/x12",
+  "@cosyte/ncpdp": "@cosyte/ncpdp is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/ncpdp",
+  "@cosyte/astm": "@cosyte/astm is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/astm",
+  "@cosyte/deid": "@cosyte/deid is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/deid"
 });
 var SynthError = class extends Error {
   /** The stable fatal code. */
   code;
   /**
    * @param code - The stable {@link SynthFatalCode}. The message comes from the frozen registry.
+   * @param options - The error that caused this one, and for a missing parser its package.
    */
-  constructor(code) {
-    super(SYNTH_FATAL_MESSAGES[code]);
+  constructor(code, options = {}) {
+    const peer = code === SYNTH_FATAL_CODES.SYNTH_PEER_NOT_INSTALLED ? options.peer : void 0;
+    super(
+      peer === void 0 ? SYNTH_FATAL_MESSAGES[code] : SYNTH_PEER_MESSAGES[peer],
+      "cause" in options ? { cause: options.cause } : void 0
+    );
     this.name = "SynthError";
     this.code = code;
+    if (peer !== void 0) Object.defineProperty(this, "peer", { value: peer, enumerable: true });
   }
 };
 
@@ -183,14 +221,44 @@ function defaultHost() {
   if (typeof undefined !== "function") return { require: __require, resolve: void 0 };
   return { require: module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))), resolve: (s) => undefined(s) };
 }
+function isDenoResolveRefusal(error) {
+  return error instanceof TypeError && !("code" in error) && error.message === "Invalid arguments";
+}
 function isRequireEsmRefusal(error) {
   return error?.code === "ERR_REQUIRE_ESM";
 }
+function peerPackage(specifier) {
+  const name2 = specifier.split("/").slice(0, 2).join("/");
+  return Object.hasOwn(SYNTH_PEER_MESSAGES, name2) ? name2 : void 0;
+}
+function isPeerNotFound(error, specifier, peer) {
+  const { code, message } = error ?? {};
+  if (typeof message !== "string") return false;
+  if (code === "ERR_MODULE_NOT_FOUND") return message.startsWith(`Cannot find package '${peer}'`);
+  if (code === "MODULE_NOT_FOUND") return message.startsWith(`Cannot find module '${specifier}'`);
+  return false;
+}
 function loadPeer(specifier, host) {
+  try {
+    return loadFrom(specifier, host);
+  } catch (error) {
+    const peer = peerPackage(specifier);
+    if (peer === void 0 || !isPeerNotFound(error, specifier, peer)) throw error;
+    throw new SynthError(SYNTH_FATAL_CODES.SYNTH_PEER_NOT_INSTALLED, { peer, cause: error });
+  }
+}
+function loadFrom(specifier, host) {
   if (host.resolve === void 0) return host.require(specifier);
-  const entry = url.fileURLToPath(host.resolve(specifier));
+  let url$1;
   try {
-    return host.require(entry);
+    url$1 = host.resolve(specifier);
+  } catch (error) {
+    if (!isDenoResolveRefusal(error)) throw error;
+    return host.require(specifier);
+  }
+  if (!url$1.startsWith("file:")) return host.require(specifier);
+  try {
+    return host.require(url.fileURLToPath(url$1));
   } catch (error) {
     if (!isRequireEsmRefusal(error)) throw error;
     return host.require(specifier);
@@ -256,7 +324,7 @@ function luhnMod10(digits) {
     if (d < 0 || d > 9) continue;
     if (double) {
       d *= 2;
-      if (d > 9) d -= 9;
+      if (d >= 10) d -= 9;
     }
     sum += d;
     double = !double;
@@ -353,7 +421,7 @@ var SYNTHETIC_CITY_NAMES = Object.freeze([
 ]);
 
 // src/safe/providers.ts
-function ssn(rng, block = "never-issued") {
+function ssn(rng, block) {
   if (block === "advertising") {
     return `987-00-432${String(rng.int(0, 9))}`;
   }
@@ -480,6 +548,63 @@ var US_STATES = Object.freeze([
   "WY"
 ]);
 
+// src/safe/animal-code.ts
+var ANIMAL_CODE_SYSTEM = "99COSYTE";
+function animalCode(value, text) {
+  return Object.freeze({ code: value, text, system: ANIMAL_CODE_SYSTEM });
+}
+function animalSpecies(value, text, breeds) {
+  return Object.freeze({ ...animalCode(value, text), breeds: Object.freeze([...breeds]) });
+}
+
+// src/safe/animal.ts
+var SYNTHETIC_ANIMAL_SPECIES = Object.freeze([
+  animalSpecies("DOG", "Dog", [
+    animalCode("DOG-LAB", "Labrador Retriever"),
+    animalCode("DOG-BGL", "Beagle"),
+    animalCode("DOG-MIX", "Mixed breed dog")
+  ]),
+  animalSpecies("CAT", "Cat", [animalCode("CAT-DSH", "Domestic Shorthair"), animalCode("CAT-SIA", "Siamese")]),
+  animalSpecies("HORSE", "Horse", [animalCode("HRS-QTR", "Quarter Horse"), animalCode("HRS-TB", "Thoroughbred")]),
+  animalSpecies("CATTLE", "Cattle", [animalCode("CTL-HOL", "Holstein"), animalCode("CTL-ANG", "Angus")])
+]);
+var SYNTHETIC_PET_NAMES = Object.freeze([
+  "Fixturepaw",
+  "Mockwhisker",
+  "Stubtail",
+  "Seedpup",
+  "Testbiscuit",
+  "Placepurr",
+  "Synthfur",
+  "Dummymane",
+  "Examplehoof",
+  "Fauxfluff",
+  "Samplesnout",
+  "Voidwag"
+]);
+var MICROCHIP_TEST_PREFIX = "999";
+function petName(rng) {
+  return rng.pick(SYNTHETIC_PET_NAMES);
+}
+function animalBreed(rng) {
+  const picked = rng.pick(SYNTHETIC_ANIMAL_SPECIES);
+  const { breeds, ...bare } = picked;
+  return { species: Object.freeze(bare), breed: rng.pick(breeds) };
+}
+function microchip(rng) {
+  return `${MICROCHIP_TEST_PREFIX}${rng.digits(12)}`;
+}
+function animalBirthDate(rng, onDate) {
+  const year = Number(onDate.slice(0, 4));
+  const month = Number(onDate.slice(4, 6)) - 1;
+  const day = Number(onDate.slice(6, 8));
+  const latest = Date.UTC(year, month, day);
+  const earliest = Date.UTC(year - 20, month, day);
+  const span = Math.round((latest - earliest) / 864e5);
+  const born = new Date(latest - rng.int(0, span) * 864e5);
+  return born.toISOString().slice(0, 10).replace(/-/g, "");
+}
+
 // src/safe/index.ts
 var safe = Object.freeze({
   ssn,
@@ -493,7 +618,11 @@ var safe = Object.freeze({
   address,
   dateYmd,
   npi,
-  dea
+  dea,
+  petName,
+  animalBreed,
+  microchip,
+  animalBirthDate
 });
 
 // src/x12/identity.ts
@@ -615,6 +744,10 @@ function resolveMix(allowed, requested, fallback) {
   if (requested === void 0) return fallback;
   return requested.map((entry) => resolveKind(allowed, entry));
 }
+function requireSelection(selection) {
+  if (selection.length === 0) throw new SynthError(SYNTH_FATAL_CODES.SYNTH_EMPTY_POOL);
+  return selection;
+}
 
 // src/x12/claim-837.ts
 var CLAIM_837_VARIANTS = Object.freeze(["P", "I", "D"]);
@@ -1051,11 +1184,11 @@ function generateKind(kind, seed) {
 }
 function x12Corpus(options) {
   const { seed, verify = true } = options;
-  const mix = resolveMix(ALL_KINDS, options.mix, DEFAULT_MIX);
+  const mix = requireSelection(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] ?? "837P";
+    const kind = mix[i % mix.length];
     const txSeed = seedStream.nextUint32();
     const rt = x12CorpusArtifact(generateKind(kind, txSeed), verify);
     return {