@clianta/sdk 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -5,6 +5,39 @@ All notable changes to the Clianta SDK will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] - 2026-02-27
+
+### Fixed
+- **CRITICAL: contactId propagation** - `identify()` now stores the returned `contactId` and attaches it to every subsequent `track()` call. Previously, all events remained anonymous after identification.
+- **CRITICAL: identify() return type** - `identify()` now returns `Promise<string | null>` (the contactId) instead of `Promise<void>`, so callers can use the contactId immediately.
+- **Transport: contactId extraction** - `sendIdentify()` now parses the server response body and returns `contactId` in `TransportResult`.
+- **Event deduplication** - Every tracked event now includes a unique `eventId` UUID in properties. Prevents duplicate events when events are retried after network timeouts or restored from localStorage on page reload.
+
+### Added
+- **`sendEvent()` method on Tracker** - Convenience proxy to `CRMClient.sendEvent()` for server-side inbound events. Requires `apiKey` in the SDK config. No need to instantiate a separate `CRMClient`.
+- **`contactId` field on TransportResult** - TypeScript type updated.
+- **`sendEvent()` on TrackerCore interface** - Full TypeScript support.
+
+### Changed
+- `TrackerCore.identify()` signature: `Promise<void>` → `Promise<string | null>`
+
+## [1.3.0] - 2026-02-17
+
+### Added
+- **ContactUpdateAction Type** - New trigger action type for automatically updating contact fields when triggers fire
+  - Supports partial contact updates via `updates: Partial<Contact>`
+- **TriggerExecution Interface** - Full execution tracking for event triggers
+  - Fields: `triggerId`, `eventType`, `entityId`, `status`, `error`, `actionsExecuted`, `executedAt`
+  - Status tracking: `pending`, `success`, `failed`
+- **deleteEventTrigger()** - New CRM client method to delete event triggers by ID
+  - `crm.deleteEventTrigger(triggerId)` - removes a trigger from the workspace
+- **Vue Type Augmentation** - Added `ComponentCustomProperties` declaration for `$clianta` global property
+  - Enables type-safe access to tracker via Options API in Vue components
+- **Export: ContactUpdateAction** - Now exported from main SDK entry point
+
+### Changed
+- `TriggerAction` union type now includes `ContactUpdateAction` alongside `EmailAction`, `WebhookAction`, and `TaskAction`
+
 ## [1.2.0] - 2026-02-02
 
 ### Added

package/README.md

@@ -1,6 +1,15 @@
 # Clianta SDK
 
-Professional CRM and tracking SDK for lead generation. Works with any website or JavaScript framework.
+Professional CRM and tracking SDK for lead generation with **automated email triggers** and workflows. Works with any website or JavaScript framework.
+
+## ✨ Key Features
+
+- 📊 **Visitor & Event Tracking** - Track page views, clicks, forms, and custom events
+- 👥 **CRM Management** - Contacts, companies, opportunities, tasks, and activities
+- 🤖 **Event Triggers & Automation** - Automated emails, tasks, and webhooks (like Salesforce & HubSpot)
+- 📧 **Email Notifications** - Send automated emails based on CRM actions
+- 🔒 **GDPR Compliant** - Built-in consent management
+- ⚡ **Framework Agnostic** - Works with React, Vue, Next.js, or vanilla JavaScript
 
 ## Installation
 
@@ -431,6 +440,67 @@ import {
 
 ---
 
+## Event Triggers & Automation
+
+Automate your workflows with event-driven triggers. Send emails, create tasks, or call webhooks when specific actions occur.
+
+### Quick Example
+
+```typescript
+import { CRMClient } from '@clianta/sdk';
+
+const crm = new CRMClient(
+  'https://api.clianta.online',
+  'your-workspace-id',
+  'your-auth-token'
+);
+
+// Send welcome email when a contact is created
+await crm.createEventTrigger({
+  name: 'Welcome Email',
+  eventType: 'contact.created',
+  actions: [
+    {
+      type: 'send_email',
+      to: '{{contact.email}}',
+      subject: 'Welcome to Our Platform!',
+      body: 'Hello {{contact.firstName}}, welcome aboard!',
+    }
+  ],
+  isActive: true,
+});
+
+// Create task when high-value opportunity is created
+await crm.triggers.createTaskTrigger({
+  name: 'Follow-up Task',
+  eventType: 'opportunity.created',
+  taskTitle: 'Call {{contact.firstName}} about {{opportunity.title}}',
+  priority: 'high',
+  dueDays: 1,
+  conditions: [
+    { field: 'value', operator: 'greater_than', value: 10000 }
+  ],
+});
+```
+
+### Supported Event Types
+
+- **Contact Events**: `contact.created`, `contact.updated`, `contact.deleted`
+- **Opportunity Events**: `opportunity.created`, `opportunity.won`, `opportunity.stage_changed`
+- **Task Events**: `task.created`, `task.completed`, `task.overdue`
+- **Activity Events**: `activity.logged`, `form.submitted`
+
+### Action Types
+
+1. **Send Email** - Automated email notifications with template variables
+2. **Create Task** - Auto-create follow-up tasks
+3. **Webhook** - Call external services (Slack, Zapier, etc.)
+4. **Update Contact** - Automatically update contact fields
+
+📚 **[Full Event Triggers Documentation](./docs/EVENT_TRIGGERS.md)**
+
+---
+
 ## Self-Hosted
 
 For self-hosted deployments, configure the API endpoint: