gdc-common-utils-ts 2.9.9 → 2.9.10

package/README.md

@@ -554,8 +554,12 @@ The canonical API contract should live in JSDoc on exported code. The README act
     the document author; a registered PractitionerRole or RelatedPerson is the
     attester, including for content entered by that authenticated person.
 - [`normalizeClinicalCreatorBinding(...)`](src/utils/fhir-ips-creator-identity.ts)
-  - Accept stable UUIDs and governed bare role codes at the BFF boundary, then
-    add canonical UUID URNs and HL7/ISCO coding systems before transport.
+  - Accept stable person, assignment and owner UUIDs plus governed bare role
+    codes at the BFF boundary, then add canonical UUID URNs and HL7/ISCO coding
+    systems before transport. Use `assignmentIdentifier` for the registered
+    `RelatedPerson`/`PractitionerRole`; the deprecated wire property
+    `authorIdentifier` names that assignment and does not decide
+    `Composition.author`.
 - [`src/examples/frontend-session.ts`](src/examples/frontend-session.ts)
   - Frontend profile/session bootstrap examples.
 - [`src/examples/lifecycle.ts`](src/examples/lifecycle.ts)

package/dist/utils/fhir-ips-creator-identity.d.ts

@@ -12,7 +12,11 @@ export type FhirIpsCreatorBundleEntry = Readonly<{
 type FhirIpsCreatorBase = Readonly<{
     /** Stable imported or locally generated actor identifier. */
     actorIdentifier: string;
-    /** Stable identifier referenced by Composition.author for this role/relationship. */
+    /**
+     * Historical API name for the stable role/relationship assignment identifier.
+     * Provenance uses this assignment as `Composition.attester.party`; it is not
+     * automatically the `Composition.author`.
+     */
     authorIdentifier: string;
 }>;
 export type FhirIpsCreatorAuthorInput = (FhirIpsCreatorBase & Readonly<{
@@ -93,8 +97,11 @@ type ClinicalCreatorChannelAliases = Readonly<{
 }>;
 /**
  * Durable clinical-creator identity stored behind the authenticated profile.
- * `actorIdentifier` identifies the person/member. `authorIdentifier` identifies
- * the concrete role or relationship assignment used as the FHIR author.
+ * `actorIdentifier` identifies the person/member. The historical wire property
+ * `authorIdentifier` identifies the concrete PractitionerRole/RelatedPerson
+ * assignment used as `Composition.attester.party`; it does not decide
+ * `Composition.author`. `ownerIdentifier` identifies the legal organization or
+ * individual organization/subject that owns that assignment.
  * Contacts, DCR clients, keys and operational DIDs are aliases only.
  */
 export type ClinicalCreatorBinding = ClinicalCreatorChannelAliases & Readonly<{
@@ -117,7 +124,10 @@ export type ClinicalCreatorBinding = ClinicalCreatorChannelAliases & Readonly<{
 export type ClinicalCreatorBindingInput = ClinicalCreatorChannelAliases & Readonly<{
     kind: FhirIpsCreatorKind;
     actorIdentifier: string;
-    authorIdentifier: string;
+    /** Preferred high-level name for the PractitionerRole/RelatedPerson UUID. */
+    assignmentIdentifier?: string;
+    /** @deprecated Historical DCR/profile wire name; use `assignmentIdentifier`. */
+    authorIdentifier?: string;
     ownerIdentifier: string;
     role: string;
 }>;

package/dist/utils/fhir-ips-creator-identity.js

@@ -129,13 +129,26 @@ export function buildFhirIpsCreatorAuthor(input) {
  */
 export function normalizeClinicalCreatorBinding(input) {
     const actorIdentifier = canonicalUuidUrn(input.actorIdentifier, 'actorIdentifier');
-    const authorIdentifier = canonicalUuidUrn(input.authorIdentifier, 'authorIdentifier');
+    const preferredAssignment = input.assignmentIdentifier
+        ? canonicalUuidUrn(input.assignmentIdentifier, 'assignmentIdentifier')
+        : undefined;
+    const legacyAssignment = input.authorIdentifier
+        ? canonicalUuidUrn(input.authorIdentifier, 'authorIdentifier')
+        : undefined;
+    if (preferredAssignment && legacyAssignment && preferredAssignment !== legacyAssignment) {
+        throw new TypeError('assignmentIdentifier and deprecated authorIdentifier must identify the same assignment.');
+    }
+    const authorIdentifier = preferredAssignment || legacyAssignment;
+    if (!authorIdentifier) {
+        throw new TypeError('assignmentIdentifier is required.');
+    }
     const ownerIdentifier = input.kind === FhirIpsCreatorKinds.Professional
         ? requireReference(input.ownerIdentifier, 'ownerIdentifier')
         : canonicalUuidUrn(input.ownerIdentifier, 'ownerIdentifier');
     const role = canonicalRoleClaim(input.role);
+    const { assignmentIdentifier: _assignmentIdentifier, ...wireInput } = input;
     return {
-        ...input,
+        ...wireInput,
         actorIdentifier,
         authorIdentifier,
         ownerIdentifier,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "2.9.9",
+  "version": "2.9.10",
   "publishConfig": {
     "access": "public"
   },