gdc-common-utils-ts 2.0.15 → 2.0.17

package/dist/constants/data-collections.js

@@ -0,0 +1,76 @@
+import { ResourceTypesFhirR4 } from './fhir-resource-types.js';
+import { HealthcareSummarySections } from './healthcare.js';
+/**
+ * Reusable logical collection ids for normalized healthcare persistence and
+ * indexing layers.
+ *
+ * They are intentionally domain-level names, not backend-specific table names,
+ * so gateways, SDK tooling, and other runtimes can share one stable taxonomy
+ * when mapping IPS sections or FHIR resource families to indexed collections.
+ */
+export const DataCollectionIds = Object.freeze({
+    adverseEvents: 'adverse-events',
+    allergies: 'allergies',
+    carePlans: 'care-plans',
+    communications: 'communications',
+    composition: 'composition',
+    conditions: 'conditions',
+    consents: 'consents',
+    diagnosticReports: 'diagnostic-reports',
+    documentReferences: 'document-references',
+    encounters: 'encounters',
+    imagingStudies: 'imaging-studies',
+    immunizations: 'immunizations',
+    medications: 'medications',
+    observations: 'observations',
+    procedures: 'procedures',
+    relatedPersons: 'related-persons',
+});
+/**
+ * Canonical IPS summary section -> collection mapping.
+ *
+ * Public search contracts should stay section-first. Internals can then fan
+ * out to the collections declared here without making callers pick one
+ * concrete `resourceType`.
+ */
+export const HealthcareSummarySectionDataCollections = Object.freeze({
+    [HealthcareSummarySections.HistoryOfMedicationUse.attributeValue]: Object.freeze([DataCollectionIds.medications]),
+    [HealthcareSummarySections.AllergiesAndIntolerances.attributeValue]: Object.freeze([DataCollectionIds.allergies]),
+    [HealthcareSummarySections.ProblemList.attributeValue]: Object.freeze([DataCollectionIds.conditions]),
+    [HealthcareSummarySections.Results.attributeValue]: Object.freeze([
+        DataCollectionIds.observations,
+        DataCollectionIds.diagnosticReports,
+    ]),
+    [HealthcareSummarySections.Procedures.attributeValue]: Object.freeze([DataCollectionIds.procedures]),
+    [HealthcareSummarySections.Immunizations.attributeValue]: Object.freeze([DataCollectionIds.immunizations]),
+    [HealthcareSummarySections.FunctionalStatus.attributeValue]: Object.freeze([DataCollectionIds.conditions]),
+    [HealthcareSummarySections.PlanOfCare.attributeValue]: Object.freeze([DataCollectionIds.carePlans]),
+    [HealthcareSummarySections.PlanOfTreatment.attributeValue]: Object.freeze([DataCollectionIds.carePlans]),
+    [HealthcareSummarySections.SocialHistory.attributeValue]: Object.freeze([DataCollectionIds.observations]),
+    [HealthcareSummarySections.VitalSigns.attributeValue]: Object.freeze([DataCollectionIds.observations]),
+    [HealthcareSummarySections.AdvanceDirectives.attributeValue]: Object.freeze([DataCollectionIds.consents]),
+    [HealthcareSummarySections.HistoryOfPastIllness.attributeValue]: Object.freeze([DataCollectionIds.conditions]),
+    [HealthcareSummarySections.PregnancyHistory.attributeValue]: Object.freeze([DataCollectionIds.observations]),
+    [HealthcareSummarySections.GoalsAndPreferences.attributeValue]: Object.freeze([DataCollectionIds.consents]),
+    [HealthcareSummarySections.Alert.attributeValue]: Object.freeze([]),
+    [HealthcareSummarySections.MedicalDevices.attributeValue]: Object.freeze([]),
+});
+/**
+ * Canonical FHIR R4 resource family -> collection mapping for normalized
+ * storage/index adapters.
+ */
+export const FhirResourceTypeDataCollections = Object.freeze({
+    [ResourceTypesFhirR4.AdverseEvent]: DataCollectionIds.adverseEvents,
+    [ResourceTypesFhirR4.AllergyIntolerance]: DataCollectionIds.allergies,
+    [ResourceTypesFhirR4.CarePlan]: DataCollectionIds.carePlans,
+    [ResourceTypesFhirR4.Condition]: DataCollectionIds.conditions,
+    [ResourceTypesFhirR4.Consent]: DataCollectionIds.consents,
+    [ResourceTypesFhirR4.DiagnosticReport]: DataCollectionIds.diagnosticReports,
+    [ResourceTypesFhirR4.Encounter]: DataCollectionIds.encounters,
+    [ResourceTypesFhirR4.ImagingStudy]: DataCollectionIds.imagingStudies,
+    [ResourceTypesFhirR4.Immunization]: DataCollectionIds.immunizations,
+    [ResourceTypesFhirR4.MedicationStatement]: DataCollectionIds.medications,
+    [ResourceTypesFhirR4.Observation]: DataCollectionIds.observations,
+    [ResourceTypesFhirR4.Procedure]: DataCollectionIds.procedures,
+    [ResourceTypesFhirR4.RelatedPerson]: DataCollectionIds.relatedPersons,
+});

package/dist/constants/healthcare.d.ts

@@ -93,6 +93,19 @@ export declare const HealthcareCoreSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    Alert: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     DietAndNutrition: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
@@ -171,6 +184,19 @@ export declare const HealthcareCoreSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    PregnancyHistory: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     ProblemList: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
@@ -262,6 +288,19 @@ export declare const HealthcareCoreSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    GoalsAndPreferences: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     PlanOfTreatment: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
@@ -370,6 +409,19 @@ export declare const HealthcareBasicSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    Alert: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     DietAndNutrition: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
@@ -448,6 +500,19 @@ export declare const HealthcareBasicSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    PregnancyHistory: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     ProblemList: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
@@ -539,6 +604,19 @@ export declare const HealthcareBasicSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    GoalsAndPreferences: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     PlanOfTreatment: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
@@ -619,6 +697,254 @@ export declare const HealthcareBasicSections: Readonly<{
         titleEn?: string;
     }>;
 }>;
+/**
+ * IPS summary-oriented subset aligned with the official HL7 IPS all-sections
+ * example and intended for "full patient summary / digital twin" flows.
+ *
+ * It excludes the broader core sections that are outside that summary example:
+ * - Diet and Nutrition
+ * - History of Family Member Diseases
+ * - History of Hospitalizations and Outpatient Visits
+ * - History of Present Illness
+ * - Problem List Narrative Reported
+ * - Instructions
+ */
+export declare const HealthcareSummarySections: Readonly<{
+    readonly PatientSummaryDocument: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly AllergiesAndIntolerances: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly HistoryOfMedicationUse: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly ProblemList: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly Results: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly Procedures: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly Immunizations: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly MedicalDevices: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly VitalSigns: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly SocialHistory: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly Alert: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly GoalsAndPreferences: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly AdvanceDirectives: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly FunctionalStatus: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly HistoryOfPastIllness: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly PregnancyHistory: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly PlanOfCare: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+    readonly PlanOfTreatment: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
+}>;
 export declare const HealthcareDocumentTypes: Readonly<{
     readonly IPS: Readonly<{
         id: string;
@@ -816,6 +1142,19 @@ export declare const HealthcareAllSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    Alert: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     DietAndNutrition: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
@@ -894,6 +1233,19 @@ export declare const HealthcareAllSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    PregnancyHistory: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     ProblemList: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
@@ -985,6 +1337,19 @@ export declare const HealthcareAllSections: Readonly<{
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
     }>;
+    GoalsAndPreferences: Readonly<{
+        system: typeof LOINC_SYSTEM_URL;
+        code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
+        claim: string;
+        i18nKey: `org.loinc.${string}`;
+        titleEn?: string;
+    }>;
     PlanOfTreatment: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;

package/dist/constants/healthcare.js

@@ -66,12 +66,14 @@ function buildWorkbookSectionCatalog(codes) {
 export const HealthcareCoreSections = Object.freeze({
     PatientSummaryDocument: defineSection('60591-5', 'Patient summary document'),
     AllergiesAndIntolerances: defineSection('48765-2', 'Allergies and adverse reactions'),
+    Alert: defineSection('104605-1', 'Alert'),
     DietAndNutrition: defineSection('61144-2', 'Diet and nutrition'),
     HistoryOfMedicationUse: defineSection('10160-0', 'History of medication use'),
     HistoryOfFamilyMemberDiseases: defineSection('10157-6', 'History of family member diseases'),
     HistoryOfHospitalizationsAndOutpatientVisits: defineSection('46240-8', 'History of hospitalizations+History of outpatient visits'),
     HistoryOfPastIllness: defineSection('11348-0', 'History of past illness'),
     HistoryOfPresentIllness: defineSection('10164-2', 'History of present illness'),
+    PregnancyHistory: defineSection('10162-6', 'Pregnancy History'),
     ProblemList: defineSection('11450-4', 'Problem list'),
     ProblemListNarrativeReported: defineSection('57852-6', 'Problem list'),
     Results: defineSection('30954-2', 'Relevant diagnostic tests/laboratory data'),
@@ -79,6 +81,7 @@ export const HealthcareCoreSections = Object.freeze({
     Immunizations: defineSection('11369-6', 'History of immunization'),
     MedicalDevices: defineSection('46264-8', 'History of medical device use'),
     FunctionalStatus: defineSection('47420-5', 'Functional status'),
+    GoalsAndPreferences: defineSection('81338-6', 'Goals / Preferences'),
     PlanOfTreatment: defineSection('18776-5', 'Plan of treatment'),
     /** @deprecated Use `PlanOfTreatment`. */
     PlanOfCare: defineSection('18776-5', 'Plan of treatment'),
@@ -89,6 +92,38 @@ export const HealthcareCoreSections = Object.freeze({
 });
 /** @deprecated Use `HealthcareCoreSections`. */
 export const HealthcareBasicSections = HealthcareCoreSections;
+/**
+ * IPS summary-oriented subset aligned with the official HL7 IPS all-sections
+ * example and intended for "full patient summary / digital twin" flows.
+ *
+ * It excludes the broader core sections that are outside that summary example:
+ * - Diet and Nutrition
+ * - History of Family Member Diseases
+ * - History of Hospitalizations and Outpatient Visits
+ * - History of Present Illness
+ * - Problem List Narrative Reported
+ * - Instructions
+ */
+export const HealthcareSummarySections = Object.freeze({
+    PatientSummaryDocument: HealthcareCoreSections.PatientSummaryDocument,
+    AllergiesAndIntolerances: HealthcareCoreSections.AllergiesAndIntolerances,
+    HistoryOfMedicationUse: HealthcareCoreSections.HistoryOfMedicationUse,
+    ProblemList: HealthcareCoreSections.ProblemList,
+    Results: HealthcareCoreSections.Results,
+    Procedures: HealthcareCoreSections.Procedures,
+    Immunizations: HealthcareCoreSections.Immunizations,
+    MedicalDevices: HealthcareCoreSections.MedicalDevices,
+    VitalSigns: HealthcareCoreSections.VitalSigns,
+    SocialHistory: HealthcareCoreSections.SocialHistory,
+    Alert: HealthcareCoreSections.Alert,
+    GoalsAndPreferences: HealthcareCoreSections.GoalsAndPreferences,
+    AdvanceDirectives: HealthcareCoreSections.AdvanceDirectives,
+    FunctionalStatus: HealthcareCoreSections.FunctionalStatus,
+    HistoryOfPastIllness: HealthcareCoreSections.HistoryOfPastIllness,
+    PregnancyHistory: HealthcareCoreSections.PregnancyHistory,
+    PlanOfCare: HealthcareCoreSections.PlanOfCare,
+    PlanOfTreatment: HealthcareCoreSections.PlanOfTreatment,
+});
 export const HealthcareDocumentTypes = Object.freeze({
     [DocumentTypeLoincOntology.IPS]: defineDocumentType(DocumentTypeLoincOntology.IPS, '60591-5', 'International Patient Summary'),
 });

package/dist/constants/index.d.ts

@@ -2,6 +2,7 @@ export * from './actor-session';
 export * from './communication';
 export * from './clinical-statuses';
 export * from './cryptography';
+export * from './data-collections';
 export * from './data-capabilities';
 export * from './dataspace-discovery';
 export * from './dataspace-protocol';

package/dist/constants/index.js

@@ -2,6 +2,7 @@ export * from './actor-session.js';
 export * from './communication.js';
 export * from './clinical-statuses.js';
 export * from './cryptography.js';
+export * from './data-collections.js';
 export * from './data-capabilities.js';
 export * from './dataspace-discovery.js';
 export * from './dataspace-protocol.js';

package/dist/utils/bundle-reader.d.ts

@@ -29,6 +29,21 @@ export type BundleReaderResponseAnalysis = Readonly<{
         success: BundleReaderSeverityBucket;
     }>;
 }>;
+/**
+ * Returns the canonical claims view for one bundle entry array index.
+ *
+ * The helper accepts the full bundle-like object plus the entry position to
+ * inspect inside `bundle.data[]` or `bundle.entry[]`.
+ */
+export declare function getClaimsInBundleEntryAt(bundle: unknown, index: number): Record<string, unknown>;
+/**
+ * Returns the merged claims view for the first `data[]` or `entry[]` item in a
+ * bundle-like body.
+ *
+ * Use this for the common "one operation, one returned entry" flows when the
+ * caller does not want to manually navigate `body.data[0]`.
+ */
+export declare function getClaimsInFirstDataEntry(bundle: unknown): Record<string, unknown>;
 /**
  * Runtime-neutral reader for built or received FHIR-like bundles.
  *
@@ -49,6 +64,10 @@ export declare class BundleReader {
     openEntry(index: number): this;
     /** Returns the resolved identifier for one entry array index when present. */
     getEntryIdentifierByArrayIndex(index: number): string | undefined;
+    /** Returns merged claims for one entry array index. */
+    getEntryClaimsByArrayIndex(index: number): Record<string, unknown>;
+    /** Returns merged claims for the currently opened entry. */
+    getActiveEntryClaims(): Record<string, unknown>;
     /** Returns the first entry array index whose resolved identifier matches the requested value. */
     getEntryIndexByIdentifier(identifier: string): number | undefined;
     /** Returns the active entry response status when present. */

package/dist/utils/bundle-reader.js

@@ -2,6 +2,38 @@ import { getHighestIssueSeverity, isIssueSeverityCode, IssueSeverity, } from '..
 function cloneEntry(value) {
     return JSON.parse(JSON.stringify(value));
 }
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+/**
+ * Returns the canonical claims view for one bundle entry array index.
+ *
+ * The helper accepts the full bundle-like object plus the entry position to
+ * inspect inside `bundle.data[]` or `bundle.entry[]`.
+ */
+export function getClaimsInBundleEntryAt(bundle, index) {
+    const bundleRecord = asRecord(bundle);
+    const entries = Array.isArray(bundleRecord.data)
+        ? bundleRecord.data
+        : (Array.isArray(bundleRecord.entry) ? bundleRecord.entry : []);
+    if (!Number.isInteger(index) || index < 0 || index >= entries.length) {
+        return {};
+    }
+    const entryRecord = asRecord(entries[index]);
+    const resource = asRecord(entryRecord.resource);
+    const resourceMeta = asRecord(resource.meta);
+    return asRecord(resourceMeta.claims);
+}
+/**
+ * Returns the merged claims view for the first `data[]` or `entry[]` item in a
+ * bundle-like body.
+ *
+ * Use this for the common "one operation, one returned entry" flows when the
+ * caller does not want to manually navigate `body.data[0]`.
+ */
+export function getClaimsInFirstDataEntry(bundle) {
+    return getClaimsInBundleEntryAt(bundle, 0);
+}
 /**
  * Runtime-neutral reader for built or received FHIR-like bundles.
  *
@@ -48,6 +80,17 @@ export class BundleReader {
         }
         return this.resolveEntryIdentifier(entries[index]);
     }
+    /** Returns merged claims for one entry array index. */
+    getEntryClaimsByArrayIndex(index) {
+        return getClaimsInBundleEntryAt(this.bundle, index);
+    }
+    /** Returns merged claims for the currently opened entry. */
+    getActiveEntryClaims() {
+        if (this.activeEntryIndex === null) {
+            throw new Error('BundleReader does not have one active entry. Call openEntry(index) first.');
+        }
+        return this.getEntryClaimsByArrayIndex(this.activeEntryIndex);
+    }
     /** Returns the first entry array index whose resolved identifier matches the requested value. */
     getEntryIndexByIdentifier(identifier) {
         const normalizedIdentifier = normalizeOptionalString(identifier);