fhir-data-utils-ts 0.2.4 → 0.3.2

package/dist/claim-helpers/claims-helpers-related-person.d.ts

@@ -0,0 +1,22 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type RelatedPersonInteroperableClaims = GenericInteroperableClaims;
+export declare function getRelatedPersonClaimList(claims: RelatedPersonInteroperableClaims, claimKey: string): string[];
+export declare function setRelatedPersonClaimList(claims: RelatedPersonInteroperableClaims, claimKey: string, values: string | readonly string[]): RelatedPersonInteroperableClaims;
+export declare function addRelatedPersonClaimList(claims: RelatedPersonInteroperableClaims, claimKey: string, values: string | readonly string[]): RelatedPersonInteroperableClaims;
+export declare function removeRelatedPersonClaimList(claims: RelatedPersonInteroperableClaims, claimKey: string, values: string | readonly string[]): RelatedPersonInteroperableClaims;
+export declare function getRelatedPersonIdentifier(claims: RelatedPersonInteroperableClaims): string;
+export declare function setRelatedPersonIdentifier(claims: RelatedPersonInteroperableClaims, value: string): RelatedPersonInteroperableClaims;
+/**
+ * Returns the current active flag as a boolean when present.
+ *
+ * Interoperability note:
+ * some callers persist the flag as a real boolean while others may carry the
+ * transport value as `"true"` / `"false"`. This helper normalizes both
+ * shapes.
+ */
+export declare function getRelatedPersonActive(claims: RelatedPersonInteroperableClaims): boolean | undefined;
+/**
+ * Sets the canonical active flag used by the current `RelatedPerson` lifecycle
+ * helpers.
+ */
+export declare function setRelatedPersonActive(claims: RelatedPersonInteroperableClaims, value: boolean): RelatedPersonInteroperableClaims;

package/dist/claim-helpers/claims-helpers-related-person.js

@@ -0,0 +1,53 @@
+import { RelatedPersonClaim } from '../claims/related-person-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getRelatedPersonClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setRelatedPersonClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addRelatedPersonClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeRelatedPersonClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getRelatedPersonIdentifier(claims) {
+    return normalizeClaimScalar(claims[RelatedPersonClaim.IdentifierValue]
+        ?? claims[RelatedPersonClaim.Identifier]);
+}
+export function setRelatedPersonIdentifier(claims, value) {
+    const normalizedValue = normalizeClaimScalar(value);
+    return {
+        ...claims,
+        [RelatedPersonClaim.IdentifierValue]: normalizedValue,
+    };
+}
+/**
+ * Returns the current active flag as a boolean when present.
+ *
+ * Interoperability note:
+ * some callers persist the flag as a real boolean while others may carry the
+ * transport value as `"true"` / `"false"`. This helper normalizes both
+ * shapes.
+ */
+export function getRelatedPersonActive(claims) {
+    const value = claims[RelatedPersonClaim.Active];
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'string') {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === 'true')
+            return true;
+        if (normalized === 'false')
+            return false;
+    }
+    return undefined;
+}
+/**
+ * Sets the canonical active flag used by the current `RelatedPerson` lifecycle
+ * helpers.
+ */
+export function setRelatedPersonActive(claims, value) {
+    return { ...claims, [RelatedPersonClaim.Active]: value };
+}

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>' },
+];