@x-oasis/log 0.1.1

package/dist/log.cjs.production.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.cjs.production.min.js","sources":["../src/types.ts","../src/utils.ts","../src/logger.ts","../src/index.ts"],"sourcesContent":["/**\n * Log levels in order of severity\n */\nexport enum LogLevel {\n  TRACE = 0,\n  DEBUG = 1,\n  INFO = 2,\n  WARN = 3,\n  ERROR = 4,\n  SILENT = 5,\n}\n\n/**\n * Log entry data structure\n */\nexport interface LogEntry {\n  level: LogLevel;\n  message: string;\n  timestamp: number;\n  context?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n  error?: Error;\n  prefix?: string;\n}\n\n/**\n * Output handler function type\n */\nexport type OutputHandler = (entry: LogEntry) => void;\n\n/**\n * Logger configuration options\n */\nexport interface LoggerOptions {\n  /**\n   * Minimum log level to output (default: LogLevel.INFO)\n   */\n  level?: LogLevel | keyof typeof LogLevel;\n\n  /**\n   * Custom output handler (default: console)\n   */\n  handler?: OutputHandler;\n\n  /**\n   * Enable timestamps in log entries (default: true)\n   */\n  enableTimestamp?: boolean;\n\n  /**\n   * Default context that will be included in all logs\n   */\n  defaultContext?: Record<string, unknown>;\n\n  /**\n   * Default prefix for all log messages\n   */\n  defaultPrefix?: string;\n}\n\n/**\n * Chainable logger interface\n */\nexport interface LoggerChain {\n  /**\n   * Add context data that will be included in this log entry\n   */\n  withContext(context: Record<string, unknown>): LoggerChain;\n\n  /**\n   * Add metadata that will be included in this log entry\n   */\n  withMetadata(metadata: Record<string, unknown>): LoggerChain;\n\n  /**\n   * Add an error object to this log entry\n   */\n  withError(error: Error): LoggerChain;\n\n  /**\n   * Add a prefix to this log message\n   */\n  withPrefix(prefix: string): LoggerChain;\n\n  /**\n   * Log at trace level\n   */\n  trace(message: string): void;\n\n  /**\n   * Log at debug level\n   */\n  debug(message: string): void;\n\n  /**\n   * Log at info level\n   */\n  info(message: string): void;\n\n  /**\n   * Log at warn level\n   */\n  warn(message: string): void;\n\n  /**\n   * Log at error level\n   */\n  error(message: string): void;\n}\n","import { LogLevel, LogEntry } from './types';\n\n/**\n * Convert log level string to LogLevel enum\n */\nexport function parseLogLevel(\n  level: LogLevel | keyof typeof LogLevel\n): LogLevel {\n  if (typeof level === 'number') {\n    return level;\n  }\n  return LogLevel[level] ?? LogLevel.INFO;\n}\n\n/**\n * Get log level name\n */\nexport function getLogLevelName(level: LogLevel): string {\n  return LogLevel[level] ?? 'UNKNOWN';\n}\n\n/**\n * Default console output handler\n */\nexport function createConsoleHandler(): (entry: LogEntry) => void {\n  const consoleMethods: Record<number, typeof console.log> = {\n    [LogLevel.TRACE]: console.trace || console.debug,\n    [LogLevel.DEBUG]: console.debug,\n    [LogLevel.INFO]: console.info,\n    [LogLevel.WARN]: console.warn,\n    [LogLevel.ERROR]: console.error,\n  };\n\n  return (entry) => {\n    const method = consoleMethods[entry.level] || console.log;\n    const parts: unknown[] = [];\n\n    // Add prefix if present\n    if (entry.prefix) {\n      parts.push(entry.prefix);\n    }\n\n    // Add message\n    parts.push(entry.message);\n\n    // Add context if present\n    if (entry.context && Object.keys(entry.context).length > 0) {\n      parts.push('\\nContext:', entry.context);\n    }\n\n    // Add metadata if present\n    if (entry.metadata && Object.keys(entry.metadata).length > 0) {\n      parts.push('\\nMetadata:', entry.metadata);\n    }\n\n    // Add error if present\n    if (entry.error) {\n      parts.push('\\nError:', entry.error);\n    }\n\n    method(...parts);\n  };\n}\n","import {\n  LogLevel,\n  LogEntry,\n  LoggerOptions,\n  LoggerChain,\n  OutputHandler,\n} from './types';\nimport { parseLogLevel, createConsoleHandler } from './utils';\n\n/**\n * Main Logger class\n */\nexport class Logger {\n  private level: LogLevel;\n  private handler: OutputHandler;\n  private enableTimestamp: boolean;\n  private defaultContext?: Record<string, unknown>;\n  private defaultPrefix?: string;\n\n  constructor(options: LoggerOptions = {}) {\n    this.level = options.level ? parseLogLevel(options.level) : LogLevel.INFO;\n    this.handler = options.handler || createConsoleHandler();\n    this.enableTimestamp =\n      options.enableTimestamp !== undefined ? options.enableTimestamp : true;\n    this.defaultContext = options.defaultContext;\n    this.defaultPrefix = options.defaultPrefix;\n  }\n\n  /**\n   * Set the minimum log level\n   */\n  setLevel(level: LogLevel | keyof typeof LogLevel): void {\n    this.level = parseLogLevel(level);\n  }\n\n  /**\n   * Get the current log level\n   */\n  getLevel(): LogLevel {\n    return this.level;\n  }\n\n  /**\n   * Set a custom output handler\n   */\n  setHandler(handler: OutputHandler): void {\n    this.handler = handler;\n  }\n\n  /**\n   * Set default context that will be included in all logs\n   */\n  setDefaultContext(context: Record<string, unknown>): void {\n    this.defaultContext = context;\n  }\n\n  /**\n   * Set default prefix for all log messages\n   */\n  setDefaultPrefix(prefix: string): void {\n    this.defaultPrefix = prefix;\n  }\n\n  /**\n   * Create a chainable logger instance\n   */\n  chain(): LoggerChain {\n    return new LoggerChainBuilder(this);\n  }\n\n  /**\n   * Log at trace level\n   */\n  trace(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.TRACE, message, context);\n  }\n\n  /**\n   * Log at debug level\n   */\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.DEBUG, message, context);\n  }\n\n  /**\n   * Log at info level\n   */\n  info(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.INFO, message, context);\n  }\n\n  /**\n   * Log at warn level\n   */\n  warn(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.WARN, message, context);\n  }\n\n  /**\n   * Log at error level\n   */\n  error(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.ERROR, message, context);\n  }\n\n  /**\n   * Internal log method\n   */\n  private log(\n    level: LogLevel,\n    message: string,\n    context?: Record<string, unknown>\n  ): void {\n    if (level < this.level) {\n      return;\n    }\n\n    const entry: LogEntry = {\n      level,\n      message,\n      timestamp: this.enableTimestamp ? Date.now() : 0,\n      prefix: this.defaultPrefix,\n    };\n\n    // Merge default context with provided context\n    if (this.defaultContext || context) {\n      entry.context = {\n        ...this.defaultContext,\n        ...context,\n      };\n    }\n\n    this.handler(entry);\n  }\n\n  /**\n   * Create a chainable logger with initial context\n   */\n  withContext(context: Record<string, unknown>): LoggerChain {\n    return new LoggerChainBuilder(this).withContext(context);\n  }\n\n  /**\n   * Create a chainable logger with initial prefix\n   */\n  withPrefix(prefix: string): LoggerChain {\n    return new LoggerChainBuilder(this).withPrefix(prefix);\n  }\n}\n\n/**\n * Chainable logger builder\n */\nclass LoggerChainBuilder implements LoggerChain {\n  private logger: Logger;\n  private context?: Record<string, unknown>;\n  private metadata?: Record<string, unknown>;\n  private errorObj?: Error;\n  private prefix?: string;\n\n  constructor(logger: Logger) {\n    this.logger = logger;\n  }\n\n  withContext(context: Record<string, unknown>): LoggerChain {\n    this.context = {\n      ...this.context,\n      ...context,\n    };\n    return this;\n  }\n\n  withMetadata(metadata: Record<string, unknown>): LoggerChain {\n    this.metadata = {\n      ...this.metadata,\n      ...metadata,\n    };\n    return this;\n  }\n\n  withError(error: Error): LoggerChain {\n    this.errorObj = error;\n    return this;\n  }\n\n  withPrefix(prefix: string): LoggerChain {\n    this.prefix = prefix;\n    return this;\n  }\n\n  private createEntry(level: LogLevel, message: string): LogEntry {\n    const entry: LogEntry = {\n      level,\n      message,\n      timestamp: this.logger['enableTimestamp'] ? Date.now() : 0,\n      prefix: this.prefix || this.logger['defaultPrefix'],\n    };\n\n    // Merge contexts\n    const defaultContext = this.logger['defaultContext'];\n    if (defaultContext || this.context) {\n      entry.context = {\n        ...defaultContext,\n        ...this.context,\n      };\n    }\n\n    if (this.metadata) {\n      entry.metadata = this.metadata;\n    }\n\n    if (this.errorObj) {\n      entry.error = this.errorObj;\n    }\n\n    return entry;\n  }\n\n  private log(level: LogLevel, message: string): void {\n    if (level < this.logger.getLevel()) {\n      return;\n    }\n\n    const entry = this.createEntry(level, message);\n    this.logger['handler'](entry);\n  }\n\n  trace(message: string): void {\n    this.log(LogLevel.TRACE, message);\n  }\n\n  debug(message: string): void {\n    this.log(LogLevel.DEBUG, message);\n  }\n\n  info(message: string): void {\n    this.log(LogLevel.INFO, message);\n  }\n\n  warn(message: string): void {\n    this.log(LogLevel.WARN, message);\n  }\n\n  error(message: string): void {\n    this.log(LogLevel.ERROR, message);\n  }\n}\n","import { Logger } from './logger';\nimport { LogLevel } from './types';\n\nexport { Logger, LogLevel };\nexport type {\n  LogEntry,\n  LoggerOptions,\n  LoggerChain,\n  OutputHandler,\n} from './types';\n\n/**\n * Default logger instance\n */\nexport const defaultLogger = new Logger();\n\n/**\n * Convenience methods using the default logger\n */\nexport const log = {\n  trace: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.trace(message, context),\n  debug: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.debug(message, context),\n  info: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.info(message, context),\n  warn: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.warn(message, context),\n  error: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.error(message, context),\n  setLevel: (level: LogLevel | keyof typeof LogLevel) =>\n    defaultLogger.setLevel(level),\n  withContext: (context: Record<string, unknown>) =>\n    defaultLogger.withContext(context),\n  withPrefix: (prefix: string) => defaultLogger.withPrefix(prefix),\n  chain: () => defaultLogger.chain(),\n};\n\nexport default Logger;\n"],"names":["LogLevel","parseLogLevel","level","_LogLevel$level","INFO","Logger","options","consoleMethods","this","handler","_consoleMethods","TRACE","console","trace","debug","DEBUG","info","WARN","warn","ERROR","error","entry","method","log","parts","prefix","push","message","context","Object","keys","length","metadata","apply","enableTimestamp","undefined","defaultContext","defaultPrefix","_proto","prototype","setLevel","getLevel","setHandler","setDefaultContext","setDefaultPrefix","chain","LoggerChainBuilder","timestamp","Date","now","_extends","withContext","withPrefix","logger","_proto2","withMetadata","withError","errorObj","createEntry","defaultLogger"],"mappings":"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"}

package/dist/log.esm.js

@@ -0,0 +1,222 @@
+function _extends() {
+  _extends = Object.assign ? Object.assign.bind() : function (target) {
+    for (var i = 1; i < arguments.length; i++) {
+      var source = arguments[i];
+      for (var key in source) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+          target[key] = source[key];
+        }
+      }
+    }
+    return target;
+  };
+  return _extends.apply(this, arguments);
+}
+
+var LogLevel;
+(function (LogLevel) {
+  LogLevel[LogLevel["TRACE"] = 0] = "TRACE";
+  LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+  LogLevel[LogLevel["INFO"] = 2] = "INFO";
+  LogLevel[LogLevel["WARN"] = 3] = "WARN";
+  LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+  LogLevel[LogLevel["SILENT"] = 5] = "SILENT";
+})(LogLevel || (LogLevel = {}));
+
+function parseLogLevel(level) {
+  var _LogLevel$level;
+  if (typeof level === 'number') {
+    return level;
+  }
+  return (_LogLevel$level = LogLevel[level]) != null ? _LogLevel$level : LogLevel.INFO;
+}
+function createConsoleHandler() {
+  var _consoleMethods;
+  var consoleMethods = (_consoleMethods = {}, _consoleMethods[LogLevel.TRACE] = console.trace || console.debug, _consoleMethods[LogLevel.DEBUG] = console.debug, _consoleMethods[LogLevel.INFO] = console.info, _consoleMethods[LogLevel.WARN] = console.warn, _consoleMethods[LogLevel.ERROR] = console.error, _consoleMethods);
+  return function (entry) {
+    var method = consoleMethods[entry.level] || console.log;
+    var parts = [];
+    if (entry.prefix) {
+      parts.push(entry.prefix);
+    }
+    parts.push(entry.message);
+    if (entry.context && Object.keys(entry.context).length > 0) {
+      parts.push('\nContext:', entry.context);
+    }
+    if (entry.metadata && Object.keys(entry.metadata).length > 0) {
+      parts.push('\nMetadata:', entry.metadata);
+    }
+    if (entry.error) {
+      parts.push('\nError:', entry.error);
+    }
+    method.apply(void 0, parts);
+  };
+}
+
+var Logger = /*#__PURE__*/function () {
+  function Logger(options) {
+    if (options === void 0) {
+      options = {};
+    }
+    this.level = options.level ? parseLogLevel(options.level) : LogLevel.INFO;
+    this.handler = options.handler || createConsoleHandler();
+    this.enableTimestamp = options.enableTimestamp !== undefined ? options.enableTimestamp : true;
+    this.defaultContext = options.defaultContext;
+    this.defaultPrefix = options.defaultPrefix;
+  }
+  var _proto = Logger.prototype;
+  _proto.setLevel = function setLevel(level) {
+    this.level = parseLogLevel(level);
+  };
+  _proto.getLevel = function getLevel() {
+    return this.level;
+  };
+  _proto.setHandler = function setHandler(handler) {
+    this.handler = handler;
+  };
+  _proto.setDefaultContext = function setDefaultContext(context) {
+    this.defaultContext = context;
+  };
+  _proto.setDefaultPrefix = function setDefaultPrefix(prefix) {
+    this.defaultPrefix = prefix;
+  };
+  _proto.chain = function chain() {
+    return new LoggerChainBuilder(this);
+  };
+  _proto.trace = function trace(message, context) {
+    this.log(LogLevel.TRACE, message, context);
+  };
+  _proto.debug = function debug(message, context) {
+    this.log(LogLevel.DEBUG, message, context);
+  };
+  _proto.info = function info(message, context) {
+    this.log(LogLevel.INFO, message, context);
+  };
+  _proto.warn = function warn(message, context) {
+    this.log(LogLevel.WARN, message, context);
+  };
+  _proto.error = function error(message, context) {
+    this.log(LogLevel.ERROR, message, context);
+  };
+  _proto.log = function log(level, message, context) {
+    if (level < this.level) {
+      return;
+    }
+    var entry = {
+      level: level,
+      message: message,
+      timestamp: this.enableTimestamp ? Date.now() : 0,
+      prefix: this.defaultPrefix
+    };
+    if (this.defaultContext || context) {
+      entry.context = _extends({}, this.defaultContext, context);
+    }
+    this.handler(entry);
+  };
+  _proto.withContext = function withContext(context) {
+    return new LoggerChainBuilder(this).withContext(context);
+  };
+  _proto.withPrefix = function withPrefix(prefix) {
+    return new LoggerChainBuilder(this).withPrefix(prefix);
+  };
+  return Logger;
+}();
+var LoggerChainBuilder = /*#__PURE__*/function () {
+  function LoggerChainBuilder(logger) {
+    this.logger = logger;
+  }
+  var _proto2 = LoggerChainBuilder.prototype;
+  _proto2.withContext = function withContext(context) {
+    this.context = _extends({}, this.context, context);
+    return this;
+  };
+  _proto2.withMetadata = function withMetadata(metadata) {
+    this.metadata = _extends({}, this.metadata, metadata);
+    return this;
+  };
+  _proto2.withError = function withError(error) {
+    this.errorObj = error;
+    return this;
+  };
+  _proto2.withPrefix = function withPrefix(prefix) {
+    this.prefix = prefix;
+    return this;
+  };
+  _proto2.createEntry = function createEntry(level, message) {
+    var entry = {
+      level: level,
+      message: message,
+      timestamp: this.logger['enableTimestamp'] ? Date.now() : 0,
+      prefix: this.prefix || this.logger['defaultPrefix']
+    };
+    var defaultContext = this.logger['defaultContext'];
+    if (defaultContext || this.context) {
+      entry.context = _extends({}, defaultContext, this.context);
+    }
+    if (this.metadata) {
+      entry.metadata = this.metadata;
+    }
+    if (this.errorObj) {
+      entry.error = this.errorObj;
+    }
+    return entry;
+  };
+  _proto2.log = function log(level, message) {
+    if (level < this.logger.getLevel()) {
+      return;
+    }
+    var entry = this.createEntry(level, message);
+    this.logger['handler'](entry);
+  };
+  _proto2.trace = function trace(message) {
+    this.log(LogLevel.TRACE, message);
+  };
+  _proto2.debug = function debug(message) {
+    this.log(LogLevel.DEBUG, message);
+  };
+  _proto2.info = function info(message) {
+    this.log(LogLevel.INFO, message);
+  };
+  _proto2.warn = function warn(message) {
+    this.log(LogLevel.WARN, message);
+  };
+  _proto2.error = function error(message) {
+    this.log(LogLevel.ERROR, message);
+  };
+  return LoggerChainBuilder;
+}();
+
+var defaultLogger = /*#__PURE__*/new Logger();
+var log = {
+  trace: function trace(message, context) {
+    return defaultLogger.trace(message, context);
+  },
+  debug: function debug(message, context) {
+    return defaultLogger.debug(message, context);
+  },
+  info: function info(message, context) {
+    return defaultLogger.info(message, context);
+  },
+  warn: function warn(message, context) {
+    return defaultLogger.warn(message, context);
+  },
+  error: function error(message, context) {
+    return defaultLogger.error(message, context);
+  },
+  setLevel: function setLevel(level) {
+    return defaultLogger.setLevel(level);
+  },
+  withContext: function withContext(context) {
+    return defaultLogger.withContext(context);
+  },
+  withPrefix: function withPrefix(prefix) {
+    return defaultLogger.withPrefix(prefix);
+  },
+  chain: function chain() {
+    return defaultLogger.chain();
+  }
+};
+
+export default Logger;
+export { LogLevel, Logger, defaultLogger, log };
+//# sourceMappingURL=log.esm.js.map

package/dist/log.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.esm.js","sources":["../src/types.ts","../src/utils.ts","../src/logger.ts","../src/index.ts"],"sourcesContent":["/**\n * Log levels in order of severity\n */\nexport enum LogLevel {\n  TRACE = 0,\n  DEBUG = 1,\n  INFO = 2,\n  WARN = 3,\n  ERROR = 4,\n  SILENT = 5,\n}\n\n/**\n * Log entry data structure\n */\nexport interface LogEntry {\n  level: LogLevel;\n  message: string;\n  timestamp: number;\n  context?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n  error?: Error;\n  prefix?: string;\n}\n\n/**\n * Output handler function type\n */\nexport type OutputHandler = (entry: LogEntry) => void;\n\n/**\n * Logger configuration options\n */\nexport interface LoggerOptions {\n  /**\n   * Minimum log level to output (default: LogLevel.INFO)\n   */\n  level?: LogLevel | keyof typeof LogLevel;\n\n  /**\n   * Custom output handler (default: console)\n   */\n  handler?: OutputHandler;\n\n  /**\n   * Enable timestamps in log entries (default: true)\n   */\n  enableTimestamp?: boolean;\n\n  /**\n   * Default context that will be included in all logs\n   */\n  defaultContext?: Record<string, unknown>;\n\n  /**\n   * Default prefix for all log messages\n   */\n  defaultPrefix?: string;\n}\n\n/**\n * Chainable logger interface\n */\nexport interface LoggerChain {\n  /**\n   * Add context data that will be included in this log entry\n   */\n  withContext(context: Record<string, unknown>): LoggerChain;\n\n  /**\n   * Add metadata that will be included in this log entry\n   */\n  withMetadata(metadata: Record<string, unknown>): LoggerChain;\n\n  /**\n   * Add an error object to this log entry\n   */\n  withError(error: Error): LoggerChain;\n\n  /**\n   * Add a prefix to this log message\n   */\n  withPrefix(prefix: string): LoggerChain;\n\n  /**\n   * Log at trace level\n   */\n  trace(message: string): void;\n\n  /**\n   * Log at debug level\n   */\n  debug(message: string): void;\n\n  /**\n   * Log at info level\n   */\n  info(message: string): void;\n\n  /**\n   * Log at warn level\n   */\n  warn(message: string): void;\n\n  /**\n   * Log at error level\n   */\n  error(message: string): void;\n}\n","import { LogLevel, LogEntry } from './types';\n\n/**\n * Convert log level string to LogLevel enum\n */\nexport function parseLogLevel(\n  level: LogLevel | keyof typeof LogLevel\n): LogLevel {\n  if (typeof level === 'number') {\n    return level;\n  }\n  return LogLevel[level] ?? LogLevel.INFO;\n}\n\n/**\n * Get log level name\n */\nexport function getLogLevelName(level: LogLevel): string {\n  return LogLevel[level] ?? 'UNKNOWN';\n}\n\n/**\n * Default console output handler\n */\nexport function createConsoleHandler(): (entry: LogEntry) => void {\n  const consoleMethods: Record<number, typeof console.log> = {\n    [LogLevel.TRACE]: console.trace || console.debug,\n    [LogLevel.DEBUG]: console.debug,\n    [LogLevel.INFO]: console.info,\n    [LogLevel.WARN]: console.warn,\n    [LogLevel.ERROR]: console.error,\n  };\n\n  return (entry) => {\n    const method = consoleMethods[entry.level] || console.log;\n    const parts: unknown[] = [];\n\n    // Add prefix if present\n    if (entry.prefix) {\n      parts.push(entry.prefix);\n    }\n\n    // Add message\n    parts.push(entry.message);\n\n    // Add context if present\n    if (entry.context && Object.keys(entry.context).length > 0) {\n      parts.push('\\nContext:', entry.context);\n    }\n\n    // Add metadata if present\n    if (entry.metadata && Object.keys(entry.metadata).length > 0) {\n      parts.push('\\nMetadata:', entry.metadata);\n    }\n\n    // Add error if present\n    if (entry.error) {\n      parts.push('\\nError:', entry.error);\n    }\n\n    method(...parts);\n  };\n}\n","import {\n  LogLevel,\n  LogEntry,\n  LoggerOptions,\n  LoggerChain,\n  OutputHandler,\n} from './types';\nimport { parseLogLevel, createConsoleHandler } from './utils';\n\n/**\n * Main Logger class\n */\nexport class Logger {\n  private level: LogLevel;\n  private handler: OutputHandler;\n  private enableTimestamp: boolean;\n  private defaultContext?: Record<string, unknown>;\n  private defaultPrefix?: string;\n\n  constructor(options: LoggerOptions = {}) {\n    this.level = options.level ? parseLogLevel(options.level) : LogLevel.INFO;\n    this.handler = options.handler || createConsoleHandler();\n    this.enableTimestamp =\n      options.enableTimestamp !== undefined ? options.enableTimestamp : true;\n    this.defaultContext = options.defaultContext;\n    this.defaultPrefix = options.defaultPrefix;\n  }\n\n  /**\n   * Set the minimum log level\n   */\n  setLevel(level: LogLevel | keyof typeof LogLevel): void {\n    this.level = parseLogLevel(level);\n  }\n\n  /**\n   * Get the current log level\n   */\n  getLevel(): LogLevel {\n    return this.level;\n  }\n\n  /**\n   * Set a custom output handler\n   */\n  setHandler(handler: OutputHandler): void {\n    this.handler = handler;\n  }\n\n  /**\n   * Set default context that will be included in all logs\n   */\n  setDefaultContext(context: Record<string, unknown>): void {\n    this.defaultContext = context;\n  }\n\n  /**\n   * Set default prefix for all log messages\n   */\n  setDefaultPrefix(prefix: string): void {\n    this.defaultPrefix = prefix;\n  }\n\n  /**\n   * Create a chainable logger instance\n   */\n  chain(): LoggerChain {\n    return new LoggerChainBuilder(this);\n  }\n\n  /**\n   * Log at trace level\n   */\n  trace(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.TRACE, message, context);\n  }\n\n  /**\n   * Log at debug level\n   */\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.DEBUG, message, context);\n  }\n\n  /**\n   * Log at info level\n   */\n  info(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.INFO, message, context);\n  }\n\n  /**\n   * Log at warn level\n   */\n  warn(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.WARN, message, context);\n  }\n\n  /**\n   * Log at error level\n   */\n  error(message: string, context?: Record<string, unknown>): void {\n    this.log(LogLevel.ERROR, message, context);\n  }\n\n  /**\n   * Internal log method\n   */\n  private log(\n    level: LogLevel,\n    message: string,\n    context?: Record<string, unknown>\n  ): void {\n    if (level < this.level) {\n      return;\n    }\n\n    const entry: LogEntry = {\n      level,\n      message,\n      timestamp: this.enableTimestamp ? Date.now() : 0,\n      prefix: this.defaultPrefix,\n    };\n\n    // Merge default context with provided context\n    if (this.defaultContext || context) {\n      entry.context = {\n        ...this.defaultContext,\n        ...context,\n      };\n    }\n\n    this.handler(entry);\n  }\n\n  /**\n   * Create a chainable logger with initial context\n   */\n  withContext(context: Record<string, unknown>): LoggerChain {\n    return new LoggerChainBuilder(this).withContext(context);\n  }\n\n  /**\n   * Create a chainable logger with initial prefix\n   */\n  withPrefix(prefix: string): LoggerChain {\n    return new LoggerChainBuilder(this).withPrefix(prefix);\n  }\n}\n\n/**\n * Chainable logger builder\n */\nclass LoggerChainBuilder implements LoggerChain {\n  private logger: Logger;\n  private context?: Record<string, unknown>;\n  private metadata?: Record<string, unknown>;\n  private errorObj?: Error;\n  private prefix?: string;\n\n  constructor(logger: Logger) {\n    this.logger = logger;\n  }\n\n  withContext(context: Record<string, unknown>): LoggerChain {\n    this.context = {\n      ...this.context,\n      ...context,\n    };\n    return this;\n  }\n\n  withMetadata(metadata: Record<string, unknown>): LoggerChain {\n    this.metadata = {\n      ...this.metadata,\n      ...metadata,\n    };\n    return this;\n  }\n\n  withError(error: Error): LoggerChain {\n    this.errorObj = error;\n    return this;\n  }\n\n  withPrefix(prefix: string): LoggerChain {\n    this.prefix = prefix;\n    return this;\n  }\n\n  private createEntry(level: LogLevel, message: string): LogEntry {\n    const entry: LogEntry = {\n      level,\n      message,\n      timestamp: this.logger['enableTimestamp'] ? Date.now() : 0,\n      prefix: this.prefix || this.logger['defaultPrefix'],\n    };\n\n    // Merge contexts\n    const defaultContext = this.logger['defaultContext'];\n    if (defaultContext || this.context) {\n      entry.context = {\n        ...defaultContext,\n        ...this.context,\n      };\n    }\n\n    if (this.metadata) {\n      entry.metadata = this.metadata;\n    }\n\n    if (this.errorObj) {\n      entry.error = this.errorObj;\n    }\n\n    return entry;\n  }\n\n  private log(level: LogLevel, message: string): void {\n    if (level < this.logger.getLevel()) {\n      return;\n    }\n\n    const entry = this.createEntry(level, message);\n    this.logger['handler'](entry);\n  }\n\n  trace(message: string): void {\n    this.log(LogLevel.TRACE, message);\n  }\n\n  debug(message: string): void {\n    this.log(LogLevel.DEBUG, message);\n  }\n\n  info(message: string): void {\n    this.log(LogLevel.INFO, message);\n  }\n\n  warn(message: string): void {\n    this.log(LogLevel.WARN, message);\n  }\n\n  error(message: string): void {\n    this.log(LogLevel.ERROR, message);\n  }\n}\n","import { Logger } from './logger';\nimport { LogLevel } from './types';\n\nexport { Logger, LogLevel };\nexport type {\n  LogEntry,\n  LoggerOptions,\n  LoggerChain,\n  OutputHandler,\n} from './types';\n\n/**\n * Default logger instance\n */\nexport const defaultLogger = new Logger();\n\n/**\n * Convenience methods using the default logger\n */\nexport const log = {\n  trace: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.trace(message, context),\n  debug: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.debug(message, context),\n  info: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.info(message, context),\n  warn: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.warn(message, context),\n  error: (message: string, context?: Record<string, unknown>) =>\n    defaultLogger.error(message, context),\n  setLevel: (level: LogLevel | keyof typeof LogLevel) =>\n    defaultLogger.setLevel(level),\n  withContext: (context: Record<string, unknown>) =>\n    defaultLogger.withContext(context),\n  withPrefix: (prefix: string) => defaultLogger.withPrefix(prefix),\n  chain: () => defaultLogger.chain(),\n};\n\nexport default Logger;\n"],"names":["LogLevel","parseLogLevel","level","_LogLevel$level","INFO","createConsoleHandler","consoleMethods","_consoleMethods","TRACE","console","trace","debug","DEBUG","info","WARN","warn","ERROR","error","entry","method","log","parts","prefix","push","message","context","Object","keys","length","metadata","apply","Logger","options","handler","enableTimestamp","undefined","defaultContext","defaultPrefix","_proto","prototype","setLevel","getLevel","setHandler","setDefaultContext","setDefaultPrefix","chain","LoggerChainBuilder","timestamp","Date","now","_extends","withContext","withPrefix","logger","_proto2","withMetadata","withError","errorObj","createEntry","defaultLogger"],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,23 @@
+import { LogLevel, LoggerOptions, LoggerChain, OutputHandler } from './types';
+export declare class Logger {
+    private level;
+    private handler;
+    private enableTimestamp;
+    private defaultContext?;
+    private defaultPrefix?;
+    constructor(options?: LoggerOptions);
+    setLevel(level: LogLevel | keyof typeof LogLevel): void;
+    getLevel(): LogLevel;
+    setHandler(handler: OutputHandler): void;
+    setDefaultContext(context: Record<string, unknown>): void;
+    setDefaultPrefix(prefix: string): void;
+    chain(): LoggerChain;
+    trace(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    private log;
+    withContext(context: Record<string, unknown>): LoggerChain;
+    withPrefix(prefix: string): LoggerChain;
+}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+export declare enum LogLevel {
+    TRACE = 0,
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4,
+    SILENT = 5
+}
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: number;
+    context?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    error?: Error;
+    prefix?: string;
+}
+export declare type OutputHandler = (entry: LogEntry) => void;
+export interface LoggerOptions {
+    level?: LogLevel | keyof typeof LogLevel;
+    handler?: OutputHandler;
+    enableTimestamp?: boolean;
+    defaultContext?: Record<string, unknown>;
+    defaultPrefix?: string;
+}
+export interface LoggerChain {
+    withContext(context: Record<string, unknown>): LoggerChain;
+    withMetadata(metadata: Record<string, unknown>): LoggerChain;
+    withError(error: Error): LoggerChain;
+    withPrefix(prefix: string): LoggerChain;
+    trace(message: string): void;
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}

package/dist/utils.d.ts

@@ -0,0 +1,4 @@
+import { LogLevel, LogEntry } from './types';
+export declare function parseLogLevel(level: LogLevel | keyof typeof LogLevel): LogLevel;
+export declare function getLogLevelName(level: LogLevel): string;
+export declare function createConsoleHandler(): (entry: LogEntry) => void;

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@x-oasis/log",
+  "version": "0.1.1",
+  "description": "A friendly logging library for browser environments",
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "module": "dist/log.esm.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "tsdx": "^0.14.1"
+  },
+  "scripts": {
+    "build": "tsdx build --tsconfig tsconfig.build.json",
+    "clean": "rimraf ./dist",
+    "test": "vitest",
+    "compile": "tsc -p tsconfig.build.json"
+  }
+}

package/src/index.ts

@@ -0,0 +1,39 @@
+import { Logger } from './logger';
+import { LogLevel } from './types';
+
+export { Logger, LogLevel };
+export type {
+  LogEntry,
+  LoggerOptions,
+  LoggerChain,
+  OutputHandler,
+} from './types';
+
+/**
+ * Default logger instance
+ */
+export const defaultLogger = new Logger();
+
+/**
+ * Convenience methods using the default logger
+ */
+export const log = {
+  trace: (message: string, context?: Record<string, unknown>) =>
+    defaultLogger.trace(message, context),
+  debug: (message: string, context?: Record<string, unknown>) =>
+    defaultLogger.debug(message, context),
+  info: (message: string, context?: Record<string, unknown>) =>
+    defaultLogger.info(message, context),
+  warn: (message: string, context?: Record<string, unknown>) =>
+    defaultLogger.warn(message, context),
+  error: (message: string, context?: Record<string, unknown>) =>
+    defaultLogger.error(message, context),
+  setLevel: (level: LogLevel | keyof typeof LogLevel) =>
+    defaultLogger.setLevel(level),
+  withContext: (context: Record<string, unknown>) =>
+    defaultLogger.withContext(context),
+  withPrefix: (prefix: string) => defaultLogger.withPrefix(prefix),
+  chain: () => defaultLogger.chain(),
+};
+
+export default Logger;

package/src/logger.ts

@@ -0,0 +1,247 @@
+import {
+  LogLevel,
+  LogEntry,
+  LoggerOptions,
+  LoggerChain,
+  OutputHandler,
+} from './types';
+import { parseLogLevel, createConsoleHandler } from './utils';
+
+/**
+ * Main Logger class
+ */
+export class Logger {
+  private level: LogLevel;
+  private handler: OutputHandler;
+  private enableTimestamp: boolean;
+  private defaultContext?: Record<string, unknown>;
+  private defaultPrefix?: string;
+
+  constructor(options: LoggerOptions = {}) {
+    this.level = options.level ? parseLogLevel(options.level) : LogLevel.INFO;
+    this.handler = options.handler || createConsoleHandler();
+    this.enableTimestamp =
+      options.enableTimestamp !== undefined ? options.enableTimestamp : true;
+    this.defaultContext = options.defaultContext;
+    this.defaultPrefix = options.defaultPrefix;
+  }
+
+  /**
+   * Set the minimum log level
+   */
+  setLevel(level: LogLevel | keyof typeof LogLevel): void {
+    this.level = parseLogLevel(level);
+  }
+
+  /**
+   * Get the current log level
+   */
+  getLevel(): LogLevel {
+    return this.level;
+  }
+
+  /**
+   * Set a custom output handler
+   */
+  setHandler(handler: OutputHandler): void {
+    this.handler = handler;
+  }
+
+  /**
+   * Set default context that will be included in all logs
+   */
+  setDefaultContext(context: Record<string, unknown>): void {
+    this.defaultContext = context;
+  }
+
+  /**
+   * Set default prefix for all log messages
+   */
+  setDefaultPrefix(prefix: string): void {
+    this.defaultPrefix = prefix;
+  }
+
+  /**
+   * Create a chainable logger instance
+   */
+  chain(): LoggerChain {
+    return new LoggerChainBuilder(this);
+  }
+
+  /**
+   * Log at trace level
+   */
+  trace(message: string, context?: Record<string, unknown>): void {
+    this.log(LogLevel.TRACE, message, context);
+  }
+
+  /**
+   * Log at debug level
+   */
+  debug(message: string, context?: Record<string, unknown>): void {
+    this.log(LogLevel.DEBUG, message, context);
+  }
+
+  /**
+   * Log at info level
+   */
+  info(message: string, context?: Record<string, unknown>): void {
+    this.log(LogLevel.INFO, message, context);
+  }
+
+  /**
+   * Log at warn level
+   */
+  warn(message: string, context?: Record<string, unknown>): void {
+    this.log(LogLevel.WARN, message, context);
+  }
+
+  /**
+   * Log at error level
+   */
+  error(message: string, context?: Record<string, unknown>): void {
+    this.log(LogLevel.ERROR, message, context);
+  }
+
+  /**
+   * Internal log method
+   */
+  private log(
+    level: LogLevel,
+    message: string,
+    context?: Record<string, unknown>
+  ): void {
+    if (level < this.level) {
+      return;
+    }
+
+    const entry: LogEntry = {
+      level,
+      message,
+      timestamp: this.enableTimestamp ? Date.now() : 0,
+      prefix: this.defaultPrefix,
+    };
+
+    // Merge default context with provided context
+    if (this.defaultContext || context) {
+      entry.context = {
+        ...this.defaultContext,
+        ...context,
+      };
+    }
+
+    this.handler(entry);
+  }
+
+  /**
+   * Create a chainable logger with initial context
+   */
+  withContext(context: Record<string, unknown>): LoggerChain {
+    return new LoggerChainBuilder(this).withContext(context);
+  }
+
+  /**
+   * Create a chainable logger with initial prefix
+   */
+  withPrefix(prefix: string): LoggerChain {
+    return new LoggerChainBuilder(this).withPrefix(prefix);
+  }
+}
+
+/**
+ * Chainable logger builder
+ */
+class LoggerChainBuilder implements LoggerChain {
+  private logger: Logger;
+  private context?: Record<string, unknown>;
+  private metadata?: Record<string, unknown>;
+  private errorObj?: Error;
+  private prefix?: string;
+
+  constructor(logger: Logger) {
+    this.logger = logger;
+  }
+
+  withContext(context: Record<string, unknown>): LoggerChain {
+    this.context = {
+      ...this.context,
+      ...context,
+    };
+    return this;
+  }
+
+  withMetadata(metadata: Record<string, unknown>): LoggerChain {
+    this.metadata = {
+      ...this.metadata,
+      ...metadata,
+    };
+    return this;
+  }
+
+  withError(error: Error): LoggerChain {
+    this.errorObj = error;
+    return this;
+  }
+
+  withPrefix(prefix: string): LoggerChain {
+    this.prefix = prefix;
+    return this;
+  }
+
+  private createEntry(level: LogLevel, message: string): LogEntry {
+    const entry: LogEntry = {
+      level,
+      message,
+      timestamp: this.logger['enableTimestamp'] ? Date.now() : 0,
+      prefix: this.prefix || this.logger['defaultPrefix'],
+    };
+
+    // Merge contexts
+    const defaultContext = this.logger['defaultContext'];
+    if (defaultContext || this.context) {
+      entry.context = {
+        ...defaultContext,
+        ...this.context,
+      };
+    }
+
+    if (this.metadata) {
+      entry.metadata = this.metadata;
+    }
+
+    if (this.errorObj) {
+      entry.error = this.errorObj;
+    }
+
+    return entry;
+  }
+
+  private log(level: LogLevel, message: string): void {
+    if (level < this.logger.getLevel()) {
+      return;
+    }
+
+    const entry = this.createEntry(level, message);
+    this.logger['handler'](entry);
+  }
+
+  trace(message: string): void {
+    this.log(LogLevel.TRACE, message);
+  }
+
+  debug(message: string): void {
+    this.log(LogLevel.DEBUG, message);
+  }
+
+  info(message: string): void {
+    this.log(LogLevel.INFO, message);
+  }
+
+  warn(message: string): void {
+    this.log(LogLevel.WARN, message);
+  }
+
+  error(message: string): void {
+    this.log(LogLevel.ERROR, message);
+  }
+}