hazo_logs 1.0.9 → 1.0.10

package/README.md

@@ -185,14 +185,32 @@ import { createLogApiHandler } from 'hazo_logs/ui/server';
 
 **Note**: The `hazo_logs/server` and `hazo_logs/ui/server` imports use the `server-only` package and will throw an error if accidentally imported in client bundles. This prevents Next.js build errors from Node.js APIs (`fs`, `async_hooks`) being bundled for the browser.
 
-**Next.js 16 Turbopack Compatibility**: As of v1.0.9, hazo_logs is fully compatible with Next.js 16 Turbopack. All server-only modules are lazy-loaded to prevent static analysis issues during bundling.
+**Next.js 16+ Turbopack Compatibility**: As of v1.0.10, hazo_logs uses **conditional exports** in `package.json` to automatically serve a client-safe bundle to browser environments. When bundlers (Next.js Turbopack, Webpack, etc.) resolve `hazo_logs`, they automatically receive:
+- **Browser/Client**: A lightweight console-only logger with zero Node.js dependencies
+- **Node.js/Server**: The full winston-based logger with file transports
+
+This eliminates "Can't resolve 'fs'" errors completely without requiring any special import paths for basic logging.
 
 ### Tailwind CSS Setup Required
 
-The log viewer UI uses dynamic Tailwind classes that would be purged during build. You **must** configure both:
+The log viewer UI uses dynamic Tailwind classes that would be purged during build.
+
+#### Tailwind v4 Setup
+
+Add the `@source` directive to your `globals.css` to enable Tailwind to scan hazo_logs classes:
+
+```css
+@import "tailwindcss";
+
+/* Required: Enable Tailwind to scan hazo_logs package classes */
+@source "../node_modules/hazo_logs/dist";
+```
+
+**Why this is needed:** Tailwind v4's JIT compiler doesn't scan `node_modules/` by default. Without this directive, hover states and interactive styles will be invisible.
+
+#### Tailwind v3 Setup
 
-1. **Content path**: So Tailwind scans the hazo_logs component files
-2. **Safelist**: To preserve dynamically-constructed classes
+Configure both the content path and safelist:
 
 ```typescript
 import { tailwindSafelist, tailwindContentPath } from 'hazo_logs/tailwind';
@@ -528,14 +546,15 @@ Error: Module not found: Can't resolve 'async_hooks'
 Error: Module not found: Can't resolve 'fs'
 ```
 
-This error occurred in earlier versions when server-only code was imported in client components. **As of v1.0.9, this is fixed** - the library now uses lazy loading for all server-only modules, making it fully compatible with Next.js 16 Turbopack.
+This error occurred in earlier versions when server-only code was imported in client components. **As of v1.0.10, this is fully fixed** - the library now uses **conditional exports** in `package.json`, so bundlers automatically receive a client-safe bundle with zero Node.js dependencies.
 
 If you still see this error:
 
-1. **Upgrade hazo_logs**: Run `npm update hazo_logs` to get the latest version
-2. **For logging in client components**: Use `createClientLogger` from `hazo_logs/ui`
-3. **For server-only modules**: Import from `hazo_logs/server` instead of `hazo_logs`
-4. **For universal code**: The base `hazo_logs` import works on both client and server (returns console logger on client)
+1. **Upgrade hazo_logs**: Run `npm update hazo_logs` to get v1.0.10 or later
+2. **Clear build cache**: Run `rm -rf .next` and rebuild
+3. **For logging in client components**: The base `hazo_logs` import now works automatically (returns console logger on client)
+4. **For client logging that posts to server**: Use `createClientLogger` from `hazo_logs/ui`
+5. **For full server capabilities**: Import from `hazo_logs/server` for file logging, sessions, and context
 
 ### hazo_ui missing errors
 

package/dist/client/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * hazo_logs/client - Client-safe logging module
+ *
+ * This module contains ONLY client-safe code with NO imports that could
+ * lead to Node.js modules (winston, fs, path, etc.).
+ *
+ * Used automatically when bundlers resolve 'hazo_logs' for browser targets.
+ */
+import type { Logger, LogData, LogLevel } from '../lib/types.js';
+/**
+ * Console-based logger for client-side use
+ * Provides basic logging that outputs to browser console
+ */
+export declare class ConsoleLogger implements Logger {
+    private packageName;
+    private minLevel;
+    constructor(packageName: string, minLevel?: LogLevel);
+    private shouldLog;
+    private formatMessage;
+    error(message: string, data?: LogData): void;
+    warn(message: string, data?: LogData): void;
+    info(message: string, data?: LogData): void;
+    debug(message: string, data?: LogData): void;
+}
+/**
+ * Create a client-side logger that outputs to browser console
+ *
+ * @param packageName - Name of the package (e.g., "hazo_auth", "my_app")
+ * @returns Logger instance that logs to console
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from 'hazo_logs';
+ *
+ * const logger = createLogger('my_app');
+ * logger.info('Application started');
+ * ```
+ *
+ * Note: For full server capabilities (file logging, context), use:
+ * ```typescript
+ * import { createLogger } from 'hazo_logs/server';
+ * ```
+ */
+export declare function createLogger(packageName: string): Logger;
+/**
+ * Async version - same as createLogger on client
+ * Provided for API compatibility with server version
+ */
+export declare function createLoggerAsync(packageName: string): Promise<Logger>;
+/**
+ * No-op on client - server preloading not applicable
+ */
+export declare function preloadServerLogger(): Promise<void>;
+export type { Logger, LogLevel, LogData, LogEntry, LogContext, HazoLogConfig, PackageLoggerOptions, LogSource, } from '../lib/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AASjE;;;GAGG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAW;gBAEf,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAkB;IAK7D,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAKrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAM3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;CAK7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzD;AAGD,YAAY,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,SAAS,GACV,MAAM,iBAAiB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,89 @@
+/**
+ * hazo_logs/client - Client-safe logging module
+ *
+ * This module contains ONLY client-safe code with NO imports that could
+ * lead to Node.js modules (winston, fs, path, etc.).
+ *
+ * Used automatically when bundlers resolve 'hazo_logs' for browser targets.
+ */
+const LOG_LEVEL_PRIORITY = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+};
+/**
+ * Console-based logger for client-side use
+ * Provides basic logging that outputs to browser console
+ */
+export class ConsoleLogger {
+    packageName;
+    minLevel;
+    constructor(packageName, minLevel = 'debug') {
+        this.packageName = packageName;
+        this.minLevel = minLevel;
+    }
+    shouldLog(level) {
+        return LOG_LEVEL_PRIORITY[level] <= LOG_LEVEL_PRIORITY[this.minLevel];
+    }
+    formatMessage(level, message) {
+        const timestamp = new Date().toISOString();
+        return `[${timestamp}] [${level.toUpperCase()}] [${this.packageName}] ${message}`;
+    }
+    error(message, data) {
+        if (this.shouldLog('error')) {
+            console.error(this.formatMessage('error', message), data ?? '');
+        }
+    }
+    warn(message, data) {
+        if (this.shouldLog('warn')) {
+            console.warn(this.formatMessage('warn', message), data ?? '');
+        }
+    }
+    info(message, data) {
+        if (this.shouldLog('info')) {
+            console.info(this.formatMessage('info', message), data ?? '');
+        }
+    }
+    debug(message, data) {
+        if (this.shouldLog('debug')) {
+            console.debug(this.formatMessage('debug', message), data ?? '');
+        }
+    }
+}
+/**
+ * Create a client-side logger that outputs to browser console
+ *
+ * @param packageName - Name of the package (e.g., "hazo_auth", "my_app")
+ * @returns Logger instance that logs to console
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from 'hazo_logs';
+ *
+ * const logger = createLogger('my_app');
+ * logger.info('Application started');
+ * ```
+ *
+ * Note: For full server capabilities (file logging, context), use:
+ * ```typescript
+ * import { createLogger } from 'hazo_logs/server';
+ * ```
+ */
+export function createLogger(packageName) {
+    return new ConsoleLogger(packageName);
+}
+/**
+ * Async version - same as createLogger on client
+ * Provided for API compatibility with server version
+ */
+export async function createLoggerAsync(packageName) {
+    return new ConsoleLogger(packageName);
+}
+/**
+ * No-op on client - server preloading not applicable
+ */
+export async function preloadServerLogger() {
+    // No-op on client
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,kBAAkB,GAA6B;IACnD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,aAAa;IAChB,WAAW,CAAS;IACpB,QAAQ,CAAW;IAE3B,YAAY,WAAmB,EAAE,WAAqB,OAAO;QAC3D,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe;QACpD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACzD,OAAO,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,kBAAkB;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_logs",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Logger for hazo packages - Winston wrapper with singleton pattern",
   "type": "module",
   "main": "dist/index.js",
@@ -8,14 +8,22 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "browser": "./dist/client/index.js",
+      "node": "./dist/index.js",
       "import": "./dist/index.js",
-      "require": "./dist/index.js"
+      "require": "./dist/index.js",
+      "default": "./dist/client/index.js"
     },
     "./server": {
       "types": "./dist/server.d.ts",
       "import": "./dist/server.js",
       "require": "./dist/server.js"
     },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js",
+      "require": "./dist/client/index.js"
+    },
     "./ui": {
       "types": "./dist/ui/index.d.ts",
       "import": "./dist/ui/index.js",