fhir-data-utils-ts 0.2.4 → 0.3.2

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

@@ -0,0 +1,59 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/care-plan-claims.ts
+export const CarePlanClaim = {
+    ActivityCode: 'CarePlan.activity-code',
+    ActivityDate: 'CarePlan.activity-date',
+    ActivityReference: 'CarePlan.activity-reference',
+    BasedOn: 'CarePlan.based-on',
+    CareTeam: 'CarePlan.care-team',
+    Category: 'CarePlan.category',
+    CategoryText: 'CarePlan.category-text',
+    CategoryDisplay: 'CarePlan.category-display',
+    Condition: 'CarePlan.condition',
+    Date: 'CarePlan.date',
+    Encounter: 'CarePlan.encounter',
+    Goal: 'CarePlan.goal',
+    Identifier: 'CarePlan.identifier',
+    Intent: 'CarePlan.intent',
+    PartOf: 'CarePlan.part-of',
+    Patient: 'CarePlan.patient',
+    Performer: 'CarePlan.performer',
+    Replaces: 'CarePlan.replaces',
+    Status: 'CarePlan.status',
+    Subject: 'CarePlan.subject',
+    Note: 'CarePlan.note',
+    Description: 'CarePlan.description',
+    PeriodStart: 'CarePlan.period-start',
+    PeriodEnd: 'CarePlan.period-end',
+    ActivityStatus: 'CarePlan.activity-status',
+    ActivityStatusReason: 'CarePlan.activity-status-reason',
+    ActivityDoNotPerform: 'CarePlan.activity-do-not-perform',
+    ActivityOutcome: 'CarePlan.activity-outcome',
+    ActivityLocationDisplay: 'CarePlan.activity-location-display',
+    ActivityTimingFrequency: 'CarePlan.activity-timing-frequency',
+    ActivityTimingPeriod: 'CarePlan.activity-timing-period',
+    ActivityTimingPeriodUnit: 'CarePlan.activity-timing-period-unit',
+};
+export const CarePlanClaimSpecs = [
+    { key: CarePlanClaim.ActivityCode, meaning: 'Planned activity code token.', example: 'http://snomed.info/sct|229065009' },
+    { key: CarePlanClaim.ActivityDate, meaning: 'Planned activity date/time.', example: '2026-06-15T09:00:00Z' },
+    { key: CarePlanClaim.ActivityReference, meaning: 'Activity reference.', example: 'ServiceRequest/sr-1' },
+    { key: CarePlanClaim.BasedOn, meaning: 'Based-on reference.', example: 'CarePlan/plan-parent' },
+    { key: CarePlanClaim.CareTeam, meaning: 'Care team references (CSV).', example: 'CareTeam/team-1' },
+    { key: CarePlanClaim.Category, meaning: 'Care plan category token.', example: 'http://snomed.info/sct|736373009' },
+    { key: CarePlanClaim.CategoryText, meaning: 'Local-language care plan category label.', example: 'Plan de control de peso' },
+    { key: CarePlanClaim.CategoryDisplay, meaning: 'Canonical/international care plan category display.', example: 'Weight management plan' },
+    { key: CarePlanClaim.Condition, meaning: 'Condition references (CSV).', example: 'Condition/cond-1' },
+    { key: CarePlanClaim.Date, meaning: 'Care plan creation or period date.', example: '2026-06-01T10:00:00Z' },
+    { key: CarePlanClaim.Encounter, meaning: 'Encounter reference.', example: 'Encounter/enc-1' },
+    { key: CarePlanClaim.Goal, meaning: 'Goal references (CSV).', example: 'Goal/goal-1' },
+    { key: CarePlanClaim.Identifier, meaning: 'Business identifier.', example: 'careplan-001' },
+    { key: CarePlanClaim.Intent, meaning: 'Care plan intent.', example: 'plan' },
+    { key: CarePlanClaim.PartOf, meaning: 'Parent care plan references (CSV).', example: 'CarePlan/plan-parent' },
+    { key: CarePlanClaim.Patient, meaning: 'Patient reference.', example: 'did:web:patient.example.org' },
+    { key: CarePlanClaim.Performer, meaning: 'Performer references (CSV).', example: 'Practitioner/prac-1' },
+    { key: CarePlanClaim.Replaces, meaning: 'Replaced care plan references (CSV).', example: 'CarePlan/old-plan' },
+    { key: CarePlanClaim.Status, meaning: 'Care plan status.', example: 'active' },
+    { key: CarePlanClaim.Subject, meaning: 'Canonical subject reference.', example: 'did:web:patient.example.org' },
+    { key: CarePlanClaim.Note, meaning: 'Clinical note text.', example: 'Daily home exercise plan.' },
+];

package/dist/claims/claim-types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Canonical interoperable-claims keys used by claims-first payloads.
+ * Keep this separated from strict FHIR resource typings.
+ */
+export type ClaimSpec = {
+    key: string;
+    meaning: string;
+    example: string;
+};

package/dist/claims/claim-types.js

@@ -0,0 +1,3 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/types.ts
+export {};

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

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

package/dist/claims/clinical-impression-claims.js

@@ -0,0 +1,30 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/clinical-impression-claims.ts
+export const ClinicalImpressionClaim = {
+    Identifier: 'ClinicalImpression.identifier',
+    Status: 'ClinicalImpression.status',
+    Description: 'ClinicalImpression.description',
+    Subject: 'ClinicalImpression.subject',
+    Encounter: 'ClinicalImpression.encounter',
+    EffectiveDateTime: 'ClinicalImpression.effective-datetime',
+    Date: 'ClinicalImpression.date',
+    Assessor: 'ClinicalImpression.assessor',
+    Problem: 'ClinicalImpression.problem',
+    Finding: 'ClinicalImpression.finding',
+    PrognosisCode: 'ClinicalImpression.prognosis-code',
+    Summary: 'ClinicalImpression.summary',
+};
+export const ClinicalImpressionClaimSpecs = [
+    { key: ClinicalImpressionClaim.Identifier, meaning: 'Business identifier.', example: 'ci-001' },
+    { key: ClinicalImpressionClaim.Status, meaning: 'Clinical impression status.', example: 'completed' },
+    { key: ClinicalImpressionClaim.Description, meaning: 'Narrative description.', example: 'Post-discharge review.' },
+    { key: ClinicalImpressionClaim.Subject, meaning: 'Canonical subject reference.', example: 'did:web:patient.example.org' },
+    { key: ClinicalImpressionClaim.Encounter, meaning: 'Encounter reference.', example: 'Encounter/enc-1' },
+    { key: ClinicalImpressionClaim.EffectiveDateTime, meaning: 'Effective assessment date/time.', example: '2026-06-01T10:00:00Z' },
+    { key: ClinicalImpressionClaim.Date, meaning: 'FHIR date field.', example: '2026-06-01T10:30:00Z' },
+    { key: ClinicalImpressionClaim.Assessor, meaning: 'Assessor reference.', example: 'Practitioner/prac-1' },
+    { key: ClinicalImpressionClaim.Problem, meaning: 'Problem references (CSV).', example: 'Condition/cond-1' },
+    { key: ClinicalImpressionClaim.Finding, meaning: 'Finding references (CSV).', example: 'Observation/obs-1' },
+    { key: ClinicalImpressionClaim.PrognosisCode, meaning: 'Prognosis token.', example: 'http://snomed.info/sct|271299001' },
+    { key: ClinicalImpressionClaim.Summary, meaning: 'Summary text.', example: 'Stable with mild fatigue.' },
+];

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

@@ -0,0 +1,55 @@
+/**
+ * Canonical flat claim keys for FHIR `Communication`.
+ *
+ * Good practice note:
+ * - any code, examples, scripts, or tests that write/read reusable
+ *   `Communication.*` claims must import these keys instead of re-hardcoding
+ *   string literals inline
+ * - legacy aliases such as `Communication.partOf` may still appear in
+ *   compatibility readers, but new code must use the canonical key constants
+ */
+export declare const CommunicationClaim: {
+    /** Communication category code (`system|code`). */
+    readonly Category: "Communication.category";
+    /** FHIR Communication status. */
+    readonly Status: "Communication.status";
+    /** Stable communication identifier. */
+    readonly Identifier: "Communication.identifier";
+    /** Subject identifier (typically `did:web`). */
+    readonly Subject: "Communication.subject";
+    /** Recipient identifier(s); CSV allowed. */
+    readonly Recipient: "Communication.recipient";
+    /** Sender identifier. */
+    readonly Sender: "Communication.sender";
+    /** Sent timestamp (ISO 8601 DateTime). */
+    readonly Sent: "Communication.sent";
+    /** Human note text for the communication context. */
+    readonly NoteText: "Communication.note-text";
+    /** Communication topic code (`system|code`). */
+    readonly Topic: "Communication.topic";
+    /** Narrative text (short summary or body). */
+    readonly Text: "Communication.text";
+    /** Related resource references; CSV allowed. */
+    readonly ContentReference: "Communication.content-reference";
+    /** Content code (`system|code`) when payload is coded. */
+    readonly ContentCode: "Communication.content-code";
+    /**
+     * Base64 encoded payload for attachment-based communication flows.
+     *
+     * Recommended lifecycle:
+     * - maintain the editable Bundle as object in memory
+     * - edit one active entry at a time (`fullUrl`, `resource`, `request`, ...)
+     * - re-serialize Bundle JSON to this claim after each save/update
+     * - treat this claim as derived data (never manual source of truth)
+     */
+    readonly ContentAttachmentData: "Communication.content-attachment-data";
+    /** Attachment MIME type (`application/fhir+json`, `application/pdf`, ...). */
+    readonly ContentAttachmentType: "Communication.content-attachment-type";
+    /** Attachment title for UI/readability contexts. */
+    readonly ContentAttachmentTitle: "Communication.content-attachment-title";
+    /** External attachment URL when payload is not embedded. */
+    readonly ContentAttachmentUrl: "Communication.content-attachment-url";
+    /** Parent communication thread/reference (`Communication.part-of`). */
+    readonly PartOf: "Communication.part-of";
+};
+export type CommunicationClaimKey = typeof CommunicationClaim[keyof typeof CommunicationClaim];

package/dist/claims/communication-claims.js

@@ -0,0 +1,57 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
+// File: src/models/interoperable-claims/communication-claims.ts
+/**
+ * Canonical flat claim keys for FHIR `Communication`.
+ *
+ * Good practice note:
+ * - any code, examples, scripts, or tests that write/read reusable
+ *   `Communication.*` claims must import these keys instead of re-hardcoding
+ *   string literals inline
+ * - legacy aliases such as `Communication.partOf` may still appear in
+ *   compatibility readers, but new code must use the canonical key constants
+ */
+export const CommunicationClaim = {
+    /** Communication category code (`system|code`). */
+    Category: 'Communication.category',
+    /** FHIR Communication status. */
+    Status: 'Communication.status',
+    /** Stable communication identifier. */
+    Identifier: 'Communication.identifier',
+    /** Subject identifier (typically `did:web`). */
+    Subject: 'Communication.subject',
+    /** Recipient identifier(s); CSV allowed. */
+    Recipient: 'Communication.recipient',
+    /** Sender identifier. */
+    Sender: 'Communication.sender',
+    /** Sent timestamp (ISO 8601 DateTime). */
+    Sent: 'Communication.sent',
+    /** Human note text for the communication context. */
+    NoteText: 'Communication.note-text',
+    /** Communication topic code (`system|code`). */
+    Topic: 'Communication.topic',
+    /** Narrative text (short summary or body). */
+    Text: 'Communication.text',
+    /** Related resource references; CSV allowed. */
+    ContentReference: 'Communication.content-reference',
+    /** Content code (`system|code`) when payload is coded. */
+    ContentCode: 'Communication.content-code',
+    /**
+     * Base64 encoded payload for attachment-based communication flows.
+     *
+     * Recommended lifecycle:
+     * - maintain the editable Bundle as object in memory
+     * - edit one active entry at a time (`fullUrl`, `resource`, `request`, ...)
+     * - re-serialize Bundle JSON to this claim after each save/update
+     * - treat this claim as derived data (never manual source of truth)
+     */
+    ContentAttachmentData: 'Communication.content-attachment-data',
+    /** Attachment MIME type (`application/fhir+json`, `application/pdf`, ...). */
+    ContentAttachmentType: 'Communication.content-attachment-type',
+    /** Attachment title for UI/readability contexts. */
+    ContentAttachmentTitle: 'Communication.content-attachment-title',
+    /** External attachment URL when payload is not embedded. */
+    ContentAttachmentUrl: 'Communication.content-attachment-url',
+    /** Parent communication thread/reference (`Communication.part-of`). */
+    PartOf: 'Communication.part-of'
+};

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

@@ -0,0 +1,27 @@
+export declare const CompositionClaim: {
+    readonly Subject: "Composition.subject";
+    readonly Section: "Composition.section";
+    readonly Author: "Composition.author";
+    /** CSV of Composition.attester.party references, aligned with AttesterMode and AttesterTime. */
+    readonly Attester: "Composition.attester";
+    /** CSV of required R4 Composition.attester.mode values, one per attester. */
+    readonly AttesterMode: "Composition.attester-mode";
+    /** CSV of optional R4 Composition.attester.time values, positionally aligned with AttesterMode. */
+    readonly AttesterTime: "Composition.attester-time";
+    /** Composition.custodian Organization reference. */
+    readonly Custodian: "Composition.custodian";
+    readonly Date: "Composition.date";
+    readonly Entry: "Composition.entry";
+    readonly Type: "Composition.type";
+    readonly Identifier: "Composition.identifier";
+    readonly Title: "Composition.title";
+};
+/** Canonical FHIR R4 Composition.attester.mode codes. */
+export declare const CompositionAttesterModes: Readonly<{
+    readonly Personal: "personal";
+    readonly Professional: "professional";
+    readonly Legal: "legal";
+    readonly Official: "official";
+}>;
+export type CompositionAttesterMode = typeof CompositionAttesterModes[keyof typeof CompositionAttesterModes];
+export type CompositionClaimKey = typeof CompositionClaim[keyof typeof CompositionClaim];

package/dist/claims/composition-claims.js

@@ -0,0 +1,27 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/composition-claims.ts
+export const CompositionClaim = {
+    Subject: 'Composition.subject',
+    Section: 'Composition.section',
+    Author: 'Composition.author',
+    /** CSV of Composition.attester.party references, aligned with AttesterMode and AttesterTime. */
+    Attester: 'Composition.attester',
+    /** CSV of required R4 Composition.attester.mode values, one per attester. */
+    AttesterMode: 'Composition.attester-mode',
+    /** CSV of optional R4 Composition.attester.time values, positionally aligned with AttesterMode. */
+    AttesterTime: 'Composition.attester-time',
+    /** Composition.custodian Organization reference. */
+    Custodian: 'Composition.custodian',
+    Date: 'Composition.date',
+    Entry: 'Composition.entry',
+    Type: 'Composition.type',
+    Identifier: 'Composition.identifier',
+    Title: 'Composition.title',
+};
+/** Canonical FHIR R4 Composition.attester.mode codes. */
+export const CompositionAttesterModes = Object.freeze({
+    Personal: 'personal',
+    Professional: 'professional',
+    Legal: 'legal',
+    Official: 'official',
+});

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

@@ -0,0 +1,79 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const ConditionClaim: {
+    readonly Identifier: "Condition.identifier";
+    readonly Subject: "Condition.subject";
+    readonly ClinicalStatus: "Condition.clinical-status";
+    readonly VerificationStatus: "Condition.verification-status";
+    readonly Category: "Condition.category";
+    readonly Code: "Condition.code";
+    /** Local-language label projected to FHIR `Condition.code.text`. */
+    readonly CodeText: "Condition.code-text";
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    readonly CodeTextLocal: "Condition.code-text";
+    /** English/international terminology label projected to `code.coding.display`. */
+    readonly CodeDisplay: "Condition.code-display";
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    readonly ContainedReferenceList: "Condition.contained-reference-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedResourceList: "Condition.contained-resource-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedDocuments: "Condition.contained-documents";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly AttachmentContentIds: "Condition.attachment-content-ids";
+    readonly Severity: "Condition.severity";
+    readonly OnsetDateTime: "Condition.onset-datetime";
+    readonly RecordedDate: "Condition.recorded-date";
+    readonly Asserter: "Condition.asserter";
+    readonly Recorder: "Condition.recorder";
+};
+export type ConditionClaimKey = typeof ConditionClaim[keyof typeof ConditionClaim];
+export declare enum ConditionClaimsFhirApi {
+    Identifier = "org.hl7.fhir.api.Condition.identifier",
+    Subject = "org.hl7.fhir.api.Condition.subject",
+    ClinicalStatus = "org.hl7.fhir.api.Condition.clinical-status",
+    VerificationStatus = "org.hl7.fhir.api.Condition.verification-status",
+    Category = "org.hl7.fhir.api.Condition.category",
+    Code = "org.hl7.fhir.api.Condition.code",
+    CodeText = "org.hl7.fhir.api.Condition.code-text",
+    CodeDisplay = "org.hl7.fhir.api.Condition.code-display",
+    Severity = "org.hl7.fhir.api.Condition.severity",
+    OnsetDateTime = "org.hl7.fhir.api.Condition.onset-datetime",
+    Recorder = "org.hl7.fhir.api.Condition.recorder"
+}
+export declare const ConditionSearchParamNames: {
+    readonly Identifier: "identifier";
+    readonly Subject: "subject";
+    readonly ClinicalStatus: "clinical-status";
+    readonly VerificationStatus: "verification-status";
+    readonly Category: "category";
+    readonly Code: "code";
+    readonly CodeText: "code-text";
+    readonly CodeDisplay: "code-display";
+    readonly Severity: "severity";
+    readonly OnsetDateTime: "onset-datetime";
+    readonly Recorder: "recorder";
+};
+export type ConditionSearchParamName = typeof ConditionSearchParamNames[keyof typeof ConditionSearchParamNames];
+export declare const ConditionSearchParamToClaimKey: Record<ConditionSearchParamName, ConditionClaimsFhirApi>;
+export declare const ConditionClaimsFhirApiMap: {
+    "org.hl7.fhir.api.Condition.identifier": StringConstructor;
+    "org.hl7.fhir.api.Condition.subject": StringConstructor;
+    "org.hl7.fhir.api.Condition.clinical-status": StringConstructor;
+    "org.hl7.fhir.api.Condition.verification-status": StringConstructor;
+    "org.hl7.fhir.api.Condition.category": StringConstructor;
+    "org.hl7.fhir.api.Condition.code": StringConstructor;
+    "org.hl7.fhir.api.Condition.code-text": StringConstructor;
+    "org.hl7.fhir.api.Condition.code-display": StringConstructor;
+    "org.hl7.fhir.api.Condition.severity": StringConstructor;
+    "org.hl7.fhir.api.Condition.onset-datetime": StringConstructor;
+    "org.hl7.fhir.api.Condition.recorder": StringConstructor;
+};
+export declare const ConditionClaimSpecs: ClaimSpec[];

package/dist/claims/condition-claims.js

@@ -0,0 +1,104 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/condition-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 ConditionClaim = {
+    Identifier: 'Condition.identifier',
+    Subject: 'Condition.subject',
+    ClinicalStatus: 'Condition.clinical-status',
+    VerificationStatus: 'Condition.verification-status',
+    Category: 'Condition.category',
+    Code: 'Condition.code',
+    /** Local-language label projected to FHIR `Condition.code.text`. */
+    CodeText: 'Condition.code-text',
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    CodeTextLocal: 'Condition.code-text',
+    /** English/international terminology label projected to `code.coding.display`. */
+    CodeDisplay: 'Condition.code-display',
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    ContainedReferenceList: 'Condition.contained-reference-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedResourceList: 'Condition.contained-resource-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedDocuments: 'Condition.contained-documents',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    AttachmentContentIds: 'Condition.attachment-content-ids',
+    Severity: 'Condition.severity',
+    OnsetDateTime: 'Condition.onset-datetime',
+    RecordedDate: 'Condition.recorded-date',
+    Asserter: 'Condition.asserter',
+    Recorder: 'Condition.recorder',
+};
+export var ConditionClaimsFhirApi;
+(function (ConditionClaimsFhirApi) {
+    ConditionClaimsFhirApi["Identifier"] = "org.hl7.fhir.api.Condition.identifier";
+    ConditionClaimsFhirApi["Subject"] = "org.hl7.fhir.api.Condition.subject";
+    ConditionClaimsFhirApi["ClinicalStatus"] = "org.hl7.fhir.api.Condition.clinical-status";
+    ConditionClaimsFhirApi["VerificationStatus"] = "org.hl7.fhir.api.Condition.verification-status";
+    ConditionClaimsFhirApi["Category"] = "org.hl7.fhir.api.Condition.category";
+    ConditionClaimsFhirApi["Code"] = "org.hl7.fhir.api.Condition.code";
+    ConditionClaimsFhirApi["CodeText"] = "org.hl7.fhir.api.Condition.code-text";
+    ConditionClaimsFhirApi["CodeDisplay"] = "org.hl7.fhir.api.Condition.code-display";
+    ConditionClaimsFhirApi["Severity"] = "org.hl7.fhir.api.Condition.severity";
+    ConditionClaimsFhirApi["OnsetDateTime"] = "org.hl7.fhir.api.Condition.onset-datetime";
+    ConditionClaimsFhirApi["Recorder"] = "org.hl7.fhir.api.Condition.recorder";
+})(ConditionClaimsFhirApi || (ConditionClaimsFhirApi = {}));
+export const ConditionSearchParamNames = {
+    Identifier: 'identifier',
+    Subject: 'subject',
+    ClinicalStatus: 'clinical-status',
+    VerificationStatus: 'verification-status',
+    Category: 'category',
+    Code: 'code',
+    CodeText: 'code-text',
+    CodeDisplay: 'code-display',
+    Severity: 'severity',
+    OnsetDateTime: 'onset-datetime',
+    Recorder: 'recorder',
+};
+export const ConditionSearchParamToClaimKey = {
+    [ConditionSearchParamNames.Identifier]: ConditionClaimsFhirApi.Identifier,
+    [ConditionSearchParamNames.Subject]: ConditionClaimsFhirApi.Subject,
+    [ConditionSearchParamNames.ClinicalStatus]: ConditionClaimsFhirApi.ClinicalStatus,
+    [ConditionSearchParamNames.VerificationStatus]: ConditionClaimsFhirApi.VerificationStatus,
+    [ConditionSearchParamNames.Category]: ConditionClaimsFhirApi.Category,
+    [ConditionSearchParamNames.Code]: ConditionClaimsFhirApi.Code,
+    [ConditionSearchParamNames.CodeText]: ConditionClaimsFhirApi.CodeText,
+    [ConditionSearchParamNames.CodeDisplay]: ConditionClaimsFhirApi.CodeDisplay,
+    [ConditionSearchParamNames.Severity]: ConditionClaimsFhirApi.Severity,
+    [ConditionSearchParamNames.OnsetDateTime]: ConditionClaimsFhirApi.OnsetDateTime,
+    [ConditionSearchParamNames.Recorder]: ConditionClaimsFhirApi.Recorder,
+};
+export const ConditionClaimsFhirApiMap = {
+    [ConditionClaimsFhirApi.Identifier]: String,
+    [ConditionClaimsFhirApi.Subject]: String,
+    [ConditionClaimsFhirApi.ClinicalStatus]: String,
+    [ConditionClaimsFhirApi.VerificationStatus]: String,
+    [ConditionClaimsFhirApi.Category]: String,
+    [ConditionClaimsFhirApi.Code]: String,
+    [ConditionClaimsFhirApi.CodeText]: String,
+    [ConditionClaimsFhirApi.CodeDisplay]: String,
+    [ConditionClaimsFhirApi.Severity]: String,
+    [ConditionClaimsFhirApi.OnsetDateTime]: String,
+    [ConditionClaimsFhirApi.Recorder]: String,
+};
+export const ConditionClaimSpecs = [
+    { key: ConditionClaim.Identifier, meaning: 'Business identifier for condition record.', example: 'COND-0001' },
+    { key: ConditionClaim.Subject, meaning: 'Patient subject reference.', example: 'Patient/pat-123' },
+    { key: ConditionClaim.ClinicalStatus, meaning: 'Clinical status code.', example: 'active' },
+    { key: ConditionClaim.VerificationStatus, meaning: 'Verification status code.', example: 'confirmed' },
+    { key: ConditionClaim.Category, meaning: 'Condition category code.', example: 'problem-list-item' },
+    { key: ConditionClaim.Code, meaning: 'Condition code.', example: 'http://snomed.info/sct|44054006' },
+    { key: ConditionClaim.CodeText, meaning: 'Local-language condition label matching the resource language.', example: 'Diabetes mellitus tipo 2' },
+    { key: ConditionClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Type 2 diabetes mellitus' },
+    { key: ConditionClaim.Severity, meaning: 'Condition severity code.', example: 'http://snomed.info/sct|24484000' },
+    { key: ConditionClaim.OnsetDateTime, meaning: 'Onset date/time.', example: '2026-01-03T09:30:00Z' },
+    { key: ConditionClaim.Recorder, meaning: 'Recorder reference.', example: 'Practitioner/prac-2' },
+];