@dxos/react-client 0.6.13 → 0.6.14-main.2b6a0f3

package/dist/lib/node-esm/chunk-KVEEO6SV.mjs

@@ -0,0 +1,168 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  ClientContext
+} from "./chunk-UPS353EF.mjs";
+
+// packages/sdk/react-client/src/client/ClientProvider.tsx
+import React, { forwardRef, useEffect, useImperativeHandle, useState } from "react";
+import { Client, SystemStatus } from "@dxos/client";
+import { registerSignalsRuntime } from "@dxos/echo-signals/react";
+import { log } from "@dxos/log";
+import { useControlledValue } from "@dxos/react-hooks";
+import { getAsyncProviderValue } from "@dxos/util";
+
+// packages/sdk/react-client/src/banner.ts
+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) {
+    return;
+  }
+  bannerPrinted = true;
+  console.log(`%c${BANNER(client)}`, "font-family: monospace;");
+};
+
+// packages/sdk/react-client/src/client/ClientProvider.tsx
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/client/ClientProvider.tsx";
+var ClientProvider = /* @__PURE__ */ forwardRef(({ children, config: configProvider, client: clientProvider, services: servicesProvider, status: controlledStatus, fallback: Fallback = () => null, signalsRuntime = true, noBanner, onInitialized, ...options }, forwardedRef) => {
+  useEffect(() => {
+    signalsRuntime && registerSignalsRuntime();
+  }, []);
+  const [error, setError] = useState();
+  if (error) {
+    throw error;
+  }
+  const [client, setClient] = useState(clientProvider instanceof Client ? clientProvider : void 0);
+  useImperativeHandle(forwardedRef, () => client, [
+    client
+  ]);
+  const [status, setStatus] = useControlledValue(controlledStatus);
+  useEffect(() => {
+    if (!client) {
+      return;
+    }
+    const subscription = client.status.subscribe((status2) => setStatus(status2));
+    return () => subscription.unsubscribe();
+  }, [
+    client
+  ]);
+  useEffect(() => {
+    const initialize = async (client3) => {
+      if (!client3.initialized) {
+        await client3.initialize().catch(setError);
+        log("client ready", void 0, {
+          F: __dxlog_file,
+          L: 134,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+        await onInitialized?.(client3);
+        log("initialization complete", void 0, {
+          F: __dxlog_file,
+          L: 136,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+      }
+      setClient(client3);
+      if (!noBanner) {
+        printBanner(client3);
+      }
+    };
+    let client2;
+    const t = setTimeout(async () => {
+      if (clientProvider) {
+        client2 = await getAsyncProviderValue(clientProvider);
+        await initialize(client2);
+      } else {
+        const config = await getAsyncProviderValue(configProvider);
+        log("resolved config", {
+          config
+        }, {
+          F: __dxlog_file,
+          L: 155,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+        const services = await getAsyncProviderValue(servicesProvider, config);
+        log("created services", {
+          services
+        }, {
+          F: __dxlog_file,
+          L: 157,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+        client2 = new Client({
+          config,
+          services,
+          ...options
+        });
+        log("created client", void 0, {
+          F: __dxlog_file,
+          L: 159,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+        await initialize(client2);
+      }
+    });
+    return () => {
+      log("clean up", void 0, {
+        F: __dxlog_file,
+        L: 165,
+        S: void 0,
+        C: (f, a) => f(...a)
+      });
+      clearTimeout(t);
+      void client2?.destroy().then(() => {
+        log("destroyed", void 0, {
+          F: __dxlog_file,
+          L: 170,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+      }).catch((err) => log.catch(err, void 0, {
+        F: __dxlog_file,
+        L: 172,
+        S: void 0,
+        C: (f, a) => f(...a)
+      }));
+    };
+  }, [
+    configProvider,
+    clientProvider,
+    servicesProvider,
+    noBanner
+  ]);
+  if (!client?.initialized || status !== SystemStatus.ACTIVE) {
+    return /* @__PURE__ */ React.createElement(Fallback, {
+      client,
+      status
+    });
+  }
+  return /* @__PURE__ */ React.createElement(ClientContext.Provider, {
+    value: {
+      client,
+      status
+    }
+  }, children);
+});
+
+export {
+  ClientProvider
+};
+//# sourceMappingURL=chunk-KVEEO6SV.mjs.map

package/dist/lib/node-esm/chunk-KVEEO6SV.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/client/ClientProvider.tsx", "../../../src/banner.ts"],
+  "sourcesContent": ["//\n// Copyright 2020 DXOS.org\n//\n\nimport React, {\n  type FunctionComponent,\n  type PropsWithChildren,\n  forwardRef,\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     * @param Client\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 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"],
+  "mappings": "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",
+  "names": ["React", "forwardRef", "useEffect", "useImperativeHandle", "useState", "Client", "SystemStatus", "registerSignalsRuntime", "log", "useControlledValue", "getAsyncProviderValue", "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"]
+}

package/dist/lib/node-esm/chunk-QNHFZM3T.mjs

@@ -0,0 +1,17 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  ClientContext
+} from "./chunk-UPS353EF.mjs";
+
+// packages/sdk/react-client/src/client/useClient.ts
+import { useContext } from "react";
+import { raise } from "@dxos/debug";
+var useClient = () => {
+  const { client } = useContext(ClientContext) ?? raise(new Error("Missing ClientContext."));
+  return client;
+};
+
+export {
+  useClient
+};
+//# sourceMappingURL=chunk-QNHFZM3T.mjs.map

package/dist/lib/node-esm/chunk-QNHFZM3T.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/client/useClient.ts"],
+  "sourcesContent": ["//\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"],
+  "mappings": ";;;;;;AAIA,SAASA,kBAAkB;AAE3B,SAASC,aAAa;AAQf,IAAMC,YAAY,MAAA;AACvB,QAAM,EAAEC,OAAM,IAAKC,WAAWC,aAAAA,KAAkBC,MAAM,IAAIC,MAAM,wBAAA,CAAA;AAChE,SAAOJ;AACT;",
+  "names": ["useContext", "raise", "useClient", "client", "useContext", "ClientContext", "raise", "Error"]
+}

package/dist/lib/node-esm/chunk-UPS353EF.mjs

@@ -0,0 +1,10 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+
+// packages/sdk/react-client/src/client/context.ts
+import { createContext } from "react";
+var ClientContext = createContext(void 0);
+
+export {
+  ClientContext
+};
+//# sourceMappingURL=chunk-UPS353EF.mjs.map

package/dist/lib/node-esm/chunk-UPS353EF.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/client/context.ts"],
+  "sourcesContent": ["//\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"],
+  "mappings": ";;;AAIA,SAAuBA,qBAAqB;AAYrC,IAAMC,gBAAyDC,cACpEC,MAAAA;",
+  "names": ["createContext", "ClientContext", "createContext", "undefined"]
+}

package/dist/lib/node-esm/chunk-UYJUBYMU.mjs

@@ -0,0 +1,165 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+
+// packages/sdk/react-client/src/invitations/index.ts
+import { AuthenticatingInvitationObservable, CancellableInvitationObservable, InvitationEncoder as InvitationEncoder2, Invitation as Invitation2, InvitationsProxy } from "@dxos/client/invitations";
+
+// packages/sdk/react-client/src/invitations/useInvitationStatus.ts
+import { useReducer, useMemo, useCallback, useEffect } from "react";
+import { Invitation, InvitationEncoder } from "@dxos/client/invitations";
+import { log } from "@dxos/log";
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/invitations/useInvitationStatus.ts";
+var isShareableInvitation = (invitation) => invitation.authMethod !== Invitation.AuthMethod.KNOWN_PUBLIC_KEY || invitation.guestKeypair?.privateKey;
+var useInvitationStatus = (observable) => {
+  const [state, dispatch] = useReducer((prev, action) => {
+    log("useInvitationStatus", {
+      action
+    }, {
+      F: __dxlog_file,
+      L: 90,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+    const invitationProps = "invitation" in action ? {
+      id: action.invitation.invitationId,
+      multiUse: action.invitation.multiUse,
+      invitationCode: InvitationEncoder.encode(action.invitation),
+      authCode: action.invitation.authCode,
+      authMethod: action.invitation.authMethod,
+      shareable: isShareableInvitation(action.invitation),
+      type: action.invitation.type
+    } : {};
+    return {
+      ...prev,
+      ...invitationProps,
+      // TODO(burdon): State.
+      status: action.status,
+      // `invitationObservable`, `secret`, and `result` is persisted between the status-actions that set them.
+      result: action.status === Invitation.State.SUCCESS ? action.result : prev.result,
+      // `error` gets set each time we enter the error state
+      ...action.status === Invitation.State.ERROR && {
+        error: action.error
+      },
+      // `haltedAt` gets set on only the first error/cancelled/timeout action and reset on any others.
+      ...(action.status === Invitation.State.ERROR || action.status === Invitation.State.CANCELLED || action.status === Invitation.State.TIMEOUT) && {
+        haltedAt: typeof prev.haltedAt === "undefined" ? action.haltedAt : prev.haltedAt
+      }
+    };
+  }, null, (_arg) => {
+    const invitation = observable?.get();
+    return {
+      status: Invitation.State.INIT,
+      result: {
+        spaceKey: null,
+        identityKey: null,
+        swarmKey: null,
+        target: null
+      },
+      id: invitation?.invitationId,
+      multiUse: invitation?.multiUse,
+      invitationCode: invitation ? InvitationEncoder.encode(invitation) : void 0,
+      authCode: invitation?.authCode,
+      authMethod: invitation?.authMethod,
+      shareable: invitation ? isShareableInvitation(invitation) : false,
+      type: invitation?.type
+    };
+  });
+  useEffect(() => {
+    const update = (invitation) => {
+      switch (invitation.state) {
+        case Invitation.State.INIT:
+        case Invitation.State.CONNECTED:
+        case Invitation.State.READY_FOR_AUTHENTICATION:
+        case Invitation.State.AUTHENTICATING: {
+          dispatch({
+            invitation,
+            status: invitation.state
+          });
+          break;
+        }
+        case Invitation.State.SUCCESS: {
+          dispatch({
+            invitation,
+            status: invitation.state,
+            result: {
+              spaceKey: invitation.spaceKey || null,
+              identityKey: invitation.identityKey || null,
+              swarmKey: invitation.swarmKey || null,
+              target: invitation.target || null
+            }
+          });
+          break;
+        }
+        case Invitation.State.CANCELLED:
+        case Invitation.State.TIMEOUT: {
+          dispatch({
+            invitation,
+            status: invitation.state,
+            haltedAt: state.status
+          });
+          break;
+        }
+      }
+    };
+    const subscription = observable?.subscribe(update, (err) => {
+      dispatch({
+        status: Invitation.State.ERROR,
+        error: err,
+        haltedAt: state.status
+      });
+    });
+    const currentState = observable?.get();
+    if (currentState) {
+      update(currentState);
+    }
+    return () => subscription?.unsubscribe();
+  }, [
+    observable,
+    state.status
+  ]);
+  const connect = useCallback((observable2) => {
+    dispatch({
+      invitation: observable2.get(),
+      status: Invitation.State.CONNECTING,
+      observable: observable2
+    });
+  }, []);
+  const authenticate = useCallback((authCode) => {
+    log("authenticating...", {
+      authCode
+    }, {
+      F: __dxlog_file,
+      L: 195,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+    return observable.authenticate(authCode);
+  }, [
+    observable
+  ]);
+  const cancel = useCallback(async () => observable?.cancel(), [
+    observable
+  ]);
+  return useMemo(() => {
+    return {
+      ...state,
+      cancel,
+      connect,
+      authenticate
+    };
+  }, [
+    state,
+    cancel,
+    connect,
+    authenticate
+  ]);
+};
+
+export {
+  useInvitationStatus,
+  AuthenticatingInvitationObservable,
+  CancellableInvitationObservable,
+  InvitationEncoder2 as InvitationEncoder,
+  Invitation2 as Invitation,
+  InvitationsProxy
+};
+//# sourceMappingURL=chunk-UYJUBYMU.mjs.map

package/dist/lib/node-esm/chunk-UYJUBYMU.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/invitations/index.ts", "../../../src/invitations/useInvitationStatus.ts"],
+  "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"],
+  "mappings": "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",
+  "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"]
+}

package/dist/lib/node-esm/devtools/index.mjs

@@ -0,0 +1,45 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  useClient
+} from "../chunk-QNHFZM3T.mjs";
+import "../chunk-UPS353EF.mjs";
+
+// packages/sdk/react-client/src/devtools/index.ts
+export * from "@dxos/client/devtools";
+
+// packages/sdk/react-client/src/devtools/useDevtools.ts
+import { raise } from "@dxos/debug";
+var useDevtools = () => {
+  const client = useClient();
+  return client.services.services.DevtoolsHost ?? raise(new Error("DevtoolsHost not available."));
+};
+
+// packages/sdk/react-client/src/devtools/useStream.ts
+import { useState, useEffect } from "react";
+import { log } from "@dxos/log";
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/react-client/src/devtools/useStream.ts";
+var useStream = (streamFactory, defaultValue, deps = []) => {
+  const [value, setValue] = useState(defaultValue);
+  useEffect(() => {
+    const stream = streamFactory();
+    stream.subscribe((response) => setValue(response), (err) => {
+      if (err) {
+        log.catch(err, void 0, {
+          F: __dxlog_file,
+          L: 21,
+          S: void 0,
+          C: (f, a) => f(...a)
+        });
+      }
+    });
+    return () => {
+      void stream.close();
+    };
+  }, deps);
+  return value ?? defaultValue;
+};
+export {
+  useDevtools,
+  useStream
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/devtools/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/devtools/index.ts", "../../../../src/devtools/useDevtools.ts", "../../../../src/devtools/useStream.ts"],
+  "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"],
+  "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;",
+  "names": ["raise", "useDevtools", "client", "useClient", "services", "DevtoolsHost", "raise", "Error", "useState", "useEffect", "log", "useStream", "streamFactory", "defaultValue", "deps", "value", "setValue", "stream", "subscribe", "response", "err", "catch", "close"]
+}

package/dist/lib/node-esm/echo/index.mjs

@@ -0,0 +1,135 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  useInvitationStatus
+} from "../chunk-UYJUBYMU.mjs";
+import {
+  useClient
+} from "../chunk-QNHFZM3T.mjs";
+import "../chunk-UPS353EF.mjs";
+
+// packages/sdk/react-client/src/echo/index.ts
+export * from "@dxos/client/echo";
+
+// packages/sdk/react-client/src/echo/useMembers.ts
+import { MulticastObservable } from "@dxos/async";
+import { HaloSpaceMember } from "@dxos/client/echo";
+import { useMulticastObservable as useMulticastObservable2 } from "@dxos/react-hooks";
+
+// packages/sdk/react-client/src/echo/useSpaces.ts
+import { useEffect, useState } from "react";
+import { SpaceState } from "@dxos/client/echo";
+import { useMulticastObservable } from "@dxos/react-hooks";
+var useSpace = (spaceKeyLike) => {
+  const client = useClient();
+  const spaces = useMulticastObservable(client.spaces);
+  const [ready, setReady] = useState(false);
+  useEffect(() => {
+    if (spaceKeyLike) {
+      return;
+    }
+    const timeout = setTimeout(async () => {
+      await client.spaces.waitUntilReady();
+      setReady(true);
+    });
+    return () => clearTimeout(timeout);
+  }, [
+    client,
+    spaceKeyLike
+  ]);
+  if (spaceKeyLike) {
+    return spaces.find((space) => space.key.equals(spaceKeyLike) || space.id === spaceKeyLike);
+  }
+  if (ready && client.halo.identity.get()) {
+    return client.spaces.default;
+  }
+};
+var useSpaces = ({ all = false } = {}) => {
+  const client = useClient();
+  const spaces = useMulticastObservable(client.spaces);
+  return spaces.filter((space) => all || space.state.get() === SpaceState.SPACE_READY);
+};
+
+// packages/sdk/react-client/src/echo/useMembers.ts
+var useMembers = (spaceKey) => {
+  const spaces = useSpaces({
+    all: true
+  });
+  const space = spaceKey ? spaces.find((space2) => space2.key.equals(spaceKey)) : void 0;
+  const members = useMulticastObservable2(space?.members ?? MulticastObservable.empty()) ?? [];
+  return members.filter((member) => member.role !== HaloSpaceMember.Role.REMOVED);
+};
+
+// packages/sdk/react-client/src/echo/useQuery.ts
+import { useMemo, useSyncExternalStore } from "react";
+import { Filter, isSpace } from "@dxos/client/echo";
+var useQuery = (spaceOrEcho, filter, options, deps) => {
+  const { subscribe, getObjects } = useMemo(() => {
+    const query = isSpace(spaceOrEcho) ? spaceOrEcho.db.query(filter, options) : spaceOrEcho?.query(filter, options);
+    let subscribed = false;
+    return {
+      subscribe: (cb) => {
+        subscribed = true;
+        const unsubscribe = query?.subscribe(cb) ?? noop;
+        return () => {
+          unsubscribe?.();
+          subscribed = false;
+        };
+      },
+      getObjects: () => subscribed && query ? query.objects : EMPTY_ARRAY
+    };
+  }, [
+    spaceOrEcho,
+    ...filterToDepsArray(filter),
+    ...deps ?? []
+  ]);
+  return useSyncExternalStore(subscribe, getObjects) ?? [];
+};
+var filterToDepsArray = (filter) => [
+  JSON.stringify(Filter.from(filter).toProto())
+];
+var noop = () => {
+};
+var EMPTY_ARRAY = [];
+
+// packages/sdk/react-client/src/echo/useSpaceInvitations.ts
+import { useMemo as useMemo2 } from "react";
+import { MulticastObservable as MulticastObservable2 } from "@dxos/async";
+import { useMulticastObservable as useMulticastObservable3 } from "@dxos/react-hooks";
+var useSpaceInvitations = (spaceKey) => {
+  const space = useSpace(spaceKey);
+  return useMulticastObservable3(space?.invitations ?? MulticastObservable2.empty()) ?? [];
+};
+var useSpaceInvitation = (spaceKey, invitationId) => {
+  const invitations = useSpaceInvitations(spaceKey);
+  const invitation = useMemo2(() => invitations.find((invitation2) => invitation2.get().invitationId === invitationId), [
+    invitations
+  ]);
+  return useInvitationStatus(invitation);
+};
+
+// packages/sdk/react-client/src/echo/useSubscription.ts
+import { useEffect as useEffect2, useRef } from "react";
+import { createSubscription } from "@dxos/client/echo";
+var useSubscription = (cb, selection) => {
+  const callbackRef = useRef(cb);
+  callbackRef.current = cb;
+  const subscriptionRef = useRef();
+  useEffect2(() => {
+    subscriptionRef.current = createSubscription(() => {
+      callbackRef.current();
+    });
+    return () => subscriptionRef.current?.unsubscribe();
+  }, []);
+  subscriptionRef.current?.update(selection);
+  return subscriptionRef.current;
+};
+export {
+  useMembers,
+  useQuery,
+  useSpace,
+  useSpaceInvitation,
+  useSpaceInvitations,
+  useSpaces,
+  useSubscription
+};
+//# sourceMappingURL=index.mjs.map