vet-sdk-core-ts 0.4.0

package/dist/species.d.ts

@@ -0,0 +1,484 @@
+export type NcbiTaxonomyId = `${number}`;
+export type VetChainAnimalGroup = "companion-mammal" | "equid-camelid" | "livestock" | "bird" | "aquatic" | "reptile-amphibian" | "managed-invertebrate";
+export type VetChainSpeciesDefinition = Readonly<{
+    /** Stable code used for application data and locale lookups. */
+    key: string;
+    /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+    ncbiTaxonomyId: NcbiTaxonomyId;
+    /** NCBI scientific name. This is reference data, not localized UI copy. */
+    scientificName: string;
+    group: VetChainAnimalGroup;
+}>;
+/**
+ * Governed starter catalogue for domesticated and commonly kept animals.
+ *
+ * This is deliberately extensible: VetChain accepts other verified non-human
+ * NCBI Taxonomy identifiers without pretending that any static list can cover
+ * every species kept in every jurisdiction. Localized common names belong in
+ * portal i18n and use these stable keys.
+ */
+export declare const VetChainDomesticAnimalSpecies: Readonly<{
+    readonly Dog: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Cat: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Rabbit: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly DomesticFerret: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly DomesticGuineaPig: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly GoldenHamster: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly ChineseHamster: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly HouseMouse: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly NorwayRat: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly AfricanPygmyHedgehog: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Horse: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Donkey: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Llama: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Alpaca: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly DromedaryCamel: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly BactrianCamel: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly DomesticCattle: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly ZebuCattle: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly WaterBuffalo: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly DomesticYak: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Goat: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Sheep: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Pig: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Reindeer: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Chicken: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Turkey: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly DomesticDuck: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly DomesticGoose: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly RockPigeon: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Budgerigar: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Cockatiel: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Canary: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly PeachFacedLovebird: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Goldfish: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly CommonCarp: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Betta: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Guppy: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Zebrafish: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly NileTilapia: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly AtlanticSalmon: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly RainbowTrout: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly CentralBeardedDragon: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly BallPython: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly CornSnake: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly LeopardGecko: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly RedEaredSlider: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly GreekTortoise: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly Axolotl: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly HoneyBee: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+    readonly DomesticSilkworm: Readonly<{
+        /** Stable code used for application data and locale lookups. */
+        key: string;
+        /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+        ncbiTaxonomyId: NcbiTaxonomyId;
+        /** NCBI scientific name. This is reference data, not localized UI copy. */
+        scientificName: string;
+        group: VetChainAnimalGroup;
+    }>;
+}>;
+export type VetChainDomesticAnimalSpeciesKey = keyof typeof VetChainDomesticAnimalSpecies;
+export declare const VetChainDomesticAnimalSpeciesList: readonly Readonly<{
+    /** Stable code used for application data and locale lookups. */
+    key: string;
+    /** Authoritative NCBI Taxonomy identifier, stored without zero padding. */
+    ncbiTaxonomyId: NcbiTaxonomyId;
+    /** NCBI scientific name. This is reference data, not localized UI copy. */
+    scientificName: string;
+    group: VetChainAnimalGroup;
+}>[];
+export declare function findVetChainSpeciesByTaxonomyId(value: string): VetChainSpeciesDefinition | undefined;
+/** The current printed card layout can embed only NCBI Taxonomy IDs of at most five digits. */
+export declare function isVetChainSpeciesCode5Compatible(value: string): boolean;

package/dist/species.js

@@ -0,0 +1,76 @@
+// Copyright 2026 Connecting Solution & Applications Ltd under the Apache License, Version 2.0.
+function species(key, ncbiTaxonomyId, scientificName, group) {
+    if (!/^[1-9]\d*$/.test(ncbiTaxonomyId) || ncbiTaxonomyId === "9606") {
+        throw new TypeError("A species requires a positive, non-human NCBI Taxonomy identifier.");
+    }
+    return Object.freeze({ key, ncbiTaxonomyId, scientificName, group });
+}
+/**
+ * Governed starter catalogue for domesticated and commonly kept animals.
+ *
+ * This is deliberately extensible: VetChain accepts other verified non-human
+ * NCBI Taxonomy identifiers without pretending that any static list can cover
+ * every species kept in every jurisdiction. Localized common names belong in
+ * portal i18n and use these stable keys.
+ */
+export const VetChainDomesticAnimalSpecies = Object.freeze({
+    Dog: species("Dog", "9615", "Canis lupus familiaris", "companion-mammal"),
+    Cat: species("Cat", "9685", "Felis catus", "companion-mammal"),
+    Rabbit: species("Rabbit", "9986", "Oryctolagus cuniculus", "companion-mammal"),
+    DomesticFerret: species("DomesticFerret", "9669", "Mustela putorius furo", "companion-mammal"),
+    DomesticGuineaPig: species("DomesticGuineaPig", "10141", "Cavia porcellus", "companion-mammal"),
+    GoldenHamster: species("GoldenHamster", "10036", "Mesocricetus auratus", "companion-mammal"),
+    ChineseHamster: species("ChineseHamster", "10029", "Cricetulus griseus", "companion-mammal"),
+    HouseMouse: species("HouseMouse", "10090", "Mus musculus", "companion-mammal"),
+    NorwayRat: species("NorwayRat", "10116", "Rattus norvegicus", "companion-mammal"),
+    AfricanPygmyHedgehog: species("AfricanPygmyHedgehog", "9368", "Atelerix albiventris", "companion-mammal"),
+    Horse: species("Horse", "9796", "Equus caballus", "equid-camelid"),
+    Donkey: species("Donkey", "9793", "Equus asinus", "equid-camelid"),
+    Llama: species("Llama", "9844", "Lama glama", "equid-camelid"),
+    Alpaca: species("Alpaca", "30538", "Vicugna pacos", "equid-camelid"),
+    DromedaryCamel: species("DromedaryCamel", "9838", "Camelus dromedarius", "equid-camelid"),
+    BactrianCamel: species("BactrianCamel", "9837", "Camelus bactrianus", "equid-camelid"),
+    DomesticCattle: species("DomesticCattle", "9913", "Bos taurus", "livestock"),
+    ZebuCattle: species("ZebuCattle", "9915", "Bos indicus", "livestock"),
+    WaterBuffalo: species("WaterBuffalo", "89462", "Bubalus bubalis", "livestock"),
+    DomesticYak: species("DomesticYak", "30521", "Bos grunniens", "livestock"),
+    Goat: species("Goat", "9925", "Capra hircus", "livestock"),
+    Sheep: species("Sheep", "9940", "Ovis aries", "livestock"),
+    Pig: species("Pig", "9823", "Sus scrofa", "livestock"),
+    Reindeer: species("Reindeer", "9870", "Rangifer tarandus", "livestock"),
+    Chicken: species("Chicken", "9031", "Gallus gallus", "bird"),
+    Turkey: species("Turkey", "9103", "Meleagris gallopavo", "bird"),
+    DomesticDuck: species("DomesticDuck", "8839", "Anas platyrhynchos", "bird"),
+    DomesticGoose: species("DomesticGoose", "8843", "Anser anser", "bird"),
+    RockPigeon: species("RockPigeon", "8932", "Columba livia", "bird"),
+    Budgerigar: species("Budgerigar", "13146", "Melopsittacus undulatus", "bird"),
+    Cockatiel: species("Cockatiel", "13180", "Nymphicus hollandicus", "bird"),
+    Canary: species("Canary", "9135", "Serinus canaria", "bird"),
+    PeachFacedLovebird: species("PeachFacedLovebird", "60468", "Agapornis roseicollis", "bird"),
+    Goldfish: species("Goldfish", "7957", "Carassius auratus", "aquatic"),
+    CommonCarp: species("CommonCarp", "7962", "Cyprinus carpio", "aquatic"),
+    Betta: species("Betta", "158456", "Betta splendens", "aquatic"),
+    Guppy: species("Guppy", "8081", "Poecilia reticulata", "aquatic"),
+    Zebrafish: species("Zebrafish", "7955", "Danio rerio", "aquatic"),
+    NileTilapia: species("NileTilapia", "8128", "Oreochromis niloticus", "aquatic"),
+    AtlanticSalmon: species("AtlanticSalmon", "8030", "Salmo salar", "aquatic"),
+    RainbowTrout: species("RainbowTrout", "8022", "Oncorhynchus mykiss", "aquatic"),
+    CentralBeardedDragon: species("CentralBeardedDragon", "103695", "Pogona vitticeps", "reptile-amphibian"),
+    BallPython: species("BallPython", "51751", "Python regius", "reptile-amphibian"),
+    CornSnake: species("CornSnake", "94885", "Pantherophis guttatus", "reptile-amphibian"),
+    LeopardGecko: species("LeopardGecko", "481883", "Eublepharis macularius", "reptile-amphibian"),
+    RedEaredSlider: species("RedEaredSlider", "31138", "Trachemys scripta elegans", "reptile-amphibian"),
+    GreekTortoise: species("GreekTortoise", "86975", "Testudo graeca", "reptile-amphibian"),
+    Axolotl: species("Axolotl", "8296", "Ambystoma mexicanum", "reptile-amphibian"),
+    HoneyBee: species("HoneyBee", "7460", "Apis mellifera", "managed-invertebrate"),
+    DomesticSilkworm: species("DomesticSilkworm", "7091", "Bombyx mori", "managed-invertebrate"),
+});
+export const VetChainDomesticAnimalSpeciesList = Object.freeze(Object.values(VetChainDomesticAnimalSpecies));
+export function findVetChainSpeciesByTaxonomyId(value) {
+    const normalized = value.trim();
+    return VetChainDomesticAnimalSpeciesList.find((entry) => entry.ncbiTaxonomyId === normalized);
+}
+/** The current printed card layout can embed only NCBI Taxonomy IDs of at most five digits. */
+export function isVetChainSpeciesCode5Compatible(value) {
+    return /^[1-9]\d{0,4}$/.test(value) && value !== "9606";
+}

package/node_modules/vet-data-utils-ts/README.md

@@ -0,0 +1,14 @@
+# vet-data-utils-ts
+
+Browser-safe, transport-neutral VetChain data contracts shared by GW VET and
+`vet-sdk-core-ts`. The package owns governed values and validation only; GW VET
+owns authorization and the SDK owns request construction.
+
+Current surfaces cover the canonical animal-card DID, veterinary summary
+sections, animal-only emergency data, pseudonymous DigitalTwin search input and
+veterinary assistant intents.
+
+The catalogue retains longitudinal sections that also apply to animal care,
+with animal-facing labels where needed. Human advance directives
+(`LOINC|42348-3`) are deliberately excluded because they express the patient's
+own legal/autonomy decisions, not controller preferences.

package/node_modules/vet-data-utils-ts/dist/animal-card.d.ts

@@ -0,0 +1,14 @@
+export type VetChainAnimalCardIdentity = Readonly<{
+    did: string;
+    host: string;
+    jurisdictionCode5: string;
+    animalNumericId15: string;
+    checkDigit1: string;
+    animalId16: string;
+    cardNumber21: string;
+}>;
+/** Parses only the current VetChain card DID; legacy UHC animal aliases are rejected. */
+export declare function parseVetChainAnimalCardDid(value: unknown): VetChainAnimalCardIdentity;
+export declare function isVetChainAnimalCardDid(value: unknown): value is string;
+/** Returns the Damm digit that makes the complete decimal card validate to zero. */
+export declare function computeVetChainDammCheckDigit(value: string): string;

package/node_modules/vet-data-utils-ts/dist/animal-card.js

@@ -0,0 +1,44 @@
+const CARD_DID = /^did:web:([^:]+):card:vetchain:(\d{5}):(\d{16})$/i;
+/** Parses only the current VetChain card DID; legacy UHC animal aliases are rejected. */
+export function parseVetChainAnimalCardDid(value) {
+    const did = String(value || '').trim();
+    const match = CARD_DID.exec(did);
+    if (!match)
+        throw new TypeError('vet_animal_card_did_invalid');
+    const [, host, jurisdictionCode5, animalId16] = match;
+    const cardNumber21 = `${jurisdictionCode5}${animalId16}`;
+    return Object.freeze({
+        did,
+        host: host.toLowerCase(),
+        jurisdictionCode5,
+        animalNumericId15: animalId16.slice(0, 15),
+        checkDigit1: animalId16.slice(15),
+        animalId16,
+        cardNumber21,
+    });
+}
+export function isVetChainAnimalCardDid(value) {
+    try {
+        parseVetChainAnimalCardDid(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Returns the Damm digit that makes the complete decimal card validate to zero. */
+export function computeVetChainDammCheckDigit(value) {
+    if (!/^\d+$/.test(value))
+        throw new TypeError('vet_animal_card_damm_input_invalid');
+    let interim = 0;
+    for (const digit of value)
+        interim = DAMM_TABLE[interim][Number(digit)];
+    return String(interim);
+}
+const DAMM_TABLE = [
+    [0, 3, 1, 7, 5, 9, 8, 6, 4, 2], [7, 0, 9, 2, 1, 5, 4, 8, 6, 3],
+    [4, 2, 0, 6, 8, 7, 1, 3, 5, 9], [1, 7, 5, 0, 9, 8, 3, 4, 2, 6],
+    [6, 1, 2, 3, 0, 4, 5, 9, 7, 8], [3, 6, 7, 4, 2, 0, 9, 5, 8, 1],
+    [5, 8, 6, 9, 7, 2, 0, 1, 3, 4], [8, 9, 4, 5, 3, 6, 2, 0, 1, 7],
+    [9, 4, 3, 8, 6, 1, 7, 2, 0, 5], [2, 5, 8, 1, 4, 3, 6, 7, 9, 0],
+];

package/node_modules/vet-data-utils-ts/dist/assistant.d.ts

@@ -0,0 +1,7 @@
+export declare const VeterinaryAssistantIntents: Readonly<{
+    readonly ExplainAnimalIdentity: "explain-animal-identity";
+    readonly ExplainPermissions: "explain-permissions";
+    readonly ExplainEmergencyAccess: "explain-emergency-access";
+    readonly ExplainDigitalTwin: "explain-digital-twin";
+}>;
+export type VeterinaryAssistantIntent = typeof VeterinaryAssistantIntents[keyof typeof VeterinaryAssistantIntents];

package/node_modules/vet-data-utils-ts/dist/assistant.js

@@ -0,0 +1,6 @@
+export const VeterinaryAssistantIntents = Object.freeze({
+    ExplainAnimalIdentity: 'explain-animal-identity',
+    ExplainPermissions: 'explain-permissions',
+    ExplainEmergencyAccess: 'explain-emergency-access',
+    ExplainDigitalTwin: 'explain-digital-twin',
+});

package/node_modules/vet-data-utils-ts/dist/digital-twin.d.ts

@@ -0,0 +1,13 @@
+export declare const VeterinaryDigitalTwinFormats: Readonly<{
+    readonly Api: "org.hl7.fhir.api";
+    readonly R4: "org.hl7.fhir.r4";
+}>;
+export type VeterinaryDigitalTwinFormat = typeof VeterinaryDigitalTwinFormats[keyof typeof VeterinaryDigitalTwinFormats];
+export type VeterinaryDigitalTwinSearch = Readonly<{
+    section: string;
+    resourceType: string;
+    claim: string;
+    value: string;
+}>;
+/** Bounds one section-first pseudonymous search and rejects direct identifiers. */
+export declare function parseVeterinaryDigitalTwinSearch(input: unknown): VeterinaryDigitalTwinSearch;