vet-data-utils-ts 0.4.9 → 0.4.11

package/README.md

@@ -13,6 +13,18 @@ Reusable Communication screens receive immutable workflow presets from
 FHIR `notification` plus HL7 v3 ActReason `HRESCH` and does not expose a topic
 picker. See [`docs/communication-inbox-filters.md`](docs/communication-inbox-filters.md).
 
+Veterinary clinical entry screens obtain their allowed coding systems from
+`vet-data-utils-ts/clinical-terminology`. Observations and diagnostic reports
+use LOINC; conditions additionally support ICD-10; SNOMED CT is offered for
+conditions, procedures and allergies only when the selected ISO country is an
+official SNOMED member territory. A returned candidate is never accepted
+automatically: the professional must review and select it before creating the
+FHIR resource. Membership does not replace national edition, attribution or
+affiliate-license requirements. See the [official member list](https://www.snomed.org/members).
+Veterinary immunizations use the distinct WHO ATCvet classification (group QI
+for immunologicals), with SNOMED CT as an additional candidate system where
+territorial use is permitted; ordinary human ATC is not substituted for it.
+
 The deferred spreadsheet shape for member and employee role assignments is
 documented in [`docs/member-import-contract.md`](docs/member-import-contract.md).
 It is not an implemented importer API.

package/dist/clinical-terminology.d.ts

@@ -0,0 +1,20 @@
+export declare const VeterinaryClinicalTerminologySystems: Readonly<{
+    readonly Loinc: "http://loinc.org";
+    readonly SnomedCt: "http://snomed.info/sct";
+    readonly Icd10: "http://hl7.org/fhir/sid/icd-10";
+    /** WHO Collaborating Centre ATCvet classification, distinct from human ATC. */
+    readonly AtcVet: "http://www.whocc.no/atcvet";
+}>;
+/**
+ * ISO 3166-1 alpha-2 territories enumerated by the official SNOMED
+ * International member page on 2026-09-05.
+ * https://www.snomed.org/members
+ *
+ * The page prose currently says 53 while its regional lists contain 54; this
+ * contract follows every named territory and must be refreshed from the source.
+ * Membership permits use within the territory but does not replace national
+ * release, edition, attribution or affiliate-license requirements.
+ */
+export declare const SnomedMemberCountryCodes: readonly ["AR", "BZ", "CA", "CL", "CR", "SV", "JM", "US", "UY", "AD", "AT", "BE", "HR", "CY", "CZ", "DK", "EE", "FI", "FR", "DE", "HU", "IS", "IE", "IL", "JO", "LV", "LT", "LU", "MT", "NL", "NO", "PT", "QA", "SI", "SA", "SK", "ZA", "ES", "SE", "CH", "AE", "GB", "AU", "BN", "HK", "IN", "ID", "MY", "MN", "NZ", "KR", "SG", "TH", "UZ"];
+export type VeterinaryCodedResourceType = 'Condition' | 'Procedure' | 'DiagnosticReport' | 'Observation' | 'AllergyIntolerance' | 'Immunization';
+export declare function veterinaryTerminologySystemsFor(resourceType: VeterinaryCodedResourceType, countryCode: string): readonly string[];

package/dist/clinical-terminology.js

@@ -0,0 +1,44 @@
+export const VeterinaryClinicalTerminologySystems = Object.freeze({
+    Loinc: 'http://loinc.org',
+    SnomedCt: 'http://snomed.info/sct',
+    Icd10: 'http://hl7.org/fhir/sid/icd-10',
+    /** WHO Collaborating Centre ATCvet classification, distinct from human ATC. */
+    AtcVet: 'http://www.whocc.no/atcvet',
+});
+/**
+ * ISO 3166-1 alpha-2 territories enumerated by the official SNOMED
+ * International member page on 2026-09-05.
+ * https://www.snomed.org/members
+ *
+ * The page prose currently says 53 while its regional lists contain 54; this
+ * contract follows every named territory and must be refreshed from the source.
+ * Membership permits use within the territory but does not replace national
+ * release, edition, attribution or affiliate-license requirements.
+ */
+export const SnomedMemberCountryCodes = Object.freeze([
+    'AR', 'BZ', 'CA', 'CL', 'CR', 'SV', 'JM', 'US', 'UY',
+    'AD', 'AT', 'BE', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'HU',
+    'IS', 'IE', 'IL', 'JO', 'LV', 'LT', 'LU', 'MT', 'NL', 'NO', 'PT', 'QA',
+    'SI', 'SA', 'SK', 'ZA', 'ES', 'SE', 'CH', 'AE', 'GB',
+    'AU', 'BN', 'HK', 'IN', 'ID', 'MY', 'MN', 'NZ', 'KR', 'SG', 'TH', 'UZ',
+]);
+export function veterinaryTerminologySystemsFor(resourceType, countryCode) {
+    if (resourceType === 'Observation' || resourceType === 'DiagnosticReport') {
+        return [VeterinaryClinicalTerminologySystems.Loinc];
+    }
+    const permitsSnomed = SnomedMemberCountryCodes.includes(countryCode.toUpperCase());
+    if (resourceType === 'Condition') {
+        return permitsSnomed
+            ? [VeterinaryClinicalTerminologySystems.SnomedCt, VeterinaryClinicalTerminologySystems.Icd10]
+            : [VeterinaryClinicalTerminologySystems.Icd10];
+    }
+    if (resourceType === 'Immunization') {
+        // ATCvet group QI owns veterinary immunological products. SNOMED CT may
+        // additionally express a vaccine concept where territorial use permits it.
+        // https://atcddd.fhi.no/atcvet/atcvet_index/
+        return permitsSnomed
+            ? [VeterinaryClinicalTerminologySystems.AtcVet, VeterinaryClinicalTerminologySystems.SnomedCt]
+            : [VeterinaryClinicalTerminologySystems.AtcVet];
+    }
+    return permitsSnomed ? [VeterinaryClinicalTerminologySystems.SnomedCt] : [];
+}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './animal-card.js';
 export * from './assistant.js';
 export * from './communication.js';
+export * from './clinical-terminology.js';
 export * from './digital-twin.js';
 export * from './emergency.js';
 export * from './financial.js';

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './animal-card.js';
 export * from './assistant.js';
 export * from './communication.js';
+export * from './clinical-terminology.js';
 export * from './digital-twin.js';
 export * from './emergency.js';
 export * from './financial.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-data-utils-ts",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
@@ -20,6 +20,10 @@
       "types": "./dist/communication.d.ts",
       "default": "./dist/communication.js"
     },
+    "./clinical-terminology": {
+      "types": "./dist/clinical-terminology.d.ts",
+      "default": "./dist/clinical-terminology.js"
+    },
     "./digital-twin": {
       "types": "./dist/digital-twin.d.ts",
       "default": "./dist/digital-twin.js"