gdc-common-utils-ts 1.14.9 → 1.14.13

package/dist/convert/convert-shared.js

@@ -0,0 +1,179 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/utils/convert-shared.ts
+export function isPlainObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+export function codingFromValue(value) {
+    if (!value)
+        return undefined;
+    const [system, code] = value.split('|');
+    if (!code)
+        return [{ code: system }];
+    return [{ system, code }];
+}
+export function codingToValue(coding) {
+    if (!coding?.code)
+        return undefined;
+    return coding.system ? `${coding.system}|${coding.code}` : coding.code;
+}
+export function referenceToValue(reference) {
+    return reference?.reference;
+}
+export function referenceListToCsv(references) {
+    const values = (references || [])
+        .map((item) => item?.reference)
+        .filter((item) => Boolean(item));
+    return values.length ? values.join(',') : undefined;
+}
+export function codingListToCsv(codings) {
+    const values = (codings || [])
+        .map((item) => codingToValue(item))
+        .filter((item) => Boolean(item));
+    return values.length ? values.join(',') : undefined;
+}
+export function requireClaim(claims, key) {
+    const value = claims[key];
+    if (!value)
+        throw new Error(`Missing required claim: ${key}`);
+    return value;
+}
+export function requireSubjectIdentifier(value, key) {
+    if (!value.startsWith('urn:') && !value.startsWith('did:web:')) {
+        throw new Error(`Invalid ${key}: expected urn:* or did:web:*`);
+    }
+}
+export function requireDidWeb(value, key) {
+    if (!value.startsWith('did:web:')) {
+        throw new Error(`Invalid ${key}: expected did:web:*`);
+    }
+}
+function stringifyClaimLeaf(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return undefined;
+}
+function flattenClaimPath(prefix, value, out) {
+    const primitive = stringifyClaimLeaf(value);
+    if (primitive !== undefined) {
+        out[prefix] = primitive;
+        if (typeof value === 'number' || typeof value === 'boolean') {
+            out[`${prefix}#type`] = typeof value;
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((entry, index) => {
+            flattenClaimPath(`${prefix}[${index}]`, entry, out);
+        });
+        return;
+    }
+    if (isPlainObject(value)) {
+        for (const [key, nestedValue] of Object.entries(value)) {
+            if (key === 'meta' && isPlainObject(nestedValue) && 'claims' in nestedValue) {
+                const nestedMeta = { ...nestedValue };
+                delete nestedMeta.claims;
+                if (Object.keys(nestedMeta).length === 0)
+                    continue;
+                flattenClaimPath(`${prefix}.${key}`, nestedMeta, out);
+                continue;
+            }
+            flattenClaimPath(`${prefix}.${key}`, nestedValue, out);
+        }
+    }
+}
+function parseClaimPath(path) {
+    const segments = [];
+    const re = /([^[.\]]+)|\[(\d+)\]/g;
+    let match;
+    while ((match = re.exec(path)) !== null) {
+        if (match[1])
+            segments.push(match[1]);
+        else if (match[2])
+            segments.push(Number(match[2]));
+    }
+    return segments;
+}
+function coerceClaimLeaf(value, typeHint) {
+    if (typeHint === 'boolean')
+        return value === 'true';
+    if (typeHint === 'number')
+        return Number(value);
+    return value;
+}
+function assignInflatedPath(target, path, value, typeHint) {
+    const segments = parseClaimPath(path);
+    if (segments.length === 0)
+        return;
+    let cursor = target;
+    for (let index = 0; index < segments.length; index += 1) {
+        const segment = segments[index];
+        const nextSegment = segments[index + 1];
+        const isLast = index === segments.length - 1;
+        if (typeof segment === 'number') {
+            if (!Array.isArray(cursor))
+                return;
+            if (isLast) {
+                cursor[segment] = coerceClaimLeaf(value, typeHint);
+                return;
+            }
+            if (cursor[segment] === undefined)
+                cursor[segment] = typeof nextSegment === 'number' ? [] : {};
+            cursor = cursor[segment];
+            continue;
+        }
+        if (!isPlainObject(cursor))
+            return;
+        if (isLast) {
+            cursor[segment] = coerceClaimLeaf(value, typeHint);
+            return;
+        }
+        if (cursor[segment] === undefined)
+            cursor[segment] = typeof nextSegment === 'number' ? [] : {};
+        cursor = cursor[segment];
+    }
+}
+/**
+ * Generic structural fallback for unsupported resources.
+ */
+export function fhirResourceToFlatClaims(resource, context = 'org.hl7.fhir.r4') {
+    if (!resource?.resourceType) {
+        throw new Error('FHIR resource must define resourceType.');
+    }
+    const out = { '@context': context };
+    for (const [key, value] of Object.entries(resource)) {
+        if (key === 'resourceType')
+            continue;
+        flattenClaimPath(`${resource.resourceType}.${key}`, value, out);
+    }
+    return out;
+}
+/**
+ * Generic structural regeneration for unsupported resources.
+ */
+export function flatClaimsToFhirResource(claims) {
+    const typeHints = new Map();
+    for (const [key, value] of Object.entries(claims || {})) {
+        if (key.endsWith('#type') && typeof value === 'string') {
+            typeHints.set(key.slice(0, -5), value);
+        }
+    }
+    const entries = Object.entries(claims || {}).filter(([key, value]) => key !== '@context' && !key.endsWith('#type') && value !== undefined);
+    const firstClaimKey = entries[0]?.[0];
+    if (!firstClaimKey || !firstClaimKey.includes('.')) {
+        throw new Error('Flat claims must contain at least one contextualized resource claim.');
+    }
+    const resourceType = firstClaimKey.split('.')[0];
+    const resource = { resourceType };
+    for (const [key, value] of entries) {
+        if (typeof value !== 'string')
+            continue;
+        if (!key.startsWith(`${resourceType}.`))
+            continue;
+        assignInflatedPath(resource, key.slice(resourceType.length + 1), value, typeHints.get(key));
+    }
+    return resource;
+}

package/dist/convert/index.d.ts

@@ -0,0 +1,22 @@
+export * from './convert-shared';
+export * from './convert-medication-statement';
+export * from './convert-allergy-intolerance';
+export * from './convert-condition';
+export * from './convert-device-use-statement';
+export * from './convert-document-reference';
+export * from './convert-immunization';
+export * from './convert-location';
+export * from './convert-observation';
+export * from './convert-organization';
+export * from './convert-procedure';
+export * from './convert-device';
+export * from './convert-flag';
+export * from './convert-care-plan';
+export * from './convert-diagnostic-report';
+export * from './convert-composition';
+export * from './convert-appointment';
+export * from './convert-appointment-response';
+export * from './convert-encounter';
+export * from './convert-related-person';
+export * from './convert-coverage';
+export * from './convert-clinical-impression';

package/dist/convert/index.js

@@ -0,0 +1,22 @@
+export * from './convert-shared.js';
+export * from './convert-medication-statement.js';
+export * from './convert-allergy-intolerance.js';
+export * from './convert-condition.js';
+export * from './convert-device-use-statement.js';
+export * from './convert-document-reference.js';
+export * from './convert-immunization.js';
+export * from './convert-location.js';
+export * from './convert-observation.js';
+export * from './convert-organization.js';
+export * from './convert-procedure.js';
+export * from './convert-device.js';
+export * from './convert-flag.js';
+export * from './convert-care-plan.js';
+export * from './convert-diagnostic-report.js';
+export * from './convert-composition.js';
+export * from './convert-appointment.js';
+export * from './convert-appointment-response.js';
+export * from './convert-encounter.js';
+export * from './convert-related-person.js';
+export * from './convert-coverage.js';
+export * from './convert-clinical-impression.js';

package/dist/examples/communication-bundle-document-request.js

@@ -39,7 +39,7 @@ export function buildExampleIpsBundleDocumentRequestFromDoctor() {
         sender: EXAMPLE_EMAIL_PROFESSIONAL,
         requesterKind: BundleDocumentRequesterKinds.Employee,
         requesterIdentifier: EXAMPLE_EMAIL_PROFESSIONAL,
-        requesterRole: HealthcareActorRoles.Physician,
+        requesterRole: HealthcareActorRoles.GeneralistMedicalPractitioner,
         documentType: DocumentTypeLoincOntology.IPS,
         sections,
         summaryOperationRequestReferencePath,
@@ -49,7 +49,7 @@ export function buildExampleIpsBundleDocumentRequestFromDoctor() {
         sender: EXAMPLE_EMAIL_PROFESSIONAL,
         requesterKind: BundleDocumentRequesterKinds.Employee,
         requesterIdentifier: EXAMPLE_EMAIL_PROFESSIONAL,
-        requesterRole: HealthcareActorRoles.Physician,
+        requesterRole: HealthcareActorRoles.GeneralistMedicalPractitioner,
         documentType: DocumentTypeLoincOntology.IPS,
         sections,
         text: String(claims[CommunicationClaim.Text] || ''),

package/dist/examples/communication-bundle-session.js

@@ -5,8 +5,8 @@ import { CommunicationCategoryCodes } from '../constants/communication.js';
 import { MedicationStatementClaim } from '../models/interoperable-claims/medication-statement-claims.js';
 import { EXAMPLE_COMMUNICATION_IDENTIFIER, EXAMPLE_CONSENT_DATE, EXAMPLE_CONSENT_IDENTIFIER, EXAMPLE_CONSENT_PERIOD_END, EXAMPLE_CONSENT_PERIOD_START, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER, EXAMPLE_MEDICATION_STATEMENT_STATUS, EXAMPLE_MEDICATION_STATEMENT_TEXT, EXAMPLE_SUBJECT_DID, } from './shared.js';
 import { CommunicationBundleSession } from '../utils/communication-bundle-session.js';
-import { setCommunicationCategory, setCommunicationIdentifier, setCommunicationSubject, setCommunicationText, } from '../utils/communication-claim-helpers.js';
-import { setActorIdentifierList, setActorRoleList, setConsentDate, setConsentDecision, setConsentIdentifier, setConsentPeriodEnd, setConsentPeriodStart, setConsentSubject, setPurposeList, setSectionList, } from '../utils/consent-claim-helpers.js';
+import { setCommunicationCategory, setCommunicationIdentifier, setCommunicationSubject, setCommunicationText, } from '../claims/claims-helpers-communication.js';
+import { setActorIdentifierList, setActorRoleList, setConsentDate, setConsentDecision, setConsentIdentifier, setConsentPeriodEnd, setConsentPeriodStart, setConsentSubject, setPurposeList, setSectionList, } from '../claims/claims-helpers-consent.js';
 /**
  * First developer use case:
  * - edit a Consent entry inside a Communication-attached Bundle

package/dist/examples/shared.d.ts

@@ -110,8 +110,8 @@ export declare const EXAMPLE_MEDICATION_PARACETAMOL_TEXT: "Paracetamol 600 mg";
 export declare const EXAMPLE_MEDICATION_PARACETAMOL_IDENTIFIER_PREFIX: "urn:uuid:med-paracetamol";
 export declare const EXAMPLE_MEDICATION_PARACETAMOL_EFFECTIVE: "2026-06-01T12:00:00Z";
 export declare const EXAMPLE_MEDICATION_PARACETAMOL_NOTE: "Take every 8 hours as needed. Keep a 4 hour gap from ibuprofen.";
-export declare const EXAMPLE_IPS_BUNDLE_REFERENCE_URL: "individual/org.hl7.fhir.r4/Bundle?type=document&composition.subject=did:web:api.acme.org:individual:123&composition.type=http://loinc.org|60591-5";
-export declare const EXAMPLE_IPS_BUNDLE_REFERENCE_ABSOLUTE_URL: "https://provider.example.org/acme-id/cds-ES/v1/health-care/individual/org.hl7.fhir.r4/Bundle?type=document&composition.subject=did:web:api.acme.org:individual:123&composition.type=http://loinc.org|60591-5";
+export declare const EXAMPLE_IPS_BUNDLE_REFERENCE_URL: "individual/org.hl7.fhir.r4/Bundle/_search?type=document&composition.subject=did:web:api.acme.org:individual:123&composition.type=http://loinc.org|60591-5";
+export declare const EXAMPLE_IPS_BUNDLE_REFERENCE_ABSOLUTE_URL: "https://provider.example.org/acme-id/cds-ES/v1/health-care/individual/org.hl7.fhir.r4/Bundle/_search?type=document&composition.subject=did:web:api.acme.org:individual:123&composition.type=http://loinc.org|60591-5";
 export type ExampleDateRange = Readonly<{
     start: string;
     end: string;
@@ -141,6 +141,17 @@ export type ExampleLiveMedicationCase = Readonly<{
     dosageAsNeeded: boolean;
     section: string;
 }>;
+export type ExampleMedicationIpsDocumentBundleInput = Readonly<{
+    subjectDid?: string;
+    medication: ExampleLiveMedicationCase;
+}>;
+export type ExampleMedicationIpsDocumentBundle = Readonly<{
+    resourceType: 'Bundle';
+    type: 'document';
+    entry: ReadonlyArray<{
+        resource: Record<string, unknown>;
+    }>;
+}>;
 export declare const EXAMPLE_CONTROLLER_SIGN_KEY: {
     readonly kid: "controller-es384-001";
     readonly kty: "EC";
@@ -253,6 +264,14 @@ export declare function buildExampleDocumentReferenceSearchPayload(subjectDid?:
 };
 export declare function cloneExample<T>(value: T): T;
 export declare function buildExampleLiveMedicationCases(seed?: number): ExampleLiveMedicationCase[];
+/**
+ * Builds a minimal IPS `Bundle.type=document` containing one
+ * `MedicationStatement` under the `History of medication use` section.
+ *
+ * This helper exists so live GW tests and demos do not handcraft one-off
+ * bundle structures inline.
+ */
+export declare function buildExampleMedicationIpsDocumentBundle(input: ExampleMedicationIpsDocumentBundleInput): ExampleMedicationIpsDocumentBundle;
 export type ExampleHostedTenantRouteContext = Readonly<{
     alternateName: string;
     jurisdiction: string;

package/dist/examples/shared.js

@@ -4,6 +4,8 @@ import { DataspaceSectors } from '../constants/sectors.js';
 import { HostNetworkTypes } from '../constants/network.js';
 import { HealthcareActorRoles, HealthcareBasicSections, HealthcareConsentPurposes, } from '../constants/healthcare.js';
 import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
+import { MedicationStatementClaim, MedicationStatementClaimsFhirApiExtended, } from '../models/interoperable-claims/medication-statement-claims.js';
+import { medicationStatementFlatToFhirR4 } from '../utils/clinical-resource-converters.js';
 /**
  * Shared low-level example fragments reused by multiple flow-specific example modules.
  *
@@ -116,7 +118,7 @@ export const EXAMPLE_MEDICATION_PARACETAMOL_TEXT = 'Paracetamol 600 mg';
 export const EXAMPLE_MEDICATION_PARACETAMOL_IDENTIFIER_PREFIX = 'urn:uuid:med-paracetamol';
 export const EXAMPLE_MEDICATION_PARACETAMOL_EFFECTIVE = '2026-06-01T12:00:00Z';
 export const EXAMPLE_MEDICATION_PARACETAMOL_NOTE = 'Take every 8 hours as needed. Keep a 4 hour gap from ibuprofen.';
-export const EXAMPLE_IPS_BUNDLE_REFERENCE_URL = `individual/org.hl7.fhir.r4/Bundle?type=document&composition.subject=${EXAMPLE_SUBJECT_DID}&composition.type=http://loinc.org|60591-5`;
+export const EXAMPLE_IPS_BUNDLE_REFERENCE_URL = `individual/org.hl7.fhir.r4/Bundle/_search?type=document&composition.subject=${EXAMPLE_SUBJECT_DID}&composition.type=http://loinc.org|60591-5`;
 export const EXAMPLE_IPS_BUNDLE_REFERENCE_ABSOLUTE_URL = `https://provider.example.org/acme-id/cds-ES/v1/health-care/${EXAMPLE_IPS_BUNDLE_REFERENCE_URL}`;
 export const EXAMPLE_CLINICAL_DATE_RANGE = {
     start: '2026-01-01',
@@ -244,6 +246,77 @@ export function buildExampleLiveMedicationCases(seed = Date.now()) {
         },
     ];
 }
+/**
+ * Builds a minimal IPS `Bundle.type=document` containing one
+ * `MedicationStatement` under the `History of medication use` section.
+ *
+ * This helper exists so live GW tests and demos do not handcraft one-off
+ * bundle structures inline.
+ */
+export function buildExampleMedicationIpsDocumentBundle(input) {
+    const subjectDid = input.subjectDid || EXAMPLE_SUBJECT_DID;
+    const medicationClaims = {
+        '@context': 'org.hl7.fhir.api',
+        [MedicationStatementClaim.Identifier]: input.medication.identifier,
+        [MedicationStatementClaim.Subject]: subjectDid,
+        [MedicationStatementClaim.Status]: EXAMPLE_MEDICATION_STATEMENT_STATUS,
+        [MedicationStatementClaim.MedicationText]: input.medication.text,
+        [MedicationStatementClaim.Effective]: input.medication.effectiveDateTime,
+        [MedicationStatementClaim.Note]: input.medication.note,
+        [MedicationStatementClaim.Category]: input.medication.section || HealthcareBasicSections.HistoryOfMedicationUse.attributeValue,
+        [MedicationStatementClaimsFhirApiExtended.DoseQuantityValue]: input.medication.doseQuantityValue,
+        [MedicationStatementClaimsFhirApiExtended.DoseQuantityUnit]: input.medication.doseQuantityUnit,
+        [MedicationStatementClaimsFhirApiExtended.TimingFrequency]: input.medication.timingFrequency,
+        [MedicationStatementClaimsFhirApiExtended.TimingPeriod]: input.medication.timingPeriod,
+        [MedicationStatementClaimsFhirApiExtended.TimingPeriodUnit]: input.medication.timingPeriodUnit,
+        [MedicationStatementClaimsFhirApiExtended.DosageAsNeeded]: input.medication.dosageAsNeeded,
+    };
+    const medicationResource = medicationStatementFlatToFhirR4(medicationClaims);
+    medicationResource.id = input.medication.identifier;
+    medicationResource.meta = {
+        ...(typeof medicationResource.meta === 'object' && medicationResource.meta ? medicationResource.meta : {}),
+        claims: medicationClaims,
+    };
+    return {
+        resourceType: 'Bundle',
+        type: 'document',
+        entry: [
+            {
+                resource: {
+                    resourceType: 'Composition',
+                    id: `composition-${input.medication.identifier}`,
+                    status: 'final',
+                    subject: { reference: subjectDid },
+                    type: { coding: [{ system: 'http://loinc.org', code: '60591-5' }] },
+                    section: [
+                        {
+                            code: {
+                                coding: [{
+                                        system: 'http://loinc.org',
+                                        code: '10160-0',
+                                    }],
+                            },
+                            entry: [
+                                {
+                                    reference: `MedicationStatement/${input.medication.identifier}`,
+                                },
+                            ],
+                        },
+                    ],
+                },
+            },
+            {
+                resource: {
+                    resourceType: 'Patient',
+                    id: `patient-${input.medication.identifier}`,
+                },
+            },
+            {
+                resource: medicationResource,
+            },
+        ],
+    };
+}
 export function buildExampleHostedTenantBaseUrl(input) {
     return `${EXAMPLE_GATEWAY_PUBLIC_ORIGIN}/${input.alternateName}/cds-${input.jurisdiction.toLowerCase()}/${input.version}/${input.sector}`;
 }

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export * from './AesManager';
 export * from './CryptographyService';
+export * from './claims';
 export * from './constants';
+export * from './convert';
 export * from './examples';
 export * from './hmac';
 export * from './i18n/clinical-sections.i18n';

package/dist/index.js

@@ -1,6 +1,8 @@
 export * from './AesManager.js';
 export * from './CryptographyService.js';
+export * from './claims/index.js';
 export * from './constants/index.js';
+export * from './convert/index.js';
 export * from './examples/index.js';
 export * from './hmac.js';
 export * from './i18n/clinical-sections.i18n.js';

package/dist/models/bundle.d.ts

@@ -34,6 +34,12 @@ export interface BundleRequest {
 /**
  * Defines the `response` property for an entry in a response Bundle.
  * This indicates the outcome of the action for the entry.
+ *
+ * Notes for consumers:
+ * - `status` is the primary per-entry result signal.
+ * - `response.outcome` may be present for diagnostics, warnings, or richer success details,
+ *   but is not guaranteed to be present on every successful entry.
+ * - `BundleJsonApi.total` counts response entries in the bundle; it is not a success counter.
  */
 export interface BundleResponse {
     /** The HTTP status code as a string (e.g., "201", "404"). */
@@ -111,7 +117,13 @@ export interface ErrorEntry {
     response: {
         /** The HTTP status code reflecting the error (e.g., "400", "500"). */
         status: string;
-        /** A FHIR OperationOutcome resource providing detailed error diagnostics. */
+        /**
+         * A FHIR OperationOutcome resource providing detailed diagnostics.
+         *
+         * `OperationOutcome.issue[*].severity` is not restricted to failure cases.
+         * Depending on the producer/profile it may contain:
+         * `fatal | error | warning | information | success`.
+         */
         outcome: OperationOutcome;
     };
 }

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

@@ -5,7 +5,7 @@
  * This model aligns with FHIR R5 conventions (using `note.text` instead of `comment`)
  * for forward compatibility and consistency with other resources like Communication.
  *
- * @basedon https://github.com/Universal-Health-Chain/uhc-fhir-utils-typescript/blob/main/src/models/templates/Appointment.template.model.ts
+ * @basedon https://github.com/Universal-Health-Chain/uhc-fhir-utils-ts/blob/main/src/models/templates/Appointment.template.model.ts
  */
 /**
  * Contains claims representing fields specific to the FHIR R4/R5 data model for an Appointment.
@@ -165,6 +165,28 @@ export declare const AppointmentClaimsFhirApiExtendedMap: {
     "org.hl7.fhir.api.Appointment.status": StringConstructor;
     "org.hl7.fhir.api.Appointment.supporting-info": StringConstructor;
 };
+export declare const AppointmentClaim: {
+    readonly Identifier: "Appointment.identifier";
+    readonly Status: "Appointment.status";
+    readonly ServiceCategory: "Appointment.service-category";
+    readonly ServiceType: "Appointment.service-type";
+    readonly Specialty: "Appointment.specialty";
+    readonly AppointmentType: "Appointment.appointment-type";
+    readonly ReasonCode: "Appointment.reason-code";
+    readonly ReasonReference: "Appointment.reason-reference";
+    readonly Description: "Appointment.description";
+    readonly Start: "Appointment.start";
+    readonly End: "Appointment.end";
+    readonly MinutesDuration: "Appointment.minutes-duration";
+    readonly Created: "Appointment.created";
+    readonly NoteText: "Appointment.note-text";
+    readonly PatientInstruction: "Appointment.patient-instruction";
+    readonly BasedOn: "Appointment.based-on";
+    readonly ParticipantActor: "Appointment.participant.actor";
+    readonly ParticipantStatus: "Appointment.participant.status";
+    readonly ParticipantType: "Appointment.participant.type";
+};
+export type AppointmentClaimKey = typeof AppointmentClaim[keyof typeof AppointmentClaim];
 /**
  * Defines the possible values for the `status` field on a FHIR Appointment resource.
  * @basedon http://hl7.org/fhir/R4/appointment.html#status

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

@@ -6,7 +6,7 @@
  * This model aligns with FHIR R5 conventions (using `note.text` instead of `comment`)
  * for forward compatibility and consistency with other resources like Communication.
  *
- * @basedon https://github.com/Universal-Health-Chain/uhc-fhir-utils-typescript/blob/main/src/models/templates/Appointment.template.model.ts
+ * @basedon https://github.com/Universal-Health-Chain/uhc-fhir-utils-ts/blob/main/src/models/templates/Appointment.template.model.ts
  */
 /**
  * Contains claims representing fields specific to the FHIR R4/R5 data model for an Appointment.
@@ -155,6 +155,27 @@ export const AppointmentClaimsFhirApiExtendedMap = {
     [AppointmentClaimsFhirApiExtended.Description]: String,
     [AppointmentClaimsFhirApiExtended.NoteText]: String,
 };
+export const AppointmentClaim = {
+    Identifier: 'Appointment.identifier',
+    Status: 'Appointment.status',
+    ServiceCategory: 'Appointment.service-category',
+    ServiceType: 'Appointment.service-type',
+    Specialty: 'Appointment.specialty',
+    AppointmentType: 'Appointment.appointment-type',
+    ReasonCode: 'Appointment.reason-code',
+    ReasonReference: 'Appointment.reason-reference',
+    Description: 'Appointment.description',
+    Start: 'Appointment.start',
+    End: 'Appointment.end',
+    MinutesDuration: 'Appointment.minutes-duration',
+    Created: 'Appointment.created',
+    NoteText: 'Appointment.note-text',
+    PatientInstruction: 'Appointment.patient-instruction',
+    BasedOn: 'Appointment.based-on',
+    ParticipantActor: 'Appointment.participant.actor',
+    ParticipantStatus: 'Appointment.participant.status',
+    ParticipantType: 'Appointment.participant.type',
+};
 // src/models/fhir/Appointment.values.ts
 /**
  * Defines the possible values for the `status` field on a FHIR Appointment resource.

package/dist/models/interoperable-claims/appointment-response-claims.d.ts

@@ -47,3 +47,17 @@ export declare const AppointmentResponseClaimsFhirApiExtended: {
     'org.hl7.fhir.api.AppointmentResponse.patient': StringConstructor;
     'org.hl7.fhir.api.AppointmentResponse.practitioner': StringConstructor;
 };
+export declare const AppointmentResponseClaim: {
+    readonly Actor: "AppointmentResponse.actor";
+    readonly Appointment: "AppointmentResponse.appointment";
+    readonly Comment: "AppointmentResponse.comment";
+    readonly Identifier: "AppointmentResponse.identifier";
+    readonly Start: "AppointmentResponse.start";
+    readonly End: "AppointmentResponse.end";
+    readonly ParticipantType: "AppointmentResponse.participant-type";
+    readonly ParticipantStatus: "AppointmentResponse.participant-status";
+    readonly Patient: "AppointmentResponse.patient";
+    readonly Practitioner: "AppointmentResponse.practitioner";
+    readonly Location: "AppointmentResponse.location";
+};
+export type AppointmentResponseClaimKey = typeof AppointmentResponseClaim[keyof typeof AppointmentResponseClaim];

package/dist/models/interoperable-claims/appointment-response-claims.js

@@ -43,3 +43,16 @@ export const AppointmentResponseClaimsFhirApiExtended = {
     ...AppointmentResponseClaimsFhirApi,
     // No additional extended claims for AppointmentResponse at this time.
 };
+export const AppointmentResponseClaim = {
+    Actor: 'AppointmentResponse.actor',
+    Appointment: 'AppointmentResponse.appointment',
+    Comment: 'AppointmentResponse.comment',
+    Identifier: 'AppointmentResponse.identifier',
+    Start: 'AppointmentResponse.start',
+    End: 'AppointmentResponse.end',
+    ParticipantType: 'AppointmentResponse.participant-type',
+    ParticipantStatus: 'AppointmentResponse.participant-status',
+    Patient: 'AppointmentResponse.patient',
+    Practitioner: 'AppointmentResponse.practitioner',
+    Location: 'AppointmentResponse.location',
+};

package/dist/models/interoperable-claims/care-plan-claims.d.ts

@@ -0,0 +1,24 @@
+import type { ClaimSpec } from './types';
+export declare const CarePlanClaim: {
+    readonly ActivityCode: "CarePlan.activity-code";
+    readonly ActivityDate: "CarePlan.activity-date";
+    readonly ActivityReference: "CarePlan.activity-reference";
+    readonly BasedOn: "CarePlan.based-on";
+    readonly CareTeam: "CarePlan.care-team";
+    readonly Category: "CarePlan.category";
+    readonly Condition: "CarePlan.condition";
+    readonly Date: "CarePlan.date";
+    readonly Encounter: "CarePlan.encounter";
+    readonly Goal: "CarePlan.goal";
+    readonly Identifier: "CarePlan.identifier";
+    readonly Intent: "CarePlan.intent";
+    readonly PartOf: "CarePlan.part-of";
+    readonly Patient: "CarePlan.patient";
+    readonly Performer: "CarePlan.performer";
+    readonly Replaces: "CarePlan.replaces";
+    readonly Status: "CarePlan.status";
+    readonly Subject: "CarePlan.subject";
+    readonly Note: "CarePlan.note";
+};
+export type CarePlanClaimKey = typeof CarePlanClaim[keyof typeof CarePlanClaim];
+export declare const CarePlanClaimSpecs: ClaimSpec[];

package/dist/models/interoperable-claims/care-plan-claims.js

@@ -0,0 +1,44 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/care-plan-claims.ts
+export const CarePlanClaim = {
+    ActivityCode: 'CarePlan.activity-code',
+    ActivityDate: 'CarePlan.activity-date',
+    ActivityReference: 'CarePlan.activity-reference',
+    BasedOn: 'CarePlan.based-on',
+    CareTeam: 'CarePlan.care-team',
+    Category: 'CarePlan.category',
+    Condition: 'CarePlan.condition',
+    Date: 'CarePlan.date',
+    Encounter: 'CarePlan.encounter',
+    Goal: 'CarePlan.goal',
+    Identifier: 'CarePlan.identifier',
+    Intent: 'CarePlan.intent',
+    PartOf: 'CarePlan.part-of',
+    Patient: 'CarePlan.patient',
+    Performer: 'CarePlan.performer',
+    Replaces: 'CarePlan.replaces',
+    Status: 'CarePlan.status',
+    Subject: 'CarePlan.subject',
+    Note: 'CarePlan.note',
+};
+export const CarePlanClaimSpecs = [
+    { key: CarePlanClaim.ActivityCode, meaning: 'Planned activity code token.', example: 'http://snomed.info/sct|229065009' },
+    { key: CarePlanClaim.ActivityDate, meaning: 'Planned activity date/time.', example: '2026-06-15T09:00:00Z' },
+    { key: CarePlanClaim.ActivityReference, meaning: 'Activity reference.', example: 'ServiceRequest/sr-1' },
+    { key: CarePlanClaim.BasedOn, meaning: 'Based-on reference.', example: 'CarePlan/plan-parent' },
+    { key: CarePlanClaim.CareTeam, meaning: 'Care team references (CSV).', example: 'CareTeam/team-1' },
+    { key: CarePlanClaim.Category, meaning: 'Care plan category token.', example: 'http://snomed.info/sct|736373009' },
+    { key: CarePlanClaim.Condition, meaning: 'Condition references (CSV).', example: 'Condition/cond-1' },
+    { key: CarePlanClaim.Date, meaning: 'Care plan creation or period date.', example: '2026-06-01T10:00:00Z' },
+    { key: CarePlanClaim.Encounter, meaning: 'Encounter reference.', example: 'Encounter/enc-1' },
+    { key: CarePlanClaim.Goal, meaning: 'Goal references (CSV).', example: 'Goal/goal-1' },
+    { key: CarePlanClaim.Identifier, meaning: 'Business identifier.', example: 'careplan-001' },
+    { key: CarePlanClaim.Intent, meaning: 'Care plan intent.', example: 'plan' },
+    { key: CarePlanClaim.PartOf, meaning: 'Parent care plan references (CSV).', example: 'CarePlan/plan-parent' },
+    { key: CarePlanClaim.Patient, meaning: 'Patient reference.', example: 'did:web:patient.example.org' },
+    { key: CarePlanClaim.Performer, meaning: 'Performer references (CSV).', example: 'Practitioner/prac-1' },
+    { key: CarePlanClaim.Replaces, meaning: 'Replaced care plan references (CSV).', example: 'CarePlan/old-plan' },
+    { key: CarePlanClaim.Status, meaning: 'Care plan status.', example: 'active' },
+    { key: CarePlanClaim.Subject, meaning: 'Canonical subject reference.', example: 'did:web:patient.example.org' },
+    { key: CarePlanClaim.Note, meaning: 'Clinical note text.', example: 'Daily home exercise plan.' },
+];

package/dist/models/interoperable-claims/clinical-impression-claims.d.ts

@@ -0,0 +1,17 @@
+import type { ClaimSpec } from './types';
+export declare const ClinicalImpressionClaim: {
+    readonly Identifier: "ClinicalImpression.identifier";
+    readonly Status: "ClinicalImpression.status";
+    readonly Description: "ClinicalImpression.description";
+    readonly Subject: "ClinicalImpression.subject";
+    readonly Encounter: "ClinicalImpression.encounter";
+    readonly EffectiveDateTime: "ClinicalImpression.effectiveDateTime";
+    readonly Date: "ClinicalImpression.date";
+    readonly Assessor: "ClinicalImpression.assessor";
+    readonly Problem: "ClinicalImpression.problem";
+    readonly Finding: "ClinicalImpression.finding";
+    readonly PrognosisCode: "ClinicalImpression.prognosis-code";
+    readonly Summary: "ClinicalImpression.summary";
+};
+export type ClinicalImpressionClaimKey = typeof ClinicalImpressionClaim[keyof typeof ClinicalImpressionClaim];
+export declare const ClinicalImpressionClaimSpecs: ClaimSpec[];