fhir-data-utils-ts 0.2.4 → 0.3.1

package/dist/claim-helpers/index.d.ts

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

package/dist/claim-helpers/index.js

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

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

@@ -0,0 +1,153 @@
+import type { ClaimSpec } from './claim-types.js';
+/**
+ * FHIR R4 `AllergyIntolerance.criticality` codes describing potential future harm.
+ *
+ * @see https://hl7.org/fhir/R4/allergyintolerance.html
+ * @see https://build.fhir.org/ig/HL7/fhir-ips/en/StructureDefinition-AllergyIntolerance-uv-ips.html
+ */
+export declare const AllergyIntoleranceCriticalities: {
+    readonly Low: "low";
+    readonly High: "high";
+    readonly UnableToAssess: "unable-to-assess";
+};
+export type AllergyIntoleranceCriticality = typeof AllergyIntoleranceCriticalities[keyof typeof AllergyIntoleranceCriticalities];
+/**
+ * FHIR R4 `AllergyIntolerance.reaction.severity` codes for one observed reaction event.
+ *
+ * @see https://hl7.org/fhir/R4/valueset-reaction-event-severity.html
+ * @see https://build.fhir.org/ig/HL7/fhir-ips/en/StructureDefinition-AllergyIntolerance-uv-ips.html
+ */
+export declare const AllergyIntoleranceReactionSeverities: {
+    readonly Mild: "mild";
+    readonly Moderate: "moderate";
+    readonly Severe: "severe";
+};
+export type AllergyIntoleranceReactionSeverity = typeof AllergyIntoleranceReactionSeverities[keyof typeof AllergyIntoleranceReactionSeverities];
+export declare const AllergyIntoleranceClaim: {
+    readonly Identifier: "AllergyIntolerance.identifier";
+    readonly Subject: "AllergyIntolerance.subject";
+    /**
+     * @deprecated Use `AllergyIntolerance.subject`.
+     * Kept as compatibility alias because FHIR native field is `patient`.
+     */
+    readonly Patient: "AllergyIntolerance.patient";
+    readonly Code: "AllergyIntolerance.code";
+    /** Local-language label projected to FHIR `AllergyIntolerance.code.text`. */
+    readonly CodeText: "AllergyIntolerance.code-text";
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    readonly CodeTextLocal: "AllergyIntolerance.code-text";
+    /** English/international terminology label projected to `code.coding.display`. */
+    readonly CodeDisplay: "AllergyIntolerance.code-display";
+    readonly ClinicalStatus: "AllergyIntolerance.clinical-status";
+    readonly VerificationStatus: "AllergyIntolerance.verification-status";
+    readonly Category: "AllergyIntolerance.category";
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    readonly ContainedReferenceList: "AllergyIntolerance.contained-reference-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedResourceList: "AllergyIntolerance.contained-resource-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedDocuments: "AllergyIntolerance.contained-documents";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly AttachmentContentIds: "AllergyIntolerance.attachment-content-ids";
+    readonly Criticality: "AllergyIntolerance.criticality";
+    readonly Asserter: "AllergyIntolerance.asserter";
+    readonly RecordedDate: "AllergyIntolerance.date";
+    readonly LastOccurrence: "AllergyIntolerance.last-date";
+    readonly Manifestation: "AllergyIntolerance.manifestation";
+    readonly Onset: "AllergyIntolerance.onset";
+    readonly Route: "AllergyIntolerance.route";
+    readonly Severity: "AllergyIntolerance.severity";
+    readonly Type: "AllergyIntolerance.type";
+    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",
+    CodeText = "org.hl7.fhir.api.AllergyIntolerance.code-text",
+    CodeDisplay = "org.hl7.fhir.api.AllergyIntolerance.code-display",
+    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",
+    Asserter = "org.hl7.fhir.api.AllergyIntolerance.asserter",
+    Date = "org.hl7.fhir.api.AllergyIntolerance.date",
+    LastDate = "org.hl7.fhir.api.AllergyIntolerance.last-date",
+    Manifestation = "org.hl7.fhir.api.AllergyIntolerance.manifestation",
+    Onset = "org.hl7.fhir.api.AllergyIntolerance.onset",
+    Route = "org.hl7.fhir.api.AllergyIntolerance.route",
+    Severity = "org.hl7.fhir.api.AllergyIntolerance.severity",
+    Type = "org.hl7.fhir.api.AllergyIntolerance.type",
+    OnsetDateTime = "org.hl7.fhir.api.AllergyIntolerance.onset-datetime",
+    Recorder = "org.hl7.fhir.api.AllergyIntolerance.recorder"
+}
+/**
+ * Resource-specific FHIR R4 search parameters. UI presentation remains governed
+ * separately by the applicable IPS StructureDefinition and its obligations.
+ *
+ * @see https://hl7.org/fhir/R4/allergyintolerance.html#search
+ * @see https://build.fhir.org/ig/HL7/fhir-ips/en/CapabilityStatement-ips-server.html
+ */
+export declare const AllergyIntoleranceSearchParamNames: {
+    readonly Identifier: "identifier";
+    readonly Subject: "subject";
+    readonly Patient: "patient";
+    readonly Code: "code";
+    readonly CodeText: "code-text";
+    readonly CodeDisplay: "code-display";
+    readonly ClinicalStatus: "clinical-status";
+    readonly VerificationStatus: "verification-status";
+    readonly Category: "category";
+    readonly Criticality: "criticality";
+    readonly Asserter: "asserter";
+    readonly Date: "date";
+    readonly LastDate: "last-date";
+    readonly Manifestation: "manifestation";
+    readonly Onset: "onset";
+    readonly Route: "route";
+    readonly Severity: "severity";
+    readonly Type: "type";
+    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.code-text": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.code-display": 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.asserter": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.date": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.last-date": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.manifestation": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.onset": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.route": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.severity": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.type": 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.
+ * WHO ATC codes V01AA for Allergen extracts
+ */
+export declare const AllergyIntoleranceClaimSpecs: ClaimSpec[];

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

@@ -0,0 +1,194 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/allergy-intolerance-claims.ts
+// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
+/**
+ * FHIR R4 `AllergyIntolerance.criticality` codes describing potential future harm.
+ *
+ * @see https://hl7.org/fhir/R4/allergyintolerance.html
+ * @see https://build.fhir.org/ig/HL7/fhir-ips/en/StructureDefinition-AllergyIntolerance-uv-ips.html
+ */
+export const AllergyIntoleranceCriticalities = {
+    Low: 'low',
+    High: 'high',
+    UnableToAssess: 'unable-to-assess',
+};
+/**
+ * FHIR R4 `AllergyIntolerance.reaction.severity` codes for one observed reaction event.
+ *
+ * @see https://hl7.org/fhir/R4/valueset-reaction-event-severity.html
+ * @see https://build.fhir.org/ig/HL7/fhir-ips/en/StructureDefinition-AllergyIntolerance-uv-ips.html
+ */
+export const AllergyIntoleranceReactionSeverities = {
+    Mild: 'mild',
+    Moderate: 'moderate',
+    Severe: 'severe',
+};
+export const AllergyIntoleranceClaim = {
+    Identifier: 'AllergyIntolerance.identifier',
+    Subject: 'AllergyIntolerance.subject',
+    /**
+     * @deprecated Use `AllergyIntolerance.subject`.
+     * Kept as compatibility alias because FHIR native field is `patient`.
+     */
+    Patient: 'AllergyIntolerance.patient',
+    Code: 'AllergyIntolerance.code',
+    /** Local-language label projected to FHIR `AllergyIntolerance.code.text`. */
+    CodeText: 'AllergyIntolerance.code-text',
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    CodeTextLocal: 'AllergyIntolerance.code-text',
+    /** English/international terminology label projected to `code.coding.display`. */
+    CodeDisplay: 'AllergyIntolerance.code-display',
+    ClinicalStatus: 'AllergyIntolerance.clinical-status',
+    VerificationStatus: 'AllergyIntolerance.verification-status',
+    Category: 'AllergyIntolerance.category',
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    ContainedReferenceList: 'AllergyIntolerance.contained-reference-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedResourceList: 'AllergyIntolerance.contained-resource-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedDocuments: 'AllergyIntolerance.contained-documents',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    AttachmentContentIds: 'AllergyIntolerance.attachment-content-ids',
+    Criticality: 'AllergyIntolerance.criticality',
+    Asserter: 'AllergyIntolerance.asserter',
+    RecordedDate: 'AllergyIntolerance.date',
+    LastOccurrence: 'AllergyIntolerance.last-date',
+    Manifestation: 'AllergyIntolerance.manifestation',
+    Onset: 'AllergyIntolerance.onset',
+    Route: 'AllergyIntolerance.route',
+    Severity: 'AllergyIntolerance.severity',
+    Type: 'AllergyIntolerance.type',
+    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["CodeText"] = "org.hl7.fhir.api.AllergyIntolerance.code-text";
+    AllergyIntoleranceClaimsFhirApi["CodeDisplay"] = "org.hl7.fhir.api.AllergyIntolerance.code-display";
+    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["Asserter"] = "org.hl7.fhir.api.AllergyIntolerance.asserter";
+    AllergyIntoleranceClaimsFhirApi["Date"] = "org.hl7.fhir.api.AllergyIntolerance.date";
+    AllergyIntoleranceClaimsFhirApi["LastDate"] = "org.hl7.fhir.api.AllergyIntolerance.last-date";
+    AllergyIntoleranceClaimsFhirApi["Manifestation"] = "org.hl7.fhir.api.AllergyIntolerance.manifestation";
+    AllergyIntoleranceClaimsFhirApi["Onset"] = "org.hl7.fhir.api.AllergyIntolerance.onset";
+    AllergyIntoleranceClaimsFhirApi["Route"] = "org.hl7.fhir.api.AllergyIntolerance.route";
+    AllergyIntoleranceClaimsFhirApi["Severity"] = "org.hl7.fhir.api.AllergyIntolerance.severity";
+    AllergyIntoleranceClaimsFhirApi["Type"] = "org.hl7.fhir.api.AllergyIntolerance.type";
+    AllergyIntoleranceClaimsFhirApi["OnsetDateTime"] = "org.hl7.fhir.api.AllergyIntolerance.onset-datetime";
+    AllergyIntoleranceClaimsFhirApi["Recorder"] = "org.hl7.fhir.api.AllergyIntolerance.recorder";
+})(AllergyIntoleranceClaimsFhirApi || (AllergyIntoleranceClaimsFhirApi = {}));
+/**
+ * Resource-specific FHIR R4 search parameters. UI presentation remains governed
+ * separately by the applicable IPS StructureDefinition and its obligations.
+ *
+ * @see https://hl7.org/fhir/R4/allergyintolerance.html#search
+ * @see https://build.fhir.org/ig/HL7/fhir-ips/en/CapabilityStatement-ips-server.html
+ */
+export const AllergyIntoleranceSearchParamNames = {
+    Identifier: 'identifier',
+    Subject: 'subject',
+    Patient: 'patient',
+    Code: 'code',
+    CodeText: 'code-text',
+    CodeDisplay: 'code-display',
+    ClinicalStatus: 'clinical-status',
+    VerificationStatus: 'verification-status',
+    Category: 'category',
+    Criticality: 'criticality',
+    Asserter: 'asserter',
+    Date: 'date',
+    LastDate: 'last-date',
+    Manifestation: 'manifestation',
+    Onset: 'onset',
+    Route: 'route',
+    Severity: 'severity',
+    Type: 'type',
+    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.CodeText]: AllergyIntoleranceClaimsFhirApi.CodeText,
+    [AllergyIntoleranceSearchParamNames.CodeDisplay]: AllergyIntoleranceClaimsFhirApi.CodeDisplay,
+    [AllergyIntoleranceSearchParamNames.ClinicalStatus]: AllergyIntoleranceClaimsFhirApi.ClinicalStatus,
+    [AllergyIntoleranceSearchParamNames.VerificationStatus]: AllergyIntoleranceClaimsFhirApi.VerificationStatus,
+    [AllergyIntoleranceSearchParamNames.Category]: AllergyIntoleranceClaimsFhirApi.Category,
+    [AllergyIntoleranceSearchParamNames.Criticality]: AllergyIntoleranceClaimsFhirApi.Criticality,
+    [AllergyIntoleranceSearchParamNames.Asserter]: AllergyIntoleranceClaimsFhirApi.Asserter,
+    [AllergyIntoleranceSearchParamNames.Date]: AllergyIntoleranceClaimsFhirApi.Date,
+    [AllergyIntoleranceSearchParamNames.LastDate]: AllergyIntoleranceClaimsFhirApi.LastDate,
+    [AllergyIntoleranceSearchParamNames.Manifestation]: AllergyIntoleranceClaimsFhirApi.Manifestation,
+    [AllergyIntoleranceSearchParamNames.Onset]: AllergyIntoleranceClaimsFhirApi.Onset,
+    [AllergyIntoleranceSearchParamNames.Route]: AllergyIntoleranceClaimsFhirApi.Route,
+    [AllergyIntoleranceSearchParamNames.Severity]: AllergyIntoleranceClaimsFhirApi.Severity,
+    [AllergyIntoleranceSearchParamNames.Type]: AllergyIntoleranceClaimsFhirApi.Type,
+    [AllergyIntoleranceSearchParamNames.OnsetDateTime]: AllergyIntoleranceClaimsFhirApi.OnsetDateTime,
+    [AllergyIntoleranceSearchParamNames.Recorder]: AllergyIntoleranceClaimsFhirApi.Recorder,
+};
+export const AllergyIntoleranceClaimsFhirApiMap = {
+    [AllergyIntoleranceClaimsFhirApi.Identifier]: String,
+    [AllergyIntoleranceClaimsFhirApi.Subject]: String,
+    [AllergyIntoleranceClaimsFhirApi.Patient]: String,
+    [AllergyIntoleranceClaimsFhirApi.Code]: String,
+    [AllergyIntoleranceClaimsFhirApi.CodeText]: String,
+    [AllergyIntoleranceClaimsFhirApi.CodeDisplay]: String,
+    [AllergyIntoleranceClaimsFhirApi.ClinicalStatus]: String,
+    [AllergyIntoleranceClaimsFhirApi.VerificationStatus]: String,
+    [AllergyIntoleranceClaimsFhirApi.Category]: String,
+    [AllergyIntoleranceClaimsFhirApi.Criticality]: String,
+    [AllergyIntoleranceClaimsFhirApi.Asserter]: String,
+    [AllergyIntoleranceClaimsFhirApi.Date]: String,
+    [AllergyIntoleranceClaimsFhirApi.LastDate]: String,
+    [AllergyIntoleranceClaimsFhirApi.Manifestation]: String,
+    [AllergyIntoleranceClaimsFhirApi.Onset]: String,
+    [AllergyIntoleranceClaimsFhirApi.Route]: String,
+    [AllergyIntoleranceClaimsFhirApi.Severity]: String,
+    [AllergyIntoleranceClaimsFhirApi.Type]: 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.
+ * WHO ATC codes V01AA for Allergen extracts
+ */
+export const AllergyIntoleranceClaimSpecs = [
+    { key: AllergyIntoleranceClaim.Identifier, meaning: 'Business identifier for allergy record.', example: 'ALG-0001' },
+    { key: AllergyIntoleranceClaim.Subject, meaning: 'Canonical subject reference (maps to FHIR AllergyIntolerance.patient.reference).', example: 'urn:uuid:<UUID-V4>' },
+    { key: AllergyIntoleranceClaim.Patient, meaning: 'Deprecated alias of subject for compatibility.', example: 'urn:uuid:<UUID-V4>' },
+    { key: AllergyIntoleranceClaim.Code, meaning: 'Allergy or intolerance code.', example: 'http://snomed.info/sct|227493005' },
+    { key: AllergyIntoleranceClaim.CodeText, meaning: 'Local-language allergy label matching the resource language.', example: 'Penicilina' },
+    { key: AllergyIntoleranceClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Penicillin' },
+    { key: AllergyIntoleranceClaim.ClinicalStatus, meaning: 'Clinical status code.', example: 'active' },
+    { key: AllergyIntoleranceClaim.VerificationStatus, meaning: 'Verification status code.', example: 'confirmed' },
+    { key: AllergyIntoleranceClaim.Category, meaning: 'Category value.', example: 'food' },
+    { key: AllergyIntoleranceClaim.Criticality, meaning: 'Potential future harm if exposed to the substance.', example: AllergyIntoleranceCriticalities.High },
+    { key: AllergyIntoleranceClaim.Asserter, meaning: 'Source of the allergy assertion.', example: 'Practitioner/practitioner-123' },
+    { key: AllergyIntoleranceClaim.RecordedDate, meaning: 'Date the allergy record was first captured.', example: '2026-01-10T10:00:00Z' },
+    { key: AllergyIntoleranceClaim.LastOccurrence, meaning: 'Date of the most recent known reaction.', example: '2026-01-09T18:00:00Z' },
+    { key: AllergyIntoleranceClaim.Manifestation, meaning: 'Clinical manifestation of the reaction.', example: 'http://snomed.info/sct|247472004' },
+    { key: AllergyIntoleranceClaim.Onset, meaning: 'Searchable onset value for the allergy or reaction.', example: '2026-01-10' },
+    { key: AllergyIntoleranceClaim.Route, meaning: 'Exposure route for the reaction.', example: 'http://snomed.info/sct|26643006' },
+    { key: AllergyIntoleranceClaim.Severity, meaning: 'Severity of one observed reaction event, distinct from future-risk criticality.', example: AllergyIntoleranceReactionSeverities.Moderate },
+    { key: AllergyIntoleranceClaim.Type, meaning: 'Allergy or intolerance classification.', example: 'allergy' },
+    { key: AllergyIntoleranceClaim.OnsetDateTime, meaning: 'Onset date/time.', example: '2026-01-10T10:00:00Z' },
+    { key: AllergyIntoleranceClaim.Recorder, meaning: 'Recorder reference.', example: 'did:web:<domain>:organization:taxid:<TAXID>:member:<MEMBER_ID>:<roleCode>' },
+];

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

@@ -0,0 +1,226 @@
+/**
+ * Defines the flat claims structure for a FHIR Appointment resource, separating
+ * version-specific data model fields from version-agnostic API search parameters.
+ *
+ * This model aligns with FHIR R5 conventions (using `note.text` instead of `comment`)
+ * for forward compatibility and consistency with other resources like Communication.
+ *
+ */
+/**
+ * @deprecated Claims are never version-specific. Kept as a source-compatible
+ * alias whose values now use the expanded `org.hl7.fhir.api` vocabulary.
+ *
+ * @basedon https://www.hl7.org/fhir/R4/appointment.html
+ */
+export declare enum AppointmentClaimsFhirR4Core {
+    Identifier = "org.hl7.fhir.api.Appointment.identifier",
+    Status = "org.hl7.fhir.api.Appointment.status",
+    CancelationReason = "org.hl7.fhir.api.Appointment.cancelation-reason",
+    ServiceCategory = "org.hl7.fhir.api.Appointment.service-category",
+    ServiceType = "org.hl7.fhir.api.Appointment.service-type",
+    Specialty = "org.hl7.fhir.api.Appointment.specialty",
+    AppointmentType = "org.hl7.fhir.api.Appointment.appointment-type",
+    ReasonCode = "org.hl7.fhir.api.Appointment.reason-code",
+    ReasonReference = "org.hl7.fhir.api.Appointment.reason-reference",
+    Priority = "org.hl7.fhir.api.Appointment.priority",
+    Description = "org.hl7.fhir.api.Appointment.description",
+    SupportingInformation = "org.hl7.fhir.api.Appointment.supporting-information",
+    Start = "org.hl7.fhir.api.Appointment.start",
+    End = "org.hl7.fhir.api.Appointment.end",
+    MinutesDuration = "org.hl7.fhir.api.Appointment.minutes-duration",
+    Slot = "org.hl7.fhir.api.Appointment.slot",
+    Created = "org.hl7.fhir.api.Appointment.created",
+    NoteText = "org.hl7.fhir.api.Appointment.note-text",
+    PatientInstruction = "org.hl7.fhir.api.Appointment.patient-instruction",
+    BasedOn = "org.hl7.fhir.api.Appointment.based-on",
+    ParticipantActor = "org.hl7.fhir.api.Appointment.participant-actor",
+    ParticipantRequired = "org.hl7.fhir.api.Appointment.participant-required",
+    ParticipantStatus = "org.hl7.fhir.api.Appointment.participant-status",
+    ParticipantType = "org.hl7.fhir.api.Appointment.participant-type",
+    RequestedPeriod = "org.hl7.fhir.api.Appointment.requested-period",
+    ResourceId = "org.hl7.fhir.api.Appointment.resource-id"
+}
+/**
+ * Contains claims representing the standard, version-agnostic API search parameters for an Appointment.
+ *
+ * @basedon https://www.hl7.org/fhir/appointment.html#search
+ */
+export declare enum AppointmentClaimsFhirApi {
+    Actor = "org.hl7.fhir.api.Appointment.actor",
+    AppointmentType = "org.hl7.fhir.api.Appointment.appointment-type",
+    BasedOn = "org.hl7.fhir.api.Appointment.based-on",
+    Date = "org.hl7.fhir.api.Appointment.date",
+    Identifier = "org.hl7.fhir.api.Appointment.identifier",
+    Location = "org.hl7.fhir.api.Appointment.location",
+    PartStatus = "org.hl7.fhir.api.Appointment.part-status",
+    Patient = "org.hl7.fhir.api.Appointment.patient",
+    Practitioner = "org.hl7.fhir.api.Appointment.practitioner",
+    ReasonCode = "org.hl7.fhir.api.Appointment.reason-code",
+    ReasonReference = "org.hl7.fhir.api.Appointment.reason-reference",
+    ServiceCategory = "org.hl7.fhir.api.Appointment.service-category",
+    ServiceType = "org.hl7.fhir.api.Appointment.service-type",
+    Slot = "org.hl7.fhir.api.Appointment.slot",
+    Specialty = "org.hl7.fhir.api.Appointment.specialty",
+    Status = "org.hl7.fhir.api.Appointment.status",
+    SupportingInfo = "org.hl7.fhir.api.Appointment.supporting-info"
+}
+/**
+ * Extends the standard API search parameters with custom parameters derived from core data model fields.
+ */
+export declare enum AppointmentClaimsFhirApiExtended {
+    Actor = "org.hl7.fhir.api.Appointment.actor",
+    AppointmentType = "org.hl7.fhir.api.Appointment.appointment-type",
+    BasedOn = "org.hl7.fhir.api.Appointment.based-on",
+    Date = "org.hl7.fhir.api.Appointment.date",
+    Identifier = "org.hl7.fhir.api.Appointment.identifier",
+    Location = "org.hl7.fhir.api.Appointment.location",
+    PartStatus = "org.hl7.fhir.api.Appointment.part-status",
+    Patient = "org.hl7.fhir.api.Appointment.patient",
+    Practitioner = "org.hl7.fhir.api.Appointment.practitioner",
+    ReasonCode = "org.hl7.fhir.api.Appointment.reason-code",
+    ReasonReference = "org.hl7.fhir.api.Appointment.reason-reference",
+    ServiceCategory = "org.hl7.fhir.api.Appointment.service-category",
+    ServiceType = "org.hl7.fhir.api.Appointment.service-type",
+    Slot = "org.hl7.fhir.api.Appointment.slot",
+    Specialty = "org.hl7.fhir.api.Appointment.specialty",
+    Status = "org.hl7.fhir.api.Appointment.status",
+    SupportingInfo = "org.hl7.fhir.api.Appointment.supporting-info",
+    CancelationReason = "org.hl7.fhir.api.Appointment.cancelation-reason",
+    MinutesDuration = "org.hl7.fhir.api.Appointment.minutes-duration",
+    Priority = "org.hl7.fhir.api.Appointment.priority",
+    Created = "org.hl7.fhir.api.Appointment.created",
+    Description = "org.hl7.fhir.api.Appointment.description",
+    NoteText = "org.hl7.fhir.api.Appointment.note-text"
+}
+export declare const AppointmentClaimsFhirR4CoreMap: {
+    "org.hl7.fhir.api.Appointment.identifier": StringConstructor;
+    "org.hl7.fhir.api.Appointment.status": StringConstructor;
+    "org.hl7.fhir.api.Appointment.cancelation-reason": StringConstructor;
+    "org.hl7.fhir.api.Appointment.service-category": StringConstructor;
+    "org.hl7.fhir.api.Appointment.service-type": StringConstructor;
+    "org.hl7.fhir.api.Appointment.specialty": StringConstructor;
+    "org.hl7.fhir.api.Appointment.appointment-type": StringConstructor;
+    "org.hl7.fhir.api.Appointment.reason-code": StringConstructor;
+    "org.hl7.fhir.api.Appointment.reason-reference": StringConstructor;
+    "org.hl7.fhir.api.Appointment.priority": NumberConstructor;
+    "org.hl7.fhir.api.Appointment.description": StringConstructor;
+    "org.hl7.fhir.api.Appointment.supporting-information": StringConstructor;
+    "org.hl7.fhir.api.Appointment.start": StringConstructor;
+    "org.hl7.fhir.api.Appointment.end": StringConstructor;
+    "org.hl7.fhir.api.Appointment.minutes-duration": NumberConstructor;
+    "org.hl7.fhir.api.Appointment.slot": StringConstructor;
+    "org.hl7.fhir.api.Appointment.created": StringConstructor;
+    "org.hl7.fhir.api.Appointment.note-text": StringConstructor;
+    "org.hl7.fhir.api.Appointment.patient-instruction": StringConstructor;
+    "org.hl7.fhir.api.Appointment.based-on": StringConstructor;
+    "org.hl7.fhir.api.Appointment.participant-actor": StringConstructor;
+    "org.hl7.fhir.api.Appointment.participant-required": StringConstructor;
+    "org.hl7.fhir.api.Appointment.participant-status": StringConstructor;
+    "org.hl7.fhir.api.Appointment.participant-type": StringConstructor;
+    "org.hl7.fhir.api.Appointment.requested-period": StringConstructor;
+    "org.hl7.fhir.api.Appointment.resource-id": StringConstructor;
+};
+export declare const AppointmentClaimsFhirApiMap: {
+    "org.hl7.fhir.api.Appointment.actor": StringConstructor;
+    "org.hl7.fhir.api.Appointment.appointment-type": StringConstructor;
+    "org.hl7.fhir.api.Appointment.based-on": StringConstructor;
+    "org.hl7.fhir.api.Appointment.date": StringConstructor;
+    "org.hl7.fhir.api.Appointment.identifier": StringConstructor;
+    "org.hl7.fhir.api.Appointment.location": StringConstructor;
+    "org.hl7.fhir.api.Appointment.part-status": StringConstructor;
+    "org.hl7.fhir.api.Appointment.patient": StringConstructor;
+    "org.hl7.fhir.api.Appointment.practitioner": StringConstructor;
+    "org.hl7.fhir.api.Appointment.reason-code": StringConstructor;
+    "org.hl7.fhir.api.Appointment.reason-reference": StringConstructor;
+    "org.hl7.fhir.api.Appointment.service-category": StringConstructor;
+    "org.hl7.fhir.api.Appointment.service-type": StringConstructor;
+    "org.hl7.fhir.api.Appointment.slot": StringConstructor;
+    "org.hl7.fhir.api.Appointment.specialty": StringConstructor;
+    "org.hl7.fhir.api.Appointment.status": StringConstructor;
+    "org.hl7.fhir.api.Appointment.supporting-info": StringConstructor;
+};
+export declare const AppointmentClaimsFhirApiExtendedMap: {
+    "org.hl7.fhir.api.Appointment.cancelation-reason": StringConstructor;
+    "org.hl7.fhir.api.Appointment.minutes-duration": NumberConstructor;
+    "org.hl7.fhir.api.Appointment.priority": NumberConstructor;
+    "org.hl7.fhir.api.Appointment.created": StringConstructor;
+    "org.hl7.fhir.api.Appointment.description": StringConstructor;
+    "org.hl7.fhir.api.Appointment.note-text": StringConstructor;
+    "org.hl7.fhir.api.Appointment.actor": StringConstructor;
+    "org.hl7.fhir.api.Appointment.appointment-type": StringConstructor;
+    "org.hl7.fhir.api.Appointment.based-on": StringConstructor;
+    "org.hl7.fhir.api.Appointment.date": StringConstructor;
+    "org.hl7.fhir.api.Appointment.identifier": StringConstructor;
+    "org.hl7.fhir.api.Appointment.location": StringConstructor;
+    "org.hl7.fhir.api.Appointment.part-status": StringConstructor;
+    "org.hl7.fhir.api.Appointment.patient": StringConstructor;
+    "org.hl7.fhir.api.Appointment.practitioner": StringConstructor;
+    "org.hl7.fhir.api.Appointment.reason-code": StringConstructor;
+    "org.hl7.fhir.api.Appointment.reason-reference": StringConstructor;
+    "org.hl7.fhir.api.Appointment.service-category": StringConstructor;
+    "org.hl7.fhir.api.Appointment.service-type": StringConstructor;
+    "org.hl7.fhir.api.Appointment.slot": StringConstructor;
+    "org.hl7.fhir.api.Appointment.specialty": StringConstructor;
+    "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.actor";
+    readonly ParticipantStatus: "Appointment.part-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
+ * @basedon http://hl7.org/fhir/valueset-appointmentstatus.html
+ */
+export declare enum AppointmentStatus {
+    Proposed = "proposed",
+    Pending = "pending",
+    Booked = "booked",
+    Arrived = "arrived",
+    Fulfilled = "fulfilled",
+    Cancelled = "cancelled",
+    NoShow = "noshow",
+    EnteredInError = "entered-in-error",
+    CheckedIn = "checked-in",
+    Waitlist = "waitlist"
+}
+/**
+ * Defines the possible values for the `participant.required` field on a FHIR Appointment resource.
+ * @basedon http://hl7.org/fhir/R4/appointment.html#participant
+ * @basedon http://hl7.org/fhir/valueset-participantrequired.html
+ */
+export declare enum AppointmentParticipantRequired {
+    Required = "required",
+    Optional = "optional",
+    InformationOnly = "information-only"
+}
+/**
+ * Defines the possible values for the `participant.status` field on a FHIR Appointment resource.
+ * @basedon http://hl7.org/fhir/R4/appointment.html#participant
+ * @basedon http://hl7.org/fhir/valueset-participationstatus.html
+ */
+export declare enum AppointmentParticipantStatus {
+    Accepted = "accepted",
+    Declined = "declined",
+    Tentative = "tentative",
+    NeedsAction = "needs-action"
+}