@cosyte/synth 0.1.9 → 0.1.11

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.1.11
+
+### Patch Changes
+
+- c913601: Docs: no example prints a whole message or a value that identifies a person any more, and a new section, What is safe to log, lists the result fields never to log. No code changes.
+
+  The HL7 v2 generators' TSDoc examples, the README, the quickstart and the HL7 example program now print the message type, codes and booleans, and show an identifying value only in a comment marked synthetic. The README and the installation page say to pin the exact version, since below 1.0 a breaking change can ship in a patch. What is safe to log, on the fatal codes page, names `content`, `original`, `deidentified` and a sentinel's `token` as the fields that hold a whole artifact or a planted value. Nothing a caller does changes.
+
+- 70c322c: Docs: the golden fixture page is now `pin-a-golden-fixture` (it was `guides-overview`), the limitations page moves to Reference, and the reason the deid pairing loop reads only the patient fields has its own explanation page. The README links follow. No code changes.
+
+## 0.1.10
+
+### Patch Changes
+
+- 3156ab8: The README's Status section now points at the page that lists what is not generated yet, instead of repeating that list. Its Documentation section links the new pages: a tutorial for each of FHIR, C-CDA, X12, NCPDP and ASTM beside the HL7 v2 one, a reference of every generator option, corpus kind and profile, a page on how `@cosyte/synth` differs from Synthea, faker-style libraries and other healthcare generators, and a glossary. No code changed, and generated output is unchanged.
+- 3156ab8: An empty selection list is now refused with `SYNTH_EMPTY_POOL`, in every format, before anything is generated and whatever the `count`. That covers an empty `mix` in `hl7Corpus`, `fhirCorpus`, `ccdaCorpus`, `x12Corpus`, `ncpdpCorpus` and `astmCorpus`, an empty `triggers` list in `hl7Corpus`, and an empty `quirks` list, or a `profile` whose `quirks` is an empty list, in `hl7QuirkCorpus`, `ccdaQuirkCorpus` and `astmQuirkCorpus`. Before, an empty `mix` with a count above zero quietly filled the corpus with one hard-coded kind (`hl7Corpus({ seed, mix: [] })` returned one `ADT^A01`), an empty `mix` with no count in the X12, NCPDP and ASTM corpora returned an empty corpus, and an empty `quirks` list was read as every quirk. What a caller changes: leave `mix`, `triggers`, `quirks` and `profile` out to get the default, instead of passing an empty list. Output for every non-empty selection is unchanged, byte for byte.
+- 3156ab8: HL7 v2 now generates ten more kinds, each built through `@cosyte/hl7`, read back with zero warnings, and fixed by its seed: `ACK`, `ADT^A02` (transfer), `ADT^A03` (discharge), `ADT^A11` (cancel admit), `ADT^A13` (cancel discharge), `ADT^A28` and `ADT^A31` (add and update person information), `MDM^T02` (a document and its text), `DFT^P03` (a posted charge) and `OML^O21` (a laboratory order). New exports from `@cosyte/synth/hl7`: `generateAck`, which answers any message (generated or your own) with an `AA`, `AE` or `AR` acknowledgment whose MSA-2 echoes its control id; `generateMdm`, `generateDft` and `generateOml`; and `HL7_MESSAGE_KINDS`, every kind `generateHl7` and `hl7Corpus` accept. `generateAdt` and the `triggers` option take the six new ADT triggers. The new kinds name their message structure in MSH-9.3. `generateAck` refuses an inbound message with no MSH-10 with the new fatal code `SYNTH_ACK_UNCORRELATED`.
+
+  Every message is still stamped HL7 v2.5: there is no option to stamp another version, because `@cosyte/hl7` has no per-version structure check to prove such a message valid. `RDE^O11` is not generated yet, because `@cosyte/hl7` publishes no structure for it.
+
+  Output for every existing kind is unchanged, byte for byte, and the default `hl7Corpus` mix is still the first seven kinds, so a seed's default corpus is unchanged: name the new kinds in `mix`, or pass `HL7_MESSAGE_KINDS`, to include them. What a caller changes: nothing, unless your code switches exhaustively over `Hl7MessageKind`, `AdtTrigger` or `SynthFatalCode`, each of which now has more members; add cases for them, or a default branch.
+
+- 3156ab8: HL7 v2 `generateAdt` and `generateOru` take a new option, `subject`: `"person"` (the default) or `"animal"`. An animal message carries the pet's name in PID-5 (the owner's family name, then the pet's), the record number and a 15-digit microchip with identifier type `MCN` in PID-3, a birth date from 0 to 20 years before the message date in PID-7, the species in PID-35 and the breed in PID-36 as `code^text^99COSYTE`, and the owner in an `NK1` after the `PID` with relationship `OWN^Owner^HL70063`. PID-19 stays empty. Every trigger and `ORU^R01` read back through `@cosyte/hl7` with zero warnings.
+
+  Species and breed come from our own short list (dog, cat, horse and cattle, two or three breeds each) under the local code system `99COSYTE`: no SNOMED CT, VetSCT or VeNom content. Microchips begin `999`. We have not verified three things against the standards: that `999` is outside every country and manufacturer code ISO 11784 gives a real chip, that `MCN` is the HL7 table 0203 identifier type for a microchip, and that `OWN` is a value of HL7 table 0063. We emit them as written; the how-to marks each as not verified.
+
+  New exports from `@cosyte/synth`: `petName`, `animalBreed`, `microchip`, `animalBirthDate` (also on `safe`), `isSyntheticMicrochip`, `SYNTHETIC_PET_NAMES`, `SYNTHETIC_ANIMAL_SPECIES`, `ANIMAL_CODE_SYSTEM`, `MICROCHIP_TEST_PREFIX`, and the types `AnimalCode`, `AnimalSpecies` and `AnimalBreedDraw`. New exports from `@cosyte/synth/hl7`: `animalIdentity`, `animalPidSegment`, `ownerNk1Segment`, `MICROCHIP_IDENTIFIER_TYPE`, `OWNER_RELATIONSHIP`, and the types `AnimalIdentity`, `AnimalOwner` and `Hl7Subject`. The animal identity is exported from the package root and `@cosyte/synth/hl7` because synth has no `./arbitraries` subpath yet; adding one, with a fast-check arbitrary for the animal identity, is left for a later change.
+
+  Output with `subject` left out is unchanged, byte for byte. What a caller changes: nothing, unless your code enumerates the keys of `safe`, which now has four more.
+
+- 3156ab8: A profile that leaves `quirks` out is no longer read as an empty quirk list. `defineSynthProfile({ name, givenNames })` now returns a profile with no `quirks` field, and `hl7QuirkCorpus`, `ccdaQuirkCorpus` and `astmQuirkCorpus` given such a profile use their `quirks` option, or every quirk when that is left out too, the same as with no profile. A profile whose `quirks` is an empty list still selects nothing and throws `SYNTH_EMPTY_POOL`. Before, `defineSynthProfile` filled a missing `quirks` with an empty list, so a profile made only for its name pools threw `SYNTH_EMPTY_POOL` in a quirk corpus. The `defineSynthProfile` example passed `quirks: []`, which a quirk corpus refuses; it now builds a profile of name pools that leaves `quirks` out. `validateProfileQuirks` now returns every quirk in the registry for a profile that leaves `quirks` out. What a caller changes: `SynthProfile.quirks` is now optional, so code that reads it directly handles `undefined` (`profile.quirks ?? []` keeps the old reading). Output for every profile that sets `quirks` is unchanged, byte for byte.
+- 3156ab8: A generator whose parser is not installed now throws a `SynthError` with the new code `SYNTH_PEER_NOT_INSTALLED`, the same from the ES module build and the CommonJS build. Its message names the package and the command that installs it ("@cosyte/hl7 is not installed, and this generator builds through it. Install it beside @cosyte/synth: npm install @cosyte/hl7"), `err.peer` is the package, and `err.cause` is the error Node.js raised. Before, the CommonJS build threw `require`'s "Cannot find module '@cosyte/hl7'" (`MODULE_NOT_FOUND`), and the ES module build threw the same until the change below, which would have made it throw the resolver's "Cannot find package '@cosyte/hl7' imported from ..." (`ERR_MODULE_NOT_FOUND`). A caller that matched either message, or either Node.js code, checks `err.code === "SYNTH_PEER_NOT_INSTALLED"` instead, or reads `err.cause.code`. A missing dependency of an installed parser is not reported as the parser missing: that error is thrown as Node.js raised it. `SynthError` takes an optional second argument, `{ cause, peer }`, and the package root exports `SYNTH_PEER_MESSAGES` (one fixed message for each parser package) and the types `SynthPeer` and `SynthErrorOptions`.
+
+  A generator falls back to loading a parser by name only where `import.meta.resolve` throws the error Deno's test runner throws (`TypeError: Invalid arguments`), or answers with a URL that is not a `file:` URL. Before, any error from resolving fell back, so on Node.js a resolve that failed for another reason could load the CommonJS copy of a parser, whose classes `instanceof` does not recognize. Now such an error is thrown, and so is a `file:` URL that names no file path, which also used to fall back. The Deno case matches on that error's message, and no CI job runs under Deno yet, so it is tested only against a stand-in that throws the same error.
+
+  The synthetic-safety providers are now tested against the published ranges they cite, and three functions in that module read more simply with the same results. `isSyntheticPhone` checks that the number's digits end in `55501NN` with one pattern where it used two, and gives the same answer for every input. `luhnMod10` tests a doubled digit for 10 or more before subtracting 9, where it tested for more than 9. `ssn(rng, block?)` declares its second parameter optional instead of giving it a default; leaving it out still draws the never-issued space, and its type is unchanged. Generated output is unchanged.
+
+- 3156ab8: The release version script now regenerates the generated API reference, so the version shown on the API page matches the `VERSION` constant after a version bump. No change to the package contents or its API.
+
 ## 0.1.9
 
 ### Patch Changes

package/README.md

@@ -34,10 +34,10 @@ date, phone, and address from a **guaranteed-non-colliding synthetic source**. I
 ## Status
 
 The 0.1 line, published to npm. The version shown on the npm package page is the one
-that is live; this page never repeats it. Below 1.0, a breaking change raises the minor version and the
-changelog says what broke. The generator is **feature-complete**: the
+that is live; this page never repeats it. Every release is a patch, a breaking change included, and
+the changelog says what broke and what a caller must change. The generator is **feature-complete**: the
 seeded-PRNG core, the synthetic-safety providers, and the round-trip harness; **generation across all
-six formats**, HL7 v2 (`ADT`/`ORU`/`ORM`/`SIU`/`VXU`), FHIR R4 / US Core (the full clinical
+six formats**, HL7 v2 (`ADT`/`ORU`/`ORM`/`SIU`/`VXU`/`MDM`/`DFT`/`OML` and `ACK`), FHIR R4 / US Core (the full clinical
 set + `collection`/`transaction`/`document` Bundles), C-CDA R2.1 (CCD + Referral Note), X12 005010
 (837P/I/D, 835, 271), NCPDP (SCRIPT NewRx / RxRenewal / RxChange + Telecom B1/B2/B3), and ASTM (E1394
 record reports + E1381 framing), each built **through its parser's own builder/serializer**; **vendor-quirk
@@ -46,15 +46,22 @@ each round-tripping to exactly the intended parser warning (the intended-warning
 **`@cosyte/deid` pairing loop**, a closed-loop co-validation harness that de-identifies generated output
 and proves every planted synthetic PHI sentinel is removed.
 
-**Deferred (honestly out of scope for now):** quirk recipes for **FHIR / X12 / NCPDP** (and any quirk
-needing a private vendor corpus); the X12 **270** eligibility _request_ and NCPDP SCRIPT lifecycle
-**responses** (both track the parsers' builder surfaces); **NCPDP SCRIPT / ASTM / DICOM** de-identify
-pairing (no `@cosyte/deid` adapter, or not generated); and optional **Synthea** clinical-content ingestion.
+What is not generated yet (quirks for some formats, a few transactions, some pairing loops) is
+listed in one place, [what it does and does not do](https://docs.cosyte.com/synth/limitations),
+so this page does not repeat it.
 
 ## Install
 
 ```bash
-npm install @cosyte/synth @cosyte/hl7 @cosyte/fhir @cosyte/ccda @cosyte/x12 @cosyte/ncpdp @cosyte/astm
+npm install @cosyte/synth @cosyte/hl7 @cosyte/fhir @cosyte/ccda @cosyte/x12 @cosyte/ncpdp @cosyte/astm @cosyte/deid
+```
+
+**Pin the exact version.** Below 1.0 a breaking change can ship in a patch release, so a caret
+range (`^0.1.x`) does not protect you from one. Install with `--save-exact` (pnpm takes the same flag;
+Yarn's is `--exact`) and read the changelog before you move the pin:
+
+```bash
+npm install --save-exact @cosyte/synth
 ```
 
 Node.js 22.12 or later, tested on 22.12, 22, 24, and 26. A generator loads its parser on first use
@@ -68,10 +75,14 @@ Rollup and Vite `external`, webpack `externals`) and install them beside the bun
 `@cosyte/hl7`, `@cosyte/fhir`, `@cosyte/ccda`, `@cosyte/x12`, `@cosyte/ncpdp`, `@cosyte/astm`, and
 `@cosyte/deid` are **optional peer dependencies**, each needed only for its subpath (`@cosyte/synth/hl7`,
 `@cosyte/synth/fhir`, `@cosyte/synth/ccda`, `@cosyte/synth/x12`, `@cosyte/synth/ncpdp`,
-`@cosyte/synth/astm`, and `@cosyte/synth/deid`: the last loads `@cosyte/deid` **plus** the five
-parsers it pairs, `@cosyte/hl7`, `@cosyte/fhir`, `@cosyte/ccda`, `@cosyte/x12`, and `@cosyte/ncpdp`,
-as soon as it is imported): install only the packages whose fixtures you generate. The package core has
-**zero third-party runtime dependencies**.
+`@cosyte/synth/astm`, and `@cosyte/synth/deid`, whose peer is `@cosyte/deid`). Importing a subpath
+loads no parser: each loads the first time a generator needs it, so install only the packages whose
+fixtures you generate. A `@cosyte/synth/deid` loop also loads the parser of its own format, so
+`hl7DeidLoop` needs `@cosyte/deid` and `@cosyte/hl7`. A parser that is missing throws
+`SYNTH_PEER_NOT_INSTALLED` on first use, except under Bun in a project with no `node_modules` folder,
+where Bun downloads and loads it instead
+([Troubleshooting](https://docs.cosyte.com/synth/troubleshooting#a-parser-is-not-installed)). The
+package core has **zero third-party runtime dependencies**.
 
 ## Usage
 
@@ -80,8 +91,10 @@ on [docs.cosyte.com/synth](https://docs.cosyte.com/synth).
 
 ### Generate a spec-clean HL7 v2 message
 
-The HL7 v2 set covers `ADT` (`A01`/`A04`/`A08`), `ORU^R01`, `ORM^O01`, `SIU^S12`, and `VXU^V04`:
-each built through `@cosyte/hl7`'s `buildMessage`, so it is spec-clean by construction.
+The HL7 v2 set covers `ADT` (`A01`/`A02`/`A03`/`A04`/`A08`/`A11`/`A13`/`A28`/`A31`), `ORU^R01`,
+`ORM^O01`, `SIU^S12`, `VXU^V04`, `MDM^T02`, `DFT^P03`, `OML^O21`, and an `ACK` for any of them:
+each built through `@cosyte/hl7`'s `buildMessage`, so it is spec-clean by construction. Every
+message is stamped HL7 v2.5.
 
 ```ts
 import { generateAdt, generateOru, generateHl7, hl7Corpus, roundTrip } from "@cosyte/synth/hl7";
@@ -99,7 +112,8 @@ const corpus = hl7Corpus({ seed: 42, count: 7 }); // one of each family, cycled
 console.log(corpus.artifacts.every((a) => a.warnings.length === 0)); // true, all spec-clean
 
 // Dispatch by kind when the message type is data:
-console.log(roundTrip(generateHl7("VXU^V04", 12345)).content.split("\r")[0]); // its MSH segment
+const vxu = roundTrip(generateHl7("VXU^V04", 12345)).content;
+console.log(vxu.split("\r")[0]?.split("|")[8]); // VXU^V04, the type from MSH-9, never the whole segment
 ```
 
 ### Generate a spec-clean FHIR R4 / US Core resource
@@ -375,14 +389,20 @@ isSyntheticNpi(safe.npi(rng)); // true, always a deliberately-invalid-Luhn NPI (
 The full reference is on [docs.cosyte.com/synth](https://docs.cosyte.com/synth):
 
 - [Installation](https://docs.cosyte.com/synth/installation), the [quickstart](https://docs.cosyte.com/synth/quickstart), and
-  a tutorial: [test your HL7 handling with generated fixtures](https://docs.cosyte.com/synth/test-hl7-handling-with-fixtures).
+  a tutorial per format: test your [HL7 v2](https://docs.cosyte.com/synth/test-hl7-handling-with-fixtures),
+  [FHIR](https://docs.cosyte.com/synth/test-fhir-handling-with-fixtures), [C-CDA](https://docs.cosyte.com/synth/test-ccda-handling-with-fixtures),
+  [X12](https://docs.cosyte.com/synth/test-x12-handling-with-fixtures), [NCPDP](https://docs.cosyte.com/synth/test-ncpdp-handling-with-fixtures),
+  and [ASTM](https://docs.cosyte.com/synth/test-astm-handling-with-fixtures) handling with generated fixtures.
 - How-to guides: [HL7 v2](https://docs.cosyte.com/synth/guides-hl7), [FHIR R4 and US Core](https://docs.cosyte.com/synth/guides-fhir),
   [C-CDA](https://docs.cosyte.com/synth/guides-ccda), [X12](https://docs.cosyte.com/synth/guides-x12), [NCPDP](https://docs.cosyte.com/synth/guides-ncpdp),
   [ASTM](https://docs.cosyte.com/synth/guides-astm), [vendor quirks](https://docs.cosyte.com/synth/guides-quirks),
   [the `@cosyte/deid` pairing loop](https://docs.cosyte.com/synth/guides-deid), [synthetic values](https://docs.cosyte.com/synth/draw-synthetic-values),
-  and [pinning a golden fixture](https://docs.cosyte.com/synth/guides-overview).
-- Explanation: [how it works](https://docs.cosyte.com/synth/concepts-archetype) and [what it does and does not do](https://docs.cosyte.com/synth/limitations).
-- Reference: [fatal codes](https://docs.cosyte.com/synth/fatal-codes), the [quirk catalog](https://docs.cosyte.com/synth/quirk-catalog), and the API reference.
+  and [pinning a golden fixture](https://docs.cosyte.com/synth/pin-a-golden-fixture).
+- Explanation: [how it works](https://docs.cosyte.com/synth/concepts-archetype), [why the removal check reads only the patient fields](https://docs.cosyte.com/synth/why-deid-checks-patient-fields),
+  and [Synthea, faker and other generators](https://docs.cosyte.com/synth/synthea-faker-and-other-generators).
+- Reference: [generator options, kinds and profiles](https://docs.cosyte.com/synth/generator-options), [fatal codes](https://docs.cosyte.com/synth/fatal-codes),
+  the [quirk catalog](https://docs.cosyte.com/synth/quirk-catalog), the [glossary](https://docs.cosyte.com/synth/glossary), [what it does and does not do](https://docs.cosyte.com/synth/limitations), and the
+  [API reference](https://github.com/cosyte/synth/blob/main/docs-content/api/README.md), generated from the source.
 - [Troubleshooting](https://docs.cosyte.com/synth/troubleshooting), [testing and quality](https://docs.cosyte.com/synth/testing-and-quality), and [performance](https://docs.cosyte.com/synth/performance).
 - [`CHANGELOG.md`](https://github.com/cosyte/synth/blob/main/CHANGELOG.md): every release.
 

package/dist/animal-code-Bdl_9Jma.d.cts

@@ -0,0 +1,30 @@
+/**
+ * The two helpers that build the animal species and breed list in `./animal.ts`. They live in a
+ * module of their own, which the package does not export, so a test can call them directly and
+ * every mutant in them meets a test of its own.
+ *
+ * @module
+ */
+/** A species or breed: our own code, its plain text, and the local code system. */
+interface AnimalCode {
+    /** Our own short code, for example `DOG` or `DOG-BGL`. */
+    readonly code: string;
+    /** The plain text, for example `Dog` or `Beagle`. */
+    readonly text: string;
+    /** Always {@link ANIMAL_CODE_SYSTEM}. */
+    readonly system: string;
+}
+/** A species and the breeds this package draws for it. */
+interface AnimalSpecies extends AnimalCode {
+    /** The breeds of this species, at least one. */
+    readonly breeds: readonly AnimalCode[];
+}
+/**
+ * The local code system for species and breed codes, in the HL7 table 0396 form for a local
+ * system (`99` followed by letters). The codes under it are ours and name nothing outside this
+ * package.
+ */
+declare const ANIMAL_CODE_SYSTEM = "99COSYTE";
+
+export { ANIMAL_CODE_SYSTEM as b };
+export type { AnimalCode as A, AnimalSpecies as a };

package/dist/animal-code-Bdl_9Jma.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The two helpers that build the animal species and breed list in `./animal.ts`. They live in a
+ * module of their own, which the package does not export, so a test can call them directly and
+ * every mutant in them meets a test of its own.
+ *
+ * @module
+ */
+/** A species or breed: our own code, its plain text, and the local code system. */
+interface AnimalCode {
+    /** Our own short code, for example `DOG` or `DOG-BGL`. */
+    readonly code: string;
+    /** The plain text, for example `Dog` or `Beagle`. */
+    readonly text: string;
+    /** Always {@link ANIMAL_CODE_SYSTEM}. */
+    readonly system: string;
+}
+/** A species and the breeds this package draws for it. */
+interface AnimalSpecies extends AnimalCode {
+    /** The breeds of this species, at least one. */
+    readonly breeds: readonly AnimalCode[];
+}
+/**
+ * The local code system for species and breed codes, in the HL7 table 0396 form for a local
+ * system (`99` followed by letters). The codes under it are ours and name nothing outside this
+ * package.
+ */
+declare const ANIMAL_CODE_SYSTEM = "99COSYTE";
+
+export { ANIMAL_CODE_SYSTEM as b };
+export type { AnimalCode as A, AnimalSpecies as a };

package/dist/astm/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 });
   }
 };
 
@@ -224,7 +262,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;
@@ -321,7 +359,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))}`;
   }
@@ -448,6 +486,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,
@@ -461,7 +556,11 @@ var safe = Object.freeze({
   address,
   dateYmd,
   npi,
-  dea
+  dea,
+  petName,
+  animalBreed,
+  microchip,
+  animalBirthDate
 });
 
 // src/astm/identity.ts
@@ -600,19 +699,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);
-  let entry;
+  let url$1;
   try {
-    entry = url.fileURLToPath(host.resolve(specifier));
-  } catch {
+    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(entry);
+    return host.require(url.fileURLToPath(url$1));
   } catch (error) {
     if (!isRequireEsmRefusal(error)) throw error;
     return host.require(specifier);
@@ -735,6 +859,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/profile.ts
 function defineSynthProfile(spec) {
@@ -745,7 +873,7 @@ function defineSynthProfile(spec) {
     name: spec.name,
     ...spec.givenNames ? { givenNames: Object.freeze([...spec.givenNames]) } : {},
     ...spec.familyNames ? { familyNames: Object.freeze([...spec.familyNames]) } : {},
-    quirks: Object.freeze([...spec.quirks ?? []])
+    ...spec.quirks !== void 0 ? { quirks: Object.freeze([...spec.quirks]) } : {}
   });
 }
 
@@ -787,6 +915,7 @@ function assertIntendedWarnings(intendedWarnings, bareWarnings) {
   }
 }
 function validateProfileQuirks(profile, registry, format) {
+  if (profile.quirks === void 0) return Object.keys(registry);
   for (const name2 of profile.quirks) resolveQuirk(registry, format, name2);
   return profile.quirks;
 }
@@ -895,8 +1024,9 @@ var ALL_ASTM_QUIRKS = Object.freeze(
   Object.keys(ASTM_QUIRKS)
 );
 function astmQuirkCorpus(options) {
-  const quirks = options.profile ? validateProfileQuirks(options.profile, ASTM_QUIRKS, "astm") : options.quirks ?? ALL_ASTM_QUIRKS;
-  const names = quirks.length > 0 ? quirks : ALL_ASTM_QUIRKS;
+  const names = requireSelection(
+    options.profile?.quirks !== void 0 ? validateProfileQuirks(options.profile, ASTM_QUIRKS, "astm") : options.quirks ?? ALL_ASTM_QUIRKS
+  );
   for (const name2 of names) resolveQuirk(ASTM_QUIRKS, "astm", name2);
   const count = options.count ?? names.length;
   const seedStream = createRng(options.seed);
@@ -931,11 +1061,11 @@ function generateKind(kind, seed, verify) {
 }
 function astmCorpus(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] ?? "Result";
+    const kind = mix[i % mix.length];
     const msgSeed = seedStream.nextUint32();
     const rt = generateKind(kind, msgSeed, verify);
     return {