@cero-base/cero 0.8.6 → 0.8.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cero-base/cero",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "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.6",
+    "@cero-base/core": "^0.8.8",
     "b4a": "^1.8.1",
     "bare-abort-controller": "^1.1.2",
     "bare-crypto": "^1.14.1",

package/src/index.js

@@ -188,24 +188,25 @@ export async function restore(me, phrase) {
   })
 }
 
-Object.assign(cero, {
-  t,
-  put,
-  set,
-  get,
-  del,
-  count,
-  watch,
-  call,
-  open,
-  before,
-  after,
-  peek,
-  restore,
-  schema,
-  bind,
-  define
-})
+// Facade: expose the operators + helpers as properties on `cero` too, so both
+// `import { define }` and `cero.define(...)` work. Explicit assignments (not
+// `Object.assign`) so tsc reflects them onto the `cero` namespace in the .d.ts.
+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.before = before
+cero.after = after
+cero.peek = peek
+cero.restore = restore
+cero.schema = schema
+cero.bind = bind
+cero.define = define
 cero._internal = internal
 // A bare function is shorthand for a behavior-only extension: `{ setup: fn }`.
 // Accepts both `use(a, b)` and `use([a, b])` (and a mix) for easier composition.

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/index.d.ts

@@ -26,6 +26,22 @@
  */
 export function cero(dir: string, spec: any, opts?: CeroOpts): Promise<Handle>;
 export namespace cero {
+    export { t };
+    export { put };
+    export { set };
+    export { get };
+    export { del };
+    export { count };
+    export { watch };
+    export { call };
+    export { open };
+    export { before };
+    export { after };
+    export { peek };
+    export { restore };
+    export { schema };
+    export { bind };
+    export { define };
     export { internal as _internal };
     export function use(...exts: any[]): number;
 }
@@ -97,6 +113,21 @@ export type CeroOpts = {
     recoveryTimeout?: number;
 };
 import { Handle } from './handle/index.js';
+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 { before } from './lib/operators.js';
+import { after } from './lib/operators.js';
+import { peek } from './lib/operators.js';
+import { schema } from './lib/spec.js';
+import { bind } from './lib/operators.js';
+import { define } from './lib/operators.js';
 import { internal } from './lib/internal.js';
 import { Ref } from './handle/index.js';
 import { Local } from './local/index.js';

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 };