@dxos/react-client 0.8.4-main.66e292d → 0.8.4-main.69d29f4

package/.storybook/main.mts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { createConfig } from '../../../../tools/storybook/.storybook/main';
+import { createConfig } from '../../../../tools/storybook-react/.storybook/main';
 
 export const stories = [
   '../src/**/*.stories.tsx',

package/.storybook/preview.mts

@@ -2,7 +2,7 @@
 // Copyright 2025 DXOS.org
 //
 
-import { preview } from '../../../../tools/storybook/.storybook/preview';
+import { preview } from '../../../../tools/storybook-react/.storybook/preview';
 
-export * from '../../../../tools/storybook/.storybook/preview';
+export * from '../../../../tools/storybook-react/.storybook/preview';
 export default preview;

package/dist/lib/browser/chunk-5UKA2BMA.mjs

@@ -0,0 +1,179 @@
+import {
+  ClientContext
+} from "./chunk-TSF6Y5VB.mjs";
+
+// src/client/ClientProvider.tsx
+import React, { forwardRef, useEffect, useImperativeHandle, useState } from "react";
+import { Client, SystemStatus } from "@dxos/client";
+import { log } from "@dxos/log";
+import { useAsyncEffect, useControlledState } from "@dxos/react-hooks";
+import { getAsyncProviderValue } from "@dxos/util";
+
+// src/banner.ts
+var BANNER = (client) => {
+  const commitHash = client.config.get("runtime.app.build.commitHash");
+  const hash = commitHash ? ` App Commit ${commitHash} 
+` : "";
+  return `
+_/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\______/\\/\\/\\/\\/\\_
+_/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__/\\/\\_________
+_/\\/\\____/\\/\\______/\\/\\______/\\/\\____/\\/\\____/\\/\\/\\/\\___
+_/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__________/\\/\\_
+_/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\/\\/\\/\\___
+
+ DXOS Client ${client.version} 
+${hash}`;
+};
+var bannerPrinted = false;
+var printBanner = (client) => {
+  if (bannerPrinted || window.location.hostname === "localhost") {
+    return;
+  }
+  bannerPrinted = true;
+  console.log(`%c${BANNER(client)}`, "font-family: monospace;");
+};
+
+// src/client/ClientProvider.tsx
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/react-client/src/client/ClientProvider.tsx";
+var ClientProvider = /* @__PURE__ */ forwardRef(({ children, config: configProp, client: clientProp, services: servicesProp, status: statusProp, fallback: Fallback = () => null, noBanner, onInitialized, ...options }, forwardedRef) => {
+  const [error, setError] = useState();
+  if (error) {
+    throw error;
+  }
+  const [client, setClient] = useState(clientProp instanceof Client ? clientProp : void 0);
+  useImperativeHandle(forwardedRef, () => client, [
+    client
+  ]);
+  const [status, setStatus] = useControlledState(statusProp);
+  useEffect(() => {
+    if (!client) {
+      return;
+    }
+    const subscription = client.status.subscribe((status2) => setStatus(status2));
+    return () => subscription.unsubscribe();
+  }, [
+    client
+  ]);
+  useAsyncEffect(async () => {
+    let disposed = false;
+    const initialize = async (client3) => {
+      if (!client3.initialized) {
+        await client3.initialize().catch((err) => {
+          if (!disposed) {
+            setError(err);
+          }
+        });
+        log("client ready", void 0, {
+          F: __dxlog_file,
+          L: 124,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+        await onInitialized?.(client3);
+        log("initialization complete", void 0, {
+          F: __dxlog_file,
+          L: 126,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+      }
+      setClient(client3);
+      if (!noBanner) {
+        printBanner(client3);
+      }
+    };
+    let client2;
+    try {
+      if (clientProp) {
+        client2 = await getAsyncProviderValue(clientProp);
+        await initialize(client2);
+      } else {
+        const config = await getAsyncProviderValue(configProp);
+        log("resolved config", {
+          config
+        }, {
+          F: __dxlog_file,
+          L: 144,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+        const services = await getAsyncProviderValue(servicesProp, config);
+        log("created services", {
+          services
+        }, {
+          F: __dxlog_file,
+          L: 146,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+        client2 = new Client({
+          config,
+          services,
+          ...options
+        });
+        log("created client", void 0, {
+          F: __dxlog_file,
+          L: 148,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+        await initialize(client2);
+      }
+    } catch (err) {
+      if (!disposed) {
+        log.catch(err, void 0, {
+          F: __dxlog_file,
+          L: 153,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+      }
+    }
+    return () => {
+      log("clean up", void 0, {
+        F: __dxlog_file,
+        L: 158,
+        S: void 0,
+        C: (f, a) => f(...a)
+      });
+      disposed = true;
+      if (!clientProp) {
+        void client2?.destroy().then(() => {
+          log("destroyed", void 0, {
+            F: __dxlog_file,
+            L: 165,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+        }).catch((err) => log.catch(err, void 0, {
+          F: __dxlog_file,
+          L: 167,
+          S: void 0,
+          C: (f, a) => f(...a)
+        }));
+      }
+    };
+  }, [
+    configProp,
+    clientProp,
+    servicesProp,
+    noBanner
+  ]);
+  if (!client?.initialized || status !== SystemStatus.ACTIVE) {
+    return /* @__PURE__ */ React.createElement(Fallback, {
+      client,
+      status
+    });
+  }
+  return /* @__PURE__ */ React.createElement(ClientContext.Provider, {
+    value: {
+      client,
+      status
+    }
+  }, children);
+});
+
+export {
+  ClientProvider
+};
+//# sourceMappingURL=chunk-5UKA2BMA.mjs.map

package/dist/lib/browser/chunk-5UKA2BMA.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/client/ClientProvider.tsx", "../../../src/banner.ts"],
+  "sourcesContent": ["//\n// Copyright 2020 DXOS.org\n//\n\nimport React, {\n  type FunctionComponent,\n  type PropsWithChildren,\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useState,\n} from 'react';\n\nimport { Client, type ClientOptions, type ClientServicesProvider, SystemStatus } from '@dxos/client';\nimport { type Config } from '@dxos/config';\nimport { log } from '@dxos/log';\nimport { useAsyncEffect, useControlledState } from '@dxos/react-hooks';\nimport { type MaybePromise, type Provider, getAsyncProviderValue } from '@dxos/util';\n\nimport { printBanner } from '../banner';\n\nimport { ClientContext, type ClientContextProps } from './context';\n\n/**\n * Properties for the ClientProvider.\n */\nexport type ClientProviderProps = Omit<ClientOptions, 'config' | 'services'> &\n  Pick<ClientContextProps, 'status'> &\n  PropsWithChildren<{\n    /**\n     * Client object or async provider to enable to caller to do custom initialization.\n     *\n     * NOTE: For advanced use cases only.\n     */\n    client?: Client | Provider<Promise<Client>>;\n\n    /**\n     * Config object or async provider.\n     *\n     * NOTE: If a `client` is provided then `config` is ignored.\n     */\n    // TODO(burdon): Reconcile with ClientOptions.\n    config?: Config | Provider<Promise<Config>>;\n\n    /**\n     * Callback to enable the caller to create a custom ClientServicesProvider.\n     *\n     * NOTE: If a `client` is provided then `services` is ignored.\n     */\n    // TODO(burdon): Reconcile with ClientOptions.\n    services?: ClientServicesProvider | ((config?: Config) => MaybePromise<ClientServicesProvider>);\n\n    /**\n     * ReactNode to display until the client is available.\n     */\n    fallback?: FunctionComponent<Partial<ClientContextProps>>;\n\n    /**\n     * Skip the DXOS banner.\n     */\n    noBanner?: boolean;\n\n    /**\n     * Post initialization hook to enable to caller to do custom initialization.\n     */\n    onInitialized?: (client: Client) => MaybePromise<void>;\n  }>;\n\n/**\n * Root component that provides the DXOS client instance to child components.\n * To be used with the `useClient` hook.\n */\nexport const ClientProvider = forwardRef<Client | undefined, ClientProviderProps>(\n  (\n    {\n      children,\n      config: configProp,\n      client: clientProp,\n      services: servicesProp,\n      status: statusProp,\n      fallback: Fallback = () => null,\n      noBanner,\n      onInitialized,\n      ...options\n    },\n    forwardedRef,\n  ) => {\n    // The client is initialized asynchronously.\n    // If an error occurs during initialization, it is caught and the state is set.\n    // This allows the error to be thrown in the render method.\n    // The assumption is that a client initialization error is fatal to the app.\n    // This error will be caught by the nearest error boundary.\n    const [error, setError] = useState();\n    if (error) {\n      throw error;\n    }\n\n    const [client, setClient] = useState(clientProp instanceof Client ? clientProp : undefined);\n\n    // Provide external access.\n    useImperativeHandle(forwardedRef, () => client, [client]);\n\n    // Client status subscription.\n    const [status, setStatus] = useControlledState(statusProp);\n    useEffect(() => {\n      if (!client) {\n        return;\n      }\n\n      const subscription = client.status.subscribe((status) => setStatus(status));\n      return () => subscription.unsubscribe();\n    }, [client]);\n\n    // Create and/or initialize client.\n    useAsyncEffect(async () => {\n      let disposed = false;\n      const initialize = async (client: Client) => {\n        if (!client.initialized) {\n          await client.initialize().catch((err) => {\n            if (!disposed) {\n              setError(err);\n            }\n          });\n          log('client ready');\n          await onInitialized?.(client);\n          log('initialization complete');\n        }\n\n        setClient(client);\n        if (!noBanner) {\n          printBanner(client);\n        }\n      };\n\n      let client: Client;\n      try {\n        if (clientProp) {\n          // Asynchronously request client.\n          client = await getAsyncProviderValue(clientProp);\n          await initialize(client);\n        } else {\n          // Asynchronously construct client (config may be undefined).\n          const config = await getAsyncProviderValue(configProp);\n          log('resolved config', { config });\n          const services = await getAsyncProviderValue(servicesProp, config);\n          log('created services', { services });\n          client = new Client({ config, services, ...options });\n          log('created client');\n          await initialize(client);\n        }\n      } catch (err) {\n        if (!disposed) {\n          log.catch(err);\n        }\n      }\n\n      return () => {\n        log('clean up');\n        disposed = true;\n        // Only destroy if the client is not provided by the parent.\n        if (!clientProp) {\n          void client\n            ?.destroy()\n            .then(() => {\n              log('destroyed');\n            })\n            .catch((err) => log.catch(err));\n        }\n      };\n    }, [configProp, clientProp, servicesProp, noBanner]);\n\n    if (!client?.initialized || status !== SystemStatus.ACTIVE) {\n      return <Fallback client={client} status={status} />;\n    }\n\n    return <ClientContext.Provider value={{ client, status }}>{children}</ClientContext.Provider>;\n  },\n);\n", "//\n// Copyright 2021 DXOS.org\n//\n\nimport { type Client } from '@dxos/client';\n\n// http://patorjk.com/software/taag/#p=testall&f=Patorjk-HeX&t=DXOS\nconst BANNER = (client: Client) => {\n  const commitHash = client.config.get('runtime.app.build.commitHash');\n  const hash = commitHash ? ` App Commit ${commitHash} \\n` : '';\n\n  return (\n    '\\n' +\n    '_/\\\\/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\______/\\\\/\\\\/\\\\/\\\\/\\\\_\\n' +\n    '_/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\__/\\\\/\\\\_________\\n' +\n    '_/\\\\/\\\\____/\\\\/\\\\______/\\\\/\\\\______/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\___\\n' +\n    '_/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\__________/\\\\/\\\\_\\n' +\n    '_/\\\\/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\/\\\\___\\n' +\n    `\\n DXOS Client ${client.version} \\n${hash}`\n  );\n};\n\nlet bannerPrinted = false;\n\nexport const printBanner = (client: Client) => {\n  if (bannerPrinted || window.location.hostname === 'localhost') {\n    return;\n  }\n\n  bannerPrinted = true;\n  // eslint-disable-next-line no-console\n  console.log(`%c${BANNER(client)}`, 'font-family: monospace;');\n};\n"],
+  "mappings": ";;;;;AAIA,OAAOA,SAGLC,YACAC,WACAC,qBACAC,gBACK;AAEP,SAASC,QAAyDC,oBAAoB;AAEtF,SAASC,WAAW;AACpB,SAASC,gBAAgBC,0BAA0B;AACnD,SAA2CC,6BAA6B;;;ACVxE,IAAMC,SAAS,CAACC,WAAAA;AACd,QAAMC,aAAaD,OAAOE,OAAOC,IAAI,8BAAA;AACrC,QAAMC,OAAOH,aAAa,eAAeA,UAAAA;IAAkB;AAE3D,SACE;;;;;;;eAMkBD,OAAOK,OAAO;EAAMD,IAAAA;AAE1C;AAEA,IAAIE,gBAAgB;AAEb,IAAMC,cAAc,CAACP,WAAAA;AAC1B,MAAIM,iBAAiBE,OAAOC,SAASC,aAAa,aAAa;AAC7D;EACF;AAEAJ,kBAAgB;AAEhBK,UAAQC,IAAI,KAAKb,OAAOC,MAAAA,CAAAA,IAAW,yBAAA;AACrC;;;;ADwCO,IAAMa,iBAAiBC,2BAC5B,CACE,EACEC,UACAC,QAAQC,YACRC,QAAQC,YACRC,UAAUC,cACVC,QAAQC,YACRC,UAAUC,WAAW,MAAM,MAC3BC,UACAC,eACA,GAAGC,QAAAA,GAELC,iBAAAA;AAOA,QAAM,CAACC,OAAOC,QAAAA,IAAYC,SAAAA;AAC1B,MAAIF,OAAO;AACT,UAAMA;EACR;AAEA,QAAM,CAACZ,QAAQe,SAAAA,IAAaD,SAASb,sBAAsBe,SAASf,aAAagB,MAAAA;AAGjFC,sBAAoBP,cAAc,MAAMX,QAAQ;IAACA;GAAO;AAGxD,QAAM,CAACI,QAAQe,SAAAA,IAAaC,mBAAmBf,UAAAA;AAC/CgB,YAAU,MAAA;AACR,QAAI,CAACrB,QAAQ;AACX;IACF;AAEA,UAAMsB,eAAetB,OAAOI,OAAOmB,UAAU,CAACnB,YAAWe,UAAUf,OAAAA,CAAAA;AACnE,WAAO,MAAMkB,aAAaE,YAAW;EACvC,GAAG;IAACxB;GAAO;AAGXyB,iBAAe,YAAA;AACb,QAAIC,WAAW;AACf,UAAMC,aAAa,OAAO3B,YAAAA;AACxB,UAAI,CAACA,QAAO4B,aAAa;AACvB,cAAM5B,QAAO2B,WAAU,EAAGE,MAAM,CAACC,QAAAA;AAC/B,cAAI,CAACJ,UAAU;AACbb,qBAASiB,GAAAA;UACX;QACF,CAAA;AACAC,YAAI,gBAAA,QAAA;;;;;;AACJ,cAAMtB,gBAAgBT,OAAAA;AACtB+B,YAAI,2BAAA,QAAA;;;;;;MACN;AAEAhB,gBAAUf,OAAAA;AACV,UAAI,CAACQ,UAAU;AACbwB,oBAAYhC,OAAAA;MACd;IACF;AAEA,QAAIA;AACJ,QAAI;AACF,UAAIC,YAAY;AAEdD,QAAAA,UAAS,MAAMiC,sBAAsBhC,UAAAA;AACrC,cAAM0B,WAAW3B,OAAAA;MACnB,OAAO;AAEL,cAAMF,SAAS,MAAMmC,sBAAsBlC,UAAAA;AAC3CgC,YAAI,mBAAmB;UAAEjC;QAAO,GAAA;;;;;;AAChC,cAAMI,WAAW,MAAM+B,sBAAsB9B,cAAcL,MAAAA;AAC3DiC,YAAI,oBAAoB;UAAE7B;QAAS,GAAA;;;;;;AACnCF,QAAAA,UAAS,IAAIgB,OAAO;UAAElB;UAAQI;UAAU,GAAGQ;QAAQ,CAAA;AACnDqB,YAAI,kBAAA,QAAA;;;;;;AACJ,cAAMJ,WAAW3B,OAAAA;MACnB;IACF,SAAS8B,KAAK;AACZ,UAAI,CAACJ,UAAU;AACbK,YAAIF,MAAMC,KAAAA,QAAAA;;;;;;MACZ;IACF;AAEA,WAAO,MAAA;AACLC,UAAI,YAAA,QAAA;;;;;;AACJL,iBAAW;AAEX,UAAI,CAACzB,YAAY;AACf,aAAKD,SACDkC,QAAAA,EACDC,KAAK,MAAA;AACJJ,cAAI,aAAA,QAAA;;;;;;QACN,CAAA,EACCF,MAAM,CAACC,QAAQC,IAAIF,MAAMC,KAAAA,QAAAA;;;;;;MAC9B;IACF;EACF,GAAG;IAAC/B;IAAYE;IAAYE;IAAcK;GAAS;AAEnD,MAAI,CAACR,QAAQ4B,eAAexB,WAAWgC,aAAaC,QAAQ;AAC1D,WAAO,sBAAA,cAAC9B,UAAAA;MAASP;MAAgBI;;EACnC;AAEA,SAAO,sBAAA,cAACkC,cAAcC,UAAQ;IAACC,OAAO;MAAExC;MAAQI;IAAO;KAAIP,QAAAA;AAC7D,CAAA;",
+  "names": ["React", "forwardRef", "useEffect", "useImperativeHandle", "useState", "Client", "SystemStatus", "log", "useAsyncEffect", "useControlledState", "getAsyncProviderValue", "BANNER", "client", "commitHash", "config", "get", "hash", "version", "bannerPrinted", "printBanner", "window", "location", "hostname", "console", "log", "ClientProvider", "forwardRef", "children", "config", "configProp", "client", "clientProp", "services", "servicesProp", "status", "statusProp", "fallback", "Fallback", "noBanner", "onInitialized", "options", "forwardedRef", "error", "setError", "useState", "setClient", "Client", "undefined", "useImperativeHandle", "setStatus", "useControlledState", "useEffect", "subscription", "subscribe", "unsubscribe", "useAsyncEffect", "disposed", "initialize", "initialized", "catch", "err", "log", "printBanner", "getAsyncProviderValue", "destroy", "then", "SystemStatus", "ACTIVE", "ClientContext", "Provider", "value"]
+}

package/dist/lib/browser/chunk-PFF63FPR.mjs

@@ -0,0 +1,16 @@
+import {
+  ClientContext
+} from "./chunk-TSF6Y5VB.mjs";
+
+// src/client/useClient.ts
+import { useContext } from "react";
+import { raise } from "@dxos/debug";
+var useClient = () => {
+  const { client } = useContext(ClientContext) ?? raise(new Error("Missing ClientContext."));
+  return client;
+};
+
+export {
+  useClient
+};
+//# sourceMappingURL=chunk-PFF63FPR.mjs.map

package/dist/lib/browser/chunk-PFF63FPR.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/client/useClient.ts"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from '../client/context';\n\n/**\n * Hook returning instance of DXOS client.\n * Requires ClientContext to be set via ClientProvider.\n */\nexport const useClient = () => {\n  const { client } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n  return client;\n};\n"],
+  "mappings": ";;;;;AAIA,SAASA,kBAAkB;AAE3B,SAASC,aAAa;AAQf,IAAMC,YAAY,MAAA;AACvB,QAAM,EAAEC,OAAM,IAAKC,WAAWC,aAAAA,KAAkBC,MAAM,IAAIC,MAAM,wBAAA,CAAA;AAChE,SAAOJ;AACT;",
+  "names": ["useContext", "raise", "useClient", "client", "useContext", "ClientContext", "raise", "Error"]
+}

package/dist/lib/browser/chunk-TSF6Y5VB.mjs

@@ -0,0 +1,8 @@
+// src/client/context.ts
+import { createContext } from "react";
+var ClientContext = createContext(void 0);
+
+export {
+  ClientContext
+};
+//# sourceMappingURL=chunk-TSF6Y5VB.mjs.map

package/dist/lib/browser/chunk-TSF6Y5VB.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/client/context.ts"],
+  "sourcesContent": ["//\n// Copyright 2020 DXOS.org\n//\n\nimport { type Context, createContext } from 'react';\n\nimport { type Client, type SystemStatus } from '@dxos/client';\n\nexport type ClientContextProps = {\n  client: Client;\n  status?: SystemStatus | null;\n};\n\n/**\n * @internal Use ClientProvider to create or initialize the Client.\n */\nexport const ClientContext: Context<ClientContextProps | undefined> = createContext<ClientContextProps | undefined>(\n  undefined,\n);\n"],
+  "mappings": ";AAIA,SAAuBA,qBAAqB;AAYrC,IAAMC,gBAAyDC,cACpEC,MAAAA;",
+  "names": ["createContext", "ClientContext", "createContext", "undefined"]
+}

package/dist/lib/browser/devtools/index.mjs

@@ -1,6 +1,7 @@
 import {
   useClient
-} from "../chunk-TA2HGRAF.mjs";
+} from "../chunk-PFF63FPR.mjs";
+import "../chunk-TSF6Y5VB.mjs";
 
 // src/devtools/index.ts
 export * from "@dxos/client/devtools";

package/dist/lib/browser/devtools/index.mjs.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../src/devtools/index.ts", "../../../../src/devtools/useDevtools.ts", "../../../../src/devtools/useStream.ts"],
   "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nexport * from '@dxos/client/devtools';\n\nexport * from './useDevtools';\nexport * from './useStream';\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { type DevtoolsHost } from '@dxos/client/devtools';\nimport { raise } from '@dxos/debug';\n\nimport { useClient } from '../client';\n\nexport const useDevtools = (): DevtoolsHost => {\n  const client = useClient();\n  return client.services.services.DevtoolsHost ?? raise(new Error('DevtoolsHost not available.'));\n};\n", "//\n// Copyright 2021 DXOS.org\n//\n\nimport { type DependencyList, useEffect, useState } from 'react';\n\nimport { type Stream } from '@dxos/codec-protobuf/stream';\nimport { log } from '@dxos/log';\n\n/**\n * Subscribe to service API streams.\n */\nexport const useStream = <T>(streamFactory: () => Stream<T>, defaultValue: T, deps: DependencyList = []): T => {\n  const [value, setValue] = useState<T | undefined>(defaultValue);\n  useEffect(() => {\n    const stream = streamFactory();\n    stream.subscribe(\n      (response: T) => setValue(response),\n      (err) => {\n        if (err) {\n          log.catch(err);\n        }\n      },\n    );\n\n    return () => {\n      void stream.close();\n    };\n  }, deps);\n\n  return value ?? defaultValue;\n};\n"],
-  "mappings": ";;;;;AAIA,cAAc;;;ACCd,SAASA,aAAa;AAIf,IAAMC,cAAc,MAAA;AACzB,QAAMC,SAASC,UAAAA;AACf,SAAOD,OAAOE,SAASA,SAASC,gBAAgBC,MAAM,IAAIC,MAAM,6BAAA,CAAA;AAClE;;;ACRA,SAA8BC,WAAWC,gBAAgB;AAGzD,SAASC,WAAW;;AAKb,IAAMC,YAAY,CAAIC,eAAgCC,cAAiBC,OAAuB,CAAA,MAAE;AACrG,QAAM,CAACC,OAAOC,QAAAA,IAAYP,SAAwBI,YAAAA;AAClDL,YAAU,MAAA;AACR,UAAMS,SAASL,cAAAA;AACfK,WAAOC,UACL,CAACC,aAAgBH,SAASG,QAAAA,GAC1B,CAACC,QAAAA;AACC,UAAIA,KAAK;AACPV,YAAIW,MAAMD,KAAAA,QAAAA;;;;;;MACZ;IACF,CAAA;AAGF,WAAO,MAAA;AACL,WAAKH,OAAOK,MAAK;IACnB;EACF,GAAGR,IAAAA;AAEH,SAAOC,SAASF;AAClB;",
+  "mappings": ";;;;;;AAIA,cAAc;;;ACCd,SAASA,aAAa;AAIf,IAAMC,cAAc,MAAA;AACzB,QAAMC,SAASC,UAAAA;AACf,SAAOD,OAAOE,SAASA,SAASC,gBAAgBC,MAAM,IAAIC,MAAM,6BAAA,CAAA;AAClE;;;ACRA,SAA8BC,WAAWC,gBAAgB;AAGzD,SAASC,WAAW;;AAKb,IAAMC,YAAY,CAAIC,eAAgCC,cAAiBC,OAAuB,CAAA,MAAE;AACrG,QAAM,CAACC,OAAOC,QAAAA,IAAYP,SAAwBI,YAAAA;AAClDL,YAAU,MAAA;AACR,UAAMS,SAASL,cAAAA;AACfK,WAAOC,UACL,CAACC,aAAgBH,SAASG,QAAAA,GAC1B,CAACC,QAAAA;AACC,UAAIA,KAAK;AACPV,YAAIW,MAAMD,KAAAA,QAAAA;;;;;;MACZ;IACF,CAAA;AAGF,WAAO,MAAA;AACL,WAAKH,OAAOK,MAAK;IACnB;EACF,GAAGR,IAAAA;AAEH,SAAOC,SAASF;AAClB;",
   "names": ["raise", "useDevtools", "client", "useClient", "services", "DevtoolsHost", "raise", "Error", "useEffect", "useState", "log", "useStream", "streamFactory", "defaultValue", "deps", "value", "setValue", "stream", "subscribe", "response", "err", "catch", "close"]
 }

package/dist/lib/browser/echo/index.mjs

@@ -3,41 +3,54 @@ import {
 } from "../chunk-LO3TU5CK.mjs";
 import {
   useClient
-} from "../chunk-TA2HGRAF.mjs";
+} from "../chunk-PFF63FPR.mjs";
+import "../chunk-TSF6Y5VB.mjs";
 
 // src/echo/index.ts
 export * from "@dxos/client/echo";
+export * from "@dxos/echo-react";
 
 // src/echo/useMembers.ts
 import { MulticastObservable } from "@dxos/async";
+import { PublicKey as PublicKey2 } from "@dxos/client";
 import { HaloSpaceMember } from "@dxos/client/echo";
 import { useMulticastObservable as useMulticastObservable2 } from "@dxos/react-hooks";
 
 // src/echo/useSpaces.ts
 import { useState } from "react";
+import { PublicKey } from "@dxos/client";
 import { SpaceState } from "@dxos/client/echo";
 import { useAsyncEffect, useMulticastObservable } from "@dxos/react-hooks";
-var useSpace = (spaceKeyLike) => {
+var useSpace = (spaceId) => {
   const client = useClient();
   const spaces = useMulticastObservable(client.spaces);
   const [ready, setReady] = useState(false);
   useAsyncEffect(async () => {
-    if (spaceKeyLike) {
+    if (spaceId) {
       return;
     }
     await client.spaces.waitUntilReady();
     setReady(true);
   }, [
     client,
-    spaceKeyLike
+    spaceId
   ]);
-  if (spaceKeyLike) {
-    return spaces.find((space) => space.key.equals(spaceKeyLike) || space.id === spaceKeyLike);
+  if (spaceId) {
+    return spaces.find((space) => {
+      if (spaceId instanceof PublicKey) {
+        return space.key.equals(spaceId);
+      }
+      return space.id === spaceId;
+    });
   }
   if (ready && client.halo.identity.get()) {
     return client.spaces.default;
   }
 };
+var useDatabase = (spaceId) => {
+  const space = useSpace(spaceId);
+  return space?.db;
+};
 var useSpaces = ({ all = false } = {}) => {
   const client = useClient();
   const spaces = useMulticastObservable(client.spaces);
@@ -49,53 +62,19 @@ var useMembers = (spaceKey) => {
   const spaces = useSpaces({
     all: true
   });
-  const space = spaceKey ? spaces.find((space2) => space2.key.equals(spaceKey)) : void 0;
+  const space = spaceKey ? spaces.find((space2) => spaceKey instanceof PublicKey2 ? space2.key.equals(spaceKey) : space2.id === spaceKey) : void 0;
   const members = useMulticastObservable2(space?.members ?? MulticastObservable.empty()) ?? [];
   return members.filter((member) => member.role !== HaloSpaceMember.Role.REMOVED);
 };
 
-// src/echo/useQuery.ts
-import { useMemo, useSyncExternalStore } from "react";
-import { Filter, Query, isSpace } from "@dxos/client/echo";
-var EMPTY_ARRAY = [];
-var noop = () => {
-};
-var useQuery = (resource, queryOrFilter, deps) => {
-  const query = Filter.is(queryOrFilter) ? Query.select(queryOrFilter) : queryOrFilter;
-  const { getObjects, subscribe } = useMemo(() => {
-    let queryResult = void 0;
-    if (resource) {
-      queryResult = isSpace(resource) ? resource.db.query(query) : resource.query(query);
-    }
-    let subscribed = false;
-    return {
-      getObjects: () => subscribed && queryResult ? queryResult.objects : EMPTY_ARRAY,
-      subscribe: (cb) => {
-        subscribed = true;
-        const unsubscribe = queryResult?.subscribe(cb) ?? noop;
-        return () => {
-          unsubscribe?.();
-          subscribed = false;
-        };
-      }
-    };
-  }, [
-    resource,
-    JSON.stringify(query.ast),
-    ...deps ?? []
-  ]);
-  const objects = useSyncExternalStore(subscribe, getObjects);
-  return objects ?? [];
-};
-
 // src/echo/useQueue.ts
-import { useEffect, useMemo as useMemo2, useRef } from "react";
+import { useEffect, useMemo, useRef } from "react";
 import { raise } from "@dxos/debug";
 var MIN_POLL_INTERVAL = 1e3;
 var useQueue = (queueDxn, options = {}) => {
   const client = useClient();
   const mountedRef = useRef(true);
-  const queue = useMemo2(() => {
+  const queue = useMemo(() => {
     if (!queueDxn) {
       return void 0;
     }
@@ -137,63 +116,34 @@ var useQueue = (queueDxn, options = {}) => {
   return queue;
 };
 
-// src/echo/useSchema.ts
-import { useMemo as useMemo3, useSyncExternalStore as useSyncExternalStore2 } from "react";
-var useSchema = (client, space, typename) => {
-  const { subscribe, getSchema } = useMemo3(() => {
-    if (!typename || !space) {
-      return {
-        subscribe: () => () => {
-        },
-        getSchema: () => void 0
-      };
-    }
-    const staticSchema = client.graph.schemaRegistry.getSchema(typename);
-    if (staticSchema) {
-      return {
-        subscribe: () => () => {
-        },
-        getSchema: () => staticSchema
-      };
-    }
-    const query = space.db.schemaRegistry.query({
-      typename
-    });
-    const initialResult = query.runSync()[0];
-    let currentSchema = initialResult;
-    return {
-      subscribe: (onStoreChange) => {
-        const unsubscribe = query.subscribe(() => {
-          currentSchema = query.results[0];
-          onStoreChange();
-        });
-        return unsubscribe;
-      },
-      getSchema: () => currentSchema
-    };
-  }, [
-    typename,
-    space
-  ]);
-  return useSyncExternalStore2(subscribe, getSchema);
-};
-
 // src/echo/useSpaceInvitations.ts
-import { useMemo as useMemo4 } from "react";
+import { useMemo as useMemo2 } from "react";
 import { MulticastObservable as MulticastObservable2 } from "@dxos/async";
 import { useMulticastObservable as useMulticastObservable3 } from "@dxos/react-hooks";
-var useSpaceInvitations = (spaceKey) => {
-  const space = useSpace(spaceKey);
+var useSpaceInvitations = (spaceId) => {
+  const space = useSpace(spaceId);
   return useMulticastObservable3(space?.invitations ?? MulticastObservable2.empty()) ?? [];
 };
-var useSpaceInvitation = (spaceKey, invitationId) => {
-  const invitations = useSpaceInvitations(spaceKey);
-  const invitation = useMemo4(() => invitations.find((invitation2) => invitation2.get().invitationId === invitationId), [
+var useSpaceInvitation = (spaceId, invitationId) => {
+  const invitations = useSpaceInvitations(spaceId);
+  const invitation = useMemo2(() => invitations.find((invitation2) => invitation2.get().invitationId === invitationId), [
     invitations
   ]);
   return useInvitationStatus(invitation);
 };
 
+// src/echo/useSpaceProperties.ts
+import { MulticastObservable as MulticastObservable3 } from "@dxos/async";
+import { SpaceState as SpaceState2 } from "@dxos/client/echo";
+import { useObject } from "@dxos/echo-react";
+import { useMulticastObservable as useMulticastObservable4 } from "@dxos/react-hooks";
+var useSpaceProperties = (spaceId) => {
+  const space = useSpace(spaceId);
+  const spaceState = useMulticastObservable4(space?.state ?? MulticastObservable3.empty());
+  const properties = spaceState === SpaceState2.SPACE_READY ? space?.properties : void 0;
+  return useObject(properties);
+};
+
 // src/echo/useSubscription.ts
 import { useEffect as useEffect2, useRef as useRef2 } from "react";
 import { createSubscription } from "@dxos/client/echo";
@@ -230,7 +180,7 @@ var useSyncState = () => {
         if (spaceState[space.id]) {
           continue;
         }
-        ctx.onDispose(space.db.subscribeToSyncState(ctx, ({ peers = [] }) => {
+        ctx.onDispose(space.internal.db.subscribeToSyncState(ctx, ({ peers = [] }) => {
           const syncState = peers.find((state) => isEdgePeerId(state.peerId, space.id));
           if (syncState) {
             setSpaceState((spaceState2) => ({
@@ -260,7 +210,7 @@ var useSpaceSyncState = (space) => {
       F: __dxlog_file,
       L: 64
     });
-    space.db.subscribeToSyncState(ctx, ({ peers = [] }) => {
+    space.internal.db.subscribeToSyncState(ctx, ({ peers = [] }) => {
       const syncState = peers.find((state) => isEdgePeerId(state.peerId, space.id));
       if (syncState) {
         setSpaceState(syncState);
@@ -275,13 +225,13 @@ var useSpaceSyncState = (space) => {
   return spaceState;
 };
 export {
+  useDatabase,
   useMembers,
-  useQuery,
   useQueue,
-  useSchema,
   useSpace,
   useSpaceInvitation,
   useSpaceInvitations,
+  useSpaceProperties,
   useSpaceSyncState,
   useSpaces,
   useSubscription,