vet-sdk-core-ts 0.4.31 → 0.4.33

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,66 @@
+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/Product 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" | "Product-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}` | `Product/${string}`;
+        }>;
+    }>[];
+}>;
+/** Builds one claims-first directory `_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[];
+export type OrganizationCatalogRequest = Readonly<{
+    operation: 'batch' | 'search';
+    resourceType?: DirectoryResourceType;
+    envelope: ReturnType<typeof buildDirectoryBatch> | ReturnType<typeof buildDirectorySearch>;
+}>;
+export type OrganizationCatalogTransport = Readonly<{
+    execute(request: OrganizationCatalogRequest): Promise<unknown>;
+}>;
+/**
+ * Reusable organization catalog manager for care Services and insurance or
+ * technology Products. The injected transport owns authentication and the GW
+ * route; this manager owns only claims-first envelopes and canonical readback.
+ */
+export declare class OrganizationCatalogManager {
+    #private;
+    constructor(transport: OrganizationCatalogTransport);
+    /** Publishes one or more organization offerings through a GW batch. */
+    publish(resources: readonly unknown[], method?: DirectoryBatchMethod): Promise<unknown>;
+    /** Searches the authorized catalog using governed flat Schema.org claims. */
+    search(resourceType: DirectoryResourceType, claims?: Readonly<Record<string, unknown>>): Promise<readonly DirectoryFlatClaimsResource[]>;
+}

package/dist/place-service-directory.js

@@ -0,0 +1,89 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _OrganizationCatalogManager_transport;
+import { normalizeDirectoryFlatClaimsResource, searchClinicMarketplace, } from 'vet-data-utils-ts/place-service-directory';
+/** Builds the claims-first Schema.org Place/Service/Product 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 directory `_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 } : {}),
+    });
+}
+/**
+ * Reusable organization catalog manager for care Services and insurance or
+ * technology Products. The injected transport owns authentication and the GW
+ * route; this manager owns only claims-first envelopes and canonical readback.
+ */
+export class OrganizationCatalogManager {
+    constructor(transport) {
+        _OrganizationCatalogManager_transport.set(this, void 0);
+        if (!transport || typeof transport.execute !== 'function')
+            throw new TypeError('organization_catalog_transport_invalid');
+        __classPrivateFieldSet(this, _OrganizationCatalogManager_transport, transport, "f");
+    }
+    /** Publishes one or more organization offerings through a GW batch. */
+    async publish(resources, method = 'POST') {
+        const envelope = buildDirectoryBatch(resources, method);
+        if (!envelope.data.length)
+            throw new TypeError('organization_catalog_resources_required');
+        return __classPrivateFieldGet(this, _OrganizationCatalogManager_transport, "f").execute(Object.freeze({ operation: 'batch', envelope }));
+    }
+    /** Searches the authorized catalog using governed flat Schema.org claims. */
+    async search(resourceType, claims = {}) {
+        const envelope = buildDirectorySearch(resourceType, claims);
+        const response = await __classPrivateFieldGet(this, _OrganizationCatalogManager_transport, "f").execute(Object.freeze({ operation: 'search', resourceType, envelope }));
+        return readDirectorySearch(responseBody(response), resourceType);
+    }
+}
+_OrganizationCatalogManager_transport = new WeakMap();
+function responseBody(value) {
+    if (value && typeof value === 'object' && 'body' in value)
+        return value.body;
+    return value;
+}

package/package.json

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