@metrone-io/sdk 1.0.1 → 1.2.0

package/dist/core/Metrone.d.ts

@@ -6,8 +6,10 @@ export interface AnalyticsConfig {
     apiKey: string;
     projectId?: string;
     endpoint?: string;
+    batchEndpoint?: string;
     debug?: boolean;
     autoTrack?: boolean;
+    autoTrackSPA?: boolean;
     autoUpdate?: boolean;
     batchSize?: number;
     flushInterval?: number;
@@ -42,11 +44,27 @@ export declare class Metrone {
     private config;
     private sessionId;
     private isInitialized;
+    private trackingActive;
     private eventQueue;
     private isOnline;
     private version;
     private updateCheckInterval;
-    constructor(config: AnalyticsConfig);
+    private flushTimerId;
+    private boundVisibilityHandler;
+    private boundBeforeUnloadHandler;
+    private lastTrackedPath;
+    constructor(config: AnalyticsConfig | string);
+    /**
+     * Explicitly start tracking. Called automatically by the constructor unless
+     * tracking is blocked by DNT or consent. Can also be called manually if you
+     * want to separate initialization from activation.
+     */
+    start(): void;
+    private activate;
+    /**
+     * Whether the SDK is actively tracking events (not disabled by DNT/consent).
+     */
+    isActive(): boolean;
     /**
      * Track a page view
      */
@@ -122,110 +140,51 @@ export declare class Metrone {
         duration?: number;
         metadata?: EventData;
     }): void;
-    /**
-     * Send event to analytics API
-     */
     private sendEvent;
-    /**
-     * Send request to analytics API
-     */
     private sendRequest;
-    /**
-     * Flush batch of events
-     */
     private flushBatch;
     private sendBatchRequest;
     /**
-     * Queue event for offline processing
+     * Flush queued events using sendBeacon (survives page unload).
      */
+    private beaconFlush;
     private queueEvent;
-    /**
-     * Process offline queue when back online
-     */
     private processQueue;
-    /**
-     * Set up online/offline detection
-     */
     private setupOnlineDetection;
-    /**
-     * Set up batch processing
-     */
     private setupBatchProcessing;
     /**
-     * Set up auto-updates
+     * Flush pending events on page hide / beforeunload using sendBeacon.
      */
-    private setupAutoUpdates;
+    private setupPageUnloadFlush;
     /**
-     * Check for SDK updates
+     * Auto-track SPA route changes via History API and popstate.
      */
-    checkForUpdates(): Promise<UpdateInfo>;
+    private setupSPATracking;
     /**
-     * Handle SDK update
+     * Check for SDK updates (only relevant for script-tag installations).
      */
+    checkForUpdates(): Promise<UpdateInfo>;
     private handleUpdate;
-    /**
-     * Load new SDK version
-     */
     private loadNewVersion;
-    /**
-     * Notify about available update
-     */
     private notifyUpdate;
     /**
-     * Generate session ID
+     * Detect whether the SDK is running inside a bundler/module context
+     * vs. a plain script-tag.
      */
+    private isModuleContext;
     private generateSessionId;
-    /**
-     * Check if Do Not Track is enabled
-     */
     private isDoNotTrackEnabled;
-    /**
-     * Check if user has given consent
-     */
     hasConsent(): boolean;
-    /**
-     * Request user consent
-     */
     requestConsent(): Promise<boolean>;
-    /**
-     * Revoke user consent
-     */
     revokeConsent(): void;
-    /**
-     * Anonymize data
-     */
     anonymize(data: string): string;
-    /**
-     * Simple hash function
-     */
     private simpleHash;
-    /**
-     * Check if running on mobile device
-     */
     isMobile(): boolean;
-    /**
-     * Get screen size
-     */
     getScreenSize(): string;
-    /**
-     * Flush pending events
-     */
     flush(): void;
-    /**
-     * Destroy SDK instance
-     */
     destroy(): void;
-    /**
-     * Get current version
-     */
     getVersion(): string;
-    /**
-     * Get session ID
-     */
     getSessionId(): string;
-    /**
-     * Get configuration
-     */
     getConfig(): AnalyticsConfig;
 }
 export declare function initAnalytics(config: AnalyticsConfig): Metrone;

package/dist/index.d.ts

@@ -5,5 +5,5 @@
 import { Metrone } from './core/Metrone';
 export { Metrone, initAnalytics, getAnalytics } from './core/Metrone';
 export type { AnalyticsConfig, EventData, CampaignData, UpdateInfo, AnalyticsEvent, BatchEvent, ConversionEvent, InteractionEvent, ProductViewEvent, WhatsAppClickEvent, PageViewEvent, DeviceInfo, LocationInfo, SessionInfo, AnalyticsStats, CampaignStats, ProjectInfo, ErrorInfo, ConsentInfo, AnalyticsCustomEvent, AnalyticsEventListener, AnalyticsSDK, AnalyticsProviderProps, AnalyticsContextValue, UseAnalyticsReturn, AnalyticsHookOptions, AnalyticsMiddleware, AnalyticsPlugin, AnalyticsConfigValidation, AnalyticsPerformanceMetrics, AnalyticsDebugInfo } from './types';
-export declare const VERSION = "1.0.1";
+export declare const VERSION = "1.2.0";
 export default Metrone;