Class Auth

Refresh the current auth token if the token will expire within the next 15 mins, or the remaining validity period is below 1/3 of the original duration.

This is used internally for all REST calls: As long as 3 requests are made within the original validity period of the token being issued, the authentication token will always remain active.

If the token does expire, users will have be re-authenticated using the oboarding authentication flow, provided by Auth.login.

note

Currently, authentication tokens are valid for 1hour.

example

import { Hivehome } from 'node-hivehome';

(async () => {
  const hive = await new Hivehome('hello@example.com');

  await hive.auth.login('supersecretpassword');
  // `hive` object is now authenticated
})()

todo

Add support for MFA

todo

Add support for providing the password via an ENV var

example

import { Hivehome } from 'node-hivehome';

(async () => {
  const hive = await new Hivehome('hello@example.com');

  // ... login as shown .login() flow

  // do some stuff (time passes..)

  await hive.auth.refresh();
  // `hive` object is now authenticated with a newly issued token
})()