mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-11 05:42:19 +00:00
Marc-André Bombeck
07f09e1b61
The matcher stored the registry entry's key, so LDL and HDL markers were recorded as total-cholesterol. The key now names what the marker is (the catalog slug, or a registry-only key for an analyte with no seed), and the registry resolves ldl and hdl to the cholesterol entry for the conversion as before. A key already written in the old form is rewritten by the same fill step that brings a stale key in line with its name, the first time a reading needs it. The OpenAPI descriptions say what the key is and that it follows the marker's name and unit.
84 lines
3.2 KiB
TypeScript
84 lines
3.2 KiB
TypeScript
/**
|
|
* Which analyte a marker is, for the unit conversion.
|
|
*
|
|
* `matchAnalyteKey` answers from two places: the localised names of the
|
|
* catalog seeds the registry knows (so a marker created from the "pick a common
|
|
* marker" list is recognised in every language the app ships) and the alias
|
|
* list in the catalog. The name must equal one of them as a WHOLE, folded the
|
|
* same way on both sides; a part of a name never matches.
|
|
*
|
|
* Two safeguards keep a link from being wrong:
|
|
* - a folded name that two analytes claim matches neither;
|
|
* - the marker's own unit must be one the analyte reaches, so a marker called
|
|
* "Glucose" in a unit the registry cannot convert is left unlinked.
|
|
*
|
|
* Returns the catalog slug the name was recognised as (`ldl`, `hdl`,
|
|
* `fasting-glucose`), or the registry-only key for an analyte with no seed
|
|
* (`urea`, `uric-acid`), or null. LDL stays `ldl` even though the registry
|
|
* converts it with the cholesterol entry: the key says which marker this is,
|
|
* and `analyteConversionFor` resolves it to its entry. Pure apart from reading
|
|
* the message bundles once.
|
|
*/
|
|
import { foldForMatch } from "@/lib/i18n/fold-for-match";
|
|
import { localisedValues } from "@/lib/i18n/shared-resolve";
|
|
|
|
import { ANALYTE_ALIASES, BIOMARKER_CATALOG } from "./biomarker-catalog";
|
|
import { analyteAcceptsUnit } from "./unit-conversion/convert";
|
|
import { analyteConversionFor } from "./unit-conversion/registry";
|
|
|
|
/** The folded name without a trailing parenthetical gloss: "Vitamin D (25-OH)" -> "vitamin d". */
|
|
function withoutGloss(folded: string): string {
|
|
return folded.replace(/\s*\([^)]*\)/gu, "").trim();
|
|
}
|
|
|
|
let cache: ReadonlyMap<string, string> | null = null;
|
|
|
|
/**
|
|
* folded name -> analyte key, with every name two keys claim removed.
|
|
* Exported for the guard test, which asserts nothing was dropped silently.
|
|
*/
|
|
export function analyteNameIndex(): {
|
|
index: ReadonlyMap<string, string>;
|
|
ambiguous: readonly string[];
|
|
} {
|
|
const claims = new Map<string, Set<string>>();
|
|
const claim = (name: string, key: string) => {
|
|
const folded = foldForMatch(name);
|
|
if (!folded) return;
|
|
const keys = claims.get(folded) ?? new Set<string>();
|
|
keys.add(key);
|
|
claims.set(folded, keys);
|
|
};
|
|
|
|
for (const seed of BIOMARKER_CATALOG) {
|
|
if (!analyteConversionFor(seed.slug)) continue;
|
|
for (const name of localisedValues(`labs.catalog.${seed.slug}`)) {
|
|
claim(name, seed.slug);
|
|
// The bare name too, for a marker typed without the app's gloss.
|
|
claim(withoutGloss(foldForMatch(name)), seed.slug);
|
|
}
|
|
}
|
|
for (const { key, names } of ANALYTE_ALIASES) {
|
|
if (!analyteConversionFor(key)) continue;
|
|
for (const name of names) claim(name, key);
|
|
}
|
|
|
|
const index = new Map<string, string>();
|
|
const ambiguous: string[] = [];
|
|
for (const [folded, keys] of claims) {
|
|
if (keys.size === 1) index.set(folded, [...keys][0]);
|
|
else ambiguous.push(folded);
|
|
}
|
|
return { index, ambiguous };
|
|
}
|
|
|
|
export function matchAnalyteKey(input: {
|
|
name: string;
|
|
unit: string;
|
|
}): string | null {
|
|
cache ??= analyteNameIndex().index;
|
|
const key = cache.get(foldForMatch(input.name));
|
|
if (!key) return null;
|
|
return analyteAcceptsUnit(key, input.unit) ? key : null;
|
|
}
|