Skip to content
Node.js library for the Range API.
JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
img
lib
.eslintrc.js
.gitignore
.prettierrc.json
LICENSE
issue_template.md
package.json
pull_request_template.md
readme.md

readme.md

Range Logo

Range Node.js SDK · License Twitter

Range helps teams know what’s happening, stay in sync, and actually feel like a team. It’s thoughtfully designed software that helps teams share daily check-ins, track goals, and run better meetings. So you can do your best work together.

Everything is easier in Range because it works with the tools you already use. Your tasks, documents, and code changes are already in Range, so you don’t have to enter data twice.

Find out more at www.range.co.

About

The Range Node SDK provides access to the Range API from applications written in server-side javascript.

This package makes use of Range API Keys, be careful to keep these keys secure. Avoid checking them into git repositories or leaving them in unsecured source code.

Documentation

See this readme and the API docs.

Installation

npm install range-sdk --save

Usage

This package needs to be configured with an API key which you can generate by visiting your developer dashboard. The key can be passed in via the RANGE_ACCESS_KEY environment variable, or as a constructor argument.

const Range = require('range-sdk');
const rangeClient = new Range('deadbeef1234567890');

The SDK uses promises:

new Range()
  .listTeams()
  .then(resp => console.log(resp))
  .catch(err => console.error(err.message));

or you can use await:

const team = await new Range().readTeam(productTeamID);

Errors are typed; both NetworkError and APIError inherit from RangeError.

new Range()
  .findUser({ email: 'no-one@mycorp.com' })
  .then(resp => console.log(resp))
  .catch(err => {
    if (err instanceof Range.APIError && err.code === Range.ErrorCodes.NOT_FOUND) {
      console.log('A Range user does not exist for that email');
    } else {
      console.error(err.message);
    }
  });
You can’t perform that action at this time.