You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
There is no guide for coding agents to set up server-side collection #93
Customers set up server-side collection by pasting an AI prompt into their coding agent (spec §12). That prompt is a docs page written for coding agents, next to /install.md and /events.md, plus a page for people. Both are labelled beta.
The guide:
Writes the integration into the customer's repository; for Next.js it uses @simpleanalytics/next.
Asks which query parameters to add to the allowed list.
Warns which cached or static pages are not counted.
Ends by replaying about ten example curl requests in test mode against the customer's app (ChatGPT-User, Googlebot, a normal Chrome and others) and comparing each reply with the expected one.
Landed on feat/server-side-collection (456f438) in draft #94. This issue closes when that PR merges.
What the pages say now: /server-side-collection.md guides a coding agent through writing an integration, or using @simpleanalytics/next for Next.js, then replaying 12 curl requests in test mode and comparing each reply's outcome and name. /server-side-collection explains the same to people, AI agent first. Both are labelled beta.
Validation: two rounds. Round 1 found that content types with parameters (application/json; charset=utf-8) were not skipped; the guide now compares the media type only. The re-check passed.
Open decisions: (a) the guide states only what Cloudflare documents about Workers; whether a Worker's X-Forwarded-For arrives unchanged needs a test with a deployed Worker.
Not run: a coding agent following the guide end to end against the real queue, since /requests is not live.
Later: the next README and docs page should link this guide first.
Activity
Merge ticket 11: server-side collection guide for coding agents and p…
simpleanalytics-agent commentedon Nov 18, 2026
Landed on
feat/server-side-collection(456f438) in draft #94. This issue closes when that PR merges.What the pages say now:
/server-side-collection.mdguides a coding agent through writing an integration, or using@simpleanalytics/nextfor Next.js, then replaying 12curlrequests in test mode and comparing each reply'soutcomeandname./server-side-collectionexplains the same to people, AI agent first. Both are labelled beta.application/json; charset=utf-8) were not skipped; the guide now compares the media type only. The re-check passed.X-Forwarded-Forarrives unchanged needs a test with a deployed Worker./requestsis not live.nextREADME and docs page should link this guide first.