@terzogenito/json-utils 1.0.10 → 1.0.12

package/README.md

@@ -8,6 +8,14 @@ This module provides various functions for reading, validating, and processing J
 npm install @terzogenito/json-utils
 ```
 
+## Quick Start
+```javascript
+import jsonUtils from '@terzogenito/json-utils';
+
+const jsonAttributes = jsonUtils.getAttributes(jsonData);
+console.log(jsonAttributes);
+```
+
 ## Function List
 
 ### 1. `getData(path)`
@@ -311,15 +319,15 @@ Returns: Object with extracted values (uses last path segment as key for array i
 ### 19. getPartialWithDefaults(jsonObject, attributesConfig)
 ```javascript
 const partialWithDefaults = app.getPartialWithDefaults(dataJSON, {
-"name": "name",
-"status": {
-path: "isActive",
-transform: (val) => val ? "Active" : "Inactive"
-},
-"email": {
-path: "contact.email",
-default: "no-email@example.com"
-}
+    "name": "name",
+    "status": {
+        path: "isActive",
+        transform: (val) => val ? "Active" : "Inactive"
+    },
+    "email": {
+        path: "contact.email",
+        default: "no-email@example.com"
+    }
 });
 ```
 
@@ -337,9 +345,9 @@ Configuration Options:
 - Object: Advanced configuration
 ```javascript
 "formattedAge": {
-path: "age", // Required: Path to attribute
-default: 0, // Optional: Default value if path doesn't exist
-transform: (val) => ${val} years old // Optional: Transformation function
+    path: "age", // Required: Path to attribute
+    default: 0, // Optional: Default value if path doesn't exist
+    transform: (val) => ${val} years old // Optional: Transformation function
 }
 ```
 
@@ -403,15 +411,15 @@ const nestedData = app.getPartialDeep(jsonData, ["user.profile.name", "user.cont
 
 // Extract with transformations and defaults
 const processedData = app.getPartialWithDefaults(jsonData, {
-"fullName": "user.name",
-"ageFormatted": {
-path: "user.age",
-transform: (age) => ${age} years old
-},
-"country": {
-path: "user.address.country",
-default: "Unknown"
-}
+    "fullName": "user.name",
+    "ageFormatted": {
+        path: "user.age",
+        transform: (age) => ${age} years old
+    },
+    "country": {
+        path: "user.address.country",
+        default: "Unknown"
+    }
 });
 
 // Exclude sensitive information

package/index.js

@@ -490,6 +490,155 @@ function excludeAttributes(jsonObject, attributesToExclude) {
   }
 }
 
+function getSize(jsonObject) {
+  try {
+    const jsonString = typeof jsonObject === 'string' 
+      ? jsonObject 
+      : JSON.stringify(jsonObject);
+    return new Blob([jsonString]).size;
+  } catch (error) {
+    console.error('Error in getSize:', error);
+    return 0;
+  }
+}
+
+function sortBy(array, key, ascending = true) {
+  try {
+    if (!Array.isArray(array)) return array;
+    
+    return [...array].sort((a, b) => {
+      const aValue = typeof key === 'function' ? key(a) : a[key];
+      const bValue = typeof key === 'function' ? key(b) : b[key];
+      
+      if (aValue < bValue) return ascending ? -1 : 1;
+      if (aValue > bValue) return ascending ? 1 : -1;
+      return 0;
+    });
+  } catch (error) {
+    console.error('Error in sortBy:', error);
+    return array;
+  }
+}
+
+function findKeys(jsonObject, keyName) {
+  try {
+    if (typeof jsonObject === 'string') {
+      jsonObject = JSON.parse(jsonObject);
+    }
+
+    if (typeof jsonObject !== 'object' || jsonObject === null) {
+      return [];
+    }
+
+    const results = [];
+    const pattern = keyName.includes('*') 
+      ? new RegExp('^' + keyName.replace(/\*/g, '.*') + '$')
+      : null;
+    
+    function search(obj, path = '') {
+      if (typeof obj !== 'object' || obj === null) return;
+      
+      if (Array.isArray(obj)) {
+        obj.forEach((item, index) => {
+          search(item, path ? `${path}[${index}]` : `[${index}]`);
+        });
+      } else {
+        for (const [key, value] of Object.entries(obj)) {
+          const newPath = path ? `${path}.${key}` : key;
+          
+          const isMatch = pattern ? pattern.test(key) : key === keyName;
+          if (isMatch) {
+            results.push({ path: newPath, value });
+          }
+          
+          if (typeof value === 'object' && value !== null) {
+            search(value, newPath);
+          }
+        }
+      }
+    }
+    
+    search(jsonObject);
+    return results;
+  } catch (error) {
+    console.error('Error in findKeys:', error);
+    return [];
+  }
+}
+
+function deepEqual(obj1, obj2) {
+  if (obj1 === obj2) return true;
+  
+  if (typeof obj1 !== 'object' || obj1 === null || 
+      typeof obj2 !== 'object' || obj2 === null) {
+    return false;
+  }
+  
+  const keys1 = Object.keys(obj1);
+  const keys2 = Object.keys(obj2);
+  
+  if (keys1.length !== keys2.length) return false;
+  
+  for (const key of keys1) {
+    if (!keys2.includes(key) || !deepEqual(obj1[key], obj2[key])) {
+      return false;
+    }
+  }
+  
+  return true;
+}
+
+function diff(obj1, obj2, path = '') {
+  const differences = [];
+  
+  if (typeof obj1 !== 'object' || obj1 === null ||
+      typeof obj2 !== 'object' || obj2 === null) {
+    if (obj1 !== obj2) {
+      differences.push({
+        path,
+        type: 'value',
+        old: obj1,
+        new: obj2
+      });
+    }
+    return differences;
+  }
+  
+  const allKeys = new Set([...Object.keys(obj1), ...Object.keys(obj2)]);
+  
+  for (const key of allKeys) {
+    const newPath = path ? `${path}.${key}` : key;
+    
+    if (!(key in obj1)) {
+      differences.push({
+        path: newPath,
+        type: 'added',
+        value: obj2[key]
+      });
+    } else if (!(key in obj2)) {
+      differences.push({
+        path: newPath,
+        type: 'removed',
+        value: obj1[key]
+      });
+    } else if (!deepEqual(obj1[key], obj2[key])) {
+      if (typeof obj1[key] === 'object' && obj1[key] !== null &&
+          typeof obj2[key] === 'object' && obj2[key] !== null) {
+        differences.push(...diff(obj1[key], obj2[key], newPath));
+      } else {
+        differences.push({
+          path: newPath,
+          type: 'changed',
+          old: obj1[key],
+          new: obj2[key]
+        });
+      }
+    }
+  }
+  
+  return differences;
+}
+
 module.exports = {
   getString,
   getFile,
@@ -512,4 +661,9 @@ module.exports = {
   getPartialDeep,
   getPartialWithDefaults,
   excludeAttributes,
+  getSize,
+  sortBy,
+  findKeys,
+  deepEqual,
+  diff
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terzogenito/json-utils",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "JSON data utilities",
   "main": "index.js",
   "files": [
@@ -31,9 +31,5 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/terzogenito/json-utils.git"
-  },
-  "homepage": "https://github.com/terzogenito/json-utils#readme",
-  "bugs": {
-    "url": "https://github.com/terzogenito/json-utils/issues"
   }
 }