ezmedicationinput 0.1.46 → 0.1.48

package/dist/types.d.ts

@@ -18,9 +18,20 @@ export interface FhirExtension {
     extension?: FhirExtension[];
     valueCode?: string;
     valueString?: string;
+    valueBoolean?: boolean;
+    valueInteger?: number;
+    valueDecimal?: number;
+    valueQuantity?: FhirQuantity;
     valueCoding?: FhirCoding;
     valueCodeableConcept?: FhirCodeableConcept;
 }
+export interface FhirElement {
+    id?: string;
+    extension?: FhirExtension[];
+}
+export interface FhirBackboneElement extends FhirElement {
+    modifierExtension?: FhirExtension[];
+}
 export interface FhirPrimitiveElement {
     extension?: FhirExtension[];
 }
@@ -30,6 +41,38 @@ export interface FhirQuantity {
     system?: string;
     code?: string;
 }
+export type DoseUnitKind = "metric" | "biologic_unit" | "counted_presentation" | "device_actuation" | "infusion_rate" | "product_specific_amount" | "length_of_product" | "body_area_proxy" | "qualitative_amount";
+export type DoseUnitApproximationConfidence = "exact" | "approximate" | "product_specific";
+export interface DoseUnitApproximation {
+    value: number;
+    unit: string;
+    confidence: DoseUnitApproximationConfidence;
+    basis: string;
+    source?: string;
+}
+export interface DoseUnitTerminologyEntry {
+    unit: string;
+    kind: DoseUnitKind;
+    aliases?: string[];
+    /**
+     * Defaults to true. Use false for terminology entries such as infusion-rate
+     * units that should be exposed to consumers but must not be accepted as a
+     * doseQuantity unit until rateQuantity parsing is implemented.
+     */
+    parseAsDose?: boolean;
+    approximateQuantity?: DoseUnitApproximation;
+}
+export interface DoseUnitSemantics {
+    unit: string;
+    kind: DoseUnitKind;
+    parseAsDose?: boolean;
+    approximateQuantity?: DoseUnitApproximation;
+}
+export interface EstimatedQuantity extends FhirQuantity {
+    confidence?: DoseUnitApproximationConfidence;
+    basis?: string;
+    source?: string;
+}
 export interface FhirRange {
     low?: FhirQuantity;
     high?: FhirQuantity;
@@ -277,7 +320,7 @@ export interface FhirTiming {
     repeat?: FhirTimingRepeat;
     code?: FhirCodeableConcept;
 }
-export interface FhirDoseAndRate {
+export interface FhirDoseAndRate extends FhirBackboneElement {
     type?: FhirCodeableConcept;
     doseRange?: FhirRange;
     doseQuantity?: FhirQuantity;
@@ -285,7 +328,7 @@ export interface FhirDoseAndRate {
     rateRange?: FhirRange;
     rateQuantity?: FhirQuantity;
 }
-export interface FhirDosage {
+export interface FhirDosage extends FhirBackboneElement {
     text?: string;
     patientInstruction?: string;
     timing?: FhirTiming;
@@ -316,6 +359,18 @@ export interface MedicationContext {
     strengthQuantity?: FhirQuantity;
     strengthRatio?: FhirRatio;
     strengthCodeableConcept?: FhirCodeableConcept;
+    /**
+     * Canonical presentation/package unit for fractional package instructions
+     * such as "1/2 bottle". When the parsed dose unit matches this value,
+     * containerValue/containerUnit describe the inner amount held by one package.
+     */
+    packageUnit?: string;
+    /**
+     * Optional per-unit approximation overrides keyed by normalized dose unit
+     * (for example FTU, drop, pump, applicatorful). These are used only for
+     * estimated amount reporting; they do not rewrite the parsed dose unit.
+     */
+    unitApproximationMap?: Record<string, DoseUnitApproximation>;
     containerValue?: number;
     containerUnit?: string;
     defaultUnit?: string;
@@ -799,6 +854,8 @@ export interface ParseResult {
 export interface ParseNormalizedMeta {
     route?: RouteCode;
     unit?: string;
+    unitKind?: DoseUnitKind;
+    unitSemantics?: DoseUnitSemantics;
     site?: BodySiteDetail;
     method?: {
         text?: string;
@@ -939,6 +996,9 @@ export interface NextDueDoseOptions {
 export interface TotalUnitsResult {
     totalUnits: number;
     totalContainers?: number;
+    totalContainerQuantity?: FhirQuantity;
+    totalApproximateQuantity?: EstimatedQuantity;
+    totalApproximateIngredientQuantity?: EstimatedQuantity;
 }
 export interface TotalUnitsOptions extends NextDueDoseOptions {
     dosage: FhirDosage | FhirDosage[];

package/dist/unit-lexicon.d.ts

@@ -1,4 +1,8 @@
-import { ParseOptions } from "./types";
+import type { DoseUnitApproximation, DoseUnitKind, DoseUnitSemantics, DoseUnitTerminologyEntry, MedicationContext, ParseOptions } from "./types";
 export declare function normalizeUnit(token: string, options?: ParseOptions): string | undefined;
+export declare function getDoseUnitKind(unit: string | undefined): DoseUnitKind | undefined;
+export declare function getDoseUnitApproximation(unit: string | undefined, context?: MedicationContext | null): DoseUnitApproximation | undefined;
+export declare function getDoseUnitSemantics(unit: string | undefined, context?: MedicationContext | null): DoseUnitSemantics | undefined;
+export declare function listDoseUnitTerminology(): DoseUnitTerminologyEntry[];
 export declare function enforceHouseholdUnitPolicy(unit: string | undefined, options?: ParseOptions): string | undefined;
 export declare function isDiscreteUnit(unit: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ezmedicationinput",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "description": "Parse concise medication sigs into FHIR R5 Dosage JSON",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -14,11 +14,6 @@
       "default": "./dist/index.js"
     }
   },
-  "scripts": {
-    "test:dist": "npm run build && vitest run test-dist",
-    "build": "tsup && tsc -p tsconfig.types.json",
-    "test": "vitest run --dir test"
-  },
   "files": [
     "dist"
   ],
@@ -39,5 +34,10 @@
     "tsup": "^8.5.1",
     "typescript": "^5.4.0",
     "vitest": "^1.5.0"
+  },
+  "scripts": {
+    "test:dist": "npm run build && vitest run test-dist",
+    "build": "tsup && tsc -p tsconfig.types.json",
+    "test": "vitest run --dir test"
   }
-}
+}