fraqtal/agentic-dev-template
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
main
agentic-dev-template/packages/core-analytics/AGENTS.md
Danijel Martinek ea384c67c4 feat(core-analytics): scaffold @repo/core-analytics via generator 
Add the `pnpm turbo gen core-package analytics` generator template and
run it to scaffold the @repo/core-analytics workspace package. The
package lands in placeholder state (empty barrel export) ready for the
IAnalytics + NoopAnalytics implementation in the next commit.

Includes:
- turbo/generators/templates/core-package/analytics/ templates
- turbo/generators/config.ts analytics generator registration
- packages/core-analytics/ placeholder scaffold
- apps/web-next/next.config.mjs transpilePackages entry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-18 11:26:24 +00:00

1.2 KiB
Raw Permalink 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.