@dxos/react-client 0.8.4-main.f5c0578 → 0.8.4-main.fcfe5033a5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/.storybook/main.mts +9 -0
  2. package/.storybook/preview.mts +8 -0
  3. package/.swc/plugins/linux_x86_64_19.0.0/727453fb3a62f7f1d952a41e051ca8a6f88cadc45cee43c6a4d1aa45f9b75665.wasmer-v7 +0 -0
  4. package/dist/lib/browser/chunk-BVDNYEYI.mjs +179 -0
  5. package/dist/lib/browser/chunk-BVDNYEYI.mjs.map +7 -0
  6. package/dist/lib/browser/{chunk-BXOLJYAY.mjs → chunk-LO3TU5CK.mjs} +4 -4
  7. package/dist/lib/browser/chunk-LO3TU5CK.mjs.map +7 -0
  8. package/dist/lib/browser/chunk-PFF63FPR.mjs +16 -0
  9. package/dist/lib/browser/chunk-PFF63FPR.mjs.map +7 -0
  10. package/dist/lib/browser/chunk-TSF6Y5VB.mjs +8 -0
  11. package/dist/lib/browser/chunk-TSF6Y5VB.mjs.map +7 -0
  12. package/dist/lib/browser/devtools/index.mjs +2 -1
  13. package/dist/lib/browser/devtools/index.mjs.map +1 -1
  14. package/dist/lib/browser/echo/index.mjs +58 -121
  15. package/dist/lib/browser/echo/index.mjs.map +4 -4
  16. package/dist/lib/browser/halo/index.mjs +4 -4
  17. package/dist/lib/browser/halo/index.mjs.map +2 -2
  18. package/dist/lib/browser/index.mjs +114 -12
  19. package/dist/lib/browser/index.mjs.map +4 -4
  20. package/dist/lib/browser/invitations/index.mjs +1 -1
  21. package/dist/lib/browser/mesh/index.mjs +2 -1
  22. package/dist/lib/browser/mesh/index.mjs.map +1 -1
  23. package/dist/lib/browser/meta.json +1 -1
  24. package/dist/lib/browser/testing/index.mjs +121 -149
  25. package/dist/lib/browser/testing/index.mjs.map +3 -3
  26. package/dist/lib/node-esm/chunk-373DPHEQ.mjs +10 -0
  27. package/dist/lib/node-esm/chunk-373DPHEQ.mjs.map +7 -0
  28. package/dist/lib/node-esm/{chunk-256IHY6F.mjs → chunk-AQJH2UNZ.mjs} +4 -4
  29. package/dist/lib/node-esm/chunk-AQJH2UNZ.mjs.map +7 -0
  30. package/dist/lib/node-esm/chunk-NETTSER2.mjs +17 -0
  31. package/dist/lib/node-esm/chunk-NETTSER2.mjs.map +7 -0
  32. package/dist/lib/node-esm/chunk-VSA674XR.mjs +180 -0
  33. package/dist/lib/node-esm/chunk-VSA674XR.mjs.map +7 -0
  34. package/dist/lib/node-esm/devtools/index.mjs +2 -1
  35. package/dist/lib/node-esm/devtools/index.mjs.map +1 -1
  36. package/dist/lib/node-esm/echo/index.mjs +58 -121
  37. package/dist/lib/node-esm/echo/index.mjs.map +4 -4
  38. package/dist/lib/node-esm/halo/index.mjs +4 -4
  39. package/dist/lib/node-esm/halo/index.mjs.map +2 -2
  40. package/dist/lib/node-esm/index.mjs +114 -12
  41. package/dist/lib/node-esm/index.mjs.map +4 -4
  42. package/dist/lib/node-esm/invitations/index.mjs +1 -1
  43. package/dist/lib/node-esm/mesh/index.mjs +2 -1
  44. package/dist/lib/node-esm/mesh/index.mjs.map +1 -1
  45. package/dist/lib/node-esm/meta.json +1 -1
  46. package/dist/lib/node-esm/testing/index.mjs +121 -149
  47. package/dist/lib/node-esm/testing/index.mjs.map +3 -3
  48. package/dist/types/src/client/ClientProvider.d.ts +0 -10
  49. package/dist/types/src/client/ClientProvider.d.ts.map +1 -1
  50. package/dist/types/src/echo/index.d.ts +2 -2
  51. package/dist/types/src/echo/index.d.ts.map +1 -1
  52. package/dist/types/src/echo/useMembers.d.ts +2 -2
  53. package/dist/types/src/echo/useMembers.d.ts.map +1 -1
  54. package/dist/types/src/echo/useQueue.d.ts +3 -2
  55. package/dist/types/src/echo/useQueue.d.ts.map +1 -1
  56. package/dist/types/src/echo/useSpaceInvitations.d.ts +3 -2
  57. package/dist/types/src/echo/useSpaceInvitations.d.ts.map +1 -1
  58. package/dist/types/src/echo/useSpaceProperties.d.ts +13 -0
  59. package/dist/types/src/echo/useSpaceProperties.d.ts.map +1 -0
  60. package/dist/types/src/echo/useSpaces.d.ts +18 -9
  61. package/dist/types/src/echo/useSpaces.d.ts.map +1 -1
  62. package/dist/types/src/echo/useSubscription.d.ts +1 -1
  63. package/dist/types/src/echo/useSubscription.d.ts.map +1 -1
  64. package/dist/types/src/echo/useSyncState.d.ts.map +1 -1
  65. package/dist/types/src/halo/Passkey.stories.d.ts +5 -5
  66. package/dist/types/src/halo/Passkey.stories.d.ts.map +1 -1
  67. package/dist/types/src/invitations/useInvitationStatus.d.ts +1 -1
  68. package/dist/types/src/invitations/useInvitationStatus.d.ts.map +1 -1
  69. package/dist/types/src/testing/ClientRepeater.d.ts +6 -5
  70. package/dist/types/src/testing/ClientRepeater.d.ts.map +1 -1
  71. package/dist/types/src/testing/ClientRepeater.stories.d.ts +6 -10
  72. package/dist/types/src/testing/ClientRepeater.stories.d.ts.map +1 -1
  73. package/dist/types/src/testing/context.d.ts +4 -2
  74. package/dist/types/src/testing/context.d.ts.map +1 -1
  75. package/dist/types/src/testing/util.d.ts.map +1 -1
  76. package/dist/types/src/testing/withClientProvider.d.ts +5 -9
  77. package/dist/types/src/testing/withClientProvider.d.ts.map +1 -1
  78. package/dist/types/src/testing/withClientProvider.stories.d.ts +8 -9
  79. package/dist/types/src/testing/withClientProvider.stories.d.ts.map +1 -1
  80. package/dist/types/tsconfig.tsbuildinfo +1 -1
  81. package/docs/README.md +38 -38
  82. package/moon.yml +3 -2
  83. package/package.json +35 -33
  84. package/src/client/ClientProvider.test.tsx +0 -1
  85. package/src/client/ClientProvider.tsx +29 -48
  86. package/src/client/useConfig.test.tsx +0 -1
  87. package/src/echo/index.ts +2 -2
  88. package/src/echo/useMembers.ts +5 -3
  89. package/src/echo/useQueue.ts +3 -4
  90. package/src/echo/useSpaceInvitations.ts +9 -5
  91. package/src/echo/useSpaceProperties.ts +28 -0
  92. package/src/echo/useSpaces.test.tsx +7 -14
  93. package/src/echo/useSpaces.ts +31 -30
  94. package/src/echo/useSubscription.ts +1 -1
  95. package/src/echo/useSyncState.ts +4 -3
  96. package/src/halo/Passkey.stories.tsx +15 -14
  97. package/src/halo/useDevices.test.tsx +0 -1
  98. package/src/invitations/useInvitationStatus.ts +9 -8
  99. package/src/testing/ClientRepeater.stories.tsx +19 -12
  100. package/src/testing/ClientRepeater.tsx +31 -40
  101. package/src/testing/context.tsx +4 -3
  102. package/src/testing/util.tsx +0 -1
  103. package/src/testing/withClientProvider.stories.tsx +30 -17
  104. package/src/testing/withClientProvider.tsx +74 -92
  105. package/tsconfig.json +3 -6
  106. package/typedoc.json +1 -1
  107. package/vitest.config.ts +10 -16
  108. package/.swc/plugins/v7_linux_x86_64_13.0.0/c614d7475354583212fbd7669acbae95b9832c305bf51bdaabe2e6de05abb6bf +0 -0
  109. package/dist/lib/browser/chunk-BXOLJYAY.mjs.map +0 -7
  110. package/dist/lib/browser/chunk-FQAPI3I4.mjs +0 -312
  111. package/dist/lib/browser/chunk-FQAPI3I4.mjs.map +0 -7
  112. package/dist/lib/node-esm/chunk-256IHY6F.mjs.map +0 -7
  113. package/dist/lib/node-esm/chunk-MNTJNI2M.mjs +0 -314
  114. package/dist/lib/node-esm/chunk-MNTJNI2M.mjs.map +0 -7
  115. package/dist/types/src/echo/useQuery.d.ts +0 -11
  116. package/dist/types/src/echo/useQuery.d.ts.map +0 -1
  117. package/dist/types/src/echo/useQuery.test.d.ts +0 -2
  118. package/dist/types/src/echo/useQuery.test.d.ts.map +0 -1
  119. package/dist/types/src/echo/useSchema.d.ts +0 -8
  120. package/dist/types/src/echo/useSchema.d.ts.map +0 -1
  121. package/dist/types/src/playwright/playwright.config.d.ts +0 -3
  122. package/dist/types/src/playwright/playwright.config.d.ts.map +0 -1
  123. package/dist/types/src/playwright/smoke.spec.d.ts +0 -2
  124. package/dist/types/src/playwright/smoke.spec.d.ts.map +0 -1
  125. package/src/echo/useQuery.test.tsx +0 -129
  126. package/src/echo/useQuery.ts +0 -56
  127. package/src/echo/useSchema.ts +0 -54
  128. package/src/playwright/playwright.config.ts +0 -17
  129. package/src/playwright/smoke.spec.ts +0 -24
@@ -3,27 +3,26 @@
3
3
  //
4
4
 
5
5
  import { type Decorator, type StoryContext } from '@storybook/react';
6
- import React, { type PropsWithChildren, createContext, useContext, useEffect, useRef, useState } from 'react';
7
- import { type FallbackProps, ErrorBoundary as NativeErrorBoundary } from 'react-error-boundary';
6
+ import React, { useCallback, useMemo, useRef, useState } from 'react';
8
7
 
9
8
  import { Trigger } from '@dxos/async';
10
9
  import { type Client } from '@dxos/client';
11
- import { type Space } from '@dxos/client/echo';
10
+ import { type Space, type SpaceId } from '@dxos/client/echo';
12
11
  import { TestBuilder, performInvitation } from '@dxos/client/testing';
13
12
  import { log } from '@dxos/log';
13
+ import { ErrorBoundary } from '@dxos/react-ui';
14
14
  import { type MaybePromise } from '@dxos/util';
15
15
 
16
16
  import { ClientProvider, type ClientProviderProps } from '../client';
17
-
18
17
  import { ClientStory } from './context';
19
18
 
20
19
  type InitializeProps = {
21
20
  createIdentity?: boolean;
22
21
  createSpace?: boolean;
23
22
  onInitialized?: (client: Client) => MaybePromise<void>;
24
- onIdentityCreated?: (props: { client: Client }) => MaybePromise<void>;
23
+ onCreateIdentity?: (props: { client: Client }, context: StoryContext | any) => MaybePromise<void>;
25
24
  // NOTE: context must be untyped until ClientRepeater is removed.
26
- onSpaceCreated?: (props: { client: Client; space: Space }, context: StoryContext | any) => MaybePromise<void>;
25
+ onCreateSpace?: (props: { client: Client; space: Space }, context: StoryContext | any) => MaybePromise<void>;
27
26
  };
28
27
 
29
28
  /**
@@ -31,7 +30,7 @@ type InitializeProps = {
31
30
  */
32
31
  const initializeClient = async (
33
32
  client: Client,
34
- { createIdentity, createSpace, onSpaceCreated, onIdentityCreated, onInitialized }: InitializeProps,
33
+ { createIdentity, createSpace, onCreateIdentity, onCreateSpace, onInitialized }: InitializeProps,
35
34
  context: StoryContext,
36
35
  ): Promise<ClientStory> => {
37
36
  await onInitialized?.(client);
@@ -39,17 +38,18 @@ const initializeClient = async (
39
38
  if (createIdentity || createSpace) {
40
39
  if (!client.halo.identity.get()) {
41
40
  await client.halo.createIdentity();
42
- await onIdentityCreated?.({ client });
41
+ await onCreateIdentity?.({ client }, context);
43
42
  }
44
43
  }
45
44
 
46
45
  let space: Space | undefined;
47
46
  if (createSpace) {
48
47
  space = await client.spaces.create({ name: 'Test Space' });
49
- await onSpaceCreated?.({ client, space }, context);
48
+ await space.waitUntilReady(); // Is this required?
49
+ await onCreateSpace?.({ client, space }, context);
50
50
  }
51
51
 
52
- return { space };
52
+ return { space, spaceId: space?.id };
53
53
  };
54
54
 
55
55
  export type WithClientProviderProps = InitializeProps & Omit<ClientProviderProps, 'onInitialized'>;
@@ -60,8 +60,8 @@ export type WithClientProviderProps = InitializeProps & Omit<ClientProviderProps
60
60
  export const withClientProvider = ({
61
61
  createIdentity,
62
62
  createSpace,
63
- onSpaceCreated,
64
- onIdentityCreated,
63
+ onCreateSpace,
64
+ onCreateIdentity,
65
65
  onInitialized,
66
66
  ...props
67
67
  }: WithClientProviderProps = {}): Decorator => {
@@ -73,8 +73,8 @@ export const withClientProvider = ({
73
73
  {
74
74
  createIdentity,
75
75
  createSpace,
76
- onSpaceCreated,
77
- onIdentityCreated,
76
+ onCreateSpace,
77
+ onCreateIdentity,
78
78
  onInitialized,
79
79
  },
80
80
  context,
@@ -84,7 +84,7 @@ export const withClientProvider = ({
84
84
  };
85
85
 
86
86
  return (
87
- <ErrorBoundary>
87
+ <ErrorBoundary name='client-provider'>
88
88
  <ClientProvider onInitialized={handleInitialized} {...props}>
89
89
  <ClientStory.Provider value={data}>
90
90
  <Story />
@@ -101,105 +101,87 @@ export const withClientProvider = ({
101
101
  export type WithMultiClientProviderProps = InitializeProps &
102
102
  Omit<ClientProviderProps, 'onInitialized'> & { numClients?: number };
103
103
 
104
- const MultiClientContext = createContext<{ id: number }>({ id: 0 });
105
-
106
- export const useMultiClient = () => useContext(MultiClientContext);
107
-
108
104
  /**
109
105
  * Decorator that creates a scaffold for multiple clients.
110
106
  * Orchestrates invitations between a randomly selected host and the remaining clients.
111
- * NOTE: Should come before withLayout.
112
107
  */
113
108
  export const withMultiClientProvider = ({
114
109
  numClients = 2,
115
110
  createIdentity,
116
111
  createSpace,
117
- onSpaceCreated,
118
- onIdentityCreated,
112
+ onCreateSpace,
113
+ onCreateIdentity,
119
114
  onInitialized,
120
115
  ...props
121
116
  }: WithMultiClientProviderProps): Decorator => {
122
117
  return (Story, context) => {
123
- const builder = useRef(new TestBuilder());
124
- const hostRef = useRef<Client>();
125
118
  const spaceReady = useRef(new Trigger<Space | undefined>());
119
+ const [spaceId, setSpaceId] = useState<SpaceId>();
120
+
121
+ const clients = useMemo(() => {
122
+ const buidler = new TestBuilder();
123
+ return Array.from({ length: numClients }).map(() => {
124
+ return {
125
+ services: buidler.createLocalClientServices(),
126
+ };
127
+ });
128
+ }, [numClients]);
126
129
 
127
130
  // Handle invitations.
128
131
  // NOTE: The zeroth client isn't necessarily the first to be initialized.
129
- const handleInitialized = async (client: Client, index: number) => {
130
- log.info('initialized', { index });
131
- if (createSpace) {
132
- if (!hostRef.current) {
133
- hostRef.current = client;
134
- const { space } = await initializeClient(
135
- client,
136
- {
137
- createIdentity,
138
- createSpace,
139
- onSpaceCreated,
140
- onIdentityCreated,
141
- onInitialized,
142
- },
143
- context,
132
+ const handleInitialized = useCallback(async (client: Client, index: number) => {
133
+ if (index === 0) {
134
+ // Initialize host.
135
+ const { space } = await initializeClient(
136
+ client,
137
+ {
138
+ createIdentity,
139
+ createSpace,
140
+ onCreateSpace,
141
+ onCreateIdentity,
142
+ onInitialized,
143
+ },
144
+ context,
145
+ );
146
+
147
+ log.info('inviting', { index, spaceId: space?.id });
148
+ setSpaceId(space?.id);
149
+ spaceReady.current.wake(space);
150
+ } else {
151
+ // Initialize guest.
152
+ await initializeClient(client, { createIdentity, onInitialized }, context);
153
+
154
+ log.info('waiting', { index });
155
+ const space = await spaceReady.current.wait();
156
+ if (space) {
157
+ log.info('joining', { index, spaceId: space.id });
158
+ await Promise.all(
159
+ performInvitation({
160
+ host: space,
161
+ guest: client.spaces,
162
+ }),
144
163
  );
145
-
146
- spaceReady.current.wake(space);
147
- log.info('inviting', { index });
148
- } else {
149
- await initializeClient(client, { createIdentity, onInitialized }, context);
150
- const space = await spaceReady.current.wait();
151
- if (space) {
152
- log.info('joining', { index });
153
- await Promise.all(performInvitation({ host: space, guest: client.spaces }));
154
- }
155
164
  }
156
165
  }
157
- };
166
+ }, []);
158
167
 
159
168
  return (
160
- <ErrorBoundary>
161
- {Array.from({ length: numClients }).map((_, index) => (
162
- <MultiClientContext.Provider key={index} value={{ id: index }}>
163
- <ClientProvider
164
- services={builder.current.createLocalClientServices()}
165
- onInitialized={(client) => handleInitialized(client, index)}
166
- {...props}
167
- >
168
- <Story />
169
- </ClientProvider>
170
- </MultiClientContext.Provider>
169
+ <div className='absolute inset-0 grid grid-flow-col auto-cols-fr gap-4 overflow-hidden'>
170
+ {clients.map((client, index) => (
171
+ <ClientProvider
172
+ key={index}
173
+ services={client.services}
174
+ onInitialized={(client) => handleInitialized(client, index)}
175
+ {...props}
176
+ >
177
+ <ClientStory.Provider value={{ index, spaceId }}>
178
+ <ErrorBoundary name='client-provider'>
179
+ <Story />
180
+ </ErrorBoundary>
181
+ </ClientStory.Provider>
182
+ </ClientProvider>
171
183
  ))}
172
- </ErrorBoundary>
184
+ </div>
173
185
  );
174
186
  };
175
187
  };
176
-
177
- const ErrorBoundary = ({ children }: PropsWithChildren) => {
178
- const [error, setError] = useState<Error>();
179
- useEffect(() => {
180
- const handleError = (event: PromiseRejectionEvent) => {
181
- setError(event.reason);
182
- };
183
-
184
- window.addEventListener('unhandledrejection', handleError);
185
- return () => window.removeEventListener('unhandledrejection', handleError);
186
- }, []);
187
-
188
- if (error) {
189
- return <ErrorFallback error={error} resetErrorBoundary={() => setError(undefined)} />;
190
- }
191
-
192
- return <NativeErrorBoundary FallbackComponent={ErrorFallback}>{children}</NativeErrorBoundary>;
193
- };
194
-
195
- const ErrorFallback = ({ error }: FallbackProps) => {
196
- const { name, message, stack } =
197
- error instanceof Error ? error : { name: 'Error', message: String(error), stack: undefined };
198
- return (
199
- <div role='alert' className='flex flex-col p-4 gap-4 overflow-auto'>
200
- <h1 className='text-xl text-red-500'>{name}</h1>
201
- <div className='text-lg'>{message}</div>
202
- {stack && <pre className='whitespace-pre-wrap text-sm text-subdued'>{stack}</pre>}
203
- </div>
204
- );
205
- };
package/tsconfig.json CHANGED
@@ -45,16 +45,13 @@
45
45
  "path": "../../core/echo/echo"
46
46
  },
47
47
  {
48
- "path": "../../core/echo/echo-schema"
49
- },
50
- {
51
- "path": "../../core/echo/echo-signals"
48
+ "path": "../../core/echo/echo-react"
52
49
  },
53
50
  {
54
51
  "path": "../../core/protocols"
55
52
  },
56
53
  {
57
- "path": "../../ui/primitives/react-hooks"
54
+ "path": "../../ui/react-primitives/react-hooks"
58
55
  },
59
56
  {
60
57
  "path": "../../ui/react-ui"
@@ -63,7 +60,7 @@
63
60
  "path": "../../ui/react-ui-syntax-highlighter"
64
61
  },
65
62
  {
66
- "path": "../../ui/react-ui-theme"
63
+ "path": "../../ui/ui-theme"
67
64
  },
68
65
  {
69
66
  "path": "../client"
package/typedoc.json CHANGED
@@ -9,4 +9,4 @@
9
9
  "src/mesh/index.ts",
10
10
  "src/worker.ts"
11
11
  ]
12
- }
12
+ }
package/vitest.config.ts CHANGED
@@ -2,21 +2,15 @@
2
2
  // Copyright 2024 DXOS.org
3
3
  //
4
4
 
5
- import { defineConfig, mergeConfig } from 'vitest/config';
5
+ import path from 'node:path';
6
+ import { fileURLToPath } from 'node:url';
6
7
 
7
- import { baseConfig } from '../../../vitest.base.config';
8
+ import { createConfig } from '../../../vitest.base.config';
8
9
 
9
- // TODO(wittjosiah): Factor out to shared config as an option.
10
- const specifiedEnv = (process.env.VITEST_ENV ?? 'node').toLowerCase();
11
- const environment = specifiedEnv === 'node' ? 'jsdom' : undefined;
12
-
13
- export default mergeConfig(
14
- baseConfig({ cwd: __dirname }),
15
- defineConfig({
16
- test: {
17
- environment,
18
- // TODO(dmaretskyi): Enabled because client tests were flaky. Remove when that's not the case.
19
- retry: 2,
20
- },
21
- }),
22
- );
10
+ export default createConfig({
11
+ dirname: typeof __dirname !== 'undefined' ? __dirname : path.dirname(fileURLToPath(import.meta.url)),
12
+ node: {
13
+ environment: 'happy-dom',
14
+ },
15
+ storybook: true,
16
+ });
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../../../src/invitations/index.ts", "../../../src/invitations/useInvitationStatus.ts"],
4
- "sourcesContent": ["//\n// Copyright 2020 DXOS.org\n//\n\n// NOTE: Export * fails here.\nexport {\n AuthenticatingInvitationObservable,\n CancellableInvitationObservable,\n InvitationEncoder,\n Invitation,\n type Invitations,\n InvitationsProxy,\n} from '@dxos/client/invitations';\n\nexport * from './useInvitationStatus';\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { type Reducer, useCallback, useEffect, useMemo, useReducer } from 'react';\n\nimport { type PublicKey } from '@dxos/client';\nimport {\n type AuthenticatingInvitationObservable,\n type CancellableInvitationObservable,\n Invitation,\n InvitationEncoder,\n} from '@dxos/client/invitations';\nimport { log } from '@dxos/log';\n\nexport type InvitationResult = {\n spaceKey: PublicKey | null;\n identityKey: PublicKey | null;\n swarmKey: PublicKey | null;\n target: string | null;\n};\n\ninterface InvitationReducerState {\n status: Invitation.State; // TODO(burdon): Rename state.\n haltedAt?: Invitation.State;\n result: InvitationResult;\n error?: number;\n id?: string;\n multiUse?: boolean;\n invitationCode?: string;\n authCode?: string;\n authMethod?: Invitation.AuthMethod;\n type?: Invitation.Type;\n}\n\ntype InvitationPayload = { invitation: Invitation };\n\nexport type InvitationAction =\n | ({\n status:\n | Invitation.State.INIT\n | Invitation.State.CONNECTED\n | Invitation.State.READY_FOR_AUTHENTICATION\n | Invitation.State.AUTHENTICATING;\n } & InvitationPayload)\n | ({\n status: Invitation.State.CONNECTING;\n observable: CancellableInvitationObservable;\n } & InvitationPayload)\n | ({\n status: Invitation.State.SUCCESS;\n result: InvitationResult;\n } & InvitationPayload)\n | ({\n status: Invitation.State.CANCELLED | Invitation.State.TIMEOUT;\n haltedAt: Invitation.State;\n } & InvitationPayload)\n | {\n status: Invitation.State.ERROR;\n error?: Error;\n haltedAt: Invitation.State;\n };\n\nexport type InvitationStatus = {\n id?: string;\n invitationCode?: string;\n authCode?: string;\n authMethod?: Invitation.AuthMethod;\n type?: Invitation.Type;\n status: Invitation.State;\n haltedAt?: Invitation.State;\n multiUse?: boolean;\n shareable?: boolean;\n result: InvitationResult;\n error?: number;\n cancel(): void;\n // TODO(wittjosiah): Remove?\n connect(observable: CancellableInvitationObservable): void;\n authenticate(authCode: string): Promise<void>;\n};\n\n// Without private key, the invitation code cannot be created.\n// These invitations are only available to be accepted but not shared.\nconst isShareableInvitation = (invitation: Invitation) =>\n invitation.authMethod !== Invitation.AuthMethod.KNOWN_PUBLIC_KEY || invitation.guestKeypair?.privateKey;\n\nexport const useInvitationStatus = (observable?: CancellableInvitationObservable): InvitationStatus => {\n const [state, dispatch] = useReducer<Reducer<InvitationReducerState, InvitationAction>, null>(\n (prev, action) => {\n log('useInvitationStatus', { action });\n const invitationProps =\n 'invitation' in action\n ? {\n id: action.invitation.invitationId,\n multiUse: action.invitation.multiUse,\n invitationCode: InvitationEncoder.encode(action.invitation),\n authCode: action.invitation.authCode,\n authMethod: action.invitation.authMethod,\n shareable: isShareableInvitation(action.invitation),\n type: action.invitation.type,\n }\n : {};\n return {\n ...prev,\n ...invitationProps,\n // TODO(burdon): State.\n status: action.status,\n // `invitationObservable`, `secret`, and `result` is persisted between the status-actions that set them.\n result: action.status === Invitation.State.SUCCESS ? action.result : prev.result,\n // `error` gets set each time we enter the error state\n ...(action.status === Invitation.State.ERROR && { error: action.error }),\n // `haltedAt` gets set on only the first error/cancelled/timeout action and reset on any others.\n ...((action.status === Invitation.State.ERROR ||\n action.status === Invitation.State.CANCELLED ||\n action.status === Invitation.State.TIMEOUT) && {\n haltedAt: typeof prev.haltedAt === 'undefined' ? action.haltedAt : prev.haltedAt,\n }),\n } as InvitationReducerState;\n },\n null,\n (_arg: null) => {\n const invitation = observable?.get();\n return {\n status: Invitation.State.INIT,\n result: { spaceKey: null, identityKey: null, swarmKey: null, target: null },\n id: invitation?.invitationId,\n multiUse: invitation?.multiUse,\n invitationCode: invitation ? InvitationEncoder.encode(invitation) : undefined,\n authCode: invitation?.authCode,\n authMethod: invitation?.authMethod,\n shareable: invitation ? isShareableInvitation(invitation) : false,\n type: invitation?.type,\n };\n },\n );\n\n // Handle unmount.\n\n useEffect(() => {\n const update = (invitation: Invitation) => {\n switch (invitation.state) {\n case Invitation.State.INIT:\n case Invitation.State.CONNECTED:\n case Invitation.State.READY_FOR_AUTHENTICATION:\n case Invitation.State.AUTHENTICATING: {\n dispatch({\n invitation,\n status: invitation.state,\n });\n break;\n }\n\n case Invitation.State.SUCCESS: {\n dispatch({\n invitation,\n status: invitation.state,\n result: {\n spaceKey: invitation.spaceKey || null,\n identityKey: invitation.identityKey || null,\n swarmKey: invitation.swarmKey || null,\n target: invitation.target || null,\n },\n });\n break;\n }\n\n case Invitation.State.CANCELLED:\n case Invitation.State.TIMEOUT: {\n dispatch({ invitation, status: invitation.state, haltedAt: state.status });\n break;\n }\n }\n };\n\n const subscription = observable?.subscribe(update, (err: Error) => {\n dispatch({ status: Invitation.State.ERROR, error: err, haltedAt: state.status });\n });\n\n const currentState = observable?.get();\n if (currentState) {\n update(currentState);\n }\n\n return () => subscription?.unsubscribe();\n }, [observable, state.status]);\n\n // Return memoized callbacks & values.\n\n const connect = useCallback((observable: CancellableInvitationObservable) => {\n dispatch({ invitation: observable.get(), status: Invitation.State.CONNECTING, observable });\n }, []);\n\n const authenticate = useCallback(\n (authCode: string) => {\n log('authenticating...', { authCode });\n return (observable as AuthenticatingInvitationObservable).authenticate(authCode);\n },\n [observable],\n );\n\n const cancel = useCallback(async () => observable?.cancel(), [observable]);\n\n return useMemo(() => {\n return {\n ...state,\n cancel,\n connect,\n authenticate,\n };\n }, [state, cancel, connect, authenticate]);\n};\n"],
5
- "mappings": "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",
6
- "names": ["AuthenticatingInvitationObservable", "CancellableInvitationObservable", "InvitationEncoder", "Invitation", "InvitationsProxy", "useCallback", "useEffect", "useMemo", "useReducer", "Invitation", "InvitationEncoder", "log", "isShareableInvitation", "invitation", "authMethod", "AuthMethod", "KNOWN_PUBLIC_KEY", "guestKeypair", "privateKey", "useInvitationStatus", "observable", "state", "dispatch", "prev", "action", "invitationProps", "id", "invitationId", "multiUse", "invitationCode", "encode", "authCode", "shareable", "type", "status", "result", "State", "SUCCESS", "ERROR", "error", "CANCELLED", "TIMEOUT", "haltedAt", "_arg", "get", "INIT", "spaceKey", "identityKey", "swarmKey", "target", "undefined", "update", "CONNECTED", "READY_FOR_AUTHENTICATION", "AUTHENTICATING", "subscription", "subscribe", "err", "currentState", "unsubscribe", "connect", "CONNECTING", "authenticate", "cancel"]
7
- }
@@ -1,312 +0,0 @@
1
- // src/client/AgentHostingProvider.tsx
2
- import React2, { createContext as createContext2, useContext as useContext4, useState as useState4 } from "react";
3
- import { AgentManagerClient, FakeAgentHostingProvider } from "@dxos/client";
4
- import { log as log2 } from "@dxos/log";
5
-
6
- // src/client/ClientProvider.tsx
7
- import React, { forwardRef, useEffect, useImperativeHandle, useState } from "react";
8
- import { Client, SystemStatus } from "@dxos/client";
9
- import { registerSignalsRuntime } from "@dxos/echo-signals/react";
10
- import { log } from "@dxos/log";
11
- import { useControlledState } from "@dxos/react-hooks";
12
- import { getAsyncProviderValue } from "@dxos/util";
13
-
14
- // src/banner.ts
15
- var BANNER = (client) => {
16
- const commitHash = client.config.get("runtime.app.build.commitHash");
17
- const hash = commitHash ? ` App Commit ${commitHash}
18
- ` : "";
19
- return `
20
- _/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\______/\\/\\/\\/\\/\\_
21
- _/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__/\\/\\_________
22
- _/\\/\\____/\\/\\______/\\/\\______/\\/\\____/\\/\\____/\\/\\/\\/\\___
23
- _/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__________/\\/\\_
24
- _/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\/\\/\\/\\___
25
-
26
- DXOS Client ${client.version}
27
- ${hash}`;
28
- };
29
- var bannerPrinted = false;
30
- var printBanner = (client) => {
31
- if (bannerPrinted || window.location.hostname === "localhost") {
32
- return;
33
- }
34
- bannerPrinted = true;
35
- console.log(`%c${BANNER(client)}`, "font-family: monospace;");
36
- };
37
-
38
- // src/client/context.ts
39
- import { createContext } from "react";
40
- var ClientContext = createContext(void 0);
41
-
42
- // src/client/ClientProvider.tsx
43
- var __dxlog_file = "/__w/dxos/dxos/packages/sdk/react-client/src/client/ClientProvider.tsx";
44
- var ClientProvider = /* @__PURE__ */ forwardRef(({ children, config: configProvider, client: clientProvider, services: servicesProvider, status: controlledStatus, fallback: Fallback = () => null, signalsRuntime = true, noBanner, onInitialized, ...options }, forwardedRef) => {
45
- useEffect(() => {
46
- signalsRuntime && registerSignalsRuntime();
47
- }, []);
48
- const [error, setError] = useState();
49
- if (error) {
50
- throw error;
51
- }
52
- const [client, setClient] = useState(clientProvider instanceof Client ? clientProvider : void 0);
53
- useImperativeHandle(forwardedRef, () => client, [
54
- client
55
- ]);
56
- const [status, setStatus] = useControlledState(controlledStatus);
57
- useEffect(() => {
58
- if (!client) {
59
- return;
60
- }
61
- const subscription = client.status.subscribe((status2) => setStatus(status2));
62
- return () => subscription.unsubscribe();
63
- }, [
64
- client
65
- ]);
66
- useEffect(() => {
67
- let disposed = false;
68
- const initialize = async (client3) => {
69
- if (!client3.initialized) {
70
- await client3.initialize().catch((err) => {
71
- if (!disposed) {
72
- setError(err);
73
- }
74
- });
75
- log("client ready", void 0, {
76
- F: __dxlog_file,
77
- L: 138,
78
- S: void 0,
79
- C: (f, a) => f(...a)
80
- });
81
- await onInitialized?.(client3);
82
- log("initialization complete", void 0, {
83
- F: __dxlog_file,
84
- L: 140,
85
- S: void 0,
86
- C: (f, a) => f(...a)
87
- });
88
- }
89
- setClient(client3);
90
- if (!noBanner) {
91
- printBanner(client3);
92
- }
93
- };
94
- let client2;
95
- const t = setTimeout(async () => {
96
- try {
97
- if (clientProvider) {
98
- client2 = await getAsyncProviderValue(clientProvider);
99
- await initialize(client2);
100
- } else {
101
- const config = await getAsyncProviderValue(configProvider);
102
- log("resolved config", {
103
- config
104
- }, {
105
- F: __dxlog_file,
106
- L: 160,
107
- S: void 0,
108
- C: (f, a) => f(...a)
109
- });
110
- const services = await getAsyncProviderValue(servicesProvider, config);
111
- log("created services", {
112
- services
113
- }, {
114
- F: __dxlog_file,
115
- L: 162,
116
- S: void 0,
117
- C: (f, a) => f(...a)
118
- });
119
- client2 = new Client({
120
- config,
121
- services,
122
- ...options
123
- });
124
- log("created client", void 0, {
125
- F: __dxlog_file,
126
- L: 164,
127
- S: void 0,
128
- C: (f, a) => f(...a)
129
- });
130
- await initialize(client2);
131
- }
132
- } catch (err) {
133
- if (!disposed) {
134
- log.catch(err, void 0, {
135
- F: __dxlog_file,
136
- L: 169,
137
- S: void 0,
138
- C: (f, a) => f(...a)
139
- });
140
- }
141
- }
142
- });
143
- return () => {
144
- log("clean up", void 0, {
145
- F: __dxlog_file,
146
- L: 175,
147
- S: void 0,
148
- C: (f, a) => f(...a)
149
- });
150
- disposed = true;
151
- clearTimeout(t);
152
- if (!clientProvider) {
153
- void client2?.destroy().then(() => {
154
- log("destroyed", void 0, {
155
- F: __dxlog_file,
156
- L: 183,
157
- S: void 0,
158
- C: (f, a) => f(...a)
159
- });
160
- }).catch((err) => log.catch(err, void 0, {
161
- F: __dxlog_file,
162
- L: 185,
163
- S: void 0,
164
- C: (f, a) => f(...a)
165
- }));
166
- }
167
- };
168
- }, [
169
- configProvider,
170
- clientProvider,
171
- servicesProvider,
172
- noBanner
173
- ]);
174
- if (!client?.initialized || status !== SystemStatus.ACTIVE) {
175
- return /* @__PURE__ */ React.createElement(Fallback, {
176
- client,
177
- status
178
- });
179
- }
180
- return /* @__PURE__ */ React.createElement(ClientContext.Provider, {
181
- value: {
182
- client,
183
- status
184
- }
185
- }, children);
186
- });
187
-
188
- // src/client/useClient.ts
189
- import { useContext } from "react";
190
- import { raise } from "@dxos/debug";
191
- var useClient = () => {
192
- const { client } = useContext(ClientContext) ?? raise(new Error("Missing ClientContext."));
193
- return client;
194
- };
195
-
196
- // src/client/useClientStatus.ts
197
- import { useEffect as useEffect2, useState as useState2 } from "react";
198
- var useClientStatus = (client) => {
199
- const [status, setStatus] = useState2();
200
- useEffect2(() => {
201
- if (!client) {
202
- return;
203
- }
204
- const subscription = client.status.subscribe((status2) => setStatus(status2));
205
- return () => subscription.unsubscribe();
206
- }, [
207
- client,
208
- setStatus
209
- ]);
210
- return status;
211
- };
212
-
213
- // src/client/useConfig.ts
214
- import { useContext as useContext2 } from "react";
215
- import { raise as raise2 } from "@dxos/debug";
216
- var useConfig = () => {
217
- const { client } = useContext2(ClientContext) ?? raise2(new Error("Missing ClientContext."));
218
- return client.config;
219
- };
220
-
221
- // src/client/useShell.ts
222
- import { useEffect as useEffect3, useState as useState3 } from "react";
223
- var useShell = () => {
224
- const client = useClient();
225
- return client.shell;
226
- };
227
- var useShellDisplay = () => {
228
- const client = useClient();
229
- const [display, setDisplay] = useState3(client.shell.display);
230
- useEffect3(() => client.shell.onDisplayChange(setDisplay), [
231
- client
232
- ]);
233
- return display;
234
- };
235
-
236
- // src/client/useStatus.ts
237
- import { useContext as useContext3 } from "react";
238
- import { raise as raise3 } from "@dxos/debug";
239
- var useStatus = () => {
240
- const { status } = useContext3(ClientContext) ?? raise3(new Error("Missing ClientContext."));
241
- return status;
242
- };
243
-
244
- // src/client/AgentHostingProvider.tsx
245
- var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/react-client/src/client/AgentHostingProvider.tsx";
246
- var AgentHostingContext = /* @__PURE__ */ createContext2(null);
247
- var AgentHostingProvider = (props) => {
248
- const client = useClient();
249
- const [agentHostingProviderClient] = useState4(makeClient(client));
250
- return /* @__PURE__ */ React2.createElement(AgentHostingContext.Provider, {
251
- value: agentHostingProviderClient
252
- }, " ", props.children);
253
- };
254
- var useAgentHostingClient = () => {
255
- return useContext4(AgentHostingContext);
256
- };
257
- var makeClient = ({ config, halo }) => {
258
- const agentHostingConfig = config.get("runtime.services.agentHosting");
259
- if (!agentHostingConfig) {
260
- log2("no agent hosting configured", void 0, {
261
- F: __dxlog_file2,
262
- L: 39,
263
- S: void 0,
264
- C: (f, a) => f(...a)
265
- });
266
- return null;
267
- }
268
- let agentHostingProviderClient = null;
269
- switch (agentHostingConfig.type) {
270
- case "LOCAL_TESTING": {
271
- log2("using FakeAgentHostingProvider", void 0, {
272
- F: __dxlog_file2,
273
- L: 47,
274
- S: void 0,
275
- C: (f, a) => f(...a)
276
- });
277
- return new FakeAgentHostingProvider();
278
- }
279
- case "AGENTHOSTING_API": {
280
- agentHostingProviderClient = new AgentManagerClient(config, halo);
281
- if (agentHostingProviderClient.init()) {
282
- return agentHostingProviderClient;
283
- } else {
284
- return null;
285
- }
286
- }
287
- default: {
288
- log2.error("Unknown agent hosting provider type: " + agentHostingConfig.type, void 0, {
289
- F: __dxlog_file2,
290
- L: 62,
291
- S: void 0,
292
- C: (f, a) => f(...a)
293
- });
294
- return null;
295
- }
296
- }
297
- };
298
-
299
- export {
300
- AgentHostingContext,
301
- AgentHostingProvider,
302
- useAgentHostingClient,
303
- ClientContext,
304
- ClientProvider,
305
- useClient,
306
- useClientStatus,
307
- useConfig,
308
- useShell,
309
- useShellDisplay,
310
- useStatus
311
- };
312
- //# sourceMappingURL=chunk-FQAPI3I4.mjs.map