@camstack/core 0.1.15 → 0.1.16

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,9 +1,194 @@
-import {
-  AddonWidgetsAggregatorAddon,
-  addon_widgets_aggregator_addon_default
-} from "../../chunk-ED57RCQE.mjs";
-export {
-  AddonWidgetsAggregatorAddon,
-  addon_widgets_aggregator_addon_default as default
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { randomUUID } from "node:crypto";
+import { BaseAddon, EventCategory, addonWidgetsCapability, errMsg } from "@camstack/types";
+//#region src/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.ts
+/**
+* Addon Widgets Aggregator — hub-local builtin that owns the singleton
+* `addon-widgets` cap.
+*
+* Mirrors `addon-pages-aggregator` exactly: walks every registered
+* `addon-widgets-source` (collection) provider and emits an enriched
+* widget metadata list with versioned `bundleUrl`s pointing at
+* `/api/addon-widgets/<addonId>/<bundle>?v=<mtime>`. The filesystem
+* `mtime` cache-buster lets the browser pick up addon rebuilds without
+* manual reload.
+*
+* The static file endpoint (`/api/addon-widgets/:addonId/*`) is served
+* by `AddonWidgetsService.resolveBundle()` on the server side; this
+* addon only owns the listing surface.
+*
+* Why a builtin: same reasoning as `addon-pages-aggregator`. The
+* aggregator is the de-facto "addon-widgets provider" — addons own caps,
+* not the server. Living in `@camstack/core/builtins` keeps the surface
+* symmetrical with `system-config`, `local-auth`, etc.
+*/
+/**
+* Backoff schedule (ms) used to retry sources that failed during a
+* `listWidgets()` round-trip — typically because the cap was just
+* registered (provider connected via Moleculer) but the worker-side
+* action registration hadn't propagated yet, so `Service '...listWidgets'
+* is not found on '<node>'` raced ahead of the call.
+*
+* On success we re-emit `AddonWidgetReady` so admin-ui invalidates its
+* `addonWidgets.listWidgets` query and the registry populates without a
+* page reload.
+*/
+var RETRY_BACKOFF_MS = [
+	500,
+	1500,
+	4e3
+];
+var AddonWidgetsAggregatorAddon = class extends BaseAddon {
+	id = "addon-widgets-aggregator";
+	resolvedPaths = null;
+	/**
+	* Last successful `listWidgets()` snapshot per source. Used as the
+	* "stale-but-valid" fallback when a source transiently fails — drops
+	* happen often enough during boot (Moleculer service-discovery
+	* window) that swallowing the error and returning empty would leave
+	* the dashboard with nothing for several seconds. Keeping the
+	* previous good entry means a flake is invisible to the operator.
+	*/
+	lastGood = /* @__PURE__ */ new Map();
+	/** In-flight retry guards keyed by sourceAddonId. Avoids double-scheduling. */
+	retryTimers = /* @__PURE__ */ new Map();
+	constructor() {
+		super({});
+	}
+	async onInitialize() {
+		this.resolvedPaths = await this.resolvePaths();
+		const provider = { listWidgets: async () => this.aggregate() };
+		this.ctx.logger.info("Initialized — aggregating addon-widgets-source providers");
+		return [{
+			capability: addonWidgetsCapability,
+			provider
+		}];
+	}
+	async onShutdown() {
+		for (const t of this.retryTimers.values()) clearTimeout(t);
+		this.retryTimers.clear();
+		this.lastGood.clear();
+	}
+	async aggregate() {
+		const entries = this.capabilities?.getCollectionEntries("addon-widgets-source") ?? [];
+		const out = [];
+		const seenIds = /* @__PURE__ */ new Set();
+		for (const [addonId, source] of entries) {
+			seenIds.add(addonId);
+			try {
+				const enriched = (await Promise.resolve(source.listWidgets())).map((w) => ({
+					...w,
+					addonId,
+					bundleUrl: this.makeBundleUrl(addonId, w.bundle)
+				}));
+				for (const item of enriched) out.push(item);
+				this.lastGood.set(addonId, enriched);
+			} catch (err) {
+				const message = errMsg(err);
+				this.ctx.logger.warn("addon-widgets-source provider failed", { meta: {
+					sourceId: addonId,
+					error: message
+				} });
+				const cached = this.lastGood.get(addonId);
+				if (cached !== void 0) {
+					for (const item of cached) out.push(item);
+					this.ctx.logger.info("addon-widgets-source falling back to cached snapshot", { meta: {
+						sourceId: addonId,
+						cachedWidgets: cached.length
+					} });
+				}
+				this.scheduleRetry(addonId);
+			}
+		}
+		for (const cachedId of this.lastGood.keys()) if (!seenIds.has(cachedId)) this.lastGood.delete(cachedId);
+		return out;
+	}
+	scheduleRetry(sourceId, attempt = 0) {
+		if (attempt >= RETRY_BACKOFF_MS.length) return;
+		if (this.retryTimers.has(sourceId)) return;
+		const delayMs = RETRY_BACKOFF_MS[attempt] ?? RETRY_BACKOFF_MS[RETRY_BACKOFF_MS.length - 1];
+		const timer = setTimeout(() => {
+			this.retryTimers.delete(sourceId);
+			this.retrySource(sourceId, attempt);
+		}, delayMs);
+		this.retryTimers.set(sourceId, timer);
+	}
+	async retrySource(sourceId, attempt) {
+		const found = (this.capabilities?.getCollectionEntries("addon-widgets-source") ?? []).find(([id]) => id === sourceId);
+		if (!found) return;
+		const [addonId, source] = found;
+		try {
+			const enriched = (await Promise.resolve(source.listWidgets())).map((w) => ({
+				...w,
+				addonId,
+				bundleUrl: this.makeBundleUrl(addonId, w.bundle)
+			}));
+			this.lastGood.set(addonId, enriched);
+			this.ctx.logger.info("addon-widgets-source recovered after retry", { meta: {
+				sourceId: addonId,
+				attempt: attempt + 1,
+				widgets: enriched.length
+			} });
+			this.ctx.eventBus.emit({
+				id: randomUUID(),
+				timestamp: /* @__PURE__ */ new Date(),
+				source: {
+					type: "addon",
+					id: this.id
+				},
+				category: EventCategory.AddonWidgetReady,
+				data: {
+					addonId,
+					recovered: true
+				}
+			});
+		} catch (err) {
+			this.ctx.logger.debug("addon-widgets-source retry failed", { meta: {
+				sourceId,
+				attempt: attempt + 1,
+				error: errMsg(err)
+			} });
+			this.scheduleRetry(sourceId, attempt + 1);
+		}
+	}
+	/**
+	* Build `/api/addon-widgets/<addonId>/<bundle>?v=<mtime>`. Falls back
+	* to `Date.now()` when the bundle path can't be stat'd (remote addon
+	* with no local file, addon not yet on disk, etc.) — the browser
+	* just gets a fresh URL on each call instead of cache-friendly mtime.
+	*/
+	makeBundleUrl(addonId, bundle) {
+		const bundlePath = this.resolveBundlePath(addonId, bundle);
+		let mtime = Date.now();
+		if (bundlePath !== null) try {
+			mtime = fs.statSync(bundlePath).mtimeMs;
+		} catch {}
+		return `/api/addon-widgets/${addonId}/${bundle}?v=${Math.floor(mtime)}`;
+	}
+	resolveBundlePath(addonId, bundle) {
+		const paths = this.resolvedPaths;
+		if (!paths) return null;
+		const addonDistPath = path.join(paths.addonsDir, "@camstack", `addon-${addonId}`, "dist");
+		const resolvedBase = path.resolve(addonDistPath);
+		const resolvedFile = path.resolve(addonDistPath, bundle);
+		if (!resolvedFile.startsWith(resolvedBase + path.sep) && resolvedFile !== resolvedBase) return null;
+		return resolvedFile;
+	}
+	async resolvePaths() {
+		const fallback = { addonsDir: path.resolve("camstack-data", "addons") };
+		if (!this.ctx.settings) return fallback;
+		try {
+			const server = await this.ctx.settings.getSection("server");
+			const dataPath = typeof server["dataPath"] === "string" && server["dataPath"] ? server["dataPath"] : "camstack-data";
+			return { addonsDir: path.resolve(dataPath, "addons") };
+		} catch (err) {
+			this.ctx.logger.debug("Failed to read server.dataPath — falling back", { meta: { error: errMsg(err) } });
+			return fallback;
+		}
+	}
 };
+//#endregion
+export { AddonWidgetsAggregatorAddon, AddonWidgetsAggregatorAddon as default };
+
 //# sourceMappingURL=addon-widgets-aggregator.addon.mjs.map

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"addon-widgets-aggregator.addon.mjs","names":[],"sources":["../../../src/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.ts"],"sourcesContent":["/**\n * Addon Widgets Aggregator — hub-local builtin that owns the singleton\n * `addon-widgets` cap.\n *\n * Mirrors `addon-pages-aggregator` exactly: walks every registered\n * `addon-widgets-source` (collection) provider and emits an enriched\n * widget metadata list with versioned `bundleUrl`s pointing at\n * `/api/addon-widgets/<addonId>/<bundle>?v=<mtime>`. The filesystem\n * `mtime` cache-buster lets the browser pick up addon rebuilds without\n * manual reload.\n *\n * The static file endpoint (`/api/addon-widgets/:addonId/*`) is served\n * by `AddonWidgetsService.resolveBundle()` on the server side; this\n * addon only owns the listing surface.\n *\n * Why a builtin: same reasoning as `addon-pages-aggregator`. The\n * aggregator is the de-facto \"addon-widgets provider\" — addons own caps,\n * not the server. Living in `@camstack/core/builtins` keeps the surface\n * symmetrical with `system-config`, `local-auth`, etc.\n */\nimport * as path from 'node:path'\nimport * as fs from 'node:fs'\nimport { randomUUID } from 'node:crypto'\nimport {\n  BaseAddon,\n  EventCategory,\n  addonWidgetsCapability,\n  errMsg,\n  type IAddonWidgetsAggregatorProvider,\n  type IAddonWidgetsSourceProvider,\n  type ProviderRegistration,\n} from '@camstack/types'\n\ninterface ResolvedPaths {\n  readonly addonsDir: string\n}\n\n/**\n * Inferred from the cap definition — equivalent to:\n * `z.infer<typeof EnrichedWidgetMetadataSchema>` but reuses the\n * provider's return type so the aggregator stays in lockstep with the\n * cap if its shape evolves.\n */\ntype EnrichedWidget = Awaited<ReturnType<IAddonWidgetsAggregatorProvider['listWidgets']>>[number]\ntype RawWidget = Awaited<ReturnType<IAddonWidgetsSourceProvider['listWidgets']>>[number]\n\n/**\n * Backoff schedule (ms) used to retry sources that failed during a\n * `listWidgets()` round-trip — typically because the cap was just\n * registered (provider connected via Moleculer) but the worker-side\n * action registration hadn't propagated yet, so `Service '...listWidgets'\n * is not found on '<node>'` raced ahead of the call.\n *\n * On success we re-emit `AddonWidgetReady` so admin-ui invalidates its\n * `addonWidgets.listWidgets` query and the registry populates without a\n * page reload.\n */\nconst RETRY_BACKOFF_MS: readonly number[] = [500, 1500, 4000]\n\nexport class AddonWidgetsAggregatorAddon extends BaseAddon {\n  readonly id = 'addon-widgets-aggregator'\n\n  private resolvedPaths: ResolvedPaths | null = null\n\n  /**\n   * Last successful `listWidgets()` snapshot per source. Used as the\n   * \"stale-but-valid\" fallback when a source transiently fails — drops\n   * happen often enough during boot (Moleculer service-discovery\n   * window) that swallowing the error and returning empty would leave\n   * the dashboard with nothing for several seconds. Keeping the\n   * previous good entry means a flake is invisible to the operator.\n   */\n  private readonly lastGood = new Map<string, readonly EnrichedWidget[]>()\n\n  /** In-flight retry guards keyed by sourceAddonId. Avoids double-scheduling. */\n  private readonly retryTimers = new Map<string, NodeJS.Timeout>()\n\n  constructor() { super({}) }\n\n  protected async onInitialize(): Promise<ProviderRegistration[]> {\n    this.resolvedPaths = await this.resolvePaths()\n\n    const provider: IAddonWidgetsAggregatorProvider = {\n      listWidgets: async (): Promise<readonly EnrichedWidget[]> => this.aggregate(),\n    }\n\n    this.ctx.logger.info('Initialized — aggregating addon-widgets-source providers')\n    return [{ capability: addonWidgetsCapability, provider }]\n  }\n\n  protected async onShutdown(): Promise<void> {\n    for (const t of this.retryTimers.values()) clearTimeout(t)\n    this.retryTimers.clear()\n    this.lastGood.clear()\n  }\n\n  // ── Aggregation ───────────────────────────────────────────────────\n\n  private async aggregate(): Promise<readonly EnrichedWidget[]> {\n    // `getCollectionEntries` returns `[addonId, provider]` tuples — the\n    // raw `addon-widgets-source` cap doesn't carry an `id` on the\n    // provider (unlike the legacy `IAddonPageProvider`), so we lean on\n    // the registry to attribute each contribution back to its addon.\n    const entries = this.capabilities?.getCollectionEntries<IAddonWidgetsSourceProvider>('addon-widgets-source') ?? []\n    const out: EnrichedWidget[] = []\n    const seenIds = new Set<string>()\n\n    for (const [addonId, source] of entries) {\n      seenIds.add(addonId)\n      try {\n        const widgets = await Promise.resolve(source.listWidgets())\n        const enriched: EnrichedWidget[] = widgets.map((w: RawWidget) => ({\n          ...w,\n          addonId,\n          bundleUrl: this.makeBundleUrl(addonId, w.bundle),\n        }))\n        for (const item of enriched) out.push(item)\n        // Cache successful snapshot — used as fallback on next failure.\n        this.lastGood.set(addonId, enriched)\n      } catch (err: unknown) {\n        const message = errMsg(err)\n        this.ctx.logger.warn('addon-widgets-source provider failed', {\n          meta: { sourceId: addonId, error: message },\n        })\n        // Fall back to the last-good snapshot for this source so a\n        // transient Moleculer service-discovery race doesn't blank\n        // the dashboard.\n        const cached = this.lastGood.get(addonId)\n        if (cached !== undefined) {\n          for (const item of cached) out.push(item)\n          this.ctx.logger.info('addon-widgets-source falling back to cached snapshot', {\n            meta: { sourceId: addonId, cachedWidgets: cached.length },\n          })\n        }\n        // Schedule a background retry. On success we re-emit\n        // `AddonWidgetReady` so admin-ui's queryClient invalidates and\n        // any newly-loaded widgets show up without a manual reload.\n        this.scheduleRetry(addonId)\n      }\n    }\n\n    // Drop cache entries for sources that have disappeared from the\n    // registry — keeps the fallback aligned with the live collection.\n    for (const cachedId of this.lastGood.keys()) {\n      if (!seenIds.has(cachedId)) this.lastGood.delete(cachedId)\n    }\n\n    return out\n  }\n\n  // ── Retry on transient Moleculer race ─────────────────────────────\n\n  private scheduleRetry(sourceId: string, attempt = 0): void {\n    if (attempt >= RETRY_BACKOFF_MS.length) return\n    if (this.retryTimers.has(sourceId)) return // already pending\n\n    const delayMs = RETRY_BACKOFF_MS[attempt] ?? RETRY_BACKOFF_MS[RETRY_BACKOFF_MS.length - 1]!\n    const timer = setTimeout(() => {\n      this.retryTimers.delete(sourceId)\n      void this.retrySource(sourceId, attempt)\n    }, delayMs)\n    this.retryTimers.set(sourceId, timer)\n  }\n\n  private async retrySource(sourceId: string, attempt: number): Promise<void> {\n    const entries = this.capabilities?.getCollectionEntries<IAddonWidgetsSourceProvider>('addon-widgets-source') ?? []\n    const found = entries.find(([id]) => id === sourceId)\n    if (!found) return // provider went away; nothing to retry\n    const [addonId, source] = found\n\n    try {\n      const widgets = await Promise.resolve(source.listWidgets())\n      const enriched: EnrichedWidget[] = widgets.map((w: RawWidget) => ({\n        ...w,\n        addonId,\n        bundleUrl: this.makeBundleUrl(addonId, w.bundle),\n      }))\n      this.lastGood.set(addonId, enriched)\n      this.ctx.logger.info('addon-widgets-source recovered after retry', {\n        meta: { sourceId: addonId, attempt: attempt + 1, widgets: enriched.length },\n      })\n      // Re-emit AddonWidgetReady so admin-ui invalidates and refetches.\n      this.ctx.eventBus.emit({\n        id: randomUUID(),\n        timestamp: new Date(),\n        source: { type: 'addon', id: this.id },\n        category: EventCategory.AddonWidgetReady,\n        data: { addonId, recovered: true },\n      })\n    } catch (err: unknown) {\n      this.ctx.logger.debug('addon-widgets-source retry failed', {\n        meta: { sourceId, attempt: attempt + 1, error: errMsg(err) },\n      })\n      this.scheduleRetry(sourceId, attempt + 1)\n    }\n  }\n\n  // ── Bundle URL stamping ──────────────────────────────────────────\n\n  /**\n   * Build `/api/addon-widgets/<addonId>/<bundle>?v=<mtime>`. Falls back\n   * to `Date.now()` when the bundle path can't be stat'd (remote addon\n   * with no local file, addon not yet on disk, etc.) — the browser\n   * just gets a fresh URL on each call instead of cache-friendly mtime.\n   */\n  private makeBundleUrl(addonId: string, bundle: string): string {\n    const bundlePath = this.resolveBundlePath(addonId, bundle)\n    let mtime = Date.now()\n    if (bundlePath !== null) {\n      try { mtime = fs.statSync(bundlePath).mtimeMs }\n      catch { /* remote addon — no local file */ }\n    }\n    const v = Math.floor(mtime)\n    return `/api/addon-widgets/${addonId}/${bundle}?v=${v}`\n  }\n\n  private resolveBundlePath(addonId: string, bundle: string): string | null {\n    const paths = this.resolvedPaths\n    if (!paths) return null\n    const addonDistPath = path.join(paths.addonsDir, '@camstack', `addon-${addonId}`, 'dist')\n    const resolvedBase = path.resolve(addonDistPath)\n    const resolvedFile = path.resolve(addonDistPath, bundle)\n    if (!resolvedFile.startsWith(resolvedBase + path.sep) && resolvedFile !== resolvedBase) {\n      return null\n    }\n    return resolvedFile\n  }\n\n  // ── Path resolution ──────────────────────────────────────────────\n\n  private async resolvePaths(): Promise<ResolvedPaths> {\n    const fallback: ResolvedPaths = { addonsDir: path.resolve('camstack-data', 'addons') }\n    if (!this.ctx.settings) return fallback\n    try {\n      const server = await this.ctx.settings.getSection('server')\n      const dataPath = typeof server['dataPath'] === 'string' && server['dataPath']\n        ? server['dataPath']\n        : 'camstack-data'\n      return { addonsDir: path.resolve(dataPath, 'addons') }\n    } catch (err: unknown) {\n      this.ctx.logger.debug('Failed to read server.dataPath — falling back', {\n        meta: { error: errMsg(err) },\n      })\n      return fallback\n    }\n  }\n}\n\nexport default AddonWidgetsAggregatorAddon\n"],"mappings":"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"}

package/dist/builtins/addon-widgets-aggregator/index.d.ts

@@ -0,0 +1,2 @@
+export { AddonWidgetsAggregatorAddon, default } from './addon-widgets-aggregator.addon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/builtins/addon-widgets-aggregator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtins/addon-widgets-aggregator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAA"}

package/dist/builtins/addon-widgets-aggregator/index.js

@@ -1,202 +1,7 @@
-"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/addon-widgets-aggregator/index.ts
-var addon_widgets_aggregator_exports = {};
-__export(addon_widgets_aggregator_exports, {
-  AddonWidgetsAggregatorAddon: () => AddonWidgetsAggregatorAddon,
-  default: () => addon_widgets_aggregator_addon_default
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
 });
-module.exports = __toCommonJS(addon_widgets_aggregator_exports);
-
-// src/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.ts
-var path = __toESM(require("path"));
-var fs = __toESM(require("fs"));
-var import_node_crypto = require("crypto");
-var import_types = require("@camstack/types");
-var RETRY_BACKOFF_MS = [500, 1500, 4e3];
-var AddonWidgetsAggregatorAddon = class extends import_types.BaseAddon {
-  id = "addon-widgets-aggregator";
-  resolvedPaths = null;
-  /**
-   * Last successful `listWidgets()` snapshot per source. Used as the
-   * "stale-but-valid" fallback when a source transiently fails — drops
-   * happen often enough during boot (Moleculer service-discovery
-   * window) that swallowing the error and returning empty would leave
-   * the dashboard with nothing for several seconds. Keeping the
-   * previous good entry means a flake is invisible to the operator.
-   */
-  lastGood = /* @__PURE__ */ new Map();
-  /** In-flight retry guards keyed by sourceAddonId. Avoids double-scheduling. */
-  retryTimers = /* @__PURE__ */ new Map();
-  constructor() {
-    super({});
-  }
-  async onInitialize() {
-    this.resolvedPaths = await this.resolvePaths();
-    const provider = {
-      listWidgets: async () => this.aggregate()
-    };
-    this.ctx.logger.info("Initialized \u2014 aggregating addon-widgets-source providers");
-    return [{ capability: import_types.addonWidgetsCapability, provider }];
-  }
-  async onShutdown() {
-    for (const t of this.retryTimers.values()) clearTimeout(t);
-    this.retryTimers.clear();
-    this.lastGood.clear();
-  }
-  // ── Aggregation ───────────────────────────────────────────────────
-  async aggregate() {
-    const entries = this.capabilities?.getCollectionEntries("addon-widgets-source") ?? [];
-    const out = [];
-    const seenIds = /* @__PURE__ */ new Set();
-    for (const [addonId, source] of entries) {
-      seenIds.add(addonId);
-      try {
-        const widgets = await Promise.resolve(source.listWidgets());
-        const enriched = widgets.map((w) => ({
-          ...w,
-          addonId,
-          bundleUrl: this.makeBundleUrl(addonId, w.bundle)
-        }));
-        for (const item of enriched) out.push(item);
-        this.lastGood.set(addonId, enriched);
-      } catch (err) {
-        const message = (0, import_types.errMsg)(err);
-        this.ctx.logger.warn("addon-widgets-source provider failed", {
-          meta: { sourceId: addonId, error: message }
-        });
-        const cached = this.lastGood.get(addonId);
-        if (cached !== void 0) {
-          for (const item of cached) out.push(item);
-          this.ctx.logger.info("addon-widgets-source falling back to cached snapshot", {
-            meta: { sourceId: addonId, cachedWidgets: cached.length }
-          });
-        }
-        this.scheduleRetry(addonId);
-      }
-    }
-    for (const cachedId of this.lastGood.keys()) {
-      if (!seenIds.has(cachedId)) this.lastGood.delete(cachedId);
-    }
-    return out;
-  }
-  // ── Retry on transient Moleculer race ─────────────────────────────
-  scheduleRetry(sourceId, attempt = 0) {
-    if (attempt >= RETRY_BACKOFF_MS.length) return;
-    if (this.retryTimers.has(sourceId)) return;
-    const delayMs = RETRY_BACKOFF_MS[attempt] ?? RETRY_BACKOFF_MS[RETRY_BACKOFF_MS.length - 1];
-    const timer = setTimeout(() => {
-      this.retryTimers.delete(sourceId);
-      void this.retrySource(sourceId, attempt);
-    }, delayMs);
-    this.retryTimers.set(sourceId, timer);
-  }
-  async retrySource(sourceId, attempt) {
-    const entries = this.capabilities?.getCollectionEntries("addon-widgets-source") ?? [];
-    const found = entries.find(([id]) => id === sourceId);
-    if (!found) return;
-    const [addonId, source] = found;
-    try {
-      const widgets = await Promise.resolve(source.listWidgets());
-      const enriched = widgets.map((w) => ({
-        ...w,
-        addonId,
-        bundleUrl: this.makeBundleUrl(addonId, w.bundle)
-      }));
-      this.lastGood.set(addonId, enriched);
-      this.ctx.logger.info("addon-widgets-source recovered after retry", {
-        meta: { sourceId: addonId, attempt: attempt + 1, widgets: enriched.length }
-      });
-      this.ctx.eventBus.emit({
-        id: (0, import_node_crypto.randomUUID)(),
-        timestamp: /* @__PURE__ */ new Date(),
-        source: { type: "addon", id: this.id },
-        category: import_types.EventCategory.AddonWidgetReady,
-        data: { addonId, recovered: true }
-      });
-    } catch (err) {
-      this.ctx.logger.debug("addon-widgets-source retry failed", {
-        meta: { sourceId, attempt: attempt + 1, error: (0, import_types.errMsg)(err) }
-      });
-      this.scheduleRetry(sourceId, attempt + 1);
-    }
-  }
-  // ── Bundle URL stamping ──────────────────────────────────────────
-  /**
-   * Build `/api/addon-widgets/<addonId>/<bundle>?v=<mtime>`. Falls back
-   * to `Date.now()` when the bundle path can't be stat'd (remote addon
-   * with no local file, addon not yet on disk, etc.) — the browser
-   * just gets a fresh URL on each call instead of cache-friendly mtime.
-   */
-  makeBundleUrl(addonId, bundle) {
-    const bundlePath = this.resolveBundlePath(addonId, bundle);
-    let mtime = Date.now();
-    if (bundlePath !== null) {
-      try {
-        mtime = fs.statSync(bundlePath).mtimeMs;
-      } catch {
-      }
-    }
-    const v = Math.floor(mtime);
-    return `/api/addon-widgets/${addonId}/${bundle}?v=${v}`;
-  }
-  resolveBundlePath(addonId, bundle) {
-    const paths = this.resolvedPaths;
-    if (!paths) return null;
-    const addonDistPath = path.join(paths.addonsDir, "@camstack", `addon-${addonId}`, "dist");
-    const resolvedBase = path.resolve(addonDistPath);
-    const resolvedFile = path.resolve(addonDistPath, bundle);
-    if (!resolvedFile.startsWith(resolvedBase + path.sep) && resolvedFile !== resolvedBase) {
-      return null;
-    }
-    return resolvedFile;
-  }
-  // ── Path resolution ──────────────────────────────────────────────
-  async resolvePaths() {
-    const fallback = { addonsDir: path.resolve("camstack-data", "addons") };
-    if (!this.ctx.settings) return fallback;
-    try {
-      const server = await this.ctx.settings.getSection("server");
-      const dataPath = typeof server["dataPath"] === "string" && server["dataPath"] ? server["dataPath"] : "camstack-data";
-      return { addonsDir: path.resolve(dataPath, "addons") };
-    } catch (err) {
-      this.ctx.logger.debug("Failed to read server.dataPath \u2014 falling back", {
-        meta: { error: (0, import_types.errMsg)(err) }
-      });
-      return fallback;
-    }
-  }
-};
-var addon_widgets_aggregator_addon_default = AddonWidgetsAggregatorAddon;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AddonWidgetsAggregatorAddon
-});
-//# sourceMappingURL=index.js.map
+const require_builtins_addon_widgets_aggregator_addon_widgets_aggregator_addon = require("./addon-widgets-aggregator.addon.js");
+exports.AddonWidgetsAggregatorAddon = require_builtins_addon_widgets_aggregator_addon_widgets_aggregator_addon.AddonWidgetsAggregatorAddon;
+exports.default = require_builtins_addon_widgets_aggregator_addon_widgets_aggregator_addon.AddonWidgetsAggregatorAddon;

package/dist/builtins/addon-widgets-aggregator/index.mjs

@@ -1,9 +1,2 @@
-import {
-  AddonWidgetsAggregatorAddon,
-  addon_widgets_aggregator_addon_default
-} from "../../chunk-ED57RCQE.mjs";
-export {
-  AddonWidgetsAggregatorAddon,
-  addon_widgets_aggregator_addon_default as default
-};
-//# sourceMappingURL=index.mjs.map
+import { AddonWidgetsAggregatorAddon } from "./addon-widgets-aggregator.addon.mjs";
+export { AddonWidgetsAggregatorAddon, AddonWidgetsAggregatorAddon as default };

package/dist/builtins/alerts/alerts.addon.d.ts

@@ -0,0 +1,82 @@
+import { ProviderRegistration, Alert, BaseAddon } from '@camstack/types';
+interface AlertCenterConfig {
+    readonly maxAlerts: number;
+    readonly retentionDays: number;
+}
+/**
+ * Alert Center addon — core builtin that persists alerts in a
+ * structured SQLite table and serves them to the admin UI.
+ *
+ * Registers as an `alerts` collection provider and subscribes to
+ * important EventBus categories to create/update alerts automatically.
+ */
+export declare class AlertCenterAddon extends BaseAddon<AlertCenterConfig> {
+    private unsubscribers;
+    constructor();
+    /**
+     * Per `(category, source.id)` counter used to rate-limit chatty
+     * events. Entries are pruned lazily when they age out of
+     * `RATE_LIMIT_WINDOW_MS`; see `shouldSuppressByRate()` below.
+     */
+    private readonly rateLimitCounters;
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    protected onShutdown(): Promise<void>;
+    protected globalSettingsSchema(): import('@camstack/types').ConfigUISchema;
+    listAlerts(filter?: {
+        unreadOnly?: boolean;
+        limit?: number;
+    }): Promise<readonly Alert[]>;
+    getUnreadCount(): Promise<number>;
+    markRead(alertId: string): Promise<void>;
+    markAllRead(): Promise<void>;
+    dismiss(alertId: string): Promise<void>;
+    private handleEvent;
+    private handleModelDownload;
+    /**
+     * `[ALERT-CENTER-EVENTS]` — rate limit a `(category, source.id)`
+     * tuple. Returns `true` when the caller should DROP this event
+     * without persisting an alert, and `false` when the alert should
+     * proceed normally.
+     *
+     * Heuristic: the first `RATE_LIMIT_MAX_PER_SOURCE` events within a
+     * `RATE_LIMIT_WINDOW_MS` window go through. Once the threshold is
+     * crossed, subsequent events are suppressed until the window rolls
+     * over. When the threshold is first crossed, the suppression is
+     * logged once so operators know why they're not seeing the follow-
+     * up alerts; after the window rolls over the next event is
+     * un-suppressed and starts a new window.
+     */
+    private shouldSuppressByRate;
+    /**
+     * AddonLoadFailed — kernel's AddonHealthMonitor has post-grace
+     * failed an addon load/init. Upsert a stable-id alert keyed by
+     * `addon-load-failed:<packageName>` so the recovery path can
+     * dismiss it. Severity=error, persistent until dismissed or
+     * auto-resolved.
+     *
+     * The action `retry` carries the package name so the admin UI can
+     * dispatch `addons.retryLoad(packageName)` directly from the alert
+     * card without the operator opening the Addons page.
+     */
+    private handleAddonLoadFailed;
+    /**
+     * AddonLoadRecovered — addon previously alerting is back to healthy.
+     * Dismiss the matching alert so the operator's badge count drops.
+     */
+    private handleAddonLoadRecovered;
+    private buildMessage;
+    private emitAlert;
+    private updateAlert;
+    /**
+     * Read-merge-write: SettingsBackend.update() replaces the entire `data` blob,
+     * so we must read the existing record, merge the patch, and write back.
+     */
+    private mergeUpdate;
+    private persistAlert;
+    private emitAlertCreatedEvent;
+    private emitAlertUpdatedEvent;
+    private enforceMaxAlerts;
+    private enforceRetention;
+}
+export default AlertCenterAddon;
+//# sourceMappingURL=alerts.addon.d.ts.map

package/dist/builtins/alerts/alerts.addon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.addon.d.ts","sourceRoot":"","sources":["../../../src/builtins/alerts/alerts.addon.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,KAAK,EAA8B,MAAM,iBAAiB,CAAA;AACxE,OAAO,EAAE,SAAS,EAAuD,MAAM,iBAAiB,CAAA;AA+EhG,UAAU,iBAAiB;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAUD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,iBAAiB,CAAC;IAChE,OAAO,CAAC,aAAa,CAA8B;;IAMnD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmF;cAErG,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;cA2B/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3C,SAAS,CAAC,oBAAoB;IAyBxB,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC;IAkBxF,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAOjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAU/B,WAAW;YAiDX,mBAAmB;IA8DjC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;;;;;;;;;OAUG;YACW,qBAAqB;IAoCnC;;;OAGG;YACW,wBAAwB;IAiBtC,OAAO,CAAC,YAAY;YAmDN,SAAS;YAOT,WAAW;IAKzB;;;OAGG;YACW,WAAW;YAUX,YAAY;IAsB1B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,qBAAqB;YAWf,gBAAgB;YAoBhB,gBAAgB;CAgB/B;AAED,eAAe,gBAAgB,CAAA"}