@wsxjs/wsx-logger 0.0.18

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WSXJS Contributors
+
+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,86 @@
+# @wsxjs/wsx-logger
+
+Pino-based logging utility for WSXJS.
+
+## Installation
+
+```bash
+pnpm add @wsxjs/wsx-logger
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { createLogger } from "@wsxjs/wsx-logger";
+
+const logger = createLogger("MyComponent");
+
+logger.info("Component initialized");
+logger.debug("Debug information");
+logger.warn("Warning message");
+logger.error("Error occurred", error);
+```
+
+### Default Logger
+
+```typescript
+import { logger } from "@wsxjs/wsx-logger";
+
+logger.info("Application started");
+```
+
+### Custom Configuration
+
+```typescript
+import { createLoggerWithConfig } from "@wsxjs/wsx-logger";
+
+const logger = createLoggerWithConfig({
+    name: "MyApp",
+    level: "debug",
+    pretty: true, // Enable pretty printing in development
+});
+```
+
+### Advanced Usage with Pino
+
+```typescript
+import { createLogger, type PinoLogger } from "@wsxjs/wsx-logger";
+
+const wsxLogger = createLogger("MyComponent");
+const pinoLogger = wsxLogger.getPinoLogger(); // Access underlying pino logger
+
+// Use pino's advanced features
+pinoLogger.child({ component: "MyComponent" }).info("Child logger");
+```
+
+## Configuration
+
+### Environment Variables
+
+- `NODE_ENV=production`: Automatically sets log level to `info` and disables pretty printing
+- `NODE_ENV=development`: Automatically sets log level to `debug` and enables pretty printing
+
+### Log Levels
+
+- `trace` - Most verbose
+- `debug` - Debug information
+- `info` - General information (default in production)
+- `warn` - Warnings
+- `error` - Errors
+- `fatal` - Fatal errors
+
+## Features
+
+- ✅ Pino-based high-performance logging
+- ✅ Pretty printing in development
+- ✅ Compatible with WSXJS core logger interface
+- ✅ TypeScript support
+- ✅ Environment-aware configuration
+- ✅ Component-specific loggers
+
+## License
+
+MIT
+

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("pino");function g(){return typeof process<"u"&&process.env.NODE_ENV==="production"}function p(){var n;return typeof process<"u"&&((n=process.versions)==null?void 0:n.node)!==void 0}function c(){return typeof window<"u"&&typeof document<"u"}const l={name:"WSX",level:g()?"info":"debug",pretty:!g()};function u(n={}){const{name:e,level:o,pretty:f,pinoOptions:r}={...l,...n},i={name:e||l.name,level:o||l.level,...r};if(c()&&(i.browser={asObject:!1,write:void 0,...(r==null?void 0:r.browser)||{}}),f&&p()&&!g())try{return t(i,t.transport({target:"pino-pretty",options:{colorize:!0,translateTime:"HH:MM:ss.l",ignore:"pid,hostname",singleLine:!1}}))}catch{return console.warn("[wsx-logger] pino-pretty not available, using default formatter"),t(i)}return t(i)}class s{constructor(e={}){this.isProd=g(),this.pinoLogger=u(e)}debug(e,...o){this.isProd||(o.length>0?this.pinoLogger.debug({args:o},e):this.pinoLogger.debug(e))}info(e,...o){this.isProd?o.length>0?this.pinoLogger.info({args:o},e):this.pinoLogger.info(e):o.length>0?this.pinoLogger.info({args:o},e):this.pinoLogger.info(e)}warn(e,...o){o.length>0?this.pinoLogger.warn({args:o},e):this.pinoLogger.warn(e)}error(e,...o){o.length>0?this.pinoLogger.error({args:o},e):this.pinoLogger.error(e)}fatal(e,...o){o.length>0?this.pinoLogger.fatal({args:o},e):this.pinoLogger.fatal(e)}trace(e,...o){this.isProd||(o.length>0?this.pinoLogger.trace({args:o},e):this.pinoLogger.trace(e))}getPinoLogger(){return this.pinoLogger}}const h=new s;function d(n,e={}){return new s({...e,name:e.name||`WSX:${n}`})}function a(n){return new s(n)}Object.defineProperty(exports,"pino",{enumerable:!0,get:()=>t.pino});exports.WSXLogger=s;exports.createLogger=d;exports.createLoggerWithConfig=a;exports.logger=h;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["/**\n * @wsxjs/wsx-logger\n * Pino-based logging utility for WSXJS\n */\n\nimport pino, { type LoggerOptions } from \"pino\";\nimport type { Logger as PinoLoggerType } from \"pino\";\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\" | \"trace\";\n\n/**\n * Logger interface compatible with WSXJS core logger\n */\nexport interface Logger {\n    debug(message: string, ...args: unknown[]): void;\n    info(message: string, ...args: unknown[]): void;\n    warn(message: string, ...args: unknown[]): void;\n    error(message: string, ...args: unknown[]): void;\n    fatal?(message: string, ...args: unknown[]): void;\n    trace?(message: string, ...args: unknown[]): void;\n}\n\n/**\n * Logger configuration options\n */\nexport interface LoggerConfig {\n    /** Logger name/prefix */\n    name?: string;\n    /** Minimum log level */\n    level?: LogLevel;\n    /** Enable pretty printing (for development) */\n    pretty?: boolean;\n    /** Additional pino options */\n    pinoOptions?: LoggerOptions;\n}\n\n/**\n * Check if we're in production environment\n */\nfunction isProduction(): boolean {\n    return typeof process !== \"undefined\" && process.env.NODE_ENV === \"production\";\n}\n\n/**\n * Check if we're in a Node.js environment\n */\nfunction isNodeEnvironment(): boolean {\n    return typeof process !== \"undefined\" && process.versions?.node !== undefined;\n}\n\n/**\n * Check if we're in a browser environment\n */\nfunction isBrowserEnvironment(): boolean {\n    return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\n/**\n * Default logger configuration\n * - Production: info level, no pretty printing\n * - Development: debug level, pretty printing enabled\n */\nconst DEFAULT_CONFIG: LoggerConfig = {\n    name: \"WSX\",\n    level: isProduction() ? \"info\" : \"debug\",\n    pretty: !isProduction(),\n};\n\n/**\n * Create a pino logger instance\n */\nfunction createPinoLogger(config: LoggerConfig = {}): PinoLoggerType {\n    const { name, level, pretty, pinoOptions } = { ...DEFAULT_CONFIG, ...config };\n\n    const options: LoggerOptions = {\n        name: name || DEFAULT_CONFIG.name,\n        level: level || DEFAULT_CONFIG.level,\n        ...pinoOptions,\n    };\n\n    // Configure browser-specific options if in browser environment\n    if (isBrowserEnvironment()) {\n        // In browser, pino automatically uses console methods\n        // We can optionally configure browser-specific behavior\n        options.browser = {\n            asObject: false, // Use console methods directly (default behavior)\n            write: undefined, // Use default console write\n            ...(pinoOptions?.browser || {}), // Allow override via pinoOptions\n        };\n    }\n\n    // In development and Node.js environment, use pino-pretty for better readability\n    if (pretty && isNodeEnvironment() && !isProduction()) {\n        try {\n            return pino(\n                options,\n                pino.transport({\n                    target: \"pino-pretty\",\n                    options: {\n                        colorize: true,\n                        translateTime: \"HH:MM:ss.l\",\n                        ignore: \"pid,hostname\",\n                        singleLine: false,\n                    },\n                })\n            );\n        } catch {\n            // Fallback to regular pino if pino-pretty is not available\n            console.warn(\"[wsx-logger] pino-pretty not available, using default formatter\");\n            return pino(options);\n        }\n    }\n\n    return pino(options);\n}\n\n/**\n * WSX Logger wrapper that implements the Logger interface\n * and uses pino under the hood\n */\nexport class WSXLogger implements Logger {\n    private pinoLogger: PinoLoggerType;\n    private isProd: boolean;\n\n    constructor(config: LoggerConfig = {}) {\n        this.isProd = isProduction();\n        this.pinoLogger = createPinoLogger(config);\n    }\n\n    debug(message: string, ...args: unknown[]): void {\n        // Always show debug logs in non-production environments\n        if (!this.isProd) {\n            if (args.length > 0) {\n                this.pinoLogger.debug({ args }, message);\n            } else {\n                this.pinoLogger.debug(message);\n            }\n        }\n    }\n\n    info(message: string, ...args: unknown[]): void {\n        // Always show info logs in non-production environments\n        if (!this.isProd) {\n            if (args.length > 0) {\n                this.pinoLogger.info({ args }, message);\n            } else {\n                this.pinoLogger.info(message);\n            }\n        } else {\n            // In production, respect pino's level configuration\n            if (args.length > 0) {\n                this.pinoLogger.info({ args }, message);\n            } else {\n                this.pinoLogger.info(message);\n            }\n        }\n    }\n\n    warn(message: string, ...args: unknown[]): void {\n        // Always show warnings (in both production and development)\n        if (args.length > 0) {\n            this.pinoLogger.warn({ args }, message);\n        } else {\n            this.pinoLogger.warn(message);\n        }\n    }\n\n    error(message: string, ...args: unknown[]): void {\n        // Always show errors (in both production and development)\n        if (args.length > 0) {\n            this.pinoLogger.error({ args }, message);\n        } else {\n            this.pinoLogger.error(message);\n        }\n    }\n\n    fatal(message: string, ...args: unknown[]): void {\n        if (args.length > 0) {\n            this.pinoLogger.fatal({ args }, message);\n        } else {\n            this.pinoLogger.fatal(message);\n        }\n    }\n\n    trace(message: string, ...args: unknown[]): void {\n        // Always show trace logs in non-production environments\n        if (!this.isProd) {\n            if (args.length > 0) {\n                this.pinoLogger.trace({ args }, message);\n            } else {\n                this.pinoLogger.trace(message);\n            }\n        }\n    }\n\n    /**\n     * Get the underlying pino logger instance\n     */\n    getPinoLogger(): PinoLoggerType {\n        return this.pinoLogger;\n    }\n}\n\n/**\n * Default logger instance\n */\nexport const logger = new WSXLogger();\n\n/**\n * Create a component-specific logger\n *\n * @param componentName - Name of the component/module\n * @param config - Optional logger configuration\n * @returns Logger instance\n */\nexport function createLogger(componentName: string, config: LoggerConfig = {}): Logger {\n    return new WSXLogger({\n        ...config,\n        name: config.name || `WSX:${componentName}`,\n    });\n}\n\n/**\n * Create a logger with custom configuration\n *\n * @param config - Logger configuration\n * @returns Logger instance\n */\nexport function createLoggerWithConfig(config: LoggerConfig): Logger {\n    return new WSXLogger(config);\n}\n\n// Export pino types for advanced usage\nexport type { Logger as PinoLogger, LoggerOptions } from \"pino\";\nexport { pino } from \"pino\";\n"],"names":["isProduction","isNodeEnvironment","_a","isBrowserEnvironment","DEFAULT_CONFIG","createPinoLogger","config","name","level","pretty","pinoOptions","options","pino","WSXLogger","message","args","logger","createLogger","componentName","createLoggerWithConfig"],"mappings":"wGAuCA,SAASA,GAAwB,CAC7B,OAAO,OAAO,QAAY,KAAe,QAAQ,IAAI,WAAa,YACtE,CAKA,SAASC,GAA6B,OAClC,OAAO,OAAO,QAAY,OAAeC,EAAA,QAAQ,WAAR,YAAAA,EAAkB,QAAS,MACxE,CAKA,SAASC,GAAgC,CACrC,OAAO,OAAO,OAAW,KAAe,OAAO,SAAa,GAChE,CAOA,MAAMC,EAA+B,CACjC,KAAM,MACN,MAAOJ,IAAiB,OAAS,QACjC,OAAQ,CAACA,EAAA,CACb,EAKA,SAASK,EAAiBC,EAAuB,GAAoB,CACjE,KAAM,CAAE,KAAAC,EAAM,MAAAC,EAAO,OAAAC,EAAQ,YAAAC,CAAA,EAAgB,CAAE,GAAGN,EAAgB,GAAGE,CAAA,EAE/DK,EAAyB,CAC3B,KAAMJ,GAAQH,EAAe,KAC7B,MAAOI,GAASJ,EAAe,MAC/B,GAAGM,CAAA,EAeP,GAXIP,MAGAQ,EAAQ,QAAU,CACd,SAAU,GACV,MAAO,OACP,IAAID,GAAA,YAAAA,EAAa,UAAW,CAAA,CAAC,GAKjCD,GAAUR,KAAuB,CAACD,IAClC,GAAI,CACA,OAAOY,EACHD,EACAC,EAAK,UAAU,CACX,OAAQ,cACR,QAAS,CACL,SAAU,GACV,cAAe,aACf,OAAQ,eACR,WAAY,EAAA,CAChB,CACH,CAAA,CAET,MAAQ,CAEJ,eAAQ,KAAK,iEAAiE,EACvEA,EAAKD,CAAO,CACvB,CAGJ,OAAOC,EAAKD,CAAO,CACvB,CAMO,MAAME,CAA4B,CAIrC,YAAYP,EAAuB,GAAI,CACnC,KAAK,OAASN,EAAA,EACd,KAAK,WAAaK,EAAiBC,CAAM,CAC7C,CAEA,MAAMQ,KAAoBC,EAAuB,CAExC,KAAK,SACFA,EAAK,OAAS,EACd,KAAK,WAAW,MAAM,CAAE,KAAAA,CAAA,EAAQD,CAAO,EAEvC,KAAK,WAAW,MAAMA,CAAO,EAGzC,CAEA,KAAKA,KAAoBC,EAAuB,CAEvC,KAAK,OAQFA,EAAK,OAAS,EACd,KAAK,WAAW,KAAK,CAAE,KAAAA,CAAA,EAAQD,CAAO,EAEtC,KAAK,WAAW,KAAKA,CAAO,EAV5BC,EAAK,OAAS,EACd,KAAK,WAAW,KAAK,CAAE,KAAAA,CAAA,EAAQD,CAAO,EAEtC,KAAK,WAAW,KAAKA,CAAO,CAUxC,CAEA,KAAKA,KAAoBC,EAAuB,CAExCA,EAAK,OAAS,EACd,KAAK,WAAW,KAAK,CAAE,KAAAA,CAAA,EAAQD,CAAO,EAEtC,KAAK,WAAW,KAAKA,CAAO,CAEpC,CAEA,MAAMA,KAAoBC,EAAuB,CAEzCA,EAAK,OAAS,EACd,KAAK,WAAW,MAAM,CAAE,KAAAA,CAAA,EAAQD,CAAO,EAEvC,KAAK,WAAW,MAAMA,CAAO,CAErC,CAEA,MAAMA,KAAoBC,EAAuB,CACzCA,EAAK,OAAS,EACd,KAAK,WAAW,MAAM,CAAE,KAAAA,CAAA,EAAQD,CAAO,EAEvC,KAAK,WAAW,MAAMA,CAAO,CAErC,CAEA,MAAMA,KAAoBC,EAAuB,CAExC,KAAK,SACFA,EAAK,OAAS,EACd,KAAK,WAAW,MAAM,CAAE,KAAAA,CAAA,EAAQD,CAAO,EAEvC,KAAK,WAAW,MAAMA,CAAO,EAGzC,CAKA,eAAgC,CAC5B,OAAO,KAAK,UAChB,CACJ,CAKO,MAAME,EAAS,IAAIH,EASnB,SAASI,EAAaC,EAAuBZ,EAAuB,GAAY,CACnF,OAAO,IAAIO,EAAU,CACjB,GAAGP,EACH,KAAMA,EAAO,MAAQ,OAAOY,CAAa,EAAA,CAC5C,CACL,CAQO,SAASC,EAAuBb,EAA8B,CACjE,OAAO,IAAIO,EAAUP,CAAM,CAC/B"}

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @wsxjs/wsx-logger
+ * Pino-based logging utility for WSXJS
+ */
+import { type LoggerOptions } from "pino";
+import type { Logger as PinoLoggerType } from "pino";
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal" | "trace";
+/**
+ * Logger interface compatible with WSXJS core logger
+ */
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    fatal?(message: string, ...args: unknown[]): void;
+    trace?(message: string, ...args: unknown[]): void;
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Logger name/prefix */
+    name?: string;
+    /** Minimum log level */
+    level?: LogLevel;
+    /** Enable pretty printing (for development) */
+    pretty?: boolean;
+    /** Additional pino options */
+    pinoOptions?: LoggerOptions;
+}
+/**
+ * WSX Logger wrapper that implements the Logger interface
+ * and uses pino under the hood
+ */
+export declare class WSXLogger implements Logger {
+    private pinoLogger;
+    private isProd;
+    constructor(config?: LoggerConfig);
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    fatal(message: string, ...args: unknown[]): void;
+    trace(message: string, ...args: unknown[]): void;
+    /**
+     * Get the underlying pino logger instance
+     */
+    getPinoLogger(): PinoLoggerType;
+}
+/**
+ * Default logger instance
+ */
+export declare const logger: WSXLogger;
+/**
+ * Create a component-specific logger
+ *
+ * @param componentName - Name of the component/module
+ * @param config - Optional logger configuration
+ * @returns Logger instance
+ */
+export declare function createLogger(componentName: string, config?: LoggerConfig): Logger;
+/**
+ * Create a logger with custom configuration
+ *
+ * @param config - Logger configuration
+ * @returns Logger instance
+ */
+export declare function createLoggerWithConfig(config: LoggerConfig): Logger;
+export type { Logger as PinoLogger, LoggerOptions } from "pino";
+export { pino } from "pino";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAa,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,MAAM,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAClD,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC;CAC/B;AAkFD;;;GAGG;AACH,qBAAa,SAAU,YAAW,MAAM;IACpC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,MAAM,CAAU;gBAEZ,MAAM,GAAE,YAAiB;IAKrC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAWhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAkB/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAS/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAShD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAQhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAWhD;;OAEG;IACH,aAAa,IAAI,cAAc;CAGlC;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,WAAkB,CAAC;AAEtC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiB,GAAG,MAAM,CAKrF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEnE;AAGD,YAAY,EAAE,MAAM,IAAI,UAAU,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,96 @@
+import r from "pino";
+import { pino as y } from "pino";
+function g() {
+  return typeof process < "u" && process.env.NODE_ENV === "production";
+}
+function p() {
+  var n;
+  return typeof process < "u" && ((n = process.versions) == null ? void 0 : n.node) !== void 0;
+}
+function c() {
+  return typeof window < "u" && typeof document < "u";
+}
+const s = {
+  name: "WSX",
+  level: g() ? "info" : "debug",
+  pretty: !g()
+};
+function h(n = {}) {
+  const { name: e, level: o, pretty: l, pinoOptions: i } = { ...s, ...n }, t = {
+    name: e || s.name,
+    level: o || s.level,
+    ...i
+  };
+  if (c() && (t.browser = {
+    asObject: !1,
+    // Use console methods directly (default behavior)
+    write: void 0,
+    // Use default console write
+    ...(i == null ? void 0 : i.browser) || {}
+    // Allow override via pinoOptions
+  }), l && p() && !g())
+    try {
+      return r(
+        t,
+        r.transport({
+          target: "pino-pretty",
+          options: {
+            colorize: !0,
+            translateTime: "HH:MM:ss.l",
+            ignore: "pid,hostname",
+            singleLine: !1
+          }
+        })
+      );
+    } catch {
+      return console.warn("[wsx-logger] pino-pretty not available, using default formatter"), r(t);
+    }
+  return r(t);
+}
+class f {
+  constructor(e = {}) {
+    this.isProd = g(), this.pinoLogger = h(e);
+  }
+  debug(e, ...o) {
+    this.isProd || (o.length > 0 ? this.pinoLogger.debug({ args: o }, e) : this.pinoLogger.debug(e));
+  }
+  info(e, ...o) {
+    this.isProd ? o.length > 0 ? this.pinoLogger.info({ args: o }, e) : this.pinoLogger.info(e) : o.length > 0 ? this.pinoLogger.info({ args: o }, e) : this.pinoLogger.info(e);
+  }
+  warn(e, ...o) {
+    o.length > 0 ? this.pinoLogger.warn({ args: o }, e) : this.pinoLogger.warn(e);
+  }
+  error(e, ...o) {
+    o.length > 0 ? this.pinoLogger.error({ args: o }, e) : this.pinoLogger.error(e);
+  }
+  fatal(e, ...o) {
+    o.length > 0 ? this.pinoLogger.fatal({ args: o }, e) : this.pinoLogger.fatal(e);
+  }
+  trace(e, ...o) {
+    this.isProd || (o.length > 0 ? this.pinoLogger.trace({ args: o }, e) : this.pinoLogger.trace(e));
+  }
+  /**
+   * Get the underlying pino logger instance
+   */
+  getPinoLogger() {
+    return this.pinoLogger;
+  }
+}
+const d = new f();
+function L(n, e = {}) {
+  return new f({
+    ...e,
+    name: e.name || `WSX:${n}`
+  });
+}
+function a(n) {
+  return new f(n);
+}
+export {
+  f as WSXLogger,
+  L as createLogger,
+  a as createLoggerWithConfig,
+  d as logger,
+  y as pino
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * @wsxjs/wsx-logger\n * Pino-based logging utility for WSXJS\n */\n\nimport pino, { type LoggerOptions } from \"pino\";\nimport type { Logger as PinoLoggerType } from \"pino\";\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\" | \"trace\";\n\n/**\n * Logger interface compatible with WSXJS core logger\n */\nexport interface Logger {\n    debug(message: string, ...args: unknown[]): void;\n    info(message: string, ...args: unknown[]): void;\n    warn(message: string, ...args: unknown[]): void;\n    error(message: string, ...args: unknown[]): void;\n    fatal?(message: string, ...args: unknown[]): void;\n    trace?(message: string, ...args: unknown[]): void;\n}\n\n/**\n * Logger configuration options\n */\nexport interface LoggerConfig {\n    /** Logger name/prefix */\n    name?: string;\n    /** Minimum log level */\n    level?: LogLevel;\n    /** Enable pretty printing (for development) */\n    pretty?: boolean;\n    /** Additional pino options */\n    pinoOptions?: LoggerOptions;\n}\n\n/**\n * Check if we're in production environment\n */\nfunction isProduction(): boolean {\n    return typeof process !== \"undefined\" && process.env.NODE_ENV === \"production\";\n}\n\n/**\n * Check if we're in a Node.js environment\n */\nfunction isNodeEnvironment(): boolean {\n    return typeof process !== \"undefined\" && process.versions?.node !== undefined;\n}\n\n/**\n * Check if we're in a browser environment\n */\nfunction isBrowserEnvironment(): boolean {\n    return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\n/**\n * Default logger configuration\n * - Production: info level, no pretty printing\n * - Development: debug level, pretty printing enabled\n */\nconst DEFAULT_CONFIG: LoggerConfig = {\n    name: \"WSX\",\n    level: isProduction() ? \"info\" : \"debug\",\n    pretty: !isProduction(),\n};\n\n/**\n * Create a pino logger instance\n */\nfunction createPinoLogger(config: LoggerConfig = {}): PinoLoggerType {\n    const { name, level, pretty, pinoOptions } = { ...DEFAULT_CONFIG, ...config };\n\n    const options: LoggerOptions = {\n        name: name || DEFAULT_CONFIG.name,\n        level: level || DEFAULT_CONFIG.level,\n        ...pinoOptions,\n    };\n\n    // Configure browser-specific options if in browser environment\n    if (isBrowserEnvironment()) {\n        // In browser, pino automatically uses console methods\n        // We can optionally configure browser-specific behavior\n        options.browser = {\n            asObject: false, // Use console methods directly (default behavior)\n            write: undefined, // Use default console write\n            ...(pinoOptions?.browser || {}), // Allow override via pinoOptions\n        };\n    }\n\n    // In development and Node.js environment, use pino-pretty for better readability\n    if (pretty && isNodeEnvironment() && !isProduction()) {\n        try {\n            return pino(\n                options,\n                pino.transport({\n                    target: \"pino-pretty\",\n                    options: {\n                        colorize: true,\n                        translateTime: \"HH:MM:ss.l\",\n                        ignore: \"pid,hostname\",\n                        singleLine: false,\n                    },\n                })\n            );\n        } catch {\n            // Fallback to regular pino if pino-pretty is not available\n            console.warn(\"[wsx-logger] pino-pretty not available, using default formatter\");\n            return pino(options);\n        }\n    }\n\n    return pino(options);\n}\n\n/**\n * WSX Logger wrapper that implements the Logger interface\n * and uses pino under the hood\n */\nexport class WSXLogger implements Logger {\n    private pinoLogger: PinoLoggerType;\n    private isProd: boolean;\n\n    constructor(config: LoggerConfig = {}) {\n        this.isProd = isProduction();\n        this.pinoLogger = createPinoLogger(config);\n    }\n\n    debug(message: string, ...args: unknown[]): void {\n        // Always show debug logs in non-production environments\n        if (!this.isProd) {\n            if (args.length > 0) {\n                this.pinoLogger.debug({ args }, message);\n            } else {\n                this.pinoLogger.debug(message);\n            }\n        }\n    }\n\n    info(message: string, ...args: unknown[]): void {\n        // Always show info logs in non-production environments\n        if (!this.isProd) {\n            if (args.length > 0) {\n                this.pinoLogger.info({ args }, message);\n            } else {\n                this.pinoLogger.info(message);\n            }\n        } else {\n            // In production, respect pino's level configuration\n            if (args.length > 0) {\n                this.pinoLogger.info({ args }, message);\n            } else {\n                this.pinoLogger.info(message);\n            }\n        }\n    }\n\n    warn(message: string, ...args: unknown[]): void {\n        // Always show warnings (in both production and development)\n        if (args.length > 0) {\n            this.pinoLogger.warn({ args }, message);\n        } else {\n            this.pinoLogger.warn(message);\n        }\n    }\n\n    error(message: string, ...args: unknown[]): void {\n        // Always show errors (in both production and development)\n        if (args.length > 0) {\n            this.pinoLogger.error({ args }, message);\n        } else {\n            this.pinoLogger.error(message);\n        }\n    }\n\n    fatal(message: string, ...args: unknown[]): void {\n        if (args.length > 0) {\n            this.pinoLogger.fatal({ args }, message);\n        } else {\n            this.pinoLogger.fatal(message);\n        }\n    }\n\n    trace(message: string, ...args: unknown[]): void {\n        // Always show trace logs in non-production environments\n        if (!this.isProd) {\n            if (args.length > 0) {\n                this.pinoLogger.trace({ args }, message);\n            } else {\n                this.pinoLogger.trace(message);\n            }\n        }\n    }\n\n    /**\n     * Get the underlying pino logger instance\n     */\n    getPinoLogger(): PinoLoggerType {\n        return this.pinoLogger;\n    }\n}\n\n/**\n * Default logger instance\n */\nexport const logger = new WSXLogger();\n\n/**\n * Create a component-specific logger\n *\n * @param componentName - Name of the component/module\n * @param config - Optional logger configuration\n * @returns Logger instance\n */\nexport function createLogger(componentName: string, config: LoggerConfig = {}): Logger {\n    return new WSXLogger({\n        ...config,\n        name: config.name || `WSX:${componentName}`,\n    });\n}\n\n/**\n * Create a logger with custom configuration\n *\n * @param config - Logger configuration\n * @returns Logger instance\n */\nexport function createLoggerWithConfig(config: LoggerConfig): Logger {\n    return new WSXLogger(config);\n}\n\n// Export pino types for advanced usage\nexport type { Logger as PinoLogger, LoggerOptions } from \"pino\";\nexport { pino } from \"pino\";\n"],"names":["isProduction","isNodeEnvironment","_a","isBrowserEnvironment","DEFAULT_CONFIG","createPinoLogger","config","name","level","pretty","pinoOptions","options","pino","WSXLogger","message","args","logger","createLogger","componentName","createLoggerWithConfig"],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@wsxjs/wsx-logger",
+  "version": "0.0.18",
+  "description": "WSXJS Logger - Pino-based logging utility for WSXJS",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/__tests__",
+    "!**/test"
+  ],
+  "dependencies": {
+    "pino": "^9.6.0",
+    "pino-pretty": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.37.0",
+    "@typescript-eslint/parser": "^8.37.0",
+    "eslint": "^9.31.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.4.19"
+  },
+  "keywords": [
+    "wsx",
+    "logger",
+    "pino",
+    "logging",
+    "web-components"
+  ],
+  "author": "WSXJS Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wsxjs/wsxjs.git",
+    "directory": "packages/logger"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist src/index.ts --moduleResolution node --esModuleInterop",
+    "build:dev": "NODE_ENV=development vite build && tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist src/index.ts --moduleResolution node --esModuleInterop",
+    "dev": "NODE_ENV=development vite build --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  }
+}

package/src/index.ts

@@ -0,0 +1,235 @@
+/**
+ * @wsxjs/wsx-logger
+ * Pino-based logging utility for WSXJS
+ */
+
+import pino, { type LoggerOptions } from "pino";
+import type { Logger as PinoLoggerType } from "pino";
+
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal" | "trace";
+
+/**
+ * Logger interface compatible with WSXJS core logger
+ */
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    fatal?(message: string, ...args: unknown[]): void;
+    trace?(message: string, ...args: unknown[]): void;
+}
+
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Logger name/prefix */
+    name?: string;
+    /** Minimum log level */
+    level?: LogLevel;
+    /** Enable pretty printing (for development) */
+    pretty?: boolean;
+    /** Additional pino options */
+    pinoOptions?: LoggerOptions;
+}
+
+/**
+ * Check if we're in production environment
+ */
+function isProduction(): boolean {
+    return typeof process !== "undefined" && process.env.NODE_ENV === "production";
+}
+
+/**
+ * Check if we're in a Node.js environment
+ */
+function isNodeEnvironment(): boolean {
+    return typeof process !== "undefined" && process.versions?.node !== undefined;
+}
+
+/**
+ * Check if we're in a browser environment
+ */
+function isBrowserEnvironment(): boolean {
+    return typeof window !== "undefined" && typeof document !== "undefined";
+}
+
+/**
+ * Default logger configuration
+ * - Production: info level, no pretty printing
+ * - Development: debug level, pretty printing enabled
+ */
+const DEFAULT_CONFIG: LoggerConfig = {
+    name: "WSX",
+    level: isProduction() ? "info" : "debug",
+    pretty: !isProduction(),
+};
+
+/**
+ * Create a pino logger instance
+ */
+function createPinoLogger(config: LoggerConfig = {}): PinoLoggerType {
+    const { name, level, pretty, pinoOptions } = { ...DEFAULT_CONFIG, ...config };
+
+    const options: LoggerOptions = {
+        name: name || DEFAULT_CONFIG.name,
+        level: level || DEFAULT_CONFIG.level,
+        ...pinoOptions,
+    };
+
+    // Configure browser-specific options if in browser environment
+    if (isBrowserEnvironment()) {
+        // In browser, pino automatically uses console methods
+        // We can optionally configure browser-specific behavior
+        options.browser = {
+            asObject: false, // Use console methods directly (default behavior)
+            write: undefined, // Use default console write
+            ...(pinoOptions?.browser || {}), // Allow override via pinoOptions
+        };
+    }
+
+    // In development and Node.js environment, use pino-pretty for better readability
+    if (pretty && isNodeEnvironment() && !isProduction()) {
+        try {
+            return pino(
+                options,
+                pino.transport({
+                    target: "pino-pretty",
+                    options: {
+                        colorize: true,
+                        translateTime: "HH:MM:ss.l",
+                        ignore: "pid,hostname",
+                        singleLine: false,
+                    },
+                })
+            );
+        } catch {
+            // Fallback to regular pino if pino-pretty is not available
+            console.warn("[wsx-logger] pino-pretty not available, using default formatter");
+            return pino(options);
+        }
+    }
+
+    return pino(options);
+}
+
+/**
+ * WSX Logger wrapper that implements the Logger interface
+ * and uses pino under the hood
+ */
+export class WSXLogger implements Logger {
+    private pinoLogger: PinoLoggerType;
+    private isProd: boolean;
+
+    constructor(config: LoggerConfig = {}) {
+        this.isProd = isProduction();
+        this.pinoLogger = createPinoLogger(config);
+    }
+
+    debug(message: string, ...args: unknown[]): void {
+        // Always show debug logs in non-production environments
+        if (!this.isProd) {
+            if (args.length > 0) {
+                this.pinoLogger.debug({ args }, message);
+            } else {
+                this.pinoLogger.debug(message);
+            }
+        }
+    }
+
+    info(message: string, ...args: unknown[]): void {
+        // Always show info logs in non-production environments
+        if (!this.isProd) {
+            if (args.length > 0) {
+                this.pinoLogger.info({ args }, message);
+            } else {
+                this.pinoLogger.info(message);
+            }
+        } else {
+            // In production, respect pino's level configuration
+            if (args.length > 0) {
+                this.pinoLogger.info({ args }, message);
+            } else {
+                this.pinoLogger.info(message);
+            }
+        }
+    }
+
+    warn(message: string, ...args: unknown[]): void {
+        // Always show warnings (in both production and development)
+        if (args.length > 0) {
+            this.pinoLogger.warn({ args }, message);
+        } else {
+            this.pinoLogger.warn(message);
+        }
+    }
+
+    error(message: string, ...args: unknown[]): void {
+        // Always show errors (in both production and development)
+        if (args.length > 0) {
+            this.pinoLogger.error({ args }, message);
+        } else {
+            this.pinoLogger.error(message);
+        }
+    }
+
+    fatal(message: string, ...args: unknown[]): void {
+        if (args.length > 0) {
+            this.pinoLogger.fatal({ args }, message);
+        } else {
+            this.pinoLogger.fatal(message);
+        }
+    }
+
+    trace(message: string, ...args: unknown[]): void {
+        // Always show trace logs in non-production environments
+        if (!this.isProd) {
+            if (args.length > 0) {
+                this.pinoLogger.trace({ args }, message);
+            } else {
+                this.pinoLogger.trace(message);
+            }
+        }
+    }
+
+    /**
+     * Get the underlying pino logger instance
+     */
+    getPinoLogger(): PinoLoggerType {
+        return this.pinoLogger;
+    }
+}
+
+/**
+ * Default logger instance
+ */
+export const logger = new WSXLogger();
+
+/**
+ * Create a component-specific logger
+ *
+ * @param componentName - Name of the component/module
+ * @param config - Optional logger configuration
+ * @returns Logger instance
+ */
+export function createLogger(componentName: string, config: LoggerConfig = {}): Logger {
+    return new WSXLogger({
+        ...config,
+        name: config.name || `WSX:${componentName}`,
+    });
+}
+
+/**
+ * Create a logger with custom configuration
+ *
+ * @param config - Logger configuration
+ * @returns Logger instance
+ */
+export function createLoggerWithConfig(config: LoggerConfig): Logger {
+    return new WSXLogger(config);
+}
+
+// Export pino types for advanced usage
+export type { Logger as PinoLogger, LoggerOptions } from "pino";
+export { pino } from "pino";