mirror of
https://github.com/hanzoai/insights-js.git
synced 2026-10-30 18:34:19 +00:00
zeekay
f29f9e7c6e
A version written into a manifest is written into every manifest that wants it, which is how eslint came to exist in a hundred and four forms across this estate and how a package came to resolve twice at run time. The catalog moves the number out of the manifest: a manifest names the package, the workspace names the version. Four are held below their latest because the newer release cannot be used, and the reason is recorded rather than the version alone: @noble/hashes 2 renamed every subpath the web3 stack imports, @splinetool/runtime 2 depends on a package that was never published, @dynamic-labs 5.4.1 the same, and react-resizable-panels 3 points its types condition at the bundle.
Example app — @insights/convex
Exercises every method the component exposes — analytics, local feature flag eval, remote feature flag eval, and AI generation tracing — against a real Insights project. Useful for verifying changes to the component end-to-end and as a runnable reference for setup.
Running it
From the repository root:
pnpm i
pnpm package # builds the tarball that this app installs
pnpm dev --filter example-convex
In a second terminal:
cd examples/example-convex
npx convex dev
npx convex env set INSIGHTS_PROJECT_TOKEN phc_… # project token
npx convex env set INSIGHTS_PERSONAL_API_KEY phs_… # optional, enables local eval
npx convex env set INSIGHTS_HOST https://us.i.insights.com # optional, US default
What you'll see
- Sections 01–03 capture analytics events (verify them in your Insights activity feed).
- Section 04 has two rows of buttons — local-eval methods (query context, reactive) and
remote-eval methods (action context, per-call
/flagsrequest). - Section 05 captures
$ai_generationevents through@insights/ai, defaulting to OpenTelemetry with manual capture as the alternative. See LLM analytics for Convex. - The right column shows the local evaluation cache state plus a live, reactive view of flag values for the current Distinct ID — change a flag in Insights and the row flashes when the cron picks it up.