@intutic/logger 1.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Intutic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPORTED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @intutic/logger — Structured logging with trace context
+ *
+ * Provides a pino-based logger factory that outputs structured JSON to stdout.
+ * 12-factor app compliant — no file transports, stdout only.
+ *
+ * **MCP proxy exception:** When `PINO_DEST=stderr` is set in the environment,
+ * all log output is redirected to stderr (fd 2). This is required by processes
+ * that reserve stdout exclusively for JSON-RPC frames (e.g., MCP stdio servers).
+ *
+ * @example
+ * ```ts
+ * import { createLogger } from '@intutic/logger'
+ * const log = createLogger('circuit-breaker')
+ * log.info({ workspaceId: 'wk_abc123' }, 'Tool call evaluated')
+ * ```
+ *
+ * @module
+ */
+import type { Logger as PinoLogger } from 'pino';
+/** Structured logger interface — re-exported pino Logger */
+export type Logger = PinoLogger;
+/**
+ * Creates a named, structured logger instance.
+ *
+ * @param name - Component name (e.g., 'control-plane', 'circuit-breaker')
+ * @param bindings - Optional default key-value pairs attached to every log line
+ * @returns Configured pino logger
+ */
+export declare function createLogger(name: string, bindings?: Record<string, unknown>): Logger;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAGhD,4DAA4D;AAC5D,MAAM,MAAM,MAAM,GAAG,UAAU,CAAA;AA0C/B;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAKR"}

package/dist/index.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * @intutic/logger — Structured logging with trace context
+ *
+ * Provides a pino-based logger factory that outputs structured JSON to stdout.
+ * 12-factor app compliant — no file transports, stdout only.
+ *
+ * **MCP proxy exception:** When `PINO_DEST=stderr` is set in the environment,
+ * all log output is redirected to stderr (fd 2). This is required by processes
+ * that reserve stdout exclusively for JSON-RPC frames (e.g., MCP stdio servers).
+ *
+ * @example
+ * ```ts
+ * import { createLogger } from '@intutic/logger'
+ * const log = createLogger('circuit-breaker')
+ * log.info({ workspaceId: 'wk_abc123' }, 'Tool call evaluated')
+ * ```
+ *
+ * @module
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const pino_1 = __importDefault(require("pino"));
+const api_1 = require("@opentelemetry/api");
+/**
+ * Resolve the pino destination stream.
+ * - Default: process.stdout (fd 1) — normal 12-factor behaviour.
+ * - PINO_DEST=stderr: process.stderr (fd 2) — used by MCP proxy to avoid
+ *   polluting the JSON-RPC channel on stdout.
+ */
+function resolveDestination() {
+    if (process.env['PINO_DEST'] === 'stderr') {
+        return pino_1.default.destination({ fd: 2, sync: true });
+    }
+    return undefined; // pino default → stdout
+}
+/** Base configuration for all loggers */
+const BASE_CONFIG = {
+    level: process.env.LOG_LEVEL ?? 'info',
+    formatters: {
+        level: (label) => ({ level: label }),
+    },
+    timestamp: pino_1.default.stdTimeFunctions.isoTime,
+    mixin() {
+        try {
+            const activeSpan = api_1.trace.getActiveSpan();
+            if (activeSpan) {
+                const spanContext = activeSpan.spanContext();
+                return {
+                    trace_id: spanContext.traceId,
+                    span_id: spanContext.spanId,
+                };
+            }
+        }
+        catch {
+            // Safe fallback if OpenTelemetry is not initialized
+        }
+        return {};
+    },
+};
+/** Resolved destination (evaluated once at module load, before any logger is created) */
+const DEST = resolveDestination();
+/**
+ * Creates a named, structured logger instance.
+ *
+ * @param name - Component name (e.g., 'control-plane', 'circuit-breaker')
+ * @param bindings - Optional default key-value pairs attached to every log line
+ * @returns Configured pino logger
+ */
+function createLogger(name, bindings) {
+    const logger = DEST
+        ? (0, pino_1.default)({ ...BASE_CONFIG, name }, DEST)
+        : (0, pino_1.default)({ ...BASE_CONFIG, name });
+    return bindings ? logger.child(bindings) : logger;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;AAwDH,oCAQC;AA9DD,gDAAuB;AAEvB,4CAA0C;AAK1C;;;;;GAKG;AACH,SAAS,kBAAkB;IACzB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,cAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,SAAS,CAAA,CAAC,wBAAwB;AAC3C,CAAC;AAED,yCAAyC;AACzC,MAAM,WAAW,GAAuB;IACtC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,UAAU,EAAE;QACV,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;KAC7C;IACD,SAAS,EAAE,cAAI,CAAC,gBAAgB,CAAC,OAAO;IACxC,KAAK;QACH,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,WAAK,CAAC,aAAa,EAAE,CAAA;YACxC,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,CAAA;gBAC5C,OAAO;oBACL,QAAQ,EAAE,WAAW,CAAC,OAAO;oBAC7B,OAAO,EAAE,WAAW,CAAC,MAAM;iBAC5B,CAAA;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;CACF,CAAA;AAED,yFAAyF;AACzF,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAA;AAEjC;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,IAAY,EACZ,QAAkC;IAElC,MAAM,MAAM,GAAG,IAAI;QACjB,CAAC,CAAC,IAAA,cAAI,EAAC,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC;QACtC,CAAC,CAAC,IAAA,cAAI,EAAC,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;IAClC,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AACnD,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@intutic/logger",
+  "version": "1.6.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/intutic/intutic",
+    "directory": "packages/logger"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "./dist"
+  ],
+  "dependencies": {
+    "pino": "^9.0.0",
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5",
+    "vitest": "^3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
+}