@sapphire-sh/utils 1.16.0 → 1.18.0

package/lib/index.d.ts

@@ -1,5 +1,7 @@
 export { getEnumValue } from './getEnumValue';
 export { isNonNullable } from './isNonNullable';
+export { logger } from './logger';
+export type { LogLevel } from './logger';
 export { Queue } from './queue';
 export { sleep } from './sleep';
 export { throttle } from './throttle';

package/lib/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.throttle = exports.sleep = exports.Queue = exports.isNonNullable = exports.getEnumValue = void 0;
+exports.throttle = exports.sleep = exports.Queue = exports.logger = exports.isNonNullable = exports.getEnumValue = void 0;
 var getEnumValue_1 = require("./getEnumValue");
 Object.defineProperty(exports, "getEnumValue", { enumerable: true, get: function () { return getEnumValue_1.getEnumValue; } });
 var isNonNullable_1 = require("./isNonNullable");
 Object.defineProperty(exports, "isNonNullable", { enumerable: true, get: function () { return isNonNullable_1.isNonNullable; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
 var queue_1 = require("./queue");
 Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return queue_1.Queue; } });
 var sleep_1 = require("./sleep");

package/lib/logger.d.ts

@@ -0,0 +1,15 @@
+export declare enum LogLevel {
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4
+}
+declare type Payload = Record<string, unknown> | Error;
+export declare const logger: {
+    debug: (message: string, payload?: Payload) => void;
+    info: (message: string, payload?: Payload) => void;
+    warn: (message: string, payload?: Payload) => void;
+    error: (message: string, payload?: Payload) => void;
+    setLevel: (level: LogLevel) => void;
+};
+export {};

package/lib/logger.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.LogLevel = void 0;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARN"] = 3] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+})(LogLevel = exports.LogLevel || (exports.LogLevel = {}));
+function serializePayload(payload) {
+    const json = JSON.stringify(payload instanceof Error ? { error: payload.message, name: payload.name, stack: payload.stack } : payload);
+    return json.padStart(json.length + 1);
+}
+let currentLevel = LogLevel.INFO;
+function log(level, message, payload) {
+    if (level < currentLevel) {
+        return;
+    }
+    const ts = new Date().toISOString();
+    const prefix = `[${ts}] [${LogLevel[level].toUpperCase()}]`;
+    const payloadStr = payload !== undefined ? serializePayload(payload) : '';
+    const output = `${prefix} ${message}${payloadStr}`;
+    if (level === LogLevel.ERROR) {
+        console.error(output);
+    }
+    else if (level === LogLevel.WARN) {
+        console.warn(output);
+    }
+    else if (level === LogLevel.DEBUG) {
+        console.debug(output);
+    }
+    else {
+        console.log(output);
+    }
+}
+exports.logger = {
+    debug: (message, payload) => log(LogLevel.DEBUG, message, payload),
+    info: (message, payload) => log(LogLevel.INFO, message, payload),
+    warn: (message, payload) => log(LogLevel.WARN, message, payload),
+    error: (message, payload) => log(LogLevel.ERROR, message, payload),
+    setLevel: (level) => {
+        currentLevel = level;
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sapphire-sh/utils",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "@sapphire-sh/utils",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",