Release v0.2.0
InsightFlare v0.2.0 expands the product from a dashboard-first analytics app into a more integration-ready analytics service with a documented API surface, API key authentication, and stronger request validation.
This release focuses on making InsightFlare easier to connect with external tools and safer to expose programmatically. It introduces API key management, a versioned API contract, OpenAPI and agent discovery endpoints, and a more consistent API response model.
Highlights
- Added API key management, including scoped keys, API key authentication, and dashboard controls for creating and managing access.
- Introduced the versioned
/api/v1API surface with generated OpenAPI 3.1 documentation and request/response examples. - Added
.well-knowndiscovery endpoints for OpenAPI, agent skills, health, security, and account password-change metadata. - Added generated
skills.jsondocumentation so LLM and agent clients can understand the public API more easily. - Added stronger request validation through shared Zod schemas for analytics, realtime, site, team, funnel, tracker, and common API inputs.
- Improved API response consistency with request IDs, timestamps, and a unified response envelope.
- Added same-origin request validation and strengthened secret/session handling for safer deployments.
- Added dashboard surfaces for API key management and clearer version update details.
- Improved geography and realtime dashboard rendering by moving heavier map and realtime views into dedicated client-side stages.
Changes Since v0.1.0
- Fixed API version reporting so it is read from
package.jsoninstead of being hardcoded. - Fixed
/api/v1root route matching with an optional catch-all route. - Aligned generated OpenAPI metadata, schemas, examples, and endpoint behavior with the actual implementation.
- Fixed mobile page scrolling behavior.
- Fixed rollback secret handling so fallback values are applied correctly.
- Replaced hardcoded locale checks with the i18n system.
- Renamed the funnel route to
funnelsfor consistency. - Removed unnecessary release-summary height restrictions.
- Reduced worker bundle pressure by moving heavier dashboard experiences behind client-only islands.
Developer Experience
- Added scripts for generating OpenAPI and skills documentation.
- Added an OpenAPI contract checker to catch documentation drift.
- Added CI coverage thresholds and broadened test coverage across API v1, API keys, scheduled tasks, hourly rollups, realtime mocks, schemas, validation, and dashboard client data.
- Added explicit Prettier defaults and stricter ESLint coverage for the codebase.
- Added environment and prebuild checks for safer Cloudflare deployment flows.