@elliemae/pui-app-sdk

SDK for React Web Applications

Software Development Kit / API for developing React Web applications. Implements cross cutting concerns as reusable APIs

Build: Deploy: Test: SecScan:

SonarQube Report

API Documentation

QA Environment

Major Version Changelog

v3 to v4

ChangeLog

v2 to v3

ChangeLog

v1 to v2

Following are the major breaking changes in v2

• App React Dependencies upgraded to v2

• React hook form has been upgraded from v6 to v7. If you are using forms, fields or control components from App SDK please regress the functionalities in your application after the upgrade. In case, if you are using watch, trigger, reset, setError, touched api of react-hook-form, in your app, there are breaking changes. Please read the guide here

• Fully supports Typescript

• Removal of following unused apis

  • loginService

• Addition of following new apis

  • useAppDispatch
  • useAppSelector

Local Development Setup

• npm run setup
• npm run storybook

FAQ

• What is the difference between the Form Controls in App SDK vs Dimsum ?

  App SDK uses Dimsum form controls and provided additional functionalities such as state management for individual fields and for the entire Form. Also it provides a framework to do field level & form level validation.

  App SDK uses React Hook Form open source library to achieve the above functionalities.

• How do i use App SDK Form control and Form components ?

  Please see code examples

• How do i do field validation during field blur event ?

  Please see code samples

• How do i do field validation during form submit ?

  Please see code samples

• How do i refresh API auth tokens when my session expires ?

  Subscribe to the Authorization failure callback and implement logic to refresh your API Auth token. Pass the authorization header back to sdk. SDK will resubmit the failed request with new token.

  Sample code snippet

  import { onAuthorizationFailure } from '@elliemae/pui-app-sdk';
  const refreshToken = () =>
    new Promise((resolve) => {
      //get your new token
      const authorizationHeader = 'xyz'; //store new header value;
      sessionStorage.setItem('Authorization', authorizationHeader);
      resolve(authorizationHeader);
    });
  onAuthorizationFailure(refreshToken);