also looking at this
chore: wip stx improvements
#1649
241 files
+19022
-1323
| @@ -0,0 +1,118 @@ | ||
| 1 | import type { AnalyticsConfig, AnalyticsEvent, AnalyticsQuery, AnalyticsResult, AnalyticsStorage, PageView } from './types' | |
| 2 | import { MemoryAnalyticsStorage } from './storage/memory' | |
| 3 | import { shouldTrack } from './tracker' | |
| 4 | ||
| 5 | export class AnalyticsEngine { | |
| 6 | config: AnalyticsConfig | |
| 7 | storage: AnalyticsStorage | |
| 8 | ||
| 9 | constructor(config: AnalyticsConfig) { | |
| 10 | this.config = { | |
| 11 | anonymize: true, | |
| 12 | sessionTimeout: 1800000, | |
| 13 | ...config, | |
| 14 | } | |
| 15 | this.storage = this.config.storage | |
| 16 | } | |
| 17 | ||
| 18 | async trackPageView( | |
| 19 | request: Request | { path: string, referrer?: string, userAgent?: string, sessionId?: string }, | |
| 20 | ): Promise<PageView> { | |
| 21 | let path: string | |
| 22 | let referrer: string | undefined | |
| 23 | let userAgent: string | undefined | |
| 24 | let sessionId: string | undefined | |
| 25 | ||
| 26 | if (request instanceof Request) { | |
| 27 | const url = new URL(request.url) | |
| 28 | path = url.pathname | |
| 29 | referrer = request.headers.get('referer') || undefined | |
| 30 | userAgent = request.headers.get('user-agent') || undefined | |
| 31 | } | |
| 32 | else { | |
| 33 | path = request.path | |
| 34 | referrer = request.referrer | |
| 35 | userAgent = request.userAgent | |
| 36 | sessionId = request.sessionId | |
| 37 | } | |
| 38 | ||
| 39 | if (!shouldTrack(path, this.config)) { | |
| 40 | throw new Error(`Path "${path}" is excluded from tracking`) | |
| 41 | } | |
| 42 | ||
| 43 | const view: PageView = { | |
| 44 | id: generateId(), | |
| 45 | path, | |
| 46 | referrer, | |
| 47 | userAgent, | |
| 48 | timestamp: Date.now(), | |
| 49 | sessionId, | |
| 50 | } | |
| 51 | ||
| 52 | await this.storage.savePageView(view) | |
| 53 | return view | |
| 54 | } | |
| 55 | ||
| 56 | async trackEvent(name: string, data?: Record<string, unknown>): Promise<AnalyticsEvent> { | |
| 57 | const event: AnalyticsEvent = { | |
| 58 | id: generateId(), | |
| 59 | name, | |
| 60 | data, | |
| 61 | timestamp: Date.now(), | |
| 62 | } | |
| 63 | ||
| 64 | await this.storage.saveEvent(event) | |
| 65 | return event | |
| 66 | } | |
| 67 | ||
| 68 | async getStats(query?: AnalyticsQuery): Promise<AnalyticsResult> { | |
| 69 | return this.storage.getStats(query) | |
| 70 | } | |
| 71 | ||
| 72 | async getPageViews(query?: AnalyticsQuery): Promise<PageView[]> { | |
| 73 | return this.storage.getPageViews(query) | |
| 74 | } | |
| 75 | ||
| 76 | async getEvents(query?: AnalyticsQuery): Promise<AnalyticsEvent[]> { | |
| 77 | return this.storage.getEvents(query) | |
| 78 | } | |
| 79 | } | |
| 80 | ||
| 81 | let _engine: AnalyticsEngine | null = null | |
| 82 | ||
| 83 | export function configureAnalytics(config: Partial<AnalyticsConfig>): void { | |
| 84 | const fullConfig: AnalyticsConfig = { | |
| 85 | storage: config.storage || new MemoryAnalyticsStorage(), | |
| 86 | anonymize: config.anonymize ?? true, | |
| 87 | ignorePaths: config.ignorePaths, | |
| 88 | sessionTimeout: config.sessionTimeout ?? 1800000, | |
| 89 | } | |
| 90 | _engine = new AnalyticsEngine(fullConfig) | |
| 91 | } | |
| 92 | ||
| 93 | export function resetAnalytics(): void { | |
| 94 | _engine = null | |
| 95 | } | |
| 96 | ||
| 97 | export async function getAnalytics(query?: AnalyticsQuery): Promise<AnalyticsResult> { | |
| 98 | const engine = getAnalyticsEngine() | |
| 99 | return engine.getStats(query) | |
| 100 | } | |
| 101 | ||
| 102 | export function getAnalyticsEngine(): AnalyticsEngine { | |
| 103 | if (!_engine) { | |
| 104 | _engine = new AnalyticsEngine({ | |
| 105 | storage: new MemoryAnalyticsStorage(), | |
| 106 | anonymize: true, | |
| 107 | sessionTimeout: 1800000, | |
| 108 | }) | |
| 109 | } | |
| 110 | return _engine | |
| 111 | } | |
| 112 | ||
| 113 | function generateId(): string { | |
| 114 | if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') { | |
| 115 | return crypto.randomUUID() | |
| 116 | } | |
| 117 | return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}` | |
| 118 | } | |