@pulsoid/socket v1.1.7

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

To add Pulsoid socket put this in head tag of your html

<script crossorigin src="https://unpkg.com/@pulsoid/socket@1.1.1/dist/index.js"></script>

Then, in your js code you can init and use pulsoid socket like this

const pulsocket = new PulsoidSocket('REPLACE WITH YOUR TOKEN');

console.log(pulsocket.isConnected());

pulsocket.on('open', () => {
  console.log('Connected');
});

pulsocket.on('heart-rate', (data) => {
  console.log(data);

  console.log(`Current heart rate is ${data.heartRate}`);
});

pulsocket.connect();

API

List of available Methods on PulsoidSocket instance

List of available EventType's for on method

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 |