gdc-common-utils-ts 2.9.0 → 2.9.1

package/README.md

@@ -530,9 +530,9 @@ The canonical API contract should live in JSDoc on exported code. The README act
 - [`buildFhirIpsCreatorProvenance(...)`](src/utils/fhir-ips-creator-identity.ts)
   and [`docs/101-DIDCOMM-IDENTITY-BOUNDARY.md`](docs/101-DIDCOMM-IDENTITY-BOUNDARY.md)
   - Keep `Composition.author`, `Composition.attester`, DIDComm sender and
-    signing key separate. A member-created fact may use the registered
-    RelatedPerson as both author and personal attester; a dictated
-    individual-created fact keeps the individual as author.
+    signing key separate. The organization, EHR/portal or individual remains
+    the document author; a registered PractitionerRole or RelatedPerson is the
+    attester, including for content entered by that authenticated person.
 - [`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/constants/healthcare.d.ts

@@ -1732,6 +1732,8 @@ export declare const HealthcareActorRoles: Readonly<{
     /** ISCO-08 laboratory occupation for human medical/pathology work. */
     readonly MedicalAndPathologyLaboratoryTechnician: "ISCO-08|3212";
     readonly VeterinaryTechnicianOrAssistant: "ISCO-08|3240";
+    /** General receptionist occupation usable across human, animal and one-health organizations. */
+    readonly Receptionist: "ISCO-08|4226";
     /** Administrative health occupation; it does not imply clinical authority. */
     readonly MedicalSecretary: "ISCO-08|3344";
 }>;
@@ -1757,6 +1759,7 @@ export declare const HealthcareActorRoleCodes: Readonly<{
     readonly LifeScienceTechnician: "3141";
     readonly MedicalAndPathologyLaboratoryTechnician: "3212";
     readonly VeterinaryTechnicianOrAssistant: "3240";
+    readonly Receptionist: "4226";
     readonly MedicalSecretary: "3344";
 }>;
 export declare const HealthcareRolesByFamily: Readonly<{
@@ -1790,19 +1793,19 @@ export declare const HealthcareRolesByFamily: Readonly<{
 }>;
 export declare const HealthcareAllRolesByClaim: Readonly<Record<string, HealthcareActorRoleDescriptor>>;
 export declare const HealthcareProfessionalRoleCodesBySector: Readonly<{
-    readonly "health-care": readonly ("RESPRSN" | "221" | "2211" | "2212" | "2221" | "2222" | "2240" | "3344")[];
-    readonly "health-research": readonly ("RESPRSN" | "221" | "2211" | "2212" | "3344")[];
-    readonly "health-lab": readonly ("RESPRSN" | "221" | "2212" | "3212" | "3344")[];
-    readonly "health-tech": readonly "RESPRSN"[];
-    readonly "health-insurance": readonly "RESPRSN"[];
-    readonly "animal-care": readonly ("RESPRSN" | "2250" | "3240")[];
-    readonly "animal-research": readonly ("RESPRSN" | "2250" | "3240")[];
-    readonly "animal-lab": readonly ("RESPRSN" | "2250" | "3141" | "3240")[];
-    readonly "animal-insurance": readonly "RESPRSN"[];
-    readonly "animal-tech": readonly "RESPRSN"[];
-    readonly "onehealth-research": readonly ("RESPRSN" | "221" | "2211" | "2212" | "2250" | "3240" | "3344")[];
-    readonly "onehealth-lab": readonly ("RESPRSN" | "221" | "2212" | "2250" | "3141" | "3212" | "3240" | "3344")[];
-    readonly "onehealth-tech": readonly "RESPRSN"[];
+    readonly "health-care": readonly ("RESPRSN" | "221" | "2211" | "2212" | "2221" | "2222" | "2240" | "4226" | "3344")[];
+    readonly "health-research": readonly ("RESPRSN" | "221" | "2211" | "2212" | "4226" | "3344")[];
+    readonly "health-lab": readonly ("RESPRSN" | "221" | "2212" | "3212" | "4226" | "3344")[];
+    readonly "health-tech": readonly ("RESPRSN" | "4226")[];
+    readonly "health-insurance": readonly ("RESPRSN" | "4226")[];
+    readonly "animal-care": readonly ("RESPRSN" | "2250" | "3240" | "4226")[];
+    readonly "animal-research": readonly ("RESPRSN" | "2250" | "3240" | "4226")[];
+    readonly "animal-lab": readonly ("RESPRSN" | "2250" | "3141" | "3240" | "4226")[];
+    readonly "animal-insurance": readonly ("RESPRSN" | "4226")[];
+    readonly "animal-tech": readonly ("RESPRSN" | "4226")[];
+    readonly "onehealth-research": readonly ("RESPRSN" | "221" | "2211" | "2212" | "2250" | "3240" | "4226" | "3344")[];
+    readonly "onehealth-lab": readonly ("RESPRSN" | "221" | "2212" | "2250" | "3141" | "3212" | "3240" | "4226" | "3344")[];
+    readonly "onehealth-tech": readonly ("RESPRSN" | "4226")[];
 }>;
 export declare const HealthcareProfessionalRolesBySector: Readonly<{
     readonly "health-care": Readonly<Record<string, Readonly<{

package/dist/constants/healthcare.js

@@ -364,6 +364,8 @@ export const HealthcareActorRoles = Object.freeze({
     /** ISCO-08 laboratory occupation for human medical/pathology work. */
     MedicalAndPathologyLaboratoryTechnician: 'ISCO-08|3212',
     VeterinaryTechnicianOrAssistant: 'ISCO-08|3240',
+    /** General receptionist occupation usable across human, animal and one-health organizations. */
+    Receptionist: 'ISCO-08|4226',
     /** Administrative health occupation; it does not imply clinical authority. */
     MedicalSecretary: 'ISCO-08|3344',
 });
@@ -389,6 +391,7 @@ export const HealthcareActorRoleCodes = Object.freeze({
     LifeScienceTechnician: '3141',
     MedicalAndPathologyLaboratoryTechnician: '3212',
     VeterinaryTechnicianOrAssistant: '3240',
+    Receptionist: '4226',
     MedicalSecretary: '3344',
 });
 function buildProfessionalIscoRoles() {
@@ -503,6 +506,17 @@ function buildProfessionalIscoRoles() {
                 titleEn: 'Veterinary technician or assistant',
             }),
         ],
+        [
+            HealthcareActorRoleCodes.Receptionist,
+            Object.freeze({
+                family: HealthcareRoleFamilies.ProfessionalOccupationIsco08,
+                codingSystem: ISCO08_CODING_SYSTEM,
+                code: HealthcareActorRoleCodes.Receptionist,
+                claim: HealthcareActorRoles.Receptionist,
+                i18nKey: `${ISCO08_I18N_NAMESPACE}.${HealthcareActorRoleCodes.Receptionist}`,
+                titleEn: 'Receptionists (general)',
+            }),
+        ],
         [
             HealthcareActorRoleCodes.MedicalSecretary,
             Object.freeze({
@@ -580,6 +594,7 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
         HealthcareActorRoleCodes.NursingProfessional,
         HealthcareActorRoleCodes.MidwiferyProfessional,
         HealthcareActorRoleCodes.Paramedic,
+        HealthcareActorRoleCodes.Receptionist,
         HealthcareActorRoleCodes.MedicalSecretary,
     ]),
     [DataspaceSectors.HealthResearch]: Object.freeze([
@@ -587,6 +602,7 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
         HealthcareActorRoleCodes.MedicalDoctors,
         HealthcareActorRoleCodes.GeneralistMedicalPractitioner,
         HealthcareActorRoleCodes.SpecialistMedicalPractitioner,
+        HealthcareActorRoleCodes.Receptionist,
         HealthcareActorRoleCodes.MedicalSecretary,
     ]),
     [DataspaceSectors.HealthLab]: Object.freeze([
@@ -594,28 +610,32 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
         HealthcareActorRoleCodes.MedicalDoctors,
         HealthcareActorRoleCodes.SpecialistMedicalPractitioner,
         HealthcareActorRoleCodes.MedicalAndPathologyLaboratoryTechnician,
+        HealthcareActorRoleCodes.Receptionist,
         HealthcareActorRoleCodes.MedicalSecretary,
     ]),
-    [DataspaceSectors.HealthTech]: Object.freeze([HealthcareActorRoleCodes.Controller]),
-    [DataspaceSectors.HealthInsurance]: Object.freeze([HealthcareActorRoleCodes.Controller]),
+    [DataspaceSectors.HealthTech]: Object.freeze([HealthcareActorRoleCodes.Controller, HealthcareActorRoleCodes.Receptionist]),
+    [DataspaceSectors.HealthInsurance]: Object.freeze([HealthcareActorRoleCodes.Controller, HealthcareActorRoleCodes.Receptionist]),
     [DataspaceSectors.AnimalCare]: Object.freeze([
         HealthcareActorRoleCodes.Controller,
         HealthcareActorRoleCodes.Veterinarian,
         HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
+        HealthcareActorRoleCodes.Receptionist,
     ]),
     [DataspaceSectors.AnimalResearch]: Object.freeze([
         HealthcareActorRoleCodes.Controller,
         HealthcareActorRoleCodes.Veterinarian,
         HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
+        HealthcareActorRoleCodes.Receptionist,
     ]),
     [DataspaceSectors.AnimalLab]: Object.freeze([
         HealthcareActorRoleCodes.Controller,
         HealthcareActorRoleCodes.Veterinarian,
         HealthcareActorRoleCodes.LifeScienceTechnician,
         HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
+        HealthcareActorRoleCodes.Receptionist,
     ]),
-    [DataspaceSectors.AnimalInsurance]: Object.freeze([HealthcareActorRoleCodes.Controller]),
-    [DataspaceSectors.AnimalTech]: Object.freeze([HealthcareActorRoleCodes.Controller]),
+    [DataspaceSectors.AnimalInsurance]: Object.freeze([HealthcareActorRoleCodes.Controller, HealthcareActorRoleCodes.Receptionist]),
+    [DataspaceSectors.AnimalTech]: Object.freeze([HealthcareActorRoleCodes.Controller, HealthcareActorRoleCodes.Receptionist]),
     [DataspaceSectors.OneHealthResearch]: Object.freeze([
         HealthcareActorRoleCodes.Controller,
         HealthcareActorRoleCodes.MedicalDoctors,
@@ -623,6 +643,7 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
         HealthcareActorRoleCodes.SpecialistMedicalPractitioner,
         HealthcareActorRoleCodes.Veterinarian,
         HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
+        HealthcareActorRoleCodes.Receptionist,
         HealthcareActorRoleCodes.MedicalSecretary,
     ]),
     [DataspaceSectors.OneHealthLab]: Object.freeze([
@@ -633,9 +654,10 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
         HealthcareActorRoleCodes.LifeScienceTechnician,
         HealthcareActorRoleCodes.MedicalAndPathologyLaboratoryTechnician,
         HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
+        HealthcareActorRoleCodes.Receptionist,
         HealthcareActorRoleCodes.MedicalSecretary,
     ]),
-    [DataspaceSectors.OneHealthTech]: Object.freeze([HealthcareActorRoleCodes.Controller]),
+    [DataspaceSectors.OneHealthTech]: Object.freeze([HealthcareActorRoleCodes.Controller, HealthcareActorRoleCodes.Receptionist]),
 });
 export const HealthcareProfessionalRolesBySector = Object.freeze({
     [DataspaceSectors.HealthCare]: pickRoleCatalogByCodes(HealthcareProfessionalAndControllerRoles, HealthcareProfessionalRoleCodesBySector[DataspaceSectors.HealthCare]),

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

@@ -33,10 +33,11 @@ export type FhirIpsCreatorAuthor = Readonly<{
 }>;
 export type FhirIpsCreatorProvenanceInput = FhirIpsCreatorAuthorInput & Readonly<{
     /**
-     * Explicit source originator. Defaults to the owning organization or
-     * individual. When the authenticated member/professional actually authored
-     * the content, pass its registered RelatedPerson/PractitionerRole assignment
-     * reference; that same assignment may also remain the attester.
+     * Explicit document/source author. Defaults to the owning organization or
+     * individual. A registered RelatedPerson/PractitionerRole is an attester,
+     * never a substitute for the organization, EHR/portal or individual that
+     * authors the document. Passing the assignment reference is normalized to
+     * the owner for compatibility with the former creator-as-author contract.
      */
     compositionAuthorReference?: string;
     /** Defaults to professional for employees and personal for individual members. */
@@ -58,13 +59,11 @@ export type FhirIpsCreatorProvenance = Readonly<{
 /**
  * Builds source authorship separately from the person or role that attests it.
  *
- * Defaults model delegated flows: an organization's professional attests an
- * organization-authored record, while a member/caregiver attests a
- * subject-authored record. For content actually created by that authenticated
- * member or professional, set `compositionAuthorReference` to its registered
- * RelatedPerson or PractitionerRole assignment. Author and attester may then
- * intentionally reference the same assignment; neither is the transport
- * sender or signing key.
+ * An organization's employee attests an organization/EHR-authored record,
+ * while a controller/member/caregiver attests an individual-authored record.
+ * Neither the attester nor the document author is the transport sender or
+ * signing key merely because the same authenticated person performed the
+ * submission.
  */
 export declare function buildFhirIpsCreatorProvenance(input: FhirIpsCreatorProvenanceInput): FhirIpsCreatorProvenance;
 /**

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

@@ -11,13 +11,11 @@ export const FhirIpsCreatorKinds = Object.freeze({
 /**
  * Builds source authorship separately from the person or role that attests it.
  *
- * Defaults model delegated flows: an organization's professional attests an
- * organization-authored record, while a member/caregiver attests a
- * subject-authored record. For content actually created by that authenticated
- * member or professional, set `compositionAuthorReference` to its registered
- * RelatedPerson or PractitionerRole assignment. Author and attester may then
- * intentionally reference the same assignment; neither is the transport
- * sender or signing key.
+ * An organization's employee attests an organization/EHR-authored record,
+ * while a controller/member/caregiver attests an individual-authored record.
+ * Neither the attester nor the document author is the transport sender or
+ * signing key merely because the same authenticated person performed the
+ * submission.
  */
 export function buildFhirIpsCreatorProvenance(input) {
     if (input.kind === FhirIpsCreatorKinds.IndividualSubject) {
@@ -31,11 +29,14 @@ export function buildFhirIpsCreatorProvenance(input) {
     const defaultAuthor = input.kind === FhirIpsCreatorKinds.Professional
         ? input.organizationReference
         : input.subjectReference;
+    const requestedAuthor = input.compositionAuthorReference === creator.authorReference
+        ? defaultAuthor
+        : input.compositionAuthorReference;
     const mode = input.attesterMode || (input.kind === FhirIpsCreatorKinds.Professional
         ? CompositionAttesterModes.Professional
         : CompositionAttesterModes.Personal);
     return {
-        authorReference: requireReference(input.compositionAuthorReference || defaultAuthor, 'compositionAuthorReference'),
+        authorReference: requireReference(requestedAuthor || defaultAuthor, 'compositionAuthorReference'),
         attesters: [{
                 mode,
                 party: { reference: creator.authorReference },
@@ -89,6 +90,13 @@ export function buildFhirIpsCreatorAuthor(input) {
     return {
         authorReference: authorIdentifier,
         entries: [
+            {
+                fullUrl: organizationReference,
+                resource: {
+                    resourceType: 'Organization',
+                    identifier: [{ value: organizationReference }],
+                },
+            },
             {
                 fullUrl: actorIdentifier,
                 resource: {

package/package.json

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