vet-sdk-core-ts 0.4.29 → 0.4.32

package/README.md

@@ -1,5 +1,10 @@
 # VetChain Core SDK
 
+`vet-sdk-core-ts/place-service-directory` is the VetChain-only bundle boundary
+for claims-first Schema.org `Place` and `Service` resources. It builds GW VET
+batch/search envelopes and joins authorized directory search responses for the
+PetChain marketplace; it does not extend `gdc-*`.
+
 Development and releases follow the mandatory
 [`local-first TDD and release contract`](docs/LOCAL_FIRST_RELEASE_CONTRACT.md).
 

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from "./animal-onboarding.js";
 export * from "./reusable-bff.js";
 export * from "./research-study.js";
 export * from "./payment.js";
+export * from "./place-service-directory.js";
 export * from "./health-card-issuance.js";
 export * from "./secure-clinic-channel.js";
 export * from "./scheduling.js";

package/dist/index.js

@@ -6,6 +6,7 @@ export * from "./animal-onboarding.js";
 export * from "./reusable-bff.js";
 export * from "./research-study.js";
 export * from "./payment.js";
+export * from "./place-service-directory.js";
 export * from "./health-card-issuance.js";
 export * from "./secure-clinic-channel.js";
 export * from "./scheduling.js";

package/dist/place-service-directory.d.ts

@@ -0,0 +1,45 @@
+import { type ClinicMarketplaceResult, type DirectoryFlatClaimsResource, type DirectoryResourceType } from 'vet-data-utils-ts/place-service-directory';
+export type DirectoryBatchMethod = 'POST' | 'PUT';
+/** Builds the claims-first Schema.org Place/Service batch accepted by GW VET. */
+export declare function buildDirectoryBatch(resources: readonly unknown[], method?: DirectoryBatchMethod): Readonly<{
+    data: readonly Readonly<{
+        type: "Place-schema.org" | "Service-schema.org";
+        resource: Readonly<{
+            resourceType: DirectoryResourceType;
+            id: string;
+            meta: Readonly<{
+                claims: Readonly<Record<string, readonly string[]>>;
+            }>;
+        }>;
+        request: Readonly<{
+            method: DirectoryBatchMethod;
+            url: `Place/${string}` | `Service/${string}`;
+        }>;
+    }>[];
+}>;
+/** Builds one claims-first Place or Service `_search` envelope. Empty claims list the authorized directory. */
+export declare function buildDirectorySearch(resourceType: DirectoryResourceType, claims?: Readonly<Record<string, unknown>>): Readonly<{
+    data: readonly Readonly<{
+        resource: Readonly<{
+            resourceType: DirectoryResourceType;
+            id: string;
+            meta: Readonly<{
+                claims: Readonly<Record<string, readonly string[]>>;
+            }>;
+        }>;
+    }>[];
+}>;
+/** Reads canonical GW directory matches from `body.data[].resource`. */
+export declare function readDirectorySearch(body: unknown, expectedResourceType: DirectoryResourceType): readonly DirectoryFlatClaimsResource[];
+/** Reads two GW searches and returns the joined, filtered public clinic marketplace. */
+export declare function readClinicMarketplaceSearch(input: Readonly<{
+    placesBody: unknown;
+    servicesBody: unknown;
+    postalCode?: string;
+    serviceTypes?: readonly string[];
+    near?: Readonly<{
+        latitude: number;
+        longitude: number;
+        radiusKm: number;
+    }>;
+}>): readonly ClinicMarketplaceResult[];

package/dist/place-service-directory.js

@@ -0,0 +1,45 @@
+import { normalizeDirectoryFlatClaimsResource, searchClinicMarketplace, } from 'vet-data-utils-ts/place-service-directory';
+/** Builds the claims-first Schema.org Place/Service batch accepted by GW VET. */
+export function buildDirectoryBatch(resources, method = 'POST') {
+    return Object.freeze({ data: Object.freeze(resources.map(candidate => {
+            const resource = normalizeDirectoryFlatClaimsResource(candidate);
+            return Object.freeze({
+                type: `${resource.resourceType}-schema.org`,
+                resource,
+                request: Object.freeze({ method, url: `${resource.resourceType}/${resource.id}` }),
+            });
+        })) });
+}
+/** Builds one claims-first Place or Service `_search` envelope. Empty claims list the authorized directory. */
+export function buildDirectorySearch(resourceType, claims = {}) {
+    const resource = normalizeDirectoryFlatClaimsResource({ resourceType, id: 'search', meta: { claims } });
+    return Object.freeze({ data: Object.freeze([Object.freeze({ resource })]) });
+}
+/** Reads canonical GW directory matches from `body.data[].resource`. */
+export function readDirectorySearch(body, expectedResourceType) {
+    if (!body || typeof body !== 'object' || !Array.isArray(body.data))
+        throw new TypeError('directory_search_invalid');
+    return Object.freeze(body.data.map(entry => {
+        if (!entry || typeof entry !== 'object' || !('resource' in entry))
+            throw new TypeError('directory_search_resource_invalid');
+        try {
+            const resource = normalizeDirectoryFlatClaimsResource(entry.resource);
+            if (resource.resourceType !== expectedResourceType)
+                throw new Error('wrong type');
+            return resource;
+        }
+        catch {
+            throw new TypeError('directory_search_resource_invalid');
+        }
+    }));
+}
+/** Reads two GW searches and returns the joined, filtered public clinic marketplace. */
+export function readClinicMarketplaceSearch(input) {
+    return searchClinicMarketplace({
+        places: readDirectorySearch(input.placesBody, 'Place'),
+        services: readDirectorySearch(input.servicesBody, 'Service'),
+        ...(input.postalCode ? { postalCode: input.postalCode } : {}),
+        ...(input.serviceTypes ? { serviceTypes: input.serviceTypes } : {}),
+        ...(input.near ? { near: input.near } : {}),
+    });
+}

package/dist/secure-clinic-channel.js

@@ -81,33 +81,6 @@ function extractIndexProjection(bundle, policy) {
         const resource = entry.resource;
         if (!resource || typeof resource.resourceType !== 'string' || typeof resource.id !== 'string')
             continue;
-        if (typeof entry.fullUrl !== 'string')
-            throw new Error('Each indexed resource requires an absolute HTTPS fullUrl');
-        const relative = /^([A-Z][A-Za-z0-9]+)\/([0-9a-f-]+)$/i.exec(entry.fullUrl);
-        let urlResourceType;
-        let urlId;
-        if (relative) {
-            ;
-            [, urlResourceType, urlId] = relative;
-        }
-        else {
-            let parsed;
-            try {
-                parsed = new URL(entry.fullUrl);
-            }
-            catch {
-                throw new Error('The index fullUrl must contain /<ResourceType>/<UUID>');
-            }
-            if (parsed.protocol !== 'https:')
-                throw new Error('The index fullUrl must contain /<ResourceType>/<UUID>');
-            const segments = parsed.pathname.split('/').filter(Boolean);
-            urlResourceType = segments.at(-2);
-            urlId = segments.at(-1);
-        }
-        if (urlResourceType !== resource.resourceType
-            || urlId !== resource.id || !UUID_PATTERN.test(resource.id)) {
-            throw new Error('The fullUrl must end in /<ResourceType>/<UUID> matching the resource');
-        }
         if (resource.resourceType === 'Binary' && resource.contentType === 'application/pdf') {
             throw new Error('PDF content must be an Attachment inside DocumentReference');
         }
@@ -128,8 +101,44 @@ function extractIndexProjection(bundle, policy) {
             (grouped[_a = tag.system] ?? (grouped[_a] = [])).push(tag.code);
         }
         const claims = Object.fromEntries(Object.entries(grouped).map(([key, values]) => [key, values.join(',')]));
-        if (Object.keys(claims).length)
-            entries.push({ fullUrl: entry.fullUrl, claims });
+        if (!Object.keys(claims).length)
+            continue;
+        // A private FHIR document can legitimately contain contained-only or
+        // human-readable entry identities. They remain in the encrypted payload,
+        // but only independently retrievable UUID resources enter the index.
+        if (typeof entry.fullUrl !== 'string' || !UUID_PATTERN.test(resource.id))
+            continue;
+        const relative = /^([A-Z][A-Za-z0-9]+)\/([0-9a-f-]+)$/i.exec(entry.fullUrl);
+        const documentUrn = /^urn:uuid:([0-9a-f-]+)$/i.exec(entry.fullUrl);
+        let urlResourceType;
+        let urlId;
+        let indexFullUrl = entry.fullUrl;
+        if (relative) {
+            ;
+            [, urlResourceType, urlId] = relative;
+        }
+        else if (documentUrn) {
+            urlResourceType = resource.resourceType;
+            [, urlId] = documentUrn;
+            indexFullUrl = `${resource.resourceType}/${resource.id}`;
+        }
+        else {
+            let parsed;
+            try {
+                parsed = new URL(entry.fullUrl);
+            }
+            catch {
+                continue;
+            }
+            if (parsed.protocol !== 'https:')
+                continue;
+            const segments = parsed.pathname.split('/').filter(Boolean);
+            urlResourceType = segments.at(-2);
+            urlId = segments.at(-1);
+        }
+        if (urlResourceType !== resource.resourceType || urlId !== resource.id)
+            continue;
+        entries.push({ fullUrl: indexFullUrl, claims });
     }
     return { entries };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-sdk-core-ts",
-  "version": "0.4.29",
+  "version": "0.4.32",
   "description": "Browser-safe VetChain core contracts and governed animal species identifiers",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
@@ -44,6 +44,10 @@
       "types": "./dist/payment.d.ts",
       "default": "./dist/payment.js"
     },
+    "./place-service-directory": {
+      "types": "./dist/place-service-directory.d.ts",
+      "default": "./dist/place-service-directory.js"
+    },
     "./health-card-issuance": {
       "types": "./dist/health-card-issuance.d.ts",
       "default": "./dist/health-card-issuance.js"
@@ -81,6 +85,6 @@
     "@noble/hashes": "^2.2.0",
     "@noble/post-quantum": "0.5.4",
     "gdc-common-utils-ts": "2.9.10",
-    "vet-data-utils-ts": "0.5.18"
+    "vet-data-utils-ts": "0.5.21"
   }
 }