@cero-base/cero 1.1.1 → 1.3.0

package/types/handle/index.d.ts

@@ -20,6 +20,7 @@ export { Ref } from "../lib/utils.js";
  * @property {Uint8Array} [encryptionKey]      Existing encryption key.
  * @property {string} [namespace]              Corestore namespace.
  * @property {KeyPair} [keyPair]               Writer keypair.
+ * @property {boolean} [passive]               Join discovery server-only; flip later with `setActive`.
  * @property {boolean} [pair]                  When `false`, skips creating a `Pairing` session.
  *
  * @typedef {object} CreateChildOpts
@@ -195,6 +196,15 @@ export class Handle extends ReadyResource {
      * @returns {Promise<void>}
      */
     recover({ timeout }?: RecoverOpts): Promise<void>;
+    /**
+     * Flip this handle's swarm announce mode — `setActive(false)` demotes an
+     * idle/background room to server-only (still reachable, stops searching);
+     * `setActive(true)` promotes it back on focus. Cheap, safe to call often.
+     *
+     * @param {boolean} active
+     * @returns {Promise<void>}
+     */
+    setActive(active: boolean): Promise<void>;
     /**
      * Mint a pairing invite for this handle.
      *
@@ -368,6 +378,10 @@ export type HandleOpts = {
      * Writer keypair.
      */
     keyPair?: KeyPair;
+    /**
+     * Join discovery server-only; flip later with `setActive`.
+     */
+    passive?: boolean;
     /**
      * When `false`, skips creating a `Pairing` session.
      */

package/types/index.d.ts

@@ -17,6 +17,9 @@
  * @property {(err: any) => void} [onerror]            Background-task error handler.
  * @property {boolean} [recovery]                      Recovery flow — wipe local state and re-claim a writer slot.
  * @property {number} [recoveryTimeout]                Max wait for peer data + writer capability during recovery.
+ * @property {Uint8Array} [storageKey]                 32-byte key encrypting local key material (master seed, device keypairs) at rest. Source it from the OS keychain — cero never stores it.
+ * @property {boolean} [extensions]                    `false` disables the bundled extensions (profileSync, handleSync) for this instance. Build with `{ extensions: false }` too so the spec matches.
+ * @property {boolean | { autoStart?: boolean, backend?: any }} [bluetooth]  `true` enables nearby (Bluetooth) sync via `me.bluetooth` (auto-started). `{ autoStart: false }` creates the facade without starting the radio — the app calls `me.bluetooth.start()`/`stop()` (user toggle). `backend` injects a bare-bluetooth-shaped backend (tests); absent backend on an unsupported host → `me.bluetooth.state === 'unsupported'`.
  */
 /**
  * Open (or create) a cero handle at `dir`. Sets up storage, network and
@@ -47,7 +50,7 @@ export namespace cero {
     export { bind };
     export { define };
     export { internal as _internal };
-    export function use(...exts: any[]): number;
+    export function use(...exts: any[]): void;
 }
 /**
  * Restore a cero instance from a mnemonic phrase. Closes the running
@@ -121,6 +124,21 @@ export type CeroOpts = {
      * Max wait for peer data + writer capability during recovery.
      */
     recoveryTimeout?: number;
+    /**
+     * 32-byte key encrypting local key material (master seed, device keypairs) at rest. Source it from the OS keychain — cero never stores it.
+     */
+    storageKey?: Uint8Array;
+    /**
+     * `false` disables the bundled extensions (profileSync, handleSync) for this instance. Build with `{ extensions: false }` too so the spec matches.
+     */
+    extensions?: boolean;
+    /**
+     * `true` enables nearby (Bluetooth) sync via `me.bluetooth` (auto-started). `{ autoStart: false }` creates the facade without starting the radio — the app calls `me.bluetooth.start()`/`stop()` (user toggle). `backend` injects a bare-bluetooth-shaped backend (tests); absent backend on an unsupported host → `me.bluetooth.state === 'unsupported'`.
+     */
+    bluetooth?: boolean | {
+        autoStart?: boolean;
+        backend?: any;
+    };
 };
 import { t } from './lib/spec.js';
 import { put } from './lib/operators.js';

package/types/lib/internal.d.ts

@@ -1,3 +1,24 @@
 export namespace internal {
-    let extensions: any[];
+    let extensions: ({
+        name: string;
+        bundled: boolean;
+        schema: {
+            profile: import("@cero-base/core").TypeDef;
+            members: {
+                kind: "extend";
+                fields: Record<string, import("@cero-base/core").Prim>;
+            };
+        };
+        setup(me: any): void;
+    } | {
+        name: string;
+        bundled: boolean;
+        schema: {
+            handles: {
+                kind: "extend";
+                fields: Record<string, import("@cero-base/core").Prim>;
+            };
+        };
+        setup(me: any): void;
+    })[];
 }

package/types/lib/operators.d.ts

@@ -45,13 +45,7 @@ export function bind(handle: any, arg: Record<string, any> | string | null): any
 export function define(map: Record<string, any>): void;
 /** Test seam: clear all registered operators. */
 export function _clearDefined(): void;
-export function put(ref: Ref, row: Record<string, any>): Promise<SingleResult | {
-    id: string;
-    name?: string;
-    type: string;
-    size: number;
-    url: string;
-}>;
+export function put(ref: Ref, row: Record<string, any>): Promise<SingleResult>;
 export function set(ref: Ref, row: Record<string, any>, opts?: {
     upsert?: boolean;
 }): Promise<SingleResult>;

package/types/local/index.d.ts

@@ -2,6 +2,7 @@
  * @typedef {object} LocalOpts
  * @property {any} [root]   Pre-existing HypercoreStorage to reuse.
  * @property {any} [store]  Pre-existing Corestore to reuse.
+ * @property {Uint8Array} [storageKey]  32-byte key encrypting the local store at rest.
  */
 /**
  * Per-device, single-writer storage for cero — holds the master seed,
@@ -14,7 +15,7 @@ export class Local extends ReadyResource {
      * @param {any} spec            Built cero spec — must include `spec.local.database` and `spec.meta.local`.
      * @param {LocalOpts} [opts]
      */
-    constructor(dir: string | null, spec: any, { root, store }?: LocalOpts);
+    constructor(dir: string | null, spec: any, { root, store, storageKey }?: LocalOpts);
     dir: string;
     spec: any;
     store: Storage;
@@ -28,6 +29,10 @@ export type LocalOpts = {
      * Pre-existing Corestore to reuse.
      */
     store?: any;
+    /**
+     * 32-byte key encrypting the local store at rest.
+     */
+    storageKey?: Uint8Array;
 };
 import ReadyResource from 'ready-resource';
 import { Storage } from '@cero-base/core/storage';

package/src/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>

package/src/build/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>

package/src/extensions/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>

package/src/handle/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>

package/src/lib/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>

package/src/rpc/CLAUDE.md

@@ -1,3 +0,0 @@
-<claude-mem-context>
-
-</claude-mem-context>