@dxos/react-client 0.8.4-main.3a94e84 → 0.8.4-main.3c1ae3b

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 (97) hide show
  1. package/.storybook/main.mts +11 -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-O5SEVDJG.mjs → chunk-LO3TU5CK.mjs} +5 -5
  5. package/dist/lib/browser/chunk-LO3TU5CK.mjs.map +7 -0
  6. package/dist/lib/browser/{chunk-AAR7V3KL.mjs → chunk-TA2HGRAF.mjs} +64 -67
  7. package/dist/lib/browser/chunk-TA2HGRAF.mjs.map +7 -0
  8. package/dist/lib/browser/devtools/index.mjs +2 -2
  9. package/dist/lib/browser/devtools/index.mjs.map +3 -3
  10. package/dist/lib/browser/echo/index.mjs +29 -33
  11. package/dist/lib/browser/echo/index.mjs.map +3 -3
  12. package/dist/lib/browser/halo/index.mjs +4 -3
  13. package/dist/lib/browser/halo/index.mjs.map +3 -3
  14. package/dist/lib/browser/index.mjs +1 -1
  15. package/dist/lib/browser/invitations/index.mjs +1 -1
  16. package/dist/lib/browser/mesh/index.mjs +1 -1
  17. package/dist/lib/browser/meta.json +1 -1
  18. package/dist/lib/browser/testing/index.mjs +51 -50
  19. package/dist/lib/browser/testing/index.mjs.map +3 -3
  20. package/dist/lib/node-esm/{chunk-TU2JJLZK.mjs → chunk-AQJH2UNZ.mjs} +5 -5
  21. package/dist/lib/node-esm/chunk-AQJH2UNZ.mjs.map +7 -0
  22. package/dist/lib/node-esm/{chunk-ZTD6HPV2.mjs → chunk-ZJMNF7GC.mjs} +64 -67
  23. package/dist/lib/node-esm/chunk-ZJMNF7GC.mjs.map +7 -0
  24. package/dist/lib/node-esm/devtools/index.mjs +2 -2
  25. package/dist/lib/node-esm/devtools/index.mjs.map +3 -3
  26. package/dist/lib/node-esm/echo/index.mjs +29 -33
  27. package/dist/lib/node-esm/echo/index.mjs.map +3 -3
  28. package/dist/lib/node-esm/halo/index.mjs +4 -3
  29. package/dist/lib/node-esm/halo/index.mjs.map +3 -3
  30. package/dist/lib/node-esm/index.mjs +1 -1
  31. package/dist/lib/node-esm/invitations/index.mjs +1 -1
  32. package/dist/lib/node-esm/mesh/index.mjs +1 -1
  33. package/dist/lib/node-esm/meta.json +1 -1
  34. package/dist/lib/node-esm/testing/index.mjs +51 -50
  35. package/dist/lib/node-esm/testing/index.mjs.map +3 -3
  36. package/dist/types/src/client/AgentHostingProvider.d.ts.map +1 -1
  37. package/dist/types/src/client/ClientProvider.d.ts.map +1 -1
  38. package/dist/types/src/echo/useQuery.d.ts +3 -3
  39. package/dist/types/src/echo/useQuery.d.ts.map +1 -1
  40. package/dist/types/src/echo/useQueue.d.ts +2 -2
  41. package/dist/types/src/echo/useQueue.d.ts.map +1 -1
  42. package/dist/types/src/echo/useSchema.d.ts +2 -3
  43. package/dist/types/src/echo/useSchema.d.ts.map +1 -1
  44. package/dist/types/src/echo/useSpaceInvitations.d.ts.map +1 -1
  45. package/dist/types/src/echo/useSpaces.d.ts.map +1 -1
  46. package/dist/types/src/echo/useSubscription.d.ts +1 -1
  47. package/dist/types/src/echo/useSubscription.d.ts.map +1 -1
  48. package/dist/types/src/echo/useSyncState.d.ts +1 -1
  49. package/dist/types/src/echo/useSyncState.d.ts.map +1 -1
  50. package/dist/types/src/halo/Passkey.stories.d.ts +5 -5
  51. package/dist/types/src/halo/Passkey.stories.d.ts.map +1 -1
  52. package/dist/types/src/halo/useHaloInvitations.d.ts.map +1 -1
  53. package/dist/types/src/invitations/useInvitationStatus.d.ts +1 -1
  54. package/dist/types/src/invitations/useInvitationStatus.d.ts.map +1 -1
  55. package/dist/types/src/testing/ClientRepeater.d.ts +2 -2
  56. package/dist/types/src/testing/ClientRepeater.d.ts.map +1 -1
  57. package/dist/types/src/testing/ClientRepeater.stories.d.ts +6 -10
  58. package/dist/types/src/testing/ClientRepeater.stories.d.ts.map +1 -1
  59. package/dist/types/src/testing/context.d.ts +3 -0
  60. package/dist/types/src/testing/context.d.ts.map +1 -1
  61. package/dist/types/src/testing/withClientProvider.d.ts +6 -7
  62. package/dist/types/src/testing/withClientProvider.d.ts.map +1 -1
  63. package/dist/types/src/testing/withClientProvider.stories.d.ts +7 -9
  64. package/dist/types/src/testing/withClientProvider.stories.d.ts.map +1 -1
  65. package/dist/types/tsconfig.tsbuildinfo +1 -1
  66. package/moon.yml +4 -0
  67. package/package.json +38 -31
  68. package/src/client/AgentHostingProvider.tsx +1 -1
  69. package/src/client/ClientProvider.test.tsx +3 -2
  70. package/src/client/ClientProvider.tsx +33 -36
  71. package/src/client/useConfig.test.tsx +2 -1
  72. package/src/devtools/useStream.ts +1 -1
  73. package/src/echo/useQuery.test.tsx +11 -10
  74. package/src/echo/useQuery.ts +24 -15
  75. package/src/echo/useQueue.ts +2 -2
  76. package/src/echo/useSchema.ts +8 -19
  77. package/src/echo/useSpaceInvitations.ts +2 -1
  78. package/src/echo/useSpaces.test.tsx +2 -1
  79. package/src/echo/useSpaces.ts +5 -9
  80. package/src/echo/useSubscription.ts +1 -1
  81. package/src/echo/useSyncState.ts +1 -1
  82. package/src/halo/Passkey.stories.tsx +16 -13
  83. package/src/halo/useDevices.test.tsx +2 -1
  84. package/src/halo/useHaloInvitations.ts +1 -1
  85. package/src/invitations/useInvitationStatus.ts +9 -8
  86. package/src/testing/ClientRepeater.stories.tsx +12 -8
  87. package/src/testing/ClientRepeater.tsx +23 -27
  88. package/src/testing/context.tsx +3 -0
  89. package/src/testing/withClientProvider.stories.tsx +25 -16
  90. package/src/testing/withClientProvider.tsx +24 -21
  91. package/tsconfig.json +0 -3
  92. package/vitest.config.ts +12 -16
  93. package/.swc/plugins/v7_linux_x86_64_13.0.0/f45bdff002284d9e8f9ef3f0be909de12da36c049cbcf261ac78fc00abb09a2d +0 -0
  94. package/dist/lib/browser/chunk-AAR7V3KL.mjs.map +0 -7
  95. package/dist/lib/browser/chunk-O5SEVDJG.mjs.map +0 -7
  96. package/dist/lib/node-esm/chunk-TU2JJLZK.mjs.map +0 -7
  97. package/dist/lib/node-esm/chunk-ZTD6HPV2.mjs.map +0 -7
package/moon.yml CHANGED
@@ -6,6 +6,7 @@ tags:
6
6
  - ts-test
7
7
  - typedoc
8
8
  - pack
9
+ - storybook
9
10
  tasks:
10
11
  compile:
11
12
  args:
@@ -17,3 +18,6 @@ tasks:
17
18
  - '--entryPoint=src/mesh/index.ts'
18
19
  - '--entryPoint=src/testing/index.ts'
19
20
  - '--entryPoint=src/worker.ts'
21
+ test:
22
+ inputs:
23
+ - .storybook/*
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dxos/react-client",
3
- "version": "0.8.4-main.3a94e84",
3
+ "version": "0.8.4-main.3c1ae3b",
4
4
  "description": "React client API",
5
5
  "homepage": "https://dxos.org",
6
6
  "bugs": "https://github.com/dxos/dxos/issues",
@@ -10,41 +10,49 @@
10
10
  "type": "module",
11
11
  "exports": {
12
12
  "./devtools": {
13
+ "source": "./src/devtools/index.ts",
13
14
  "types": "./dist/types/src/devtools/index.d.ts",
14
15
  "browser": "./dist/lib/browser/devtools/index.mjs",
15
16
  "node": "./dist/lib/node-esm/devtools/index.mjs"
16
17
  },
17
18
  "./echo": {
19
+ "source": "./src/echo/index.ts",
18
20
  "types": "./dist/types/src/echo/index.d.ts",
19
21
  "browser": "./dist/lib/browser/echo/index.mjs",
20
22
  "node": "./dist/lib/node-esm/echo/index.mjs"
21
23
  },
22
24
  "./halo": {
25
+ "source": "./src/halo/index.ts",
23
26
  "types": "./dist/types/src/halo/index.d.ts",
24
27
  "browser": "./dist/lib/browser/halo/index.mjs",
25
28
  "node": "./dist/lib/node-esm/halo/index.mjs"
26
29
  },
27
30
  ".": {
31
+ "source": "./src/index.ts",
28
32
  "types": "./dist/types/src/index.d.ts",
29
33
  "browser": "./dist/lib/browser/index.mjs",
30
34
  "node": "./dist/lib/node-esm/index.mjs"
31
35
  },
32
36
  "./invitations": {
37
+ "source": "./src/invitations/index.ts",
33
38
  "types": "./dist/types/src/invitations/index.d.ts",
34
39
  "browser": "./dist/lib/browser/invitations/index.mjs",
35
40
  "node": "./dist/lib/node-esm/invitations/index.mjs"
36
41
  },
37
42
  "./mesh": {
43
+ "source": "./src/mesh/index.ts",
38
44
  "types": "./dist/types/src/mesh/index.d.ts",
39
45
  "browser": "./dist/lib/browser/mesh/index.mjs",
40
46
  "node": "./dist/lib/node-esm/mesh/index.mjs"
41
47
  },
42
48
  "./testing": {
49
+ "source": "./src/testing/index.ts",
43
50
  "types": "./dist/types/src/testing/index.d.ts",
44
51
  "browser": "./dist/lib/browser/testing/index.mjs",
45
52
  "node": "./dist/lib/node-esm/testing/index.mjs"
46
53
  },
47
54
  "./worker": {
55
+ "source": "./src/worker.ts",
48
56
  "types": "./dist/types/src/worker.d.ts",
49
57
  "browser": "./dist/lib/browser/worker.mjs",
50
58
  "node": "./dist/lib/node-esm/worker.mjs"
@@ -78,43 +86,42 @@
78
86
  },
79
87
  "dependencies": {
80
88
  "react-error-boundary": "^4.0.13",
81
- "@dxos/async": "0.8.4-main.3a94e84",
82
- "@dxos/client": "0.8.4-main.3a94e84",
83
- "@dxos/codec-protobuf": "0.8.4-main.3a94e84",
84
- "@dxos/config": "0.8.4-main.3a94e84",
85
- "@dxos/context": "0.8.4-main.3a94e84",
86
- "@dxos/echo": "0.8.4-main.3a94e84",
87
- "@dxos/invariant": "0.8.4-main.3a94e84",
88
- "@dxos/debug": "0.8.4-main.3a94e84",
89
- "@dxos/echo-signals": "0.8.4-main.3a94e84",
90
- "@dxos/echo-schema": "0.8.4-main.3a94e84",
91
- "@dxos/log": "0.8.4-main.3a94e84",
92
- "@dxos/node-std": "0.8.4-main.3a94e84",
93
- "@dxos/react-hooks": "0.8.4-main.3a94e84",
94
- "@dxos/util": "0.8.4-main.3a94e84",
95
- "@dxos/protocols": "0.8.4-main.3a94e84"
89
+ "@dxos/async": "0.8.4-main.3c1ae3b",
90
+ "@dxos/client": "0.8.4-main.3c1ae3b",
91
+ "@dxos/codec-protobuf": "0.8.4-main.3c1ae3b",
92
+ "@dxos/debug": "0.8.4-main.3c1ae3b",
93
+ "@dxos/config": "0.8.4-main.3c1ae3b",
94
+ "@dxos/context": "0.8.4-main.3c1ae3b",
95
+ "@dxos/invariant": "0.8.4-main.3c1ae3b",
96
+ "@dxos/log": "0.8.4-main.3c1ae3b",
97
+ "@dxos/echo-signals": "0.8.4-main.3c1ae3b",
98
+ "@dxos/echo": "0.8.4-main.3c1ae3b",
99
+ "@dxos/protocols": "0.8.4-main.3c1ae3b",
100
+ "@dxos/react-hooks": "0.8.4-main.3c1ae3b",
101
+ "@dxos/node-std": "0.8.4-main.3c1ae3b",
102
+ "@dxos/util": "0.8.4-main.3c1ae3b"
96
103
  },
97
104
  "devDependencies": {
98
- "@types/react": "~18.2.0",
99
- "@types/react-dom": "~18.2.0",
100
- "react": "~18.2.0",
101
- "react-dom": "~18.2.0",
105
+ "@types/react": "~19.2.2",
106
+ "@types/react-dom": "~19.2.2",
107
+ "react": "~19.2.0",
108
+ "react-dom": "~19.2.0",
102
109
  "typedoc": "0.28.1",
103
- "@dxos/random": "0.8.4-main.3a94e84",
104
- "@dxos/react-ui": "0.8.4-main.3a94e84",
105
- "@dxos/react-ui-syntax-highlighter": "0.8.4-main.3a94e84",
106
- "@dxos/react-ui-theme": "0.8.4-main.3a94e84",
107
- "@dxos/storybook-utils": "0.8.4-main.3a94e84",
108
- "@dxos/test-utils": "0.8.4-main.3a94e84"
110
+ "@dxos/random": "0.8.4-main.3c1ae3b",
111
+ "@dxos/react-ui-syntax-highlighter": "0.8.4-main.3c1ae3b",
112
+ "@dxos/storybook-utils": "0.8.4-main.3c1ae3b",
113
+ "@dxos/react-ui": "0.8.4-main.3c1ae3b",
114
+ "@dxos/test-utils": "0.8.4-main.3c1ae3b",
115
+ "@dxos/react-ui-theme": "0.8.4-main.3c1ae3b"
109
116
  },
110
117
  "peerDependencies": {
111
- "react": "~18.2.0",
112
- "react-dom": "~18.2.0"
118
+ "react": "^19.0.0",
119
+ "react-dom": "^19.0.0"
113
120
  },
114
121
  "optionalDependencies": {
115
- "@dxos/random": "0.8.4-main.3a94e84",
116
- "@dxos/react-ui": "0.8.4-main.3a94e84",
117
- "@dxos/react-ui-theme": "0.8.4-main.3a94e84"
122
+ "@dxos/react-ui": "0.8.4-main.3c1ae3b",
123
+ "@dxos/react-ui-theme": "0.8.4-main.3c1ae3b",
124
+ "@dxos/random": "0.8.4-main.3c1ae3b"
118
125
  },
119
126
  "publishConfig": {
120
127
  "access": "public"
@@ -2,7 +2,7 @@
2
2
  // Copyright 2023 DXOS.org
3
3
  //
4
4
 
5
- import React, { createContext, type PropsWithChildren, useContext, useState } from 'react';
5
+ import React, { type PropsWithChildren, createContext, useContext, useState } from 'react';
6
6
 
7
7
  import { type AgentHostingProviderClient, AgentManagerClient, FakeAgentHostingProvider } from '@dxos/client';
8
8
  import { type Halo } from '@dxos/client/halo';
@@ -2,7 +2,7 @@
2
2
  // Copyright 2020 DXOS.org
3
3
  //
4
4
 
5
- import { renderHook, screen, render, act, cleanup } from '@testing-library/react';
5
+ import { act, cleanup, render, renderHook, screen } from '@testing-library/react';
6
6
  import React, { Component, type PropsWithChildren } from 'react';
7
7
  import { afterEach, beforeEach, describe, expect, test } from 'vitest';
8
8
 
@@ -10,9 +10,10 @@ import { waitForCondition } from '@dxos/async';
10
10
  import { Client, Config, SystemStatus, fromHost } from '@dxos/client';
11
11
  import { log } from '@dxos/log';
12
12
 
13
+ import { useIdentity } from '../halo';
14
+
13
15
  import { ClientProvider } from './ClientProvider';
14
16
  import { useClient } from './useClient';
15
- import { useIdentity } from '../halo';
16
17
 
17
18
  log.config({ filter: 'ClientContext:debug,warn' });
18
19
 
@@ -3,9 +3,9 @@
3
3
  //
4
4
 
5
5
  import React, {
6
- forwardRef,
7
6
  type FunctionComponent,
8
7
  type PropsWithChildren,
8
+ forwardRef,
9
9
  useEffect,
10
10
  useImperativeHandle,
11
11
  useState,
@@ -15,12 +15,13 @@ import { Client, type ClientOptions, type ClientServicesProvider, SystemStatus }
15
15
  import { type Config } from '@dxos/config';
16
16
  import { registerSignalsRuntime } from '@dxos/echo-signals/react';
17
17
  import { log } from '@dxos/log';
18
- import { useControlledState } from '@dxos/react-hooks';
19
- import { getAsyncProviderValue, type MaybePromise, type Provider } from '@dxos/util';
18
+ import { useAsyncEffect, useControlledState } from '@dxos/react-hooks';
19
+ import { type MaybePromise, type Provider, getAsyncProviderValue } from '@dxos/util';
20
20
 
21
- import { ClientContext, type ClientContextProps } from './context';
22
21
  import { printBanner } from '../banner';
23
22
 
23
+ import { ClientContext, type ClientContextProps } from './context';
24
+
24
25
  /**
25
26
  * Properties for the ClientProvider.
26
27
  */
@@ -80,10 +81,10 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
80
81
  (
81
82
  {
82
83
  children,
83
- config: configProvider,
84
- client: clientProvider,
85
- services: servicesProvider,
86
- status: controlledStatus,
84
+ config: configParam,
85
+ client: clientParam,
86
+ services: servicesParam,
87
+ status: statusParam,
87
88
  fallback: Fallback = () => null,
88
89
  signalsRuntime = true,
89
90
  noBanner,
@@ -108,13 +109,13 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
108
109
  throw error;
109
110
  }
110
111
 
111
- const [client, setClient] = useState(clientProvider instanceof Client ? clientProvider : undefined);
112
+ const [client, setClient] = useState(clientParam instanceof Client ? clientParam : undefined);
112
113
 
113
114
  // Provide external access.
114
115
  useImperativeHandle(forwardedRef, () => client, [client]);
115
116
 
116
117
  // Client status subscription.
117
- const [status, setStatus] = useControlledState(controlledStatus);
118
+ const [status, setStatus] = useControlledState(statusParam);
118
119
  useEffect(() => {
119
120
  if (!client) {
120
121
  return;
@@ -125,7 +126,7 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
125
126
  }, [client]);
126
127
 
127
128
  // Create and/or initialize client.
128
- useEffect(() => {
129
+ useAsyncEffect(async () => {
129
130
  let disposed = false;
130
131
  const initialize = async (client: Client) => {
131
132
  if (!client.initialized) {
@@ -140,42 +141,38 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
140
141
  }
141
142
 
142
143
  setClient(client);
143
-
144
144
  if (!noBanner) {
145
145
  printBanner(client);
146
146
  }
147
147
  };
148
148
 
149
149
  let client: Client;
150
- const t = setTimeout(async () => {
151
- try {
152
- if (clientProvider) {
153
- // Asynchronously request client.
154
- client = await getAsyncProviderValue(clientProvider);
155
- await initialize(client);
156
- } else {
157
- // Asynchronously construct client (config may be undefined).
158
- const config = await getAsyncProviderValue(configProvider);
159
- log('resolved config', { config });
160
- const services = await getAsyncProviderValue(servicesProvider, config);
161
- log('created services', { services });
162
- client = new Client({ config, services, ...options });
163
- log('created client');
164
- await initialize(client);
165
- }
166
- } catch (err) {
167
- if (!disposed) {
168
- log.catch(err);
169
- }
150
+ try {
151
+ if (clientParam) {
152
+ // Asynchronously request client.
153
+ client = await getAsyncProviderValue(clientParam);
154
+ await initialize(client);
155
+ } else {
156
+ // Asynchronously construct client (config may be undefined).
157
+ const config = await getAsyncProviderValue(configParam);
158
+ log('resolved config', { config });
159
+ const services = await getAsyncProviderValue(servicesParam, config);
160
+ log('created services', { services });
161
+ client = new Client({ config, services, ...options });
162
+ log('created client');
163
+ await initialize(client);
170
164
  }
171
- });
165
+ } catch (err) {
166
+ if (!disposed) {
167
+ log.catch(err);
168
+ }
169
+ }
172
170
 
173
171
  return () => {
174
172
  log('clean up');
175
173
  disposed = true;
176
- clearTimeout(t);
177
174
  // Only destroy if the client is not provided by the parent.
178
- if (!clientProvider) {
175
+ if (!clientParam) {
179
176
  void client
180
177
  ?.destroy()
181
178
  .then(() => {
@@ -184,7 +181,7 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
184
181
  .catch((err) => log.catch(err));
185
182
  }
186
183
  };
187
- }, [configProvider, clientProvider, servicesProvider, noBanner]);
184
+ }, [configParam, clientParam, servicesParam, noBanner]);
188
185
 
189
186
  if (!client?.initialized || status !== SystemStatus.ACTIVE) {
190
187
  return <Fallback client={client} status={status} />;
@@ -8,9 +8,10 @@ import { describe, expect, test } from 'vitest';
8
8
  import { waitForCondition } from '@dxos/async';
9
9
  import { Config, SystemStatus } from '@dxos/client';
10
10
 
11
- import { useConfig } from './useConfig';
12
11
  import { createClient, createClientContextProvider } from '../testing/util';
13
12
 
13
+ import { useConfig } from './useConfig';
14
+
14
15
  // TODO(burdon): Disabled in CI since flaky.
15
16
  describe.runIf(!process.env.CI)('Config hook', () => {
16
17
  const render = () => useConfig();
@@ -2,7 +2,7 @@
2
2
  // Copyright 2021 DXOS.org
3
3
  //
4
4
 
5
- import { type DependencyList, useState, useEffect } from 'react';
5
+ import { type DependencyList, useEffect, useState } from 'react';
6
6
 
7
7
  import { type Stream } from '@dxos/codec-protobuf/stream';
8
8
  import { log } from '@dxos/log';
@@ -5,11 +5,13 @@
5
5
  import { renderHook } from '@testing-library/react';
6
6
  import { describe, expect, test } from 'vitest';
7
7
 
8
- import { Expando, Filter, live } from '@dxos/client/echo';
8
+ import { Filter } from '@dxos/client/echo';
9
+ import { Obj, Type } from '@dxos/echo';
9
10
 
10
- import { useQuery } from './useQuery';
11
11
  import { createClient, createClientContextProvider } from '../testing/util';
12
12
 
13
+ import { useQuery } from './useQuery';
14
+
13
15
  describe('useQuery', () => {
14
16
  // TODO(dmaretskyi): Fix this test.
15
17
  test.skip('deleting an element should result in correct render sequence', async () => {
@@ -18,9 +20,9 @@ describe('useQuery', () => {
18
20
  const wrapper = await createClientContextProvider(client);
19
21
 
20
22
  // Create 3 test objects: Alice, Bob, Charlie.
21
- const alice = live(Expando, { name: 'Alice' });
22
- const bob = live(Expando, { name: 'Bob' });
23
- const charlie = live(Expando, { name: 'Charlie' });
23
+ const alice = Obj.make(Type.Expando, { name: 'Alice' });
24
+ const bob = Obj.make(Type.Expando, { name: 'Bob' });
25
+ const charlie = Obj.make(Type.Expando, { name: 'Charlie' });
24
26
 
25
27
  space!.db.add(alice);
26
28
  space!.db.add(bob);
@@ -33,7 +35,7 @@ describe('useQuery', () => {
33
35
  // Setup useQuery hook that captures every render.
34
36
  renderHook(
35
37
  () => {
36
- const objects = useQuery(space, Filter.type(Expando));
38
+ const objects = useQuery(space, Filter.type(Type.Expando));
37
39
 
38
40
  // Capture the names in this render.
39
41
  const namesInThisRender = objects.map((obj) => obj.name);
@@ -64,7 +66,7 @@ describe('useQuery', () => {
64
66
  * Actual: 4 renders
65
67
  * 1. [] (empty)
66
68
  * 2. ['Alice', 'Bob', 'Charlie'] (all loaded)
67
- * 3. ['Alice', 'Charlie', 'Bob'] (FLASH BUG - Bob moves to end!)
69
+ * 3. ['Alice', 'Charlie', 'Bob'] (FLASH BUG - Bob moves to end!)x
68
70
  * 4. ['Alice', 'Charlie'] (Bob finally removed)
69
71
  */
70
72
 
@@ -81,7 +83,7 @@ describe('useQuery', () => {
81
83
  const wrapper = await createClientContextProvider(client);
82
84
 
83
85
  // Create 10 test objects: 1, 2, 3, ..., 10.
84
- const objects = Array.from({ length: 10 }, (_, i) => live(Expando, { value: i + 1 }));
86
+ const objects = Array.from({ length: 10 }, (_, i) => Obj.make(Type.Expando, { value: i + 1 }));
85
87
 
86
88
  objects.forEach((obj) => space!.db.add(obj));
87
89
  await space!.db.flush();
@@ -92,7 +94,7 @@ describe('useQuery', () => {
92
94
  // Setup useQuery hook that captures every render.
93
95
  renderHook(
94
96
  () => {
95
- const queryObjects = useQuery(space, Filter.type(Expando));
97
+ const queryObjects = useQuery(space, Filter.type(Type.Expando));
96
98
 
97
99
  // Capture the values in this render.
98
100
  const valuesInThisRender = queryObjects.map((obj) => obj.value);
@@ -121,7 +123,6 @@ describe('useQuery', () => {
121
123
  new Set([]), // Initial loading state.
122
124
  new Set([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]), // All objects loaded.
123
125
  // TODO(dmaretskyi): Fix this with query ordering.
124
- new Set([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]), // Getting another render for some reason.
125
126
  new Set([]), // All items deleted.
126
127
  ]);
127
128
  });
@@ -4,7 +4,8 @@
4
4
 
5
5
  import { useMemo, useSyncExternalStore } from 'react';
6
6
 
7
- import { type Echo, Filter, type Live, Query, type Space, isSpace } from '@dxos/client/echo';
7
+ import { type Database, type Echo, type Entity, Filter, Query, type Space, isSpace } from '@dxos/client/echo';
8
+ import { type AnyProperties } from '@dxos/echo/internal';
8
9
 
9
10
  const EMPTY_ARRAY: never[] = [];
10
11
 
@@ -12,32 +13,40 @@ const noop = () => {};
12
13
 
13
14
  // TODO(dmaretskyi): Queries are fully serializable, so we can remove `deps` argument.
14
15
  interface UseQueryFn {
15
- <Q extends Query.Any>(spaceOrEcho: Space | Echo | undefined, query: Q, deps?: any[]): Live<Query.Type<Q>>[];
16
+ <Q extends Query.Any, O extends Entity.Entity<Query.Type<Q>> = Entity.Entity<Query.Type<Q>>>(
17
+ spaceOrEcho: Space | Echo | Database.Queryable | undefined,
18
+ query: Q,
19
+ deps?: any[],
20
+ ): O[];
16
21
 
17
- <F extends Filter.Any>(spaceOrEcho: Space | Echo | undefined, filter: F, deps?: any[]): Live<Filter.Type<F>>[];
22
+ <F extends Filter.Any, O extends Entity.Entity<Filter.Type<F>> = Entity.Entity<Filter.Type<F>>>(
23
+ spaceOrEcho: Space | Echo | Database.Queryable | undefined,
24
+ filter: F,
25
+ deps?: any[],
26
+ ): O[];
18
27
  }
19
28
 
20
29
  /**
21
30
  * Create subscription.
22
31
  */
32
+ // TODO(burdon): Sort?
23
33
  export const useQuery: UseQueryFn = (
24
- spaceOrEcho: Space | Echo | undefined,
34
+ // TODO(burdon): CRITICAL: Remove Space and just requre Queryable.
35
+ resource: Space | Echo | Database.Queryable | undefined,
25
36
  queryOrFilter: Query.Any | Filter.Any,
26
37
  deps?: any[],
27
- ): Live<unknown>[] => {
38
+ ): Entity.Entity<AnyProperties>[] => {
28
39
  const query = Filter.is(queryOrFilter) ? Query.select(queryOrFilter) : queryOrFilter;
29
40
 
30
41
  const { getObjects, subscribe } = useMemo(() => {
31
- let subscribed = false;
32
- const queryResult =
33
- spaceOrEcho === undefined
34
- ? undefined
35
- : isSpace(spaceOrEcho)
36
- ? spaceOrEcho.db.query(query)
37
- : spaceOrEcho.query(query);
42
+ let queryResult = undefined;
43
+ if (resource) {
44
+ queryResult = isSpace(resource) ? resource.db.query(query) : resource.query(query);
45
+ }
38
46
 
47
+ let subscribed = false;
39
48
  return {
40
- getObjects: () => (subscribed && queryResult ? queryResult.objects : EMPTY_ARRAY),
49
+ getObjects: () => (subscribed && queryResult ? queryResult.results : EMPTY_ARRAY),
41
50
  subscribe: (cb: () => void) => {
42
51
  subscribed = true;
43
52
  const unsubscribe = queryResult?.subscribe(cb) ?? noop;
@@ -47,10 +56,10 @@ export const useQuery: UseQueryFn = (
47
56
  };
48
57
  },
49
58
  };
50
- }, [spaceOrEcho, JSON.stringify(query.ast), ...(deps ?? [])]);
59
+ }, [resource, JSON.stringify(query.ast), ...(deps ?? [])]);
51
60
 
52
61
  // https://beta.reactjs.org/reference/react/useSyncExternalStore
53
62
  // NOTE: This hook will resubscribe whenever the callback passed to the first argument changes; make sure it is stable.
54
- const objects = useSyncExternalStore<Live<unknown>[] | undefined>(subscribe, getObjects);
63
+ const objects = useSyncExternalStore<Entity.Entity<AnyProperties>[] | undefined>(subscribe, getObjects);
55
64
  return objects ?? [];
56
65
  };
@@ -6,7 +6,7 @@ import { useEffect, useMemo, useRef } from 'react';
6
6
 
7
7
  import { type Queue } from '@dxos/client/echo';
8
8
  import { raise } from '@dxos/debug';
9
- import { type Obj, type Relation } from '@dxos/echo';
9
+ import { type Entity } from '@dxos/echo';
10
10
  import { type DXN } from '@dxos/keys';
11
11
 
12
12
  import { useClient } from '../client';
@@ -24,7 +24,7 @@ export type UseQueueOptions = {
24
24
  // TODO(dmaretskyi): Move into client package.
25
25
  // TODO(dmaretskyi): Consider passing the space into the hook to support queue DXNs without space id.
26
26
  // TODO(ZaymonFC): If queue is unchanged returned object should be refferentially stable on poll.
27
- export const useQueue = <T extends Obj.Any | Relation.Any>(
27
+ export const useQueue = <T extends Entity.Unknown>(
28
28
  queueDxn?: DXN,
29
29
  options: UseQueueOptions = {},
30
30
  ): Queue<T> | undefined => {
@@ -2,21 +2,18 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- import { type Schema } from 'effect';
6
5
  import { useMemo, useSyncExternalStore } from 'react';
7
6
 
8
- import { type Client } from '@dxos/client';
9
7
  import { type Space } from '@dxos/client/echo';
10
- import { type BaseSchema } from '@dxos/echo-schema';
8
+ import { type Type } from '@dxos/echo';
11
9
 
12
10
  /**
13
11
  * Subscribe to and retrieve schema changes from a space's schema registry.
14
12
  */
15
- export const useSchema = (
16
- client: Client,
17
- space: Space | undefined,
18
- typename: string | undefined,
19
- ): Schema.Schema.AnyNoContext | undefined => {
13
+ export const useSchema = <T extends Type.Entity.Any = Type.Entity.Any>(
14
+ space?: Space,
15
+ typename?: string,
16
+ ): T | undefined => {
20
17
  const { subscribe, getSchema } = useMemo(() => {
21
18
  if (!typename || !space) {
22
19
  return {
@@ -25,16 +22,8 @@ export const useSchema = (
25
22
  };
26
23
  }
27
24
 
28
- const staticSchema = client.graph.schemaRegistry.getSchema(typename);
29
- if (staticSchema) {
30
- return {
31
- subscribe: () => () => {},
32
- getSchema: () => staticSchema,
33
- };
34
- }
35
-
36
- const query = space.db.schemaRegistry.query({ typename });
37
- const initialResult: BaseSchema = query.runSync()[0];
25
+ const query = space.db.schemaRegistry.query({ typename, location: ['database', 'runtime'] });
26
+ const initialResult = query.runSync()[0];
38
27
  let currentSchema = initialResult;
39
28
 
40
29
  return {
@@ -50,5 +39,5 @@ export const useSchema = (
50
39
  };
51
40
  }, [typename, space]);
52
41
 
53
- return useSyncExternalStore(subscribe, getSchema);
42
+ return useSyncExternalStore(subscribe, getSchema) as T;
54
43
  };
@@ -8,9 +8,10 @@ import { MulticastObservable } from '@dxos/async';
8
8
  import { type PublicKey } from '@dxos/client';
9
9
  import { useMulticastObservable } from '@dxos/react-hooks';
10
10
 
11
- import { useSpace } from './useSpaces';
12
11
  import { type CancellableInvitationObservable, useInvitationStatus } from '../invitations';
13
12
 
13
+ import { useSpace } from './useSpaces';
14
+
14
15
  export const useSpaceInvitations = (spaceKey?: PublicKey): CancellableInvitationObservable[] => {
15
16
  const space = useSpace(spaceKey);
16
17
  return useMulticastObservable(space?.invitations ?? MulticastObservable.empty()) ?? [];
@@ -5,9 +5,10 @@
5
5
  import { act, renderHook } from '@testing-library/react';
6
6
  import { describe, expect, test } from 'vitest';
7
7
 
8
- import { useSpace, useSpaces } from './useSpaces';
9
8
  import { createClient, createClientContextProvider } from '../testing/util';
10
9
 
10
+ import { useSpace, useSpaces } from './useSpaces';
11
+
11
12
  describe('useSpaces', () => {
12
13
  test('lists existing spaces', async () => {
13
14
  const { client } = await createClient({ createIdentity: true });
@@ -2,11 +2,11 @@
2
2
  // Copyright 2020 DXOS.org
3
3
  //
4
4
 
5
- import { useEffect, useState } from 'react';
5
+ import { useState } from 'react';
6
6
 
7
7
  import { type PublicKeyLike } from '@dxos/client';
8
8
  import { type Space, SpaceState } from '@dxos/client/echo';
9
- import { useMulticastObservable } from '@dxos/react-hooks';
9
+ import { useAsyncEffect, useMulticastObservable } from '@dxos/react-hooks';
10
10
 
11
11
  import { useClient } from '../client';
12
12
 
@@ -23,18 +23,14 @@ export const useSpace = (spaceKeyLike?: PublicKeyLike): Space | undefined => {
23
23
  const spaces = useMulticastObservable<Space[]>(client.spaces);
24
24
  const [ready, setReady] = useState(false);
25
25
 
26
- useEffect(() => {
26
+ useAsyncEffect(async () => {
27
27
  // Only wait for ready if looking for the default space.
28
28
  if (spaceKeyLike) {
29
29
  return;
30
30
  }
31
31
 
32
- const timeout = setTimeout(async () => {
33
- await client.spaces.waitUntilReady();
34
- setReady(true);
35
- });
36
-
37
- return () => clearTimeout(timeout);
32
+ await client.spaces.waitUntilReady();
33
+ setReady(true);
38
34
  }, [client, spaceKeyLike]);
39
35
 
40
36
  if (spaceKeyLike) {
@@ -18,7 +18,7 @@ export const useSubscription = (cb: () => void, selection: Selection) => {
18
18
  const callbackRef = useRef(cb);
19
19
  callbackRef.current = cb;
20
20
 
21
- const subscriptionRef = useRef<SubscriptionHandle>();
21
+ const subscriptionRef = useRef<SubscriptionHandle>(null);
22
22
 
23
23
  useEffect(() => {
24
24
  subscriptionRef.current = createSubscription(() => {
@@ -4,7 +4,7 @@
4
4
 
5
5
  import { useEffect, useState } from 'react';
6
6
 
7
- import { type PeerSyncState, type SpaceSyncStateMap, type Space } from '@dxos/client/echo';
7
+ import { type PeerSyncState, type Space, type SpaceSyncStateMap } from '@dxos/client/echo';
8
8
  import { Context } from '@dxos/context';
9
9
  import { type SpaceId } from '@dxos/keys';
10
10
  import { EdgeService } from '@dxos/protocols';