@cero-base/cero 1.8.1 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cero-base/cero",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "description": "The ideal p2p API — everything is a handle, handles contain refs, refs contain rows.",
   "type": "module",
   "sideEffects": false,
@@ -95,11 +95,11 @@
     "test:node": "ls test/*.test.js | xargs -P1 -n1 brittle-node"
   },
   "dependencies": {
-    "@cero-base/core": "^1.8.1",
+    "@cero-base/core": "^1.10.0",
     "b4a": "^1.8.1",
     "bare-abort-controller": "^1.1.2",
     "bare-crypto": "^1.15.3",
-    "bare-fs": "^4.7.4",
+    "bare-fs": "^4.8.0",
     "bare-path": "^3.1.1",
     "compact-encoding": "^3.3.0",
     "corestore": "^7.12.0",
@@ -120,7 +120,7 @@
     "bare-events": "^2.9.1",
     "bare-fetch": "^3.2.0",
     "bare-process": "^4.5.1",
-    "bare-url": "^2.4.6",
+    "bare-url": "^2.5.2",
     "brittle": "^4.1.0",
     "typescript": "^5.9.3"
   },

package/src/bluetooth.js

@@ -43,8 +43,9 @@ export class Bluetooth extends ReadyResource {
    * @param {boolean} [opts.autoStart]  Start on handle open (from `cero({ bluetooth: true })`).
    * @param {number} [opts.maxOutbound]  Max concurrent outbound links; gossip covers the rest.
    * @param {number} [opts.maxInbound]   Max concurrent inbound sessions; newcomers past this are refused.
+   * @param {'l2cap' | 'gatt'} [opts.pipe]  Data pipe — 'l2cap' (default, faster) or 'gatt'. Both peers must match.
    */
-  constructor(handle, { backend, autoStart, maxOutbound, maxInbound } = {}) {
+  constructor(handle, { backend, autoStart, maxOutbound, maxInbound, pipe } = {}) {
     super()
     this._handle = handle
     // explicit null/false disables bluetooth; only an omitted backend lazy-loads
@@ -53,6 +54,7 @@ export class Bluetooth extends ReadyResource {
     this._autoStart = autoStart === true
     this._maxOutbound = maxOutbound
     this._maxInbound = maxInbound
+    this._pipe = pipe
     this._transport = null
     this._name = null
     this._announces = new Set()
@@ -83,6 +85,7 @@ export class Bluetooth extends ReadyResource {
       uuid: topic,
       nodeId: this._handle.identity.publicKey,
       tag: 'cero-ble-invite',
+      pipe: this._pipe,
       // the QR closing stops the rendezvous, not the just-established link —
       // that link carries the joiner's initial replication
       keepLinks: true
@@ -145,6 +148,7 @@ export class Bluetooth extends ReadyResource {
         : handle.identity.publicKey,
       nodeId: handle.identity.publicKey,
       name: this._name || '',
+      pipe: this._pipe,
       maxOutbound: this._maxOutbound,
       maxInbound: this._maxInbound,
       // Android scans in a battery-saver mode by default — too slow for a mesh

package/src/build/schemas.js

@@ -48,7 +48,9 @@ export const main = {
     role: required(string),
     expires: int,
     createdAt: int,
-    index: uint
+    index: uint,
+    seed: bytes,
+    reuse: bool
   },
   handle: {
     id: required(string),

package/src/handle/index.js

@@ -154,9 +154,18 @@ export class Handle extends ReadyResource {
         network: this.network,
         identity: this.identity,
         topic: this.store.key,
-        onerror: this._onerror
+        onerror: this._onerror,
+        onconsume: (id) => {
+          this.store.call('del-invite', { id }).catch(safetyCatch)
+        }
       })
       await this.pair.ready()
+      // Serve invites persisted by any member — and keep the served set in
+      // step as rows replicate in (minted elsewhere) or disappear (revoked
+      // or consumed elsewhere).
+      await this._syncInvites().catch(safetyCatch)
+      this._invitesSync = () => this._syncInvites().catch(safetyCatch)
+      this.store.on('update', this._invitesSync)
     }
     attachRefs(this, this.store.refs)
     this.root._coreKeys.set(b4a.toString(this.store.key, 'hex'), this.store.encryptionKey)
@@ -179,6 +188,10 @@ export class Handle extends ReadyResource {
       for (const c of [...this.children]) await c.close()
       this.children.clear()
     }
+    if (this._invitesSync) {
+      this.store.off('update', this._invitesSync)
+      this._invitesSync = null
+    }
     if (this.pair) await this.pair.close()
 
     if (this.parent) {
@@ -455,12 +468,37 @@ export class Handle extends ReadyResource {
    * @param {{ role?: string, expiresIn?: number, data?: any }} [opts]
    * @returns {Promise<string>}  Z32-encoded invite string.
    */
-  invite(opts) {
+  async invite(opts) {
     if (!this.pair)
       throw CeroError.INVALID(
         'invite() is not available on the root handle — open a child handle first'
       )
-    return this.pair.createInvite(opts)
+    const str = await this.pair.createInvite(opts)
+    const record = this.pair.recordOf(str)
+    if (record) {
+      // Persist so every member replica serves this invite across restarts —
+      // the in-memory record keeps working this session even if the write
+      // fails.
+      await this.store
+        .call('add-invite', {
+          id: b4a.toString(record.id, 'hex'),
+          invite: b4a.from(str),
+          publicKey: record.publicKey,
+          seed: record.seed,
+          role: record.invite.role || '',
+          expires: record.invite.expires || 0,
+          createdAt: Date.now(),
+          reuse: !!record.reuse
+        })
+        .catch(safetyCatch)
+    }
+    return str
+  }
+
+  async _syncInvites() {
+    if (!this.pair) return
+    const { data } = await this.store.get('invites')
+    this.pair.syncRows(data || [])
   }
 
   /**
@@ -471,7 +509,13 @@ export class Handle extends ReadyResource {
    */
   revoke(invite) {
     if (!this.pair) throw CeroError.INVALID('revoke() is not available on the root handle')
-    return this.pair.revoke(invite)
+    const record = this.pair.recordOf(invite)
+    const revoked = this.pair.revoke(invite)
+    if (revoked && record) {
+      // drop the persisted row so every other member stops serving it too
+      this.store.call('del-invite', { id: b4a.toString(record.id, 'hex') }).catch(safetyCatch)
+    }
+    return revoked
   }
 
   /**

package/types/bluetooth.d.ts

@@ -21,12 +21,14 @@ export class Bluetooth extends ReadyResource {
      * @param {boolean} [opts.autoStart]  Start on handle open (from `cero({ bluetooth: true })`).
      * @param {number} [opts.maxOutbound]  Max concurrent outbound links; gossip covers the rest.
      * @param {number} [opts.maxInbound]   Max concurrent inbound sessions; newcomers past this are refused.
+     * @param {'l2cap' | 'gatt'} [opts.pipe]  Data pipe — 'l2cap' (default, faster) or 'gatt'. Both peers must match.
      */
-    constructor(handle: object, { backend, autoStart, maxOutbound, maxInbound }?: {
+    constructor(handle: object, { backend, autoStart, maxOutbound, maxInbound, pipe }?: {
         backend?: any;
         autoStart?: boolean;
         maxOutbound?: number;
         maxInbound?: number;
+        pipe?: "l2cap" | "gatt";
     });
     _handle: any;
     _backend: any;
@@ -34,6 +36,7 @@ export class Bluetooth extends ReadyResource {
     _autoStart: boolean;
     _maxOutbound: number;
     _maxInbound: number;
+    _pipe: "l2cap" | "gatt";
     _transport: BLETransport;
     _name: any;
     _announces: Set<any>;

package/types/build/schemas.d.ts

@@ -42,6 +42,8 @@ export const main: {
         expires: import("@cero-base/core").Prim;
         createdAt: import("@cero-base/core").Prim;
         index: import("@cero-base/core").Prim;
+        seed: import("@cero-base/core").Prim;
+        reuse: import("@cero-base/core").Prim;
     };
     handle: {
         id: import("@cero-base/core").Prim;

package/types/handle/index.d.ts

@@ -100,6 +100,7 @@ export class Handle extends ReadyResource {
     store: Database;
     pair: Pairing;
     _wantsPair: boolean;
+    _invitesSync: () => Promise<void>;
     /**
      * Tie a destroyable resource (a `watch` stream, a timer, any `{ destroy }`)
      * to this handle's lifecycle — it's destroyed automatically on close, so
@@ -235,6 +236,7 @@ export class Handle extends ReadyResource {
         expiresIn?: number;
         data?: any;
     }): Promise<string>;
+    _syncInvites(): Promise<void>;
     /**
      * Revoke a previously-minted invite by its string form.
      *