gdc-common-utils-ts 1.14.2 → 1.14.4

package/dist/examples/ips-bundle.js

@@ -0,0 +1,106 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { HealthcareBasicSections } from '../constants/healthcare.js';
+import { CommunicationCategoryCodes } from '../constants/communication.js';
+import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.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 { MedicationStatementClaim } from '../models/interoperable-claims/medication-statement-claims.js';
+import { EXAMPLE_COMMUNICATION_IDENTIFIER, EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF, EXAMPLE_DOCUMENT_REFERENCE_DATE, EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION, EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER, EXAMPLE_DOCUMENT_REFERENCE_URL, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER, EXAMPLE_MEDICATION_STATEMENT_STATUS, EXAMPLE_MEDICATION_STATEMENT_TEXT, EXAMPLE_SUBJECT_DID, } from './shared.js';
+import { toClinicalResourceCardViews, toClinicalResourceCommonViews, } from '../utils/clinical-resource-view.js';
+import { CommunicationBundleSession } from '../utils/communication-bundle-session.js';
+/**
+ * Builds a minimal IPS-like history bundle with common clinical resource types
+ * authored as `resource.meta.claims`.
+ */
+export function buildIpsClinicalHistoryBundleExample() {
+    const bundleEditor = new CommunicationBundleSession({
+        communicationClaims: {
+            '@context': 'org.hl7.fhir.r4',
+            [CommunicationClaim.Identifier]: EXAMPLE_COMMUNICATION_IDENTIFIER,
+            [CommunicationClaim.Subject]: EXAMPLE_SUBJECT_DID,
+            [CommunicationClaim.Category]: CommunicationCategoryCodes.Notification.claim,
+            [CommunicationClaim.Text]: EXAMPLE_IPS_BUNDLE_NOTE_TEXT,
+        },
+    });
+    bundleEditor.upsertActiveAllergyIntoleranceEntry({
+        claims: {
+            '@context': 'org.hl7.fhir.api',
+            [AllergyIntoleranceClaim.Identifier]: 'allergy-1',
+            [AllergyIntoleranceClaim.Subject]: EXAMPLE_SUBJECT_DID,
+            [AllergyIntoleranceClaim.Code]: 'http://snomed.info/sct|227493005',
+            [AllergyIntoleranceClaim.Category]: HealthcareBasicSections.AllergiesAndIntolerances.attributeValue,
+            [AllergyIntoleranceClaim.ClinicalStatus]: 'active',
+            [AllergyIntoleranceClaim.VerificationStatus]: 'confirmed',
+            [AllergyIntoleranceClaim.OnsetDateTime]: '2026-05-01T08:30:00Z',
+            [AllergyIntoleranceClaim.Recorder]: 'did:web:clinic.example.org:member:allergist-1',
+        },
+        fullUrl: 'urn:uuid:allergy-1',
+    });
+    bundleEditor.upsertActiveConditionEntry({
+        claims: {
+            '@context': 'org.hl7.fhir.api',
+            [ConditionClaim.Identifier]: 'condition-1',
+            [ConditionClaim.Subject]: EXAMPLE_SUBJECT_DID,
+            [ConditionClaim.Code]: 'http://snomed.info/sct|44054006',
+            [ConditionClaim.Category]: HealthcareBasicSections.ProblemList.attributeValue,
+            [ConditionClaim.ClinicalStatus]: 'active',
+            [ConditionClaim.VerificationStatus]: 'confirmed',
+            [ConditionClaim.OnsetDateTime]: '2026-05-03T09:00:00Z',
+            [ConditionClaim.Recorder]: 'did:web:clinic.example.org:member:physician-1',
+        },
+        fullUrl: 'urn:uuid:condition-1',
+    });
+    bundleEditor.upsertActiveMedicationStatementEntry({
+        claims: {
+            '@context': 'org.hl7.fhir.api',
+            [MedicationStatementClaim.Identifier]: EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER,
+            [MedicationStatementClaim.Subject]: EXAMPLE_SUBJECT_DID,
+            [MedicationStatementClaim.Status]: EXAMPLE_MEDICATION_STATEMENT_STATUS,
+            [MedicationStatementClaim.MedicationText]: EXAMPLE_MEDICATION_STATEMENT_TEXT,
+            [MedicationStatementClaim.Effective]: '2026-05-05',
+        },
+        fullUrl: `urn:uuid:${EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER}`,
+    });
+    bundleEditor.addContainedDocumentToActiveEntry({
+        identifier: EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER,
+        attachmentContentType: EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF,
+        attachmentUrl: EXAMPLE_DOCUMENT_REFERENCE_URL,
+        description: EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION,
+        date: EXAMPLE_DOCUMENT_REFERENCE_DATE,
+    });
+    bundleEditor.saveAndReleaseActiveEntry();
+    return {
+        communicationClaims: bundleEditor.getCommunicationClaims(),
+        bundleInMemory: bundleEditor.getBundleInMemory(),
+    };
+}
+/**
+ * Builds the bundle plus section-level ids and UI-friendly card/common views
+ * for frontend resource cards.
+ */
+export function buildIpsBundleFrontCardsExample() {
+    const { communicationClaims, bundleInMemory } = buildIpsClinicalHistoryBundleExample();
+    const bundleEditor = new CommunicationBundleSession({
+        communicationClaims,
+        initialBundle: bundleInMemory,
+    });
+    return {
+        communicationClaims,
+        bundleInMemory,
+        medicationEntryIds: bundleEditor.getResourceIds({
+            sections: [HealthcareBasicSections.HistoryOfMedicationUse.attributeValue],
+            resourceTypes: [ResourceTypesFhirR4.MedicationStatement],
+        }),
+        allergyEntryIds: bundleEditor.getResourceIds({
+            sections: [HealthcareBasicSections.AllergiesAndIntolerances.attributeValue],
+            resourceTypes: [ResourceTypesFhirR4.AllergyIntolerance],
+        }),
+        conditionEntryIds: bundleEditor.getResourceIds({
+            sections: [HealthcareBasicSections.ProblemList.attributeValue],
+            resourceTypes: [ResourceTypesFhirR4.Condition],
+        }),
+        cardViews: toClinicalResourceCardViews(bundleInMemory),
+        commonViews: toClinicalResourceCommonViews(bundleInMemory),
+    };
+}

package/dist/examples/shared.d.ts

@@ -82,6 +82,12 @@ export declare const EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER: "urn:uuid:medicati
 export declare const EXAMPLE_MEDICATION_STATEMENT_STATUS: "active";
 export declare const EXAMPLE_MEDICATION_STATEMENT_CODE: "http://www.nlm.nih.gov/research/umls/rxnorm|313782";
 export declare const EXAMPLE_MEDICATION_STATEMENT_TEXT: "atorvastatin 20 mg oral tablet";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER: "docref-example-001";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER_SECONDARY: "docref-example-002";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF: "application/pdf";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_URL: "https://example.org/prescription.pdf";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION: "Prescription PDF";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_DATE: "2026-06-12T10:00:00Z";
 export declare const EXAMPLE_EMPLOYEE_ACTIVATION_CODE: "ACT-001";
 export declare const EXAMPLE_DEVICE_CLIENT_ID: "did:web:device-001";
 export type ExampleDateRange = Readonly<{

package/dist/examples/shared.js

@@ -75,7 +75,7 @@ export const EXAMPLE_RELATED_PERSON_ROLE = 'v3-RoleCode|RESPRSN';
 export const EXAMPLE_CLINICAL_SECTION_RESULTS = 'LOINC|30954-2';
 export const EXAMPLE_CLINICAL_SECTION_PATIENT_SUMMARY = 'LOINC|60591-5';
 export const EXAMPLE_CLINICAL_SECTION_HISTORY_MEDICATION = 'LOINC|10160-0';
-export const EXAMPLE_CLINICAL_SECTION_ALLERGIES = HealthcareBasicSections.AllergiesAndIntolerances.claim;
+export const EXAMPLE_CLINICAL_SECTION_ALLERGIES = HealthcareBasicSections.AllergiesAndIntolerances.attributeValue;
 export const EXAMPLE_CLINICAL_CODE_PROBLEM = 'LOINC|11450-4';
 export const EXAMPLE_CONSENT_DATE = '2026-05-20';
 export const EXAMPLE_CONSENT_PERIOD_END = '2026-05-01T00:00:00Z';
@@ -88,6 +88,12 @@ export const EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER = 'urn:uuid:medication-stat
 export const EXAMPLE_MEDICATION_STATEMENT_STATUS = 'active';
 export const EXAMPLE_MEDICATION_STATEMENT_CODE = 'http://www.nlm.nih.gov/research/umls/rxnorm|313782';
 export const EXAMPLE_MEDICATION_STATEMENT_TEXT = 'atorvastatin 20 mg oral tablet';
+export const EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER = 'docref-example-001';
+export const EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER_SECONDARY = 'docref-example-002';
+export const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF = 'application/pdf';
+export const EXAMPLE_DOCUMENT_REFERENCE_URL = 'https://example.org/prescription.pdf';
+export const EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION = 'Prescription PDF';
+export const EXAMPLE_DOCUMENT_REFERENCE_DATE = '2026-06-12T10:00:00Z';
 export const EXAMPLE_EMPLOYEE_ACTIVATION_CODE = 'ACT-001';
 export const EXAMPLE_DEVICE_CLIENT_ID = 'did:web:device-001';
 export const EXAMPLE_CLINICAL_DATE_RANGE = {

package/dist/models/consent-rule.d.ts

@@ -14,6 +14,11 @@ export declare enum ClaimConsent {
     'verifiedDate' = "Consent.verified-date",
     'purpose' = "Consent.purpose",
     'identifier' = "Consent.identifier",
+    'containedDocuments' = "Consent.contained-documents",
+    /**
+     * @deprecated Use `containedDocuments`.
+     */
+    'attachmentContentIds' = "Consent.attachment-content-ids",
     'attachmentContentType' = "Consent.attachment-contentType",
     'attachmentData' = "Consent.attachment-data",
     'attachmentId' = "Consent.attachment-id"
@@ -116,6 +121,8 @@ export interface ConsentRule {
      * Derived from the `org.hl7.fhir.api.Consent.identifier` claim.
      */
     'Consent.identifier': string;
+    'Consent.contained-documents'?: string;
+    'Consent.attachment-content-ids'?: string;
     'Consent.attachment-contentType'?: string;
     'Consent.attachment-data'?: string;
     'Consent.attachment-id'?: string;

package/dist/models/consent-rule.js

@@ -16,6 +16,11 @@ export var ClaimConsent;
     ClaimConsent["verifiedDate"] = "Consent.verified-date";
     ClaimConsent["purpose"] = "Consent.purpose";
     ClaimConsent["identifier"] = "Consent.identifier";
+    ClaimConsent["containedDocuments"] = "Consent.contained-documents";
+    /**
+     * @deprecated Use `containedDocuments`.
+     */
+    ClaimConsent["attachmentContentIds"] = "Consent.attachment-content-ids";
     ClaimConsent["attachmentContentType"] = "Consent.attachment-contentType";
     ClaimConsent["attachmentData"] = "Consent.attachment-data";
     ClaimConsent["attachmentId"] = "Consent.attachment-id";

package/dist/models/dataspace-discovery-defaults.d.ts

@@ -1,5 +1,5 @@
 import type { DataspaceDiscoverySourceModeValue } from '../constants/dataspace-discovery';
-import type { HostingOperatorSemanticRecord } from './dataspace-discovery';
+import type { HostingOperatorSemanticRecord, PublishedProviderCatalogRecord } from './dataspace-discovery';
 /**
  * Shared host/ICA context used to select dataspace discovery defaults.
  *
@@ -29,6 +29,7 @@ export type DefaultHostingOperatorRegistration = DataspaceDiscoveryNetworkContex
     discoveryUrl?: string;
     catalogUrl?: string;
     record: HostingOperatorSemanticRecord;
+    publishedProviders?: readonly PublishedProviderCatalogRecord[];
     title?: string;
 }>;
 /**

package/dist/models/interoperable-claims/allergy-intolerance-claims.d.ts

@@ -11,11 +11,54 @@ export declare const AllergyIntoleranceClaim: {
     readonly ClinicalStatus: "AllergyIntolerance.clinical-status";
     readonly VerificationStatus: "AllergyIntolerance.verification-status";
     readonly Category: "AllergyIntolerance.category";
+    readonly ContainedDocuments: "AllergyIntolerance.contained-documents";
+    /**
+     * @deprecated Use `ContainedDocuments`.
+     */
+    readonly AttachmentContentIds: "AllergyIntolerance.attachment-content-ids";
     readonly Criticality: "AllergyIntolerance.criticality";
     readonly OnsetDateTime: "AllergyIntolerance.onset-datetime";
     readonly Recorder: "AllergyIntolerance.recorder";
 };
 export type AllergyIntoleranceClaimKey = typeof AllergyIntoleranceClaim[keyof typeof AllergyIntoleranceClaim];
+export declare enum AllergyIntoleranceClaimsFhirApi {
+    Identifier = "org.hl7.fhir.api.AllergyIntolerance.identifier",
+    Subject = "org.hl7.fhir.api.AllergyIntolerance.subject",
+    Patient = "org.hl7.fhir.api.AllergyIntolerance.patient",
+    Code = "org.hl7.fhir.api.AllergyIntolerance.code",
+    ClinicalStatus = "org.hl7.fhir.api.AllergyIntolerance.clinical-status",
+    VerificationStatus = "org.hl7.fhir.api.AllergyIntolerance.verification-status",
+    Category = "org.hl7.fhir.api.AllergyIntolerance.category",
+    Criticality = "org.hl7.fhir.api.AllergyIntolerance.criticality",
+    OnsetDateTime = "org.hl7.fhir.api.AllergyIntolerance.onset-datetime",
+    Recorder = "org.hl7.fhir.api.AllergyIntolerance.recorder"
+}
+export declare const AllergyIntoleranceSearchParamNames: {
+    readonly Identifier: "identifier";
+    readonly Subject: "subject";
+    readonly Patient: "patient";
+    readonly Code: "code";
+    readonly ClinicalStatus: "clinical-status";
+    readonly VerificationStatus: "verification-status";
+    readonly Category: "category";
+    readonly Criticality: "criticality";
+    readonly OnsetDateTime: "onset-datetime";
+    readonly Recorder: "recorder";
+};
+export type AllergyIntoleranceSearchParamName = typeof AllergyIntoleranceSearchParamNames[keyof typeof AllergyIntoleranceSearchParamNames];
+export declare const AllergyIntoleranceSearchParamToClaimKey: Record<AllergyIntoleranceSearchParamName, AllergyIntoleranceClaimsFhirApi>;
+export declare const AllergyIntoleranceClaimsFhirApiMap: {
+    "org.hl7.fhir.api.AllergyIntolerance.identifier": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.subject": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.patient": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.code": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.clinical-status": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.verification-status": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.category": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.criticality": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.onset-datetime": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.recorder": StringConstructor;
+};
 /**
  * http://hl7.org/fhir/uv/ips/ValueSet/allergies-intolerances-uv-ips
  * Snomed IPS codes for allergy and intolerance categories: food, medication, environment, biologic.

package/dist/models/interoperable-claims/allergy-intolerance-claims.js

@@ -13,10 +13,64 @@ export const AllergyIntoleranceClaim = {
     ClinicalStatus: 'AllergyIntolerance.clinical-status',
     VerificationStatus: 'AllergyIntolerance.verification-status',
     Category: 'AllergyIntolerance.category',
+    ContainedDocuments: 'AllergyIntolerance.contained-documents',
+    /**
+     * @deprecated Use `ContainedDocuments`.
+     */
+    AttachmentContentIds: 'AllergyIntolerance.attachment-content-ids',
     Criticality: 'AllergyIntolerance.criticality',
     OnsetDateTime: 'AllergyIntolerance.onset-datetime',
     Recorder: 'AllergyIntolerance.recorder',
 };
+export var AllergyIntoleranceClaimsFhirApi;
+(function (AllergyIntoleranceClaimsFhirApi) {
+    AllergyIntoleranceClaimsFhirApi["Identifier"] = "org.hl7.fhir.api.AllergyIntolerance.identifier";
+    AllergyIntoleranceClaimsFhirApi["Subject"] = "org.hl7.fhir.api.AllergyIntolerance.subject";
+    AllergyIntoleranceClaimsFhirApi["Patient"] = "org.hl7.fhir.api.AllergyIntolerance.patient";
+    AllergyIntoleranceClaimsFhirApi["Code"] = "org.hl7.fhir.api.AllergyIntolerance.code";
+    AllergyIntoleranceClaimsFhirApi["ClinicalStatus"] = "org.hl7.fhir.api.AllergyIntolerance.clinical-status";
+    AllergyIntoleranceClaimsFhirApi["VerificationStatus"] = "org.hl7.fhir.api.AllergyIntolerance.verification-status";
+    AllergyIntoleranceClaimsFhirApi["Category"] = "org.hl7.fhir.api.AllergyIntolerance.category";
+    AllergyIntoleranceClaimsFhirApi["Criticality"] = "org.hl7.fhir.api.AllergyIntolerance.criticality";
+    AllergyIntoleranceClaimsFhirApi["OnsetDateTime"] = "org.hl7.fhir.api.AllergyIntolerance.onset-datetime";
+    AllergyIntoleranceClaimsFhirApi["Recorder"] = "org.hl7.fhir.api.AllergyIntolerance.recorder";
+})(AllergyIntoleranceClaimsFhirApi || (AllergyIntoleranceClaimsFhirApi = {}));
+export const AllergyIntoleranceSearchParamNames = {
+    Identifier: 'identifier',
+    Subject: 'subject',
+    Patient: 'patient',
+    Code: 'code',
+    ClinicalStatus: 'clinical-status',
+    VerificationStatus: 'verification-status',
+    Category: 'category',
+    Criticality: 'criticality',
+    OnsetDateTime: 'onset-datetime',
+    Recorder: 'recorder',
+};
+export const AllergyIntoleranceSearchParamToClaimKey = {
+    [AllergyIntoleranceSearchParamNames.Identifier]: AllergyIntoleranceClaimsFhirApi.Identifier,
+    [AllergyIntoleranceSearchParamNames.Subject]: AllergyIntoleranceClaimsFhirApi.Subject,
+    [AllergyIntoleranceSearchParamNames.Patient]: AllergyIntoleranceClaimsFhirApi.Patient,
+    [AllergyIntoleranceSearchParamNames.Code]: AllergyIntoleranceClaimsFhirApi.Code,
+    [AllergyIntoleranceSearchParamNames.ClinicalStatus]: AllergyIntoleranceClaimsFhirApi.ClinicalStatus,
+    [AllergyIntoleranceSearchParamNames.VerificationStatus]: AllergyIntoleranceClaimsFhirApi.VerificationStatus,
+    [AllergyIntoleranceSearchParamNames.Category]: AllergyIntoleranceClaimsFhirApi.Category,
+    [AllergyIntoleranceSearchParamNames.Criticality]: AllergyIntoleranceClaimsFhirApi.Criticality,
+    [AllergyIntoleranceSearchParamNames.OnsetDateTime]: AllergyIntoleranceClaimsFhirApi.OnsetDateTime,
+    [AllergyIntoleranceSearchParamNames.Recorder]: AllergyIntoleranceClaimsFhirApi.Recorder,
+};
+export const AllergyIntoleranceClaimsFhirApiMap = {
+    [AllergyIntoleranceClaimsFhirApi.Identifier]: String,
+    [AllergyIntoleranceClaimsFhirApi.Subject]: String,
+    [AllergyIntoleranceClaimsFhirApi.Patient]: String,
+    [AllergyIntoleranceClaimsFhirApi.Code]: String,
+    [AllergyIntoleranceClaimsFhirApi.ClinicalStatus]: String,
+    [AllergyIntoleranceClaimsFhirApi.VerificationStatus]: String,
+    [AllergyIntoleranceClaimsFhirApi.Category]: String,
+    [AllergyIntoleranceClaimsFhirApi.Criticality]: String,
+    [AllergyIntoleranceClaimsFhirApi.OnsetDateTime]: String,
+    [AllergyIntoleranceClaimsFhirApi.Recorder]: String,
+};
 /**
  * http://hl7.org/fhir/uv/ips/ValueSet/allergies-intolerances-uv-ips
  * Snomed IPS codes for allergy and intolerance categories: food, medication, environment, biologic.

package/dist/models/interoperable-claims/condition-claims.d.ts

@@ -6,9 +6,49 @@ export declare const ConditionClaim: {
     readonly VerificationStatus: "Condition.verification-status";
     readonly Category: "Condition.category";
     readonly Code: "Condition.code";
+    readonly ContainedDocuments: "Condition.contained-documents";
+    /**
+     * @deprecated Use `ContainedDocuments`.
+     */
+    readonly AttachmentContentIds: "Condition.attachment-content-ids";
     readonly Severity: "Condition.severity";
     readonly OnsetDateTime: "Condition.onset-datetime";
     readonly Recorder: "Condition.recorder";
 };
 export type ConditionClaimKey = typeof ConditionClaim[keyof typeof ConditionClaim];
+export declare enum ConditionClaimsFhirApi {
+    Identifier = "org.hl7.fhir.api.Condition.identifier",
+    Subject = "org.hl7.fhir.api.Condition.subject",
+    ClinicalStatus = "org.hl7.fhir.api.Condition.clinical-status",
+    VerificationStatus = "org.hl7.fhir.api.Condition.verification-status",
+    Category = "org.hl7.fhir.api.Condition.category",
+    Code = "org.hl7.fhir.api.Condition.code",
+    Severity = "org.hl7.fhir.api.Condition.severity",
+    OnsetDateTime = "org.hl7.fhir.api.Condition.onset-datetime",
+    Recorder = "org.hl7.fhir.api.Condition.recorder"
+}
+export declare const ConditionSearchParamNames: {
+    readonly Identifier: "identifier";
+    readonly Subject: "subject";
+    readonly ClinicalStatus: "clinical-status";
+    readonly VerificationStatus: "verification-status";
+    readonly Category: "category";
+    readonly Code: "code";
+    readonly Severity: "severity";
+    readonly OnsetDateTime: "onset-datetime";
+    readonly Recorder: "recorder";
+};
+export type ConditionSearchParamName = typeof ConditionSearchParamNames[keyof typeof ConditionSearchParamNames];
+export declare const ConditionSearchParamToClaimKey: Record<ConditionSearchParamName, ConditionClaimsFhirApi>;
+export declare const ConditionClaimsFhirApiMap: {
+    "org.hl7.fhir.api.Condition.identifier": StringConstructor;
+    "org.hl7.fhir.api.Condition.subject": StringConstructor;
+    "org.hl7.fhir.api.Condition.clinical-status": StringConstructor;
+    "org.hl7.fhir.api.Condition.verification-status": StringConstructor;
+    "org.hl7.fhir.api.Condition.category": StringConstructor;
+    "org.hl7.fhir.api.Condition.code": StringConstructor;
+    "org.hl7.fhir.api.Condition.severity": StringConstructor;
+    "org.hl7.fhir.api.Condition.onset-datetime": StringConstructor;
+    "org.hl7.fhir.api.Condition.recorder": StringConstructor;
+};
 export declare const ConditionClaimSpecs: ClaimSpec[];

package/dist/models/interoperable-claims/condition-claims.js

@@ -8,10 +8,60 @@ export const ConditionClaim = {
     VerificationStatus: 'Condition.verification-status',
     Category: 'Condition.category',
     Code: 'Condition.code',
+    ContainedDocuments: 'Condition.contained-documents',
+    /**
+     * @deprecated Use `ContainedDocuments`.
+     */
+    AttachmentContentIds: 'Condition.attachment-content-ids',
     Severity: 'Condition.severity',
     OnsetDateTime: 'Condition.onset-datetime',
     Recorder: 'Condition.recorder',
 };
+export var ConditionClaimsFhirApi;
+(function (ConditionClaimsFhirApi) {
+    ConditionClaimsFhirApi["Identifier"] = "org.hl7.fhir.api.Condition.identifier";
+    ConditionClaimsFhirApi["Subject"] = "org.hl7.fhir.api.Condition.subject";
+    ConditionClaimsFhirApi["ClinicalStatus"] = "org.hl7.fhir.api.Condition.clinical-status";
+    ConditionClaimsFhirApi["VerificationStatus"] = "org.hl7.fhir.api.Condition.verification-status";
+    ConditionClaimsFhirApi["Category"] = "org.hl7.fhir.api.Condition.category";
+    ConditionClaimsFhirApi["Code"] = "org.hl7.fhir.api.Condition.code";
+    ConditionClaimsFhirApi["Severity"] = "org.hl7.fhir.api.Condition.severity";
+    ConditionClaimsFhirApi["OnsetDateTime"] = "org.hl7.fhir.api.Condition.onset-datetime";
+    ConditionClaimsFhirApi["Recorder"] = "org.hl7.fhir.api.Condition.recorder";
+})(ConditionClaimsFhirApi || (ConditionClaimsFhirApi = {}));
+export const ConditionSearchParamNames = {
+    Identifier: 'identifier',
+    Subject: 'subject',
+    ClinicalStatus: 'clinical-status',
+    VerificationStatus: 'verification-status',
+    Category: 'category',
+    Code: 'code',
+    Severity: 'severity',
+    OnsetDateTime: 'onset-datetime',
+    Recorder: 'recorder',
+};
+export const ConditionSearchParamToClaimKey = {
+    [ConditionSearchParamNames.Identifier]: ConditionClaimsFhirApi.Identifier,
+    [ConditionSearchParamNames.Subject]: ConditionClaimsFhirApi.Subject,
+    [ConditionSearchParamNames.ClinicalStatus]: ConditionClaimsFhirApi.ClinicalStatus,
+    [ConditionSearchParamNames.VerificationStatus]: ConditionClaimsFhirApi.VerificationStatus,
+    [ConditionSearchParamNames.Category]: ConditionClaimsFhirApi.Category,
+    [ConditionSearchParamNames.Code]: ConditionClaimsFhirApi.Code,
+    [ConditionSearchParamNames.Severity]: ConditionClaimsFhirApi.Severity,
+    [ConditionSearchParamNames.OnsetDateTime]: ConditionClaimsFhirApi.OnsetDateTime,
+    [ConditionSearchParamNames.Recorder]: ConditionClaimsFhirApi.Recorder,
+};
+export const ConditionClaimsFhirApiMap = {
+    [ConditionClaimsFhirApi.Identifier]: String,
+    [ConditionClaimsFhirApi.Subject]: String,
+    [ConditionClaimsFhirApi.ClinicalStatus]: String,
+    [ConditionClaimsFhirApi.VerificationStatus]: String,
+    [ConditionClaimsFhirApi.Category]: String,
+    [ConditionClaimsFhirApi.Code]: String,
+    [ConditionClaimsFhirApi.Severity]: String,
+    [ConditionClaimsFhirApi.OnsetDateTime]: String,
+    [ConditionClaimsFhirApi.Recorder]: String,
+};
 export const ConditionClaimSpecs = [
     { key: ConditionClaim.Identifier, meaning: 'Business identifier for condition record.', example: 'COND-0001' },
     { key: ConditionClaim.Subject, meaning: 'Patient subject reference.', example: 'Patient/pat-123' },

package/dist/models/interoperable-claims/diagnostic-report-claims.d.ts

@@ -0,0 +1,96 @@
+import type { ClaimSpec } from './types';
+export declare const DiagnosticReportClaim: {
+    readonly BasedOn: "DiagnosticReport.based-on";
+    readonly Category: "DiagnosticReport.category";
+    readonly Code: "DiagnosticReport.code";
+    readonly Date: "DiagnosticReport.date";
+    readonly Encounter: "DiagnosticReport.encounter";
+    readonly Identifier: "DiagnosticReport.identifier";
+    readonly Media: "DiagnosticReport.media";
+    readonly Patient: "DiagnosticReport.patient";
+    readonly Performer: "DiagnosticReport.performer";
+    readonly Result: "DiagnosticReport.result";
+    readonly ResultsInterpreter: "DiagnosticReport.results-interpreter";
+    readonly Specimen: "DiagnosticReport.specimen";
+    readonly Status: "DiagnosticReport.status";
+    readonly Subject: "DiagnosticReport.subject";
+    readonly PresentedFormContentType: "DiagnosticReport.presented-form-contenttype";
+    readonly PresentedFormData: "DiagnosticReport.presented-form-data";
+    readonly PresentedFormUrl: "DiagnosticReport.presented-form-url";
+    readonly ContainedDocuments: "DiagnosticReport.contained-documents";
+};
+/**
+ * TODO(ips-next):
+ * Add resource-level claim helpers in `src/utils/diagnostic-report-claim-helpers.ts`
+ * following the same contract already used by Consent/Medication/Condition/Allergy:
+ * - `getDiagnosticReportClaimList(...)`
+ * - `setDiagnosticReportClaimList(...)`
+ * - `addDiagnosticReportClaimList(...)`
+ * - `removeDiagnosticReportClaimList(...)`
+ * - focused helpers for:
+ *   - `get/set/add/removeDiagnosticReportResultList`
+ *   - `get/set/add/removeDiagnosticReportPerformerList`
+ *   - `get/set/add/removeDiagnosticReportSpecimenList`
+ *   - `get/set/add/removeDiagnosticReportContainedDocuments`
+ *   - `get/setDiagnosticReportPresentedFormContentType`
+ *   - `get/setDiagnosticReportPresentedFormData`
+ *   - `get/setDiagnosticReportPresentedFormUrl`
+ *
+ * Keep naming aligned with canonical FHIR search parameter names
+ * (lowercase with `-`) and reuse the existing `SearchParamNames` + contextualized
+ * claim-key mapping pattern.
+ *
+ * This file is intentionally type-first only for now so GW Core and
+ * `common-utils` can already exercise the rest of the bundle workflow without
+ * committing to the DiagnosticReport editing surface yet.
+ */
+export type DiagnosticReportClaimKey = typeof DiagnosticReportClaim[keyof typeof DiagnosticReportClaim];
+export declare const DiagnosticReportClaimSpecs: ClaimSpec[];
+export declare const DiagnosticReportSearchParamNames: {
+    readonly BasedOn: "based-on";
+    readonly Category: "category";
+    readonly Code: "code";
+    readonly Date: "date";
+    readonly Encounter: "encounter";
+    readonly Identifier: "identifier";
+    readonly Media: "media";
+    readonly Patient: "patient";
+    readonly Performer: "performer";
+    readonly Result: "result";
+    readonly ResultsInterpreter: "results-interpreter";
+    readonly Specimen: "specimen";
+    readonly Status: "status";
+    readonly Subject: "subject";
+};
+export type DiagnosticReportSearchParamName = typeof DiagnosticReportSearchParamNames[keyof typeof DiagnosticReportSearchParamNames];
+export declare enum DiagnosticReportClaimsFhirApi {
+    BasedOn = "org.hl7.fhir.api.DiagnosticReport.based-on",
+    Category = "org.hl7.fhir.api.DiagnosticReport.category",
+    Code = "org.hl7.fhir.api.DiagnosticReport.code",
+    Date = "org.hl7.fhir.api.DiagnosticReport.date",
+    Encounter = "org.hl7.fhir.api.DiagnosticReport.encounter",
+    Identifier = "org.hl7.fhir.api.DiagnosticReport.identifier",
+    Media = "org.hl7.fhir.api.DiagnosticReport.media",
+    Patient = "org.hl7.fhir.api.DiagnosticReport.patient",
+    Performer = "org.hl7.fhir.api.DiagnosticReport.performer",
+    Result = "org.hl7.fhir.api.DiagnosticReport.result",
+    ResultsInterpreter = "org.hl7.fhir.api.DiagnosticReport.results-interpreter",
+    Specimen = "org.hl7.fhir.api.DiagnosticReport.specimen",
+    Status = "org.hl7.fhir.api.DiagnosticReport.status",
+    Subject = "org.hl7.fhir.api.DiagnosticReport.subject"
+}
+export declare const DiagnosticReportSearchParamToClaimKey: Record<DiagnosticReportSearchParamName, DiagnosticReportClaimsFhirApi>;
+/**
+ * TODO(ips-next):
+ * Add `DiagnosticReportClaimsFhirApiExtended` only if/when the bundle editor
+ * needs operational flat fields beyond the official search parameter surface.
+ *
+ * Do not invent camelCase names. Prefer official FHIR search parameter names
+ * or explicit attachment aliases such as `presented-form-*` and
+ * `contained-documents`.
+ *
+ * Keep `DiagnosticReport` paused at the typing/mapping layer until:
+ * 1. `diagnostic-report-claim-helpers.ts` exists
+ * 2. `CommunicationBundleSession.upsertActiveDiagnosticReportEntry(...)` exists
+ * 3. GW Core readers/tests consume the same shared claim keys
+ */

package/dist/models/interoperable-claims/diagnostic-report-claims.js

@@ -0,0 +1,105 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/diagnostic-report-claims.ts
+export const DiagnosticReportClaim = {
+    BasedOn: 'DiagnosticReport.based-on',
+    Category: 'DiagnosticReport.category',
+    Code: 'DiagnosticReport.code',
+    Date: 'DiagnosticReport.date',
+    Encounter: 'DiagnosticReport.encounter',
+    Identifier: 'DiagnosticReport.identifier',
+    Media: 'DiagnosticReport.media',
+    Patient: 'DiagnosticReport.patient',
+    Performer: 'DiagnosticReport.performer',
+    Result: 'DiagnosticReport.result',
+    ResultsInterpreter: 'DiagnosticReport.results-interpreter',
+    Specimen: 'DiagnosticReport.specimen',
+    Status: 'DiagnosticReport.status',
+    Subject: 'DiagnosticReport.subject',
+    PresentedFormContentType: 'DiagnosticReport.presented-form-contenttype',
+    PresentedFormData: 'DiagnosticReport.presented-form-data',
+    PresentedFormUrl: 'DiagnosticReport.presented-form-url',
+    ContainedDocuments: 'DiagnosticReport.contained-documents',
+};
+export const DiagnosticReportClaimSpecs = [
+    { key: DiagnosticReportClaim.BasedOn, meaning: 'Request or order that originated the report.', example: 'ServiceRequest/sr-1' },
+    { key: DiagnosticReportClaim.Category, meaning: 'Diagnostic service section/category.', example: 'http://terminology.hl7.org/CodeSystem/v2-0074|LAB' },
+    { key: DiagnosticReportClaim.Code, meaning: 'Main diagnostic report code.', example: 'http://loinc.org|58410-2' },
+    { key: DiagnosticReportClaim.Date, meaning: 'Report issuance date/time.', example: '2026-06-12T10:00:00Z' },
+    { key: DiagnosticReportClaim.Encounter, meaning: 'Encounter reference.', example: 'Encounter/enc-1' },
+    { key: DiagnosticReportClaim.Identifier, meaning: 'Business identifier for the report.', example: 'diag-report-001' },
+    { key: DiagnosticReportClaim.Media, meaning: 'Linked media reference list (comma-separeted).', example: 'Media/media-1' },
+    { key: DiagnosticReportClaim.Patient, meaning: 'Patient reference.', example: 'did:web:patient.example.org' },
+    { key: DiagnosticReportClaim.Performer, meaning: 'Performer reference.', example: 'did:web:lab.example.org:system:lisin' },
+    { key: DiagnosticReportClaim.Result, meaning: 'Observation/result reference.', example: 'Observation/obs-1' },
+    { key: DiagnosticReportClaim.ResultsInterpreter, meaning: 'Results interpreter reference.', example: 'Practitioner/prac-1' },
+    { key: DiagnosticReportClaim.Specimen, meaning: 'Specimen reference list (comma-separared).', example: 'Specimen/spec-1' },
+    { key: DiagnosticReportClaim.Status, meaning: 'Diagnostic report status.', example: 'final' },
+    { key: DiagnosticReportClaim.Subject, meaning: 'Canonical subject reference.', example: 'did:web:patient.example.org' },
+    { key: DiagnosticReportClaim.PresentedFormContentType, meaning: 'FHIR presentedForm attachment content type.', example: 'application/pdf' },
+    { key: DiagnosticReportClaim.PresentedFormData, meaning: 'FHIR presentedForm inline base64 payload.', example: 'JVBERi0xLjc...' },
+    { key: DiagnosticReportClaim.PresentedFormUrl, meaning: 'FHIR presentedForm external URL.', example: 'https://example.org/report.pdf' },
+    { key: DiagnosticReportClaim.ContainedDocuments, meaning: 'CSV of linked DocumentReference identifiers stored in the same bundle.', example: 'docref-example-001,docref-example-002' },
+];
+export const DiagnosticReportSearchParamNames = {
+    BasedOn: 'based-on',
+    Category: 'category',
+    Code: 'code',
+    Date: 'date',
+    Encounter: 'encounter',
+    Identifier: 'identifier',
+    Media: 'media',
+    Patient: 'patient',
+    Performer: 'performer',
+    Result: 'result',
+    ResultsInterpreter: 'results-interpreter',
+    Specimen: 'specimen',
+    Status: 'status',
+    Subject: 'subject',
+};
+export var DiagnosticReportClaimsFhirApi;
+(function (DiagnosticReportClaimsFhirApi) {
+    DiagnosticReportClaimsFhirApi["BasedOn"] = "org.hl7.fhir.api.DiagnosticReport.based-on";
+    DiagnosticReportClaimsFhirApi["Category"] = "org.hl7.fhir.api.DiagnosticReport.category";
+    DiagnosticReportClaimsFhirApi["Code"] = "org.hl7.fhir.api.DiagnosticReport.code";
+    DiagnosticReportClaimsFhirApi["Date"] = "org.hl7.fhir.api.DiagnosticReport.date";
+    DiagnosticReportClaimsFhirApi["Encounter"] = "org.hl7.fhir.api.DiagnosticReport.encounter";
+    DiagnosticReportClaimsFhirApi["Identifier"] = "org.hl7.fhir.api.DiagnosticReport.identifier";
+    DiagnosticReportClaimsFhirApi["Media"] = "org.hl7.fhir.api.DiagnosticReport.media";
+    DiagnosticReportClaimsFhirApi["Patient"] = "org.hl7.fhir.api.DiagnosticReport.patient";
+    DiagnosticReportClaimsFhirApi["Performer"] = "org.hl7.fhir.api.DiagnosticReport.performer";
+    DiagnosticReportClaimsFhirApi["Result"] = "org.hl7.fhir.api.DiagnosticReport.result";
+    DiagnosticReportClaimsFhirApi["ResultsInterpreter"] = "org.hl7.fhir.api.DiagnosticReport.results-interpreter";
+    DiagnosticReportClaimsFhirApi["Specimen"] = "org.hl7.fhir.api.DiagnosticReport.specimen";
+    DiagnosticReportClaimsFhirApi["Status"] = "org.hl7.fhir.api.DiagnosticReport.status";
+    DiagnosticReportClaimsFhirApi["Subject"] = "org.hl7.fhir.api.DiagnosticReport.subject";
+})(DiagnosticReportClaimsFhirApi || (DiagnosticReportClaimsFhirApi = {}));
+export const DiagnosticReportSearchParamToClaimKey = {
+    [DiagnosticReportSearchParamNames.BasedOn]: DiagnosticReportClaimsFhirApi.BasedOn,
+    [DiagnosticReportSearchParamNames.Category]: DiagnosticReportClaimsFhirApi.Category,
+    [DiagnosticReportSearchParamNames.Code]: DiagnosticReportClaimsFhirApi.Code,
+    [DiagnosticReportSearchParamNames.Date]: DiagnosticReportClaimsFhirApi.Date,
+    [DiagnosticReportSearchParamNames.Encounter]: DiagnosticReportClaimsFhirApi.Encounter,
+    [DiagnosticReportSearchParamNames.Identifier]: DiagnosticReportClaimsFhirApi.Identifier,
+    [DiagnosticReportSearchParamNames.Media]: DiagnosticReportClaimsFhirApi.Media,
+    [DiagnosticReportSearchParamNames.Patient]: DiagnosticReportClaimsFhirApi.Patient,
+    [DiagnosticReportSearchParamNames.Performer]: DiagnosticReportClaimsFhirApi.Performer,
+    [DiagnosticReportSearchParamNames.Result]: DiagnosticReportClaimsFhirApi.Result,
+    [DiagnosticReportSearchParamNames.ResultsInterpreter]: DiagnosticReportClaimsFhirApi.ResultsInterpreter,
+    [DiagnosticReportSearchParamNames.Specimen]: DiagnosticReportClaimsFhirApi.Specimen,
+    [DiagnosticReportSearchParamNames.Status]: DiagnosticReportClaimsFhirApi.Status,
+    [DiagnosticReportSearchParamNames.Subject]: DiagnosticReportClaimsFhirApi.Subject,
+};
+/**
+ * TODO(ips-next):
+ * Add `DiagnosticReportClaimsFhirApiExtended` only if/when the bundle editor
+ * needs operational flat fields beyond the official search parameter surface.
+ *
+ * Do not invent camelCase names. Prefer official FHIR search parameter names
+ * or explicit attachment aliases such as `presented-form-*` and
+ * `contained-documents`.
+ *
+ * Keep `DiagnosticReport` paused at the typing/mapping layer until:
+ * 1. `diagnostic-report-claim-helpers.ts` exists
+ * 2. `CommunicationBundleSession.upsertActiveDiagnosticReportEntry(...)` exists
+ * 3. GW Core readers/tests consume the same shared claim keys
+ */

package/dist/models/interoperable-claims/index.d.ts

@@ -2,6 +2,7 @@ export * from './types';
 export * from './composition-claims';
 export * from './communication-claims';
 export * from './document-reference-claims';
+export * from './diagnostic-report-claims';
 export * from './medication-statement-claims';
 export * from './allergy-intolerance-claims';
 export * from './condition-claims';