vet-sdk-core-ts 0.4.31 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-sdk-core-ts",
-  "version": "0.4.31",
+  "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.20"
+    "vet-data-utils-ts": "0.5.21"
   }
 }