@peerbits/medical-terminology 0.1.0 → 0.2.0

package/README.md

@@ -1,5 +1,7 @@
 # @peerbits/medical-terminology
 
+Version 0.2 adds batch validation, canonical code-system URI resolution, and an optional strict mode that treats unknown systems as errors. The default remains backward compatible and reports unknown systems as warnings.
+
 > Terminology system-URI registry and code format/checksum validation utilities — ships zero licensed terminology datasets (see [Licensing](./docs/LICENSING.md))
 
 **Category:** Medical Coding — Terminology & Code-Handling Utilities · **License:** Apache-2.0 · **Status:** Stable
@@ -50,7 +52,7 @@ npm install @peerbits/medical-terminology
 [Peerbits HealthTech - Medical Terminology Demo](https://healthcare.peerbits.com/demo/medical-terminology)
 
 ```ts
-import { validate, SYSTEM_REGISTRY, isValidSctid } from "@peerbits/medical-terminology";
+import { canonicalizeSystemIdentifier, validate, validateMany } from "@peerbits/medical-terminology";
 
 // 1. Validate a LOINC observation code
 const loincResult = validate({
@@ -74,6 +76,16 @@ const invalidResult = validate({
 console.log(invalidResult.valid); // false
 console.log(invalidResult.issues);
 // [ { severity: "error", path: "code", code: "invalid-format", message: "..." } ]
+
+// Validate batches and reject unknown code systems when required
+const batch = validateMany([
+  { system: "LOINC", code: "8867-4" },
+  { system: "UCUM", code: "mm[Hg]" },
+], { unknownSystem: "error" });
+
+// Resolve aliases and OIDs to the canonical URI
+const canonicalUri = canonicalizeSystemIdentifier("LOINC");
+// http://loinc.org
 ```
 
 ---

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-export declare const VERSION = "1.0.0";
-export { validate, validateWithProvider } from "./validate.js";
+export declare const VERSION = "0.2.0";
+export { validate, validateWithProvider, validateMany, validateManyWithProvider } from "./validate.js";
 export { registerProvider, unregisterProvider, clearProviders, lookup, hasProvider, getRegisteredProviderSystems, } from "./provider.js";
-export { SYSTEM_REGISTRY, getSupportedSystems, getSystemByIdentifier, getSystemByShortName, getSystemByUri, } from "./registry.js";
+export { SYSTEM_REGISTRY, getSupportedSystems, getSystemByIdentifier, getSystemByShortName, getSystemByUri, canonicalizeSystemIdentifier, } from "./registry.js";
 export { isValidLoincFormat } from "./validators/loinc.js";
 export { isValidIcd10CmFormat } from "./validators/icd10cm.js";
 export { isValidCptFormat } from "./validators/cpt.js";
 export { isValidRxNormFormat } from "./validators/rxnorm.js";
 export { isValidUcumSyntax } from "./validators/ucum.js";
 export { calculateSctidCheckDigit, isValidSctid, } from "./validators/snomed.js";
-export type { CodedConcept, ProviderLookupResult, SupportedTerminologySystem, TerminologyProvider, TerminologySystem, ValidationIssue, ValidationResult, ValidationSeverity, } from "./types.js";
+export type { CodedConcept, ProviderLookupResult, SupportedTerminologySystem, TerminologyProvider, TerminologySystem, ValidationIssue, ValidationResult, ValidationSeverity, ValidationOptions, } from "./types.js";

package/dist/index.js

@@ -1,7 +1,7 @@
-export const VERSION = "1.0.0";
-export { validate, validateWithProvider } from "./validate.js";
+export const VERSION = "0.2.0";
+export { validate, validateWithProvider, validateMany, validateManyWithProvider } from "./validate.js";
 export { registerProvider, unregisterProvider, clearProviders, lookup, hasProvider, getRegisteredProviderSystems, } from "./provider.js";
-export { SYSTEM_REGISTRY, getSupportedSystems, getSystemByIdentifier, getSystemByShortName, getSystemByUri, } from "./registry.js";
+export { SYSTEM_REGISTRY, getSupportedSystems, getSystemByIdentifier, getSystemByShortName, getSystemByUri, canonicalizeSystemIdentifier, } from "./registry.js";
 export { isValidLoincFormat } from "./validators/loinc.js";
 export { isValidIcd10CmFormat } from "./validators/icd10cm.js";
 export { isValidCptFormat } from "./validators/cpt.js";

package/dist/registry.d.ts

@@ -4,3 +4,5 @@ export declare const getSupportedSystems: () => readonly TerminologySystem[];
 export declare const getSystemByShortName: (shortName: string) => TerminologySystem | undefined;
 export declare const getSystemByUri: (uri: string) => TerminologySystem | undefined;
 export declare const getSystemByIdentifier: (identifier: string) => TerminologySystem | undefined;
+/** Resolves a short name, URI, or OID to the canonical FHIR system URI. */
+export declare const canonicalizeSystemIdentifier: (identifier: string) => string | undefined;

package/dist/registry.js

@@ -65,3 +65,5 @@ export const getSystemByIdentifier = (identifier) => {
     const clean = identifier.trim().toLowerCase();
     return byUri.get(clean) ?? byShortName.get(clean) ?? byOid.get(clean);
 };
+/** Resolves a short name, URI, or OID to the canonical FHIR system URI. */
+export const canonicalizeSystemIdentifier = (identifier) => getSystemByIdentifier(identifier)?.uri;

package/dist/types.d.ts

@@ -24,6 +24,10 @@ export interface ValidationResult {
     system?: TerminologySystem;
     providerConfigured: boolean;
 }
+export interface ValidationOptions {
+    /** Unknown code systems remain warnings by default for backward compatibility. */
+    unknownSystem?: "warning" | "error";
+}
 export interface ProviderLookupResult {
     found: boolean;
     display?: string;

package/dist/validate.d.ts

@@ -1,15 +1,19 @@
-import type { ValidationResult } from "./types.js";
+import type { ValidationResult, ValidationOptions } from "./types.js";
 /**
  * Validates the structure and code format of a coded concept.
  *
  * @param concept The input concept object (e.g., { system, code, display? }).
  * @returns ValidationResult with validity flag, issues, and system metadata.
  */
-export declare function validate(concept: unknown): ValidationResult;
+export declare function validate(concept: unknown, options?: ValidationOptions): ValidationResult;
 /**
  * Validates format and dispatches to a registered TerminologyProvider if configured.
  *
  * @param concept The input concept object (e.g., { system, code, display? }).
  * @returns Promise<ValidationResult> with format & provider validation results.
  */
-export declare function validateWithProvider(concept: unknown): Promise<ValidationResult>;
+export declare function validateWithProvider(concept: unknown, options?: ValidationOptions): Promise<ValidationResult>;
+/** Validates a list without stopping at the first invalid concept. */
+export declare function validateMany(concepts: readonly unknown[], options?: ValidationOptions): ValidationResult[];
+/** Provider-aware batch variant. Provider calls are independent and run concurrently. */
+export declare function validateManyWithProvider(concepts: readonly unknown[], options?: ValidationOptions): Promise<ValidationResult[]>;

package/dist/validate.js

@@ -40,7 +40,7 @@ function extractString(target, key) {
  * @param concept The input concept object (e.g., { system, code, display? }).
  * @returns ValidationResult with validity flag, issues, and system metadata.
  */
-export function validate(concept) {
+export function validate(concept, options) {
     const issues = [];
     if (!concept || typeof concept !== "object" || Array.isArray(concept)) {
         return {
@@ -87,13 +87,13 @@ export function validate(concept) {
     const system = getSystemByUri(systemStr) ?? getSystemByIdentifier(systemStr);
     if (!system) {
         issues.push({
-            severity: "warning",
+            severity: options?.unknownSystem === "error" ? "error" : "warning",
             path: "system",
             code: "unknown-system",
             message: `Unknown terminology system: "${systemStr}". Format validation was skipped.`,
         });
         return {
-            valid: true,
+            valid: options?.unknownSystem !== "error",
             issues,
             providerConfigured: false,
         };
@@ -121,8 +121,8 @@ export function validate(concept) {
  * @param concept The input concept object (e.g., { system, code, display? }).
  * @returns Promise<ValidationResult> with format & provider validation results.
  */
-export async function validateWithProvider(concept) {
-    const result = validate(concept);
+export async function validateWithProvider(concept, options) {
+    const result = validate(concept, options);
     if (!result.valid || !result.system || !result.providerConfigured) {
         return result;
     }
@@ -157,3 +157,15 @@ export async function validateWithProvider(concept) {
     }
     return result;
 }
+/** Validates a list without stopping at the first invalid concept. */
+export function validateMany(concepts, options) {
+    if (!Array.isArray(concepts))
+        throw new TypeError("concepts must be an array");
+    return concepts.map((concept) => validate(concept, options));
+}
+/** Provider-aware batch variant. Provider calls are independent and run concurrently. */
+export async function validateManyWithProvider(concepts, options) {
+    if (!Array.isArray(concepts))
+        throw new TypeError("concepts must be an array");
+    return Promise.all(concepts.map((concept) => validateWithProvider(concept, options)));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peerbits/medical-terminology",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Terminology system-URI registry and code format/checksum validation utilities — ships zero licensed terminology datasets (see docs/LICENSING.md)",
   "license": "Apache-2.0",
   "author": "PeerbitsSolution",
@@ -26,7 +26,8 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build",
+    "prepack": "npm run build && npm run typecheck && npm test",
+    "prepublishOnly": "npm run lint && npm run prepack",
     "lint": "eslint .",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"
@@ -49,12 +50,12 @@
   ],
   "devDependencies": {
     "typescript": "^5.5.0",
-    "vitest": "^2.0.0",
+    "vitest": "^4.0.0",
     "eslint": "^9.0.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   }
 }