refactor(gateway): share gmail watcher startup flow

src/hooks/gmail-watcher-lifecycle.test.ts

@@ -0,0 +1,94 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+const { startGmailWatcherMock } = vi.hoisted(() => ({
+  startGmailWatcherMock: vi.fn(),
+}));
+
+vi.mock("./gmail-watcher.js", () => ({
+  startGmailWatcher: startGmailWatcherMock,
+}));
+
+import { startGmailWatcherWithLogs } from "./gmail-watcher-lifecycle.js";
+
+describe("startGmailWatcherWithLogs", () => {
+  const log = {
+    info: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+  };
+
+  beforeEach(() => {
+    startGmailWatcherMock.mockReset();
+    log.info.mockReset();
+    log.warn.mockReset();
+    log.error.mockReset();
+    delete process.env.OPENCLAW_SKIP_GMAIL_WATCHER;
+  });
+
+  afterEach(() => {
+    delete process.env.OPENCLAW_SKIP_GMAIL_WATCHER;
+  });
+
+  it("logs startup success", async () => {
+    startGmailWatcherMock.mockResolvedValue({ started: true, reason: undefined });
+
+    await startGmailWatcherWithLogs({
+      cfg: {},
+      log,
+    });
+
+    expect(log.info).toHaveBeenCalledWith("gmail watcher started");
+    expect(log.warn).not.toHaveBeenCalled();
+    expect(log.error).not.toHaveBeenCalled();
+  });
+
+  it("logs actionable non-start reason", async () => {
+    startGmailWatcherMock.mockResolvedValue({ started: false, reason: "auth failed" });
+
+    await startGmailWatcherWithLogs({
+      cfg: {},
+      log,
+    });
+
+    expect(log.warn).toHaveBeenCalledWith("gmail watcher not started: auth failed");
+  });
+
+  it("suppresses expected non-start reasons", async () => {
+    startGmailWatcherMock.mockResolvedValue({
+      started: false,
+      reason: "hooks not enabled",
+    });
+
+    await startGmailWatcherWithLogs({
+      cfg: {},
+      log,
+    });
+
+    expect(log.warn).not.toHaveBeenCalled();
+  });
+
+  it("supports skip callback when watcher is disabled", async () => {
+    process.env.OPENCLAW_SKIP_GMAIL_WATCHER = "1";
+    const onSkipped = vi.fn();
+
+    await startGmailWatcherWithLogs({
+      cfg: {},
+      log,
+      onSkipped,
+    });
+
+    expect(startGmailWatcherMock).not.toHaveBeenCalled();
+    expect(onSkipped).toHaveBeenCalledTimes(1);
+  });
+
+  it("logs startup errors", async () => {
+    startGmailWatcherMock.mockRejectedValue(new Error("boom"));
+
+    await startGmailWatcherWithLogs({
+      cfg: {},
+      log,
+    });
+
+    expect(log.error).toHaveBeenCalledWith("gmail watcher failed to start: Error: boom");
+  });
+});