@outfitter/logging 0.2.0 → 0.3.0

package/README.md

@@ -304,6 +304,34 @@ await flush();
 process.exit(0);
 ```
 
+## Environment-Aware Log Level
+
+### `resolveLogLevel(level?)`
+
+Resolve the log level from environment configuration. Use this instead of hardcoding levels so your app responds to `OUTFITTER_ENV` and `OUTFITTER_LOG_LEVEL` automatically.
+
+**Precedence** (highest wins):
+1. `OUTFITTER_LOG_LEVEL` environment variable
+2. Explicit `level` parameter
+3. `OUTFITTER_ENV` profile defaults (`"debug"` in development)
+4. `"info"` (default)
+
+```typescript
+import { createLogger, resolveLogLevel } from "@outfitter/logging";
+
+const logger = createLogger({
+  name: "my-app",
+  level: resolveLogLevel(),
+  sinks: [createConsoleSink()],
+});
+
+// With OUTFITTER_ENV=development → "debug"
+// With OUTFITTER_LOG_LEVEL=error → "error" (overrides everything)
+// With nothing set → "info"
+```
+
+MCP-style level names are mapped automatically: `warning` to `warn`, `emergency`/`critical`/`alert` to `fatal`, `notice` to `info`.
+
 ## API Reference
 
 ### Functions
@@ -312,6 +340,7 @@ process.exit(0);
 | ----------------------- | --------------------------------------------------- |
 | `createLogger`          | Create a configured logger instance                 |
 | `createChildLogger`     | Create a child logger with merged context           |
+| `resolveLogLevel`       | Resolve log level from env vars and profile         |
 | `configureRedaction`    | Configure global redaction patterns and keys        |
 | `flush`                 | Flush all pending log writes across all sinks       |
 | `createJsonFormatter`   | Create a JSON formatter for structured output       |

package/dist/index.d.ts

@@ -1,12 +1,4 @@
 /**
-* @outfitter/logging
-*
-* Structured logging via logtape with automatic sensitive data redaction.
-* Provides consistent log formatting across CLI, MCP, and server contexts.
-*
-* @packageDocumentation
-*/
-/**
 * Log levels supported by the logger, ordered from lowest to highest severity.
 *
 * Level priority (lowest to highest): trace (0) < debug (1) < info (2) < warn (3) < error (4) < fatal (5)
@@ -549,4 +541,32 @@ declare function configureRedaction(config: GlobalRedactionConfig): void;
 * ```
 */
 declare function flush(): Promise<void>;
-export { flush, createPrettyFormatter, createLogger, createJsonFormatter, createFileSink, createConsoleSink, createChildLogger, configureRedaction, Sink, RedactionConfig, PrettyFormatterOptions, LoggerInstance, LoggerConfig, LogRecord, LogLevel, GlobalRedactionConfig, Formatter, FileSinkOptions, DEFAULT_PATTERNS, ConsoleSinkOptions };
+/**
+* Resolve the log level from environment configuration.
+*
+* Precedence (highest wins):
+* 1. `OUTFITTER_LOG_LEVEL` environment variable
+* 2. Explicit `level` parameter
+* 3. `OUTFITTER_ENV` environment profile defaults
+* 4. `"info"` (default)
+*
+* @param level - Optional explicit log level (overridden by env var)
+* @returns Resolved LogLevel
+*
+* @example
+* ```typescript
+* import { createLogger, resolveLogLevel } from "@outfitter/logging";
+*
+* // Auto-resolve from environment
+* const logger = createLogger({
+*   name: "my-app",
+*   level: resolveLogLevel(),
+* });
+*
+* // With OUTFITTER_ENV=development → "debug"
+* // With OUTFITTER_LOG_LEVEL=error → "error" (overrides everything)
+* // With nothing set → "info"
+* ```
+*/
+declare function resolveLogLevel(level?: LogLevel): LogLevel;
+export { resolveLogLevel, flush, createPrettyFormatter, createLogger, createJsonFormatter, createFileSink, createConsoleSink, createChildLogger, configureRedaction, Sink, RedactionConfig, PrettyFormatterOptions, LoggerInstance, LoggerConfig, LogRecord, LogLevel, GlobalRedactionConfig, Formatter, FileSinkOptions, DEFAULT_PATTERNS, ConsoleSinkOptions };

package/dist/index.js

@@ -1,4 +1,8 @@
 // src/index.ts
+import {
+  getEnvironment as _getEnvironment,
+  getEnvironmentDefaults as _getEnvironmentDefaults
+} from "@outfitter/config";
 var LEVEL_PRIORITY = {
   trace: 0,
   debug: 1,
@@ -387,7 +391,43 @@ async function flush() {
   }
   await Promise.all(flushPromises);
 }
+var ENV_LEVEL_MAP = {
+  trace: "trace",
+  debug: "debug",
+  info: "info",
+  notice: "info",
+  warn: "warn",
+  warning: "warn",
+  error: "error",
+  critical: "fatal",
+  alert: "fatal",
+  emergency: "fatal",
+  fatal: "fatal",
+  silent: "silent"
+};
+function resolveLogLevel(level) {
+  const envLogLevel = process.env["OUTFITTER_LOG_LEVEL"];
+  if (envLogLevel !== undefined) {
+    const mapped = ENV_LEVEL_MAP[envLogLevel];
+    if (mapped !== undefined) {
+      return mapped;
+    }
+  }
+  if (level !== undefined) {
+    return level;
+  }
+  const env = _getEnvironment();
+  const defaults = _getEnvironmentDefaults(env);
+  if (defaults.logLevel !== null) {
+    const mapped = ENV_LEVEL_MAP[defaults.logLevel];
+    if (mapped !== undefined) {
+      return mapped;
+    }
+  }
+  return "info";
+}
 export {
+  resolveLogLevel,
   flush,
   createPrettyFormatter,
   createLogger,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outfitter/logging",
   "description": "Structured logging via logtape with redaction support for Outfitter",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "files": [
     "dist"
@@ -27,6 +27,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
+    "@outfitter/config": "0.3.0",
     "@outfitter/contracts": "0.2.0",
     "@logtape/logtape": "^2.0.0"
   },