cinstance-error

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.