@helyx/module-reactionroles 1.0.15 → 1.0.18

package/dist/health.js

@@ -0,0 +1,85 @@
+import { HELYX_SERVICE_NAMES, } from "@helyx/sdk";
+const REQUIRED_SERVICES = [
+    HELYX_SERVICE_NAMES.audit,
+    HELYX_SERVICE_NAMES.discordOwnedMessages,
+    HELYX_SERVICE_NAMES.discordResources,
+    HELYX_SERVICE_NAMES.memberRoles,
+    HELYX_SERVICE_NAMES.messageBuilder,
+    HELYX_SERVICE_NAMES.rateLimits,
+    HELYX_SERVICE_NAMES.records,
+    HELYX_SERVICE_NAMES.scheduledTasks,
+    HELYX_SERVICE_NAMES.sessions,
+];
+export class ReactionRolesHealthTracker {
+    #started = false;
+    #services = null;
+    #primaryFailures = new Set();
+    #cacheWarmFailed = false;
+    #cacheSaturated = false;
+    #cleanupFailures = 0;
+    start(context) {
+        this.#started = true;
+        this.#services = context.services;
+        this.#primaryFailures.clear();
+        this.#cacheWarmFailed = false;
+        this.#cacheSaturated = false;
+        this.#cleanupFailures = 0;
+    }
+    startupResult(input) {
+        this.#cacheWarmFailed = input.cacheWarmFailed === true;
+        this.#cacheSaturated = input.cacheSaturated === true;
+        this.#cleanupFailures = input.cleanupFailures ?? 0;
+    }
+    primarySuccess(source = "resource") {
+        this.#primaryFailures.delete(source);
+    }
+    primaryFailure(source = "resource") {
+        this.#primaryFailures.add(source);
+    }
+    cleanupRecovered() {
+        if (this.#cleanupFailures > 0)
+            this.#cleanupFailures -= 1;
+    }
+    stop() {
+        this.#started = false;
+        this.#services = null;
+        this.#primaryFailures.clear();
+        this.#cacheWarmFailed = false;
+        this.#cacheSaturated = false;
+        this.#cleanupFailures = 0;
+    }
+    health() {
+        if (!this.#started)
+            return {
+                status: "unhealthy",
+                message: "Reaction Roles is not started",
+            };
+        if (!this.#services ||
+            !REQUIRED_SERVICES.every((name) => this.#services?.has(name)))
+            return {
+                status: "unhealthy",
+                message: "Reaction Roles required services are unavailable",
+            };
+        if (this.#primaryFailures.size > 0)
+            return {
+                status: "unhealthy",
+                message: "A recent Reaction Roles operation failed",
+            };
+        if (this.#cacheWarmFailed)
+            return {
+                status: "degraded",
+                message: "Reaction Roles is using cold panel lookups",
+            };
+        if (this.#cacheSaturated)
+            return {
+                status: "degraded",
+                message: "Reaction Roles reached its bounded panel cache capacity",
+            };
+        if (this.#cleanupFailures > 0)
+            return {
+                status: "degraded",
+                message: "Reaction Roles has pending owned-message cleanup",
+            };
+        return { status: "healthy", message: "Reaction Roles is ready" };
+    }
+}