@dxos/react-client 0.10.0 → 0.11.0

package/dist/lib/halo.mjs

@@ -0,0 +1,85 @@
+import { t as useClient } from "./chunk-useClient.mjs";
+import { useInvitationStatus } from "./invitations.mjs";
+import { useMemo, useReducer } from "react";
+import { useMulticastObservable } from "@dxos/react-hooks";
+import { Device, DeviceKind, DeviceType } from "@dxos/client/halo";
+//#region src/halo/useContacts.ts
+/**
+* Returns all known Contacts across all Spaces.
+* Contacts are known members of a common Space.
+* Requires ClientContext to be set via ClientProvider.
+*/
+var useContacts = () => {
+	return useMulticastObservable(useClient().halo.contacts);
+};
+//#endregion
+//#region src/halo/useCredentials.ts
+var useCredentials = () => {
+	return useMulticastObservable(useClient().halo.credentials);
+};
+//#endregion
+//#region src/halo/useDevices.ts
+var useDevices = () => {
+	return useMulticastObservable(useClient().halo.devices);
+};
+//#endregion
+//#region src/halo/useHaloInvitations.ts
+var useHaloInvitations = () => {
+	return useMulticastObservable(useClient().halo.invitations);
+};
+var useHaloInvitation = (invitationId) => {
+	const invitations = useHaloInvitations();
+	return useInvitationStatus(useMemo(() => invitations.find((invitation) => invitation.get().invitationId === invitationId), [invitations]));
+};
+//#endregion
+//#region src/halo/useIdentity.ts
+/**
+* Hook returning DXOS identity object.
+* Requires ClientContext to be set via ClientProvider.
+*/
+var useIdentity = () => {
+	return useMulticastObservable(useClient().halo.identity);
+};
+//#endregion
+//#region src/halo/useKeyStore.ts
+var KeyStore = class {
+	_defaultKeys;
+	_keyMap = /* @__PURE__ */ new Map();
+	constructor(_defaultKeys = []) {
+		this._defaultKeys = _defaultKeys;
+	}
+	get map() {
+		return this._keyMap;
+	}
+	initialize() {
+		this._defaultKeys.forEach((key) => {
+			const value = localStorage.getItem(key);
+			this.setKey(key, value ?? "");
+		});
+		return this;
+	}
+	getKey(key) {
+		localStorage.getItem(key);
+	}
+	setKey(key, value) {
+		localStorage.setItem(key, "");
+		this._keyMap.set(key, value);
+	}
+};
+/**
+* Settings store.
+* @deprecated Replace with HALO key store when available.
+*/
+var useKeyStore = (defaultKeys = []) => {
+	const [, forceUpdate] = useReducer((x) => x + 1, 0);
+	const store = useMemo(() => new KeyStore(defaultKeys).initialize(), [defaultKeys]);
+	const setKey = (key, value) => {
+		store.setKey(key, value);
+		forceUpdate();
+	};
+	return [store.map, setKey];
+};
+//#endregion
+export { Device, DeviceKind, DeviceType, KeyStore, useContacts, useCredentials, useDevices, useHaloInvitation, useHaloInvitations, useIdentity, useKeyStore };
+
+//# sourceMappingURL=halo.mjs.map

package/dist/lib/halo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"halo.mjs","names":[],"sources":["../../src/halo/useContacts.ts","../../src/halo/useCredentials.ts","../../src/halo/useDevices.ts","../../src/halo/useHaloInvitations.ts","../../src/halo/useIdentity.ts","../../src/halo/useKeyStore.ts"],"sourcesContent":["//\n// Copyright 2020 DXOS.org\n//\n\nimport type { Contact } from '@dxos/client/halo';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useClient } from '../client';\n\n/**\n * Returns all known Contacts across all Spaces.\n * Contacts are known members of a common Space.\n * Requires ClientContext to be set via ClientProvider.\n */\nexport const useContacts = (): Contact[] => {\n  const client = useClient();\n  return useMulticastObservable(client.halo.contacts);\n};\n","//\n// Copyright 2020 DXOS.org\n//\n\nimport type { Credential } from '@dxos/client/halo';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useClient } from '../client';\n\nexport const useCredentials = (): Credential[] => {\n  const client = useClient();\n  return useMulticastObservable(client.halo.credentials);\n};\n","//\n// Copyright 2020 DXOS.org\n//\n\nimport type { Device } from '@dxos/client/halo';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useClient } from '../client';\n\nexport const useDevices = (): Device[] => {\n  const client = useClient();\n  return useMulticastObservable(client.halo.devices);\n};\n","//\n// Copyright 2022 DXOS.org\n//\n\nimport { useMemo } from 'react';\n\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useClient } from '../client';\nimport { type CancellableInvitationObservable, useInvitationStatus } from '../invitations';\n\nexport const useHaloInvitations = (): CancellableInvitationObservable[] => {\n  const client = useClient();\n  return useMulticastObservable(client.halo.invitations);\n};\n\nexport const useHaloInvitation = (invitationId?: string) => {\n  const invitations = useHaloInvitations();\n  const invitation = useMemo(\n    () => invitations.find((invitation) => invitation.get().invitationId === invitationId),\n    [invitations],\n  );\n  return useInvitationStatus(invitation);\n};\n","//\n// Copyright 2020 DXOS.org\n//\n\nimport { type Identity } from '@dxos/client/halo';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useClient } from '../client';\n\n/**\n * Hook returning DXOS identity object.\n * Requires ClientContext to be set via ClientProvider.\n */\nexport const useIdentity = (): Identity | null => {\n  const client = useClient();\n  return useMulticastObservable(client.halo.identity);\n};\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport { useMemo, useReducer } from 'react';\n\n// TODO(burdon): Move to settings plugin.\nexport class KeyStore {\n  private _keyMap = new Map<string, string>();\n\n  constructor(private readonly _defaultKeys: string[] = []) {}\n\n  get map() {\n    return this._keyMap;\n  }\n\n  // TODO(burdon): Create subkeys.\n  initialize(): this {\n    this._defaultKeys.forEach((key) => {\n      const value = localStorage.getItem(key);\n      this.setKey(key, value ?? '');\n    });\n\n    return this;\n  }\n\n  getKey(key: string): void {\n    localStorage.getItem(key);\n  }\n\n  setKey(key: string, value: string): void {\n    localStorage.setItem(key, '');\n    this._keyMap.set(key, value);\n  }\n}\n\n/**\n * Settings store.\n * @deprecated Replace with HALO key store when available.\n */\nexport const useKeyStore = (\n  defaultKeys: string[] = [],\n): [Map<string, string>, (key: string, value: string) => void] => {\n  const [, forceUpdate] = useReducer((x) => x + 1, 0);\n  const store = useMemo(() => new KeyStore(defaultKeys).initialize(), [defaultKeys]);\n  const setKey = (key: string, value: string) => {\n    store.setKey(key, value);\n    forceUpdate();\n  };\n\n  return [store.map, setKey];\n};\n"],"mappings":";;;;;;;;;;;AAcA,IAAa,oBAA+B;CAE1C,OAAO,uBADQ,UACe,CAAA,CAAO,KAAK,QAAQ;AACpD;;;ACRA,IAAa,uBAAqC;CAEhD,OAAO,uBADQ,UACe,CAAA,CAAO,KAAK,WAAW;AACvD;;;ACHA,IAAa,mBAA6B;CAExC,OAAO,uBADQ,UACe,CAAA,CAAO,KAAK,OAAO;AACnD;;;ACDA,IAAa,2BAA8D;CAEzE,OAAO,uBADQ,UACe,CAAA,CAAO,KAAK,WAAW;AACvD;AAEA,IAAa,qBAAqB,iBAA0B;CAC1D,MAAM,cAAc,mBAAmB;CAKvC,OAAO,oBAJY,cACX,YAAY,MAAM,eAAe,WAAW,IAAI,CAAC,CAAC,iBAAiB,YAAY,GACrF,CAAC,WAAW,CAEa,CAAU;AACvC;;;;;;;ACVA,IAAa,oBAAqC;CAEhD,OAAO,uBADQ,UACe,CAAA,CAAO,KAAK,QAAQ;AACpD;;;ACTA,IAAa,WAAb,MAAsB;CAGS;CAF7B,0BAAkB,IAAI,IAAoB;CAE1C,YAAY,eAA0C,CAAC,GAAG;EAA7B,KAAA,eAAA;CAA8B;CAE3D,IAAI,MAAM;EACR,OAAO,KAAK;CACd;CAGA,aAAmB;EACjB,KAAK,aAAa,SAAS,QAAQ;GACjC,MAAM,QAAQ,aAAa,QAAQ,GAAG;GACtC,KAAK,OAAO,KAAK,SAAS,EAAE;EAC9B,CAAC;EAED,OAAO;CACT;CAEA,OAAO,KAAmB;EACxB,aAAa,QAAQ,GAAG;CAC1B;CAEA,OAAO,KAAa,OAAqB;EACvC,aAAa,QAAQ,KAAK,EAAE;EAC5B,KAAK,QAAQ,IAAI,KAAK,KAAK;CAC7B;AACF;;;;;AAMA,IAAa,eACX,cAAwB,CAAC,MACuC;CAChE,MAAM,GAAG,eAAe,YAAY,MAAM,IAAI,GAAG,CAAC;CAClD,MAAM,QAAQ,cAAc,IAAI,SAAS,WAAW,CAAC,CAAC,WAAW,GAAG,CAAC,WAAW,CAAC;CACjF,MAAM,UAAU,KAAa,UAAkB;EAC7C,MAAM,OAAO,KAAK,KAAK;EACvB,YAAY;CACd;CAEA,OAAO,CAAC,MAAM,KAAK,MAAM;AAC3B"}

package/dist/lib/index.mjs

@@ -0,0 +1,108 @@
+import { n as ClientContext, r as useAgentHostingClient, t as AgentHostingContext } from "./chunk-context.mjs";
+import { t as useClient } from "./chunk-useClient.mjs";
+import { t as ClientProvider } from "./chunk-ClientProvider.mjs";
+import { raise } from "@dxos/debug";
+import { useContext, useEffect, useState } from "react";
+import { AgentManagerClient, FakeAgentHostingProvider } from "@dxos/client";
+import { log } from "@dxos/log";
+import { jsxs } from "react/jsx-runtime";
+import { useMulticastObservable } from "@dxos/react-hooks";
+export * from "@dxos/client";
+//#region src/client/AgentHostingProvider.tsx
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/react-client/src/client/AgentHostingProvider.tsx";
+/**
+* Experimental agent hosting provider.
+* @param props
+* @constructor
+* @deprecated
+*/
+var AgentHostingProvider = (props) => {
+	const [agentHostingProviderClient] = useState(makeClient(useClient()));
+	return /* @__PURE__ */ jsxs(AgentHostingContext.Provider, {
+		value: agentHostingProviderClient,
+		children: [" ", props.children]
+	});
+};
+var makeClient = ({ config, halo }) => {
+	const agentHostingConfig = config.get("runtime.services.agentHosting");
+	if (!agentHostingConfig) {
+		log("no agent hosting configured", void 0, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 36,
+			S: void 0
+		});
+		return null;
+	}
+	let agentHostingProviderClient = null;
+	switch (agentHostingConfig.type) {
+		case "LOCAL_TESTING":
+			log("using FakeAgentHostingProvider", void 0, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 44,
+				S: void 0
+			});
+			return new FakeAgentHostingProvider();
+		case "AGENTHOSTING_API":
+			agentHostingProviderClient = new AgentManagerClient(config, halo);
+			if (agentHostingProviderClient.init()) return agentHostingProviderClient;
+			else return null;
+		default:
+			log.error("Unknown agent hosting provider type: " + agentHostingConfig.type, void 0, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 59,
+				S: void 0
+			});
+			return null;
+	}
+};
+//#endregion
+//#region src/client/useClientStatus.ts
+var useClientStatus = (client) => {
+	const [status, setStatus] = useState();
+	useEffect(() => {
+		if (!client) return;
+		const subscription = client.status.subscribe((status) => setStatus(status));
+		return () => subscription.unsubscribe();
+	}, [client, setStatus]);
+	return status;
+};
+//#endregion
+//#region src/client/useConfig.ts
+/**
+* Hook returning config object used to initialize the DXOS client instance.
+* Requires ClientContext to be set via ClientProvider.
+*/
+var useConfig = () => {
+	const { client } = useContext(ClientContext) ?? raise(/* @__PURE__ */ new Error("Missing ClientContext."));
+	return client.config;
+};
+//#endregion
+//#region src/client/useShell.ts
+/**
+* Helper hook to access the shell.
+*/
+var useShell = () => {
+	return useClient().shell;
+};
+/**
+* Hook to access the shell’s display state.
+*/
+var useShellDisplay = () => {
+	const client = useClient();
+	const [display, setDisplay] = useState(client.shell.display);
+	useEffect(() => client.shell.onDisplayChange(setDisplay), [client]);
+	return display;
+};
+//#endregion
+//#region src/client/useStatus.ts
+var useStatus = () => {
+	const { status } = useContext(ClientContext) ?? raise(/* @__PURE__ */ new Error("Missing ClientContext."));
+	return status;
+};
+//#endregion
+export { AgentHostingContext, AgentHostingProvider, ClientContext, ClientProvider, useAgentHostingClient, useClient, useClientStatus, useConfig, useMulticastObservable, useShell, useShellDisplay, useStatus };
+
+//# sourceMappingURL=index.mjs.map

package/dist/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/client/AgentHostingProvider.tsx","../../src/client/useClientStatus.ts","../../src/client/useConfig.ts","../../src/client/useShell.ts","../../src/client/useStatus.ts"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { type PropsWithChildren, useState } from 'react';\n\nimport { type AgentHostingProviderClient, AgentManagerClient, FakeAgentHostingProvider } from '@dxos/client';\nimport { type Halo } from '@dxos/client/halo';\nimport { type Config } from '@dxos/config';\nimport { log } from '@dxos/log';\n\n// Imported from the defining module, not the directory barrel: `'../client'` is this file's own\n// barrel, and that cycle made every downstream edit a full page reload.\nimport { AgentHostingContext } from './context';\nimport { useClient } from './useClient';\n\nexport type AgentHostingProviderProps = { config: Config; halo: Halo };\n\n/**\n * Experimental agent hosting provider.\n * @param props\n * @constructor\n * @deprecated\n */\nexport const AgentHostingProvider = (props: PropsWithChildren) => {\n  const client = useClient();\n  const [agentHostingProviderClient] = useState(makeClient(client));\n  return (\n    <AgentHostingContext.Provider value={agentHostingProviderClient}> {props.children}</AgentHostingContext.Provider>\n  );\n};\n\nconst makeClient = ({ config, halo }: AgentHostingProviderProps) => {\n  const agentHostingConfig = config.get('runtime.services.agentHosting');\n  if (!agentHostingConfig) {\n    log('no agent hosting configured');\n    return null;\n  }\n\n  // TODO(nf): Dynamically discover based on runtime config.\n  let agentHostingProviderClient: AgentHostingProviderClient | null = null;\n  switch (agentHostingConfig.type) {\n    case 'LOCAL_TESTING': {\n      log('using FakeAgentHostingProvider');\n      return new FakeAgentHostingProvider();\n    }\n\n    case 'AGENTHOSTING_API': {\n      agentHostingProviderClient = new AgentManagerClient(config, halo);\n      if (agentHostingProviderClient.init()) {\n        return agentHostingProviderClient;\n      } else {\n        // Not authorized or error initializing.\n        return null;\n      }\n    }\n\n    default: {\n      log.error('Unknown agent hosting provider type: ' + agentHostingConfig.type);\n      return null;\n    }\n  }\n};\n","//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type Client, type SystemStatus } from '@dxos/client';\n\nexport const useClientStatus = (client: Client) => {\n  const [status, setStatus] = useState<SystemStatus | null>();\n  useEffect(() => {\n    if (!client) {\n      return;\n    }\n\n    const subscription = client.status.subscribe((status) => setStatus(status));\n    return () => subscription.unsubscribe();\n  }, [client, setStatus]);\n\n  return status;\n};\n","//\n// Copyright 2020 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from './context';\n\n/**\n * Hook returning config object used to initialize the DXOS client instance.\n * Requires ClientContext to be set via ClientProvider.\n */\nexport const useConfig = () => {\n  const { client } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n  return client.config;\n};\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type Shell, type ShellDisplay } from '@dxos/client';\n\nimport { useClient } from './useClient';\n\n/**\n * Helper hook to access the shell.\n */\nexport const useShell = (): Shell => {\n  const client = useClient();\n  return client.shell;\n};\n\n/**\n * Hook to access the shell’s display state.\n */\nexport const useShellDisplay = (): ShellDisplay => {\n  const client = useClient();\n  const [display, setDisplay] = useState(client.shell.display);\n  useEffect(() => client.shell.onDisplayChange(setDisplay), [client]);\n  return display;\n};\n","//\n// Copyright 2022 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { type SystemStatus } from '@dxos/client';\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from './context';\n\nexport const useStatus = (): SystemStatus | null | undefined => {\n  const { status } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n  return status;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwBA,IAAa,wBAAwB,UAA6B;CAEhE,MAAM,CAAC,8BAA8B,SAAS,WAD/B,UAC0C,CAAM,CAAC;CAChE,OACE,qBAAC,oBAAoB,UAArB;EAA8B,OAAO;YAArC,CAAiE,KAAE,MAAM,QAAuC;;AAEpH;AAEA,IAAM,cAAc,EAAE,QAAQ,WAAsC;CAClE,MAAM,qBAAqB,OAAO,IAAI,+BAA+B;CACrE,IAAI,CAAC,oBAAoB;EACvB,IAAI,+BAA4B,KAAA,GAAA;GAAA,YAAA;GAAA,GAAA;GAAA,GAAA;GAAA,GAAA,KAAA;EAAA,CAAC;EACjC,OAAO;CACT;CAGA,IAAI,6BAAgE;CACpE,QAAQ,mBAAmB,MAA3B;EACE,KAAK;GACH,IAAI,kCAA+B,KAAA,GAAA;IAAA,YAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA,KAAA;GAAA,CAAC;GACpC,OAAO,IAAI,yBAAyB;EAGtC,KAAK;GACH,6BAA6B,IAAI,mBAAmB,QAAQ,IAAI;GAChE,IAAI,2BAA2B,KAAK,GAClC,OAAO;QAGP,OAAO;EAIX;GACE,IAAI,MAAM,0CAA0C,mBAAmB,MAAG,KAAA,GAAA;IAAA,YAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA,KAAA;GAAA,CAAC;GAC3E,OAAO;CAEX;AACF;;;ACtDA,IAAa,mBAAmB,WAAmB;CACjD,MAAM,CAAC,QAAQ,aAAa,SAA8B;CAC1D,gBAAgB;EACd,IAAI,CAAC,QACH;EAGF,MAAM,eAAe,OAAO,OAAO,WAAW,WAAW,UAAU,MAAM,CAAC;EAC1E,aAAa,aAAa,YAAY;CACxC,GAAG,CAAC,QAAQ,SAAS,CAAC;CAEtB,OAAO;AACT;;;;;;;ACNA,IAAa,kBAAkB;CAC7B,MAAM,EAAE,WAAW,WAAW,aAAa,KAAK,sBAAM,IAAI,MAAM,wBAAwB,CAAC;CACzF,OAAO,OAAO;AAChB;;;;;;ACJA,IAAa,iBAAwB;CAEnC,OADe,UACR,CAAA,CAAO;AAChB;;;;AAKA,IAAa,wBAAsC;CACjD,MAAM,SAAS,UAAU;CACzB,MAAM,CAAC,SAAS,cAAc,SAAS,OAAO,MAAM,OAAO;CAC3D,gBAAgB,OAAO,MAAM,gBAAgB,UAAU,GAAG,CAAC,MAAM,CAAC;CAClE,OAAO;AACT;;;ACfA,IAAa,kBAAmD;CAC9D,MAAM,EAAE,WAAW,WAAW,aAAa,KAAK,sBAAM,IAAI,MAAM,wBAAwB,CAAC;CACzF,OAAO;AACT"}

package/dist/lib/invitations.mjs

@@ -0,0 +1,130 @@
+import { useCallback, useEffect, useMemo, useReducer } from "react";
+import { log } from "@dxos/log";
+import { AuthenticatingInvitationObservable, CancellableInvitationObservable, Invitation, Invitation as Invitation$1, InvitationEncoder, InvitationEncoder as InvitationEncoder$1, InvitationsProxy } from "@dxos/client/invitations";
+//#region src/invitations/useInvitationStatus.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/react-client/src/invitations/useInvitationStatus.ts";
+var isShareableInvitation = (invitation) => invitation.authMethod !== Invitation$1.AuthMethod.KNOWN_PUBLIC_KEY || !!invitation.guestKeypair?.privateKey;
+var useInvitationStatus = (observable) => {
+	const [state, dispatch] = useReducer((prev, action) => {
+		log("useInvitationStatus", { action }, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 91,
+			S: void 0
+		});
+		const invitationProps = "invitation" in action ? {
+			id: action.invitation.invitationId,
+			multiUse: action.invitation.multiUse,
+			invitationCode: InvitationEncoder$1.encode(action.invitation),
+			authCode: action.invitation.authCode,
+			authMethod: action.invitation.authMethod,
+			shareable: isShareableInvitation(action.invitation),
+			type: action.invitation.type
+		} : {};
+		return {
+			...prev,
+			...invitationProps,
+			status: action.status,
+			result: action.status === Invitation$1.State.SUCCESS ? action.result : prev.result,
+			...action.status === Invitation$1.State.ERROR && { error: action.error },
+			...(action.status === Invitation$1.State.ERROR || action.status === Invitation$1.State.CANCELLED || action.status === Invitation$1.State.TIMEOUT) && { haltedAt: typeof prev.haltedAt === "undefined" ? action.haltedAt : prev.haltedAt }
+		};
+	}, null, (_arg) => {
+		const invitation = observable?.get();
+		return {
+			status: Invitation$1.State.INIT,
+			result: {
+				spaceKey: null,
+				identityKey: null,
+				swarmKey: null,
+				target: null
+			},
+			id: invitation?.invitationId,
+			multiUse: invitation?.multiUse,
+			invitationCode: invitation ? InvitationEncoder$1.encode(invitation) : void 0,
+			authCode: invitation?.authCode,
+			authMethod: invitation?.authMethod,
+			shareable: invitation ? isShareableInvitation(invitation) : false,
+			type: invitation?.type
+		};
+	});
+	useEffect(() => {
+		const update = (invitation) => {
+			switch (invitation.state) {
+				case Invitation$1.State.INIT:
+				case Invitation$1.State.CONNECTED:
+				case Invitation$1.State.READY_FOR_AUTHENTICATION:
+				case Invitation$1.State.AUTHENTICATING:
+					dispatch({
+						invitation,
+						status: invitation.state
+					});
+					break;
+				case Invitation$1.State.SUCCESS:
+					dispatch({
+						invitation,
+						status: invitation.state,
+						result: {
+							spaceKey: invitation.spaceKey || null,
+							identityKey: invitation.identityKey || null,
+							swarmKey: invitation.swarmKey || null,
+							target: invitation.target || null
+						}
+					});
+					break;
+				case Invitation$1.State.CANCELLED:
+				case Invitation$1.State.TIMEOUT:
+					dispatch({
+						invitation,
+						status: invitation.state,
+						haltedAt: state.status
+					});
+					break;
+			}
+		};
+		const subscription = observable?.subscribe(update, (err) => {
+			dispatch({
+				status: Invitation$1.State.ERROR,
+				error: err,
+				haltedAt: state.status
+			});
+		});
+		const currentState = observable?.get();
+		if (currentState) update(currentState);
+		return () => subscription?.unsubscribe();
+	}, [observable, state.status]);
+	const connect = useCallback((observable) => {
+		dispatch({
+			invitation: observable.get(),
+			status: Invitation$1.State.CONNECTING,
+			observable
+		});
+	}, []);
+	const authenticate = useCallback((authCode) => {
+		log("authenticating...", { authCode }, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 196,
+			S: void 0
+		});
+		return observable.authenticate(authCode);
+	}, [observable]);
+	const cancel = useCallback(async () => observable?.cancel(), [observable]);
+	return useMemo(() => {
+		return {
+			...state,
+			cancel,
+			connect,
+			authenticate
+		};
+	}, [
+		state,
+		cancel,
+		connect,
+		authenticate
+	]);
+};
+//#endregion
+export { AuthenticatingInvitationObservable, CancellableInvitationObservable, Invitation, InvitationEncoder, InvitationsProxy, useInvitationStatus };
+
+//# sourceMappingURL=invitations.mjs.map

package/dist/lib/invitations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invitations.mjs","names":[],"sources":["../../src/invitations/useInvitationStatus.ts"],"sourcesContent":["//\n// Copyright 2022 DXOS.org\n//\n\nimport { useCallback, useEffect, useMemo, useReducer } from 'react';\n\nimport { type PublicKey } from '@dxos/client';\nimport {\n  type AuthenticatingInvitationObservable,\n  type CancellableInvitationObservable,\n  Invitation,\n  InvitationEncoder,\n} from '@dxos/client/invitations';\nimport { log } from '@dxos/log';\n\nexport type InvitationResult = {\n  spaceKey: PublicKey | null;\n  identityKey: PublicKey | null;\n  swarmKey: PublicKey | null;\n  target: string | null;\n};\n\ninterface InvitationReducerState {\n  status: Invitation.State; // TODO(burdon): Rename state.\n  haltedAt?: Invitation.State;\n  result: InvitationResult;\n  error?: Error;\n  id?: string;\n  multiUse?: boolean;\n  shareable?: boolean;\n  invitationCode?: string;\n  authCode?: string;\n  authMethod?: Invitation.AuthMethod;\n  type?: Invitation.Type;\n}\n\ntype InvitationPayload = { invitation: Invitation };\n\nexport type InvitationAction =\n  | ({\n      status:\n        | Invitation.State.INIT\n        | Invitation.State.CONNECTED\n        | Invitation.State.READY_FOR_AUTHENTICATION\n        | Invitation.State.AUTHENTICATING;\n    } & InvitationPayload)\n  | ({\n      status: Invitation.State.CONNECTING;\n      observable: CancellableInvitationObservable;\n    } & InvitationPayload)\n  | ({\n      status: Invitation.State.SUCCESS;\n      result: InvitationResult;\n    } & InvitationPayload)\n  | ({\n      status: Invitation.State.CANCELLED | Invitation.State.TIMEOUT;\n      haltedAt: Invitation.State;\n    } & InvitationPayload)\n  | {\n      status: Invitation.State.ERROR;\n      error?: Error;\n      haltedAt: Invitation.State;\n    };\n\nexport type InvitationStatus = {\n  id?: string;\n  invitationCode?: string;\n  authCode?: string;\n  authMethod?: Invitation.AuthMethod;\n  type?: Invitation.Type;\n  status: Invitation.State;\n  haltedAt?: Invitation.State;\n  multiUse?: boolean;\n  shareable?: boolean;\n  result: InvitationResult;\n  error?: Error;\n  cancel(): void;\n  // TODO(wittjosiah): Remove?\n  connect(observable: CancellableInvitationObservable): void;\n  authenticate(authCode: string): Promise<void>;\n};\n\n// Without private key, the invitation code cannot be created.\n// These invitations are only available to be accepted but not shared.\nconst isShareableInvitation = (invitation: Invitation) =>\n  invitation.authMethod !== Invitation.AuthMethod.KNOWN_PUBLIC_KEY || !!invitation.guestKeypair?.privateKey;\n\nexport const useInvitationStatus = (observable?: CancellableInvitationObservable): InvitationStatus => {\n  const [state, dispatch] = useReducer(\n    (prev: InvitationReducerState, action: InvitationAction): InvitationReducerState => {\n      log('useInvitationStatus', { action });\n      const invitationProps =\n        'invitation' in action\n          ? {\n              id: action.invitation.invitationId,\n              multiUse: action.invitation.multiUse,\n              invitationCode: InvitationEncoder.encode(action.invitation),\n              authCode: action.invitation.authCode,\n              authMethod: action.invitation.authMethod,\n              shareable: isShareableInvitation(action.invitation),\n              type: action.invitation.type,\n            }\n          : {};\n      return {\n        ...prev,\n        ...invitationProps,\n        // TODO(burdon): State.\n        status: action.status,\n        // `invitationObservable`, `secret`, and `result` is persisted between the status-actions that set them.\n        result: action.status === Invitation.State.SUCCESS ? action.result : prev.result,\n        // `error` gets set each time we enter the error state\n        ...(action.status === Invitation.State.ERROR && { error: action.error }),\n        // `haltedAt` gets set on only the first error/cancelled/timeout action and reset on any others.\n        ...((action.status === Invitation.State.ERROR ||\n          action.status === Invitation.State.CANCELLED ||\n          action.status === Invitation.State.TIMEOUT) && {\n          haltedAt: typeof prev.haltedAt === 'undefined' ? action.haltedAt : prev.haltedAt,\n        }),\n      };\n    },\n    null,\n    (_arg: null): InvitationReducerState => {\n      const invitation = observable?.get();\n      return {\n        status: Invitation.State.INIT,\n        result: { spaceKey: null, identityKey: null, swarmKey: null, target: null },\n        id: invitation?.invitationId,\n        multiUse: invitation?.multiUse,\n        invitationCode: invitation ? InvitationEncoder.encode(invitation) : undefined,\n        authCode: invitation?.authCode,\n        authMethod: invitation?.authMethod,\n        shareable: invitation ? isShareableInvitation(invitation) : false,\n        type: invitation?.type,\n      };\n    },\n  );\n\n  // Handle unmount.\n\n  useEffect(() => {\n    const update = (invitation: Invitation) => {\n      switch (invitation.state) {\n        case Invitation.State.INIT:\n        case Invitation.State.CONNECTED:\n        case Invitation.State.READY_FOR_AUTHENTICATION:\n        case Invitation.State.AUTHENTICATING: {\n          dispatch({\n            invitation,\n            status: invitation.state,\n          });\n          break;\n        }\n\n        case Invitation.State.SUCCESS: {\n          dispatch({\n            invitation,\n            status: invitation.state,\n            result: {\n              spaceKey: invitation.spaceKey || null,\n              identityKey: invitation.identityKey || null,\n              swarmKey: invitation.swarmKey || null,\n              target: invitation.target || null,\n            },\n          });\n          break;\n        }\n\n        case Invitation.State.CANCELLED:\n        case Invitation.State.TIMEOUT: {\n          dispatch({ invitation, status: invitation.state, haltedAt: state.status });\n          break;\n        }\n      }\n    };\n\n    const subscription = observable?.subscribe(update, (err: Error) => {\n      dispatch({ status: Invitation.State.ERROR, error: err, haltedAt: state.status });\n    });\n\n    const currentState = observable?.get();\n    if (currentState) {\n      update(currentState);\n    }\n\n    return () => subscription?.unsubscribe();\n  }, [observable, state.status]);\n\n  // Return memoized callbacks & values.\n\n  const connect = useCallback((observable: CancellableInvitationObservable) => {\n    dispatch({ invitation: observable.get(), status: Invitation.State.CONNECTING, observable });\n  }, []);\n\n  const authenticate = useCallback(\n    (authCode: string) => {\n      log('authenticating...', { authCode });\n      return (observable as AuthenticatingInvitationObservable).authenticate(authCode);\n    },\n    [observable],\n  );\n\n  const cancel = useCallback(async () => observable?.cancel(), [observable]);\n\n  return useMemo(() => {\n    return {\n      ...state,\n      cancel,\n      connect,\n      authenticate,\n    };\n  }, [state, cancel, connect, authenticate]);\n};\n"],"mappings":"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"}

package/dist/lib/mesh.mjs

@@ -0,0 +1,14 @@
+import { t as useClient } from "./chunk-useClient.mjs";
+import { useMulticastObservable } from "@dxos/react-hooks";
+export * from "@dxos/client/mesh";
+//#region src/mesh/useNetworkStatus.ts
+/**
+* Creates a network status subscription.
+*/
+var useNetworkStatus = () => {
+	return useMulticastObservable(useClient().mesh.networkStatus);
+};
+//#endregion
+export { useNetworkStatus };
+
+//# sourceMappingURL=mesh.mjs.map

package/dist/lib/mesh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh.mjs","names":[],"sources":["../../src/mesh/useNetworkStatus.ts"],"sourcesContent":["//\n// Copyright 2020 DXOS.org\n//\n\nimport { type NetworkStatus } from '@dxos/client/mesh';\nimport { useMulticastObservable } from '@dxos/react-hooks';\n\nimport { useClient } from '../client';\n\n/**\n * Creates a network status subscription.\n */\nexport const useNetworkStatus = (): NetworkStatus => {\n  const client = useClient();\n  return useMulticastObservable(client.mesh.networkStatus);\n};\n"],"mappings":";;;;;;;AAYA,IAAa,yBAAwC;CAEnD,OAAO,uBADQ,UACe,CAAA,CAAO,KAAK,aAAa;AACzD"}

package/dist/lib/testing.mjs

@@ -0,0 +1,206 @@
+import { t as ClientProvider } from "./chunk-ClientProvider.mjs";
+import { raise } from "@dxos/debug";
+import { createContext, useCallback, useContext, useMemo, useRef, useState } from "react";
+import { Client } from "@dxos/client";
+import { log } from "@dxos/log";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useAsyncEffect } from "@dxos/react-hooks";
+import { Trigger } from "@dxos/async";
+import { TestBuilder, performInvitation } from "@dxos/client/testing";
+import { random } from "@dxos/random";
+import { ErrorBoundary } from "@dxos/react-ui";
+export * from "@dxos/client/testing";
+//#region src/testing/context.tsx
+var ClientStory = createContext(void 0);
+var useClientStory = () => {
+	return useContext(ClientStory) ?? raise(/* @__PURE__ */ new Error("Missing ClientStory"));
+};
+//#endregion
+//#region src/testing/ClientRepeater.tsx
+/**
+* Utility component for Storybook stories which sets up clients for n peers.
+* The `Component` property is rendered n times, once for each peer.
+* @deprecated use `withClientProvider`.
+*/
+var ClientRepeater = (props) => {
+	const { component: Component, controls: Controls, count = 1, types, createIdentity, createSpace, onCreateSpace } = props;
+	const [clients, setClients] = useState(props.clients ?? []);
+	const [spaceId, setSpaceId] = useState();
+	const testBuilder = useRef(new TestBuilder());
+	useAsyncEffect(async () => {
+		const clients = [...Array(count)].map((_) => new Client({
+			services: testBuilder.current.createLocalClientServices(),
+			types
+		}));
+		await Promise.all(clients.map((client) => client.initialize()));
+		if (createIdentity || createSpace) await Promise.all(clients.map((client) => client.halo.createIdentity()));
+		if (createSpace) {
+			const client = clients[0];
+			const space = await client.spaces.create({ name: random.commerce.productName() });
+			setSpaceId(space.id);
+			await onCreateSpace?.({
+				client,
+				space
+			}, {});
+			await Promise.all(clients.slice(1).flatMap((client) => performInvitation({
+				host: space,
+				guest: client.spaces
+			})));
+		}
+		setClients(clients);
+	}, []);
+	if (clients.length === 0) return null;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [Controls && /* @__PURE__ */ jsx(Controls, { clients }), clients.map((client, index) => /* @__PURE__ */ jsx(ClientProvider, {
+		client,
+		children: /* @__PURE__ */ jsx(Component, {
+			id: index,
+			count: clients.length,
+			spaceId,
+			...props.args
+		})
+	}, index))] });
+};
+//#endregion
+//#region src/testing/withClientProvider.tsx
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/react-client/src/testing/withClientProvider.tsx";
+/**
+* Initialize client, identity and first space.
+*/
+var initializeClient = async (client, { createIdentity, createSpace, onCreateIdentity, onCreateSpace, onInitialized }, context) => {
+	await onInitialized?.(client);
+	if (createIdentity || createSpace) {
+		if (!client.halo.identity.get()) {
+			await client.halo.createIdentity();
+			await onCreateIdentity?.({ client }, context);
+		}
+	}
+	let space;
+	if (createSpace) {
+		space = await client.spaces.create({ name: "Test Space" });
+		await space.waitUntilReady();
+		await onCreateSpace?.({
+			client,
+			space
+		}, context);
+	}
+	return {
+		space,
+		spaceId: space?.id
+	};
+};
+/**
+* Decorator that provides the client context.
+*/
+var withClientProvider = ({ createIdentity, createSpace, onCreateSpace, onCreateIdentity, onInitialized, ...props } = {}) => {
+	return (Story, context) => {
+		const [data, setData] = useState({});
+		const handleInitialized = async (client) => {
+			const data = await initializeClient(client, {
+				createIdentity,
+				createSpace,
+				onCreateSpace,
+				onCreateIdentity,
+				onInitialized
+			}, context);
+			setData(data);
+		};
+		return /* @__PURE__ */ jsx(ErrorBoundary, {
+			name: "client-provider",
+			children: /* @__PURE__ */ jsx(ClientProvider, {
+				onInitialized: handleInitialized,
+				...props,
+				children: /* @__PURE__ */ jsx(ClientStory.Provider, {
+					value: data,
+					children: /* @__PURE__ */ jsx(Story, {})
+				})
+			})
+		});
+	};
+};
+/**
+* Decorator that creates a scaffold for multiple clients.
+* Orchestrates invitations between a randomly selected host and the remaining clients.
+*/
+var withMultiClientProvider = ({ numClients = 2, createIdentity, createSpace, onCreateSpace, onCreateIdentity, onInitialized, ...props }) => {
+	return (Story, context) => {
+		const spaceReady = useRef(new Trigger());
+		const [spaceId, setSpaceId] = useState();
+		const clients = useMemo(() => {
+			const buidler = new TestBuilder();
+			return Array.from({ length: numClients }).map(() => {
+				return { services: buidler.createLocalClientServices() };
+			});
+		}, [numClients]);
+		const handleInitialized = useCallback(async (client, index) => {
+			if (index === 0) {
+				const { space } = await initializeClient(client, {
+					createIdentity,
+					createSpace,
+					onCreateSpace,
+					onCreateIdentity,
+					onInitialized
+				}, context);
+				log.info("inviting", {
+					index,
+					spaceId: space?.id
+				}, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 148,
+					S: void 0
+				});
+				setSpaceId(space?.id);
+				spaceReady.current.wake(space);
+			} else {
+				await initializeClient(client, {
+					createIdentity,
+					onInitialized
+				}, context);
+				log.info("waiting", { index }, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 155,
+					S: void 0
+				});
+				const space = await spaceReady.current.wait();
+				if (space) {
+					log.info("joining", {
+						index,
+						spaceId: space.id
+					}, {
+						"~LogMeta": "~LogMeta",
+						F: __dxlog_file,
+						L: 158,
+						S: void 0
+					});
+					await Promise.all(performInvitation({
+						host: space,
+						guest: client.spaces
+					}));
+				}
+			}
+		}, []);
+		return /* @__PURE__ */ jsx("div", {
+			className: "absolute inset-0 grid grid-flow-col auto-cols-fr gap-4 overflow-hidden",
+			children: clients.map((client, index) => /* @__PURE__ */ jsx(ClientProvider, {
+				services: client.services,
+				onInitialized: (client) => handleInitialized(client, index),
+				...props,
+				children: /* @__PURE__ */ jsx(ClientStory.Provider, {
+					value: {
+						index,
+						spaceId
+					},
+					children: /* @__PURE__ */ jsx(ErrorBoundary, {
+						name: "client-provider",
+						children: /* @__PURE__ */ jsx(Story, {})
+					})
+				})
+			}, index))
+		});
+	};
+};
+//#endregion
+export { ClientRepeater, ClientStory, useClientStory, withClientProvider, withMultiClientProvider };
+
+//# sourceMappingURL=testing.mjs.map

package/dist/lib/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.mjs","names":[],"sources":["../../src/testing/context.tsx","../../src/testing/ClientRepeater.tsx","../../src/testing/withClientProvider.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { createContext, useContext } from 'react';\n\nimport { type Space } from '@dxos/client/echo';\nimport { raise } from '@dxos/debug';\nimport { type SpaceId } from '@dxos/keys';\n\nexport type ClientStory = {\n  index?: number;\n  spaceId?: SpaceId;\n  space?: Space;\n};\n\nexport const ClientStory = createContext<ClientStory | undefined>(undefined);\n\nexport const useClientStory = (): ClientStory => {\n  return useContext(ClientStory) ?? raise(new Error('Missing ClientStory'));\n};\n","//\n// Copyright 2022 DXOS.org\n//\n\nimport React, { type FC, useRef, useState } from 'react';\n\nimport { Client } from '@dxos/client';\nimport { TestBuilder, performInvitation } from '@dxos/client/testing';\nimport { type Type } from '@dxos/echo';\nimport { type SpaceId } from '@dxos/keys';\nimport { random } from '@dxos/random';\nimport { useAsyncEffect } from '@dxos/react-hooks';\n\nimport { ClientProvider } from '../client';\nimport { type WithClientProviderProps } from './withClientProvider';\n\nexport type ClientRepeatedComponentProps = { id: number; count: number; spaceId?: SpaceId };\n\nexport type ClientRepeaterControlsProps = { clients: Client[] };\n\n// TODO(burdon): Reconcile with ClientProviderProps.\nexport type ClientRepeaterProps<P extends ClientRepeatedComponentProps> = {\n  className?: string;\n  component: FC<ClientRepeatedComponentProps>;\n  controls?: FC<ClientRepeaterControlsProps>;\n  count?: number;\n  clients?: Client[];\n  types?: Type.AnyObj[];\n  args?: Omit<P, 'id' | 'count'>;\n} & Pick<WithClientProviderProps, 'createIdentity' | 'createSpace' | 'onCreateSpace'>;\n\n/**\n * Utility component for Storybook stories which sets up clients for n peers.\n * The `Component` property is rendered n times, once for each peer.\n * @deprecated use `withClientProvider`.\n */\n// TODO(burdon): To discuss: evolve ClientRepeater with optional decorator that uses it.\n// NOTE: This is specifically not a storybook decorator because it broke stories as a decorator.\n//   This seems primarily due to the fact that it required top-level await for the clients to initialize.\n//   Storybook seemed to handle it alright, but Chromatic had a lot of trouble with it.\n//   There was also a question of whether or not calling the story function multiple times was a good idea.\nexport const ClientRepeater = <P extends ClientRepeatedComponentProps>(props: ClientRepeaterProps<P>) => {\n  const {\n    component: Component,\n    controls: Controls,\n    count = 1,\n    types,\n    createIdentity,\n    createSpace,\n    onCreateSpace,\n  } = props;\n\n  const [clients, setClients] = useState(props.clients ?? []);\n  const [spaceId, setSpaceId] = useState<SpaceId>();\n\n  const testBuilder = useRef(new TestBuilder());\n  useAsyncEffect(async () => {\n    const clients = [...Array(count)].map(\n      (_) => new Client({ services: testBuilder.current.createLocalClientServices(), types }),\n    );\n\n    await Promise.all(clients.map((client) => client.initialize()));\n    if (createIdentity || createSpace) {\n      await Promise.all(clients.map((client) => client.halo.createIdentity()));\n    }\n\n    if (createSpace) {\n      const client = clients[0];\n      const space = await client.spaces.create({ name: random.commerce.productName() });\n      setSpaceId(space.id);\n      await onCreateSpace?.({ client, space }, {});\n      await Promise.all(clients.slice(1).flatMap((client) => performInvitation({ host: space, guest: client.spaces })));\n    }\n\n    setClients(clients);\n  }, []);\n\n  if (clients.length === 0) {\n    return null;\n  }\n\n  return (\n    <>\n      {Controls && <Controls clients={clients} />}\n      {clients.map((client, index) => (\n        <ClientProvider key={index} client={client}>\n          <Component id={index} count={clients.length} spaceId={spaceId} {...{ ...props.args }} />\n        </ClientProvider>\n      ))}\n    </>\n  );\n};\n","//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Decorator, type StoryContext } from '@storybook/react';\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\n\nimport { Trigger } from '@dxos/async';\nimport { type Client } from '@dxos/client';\nimport { type Space } from '@dxos/client/echo';\nimport { TestBuilder, performInvitation } from '@dxos/client/testing';\nimport { type SpaceId } from '@dxos/keys';\nimport { log } from '@dxos/log';\nimport { ErrorBoundary } from '@dxos/react-ui';\nimport { type MaybePromise } from '@dxos/util';\n\nimport { ClientProvider, type ClientProviderProps } from '../client';\nimport { ClientStory } from './context';\n\ntype InitializeProps = {\n  createIdentity?: boolean;\n  createSpace?: boolean;\n  onInitialized?: (client: Client) => MaybePromise<void>;\n  onCreateIdentity?: (props: { client: Client }, context: StoryContext | any) => MaybePromise<void>;\n  // NOTE: context must be untyped until ClientRepeater is removed.\n  onCreateSpace?: (props: { client: Client; space: Space }, context: StoryContext | any) => MaybePromise<void>;\n};\n\n/**\n * Initialize client, identity and first space.\n */\nconst initializeClient = async (\n  client: Client,\n  { createIdentity, createSpace, onCreateIdentity, onCreateSpace, onInitialized }: InitializeProps,\n  context: StoryContext,\n): Promise<ClientStory> => {\n  await onInitialized?.(client);\n\n  if (createIdentity || createSpace) {\n    if (!client.halo.identity.get()) {\n      await client.halo.createIdentity();\n      await onCreateIdentity?.({ client }, context);\n    }\n  }\n\n  let space: Space | undefined;\n  if (createSpace) {\n    space = await client.spaces.create({ name: 'Test Space' });\n    await space.waitUntilReady(); // Is this required?\n    await onCreateSpace?.({ client, space }, context);\n  }\n\n  return { space, spaceId: space?.id };\n};\n\nexport type WithClientProviderProps = InitializeProps & Omit<ClientProviderProps, 'onInitialized'>;\n\n/**\n * Decorator that provides the client context.\n */\nexport const withClientProvider = ({\n  createIdentity,\n  createSpace,\n  onCreateSpace,\n  onCreateIdentity,\n  onInitialized,\n  ...props\n}: WithClientProviderProps = {}): Decorator => {\n  return (Story, context) => {\n    const [data, setData] = useState<ClientStory>({});\n    const handleInitialized = async (client: Client) => {\n      const data = await initializeClient(\n        client,\n        {\n          createIdentity,\n          createSpace,\n          onCreateSpace,\n          onCreateIdentity,\n          onInitialized,\n        },\n        context,\n      );\n\n      setData(data);\n    };\n\n    return (\n      <ErrorBoundary name='client-provider'>\n        <ClientProvider onInitialized={handleInitialized} {...props}>\n          <ClientStory.Provider value={data}>\n            <Story />\n          </ClientStory.Provider>\n        </ClientProvider>\n      </ErrorBoundary>\n    );\n  };\n};\n\n// TODO(burdon): Implement context per client for context.\n// TODO(burdon): Callback once all invitations have completed.\n// TODO(burdon): Delay/jitter for creation of other clients.\nexport type WithMultiClientProviderProps = InitializeProps &\n  Omit<ClientProviderProps, 'onInitialized'> & { numClients?: number };\n\n/**\n * Decorator that creates a scaffold for multiple clients.\n * Orchestrates invitations between a randomly selected host and the remaining clients.\n */\nexport const withMultiClientProvider = ({\n  numClients = 2,\n  createIdentity,\n  createSpace,\n  onCreateSpace,\n  onCreateIdentity,\n  onInitialized,\n  ...props\n}: WithMultiClientProviderProps): Decorator => {\n  return (Story, context) => {\n    const spaceReady = useRef(new Trigger<Space | undefined>());\n    const [spaceId, setSpaceId] = useState<SpaceId>();\n\n    const clients = useMemo(() => {\n      const buidler = new TestBuilder();\n      return Array.from({ length: numClients }).map(() => {\n        return {\n          services: buidler.createLocalClientServices(),\n        };\n      });\n    }, [numClients]);\n\n    // Handle invitations.\n    // NOTE: The zeroth client isn't necessarily the first to be initialized.\n    const handleInitialized = useCallback(async (client: Client, index: number) => {\n      if (index === 0) {\n        // Initialize host.\n        const { space } = await initializeClient(\n          client,\n          {\n            createIdentity,\n            createSpace,\n            onCreateSpace,\n            onCreateIdentity,\n            onInitialized,\n          },\n          context,\n        );\n\n        log.info('inviting', { index, spaceId: space?.id });\n        setSpaceId(space?.id);\n        spaceReady.current.wake(space);\n      } else {\n        // Initialize guest.\n        await initializeClient(client, { createIdentity, onInitialized }, context);\n\n        log.info('waiting', { index });\n        const space = await spaceReady.current.wait();\n        if (space) {\n          log.info('joining', { index, spaceId: space.id });\n          await Promise.all(\n            performInvitation({\n              host: space,\n              guest: client.spaces,\n            }),\n          );\n        }\n      }\n    }, []);\n\n    return (\n      <div className='absolute inset-0 grid grid-flow-col auto-cols-fr gap-4 overflow-hidden'>\n        {clients.map((client, index) => (\n          <ClientProvider\n            key={index}\n            services={client.services}\n            onInitialized={(client) => handleInitialized(client, index)}\n            {...props}\n          >\n            <ClientStory.Provider value={{ index, spaceId }}>\n              <ErrorBoundary name='client-provider'>\n                <Story />\n              </ErrorBoundary>\n            </ClientStory.Provider>\n          </ClientProvider>\n        ))}\n      </div>\n    );\n  };\n};\n"],"mappings":"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"}

package/dist/types/src/client/AgentHostingProvider.d.ts

@@ -1,12 +1,10 @@
 import React, { type PropsWithChildren } from 'react';
-import { type AgentHostingProviderClient } from '@dxos/client';
 import { type Halo } from '@dxos/client/halo';
 import { type Config } from '@dxos/config';
 export type AgentHostingProviderProps = {
     config: Config;
     halo: Halo;
 };
-export declare const AgentHostingContext: React.Context<AgentHostingProviderClient | null>;
 /**
  * Experimental agent hosting provider.
  * @param props
@@ -14,5 +12,4 @@ export declare const AgentHostingContext: React.Context<AgentHostingProviderClie
  * @deprecated
  */
 export declare const AgentHostingProvider: (props: PropsWithChildren) => React.JSX.Element;
-export declare const useAgentHostingClient: () => AgentHostingProviderClient | null;
 //# sourceMappingURL=AgentHostingProvider.d.ts.map

package/dist/types/src/client/AgentHostingProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentHostingProvider.d.ts","sourceRoot":"","sources":["../../../../src/client/AgentHostingProvider.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAuC,MAAM,OAAO,CAAC;AAE3F,OAAO,EAAE,KAAK,0BAA0B,EAAgD,MAAM,cAAc,CAAC;AAC7G,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAK3C,MAAM,MAAM,yBAAyB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAEvE,eAAO,MAAM,mBAAmB,kDAAyD,CAAC;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,UAAW,iBAAiB,sBAM5D,CAAC;AAEF,eAAO,MAAM,qBAAqB,yCAEjC,CAAC"}
+{"version":3,"file":"AgentHostingProvider.d.ts","sourceRoot":"","sources":["../../../../src/client/AgentHostingProvider.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAY,MAAM,OAAO,CAAC;AAGhE,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAQ3C,MAAM,MAAM,yBAAyB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,UAAW,iBAAiB,sBAM5D,CAAC"}