fraqtal/agentic-dev
Template
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f77e6ea881a8a2a1c63a0aee897e110616e9fae1
agentic-dev/packages/core-analytics/AGENTS.md
Danijel Martinek f77e6ea881 chore(template): clean-slate template snapshot from bb4a0c7 
Curated, product-agnostic snapshot of the post-story-04 tree: demo
content deleted, auth-only reference feature, web-next shell, all gates
green. Product-specific docs, ADRs 027-029, PRDs/epics/archive, editor
library traces, and product naming are curated out; generic template
repairs (coverage provider devDeps, root test:coverage script, live
lint fixes, root-only release-please) are kept. See TEMPLATE.md for
provenance, curation list, and usage.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016j8z4VHjedXDTjEDNg7qHK
2026-07-12 20:40:54 +02:00

1.2 KiB
Raw Blame History

@repo/core-analytics

Optional core package providing a vendor-neutral product analytics interface. Scaffold via pnpm turbo gen core-package analytics.

Structure

src/
  analytics.interface.ts   # IAnalytics — track, identify, pageView, flush
  noop-analytics.ts        # NoopAnalytics (default no-op implementation)
  index.ts                 # Barrel export

Design

IAnalytics exposes four methods:

  • track(event, attributes?) — record a named event with optional attributes
  • identify(user) — associate subsequent events with a user
  • pageView(path, attributes?) — record a page-view event
  • flush() — drain any in-flight queued events (returns Promise<void>)

The interface is vendor-neutral: no third-party analytics SDK is bundled. Feature packages depend on IAnalytics only; concrete implementations (e.g. a PostHog or Segment adapter) are wired at DI bind time in bind-production.

NoopAnalytics is the default implementation — all methods are no-ops and flush() resolves immediately via Promise.resolve(). Use it in dev-seed bindings and unit tests.

See docs/architecture/agent-first-workflow-and-conformance.md for the dependency-injection conventions.