gdc-common-utils-ts 1.14.0 → 1.14.1

package/README.md

@@ -275,6 +275,8 @@ The canonical API contract should live in JSDoc on exported code. The README act
   - `tenantId` is modeled as an identifier-like route token (`acme-id`), not as a friendly alternate name.
 - [`docs/LIFECYCLE_101.md`](docs/LIFECYCLE_101.md)
   - Copy/paste lifecycle `101` guide with semantic rules and reusable placeholders.
+- [`docs/HEALTHCARE_ROLES_I18N_101.md`](docs/HEALTHCARE_ROLES_I18N_101.md)
+  - Sector-aware healthcare role catalog and i18n `101` (ISCO-08 + HL7) for FE/BE onboarding.
 
 ## Documentation Naming Rules
 

package/dist/constants/healthcare.d.ts

@@ -1,69 +1,119 @@
 import { LOINC_SYSTEM_URL } from '../models/clinical-sections';
+import { type DataspaceSector } from './sectors';
 export type HealthcareSectionDescriptor = Readonly<{
     system: typeof LOINC_SYSTEM_URL;
     code: string;
     claim: string;
+    i18nKey: `org.loinc.${string}`;
+    titleEn?: string;
 }>;
+export declare const ISCO08_CODING_SYSTEM: "org.ilo.isco";
+export declare const ISCO08_I18N_NAMESPACE: "org.ilo.isco-08";
+export declare const HealthcareRoleFamilies: Readonly<{
+    readonly ProfessionalOccupationIsco08: "professionalOccupationIsco08";
+    readonly PersonalRelationshipHl7: "personalRelationshipHl7";
+    readonly LegalRepresentativeHl7: "legalRepresentativeHl7";
+}>;
+export type HealthcareRoleFamily = typeof HealthcareRoleFamilies[keyof typeof HealthcareRoleFamilies];
+export type HealthcareActorRoleDescriptor = Readonly<{
+    family: HealthcareRoleFamily;
+    codingSystem: string;
+    code: string;
+    claim: string;
+    i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+    titleEn: string;
+    definition?: string;
+}>;
+export declare const HealthcareSectionFamilies: Readonly<{
+    readonly Summary: "summary";
+    readonly Management: "management";
+    readonly SubjectMatterDomain: "subjectMatterDomain";
+}>;
+export type HealthcareSectionFamily = typeof HealthcareSectionFamilies[keyof typeof HealthcareSectionFamilies];
 export declare const HealthcareBasicSections: Readonly<{
     PatientSummaryDocument: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     AllergiesAndIntolerances: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     HistoryOfMedicationUse: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     ProblemList: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     Results: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     Procedures: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     Immunizations: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     MedicalDevices: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     FunctionalStatus: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     PlanOfCare: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     SocialHistory: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     VitalSigns: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
 }>;
 export declare const HealthcareAdditionalSections: Readonly<{
@@ -71,31 +121,43 @@ export declare const HealthcareAdditionalSections: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     DiagnosticImaging: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     HistoryOfPastIllness: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     ReasonForReferral: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     ChiefComplaint: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     HealthcareGeneral: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
 }>;
 export declare const HealthcareAllSections: Readonly<{
@@ -103,93 +165,164 @@ export declare const HealthcareAllSections: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     DiagnosticImaging: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     HistoryOfPastIllness: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     ReasonForReferral: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     ChiefComplaint: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     HealthcareGeneral: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     PatientSummaryDocument: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     AllergiesAndIntolerances: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     HistoryOfMedicationUse: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     ProblemList: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     Results: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     Procedures: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     Immunizations: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     MedicalDevices: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     FunctionalStatus: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     PlanOfCare: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     SocialHistory: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
     VitalSigns: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
         claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
     }>;
 }>;
+/**
+ * Full section families sourced from the existing section catalogs in
+ * `models/clinical-sections.en.ts`.
+ *
+ * Family mapping used by SDK/business layers:
+ * - `summary`: IPS/base summary sections.
+ * - `management`: kind-of-document and type-of-service oriented sections.
+ * - `subjectMatterDomain`: additional service-domain sections.
+ */
+export declare const HealthcareSectionsByFamily: Readonly<{
+    readonly summary: Readonly<Record<string, Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>>>;
+    readonly management: Readonly<Record<string, Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>>>;
+    readonly subjectMatterDomain: Readonly<Record<string, Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>>>;
+}>;
+export declare const HealthcareAllSectionsByCode: Readonly<Record<string, HealthcareSectionDescriptor>>;
+export declare function getHealthcareSectionByCode(code: string): HealthcareSectionDescriptor | undefined;
+export declare function getHealthcareSectionsByFamily(family: HealthcareSectionFamily): Readonly<Record<string, HealthcareSectionDescriptor>>;
 export declare const HealthcareConsentPurposes: Readonly<{
     readonly Treatment: "TREAT";
     readonly EmergencyTreatment: "ETREAT";
@@ -203,6 +336,7 @@ export declare const HealthcareActorRoles: Readonly<{
     readonly Physician: "ISCO-08|2211";
     readonly NursingProfessional: "ISCO-08|2221";
     readonly Paramedic: "ISCO-08|2240";
+    readonly Veterinarian: "ISCO-08|2250";
 }>;
 export declare const HealthcareActorRoleCodes: Readonly<{
     readonly Controller: "1120";
@@ -210,7 +344,147 @@ export declare const HealthcareActorRoleCodes: Readonly<{
     readonly PhysicianBroad: "221";
     readonly NursingProfessional: "2221";
     readonly Paramedic: "2240";
+    readonly Veterinarian: "2250";
+}>;
+export declare const HealthcareRolesByFamily: Readonly<{
+    readonly professionalOccupationIsco08: Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly personalRelationshipHl7: Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly legalRepresentativeHl7: Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+}>;
+export declare const HealthcareAllRolesByClaim: Readonly<Record<string, HealthcareActorRoleDescriptor>>;
+export declare const HealthcareProfessionalRoleCodesBySector: Readonly<{
+    readonly "health-care": readonly ("1120" | "2211" | "2221" | "2240")[];
+    readonly "health-research": readonly ("1120" | "2211")[];
+    readonly "health-tech": readonly "1120"[];
+    readonly "health-insurance": readonly "1120"[];
+    readonly "animal-care": readonly ("1120" | "2250")[];
+    readonly "animal-research": readonly ("1120" | "2250")[];
+    readonly "animal-insurance": readonly "1120"[];
+    readonly "animal-tech": readonly "1120"[];
+    readonly "onehealth-research": readonly ("1120" | "2211" | "2250")[];
+    readonly "onehealth-tech": readonly "1120"[];
+}>;
+export declare const HealthcareProfessionalRolesBySector: Readonly<{
+    readonly "health-care": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "health-research": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "health-tech": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "health-insurance": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "animal-care": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "animal-research": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "animal-insurance": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "animal-tech": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "onehealth-research": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
+    readonly "onehealth-tech": Readonly<Record<string, Readonly<{
+        family: HealthcareRoleFamily;
+        codingSystem: string;
+        code: string;
+        claim: string;
+        i18nKey: `org.ilo.isco-08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+        titleEn: string;
+        definition?: string;
+    }>>>;
 }>;
+export declare const HealthcareRolesBySector: Readonly<Record<DataspaceSector, Readonly<Record<HealthcareRoleFamily, Readonly<Record<string, HealthcareActorRoleDescriptor>>>>>>;
+export declare function getHealthcareRolesByFamily(family: HealthcareRoleFamily): Readonly<Record<string, HealthcareActorRoleDescriptor>>;
+export declare function getHealthcareRoleByClaim(claim: string): HealthcareActorRoleDescriptor | undefined;
+export declare function getHealthcareProfessionalRolesBySector(sector: DataspaceSector): Readonly<Record<string, HealthcareActorRoleDescriptor>>;
+export declare function getHealthcareRolesBySector(sector: DataspaceSector, family: HealthcareRoleFamily): Readonly<Record<string, HealthcareActorRoleDescriptor>>;
 export declare const HealthcareConsentActions: Readonly<{
     readonly PatientSummaryDocument: string;
     readonly AllergiesAndIntolerances: string;