@nlabs/arkhamjs-middleware-logger 3.28.7 → 3.29.0

package/README.md

@@ -1,6 +1,6 @@
 # @nlabs/arkhamjs-middleware-logger
 
-Add console logging for ArkhamJS
+> **Powerful Logging Middleware for ArkhamJS** - Comprehensive action and state logging with customizable output formats, filtering, and performance insights.
 
 [![npm version](https://img.shields.io/npm/v/@nlabs/arkhamjs-middleware-logger.svg?style=flat-square)](https://www.npmjs.com/package/@nlabs/arkhamjs-middleware-logger)
 [![npm downloads](https://img.shields.io/npm/dm/@nlabs/arkhamjs-middleware-logger.svg?style=flat-square)](https://www.npmjs.com/package/@nlabs/arkhamjs-middleware-logger)
@@ -10,14 +10,456 @@ Add console logging for ArkhamJS
 [![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](http://opensource.org/licenses/MIT)
 [![Chat](https://img.shields.io/discord/446122412715802649.svg)](https://discord.gg/Ttgev58)
 
-## Installation
+## 🚀 Features
 
-Using [npm](https://www.npmjs.com/):
+- **📝 Comprehensive Logging** - Log actions, state changes, and performance metrics
+- **🎨 Customizable Output** - Beautiful console formatting with colors and grouping
+- **🔍 Action Filtering** - Filter specific actions or action types
+- **⚡ Performance Tracking** - Measure action execution time and state update performance
+- **🌲 Tree-shakable** - Only include what you need in production
+- **🔧 Configurable** - Extensive options for customization
+- **📱 Browser Support** - Works in Chrome, Firefox, Safari, and Edge
 
-```shell
-npm i --save @nlabs/arkhamjs-middleware-logger
+## 📦 Installation
+
+```bash
+npm install @nlabs/arkhamjs-middleware-logger
+```
+
+## 🎯 Quick Start
+
+### **Basic Setup**
+
+```typescript
+import { Flux } from '@nlabs/arkhamjs';
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+// Initialize Flux with logger middleware
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore, CartStore],
+  middleware: [
+    Logger() // Enable basic logging
+  ]
+});
+
+// Dispatch actions and see beautiful logs
+Flux.dispatch({ type: 'ADD_USER', user: { name: 'John' } });
+```
+
+### **Console Output**
+
+```
+🚀 ArkhamJS Logger - Action Dispatched
+┌─────────────────────────────────────────────────────────────┐
+│ Action: ADD_USER                                            │
+│ Timestamp: 2024-01-15T10:30:45.123Z                        │
+│ Duration: 2.5ms                                             │
+├─────────────────────────────────────────────────────────────┤
+│ Payload:                                                    │
+│ {                                                           │
+│   "user": {                                                 │
+│     "name": "John"                                          │
+│   }                                                         │
+│ }                                                           │
+├─────────────────────────────────────────────────────────────┤
+│ State Changes:                                              │
+│ • user.list: [] → [{"name":"John"}]                        │
+│ • user.count: 0 → 1                                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 🔧 Configuration Options
+
+### **Basic Configuration**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [
+    Logger({
+      // Enable/disable features
+      logActions: true,        // Log dispatched actions
+      logState: true,          // Log state changes
+      logPerformance: true,    // Log performance metrics
+
+      // Filtering options
+      filterActions: ['ADD_USER', 'UPDATE_USER'], // Only log specific actions
+      excludeActions: ['TICK', 'MOUSE_MOVE'],     // Exclude specific actions
+
+      // Output options
+      groupActions: true,      // Group related logs
+      showTimestamp: true,     // Show timestamps
+      showDuration: true,      // Show action duration
+
+      // Styling
+      colors: true,            // Enable colored output
+      compact: false,          // Compact mode for less verbose output
+
+      // Performance thresholds
+      slowActionThreshold: 100, // Warn for actions taking >100ms
+
+      // Custom formatting
+      formatAction: (action) => `🎯 ${action.type}`,
+      formatState: (path, oldValue, newValue) =>
+        `${path}: ${JSON.stringify(oldValue)} → ${JSON.stringify(newValue)}`
+    })
+  ]
+});
+```
+
+### **Production Configuration**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+const isDevelopment = process.env.NODE_ENV === 'development';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [
+    // Only enable logging in development
+    ...(isDevelopment ? [Logger()] : [])
+  ]
+});
+```
+
+### **Advanced Filtering**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+interface UserAction {
+  type: string;
+  user?: { premium?: boolean };
+}
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [
+    Logger({
+      // Filter by action type pattern
+      filterActions: (action: UserAction) => action.type.startsWith('USER_'),
+
+      // Filter by action payload
+      filterActions: (action: UserAction) => action.user && action.user.premium,
+
+      // Filter state changes
+      filterState: (path: string, oldValue: any, newValue: any): boolean => {
+        // Only log significant changes
+        return JSON.stringify(oldValue) !== JSON.stringify(newValue);
+      },
+
+      // Custom action grouping
+      groupBy: (action: UserAction): string => {
+        if (action.type.startsWith('USER_')) return 'User Actions';
+        if (action.type.startsWith('CART_')) return 'Cart Actions';
+        return 'Other Actions';
+      }
+    })
+  ]
+});
+```
+
+## 🎨 Custom Logging Formats
+
+### **Custom Action Formatter**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+interface Action {
+  type: string;
+}
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [
+    Logger({
+      formatAction: (action: Action): string => {
+        const icons: Record<string, string> = {
+          'ADD_USER': '👤',
+          'UPDATE_USER': '✏️',
+          'DELETE_USER': '🗑️',
+          'CART_ADD': '🛒',
+          'CART_REMOVE': '❌'
+        };
+
+        const icon = icons[action.type] || '📝';
+        return `${icon} ${action.type}`;
+      }
+    })
+  ]
+});
+```
+
+### **Custom State Formatter**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [
+    Logger({
+      formatState: (path: string, oldValue: any, newValue: any): string => {
+        const formatValue = (value: any): string => {
+          if (Array.isArray(value)) return `[${value.length} items]`;
+          if (typeof value === 'object' && value !== null) return '{...}';
+          return String(value);
+        };
+
+        return `${path}: ${formatValue(oldValue)} → ${formatValue(newValue)}`;
+      }
+    })
+  ]
+});
+```
+
+## 🎯 Advanced Usage
+
+### **Performance Monitoring**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [
+    Logger({
+      logPerformance: true,
+      slowActionThreshold: 50, // Warn for actions >50ms
+
+      // Custom performance formatter
+      formatPerformance: (duration: number, action: any): string => {
+        if (duration > 100) return `🐌 Slow action: ${action.type} (${duration}ms)`;
+        if (duration > 50) return `⚠️ Medium action: ${action.type} (${duration}ms)`;
+        return `⚡ Fast action: ${action.type} (${duration}ms)`;
+      }
+    })
+  ]
+});
+```
+
+### **Conditional Logging**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+const createLogger = (options: any) => {
+  const isDevelopment = process.env.NODE_ENV === 'development';
+  const isTest = process.env.NODE_ENV === 'test';
+
+  if (isTest) {
+    return Logger({
+      logActions: false,
+      logState: false,
+      logPerformance: false
+    });
+  }
+
+  if (isDevelopment) {
+    return Logger({
+      ...options,
+      colors: true,
+      groupActions: true
+    });
+  }
+
+  return Logger({
+    ...options,
+    colors: false,
+    groupActions: false,
+    compact: true
+  });
+};
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [createLogger()]
+});
+```
+
+### **Custom Log Handlers**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [
+    Logger({
+      // Custom log handler for external logging services
+      onActionLogged: (action: any, duration: number) => {
+        // Send to external logging service
+        analytics.track('action_dispatched', {
+          action: action.type,
+          duration,
+          timestamp: Date.now()
+        });
+      },
+
+      onStateChanged: (path: string, oldValue: any, newValue: any) => {
+        // Track state changes
+        analytics.track('state_changed', {
+          path,
+          oldValue,
+          newValue
+        });
+      }
+    })
+  ]
+});
+```
+
+## 🔧 API Reference
+
+### **Logger Options**
+
+```typescript
+interface LoggerOptions {
+  // Basic settings
+  logActions?: boolean;
+  logState?: boolean;
+  logPerformance?: boolean;
+
+  // Filtering
+  filterActions?: string[] | ((action: any) => boolean);
+  excludeActions?: string[] | ((action: any) => boolean);
+  filterState?: (path: string, oldValue: any, newValue: any) => boolean;
+
+  // Output formatting
+  groupActions?: boolean;
+  showTimestamp?: boolean;
+  showDuration?: boolean;
+  colors?: boolean;
+  compact?: boolean;
+
+  // Performance
+  slowActionThreshold?: number;
+
+  // Custom formatters
+  formatAction?: (action: any) => string;
+  formatState?: (path: string, oldValue: any, newValue: any) => string;
+  formatPerformance?: (duration: number, action: any) => string;
+
+  // Custom handlers
+  onActionLogged?: (action: any, duration: number) => void;
+  onStateChanged?: (path: string, oldValue: any, newValue: any) => void;
+
+  // Grouping
+  groupBy?: (action: any) => string;
+}
 ```
 
-## Documentation
+## 🎯 Use Cases
+
+### **Development Debugging**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+// Development setup with full logging
+const devLogger = Logger({
+  logActions: true,
+  logState: true,
+  logPerformance: true,
+  colors: true,
+  groupActions: true,
+  showTimestamp: true,
+  showDuration: true
+});
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [devLogger]
+});
+```
+
+### **Production Monitoring**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+// Production setup with minimal logging
+const prodLogger = Logger({
+  logActions: false,
+  logState: false,
+  logPerformance: true,
+  colors: false,
+  compact: true,
+  slowActionThreshold: 100,
+
+  onActionLogged: (action, duration) => {
+    if (duration > 100) {
+      // Send slow action alerts
+      errorReporting.captureMessage(`Slow action: ${action.type}`, {
+        level: 'warning',
+        extra: { action, duration }
+      });
+    }
+  }
+});
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  middleware: [prodLogger]
+});
+```
+
+### **Testing Setup**
+
+```typescript
+import { Logger } from '@nlabs/arkhamjs-middleware-logger';
+
+// Testing setup with no logging
+const testLogger = Logger({
+  logActions: false,
+  logState: false,
+  logPerformance: false
+});
+
+Flux.init({
+  name: 'test-app',
+  stores: [UserStore],
+  middleware: [testLogger]
+});
+```
+
+## 🔗 Related Packages
+
+- **[@nlabs/arkhamjs](./packages/arkhamjs/README.md)** - Core Flux framework
+- **[@nlabs/arkhamjs-middleware-devtools](./packages/arkhamjs-middleware-devtools/README.md)** - Chrome DevTools integration
+- **[@nlabs/arkhamjs-utils-react](./packages/arkhamjs-utils-react/README.md)** - React hooks and utilities
+
+## 📚 Documentation
+
+- **[ArkhamJS Documentation](https://arkhamjs.io)** - Complete API reference
+- **[Middleware Guide](https://arkhamjs.io/docs/middleware)** - Middleware development guide
+- **[Debugging Guide](https://arkhamjs.io/docs/debugging)** - Debugging best practices
+
+## 🤝 Community & Support
+
+- **💬 [Discord Community](https://discord.gg/Ttgev58)** - Chat with other developers
+- **🐛 [GitHub Issues](https://github.com/nitrogenlabs/arkhamjs/issues)** - Report bugs and request features
+- **📝 [Examples](./packages/arkhamjs-example-ts-react/README.md)** - Complete working examples
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
 
-For detailed [Documentation](https://arkhamjs.io) and additional options.
+**Start debugging your ArkhamJS applications with powerful logging today!** 🚀

package/lib/Logger/Logger.d.ts

@@ -0,0 +1,17 @@
+import { FluxAction } from '@nlabs/arkhamjs';
+import { LoggerOptions } from '../types/main';
+export declare class Logger {
+    name: string;
+    private previousStore;
+    private defaultOptions;
+    private options;
+    constructor(options: LoggerOptions);
+    config(options: LoggerOptions): void;
+    debugError(...obj: any[]): void;
+    debugInfo(...obj: any[]): void;
+    debugLog(...obj: any[]): void;
+    enableDebugger(level?: number): void;
+    getOptions(): LoggerOptions;
+    preDispatch(action: FluxAction, store: any): Promise<FluxAction>;
+    postDispatch(action: FluxAction, store: object): Promise<FluxAction>;
+}

package/lib/Logger/Logger.js

@@ -0,0 +1,2 @@
+var r=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var h=(i,o)=>{for(var e in o)r(i,e,{get:o[e],enumerable:!0})},a=(i,o,e,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let s of c(o))!u.call(i,s)&&s!==e&&r(i,s,{get:()=>o[s],enumerable:!(t=l(o,s))||t.enumerable});return i};var b=i=>a(r({},"__esModule",{value:!0}),i);var f={};h(f,{Logger:()=>L});module.exports=b(f);var p=require("@nlabs/utils/checks/isEqual"),d=require("@nlabs/utils/objects/clone"),n=require("../types/main");class L{constructor(o){this.name="Logger";this.previousStore={};this.defaultOptions={debugLevel:n.LoggerDebugLevel.DISABLED};this.options=this.defaultOptions;this.config=this.config.bind(this),this.debugError=this.debugError.bind(this),this.debugInfo=this.debugInfo.bind(this),this.debugLog=this.debugLog.bind(this),this.enableDebugger=this.enableDebugger.bind(this),this.getOptions=this.getOptions.bind(this),this.postDispatch=this.postDispatch.bind(this),this.preDispatch=this.preDispatch.bind(this),this.config(o)}config(o){this.options={...this.defaultOptions,...o}}debugError(...o){const{debugErrorFnc:e,debugLevel:t}=this.options;e&&e(t,...o)}debugInfo(...o){const{debugInfoFnc:e,debugLevel:t}=this.options;e&&e(t,...o)}debugLog(...o){const{debugLogFnc:e,debugLevel:t}=this.options;e&&e(t,...o)}enableDebugger(o=n.LoggerDebugLevel.DISPATCH){this.options={...this.options,debugLevel:o}}getOptions(){return this.options}preDispatch(o,e){return this.previousStore=e,Promise.resolve(o)}postDispatch(o,e){const{debugLevel:t}=this.options;if(t>n.LoggerDebugLevel.LOGS){const{type:s}=o,g=!(0,p.isEqual)(e,this.previousStore),v=g?"Changed State":"Unchanged State",S=g?"#00d484":"#959595",D=(0,d.cloneDeep)(e)}return Promise.resolve(o)}}0&&(module.exports={Logger});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vc3JjL0xvZ2dlci9Mb2dnZXIudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQ29weXJpZ2h0IChjKSAyMDE4LVByZXNlbnQsIE5pdHJvZ2VuIExhYnMsIEluYy5cbiAqIENvcHlyaWdodHMgbGljZW5zZWQgdW5kZXIgdGhlIE1JVCBMaWNlbnNlLiBTZWUgdGhlIGFjY29tcGFueWluZyBMSUNFTlNFIGZpbGUgZm9yIHRlcm1zLlxuICovXG5cbmltcG9ydCB7Rmx1eEFjdGlvbn0gZnJvbSAnQG5sYWJzL2Fya2hhbWpzJztcbmltcG9ydCB7aXNFcXVhbH0gZnJvbSAnQG5sYWJzL3V0aWxzL2NoZWNrcy9pc0VxdWFsJztcbmltcG9ydCB7Y2xvbmVEZWVwfSBmcm9tICdAbmxhYnMvdXRpbHMvb2JqZWN0cy9jbG9uZSc7XG5cbmltcG9ydCB7TG9nZ2VyRGVidWdMZXZlbCwgTG9nZ2VyT3B0aW9uc30gZnJvbSAnLi4vdHlwZXMvbWFpbic7XG5cbmV4cG9ydCBjbGFzcyBMb2dnZXIge1xuICBuYW1lOiBzdHJpbmcgPSAnTG9nZ2VyJztcblxuICBwcml2YXRlIHByZXZpb3VzU3RvcmU6IGFueSA9IHt9O1xuICBwcml2YXRlIGRlZmF1bHRPcHRpb25zOiBMb2dnZXJPcHRpb25zID0ge1xuICAgIGRlYnVnTGV2ZWw6IExvZ2dlckRlYnVnTGV2ZWwuRElTQUJMRURcbiAgfTtcbiAgcHJpdmF0ZSBvcHRpb25zOiBMb2dnZXJPcHRpb25zID0gdGhpcy5kZWZhdWx0T3B0aW9ucztcblxuICBjb25zdHJ1Y3RvcihvcHRpb25zOiBMb2dnZXJPcHRpb25zKSB7XG4gICAgLy8gTWV0aG9kc1xuICAgIHRoaXMuY29uZmlnID0gdGhpcy5jb25maWcuYmluZCh0aGlzKTtcbiAgICB0aGlzLmRlYnVnRXJyb3IgPSB0aGlzLmRlYnVnRXJyb3IuYmluZCh0aGlzKTtcbiAgICB0aGlzLmRlYnVnSW5mbyA9IHRoaXMuZGVidWdJbmZvLmJpbmQodGhpcyk7XG4gICAgdGhpcy5kZWJ1Z0xvZyA9IHRoaXMuZGVidWdMb2cuYmluZCh0aGlzKTtcbiAgICB0aGlzLmVuYWJsZURlYnVnZ2VyID0gdGhpcy5lbmFibGVEZWJ1Z2dlci5iaW5kKHRoaXMpO1xuICAgIHRoaXMuZ2V0T3B0aW9ucyA9IHRoaXMuZ2V0T3B0aW9ucy5iaW5kKHRoaXMpO1xuICAgIHRoaXMucG9zdERpc3BhdGNoID0gdGhpcy5wb3N0RGlzcGF0Y2guYmluZCh0aGlzKTtcbiAgICB0aGlzLnByZURpc3BhdGNoID0gdGhpcy5wcmVEaXNwYXRjaC5iaW5kKHRoaXMpO1xuXG4gICAgLy8gQ29uZmlndXJhdGlvblxuICAgIHRoaXMuY29uZmlnKG9wdGlvbnMpO1xuICB9XG5cbiAgLyoqXG4gICAqIFNldCBjb25maWd1cmF0aW9uIG9wdGlvbnMuXG4gICAqXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBvcHRpb25zIENvbmZpZ3VyYXRpb24gb3B0aW9ucy5cbiAgICovXG4gIGNvbmZpZyhvcHRpb25zOiBMb2dnZXJPcHRpb25zKTogdm9pZCB7XG4gICAgdGhpcy5vcHRpb25zID0gey4uLnRoaXMuZGVmYXVsdE9wdGlvbnMsIC4uLm9wdGlvbnN9O1xuICB9XG5cbiAgLyoqXG4gICAqIExvZ3MgZXJyb3JzIGluIHRoZSBjb25zb2xlLiBXaWxsIGFsc28gY2FsbCB0aGUgZGVidWdFcnJvckZuYyBtZXRob2Qgc2V0IGluIHRoZSBjb25maWcuXG4gICAqXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBvYmogQSBsaXN0IG9mIEphdmFTY3JpcHQgb2JqZWN0cyB0byBvdXRwdXQuIFRoZSBzdHJpbmcgcmVwcmVzZW50YXRpb25zIG9mIGVhY2ggb2YgdGhlc2Ugb2JqZWN0c1xuICAgKiBhcmUgYXBwZW5kZWQgdG9nZXRoZXIgaW4gdGhlIG9yZGVyIGxpc3RlZCBhbmQgb3V0cHV0LlxuICAgKi9cbiAgZGVidWdFcnJvciguLi5vYmopOiB2b2lkIHtcbiAgICBjb25zdCB7ZGVidWdFcnJvckZuYywgZGVidWdMZXZlbH0gPSB0aGlzLm9wdGlvbnM7XG5cbiAgICBpZihkZWJ1Z0xldmVsKSB7XG4gICAgICBjb25zb2xlLmVycm9yKC4uLm9iaik7XG4gICAgfVxuXG4gICAgaWYoZGVidWdFcnJvckZuYykge1xuICAgICAgZGVidWdFcnJvckZuYyhkZWJ1Z0xldmVsLCAuLi5vYmopO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBMb2dzIGluZm9ybWF0aW9uYWwgbWVzc2FnZXMgdG8gdGhlIGNvbnNvbGUuIFdpbGwgYWxzbyBjYWxsIHRoZSBkZWJ1Z0luZm9GbmMgbWV0aG9kIHNldCBpbiB0aGUgY29uZmlnLlxuICAgKlxuICAgKiBAcGFyYW0ge29iamVjdH0gb2JqIEEgbGlzdCBvZiBKYXZhU2NyaXB0IG9iamVjdHMgdG8gb3V0cHV0LiBUaGUgc3RyaW5nIHJlcHJlc2VudGF0aW9ucyBvZiBlYWNoIG9mIHRoZXNlIG9iamVjdHNcbiAgICogYXJlIGFwcGVuZGVkIHRvZ2V0aGVyIGluIHRoZSBvcmRlciBsaXN0ZWQgYW5kIG91dHB1dC5cbiAgICovXG4gIGRlYnVnSW5mbyguLi5vYmopOiB2b2lkIHtcbiAgICBjb25zdCB7ZGVidWdJbmZvRm5jLCBkZWJ1Z0xldmVsfSA9IHRoaXMub3B0aW9ucztcblxuICAgIGlmKGRlYnVnTGV2ZWwpIHtcbiAgICAgIGNvbnNvbGUuaW5mbyguLi5vYmopO1xuICAgIH1cblxuICAgIGlmKGRlYnVnSW5mb0ZuYykge1xuICAgICAgZGVidWdJbmZvRm5jKGRlYnVnTGV2ZWwsIC4uLm9iaik7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIExvZ3MgZGF0YSBpbiB0aGUgY29uc29sZS4gT25seSBsb2dzIHdoZW4gaW4gZGVidWcgbW9kZS4gIFdpbGwgYWxzbyBjYWxsIHRoZSBkZWJ1Z0xvZ0ZuYyBtZXRob2Qgc2V0IGluIHRoZSBjb25maWcuXG4gICAqXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBvYmogQSBsaXN0IG9mIEphdmFTY3JpcHQgb2JqZWN0cyB0byBvdXRwdXQuIFRoZSBzdHJpbmcgcmVwcmVzZW50YXRpb25zIG9mIGVhY2ggb2YgdGhlc2Ugb2JqZWN0c1xuICAgKiBhcmUgYXBwZW5kZWQgdG9nZXRoZXIgaW4gdGhlIG9yZGVyIGxpc3RlZCBhbmQgb3V0cHV0LlxuICAgKi9cbiAgZGVidWdMb2coLi4ub2JqKTogdm9pZCB7XG4gICAgY29uc3Qge2RlYnVnTG9nRm5jLCBkZWJ1Z0xldmVsfSA9IHRoaXMub3B0aW9ucztcblxuICAgIGlmKGRlYnVnTGV2ZWwpIHtcbiAgICAgIGNvbnNvbGUubG9nKC4uLm9iaik7XG4gICAgfVxuXG4gICAgaWYoZGVidWdMb2dGbmMpIHtcbiAgICAgIGRlYnVnTG9nRm5jKGRlYnVnTGV2ZWwsIC4uLm9iaik7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIEVuYWJsZXMgdGhlIGNvbnNvbGUgZGVidWdnZXIuXG4gICAqXG4gICAqIEBwYXJhbSB7bnVtYmVyfSBsZXZlbCBFbmFibGUgb3IgZGlzYWJsZSB0aGUgZGVidWdnZXIuIFVzZXMgdGhlIGNvbnN0YW50czpcbiAgICogICBMb2dnZXJEZWJ1Z0xldmVsLkRJU0FCTEVEICgwKSAtIERpc2FibGUuXG4gICAqICAgTG9nZ2VyRGVidWdMZXZlbC5MT0dTICgxKSAtIEVuYWJsZSBjb25zb2xlIGxvZ3MuXG4gICAqICAgTG9nZ2VyRGVidWdMZXZlbC5ESVNQQVRDSCAoMikgLSBFbmFibGUgY29uc29sZSBsb2dzIGFuZCBkaXNwYXRjaCBhY3Rpb24gZGF0YSAoZGVmYXVsdCkuXG4gICAqL1xuICBlbmFibGVEZWJ1Z2dlcihsZXZlbDogbnVtYmVyID0gTG9nZ2VyRGVidWdMZXZlbC5ESVNQQVRDSCk6IHZvaWQge1xuICAgIHRoaXMub3B0aW9ucyA9IHsuLi50aGlzLm9wdGlvbnMsIGRlYnVnTGV2ZWw6IGxldmVsfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgdGhlIGN1cnJlbnQgRmx1eExvZ2dlciBvcHRpb25zLlxuICAgKlxuICAgKiBAcmV0dXJucyB7TG9nZ2VyT3B0aW9uc30gdGhlIEZsdXhMb2dnZXIgb3B0aW9ucyBvYmplY3QuXG4gICAqL1xuICBnZXRPcHRpb25zKCk6IExvZ2dlck9wdGlvbnMge1xuICAgIHJldHVybiB0aGlzLm9wdGlvbnM7XG4gIH1cblxuICBwcmVEaXNwYXRjaChhY3Rpb246IEZsdXhBY3Rpb24sIHN0b3JlKTogUHJvbWlzZTxGbHV4QWN0aW9uPiB7XG4gICAgdGhpcy5wcmV2aW91c1N0b3JlID0gc3RvcmU7XG4gICAgcmV0dXJuIFByb21pc2UucmVzb2x2ZShhY3Rpb24pO1xuICB9XG5cbiAgcG9zdERpc3BhdGNoKGFjdGlvbjogRmx1eEFjdGlvbiwgc3RvcmU6IG9iamVjdCk6IFByb21pc2U8Rmx1eEFjdGlvbj4ge1xuICAgIGNvbnN0IHtkZWJ1Z0xldmVsfSA9IHRoaXMub3B0aW9ucztcblxuICAgIGlmKGRlYnVnTGV2ZWwgPiBMb2dnZXJEZWJ1Z0xldmVsLkxPR1MpIHtcbiAgICAgIGNvbnN0IHt0eXBlfSA9IGFjdGlvbjtcbiAgICAgIGNvbnN0IGhhc0NoYW5nZWQgPSAhaXNFcXVhbChzdG9yZSwgdGhpcy5wcmV2aW91c1N0b3JlKTtcbiAgICAgIGNvbnN0IHVwZGF0ZWRMYWJlbCA9IGhhc0NoYW5nZWQgPyAnQ2hhbmdlZCBTdGF0ZScgOiAnVW5jaGFuZ2VkIFN0YXRlJztcbiAgICAgIGNvbnN0IHVwZGF0ZWRDb2xvciA9IGhhc0NoYW5nZWQgPyAnIzAwZDQ4NCcgOiAnIzk1OTU5NSc7XG4gICAgICBjb25zdCB1cGRhdGVkU3RvcmUgPSBjbG9uZURlZXAoc3RvcmUpO1xuXG4gICAgICBpZihjb25zb2xlLmdyb3VwQ29sbGFwc2VkKSB7XG4gICAgICAgIGNvbnNvbGUuZ3JvdXBDb2xsYXBzZWQoYEZMVVggRElTUEFUQ0g6ICR7dHlwZX1gKTtcbiAgICAgICAgY29uc29sZS5sb2coJyVjIEFjdGlvbjogJywgJ2NvbG9yOiAjMDBDNEZGJywgYWN0aW9uKTtcbiAgICAgICAgY29uc29sZS5sb2coJyVjIExhc3QgU3RhdGU6ICcsICdjb2xvcjogIzk1OTU5NScsIHRoaXMucHJldmlvdXNTdG9yZSk7XG4gICAgICAgIGNvbnNvbGUubG9nKGAlYyAke3VwZGF0ZWRMYWJlbH06IGAsIGBjb2xvcjogJHt1cGRhdGVkQ29sb3J9YCwgdXBkYXRlZFN0b3JlKTtcbiAgICAgICAgY29uc29sZS5ncm91cEVuZCgpO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgY29uc29sZS5sb2coYEZMVVggRElTUEFUQ0g6ICR7dHlwZX1gKTtcbiAgICAgICAgY29uc29sZS5sb2coJ0FjdGlvbjogJywgYWN0aW9uKTtcbiAgICAgICAgY29uc29sZS5sb2coJ0xhc3QgU3RhdGU6ICcsIHRoaXMucHJldmlvdXNTdG9yZSk7XG4gICAgICAgIGNvbnNvbGUubG9nKGAke3VwZGF0ZWRMYWJlbH06IGAsIHVwZGF0ZWRTdG9yZSk7XG4gICAgICB9XG4gICAgfVxuXG4gICAgcmV0dXJuIFByb21pc2UucmVzb2x2ZShhY3Rpb24pO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiNFpBQUEsSUFBQUEsRUFBQSxHQUFBQyxFQUFBRCxFQUFBLFlBQUFFLElBQUEsZUFBQUMsRUFBQUgsR0FNQSxJQUFBSSxFQUFzQix1Q0FDdEJDLEVBQXdCLHNDQUV4QkMsRUFBOEMseUJBRXZDLE1BQU1KLENBQU8sQ0FTbEIsWUFBWUssRUFBd0IsQ0FScEMsVUFBZSxTQUVmLEtBQVEsY0FBcUIsQ0FBQyxFQUM5QixLQUFRLGVBQWdDLENBQ3RDLFdBQVksbUJBQWlCLFFBQy9CLEVBQ0EsS0FBUSxRQUF5QixLQUFLLGVBSXBDLEtBQUssT0FBUyxLQUFLLE9BQU8sS0FBSyxJQUFJLEVBQ25DLEtBQUssV0FBYSxLQUFLLFdBQVcsS0FBSyxJQUFJLEVBQzNDLEtBQUssVUFBWSxLQUFLLFVBQVUsS0FBSyxJQUFJLEVBQ3pDLEtBQUssU0FBVyxLQUFLLFNBQVMsS0FBSyxJQUFJLEVBQ3ZDLEtBQUssZUFBaUIsS0FBSyxlQUFlLEtBQUssSUFBSSxFQUNuRCxLQUFLLFdBQWEsS0FBSyxXQUFXLEtBQUssSUFBSSxFQUMzQyxLQUFLLGFBQWUsS0FBSyxhQUFhLEtBQUssSUFBSSxFQUMvQyxLQUFLLFlBQWMsS0FBSyxZQUFZLEtBQUssSUFBSSxFQUc3QyxLQUFLLE9BQU9BLENBQU8sQ0FDckIsQ0FPQSxPQUFPQSxFQUE4QixDQUNuQyxLQUFLLFFBQVUsQ0FBQyxHQUFHLEtBQUssZUFBZ0IsR0FBR0EsQ0FBTyxDQUNwRCxDQVFBLGNBQWNDLEVBQVcsQ0FDdkIsS0FBTSxDQUFDLGNBQUFDLEVBQWUsV0FBQUMsQ0FBVSxFQUFJLEtBQUssUUFNdENELEdBQ0RBLEVBQWNDLEVBQVksR0FBR0YsQ0FBRyxDQUVwQyxDQVFBLGFBQWFBLEVBQVcsQ0FDdEIsS0FBTSxDQUFDLGFBQUFHLEVBQWMsV0FBQUQsQ0FBVSxFQUFJLEtBQUssUUFNckNDLEdBQ0RBLEVBQWFELEVBQVksR0FBR0YsQ0FBRyxDQUVuQyxDQVFBLFlBQVlBLEVBQVcsQ0FDckIsS0FBTSxDQUFDLFlBQUFJLEVBQWEsV0FBQUYsQ0FBVSxFQUFJLEtBQUssUUFNcENFLEdBQ0RBLEVBQVlGLEVBQVksR0FBR0YsQ0FBRyxDQUVsQyxDQVVBLGVBQWVLLEVBQWdCLG1CQUFpQixTQUFnQixDQUM5RCxLQUFLLFFBQVUsQ0FBQyxHQUFHLEtBQUssUUFBUyxXQUFZQSxDQUFLLENBQ3BELENBT0EsWUFBNEIsQ0FDMUIsT0FBTyxLQUFLLE9BQ2QsQ0FFQSxZQUFZQyxFQUFvQkMsRUFBNEIsQ0FDMUQsWUFBSyxjQUFnQkEsRUFDZCxRQUFRLFFBQVFELENBQU0sQ0FDL0IsQ0FFQSxhQUFhQSxFQUFvQkMsRUFBb0MsQ0FDbkUsS0FBTSxDQUFDLFdBQUFMLENBQVUsRUFBSSxLQUFLLFFBRTFCLEdBQUdBLEVBQWEsbUJBQWlCLEtBQU0sQ0FDckMsS0FBTSxDQUFDLEtBQUFNLENBQUksRUFBSUYsRUFDVEcsRUFBYSxJQUFDLFdBQVFGLEVBQU8sS0FBSyxhQUFhLEVBQy9DRyxFQUFlRCxFQUFhLGdCQUFrQixrQkFDOUNFLEVBQWVGLEVBQWEsVUFBWSxVQUN4Q0csS0FBZSxhQUFVTCxDQUFLLENBY3RDLENBRUEsT0FBTyxRQUFRLFFBQVFELENBQU0sQ0FDL0IsQ0FDRiIsCiAgIm5hbWVzIjogWyJMb2dnZXJfZXhwb3J0cyIsICJfX2V4cG9ydCIsICJMb2dnZXIiLCAiX190b0NvbW1vbkpTIiwgImltcG9ydF9pc0VxdWFsIiwgImltcG9ydF9jbG9uZSIsICJpbXBvcnRfbWFpbiIsICJvcHRpb25zIiwgIm9iaiIsICJkZWJ1Z0Vycm9yRm5jIiwgImRlYnVnTGV2ZWwiLCAiZGVidWdJbmZvRm5jIiwgImRlYnVnTG9nRm5jIiwgImxldmVsIiwgImFjdGlvbiIsICJzdG9yZSIsICJ0eXBlIiwgImhhc0NoYW5nZWQiLCAidXBkYXRlZExhYmVsIiwgInVwZGF0ZWRDb2xvciIsICJ1cGRhdGVkU3RvcmUiXQp9Cg==

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+import { Logger } from './Logger/Logger';
+export * from './types/main';
+export { Logger };

package/lib/index.js

@@ -0,0 +1,2 @@
+var g=Object.defineProperty;var L=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var c=(r,o)=>{for(var e in o)g(r,e,{get:o[e],enumerable:!0})},f=(r,o,e,x)=>{if(o&&typeof o=="object"||typeof o=="function")for(let m of a(o))!b.call(r,m)&&m!==e&&g(r,m,{get:()=>o[m],enumerable:!(x=L(o,m))||x.enumerable});return r},t=(r,o,e)=>(f(r,o,"default"),e&&f(e,o,"default"));var d=r=>f(g({},"__esModule",{value:!0}),r);var p={};c(p,{Logger:()=>i.Logger});module.exports=d(p);var i=require("./Logger/Logger");t(p,require("./types/main"),module.exports);0&&(module.exports={Logger,...require("./types/main")});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIENvcHlyaWdodCAoYykgMjAxOC1QcmVzZW50LCBOaXRyb2dlbiBMYWJzLCBJbmMuXG4gKiBDb3B5cmlnaHRzIGxpY2Vuc2VkIHVuZGVyIHRoZSBNSVQgTGljZW5zZS4gU2VlIHRoZSBhY2NvbXBhbnlpbmcgTElDRU5TRSBmaWxlIGZvciB0ZXJtcy5cbiAqL1xuXG5pbXBvcnQge0xvZ2dlcn0gZnJvbSAnLi9Mb2dnZXIvTG9nZ2VyJztcblxuZXhwb3J0ICogZnJvbSAnLi90eXBlcy9tYWluJztcbmV4cG9ydCB7TG9nZ2VyfTtcbiJdLAogICJtYXBwaW5ncyI6ICI4Y0FBQSxJQUFBQSxFQUFBLEdBQUFDLEVBQUFELEVBQUEsc0NBQUFFLEVBQUFGLEdBS0EsSUFBQUcsRUFBcUIsMkJBRXJCQyxFQUFBSixFQUFjLHdCQVBkIiwKICAibmFtZXMiOiBbImluZGV4X2V4cG9ydHMiLCAiX19leHBvcnQiLCAiX190b0NvbW1vbkpTIiwgImltcG9ydF9Mb2dnZXIiLCAiX19yZUV4cG9ydCJdCn0K

package/lib/types/main.d.ts

@@ -0,0 +1,11 @@
+export declare enum LoggerDebugLevel {
+    DISABLED = 0,
+    LOGS = 1,
+    DISPATCH = 2
+}
+export interface LoggerOptions {
+    readonly debugLevel?: LoggerDebugLevel;
+    readonly debugErrorFnc?: (debugLevel: number, ...args: any[]) => void;
+    readonly debugInfoFnc?: (debugLevel: number, ...args: any[]) => void;
+    readonly debugLogFnc?: (debugLevel: number, ...args: any[]) => void;
+}

package/lib/types/main.js

@@ -0,0 +1,2 @@
+var e=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var m=(r,d)=>{for(var a in d)e(r,a,{get:d[a],enumerable:!0})},s=(r,d,a,n)=>{if(d&&typeof d=="object"||typeof d=="function")for(let o of i(d))!c.call(r,o)&&o!==a&&e(r,o,{get:()=>d[o],enumerable:!(n=b(d,o))||n.enumerable});return r};var t=r=>s(e({},"__esModule",{value:!0}),r);var y={};m(y,{LoggerDebugLevel:()=>u});module.exports=t(y);var u=(n=>(n[n.DISABLED=0]="DISABLED",n[n.LOGS=1]="LOGS",n[n.DISPATCH=2]="DISPATCH",n))(u||{});0&&(module.exports={LoggerDebugLevel});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vc3JjL3R5cGVzL21haW4udHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbImV4cG9ydCBlbnVtIExvZ2dlckRlYnVnTGV2ZWwge1xuICBESVNBQkxFRCA9IDAsXG4gIExPR1MgPSAxLFxuICBESVNQQVRDSCA9IDJcbn1cblxuZXhwb3J0IGludGVyZmFjZSBMb2dnZXJPcHRpb25zIHtcbiAgcmVhZG9ubHkgZGVidWdMZXZlbD86IExvZ2dlckRlYnVnTGV2ZWw7XG4gIHJlYWRvbmx5IGRlYnVnRXJyb3JGbmM/OiAoZGVidWdMZXZlbDogbnVtYmVyLCAuLi5hcmdzKSA9PiB2b2lkO1xuICByZWFkb25seSBkZWJ1Z0luZm9GbmM/OiAoZGVidWdMZXZlbDogbnVtYmVyLCAuLi5hcmdzKSA9PiB2b2lkO1xuICByZWFkb25seSBkZWJ1Z0xvZ0ZuYz86IChkZWJ1Z0xldmVsOiBudW1iZXIsIC4uLmFyZ3MpID0+IHZvaWQ7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiNFpBQUEsSUFBQUEsRUFBQSxHQUFBQyxFQUFBRCxFQUFBLHNCQUFBRSxJQUFBLGVBQUFDLEVBQUFILEdBQU8sSUFBS0UsT0FDVkEsSUFBQSxTQUFXLEdBQVgsV0FDQUEsSUFBQSxLQUFPLEdBQVAsT0FDQUEsSUFBQSxTQUFXLEdBQVgsV0FIVUEsT0FBQSIsCiAgIm5hbWVzIjogWyJtYWluX2V4cG9ydHMiLCAiX19leHBvcnQiLCAiTG9nZ2VyRGVidWdMZXZlbCIsICJfX3RvQ29tbW9uSlMiXQp9Cg==

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@nlabs/arkhamjs-middleware-logger",
-  "version": "3.28.7",
+  "version": "3.29.0",
   "publishConfig": {
     "access": "public"
   },
   "description": "Add console logging for ArkhamJS",
+  "type": "module",
   "license": "MIT",
   "main": "./lib/index.js",
   "module": "./lib/index.js",
@@ -30,29 +31,33 @@
     "url": "https://github.com/nitrogenlabs/arkhamjs/issues"
   },
   "scripts": {
-    "build": "lex compile",
+    "build": "lex compile --remove",
     "clean": "lex clean",
-    "lint": "eslint ./src --ext .ts,.tsx",
+    "lint": "lex lint --fix",
     "prepublishOnly": "npm run build",
     "publish:major": "npm version major && npm publish",
     "publish:minor": "npm version minor && npm publish",
     "publish:patch": "npm version patch && npm publish",
     "pretest": "lex lint",
     "test": "lex test",
-    "update": "npm-check-updates --interactive"
+    "update": "lex update --interactive"
   },
   "peerDependencies": {
-    "@nlabs/arkhamjs": "*",
-    "lodash": "^4.17"
+    "@nlabs/arkhamjs": "*"
   },
   "devDependencies": {
     "@nlabs/arkhamjs": "*",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^22.13.1",
-    "eslint": "^9.19.0",
-    "eslint-config-styleguidejs": "^3.2.1",
-    "lodash": "^4.17.21",
-    "typescript": "^5.7.3"
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.0.10",
+    "typescript": "^5.8.3"
   },
+  "files": [
+    "lib",
+    "index.js",
+    "index.d.ts",
+    "LICENSE",
+    "package.json",
+    "README.md"
+  ],
   "gitHead": "fc371e1e28fe0ae35d40d29a217d5f0e990ec32a"
 }