@camstack/core 0.1.13 → 0.1.15

package/dist/builtins/system-config/system-config.addon.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/builtins/system-config/system-config.addon.ts"],"sourcesContent":["import type {\n  ConfigUISchema,\n  ConfigUISchemaWithValues,\n} from '@camstack/types'\nimport { BaseAddon, hydrateSchema , errMsg } from '@camstack/types'\n\n/**\n * Built-in `system-config` addon — Phase 4 of the settings redesign.\n *\n * Exposes the cluster-wide yml-backed sections that the bootstrap\n * loader reads before any addon is instantiated — things that cannot\n * live inside an addon because changing them requires a server\n * restart (port, host, dataPath) or because they own no runtime\n * state of their own (auth token expiry, global ffmpeg binary path).\n *\n * Sections exposed:\n *   - server     (port, host, dataPath — READ-ONLY, loaded from config.yaml at bootstrap)\n *   - auth       (tokenExpiry)\n *   - ffmpeg     (binaryPath, hwAccel, threadCount)\n *\n * Sections NOT exposed (each owned by the addon that implements them):\n *   - logging    → `winston-logging` addon (level + retention)\n *   - recording  → `recording` addon (segment duration, retention)\n *   - retention  → analytics / detection addons (per-table retention)\n *\n * Implementation notes:\n *   - Runs only on the hub process (yml sections are hub-side state).\n *     On agent nodes this addon would still instantiate, but every\n *     `ctx.settings.getSection(section)` call would hit an empty\n *     ConfigManager section so the UI would show the schema defaults.\n *     In practice the built-in loader can skip it on agents; for now we\n *     just let it run everywhere because it's harmless.\n *   - Reads via `ctx.settings.getSection(section)` and writes via\n *     `ctx.settings.setSection(section, patch)` — the explicit\n *     yml-section pair on `AddonSettingsApi`.\n *   - Does NOT register as a capability provider. It's a pure \"settings\n *     surface\" addon — its sole purpose is to expose the yml sections\n *     through the new three-level settings API.\n *\n * This addon is declared in `@camstack/core`'s package.json `camstack.addons[]`\n * and loaded automatically via AddonLoader like any other core built-in.\n */\n\n/** Section key → user-facing section title. */\nconst SECTION_TITLES: Readonly<Record<string, string>> = {\n  server: 'Server',\n  auth: 'Authentication',\n  ffmpeg: 'FFmpeg',\n}\n\n/** Keys that map 1:1 to a given yml section — used by `updateGlobalSettings`\n *  to figure out which section owns each key in the incoming patch. */\nconst KEY_TO_SECTION: Readonly<Record<string, string>> = {\n  // server (read-only)\n  port: 'server',\n  host: 'server',\n  dataPath: 'server',\n  // auth\n  tokenExpiry: 'auth',\n  // ffmpeg\n  binaryPath: 'ffmpeg',\n  hwAccel: 'ffmpeg',\n  threadCount: 'ffmpeg',\n}\n\nexport class SystemConfigAddon extends BaseAddon {\n  readonly id = 'system-config'\n\n  constructor() { super({}) }\n\n  protected async onInitialize(): Promise<void> {\n    this.ctx.logger.info('Initialized — exposes yml-backed sections via getGlobalSettings')\n  }\n\n  // ── Three-level settings API (only `getGlobalSettings` is implemented) ──\n\n  private buildGlobalSchema(): ConfigUISchema {\n    return {\n      sections: [\n        {\n          id: 'system-config-server',\n          title: SECTION_TITLES['server']!,\n          description: 'Core server connection settings — read-only, loaded from config.yaml at bootstrap.',\n          columns: 2,\n          fields: [\n            {\n              type: 'info',\n              key: 'server-restart-note',\n              label: 'Restart required',\n              content: 'Server settings are read-only. Change them in config.yaml and restart.',\n              variant: 'warning',\n            },\n            { type: 'text', key: 'port', label: 'Port', description: 'Listening port', disabled: true },\n            { type: 'text', key: 'host', label: 'Host', description: 'Bind address', disabled: true },\n            { type: 'text', key: 'dataPath', label: 'Data Path', description: 'Root data directory', disabled: true, span: 2 },\n          ],\n        },\n        {\n          id: 'system-config-auth',\n          title: SECTION_TITLES['auth']!,\n          description: 'Token and session settings.',\n          columns: 1,\n          fields: [\n            {\n              type: 'text',\n              key: 'tokenExpiry',\n              label: 'Token Expiry',\n              description: 'JWT token lifetime (e.g. 24h, 7d, 1h)',\n              placeholder: '24h',\n              default: '24h',\n            },\n          ],\n        },\n        {\n          id: 'system-config-ffmpeg',\n          title: SECTION_TITLES['ffmpeg']!,\n          description: 'FFmpeg binary and hardware acceleration settings.',\n          columns: 2,\n          fields: [\n            {\n              type: 'text',\n              key: 'binaryPath',\n              label: 'Binary Path',\n              description: 'Path to ffmpeg executable',\n              placeholder: 'ffmpeg',\n              default: 'ffmpeg',\n              span: 2,\n            },\n            {\n              type: 'select',\n              key: 'hwAccel',\n              label: 'Hardware Acceleration',\n              description: 'GPU decoding/encoding backend',\n              default: 'auto',\n              options: [\n                { value: 'auto', label: 'Auto-detect' },\n                { value: 'none', label: 'None (CPU only)' },\n                { value: 'videotoolbox', label: 'VideoToolbox (macOS)' },\n                { value: 'vaapi', label: 'VA-API (Linux Intel/AMD)' },\n                { value: 'qsv', label: 'QSV (Intel Quick Sync)' },\n                { value: 'cuda', label: 'CUDA (NVIDIA)' },\n              ],\n            },\n            {\n              type: 'number',\n              key: 'threadCount',\n              label: 'Thread Count',\n              description: '0 = auto (let FFmpeg decide)',\n              min: 0,\n              max: 16,\n              step: 1,\n              default: 0,\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  async getGlobalSettings(): Promise<ConfigUISchemaWithValues> {\n    const schema = this.buildGlobalSchema()\n    if (!this.ctx.settings) {\n      return hydrateSchema(schema, {})\n    }\n\n    // Read all yml sections in parallel and merge their values into a\n    // single flat record keyed by field name. The `KEY_TO_SECTION` map\n    // guarantees uniqueness (each key belongs to exactly one section).\n    const sectionNames = Object.keys(SECTION_TITLES)\n    const merged: Record<string, unknown> = {}\n    for (const section of sectionNames) {\n      try {\n        const values = await this.ctx.settings!.getSection(section)\n        Object.assign(merged, values)\n      } catch (err: unknown) {\n        const msg = errMsg(err)\n        this.ctx.logger.debug('Failed to read section', { meta: { section, error: msg } })\n      }\n    }\n\n    return hydrateSchema(schema, merged)\n  }\n\n  async updateGlobalSettings(patch: Record<string, unknown>): Promise<void> {\n    if (!this.ctx.settings) {\n      throw new Error('system-config: ctx.settings not available — cannot write sections')\n    }\n\n    // Group the patch keys by the section they belong to, then write\n    // each section in one shot via ctx.settings.setSection(). The\n    // server section is read-only, so any keys targeting it are skipped\n    // with a warning.\n    const perSection = new Map<string, Record<string, unknown>>()\n    for (const [key, value] of Object.entries(patch)) {\n      const section = KEY_TO_SECTION[key]\n      if (section === undefined) {\n        this.ctx.logger.warn('update ignored unknown key (not mapped to any section)', { meta: { key } })\n        continue\n      }\n      if (section === 'server') {\n        this.ctx.logger.warn('update ignored read-only server-section key', { meta: { key } })\n        continue\n      }\n      let bucket = perSection.get(section)\n      if (!bucket) {\n        bucket = {}\n        perSection.set(section, bucket)\n      }\n      bucket[key] = value\n    }\n\n    for (const [section, sectionPatch] of perSection) {\n      await this.ctx.settings!.setSection(section, sectionPatch)\n      this.ctx.logger.info('Wrote keys to section', { meta: { section, keyCount: Object.keys(sectionPatch).length } })\n    }\n  }\n}\n\nexport default SystemConfigAddon\n"],"mappings":"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","names":[]}

package/dist/builtins/system-config/system-config.addon.mjs

@@ -0,0 +1,9 @@
+import {
+  SystemConfigAddon,
+  system_config_addon_default
+} from "../../chunk-QT57H266.mjs";
+export {
+  SystemConfigAddon,
+  system_config_addon_default as default
+};
+//# sourceMappingURL=system-config.addon.mjs.map

package/dist/builtins/system-config/system-config.addon.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -36,16 +36,147 @@ __export(winston_logging_exports, {
 });
 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"));
-function formatScope(scope) {
-  if (scope.length === 0) return "";
-  const [first, ...rest] = scope;
-  const restFormatted = rest.map((s) => `[${s}]`).join("");
-  return `(${first})${restFormatted}`;
+
+// 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
 var WinstonDestination = class {
   logger = null;
   async initialize(config) {
@@ -54,24 +185,23 @@ var WinstonDestination = class {
       retentionDays = 30,
       logsDir = path.join("camstack-data", "logs")
     } = config ?? {};
-    const consoleFormat = winston.format.combine(
-      winston.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
-      winston.format.colorize(),
-      winston.format.printf(({ timestamp, level: lvl, message, scope }) => {
-        const scopeStr = scope ? ` ${scope}` : "";
-        return `${timestamp} [${lvl}]${scopeStr} - ${message}`;
-      })
-    );
+    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 winston.transports.Console({
-          format: consoleFormat
-        }),
         new import_winston_daily_rotate_file.default({
           dirname: logsDir,
           filename: "camstack-%DATE%.log",
@@ -84,14 +214,16 @@ var WinstonDestination = class {
   }
   write(entry) {
     if (!this.logger) return;
-    const scope = formatScope(entry.scope);
-    const meta = entry.meta ?? {};
+    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,
-      scope,
-      timestamp: entry.timestamp.toISOString(),
-      ...meta
+      _rendered: rendered,
+      timestamp: ts,
+      scope: entry.scope,
+      ...entry.tags ? { tags: entry.tags } : {},
+      ...entry.meta ? { meta: entry.meta } : {}
     });
   }
   async query(_filter) {
@@ -108,51 +240,47 @@ var WinstonDestination = class {
 };
 
 // src/builtins/winston-logging/winston-logging.addon.ts
-var WinstonLoggingAddon = class {
-  manifest = {
-    id: "winston-logging",
-    name: "Winston Logging",
-    version: "1.0.0",
-    capabilities: ["log-destination"]
-  };
+var WinstonLoggingAddon = class extends import_types.BaseAddon {
   destination = null;
-  currentConfig = {
-    level: "info",
-    retentionDays: 30
-  };
-  async initialize(context) {
-    this.currentConfig = {
-      level: context.addonConfig.level ?? this.currentConfig.level,
-      retentionDays: context.addonConfig.retentionDays ?? this.currentConfig.retentionDays
-    };
-    const logsDir = context.locationPaths.logs;
+  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.currentConfig, logsDir });
-    context.logger.info("Winston logging initialized");
+    await this.destination.initialize({ ...this.config, logsDir });
+    this.ctx.logger.info("Winston logging initialized");
+    return [{ capability: import_types.logDestinationCapability, provider: this.destination }];
   }
-  async shutdown() {
+  async onShutdown() {
     await this.destination?.shutdown();
   }
   getDestination() {
     if (!this.destination) throw new Error("Winston not initialized");
     return this.destination;
   }
-  getCapabilityProvider(name) {
-    if (name === "log-destination" && this.destination) {
-      return this.destination;
-    }
-    return null;
-  }
-  getConfigSchema() {
-    return {
+  globalSettingsSchema() {
+    return this.schema({
       sections: [
         {
-          id: "winston-retention",
-          title: "Log Retention",
-          description: "How long Winston keeps rotated log files on disk.",
-          columns: 1,
+          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)",
@@ -160,21 +288,13 @@ var WinstonLoggingAddon = class {
               min: 1,
               max: 365,
               step: 1,
+              default: 30,
               unit: "days"
-            }
+            })
           ]
         }
       ]
-    };
-  }
-  getConfig() {
-    return { ...this.currentConfig };
-  }
-  async onConfigChange(config) {
-    this.currentConfig = {
-      level: config.level ?? this.currentConfig.level,
-      retentionDays: config.retentionDays ?? this.currentConfig.retentionDays
-    };
+    });
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/builtins/winston-logging/index.ts","../../../src/builtins/winston-logging/winston-destination.ts","../../../src/builtins/winston-logging/winston-logging.addon.ts"],"sourcesContent":["export { WinstonLoggingAddon } from './winston-logging.addon'\nexport { WinstonDestination } from './winston-destination'\nexport { WinstonLoggingAddon as default } from './winston-logging.addon'\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'\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\nfunction formatScope(scope: readonly string[]): string {\n  if (scope.length === 0) return ''\n  const [first, ...rest] = scope\n  const restFormatted = rest.map((s) => `[${s}]`).join('')\n  return `(${first})${restFormatted}`\n}\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    const consoleFormat = winston.format.combine(\n      winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),\n      winston.format.colorize(),\n      winston.format.printf(({ timestamp, level: lvl, message, scope }) => {\n        const scopeStr = scope ? ` ${scope}` : ''\n        return `${timestamp} [${lvl}]${scopeStr} - ${message}`\n      }),\n    )\n\n    const fileFormat = winston.format.combine(\n      winston.format.timestamp(),\n      winston.format.json(),\n    )\n\n    this.logger = winston.createLogger({\n      level,\n      transports: [\n        new winston.transports.Console({\n          format: consoleFormat,\n        }),\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    const scope = formatScope(entry.scope)\n    const meta = entry.meta ?? {}\n\n    this.logger.log({\n      level: entry.level,\n      message: entry.message,\n      scope,\n      timestamp: entry.timestamp.toISOString(),\n      ...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 {\n  ICamstackAddon,\n  AddonManifest,\n  AddonContext,\n  IConfigurable,\n  ConfigUISchema,\n  CapabilityProviderMap,\n} from '@camstack/types'\nimport { WinstonDestination } from './winston-destination'\n\nexport class WinstonLoggingAddon implements ICamstackAddon, IConfigurable {\n  readonly manifest: AddonManifest = {\n    id: 'winston-logging',\n    name: 'Winston Logging',\n    version: '1.0.0',\n    capabilities: ['log-destination'],\n  }\n\n  private destination: WinstonDestination | null = null\n  private currentConfig = {\n    level: 'info',\n    retentionDays: 30,\n  }\n\n  async initialize(context: AddonContext): Promise<void> {\n    this.currentConfig = {\n      level: (context.addonConfig.level as string) ?? this.currentConfig.level,\n      retentionDays: (context.addonConfig.retentionDays as number) ?? this.currentConfig.retentionDays,\n    }\n    const logsDir = context.locationPaths.logs\n    this.destination = new WinstonDestination()\n    await this.destination.initialize({ ...this.currentConfig, logsDir })\n    context.logger.info('Winston logging initialized')\n  }\n\n  async shutdown(): 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  getCapabilityProvider<K extends keyof CapabilityProviderMap>(\n    name: K,\n  ): CapabilityProviderMap[K] | null {\n    if (name === 'log-destination' && this.destination) {\n      return this.destination as unknown as CapabilityProviderMap[K]\n    }\n    return null\n  }\n\n  getConfigSchema(): ConfigUISchema {\n    return {\n      sections: [\n        {\n          id: 'winston-retention',\n          title: 'Log Retention',\n          description: 'How long Winston keeps rotated log files on disk.',\n          columns: 1,\n          fields: [\n            {\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              unit: 'days',\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  getConfig(): Record<string, unknown> {\n    return { ...this.currentConfig }\n  }\n\n  async onConfigChange(config: Record<string, unknown>): Promise<void> {\n    this.currentConfig = {\n      level: (config.level as string) ?? this.currentConfig.level,\n      retentionDays: (config.retentionDays as number) ?? this.currentConfig.retentionDays,\n    }\n  }\n}\n"],"mappings":"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","names":["DailyRotateFile"]}
+{"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"]}

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

@@ -1,7 +1,8 @@
 import {
   WinstonDestination,
   WinstonLoggingAddon
-} from "../../chunk-LQFPAEQF.mjs";
+} from "../../chunk-KDG2NTDB.mjs";
+import "../../chunk-2F76X6NL.mjs";
 export {
   WinstonDestination,
   WinstonLoggingAddon,

package/dist/chunk-2CIYKDRN.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-2CIYKDRN.mjs.map

package/dist/chunk-2CIYKDRN.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-2F76X6NL.mjs

@@ -0,0 +1,136 @@
+// 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}`;
+}
+
+export {
+  formatLogLine
+};
+//# sourceMappingURL=chunk-2F76X6NL.mjs.map

package/dist/chunk-2F76X6NL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging/formatter.ts"],"sourcesContent":["/**\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":[]}

package/dist/chunk-2QUFBZ7M.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-2QUFBZ7M.mjs.map

package/dist/chunk-2QUFBZ7M.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}