@grainql/analytics-web 2.7.1 → 2.8.0

package/dist/debug-agent.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Debug Agent for Visual Event Tracking
+ * Provides a toolbar and element inspection mode for creating event trackers
+ */
+export interface DebugAgentConfig {
+    debug?: boolean;
+}
+export interface Tracker {
+    track(eventName: string, properties?: Record<string, unknown>): void | Promise<void>;
+    log(...args: unknown[]): void;
+}
+export interface ExistingTracker {
+    trackerId: string;
+    name: string;
+    type: string;
+    selector: string;
+    urlScope: string;
+    urlPattern?: string;
+    isEnabled: boolean;
+}
+export declare class DebugAgent {
+    private tracker;
+    private sessionId;
+    private tenantId;
+    private apiUrl;
+    private config;
+    private isDestroyed;
+    private isInspectMode;
+    private showTrackers;
+    private selectedElement;
+    private toolbarElement;
+    private panelElement;
+    private highlightElement;
+    private existingTrackers;
+    private trackerHighlights;
+    private isDragging;
+    private dragStartX;
+    private dragStartY;
+    private toolbarStartX;
+    private toolbarStartY;
+    private mouseMoveListener;
+    private clickListener;
+    private dragMoveListener;
+    private dragEndListener;
+    constructor(tracker: Tracker, sessionId: string, tenantId: string, apiUrl: string, config?: DebugAgentConfig);
+    /**
+     * Initialize the debug agent
+     */
+    private initialize;
+    /**
+     * Load existing trackers from API
+     */
+    private loadExistingTrackers;
+    /**
+     * Show the debug toolbar
+     */
+    private showToolbar;
+    /**
+     * Create highlight element for hovering
+     */
+    private createHighlightElement;
+    /**
+     * Start dragging the toolbar
+     */
+    private startDrag;
+    /**
+     * Handle drag movement
+     */
+    private onDrag;
+    /**
+     * End dragging
+     */
+    private endDrag;
+    /**
+     * Toggle tracker view
+     */
+    private toggleTrackerView;
+    /**
+     * Show tracker highlights on page
+     */
+    private showTrackerHighlights;
+    /**
+     * Hide tracker highlights
+     */
+    private hideTrackerHighlights;
+    /**
+     * Show trackers list
+     */
+    private showTrackersList;
+    /**
+     * Hide trackers list
+     */
+    private hideTrackersList;
+    /**
+     * Scroll to and highlight a tracker element
+     */
+    private scrollToTracker;
+    /**
+     * Find element by XPath selector
+     */
+    private findElementBySelector;
+    /**
+     * Toggle inspect mode
+     */
+    private toggleInspectMode;
+    /**
+     * Enable element inspection mode
+     */
+    private enableInspectMode;
+    /**
+     * Handle ESC key to exit inspect mode
+     */
+    private handleEscapeKey;
+    /**
+     * Disable element inspection mode
+     */
+    private disableInspectMode;
+    /**
+     * Handle mouse move to highlight hovered element
+     */
+    private handleMouseMove;
+    /**
+     * Handle element click to show creation panel
+     */
+    private handleElementClick;
+    /**
+     * Show tracker creation panel
+     */
+    private showCreationPanel;
+    /**
+     * Generate suggested event name from element
+     */
+    private generateEventName;
+    /**
+     * Handle tracker creation
+     */
+    private handleCreateTracker;
+    /**
+     * Create tracker via API
+     */
+    private createTracker;
+    /**
+     * Hide creation panel
+     */
+    private hideCreationPanel;
+    /**
+     * Show success message
+     */
+    private showSuccessMessage;
+    /**
+     * End debug session
+     */
+    private endDebug;
+    /**
+     * Get XPath for element
+     */
+    private getXPathForElement;
+    /**
+     * Log debug messages
+     */
+    private log;
+    /**
+     * Update toolbar stats
+     */
+    private updateToolbarStats;
+    /**
+     * Destroy the debug agent
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=debug-agent.d.ts.map

package/dist/debug-agent.d.ts.map

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