@dxos/react-client 0.10.0 → 0.11.1

package/.storybook/main.mts

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

package/.storybook/preview.mts

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

package/CHANGELOG.md

@@ -0,0 +1,77 @@
+# @dxos/react-client
+
+## 0.11.1
+
+### Patch Changes
+
+- @dxos/async@0.11.1
+- @dxos/client@0.11.1
+- @dxos/codec-protobuf@0.11.1
+- @dxos/config@0.11.1
+- @dxos/context@0.11.1
+- @dxos/debug@0.11.1
+- @dxos/echo@0.11.1
+- @dxos/echo-protocol@0.11.1
+- @dxos/echo-react@0.11.1
+- @dxos/invariant@0.11.1
+- @dxos/keys@0.11.1
+- @dxos/log@0.11.1
+- @dxos/node-std@0.11.1
+- @dxos/react-hooks@0.11.1
+- @dxos/util@0.11.1
+
+## 0.11.0
+
+### Patch Changes
+
+- c9da903: Move the `useFlush` hook from `@dxos/plugin-assistant/hooks` to `@dxos/react-client/echo`. It operates on a `Space`, so it belongs with the other space hooks; import it from `@dxos/react-client/echo` instead of `@dxos/plugin-assistant/hooks`.
+- Updated dependencies [f9ba47a]
+- Updated dependencies [4e64123]
+- Updated dependencies [c035062]
+- Updated dependencies [aea1e6e]
+- Updated dependencies [46ec569]
+- Updated dependencies [b5ecf54]
+- Updated dependencies [3f6ac61]
+- Updated dependencies [091ebe4]
+- Updated dependencies [eec72c5]
+- Updated dependencies [3f1fc67]
+- Updated dependencies [6df314a]
+- Updated dependencies [856c4f0]
+- Updated dependencies [46ec569]
+- Updated dependencies [f8637f1]
+- Updated dependencies [b8c0825]
+- Updated dependencies [4e64123]
+- Updated dependencies [6a03a30]
+- Updated dependencies [7b270f2]
+- Updated dependencies [7b270f2]
+- Updated dependencies [af5fbf4]
+- Updated dependencies [d547045]
+- Updated dependencies [410a019]
+- Updated dependencies [f6a01e3]
+- Updated dependencies [9cde1c6]
+- Updated dependencies [923d5be]
+- Updated dependencies [85893fe]
+- Updated dependencies [12fd785]
+- Updated dependencies [d547045]
+- Updated dependencies [5f08a6a]
+- Updated dependencies [f15c632]
+- Updated dependencies [3761762]
+- Updated dependencies [4bb7e3b]
+- Updated dependencies [41141d8]
+- Updated dependencies [686fac1]
+- Updated dependencies [ac51564]
+  - @dxos/echo@0.11.0
+  - @dxos/async@0.11.0
+  - @dxos/client@0.11.0
+  - @dxos/util@0.11.0
+  - @dxos/keys@0.11.0
+  - @dxos/log@0.11.0
+  - @dxos/echo-react@0.11.0
+  - @dxos/config@0.11.0
+  - @dxos/codec-protobuf@0.11.0
+  - @dxos/react-hooks@0.11.0
+  - @dxos/context@0.11.0
+  - @dxos/echo-protocol@0.11.0
+  - @dxos/debug@0.11.0
+  - @dxos/invariant@0.11.0
+  - @dxos/node-std@0.11.0

package/dist/lib/chunk-ClientProvider.mjs

@@ -0,0 +1,152 @@
+import { n as ClientContext } from "./chunk-context.mjs";
+import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
+import { Client, SystemStatus } from "@dxos/client";
+import { log } from "@dxos/log";
+import { jsx } from "react/jsx-runtime";
+import { useAsyncEffect, useControlledState } from "@dxos/react-hooks";
+import { getAsyncProviderValue } from "@dxos/util";
+//#region src/banner.ts
+var BANNER = (client) => {
+	const commitHash = client.config.get("runtime.app.build.commitHash");
+	const hash = commitHash ? ` App Commit ${commitHash} \n` : "";
+	return `
+_/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\______/\\/\\/\\/\\/\\_
+_/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__/\\/\\_________
+_/\\/\\____/\\/\\______/\\/\\______/\\/\\____/\\/\\____/\\/\\/\\/\\___
+_/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__________/\\/\\_
+_/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\/\\/\\/\\___
+\n DXOS Client ${client.version} \n${hash}`;
+};
+var bannerPrinted = false;
+var printBanner = (client) => {
+	if (bannerPrinted || window.location.hostname === "localhost") return;
+	bannerPrinted = true;
+	console.log(`%c${BANNER(client)}`, "font-family: monospace;");
+};
+//#endregion
+//#region src/client/ClientProvider.tsx
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/react-client/src/client/ClientProvider.tsx";
+/**
+* Root component that provides the DXOS client instance to child components.
+* To be used with the `useClient` hook.
+*/
+var ClientProvider = 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((status) => setStatus(status));
+		return () => subscription.unsubscribe();
+	}, [client]);
+	useAsyncEffect(async () => {
+		let disposed = false;
+		const initialize = async (client) => {
+			if (!client.initialized) {
+				await client.initialize().catch((err) => {
+					if (!disposed) setError(err);
+				});
+				log("client ready", void 0, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 123,
+					S: void 0
+				});
+				await onInitialized?.(client);
+				log("initialization complete", void 0, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 125,
+					S: void 0
+				});
+			}
+			setClient(client);
+			if (!noBanner) printBanner(client);
+		};
+		let client;
+		try {
+			if (clientProp) {
+				client = await getAsyncProviderValue(clientProp);
+				await initialize(client);
+			} else {
+				const config = await getAsyncProviderValue(configProp);
+				log("resolved config", { config }, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 143,
+					S: void 0
+				});
+				const services = await getAsyncProviderValue(servicesProp, config);
+				log("created services", { services }, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 145,
+					S: void 0
+				});
+				client = new Client({
+					config,
+					services,
+					...options
+				});
+				log("created client", void 0, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 147,
+					S: void 0
+				});
+				await initialize(client);
+			}
+		} catch (err) {
+			if (!disposed) log.catch(err, void 0, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 152,
+				S: void 0
+			});
+		}
+		return () => {
+			log("clean up", void 0, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 157,
+				S: void 0
+			});
+			disposed = true;
+			if (!clientProp) client?.destroy().then(() => {
+				log("destroyed", void 0, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 164,
+					S: void 0
+				});
+			}).catch((err) => log.catch(err, void 0, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 166,
+				S: void 0
+			}));
+		};
+	}, [
+		configProp,
+		clientProp,
+		servicesProp,
+		noBanner
+	]);
+	if (!client?.initialized || status !== SystemStatus.ACTIVE) return /* @__PURE__ */ jsx(Fallback, {
+		client,
+		status
+	});
+	return /* @__PURE__ */ jsx(ClientContext.Provider, {
+		value: {
+			client,
+			status
+		},
+		children
+	});
+});
+//#endregion
+export { ClientProvider as t };
+
+//# sourceMappingURL=chunk-ClientProvider.mjs.map

package/dist/lib/chunk-ClientProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-ClientProvider.mjs","names":[],"sources":["../../src/banner.ts","../../src/client/ClientProvider.tsx"],"sourcesContent":["//\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","//\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';\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"],"mappings":"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"}

package/dist/lib/chunk-context.mjs

@@ -0,0 +1,14 @@
+import { createContext, useContext } from "react";
+//#region src/client/context.ts
+/**
+* @internal Use ClientProvider to create or initialize the Client.
+*/
+var ClientContext = createContext(void 0);
+var AgentHostingContext = createContext(null);
+var useAgentHostingClient = () => {
+	return useContext(AgentHostingContext);
+};
+//#endregion
+export { ClientContext as n, useAgentHostingClient as r, AgentHostingContext as t };
+
+//# sourceMappingURL=chunk-context.mjs.map

package/dist/lib/chunk-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-context.mjs","names":[],"sources":["../../src/client/context.ts"],"sourcesContent":["//\n// Copyright 2020 DXOS.org\n//\n\nimport { type Context, createContext, useContext } from 'react';\n\nimport { type AgentHostingProviderClient, 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\n// Kept out of `AgentHostingProvider.tsx`: react-refresh only fast-refreshes a module whose exports\n// are all components, so a context and hook exported beside the provider make it a reload boundary\n// for everything downstream of it.\nexport const AgentHostingContext = createContext<AgentHostingProviderClient | null>(null);\n\nexport const useAgentHostingClient = () => {\n  return useContext(AgentHostingContext);\n};\n"],"mappings":";;;;;AAgBA,IAAa,gBAAyD,cACpE,KAAA,CACF;AAKA,IAAa,sBAAsB,cAAiD,IAAI;AAExF,IAAa,8BAA8B;CACzC,OAAO,WAAW,mBAAmB;AACvC"}

package/dist/lib/chunk-useClient.mjs

@@ -0,0 +1,16 @@
+import { n as ClientContext } from "./chunk-context.mjs";
+import { raise } from "@dxos/debug";
+import { useContext } from "react";
+//#region src/client/useClient.ts
+/**
+* Hook returning instance of DXOS client.
+* Requires ClientContext to be set via ClientProvider.
+*/
+var useClient = () => {
+	const { client } = useContext(ClientContext) ?? raise(/* @__PURE__ */ new Error("Missing ClientContext."));
+	return client;
+};
+//#endregion
+export { useClient as t };
+
+//# sourceMappingURL=chunk-useClient.mjs.map

package/dist/lib/chunk-useClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-useClient.mjs","names":[],"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":";;;;;;;;AAcA,IAAa,kBAAkB;CAC7B,MAAM,EAAE,WAAW,WAAW,aAAa,KAAK,sBAAM,IAAI,MAAM,wBAAwB,CAAC;CACzF,OAAO;AACT"}

package/dist/lib/devtools.mjs

@@ -0,0 +1,37 @@
+import { t as useClient } from "./chunk-useClient.mjs";
+import { raise } from "@dxos/debug";
+import { useEffect, useState } from "react";
+import { log } from "@dxos/log";
+export * from "@dxos/client/devtools";
+//#region src/devtools/useDevtools.ts
+var useDevtools = () => {
+	return useClient().services.services.DevtoolsHost ?? raise(/* @__PURE__ */ new Error("DevtoolsHost not available."));
+};
+//#endregion
+//#region src/devtools/useStream.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/react-client/src/devtools/useStream.ts";
+/**
+* Subscribe to service API streams.
+*/
+var useStream = (streamFactory, defaultValue, deps = []) => {
+	const [value, setValue] = useState(defaultValue);
+	useEffect(() => {
+		const stream = streamFactory();
+		stream.subscribe((response) => setValue(response), (err) => {
+			if (err) log.catch(err, void 0, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 21,
+				S: void 0
+			});
+		});
+		return () => {
+			stream.close();
+		};
+	}, deps);
+	return value ?? defaultValue;
+};
+//#endregion
+export { useDevtools, useStream };
+
+//# sourceMappingURL=devtools.mjs.map

package/dist/lib/devtools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.mjs","names":[],"sources":["../../src/devtools/useDevtools.ts","../../src/devtools/useStream.ts"],"sourcesContent":["//\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":";;;;;;AASA,IAAa,oBAAkC;CAE7C,OADe,UACR,CAAA,CAAO,SAAS,SAAS,gBAAgB,sBAAM,IAAI,MAAM,6BAA6B,CAAC;AAChG;;;;;;;ACAA,IAAa,aAAgB,eAAgC,cAAiB,OAAuB,CAAC,MAAS;CAC7G,MAAM,CAAC,OAAO,YAAY,SAAwB,YAAY;CAC9D,gBAAgB;EACd,MAAM,SAAS,cAAc;EAC7B,OAAO,WACJ,aAAgB,SAAS,QAAQ,IACjC,QAAQ;GACP,IAAI,KACF,IAAI,MAAM,KAAE,KAAA,GAAA;IAAA,YAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA,KAAA;GAAA,CAAC;EAEjB,CACF;EAEA,aAAa;GACX,OAAY,MAAM;EACpB;CACF,GAAG,IAAI;CAEP,OAAO,SAAS;AAClB"}

package/dist/lib/echo.mjs

@@ -0,0 +1,230 @@
+import { t as useClient } from "./chunk-useClient.mjs";
+import { useInvitationStatus } from "./invitations.mjs";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { PublicKey } from "@dxos/client";
+import { useMulticastObservable } from "@dxos/react-hooks";
+import { HaloSpaceMember, SpaceState, createSubscription } from "@dxos/client/echo";
+import { useObject } from "@dxos/echo-react";
+import { MulticastObservable } from "@dxos/async";
+import { Context } from "@dxos/context";
+import { isEdgePeerId } from "@dxos/echo-protocol";
+export * from "@dxos/client/echo";
+export * from "@dxos/echo-react";
+//#region src/echo/useSpaces.ts
+/**
+* Get a specific Space using its id.
+* The space is not guaranteed to be in the ready state.
+* Returns undefined if no id is provided.
+* Requires a ClientProvider somewhere in the parent tree.
+*
+* @param spaceId the id of the space to look for.
+*/
+var useSpace = (spaceId) => {
+	const spaces = useMulticastObservable(useClient().spaces);
+	if (!spaceId) return;
+	return spaces.find((space) => {
+		if (spaceId instanceof PublicKey) return space.key.equals(spaceId);
+		return space.id === spaceId;
+	});
+};
+/**
+* Get all Spaces available to current user.
+* Requires a ClientProvider somewhere in the parent tree.
+* By default, only ready spaces are returned.
+* @returns an array of Spaces.
+*/
+var useSpaces = ({ all = false } = {}) => {
+	return useMulticastObservable(useClient().spaces).filter((space) => all || space.state.get() === SpaceState.SPACE_READY);
+};
+//#endregion
+//#region src/echo/useMembers.ts
+var useMembers = (spaceKey) => {
+	const spaces = useSpaces({ all: true });
+	return (useMulticastObservable((spaceKey ? spaces.find((space) => spaceKey instanceof PublicKey ? space.key.equals(spaceKey) : space.id === spaceKey) : void 0)?.members ?? MulticastObservable.empty()) ?? []).filter((member) => member.role !== HaloSpaceMember.Role.REMOVED);
+};
+//#endregion
+//#region src/echo/useSpaceInvitations.ts
+var useSpaceInvitations = (spaceId) => {
+	return useMulticastObservable(useSpace(spaceId)?.invitations ?? MulticastObservable.empty()) ?? [];
+};
+var useSpaceInvitation = (spaceId, invitationId) => {
+	const invitations = useSpaceInvitations(spaceId);
+	return useInvitationStatus(useMemo(() => invitations.find((invitation) => invitation.get().invitationId === invitationId), [invitations]));
+};
+//#endregion
+//#region src/echo/useSpaceProperties.ts
+/**
+* Subscribe to a space's properties with reactive updates.
+* Returns undefined if the space is undefined or not ready yet.
+* Automatically waits for the space to be ready before returning properties.
+*
+* @param spaceId - The space ID to get properties from (can be undefined).
+* @returns A tuple of [snapshot, updateCallback] or [undefined, no-op] if not ready.
+*/
+var useSpaceProperties = (spaceId) => {
+	const space = useSpace(spaceId);
+	return useObject(useMulticastObservable(space?.state ?? MulticastObservable.empty()) === SpaceState.SPACE_READY ? space?.properties : void 0);
+};
+//#endregion
+//#region src/echo/useFlush.ts
+/**
+* Flushes a space's database to storage, exposing a transient `idle → flushing → flushed → idle`
+* state suitable for driving a toolbar affordance.
+*/
+var useFlush = (space) => {
+	const [state, setState] = useState("idle");
+	const resetTimer = useRef(null);
+	return {
+		state,
+		handleFlush: useCallback(() => {
+			if (!space) return;
+			queueMicrotask(async () => {
+				if (resetTimer.current) clearTimeout(resetTimer.current);
+				setState("flushing");
+				await space.db.flush();
+				setState("flushed");
+				resetTimer.current = setTimeout(() => {
+					setState("idle");
+					resetTimer.current = null;
+				}, 1e3);
+			});
+		}, [space])
+	};
+};
+//#endregion
+//#region src/echo/useSubscription.ts
+/**
+* Create reactive selection.
+* Calls the callback when the selection changes and during the first render.
+*/
+var useSubscription = (cb, selection) => {
+	const callbackRef = useRef(cb);
+	callbackRef.current = cb;
+	const subscriptionRef = useRef(null);
+	useEffect(() => {
+		subscriptionRef.current = createSubscription(() => {
+			callbackRef.current();
+		});
+		return () => subscriptionRef.current?.unsubscribe();
+	}, []);
+	subscriptionRef.current?.update(selection);
+	return subscriptionRef.current;
+};
+//#endregion
+//#region src/echo/useSyncState.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/react-client/src/echo/useSyncState.ts";
+/**
+* Hook Subscribes to sync state for each space.
+*/
+var useSyncState = () => {
+	const client = useClient();
+	const [spaceState, setSpaceState] = useState({});
+	useEffect(() => {
+		const ctx = new Context(void 0, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 21
+		});
+		const createSubscriptions = (spaces) => {
+			for (const space of spaces) {
+				if (spaceState[space.id]) continue;
+				ctx.onDispose(space.internal.db.subscribeToAutomergeSyncState(ctx, ({ peers = [] }) => {
+					const syncState = peers.find((state) => isEdgePeerId(state.peerId, space.id));
+					if (syncState) setSpaceState((spaceState) => ({
+						...spaceState,
+						[space.id]: syncState
+					}));
+				}));
+			}
+		};
+		createSubscriptions(client.spaces.get());
+		client.spaces.subscribe((spaces) => {
+			createSubscriptions(spaces);
+		});
+		return () => {
+			ctx.dispose();
+		};
+	}, [client]);
+	return spaceState;
+};
+/**
+* Hook Subscribes to sync state for a single space.
+*/
+var useSpaceSyncState = (space) => {
+	const [spaceState, setSpaceState] = useState();
+	useEffect(() => {
+		const ctx = new Context(void 0, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 60
+		});
+		space.internal.db.subscribeToAutomergeSyncState(ctx, ({ peers = [] }) => {
+			const syncState = peers.find((state) => isEdgePeerId(state.peerId, space.id));
+			if (syncState) setSpaceState(syncState);
+		});
+		return () => {
+			ctx.dispose();
+		};
+	}, [space]);
+	return spaceState;
+};
+//#endregion
+//#region src/echo/useFeedSyncState.ts
+var DEFAULT_POLL_INTERVAL_MS = 5e3;
+/**
+* Polls feed replication state per space.
+*/
+var useFeedSyncState = (pollIntervalMs = DEFAULT_POLL_INTERVAL_MS) => {
+	const client = useClient();
+	const [feedSyncState, setFeedSyncState] = useState({});
+	useEffect(() => {
+		const feedService = client.services.services.FeedService;
+		if (!feedService) return;
+		let cancelled = false;
+		const poll = async () => {
+			const spaces = client.spaces.get();
+			const entries = await Promise.all(spaces.map(async (space) => {
+				try {
+					const state = ((await feedService.getSyncState({ spaceId: space.id })).namespaces ?? []).reduce((acc, entry) => {
+						acc.pending += Number(entry.blocksToPull ?? 0) + Number(entry.blocksToPush ?? 0);
+						acc.total += Number(entry.totalBlocks ?? 0);
+						return acc;
+					}, {
+						pending: 0,
+						total: 0
+					});
+					return [space.id, state];
+				} catch {
+					return [space.id, {
+						pending: 0,
+						total: 0
+					}];
+				}
+			}));
+			if (!cancelled) setFeedSyncState(Object.fromEntries(entries));
+		};
+		poll();
+		const interval = setInterval(() => void poll(), pollIntervalMs);
+		const spacesSubscription = client.spaces.subscribe(() => {
+			poll();
+		});
+		return () => {
+			cancelled = true;
+			clearInterval(interval);
+			spacesSubscription.unsubscribe();
+		};
+	}, [client, pollIntervalMs]);
+	return feedSyncState;
+};
+//#endregion
+//#region src/echo/useRegistry.ts
+/**
+* Returns the hypergraph registry attached to the current client.
+*/
+var useRegistry = () => {
+	return useClient().graph.registry;
+};
+//#endregion
+export { useFeedSyncState, useFlush, useMembers, useRegistry, useSpace, useSpaceInvitation, useSpaceInvitations, useSpaceProperties, useSpaceSyncState, useSpaces, useSubscription, useSyncState };
+
+//# sourceMappingURL=echo.mjs.map

package/dist/lib/echo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.mjs","names":[],"sources":["../../src/echo/useSpaces.ts","../../src/echo/useMembers.ts","../../src/echo/useSpaceInvitations.ts","../../src/echo/useSpaceProperties.ts","../../src/echo/useFlush.ts","../../src/echo/useSubscription.ts","../../src/echo/useSyncState.ts","../../src/echo/useFeedSyncState.ts","../../src/echo/useRegistry.ts"],"sourcesContent":["//\n// Copyright 2020 DXOS.org\n//\n\nimport { PublicKey } from '@dxos/client';\nimport { type Space, SpaceState } from '@dxos/client/echo';\nimport { type SpaceId } from '@dxos/keys';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useClient } from '../client';\n\n/**\n * Get a specific Space using its id.\n * The space is not guaranteed to be in the ready state.\n * Returns undefined if no id is provided.\n * Requires a ClientProvider somewhere in the parent tree.\n *\n * @param spaceId the id of the space to look for.\n */\n// TODO(wittjosiah): Currently unable to remove `PublicKey` from this api.\n//  When initially joining a space that is all that is returned.\nexport const useSpace = (spaceId?: SpaceId | PublicKey): Space | undefined => {\n  const client = useClient();\n  const spaces = useMulticastObservable<Space[]>(client.spaces);\n  if (!spaceId) {\n    return undefined;\n  }\n\n  return spaces.find((space) => {\n    if (spaceId instanceof PublicKey) {\n      return space.key.equals(spaceId);\n    }\n\n    return space.id === spaceId;\n  });\n};\n\nexport type UseSpacesProps = {\n  /**\n   * Return uninitialized spaces as well.\n   */\n  all?: boolean;\n};\n\n/**\n * Get all Spaces available to current user.\n * Requires a ClientProvider somewhere in the parent tree.\n * By default, only ready spaces are returned.\n * @returns an array of Spaces.\n */\nexport const useSpaces = ({ all = false }: UseSpacesProps = {}): Space[] => {\n  const client = useClient();\n  const spaces = useMulticastObservable<Space[]>(client.spaces);\n\n  // TODO(dmaretskyi): Array reference equality.\n  return spaces.filter((space) => all || space.state.get() === SpaceState.SPACE_READY);\n};\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport { MulticastObservable } from '@dxos/async';\nimport { PublicKey, type PublicKeyLike } from '@dxos/client';\nimport { HaloSpaceMember, type SpaceMember } from '@dxos/client/echo';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useSpaces } from './useSpaces';\n\nexport const useMembers = (spaceKey: PublicKeyLike | undefined): SpaceMember[] => {\n  // TODO(dmaretskyi): useSpace hook for spaces that are not ready.\n  const spaces = useSpaces({ all: true });\n  const space = spaceKey\n    ? spaces.find((space) => (spaceKey instanceof PublicKey ? space.key.equals(spaceKey) : space.id === spaceKey))\n    : undefined;\n\n  // EMPTY_OBSERVABLE needs to be a stable reference to avoid re-subscribing on every render.\n  const members = useMulticastObservable(space?.members ?? MulticastObservable.empty()) ?? [];\n  return members.filter((member) => member.role !== HaloSpaceMember.Role.REMOVED);\n};\n","//\n// Copyright 2022 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\nimport { MulticastObservable } from '@dxos/async';\nimport { type PublicKey } from '@dxos/client';\nimport { type SpaceId } from '@dxos/keys';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { type CancellableInvitationObservable, useInvitationStatus } from '../invitations';\nimport { useSpace } from './useSpaces';\n\n// TODO(wittjosiah): Currently unable to remove `PublicKey` from this api.\n//  When initially joining a space that is all that is returned.\nexport const useSpaceInvitations = (spaceId?: SpaceId | PublicKey): CancellableInvitationObservable[] => {\n  const space = useSpace(spaceId);\n  return useMulticastObservable(space?.invitations ?? MulticastObservable.empty()) ?? [];\n};\n\n// TODO(wittjosiah): Currently unable to remove `PublicKey` from this api.\n//  When initially joining a space that is all that is returned.\nexport const useSpaceInvitation = (spaceId?: SpaceId | PublicKey, invitationId?: string) => {\n  const invitations = useSpaceInvitations(spaceId);\n  const invitation = useMemo(\n    () => invitations.find((invitation) => invitation.get().invitationId === invitationId),\n    [invitations],\n  );\n  return useInvitationStatus(invitation);\n};\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport { MulticastObservable } from '@dxos/async';\nimport { type SpaceProperties, SpaceState } from '@dxos/client/echo';\nimport { type Key, type Obj } from '@dxos/echo';\nimport { type ObjectUpdateCallback, useObject } from '@dxos/echo-react';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useSpace } from './useSpaces';\n\n/**\n * Subscribe to a space's properties with reactive updates.\n * Returns undefined if the space is undefined or not ready yet.\n * Automatically waits for the space to be ready before returning properties.\n *\n * @param spaceId - The space ID to get properties from (can be undefined).\n * @returns A tuple of [snapshot, updateCallback] or [undefined, no-op] if not ready.\n */\nexport const useSpaceProperties = (\n  spaceId: Key.SpaceId | undefined,\n): [Obj.Snapshot<SpaceProperties> | undefined, ObjectUpdateCallback<SpaceProperties>] => {\n  const space = useSpace(spaceId);\n  const spaceState = useMulticastObservable(space?.state ?? MulticastObservable.empty());\n  const properties = spaceState === SpaceState.SPACE_READY ? space?.properties : undefined;\n  return useObject(properties);\n};\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport { useCallback, useRef, useState } from 'react';\n\nimport { type Space } from '@dxos/client/echo';\n\n/**\n * Flushes a space's database to storage, exposing a transient `idle → flushing → flushed → idle`\n * state suitable for driving a toolbar affordance.\n */\nexport const useFlush = (space?: Space) => {\n  const [state, setState] = useState<'idle' | 'flushing' | 'flushed'>('idle');\n  const resetTimer = useRef<NodeJS.Timeout | null>(null);\n\n  const handleFlush = useCallback(() => {\n    if (!space) {\n      return;\n    }\n\n    queueMicrotask(async () => {\n      if (resetTimer.current) {\n        clearTimeout(resetTimer.current);\n      }\n\n      setState('flushing');\n      await space.db.flush();\n      setState('flushed');\n\n      resetTimer.current = setTimeout(() => {\n        setState('idle');\n        resetTimer.current = null;\n      }, 1_000);\n    });\n  }, [space]);\n\n  return { state, handleFlush };\n};\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport { useEffect, useRef } from 'react';\n\nimport { type Selection, type SubscriptionHandle, createSubscription } from '@dxos/client/echo';\n\n/**\n * Create reactive selection.\n * Calls the callback when the selection changes and during the first render.\n */\n// TODO(wittjosiah): Is this still needed with signals reactivity? If not, remove or update jsdoc with usage info.\nexport const useSubscription = (cb: () => void, selection: Selection) => {\n  // Make sure that the callback is always the one from the latest render.\n  // Without this, we would always call the callback from the initial render,\n  // which might contain stale data.\n  const callbackRef = useRef(cb);\n  callbackRef.current = cb;\n\n  const subscriptionRef = useRef<SubscriptionHandle>(null);\n\n  useEffect(() => {\n    subscriptionRef.current = createSubscription(() => {\n      callbackRef.current();\n    });\n\n    return () => subscriptionRef.current?.unsubscribe();\n  }, []);\n\n  subscriptionRef.current?.update(selection);\n  return subscriptionRef.current;\n};\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type PeerSyncState, type Space, type SpaceSyncStateMap } from '@dxos/client/echo';\nimport { Context } from '@dxos/context';\nimport { isEdgePeerId } from '@dxos/echo-protocol';\n\nimport { useClient } from '../client';\n\n/**\n * Hook Subscribes to sync state for each space.\n */\nexport const useSyncState = (): SpaceSyncStateMap => {\n  const client = useClient();\n  const [spaceState, setSpaceState] = useState<SpaceSyncStateMap>({});\n\n  useEffect(() => {\n    const ctx = new Context();\n    const createSubscriptions = (spaces: Space[]) => {\n      for (const space of spaces) {\n        if (spaceState[space.id]) {\n          continue;\n        }\n\n        ctx.onDispose(\n          space.internal.db.subscribeToAutomergeSyncState(ctx, ({ peers = [] }) => {\n            const syncState = peers.find((state) => isEdgePeerId(state.peerId, space.id));\n            if (syncState) {\n              setSpaceState((spaceState) => ({ ...spaceState, [space.id]: syncState }));\n            }\n          }),\n        );\n      }\n    };\n\n    createSubscriptions(client.spaces.get());\n    client.spaces.subscribe((spaces) => {\n      createSubscriptions(spaces);\n    });\n\n    return () => {\n      void ctx.dispose();\n    };\n  }, [client]);\n\n  return spaceState;\n};\n\n/**\n * Hook Subscribes to sync state for a single space.\n */\n// TODO(wittjosiah): Reconcile w/ useSyncState.\nexport const useSpaceSyncState = (space: Space): PeerSyncState | undefined => {\n  const [spaceState, setSpaceState] = useState<PeerSyncState>();\n\n  useEffect(() => {\n    const ctx = new Context();\n    space.internal.db.subscribeToAutomergeSyncState(ctx, ({ peers = [] }) => {\n      const syncState = peers.find((state) => isEdgePeerId(state.peerId, space.id));\n      if (syncState) {\n        setSpaceState(syncState);\n      }\n    });\n\n    return () => {\n      void ctx.dispose();\n    };\n  }, [space]);\n\n  return spaceState;\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type SpaceId } from '@dxos/keys';\n\nimport { useClient } from '../client';\n\nconst DEFAULT_POLL_INTERVAL_MS = 5_000;\n\nexport type FeedSyncState = {\n  /** Combined blocks to pull + push across namespaces. */\n  pending: number;\n  /** Total blocks stored locally across namespaces. */\n  total: number;\n};\n\nexport type FeedSyncStateMap = Record<SpaceId, FeedSyncState>;\n\n/**\n * Polls feed replication state per space.\n */\nexport const useFeedSyncState = (pollIntervalMs = DEFAULT_POLL_INTERVAL_MS): FeedSyncStateMap => {\n  const client = useClient();\n  const [feedSyncState, setFeedSyncState] = useState<FeedSyncStateMap>({});\n\n  useEffect(() => {\n    const feedService = client.services.services.FeedService;\n    if (!feedService) {\n      return;\n    }\n\n    let cancelled = false;\n\n    const poll = async () => {\n      const spaces = client.spaces.get();\n      const entries = await Promise.all(\n        spaces.map(async (space) => {\n          try {\n            const response = await feedService.getSyncState({ spaceId: space.id });\n            const state = (response.namespaces ?? []).reduce<FeedSyncState>(\n              (acc, entry) => {\n                acc.pending += Number(entry.blocksToPull ?? 0) + Number(entry.blocksToPush ?? 0);\n                acc.total += Number(entry.totalBlocks ?? 0);\n                return acc;\n              },\n              { pending: 0, total: 0 },\n            );\n            return [space.id, state] as const;\n          } catch {\n            return [space.id, { pending: 0, total: 0 }] as const;\n          }\n        }),\n      );\n\n      if (!cancelled) {\n        setFeedSyncState(Object.fromEntries(entries));\n      }\n    };\n\n    void poll();\n    const interval = setInterval(() => void poll(), pollIntervalMs);\n\n    const spacesSubscription = client.spaces.subscribe(() => {\n      void poll();\n    });\n\n    return () => {\n      cancelled = true;\n      clearInterval(interval);\n      spacesSubscription.unsubscribe();\n    };\n  }, [client, pollIntervalMs]);\n\n  return feedSyncState;\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { type Registry } from '@dxos/echo';\n\nimport { useClient } from '../client';\n\n/**\n * Returns the hypergraph registry attached to the current client.\n */\nexport const useRegistry = (): Registry.Registry => {\n  const client = useClient();\n  return client.graph.registry;\n};\n"],"mappings":"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"}