ezmedicationinput 0.1.9 → 0.1.12

package/dist/types.d.ts

@@ -289,6 +289,64 @@ export interface FormatOptions {
     locale?: "en" | "th" | string;
     i18n?: SigTranslationConfig;
 }
+export interface BodySiteCode {
+    code: string;
+    display?: string;
+    system?: string;
+}
+export interface BodySiteDefinition {
+    coding: BodySiteCode;
+    text?: string;
+}
+export interface TextRange {
+    /** Inclusive start index of the matched substring within the original input. */
+    start: number;
+    /** Exclusive end index of the matched substring within the original input. */
+    end: number;
+}
+export interface SiteCodeLookupRequest {
+    /** Original site text preserved for debugging or auditing. */
+    originalText: string;
+    /**
+     * Sanitized site text used for human-readable output. Connectors and braces
+     * are stripped but casing is preserved.
+     */
+    text: string;
+    /** Lower-case variant of the text for case-insensitive lookups. */
+    normalized: string;
+    /** Canonical key generated by trimming and collapsing whitespace. */
+    canonical: string;
+    /** Indicates the text was wrapped in `{}` to request interactive lookup. */
+    isProbe: boolean;
+    /** Full original input string provided to the parser. */
+    inputText: string;
+    /**
+     * Substring captured directly from the original input, preserving spacing and
+     * casing. Undefined when a reliable slice cannot be determined.
+     */
+    sourceText?: string;
+    /** Location of {@link sourceText} relative to the original input. */
+    range?: TextRange;
+}
+export interface SiteCodeResolution extends BodySiteDefinition {
+}
+export interface SiteCodeSuggestion {
+    coding: BodySiteCode;
+    text?: string;
+}
+export interface SiteCodeSuggestionsResult {
+    suggestions: SiteCodeSuggestion[];
+}
+/**
+ * Site code resolvers can perform deterministic lookups or remote queries with
+ * access to the original sig text and extracted site range.
+ */
+export type SiteCodeResolver = (request: SiteCodeLookupRequest) => SiteCodeResolution | null | undefined | Promise<SiteCodeResolution | null | undefined>;
+/**
+ * Suggestion providers receive the same context as resolvers, including the
+ * caller's full input and the character range of the detected site phrase.
+ */
+export type SiteCodeSuggestionResolver = (request: SiteCodeLookupRequest) => SiteCodeSuggestionsResult | SiteCodeSuggestion[] | SiteCodeSuggestion | null | undefined | Promise<SiteCodeSuggestionsResult | SiteCodeSuggestion[] | SiteCodeSuggestion | null | undefined>;
 export interface ParseOptions extends FormatOptions {
     /**
      * Optional medication context that assists with default unit inference.
@@ -326,6 +384,23 @@ export interface ParseOptions extends FormatOptions {
      * and tablespoon when set to false. Defaults to true.
      */
     allowHouseholdVolumeUnits?: boolean;
+    /**
+     * Allows mapping normalized site phrases (e.g., "left arm") to
+     * institution-specific codings. Keys are normalized with the same logic as
+     * the default site dictionary (trimmed, lower-cased, collapsing whitespace).
+     */
+    siteCodeMap?: Record<string, BodySiteDefinition>;
+    /**
+     * Callback(s) that can translate detected site text into a coded body site.
+     * Return a promise when using asynchronous terminology services.
+     */
+    siteCodeResolvers?: SiteCodeResolver | SiteCodeResolver[];
+    /**
+     * Callback(s) that surface possible coded body sites for interactive flows
+     * when the parser cannot confidently resolve a site, or the input explicitly
+     * requested a lookup via `{site}` placeholders.
+     */
+    siteCodeSuggestionResolvers?: SiteCodeSuggestionResolver | SiteCodeSuggestionResolver[];
 }
 export interface ParseResult {
     fhir: FhirDosage;
@@ -338,7 +413,15 @@ export interface ParseResult {
         normalized: {
             route?: RouteCode;
             unit?: string;
+            site?: {
+                text?: string;
+                coding?: BodySiteCode;
+            };
         };
+        siteLookups?: Array<{
+            request: SiteCodeLookupRequest;
+            suggestions: SiteCodeSuggestion[];
+        }>;
     };
 }
 /**
@@ -375,6 +458,7 @@ export interface NextDueDoseOptions {
     from: Date | string;
     orderedAt?: Date | string;
     limit?: number;
+    priorCount?: number;
     timeZone?: string;
     eventClock?: EventClockMap;
     mealOffsets?: MealOffsetMap;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ezmedicationinput",
-  "version": "0.1.9",
+  "version": "0.1.12",
   "description": "Parse concise medication sigs into FHIR R5 Dosage JSON",
   "type": "module",
   "main": "dist/index.js",