@cero-base/core 1.7.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cero-base/core",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "cero p2p primitives — identity, storage, network, database, blobs, rpc, pairing.",
   "type": "module",
   "sideEffects": false,
@@ -137,7 +137,7 @@
     "build:types": "rm -rf types && tsc -p .",
     "pretest": "npm run build:test",
     "prepublishOnly": "npm run build:types",
-    "test": "npm run test:node",
+    "test": "npm run test:bare",
     "test:bare": "brittle-bare test/bare.js test/*.test.js",
     "pretest:bare": "npm run build:test",
     "test:node": "brittle-node test/*.test.js"
@@ -152,20 +152,20 @@
     "bare-path": "^3.1.1",
     "bip39-mnemonic": "^2.5.0",
     "blind-pairing": "^2.3.1",
-    "blind-peering": "^2.5.0",
+    "blind-peering": "^2.5.3",
     "compact-encoding": "^3.3.0",
-    "corestore": "^7.11.1",
+    "corestore": "^7.12.0",
     "framed-stream": "^1.0.1",
     "hrpc": "^4.3.0",
     "hyperblobs": "^2.12.1",
-    "hypercore": "^11.34.1",
+    "hypercore": "^11.35.1",
     "hypercore-blob-server": "^1.15.0",
     "hypercore-crypto": "^3.7.0",
     "hypercore-id-encoding": "^1.3.0",
     "hypercore-storage": "^3.2.0",
-    "hyperdb": "^6.7.0",
+    "hyperdb": "^6.8.0",
     "hyperdispatch": "^1.6.0",
-    "hyperschema": "^1.21.0",
+    "hyperschema": "^1.22.0",
     "hyperswarm": "^4.17.0",
     "keet-identity-key": "^3.2.0",
     "protomux-wakeup": "^2.9.0",
@@ -182,7 +182,7 @@
     "bare-fetch": "^3.2.0",
     "bare-process": "^4.5.1",
     "bare-url": "^2.4.6",
-    "blind-peer": "^3.12.3",
+    "blind-peer": "^3.12.5",
     "brittle": "^4.1.0",
     "typescript": "^5.9.3",
     "which-runtime": "^1.4.0"

package/src/pairing/index.js

@@ -23,6 +23,7 @@ const Response = getEncoding('@cero/confirm')
  * @property {import('../network/index.js').Network} network         Network to host the BlindPairing member.
  * @property {import('../identity/index.js').Identity} identity      Identity used to sign invites and derive the topic.
  * @property {Uint8Array} [topic]                                    Optional override topic; defaults to `identity.publicKey`.
+ * @property {boolean} [host]                                        Register the member listener that serves invites (default `true`). Join-only pairings pass `false` — a listener is one-per-topic, so a joiner registering one collides with any concurrent join.
  * @property {any} [inviteEncoding]                                  compact-encoding type for the invite payload `data`.
  * @property {any} [joinerEncoding]                                  compact-encoding type for the joiner-supplied `userData`.
  * @property {(err: Error) => void} [onerror]                        Called when a background candidate fails to process.
@@ -31,7 +32,7 @@ const Response = getEncoding('@cero/confirm')
  * @property {string} [role]                                         Role tag bound into the invite.
  * @property {number} [expiresIn]                                    TTL in ms; `0`/omitted = no expiry.
  * @property {any} [data]                                            Arbitrary payload (encoded via `inviteEncoding` when set).
- * @property {boolean} [multiUse]                                    Reusable until expiry/revoke; default `false` (consumed on first settle).
+ * @property {boolean} [reuse]                                       Reusable until expiry/revoke; default `false` (consumed on first settle).
  *
  * @typedef {object} JoinOpts
  * @property {any} [userData]                                        Payload sent with the candidate request.
@@ -65,6 +66,7 @@ export class Pairing extends ReadyResource {
     network,
     identity,
     topic,
+    host = true,
     inviteEncoding = null,
     joinerEncoding = null,
     onerror = safetyCatch
@@ -76,6 +78,7 @@ export class Pairing extends ReadyResource {
     this.network = network
     this.identity = identity
     this.topic = topic || identity.publicKey
+    this.host = host
     this.inviteEncoding = inviteEncoding
     this.joinerEncoding = joinerEncoding
     this._onerror = onerror
@@ -91,10 +94,15 @@ export class Pairing extends ReadyResource {
     // shared instance — one set of swarm/DHT listeners for every handle
     this._blind = await this.network.blind()
 
-    this._member = this._blind.addMember({
-      discoveryKey: discoveryKey(this.topic),
-      onadd: (req) => this._onCandidate(req).catch(this._onerror)
-    })
+    // blind-pairing allows ONE member listener per discovery key — a join-only
+    // pairing must not register one, or concurrent joins under the same
+    // identity throw 'Active member already exist'
+    if (this.host) {
+      this._member = this._blind.addMember({
+        discoveryKey: discoveryKey(this.topic),
+        onadd: (req) => this._onCandidate(req).catch(this._onerror)
+      })
+    }
     await this.network.refreshInjected()
   }
 
@@ -133,8 +141,11 @@ export class Pairing extends ReadyResource {
    * @param {CreateInviteOpts} [opts]
    * @returns {Promise<string>}
    */
-  async createInvite({ role = '', expiresIn = 0, data = null, multiUse = false } = {}) {
+  async createInvite({ role = '', expiresIn = 0, data = null, reuse = false } = {}) {
     if (this.closing || this.closed) throw CeroError.CLOSED('Pairing')
+    // a join-only pairing has no member listener — an invite it mints would
+    // never be served, so fail loudly instead of handing out a dead invite
+    if (!this.host) throw CeroError.INVALID('cannot create invites on a join-only Pairing')
     if (!this.opened) await this.ready()
 
     // Rendezvous key matches the Member topic so candidates land on the right
@@ -157,7 +168,7 @@ export class Pairing extends ReadyResource {
       seed: blind.seed,
       publicKey: blind.publicKey,
       invite,
-      multiUse
+      reuse
     })
 
     return invite.toString()
@@ -281,7 +292,7 @@ export class Pairing extends ReadyResource {
       seed: record.seed,
       userData,
       onsettle: () => {
-        if (!record.multiUse) this._invites.delete(id)
+        if (!record.reuse) this._invites.delete(id)
       }
     })
 

package/types/pairing/index.d.ts

@@ -3,6 +3,7 @@
  * @property {import('../network/index.js').Network} network         Network to host the BlindPairing member.
  * @property {import('../identity/index.js').Identity} identity      Identity used to sign invites and derive the topic.
  * @property {Uint8Array} [topic]                                    Optional override topic; defaults to `identity.publicKey`.
+ * @property {boolean} [host]                                        Register the member listener that serves invites (default `true`). Join-only pairings pass `false` — a listener is one-per-topic, so a joiner registering one collides with any concurrent join.
  * @property {any} [inviteEncoding]                                  compact-encoding type for the invite payload `data`.
  * @property {any} [joinerEncoding]                                  compact-encoding type for the joiner-supplied `userData`.
  * @property {(err: Error) => void} [onerror]                        Called when a background candidate fails to process.
@@ -11,7 +12,7 @@
  * @property {string} [role]                                         Role tag bound into the invite.
  * @property {number} [expiresIn]                                    TTL in ms; `0`/omitted = no expiry.
  * @property {any} [data]                                            Arbitrary payload (encoded via `inviteEncoding` when set).
- * @property {boolean} [multiUse]                                    Reusable until expiry/revoke; default `false` (consumed on first settle).
+ * @property {boolean} [reuse]                                       Reusable until expiry/revoke; default `false` (consumed on first settle).
  *
  * @typedef {object} JoinOpts
  * @property {any} [userData]                                        Payload sent with the candidate request.
@@ -56,10 +57,11 @@ export class Pairing extends ReadyResource {
      */
     static isInvite(str: unknown): boolean;
     /** @param {PairingOpts} [opts] */
-    constructor({ network, identity, topic, inviteEncoding, joinerEncoding, onerror }?: PairingOpts);
+    constructor({ network, identity, topic, host, inviteEncoding, joinerEncoding, onerror }?: PairingOpts);
     network: import("../index.js").Network;
     identity: import("../index.js").Identity;
     topic: Uint8Array<ArrayBufferLike>;
+    host: boolean;
     inviteEncoding: any;
     joinerEncoding: any;
     _onerror: (err: Error) => void;
@@ -73,7 +75,7 @@ export class Pairing extends ReadyResource {
      * @param {CreateInviteOpts} [opts]
      * @returns {Promise<string>}
      */
-    createInvite({ role, expiresIn, data, multiUse }?: CreateInviteOpts): Promise<string>;
+    createInvite({ role, expiresIn, data, reuse }?: CreateInviteOpts): Promise<string>;
     /**
      * Forget a previously-minted invite. New candidates carrying it will be
      * dropped silently.
@@ -124,6 +126,10 @@ export type PairingOpts = {
      * Optional override topic; defaults to `identity.publicKey`.
      */
     topic?: Uint8Array;
+    /**
+     * Register the member listener that serves invites (default `true`). Join-only pairings pass `false` — a listener is one-per-topic, so a joiner registering one collides with any concurrent join.
+     */
+    host?: boolean;
     /**
      * compact-encoding type for the invite payload `data`.
      */
@@ -153,7 +159,7 @@ export type CreateInviteOpts = {
     /**
      * Reusable until expiry/revoke; default `false` (consumed on first settle).
      */
-    multiUse?: boolean;
+    reuse?: boolean;
 };
 export type JoinOpts = {
     /**