@xnetjs/react 0.2.0 → 0.4.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

@@ -3,7 +3,7 @@ export { i as FlattenNodeOptions, M as MigrationWarning, c as QueryListResult, d
 export { ErrorBoundary, ErrorBoundaryProps, InfiniteQueryFilter, InfiniteQueryPage, InfiniteQueryResult, MutateCreate, MutateDelete, MutateOp, MutateRestore, MutateUpdate, OfflineIndicator, OfflineIndicatorProps, PresenceUser, SyncStatus, UseIdentityResult, UseMutateResult, UseNodeOptions, UseNodeResult, useIdentity, useInfiniteQuery, useIsOffline, useMutate, useNode } from './core.js';
 import { U as UseTaskProjectionSyncResult, T as TaskProjectionInput, a as TaskTreeItem } from './experimental-B2FrBnkV.js';
 export { A as AddCommentOptions, a0 as AddReactionOptions, bm as AuthErrorScreen, aP as AuthTraceSummary, bl as AuthenticatingScreen, r as CommentNode, C as CommentThread, F as CommentVisibility, ad as CreateMessageRequestOptions, b7 as DemoBanner, b8 as DemoBannerProps, bb as DemoDataExpiredScreen, be as DemoLimits, bd as DemoModeState, b9 as DemoQuotaIndicator, ba as DemoQuotaIndicatorProps, bf as DemoUsage, b2 as DiscoveredPeer, aU as FileRef, ae as FirstContactAdmission, af as FirstContactDecision, ag as FirstContactDecisionInput, G as FirstContactMode, ah as FirstContactVisibility, aK as GrantConsentSummary, aL as GrantInput, bp as HubConnectScreen, aX as HubSearchOptions, aY as HubSearchResult, aZ as HubSearchState, b3 as HubStatusIndicator, bo as ImportIdentityScreen, I as InteractionPermission, ai as MessageRequestNode, aj as MessageRequestProperties, ak as MessageRequestStatus, M as ModeratedCommentNode, H as ModeratedCommentThread, J as ModerationFilterOptions, K as ModerationLabelSummary, bA as OnboardingContextValue, bD as OnboardingEvent, bj as OnboardingFlow, bB as OnboardingFlowProps, bE as OnboardingMachineContext, bh as OnboardingProvider, bz as OnboardingProviderProps, bF as OnboardingReducerState, bC as OnboardingState, P as PageTaskInput, e as PageTaskReferenceInput, bI as PageTasksPanel, bJ as PageTasksPanelProps, bW as PluginRegistryContext, L as PublicInteractionMode, N as PublicInteractionPolicySnapshot, O as PublicInteractionSurface, Q as PublicModerationMode, bv as QUICK_START_TEMPLATES, bG as QuickStartTemplate, a1 as ReactionCounterSnapshot, a2 as ReactionNode, a3 as ReactionType, bq as ReadyScreen, a$ as RemoteSchemaDefinition, b0 as RemoteSchemaState, R as ReplyContext, bQ as SecurityContextActions, bP as SecurityContextState, bR as SecurityContextValue, bM as SecurityProvider, bS as SecurityProviderProps, b4 as Skeleton, b6 as SkeletonProps, br as SmartWelcome, bs as SyncProgressOverlay, bH as SyncProgressOverlayProps, bK as TaskCollectionEmbed, bL as TaskCollectionEmbedProps, j as TaskProjectionHost, i as TaskProjectionReferenceInput, bn as UnsupportedBrowserScreen, aw as UseAuditOptions, av as UseAuditResult, aQ as UseAuthTraceResult, aS as UseBackupReturn, aA as UseBlameResult, aH as UseCanEditResult, aF as UseCanResult, p as UseCommentsOptions, q as UseCommentsResult, ay as UseDiffResult, aV as UseFileUploadReturn, b as UseFindOptions, c as UseFindResult, aM as UseGrantsResult, aq as UseHistoryResult, al as UseMessageRequestsOptions, am as UseMessageRequestsResult, S as UseModeratedThreadOptions, f as UsePageTaskSyncOptions, g as UsePageTaskSyncResult, a4 as UsePolicyFilteredReactionCountersOptions, a5 as UsePolicyFilteredReactionCountersResult, bU as UseSecurityOptions, bV as UseSecurityResult, k as UseTaskProjectionSyncOptions, m as UseTasksOptions, n as UseTasksResult, at as UseUndoOptions, as as UseUndoResult, aC as UseVerificationResult, V as UseVisibleCommentsOptions, W as UseVisibleCommentsResult, bk as WelcomeScreen, by as copyToClipboard, a7 as createConversationKey, bu as createInitialState, a8 as createMessageRequestProperties, v as createModerationLabelIndex, Y as createReactionCounterSnapshot, Z as dedupeReactions, aI as describeGrantConsent, w as evaluateCommentModeration, a9 as evaluateFirstContactDecision, x as evaluateInteractionPermission, aa as findLatestMessageRequest, bw as getPlatformAuthName, ab as hasAcceptedContact, b5 as injectSkeletonStyles, _ as isReactionVisible, y as moderateThread, bt as onboardingReducer, z as selectActiveInteractionPolicy, B as selectPublicInteractionMode, aN as summarizeAuthTrace, ac as summarizeMessageRequest, D as summarizeModerationLabel, E as summarizePublicInteractionPolicy, $ as summarizeReactionNode, bx as truncateDid, au as useAudit, aO as useAuthTrace, aR as useBackup, az as useBlame, aE as useCan, aG as useCanEdit, c7 as useCommand, c0 as useCommands, an as useCommentCount, ao as useCommentCounts, o as useComments, b_ as useContributions, bc as useDemoMode, ax as useDiff, c4 as useEditorExtensions, c5 as useEditorExtensionsSafe, aT as useFileUpload, u as useFind, aJ as useGrants, ap as useHistory, aW as useHubSearch, aD as useHubStatus, c3 as useImporters, a6 as useMessageRequests, t as useModeratedThread, bi as useOnboarding, d as usePageTaskSync, b1 as usePeerDiscovery, bX as usePluginRegistry, bY as usePluginRegistryOptional, bZ as usePlugins, X as usePolicyFilteredReactionCounters, a_ as useRemoteSchema, bT as useSecurity, bN as useSecurityContext, bO as useSecurityContextOptional, c2 as useSidebarItems, c1 as useSlashCommands, bg as useSyncManager, h as useTaskProjectionSync, l as useTasks, ar as useUndo, aB as useVerification, c6 as useView, b$ as useViews, s as useVisibleComments } from './experimental-B2FrBnkV.js';
-import { SchemaIRI, Schema, SavedViewDescriptor, DefinedSchema, PropertyBuilder, QueryASTOrderBy, QueryASTPage, QueryASTValidationResult, QueryASTPlannerGate, QueryASTAggregateExecution, ExternalReferenceProvider, SavedViewFeedLayout, SavedViewFeedDensity, FieldType, FieldConfig, ViewType, FilterGroup, SortConfig, RowHeight, SummaryFunction, CellValue } from '@xnetjs/data';
+import { SchemaIRI, Schema, SavedViewDescriptor, DefinedSchema, PropertyBuilder, QueryASTOrderBy, QueryASTPage, QueryASTValidationResult, QueryASTPlannerGate, QueryASTAggregateExecution, ExternalReferenceProvider, SavedViewFeedLayout, SavedViewFeedDensity, FieldType, FieldConfig, ViewType, FilterGroup, SortConfig, RowHeight, SummaryFunction, FormViewConfig, FormFieldRule, CellValue, FormSubmissionMeta } from '@xnetjs/data';
 export { ColumnConfig, ColumnDefinition, ColumnType, SavedViewFeedDensity, SavedViewFeedLayout, ViewConfig, ViewType } from '@xnetjs/data';
 import { QueryExecutionMode, QuerySourcePreference, QuerySearchFilter, QueryPageInfo, QueryMetadata } from '@xnetjs/data-bridge';
 import { LucideIcon } from 'lucide-react';
@@ -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';
@@ -520,12 +520,22 @@ interface GridViewModel {
     rowHeight: RowHeight;
     columnSummaries: Record<string, SummaryFunction>;
     sortKey: string;
+    formConfig: FormViewConfig | null;
+    formRules: Record<string, FormFieldRule>;
+    formAccepting: boolean;
 }
 interface GridRowModel {
     id: string;
     sortKey: string;
     cells: Record<string, CellValue>;
 }
+/** Options for `addRow` (exploration 0278: form submissions). */
+interface AddRowOptions {
+    /** Explicit node id — deterministic ids make retried submissions upsert. */
+    id?: string;
+    /** Form-submission provenance stamped on the row. */
+    meta?: FormSubmissionMeta;
+}
 interface UseGridDatabaseOptions {
     /** Active view ID (defaults to the first view) */
     viewId?: string;
@@ -556,7 +566,7 @@ interface UseGridDatabaseResult {
         rowId: string;
         fieldId: string;
     }>) => Promise<void>;
-    addRow: (afterRowId?: string, cells?: Record<string, CellValue>) => Promise<string | null>;
+    addRow: (afterRowId?: string, cells?: Record<string, CellValue>, opts?: AddRowOptions) => Promise<string | null>;
     deleteRows: (rowIds: string[]) => Promise<void>;
     moveRowToIndex: (rowId: string, targetIndex: number) => Promise<void>;
     addField: (name: string, type: FieldType, config?: FieldConfig, opts?: {
@@ -576,6 +586,9 @@ interface UseGridDatabaseResult {
     setGroupBy: (fieldId: string | null) => Promise<void>;
     setRowHeight: (rowHeight: RowHeight) => Promise<void>;
     setColumnSummary: (fieldId: string, fn: SummaryFunction) => Promise<void>;
+    setFormConfig: (config: FormViewConfig) => Promise<void>;
+    setFormRules: (rules: Record<string, FormFieldRule>) => Promise<void>;
+    setFormAccepting: (accepting: boolean) => Promise<void>;
     addView: (name: string, type: ViewType) => Promise<string | null>;
     renameView: (viewId: string, name: string) => Promise<void>;
     removeView: (viewId: string) => Promise<void>;
@@ -680,4 +693,4 @@ declare function flattenTaskTree(items: TaskTreeItem[], depth?: number): Rendera
 declare function formatTaskDueDate(timestamp: number | undefined): string | null;
 declare function isTaskOverdue(timestamp: number | undefined, completed: boolean): boolean;
 
-export { type CanvasTaskInput, type CheckoutOptions, FlatNode, type GridFieldModel, type GridOptionModel, type GridRowModel, type GridViewModel, QueryFilter, type RenderableTaskRow, type SavedViewCanvasProjectionNode, type SavedViewDateBrushSelection, type SavedViewDateBucketFieldSummary, type SavedViewDateBucketInterval, type SavedViewDateBucketSummary, type SavedViewFacetSelection, type SavedViewFacetSummary, type SavedViewFacetValueSummary, type SavedViewFeedEnrichmentAdapter, type SavedViewFeedEnrichmentEntry, type SavedViewInspectorItem, type SavedViewInspectorItemKind, type SavedViewLensDraft, type SavedViewPresentationMode, type SavedViewPrivacyChip, type SavedViewPrivacyChipTone, type SavedViewPrivacySummary, type SavedViewQueryOverride, type SavedViewQueryResult, SavedViewResultTable, type SavedViewResultTableProps, type SavedViewRowInspectorModel, SavedViewRunner, type SavedViewRunnerProps, type SavedViewSchemaRegistry, type SavedViewSortDirection, type SavedViewVisualCanvasProjectionRequest, SavedViewVisualFeed, type SavedViewVisualLayoutId, type SavedViewVisualLayoutOption, type SavedViewVisualPreviewCreator, type SavedViewVisualPreviewKind, type SavedViewVisualPreviewModel, type SavedViewVisualPreviewPrivacy, type SavedViewVisualPreviewRelationship, type SavedViewVisualTimelineBucket, type SavedViewVisualWorkspaceLayout, TaskProjectionInput, TaskTreeItem, type UseBillingResult, type UseCanvasTaskSyncOptions, type UseCanvasTaskSyncResult, type UseEffectiveSchemaResult, type UseGlobalUndoResult, type UseGridDatabaseOptions, type UseGridDatabaseResult, type UseSavedViewOptions, type UseSavedViewResult, UseTaskProjectionSyncResult, createSavedViewCanvasProjectionNodes, createSavedViewLensDraft, createSavedViewVisualCanvasProjectionRequest, createSavedViewVisualPreviewFingerprint, deriveCachedSavedViewVisualPreviews, deriveSavedViewColumns, deriveSavedViewDateBucketSummaries, deriveSavedViewFacetSummaries, deriveSavedViewPrivacyChips, deriveSavedViewRowInspector, deriveSavedViewTimelineBuckets, deriveSavedViewVisualPreview, deriveSavedViewVisualPreviews, filterSavedViewRowsByDateBrush, filterSavedViewRowsByFacets, flattenTaskTree, formatSavedViewCellValue, formatTaskDueDate, getSavedViewSensitiveResultWarning, hasSavedViewVisualPreviewSensitiveData, isSavedViewVisualPreviewEmbeddable, isTaskOverdue, mergeSavedViewFeedEnrichment, savedViewVisualPreviewIsSelfActor, useBilling, useCanvasTaskSync, useEffectiveSchema, useGlobalUndo, useGridDatabase, useSavedView };
+export { type AddRowOptions, type CanvasTaskInput, type CheckoutOptions, FlatNode, type GridFieldModel, type GridOptionModel, type GridRowModel, type GridViewModel, QueryFilter, type RenderableTaskRow, type SavedViewCanvasProjectionNode, type SavedViewDateBrushSelection, type SavedViewDateBucketFieldSummary, type SavedViewDateBucketInterval, type SavedViewDateBucketSummary, type SavedViewFacetSelection, type SavedViewFacetSummary, type SavedViewFacetValueSummary, type SavedViewFeedEnrichmentAdapter, type SavedViewFeedEnrichmentEntry, type SavedViewInspectorItem, type SavedViewInspectorItemKind, type SavedViewLensDraft, type SavedViewPresentationMode, type SavedViewPrivacyChip, type SavedViewPrivacyChipTone, type SavedViewPrivacySummary, type SavedViewQueryOverride, type SavedViewQueryResult, SavedViewResultTable, type SavedViewResultTableProps, type SavedViewRowInspectorModel, SavedViewRunner, type SavedViewRunnerProps, type SavedViewSchemaRegistry, type SavedViewSortDirection, type SavedViewVisualCanvasProjectionRequest, SavedViewVisualFeed, type SavedViewVisualLayoutId, type SavedViewVisualLayoutOption, type SavedViewVisualPreviewCreator, type SavedViewVisualPreviewKind, type SavedViewVisualPreviewModel, type SavedViewVisualPreviewPrivacy, type SavedViewVisualPreviewRelationship, type SavedViewVisualTimelineBucket, type SavedViewVisualWorkspaceLayout, TaskProjectionInput, TaskTreeItem, type UseBillingResult, type UseCanvasTaskSyncOptions, type UseCanvasTaskSyncResult, type UseEffectiveSchemaResult, type UseGlobalUndoResult, type UseGridDatabaseOptions, type UseGridDatabaseResult, type UseSavedViewOptions, type UseSavedViewResult, UseTaskProjectionSyncResult, createSavedViewCanvasProjectionNodes, createSavedViewLensDraft, createSavedViewVisualCanvasProjectionRequest, createSavedViewVisualPreviewFingerprint, deriveCachedSavedViewVisualPreviews, deriveSavedViewColumns, deriveSavedViewDateBucketSummaries, deriveSavedViewFacetSummaries, deriveSavedViewPrivacyChips, deriveSavedViewRowInspector, deriveSavedViewTimelineBuckets, deriveSavedViewVisualPreview, deriveSavedViewVisualPreviews, filterSavedViewRowsByDateBrush, filterSavedViewRowsByFacets, flattenTaskTree, formatSavedViewCellValue, formatTaskDueDate, getSavedViewSensitiveResultWarning, hasSavedViewVisualPreviewSensitiveData, isSavedViewVisualPreviewEmbeddable, isTaskOverdue, mergeSavedViewFeedEnrichment, savedViewVisualPreviewIsSelfActor, useBilling, useCanvasTaskSync, useEffectiveSchema, useGlobalUndo, useGridDatabase, useSavedView };

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 {
@@ -4264,7 +4264,10 @@ function toViewModel(node) {
     hiddenFields: node.hiddenFields ?? [],
     rowHeight: asRowHeight(node.rowHeight),
     columnSummaries: node.columnSummaries ?? {},
-    sortKey: node.sortKey ?? ""
+    sortKey: node.sortKey ?? "",
+    formConfig: node.formConfig ?? null,
+    formRules: node.formRules ?? {},
+    formAccepting: node.formAccepting ?? true
   };
 }
 function fieldsToColumnDefinitions(fields) {
@@ -4533,7 +4536,7 @@ function useGridDatabase(databaseId, options = {}) {
     [updateRowProps]
   );
   const addRow = useCallback2(
-    async (afterRowId, cells) => {
+    async (afterRowId, cells, opts) => {
       let sortKey;
       if (afterRowId) {
         const bySortKey = [...rows].sort((a, b) => compareSortKeys(a.sortKey, b.sortKey));
@@ -4553,11 +4556,16 @@ function useGridDatabase(databaseId, options = {}) {
       for (const [fieldId, value] of Object.entries(cells ?? {})) {
         cellProps[cellKey(fieldId)] = value;
       }
-      const node = await mutate.create(DatabaseRowSchema, {
-        database: databaseId,
-        sortKey,
-        ...cellProps
-      });
+      const node = await mutate.create(
+        DatabaseRowSchema,
+        {
+          database: databaseId,
+          sortKey,
+          ...opts?.meta ? { submissionMeta: opts.meta } : {},
+          ...cellProps
+        },
+        opts?.id
+      );
       return node?.id ?? null;
     },
     [mutate, databaseId, rows, nextAppendKey]
@@ -4750,6 +4758,27 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, activeView]
   );
+  const setFormConfig = useCallback2(
+    async (config) => {
+      if (!activeView) return;
+      await mutate.update(DatabaseViewSchema, activeView.id, { formConfig: config });
+    },
+    [mutate, activeView]
+  );
+  const setFormRules = useCallback2(
+    async (rules) => {
+      if (!activeView) return;
+      await mutate.update(DatabaseViewSchema, activeView.id, { formRules: rules });
+    },
+    [mutate, activeView]
+  );
+  const setFormAccepting = useCallback2(
+    async (accepting) => {
+      if (!activeView) return;
+      await mutate.update(DatabaseViewSchema, activeView.id, { formAccepting: accepting });
+    },
+    [mutate, activeView]
+  );
   const addView = useCallback2(
     async (name, type) => {
       const node = await mutate.create(DatabaseViewSchema, {
@@ -4801,6 +4830,9 @@ function useGridDatabase(databaseId, options = {}) {
     setGroupBy,
     setRowHeight,
     setColumnSummary,
+    setFormConfig,
+    setFormRules,
+    setFormAccepting,
     addView,
     renameView,
     removeView,

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.2.0",
+  "version": "0.4.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.2.0",
-    "@xnetjs/crypto": "0.2.0",
-    "@xnetjs/data": "0.2.0",
-    "@xnetjs/data-bridge": "0.2.0",
-    "@xnetjs/history": "0.2.0",
-    "@xnetjs/identity": "0.2.0",
-    "@xnetjs/plugins": "0.2.0",
-    "@xnetjs/runtime": "0.1.3",
-    "@xnetjs/sync": "0.2.0"
+    "@xnetjs/core": "0.4.0",
+    "@xnetjs/crypto": "0.4.0",
+    "@xnetjs/data": "0.4.0",
+    "@xnetjs/data-bridge": "0.4.0",
+    "@xnetjs/history": "0.4.0",
+    "@xnetjs/identity": "0.4.0",
+    "@xnetjs/plugins": "0.4.0",
+    "@xnetjs/runtime": "0.1.5",
+    "@xnetjs/sync": "0.4.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';