@clianta/sdk 1.3.0 → 1.5.0

package/dist/clianta.esm.js

@@ -1,5 +1,5 @@
 /*!
- * Clianta SDK v1.3.0
+ * Clianta SDK v1.5.0
  * (c) 2026 Clianta
  * Released under the MIT License.
  */
@@ -8,7 +8,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')
@@ -34,6 +34,7 @@ const DEFAULT_CONFIG = {
     projectId: '',
     apiEndpoint: getDefaultApiEndpoint(),
     authToken: '',
+    apiKey: '',
     debug: false,
     autoPageView: true,
     plugins: DEFAULT_PLUGINS,
@@ -49,6 +50,7 @@ const DEFAULT_CONFIG = {
     cookieDomain: '',
     useCookies: false,
     cookielessMode: false,
+    persistMode: 'session',
 };
 /** Storage keys */
 const STORAGE_KEYS = {
@@ -181,12 +183,39 @@ class Transport {
         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)
@@ -215,6 +244,39 @@ class Transport {
             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
      */
@@ -379,7 +441,9 @@ function cookie(name, value, days) {
         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;
 }
 // ============================================
@@ -543,6 +607,17 @@ function isMobile() {
     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
 // ============================================
 /**
@@ -596,6 +671,7 @@ class EventQueue {
             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
@@ -701,6 +777,13 @@ class EventQueue {
     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
@@ -755,22 +838,44 @@ class EventQueue {
         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) {
@@ -838,10 +943,13 @@ class PageViewPlugin extends BasePlugin {
             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();
@@ -895,9 +1003,8 @@ class ScrollPlugin extends BasePlugin {
         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) {
@@ -906,8 +1013,13 @@ class ScrollPlugin extends BasePlugin {
         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() {
@@ -917,16 +1029,10 @@ class ScrollPlugin extends BasePlugin {
         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;
@@ -941,29 +1047,6 @@ class ScrollPlugin extends BasePlugin {
         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) {
@@ -1163,6 +1246,10 @@ class ClicksPlugin extends BasePlugin {
             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,
         });
     }
 }
@@ -1185,6 +1272,9 @@ class EngagementPlugin extends BasePlugin {
         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);
@@ -1210,6 +1300,13 @@ class EngagementPlugin extends BasePlugin {
         // 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') {
@@ -1223,11 +1320,28 @@ class EngagementPlugin extends BasePlugin {
         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;
@@ -1267,9 +1381,8 @@ class DownloadsPlugin extends BasePlugin {
         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) {
@@ -1277,24 +1390,25 @@ class DownloadsPlugin extends BasePlugin {
         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;
@@ -1307,29 +1421,6 @@ class DownloadsPlugin extends BasePlugin {
     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)
@@ -1365,6 +1456,9 @@ class ExitIntentPlugin extends BasePlugin {
         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);
@@ -1376,13 +1470,34 @@ class ExitIntentPlugin extends BasePlugin {
             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)
@@ -1610,6 +1725,8 @@ class PopupFormsPlugin extends BasePlugin {
         this.shownForms = new Set();
         this.scrollHandler = null;
         this.exitHandler = null;
+        this.delayTimers = [];
+        this.clickTriggerListeners = [];
     }
     async init(tracker) {
         super.init(tracker);
@@ -1624,6 +1741,14 @@ class PopupFormsPlugin extends BasePlugin {
     }
     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() {
@@ -1686,7 +1811,7 @@ class PopupFormsPlugin extends BasePlugin {
         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);
@@ -1729,7 +1854,9 @@ class PopupFormsPlugin extends BasePlugin {
             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() {
@@ -2016,7 +2143,7 @@ class PopupFormsPlugin extends BasePlugin {
         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`, {
@@ -2057,11 +2184,24 @@ class PopupFormsPlugin extends BasePlugin {
                 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(() => {
@@ -2076,7 +2216,7 @@ class PopupFormsPlugin extends BasePlugin {
             console.error('[Clianta] Form submit error:', error);
             if (submitBtn) {
                 submitBtn.disabled = false;
-                submitBtn.innerHTML = form.submitButtonText || 'Subscribe';
+                submitBtn.textContent = form.submitButtonText || 'Subscribe';
             }
         }
     }
@@ -2361,355 +2501,478 @@ class ConsentManager {
 }
 
 /**
- * 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
@@ -2720,970 +2983,1206 @@ class EventTriggersManager {
             '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;
     }
 }