Proxy analytics events

[conico974]

Middleware now handles forwarding insights events instead of going through the api directly.

[linear]

RND-7887 Proxy analytics events in GBO

[changeset-bot]

⚠️ No Changeset found

Latest commit: add4a2d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-72s7bjthn-gitbook.vercel.app	✅
Cloudflare	https://01c05609-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-72s7bjthn-gitbook.vercel.app/url/gitbook.com/docs	https://01c05609-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-72s7bjthn-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://01c05609-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2 (Inspect)	👍 Changes approved	4 changed	Aug 25, 2025, 9:17 AM
v2-cloudflare (Inspect)	👍 Changes approved	2 changed	Aug 25, 2025, 9:12 AM
v2-vercel (Inspect)	✅ No changes detected	-	Aug 25, 2025, 9:21 AM

[Copilot]

Pull Request Overview

This PR implements proxying of analytics events through the middleware instead of sending them directly to the GitBook API. The middleware now handles forwarding insights events to maintain better control over analytics traffic routing.

• Adds middleware route handler for analytics events at /~gitbook/__evt endpoint
• Updates InsightsProvider to send events through the middleware proxy instead of directly to the API
• Replaces API host parameter with base path parameter to support the new routing approach

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
packages/gitbook/src/middleware.ts	Adds analytics event forwarding handler and imports GITBOOK_API_URL
packages/gitbook/src/components/SpaceLayout/SpaceLayout.tsx	Removes unused API URL import and updates InsightsProvider props
packages/gitbook/src/components/Insights/visitorId.ts	Updates session endpoint path
packages/gitbook/src/components/Insights/InsightsProvider.tsx	Refactors to use basePath instead of apiHost and updates event sending logic

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}