@xnetjs/react 0.12.0 → 1.0.0

package/dist/{chunk-SEYIZDHG.js → chunk-MEIYFD6R.js}

@@ -2478,7 +2478,9 @@ function useCan(nodeId) {
       try {
         const [read, write, del, share] = await Promise.all([
           store.auth.can({ action: "read", nodeId }),
-          store.auth.can({ action: "write", nodeId }),
+          // 'update' is the precise verb for mutating an existing node; it
+          // falls back to the schema's write expression (0304).
+          store.auth.can({ action: "update", nodeId }),
           store.auth.can({ action: "delete", nodeId }),
           store.auth.can({ action: "share", nodeId })
         ]);
@@ -2553,7 +2555,9 @@ function useCanEdit(nodeId) {
       try {
         const [read, write] = await Promise.all([
           store.auth.can({ action: "read", nodeId }),
-          store.auth.can({ action: "write", nodeId })
+          // 'update' is the precise verb for mutating an existing node; it
+          // falls back to the schema's write expression (0304).
+          store.auth.can({ action: "update", nodeId })
         ]);
         if (requestRef.current !== requestId) return;
         const roleSet = /* @__PURE__ */ new Set([...read.roles, ...write.roles]);

package/dist/experimental.js

@@ -73,7 +73,7 @@ import {
   useUndo,
   useVerification,
   useVisibleComments
-} from "./chunk-SEYIZDHG.js";
+} from "./chunk-MEIYFD6R.js";
 import {
   flattenNode,
   flattenNodes,

package/dist/index.d.ts

@@ -457,6 +457,45 @@ declare function createSavedViewVisualCanvasProjectionRequest(input: {
 }): SavedViewVisualCanvasProjectionRequest;
 declare function SavedViewResultTable({ query, columns, expandedRowId, onToggleRow, loadingLabel, emptyLabel, formatValue }: SavedViewResultTableProps): JSX.Element;
 
+/**
+ * Minimal Awareness surface (compatible with y-protocols/awareness).
+ * Duck-typed so tests and non-Yjs transports can provide their own.
+ */
+interface PresenceAwareness {
+    clientID: number;
+    getLocalState(): Record<string, unknown> | null;
+    setLocalState(state: Record<string, unknown> | null): void;
+    getStates(): Map<number, Record<string, unknown>>;
+    on(event: 'change', handler: () => void): void;
+    off(event: 'change', handler: () => void): void;
+}
+interface PresencePeer<T> {
+    /** Awareness client id (one per connected tab/device). */
+    clientId: number;
+    /** That peer's presence state. */
+    state: T;
+}
+interface UsePresenceOptions {
+    /**
+     * Minimum ms between broadcasts (default 33 ≈ 30fps). The hub rate-limits
+     * at 100 messages/sec/connection and closes the socket on repeated
+     * breaches — do not go below ~16ms.
+     */
+    throttleMs?: number;
+}
+interface UsePresenceResult<T> {
+    /** Remote peers only (local client excluded). Evicted on disconnect. */
+    peers: Array<PresencePeer<T>>;
+    /**
+     * Merge a partial patch into local presence. Patches within one throttle
+     * window coalesce into a single broadcast (leading + trailing edge).
+     */
+    setState: (patch: Partial<T>) => void;
+    /** Local awareness client id, or null before awareness attaches. */
+    clientId: number | null;
+}
+declare function usePresence<T extends Record<string, unknown>>(awareness: PresenceAwareness | null | undefined, initialState: T, options?: UsePresenceOptions): UsePresenceResult<T>;
+
 /**
  * useCanvasTaskSync - Reconcile canvas checklist items with Task nodes.
  *
@@ -630,6 +669,31 @@ interface UseGlobalUndoResult {
 }
 declare function useGlobalUndo(): UseGlobalUndoResult;
 
+/**
+ * useCanCreate - Check whether the current user may create a node of a schema
+ * (exploration 0304).
+ *
+ * The check runs against a *draft* node built from `schemaId` + `properties`,
+ * so container relations in the draft (e.g. `space`, `channel`) resolve
+ * membership roles — pass the relation the composer is about to write into:
+ *
+ * ```tsx
+ * const { canCreate } = useCanCreate(CHAT_MESSAGE_SCHEMA_IRI, { channel: channelId })
+ * <SendButton disabled={!canCreate} />
+ * ```
+ *
+ * Schemas that declare no `create` expression fall back to their `write`
+ * policy, which includes the creator role in every preset — those schemas
+ * resolve to `canCreate: true`.
+ */
+
+type UseCanCreateResult = {
+    canCreate: boolean;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useCanCreate(schemaId: SchemaIRI, properties?: Record<string, unknown>): UseCanCreateResult;
+
 /**
  * useBilling — reactive billing state + checkout, the same shape as `useIdentity`.
  *
@@ -693,4 +757,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 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 };
+export { type AddRowOptions, type CanvasTaskInput, type CheckoutOptions, FlatNode, type GridFieldModel, type GridOptionModel, type GridRowModel, type GridViewModel, type PresenceAwareness, type PresencePeer, 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 UseCanCreateResult, type UseCanvasTaskSyncOptions, type UseCanvasTaskSyncResult, type UseEffectiveSchemaResult, type UseGlobalUndoResult, type UseGridDatabaseOptions, type UseGridDatabaseResult, type UsePresenceOptions, type UsePresenceResult, 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, useCanCreate, useCanvasTaskSync, useEffectiveSchema, useGlobalUndo, useGridDatabase, usePresence, useSavedView };

package/dist/index.js

@@ -94,7 +94,7 @@ import {
   useUndo,
   useVerification,
   useVisibleComments
-} from "./chunk-SEYIZDHG.js";
+} from "./chunk-MEIYFD6R.js";
 import {
   EMPTY_PAGE_INFO,
   computeFallbackPageInfo,
@@ -4205,6 +4205,92 @@ function formatSavedViewInspectorValue(key, value) {
   return formatSavedViewCellValue(key, value);
 }
 
+// src/hooks/usePresence.ts
+import { useCallback as useCallback2, useEffect as useEffect5, useRef as useRef3, useState as useState5 } from "react";
+function readPeers(awareness, ownKeys) {
+  const peers = [];
+  awareness.getStates().forEach((state, clientId) => {
+    if (clientId === awareness.clientID || !state) return;
+    for (const key of ownKeys) {
+      if (key in state) {
+        peers.push({ clientId, state });
+        return;
+      }
+    }
+  });
+  return peers;
+}
+function usePresence(awareness, initialState, options = {}) {
+  const { throttleMs = 33 } = options;
+  const [peers, setPeers] = useState5([]);
+  const [clientId, setClientId] = useState5(null);
+  const ownKeysRef = useRef3(new Set(Object.keys(initialState)));
+  const initialStateRef = useRef3(initialState);
+  initialStateRef.current = initialState;
+  const awarenessRef = useRef3(null);
+  const pendingRef = useRef3({});
+  const lastBroadcastRef = useRef3(0);
+  const timerRef = useRef3(null);
+  const flush = useCallback2(() => {
+    const aw = awarenessRef.current;
+    if (!aw) return;
+    lastBroadcastRef.current = Date.now();
+    const patch = pendingRef.current;
+    pendingRef.current = {};
+    aw.setLocalState({ ...aw.getLocalState() ?? {}, ...patch });
+  }, []);
+  const setState = useCallback2(
+    (patch) => {
+      for (const key of Object.keys(patch)) ownKeysRef.current.add(key);
+      pendingRef.current = { ...pendingRef.current, ...patch };
+      const elapsed = Date.now() - lastBroadcastRef.current;
+      if (elapsed >= throttleMs) {
+        flush();
+      } else if (timerRef.current === null) {
+        timerRef.current = setTimeout(() => {
+          timerRef.current = null;
+          flush();
+        }, throttleMs - elapsed);
+      }
+    },
+    [flush, throttleMs]
+  );
+  useEffect5(() => {
+    if (!awareness) {
+      awarenessRef.current = null;
+      setClientId(null);
+      setPeers([]);
+      return;
+    }
+    awarenessRef.current = awareness;
+    setClientId(awareness.clientID);
+    const ownKeys = ownKeysRef.current;
+    awareness.setLocalState({
+      ...awareness.getLocalState() ?? {},
+      ...initialStateRef.current
+    });
+    lastBroadcastRef.current = Date.now();
+    const handleChange = () => {
+      setPeers(readPeers(awareness, ownKeysRef.current));
+    };
+    handleChange();
+    awareness.on("change", handleChange);
+    return () => {
+      awareness.off("change", handleChange);
+      if (timerRef.current !== null) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+      pendingRef.current = {};
+      const remaining = { ...awareness.getLocalState() ?? {} };
+      for (const key of ownKeys) delete remaining[key];
+      awareness.setLocalState(remaining);
+      if (awarenessRef.current === awareness) awarenessRef.current = null;
+    };
+  }, [awareness]);
+  return { peers, setState, clientId };
+}
+
 // src/hooks/useCanvasTaskSync.ts
 function useCanvasTaskSync({
   canvasId,
@@ -4237,7 +4323,7 @@ import {
   convertCellValue,
   FormulaService
 } from "@xnetjs/data";
-import { useCallback as useCallback2, useEffect as useEffect5, useMemo as useMemo5, useRef as useRef3, useState as useState5 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect6, useMemo as useMemo5, useRef as useRef4, useState as useState6 } from "react";
 function toFieldModel(node) {
   return {
     id: node.id,
@@ -4358,8 +4444,8 @@ function useGridDatabase(databaseId, options = {}) {
     return effective.map((e) => e.field);
   }, [fields, activeView]);
   const { store } = useNodeStore();
-  const [rollupValues, setRollupValues] = useState5(/* @__PURE__ */ new Map());
-  useEffect5(() => {
+  const [rollupValues, setRollupValues] = useState6(/* @__PURE__ */ new Map());
+  useEffect6(() => {
     const rollupFields = fields.filter((f) => f.type === "rollup");
     if (rollupFields.length === 0 || !store) {
       setRollupValues((prev) => prev.size > 0 ? /* @__PURE__ */ new Map() : prev);
@@ -4459,11 +4545,11 @@ function useGridDatabase(databaseId, options = {}) {
     return sortRows(filtered, columns, activeView.sorts);
   }, [rowNodes, activeView, fields, databaseId, rollupValues]);
   const loading = dbStatus === "loading" || fieldStatus === "loading" || viewStatus === "loading" || rowStatus === "loading";
-  const rowTailRef = useRef3(void 0);
-  const fieldTailRef = useRef3(void 0);
-  const viewTailRef = useRef3(void 0);
-  const optionTailRef = useRef3(/* @__PURE__ */ new Map());
-  useEffect5(() => {
+  const rowTailRef = useRef4(void 0);
+  const fieldTailRef = useRef4(void 0);
+  const viewTailRef = useRef4(void 0);
+  const optionTailRef = useRef4(/* @__PURE__ */ new Map());
+  useEffect6(() => {
     const dataTail = rows.reduce(
       (max, r) => !max || compareSortKeys(r.sortKey, max) > 0 ? r.sortKey : max,
       void 0
@@ -4472,19 +4558,19 @@ function useGridDatabase(databaseId, options = {}) {
       rowTailRef.current = dataTail;
     }
   }, [rows]);
-  useEffect5(() => {
+  useEffect6(() => {
     const dataTail = fields[fields.length - 1]?.sortKey;
     if (dataTail && (!fieldTailRef.current || compareSortKeys(dataTail, fieldTailRef.current) > 0)) {
       fieldTailRef.current = dataTail;
     }
   }, [fields]);
-  useEffect5(() => {
+  useEffect6(() => {
     const dataTail = views[views.length - 1]?.sortKey;
     if (dataTail && (!viewTailRef.current || compareSortKeys(dataTail, viewTailRef.current) > 0)) {
       viewTailRef.current = dataTail;
     }
   }, [views]);
-  useEffect5(() => {
+  useEffect6(() => {
     for (const [fieldId, list] of optionsByField) {
       const dataTail = list[list.length - 1]?.sortKey;
       const current = optionTailRef.current.get(fieldId);
@@ -4493,7 +4579,7 @@ function useGridDatabase(databaseId, options = {}) {
       }
     }
   }, [optionsByField]);
-  const nextAppendKey = useCallback2((tailRef) => {
+  const nextAppendKey = useCallback3((tailRef) => {
     const key = generateSortKey(tailRef.current, void 0);
     tailRef.current = key;
     return key;
@@ -4511,19 +4597,19 @@ function useGridDatabase(databaseId, options = {}) {
     localDID: did ?? null,
     options: { localOnly: true }
   });
-  const updateRowProps = useCallback2(
+  const updateRowProps = useCallback3(
     async (rowId, properties) => {
       await mutate.update(DatabaseRowSchema, rowId, properties);
     },
     [mutate]
   );
-  const updateCell = useCallback2(
+  const updateCell = useCallback3(
     async (rowId, fieldId, value) => {
       await updateRowProps(rowId, { [cellKey(fieldId)]: value });
     },
     [updateRowProps]
   );
-  const clearCells = useCallback2(
+  const clearCells = useCallback3(
     async (cells) => {
       const byRow = /* @__PURE__ */ new Map();
       for (const { rowId, fieldId } of cells) {
@@ -4535,7 +4621,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [updateRowProps]
   );
-  const addRow = useCallback2(
+  const addRow = useCallback3(
     async (afterRowId, cells, opts) => {
       let sortKey;
       if (afterRowId) {
@@ -4570,13 +4656,13 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, databaseId, rows, nextAppendKey]
   );
-  const deleteRows = useCallback2(
+  const deleteRows = useCallback3(
     async (rowIds) => {
       await Promise.all(rowIds.map((id) => mutate.remove(id)));
     },
     [mutate]
   );
-  const moveRowToIndex = useCallback2(
+  const moveRowToIndex = useCallback3(
     async (rowId, targetIndex) => {
       if (activeView && activeView.sorts.length > 0) return;
       const ordered = rows.map((r) => ({ id: r.id, key: r.sortKey }));
@@ -4585,7 +4671,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [rows, activeView, updateRowProps]
   );
-  const createOption = useCallback2(
+  const createOption = useCallback3(
     async (fieldId, name) => {
       const existing = optionsByField.get(fieldId) ?? [];
       const match = existing.find((o) => o.name.toLowerCase() === name.toLowerCase());
@@ -4604,7 +4690,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, databaseId, optionsByField]
   );
-  const addField = useCallback2(
+  const addField = useCallback3(
     async (name, type, config, opts) => {
       const node = await mutate.create(DatabaseFieldSchema, {
         database: databaseId,
@@ -4619,13 +4705,13 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, databaseId, nextAppendKey]
   );
-  const renameField = useCallback2(
+  const renameField = useCallback3(
     async (fieldId, name) => {
       await mutate.update(DatabaseFieldSchema, fieldId, { name });
     },
     [mutate]
   );
-  const updateFieldConfig = useCallback2(
+  const updateFieldConfig = useCallback3(
     async (fieldId, config) => {
       await mutate.update(DatabaseFieldSchema, fieldId, {
         config
@@ -4633,7 +4719,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate]
   );
-  const changeFieldType = useCallback2(
+  const changeFieldType = useCallback3(
     async (fieldId, type) => {
       const field = fields.find((f) => f.id === fieldId);
       const sourceType = field?.type ?? "text";
@@ -4670,7 +4756,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, fields, rows, createOption, updateRowProps]
   );
-  const removeField = useCallback2(
+  const removeField = useCallback3(
     async (fieldId) => {
       const orphanedOptions = optionsByField.get(fieldId) ?? [];
       await Promise.all(orphanedOptions.map((o) => mutate.remove(o.id)));
@@ -4678,7 +4764,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, optionsByField]
   );
-  const moveFieldToIndex = useCallback2(
+  const moveFieldToIndex = useCallback3(
     async (fieldId, targetIndex) => {
       if (!activeView) return;
       const ordered = visibleFields.map((f) => ({
@@ -4692,7 +4778,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, activeView, visibleFields, fields]
   );
-  const resizeField = useCallback2(
+  const resizeField = useCallback3(
     async (fieldId, width) => {
       if (!activeView) return;
       await mutate.update(DatabaseViewSchema, activeView.id, {
@@ -4701,7 +4787,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, activeView]
   );
-  const setFieldHiddenInView = useCallback2(
+  const setFieldHiddenInView = useCallback3(
     async (fieldId, hidden) => {
       if (!activeView) return;
       const set = new Set(activeView.hiddenFields);
@@ -4711,7 +4797,7 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, activeView]
   );
-  const toggleSort = useCallback2(
+  const toggleSort = useCallback3(
     async (fieldId) => {
       if (!activeView) return;
       const current = activeView.sorts.find((s) => s.columnId === fieldId);
@@ -4727,28 +4813,28 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, activeView]
   );
-  const setFilters = useCallback2(
+  const setFilters = useCallback3(
     async (filters) => {
       if (!activeView) return;
       await mutate.update(DatabaseViewSchema, activeView.id, { filters });
     },
     [mutate, activeView]
   );
-  const setGroupBy = useCallback2(
+  const setGroupBy = useCallback3(
     async (fieldId) => {
       if (!activeView) return;
       await mutate.update(DatabaseViewSchema, activeView.id, { groupBy: fieldId ?? void 0 });
     },
     [mutate, activeView]
   );
-  const setRowHeight = useCallback2(
+  const setRowHeight = useCallback3(
     async (rowHeight) => {
       if (!activeView) return;
       await mutate.update(DatabaseViewSchema, activeView.id, { rowHeight });
     },
     [mutate, activeView]
   );
-  const setColumnSummary = useCallback2(
+  const setColumnSummary = useCallback3(
     async (fieldId, fn) => {
       if (!activeView) return;
       const next = { ...activeView.columnSummaries };
@@ -4758,28 +4844,28 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, activeView]
   );
-  const setFormConfig = useCallback2(
+  const setFormConfig = useCallback3(
     async (config) => {
       if (!activeView) return;
       await mutate.update(DatabaseViewSchema, activeView.id, { formConfig: config });
     },
     [mutate, activeView]
   );
-  const setFormRules = useCallback2(
+  const setFormRules = useCallback3(
     async (rules) => {
       if (!activeView) return;
       await mutate.update(DatabaseViewSchema, activeView.id, { formRules: rules });
     },
     [mutate, activeView]
   );
-  const setFormAccepting = useCallback2(
+  const setFormAccepting = useCallback3(
     async (accepting) => {
       if (!activeView) return;
       await mutate.update(DatabaseViewSchema, activeView.id, { formAccepting: accepting });
     },
     [mutate, activeView]
   );
-  const addView = useCallback2(
+  const addView = useCallback3(
     async (name, type) => {
       const node = await mutate.create(DatabaseViewSchema, {
         database: databaseId,
@@ -4791,13 +4877,13 @@ function useGridDatabase(databaseId, options = {}) {
     },
     [mutate, databaseId, nextAppendKey]
   );
-  const renameView = useCallback2(
+  const renameView = useCallback3(
     async (id, name) => {
       await mutate.update(DatabaseViewSchema, id, { name });
     },
     [mutate]
   );
-  const removeView = useCallback2(
+  const removeView = useCallback3(
     async (id) => {
       await mutate.remove(id);
     },
@@ -4844,7 +4930,7 @@ function useGridDatabase(databaseId, options = {}) {
 }
 
 // src/hooks/useGlobalUndo.ts
-import { useCallback as useCallback3, useContext, useEffect as useEffect6, useReducer } from "react";
+import { useCallback as useCallback4, useContext, useEffect as useEffect7, useReducer } from "react";
 function readUndoContext(ctx) {
   if (!ctx) return { undoManager: null, nodeStore: null };
   return { undoManager: ctx.undoManager, nodeStore: ctx.nodeStore };
@@ -4853,17 +4939,17 @@ function useGlobalUndo() {
   const ctx = useContext(XNetContext);
   const { undoManager, nodeStore } = readUndoContext(ctx);
   const [, bump] = useReducer((n) => n + 1, 0);
-  useEffect6(() => {
+  useEffect7(() => {
     if (!nodeStore) return;
     return nodeStore.subscribe(() => bump());
   }, [nodeStore]);
-  const undo = useCallback3(async () => {
+  const undo = useCallback4(async () => {
     if (!undoManager) return false;
     const ok = await undoManager.undoLatest();
     bump();
     return ok;
   }, [undoManager]);
-  const redo = useCallback3(async () => {
+  const redo = useCallback4(async () => {
     if (!undoManager) return false;
     const ok = await undoManager.redoLatest();
     bump();
@@ -4877,6 +4963,57 @@ function useGlobalUndo() {
   };
 }
 
+// src/hooks/useCanCreate.ts
+import { useEffect as useEffect8, useMemo as useMemo6, useRef as useRef5, useState as useState7 } from "react";
+var INITIAL_STATE = {
+  canCreate: false,
+  loading: true,
+  error: null
+};
+function useCanCreate(schemaId, properties) {
+  const { store, isReady } = useNodeStore();
+  const [state, setState] = useState7(INITIAL_STATE);
+  const requestRef = useRef5(0);
+  const propertiesKey = useMemo6(() => JSON.stringify(properties ?? {}), [properties]);
+  useEffect8(() => {
+    if (!store || !isReady) {
+      setState((prev) => ({ ...prev, loading: true }));
+      return;
+    }
+    if (!store.auth) {
+      setState({
+        ...INITIAL_STATE,
+        loading: false,
+        error: new Error("Authorization API is not configured on this NodeStore")
+      });
+      return;
+    }
+    const run = async () => {
+      const requestId = ++requestRef.current;
+      setState((prev) => ({ ...prev, loading: true, error: null }));
+      try {
+        const decision = await store.auth.can({
+          action: "create",
+          // A synthetic id: the draft node must not collide with a stored one.
+          nodeId: `draft:${schemaId}`,
+          node: {
+            schemaId,
+            properties: JSON.parse(propertiesKey)
+          }
+        });
+        if (requestRef.current !== requestId) return;
+        setState({ canCreate: decision.allowed, loading: false, error: null });
+      } catch (error) {
+        if (requestRef.current !== requestId) return;
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        setState((prev) => ({ ...prev, loading: false, error: normalized }));
+      }
+    };
+    void run();
+  }, [isReady, propertiesKey, schemaId, store]);
+  return state;
+}
+
 // src/index.ts
 import { WebSocketSyncProvider } from "@xnetjs/runtime";
 import {
@@ -4907,7 +5044,7 @@ import {
 } from "@xnetjs/runtime";
 
 // src/hooks/useBilling.ts
-import { useCallback as useCallback4, useContext as useContext2, useEffect as useEffect7, useMemo as useMemo6, useState as useState6 } from "react";
+import { useCallback as useCallback5, useContext as useContext2, useEffect as useEffect9, useMemo as useMemo7, useState as useState8 } from "react";
 var toHttpUrl = (hubUrl) => {
   try {
     const url = new URL(hubUrl);
@@ -4944,20 +5081,20 @@ function deriveBilling(state) {
 }
 function useBilling() {
   const context = useContext2(XNetContext);
-  const [state, setState] = useState6(null);
-  const [loading, setLoading] = useState6(
+  const [state, setState] = useState8(null);
+  const [loading, setLoading] = useState8(
     Boolean(context?.hubUrl || context?.billing?.apiBase)
   );
-  const [error, setError] = useState6(null);
-  const apiBase = useMemo6(() => {
+  const [error, setError] = useState8(null);
+  const apiBase = useMemo7(() => {
     if (context?.billing?.apiBase) return context.billing.apiBase.replace(/\/$/, "");
     return context?.hubUrl ? toHttpUrl(context.hubUrl) : null;
   }, [context?.billing?.apiBase, context?.hubUrl]);
-  const authHeaders = useCallback4(async () => {
+  const authHeaders = useCallback5(async () => {
     const token = context?.getHubAuthToken ? await context.getHubAuthToken() : "";
     return token ? { Authorization: `Bearer ${token}` } : {};
   }, [context]);
-  const reload = useCallback4(async () => {
+  const reload = useCallback5(async () => {
     if (!apiBase) {
       setState(null);
       setLoading(false);
@@ -4975,10 +5112,10 @@ function useBilling() {
       setLoading(false);
     }
   }, [apiBase, authHeaders]);
-  useEffect7(() => {
+  useEffect9(() => {
     void reload();
   }, [reload]);
-  const redirectVia = useCallback4(
+  const redirectVia = useCallback5(
     async (path, body) => {
       if (!apiBase) throw new Error("Hub URL not configured");
       const res = await fetch(`${apiBase}${path}`, {
@@ -4992,11 +5129,11 @@ function useBilling() {
     },
     [apiBase, authHeaders]
   );
-  const openCheckout = useCallback4(
+  const openCheckout = useCallback5(
     (priceRef, options = {}) => redirectVia("/billing/checkout", buildCheckoutBody(priceRef, options)),
     [redirectVia]
   );
-  const openPortal = useCallback4(
+  const openPortal = useCallback5(
     (returnUrl) => redirectVia("/billing/portal", returnUrl ? { returnUrl } : {}),
     [redirectVia]
   );
@@ -5120,6 +5257,7 @@ export {
   useBilling,
   useBlame,
   useCan,
+  useCanCreate,
   useCanEdit,
   useCanvasTaskSync,
   useCell,
@@ -5164,6 +5302,7 @@ export {
   usePluginRegistryOptional,
   usePlugins,
   usePolicyFilteredReactionCounters,
+  usePresence,
   useQuery,
   useRelatedRows,
   useRemoteSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/react",
-  "version": "0.12.0",
+  "version": "1.0.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.12.0",
-    "@xnetjs/crypto": "0.12.0",
-    "@xnetjs/data": "0.12.0",
-    "@xnetjs/data-bridge": "0.12.0",
-    "@xnetjs/history": "0.12.0",
-    "@xnetjs/identity": "0.12.0",
-    "@xnetjs/plugins": "0.12.0",
-    "@xnetjs/runtime": "0.3.2",
-    "@xnetjs/sync": "0.12.0"
+    "@xnetjs/core": "1.0.0",
+    "@xnetjs/crypto": "1.0.0",
+    "@xnetjs/data": "1.0.0",
+    "@xnetjs/data-bridge": "1.0.0",
+    "@xnetjs/history": "1.0.0",
+    "@xnetjs/identity": "1.0.0",
+    "@xnetjs/plugins": "1.0.0",
+    "@xnetjs/runtime": "0.4.0",
+    "@xnetjs/sync": "1.0.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"