@proteinjs/logger 1.0.1

package/.eslintrc.js

@@ -0,0 +1,20 @@
+module.exports = {
+  extends: ['eslint:recommended', 'plugin:@typescript-eslint/recommended', 'plugin:prettier/recommended', 'prettier'],
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint', 'prettier'],
+  root: true,
+  ignorePatterns: ['**/dist/*', '**/node_modules/*', '*.md'],
+
+  rules: {
+    'prettier/prettier': ['warn'],
+    curly: ['warn'],
+    'eol-last': ['warn', 'always'],
+    'keyword-spacing': ['warn', { before: true }],
+    'no-undef': 'off',
+    '@typescript-eslint/no-unused-vars': 'off',
+    '@typescript-eslint/no-var-requires': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/prefer-as-const': 'off',
+    '@typescript-eslint/ban-types': 'off',
+  },
+};

package/.prettierignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+.DS_Store
+*.md

package/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "semi": true,
+  "singleQuote": true,
+  "jsxSingleQuote": true,
+  "printWidth": 120
+}

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 1.0.1 (2024-08-13)
+
+**Note:** Version bump only for package @proteinjs/logger

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Brent Bahry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/generated/index.d.ts

@@ -0,0 +1,4 @@
+/** Load Dependency Source Graphs */
+import '@proteinjs/reflection';
+export * from '../index';
+//# sourceMappingURL=index.d.ts.map

package/dist/generated/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AAEpC,OAAO,uBAAuB,CAAC;AAqB/B,cAAc,UAAU,CAAC"}

package/dist/generated/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/** Load Dependency Source Graphs */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("@proteinjs/reflection");
+/** Generate Source Graph */
+const sourceGraph = "{\"options\":{\"directed\":true,\"multigraph\":false,\"compound\":false},\"nodes\":[{\"v\":\"/'debug' | 'info' | 'warn' | 'error'\"},{\"v\":\"@proteinjs/logger/LogWriter\",\"value\":{\"packageName\":\"@proteinjs/logger\",\"name\":\"LogWriter\",\"filePath\":\"/home/runner/work/util/util/packages/logger/src/LogWriter.ts\",\"qualifiedName\":\"@proteinjs/logger/LogWriter\",\"properties\":[],\"methods\":[{\"name\":\"write\",\"returnType\":{\"packageName\":\"\",\"name\":\"void\",\"filePath\":null,\"qualifiedName\":\"/void\",\"typeParameters\":null,\"directParents\":null},\"isAsync\":false,\"isOptional\":false,\"isAbstract\":true,\"isStatic\":false,\"visibility\":\"public\",\"parameters\":[{\"name\":\"log\",\"type\":{\"packageName\":\"@proteinjs/logger\",\"name\":\"Log\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/logger/Log\",\"typeParameters\":null,\"directParents\":null}}]}],\"typeParameters\":[],\"directParents\":[{\"packageName\":\"@proteinjs/reflection\",\"name\":\"Loadable\",\"filePath\":null,\"qualifiedName\":\"@proteinjs/reflection/Loadable\",\"properties\":[],\"methods\":[],\"typeParameters\":[],\"directParents\":[]}],\"sourceType\":3}},{\"v\":\"@proteinjs/reflection/Loadable\"}],\"edges\":[{\"v\":\"@proteinjs/logger/LogWriter\",\"w\":\"@proteinjs/reflection/Loadable\",\"value\":\"extends interface\"}]}";
+/** Generate Source Links */
+const sourceLinks = {};
+/** Load Source Graph and Links */
+const reflection_1 = require("@proteinjs/reflection");
+reflection_1.SourceRepository.merge(sourceGraph, sourceLinks);
+__exportStar(require("../index"), exports);
+//# sourceMappingURL=index.js.map

package/dist/generated/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,iCAA+B;AAG/B,4BAA4B;AAE5B,MAAM,WAAW,GAAG,szCAAszC,CAAC;AAG30C,4BAA4B;AAG5B,MAAM,WAAW,GAAG,EACnB,CAAC;AAGF,kCAAkC;AAElC,sDAAyD;AACzD,6BAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAGjD,2CAAyB"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './src/Logger';
+export * from './src/LogLevel';
+export * from './src/LogWriter';
+export * from './src/DevLogWriter';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./src/Logger"), exports);
+__exportStar(require("./src/LogLevel"), exports);
+__exportStar(require("./src/LogWriter"), exports);
+__exportStar(require("./src/DevLogWriter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,iDAA+B;AAC/B,kDAAgC;AAChC,qDAAmC"}

package/dist/src/DevLogWriter.d.ts

@@ -0,0 +1,9 @@
+import { Log } from './LogWriter';
+export declare class DevLogWriter {
+    private static COLORS;
+    write({ loggerName, logLevel, timestamp, message, obj, inspectOptions, error }: Log): void;
+    private prefix;
+    private formatDate;
+    private colorMessage;
+}
+//# sourceMappingURL=DevLogWriter.d.ts.map

package/dist/src/DevLogWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevLogWriter.d.ts","sourceRoot":"","sources":["../../src/DevLogWriter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,MAAM,CAMnB;IAEF,KAAK,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,IAAI;IAkC1F,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,YAAY;CAQrB"}

package/dist/src/DevLogWriter.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevLogWriter = void 0;
+const util_1 = require("util");
+class DevLogWriter {
+    write({ loggerName, logLevel, timestamp, message, obj, inspectOptions, error }) {
+        let formattedMessage;
+        if (message) {
+            const prefixedMessage = `${this.prefix(timestamp, loggerName)} ${message}`;
+            formattedMessage = this.colorMessage(prefixedMessage, logLevel);
+        }
+        const defaultInspectOptions = {
+            depth: 10,
+            colors: true,
+            compact: false,
+            breakLength: 80,
+            maxStringLength: 1000,
+        };
+        const formatObj = (o) => (0, util_1.inspect)(o, Object.assign(Object.assign({}, defaultInspectOptions), inspectOptions));
+        const logParts = [formattedMessage, obj && formatObj(obj), error && formatObj({ error })].filter(Boolean);
+        switch (logLevel) {
+            case 'info':
+                console.info(...logParts);
+                break;
+            case 'warn':
+                console.warn(...logParts);
+                break;
+            case 'error':
+                console.error(...logParts);
+                break;
+            default:
+                console.log(...logParts);
+        }
+    }
+    prefix(timestamp, loggerName) {
+        const formattedTimestamp = this.formatDate(timestamp);
+        const namePrefix = loggerName ? ` [${loggerName}]` : '';
+        return `${formattedTimestamp}${namePrefix}`;
+    }
+    formatDate(date) {
+        const pad = (num) => num.toString().padStart(2, '0');
+        const padMs = (num) => num.toString().padStart(3, '0');
+        const hours = date.getHours();
+        const minutes = pad(date.getMinutes());
+        const seconds = pad(date.getSeconds());
+        const milliseconds = padMs(date.getMilliseconds());
+        const ampm = hours >= 12 ? 'PM' : 'AM';
+        const formattedHours = hours % 12 || 12; // Convert to 12-hour format
+        return `${formattedHours}:${minutes}:${seconds}.${milliseconds} ${ampm}`;
+    }
+    colorMessage(message, logLevel) {
+        if (logLevel === 'info') {
+            return message;
+        }
+        const color = DevLogWriter.COLORS[logLevel === 'error' ? 'red' : logLevel === 'warn' ? 'yellow' : 'green'];
+        return `${color}${message}${DevLogWriter.COLORS.reset}`;
+    }
+}
+exports.DevLogWriter = DevLogWriter;
+DevLogWriter.COLORS = {
+    reset: '\x1b[0m',
+    green: '\x1b[32m',
+    cyan: '\x1b[36m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+};
+//# sourceMappingURL=DevLogWriter.js.map

package/dist/src/DevLogWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevLogWriter.js","sourceRoot":"","sources":["../../src/DevLogWriter.ts"],"names":[],"mappings":"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"}

package/dist/src/LogLevel.d.ts

@@ -0,0 +1,2 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+//# sourceMappingURL=LogLevel.d.ts.map

package/dist/src/LogLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.d.ts","sourceRoot":"","sources":["../../src/LogLevel.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC"}

package/dist/src/LogLevel.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=LogLevel.js.map

package/dist/src/LogLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.js","sourceRoot":"","sources":["../../src/LogLevel.ts"],"names":[],"mappings":""}

package/dist/src/LogWriter.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="node" />
+import { Loadable } from '@proteinjs/reflection';
+import { LogLevel } from './LogLevel';
+import { InspectOptions } from 'util';
+export declare const getLogWriter: () => LogWriter;
+export type Log = {
+    /** The name of the logger creating this log */
+    loggerName?: string;
+    /** The log level of this log */
+    logLevel: LogLevel;
+    /** The time the log was created */
+    timestamp: Date;
+    /** The log message */
+    message?: string;
+    /** The object being logged */
+    obj?: any;
+    /** The error being logged */
+    error?: Error;
+    /** Object formatting options */
+    inspectOptions?: InspectOptions;
+};
+export interface LogWriter extends Loadable {
+    write(log: Log): void;
+}
+//# sourceMappingURL=LogWriter.d.ts.map

package/dist/src/LogWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogWriter.d.ts","sourceRoot":"","sources":["../../src/LogWriter.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAEtC,eAAO,MAAM,YAAY,iBAAgF,CAAC;AAE1G,MAAM,MAAM,GAAG,GAAG;IAChB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,6BAA6B;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gCAAgC;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;CACvB"}

package/dist/src/LogWriter.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogWriter = void 0;
+const reflection_1 = require("@proteinjs/reflection");
+const getLogWriter = () => reflection_1.SourceRepository.get().object('@proteinjs/logger/LogWriter');
+exports.getLogWriter = getLogWriter;
+//# sourceMappingURL=LogWriter.js.map

package/dist/src/LogWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogWriter.js","sourceRoot":"","sources":["../../src/LogWriter.ts"],"names":[],"mappings":";;;AAAA,sDAAmE;AAI5D,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,6BAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAY,6BAA6B,CAAC,CAAC;AAA7F,QAAA,YAAY,gBAAiF"}

package/dist/src/Logger.d.ts

@@ -0,0 +1,30 @@
+/// <reference types="node" />
+import { InspectOptions } from 'util';
+import { LogLevel } from './LogLevel';
+import { LogWriter } from './LogWriter';
+type LoggerParams = {
+    name?: string;
+    logLevel?: LogLevel;
+    logWriter?: LogWriter;
+};
+type Log = {
+    message?: string;
+    obj?: any;
+    inspectOptions?: InspectOptions;
+};
+type ErrorLog = Log & {
+    error?: Error;
+};
+export declare class Logger {
+    private name?;
+    private logLevel;
+    private logWriter;
+    constructor({ name, logLevel, logWriter }: LoggerParams);
+    log({ message, obj, inspectOptions }: Log): void;
+    debug({ message, obj, inspectOptions }: Log): void;
+    info({ message, obj, inspectOptions }: Log): void;
+    warn({ message, obj, inspectOptions }: Log): void;
+    error({ message, obj, inspectOptions, error }: ErrorLog): void;
+}
+export {};
+//# sourceMappingURL=Logger.d.ts.map

package/dist/src/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/Logger.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,KAAK,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAClF,KAAK,GAAG,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC;AAC5E,KAAK,QAAQ,GAAG,GAAG,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAExC,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAY;gBAEjB,EAAE,IAAI,EAAE,QAAiB,EAAE,SAA8B,EAAE,EAAE,YAAY;IAMrF,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,GAAG;IAWzC,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,GAAG;IAe3C,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,GAAG;IAe1C,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,GAAG;IAe1C,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,QAAQ;CAWxD"}

package/dist/src/Logger.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const DevLogWriter_1 = require("./DevLogWriter");
+class Logger {
+    constructor({ name, logLevel = 'info', logWriter = new DevLogWriter_1.DevLogWriter() }) {
+        this.name = name;
+        this.logLevel = logLevel;
+        this.logWriter = logWriter;
+    }
+    log({ message, obj, inspectOptions }) {
+        this.logWriter.write({
+            loggerName: this.name,
+            logLevel: 'info',
+            timestamp: new Date(),
+            message,
+            obj,
+            inspectOptions,
+        });
+    }
+    debug({ message, obj, inspectOptions }) {
+        if (this.logLevel == 'info' || this.logLevel == 'warn' || this.logLevel == 'error') {
+            return;
+        }
+        this.logWriter.write({
+            loggerName: this.name,
+            logLevel: 'debug',
+            timestamp: new Date(),
+            message,
+            obj,
+            inspectOptions,
+        });
+    }
+    info({ message, obj, inspectOptions }) {
+        if (this.logLevel == 'warn' || this.logLevel == 'error') {
+            return;
+        }
+        this.logWriter.write({
+            loggerName: this.name,
+            logLevel: 'info',
+            timestamp: new Date(),
+            message,
+            obj,
+            inspectOptions,
+        });
+    }
+    warn({ message, obj, inspectOptions }) {
+        if (this.logLevel == 'error') {
+            return;
+        }
+        this.logWriter.write({
+            loggerName: this.name,
+            logLevel: 'warn',
+            timestamp: new Date(),
+            message,
+            obj,
+            inspectOptions,
+        });
+    }
+    error({ message, obj, inspectOptions, error }) {
+        this.logWriter.write({
+            loggerName: this.name,
+            logLevel: 'error',
+            timestamp: new Date(),
+            message,
+            obj,
+            inspectOptions,
+            error,
+        });
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=Logger.js.map

package/dist/src/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/Logger.ts"],"names":[],"mappings":";;;AAGA,iDAA8C;AAM9C,MAAa,MAAM;IAKjB,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,SAAS,GAAG,IAAI,2BAAY,EAAE,EAAgB;QACnF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAO;QACvC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACnB,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO;YACP,GAAG;YACH,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAO;QACzC,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,EAAE;YAClF,OAAO;SACR;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACnB,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO;YACP,GAAG;YACH,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAO;QACxC,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,EAAE;YACvD,OAAO;SACR;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACnB,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO;YACP,GAAG;YACH,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAO;QACxC,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO,EAAE;YAC5B,OAAO;SACR;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACnB,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO;YACP,GAAG;YACH,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAY;QACrD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACnB,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,QAAQ,EAAE,OAAO;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO;YACP,GAAG;YACH,cAAc;YACd,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF;AA9ED,wBA8EC"}

package/generated/index.ts

@@ -0,0 +1,19 @@
+/** Load Dependency Source Graphs */
+
+import '@proteinjs/reflection';
+
+/** Generate Source Graph */
+
+const sourceGraph =
+  '{"options":{"directed":true,"multigraph":false,"compound":false},"nodes":[{"v":"/\'debug\' | \'info\' | \'warn\' | \'error\'"},{"v":"@proteinjs/logger/LogWriter","value":{"packageName":"@proteinjs/logger","name":"LogWriter","filePath":"/home/runner/work/util/util/packages/logger/src/LogWriter.ts","qualifiedName":"@proteinjs/logger/LogWriter","properties":[],"methods":[{"name":"write","returnType":{"packageName":"","name":"void","filePath":null,"qualifiedName":"/void","typeParameters":null,"directParents":null},"isAsync":false,"isOptional":false,"isAbstract":true,"isStatic":false,"visibility":"public","parameters":[{"name":"log","type":{"packageName":"@proteinjs/logger","name":"Log","filePath":null,"qualifiedName":"@proteinjs/logger/Log","typeParameters":null,"directParents":null}}]}],"typeParameters":[],"directParents":[{"packageName":"@proteinjs/reflection","name":"Loadable","filePath":null,"qualifiedName":"@proteinjs/reflection/Loadable","properties":[],"methods":[],"typeParameters":[],"directParents":[]}],"sourceType":3}},{"v":"@proteinjs/reflection/Loadable"}],"edges":[{"v":"@proteinjs/logger/LogWriter","w":"@proteinjs/reflection/Loadable","value":"extends interface"}]}';
+
+/** Generate Source Links */
+
+const sourceLinks = {};
+
+/** Load Source Graph and Links */
+
+import { SourceRepository } from '@proteinjs/reflection';
+SourceRepository.merge(sourceGraph, sourceLinks);
+
+export * from '../index';

package/index.ts

@@ -0,0 +1,4 @@
+export * from './src/Logger';
+export * from './src/LogLevel';
+export * from './src/LogWriter';
+export * from './src/DevLogWriter';

package/jest.config.js

@@ -0,0 +1,9 @@
+module.exports = {
+  roots: ['<rootDir>/test'],
+  transform: {
+    '^.+\\.tsx?$': 'ts-jest',
+  },
+  testRegex: '(/__tests__/.*|(\\.|/)(test|spec))\\.tsx?$',
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  testEnvironment: 'node',
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@proteinjs/logger",
+  "version": "1.0.1",
+  "description": "A simple logger",
+  "main": "./dist/generated/index.js",
+  "types": "./dist/generated/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/proteinjs/util.git"
+  },
+  "bugs": {
+    "url": "https://github.com/proteinjs/util/issues"
+  },
+  "homepage": "https://github.com/proteinjs/util#readme",
+  "author": "Brent Bahry",
+  "license": "MIT",
+  "scripts": {
+    "clean": "rm -rf dist/ generated/ node_modules/",
+    "build": "reflection-build && tsc",
+    "watch": "reflection-watch"
+  },
+  "dependencies": {
+    "@proteinjs/reflection": "1.1.8"
+  },
+  "devDependencies": {
+    "@proteinjs/reflection-build": "1.0.23",
+    "@types/jest": "29.5.5",
+    "@types/node": "20.8.2",
+    "@typescript-eslint/eslint-plugin": "7.8.0",
+    "@typescript-eslint/parser": "7.8.0",
+    "eslint": "8.57.0",
+    "eslint-config-prettier": "9.1.0",
+    "eslint-plugin-prettier": "5.1.3",
+    "jest": "29.7.0",
+    "ts-jest": "29.1.1",
+    "typescript": "5.2.2"
+  },
+  "gitHead": "f14c87eefacbcfcb708dbaf711316519482a8923"
+}

package/src/DevLogWriter.ts

@@ -0,0 +1,76 @@
+import { inspect, InspectOptions } from 'util';
+import { LogLevel } from './LogLevel';
+import { Log } from './LogWriter';
+
+export class DevLogWriter {
+  private static COLORS = {
+    reset: '\x1b[0m',
+    green: '\x1b[32m',
+    cyan: '\x1b[36m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+  };
+
+  write({ loggerName, logLevel, timestamp, message, obj, inspectOptions, error }: Log): void {
+    let formattedMessage: string | undefined;
+    if (message) {
+      const prefixedMessage = `${this.prefix(timestamp, loggerName)} ${message}`;
+      formattedMessage = this.colorMessage(prefixedMessage, logLevel);
+    }
+
+    const defaultInspectOptions: InspectOptions = {
+      depth: 10,
+      colors: true,
+      compact: false,
+      breakLength: 80,
+      maxStringLength: 1000,
+    };
+
+    const formatObj = (o: any) => inspect(o, { ...defaultInspectOptions, ...inspectOptions });
+
+    const logParts = [formattedMessage, obj && formatObj(obj), error && formatObj({ error })].filter(Boolean);
+
+    switch (logLevel) {
+      case 'info':
+        console.info(...logParts);
+        break;
+      case 'warn':
+        console.warn(...logParts);
+        break;
+      case 'error':
+        console.error(...logParts);
+        break;
+      default:
+        console.log(...logParts);
+    }
+  }
+
+  private prefix(timestamp: Date, loggerName?: string) {
+    const formattedTimestamp = this.formatDate(timestamp);
+    const namePrefix = loggerName ? ` [${loggerName}]` : '';
+    return `${formattedTimestamp}${namePrefix}`;
+  }
+
+  private formatDate(date: Date) {
+    const pad = (num: number) => num.toString().padStart(2, '0');
+    const padMs = (num: number) => num.toString().padStart(3, '0');
+
+    const hours = date.getHours();
+    const minutes = pad(date.getMinutes());
+    const seconds = pad(date.getSeconds());
+    const milliseconds = padMs(date.getMilliseconds());
+    const ampm = hours >= 12 ? 'PM' : 'AM';
+    const formattedHours = hours % 12 || 12; // Convert to 12-hour format
+
+    return `${formattedHours}:${minutes}:${seconds}.${milliseconds} ${ampm}`;
+  }
+
+  private colorMessage(message: string, logLevel: LogLevel) {
+    if (logLevel === 'info') {
+      return message;
+    }
+
+    const color = DevLogWriter.COLORS[logLevel === 'error' ? 'red' : logLevel === 'warn' ? 'yellow' : 'green'];
+    return `${color}${message}${DevLogWriter.COLORS.reset}`;
+  }
+}

package/src/LogLevel.ts

@@ -0,0 +1 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';

package/src/LogWriter.ts

@@ -0,0 +1,26 @@
+import { Loadable, SourceRepository } from '@proteinjs/reflection';
+import { LogLevel } from './LogLevel';
+import { InspectOptions } from 'util';
+
+export const getLogWriter = () => SourceRepository.get().object<LogWriter>('@proteinjs/logger/LogWriter');
+
+export type Log = {
+  /** The name of the logger creating this log */
+  loggerName?: string;
+  /** The log level of this log */
+  logLevel: LogLevel;
+  /** The time the log was created */
+  timestamp: Date;
+  /** The log message */
+  message?: string;
+  /** The object being logged */
+  obj?: any;
+  /** The error being logged */
+  error?: Error;
+  /** Object formatting options */
+  inspectOptions?: InspectOptions;
+};
+
+export interface LogWriter extends Loadable {
+  write(log: Log): void;
+}

package/src/Logger.ts

@@ -0,0 +1,88 @@
+import { InspectOptions } from 'util';
+import { LogLevel } from './LogLevel';
+import { LogWriter } from './LogWriter';
+import { DevLogWriter } from './DevLogWriter';
+
+type LoggerParams = { name?: string; logLevel?: LogLevel; logWriter?: LogWriter };
+type Log = { message?: string; obj?: any; inspectOptions?: InspectOptions };
+type ErrorLog = Log & { error?: Error };
+
+export class Logger {
+  private name?: string;
+  private logLevel: LogLevel;
+  private logWriter: LogWriter;
+
+  constructor({ name, logLevel = 'info', logWriter = new DevLogWriter() }: LoggerParams) {
+    this.name = name;
+    this.logLevel = logLevel;
+    this.logWriter = logWriter;
+  }
+
+  log({ message, obj, inspectOptions }: Log) {
+    this.logWriter.write({
+      loggerName: this.name,
+      logLevel: 'info',
+      timestamp: new Date(),
+      message,
+      obj,
+      inspectOptions,
+    });
+  }
+
+  debug({ message, obj, inspectOptions }: Log) {
+    if (this.logLevel == 'info' || this.logLevel == 'warn' || this.logLevel == 'error') {
+      return;
+    }
+
+    this.logWriter.write({
+      loggerName: this.name,
+      logLevel: 'debug',
+      timestamp: new Date(),
+      message,
+      obj,
+      inspectOptions,
+    });
+  }
+
+  info({ message, obj, inspectOptions }: Log) {
+    if (this.logLevel == 'warn' || this.logLevel == 'error') {
+      return;
+    }
+
+    this.logWriter.write({
+      loggerName: this.name,
+      logLevel: 'info',
+      timestamp: new Date(),
+      message,
+      obj,
+      inspectOptions,
+    });
+  }
+
+  warn({ message, obj, inspectOptions }: Log) {
+    if (this.logLevel == 'error') {
+      return;
+    }
+
+    this.logWriter.write({
+      loggerName: this.name,
+      logLevel: 'warn',
+      timestamp: new Date(),
+      message,
+      obj,
+      inspectOptions,
+    });
+  }
+
+  error({ message, obj, inspectOptions, error }: ErrorLog) {
+    this.logWriter.write({
+      loggerName: this.name,
+      logLevel: 'error',
+      timestamp: new Date(),
+      message,
+      obj,
+      inspectOptions,
+      error,
+    });
+  }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "rootDir": "./",
+    "target": "es6",
+    "module": "commonjs",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist/",
+    "strict": true,
+    "noImplicitAny": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "jsx": "react"
+  }
+}