@cero-base/cero 0.8.9 → 0.8.10

package/README.md

@@ -85,6 +85,15 @@ const recovered = await cero.restore(me, 'twelve words …')
 | `{ … }` (plain object)     | a child handle — its own scope, share by invite |
 | `local: { … }`             | device-only — never leaves this device          |
 
+A collection can declare **secondary indexes** for fast exact-field lookups:
+
+```js
+cero.t.collection(
+  { text: cero.t.string },
+  { indexes: { 'by-text': ['text'] } } // name → field(s); query via `cero.get(ref, { text: '…' })`
+)
+```
+
 ## Operators
 
 Every operator takes a `ref` (e.g. `me.profile`, `room.messages`) as the first arg.
@@ -110,19 +119,30 @@ await cero.set(room.messages, { id: 'abc', text: 'edited' }) // upsert by id
 
 ### `cero.get(ref, q?)`
 
-Read. Three shapes depending on `q`:
+Read. The shape of `q` decides what comes back:
 
 ```js
 const { data } = await cero.get(me.profile) // single → the row (or null)
 const { data } = await cero.get(room.messages, 'abc') // by id  → the row (or null)
+
+// collection → paginated, with range filters
 const { data, total, size } = await cero.get(room.messages, {
-  gt: 'm-2025', // filters: gt / gte / lt / lte
+  gt: 'm-2025', // range: gt / gte / lt / lte
   limit: 20,
   reverse: true
-}) // collection → paginated
+})
+
+// search → case-insensitive substring across string fields
+const { data } = await cero.get(room.messages, { search: 'jo sm' })
+// every space-separated term must match (AND); folds case + diacritics ('jose' ⇢ 'José').
+// `fields` restricts which fields are searched (default: all string fields):
+const { data } = await cero.get(room.guests, { search: 'jose', fields: ['name'] })
+
+// exact field match → routed through a declared secondary index when the field has one
+const { data } = await cero.get(room.messages, { text: 'alpha' })
 ```
 
-`total` is the unfiltered row count; `size` is what came back after `limit`.
+`total` is the unfiltered row count; `size` is what came back after `limit`. `search` and exact-field filters compose with `limit` / `reverse`, and `cero.count(ref, q)` honors them too.
 
 ### `cero.del(ref, id)`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cero-base/cero",
-  "version": "0.8.9",
+  "version": "0.8.10",
   "description": "The ideal p2p API — everything is a handle, handles contain refs, refs contain rows.",
   "type": "module",
   "main": "./src/index.js",
@@ -78,7 +78,7 @@
     "test": "ls test/*.test.js | xargs -P1 -n1 brittle-node"
   },
   "dependencies": {
-    "@cero-base/core": "^0.8.9",
+    "@cero-base/core": "^0.8.10",
     "b4a": "^1.8.1",
     "bare-abort-controller": "^1.1.2",
     "bare-crypto": "^1.14.1",