@dxos/react-client 0.7.4 → 0.7.5-labs.071a3e2

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

@@ -1,10 +1,18 @@
 import {
   ClientProvider
-} from "../chunk-U4MCIYKN.mjs";
+} from "../chunk-LVTCEDI2.mjs";
 
 // packages/sdk/react-client/src/testing/index.ts
 export * from "@dxos/client/testing";
 
+// packages/sdk/react-client/src/testing/context.tsx
+import { createContext, useContext } from "react";
+import { raise } from "@dxos/debug";
+var ClientStory = /* @__PURE__ */ createContext(void 0);
+var useClientProvider = () => {
+  return useContext(ClientStory) ?? raise(new Error("Missing ClientStory"));
+};
+
 // packages/sdk/react-client/src/testing/ClientRepeater.tsx
 import React, { useState, useEffect, useRef } from "react";
 import { Client } from "@dxos/client";
@@ -40,7 +48,7 @@ var ClientRepeater = (props) => {
         await onSpaceCreated?.({
           client,
           space
-        });
+        }, {});
         await Promise.all(clients2.slice(1).flatMap((client2) => performInvitation({
           host: space,
           guest: client2.spaces
@@ -67,73 +75,63 @@ var ClientRepeater = (props) => {
 };
 
 // packages/sdk/react-client/src/testing/withClientProvider.tsx
-import React2, { createContext, useContext, useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
+import React2, { createContext as createContext2, useContext as useContext2, useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
 import { ErrorBoundary as NativeErrorBoundary } from "react-error-boundary";
 import { Trigger } from "@dxos/async";
 import { performInvitation as performInvitation2, TestBuilder as TestBuilder2 } from "@dxos/client/testing";
-import { raise } from "@dxos/debug";
 import { log } from "@dxos/log";
 var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/testing/withClientProvider.tsx";
-var initializeClient = async (client, { createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized }) => {
-  const clientData = await onInitialized?.(client);
-  let identityData = {};
+var initializeClient = async (client, { createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized }, context) => {
+  await onInitialized?.(client);
   if (createIdentity || createSpace) {
     if (!client.halo.identity.get()) {
       await client.halo.createIdentity();
-      identityData = await onIdentityCreated?.({
+      await onIdentityCreated?.({
         client
       });
     }
   }
   let space;
-  let spaceData = {};
   if (createSpace) {
     space = await client.spaces.create({
       name: "Test Space"
     });
-    spaceData = await onSpaceCreated?.({
+    await onSpaceCreated?.({
       client,
       space
-    });
+    }, context);
   }
   return {
-    space,
-    ...clientData,
-    ...identityData,
-    ...spaceData
+    space
   };
 };
-var StoryClientContext = /* @__PURE__ */ createContext(void 0);
-var useStoryClientData = () => {
-  const data = useContext(StoryClientContext) ?? raise(new Error("Missing withClientProvider decorator."));
-  return data;
-};
 var withClientProvider = ({ createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized, ...props } = {}) => {
-  return (Story) => {
+  return (Story, context) => {
     const [data, setData] = useState2({});
     const handleInitialized = async (client) => {
-      setData(await initializeClient(client, {
+      const data2 = await initializeClient(client, {
         createIdentity,
         createSpace,
         onSpaceCreated,
         onIdentityCreated,
         onInitialized
-      }));
+      }, context);
+      setData(data2);
     };
     return /* @__PURE__ */ React2.createElement(ErrorBoundary, null, /* @__PURE__ */ React2.createElement(ClientProvider, {
       onInitialized: handleInitialized,
       ...props
-    }, /* @__PURE__ */ React2.createElement(StoryClientContext.Provider, {
+    }, /* @__PURE__ */ React2.createElement(ClientStory.Provider, {
       value: data
     }, /* @__PURE__ */ React2.createElement(Story, null))));
   };
 };
-var MultiClientContext = /* @__PURE__ */ createContext({
+var MultiClientContext = /* @__PURE__ */ createContext2({
   id: 0
 });
-var useMultiClient = () => useContext(MultiClientContext);
+var useMultiClient = () => useContext2(MultiClientContext);
 var withMultiClientProvider = ({ numClients = 2, createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized, ...props }) => {
-  return (Story) => {
+  return (Story, context) => {
     const builder = useRef2(new TestBuilder2());
     const hostRef = useRef2();
     const spaceReady = useRef2(new Trigger());
@@ -142,7 +140,7 @@ var withMultiClientProvider = ({ numClients = 2, createIdentity, createSpace, on
         index
       }, {
         F: __dxlog_file,
-        L: 136,
+        L: 129,
         S: void 0,
         C: (f, a) => f(...a)
       });
@@ -155,13 +153,13 @@ var withMultiClientProvider = ({ numClients = 2, createIdentity, createSpace, on
             onSpaceCreated,
             onIdentityCreated,
             onInitialized
-          });
+          }, context);
           spaceReady.current.wake(space);
           log.info("inviting", {
             index
           }, {
             F: __dxlog_file,
-            L: 148,
+            L: 146,
             S: void 0,
             C: (f, a) => f(...a)
           });
@@ -169,14 +167,14 @@ var withMultiClientProvider = ({ numClients = 2, createIdentity, createSpace, on
           await initializeClient(client, {
             createIdentity,
             onInitialized
-          });
+          }, context);
           const space = await spaceReady.current.wait();
           if (space) {
             log.info("joining", {
               index
             }, {
               F: __dxlog_file,
-              L: 153,
+              L: 151,
               S: void 0,
               C: (f, a) => f(...a)
             });
@@ -240,8 +238,9 @@ var ErrorFallback = ({ error }) => {
 };
 export {
   ClientRepeater,
+  ClientStory,
+  useClientProvider,
   useMultiClient,
-  useStoryClientData,
   withClientProvider,
   withMultiClientProvider
 };

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../../src/testing/index.ts", "../../../../src/testing/ClientRepeater.tsx", "../../../../src/testing/withClientProvider.tsx"],
-  "sourcesContent": ["//\n// Copyright 2020 DXOS.org\n//\n\nexport * from '@dxos/client/testing';\n\nexport * from './ClientRepeater';\nexport * from './withClientProvider';\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport React, { useState, type FC, useEffect, useRef } from 'react';\n\nimport { Client, type PublicKey } from '@dxos/client';\nimport { TestBuilder, performInvitation } from '@dxos/client/testing';\nimport { type AbstractTypedObject } from '@dxos/echo-schema';\nimport { registerSignalsRuntime } from '@dxos/echo-signals/react';\nimport { faker } from '@dxos/random';\n\nimport { type WithClientProviderProps } from './withClientProvider';\nimport { ClientProvider } from '../client';\n\nexport type ClientRepeatedComponentProps = { id: number; count: number; spaceKey?: PublicKey };\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?: AbstractTypedObject[];\n  args?: Omit<P, 'id' | 'count'>;\n} & Pick<WithClientProviderProps, 'createIdentity' | 'createSpace' | 'onSpaceCreated'>;\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    onSpaceCreated,\n  } = props;\n  useEffect(() => {\n    registerSignalsRuntime();\n  }, []);\n\n  const [clients, setClients] = useState(props.clients ?? []);\n  const [spaceKey, setSpaceKey] = useState<PublicKey>();\n\n  const testBuilder = useRef(new TestBuilder());\n  useEffect(() => {\n    const timeout = setTimeout(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: faker.commerce.productName() });\n        setSpaceKey(space.key);\n        await onSpaceCreated?.({ client, space });\n        await Promise.all(\n          clients.slice(1).flatMap((client) => performInvitation({ host: space, guest: client.spaces })),\n        );\n      }\n\n      setClients(clients);\n    });\n\n    return () => clearTimeout(timeout);\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} spaceKey={spaceKey} {...{ ...props.args }} />\n        </ClientProvider>\n      ))}\n    </>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Decorator } from '@storybook/react';\nimport React, { createContext, type PropsWithChildren, useContext, useEffect, useRef, useState } from 'react';\nimport { type FallbackProps, ErrorBoundary as NativeErrorBoundary } from 'react-error-boundary';\n\nimport { Trigger } from '@dxos/async';\nimport { type Client } from '@dxos/client';\nimport { type Space } from '@dxos/client/echo';\nimport { performInvitation, TestBuilder } from '@dxos/client/testing';\nimport { raise } from '@dxos/debug';\nimport { log } from '@dxos/log';\nimport { type MaybePromise } from '@dxos/util';\n\nimport { ClientProvider, type ClientProviderProps } from '../client';\n\ntype InitializeProps = {\n  createIdentity?: boolean;\n  createSpace?: boolean;\n  onInitialized?: (client: Client) => MaybePromise<Record<string, any> | void>;\n  onIdentityCreated?: (props: { client: Client }) => MaybePromise<Record<string, any> | void>;\n  onSpaceCreated?: (props: { client: Client; space: Space }) => MaybePromise<Record<string, any> | void>;\n};\n\n/**\n * Initialize client, identity and first space.\n */\nconst initializeClient = async (\n  client: Client,\n  { createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized }: InitializeProps,\n): Promise<StoryClientProps> => {\n  const clientData = await onInitialized?.(client);\n\n  let identityData: Record<string, any> | void = {};\n  if (createIdentity || createSpace) {\n    if (!client.halo.identity.get()) {\n      await client.halo.createIdentity();\n      identityData = await onIdentityCreated?.({ client });\n    }\n  }\n\n  let space: Space | undefined;\n  let spaceData: Record<string, any> | void = {};\n  if (createSpace) {\n    space = await client.spaces.create({ name: 'Test Space' });\n    spaceData = await onSpaceCreated?.({ client, space });\n  }\n\n  return { space, ...clientData, ...identityData, ...spaceData };\n};\n\ntype StoryClientProps<T extends Record<string, any> = Record<string, unknown>> = T & { space?: Space };\n\n// TODO(wittjosiah): Add to multi-client as well.\nconst StoryClientContext = createContext<StoryClientProps | undefined>(undefined);\n\nexport const useStoryClientData = <T extends Record<string, any> = Record<string, unknown>>() => {\n  const data = useContext(StoryClientContext) ?? raise(new Error('Missing withClientProvider decorator.'));\n  return data as StoryClientProps<T>;\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  onSpaceCreated,\n  onIdentityCreated,\n  onInitialized,\n  ...props\n}: WithClientProviderProps = {}): Decorator => {\n  return (Story) => {\n    const [data, setData] = useState<StoryClientProps>({});\n\n    const handleInitialized = async (client: Client) => {\n      setData(\n        await initializeClient(client, {\n          createIdentity,\n          createSpace,\n          onSpaceCreated,\n          onIdentityCreated,\n          onInitialized,\n        }),\n      );\n    };\n\n    return (\n      <ErrorBoundary>\n        <ClientProvider onInitialized={handleInitialized} {...props}>\n          <StoryClientContext.Provider value={data}>\n            <Story />\n          </StoryClientContext.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\nconst MultiClientContext = createContext<{ id: number }>({ id: 0 });\n\nexport const useMultiClient = () => useContext(MultiClientContext);\n\n/**\n * Decorator that creates a scaffold for multiple clients.\n * Orchestrates invitations between a randomly selected host and the remaining clients.\n * NOTE: Should come before withLayout.\n */\nexport const withMultiClientProvider = ({\n  numClients = 2,\n  createIdentity,\n  createSpace,\n  onSpaceCreated,\n  onIdentityCreated,\n  onInitialized,\n  ...props\n}: WithMultiClientProviderProps): Decorator => {\n  return (Story) => {\n    const builder = useRef(new TestBuilder());\n    const hostRef = useRef<Client>();\n    const spaceReady = useRef(new Trigger<Space | undefined>());\n\n    // Handle invitations.\n    // NOTE: The zeroth client isn't necessarily the first to be initialized.\n    const handleInitialized = async (client: Client, index: number) => {\n      log.info('initialized', { index });\n      if (createSpace) {\n        if (!hostRef.current) {\n          hostRef.current = client;\n          const { space } = await initializeClient(client, {\n            createIdentity,\n            createSpace,\n            onSpaceCreated,\n            onIdentityCreated,\n            onInitialized,\n          });\n          spaceReady.current.wake(space);\n          log.info('inviting', { index });\n        } else {\n          await initializeClient(client, { createIdentity, onInitialized });\n          const space = await spaceReady.current.wait();\n          if (space) {\n            log.info('joining', { index });\n            await Promise.all(performInvitation({ host: space, guest: client.spaces }));\n          }\n        }\n      }\n    };\n\n    return (\n      <ErrorBoundary>\n        {Array.from({ length: numClients }).map((_, index) => (\n          <MultiClientContext.Provider key={index} value={{ id: index }}>\n            <ClientProvider\n              services={builder.current.createLocalClientServices()}\n              onInitialized={(client) => handleInitialized(client, index)}\n              {...props}\n            >\n              <Story />\n            </ClientProvider>\n          </MultiClientContext.Provider>\n        ))}\n      </ErrorBoundary>\n    );\n  };\n};\n\nconst ErrorBoundary = ({ children }: PropsWithChildren) => {\n  const [error, setError] = useState<Error>();\n  useEffect(() => {\n    const handleError = (event: PromiseRejectionEvent) => {\n      setError(event.reason);\n    };\n\n    window.addEventListener('unhandledrejection', handleError);\n    return () => window.removeEventListener('unhandledrejection', handleError);\n  }, []);\n\n  if (error) {\n    return <ErrorFallback error={error} resetErrorBoundary={() => setError(undefined)} />;\n  }\n\n  return <NativeErrorBoundary FallbackComponent={ErrorFallback}>{children}</NativeErrorBoundary>;\n};\n\nconst ErrorFallback = ({ error }: FallbackProps) => {\n  const { name, message, stack } =\n    error instanceof Error ? error : { name: 'Error', message: String(error), stack: undefined };\n  return (\n    <div role='alert' className='flex flex-col p-4 gap-4 overflow-auto'>\n      <h1 className='text-xl text-red-500'>{name}</h1>\n      <div className='text-lg'>{message}</div>\n      {stack && <pre className='whitespace-pre-wrap text-sm text-subdued'>{stack}</pre>}\n    </div>\n  );\n};\n"],
-  "mappings": "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",
-  "names": ["React", "useState", "useEffect", "useRef", "Client", "TestBuilder", "performInvitation", "registerSignalsRuntime", "faker", "ClientRepeater", "props", "component", "Component", "controls", "Controls", "count", "types", "createIdentity", "createSpace", "onSpaceCreated", "useEffect", "registerSignalsRuntime", "clients", "setClients", "useState", "spaceKey", "setSpaceKey", "testBuilder", "useRef", "TestBuilder", "timeout", "setTimeout", "Array", "map", "_", "Client", "services", "current", "createLocalClientServices", "Promise", "all", "client", "initialize", "halo", "space", "spaces", "create", "name", "faker", "commerce", "productName", "key", "slice", "flatMap", "performInvitation", "host", "guest", "clearTimeout", "length", "index", "ClientProvider", "id", "args", "React", "createContext", "useContext", "useEffect", "useRef", "useState", "ErrorBoundary", "NativeErrorBoundary", "Trigger", "performInvitation", "TestBuilder", "raise", "log", "initializeClient", "client", "createIdentity", "createSpace", "onSpaceCreated", "onIdentityCreated", "onInitialized", "clientData", "identityData", "halo", "identity", "get", "space", "spaceData", "spaces", "create", "name", "StoryClientContext", "createContext", "undefined", "useStoryClientData", "data", "useContext", "raise", "Error", "withClientProvider", "props", "Story", "setData", "useState", "handleInitialized", "React", "ErrorBoundary", "ClientProvider", "Provider", "value", "MultiClientContext", "id", "useMultiClient", "withMultiClientProvider", "numClients", "builder", "useRef", "TestBuilder", "hostRef", "spaceReady", "Trigger", "index", "log", "info", "current", "wake", "wait", "Promise", "all", "performInvitation", "host", "guest", "Array", "from", "length", "map", "_", "key", "services", "createLocalClientServices", "children", "error", "setError", "useEffect", "handleError", "event", "reason", "window", "addEventListener", "removeEventListener", "ErrorFallback", "resetErrorBoundary", "NativeErrorBoundary", "FallbackComponent", "message", "stack", "String", "div", "role", "className", "h1", "pre"]
+  "sources": ["../../../../src/testing/index.ts", "../../../../src/testing/context.tsx", "../../../../src/testing/ClientRepeater.tsx", "../../../../src/testing/withClientProvider.tsx"],
+  "sourcesContent": ["//\n// Copyright 2020 DXOS.org\n//\n\nexport * from '@dxos/client/testing';\n\nexport * from './context';\nexport * from './ClientRepeater';\nexport * from './withClientProvider';\n", "//\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';\n\nexport type ClientStory = {\n  space?: Space;\n};\n\n// TODO(wittjosiah): Add to multi-client as well.\nexport const ClientStory = createContext<ClientStory | undefined>(undefined);\n\nexport const useClientProvider = (): ClientStory => {\n  return useContext(ClientStory) ?? raise(new Error('Missing ClientStory'));\n};\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport React, { useState, type FC, useEffect, useRef } from 'react';\n\nimport { Client, type PublicKey } from '@dxos/client';\nimport { TestBuilder, performInvitation } from '@dxos/client/testing';\nimport { type TypedObject } from '@dxos/echo-schema';\nimport { registerSignalsRuntime } from '@dxos/echo-signals/react';\nimport { faker } from '@dxos/random';\n\nimport { type WithClientProviderProps } from './withClientProvider';\nimport { ClientProvider } from '../client';\n\nexport type ClientRepeatedComponentProps = { id: number; count: number; spaceKey?: PublicKey };\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?: TypedObject[];\n  args?: Omit<P, 'id' | 'count'>;\n} & Pick<WithClientProviderProps, 'createIdentity' | 'createSpace' | 'onSpaceCreated'>;\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    onSpaceCreated,\n  } = props;\n  useEffect(() => {\n    registerSignalsRuntime();\n  }, []);\n\n  const [clients, setClients] = useState(props.clients ?? []);\n  const [spaceKey, setSpaceKey] = useState<PublicKey>();\n\n  const testBuilder = useRef(new TestBuilder());\n  useEffect(() => {\n    const timeout = setTimeout(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: faker.commerce.productName() });\n        setSpaceKey(space.key);\n        await onSpaceCreated?.({ client, space }, {});\n        await Promise.all(\n          clients.slice(1).flatMap((client) => performInvitation({ host: space, guest: client.spaces })),\n        );\n      }\n\n      setClients(clients);\n    });\n\n    return () => clearTimeout(timeout);\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} spaceKey={spaceKey} {...{ ...props.args }} />\n        </ClientProvider>\n      ))}\n    </>\n  );\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type StoryContext, type Decorator } from '@storybook/react';\nimport React, { createContext, type PropsWithChildren, useContext, useEffect, useRef, useState } from 'react';\nimport { type FallbackProps, ErrorBoundary as NativeErrorBoundary } from 'react-error-boundary';\n\nimport { Trigger } from '@dxos/async';\nimport { type Client } from '@dxos/client';\nimport { type Space } from '@dxos/client/echo';\nimport { performInvitation, TestBuilder } from '@dxos/client/testing';\nimport { log } from '@dxos/log';\nimport { type MaybePromise } from '@dxos/util';\n\nimport { ClientStory } from './context';\nimport { ClientProvider, type ClientProviderProps } from '../client';\n\ntype InitializeProps = {\n  createIdentity?: boolean;\n  createSpace?: boolean;\n  onInitialized?: (client: Client) => MaybePromise<void>;\n  onIdentityCreated?: (props: { client: Client }) => MaybePromise<void>;\n  // NOTE: context must be untyped until ClientRepeater is removed.\n  onSpaceCreated?: (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, onSpaceCreated, onIdentityCreated, 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 onIdentityCreated?.({ client });\n    }\n  }\n\n  let space: Space | undefined;\n  if (createSpace) {\n    space = await client.spaces.create({ name: 'Test Space' });\n    await onSpaceCreated?.({ client, space }, context);\n  }\n\n  return { space };\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  onSpaceCreated,\n  onIdentityCreated,\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          onSpaceCreated,\n          onIdentityCreated,\n          onInitialized,\n        },\n        context,\n      );\n\n      setData(data);\n    };\n\n    return (\n      <ErrorBoundary>\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\nconst MultiClientContext = createContext<{ id: number }>({ id: 0 });\n\nexport const useMultiClient = () => useContext(MultiClientContext);\n\n/**\n * Decorator that creates a scaffold for multiple clients.\n * Orchestrates invitations between a randomly selected host and the remaining clients.\n * NOTE: Should come before withLayout.\n */\nexport const withMultiClientProvider = ({\n  numClients = 2,\n  createIdentity,\n  createSpace,\n  onSpaceCreated,\n  onIdentityCreated,\n  onInitialized,\n  ...props\n}: WithMultiClientProviderProps): Decorator => {\n  return (Story, context) => {\n    const builder = useRef(new TestBuilder());\n    const hostRef = useRef<Client>();\n    const spaceReady = useRef(new Trigger<Space | undefined>());\n\n    // Handle invitations.\n    // NOTE: The zeroth client isn't necessarily the first to be initialized.\n    const handleInitialized = async (client: Client, index: number) => {\n      log.info('initialized', { index });\n      if (createSpace) {\n        if (!hostRef.current) {\n          hostRef.current = client;\n          const { space } = await initializeClient(\n            client,\n            {\n              createIdentity,\n              createSpace,\n              onSpaceCreated,\n              onIdentityCreated,\n              onInitialized,\n            },\n            context,\n          );\n\n          spaceReady.current.wake(space);\n          log.info('inviting', { index });\n        } else {\n          await initializeClient(client, { createIdentity, onInitialized }, context);\n          const space = await spaceReady.current.wait();\n          if (space) {\n            log.info('joining', { index });\n            await Promise.all(performInvitation({ host: space, guest: client.spaces }));\n          }\n        }\n      }\n    };\n\n    return (\n      <ErrorBoundary>\n        {Array.from({ length: numClients }).map((_, index) => (\n          <MultiClientContext.Provider key={index} value={{ id: index }}>\n            <ClientProvider\n              services={builder.current.createLocalClientServices()}\n              onInitialized={(client) => handleInitialized(client, index)}\n              {...props}\n            >\n              <Story />\n            </ClientProvider>\n          </MultiClientContext.Provider>\n        ))}\n      </ErrorBoundary>\n    );\n  };\n};\n\nconst ErrorBoundary = ({ children }: PropsWithChildren) => {\n  const [error, setError] = useState<Error>();\n  useEffect(() => {\n    const handleError = (event: PromiseRejectionEvent) => {\n      setError(event.reason);\n    };\n\n    window.addEventListener('unhandledrejection', handleError);\n    return () => window.removeEventListener('unhandledrejection', handleError);\n  }, []);\n\n  if (error) {\n    return <ErrorFallback error={error} resetErrorBoundary={() => setError(undefined)} />;\n  }\n\n  return <NativeErrorBoundary FallbackComponent={ErrorFallback}>{children}</NativeErrorBoundary>;\n};\n\nconst ErrorFallback = ({ error }: FallbackProps) => {\n  const { name, message, stack } =\n    error instanceof Error ? error : { name: 'Error', message: String(error), stack: undefined };\n  return (\n    <div role='alert' className='flex flex-col p-4 gap-4 overflow-auto'>\n      <h1 className='text-xl text-red-500'>{name}</h1>\n      <div className='text-lg'>{message}</div>\n      {stack && <pre className='whitespace-pre-wrap text-sm text-subdued'>{stack}</pre>}\n    </div>\n  );\n};\n"],
+  "mappings": "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",
+  "names": ["createContext", "useContext", "raise", "ClientStory", "createContext", "undefined", "useClientProvider", "useContext", "raise", "Error", "React", "useState", "useEffect", "useRef", "Client", "TestBuilder", "performInvitation", "registerSignalsRuntime", "faker", "ClientRepeater", "props", "component", "Component", "controls", "Controls", "count", "types", "createIdentity", "createSpace", "onSpaceCreated", "useEffect", "registerSignalsRuntime", "clients", "setClients", "useState", "spaceKey", "setSpaceKey", "testBuilder", "useRef", "TestBuilder", "timeout", "setTimeout", "Array", "map", "_", "Client", "services", "current", "createLocalClientServices", "Promise", "all", "client", "initialize", "halo", "space", "spaces", "create", "name", "faker", "commerce", "productName", "key", "slice", "flatMap", "performInvitation", "host", "guest", "clearTimeout", "length", "index", "ClientProvider", "id", "args", "React", "createContext", "useContext", "useEffect", "useRef", "useState", "ErrorBoundary", "NativeErrorBoundary", "Trigger", "performInvitation", "TestBuilder", "log", "initializeClient", "client", "createIdentity", "createSpace", "onSpaceCreated", "onIdentityCreated", "onInitialized", "context", "halo", "identity", "get", "space", "spaces", "create", "name", "withClientProvider", "props", "Story", "data", "setData", "useState", "handleInitialized", "React", "ErrorBoundary", "ClientProvider", "ClientStory", "Provider", "value", "MultiClientContext", "createContext", "id", "useMultiClient", "useContext", "withMultiClientProvider", "numClients", "builder", "useRef", "TestBuilder", "hostRef", "spaceReady", "Trigger", "index", "log", "info", "current", "wake", "wait", "Promise", "all", "performInvitation", "host", "guest", "Array", "from", "length", "map", "_", "key", "services", "createLocalClientServices", "children", "error", "setError", "useEffect", "handleError", "event", "reason", "window", "addEventListener", "removeEventListener", "ErrorFallback", "resetErrorBoundary", "undefined", "NativeErrorBoundary", "FallbackComponent", "message", "stack", "Error", "String", "div", "role", "className", "h1", "pre"]
 }

package/dist/lib/node/{chunk-UJLDNXPC.cjs → chunk-Y2HFUT7P.cjs}

@@ -26,8 +26,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var chunk_UJLDNXPC_exports = {};
-__export(chunk_UJLDNXPC_exports, {
+var chunk_Y2HFUT7P_exports = {};
+__export(chunk_Y2HFUT7P_exports, {
   AgentHostingContext: () => AgentHostingContext,
   AgentHostingProvider: () => AgentHostingProvider,
   ClientContext: () => ClientContext,
@@ -40,7 +40,7 @@ __export(chunk_UJLDNXPC_exports, {
   useShellDisplay: () => useShellDisplay,
   useStatus: () => useStatus
 });
-module.exports = __toCommonJS(chunk_UJLDNXPC_exports);
+module.exports = __toCommonJS(chunk_Y2HFUT7P_exports);
 var import_react = __toESM(require("react"));
 var import_client = require("@dxos/client");
 var import_log = require("@dxos/log");
@@ -106,19 +106,24 @@ var ClientProvider = /* @__PURE__ */ (0, import_react2.forwardRef)(({ children,
     client
   ]);
   (0, import_react2.useEffect)(() => {
+    let disposed = false;
     const initialize = async (client3) => {
       if (!client3.initialized) {
-        await client3.initialize().catch(setError);
+        await client3.initialize().catch((err) => {
+          if (!disposed) {
+            setError(err);
+          }
+        });
         (0, import_log2.log)("client ready", void 0, {
           F: __dxlog_file,
-          L: 132,
+          L: 137,
           S: void 0,
           C: (f, a) => f(...a)
         });
         await onInitialized?.(client3);
         (0, import_log2.log)("initialization complete", void 0, {
           F: __dxlog_file,
-          L: 134,
+          L: 139,
           S: void 0,
           C: (f, a) => f(...a)
         });
@@ -130,63 +135,77 @@ var ClientProvider = /* @__PURE__ */ (0, import_react2.forwardRef)(({ children,
     };
     let client2;
     const t = setTimeout(async () => {
-      if (clientProvider) {
-        client2 = await (0, import_util.getAsyncProviderValue)(clientProvider);
-        await initialize(client2);
-      } else {
-        const config = await (0, import_util.getAsyncProviderValue)(configProvider);
-        (0, import_log2.log)("resolved config", {
-          config
-        }, {
-          F: __dxlog_file,
-          L: 153,
-          S: void 0,
-          C: (f, a) => f(...a)
-        });
-        const services = await (0, import_util.getAsyncProviderValue)(servicesProvider, config);
-        (0, import_log2.log)("created services", {
-          services
-        }, {
-          F: __dxlog_file,
-          L: 155,
-          S: void 0,
-          C: (f, a) => f(...a)
-        });
-        client2 = new import_client2.Client({
-          config,
-          services,
-          ...options
-        });
-        (0, import_log2.log)("created client", void 0, {
-          F: __dxlog_file,
-          L: 157,
-          S: void 0,
-          C: (f, a) => f(...a)
-        });
-        await initialize(client2);
+      try {
+        if (clientProvider) {
+          client2 = await (0, import_util.getAsyncProviderValue)(clientProvider);
+          await initialize(client2);
+        } else {
+          const config = await (0, import_util.getAsyncProviderValue)(configProvider);
+          (0, import_log2.log)("resolved config", {
+            config
+          }, {
+            F: __dxlog_file,
+            L: 159,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+          const services = await (0, import_util.getAsyncProviderValue)(servicesProvider, config);
+          (0, import_log2.log)("created services", {
+            services
+          }, {
+            F: __dxlog_file,
+            L: 161,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+          client2 = new import_client2.Client({
+            config,
+            services,
+            ...options
+          });
+          (0, import_log2.log)("created client", void 0, {
+            F: __dxlog_file,
+            L: 163,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+          await initialize(client2);
+        }
+      } catch (err) {
+        if (!disposed) {
+          import_log2.log.catch(err, void 0, {
+            F: __dxlog_file,
+            L: 168,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+        }
       }
     });
     return () => {
       (0, import_log2.log)("clean up", void 0, {
         F: __dxlog_file,
-        L: 163,
+        L: 174,
         S: void 0,
         C: (f, a) => f(...a)
       });
+      disposed = true;
       clearTimeout(t);
-      void client2?.destroy().then(() => {
-        (0, import_log2.log)("destroyed", void 0, {
+      if (!clientProvider) {
+        void client2?.destroy().then(() => {
+          (0, import_log2.log)("destroyed", void 0, {
+            F: __dxlog_file,
+            L: 182,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+        }).catch((err) => import_log2.log.catch(err, void 0, {
           F: __dxlog_file,
-          L: 168,
+          L: 184,
           S: void 0,
           C: (f, a) => f(...a)
-        });
-      }).catch((err) => import_log2.log.catch(err, void 0, {
-        F: __dxlog_file,
-        L: 170,
-        S: void 0,
-        C: (f, a) => f(...a)
-      }));
+        }));
+      }
     };
   }, [
     configProvider,
@@ -312,4 +331,4 @@ var makeClient = ({ config, halo }) => {
   useShellDisplay,
   useStatus
 });
-//# sourceMappingURL=chunk-UJLDNXPC.cjs.map
+//# sourceMappingURL=chunk-Y2HFUT7P.cjs.map

package/dist/lib/node/chunk-Y2HFUT7P.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/client/AgentHostingProvider.tsx", "../../../src/client/ClientProvider.tsx", "../../../src/client/context.ts", "../../../src/banner.ts", "../../../src/client/useClient.ts", "../../../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, { createContext, type PropsWithChildren, useContext, 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\nimport { useClient } from '../client';\n\nexport type AgentHostingProviderProps = { config: Config; halo: Halo };\n\nexport const AgentHostingContext = createContext<AgentHostingProviderClient | null>(null);\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\nexport const useAgentHostingClient = () => {\n  return useContext(AgentHostingContext);\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 2020 DXOS.org\n//\n\nimport React, {\n  forwardRef,\n  type FunctionComponent,\n  type PropsWithChildren,\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 { registerSignalsRuntime } from '@dxos/echo-signals/react';\nimport { log } from '@dxos/log';\nimport { useControlledValue } from '@dxos/react-hooks';\nimport { getAsyncProviderValue, type MaybePromise, type Provider } from '@dxos/util';\n\nimport { ClientContext, type ClientContextProps } from './context';\nimport { printBanner } from '../banner';\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     * Enable (by default) registration of Preact signals runtime for reactive ECHO objects.\n     * @see https://www.npmjs.com/package/@preact/signals-react\n     */\n    signalsRuntime?: boolean;\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: configProvider,\n      client: clientProvider,\n      services: servicesProvider,\n      status: controlledStatus,\n      fallback: Fallback = () => null,\n      signalsRuntime = true,\n      noBanner,\n      onInitialized,\n      ...options\n    },\n    forwardedRef,\n  ) => {\n    useEffect(() => {\n      // TODO(wittjosiah): Ideally this should be imported asynchronously because it is optional.\n      //   Unfortunately, async import seemed to break signals React instrumentation.\n      signalsRuntime && registerSignalsRuntime();\n    }, []);\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(clientProvider instanceof Client ? clientProvider : undefined);\n\n    // Provide external access.\n    useImperativeHandle(forwardedRef, () => client, [client]);\n\n    // Client status subscription.\n    const [status, setStatus] = useControlledValue(controlledStatus);\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    useEffect(() => {\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\n        if (!noBanner) {\n          printBanner(client);\n        }\n      };\n\n      let client: Client;\n      const t = setTimeout(async () => {\n        try {\n          if (clientProvider) {\n            // Asynchronously request client.\n            client = await getAsyncProviderValue(clientProvider);\n            await initialize(client);\n          } else {\n            // Asynchronously construct client (config may be undefined).\n            const config = await getAsyncProviderValue(configProvider);\n            log('resolved config', { config });\n            const services = await getAsyncProviderValue(servicesProvider, 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\n      return () => {\n        log('clean up');\n        disposed = true;\n        clearTimeout(t);\n        // Only destroy if the client is not provided by the parent.\n        if (!clientProvider) {\n          void client\n            ?.destroy()\n            .then(() => {\n              log('destroyed');\n            })\n            .catch((err) => log.catch(err));\n        }\n      };\n    }, [configProvider, clientProvider, servicesProvider, 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 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", "//\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 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", "//\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": "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",
+  "names": ["import_react", "import_client", "import_log", "import_debug", "ClientContext", "createContext", "undefined", "BANNER", "client", "commitHash", "config", "get", "hash", "version", "bannerPrinted", "printBanner", "window", "location", "hostname", "console", "log", "ClientProvider", "forwardRef", "children", "configProvider", "clientProvider", "services", "servicesProvider", "status", "controlledStatus", "fallback", "Fallback", "signalsRuntime", "noBanner", "onInitialized", "options", "forwardedRef", "useEffect", "registerSignalsRuntime", "error", "setError", "useState", "setClient", "Client", "useImperativeHandle", "setStatus", "useControlledValue", "subscription", "subscribe", "unsubscribe", "disposed", "initialize", "initialized", "catch", "err", "t", "setTimeout", "getAsyncProviderValue", "clearTimeout", "destroy", "then", "SystemStatus", "ACTIVE", "React", "Provider", "value", "useClient", "useContext", "raise", "Error", "useClientStatus", "useConfig", "useShell", "shell", "useShellDisplay", "display", "setDisplay", "onDisplayChange", "useStatus", "AgentHostingContext", "AgentHostingProvider", "props", "agentHostingProviderClient", "makeClient", "useAgentHostingClient", "halo", "agentHostingConfig", "type", "FakeAgentHostingProvider", "AgentManagerClient", "init"]
+}

package/dist/lib/node/devtools/index.cjs

@@ -23,13 +23,13 @@ __export(devtools_exports, {
   useStream: () => useStream
 });
 module.exports = __toCommonJS(devtools_exports);
-var import_chunk_UJLDNXPC = require("../chunk-UJLDNXPC.cjs");
+var import_chunk_Y2HFUT7P = require("../chunk-Y2HFUT7P.cjs");
 __reExport(devtools_exports, require("@dxos/client/devtools"), module.exports);
 var import_debug = require("@dxos/debug");
 var import_react = require("react");
 var import_log = require("@dxos/log");
 var useDevtools = () => {
-  const client = (0, import_chunk_UJLDNXPC.useClient)();
+  const client = (0, import_chunk_Y2HFUT7P.useClient)();
   return client.services.services.DevtoolsHost ?? (0, import_debug.raise)(new Error("DevtoolsHost not available."));
 };
 var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/devtools/useStream.ts";

package/dist/lib/node/devtools/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "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, useState, useEffect } from 'react';\n\nimport { type Stream } from '@dxos/codec-protobuf';\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"],
+  "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, useState, useEffect } 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,6BAAc;ACCd,mBAAsB;ACDtB,mBAAyD;AAGzD,iBAAoB;ADEb,IAAMA,cAAc,MAAA;AACzB,QAAMC,aAASC,iCAAAA;AACf,SAAOD,OAAOE,SAASA,SAASC,oBAAgBC,oBAAM,IAAIC,MAAM,6BAAA,CAAA;AAClE;;ACAO,IAAMC,YAAY,CAAIC,eAAgCC,cAAiBC,OAAuB,CAAA,MAAE;AACrG,QAAM,CAACC,OAAOC,QAAAA,QAAYC,uBAAwBJ,YAAAA;AAClDK,8BAAU,MAAA;AACR,UAAMC,SAASP,cAAAA;AACfO,WAAOC,UACL,CAACC,aAAgBL,SAASK,QAAAA,GAC1B,CAACC,QAAAA;AACC,UAAIA,KAAK;AACPC,uBAAIC,MAAMF,KAAAA,QAAAA;;;;;;MACZ;IACF,CAAA;AAGF,WAAO,MAAA;AACL,WAAKH,OAAOM,MAAK;IACnB;EACF,GAAGX,IAAAA;AAEH,SAAOC,SAASF;AAClB;",
   "names": ["useDevtools", "client", "useClient", "services", "DevtoolsHost", "raise", "Error", "useStream", "streamFactory", "defaultValue", "deps", "value", "setValue", "useState", "useEffect", "stream", "subscribe", "response", "err", "log", "catch", "close"]
 }

package/dist/lib/node/echo/index.cjs

@@ -29,7 +29,7 @@ __export(echo_exports, {
 });
 module.exports = __toCommonJS(echo_exports);
 var import_chunk_FYOAVV65 = require("../chunk-FYOAVV65.cjs");
-var import_chunk_UJLDNXPC = require("../chunk-UJLDNXPC.cjs");
+var import_chunk_Y2HFUT7P = require("../chunk-Y2HFUT7P.cjs");
 __reExport(echo_exports, require("@dxos/client/echo"), module.exports);
 var import_async = require("@dxos/async");
 var import_echo = require("@dxos/client/echo");
@@ -45,7 +45,7 @@ var import_react_hooks3 = require("@dxos/react-hooks");
 var import_react4 = require("react");
 var import_echo4 = require("@dxos/client/echo");
 var useSpace = (spaceKeyLike) => {
-  const client = (0, import_chunk_UJLDNXPC.useClient)();
+  const client = (0, import_chunk_Y2HFUT7P.useClient)();
   const spaces = (0, import_react_hooks2.useMulticastObservable)(client.spaces);
   const [ready, setReady] = (0, import_react.useState)(false);
   (0, import_react.useEffect)(() => {
@@ -69,7 +69,7 @@ var useSpace = (spaceKeyLike) => {
   }
 };
 var useSpaces = ({ all = false } = {}) => {
-  const client = (0, import_chunk_UJLDNXPC.useClient)();
+  const client = (0, import_chunk_Y2HFUT7P.useClient)();
   const spaces = (0, import_react_hooks2.useMulticastObservable)(client.spaces);
   return spaces.filter((space) => all || space.state.get() === import_echo2.SpaceState.SPACE_READY);
 };