vet-data-utils-ts 0.4.8 → 0.4.10

package/README.md

@@ -8,6 +8,20 @@ Current surfaces cover the canonical animal-card DID, veterinary summary
 sections, animal-only emergency data, pseudonymous DigitalTwin search input and
 veterinary assistant intents.
 
+Reusable Communication screens receive immutable workflow presets from
+`vet-data-utils-ts/communication`. The research-agreement screen is fixed to
+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).
+
 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,18 @@
+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";
+}>;
+/**
+ * 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';
+export declare function veterinaryTerminologySystemsFor(resourceType: VeterinaryCodedResourceType, countryCode: string): readonly string[];

package/dist/clinical-terminology.js

@@ -0,0 +1,34 @@
+export const VeterinaryClinicalTerminologySystems = Object.freeze({
+    Loinc: 'http://loinc.org',
+    SnomedCt: 'http://snomed.info/sct',
+    Icd10: 'http://hl7.org/fhir/sid/icd-10',
+});
+/**
+ * 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];
+    }
+    return permitsSnomed ? [VeterinaryClinicalTerminologySystems.SnomedCt] : [];
+}

package/dist/communication.d.ts

@@ -0,0 +1,37 @@
+export declare const VeterinaryCommunicationTopicSystems: Readonly<{
+    ActReason: "http://terminology.hl7.org/CodeSystem/v3-ActReason";
+}>;
+export type VeterinaryCommunicationTopic = Readonly<{
+    system: typeof VeterinaryCommunicationTopicSystems.ActReason;
+    code: string;
+    value: `${typeof VeterinaryCommunicationTopicSystems.ActReason}|${string}`;
+}>;
+/**
+ * Governed topics included by the VetChain research-agreement inbox.
+ * HRESCH is the HL7 v3 ActReason healthcare-research code:
+ * http://terminology.hl7.org/CodeSystem/v3-ActReason
+ *
+ * This topic filter is distinct from the four FHIR Communication categories:
+ * https://www.hl7.org/fhir/valueset-communication-category.html
+ */
+export declare const VeterinaryResearchCommunicationTopics: readonly VeterinaryCommunicationTopic[];
+export type VeterinaryCommunicationPresetFilter = Readonly<{
+    categories: readonly string[];
+    topics: readonly VeterinaryCommunicationTopic[];
+    allowTopicSelection: false;
+}>;
+/**
+ * Screen-owned presets for a reusable Communication component. Consumers pass
+ * this filter to the component; users cannot broaden the governed topic set.
+ */
+export declare const VeterinaryCommunicationPresetFilters: Readonly<{
+    ResearchAgreements: Readonly<{
+        categories: readonly string[];
+        topics: readonly Readonly<{
+            system: typeof VeterinaryCommunicationTopicSystems.ActReason;
+            code: string;
+            value: `${typeof VeterinaryCommunicationTopicSystems.ActReason}|${string}`;
+        }>[];
+        allowTopicSelection: false;
+    }>;
+}>;

package/dist/communication.js

@@ -0,0 +1,30 @@
+import { CommunicationCategoryCodes } from 'gdc-common-utils-ts/constants/communication';
+export const VeterinaryCommunicationTopicSystems = Object.freeze({
+    ActReason: 'http://terminology.hl7.org/CodeSystem/v3-ActReason',
+});
+/**
+ * Governed topics included by the VetChain research-agreement inbox.
+ * HRESCH is the HL7 v3 ActReason healthcare-research code:
+ * http://terminology.hl7.org/CodeSystem/v3-ActReason
+ *
+ * This topic filter is distinct from the four FHIR Communication categories:
+ * https://www.hl7.org/fhir/valueset-communication-category.html
+ */
+export const VeterinaryResearchCommunicationTopics = Object.freeze([
+    Object.freeze({
+        system: VeterinaryCommunicationTopicSystems.ActReason,
+        code: 'HRESCH',
+        value: `${VeterinaryCommunicationTopicSystems.ActReason}|HRESCH`,
+    }),
+]);
+/**
+ * Screen-owned presets for a reusable Communication component. Consumers pass
+ * this filter to the component; users cannot broaden the governed topic set.
+ */
+export const VeterinaryCommunicationPresetFilters = Object.freeze({
+    ResearchAgreements: Object.freeze({
+        categories: Object.freeze([CommunicationCategoryCodes.Notification.attributeValue]),
+        topics: VeterinaryResearchCommunicationTopics,
+        allowTopicSelection: false,
+    }),
+});

package/dist/index.d.ts

@@ -1,5 +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,5 +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.8",
+  "version": "0.4.10",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
@@ -16,6 +16,14 @@
       "types": "./dist/animal-card.d.ts",
       "default": "./dist/animal-card.js"
     },
+    "./communication": {
+      "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"
@@ -68,7 +76,7 @@
     "typescript": "^5.5.4"
   },
   "dependencies": {
-    "gdc-common-utils-ts": "2.5.21"
+    "gdc-common-utils-ts": "2.8.8"
   },
   "engines": {
     "node": ">=20"