@clianta/sdk 1.5.1 → 1.6.1

package/dist/react.cjs.js

@@ -1,5 +1,5 @@
 /*!
- * Clianta SDK v1.5.1
+ * Clianta SDK v1.6.1
  * (c) 2026 Clianta
  * Released under the MIT License.
  */
@@ -13,7 +13,7 @@ var react = require('react');
  * @see SDK_VERSION in core/config.ts
  */
 /** SDK Version */
-const SDK_VERSION = '1.4.0';
+const SDK_VERSION = '1.6.1';
 /** Default API endpoint — reads from env or falls back to localhost */
 const getDefaultApiEndpoint = () => {
     // Build-time env var (works with Next.js, Vite, CRA, etc.)
@@ -45,8 +45,6 @@ const DEFAULT_PLUGINS = [
 const DEFAULT_CONFIG = {
     projectId: '',
     apiEndpoint: getDefaultApiEndpoint(),
-    authToken: '',
-    apiKey: '',
     debug: false,
     autoPageView: true,
     plugins: DEFAULT_PLUGINS,
@@ -2512,1189 +2510,6 @@ class ConsentManager {
     }
 }
 
-/**
- * Clianta SDK - Event Triggers Manager
- * Manages event-driven automation and email notifications
- */
-/**
- * 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 EventTriggersManager {
-    constructor(apiEndpoint, workspaceId, authToken) {
-        this.triggers = new Map();
-        this.listeners = new Map();
-        this.apiEndpoint = apiEndpoint;
-        this.workspaceId = workspaceId;
-        this.authToken = authToken;
-    }
-    /**
-     * Set authentication token
-     */
-    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}`;
-        }
-        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,
-            };
-        }
-    }
-    // ============================================
-    // TRIGGER MANAGEMENT
-    // ============================================
-    /**
-     * Get all event triggers
-     */
-    async getTriggers() {
-        return this.request(`/api/workspaces/${this.workspaceId}/triggers`);
-    }
-    /**
-     * Get a single trigger by ID
-     */
-    async getTrigger(triggerId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/triggers/${triggerId}`);
-    }
-    /**
-     * Create a new event trigger
-     */
-    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);
-        }
-        return result;
-    }
-    /**
-     * Update an existing trigger
-     */
-    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;
-    }
-    /**
-     * Delete a trigger
-     */
-    async deleteTrigger(triggerId) {
-        const result = await this.request(`/api/workspaces/${this.workspaceId}/triggers/${triggerId}`, {
-            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)
-    // ============================================
-    /**
-     * 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
-     */
-    off(eventType, callback) {
-        const listeners = this.listeners.get(eventType);
-        if (listeners) {
-            listeners.delete(callback);
-        }
-    }
-    /**
-     * Emit an event (client-side only)
-     * This will trigger any registered local listeners
-     */
-    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);
-                }
-            });
-        }
-    }
-    /**
-     * Check if conditions are met for a trigger
-     * Supports dynamic field evaluation including custom fields and nested paths
-     */
-    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;
-            }
-        });
-    }
-    /**
-     * Execute actions for a triggered event (client-side preview)
-     * Note: Actual execution happens on the backend
-     */
-    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);
-            }
-        }
-    }
-    /**
-     * Execute a single action
-     */
-    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);
-        }
-    }
-    /**
-     * Execute send email action (via backend API)
-     */
-    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;
-        }
-        logger.debug('Updating contact:', contactId);
-        await this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
-            method: 'PUT',
-            body: JSON.stringify(action.updates),
-        });
-    }
-    /**
-     * Replace variables in a string template
-     * Supports syntax like {{contact.email}}, {{opportunity.value}}
-     */
-    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);
-            }
-        }
-        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 - CRM API Client
- * @see SDK_VERSION in core/config.ts
- */
-/**
- * CRM API Client for managing contacts and opportunities
- */
-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 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
-     */
-    async request(endpoint, options = {}) {
-        const url = `${this.apiEndpoint}${endpoint}`;
-        const headers = {
-            'Content-Type': 'application/json',
-            ...(options.headers || {}),
-        };
-        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('http://localhost:5000', '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, {
-                method: 'POST',
-                headers,
-                body: JSON.stringify(payload),
-            });
-            const data = await response.json();
-            if (!response.ok) {
-                return {
-                    success: false,
-                    contactCreated: false,
-                    event: payload.event,
-                    error: data.error || 'Request failed',
-                };
-            }
-            return {
-                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',
-            };
-        }
-    }
-    // ============================================
-    // CONTACTS API
-    // ============================================
-    /**
-     * Get all contacts with pagination
-     */
-    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 contact by ID
-     */
-    async getContact(contactId) {
-        this.validateRequired('contactId', contactId, 'getContact');
-        return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`);
-    }
-    /**
-     * Create a new contact
-     */
-    async createContact(contact) {
-        return this.request(`/api/workspaces/${this.workspaceId}/contacts`, {
-            method: 'POST',
-            body: JSON.stringify(contact),
-        });
-    }
-    /**
-     * Update an existing contact
-     */
-    async updateContact(contactId, updates) {
-        this.validateRequired('contactId', contactId, 'updateContact');
-        return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
-            method: 'PUT',
-            body: JSON.stringify(updates),
-        });
-    }
-    /**
-     * Delete a contact
-     */
-    async deleteContact(contactId) {
-        this.validateRequired('contactId', contactId, 'deleteContact');
-        return this.request(`/api/workspaces/${this.workspaceId}/contacts/${contactId}`, {
-            method: 'DELETE',
-        });
-    }
-    // ============================================
-    // OPPORTUNITIES API
-    // ============================================
-    /**
-     * Get all opportunities with pagination
-     */
-    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);
-    }
-    /**
-     * Get a single opportunity by ID
-     */
-    async getOpportunity(opportunityId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`);
-    }
-    /**
-     * Create a new opportunity
-     */
-    async createOpportunity(opportunity) {
-        return this.request(`/api/workspaces/${this.workspaceId}/opportunities`, {
-            method: 'POST',
-            body: JSON.stringify(opportunity),
-        });
-    }
-    /**
-     * Update an existing opportunity
-     */
-    async updateOpportunity(opportunityId, updates) {
-        return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`, {
-            method: 'PUT',
-            body: JSON.stringify(updates),
-        });
-    }
-    /**
-     * Delete an opportunity
-     */
-    async deleteOpportunity(opportunityId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}`, {
-            method: 'DELETE',
-        });
-    }
-    /**
-     * Move opportunity to a different stage
-     */
-    async moveOpportunity(opportunityId, stageId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/opportunities/${opportunityId}/move`, {
-            method: 'POST',
-            body: JSON.stringify({ stageId }),
-        });
-    }
-    // ============================================
-    // COMPANIES API
-    // ============================================
-    /**
-     * Get all companies with pagination
-     */
-    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);
-    }
-    /**
-     * Get a single company by ID
-     */
-    async getCompany(companyId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`);
-    }
-    /**
-     * Create a new company
-     */
-    async createCompany(company) {
-        return this.request(`/api/workspaces/${this.workspaceId}/companies`, {
-            method: 'POST',
-            body: JSON.stringify(company),
-        });
-    }
-    /**
-     * Update an existing company
-     */
-    async updateCompany(companyId, updates) {
-        return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`, {
-            method: 'PUT',
-            body: JSON.stringify(updates),
-        });
-    }
-    /**
-     * Delete a company
-     */
-    async deleteCompany(companyId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/companies/${companyId}`, {
-            method: 'DELETE',
-        });
-    }
-    /**
-     * Get contacts belonging to a company
-     */
-    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 deals/opportunities belonging to a company
-     */
-    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);
-    }
-    // ============================================
-    // PIPELINES API
-    // ============================================
-    /**
-     * Get all pipelines
-     */
-    async getPipelines() {
-        return this.request(`/api/workspaces/${this.workspaceId}/pipelines`);
-    }
-    /**
-     * Get a single pipeline by ID
-     */
-    async getPipeline(pipelineId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`);
-    }
-    /**
-     * Create a new pipeline
-     */
-    async createPipeline(pipeline) {
-        return this.request(`/api/workspaces/${this.workspaceId}/pipelines`, {
-            method: 'POST',
-            body: JSON.stringify(pipeline),
-        });
-    }
-    /**
-     * Update an existing pipeline
-     */
-    async updatePipeline(pipelineId, updates) {
-        return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`, {
-            method: 'PUT',
-            body: JSON.stringify(updates),
-        });
-    }
-    /**
-     * Delete a pipeline
-     */
-    async deletePipeline(pipelineId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/pipelines/${pipelineId}`, {
-            method: 'DELETE',
-        });
-    }
-    // ============================================
-    // TASKS API
-    // ============================================
-    /**
-     * Get all tasks with pagination
-     */
-    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);
-    }
-    /**
-     * Get a single task by ID
-     */
-    async getTask(taskId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}`);
-    }
-    /**
-     * Create a new task
-     */
-    async createTask(task) {
-        return this.request(`/api/workspaces/${this.workspaceId}/tasks`, {
-            method: 'POST',
-            body: JSON.stringify(task),
-        });
-    }
-    /**
-     * Update an existing task
-     */
-    async updateTask(taskId, updates) {
-        return this.request(`/api/workspaces/${this.workspaceId}/tasks/${taskId}`, {
-            method: 'PUT',
-            body: JSON.stringify(updates),
-        });
-    }
-    /**
-     * Mark a task as completed
-     */
-    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',
-        });
-    }
-    // ============================================
-    // ACTIVITIES API
-    // ============================================
-    /**
-     * Get activities for a contact
-     */
-    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);
-    }
-    /**
-     * Get activities for an opportunity/deal
-     */
-    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 activity
-     */
-    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(activity),
-        });
-    }
-    /**
-     * Update an existing activity
-     */
-    async updateActivity(activityId, updates) {
-        return this.request(`/api/workspaces/${this.workspaceId}/activities/${activityId}`, {
-            method: 'PATCH',
-            body: JSON.stringify(updates),
-        });
-    }
-    /**
-     * Delete an activity
-     */
-    async deleteActivity(activityId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/activities/${activityId}`, {
-            method: 'DELETE',
-        });
-    }
-    /**
-     * Log a call activity
-     */
-    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,
-        });
-    }
-    // ============================================
-    // EMAIL TEMPLATES API
-    // ============================================
-    /**
-     * Get all email templates
-     */
-    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);
-    }
-    /**
-     * Get a single email template by ID
-     */
-    async getEmailTemplate(templateId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`);
-    }
-    /**
-     * Create a new email template
-     */
-    async createEmailTemplate(template) {
-        return this.request(`/api/workspaces/${this.workspaceId}/email-templates`, {
-            method: 'POST',
-            body: JSON.stringify(template),
-        });
-    }
-    /**
-     * Update an email template
-     */
-    async updateEmailTemplate(templateId, updates) {
-        return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`, {
-            method: 'PUT',
-            body: JSON.stringify(updates),
-        });
-    }
-    /**
-     * Delete an email template
-     */
-    async deleteEmailTemplate(templateId) {
-        return this.request(`/api/workspaces/${this.workspaceId}/email-templates/${templateId}`, {
-            method: 'DELETE',
-        });
-    }
-    /**
-     * Send an email using a template
-     */
-    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}/contacts/${contactId}/activities${query ? `?${query}` : ''}`;
-        return this.request(endpoint);
-    }
-    /**
-     * Get engagement metrics for a contact (via their linked visitor data)
-     */
-    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}/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);
-    }
-    // ============================================
-    // WEBHOOK MANAGEMENT API
-    // ============================================
-    /**
-     * List all webhook subscriptions
-     */
-    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}` : ''}`);
-    }
-    /**
-     * Create a new webhook subscription
-     */
-    async createWebhook(data) {
-        return this.request(`/api/workspaces/${this.workspaceId}/webhooks`, {
-            method: 'POST',
-            body: JSON.stringify(data),
-        });
-    }
-    /**
-     * Delete a webhook subscription
-     */
-    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();
-    }
-    /**
-     * Create a new event trigger
-     */
-    async createEventTrigger(trigger) {
-        return this.triggers.createTrigger(trigger);
-    }
-    /**
-     * Update an event trigger
-     */
-    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
@@ -3708,10 +2523,16 @@ class Tracker {
         this.isInitialized = false;
         /** contactId after a successful identify() call */
         this.contactId = null;
+        /** groupId after a successful group() call */
+        this.groupId = null;
         /** Pending identify retry on next flush */
         this.pendingIdentify = null;
         /** Registered event schemas for validation */
         this.eventSchemas = new Map();
+        /** Event middleware pipeline */
+        this.middlewares = [];
+        /** Ready callbacks */
+        this.readyCallbacks = [];
         if (!workspaceId) {
             throw new Error('[Clianta] Workspace ID is required');
         }
@@ -3742,15 +2563,22 @@ class Tracker {
             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.');
+            logger.warn('apiEndpoint uses HTTP — events will be sent unencrypted. Use HTTPS in production.');
         }
         // Initialize plugins
         this.initPlugins();
         this.isInitialized = true;
         logger.info('SDK initialized successfully');
+        // Fire ready callbacks
+        for (const cb of this.readyCallbacks) {
+            try {
+                cb();
+            }
+            catch (e) {
+                logger.error('onReady callback error:', e);
+            }
+        }
+        this.readyCallbacks = [];
     }
     /**
      * Create visitor ID based on storage mode
@@ -3863,6 +2691,10 @@ class Tracker {
         if (this.contactId) {
             event.contactId = this.contactId;
         }
+        // Attach groupId if known (from a prior group() call)
+        if (this.groupId) {
+            event.groupId = this.groupId;
+        }
         // Validate event against registered schema (debug mode only)
         this.validateEventSchema(eventType, properties);
         // Check consent before tracking
@@ -3876,8 +2708,11 @@ class Tracker {
             logger.debug('Event dropped (no consent):', eventName);
             return;
         }
-        this.queue.push(event);
-        logger.debug('Event tracked:', eventName, properties);
+        // Run event through middleware pipeline
+        this.runMiddleware(event, () => {
+            this.queue.push(event);
+            logger.debug('Event tracked:', eventName, properties);
+        });
     }
     /**
      * Track a page view
@@ -3925,123 +2760,176 @@ class Tracker {
         }
     }
     /**
-     * Send a server-side inbound event via the API key endpoint.
-     * Convenience proxy to CRMClient.sendEvent() — requires apiKey in config.
+     * Retry pending identify call
      */
-    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);
+    async retryPendingIdentify() {
+        if (!this.pendingIdentify)
+            return;
+        const { email, traits } = this.pendingIdentify;
+        this.pendingIdentify = null;
+        await this.identify(email, traits);
     }
     /**
-     * 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).
+     * Update consent state
      */
-    async getVisitorProfile() {
-        if (!this.isInitialized) {
-            logger.warn('SDK not initialized');
-            return null;
-        }
-        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;
-        }
-        logger.warn('Failed to fetch visitor profile:', result.error);
-        return null;
+    consent(state) {
+        this.consentManager.update(state);
     }
     /**
-     * Get the current visitor's recent activity/events.
-     * Returns paginated list of tracking events for this visitor.
+     * Get current consent state
      */
-    async getVisitorActivity(options) {
-        if (!this.isInitialized) {
-            logger.warn('SDK not initialized');
-            return null;
-        }
-        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;
+    getConsentState() {
+        return this.consentManager.getState();
     }
     /**
-     * Get a summarized journey timeline for the current visitor.
-     * Includes top pages, sessions, time spent, and recent activities.
+     * Toggle debug mode
      */
-    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;
+    debug(enabled) {
+        logger.enabled = enabled;
+        logger.info(`Debug mode ${enabled ? 'enabled' : 'disabled'}`);
+    }
+    // ============================================
+    // GROUP, ALIAS, SCREEN
+    // ============================================
+    /**
+     * Associate the current visitor with a group (company/account).
+     * The groupId will be attached to all subsequent track() calls.
+     */
+    group(groupId, traits = {}) {
+        if (!groupId) {
+            logger.warn('groupId is required for group()');
+            return;
         }
-        logger.warn('Failed to fetch visitor timeline:', result.error);
-        return null;
+        this.groupId = groupId;
+        logger.info('Visitor grouped:', groupId);
+        this.track('group', 'Group Identified', {
+            groupId,
+            ...traits,
+        });
     }
     /**
-     * Get engagement metrics for the current visitor.
-     * Includes time on site, page views, bounce rate, and engagement score.
+     * Merge two visitor identities.
+     * Links `previousId` (typically the anonymous visitor) to `newId` (the known user).
+     * If `previousId` is omitted, the current visitorId is used.
      */
-    async getVisitorEngagement() {
-        if (!this.isInitialized) {
-            logger.warn('SDK not initialized');
-            return null;
+    async alias(newId, previousId) {
+        if (!newId) {
+            logger.warn('newId is required for alias()');
+            return false;
+        }
+        const prevId = previousId || this.visitorId;
+        logger.info('Aliasing visitor:', { from: prevId, to: newId });
+        try {
+            const url = `${this.config.apiEndpoint}/api/public/track/alias`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    workspaceId: this.workspaceId,
+                    previousId: prevId,
+                    newId,
+                }),
+            });
+            if (response.ok) {
+                logger.info('Alias successful');
+                return true;
+            }
+            logger.error('Alias failed:', response.status);
+            return false;
         }
-        const result = await this.transport.fetchData(`/api/public/track/visitor/${this.workspaceId}/${this.visitorId}/engagement`);
-        if (result.success && result.data) {
-            return result.data;
+        catch (error) {
+            logger.error('Alias request failed:', error);
+            return false;
         }
-        logger.warn('Failed to fetch visitor engagement:', result.error);
-        return null;
     }
     /**
-     * Retry pending identify call
+     * Track a screen view (for mobile-first PWAs and SPAs).
+     * Similar to page() but semantically for app screens.
      */
-    async retryPendingIdentify() {
-        if (!this.pendingIdentify)
-            return;
-        const { email, traits } = this.pendingIdentify;
-        this.pendingIdentify = null;
-        await this.identify(email, traits);
+    screen(name, properties = {}) {
+        this.track('screen_view', name, {
+            ...properties,
+            screenName: name,
+        });
     }
+    // ============================================
+    // MIDDLEWARE
+    // ============================================
     /**
-     * Update consent state
+     * Register event middleware.
+     * Middleware functions receive the event and a `next` callback.
+     * Call `next()` to pass the event through, or don't call it to drop the event.
+     *
+     * @example
+     * tracker.use((event, next) => {
+     *   // Strip PII from events
+     *   delete event.properties.email;
+     *   next(); // pass it through
+     * });
      */
-    consent(state) {
-        this.consentManager.update(state);
+    use(middleware) {
+        this.middlewares.push(middleware);
+        logger.debug('Middleware registered');
     }
     /**
-     * Get current consent state
+     * Run event through the middleware pipeline.
+     * Executes each middleware in order; if any skips `next()`, the event is dropped.
      */
-    getConsentState() {
-        return this.consentManager.getState();
+    runMiddleware(event, finalCallback) {
+        if (this.middlewares.length === 0) {
+            finalCallback();
+            return;
+        }
+        let index = 0;
+        const middlewares = this.middlewares;
+        const next = () => {
+            index++;
+            if (index < middlewares.length) {
+                try {
+                    middlewares[index](event, next);
+                }
+                catch (e) {
+                    logger.error('Middleware error:', e);
+                    finalCallback();
+                }
+            }
+            else {
+                finalCallback();
+            }
+        };
+        try {
+            middlewares[0](event, next);
+        }
+        catch (e) {
+            logger.error('Middleware error:', e);
+            finalCallback();
+        }
     }
+    // ============================================
+    // LIFECYCLE
+    // ============================================
     /**
-     * Toggle debug mode
+     * Register a callback to be invoked when the SDK is fully initialized.
+     * If already initialized, the callback fires immediately.
      */
-    debug(enabled) {
-        logger.enabled = enabled;
-        logger.info(`Debug mode ${enabled ? 'enabled' : 'disabled'}`);
+    onReady(callback) {
+        if (this.isInitialized) {
+            try {
+                callback();
+            }
+            catch (e) {
+                logger.error('onReady callback error:', e);
+            }
+        }
+        else {
+            this.readyCallbacks.push(callback);
+        }
+    }
+    /**
+     * Check if the SDK is fully initialized and ready.
+     */
+    isReady() {
+        return this.isInitialized;
     }
     /**
      * Register a schema for event validation.
@@ -4280,7 +3168,12 @@ class Tracker {
 
 /**
  * Clianta SDK
- * Professional CRM and tracking SDK for lead generation
+ * Client-side tracking SDK for CRM — tracks visitors, identifies contacts,
+ * captures forms, and writes CRM data from client websites.
+ *
+ * This SDK is designed to run on CLIENT WEBSITES (React, Next.js, Vue, etc.)
+ * It only SENDS data to your CRM — it never reads CRM data back.
+ *
  * @see SDK_VERSION in core/config.ts
  */
 // Global instance cache
@@ -4322,29 +3215,55 @@ function clianta(workspaceId, config) {
     globalInstance = new Tracker(workspaceId, config);
     return globalInstance;
 }
-// Attach to window for <script> usage
+// Attach to window for <script> tag usage
 if (typeof window !== 'undefined') {
     window.clianta = clianta;
     window.Clianta = {
         clianta,
         Tracker,
-        CRMClient,
         ConsentManager,
-        EventTriggersManager,
     };
 }
 
 /**
  * Clianta SDK - React Integration
  *
- * Provides CliantaProvider component for easy React/Next.js integration
- * using the clianta.config.ts pattern.
+ * Provides CliantaProvider component (with ErrorBoundary) for easy
+ * React/Next.js integration using the clianta.config.ts pattern.
+ */
+const CliantaContext = react.createContext({
+    tracker: null,
+    isReady: false,
+});
+/**
+ * Internal ErrorBoundary to prevent SDK errors from crashing the host app.
+ * Catches render-time errors in the provider tree.
  */
-// Context for accessing tracker throughout the app
-const CliantaContext = react.createContext(null);
+class CliantaErrorBoundary extends react.Component {
+    constructor(props) {
+        super(props);
+        this.state = { hasError: false };
+    }
+    static getDerivedStateFromError() {
+        return { hasError: true };
+    }
+    componentDidCatch(error, errorInfo) {
+        console.error('[Clianta] SDK error caught by ErrorBoundary:', error);
+        this.props.onError?.(error, errorInfo);
+    }
+    render() {
+        if (this.state.hasError) {
+            // Render children anyway — SDK failure shouldn't break the host UI
+            return this.props.fallback ?? this.props.children;
+        }
+        return this.props.children;
+    }
+}
 /**
  * CliantaProvider - Wrap your app to enable tracking
  *
+ * Includes an ErrorBoundary so SDK failures never crash the host app.
+ *
  * @example
  * // In clianta.config.ts:
  * import { CliantaConfig } from '@clianta/sdk';
@@ -4365,8 +3284,9 @@ const CliantaContext = react.createContext(null);
  *   {children}
  * </CliantaProvider>
  */
-function CliantaProvider({ config, children }) {
+function CliantaProvider({ config, children, onError }) {
     const [tracker, setTracker] = react.useState(null);
+    const [isReady, setIsReady] = react.useState(false);
     // Stable ref to projectId — the only value that truly identifies the tracker
     const projectIdRef = react.useRef(config.projectId);
     react.useEffect(() => {
@@ -4380,18 +3300,29 @@ function CliantaProvider({ config, children }) {
         if (projectIdRef.current !== projectId) {
             projectIdRef.current = projectId;
         }
-        // Extract projectId (handled separately) and pass rest as options
-        const { projectId: _, ...options } = config;
-        const instance = clianta(projectId, options);
-        setTracker(instance);
+        try {
+            // Extract projectId (handled separately) and pass rest as options
+            const { projectId: _, ...options } = config;
+            const instance = clianta(projectId, options);
+            setTracker(instance);
+            setIsReady(true);
+        }
+        catch (error) {
+            console.error('[Clianta] Failed to initialize SDK:', error);
+            onError?.(error, { componentStack: '' });
+        }
         // Cleanup: flush pending events on unmount
         return () => {
-            instance?.flush();
+            tracker?.flush();
+            setIsReady(false);
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [config.projectId]);
-    return (jsxRuntime.jsx(CliantaContext.Provider, { value: tracker, children: children }));
+    return (jsxRuntime.jsx(CliantaErrorBoundary, { onError: onError, children: jsxRuntime.jsx(CliantaContext.Provider, { value: { tracker, isReady }, children: children }) }));
 }
+// ============================================
+// HOOKS
+// ============================================
 /**
  * useClianta - Hook to access tracker in any component
  *
@@ -4400,7 +3331,21 @@ function CliantaProvider({ config, children }) {
  * tracker?.track('button_click', 'CTA Button');
  */
 function useClianta() {
-    return react.useContext(CliantaContext);
+    const { tracker } = react.useContext(CliantaContext);
+    return tracker;
+}
+/**
+ * useCliantaReady - Hook to check if SDK is initialized
+ *
+ * @example
+ * const { isReady, tracker } = useCliantaReady();
+ * if (isReady) {
+ *   tracker.track('purchase', 'Order', { value: 99 });
+ * }
+ */
+function useCliantaReady() {
+    const { tracker, isReady } = react.useContext(CliantaContext);
+    return { isReady, tracker };
 }
 /**
  * useCliantaTrack - Convenience hook for tracking events
@@ -4418,5 +3363,6 @@ function useCliantaTrack() {
 
 exports.CliantaProvider = CliantaProvider;
 exports.useClianta = useClianta;
+exports.useCliantaReady = useCliantaReady;
 exports.useCliantaTrack = useCliantaTrack;
 //# sourceMappingURL=react.cjs.js.map