@dxos/react-client 0.6.13 → 0.6.14-main.69511f5

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 (90) hide show
  1. package/dist/lib/browser/{chunk-CL7JDETM.mjs → chunk-U6WOCCWH.mjs} +62 -60
  2. package/dist/lib/browser/chunk-U6WOCCWH.mjs.map +7 -0
  3. package/dist/lib/browser/devtools/index.mjs +1 -1
  4. package/dist/lib/browser/echo/index.mjs +7 -5
  5. package/dist/lib/browser/echo/index.mjs.map +3 -3
  6. package/dist/lib/browser/halo/index.mjs +1 -1
  7. package/dist/lib/browser/index.mjs +1 -3
  8. package/dist/lib/browser/index.mjs.map +1 -1
  9. package/dist/lib/browser/mesh/index.mjs +1 -1
  10. package/dist/lib/browser/meta.json +1 -1
  11. package/dist/lib/browser/testing/index.mjs +98 -37
  12. package/dist/lib/browser/testing/index.mjs.map +3 -3
  13. package/dist/lib/node/{chunk-C4EWAKPZ.cjs → chunk-BYDG3FH4.cjs} +63 -60
  14. package/dist/lib/node/chunk-BYDG3FH4.cjs.map +7 -0
  15. package/dist/lib/node/devtools/index.cjs +2 -2
  16. package/dist/lib/node/echo/index.cjs +8 -6
  17. package/dist/lib/node/echo/index.cjs.map +3 -3
  18. package/dist/lib/node/halo/index.cjs +5 -5
  19. package/dist/lib/node/index.cjs +12 -14
  20. package/dist/lib/node/index.cjs.map +1 -1
  21. package/dist/lib/node/mesh/index.cjs +2 -2
  22. package/dist/lib/node/meta.json +1 -1
  23. package/dist/lib/node/testing/index.cjs +98 -36
  24. package/dist/lib/node/testing/index.cjs.map +3 -3
  25. package/dist/lib/node-esm/chunk-E5UAY5Z4.mjs +295 -0
  26. package/dist/lib/node-esm/chunk-E5UAY5Z4.mjs.map +7 -0
  27. package/dist/lib/node-esm/chunk-UYJUBYMU.mjs +165 -0
  28. package/dist/lib/node-esm/chunk-UYJUBYMU.mjs.map +7 -0
  29. package/dist/lib/node-esm/devtools/index.mjs +44 -0
  30. package/dist/lib/node-esm/devtools/index.mjs.map +7 -0
  31. package/dist/lib/node-esm/echo/index.mjs +134 -0
  32. package/dist/lib/node-esm/echo/index.mjs.map +7 -0
  33. package/dist/lib/node-esm/halo/index.mjs +100 -0
  34. package/dist/lib/node-esm/halo/index.mjs.map +7 -0
  35. package/dist/lib/node-esm/index.mjs +33 -0
  36. package/dist/lib/node-esm/index.mjs.map +7 -0
  37. package/dist/lib/node-esm/invitations/index.mjs +18 -0
  38. package/dist/lib/node-esm/invitations/index.mjs.map +7 -0
  39. package/dist/lib/node-esm/mesh/index.mjs +18 -0
  40. package/dist/lib/node-esm/mesh/index.mjs.map +7 -0
  41. package/dist/lib/node-esm/meta.json +1 -0
  42. package/dist/lib/node-esm/testing/index.mjs +227 -0
  43. package/dist/lib/node-esm/testing/index.mjs.map +7 -0
  44. package/dist/lib/node-esm/worker.mjs +5 -0
  45. package/dist/lib/node-esm/worker.mjs.map +7 -0
  46. package/dist/types/src/client/AgentHostingProvider.d.ts +1 -1
  47. package/dist/types/src/client/AgentHostingProvider.d.ts.map +1 -1
  48. package/dist/types/src/client/ClientProvider.d.ts +57 -20
  49. package/dist/types/src/client/ClientProvider.d.ts.map +1 -1
  50. package/dist/types/src/client/context.d.ts +1 -4
  51. package/dist/types/src/client/context.d.ts.map +1 -1
  52. package/dist/types/src/client/index.d.ts +0 -1
  53. package/dist/types/src/client/index.d.ts.map +1 -1
  54. package/dist/types/src/echo/useQuery.d.ts.map +1 -1
  55. package/dist/types/src/playwright/playwright.config.d.ts +2 -2
  56. package/dist/types/src/playwright/playwright.config.d.ts.map +1 -1
  57. package/dist/types/src/testing/ClientRepeater.d.ts +9 -12
  58. package/dist/types/src/testing/ClientRepeater.d.ts.map +1 -1
  59. package/dist/types/src/testing/util.d.ts +5 -3
  60. package/dist/types/src/testing/util.d.ts.map +1 -1
  61. package/dist/types/src/testing/withClientProvider.d.ts +7 -1
  62. package/dist/types/src/testing/withClientProvider.d.ts.map +1 -1
  63. package/dist/types/src/testing/withClientProvider.stories.d.ts +4 -3
  64. package/dist/types/src/testing/withClientProvider.stories.d.ts.map +1 -1
  65. package/package.json +45 -62
  66. package/project.json +3 -22
  67. package/src/client/AgentHostingProvider.tsx +1 -1
  68. package/src/client/ClientProvider.test.tsx +7 -4
  69. package/src/client/ClientProvider.tsx +126 -102
  70. package/src/client/context.ts +4 -5
  71. package/src/client/index.ts +0 -3
  72. package/src/client/useConfig.test.tsx +10 -12
  73. package/src/echo/useQuery.ts +3 -6
  74. package/src/echo/useSpaces.test.tsx +7 -9
  75. package/src/echo/useSpaces.ts +1 -1
  76. package/src/halo/useDevices.test.tsx +3 -5
  77. package/src/playwright/playwright.config.ts +13 -2
  78. package/src/playwright/smoke.spec.ts +5 -10
  79. package/src/testing/ClientRepeater.stories.tsx +1 -1
  80. package/src/testing/ClientRepeater.tsx +19 -20
  81. package/src/testing/util.tsx +12 -7
  82. package/src/testing/withClientProvider.stories.tsx +20 -11
  83. package/src/testing/withClientProvider.tsx +55 -24
  84. package/tsconfig.json +3 -59
  85. package/vitest.config.ts +22 -0
  86. package/dist/lib/browser/chunk-CL7JDETM.mjs.map +0 -7
  87. package/dist/lib/node/chunk-C4EWAKPZ.cjs.map +0 -7
  88. package/dist/types/src/client/useClientServices.d.ts +0 -3
  89. package/dist/types/src/client/useClientServices.d.ts.map +0 -1
  90. package/src/client/useClientServices.ts +0 -15
@@ -0,0 +1,295 @@
1
+ import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
2
+
3
+ // packages/sdk/react-client/src/client/AgentHostingProvider.tsx
4
+ import React2, { createContext as createContext2, useContext as useContext4, useState as useState4 } from "react";
5
+ import { AgentManagerClient, FakeAgentHostingProvider } from "@dxos/client";
6
+ import { log as log2 } from "@dxos/log";
7
+
8
+ // packages/sdk/react-client/src/client/ClientProvider.tsx
9
+ import React, { forwardRef, useEffect, useImperativeHandle, useState } from "react";
10
+ import { Client, SystemStatus } from "@dxos/client";
11
+ import { registerSignalsRuntime } from "@dxos/echo-signals/react";
12
+ import { log } from "@dxos/log";
13
+ import { useControlledValue } from "@dxos/react-hooks";
14
+ import { getAsyncProviderValue } from "@dxos/util";
15
+
16
+ // packages/sdk/react-client/src/client/context.ts
17
+ import { createContext } from "react";
18
+ var ClientContext = createContext(void 0);
19
+
20
+ // packages/sdk/react-client/src/banner.ts
21
+ var BANNER = (client) => {
22
+ const commitHash = client.config.get("runtime.app.build.commitHash");
23
+ const hash = commitHash ? ` App Commit ${commitHash}
24
+ ` : "";
25
+ return `
26
+ _/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\______/\\/\\/\\/\\/\\_
27
+ _/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__/\\/\\_________
28
+ _/\\/\\____/\\/\\______/\\/\\______/\\/\\____/\\/\\____/\\/\\/\\/\\___
29
+ _/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__________/\\/\\_
30
+ _/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\/\\/\\/\\___
31
+
32
+ DXOS Client ${client.version}
33
+ ${hash}`;
34
+ };
35
+ var bannerPrinted = false;
36
+ var printBanner = (client) => {
37
+ if (bannerPrinted) {
38
+ return;
39
+ }
40
+ bannerPrinted = true;
41
+ console.log(`%c${BANNER(client)}`, "font-family: monospace;");
42
+ };
43
+
44
+ // packages/sdk/react-client/src/client/ClientProvider.tsx
45
+ var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/client/ClientProvider.tsx";
46
+ var ClientProvider = /* @__PURE__ */ forwardRef(({ children, config: configProvider, client: clientProvider, services: servicesProvider, status: controlledStatus, fallback: Fallback = () => null, signalsRuntime = true, noBanner, onInitialized, ...options }, forwardedRef) => {
47
+ useEffect(() => {
48
+ signalsRuntime && registerSignalsRuntime();
49
+ }, []);
50
+ const [error, setError] = useState();
51
+ if (error) {
52
+ throw error;
53
+ }
54
+ const [client, setClient] = useState(clientProvider instanceof Client ? clientProvider : void 0);
55
+ useImperativeHandle(forwardedRef, () => client, [
56
+ client
57
+ ]);
58
+ const [status, setStatus] = useControlledValue(controlledStatus);
59
+ useEffect(() => {
60
+ if (!client) {
61
+ return;
62
+ }
63
+ const subscription = client.status.subscribe((status2) => setStatus(status2));
64
+ return () => subscription.unsubscribe();
65
+ }, [
66
+ client
67
+ ]);
68
+ useEffect(() => {
69
+ const initialize = async (client3) => {
70
+ if (!client3.initialized) {
71
+ await client3.initialize().catch(setError);
72
+ log("client ready", void 0, {
73
+ F: __dxlog_file,
74
+ L: 132,
75
+ S: void 0,
76
+ C: (f, a) => f(...a)
77
+ });
78
+ await onInitialized?.(client3);
79
+ log("initialization complete", void 0, {
80
+ F: __dxlog_file,
81
+ L: 134,
82
+ S: void 0,
83
+ C: (f, a) => f(...a)
84
+ });
85
+ }
86
+ setClient(client3);
87
+ if (!noBanner) {
88
+ printBanner(client3);
89
+ }
90
+ };
91
+ let client2;
92
+ const t = setTimeout(async () => {
93
+ if (clientProvider) {
94
+ client2 = await getAsyncProviderValue(clientProvider);
95
+ await initialize(client2);
96
+ } else {
97
+ const config = await getAsyncProviderValue(configProvider);
98
+ log("resolved config", {
99
+ config
100
+ }, {
101
+ F: __dxlog_file,
102
+ L: 153,
103
+ S: void 0,
104
+ C: (f, a) => f(...a)
105
+ });
106
+ const services = await getAsyncProviderValue(servicesProvider, config);
107
+ log("created services", {
108
+ services
109
+ }, {
110
+ F: __dxlog_file,
111
+ L: 155,
112
+ S: void 0,
113
+ C: (f, a) => f(...a)
114
+ });
115
+ client2 = new Client({
116
+ config,
117
+ services,
118
+ ...options
119
+ });
120
+ log("created client", void 0, {
121
+ F: __dxlog_file,
122
+ L: 157,
123
+ S: void 0,
124
+ C: (f, a) => f(...a)
125
+ });
126
+ await initialize(client2);
127
+ }
128
+ });
129
+ return () => {
130
+ log("clean up", void 0, {
131
+ F: __dxlog_file,
132
+ L: 163,
133
+ S: void 0,
134
+ C: (f, a) => f(...a)
135
+ });
136
+ clearTimeout(t);
137
+ void client2?.destroy().then(() => {
138
+ log("destroyed", void 0, {
139
+ F: __dxlog_file,
140
+ L: 168,
141
+ S: void 0,
142
+ C: (f, a) => f(...a)
143
+ });
144
+ }).catch((err) => log.catch(err, void 0, {
145
+ F: __dxlog_file,
146
+ L: 170,
147
+ S: void 0,
148
+ C: (f, a) => f(...a)
149
+ }));
150
+ };
151
+ }, [
152
+ configProvider,
153
+ clientProvider,
154
+ servicesProvider,
155
+ noBanner
156
+ ]);
157
+ if (!client?.initialized || status !== SystemStatus.ACTIVE) {
158
+ return /* @__PURE__ */ React.createElement(Fallback, {
159
+ client,
160
+ status
161
+ });
162
+ }
163
+ return /* @__PURE__ */ React.createElement(ClientContext.Provider, {
164
+ value: {
165
+ client,
166
+ status
167
+ }
168
+ }, children);
169
+ });
170
+
171
+ // packages/sdk/react-client/src/client/useClient.ts
172
+ import { useContext } from "react";
173
+ import { raise } from "@dxos/debug";
174
+ var useClient = () => {
175
+ const { client } = useContext(ClientContext) ?? raise(new Error("Missing ClientContext."));
176
+ return client;
177
+ };
178
+
179
+ // packages/sdk/react-client/src/client/useClientStatus.ts
180
+ import { useEffect as useEffect2, useState as useState2 } from "react";
181
+ var useClientStatus = (client) => {
182
+ const [status, setStatus] = useState2();
183
+ useEffect2(() => {
184
+ if (!client) {
185
+ return;
186
+ }
187
+ const subscription = client.status.subscribe((status2) => setStatus(status2));
188
+ return () => subscription.unsubscribe();
189
+ }, [
190
+ client,
191
+ setStatus
192
+ ]);
193
+ return status;
194
+ };
195
+
196
+ // packages/sdk/react-client/src/client/useConfig.ts
197
+ import { useContext as useContext2 } from "react";
198
+ import { raise as raise2 } from "@dxos/debug";
199
+ var useConfig = () => {
200
+ const { client } = useContext2(ClientContext) ?? raise2(new Error("Missing ClientContext."));
201
+ return client.config;
202
+ };
203
+
204
+ // packages/sdk/react-client/src/client/useShell.ts
205
+ import { useEffect as useEffect3, useState as useState3 } from "react";
206
+ var useShell = () => {
207
+ const client = useClient();
208
+ return client.shell;
209
+ };
210
+ var useShellDisplay = () => {
211
+ const client = useClient();
212
+ const [display, setDisplay] = useState3(client.shell.display);
213
+ useEffect3(() => client.shell.onDisplayChange(setDisplay), [
214
+ client
215
+ ]);
216
+ return display;
217
+ };
218
+
219
+ // packages/sdk/react-client/src/client/useStatus.ts
220
+ import { useContext as useContext3 } from "react";
221
+ import { raise as raise3 } from "@dxos/debug";
222
+ var useStatus = () => {
223
+ const { status } = useContext3(ClientContext) ?? raise3(new Error("Missing ClientContext."));
224
+ return status;
225
+ };
226
+
227
+ // packages/sdk/react-client/src/client/AgentHostingProvider.tsx
228
+ var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/client/AgentHostingProvider.tsx";
229
+ var AgentHostingContext = /* @__PURE__ */ createContext2(null);
230
+ var AgentHostingProvider = (props) => {
231
+ const client = useClient();
232
+ const [agentHostingProviderClient] = useState4(makeClient(client));
233
+ return /* @__PURE__ */ React2.createElement(AgentHostingContext.Provider, {
234
+ value: agentHostingProviderClient
235
+ }, " ", props.children);
236
+ };
237
+ var useAgentHostingClient = () => {
238
+ return useContext4(AgentHostingContext);
239
+ };
240
+ var makeClient = ({ config, halo }) => {
241
+ const agentHostingConfig = config.get("runtime.services.agentHosting");
242
+ if (!agentHostingConfig) {
243
+ log2("no agent hosting configured", void 0, {
244
+ F: __dxlog_file2,
245
+ L: 39,
246
+ S: void 0,
247
+ C: (f, a) => f(...a)
248
+ });
249
+ return null;
250
+ }
251
+ let agentHostingProviderClient = null;
252
+ switch (agentHostingConfig.type) {
253
+ case "LOCAL_TESTING": {
254
+ log2("using FakeAgentHostingProvider", void 0, {
255
+ F: __dxlog_file2,
256
+ L: 47,
257
+ S: void 0,
258
+ C: (f, a) => f(...a)
259
+ });
260
+ return new FakeAgentHostingProvider();
261
+ }
262
+ case "AGENTHOSTING_API": {
263
+ agentHostingProviderClient = new AgentManagerClient(config, halo);
264
+ if (agentHostingProviderClient.init()) {
265
+ return agentHostingProviderClient;
266
+ } else {
267
+ return null;
268
+ }
269
+ }
270
+ default: {
271
+ log2.error("Unknown agent hosting provider type: " + agentHostingConfig.type, void 0, {
272
+ F: __dxlog_file2,
273
+ L: 62,
274
+ S: void 0,
275
+ C: (f, a) => f(...a)
276
+ });
277
+ return null;
278
+ }
279
+ }
280
+ };
281
+
282
+ export {
283
+ AgentHostingContext,
284
+ AgentHostingProvider,
285
+ useAgentHostingClient,
286
+ ClientContext,
287
+ ClientProvider,
288
+ useClient,
289
+ useClientStatus,
290
+ useConfig,
291
+ useShell,
292
+ useShellDisplay,
293
+ useStatus
294
+ };
295
+ //# sourceMappingURL=chunk-E5UAY5Z4.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../src/client/AgentHostingProvider.tsx", "../../../src/client/ClientProvider.tsx", "../../../src/client/context.ts", "../../../src/banner.ts", "../../../src/client/useClient.ts", "../../../src/client/useClientStatus.ts", "../../../src/client/useConfig.ts", "../../../src/client/useShell.ts", "../../../src/client/useStatus.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { createContext, type PropsWithChildren, useContext, useState } from 'react';\n\nimport { type AgentHostingProviderClient, AgentManagerClient, FakeAgentHostingProvider } from '@dxos/client';\nimport { type Halo } from '@dxos/client/halo';\nimport { type Config } from '@dxos/config';\nimport { log } from '@dxos/log';\n\nimport { useClient } from '../client';\n\nexport type AgentHostingProviderProps = { config: Config; halo: Halo };\n\nexport const AgentHostingContext = createContext<AgentHostingProviderClient | null>(null);\n\n/**\n * Experimental agent hosting provider.\n * @param props\n * @constructor\n * @deprecated\n */\nexport const AgentHostingProvider = (props: PropsWithChildren) => {\n const client = useClient();\n const [agentHostingProviderClient] = useState(makeClient(client));\n return (\n <AgentHostingContext.Provider value={agentHostingProviderClient}> {props.children}</AgentHostingContext.Provider>\n );\n};\n\nexport const useAgentHostingClient = () => {\n return useContext(AgentHostingContext);\n};\n\nconst makeClient = ({ config, halo }: AgentHostingProviderProps) => {\n const agentHostingConfig = config.get('runtime.services.agentHosting');\n if (!agentHostingConfig) {\n log('no agent hosting configured');\n return null;\n }\n\n // TODO(nf): Dynamically discover based on runtime config.\n let agentHostingProviderClient: AgentHostingProviderClient | null = null;\n switch (agentHostingConfig.type) {\n case 'LOCAL_TESTING': {\n log('using FakeAgentHostingProvider');\n return new FakeAgentHostingProvider();\n }\n\n case 'AGENTHOSTING_API': {\n agentHostingProviderClient = new AgentManagerClient(config, halo);\n if (agentHostingProviderClient.init()) {\n return agentHostingProviderClient;\n } else {\n // Not authorized or error initializing.\n return null;\n }\n }\n\n default: {\n log.error('Unknown agent hosting provider type: ' + agentHostingConfig.type);\n return null;\n }\n }\n};\n", "//\n// Copyright 2020 DXOS.org\n//\n\nimport React, {\n forwardRef,\n type FunctionComponent,\n type PropsWithChildren,\n useEffect,\n useImperativeHandle,\n useState,\n} from 'react';\n\nimport { Client, type ClientOptions, type ClientServicesProvider, SystemStatus } from '@dxos/client';\nimport { type Config } from '@dxos/config';\nimport { registerSignalsRuntime } from '@dxos/echo-signals/react';\nimport { log } from '@dxos/log';\nimport { useControlledValue } from '@dxos/react-hooks';\nimport { getAsyncProviderValue, type MaybePromise, type Provider } from '@dxos/util';\n\nimport { ClientContext, type ClientContextProps } from './context';\nimport { printBanner } from '../banner';\n\n/**\n * Properties for the ClientProvider.\n */\nexport type ClientProviderProps = Omit<ClientOptions, 'config' | 'services'> &\n Pick<ClientContextProps, 'status'> &\n PropsWithChildren<{\n /**\n * Client object or async provider to enable to caller to do custom initialization.\n *\n * NOTE: For advanced use cases only.\n */\n client?: Client | Provider<Promise<Client>>;\n\n /**\n * Config object or async provider.\n *\n * NOTE: If a `client` is provided then `config` is ignored.\n */\n // TODO(burdon): Reconcile with ClientOptions.\n config?: Config | Provider<Promise<Config>>;\n\n /**\n * Callback to enable the caller to create a custom ClientServicesProvider.\n *\n * NOTE: If a `client` is provided then `services` is ignored.\n */\n // TODO(burdon): Reconcile with ClientOptions.\n services?: ClientServicesProvider | ((config?: Config) => MaybePromise<ClientServicesProvider>);\n\n /**\n * ReactNode to display until the client is available.\n */\n fallback?: FunctionComponent<Partial<ClientContextProps>>;\n\n /**\n * Enable (by default) registration of Preact signals runtime for reactive ECHO objects.\n * @see https://www.npmjs.com/package/@preact/signals-react\n */\n signalsRuntime?: boolean;\n\n /**\n * Skip the DXOS banner.\n */\n noBanner?: boolean;\n\n /**\n * Post initialization hook to enable to caller to do custom initialization.\n */\n onInitialized?: (client: Client) => MaybePromise<void>;\n }>;\n\n/**\n * Root component that provides the DXOS client instance to child components.\n * To be used with the `useClient` hook.\n */\nexport const ClientProvider = forwardRef<Client | undefined, ClientProviderProps>(\n (\n {\n children,\n config: configProvider,\n client: clientProvider,\n services: servicesProvider,\n status: controlledStatus,\n fallback: Fallback = () => null,\n signalsRuntime = true,\n noBanner,\n onInitialized,\n ...options\n },\n forwardedRef,\n ) => {\n useEffect(() => {\n // TODO(wittjosiah): Ideally this should be imported asynchronously because it is optional.\n // Unfortunately, async import seemed to break signals React instrumentation.\n signalsRuntime && registerSignalsRuntime();\n }, []);\n\n // The client is initialized asynchronously.\n // If an error occurs during initialization, it is caught and the state is set.\n // This allows the error to be thrown in the render method.\n // The assumption is that a client initialization error is fatal to the app.\n // This error will be caught by the nearest error boundary.\n const [error, setError] = useState();\n if (error) {\n throw error;\n }\n\n const [client, setClient] = useState(clientProvider instanceof Client ? clientProvider : undefined);\n\n // Provide external access.\n useImperativeHandle(forwardedRef, () => client, [client]);\n\n // Client status subscription.\n const [status, setStatus] = useControlledValue(controlledStatus);\n useEffect(() => {\n if (!client) {\n return;\n }\n\n const subscription = client.status.subscribe((status) => setStatus(status));\n return () => subscription.unsubscribe();\n }, [client]);\n\n // Create and/or initialize client.\n useEffect(() => {\n const initialize = async (client: Client) => {\n if (!client.initialized) {\n await client.initialize().catch(setError);\n log('client ready');\n await onInitialized?.(client);\n log('initialization complete');\n }\n\n setClient(client);\n\n if (!noBanner) {\n printBanner(client);\n }\n };\n\n let client: Client;\n const t = setTimeout(async () => {\n if (clientProvider) {\n // Asynchronously request client.\n client = await getAsyncProviderValue(clientProvider);\n await initialize(client);\n } else {\n // Asynchronously construct client (config may be undefined).\n const config = await getAsyncProviderValue(configProvider);\n log('resolved config', { config });\n const services = await getAsyncProviderValue(servicesProvider, config);\n log('created services', { services });\n client = new Client({ config, services, ...options });\n log('created client');\n await initialize(client);\n }\n });\n\n return () => {\n log('clean up');\n clearTimeout(t);\n void client\n ?.destroy()\n .then(() => {\n log('destroyed');\n })\n .catch((err) => log.catch(err));\n };\n }, [configProvider, clientProvider, servicesProvider, noBanner]);\n\n if (!client?.initialized || status !== SystemStatus.ACTIVE) {\n return <Fallback client={client} status={status} />;\n }\n\n return <ClientContext.Provider value={{ client, status }}>{children}</ClientContext.Provider>;\n },\n);\n", "//\n// Copyright 2020 DXOS.org\n//\n\nimport { type Context, createContext } from 'react';\n\nimport { type Client, type SystemStatus } from '@dxos/client';\n\nexport type ClientContextProps = {\n client: Client;\n status?: SystemStatus | null;\n};\n\n/**\n * @internal Use ClientProvider to create or initialize the Client.\n */\nexport const ClientContext: Context<ClientContextProps | undefined> = createContext<ClientContextProps | undefined>(\n undefined,\n);\n", "//\n// Copyright 2021 DXOS.org\n//\n\nimport { type Client } from '@dxos/client';\n\n// http://patorjk.com/software/taag/#p=testall&f=Patorjk-HeX&t=DXOS\nconst BANNER = (client: Client) => {\n const commitHash = client.config.get('runtime.app.build.commitHash');\n const hash = commitHash ? ` App Commit ${commitHash} \\n` : '';\n\n return (\n '\\n' +\n '_/\\\\/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\______/\\\\/\\\\/\\\\/\\\\/\\\\_\\n' +\n '_/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\__/\\\\/\\\\_________\\n' +\n '_/\\\\/\\\\____/\\\\/\\\\______/\\\\/\\\\______/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\___\\n' +\n '_/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\__________/\\\\/\\\\_\\n' +\n '_/\\\\/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\/\\\\___\\n' +\n `\\n DXOS Client ${client.version} \\n${hash}`\n );\n};\n\nlet bannerPrinted = false;\n\nexport const printBanner = (client: Client) => {\n if (bannerPrinted) {\n return;\n }\n\n bannerPrinted = true;\n // eslint-disable-next-line no-console\n console.log(`%c${BANNER(client)}`, 'font-family: monospace;');\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from '../client/context';\n\n/**\n * Hook returning instance of DXOS client.\n * Requires ClientContext to be set via ClientProvider.\n */\nexport const useClient = () => {\n const { client } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n return client;\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type Client, type SystemStatus } from '@dxos/client';\n\nexport const useClientStatus = (client: Client) => {\n const [status, setStatus] = useState<SystemStatus | null>();\n useEffect(() => {\n if (!client) {\n return;\n }\n\n const subscription = client.status.subscribe((status) => setStatus(status));\n return () => subscription.unsubscribe();\n }, [client, setStatus]);\n\n return status;\n};\n", "//\n// Copyright 2020 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from './context';\n\n/**\n * Hook returning config object used to initialize the DXOS client instance.\n * Requires ClientContext to be set via ClientProvider.\n */\nexport const useConfig = () => {\n const { client } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n return client.config;\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type Shell, type ShellDisplay } from '@dxos/client';\n\nimport { useClient } from './useClient';\n\n/**\n * Helper hook to access the shell.\n */\nexport const useShell = (): Shell => {\n const client = useClient();\n return client.shell;\n};\n\n/**\n * Hook to access the shell’s display state.\n */\nexport const useShellDisplay = (): ShellDisplay => {\n const client = useClient();\n const [display, setDisplay] = useState(client.shell.display);\n useEffect(() => client.shell.onDisplayChange(setDisplay), [client]);\n return display;\n};\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { type SystemStatus } from '@dxos/client';\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from './context';\n\nexport const useStatus = (): SystemStatus | null | undefined => {\n const { status } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n return status;\n};\n"],
5
+ "mappings": "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",
6
+ "names": ["React", "createContext", "useContext", "useState", "AgentManagerClient", "FakeAgentHostingProvider", "log", "React", "forwardRef", "useEffect", "useImperativeHandle", "useState", "Client", "SystemStatus", "registerSignalsRuntime", "log", "useControlledValue", "getAsyncProviderValue", "createContext", "ClientContext", "createContext", "undefined", "BANNER", "client", "commitHash", "config", "get", "hash", "version", "bannerPrinted", "printBanner", "console", "log", "ClientProvider", "forwardRef", "children", "config", "configProvider", "client", "clientProvider", "services", "servicesProvider", "status", "controlledStatus", "fallback", "Fallback", "signalsRuntime", "noBanner", "onInitialized", "options", "forwardedRef", "useEffect", "registerSignalsRuntime", "error", "setError", "useState", "setClient", "Client", "undefined", "useImperativeHandle", "setStatus", "useControlledValue", "subscription", "subscribe", "unsubscribe", "initialize", "initialized", "catch", "log", "printBanner", "t", "setTimeout", "getAsyncProviderValue", "clearTimeout", "destroy", "then", "err", "SystemStatus", "ACTIVE", "ClientContext", "Provider", "value", "useContext", "raise", "useClient", "client", "useContext", "ClientContext", "raise", "Error", "useEffect", "useState", "useClientStatus", "client", "status", "setStatus", "useState", "useEffect", "subscription", "subscribe", "unsubscribe", "useContext", "raise", "useConfig", "client", "useContext", "ClientContext", "raise", "Error", "config", "useEffect", "useState", "useShell", "client", "useClient", "shell", "useShellDisplay", "display", "setDisplay", "useState", "useEffect", "onDisplayChange", "useContext", "raise", "useStatus", "status", "useContext", "ClientContext", "raise", "Error", "AgentHostingContext", "createContext", "AgentHostingProvider", "props", "client", "useClient", "agentHostingProviderClient", "useState", "makeClient", "React", "Provider", "value", "children", "useAgentHostingClient", "useContext", "config", "halo", "agentHostingConfig", "get", "log", "type", "FakeAgentHostingProvider", "AgentManagerClient", "init", "error"]
7
+ }
@@ -0,0 +1,165 @@
1
+ import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
2
+
3
+ // packages/sdk/react-client/src/invitations/index.ts
4
+ import { AuthenticatingInvitationObservable, CancellableInvitationObservable, InvitationEncoder as InvitationEncoder2, Invitation as Invitation2, InvitationsProxy } from "@dxos/client/invitations";
5
+
6
+ // packages/sdk/react-client/src/invitations/useInvitationStatus.ts
7
+ import { useReducer, useMemo, useCallback, useEffect } from "react";
8
+ import { Invitation, InvitationEncoder } from "@dxos/client/invitations";
9
+ import { log } from "@dxos/log";
10
+ var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/invitations/useInvitationStatus.ts";
11
+ var isShareableInvitation = (invitation) => invitation.authMethod !== Invitation.AuthMethod.KNOWN_PUBLIC_KEY || invitation.guestKeypair?.privateKey;
12
+ var useInvitationStatus = (observable) => {
13
+ const [state, dispatch] = useReducer((prev, action) => {
14
+ log("useInvitationStatus", {
15
+ action
16
+ }, {
17
+ F: __dxlog_file,
18
+ L: 90,
19
+ S: void 0,
20
+ C: (f, a) => f(...a)
21
+ });
22
+ const invitationProps = "invitation" in action ? {
23
+ id: action.invitation.invitationId,
24
+ multiUse: action.invitation.multiUse,
25
+ invitationCode: InvitationEncoder.encode(action.invitation),
26
+ authCode: action.invitation.authCode,
27
+ authMethod: action.invitation.authMethod,
28
+ shareable: isShareableInvitation(action.invitation),
29
+ type: action.invitation.type
30
+ } : {};
31
+ return {
32
+ ...prev,
33
+ ...invitationProps,
34
+ // TODO(burdon): State.
35
+ status: action.status,
36
+ // `invitationObservable`, `secret`, and `result` is persisted between the status-actions that set them.
37
+ result: action.status === Invitation.State.SUCCESS ? action.result : prev.result,
38
+ // `error` gets set each time we enter the error state
39
+ ...action.status === Invitation.State.ERROR && {
40
+ error: action.error
41
+ },
42
+ // `haltedAt` gets set on only the first error/cancelled/timeout action and reset on any others.
43
+ ...(action.status === Invitation.State.ERROR || action.status === Invitation.State.CANCELLED || action.status === Invitation.State.TIMEOUT) && {
44
+ haltedAt: typeof prev.haltedAt === "undefined" ? action.haltedAt : prev.haltedAt
45
+ }
46
+ };
47
+ }, null, (_arg) => {
48
+ const invitation = observable?.get();
49
+ return {
50
+ status: Invitation.State.INIT,
51
+ result: {
52
+ spaceKey: null,
53
+ identityKey: null,
54
+ swarmKey: null,
55
+ target: null
56
+ },
57
+ id: invitation?.invitationId,
58
+ multiUse: invitation?.multiUse,
59
+ invitationCode: invitation ? InvitationEncoder.encode(invitation) : void 0,
60
+ authCode: invitation?.authCode,
61
+ authMethod: invitation?.authMethod,
62
+ shareable: invitation ? isShareableInvitation(invitation) : false,
63
+ type: invitation?.type
64
+ };
65
+ });
66
+ useEffect(() => {
67
+ const update = (invitation) => {
68
+ switch (invitation.state) {
69
+ case Invitation.State.INIT:
70
+ case Invitation.State.CONNECTED:
71
+ case Invitation.State.READY_FOR_AUTHENTICATION:
72
+ case Invitation.State.AUTHENTICATING: {
73
+ dispatch({
74
+ invitation,
75
+ status: invitation.state
76
+ });
77
+ break;
78
+ }
79
+ case Invitation.State.SUCCESS: {
80
+ dispatch({
81
+ invitation,
82
+ status: invitation.state,
83
+ result: {
84
+ spaceKey: invitation.spaceKey || null,
85
+ identityKey: invitation.identityKey || null,
86
+ swarmKey: invitation.swarmKey || null,
87
+ target: invitation.target || null
88
+ }
89
+ });
90
+ break;
91
+ }
92
+ case Invitation.State.CANCELLED:
93
+ case Invitation.State.TIMEOUT: {
94
+ dispatch({
95
+ invitation,
96
+ status: invitation.state,
97
+ haltedAt: state.status
98
+ });
99
+ break;
100
+ }
101
+ }
102
+ };
103
+ const subscription = observable?.subscribe(update, (err) => {
104
+ dispatch({
105
+ status: Invitation.State.ERROR,
106
+ error: err,
107
+ haltedAt: state.status
108
+ });
109
+ });
110
+ const currentState = observable?.get();
111
+ if (currentState) {
112
+ update(currentState);
113
+ }
114
+ return () => subscription?.unsubscribe();
115
+ }, [
116
+ observable,
117
+ state.status
118
+ ]);
119
+ const connect = useCallback((observable2) => {
120
+ dispatch({
121
+ invitation: observable2.get(),
122
+ status: Invitation.State.CONNECTING,
123
+ observable: observable2
124
+ });
125
+ }, []);
126
+ const authenticate = useCallback((authCode) => {
127
+ log("authenticating...", {
128
+ authCode
129
+ }, {
130
+ F: __dxlog_file,
131
+ L: 195,
132
+ S: void 0,
133
+ C: (f, a) => f(...a)
134
+ });
135
+ return observable.authenticate(authCode);
136
+ }, [
137
+ observable
138
+ ]);
139
+ const cancel = useCallback(async () => observable?.cancel(), [
140
+ observable
141
+ ]);
142
+ return useMemo(() => {
143
+ return {
144
+ ...state,
145
+ cancel,
146
+ connect,
147
+ authenticate
148
+ };
149
+ }, [
150
+ state,
151
+ cancel,
152
+ connect,
153
+ authenticate
154
+ ]);
155
+ };
156
+
157
+ export {
158
+ useInvitationStatus,
159
+ AuthenticatingInvitationObservable,
160
+ CancellableInvitationObservable,
161
+ InvitationEncoder2 as InvitationEncoder,
162
+ Invitation2 as Invitation,
163
+ InvitationsProxy
164
+ };
165
+ //# sourceMappingURL=chunk-UYJUBYMU.mjs.map
@@ -0,0 +1,7 @@
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 { useReducer, type Reducer, useMemo, useCallback, useEffect } 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", "useReducer", "useMemo", "useCallback", "useEffect", "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
+ }
@@ -0,0 +1,44 @@
1
+ import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
2
+ import {
3
+ useClient
4
+ } from "../chunk-E5UAY5Z4.mjs";
5
+
6
+ // packages/sdk/react-client/src/devtools/index.ts
7
+ export * from "@dxos/client/devtools";
8
+
9
+ // packages/sdk/react-client/src/devtools/useDevtools.ts
10
+ import { raise } from "@dxos/debug";
11
+ var useDevtools = () => {
12
+ const client = useClient();
13
+ return client.services.services.DevtoolsHost ?? raise(new Error("DevtoolsHost not available."));
14
+ };
15
+
16
+ // packages/sdk/react-client/src/devtools/useStream.ts
17
+ import { useState, useEffect } from "react";
18
+ import { log } from "@dxos/log";
19
+ var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/devtools/useStream.ts";
20
+ var useStream = (streamFactory, defaultValue, deps = []) => {
21
+ const [value, setValue] = useState(defaultValue);
22
+ useEffect(() => {
23
+ const stream = streamFactory();
24
+ stream.subscribe((response) => setValue(response), (err) => {
25
+ if (err) {
26
+ log.catch(err, void 0, {
27
+ F: __dxlog_file,
28
+ L: 21,
29
+ S: void 0,
30
+ C: (f, a) => f(...a)
31
+ });
32
+ }
33
+ });
34
+ return () => {
35
+ void stream.close();
36
+ };
37
+ }, deps);
38
+ return value ?? defaultValue;
39
+ };
40
+ export {
41
+ useDevtools,
42
+ useStream
43
+ };
44
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../src/devtools/index.ts", "../../../../src/devtools/useDevtools.ts", "../../../../src/devtools/useStream.ts"],
4
+ "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nexport * from '@dxos/client/devtools';\n\nexport * from './useDevtools';\nexport * from './useStream';\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { type DevtoolsHost } from '@dxos/client/devtools';\nimport { raise } from '@dxos/debug';\n\nimport { useClient } from '../client';\n\nexport const useDevtools = (): DevtoolsHost => {\n const client = useClient();\n return client.services.services.DevtoolsHost ?? raise(new Error('DevtoolsHost not available.'));\n};\n", "//\n// Copyright 2021 DXOS.org\n//\n\nimport { type DependencyList, useState, useEffect } from 'react';\n\nimport { type Stream } from '@dxos/codec-protobuf';\nimport { log } from '@dxos/log';\n\n/**\n * Subscribe to service API streams.\n */\nexport const useStream = <T>(streamFactory: () => Stream<T>, defaultValue: T, deps: DependencyList = []): T => {\n const [value, setValue] = useState<T | undefined>(defaultValue);\n useEffect(() => {\n const stream = streamFactory();\n stream.subscribe(\n (response: T) => setValue(response),\n (err) => {\n if (err) {\n log.catch(err);\n }\n },\n );\n\n return () => {\n void stream.close();\n };\n }, deps);\n\n return value ?? defaultValue;\n};\n"],
5
+ "mappings": ";;;;;;AAIA,cAAc;;;ACCd,SAASA,aAAa;AAIf,IAAMC,cAAc,MAAA;AACzB,QAAMC,SAASC,UAAAA;AACf,SAAOD,OAAOE,SAASA,SAASC,gBAAgBC,MAAM,IAAIC,MAAM,6BAAA,CAAA;AAClE;;;ACRA,SAA8BC,UAAUC,iBAAiB;AAGzD,SAASC,WAAW;;AAKb,IAAMC,YAAY,CAAIC,eAAgCC,cAAiBC,OAAuB,CAAA,MAAE;AACrG,QAAM,CAACC,OAAOC,QAAAA,IAAYR,SAAwBK,YAAAA;AAClDJ,YAAU,MAAA;AACR,UAAMQ,SAASL,cAAAA;AACfK,WAAOC,UACL,CAACC,aAAgBH,SAASG,QAAAA,GAC1B,CAACC,QAAAA;AACC,UAAIA,KAAK;AACPV,YAAIW,MAAMD,KAAAA,QAAAA;;;;;;MACZ;IACF,CAAA;AAGF,WAAO,MAAA;AACL,WAAKH,OAAOK,MAAK;IACnB;EACF,GAAGR,IAAAA;AAEH,SAAOC,SAASF;AAClB;",
6
+ "names": ["raise", "useDevtools", "client", "useClient", "services", "DevtoolsHost", "raise", "Error", "useState", "useEffect", "log", "useStream", "streamFactory", "defaultValue", "deps", "value", "setValue", "stream", "subscribe", "response", "err", "catch", "close"]
7
+ }