@umituz/web-traffic 1.0.12 → 1.0.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/web-traffic",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Web analytics tracking library. Event tracking, pageviews, sessions, device info, and UTM parameter support.",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -17,7 +17,7 @@
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "lint": "echo 'Lint passed'",
+    "lint": "eslint .",
     "version:patch": "npm version patch -m 'chore: release v%s'",
     "version:minor": "npm version minor -m 'chore: release v%s'",
     "version:major": "npm version major -m 'chore: release v%s'"
@@ -46,9 +46,12 @@
     "react": ">=18.2.0"
   },
   "devDependencies": {
+    "@eslint/js": "^9.32.0",
     "@types/react": "~19.1.10",
+    "eslint": "^9.32.0",
     "react": "19.1.0",
-    "typescript": "~5.9.2"
+    "typescript": "~5.9.2",
+    "typescript-eslint": "^8.38.0"
   },
   "publishConfig": {
     "access": "public"

package/src/domains/affiliate/repositories/affiliate.repository.interface.ts

@@ -8,6 +8,7 @@ import type { AffiliateVisit } from '../entities/affiliate-visit.entity';
 import type { AffiliateId } from '../value-objects/affiliate-id.vo';
 import type { SiteId } from '../value-objects/site-id.vo';
 import type { SessionId } from '../../tracking/value-objects/session-id.vo';
+import type { EventId } from '../../tracking/value-objects/event-id.vo';
 
 export interface IAffiliateRepository {
   save(affiliate: Affiliate): Promise<void>;
@@ -19,8 +20,8 @@ export interface IAffiliateRepository {
 
 export interface IAffiliateVisitRepository {
   save(visit: AffiliateVisit): Promise<void>;
-  findById(id: import('../../tracking/value-objects/event-id.vo').EventId): Promise<AffiliateVisit | null>;
+  findById(id: EventId): Promise<AffiliateVisit | null>;
   findByAffiliate(affiliateId: AffiliateId): Promise<AffiliateVisit[]>;
   findByVisitorAndSession(visitorId: string, sessionId: SessionId): Promise<AffiliateVisit[]>;
-  delete(id: import('../../tracking/value-objects/event-id.vo').EventId): Promise<void>;
+  delete(id: EventId): Promise<void>;
 }

package/src/domains/conversion/aggregates/order.aggregate.ts

@@ -3,9 +3,10 @@
  * @description Manages conversion order and its items
  */
 
-import type { OrderItem } from '../entities/order-item.entity';
+import type { OrderItem, OrderItemCreateInput } from '../entities/order-item.entity';
 import type { EventId } from '../../tracking/value-objects/event-id.vo';
 import { Money } from '../value-objects/money.vo';
+import { createOrderItem } from '../entities/order-item.entity';
 
 export interface OrderCreateInput {
   sessionId: string;
@@ -37,12 +38,13 @@ export class Order {
     // Calculate total and create items
     let totalAmount = 0;
     for (const item of input.items) {
-      const orderItem: OrderItem = {
+      const createInput: OrderItemCreateInput = {
         id: item.id,
         name: item.name,
         price: item.price,
         quantity: item.quantity,
       };
+      const orderItem = createOrderItem(createInput);
       this.items.push(orderItem);
       totalAmount += item.price * item.quantity;
     }

package/src/domains/conversion/index.ts

@@ -16,6 +16,3 @@ export { Money } from './value-objects/money.vo';
 
 // Repository Interfaces
 export type { IConversionRepository } from './repositories/conversion.repository.interface';
-
-// Domain Events
-export { ConversionRecorded } from './events/conversion-recorded.domain-event';

package/src/domains/tracking/aggregates/session.aggregate.ts

@@ -25,8 +25,6 @@ export class Session {
   private endTime: number | null;
   private events: Event[];
   private pageviews: Pageview[];
-  private eventCount: number;
-  private pageviewCount: number;
   private entryPage: string | null;
   private exitPage: string | null;
 
@@ -39,8 +37,6 @@ export class Session {
     this.endTime = null;
     this.events = [];
     this.pageviews = [];
-    this.eventCount = 0;
-    this.pageviewCount = 0;
     this.entryPage = null;
     this.exitPage = null;
     Object.freeze(this.id);
@@ -56,8 +52,6 @@ export class Session {
       throw new Error('Cannot add event to expired session');
     }
     this.events.push(event);
-    this.eventCount++;
-    this.updateLastActivity();
   }
 
   addPageview(pageview: Pageview): void {
@@ -65,12 +59,10 @@ export class Session {
       throw new Error('Cannot add pageview to expired session');
     }
     this.pageviews.push(pageview);
-    this.pageviewCount++;
     this.exitPage = pageview.path;
     if (!this.entryPage) {
       this.entryPage = pageview.path;
     }
-    this.updateLastActivity();
   }
 
   getEntryPage(): string | null {
@@ -117,11 +109,11 @@ export class Session {
   }
 
   getEventCount(): number {
-    return this.eventCount;
+    return this.events.length;
   }
 
   getPageviewCount(): number {
-    return this.pageviewCount;
+    return this.pageviews.length;
   }
 
   getEvents(): Event[] {
@@ -132,10 +124,6 @@ export class Session {
     return [...this.pageviews];
   }
 
-  private updateLastActivity(): void {
-    // Could emit domain event here
-  }
-
   toJSON() {
     return {
       id: this.id.toString(),
@@ -144,8 +132,8 @@ export class Session {
       deviceInfo: this.deviceInfo.toJSON(),
       startTime: this.startTime,
       endTime: this.endTime,
-      eventCount: this.eventCount,
-      pageviewCount: this.pageviewCount,
+      eventCount: this.events.length,
+      pageviewCount: this.pageviews.length,
       entryPage: this.entryPage,
       exitPage: this.exitPage,
       duration: this.getDuration(),

package/src/domains/tracking/index.ts

@@ -28,10 +28,6 @@ export type {
   ISessionRepository,
 } from './repositories/event.repository.interface';
 
-// Domain Events
-export { EventTracked } from './events/event-tracked.domain-event';
-export { PageviewTracked } from './events/pageview-tracked.domain-event';
-
 // Application Services
 export { TrackingCommandService } from './application/tracking-command.service';
 export type { TrackingCommandResult } from './application/tracking-command.service';

package/src/domains/tracking/repositories/event.repository.interface.ts

@@ -7,6 +7,7 @@ import type { Event } from '../entities/event.entity';
 import type { Pageview } from '../entities/pageview.entity';
 import type { EventId } from '../value-objects/event-id.vo';
 import type { SessionId } from '../value-objects/session-id.vo';
+import type { Session } from '../aggregates/session.aggregate';
 
 export interface IEventRepository {
   save(event: Event | Pageview): Promise<void>;
@@ -16,15 +17,15 @@ export interface IEventRepository {
 }
 
 export interface IPageviewRepository {
-  save(pageview: import('../entities/pageview.entity').Pageview): Promise<void>;
-  findById(id: EventId): Promise<import('../entities/pageview.entity').Pageview | null>;
-  findBySessionId(sessionId: SessionId): Promise<import('../entities/pageview.entity').Pageview[]>;
+  save(pageview: Pageview): Promise<void>;
+  findById(id: EventId): Promise<Pageview | null>;
+  findBySessionId(sessionId: SessionId): Promise<Pageview[]>;
   delete(id: EventId): Promise<void>;
 }
 
 export interface ISessionRepository {
-  save(session: import('../aggregates/session.aggregate').Session): Promise<void>;
-  findById(id: SessionId): Promise<import('../aggregates/session.aggregate').Session | null>;
-  findActive(deviceId: string, timeoutMs: number): Promise<import('../aggregates/session.aggregate').Session | null>;
+  save(session: Session): Promise<void>;
+  findById(id: SessionId): Promise<Session | null>;
+  findActive(deviceId: string, timeoutMs: number): Promise<Session | null>;
   delete(id: SessionId): Promise<void>;
 }

package/src/infrastructure/tracking/web-traffic.service.ts

@@ -179,12 +179,16 @@ class WebTrafficService {
     this.originalReplaceState = history.replaceState;
 
     history.pushState = (...args) => {
-      this.originalPushState!.apply(history, args);
+      if (this.originalPushState) {
+        this.originalPushState.apply(history, args);
+      }
       void this.trackPageView();
     };
 
     history.replaceState = (...args) => {
-      this.originalReplaceState!.apply(history, args);
+      if (this.originalReplaceState) {
+        this.originalReplaceState.apply(history, args);
+      }
       void this.trackPageView();
     };
 

package/src/presentation/context.tsx

@@ -8,7 +8,7 @@ import { webTrafficService, type WebTrafficConfig } from '../infrastructure/trac
 import type { WebTrafficContextValue } from './hooks';
 import type { TrackingCommandResult } from '../domains/tracking/application/tracking-command.service';
 
-const TrackingContext = createContext<WebTrafficContextValue | null>(null);
+const WebTrafficContext = createContext<WebTrafficContextValue | null>(null);
 
 export interface WebTrafficProviderProps {
   readonly children: ReactNode;
@@ -26,10 +26,10 @@ export function WebTrafficProvider({ children, config }: WebTrafficProviderProps
 
   const value = useMemo<WebTrafficContextValue>(
     () => ({
-      trackEvent: async (name: string, properties?: Record<string, unknown>) => {
+      trackEvent: (name: string, properties?: Record<string, unknown>) => {
         return webTrafficService.trackEvent(name, properties);
       },
-      trackPageView: async (path?: string) => {
+      trackPageView: (path?: string) => {
         return webTrafficService.trackPageView(path);
       },
       isInitialized: webTrafficService.isInitialized(),
@@ -38,7 +38,7 @@ export function WebTrafficProvider({ children, config }: WebTrafficProviderProps
     [config]
   );
 
-  return <TrackingContext.Provider value={value}>{children}</TrackingContext.Provider>;
+  return <WebTrafficContext.Provider value={value}>{children}</WebTrafficContext.Provider>;
 }
 
-export { TrackingContext as WebTrafficContext };
+export { WebTrafficContext };

package/src/domains/conversion/events/conversion-recorded.domain-event.ts

@@ -1,30 +0,0 @@
-/**
- * Conversion Recorded Domain Event
- * @description Published when a conversion is recorded
- */
-
-import type { Money } from '../value-objects/money.vo';
-
-export class ConversionRecorded {
-  readonly eventType = 'ConversionRecorded';
-  readonly orderId: string;
-  readonly sessionId: string;
-  readonly revenue: Money;
-  readonly itemCount: number;
-  readonly occurredAt: number;
-
-  constructor(params: {
-    orderId: string;
-    sessionId: string;
-    revenue: Money;
-    itemCount: number;
-    occurredAt?: number;
-  }) {
-    this.orderId = params.orderId;
-    this.sessionId = params.sessionId;
-    this.revenue = params.revenue;
-    this.itemCount = params.itemCount;
-    this.occurredAt = params.occurredAt ?? Date.now();
-    Object.freeze(this);
-  }
-}

package/src/domains/tracking/events/event-tracked.domain-event.ts

@@ -1,28 +0,0 @@
-/**
- * Event Tracked Domain Event
- * @description Published when an analytics event is tracked
- */
-
-import type { EventId } from '../../tracking/value-objects/event-id.vo';
-import type { SessionId } from '../../tracking/value-objects/session-id.vo';
-
-export class EventTracked {
-  readonly eventType = 'EventTracked';
-  readonly eventId: EventId;
-  readonly sessionId: SessionId;
-  readonly eventName: string;
-  readonly occurredAt: number;
-
-  constructor(params: {
-    eventId: EventId;
-    sessionId: SessionId;
-    eventName: string;
-    occurredAt?: number;
-  }) {
-    this.eventId = params.eventId;
-    this.sessionId = params.sessionId;
-    this.eventName = params.eventName;
-    this.occurredAt = params.occurredAt ?? Date.now();
-    Object.freeze(this);
-  }
-}

package/src/domains/tracking/events/pageview-tracked.domain-event.ts

@@ -1,31 +0,0 @@
-/**
- * Pageview Tracked Domain Event
- * @description Published when a pageview is tracked
- */
-
-import type { EventId } from '../../tracking/value-objects/event-id.vo';
-import type { SessionId } from '../../tracking/value-objects/session-id.vo';
-
-export class PageviewTracked {
-  readonly eventType = 'PageviewTracked';
-  readonly pageviewId: EventId;
-  readonly sessionId: SessionId;
-  readonly path: string;
-  readonly hasUTM: boolean;
-  readonly occurredAt: number;
-
-  constructor(params: {
-    pageviewId: EventId;
-    sessionId: SessionId;
-    path: string;
-    hasUTM: boolean;
-    occurredAt?: number;
-  }) {
-    this.pageviewId = params.pageviewId;
-    this.sessionId = params.sessionId;
-    this.path = params.path;
-    this.hasUTM = params.hasUTM;
-    this.occurredAt = params.occurredAt ?? Date.now();
-    Object.freeze(this);
-  }
-}