log-discord
v1.1.5
Published
A logging library for TypeScript to write logs on local files and sending messages to Discord.
Downloads
42
Maintainers
Readme
Logs
Logs is a TypeScript library that makes it easy to write logs on local files and sending messages to Discord.
Installation
You can install the Log library using npm or yarn:
npm install log-discord
or
yarn add log-discord
or
bun add log-discord
Usage
Here's an example of how to use the Log library:
import Log from "log-discord";
// Set the webhook URL
Log.webhookUrl =
"https://discord.com/api/webhooks/1234567890/abcdefghijklmnopqrstuvwxyz";
// Write a log message
Log.info("This is an info log message");
Log.error("This is an error log message");
Log.warning("This is a warning log message");
Log.debug("This is a debug log message");
Log.emergency("This is an emergency log message");
Log.critical("This is a critical log message");
// Write a log message with context
const context = {
userId: "1234567890",
userName: "Riode Prabowo",
ipAddress: "192.168.1.1",
};
Log.info("This is an info log message with context", context);
Functions
The Log library provides various functions for writing logs at different levels of severity:
Log.info(message: string, context?: any)
: Write an info log messageLog.error(message: string, context?: any)
: Write an error log messageLog.warning(message: string, context?: any)
: Write a warning log messageLog.debug(message: string, context?: any)
: Write a debug log messageLog.emergency(message: string, context?: any)
: Write an emergency log messageLog.critical(message: string, context?: any)
: Write a critical log message
You can send log messages with additional context by passing it as a parameter to the functions.
Configuration
You can configure the Log library by setting the following properties:
set from the environment
LOG_FOLDER_PATH=./logs // default: ./logs
LOG_DAYS_TO_KEEP=7 // default: 7 (keep logs for 7 days) set to 0 to keep logs forever
DISCORD_WEBHOOK_URL= // default: null
DISCORD_FOOTER_TEXT= // default: 'Sent by Log'
What does it look like?
You can get a preview of what it looks like using each of the provided converters.
Tests
npm test
License
This library is licensed under the MIT license.
Feel free to modify the content as needed. Let me know if you need any further assistance!