Performance

This page describes what we measure on @cosyte/transform, how, and how to time it yourself. The shared method every Cosyte package follows (throughput, latency percentiles, memory, import time and bundle size, and how a pull request is compared with main) is written down in the performance standard in cosyte/config's decision records. The numbers for the current release are in Current numbers below.

What we measure

We do not run benchmarks on @cosyte/transform yet, and no CI job guards its speed. The performance standard names what a benchmark measures: throughput, latency at the 50th, 95th and 99th percentiles, peak memory, import time and bundle size. For this package, each of those reads "not measured" in the section below until a benchmark runs on it.

What each call does

• A datatype converter reads one composite, consults the naming system when it needs a system URI, and builds one FHIR datatype node. It touches nothing else.
• toFhir runs the converters for each field it maps, checks each resource it builds with @cosyte/fhir's validateResource before the resource joins the bundle, and records which segment occurrences reached a resource. Issues are never summarized, so a message with many segments that reach nothing also returns many issues.
• toV2Patient and toV2Observation read one resource and build one v2 message with @cosyte/hl7's builder.

Parsing is not part of any of these: parseHL7 and parseResource run before them, in the sibling packages.

What these numbers are not

• Not a guarantee for your machine. Absolute times depend on the hardware and its load.
• Not a comparison with other libraries. That is a separate suite with its own written method.

Time it yourself

This program parses one synthetic admission and transforms it many times on your machine. It prints the time and checks only that each run produced its bundle:

import { parseHL7 } from "@cosyte/hl7";
import { toFhir } from "@cosyte/transform";

const raw = [
  "MSH|^~\\&|SENDAPP|SENDFAC|RCVAPP|RCVFAC|20260721143000-0500||ADT^A01^ADT_A01|MSG00001|P|2.5.1",
  "PID|1||MRN12345^^^HOSP^MR||Public^Jane^Q||19800115|F",
  "PV1|1|I",
  "AL1|1|DA|70618^Penicillin^RXNORM|SV",
].join("\r");
const message = parseHL7(raw);

const runs = 200;
let entries = 0;
const start = performance.now();
for (let i = 0; i < runs; i += 1) {
  entries += toFhir(message).bundle.properties.length > 0 ? 1 : 0;
}
const elapsed = performance.now() - start;

console.log(`${String(runs)} transforms in ${elapsed.toFixed(1)} ms`);
entries; // => 200

Current numbers

The numbers for this section are measured on main at each release and filled in when the release is built. They are never typed by hand.