fn_registry/frontend/functions/ui/use_wails_query.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path, props, emits, has_state, framework, variant, source_repo, source_license, source_file

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path	props	emits	has_state	framework	variant	source_repo	source_license	source_file
use_wails_query	component	ts	ui	1.0.0	impure	useWailsQuery<T>(opts: UseWailsQueryOptions<T>): UseWailsQueryResult<T>	Hook React Query-like sobre IPC Wails. Cache automático, refetch por intervalo/foco, retry con backoff, invalidación.	wails query hook ipc cache component ui	wails_cache_ts_core wails_provider_ts_ui	WailsIPC_ts_ui		false		react	name desc opts Configuración: queryKey para cache, queryFn que ejecuta binding Wails, enabled, refetchInterval, staleTime	Hook que retorna data, loading, error, refetch, invalidate para queries cacheadas vía IPC	false			frontend/functions/ui/use_wails_query.tsx	name type required description queryKey string[] true Key única para cache name type required description queryFn () => Promise<T> true Función que llama al binding Wails name type required description enabled boolean false Habilitar auto-fetch (default true) name type required description refetchInterval number false Refetch cada N ms name type required description staleTime number false Tiempo antes de considerar datos stale	onSuccess onError	true	react	default	https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/Bl4cksmith/Frontend_Library	MIT	frontend/src/lib/wails/use-wails-query.tsx

Ejemplo

const { data, loading, refetch, invalidate } = useWailsQuery({
  queryKey: ['users', 'list'],
  queryFn: () => GetUsers(),       // Wails binding
  refetchInterval: 30000,          // Cada 30s
  staleTime: 5000,                 // Fresh por 5s
  onSuccess: (users) => console.log(`${users.length} users`),
})

Notas

API inspirada en TanStack Query pero sobre IPC Wails (sin HTTP). Cache compartido via WailsProvider o singleton. Refetch automático en window focus.