@xnetjs/react 0.1.2 → 0.3.0

package/dist/{chunk-EJ5RW5GI.js → chunk-BDBDZXYS.js}

@@ -1,6 +1,6 @@
 import {
   useNodeStore
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 
 // src/hooks/useUndoScope.ts
 import { UndoManager } from "@xnetjs/history";

package/dist/{chunk-6VOICQZ3.js → chunk-EJEGIEIC.js}

@@ -7,7 +7,7 @@ import {
   useDataBridge,
   useTelemetryReporter,
   useTracingReporter
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 
 // src/utils/flattenNode.ts
 function flattenNode(node, options) {

package/dist/{chunk-QHNYQVUM.js → chunk-Q3NDLI6Z.js}

@@ -2,7 +2,7 @@ import {
   flattenNode,
   useQuery,
   useSyncManager
-} from "./chunk-6VOICQZ3.js";
+} from "./chunk-EJEGIEIC.js";
 import {
   useInstrumentation
 } from "./chunk-JCOFKBOB.js";
@@ -11,7 +11,7 @@ import {
   useNodeStore,
   useXNet,
   useXNetInternal
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 
 // src/hooks/useInfiniteQuery.ts
 import { createQueryDescriptor, serializeQueryDescriptor } from "@xnetjs/data-bridge";

package/dist/{chunk-7OQXRHEQ.js → chunk-QIX3F46C.js}

@@ -1,7 +1,7 @@
 import {
   useMutate,
   useQuery
-} from "./chunk-6VOICQZ3.js";
+} from "./chunk-EJEGIEIC.js";
 import {
   XNetContext,
   downloadBackup,
@@ -9,7 +9,7 @@ import {
   useNodeStore,
   useSecurityContext,
   useXNet
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 
 // src/hooks/useTaskProjectionSync.ts
 import { ExternalReferenceSchema, TaskSchema, isCompletedTaskStatus } from "@xnetjs/data";

package/dist/{chunk-IHTMVTTE.js → chunk-RIN2MXZK.js}

@@ -227,153 +227,11 @@ function createRuntimeStatus(runtime, overrides = {}) {
 }
 
 // src/context.ts
-import { MemoryNodeStorageAdapter, NodeStore } from "@xnetjs/data";
-import {
-  createDataBridge,
-  createMainThreadBridge,
-  MainThreadBridge,
-  WorkerBridge
-} from "@xnetjs/data-bridge";
 import { UndoManager } from "@xnetjs/history";
-import { createUCAN } from "@xnetjs/identity";
 import { PluginRegistry } from "@xnetjs/plugins";
-import React, {
-  createContext as createContext5,
-  useCallback,
-  useContext as useContext5,
-  useEffect as useEffect3,
-  useMemo as useMemo2,
-  useRef,
-  useState as useState3
-} from "react";
-
-// src/hub/auto-backup.ts
-import * as Y from "yjs";
-var AutoBackup = class {
-  constructor(upload, options) {
-    this.upload = upload;
-    this.debounceMs = options?.debounceMs ?? 5e3;
-    this.isEnabled = options?.isEnabled ?? (() => true);
-  }
-  timers = /* @__PURE__ */ new Map();
-  debounceMs;
-  isEnabled;
-  handleDocUpdate(docId, doc) {
-    this.scheduleBackup(docId, doc, this.debounceMs);
-  }
-  handleDocEvict(docId, doc) {
-    this.scheduleBackup(docId, doc, 0);
-  }
-  scheduleBackup(docId, doc, delay) {
-    const existing = this.timers.get(docId);
-    if (existing) {
-      clearTimeout(existing);
-    }
-    const run = async () => {
-      this.timers.delete(docId);
-      if (!this.isEnabled()) return;
-      try {
-        const state = Y.encodeStateAsUpdate(doc);
-        await this.upload(docId, state);
-      } catch (err) {
-        console.warn(`[auto-backup] Failed for ${docId}:`, err);
-      }
-    };
-    if (delay <= 0) {
-      void run();
-      return;
-    }
-    this.timers.set(
-      docId,
-      setTimeout(() => void run(), delay)
-    );
-  }
-  async flush() {
-    for (const timer of this.timers.values()) {
-      clearTimeout(timer);
-    }
-    this.timers.clear();
-  }
-  destroy() {
-    void this.flush();
-  }
-};
-
-// src/hub/backup.ts
-import { concatBytes, decrypt, encrypt, NONCE_SIZE } from "@xnetjs/crypto";
-var toHttpUrl = (hubUrl) => {
-  try {
-    const url = new URL(hubUrl);
-    if (url.protocol === "ws:") url.protocol = "http:";
-    if (url.protocol === "wss:") url.protocol = "https:";
-    return url.toString().replace(/\/$/, "");
-  } catch {
-    return hubUrl;
-  }
-};
-var encodeEncrypted = (encrypted) => concatBytes(encrypted.nonce, encrypted.ciphertext);
-var decodeEncrypted = (payload) => {
-  const nonce = payload.slice(0, NONCE_SIZE);
-  const ciphertext = payload.slice(NONCE_SIZE);
-  return { nonce, ciphertext };
-};
-var resolveFetch = (fetchFn) => {
-  if (fetchFn) return fetchFn;
-  if (typeof fetch === "undefined") {
-    throw new Error("fetch is not available in this environment");
-  }
-  return fetch;
-};
-var buildAuthHeader = async (getAuthToken) => {
-  if (!getAuthToken) return null;
-  const token = await getAuthToken();
-  if (!token) return null;
-  return `Bearer ${token}`;
-};
-async function uploadBackup(config, docId, plaintext) {
-  const encrypted = encrypt(plaintext, config.encryptionKey);
-  const payload = encodeEncrypted(encrypted);
-  return uploadEncryptedBackup(config, docId, payload);
-}
-async function uploadEncryptedBackup(config, docId, payload) {
-  const httpUrl = toHttpUrl(config.hubUrl);
-  const fetcher = resolveFetch(config.fetchFn);
-  const authHeader = await buildAuthHeader(config.getAuthToken);
-  const res = await fetcher(`${httpUrl}/backup/${encodeURIComponent(docId)}`, {
-    method: "PUT",
-    headers: {
-      ...authHeader ? { Authorization: authHeader } : {},
-      "Content-Type": "application/octet-stream"
-    },
-    body: payload
-  });
-  if (!res.ok) {
-    throw new Error(`Backup upload failed: ${res.status} ${res.statusText}`);
-  }
-  return res.json();
-}
-async function downloadBackup(config, docId) {
-  const payload = await downloadEncryptedBackup(config, docId);
-  if (!payload) return null;
-  const encrypted = decodeEncrypted(payload);
-  return decrypt(encrypted, config.encryptionKey);
-}
-async function downloadEncryptedBackup(config, docId) {
-  const httpUrl = toHttpUrl(config.hubUrl);
-  const fetcher = resolveFetch(config.fetchFn);
-  const authHeader = await buildAuthHeader(config.getAuthToken);
-  const res = await fetcher(`${httpUrl}/backup/${encodeURIComponent(docId)}`, {
-    headers: authHeader ? { Authorization: authHeader } : void 0
-  });
-  if (res.status === 404) return null;
-  if (!res.ok) {
-    throw new Error(`Backup download failed: ${res.status} ${res.statusText}`);
-  }
-  return new Uint8Array(await res.arrayBuffer());
-}
+import React, { createContext as createContext5, useContext as useContext5, useEffect as useEffect6, useMemo as useMemo2, useState as useState5 } from "react";
 
-// src/context.ts
-import { createSyncManager } from "@xnetjs/runtime";
+// src/provider/debug.ts
 function log(...args) {
   if (typeof localStorage !== "undefined" && localStorage.getItem("xnet:sync:debug") === "true") {
     console.log("[XNetProvider]", ...args);
@@ -385,16 +243,10 @@ function scheduleIdle(fn) {
   if (typeof ric === "function") ric(fn);
   else setTimeout(fn, 1e3);
 }
-function resolveConfiguredSignalingUrls(hubUrl, signalingServers) {
-  const seen = /* @__PURE__ */ new Set();
-  const configured = hubUrl ? [hubUrl, ...signalingServers ?? []] : signalingServers ?? [];
-  const urls = configured.map((url) => url.trim()).filter((url) => {
-    if (!url || seen.has(url)) return false;
-    seen.add(url);
-    return true;
-  });
-  return urls;
-}
+
+// src/provider/use-hub-auth-token.ts
+import { createUCAN } from "@xnetjs/identity";
+import { useCallback } from "react";
 var HUB_CAPABILITIES = [
   { with: "*", can: "hub/*" },
   { with: "*", can: "backup/*" },
@@ -403,7 +255,112 @@ var HUB_CAPABILITIES = [
   { with: "*", can: "index/*" }
 ];
 var HUB_TOKEN_TTL_SECONDS = 60 * 60 * 24;
+function useHubAuthToken(input) {
+  const { authorDID, signingKey, hubUrl, autoAuth, staticHubAuthToken } = input;
+  return useCallback(async () => {
+    if (staticHubAuthToken) return staticHubAuthToken;
+    if (!hubUrl || !autoAuth) return "";
+    if (!authorDID || !signingKey) {
+      throw new Error("Missing authorDID/signingKey for hub auth");
+    }
+    return createUCAN({
+      issuer: authorDID,
+      issuerKey: signingKey,
+      audience: hubUrl,
+      capabilities: HUB_CAPABILITIES,
+      expiration: Math.floor(Date.now() / 1e3) + HUB_TOKEN_TTL_SECONDS
+    });
+  }, [authorDID, autoAuth, signingKey, hubUrl, staticHubAuthToken]);
+}
+
+// src/provider/use-hub-search-index.ts
+import { useEffect as useEffect3 } from "react";
 var HUB_INDEX_DEBOUNCE_MS = 2e3;
+async function resolveTagSearchText(store, tagIds) {
+  const names = await Promise.all(
+    tagIds.map(async (id) => {
+      const tag = await store.get(id).catch(() => null);
+      const name = tag?.properties?.name;
+      return typeof name === "string" && name ? `#${name}` : null;
+    })
+  );
+  const present = names.filter((entry) => entry !== null);
+  return present.length > 0 ? present.join(" ") : void 0;
+}
+function useHubSearchIndex(input) {
+  const { nodeStore, syncManager, hubUrl, enableSearchIndex } = input;
+  useEffect3(() => {
+    if (!nodeStore || !syncManager || !hubUrl || !enableSearchIndex) return;
+    const connection = syncManager.connection;
+    if (!connection) return;
+    const timers = /* @__PURE__ */ new Map();
+    const pending = /* @__PURE__ */ new Map();
+    const schedule = (docId, payload) => {
+      pending.set(docId, payload);
+      const existing = timers.get(docId);
+      if (existing) clearTimeout(existing);
+      timers.set(
+        docId,
+        setTimeout(() => {
+          timers.delete(docId);
+          const next = pending.get(docId);
+          pending.delete(docId);
+          if (!next) return;
+          if (connection.status !== "connected") return;
+          if (next.type === "remove") {
+            connection.sendRaw({ type: "index-remove", docId });
+            return;
+          }
+          connection.sendRaw({
+            type: "index-update",
+            docId,
+            meta: next.meta,
+            ...next.text !== void 0 ? { text: next.text } : {}
+          });
+        }, HUB_INDEX_DEBOUNCE_MS)
+      );
+    };
+    const handleChange = (event) => {
+      const node = event.node;
+      if (!node || node.deleted) {
+        schedule(event.change.payload.nodeId, { type: "remove" });
+        return;
+      }
+      if (!node.schemaId) return;
+      const title = typeof node.properties.title === "string" ? node.properties.title : typeof node.properties.name === "string" ? node.properties.name : "";
+      const meta = { schemaIri: node.schemaId, title, properties: node.properties };
+      const tagIds = Array.isArray(node.properties.tags) ? node.properties.tags.filter((id) => typeof id === "string") : [];
+      if (tagIds.length === 0) {
+        schedule(node.id, { type: "update", meta });
+        return;
+      }
+      void resolveTagSearchText(nodeStore, tagIds).then((text) => {
+        schedule(node.id, { type: "update", meta, ...text ? { text } : {} });
+      });
+    };
+    const unsubscribe = nodeStore.subscribe(handleChange);
+    return () => {
+      unsubscribe();
+      for (const timer of timers.values()) {
+        clearTimeout(timer);
+      }
+      timers.clear();
+      pending.clear();
+    };
+  }, [enableSearchIndex, hubUrl, nodeStore, syncManager]);
+}
+
+// src/provider/use-node-store-runtime.ts
+import { MemoryNodeStorageAdapter, NodeStore } from "@xnetjs/data";
+import { useEffect as useEffect4, useRef, useState as useState3 } from "react";
+
+// src/provider/runtime-resolution.ts
+import {
+  createDataBridge,
+  createMainThreadBridge,
+  MainThreadBridge,
+  WorkerBridge
+} from "@xnetjs/data-bridge";
 function getRuntimeErrorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
@@ -433,17 +390,6 @@ function logRuntimeStatus(runtime, status) {
   }
   console.info("[XNetProvider] Runtime ready:", status);
 }
-async function resolveTagSearchText(store, tagIds) {
-  const names = await Promise.all(
-    tagIds.map(async (id) => {
-      const tag = await store.get(id).catch(() => null);
-      const name = tag?.properties?.name;
-      return typeof name === "string" && name ? `#${name}` : null;
-    })
-  );
-  const present = names.filter((entry) => entry !== null);
-  return present.length > 0 ? present.join(" ") : void 0;
-}
 function resolveRuntimeFailure(runtime, nodeStore, reason, bridgeOptions) {
   if (runtime.fallback === "main-thread") {
     return {
@@ -568,79 +514,33 @@ async function resolveRuntimeBridge(input) {
     })
   };
 }
-var XNetContext = createContext5(null);
-var XNetInternalContext = createContext5({
-  authorDID: null,
-  signingKey: null,
-  sync: void 0
-});
-var DataBridgeContext = createContext5(null);
-function useDataBridge() {
-  return useContext5(DataBridgeContext);
-}
-function XNetProvider({ config, children }) {
+
+// src/provider/use-node-store-runtime.ts
+function useNodeStoreRuntime(input) {
+  const {
+    authorDID,
+    signingKey,
+    nodeStorage,
+    dataBridge: configDataBridge,
+    remoteNodeQueryClient,
+    remoteNodeQueryRouting,
+    syncManager: configSyncManager,
+    telemetry,
+    hubUrl,
+    signalingUrls,
+    runtimeConfig,
+    runtimeWorkerUrlKey
+  } = input;
   const [nodeStore, setNodeStore] = useState3(null);
   const [nodeStoreReady, setNodeStoreReady] = useState3(false);
-  const [undoManager, setUndoManager] = useState3(null);
   const [dataBridge, setDataBridge] = useState3(null);
-  const [syncManager, setSyncManager] = useState3(null);
-  const [hubStatus, setHubStatus] = useState3("disconnected");
-  const [pluginRegistry, setPluginRegistry] = useState3(null);
   const nodeStorageRef = useRef(null);
-  const platform = config.platform ?? "web";
-  const authorDID = config.authorDID ?? config.identity?.did;
-  const hubUrl = config.hubUrl ?? null;
-  const signalingServersKey = (config.signalingServers ?? []).join("\n");
-  const signalingServers = useMemo2(
-    () => signalingServersKey ? signalingServersKey.split("\n") : [],
-    [signalingServersKey]
-  );
-  const signalingUrls = useMemo2(
-    () => resolveConfiguredSignalingUrls(hubUrl, signalingServers),
-    [hubUrl, signalingServers]
-  );
-  const hubOptions = config.hubOptions;
-  const autoAuth = hubOptions?.autoAuth ?? true;
-  const staticHubAuthToken = hubOptions?.authToken?.trim() ?? "";
-  const autoBackup = hubOptions?.autoBackup ?? false;
-  const backupDebounceMs = hubOptions?.backupDebounceMs ?? 5e3;
-  const enableSearchIndex = hubOptions?.enableSearchIndex ?? false;
-  const nodeSyncRoom = hubOptions?.nodeSyncRoom ?? authorDID ?? "default";
-  const encryptionKey = config.encryptionKey ?? null;
-  const runtimeWorkerUrlKey = config.runtime?.worker?.url ? String(config.runtime.worker.url) : "";
-  const runtimeConfig = useMemo2(
-    () => resolveRuntimeConfig(config.runtime, platform),
-    [
-      config.runtime?.mode,
-      config.runtime?.fallback,
-      config.runtime?.diagnostics,
-      config.runtime?.worker?.dbName,
-      config.runtime?.worker?.signalingUrl,
-      runtimeWorkerUrlKey,
-      platform
-    ]
-  );
   const [runtimeStatus, setRuntimeStatus] = useState3(
     () => createRuntimeStatus(runtimeConfig)
   );
-  const getHubAuthToken = useCallback(async () => {
-    if (staticHubAuthToken) return staticHubAuthToken;
-    if (!hubUrl || !autoAuth) return "";
-    if (!authorDID || !config.signingKey) {
-      throw new Error("Missing authorDID/signingKey for hub auth");
-    }
-    return createUCAN({
-      issuer: authorDID,
-      issuerKey: config.signingKey,
-      audience: hubUrl,
-      capabilities: HUB_CAPABILITIES,
-      expiration: Math.floor(Date.now() / 1e3) + HUB_TOKEN_TTL_SECONDS
-    });
-  }, [authorDID, autoAuth, config.signingKey, hubUrl, staticHubAuthToken]);
-  useEffect3(() => {
-    const nodeStorageAdapter = config.nodeStorage ?? new MemoryNodeStorageAdapter();
+  useEffect4(() => {
+    const nodeStorageAdapter = nodeStorage ?? new MemoryNodeStorageAdapter();
     nodeStorageRef.current = nodeStorageAdapter;
-    const signingKey = config.signingKey;
     setRuntimeStatus(createRuntimeStatus(runtimeConfig));
     if (!authorDID || !signingKey) {
       console.warn(
@@ -673,10 +573,10 @@ function XNetProvider({ config, children }) {
         authorDID,
         signingKey,
         signalingUrl: signalingUrls[0],
-        dataBridge: config.dataBridge,
-        remoteNodeQueryClient: config.remoteNodeQueryClient,
-        remoteNodeQueryRouting: config.remoteNodeQueryRouting,
-        syncManager: config.syncManager
+        dataBridge: configDataBridge,
+        remoteNodeQueryClient,
+        remoteNodeQueryRouting,
+        syncManager: configSyncManager
       });
       if (cancelled) {
         if (resolvedRuntime.createdInternally && resolvedRuntime.bridge) {
@@ -685,16 +585,13 @@ function XNetProvider({ config, children }) {
         return;
       }
       setRuntimeStatus(resolvedRuntime.status);
-      reportRuntimeStatus(config.telemetry, resolvedRuntime.status);
+      reportRuntimeStatus(telemetry, resolvedRuntime.status);
       logRuntimeStatus(runtimeConfig, resolvedRuntime.status);
       if (resolvedRuntime.status.phase !== "ready" || !resolvedRuntime.bridge) {
-        config.telemetry?.reportCrash(
-          new Error(resolvedRuntime.status.reason ?? "Runtime failed"),
-          {
-            codeNamespace: "react.runtime.initialize",
-            requestedMode: resolvedRuntime.status.requestedMode
-          }
-        );
+        telemetry?.reportCrash(new Error(resolvedRuntime.status.reason ?? "Runtime failed"), {
+          codeNamespace: "react.runtime.initialize",
+          requestedMode: resolvedRuntime.status.requestedMode
+        });
         setNodeStore(null);
         setNodeStoreReady(false);
         setDataBridge(null);
@@ -732,43 +629,197 @@ function XNetProvider({ config, children }) {
     };
   }, [
     authorDID,
-    config.nodeStorage,
-    config.signingKey,
-    config.dataBridge,
+    nodeStorage,
+    signingKey,
+    configDataBridge,
     signalingUrls,
-    config.syncManager,
-    config.remoteNodeQueryClient,
-    config.remoteNodeQueryRouting,
-    config.telemetry,
+    configSyncManager,
+    remoteNodeQueryClient,
+    remoteNodeQueryRouting,
+    telemetry,
     hubUrl,
     runtimeConfig,
     runtimeWorkerUrlKey
   ]);
-  useEffect3(() => {
-    if (config.syncManager) {
-      setSyncManager(config.syncManager);
-      const sm2 = config.syncManager;
-      if (sm2.setIdentity && authorDID && config.signingKey) {
-        sm2.setIdentity(authorDID, config.signingKey);
+  return { nodeStore, nodeStoreReady, dataBridge, runtimeStatus, nodeStorageRef };
+}
+
+// src/provider/use-sync-manager.ts
+import { createSyncManager } from "@xnetjs/runtime";
+import { useEffect as useEffect5, useState as useState4 } from "react";
+
+// src/hub/auto-backup.ts
+import * as Y from "yjs";
+var AutoBackup = class {
+  constructor(upload, options) {
+    this.upload = upload;
+    this.debounceMs = options?.debounceMs ?? 5e3;
+    this.isEnabled = options?.isEnabled ?? (() => true);
+  }
+  timers = /* @__PURE__ */ new Map();
+  debounceMs;
+  isEnabled;
+  handleDocUpdate(docId, doc) {
+    this.scheduleBackup(docId, doc, this.debounceMs);
+  }
+  handleDocEvict(docId, doc) {
+    this.scheduleBackup(docId, doc, 0);
+  }
+  scheduleBackup(docId, doc, delay) {
+    const existing = this.timers.get(docId);
+    if (existing) {
+      clearTimeout(existing);
+    }
+    const run = async () => {
+      this.timers.delete(docId);
+      if (!this.isEnabled()) return;
+      try {
+        const state = Y.encodeStateAsUpdate(doc);
+        await this.upload(docId, state);
+      } catch (err) {
+        console.warn(`[auto-backup] Failed for ${docId}:`, err);
+      }
+    };
+    if (delay <= 0) {
+      void run();
+      return;
+    }
+    this.timers.set(
+      docId,
+      setTimeout(() => void run(), delay)
+    );
+  }
+  async flush() {
+    for (const timer of this.timers.values()) {
+      clearTimeout(timer);
+    }
+    this.timers.clear();
+  }
+  destroy() {
+    void this.flush();
+  }
+};
+
+// src/hub/backup.ts
+import { concatBytes, decrypt, encrypt, NONCE_SIZE } from "@xnetjs/crypto";
+var toHttpUrl = (hubUrl) => {
+  try {
+    const url = new URL(hubUrl);
+    if (url.protocol === "ws:") url.protocol = "http:";
+    if (url.protocol === "wss:") url.protocol = "https:";
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return hubUrl;
+  }
+};
+var encodeEncrypted = (encrypted) => concatBytes(encrypted.nonce, encrypted.ciphertext);
+var decodeEncrypted = (payload) => {
+  const nonce = payload.slice(0, NONCE_SIZE);
+  const ciphertext = payload.slice(NONCE_SIZE);
+  return { nonce, ciphertext };
+};
+var resolveFetch = (fetchFn) => {
+  if (fetchFn) return fetchFn;
+  if (typeof fetch === "undefined") {
+    throw new Error("fetch is not available in this environment");
+  }
+  return fetch;
+};
+var buildAuthHeader = async (getAuthToken) => {
+  if (!getAuthToken) return null;
+  const token = await getAuthToken();
+  if (!token) return null;
+  return `Bearer ${token}`;
+};
+async function uploadBackup(config, docId, plaintext) {
+  const encrypted = encrypt(plaintext, config.encryptionKey);
+  const payload = encodeEncrypted(encrypted);
+  return uploadEncryptedBackup(config, docId, payload);
+}
+async function uploadEncryptedBackup(config, docId, payload) {
+  const httpUrl = toHttpUrl(config.hubUrl);
+  const fetcher = resolveFetch(config.fetchFn);
+  const authHeader = await buildAuthHeader(config.getAuthToken);
+  const res = await fetcher(`${httpUrl}/backup/${encodeURIComponent(docId)}`, {
+    method: "PUT",
+    headers: {
+      ...authHeader ? { Authorization: authHeader } : {},
+      "Content-Type": "application/octet-stream"
+    },
+    body: payload
+  });
+  if (!res.ok) {
+    throw new Error(`Backup upload failed: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+async function downloadBackup(config, docId) {
+  const payload = await downloadEncryptedBackup(config, docId);
+  if (!payload) return null;
+  const encrypted = decodeEncrypted(payload);
+  return decrypt(encrypted, config.encryptionKey);
+}
+async function downloadEncryptedBackup(config, docId) {
+  const httpUrl = toHttpUrl(config.hubUrl);
+  const fetcher = resolveFetch(config.fetchFn);
+  const authHeader = await buildAuthHeader(config.getAuthToken);
+  const res = await fetcher(`${httpUrl}/backup/${encodeURIComponent(docId)}`, {
+    headers: authHeader ? { Authorization: authHeader } : void 0
+  });
+  if (res.status === 404) return null;
+  if (!res.ok) {
+    throw new Error(`Backup download failed: ${res.status} ${res.statusText}`);
+  }
+  return new Uint8Array(await res.arrayBuffer());
+}
+
+// src/provider/use-sync-manager.ts
+function useSyncManagerLifecycle(input) {
+  const {
+    nodeStore,
+    nodeStoreReady,
+    nodeStorageRef,
+    externalSyncManager,
+    disableSyncManager,
+    signalingUrls,
+    authorDID,
+    signingKey,
+    sync,
+    blobStore,
+    hubUrl,
+    nodeSyncRoom,
+    autoAuth,
+    autoBackup,
+    backupDebounceMs,
+    encryptionKey,
+    getHubAuthToken
+  } = input;
+  const [syncManager, setSyncManager] = useState4(null);
+  useEffect5(() => {
+    if (externalSyncManager) {
+      setSyncManager(externalSyncManager);
+      const sm2 = externalSyncManager;
+      if (sm2.setIdentity && authorDID && signingKey) {
+        sm2.setIdentity(authorDID, signingKey);
       }
       if (sm2.configureReplication) {
-        sm2.configureReplication(config.sync);
+        sm2.configureReplication(sync);
       }
-      config.syncManager.start().catch((err) => {
+      externalSyncManager.start().catch((err) => {
         console.warn("[XNetProvider] External SyncManager failed to start:", err);
       });
       return () => {
-        config.syncManager.stop().catch((err) => {
+        externalSyncManager.stop().catch((err) => {
           console.warn("[XNetProvider] External SyncManager failed to stop:", err);
         });
         setSyncManager(null);
       };
     }
-    if (!nodeStore || !nodeStoreReady || config.disableSyncManager) {
+    if (!nodeStore || !nodeStoreReady || disableSyncManager) {
       log("SyncManager disabled or NodeStore not ready", {
         nodeStore: !!nodeStore,
         nodeStoreReady,
-        disableSyncManager: config.disableSyncManager
+        disableSyncManager
       });
       setSyncManager(null);
       return;
@@ -779,7 +830,7 @@ function XNetProvider({ config, children }) {
       return;
     }
     const signalingUrl = signalingUrls[0] ?? "";
-    if (autoAuth && hubUrl && (!authorDID || !config.signingKey)) {
+    if (autoAuth && hubUrl && (!authorDID || !signingKey)) {
       console.warn("[XNetProvider] Hub auth enabled but authorDID/signingKey missing");
     }
     if (autoBackup && (!hubUrl || !encryptionKey)) {
@@ -795,9 +846,9 @@ function XNetProvider({ config, children }) {
       signalingUrl,
       signalingUrls,
       authorDID,
-      signingKey: config.signingKey,
-      replication: config.sync,
-      blobStore: config.blobStore,
+      signingKey,
+      replication: sync,
+      blobStore,
       nodeSyncRoom: hubUrl ? nodeSyncRoom : void 0,
       getUCANToken: hubUrl ? getHubAuthToken : void 0,
       onDocUpdate: enableAutoBackup ? (nodeId, doc) => {
@@ -845,11 +896,11 @@ function XNetProvider({ config, children }) {
   }, [
     nodeStore,
     nodeStoreReady,
-    config.disableSyncManager,
-    config.syncManager,
+    disableSyncManager,
+    externalSyncManager,
     signalingUrls,
-    config.blobStore,
-    config.sync,
+    blobStore,
+    sync,
     authorDID,
     autoAuth,
     autoBackup,
@@ -857,9 +908,14 @@ function XNetProvider({ config, children }) {
     encryptionKey,
     getHubAuthToken,
     hubUrl,
-    nodeSyncRoom
+    nodeSyncRoom,
+    nodeStorageRef,
+    signingKey
   ]);
-  useEffect3(() => {
+  return syncManager;
+}
+function useBridgeSyncWiring(dataBridge, syncManager) {
+  useEffect5(() => {
     if (!dataBridge || !syncManager) return;
     const bridge = dataBridge;
     if (typeof bridge.setSyncManager === "function") {
@@ -872,7 +928,10 @@ function XNetProvider({ config, children }) {
       }
     };
   }, [dataBridge, syncManager]);
-  useEffect3(() => {
+}
+function useHubStatus(syncManager) {
+  const [hubStatus, setHubStatus] = useState4("disconnected");
+  useEffect5(() => {
     if (!syncManager) {
       setHubStatus("disconnected");
       return;
@@ -882,66 +941,110 @@ function XNetProvider({ config, children }) {
       setHubStatus(status);
     });
   }, [syncManager]);
-  useEffect3(() => {
-    if (!nodeStore || !syncManager || !hubUrl || !enableSearchIndex) return;
-    const connection = syncManager.connection;
-    if (!connection) return;
-    const timers = /* @__PURE__ */ new Map();
-    const pending = /* @__PURE__ */ new Map();
-    const schedule = (docId, payload) => {
-      pending.set(docId, payload);
-      const existing = timers.get(docId);
-      if (existing) clearTimeout(existing);
-      timers.set(
-        docId,
-        setTimeout(() => {
-          timers.delete(docId);
-          const next = pending.get(docId);
-          pending.delete(docId);
-          if (!next) return;
-          if (connection.status !== "connected") return;
-          if (next.type === "remove") {
-            connection.sendRaw({ type: "index-remove", docId });
-            return;
-          }
-          connection.sendRaw({
-            type: "index-update",
-            docId,
-            meta: next.meta,
-            ...next.text !== void 0 ? { text: next.text } : {}
-          });
-        }, HUB_INDEX_DEBOUNCE_MS)
-      );
-    };
-    const handleChange = (event) => {
-      const node = event.node;
-      if (!node || node.deleted) {
-        schedule(event.change.payload.nodeId, { type: "remove" });
-        return;
-      }
-      if (!node.schemaId) return;
-      const title = typeof node.properties.title === "string" ? node.properties.title : typeof node.properties.name === "string" ? node.properties.name : "";
-      const meta = { schemaIri: node.schemaId, title, properties: node.properties };
-      const tagIds = Array.isArray(node.properties.tags) ? node.properties.tags.filter((id) => typeof id === "string") : [];
-      if (tagIds.length === 0) {
-        schedule(node.id, { type: "update", meta });
-        return;
-      }
-      void resolveTagSearchText(nodeStore, tagIds).then((text) => {
-        schedule(node.id, { type: "update", meta, ...text ? { text } : {} });
-      });
-    };
-    const unsubscribe = nodeStore.subscribe(handleChange);
-    return () => {
-      unsubscribe();
-      for (const timer of timers.values()) {
-        clearTimeout(timer);
-      }
-      timers.clear();
-      pending.clear();
-    };
-  }, [enableSearchIndex, hubUrl, nodeStore, syncManager]);
-  useEffect3(() => {
+  return hubStatus;
+}
+
+// src/context.ts
+function resolveConfiguredSignalingUrls(hubUrl, signalingServers) {
+  const seen = /* @__PURE__ */ new Set();
+  const configured = hubUrl ? [hubUrl, ...signalingServers ?? []] : signalingServers ?? [];
+  const urls = configured.map((url) => url.trim()).filter((url) => {
+    if (!url || seen.has(url)) return false;
+    seen.add(url);
+    return true;
+  });
+  return urls;
+}
+var XNetContext = createContext5(null);
+var XNetInternalContext = createContext5({
+  authorDID: null,
+  signingKey: null,
+  sync: void 0
+});
+var DataBridgeContext = createContext5(null);
+function useDataBridge() {
+  return useContext5(DataBridgeContext);
+}
+function XNetProvider({ config, children }) {
+  const [undoManager, setUndoManager] = useState5(null);
+  const [pluginRegistry, setPluginRegistry] = useState5(null);
+  const platform = config.platform ?? "web";
+  const authorDID = config.authorDID ?? config.identity?.did;
+  const hubUrl = config.hubUrl ?? null;
+  const signalingServersKey = (config.signalingServers ?? []).join("\n");
+  const signalingServers = useMemo2(
+    () => signalingServersKey ? signalingServersKey.split("\n") : [],
+    [signalingServersKey]
+  );
+  const signalingUrls = useMemo2(
+    () => resolveConfiguredSignalingUrls(hubUrl, signalingServers),
+    [hubUrl, signalingServers]
+  );
+  const hubOptions = config.hubOptions;
+  const autoAuth = hubOptions?.autoAuth ?? true;
+  const staticHubAuthToken = hubOptions?.authToken?.trim() ?? "";
+  const autoBackup = hubOptions?.autoBackup ?? false;
+  const backupDebounceMs = hubOptions?.backupDebounceMs ?? 5e3;
+  const enableSearchIndex = hubOptions?.enableSearchIndex ?? false;
+  const nodeSyncRoom = hubOptions?.nodeSyncRoom ?? authorDID ?? "default";
+  const encryptionKey = config.encryptionKey ?? null;
+  const runtimeWorkerUrlKey = config.runtime?.worker?.url ? String(config.runtime.worker.url) : "";
+  const runtimeConfig = useMemo2(
+    () => resolveRuntimeConfig(config.runtime, platform),
+    [
+      config.runtime?.mode,
+      config.runtime?.fallback,
+      config.runtime?.diagnostics,
+      config.runtime?.worker?.dbName,
+      config.runtime?.worker?.signalingUrl,
+      runtimeWorkerUrlKey,
+      platform
+    ]
+  );
+  const getHubAuthToken = useHubAuthToken({
+    authorDID,
+    signingKey: config.signingKey,
+    hubUrl,
+    autoAuth,
+    staticHubAuthToken
+  });
+  const { nodeStore, nodeStoreReady, dataBridge, runtimeStatus, nodeStorageRef } = useNodeStoreRuntime({
+    authorDID,
+    signingKey: config.signingKey,
+    nodeStorage: config.nodeStorage,
+    dataBridge: config.dataBridge,
+    remoteNodeQueryClient: config.remoteNodeQueryClient,
+    remoteNodeQueryRouting: config.remoteNodeQueryRouting,
+    syncManager: config.syncManager,
+    telemetry: config.telemetry,
+    hubUrl,
+    signalingUrls,
+    runtimeConfig,
+    runtimeWorkerUrlKey
+  });
+  const syncManager = useSyncManagerLifecycle({
+    nodeStore,
+    nodeStoreReady,
+    nodeStorageRef,
+    externalSyncManager: config.syncManager,
+    disableSyncManager: config.disableSyncManager,
+    signalingUrls,
+    authorDID,
+    signingKey: config.signingKey,
+    sync: config.sync,
+    blobStore: config.blobStore,
+    hubUrl,
+    nodeSyncRoom,
+    autoAuth,
+    autoBackup,
+    backupDebounceMs,
+    encryptionKey,
+    getHubAuthToken
+  });
+  useBridgeSyncWiring(dataBridge, syncManager);
+  const hubStatus = useHubStatus(syncManager);
+  useHubSearchIndex({ nodeStore, syncManager, hubUrl, enableSearchIndex });
+  useEffect6(() => {
     if (!nodeStore || !nodeStoreReady || config.disablePlugins) {
       log("PluginRegistry disabled or NodeStore not ready");
       setPluginRegistry(null);
@@ -965,7 +1068,7 @@ function XNetProvider({ config, children }) {
       setPluginRegistry(null);
     };
   }, [nodeStore, nodeStoreReady, config.disablePlugins, config.platform]);
-  useEffect3(() => {
+  useEffect6(() => {
     if (!nodeStore || !nodeStoreReady || !authorDID) {
       setUndoManager(null);
       return;

package/dist/{chunk-KSHTDZ2V.js → chunk-WL7OCTSM.js}

@@ -1,6 +1,6 @@
 import {
   useNodeStore
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 
 // src/hooks/useDatabaseDoc.ts
 import {

package/dist/core.d.ts

@@ -5,11 +5,11 @@ import { QueryPageInfo } from '@xnetjs/data-bridge';
 import { Awareness } from 'y-protocols/awareness';
 import * as Y from 'yjs';
 import { Identity } from '@xnetjs/identity';
-export { f as XNetConfig, X as XNetContextValue, e as XNetProvider, g as XNetProviderProps, h as XNetRuntimeConfig, i as XNetRuntimeFallback, j as XNetRuntimeMode, k as XNetRuntimePhase, d as XNetRuntimeStatus, l as XNetRuntimeWorkerConfig, a as useXNet } from './context-CFu9i136.js';
+export { f as XNetConfig, X as XNetContextValue, e as XNetProvider, g as XNetProviderProps, h as XNetRuntimeConfig, i as XNetRuntimeFallback, j as XNetRuntimeMode, k as XNetRuntimePhase, d as XNetRuntimeStatus, l as XNetRuntimeWorkerConfig, a as useXNet } from './context-aeFzX2eW.js';
 import { Component, ReactNode, ErrorInfo } from 'react';
 import '@xnetjs/core';
-import '@xnetjs/runtime';
 import '@xnetjs/crypto';
+import '@xnetjs/runtime';
 import '@xnetjs/sync';
 import '@xnetjs/history';
 import '@xnetjs/plugins';

package/dist/core.js

@@ -5,16 +5,16 @@ import {
   useInfiniteQuery,
   useIsOffline,
   useNode
-} from "./chunk-QHNYQVUM.js";
+} from "./chunk-Q3NDLI6Z.js";
 import {
   useMutate,
   useQuery
-} from "./chunk-6VOICQZ3.js";
+} from "./chunk-EJEGIEIC.js";
 import "./chunk-JCOFKBOB.js";
 import {
   XNetProvider,
   useXNet
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 export {
   ErrorBoundary,
   OfflineIndicator,

package/dist/database.js

@@ -6,8 +6,8 @@ import {
   useDatabaseSchema,
   useRelatedRows,
   useReverseRelations
-} from "./chunk-KSHTDZ2V.js";
-import "./chunk-IHTMVTTE.js";
+} from "./chunk-WL7OCTSM.js";
+import "./chunk-RIN2MXZK.js";
 export {
   useCell,
   useDatabase,

package/dist/experimental.js

@@ -73,14 +73,14 @@ import {
   useUndo,
   useVerification,
   useVisibleComments
-} from "./chunk-7OQXRHEQ.js";
+} from "./chunk-QIX3F46C.js";
 import {
   flattenNode,
   flattenNodes,
   flattenNodesWithSchemaCheck,
   flattenUnknownSchemaNode,
   useSyncManager
-} from "./chunk-6VOICQZ3.js";
+} from "./chunk-EJEGIEIC.js";
 import {
   InstrumentationContext,
   useInstrumentation
@@ -104,7 +104,7 @@ import {
   useTelemetryReporter,
   useView,
   useViews
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 
 // src/experimental.ts
 import { WebSocketSyncProvider } from "@xnetjs/runtime";

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export { DatabaseRow, DatabaseRowData, ReverseRelation, UseCellOptions, UseCellR
 export { u as useNodeStore } from './useNodeStore-DTCSBF51.js';
 export { BlobStoreForSync, ConnectionManager, ConnectionManagerConfig, ConnectionStatus, InitialSyncManager, InitialSyncMessage, METABRIDGE_ORIGIN, METABRIDGE_SEED_ORIGIN, MetaBridge, MultiHubConnectionManagerConfig, NodePool, NodePoolConfig, NodeStoreSyncProvider, NodeSyncResponse, OfflineQueue, OfflineQueueConfig, PoolEntryState, ProgressListener, QueueEntry, Registry, RegistryConfig, RegistryStorage, SerializedNodeChange, SyncManager, SyncManagerConfig, SyncStatus as SyncManagerStatus, SyncPhase, SyncProgress, SyncReconciliationOptions, SyncReconciliationReport, TrackedNode, WebSocketSyncProvider, WebSocketSyncProviderOptions, createConnectionManager, createInitialSyncManager, createMetaBridge, createMultiHubConnectionManager, createNodePool, createOfflineQueue, createRegistry, createSyncManager } from '@xnetjs/runtime';
 import { Subscription, Customer, Invoice, Payment } from '@xnetjs/billing';
-export { n as TRACE_STAGES, s as TracingAttributes, T as TracingContext, p as TracingHandle, o as TracingReporter, r as TracingRootKind, q as TracingSpanInput, f as XNetConfig, X as XNetContextValue, e as XNetProvider, g as XNetProviderProps, h as XNetRuntimeConfig, i as XNetRuntimeFallback, j as XNetRuntimeMode, k as XNetRuntimePhase, d as XNetRuntimeStatus, l as XNetRuntimeWorkerConfig, u as useDataBridge, m as useTracingReporter, a as useXNet } from './context-CFu9i136.js';
+export { n as TRACE_STAGES, s as TracingAttributes, T as TracingContext, p as TracingHandle, o as TracingReporter, r as TracingRootKind, q as TracingSpanInput, f as XNetConfig, X as XNetContextValue, e as XNetProvider, g as XNetProviderProps, h as XNetRuntimeConfig, i as XNetRuntimeFallback, j as XNetRuntimeMode, k as XNetRuntimePhase, d as XNetRuntimeStatus, l as XNetRuntimeWorkerConfig, u as useDataBridge, m as useTracingReporter, a as useXNet } from './context-aeFzX2eW.js';
 export { I as InstrumentationContext, a as InstrumentationContextValue, Q as QueryTrackerLike, Y as YDocRegistryLike, u as useInstrumentation } from './instrumentation-CpIuG2y5.js';
 export { a as TelemetryContext, T as TelemetryReporter, u as useTelemetryReporter } from './telemetry-context-B7r6H1KW.js';
 import '@xnetjs/core';

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   useInfiniteQuery,
   useIsOffline,
   useNode
-} from "./chunk-QHNYQVUM.js";
+} from "./chunk-Q3NDLI6Z.js";
 import {
   useCell,
   useDatabase,
@@ -14,7 +14,7 @@ import {
   useDatabaseSchema,
   useRelatedRows,
   useReverseRelations
-} from "./chunk-KSHTDZ2V.js";
+} from "./chunk-WL7OCTSM.js";
 import {
   AuthErrorScreen,
   AuthenticatingScreen,
@@ -94,7 +94,7 @@ import {
   useUndo,
   useVerification,
   useVisibleComments
-} from "./chunk-7OQXRHEQ.js";
+} from "./chunk-QIX3F46C.js";
 import {
   EMPTY_PAGE_INFO,
   computeFallbackPageInfo,
@@ -106,10 +106,10 @@ import {
   useMutate,
   useQuery,
   useSyncManager
-} from "./chunk-6VOICQZ3.js";
+} from "./chunk-EJEGIEIC.js";
 import {
   useUndoScope
-} from "./chunk-EJ5RW5GI.js";
+} from "./chunk-BDBDZXYS.js";
 import {
   InstrumentationContext,
   useInstrumentation
@@ -142,7 +142,7 @@ import {
   useView,
   useViews,
   useXNet
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 
 // src/hooks/useEffectiveSchema.ts
 import {

package/dist/internal.d.ts

@@ -3,13 +3,13 @@ import { DID } from '@xnetjs/core';
 import { NodeId } from '@xnetjs/data';
 import { UndoManagerOptions } from '@xnetjs/history';
 export { I as InstrumentationContext, a as InstrumentationContextValue, Q as QueryTrackerLike, Y as YDocRegistryLike, u as useInstrumentation } from './instrumentation-CpIuG2y5.js';
-export { X as XNetContextValue, c as XNetInternalContextValue, d as XNetRuntimeStatus, u as useDataBridge, a as useXNet, b as useXNetInternal } from './context-CFu9i136.js';
+export { X as XNetContextValue, c as XNetInternalContextValue, d as XNetRuntimeStatus, u as useDataBridge, a as useXNet, b as useXNetInternal } from './context-aeFzX2eW.js';
 import 'react';
 import '@xnetjs/data-bridge';
 import 'yjs';
-import '@xnetjs/runtime';
 import '@xnetjs/crypto';
 import '@xnetjs/identity';
+import '@xnetjs/runtime';
 import '@xnetjs/sync';
 import '@xnetjs/plugins';
 import './telemetry-context-B7r6H1KW.js';

package/dist/internal.js

@@ -1,6 +1,6 @@
 import {
   useUndoScope
-} from "./chunk-EJ5RW5GI.js";
+} from "./chunk-BDBDZXYS.js";
 import {
   InstrumentationContext,
   useInstrumentation
@@ -10,7 +10,7 @@ import {
   useNodeStore,
   useXNet,
   useXNetInternal
-} from "./chunk-IHTMVTTE.js";
+} from "./chunk-RIN2MXZK.js";
 export {
   InstrumentationContext,
   useDataBridge,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/react",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -46,15 +46,15 @@
     "y-protocols": "^1.0.6",
     "yjs": "^13.6.24",
     "@xnetjs/billing": "0.0.2",
-    "@xnetjs/core": "0.1.2",
-    "@xnetjs/crypto": "0.1.2",
-    "@xnetjs/data": "0.1.2",
-    "@xnetjs/data-bridge": "0.1.2",
-    "@xnetjs/history": "0.1.2",
-    "@xnetjs/identity": "0.1.2",
-    "@xnetjs/plugins": "0.1.2",
-    "@xnetjs/runtime": "0.1.2",
-    "@xnetjs/sync": "0.1.2"
+    "@xnetjs/core": "0.3.0",
+    "@xnetjs/crypto": "0.3.0",
+    "@xnetjs/data": "0.3.0",
+    "@xnetjs/data-bridge": "0.3.0",
+    "@xnetjs/history": "0.3.0",
+    "@xnetjs/identity": "0.3.0",
+    "@xnetjs/plugins": "0.3.0",
+    "@xnetjs/runtime": "0.1.4",
+    "@xnetjs/sync": "0.3.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"

package/dist/{context-CFu9i136.d.ts → context-aeFzX2eW.d.ts}

@@ -1,8 +1,8 @@
-import { SyncManager, BlobStoreForSync, SyncStatus, ConnectionManager } from '@xnetjs/runtime';
 import { DID } from '@xnetjs/core';
 import { SecurityLevel } from '@xnetjs/crypto';
 import { NodeStorageAdapter, NodeStore } from '@xnetjs/data';
 import { Identity, PQKeyRegistry, HybridKeyBundle } from '@xnetjs/identity';
+import { SyncManager, BlobStoreForSync, SyncStatus, ConnectionManager } from '@xnetjs/runtime';
 import { SyncReplicationConfig } from '@xnetjs/sync';
 import * as react from 'react';
 import { ReactNode } from 'react';