gdc-common-utils-ts 2.8.2 → 2.8.4

package/dist/constants/healthcare.d.ts

@@ -1727,6 +1727,7 @@ export declare const HealthcareActorRoles: Readonly<{
     readonly MidwiferyProfessional: "ISCO-08|2222";
     readonly Paramedic: "ISCO-08|2240";
     readonly Veterinarian: "ISCO-08|2250";
+    readonly VeterinaryTechnicianOrAssistant: "ISCO-08|3240";
     /** Administrative health occupation; it does not imply clinical authority. */
     readonly MedicalSecretary: "ISCO-08|3344";
 }>;
@@ -1749,6 +1750,7 @@ export declare const HealthcareActorRoleCodes: Readonly<{
     readonly MidwiferyProfessional: "2222";
     readonly Paramedic: "2240";
     readonly Veterinarian: "2250";
+    readonly VeterinaryTechnicianOrAssistant: "3240";
     readonly MedicalSecretary: "3344";
 }>;
 export declare const HealthcareRolesByFamily: Readonly<{
@@ -1786,11 +1788,11 @@ export declare const HealthcareProfessionalRoleCodesBySector: Readonly<{
     readonly "health-research": readonly ("RESPRSN" | "221" | "2211" | "2212" | "3344")[];
     readonly "health-tech": readonly "RESPRSN"[];
     readonly "health-insurance": readonly "RESPRSN"[];
-    readonly "animal-care": readonly ("RESPRSN" | "2250")[];
-    readonly "animal-research": readonly ("RESPRSN" | "2250")[];
+    readonly "animal-care": readonly ("RESPRSN" | "2250" | "3240")[];
+    readonly "animal-research": readonly ("RESPRSN" | "2250" | "3240")[];
     readonly "animal-insurance": readonly "RESPRSN"[];
     readonly "animal-tech": readonly "RESPRSN"[];
-    readonly "onehealth-research": readonly ("RESPRSN" | "221" | "2211" | "2212" | "2250" | "3344")[];
+    readonly "onehealth-research": readonly ("RESPRSN" | "221" | "2211" | "2212" | "2250" | "3240" | "3344")[];
     readonly "onehealth-tech": readonly "RESPRSN"[];
 }>;
 export declare const HealthcareProfessionalRolesBySector: Readonly<{

package/dist/constants/healthcare.js

@@ -359,6 +359,7 @@ export const HealthcareActorRoles = Object.freeze({
     MidwiferyProfessional: 'ISCO-08|2222',
     Paramedic: 'ISCO-08|2240',
     Veterinarian: 'ISCO-08|2250',
+    VeterinaryTechnicianOrAssistant: 'ISCO-08|3240',
     /** Administrative health occupation; it does not imply clinical authority. */
     MedicalSecretary: 'ISCO-08|3344',
 });
@@ -381,6 +382,7 @@ export const HealthcareActorRoleCodes = Object.freeze({
     MidwiferyProfessional: '2222',
     Paramedic: '2240',
     Veterinarian: '2250',
+    VeterinaryTechnicianOrAssistant: '3240',
     MedicalSecretary: '3344',
 });
 function buildProfessionalIscoRoles() {
@@ -462,6 +464,17 @@ function buildProfessionalIscoRoles() {
                 titleEn: 'Veterinarian',
             }),
         ],
+        [
+            HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
+            Object.freeze({
+                family: HealthcareRoleFamilies.ProfessionalOccupationIsco08,
+                codingSystem: ISCO08_CODING_SYSTEM,
+                code: HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
+                claim: HealthcareActorRoles.VeterinaryTechnicianOrAssistant,
+                i18nKey: `${ISCO08_I18N_NAMESPACE}.${HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant}`,
+                titleEn: 'Veterinary technician or assistant',
+            }),
+        ],
         [
             HealthcareActorRoleCodes.MedicalSecretary,
             Object.freeze({
@@ -553,10 +566,12 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
     [DataspaceSectors.AnimalCare]: Object.freeze([
         HealthcareActorRoleCodes.Controller,
         HealthcareActorRoleCodes.Veterinarian,
+        HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
     ]),
     [DataspaceSectors.AnimalResearch]: Object.freeze([
         HealthcareActorRoleCodes.Controller,
         HealthcareActorRoleCodes.Veterinarian,
+        HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
     ]),
     [DataspaceSectors.AnimalInsurance]: Object.freeze([HealthcareActorRoleCodes.Controller]),
     [DataspaceSectors.AnimalTech]: Object.freeze([HealthcareActorRoleCodes.Controller]),
@@ -566,6 +581,7 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
         HealthcareActorRoleCodes.GeneralistMedicalPractitioner,
         HealthcareActorRoleCodes.SpecialistMedicalPractitioner,
         HealthcareActorRoleCodes.Veterinarian,
+        HealthcareActorRoleCodes.VeterinaryTechnicianOrAssistant,
         HealthcareActorRoleCodes.MedicalSecretary,
     ]),
     [DataspaceSectors.OneHealthTech]: Object.freeze([HealthcareActorRoleCodes.Controller]),

package/dist/utils/clinical-resource-replacement.d.ts

@@ -0,0 +1,34 @@
+export declare const ClinicalResourceReplacementDecision: Readonly<{
+    readonly AllowOrganizationSuccessor: "allow-organization-successor";
+    readonly Deny: "deny";
+}>;
+export type ClinicalResourceReplacementDecisionValue = typeof ClinicalResourceReplacementDecision[keyof typeof ClinicalResourceReplacementDecision];
+export type ClinicalResourceVersionIdentity = Readonly<{
+    resourceId: string;
+    authorOwnerIdentifier: string;
+    documentDate: string;
+}>;
+export type ClinicalDocumentAuthorOrganization = Readonly<{
+    authorReference: string;
+    organizationReference: string;
+    documentDate: string;
+}>;
+/**
+ * Resolves document ownership from the FHIR graph carried by an IPS Bundle.
+ * A Composition may name its Organization directly or name a PractitionerRole
+ * whose `organization` reference names it. Custodian is a compatibility
+ * fallback only when the author is a Practitioner represented without a
+ * PractitionerRole organization link.
+ */
+export declare function resolveClinicalDocumentAuthorOrganization(bundle: unknown): ClinicalDocumentAuthorOrganization | undefined;
+/**
+ * Evaluates the narrow provenance-preserving replacement exception.
+ *
+ * This does not authorize an actor or a delete. Gateways call it only after
+ * authenticating the sender and resolving both document authors to their
+ * registered owning organizations.
+ */
+export declare function evaluateClinicalResourceReplacement(input: Readonly<{
+    existing: ClinicalResourceVersionIdentity;
+    incoming: ClinicalResourceVersionIdentity;
+}>): ClinicalResourceReplacementDecisionValue;

package/dist/utils/clinical-resource-replacement.js

@@ -0,0 +1,83 @@
+export const ClinicalResourceReplacementDecision = Object.freeze({
+    AllowOrganizationSuccessor: 'allow-organization-successor',
+    Deny: 'deny',
+});
+function cleanReference(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function resourceReference(resource) {
+    const resourceType = cleanReference(resource?.resourceType);
+    const id = cleanReference(resource?.id);
+    return resourceType && id ? `${resourceType}/${id}` : '';
+}
+/**
+ * Resolves document ownership from the FHIR graph carried by an IPS Bundle.
+ * A Composition may name its Organization directly or name a PractitionerRole
+ * whose `organization` reference names it. Custodian is a compatibility
+ * fallback only when the author is a Practitioner represented without a
+ * PractitionerRole organization link.
+ */
+export function resolveClinicalDocumentAuthorOrganization(bundle) {
+    const entries = Array.isArray(bundle?.entry)
+        ? bundle.entry
+        : [];
+    const composition = entries.find(({ resource }) => resource?.resourceType === 'Composition')?.resource;
+    const authorReference = cleanReference(composition?.author?.[0]?.reference);
+    const documentDate = cleanReference(composition?.date);
+    if (!composition || !authorReference || !documentDate || !Number.isFinite(Date.parse(documentDate))) {
+        return undefined;
+    }
+    const findResource = (reference) => entries.find((entry) => {
+        const fullUrl = cleanReference(entry.fullUrl);
+        const relativeReference = resourceReference(entry.resource);
+        return reference === fullUrl
+            || reference === relativeReference
+            || (fullUrl && relativeReference && reference === `${fullUrl.replace(/\/$/, '')}/${relativeReference}`);
+    })?.resource;
+    const author = findResource(authorReference);
+    let organizationReference = '';
+    if (author?.resourceType === 'Organization') {
+        organizationReference = authorReference;
+    }
+    else if (author?.resourceType === 'PractitionerRole') {
+        organizationReference = cleanReference(author.organization?.reference);
+    }
+    else if (author?.resourceType === 'Practitioner') {
+        const role = entries.find(({ resource }) => resource?.resourceType === 'PractitionerRole'
+            && cleanReference(resource.practitioner?.reference) === authorReference)?.resource;
+        organizationReference = cleanReference(role?.organization?.reference);
+    }
+    if (!organizationReference) {
+        organizationReference = cleanReference(composition.custodian?.reference);
+    }
+    const organization = findResource(organizationReference);
+    if (!organizationReference || organization?.resourceType !== 'Organization') {
+        return undefined;
+    }
+    return { authorReference, organizationReference, documentDate };
+}
+/**
+ * Evaluates the narrow provenance-preserving replacement exception.
+ *
+ * This does not authorize an actor or a delete. Gateways call it only after
+ * authenticating the sender and resolving both document authors to their
+ * registered owning organizations.
+ */
+export function evaluateClinicalResourceReplacement(input) {
+    const existingResourceId = String(input.existing.resourceId || '').trim();
+    const incomingResourceId = String(input.incoming.resourceId || '').trim();
+    const existingOwner = String(input.existing.authorOwnerIdentifier || '').trim();
+    const incomingOwner = String(input.incoming.authorOwnerIdentifier || '').trim();
+    const existingDate = Date.parse(String(input.existing.documentDate || '').trim());
+    const incomingDate = Date.parse(String(input.incoming.documentDate || '').trim());
+    if (!existingResourceId
+        || incomingResourceId !== existingResourceId
+        || !existingOwner
+        || incomingOwner !== existingOwner
+        || !Number.isFinite(existingDate)
+        || !Number.isFinite(incomingDate)
+        || incomingDate <= existingDate) {
+        return ClinicalResourceReplacementDecision.Deny;
+    }
+    return ClinicalResourceReplacementDecision.AllowOrganizationSuccessor;
+}

package/dist/utils/index.d.ts

@@ -59,6 +59,7 @@ export * from './related-person-list';
 export * from './clinical-resource-converters';
 export * from './clinical-bundle-summary';
 export * from './clinical-resource-view';
+export * from './clinical-resource-replacement';
 export * from './fhir-validator';
 export * from './family-registration-test-data';
 export * from './individual-form-pdf';

package/dist/utils/index.js

@@ -59,6 +59,7 @@ export * from './related-person-list.js';
 export * from './clinical-resource-converters.js';
 export * from './clinical-bundle-summary.js';
 export * from './clinical-resource-view.js';
+export * from './clinical-resource-replacement.js';
 export * from './fhir-validator.js';
 export * from './family-registration-test-data.js';
 export * from './individual-form-pdf.js';

package/package.json

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