@cht/ui-data-mgmt

Important: Sibling dependency on @cht/ui-component-lib

In order to use this library in your application, you must also import @cht/ui-component-lib. This library depends on this component library, but intentionally does not bundle it in directly.

You can add the component library to your current app with the command:

yarn add @cht/ui-component-lib

Error handling and logging

When Rollbar is enabled, you will see any uncaught errors in the application reported to this project's error page.

Configuration

• ROLLBAR_ENABLED: To report uncaught errors to Rollbar, build your consuming application with the environment variable ROLLBAR_ENABLED set to yes. If Rollbar is not enabled, manual logging will not be reported either.
• ROLLBAR_VERBOSE: To log Rollbar messages to the JS console as well as to Rollbar, set ROLLBAR_VERBOSE to yes. If Rollbar is not enabled, console logging is also disabled.

Manual logging

To manually log an event to Rollbar, use any of the debug, info, warn, or error functions:

import { notifier } from '@cht/ui-data-mgmt';

if (error) {
  notifier.error('Something wrong happened', error);
}

Uploading an application sourcemap to Rollbar

When deploying an application, its sourcemap should be sent to Rollbar for future debuging.

This is done via a CLI exposed by this package. All available options are documented in cht-upload-sourcemap --help.

Required options:

• --sourcemap: Path to the sourcemap file. This will typically be dist/bundle.js.map or the like.
• --url: URL of the minified JS. This will typically be https://apps.cloudhealthtech.com/my-app/bundle.js.
• --token: Rollbar server token. This is your project's post_server_item token that can be found at https://rollbar.com/cloudhealthtech/my-project/settings/access_tokens/.