Function useConfigPage

ui/src/hooks/useConfigPage.ts:30–87

({
  section,
  extract,
  delay = 600,
}: UseConfigPageOptions<T>)

 * Handles: load → autoSave → flush → updateConfig/updateConfigImmediate.
 */
export function useConfigPage<T extends object>({
  section,
  extract,
  delay = 600,
}: UseConfigPageOptions<T>): UseConfigPageResult<T> {
  const [fullConfig, setFullConfig] = useState<AppConfig | null>(null)
  const [config, setConfig] = useState<T | null>(null)
  const [loadError, setLoadError] = useState(false)
  const flushRequestedRef = useRef(false)

  useEffect(() => {
    api.config
      .load()
      .then((full) => {
        setFullConfig(full)
        setConfig(extract(full))
      })
      .catch(() => setLoadError(true))
  }, []) // extract is stable (caller should memoize or use inline arrow)

  const saveConfig = useCallback(
    async (data: T) => {
      const result = await api.config.updateSection(section, data)
      // Adopt the server echo only when its content actually differs
      // (zod normalization, defaults). Unconditionally swapping in a
      // fresh object re-arms useAutoSave's [data] effect and loops the
      // PUT forever — echo → new identity → schedule → PUT → echo …
      setConfig((prev) => (JSON.stringify(prev) === JSON.stringify(result) ? prev : (result as T)))
    },
    [section],
  )

  const { status, flush, retry } = useAutoSave({
    data: config!,
    save: saveConfig,
    delay,
    enabled: config !== null,
  })

  // After React commits a state update with flushRequested, trigger immediate save
  useEffect(() => {
    if (flushRequestedRef.current && config) {
      flushRequestedRef.current = false
      flush()
    }
  }, [config, flush])

  const updateConfig = useCallback((patch: Partial<T>) => {
    setConfig((prev) => (prev ? { ...prev, ...patch } : prev))
  }, [])

  const updateConfigImmediate = useCallback((patch: Partial<T>) => {
    setConfig((prev) => (prev ? { ...prev, ...patch } : prev))
    flushRequestedRef.current = true
  }, [])

  return { config, fullConfig, status, loadError, updateConfig, updateConfigImmediate, retry }
}