From 519ffd59d45896d25363aa2dfaaa9de84c53c56d Mon Sep 17 00:00:00 2001
From: Gustavo Madeira Santana <gumadeiras@gmail.com>
Date: Sat, 14 Feb 2026 14:54:52 -0500
Subject: [PATCH] test: annotate web monitor inbox harness mocks

---
 src/web/monitor-inbox.test-harness.ts | 33 +++++++++++++++++++++------
 1 file changed, 26 insertions(+), 7 deletions(-)

diff --git a/src/web/monitor-inbox.test-harness.ts b/src/web/monitor-inbox.test-harness.ts
index 3237c3774..27602f83a 100644
--- a/src/web/monitor-inbox.test-harness.ts
+++ b/src/web/monitor-inbox.test-harness.ts
@@ -3,6 +3,7 @@ import fsSync from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { afterEach, beforeEach, vi } from "vitest";
+import type { MockFn } from "../test-utils/vitest-mock-fn.js";
 import { resetLogger, setLoggerOverride } from "../logging.js";
 
 export const DEFAULT_ACCOUNT_ID = "default";
@@ -20,16 +21,34 @@ export const DEFAULT_WEB_INBOX_CONFIG = {
   },
 } as const;
 
-export const mockLoadConfig = vi.fn().mockReturnValue(DEFAULT_WEB_INBOX_CONFIG);
-
-export const readAllowFromStoreMock = vi.fn().mockResolvedValue([]);
-export const upsertPairingRequestMock = vi
+export const mockLoadConfig: MockFn<() => typeof DEFAULT_WEB_INBOX_CONFIG> = vi
   .fn()
-  .mockResolvedValue({ code: "PAIRCODE", created: true });
+  .mockReturnValue(DEFAULT_WEB_INBOX_CONFIG);
 
-export type MockSock = ReturnType<typeof createMockSock>;
+export const readAllowFromStoreMock: MockFn<(...args: unknown[]) => Promise<unknown[]>> = vi
+  .fn()
+  .mockResolvedValue([]);
+export const upsertPairingRequestMock: MockFn<
+  (...args: unknown[]) => Promise<{ code: string; created: boolean }>
+> = vi.fn().mockResolvedValue({ code: "PAIRCODE", created: true });
 
-function createMockSock() {
+export type MockSock = {
+  ev: EventEmitter;
+  ws: { close: MockFn };
+  sendPresenceUpdate: MockFn;
+  sendMessage: MockFn;
+  readMessages: MockFn;
+  updateMediaMessage: MockFn;
+  logger: Record<string, unknown>;
+  signalRepository: {
+    lidMapping: {
+      getPNForLID: MockFn;
+    };
+  };
+  user: { id: string };
+};
+
+function createMockSock(): MockSock {
   const ev = new EventEmitter();
   return {
     ev,