@camstack/core 0.1.14 → 0.1.16

package/dist/builtins/turn-orchestrator/turn-orchestrator.addon.mjs

@@ -0,0 +1,72 @@
+import { BaseAddon, turnOrchestratorCapability } from "@camstack/types";
+//#region src/builtins/turn-orchestrator/turn-orchestrator.addon.ts
+/**
+* TURN orchestrator — singleton facade over the `turn-provider`
+* collection (Cloudflare TURN, coturn, Twilio, …). Mirrors the
+* auth-orchestrator / remote-access-orchestrator patterns.
+*
+* Provides:
+*   - listProviders() — admin UI inventory
+*   - getAllServers() — combined ICE server list across enabled
+*     providers, consumed by the WebRTC layer at session creation
+*/
+var TurnOrchestratorAddon = class extends BaseAddon {
+	constructor() {
+		super({});
+	}
+	async onInitialize() {
+		const provider = {
+			listProviders: async () => this.listProviders(),
+			getAllServers: async () => this.getAllServers(),
+			setProviderEnabled: async () => {
+				return { success: true };
+			}
+		};
+		this.ctx.logger.info("TURN orchestrator initialized");
+		return [{
+			capability: turnOrchestratorCapability,
+			provider
+		}];
+	}
+	getEntries() {
+		return this.capabilities?.getCollectionEntries("turn-provider") ?? [];
+	}
+	async listProviders() {
+		const out = [];
+		for (const [addonId, impl] of this.getEntries()) {
+			let serverCount = 0;
+			let error;
+			if (impl.getTurnServers) try {
+				serverCount = (await impl.getTurnServers()).length;
+			} catch (err) {
+				error = err instanceof Error ? err.message : String(err);
+			}
+			out.push({
+				addonId,
+				displayName: impl.displayName ?? addonId,
+				kind: impl.kind ?? (addonId.includes("cloudflare") ? "cloudflare" : addonId.includes("coturn") ? "coturn" : "other"),
+				enabled: true,
+				serverCount,
+				...error !== void 0 ? { error } : {}
+			});
+		}
+		return out;
+	}
+	async getAllServers() {
+		const out = [];
+		for (const [, impl] of this.getEntries()) {
+			if (!impl.getTurnServers) continue;
+			try {
+				const servers = await impl.getTurnServers();
+				out.push(...servers);
+			} catch (err) {
+				this.ctx.logger.warn("TURN provider failed to enumerate servers", { meta: { error: err instanceof Error ? err.message : String(err) } });
+			}
+		}
+		return out;
+	}
+};
+//#endregion
+export { TurnOrchestratorAddon, TurnOrchestratorAddon as default };
+
+//# sourceMappingURL=turn-orchestrator.addon.mjs.map

package/dist/builtins/turn-orchestrator/turn-orchestrator.addon.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-orchestrator.addon.mjs","names":[],"sources":["../../../src/builtins/turn-orchestrator/turn-orchestrator.addon.ts"],"sourcesContent":["/**\n * TURN orchestrator — singleton facade over the `turn-provider`\n * collection (Cloudflare TURN, coturn, Twilio, …). Mirrors the\n * auth-orchestrator / remote-access-orchestrator patterns.\n *\n * Provides:\n *   - listProviders() — admin UI inventory\n *   - getAllServers() — combined ICE server list across enabled\n *     providers, consumed by the WebRTC layer at session creation\n */\nimport {\n  BaseAddon,\n  turnOrchestratorCapability,\n  type ITurnOrchestratorProvider,\n  type TurnProviderInfo,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface TurnProviderLike {\n  getTurnServers?: () => Promise<readonly { urls: string | string[]; username?: string; credential?: string }[]>\n  readonly displayName?: string\n  readonly kind?: TurnProviderInfo['kind']\n}\n\nexport class TurnOrchestratorAddon extends BaseAddon<Record<string, never>> {\n  constructor() {\n    super({})\n  }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    const provider: ITurnOrchestratorProvider = {\n      listProviders: async () => this.listProviders(),\n      getAllServers: async () => this.getAllServers(),\n      setProviderEnabled: async () => {\n        // Persistence per-addon for now — see auth-orchestrator\n        // rationale.\n        return { success: true as const }\n      },\n    }\n    this.ctx.logger.info('TURN orchestrator initialized')\n    return [{ capability: turnOrchestratorCapability, provider }]\n  }\n\n  private getEntries(): readonly (readonly [string, TurnProviderLike])[] {\n    return this.capabilities?.getCollectionEntries<TurnProviderLike>('turn-provider') ?? []\n  }\n\n  private async listProviders(): Promise<readonly TurnProviderInfo[]> {\n    const out: TurnProviderInfo[] = []\n    for (const [addonId, impl] of this.getEntries()) {\n      let serverCount = 0\n      let error: string | undefined\n      if (impl.getTurnServers) {\n        try {\n          const servers = await impl.getTurnServers()\n          serverCount = servers.length\n        } catch (err) {\n          error = err instanceof Error ? err.message : String(err)\n        }\n      }\n      out.push({\n        addonId,\n        displayName: impl.displayName ?? addonId,\n        kind: impl.kind ?? (addonId.includes('cloudflare') ? 'cloudflare' as const : addonId.includes('coturn') ? 'coturn' as const : 'other' as const),\n        enabled: true,\n        serverCount,\n        ...(error !== undefined ? { error } : {}),\n      })\n    }\n    return out\n  }\n\n  private async getAllServers(): Promise<readonly { urls: string | string[]; username?: string; credential?: string }[]> {\n    const out: { urls: string | string[]; username?: string; credential?: string }[] = []\n    for (const [, impl] of this.getEntries()) {\n      if (!impl.getTurnServers) continue\n      try {\n        const servers = await impl.getTurnServers()\n        out.push(...servers)\n      } catch (err) {\n        this.ctx.logger.warn('TURN provider failed to enumerate servers', {\n          meta: { error: err instanceof Error ? err.message : String(err) },\n        })\n      }\n    }\n    return out\n  }\n}\n\nexport default TurnOrchestratorAddon\n"],"mappings":";;;;;;;;;;;;AAwBA,IAAa,wBAAb,cAA2C,UAAiC;CAC1E,cAAc;EACZ,MAAM,EAAE,CAAC;;CAGX,MAAgB,eAAgD;EAC9D,MAAM,WAAsC;GAC1C,eAAe,YAAY,KAAK,eAAe;GAC/C,eAAe,YAAY,KAAK,eAAe;GAC/C,oBAAoB,YAAY;IAG9B,OAAO,EAAE,SAAS,MAAe;;GAEpC;EACD,KAAK,IAAI,OAAO,KAAK,gCAAgC;EACrD,OAAO,CAAC;GAAE,YAAY;GAA4B;GAAU,CAAC;;CAG/D,aAAuE;EACrE,OAAO,KAAK,cAAc,qBAAuC,gBAAgB,IAAI,EAAE;;CAGzF,MAAc,gBAAsD;EAClE,MAAM,MAA0B,EAAE;EAClC,KAAK,MAAM,CAAC,SAAS,SAAS,KAAK,YAAY,EAAE;GAC/C,IAAI,cAAc;GAClB,IAAI;GACJ,IAAI,KAAK,gBACP,IAAI;IAEF,eAAc,MADQ,KAAK,gBAAgB,EACrB;YACf,KAAK;IACZ,QAAQ,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;;GAG5D,IAAI,KAAK;IACP;IACA,aAAa,KAAK,eAAe;IACjC,MAAM,KAAK,SAAS,QAAQ,SAAS,aAAa,GAAG,eAAwB,QAAQ,SAAS,SAAS,GAAG,WAAoB;IAC9H,SAAS;IACT;IACA,GAAI,UAAU,KAAA,IAAY,EAAE,OAAO,GAAG,EAAE;IACzC,CAAC;;EAEJ,OAAO;;CAGT,MAAc,gBAAyG;EACrH,MAAM,MAA6E,EAAE;EACrF,KAAK,MAAM,GAAG,SAAS,KAAK,YAAY,EAAE;GACxC,IAAI,CAAC,KAAK,gBAAgB;GAC1B,IAAI;IACF,MAAM,UAAU,MAAM,KAAK,gBAAgB;IAC3C,IAAI,KAAK,GAAG,QAAQ;YACb,KAAK;IACZ,KAAK,IAAI,OAAO,KAAK,6CAA6C,EAChE,MAAM,EAAE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,EAAE,EAClE,CAAC;;;EAGN,OAAO"}

package/dist/builtins/winston-logging/index.d.ts

@@ -1,30 +1,4 @@
-import { ILogDestination, LogEntry, LogFilter, ICamstackAddon, IConfigurable, AddonManifest, AddonContext, CapabilityProviderMap, ConfigUISchema } from '@camstack/types';
-
-interface WinstonConfig {
-    readonly level: string;
-    readonly retentionDays: number;
-    /** Resolved absolute path to the logs directory (replaces the old dataPath field). */
-    readonly logsDir: string;
-}
-declare class WinstonDestination implements ILogDestination {
-    private logger;
-    initialize(config?: WinstonConfig): Promise<void>;
-    write(entry: LogEntry): void;
-    query(_filter: LogFilter): Promise<readonly LogEntry[]>;
-    shutdown(): Promise<void>;
-}
-
-declare class WinstonLoggingAddon implements ICamstackAddon, IConfigurable {
-    readonly manifest: AddonManifest;
-    private destination;
-    private currentConfig;
-    initialize(context: AddonContext): Promise<void>;
-    shutdown(): Promise<void>;
-    getDestination(): WinstonDestination;
-    getCapabilityProvider<K extends keyof CapabilityProviderMap>(name: K): CapabilityProviderMap[K] | null;
-    getConfigSchema(): ConfigUISchema;
-    getConfig(): Record<string, unknown>;
-    onConfigChange(config: Record<string, unknown>): Promise<void>;
-}
-
-export { WinstonDestination, WinstonLoggingAddon, WinstonLoggingAddon as default };
+export { WinstonLoggingAddon } from './winston-logging.addon.js';
+export { WinstonDestination } from './winston-destination.js';
+export { WinstonLoggingAddon as default } from './winston-logging.addon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/winston-logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/winston-logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,IAAI,OAAO,EAAE,MAAM,4BAA4B,CAAA"}

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

@@ -1,185 +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-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}`;
-}
+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.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 fileFormat = winston.format.combine(
-      winston.format.timestamp(),
-      winston.format.json()
-    );
-    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",
-          datePattern: "YYYY-MM-DD",
-          maxFiles: `${retentionDays}d`,
-          format: fileFormat
-        })
-      ]
-    });
-  }
-  write(entry) {
-    if (!this.logger) return;
-    const scope = formatScope(entry.scope);
-    const meta = entry.meta ?? {};
-    this.logger.log({
-      level: entry.level,
-      message: entry.message,
-      scope,
-      timestamp: entry.timestamp.toISOString(),
-      ...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 {
-  manifest = {
-    id: "winston-logging",
-    name: "Winston Logging",
-    version: "1.0.0",
-    capabilities: ["log-destination"]
-  };
-  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;
-    this.destination = new WinstonDestination();
-    await this.destination.initialize({ ...this.currentConfig, logsDir });
-    context.logger.info("Winston logging initialized");
-  }
-  async shutdown() {
-    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 {
-      sections: [
-        {
-          id: "winston-retention",
-          title: "Log Retention",
-          description: "How long Winston keeps rotated log files on disk.",
-          columns: 1,
-          fields: [
-            {
-              type: "number",
-              key: "retentionDays",
-              label: "Retention (days)",
-              description: "Number of days to keep rotated log files before deletion",
-              min: 1,
-              max: 365,
-              step: 1,
-              unit: "days"
-            }
-          ]
-        }
-      ]
-    };
-  }
-  getConfig() {
-    return { ...this.currentConfig };
-  }
-  async onConfigChange(config) {
-    this.currentConfig = {
-      level: config.level ?? this.currentConfig.level,
-      retentionDays: config.retentionDays ?? this.currentConfig.retentionDays
-    };
-  }
+//#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-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,"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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"}