docs: add README

README.md

@@ -72,6 +72,40 @@ search('year:!=1990,2000', db); // [{name: 'Jane', year: 1985}]
 search('year:1980..1987', db); // [{name: 'Jane', year: 1985}]
 ```
 
+## Usage with BSON
+
+```js
+import { search } from 'smart-sqlite3-filter';
+import sqLite from 'better-sqlite3';
+
+const db = sqLite(':memory:');
+
+// create data and add some dummy data
+const sql = `
+    CREATE TABLE IF NOT EXISTS bsons (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL,
+      year INTEGER NOT NULL,
+      bson BLOB NOT NULL
+    );
+
+    INSERT INTO bsons (name, year, bson) VALUES
+    ('John', 1990, jsonb('{"name": "John", "year": 1990}')),
+    ('Jane', 1985, jsonb('{"name": "Jane", "year": 1985}')),
+    ('Alice', 2000, jsonb('{"name": "Alice", "year": 2000}')),
+    ('Bob', 1990, jsonb('{"name": "Bob", "year": 1990}'));
+  `;
+
+db.exec(sql);
+
+search('name:$e,n', db); // 3 hits
+search('year:1990,2000 name:$e,n', db); // 2 hits
+search('bson.year:1990', db); // 2 hits
+search('bson.name:$e', db); // 2 hits
+search('bson.name:$e,n', db); // 3 hits
+search('bson.year:1990,2000 bson.name:$e,n', db); // 2 hits
+```
+
 ## License
 
 [MIT](./LICENSE)