Error Logger

A simple error logging package for sending errors to a centralized error management system.

Installation

To install the package, run:

npm install cinstance-error

or

yarn add cinstance-error

Usage

Here's an example of how to use the cinstance-error in your application:

// Import the logger
import CInstanceErrorLogger from 'cinstance-error';

// Initialize the logger with your secret key
const logger = new CInstanceErrorLogger('your_secret_key');

// Log an error with medium severity
logger.info({
  message: 'An error occurred',
  stack: 'Error stack trace',
  type: 'ypeError',
  platform: 'web',
  environment: 'production',
});

API Reference

CInstanceErrorLogger(secretKey)

• secretKey: Your secret key for authentication.

Logger Methods Overview

| Method | Description | Parameters | Returns | |---------------------------|----------------------------------------|-------------|------------------| | logger.info(errorData) | Logs an error with info severity. | errorData: IError | Promise<void> | | logger.fatal(errorData) | Logs an error with fatal severity. | errorData: IError | Promise<void> | | logger.debug(errorData) | Logs an error with debug severity. | errorData: IError | Promise<void> |

Logs an error with medium severity.

Error Data Object

The errorData object should include the following fields:

| Field | Type | Required | Description | |------------------|-------------------|----------|---------------------------------------------------------------| | message | string | Yes | Description of the error | | stack | string | Yes | Stack trace of the error | | type | IErrorTypeEnum | Yes | Type of error (e.g., TypeError, SyntaxError) | | environment | IEnvironment | Yes | Environment (e.g., development, production) | | platform | IPlatform | Yes | Platform where the error occurred (e.g., web, mobile) | | severity | ISeverity | Yes | Severity level (low, medium, high) | | appId | string | No | Application identifier (optional) | | sdkVersion | string | No | Version of the SDK used (optional) | | appVersion | string | No | Version of the application (optional) | | operatingSystem | string | No | Operating system where the error occurred (optional) | | device | string | No | Device type (if applicable) (optional) | | ipAddress | string | No | IP address of the source (optional) |

Enums Overview

IErrorTypeEnum

| Error Type | Value | |------------------|----------------| | TypeError | typeError | | ReferenceError | referenceError| | SyntaxError | syntaxError | | CustomError | customError | | Other | other |

IEnvironment

| Environment | Value | |------------------|----------------| | Development | development | | Production | production |

IPlatform

| Platform | Value | |------------------|----------------| | Web | web | | Mobile | mobile | | Desktop | desktop |

ISeverity

| Severity | Value | |----------|---------| | fatal | fatal | | debug | debug | | info | info | | error | error |

License

This project is licensed under the MIT License.