@camstack/core 0.1.14 → 0.1.15

package/dist/builtins/hub-forwarder/index.js

@@ -0,0 +1,297 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/builtins/hub-forwarder/index.ts
+var hub_forwarder_exports = {};
+__export(hub_forwarder_exports, {
+  HubForwarderAddon: () => HubForwarderAddon,
+  HubForwarderDestination: () => HubForwarderDestination,
+  default: () => HubForwarderAddon
+});
+module.exports = __toCommonJS(hub_forwarder_exports);
+
+// src/builtins/hub-forwarder/hub-forwarder.addon.ts
+var import_types = require("@camstack/types");
+
+// 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/hub-forwarder/hub-forwarder-destination.ts
+var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
+var HubForwarderDestination = class {
+  broker = null;
+  hubConnected = false;
+  outboundBuffer = [];
+  statusLogger = null;
+  async initialize() {
+  }
+  /**
+   * Provide a logger for the destination's own status messages
+   * (discovery, disconnect, reconnect). Routed through the agent's
+   * LogManager but never through this same destination — the owning
+   * addon must hand in a logger that does NOT route back here, or
+   * status writes will recurse.
+   */
+  setStatusLogger(logger) {
+    this.statusLogger = logger;
+  }
+  status(level, msg) {
+    if (this.statusLogger) {
+      if (level === "warn") this.statusLogger.warn(msg);
+      else this.statusLogger.info(msg);
+      return;
+    }
+    if (level === "warn") console.warn(`[hub-forwarder] ${msg}`);
+    else console.log(`[hub-forwarder] ${msg}`);
+  }
+  /**
+   * Attach the Moleculer broker so hub forwarding can start.
+   * Called by the owning addon from `onInitialize(ctx)` with
+   * `ctx.kernel.cluster?.broker`.
+   */
+  connectBroker(broker) {
+    this.broker = broker;
+    broker.waitForServices("log-receiver").then(() => {
+      this.hubConnected = true;
+      this.status("info", "log-receiver discovered \u2014 log forwarding active");
+      this.flushOutbound();
+    }).catch(() => {
+    });
+    broker.localBus.on("$node.disconnected", ({ node }) => {
+      if (node.id === "hub") {
+        this.hubConnected = false;
+        this.status("info", "Hub disconnected \u2014 log forwarding paused");
+        broker.waitForServices("log-receiver").then(() => {
+          this.hubConnected = true;
+          this.status("info", "Hub reconnected \u2014 log forwarding resumed");
+          this.flushOutbound();
+        }).catch(() => {
+        });
+      }
+    });
+  }
+  write(entry) {
+    if (this.hubConnected && this.broker) {
+      this.forward(entry);
+      return;
+    }
+    this.bufferOutbound(entry);
+    const line = formatLogLine(entry, { colorize: true });
+    if (entry.level === "error") console.error(line);
+    else if (entry.level === "warn") console.warn(line);
+    else console.log(line);
+  }
+  async query(_filter) {
+    return [];
+  }
+  async shutdown() {
+    this.hubConnected = false;
+    this.broker = null;
+    this.outboundBuffer.length = 0;
+  }
+  bufferOutbound(entry) {
+    this.outboundBuffer.push(entry);
+    if (this.outboundBuffer.length > DEFAULT_OUTBOUND_BUFFER_SIZE) {
+      this.outboundBuffer.splice(0, this.outboundBuffer.length - DEFAULT_OUTBOUND_BUFFER_SIZE);
+    }
+  }
+  flushOutbound() {
+    if (!this.broker || !this.hubConnected) return;
+    const pending = this.outboundBuffer.splice(0, this.outboundBuffer.length);
+    for (const entry of pending) {
+      this.forward(entry);
+    }
+  }
+  forward(entry) {
+    if (!this.broker) return;
+    this.broker.call("log-receiver.ingest", {
+      level: entry.level,
+      message: entry.message,
+      addonId: entry.tags?.addonId ?? "agent",
+      nodeId: entry.tags?.nodeId ?? this.broker.nodeID,
+      ...entry.scope !== void 0 ? { scope: entry.scope } : {},
+      ...entry.tags ? { tags: entry.tags } : {},
+      ...entry.meta ? { meta: entry.meta } : {}
+    }).catch(() => {
+    });
+  }
+};
+
+// src/builtins/hub-forwarder/hub-forwarder.addon.ts
+var HubForwarderAddon = class extends import_types.BaseAddon {
+  destination = null;
+  constructor() {
+    super({});
+  }
+  async onInitialize() {
+    this.destination = new HubForwarderDestination();
+    await this.destination.initialize();
+    this.destination.setStatusLogger(this.ctx.logger);
+    const broker = this.ctx.kernel.cluster?.broker;
+    if (broker) {
+      this.destination.connectBroker(broker);
+    } else {
+      this.ctx.logger.warn("cluster.broker not available \u2014 hub forwarding disabled, console only");
+    }
+    this.ctx.logger.info("Hub forwarder log destination registered");
+    return [{ capability: import_types.logDestinationCapability, provider: this.destination }];
+  }
+  getDestination() {
+    return this.destination;
+  }
+  async onShutdown() {
+    await this.destination?.shutdown();
+    this.destination = null;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HubForwarderAddon,
+  HubForwarderDestination
+});
+//# sourceMappingURL=index.js.map

package/dist/builtins/hub-forwarder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/builtins/hub-forwarder/index.ts","../../../src/builtins/hub-forwarder/hub-forwarder.addon.ts","../../../src/logging/formatter.ts","../../../src/builtins/hub-forwarder/hub-forwarder-destination.ts"],"sourcesContent":["export { HubForwarderAddon } from './hub-forwarder.addon.js'\nexport { HubForwarderAddon as default } from './hub-forwarder.addon.js'\nexport { HubForwarderDestination } from './hub-forwarder-destination.js'\n","import type { ProviderRegistration } from '@camstack/types'\nimport { BaseAddon, logDestinationCapability } from '@camstack/types'\nimport { HubForwarderDestination } from './hub-forwarder-destination.js'\n\n/**\n * Agent-only addon that provides the `log-destination` capability.\n * Writes all logs to the console and forwards to the hub via Moleculer when\n * reachable. The broker is read from `ctx.kernel.cluster?.broker`; outbound\n * log replay on hub-connect is handled internally by the destination.\n */\nexport class HubForwarderAddon extends BaseAddon {\n  private destination: HubForwarderDestination | null = null\n\n  constructor() { super({}) }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    this.destination = new HubForwarderDestination()\n    await this.destination.initialize()\n    // Status messages (discovery, disconnect) go through ctx.logger so they\n    // appear in the structured log stream, not raw stdout.\n    this.destination.setStatusLogger(this.ctx.logger)\n\n    // Self-wire the broker when the kernel exposes one (agent + hub processes).\n    // In-process unit tests may omit it — logs still go to the console.\n    const broker = this.ctx.kernel.cluster?.broker\n    if (broker) {\n      this.destination.connectBroker(broker)\n    } else {\n      this.ctx.logger.warn('cluster.broker not available — hub forwarding disabled, console only')\n    }\n\n    this.ctx.logger.info('Hub forwarder log destination registered')\n    return [{ capability: logDestinationCapability, provider: this.destination }]\n  }\n\n  getDestination(): HubForwarderDestination | null {\n    return this.destination\n  }\n\n  protected async onShutdown(): Promise<void> {\n    await this.destination?.shutdown()\n    this.destination = 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","import type { IClusterBroker, ILogDestination, IScopedLogger, LogEntry, LogFilter } from '@camstack/types'\nimport { formatLogLine } from '../../logging/formatter.js'\n\nconst DEFAULT_OUTBOUND_BUFFER_SIZE = 500\n\n/**\n * Log destination for agent mode.\n *\n * - Writes to console ONLY when hub is not yet reachable (cold-start\n *   fallback). Forked-worker agents share stdout with their parent\n *   hub, so logging to local console AND forwarding to hub's\n *   `log-receiver` would print the entry twice on the hub terminal.\n *   Once the hub is discovered, local console output stops and the\n *   hub's own ConsoleDestination owns the render.\n * - When a Moleculer broker is connected and the hub node is reachable,\n *   forwards every log entry to the hub via `log-receiver.ingest`.\n * - Entries written before the hub is reachable are buffered internally\n *   (ring-buffered to `DEFAULT_OUTBOUND_BUFFER_SIZE`) and flushed on connect,\n *   so boot-time logs still reach the hub without any external replay trigger.\n */\nexport class HubForwarderDestination implements ILogDestination {\n  private broker: IClusterBroker | null = null\n  private hubConnected = false\n  private readonly outboundBuffer: LogEntry[] = []\n  private statusLogger: IScopedLogger | null = null\n\n  async initialize(): Promise<void> {\n    // Console destination is always active — no setup needed.\n  }\n\n  /**\n   * Provide a logger for the destination's own status messages\n   * (discovery, disconnect, reconnect). Routed through the agent's\n   * LogManager but never through this same destination — the owning\n   * addon must hand in a logger that does NOT route back here, or\n   * status writes will recurse.\n   */\n  setStatusLogger(logger: IScopedLogger): void {\n    this.statusLogger = logger\n  }\n\n  private status(level: 'info' | 'warn', msg: string): void {\n    if (this.statusLogger) {\n      if (level === 'warn') this.statusLogger.warn(msg)\n      else this.statusLogger.info(msg)\n      return\n    }\n    // Cold-start fallback: status logger not yet wired.\n    if (level === 'warn') console.warn(`[hub-forwarder] ${msg}`)\n    else console.log(`[hub-forwarder] ${msg}`)\n  }\n\n  /**\n   * Attach the Moleculer broker so hub forwarding can start.\n   * Called by the owning addon from `onInitialize(ctx)` with\n   * `ctx.kernel.cluster?.broker`.\n   */\n  connectBroker(broker: IClusterBroker): void {\n    this.broker = broker\n\n    // Wait for `log-receiver` service (no timeout — waits until available).\n    // The service is registered on the hub after app.init(), so it may\n    // appear after node discovery. This is fully event-driven.\n    broker.waitForServices('log-receiver')\n      .then(() => {\n        this.hubConnected = true\n        this.status('info', 'log-receiver discovered — log forwarding active')\n        this.flushOutbound()\n      })\n      .catch(() => { /* broker stopped before discovery */ })\n\n    broker.localBus.on('$node.disconnected', ({ node }) => {\n      if (node.id === 'hub') {\n        this.hubConnected = false\n        this.status('info', 'Hub disconnected — log forwarding paused')\n        // Re-wait for reconnect\n        broker.waitForServices('log-receiver')\n          .then(() => {\n            this.hubConnected = true\n            this.status('info', 'Hub reconnected — log forwarding resumed')\n            this.flushOutbound()\n          })\n          .catch(() => { /* broker stopped */ })\n      }\n    })\n  }\n\n  write(entry: LogEntry): void {\n    // 1. Forward to hub when connected, otherwise buffer for flush-on-connect.\n    if (this.hubConnected && this.broker) {\n      this.forward(entry)\n      return\n    }\n    this.bufferOutbound(entry)\n\n    // 2. Local console output ONLY as a cold-start fallback. Forked-worker\n    //    stdout is already piped to the hub's terminal; once the hub\n    //    ingests our forwarded entry it renders it there. Printing\n    //    locally would show the same line twice.\n    const line = formatLogLine(entry, { colorize: true })\n    if (entry.level === 'error') console.error(line)\n    else if (entry.level === 'warn') console.warn(line)\n    else console.log(line)\n  }\n\n  async query(_filter: LogFilter): Promise<readonly LogEntry[]> {\n    // Agent does not support log queries — hub holds the queryable store.\n    return []\n  }\n\n  async shutdown(): Promise<void> {\n    this.hubConnected = false\n    this.broker = null\n    this.outboundBuffer.length = 0\n  }\n\n  private bufferOutbound(entry: LogEntry): void {\n    this.outboundBuffer.push(entry)\n    // Ring-buffer: drop oldest entries once we're past the cap so the\n    // outbound buffer never grows without bound.\n    if (this.outboundBuffer.length > DEFAULT_OUTBOUND_BUFFER_SIZE) {\n      this.outboundBuffer.splice(0, this.outboundBuffer.length - DEFAULT_OUTBOUND_BUFFER_SIZE)\n    }\n  }\n\n  private flushOutbound(): void {\n    if (!this.broker || !this.hubConnected) return\n    const pending = this.outboundBuffer.splice(0, this.outboundBuffer.length)\n    for (const entry of pending) {\n      this.forward(entry)\n    }\n  }\n\n  private forward(entry: LogEntry): void {\n    if (!this.broker) return\n    this.broker.call('log-receiver.ingest', {\n      level: entry.level,\n      message: entry.message,\n      addonId: entry.tags?.addonId ?? 'agent',\n      nodeId: entry.tags?.nodeId ?? this.broker.nodeID,\n      ...(entry.scope !== undefined ? { scope: entry.scope } : {}),\n      ...(entry.tags ? { tags: entry.tags } : {}),\n      ...(entry.meta ? { meta: entry.meta } : {}),\n    }).catch(() => {\n      // Hub unreachable — silently drop. Will resume on reconnect.\n    })\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/builtins/hub-forwarder/index.mjs

@@ -0,0 +1,11 @@
+import {
+  HubForwarderAddon,
+  HubForwarderDestination
+} from "../../chunk-QX4RH25I.mjs";
+import "../../chunk-2F76X6NL.mjs";
+export {
+  HubForwarderAddon,
+  HubForwarderDestination,
+  HubForwarderAddon as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/builtins/hub-forwarder/index.mjs.map

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