@cero-base/cero 0.8.8 → 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.8",
+  "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.8",
+    "@cero-base/core": "^0.8.10",
     "b4a": "^1.8.1",
     "bare-abort-controller": "^1.1.2",
     "bare-crypto": "^1.14.1",

package/src/build/index.js

@@ -120,7 +120,14 @@ function isPlainHandle(v) {
 }
 
 function compile(root, ns, scope = 'main') {
-  const ctx = { types: [], collections: [], dispatches: [], meta: { ns, refs: {} }, ns }
+  const ctx = {
+    types: [],
+    collections: [],
+    dispatches: [],
+    indexes: [],
+    meta: { ns, refs: {} },
+    ns
+  }
 
   Object.assign(ctx.meta.refs, builtinRefs(ns, scope))
 
@@ -136,6 +143,7 @@ function compile(root, ns, scope = 'main') {
     types: ctx.types,
     collections: ctx.collections,
     dispatches: ctx.dispatches,
+    indexes: ctx.indexes,
     meta: ctx.meta
   }
 }
@@ -173,6 +181,12 @@ function register(name, node, ctx) {
     ctx.dispatches.push({ name: `set-${name}`, requestType: fqn })
     ctx.dispatches.push({ name: `del-${name}`, requestType: `@${ctx.ns}/del-by-id` })
     ctx.meta.refs[name] = { kind: 'collection', path: [name], schema: fqn }
+    if (node.indexes) {
+      for (const [idx, fields] of Object.entries(node.indexes)) {
+        ctx.indexes.push({ name: `${name}-${idx}`, collection: fqn, key: fields })
+      }
+      ctx.meta.refs[name].indexes = node.indexes
+    }
   }
 }
 
@@ -184,7 +198,7 @@ function fieldsFor(fields) {
   }))
 }
 
-function emitMain(dir, ns, { types, collections, dispatches }, { rpc, extend = {} }) {
+function emitMain(dir, ns, { types, collections, dispatches, indexes = [] }, { rpc, extend = {} }) {
   const schemaDir = join(dir, 'schema')
   const dbDir = join(dir, 'db')
   const dispatchDir = join(dir, 'dispatch')
@@ -201,6 +215,7 @@ function emitMain(dir, ns, { types, collections, dispatches }, { rpc, extend = {
   const dns = db.namespace(ns)
   for (const desc of builtinCollections(ns, 'main')) dns.collections.register(desc)
   for (const desc of collections) dns.collections.register(desc)
+  for (const desc of indexes) dns.indexes.register(desc)
   HyperdbBuilder.toDisk(db, dbDir, { esm: true })
 
   const d = Hyperdispatch.from(schemaDir, dispatchDir)
@@ -217,7 +232,7 @@ function emitMain(dir, ns, { types, collections, dispatches }, { rpc, extend = {
   }
 }
 
-function emitLocal(dir, ns, { types, collections }) {
+function emitLocal(dir, ns, { types, collections, indexes = [] }) {
   const schemaDir = join(dir, 'schema')
   const dbDir = join(dir, 'db')
 
@@ -231,6 +246,7 @@ function emitLocal(dir, ns, { types, collections }) {
   const dns = db.namespace(ns)
   for (const desc of builtinCollections(ns, 'local')) dns.collections.register(desc)
   for (const desc of collections) dns.collections.register(desc)
+  for (const desc of indexes) dns.indexes.register(desc)
   HyperdbBuilder.toDisk(db, dbDir, { esm: true })
 }