KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

simple-hl7

★ 126 Open GitHub ↗

A simple library for creating HL7 middleware, based on connect & express.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# simple-hl7
[![Node.js CI](https://github.com/hitgeek/simple-hl7/actions/workflows/test.yml/badge.svg)](https://github.com/hitgeek/simple-hl7/actions/workflows/test.yml)

A simple library for creating HL7 middleware, based on connect & express.

```js
var hl7 = require('simple-hl7');

///////////////////SERVER/////////////////////
var app = hl7.tcp();

app.use(function(req, res, next) {
  //req.msg is the HL7 message
  console.log('******message received*****')
  console.log(req.msg.log());
  next();
})

app.use(function(req, res, next){
  //res.ack is the ACK
  //acks are created automatically

//send the res.ack back
  console.log('******sending ack*****')
  res.end()
})

app.use(function(err, req, res, next) {
  //error handler
  //standard error middleware would be
  console.log('******ERROR*****')
  console.log(err);
  var msa = res.ack.getSegment('MSA');
  msa.setField(1, 'AR');
  res.ack.addSegment('ERR', err.message);
  res.end();
});

//Listen on port 7777
app.start(7777); //optionally pass encoding here, app.start(1234, 'latin-1');
///////////////////SERVER/////////////////////

///////////////////CLIENT/////////////////////
var client = hl7.Server.createTcpClient('localhost', 7777);

//create a message
var msg = new hl7.Message(
                    "EPIC",
                    "EPICADT",
                    "SMS",
                    "199912271408",
                    "CHARRIS",
                    ["ADT", "A04"], //This field has 2 components
                    "1817457",
                    "D",
                    "2.5"
                );

console.log('******sending message*****')
client.send(msg, function(err, ack) {
  console.log('******ack received*****')
  console.log(ack.log());
});
///////////////////CLIENT/////////////////////
```

## Installation

```bash
$ npm install simple-hl7
```

## Features

* Parser
  * Message Builder/Editor API
  * Server/Client components for TCP and File System Based Interfaces

## Philosophy
Make HL7 interfaces and middleware as easy as express web servers.

## Examples
See examples & tests folder on github.

## People
Author: Bob Rupp bob@rupp.io

## License
MIT

simple-hl7

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README