grafana, tautulli, nextcloud, nodered: full nox modules (ADR 0044/0046)

grafana: status/datasources/dashboards/alerts tools, emits alert.firing. tautulli: activity/history/stats tools, emits watch.recorded. nextcloud: users/shares/apps/occ tools (occ via docker exec, shares over OCS), emits user.created/share.created. nodered: flows/nodes/deploy tools, emits flows.deployed inline from the deploy tool. All typecheck; manifests parse.
2026-09-04 02:43:20 +02:00
parent 1e2a849b90
commit eccfc70991
23 changed files with 897 additions and 2 deletions
@@ -0,0 +1,57 @@
+// nextcloud's events. The tool runtime imports this once the broker is bound. It watches the user
+// list and the share list and announces new arrivals.
+//
+// Emits (novox/hq ADR 0046/0047):
+//   module.nextcloud.user.created    — a user account appeared (occ user:list)
+//   module.nextcloud.share.created   — a share appeared (OCS shares)
+//
+// Both are diffed and primed silently on the first look, so a restart does not re-announce every
+// existing user and share as freshly created.
+
+import { emit } from "@novox/mesh-sdk/events";
+import { NextcloudClient } from "./client.js";
+
+// Constructed lazily so an unconfigured node (no admin password) loads this entrypoint without
+// crashing the events host — it simply watches nothing.
+let nextcloud: NextcloudClient | undefined;
+try {
+  nextcloud = NextcloudClient.fromEnv();
+} catch (err) {
+  console.log(`[nextcloud] not configured, not watching: ${err}`);
+}
+
+const knownUsers = new Set<string>();
+let usersPrimed = false;
+async function pollUsers(client: NextcloudClient): Promise<void> {
+  const users = client.listUsers();
+  for (const u of users) {
+    if (knownUsers.has(u.uid)) continue;
+    if (usersPrimed) await emit("module.nextcloud.user.created", { uid: u.uid, displayName: u.displayName });
+    knownUsers.add(u.uid);
+  }
+  usersPrimed = true;
+}
+
+const knownShares = new Set<string>();
+let sharesPrimed = false;
+async function pollShares(client: NextcloudClient): Promise<void> {
+  const shares = await client.listShares();
+  for (const s of shares) {
+    if (knownShares.has(s.id)) continue;
+    if (sharesPrimed) await emit("module.nextcloud.share.created", { id: s.id, path: s.path, shareType: s.shareType, shareWith: s.shareWith, owner: s.owner });
+    knownShares.add(s.id);
+  }
+  sharesPrimed = true;
+}
+
+if (nextcloud) {
+  const client = nextcloud;
+  const tick = (fn: (c: NextcloudClient) => Promise<void>): void => {
+    const run = (): void => void fn(client).catch((err) => console.error(`[nextcloud] ${err}`));
+    setInterval(run, 60_000);
+    run();
+  };
+  tick(pollUsers);
+  tick(pollShares);
+  console.log("[nextcloud] watching users and shares");
+}