clarity-analytics-sdk 1.0.5 → 1.0.6

package/package.json

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

package/src/index.js

@@ -138,7 +138,8 @@
      * @param {Object} properties - Event properties
      * @param {Object} options - Additional options
      */
-    async track (eventName, properties = {}, options = {}) {      // Wait for SDK to be initialized
+    async track (eventName, properties = {}, options = {}) {
+      // Wait for SDK to be initialized
       if (!this._isInitialized) {
         try {
           await this._initializationPromise
@@ -156,6 +157,44 @@
         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 < 5 || 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,
@@ -190,7 +229,7 @@
         event_id: eventId,
         request_id: requestId,
         event_name: data.eventName || 'Unnamed Event',
-        timestamp: timestamp,
+        timestamp,
 
         // User and session
         user_id: finalUserId,