clarity-analytics-sdk 1.0.5 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clarity-analytics-sdk",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "A lightweight JavaScript SDK for tracking events and analytics with Clarity Analytics",
   "main": "src/index.js",
   "scripts": {

package/src/index.js

@@ -20,11 +20,9 @@
         apiUrl: 'https://apps.helo.ai/api/v1/sdk/clarity/events/publish-event',
         fetchUserIdUrl: 'https://apps.helo.ai/api/v1/sdk/clarity/projects?id=',
         projectId: config.projectId,
-        projectName: config.projectName || '',
-        apiKey: config.apiKey || null,
-        userId: null, // Will be fetched from backend
-        systemUserId: null, // Will be fetched from backend API
-        sessionId: config.sessionId || this._generateSessionId(),
+        projectName: null,
+        userId: null, // customer: should come from app
+        systemUserId: null, // Will be fetched from backend API(user who logged in clarity)
         debug: config.debug || false,
         retryAttempts: config.retryAttempts || 3,
         timeout: config.timeout || 10000,
@@ -50,15 +48,20 @@
     async _initialize (config) {
       try {
         // Fetch user ID from backend
-        const { userId, ipaddress } = await this._fetchUserId(this.config.projectId)
-
-        if (!userId) {
+        const { systemUserId, ipaddress, projectName } = await this._fetchUserId(this.config.projectId)
+        if (!systemUserId) {
           throw new Error('Failed to fetch user ID from backend')
         }
 
-        this.config.userId = userId
+        if (!projectName) {
+          throw new Error('Failed to fetch project name from backend111')
+        }
+
         this.config.ipaddress = ipaddress
-        this.config.systemUserId = userId || '' // Set to empty string if not provided
+        this.config.systemUserId = systemUserId // Set to empty string if not provided
+        this.config.projectName = projectName
+        this.config.customerId = this._generateId()
+        this.config.sessionId = this._generateId()
         this._isInitialized = true
 
         // Auto-collect page view if enabled
@@ -111,21 +114,23 @@
         // Extract userId from response (supports multiple response structures)
         let userId = null
         let ipaddress = null
-
+        let projectName = null
         // Check if response has a 'data' wrapper
         if (responseData?.data) {
           userId = responseData?.data?.userId
           ipaddress = responseData?.data?.ipaddress
+          projectName = responseData?.data?.projectName
         } else {
           userId = responseData?.userId
           ipaddress = responseData?.ipaddress
+          projectName = responseData?.projectName
         }
 
         if (!userId) {
           throw new Error('User ID not found in API response')
         }
 
-        return { userId, ipaddress }
+        return { systemUserId: userId, ipaddress, projectName }
       } catch (error) {
         clearTimeout(timeoutId)
         throw error
@@ -156,16 +161,54 @@
         throw new Error('Event name is required')
       }
 
+      // Validate event name length
+      if (typeof eventName !== 'string') {
+        throw new Error('Event name must be a string')
+      }
+
+      const eventNameLength = eventName.trim().length
+      if (eventNameLength < 4 || eventNameLength > 50) {
+        throw new Error('Event name must be between 5 and 50 characters')
+      }
+
+      // Validate properties is an object
+      if (properties !== null && (typeof properties !== 'object' || Array.isArray(properties))) {
+        throw new Error('Properties must be an object')
+      }
+
+      // Validate properties size (max 16KB)
+      if (properties && typeof properties === 'object') {
+        const propertiesJson = JSON.stringify(properties)
+        let propertiesSize
+
+        // Calculate size in bytes (works in both browser and Node.js)
+        if (typeof Blob !== 'undefined') {
+          propertiesSize = new Blob([propertiesJson]).size
+        } else if (typeof TextEncoder !== 'undefined') {
+          propertiesSize = new TextEncoder().encode(propertiesJson).length
+        } else if (typeof Buffer !== 'undefined') {
+          propertiesSize = Buffer.byteLength(propertiesJson, 'utf8')
+        } else {
+          // Fallback: approximate size using string length (UTF-8)
+          propertiesSize = propertiesJson.length
+        }
+
+        const maxSize = 16 * 1024 // 16KB in bytes
+        if (propertiesSize > maxSize) {
+          throw new Error(`Properties object size (${propertiesSize} bytes) exceeds maximum allowed size of 16KB`)
+        }
+      }
+
       const eventData = this._buildEventPayload({
         eventType: options.eventType || 'custom',
         eventName,
         eventKey: options.eventKey || this._sanitizeEventName(eventName),
         properties,
-        sessionId: properties.sessionId || options.sessionId,
+        sessionId: properties.sessionId || options.sessionId || this.config.sessionId,
         context: options.context || {},
         traits: options.traits || {},
-        ipaddress: options.ipaddress || this.config.ipaddress,
-        customId: properties.userId || options.userId
+        ipaddress:  properties.ipaddress || options.ipaddress || this.config.ipaddress,
+        customerId: properties.userId || properties.customerId || options.userId || options.customerId || this.config.customerId,
       })
       return this._sendEvent(eventData)
     }
@@ -178,11 +221,10 @@
       const timestamp = Date.now()
       const eventId = this._generateUUID()
       const requestId = this._generateRequestId()
-      const userId = data.customId || this.config.userId
+      const userId = data.customerId // actual customer id from app
 
       // system_user_id comes from API response only, default to empty string if not available
       const systemUserId = this.config.systemUserId || ''
-      const finalUserId = userId
 
       // Build flat event payload (matching staging.js structure)
       return {
@@ -193,13 +235,13 @@
         timestamp: timestamp,
 
         // User and session
-        user_id: finalUserId,
+        user_id: userId,
         session_id: data.sessionId || this.config.sessionId,
         system_user_id: systemUserId,
 
         // Project information
         project_id: this.config.projectId,
-        project_name: this.config.projectName || '',
+        project_name: this.config.projectName,
 
         // Device information (flattened)
         device: this._deviceInfo.device.type,
@@ -275,7 +317,6 @@
       try {
         // Validate mandatory fields before sending
         this._validateMandatoryFields(eventData)
-
         const headers = {
           'Content-Type': 'application/json'
         }
@@ -495,14 +536,6 @@
       }
     }
 
-    /**
-       * Generate session ID
-       * @private
-       */
-    _generateSessionId () {
-      return 'sess_' + this._generateId()
-    }
-
     /**
        * Generate UUID v4
        * @private