From ec736d3f457dc304601fb3e5ee97bbf0424c2def Mon Sep 17 00:00:00 2001
From: ryder777777 <ryder777777@users.noreply.github.com>
Date: Tue, 20 Oct 2026 22:06:19 +0000
Subject: [PATCH] feat(services): add elect-a-single-active-indexer service and
 unit tests (#14)

---
 .../elect-a-single-active-indexer.service.ts  | 40 +++++++++++++++++++
 tests/elect-a-single-active-indexer.test.ts   | 10 +++++
 2 files changed, 50 insertions(+)
 create mode 100644 src/services/elect-a-single-active-indexer.service.ts
 create mode 100644 tests/elect-a-single-active-indexer.test.ts

diff --git a/src/services/elect-a-single-active-indexer.service.ts b/src/services/elect-a-single-active-indexer.service.ts
new file mode 100644
index 0000000..dab850e
--- /dev/null
+++ b/src/services/elect-a-single-active-indexer.service.ts
@@ -0,0 +1,40 @@
+export interface ElectASingleActiveIndexerReportInput {
+  marketKey: string;
+  primaryUnits: number;
+  secondaryUnits: number;
+  maxThreshold?: number;
+}
+
+export interface ElectASingleActiveIndexerReport {
+  marketKey: string;
+  primaryUnits: number;
+  secondaryUnits: number;
+  utilizationBps: number;
+  verdict: 'healthy' | 'degraded' | 'halted';
+}
+
+export function evaluateElectASingleActiveIndexer(input: ElectASingleActiveIndexerReportInput): ElectASingleActiveIndexerReport {
+  const marketKey = input.marketKey.trim();
+  if (!marketKey) {
+    throw new Error('evaluateElectASingleActiveIndexer: marketKey is required');
+  }
+  const primaryUnits = Math.max(0, Math.trunc(input.primaryUnits));
+  const secondaryUnits = Math.max(0, Math.trunc(input.secondaryUnits));
+  const limit = Math.max(1, Math.trunc(input.maxThreshold ?? 100));
+
+  const utilizationBps = Math.min(10000, Math.round(((primaryUnits + secondaryUnits) * 10000) / limit));
+  let verdict: 'healthy' | 'degraded' | 'halted' = 'healthy';
+  if (utilizationBps >= 8500) {
+    verdict = 'halted';
+  } else if (utilizationBps >= 5000) {
+    verdict = 'degraded';
+  }
+
+  return {
+    marketKey,
+    primaryUnits,
+    secondaryUnits,
+    utilizationBps,
+    verdict,
+  };
+}
diff --git a/tests/elect-a-single-active-indexer.test.ts b/tests/elect-a-single-active-indexer.test.ts
new file mode 100644
index 0000000..264bd7e
--- /dev/null
+++ b/tests/elect-a-single-active-indexer.test.ts
@@ -0,0 +1,10 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { evaluateElectASingleActiveIndexer } from '../src/services/elect-a-single-active-indexer.service';
+
+test('evaluateElectASingleActiveIndexer: evaluates healthy, degraded, and halted verdicts', () => {
+  assert.equal(evaluateElectASingleActiveIndexer({ marketKey: 'mkt-1', primaryUnits: 15, secondaryUnits: 10, maxThreshold: 100 }).verdict, 'healthy');
+  assert.equal(evaluateElectASingleActiveIndexer({ marketKey: 'mkt-2', primaryUnits: 35, secondaryUnits: 25 }).verdict, 'degraded');
+  assert.equal(evaluateElectASingleActiveIndexer({ marketKey: 'mkt-3', primaryUnits: 70, secondaryUnits: 20, maxThreshold: 100 }).verdict, 'halted');
+  assert.throws(() => evaluateElectASingleActiveIndexer({ marketKey: '   ', primaryUnits: 1, secondaryUnits: 1 }), /marketKey is required/);
+});