analyzer-analytics 0.1.0

package/dist/storage.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @youranalytics/web-sdk Storage Utilities
+ * Safe browser storage with fallbacks for edge cases
+ */
+import { type VisitorId, type SessionId } from './types';
+type StorageType = 'localStorage' | 'sessionStorage';
+/**
+ * Test if a storage type is available and working.
+ * Result is cached after first check.
+ *
+ * @param type - The storage type to check
+ * @returns true if storage is available and functional
+ */
+export declare function isStorageAvailable(type: StorageType): boolean;
+/**
+ * Reset storage availability cache.
+ * Useful for testing or when storage state might have changed.
+ */
+export declare function resetStorageCache(): void;
+/**
+ * Safely get item from localStorage.
+ *
+ * @param key - Storage key
+ * @returns Value or null if not found/error
+ */
+export declare function getItem(key: string): string | null;
+/**
+ * Safely set item in localStorage.
+ *
+ * @param key - Storage key
+ * @param value - Value to store
+ * @returns true if successful, false if failed
+ */
+export declare function setItem(key: string, value: string): boolean;
+/**
+ * Safely get item from sessionStorage.
+ *
+ * @param key - Storage key
+ * @returns Value or null if not found/error
+ */
+export declare function getSessionItem(key: string): string | null;
+/**
+ * Safely set item in sessionStorage.
+ *
+ * @param key - Storage key
+ * @param value - Value to store
+ * @returns true if successful, false if failed
+ */
+export declare function setSessionItem(key: string, value: string): boolean;
+/**
+ * Generate a unique ID using crypto.randomUUID or fallback.
+ * Format: timestamp_randomString
+ * Example: "1704067200000_x7k9m2p" or "1704067200000_a1b2c3d4-e5f6-..."
+ *
+ * @returns Unique identifier string
+ */
+export declare function generateId(): string;
+/**
+ * Get or create a visitor ID that persists across sessions.
+ * Uses localStorage with fallbacks to sessionStorage and memory.
+ *
+ * @returns Branded VisitorId
+ */
+export declare function getVisitorId(): VisitorId;
+/**
+ * Clear the cached visitor ID.
+ * Useful for testing or when user requests data deletion.
+ */
+export declare function clearVisitorId(): void;
+/**
+ * Get or create a session ID that resets when tab/window closes.
+ * Uses sessionStorage with fallback to memory.
+ *
+ * @returns Branded SessionId
+ */
+export declare function getSessionId(): SessionId;
+/**
+ * Clear the cached session ID.
+ * Useful for testing or forcing a new session.
+ */
+export declare function clearSessionId(): void;
+/** Storage keys exported for testing */
+export declare const STORAGE_KEYS: {
+    readonly VISITOR_ID: "_analytics_vid";
+    readonly SESSION_ID: "_analytics_sid";
+};
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AA0D3F,KAAK,WAAW,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAQrD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CA0B7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAMD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAalD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAe3D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAazD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAelE;AAMD;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAenC;AAwCD;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAqDxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAsBrC;AASD;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,SAAS,CA6BxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAarC;AAMD,wCAAwC;AACxC,eAAO,MAAM,YAAY;;;CAGf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * @youranalytics/web-sdk Type Definitions
+ * Comprehensive types for the analytics SDK
+ */
+/**
+ * Unique visitor identifier that persists across sessions.
+ * Branded type prevents mixing with other string IDs.
+ */
+export type VisitorId = string & {
+    readonly __brand: 'VisitorId';
+};
+/**
+ * Session identifier that resets on new browser session.
+ * Branded type prevents mixing with other string IDs.
+ */
+export type SessionId = string & {
+    readonly __brand: 'SessionId';
+};
+/**
+ * Analytics SDK configuration options.
+ * Only `apiKey` is required; all other options have sensible defaults.
+ */
+export type AnalyticsConfig = {
+    /** API key from analytics dashboard (required) */
+    readonly apiKey: string;
+    /** Analytics server endpoint */
+    readonly endpoint?: string;
+    /** Enable debug logging to console */
+    readonly debug?: boolean;
+    /** Max events before auto-flush */
+    readonly maxQueueSize?: number;
+    /** Flush interval in milliseconds */
+    readonly flushInterval?: number;
+    /** Auto-track page views on initialization and navigation */
+    readonly autoTrack?: boolean;
+    /** Enable adaptive network behavior (adjusts batching based on connection quality) */
+    readonly adaptiveNetwork?: boolean;
+};
+/**
+ * Resolved configuration with all defaults applied.
+ * Used internally after merging user config with defaults.
+ */
+export type ResolvedConfig = {
+    readonly apiKey: string;
+    readonly endpoint: string;
+    readonly debug: boolean;
+    readonly maxQueueSize: number;
+    readonly flushInterval: number;
+    readonly autoTrack: boolean;
+    readonly adaptiveNetwork: boolean;
+};
+/**
+ * UTM parameters for campaign tracking.
+ * Extracted from URL query parameters.
+ */
+export type UtmParams = {
+    /** Traffic source (e.g., 'google', 'newsletter') */
+    readonly source?: string;
+    /** Marketing medium (e.g., 'cpc', 'email') */
+    readonly medium?: string;
+    /** Campaign name */
+    readonly campaign?: string;
+    /** Paid search keyword */
+    readonly term?: string;
+    /** Ad content identifier */
+    readonly content?: string;
+};
+/**
+ * Raw event as sent to the analytics server.
+ * Contains all tracking data including context.
+ */
+export type RawEvent = {
+    /** Event name (e.g., 'pageview', 'click', 'signup') */
+    readonly event: string;
+    /** Custom event properties */
+    readonly properties: Record<string, unknown>;
+    /** Client timestamp (milliseconds since epoch) */
+    readonly timestamp: number;
+    /** Unique visitor identifier (persists across sessions) */
+    readonly visitor_id: string;
+    /** Session identifier (resets on new browser session) */
+    readonly session_id: string;
+    /** Current page URL */
+    readonly page_url: string;
+    /** Page title */
+    readonly page_title?: string;
+    /** Referrer URL */
+    readonly referrer?: string;
+    /** User agent string */
+    readonly user_agent: string;
+    /** Screen width in pixels */
+    readonly screen_width: number;
+    /** Screen height in pixels */
+    readonly screen_height: number;
+    /** UTM parameters if present */
+    readonly utm?: UtmParams;
+};
+/**
+ * Queued event waiting to be flushed.
+ * Contains only user-provided data; context is added at flush time.
+ */
+export type QueuedEvent = {
+    /** Event name */
+    readonly event: string;
+    /** Custom event properties */
+    readonly properties: Record<string, unknown>;
+    /** Timestamp when event was queued */
+    readonly timestamp: number;
+};
+/**
+ * Network connection type as reported by the Network Information API.
+ * Used for adaptive batching strategies.
+ */
+export type ConnectionType = 'slow-2g' | '2g' | '3g' | '4g' | 'unknown';
+/**
+ * Network information for adaptive behavior.
+ * Based on the Network Information API.
+ */
+export type NetworkInfo = {
+    /** Effective connection type */
+    readonly effectiveType: ConnectionType;
+    /** Downlink speed in Mbps */
+    readonly downlink?: number;
+    /** Round-trip time in milliseconds */
+    readonly rtt?: number;
+    /** Whether the user has enabled data saver mode */
+    readonly saveData?: boolean;
+};
+/**
+ * Batch of events sent to the server.
+ * Includes API key for authentication.
+ */
+export type EventBatch = {
+    /** API key for authentication */
+    readonly api_key: string;
+    /** Array of events in this batch */
+    readonly events: readonly RawEvent[];
+};
+/**
+ * Adaptive settings computed based on network conditions.
+ * Adjusts SDK behavior for optimal performance.
+ */
+export type AdaptiveSettings = {
+    /** Maximum events to queue before forcing a flush */
+    readonly maxQueueSize: number;
+    /** Interval between automatic flushes in milliseconds */
+    readonly flushInterval: number;
+    /** Whether to compress event payloads */
+    readonly compressionEnabled: boolean;
+};
+/**
+ * SDK internal state.
+ */
+export type SdkState = {
+    /** Whether the SDK has been initialized */
+    initialized: boolean;
+    /** Current event queue */
+    queue: QueuedEvent[];
+    /** Flush timer ID */
+    flushTimerId: ReturnType<typeof setTimeout> | null;
+    /** Current visitor ID */
+    visitorId: VisitorId | null;
+    /** Current session ID */
+    sessionId: SessionId | null;
+};
+/**
+ * Check if a value is a valid UTM params object.
+ */
+export declare function isValidUtmParams(value: unknown): value is UtmParams;
+/**
+ * Check if a value is a valid RawEvent.
+ * Performs runtime validation of event structure.
+ */
+export declare function isValidEvent(value: unknown): value is RawEvent;
+/**
+ * Check if a value is a valid AnalyticsConfig.
+ */
+export declare function isValidConfig(value: unknown): value is AnalyticsConfig;
+/**
+ * Check if a value is a valid QueuedEvent.
+ */
+export declare function isValidQueuedEvent(value: unknown): value is QueuedEvent;
+/**
+ * Create a branded VisitorId from a string.
+ * Use this when generating or parsing visitor IDs.
+ */
+export declare function createVisitorId(id: string): VisitorId;
+/**
+ * Create a branded SessionId from a string.
+ * Use this when generating or parsing session IDs.
+ */
+export declare function createSessionId(id: string): SessionId;
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_CONFIG: Omit<ResolvedConfig, 'apiKey'>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @youranalytics/web-sdk Utility Functions
+ * Performance-focused utilities with browser compatibility
+ */
+import type { UtmParams, NetworkInfo, ConnectionType } from './types';
+/**
+ * Parse query string into key-value object.
+ * Uses URLSearchParams if available, falls back to manual parsing.
+ *
+ * @param search - Query string (with or without leading '?')
+ * @returns Parsed key-value pairs
+ *
+ * @example
+ * parseQueryString('?foo=bar&baz=qux')
+ * // Returns: { foo: 'bar', baz: 'qux' }
+ */
+export declare function parseQueryString(search: string): Record<string, string>;
+/**
+ * Extract UTM parameters from current URL query string.
+ * Handles both standard query strings and hash-based routing.
+ *
+ * @returns UTM parameters found in URL
+ *
+ * @example
+ * // URL: https://example.com?utm_source=google&utm_medium=cpc
+ * getUtmParams()
+ * // Returns: { source: 'google', medium: 'cpc' }
+ */
+export declare function getUtmParams(): UtmParams;
+/**
+ * Get detailed network quality information.
+ * Uses the Network Information API when available.
+ *
+ * @returns Network info or null if API not available
+ */
+export declare function getConnectionInfo(): NetworkInfo | null;
+/**
+ * Get simplified connection type.
+ * Returns 'unknown' if Network Information API is not available.
+ *
+ * @returns Connection type: 'slow-2g' | '2g' | '3g' | '4g' | 'unknown'
+ */
+export declare function getConnectionType(): ConnectionType;
+/**
+ * Detect if the current user agent is a bot or crawler.
+ * Used to skip tracking for automated traffic.
+ *
+ * @returns true if user agent appears to be a bot
+ */
+export declare function isBot(): boolean;
+/**
+ * Debounce function calls.
+ * Delays execution until after wait milliseconds have elapsed
+ * since the last time the function was invoked.
+ *
+ * @param func - Function to debounce
+ * @param wait - Milliseconds to wait
+ * @returns Debounced function
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle function calls.
+ * Ensures function runs at most once per specified time period.
+ *
+ * @param func - Function to throttle
+ * @param limit - Minimum milliseconds between calls
+ * @returns Throttled function
+ */
+export declare function throttle<T extends (...args: unknown[]) => unknown>(func: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Check if navigator.sendBeacon is available.
+ * Beacon API allows reliable data sending even when page is unloading.
+ *
+ * @returns true if sendBeacon is available
+ */
+export declare function supportsBeacon(): boolean;
+/**
+ * Check if Fetch API is available.
+ *
+ * @returns true if fetch is available
+ */
+export declare function supportsFetch(): boolean;
+/**
+ * Check if CompressionStream is available for GZIP compression.
+ *
+ * @returns true if compression is available
+ */
+export declare function supportsCompression(): boolean;
+/**
+ * Reset capability cache.
+ * Useful for testing.
+ */
+export declare function resetCapabilityCache(): void;
+/**
+ * Sanitize event names for consistency and safety.
+ * - Converts to lowercase
+ * - Replaces spaces with underscores
+ * - Removes special characters (keeps alphanumeric and underscore)
+ * - Limits length to 100 characters
+ *
+ * @param name - Raw event name
+ * @returns Sanitized event name
+ */
+export declare function sanitizeEventName(name: string): string;
+/**
+ * Sanitize event properties for safe transmission.
+ * - Removes undefined values
+ * - Converts Dates to ISO strings
+ * - Limits string lengths
+ * - Limits object depth to prevent circular references
+ * - Handles NaN and Infinity
+ *
+ * @param props - Raw properties object
+ * @returns Sanitized properties
+ */
+export declare function sanitizeProperties(props: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Get current page URL safely.
+ *
+ * @returns Current page URL or empty string
+ */
+export declare function getPageUrl(): string;
+/**
+ * Get current page title safely.
+ *
+ * @returns Current page title or undefined
+ */
+export declare function getPageTitle(): string | undefined;
+/**
+ * Get referrer URL safely.
+ *
+ * @returns Referrer URL or undefined
+ */
+export declare function getReferrer(): string | undefined;
+/**
+ * Get user agent string safely.
+ *
+ * @returns User agent or empty string
+ */
+export declare function getUserAgent(): string;
+/**
+ * Get screen dimensions safely.
+ *
+ * @returns Object with width and height
+ */
+export declare function getScreenDimensions(): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAiBtE;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+CvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAiCxC;AA+BD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAetD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAelD;AAgDD;;;;;GAKG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAwB/B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAalC;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAsBlC;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAWxC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CASvC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAS7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAeD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAetD;AAuED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAMD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,MAAM,CASnC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CASjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAShD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CASrC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAYvE"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "analyzer-analytics",
+  "version": "0.1.0",
+  "description": "Lightweight analytics tracker for web applications (<3KB gzipped)",
+  "type": "module",
+  "main": "dist/analytics.js",
+  "module": "dist/analytics.esm.js",
+  "types": "dist/index.d.ts",
+  "browser": "dist/analytics.min.js",
+  "unpkg": "dist/analytics.min.js",
+  "jsdelivr": "dist/analytics.min.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/analytics.esm.js",
+      "require": "./dist/analytics.js",
+      "default": "./dist/analytics.esm.js"
+    },
+    "./iife": {
+      "default": "./dist/analytics.js"
+    },
+    "./min": {
+      "default": "./dist/analytics.min.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "dev": "bun build src/index.ts --outdir=dist --watch",
+    "build": "bun run clean && bun run build:all && bun run size-check",
+    "build:all": "bun run build:core && bun run build:full && bun run build:types",
+    "build:core": "bun build src/core.ts --outfile=dist/analytics.min.js --format=iife --target=browser --global-name=Analytics --minify",
+    "build:slim": "bun build src/slim.ts --outfile=dist/analytics.slim.min.js --format=iife --target=browser --global-name=Analytics --minify",
+    "build:full": "bun run build:esm && bun run build:iife && bun run build:full-min",
+    "build:esm": "bun build src/index.ts --outfile=dist/analytics.esm.js --format=esm --target=browser",
+    "build:iife": "bun build src/index.ts --outfile=dist/analytics.js --format=iife --target=browser --global-name=Analytics",
+    "build:full-min": "bun build src/index.ts --outfile=dist/analytics.full.min.js --format=iife --target=browser --global-name=Analytics --minify",
+    "build:types": "tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist",
+    "build:analyze": "bun run build:min && echo '\\n📊 Bundle Analysis:' && bun run scripts/analyze-bundle.ts",
+    "clean": "rm -rf dist && mkdir -p dist",
+    "size-check": "bun run scripts/check-size.ts",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit && echo 'Typecheck passed'",
+    "prepublishOnly": "bun run build && bun run test"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "@types/bun": "latest",
+    "bun-types": "latest"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "lightweight",
+    "web",
+    "performance",
+    "privacy",
+    "pageview",
+    "events",
+    "beacon"
+  ],
+  "author": "gonalc",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gonalc/analyzer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gonalc/analyzer/issues"
+  },
+  "homepage": "https://github.com/gonalc/analyzer#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}