Skip to content

Release v0.2.0

Choose a tag to compare

@github-actions github-actions released this 27 Jun 11:19

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/v1 API surface with generated OpenAPI 3.1 documentation and request/response examples.
  • Added .well-known discovery endpoints for OpenAPI, agent skills, health, security, and account password-change metadata.
  • Added generated skills.json documentation 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.json instead of being hardcoded.
  • Fixed /api/v1 root 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 funnels for 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.