vet-data-utils-ts 0.5.27 → 0.5.28

package/README.md

@@ -126,6 +126,11 @@ resource-specific standard SearchParameters and preserves agent correlation as
 exact code from the FHIR ParticipationRoleType ValueSet and the value is the
 agent's FHIR Reference or URI. The standard `Provenance.agent` and
 `Provenance.agent-type` claims are indexed alongside that correlation claim.
+For a professional, use
+`buildPractitionerRoleReferenceFromAssignmentIdentifier()` with the real
+Occupation/PractitionerRole assignment UUID returned by GW. The role-bearing
+employee URN and role-license hash remain operational authorization identities;
+they are not substituted for the clinical `PractitionerRole` reference.
 
 ResearchStudy professional teams use native FHIR R5 Group resources from
 `vet-data-utils-ts/group`: required type and membership codes, the exact twelve

package/dist/provenance.d.ts

@@ -1,4 +1,3 @@
-/** Browser-safe FHIR R5 Provenance flat-claim vocabulary and builders. */
 export declare const FhirR5ParticipationRoleTypeValueSet: "http://hl7.org/fhir/ValueSet/participation-role-type";
 export declare const FhirR5ProvenanceParticipantTypeSystem: "http://terminology.hl7.org/CodeSystem/provenance-participant-type";
 export declare const FhirR5ExtraSecurityRoleTypeSystem: "http://terminology.hl7.org/CodeSystem/extra-security-role-type";
@@ -23,6 +22,8 @@ export type ProvenanceR5FlatClaimsResource = Readonly<{
         claims: Readonly<Record<string, readonly string[]>>;
     }>;
 }>;
+/** Builds the FHIR PractitionerRole reference from the server-issued assignment UUID. */
+export declare function buildPractitionerRoleReferenceFromAssignmentIdentifier(assignmentIdentifier: string): string;
 /** Returns the correlated agent reference claim for one official participation type. */
 export declare function provenanceAgentClaim(code: FhirR5ParticipationRoleTypeCode | string): string;
 /** Returns the system-qualified FHIR token for one official participation type. */

package/dist/provenance.js

@@ -1,4 +1,5 @@
 /** Browser-safe FHIR R5 Provenance flat-claim vocabulary and builders. */
+import { normalizeUuid } from 'gdc-common-utils-ts/utils/normalize-uuid';
 export const FhirR5ParticipationRoleTypeValueSet = 'http://hl7.org/fhir/ValueSet/participation-role-type';
 export const FhirR5ProvenanceParticipantTypeSystem = 'http://terminology.hl7.org/CodeSystem/provenance-participant-type';
 export const FhirR5ExtraSecurityRoleTypeSystem = 'http://terminology.hl7.org/CodeSystem/extra-security-role-type';
@@ -30,6 +31,14 @@ const standardClaims = ProvenanceR5SearchParameterCatalog.map(parameter => `Prov
 const correlatedAgentClaims = FhirR5ParticipationRoleTypeCodes.map(code => `Provenance.agent-${code}-who`);
 /** Standard search claims plus typed-agent correlation claims. */
 export const ProvenanceFlatClaimCatalog = Object.freeze([...standardClaims, ...correlatedAgentClaims]);
+/** Builds the FHIR PractitionerRole reference from the server-issued assignment UUID. */
+export function buildPractitionerRoleReferenceFromAssignmentIdentifier(assignmentIdentifier) {
+    const compact = normalizeUuid(assignmentIdentifier);
+    if (!compact)
+        throw new TypeError('professional_assignment_identifier_invalid');
+    const uuid = `${compact.slice(0, 8)}-${compact.slice(8, 12)}-${compact.slice(12, 16)}-${compact.slice(16, 20)}-${compact.slice(20)}`;
+    return `PractitionerRole/${uuid}`;
+}
 /** Returns the correlated agent reference claim for one official participation type. */
 export function provenanceAgentClaim(code) {
     if (!FhirR5ParticipationRoleTypeCodes.includes(code))

package/package.json

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