@camstack/server 1.2.102 → 1.2.104

package/dist/core/addon/addon-registry.service.js

@@ -94,6 +94,9 @@ function isSettingsStore(backend) {
         'getAddonDevice',
         'setAddonDevice',
         'clearAddonDevice',
+        'getDeviceRuntimeState',
+        'setDeviceRuntimeState',
+        'clearDeviceRuntimeState',
     ];
     for (const key of required) {
         if (typeof Reflect.get(backend, key) !== 'function')

package/dist/core/agent/cluster-node-history-store.js

@@ -27,6 +27,43 @@ const RowDataSchema = zod_1.z.object({
     descriptor: DescriptorSchema,
 });
 const COLLECTION = 'cluster-node-history';
+/**
+ * How stale `lastActive` may get on an ONLINE node before an otherwise
+ * unchanged snapshot is written anyway. Five minutes turns the 30 s topology
+ * poll's 2,880 writes/node/day into 288 while keeping "last seen" honest to
+ * within one window. Every real transition — descriptor change, disconnect —
+ * is written on its own edge and is not subject to this bound.
+ */
+const LAST_ACTIVE_HEARTBEAT_MS = 5 * 60_000;
+/**
+ * Structural equality over a node descriptor. Every field is a scalar or an
+ * array of scalars/`{name,version}` pairs, so a JSON-shaped deep compare is
+ * exact — and reference equality would be useless here, since the descriptor
+ * is rebuilt from the live Moleculer registry on every poll.
+ */
+function descriptorsEqual(a, b) {
+    return (a.id === b.id &&
+        a.name === b.name &&
+        a.hostname === b.hostname &&
+        a.platform === b.platform &&
+        a.arch === b.arch &&
+        a.cpuModel === b.cpuModel &&
+        a.cpuCores === b.cpuCores &&
+        a.memoryMB === b.memoryMB &&
+        a.isHub === b.isHub &&
+        sameStrings(a.engines, b.engines) &&
+        sameStrings(a.localIps, b.localIps) &&
+        sameStrings(a.addonIds, b.addonIds) &&
+        samePackages(a.packages, b.packages));
+}
+function sameStrings(a, b) {
+    return a.length === b.length && a.every((v, i) => v === b[i]);
+}
+function samePackages(a, b) {
+    if (a === undefined || b === undefined)
+        return a === b;
+    return (a.length === b.length && a.every((p, i) => p.name === b[i]?.name && p.version === b[i]?.version));
+}
 class ClusterNodeHistoryStore {
     resolveSettingsStore;
     logger;
@@ -69,6 +106,19 @@ class ClusterNodeHistoryStore {
      * Upsert a node's descriptor + addon roster while it is ONLINE, stamping
      * `lastActive = Date.now()`. Called on each `listNodes()` refresh for every
      * live node (R2 capture point).
+     *
+     * WRITES ONLY ON A CHANGE, OR ONCE PER {@link LAST_ACTIVE_HEARTBEAT_MS}.
+     * `listNodes()` runs off the 30 s topology heartbeat, so the unconditional
+     * upsert this used to be was the worst write:row ratio in the whole system —
+     * measured on the live hub at ~6 upserts/minute = **8,640 a day to maintain
+     * three rows**, i.e. 40 % of every ledger write on the hub, on the same shfs
+     * SQLite file whose WAL checkpoint can stall hub-main for seconds (D96).
+     *
+     * Nothing is lost. `lastActive` exists to answer "when was this node last
+     * seen", which only matters at OFFLINE resolution — and the disconnect edge
+     * is written by {@link touch}, which is unbounded. The bound costs at most
+     * five minutes of precision on a node that then disappeared without a
+     * `$node.disconnected`, and buys 288 writes/day/node instead of 2,880.
      */
     async snapshot(descriptor) {
         const store = await this.ensureDeclared();
@@ -80,13 +130,13 @@ class ClusterNodeHistoryStore {
             // the back-fill's intended set on the very next topology poll.
             const existing = await this.readRow(store, descriptor.id);
             const packages = descriptor.packages ?? existing?.descriptor.packages;
+            const next = packages === undefined ? descriptor : { ...descriptor, packages };
+            if (existing !== null && !this.worthWriting(existing, next))
+                return;
             await store.set({
                 collection: COLLECTION,
                 key: descriptor.id,
-                value: {
-                    lastActive: Date.now(),
-                    descriptor: packages === undefined ? descriptor : { ...descriptor, packages },
-                },
+                value: { lastActive: Date.now(), descriptor: next },
             });
         }
         catch (err) {
@@ -96,6 +146,16 @@ class ClusterNodeHistoryStore {
             });
         }
     }
+    /**
+     * Is this snapshot worth a commit? Yes when the descriptor CHANGED, or when
+     * the stored `lastActive` has aged past the heartbeat bound. A read that
+     * fails never reaches here — `snapshot` writes when there is no existing row.
+     */
+    worthWriting(existing, next) {
+        if (Date.now() - existing.lastActive >= LAST_ACTIVE_HEARTBEAT_MS)
+            return true;
+        return !descriptorsEqual(existing.descriptor, next);
+    }
     /** Read one node's row, validated. `null` when absent or malformed. */
     async readRow(store, nodeId) {
         const raw = await store.get({ collection: COLLECTION, key: nodeId });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/server",
-  "version": "1.2.102",
+  "version": "1.2.104",
   "private": false,
   "files": [
     "dist",
@@ -33,19 +33,19 @@
     ]
   },
   "dependencies": {
-    "@camstack/addon-admin-ui": "1.2.52",
-    "@camstack/addon-agent-ui": "1.2.15",
-    "@camstack/addon-auth": "1.2.16",
-    "@camstack/addon-decoder-nodeav": "1.2.14",
-    "@camstack/addon-notifiers": "1.2.19",
-    "@camstack/addon-pipeline": "1.2.71",
-    "@camstack/addon-pipeline-orchestrator": "1.2.51",
-    "@camstack/addon-post-analysis": "1.2.68",
-    "@camstack/sdk": "1.2.16",
-    "@camstack/shm-ring": "1.1.14",
-    "@camstack/system": "1.2.86",
-    "@camstack/types": "1.2.65",
-    "@camstack/ui-library": "1.2.44",
+    "@camstack/addon-admin-ui": "1.2.54",
+    "@camstack/addon-agent-ui": "1.2.17",
+    "@camstack/addon-auth": "1.2.18",
+    "@camstack/addon-decoder-nodeav": "1.2.16",
+    "@camstack/addon-notifiers": "1.2.21",
+    "@camstack/addon-pipeline": "1.2.73",
+    "@camstack/addon-pipeline-orchestrator": "1.2.53",
+    "@camstack/addon-post-analysis": "1.2.70",
+    "@camstack/sdk": "1.2.18",
+    "@camstack/shm-ring": "1.1.16",
+    "@camstack/system": "1.2.88",
+    "@camstack/types": "1.2.67",
+    "@camstack/ui-library": "1.2.46",
     "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/cors": "^11.2.0",