pulsoid-socket

Zero dependency client for consuming Heart Rate Data from pulsoid-api.

Getting started

To install the package with npm, run:

npm install pulsoid-socket

or with yarn:

yarn add pulsoid-socket

Basic usage

In order to use the client, you need to have a valid authorization token. Check out how to get one here;

import PulsoidSocket from 'pulsoid-socket';

const pulsocket = new PulsoidSocket('YOUR_AUTH_TOKEN');

pulsocket.on('open', (event) => {
  console.log('Start listening to heart rate data');
});
pulsocket.on('heart-rate', (data) => {
  console.log(`Current heart rate is ${data.heartRate}`);
});
pulsocket.on('close', (event) => {
  console.log('Stop listening to heart rate data');
});

pulsocket.connect();

Using CDN

You can also use the client directly from CDN. The client is available on unpkg and jsdelivr.

Check the codepen example on basic PulsoidSocket usage with CDN

---

API

List of available Methods on PulsoidSocket instance

Method	Description
constructor(token: string, options?: PulsoidSocketOptions)	Creates a new instance of the client.
connect()	Connects to the websocket server
disconnect()	Disconnects from the websocket server
on(eventType: EventType, callback: Callback	Adds a listener for the specified event type.
off(eventType: EventType, callback?: Callback)	Removes a listener for the specified event type. Removes all handlers if callback parameter is not specified
isConnected()	Returns true if socket connection is alive

List of available EventType's for on method

Event Type	Callback Type	Description
'open'	(event: Event) => void	Called when the connection is established
'heart-rate'	(heartRate: HeartRateMessage) => void	Called when heart rate message is recieved
'close'	(event: CloseEvent) => void	Called when the connection is closed
'error'	(error: PulsoidSocketError) => void	Called when an error occurs
'online'	() => void	Called when heart rate monitor device sends first message
'offline'	() => void	Called when there are no incomming messages from heart rate monitor device for more than 30 seconds
'reconnect'	(event: {attempt: number}) => void	Called when the client is trying to reconnect

PulsoidSocketOptions interface:

interface PulsoidSocketOptions {
  // Reconnect timing formula:
  // Math.min(maxInterval, minInterval * Math.pow(2, attempt))
  reconnect?: {
    // Turn on/off the reconnect option. true by default
    enabled?: boolean;

    // Base value for reconnect interval. 2000 by default
    reconnectMinInterval?: number;

    // Max value for reconnect interval. 10000 by default
    reconnectMaxInterval?: number;

    // Number of attempts before stopping the reconect. 10 000 by default trying to reconnect really hard
    reconnectAttempts?: number;
  };
}

HeartRateMessage format:

interface HeartRateMessage {
  measuredAt: number; // Unix timestamp
  heartRate: number; // Heart rate in BPM
}

PulsoidSocketError interface:

interface PulsoidSocketError {
  code: number; // Error code
}

specification of error codes:

Code	Description
412	User doesn't have any heart rate data