vet-sdk-core-ts 0.4.4 → 0.4.6

package/README.md

@@ -64,14 +64,17 @@ 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
+free text and dates. It returns both the basic FHIR
 `Parameters` body and the `filters` map for `DigitalTwinSdk.search`; callers do
-not author `Composition.section` or resource claim names.
+not author `Composition.section`, resource families or flat claim names. The returned public
+resource is `ResearchSubject`, so the Node SDK sends
+`POST digitaltwin/.../ResearchSubject/_search`; the `Composition.*` fields
+inside GW index the canonical Composition embedded in that ResearchSubject.
 
 ```ts
 const request = buildVeterinaryDigitalTwinSearchRequest({
   thid: crypto.randomUUID(),
-  search: { section, resourceTypes, text, dateFrom, ...(dateTo ? { dateTo } : {}) },
+  search: { section, text, dateFrom, ...(dateTo ? { dateTo } : {}) },
 })
 
 await digitalTwins.search(routeContext, {

package/dist/gateway-contract.d.ts

@@ -48,7 +48,7 @@ export type VeterinaryBreakGlassSmartAuthorization = Readonly<{
 }>;
 export type VeterinaryDigitalTwinSearchRequest = Readonly<{
     format: VeterinaryDigitalTwinFormat;
-    resourceType: 'Composition';
+    resourceType: 'ResearchSubject';
     filters: Readonly<Record<string, string | readonly string[]>>;
     payload: Readonly<{
         thid: string;
@@ -86,9 +86,11 @@ export declare function buildVeterinaryBreakGlassSmartRequest(input: Readonly<{
     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.
+ * Converts browser-safe section, text and date values into the basic FHIR
+ * Parameters accepted by the Node DigitalTwin SDK. The public resource is a
+ * ResearchSubject; GW applies these business filters to its embedded canonical
+ * Composition and derived clinical index. Callers never choose claim names or
+ * clinical resource families; coded search can be added as a separate profile.
  */
 export declare function buildVeterinaryDigitalTwinSearchRequest(input: Readonly<{
     thid: string;

package/dist/gateway-contract.js

@@ -60,46 +60,44 @@ 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.
+ * Converts browser-safe section, text and date values into the basic FHIR
+ * Parameters accepted by the Node DigitalTwin SDK. The public resource is a
+ * ResearchSubject; GW applies these business filters to its embedded canonical
+ * Composition and derived clinical index. Callers never choose claim names or
+ * clinical resource families; coded search can be added as a separate profile.
  */
 export function buildVeterinaryDigitalTwinSearchRequest(input) {
-    const search = parseVeterinaryDigitalTwinSearch(input.search);
+    const rawSearch = (input.search || {});
+    const requestedSection = String(rawSearch.section || '').trim();
+    const defaultProfile = (VeterinaryDigitalTwinSectionSearchProfiles[requestedSection] || [])[0];
+    const search = parseVeterinaryDigitalTwinSearch({
+        ...rawSearch,
+        resourceTypes: defaultProfile ? [defaultProfile.resourceType] : [],
+    });
     const format = input.format || VeterinaryDigitalTwinFormats.R4;
     const parameter = [
-        { name: 'Composition.section', valueString: search.section },
+        { name: 'section', valueString: search.section },
+        { name: 'text', valueString: search.text },
+        { name: 'date-from', valueDate: search.dateFrom },
     ];
-    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];
-    }
+    if (search.dateTo)
+        parameter.push({ name: 'date-to', valueDate: search.dateTo });
+    const filters = {
+        section: search.section,
+        text: search.text,
+        'date-from': search.dateFrom,
+        ...(search.dateTo ? { 'date-to': search.dateTo } : {}),
+    };
     return Object.freeze({
         format,
         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',
+        // ResearchSubject is the public twin. GW searches the embedded canonical
+        // Composition and derived clinical index; the route type never changes.
+        resourceType: 'ResearchSubject',
         payload: {
             thid: bounded(input.thid, 'thid'),
             body: format === VeterinaryDigitalTwinFormats.Api
-                ? { data: [{ type: 'Composition-search-request-v1.0', resource: { resourceType: 'Parameters', parameter } }] }
+                ? { data: [{ type: 'ResearchSubject-search-request-v1.0', resource: { resourceType: 'Parameters', parameter } }] }
                 : { resourceType: 'Parameters', parameter },
         },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-sdk-core-ts",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Browser-safe VetChain core contracts and governed animal species identifiers",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",