@likec4/log 1.36.1 → 1.38.0

package/dist/index.d.mts

@@ -7,6 +7,11 @@ declare function getMessageOnlyFormatter(): TextFormatter;
 declare function getTextFormatter(options?: TextFormatterOptions): TextFormatter;
 declare function getAnsiColorFormatter(options?: AnsiColorFormatterOptions): TextFormatter;
 declare function getConsoleSink(options?: ConsoleSinkOptions): Sink;
+/**
+ * Creates a console sink that writes to stderr.
+ * (MCP protocol requires stderr to be used for logging)
+ */
+declare function getConsoleStderrSink(options?: ConsoleSinkOptions): Sink;
 
 declare function loggable(error: unknown): string;
 
@@ -18,6 +23,6 @@ declare const logger: _logtape_logtape.Logger;
  * @returns The child logger.
  */
 declare function createLogger(subcategory: string | readonly [string] | readonly [string, ...string[]]): _logtape_logtape.Logger;
-declare function configureLogger<TSinkId extends string, TFilterId extends string>(config?: Config<TSinkId, TFilterId>): void;
+declare function configureLogger<TSinkId extends string, TFilterId extends string>(config?: Partial<Config<TSinkId, TFilterId>>): void;
 
-export { configureLogger, logger as consola, createLogger, errorFromLogRecord, getAnsiColorFormatter, getConsoleSink, getMessageOnlyFormatter, getTextFormatter, loggable, logger, logger as rootLogger };
+export { configureLogger, logger as consola, createLogger, errorFromLogRecord, getAnsiColorFormatter, getConsoleSink, getConsoleStderrSink, getMessageOnlyFormatter, getTextFormatter, loggable, logger, logger as rootLogger };

package/dist/index.mjs

@@ -1402,6 +1402,18 @@ function getConsoleSink(options) {
     ...options
   });
 }
+function getConsoleStderrSink(options) {
+  const formatter = options?.formatter ?? getTextFormatter();
+  return (record) => {
+    const args = formatter(record);
+    if (typeof args === "string") {
+      const msg = args.replace(/\r?\n$/, "");
+      console.error(msg);
+    } else {
+      console.error(...args);
+    }
+  };
+}
 
 const logger = getLogger("likec4");
 function createLogger(subcategory) {
@@ -1413,11 +1425,11 @@ function configureLogger(config) {
     configureWasCalled = true;
     const sinks = config?.sinks ?? {};
     configureSync({
+      reset: true,
       ...config,
       sinks: {
-        ...sinks,
-        // @ts-expect-error console is not a valid sink id
-        console: sinks["console"] ?? getConsoleSink()
+        console: getConsoleSink(),
+        ...sinks
       },
       loggers: [
         { category: ["logtape", "meta"], sinks: ["console"], lowestLevel: "warning" },
@@ -1435,4 +1447,4 @@ function configureLogger(config) {
   }
 }
 
-export { configureLogger, logger as consola, createLogger, errorFromLogRecord, getAnsiColorFormatter, getConsoleSink, getMessageOnlyFormatter, getTextFormatter, loggable, logger, logger as rootLogger };
+export { configureLogger, logger as consola, createLogger, errorFromLogRecord, getAnsiColorFormatter, getConsoleSink, getConsoleStderrSink, getMessageOnlyFormatter, getTextFormatter, loggable, logger, logger as rootLogger };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@likec4/log",
   "description": "Shared interface for logging",
   "license": "MIT",
-  "version": "1.36.1",
+  "version": "1.38.0",
   "bugs": "https://github.com/likec4/likec4/issues",
   "homepage": "https://likec4.dev",
   "author": "Denis Davydkov <denis@davydkov.com>",
@@ -42,7 +42,7 @@
     "typescript": "5.9.2",
     "unbuild": "3.5.0",
     "wrap-error-message": "^3.0.1",
-    "@likec4/tsconfig": "1.36.1"
+    "@likec4/tsconfig": "1.38.0"
   },
   "scripts": {
     "typecheck": "tsc -b --verbose",

package/src/formatters.ts

@@ -129,3 +129,20 @@ export function getConsoleSink(options?: ConsoleSinkOptions): Sink {
     ...options,
   })
 }
+
+/**
+ * Creates a console sink that writes to stderr.
+ * (MCP protocol requires stderr to be used for logging)
+ */
+export function getConsoleStderrSink(options?: ConsoleSinkOptions): Sink {
+  const formatter = options?.formatter ?? getTextFormatter()
+  return (record: LogRecord) => {
+    const args = formatter(record)
+    if (typeof args === 'string') {
+      const msg = args.replace(/\r?\n$/, '')
+      console.error(msg)
+    } else {
+      console.error(...args)
+    }
+  }
+}

package/src/index.ts

@@ -20,6 +20,7 @@ export {
   // formatRecord,
   getAnsiColorFormatter,
   getConsoleSink,
+  getConsoleStderrSink,
   getMessageOnlyFormatter,
   getTextFormatter,
 } from './formatters'
@@ -52,24 +53,24 @@ export function createLogger(subcategory: string | readonly [string] | readonly
 let configureWasCalled = false
 
 export function configureLogger<TSinkId extends string, TFilterId extends string>(
-  config?: Config<TSinkId, TFilterId>,
+  config?: Partial<Config<TSinkId, TFilterId>>,
 ) {
   try {
     configureWasCalled = true
     const sinks = config?.sinks ?? {}
     configureLogtape<any, any>({
+      reset: true,
       ...config,
       sinks: {
+        console: getConsoleSink(),
         ...sinks,
-        // @ts-expect-error console is not a valid sink id
-        console: sinks['console'] ?? getConsoleSink(),
       },
       loggers: [
-        { category: ['logtape', 'meta'], sinks: ['console' as any], lowestLevel: 'warning' },
+        { category: ['logtape', 'meta'], sinks: ['console'], lowestLevel: 'warning' },
         ...(config?.loggers ?? [
           {
             category: 'likec4',
-            sinks: ['console' as any],
+            sinks: ['console'],
             lowestLevel: 'debug',
           },
         ]),