@tracelog/lib 0.4.0 → 0.5.0

package/dist/esm/utils/validations/metadata-validations.utils.js

@@ -41,13 +41,13 @@ export const isValidEventName = (eventName) => {
     return { valid: true };
 };
 /**
- * Validates metadata for events
+ * Validates a single metadata object
  * @param eventName - The event name (for error messages)
- * @param metadata - The metadata to validate
+ * @param metadata - The metadata object to validate
  * @param type - Type of metadata (globalMetadata or customEvent)
  * @returns Validation result with sanitized metadata if valid
  */
-export const isValidMetadata = (eventName, metadata, type) => {
+const validateSingleMetadata = (eventName, metadata, type) => {
     const sanitizedMetadata = sanitizeMetadata(metadata);
     const intro = type && type === 'customEvent' ? `${type} "${eventName}" metadata error` : `${eventName} metadata error`;
     if (!isOnlyPrimitiveFields(sanitizedMetadata)) {
@@ -108,3 +108,41 @@ export const isValidMetadata = (eventName, metadata, type) => {
         sanitizedMetadata,
     };
 };
+/**
+ * Validates metadata for events (supports both objects and arrays of objects)
+ * @param eventName - The event name (for error messages)
+ * @param metadata - The metadata to validate
+ * @param type - Type of metadata (globalMetadata or customEvent)
+ * @returns Validation result with sanitized metadata if valid
+ */
+export const isValidMetadata = (eventName, metadata, type) => {
+    if (Array.isArray(metadata)) {
+        const sanitizedArray = [];
+        const intro = type && type === 'customEvent' ? `${type} "${eventName}" metadata error` : `${eventName} metadata error`;
+        for (let i = 0; i < metadata.length; i++) {
+            const item = metadata[i];
+            if (typeof item !== 'object' || item === null || Array.isArray(item)) {
+                return {
+                    valid: false,
+                    error: `${intro}: array item at index ${i} must be an object.`,
+                };
+            }
+            const itemValidation = validateSingleMetadata(eventName, item, type);
+            if (!itemValidation.valid) {
+                return {
+                    valid: false,
+                    error: `${intro}: array item at index ${i} is invalid: ${itemValidation.error}`,
+                };
+            }
+            if (itemValidation.sanitizedMetadata) {
+                sanitizedArray.push(itemValidation.sanitizedMetadata);
+            }
+        }
+        // Allow empty arrays after sanitization
+        return {
+            valid: true,
+            sanitizedMetadata: sanitizedArray,
+        };
+    }
+    return validateSingleMetadata(eventName, metadata, type);
+};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tracelog/lib",
   "description": "JavaScript library for web analytics and real-time event tracking",
   "license": "MIT",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "main": "./dist/cjs/public-api.js",
   "module": "./dist/esm/public-api.js",
   "types": "./dist/esm/public-api.d.ts",