@dxos/react-client 0.7.5-labs.f5080a1 → 0.7.5-labs.ff2ff30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/react-client",
-  "version": "0.7.5-labs.f5080a1",
+  "version": "0.7.5-labs.ff2ff30",
   "description": "React client API",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -77,40 +77,40 @@
   },
   "dependencies": {
     "react-error-boundary": "^4.0.13",
-    "@dxos/async": "0.7.5-labs.f5080a1",
-    "@dxos/client": "0.7.5-labs.f5080a1",
-    "@dxos/codec-protobuf": "0.7.5-labs.f5080a1",
-    "@dxos/config": "0.7.5-labs.f5080a1",
-    "@dxos/debug": "0.7.5-labs.f5080a1",
-    "@dxos/echo-schema": "0.7.5-labs.f5080a1",
-    "@dxos/echo-signals": "0.7.5-labs.f5080a1",
-    "@dxos/invariant": "0.7.5-labs.f5080a1",
-    "@dxos/log": "0.7.5-labs.f5080a1",
-    "@dxos/protocols": "0.7.5-labs.f5080a1",
-    "@dxos/node-std": "0.7.5-labs.f5080a1",
-    "@dxos/react-hooks": "0.7.5-labs.f5080a1",
-    "@dxos/util": "0.7.5-labs.f5080a1"
+    "@dxos/async": "0.7.5-labs.ff2ff30",
+    "@dxos/client": "0.7.5-labs.ff2ff30",
+    "@dxos/codec-protobuf": "0.7.5-labs.ff2ff30",
+    "@dxos/debug": "0.7.5-labs.ff2ff30",
+    "@dxos/config": "0.7.5-labs.ff2ff30",
+    "@dxos/echo-schema": "0.7.5-labs.ff2ff30",
+    "@dxos/echo-signals": "0.7.5-labs.ff2ff30",
+    "@dxos/log": "0.7.5-labs.ff2ff30",
+    "@dxos/node-std": "0.7.5-labs.ff2ff30",
+    "@dxos/protocols": "0.7.5-labs.ff2ff30",
+    "@dxos/invariant": "0.7.5-labs.ff2ff30",
+    "@dxos/react-hooks": "0.7.5-labs.ff2ff30",
+    "@dxos/util": "0.7.5-labs.ff2ff30"
   },
   "devDependencies": {
     "@types/react": "~18.2.0",
     "@types/react-dom": "~18.2.0",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/random": "0.7.5-labs.f5080a1",
-    "@dxos/react-ui": "0.7.5-labs.f5080a1",
-    "@dxos/react-ui-syntax-highlighter": "0.7.5-labs.f5080a1",
-    "@dxos/react-ui-theme": "0.7.5-labs.f5080a1",
-    "@dxos/storybook-utils": "0.7.5-labs.f5080a1",
-    "@dxos/test-utils": "0.7.5-labs.f5080a1"
+    "@dxos/random": "0.7.5-labs.ff2ff30",
+    "@dxos/react-ui": "0.7.5-labs.ff2ff30",
+    "@dxos/react-ui-syntax-highlighter": "0.7.5-labs.ff2ff30",
+    "@dxos/react-ui-theme": "0.7.5-labs.ff2ff30",
+    "@dxos/storybook-utils": "0.7.5-labs.ff2ff30",
+    "@dxos/test-utils": "0.7.5-labs.ff2ff30"
   },
   "peerDependencies": {
     "react": "~18.2.0",
     "react-dom": "~18.2.0"
   },
   "optionalDependencies": {
-    "@dxos/random": "0.7.5-labs.f5080a1",
-    "@dxos/react-ui": "0.7.5-labs.f5080a1",
-    "@dxos/react-ui-theme": "0.7.5-labs.f5080a1"
+    "@dxos/random": "0.7.5-labs.ff2ff30",
+    "@dxos/react-ui": "0.7.5-labs.ff2ff30",
+    "@dxos/react-ui-theme": "0.7.5-labs.ff2ff30"
   },
   "publishConfig": {
     "access": "public"

package/src/client/ClientProvider.tsx

@@ -15,7 +15,7 @@ import { Client, type ClientOptions, type ClientServicesProvider, SystemStatus }
 import { type Config } from '@dxos/config';
 import { registerSignalsRuntime } from '@dxos/echo-signals/react';
 import { log } from '@dxos/log';
-import { useControlledValue } from '@dxos/react-hooks';
+import { useControlledState } from '@dxos/react-hooks';
 import { getAsyncProviderValue, type MaybePromise, type Provider } from '@dxos/util';
 
 import { ClientContext, type ClientContextProps } from './context';
@@ -114,7 +114,7 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
     useImperativeHandle(forwardedRef, () => client, [client]);
 
     // Client status subscription.
-    const [status, setStatus] = useControlledValue(controlledStatus);
+    const [status, setStatus] = useControlledState(controlledStatus);
     useEffect(() => {
       if (!client) {
         return;

package/src/echo/index.ts

@@ -6,6 +6,7 @@ export * from '@dxos/client/echo';
 
 export * from './useMembers';
 export * from './useQuery';
+export * from './useSchema';
 export * from './useSpaces';
 export * from './useSpaceInvitations';
 export * from './useSubscription';

package/src/echo/useSchema.ts

@@ -0,0 +1,39 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { useMemo, useSyncExternalStore } from 'react';
+
+import { type Space } from '@dxos/client/echo';
+import { type EchoSchema } from '@dxos/echo-schema';
+
+/**
+ * Subscribe to and retrieve schema changes from a space's schema registry.
+ */
+export const useSchema = (space: Space | undefined, typename: string | undefined): EchoSchema | undefined => {
+  const { subscribe, getSchema } = useMemo(() => {
+    if (!typename || !space) {
+      return {
+        subscribe: () => () => {},
+        getSchema: () => undefined,
+      };
+    }
+
+    const query = space.db.schemaRegistry.query({ typename });
+    const initialResult = query.runSync()[0];
+    let currentSchema = initialResult;
+
+    return {
+      subscribe: (onStoreChange: () => void) => {
+        const unsubscribe = query.subscribe(() => {
+          currentSchema = query.results[0];
+          onStoreChange();
+        });
+        return unsubscribe;
+      },
+      getSchema: () => currentSchema,
+    };
+  }, [typename, space]);
+
+  return useSyncExternalStore(subscribe, getSchema);
+};