@terzogenito/json-utils 1.0.10 → 1.0.11

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,36 @@ 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;
+  }
+}
+
 module.exports = {
   getString,
   getFile,
@@ -512,4 +542,6 @@ module.exports = {
   getPartialDeep,
   getPartialWithDefaults,
   excludeAttributes,
+  getSize,
+  sortBy
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terzogenito/json-utils",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "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"
   }
 }