@cero-base/cero 0.8.7 → 0.8.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cero-base/cero",
-  "version": "0.8.7",
+  "version": "0.8.9",
   "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.7",
+    "@cero-base/core": "^0.8.9",
     "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 })
 }
 

package/src/lib/operators.js

@@ -1,11 +1,12 @@
 import { Readable } from 'streamx'
-import HypercoreStorage from 'hypercore-storage'
-import Corestore from 'corestore'
 
 import { CeroError } from '@cero-base/core/errors'
 
 import { onAbort } from './utils.js'
-import { Local } from '../local/index.js'
+
+// `peek` (below) lazy-imports hypercore-storage / corestore / local so this
+// module — which the lightweight RPC client re-exports — stays free of native
+// deps. A client never calls `peek`, so the heavy imports load only on the core.
 
 /**
  * @typedef {import('./utils.js').Ref} Ref
@@ -205,6 +206,10 @@ export async function peek(dir, spec) {
   if (typeof dir !== 'string' || !dir) throw CeroError.INVALID('dir must be a non-empty string')
   if (!spec) throw CeroError.REQUIRED('spec')
 
+  const { default: HypercoreStorage } = await import('hypercore-storage')
+  const { default: Corestore } = await import('corestore')
+  const { Local } = await import('../local/index.js')
+
   const root = new HypercoreStorage(`${dir}/main`)
   await root.ready()
   const store = new Corestore(root, { manifestVersion: 2 })

package/src/rpc/client.js

@@ -2,9 +2,10 @@ import { Readable } from 'streamx'
 import { RPCClient, bindCodec } from '@cero-base/core/rpc'
 
 import { attachRefs } from '../lib/utils.js'
-import { bind } from '../lib/operators.js'
+import { put, set, get, del, count, watch, call, open, bind, define } from '../lib/operators.js'
+import { t, schema } from '../lib/spec.js'
 
-export { put, set, get, del, count, watch, call, open } from '../lib/operators.js'
+export { put, set, get, del, count, watch, call, open, bind, define, t, schema }
 
 /**
  * @typedef {import('@cero-base/core/rpc').RPCClient} BaseRPCClient
@@ -397,3 +398,34 @@ export async function connect(ipc, spec) {
   await client.ready()
   return client
 }
+
+/**
+ * Symmetric client entry. Mirrors the main `cero`, but `cero(ipc, spec)` connects
+ * to a server (via `connect`) instead of opening a local store. The same operator
+ * surface is attached, so `import { cero } from '@cero-base/cero/client'` works
+ * just like `import { cero } from '@cero-base/cero'`.
+ *
+ * Note: `before`/`after`/`peek` are intentionally not exposed here — they hook the
+ * local write path / probe a local store, which a client proxy has no notion of.
+ *
+ * @param {any} ipc    Framed IPC duplex stream.
+ * @param {any} spec   Built cero spec.
+ * @returns {Promise<Client>}
+ */
+export function cero(ipc, spec) {
+  return connect(ipc, spec)
+}
+cero.connect = connect
+cero.restore = restore
+cero.t = t
+cero.put = put
+cero.set = set
+cero.get = get
+cero.del = del
+cero.count = count
+cero.watch = watch
+cero.call = call
+cero.open = open
+cero.bind = bind
+cero.define = define
+cero.schema = schema

package/types/rpc/client.d.ts

@@ -15,6 +15,36 @@ export function restore(me: Client, phrase: string): Promise<Client>;
  * @returns {Promise<Client>}
  */
 export function connect(ipc: any, spec: object): Promise<Client>;
+/**
+ * Symmetric client entry. Mirrors the main `cero`, but `cero(ipc, spec)` connects
+ * to a server (via `connect`) instead of opening a local store. The same operator
+ * surface is attached, so `import { cero } from '@cero-base/cero/client'` works
+ * just like `import { cero } from '@cero-base/cero'`.
+ *
+ * Note: `before`/`after`/`peek` are intentionally not exposed here — they hook the
+ * local write path / probe a local store, which a client proxy has no notion of.
+ *
+ * @param {any} ipc    Framed IPC duplex stream.
+ * @param {any} spec   Built cero spec.
+ * @returns {Promise<Client>}
+ */
+export function cero(ipc: any, spec: any): Promise<Client>;
+export namespace cero {
+    export { connect };
+    export { restore };
+    export { t };
+    export { put };
+    export { set };
+    export { get };
+    export { del };
+    export { count };
+    export { watch };
+    export { call };
+    export { open };
+    export { bind };
+    export { define };
+    export { schema };
+}
 /**
  * IPC-side RPC client for cero. Wraps an `hrpc` channel and exposes the
  * same handle/ref/row API as a local cero instance, transparently
@@ -100,6 +130,18 @@ export type HandleStub = {
     type: string;
     name: string | null;
 };
+import { t } from '../lib/spec.js';
+import { put } from '../lib/operators.js';
+import { set } from '../lib/operators.js';
+import { get } from '../lib/operators.js';
+import { del } from '../lib/operators.js';
+import { count } from '../lib/operators.js';
+import { watch } from '../lib/operators.js';
+import { call } from '../lib/operators.js';
+import { open } from '../lib/operators.js';
+import { bind } from '../lib/operators.js';
+import { define } from '../lib/operators.js';
+import { schema } from '../lib/spec.js';
 import { RPCClient } from '@cero-base/core/rpc';
 /**
  * Per-device `local`-namespace surface on a Client. Exposes each app-defined
@@ -145,4 +187,4 @@ declare class Handle {
     /** Tear down the remote handle and drop membership. */
     leave(): any;
 }
-export { put, set, get, del, count, watch, call, open } from "../lib/operators.js";
+export { put, set, get, del, count, watch, call, open, bind, define, t, schema };