@clianta/sdk 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.5.1] - 2026-02-28
+
+### Added
+- **Public CRM API** — Frontend-safe CRM methods that don't require an API key (secured by domain whitelist):
+  - `createContact()` — Create or upsert a contact by email
+  - `updateContact()` — Update an existing contact by ID
+  - `submitForm()` — Submit a form and auto-create/update contact
+  - `logActivity()` — Append an activity to a contact
+  - `createOpportunity()` — Create an opportunity (e.g., from "Request Demo" forms)
+- **Public CRM types** — `PublicContactData`, `PublicContactUpdate`, `PublicFormSubmission`, `PublicActivityData`, `PublicOpportunityData`, `PublicCrmResult`
+- **Updated docs** — API Reference and Getting Started guides updated with public CRM usage
+
+### Changed
+- Config: improved `getDefaultApiEndpoint()` with env variable support
+- Framework integrations: minor fixes for Angular, Svelte, Vue, React
+
 ## [1.5.0] - 2026-02-28
 
 ### Security

package/dist/angular.cjs.js

@@ -1,5 +1,5 @@
 /*!
- * Clianta SDK v1.5.0
+ * Clianta SDK v1.5.1
  * (c) 2026 Clianta
  * Released under the MIT License.
  */
@@ -11,15 +11,22 @@
  */
 /** SDK Version */
 const SDK_VERSION = '1.4.0';
-/** Default API endpoint based on environment */
+/** Default API endpoint — reads from env or falls back to localhost */
 const getDefaultApiEndpoint = () => {
-    if (typeof window === 'undefined')
-        return 'https://api.clianta.online';
-    const hostname = window.location.hostname;
-    if (hostname.includes('localhost') || hostname.includes('127.0.0.1')) {
-        return 'http://localhost:5000';
+    // Build-time env var (works with Next.js, Vite, CRA, etc.)
+    if (typeof process !== 'undefined' && process.env?.NEXT_PUBLIC_CLIANTA_API_ENDPOINT) {
+        return process.env.NEXT_PUBLIC_CLIANTA_API_ENDPOINT;
+    }
+    if (typeof process !== 'undefined' && process.env?.VITE_CLIANTA_API_ENDPOINT) {
+        return process.env.VITE_CLIANTA_API_ENDPOINT;
+    }
+    if (typeof process !== 'undefined' && process.env?.REACT_APP_CLIANTA_API_ENDPOINT) {
+        return process.env.REACT_APP_CLIANTA_API_ENDPOINT;
     }
-    return 'https://api.clianta.online';
+    if (typeof process !== 'undefined' && process.env?.CLIANTA_API_ENDPOINT) {
+        return process.env.CLIANTA_API_ENDPOINT;
+    }
+    return 'http://localhost:5000';
 };
 /** Core plugins enabled by default */
 const DEFAULT_PLUGINS = [
@@ -1781,7 +1788,7 @@ class PopupFormsPlugin extends BasePlugin {
             return;
         const config = this.tracker.getConfig();
         const workspaceId = this.tracker.getWorkspaceId();
-        const apiEndpoint = config.apiEndpoint || 'https://api.clianta.online';
+        const apiEndpoint = config.apiEndpoint || 'http://localhost:5000';
         try {
             const url = encodeURIComponent(window.location.href);
             const response = await fetch(`${apiEndpoint}/api/public/lead-forms/${workspaceId}?url=${url}`);
@@ -1886,7 +1893,7 @@ class PopupFormsPlugin extends BasePlugin {
         if (!this.tracker)
             return;
         const config = this.tracker.getConfig();
-        const apiEndpoint = config.apiEndpoint || 'https://api.clianta.online';
+        const apiEndpoint = config.apiEndpoint || 'http://localhost:5000';
         try {
             await fetch(`${apiEndpoint}/api/public/lead-forms/${formId}/view`, {
                 method: 'POST',
@@ -2133,7 +2140,7 @@ class PopupFormsPlugin extends BasePlugin {
         if (!this.tracker)
             return;
         const config = this.tracker.getConfig();
-        const apiEndpoint = config.apiEndpoint || 'https://api.clianta.online';
+        const apiEndpoint = config.apiEndpoint || 'http://localhost:5000';
         const visitorId = this.tracker.getVisitorId();
         // Collect form data
         const formData = new FormData(formElement);
@@ -3028,7 +3035,7 @@ class CRMClient {
      * The contact is upserted in the CRM and matching workflow automations fire automatically.
      *
      * @example
-     * const crm = new CRMClient('https://api.clianta.online', 'WORKSPACE_ID');
+     * const crm = new CRMClient('http://localhost:5000', 'WORKSPACE_ID');
      * crm.setApiKey('mm_live_...');
      *
      * await crm.sendEvent({
@@ -4168,6 +4175,86 @@ class Tracker {
         this.sessionId = this.createSessionId();
         logger.info('All user data deleted');
     }
+    // ============================================
+    // PUBLIC CRM METHODS (no API key required)
+    // ============================================
+    /**
+     * Create or update a contact by email (upsert).
+     * Secured by domain whitelist — no API key needed.
+     */
+    async createContact(data) {
+        return this.publicCrmRequest('/api/public/crm/contacts', 'POST', {
+            workspaceId: this.workspaceId,
+            ...data,
+        });
+    }
+    /**
+     * Update an existing contact by ID (limited fields only).
+     */
+    async updateContact(contactId, data) {
+        return this.publicCrmRequest(`/api/public/crm/contacts/${contactId}`, 'PUT', {
+            workspaceId: this.workspaceId,
+            ...data,
+        });
+    }
+    /**
+     * Submit a form — creates/updates contact from form data.
+     */
+    async submitForm(formId, data) {
+        const payload = {
+            ...data,
+            metadata: {
+                ...data.metadata,
+                visitorId: this.visitorId,
+                sessionId: this.sessionId,
+                pageUrl: typeof window !== 'undefined' ? window.location.href : undefined,
+                referrer: typeof document !== 'undefined' ? document.referrer || undefined : undefined,
+            },
+        };
+        return this.publicCrmRequest(`/api/public/crm/forms/${formId}/submit`, 'POST', payload);
+    }
+    /**
+     * Log an activity linked to a contact (append-only).
+     */
+    async logActivity(data) {
+        return this.publicCrmRequest('/api/public/crm/activities', 'POST', {
+            workspaceId: this.workspaceId,
+            ...data,
+        });
+    }
+    /**
+     * Create an opportunity (e.g., from "Request Demo" forms).
+     */
+    async createOpportunity(data) {
+        return this.publicCrmRequest('/api/public/crm/opportunities', 'POST', {
+            workspaceId: this.workspaceId,
+            ...data,
+        });
+    }
+    /**
+     * Internal helper for public CRM API calls.
+     */
+    async publicCrmRequest(path, method, body) {
+        const url = `${this.config.apiEndpoint}${path}`;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+            const data = await response.json().catch(() => ({}));
+            if (response.ok) {
+                logger.debug(`Public CRM ${method} ${path} succeeded`);
+                return { success: true, data: data.data ?? data, status: response.status };
+            }
+            logger.error(`Public CRM ${method} ${path} failed (${response.status}):`, data.message);
+            return { success: false, error: data.message, status: response.status };
+        }
+        catch (error) {
+            logger.error(`Public CRM ${method} ${path} error:`, error);
+            return { success: false, error: error.message };
+        }
+    }
     /**
      * Destroy tracker and cleanup
      */
@@ -4292,7 +4379,7 @@ if (typeof window !== 'undefined') {
  * @example
  * const instance = createCliantaTracker({
  *   projectId: 'your-project-id',
- *   apiEndpoint: 'https://api.clianta.online',
+ *   apiEndpoint: environment.cliantaApiEndpoint || 'http://localhost:5000',
  * });
  *
  * instance.tracker?.track('page_view', 'Home Page');