vet-data-utils-ts 0.5.15 → 0.5.17

package/README.md

@@ -30,6 +30,12 @@ shows FHIR `Immunization.occurrenceDateTime`, `vaccineCode` and
 `protocolApplied.targetDisease`. Its issuer-supplied validity interval is not
 FHIR `Immunization.expirationDate`, which means vaccine-batch expiry.
 
+`buildSmartHealthCardJwsProofReference(...)` serves a different purpose: it
+hashes the exact compact SHC JWS, including its ES256 signature, with a domain
+separator. A product ledger/resolver may use that key to retrieve the existing
+detached `pqc:/` proofs when only the SHC QR is printed and internet access is
+available. Offline PQC verification still requires the companion QR labels.
+
 Development and releases follow the mandatory
 [`local-first TDD and release contract`](docs/LOCAL_FIRST_RELEASE_CONTRACT.md).
 

package/dist/scheduling.js

@@ -29,7 +29,7 @@ const nativeFieldsByResource = Object.freeze({
     Location: new Set(['identifier', 'status', 'mode', 'name', 'description', 'type', 'telecom', 'address', 'physicalType', 'position', 'managingOrganization', 'characteristic', 'contained']),
     Schedule: new Set(['identifier', 'active', 'serviceCategory', 'serviceType', 'specialty', 'name', 'actor', 'planningHorizon', 'comment']),
     Slot: new Set(['identifier', 'serviceCategory', 'serviceType', 'specialty', 'appointmentType', 'schedule', 'status', 'start', 'end', 'overbooked', 'comment']),
-    Appointment: new Set(['identifier', 'status', 'serviceCategory', 'serviceType', 'specialty', 'appointmentType', 'reason', 'description', 'start', 'end', 'slot', 'participant', 'subject', 'note', 'supportingInformation']),
+    Appointment: new Set(['identifier', 'status', 'serviceCategory', 'serviceType', 'specialty', 'appointmentType', 'reason', 'description', 'start', 'end', 'slot', 'participant', 'subject', 'note', 'supportingInformation', 'contained']),
     AppointmentResponse: new Set(['identifier', 'appointment', 'proposedNewTime', 'start', 'end', 'participantType', 'actor', 'participantStatus', 'comment', 'recurring', 'occurrenceDate', 'recurrenceId', 'contained']),
 });
 /** Validates native FHIR scheduling data and normalizes indexed SearchParameter claims to strings. */
@@ -295,6 +295,11 @@ export function buildAppointmentResource(input) {
     const startInstant = new Date(start).toISOString();
     const endInstant = new Date(end).toISOString();
     const organization = hasOrganization ? organizationReference.trim() : undefined;
+    const emailEndpoint = hasNotificationEmail ? {
+        resourceType: 'Endpoint', id: 'clinic-notification-email', status: 'active',
+        connectionType: [{ coding: [{ code: 'email' }] }],
+        address: `mailto:${notificationEmail.trim().toLowerCase()}`,
+    } : undefined;
     return claimsResource('Appointment', input.id, {
         'Appointment.identifier': input.id, 'Appointment.status': input.status, 'Appointment.date': startInstant,
         ...(input.slotReferences.length ? { 'Appointment.slot': Object.freeze([...input.slotReferences]) } : {}),
@@ -306,7 +311,8 @@ export function buildAppointmentResource(input) {
         identifier: [{ value: input.id }], status: input.status, start: startInstant, end: endInstant,
         ...(input.slotReferences.length ? { slot: input.slotReferences.map(reference => ({ reference })) } : {}),
         participant: input.actorReferences.map(reference => ({ actor: { reference }, status: 'needs-action' })),
-        ...(organization ? { supportingInformation: [{ reference: organization }] } : {}),
+        ...(organization ? { supportingInformation: [{ reference: organization }, { reference: '#clinic-notification-email' }] } : {}),
+        ...(emailEndpoint ? { contained: [emailEndpoint] } : {}),
     });
 }
 /** Builds the durable web inbox notification when a schedule change displaces an appointment. */

package/dist/shc.d.ts

@@ -55,6 +55,13 @@ export declare function assembleSmartHealthCardJws(prepared: Pick<PreparedSmartH
  * content identifier. They are deliberately not aliases.
  */
 export declare function buildSmartHealthCardPayloadReferences(payloadBytes: Uint8Array): SmartHealthCardPayloadReferences;
+/**
+ * Builds the optional online lookup key for a PQC companion proof from the
+ * exact compact SHC JWS printed by `shc:/`. This is intentionally distinct
+ * from the canonical payload references above: it includes the ES256
+ * signature and uses a domain separator so the two namespaces cannot collide.
+ */
+export declare function buildSmartHealthCardJwsProofReference(compactJws: string): string;
 /** Encodes one compact SHC JWS into one or more standard numeric QR payloads. */
 export declare function encodeSmartHealthCardQr(compactJws: string): readonly string[];
 /** Reassembles standard SHC QR payloads regardless of scan order. */

package/dist/shc.js

@@ -156,6 +156,19 @@ export function buildSmartHealthCardPayloadReferences(payloadBytes) {
         cidV1: buildRawCidV1FromUtf8String(payloadText),
     };
 }
+/**
+ * Builds the optional online lookup key for a PQC companion proof from the
+ * exact compact SHC JWS printed by `shc:/`. This is intentionally distinct
+ * from the canonical payload references above: it includes the ES256
+ * signature and uses a domain separator so the two namespaces cannot collide.
+ */
+export function buildSmartHealthCardJwsProofReference(compactJws) {
+    const jws = nonEmptyString(compactJws, 'shc_compact_jws_required');
+    if (jws.split('.').length !== 3)
+        throw new TypeError('shc_compact_jws_required');
+    const lookupBytes = Content.stringToBytesUTF8(`vetchain:shc-jws-pqc-proof:v1\0${jws}`);
+    return `urn:multibase:${encodeMultibaseSha3(lookupBytes, 384)}`;
+}
 /** Encodes one compact SHC JWS into one or more standard numeric QR payloads. */
 export function encodeSmartHealthCardQr(compactJws) {
     const jws = nonEmptyString(compactJws, 'shc_compact_jws_required');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-data-utils-ts",
-  "version": "0.5.15",
+  "version": "0.5.17",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",