@grainql/analytics-web 2.7.1 → 2.9.0

package/dist/cjs/react/hooks/useConsent.js

@@ -1,6 +1,7 @@
 "use strict";
 /**
- * useConsent - Hook for managing user consent
+ * useConsent - Hook for managing user consent (v2.0)
+ * Updated for new consent modes: cookieless, gdpr-strict, gdpr-opt-out
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -37,6 +38,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useConsent = useConsent;
+exports.useConsentMode = useConsentMode;
+exports.useTrackingId = useTrackingId;
+exports.useCanTrack = useCanTrack;
 const React = __importStar(require("react"));
 const useGrainAnalytics_1 = require("./useGrainAnalytics");
 function useConsent() {
@@ -81,4 +85,51 @@ function useConsent() {
         categories: consentState?.categories ?? [],
     };
 }
+/**
+ * useConsentMode - Hook to get current consent mode
+ * v2.0: Returns 'cookieless' | 'gdpr-strict' | 'gdpr-opt-out'
+ */
+function useConsentMode() {
+    const client = (0, useGrainAnalytics_1.useGrainAnalytics)();
+    const [mode, setMode] = React.useState(null);
+    React.useEffect(() => {
+        if (!client)
+            return;
+        // Access internal consent manager via client methods
+        // This is a simplified version - mode doesn't change at runtime
+        const config = client.config;
+        setMode(config?.consentMode ?? 'cookieless');
+    }, [client]);
+    return mode;
+}
+/**
+ * useTrackingId - Hook to get current tracking ID
+ * v2.0: Returns daily rotating ID or permanent ID based on consent
+ */
+function useTrackingId() {
+    const client = (0, useGrainAnalytics_1.useGrainAnalytics)();
+    const [trackingId, setTrackingId] = React.useState(null);
+    const { consentState } = useConsent();
+    React.useEffect(() => {
+        if (!client)
+            return;
+        try {
+            const id = client.getEffectiveUserId();
+            setTrackingId(id);
+        }
+        catch (error) {
+            console.warn('Failed to get tracking ID:', error);
+        }
+    }, [client, consentState]); // Re-fetch when consent changes
+    return trackingId;
+}
+/**
+ * useCanTrack - Hook to check if tracking is allowed
+ * v2.0: Always returns true (even cookieless mode allows basic tracking)
+ */
+function useCanTrack() {
+    const mode = useConsentMode();
+    // All modes allow some form of tracking in v2.0
+    return mode !== null;
+}
 //# sourceMappingURL=useConsent.js.map

package/dist/cjs/react/hooks/useConsent.js.map

@@ -1 +1 @@
-{"version":3,"file":"useConsent.js","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMH,gCAyDC;AA7DD,6CAA+B;AAC/B,2DAAwD;AAGxD,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAG,IAAA,qCAAiB,GAAE,CAAC;IACnC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAsB,IAAI,CAAC,CAAC;IAElF,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,4BAA4B;QAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAC9C,eAAe,CAAC,YAAY,CAAC,CAAC;QAE9B,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,CAAC,KAAmB,EAAE,EAAE;YACvC,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEjC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CACpC,CAAC,UAAqB,EAAE,EAAE;QACxB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CACrC,CAAC,UAAqB,EAAE,EAAE;QACxB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAClC,CAAC,QAAiB,EAAE,EAAE;QACpB,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,UAAU;QACV,SAAS,EAAE,YAAY,EAAE,OAAO,IAAI,KAAK;QACzC,UAAU,EAAE,YAAY,EAAE,UAAU,IAAI,EAAE;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useConsent.js","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":"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"}

package/dist/consent.d.ts

@@ -1,8 +1,13 @@
 /**
- * Consent management for Grain Analytics
- * Handles GDPR-compliant consent tracking and state management
+ * Consent management for Grain Analytics v2.0
+ * Privacy-first, cookie-less by default
+ *
+ * Consent Modes:
+ * - cookieless: Default mode, daily rotating IDs, no consent needed
+ * - gdpr-strict: Requires explicit consent, falls back to cookieless
+ * - gdpr-opt-out: Permanent IDs by default, cookieless on opt-out
  */
-export type ConsentMode = 'opt-in' | 'opt-out' | 'disabled';
+export type ConsentMode = 'cookieless' | 'gdpr-strict' | 'gdpr-opt-out';
 export interface ConsentState {
     granted: boolean;
     categories: string[];
@@ -13,6 +18,7 @@ export declare const DEFAULT_CONSENT_CATEGORIES: string[];
 export declare const CONSENT_VERSION = "1.0.0";
 /**
  * Consent manager for handling user consent state
+ * v2.0: Cookie-less by default, privacy-first approach
  */
 export declare class ConsentManager {
     private consentState;
@@ -23,9 +29,8 @@ export declare class ConsentManager {
     /**
      * Load consent state from localStorage
      *
-     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
-     * since storing consent choices is a legitimate interest and necessary for compliance.
-     * The consent preference itself is not tracking data.
+     * GDPR Compliance: localStorage only used for storing consent preferences
+     * (not for tracking), which is a legitimate interest for compliance.
      */
     private loadConsentState;
     /**
@@ -45,11 +50,28 @@ export declare class ConsentManager {
      */
     getConsentState(): ConsentState | null;
     /**
-     * Check if user has granted consent
+     * Check if user has granted consent for permanent IDs
      */
     hasConsent(category?: string): boolean;
+    /**
+     * Check if permanent IDs are allowed
+     */
+    shouldUsePermanentId(): boolean;
+    /**
+     * Check if we should strip query parameters from URLs
+     * Query params stripped unless:
+     * - Mode is gdpr-opt-out, OR
+     * - Mode is gdpr-strict AND consent given
+     */
+    shouldStripQueryParams(): boolean;
+    /**
+     * Check if we can track events (always true in v2.0)
+     * Even cookieless mode allows basic analytics with daily IDs
+     */
+    canTrack(): boolean;
     /**
      * Check if we should wait for consent before tracking
+     * Only relevant for GDPR Strict mode
      */
     shouldWaitForConsent(): boolean;
     /**
@@ -68,5 +90,14 @@ export declare class ConsentManager {
      * Clear all consent data
      */
     clearConsent(): void;
+    /**
+     * Get current consent mode
+     */
+    getConsentMode(): ConsentMode;
+    /**
+     * Get ID mode based on consent state
+     * Returns 'cookieless' or 'permanent'
+     */
+    getIdMode(): 'cookieless' | 'permanent';
 }
 //# sourceMappingURL=consent.d.ts.map

package/dist/consent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAAuB;IAMlE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAwBtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;CAUrB"}
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAA0B;IAMrE;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAiCtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;;;;OAKG;IACH,sBAAsB,IAAI,OAAO;IAgBjC;;;OAGG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;IAWpB;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;;OAGG;IACH,SAAS,IAAI,YAAY,GAAG,WAAW;CAGxC"}

package/dist/consent.js

@@ -1,7 +1,12 @@
 "use strict";
 /**
- * Consent management for Grain Analytics
- * Handles GDPR-compliant consent tracking and state management
+ * Consent management for Grain Analytics v2.0
+ * Privacy-first, cookie-less by default
+ *
+ * Consent Modes:
+ * - cookieless: Default mode, daily rotating IDs, no consent needed
+ * - gdpr-strict: Requires explicit consent, falls back to cookieless
+ * - gdpr-opt-out: Permanent IDs by default, cookieless on opt-out
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConsentManager = exports.CONSENT_VERSION = exports.DEFAULT_CONSENT_CATEGORIES = void 0;
@@ -9,9 +14,10 @@ exports.DEFAULT_CONSENT_CATEGORIES = ['necessary', 'analytics', 'functional'];
 exports.CONSENT_VERSION = '1.0.0';
 /**
  * Consent manager for handling user consent state
+ * v2.0: Cookie-less by default, privacy-first approach
  */
 class ConsentManager {
-    constructor(tenantId, consentMode = 'opt-out') {
+    constructor(tenantId, consentMode = 'cookieless') {
         this.consentState = null;
         this.listeners = [];
         this.consentMode = consentMode;
@@ -21,9 +27,8 @@ class ConsentManager {
     /**
      * Load consent state from localStorage
      *
-     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
-     * since storing consent choices is a legitimate interest and necessary for compliance.
-     * The consent preference itself is not tracking data.
+     * GDPR Compliance: localStorage only used for storing consent preferences
+     * (not for tracking), which is a legitimate interest for compliance.
      */
     loadConsentState() {
         if (typeof window === 'undefined')
@@ -37,8 +42,8 @@ class ConsentManager {
                     timestamp: new Date(parsed.timestamp),
                 };
             }
-            else if (this.consentMode === 'opt-out' || this.consentMode === 'disabled') {
-                // Auto-grant consent for opt-out and disabled modes
+            else if (this.consentMode === 'gdpr-opt-out') {
+                // Auto-grant consent for opt-out mode (user hasn't opted out yet)
                 this.consentState = {
                     granted: true,
                     categories: exports.DEFAULT_CONSENT_CATEGORIES,
@@ -47,10 +52,10 @@ class ConsentManager {
                 };
                 this.saveConsentState();
             }
-            // Note: In opt-in mode without stored consent, consentState remains null (no consent)
+            // Note: cookieless and gdpr-strict modes without stored consent → no permanent tracking
         }
         catch (error) {
-            // Silent failure - consent will be requested when needed
+            // Silent failure - will use cookieless mode by default
         }
     }
     /**
@@ -120,32 +125,73 @@ class ConsentManager {
         return this.consentState ? { ...this.consentState } : null;
     }
     /**
-     * Check if user has granted consent
+     * Check if user has granted consent for permanent IDs
      */
     hasConsent(category) {
-        // Disabled mode always returns true (no consent required)
-        if (this.consentMode === 'disabled') {
-            return true;
+        // Cookie-less mode: no consent needed (no permanent tracking)
+        if (this.consentMode === 'cookieless') {
+            return false; // No permanent IDs
         }
-        // No consent state in opt-in mode means no consent
-        if (this.consentMode === 'opt-in' && !this.consentState) {
-            return false;
+        // GDPR Strict: requires explicit consent
+        if (this.consentMode === 'gdpr-strict') {
+            if (!this.consentState?.granted) {
+                return false;
+            }
         }
-        // Check consent state
-        if (!this.consentState?.granted) {
-            return false;
+        // GDPR Opt-out: consent by default unless explicitly revoked
+        if (this.consentMode === 'gdpr-opt-out') {
+            // If no state, assume consent (opt-out model)
+            if (!this.consentState) {
+                return true;
+            }
+            // Check if consent was revoked
+            if (!this.consentState.granted) {
+                return false;
+            }
         }
         // Check specific category if provided
-        if (category) {
+        if (category && this.consentState) {
             return this.consentState.categories.includes(category);
         }
-        return true;
+        return this.consentState?.granted ?? (this.consentMode === 'gdpr-opt-out');
+    }
+    /**
+     * Check if permanent IDs are allowed
+     */
+    shouldUsePermanentId() {
+        return this.hasConsent();
+    }
+    /**
+     * Check if we should strip query parameters from URLs
+     * Query params stripped unless:
+     * - Mode is gdpr-opt-out, OR
+     * - Mode is gdpr-strict AND consent given
+     */
+    shouldStripQueryParams() {
+        if (this.consentMode === 'cookieless') {
+            return true; // Always strip in cookieless mode
+        }
+        if (this.consentMode === 'gdpr-strict') {
+            return !this.hasConsent(); // Strip unless consented
+        }
+        if (this.consentMode === 'gdpr-opt-out') {
+            return false; // Don't strip in opt-out mode
+        }
+        return true; // Default: strip
+    }
+    /**
+     * Check if we can track events (always true in v2.0)
+     * Even cookieless mode allows basic analytics with daily IDs
+     */
+    canTrack() {
+        return true; // All modes allow some form of tracking
     }
     /**
      * Check if we should wait for consent before tracking
+     * Only relevant for GDPR Strict mode
      */
     shouldWaitForConsent() {
-        return this.consentMode === 'opt-in' && !this.consentState?.granted;
+        return this.consentMode === 'gdpr-strict' && !this.consentState?.granted;
     }
     /**
      * Add consent change listener
@@ -191,6 +237,19 @@ class ConsentManager {
             // Silent failure - consent state may not be fully cleared
         }
     }
+    /**
+     * Get current consent mode
+     */
+    getConsentMode() {
+        return this.consentMode;
+    }
+    /**
+     * Get ID mode based on consent state
+     * Returns 'cookieless' or 'permanent'
+     */
+    getIdMode() {
+        return this.shouldUsePermanentId() ? 'permanent' : 'cookieless';
+    }
 }
 exports.ConsentManager = ConsentManager;
 //# sourceMappingURL=consent.js.map

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":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,iBAAiB,CAAqB;IAG9C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAK;IAG1B,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,eAAe,CAA0C;gBAG/D,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,gBAAqB;IAe/B;;OAEG;YACW,UAAU;IAYxB;;OAEG;YACW,oBAAoB;IAelC;;OAEG;IACH,OAAO,CAAC,WAAW;IAkTnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;IACH,OAAO,CAAC,SAAS;IAoBjB;;OAEG;IACH,OAAO,CAAC,MAAM;IAsBd;;OAEG;IACH,OAAO,CAAC,OAAO;IAoBf;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwCxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,eAAe,CAIrB;IAEF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8PzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;YACW,mBAAmB;IAoEjC;;OAEG;YACW,aAAa;IA4B3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2C1B;;OAEG;YACW,QAAQ;IAyBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,IAAI,IAAI;CAyBhB"}