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

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 (134) hide show
  1. package/.storybook/main.mts +9 -0
  2. package/.storybook/preview.mts +8 -0
  3. package/dist/lib/browser/chunk-3LVU7RNK.mjs +16 -0
  4. package/dist/lib/browser/chunk-3LVU7RNK.mjs.map +7 -0
  5. package/dist/lib/browser/chunk-CZMIVAGI.mjs +8 -0
  6. package/dist/lib/browser/chunk-CZMIVAGI.mjs.map +7 -0
  7. package/dist/lib/browser/chunk-XT352YI6.mjs +134 -0
  8. package/dist/lib/browser/chunk-XT352YI6.mjs.map +7 -0
  9. package/dist/lib/browser/{chunk-BXOLJYAY.mjs → chunk-YHE6WD44.mjs} +4 -14
  10. package/dist/lib/browser/chunk-YHE6WD44.mjs.map +7 -0
  11. package/dist/lib/browser/devtools/index.mjs +3 -7
  12. package/dist/lib/browser/devtools/index.mjs.map +2 -2
  13. package/dist/lib/browser/echo/index.mjs +58 -127
  14. package/dist/lib/browser/echo/index.mjs.map +4 -4
  15. package/dist/lib/browser/halo/index.mjs +4 -4
  16. package/dist/lib/browser/halo/index.mjs.map +2 -2
  17. package/dist/lib/browser/index.mjs +99 -12
  18. package/dist/lib/browser/index.mjs.map +4 -4
  19. package/dist/lib/browser/invitations/index.mjs +1 -1
  20. package/dist/lib/browser/mesh/index.mjs +2 -1
  21. package/dist/lib/browser/mesh/index.mjs.map +1 -1
  22. package/dist/lib/browser/meta.json +1 -1
  23. package/dist/lib/browser/testing/index.mjs +111 -154
  24. package/dist/lib/browser/testing/index.mjs.map +3 -3
  25. package/dist/lib/node-esm/chunk-CUDKNAMV.mjs +17 -0
  26. package/dist/lib/node-esm/chunk-CUDKNAMV.mjs.map +7 -0
  27. package/dist/lib/node-esm/{chunk-256IHY6F.mjs → chunk-RQJPEHDY.mjs} +4 -14
  28. package/dist/lib/node-esm/chunk-RQJPEHDY.mjs.map +7 -0
  29. package/dist/lib/node-esm/chunk-WL3Z5HOH.mjs +135 -0
  30. package/dist/lib/node-esm/chunk-WL3Z5HOH.mjs.map +7 -0
  31. package/dist/lib/node-esm/chunk-WUTK2IJF.mjs +10 -0
  32. package/dist/lib/node-esm/chunk-WUTK2IJF.mjs.map +7 -0
  33. package/dist/lib/node-esm/devtools/index.mjs +3 -7
  34. package/dist/lib/node-esm/devtools/index.mjs.map +2 -2
  35. package/dist/lib/node-esm/echo/index.mjs +58 -127
  36. package/dist/lib/node-esm/echo/index.mjs.map +4 -4
  37. package/dist/lib/node-esm/halo/index.mjs +4 -4
  38. package/dist/lib/node-esm/halo/index.mjs.map +2 -2
  39. package/dist/lib/node-esm/index.mjs +99 -12
  40. package/dist/lib/node-esm/index.mjs.map +4 -4
  41. package/dist/lib/node-esm/invitations/index.mjs +1 -1
  42. package/dist/lib/node-esm/mesh/index.mjs +2 -1
  43. package/dist/lib/node-esm/mesh/index.mjs.map +1 -1
  44. package/dist/lib/node-esm/meta.json +1 -1
  45. package/dist/lib/node-esm/testing/index.mjs +111 -154
  46. package/dist/lib/node-esm/testing/index.mjs.map +3 -3
  47. package/dist/types/src/banner.d.ts.map +1 -1
  48. package/dist/types/src/client/AgentHostingProvider.d.ts.map +1 -1
  49. package/dist/types/src/client/ClientProvider.d.ts +1 -11
  50. package/dist/types/src/client/ClientProvider.d.ts.map +1 -1
  51. package/dist/types/src/client/useClientStatus.d.ts.map +1 -1
  52. package/dist/types/src/devtools/useStream.d.ts.map +1 -1
  53. package/dist/types/src/echo/index.d.ts +2 -2
  54. package/dist/types/src/echo/index.d.ts.map +1 -1
  55. package/dist/types/src/echo/useMembers.d.ts +2 -2
  56. package/dist/types/src/echo/useMembers.d.ts.map +1 -1
  57. package/dist/types/src/echo/useQueue.d.ts +3 -2
  58. package/dist/types/src/echo/useQueue.d.ts.map +1 -1
  59. package/dist/types/src/echo/useSpaceInvitations.d.ts +3 -2
  60. package/dist/types/src/echo/useSpaceInvitations.d.ts.map +1 -1
  61. package/dist/types/src/echo/useSpaceProperties.d.ts +13 -0
  62. package/dist/types/src/echo/useSpaceProperties.d.ts.map +1 -0
  63. package/dist/types/src/echo/useSpaces.d.ts +19 -9
  64. package/dist/types/src/echo/useSpaces.d.ts.map +1 -1
  65. package/dist/types/src/echo/useSubscription.d.ts +1 -1
  66. package/dist/types/src/echo/useSubscription.d.ts.map +1 -1
  67. package/dist/types/src/echo/useSyncState.d.ts.map +1 -1
  68. package/dist/types/src/halo/Passkey.stories.d.ts +5 -5
  69. package/dist/types/src/halo/Passkey.stories.d.ts.map +1 -1
  70. package/dist/types/src/halo/useHaloInvitations.d.ts.map +1 -1
  71. package/dist/types/src/halo/useKeyStore.d.ts.map +1 -1
  72. package/dist/types/src/invitations/useInvitationStatus.d.ts +1 -1
  73. package/dist/types/src/invitations/useInvitationStatus.d.ts.map +1 -1
  74. package/dist/types/src/testing/ClientRepeater.d.ts +6 -5
  75. package/dist/types/src/testing/ClientRepeater.d.ts.map +1 -1
  76. package/dist/types/src/testing/ClientRepeater.stories.d.ts +6 -10
  77. package/dist/types/src/testing/ClientRepeater.stories.d.ts.map +1 -1
  78. package/dist/types/src/testing/context.d.ts +4 -2
  79. package/dist/types/src/testing/context.d.ts.map +1 -1
  80. package/dist/types/src/testing/util.d.ts.map +1 -1
  81. package/dist/types/src/testing/withClientProvider.d.ts +5 -9
  82. package/dist/types/src/testing/withClientProvider.d.ts.map +1 -1
  83. package/dist/types/src/testing/withClientProvider.stories.d.ts +8 -9
  84. package/dist/types/src/testing/withClientProvider.stories.d.ts.map +1 -1
  85. package/dist/types/tsconfig.tsbuildinfo +1 -1
  86. package/docs/README.md +38 -38
  87. package/moon.yml +3 -2
  88. package/package.json +35 -58
  89. package/src/client/ClientProvider.test.tsx +0 -1
  90. package/src/client/ClientProvider.tsx +29 -48
  91. package/src/client/useConfig.test.tsx +0 -1
  92. package/src/echo/index.ts +2 -2
  93. package/src/echo/useMembers.ts +5 -3
  94. package/src/echo/useQueue.ts +3 -4
  95. package/src/echo/useSpaceInvitations.ts +9 -5
  96. package/src/echo/useSpaceProperties.ts +28 -0
  97. package/src/echo/useSpaces.test.tsx +7 -14
  98. package/src/echo/useSpaces.ts +32 -30
  99. package/src/echo/useSubscription.ts +1 -1
  100. package/src/echo/useSyncState.ts +4 -3
  101. package/src/halo/Passkey.stories.tsx +17 -18
  102. package/src/halo/useDevices.test.tsx +0 -1
  103. package/src/invitations/useInvitationStatus.ts +9 -8
  104. package/src/testing/ClientRepeater.stories.tsx +21 -16
  105. package/src/testing/ClientRepeater.tsx +31 -40
  106. package/src/testing/context.tsx +4 -3
  107. package/src/testing/util.tsx +0 -1
  108. package/src/testing/withClientProvider.stories.tsx +33 -20
  109. package/src/testing/withClientProvider.tsx +74 -92
  110. package/tsconfig.json +3 -6
  111. package/typedoc.json +1 -1
  112. package/vitest.config.ts +10 -16
  113. package/.swc/plugins/v7_linux_x86_64_13.0.0/c614d7475354583212fbd7669acbae95b9832c305bf51bdaabe2e6de05abb6bf +0 -0
  114. package/dist/lib/browser/chunk-BXOLJYAY.mjs.map +0 -7
  115. package/dist/lib/browser/chunk-FQAPI3I4.mjs +0 -312
  116. package/dist/lib/browser/chunk-FQAPI3I4.mjs.map +0 -7
  117. package/dist/lib/node-esm/chunk-256IHY6F.mjs.map +0 -7
  118. package/dist/lib/node-esm/chunk-MNTJNI2M.mjs +0 -314
  119. package/dist/lib/node-esm/chunk-MNTJNI2M.mjs.map +0 -7
  120. package/dist/types/src/echo/useQuery.d.ts +0 -11
  121. package/dist/types/src/echo/useQuery.d.ts.map +0 -1
  122. package/dist/types/src/echo/useQuery.test.d.ts +0 -2
  123. package/dist/types/src/echo/useQuery.test.d.ts.map +0 -1
  124. package/dist/types/src/echo/useSchema.d.ts +0 -8
  125. package/dist/types/src/echo/useSchema.d.ts.map +0 -1
  126. package/dist/types/src/playwright/playwright.config.d.ts +0 -3
  127. package/dist/types/src/playwright/playwright.config.d.ts.map +0 -1
  128. package/dist/types/src/playwright/smoke.spec.d.ts +0 -2
  129. package/dist/types/src/playwright/smoke.spec.d.ts.map +0 -1
  130. package/src/echo/useQuery.test.tsx +0 -129
  131. package/src/echo/useQuery.ts +0 -56
  132. package/src/echo/useSchema.ts +0 -54
  133. package/src/playwright/playwright.config.ts +0 -17
  134. package/src/playwright/smoke.spec.ts +0 -24
package/docs/README.md CHANGED
@@ -168,41 +168,41 @@ dxos/react-client --> dxos/react-async
168
168
 
169
169
  ## Dependencies
170
170
 
171
- | Module | Direct |
172
- |---|---|
173
- | [`@dxos/async`](../../../common/async/docs/README.md) | ✓ |
174
- | [`@dxos/broadcast`](../../../core/mesh/broadcast/docs/README.md) | |
175
- | [`@dxos/client`](../../client/docs/README.md) | ✓ |
176
- | [`@dxos/client-services`](../../client-services/docs/README.md) | ✓ |
177
- | [`@dxos/codec-protobuf`](../../../common/codec-protobuf/docs/README.md) | ✓ |
178
- | [`@dxos/config`](../../config/docs/README.md) | ✓ |
179
- | [`@dxos/context`](../../../common/context/docs/README.md) | |
180
- | [`@dxos/credentials`](../../../core/halo/credentials/docs/README.md) | |
181
- | [`@dxos/crypto`](../../../common/crypto/docs/README.md) | |
182
- | [`@dxos/debug`](../../../common/debug/docs/README.md) | ✓ |
183
- | [`@dxos/echo-db`](../../../core/echo/echo-db/docs/README.md) | |
184
- | [`@dxos/errors`](../../errors/docs/README.md) | |
185
- | [`@dxos/feed-store`](../../../common/feed-store/docs/README.md) | |
186
- | [`@dxos/hypercore`](../../../common/hypercore/docs/README.md) | |
187
- | [`@dxos/keyring`](../../../core/halo/keyring/docs/README.md) | |
188
- | [`@dxos/keys`](../../../common/keys/docs/README.md) | ✓ |
189
- | [`@dxos/log`](../../../common/log/docs/README.md) | ✓ |
190
- | [`@dxos/mesh-protocol`](../../../core/mesh/mesh-protocol/docs/README.md) | |
191
- | [`@dxos/messaging`](../../../core/mesh/messaging/docs/README.md) | ✓ |
192
- | [`@dxos/model-factory`](../../../core/echo/model-factory/docs/README.md) | |
193
- | [`@dxos/network-generator`](../../../core/mesh/network-generator/docs/README.md) | |
194
- | [`@dxos/network-manager`](../../../core/mesh/network-manager/docs/README.md) | |
195
- | [`@dxos/document-model`](../../../core/echo/document-model/docs/README.md) | |
196
- | [`@dxos/protocol-plugin-presence`](../../../core/mesh/protocol-plugin-presence/docs/README.md) | |
197
- | [`@dxos/protocol-plugin-replicator`](../../../core/mesh/protocol-plugin-replicator/docs/README.md) | |
198
- | [`@dxos/protocol-plugin-rpc`](../../../core/mesh/protocol-plugin-rpc/docs/README.md) | |
199
- | [`@dxos/protocols`](../../../core/protocols/docs/README.md) | ✓ |
200
- | [`@dxos/random-access-storage`](../../../common/random-access-storage/docs/README.md) | |
201
- | [`@dxos/react-async`](../../../common/react-async/docs/README.md) | ✓ |
202
- | [`@dxos/rpc`](../../../core/mesh/rpc/docs/README.md) | ✓ |
203
- | [`@dxos/rpc-tunnel`](../../../core/mesh/rpc-tunnel/docs/README.md) | ✓ |
204
- | [`@dxos/teleport`](../../../core/mesh/teleport/docs/README.md) | |
205
- | [`@dxos/teleport-plugin-replicator`](../../../core/mesh/teleport-plugin-replicator/docs/README.md) | |
206
- | [`@dxos/text-model`](../../../core/echo/text-model/docs/README.md) | |
207
- | [`@dxos/timeframe`](../../../common/timeframe/docs/README.md) | |
208
- | [`@dxos/util`](../../../common/util/docs/README.md) | ✓ |
171
+ | Module | Direct |
172
+ | -------------------------------------------------------------------------------------------------- | ------- |
173
+ | [`@dxos/async`](../../../common/async/docs/README.md) | ✓ |
174
+ | [`@dxos/broadcast`](../../../core/mesh/broadcast/docs/README.md) | |
175
+ | [`@dxos/client`](../../client/docs/README.md) | ✓ |
176
+ | [`@dxos/client-services`](../../client-services/docs/README.md) | ✓ |
177
+ | [`@dxos/codec-protobuf`](../../../common/codec-protobuf/docs/README.md) | ✓ |
178
+ | [`@dxos/config`](../../config/docs/README.md) | ✓ |
179
+ | [`@dxos/context`](../../../common/context/docs/README.md) | |
180
+ | [`@dxos/credentials`](../../../core/halo/credentials/docs/README.md) | |
181
+ | [`@dxos/crypto`](../../../common/crypto/docs/README.md) | |
182
+ | [`@dxos/debug`](../../../common/debug/docs/README.md) | ✓ |
183
+ | [`@dxos/echo-db`](../../../core/echo/echo-db/docs/README.md) | |
184
+ | [`@dxos/errors`](../../errors/docs/README.md) | |
185
+ | [`@dxos/feed-store`](../../../common/feed-store/docs/README.md) | |
186
+ | [`@dxos/hypercore`](../../../common/hypercore/docs/README.md) | |
187
+ | [`@dxos/keyring`](../../../core/halo/keyring/docs/README.md) | |
188
+ | [`@dxos/keys`](../../../common/keys/docs/README.md) | ✓ |
189
+ | [`@dxos/log`](../../../common/log/docs/README.md) | ✓ |
190
+ | [`@dxos/mesh-protocol`](../../../core/mesh/mesh-protocol/docs/README.md) | |
191
+ | [`@dxos/messaging`](../../../core/mesh/messaging/docs/README.md) | ✓ |
192
+ | [`@dxos/model-factory`](../../../core/echo/model-factory/docs/README.md) | |
193
+ | [`@dxos/network-generator`](../../../core/mesh/network-generator/docs/README.md) | |
194
+ | [`@dxos/network-manager`](../../../core/mesh/network-manager/docs/README.md) | |
195
+ | [`@dxos/document-model`](../../../core/echo/document-model/docs/README.md) | |
196
+ | [`@dxos/protocol-plugin-presence`](../../../core/mesh/protocol-plugin-presence/docs/README.md) | |
197
+ | [`@dxos/protocol-plugin-replicator`](../../../core/mesh/protocol-plugin-replicator/docs/README.md) | |
198
+ | [`@dxos/protocol-plugin-rpc`](../../../core/mesh/protocol-plugin-rpc/docs/README.md) | |
199
+ | [`@dxos/protocols`](../../../core/protocols/docs/README.md) | ✓ |
200
+ | [`@dxos/random-access-storage`](../../../common/random-access-storage/docs/README.md) | |
201
+ | [`@dxos/react-async`](../../../common/react-async/docs/README.md) | ✓ |
202
+ | [`@dxos/rpc`](../../../core/mesh/rpc/docs/README.md) | ✓ |
203
+ | [`@dxos/rpc-tunnel`](../../../core/mesh/rpc-tunnel/docs/README.md) | ✓ |
204
+ | [`@dxos/teleport`](../../../core/mesh/teleport/docs/README.md) | |
205
+ | [`@dxos/teleport-plugin-replicator`](../../../core/mesh/teleport-plugin-replicator/docs/README.md) | |
206
+ | [`@dxos/text-model`](../../../core/echo/text-model/docs/README.md) | |
207
+ | [`@dxos/timeframe`](../../../common/timeframe/docs/README.md) | |
208
+ | [`@dxos/util`](../../../common/util/docs/README.md) | ✓ |
package/moon.yml CHANGED
@@ -1,11 +1,12 @@
1
- type: library
1
+ layer: library
2
2
  language: typescript
3
3
  tags:
4
- - e2e
5
4
  - ts-build
6
5
  - ts-test
6
+ - ts-test-storybook
7
7
  - typedoc
8
8
  - pack
9
+ - storybook
9
10
  tasks:
10
11
  compile:
11
12
  args:
package/package.json CHANGED
@@ -1,12 +1,16 @@
1
1
  {
2
2
  "name": "@dxos/react-client",
3
- "version": "0.8.4-main.f5c0578",
3
+ "version": "0.8.4-main.fcc0d83b33",
4
4
  "description": "React client API",
5
5
  "homepage": "https://dxos.org",
6
6
  "bugs": "https://github.com/dxos/dxos/issues",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "https://github.com/dxos/dxos"
10
+ },
7
11
  "license": "MIT",
8
12
  "author": "DXOS.org",
9
- "sideEffects": true,
13
+ "sideEffects": false,
10
14
  "type": "module",
11
15
  "exports": {
12
16
  "./devtools": {
@@ -59,70 +63,43 @@
59
63
  }
60
64
  },
61
65
  "types": "dist/types/src/index.d.ts",
62
- "typesVersions": {
63
- "*": {
64
- "devtools": [
65
- "dist/types/src/devtools/index.d.ts"
66
- ],
67
- "echo": [
68
- "dist/types/src/echo/index.d.ts"
69
- ],
70
- "halo": [
71
- "dist/types/src/halo/index.d.ts"
72
- ],
73
- "invitations": [
74
- "dist/types/src/invitations/index.d.ts"
75
- ],
76
- "mesh": [
77
- "dist/types/src/mesh/index.d.ts"
78
- ],
79
- "testing": [
80
- "dist/types/src/testing/index.d.ts"
81
- ],
82
- "worker": [
83
- "dist/types/src/worker.d.ts"
84
- ]
85
- }
86
- },
87
66
  "dependencies": {
88
- "react-error-boundary": "^4.0.13",
89
- "@dxos/async": "0.8.4-main.f5c0578",
90
- "@dxos/client": "0.8.4-main.f5c0578",
91
- "@dxos/codec-protobuf": "0.8.4-main.f5c0578",
92
- "@dxos/context": "0.8.4-main.f5c0578",
93
- "@dxos/echo": "0.8.4-main.f5c0578",
94
- "@dxos/debug": "0.8.4-main.f5c0578",
95
- "@dxos/echo-schema": "0.8.4-main.f5c0578",
96
- "@dxos/echo-signals": "0.8.4-main.f5c0578",
97
- "@dxos/config": "0.8.4-main.f5c0578",
98
- "@dxos/invariant": "0.8.4-main.f5c0578",
99
- "@dxos/log": "0.8.4-main.f5c0578",
100
- "@dxos/protocols": "0.8.4-main.f5c0578",
101
- "@dxos/node-std": "0.8.4-main.f5c0578",
102
- "@dxos/react-hooks": "0.8.4-main.f5c0578",
103
- "@dxos/util": "0.8.4-main.f5c0578"
67
+ "@dxos/async": "0.8.4-main.fcc0d83b33",
68
+ "@dxos/codec-protobuf": "0.8.4-main.fcc0d83b33",
69
+ "@dxos/config": "0.8.4-main.fcc0d83b33",
70
+ "@dxos/context": "0.8.4-main.fcc0d83b33",
71
+ "@dxos/echo": "0.8.4-main.fcc0d83b33",
72
+ "@dxos/client": "0.8.4-main.fcc0d83b33",
73
+ "@dxos/echo-react": "0.8.4-main.fcc0d83b33",
74
+ "@dxos/invariant": "0.8.4-main.fcc0d83b33",
75
+ "@dxos/log": "0.8.4-main.fcc0d83b33",
76
+ "@dxos/node-std": "0.8.4-main.fcc0d83b33",
77
+ "@dxos/react-hooks": "0.8.4-main.fcc0d83b33",
78
+ "@dxos/util": "0.8.4-main.fcc0d83b33",
79
+ "@dxos/protocols": "0.8.4-main.fcc0d83b33",
80
+ "@dxos/debug": "0.8.4-main.fcc0d83b33"
104
81
  },
105
82
  "devDependencies": {
106
- "@types/react": "~18.2.0",
107
- "@types/react-dom": "~18.2.0",
108
- "react": "~18.2.0",
109
- "react-dom": "~18.2.0",
83
+ "@types/react": "~19.2.7",
84
+ "@types/react-dom": "~19.2.3",
85
+ "react": "~19.2.3",
86
+ "react-dom": "~19.2.3",
110
87
  "typedoc": "0.28.1",
111
- "@dxos/random": "0.8.4-main.f5c0578",
112
- "@dxos/react-ui-theme": "0.8.4-main.f5c0578",
113
- "@dxos/react-ui": "0.8.4-main.f5c0578",
114
- "@dxos/react-ui-syntax-highlighter": "0.8.4-main.f5c0578",
115
- "@dxos/test-utils": "0.8.4-main.f5c0578",
116
- "@dxos/storybook-utils": "0.8.4-main.f5c0578"
88
+ "@dxos/storybook-utils": "0.8.4-main.fcc0d83b33",
89
+ "@dxos/react-ui-syntax-highlighter": "0.8.4-main.fcc0d83b33",
90
+ "@dxos/test-utils": "0.8.4-main.fcc0d83b33",
91
+ "@dxos/random": "0.8.4-main.fcc0d83b33",
92
+ "@dxos/react-ui": "0.8.4-main.fcc0d83b33",
93
+ "@dxos/ui-theme": "0.8.4-main.fcc0d83b33"
117
94
  },
118
95
  "peerDependencies": {
119
- "react": "~18.2.0",
120
- "react-dom": "~18.2.0"
96
+ "react": "~19.2.3",
97
+ "react-dom": "~19.2.3"
121
98
  },
122
99
  "optionalDependencies": {
123
- "@dxos/random": "0.8.4-main.f5c0578",
124
- "@dxos/react-ui": "0.8.4-main.f5c0578",
125
- "@dxos/react-ui-theme": "0.8.4-main.f5c0578"
100
+ "@dxos/react-ui": "0.8.4-main.fcc0d83b33",
101
+ "@dxos/random": "0.8.4-main.fcc0d83b33",
102
+ "@dxos/ui-theme": "0.8.4-main.fcc0d83b33"
126
103
  },
127
104
  "publishConfig": {
128
105
  "access": "public"
@@ -11,7 +11,6 @@ import { Client, Config, SystemStatus, fromHost } from '@dxos/client';
11
11
  import { log } from '@dxos/log';
12
12
 
13
13
  import { useIdentity } from '../halo';
14
-
15
14
  import { ClientProvider } from './ClientProvider';
16
15
  import { useClient } from './useClient';
17
16
 
@@ -13,13 +13,11 @@ import React, {
13
13
 
14
14
  import { Client, type ClientOptions, type ClientServicesProvider, SystemStatus } from '@dxos/client';
15
15
  import { type Config } from '@dxos/config';
16
- import { registerSignalsRuntime } from '@dxos/echo-signals/react';
17
16
  import { log } from '@dxos/log';
18
- import { useControlledState } from '@dxos/react-hooks';
17
+ import { useAsyncEffect, useControlledState } from '@dxos/react-hooks';
19
18
  import { type MaybePromise, type Provider, getAsyncProviderValue } from '@dxos/util';
20
19
 
21
20
  import { printBanner } from '../banner';
22
-
23
21
  import { ClientContext, type ClientContextProps } from './context';
24
22
 
25
23
  /**
@@ -56,12 +54,6 @@ export type ClientProviderProps = Omit<ClientOptions, 'config' | 'services'> &
56
54
  */
57
55
  fallback?: FunctionComponent<Partial<ClientContextProps>>;
58
56
 
59
- /**
60
- * Enable (by default) registration of Preact signals runtime for reactive ECHO objects.
61
- * @see https://www.npmjs.com/package/@preact/signals-react
62
- */
63
- signalsRuntime?: boolean;
64
-
65
57
  /**
66
58
  * Skip the DXOS banner.
67
59
  */
@@ -81,24 +73,17 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
81
73
  (
82
74
  {
83
75
  children,
84
- config: configProvider,
85
- client: clientProvider,
86
- services: servicesProvider,
87
- status: controlledStatus,
76
+ config: configProp,
77
+ client: clientProp,
78
+ services: servicesProp,
79
+ status: statusProp,
88
80
  fallback: Fallback = () => null,
89
- signalsRuntime = true,
90
81
  noBanner,
91
82
  onInitialized,
92
83
  ...options
93
84
  },
94
85
  forwardedRef,
95
86
  ) => {
96
- useEffect(() => {
97
- // TODO(wittjosiah): Ideally this should be imported asynchronously because it is optional.
98
- // Unfortunately, async import seemed to break signals React instrumentation.
99
- signalsRuntime && registerSignalsRuntime();
100
- }, []);
101
-
102
87
  // The client is initialized asynchronously.
103
88
  // If an error occurs during initialization, it is caught and the state is set.
104
89
  // This allows the error to be thrown in the render method.
@@ -109,13 +94,13 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
109
94
  throw error;
110
95
  }
111
96
 
112
- const [client, setClient] = useState(clientProvider instanceof Client ? clientProvider : undefined);
97
+ const [client, setClient] = useState(clientProp instanceof Client ? clientProp : undefined);
113
98
 
114
99
  // Provide external access.
115
100
  useImperativeHandle(forwardedRef, () => client, [client]);
116
101
 
117
102
  // Client status subscription.
118
- const [status, setStatus] = useControlledState(controlledStatus);
103
+ const [status, setStatus] = useControlledState(statusProp);
119
104
  useEffect(() => {
120
105
  if (!client) {
121
106
  return;
@@ -126,7 +111,7 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
126
111
  }, [client]);
127
112
 
128
113
  // Create and/or initialize client.
129
- useEffect(() => {
114
+ useAsyncEffect(async () => {
130
115
  let disposed = false;
131
116
  const initialize = async (client: Client) => {
132
117
  if (!client.initialized) {
@@ -141,42 +126,38 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
141
126
  }
142
127
 
143
128
  setClient(client);
144
-
145
129
  if (!noBanner) {
146
130
  printBanner(client);
147
131
  }
148
132
  };
149
133
 
150
134
  let client: Client;
151
- const t = setTimeout(async () => {
152
- try {
153
- if (clientProvider) {
154
- // Asynchronously request client.
155
- client = await getAsyncProviderValue(clientProvider);
156
- await initialize(client);
157
- } else {
158
- // Asynchronously construct client (config may be undefined).
159
- const config = await getAsyncProviderValue(configProvider);
160
- log('resolved config', { config });
161
- const services = await getAsyncProviderValue(servicesProvider, config);
162
- log('created services', { services });
163
- client = new Client({ config, services, ...options });
164
- log('created client');
165
- await initialize(client);
166
- }
167
- } catch (err) {
168
- if (!disposed) {
169
- log.catch(err);
170
- }
135
+ try {
136
+ if (clientProp) {
137
+ // Asynchronously request client.
138
+ client = await getAsyncProviderValue(clientProp);
139
+ await initialize(client);
140
+ } else {
141
+ // Asynchronously construct client (config may be undefined).
142
+ const config = await getAsyncProviderValue(configProp);
143
+ log('resolved config', { config });
144
+ const services = await getAsyncProviderValue(servicesProp, config);
145
+ log('created services', { services });
146
+ client = new Client({ config, services, ...options });
147
+ log('created client');
148
+ await initialize(client);
171
149
  }
172
- });
150
+ } catch (err) {
151
+ if (!disposed) {
152
+ log.catch(err);
153
+ }
154
+ }
173
155
 
174
156
  return () => {
175
157
  log('clean up');
176
158
  disposed = true;
177
- clearTimeout(t);
178
159
  // Only destroy if the client is not provided by the parent.
179
- if (!clientProvider) {
160
+ if (!clientProp) {
180
161
  void client
181
162
  ?.destroy()
182
163
  .then(() => {
@@ -185,7 +166,7 @@ export const ClientProvider = forwardRef<Client | undefined, ClientProviderProps
185
166
  .catch((err) => log.catch(err));
186
167
  }
187
168
  };
188
- }, [configProvider, clientProvider, servicesProvider, noBanner]);
169
+ }, [configProp, clientProp, servicesProp, noBanner]);
189
170
 
190
171
  if (!client?.initialized || status !== SystemStatus.ACTIVE) {
191
172
  return <Fallback client={client} status={status} />;
@@ -9,7 +9,6 @@ import { waitForCondition } from '@dxos/async';
9
9
  import { Config, SystemStatus } from '@dxos/client';
10
10
 
11
11
  import { createClient, createClientContextProvider } from '../testing/util';
12
-
13
12
  import { useConfig } from './useConfig';
14
13
 
15
14
  // TODO(burdon): Disabled in CI since flaky.
package/src/echo/index.ts CHANGED
@@ -3,12 +3,12 @@
3
3
  //
4
4
 
5
5
  export * from '@dxos/client/echo';
6
+ export * from '@dxos/echo-react';
6
7
 
7
8
  export * from './useMembers';
8
- export * from './useQuery';
9
9
  export * from './useQueue';
10
- export * from './useSchema';
11
10
  export * from './useSpaces';
12
11
  export * from './useSpaceInvitations';
12
+ export * from './useSpaceProperties';
13
13
  export * from './useSubscription';
14
14
  export * from './useSyncState';
@@ -3,16 +3,18 @@
3
3
  //
4
4
 
5
5
  import { MulticastObservable } from '@dxos/async';
6
- import { type PublicKey } from '@dxos/client';
6
+ import { PublicKey, type PublicKeyLike } from '@dxos/client';
7
7
  import { HaloSpaceMember, type SpaceMember } from '@dxos/client/echo';
8
8
  import { useMulticastObservable } from '@dxos/react-hooks';
9
9
 
10
10
  import { useSpaces } from './useSpaces';
11
11
 
12
- export const useMembers = (spaceKey: PublicKey | undefined): SpaceMember[] => {
12
+ export const useMembers = (spaceKey: PublicKeyLike | undefined): SpaceMember[] => {
13
13
  // TODO(dmaretskyi): useSpace hook for spaces that are not ready.
14
14
  const spaces = useSpaces({ all: true });
15
- const space = spaceKey ? spaces.find((space) => space.key.equals(spaceKey)) : undefined;
15
+ const space = spaceKey
16
+ ? spaces.find((space) => (spaceKey instanceof PublicKey ? space.key.equals(spaceKey) : space.id === spaceKey))
17
+ : undefined;
16
18
 
17
19
  // EMPTY_OBSERVABLE needs to be a stable reference to avoid re-subscribing on every render.
18
20
  const members = useMulticastObservable(space?.members ?? MulticastObservable.empty()) ?? [];
@@ -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';
@@ -19,12 +19,11 @@ export type UseQueueOptions = {
19
19
 
20
20
  /**
21
21
  * Polls the given Edge queue.
22
+ * @deprecated Use `useQuery` instead.
22
23
  */
23
- // TODO(burdon): Replace polling with socket?
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
- // TODO(ZaymonFC): If queue is unchanged returned object should be refferentially stable on poll.
27
- export const useQueue = <T extends Obj.Any | Relation.Any>(
26
+ export const useQueue = <T extends Entity.Unknown>(
28
27
  queueDxn?: DXN,
29
28
  options: UseQueueOptions = {},
30
29
  ): Queue<T> | undefined => {
@@ -6,19 +6,23 @@ import { useMemo } from 'react';
6
6
 
7
7
  import { MulticastObservable } from '@dxos/async';
8
8
  import { type PublicKey } from '@dxos/client';
9
+ import { type SpaceId } from '@dxos/client/echo';
9
10
  import { useMulticastObservable } from '@dxos/react-hooks';
10
11
 
11
12
  import { type CancellableInvitationObservable, useInvitationStatus } from '../invitations';
12
-
13
13
  import { useSpace } from './useSpaces';
14
14
 
15
- export const useSpaceInvitations = (spaceKey?: PublicKey): CancellableInvitationObservable[] => {
16
- const space = useSpace(spaceKey);
15
+ // TODO(wittjosiah): Currently unable to remove `PublicKey` from this api.
16
+ // When initially joining a space that is all that is returned.
17
+ export const useSpaceInvitations = (spaceId?: SpaceId | PublicKey): CancellableInvitationObservable[] => {
18
+ const space = useSpace(spaceId);
17
19
  return useMulticastObservable(space?.invitations ?? MulticastObservable.empty()) ?? [];
18
20
  };
19
21
 
20
- export const useSpaceInvitation = (spaceKey?: PublicKey, invitationId?: string) => {
21
- const invitations = useSpaceInvitations(spaceKey);
22
+ // TODO(wittjosiah): Currently unable to remove `PublicKey` from this api.
23
+ // When initially joining a space that is all that is returned.
24
+ export const useSpaceInvitation = (spaceId?: SpaceId | PublicKey, invitationId?: string) => {
25
+ const invitations = useSpaceInvitations(spaceId);
22
26
  const invitation = useMemo(
23
27
  () => invitations.find((invitation) => invitation.get().invitationId === invitationId),
24
28
  [invitations],
@@ -0,0 +1,28 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { MulticastObservable } from '@dxos/async';
6
+ import { type SpaceProperties, SpaceState } from '@dxos/client/echo';
7
+ import { type Key, type Obj } from '@dxos/echo';
8
+ import { type ObjectUpdateCallback, useObject } from '@dxos/echo-react';
9
+ import { useMulticastObservable } from '@dxos/react-hooks';
10
+
11
+ import { useSpace } from './useSpaces';
12
+
13
+ /**
14
+ * Subscribe to a space's properties with reactive updates.
15
+ * Returns undefined if the space is undefined or not ready yet.
16
+ * Automatically waits for the space to be ready before returning properties.
17
+ *
18
+ * @param spaceId - The space ID to get properties from (can be undefined).
19
+ * @returns A tuple of [snapshot, updateCallback] or [undefined, no-op] if not ready.
20
+ */
21
+ export const useSpaceProperties = (
22
+ spaceId: Key.SpaceId | undefined,
23
+ ): [Obj.Snapshot<SpaceProperties> | undefined, ObjectUpdateCallback<SpaceProperties>] => {
24
+ const space = useSpace(spaceId);
25
+ const spaceState = useMulticastObservable(space?.state ?? MulticastObservable.empty());
26
+ const properties = spaceState === SpaceState.SPACE_READY ? space?.properties : undefined;
27
+ return useObject(properties);
28
+ };
@@ -6,19 +6,18 @@ import { act, renderHook } from '@testing-library/react';
6
6
  import { describe, expect, test } from 'vitest';
7
7
 
8
8
  import { createClient, createClientContextProvider } from '../testing/util';
9
-
10
9
  import { useSpace, useSpaces } from './useSpaces';
11
10
 
12
11
  describe('useSpaces', () => {
13
12
  test('lists existing spaces', async () => {
14
- const { client } = await createClient({ createIdentity: true });
13
+ const { client } = await createClient({ createIdentity: true, createSpace: true });
15
14
  const wrapper = await createClientContextProvider(client);
16
15
  const { result } = renderHook(() => useSpaces(), { wrapper });
17
16
  expect(result.current.length).to.eq(1);
18
17
  });
19
18
 
20
19
  test('updates when new spaces are created', async () => {
21
- const { client } = await createClient({ createIdentity: true });
20
+ const { client } = await createClient({ createIdentity: true, createSpace: true });
22
21
  const wrapper = await createClientContextProvider(client);
23
22
  const { result, rerender } = renderHook(() => useSpaces(), { wrapper });
24
23
  expect(result.current.length).to.eq(1);
@@ -31,23 +30,17 @@ describe('useSpaces', () => {
31
30
  });
32
31
 
33
32
  describe('useSpace', () => {
34
- test('gets default space', async () => {
35
- const { client } = await createClient();
33
+ test('returns undefined when no id provided', async () => {
34
+ const { client } = await createClient({ createIdentity: true });
36
35
  const wrapper = await createClientContextProvider(client);
37
- const { result, rerender } = renderHook(() => useSpace(), { wrapper });
36
+ const { result } = renderHook(() => useSpace(undefined), { wrapper });
38
37
  expect(result.current).to.be.undefined;
39
- await act(async () => {
40
- await client.halo.createIdentity();
41
- await client.spaces.waitUntilReady();
42
- });
43
- rerender();
44
- expect(result.current).to.not.be.undefined;
45
38
  });
46
39
 
47
- test('gets space by key', async () => {
40
+ test('gets space by id', async () => {
48
41
  const { client, space } = await createClient({ createIdentity: true, createSpace: true });
49
42
  const wrapper = await createClientContextProvider(client);
50
- const { result } = renderHook(() => useSpace(space!.key), { wrapper });
43
+ const { result } = renderHook(() => useSpace(space!.id), { wrapper });
51
44
  expect(result.current).to.not.be.undefined;
52
45
  });
53
46
  });