@naylence/runtime 0.3.3 → 0.3.4

package/dist/browser/index.js

@@ -7920,6 +7920,24 @@
      *
      * This module provides a unified logging interface that works in both Node.js and browser environments.
      * It includes structured logging with processors similar to Python's structlog.
+     *
+     * Environment Variables:
+     * - FAME_LOG_LEVEL: Set the initial log level at framework initialization (Node.js only)
+     *   Valid values: TRACE, DEBUG, INFO, WARNING, WARN, ERROR, CRITICAL
+     *   Default: INFO (balanced verbosity), OFF during tests
+     *
+     * Usage:
+     * ```typescript
+     * // Automatic - just set the environment variable
+     * // FAME_LOG_LEVEL=INFO node my-app.js
+     *
+     * // Or call enableLogging() to override at runtime
+     * import { enableLogging, getLogger } from '@naylence/runtime';
+     * enableLogging('DEBUG');
+     *
+     * const logger = getLogger('my.app');
+     * logger.info('Application started');
+     * ```
      */
     // Default processors (similar to structlog processors)
     const addTimestamp = (entry) => {
@@ -8174,8 +8192,35 @@
     if (isNode) {
         initializePino();
     }
+    /**
+     * Get initial log level from environment variable or defaults
+     */
+    function getInitialLogLevel() {
+        // Tests should be silent
+        if (isTest) {
+            return exports.LogLevel.OFF;
+        }
+        // Check FAME_LOG_LEVEL environment variable
+        if (isNode && typeof process !== 'undefined' && process.env.FAME_LOG_LEVEL) {
+            try {
+                const envLevel = process.env.FAME_LOG_LEVEL.trim().toUpperCase();
+                // Direct enum name match (e.g., "DEBUG", "INFO")
+                if (envLevel in exports.LogLevel) {
+                    return exports.LogLevel[envLevel];
+                }
+                // Try alternative mappings
+                if (envLevel === 'WARN')
+                    return exports.LogLevel.WARNING;
+            }
+            catch {
+                // Fall through to default
+            }
+        }
+        // Default to INFO - balanced verbosity for most use cases
+        return exports.LogLevel.INFO;
+    }
     const defaultConfig = {
-        level: isTest ? exports.LogLevel.OFF : exports.LogLevel.TRACE, // Silent during tests
+        level: getInitialLogLevel(),
         processors: [
             addTimestamp,
             addEnvelopeFields,