@clianta/sdk 1.3.0 → 1.5.0

package/dist/index.d.ts

@@ -1,945 +1,1222 @@
 /**
- * Clianta SDK - Type Definitions
- * @see SDK_VERSION in core/config.ts
+ * Clianta SDK - Event Triggers Manager
+ * Manages event-driven automation and email notifications
  */
-interface CliantaConfig {
-    /** Project ID (required for config file pattern) */
-    projectId?: string;
-    /** Backend API endpoint URL */
-    apiEndpoint?: string;
-    /** Auth token for server-side API access */
-    authToken?: string;
-    /** Enable debug mode with verbose logging */
-    debug?: boolean;
-    /** Automatically track page views on load and navigation */
-    autoPageView?: boolean;
-    /** Plugins to enable (default: all core plugins) */
-    plugins?: PluginName[];
-    /** Session timeout in milliseconds (default: 30 minutes) */
-    sessionTimeout?: number;
-    /** Maximum events to batch before sending (default: 10) */
-    batchSize?: number;
-    /** Interval to flush events in milliseconds (default: 5000) */
-    flushInterval?: number;
-    /** Consent configuration */
-    consent?: ConsentConfig;
-    /** Cookie domain for cross-subdomain tracking */
-    cookieDomain?: string;
-    /** Use cookies instead of localStorage for visitor ID */
-    useCookies?: boolean;
-    /** Cookie-less mode: use sessionStorage only (no persistent storage) */
-    cookielessMode?: boolean;
-}
-type PluginName = 'pageView' | 'forms' | 'scroll' | 'clicks' | 'engagement' | 'downloads' | 'exitIntent' | 'errors' | 'performance' | 'popupForms';
-interface ConsentConfig {
-    /** Default consent state before user action */
-    defaultConsent?: ConsentState;
-    /** Wait for consent before tracking anything */
-    waitForConsent?: boolean;
-    /** Storage key for consent state */
-    storageKey?: string;
-    /** Anonymous mode: track without visitor ID until explicit consent */
-    anonymousMode?: boolean;
-}
-interface ConsentState {
-    /** Consent for analytics/essential tracking */
-    analytics?: boolean;
-    /** Consent for marketing/advertising tracking */
-    marketing?: boolean;
-    /** Consent for personalization */
-    personalization?: boolean;
-}
-type EventType = 'page_view' | 'button_click' | 'form_view' | 'form_submit' | 'form_interaction' | 'scroll_depth' | 'engagement' | 'download' | 'exit_intent' | 'error' | 'performance' | 'time_on_page' | 'custom';
-interface TrackingEvent {
-    /** Workspace/project ID */
-    workspaceId: string;
-    /** Anonymous visitor identifier */
-    visitorId: string;
-    /** Session identifier */
-    sessionId: string;
-    /** Event type category */
-    eventType: EventType;
-    /** Human-readable event name */
-    eventName: string;
-    /** Current page URL */
-    url: string;
-    /** Referrer URL */
-    referrer?: string;
-    /** Event properties/metadata */
-    properties: Record<string, unknown>;
-    /** Device information */
-    device: DeviceInfo;
-    /** UTM parameters */
-    utm?: UTMParams;
-    /** ISO timestamp */
-    timestamp: string;
-    /** SDK version */
-    sdkVersion: string;
+
+/**
+ * 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
+ */
+declare class EventTriggersManager {
+    private apiEndpoint;
+    private workspaceId;
+    private authToken?;
+    private triggers;
+    private listeners;
+    constructor(apiEndpoint: string, workspaceId: string, authToken?: string);
+    /**
+     * Set authentication token
+     */
+    setAuthToken(token: string): void;
+    /**
+     * Make authenticated API request
+     */
+    private request;
+    /**
+     * Get all event triggers
+     */
+    getTriggers(): Promise<ApiResponse<EventTrigger[]>>;
+    /**
+     * Get a single trigger by ID
+     */
+    getTrigger(triggerId: string): Promise<ApiResponse<EventTrigger>>;
+    /**
+     * Create a new event trigger
+     */
+    createTrigger(trigger: Partial<EventTrigger>): Promise<ApiResponse<EventTrigger>>;
+    /**
+     * Update an existing trigger
+     */
+    updateTrigger(triggerId: string, updates: Partial<EventTrigger>): Promise<ApiResponse<EventTrigger>>;
+    /**
+     * Delete a trigger
+     */
+    deleteTrigger(triggerId: string): Promise<ApiResponse<void>>;
+    /**
+     * Activate a trigger
+     */
+    activateTrigger(triggerId: string): Promise<ApiResponse<EventTrigger>>;
+    /**
+     * Deactivate a trigger
+     */
+    deactivateTrigger(triggerId: string): Promise<ApiResponse<EventTrigger>>;
+    /**
+     * Register a local event listener for client-side triggers
+     * This allows immediate client-side reactions to events
+     */
+    on(eventType: TriggerEventType, callback: (data: unknown) => void): void;
+    /**
+     * Remove an event listener
+     */
+    off(eventType: TriggerEventType, callback: (data: unknown) => void): void;
+    /**
+     * Emit an event (client-side only)
+     * This will trigger any registered local listeners
+     */
+    emit(eventType: TriggerEventType, data: unknown): void;
+    /**
+     * Check if conditions are met for a trigger
+     * Supports dynamic field evaluation including custom fields and nested paths
+     */
+    private evaluateConditions;
+    /**
+     * Execute actions for a triggered event (client-side preview)
+     * Note: Actual execution happens on the backend
+     */
+    executeActions(trigger: EventTrigger, data: Record<string, unknown>): Promise<void>;
+    /**
+     * Execute a single action
+     */
+    private executeAction;
+    /**
+     * Execute send email action (via backend API)
+     */
+    private executeSendEmail;
+    /**
+     * Execute webhook action
+     */
+    private executeWebhook;
+    /**
+     * Execute create task action
+     */
+    private executeCreateTask;
+    /**
+     * Execute update contact action
+     */
+    private executeUpdateContact;
+    /**
+     * Replace variables in a string template
+     * Supports syntax like {{contact.email}}, {{opportunity.value}}
+     */
+    private replaceVariables;
+    /**
+     * Get nested value from object using dot notation
+     * Supports dynamic field access including custom fields
+     */
+    private getNestedValue;
+    /**
+     * 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'])
+     */
+    private extractAvailableFields;
+    /**
+     * 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: Record<string, unknown>): string[];
+    /**
+     * Create a simple email trigger
+     * Helper method for common use case
+     */
+    createEmailTrigger(config: {
+        name: string;
+        eventType: TriggerEventType;
+        to: string;
+        subject: string;
+        body: string;
+        conditions?: TriggerCondition[];
+    }): Promise<ApiResponse<EventTrigger>>;
+    /**
+     * Create a task creation trigger
+     */
+    createTaskTrigger(config: {
+        name: string;
+        eventType: TriggerEventType;
+        taskTitle: string;
+        taskDescription?: string;
+        priority?: 'low' | 'medium' | 'high' | 'urgent';
+        dueDays?: number;
+        conditions?: TriggerCondition[];
+    }): Promise<ApiResponse<EventTrigger>>;
+    /**
+     * Create a webhook trigger
+     */
+    createWebhookTrigger(config: {
+        name: string;
+        eventType: TriggerEventType;
+        webhookUrl: string;
+        method?: 'POST' | 'PUT' | 'PATCH';
+        conditions?: TriggerCondition[];
+    }): Promise<ApiResponse<EventTrigger>>;
 }
-interface DeviceInfo {
-    userAgent: string;
-    screen: string;
-    language: string;
-    timezone?: string;
+
+/**
+ * Clianta SDK - CRM API Client
+ * @see SDK_VERSION in core/config.ts
+ */
+
+type InboundEventType = 'user.registered' | 'user.updated' | 'user.subscribed' | 'user.unsubscribed' | 'contact.created' | 'contact.updated' | 'purchase.completed';
+interface InboundEventPayload {
+    /** Event type (e.g. "user.registered") */
+    event: InboundEventType;
+    /** Contact data — at least email or phone is required */
+    contact: {
+        email?: string;
+        phone?: string;
+        firstName?: string;
+        lastName?: string;
+        company?: string;
+        jobTitle?: string;
+        tags?: string[];
+    };
+    /** Optional extra data stored as customFields on the contact */
+    data?: Record<string, unknown>;
 }
-interface UTMParams {
-    utmSource?: string;
-    utmMedium?: string;
-    utmCampaign?: string;
-    utmTerm?: string;
-    utmContent?: string;
+interface InboundEventResult {
+    success: boolean;
+    contactCreated: boolean;
+    contactId?: string;
+    event: string;
+    error?: string;
 }
-interface UserTraits {
-    firstName?: string;
-    lastName?: string;
-    company?: string;
-    phone?: string;
-    title?: string;
-    [key: string]: unknown;
-}
-interface Plugin {
-    /** Unique plugin name */
-    name: PluginName;
-    /** Initialize the plugin (can be sync or async) */
-    init(tracker: TrackerCore): void | Promise<void>;
-    /** Cleanup when plugin is disabled */
-    destroy?(): void;
-}
-interface TrackerCore {
-    /** Track a custom event */
-    track(eventType: EventType | string, eventName: string, properties?: Record<string, unknown>): void;
-    /** Identify a visitor */
-    identify(email: string, traits?: UserTraits): void;
-    /** Track a page view */
-    page(name?: string, properties?: Record<string, unknown>): void;
-    /** Update consent state */
-    consent(state: ConsentState): void;
-    /** Toggle debug mode */
-    debug(enabled: boolean): void;
-    /** Get visitor ID */
-    getVisitorId(): string;
-    /** Get session ID */
-    getSessionId(): string;
-    /** Force flush event queue */
-    flush(): Promise<void>;
-    /** Reset visitor (for logout) */
-    reset(): void;
-    /** Get current configuration */
-    getConfig(): CliantaConfig;
-    /** Get workspace ID */
-    getWorkspaceId(): string;
-    /** Delete all stored user data (GDPR right-to-erasure) */
-    deleteData(): void;
-    /** Get current consent state */
-    getConsentState(): ConsentState;
-}
-interface Contact {
-    _id?: string;
-    workspaceId: string;
-    email: string;
-    firstName?: string;
-    lastName?: string;
-    company?: string;
-    jobTitle?: string;
-    phone?: string;
-    status?: 'lead' | 'contact' | 'customer';
-    lifecycleStage?: 'subscriber' | 'lead' | 'mql' | 'sql' | 'opportunity' | 'customer' | 'evangelist';
-    source?: string;
-    tags?: string[];
-    leadScore?: number;
-    customFields?: Record<string, unknown>;
-    companyId?: string;
-    assignedTo?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-interface Company {
-    _id?: string;
-    workspaceId: string;
-    name: string;
-    industry?: string;
-    website?: string;
-    phone?: string;
-    address?: {
-        street?: string;
-        city?: string;
-        state?: string;
-        country?: string;
-        postalCode?: string;
-    };
-    companySize?: string;
-    annualRevenue?: number;
-    status?: 'prospect' | 'active' | 'inactive' | 'churned';
-    accountTier?: 'enterprise' | 'mid-market' | 'smb';
-    isTargetAccount?: boolean;
-    tags?: string[];
-    customFields?: Record<string, unknown>;
-    assignedTo?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-interface Pipeline {
-    _id?: string;
-    workspaceId: string;
-    name: string;
-    description?: string;
-    stages: PipelineStage[];
-    isDefault?: boolean;
-    isActive?: boolean;
-    createdAt?: string;
-    updatedAt?: string;
-}
-interface PipelineStage {
-    _id?: string;
-    name: string;
-    order: number;
-    probability?: number;
-    color?: string;
-    rottenDays?: number;
-}
-interface Task {
-    _id?: string;
-    workspaceId: string;
-    title: string;
-    description?: string;
-    status?: 'pending' | 'in_progress' | 'completed' | 'cancelled';
-    priority?: 'low' | 'medium' | 'high' | 'urgent';
-    dueDate?: string;
-    reminderDate?: string;
-    completedAt?: string;
-    tags?: string[];
-    relatedContactId?: string;
-    relatedCompanyId?: string;
-    relatedOpportunityId?: string;
-    assignedTo?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-interface Activity {
-    _id?: string;
-    workspaceId: string;
-    type: 'call' | 'email' | 'meeting' | 'note' | 'task' | 'other';
-    title: string;
-    description?: string;
-    direction?: 'inbound' | 'outbound';
-    duration?: number;
-    outcome?: string;
-    emailSubject?: string;
-    emailBody?: string;
-    metadata?: Record<string, unknown>;
-    contactId?: string;
-    companyId?: string;
-    opportunityId?: string;
-    userId?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-interface Opportunity {
-    _id?: string;
-    workspaceId: string;
-    contactId: string;
-    companyId?: string;
-    pipelineId: string;
-    stageId: string;
-    title: string;
-    value?: number;
-    currency?: string;
-    probability?: number;
-    expectedCloseDate?: string;
-    status?: 'open' | 'won' | 'lost';
-    priority?: 'low' | 'medium' | 'high';
-    lostReason?: string;
-    customFields?: Record<string, unknown>;
-    assignedTo?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-interface ApiResponse<T> {
-    success: boolean;
-    data?: T;
-    error?: string;
-    status: number;
-}
-interface PaginatedResponse<T> {
-    data: T[];
-    pagination: {
-        page: number;
-        limit: number;
-        total: number;
-        pages: number;
-    };
-}
-type TriggerEventType = 'contact.created' | 'contact.updated' | 'contact.deleted' | 'opportunity.created' | 'opportunity.updated' | 'opportunity.stage_changed' | 'opportunity.won' | 'opportunity.lost' | 'task.created' | 'task.completed' | 'task.overdue' | 'activity.logged' | 'form.submitted';
-interface TriggerCondition {
-    /**
-     * Field to check - supports dynamic field names including custom fields
-     * Examples: 'status', 'lifecycleStage', 'leadScore', 'customFields.industry'
-     * Use dot notation for nested fields: 'contact.email', 'customFields.accountType'
-     */
-    field: string;
-    /** Operator for comparison */
-    operator: 'equals' | 'not_equals' | 'contains' | 'greater_than' | 'less_than' | 'in' | 'not_in';
-    /** Value to compare against */
-    value: unknown;
-}
-interface EmailTemplate {
-    /** Template ID */
-    _id?: string;
-    /** Template name */
-    name: string;
-    /** Email subject line (supports variables) */
-    subject: string;
-    /** Email body (supports HTML and variables) */
-    body: string;
-    /** Variables available in this template */
-    variables?: string[];
-    /** Sender email address */
-    fromEmail?: string;
-    /** Sender name */
-    fromName?: string;
-}
-interface EmailAction {
-    /** Action type identifier */
-    type: 'send_email';
-    /** Email template ID or inline template */
-    templateId?: string;
-    /** Inline email subject (if not using template) */
-    subject?: string;
-    /** Inline email body (if not using template) */
-    body?: string;
-    /** Recipient email (supports variables like {{contact.email}}) */
-    to: string;
-    /** CC recipients */
-    cc?: string[];
-    /** BCC recipients */
-    bcc?: string[];
-    /** Sender email */
-    from?: string;
-    /** Delay in minutes before sending */
-    delayMinutes?: number;
-}
-interface WebhookAction {
-    /** Action type identifier */
-    type: 'webhook';
-    /** Webhook URL to call */
-    url: string;
-    /** HTTP method */
-    method: 'POST' | 'PUT' | 'PATCH';
-    /** Custom headers */
-    headers?: Record<string, string>;
-    /** Request body template (supports variables) */
-    body?: string;
-}
-interface TaskAction {
-    /** Action type identifier */
-    type: 'create_task';
-    /** Task title (supports variables) */
-    title: string;
-    /** Task description */
-    description?: string;
-    /** Task priority */
-    priority?: 'low' | 'medium' | 'high' | 'urgent';
-    /** Due date in days from trigger */
-    dueDays?: number;
-    /** Assign to user ID */
-    assignedTo?: string;
-}
-interface ContactUpdateAction {
-    /** Action type identifier */
-    type: 'update_contact';
-    /** Fields to update */
-    updates: Partial<Contact>;
-}
-type TriggerAction = EmailAction | WebhookAction | TaskAction | ContactUpdateAction;
-interface EventTrigger {
-    /** Trigger ID */
-    _id?: string;
-    /** Workspace ID */
-    workspaceId: string;
-    /** Trigger name */
-    name: string;
-    /** Description of what this trigger does */
-    description?: string;
-    /** Event type that activates this trigger */
-    eventType: TriggerEventType;
-    /** Conditions that must be met for trigger to fire */
-    conditions?: TriggerCondition[];
-    /** Actions to execute when trigger fires */
-    actions: TriggerAction[];
-    /** Whether this trigger is active */
-    isActive?: boolean;
-    /** Created timestamp */
-    createdAt?: string;
-    /** Updated timestamp */
-    updatedAt?: string;
-}
-interface TriggerExecution {
-    /** Execution ID */
-    _id?: string;
-    /** Trigger ID that was executed */
-    triggerId: string;
-    /** Event that triggered the execution */
-    eventType: TriggerEventType;
-    /** Entity ID that triggered the event */
-    entityId: string;
-    /** Execution status */
-    status: 'pending' | 'success' | 'failed';
-    /** Error message if failed */
-    error?: string;
-    /** Actions executed */
-    actionsExecuted: number;
-    /** Execution timestamp */
-    executedAt: string;
-}
-
-/**
- * Clianta SDK - Main Tracker Class
- * @see SDK_VERSION in core/config.ts
- */
-
 /**
- * Main Clianta Tracker Class
+ * CRM API Client for managing contacts and opportunities
  */
-declare class Tracker implements TrackerCore {
+declare class CRMClient {
+    private apiEndpoint;
     private workspaceId;
-    private config;
-    private transport;
-    private queue;
-    private plugins;
-    private visitorId;
-    private sessionId;
-    private isInitialized;
-    private consentManager;
-    /** Pending identify retry on next flush */
-    private pendingIdentify;
-    constructor(workspaceId: string, userConfig?: CliantaConfig);
+    private authToken?;
+    private apiKey?;
+    triggers: EventTriggersManager;
+    constructor(apiEndpoint: string, workspaceId: string, authToken?: string, apiKey?: string);
+    /**
+     * Set authentication token for API requests (user JWT)
+     */
+    setAuthToken(token: string): void;
+    /**
+     * Set workspace API key for server-to-server requests.
+     * Use this instead of setAuthToken when integrating from an external app.
+     */
+    setApiKey(key: string): void;
+    /**
+     * Validate required parameter exists
+     * @throws {Error} if value is null/undefined or empty string
+     */
+    private validateRequired;
+    /**
+     * Make authenticated API request
+     */
+    private request;
+    /**
+     * 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' },
+     * });
+     */
+    sendEvent(payload: InboundEventPayload): Promise<InboundEventResult>;
+    /**
+     * Get all contacts with pagination
+     */
+    getContacts(params?: {
+        page?: number;
+        limit?: number;
+        search?: string;
+        status?: string;
+    }): Promise<ApiResponse<PaginatedResponse<Contact>>>;
+    /**
+     * Get a single contact by ID
+     */
+    getContact(contactId: string): Promise<ApiResponse<Contact>>;
+    /**
+     * Create a new contact
+     */
+    createContact(contact: Partial<Contact>): Promise<ApiResponse<Contact>>;
+    /**
+     * Update an existing contact
+     */
+    updateContact(contactId: string, updates: Partial<Contact>): Promise<ApiResponse<Contact>>;
     /**
-     * Create visitor ID based on storage mode
+     * Delete a contact
      */
-    private createVisitorId;
+    deleteContact(contactId: string): Promise<ApiResponse<void>>;
     /**
-     * Create session ID
+     * Get all opportunities with pagination
      */
-    private createSessionId;
+    getOpportunities(params?: {
+        page?: number;
+        limit?: number;
+        pipelineId?: string;
+        stageId?: string;
+    }): Promise<ApiResponse<PaginatedResponse<Opportunity>>>;
     /**
-     * Handle consent state changes
+     * Get a single opportunity by ID
      */
-    private onConsentChange;
+    getOpportunity(opportunityId: string): Promise<ApiResponse<Opportunity>>;
     /**
-     * Initialize enabled plugins
-     * Handles both sync and async plugin init methods
+     * Create a new opportunity
      */
-    private initPlugins;
+    createOpportunity(opportunity: Partial<Opportunity>): Promise<ApiResponse<Opportunity>>;
     /**
-     * Track a custom event
+     * Update an existing opportunity
      */
-    track(eventType: EventType | string, eventName: string, properties?: Record<string, unknown>): void;
+    updateOpportunity(opportunityId: string, updates: Partial<Opportunity>): Promise<ApiResponse<Opportunity>>;
     /**
-     * Track a page view
+     * Delete an opportunity
      */
-    page(name?: string, properties?: Record<string, unknown>): void;
+    deleteOpportunity(opportunityId: string): Promise<ApiResponse<void>>;
     /**
-     * Identify a visitor
+     * Move opportunity to a different stage
      */
-    identify(email: string, traits?: UserTraits): Promise<void>;
+    moveOpportunity(opportunityId: string, stageId: string): Promise<ApiResponse<Opportunity>>;
     /**
-     * Retry pending identify call
+     * Get all companies with pagination
      */
-    private retryPendingIdentify;
+    getCompanies(params?: {
+        page?: number;
+        limit?: number;
+        search?: string;
+        status?: string;
+        industry?: string;
+    }): Promise<ApiResponse<PaginatedResponse<Company>>>;
     /**
-     * Update consent state
+     * Get a single company by ID
      */
-    consent(state: ConsentState): void;
+    getCompany(companyId: string): Promise<ApiResponse<Company>>;
     /**
-     * Get current consent state
+     * Create a new company
      */
-    getConsentState(): ConsentState;
+    createCompany(company: Partial<Company>): Promise<ApiResponse<Company>>;
     /**
-     * Toggle debug mode
+     * Update an existing company
      */
-    debug(enabled: boolean): void;
+    updateCompany(companyId: string, updates: Partial<Company>): Promise<ApiResponse<Company>>;
     /**
-     * Get visitor ID
+     * Delete a company
      */
-    getVisitorId(): string;
+    deleteCompany(companyId: string): Promise<ApiResponse<void>>;
     /**
-     * Get session ID
+     * Get contacts belonging to a company
      */
-    getSessionId(): string;
+    getCompanyContacts(companyId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<PaginatedResponse<Contact>>>;
     /**
-     * Get workspace ID
+     * Get deals/opportunities belonging to a company
      */
-    getWorkspaceId(): string;
+    getCompanyDeals(companyId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<PaginatedResponse<Opportunity>>>;
     /**
-     * Get current configuration
+     * Get all pipelines
      */
-    getConfig(): CliantaConfig;
+    getPipelines(): Promise<ApiResponse<Pipeline[]>>;
     /**
-     * Force flush event queue
+     * Get a single pipeline by ID
      */
-    flush(): Promise<void>;
+    getPipeline(pipelineId: string): Promise<ApiResponse<Pipeline>>;
     /**
-     * Reset visitor and session (for logout)
+     * Create a new pipeline
      */
-    reset(): void;
+    createPipeline(pipeline: Partial<Pipeline>): Promise<ApiResponse<Pipeline>>;
     /**
-     * Delete all stored user data (GDPR right-to-erasure)
+     * Update an existing pipeline
      */
-    deleteData(): void;
+    updatePipeline(pipelineId: string, updates: Partial<Pipeline>): Promise<ApiResponse<Pipeline>>;
     /**
-     * Destroy tracker and cleanup
+     * Delete a pipeline
      */
-    destroy(): Promise<void>;
-}
-
-/**
- * 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
- */
-declare class EventTriggersManager {
-    private apiEndpoint;
-    private workspaceId;
-    private authToken?;
-    private triggers;
-    private listeners;
-    constructor(apiEndpoint: string, workspaceId: string, authToken?: string);
+    deletePipeline(pipelineId: string): Promise<ApiResponse<void>>;
     /**
-     * Set authentication token
+     * Get all tasks with pagination
      */
-    setAuthToken(token: string): void;
+    getTasks(params?: {
+        page?: number;
+        limit?: number;
+        status?: string;
+        priority?: string;
+        contactId?: string;
+        companyId?: string;
+        opportunityId?: string;
+    }): Promise<ApiResponse<PaginatedResponse<Task>>>;
     /**
-     * Make authenticated API request
+     * Get a single task by ID
      */
-    private request;
+    getTask(taskId: string): Promise<ApiResponse<Task>>;
     /**
-     * Get all event triggers
+     * Create a new task
      */
-    getTriggers(): Promise<ApiResponse<EventTrigger[]>>;
+    createTask(task: Partial<Task>): Promise<ApiResponse<Task>>;
     /**
-     * Get a single trigger by ID
+     * Update an existing task
      */
-    getTrigger(triggerId: string): Promise<ApiResponse<EventTrigger>>;
+    updateTask(taskId: string, updates: Partial<Task>): Promise<ApiResponse<Task>>;
     /**
-     * Create a new event trigger
+     * Mark a task as completed
      */
-    createTrigger(trigger: Partial<EventTrigger>): Promise<ApiResponse<EventTrigger>>;
+    completeTask(taskId: string): Promise<ApiResponse<Task>>;
     /**
-     * Update an existing trigger
+     * Delete a task
      */
-    updateTrigger(triggerId: string, updates: Partial<EventTrigger>): Promise<ApiResponse<EventTrigger>>;
+    deleteTask(taskId: string): Promise<ApiResponse<void>>;
     /**
-     * Delete a trigger
+     * Get activities for a contact
      */
-    deleteTrigger(triggerId: string): Promise<ApiResponse<void>>;
+    getContactActivities(contactId: string, params?: {
+        page?: number;
+        limit?: number;
+        type?: string;
+    }): Promise<ApiResponse<PaginatedResponse<Activity>>>;
     /**
-     * Activate a trigger
+     * Get activities for an opportunity/deal
      */
-    activateTrigger(triggerId: string): Promise<ApiResponse<EventTrigger>>;
+    getOpportunityActivities(opportunityId: string, params?: {
+        page?: number;
+        limit?: number;
+        type?: string;
+    }): Promise<ApiResponse<PaginatedResponse<Activity>>>;
     /**
-     * Deactivate a trigger
+     * Create a new activity
      */
-    deactivateTrigger(triggerId: string): Promise<ApiResponse<EventTrigger>>;
+    createActivity(activity: Partial<Activity>): Promise<ApiResponse<Activity>>;
     /**
-     * Register a local event listener for client-side triggers
-     * This allows immediate client-side reactions to events
+     * Update an existing activity
      */
-    on(eventType: TriggerEventType, callback: (data: unknown) => void): void;
+    updateActivity(activityId: string, updates: Partial<Activity>): Promise<ApiResponse<Activity>>;
     /**
-     * Remove an event listener
+     * Delete an activity
      */
-    off(eventType: TriggerEventType, callback: (data: unknown) => void): void;
+    deleteActivity(activityId: string): Promise<ApiResponse<void>>;
     /**
-     * Emit an event (client-side only)
-     * This will trigger any registered local listeners
+     * Log a call activity
      */
-    emit(eventType: TriggerEventType, data: unknown): void;
+    logCall(data: {
+        contactId?: string;
+        opportunityId?: string;
+        direction: 'inbound' | 'outbound';
+        duration?: number;
+        outcome?: string;
+        notes?: string;
+    }): Promise<ApiResponse<Activity>>;
     /**
-     * Check if conditions are met for a trigger
-     * Supports dynamic field evaluation including custom fields and nested paths
+     * Log a meeting activity
      */
-    private evaluateConditions;
+    logMeeting(data: {
+        contactId?: string;
+        opportunityId?: string;
+        title: string;
+        duration?: number;
+        outcome?: string;
+        notes?: string;
+    }): Promise<ApiResponse<Activity>>;
     /**
-     * Execute actions for a triggered event (client-side preview)
-     * Note: Actual execution happens on the backend
+     * Add a note to a contact or opportunity
      */
-    executeActions(trigger: EventTrigger, data: Record<string, unknown>): Promise<void>;
+    addNote(data: {
+        contactId?: string;
+        opportunityId?: string;
+        content: string;
+    }): Promise<ApiResponse<Activity>>;
     /**
-     * Execute a single action
+     * Get all email templates
      */
-    private executeAction;
+    getEmailTemplates(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<PaginatedResponse<EmailTemplate>>>;
     /**
-     * Execute send email action (via backend API)
+     * Get a single email template by ID
      */
-    private executeSendEmail;
+    getEmailTemplate(templateId: string): Promise<ApiResponse<EmailTemplate>>;
     /**
-     * Execute webhook action
+     * Create a new email template
      */
-    private executeWebhook;
+    createEmailTemplate(template: Partial<EmailTemplate>): Promise<ApiResponse<EmailTemplate>>;
+    /**
+     * Update an email template
+     */
+    updateEmailTemplate(templateId: string, updates: Partial<EmailTemplate>): Promise<ApiResponse<EmailTemplate>>;
+    /**
+     * Delete an email template
+     */
+    deleteEmailTemplate(templateId: string): Promise<ApiResponse<void>>;
+    /**
+     * Send an email using a template
+     */
+    sendEmail(data: {
+        to: string;
+        templateId?: string;
+        subject?: string;
+        body?: string;
+        cc?: string[];
+        bcc?: string[];
+        variables?: Record<string, unknown>;
+        contactId?: string;
+    }): Promise<ApiResponse<{
+        messageId: string;
+    }>>;
+    /**
+     * Get a contact by email address.
+     * Returns the first matching contact from a search query.
+     */
+    getContactByEmail(email: string): Promise<ApiResponse<PaginatedResponse<Contact>>>;
+    /**
+     * Get activity timeline for a contact
+     */
+    getContactActivity(contactId: string, params?: {
+        page?: number;
+        limit?: number;
+        type?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<ApiResponse<PaginatedResponse<Activity>>>;
     /**
-     * Execute create task action
+     * Get engagement metrics for a contact (via their linked visitor data)
      */
-    private executeCreateTask;
+    getContactEngagement(contactId: string): Promise<ApiResponse<{
+        totalTimeOnSiteSeconds: number;
+        averageSessionDurationSeconds: number;
+        totalPageViews: number;
+        totalSessions: number;
+        engagementScore: number;
+        lastActiveAt: string;
+    }>>;
     /**
-     * Execute update contact action
+     * Get a full timeline for a contact including events, activities, and opportunities
      */
-    private executeUpdateContact;
+    getContactTimeline(contactId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<PaginatedResponse<{
+        type: 'event' | 'activity' | 'opportunity' | 'note';
+        title: string;
+        description?: string;
+        timestamp: string;
+        metadata?: Record<string, unknown>;
+    }>>>;
     /**
-     * Replace variables in a string template
-     * Supports syntax like {{contact.email}}, {{opportunity.value}}
+     * Search contacts with advanced filters
      */
-    private replaceVariables;
+    searchContacts(query: string, filters?: {
+        status?: string;
+        lifecycleStage?: string;
+        source?: string;
+        tags?: string[];
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<PaginatedResponse<Contact>>>;
     /**
-     * Get nested value from object using dot notation
-     * Supports dynamic field access including custom fields
+     * List all webhook subscriptions
      */
-    private getNestedValue;
+    listWebhooks(params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<PaginatedResponse<{
+        _id: string;
+        url: string;
+        events: string[];
+        isActive: boolean;
+        createdAt: string;
+    }>>>;
+    /**
+     * Create a new webhook subscription
+     */
+    createWebhook(data: {
+        url: string;
+        events: string[];
+        secret?: string;
+    }): Promise<ApiResponse<{
+        _id: string;
+        url: string;
+        events: string[];
+        isActive: boolean;
+    }>>;
     /**
-     * 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'])
+     * Delete a webhook subscription
      */
-    private extractAvailableFields;
+    deleteWebhook(webhookId: string): Promise<ApiResponse<void>>;
     /**
-     * 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 all event triggers
      */
-    getAvailableFields(sampleData: Record<string, unknown>): string[];
+    getEventTriggers(): Promise<ApiResponse<EventTrigger[]>>;
     /**
-     * Create a simple email trigger
-     * Helper method for common use case
+     * Create a new event trigger
      */
-    createEmailTrigger(config: {
-        name: string;
-        eventType: TriggerEventType;
-        to: string;
-        subject: string;
-        body: string;
-        conditions?: TriggerCondition[];
-    }): Promise<ApiResponse<EventTrigger>>;
+    createEventTrigger(trigger: Partial<EventTrigger>): Promise<ApiResponse<EventTrigger>>;
     /**
-     * Create a task creation trigger
+     * Update an event trigger
      */
-    createTaskTrigger(config: {
-        name: string;
-        eventType: TriggerEventType;
-        taskTitle: string;
-        taskDescription?: string;
-        priority?: 'low' | 'medium' | 'high' | 'urgent';
-        dueDays?: number;
-        conditions?: TriggerCondition[];
-    }): Promise<ApiResponse<EventTrigger>>;
+    updateEventTrigger(triggerId: string, updates: Partial<EventTrigger>): Promise<ApiResponse<EventTrigger>>;
     /**
-     * Create a webhook trigger
+     * Delete an event trigger
      */
-    createWebhookTrigger(config: {
-        name: string;
-        eventType: TriggerEventType;
-        webhookUrl: string;
-        method?: 'POST' | 'PUT' | 'PATCH';
-        conditions?: TriggerCondition[];
-    }): Promise<ApiResponse<EventTrigger>>;
+    deleteEventTrigger(triggerId: string): Promise<ApiResponse<void>>;
+}
+
+/**
+ * Clianta SDK - Type Definitions
+ * @see SDK_VERSION in core/config.ts
+ */
+interface CliantaConfig {
+    /** Project ID (required for config file pattern) */
+    projectId?: string;
+    /** Backend API endpoint URL */
+    apiEndpoint?: string;
+    /** Auth token for server-side API access (user JWT) */
+    authToken?: string;
+    /** Workspace API key for server-to-server access (use instead of authToken for external apps) */
+    apiKey?: string;
+    /** Enable debug mode with verbose logging */
+    debug?: boolean;
+    /** Automatically track page views on load and navigation */
+    autoPageView?: boolean;
+    /** Plugins to enable (default: all core plugins) */
+    plugins?: PluginName[];
+    /** Session timeout in milliseconds (default: 30 minutes) */
+    sessionTimeout?: number;
+    /** Maximum events to batch before sending (default: 10) */
+    batchSize?: number;
+    /** Interval to flush events in milliseconds (default: 5000) */
+    flushInterval?: number;
+    /** Consent configuration */
+    consent?: ConsentConfig;
+    /** Cookie domain for cross-subdomain tracking */
+    cookieDomain?: string;
+    /** Use cookies instead of localStorage for visitor ID */
+    useCookies?: boolean;
+    /** Cookie-less mode: use sessionStorage only (no persistent storage) */
+    cookielessMode?: boolean;
+    /** Queue persistence mode: 'session' (default), 'local' (survives browser restart), 'none' */
+    persistMode?: 'session' | 'local' | 'none';
+}
+type PluginName = 'pageView' | 'forms' | 'scroll' | 'clicks' | 'engagement' | 'downloads' | 'exitIntent' | 'errors' | 'performance' | 'popupForms';
+interface ConsentConfig {
+    /** Default consent state before user action */
+    defaultConsent?: ConsentState;
+    /** Wait for consent before tracking anything */
+    waitForConsent?: boolean;
+    /** Storage key for consent state */
+    storageKey?: string;
+    /** Anonymous mode: track without visitor ID until explicit consent */
+    anonymousMode?: boolean;
+}
+interface ConsentState {
+    /** Consent for analytics/essential tracking */
+    analytics?: boolean;
+    /** Consent for marketing/advertising tracking */
+    marketing?: boolean;
+    /** Consent for personalization */
+    personalization?: boolean;
+}
+type EventType = 'page_view' | 'button_click' | 'form_view' | 'form_submit' | 'form_interaction' | 'scroll_depth' | 'engagement' | 'download' | 'exit_intent' | 'error' | 'performance' | 'time_on_page' | 'custom';
+interface TrackingEvent {
+    /** Workspace/project ID */
+    workspaceId: string;
+    /** Anonymous visitor identifier */
+    visitorId: string;
+    /** Session identifier */
+    sessionId: string;
+    /** Event type category */
+    eventType: EventType;
+    /** Human-readable event name */
+    eventName: string;
+    /** Current page URL */
+    url: string;
+    /** Referrer URL */
+    referrer?: string;
+    /** Event properties/metadata */
+    properties: Record<string, unknown>;
+    /** Device information */
+    device: DeviceInfo;
+    /** UTM parameters */
+    utm?: UTMParams;
+    /** ISO timestamp */
+    timestamp: string;
+    /** SDK version */
+    sdkVersion: string;
+}
+interface DeviceInfo {
+    userAgent: string;
+    screen: string;
+    language: string;
+    timezone?: string;
+}
+interface UTMParams {
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    utmTerm?: string;
+    utmContent?: string;
+}
+interface UserTraits {
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+    phone?: string;
+    title?: string;
+    [key: string]: unknown;
+}
+interface Plugin {
+    /** Unique plugin name */
+    name: PluginName;
+    /** Initialize the plugin (can be sync or async) */
+    init(tracker: TrackerCore): void | Promise<void>;
+    /** Cleanup when plugin is disabled */
+    destroy?(): void;
+}
+interface TrackerCore {
+    /** Track a custom event */
+    track(eventType: EventType | string, eventName: string, properties?: Record<string, unknown>): void;
+    /** Identify a visitor — returns the contactId if successful */
+    identify(email: string, traits?: UserTraits): Promise<string | null>;
+    /** Track a page view */
+    page(name?: string, properties?: Record<string, unknown>): void;
+    /** Update consent state */
+    consent(state: ConsentState): void;
+    /** Toggle debug mode */
+    debug(enabled: boolean): void;
+    /** Get visitor ID */
+    getVisitorId(): string;
+    /** Get session ID */
+    getSessionId(): string;
+    /** Force flush event queue */
+    flush(): Promise<void>;
+    /** Reset visitor (for logout) */
+    reset(): void;
+    /** Get current configuration */
+    getConfig(): CliantaConfig;
+    /** Get workspace ID */
+    getWorkspaceId(): string;
+    /** Delete all stored user data (GDPR right-to-erasure) */
+    deleteData(): void;
+    /** Get current consent state */
+    getConsentState(): ConsentState;
+    /** Get the current visitor's profile from the CRM */
+    getVisitorProfile(): Promise<VisitorProfile | null>;
+    /** Get the current visitor's recent activity */
+    getVisitorActivity(options?: VisitorActivityOptions): Promise<{
+        data: VisitorActivity[];
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            pages: number;
+        };
+    } | null>;
+    /** Get a summarized journey timeline for the current visitor */
+    getVisitorTimeline(): Promise<VisitorTimeline | null>;
+    /** Get engagement metrics for the current visitor */
+    getVisitorEngagement(): Promise<EngagementMetrics | null>;
+    /** Send a server-side inbound event (requires apiKey in config) */
+    sendEvent(payload: InboundEventPayload): Promise<InboundEventResult>;
+}
+interface Contact {
+    _id?: string;
+    workspaceId: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+    jobTitle?: string;
+    phone?: string;
+    status?: 'lead' | 'contact' | 'customer';
+    lifecycleStage?: 'subscriber' | 'lead' | 'mql' | 'sql' | 'opportunity' | 'customer' | 'evangelist';
+    source?: string;
+    tags?: string[];
+    leadScore?: number;
+    customFields?: Record<string, unknown>;
+    companyId?: string;
+    assignedTo?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface Company {
+    _id?: string;
+    workspaceId: string;
+    name: string;
+    industry?: string;
+    website?: string;
+    phone?: string;
+    address?: {
+        street?: string;
+        city?: string;
+        state?: string;
+        country?: string;
+        postalCode?: string;
+    };
+    companySize?: string;
+    annualRevenue?: number;
+    status?: 'prospect' | 'active' | 'inactive' | 'churned';
+    accountTier?: 'enterprise' | 'mid-market' | 'smb';
+    isTargetAccount?: boolean;
+    tags?: string[];
+    customFields?: Record<string, unknown>;
+    assignedTo?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface Pipeline {
+    _id?: string;
+    workspaceId: string;
+    name: string;
+    description?: string;
+    stages: PipelineStage[];
+    isDefault?: boolean;
+    isActive?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
 }
-
-/**
- * Clianta SDK - CRM API Client
- * @see SDK_VERSION in core/config.ts
- */
-
-/**
- * CRM API Client for managing contacts and opportunities
- */
-declare class CRMClient {
-    private apiEndpoint;
-    private workspaceId;
-    private authToken?;
-    triggers: EventTriggersManager;
-    constructor(apiEndpoint: string, workspaceId: string, authToken?: string);
-    /**
-     * Set authentication token for API requests
-     */
-    setAuthToken(token: string): void;
-    /**
-     * Validate required parameter exists
-     * @throws {Error} if value is null/undefined or empty string
-     */
-    private validateRequired;
-    /**
-     * Make authenticated API request
-     */
-    private request;
-    /**
-     * Get all contacts with pagination
-     */
-    getContacts(params?: {
-        page?: number;
-        limit?: number;
-        search?: string;
-        status?: string;
-    }): Promise<ApiResponse<PaginatedResponse<Contact>>>;
-    /**
-     * Get a single contact by ID
-     */
-    getContact(contactId: string): Promise<ApiResponse<Contact>>;
-    /**
-     * Create a new contact
-     */
-    createContact(contact: Partial<Contact>): Promise<ApiResponse<Contact>>;
-    /**
-     * Update an existing contact
-     */
-    updateContact(contactId: string, updates: Partial<Contact>): Promise<ApiResponse<Contact>>;
-    /**
-     * Delete a contact
-     */
-    deleteContact(contactId: string): Promise<ApiResponse<void>>;
-    /**
-     * Get all opportunities with pagination
-     */
-    getOpportunities(params?: {
-        page?: number;
-        limit?: number;
-        pipelineId?: string;
-        stageId?: string;
-    }): Promise<ApiResponse<PaginatedResponse<Opportunity>>>;
-    /**
-     * Get a single opportunity by ID
-     */
-    getOpportunity(opportunityId: string): Promise<ApiResponse<Opportunity>>;
-    /**
-     * Create a new opportunity
-     */
-    createOpportunity(opportunity: Partial<Opportunity>): Promise<ApiResponse<Opportunity>>;
-    /**
-     * Update an existing opportunity
-     */
-    updateOpportunity(opportunityId: string, updates: Partial<Opportunity>): Promise<ApiResponse<Opportunity>>;
-    /**
-     * Delete an opportunity
-     */
-    deleteOpportunity(opportunityId: string): Promise<ApiResponse<void>>;
-    /**
-     * Move opportunity to a different stage
-     */
-    moveOpportunity(opportunityId: string, stageId: string): Promise<ApiResponse<Opportunity>>;
-    /**
-     * Get all companies with pagination
-     */
-    getCompanies(params?: {
-        page?: number;
-        limit?: number;
-        search?: string;
-        status?: string;
-        industry?: string;
-    }): Promise<ApiResponse<PaginatedResponse<Company>>>;
-    /**
-     * Get a single company by ID
-     */
-    getCompany(companyId: string): Promise<ApiResponse<Company>>;
-    /**
-     * Create a new company
-     */
-    createCompany(company: Partial<Company>): Promise<ApiResponse<Company>>;
-    /**
-     * Update an existing company
-     */
-    updateCompany(companyId: string, updates: Partial<Company>): Promise<ApiResponse<Company>>;
-    /**
-     * Delete a company
-     */
-    deleteCompany(companyId: string): Promise<ApiResponse<void>>;
-    /**
-     * Get contacts belonging to a company
-     */
-    getCompanyContacts(companyId: string, params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<ApiResponse<PaginatedResponse<Contact>>>;
-    /**
-     * Get deals/opportunities belonging to a company
-     */
-    getCompanyDeals(companyId: string, params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<ApiResponse<PaginatedResponse<Opportunity>>>;
-    /**
-     * Get all pipelines
-     */
-    getPipelines(): Promise<ApiResponse<Pipeline[]>>;
-    /**
-     * Get a single pipeline by ID
-     */
-    getPipeline(pipelineId: string): Promise<ApiResponse<Pipeline>>;
+interface PipelineStage {
+    _id?: string;
+    name: string;
+    order: number;
+    probability?: number;
+    color?: string;
+    rottenDays?: number;
+}
+interface Task {
+    _id?: string;
+    workspaceId: string;
+    title: string;
+    description?: string;
+    status?: 'pending' | 'in_progress' | 'completed' | 'cancelled';
+    priority?: 'low' | 'medium' | 'high' | 'urgent';
+    dueDate?: string;
+    reminderDate?: string;
+    completedAt?: string;
+    tags?: string[];
+    relatedContactId?: string;
+    relatedCompanyId?: string;
+    relatedOpportunityId?: string;
+    assignedTo?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface Activity {
+    _id?: string;
+    workspaceId: string;
+    type: 'call' | 'email' | 'meeting' | 'note' | 'task' | 'other';
+    title: string;
+    description?: string;
+    direction?: 'inbound' | 'outbound';
+    duration?: number;
+    outcome?: string;
+    emailSubject?: string;
+    emailBody?: string;
+    metadata?: Record<string, unknown>;
+    contactId?: string;
+    companyId?: string;
+    opportunityId?: string;
+    userId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface Opportunity {
+    _id?: string;
+    workspaceId: string;
+    contactId: string;
+    companyId?: string;
+    pipelineId: string;
+    stageId: string;
+    title: string;
+    value?: number;
+    currency?: string;
+    probability?: number;
+    expectedCloseDate?: string;
+    status?: 'open' | 'won' | 'lost';
+    priority?: 'low' | 'medium' | 'high';
+    lostReason?: string;
+    customFields?: Record<string, unknown>;
+    assignedTo?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    status: number;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        pages: number;
+    };
+}
+type TriggerEventType = 'contact.created' | 'contact.updated' | 'contact.deleted' | 'opportunity.created' | 'opportunity.updated' | 'opportunity.stage_changed' | 'opportunity.won' | 'opportunity.lost' | 'task.created' | 'task.completed' | 'task.overdue' | 'activity.logged' | 'form.submitted';
+interface TriggerCondition {
     /**
-     * Create a new pipeline
+     * Field to check - supports dynamic field names including custom fields
+     * Examples: 'status', 'lifecycleStage', 'leadScore', 'customFields.industry'
+     * Use dot notation for nested fields: 'contact.email', 'customFields.accountType'
      */
-    createPipeline(pipeline: Partial<Pipeline>): Promise<ApiResponse<Pipeline>>;
+    field: string;
+    /** Operator for comparison */
+    operator: 'equals' | 'not_equals' | 'contains' | 'greater_than' | 'less_than' | 'in' | 'not_in';
+    /** Value to compare against */
+    value: unknown;
+}
+interface EmailTemplate {
+    /** Template ID */
+    _id?: string;
+    /** Template name */
+    name: string;
+    /** Email subject line (supports variables) */
+    subject: string;
+    /** Email body (supports HTML and variables) */
+    body: string;
+    /** Variables available in this template */
+    variables?: string[];
+    /** Sender email address */
+    fromEmail?: string;
+    /** Sender name */
+    fromName?: string;
+}
+interface EmailAction {
+    /** Action type identifier */
+    type: 'send_email';
+    /** Email template ID or inline template */
+    templateId?: string;
+    /** Inline email subject (if not using template) */
+    subject?: string;
+    /** Inline email body (if not using template) */
+    body?: string;
+    /** Recipient email (supports variables like {{contact.email}}) */
+    to: string;
+    /** CC recipients */
+    cc?: string[];
+    /** BCC recipients */
+    bcc?: string[];
+    /** Sender email */
+    from?: string;
+    /** Delay in minutes before sending */
+    delayMinutes?: number;
+}
+interface WebhookAction {
+    /** Action type identifier */
+    type: 'webhook';
+    /** Webhook URL to call */
+    url: string;
+    /** HTTP method */
+    method: 'POST' | 'PUT' | 'PATCH';
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Request body template (supports variables) */
+    body?: string;
+}
+interface TaskAction {
+    /** Action type identifier */
+    type: 'create_task';
+    /** Task title (supports variables) */
+    title: string;
+    /** Task description */
+    description?: string;
+    /** Task priority */
+    priority?: 'low' | 'medium' | 'high' | 'urgent';
+    /** Due date in days from trigger */
+    dueDays?: number;
+    /** Assign to user ID */
+    assignedTo?: string;
+}
+interface ContactUpdateAction {
+    /** Action type identifier */
+    type: 'update_contact';
+    /** Fields to update */
+    updates: Partial<Contact>;
+}
+type TriggerAction = EmailAction | WebhookAction | TaskAction | ContactUpdateAction;
+interface EventTrigger {
+    /** Trigger ID */
+    _id?: string;
+    /** Workspace ID */
+    workspaceId: string;
+    /** Trigger name */
+    name: string;
+    /** Description of what this trigger does */
+    description?: string;
+    /** Event type that activates this trigger */
+    eventType: TriggerEventType;
+    /** Conditions that must be met for trigger to fire */
+    conditions?: TriggerCondition[];
+    /** Actions to execute when trigger fires */
+    actions: TriggerAction[];
+    /** Whether this trigger is active */
+    isActive?: boolean;
+    /** Created timestamp */
+    createdAt?: string;
+    /** Updated timestamp */
+    updatedAt?: string;
+}
+interface TriggerExecution {
+    /** Execution ID */
+    _id?: string;
+    /** Trigger ID that was executed */
+    triggerId: string;
+    /** Event that triggered the execution */
+    eventType: TriggerEventType;
+    /** Entity ID that triggered the event */
+    entityId: string;
+    /** Execution status */
+    status: 'pending' | 'success' | 'failed';
+    /** Error message if failed */
+    error?: string;
+    /** Actions executed */
+    actionsExecuted: number;
+    /** Execution timestamp */
+    executedAt: string;
+}
+interface VisitorProfile {
+    visitorId: string;
+    contactId?: string;
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+    jobTitle?: string;
+    phone?: string;
+    status?: string;
+    lifecycleStage?: string;
+    tags?: string[];
+    leadScore?: number;
+    firstSeen?: string;
+    lastSeen?: string;
+    sessionCount?: number;
+    pageViewCount?: number;
+    totalTimeSpent?: number;
+    customFields?: Record<string, unknown>;
+}
+interface VisitorActivity {
+    _id?: string;
+    eventType: string;
+    eventName: string;
+    url: string;
+    properties?: Record<string, unknown>;
+    timestamp: string;
+}
+interface VisitorTimeline {
+    visitorId: string;
+    contactId?: string;
+    firstSeen: string;
+    lastSeen: string;
+    totalSessions: number;
+    totalPageViews: number;
+    totalEvents: number;
+    totalTimeSpentSeconds: number;
+    averageSessionDurationSeconds: number;
+    topPages: Array<{
+        url: string;
+        views: number;
+        avgTimeSeconds?: number;
+    }>;
+    recentActivities: VisitorActivity[];
+    devices: Array<{
+        userAgent: string;
+        lastSeen: string;
+    }>;
+}
+interface EngagementMetrics {
+    visitorId: string;
+    totalTimeOnSiteSeconds: number;
+    averageSessionDurationSeconds: number;
+    totalPageViews: number;
+    totalSessions: number;
+    engagementScore: number;
+    bounceRate: number;
+    lastActiveAt: string;
+    topEvents: Array<{
+        eventType: string;
+        count: number;
+    }>;
+}
+interface VisitorActivityOptions {
+    page?: number;
+    limit?: number;
+    eventType?: string;
+    startDate?: string;
+    endDate?: string;
+}
+interface ContactTimelineOptions {
+    page?: number;
+    limit?: number;
+    includeEvents?: boolean;
+    includeActivities?: boolean;
+    includeOpportunities?: boolean;
+}
+
+/**
+ * Main Clianta Tracker Class
+ */
+declare class Tracker implements TrackerCore {
+    private workspaceId;
+    private config;
+    private transport;
+    private queue;
+    private plugins;
+    private visitorId;
+    private sessionId;
+    private isInitialized;
+    private consentManager;
+    /** contactId after a successful identify() call */
+    private contactId;
+    /** Pending identify retry on next flush */
+    private pendingIdentify;
+    /** Registered event schemas for validation */
+    private eventSchemas;
+    constructor(workspaceId: string, userConfig?: CliantaConfig);
     /**
-     * Update an existing pipeline
+     * Create visitor ID based on storage mode
      */
-    updatePipeline(pipelineId: string, updates: Partial<Pipeline>): Promise<ApiResponse<Pipeline>>;
+    private createVisitorId;
     /**
-     * Delete a pipeline
+     * Create session ID
      */
-    deletePipeline(pipelineId: string): Promise<ApiResponse<void>>;
+    private createSessionId;
     /**
-     * Get all tasks with pagination
+     * Handle consent state changes
      */
-    getTasks(params?: {
-        page?: number;
-        limit?: number;
-        status?: string;
-        priority?: string;
-        contactId?: string;
-        companyId?: string;
-        opportunityId?: string;
-    }): Promise<ApiResponse<PaginatedResponse<Task>>>;
+    private onConsentChange;
     /**
-     * Get a single task by ID
+     * Initialize enabled plugins
+     * Handles both sync and async plugin init methods
      */
-    getTask(taskId: string): Promise<ApiResponse<Task>>;
+    private initPlugins;
     /**
-     * Create a new task
+     * Track a custom event
      */
-    createTask(task: Partial<Task>): Promise<ApiResponse<Task>>;
+    track(eventType: EventType | string, eventName: string, properties?: Record<string, unknown>): void;
     /**
-     * Update an existing task
+     * Track a page view
      */
-    updateTask(taskId: string, updates: Partial<Task>): Promise<ApiResponse<Task>>;
+    page(name?: string, properties?: Record<string, unknown>): void;
     /**
-     * Mark a task as completed
+     * Identify a visitor.
+     * Links the anonymous visitorId to a CRM contact and returns the contactId.
+     * All subsequent track() calls will include the contactId automatically.
      */
-    completeTask(taskId: string): Promise<ApiResponse<Task>>;
+    identify(email: string, traits?: UserTraits): Promise<string | null>;
     /**
-     * Delete a task
+     * Send a server-side inbound event via the API key endpoint.
+     * Convenience proxy to CRMClient.sendEvent() — requires apiKey in config.
      */
-    deleteTask(taskId: string): Promise<ApiResponse<void>>;
+    sendEvent(payload: InboundEventPayload): Promise<InboundEventResult>;
     /**
-     * Get activities for a contact
+     * 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).
      */
-    getContactActivities(contactId: string, params?: {
-        page?: number;
-        limit?: number;
-        type?: string;
-    }): Promise<ApiResponse<PaginatedResponse<Activity>>>;
+    getVisitorProfile(): Promise<VisitorProfile | null>;
     /**
-     * Get activities for an opportunity/deal
+     * Get the current visitor's recent activity/events.
+     * Returns paginated list of tracking events for this visitor.
      */
-    getOpportunityActivities(opportunityId: string, params?: {
-        page?: number;
-        limit?: number;
-        type?: string;
-    }): Promise<ApiResponse<PaginatedResponse<Activity>>>;
+    getVisitorActivity(options?: VisitorActivityOptions): Promise<{
+        data: VisitorActivity[];
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            pages: number;
+        };
+    } | null>;
     /**
-     * Create a new activity
+     * Get a summarized journey timeline for the current visitor.
+     * Includes top pages, sessions, time spent, and recent activities.
      */
-    createActivity(activity: Partial<Activity>): Promise<ApiResponse<Activity>>;
+    getVisitorTimeline(): Promise<VisitorTimeline | null>;
     /**
-     * Update an existing activity
+     * Get engagement metrics for the current visitor.
+     * Includes time on site, page views, bounce rate, and engagement score.
      */
-    updateActivity(activityId: string, updates: Partial<Activity>): Promise<ApiResponse<Activity>>;
+    getVisitorEngagement(): Promise<EngagementMetrics | null>;
     /**
-     * Delete an activity
+     * Retry pending identify call
      */
-    deleteActivity(activityId: string): Promise<ApiResponse<void>>;
+    private retryPendingIdentify;
     /**
-     * Log a call activity
+     * Update consent state
      */
-    logCall(data: {
-        contactId?: string;
-        opportunityId?: string;
-        direction: 'inbound' | 'outbound';
-        duration?: number;
-        outcome?: string;
-        notes?: string;
-    }): Promise<ApiResponse<Activity>>;
+    consent(state: ConsentState): void;
     /**
-     * Log a meeting activity
+     * Get current consent state
      */
-    logMeeting(data: {
-        contactId?: string;
-        opportunityId?: string;
-        title: string;
-        duration?: number;
-        outcome?: string;
-        notes?: string;
-    }): Promise<ApiResponse<Activity>>;
+    getConsentState(): ConsentState;
     /**
-     * Add a note to a contact or opportunity
+     * Toggle debug mode
      */
-    addNote(data: {
-        contactId?: string;
-        opportunityId?: string;
-        content: string;
-    }): Promise<ApiResponse<Activity>>;
+    debug(enabled: boolean): void;
     /**
-     * Get all email templates
+     * 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',
+     * });
      */
-    getEmailTemplates(params?: {
-        page?: number;
-        limit?: number;
-    }): Promise<ApiResponse<PaginatedResponse<EmailTemplate>>>;
+    registerEventSchema(eventType: string, schema: Record<string, 'string' | 'number' | 'boolean' | 'object' | 'array'>): void;
     /**
-     * Get a single email template by ID
+     * Validate event properties against a registered schema (debug mode only)
      */
-    getEmailTemplate(templateId: string): Promise<ApiResponse<EmailTemplate>>;
+    private validateEventSchema;
     /**
-     * Create a new email template
+     * Get visitor ID
      */
-    createEmailTemplate(template: Partial<EmailTemplate>): Promise<ApiResponse<EmailTemplate>>;
+    getVisitorId(): string;
     /**
-     * Update an email template
+     * Get session ID
      */
-    updateEmailTemplate(templateId: string, updates: Partial<EmailTemplate>): Promise<ApiResponse<EmailTemplate>>;
+    getSessionId(): string;
     /**
-     * Delete an email template
+     * Get workspace ID
      */
-    deleteEmailTemplate(templateId: string): Promise<ApiResponse<void>>;
+    getWorkspaceId(): string;
     /**
-     * Send an email using a template
+     * Get current configuration
      */
-    sendEmail(data: {
-        to: string;
-        templateId?: string;
-        subject?: string;
-        body?: string;
-        cc?: string[];
-        bcc?: string[];
-        variables?: Record<string, unknown>;
-        contactId?: string;
-    }): Promise<ApiResponse<{
-        messageId: string;
-    }>>;
+    getConfig(): CliantaConfig;
     /**
-     * Get all event triggers
+     * Force flush event queue
      */
-    getEventTriggers(): Promise<ApiResponse<EventTrigger[]>>;
+    flush(): Promise<void>;
     /**
-     * Create a new event trigger
+     * Reset visitor and session (for logout)
      */
-    createEventTrigger(trigger: Partial<EventTrigger>): Promise<ApiResponse<EventTrigger>>;
+    reset(): void;
     /**
-     * Update an event trigger
+     * Delete all stored user data (GDPR right-to-erasure)
      */
-    updateEventTrigger(triggerId: string, updates: Partial<EventTrigger>): Promise<ApiResponse<EventTrigger>>;
+    deleteData(): void;
     /**
-     * Delete an event trigger
+     * Destroy tracker and cleanup
      */
-    deleteEventTrigger(triggerId: string): Promise<ApiResponse<void>>;
+    destroy(): Promise<void>;
 }
 
 /**
@@ -1038,7 +1315,7 @@ interface StoredConsent {
  */
 
 /** SDK Version */
-declare const SDK_VERSION = "1.3.0";
+declare const SDK_VERSION = "1.4.0";
 
 /**
  * Clianta SDK
@@ -1073,4 +1350,4 @@ declare const SDK_VERSION = "1.3.0";
 declare function clianta(workspaceId: string, config?: CliantaConfig): TrackerCore;
 
 export { CRMClient, ConsentManager, EventTriggersManager, SDK_VERSION, Tracker, clianta, clianta as default };
-export type { Activity, ApiResponse, CliantaConfig, Company, ConsentChangeCallback, ConsentConfig, ConsentManagerConfig, ConsentState, Contact, ContactUpdateAction, EmailAction, EmailTemplate, EventTrigger, EventType, Opportunity, PaginatedResponse, Pipeline, PipelineStage, Plugin, PluginName, StoredConsent, Task, TaskAction, TrackerCore, TrackingEvent, TriggerAction, TriggerCondition, TriggerEventType, TriggerExecution, UserTraits, WebhookAction };
+export type { Activity, ApiResponse, CliantaConfig, Company, ConsentChangeCallback, ConsentConfig, ConsentManagerConfig, ConsentState, Contact, ContactTimelineOptions, ContactUpdateAction, EmailAction, EmailTemplate, EngagementMetrics, EventTrigger, EventType, InboundEventPayload, InboundEventResult, InboundEventType, Opportunity, PaginatedResponse, Pipeline, PipelineStage, Plugin, PluginName, StoredConsent, Task, TaskAction, TrackerCore, TrackingEvent, TriggerAction, TriggerCondition, TriggerEventType, TriggerExecution, UserTraits, VisitorActivity, VisitorActivityOptions, VisitorProfile, VisitorTimeline, WebhookAction };