The consent check someone missed
Analytics that fires on page load with a banner bolted on afterwards needs a guard at every call site, and one missed guard is a real problem. Here the guard is inside the tracking call itself.
Weet wat stukging, zonder iemand te volgen die nee zei.
Als een verzoek mislukt, krijg je een korte verwijzing zoals APP-CAPACITY-002 en een gewone melding, en die verwijzing hoort bij precies één regel in een register. Productanalyse blijft stil en doet niets tot iemand de analysecookie accepteert, ook als dat halverwege een sessie gebeurt.
0
tracking events before consent
1
place where every error code lives
2
tools that leave the build when unset
Zonder een gedeelde basis bouwt elk team deze randgevallen opnieuw, en anders.
Analytics that fires on page load with a banner bolted on afterwards needs a guard at every call site, and one missed guard is a real problem. Here the guard is inside the tracking call itself.
Someone says it broke, with no reference, or pastes a stack trace. There is nothing stable to match against what was actually captured. A short reference solves that in one line.
SDKs that assume their keys exist crash local development or behave differently between environments. Here both wrappers are safe to call unconfigured and disappear from the build entirely.
Het mechanisme van begin tot eind, zoals het in de repository is geïmplementeerd.
Consent comes first
Every tracking call checks the analytics cookie choice. On acceptance the tracker loads lazily, and a change listener covers a yes that arrives later in the session.
Errors are captured with context
Reporting filters noise and tags each event with structured context such as organization, project and job. In development, events log locally rather than being sent.
People get a stable reference
Every failure resolves through one registry to a reference such as APP-CAPACITY-001 and a safe public message. Operator meanings stay in the repository docs.
Missing keys cost nothing
Without analytics or error-reporting keys every helper becomes a no-op and the build drops the unused tools.
Interactief voorbeeld
Deze rondleiding toont het geïmplementeerde backendcontract zonder account, credentials of providercalls.
Interactief voorbeeld
Alleen deterministische voorbeelddata. De interactie gebruikt geen account-, provider- of netwerkverbinding.
Kernpunten
Every tracking call checks the consent choice first. The tracker loads lazily on acceptance, and a listener covers someone who accepts mid-session.
Reports are tagged with organization, project, job and AI details, so a failure can be placed without digging through raw payloads.
Every API error maps through one registry to a support reference and a safe public message. A released reference always means the same thing.
Technische garanties
Foutrapportage wordt los van de analysetoestemming ingesteld, en deze pagina doet niet alsof dat anders is. Wat er in onze foutcontext mag staan en hoe lang die bewaard blijft, is aan ons om te bepalen en niet iets wat de code beslecht.
De grens hierboven is geen claim maar code. Deze bestanden dragen het contract:
src/lib/analytics.tssrc/lib/sentry.tssrc/registries/error-codes.tsdocs/ERROR-CODES.mdDeze functies delen contracten en grenzen met deze pagina.
De documentatie beschrijft dezelfde contracten die deze pagina demonstreert.