@camstack/core 0.1.15 → 0.1.16

package/dist/builtins/winston-logging/index.js

@@ -1,305 +1,158 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/builtins/winston-logging/index.ts
-var winston_logging_exports = {};
-__export(winston_logging_exports, {
-  WinstonDestination: () => WinstonDestination,
-  WinstonLoggingAddon: () => WinstonLoggingAddon,
-  default: () => WinstonLoggingAddon
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
 });
-module.exports = __toCommonJS(winston_logging_exports);
-
-// src/builtins/winston-logging/winston-logging.addon.ts
-var import_types = require("@camstack/types");
-
-// src/builtins/winston-logging/winston-destination.ts
-var winston = __toESM(require("winston"));
-var import_winston_daily_rotate_file = __toESM(require("winston-daily-rotate-file"));
-var path = __toESM(require("path"));
-
-// src/logging/formatter.ts
-var USE_COLOR = (() => {
-  try {
-    if (typeof process === "undefined") return false;
-    const env = process.env ?? {};
-    if (env["NO_COLOR"]) return false;
-    const force = env["FORCE_COLOR"];
-    if (force !== void 0) return force !== "" && force !== "0" && force !== "false";
-    return Boolean(process.stdout?.isTTY);
-  } catch {
-    return false;
-  }
-})();
-var NO_COLOR = (() => {
-  try {
-    return Boolean(process?.env?.["NO_COLOR"]);
-  } catch {
-    return false;
-  }
-})();
-var RESET = "\x1B[0m";
-var ANSI = {
-  green: "\x1B[32m",
-  yellow: "\x1B[33m",
-  red: "\x1B[31m",
-  cyan: "\x1B[36m",
-  gray: "\x1B[90m"
-};
-var COLOR_BY_LEVEL = {
-  debug: ANSI.gray,
-  info: ANSI.green,
-  warn: ANSI.yellow,
-  error: ANSI.red
-};
-function paint(color, text, enabled) {
-  return enabled ? `${color}${text}${RESET}` : text;
-}
-function colorizeLevel(level, text, enabled) {
-  if (!enabled) return text;
-  const code = COLOR_BY_LEVEL[level];
-  return code ? `${code}${text}${RESET}` : text;
-}
-function padRight(value, width) {
-  if (value.length >= width) return value.slice(0, width);
-  return value + " ".repeat(width - value.length);
-}
-function resolveAgent(tags) {
-  const agentId = tags?.agentId;
-  if (typeof agentId === "string" && agentId.length > 0) return agentId;
-  const nodeId = tags?.nodeId;
-  if (typeof nodeId === "string" && nodeId.length > 0) {
-    return nodeId.includes("/") ? nodeId.split("/")[0] : nodeId;
-  }
-  return null;
-}
-function resolveAddon(entry) {
-  const addonId = entry.tags?.addonId;
-  if (typeof addonId === "string" && addonId.length > 0) return addonId;
-  return "system";
-}
-function resolveDevice(tags) {
-  const name = tags?.deviceName;
-  if (typeof name === "string" && name.length > 0) return name;
-  const id = tags?.deviceId;
-  if (typeof id === "number" && Number.isFinite(id)) return `#${id}`;
-  return null;
-}
-function buildBrand(entry) {
-  const agent = resolveAgent(entry.tags) ?? "?";
-  const addon = resolveAddon(entry);
-  return `${agent}/${addon}`;
-}
-function buildDeviceContext(entry) {
-  return resolveDevice(entry.tags);
-}
-function formatTimestamp(value) {
-  const date = value instanceof Date ? value : new Date(typeof value === "string" ? value : Date.now());
-  return date.toLocaleString("en-US", {
-    month: "numeric",
-    day: "numeric",
-    year: "numeric",
-    hour: "numeric",
-    minute: "2-digit",
-    second: "2-digit",
-    hour12: true
-  });
-}
-function formatMeta(meta) {
-  if (!meta) return "";
-  const keys = Object.keys(meta);
-  if (keys.length === 0) return "";
-  const parts = [];
-  for (const key of keys) {
-    const value = meta[key];
-    parts.push(`${key}=${formatMetaValue(value)}`);
-  }
-  return `{${parts.join(" ")}}`;
-}
-function formatMetaValue(value) {
-  if (value === null) return "null";
-  if (value === void 0) return "undefined";
-  if (typeof value === "string") {
-    return /\s|"/.test(value) ? JSON.stringify(value) : value;
-  }
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  if (value instanceof Error) return JSON.stringify(value.message);
-  try {
-    return JSON.stringify(value);
-  } catch {
-    return String(value);
-  }
-}
-var PID = typeof process !== "undefined" && typeof process.pid === "number" ? String(process.pid) : "?";
-function formatLogLine(entry, options) {
-  const wantsColor = options?.colorize ?? USE_COLOR;
-  const colorize = wantsColor && !NO_COLOR;
-  const levelColor = COLOR_BY_LEVEL[entry.level];
-  const brand = paint(ANSI.green, `[${buildBrand(entry)}]`, colorize);
-  const entryPid = entry.tags?.pid;
-  const pid = typeof entryPid === "number" ? String(entryPid) : PID;
-  const timestamp = formatTimestamp(entry.timestamp);
-  const level = colorizeLevel(entry.level, padRight(entry.level.toUpperCase(), 5), colorize);
-  const device = buildDeviceContext(entry);
-  const ctxPart = device ? " " + paint(ANSI.yellow, `[${device}]`, colorize) : "";
-  const scope = typeof entry.scope === "string" && entry.scope.length > 0 ? entry.scope : null;
-  const scopePart = scope ? " " + paint(ANSI.cyan, `(${scope})`, colorize) : "";
-  const metaText = formatMeta(entry.meta);
-  const metaPart = metaText ? " " + paint(ANSI.gray, metaText, colorize) : "";
-  const message = colorize && levelColor ? `${levelColor}${entry.message}${RESET}` : entry.message;
-  return `${brand} ${pid}  - ${timestamp}     ${level}${ctxPart}${scopePart} ${message}${metaPart}`;
-}
-
-// src/builtins/winston-logging/winston-destination.ts
+const require_chunk = require("../../chunk-C13QxCFV.js");
+const require_formatter = require("../../formatter-Dr_6NNZc.js");
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path);
+let _camstack_types = require("@camstack/types");
+let winston = require("winston");
+winston = require_chunk.__toESM(winston);
+let winston_daily_rotate_file = require("winston-daily-rotate-file");
+winston_daily_rotate_file = require_chunk.__toESM(winston_daily_rotate_file);
+//#region src/builtins/winston-logging/winston-destination.ts
+/**
+* Rotated-file log destination. Console output goes through the shared
+* `formatLogLine` so every console sink (Winston, ConsoleDestination,
+* HubForwarderDestination) emits identical lines. File output keeps a
+* structured JSON shape so log tooling can query tags/meta.
+*/
 var WinstonDestination = class {
-  logger = null;
-  async initialize(config) {
-    const {
-      level = "info",
-      retentionDays = 30,
-      logsDir = path.join("camstack-data", "logs")
-    } = config ?? {};
-    const consoleFormat = winston.format.printf((info) => {
-      const rendered = info._rendered;
-      return typeof rendered === "string" ? rendered : String(info.message);
-    });
-    const stripRendered = winston.format((info) => {
-      delete info["_rendered"];
-      return info;
-    });
-    const fileFormat = winston.format.combine(
-      winston.format.timestamp(),
-      stripRendered(),
-      winston.format.json()
-    );
-    void consoleFormat;
-    this.logger = winston.createLogger({
-      level,
-      transports: [
-        new import_winston_daily_rotate_file.default({
-          dirname: logsDir,
-          filename: "camstack-%DATE%.log",
-          datePattern: "YYYY-MM-DD",
-          maxFiles: `${retentionDays}d`,
-          format: fileFormat
-        })
-      ]
-    });
-  }
-  write(entry) {
-    if (!this.logger) return;
-    const ts = entry.timestamp instanceof Date ? entry.timestamp.toISOString() : String(entry.timestamp);
-    const rendered = formatLogLine(entry, { colorize: true });
-    this.logger.log({
-      level: entry.level,
-      message: entry.message,
-      _rendered: rendered,
-      timestamp: ts,
-      scope: entry.scope,
-      ...entry.tags ? { tags: entry.tags } : {},
-      ...entry.meta ? { meta: entry.meta } : {}
-    });
-  }
-  async query(_filter) {
-    return [];
-  }
-  async shutdown() {
-    if (!this.logger) return;
-    await new Promise((resolve) => {
-      this.logger.on("finish", resolve);
-      this.logger.end();
-    });
-    this.logger = null;
-  }
+	logger = null;
+	async initialize(config) {
+		const { level = "info", retentionDays = 30, logsDir = node_path.join("camstack-data", "logs") } = config ?? {};
+		winston.format.printf((info) => {
+			const rendered = info._rendered;
+			return typeof rendered === "string" ? rendered : String(info.message);
+		});
+		const stripRendered = winston.format((info) => {
+			delete info["_rendered"];
+			return info;
+		});
+		const fileFormat = winston.format.combine(winston.format.timestamp(), stripRendered(), winston.format.json());
+		this.logger = winston.createLogger({
+			level,
+			transports: [new winston_daily_rotate_file.default({
+				dirname: logsDir,
+				filename: "camstack-%DATE%.log",
+				datePattern: "YYYY-MM-DD",
+				maxFiles: `${retentionDays}d`,
+				format: fileFormat
+			})]
+		});
+	}
+	write(entry) {
+		if (!this.logger) return;
+		const ts = entry.timestamp instanceof Date ? entry.timestamp.toISOString() : String(entry.timestamp);
+		const rendered = require_formatter.formatLogLine(entry, { colorize: true });
+		this.logger.log({
+			level: entry.level,
+			message: entry.message,
+			_rendered: rendered,
+			timestamp: ts,
+			scope: entry.scope,
+			...entry.tags ? { tags: entry.tags } : {},
+			...entry.meta ? { meta: entry.meta } : {}
+		});
+	}
+	async query(_filter) {
+		return [];
+	}
+	async shutdown() {
+		if (!this.logger) return;
+		await new Promise((resolve) => {
+			this.logger.on("finish", resolve);
+			this.logger.end();
+		});
+		this.logger = null;
+	}
 };
-
-// src/builtins/winston-logging/winston-logging.addon.ts
-var WinstonLoggingAddon = class extends import_types.BaseAddon {
-  destination = null;
-  constructor() {
-    super({ level: "info", retentionDays: 30 });
-  }
-  async onInitialize() {
-    const logsDir = await this.ctx.api.storage.resolve.query({ location: "logs", relativePath: "" }).catch(() => "camstack-data/logs");
-    this.destination = new WinstonDestination();
-    await this.destination.initialize({ ...this.config, logsDir });
-    this.ctx.logger.info("Winston logging initialized");
-    return [{ capability: import_types.logDestinationCapability, provider: this.destination }];
-  }
-  async onShutdown() {
-    await this.destination?.shutdown();
-  }
-  getDestination() {
-    if (!this.destination) throw new Error("Winston not initialized");
-    return this.destination;
-  }
-  globalSettingsSchema() {
-    return this.schema({
-      sections: [
-        {
-          id: "winston-logging",
-          title: "Logging",
-          description: "Global log verbosity + retention for rotated log files on this node.",
-          columns: 2,
-          fields: [
-            this.field({
-              type: "select",
-              key: "level",
-              label: "Log Level",
-              default: "info",
-              options: [
-                { value: "debug", label: "Debug" },
-                { value: "info", label: "Info" },
-                { value: "warn", label: "Warn" },
-                { value: "error", label: "Error" }
-              ]
-            }),
-            this.field({
-              type: "number",
-              key: "retentionDays",
-              label: "Retention (days)",
-              description: "Number of days to keep rotated log files before deletion",
-              min: 1,
-              max: 365,
-              step: 1,
-              default: 30,
-              unit: "days"
-            })
-          ]
-        }
-      ]
-    });
-  }
+//#endregion
+//#region src/builtins/winston-logging/winston-logging.addon.ts
+/**
+* Winston logging addon — rotated log files + console output.
+* Settings appear under Cluster → NodeDetail → Settings.
+*/
+var WinstonLoggingAddon = class extends _camstack_types.BaseAddon {
+	destination = null;
+	constructor() {
+		super({
+			level: "info",
+			retentionDays: 30
+		});
+	}
+	async onInitialize() {
+		const logsDir = await this.ctx.api.storage.resolve.query({
+			location: "logs",
+			relativePath: ""
+		}).catch(() => "camstack-data/logs");
+		this.destination = new WinstonDestination();
+		await this.destination.initialize({
+			...this.config,
+			logsDir
+		});
+		this.ctx.logger.info("Winston logging initialized");
+		return [{
+			capability: _camstack_types.logDestinationCapability,
+			provider: this.destination
+		}];
+	}
+	async onShutdown() {
+		await this.destination?.shutdown();
+	}
+	getDestination() {
+		if (!this.destination) throw new Error("Winston not initialized");
+		return this.destination;
+	}
+	globalSettingsSchema() {
+		return this.schema({ sections: [{
+			id: "winston-logging",
+			title: "Logging",
+			description: "Global log verbosity + retention for rotated log files on this node.",
+			columns: 2,
+			fields: [this.field({
+				type: "select",
+				key: "level",
+				label: "Log Level",
+				default: "info",
+				options: [
+					{
+						value: "debug",
+						label: "Debug"
+					},
+					{
+						value: "info",
+						label: "Info"
+					},
+					{
+						value: "warn",
+						label: "Warn"
+					},
+					{
+						value: "error",
+						label: "Error"
+					}
+				]
+			}), this.field({
+				type: "number",
+				key: "retentionDays",
+				label: "Retention (days)",
+				description: "Number of days to keep rotated log files before deletion",
+				min: 1,
+				max: 365,
+				step: 1,
+				default: 30,
+				unit: "days"
+			})]
+		}] });
+	}
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  WinstonDestination,
-  WinstonLoggingAddon
-});
+//#endregion
+exports.WinstonDestination = WinstonDestination;
+exports.WinstonDestination$1 = WinstonDestination;
+exports.WinstonLoggingAddon = WinstonLoggingAddon;
+exports.WinstonLoggingAddon$1 = WinstonLoggingAddon;
+exports.default = WinstonLoggingAddon;
+
 //# sourceMappingURL=index.js.map

package/dist/builtins/winston-logging/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/builtins/winston-logging/index.ts","../../../src/builtins/winston-logging/winston-logging.addon.ts","../../../src/builtins/winston-logging/winston-destination.ts","../../../src/logging/formatter.ts"],"sourcesContent":["export { WinstonLoggingAddon } from './winston-logging.addon.js'\nexport { WinstonDestination } from './winston-destination.js'\nexport { WinstonLoggingAddon as default } from './winston-logging.addon.js'\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { WinstonDestination } from './winston-destination.js'\n\ninterface WinstonConfig {\n  readonly level: string\n  readonly retentionDays: number\n}\n\n/**\n * Winston logging addon — rotated log files + console output.\n * Settings appear under Cluster → NodeDetail → Settings.\n */\nexport class WinstonLoggingAddon extends BaseAddon<WinstonConfig> {\n  private destination: WinstonDestination | null = null\n\n  constructor() {\n    super({ level: 'info', retentionDays: 30 })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const logsDir = await this.ctx.api.storage.resolve.query({ location: 'logs', relativePath: '' })\n      .catch(() => 'camstack-data/logs')\n    this.destination = new WinstonDestination()\n    await this.destination.initialize({ ...this.config, logsDir })\n    this.ctx.logger.info('Winston logging initialized')\n    return [{ capability: logDestinationCapability, provider: this.destination }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    await this.destination?.shutdown()\n  }\n\n  getDestination(): WinstonDestination {\n    if (!this.destination) throw new Error('Winston not initialized')\n    return this.destination\n  }\n\n  protected globalSettingsSchema() {\n    return this.schema({\n      sections: [\n        {\n          id: 'winston-logging',\n          title: 'Logging',\n          description: 'Global log verbosity + retention for rotated log files on this node.',\n          columns: 2,\n          fields: [\n            this.field({\n              type: 'select',\n              key: 'level',\n              label: 'Log Level',\n              default: 'info',\n              options: [\n                { value: 'debug', label: 'Debug' },\n                { value: 'info', label: 'Info' },\n                { value: 'warn', label: 'Warn' },\n                { value: 'error', label: 'Error' },\n              ],\n            }),\n            this.field({\n              type: 'number',\n              key: 'retentionDays',\n              label: 'Retention (days)',\n              description: 'Number of days to keep rotated log files before deletion',\n              min: 1,\n              max: 365,\n              step: 1,\n              default: 30,\n              unit: 'days',\n            }),\n          ],\n        },\n      ],\n    })\n  }\n}\n","import * as winston from 'winston'\nimport DailyRotateFile from 'winston-daily-rotate-file'\nimport * as path from 'node:path'\nimport type { ILogDestination, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\ninterface WinstonConfig {\n  readonly level: string\n  readonly retentionDays: number\n  /** Resolved absolute path to the logs directory (replaces the old dataPath field). */\n  readonly logsDir: string\n}\n\n/**\n * Rotated-file log destination. Console output goes through the shared\n * `formatLogLine` so every console sink (Winston, ConsoleDestination,\n * HubForwarderDestination) emits identical lines. File output keeps a\n * structured JSON shape so log tooling can query tags/meta.\n */\nexport class WinstonDestination implements ILogDestination {\n  private logger: winston.Logger | null = null\n\n  async initialize(config?: WinstonConfig): Promise<void> {\n    const {\n      level = 'info',\n      retentionDays = 30,\n      logsDir = path.join('camstack-data', 'logs'),\n    } = config ?? {}\n\n    // Console: canonical single-line formatter — `_rendered` already\n    // carries level-based ANSI colour codes (see `formatLogLine` in\n    // `@camstack/core/logging/formatter.ts`). Using Winston's colorize\n    // here would just decorate unused `info.level` and leave the\n    // rendered line uncoloured.\n    const consoleFormat = winston.format.printf((info) => {\n      const rendered = (info as unknown as { _rendered?: string })._rendered\n      return typeof rendered === 'string' ? rendered : String(info.message)\n    })\n\n    // File: structured JSON. Strip `_rendered` first — it carries ANSI\n    // escape codes intended for the terminal and has no place in a\n    // rotated-file store used for ops queries.\n    const stripRendered = winston.format((info) => {\n      delete (info as Record<string, unknown>)['_rendered']\n      return info\n    })\n    const fileFormat = winston.format.combine(\n      winston.format.timestamp(),\n      stripRendered(),\n      winston.format.json(),\n    )\n\n    // File-only winston. Stdout is owned by `ConsoleDestination`\n    // (the `console-logging` builtin addon) — adding a Winston console\n    // transport here would re-render every log line a second time on\n    // the hub terminal, which is the historic cause of the duplicate\n    // output operators have been seeing. The `consoleFormat` printf\n    // above stays wired in so a future opt-in transport can use it\n    // without re-deriving the layout.\n    void consoleFormat\n    this.logger = winston.createLogger({\n      level,\n      transports: [\n        new DailyRotateFile({\n          dirname: logsDir,\n          filename: 'camstack-%DATE%.log',\n          datePattern: 'YYYY-MM-DD',\n          maxFiles: `${retentionDays}d`,\n          format: fileFormat,\n        }),\n      ],\n    })\n  }\n\n  write(entry: LogEntry): void {\n    if (!this.logger) return\n\n    // Moleculer JSON serialization converts Date → string; normalize back\n    const ts = entry.timestamp instanceof Date\n      ? entry.timestamp.toISOString()\n      : String(entry.timestamp)\n    // Render once with colours for the console transport; file transport\n    // strips `_rendered` via the format chain above so disk stays plain.\n    const rendered = formatLogLine(entry, { colorize: true })\n\n    this.logger.log({\n      level: entry.level,\n      message: entry.message,\n      _rendered: rendered,\n      timestamp: ts,\n      scope: entry.scope,\n      ...(entry.tags ? { tags: entry.tags } : {}),\n      ...(entry.meta ? { meta: entry.meta } : {}),\n    })\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // File-based log querying is not implemented; use structured storage for log queries\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.logger) return\n\n    await new Promise<void>((resolve) => {\n      this.logger!.on('finish', resolve)\n      this.logger!.end()\n    })\n    this.logger = null\n  }\n}\n","/**\n * Canonical single-line formatter for every `LogEntry` that reaches a\n * console transport — hub-side `WinstonDestination` +\n * `ConsoleDestination`, agent-side `HubForwarderDestination`. One\n * definition so the three paths can't drift.\n *\n * Layout mirrors NestJS `ConsoleLogger` output:\n *\n *   [Nest] 54994  - 04/20/2026, 12:45:53 AM     LOG [InstanceLoader] TrpcModule dependencies initialized +0ms\n *\n * Mapping for camstack — cluster-aware:\n *   - `[Nest]` (brand bracket)   → `[<agent>/<addonId>]` so operators see\n *                                   at a glance which node emitted the line\n *                                   (matches the cluster topology)\n *   - `54994` (pid)              → `process.pid`\n *   - `<timestamp>`              → `M/D/YYYY, H:MM:SS AM`\n *   - `LOG` / `WARN` / `ERROR`   → `entry.level` upper-cased, colour per level\n *   - `[InstanceLoader]` (ctx)   → `[<device>]` — shown only when a device\n *                                   tag is present; omitted otherwise\n *   - `<message>`                → `entry.message`\n *   - trailing `+Nms`            → we don't compute timing yet; omitted\n *\n * Rendered examples:\n *   [hub/winston-logging]        71184  - 04/20/2026, 12:45:53 AM     INFO  Winston logging initialized\n *   [hub/provider-rtsp]          71184  - 04/20/2026, 12:46:01 AM     WARN  [salone] probe failed {err=\"timeout\"}\n *   [dev-agent-0/detection]      12345  - 04/20/2026, 12:47:15 AM     ERROR [cortile] no detector {codec=av1}\n */\nimport type { LogEntry, LogTags } from '@camstack/types'\n\n// Emit ANSI colour codes when the runtime supports them. Heuristic\n// follows npm ecosystem convention so log-consumers can override:\n//   - `NO_COLOR` env present → OFF (https://no-color.org/)\n//   - `FORCE_COLOR=0` → OFF\n//   - `FORCE_COLOR` truthy (1/2/3/true) → ON  (forces even when piped)\n//   - stdout.isTTY → ON\n//   - else → OFF\n// Rationale: running via `concurrently` / `npm run dev` often pipes\n// stdout and strips `isTTY`, making colours disappear. Dev sets\n// `FORCE_COLOR=1` in the shell to opt back in; CI / file-piping\n// pipelines set `NO_COLOR=1` to strip.\n//\n// Destinations that always render for console (ConsoleDestination,\n// HubForwarderDestination) pass `colorize: true` explicitly — still\n// gated by NO_COLOR. File sinks (Winston JSON) pass `colorize: false`\n// so log files stay plain text regardless of the shell environment.\nconst USE_COLOR = (() => {\n  try {\n    if (typeof process === 'undefined') return false\n    const env = process.env ?? {}\n    if (env['NO_COLOR']) return false\n    const force = env['FORCE_COLOR']\n    if (force !== undefined) return force !== '' && force !== '0' && force !== 'false'\n    return Boolean((process.stdout as { isTTY?: boolean })?.isTTY)\n  } catch { return false }\n})()\n\n/** True when `NO_COLOR` is set — destinations that force colour on still honour this. */\nconst NO_COLOR = (() => {\n  try { return Boolean(process?.env?.['NO_COLOR']) } catch { return false }\n})()\n\nconst RESET = '\\x1b[0m'\nconst ANSI = {\n  green:  '\\x1b[32m',\n  yellow: '\\x1b[33m',\n  red:    '\\x1b[31m',\n  cyan:   '\\x1b[36m',\n  gray:   '\\x1b[90m',\n} as const\n\nconst COLOR_BY_LEVEL: Readonly<Record<string, string>> = {\n  debug: ANSI.gray,\n  info:  ANSI.green,\n  warn:  ANSI.yellow,\n  error: ANSI.red,\n}\n\nfunction paint(color: string, text: string, enabled: boolean): string {\n  return enabled ? `${color}${text}${RESET}` : text\n}\n\nfunction colorizeLevel(level: string, text: string, enabled: boolean): string {\n  if (!enabled) return text\n  const code = COLOR_BY_LEVEL[level]\n  return code ? `${code}${text}${RESET}` : text\n}\n\n/** Right-pad `value` to exactly `width` characters. */\nfunction padRight(value: string, width: number): string {\n  if (value.length >= width) return value.slice(0, width)\n  return value + ' '.repeat(width - value.length)\n}\n\n/** Derive the agent — the top-level cluster node, never the forked-worker suffix. */\nfunction resolveAgent(tags: LogTags | undefined): string | null {\n  const agentId = tags?.agentId\n  if (typeof agentId === 'string' && agentId.length > 0) return agentId\n  const nodeId = tags?.nodeId\n  if (typeof nodeId === 'string' && nodeId.length > 0) {\n    return nodeId.includes('/') ? nodeId.split('/')[0]! : nodeId\n  }\n  return null\n}\n\n/** Derive the addon — `tags.addonId` first; `system` when the tag is missing\n *  (scope is no longer a fallback — it's a sub-component label, not identity). */\nfunction resolveAddon(entry: Pick<LogEntry, 'tags'>): string {\n  const addonId = entry.tags?.addonId\n  if (typeof addonId === 'string' && addonId.length > 0) return addonId\n  return 'system'\n}\n\n/** Device name (or `#id` fallback) — used inside the context bracket when present. */\nfunction resolveDevice(tags: LogTags | undefined): string | null {\n  const name = tags?.deviceName\n  if (typeof name === 'string' && name.length > 0) return name\n  const id = tags?.deviceId\n  if (typeof id === 'number' && Number.isFinite(id)) return `#${id}`\n  return null\n}\n\n/**\n * Build the brand bracket content — `<agent>/<addonId>`. Agent is\n * always shown (even `hub`) so operators never have to guess which\n * node emitted a line. Falls back to `?/<addon>` when tags don't\n * carry an agent id (pre-boot logs, test harnesses).\n */\nfunction buildBrand(entry: Pick<LogEntry, 'tags'>): string {\n  const agent = resolveAgent(entry.tags) ?? '?'\n  const addon = resolveAddon(entry)\n  return `${agent}/${addon}`\n}\n\n/**\n * Build the optional device-context bracket. Returns `null` when the\n * line doesn't carry a device tag — renders as just the brand + message\n * without the second bracket. With a device tag: `salone` / `#42`.\n */\nfunction buildDeviceContext(entry: Pick<LogEntry, 'tags'>): string | null {\n  return resolveDevice(entry.tags)\n}\n\n/**\n * NestJS-style locale timestamp: `M/D/YYYY, H:MM:SS AM`. Built with\n * `toLocaleString('en-US')` to match the default NestJS format that\n * operators are used to from Nest boot output.\n */\nfunction formatTimestamp(value: unknown): string {\n  const date = value instanceof Date ? value : new Date(typeof value === 'string' ? value : Date.now())\n  return date.toLocaleString('en-US', {\n    month: 'numeric',\n    day: 'numeric',\n    year: 'numeric',\n    hour: 'numeric',\n    minute: '2-digit',\n    second: '2-digit',\n    hour12: true,\n  })\n}\n\n/** Compact `{key=value key=\"with space\"}` rendering of an arbitrary object. Empty → ''. */\nfunction formatMeta(meta: Record<string, unknown> | undefined): string {\n  if (!meta) return ''\n  const keys = Object.keys(meta)\n  if (keys.length === 0) return ''\n  const parts: string[] = []\n  for (const key of keys) {\n    const value = meta[key]\n    parts.push(`${key}=${formatMetaValue(value)}`)\n  }\n  return `{${parts.join(' ')}}`\n}\n\nfunction formatMetaValue(value: unknown): string {\n  if (value === null) return 'null'\n  if (value === undefined) return 'undefined'\n  if (typeof value === 'string') {\n    return /\\s|\"/.test(value) ? JSON.stringify(value) : value\n  }\n  if (typeof value === 'number' || typeof value === 'boolean') return String(value)\n  if (value instanceof Error) return JSON.stringify(value.message)\n  try { return JSON.stringify(value) } catch { return String(value) }\n}\n\n/** Cached renderer PID — fallback when the entry doesn't carry its own `tags.pid`. */\nconst PID = typeof process !== 'undefined' && typeof process.pid === 'number' ? String(process.pid) : '?'\n\n/** Options for `formatLogLine`. */\nexport interface FormatLogLineOptions {\n  /**\n   * Emit ANSI colour codes. When omitted, falls back to the shell-env\n   * heuristic (`NO_COLOR`/`FORCE_COLOR`/`isTTY`). Destinations that\n   * always target a console (ConsoleDestination, HubForwarderDestination)\n   * pass `true`; file sinks (Winston JSON) pass `false` so logs on disk\n   * stay plain text regardless of the shell env.\n   *\n   * `NO_COLOR=1` in the environment still wins — consumer opt-in beats\n   * producer opt-in, matching the https://no-color.org/ convention.\n   */\n  readonly colorize?: boolean\n}\n\n/**\n * Render a `LogEntry` as one complete console line — no trailing newline.\n * Caller appends `\\n` (file sinks) or relies on `console.log` (stdout sink).\n *\n * PID column prefers `entry.tags.pid` when set (so forked-worker entries\n * carry the worker's OS pid even when the hub renders them), falling back\n * to the renderer's own `process.pid`.\n *\n * Colours (when enabled) follow the NestJS convention: the level token\n * AND the message body share the level colour (green/yellow/red/gray for\n * info/warn/error/debug). Brand, device context, scope and meta keep\n * their fixed hues so the structural fields stay visually distinct from\n * the message content.\n */\nexport function formatLogLine(entry: LogEntry, options?: FormatLogLineOptions): string {\n  const wantsColor = options?.colorize ?? USE_COLOR\n  const colorize = wantsColor && !NO_COLOR\n  const levelColor = COLOR_BY_LEVEL[entry.level]\n\n  const brand = paint(ANSI.green, `[${buildBrand(entry)}]`, colorize)\n  const entryPid = entry.tags?.pid\n  const pid = typeof entryPid === 'number' ? String(entryPid) : PID\n  const timestamp = formatTimestamp(entry.timestamp)\n  // Right-pad level to 5 chars (matches NestJS) so the context/message\n  // column aligns across different levels without fixed-width hacks\n  // on the surrounding fields.\n  const level = colorizeLevel(entry.level, padRight(entry.level.toUpperCase(), 5), colorize)\n  const device = buildDeviceContext(entry)\n  const ctxPart = device ? ' ' + paint(ANSI.yellow, `[${device}]`, colorize) : ''\n  const scope = typeof entry.scope === 'string' && entry.scope.length > 0 ? entry.scope : null\n  const scopePart = scope ? ' ' + paint(ANSI.cyan, `(${scope})`, colorize) : ''\n  const metaText = formatMeta(entry.meta)\n  const metaPart = metaText ? ' ' + paint(ANSI.gray, metaText, colorize) : ''\n  // NestJS layout: `[<agent>/<addon>] <pid>  - <timestamp>     <LEVEL> [<device>] (<scope>) <message>`\n  // Message body is tinted by level colour so `error`/`warn` stand out at a glance.\n  const message = colorize && levelColor\n    ? `${levelColor}${entry.message}${RESET}`\n    : entry.message\n  return `${brand} ${pid}  - ${timestamp}     ${level}${ctxPart}${scopePart} ${message}${metaPart}`\n}\n"],"mappings":"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","names":["DailyRotateFile"]}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/builtins/winston-logging/winston-destination.ts","../../../src/builtins/winston-logging/winston-logging.addon.ts"],"sourcesContent":["import * as winston from 'winston'\nimport DailyRotateFile from 'winston-daily-rotate-file'\nimport * as path from 'node:path'\nimport type { ILogDestination, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\ninterface WinstonConfig {\n  readonly level: string\n  readonly retentionDays: number\n  /** Resolved absolute path to the logs directory (replaces the old dataPath field). */\n  readonly logsDir: string\n}\n\n/**\n * Rotated-file log destination. Console output goes through the shared\n * `formatLogLine` so every console sink (Winston, ConsoleDestination,\n * HubForwarderDestination) emits identical lines. File output keeps a\n * structured JSON shape so log tooling can query tags/meta.\n */\nexport class WinstonDestination implements ILogDestination {\n  private logger: winston.Logger | null = null\n\n  async initialize(config?: WinstonConfig): Promise<void> {\n    const {\n      level = 'info',\n      retentionDays = 30,\n      logsDir = path.join('camstack-data', 'logs'),\n    } = config ?? {}\n\n    // Console: canonical single-line formatter — `_rendered` already\n    // carries level-based ANSI colour codes (see `formatLogLine` in\n    // `@camstack/core/logging/formatter.ts`). Using Winston's colorize\n    // here would just decorate unused `info.level` and leave the\n    // rendered line uncoloured.\n    const consoleFormat = winston.format.printf((info) => {\n      const rendered = (info as unknown as { _rendered?: string })._rendered\n      return typeof rendered === 'string' ? rendered : String(info.message)\n    })\n\n    // File: structured JSON. Strip `_rendered` first — it carries ANSI\n    // escape codes intended for the terminal and has no place in a\n    // rotated-file store used for ops queries.\n    const stripRendered = winston.format((info) => {\n      delete (info as Record<string, unknown>)['_rendered']\n      return info\n    })\n    const fileFormat = winston.format.combine(\n      winston.format.timestamp(),\n      stripRendered(),\n      winston.format.json(),\n    )\n\n    // File-only winston. Stdout is owned by `ConsoleDestination`\n    // (the `console-logging` builtin addon) — adding a Winston console\n    // transport here would re-render every log line a second time on\n    // the hub terminal, which is the historic cause of the duplicate\n    // output operators have been seeing. The `consoleFormat` printf\n    // above stays wired in so a future opt-in transport can use it\n    // without re-deriving the layout.\n    void consoleFormat\n    this.logger = winston.createLogger({\n      level,\n      transports: [\n        new DailyRotateFile({\n          dirname: logsDir,\n          filename: 'camstack-%DATE%.log',\n          datePattern: 'YYYY-MM-DD',\n          maxFiles: `${retentionDays}d`,\n          format: fileFormat,\n        }),\n      ],\n    })\n  }\n\n  write(entry: LogEntry): void {\n    if (!this.logger) return\n\n    // Moleculer JSON serialization converts Date → string; normalize back\n    const ts = entry.timestamp instanceof Date\n      ? entry.timestamp.toISOString()\n      : String(entry.timestamp)\n    // Render once with colours for the console transport; file transport\n    // strips `_rendered` via the format chain above so disk stays plain.\n    const rendered = formatLogLine(entry, { colorize: true })\n\n    this.logger.log({\n      level: entry.level,\n      message: entry.message,\n      _rendered: rendered,\n      timestamp: ts,\n      scope: entry.scope,\n      ...(entry.tags ? { tags: entry.tags } : {}),\n      ...(entry.meta ? { meta: entry.meta } : {}),\n    })\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // File-based log querying is not implemented; use structured storage for log queries\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.logger) return\n\n    await new Promise<void>((resolve) => {\n      this.logger!.on('finish', resolve)\n      this.logger!.end()\n    })\n    this.logger = null\n  }\n}\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { WinstonDestination } from './winston-destination.js'\n\ninterface WinstonConfig {\n  readonly level: string\n  readonly retentionDays: number\n}\n\n/**\n * Winston logging addon — rotated log files + console output.\n * Settings appear under Cluster → NodeDetail → Settings.\n */\nexport class WinstonLoggingAddon extends BaseAddon<WinstonConfig> {\n  private destination: WinstonDestination | null = null\n\n  constructor() {\n    super({ level: 'info', retentionDays: 30 })\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const logsDir = await this.ctx.api.storage.resolve.query({ location: 'logs', relativePath: '' })\n      .catch(() => 'camstack-data/logs')\n    this.destination = new WinstonDestination()\n    await this.destination.initialize({ ...this.config, logsDir })\n    this.ctx.logger.info('Winston logging initialized')\n    return [{ capability: logDestinationCapability, provider: this.destination }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    await this.destination?.shutdown()\n  }\n\n  getDestination(): WinstonDestination {\n    if (!this.destination) throw new Error('Winston not initialized')\n    return this.destination\n  }\n\n  protected globalSettingsSchema() {\n    return this.schema({\n      sections: [\n        {\n          id: 'winston-logging',\n          title: 'Logging',\n          description: 'Global log verbosity + retention for rotated log files on this node.',\n          columns: 2,\n          fields: [\n            this.field({\n              type: 'select',\n              key: 'level',\n              label: 'Log Level',\n              default: 'info',\n              options: [\n                { value: 'debug', label: 'Debug' },\n                { value: 'info', label: 'Info' },\n                { value: 'warn', label: 'Warn' },\n                { value: 'error', label: 'Error' },\n              ],\n            }),\n            this.field({\n              type: 'number',\n              key: 'retentionDays',\n              label: 'Retention (days)',\n              description: 'Number of days to keep rotated log files before deletion',\n              min: 1,\n              max: 365,\n              step: 1,\n              default: 30,\n              unit: 'days',\n            }),\n          ],\n        },\n      ],\n    })\n  }\n}\n"],"mappings":"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"}