@dxos/react-client 0.7.2 → 0.7.3-main.2dd075e

package/dist/lib/node-esm/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  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, onInitialized }: InitializeProps,\n): Promise<StoryClientProps> => {\n  const clientData = await onInitialized?.(client);\n\n  if (createIdentity || createSpace) {\n    if (!client.halo.identity.get()) {\n      await client.halo.createIdentity();\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, ...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  onInitialized,\n  ...props\n}: WithClientProviderProps = {}): Decorator => {\n  return (Story) => {\n    const [data, setData] = useState<StoryClientProps>({});\n\n    const handleInitialized = async (client: Client) => {\n      setData(await initializeClient(client, { createIdentity, createSpace, onSpaceCreated, onInitialized }));\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  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            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", "onInitialized", "clientData", "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"]
+  "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"]
 }

package/dist/types/src/testing/withClientProvider.d.ts

@@ -7,6 +7,9 @@ type InitializeProps = {
     createIdentity?: boolean;
     createSpace?: boolean;
     onInitialized?: (client: Client) => MaybePromise<Record<string, any> | void>;
+    onIdentityCreated?: (props: {
+        client: Client;
+    }) => MaybePromise<Record<string, any> | void>;
     onSpaceCreated?: (props: {
         client: Client;
         space: Space;
@@ -20,7 +23,7 @@ export type WithClientProviderProps = InitializeProps & Omit<ClientProviderProps
 /**
  * Decorator that provides the client context.
  */
-export declare const withClientProvider: ({ createIdentity, createSpace, onSpaceCreated, onInitialized, ...props }?: WithClientProviderProps) => Decorator;
+export declare const withClientProvider: ({ createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized, ...props }?: WithClientProviderProps) => Decorator;
 export type WithMultiClientProviderProps = InitializeProps & Omit<ClientProviderProps, 'onInitialized'> & {
     numClients?: number;
 };
@@ -32,6 +35,6 @@ export declare const useMultiClient: () => {
  * Orchestrates invitations between a randomly selected host and the remaining clients.
  * NOTE: Should come before withLayout.
  */
-export declare const withMultiClientProvider: ({ numClients, createIdentity, createSpace, onSpaceCreated, onInitialized, ...props }: WithMultiClientProviderProps) => Decorator;
+export declare const withMultiClientProvider: ({ numClients, createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized, ...props }: WithMultiClientProviderProps) => Decorator;
 export {};
 //# sourceMappingURL=withClientProvider.d.ts.map

package/dist/types/src/testing/withClientProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withClientProvider.d.ts","sourceRoot":"","sources":["../../../../src/testing/withClientProvider.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErE,KAAK,eAAe,GAAG;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;CACxG,CAAC;AA2BF,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAKvG,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,iCAE/C,gBAAgB,CAAC,CAAC,CAClC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;AAEnG;;GAEG;AACH,eAAO,MAAM,kBAAkB,8EAM5B,uBAAuB,KAAQ,SAkBjC,CAAC;AAKF,MAAM,MAAM,4BAA4B,GAAG,eAAe,GACxD,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvE,eAAO,MAAM,cAAc;QAFoB,MAAM;CAEa,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,yFAOjC,4BAA4B,KAAG,SAgDjC,CAAC"}
+{"version":3,"file":"withClientProvider.d.ts","sourceRoot":"","sources":["../../../../src/testing/withClientProvider.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErE,KAAK,eAAe,GAAG;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7E,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5F,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;CACxG,CAAC;AA6BF,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAKvG,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,iCAE/C,gBAAgB,CAAC,CAAC,CAClC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;AAEnG;;GAEG;AACH,eAAO,MAAM,kBAAkB,iGAO5B,uBAAuB,KAAQ,SA0BjC,CAAC;AAKF,MAAM,MAAM,4BAA4B,GAAG,eAAe,GACxD,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAIvE,eAAO,MAAM,cAAc;QAFoB,MAAM;CAEa,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,4GAQjC,4BAA4B,KAAG,SAiDjC,CAAC"}

package/package.json

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

package/src/banner.ts

@@ -23,7 +23,7 @@ const BANNER = (client: Client) => {
 let bannerPrinted = false;
 
 export const printBanner = (client: Client) => {
-  if (bannerPrinted) {
+  if (bannerPrinted || window.location.hostname === 'localhost') {
     return;
   }
 

package/src/testing/withClientProvider.tsx

@@ -20,6 +20,7 @@ type InitializeProps = {
   createIdentity?: boolean;
   createSpace?: boolean;
   onInitialized?: (client: Client) => MaybePromise<Record<string, any> | void>;
+  onIdentityCreated?: (props: { client: Client }) => MaybePromise<Record<string, any> | void>;
   onSpaceCreated?: (props: { client: Client; space: Space }) => MaybePromise<Record<string, any> | void>;
 };
 
@@ -28,13 +29,15 @@ type InitializeProps = {
  */
 const initializeClient = async (
   client: Client,
-  { createIdentity, createSpace, onSpaceCreated, onInitialized }: InitializeProps,
+  { createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized }: InitializeProps,
 ): Promise<StoryClientProps> => {
   const clientData = await onInitialized?.(client);
 
+  let identityData: Record<string, any> | void = {};
   if (createIdentity || createSpace) {
     if (!client.halo.identity.get()) {
       await client.halo.createIdentity();
+      identityData = await onIdentityCreated?.({ client });
     }
   }
 
@@ -45,7 +48,7 @@ const initializeClient = async (
     spaceData = await onSpaceCreated?.({ client, space });
   }
 
-  return { space, ...clientData, ...spaceData };
+  return { space, ...clientData, ...identityData, ...spaceData };
 };
 
 type StoryClientProps<T extends Record<string, any> = Record<string, unknown>> = T & { space?: Space };
@@ -67,6 +70,7 @@ export const withClientProvider = ({
   createIdentity,
   createSpace,
   onSpaceCreated,
+  onIdentityCreated,
   onInitialized,
   ...props
 }: WithClientProviderProps = {}): Decorator => {
@@ -74,7 +78,15 @@ export const withClientProvider = ({
     const [data, setData] = useState<StoryClientProps>({});
 
     const handleInitialized = async (client: Client) => {
-      setData(await initializeClient(client, { createIdentity, createSpace, onSpaceCreated, onInitialized }));
+      setData(
+        await initializeClient(client, {
+          createIdentity,
+          createSpace,
+          onSpaceCreated,
+          onIdentityCreated,
+          onInitialized,
+        }),
+      );
     };
 
     return (
@@ -109,6 +121,7 @@ export const withMultiClientProvider = ({
   createIdentity,
   createSpace,
   onSpaceCreated,
+  onIdentityCreated,
   onInitialized,
   ...props
 }: WithMultiClientProviderProps): Decorator => {
@@ -128,6 +141,7 @@ export const withMultiClientProvider = ({
             createIdentity,
             createSpace,
             onSpaceCreated,
+            onIdentityCreated,
             onInitialized,
           });
           spaceReady.current.wake(space);