feat: handle stream and file inputs

Author: DoneDeal0

README.md

@@ -40,7 +40,7 @@ I am grateful to the generous donors of **Superdiff**!
 
 ## FEATURES
 
-**Superdiff** exports 5 functions:
+**Superdiff** exports 6 functions:
 
 ```ts
 // Returns a complete diff of two objects
@@ -52,6 +52,9 @@ getListDiff(prevList, nextList)
 // Streams the diff of two object lists, ideal for large lists and maximum performance
 streamListDiff(prevList, nextList, referenceProperty)
 
+// Similar to streamListDiff, but for browser use
+streamListDiffClient(prevList, nextList, referenceProperty)
+
 // Checks whether two values are equal 
 isEqual(dataA, dataB)
 
@@ -306,7 +309,10 @@ getListDiff(
 ### streamListDiff() 
 
 ```js
+// If you are in a server environment
 import { streamListDiff } from "@donedeal0/superdiff";
+// If you are in a browser environment
+import { streamListDiffClient } from "@donedeal0/superdiff";
 ```
 
 Streams the diff of two object lists, ideal for large lists and maximum performance.
@@ -316,8 +322,8 @@ Streams the diff of two object lists, ideal for large lists and maximum performa
 **Input**
 
 ```ts
- prevList: Record<string, unknown>[],
- nextList: Record<string, unknown>[],
+ prevList: Readable | FilePath | Record<string, unknown>[],
+ nextList: Readable | FilePath | Record<string, unknown>[],
  referenceProperty: keyof Record<string, unknown>,
  options: {
   showOnly?: ("added" | "deleted" | "moved" | "updated" | "equal")[], // [] by default
@@ -370,6 +376,18 @@ type StreamListDiff<T extends Record<string, unknown>> = {
 
 **Input**
 
+You can send streams, file paths, or arrays as input:
+
+```ts
+    // If you are in a server environment
+    const streamA = Readable.from(list, { objectMode: true });
+    const streamB = path.resolve(__dirname, "./list.json");
+    const streamC = [{ id: 1, name: "hello" }]
+
+    // If you are in a browser environment
+    const streamC = [{ id: 1, name: "hello" }]
+```
+
 ```diff
 const diff = streamListDiff(
       [