@camstack/core 0.1.15 → 0.1.17

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

@@ -1,11 +1,147 @@
-import {
-  HubForwarderAddon,
-  HubForwarderDestination
-} from "../../chunk-QX4RH25I.mjs";
-import "../../chunk-2F76X6NL.mjs";
-export {
-  HubForwarderAddon,
-  HubForwarderDestination,
-  HubForwarderAddon as default
+import { t as formatLogLine } from "../../formatter-C-5An4Bl.mjs";
+import { BaseAddon, logDestinationCapability } from "@camstack/types";
+//#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
+var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
+/**
+* Log destination for agent mode.
+*
+* - Writes to console ONLY when hub is not yet reachable (cold-start
+*   fallback). Forked-worker agents share stdout with their parent
+*   hub, so logging to local console AND forwarding to hub's
+*   `log-receiver` would print the entry twice on the hub terminal.
+*   Once the hub is discovered, local console output stops and the
+*   hub's own ConsoleDestination owns the render.
+* - When a Moleculer broker is connected and the hub node is reachable,
+*   forwards every log entry to the hub via `log-receiver.ingest`.
+* - Entries written before the hub is reachable are buffered internally
+*   (ring-buffered to `DEFAULT_OUTBOUND_BUFFER_SIZE`) and flushed on connect,
+*   so boot-time logs still reach the hub without any external replay trigger.
+*/
+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 — log forwarding active");
+			this.flushOutbound();
+		}).catch(() => {});
+		broker.localBus.on("$node.disconnected", ({ node }) => {
+			if (node.id === "hub") {
+				this.hubConnected = false;
+				this.status("info", "Hub disconnected — log forwarding paused");
+				broker.waitForServices("log-receiver").then(() => {
+					this.hubConnected = true;
+					this.status("info", "Hub reconnected — 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(() => {});
+	}
 };
+//#endregion
+//#region src/builtins/hub-forwarder/hub-forwarder.addon.ts
+/**
+* Agent-only addon that provides the `log-destination` capability.
+* Writes all logs to the console and forwards to the hub via Moleculer when
+* reachable. The broker is read from `ctx.kernel.cluster?.broker`; outbound
+* log replay on hub-connect is handled internally by the destination.
+*/
+var HubForwarderAddon = class extends 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 — hub forwarding disabled, console only");
+		this.ctx.logger.info("Hub forwarder log destination registered");
+		return [{
+			capability: logDestinationCapability,
+			provider: this.destination
+		}];
+	}
+	getDestination() {
+		return this.destination;
+	}
+	async onShutdown() {
+		await this.destination?.shutdown();
+		this.destination = null;
+	}
+};
+//#endregion
+export { HubForwarderAddon, HubForwarderAddon as default, HubForwarderDestination };
+
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/builtins/hub-forwarder/hub-forwarder-destination.ts","../../../src/builtins/hub-forwarder/hub-forwarder.addon.ts"],"sourcesContent":["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","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"],"mappings":"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"}

package/dist/builtins/local-auth/auth-schema.d.ts

@@ -0,0 +1,12 @@
+import { SettingsStoreClient } from '@camstack/types';
+export declare const USERS_COLLECTION = "users";
+export declare const API_KEYS_COLLECTION = "api_keys";
+export declare const SCOPED_TOKENS_COLLECTION = "scoped_tokens";
+/**
+ * Declare every auth collection with the typed schema. Called by
+ * `LocalAuthAddon.onInitialize` before constructing the per-collection
+ * managers. Idempotent — `declareCollection` is a no-op when the
+ * collection has already been declared (same shape).
+ */
+export declare function declareAuthSchema(store: SettingsStoreClient): Promise<void>;
+//# sourceMappingURL=auth-schema.d.ts.map

package/dist/builtins/local-auth/auth-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-schema.d.ts","sourceRoot":"","sources":["../../../src/builtins/local-auth/auth-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,eAAO,MAAM,gBAAgB,UAAU,CAAA;AACvC,eAAO,MAAM,mBAAmB,aAAa,CAAA;AAC7C,eAAO,MAAM,wBAAwB,kBAAkB,CAAA;AAqCvD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBjF"}

package/dist/builtins/local-auth/index.d.ts

@@ -0,0 +1,2 @@
+export { LocalAuthAddon } from './local-auth.addon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/local-auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/local-auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA"}