ezmedicationinput 0.1.0 → 0.1.2

package/dist/suggest.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestSig = suggestSig;
+const context_1 = require("./context");
+const DEFAULT_LIMIT = 10;
+const DEFAULT_UNIT_ROUTE_ORDER = [
+    { unit: "tab", route: "po" },
+    { unit: "cap", route: "po" },
+    { unit: "mL", route: "po" },
+    { unit: "mg", route: "po" },
+    { unit: "puff", route: "inh" },
+    { unit: "spray", route: "in" },
+    { unit: "drop", route: "oph" },
+    { unit: "suppository", route: "pr" },
+    { unit: "patch", route: "transdermal" },
+    { unit: "g", route: "topical" }
+];
+const DEFAULT_ROUTE_BY_UNIT = {
+    tab: "po",
+    tabs: "po",
+    tablet: "po",
+    cap: "po",
+    capsule: "po",
+    ml: "po",
+    mg: "po",
+    puff: "inh",
+    puffs: "inh",
+    spray: "in",
+    sprays: "in",
+    drop: "oph",
+    drops: "oph",
+    suppository: "pr",
+    suppositories: "pr",
+    patch: "transdermal",
+    patches: "transdermal",
+    g: "topical"
+};
+const FREQUENCY_CODES = ["qd", "bid", "tid", "qid"];
+const INTERVAL_CODES = ["q4h", "q6h", "q8h"];
+const WHEN_TOKENS = ["ac", "pc", "hs", "am", "pm"];
+const CORE_WHEN_TOKENS = ["pc", "ac", "hs"];
+const FREQUENCY_NUMBERS = [1, 2, 3, 4];
+const FREQ_TOKEN_BY_NUMBER = {
+    1: "qd",
+    2: "bid",
+    3: "tid",
+    4: "qid",
+};
+const DEFAULT_PRN_REASONS = [
+    "pain",
+    "nausea",
+    "itching",
+    "anxiety",
+    "sleep",
+    "cough",
+    "fever",
+    "spasm",
+    "constipation",
+    "dyspnea",
+];
+const DEFAULT_DOSE_COUNTS = ["1", "2"];
+function normalizeKey(value) {
+    return value.trim().toLowerCase();
+}
+function normalizeSpacing(value) {
+    return value
+        .trim()
+        .replace(/\s+/g, " ");
+}
+function buildUnitRoutePairs(contextUnit) {
+    const pairs = [];
+    const seen = new Set();
+    const addPair = (unit, route) => {
+        var _a;
+        if (!unit) {
+            return;
+        }
+        const cleanUnit = unit.trim();
+        if (!cleanUnit) {
+            return;
+        }
+        const normalizedUnit = cleanUnit.toLowerCase();
+        const resolvedRoute = (_a = route !== null && route !== void 0 ? route : DEFAULT_ROUTE_BY_UNIT[normalizedUnit]) !== null && _a !== void 0 ? _a : "po";
+        const key = `${normalizedUnit}::${resolvedRoute.toLowerCase()}`;
+        if (seen.has(key)) {
+            return;
+        }
+        seen.add(key);
+        pairs.push({ unit: cleanUnit, route: resolvedRoute });
+    };
+    if (contextUnit) {
+        const normalized = normalizeKey(contextUnit);
+        addPair(contextUnit, DEFAULT_ROUTE_BY_UNIT[normalized]);
+    }
+    for (const pair of DEFAULT_UNIT_ROUTE_ORDER) {
+        addPair(pair.unit, pair.route);
+    }
+    return pairs;
+}
+function buildPrnReasons(customReasons) {
+    const reasons = new Set();
+    const add = (reason) => {
+        if (!reason) {
+            return;
+        }
+        const normalized = normalizeSpacing(reason.toLowerCase());
+        if (!normalized) {
+            return;
+        }
+        reasons.add(normalized);
+    };
+    if (customReasons) {
+        for (const reason of customReasons) {
+            add(reason);
+        }
+    }
+    for (const reason of DEFAULT_PRN_REASONS) {
+        add(reason);
+    }
+    return [...reasons];
+}
+function extractDoseValuesFromInput(input) {
+    const matches = input.match(/\d+(?:\.\d+)?(?:\/\d+(?:\.\d+)?)?/g);
+    if (!matches) {
+        return [];
+    }
+    const values = new Set();
+    for (const match of matches) {
+        if (!match) {
+            continue;
+        }
+        values.add(match);
+    }
+    return [...values];
+}
+function buildDoseValues(input) {
+    const dynamicValues = extractDoseValuesFromInput(input);
+    const values = new Set();
+    for (const value of dynamicValues) {
+        values.add(value);
+    }
+    for (const value of DEFAULT_DOSE_COUNTS) {
+        values.add(value);
+    }
+    return [...values];
+}
+function generateCandidateSignatures(pairs, doseValues, prnReasons) {
+    const suggestions = [];
+    const seen = new Set();
+    const push = (value) => {
+        const normalized = normalizeSpacing(value);
+        if (!normalized) {
+            return;
+        }
+        const key = normalizeKey(normalized);
+        if (seen.has(key)) {
+            return;
+        }
+        seen.add(key);
+        suggestions.push(normalized);
+    };
+    for (const pair of pairs) {
+        for (const code of FREQUENCY_CODES) {
+            for (const dose of doseValues) {
+                push(`${dose} ${pair.unit} ${pair.route} ${code}`);
+            }
+            push(`${pair.route} ${code}`);
+        }
+        for (const interval of INTERVAL_CODES) {
+            for (const dose of doseValues) {
+                push(`${dose} ${pair.unit} ${pair.route} ${interval}`);
+                for (const reason of prnReasons) {
+                    push(`${dose} ${pair.unit} ${pair.route} ${interval} prn ${reason}`);
+                }
+            }
+            push(`${pair.route} ${interval}`);
+        }
+        for (const freq of FREQUENCY_NUMBERS) {
+            const freqToken = FREQ_TOKEN_BY_NUMBER[freq];
+            push(`1x${freq} ${pair.route} ${freqToken}`);
+            for (const when of CORE_WHEN_TOKENS) {
+                push(`1x${freq} ${pair.route} ${when}`);
+            }
+        }
+        for (const when of WHEN_TOKENS) {
+            for (const dose of doseValues) {
+                push(`${dose} ${pair.unit} ${pair.route} ${when}`);
+            }
+            push(`${pair.route} ${when}`);
+        }
+        for (const reason of prnReasons) {
+            push(`1 ${pair.unit} ${pair.route} prn ${reason}`);
+        }
+    }
+    return suggestions;
+}
+function matchesPrefix(candidate, prefix, prefixCompact) {
+    if (!prefix) {
+        return true;
+    }
+    const normalizedCandidate = candidate.toLowerCase();
+    if (normalizedCandidate.startsWith(prefix)) {
+        return true;
+    }
+    const compactCandidate = normalizedCandidate.replace(/\s+/g, "");
+    return compactCandidate.startsWith(prefixCompact);
+}
+function suggestSig(input, options) {
+    var _a, _b;
+    const limit = (_a = options === null || options === void 0 ? void 0 : options.limit) !== null && _a !== void 0 ? _a : DEFAULT_LIMIT;
+    const prefix = normalizeSpacing(input.toLowerCase());
+    const prefixCompact = prefix.replace(/\s+/g, "");
+    const contextUnit = (0, context_1.inferUnitFromContext)((_b = options === null || options === void 0 ? void 0 : options.context) !== null && _b !== void 0 ? _b : undefined);
+    const pairs = buildUnitRoutePairs(contextUnit);
+    const doseValues = buildDoseValues(input);
+    const prnReasons = buildPrnReasons(options === null || options === void 0 ? void 0 : options.prnReasons);
+    const candidates = generateCandidateSignatures(pairs, doseValues, prnReasons);
+    const results = [];
+    for (const candidate of candidates) {
+        if (matchesPrefix(candidate, prefix, prefixCompact)) {
+            results.push(candidate);
+        }
+        if (results.length >= limit) {
+            break;
+        }
+    }
+    return results;
+}

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { SigTranslationConfig } from "./i18n";
 export interface FhirCoding {
     system?: string;
     code?: string;
@@ -167,6 +168,7 @@ export declare enum SNOMEDCTRouteCodes {
     "Intrapulmonary route (qualifier value)" = "420201002",
     "Mucous fistula route (qualifier value)" = "420204005",
     "Nasoduodenal route (qualifier value)" = "420218003",
+    "Body cavity route" = "420254004",
     "A route that begins within a non-pathologic hollow cavity, such as that of the abdominal cavity or uterus." = "420254004",
     "Intraventricular route - cardiac (qualifier value)" = "420287000",
     "Intracerebroventricular route (qualifier value)" = "420719007",
@@ -282,7 +284,11 @@ export interface MedicationContext {
     containerUnit?: string;
     defaultUnit?: string;
 }
-export interface ParseOptions {
+export interface FormatOptions {
+    locale?: "en" | "th" | string;
+    i18n?: SigTranslationConfig;
+}
+export interface ParseOptions extends FormatOptions {
     /**
      * Optional medication context that assists with default unit inference.
      * May be omitted or explicitly set to null when no contextual clues exist.
@@ -298,7 +304,6 @@ export interface ParseOptions {
     }>;
     whenMap?: Record<string, EventTiming>;
     allowDiscouraged?: boolean;
-    locale?: "en" | "th" | string;
     /**
      * When enabled the parser will expand generic meal timing tokens (AC/PC/C)
      * into specific breakfast/lunch/dinner (and bedtime) EventTiming entries
@@ -347,17 +352,21 @@ export interface FrequencyFallbackTimes {
  * Shared configuration required to generate next-due dose timestamps.
  */
 export interface NextDueDoseConfig {
-    timeZone: string;
-    eventClock: EventClockMap;
-    mealOffsets: MealOffsetMap;
+    timeZone?: string;
+    eventClock?: EventClockMap;
+    mealOffsets?: MealOffsetMap;
     frequencyDefaults?: FrequencyFallbackTimes;
 }
 /**
  * Options bag for next-due dose generation.
  */
 export interface NextDueDoseOptions {
-    orderedAt: Date | string;
     from: Date | string;
-    limit: number;
-    config: NextDueDoseConfig;
+    orderedAt?: Date | string;
+    limit?: number;
+    timeZone?: string;
+    eventClock?: EventClockMap;
+    mealOffsets?: MealOffsetMap;
+    frequencyDefaults?: FrequencyFallbackTimes;
+    config?: NextDueDoseConfig;
 }

package/dist/types.js

@@ -1,8 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteCode = exports.FhirDayOfWeek = exports.FhirPeriodUnit = exports.SNOMEDCTRouteCodes = exports.EventTiming = void 0;
 /**
  * Follows https://build.fhir.org/valueset-event-timing.html
  * Real-world event relating to the schedule.
  */
-export var EventTiming;
+var EventTiming;
 (function (EventTiming) {
     EventTiming["Before Sleep"] = "HS";
     EventTiming["Wake"] = "WAKE";
@@ -31,12 +34,12 @@ export var EventTiming;
     EventTiming["Night"] = "NIGHT";
     EventTiming["After Sleep"] = "PHS";
     EventTiming["Immediate"] = "IMD";
-})(EventTiming || (EventTiming = {}));
+})(EventTiming || (exports.EventTiming = EventTiming = {}));
 /**
  * SNOMED CT route codes aligned with the official "route of administration values" value set.
  * Keeping the enumeration exhaustive ensures downstream consumers can rely on strong typing.
  */
-export var SNOMEDCTRouteCodes;
+var SNOMEDCTRouteCodes;
 (function (SNOMEDCTRouteCodes) {
     SNOMEDCTRouteCodes["Topical route"] = "6064005";
     SNOMEDCTRouteCodes["Otic route"] = "10547007";
@@ -148,6 +151,7 @@ export var SNOMEDCTRouteCodes;
     SNOMEDCTRouteCodes["Intrapulmonary route (qualifier value)"] = "420201002";
     SNOMEDCTRouteCodes["Mucous fistula route (qualifier value)"] = "420204005";
     SNOMEDCTRouteCodes["Nasoduodenal route (qualifier value)"] = "420218003";
+    SNOMEDCTRouteCodes["Body cavity route"] = "420254004";
     SNOMEDCTRouteCodes["A route that begins within a non-pathologic hollow cavity, such as that of the abdominal cavity or uterus."] = "420254004";
     SNOMEDCTRouteCodes["Intraventricular route - cardiac (qualifier value)"] = "420287000";
     SNOMEDCTRouteCodes["Intracerebroventricular route (qualifier value)"] = "420719007";
@@ -200,8 +204,8 @@ export var SNOMEDCTRouteCodes;
     SNOMEDCTRouteCodes["Posterior juxtascleral route (qualifier value)"] = "58821000052106";
     SNOMEDCTRouteCodes["Subretinal route (qualifier value)"] = "58831000052108";
     SNOMEDCTRouteCodes["Sublabial use"] = "66621000052103";
-})(SNOMEDCTRouteCodes || (SNOMEDCTRouteCodes = {}));
-export var FhirPeriodUnit;
+})(SNOMEDCTRouteCodes || (exports.SNOMEDCTRouteCodes = SNOMEDCTRouteCodes = {}));
+var FhirPeriodUnit;
 (function (FhirPeriodUnit) {
     FhirPeriodUnit["Second"] = "s";
     FhirPeriodUnit["Minute"] = "min";
@@ -210,8 +214,8 @@ export var FhirPeriodUnit;
     FhirPeriodUnit["Week"] = "wk";
     FhirPeriodUnit["Month"] = "mo";
     FhirPeriodUnit["Year"] = "a";
-})(FhirPeriodUnit || (FhirPeriodUnit = {}));
-export var FhirDayOfWeek;
+})(FhirPeriodUnit || (exports.FhirPeriodUnit = FhirPeriodUnit = {}));
+var FhirDayOfWeek;
 (function (FhirDayOfWeek) {
     FhirDayOfWeek["Monday"] = "mon";
     FhirDayOfWeek["Tuesday"] = "tue";
@@ -220,5 +224,5 @@ export var FhirDayOfWeek;
     FhirDayOfWeek["Friday"] = "fri";
     FhirDayOfWeek["Saturday"] = "sat";
     FhirDayOfWeek["Sunday"] = "sun";
-})(FhirDayOfWeek || (FhirDayOfWeek = {}));
-export const RouteCode = SNOMEDCTRouteCodes;
+})(FhirDayOfWeek || (exports.FhirDayOfWeek = FhirDayOfWeek = {}));
+exports.RouteCode = SNOMEDCTRouteCodes;

package/dist/utils/array.d.ts

@@ -0,0 +1 @@
+export declare function arrayIncludes<T>(values: ReadonlyArray<T>, target: T): boolean;

package/dist/utils/array.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrayIncludes = arrayIncludes;
+function arrayIncludes(values, target) {
+    for (let index = 0; index < values.length; index += 1) {
+        if (values[index] === target) {
+            return true;
+        }
+    }
+    return false;
+}

package/dist/utils/enum.d.ts

@@ -0,0 +1,2 @@
+export declare function enumEntries<T extends Record<string, string | number>>(enumeration: T): Array<[keyof T, T[keyof T]]>;
+export declare function enumValues<T extends Record<string, string | number>>(enumeration: T): Array<T[keyof T]>;

package/dist/utils/enum.js

@@ -0,0 +1,7 @@
+import { objectEntries, objectValues } from "./object";
+export function enumEntries(enumeration) {
+    return objectEntries(enumeration);
+}
+export function enumValues(enumeration) {
+    return objectValues(enumeration);
+}

package/dist/utils/object.d.ts

@@ -0,0 +1,7 @@
+export type ObjectEntries<T extends Record<string, unknown>> = Array<[
+    keyof T,
+    T[keyof T]
+]>;
+export declare function objectEntries<T extends Record<string, unknown>>(value: T): ObjectEntries<T>;
+export declare function objectValues<T extends Record<string, unknown>>(value: T): Array<T[keyof T]>;
+export declare function objectFromEntries<K extends string, V>(entries: Array<[K, V]>): Record<K, V>;

package/dist/utils/object.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectEntries = objectEntries;
+exports.objectValues = objectValues;
+exports.objectFromEntries = objectFromEntries;
+function objectEntries(value) {
+    const entries = [];
+    for (const key in value) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
+            const typedKey = key;
+            entries.push([typedKey, value[typedKey]]);
+        }
+    }
+    return entries;
+}
+function objectValues(value) {
+    const values = [];
+    for (const key in value) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
+            values.push(value[key]);
+        }
+    }
+    return values;
+}
+function objectFromEntries(entries) {
+    const result = {};
+    for (let index = 0; index < entries.length; index += 1) {
+        const entry = entries[index];
+        const key = entry[0];
+        const value = entry[1];
+        result[key] = value;
+    }
+    return result;
+}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "ezmedicationinput",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Parse concise medication sigs into FHIR R5 Dosage JSON",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node scripts/postbuild.cjs",
     "test": "vitest run"
   },
   "files": [