analyzer-analytics 0.1.0

package/dist/analytics.min.js

@@ -0,0 +1 @@
+(()=>{var{defineProperty:x,getOwnPropertyNames:P,getOwnPropertyDescriptor:Q}=Object,T=Object.prototype.hasOwnProperty;var G=new WeakMap,U=(j)=>{var m=G.get(j),q;if(m)return m;if(m=x({},"__esModule",{value:!0}),j&&typeof j==="object"||typeof j==="function")P(j).map((w)=>!T.call(m,w)&&x(m,w,{get:()=>j[w],enumerable:!(q=Q(j,w))||q.enumerable}));return G.set(j,m),m};var W=(j,m)=>{for(var q in m)x(j,q,{get:m[q],enumerable:!0,configurable:!0,set:(w)=>m[q]=()=>w})};var $={};W($,{default:()=>z,VERSION:()=>M,Analytics:()=>F});function H(){return Date.now()+"_"+Math.random().toString(36).slice(2,10)}function J(j,m=!1){try{return(m?sessionStorage:localStorage).getItem(j)}catch{return null}}function L(j,m,q=!1){try{(q?sessionStorage:localStorage).setItem(j,m)}catch{}}function X(){let j=J("_a_vid");if(!j)j=H(),L("_a_vid",j);return j}function Y(){let j=J("_a_sid",!0);if(!j)j=H(),L("_a_sid",j,!0);return j}function Z(){let j=navigator.userAgent?.toLowerCase()||"";return/bot|crawler|spider|googlebot|bingbot|slurp|duckduckbot|baiduspider|yandex|headless|phantom|selenium|puppeteer/.test(j)}function _(j){return j.toLowerCase().replace(/\s+/g,"_").replace(/[^a-z0-9_]/g,"").slice(0,100)||"event"}class F{cfg;q=[];vid;sid;timer=null;ok=!1;constructor(j){if(!j.apiKey)throw new Error("API key required");if(this.cfg={apiKey:j.apiKey,endpoint:j.endpoint||"http://localhost:8080",debug:j.debug||!1,autoTrack:j.autoTrack!==!1,maxQueueSize:j.maxQueueSize||10,flushInterval:j.flushInterval||5000},this.vid=X(),this.sid=Y(),Z())return;if(this.ok=!0,this.cfg.autoTrack)this.trackPV();if(this.startTimer(),typeof window!=="undefined")window.addEventListener("beforeunload",()=>this.send())}track(j,m={}){if(!this.ok)return;if(this.q.push({e:_(j),p:m,t:Date.now()}),this.q.length>=this.cfg.maxQueueSize)this.flush()}trackPV(){this.track("pageview")}async flush(){if(!this.q.length)return;let j=this.q;this.q=[],await this.send(j)}async send(j=this.q){if(!j.length)return;let m={api_key:this.cfg.apiKey,events:j.map((w)=>this.build(w))},q=this.cfg.endpoint+"/events";try{if(navigator.sendBeacon?.(q,new Blob([JSON.stringify(m)],{type:"application/json"})))return;await fetch(q,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.cfg.apiKey}`},body:JSON.stringify(m),keepalive:!0})}catch(w){if(this.cfg.debug)console.error("[Analytics]",w)}}build(j){return{event:j.e,properties:j.p,timestamp:j.t,visitor_id:this.vid,session_id:this.sid,page_url:location.href,page_title:document.title,referrer:document.referrer,user_agent:navigator.userAgent,screen_width:screen.width,screen_height:screen.height}}startTimer(){if(this.cfg.flushInterval>0)this.timer=setInterval(()=>this.flush(),this.cfg.flushInterval)}destroy(){if(this.timer)clearInterval(this.timer);this.send(),this.ok=!1}getVisitorId(){return this.vid}getSessionId(){return this.sid}}var M="0.1.0",D={version:M,instance:null,init(j,m={}){if(this.instance)this.instance.destroy();return this.instance=new F({apiKey:j,...m}),this.instance},track(j,m={}){if(!this.instance){console.warn("[Analytics] Not initialized");return}this.instance.track(j,m)},async flush(){if(this.instance)await this.instance.flush()}};if(typeof window!=="undefined"){window.analytics=D;let j=document.currentScript,m=j?.getAttribute("data-api-key");if(m)D.init(m,{endpoint:j?.getAttribute("data-endpoint")||void 0,debug:j?.getAttribute("data-debug")==="true"})}var z=D;})();

package/dist/core.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @youranalytics/web-sdk - Core Build
+ * Ultra-minimal analytics SDK (<3KB gzipped)
+ * Basic tracking without adaptive networking
+ * @version 0.1.0
+ */
+interface Config {
+    apiKey: string;
+    endpoint: string;
+    debug: boolean;
+    autoTrack: boolean;
+    maxQueueSize: number;
+    flushInterval: number;
+}
+declare class Core {
+    private cfg;
+    private q;
+    private vid;
+    private sid;
+    private timer;
+    private ok;
+    constructor(config: Partial<Config> & {
+        apiKey: string;
+    });
+    track(event: string, props?: Record<string, unknown>): void;
+    trackPV(): void;
+    flush(): Promise<void>;
+    private send;
+    private build;
+    private startTimer;
+    destroy(): void;
+    getVisitorId(): string;
+    getSessionId(): string;
+}
+declare const VERSION = "0.1.0";
+interface GA {
+    version: string;
+    instance: Core | null;
+    init(apiKey: string, cfg?: Partial<Config>): Core;
+    track(e: string, p?: Record<string, unknown>): void;
+    flush(): Promise<void>;
+}
+declare const ga: GA;
+export { Core as Analytics, VERSION };
+export default ga;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,MAAM;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAwED,cAAM,IAAI;IACR,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,CAAC,CAAmE;IAC5E,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,EAAE,CAAS;gBAEP,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IA0BxD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAM/D,OAAO,IAAI,IAAI;IAIT,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,IAAI;IA4BlB,OAAO,CAAC,KAAK;IAgBb,OAAO,CAAC,UAAU;IAMlB,OAAO,IAAI,IAAI;IAMf,YAAY,IAAI,MAAM;IACtB,YAAY,IAAI,MAAM;CACvB;AAMD,QAAA,MAAM,OAAO,UAAU,CAAC;AAExB,UAAU,EAAE;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAClD,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,QAAA,MAAM,EAAE,EAAE,EAaT,CAAC;AAaF,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,OAAO,EAAE,CAAC;AACtC,eAAe,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @youranalytics/web-sdk
+ * Lightweight analytics SDK optimized for slow networks
+ * @version 0.1.0
+ * @license MIT
+ */
+export { Analytics, createAnalytics } from './analytics';
+export type { AnalyticsConfig, ResolvedConfig, RawEvent, QueuedEvent, UtmParams, ConnectionType, NetworkInfo, EventBatch, AdaptiveSettings as AdaptiveSettingsType, SdkState, VisitorId, SessionId, } from './types';
+export { isValidEvent, isValidConfig, isValidQueuedEvent, isValidUtmParams, createVisitorId, createSessionId, DEFAULT_CONFIG, } from './types';
+export { generateId, getVisitorId, getSessionId, getItem, setItem, getSessionItem, setSessionItem, isStorageAvailable, resetStorageCache, clearVisitorId, clearSessionId, STORAGE_KEYS, } from './storage';
+export { parseQueryString, getUtmParams, getConnectionInfo, getConnectionType, isBot, debounce, throttle, supportsBeacon, supportsFetch, supportsCompression, resetCapabilityCache, sanitizeEventName, sanitizeProperties, getPageUrl, getPageTitle, getReferrer, getUserAgent, getScreenDimensions, } from './utils';
+export { sendBeacon, sendFetch, sendWithRetry, send, queueOfflineEvents, getOfflineEvents, clearOfflineEvents, isOffline, onOnline, setDebugMode, NetworkError, } from './network';
+export { NetworkAdapter, RetryStrategy, EventPriority, sortByPriority, assignPriority, isDataSaverEnabled, getRtt, getDownlink, sendAdaptive, getNetworkAdapter, resetNetworkAdapter, type AdaptiveSettings, type BatchingStrategy, type PrioritizedEvent, } from './network-adapter';
+import { Analytics } from './analytics';
+import type { AnalyticsConfig } from './types';
+/**
+ * Version of the SDK
+ */
+export declare const VERSION = "0.1.0";
+/**
+ * Global analytics interface for script tag usage.
+ * Provides a simple API that can be accessed via window.analytics
+ */
+export interface GlobalAnalytics {
+    /** SDK version */
+    readonly version: string;
+    /** Current analytics instance (null if not initialized) */
+    instance: Analytics | null;
+    /**
+     * Initialize the analytics SDK
+     * @param apiKey - Your API key from the analytics dashboard
+     * @param config - Optional configuration overrides
+     * @returns The Analytics instance
+     */
+    init(apiKey: string, config?: Partial<Omit<AnalyticsConfig, 'apiKey'>>): Analytics;
+    /**
+     * Track a custom event
+     * @param event - Event name
+     * @param properties - Optional event properties
+     */
+    track(event: string, properties?: Record<string, unknown>): void;
+    /**
+     * Track a page view
+     */
+    trackPageView(): void;
+    /**
+     * Get the current visitor ID
+     * @returns Visitor ID or null if not initialized
+     */
+    getVisitorId(): string | null;
+    /**
+     * Get the current session ID
+     * @returns Session ID or null if not initialized
+     */
+    getSessionId(): string | null;
+    /**
+     * Manually flush queued events
+     * @returns Promise that resolves when flush is complete
+     */
+    flush(): Promise<void>;
+    /**
+     * Destroy the analytics instance and clean up
+     */
+    destroy(): void;
+}
+/**
+ * Global analytics instance
+ */
+declare const globalAnalytics: GlobalAnalytics;
+/**
+ * Default export is the global analytics object.
+ * Can be used as: import analytics from '@youranalytics/web-sdk'
+ */
+export default globalAnalytics;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EACV,eAAe,EACf,cAAc,EACd,QAAQ,EACR,WAAW,EACX,SAAS,EACT,cAAc,EACd,WAAW,EACX,UAAU,EACV,gBAAgB,IAAI,oBAAoB,EACxC,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EAEL,gBAAgB,EAChB,YAAY,EAEZ,iBAAiB,EACjB,iBAAiB,EAEjB,KAAK,EAEL,QAAQ,EACR,QAAQ,EAER,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EAEpB,iBAAiB,EACjB,kBAAkB,EAElB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,IAAI,EACJ,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,MAAM,EACN,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,2DAA2D;IAC3D,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAE3B;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;IAEnF;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEjE;;OAEG;IACH,aAAa,IAAI,IAAI,CAAC;IAEtB;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AA+DD;;GAEG;AACH,QAAA,MAAM,eAAe,EAAE,eAAyC,CAAC;AAgEjE;;;GAGG;AACH,eAAe,eAAe,CAAC"}

package/dist/network-adapter.d.ts

@@ -0,0 +1,243 @@
+/**
+ * @youranalytics/web-sdk Network Adapter
+ * Adaptive behavior for different network conditions
+ * Optimized for 2G/3G networks with smart batching and compression
+ */
+import type { ConnectionType, RawEvent, EventBatch } from './types';
+/**
+ * Batching strategy based on network conditions.
+ * - aggressive: Large batches, less frequent sends (slow networks)
+ * - balanced: Medium batches, moderate frequency (3G)
+ * - conservative: Small batches, frequent sends (fast networks)
+ */
+export type BatchingStrategy = 'aggressive' | 'balanced' | 'conservative';
+/**
+ * Adaptive settings computed from network conditions.
+ */
+export interface AdaptiveSettings {
+    /** Maximum events to queue before forcing a flush */
+    maxQueueSize: number;
+    /** Interval between automatic flushes in milliseconds */
+    flushInterval: number;
+    /** Whether to compress event payloads */
+    compressionEnabled: boolean;
+    /** Batching strategy name */
+    batchingStrategy: BatchingStrategy;
+}
+/**
+ * Event priority levels for request prioritization.
+ */
+export declare enum EventPriority {
+    /** Low priority: page views, impressions */
+    LOW = 0,
+    /** Normal priority: custom events, interactions */
+    NORMAL = 1,
+    /** High priority: conversions, errors, critical events */
+    HIGH = 2
+}
+/**
+ * Event with priority information.
+ */
+export interface PrioritizedEvent extends RawEvent {
+    priority: EventPriority;
+}
+/**
+ * Check if user has enabled data saver mode.
+ * Data saver mode indicates the user wants to minimize data usage.
+ *
+ * @returns true if data saver is enabled
+ */
+export declare function isDataSaverEnabled(): boolean;
+/**
+ * Get the round-trip time (RTT) in milliseconds.
+ * Returns a default value if not available.
+ *
+ * @returns RTT in milliseconds
+ */
+export declare function getRtt(): number;
+/**
+ * Get the downlink speed in Mbps.
+ * Returns a default value if not available.
+ *
+ * @returns Downlink speed in Mbps
+ */
+export declare function getDownlink(): number;
+/**
+ * Sort events by priority (high priority first).
+ * Useful for slow connections where high-priority events should be sent first.
+ *
+ * @param events - Array of prioritized events
+ * @returns Sorted array with high priority events first
+ */
+export declare function sortByPriority(events: PrioritizedEvent[]): PrioritizedEvent[];
+/**
+ * Assign priority to an event based on its type.
+ *
+ * @param event - Raw event to prioritize
+ * @returns Event with priority assigned
+ */
+export declare function assignPriority(event: RawEvent): PrioritizedEvent;
+/**
+ * Smart retry strategy with exponential backoff.
+ * Adapts max retries based on connection quality.
+ */
+export declare class RetryStrategy {
+    private attempts;
+    private readonly maxRetries;
+    /**
+     * Create a new retry strategy.
+     *
+     * @param connectionType - Current connection type
+     */
+    constructor(connectionType?: ConnectionType);
+    /**
+     * Get the backoff delay for the current attempt.
+     * Uses exponential backoff with a maximum cap.
+     *
+     * Formula: min(1000 * 2^attempts, 30000)
+     * - Retry 1: 1s
+     * - Retry 2: 2s
+     * - Retry 3: 4s
+     * - Retry 4: 8s
+     * - Retry 5: 16s
+     * - Max: 30s
+     *
+     * @returns Delay in milliseconds
+     */
+    getBackoffDelay(): number;
+    /**
+     * Check if a retry should be attempted based on the error.
+     *
+     * Retry on:
+     * - Network errors (fetch failed)
+     * - 5xx server errors
+     * - Timeout errors
+     * - 429 rate limit errors
+     *
+     * Don't retry on:
+     * - 4xx client errors (except 429)
+     * - Max retries reached
+     *
+     * @param error - Error to evaluate
+     * @returns true if should retry
+     */
+    shouldRetry(error: Error): boolean;
+    /**
+     * Record an attempt.
+     */
+    recordAttempt(): void;
+    /**
+     * Reset the strategy.
+     */
+    reset(): void;
+    /**
+     * Get number of attempts made.
+     */
+    getAttempts(): number;
+    /**
+     * Get maximum retries allowed.
+     */
+    getMaxRetries(): number;
+}
+/**
+ * Network adapter that provides adaptive settings based on connection quality.
+ * Listens for connection changes and notifies subscribers.
+ */
+export declare class NetworkAdapter {
+    private currentSettings;
+    private connection;
+    private changeCallbacks;
+    private boundHandleChange;
+    private cachedConnectionType;
+    private lastUpdateTime;
+    private readonly cacheTimeout;
+    /**
+     * Create a new network adapter.
+     * Automatically detects connection and sets up listeners.
+     */
+    constructor();
+    /**
+     * Compute settings based on current connection.
+     */
+    private computeSettings;
+    /**
+     * Handle connection change event.
+     */
+    private handleConnectionChange;
+    /**
+     * Get current connection type with caching.
+     */
+    private getConnectionType;
+    /**
+     * Get current adaptive settings.
+     *
+     * @returns Current settings based on connection quality
+     */
+    getSettings(): AdaptiveSettings;
+    /**
+     * Register a callback for connection changes.
+     * Callback is invoked when connection quality changes.
+     *
+     * @param callback - Function to call with new settings
+     * @returns Cleanup function to remove the callback
+     */
+    onConnectionChange(callback: (settings: AdaptiveSettings) => void): () => void;
+    /**
+     * Check if compression should be used.
+     * Based on connection type, CompressionStream availability, and data saver mode.
+     *
+     * @returns true if compression should be enabled
+     */
+    shouldCompress(): boolean;
+    /**
+     * Get the optimal batch size for current connection.
+     * Considers connection speed, RTT, and data saver mode.
+     *
+     * @returns Optimal batch size
+     */
+    getOptimalBatchSize(): number;
+    /**
+     * Get a retry strategy appropriate for current connection.
+     *
+     * @returns RetryStrategy configured for connection
+     */
+    getRetryStrategy(): RetryStrategy;
+    /**
+     * Check if network conditions are poor.
+     *
+     * @returns true if on slow connection
+     */
+    isSlowConnection(): boolean;
+    /**
+     * Get recommended timeout for requests.
+     * Based on RTT and connection type.
+     *
+     * @returns Timeout in milliseconds
+     */
+    getRecommendedTimeout(): number;
+    /**
+     * Clean up the adapter.
+     * Removes event listeners.
+     */
+    destroy(): void;
+}
+/**
+ * Send data with adaptive behavior based on network conditions.
+ * Chooses the best transport method and applies compression as needed.
+ *
+ * @param url - Endpoint URL
+ * @param data - Event batch to send
+ * @param adapter - Network adapter for connection info
+ */
+export declare function sendAdaptive(url: string, data: EventBatch, adapter: NetworkAdapter): Promise<void>;
+/**
+ * Get or create the global network adapter instance.
+ *
+ * @returns Global NetworkAdapter instance
+ */
+export declare function getNetworkAdapter(): NetworkAdapter;
+/**
+ * Reset the global adapter (for testing).
+ */
+export declare function resetNetworkAdapter(): void;
+//# sourceMappingURL=network-adapter.d.ts.map

package/dist/network-adapter.d.ts.map

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

package/dist/network.d.ts

@@ -0,0 +1,175 @@
+/**
+ * @youranalytics/web-sdk Network Communication Layer
+ * Handles sending events to the analytics server with fallbacks and offline support
+ */
+import type { EventBatch, RawEvent } from './types';
+/**
+ * Enable or disable debug logging.
+ * @param enabled - Whether to enable debug mode
+ */
+export declare function setDebugMode(enabled: boolean): void;
+/**
+ * Custom error class for network-related errors.
+ * Includes status code and retry information.
+ */
+export declare class NetworkError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly retry?: boolean | undefined;
+    constructor(message: string, statusCode?: number | undefined, retry?: boolean | undefined);
+}
+/**
+ * Send data using navigator.sendBeacon.
+ *
+ * Advantages:
+ * - Survives page navigation
+ * - Non-blocking
+ * - Browser queues the request
+ *
+ * Limits:
+ * - Max 64KB payload
+ * - No response handling
+ * - No retry on failure
+ *
+ * @param url - Endpoint URL
+ * @param data - Event batch to send
+ * @returns true if queued successfully, false otherwise
+ */
+export declare function sendBeacon(url: string, data: EventBatch): boolean;
+/**
+ * Send data using fetch API.
+ * Used when sendBeacon fails or isn't available.
+ *
+ * Features:
+ * - Handles responses
+ * - Can retry on failure
+ * - Works with larger payloads
+ * - Sends Authorization header with Bearer token
+ *
+ * @param url - Endpoint URL
+ * @param data - Event batch to send
+ * @param apiKey - Optional API key for Authorization header
+ * @throws NetworkError on failure
+ */
+export declare function sendFetch(url: string, data: EventBatch, apiKey?: string): Promise<void>;
+/**
+ * Send with retry on failure using exponential backoff.
+ *
+ * Backoff strategy:
+ * - Retry 1: wait 1s
+ * - Retry 2: wait 2s
+ * - Retry 3: wait 4s
+ * - Then give up
+ *
+ * Only retry on network errors, not 4xx errors.
+ *
+ * @param url - Endpoint URL
+ * @param data - Event batch to send
+ * @param maxRetries - Maximum number of retry attempts (default: 3)
+ * @param apiKey - Optional API key for Authorization header
+ * @throws NetworkError if all retries fail
+ */
+export declare function sendWithRetry(url: string, data: EventBatch, maxRetries?: number, apiKey?: string): Promise<void>;
+/**
+ * Compress JSON payload using GZIP.
+ * Only if CompressionStream is available.
+ *
+ * Savings: ~50-70% size reduction
+ *
+ * @param data - String data to compress
+ * @returns Compressed Blob or original string if compression not supported
+ */
+export declare function compressData(data: string): Promise<Blob | string>;
+/**
+ * Send compressed data using fetch.
+ * Falls back to uncompressed if compression fails.
+ *
+ * @param url - Endpoint URL
+ * @param data - Event batch to send
+ * @param apiKey - Optional API key for Authorization header
+ */
+export declare function sendCompressed(url: string, data: EventBatch, apiKey?: string): Promise<void>;
+/**
+ * Store events in localStorage when offline.
+ * Limits to MAX_OFFLINE_EVENTS to prevent quota issues.
+ *
+ * @param events - Events to queue for later sending
+ */
+export declare function queueOfflineEvents(events: RawEvent[]): void;
+/**
+ * Retrieve queued offline events.
+ * Parses from localStorage.
+ *
+ * @returns Array of queued events, or empty array if none or error
+ */
+export declare function getOfflineEvents(): RawEvent[];
+/**
+ * Clear offline queue after successful send.
+ */
+export declare function clearOfflineEvents(): void;
+/**
+ * Check if the browser is currently offline.
+ *
+ * @returns true if offline
+ */
+export declare function isOffline(): boolean;
+/**
+ * Register a callback to be called when the browser comes back online.
+ * Returns a cleanup function to remove the listener.
+ *
+ * @param callback - Function to call when online
+ * @returns Cleanup function
+ */
+export declare function onOnline(callback: () => void): () => void;
+/**
+ * Generate unique request ID.
+ * Format: timestamp_random
+ * Used to prevent duplicate sends.
+ *
+ * @returns Unique request ID
+ */
+export declare function generateRequestId(): string;
+/**
+ * Check if request was already sent.
+ * Checks sent IDs in sessionStorage.
+ *
+ * @param requestId - Request ID to check
+ * @returns true if request was already sent
+ */
+export declare function wasRequestSent(requestId: string): boolean;
+/**
+ * Mark request as sent.
+ * Stores in sessionStorage. Keeps last MAX_TRACKED_REQUESTS IDs.
+ *
+ * @param requestId - Request ID to mark as sent
+ */
+export declare function markRequestSent(requestId: string): void;
+/**
+ * Clear all tracked request IDs.
+ * Useful for testing.
+ */
+export declare function clearSentRequests(): void;
+/**
+ * Send events to the server using the best available method.
+ * Handles offline state, deduplication, and fallbacks.
+ *
+ * @param url - Endpoint URL
+ * @param data - Event batch to send
+ * @param options - Send options
+ * @returns Promise that resolves when sent (or queued if offline)
+ */
+export declare function send(url: string, data: EventBatch, options?: {
+    useBeacon?: boolean;
+    compress?: boolean;
+    retry?: boolean;
+    requestId?: string;
+    apiKey?: string;
+}): Promise<void>;
+export declare const _testing: {
+    OFFLINE_QUEUE_KEY: string;
+    SENT_REQUESTS_KEY: string;
+    MAX_OFFLINE_EVENTS: number;
+    MAX_TRACKED_REQUESTS: number;
+    MAX_BEACON_PAYLOAD: number;
+    BASE_RETRY_DELAY: number;
+};
+//# sourceMappingURL=network.d.ts.map

package/dist/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAgCpD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEnD;AAwBD;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,UAAU,CAAC,EAAE,MAAM;aACnB,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,KAAK,CAAC,EAAE,OAAO,YAAA;CAUlC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAkCjE;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD7F;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,EAChB,UAAU,SAAI,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAoCf;AAMD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CA6BvE;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAiDf;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CA0B3D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,EAAE,CA0B7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CASzC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAUzD;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AA0CD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmBvD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAQxC;AAMD;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC,IAAI,CAAC,CAsDf;AAMD,eAAO,MAAM,QAAQ;;;;;;;CAOpB,CAAC"}

package/dist/slim.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @youranalytics/web-sdk - Slim Build
+ * Minimal analytics SDK (<3KB gzipped)
+ * Only includes core tracking functionality
+ * @version 0.1.0
+ */
+import { Analytics } from './analytics';
+import type { AnalyticsConfig } from './types';
+export { Analytics };
+export type { AnalyticsConfig };
+export declare const VERSION = "0.1.0";
+/**
+ * Global analytics interface for script tag usage.
+ */
+interface GlobalAnalytics {
+    readonly version: string;
+    instance: Analytics | null;
+    init(apiKey: string, config?: Partial<Omit<AnalyticsConfig, 'apiKey'>>): Analytics;
+    track(event: string, properties?: Record<string, unknown>): void;
+    trackPageView(): void;
+    flush(): Promise<void>;
+    destroy(): void;
+}
+declare const globalAnalytics: GlobalAnalytics;
+export default globalAnalytics;
+//# sourceMappingURL=slim.d.ts.map

package/dist/slim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slim.d.ts","sourceRoot":"","sources":["../src/slim.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM/C,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,CAAC;AAMhC,eAAO,MAAM,OAAO,UAAU,CAAC;AAM/B;;GAEG;AACH,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;IACnF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,aAAa,IAAI,IAAI,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,QAAA,MAAM,eAAe,EAAE,eAgCtB,CAAC;AAsBF,eAAe,eAAe,CAAC"}