@honeybadger-io/react-native 0.0.6 → 0.0.9

package/index.d.ts

@@ -0,0 +1,61 @@
+export default honeybadger;
+declare namespace honeybadger {
+    /**
+     * Initialize and configure the Honeybadger React Native library.
+     * @param {string} apiKey - Your Honeybadger API key.
+     * @param {boolean} [reportErrors=true] reportErrors - Whether to send error reports to Honeybadger (disable for dev environments, etc.)
+     * @param {string=} revision - The git revision of the current build.
+     * @param {string=} projectRoot - The path to the project root.
+     */
+    function configure(apiKey: string, reportErrors?: boolean, revision?: string, projectRoot?: string): void;
+    /**
+     * Initialize and configure the Honeybadger React Native library.
+     * @param {string} apiKey - Your Honeybadger API key.
+     * @param {boolean} [reportErrors=true] reportErrors - Whether to send error reports to Honeybadger (disable for dev environments, etc.)
+     * @param {string=} revision - The git revision of the current build.
+     * @param {string=} projectRoot - The path to the project root.
+     */
+    function configure(apiKey: string, reportErrors?: boolean, revision?: string, projectRoot?: string): void;
+    /**
+     * Send any kind of error, exception, object, String, etc. to Honeybadger.
+     * @param {string|object} err - The error string or object.
+     * @param {string|object} additionalData - Additional data to include with the error.
+     */
+    function notify(err: any, additionalData: any): void;
+    /**
+     * Send any kind of error, exception, object, String, etc. to Honeybadger.
+     * @param {string|object} err - The error string or object.
+     * @param {string|object} additionalData - Additional data to include with the error.
+     */
+    function notify(err: any, additionalData: any): void;
+    /**
+     * Include additional data whenever an error or an exception occurs. This can be called as many times as needed. New context data will be merged with any previously-set context data.
+     * @param {object} context - Additional data to include with all errors and exceptions.
+     */
+    function setContext(context: any): void;
+    /**
+     * Include additional data whenever an error or an exception occurs. This can be called as many times as needed. New context data will be merged with any previously-set context data.
+     * @param {object} context - Additional data to include with all errors and exceptions.
+     */
+    function setContext(context: any): void;
+    /**
+     * Clears/resets any data previously set through setContext().
+     * @param {object=} context - Optional new context to set.
+     */
+    function resetContext(context?: any): void;
+    /**
+     * Clears/resets any data previously set through setContext().
+     * @param {object=} context - Optional new context to set.
+     */
+    function resetContext(context?: any): void;
+    /**
+     * Sets the logging level for the Honeybadger library.
+     * @param {('debug'|'warning'|'error')} [level=warning] - The logging level.
+     */
+    function setLogLevel(level?: "error" | "warning" | "debug"): void;
+    /**
+     * Sets the logging level for the Honeybadger library.
+     * @param {('debug'|'warning'|'error')} [level=warning] - The logging level.
+     */
+    function setLogLevel(level?: "error" | "warning" | "debug"): void;
+}

package/index.js

@@ -14,6 +14,11 @@ let _apiKey = null;
 let _initialized = false;
 let _context = {};
 let _logLevel = "warning"; // "error", "warning", "debug"
+let _previousJSGlobalExceptionHandler = null;
+let _revision = "";
+let _projectRoot = "";
+let _reportErrors = true;
+
 
 
 // ----------------------------------------------------------------------------
@@ -21,7 +26,14 @@ let _logLevel = "warning"; // "error", "warning", "debug"
 // ----------------------------------------------------------------------------
 const honeybadger = {
 
-    configure ( apiKey )
+    /**
+     * Initialize and configure the Honeybadger React Native library.
+     * @param {string} apiKey - Your Honeybadger API key.
+     * @param {boolean} [reportErrors=true] reportErrors - Whether to send error reports to Honeybadger (disable for dev environments, etc.)
+     * @param {string=} revision - The git revision of the current build.
+     * @param {string=} projectRoot - The path to the project root.
+     */
+    configure ( apiKey, reportErrors = true, revision = '', projectRoot = '' )
     {
         if ( !isValidAPIKey(apiKey) )
         {
@@ -30,6 +42,9 @@ const honeybadger = {
         }
 
         _apiKey = apiKey.trim();
+        _revision = (revision || '').trim();
+        _projectRoot = (projectRoot || '').trim();
+        _reportErrors = reportErrors;
 
         if ( !_initialized )
         {
@@ -39,7 +54,11 @@ const honeybadger = {
         }
     },
 
-
+    /**
+     * Send any kind of error, exception, object, String, etc. to Honeybadger.
+     * @param {string|object} err - The error string or object.
+     * @param {string|object} additionalData - Additional data to include with the error.
+     */
     notify ( err, additionalData )
     {
         if ( !isValidAPIKey(_apiKey) ) {
@@ -100,6 +119,10 @@ const honeybadger = {
     },
 
 
+    /**
+     * Include additional data whenever an error or an exception occurs. This can be called as many times as needed. New context data will be merged with any previously-set context data.
+     * @param {object} context - Additional data to include with all errors and exceptions.
+     */
     setContext ( context )
     {
         if ( isObject(context) ) {
@@ -108,12 +131,20 @@ const honeybadger = {
     },
 
 
+    /**
+     * Clears/resets any data previously set through setContext().
+     * @param {object=} context - Optional new context to set.
+     */
     resetContext ( context )
     {
         _context = (isObject(context) ? context : {});
     },
 
 
+    /**
+     * Sets the logging level for the Honeybadger library. 
+     * @param {('debug'|'warning'|'error')} [level=warning] - The logging level.
+     */
     setLogLevel ( level = "warning" )
     {
         if ( !level ) {
@@ -153,13 +184,26 @@ function isValidAPIKey(apiKey) {
 }
 
 
-function setJavaScriptErrorHandler() {
+
+function setJavaScriptErrorHandler() 
+{
     logDebug("Setting up the JavaScript global error handler.");
+    
+    _previousJSGlobalExceptionHandler = global.ErrorUtils.getGlobalHandler();
+
     global.ErrorUtils.setGlobalHandler(function(err, isFatal) {
         logDebug("JavaScript global error handler triggered.");
+
         onJavaScriptError(err, {
             initialHandler: 'Global JavaScript Error Handler',
         });
+
+        // Allowing the default error handler to process the error after
+        // we're done with it will show the useful RN red info box in dev. 
+        if ( _previousJSGlobalExceptionHandler && _previousJSGlobalExceptionHandler != this ) {
+            logDebug("Passing error to previous error handler.");
+            _previousJSGlobalExceptionHandler(err, isFatal);
+        }
     });
 }
 
@@ -188,10 +232,13 @@ function setNativeExceptionHandler() {
 
 
 function sendToHoneybadger(payload) {
-    if ( !payload || !isValidAPIKey(_apiKey) ) {
+    if ( !payload || !isValidAPIKey(_apiKey) || !_reportErrors ) {
         return;
     }
 
+
+    logDebug("Sending error report to Honeybadger...");
+
     const params = {
         method: 'POST',
         headers: {
@@ -243,6 +290,8 @@ function buildPayload ( data ) {
         },
         server : {
             environment_name: (__DEV__ ? "development" : "production"),
+            project_root: _projectRoot || '',
+            revision: _revision || ''
         },
     };
 

package/package.json

@@ -1,16 +1,17 @@
 {
     "name": "@honeybadger-io/react-native",
-    "version": "0.0.6",
+    "version": "0.0.9",
     "description": "Honeybadger.io for React Native.",
     "author": "Andrey Butov <andreybutov@antair.com> (https://andreybutov.com)",
     "license": "MIT",
+    "types": "index.d.ts",
     "main": "index.js",
     "scripts": {
         "test": "echo \"Error: no test specified\" && exit 1"
     },
-	"bin": {
-		"honeybadger-generate-sourcemaps" : "./honeybadger-generate-sourcemaps.sh"
-	},
+    "bin": {
+        "honeybadger-generate-sourcemaps": "./honeybadger-generate-sourcemaps.sh"
+    },
     "repository": {
         "type": "git",
         "url": "git+ssh://git@github.com:honeybadger-io/honeybadger-react-native.git"
@@ -25,7 +26,7 @@
     },
     "devDependencies": {
         "react": "^16.13.1",
-        "react-native": "^0.63.3"
+        "react-native": "^0.63.3",
+        "typescript": "^4.3.5"
     }
 }
-

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+	"include": ["index.js"],
+	"compilerOptions": {
+		// Read .js files
+		"allowJs": true,
+		// Generate d.ts files
+		"declaration": true,
+	  	// Only generate d.ts files
+	  	"emitDeclarationOnly": true,
+	}
+}