@clianta/sdk 1.3.0 → 1.5.0

package/dist/clianta.umd.js

@@ -1,5 +1,5 @@
 /*!
- * Clianta SDK v1.3.0
+ * Clianta SDK v1.5.0
  * (c) 2026 Clianta
  * Released under the MIT License.
  */
@@ -14,7 +14,7 @@
      * @see SDK_VERSION in core/config.ts
      */
     /** SDK Version */
-    const SDK_VERSION = '1.3.0';
+    const SDK_VERSION = '1.4.0';
     /** Default API endpoint based on environment */
     const getDefaultApiEndpoint = () => {
         if (typeof window === 'undefined')
@@ -40,6 +40,7 @@
         projectId: '',
         apiEndpoint: getDefaultApiEndpoint(),
         authToken: '',
+        apiKey: '',
         debug: false,
         autoPageView: true,
         plugins: DEFAULT_PLUGINS,
@@ -55,6 +56,7 @@
         cookieDomain: '',
         useCookies: false,
         cookielessMode: false,
+        persistMode: 'session',
     };
     /** Storage keys */
     const STORAGE_KEYS = {
@@ -187,12 +189,39 @@
             return this.send(url, payload);
         }
         /**
-         * Send identify request
+         * Send identify request.
+         * Returns contactId from the server response so the Tracker can store it.
          */
         async sendIdentify(data) {
             const url = `${this.config.apiEndpoint}/api/public/track/identify`;
-            const payload = JSON.stringify(data);
-            return this.send(url, payload);
+            try {
+                const response = await this.fetchWithTimeout(url, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(data),
+                    keepalive: true,
+                });
+                const body = await response.json().catch(() => ({}));
+                if (response.ok) {
+                    logger.debug('Identify successful, contactId:', body.contactId);
+                    return {
+                        success: true,
+                        status: response.status,
+                        contactId: body.contactId ?? undefined,
+                    };
+                }
+                if (response.status >= 500) {
+                    logger.warn(`Identify server error (${response.status})`);
+                }
+                else {
+                    logger.error(`Identify failed with status ${response.status}:`, body.message);
+                }
+                return { success: false, status: response.status };
+            }
+            catch (error) {
+                logger.error('Identify request failed:', error);
+                return { success: false, error: error };
+            }
         }
         /**
          * Send events synchronously (for page unload)
@@ -221,6 +250,39 @@
                 return false;
             }
         }
+        /**
+         * Fetch data from the tracking API (GET request)
+         * Used for read-back APIs (visitor profile, activity, etc.)
+         */
+        async fetchData(path, params) {
+            const url = new URL(`${this.config.apiEndpoint}${path}`);
+            if (params) {
+                Object.entries(params).forEach(([key, value]) => {
+                    if (value !== undefined && value !== null) {
+                        url.searchParams.set(key, value);
+                    }
+                });
+            }
+            try {
+                const response = await this.fetchWithTimeout(url.toString(), {
+                    method: 'GET',
+                    headers: {
+                        'Accept': 'application/json',
+                    },
+                });
+                if (response.ok) {
+                    const body = await response.json();
+                    logger.debug('Fetch successful:', path);
+                    return { success: true, data: body.data ?? body, status: response.status };
+                }
+                logger.error(`Fetch failed with status ${response.status}`);
+                return { success: false, status: response.status };
+            }
+            catch (error) {
+                logger.error('Fetch request failed:', error);
+                return { success: false, error: error };
+            }
+        }
         /**
          * Internal send with retry logic
          */
@@ -385,7 +447,9 @@
             date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);
             expires = '; expires=' + date.toUTCString();
         }
-        document.cookie = name + '=' + value + expires + '; path=/; SameSite=Lax';
+        // Add Secure flag on HTTPS to prevent cookie leakage over plaintext
+        const secure = typeof location !== 'undefined' && location.protocol === 'https:' ? '; Secure' : '';
+        document.cookie = name + '=' + value + expires + '; path=/; SameSite=Lax' + secure;
         return value;
     }
     // ============================================
@@ -549,6 +613,17 @@
         return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);
     }
     // ============================================
+    // VALIDATION UTILITIES
+    // ============================================
+    /**
+     * Validate email format
+     */
+    function isValidEmail(email) {
+        if (typeof email !== 'string' || !email)
+            return false;
+        return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+    }
+    // ============================================
     // DEVICE INFO
     // ============================================
     /**
@@ -602,6 +677,7 @@
                 maxQueueSize: config.maxQueueSize ?? MAX_QUEUE_SIZE,
                 storageKey: config.storageKey ?? STORAGE_KEYS.EVENT_QUEUE,
             };
+            this.persistMode = config.persistMode || 'session';
             // Restore persisted queue
             this.restoreQueue();
             // Start auto-flush timer
@@ -707,6 +783,13 @@
         clear() {
             this.queue = [];
             this.persistQueue([]);
+            // Also clear localStorage if used
+            if (this.persistMode === 'local' && typeof localStorage !== 'undefined') {
+                try {
+                    localStorage.removeItem(this.config.storageKey);
+                }
+                catch { /* ignore */ }
+            }
         }
         /**
          * Stop the flush timer and cleanup handlers
@@ -761,22 +844,44 @@
             window.addEventListener('pagehide', this.boundPageHide);
         }
         /**
-         * Persist queue to localStorage
+         * Persist queue to storage based on persistMode
          */
         persistQueue(events) {
+            if (this.persistMode === 'none')
+                return;
             try {
-                setLocalStorage(this.config.storageKey, JSON.stringify(events));
+                const serialized = JSON.stringify(events);
+                if (this.persistMode === 'local' && typeof localStorage !== 'undefined') {
+                    try {
+                        localStorage.setItem(this.config.storageKey, serialized);
+                    }
+                    catch {
+                        // localStorage quota exceeded — fallback to sessionStorage
+                        setSessionStorage(this.config.storageKey, serialized);
+                    }
+                }
+                else {
+                    setSessionStorage(this.config.storageKey, serialized);
+                }
             }
             catch {
                 // Ignore storage errors
             }
         }
         /**
-         * Restore queue from localStorage
+         * Restore queue from storage
          */
         restoreQueue() {
             try {
-                const stored = getLocalStorage(this.config.storageKey);
+                let stored = null;
+                // Check localStorage first (cross-session persistence)
+                if (this.persistMode === 'local' && typeof localStorage !== 'undefined') {
+                    stored = localStorage.getItem(this.config.storageKey);
+                }
+                // Fall back to sessionStorage
+                if (!stored) {
+                    stored = getSessionStorage(this.config.storageKey);
+                }
                 if (stored) {
                     const events = JSON.parse(stored);
                     if (Array.isArray(events) && events.length > 0) {
@@ -844,10 +949,13 @@
                 history.pushState = function (...args) {
                     self.originalPushState.apply(history, args);
                     self.trackPageView();
+                    // Notify other plugins (e.g. ScrollPlugin) about navigation
+                    window.dispatchEvent(new Event('clianta:navigation'));
                 };
                 history.replaceState = function (...args) {
                     self.originalReplaceState.apply(history, args);
                     self.trackPageView();
+                    window.dispatchEvent(new Event('clianta:navigation'));
                 };
                 // Handle back/forward navigation
                 this.popstateHandler = () => this.trackPageView();
@@ -901,9 +1009,8 @@
             this.pageLoadTime = 0;
             this.scrollTimeout = null;
             this.boundHandler = null;
-            /** SPA navigation support */
-            this.originalPushState = null;
-            this.originalReplaceState = null;
+            /** SPA navigation — listen for PageViewPlugin's custom event instead of patching history */
+            this.navigationHandler = null;
             this.popstateHandler = null;
         }
         init(tracker) {
@@ -912,8 +1019,13 @@
             if (typeof window !== 'undefined') {
                 this.boundHandler = this.handleScroll.bind(this);
                 window.addEventListener('scroll', this.boundHandler, { passive: true });
-                // Setup SPA navigation reset
-                this.setupNavigationReset();
+                // Listen for navigation events dispatched by PageViewPlugin
+                // instead of independently monkey-patching history.pushState
+                this.navigationHandler = () => this.resetForNavigation();
+                window.addEventListener('clianta:navigation', this.navigationHandler);
+                // Handle back/forward navigation
+                this.popstateHandler = () => this.resetForNavigation();
+                window.addEventListener('popstate', this.popstateHandler);
             }
         }
         destroy() {
@@ -923,16 +1035,10 @@
             if (this.scrollTimeout) {
                 clearTimeout(this.scrollTimeout);
             }
-            // Restore original history methods
-            if (this.originalPushState) {
-                history.pushState = this.originalPushState;
-                this.originalPushState = null;
-            }
-            if (this.originalReplaceState) {
-                history.replaceState = this.originalReplaceState;
-                this.originalReplaceState = null;
+            if (this.navigationHandler && typeof window !== 'undefined') {
+                window.removeEventListener('clianta:navigation', this.navigationHandler);
+                this.navigationHandler = null;
             }
-            // Remove popstate listener
             if (this.popstateHandler && typeof window !== 'undefined') {
                 window.removeEventListener('popstate', this.popstateHandler);
                 this.popstateHandler = null;
@@ -947,29 +1053,6 @@
             this.maxScrollDepth = 0;
             this.pageLoadTime = Date.now();
         }
-        /**
-         * Setup History API interception for SPA navigation
-         */
-        setupNavigationReset() {
-            if (typeof window === 'undefined')
-                return;
-            // Store originals for cleanup
-            this.originalPushState = history.pushState;
-            this.originalReplaceState = history.replaceState;
-            // Intercept pushState and replaceState
-            const self = this;
-            history.pushState = function (...args) {
-                self.originalPushState.apply(history, args);
-                self.resetForNavigation();
-            };
-            history.replaceState = function (...args) {
-                self.originalReplaceState.apply(history, args);
-                self.resetForNavigation();
-            };
-            // Handle back/forward navigation
-            this.popstateHandler = () => this.resetForNavigation();
-            window.addEventListener('popstate', this.popstateHandler);
-        }
         handleScroll() {
             // Debounce scroll tracking
             if (this.scrollTimeout) {
@@ -1169,6 +1252,10 @@
                 elementId: elementInfo.id,
                 elementClass: elementInfo.className,
                 href: target.href || undefined,
+                x: Math.round((e.clientX / window.innerWidth) * 100),
+                y: Math.round((e.clientY / window.innerHeight) * 100),
+                viewportWidth: window.innerWidth,
+                viewportHeight: window.innerHeight,
             });
         }
     }
@@ -1191,6 +1278,9 @@
             this.boundMarkEngaged = null;
             this.boundTrackTimeOnPage = null;
             this.boundVisibilityHandler = null;
+            /** SPA navigation — listen for PageViewPlugin's custom event instead of patching history */
+            this.navigationHandler = null;
+            this.popstateHandler = null;
         }
         init(tracker) {
             super.init(tracker);
@@ -1216,6 +1306,13 @@
             // Track time on page before unload
             window.addEventListener('beforeunload', this.boundTrackTimeOnPage);
             document.addEventListener('visibilitychange', this.boundVisibilityHandler);
+            // Listen for navigation events dispatched by PageViewPlugin
+            // instead of independently monkey-patching history.pushState
+            this.navigationHandler = () => this.resetForNavigation();
+            window.addEventListener('clianta:navigation', this.navigationHandler);
+            // Handle back/forward navigation
+            this.popstateHandler = () => this.resetForNavigation();
+            window.addEventListener('popstate', this.popstateHandler);
         }
         destroy() {
             if (this.boundMarkEngaged && typeof document !== 'undefined') {
@@ -1229,11 +1326,28 @@
             if (this.boundVisibilityHandler && typeof document !== 'undefined') {
                 document.removeEventListener('visibilitychange', this.boundVisibilityHandler);
             }
+            if (this.navigationHandler && typeof window !== 'undefined') {
+                window.removeEventListener('clianta:navigation', this.navigationHandler);
+                this.navigationHandler = null;
+            }
+            if (this.popstateHandler && typeof window !== 'undefined') {
+                window.removeEventListener('popstate', this.popstateHandler);
+                this.popstateHandler = null;
+            }
             if (this.engagementTimeout) {
                 clearTimeout(this.engagementTimeout);
             }
             super.destroy();
         }
+        resetForNavigation() {
+            this.pageLoadTime = Date.now();
+            this.engagementStartTime = Date.now();
+            this.isEngaged = false;
+            if (this.engagementTimeout) {
+                clearTimeout(this.engagementTimeout);
+                this.engagementTimeout = null;
+            }
+        }
         markEngaged() {
             if (!this.isEngaged) {
                 this.isEngaged = true;
@@ -1273,9 +1387,8 @@
             this.name = 'downloads';
             this.trackedDownloads = new Set();
             this.boundHandler = null;
-            /** SPA navigation support */
-            this.originalPushState = null;
-            this.originalReplaceState = null;
+            /** SPA navigation — listen for PageViewPlugin's custom event instead of patching history */
+            this.navigationHandler = null;
             this.popstateHandler = null;
         }
         init(tracker) {
@@ -1283,24 +1396,25 @@
             if (typeof document !== 'undefined') {
                 this.boundHandler = this.handleClick.bind(this);
                 document.addEventListener('click', this.boundHandler, true);
-                // Setup SPA navigation reset
-                this.setupNavigationReset();
+            }
+            if (typeof window !== 'undefined') {
+                // Listen for navigation events dispatched by PageViewPlugin
+                // instead of independently monkey-patching history.pushState
+                this.navigationHandler = () => this.resetForNavigation();
+                window.addEventListener('clianta:navigation', this.navigationHandler);
+                // Handle back/forward navigation
+                this.popstateHandler = () => this.resetForNavigation();
+                window.addEventListener('popstate', this.popstateHandler);
             }
         }
         destroy() {
             if (this.boundHandler && typeof document !== 'undefined') {
                 document.removeEventListener('click', this.boundHandler, true);
             }
-            // Restore original history methods
-            if (this.originalPushState) {
-                history.pushState = this.originalPushState;
-                this.originalPushState = null;
-            }
-            if (this.originalReplaceState) {
-                history.replaceState = this.originalReplaceState;
-                this.originalReplaceState = null;
+            if (this.navigationHandler && typeof window !== 'undefined') {
+                window.removeEventListener('clianta:navigation', this.navigationHandler);
+                this.navigationHandler = null;
             }
-            // Remove popstate listener
             if (this.popstateHandler && typeof window !== 'undefined') {
                 window.removeEventListener('popstate', this.popstateHandler);
                 this.popstateHandler = null;
@@ -1313,29 +1427,6 @@
         resetForNavigation() {
             this.trackedDownloads.clear();
         }
-        /**
-         * Setup History API interception for SPA navigation
-         */
-        setupNavigationReset() {
-            if (typeof window === 'undefined')
-                return;
-            // Store originals for cleanup
-            this.originalPushState = history.pushState;
-            this.originalReplaceState = history.replaceState;
-            // Intercept pushState and replaceState
-            const self = this;
-            history.pushState = function (...args) {
-                self.originalPushState.apply(history, args);
-                self.resetForNavigation();
-            };
-            history.replaceState = function (...args) {
-                self.originalReplaceState.apply(history, args);
-                self.resetForNavigation();
-            };
-            // Handle back/forward navigation
-            this.popstateHandler = () => this.resetForNavigation();
-            window.addEventListener('popstate', this.popstateHandler);
-        }
         handleClick(e) {
             const link = e.target.closest('a');
             if (!link || !link.href)
@@ -1371,6 +1462,9 @@
             this.exitIntentShown = false;
             this.pageLoadTime = 0;
             this.boundHandler = null;
+            /** SPA navigation — listen for PageViewPlugin's custom event instead of patching history */
+            this.navigationHandler = null;
+            this.popstateHandler = null;
         }
         init(tracker) {
             super.init(tracker);
@@ -1382,13 +1476,34 @@
                 this.boundHandler = this.handleMouseLeave.bind(this);
                 document.addEventListener('mouseleave', this.boundHandler);
             }
+            if (typeof window !== 'undefined') {
+                // Listen for navigation events dispatched by PageViewPlugin
+                // instead of independently monkey-patching history.pushState
+                this.navigationHandler = () => this.resetForNavigation();
+                window.addEventListener('clianta:navigation', this.navigationHandler);
+                // Handle back/forward navigation
+                this.popstateHandler = () => this.resetForNavigation();
+                window.addEventListener('popstate', this.popstateHandler);
+            }
         }
         destroy() {
             if (this.boundHandler && typeof document !== 'undefined') {
                 document.removeEventListener('mouseleave', this.boundHandler);
             }
+            if (this.navigationHandler && typeof window !== 'undefined') {
+                window.removeEventListener('clianta:navigation', this.navigationHandler);
+                this.navigationHandler = null;
+            }
+            if (this.popstateHandler && typeof window !== 'undefined') {
+                window.removeEventListener('popstate', this.popstateHandler);
+                this.popstateHandler = null;
+            }
             super.destroy();
         }
+        resetForNavigation() {
+            this.exitIntentShown = false;
+            this.pageLoadTime = Date.now();
+        }
         handleMouseLeave(e) {
             // Only trigger when mouse leaves from the top of the page
             if (e.clientY > 0 || this.exitIntentShown)
@@ -1616,6 +1731,8 @@
             this.shownForms = new Set();
             this.scrollHandler = null;
             this.exitHandler = null;
+            this.delayTimers = [];
+            this.clickTriggerListeners = [];
         }
         async init(tracker) {
             super.init(tracker);
@@ -1630,6 +1747,14 @@
         }
         destroy() {
             this.removeTriggers();
+            for (const timer of this.delayTimers) {
+                clearTimeout(timer);
+            }
+            this.delayTimers = [];
+            for (const { element, handler } of this.clickTriggerListeners) {
+                element.removeEventListener('click', handler);
+            }
+            this.clickTriggerListeners = [];
             super.destroy();
         }
         loadShownForms() {
@@ -1692,7 +1817,7 @@
             this.forms.forEach(form => {
                 switch (form.trigger.type) {
                     case 'delay':
-                        setTimeout(() => this.showForm(form), (form.trigger.value || 5) * 1000);
+                        this.delayTimers.push(setTimeout(() => this.showForm(form), (form.trigger.value || 5) * 1000));
                         break;
                     case 'scroll':
                         this.setupScrollTrigger(form);
@@ -1735,7 +1860,9 @@
                 return;
             const elements = document.querySelectorAll(form.trigger.selector);
             elements.forEach(el => {
-                el.addEventListener('click', () => this.showForm(form));
+                const handler = () => this.showForm(form);
+                el.addEventListener('click', handler);
+                this.clickTriggerListeners.push({ element: el, handler });
             });
         }
         removeTriggers() {
@@ -2022,7 +2149,7 @@
             const submitBtn = formElement.querySelector('button[type="submit"]');
             if (submitBtn) {
                 submitBtn.disabled = true;
-                submitBtn.innerHTML = 'Submitting...';
+                submitBtn.textContent = 'Submitting...';
             }
             try {
                 const response = await fetch(`${apiEndpoint}/api/public/lead-forms/${form._id}/submit`, {
@@ -2063,11 +2190,24 @@
                     if (data.email) {
                         this.tracker?.identify(data.email, data);
                     }
-                    // Redirect if configured
+                    // Redirect if configured (validate URL to prevent open redirect)
                     if (form.redirectUrl) {
-                        setTimeout(() => {
-                            window.location.href = form.redirectUrl;
-                        }, 1500);
+                        try {
+                            const redirect = new URL(form.redirectUrl, window.location.origin);
+                            const isSameOrigin = redirect.origin === window.location.origin;
+                            const isSafeProtocol = redirect.protocol === 'https:' || redirect.protocol === 'http:';
+                            if (isSameOrigin || isSafeProtocol) {
+                                setTimeout(() => {
+                                    window.location.href = redirect.href;
+                                }, 1500);
+                            }
+                            else {
+                                console.warn('[Clianta] Blocked unsafe redirect URL:', form.redirectUrl);
+                            }
+                        }
+                        catch {
+                            console.warn('[Clianta] Invalid redirect URL:', form.redirectUrl);
+                        }
                     }
                     // Close after delay
                     setTimeout(() => {
@@ -2082,7 +2222,7 @@
                 console.error('[Clianta] Form submit error:', error);
                 if (submitBtn) {
                     submitBtn.disabled = false;
-                    submitBtn.innerHTML = form.submitButtonText || 'Subscribe';
+                    submitBtn.textContent = form.submitButtonText || 'Subscribe';
                 }
             }
         }
@@ -2367,355 +2507,478 @@
     }
 
     /**
-     * Clianta SDK - Main Tracker Class
-     * @see SDK_VERSION in core/config.ts
+     * Clianta SDK - Event Triggers Manager
+     * Manages event-driven automation and email notifications
      */
     /**
-     * Main Clianta Tracker Class
+     * Event Triggers Manager
+     * Handles event-driven automation based on CRM actions
+     *
+     * Similar to:
+     * - Salesforce: Process Builder, Flow Automation
+     * - HubSpot: Workflows, Email Sequences
+     * - Pipedrive: Workflow Automation
      */
-    class Tracker {
-        constructor(workspaceId, userConfig = {}) {
-            this.plugins = [];
-            this.isInitialized = false;
-            /** Pending identify retry on next flush */
-            this.pendingIdentify = null;
-            if (!workspaceId) {
-                throw new Error('[Clianta] Workspace ID is required');
-            }
+    class EventTriggersManager {
+        constructor(apiEndpoint, workspaceId, authToken) {
+            this.triggers = new Map();
+            this.listeners = new Map();
+            this.apiEndpoint = apiEndpoint;
             this.workspaceId = workspaceId;
-            this.config = mergeConfig(userConfig);
-            // Setup debug mode
-            logger.enabled = this.config.debug;
-            logger.info(`Initializing SDK v${SDK_VERSION}`, { workspaceId });
-            // Initialize consent manager
-            this.consentManager = new ConsentManager({
-                ...this.config.consent,
-                onConsentChange: (state, previous) => {
-                    this.onConsentChange(state, previous);
-                },
-            });
-            // Initialize transport and queue
-            this.transport = new Transport({ apiEndpoint: this.config.apiEndpoint });
-            this.queue = new EventQueue(this.transport, {
-                batchSize: this.config.batchSize,
-                flushInterval: this.config.flushInterval,
-            });
-            // Get or create visitor and session IDs based on mode
-            this.visitorId = this.createVisitorId();
-            this.sessionId = this.createSessionId();
-            logger.debug('IDs created', { visitorId: this.visitorId, sessionId: this.sessionId });
-            // Initialize plugins
-            this.initPlugins();
-            this.isInitialized = true;
-            logger.info('SDK initialized successfully');
+            this.authToken = authToken;
         }
         /**
-         * Create visitor ID based on storage mode
+         * Set authentication token
          */
-        createVisitorId() {
-            // Anonymous mode: use temporary ID until consent
-            if (this.config.consent.anonymousMode && !this.consentManager.hasExplicit()) {
-                const key = STORAGE_KEYS.VISITOR_ID + '_anon';
-                let anonId = getSessionStorage(key);
-                if (!anonId) {
-                    anonId = 'anon_' + generateUUID();
-                    setSessionStorage(key, anonId);
-                }
-                return anonId;
+        setAuthToken(token) {
+            this.authToken = token;
+        }
+        /**
+         * Make authenticated API request
+         */
+        async request(endpoint, options = {}) {
+            const url = `${this.apiEndpoint}${endpoint}`;
+            const headers = {
+                'Content-Type': 'application/json',
+                ...(options.headers || {}),
+            };
+            if (this.authToken) {
+                headers['Authorization'] = `Bearer ${this.authToken}`;
             }
-            // Cookie-less mode: use sessionStorage only
-            if (this.config.cookielessMode) {
-                let visitorId = getSessionStorage(STORAGE_KEYS.VISITOR_ID);
-                if (!visitorId) {
-                    visitorId = generateUUID();
-                    setSessionStorage(STORAGE_KEYS.VISITOR_ID, visitorId);
+            try {
+                const response = await fetch(url, {
+                    ...options,
+                    headers,
+                });
+                const data = await response.json();
+                if (!response.ok) {
+                    return {
+                        success: false,
+                        error: data.message || 'Request failed',
+                        status: response.status,
+                    };
                 }
-                return visitorId;
+                return {
+                    success: true,
+                    data: data.data || data,
+                    status: response.status,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Network error',
+                    status: 0,
+                };
             }
-            // Normal mode
-            return getOrCreateVisitorId(this.config.useCookies);
         }
+        // ============================================
+        // TRIGGER MANAGEMENT
+        // ============================================
         /**
-         * Create session ID
+         * Get all event triggers
          */
-        createSessionId() {
-            return getOrCreateSessionId(this.config.sessionTimeout);
-        }
-        /**
-         * Handle consent state changes
-         */
-        onConsentChange(state, previous) {
-            logger.debug('Consent changed:', { from: previous, to: state });
-            // If analytics consent was just granted
-            if (state.analytics && !previous.analytics) {
-                // Upgrade from anonymous ID to persistent ID
-                if (this.config.consent.anonymousMode) {
-                    this.visitorId = getOrCreateVisitorId(this.config.useCookies);
-                    logger.info('Upgraded from anonymous to persistent visitor ID');
-                }
-                // Flush buffered events
-                const buffered = this.consentManager.flushBuffer();
-                for (const event of buffered) {
-                    // Update event with new visitor ID
-                    event.visitorId = this.visitorId;
-                    this.queue.push(event);
-                }
-            }
+        async getTriggers() {
+            return this.request(`/api/workspaces/${this.workspaceId}/triggers`);
         }
         /**
-         * Initialize enabled plugins
-         * Handles both sync and async plugin init methods
+         * Get a single trigger by ID
          */
-        initPlugins() {
-            const pluginsToLoad = this.config.plugins;
-            // Skip pageView plugin if autoPageView is disabled
-            const filteredPlugins = this.config.autoPageView
-                ? pluginsToLoad
-                : pluginsToLoad.filter((p) => p !== 'pageView');
-            for (const pluginName of filteredPlugins) {
-                try {
-                    const plugin = getPlugin(pluginName);
-                    // Handle both sync and async init (fire-and-forget for async)
-                    const result = plugin.init(this);
-                    if (result instanceof Promise) {
-                        result.catch((error) => {
-                            logger.error(`Async plugin init failed: ${pluginName}`, error);
-                        });
-                    }
-                    this.plugins.push(plugin);
-                    logger.debug(`Plugin loaded: ${pluginName}`);
-                }
-                catch (error) {
-                    logger.error(`Failed to load plugin: ${pluginName}`, error);
-                }
-            }
+        async getTrigger(triggerId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/triggers/${triggerId}`);
         }
         /**
-         * Track a custom event
+         * Create a new event trigger
          */
-        track(eventType, eventName, properties = {}) {
-            if (!this.isInitialized) {
-                logger.warn('SDK not initialized, event dropped');
-                return;
-            }
-            const event = {
-                workspaceId: this.workspaceId,
-                visitorId: this.visitorId,
-                sessionId: this.sessionId,
-                eventType: eventType,
-                eventName,
-                url: typeof window !== 'undefined' ? window.location.href : '',
-                referrer: typeof document !== 'undefined' ? document.referrer || undefined : undefined,
-                properties,
-                device: getDeviceInfo(),
-                ...getUTMParams(),
-                timestamp: new Date().toISOString(),
-                sdkVersion: SDK_VERSION,
-            };
-            // Check consent before tracking
-            if (!this.consentManager.canTrack()) {
-                // Buffer event for later if waitForConsent is enabled
-                if (this.config.consent.waitForConsent) {
-                    this.consentManager.bufferEvent(event);
-                    return;
-                }
-                // Otherwise drop the event
-                logger.debug('Event dropped (no consent):', eventName);
-                return;
+        async createTrigger(trigger) {
+            const result = await this.request(`/api/workspaces/${this.workspaceId}/triggers`, {
+                method: 'POST',
+                body: JSON.stringify(trigger),
+            });
+            // Cache the trigger locally if successful
+            if (result.success && result.data?._id) {
+                this.triggers.set(result.data._id, result.data);
             }
-            this.queue.push(event);
-            logger.debug('Event tracked:', eventName, properties);
+            return result;
         }
         /**
-         * Track a page view
+         * Update an existing trigger
          */
-        page(name, properties = {}) {
-            const pageName = name || (typeof document !== 'undefined' ? document.title : 'Page View');
-            this.track('page_view', pageName, {
-                ...properties,
-                path: typeof window !== 'undefined' ? window.location.pathname : '',
+        async updateTrigger(triggerId, updates) {
+            const result = await this.request(`/api/workspaces/${this.workspaceId}/triggers/${triggerId}`, {
+                method: 'PUT',
+                body: JSON.stringify(updates),
             });
+            // Update cache if successful
+            if (result.success && result.data?._id) {
+                this.triggers.set(result.data._id, result.data);
+            }
+            return result;
         }
         /**
-         * Identify a visitor
+         * Delete a trigger
          */
-        async identify(email, traits = {}) {
-            if (!email) {
-                logger.warn('Email is required for identification');
-                return;
-            }
-            logger.info('Identifying visitor:', email);
-            const result = await this.transport.sendIdentify({
-                workspaceId: this.workspaceId,
-                visitorId: this.visitorId,
-                email,
-                properties: traits,
+        async deleteTrigger(triggerId) {
+            const result = await this.request(`/api/workspaces/${this.workspaceId}/triggers/${triggerId}`, {
+                method: 'DELETE',
             });
+            // Remove from cache if successful
             if (result.success) {
-                logger.info('Visitor identified successfully');
-                this.pendingIdentify = null;
-            }
-            else {
-                logger.error('Failed to identify visitor:', result.error);
-                // Store for retry on next flush
-                this.pendingIdentify = { email, traits };
+                this.triggers.delete(triggerId);
             }
+            return result;
         }
         /**
-         * Retry pending identify call
-         */
-        async retryPendingIdentify() {
-            if (!this.pendingIdentify)
-                return;
-            const { email, traits } = this.pendingIdentify;
-            this.pendingIdentify = null;
-            await this.identify(email, traits);
-        }
-        /**
-         * Update consent state
-         */
-        consent(state) {
-            this.consentManager.update(state);
-        }
-        /**
-         * Get current consent state
+         * Activate a trigger
          */
-        getConsentState() {
-            return this.consentManager.getState();
+        async activateTrigger(triggerId) {
+            return this.updateTrigger(triggerId, { isActive: true });
         }
         /**
-         * Toggle debug mode
+         * Deactivate a trigger
          */
-        debug(enabled) {
-            logger.enabled = enabled;
-            logger.info(`Debug mode ${enabled ? 'enabled' : 'disabled'}`);
+        async deactivateTrigger(triggerId) {
+            return this.updateTrigger(triggerId, { isActive: false });
         }
+        // ============================================
+        // EVENT HANDLING (CLIENT-SIDE)
+        // ============================================
         /**
-         * Get visitor ID
+         * Register a local event listener for client-side triggers
+         * This allows immediate client-side reactions to events
          */
-        getVisitorId() {
-            return this.visitorId;
+        on(eventType, callback) {
+            if (!this.listeners.has(eventType)) {
+                this.listeners.set(eventType, new Set());
+            }
+            this.listeners.get(eventType).add(callback);
+            logger.debug(`Event listener registered: ${eventType}`);
         }
         /**
-         * Get session ID
+         * Remove an event listener
          */
-        getSessionId() {
-            return this.sessionId;
+        off(eventType, callback) {
+            const listeners = this.listeners.get(eventType);
+            if (listeners) {
+                listeners.delete(callback);
+            }
         }
         /**
-         * Get workspace ID
+         * Emit an event (client-side only)
+         * This will trigger any registered local listeners
          */
-        getWorkspaceId() {
-            return this.workspaceId;
+        emit(eventType, data) {
+            logger.debug(`Event emitted: ${eventType}`, data);
+            const listeners = this.listeners.get(eventType);
+            if (listeners) {
+                listeners.forEach(callback => {
+                    try {
+                        callback(data);
+                    }
+                    catch (error) {
+                        logger.error(`Error in event listener for ${eventType}:`, error);
+                    }
+                });
+            }
         }
         /**
-         * Get current configuration
+         * Check if conditions are met for a trigger
+         * Supports dynamic field evaluation including custom fields and nested paths
          */
-        getConfig() {
-            return { ...this.config };
+        evaluateConditions(conditions, data) {
+            if (!conditions || conditions.length === 0) {
+                return true; // No conditions means always fire
+            }
+            return conditions.every(condition => {
+                // Support dot notation for nested fields (e.g., 'customFields.industry')
+                const fieldValue = condition.field.includes('.')
+                    ? this.getNestedValue(data, condition.field)
+                    : data[condition.field];
+                const targetValue = condition.value;
+                switch (condition.operator) {
+                    case 'equals':
+                        return fieldValue === targetValue;
+                    case 'not_equals':
+                        return fieldValue !== targetValue;
+                    case 'contains':
+                        return String(fieldValue).includes(String(targetValue));
+                    case 'greater_than':
+                        return Number(fieldValue) > Number(targetValue);
+                    case 'less_than':
+                        return Number(fieldValue) < Number(targetValue);
+                    case 'in':
+                        return Array.isArray(targetValue) && targetValue.includes(fieldValue);
+                    case 'not_in':
+                        return Array.isArray(targetValue) && !targetValue.includes(fieldValue);
+                    default:
+                        return false;
+                }
+            });
         }
         /**
-         * Force flush event queue
+         * Execute actions for a triggered event (client-side preview)
+         * Note: Actual execution happens on the backend
          */
-        async flush() {
-            await this.retryPendingIdentify();
-            await this.queue.flush();
+        async executeActions(trigger, data) {
+            logger.info(`Executing actions for trigger: ${trigger.name}`);
+            for (const action of trigger.actions) {
+                try {
+                    await this.executeAction(action, data);
+                }
+                catch (error) {
+                    logger.error(`Failed to execute action:`, error);
+                }
+            }
         }
         /**
-         * Reset visitor and session (for logout)
+         * Execute a single action
          */
-        reset() {
-            logger.info('Resetting visitor data');
-            resetIds(this.config.useCookies);
-            this.visitorId = this.createVisitorId();
-            this.sessionId = this.createSessionId();
-            this.queue.clear();
+        async executeAction(action, data) {
+            switch (action.type) {
+                case 'send_email':
+                    await this.executeSendEmail(action, data);
+                    break;
+                case 'webhook':
+                    await this.executeWebhook(action, data);
+                    break;
+                case 'create_task':
+                    await this.executeCreateTask(action, data);
+                    break;
+                case 'update_contact':
+                    await this.executeUpdateContact(action, data);
+                    break;
+                default:
+                    logger.warn(`Unknown action type:`, action);
+            }
         }
         /**
-         * Delete all stored user data (GDPR right-to-erasure)
+         * Execute send email action (via backend API)
          */
-        deleteData() {
-            logger.info('Deleting all user data (GDPR request)');
-            // Clear queue
-            this.queue.clear();
-            // Reset consent
-            this.consentManager.reset();
-            // Clear all stored IDs
-            resetIds(this.config.useCookies);
-            // Clear session storage items
-            if (typeof sessionStorage !== 'undefined') {
-                try {
-                    sessionStorage.removeItem(STORAGE_KEYS.VISITOR_ID);
-                    sessionStorage.removeItem(STORAGE_KEYS.VISITOR_ID + '_anon');
-                    sessionStorage.removeItem(STORAGE_KEYS.SESSION_ID);
-                    sessionStorage.removeItem(STORAGE_KEYS.SESSION_TIMESTAMP);
-                }
-                catch {
-                    // Ignore errors
-                }
-            }
-            // Clear localStorage items
-            if (typeof localStorage !== 'undefined') {
-                try {
-                    localStorage.removeItem(STORAGE_KEYS.VISITOR_ID);
-                    localStorage.removeItem(STORAGE_KEYS.CONSENT);
-                    localStorage.removeItem(STORAGE_KEYS.EVENT_QUEUE);
-                }
-                catch {
-                    // Ignore errors
-                }
+        async executeSendEmail(action, data) {
+            logger.debug('Sending email:', action);
+            const payload = {
+                to: this.replaceVariables(action.to, data),
+                subject: action.subject ? this.replaceVariables(action.subject, data) : undefined,
+                body: action.body ? this.replaceVariables(action.body, data) : undefined,
+                templateId: action.templateId,
+                cc: action.cc,
+                bcc: action.bcc,
+                from: action.from,
+                delayMinutes: action.delayMinutes,
+            };
+            await this.request(`/api/workspaces/${this.workspaceId}/emails/send`, {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+        }
+        /**
+         * Execute webhook action
+         */
+        async executeWebhook(action, data) {
+            logger.debug('Calling webhook:', action.url);
+            const body = action.body ? this.replaceVariables(action.body, data) : JSON.stringify(data);
+            await fetch(action.url, {
+                method: action.method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...action.headers,
+                },
+                body,
+            });
+        }
+        /**
+         * Execute create task action
+         */
+        async executeCreateTask(action, data) {
+            logger.debug('Creating task:', action.title);
+            const dueDate = action.dueDays
+                ? new Date(Date.now() + action.dueDays * 24 * 60 * 60 * 1000).toISOString()
+                : undefined;
+            await this.request(`/api/workspaces/${this.workspaceId}/tasks`, {
+                method: 'POST',
+                body: JSON.stringify({
+                    title: this.replaceVariables(action.title, data),
+                    description: action.description ? this.replaceVariables(action.description, data) : undefined,
+                    priority: action.priority,
+                    dueDate,
+                    assignedTo: action.assignedTo,
+                    relatedContactId: typeof data.contactId === 'string' ? data.contactId : undefined,
+                }),
+            });
+        }
+        /**
+         * Execute update contact action
+         */
+        async executeUpdateContact(action, data) {
+            const contactId = data.contactId || data._id;
+            if (!contactId) {
+                logger.warn('Cannot update contact: no contactId in data');
+                return;
             }
-            // Generate new IDs
-            this.visitorId = this.createVisitorId();
-            this.sessionId = this.createSessionId();
-            logger.info('All user data deleted');
+            logger.debug('Updating contact:', contactId);
+            await this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
+                method: 'PUT',
+                body: JSON.stringify(action.updates),
+            });
         }
         /**
-         * Destroy tracker and cleanup
+         * Replace variables in a string template
+         * Supports syntax like {{contact.email}}, {{opportunity.value}}
          */
-        async destroy() {
-            logger.info('Destroying tracker');
-            // Flush any remaining events (await to ensure completion)
-            await this.queue.flush();
-            // Destroy plugins
-            for (const plugin of this.plugins) {
-                if (plugin.destroy) {
-                    plugin.destroy();
+        replaceVariables(template, data) {
+            return template.replace(/\{\{([^}]+)\}\}/g, (match, path) => {
+                const value = this.getNestedValue(data, path.trim());
+                return value !== undefined ? String(value) : match;
+            });
+        }
+        /**
+         * Get nested value from object using dot notation
+         * Supports dynamic field access including custom fields
+         */
+        getNestedValue(obj, path) {
+            return path.split('.').reduce((current, key) => {
+                return current !== null && current !== undefined && typeof current === 'object'
+                    ? current[key]
+                    : undefined;
+            }, obj);
+        }
+        /**
+         * Extract all available field paths from a data object
+         * Useful for dynamic field discovery based on platform-specific attributes
+         * @param obj - The data object to extract fields from
+         * @param prefix - Internal use for nested paths
+         * @param maxDepth - Maximum depth to traverse (default: 3)
+         * @returns Array of field paths (e.g., ['email', 'contact.firstName', 'customFields.industry'])
+         */
+        extractAvailableFields(obj, prefix = '', maxDepth = 3) {
+            if (maxDepth <= 0)
+                return [];
+            const fields = [];
+            for (const key in obj) {
+                if (!obj.hasOwnProperty(key))
+                    continue;
+                const value = obj[key];
+                const fieldPath = prefix ? `${prefix}.${key}` : key;
+                fields.push(fieldPath);
+                // Recursively traverse nested objects
+                if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                    const nestedFields = this.extractAvailableFields(value, fieldPath, maxDepth - 1);
+                    fields.push(...nestedFields);
                 }
             }
-            this.plugins = [];
-            // Destroy queue
-            this.queue.destroy();
-            this.isInitialized = false;
+            return fields;
+        }
+        /**
+         * Get available fields from sample data
+         * Helps with dynamic field detection for platform-specific attributes
+         * @param sampleData - Sample data object to analyze
+         * @returns Array of available field paths
+         */
+        getAvailableFields(sampleData) {
+            return this.extractAvailableFields(sampleData);
+        }
+        // ============================================
+        // HELPER METHODS FOR COMMON PATTERNS
+        // ============================================
+        /**
+         * Create a simple email trigger
+         * Helper method for common use case
+         */
+        async createEmailTrigger(config) {
+            return this.createTrigger({
+                name: config.name,
+                eventType: config.eventType,
+                conditions: config.conditions,
+                actions: [
+                    {
+                        type: 'send_email',
+                        to: config.to,
+                        subject: config.subject,
+                        body: config.body,
+                    },
+                ],
+                isActive: true,
+            });
+        }
+        /**
+         * Create a task creation trigger
+         */
+        async createTaskTrigger(config) {
+            return this.createTrigger({
+                name: config.name,
+                eventType: config.eventType,
+                conditions: config.conditions,
+                actions: [
+                    {
+                        type: 'create_task',
+                        title: config.taskTitle,
+                        description: config.taskDescription,
+                        priority: config.priority,
+                        dueDays: config.dueDays,
+                    },
+                ],
+                isActive: true,
+            });
+        }
+        /**
+         * Create a webhook trigger
+         */
+        async createWebhookTrigger(config) {
+            return this.createTrigger({
+                name: config.name,
+                eventType: config.eventType,
+                conditions: config.conditions,
+                actions: [
+                    {
+                        type: 'webhook',
+                        url: config.webhookUrl,
+                        method: config.method || 'POST',
+                    },
+                ],
+                isActive: true,
+            });
         }
     }
 
     /**
-     * Clianta SDK - Event Triggers Manager
-     * Manages event-driven automation and email notifications
+     * Clianta SDK - CRM API Client
+     * @see SDK_VERSION in core/config.ts
      */
     /**
-     * Event Triggers Manager
-     * Handles event-driven automation based on CRM actions
-     *
-     * Similar to:
-     * - Salesforce: Process Builder, Flow Automation
-     * - HubSpot: Workflows, Email Sequences
-     * - Pipedrive: Workflow Automation
+     * CRM API Client for managing contacts and opportunities
      */
-    class EventTriggersManager {
-        constructor(apiEndpoint, workspaceId, authToken) {
-            this.triggers = new Map();
-            this.listeners = new Map();
+    class CRMClient {
+        constructor(apiEndpoint, workspaceId, authToken, apiKey) {
             this.apiEndpoint = apiEndpoint;
             this.workspaceId = workspaceId;
             this.authToken = authToken;
+            this.apiKey = apiKey;
+            this.triggers = new EventTriggersManager(apiEndpoint, workspaceId, authToken);
         }
         /**
-         * Set authentication token
+         * Set authentication token for API requests (user JWT)
          */
         setAuthToken(token) {
             this.authToken = token;
+            this.apiKey = undefined;
+            this.triggers.setAuthToken(token);
+        }
+        /**
+         * Set workspace API key for server-to-server requests.
+         * Use this instead of setAuthToken when integrating from an external app.
+         */
+        setApiKey(key) {
+            this.apiKey = key;
+            this.authToken = undefined;
+        }
+        /**
+         * Validate required parameter exists
+         * @throws {Error} if value is null/undefined or empty string
+         */
+        validateRequired(param, value, methodName) {
+            if (value === null || value === undefined || value === '') {
+                throw new Error(`[CRMClient.${methodName}] ${param} is required`);
+            }
         }
         /**
          * Make authenticated API request
@@ -2726,970 +2989,1206 @@
                 'Content-Type': 'application/json',
                 ...(options.headers || {}),
             };
-            if (this.authToken) {
+            if (this.apiKey) {
+                headers['X-Api-Key'] = this.apiKey;
+            }
+            else if (this.authToken) {
+                headers['Authorization'] = `Bearer ${this.authToken}`;
+            }
+            try {
+                const response = await fetch(url, {
+                    ...options,
+                    headers,
+                });
+                const data = await response.json();
+                if (!response.ok) {
+                    return {
+                        success: false,
+                        error: data.message || 'Request failed',
+                        status: response.status,
+                    };
+                }
+                return {
+                    success: true,
+                    data: data.data || data,
+                    status: response.status,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Network error',
+                    status: 0,
+                };
+            }
+        }
+        // ============================================
+        // INBOUND EVENTS API (API-key authenticated)
+        // ============================================
+        /**
+         * Send an inbound event from an external app (e.g. user signup on client website).
+         * Requires the client to be initialized with an API key via setApiKey() or the constructor.
+         *
+         * The contact is upserted in the CRM and matching workflow automations fire automatically.
+         *
+         * @example
+         * const crm = new CRMClient('https://api.clianta.online', 'WORKSPACE_ID');
+         * crm.setApiKey('mm_live_...');
+         *
+         * await crm.sendEvent({
+         *   event: 'user.registered',
+         *   contact: { email: 'alice@example.com', firstName: 'Alice' },
+         *   data: { plan: 'free', signupSource: 'homepage' },
+         * });
+         */
+        async sendEvent(payload) {
+            const url = `${this.apiEndpoint}/api/public/events`;
+            const headers = { 'Content-Type': 'application/json' };
+            if (this.apiKey) {
+                headers['X-Api-Key'] = this.apiKey;
+            }
+            else if (this.authToken) {
                 headers['Authorization'] = `Bearer ${this.authToken}`;
             }
             try {
                 const response = await fetch(url, {
-                    ...options,
+                    method: 'POST',
                     headers,
+                    body: JSON.stringify(payload),
                 });
                 const data = await response.json();
                 if (!response.ok) {
                     return {
                         success: false,
-                        error: data.message || 'Request failed',
-                        status: response.status,
+                        contactCreated: false,
+                        event: payload.event,
+                        error: data.error || 'Request failed',
                     };
                 }
                 return {
-                    success: true,
-                    data: data.data || data,
-                    status: response.status,
+                    success: data.success,
+                    contactCreated: data.contactCreated,
+                    contactId: data.contactId,
+                    event: data.event,
                 };
             }
             catch (error) {
                 return {
                     success: false,
+                    contactCreated: false,
+                    event: payload.event,
                     error: error instanceof Error ? error.message : 'Network error',
-                    status: 0,
                 };
             }
         }
         // ============================================
-        // TRIGGER MANAGEMENT
+        // CONTACTS API
         // ============================================
         /**
-         * Get all event triggers
+         * Get all contacts with pagination
          */
-        async getTriggers() {
-            return this.request(`/api/workspaces/${this.workspaceId}/triggers`);
+        async getContacts(params) {
+            const queryParams = new URLSearchParams();
+            if (params?.page)
+                queryParams.set('page', params.page.toString());
+            if (params?.limit)
+                queryParams.set('limit', params.limit.toString());
+            if (params?.search)
+                queryParams.set('search', params.search);
+            if (params?.status)
+                queryParams.set('status', params.status);
+            const query = queryParams.toString();
+            const endpoint = `/api/workspaces/${this.workspaceId}/contacts${query ? `?${query}` : ''}`;
+            return this.request(endpoint);
         }
         /**
-         * Get a single trigger by ID
+         * Get a single contact by ID
          */
-        async getTrigger(triggerId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/triggers/${triggerId}`);
+        async getContact(contactId) {
+            this.validateRequired('contactId', contactId, 'getContact');
+            return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`);
         }
         /**
-         * Create a new event trigger
+         * Create a new contact
          */
-        async createTrigger(trigger) {
-            const result = await this.request(`/api/workspaces/${this.workspaceId}/triggers`, {
+        async createContact(contact) {
+            return this.request(`/api/workspaces/${this.workspaceId}/contacts`, {
                 method: 'POST',
-                body: JSON.stringify(trigger),
+                body: JSON.stringify(contact),
             });
-            // Cache the trigger locally if successful
-            if (result.success && result.data?._id) {
-                this.triggers.set(result.data._id, result.data);
-            }
-            return result;
         }
         /**
-         * Update an existing trigger
+         * Update an existing contact
          */
-        async updateTrigger(triggerId, updates) {
-            const result = await this.request(`/api/workspaces/${this.workspaceId}/triggers/${triggerId}`, {
+        async updateContact(contactId, updates) {
+            this.validateRequired('contactId', contactId, 'updateContact');
+            return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
                 method: 'PUT',
                 body: JSON.stringify(updates),
             });
-            // Update cache if successful
-            if (result.success && result.data?._id) {
-                this.triggers.set(result.data._id, result.data);
-            }
-            return result;
         }
         /**
-         * Delete a trigger
+         * Delete a contact
          */
-        async deleteTrigger(triggerId) {
-            const result = await this.request(`/api/workspaces/${this.workspaceId}/triggers/${triggerId}`, {
+        async deleteContact(contactId) {
+            this.validateRequired('contactId', contactId, 'deleteContact');
+            return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
                 method: 'DELETE',
             });
-            // Remove from cache if successful
-            if (result.success) {
-                this.triggers.delete(triggerId);
-            }
-            return result;
-        }
-        /**
-         * Activate a trigger
-         */
-        async activateTrigger(triggerId) {
-            return this.updateTrigger(triggerId, { isActive: true });
-        }
-        /**
-         * Deactivate a trigger
-         */
-        async deactivateTrigger(triggerId) {
-            return this.updateTrigger(triggerId, { isActive: false });
         }
         // ============================================
-        // EVENT HANDLING (CLIENT-SIDE)
+        // OPPORTUNITIES API
         // ============================================
         /**
-         * Register a local event listener for client-side triggers
-         * This allows immediate client-side reactions to events
-         */
-        on(eventType, callback) {
-            if (!this.listeners.has(eventType)) {
-                this.listeners.set(eventType, new Set());
-            }
-            this.listeners.get(eventType).add(callback);
-            logger.debug(`Event listener registered: ${eventType}`);
-        }
-        /**
-         * Remove an event listener
+         * Get all opportunities with pagination
          */
-        off(eventType, callback) {
-            const listeners = this.listeners.get(eventType);
-            if (listeners) {
-                listeners.delete(callback);
-            }
+        async getOpportunities(params) {
+            const queryParams = new URLSearchParams();
+            if (params?.page)
+                queryParams.set('page', params.page.toString());
+            if (params?.limit)
+                queryParams.set('limit', params.limit.toString());
+            if (params?.pipelineId)
+                queryParams.set('pipelineId', params.pipelineId);
+            if (params?.stageId)
+                queryParams.set('stageId', params.stageId);
+            const query = queryParams.toString();
+            const endpoint = `/api/workspaces/${this.workspaceId}/opportunities${query ? `?${query}` : ''}`;
+            return this.request(endpoint);
         }
         /**
-         * Emit an event (client-side only)
-         * This will trigger any registered local listeners
+         * Get a single opportunity by ID
          */
-        emit(eventType, data) {
-            logger.debug(`Event emitted: ${eventType}`, data);
-            const listeners = this.listeners.get(eventType);
-            if (listeners) {
-                listeners.forEach(callback => {
-                    try {
-                        callback(data);
-                    }
-                    catch (error) {
-                        logger.error(`Error in event listener for ${eventType}:`, error);
-                    }
-                });
-            }
+        async getOpportunity(opportunityId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`);
         }
         /**
-         * Check if conditions are met for a trigger
-         * Supports dynamic field evaluation including custom fields and nested paths
+         * Create a new opportunity
          */
-        evaluateConditions(conditions, data) {
-            if (!conditions || conditions.length === 0) {
-                return true; // No conditions means always fire
-            }
-            return conditions.every(condition => {
-                // Support dot notation for nested fields (e.g., 'customFields.industry')
-                const fieldValue = condition.field.includes('.')
-                    ? this.getNestedValue(data, condition.field)
-                    : data[condition.field];
-                const targetValue = condition.value;
-                switch (condition.operator) {
-                    case 'equals':
-                        return fieldValue === targetValue;
-                    case 'not_equals':
-                        return fieldValue !== targetValue;
-                    case 'contains':
-                        return String(fieldValue).includes(String(targetValue));
-                    case 'greater_than':
-                        return Number(fieldValue) > Number(targetValue);
-                    case 'less_than':
-                        return Number(fieldValue) < Number(targetValue);
-                    case 'in':
-                        return Array.isArray(targetValue) && targetValue.includes(fieldValue);
-                    case 'not_in':
-                        return Array.isArray(targetValue) && !targetValue.includes(fieldValue);
-                    default:
-                        return false;
-                }
+        async createOpportunity(opportunity) {
+            return this.request(`/api/workspaces/${this.workspaceId}/opportunities`, {
+                method: 'POST',
+                body: JSON.stringify(opportunity),
             });
         }
         /**
-         * Execute actions for a triggered event (client-side preview)
-         * Note: Actual execution happens on the backend
+         * Update an existing opportunity
          */
-        async executeActions(trigger, data) {
-            logger.info(`Executing actions for trigger: ${trigger.name}`);
-            for (const action of trigger.actions) {
-                try {
-                    await this.executeAction(action, data);
-                }
-                catch (error) {
-                    logger.error(`Failed to execute action:`, error);
-                }
-            }
+        async updateOpportunity(opportunityId, updates) {
+            return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`, {
+                method: 'PUT',
+                body: JSON.stringify(updates),
+            });
         }
         /**
-         * Execute a single action
+         * Delete an opportunity
          */
-        async executeAction(action, data) {
-            switch (action.type) {
-                case 'send_email':
-                    await this.executeSendEmail(action, data);
-                    break;
-                case 'webhook':
-                    await this.executeWebhook(action, data);
-                    break;
-                case 'create_task':
-                    await this.executeCreateTask(action, data);
-                    break;
-                case 'update_contact':
-                    await this.executeUpdateContact(action, data);
-                    break;
-                default:
-                    logger.warn(`Unknown action type:`, action);
-            }
+        async deleteOpportunity(opportunityId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`, {
+                method: 'DELETE',
+            });
         }
         /**
-         * Execute send email action (via backend API)
+         * Move opportunity to a different stage
          */
-        async executeSendEmail(action, data) {
-            logger.debug('Sending email:', action);
-            const payload = {
-                to: this.replaceVariables(action.to, data),
-                subject: action.subject ? this.replaceVariables(action.subject, data) : undefined,
-                body: action.body ? this.replaceVariables(action.body, data) : undefined,
-                templateId: action.templateId,
-                cc: action.cc,
-                bcc: action.bcc,
-                from: action.from,
-                delayMinutes: action.delayMinutes,
-            };
-            await this.request(`/api/workspaces/${this.workspaceId}/emails/send`, {
+        async moveOpportunity(opportunityId, stageId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}/move`, {
                 method: 'POST',
-                body: JSON.stringify(payload),
+                body: JSON.stringify({ stageId }),
             });
         }
+        // ============================================
+        // COMPANIES API
+        // ============================================
         /**
-         * Execute webhook action
+         * Get all companies with pagination
          */
-        async executeWebhook(action, data) {
-            logger.debug('Calling webhook:', action.url);
-            const body = action.body ? this.replaceVariables(action.body, data) : JSON.stringify(data);
-            await fetch(action.url, {
-                method: action.method,
-                headers: {
-                    'Content-Type': 'application/json',
-                    ...action.headers,
-                },
-                body,
-            });
+        async getCompanies(params) {
+            const queryParams = new URLSearchParams();
+            if (params?.page)
+                queryParams.set('page', params.page.toString());
+            if (params?.limit)
+                queryParams.set('limit', params.limit.toString());
+            if (params?.search)
+                queryParams.set('search', params.search);
+            if (params?.status)
+                queryParams.set('status', params.status);
+            if (params?.industry)
+                queryParams.set('industry', params.industry);
+            const query = queryParams.toString();
+            const endpoint = `/api/workspaces/${this.workspaceId}/companies${query ? `?${query}` : ''}`;
+            return this.request(endpoint);
         }
         /**
-         * Execute create task action
+         * Get a single company by ID
          */
-        async executeCreateTask(action, data) {
-            logger.debug('Creating task:', action.title);
-            const dueDate = action.dueDays
-                ? new Date(Date.now() + action.dueDays * 24 * 60 * 60 * 1000).toISOString()
-                : undefined;
-            await this.request(`/api/workspaces/${this.workspaceId}/tasks`, {
-                method: 'POST',
-                body: JSON.stringify({
-                    title: this.replaceVariables(action.title, data),
-                    description: action.description ? this.replaceVariables(action.description, data) : undefined,
-                    priority: action.priority,
-                    dueDate,
-                    assignedTo: action.assignedTo,
-                    relatedContactId: typeof data.contactId === 'string' ? data.contactId : undefined,
-                }),
-            });
+        async getCompany(companyId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`);
         }
         /**
-         * Execute update contact action
+         * Create a new company
          */
-        async executeUpdateContact(action, data) {
-            const contactId = data.contactId || data._id;
-            if (!contactId) {
-                logger.warn('Cannot update contact: no contactId in data');
-                return;
-            }
-            logger.debug('Updating contact:', contactId);
-            await this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
-                method: 'PUT',
-                body: JSON.stringify(action.updates),
+        async createCompany(company) {
+            return this.request(`/api/workspaces/${this.workspaceId}/companies`, {
+                method: 'POST',
+                body: JSON.stringify(company),
             });
         }
         /**
-         * Replace variables in a string template
-         * Supports syntax like {{contact.email}}, {{opportunity.value}}
+         * Update an existing company
          */
-        replaceVariables(template, data) {
-            return template.replace(/\{\{([^}]+)\}\}/g, (match, path) => {
-                const value = this.getNestedValue(data, path.trim());
-                return value !== undefined ? String(value) : match;
+        async updateCompany(companyId, updates) {
+            return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`, {
+                method: 'PUT',
+                body: JSON.stringify(updates),
             });
         }
         /**
-         * Get nested value from object using dot notation
-         * Supports dynamic field access including custom fields
+         * Delete a company
          */
-        getNestedValue(obj, path) {
-            return path.split('.').reduce((current, key) => {
-                return current !== null && current !== undefined && typeof current === 'object'
-                    ? current[key]
-                    : undefined;
-            }, obj);
+        async deleteCompany(companyId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`, {
+                method: 'DELETE',
+            });
         }
         /**
-         * Extract all available field paths from a data object
-         * Useful for dynamic field discovery based on platform-specific attributes
-         * @param obj - The data object to extract fields from
-         * @param prefix - Internal use for nested paths
-         * @param maxDepth - Maximum depth to traverse (default: 3)
-         * @returns Array of field paths (e.g., ['email', 'contact.firstName', 'customFields.industry'])
+         * Get contacts belonging to a company
          */
-        extractAvailableFields(obj, prefix = '', maxDepth = 3) {
-            if (maxDepth <= 0)
-                return [];
-            const fields = [];
-            for (const key in obj) {
-                if (!obj.hasOwnProperty(key))
-                    continue;
-                const value = obj[key];
-                const fieldPath = prefix ? `${prefix}.${key}` : key;
-                fields.push(fieldPath);
-                // Recursively traverse nested objects
-                if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
-                    const nestedFields = this.extractAvailableFields(value, fieldPath, maxDepth - 1);
-                    fields.push(...nestedFields);
-                }
-            }
-            return fields;
+        async getCompanyContacts(companyId, params) {
+            const queryParams = new URLSearchParams();
+            if (params?.page)
+                queryParams.set('page', params.page.toString());
+            if (params?.limit)
+                queryParams.set('limit', params.limit.toString());
+            const query = queryParams.toString();
+            const endpoint = `/api/workspaces/${this.workspaceId}/companies/${companyId}/contacts${query ? `?${query}` : ''}`;
+            return this.request(endpoint);
         }
         /**
-         * Get available fields from sample data
-         * Helps with dynamic field detection for platform-specific attributes
-         * @param sampleData - Sample data object to analyze
-         * @returns Array of available field paths
+         * Get deals/opportunities belonging to a company
          */
-        getAvailableFields(sampleData) {
-            return this.extractAvailableFields(sampleData);
+        async getCompanyDeals(companyId, params) {
+            const queryParams = new URLSearchParams();
+            if (params?.page)
+                queryParams.set('page', params.page.toString());
+            if (params?.limit)
+                queryParams.set('limit', params.limit.toString());
+            const query = queryParams.toString();
+            const endpoint = `/api/workspaces/${this.workspaceId}/companies/${companyId}/deals${query ? `?${query}` : ''}`;
+            return this.request(endpoint);
         }
         // ============================================
-        // HELPER METHODS FOR COMMON PATTERNS
+        // PIPELINES API
         // ============================================
         /**
-         * Create a simple email trigger
-         * Helper method for common use case
+         * Get all pipelines
          */
-        async createEmailTrigger(config) {
-            return this.createTrigger({
-                name: config.name,
-                eventType: config.eventType,
-                conditions: config.conditions,
-                actions: [
-                    {
-                        type: 'send_email',
-                        to: config.to,
-                        subject: config.subject,
-                        body: config.body,
-                    },
-                ],
-                isActive: true,
-            });
+        async getPipelines() {
+            return this.request(`/api/workspaces/${this.workspaceId}/pipelines`);
         }
         /**
-         * Create a task creation trigger
+         * Get a single pipeline by ID
          */
-        async createTaskTrigger(config) {
-            return this.createTrigger({
-                name: config.name,
-                eventType: config.eventType,
-                conditions: config.conditions,
-                actions: [
-                    {
-                        type: 'create_task',
-                        title: config.taskTitle,
-                        description: config.taskDescription,
-                        priority: config.priority,
-                        dueDays: config.dueDays,
-                    },
-                ],
-                isActive: true,
-            });
+        async getPipeline(pipelineId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`);
         }
         /**
-         * Create a webhook trigger
+         * Create a new pipeline
          */
-        async createWebhookTrigger(config) {
-            return this.createTrigger({
-                name: config.name,
-                eventType: config.eventType,
-                conditions: config.conditions,
-                actions: [
-                    {
-                        type: 'webhook',
-                        url: config.webhookUrl,
-                        method: config.method || 'POST',
-                    },
-                ],
-                isActive: true,
+        async createPipeline(pipeline) {
+            return this.request(`/api/workspaces/${this.workspaceId}/pipelines`, {
+                method: 'POST',
+                body: JSON.stringify(pipeline),
             });
         }
-    }
-
-    /**
-     * Clianta SDK - CRM API Client
-     * @see SDK_VERSION in core/config.ts
-     */
-    /**
-     * CRM API Client for managing contacts and opportunities
-     */
-    class CRMClient {
-        constructor(apiEndpoint, workspaceId, authToken) {
-            this.apiEndpoint = apiEndpoint;
-            this.workspaceId = workspaceId;
-            this.authToken = authToken;
-            this.triggers = new EventTriggersManager(apiEndpoint, workspaceId, authToken);
-        }
         /**
-         * Set authentication token for API requests
-         */
-        setAuthToken(token) {
-            this.authToken = token;
-            this.triggers.setAuthToken(token);
-        }
-        /**
-         * Validate required parameter exists
-         * @throws {Error} if value is null/undefined or empty string
+         * Update an existing pipeline
          */
-        validateRequired(param, value, methodName) {
-            if (value === null || value === undefined || value === '') {
-                throw new Error(`[CRMClient.${methodName}] ${param} is required`);
-            }
+        async updatePipeline(pipelineId, updates) {
+            return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`, {
+                method: 'PUT',
+                body: JSON.stringify(updates),
+            });
         }
         /**
-         * Make authenticated API request
+         * Delete a pipeline
          */
-        async request(endpoint, options = {}) {
-            const url = `${this.apiEndpoint}${endpoint}`;
-            const headers = {
-                'Content-Type': 'application/json',
-                ...(options.headers || {}),
-            };
-            if (this.authToken) {
-                headers['Authorization'] = `Bearer ${this.authToken}`;
-            }
-            try {
-                const response = await fetch(url, {
-                    ...options,
-                    headers,
-                });
-                const data = await response.json();
-                if (!response.ok) {
-                    return {
-                        success: false,
-                        error: data.message || 'Request failed',
-                        status: response.status,
-                    };
-                }
-                return {
-                    success: true,
-                    data: data.data || data,
-                    status: response.status,
-                };
-            }
-            catch (error) {
-                return {
-                    success: false,
-                    error: error instanceof Error ? error.message : 'Network error',
-                    status: 0,
-                };
-            }
+        async deletePipeline(pipelineId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`, {
+                method: 'DELETE',
+            });
         }
         // ============================================
-        // CONTACTS API
+        // TASKS API
         // ============================================
         /**
-         * Get all contacts with pagination
+         * Get all tasks with pagination
          */
-        async getContacts(params) {
+        async getTasks(params) {
             const queryParams = new URLSearchParams();
             if (params?.page)
                 queryParams.set('page', params.page.toString());
             if (params?.limit)
                 queryParams.set('limit', params.limit.toString());
-            if (params?.search)
-                queryParams.set('search', params.search);
             if (params?.status)
                 queryParams.set('status', params.status);
+            if (params?.priority)
+                queryParams.set('priority', params.priority);
+            if (params?.contactId)
+                queryParams.set('contactId', params.contactId);
+            if (params?.companyId)
+                queryParams.set('companyId', params.companyId);
+            if (params?.opportunityId)
+                queryParams.set('opportunityId', params.opportunityId);
             const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/contacts${query ? `?${query}` : ''}`;
+            const endpoint = `/api/workspaces/${this.workspaceId}/tasks${query ? `?${query}` : ''}`;
             return this.request(endpoint);
         }
         /**
-         * Get a single contact by ID
+         * Get a single task by ID
          */
-        async getContact(contactId) {
-            this.validateRequired('contactId', contactId, 'getContact');
-            return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`);
+        async getTask(taskId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}`);
         }
         /**
-         * Create a new contact
+         * Create a new task
          */
-        async createContact(contact) {
-            return this.request(`/api/workspaces/${this.workspaceId}/contacts`, {
+        async createTask(task) {
+            return this.request(`/api/workspaces/${this.workspaceId}/tasks`, {
                 method: 'POST',
-                body: JSON.stringify(contact),
+                body: JSON.stringify(task),
             });
         }
         /**
-         * Update an existing contact
+         * Update an existing task
          */
-        async updateContact(contactId, updates) {
-            this.validateRequired('contactId', contactId, 'updateContact');
-            return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
+        async updateTask(taskId, updates) {
+            return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}`, {
                 method: 'PUT',
                 body: JSON.stringify(updates),
             });
         }
         /**
-         * Delete a contact
+         * Mark a task as completed
          */
-        async deleteContact(contactId) {
-            this.validateRequired('contactId', contactId, 'deleteContact');
-            return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
+        async completeTask(taskId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}/complete`, {
+                method: 'PATCH',
+            });
+        }
+        /**
+         * Delete a task
+         */
+        async deleteTask(taskId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}`, {
                 method: 'DELETE',
             });
         }
         // ============================================
-        // OPPORTUNITIES API
+        // ACTIVITIES API
         // ============================================
         /**
-         * Get all opportunities with pagination
+         * Get activities for a contact
          */
-        async getOpportunities(params) {
+        async getContactActivities(contactId, params) {
             const queryParams = new URLSearchParams();
             if (params?.page)
                 queryParams.set('page', params.page.toString());
             if (params?.limit)
                 queryParams.set('limit', params.limit.toString());
-            if (params?.pipelineId)
-                queryParams.set('pipelineId', params.pipelineId);
-            if (params?.stageId)
-                queryParams.set('stageId', params.stageId);
+            if (params?.type)
+                queryParams.set('type', params.type);
             const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/opportunities${query ? `?${query}` : ''}`;
+            const endpoint = `/api/workspaces/${this.workspaceId}/contacts/${contactId}/activities${query ? `?${query}` : ''}`;
             return this.request(endpoint);
         }
         /**
-         * Get a single opportunity by ID
+         * Get activities for an opportunity/deal
          */
-        async getOpportunity(opportunityId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`);
+        async getOpportunityActivities(opportunityId, params) {
+            const queryParams = new URLSearchParams();
+            if (params?.page)
+                queryParams.set('page', params.page.toString());
+            if (params?.limit)
+                queryParams.set('limit', params.limit.toString());
+            if (params?.type)
+                queryParams.set('type', params.type);
+            const query = queryParams.toString();
+            const endpoint = `/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}/activities${query ? `?${query}` : ''}`;
+            return this.request(endpoint);
         }
         /**
-         * Create a new opportunity
+         * Create a new activity
          */
-        async createOpportunity(opportunity) {
-            return this.request(`/api/workspaces/${this.workspaceId}/opportunities`, {
+        async createActivity(activity) {
+            // Determine the correct endpoint based on related entity
+            let endpoint;
+            if (activity.opportunityId) {
+                endpoint = `/api/workspaces/${this.workspaceId}/opportunities/${activity.opportunityId}/activities`;
+            }
+            else if (activity.contactId) {
+                endpoint = `/api/workspaces/${this.workspaceId}/contacts/${activity.contactId}/activities`;
+            }
+            else {
+                endpoint = `/api/workspaces/${this.workspaceId}/activities`;
+            }
+            return this.request(endpoint, {
                 method: 'POST',
-                body: JSON.stringify(opportunity),
+                body: JSON.stringify(activity),
             });
         }
         /**
-         * Update an existing opportunity
+         * Update an existing activity
          */
-        async updateOpportunity(opportunityId, updates) {
-            return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`, {
-                method: 'PUT',
+        async updateActivity(activityId, updates) {
+            return this.request(`/api/workspaces/${this.workspaceId}/activities/${activityId}`, {
+                method: 'PATCH',
                 body: JSON.stringify(updates),
             });
         }
         /**
-         * Delete an opportunity
+         * Delete an activity
          */
-        async deleteOpportunity(opportunityId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`, {
+        async deleteActivity(activityId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/activities/${activityId}`, {
                 method: 'DELETE',
             });
         }
         /**
-         * Move opportunity to a different stage
+         * Log a call activity
          */
-        async moveOpportunity(opportunityId, stageId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}/move`, {
-                method: 'POST',
-                body: JSON.stringify({ stageId }),
+        async logCall(data) {
+            return this.createActivity({
+                type: 'call',
+                title: `${data.direction === 'inbound' ? 'Inbound' : 'Outbound'} Call`,
+                direction: data.direction,
+                duration: data.duration,
+                outcome: data.outcome,
+                description: data.notes,
+                contactId: data.contactId,
+                opportunityId: data.opportunityId,
+            });
+        }
+        /**
+         * Log a meeting activity
+         */
+        async logMeeting(data) {
+            return this.createActivity({
+                type: 'meeting',
+                title: data.title,
+                duration: data.duration,
+                outcome: data.outcome,
+                description: data.notes,
+                contactId: data.contactId,
+                opportunityId: data.opportunityId,
+            });
+        }
+        /**
+         * Add a note to a contact or opportunity
+         */
+        async addNote(data) {
+            return this.createActivity({
+                type: 'note',
+                title: 'Note',
+                description: data.content,
+                contactId: data.contactId,
+                opportunityId: data.opportunityId,
             });
         }
         // ============================================
-        // COMPANIES API
+        // EMAIL TEMPLATES API
         // ============================================
         /**
-         * Get all companies with pagination
+         * Get all email templates
          */
-        async getCompanies(params) {
+        async getEmailTemplates(params) {
             const queryParams = new URLSearchParams();
             if (params?.page)
                 queryParams.set('page', params.page.toString());
             if (params?.limit)
                 queryParams.set('limit', params.limit.toString());
-            if (params?.search)
-                queryParams.set('search', params.search);
-            if (params?.status)
-                queryParams.set('status', params.status);
-            if (params?.industry)
-                queryParams.set('industry', params.industry);
             const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/companies${query ? `?${query}` : ''}`;
+            const endpoint = `/api/workspaces/${this.workspaceId}/email-templates${query ? `?${query}` : ''}`;
             return this.request(endpoint);
         }
         /**
-         * Get a single company by ID
+         * Get a single email template by ID
          */
-        async getCompany(companyId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`);
+        async getEmailTemplate(templateId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`);
         }
         /**
-         * Create a new company
+         * Create a new email template
          */
-        async createCompany(company) {
-            return this.request(`/api/workspaces/${this.workspaceId}/companies`, {
+        async createEmailTemplate(template) {
+            return this.request(`/api/workspaces/${this.workspaceId}/email-templates`, {
                 method: 'POST',
-                body: JSON.stringify(company),
+                body: JSON.stringify(template),
             });
         }
         /**
-         * Update an existing company
+         * Update an email template
          */
-        async updateCompany(companyId, updates) {
-            return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`, {
+        async updateEmailTemplate(templateId, updates) {
+            return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`, {
                 method: 'PUT',
                 body: JSON.stringify(updates),
             });
         }
         /**
-         * Delete a company
+         * Delete an email template
          */
-        async deleteCompany(companyId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`, {
+        async deleteEmailTemplate(templateId) {
+            return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`, {
                 method: 'DELETE',
             });
         }
         /**
-         * Get contacts belonging to a company
+         * Send an email using a template
          */
-        async getCompanyContacts(companyId, params) {
+        async sendEmail(data) {
+            return this.request(`/api/workspaces/${this.workspaceId}/emails/send`, {
+                method: 'POST',
+                body: JSON.stringify(data),
+            });
+        }
+        // ============================================
+        // READ-BACK / DATA RETRIEVAL API
+        // ============================================
+        /**
+         * Get a contact by email address.
+         * Returns the first matching contact from a search query.
+         */
+        async getContactByEmail(email) {
+            this.validateRequired('email', email, 'getContactByEmail');
+            const queryParams = new URLSearchParams({ search: email, limit: '1' });
+            return this.request(`/api/workspaces/${this.workspaceId}/contacts?${queryParams.toString()}`);
+        }
+        /**
+         * Get activity timeline for a contact
+         */
+        async getContactActivity(contactId, params) {
+            this.validateRequired('contactId', contactId, 'getContactActivity');
             const queryParams = new URLSearchParams();
             if (params?.page)
                 queryParams.set('page', params.page.toString());
             if (params?.limit)
                 queryParams.set('limit', params.limit.toString());
+            if (params?.type)
+                queryParams.set('type', params.type);
+            if (params?.startDate)
+                queryParams.set('startDate', params.startDate);
+            if (params?.endDate)
+                queryParams.set('endDate', params.endDate);
             const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/companies/${companyId}/contacts${query ? `?${query}` : ''}`;
+            const endpoint = `/api/workspaces/${this.workspaceId}/contacts/${contactId}/activities${query ? `?${query}` : ''}`;
             return this.request(endpoint);
         }
         /**
-         * Get deals/opportunities belonging to a company
+         * Get engagement metrics for a contact (via their linked visitor data)
          */
-        async getCompanyDeals(companyId, params) {
+        async getContactEngagement(contactId) {
+            this.validateRequired('contactId', contactId, 'getContactEngagement');
+            return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}/engagement`);
+        }
+        /**
+         * Get a full timeline for a contact including events, activities, and opportunities
+         */
+        async getContactTimeline(contactId, params) {
+            this.validateRequired('contactId', contactId, 'getContactTimeline');
             const queryParams = new URLSearchParams();
             if (params?.page)
                 queryParams.set('page', params.page.toString());
             if (params?.limit)
                 queryParams.set('limit', params.limit.toString());
             const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/companies/${companyId}/deals${query ? `?${query}` : ''}`;
+            const endpoint = `/api/workspaces/${this.workspaceId}/contacts/${contactId}/timeline${query ? `?${query}` : ''}`;
+            return this.request(endpoint);
+        }
+        /**
+         * Search contacts with advanced filters
+         */
+        async searchContacts(query, filters) {
+            const queryParams = new URLSearchParams();
+            queryParams.set('search', query);
+            if (filters?.status)
+                queryParams.set('status', filters.status);
+            if (filters?.lifecycleStage)
+                queryParams.set('lifecycleStage', filters.lifecycleStage);
+            if (filters?.source)
+                queryParams.set('source', filters.source);
+            if (filters?.tags)
+                queryParams.set('tags', filters.tags.join(','));
+            if (filters?.page)
+                queryParams.set('page', filters.page.toString());
+            if (filters?.limit)
+                queryParams.set('limit', filters.limit.toString());
+            const qs = queryParams.toString();
+            const endpoint = `/api/workspaces/${this.workspaceId}/contacts${qs ? `?${qs}` : ''}`;
             return this.request(endpoint);
         }
         // ============================================
-        // PIPELINES API
+        // WEBHOOK MANAGEMENT API
         // ============================================
         /**
-         * Get all pipelines
+         * List all webhook subscriptions
          */
-        async getPipelines() {
-            return this.request(`/api/workspaces/${this.workspaceId}/pipelines`);
+        async listWebhooks(params) {
+            const queryParams = new URLSearchParams();
+            if (params?.page)
+                queryParams.set('page', params.page.toString());
+            if (params?.limit)
+                queryParams.set('limit', params.limit.toString());
+            const query = queryParams.toString();
+            return this.request(`/api/workspaces/${this.workspaceId}/webhooks${query ? `?${query}` : ''}`);
         }
         /**
-         * Get a single pipeline by ID
+         * Create a new webhook subscription
          */
-        async getPipeline(pipelineId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`);
+        async createWebhook(data) {
+            return this.request(`/api/workspaces/${this.workspaceId}/webhooks`, {
+                method: 'POST',
+                body: JSON.stringify(data),
+            });
         }
         /**
-         * Create a new pipeline
+         * Delete a webhook subscription
          */
-        async createPipeline(pipeline) {
-            return this.request(`/api/workspaces/${this.workspaceId}/pipelines`, {
-                method: 'POST',
-                body: JSON.stringify(pipeline),
+        async deleteWebhook(webhookId) {
+            this.validateRequired('webhookId', webhookId, 'deleteWebhook');
+            return this.request(`/api/workspaces/${this.workspaceId}/webhooks/${webhookId}`, {
+                method: 'DELETE',
             });
         }
+        // ============================================
+        // EVENT TRIGGERS API (delegated to triggers manager)
+        // ============================================
+        /**
+         * Get all event triggers
+         */
+        async getEventTriggers() {
+            return this.triggers.getTriggers();
+        }
         /**
-         * Update an existing pipeline
+         * Create a new event trigger
          */
-        async updatePipeline(pipelineId, updates) {
-            return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`, {
-                method: 'PUT',
-                body: JSON.stringify(updates),
-            });
+        async createEventTrigger(trigger) {
+            return this.triggers.createTrigger(trigger);
         }
         /**
-         * Delete a pipeline
+         * Update an event trigger
          */
-        async deletePipeline(pipelineId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`, {
-                method: 'DELETE',
+        async updateEventTrigger(triggerId, updates) {
+            return this.triggers.updateTrigger(triggerId, updates);
+        }
+        /**
+         * Delete an event trigger
+         */
+        async deleteEventTrigger(triggerId) {
+            return this.triggers.deleteTrigger(triggerId);
+        }
+    }
+
+    /**
+     * Clianta SDK - Main Tracker Class
+     * @see SDK_VERSION in core/config.ts
+     */
+    /**
+     * Main Clianta Tracker Class
+     */
+    class Tracker {
+        constructor(workspaceId, userConfig = {}) {
+            this.plugins = [];
+            this.isInitialized = false;
+            /** contactId after a successful identify() call */
+            this.contactId = null;
+            /** Pending identify retry on next flush */
+            this.pendingIdentify = null;
+            /** Registered event schemas for validation */
+            this.eventSchemas = new Map();
+            if (!workspaceId) {
+                throw new Error('[Clianta] Workspace ID is required');
+            }
+            this.workspaceId = workspaceId;
+            this.config = mergeConfig(userConfig);
+            // Setup debug mode
+            logger.enabled = this.config.debug;
+            logger.info(`Initializing SDK v${SDK_VERSION}`, { workspaceId });
+            // Initialize consent manager
+            this.consentManager = new ConsentManager({
+                ...this.config.consent,
+                onConsentChange: (state, previous) => {
+                    this.onConsentChange(state, previous);
+                },
+            });
+            // Initialize transport and queue
+            this.transport = new Transport({ apiEndpoint: this.config.apiEndpoint });
+            this.queue = new EventQueue(this.transport, {
+                batchSize: this.config.batchSize,
+                flushInterval: this.config.flushInterval,
             });
+            // Get or create visitor and session IDs based on mode
+            this.visitorId = this.createVisitorId();
+            this.sessionId = this.createSessionId();
+            logger.debug('IDs created', { visitorId: this.visitorId, sessionId: this.sessionId });
+            // Security warnings
+            if (this.config.apiEndpoint.startsWith('http://') &&
+                typeof window !== 'undefined' &&
+                !window.location.hostname.includes('localhost') &&
+                !window.location.hostname.includes('127.0.0.1')) {
+                logger.warn('apiEndpoint uses HTTP — events and visitor data will be sent unencrypted. Use HTTPS in production.');
+            }
+            if (this.config.apiKey && typeof window !== 'undefined') {
+                logger.warn('API key is exposed in client-side code. Use API keys only in server-side (Node.js) environments.');
+            }
+            // Initialize plugins
+            this.initPlugins();
+            this.isInitialized = true;
+            logger.info('SDK initialized successfully');
         }
-        // ============================================
-        // TASKS API
-        // ============================================
         /**
-         * Get all tasks with pagination
+         * Create visitor ID based on storage mode
          */
-        async getTasks(params) {
-            const queryParams = new URLSearchParams();
-            if (params?.page)
-                queryParams.set('page', params.page.toString());
-            if (params?.limit)
-                queryParams.set('limit', params.limit.toString());
-            if (params?.status)
-                queryParams.set('status', params.status);
-            if (params?.priority)
-                queryParams.set('priority', params.priority);
-            if (params?.contactId)
-                queryParams.set('contactId', params.contactId);
-            if (params?.companyId)
-                queryParams.set('companyId', params.companyId);
-            if (params?.opportunityId)
-                queryParams.set('opportunityId', params.opportunityId);
-            const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/tasks${query ? `?${query}` : ''}`;
-            return this.request(endpoint);
+        createVisitorId() {
+            // Anonymous mode: use temporary ID until consent
+            if (this.config.consent.anonymousMode && !this.consentManager.hasExplicit()) {
+                const key = STORAGE_KEYS.VISITOR_ID + '_anon';
+                let anonId = getSessionStorage(key);
+                if (!anonId) {
+                    anonId = 'anon_' + generateUUID();
+                    setSessionStorage(key, anonId);
+                }
+                return anonId;
+            }
+            // Cookie-less mode: use sessionStorage only
+            if (this.config.cookielessMode) {
+                let visitorId = getSessionStorage(STORAGE_KEYS.VISITOR_ID);
+                if (!visitorId) {
+                    visitorId = generateUUID();
+                    setSessionStorage(STORAGE_KEYS.VISITOR_ID, visitorId);
+                }
+                return visitorId;
+            }
+            // Normal mode
+            return getOrCreateVisitorId(this.config.useCookies);
         }
         /**
-         * Get a single task by ID
+         * Create session ID
          */
-        async getTask(taskId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}`);
+        createSessionId() {
+            return getOrCreateSessionId(this.config.sessionTimeout);
         }
         /**
-         * Create a new task
+         * Handle consent state changes
          */
-        async createTask(task) {
-            return this.request(`/api/workspaces/${this.workspaceId}/tasks`, {
-                method: 'POST',
-                body: JSON.stringify(task),
-            });
+        onConsentChange(state, previous) {
+            logger.debug('Consent changed:', { from: previous, to: state });
+            // If analytics consent was just granted
+            if (state.analytics && !previous.analytics) {
+                // Upgrade from anonymous ID to persistent ID
+                if (this.config.consent.anonymousMode) {
+                    this.visitorId = getOrCreateVisitorId(this.config.useCookies);
+                    logger.info('Upgraded from anonymous to persistent visitor ID');
+                }
+                // Flush buffered events
+                const buffered = this.consentManager.flushBuffer();
+                for (const event of buffered) {
+                    // Update event with new visitor ID
+                    event.visitorId = this.visitorId;
+                    this.queue.push(event);
+                }
+            }
         }
         /**
-         * Update an existing task
+         * Initialize enabled plugins
+         * Handles both sync and async plugin init methods
          */
-        async updateTask(taskId, updates) {
-            return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}`, {
-                method: 'PUT',
-                body: JSON.stringify(updates),
-            });
+        initPlugins() {
+            const pluginsToLoad = this.config.plugins;
+            // Skip pageView plugin if autoPageView is disabled
+            const filteredPlugins = this.config.autoPageView
+                ? pluginsToLoad
+                : pluginsToLoad.filter((p) => p !== 'pageView');
+            for (const pluginName of filteredPlugins) {
+                try {
+                    const plugin = getPlugin(pluginName);
+                    // Handle both sync and async init (fire-and-forget for async)
+                    const result = plugin.init(this);
+                    if (result instanceof Promise) {
+                        result.catch((error) => {
+                            logger.error(`Async plugin init failed: ${pluginName}`, error);
+                        });
+                    }
+                    this.plugins.push(plugin);
+                    logger.debug(`Plugin loaded: ${pluginName}`);
+                }
+                catch (error) {
+                    logger.error(`Failed to load plugin: ${pluginName}`, error);
+                }
+            }
         }
         /**
-         * Mark a task as completed
+         * Track a custom event
          */
-        async completeTask(taskId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}/complete`, {
-                method: 'PATCH',
-            });
+        track(eventType, eventName, properties = {}) {
+            if (!this.isInitialized) {
+                logger.warn('SDK not initialized, event dropped');
+                return;
+            }
+            const event = {
+                workspaceId: this.workspaceId,
+                visitorId: this.visitorId,
+                sessionId: this.sessionId,
+                eventType: eventType,
+                eventName,
+                url: typeof window !== 'undefined' ? window.location.href : '',
+                referrer: typeof document !== 'undefined' ? document.referrer || undefined : undefined,
+                properties: {
+                    ...properties,
+                    eventId: generateUUID(), // Unique ID for deduplication on retry
+                    websiteDomain: typeof window !== 'undefined' ? window.location.hostname : undefined,
+                },
+                device: getDeviceInfo(),
+                ...getUTMParams(),
+                timestamp: new Date().toISOString(),
+                sdkVersion: SDK_VERSION,
+            };
+            // Attach contactId if known (from a prior identify() call)
+            if (this.contactId) {
+                event.contactId = this.contactId;
+            }
+            // Validate event against registered schema (debug mode only)
+            this.validateEventSchema(eventType, properties);
+            // Check consent before tracking
+            if (!this.consentManager.canTrack()) {
+                // Buffer event for later if waitForConsent is enabled
+                if (this.config.consent.waitForConsent) {
+                    this.consentManager.bufferEvent(event);
+                    return;
+                }
+                // Otherwise drop the event
+                logger.debug('Event dropped (no consent):', eventName);
+                return;
+            }
+            this.queue.push(event);
+            logger.debug('Event tracked:', eventName, properties);
         }
         /**
-         * Delete a task
+         * Track a page view
          */
-        async deleteTask(taskId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}`, {
-                method: 'DELETE',
+        page(name, properties = {}) {
+            const pageName = name || (typeof document !== 'undefined' ? document.title : 'Page View');
+            this.track('page_view', pageName, {
+                ...properties,
+                path: typeof window !== 'undefined' ? window.location.pathname : '',
             });
         }
-        // ============================================
-        // ACTIVITIES API
-        // ============================================
         /**
-         * Get activities for a contact
+         * Identify a visitor.
+         * Links the anonymous visitorId to a CRM contact and returns the contactId.
+         * All subsequent track() calls will include the contactId automatically.
          */
-        async getContactActivities(contactId, params) {
-            const queryParams = new URLSearchParams();
-            if (params?.page)
-                queryParams.set('page', params.page.toString());
-            if (params?.limit)
-                queryParams.set('limit', params.limit.toString());
-            if (params?.type)
-                queryParams.set('type', params.type);
-            const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/contacts/${contactId}/activities${query ? `?${query}` : ''}`;
-            return this.request(endpoint);
+        async identify(email, traits = {}) {
+            if (!email) {
+                logger.warn('Email is required for identification');
+                return null;
+            }
+            if (!isValidEmail(email)) {
+                logger.warn('Invalid email format, identification skipped:', email);
+                return null;
+            }
+            logger.info('Identifying visitor:', email);
+            const result = await this.transport.sendIdentify({
+                workspaceId: this.workspaceId,
+                visitorId: this.visitorId,
+                email,
+                properties: traits,
+            });
+            if (result.success) {
+                logger.info('Visitor identified successfully, contactId:', result.contactId);
+                // Store contactId so all future track() calls include it
+                this.contactId = result.contactId ?? null;
+                this.pendingIdentify = null;
+                return this.contactId;
+            }
+            else {
+                logger.error('Failed to identify visitor:', result.error);
+                // Store for retry on next flush
+                this.pendingIdentify = { email, traits };
+                return null;
+            }
         }
         /**
-         * Get activities for an opportunity/deal
+         * Send a server-side inbound event via the API key endpoint.
+         * Convenience proxy to CRMClient.sendEvent() — requires apiKey in config.
          */
-        async getOpportunityActivities(opportunityId, params) {
-            const queryParams = new URLSearchParams();
-            if (params?.page)
-                queryParams.set('page', params.page.toString());
-            if (params?.limit)
-                queryParams.set('limit', params.limit.toString());
-            if (params?.type)
-                queryParams.set('type', params.type);
-            const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}/activities${query ? `?${query}` : ''}`;
-            return this.request(endpoint);
+        async sendEvent(payload) {
+            const apiKey = this.config.apiKey;
+            if (!apiKey) {
+                logger.error('sendEvent() requires an apiKey in the SDK config');
+                return { success: false, contactCreated: false, event: payload.event, error: 'No API key configured' };
+            }
+            const client = new CRMClient(this.config.apiEndpoint, this.workspaceId, undefined, apiKey);
+            return client.sendEvent(payload);
         }
         /**
-         * Create a new activity
+         * Get the current visitor's profile from the CRM.
+         * Returns visitor data and linked contact info if identified.
+         * Only returns data for the current visitor (privacy-safe for frontend).
          */
-        async createActivity(activity) {
-            // Determine the correct endpoint based on related entity
-            let endpoint;
-            if (activity.opportunityId) {
-                endpoint = `/api/workspaces/${this.workspaceId}/opportunities/${activity.opportunityId}/activities`;
+        async getVisitorProfile() {
+            if (!this.isInitialized) {
+                logger.warn('SDK not initialized');
+                return null;
             }
-            else if (activity.contactId) {
-                endpoint = `/api/workspaces/${this.workspaceId}/contacts/${activity.contactId}/activities`;
+            const result = await this.transport.fetchData(`/api/public/track/visitor/${this.workspaceId}/${this.visitorId}/profile`);
+            if (result.success && result.data) {
+                logger.debug('Visitor profile fetched:', result.data);
+                return result.data;
             }
-            else {
-                endpoint = `/api/workspaces/${this.workspaceId}/activities`;
+            logger.warn('Failed to fetch visitor profile:', result.error);
+            return null;
+        }
+        /**
+         * Get the current visitor's recent activity/events.
+         * Returns paginated list of tracking events for this visitor.
+         */
+        async getVisitorActivity(options) {
+            if (!this.isInitialized) {
+                logger.warn('SDK not initialized');
+                return null;
             }
-            return this.request(endpoint, {
-                method: 'POST',
-                body: JSON.stringify(activity),
-            });
+            const params = {};
+            if (options?.page)
+                params.page = options.page.toString();
+            if (options?.limit)
+                params.limit = options.limit.toString();
+            if (options?.eventType)
+                params.eventType = options.eventType;
+            if (options?.startDate)
+                params.startDate = options.startDate;
+            if (options?.endDate)
+                params.endDate = options.endDate;
+            const result = await this.transport.fetchData(`/api/public/track/visitor/${this.workspaceId}/${this.visitorId}/activity`, params);
+            if (result.success && result.data) {
+                return result.data;
+            }
+            logger.warn('Failed to fetch visitor activity:', result.error);
+            return null;
         }
         /**
-         * Update an existing activity
+         * Get a summarized journey timeline for the current visitor.
+         * Includes top pages, sessions, time spent, and recent activities.
          */
-        async updateActivity(activityId, updates) {
-            return this.request(`/api/workspaces/${this.workspaceId}/activities/${activityId}`, {
-                method: 'PATCH',
-                body: JSON.stringify(updates),
-            });
+        async getVisitorTimeline() {
+            if (!this.isInitialized) {
+                logger.warn('SDK not initialized');
+                return null;
+            }
+            const result = await this.transport.fetchData(`/api/public/track/visitor/${this.workspaceId}/${this.visitorId}/timeline`);
+            if (result.success && result.data) {
+                return result.data;
+            }
+            logger.warn('Failed to fetch visitor timeline:', result.error);
+            return null;
         }
         /**
-         * Delete an activity
+         * Get engagement metrics for the current visitor.
+         * Includes time on site, page views, bounce rate, and engagement score.
          */
-        async deleteActivity(activityId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/activities/${activityId}`, {
-                method: 'DELETE',
-            });
+        async getVisitorEngagement() {
+            if (!this.isInitialized) {
+                logger.warn('SDK not initialized');
+                return null;
+            }
+            const result = await this.transport.fetchData(`/api/public/track/visitor/${this.workspaceId}/${this.visitorId}/engagement`);
+            if (result.success && result.data) {
+                return result.data;
+            }
+            logger.warn('Failed to fetch visitor engagement:', result.error);
+            return null;
         }
         /**
-         * Log a call activity
+         * Retry pending identify call
          */
-        async logCall(data) {
-            return this.createActivity({
-                type: 'call',
-                title: `${data.direction === 'inbound' ? 'Inbound' : 'Outbound'} Call`,
-                direction: data.direction,
-                duration: data.duration,
-                outcome: data.outcome,
-                description: data.notes,
-                contactId: data.contactId,
-                opportunityId: data.opportunityId,
-            });
+        async retryPendingIdentify() {
+            if (!this.pendingIdentify)
+                return;
+            const { email, traits } = this.pendingIdentify;
+            this.pendingIdentify = null;
+            await this.identify(email, traits);
         }
         /**
-         * Log a meeting activity
+         * Update consent state
          */
-        async logMeeting(data) {
-            return this.createActivity({
-                type: 'meeting',
-                title: data.title,
-                duration: data.duration,
-                outcome: data.outcome,
-                description: data.notes,
-                contactId: data.contactId,
-                opportunityId: data.opportunityId,
-            });
+        consent(state) {
+            this.consentManager.update(state);
         }
         /**
-         * Add a note to a contact or opportunity
+         * Get current consent state
          */
-        async addNote(data) {
-            return this.createActivity({
-                type: 'note',
-                title: 'Note',
-                description: data.content,
-                contactId: data.contactId,
-                opportunityId: data.opportunityId,
-            });
+        getConsentState() {
+            return this.consentManager.getState();
         }
-        // ============================================
-        // EMAIL TEMPLATES API
-        // ============================================
         /**
-         * Get all email templates
+         * Toggle debug mode
          */
-        async getEmailTemplates(params) {
-            const queryParams = new URLSearchParams();
-            if (params?.page)
-                queryParams.set('page', params.page.toString());
-            if (params?.limit)
-                queryParams.set('limit', params.limit.toString());
-            const query = queryParams.toString();
-            const endpoint = `/api/workspaces/${this.workspaceId}/email-templates${query ? `?${query}` : ''}`;
-            return this.request(endpoint);
+        debug(enabled) {
+            logger.enabled = enabled;
+            logger.info(`Debug mode ${enabled ? 'enabled' : 'disabled'}`);
         }
         /**
-         * Get a single email template by ID
+         * Register a schema for event validation.
+         * When debug mode is enabled, events will be validated against registered schemas.
+         *
+         * @example
+         * tracker.registerEventSchema('purchase', {
+         *   productId: 'string',
+         *   price: 'number',
+         *   quantity: 'number',
+         * });
          */
-        async getEmailTemplate(templateId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`);
+        registerEventSchema(eventType, schema) {
+            this.eventSchemas.set(eventType, schema);
+            logger.debug('Event schema registered:', eventType);
         }
         /**
-         * Create a new email template
+         * Validate event properties against a registered schema (debug mode only)
          */
-        async createEmailTemplate(template) {
-            return this.request(`/api/workspaces/${this.workspaceId}/email-templates`, {
-                method: 'POST',
-                body: JSON.stringify(template),
-            });
+        validateEventSchema(eventType, properties) {
+            if (!this.config.debug)
+                return;
+            const schema = this.eventSchemas.get(eventType);
+            if (!schema)
+                return;
+            for (const [key, expectedType] of Object.entries(schema)) {
+                const value = properties[key];
+                if (value === undefined) {
+                    logger.warn(`[Schema] Missing property "${key}" for event type "${eventType}"`);
+                    continue;
+                }
+                let valid = false;
+                switch (expectedType) {
+                    case 'string':
+                        valid = typeof value === 'string';
+                        break;
+                    case 'number':
+                        valid = typeof value === 'number';
+                        break;
+                    case 'boolean':
+                        valid = typeof value === 'boolean';
+                        break;
+                    case 'object':
+                        valid = typeof value === 'object' && !Array.isArray(value);
+                        break;
+                    case 'array':
+                        valid = Array.isArray(value);
+                        break;
+                }
+                if (!valid) {
+                    logger.warn(`[Schema] Property "${key}" for event "${eventType}" expected ${expectedType}, got ${typeof value}`);
+                }
+            }
         }
         /**
-         * Update an email template
+         * Get visitor ID
          */
-        async updateEmailTemplate(templateId, updates) {
-            return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`, {
-                method: 'PUT',
-                body: JSON.stringify(updates),
-            });
+        getVisitorId() {
+            return this.visitorId;
         }
         /**
-         * Delete an email template
+         * Get session ID
          */
-        async deleteEmailTemplate(templateId) {
-            return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`, {
-                method: 'DELETE',
-            });
+        getSessionId() {
+            return this.sessionId;
         }
         /**
-         * Send an email using a template
+         * Get workspace ID
          */
-        async sendEmail(data) {
-            return this.request(`/api/workspaces/${this.workspaceId}/emails/send`, {
-                method: 'POST',
-                body: JSON.stringify(data),
-            });
+        getWorkspaceId() {
+            return this.workspaceId;
         }
-        // ============================================
-        // EVENT TRIGGERS API (delegated to triggers manager)
-        // ============================================
         /**
-         * Get all event triggers
+         * Get current configuration
          */
-        async getEventTriggers() {
-            return this.triggers.getTriggers();
+        getConfig() {
+            return { ...this.config };
         }
         /**
-         * Create a new event trigger
+         * Force flush event queue
          */
-        async createEventTrigger(trigger) {
-            return this.triggers.createTrigger(trigger);
+        async flush() {
+            await this.retryPendingIdentify();
+            await this.queue.flush();
         }
         /**
-         * Update an event trigger
+         * Reset visitor and session (for logout)
          */
-        async updateEventTrigger(triggerId, updates) {
-            return this.triggers.updateTrigger(triggerId, updates);
+        reset() {
+            logger.info('Resetting visitor data');
+            resetIds(this.config.useCookies);
+            this.visitorId = this.createVisitorId();
+            this.sessionId = this.createSessionId();
+            this.contactId = null;
+            this.pendingIdentify = null;
+            this.queue.clear();
         }
         /**
-         * Delete an event trigger
+         * Delete all stored user data (GDPR right-to-erasure)
          */
-        async deleteEventTrigger(triggerId) {
-            return this.triggers.deleteTrigger(triggerId);
+        deleteData() {
+            logger.info('Deleting all user data (GDPR request)');
+            // Clear queue
+            this.queue.clear();
+            // Reset consent
+            this.consentManager.reset();
+            // Clear all stored IDs
+            resetIds(this.config.useCookies);
+            // Clear session storage items
+            if (typeof sessionStorage !== 'undefined') {
+                try {
+                    sessionStorage.removeItem(STORAGE_KEYS.VISITOR_ID);
+                    sessionStorage.removeItem(STORAGE_KEYS.VISITOR_ID + '_anon');
+                    sessionStorage.removeItem(STORAGE_KEYS.SESSION_ID);
+                    sessionStorage.removeItem(STORAGE_KEYS.SESSION_TIMESTAMP);
+                }
+                catch {
+                    // Ignore errors
+                }
+            }
+            // Clear localStorage items
+            if (typeof localStorage !== 'undefined') {
+                try {
+                    localStorage.removeItem(STORAGE_KEYS.VISITOR_ID);
+                    localStorage.removeItem(STORAGE_KEYS.CONSENT);
+                    localStorage.removeItem(STORAGE_KEYS.EVENT_QUEUE);
+                }
+                catch {
+                    // Ignore errors
+                }
+            }
+            // Generate new IDs
+            this.visitorId = this.createVisitorId();
+            this.sessionId = this.createSessionId();
+            logger.info('All user data deleted');
+        }
+        /**
+         * Destroy tracker and cleanup
+         */
+        async destroy() {
+            logger.info('Destroying tracker');
+            // Flush any remaining events (await to ensure completion)
+            await this.queue.flush();
+            // Destroy plugins
+            for (const plugin of this.plugins) {
+                if (plugin.destroy) {
+                    plugin.destroy();
+                }
+            }
+            this.plugins = [];
+            // Destroy queue
+            this.queue.destroy();
+            this.isInitialized = false;
         }
     }