From 39bc4c39ed8394fe5955a8741c2c5a908cc33c88 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 retry-failed-indexer-side-effects service
 and unit tests (#13)

---
 ...try-failed-indexer-side-effects.service.ts | 40 +++++++++++++++++++
 .../retry-failed-indexer-side-effects.test.ts | 10 +++++
 2 files changed, 50 insertions(+)
 create mode 100644 src/services/retry-failed-indexer-side-effects.service.ts
 create mode 100644 tests/retry-failed-indexer-side-effects.test.ts

diff --git a/src/services/retry-failed-indexer-side-effects.service.ts b/src/services/retry-failed-indexer-side-effects.service.ts
new file mode 100644
index 0000000..d34a603
--- /dev/null
+++ b/src/services/retry-failed-indexer-side-effects.service.ts
@@ -0,0 +1,40 @@
+export interface RetryFailedIndexerSideEffectsReportInput {
+  marketKey: string;
+  primaryUnits: number;
+  secondaryUnits: number;
+  maxThreshold?: number;
+}
+
+export interface RetryFailedIndexerSideEffectsReport {
+  marketKey: string;
+  primaryUnits: number;
+  secondaryUnits: number;
+  utilizationBps: number;
+  verdict: 'healthy' | 'degraded' | 'halted';
+}
+
+export function evaluateRetryFailedIndexerSideEffects(input: RetryFailedIndexerSideEffectsReportInput): RetryFailedIndexerSideEffectsReport {
+  const marketKey = input.marketKey.trim();
+  if (!marketKey) {
+    throw new Error('evaluateRetryFailedIndexerSideEffects: 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/retry-failed-indexer-side-effects.test.ts b/tests/retry-failed-indexer-side-effects.test.ts
new file mode 100644
index 0000000..de0c52f
--- /dev/null
+++ b/tests/retry-failed-indexer-side-effects.test.ts
@@ -0,0 +1,10 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { evaluateRetryFailedIndexerSideEffects } from '../src/services/retry-failed-indexer-side-effects.service';
+
+test('evaluateRetryFailedIndexerSideEffects: evaluates healthy, degraded, and halted verdicts', () => {
+  assert.equal(evaluateRetryFailedIndexerSideEffects({ marketKey: 'mkt-1', primaryUnits: 15, secondaryUnits: 10, maxThreshold: 100 }).verdict, 'healthy');
+  assert.equal(evaluateRetryFailedIndexerSideEffects({ marketKey: 'mkt-2', primaryUnits: 35, secondaryUnits: 25 }).verdict, 'degraded');
+  assert.equal(evaluateRetryFailedIndexerSideEffects({ marketKey: 'mkt-3', primaryUnits: 70, secondaryUnits: 20, maxThreshold: 100 }).verdict, 'halted');
+  assert.throws(() => evaluateRetryFailedIndexerSideEffects({ marketKey: '   ', primaryUnits: 1, secondaryUnits: 1 }), /marketKey is required/);
+});