From 09257e39b4fe09de480e90c8fd99e3aba73a886b Mon Sep 17 00:00:00 2001
From: Jay <jay@wisehodl.dev>
Date: Wed, 20 May 2026 08:10:02 -0400
Subject: [PATCH] refactor: add idle watchgod to transport

---
 transport/watchdog.go      |  45 ++++++++++++
 transport/watchdog_test.go | 141 +++++++++++++++++++++++++++++++++++++
 2 files changed, 186 insertions(+)
 create mode 100644 transport/watchdog.go
 create mode 100644 transport/watchdog_test.go

diff --git a/transport/watchdog.go b/transport/watchdog.go
new file mode 100644
index 0000000..79336ad
--- /dev/null
+++ b/transport/watchdog.go
@@ -0,0 +1,45 @@
+package transport
+
+import (
+	"context"
+	"time"
+)
+
+func IdleWatchdog(
+	ctx context.Context,
+	activity <-chan struct{},
+	timeout time.Duration,
+	onTimeout func(),
+) {
+	// disable watchdog timeout if not configured
+	if timeout <= 0 {
+		for {
+			select {
+			case <-activity:
+			case <-ctx.Done():
+				return
+			}
+		}
+	}
+
+	timer := time.NewTimer(timeout)
+	defer timer.Stop()
+
+	for {
+		select {
+		case <-ctx.Done():
+			return
+		case <-activity:
+			if !timer.Stop() {
+				select {
+				case <-timer.C:
+				default:
+				}
+			}
+			timer.Reset(timeout)
+		case <-timer.C:
+			onTimeout()
+			return
+		}
+	}
+}
diff --git a/transport/watchdog_test.go b/transport/watchdog_test.go
new file mode 100644
index 0000000..824b6db
--- /dev/null
+++ b/transport/watchdog_test.go
@@ -0,0 +1,141 @@
+package transport
+
+import (
+	"context"
+	"git.wisehodl.dev/jay/go-honeybee/honeybeetest"
+	"github.com/stretchr/testify/assert"
+	"sync/atomic"
+	"testing"
+	"time"
+)
+
+func TestIdleWatchdog(t *testing.T) {
+	t.Run("heartbeat resets timer, onTimeout not called", func(t *testing.T) {
+		activity := make(chan struct{})
+		ctx, cancel := context.WithCancel(context.Background())
+		defer cancel()
+
+		called := atomic.Bool{}
+		go IdleWatchdog(
+			ctx, activity, 200*time.Millisecond, func() { called.Store(true) },
+		)
+
+		for i := 0; i < 5; i++ {
+			time.Sleep(20 * time.Millisecond)
+			activity <- struct{}{}
+		}
+
+		honeybeetest.Never(t, func() bool {
+			return called.Load()
+		}, "unexpected onTimeout call")
+	})
+
+	t.Run("timeout fires onTimeout exactly once", func(t *testing.T) {
+		activity := make(chan struct{})
+		ctx, cancel := context.WithCancel(context.Background())
+		defer cancel()
+
+		count := atomic.Int32{}
+		done := make(chan struct{})
+		go IdleWatchdog(
+			ctx, activity, 20*time.Millisecond, func() {
+				// will panic on second close
+				count.Add(1)
+				close(done)
+			},
+		)
+
+		honeybeetest.Eventually(t, func() bool {
+			select {
+			case <-done:
+				return true
+			default:
+				return false
+			}
+		}, "expected onTimeout")
+
+		assert.Equal(t, 1, int(count.Load()))
+	})
+
+	t.Run("ctx.Done exits without calling onTimeout", func(t *testing.T) {
+		activity := make(chan struct{})
+		ctx, cancel := context.WithCancel(context.Background())
+
+		called := atomic.Bool{}
+		done := make(chan struct{})
+		go func() {
+			IdleWatchdog(
+				ctx, activity, 20*time.Second, func() { called.Store(true) },
+			)
+			close(done)
+		}()
+
+		cancel()
+
+		honeybeetest.Eventually(t, func() bool {
+			select {
+			case <-done:
+				return true
+			default:
+				return false
+			}
+		}, "expected RunWatchdog to exit")
+
+		assert.False(t, called.Load())
+	})
+
+	t.Run("zero timeout exits on ctx.Done without firing onTimeout", func(t *testing.T) {
+		activity := make(chan struct{})
+		ctx, cancel := context.WithCancel(context.Background())
+
+		called := atomic.Bool{}
+		done := make(chan struct{})
+		go func() {
+			IdleWatchdog(
+				ctx, activity, 0, func() { called.Store(true) },
+			)
+			close(done)
+		}()
+
+		cancel()
+
+		honeybeetest.Eventually(t, func() bool {
+			select {
+			case <-done:
+				return true
+			default:
+				return false
+			}
+		}, "expected RunWatchdog to exit")
+
+		assert.False(t, called.Load())
+	})
+
+	t.Run("zero timeout drains activity without blocking", func(t *testing.T) {
+		activity := make(chan struct{})
+		ctx, cancel := context.WithCancel(context.Background())
+		defer cancel()
+
+		done := make(chan struct{})
+		go func() {
+			IdleWatchdog(ctx, activity, 0, func() {})
+			close(done)
+		}()
+
+		// these must not block
+		for i := 0; i < 5; i++ {
+			activity <- struct{}{}
+		}
+
+		cancel()
+
+		honeybeetest.Eventually(t, func() bool {
+			select {
+			case <-done:
+				return true
+			default:
+				return false
+			}
+		}, "expected RunWatchdog to exit")
+	})
+}