vet-data-utils-ts 0.5.16 → 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/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.16",
+  "version": "0.5.17",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",