Developers

Events

GPCGuard currently records endpoint decision events for customer evidence views. This page describes event semantics and downstream wiring expectations; it does not claim a mature public webhook or SDK event bus.

Current Event Semantics

decision.processed
A request reached the endpoint and returned a policy decision.
decision.denied
A compliance-critical guard denied the request.
decision.failed
The endpoint attempted to preserve evidence for an internal failure state.
handoff.expected
A HONORED decision needs customer wiring into downstream systems.

Current Limitations

  • No public webhook delivery contract is currently published.
  • No public npm SDK maturity claim is made from this page.
  • Dashboard evidence and API responses are the current customer-facing event surfaces.

Downstream Wiring Checklist

  • Map HONORED decisions to CMP state or consent variables.
  • Block or suppress tag-manager triggers that would sell, share, or target based on the relevant policy.
  • Propagate suppression state to CDP profiles and server-side events.
  • Document which ad partners receive suppression signals and how failures are handled.
  • Test Sec-GPC and navigator.globalPrivacyControl paths separately.