gdc-common-utils-ts 2.9.18 → 2.9.19

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

@@ -5,8 +5,15 @@ import { codingFromValue, codingToValue, requireDidWeb, requireSubjectIdentifier
 export function allergyIntoleranceFlatToFhirR4(claims) {
     const patient = claims[AllergyIntoleranceClaim.Subject] ?? claims[AllergyIntoleranceClaim.Patient];
     const recorder = claims[AllergyIntoleranceClaim.Recorder];
+    const manifestation = claims[AllergyIntoleranceClaim.Manifestation];
+    const severity = claims[AllergyIntoleranceClaim.Severity];
+    const reactionOnset = claims[AllergyIntoleranceClaim.Onset];
+    const route = claims[AllergyIntoleranceClaim.Route];
     if (!patient)
         throw new Error(`Missing required claim: ${AllergyIntoleranceClaim.Subject}`);
+    if ((severity || reactionOnset || route) && !manifestation) {
+        throw new Error(`${severity ? AllergyIntoleranceClaim.Severity : reactionOnset ? AllergyIntoleranceClaim.Onset : AllergyIntoleranceClaim.Route} requires ${AllergyIntoleranceClaim.Manifestation}`);
+    }
     requireSubjectIdentifier(patient, AllergyIntoleranceClaim.Subject);
     if (recorder)
         requireDidWeb(recorder, AllergyIntoleranceClaim.Recorder);
@@ -31,13 +38,28 @@ export function allergyIntoleranceFlatToFhirR4(claims) {
         verificationStatus: claims[AllergyIntoleranceClaim.VerificationStatus] ? { coding: [{ code: claims[AllergyIntoleranceClaim.VerificationStatus] }] } : undefined,
         category: claims[AllergyIntoleranceClaim.Category] ? [claims[AllergyIntoleranceClaim.Category]] : undefined,
         criticality: claims[AllergyIntoleranceClaim.Criticality],
+        type: claims[AllergyIntoleranceClaim.Type],
         onsetDateTime: claims[AllergyIntoleranceClaim.OnsetDateTime],
+        recordedDate: claims[AllergyIntoleranceClaim.RecordedDate],
+        lastOccurrence: claims[AllergyIntoleranceClaim.LastOccurrence],
+        asserter: claims[AllergyIntoleranceClaim.Asserter]
+            ? { reference: claims[AllergyIntoleranceClaim.Asserter] }
+            : undefined,
         recorder: recorder ? { reference: recorder } : undefined,
+        reaction: manifestation ? [{
+                manifestation: [{ coding: codingFromValue(manifestation) }],
+                onset: reactionOnset,
+                severity,
+                exposureRoute: route ? { coding: codingFromValue(route) } : undefined,
+            }] : undefined,
     };
 }
 export function allergyIntoleranceFhirR4ToFlat(resource) {
     const subject = resource.patient?.reference;
     const code = resource.code;
+    const reaction = resource.reaction?.[0];
+    const manifestation = reaction?.manifestation?.[0];
+    const exposureRoute = reaction?.exposureRoute;
     return {
         [AllergyIntoleranceClaim.Identifier]: resource.identifier?.[0]?.value,
         [AllergyIntoleranceClaim.Subject]: subject,
@@ -49,7 +71,15 @@ export function allergyIntoleranceFhirR4ToFlat(resource) {
         [AllergyIntoleranceClaim.VerificationStatus]: resource.verificationStatus?.coding?.[0]?.code,
         [AllergyIntoleranceClaim.Category]: resource.category?.[0],
         [AllergyIntoleranceClaim.Criticality]: resource.criticality,
+        [AllergyIntoleranceClaim.Type]: resource.type,
         [AllergyIntoleranceClaim.OnsetDateTime]: resource.onsetDateTime,
+        [AllergyIntoleranceClaim.RecordedDate]: resource.recordedDate,
+        [AllergyIntoleranceClaim.LastOccurrence]: resource.lastOccurrence,
+        [AllergyIntoleranceClaim.Asserter]: resource.asserter?.reference,
+        [AllergyIntoleranceClaim.Manifestation]: codingToValue(manifestation?.coding?.[0]),
+        [AllergyIntoleranceClaim.Onset]: reaction?.onset,
+        [AllergyIntoleranceClaim.Route]: codingToValue(exposureRoute?.coding?.[0]),
+        [AllergyIntoleranceClaim.Severity]: reaction?.severity,
         [AllergyIntoleranceClaim.Recorder]: resource.recorder?.reference,
     };
 }

package/dist/convert/convert-medication-statement.js

@@ -5,7 +5,12 @@ import { codingFromValue, codingToValue, requireClaim } from './convert-shared.j
 export function medicationStatementFlatToFhirR4(claims) {
     const subject = requireClaim(claims, MedicationStatementClaim.Subject);
     const status = requireClaim(claims, MedicationStatementClaim.Status);
-    const effectiveDateTime = claims[MedicationStatementClaim.Effective];
+    const effectivePeriodEnd = claims[MedicationStatementClaim.EffectivePeriodEnd];
+    const effectivePeriodStart = claims[MedicationStatementClaim.EffectivePeriodStart]
+        || (effectivePeriodEnd ? claims[MedicationStatementClaim.Effective] : undefined);
+    const effectiveDateTime = effectivePeriodStart || effectivePeriodEnd
+        ? undefined
+        : claims[MedicationStatementClaim.Effective];
     const medicationText = claims[MedicationStatementClaim.CodeText]
         || claims[MedicationStatementClaim.MedicationText];
     const medicationReference = claims[MedicationStatementClaim.Medication];
@@ -42,7 +47,11 @@ export function medicationStatementFlatToFhirR4(claims) {
         identifier: claims[MedicationStatementClaim.Identifier] ? [{ value: claims[MedicationStatementClaim.Identifier] }] : undefined,
         status,
         subject: { reference: subject },
-        effectiveDateTime,
+        ...(effectiveDateTime ? { effectiveDateTime } : {}),
+        effectivePeriod: effectivePeriodStart || effectivePeriodEnd ? {
+            start: effectivePeriodStart,
+            end: effectivePeriodEnd,
+        } : undefined,
         medicationCodeableConcept: !medicationReference && !hasContainedMedication && claims[MedicationStatementClaim.Code]
             ? {
                 coding: codingFromValue(claims[MedicationStatementClaim.Code])?.map((coding) => ({
@@ -93,11 +102,14 @@ export function medicationStatementFhirR4ToFlat(resource) {
         : undefined;
     const routeCoding = dosage?.route?.coding?.[0];
     const doseQuantity = (dosage?.doseAndRate?.[0]?.doseQuantity);
+    const effectivePeriod = resource.effectivePeriod;
     return {
         [MedicationStatementClaim.Identifier]: resource.identifier?.[0]?.value,
         [MedicationStatementClaim.Subject]: resource.subject?.reference,
         [MedicationStatementClaim.Status]: resource.status,
         [MedicationStatementClaim.Effective]: resource.effectiveDateTime,
+        [MedicationStatementClaim.EffectivePeriodStart]: effectivePeriod?.start,
+        [MedicationStatementClaim.EffectivePeriodEnd]: effectivePeriod?.end,
         [MedicationStatementClaim.Code]: medicationCode,
         [MedicationStatementClaim.CodeText]: medicationText,
         [MedicationStatementClaim.Medication]: medicationReference?.startsWith('#') ? undefined : medicationReference,

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

@@ -1,4 +1,28 @@
 import type { ClaimSpec } from './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";
@@ -34,6 +58,14 @@ export declare const AllergyIntoleranceClaim: {
      */
     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";
 };
@@ -49,9 +81,24 @@ export declare enum AllergyIntoleranceClaimsFhirApi {
     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";
@@ -63,6 +110,14 @@ export declare const AllergyIntoleranceSearchParamNames: {
     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";
 };
@@ -79,6 +134,14 @@ export declare const AllergyIntoleranceClaimsFhirApiMap: {
     "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;
 };

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

@@ -1,6 +1,28 @@
 // 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',
@@ -36,6 +58,14 @@ export const AllergyIntoleranceClaim = {
      */
     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',
 };
@@ -51,9 +81,24 @@ export var AllergyIntoleranceClaimsFhirApi;
     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',
@@ -65,6 +110,14 @@ export const AllergyIntoleranceSearchParamNames = {
     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',
 };
@@ -79,6 +132,14 @@ export const AllergyIntoleranceSearchParamToClaimKey = {
     [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,
 };
@@ -93,6 +154,14 @@ export const AllergyIntoleranceClaimsFhirApiMap = {
     [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,
 };
@@ -111,7 +180,15 @@ export const AllergyIntoleranceClaimSpecs = [
     { 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: 'Criticality level.', example: 'high' },
+    { 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/models/interoperable-claims/medication-statement-claims.d.ts

@@ -32,6 +32,16 @@ export declare const MedicationStatementClaim: {
     readonly Status: "MedicationStatement.status";
     readonly Category: "MedicationStatement.category";
     readonly Effective: "MedicationStatement.effective";
+    /**
+     * Start of FHIR R4 `effectivePeriod`; mutually exclusive with `Effective`.
+     * @see https://hl7.org/fhir/R4/medicationstatement.html
+     */
+    readonly EffectivePeriodStart: "MedicationStatement.effective-period-start";
+    /**
+     * End of FHIR R4 `effectivePeriod`; mutually exclusive with `Effective`.
+     * @see https://hl7.org/fhir/R4/medicationstatement.html
+     */
+    readonly EffectivePeriodEnd: "MedicationStatement.effective-period-end";
     /** Official token SearchParameter `code`; maps to the medication concept, not a root FHIR element. */
     readonly Code: "MedicationStatement.code";
     /** Local/manual `CodeableConcept.text` companion for the medication concept. */

package/dist/models/interoperable-claims/medication-statement-claims.js

@@ -32,6 +32,16 @@ export const MedicationStatementClaim = {
     Status: 'MedicationStatement.status',
     Category: 'MedicationStatement.category',
     Effective: 'MedicationStatement.effective',
+    /**
+     * Start of FHIR R4 `effectivePeriod`; mutually exclusive with `Effective`.
+     * @see https://hl7.org/fhir/R4/medicationstatement.html
+     */
+    EffectivePeriodStart: 'MedicationStatement.effective-period-start',
+    /**
+     * End of FHIR R4 `effectivePeriod`; mutually exclusive with `Effective`.
+     * @see https://hl7.org/fhir/R4/medicationstatement.html
+     */
+    EffectivePeriodEnd: 'MedicationStatement.effective-period-end',
     /** Official token SearchParameter `code`; maps to the medication concept, not a root FHIR element. */
     Code: 'MedicationStatement.code',
     /** Local/manual `CodeableConcept.text` companion for the medication concept. */
@@ -112,6 +122,8 @@ export const MedicationStatementClaimSpecs = [
     { key: MedicationStatementClaim.Adherence, meaning: 'Official R5 adherence token SearchParameter.', example: `${MEDICATION_STATEMENT_ADHERENCE_CODE_SYSTEM}|taking-as-directed` },
     { key: MedicationStatementClaim.AdherenceText, meaning: 'Local/manual adherence CodeableConcept.text.', example: 'Tomando según indicación' },
     { key: MedicationStatementClaim.AdherenceDisplay, meaning: 'Canonical adherence Coding.display.', example: 'Taking As Directed' },
+    { key: MedicationStatementClaim.EffectivePeriodStart, meaning: 'Start of the medication treatment period.', example: '2026-09-01T08:00:00Z' },
+    { key: MedicationStatementClaim.EffectivePeriodEnd, meaning: 'End of the medication treatment period.', example: '2026-09-10T20:00:00Z' },
 ];
 /**
  * Flat claims contract for MedicationStatement using FHIR API-like search params.

package/dist/utils/allergy-intolerance-entry-editor.d.ts

@@ -1,4 +1,5 @@
 import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor.js';
+import { type AllergyIntoleranceCriticality, type AllergyIntoleranceReactionSeverity } from '../models/interoperable-claims/allergy-intolerance-claims.js';
 /**
  * Typed editor for one staged AllergyIntolerance resource entry.
  *
@@ -46,9 +47,17 @@ export declare class AllergyIntoleranceEntryEditor extends ClinicalResourceEntry
     /** Reads the allergy category. */
     getCategory(): string | undefined;
     /** Writes the allergy criticality. */
-    setCriticality(criticality?: string | null): this;
+    setCriticality(criticality?: AllergyIntoleranceCriticality | null): this;
     /** Reads the allergy criticality. */
-    getCriticality(): string | undefined;
+    getCriticality(): AllergyIntoleranceCriticality | undefined;
+    /** Writes the clinical manifestation required for a reaction event. */
+    setReactionManifestation(manifestation?: string | null): this;
+    /** Reads the clinical manifestation for the reaction event. */
+    getReactionManifestation(): string | undefined;
+    /** Writes reaction-event severity, which is distinct from potential future-risk criticality. */
+    setReactionSeverity(severity?: AllergyIntoleranceReactionSeverity | null): this;
+    /** Reads reaction-event severity. */
+    getReactionSeverity(): AllergyIntoleranceReactionSeverity | undefined;
     /** Writes the onset date/time. */
     setOnsetDateTime(value?: string | null): this;
     /** Reads the onset date/time. */

package/dist/utils/allergy-intolerance-entry-editor.js

@@ -1,5 +1,5 @@
 import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor.js';
-import { AllergyIntoleranceClaim } from '../models/interoperable-claims/allergy-intolerance-claims.js';
+import { AllergyIntoleranceClaim, } from '../models/interoperable-claims/allergy-intolerance-claims.js';
 import { BundleEditableResourceTypes } from '../models/bundle-editor-types.js';
 import { registerBundleEntryEditor } from './bundle-editor-registry.js';
 /**
@@ -50,6 +50,14 @@ export class AllergyIntoleranceEntryEditor extends ClinicalResourceEntryEditor {
     setCriticality(criticality) { return this.setScalarClaim(AllergyIntoleranceClaim.Criticality, criticality); }
     /** Reads the allergy criticality. */
     getCriticality() { return this.getScalarClaim(AllergyIntoleranceClaim.Criticality); }
+    /** Writes the clinical manifestation required for a reaction event. */
+    setReactionManifestation(manifestation) { return this.setScalarClaim(AllergyIntoleranceClaim.Manifestation, manifestation); }
+    /** Reads the clinical manifestation for the reaction event. */
+    getReactionManifestation() { return this.getScalarClaim(AllergyIntoleranceClaim.Manifestation); }
+    /** Writes reaction-event severity, which is distinct from potential future-risk criticality. */
+    setReactionSeverity(severity) { return this.setScalarClaim(AllergyIntoleranceClaim.Severity, severity); }
+    /** Reads reaction-event severity. */
+    getReactionSeverity() { return this.getScalarClaim(AllergyIntoleranceClaim.Severity); }
     /** Writes the onset date/time. */
     setOnsetDateTime(value) { return this.setScalarClaim(AllergyIntoleranceClaim.OnsetDateTime, value); }
     /** Reads the onset date/time. */

package/dist/utils/medication-statement-entry-editor.d.ts

@@ -31,6 +31,14 @@ export declare class MedicationStatementEntryEditor extends ClinicalResourceEntr
     setEffective(value?: string | null): this;
     /** Returns the effective date or period token. */
     getEffective(): string | undefined;
+    /** Sets the start of `effectivePeriod` and clears the mutually exclusive dateTime claim. */
+    setEffectivePeriodStart(value?: string | null): this;
+    /** Returns the start of `effectivePeriod`. */
+    getEffectivePeriodStart(): string | undefined;
+    /** Sets the end of `effectivePeriod`, promoting an existing dateTime value to the period start. */
+    setEffectivePeriodEnd(value?: string | null): this;
+    /** Returns the end of `effectivePeriod`. */
+    getEffectivePeriodEnd(): string | undefined;
     /** Sets the medication code from `code`, `system|code`, or separate `system, code` arguments. */
     setCode(code?: string | null): this;
     setCode(codeSystem: string, codeValue: string): this;

package/dist/utils/medication-statement-entry-editor.js

@@ -31,9 +31,34 @@ export class MedicationStatementEntryEditor extends ClinicalResourceEntryEditor
     /** Returns the medication statement status. */
     getStatus() { return this.getScalarClaim(MedicationStatementClaim.Status); }
     /** Sets the effective date or period token stored in the flat-claims model. */
-    setEffective(value) { return this.setScalarClaim(MedicationStatementClaim.Effective, value); }
+    setEffective(value) {
+        this.removeClaim(MedicationStatementClaim.EffectivePeriodStart);
+        this.removeClaim(MedicationStatementClaim.EffectivePeriodEnd);
+        return this.setScalarClaim(MedicationStatementClaim.Effective, value);
+    }
     /** Returns the effective date or period token. */
     getEffective() { return this.getScalarClaim(MedicationStatementClaim.Effective); }
+    /** Sets the start of `effectivePeriod` and clears the mutually exclusive dateTime claim. */
+    setEffectivePeriodStart(value) {
+        if (value?.trim())
+            this.removeClaim(MedicationStatementClaim.Effective);
+        return this.setScalarClaim(MedicationStatementClaim.EffectivePeriodStart, value);
+    }
+    /** Returns the start of `effectivePeriod`. */
+    getEffectivePeriodStart() { return this.getScalarClaim(MedicationStatementClaim.EffectivePeriodStart); }
+    /** Sets the end of `effectivePeriod`, promoting an existing dateTime value to the period start. */
+    setEffectivePeriodEnd(value) {
+        if (value?.trim()) {
+            const effective = this.getEffective();
+            if (effective && !this.getEffectivePeriodStart()) {
+                this.setScalarClaim(MedicationStatementClaim.EffectivePeriodStart, effective);
+            }
+            this.removeClaim(MedicationStatementClaim.Effective);
+        }
+        return this.setScalarClaim(MedicationStatementClaim.EffectivePeriodEnd, value);
+    }
+    /** Returns the end of `effectivePeriod`. */
+    getEffectivePeriodEnd() { return this.getScalarClaim(MedicationStatementClaim.EffectivePeriodEnd); }
     setCode(codeOrSystem, codeValue) { return this.setCodingTokenCode(MedicationStatementClaim.Code, codeOrSystem, codeValue); }
     /** Returns only the medication code value. */
     getCode() { return this.getCodingTokenCode(MedicationStatementClaim.Code); }

package/dist/utils/observation-entry-editor.d.ts

@@ -34,4 +34,11 @@ export declare class ObservationEntryEditor extends VitalSignEntryEditor {
     setHasMemberList(references: readonly string[]): this;
     /** Reads the has-member list. */
     getHasMemberList(): string[];
+    /**
+     * Writes the human-readable FHIR R4 `Observation.referenceRange.text` guidance.
+     * @see https://hl7.org/fhir/R4/observation.html
+     */
+    setReferenceRangeText(value?: string | null): this;
+    /** Reads the human-readable reference-range guidance. */
+    getReferenceRangeText(): string | undefined;
 }

package/dist/utils/observation-entry-editor.js

@@ -71,5 +71,16 @@ export class ObservationEntryEditor extends VitalSignEntryEditor {
     getHasMemberList() {
         return getClaimValues(this.getClaims(), ObservationClaim.HasMember);
     }
+    /**
+     * Writes the human-readable FHIR R4 `Observation.referenceRange.text` guidance.
+     * @see https://hl7.org/fhir/R4/observation.html
+     */
+    setReferenceRangeText(value) {
+        return this.setScalarClaim(ObservationClaim.ReferenceRangeText, value);
+    }
+    /** Reads the human-readable reference-range guidance. */
+    getReferenceRangeText() {
+        return this.getScalarClaim(ObservationClaim.ReferenceRangeText);
+    }
 }
 registerBundleEntryEditor(BundleEditableResourceTypes.observation, ObservationEntryEditor);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "2.9.18",
+  "version": "2.9.19",
   "publishConfig": {
     "access": "public"
   },