@truto/truto-jsonata 1.0.47 → 1.0.49

package/README.md

@@ -999,7 +999,13 @@ Blob (13 bytes) {
 <details>
 <summary>digest(text, algorithm = 'SHA-256', stringType = 'hex')</summary>
 
-Generates a cryptographic hash of the input text using a specified hashing algorithm and output format.
+Generates a cryptographic hash of the input text using a specified hashing algorithm and output format. 
+
+**Supported Algorithms:**
+- SHA algorithms (SHA-1, SHA-256, SHA-384, SHA-512) use the [Web Crypto API's `crypto.subtle.digest()`](https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/digest). See [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/digest#supported_algorithms) for the complete list of supported algorithms.
+- MD5 uses the `md5.js` library (since MD5 is not supported by Web Crypto API).
+
+**Output Formats:** 'hex', 'base64', and 'base64-urlSafe'.
 
 **Example:**
 
@@ -1037,7 +1043,39 @@ const expression3 = trutoJsonata("$digest(text, algorithm, stringType)");
 expression3.evaluate({ text: text3, algorithm: algorithm3, stringType: stringType3 }).then(result => {
   console.log(result);
   // Output: "Xh3mV+fAAG7ScGPjo4PElmR3obnFzGrxnbwGpEE4lI4="
+});
+
+// Example 4: MD5 Algorithm, Hex Output
+const text4 = '42';
+const algorithm4 = 'MD5';
+const stringType4 = 'hex';
 
+const expression4 = trutoJsonata("$digest(text, algorithm, stringType)");
+expression4.evaluate({ text: text4, algorithm: algorithm4, stringType: stringType4 }).then(result => {
+  console.log(result);
+  // Output: "a1d0c6e83f027327d8461063f4ac58a6"
+});
+
+// Example 5: MD5 Algorithm, Base64 Output
+const text5 = '42';
+const algorithm5 = 'MD5';
+const stringType5 = 'base64';
+
+const expression5 = trutoJsonata("$digest(text, algorithm, stringType)");
+expression5.evaluate({ text: text5, algorithm: algorithm5, stringType: stringType5 }).then(result => {
+  console.log(result);
+  // Output: "odDG6D8CcyfYRgYj9KxYpg=="
+});
+
+// Example 6: MD5 Algorithm, Base64 URL-Safe Output
+const text6 = '42';
+const algorithm6 = 'MD5';
+const stringType6 = 'base64-urlSafe';
+
+const expression6 = trutoJsonata("$digest(text, algorithm, stringType)");
+expression6.evaluate({ text: text6, algorithm: algorithm6, stringType: stringType6 }).then(result => {
+  console.log(result);
+  // Output: "odDG6D8CcyfYRgYj9KxYpg"
 });
 
 ```
@@ -2116,6 +2154,53 @@ expression.evaluate({ input, possibleValues, threshold }).then(result => { conso
 
 </details>
 
+<details>
+<summary>diceCoefficient(value1, value2)</summary>
+
+Calculates the Dice Coefficient similarity score between two strings. The Dice Coefficient measures the similarity of two strings based on their bigrams (pairs of adjacent characters). The function normalizes both strings (converts to lowercase and removes non-alphanumeric characters) before comparison.
+
+**Parameters:**
+
+- **value1**: The first string to compare.
+- **value2**: The second string to compare.
+
+**Returns:**
+
+A number between `0.0` (completely different) and `1.0` (identical), representing the similarity score.
+
+**Example Usage:**
+
+```javascript
+import trutoJsonata from '@truto/truto-jsonata';
+
+// Example 1: Identical strings return 1.0
+const expression1 = trutoJsonata("$diceCoefficient('hello', 'hello')");
+expression1.evaluate({}).then(result => { console.log(result); });
+// Output: 1.0
+
+// Example 2: Similar strings return a score between 0 and 1
+const expression2 = trutoJsonata("$diceCoefficient('apple', 'appl')");
+expression2.evaluate({}).then(result => { console.log(result); });
+// Output: 0.8 (or similar value depending on similarity)
+
+// Example 3: Case-insensitive comparison
+const expression3 = trutoJsonata("$diceCoefficient('Hello', 'HELLO')");
+expression3.evaluate({}).then(result => { console.log(result); });
+// Output: 1.0
+
+// Example 4: Non-alphanumeric characters are ignored
+const expression4 = trutoJsonata("$diceCoefficient('hello-world', 'hello world')");
+expression4.evaluate({}).then(result => { console.log(result); });
+// Output: 1.0
+
+// Example 5: Completely different strings return 0.0
+const expression5 = trutoJsonata("$diceCoefficient('hello', 'xyz')");
+expression5.evaluate({}).then(result => { console.log(result); });
+// Output: 0.0
+```
+
+</details>
+
 <details>
 <summary>sortNodes(array,   idKey = 'id',
   parentIdKey = 'parent_id',