fhir-data-utils-ts 0.2.4 → 0.3.1

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

@@ -0,0 +1,109 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const DiagnosticReportClaim: {
+    readonly BasedOn: "DiagnosticReport.based-on";
+    readonly Category: "DiagnosticReport.category";
+    readonly Code: "DiagnosticReport.code";
+    readonly CodeText: "DiagnosticReport.code-text";
+    readonly CodeTextLocal: "DiagnosticReport.code-text";
+    readonly CodeDisplay: "DiagnosticReport.code-display";
+    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";
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    readonly ContainedReferenceList: "DiagnosticReport.contained-reference-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedResourceList: "DiagnosticReport.contained-resource-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedDocuments: "DiagnosticReport.contained-documents";
+};
+/**
+ * TODO(ips-next):
+ * Add resource-level claim helpers in `src/utils/claims-helpers-diagnostic-report.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/removeDiagnosticReportContainedResourceReferences`
+ *   - `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-reference-list`.
+ *
+ * Keep `DiagnosticReport` paused at the typing/mapping layer until:
+ * 1. `claims-helpers-diagnostic-report.ts` exists
+ * 2. GW Core readers/tests consume the same shared claim keys
+ */

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

@@ -0,0 +1,120 @@
+// 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',
+    CodeText: 'DiagnosticReport.code-text',
+    CodeTextLocal: 'DiagnosticReport.code-text',
+    CodeDisplay: 'DiagnosticReport.code-display',
+    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',
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    ContainedReferenceList: 'DiagnosticReport.contained-reference-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedResourceList: 'DiagnosticReport.contained-resource-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    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.CodeText, meaning: 'Local-language report name matching resource language.', example: 'Hemograma completo' },
+    { key: DiagnosticReportClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Complete blood count panel' },
+    { 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-reference-list`.
+ *
+ * Keep `DiagnosticReport` paused at the typing/mapping layer until:
+ * 1. `claims-helpers-diagnostic-report.ts` exists
+ * 2. GW Core readers/tests consume the same shared claim keys
+ */

package/dist/claims/document-reference-claims.d.ts

@@ -0,0 +1,39 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const DocumentReferenceClaim: {
+    readonly Attester: "DocumentReference.attester";
+    readonly Author: "DocumentReference.author";
+    readonly BasedOn: "DocumentReference.based-on";
+    readonly Category: "DocumentReference.category";
+    readonly ContentData: "DocumentReference.contentdata";
+    readonly ContentHash: "DocumentReference.contenthash";
+    readonly ContentType: "DocumentReference.contenttype";
+    readonly Context: "DocumentReference.context";
+    readonly Creation: "DocumentReference.creation";
+    readonly Date: "DocumentReference.date";
+    readonly Description: "DocumentReference.description";
+    readonly EventCode: "DocumentReference.event-code";
+    readonly EventReference: "DocumentReference.event-reference";
+    readonly FormatUri: "DocumentReference.format-uri";
+    readonly Identifier: "DocumentReference.identifier";
+    readonly Language: "DocumentReference.language";
+    readonly Location: "DocumentReference.location";
+    readonly Modality: "DocumentReference.modality";
+    readonly RelatesTo: "DocumentReference.relatesto";
+    readonly Relation: "DocumentReference.relation";
+    readonly Subject: "DocumentReference.subject";
+    readonly Type: "DocumentReference.type";
+    readonly TypeText: "DocumentReference.type-text";
+    readonly TypeDisplay: "DocumentReference.type-display";
+    readonly UserSelected: "DocumentReference.user-selected";
+};
+export type DocumentReferenceClaimKey = typeof DocumentReferenceClaim[keyof typeof DocumentReferenceClaim];
+/**
+ * Human-readable reference for UI/docs generators.
+ * This is intentionally claims-first metadata and not a FHIR structure.
+ */
+export declare const DocumentReferenceClaimSpecs: ClaimSpec[];
+/**
+ * Optional mapping helper when converting claims-first payloads to strict FHIR JSON.
+ * Not used as canonical claim naming.
+ */
+export declare const DocumentReferenceClaimToFhirPath: Record<string, string | string[]>;

package/dist/claims/document-reference-claims.js

@@ -0,0 +1,96 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/document-reference-claims.ts
+// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
+export const DocumentReferenceClaim = {
+    Attester: 'DocumentReference.attester',
+    Author: 'DocumentReference.author',
+    BasedOn: 'DocumentReference.based-on',
+    Category: 'DocumentReference.category',
+    ContentData: 'DocumentReference.contentdata',
+    ContentHash: 'DocumentReference.contenthash',
+    ContentType: 'DocumentReference.contenttype',
+    Context: 'DocumentReference.context',
+    Creation: 'DocumentReference.creation',
+    Date: 'DocumentReference.date',
+    Description: 'DocumentReference.description',
+    EventCode: 'DocumentReference.event-code',
+    EventReference: 'DocumentReference.event-reference',
+    FormatUri: 'DocumentReference.format-uri',
+    Identifier: 'DocumentReference.identifier',
+    Language: 'DocumentReference.language',
+    Location: 'DocumentReference.location',
+    Modality: 'DocumentReference.modality',
+    RelatesTo: 'DocumentReference.relatesto',
+    Relation: 'DocumentReference.relation',
+    Subject: 'DocumentReference.subject',
+    Type: 'DocumentReference.type',
+    TypeText: 'DocumentReference.type-text',
+    TypeDisplay: 'DocumentReference.type-display',
+    UserSelected: 'DocumentReference.user-selected',
+};
+/**
+ * Human-readable reference for UI/docs generators.
+ * This is intentionally claims-first metadata and not a FHIR structure.
+ */
+export const DocumentReferenceClaimSpecs = [
+    { key: DocumentReferenceClaim.Attester, meaning: 'Attester value (DID or role: personal | professional | legal | official).', example: 'did:web:hospital.example.com:employee:adm-332' },
+    { key: DocumentReferenceClaim.Author, meaning: 'DID of the source author.', example: 'did:web:lab.example.com:system:lisin' },
+    { key: DocumentReferenceClaim.BasedOn, meaning: 'URL of the source FHIR resource.', example: 'https://ehr.example.com/fhir/ServiceRequest/sr-991' },
+    { key: DocumentReferenceClaim.Category, meaning: 'Higher-level document grouping.', example: 'http://hl7.org/fhir/ValueSet/document-classcodes|LP173418-7' },
+    { key: DocumentReferenceClaim.ContentData, meaning: 'Embedded attachment as base64.', example: 'JVBERi0xLjc...' },
+    { key: DocumentReferenceClaim.ContentHash, meaning: 'Attachment content hash/CID used for retrieval and integrity checks.', example: 'z4EBG9jDwAxbThHs9AMGBy6dTN1P9fGEcXq6tCm1ugw3pV89Nsc' },
+    { key: DocumentReferenceClaim.ContentType, meaning: 'Attachment MIME type.', example: 'application/pdf' },
+    { key: DocumentReferenceClaim.Context, meaning: 'Context such as Appointment | Encounter | EpisodeOfCare.', example: 'Encounter/enc-123' },
+    { key: DocumentReferenceClaim.Creation, meaning: 'When source information was created.', example: '2026-02-10T08:20:00Z' },
+    { key: DocumentReferenceClaim.Date, meaning: 'When this registration was attested.', example: '2026-02-10T10:05:33Z' },
+    { key: DocumentReferenceClaim.Description, meaning: 'Human-readable summary.', example: 'Vital signs report from home device' },
+    { key: DocumentReferenceClaim.EventCode, meaning: 'Main code for the source FHIR resource.', example: 'http://loinc.org|85354-9' },
+    { key: DocumentReferenceClaim.EventReference, meaning: 'URL of the source FHIR resource.', example: 'https://ehr.example.com/fhir/Observation/obs-778' },
+    { key: DocumentReferenceClaim.FormatUri, meaning: 'Attachment format URI.', example: 'urn:ihe:dent:PDF' },
+    { key: DocumentReferenceClaim.Identifier, meaning: 'Document identifier used for correlation.', example: 'docref-2026-00042' },
+    { key: DocumentReferenceClaim.Language, meaning: 'Language of attachment content.', example: 'en' },
+    { key: DocumentReferenceClaim.Location, meaning: 'Remote URL of attachment.', example: 'https://ehr.example.com/fhir/Binary/bin-123' },
+    { key: DocumentReferenceClaim.Modality, meaning: 'Imaging modality/equipment function.', example: 'http://dicom.nema.org/resources/ontology/DCM|CT' },
+    { key: DocumentReferenceClaim.RelatesTo, meaning: 'Reference to related/prior document.', example: 'DocumentReference/docref-00041' },
+    { key: DocumentReferenceClaim.Relation, meaning: 'Relation type to related document.', example: 'appends' },
+    { key: DocumentReferenceClaim.Subject, meaning: 'URN for the section in the individual index.', example: 'urn:uhix:section:vitals' },
+    { key: DocumentReferenceClaim.Type, meaning: 'Lower-level, sector-specific type.', example: 'http://hl7.org/fhir/ValueSet/c80-doc-typecodes|34133-9' },
+    { key: DocumentReferenceClaim.TypeText, meaning: 'Local-language document type label.', example: 'Resumen clínico' },
+    { key: DocumentReferenceClaim.TypeDisplay, meaning: 'Canonical/international document type display.', example: 'Patient summary Document' },
+    { key: DocumentReferenceClaim.UserSelected, meaning: 'Custom provenance flag telling whether the document was explicitly created or selected by the end user/controller.', example: 'true' },
+];
+/**
+ * Optional mapping helper when converting claims-first payloads to strict FHIR JSON.
+ * Not used as canonical claim naming.
+ */
+export const DocumentReferenceClaimToFhirPath = {
+    [DocumentReferenceClaim.Attester]: [
+        'DocumentReference.attester.party.reference',
+        'DocumentReference.attester.mode',
+    ],
+    [DocumentReferenceClaim.Author]: 'DocumentReference.author.reference',
+    [DocumentReferenceClaim.BasedOn]: 'DocumentReference.basedOn.reference',
+    [DocumentReferenceClaim.Category]: 'DocumentReference.category.coding',
+    [DocumentReferenceClaim.ContentData]: 'DocumentReference.content.attachment.data',
+    [DocumentReferenceClaim.ContentHash]: [
+        'DocumentReference.content.attachment.hash',
+        'DocumentReference.meta.versionId',
+    ],
+    [DocumentReferenceClaim.ContentType]: 'DocumentReference.content.attachment.contentType',
+    [DocumentReferenceClaim.Context]: 'DocumentReference.context',
+    [DocumentReferenceClaim.Creation]: 'DocumentReference.content.attachment.creation',
+    [DocumentReferenceClaim.Date]: 'DocumentReference.date',
+    [DocumentReferenceClaim.Description]: 'DocumentReference.description',
+    [DocumentReferenceClaim.EventCode]: 'DocumentReference.context.event.coding',
+    [DocumentReferenceClaim.EventReference]: 'DocumentReference.context.related.reference',
+    [DocumentReferenceClaim.FormatUri]: 'DocumentReference.content.format.code',
+    [DocumentReferenceClaim.Identifier]: 'DocumentReference.identifier.value',
+    [DocumentReferenceClaim.Language]: 'DocumentReference.content.attachment.language',
+    [DocumentReferenceClaim.Location]: 'DocumentReference.content.attachment.url',
+    [DocumentReferenceClaim.Modality]: 'DocumentReference.modality',
+    [DocumentReferenceClaim.RelatesTo]: 'DocumentReference.relatesTo.target.reference',
+    [DocumentReferenceClaim.Relation]: 'DocumentReference.relatesTo.code',
+    [DocumentReferenceClaim.Subject]: 'DocumentReference.subject.reference',
+    [DocumentReferenceClaim.Type]: 'DocumentReference.type.coding',
+    [DocumentReferenceClaim.UserSelected]: 'DocumentReference.user-selected',
+};

package/dist/claims/encounter-claims.d.ts

@@ -0,0 +1,18 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const EncounterClaim: {
+    readonly Identifier: "Encounter.identifier";
+    readonly Status: "Encounter.status";
+    readonly Class: "Encounter.class";
+    readonly Type: "Encounter.type";
+    readonly Subject: "Encounter.subject";
+    readonly Patient: "Encounter.patient";
+    readonly Participant: "Encounter.participant";
+    readonly ServiceProvider: "Encounter.service-provider";
+    readonly PeriodStart: "Encounter.period-start";
+    readonly PeriodEnd: "Encounter.period-end";
+    readonly ReasonCode: "Encounter.reason-code";
+    readonly Diagnosis: "Encounter.diagnosis";
+    readonly Location: "Encounter.location";
+};
+export type EncounterClaimKey = typeof EncounterClaim[keyof typeof EncounterClaim];
+export declare const EncounterClaimSpecs: ClaimSpec[];

package/dist/claims/encounter-claims.js

@@ -0,0 +1,32 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/encounter-claims.ts
+export const EncounterClaim = {
+    Identifier: 'Encounter.identifier',
+    Status: 'Encounter.status',
+    Class: 'Encounter.class',
+    Type: 'Encounter.type',
+    Subject: 'Encounter.subject',
+    Patient: 'Encounter.patient',
+    Participant: 'Encounter.participant',
+    ServiceProvider: 'Encounter.service-provider',
+    PeriodStart: 'Encounter.period-start',
+    PeriodEnd: 'Encounter.period-end',
+    ReasonCode: 'Encounter.reason-code',
+    Diagnosis: 'Encounter.diagnosis',
+    Location: 'Encounter.location',
+};
+export const EncounterClaimSpecs = [
+    { key: EncounterClaim.Identifier, meaning: 'Business identifier.', example: 'enc-001' },
+    { key: EncounterClaim.Status, meaning: 'Encounter status.', example: 'finished' },
+    { key: EncounterClaim.Class, meaning: 'Encounter class token.', example: 'http://terminology.hl7.org/CodeSystem/v3-ActCode|AMB' },
+    { key: EncounterClaim.Type, meaning: 'Encounter type token.', example: 'http://snomed.info/sct|185349003' },
+    { key: EncounterClaim.Subject, meaning: 'Canonical subject reference.', example: 'did:web:patient.example.org' },
+    { key: EncounterClaim.Patient, meaning: 'Patient alias reference.', example: 'did:web:patient.example.org' },
+    { key: EncounterClaim.Participant, meaning: 'Participant references (CSV).', example: 'Practitioner/prac-1' },
+    { key: EncounterClaim.ServiceProvider, meaning: 'Service provider reference.', example: 'Organization/org-1' },
+    { key: EncounterClaim.PeriodStart, meaning: 'Encounter start.', example: '2026-06-01T10:00:00Z' },
+    { key: EncounterClaim.PeriodEnd, meaning: 'Encounter end.', example: '2026-06-01T10:30:00Z' },
+    { key: EncounterClaim.ReasonCode, meaning: 'Reason code token.', example: 'http://snomed.info/sct|65363002' },
+    { key: EncounterClaim.Diagnosis, meaning: 'Diagnosis references (CSV).', example: 'Condition/cond-1' },
+    { key: EncounterClaim.Location, meaning: 'Location references (CSV).', example: 'Location/loc-1' },
+];

package/dist/claims/flag-claims.d.ts

@@ -0,0 +1,19 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const FlagClaim: {
+    readonly Author: "Flag.author";
+    readonly Date: "Flag.date";
+    readonly Encounter: "Flag.encounter";
+    readonly Identifier: "Flag.identifier";
+    readonly Patient: "Flag.patient";
+    readonly Subject: "Flag.subject";
+    readonly Status: "Flag.status";
+    readonly Category: "Flag.category";
+    readonly Code: "Flag.code";
+    readonly CodeText: "Flag.code-text";
+    readonly CodeTextLocal: "Flag.code-text";
+    readonly CodeDisplay: "Flag.code-display";
+    readonly PeriodStart: "Flag.period-start";
+    readonly PeriodEnd: "Flag.period-end";
+};
+export type FlagClaimKey = typeof FlagClaim[keyof typeof FlagClaim];
+export declare const FlagClaimSpecs: ClaimSpec[];

package/dist/claims/flag-claims.js

@@ -0,0 +1,33 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/flag-claims.ts
+export const FlagClaim = {
+    Author: 'Flag.author',
+    Date: 'Flag.date',
+    Encounter: 'Flag.encounter',
+    Identifier: 'Flag.identifier',
+    Patient: 'Flag.patient',
+    Subject: 'Flag.subject',
+    Status: 'Flag.status',
+    Category: 'Flag.category',
+    Code: 'Flag.code',
+    CodeText: 'Flag.code-text',
+    CodeTextLocal: 'Flag.code-text',
+    CodeDisplay: 'Flag.code-display',
+    PeriodStart: 'Flag.period-start',
+    PeriodEnd: 'Flag.period-end',
+};
+export const FlagClaimSpecs = [
+    { key: FlagClaim.Author, meaning: 'Author reference.', example: 'Practitioner/prac-1' },
+    { key: FlagClaim.Date, meaning: 'Flag issue date/time.', example: '2026-06-01T10:00:00Z' },
+    { key: FlagClaim.Encounter, meaning: 'Encounter reference.', example: 'Encounter/enc-1' },
+    { key: FlagClaim.Identifier, meaning: 'Business identifier.', example: 'flag-001' },
+    { key: FlagClaim.Patient, meaning: 'Patient reference.', example: 'did:web:patient.example.org' },
+    { key: FlagClaim.Subject, meaning: 'Canonical subject reference.', example: 'did:web:patient.example.org' },
+    { key: FlagClaim.Status, meaning: 'Flag status.', example: 'active' },
+    { key: FlagClaim.Category, meaning: 'Flag category token.', example: 'http://terminology.hl7.org/CodeSystem/flag-category|safety' },
+    { key: FlagClaim.Code, meaning: 'Flag code token.', example: 'http://loinc.org|104605-1' },
+    { key: FlagClaim.CodeText, meaning: 'Local-language alert name matching resource language.', example: 'Dieta sin marisco' },
+    { key: FlagClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Shellfish free diet' },
+    { key: FlagClaim.PeriodStart, meaning: 'Flag period start.', example: '2026-06-01T10:00:00Z' },
+    { key: FlagClaim.PeriodEnd, meaning: 'Flag period end.', example: '2026-07-01T10:00:00Z' },
+];

package/dist/claims/immunization-claims.d.ts

@@ -0,0 +1,31 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const ImmunizationClaim: {
+    readonly Date: "Immunization.date";
+    readonly Identifier: "Immunization.identifier";
+    readonly Location: "Immunization.location";
+    readonly LotNumber: "Immunization.lot-number";
+    readonly Manufacturer: "Immunization.manufacturer";
+    readonly Patient: "Immunization.patient";
+    readonly Performer: "Immunization.performer";
+    readonly ReactionDate: "Immunization.reaction-date";
+    readonly ReasonCode: "Immunization.reason-code";
+    readonly ReasonReference: "Immunization.reason-reference";
+    readonly Series: "Immunization.series";
+    readonly Status: "Immunization.status";
+    readonly StatusReason: "Immunization.status-reason";
+    readonly TargetDisease: "Immunization.target-disease";
+    readonly TargetDiseaseText: "Immunization.target-disease-text";
+    readonly TargetDiseaseDisplay: "Immunization.target-disease-display";
+    readonly VaccineCode: "Immunization.vaccine-code";
+    readonly VaccineCodeText: "Immunization.vaccine-code-text";
+    readonly VaccineCodeDisplay: "Immunization.vaccine-code-display";
+    readonly DoseSequence: "Immunization.dose-sequence";
+    readonly Subject: "Immunization.subject";
+    readonly Note: "Immunization.note";
+    readonly Route: "Immunization.route";
+    readonly RouteDisplay: "Immunization.route-display";
+    readonly Site: "Immunization.site";
+    readonly SiteDisplay: "Immunization.site-display";
+};
+export type ImmunizationClaimKey = typeof ImmunizationClaim[keyof typeof ImmunizationClaim];
+export declare const ImmunizationClaimSpecs: ClaimSpec[];

package/dist/claims/immunization-claims.js

@@ -0,0 +1,54 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/immunization-claims.ts
+export const ImmunizationClaim = {
+    Date: 'Immunization.date',
+    Identifier: 'Immunization.identifier',
+    Location: 'Immunization.location',
+    LotNumber: 'Immunization.lot-number',
+    Manufacturer: 'Immunization.manufacturer',
+    Patient: 'Immunization.patient',
+    Performer: 'Immunization.performer',
+    ReactionDate: 'Immunization.reaction-date',
+    ReasonCode: 'Immunization.reason-code',
+    ReasonReference: 'Immunization.reason-reference',
+    Series: 'Immunization.series',
+    Status: 'Immunization.status',
+    StatusReason: 'Immunization.status-reason',
+    TargetDisease: 'Immunization.target-disease',
+    TargetDiseaseText: 'Immunization.target-disease-text',
+    TargetDiseaseDisplay: 'Immunization.target-disease-display',
+    VaccineCode: 'Immunization.vaccine-code',
+    VaccineCodeText: 'Immunization.vaccine-code-text',
+    VaccineCodeDisplay: 'Immunization.vaccine-code-display',
+    DoseSequence: 'Immunization.dose-sequence',
+    Subject: 'Immunization.subject',
+    Note: 'Immunization.note',
+    Route: 'Immunization.route',
+    RouteDisplay: 'Immunization.route-display',
+    Site: 'Immunization.site',
+    SiteDisplay: 'Immunization.site-display',
+};
+export const ImmunizationClaimSpecs = [
+    { key: ImmunizationClaim.Date, meaning: 'Administration date/time.', example: '2026-06-01T10:00:00Z' },
+    { key: ImmunizationClaim.Identifier, meaning: 'Business identifier.', example: 'imm-001' },
+    { key: ImmunizationClaim.Location, meaning: 'Location reference.', example: 'Location/loc-1' },
+    { key: ImmunizationClaim.LotNumber, meaning: 'Vaccine lot number.', example: 'LOT-2026-01' },
+    { key: ImmunizationClaim.Manufacturer, meaning: 'Manufacturer reference.', example: 'Organization/org-vax' },
+    { key: ImmunizationClaim.Patient, meaning: 'Patient reference.', example: 'did:web:patient.example.org' },
+    { key: ImmunizationClaim.Performer, meaning: 'Performer references (CSV).', example: 'Practitioner/prac-1' },
+    { key: ImmunizationClaim.ReactionDate, meaning: 'Reaction date/time.', example: '2026-06-02T08:00:00Z' },
+    { key: ImmunizationClaim.ReasonCode, meaning: 'Reason code token.', example: 'http://snomed.info/sct|281647001' },
+    { key: ImmunizationClaim.ReasonReference, meaning: 'Reason reference.', example: 'Condition/cond-1' },
+    { key: ImmunizationClaim.Series, meaning: 'Vaccination series.', example: 'COVID primary series' },
+    { key: ImmunizationClaim.Status, meaning: 'Immunization status.', example: 'completed' },
+    { key: ImmunizationClaim.StatusReason, meaning: 'Status reason token.', example: 'http://terminology.hl7.org/CodeSystem/immunization-status-reason|expired' },
+    { key: ImmunizationClaim.TargetDisease, meaning: 'Target disease token.', example: 'http://snomed.info/sct|840539006' },
+    { key: ImmunizationClaim.TargetDiseaseText, meaning: 'Source-language target disease label.', example: 'Gripe' },
+    { key: ImmunizationClaim.TargetDiseaseDisplay, meaning: 'Canonical target disease display.', example: 'Influenza' },
+    { key: ImmunizationClaim.VaccineCode, meaning: 'Vaccine code token.', example: 'http://hl7.org/fhir/sid/cvx|207' },
+    { key: ImmunizationClaim.VaccineCodeText, meaning: 'Local-language vaccine label used by forms/UI.', example: 'Vacuna COVID-19' },
+    { key: ImmunizationClaim.VaccineCodeDisplay, meaning: 'Canonical/international vaccine display label.', example: 'COVID-19 vaccine' },
+    { key: ImmunizationClaim.DoseSequence, meaning: 'Dose sequence string.', example: '2' },
+    { key: ImmunizationClaim.Subject, meaning: 'Canonical subject reference.', example: 'did:web:patient.example.org' },
+    { key: ImmunizationClaim.Note, meaning: 'Clinical note text.', example: 'No adverse reaction recorded.' },
+];

package/dist/claims/immunization-recommendation-claims.d.ts

@@ -0,0 +1,19 @@
+import type { ClaimSpec } from './claim-types.js';
+/** Canonical flat claims used by a FHIR ImmunizationRecommendation graph entry. */
+export declare const ImmunizationRecommendationClaim: Readonly<{
+    readonly Identifier: "ImmunizationRecommendation.identifier";
+    readonly Patient: "ImmunizationRecommendation.patient";
+    readonly Date: "ImmunizationRecommendation.date";
+    readonly VaccineCode: "ImmunizationRecommendation.vaccine-code";
+    readonly ForecastStatus: "ImmunizationRecommendation.forecast-status";
+    readonly DateCriterionCode: "ImmunizationRecommendation.date-criterion-code";
+    readonly DateCriterionValue: "ImmunizationRecommendation.date-criterion-value";
+    readonly SupportingImmunization: "ImmunizationRecommendation.supporting-immunization";
+}>;
+export type ImmunizationRecommendationClaimKey = typeof ImmunizationRecommendationClaim[keyof typeof ImmunizationRecommendationClaim];
+/** Governed coding tokens authored by the neutral recommendation builder. */
+export declare const ImmunizationRecommendationCodes: Readonly<{
+    readonly ForecastDue: "http://terminology.hl7.org/CodeSystem/immunization-recommendation-status|due";
+    readonly RecommendedDate: "http://loinc.org|30980-7";
+}>;
+export declare const ImmunizationRecommendationClaimSpecs: readonly ClaimSpec[];

package/dist/claims/immunization-recommendation-claims.js

@@ -0,0 +1,26 @@
+/** Canonical flat claims used by a FHIR ImmunizationRecommendation graph entry. */
+export const ImmunizationRecommendationClaim = Object.freeze({
+    Identifier: 'ImmunizationRecommendation.identifier',
+    Patient: 'ImmunizationRecommendation.patient',
+    Date: 'ImmunizationRecommendation.date',
+    VaccineCode: 'ImmunizationRecommendation.vaccine-code',
+    ForecastStatus: 'ImmunizationRecommendation.forecast-status',
+    DateCriterionCode: 'ImmunizationRecommendation.date-criterion-code',
+    DateCriterionValue: 'ImmunizationRecommendation.date-criterion-value',
+    SupportingImmunization: 'ImmunizationRecommendation.supporting-immunization',
+});
+/** Governed coding tokens authored by the neutral recommendation builder. */
+export const ImmunizationRecommendationCodes = Object.freeze({
+    ForecastDue: 'http://terminology.hl7.org/CodeSystem/immunization-recommendation-status|due',
+    RecommendedDate: 'http://loinc.org|30980-7',
+});
+export const ImmunizationRecommendationClaimSpecs = Object.freeze([
+    { key: ImmunizationRecommendationClaim.Identifier, meaning: 'Recommendation business identifier.', example: 'urn:uuid:recommendation-1' },
+    { key: ImmunizationRecommendationClaim.Patient, meaning: 'Subject reference.', example: 'Patient/subject-1' },
+    { key: ImmunizationRecommendationClaim.Date, meaning: 'Recommendation creation date.', example: '2026-09-22' },
+    { key: ImmunizationRecommendationClaim.VaccineCode, meaning: 'Recommended vaccine coding token.', example: 'http://www.whocc.no/atc|J07BB02' },
+    { key: ImmunizationRecommendationClaim.ForecastStatus, meaning: 'FHIR forecast status coding token.', example: 'http://terminology.hl7.org/CodeSystem/immunization-recommendation-status|due' },
+    { key: ImmunizationRecommendationClaim.DateCriterionCode, meaning: 'Date criterion coding token.', example: 'http://loinc.org|30980-7' },
+    { key: ImmunizationRecommendationClaim.DateCriterionValue, meaning: 'Date criterion value.', example: '2026-12-21' },
+    { key: ImmunizationRecommendationClaim.SupportingImmunization, meaning: 'Supporting Immunization reference.', example: 'Immunization/immunization-1' },
+]);