axon-logger 1.0.2 → 1.0.3

package/BROWSER_COMPATIBILITY.md

@@ -4,10 +4,11 @@
 
 AXON Logger version 1.0.1+ is fully compatible with browser environments (React, Next.js, Vue, Angular, etc.). The framework automatically detects the environment and uses appropriate storage mechanisms.
 
-## What's Changed in v1.0.1
+## What's Changed in v1.0.2
 
-✅ **Fixed**: Conditional imports for Node.js-only modules (`fs`, `path`)  
-✅ **Fixed**: Browser bundlers (webpack, Vite, etc.) no longer throw "Can't resolve 'fs'" errors  
+✅ **Fixed**: Conditional imports for Node.js-only modules (`fs`, `path`) in FileManager  
+✅ **Fixed**: Browser bundlers (webpack, Vite, Turbopack) no longer throw "Can't resolve 'fs'" errors  
+✅ **Fixed**: Next.js 16 Turbopack compatibility  
 ✅ **Added**: Automatic environment detection  
 ✅ **Added**: Browser-specific storage using localStorage/IndexedDB  
 
@@ -294,25 +295,18 @@ AXON automatically uses the best available storage:
 
 ### Issue: "Can't resolve 'fs'" error in Next.js
 
-**Solution**: Update to axon-logger v1.0.1+
+**Solution**: Update to axon-logger v1.0.2+
 
-If still seeing errors, add to `next.config.ts`:
+```bash
+npm install axon-logger@latest
+```
 
-```typescript
-const nextConfig = {
-  webpack: (config, { isServer }) => {
-    if (!isServer) {
-      config.resolve.fallback = {
-        ...config.resolve.fallback,
-        fs: false,
-        path: false,
-      };
-    }
-    return config;
-  },
-};
+If still seeing errors after update, try clearing cache:
 
-export default nextConfig;
+```bash
+rm -rf .next node_modules
+npm install
+npm run build
 ```
 
 ### Issue: Logs not persisting across page reloads
@@ -417,29 +411,23 @@ setInterval(async () => {
 }, 30000); // Every 30 seconds
 ```
 
-## Migration from v1.0.0 to v1.0.1
+## Migration from v1.0.0 to v1.0.2
 
 No breaking changes! Just update:
 
 ```bash
-npm update axon-logger
+npm install axon-logger@latest
 ```
 
-If you were using webpack fallbacks, you can remove them:
+Clear build cache if needed:
 
-```typescript
-// next.config.ts - CAN BE REMOVED in v1.0.1+
-const nextConfig = {
-  webpack: (config, { isServer }) => {
-    if (!isServer) {
-      config.resolve.fallback = {
-        fs: false,  // ← No longer needed
-        path: false // ← No longer needed
-      };
-    }
-    return config;
-  },
-};
+```bash
+# Next.js
+rm -rf .next
+
+# General
+rm -rf node_modules
+npm install
 ```
 
 ## Browser Support
@@ -479,7 +467,7 @@ See full examples at:
 
 - **NPM**: https://www.npmjs.com/package/axon-logger
 - **Issues**: Report via npm package page
-- **Version**: 1.0.1+
+- **Version**: 1.0.2+ (Browser compatible)
 
 ## License
 

package/QUICK_START_FOR_AI.md

@@ -0,0 +1,240 @@
+# AXON Logger - Quick Start for AI Assistants
+
+## TL;DR
+
+```bash
+npm install axon-logger
+```
+
+```typescript
+import { Logger, LogLevel } from 'axon-logger';
+
+const logger = new Logger({
+  outputPath: './logs/app.txt',  // Node.js: file path | Browser: storage key
+  level: LogLevel.INFO
+});
+
+logger.info('Hello AXON');
+await logger.flush();
+```
+
+## Key Points
+
+✅ **Works in both Node.js and Browser** (React, Next.js, Vue, Angular)  
+✅ **No configuration needed** for browser environments  
+✅ **30-60% fewer tokens** than JSON logging  
+✅ **Automatic environment detection**  
+
+## Installation
+
+```bash
+npm install axon-logger
+```
+
+## Node.js Usage
+
+```typescript
+import { Logger, LogLevel } from 'axon-logger';
+
+const logger = new Logger({
+  outputPath: './logs/app.txt',
+  level: LogLevel.INFO
+});
+
+logger.info('Application started');
+logger.error('Error occurred', { code: 500 });
+
+await logger.flush();
+await logger.close();
+```
+
+## Browser Usage (React, Next.js, Vue, Angular)
+
+```typescript
+import { Logger, LogLevel } from 'axon-logger';
+
+// Automatically uses localStorage/IndexedDB
+const logger = new Logger({
+  outputPath: 'app-logs',  // Storage key, not file path
+  level: LogLevel.INFO
+});
+
+logger.info('User action', { action: 'click' });
+await logger.flush();
+```
+
+## Next.js Client Component
+
+```typescript
+'use client';
+
+import { Logger, LogLevel } from 'axon-logger';
+
+const logger = new Logger({
+  outputPath: 'nextjs-logs',
+  level: LogLevel.INFO
+});
+
+export default function MyComponent() {
+  const handleClick = () => {
+    logger.info('Button clicked');
+  };
+
+  return <button onClick={handleClick}>Click Me</button>;
+}
+```
+
+## Configuration Options
+
+```typescript
+const logger = new Logger({
+  outputPath: './logs/app.txt',     // Required
+  level: LogLevel.INFO,             // Required
+  maxFileSize: 10 * 1024 * 1024,   // Optional: 10MB
+  rotationInterval: 'daily',        // Optional: 'hourly' | 'daily' | 'weekly' | 'none'
+  bufferSize: 100,                  // Optional: buffer entries
+  flushInterval: 5000,              // Optional: auto-flush ms
+  omitNullValues: true,             // Optional: skip nulls
+  fieldAliases: {                   // Optional: shorten fields
+    timestamp: 't',
+    level: 'l',
+    message: 'm'
+  }
+});
+```
+
+## Log Levels
+
+```typescript
+logger.debug('Debug info');      // LogLevel.DEBUG (0)
+logger.info('Information');      // LogLevel.INFO (1)
+logger.warn('Warning');          // LogLevel.WARN (2)
+logger.error('Error');           // LogLevel.ERROR (3)
+logger.fatal('Critical error');  // LogLevel.FATAL (4)
+```
+
+## Advanced Features
+
+### Section Markers
+
+```typescript
+logger.mark('payment-start');
+logger.info('Processing payment');
+logger.mark('payment-end');
+```
+
+### Global Metadata
+
+```typescript
+logger.setGlobalMetadata({
+  appVersion: '1.0.0',
+  environment: 'production'
+});
+
+logger.info('Event'); // Includes global metadata
+```
+
+### Download Logs (Browser)
+
+```typescript
+const fileManager = logger.getFileManager();
+if ('downloadLogs' in fileManager) {
+  await fileManager.downloadLogs();
+}
+```
+
+## Common Patterns
+
+### Express.js Middleware
+
+```typescript
+app.use((req, res, next) => {
+  logger.info('Request', {
+    method: req.method,
+    path: req.path
+  });
+  next();
+});
+```
+
+### Error Handling
+
+```typescript
+try {
+  // ... code
+} catch (error) {
+  logger.error('Operation failed', {
+    error: error.message,
+    stack: error.stack
+  });
+}
+```
+
+### Cleanup on Shutdown
+
+```typescript
+process.on('SIGTERM', async () => {
+  await logger.flush();
+  await logger.close();
+  process.exit(0);
+});
+```
+
+## Troubleshooting
+
+### "Can't resolve 'fs'" in Next.js
+
+**Solution**: Update to latest version
+
+```bash
+npm install axon-logger@latest
+rm -rf .next
+npm run build
+```
+
+### Logs not persisting
+
+**Solution**: Call flush before exit
+
+```typescript
+await logger.flush();
+```
+
+## TOON Format Example
+
+Input:
+```typescript
+logger.info('User login', { userId: 123, email: 'user@example.com' });
+```
+
+Output (TOON):
+```
+timestamp: 1705334400000, level: INFO, message: User login, userId: 123, email: user@example.com
+```
+
+vs JSON (more tokens):
+```json
+{"timestamp":1705334400000,"level":"INFO","message":"User login","userId":123,"email":"user@example.com"}
+```
+
+## Performance
+
+- **Token Reduction**: 30-60% vs JSON
+- **Throughput**: 80,000+ logs/second
+- **Memory**: ~1-2MB per 1000 entries
+- **Latency**: <1ms per log (buffered)
+
+## Documentation
+
+- **Full Guide**: `INTEGRATION_GUIDE.md`
+- **Browser Guide**: `BROWSER_COMPATIBILITY.md`
+- **API Docs**: `docs/API.md`
+- **NPM**: https://www.npmjs.com/package/axon-logger
+
+## Version
+
+Current: **1.0.2** (Browser compatible)
+
+## License
+
+MIT - Free for commercial and personal use

package/dist/index.d.ts

@@ -5,7 +5,10 @@
 export { Logger, LogLevel, LogEntry, LoggerConfig, ResolvedConfig, Environment, MetadataFilter, DEFAULT_CONFIG, detectEnvironment, loadFromEnvironment, loadFromFile, mergeConfigurations } from './logger';
 export { TOONSerializer, TOONSerializerConfig } from './serializer';
 export { TOONParser, StreamingParser } from './parser';
-export { FileManager, BrowserFileManager, FileManagerConfig, RotationMetadata } from './file-manager';
+export { BrowserFileManager, FileManagerConfig, RotationMetadata } from './file-manager';
+export type { FileManager } from './file-manager/FileManager';
+export type { LogExtractor } from './extractor/LogExtractor';
 export { TokenCounter } from './utils';
-export { LogExtractor } from './extractor';
+export declare const loadFileManager: () => Promise<typeof import("./file-manager").FileManager>;
+export declare const loadLogExtractor: () => Promise<typeof import("./extractor/LogExtractor").LogExtractor>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,cAAc,EACd,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,eAAe,EAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,YAAY,EACb,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,cAAc,EACd,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,eAAe,EAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EACL,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,eAAe,4DAM3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,uEAM5B,CAAC"}

package/dist/index.js

@@ -3,8 +3,41 @@
  * AXON - Token-Oriented Logging Framework
  * Main export file
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogExtractor = exports.TokenCounter = exports.BrowserFileManager = exports.FileManager = exports.StreamingParser = exports.TOONParser = exports.TOONSerializer = exports.mergeConfigurations = exports.loadFromFile = exports.loadFromEnvironment = exports.detectEnvironment = exports.DEFAULT_CONFIG = exports.LogLevel = exports.Logger = void 0;
+exports.loadLogExtractor = exports.loadFileManager = exports.TokenCounter = exports.BrowserFileManager = exports.StreamingParser = exports.TOONParser = exports.TOONSerializer = exports.mergeConfigurations = exports.loadFromFile = exports.loadFromEnvironment = exports.detectEnvironment = exports.DEFAULT_CONFIG = exports.LogLevel = exports.Logger = void 0;
 // Logger exports
 var logger_1 = require("./logger");
 Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
@@ -23,12 +56,25 @@ Object.defineProperty(exports, "TOONParser", { enumerable: true, get: function (
 Object.defineProperty(exports, "StreamingParser", { enumerable: true, get: function () { return parser_1.StreamingParser; } });
 // File Manager exports
 var file_manager_1 = require("./file-manager");
-Object.defineProperty(exports, "FileManager", { enumerable: true, get: function () { return file_manager_1.FileManager; } });
 Object.defineProperty(exports, "BrowserFileManager", { enumerable: true, get: function () { return file_manager_1.BrowserFileManager; } });
 // Utils exports
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "TokenCounter", { enumerable: true, get: function () { return utils_1.TokenCounter; } });
-// Extractor exports
-var extractor_1 = require("./extractor");
-Object.defineProperty(exports, "LogExtractor", { enumerable: true, get: function () { return extractor_1.LogExtractor; } });
+// Dynamic imports for Node.js only (prevents bundling in browser)
+const loadFileManager = async () => {
+    if (typeof window !== 'undefined') {
+        throw new Error('FileManager is only available in Node.js. Use BrowserFileManager for browser environments.');
+    }
+    const { FileManager } = await Promise.resolve().then(() => __importStar(require('./file-manager/FileManager')));
+    return FileManager;
+};
+exports.loadFileManager = loadFileManager;
+const loadLogExtractor = async () => {
+    if (typeof window !== 'undefined') {
+        throw new Error('LogExtractor is only available in Node.js.');
+    }
+    const { LogExtractor } = await Promise.resolve().then(() => __importStar(require('./extractor/LogExtractor')));
+    return LogExtractor;
+};
+exports.loadLogExtractor = loadLogExtractor;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iBAAiB;AACjB,mCAakB;AAZhB,gGAAA,MAAM,OAAA;AACN,kGAAA,QAAQ,OAAA;AAMR,wGAAA,cAAc,OAAA;AACd,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AACnB,sGAAA,YAAY,OAAA;AACZ,6GAAA,mBAAmB,OAAA;AAGrB,qBAAqB;AACrB,2CAGsB;AAFpB,4GAAA,cAAc,OAAA;AAIhB,iBAAiB;AACjB,mCAGkB;AAFhB,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AAGjB,uBAAuB;AACvB,+CAKwB;AAJtB,2GAAA,WAAW,OAAA;AACX,kHAAA,kBAAkB,OAAA;AAKpB,gBAAgB;AAChB,iCAEiB;AADf,qGAAA,YAAY,OAAA;AAGd,oBAAoB;AACpB,yCAEqB;AADnB,yGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iBAAiB;AACjB,mCAakB;AAZhB,gGAAA,MAAM,OAAA;AACN,kGAAA,QAAQ,OAAA;AAMR,wGAAA,cAAc,OAAA;AACd,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AACnB,sGAAA,YAAY,OAAA;AACZ,6GAAA,mBAAmB,OAAA;AAGrB,qBAAqB;AACrB,2CAGsB;AAFpB,4GAAA,cAAc,OAAA;AAIhB,iBAAiB;AACjB,mCAGkB;AAFhB,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AAGjB,uBAAuB;AACvB,+CAIwB;AAHtB,kHAAA,kBAAkB,OAAA;AASpB,gBAAgB;AAChB,iCAEiB;AADf,qGAAA,YAAY,OAAA;AAGd,kEAAkE;AAC3D,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;IACxC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;IAChH,CAAC;IACD,MAAM,EAAE,WAAW,EAAE,GAAG,wDAAa,4BAA4B,GAAC,CAAC;IACnE,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AANW,QAAA,eAAe,mBAM1B;AAEK,MAAM,gBAAgB,GAAG,KAAK,IAAI,EAAE;IACzC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,EAAE,YAAY,EAAE,GAAG,wDAAa,0BAA0B,GAAC,CAAC;IAClE,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B"}

package/package.json

@@ -1,12 +1,24 @@
 {
   "name": "axon-logger",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "A token-efficient logging framework using TOON (Token-Oriented Object Notation) format",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "node": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "browser": {
+    "./dist/file-manager/FileManager.js": "./dist/file-manager/BrowserFileManager.js",
     "./dist/extractor/LogExtractor.js": false,
-    "./dist/cli/axon-cli.js": false
+    "./dist/cli/axon-cli.js": false,
+    "fs": false,
+    "path": false
   },
   "scripts": {
     "build": "tsc",