@dxos/react-client 0.10.0 → 0.11.1

package/moon.yml

@@ -1,20 +1,9 @@
 layer: library
 language: typescript
 tags:
-  - ts-build
+  - ts-vite-build
   - ts-test
   - ts-test-storybook
   - typedoc
   - pack
   - storybook
-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.10.0",
+  "version": "0.11.1",
   "description": "React client API",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -16,69 +16,56 @@
     "./devtools": {
       "source": "./src/devtools/index.ts",
       "types": "./dist/types/src/devtools/index.d.ts",
-      "browser": "./dist/lib/browser/devtools/index.mjs",
-      "node": "./dist/lib/node-esm/devtools/index.mjs"
+      "import": "./dist/lib/devtools.mjs"
     },
     "./echo": {
       "source": "./src/echo/index.ts",
       "types": "./dist/types/src/echo/index.d.ts",
-      "browser": "./dist/lib/browser/echo/index.mjs",
-      "node": "./dist/lib/node-esm/echo/index.mjs"
+      "import": "./dist/lib/echo.mjs"
     },
     "./halo": {
       "source": "./src/halo/index.ts",
       "types": "./dist/types/src/halo/index.d.ts",
-      "browser": "./dist/lib/browser/halo/index.mjs",
-      "node": "./dist/lib/node-esm/halo/index.mjs"
+      "import": "./dist/lib/halo.mjs"
     },
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs",
-      "node": "./dist/lib/node-esm/index.mjs"
+      "import": "./dist/lib/index.mjs"
     },
     "./invitations": {
       "source": "./src/invitations/index.ts",
       "types": "./dist/types/src/invitations/index.d.ts",
-      "browser": "./dist/lib/browser/invitations/index.mjs",
-      "node": "./dist/lib/node-esm/invitations/index.mjs"
+      "import": "./dist/lib/invitations.mjs"
     },
     "./mesh": {
       "source": "./src/mesh/index.ts",
       "types": "./dist/types/src/mesh/index.d.ts",
-      "browser": "./dist/lib/browser/mesh/index.mjs",
-      "node": "./dist/lib/node-esm/mesh/index.mjs"
+      "import": "./dist/lib/mesh.mjs"
     },
     "./testing": {
       "source": "./src/testing/index.ts",
       "types": "./dist/types/src/testing/index.d.ts",
-      "browser": "./dist/lib/browser/testing/index.mjs",
-      "node": "./dist/lib/node-esm/testing/index.mjs"
-    },
-    "./worker": {
-      "source": "./src/worker.ts",
-      "types": "./dist/types/src/worker.d.ts",
-      "browser": "./dist/lib/browser/worker.mjs",
-      "node": "./dist/lib/node-esm/worker.mjs"
+      "import": "./dist/lib/testing.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "dependencies": {
-    "@dxos/async": "0.10.0",
-    "@dxos/client": "0.10.0",
-    "@dxos/config": "0.10.0",
-    "@dxos/context": "0.10.0",
-    "@dxos/codec-protobuf": "0.10.0",
-    "@dxos/debug": "0.10.0",
-    "@dxos/echo-protocol": "0.10.0",
-    "@dxos/echo": "0.10.0",
-    "@dxos/invariant": "0.10.0",
-    "@dxos/echo-react": "0.10.0",
-    "@dxos/keys": "0.10.0",
-    "@dxos/log": "0.10.0",
-    "@dxos/node-std": "0.10.0",
-    "@dxos/react-hooks": "0.10.0",
-    "@dxos/util": "0.10.0"
+    "@dxos/async": "0.11.1",
+    "@dxos/client": "0.11.1",
+    "@dxos/codec-protobuf": "0.11.1",
+    "@dxos/config": "0.11.1",
+    "@dxos/context": "0.11.1",
+    "@dxos/debug": "0.11.1",
+    "@dxos/echo": "0.11.1",
+    "@dxos/echo-protocol": "0.11.1",
+    "@dxos/echo-react": "0.11.1",
+    "@dxos/invariant": "0.11.1",
+    "@dxos/keys": "0.11.1",
+    "@dxos/log": "0.11.1",
+    "@dxos/node-std": "0.11.1",
+    "@dxos/react-hooks": "0.11.1",
+    "@dxos/util": "0.11.1"
   },
   "devDependencies": {
     "@types/react": "~19.2.17",
@@ -86,21 +73,21 @@
     "react": "~19.2.7",
     "react-dom": "~19.2.7",
     "typedoc": "0.28.1",
-    "@dxos/random": "0.10.0",
-    "@dxos/react-ui-syntax-highlighter": "0.10.0",
-    "@dxos/test-utils": "0.10.0",
-    "@dxos/storybook-utils": "0.10.0",
-    "@dxos/react-ui": "0.10.0",
-    "@dxos/ui-theme": "0.10.0"
+    "@dxos/random": "0.11.1",
+    "@dxos/react-ui": "0.11.1",
+    "@dxos/react-ui-syntax-highlighter": "0.11.1",
+    "@dxos/storybook-utils": "0.11.1",
+    "@dxos/test-utils": "0.11.1",
+    "@dxos/ui-theme": "0.11.1"
   },
   "peerDependencies": {
     "react": "~19.2.7",
     "react-dom": "~19.2.7"
   },
   "optionalDependencies": {
-    "@dxos/random": "0.10.0",
-    "@dxos/react-ui": "0.10.0",
-    "@dxos/ui-theme": "0.10.0"
+    "@dxos/random": "0.11.1",
+    "@dxos/react-ui": "0.11.1",
+    "@dxos/ui-theme": "0.11.1"
   },
   "publishConfig": {
     "access": "public"

package/src/client/AgentHostingProvider.tsx

@@ -2,19 +2,20 @@
 // Copyright 2023 DXOS.org
 //
 
-import React, { type PropsWithChildren, createContext, useContext, useState } from 'react';
+import React, { type PropsWithChildren, useState } from 'react';
 
 import { type AgentHostingProviderClient, AgentManagerClient, FakeAgentHostingProvider } from '@dxos/client';
 import { type Halo } from '@dxos/client/halo';
 import { type Config } from '@dxos/config';
 import { log } from '@dxos/log';
 
-import { useClient } from '../client';
+// Imported from the defining module, not the directory barrel: `'../client'` is this file's own
+// barrel, and that cycle made every downstream edit a full page reload.
+import { AgentHostingContext } from './context';
+import { useClient } from './useClient';
 
 export type AgentHostingProviderProps = { config: Config; halo: Halo };
 
-export const AgentHostingContext = createContext<AgentHostingProviderClient | null>(null);
-
 /**
  * Experimental agent hosting provider.
  * @param props
@@ -29,10 +30,6 @@ export const AgentHostingProvider = (props: PropsWithChildren) => {
   );
 };
 
-export const useAgentHostingClient = () => {
-  return useContext(AgentHostingContext);
-};
-
 const makeClient = ({ config, halo }: AgentHostingProviderProps) => {
   const agentHostingConfig = config.get('runtime.services.agentHosting');
   if (!agentHostingConfig) {

package/src/client/context.ts

@@ -2,9 +2,9 @@
 // Copyright 2020 DXOS.org
 //
 
-import { type Context, createContext } from 'react';
+import { type Context, createContext, useContext } from 'react';
 
-import { type Client, type SystemStatus } from '@dxos/client';
+import { type AgentHostingProviderClient, type Client, type SystemStatus } from '@dxos/client';
 
 export type ClientContextProps = {
   client: Client;
@@ -17,3 +17,12 @@ export type ClientContextProps = {
 export const ClientContext: Context<ClientContextProps | undefined> = createContext<ClientContextProps | undefined>(
   undefined,
 );
+
+// Kept out of `AgentHostingProvider.tsx`: react-refresh only fast-refreshes a module whose exports
+// are all components, so a context and hook exported beside the provider make it a reload boundary
+// for everything downstream of it.
+export const AgentHostingContext = createContext<AgentHostingProviderClient | null>(null);
+
+export const useAgentHostingClient = () => {
+  return useContext(AgentHostingContext);
+};

package/src/echo/index.ts

@@ -9,6 +9,7 @@ export * from './useMembers';
 export * from './useSpaces';
 export * from './useSpaceInvitations';
 export * from './useSpaceProperties';
+export * from './useFlush';
 export * from './useSubscription';
 export * from './useSyncState';
 export * from './useFeedSyncState';

package/src/echo/useFeedSyncState.ts

@@ -20,15 +20,15 @@ export type FeedSyncState = {
 export type FeedSyncStateMap = Record<SpaceId, FeedSyncState>;
 
 /**
- * Polls queue replication state per space.
+ * Polls feed replication state per space.
  */
 export const useFeedSyncState = (pollIntervalMs = DEFAULT_POLL_INTERVAL_MS): FeedSyncStateMap => {
   const client = useClient();
   const [feedSyncState, setFeedSyncState] = useState<FeedSyncStateMap>({});
 
   useEffect(() => {
-    const queueService = client.services.services.QueueService;
-    if (!queueService) {
+    const feedService = client.services.services.FeedService;
+    if (!feedService) {
       return;
     }
 
@@ -39,7 +39,7 @@ export const useFeedSyncState = (pollIntervalMs = DEFAULT_POLL_INTERVAL_MS): Fee
       const entries = await Promise.all(
         spaces.map(async (space) => {
           try {
-            const response = await queueService.getSyncState({ spaceId: space.id });
+            const response = await feedService.getSyncState({ spaceId: space.id });
             const state = (response.namespaces ?? []).reduce<FeedSyncState>(
               (acc, entry) => {
                 acc.pending += Number(entry.blocksToPull ?? 0) + Number(entry.blocksToPush ?? 0);

package/src/echo/useFlush.ts

@@ -0,0 +1,39 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { useCallback, useRef, useState } from 'react';
+
+import { type Space } from '@dxos/client/echo';
+
+/**
+ * Flushes a space's database to storage, exposing a transient `idle → flushing → flushed → idle`
+ * state suitable for driving a toolbar affordance.
+ */
+export const useFlush = (space?: Space) => {
+  const [state, setState] = useState<'idle' | 'flushing' | 'flushed'>('idle');
+  const resetTimer = useRef<NodeJS.Timeout | null>(null);
+
+  const handleFlush = useCallback(() => {
+    if (!space) {
+      return;
+    }
+
+    queueMicrotask(async () => {
+      if (resetTimer.current) {
+        clearTimeout(resetTimer.current);
+      }
+
+      setState('flushing');
+      await space.db.flush();
+      setState('flushed');
+
+      resetTimer.current = setTimeout(() => {
+        setState('idle');
+        resetTimer.current = null;
+      }, 1_000);
+    });
+  }, [space]);
+
+  return { state, handleFlush };
+};

package/src/echo/useSpaces.ts

@@ -35,20 +35,6 @@ export const useSpace = (spaceId?: SpaceId | PublicKey): Space | undefined => {
   });
 };
 
-/**
- * Get a Space database by the id of the space.
- * The space is not guaranteed to be in the ready state.
- * Returns undefined if no id is provided.
- * Requires a ClientProvider somewhere in the parent tree.
- *
- * @param spaceId the id of the space to look for.
- * @deprecated Use useSpace.
- */
-export const useDatabase = (spaceId?: SpaceId): Space['db'] | undefined => {
-  const space = useSpace(spaceId);
-  return space?.db;
-};
-
 export type UseSpacesProps = {
   /**
    * Return uninitialized spaces as well.

package/src/echo/useSyncState.ts

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

package/src/halo/Passkey.stories.tsx

@@ -115,7 +115,7 @@ const Test = () => {
           Authenticate with Passkey
         </Button>
       </div>
-      <div className='flex flex-col min-w-[28rem] divide-y divide-separator border border-separator rounded-sm'>
+      <div className='flex flex-col min-w-[28rem] divide-y divide-subdued-separator border border-separator rounded-sm'>
         <JsonHighlighter data={{ identity, credentials: credentials.length }} />
       </div>
     </>

package/src/testing/withClientProvider.stories.tsx

@@ -27,7 +27,7 @@ const DefaultStory = () => {
   }
 
   return (
-    <div className='flex flex-col divide-y divide-separator border border-separator'>
+    <div className='flex flex-col divide-y divide-subdued-separator border border-separator'>
       <JsonHighlighter data={client.toJSON()} />
       {spaces.map((space) => (
         <SpaceInfo key={space.id} space={space} />

package/vite.config.ts

@@ -0,0 +1,19 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { defineConfig } from '../../../vite.base.config.ts';
+
+export default defineConfig({
+  entry: {
+    devtools: 'src/devtools/index.ts',
+    echo: 'src/echo/index.ts',
+    halo: 'src/halo/index.ts',
+    index: 'src/index.ts',
+    invitations: 'src/invitations/index.ts',
+    mesh: 'src/mesh/index.ts',
+    testing: 'src/testing/index.ts',
+  },
+  jsx: 'react',
+  test: { node: { environment: 'happy-dom' }, storybook: true },
+});

package/dist/lib/browser/chunk-3LVU7RNK.mjs

@@ -1,16 +0,0 @@
-import {
-  ClientContext
-} from "./chunk-CZMIVAGI.mjs";
-
-// 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-3LVU7RNK.mjs.map

package/dist/lib/browser/chunk-3LVU7RNK.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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/browser/chunk-CZMIVAGI.mjs

@@ -1,8 +0,0 @@
-// src/client/context.ts
-import { createContext } from "react";
-var ClientContext = createContext(void 0);
-
-export {
-  ClientContext
-};
-//# sourceMappingURL=chunk-CZMIVAGI.mjs.map

package/dist/lib/browser/chunk-CZMIVAGI.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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,gBAAyDD,cACpEE,MAAAA;",
-  "names": ["createContext", "ClientContext", "undefined"]
-}

package/dist/lib/browser/chunk-SSDQ6NXU.mjs

@@ -1,153 +0,0 @@
-// src/invitations/index.ts
-import { AuthenticatingInvitationObservable, CancellableInvitationObservable, Invitation as Invitation2, InvitationEncoder as InvitationEncoder2, InvitationsProxy } from "@dxos/client/invitations";
-
-// src/invitations/useInvitationStatus.ts
-import { useCallback, useEffect, useMemo, useReducer } from "react";
-import { Invitation, InvitationEncoder } from "@dxos/client/invitations";
-import { log } from "@dxos/log";
-var __dxlog_file = "/__w/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
-    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 12, S: void 0 });
-    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
-    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 125, S: void 0 });
-    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,
-  Invitation2 as Invitation,
-  InvitationEncoder2 as InvitationEncoder,
-  InvitationsProxy
-};
-//# sourceMappingURL=chunk-SSDQ6NXU.mjs.map

package/dist/lib/browser/chunk-SSDQ6NXU.mjs.map

@@ -1,7 +0,0 @@
-{
-  "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  Invitation,\n  InvitationEncoder,\n  type Invitations,\n  InvitationsProxy,\n} from '@dxos/client/invitations';\n\nexport * from './useInvitationStatus';\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { useCallback, useEffect, useMemo, useReducer } 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?: Error;\n  id?: string;\n  multiUse?: boolean;\n  shareable?: 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?: Error;\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(\n    (prev: InvitationReducerState, action: InvitationAction): InvitationReducerState => {\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      };\n    },\n    null,\n    (_arg: null): InvitationReducerState => {\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", "Invitation", "InvitationEncoder", "InvitationsProxy", "useCallback", "useEffect", "useMemo", "useReducer", "Invitation", "InvitationEncoder", "log", "prev", "action", "invitationId", "multiUse", "invitation", "invitationCode", "authCode", "authMethod", "shareable", "isShareableInvitation", "type", "invitationProps", "status", "result", "INIT", "spaceKey", "identityKey", "swarmKey", "target", "State", "READY_FOR_AUTHENTICATION", "AUTHENTICATING", "dispatch", "haltedAt", "ERROR", "error", "update", "currentState", "subscription", "observable", "state", "cancel", "connect", "authenticate"]
-}