Package Exports

@tourmalinecore/react-tc-auth

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@tourmalinecore/react-tc-auth) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Tourmaline Core jwt authentication package

authService factory

usage

import { createAuthService } from '@tourmalinecore/react-tc-auth';

const authService = createAuthService({
  authApiRoot: '/', // api root for auth, eg: yourdomain/api/auth
  authType: 'ls' | 'cookies', // implementation type, not just storage usage

  // for ls we fetch as pair of jwt + rt tokens, there are accessors for dto fields
  tokenAccessor: 'accessToken',
  refreshTokenAccessor: 'refreshToken',
  tokenValueAccessor: 'value',
  tokenExpireAccessor: 'expiresInUtc',
})

authService now provides:

{
  getAuthToken, // get token value from storage
  getAuthTokenOrRefresh, // async function, gets token from storage, refreshes if expired
  refreshToken, // async function, call api to refresh token
  loginCall, // fetch login data with axios
  logoutCall,
  setLoggedIn, // set token to storage
  setLoggedOut, // remove token from storage
  AuthContext, // react auth context
  AuthProvider, // react context provider
  withPrivateRoute, // react HOC for private routes
  useAuth, // hook for custom react auth context provider
}

Usage

You can use it as is, just add await getAuthTokenOrRefresh() to your api calls to get actual access token
Or you can add error interceptor and call await refreshToken() inside it, do not forget to change logged state after it (setLoggedOut, setLoggedIn), this calls will notify storage observers