@ad-execute-manager/logger 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 singcl
+
+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/README.md

@@ -0,0 +1,181 @@
+# @ad-execute-manager/logger
+
+A flexible logging utility for JavaScript applications with multiple log levels and customizable prefixes.
+
+## Installation
+
+```bash
+npm install @ad-execute-manager/logger
+```
+
+## Features
+
+- **Multiple Log Levels**: Support for error, warn, info, log, and debug levels
+- **Customizable Prefix**: Add a prefix to identify the source of logs
+- **Log Level Control**: Set minimum log level to filter out less important messages
+- **Enable/Disable**: Toggle logging on and off as needed
+- **TypeScript Support**: Includes TypeScript type definitions
+
+## Usage
+
+### Basic Usage
+
+```javascript
+import { Logger } from '@ad-execute-manager/logger';
+
+// Create a logger instance
+const logger = new Logger({
+  prefix: 'MyApp',
+  level: 'info',
+  enabled: true
+});
+
+// Log messages at different levels
+logger.error('Something went wrong');
+logger.warn('This is a warning');
+logger.info('Application started');
+logger.log('Regular message');
+logger.debug('Debug information');
+```
+
+### Log Level Control
+
+```javascript
+import { Logger } from '@ad-execute-manager/logger';
+
+// Create logger with different levels
+const productionLogger = new Logger({
+  prefix: 'App',
+  level: 'warn' // Only show warn and error messages
+});
+
+const developmentLogger = new Logger({
+  prefix: 'App',
+  level: 'debug' // Show all messages
+});
+
+// Change level dynamically
+productionLogger.setLevel('info');
+```
+
+### Enable/Disable Logging
+
+```javascript
+import { Logger } from '@ad-execute-manager/logger';
+
+const logger = new Logger({ prefix: 'MyApp' });
+
+// Disable logging
+logger.disable();
+logger.info('This won\'t be logged');
+
+// Enable logging
+logger.enable();
+logger.info('This will be logged');
+
+// Check if logging is enabled
+if (logger.isEnabled()) {
+  logger.log('Logging is enabled');
+}
+```
+
+### Real-world Examples
+
+#### 1. Application Logging
+
+```javascript
+import { Logger } from '@ad-execute-manager/logger';
+
+// Create logger based on environment
+const logger = new Logger({
+  prefix: 'MyApp',
+  level: process.env.NODE_ENV === 'production' ? 'info' : 'debug'
+});
+
+// Log application startup
+logger.info('Application started');
+
+// Log errors
+function handleError(error) {
+  logger.error('Error occurred:', error);
+  // Error handling logic
+}
+
+// Log debug information
+function processData(data) {
+  logger.debug('Processing data:', data);
+  // Processing logic
+  logger.info('Data processed successfully');
+}
+```
+
+#### 2. Module-specific Logging
+
+```javascript
+import { Logger } from '@ad-execute-manager/logger';
+
+// Create logger for different modules
+const authLogger = new Logger({ prefix: 'AuthModule' });
+const apiLogger = new Logger({ prefix: 'APIModule' });
+const dbLogger = new Logger({ prefix: 'DBModule' });
+
+// Use in different modules
+function login(user) {
+  authLogger.info('User login attempt:', user.username);
+  // Login logic
+}
+
+function fetchData() {
+  apiLogger.debug('Fetching data from API');
+  // API call
+  apiLogger.info('Data fetched successfully');
+}
+
+function saveData(data) {
+  dbLogger.debug('Saving data to database');
+  // Database operation
+  dbLogger.info('Data saved successfully');
+}
+```
+
+## API
+
+### Constructor
+
+```javascript
+new Logger(options)
+```
+
+- **options** (Object): Configuration options
+  - **prefix** (String): Log prefix, defaults to 'Logger'
+  - **level** (String): Log level, options: 'error', 'warn', 'info', 'log', 'debug', defaults to 'log'
+  - **enabled** (Boolean): Whether logging is enabled, defaults to true
+
+### Methods
+
+- **enable()**: Enable logging
+- **disable()**: Disable logging
+- **isEnabled()**: Return whether logging is enabled
+- **setLevel(level)**: Set log level
+  - **level** (String): Log level
+- **error(message, ...args)**: Output error log
+- **warn(message, ...args)**: Output warning log
+- **info(message, ...args)**: Output info log
+- **log(message, ...args)**: Output regular log
+- **debug(message, ...args)**: Output debug log
+
+### Log Levels
+
+| Level   | Description                  | Methods            |
+|---------|------------------------------|--------------------|
+| error   | Error messages               | logger.error()     |
+| warn    | Warning messages             | logger.warn()      |
+| info    | Information messages         | logger.info()      |
+| log     | Regular messages             | logger.log()       |
+| debug   | Debug information            | logger.debug()     |
+
+The log level is hierarchical, meaning if you set the level to 'info', it will show info, warn, and error messages, but not log or debug messages.
+
+## License
+
+MIT

package/dist/Logger.d.ts

@@ -0,0 +1,35 @@
+export class Logger {
+    /**
+     *
+     * @param {object} [options]
+     * @param {string} [options.prefix] - 日志前缀
+     * @param {'error'|'warn'|'info'|'log'|'debug'} [options.level] - 日志级别
+     * @param {boolean} [options.enabled] - 是否启用日志
+     */
+    constructor(options?: {
+        prefix?: string;
+        level?: "error" | "warn" | "info" | "log" | "debug";
+        enabled?: boolean;
+    });
+    prefix: string;
+    enabled: boolean;
+    levels: {
+        error: number;
+        warn: number;
+        info: number;
+        log: number;
+        debug: number;
+    };
+    currentLevel: number;
+    enable(): void;
+    disable(): void;
+    isEnabled(): boolean;
+    setLevel(level: any): void;
+    formatMessage(level: any, message: any): string;
+    _log(level: any, message: any, ...args: any[]): void;
+    error(message: any, ...args: any[]): void;
+    warn(message: any, ...args: any[]): void;
+    info(message: any, ...args: any[]): void;
+    log(message: any, ...args: any[]): void;
+    debug(message: any, ...args: any[]): void;
+}

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";const __rslib_import_meta_url__="u"<typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,r)=>{for(var _ in r)__webpack_require__.o(r,_)&&!__webpack_require__.o(e,_)&&Object.defineProperty(e,_,{enumerable:!0,get:r[_]})},__webpack_require__.o=(e,r)=>Object.prototype.hasOwnProperty.call(e,r),__webpack_require__.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{Logger:()=>Logger});class Logger{constructor(e={}){const{prefix:r="Logger",level:_="log",enabled:t=!0}=e;this.prefix=r,this.enabled=t,this.levels={error:0,warn:1,info:2,log:3,debug:4},this.currentLevel=this.levels[_]||this.levels.log}enable(){this.enabled=!0}disable(){this.enabled=!1}isEnabled(){return this.enabled}setLevel(e){Object.prototype.hasOwnProperty.call(this.levels,e)&&(this.currentLevel=this.levels[e])}formatMessage(e,r){let _=new Date,t=`${_.getFullYear()}/${_.getMonth()+1}/${_.getDate()} ${_.getHours()}:${_.getMinutes()}:${_.getSeconds()}`;return`[${t}] [${e.toUpperCase()}] [${this.prefix}] ${r}`}_log(e,r,..._){if(!this.enabled)return;let t=this.levels[e];if(void 0!==t&&this.currentLevel>=t){let t=this.formatMessage(e,r);switch(e){case"error":console.error(t,..._);break;case"warn":console.warn(t,..._);break;case"info":console.info(t,..._);break;case"log":default:console.log(t,..._);break;case"debug":console.debug(t,..._)}}}error(e,...r){this._log("error",e,...r)}warn(e,...r){this._log("warn",e,...r)}info(e,...r){this._log("info",e,...r)}log(e,...r){this._log("log",e,...r)}debug(e,...r){this._log("debug",e,...r)}}for(var __rspack_i in exports.Logger=__webpack_exports__.Logger,__webpack_exports__)-1===["Logger"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { Logger } from "./Logger.js";

package/dist/index.js

@@ -0,0 +1 @@
+class e{constructor(e={}){let{prefix:t="Logger",level:s="log",enabled:l=!0}=e;this.prefix=t,this.enabled=l,this.levels={error:0,warn:1,info:2,log:3,debug:4},this.currentLevel=this.levels[s]||this.levels.log}enable(){this.enabled=!0}disable(){this.enabled=!1}isEnabled(){return this.enabled}setLevel(e){Object.prototype.hasOwnProperty.call(this.levels,e)&&(this.currentLevel=this.levels[e])}formatMessage(e,t){let s=new Date,l=`${s.getFullYear()}/${s.getMonth()+1}/${s.getDate()} ${s.getHours()}:${s.getMinutes()}:${s.getSeconds()}`;return`[${l}] [${e.toUpperCase()}] [${this.prefix}] ${t}`}_log(e,t,...s){if(!this.enabled)return;let l=this.levels[e];if(void 0!==l&&this.currentLevel>=l){let l=this.formatMessage(e,t);switch(e){case"error":console.error(l,...s);break;case"warn":console.warn(l,...s);break;case"info":console.info(l,...s);break;case"log":default:console.log(l,...s);break;case"debug":console.debug(l,...s)}}}error(e,...t){this._log("error",e,...t)}warn(e,...t){this._log("warn",e,...t)}info(e,...t){this._log("info",e,...t)}log(e,...t){this._log("log",e,...t)}debug(e,...t){this._log("debug",e,...t)}}export{e as Logger};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@ad-execute-manager/logger",
+  "version": "2.0.1",
+  "description": "A flexible logging utility for JavaScript applications with multiple log levels and customizable prefixes.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "author": {
+    "name": "singcl",
+    "email": "iambabyer@gmail.com",
+    "url": "https://github.com/singcl"
+  },
+  "license": "MIT",
+  "homepage": "https://npmjs.com/package/@ad-execute-manager/logger",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/singcl/ad-execute-manager.git",
+    "directory": "packages/logger"
+  },
+  "bugs": {
+    "url": "https://github.com/singcl/ad-execute-manager/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "keywords": [
+    "logger",
+    "logging",
+    "utility",
+    "javascript",
+    "nodejs",
+    "typescript",
+    "log-levels",
+    "debug"
+  ],
+  "scripts": {
+    "build": "rslib build && tsc",
+    "dev": "rslib build --watch",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "rstest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@babel/eslint-parser": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@eslint/js": "^9.39.1",
+    "@rslib/core": "^0.18.5",
+    "@rstest/core": "^0.7.2",
+    "eslint": "^9.39.2",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.5.0",
+    "prettier": "^3.7.3",
+    "typescript": "^5.9.3"
+  }
+}