@dxos/react-client 0.8.3 → 0.8.4-main.3f58842

package/moon.yml

@@ -0,0 +1,19 @@
+type: library
+language: typescript
+tags:
+  - e2e
+  - ts-build
+  - ts-test
+  - typedoc
+  - pack
+tasks:
+  compile:
+    args:
+      - '--entryPoint=src/devtools/index.ts'
+      - '--entryPoint=src/echo/index.ts'
+      - '--entryPoint=src/halo/index.ts'
+      - '--entryPoint=src/index.ts'
+      - '--entryPoint=src/invitations/index.ts'
+      - '--entryPoint=src/mesh/index.ts'
+      - '--entryPoint=src/testing/index.ts'
+      - '--entryPoint=src/worker.ts'

package/package.json

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

package/src/echo/useSyncState.ts

@@ -30,7 +30,7 @@ export const useSyncState = (): SpaceSyncStateMap => {
         }
 
         ctx.onDispose(
-          space.crud.subscribeToSyncState(ctx, ({ peers = [] }) => {
+          space.db.subscribeToSyncState(ctx, ({ peers = [] }) => {
             const syncState = peers.find((state) => isEdgePeerId(state.peerId, space.id));
             if (syncState) {
               setSpaceState((spaceState) => ({ ...spaceState, [space.id]: syncState }));
@@ -62,7 +62,7 @@ export const useSpaceSyncState = (space: Space): PeerSyncState | undefined => {
 
   useEffect(() => {
     const ctx = new Context();
-    space.crud.subscribeToSyncState(ctx, ({ peers = [] }) => {
+    space.db.subscribeToSyncState(ctx, ({ peers = [] }) => {
       const syncState = peers.find((state) => isEdgePeerId(state.peerId, space.id));
       if (syncState) {
         setSpaceState(syncState);

package/src/playwright/playwright.config.ts

@@ -0,0 +1,17 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { defineConfig } from '@playwright/test';
+
+import { e2ePreset } from '@dxos/test-utils/playwright';
+
+export default defineConfig({
+  ...e2ePreset(import.meta.dirname),
+  // TODO(wittjosiah): Avoid hard-coding ports.
+  webServer: {
+    command: 'moon run storybook:serve-e2e -- --port=9000',
+    port: 9000,
+    reuseExistingServer: false,
+  },
+});

package/src/playwright/smoke.spec.ts

@@ -4,17 +4,15 @@
 
 import { type Page, expect, test } from '@playwright/test';
 
-import { setupPage } from '@dxos/test-utils/playwright';
-
-// TODO(wittjosiah): Factor out.
-// TODO(burdon): No hard-coding of ports; reconcile all DXOS tools ports.
-const storybookUrl = (storyId: string) => `http://localhost:9009/iframe.html?id=${storyId}&viewMode=story`;
+import { setupPage, storybookUrl } from '@dxos/test-utils/playwright';
 
 test.describe('Smoke test', () => {
   let page: Page;
 
   test.beforeAll(async ({ browser }) => {
-    const result = await setupPage(browser, { url: storybookUrl('sdk-react-client-withclientprovider--default') });
+    const result = await setupPage(browser, {
+      url: storybookUrl('sdk-react-client-withclientprovider--default', 9000),
+    });
     page = result.page;
     await page.locator(':text("initialized")').waitFor({ state: 'visible' });
   });

package/vitest.config.ts

@@ -4,7 +4,7 @@
 
 import { defineConfig, mergeConfig } from 'vitest/config';
 
-import { baseConfig } from '../../../vitest.shared';
+import { baseConfig } from '../../../vitest.base.config';
 
 // TODO(wittjosiah): Factor out to shared config as an option.
 const specifiedEnv = (process.env.VITEST_ENV ?? 'node').toLowerCase();

package/.eslintrc.cjs

@@ -1,12 +0,0 @@
-module.exports = {
-  "extends": [
-    "../../../.eslintrc.js"
-  ],
-  "parserOptions": {
-    "project": "tsconfig.json",
-    "tsconfigRootDir": __dirname,
-  },
-  "ignorePatterns": [
-    "**/*.d.ts"
-  ]
-}

package/README.yml

@@ -1,33 +0,0 @@
-usage: |
-  The snippet below illustrates a self-contained DXOS application that uses providers to create the client and instantiate a user profile.
-
-  ```javascript
-
-  import React from 'react';
-  import { useClient, ClientProvider } from '@dxos/react-client';
-  import { createRoot } from 'react-dom/client';
-
-  const App = () => {
-    const client = useClient();
-    const space = useSpaces();
-    return (
-      <pre>{JSON.stringify(client.info())}</pre>
-    );
-  };
-
-  const Root = () => (
-    <ClientProvider>
-      <App />
-    </ClientProvider>
-  );
-
-  createRoot(document.getElementById('root')!)
-    .render(<Root/>);
-  
-  ```
-storybooks:
-  - "The [HALO Invitation Story](./stories/halo-invitations.stories.tsx) demonstrates multiple clients (devices) joining the same HALO. [Demo video](https://user-images.githubusercontent.com/3523355/137532718-a21f1f27-9854-4c0b-831a-e9ff92feac49.mov)."
-  - "The [Space Invitation Story](./stories/space-invitations.stories.tsx) demonstrates multiple clients creating and sharing spaces. [Demo video](https://user-images.githubusercontent.com/3523355/137532717-e77395dc-96f9-4e4b-8f67-e6bd026a3abe.mov)."
-quickStartUrl: https://docs.dxos.org/guide/quick-start
-guideUrl: https://docs.dxos.org/guide/echo/react
-apiReferenceUrl: true

package/dist/lib/node/chunk-5RUIFUEC.cjs

@@ -1,334 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var chunk_5RUIFUEC_exports = {};
-__export(chunk_5RUIFUEC_exports, {
-  AgentHostingContext: () => AgentHostingContext,
-  AgentHostingProvider: () => AgentHostingProvider,
-  ClientContext: () => ClientContext,
-  ClientProvider: () => ClientProvider,
-  useAgentHostingClient: () => useAgentHostingClient,
-  useClient: () => useClient,
-  useClientStatus: () => useClientStatus,
-  useConfig: () => useConfig,
-  useShell: () => useShell,
-  useShellDisplay: () => useShellDisplay,
-  useStatus: () => useStatus
-});
-module.exports = __toCommonJS(chunk_5RUIFUEC_exports);
-var import_react = __toESM(require("react"));
-var import_client = require("@dxos/client");
-var import_log = require("@dxos/log");
-var import_react2 = __toESM(require("react"));
-var import_client2 = require("@dxos/client");
-var import_react3 = require("@dxos/echo-signals/react");
-var import_log2 = require("@dxos/log");
-var import_react_hooks = require("@dxos/react-hooks");
-var import_util = require("@dxos/util");
-var import_react4 = require("react");
-var import_react5 = require("react");
-var import_debug = require("@dxos/debug");
-var import_react6 = require("react");
-var import_react7 = require("react");
-var import_debug2 = require("@dxos/debug");
-var import_react8 = require("react");
-var import_react9 = require("react");
-var import_debug3 = require("@dxos/debug");
-var ClientContext = (0, import_react4.createContext)(void 0);
-var BANNER = (client) => {
-  const commitHash = client.config.get("runtime.app.build.commitHash");
-  const hash = commitHash ? ` App Commit ${commitHash} 
-` : "";
-  return `
-_/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\______/\\/\\/\\/\\/\\_
-_/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__/\\/\\_________
-_/\\/\\____/\\/\\______/\\/\\______/\\/\\____/\\/\\____/\\/\\/\\/\\___
-_/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\____/\\/\\__________/\\/\\_
-_/\\/\\/\\/\\/\\____/\\/\\____/\\/\\____/\\/\\/\\/\\____/\\/\\/\\/\\/\\___
-
- DXOS Client ${client.version} 
-${hash}`;
-};
-var bannerPrinted = false;
-var printBanner = (client) => {
-  if (bannerPrinted || window.location.hostname === "localhost") {
-    return;
-  }
-  bannerPrinted = true;
-  console.log(`%c${BANNER(client)}`, "font-family: monospace;");
-};
-var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/client/ClientProvider.tsx";
-var ClientProvider = /* @__PURE__ */ (0, import_react2.forwardRef)(({ children, config: configProvider, client: clientProvider, services: servicesProvider, status: controlledStatus, fallback: Fallback = () => null, signalsRuntime = true, noBanner, onInitialized, ...options }, forwardedRef) => {
-  (0, import_react2.useEffect)(() => {
-    signalsRuntime && (0, import_react3.registerSignalsRuntime)();
-  }, []);
-  const [error, setError] = (0, import_react2.useState)();
-  if (error) {
-    throw error;
-  }
-  const [client, setClient] = (0, import_react2.useState)(clientProvider instanceof import_client2.Client ? clientProvider : void 0);
-  (0, import_react2.useImperativeHandle)(forwardedRef, () => client, [
-    client
-  ]);
-  const [status, setStatus] = (0, import_react_hooks.useControlledState)(controlledStatus);
-  (0, import_react2.useEffect)(() => {
-    if (!client) {
-      return;
-    }
-    const subscription = client.status.subscribe((status2) => setStatus(status2));
-    return () => subscription.unsubscribe();
-  }, [
-    client
-  ]);
-  (0, import_react2.useEffect)(() => {
-    let disposed = false;
-    const initialize = async (client3) => {
-      if (!client3.initialized) {
-        await client3.initialize().catch((err) => {
-          if (!disposed) {
-            setError(err);
-          }
-        });
-        (0, import_log2.log)("client ready", void 0, {
-          F: __dxlog_file,
-          L: 137,
-          S: void 0,
-          C: (f, a) => f(...a)
-        });
-        await onInitialized?.(client3);
-        (0, import_log2.log)("initialization complete", void 0, {
-          F: __dxlog_file,
-          L: 139,
-          S: void 0,
-          C: (f, a) => f(...a)
-        });
-      }
-      setClient(client3);
-      if (!noBanner) {
-        printBanner(client3);
-      }
-    };
-    let client2;
-    const t = setTimeout(async () => {
-      try {
-        if (clientProvider) {
-          client2 = await (0, import_util.getAsyncProviderValue)(clientProvider);
-          await initialize(client2);
-        } else {
-          const config = await (0, import_util.getAsyncProviderValue)(configProvider);
-          (0, import_log2.log)("resolved config", {
-            config
-          }, {
-            F: __dxlog_file,
-            L: 159,
-            S: void 0,
-            C: (f, a) => f(...a)
-          });
-          const services = await (0, import_util.getAsyncProviderValue)(servicesProvider, config);
-          (0, import_log2.log)("created services", {
-            services
-          }, {
-            F: __dxlog_file,
-            L: 161,
-            S: void 0,
-            C: (f, a) => f(...a)
-          });
-          client2 = new import_client2.Client({
-            config,
-            services,
-            ...options
-          });
-          (0, import_log2.log)("created client", void 0, {
-            F: __dxlog_file,
-            L: 163,
-            S: void 0,
-            C: (f, a) => f(...a)
-          });
-          await initialize(client2);
-        }
-      } catch (err) {
-        if (!disposed) {
-          import_log2.log.catch(err, void 0, {
-            F: __dxlog_file,
-            L: 168,
-            S: void 0,
-            C: (f, a) => f(...a)
-          });
-        }
-      }
-    });
-    return () => {
-      (0, import_log2.log)("clean up", void 0, {
-        F: __dxlog_file,
-        L: 174,
-        S: void 0,
-        C: (f, a) => f(...a)
-      });
-      disposed = true;
-      clearTimeout(t);
-      if (!clientProvider) {
-        void client2?.destroy().then(() => {
-          (0, import_log2.log)("destroyed", void 0, {
-            F: __dxlog_file,
-            L: 182,
-            S: void 0,
-            C: (f, a) => f(...a)
-          });
-        }).catch((err) => import_log2.log.catch(err, void 0, {
-          F: __dxlog_file,
-          L: 184,
-          S: void 0,
-          C: (f, a) => f(...a)
-        }));
-      }
-    };
-  }, [
-    configProvider,
-    clientProvider,
-    servicesProvider,
-    noBanner
-  ]);
-  if (!client?.initialized || status !== import_client2.SystemStatus.ACTIVE) {
-    return /* @__PURE__ */ import_react2.default.createElement(Fallback, {
-      client,
-      status
-    });
-  }
-  return /* @__PURE__ */ import_react2.default.createElement(ClientContext.Provider, {
-    value: {
-      client,
-      status
-    }
-  }, children);
-});
-var useClient = () => {
-  const { client } = (0, import_react5.useContext)(ClientContext) ?? (0, import_debug.raise)(new Error("Missing ClientContext."));
-  return client;
-};
-var useClientStatus = (client) => {
-  const [status, setStatus] = (0, import_react6.useState)();
-  (0, import_react6.useEffect)(() => {
-    if (!client) {
-      return;
-    }
-    const subscription = client.status.subscribe((status2) => setStatus(status2));
-    return () => subscription.unsubscribe();
-  }, [
-    client,
-    setStatus
-  ]);
-  return status;
-};
-var useConfig = () => {
-  const { client } = (0, import_react7.useContext)(ClientContext) ?? (0, import_debug2.raise)(new Error("Missing ClientContext."));
-  return client.config;
-};
-var useShell = () => {
-  const client = useClient();
-  return client.shell;
-};
-var useShellDisplay = () => {
-  const client = useClient();
-  const [display, setDisplay] = (0, import_react8.useState)(client.shell.display);
-  (0, import_react8.useEffect)(() => client.shell.onDisplayChange(setDisplay), [
-    client
-  ]);
-  return display;
-};
-var useStatus = () => {
-  const { status } = (0, import_react9.useContext)(ClientContext) ?? (0, import_debug3.raise)(new Error("Missing ClientContext."));
-  return status;
-};
-var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/client/AgentHostingProvider.tsx";
-var AgentHostingContext = /* @__PURE__ */ (0, import_react.createContext)(null);
-var AgentHostingProvider = (props) => {
-  const client = useClient();
-  const [agentHostingProviderClient] = (0, import_react.useState)(makeClient(client));
-  return /* @__PURE__ */ import_react.default.createElement(AgentHostingContext.Provider, {
-    value: agentHostingProviderClient
-  }, " ", props.children);
-};
-var useAgentHostingClient = () => {
-  return (0, import_react.useContext)(AgentHostingContext);
-};
-var makeClient = ({ config, halo }) => {
-  const agentHostingConfig = config.get("runtime.services.agentHosting");
-  if (!agentHostingConfig) {
-    (0, import_log.log)("no agent hosting configured", void 0, {
-      F: __dxlog_file2,
-      L: 39,
-      S: void 0,
-      C: (f, a) => f(...a)
-    });
-    return null;
-  }
-  let agentHostingProviderClient = null;
-  switch (agentHostingConfig.type) {
-    case "LOCAL_TESTING": {
-      (0, import_log.log)("using FakeAgentHostingProvider", void 0, {
-        F: __dxlog_file2,
-        L: 47,
-        S: void 0,
-        C: (f, a) => f(...a)
-      });
-      return new import_client.FakeAgentHostingProvider();
-    }
-    case "AGENTHOSTING_API": {
-      agentHostingProviderClient = new import_client.AgentManagerClient(config, halo);
-      if (agentHostingProviderClient.init()) {
-        return agentHostingProviderClient;
-      } else {
-        return null;
-      }
-    }
-    default: {
-      import_log.log.error("Unknown agent hosting provider type: " + agentHostingConfig.type, void 0, {
-        F: __dxlog_file2,
-        L: 62,
-        S: void 0,
-        C: (f, a) => f(...a)
-      });
-      return null;
-    }
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AgentHostingContext,
-  AgentHostingProvider,
-  ClientContext,
-  ClientProvider,
-  useAgentHostingClient,
-  useClient,
-  useClientStatus,
-  useConfig,
-  useShell,
-  useShellDisplay,
-  useStatus
-});
-//# sourceMappingURL=chunk-5RUIFUEC.cjs.map

package/dist/lib/node/chunk-5RUIFUEC.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 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"],
-  "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 { useControlledState } 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] = useControlledState(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      let disposed = false;\n      const initialize = async (client: Client) => {\n        if (!client.initialized) {\n          await client.initialize().catch((err) => {\n            if (!disposed) {\n              setError(err);\n            }\n          });\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        try {\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        } catch (err) {\n          if (!disposed) {\n            log.catch(err);\n          }\n        }\n      });\n\n      return () => {\n        log('clean up');\n        disposed = true;\n        clearTimeout(t);\n        // Only destroy if the client is not provided by the parent.\n        if (!clientProvider) {\n          void client\n            ?.destroy()\n            .then(() => {\n              log('destroyed');\n            })\n            .catch((err) => log.catch(err));\n        }\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 || window.location.hostname === 'localhost') {\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"],
-  "mappings": "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",
-  "names": ["import_react", "import_client", "import_log", "import_debug", "ClientContext", "createContext", "undefined", "BANNER", "client", "commitHash", "config", "get", "hash", "version", "bannerPrinted", "printBanner", "window", "location", "hostname", "console", "log", "ClientProvider", "forwardRef", "children", "configProvider", "clientProvider", "services", "servicesProvider", "status", "controlledStatus", "fallback", "Fallback", "signalsRuntime", "noBanner", "onInitialized", "options", "forwardedRef", "useEffect", "registerSignalsRuntime", "error", "setError", "useState", "setClient", "Client", "useImperativeHandle", "setStatus", "useControlledState", "subscription", "subscribe", "unsubscribe", "disposed", "initialize", "initialized", "catch", "err", "t", "setTimeout", "getAsyncProviderValue", "clearTimeout", "destroy", "then", "SystemStatus", "ACTIVE", "React", "Provider", "value", "useClient", "useContext", "raise", "Error", "useClientStatus", "useConfig", "useShell", "shell", "useShellDisplay", "display", "setDisplay", "onDisplayChange", "useStatus", "AgentHostingContext", "AgentHostingProvider", "props", "agentHostingProviderClient", "makeClient", "useAgentHostingClient", "halo", "agentHostingConfig", "type", "FakeAgentHostingProvider", "AgentManagerClient", "init"]
-}