vet-sdk-core-ts 0.4.2 → 0.4.3

package/README.md

@@ -35,3 +35,24 @@ import {
 VetChainDomesticAnimalSpecies.DomesticFerret.ncbiTaxonomyId; // "9669"
 findVetChainSpeciesByTaxonomyId("9685")?.key; // "Cat"
 ```
+
+## Digital-twin search
+
+`buildVeterinaryDigitalTwinSearchRequest` accepts only one governed section,
+selected resource families, display text and dates. It returns both the FHIR
+`Parameters` body and the `filters` map for `DigitalTwinSdk.search`; callers do
+not author `Composition.section` or resource claim names.
+
+```ts
+const request = buildVeterinaryDigitalTwinSearchRequest({
+  thid: crypto.randomUUID(),
+  search: { section, resourceTypes, text, dateFrom, ...(dateTo ? { dateTo } : {}) },
+})
+
+await digitalTwins.search(routeContext, {
+  thid: request.payload.thid,
+  format: request.format,
+  resourceType: request.resourceType,
+  filters: request.filters,
+})
+```

package/dist/gateway-contract.d.ts

@@ -29,6 +29,7 @@ export type VeterinaryBreakGlassSmartRequest = Readonly<{
 export type VeterinaryDigitalTwinSearchRequest = Readonly<{
     format: VeterinaryDigitalTwinFormat;
     resourceType: 'Composition';
+    filters: Readonly<Record<string, string | readonly string[]>>;
     payload: Readonly<{
         thid: string;
         body: Readonly<Record<string, unknown>>;
@@ -47,6 +48,11 @@ export declare function buildVeterinaryBreakGlassSmartRequest(input: Readonly<{
     vpToken: string;
     audience: string;
 }>): VeterinaryBreakGlassSmartRequest;
+/**
+ * Converts browser-safe search values into both FHIR Parameters and the exact
+ * filter map accepted by the Node DigitalTwin SDK. Callers never choose flat
+ * claim names.
+ */
 export declare function buildVeterinaryDigitalTwinSearchRequest(input: Readonly<{
     thid: string;
     format?: VeterinaryDigitalTwinFormat;

package/dist/gateway-contract.js

@@ -1,4 +1,4 @@
-import { VeterinaryBreakGlassMaxLifetimeSeconds, VeterinaryDigitalTwinFormats, parseVetChainAnimalCardDid, parseVeterinaryBreakGlassRequestData, parseVeterinaryDigitalTwinSearch, } from 'vet-data-utils-ts';
+import { VeterinaryBreakGlassMaxLifetimeSeconds, VeterinaryDigitalTwinFormats, VeterinaryDigitalTwinSectionSearchProfiles, parseVetChainAnimalCardDid, parseVeterinaryBreakGlassRequestData, parseVeterinaryDigitalTwinSearch, } from 'vet-data-utils-ts';
 export function buildVetGatewayRoutePrefix(context) {
     const tenantId = bounded(context.tenantId, 'tenantId');
     const jurisdiction = bounded(context.jurisdiction, 'jurisdiction').toUpperCase();
@@ -34,18 +34,42 @@ export function buildVeterinaryBreakGlassSmartRequest(input) {
         },
     });
 }
+/**
+ * Converts browser-safe search values into both FHIR Parameters and the exact
+ * filter map accepted by the Node DigitalTwin SDK. Callers never choose flat
+ * claim names.
+ */
 export function buildVeterinaryDigitalTwinSearchRequest(input) {
     const search = parseVeterinaryDigitalTwinSearch(input.search);
     const format = input.format || VeterinaryDigitalTwinFormats.R4;
     const parameter = [
-        { name: 'section', valueString: search.section },
-        { name: search.claim, valueString: search.value },
+        { name: 'Composition.section', valueString: search.section },
     ];
+    const profiles = VeterinaryDigitalTwinSectionSearchProfiles[search.section] || [];
+    for (const resourceType of search.resourceTypes) {
+        const selectedProfile = profiles.find(profile => profile.resourceType === resourceType);
+        if (!selectedProfile)
+            throw new TypeError('veterinary_digital_twin_resource_invalid');
+        parameter.push({ name: selectedProfile.codeDisplayClaim, valueString: search.text }, { name: selectedProfile.dateClaim, valueString: `ge${search.dateFrom}` });
+        if (search.dateTo)
+            parameter.push({ name: selectedProfile.dateClaim, valueString: `le${search.dateTo}` });
+    }
+    const filters = {};
+    for (const item of parameter) {
+        const existing = filters[item.name];
+        if (!existing)
+            filters[item.name] = item.valueString;
+        else if (Array.isArray(existing))
+            existing.push(item.valueString);
+        else
+            filters[item.name] = [existing, item.valueString];
+    }
     return Object.freeze({
         format,
-        // GW stores the pseudonymous twin as a Composition. `search.resourceType`
-        // names the nested clinical resource whose claim is being filtered; it is
-        // never the asynchronous route resource type.
+        filters: Object.freeze(filters),
+        // GW stores the pseudonymous twin as a Composition. The selected nested
+        // resource families become repeated Parameters entries; they never change
+        // the asynchronous route resource type.
         resourceType: 'Composition',
         payload: {
             thid: bounded(input.thid, 'thid'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-sdk-core-ts",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Browser-safe VetChain core contracts and governed animal species identifiers",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
@@ -54,6 +54,6 @@
   },
   "dependencies": {
     "@noble/hashes": "^2.2.0",
-    "vet-data-utils-ts": "0.3.0"
+    "vet-data-utils-ts": "0.3.1"
   }
 }