@inog/iris-library-js NPM

IRIS - JS Library

IRIS stands for "Integration of Remote systems into Infection control Software" and is intended to be the central point of mediation between the various contact, event and guest tracking apps on the one hand and the infection control software (e.g. SORMAS) in the health departments on the other.

This repository is used as a client library to handle the connection with the IRIS gateway

Purpose

To help interact with the IRIS Gateway this helper library abstracts aspects of the interaction with the IRIS Gateway like encryption. This way you can just send the data without worrying about the annoying stuff.

Installation

You should have node and npm or yarn installed.

$ yarn add @inog/iris-library-js

Basic Usage

Before being able to send or check data the library must be initialized with the url of the IRIS Gateway:

import Iris from '@inog/iris-library-js';

const iris = new Iris({
  baseUrl: 'https://your.iris.url',
});

At first, it must be checked whether a data request for this code exists in the IRIS system. This way also the public key for addressing the correct health office is also obtained

const dataRequest = await iris.getDataRequest('12345-abcd');

Afterwards the data can be sent with the corresponding code

await iris.sendContactsEvents('12345-abcd', { your: 'data' }, { firstName: 'Sending', lastName: 'User' });

Please note: Before being able to call sendContactsEvents with a specific code, the data request must be received first by calling getDataRequest with the same code.