Search REST integration

The public search endpoint is /wp-json/cointacted-search/v1/search. Themes and official add-ons should consume its normalized result contract or register a presentation handler instead of querying every source independently.

Pass the query and supported source scope. Respect minimum length, bounded per-source limits, result URLs, source identifiers, and current-viewer permissions. Do not cache personalized or restricted responses as public data.

The server remains authoritative even when a browser interface hides disabled filters. Administration settings endpoints require the appropriate WordPress capability.

Integrations must preserve keyboard focus, loading and empty states, canonical URLs, browser history, and the local fallback when optional external indexing is unavailable.