vet-data-utils-ts 0.3.0 → 0.3.1

package/README.md

@@ -12,3 +12,9 @@ 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.
+
+Digital-twin search input contains one section, one or more resource types
+allowed by that section, display text, `dateFrom` and optional `dateTo`.
+`VeterinaryDigitalTwinSectionSearchProfiles` owns the corresponding
+`code-display` and date claims so browser code never supplies claim names.
+Identifying fields and caller-authored `claim`/`dateClaim` values are rejected.

package/dist/digital-twin.d.ts

@@ -3,11 +3,24 @@ export declare const VeterinaryDigitalTwinFormats: Readonly<{
     readonly R4: "org.hl7.fhir.r4";
 }>;
 export type VeterinaryDigitalTwinFormat = typeof VeterinaryDigitalTwinFormats[keyof typeof VeterinaryDigitalTwinFormats];
+export type VeterinaryDigitalTwinResourceSearchProfile = Readonly<{
+    resourceType: string;
+    codeDisplayClaim: `${string}.code-display`;
+    dateClaim: `${string}.${string}`;
+}>;
+/**
+ * Searchable flat-claim projections for each veterinary section.
+ *
+ * Native FHIR resources are converted by GW into these governed claims. The
+ * browser selects resource families only; it never supplies claim names.
+ */
+export declare const VeterinaryDigitalTwinSectionSearchProfiles: Readonly<Record<string, readonly VeterinaryDigitalTwinResourceSearchProfile[]>>;
 export type VeterinaryDigitalTwinSearch = Readonly<{
     section: string;
-    resourceType: string;
-    claim: string;
-    value: string;
+    resourceTypes: readonly string[];
+    text: string;
+    dateFrom: string;
+    dateTo?: string;
 }>;
-/** Bounds one section-first pseudonymous search and rejects direct identifiers. */
+/** Bounds one section-first pseudonymous search and rejects direct identifiers and caller-authored claims. */
 export declare function parseVeterinaryDigitalTwinSearch(input: unknown): VeterinaryDigitalTwinSearch;

package/dist/digital-twin.js

@@ -1,24 +1,61 @@
-import { isVeterinarySummarySection } from './veterinary-sections.js';
+import { VeterinarySummarySections, isVeterinarySummarySection } from './veterinary-sections.js';
 export const VeterinaryDigitalTwinFormats = Object.freeze({ Api: 'org.hl7.fhir.api', R4: 'org.hl7.fhir.r4' });
-/** Bounds one section-first pseudonymous search and rejects direct identifiers. */
+const profile = (resourceType, dateClaim) => Object.freeze({ resourceType, codeDisplayClaim: `${resourceType}.code-display`, dateClaim });
+/**
+ * Searchable flat-claim projections for each veterinary section.
+ *
+ * Native FHIR resources are converted by GW into these governed claims. The
+ * browser selects resource families only; it never supplies claim names.
+ */
+export const VeterinaryDigitalTwinSectionSearchProfiles = Object.freeze({
+    [VeterinarySummarySections.Problems.value]: Object.freeze([profile('Condition', 'Condition.onset-datetime')]),
+    [VeterinarySummarySections.Allergies.value]: Object.freeze([profile('AllergyIntolerance', 'AllergyIntolerance.onset-datetime')]),
+    [VeterinarySummarySections.Medications.value]: Object.freeze([profile('MedicationStatement', 'MedicationStatement.effective')]),
+    [VeterinarySummarySections.Immunizations.value]: Object.freeze([profile('Immunization', 'Immunization.date')]),
+    [VeterinarySummarySections.Results.value]: Object.freeze([
+        profile('Observation', 'Observation.date'),
+        profile('DiagnosticReport', 'DiagnosticReport.date'),
+    ]),
+    [VeterinarySummarySections.Procedures.value]: Object.freeze([profile('Procedure', 'Procedure.date')]),
+    [VeterinarySummarySections.VitalSigns.value]: Object.freeze([profile('Observation', 'Observation.date')]),
+    [VeterinarySummarySections.EnvironmentAndLifestyle.value]: Object.freeze([profile('Observation', 'Observation.date')]),
+    [VeterinarySummarySections.FunctionalStatus.value]: Object.freeze([profile('Condition', 'Condition.onset-datetime')]),
+    [VeterinarySummarySections.PastIllness.value]: Object.freeze([profile('Condition', 'Condition.onset-datetime')]),
+    [VeterinarySummarySections.ReproductiveHistory.value]: Object.freeze([profile('Observation', 'Observation.date')]),
+});
+/** Bounds one section-first pseudonymous search and rejects direct identifiers and caller-authored claims. */
 export function parseVeterinaryDigitalTwinSearch(input) {
     const value = (input || {});
     for (const forbidden of ['name', 'email', 'telephone', 'identifier', 'subjectDid', 'cardNumber']) {
         if (String(value[forbidden] || '').trim())
             throw new TypeError('veterinary_digital_twin_identifying_filter_forbidden');
     }
+    if (String(value.claim || '').trim() || String(value.dateClaim || '').trim()) {
+        throw new TypeError('veterinary_digital_twin_claim_forbidden');
+    }
     const section = String(value.section || '').trim();
-    const resourceType = String(value.resourceType || '').trim();
-    const claim = String(value.claim || '').trim();
-    const filterValue = String(value.value || '').trim();
     if (!isVeterinarySummarySection(section))
         throw new TypeError('veterinary_digital_twin_section_invalid');
-    if (!/^[A-Z][A-Za-z]{1,63}$/.test(resourceType))
+    const allowedProfiles = VeterinaryDigitalTwinSectionSearchProfiles[section] || [];
+    if (allowedProfiles.length === 0)
+        throw new TypeError('veterinary_digital_twin_section_not_searchable');
+    const rawResourceTypes = Array.isArray(value.resourceTypes) ? value.resourceTypes : [value.resourceType];
+    const resourceTypes = Array.from(new Set(rawResourceTypes.map(item => String(item || '').trim()).filter(Boolean)));
+    if (resourceTypes.length === 0 || resourceTypes.some(resourceType => !allowedProfiles.some(item => item.resourceType === resourceType))) {
         throw new TypeError('veterinary_digital_twin_resource_invalid');
-    if (!new RegExp(`^${resourceType.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\.[A-Za-z0-9][A-Za-z0-9.-]{0,127}$`).test(claim)) {
-        throw new TypeError('veterinary_digital_twin_claim_invalid');
     }
-    if (!filterValue || filterValue.length > 256)
-        throw new TypeError('veterinary_digital_twin_value_invalid');
-    return Object.freeze({ section, resourceType, claim, value: filterValue });
+    const text = String(value.text || value.value || '').trim();
+    if (!text || text.length > 256)
+        throw new TypeError('veterinary_digital_twin_text_invalid');
+    const dateFrom = parseIsoDate(value.dateFrom, 'date_from');
+    const dateTo = String(value.dateTo || '').trim() ? parseIsoDate(value.dateTo, 'date_to') : undefined;
+    if (dateTo && Date.parse(dateTo) < Date.parse(dateFrom))
+        throw new TypeError('veterinary_digital_twin_date_range_invalid');
+    return Object.freeze({ section, resourceTypes: Object.freeze(resourceTypes), text, dateFrom, ...(dateTo ? { dateTo } : {}) });
+}
+function parseIsoDate(value, field) {
+    const normalized = String(value || '').trim();
+    if (!normalized || Number.isNaN(Date.parse(normalized)))
+        throw new TypeError(`veterinary_digital_twin_${field}_invalid`);
+    return normalized;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-data-utils-ts",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",