gdc-common-utils-ts 2.0.18 → 2.1.0

package/dist/utils/communication-attached-bundle-session.js

@@ -1,28 +1,13 @@
 // Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
 // Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
 import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
-import { getHealthcareProfessionalRolesBySector, getHealthcareRoleByClaim, HealthcareRoleFamilies, getHealthcareRolesByFamily, getHealthcareSectionsByFamily, getHealthcareSectionByCode, getHealthcareSectionFamilyByCode, HealthcareConsentPurposes, HealthcareCanonicalSectionFamilies, } from '../constants/healthcare.js';
-import { ClaimConsent } from '../models/consent-rule.js';
-import { AllergyIntoleranceClaim } from '../models/interoperable-claims/allergy-intolerance-claims.js';
 import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
-import { ConditionClaim } from '../models/interoperable-claims/condition-claims.js';
 import { DocumentReferenceClaim } from '../models/interoperable-claims/document-reference-claims.js';
+import { BundleEntryClaimsContext, } from '../models/communication-attached-bundle-session.js';
 import { BundleQuery } from './bundle-query.js';
 import { addClaimValues } from '../claims/claim-list-helpers.js';
-import { detectDuplicateConsentRuleConflicts, } from './consent-duplicate-rules.js';
-import { MedicationStatementClaim, } from '../models/interoperable-claims/medication-statement-claims.js';
-import { ObservationClaim } from '../models/interoperable-claims/observation-claims.js';
-export const ConsentEditorTargetKinds = Object.freeze({
-    Section: 'section',
-    ResourceType: 'resource-type',
-});
-export const ConsentEditorScopeCodes = Object.freeze({
-    Search: 's',
-    Read: 'r',
-    Create: 'c',
-    Update: 'u',
-    Delete: 'd',
-});
+import { asTrimmedString, cloneBundle, cloneEntry, cloneUnknownValue, createEmptyBundle, encodeBundleToBase64, ensureEntryResource, resolveBundleEntryCanonicalIdValue, resolveBundleEntryIdentifier, resolveContainedDocumentsClaimKey, resolveSubjectFromClaims, runtimeUuid, setIfMissing, validateBundleLike, } from './communication-attached-bundle-session-helpers.js';
+export { BundleEntryClaimsContext, CommunicationAttachmentClaimsContext, ConsentEditorScopeCodes, ConsentEditorTargetKinds, } from '../models/communication-attached-bundle-session.js';
 /**
  * Communication editing session with bundle-in-memory as source of truth.
  *
@@ -64,10 +49,18 @@ export class CommunicationAttachedBundleSession {
     getActiveEntryIndex() {
         return this.activeEntryIndex;
     }
+    /** Returns the active entry position, or null when no entry is selected. */
+    getActiveEntryPosition() {
+        return this.activeEntryIndex;
+    }
     /** Alias of `getActiveEntryIndex()` with entry-selection wording. */
     getSelectedEntryIndex() {
         return this.getActiveEntryIndex();
     }
+    /** Alias of `getActiveEntryPosition()` with entry-selection wording. */
+    getSelectedEntryPosition() {
+        return this.getActiveEntryPosition();
+    }
     /** Returns a deep copy of the active entry when selected. */
     getActiveEntry() {
         if (this.activeEntryIndex === null) {
@@ -155,11 +148,14 @@ export class CommunicationAttachedBundleSession {
         this.syncAttachmentFromBundle();
         return this;
     }
-    /** Selects an active entry by index or fullUrl. */
+    /** Selects an active entry by position or fullUrl. */
     selectActiveEntry(selection) {
-        if (typeof selection.index === 'number') {
-            this.assertEntryIndex(selection.index);
-            this.activeEntryIndex = selection.index;
+        const requestedPosition = typeof selection.position === 'number'
+            ? selection.position
+            : selection.index;
+        if (typeof requestedPosition === 'number') {
+            this.assertEntryIndex(requestedPosition);
+            this.activeEntryIndex = requestedPosition;
             return this;
         }
         if (selection.fullUrl) {
@@ -170,7 +166,7 @@ export class CommunicationAttachedBundleSession {
             this.activeEntryIndex = foundIndex;
             return this;
         }
-        throw new Error('selectActiveEntry requires either index or fullUrl.');
+        throw new Error('selectActiveEntry requires either position or fullUrl.');
     }
     /** Alias of `selectActiveEntry()` with entry-selection wording. */
     selectEntry(selection) {
@@ -200,49 +196,44 @@ export class CommunicationAttachedBundleSession {
         return this;
     }
     /**
-     * Consent-first helper for developer onboarding.
+     * Reusable resource-typed wrapper around `upsertActiveEntry(...)`.
      *
-     * Expected keys should come from `ClaimConsent` in caller code.
+     * Resource-specific helpers should delegate here instead of re-embedding the
+     * same `resourceType/fullUrl/type/request/claims` plumbing.
      */
-    upsertActiveConsentEntry(input) {
+    upsertActiveClaimsResourceEntry(resourceType, input) {
         return this.upsertActiveEntry({
-            resourceType: ResourceTypesFhirR4.Consent,
-            claims: input.claims,
+            resourceType,
+            claims: {
+                ...input.claims,
+            },
             fullUrl: input.fullUrl,
             type: input.type,
             request: input.request,
         });
     }
+    /**
+     * Consent-first helper for developer onboarding.
+     *
+     * Expected keys should come from `ClaimConsent` in caller code.
+     */
+    upsertActiveConsentEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Consent, input);
+    }
     /**
      * MedicationStatement helper for IPS-in-Communication use cases.
      *
      * Expected keys should come from MedicationStatement claims constants.
      */
     upsertActiveMedicationStatementEntry(input) {
-        return this.upsertActiveEntry({
-            resourceType: ResourceTypesFhirR4.MedicationStatement,
-            claims: {
-                ...input.claims,
-            },
-            fullUrl: input.fullUrl,
-            type: input.type,
-            request: input.request,
-        });
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.MedicationStatement, input);
     }
     /**
      * DocumentReference helper for bundle-contained attachments linked from
      * other clinical resources through `*.contained-documents`.
      */
     upsertActiveDocumentReferenceEntry(input) {
-        return this.upsertActiveEntry({
-            resourceType: ResourceTypesFhirR4.DocumentReference,
-            claims: {
-                ...input.claims,
-            },
-            fullUrl: input.fullUrl,
-            type: input.type,
-            request: input.request,
-        });
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.DocumentReference, input);
     }
     /**
      * Condition helper for IPS-in-Communication use cases.
@@ -250,15 +241,15 @@ export class CommunicationAttachedBundleSession {
      * Expected keys should come from Condition claims constants.
      */
     upsertActiveConditionEntry(input) {
-        return this.upsertActiveEntry({
-            resourceType: ResourceTypesFhirR4.Condition,
-            claims: {
-                ...input.claims,
-            },
-            fullUrl: input.fullUrl,
-            type: input.type,
-            request: input.request,
-        });
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Condition, input);
+    }
+    /**
+     * Appointment helper for schedule/event flows carried inside Communication.
+     *
+     * Expected keys should come from Appointment claims constants.
+     */
+    upsertActiveAppointmentEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Appointment, input);
     }
     /**
      * Observation helper for IPS-style and sectioned bundle authoring.
@@ -266,15 +257,7 @@ export class CommunicationAttachedBundleSession {
      * Expected keys should come from Observation claims constants.
      */
     upsertActiveObservationEntry(input) {
-        return this.upsertActiveEntry({
-            resourceType: ResourceTypesFhirR4.Observation,
-            claims: {
-                ...input.claims,
-            },
-            fullUrl: input.fullUrl,
-            type: input.type,
-            request: input.request,
-        });
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Observation, input);
     }
     /**
      * AllergyIntolerance helper for IPS-in-Communication use cases.
@@ -282,33 +265,68 @@ export class CommunicationAttachedBundleSession {
      * Expected keys should come from AllergyIntolerance claims constants.
      */
     upsertActiveAllergyIntoleranceEntry(input) {
-        return this.upsertActiveEntry({
-            resourceType: ResourceTypesFhirR4.AllergyIntolerance,
-            claims: {
-                ...input.claims,
-            },
-            fullUrl: input.fullUrl,
-            type: input.type,
-            request: input.request,
-        });
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.AllergyIntolerance, input);
+    }
+    /** DiagnosticReport helper for report-in-Communication use cases. */
+    upsertActiveDiagnosticReportEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.DiagnosticReport, input);
+    }
+    /** CarePlan helper for plan-in-Communication use cases. */
+    upsertActiveCarePlanEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.CarePlan, input);
+    }
+    /** Procedure helper for procedure-in-Communication use cases. */
+    upsertActiveProcedureEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Procedure, input);
+    }
+    /** Immunization helper for immunization-in-Communication use cases. */
+    upsertActiveImmunizationEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Immunization, input);
+    }
+    /** Encounter helper for visit/event flows carried inside Communication. */
+    upsertActiveEncounterEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Encounter, input);
+    }
+    /** Device helper for device catalog or implant/device context flows. */
+    upsertActiveDeviceEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Device, input);
+    }
+    /** DeviceUseStatement helper for device usage flows carried inside Communication. */
+    upsertActiveDeviceUseStatementEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.DeviceUseStatement, input);
+    }
+    /** Flag helper for alert/banner flows carried inside Communication. */
+    upsertActiveFlagEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Flag, input);
+    }
+    /** ClinicalImpression helper for assessment flows carried inside Communication. */
+    upsertActiveClinicalImpressionEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.ClinicalImpression, input);
+    }
+    /** Coverage helper for entitlement/insurance flows carried inside Communication. */
+    upsertActiveCoverageEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Coverage, input);
+    }
+    /** AppointmentResponse helper for schedule-response flows carried inside Communication. */
+    upsertActiveAppointmentResponseEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.AppointmentResponse, input);
+    }
+    /** Composition helper for document-structure flows carried inside Communication. */
+    upsertActiveCompositionEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Composition, input);
+    }
+    /** Location helper for schedule/place flows carried inside Communication. */
+    upsertActiveLocationEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Location, input);
+    }
+    /** Organization helper for provider/payer/department flows carried inside Communication. */
+    upsertActiveOrganizationEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.Organization, input);
+    }
+    /** RelatedPerson helper for relationship/member flows carried inside Communication. */
+    upsertActiveRelatedPersonEntry(input) {
+        return this.upsertActiveClaimsResourceEntry(ResourceTypesFhirR4.RelatedPerson, input);
     }
-    /**
-     * TODO(ips-next):
-     * Add `upsertActiveDiagnosticReportEntry(...)` once the shared claim helpers
-     * for `DiagnosticReport` are in place.
-     *
-     * Expected shape should mirror the existing resource helpers:
-     * - `claims` authored with `@context = org.hl7.fhir.api`
-     * - matching priority by `DiagnosticReport.identifier`
-     * - support for linked `DocumentReference` ids through
-     *   `DiagnosticReport.contained-documents`
-     *
-     * Intentionally not implemented in this pass:
-     * - IPS authoring already works for the currently documented resources
-     * - GW Core can already consume bundle-contained `DocumentReference` rows
-     * - adding the DiagnosticReport editing surface now would expand the IPS
-     *   contract further than intended for this release slice
-     */
     /**
      * Creates or updates a linked `DocumentReference` entry and stores its
      * identifier under the active resource `*.contained-documents` claim.
@@ -335,7 +353,7 @@ export class CommunicationAttachedBundleSession {
             || resolveSubjectFromClaims(parentClaims)
             || asTrimmedString(this.communicationClaims[CommunicationClaim.Subject]);
         const documentClaims = {
-            '@context': 'org.hl7.fhir.api',
+            '@context': BundleEntryClaimsContext,
             ...(input.claims || {}),
             [DocumentReferenceClaim.Identifier]: documentIdentifier,
         };
@@ -460,29 +478,9 @@ export class CommunicationAttachedBundleSession {
     resolveCurrentSubject() {
         if (this.activeEntryIndex !== null) {
             const claims = this.bundleInMemory.data[this.activeEntryIndex]?.resource?.meta?.claims || {};
-            const consentSubject = asTrimmedString(claims[ClaimConsent.subject]);
-            if (consentSubject) {
-                return consentSubject;
-            }
-            const medicationSubject = asTrimmedString(claims[MedicationStatementClaim.Subject]);
-            if (medicationSubject) {
-                return medicationSubject;
-            }
-            const conditionSubject = asTrimmedString(claims[ConditionClaim.Subject]);
-            if (conditionSubject) {
-                return conditionSubject;
-            }
-            const allergySubject = asTrimmedString(claims[AllergyIntoleranceClaim.Subject] || claims[AllergyIntoleranceClaim.Patient]);
-            if (allergySubject) {
-                return allergySubject;
-            }
-            const documentReferenceSubject = asTrimmedString(claims[DocumentReferenceClaim.Subject]);
-            if (documentReferenceSubject) {
-                return documentReferenceSubject;
-            }
-            const observationSubject = asTrimmedString(claims[ObservationClaim.Subject] || claims[ObservationClaim.Patient]);
-            if (observationSubject) {
-                return observationSubject;
+            const entrySubject = resolveSubjectFromClaims(claims);
+            if (entrySubject) {
+                return entrySubject;
             }
         }
         const fromClaims = asTrimmedString(this.communicationClaims[CommunicationClaim.Subject]);
@@ -506,31 +504,7 @@ export class CommunicationAttachedBundleSession {
         });
     }
     resolveEntryIdentifier(claims) {
-        const consentIdentifier = asTrimmedString(claims[ClaimConsent.identifier]);
-        if (consentIdentifier) {
-            return `${ResourceTypesFhirR4.Consent}:${consentIdentifier}`;
-        }
-        const medicationIdentifier = asTrimmedString(claims[MedicationStatementClaim.Identifier]);
-        if (medicationIdentifier) {
-            return `${ResourceTypesFhirR4.MedicationStatement}:${medicationIdentifier}`;
-        }
-        const conditionIdentifier = asTrimmedString(claims[ConditionClaim.Identifier]);
-        if (conditionIdentifier) {
-            return `${ResourceTypesFhirR4.Condition}:${conditionIdentifier}`;
-        }
-        const allergyIdentifier = asTrimmedString(claims[AllergyIntoleranceClaim.Identifier]);
-        if (allergyIdentifier) {
-            return `${ResourceTypesFhirR4.AllergyIntolerance}:${allergyIdentifier}`;
-        }
-        const documentReferenceIdentifier = asTrimmedString(claims[DocumentReferenceClaim.Identifier]);
-        if (documentReferenceIdentifier) {
-            return `${ResourceTypesFhirR4.DocumentReference}:${documentReferenceIdentifier}`;
-        }
-        const observationIdentifier = asTrimmedString(claims[ObservationClaim.Identifier]);
-        if (observationIdentifier) {
-            return `${ResourceTypesFhirR4.Observation}:${observationIdentifier}`;
-        }
-        return '';
+        return resolveBundleEntryIdentifier(claims);
     }
     createBundleEntry(input) {
         const resourceClaims = {
@@ -551,35 +525,7 @@ export class CommunicationAttachedBundleSession {
         };
     }
     resolveEntryCanonicalIdValue(claims) {
-        const consentIdentifier = asTrimmedString(claims[ClaimConsent.identifier]);
-        if (consentIdentifier) {
-            return consentIdentifier;
-        }
-        const medicationIdentifier = asTrimmedString(claims[MedicationStatementClaim.Identifier]);
-        if (medicationIdentifier) {
-            return medicationIdentifier;
-        }
-        const conditionIdentifier = asTrimmedString(claims[ConditionClaim.Identifier]);
-        if (conditionIdentifier) {
-            return conditionIdentifier;
-        }
-        const allergyIdentifier = asTrimmedString(claims[AllergyIntoleranceClaim.Identifier]);
-        if (allergyIdentifier) {
-            return allergyIdentifier;
-        }
-        const documentReferenceIdentifier = asTrimmedString(claims[DocumentReferenceClaim.Identifier]);
-        if (documentReferenceIdentifier) {
-            return documentReferenceIdentifier;
-        }
-        const observationIdentifier = asTrimmedString(claims[ObservationClaim.Identifier]);
-        if (observationIdentifier) {
-            return observationIdentifier;
-        }
-        const communicationIdentifier = asTrimmedString(claims[CommunicationClaim.Identifier]);
-        if (communicationIdentifier) {
-            return communicationIdentifier;
-        }
-        return '';
+        return resolveBundleEntryCanonicalIdValue(claims);
     }
     assertEntryIndex(index) {
         if (!Number.isInteger(index) || index < 0 || index >= this.bundleInMemory.data.length) {
@@ -587,674 +533,3 @@ export class CommunicationAttachedBundleSession {
         }
     }
 }
-/**
- * High-level consent-access editor alias for onboarding and app-facing code.
- *
- * This keeps the business intent explicit for developers who are editing
- * Consent access rules inside a Communication-carried bundle and should not
- * need to start from the lower-level generic session name.
- */
-export class ConsentAccessEditor extends CommunicationAttachedBundleSession {
-    /** Returns duplicate atomic consent-rule conflicts across the current bundle. */
-    getConsentRuleDuplicateConflicts() {
-        return detectDuplicateConsentRuleConflicts(this.getBundleInMemory().data);
-    }
-    /** Returns duplicate atomic consent-rule conflicts affecting the active Consent entry. */
-    getActiveConsentRuleDuplicateConflicts() {
-        const activeEntryIndex = this.getActiveEntryIndex();
-        if (activeEntryIndex === null) {
-            return [];
-        }
-        return this.getConsentRuleDuplicateConflicts()
-            .filter((conflict) => conflict.affectedEntries.some((entry) => entry.entryIndex === activeEntryIndex));
-    }
-    /** Returns one frontend-facing editable view model for the active Consent entry. */
-    getConsentViewModel() {
-        const activeEntry = this.getActiveEntry();
-        const claims = {
-            ...(activeEntry?.resource?.meta?.claims || {}),
-        };
-        return {
-            ...(activeEntry?.fullUrl ? { fullUrl: activeEntry.fullUrl } : {}),
-            identifier: asTrimmedString(claims[ClaimConsent.identifier]),
-            subject: asTrimmedString(claims[ClaimConsent.subject]),
-            decision: this.getDecision(),
-            classifiedActors: this.getActorsClassified(),
-            classifiedRoles: this.getRolesClassified(),
-            classifiedPurposes: this.getPurposesClassified(),
-            classifiedTargets: this.getTargetsClassified(),
-        };
-    }
-    /** Applies one frontend-facing editable view model back into the active Consent entry. */
-    applyConsentViewModel(viewModel) {
-        this.setActiveEntryClaim(ClaimConsent.identifier, viewModel.identifier);
-        this.setActiveEntryClaim(ClaimConsent.subject, viewModel.subject);
-        this.setActiveEntryClaim(ClaimConsent.decision, viewModel.decision);
-        this.setActiveEntryClaimList(ClaimConsent.actorIdentifier, flattenClassifiedActors(viewModel.classifiedActors));
-        this.setSelectedRoles(flattenClassifiedRoles(viewModel.classifiedRoles));
-        this.setSelectedPurposes(viewModel.classifiedPurposes.map((purpose) => purpose.code));
-        const flattenedTargets = flattenClassifiedTargets(viewModel.classifiedTargets);
-        this.setSelectedCoreSections(flattenedTargets.coreSections);
-        this.setSelectedKindOfDocuments(flattenedTargets.kindOfDocuments);
-        this.setSelectedTypeOfServices(flattenedTargets.typeOfServices);
-        this.setSelectedSubjectMatterDomains(flattenedTargets.subjectMatterDomains);
-        this.setSelectedResourceTypes(flattenedTargets.resourceTypes);
-        return this;
-    }
-    /** Returns the canonical permit/deny decision from the active Consent entry. */
-    getDecision() {
-        return asTrimmedString(this.getActiveEntryClaim(ClaimConsent.decision));
-    }
-    /**
-     * @deprecated Use `getDecision()`.
-     * Kept as a compatibility alias for the previous helper name.
-     */
-    getPermit() {
-        return this.getDecision();
-    }
-    /**
-     * Returns target classification derived from the current consent claim
-     * contract without altering or extending the persisted claim keys.
-     */
-    getTargetsClassified() {
-        const claims = {
-            ...(this.getActiveEntry()?.resource?.meta?.claims || {}),
-        };
-        const actionTargets = splitCsv(claims[ClaimConsent.action]).map((code) => buildClassifiedConsentTarget(ConsentEditorTargetKinds.Section, code, [ConsentEditorScopeCodes.Read]));
-        const categoryTargets = splitCsv(claims[ClaimConsent.category]).map((code) => buildClassifiedConsentTarget(ConsentEditorTargetKinds.Section, code, [ConsentEditorScopeCodes.Read], HealthcareCanonicalSectionFamilies.KindOfDocument));
-        const resourceTypes = splitCsv(claims[ClaimConsent.resourceType]).map((code) => buildClassifiedConsentTarget(ConsentEditorTargetKinds.ResourceType, code, [ConsentEditorScopeCodes.Read]));
-        return normalizeClassifiedTargets([
-            ...actionTargets,
-            ...categoryTargets,
-            ...resourceTypes,
-        ]);
-    }
-    /** Returns the catalog of core-section targets available for picker UIs. */
-    getCoreSectionOptions() {
-        return buildSectionCatalogOptions(HealthcareCanonicalSectionFamilies.CoreSection);
-    }
-    /** Returns the core-section catalog keyed by LOINC code. */
-    getCoreSectionCatalog() {
-        return getHealthcareSectionsByFamily(HealthcareCanonicalSectionFamilies.CoreSection);
-    }
-    /** Returns the catalog of kind-of-document targets available for picker UIs. */
-    getKindOfDocumentOptions() {
-        return buildSectionCatalogOptions(HealthcareCanonicalSectionFamilies.KindOfDocument);
-    }
-    /** Returns the kind-of-document catalog keyed by LOINC code. */
-    getKindOfDocumentCatalog() {
-        return getHealthcareSectionsByFamily(HealthcareCanonicalSectionFamilies.KindOfDocument);
-    }
-    /** Returns the catalog of type-of-service targets available for picker UIs. */
-    getTypeOfServiceOptions() {
-        return buildSectionCatalogOptions(HealthcareCanonicalSectionFamilies.TypeOfService);
-    }
-    /** Returns the type-of-service catalog keyed by LOINC code. */
-    getTypeOfServiceCatalog() {
-        return getHealthcareSectionsByFamily(HealthcareCanonicalSectionFamilies.TypeOfService);
-    }
-    /** Returns the catalog of subject-matter-domain targets available for picker UIs. */
-    getSubjectMatterDomainOptions() {
-        return buildSectionCatalogOptions(HealthcareCanonicalSectionFamilies.SubjectMatterDomain);
-    }
-    /** Returns the subject-matter-domain catalog keyed by LOINC code. */
-    getSubjectMatterDomainCatalog() {
-        return getHealthcareSectionsByFamily(HealthcareCanonicalSectionFamilies.SubjectMatterDomain);
-    }
-    /** Returns resource-type targets currently known in the active consent entry. */
-    getResourceTypeOptions() {
-        return this.getSelectedResourceTypes().map((code) => buildClassifiedConsentTarget(ConsentEditorTargetKinds.ResourceType, code, [ConsentEditorScopeCodes.Read]));
-    }
-    /** Returns the supported resource-type catalog. */
-    getResourceTypeCatalog() {
-        return Object.values(ResourceTypesFhirR4).filter((resourceType) => resourceType !== ResourceTypesFhirR4.Bundle);
-    }
-    /** Returns the available professional roles for one sector. */
-    getAvailableProfessionalRolesBySector(sector) {
-        return getHealthcareProfessionalRolesBySector(sector);
-    }
-    /** Returns the available HL7 relationship roles. */
-    getAvailableRelationshipRoles() {
-        return getHealthcareRolesByFamily(HealthcareRoleFamilies.PersonalRelationshipHl7);
-    }
-    /** Returns selected core-section claim values. */
-    getSelectedCoreSections() {
-        return this.getSelectedSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.CoreSection);
-    }
-    /** Returns selected kind-of-document claim values. */
-    getSelectedKindOfDocuments() {
-        return splitCsv(this.getActiveEntryClaim(ClaimConsent.category));
-    }
-    /** Returns selected type-of-service claim values. */
-    getSelectedTypeOfServices() {
-        return this.getSelectedSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.TypeOfService);
-    }
-    /** Returns selected subject-matter-domain claim values. */
-    getSelectedSubjectMatterDomains() {
-        return this.getSelectedSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.SubjectMatterDomain);
-    }
-    /** Returns selected resource-type claim values. */
-    getSelectedResourceTypes() {
-        return splitCsv(this.getActiveEntryClaim(ClaimConsent.resourceType));
-    }
-    /** Replaces selected core-section claim values while preserving other families. */
-    setSelectedCoreSections(codes) {
-        return this.setSelectedSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.CoreSection, codes);
-    }
-    /** Replaces selected kind-of-document claim values. */
-    setSelectedKindOfDocuments(codes) {
-        return this.setActiveEntryClaimList(ClaimConsent.category, codes);
-    }
-    /** Replaces selected type-of-service claim values while preserving other families. */
-    setSelectedTypeOfServices(codes) {
-        return this.setSelectedSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.TypeOfService, codes);
-    }
-    /** Replaces selected subject-matter-domain claim values while preserving other families. */
-    setSelectedSubjectMatterDomains(codes) {
-        return this.setSelectedSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.SubjectMatterDomain, codes);
-    }
-    /** Replaces selected resource-type claim values. */
-    setSelectedResourceTypes(codes) {
-        return this.setActiveEntryClaimList(ClaimConsent.resourceType, codes);
-    }
-    /** Adds core-section claim values without removing other selected targets. */
-    addCoreSections(codes) {
-        return this.addSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.CoreSection, codes);
-    }
-    /** Removes selected core-section claim values. */
-    removeCoreSections(codes) {
-        return this.removeSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.CoreSection, codes);
-    }
-    /** Adds kind-of-document claim values. */
-    addKindOfDocuments(codes) {
-        return this.addActiveEntryClaimList(ClaimConsent.category, codes);
-    }
-    /** Removes kind-of-document claim values. */
-    removeKindOfDocuments(codes) {
-        return this.removeActiveEntryClaimList(ClaimConsent.category, codes);
-    }
-    /** Adds type-of-service claim values without removing other selected targets. */
-    addTypeOfServices(codes) {
-        return this.addSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.TypeOfService, codes);
-    }
-    /** Removes selected type-of-service claim values. */
-    removeTypeOfServices(codes) {
-        return this.removeSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.TypeOfService, codes);
-    }
-    /** Adds subject-matter-domain claim values without removing other selected targets. */
-    addSubjectMatterDomains(codes) {
-        return this.addSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.SubjectMatterDomain, codes);
-    }
-    /** Removes selected subject-matter-domain claim values. */
-    removeSubjectMatterDomains(codes) {
-        return this.removeSectionCodesByFamily(ClaimConsent.action, HealthcareCanonicalSectionFamilies.SubjectMatterDomain, codes);
-    }
-    /** Adds resource-type claim values. */
-    addResourceTypes(codes) {
-        return this.addActiveEntryClaimList(ClaimConsent.resourceType, codes);
-    }
-    /** Removes resource-type claim values. */
-    removeResourceTypes(codes) {
-        return this.removeActiveEntryClaimList(ClaimConsent.resourceType, codes);
-    }
-    /** Returns purposes as explicit classified items. */
-    getPurposesClassified() {
-        return this.getSelectedPurposes().map((code) => ({
-            code,
-            display: resolveConsentPurposeDisplay(code),
-        }));
-    }
-    /** Returns selected purpose claim values. */
-    getSelectedPurposes() {
-        return splitCsv(this.getActiveEntryClaim(ClaimConsent.purpose));
-    }
-    /** Replaces selected purpose claim values. */
-    setSelectedPurposes(codes) {
-        return this.setActiveEntryClaimList(ClaimConsent.purpose, codes);
-    }
-    /** Adds purpose claim values. */
-    addPurposes(codes) {
-        return this.addActiveEntryClaimList(ClaimConsent.purpose, codes);
-    }
-    /** Removes purpose claim values. */
-    removePurposes(codes) {
-        return this.removeActiveEntryClaimList(ClaimConsent.purpose, codes);
-    }
-    /** Returns selected actor roles as explicit classified items. */
-    getRolesClassified() {
-        const classified = {
-            professional: [],
-            relationship: [],
-            legalRepresentative: [],
-            other: [],
-        };
-        for (const roleToken of this.getSelectedRoles()) {
-            const role = getHealthcareRoleByClaim(roleToken);
-            if (!role) {
-                classified.other.push({
-                    codingSystem: '',
-                    code: roleToken,
-                    display: roleToken,
-                });
-                continue;
-            }
-            const nextRole = {
-                family: role.family,
-                codingSystem: role.codingSystem,
-                code: role.code,
-                display: role.titleEn,
-                definition: role.definition,
-            };
-            if (role.family === HealthcareRoleFamilies.ProfessionalOccupationIsco08) {
-                classified.professional.push(nextRole);
-            }
-            else if (role.family === HealthcareRoleFamilies.PersonalRelationshipHl7) {
-                classified.relationship.push(nextRole);
-            }
-            else if (role.family === HealthcareRoleFamilies.LegalRepresentativeHl7) {
-                classified.legalRepresentative.push(nextRole);
-            }
-            else {
-                classified.other.push(nextRole);
-            }
-        }
-        return classified;
-    }
-    /** Returns selected actor-role claim values. */
-    getSelectedRoles() {
-        return splitCsv(this.getActiveEntryClaim(ClaimConsent.actorRole));
-    }
-    /** Replaces selected actor-role claim values. */
-    setSelectedRoles(codes) {
-        return this.setActiveEntryClaimList(ClaimConsent.actorRole, codes);
-    }
-    /** Adds actor-role claim values. */
-    addRoles(codes) {
-        return this.addActiveEntryClaimList(ClaimConsent.actorRole, codes);
-    }
-    /** Removes actor-role claim values. */
-    removeRoles(codes) {
-        return this.removeActiveEntryClaimList(ClaimConsent.actorRole, codes);
-    }
-    /** Returns consent actors grouped by jurisdiction, organization, and user. */
-    getActorsClassified() {
-        const claims = {
-            ...(this.getActiveEntry()?.resource?.meta?.claims || {}),
-        };
-        const actorTokens = splitCsv(claims[ClaimConsent.actorIdentifier]);
-        const actorRole = parseConsentActorRole(splitCsv(claims[ClaimConsent.actorRole])[0] || '');
-        const jurisdictions = new Map();
-        const organizations = new Map();
-        const users = new Map();
-        for (const token of actorTokens) {
-            if (looksLikeJurisdictionToken(token)) {
-                jurisdictions.set(token, { code: token, display: token });
-                continue;
-            }
-            if (looksLikeEmailToken(token)) {
-                users.set(`email:${token}`, {
-                    email: token,
-                    ...(actorRole ? { role: actorRole } : {}),
-                });
-                continue;
-            }
-            if (looksLikePhoneToken(token)) {
-                users.set(`phone:${token}`, {
-                    phone: token,
-                    ...(actorRole ? { role: actorRole } : {}),
-                });
-                continue;
-            }
-            const organization = parseDidWebOrganizationToken(token);
-            if (organization) {
-                organizations.set(organization.domain, organization);
-            }
-        }
-        return {
-            jurisdictions: Array.from(jurisdictions.values()),
-            organizations: Array.from(organizations.values()),
-            users: Array.from(users.values()),
-        };
-    }
-    getSelectedSectionCodesByFamily(claimKey, family) {
-        return splitCsv(this.getActiveEntryClaim(claimKey))
-            .filter((code) => getHealthcareSectionFamilyByCode(code) === family);
-    }
-    setSelectedSectionCodesByFamily(claimKey, family, codes) {
-        const preserved = splitCsv(this.getActiveEntryClaim(claimKey))
-            .filter((code) => getHealthcareSectionFamilyByCode(code) !== family);
-        return this.setActiveEntryClaimList(claimKey, [...preserved, ...codes]);
-    }
-    addSectionCodesByFamily(claimKey, family, codes) {
-        const next = [...this.getSelectedSectionCodesByFamily(claimKey, family), ...codes];
-        return this.setSelectedSectionCodesByFamily(claimKey, family, next);
-    }
-    removeSectionCodesByFamily(claimKey, family, codes) {
-        const codesToRemove = new Set(normalizeCsvValues(codes));
-        const next = this.getSelectedSectionCodesByFamily(claimKey, family)
-            .filter((code) => !codesToRemove.has(code));
-        return this.setSelectedSectionCodesByFamily(claimKey, family, next);
-    }
-    setActiveEntryClaimList(key, values) {
-        const normalized = normalizeCsvValues(values);
-        if (normalized.length === 0) {
-            return this.removeActiveEntryClaim(key);
-        }
-        return this.setActiveEntryClaim(key, normalized.join(CSV_SEPARATOR));
-    }
-    addActiveEntryClaimList(key, values) {
-        const next = normalizeCsvValues([
-            ...splitCsv(this.getActiveEntryClaim(key)),
-            ...values,
-        ]);
-        return this.setActiveEntryClaimList(key, next);
-    }
-    removeActiveEntryClaimList(key, values) {
-        const valuesToRemove = new Set(normalizeCsvValues(values));
-        const next = splitCsv(this.getActiveEntryClaim(key))
-            .filter((value) => !valuesToRemove.has(value));
-        return this.setActiveEntryClaimList(key, next);
-    }
-}
-/**
- * High-level factory for consent-access editing.
- *
- * Prefer this name in onboarding docs when the developer intent is:
- * "edit a Consent access bundle carried by a Communication".
- */
-export function createConsentAccessEditor(options = {}) {
-    return new ConsentAccessEditor(options);
-}
-function ensureEntryResource(entry, mode) {
-    const resource = entry.resource;
-    if (resource && typeof resource === 'object') {
-        return resource;
-    }
-    if (mode === 'normalize') {
-        return { meta: { claims: {} } };
-    }
-    throw new Error('Active entry does not contain a valid resource object.');
-}
-function validateBundleLike(bundle, mode) {
-    const looksLikeBundle = bundle && bundle.resourceType === ResourceTypesFhirR4.Bundle && Array.isArray(bundle.data);
-    if (looksLikeBundle) {
-        return;
-    }
-    if (mode === 'normalize') {
-        return;
-    }
-    throw new Error('Decoded attachment is not a valid BundleJsonApi payload.');
-}
-function createEmptyBundle() {
-    return {
-        resourceType: ResourceTypesFhirR4.Bundle,
-        type: 'batch',
-        data: [],
-    };
-}
-function encodeBundleToBase64(bundle) {
-    return Buffer.from(JSON.stringify(bundle), 'utf8').toString('base64');
-}
-function cloneBundle(bundle) {
-    return JSON.parse(JSON.stringify(bundle));
-}
-function cloneEntry(entry) {
-    return JSON.parse(JSON.stringify(entry));
-}
-function cloneUnknownValue(value) {
-    if (value === undefined) {
-        return value;
-    }
-    return JSON.parse(JSON.stringify(value));
-}
-function asTrimmedString(value) {
-    if (value === undefined || value === null) {
-        return '';
-    }
-    return String(value).trim();
-}
-function resolveContainedDocumentsClaimKey(resourceType) {
-    if (resourceType === ResourceTypesFhirR4.Consent) {
-        return ClaimConsent.containedDocuments;
-    }
-    if (resourceType === ResourceTypesFhirR4.MedicationStatement) {
-        return MedicationStatementClaim.ContainedDocuments;
-    }
-    if (resourceType === ResourceTypesFhirR4.Condition) {
-        return ConditionClaim.ContainedDocuments;
-    }
-    if (resourceType === ResourceTypesFhirR4.AllergyIntolerance) {
-        return AllergyIntoleranceClaim.ContainedDocuments;
-    }
-    return '';
-}
-function resolveSubjectFromClaims(claims) {
-    return asTrimmedString(claims[ClaimConsent.subject]
-        || claims[MedicationStatementClaim.Subject]
-        || claims[ConditionClaim.Subject]
-        || claims[AllergyIntoleranceClaim.Subject]
-        || claims[AllergyIntoleranceClaim.Patient]
-        || claims[DocumentReferenceClaim.Subject]);
-}
-function setIfMissing(target, key, value) {
-    if (target[key] !== undefined) {
-        return;
-    }
-    if (value === undefined || value === null || String(value).trim() === '') {
-        return;
-    }
-    target[key] = value;
-}
-function runtimeUuid(prefix) {
-    const cryptoLike = globalThis;
-    if (typeof cryptoLike.crypto?.randomUUID === 'function') {
-        return cryptoLike.crypto.randomUUID();
-    }
-    return `${prefix}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
-}
-const CSV_SEPARATOR = ',';
-const DID_WEB_PREFIX = 'did:web:';
-const PHONE_PREFIX = 'tel:';
-function splitCsv(value) {
-    return normalizeCsvValues(String(value || '').split(CSV_SEPARATOR));
-}
-function normalizeCsvValues(values) {
-    return Array.from(new Set(values
-        .map((item) => String(item || '').trim())
-        .filter(Boolean)));
-}
-function buildClassifiedConsentTarget(kind, code, scopeCodes, sectionFamily) {
-    const normalizedCode = String(code || '').trim();
-    return {
-        target: {
-            kind,
-            code: normalizedCode,
-            display: resolveConsentTargetDisplay(kind, normalizedCode),
-            ...(kind === ConsentEditorTargetKinds.Section
-                ? { sectionFamily: sectionFamily || getHealthcareSectionFamilyByCode(normalizedCode) }
-                : {}),
-        },
-        scopes: normalizeScopeCodes(scopeCodes).map((scopeCode) => ({
-            code: scopeCode,
-            display: resolveConsentScopeDisplay(scopeCode),
-        })),
-    };
-}
-function buildSectionCatalogOptions(family) {
-    return Object.values(getHealthcareSectionsByFamily(family)).map((descriptor) => buildClassifiedConsentTarget(ConsentEditorTargetKinds.Section, descriptor.attributeValue, [ConsentEditorScopeCodes.Read]));
-}
-function normalizeScopeCodes(scopeCodes) {
-    const values = Array.from(new Set(scopeCodes.map((scopeCode) => String(scopeCode).trim()).filter(Boolean)));
-    return values.filter((scopeCode) => Object.values(ConsentEditorScopeCodes).includes(scopeCode));
-}
-function normalizeClassifiedTargets(targets) {
-    const result = new Map();
-    for (const target of targets) {
-        const normalized = buildClassifiedConsentTarget(target.target.kind, String(target.target.code || '').trim(), target.scopes.map((scope) => scope.code), target.target.sectionFamily);
-        const key = `${normalized.target.kind}:${normalized.target.code}`;
-        result.set(key, normalized);
-    }
-    return Array.from(result.values());
-}
-function resolveConsentTargetDisplay(kind, code) {
-    if (kind === ConsentEditorTargetKinds.ResourceType) {
-        return code;
-    }
-    if (kind === ConsentEditorTargetKinds.Section) {
-        const loincCode = code.includes('|') ? code.split('|').slice(-1)[0] : code;
-        return getHealthcareSectionByCode(loincCode)?.titleEn;
-    }
-    return undefined;
-}
-function resolveConsentScopeDisplay(scopeCode) {
-    if (scopeCode === ConsentEditorScopeCodes.Search)
-        return 'search';
-    if (scopeCode === ConsentEditorScopeCodes.Read)
-        return 'read';
-    if (scopeCode === ConsentEditorScopeCodes.Create)
-        return 'create';
-    if (scopeCode === ConsentEditorScopeCodes.Update)
-        return 'update';
-    return 'delete';
-}
-function resolveConsentPurposeDisplay(code) {
-    const normalized = String(code || '').trim();
-    if (normalized === HealthcareConsentPurposes.Treatment) {
-        return 'Treatment';
-    }
-    if (normalized === HealthcareConsentPurposes.EmergencyTreatment) {
-        return 'Emergency treatment';
-    }
-    if (normalized === HealthcareConsentPurposes.CareManagement) {
-        return 'Care management';
-    }
-    if (normalized === HealthcareConsentPurposes.Operations) {
-        return 'Operations';
-    }
-    if (normalized === HealthcareConsentPurposes.PatientAdministration) {
-        return 'Patient administration';
-    }
-    if (normalized === HealthcareConsentPurposes.RecordsManagement) {
-        return 'Records management';
-    }
-    return normalized;
-}
-function looksLikeEmailToken(value) {
-    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(String(value || '').trim().toLowerCase());
-}
-function looksLikePhoneToken(value) {
-    return String(value || '').trim().startsWith(PHONE_PREFIX);
-}
-function looksLikeJurisdictionToken(value) {
-    return /^[A-Z]{2}([\-:][A-Z0-9]+)?$/.test(String(value || '').trim());
-}
-function parseDidWebOrganizationToken(value) {
-    const normalized = String(value || '').trim();
-    if (!normalized.startsWith(DID_WEB_PREFIX)) {
-        return undefined;
-    }
-    const segments = normalized.slice(DID_WEB_PREFIX.length).split(':').filter(Boolean);
-    if (segments.length === 0) {
-        return undefined;
-    }
-    const [domain, ...departmentSegments] = segments;
-    return {
-        domain,
-        display: domain,
-        departments: departmentSegments.map((segment) => ({
-            code: segment,
-            display: segment,
-        })),
-        locations: [],
-    };
-}
-function parseConsentActorRole(value) {
-    const normalized = String(value || '').trim();
-    if (!normalized) {
-        return undefined;
-    }
-    const healthcareRole = getHealthcareRoleByClaim(normalized);
-    if (healthcareRole) {
-        return {
-            codingSystem: healthcareRole.codingSystem,
-            code: healthcareRole.code,
-            display: healthcareRole.titleEn,
-        };
-    }
-    const separatorIndex = normalized.indexOf('|');
-    if (separatorIndex < 0) {
-        return {
-            codingSystem: '',
-            code: normalized,
-            display: normalized,
-        };
-    }
-    return {
-        codingSystem: normalized.slice(0, separatorIndex),
-        code: normalized.slice(separatorIndex + 1),
-        display: normalized,
-    };
-}
-function flattenClassifiedActors(classifiedActors) {
-    return normalizeCsvValues([
-        ...classifiedActors.jurisdictions.map((jurisdiction) => jurisdiction.code),
-        ...classifiedActors.organizations.map(serializeClassifiedOrganization),
-        ...classifiedActors.users.flatMap((user) => [user.email, user.phone]),
-    ]);
-}
-function serializeClassifiedOrganization(organization) {
-    const domain = String(organization.domain || '').trim();
-    const departments = organization.departments
-        .map((department) => String(department.code || '').trim())
-        .filter(Boolean);
-    return [DID_WEB_PREFIX.replace(/:$/, ''), domain, ...departments].join(':');
-}
-function flattenClassifiedRoles(classifiedRoles) {
-    return normalizeCsvValues([
-        ...classifiedRoles.professional.map(serializeClassifiedRole),
-        ...classifiedRoles.relationship.map(serializeClassifiedRole),
-        ...classifiedRoles.legalRepresentative.map(serializeClassifiedRole),
-        ...classifiedRoles.other.map(serializeClassifiedRole),
-    ]);
-}
-function serializeClassifiedRole(role) {
-    const descriptor = getHealthcareRoleByClaim(`${String(role.codingSystem || '').trim()}|${String(role.code || '').trim()}`);
-    if (descriptor) {
-        return descriptor.claim;
-    }
-    return String(role.code || '').trim() || String(role.display || '').trim();
-}
-function flattenClassifiedTargets(classifiedTargets) {
-    const coreSections = [];
-    const kindOfDocuments = [];
-    const typeOfServices = [];
-    const subjectMatterDomains = [];
-    const resourceTypes = [];
-    for (const entry of normalizeClassifiedTargets(classifiedTargets)) {
-        if (entry.target.kind === ConsentEditorTargetKinds.ResourceType) {
-            resourceTypes.push(entry.target.code);
-            continue;
-        }
-        const family = entry.target.sectionFamily || getHealthcareSectionFamilyByCode(entry.target.code);
-        if (family === HealthcareCanonicalSectionFamilies.KindOfDocument) {
-            kindOfDocuments.push(entry.target.code);
-            continue;
-        }
-        if (family === HealthcareCanonicalSectionFamilies.TypeOfService) {
-            typeOfServices.push(entry.target.code);
-            continue;
-        }
-        if (family === HealthcareCanonicalSectionFamilies.SubjectMatterDomain) {
-            subjectMatterDomains.push(entry.target.code);
-            continue;
-        }
-        coreSections.push(entry.target.code);
-    }
-    return {
-        coreSections: normalizeCsvValues(coreSections),
-        kindOfDocuments: normalizeCsvValues(kindOfDocuments),
-        typeOfServices: normalizeCsvValues(typeOfServices),
-        subjectMatterDomains: normalizeCsvValues(subjectMatterDomains),
-        resourceTypes: normalizeCsvValues(resourceTypes),
-    };
-}