@hestjs/logger 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 aqz236
+
+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,295 @@
+# @hest/logger
+
+<div align="center">
+
+![HestJS Logger](https://img.shields.io/badge/HestJS-Logger-blue?style=for-the-badge&logo=typescript)
+
+**A powerful, modern logging solution for HestJS framework based on Pino**
+
+[![npm version](https://img.shields.io/npm/v/@hest/logger?style=flat-square)](https://www.npmjs.com/package/@hest/logger)
+[![downloads](https://img.shields.io/npm/dm/@hest/logger?style=flat-square)](https://www.npmjs.com/package/@hest/logger)
+[![license](https://img.shields.io/npm/l/@hest/logger?style=flat-square)](https://github.com/aqz236/hest-logger/blob/main/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+
+
+</div>
+
+
+## ✨ Features
+
+- 🚀 **High Performance** - Built on top of Pino, one of the fastest JSON loggers
+- 🎨 **Beautiful Output** - Clean, readable console logs with customizable formatting
+- 🔧 **TypeScript Native** - Full TypeScript support with comprehensive type definitions
+- 🌍 **Environment Aware** - Different configurations for development, production, and testing
+- 📝 **Structured Logging** - JSON logging with customizable serializers
+- 🎯 **Context Support** - Add request IDs, user IDs, and custom context data
+- 🔄 **Multiple Transports** - Console, file, rotating files, and custom transports
+- 🛡️ **Security First** - Built-in redaction for sensitive information
+- 📦 **Framework Integration** - Seamlessly integrates with HestJS framework
+
+## 📦 Installation
+
+```bash
+# npm
+npm install @hest/logger
+
+# yarn
+yarn add @hest/logger
+
+# pnpm
+pnpm add @hest/logger
+
+# bun
+bun add @hest/logger
+```
+
+## 🚀 Quick Start
+
+### Basic Usage
+
+```typescript
+import { createLogger, logger } from '@hest/logger';
+
+// Use global logger
+logger.info('Hello, World!');
+logger.error('Something went wrong!', { error: 'details' });
+
+// Create named logger
+const apiLogger = createLogger('API');
+apiLogger.info('API server started');
+```
+
+### With HestJS Framework
+
+```typescript
+import { HestFactory, logger } from '@hest/core';
+
+async function bootstrap() {
+  logger.info('🚀 Starting HestJS application...');
+  
+  const app = await HestFactory.create(AppModule);
+  
+  logger.info('✅ Application ready!');
+}
+```
+
+### Advanced Configuration
+
+```typescript
+import { createLogger, LogLevel } from '@hest/logger';
+
+const customLogger = createLogger('MyService', {
+  level: LogLevel.DEBUG,
+  transport: {
+    target: 'pino-pretty',
+    options: {
+      colorize: true,
+      translateTime: 'yyyy-mm-dd HH:MM:ss.l',
+    }
+  }
+});
+
+customLogger.debug('Debug information');
+customLogger.info('Service initialized');
+customLogger.warn('Warning message');
+customLogger.error('Error occurred');
+```
+
+## 📖 API Reference
+
+### Core Functions
+
+#### `createLogger(name?, config?)`
+
+Creates a new logger instance with optional name and configuration.
+
+```typescript
+const logger = createLogger('ServiceName', {
+  level: LogLevel.INFO,
+  // ... other options
+});
+```
+
+#### `logger` (Global Logger)
+
+Pre-configured global logger instance.
+
+```typescript
+import { logger } from '@hest/logger';
+
+logger.info('Global log message');
+```
+
+### Logger Methods
+
+```typescript
+logger.fatal('Fatal error');
+logger.error('Error message');
+logger.warn('Warning message');
+logger.info('Info message');
+logger.debug('Debug message');
+logger.trace('Trace message');
+```
+
+### Context Support
+
+```typescript
+// Set context for all subsequent logs
+logger.setContext({ requestId: '123', userId: 'user456' });
+logger.info('User action performed');
+
+// Create child logger with context
+const childLogger = logger.child({ module: 'auth' });
+childLogger.info('Authentication successful');
+```
+
+## ⚙️ Configuration
+
+### Environment-based Configuration
+
+The logger automatically adapts based on `NODE_ENV`:
+
+- **Development**: Pretty-printed colored output
+- **Production**: JSON format optimized for log aggregation
+- **Test**: Minimal logging to reduce noise
+
+### Custom Configuration
+
+```typescript
+import { createLogger, LogLevel } from '@hest/logger';
+
+const logger = createLogger('MyApp', {
+  level: LogLevel.INFO,
+  redact: ['password', 'token'], // Hide sensitive fields
+  formatters: {
+    level: (label, number) => ({ level: number }),
+    bindings: (bindings) => ({ service: 'MyApp', ...bindings })
+  },
+  serializers: {
+    req: (req) => ({ method: req.method, url: req.url }),
+    res: (res) => ({ statusCode: res.statusCode })
+  }
+});
+```
+
+## 🎨 Output Examples
+
+### Development Output
+```
+[2025-07-27 14:08:19.149] INFO (MyService): User login successful
+[2025-07-27 14:08:19.150] ERROR (Auth): Invalid credentials provided
+    error: "Invalid username or password"
+    requestId: "req_123456"
+```
+
+### Production Output
+```json
+{"level":30,"time":1643299699149,"name":"MyService","msg":"User login successful","requestId":"req_123456"}
+{"level":50,"time":1643299699150,"name":"Auth","msg":"Invalid credentials provided","err":{"type":"AuthError","message":"Invalid username or password"}}
+```
+
+## 🔧 Transports
+
+### Console Transport
+```typescript
+import { createConsoleTransport } from '@hest/logger';
+
+const transport = createConsoleTransport({
+  colorize: true,
+  translateTime: 'yyyy-mm-dd HH:MM:ss.l'
+});
+```
+
+### File Transport
+```typescript
+import { createFileTransport } from '@hest/logger';
+
+const transport = createFileTransport({
+  destination: './logs/app.log',
+  mkdir: true
+});
+```
+
+### Rotating Files
+```typescript
+import { createRotatingFileTransport } from '@hest/logger';
+
+const transport = createRotatingFileTransport({
+  filename: './logs/app-%DATE%.log',
+  frequency: 'daily',
+  maxSize: '10M',
+  maxFiles: '7'
+});
+```
+
+## 🛡️ Security Features
+
+### Automatic Redaction
+```typescript
+const logger = createLogger('SecureApp', {
+  redact: ['password', 'token', 'authorization', 'cookie']
+});
+
+// This will automatically redact sensitive fields
+logger.info('User data', { 
+  username: 'john_doe', 
+  password: 'secret123' // This will be redacted
+});
+```
+
+### Safe Serialization
+All serializers include error handling to prevent logging failures from crashing your application.
+
+## 🧪 Testing
+
+```typescript
+import { createLogger, LogLevel } from '@hest/logger';
+
+// Create test logger with minimal output
+const testLogger = createLogger('Test', {
+  level: LogLevel.WARN // Only log warnings and errors in tests
+});
+```
+
+
+## 📊 Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=aqz236/hest-logger&type=Date)](https://star-history.com/#aqz236/hest-logger&Date)
+
+## 📊 Performance
+
+- **Zero-cost abstractions** when logging is disabled
+- **Fast serialization** with Pino's optimized JSON stringification
+- **Minimal memory footprint** with streaming architecture
+- **Benchmark**: Up to 35,000 logs/second in production mode
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- [HestJS Framework](https://github.com/aqz236/hest)
+- [Pino Logger](https://github.com/pinojs/pino)
+- [Documentation](https://github.com/aqz236/hest-logger/wiki)
+- [Issues](https://github.com/aqz236/hest-logger/issues)
+
+---
+
+<div align="center">
+
+**Built with ❤️ for the HestJS ecosystem**
+
+[⭐ Star us on GitHub](https://github.com/aqz236/hest-logger) • [📝 Report Bug](https://github.com/aqz236/hest-logger/issues) • [💡 Request Feature](https://github.com/aqz236/hest-logger/issues)
+
+</div>

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+import { LoggerConfig } from "./types";
+/**
+ * 默认日志配置
+ */
+export declare const DEFAULT_CONFIG: LoggerConfig;
+/**
+ * 开发环境配置
+ */
+export declare const DEVELOPMENT_CONFIG: Partial<LoggerConfig>;
+/**
+ * 生产环境配置
+ */
+export declare const PRODUCTION_CONFIG: Partial<LoggerConfig>;
+/**
+ * 测试环境配置
+ */
+export declare const TEST_CONFIG: Partial<LoggerConfig>;
+/**
+ * 根据环境获取配置
+ */
+export declare function getEnvironmentConfig(env?: string): Partial<LoggerConfig>;
+/**
+ * 从环境变量创建配置
+ */
+export declare function createConfigFromEnv(): Partial<LoggerConfig>;
+/**
+ * 合并配置
+ */
+export declare function mergeConfig(...configs: Partial<LoggerConfig>[]): LoggerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+B,MAAM,SAAS,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAU5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,YAAY,CAGpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,YAAY,CAGnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,YAAY,CAE7C,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAexE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,YAAY,CAAC,CAa3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,GAAG,YAAY,CAI7E"}

package/dist/config.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEST_CONFIG = exports.PRODUCTION_CONFIG = exports.DEVELOPMENT_CONFIG = exports.DEFAULT_CONFIG = void 0;
+exports.getEnvironmentConfig = getEnvironmentConfig;
+exports.createConfigFromEnv = createConfigFromEnv;
+exports.mergeConfig = mergeConfig;
+const types_1 = require("./types");
+/**
+ * 默认日志配置
+ */
+exports.DEFAULT_CONFIG = {
+    level: types_1.LogLevel.INFO,
+    timestamp: true,
+    name: "HestJS",
+    messageKey: "msg",
+    errorKey: "err",
+    base: {
+        pid: process.pid,
+        hostname: require("os").hostname(),
+    },
+};
+/**
+ * 开发环境配置
+ */
+exports.DEVELOPMENT_CONFIG = {
+    level: types_1.LogLevel.DEBUG,
+    // 不在这里设置 transport，让 factory 使用 transports.ts 中的配置
+};
+/**
+ * 生产环境配置
+ */
+exports.PRODUCTION_CONFIG = {
+    level: types_1.LogLevel.INFO,
+    redact: ["password", "token", "authorization", "cookie"],
+};
+/**
+ * 测试环境配置
+ */
+exports.TEST_CONFIG = {
+    level: types_1.LogLevel.WARN,
+};
+/**
+ * 根据环境获取配置
+ */
+function getEnvironmentConfig(env) {
+    const environment = env || process.env.NODE_ENV || "development";
+    switch (environment) {
+        case "production":
+        case "prod":
+            return exports.PRODUCTION_CONFIG;
+        case "test":
+        case "testing":
+            return exports.TEST_CONFIG;
+        case "development":
+        case "dev":
+        default:
+            return exports.DEVELOPMENT_CONFIG;
+    }
+}
+/**
+ * 从环境变量创建配置
+ */
+function createConfigFromEnv() {
+    const env = process.env;
+    const config = {};
+    if (env.LOG_LEVEL) {
+        config.level = env.LOG_LEVEL;
+    }
+    if (env.LOG_NAME) {
+        config.name = env.LOG_NAME;
+    }
+    return config;
+}
+/**
+ * 合并配置
+ */
+function mergeConfig(...configs) {
+    return configs.reduce((merged, config) => ({ ...merged, ...config }), {
+        ...exports.DEFAULT_CONFIG,
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AA2CA,oDAeC;AAKD,kDAaC;AAKD,kCAIC;AArFD,mCAAoE;AAEpE;;GAEG;AACU,QAAA,cAAc,GAAiB;IAC1C,KAAK,EAAE,gBAAQ,CAAC,IAAI;IACpB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE;QACJ,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;KACnC;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,kBAAkB,GAA0B;IACvD,KAAK,EAAE,gBAAQ,CAAC,KAAK;IACrB,mDAAmD;CACpD,CAAC;AAEF;;GAEG;AACU,QAAA,iBAAiB,GAA0B;IACtD,KAAK,EAAE,gBAAQ,CAAC,IAAI;IACpB,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC;CACzD,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAA0B;IAChD,KAAK,EAAE,gBAAQ,CAAC,IAAI;CACrB,CAAC;AAEF;;GAEG;AACH,SAAgB,oBAAoB,CAAC,GAAY;IAC/C,MAAM,WAAW,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;IAEjE,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,YAAY,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,yBAAiB,CAAC;QAC3B,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,mBAAW,CAAC;QACrB,KAAK,aAAa,CAAC;QACnB,KAAK,KAAK,CAAC;QACX;YACE,OAAO,0BAAkB,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,MAAM,GAAG,GAAsB,OAAO,CAAC,GAAG,CAAC;IAC3C,MAAM,MAAM,GAA0B,EAAE,CAAC;IAEzC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,SAAqB,CAAC;IAC3C,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,GAAG,OAAgC;IAC7D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE;QACpE,GAAG,sBAAc;KAClB,CAAiB,CAAC;AACrB,CAAC"}

package/dist/factory.d.ts

@@ -0,0 +1,14 @@
+import type { Logger, LoggerConfig } from './types';
+/**
+ * 创建 Logger 实例
+ */
+export declare function createLogger(name?: string, config?: Partial<LoggerConfig>): Logger;
+/**
+ * 创建带有上下文的 Logger
+ */
+export declare function createLoggerWithContext(name: string, context: Record<string, any>, config?: Partial<LoggerConfig>): Logger;
+/**
+ * 创建子 Logger
+ */
+export declare function createChildLogger(parent: Logger, bindings: Record<string, any>): Logger;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,MAAM,CA0CR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,MAAM,CAER"}

package/dist/factory.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+exports.createLoggerWithContext = createLoggerWithContext;
+exports.createChildLogger = createChildLogger;
+const pino_1 = __importDefault(require("pino"));
+const logger_1 = require("./logger");
+const config_1 = require("./config");
+const serializers_1 = require("./serializers");
+const formatters_1 = require("./formatters");
+const transports_1 = require("./transports");
+/**
+ * 创建 Logger 实例
+ */
+function createLogger(name, config) {
+    // 合并配置：默认配置 -> 环境配置 -> 环境变量配置 -> 用户配置
+    const envConfig = (0, config_1.getEnvironmentConfig)();
+    const envVarConfig = (0, config_1.createConfigFromEnv)();
+    const userConfig = config || {};
+    // 如果提供了名称，添加到配置中
+    if (name) {
+        userConfig.name = name;
+    }
+    const finalConfig = (0, config_1.mergeConfig)(envConfig, envVarConfig, userConfig);
+    // 设置默认序列化器和格式化器
+    if (!finalConfig.serializers) {
+        finalConfig.serializers = (0, serializers_1.getDefaultSerializers)();
+    }
+    if (!finalConfig.formatters) {
+        finalConfig.formatters = (0, formatters_1.getDefaultFormatters)();
+    }
+    // 设置传输
+    if (!finalConfig.transport) {
+        const transport = (0, transports_1.getEnvironmentTransport)();
+        if (transport) {
+            finalConfig.transport = transport;
+        }
+    }
+    // 创建 Pino Logger
+    const pinoLogger = (0, pino_1.default)(finalConfig);
+    // 如果有 name，创建一个 child logger 来包含 name
+    const loggerWithName = name ? pinoLogger.child({ name }) : pinoLogger;
+    // 返回 HestLogger 实例
+    return new logger_1.HestLogger(loggerWithName);
+}
+/**
+ * 创建带有上下文的 Logger
+ */
+function createLoggerWithContext(name, context, config) {
+    const logger = createLogger(name, config);
+    return logger.setContext(context);
+}
+/**
+ * 创建子 Logger
+ */
+function createChildLogger(parent, bindings) {
+    return parent.child(bindings);
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":";;;;;AAWA,oCA6CC;AAKD,0DAOC;AAKD,8CAKC;AA9ED,gDAAwB;AACxB,qCAAsC;AACtC,qCAAkF;AAClF,+CAAsD;AACtD,6CAAoD;AACpD,6CAAuD;AAGvD;;GAEG;AACH,SAAgB,YAAY,CAC1B,IAAa,EACb,MAA8B;IAE9B,sCAAsC;IACtC,MAAM,SAAS,GAAG,IAAA,6BAAoB,GAAE,CAAC;IACzC,MAAM,YAAY,GAAG,IAAA,4BAAmB,GAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,IAAI,EAAE,CAAC;IAEhC,iBAAiB;IACjB,IAAI,IAAI,EAAE,CAAC;QACT,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,oBAAW,EAC7B,SAAS,EACT,YAAY,EACZ,UAAU,CACX,CAAC;IAEF,gBAAgB;IAChB,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAC7B,WAAW,CAAC,WAAW,GAAG,IAAA,mCAAqB,GAAE,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAC5B,WAAW,CAAC,UAAU,GAAG,IAAA,iCAAoB,GAAE,CAAC;IAClD,CAAC;IAED,OAAO;IACP,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAA,oCAAuB,GAAE,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,CAAC,SAAS,GAAG,SAAS,CAAC;QACpC,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,MAAM,UAAU,GAAG,IAAA,cAAI,EAAC,WAAiC,CAAC,CAAC;IAE3D,sCAAsC;IACtC,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAEtE,mBAAmB;IACnB,OAAO,IAAI,mBAAU,CAAC,cAAc,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CACrC,IAAY,EACZ,OAA4B,EAC5B,MAA8B;IAE9B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,MAAc,EACd,QAA6B;IAE7B,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/formatters.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 日志级别格式化器 - 简洁版本，只保留数字级别
+ */
+export declare const levelFormatter: (_label: string, number: number) => {
+    level: number;
+};
+/**
+ * 时间戳格式化器
+ */
+export declare const timestampFormatter: () => {
+    timestamp: string;
+};
+/**
+ * 绑定数据格式化器 - 默认返回空对象，保持简洁
+ */
+export declare const bindingsFormatter: (_bindings: Record<string, any>) => {};
+/**
+ * 日志对象格式化器 - 标准化日志结构
+ */
+export declare const logFormatter: (object: Record<string, any>) => {
+    "@timestamp": any;
+    level: any;
+    message: any;
+};
+/**
+ * 错误格式化器 - 专门处理错误对象
+ */
+export declare const errorFormatter: (object: Record<string, any>) => Record<string, any>;
+/**
+ * 获取默认格式化器
+ */
+export declare function getDefaultFormatters(): {
+    level: (_label: string, number: number) => {
+        level: number;
+    };
+    bindings: (_bindings: Record<string, any>) => {};
+    log: (object: Record<string, any>) => Record<string, any>;
+};
+/**
+ * 创建自定义格式化器
+ */
+export declare function createFormatter<T = Record<string, any>>(fn: (object: T) => T): (object: T) => T;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,EAAE,QAAQ,MAAM;;CAS5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;CAI9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAa/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;CAUvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,wBAezD,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB;oBA5EG,MAAM,UAAU,MAAM;;;0BAuBhB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;kBAyD9C,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;EAMpC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GACnB,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAalB"}

package/dist/formatters.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorFormatter = exports.logFormatter = exports.bindingsFormatter = exports.timestampFormatter = exports.levelFormatter = void 0;
+exports.getDefaultFormatters = getDefaultFormatters;
+exports.createFormatter = createFormatter;
+/**
+ * 日志级别格式化器 - 简洁版本，只保留数字级别
+ */
+const levelFormatter = (_label, number) => {
+    return {
+        level: number,
+    };
+    //   return {
+    //   level: number,
+    //   levelLabel: label.toUpperCase(),
+    // };
+};
+exports.levelFormatter = levelFormatter;
+/**
+ * 时间戳格式化器
+ */
+const timestampFormatter = () => {
+    return {
+        timestamp: new Date().toISOString(),
+    };
+};
+exports.timestampFormatter = timestampFormatter;
+/**
+ * 绑定数据格式化器 - 默认返回空对象，保持简洁
+ */
+const bindingsFormatter = (_bindings) => {
+    // 默认不添加任何额外信息，保持日志简洁
+    return {};
+    // const { pid, hostname, ...rest } = bindings;
+    // return {
+    //   service: 'HestJS',
+    //   version: process.env.npm_package_version || '0.1.0',
+    //   environment: process.env.NODE_ENV || 'development',
+    //   pid,
+    //   hostname,
+    //   ...rest,
+    // };
+};
+exports.bindingsFormatter = bindingsFormatter;
+/**
+ * 日志对象格式化器 - 标准化日志结构
+ */
+const logFormatter = (object) => {
+    const { level, time, msg, ...rest } = object;
+    // 重组日志结构，确保关键字段在前
+    return {
+        "@timestamp": time,
+        level,
+        message: msg,
+        ...rest,
+    };
+};
+exports.logFormatter = logFormatter;
+/**
+ * 错误格式化器 - 专门处理错误对象
+ */
+const errorFormatter = (object) => {
+    if (object.err || object.error) {
+        const error = object.err || object.error;
+        return {
+            ...object,
+            error: {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+                ...(error.status && { status: error.status }),
+                ...(error.statusCode && { statusCode: error.statusCode }),
+            },
+        };
+    }
+    return object;
+};
+exports.errorFormatter = errorFormatter;
+/**
+ * 获取默认格式化器
+ */
+function getDefaultFormatters() {
+    return {
+        level: exports.levelFormatter,
+        bindings: exports.bindingsFormatter,
+        log: (object) => {
+            // 组合多个格式化器
+            const formatted = (0, exports.logFormatter)(object);
+            return (0, exports.errorFormatter)(formatted);
+        },
+    };
+}
+/**
+ * 创建自定义格式化器
+ */
+function createFormatter(fn) {
+    return (object) => {
+        try {
+            return fn(object);
+        }
+        catch (error) {
+            // 如果格式化失败，返回原始对象并添加错误信息
+            return {
+                ...object,
+                formatError: error instanceof Error ? error.message : "Unknown formatting error",
+            };
+        }
+    };
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":";;;AA+EA,oDAUC;AAKD,0CAeC;AA7GD;;GAEG;AACI,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE;IAC/D,OAAO;QACL,KAAK,EAAE,MAAM;KACd,CAAC;IAEF,aAAa;IACb,mBAAmB;IACnB,qCAAqC;IACrC,KAAK;AACP,CAAC,CAAC;AATW,QAAA,cAAc,kBASzB;AAEF;;GAEG;AACI,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC,CAAC;AAJW,QAAA,kBAAkB,sBAI7B;AAEF;;GAEG;AACI,MAAM,iBAAiB,GAAG,CAAC,SAA8B,EAAE,EAAE;IAClE,qBAAqB;IACrB,OAAO,EAAE,CAAC;IAEV,+CAA+C;IAC/C,WAAW;IACX,uBAAuB;IACvB,yDAAyD;IACzD,wDAAwD;IACxD,SAAS;IACT,cAAc;IACd,aAAa;IACb,KAAK;AACP,CAAC,CAAC;AAbW,QAAA,iBAAiB,qBAa5B;AAEF;;GAEG;AACI,MAAM,YAAY,GAAG,CAAC,MAA2B,EAAE,EAAE;IAC1D,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAE7C,kBAAkB;IAClB,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,KAAK;QACL,OAAO,EAAE,GAAG;QACZ,GAAG,IAAI;KACR,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,YAAY,gBAUvB;AAEF;;GAEG;AACI,MAAM,cAAc,GAAG,CAAC,MAA2B,EAAE,EAAE;IAC5D,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC;QACzC,OAAO;YACL,GAAG,MAAM;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC7C,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;aAC1D;SACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAfW,QAAA,cAAc,kBAezB;AAEF;;GAEG;AACH,SAAgB,oBAAoB;IAClC,OAAO;QACL,KAAK,EAAE,sBAAc;QACrB,QAAQ,EAAE,yBAAiB;QAC3B,GAAG,EAAE,CAAC,MAA2B,EAAE,EAAE;YACnC,WAAW;YACX,MAAM,SAAS,GAAG,IAAA,oBAAY,EAAC,MAAM,CAAC,CAAC;YACvC,OAAO,IAAA,sBAAc,EAAC,SAAS,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC7B,EAAoB;IAEpB,OAAO,CAAC,MAAS,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wBAAwB;YACxB,OAAO;gBACL,GAAG,MAAM;gBACT,WAAW,EACT,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;aACjE,CAAC;QACT,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}