Skip to main content
Version: v0.0.2

Guides

Task-oriented recipes - "how do I X?" - for @cosyte/terminology. Each guide is a short, copy-pasteable answer to one real integration question.

Status: this package ships the identity resolver, the ConceptMap $translate engine, the CodeSystem $lookup/$validate-code loaders, ValueSet $expand/binding, UCUM validation, the crosswalk resolvers, and the RxNorm drug graph.

Available now​

  • Canonicalize a code system - turn an OID or HL7 v2 mnemonic off a parsed message into a FHIR canonical URI with resolveSystem, handling the typed unknown case.
  • Translate through a ConceptMap - loadConceptMap + translate, reading the matches (with their relationship and steward comments) or the typed unmapped outcome.
  • Look up a code's display and status - $lookup / $validate-code over a BYO CodeSystem.
  • Validate a code against a value set - $validate-code / $expand over a BYO ValueSet.
  • Validate a UCUM unit - recognition/validation, never magnitude conversion.
  • Resolve a SNOMED→ICD-10-CM crosswalk or the ICD-9↔ICD-10 GEMs - carrying every steward No-Map/advice flag, never inverted.
  • Navigate the RxNorm drug graph - resolve a drug to its components and through them to its ingredient, a brand to its generic, or an NDC to its RXCUI, over a BYO RxNorm RRF release, never fabricating an edge.

The Quickstart covers the one-line calls, and the API Reference documents every shipped export.