ReviewOS

also looking at this

stacks/stx

chore: wip stx improvements

#1649
Merged fingersandmind wants to merge feat/stx-improvements into main
241 files +19022 -1323
packages/analytics/src/analytics.tsadded+118-0
Changes to packages/analytics/src/analytics.ts
@@ -0,0 +1,118 @@
1import type { AnalyticsConfig, AnalyticsEvent, AnalyticsQuery, AnalyticsResult, AnalyticsStorage, PageView } from './types'
2import { MemoryAnalyticsStorage } from './storage/memory'
3import { shouldTrack } from './tracker'
4
5export 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
81let _engine: AnalyticsEngine | null = null
82
83export 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
93export function resetAnalytics(): void {
94 _engine = null
95}
96
97export async function getAnalytics(query?: AnalyticsQuery): Promise<AnalyticsResult> {
98 const engine = getAnalyticsEngine()
99 return engine.getStats(query)
100}
101
102export 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
113function 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}