@dxos/plugin-client 0.8.4-main.67995b8 → 0.8.4-main.6fa680abb7

package/src/capabilities/intent-resolver.ts

@@ -1,250 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { pipe } from 'effect';
-
-import {
-  Capabilities,
-  chain,
-  contributes,
-  createIntent,
-  createResolver,
-  LayoutAction,
-  type PluginContext,
-} from '@dxos/app-framework';
-import { invariant } from '@dxos/invariant';
-import { ObservabilityAction } from '@dxos/plugin-observability/types';
-import { PublicKey } from '@dxos/react-client';
-import { type JoinPanelProps } from '@dxos/shell/react';
-
-import { ClientCapabilities } from './capabilities';
-import { JOIN_DIALOG, RECOVERY_CODE_DIALOG, RESET_DIALOG } from '../components';
-import { ClientEvents } from '../events';
-import { Account, ClientAction } from '../types';
-
-type IntentResolverOptions = {
-  context: PluginContext;
-  appName?: string;
-};
-
-const RECOVER_IDENTITY_RPC_TIMEOUT = 20_000;
-
-export default ({ context, appName = 'Composer' }: IntentResolverOptions) =>
-  contributes(Capabilities.IntentResolver, [
-    createResolver({
-      intent: ClientAction.CreateIdentity,
-      resolve: async (profile) => {
-        const manager = context.getCapability(Capabilities.PluginManager);
-        const client = context.getCapability(ClientCapabilities.Client);
-        const data = await client.halo.createIdentity(profile);
-        await manager.activate(ClientEvents.IdentityCreated);
-        return {
-          data,
-          intents: [
-            createIntent(ObservabilityAction.SendEvent, {
-              name: 'identity.create',
-            }),
-          ],
-        };
-      },
-    }),
-    createResolver({
-      intent: ClientAction.JoinIdentity,
-      resolve: async (data) => {
-        return {
-          intents: [
-            createIntent(LayoutAction.UpdateDialog, {
-              part: 'dialog',
-              subject: JOIN_DIALOG,
-              options: {
-                blockAlign: 'start',
-                props: {
-                  initialInvitationCode: data.invitationCode,
-                  initialDisposition: 'accept-halo-invitation',
-                },
-              },
-            }),
-          ],
-        };
-      },
-    }),
-    createResolver({
-      intent: ClientAction.ShareIdentity,
-      resolve: async () => {
-        return {
-          intents: [
-            pipe(
-              createIntent(LayoutAction.SwitchWorkspace, {
-                part: 'workspace',
-                subject: Account.id,
-              }),
-              chain(LayoutAction.Open, {
-                part: 'main',
-                subject: [Account.Profile],
-              }),
-            ),
-            createIntent(ObservabilityAction.SendEvent, {
-              name: 'identity.share',
-            }),
-          ],
-        };
-      },
-    }),
-    createResolver({
-      intent: ClientAction.RecoverIdentity,
-      resolve: async () => {
-        return {
-          intents: [
-            createIntent(LayoutAction.UpdateDialog, {
-              part: 'dialog',
-              subject: JOIN_DIALOG,
-              options: {
-                blockAlign: 'start',
-                props: {
-                  initialDisposition: 'recover-identity',
-                } satisfies Partial<JoinPanelProps>,
-              },
-            }),
-          ],
-        };
-      },
-    }),
-    createResolver({
-      intent: ClientAction.ResetStorage,
-      resolve: async (data) => {
-        return {
-          intents: [
-            createIntent(LayoutAction.UpdateDialog, {
-              part: 'dialog',
-              subject: RESET_DIALOG,
-              options: {
-                blockAlign: 'start',
-                props: {
-                  mode: data.mode ?? 'reset storage',
-                },
-              },
-            }),
-          ],
-        };
-      },
-    }),
-    createResolver({
-      intent: ClientAction.CreateAgent,
-      resolve: async () => {
-        const client = context.getCapability(ClientCapabilities.Client);
-        invariant(client.services.services.EdgeAgentService, 'Missing EdgeAgentService');
-        await client.services.services.EdgeAgentService.createAgent(null as any, { timeout: 10_000 });
-      },
-    }),
-    createResolver({
-      intent: ClientAction.CreateRecoveryCode,
-      resolve: async () => {
-        const client = context.getCapability(ClientCapabilities.Client);
-        invariant(client.services.services.IdentityService, 'IdentityService not available');
-        // TODO(wittjosiah): This needs a proper api.
-        const { recoveryCode } = await client.services.services.IdentityService.createRecoveryCredential({});
-        return {
-          intents: [
-            createIntent(LayoutAction.UpdateDialog, {
-              part: 'dialog',
-              subject: RECOVERY_CODE_DIALOG,
-              options: {
-                blockAlign: 'start',
-                type: 'alert',
-                props: { code: recoveryCode },
-              },
-            }),
-          ],
-        };
-      },
-    }),
-    createResolver({
-      intent: ClientAction.CreatePasskey,
-      resolve: async () => {
-        const client = context.getCapability(ClientCapabilities.Client);
-        const identity = client.halo.identity.get();
-        invariant(identity, 'Identity not available');
-
-        // TODO(wittjosiah): Consider factoring out passkey creation to the halo api.
-        const lookupKey = PublicKey.random();
-        const credential = await navigator.credentials.create({
-          publicKey: {
-            challenge: new Uint8Array(),
-            rp: { id: location.hostname, name: appName },
-            user: {
-              id: lookupKey.asUint8Array(),
-              name: identity.did,
-              displayName: identity.profile?.displayName ?? '',
-            },
-            pubKeyCredParams: [
-              { type: 'public-key', alg: -8 }, // Ed25519 (not yet supported across all browsers)
-              { type: 'public-key', alg: -7 }, // ES256
-            ],
-            // https://web.dev/articles/webauthn-discoverable-credentials#resident-key
-            authenticatorSelection: {
-              residentKey: 'required',
-              requireResidentKey: true,
-            },
-          },
-        });
-
-        invariant(credential, 'Credential not available');
-        const recoveryKey = PublicKey.from(new Uint8Array((credential as any).response.getPublicKey()));
-        const algorithm = (credential as any).response.getPublicKeyAlgorithm() === -7 ? 'ES256' : 'ED25519';
-
-        // TODO(wittjosiah): This needs a proper api.
-        invariant(client.services.services.IdentityService, 'IdentityService not available');
-        await client.services.services.IdentityService.createRecoveryCredential({
-          data: {
-            recoveryKey,
-            algorithm,
-            lookupKey,
-          },
-        });
-      },
-    }),
-    createResolver({
-      intent: ClientAction.RedeemPasskey,
-      resolve: async () => {
-        const client = context.getCapability(ClientCapabilities.Client);
-        // TODO(wittjosiah): This needs a proper api.
-        invariant(client.services.services.IdentityService, 'IdentityService not available');
-        const { deviceKey, controlFeedKey, challenge } =
-          await client.services.services.IdentityService.requestRecoveryChallenge();
-        const credential = await navigator.credentials.get({
-          publicKey: {
-            challenge: Buffer.from(challenge, 'base64'),
-            rpId: location.hostname,
-            userVerification: 'required',
-          },
-        });
-        const lookupKey = PublicKey.from(new Uint8Array((credential as any).response.userHandle));
-        await client.services.services.IdentityService.recoverIdentity(
-          {
-            external: {
-              lookupKey,
-              deviceKey,
-              controlFeedKey,
-              signature: Buffer.from((credential as any).response.signature),
-              clientDataJson: Buffer.from((credential as any).response.clientDataJSON),
-              authenticatorData: Buffer.from((credential as any).response.authenticatorData),
-            },
-          },
-          { timeout: RECOVER_IDENTITY_RPC_TIMEOUT },
-        );
-      },
-    }),
-    createResolver({
-      intent: ClientAction.RedeemToken,
-      resolve: async (data) => {
-        const client = context.getCapability(ClientCapabilities.Client);
-        // TODO(wittjosiah): This needs a proper api.
-        invariant(client.services.services.IdentityService, 'IdentityService not available');
-        await client.services.services.IdentityService.recoverIdentity(
-          { token: data.token },
-          { timeout: RECOVER_IDENTITY_RPC_TIMEOUT },
-        );
-      },
-    }),
-  ]);

package/src/capabilities/migrations.ts

@@ -1,25 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capabilities, contributes, type PluginContext } from '@dxos/app-framework';
-
-import { ClientCapabilities } from './capabilities';
-
-export default (context: PluginContext) => {
-  const registry = context.getCapability(Capabilities.RxRegistry);
-  const client = context.getCapability(ClientCapabilities.Client);
-
-  // NOTE: Migrations are currently unidirectional and idempotent.
-  const cancel = registry.subscribe(
-    context.capabilities(ClientCapabilities.Migration),
-    (_migrations) => {
-      const migrations = Array.from(new Set(_migrations.flat()));
-      const spaces = client.spaces.get();
-      void Promise.all(spaces.map((space) => space.db.runMigrations(migrations)));
-    },
-    { immediate: true },
-  );
-
-  return contributes(Capabilities.Null, null, () => cancel());
-};

package/src/capabilities/react-context.tsx

@@ -1,20 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import React from 'react';
-
-import { Capabilities, contributes, useCapability } from '@dxos/app-framework';
-import { ClientProvider } from '@dxos/react-client';
-
-import { ClientCapabilities } from './capabilities';
-import { CLIENT_PLUGIN } from '../meta';
-
-export default () =>
-  contributes(Capabilities.ReactContext, {
-    id: CLIENT_PLUGIN,
-    context: ({ children }) => {
-      const client = useCapability(ClientCapabilities.Client);
-      return <ClientProvider client={client}>{children}</ClientProvider>;
-    },
-  });

package/src/capabilities/react-surface.tsx

@@ -1,67 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import React from 'react';
-
-import { createSurface, Capabilities, contributes } from '@dxos/app-framework';
-import { type JoinPanelProps } from '@dxos/shell/react';
-
-import {
-  DevicesContainer,
-  JOIN_DIALOG,
-  JoinDialog,
-  ProfileContainer,
-  RECOVERY_CODE_DIALOG,
-  RecoveryCodeDialog,
-  RecoveryCredentialsContainer,
-  RESET_DIALOG,
-  ResetDialog,
-  type ResetDialogProps,
-  type RecoveryCodeDialogProps,
-} from '../components';
-import { Account, type ClientPluginOptions } from '../types';
-
-type ReactSurfaceOptions = Pick<ClientPluginOptions, 'onReset'> & {
-  createInvitationUrl: (invitationCode: string) => string;
-};
-
-export default ({ createInvitationUrl, onReset }: ReactSurfaceOptions) =>
-  contributes(Capabilities.ReactSurface, [
-    createSurface({
-      id: Account.Profile,
-      role: 'article',
-      filter: (data): data is any => data.subject === Account.Profile,
-      component: () => <ProfileContainer />,
-    }),
-    createSurface({
-      id: Account.Devices,
-      role: 'article',
-      filter: (data): data is any => data.subject === Account.Devices,
-      component: ({ data }) => <DevicesContainer createInvitationUrl={createInvitationUrl} />,
-    }),
-    createSurface({
-      id: Account.Security,
-      role: 'article',
-      filter: (data): data is any => data.subject === Account.Security,
-      component: () => <RecoveryCredentialsContainer />,
-    }),
-    createSurface({
-      id: JOIN_DIALOG,
-      role: 'dialog',
-      filter: (data): data is { props: JoinPanelProps } => data.component === JOIN_DIALOG,
-      component: ({ data }) => <JoinDialog {...data.props} />,
-    }),
-    createSurface({
-      id: RECOVERY_CODE_DIALOG,
-      role: 'dialog',
-      filter: (data): data is { props: RecoveryCodeDialogProps } => data.component === RECOVERY_CODE_DIALOG,
-      component: ({ data }) => <RecoveryCodeDialog {...data.props} />,
-    }),
-    createSurface({
-      id: RESET_DIALOG,
-      role: 'dialog',
-      filter: (data): data is { props: ResetDialogProps } => data.component === RESET_DIALOG,
-      component: ({ data }) => <ResetDialog {...data.props} onReset={onReset} />,
-    }),
-  ]);

package/src/capabilities/schema-defs.ts

@@ -1,29 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { Capabilities, contributes, type PluginContext } from '@dxos/app-framework';
-import { type Type } from '@dxos/echo';
-
-import { ClientCapabilities } from './capabilities';
-
-export default (context: PluginContext) => {
-  const registry = context.getCapability(Capabilities.RxRegistry);
-  const client = context.getCapability(ClientCapabilities.Client);
-
-  // TODO(wittjosiah): Unregister schemas when they are disabled.
-  let previous: Type.Obj.Any[] = [];
-  const cancel = registry.subscribe(
-    context.capabilities(ClientCapabilities.Schema),
-    (_schemas) => {
-      const schemas = Array.from(new Set(_schemas.flat()));
-      // TODO(wittjosiah): Filter out schemas which the client has already registered.
-      const newSchemas = schemas.filter((schema) => !previous.includes(schema));
-      previous = schemas;
-      client.addTypes(newSchemas);
-    },
-    { immediate: true },
-  );
-
-  return contributes(Capabilities.Null, null, () => cancel());
-};

package/src/components/DevicesContainer.stories.tsx

@@ -1,49 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import '@dxos-theme';
-
-import { type StoryObj, type Meta } from '@storybook/react-vite';
-
-import { IntentPlugin } from '@dxos/app-framework';
-import { withPluginManager } from '@dxos/app-framework/testing';
-import { translations as shellTranslations } from '@dxos/shell/react';
-import { withTheme, withLayout } from '@dxos/storybook-utils';
-
-import { DevicesContainer } from './DevicesContainer';
-import { ClientPlugin } from '../ClientPlugin';
-import { translations } from '../translations';
-
-const meta: Meta = {
-  title: 'plugins/plugin-client/DevicesContainer',
-  component: DevicesContainer,
-  decorators: [
-    withPluginManager({
-      plugins: [
-        ClientPlugin({
-          onClientInitialized: async (_, client) => {
-            await client.halo.createIdentity();
-          },
-        }),
-        IntentPlugin(),
-      ],
-    }),
-    withTheme,
-    withLayout(),
-  ],
-  parameters: {
-    layout: 'fullscreen',
-    translations: [...translations, ...shellTranslations],
-  },
-};
-
-export default meta;
-
-type Story = StoryObj<typeof DevicesContainer>;
-
-export const Default: Story = {
-  args: {
-    createInvitationUrl: () => 'https://example.com',
-  },
-};

package/src/components/JoinDialog.tsx

@@ -1,53 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import React, { useCallback } from 'react';
-
-import { createIntent, LayoutAction, useIntentDispatcher } from '@dxos/app-framework';
-import { ObservabilityAction } from '@dxos/plugin-observability/types';
-import { type InvitationResult } from '@dxos/react-client/invitations';
-import { Dialog, useTranslation } from '@dxos/react-ui';
-import { JoinPanel, type JoinPanelProps } from '@dxos/shell/react';
-
-import { CLIENT_PLUGIN } from '../meta';
-import { ClientAction } from '../types';
-
-export const JOIN_DIALOG = `${CLIENT_PLUGIN}/JoinDialog`;
-
-export const JoinDialog = (props: JoinPanelProps) => {
-  const { dispatchPromise: dispatch } = useIntentDispatcher();
-  const { t } = useTranslation(CLIENT_PLUGIN);
-
-  const handleCancelResetStorage = useCallback(() => dispatch(createIntent(ClientAction.ShareIdentity)), [dispatch]);
-
-  const handleDone = useCallback(
-    async (result: InvitationResult | null) => {
-      if (result?.identityKey) {
-        await Promise.all([
-          dispatch(createIntent(LayoutAction.UpdateDialog, { part: 'dialog', options: { state: false } })),
-          dispatch(
-            createIntent(ObservabilityAction.SendEvent, {
-              name: props.initialDisposition === 'recover-identity' ? 'identity.recover' : 'identity.join',
-            }),
-          ),
-        ]);
-      }
-    },
-    [dispatch],
-  );
-
-  return (
-    <Dialog.Content>
-      <Dialog.Title classNames='sr-only'>{t('join space label', { ns: 'os' })}</Dialog.Title>
-      <JoinPanel
-        mode='halo-only'
-        {...props}
-        exitActionParent={<Dialog.Close asChild />}
-        doneActionParent={<Dialog.Close asChild />}
-        onCancelResetStorage={handleCancelResetStorage}
-        onDone={handleDone}
-      />
-    </Dialog.Content>
-  );
-};

package/src/components/ProfileContainer.stories.tsx

@@ -1,29 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import '@dxos-theme';
-
-import { type StoryObj, type Meta } from '@storybook/react-vite';
-
-import { withClientProvider } from '@dxos/react-client/testing';
-import { withTheme, withLayout } from '@dxos/storybook-utils';
-
-import { ProfileContainer } from './ProfileContainer';
-import { translations } from '../translations';
-
-const meta: Meta = {
-  title: 'plugins/plugin-client/ProfileContainer',
-  component: ProfileContainer,
-  decorators: [withClientProvider({ createIdentity: true }), withTheme, withLayout()],
-  parameters: {
-    layout: 'fullscreen',
-    translations,
-  },
-};
-
-export default meta;
-
-type Story = StoryObj<typeof ProfileContainer>;
-
-export const Default: Story = {};

package/src/components/RecoveryCredentialsContainer.stories.tsx

@@ -1,44 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import '@dxos-theme';
-
-import { type StoryObj, type Meta } from '@storybook/react-vite';
-
-import { IntentPlugin } from '@dxos/app-framework';
-import { withPluginManager } from '@dxos/app-framework/testing';
-import { withTheme, withLayout } from '@dxos/storybook-utils';
-
-import { RecoveryCredentialsContainer } from './RecoveryCredentialsContainer';
-import { ClientPlugin } from '../ClientPlugin';
-import { translations } from '../translations';
-
-const meta: Meta = {
-  title: 'plugins/plugin-client/RecoveryCredentialsContainer',
-  component: RecoveryCredentialsContainer,
-  decorators: [
-    withPluginManager({
-      plugins: [
-        ClientPlugin({
-          onClientInitialized: async (_, client) => {
-            await client.halo.createIdentity();
-          },
-        }),
-        IntentPlugin(),
-      ],
-    }),
-    withTheme,
-    withLayout(),
-  ],
-  parameters: {
-    layout: 'fullscreen',
-    translations,
-  },
-};
-
-export default meta;
-
-type Story = StoryObj<typeof RecoveryCredentialsContainer>;
-
-export const Default: Story = {};

package/src/components/RecoveryCredentialsContainer.tsx

@@ -1,73 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import React from 'react';
-
-import { createIntent, useIntentDispatcher } from '@dxos/app-framework';
-import { useCredentials } from '@dxos/react-client/halo';
-import { Icon, IconButton, List, ListItem, useTranslation, Message } from '@dxos/react-ui';
-import { ControlGroup, ControlItem, ControlPage, ControlSection } from '@dxos/react-ui-form';
-import { StackItem } from '@dxos/react-ui-stack';
-
-import { CLIENT_PLUGIN } from '../meta';
-import { ClientAction } from '../types';
-
-export const MANAGE_CREDENTIALS_DIALOG = `${CLIENT_PLUGIN}/ManageCredentialsDialog`;
-
-export const RecoveryCredentialsContainer = () => {
-  const { t } = useTranslation(CLIENT_PLUGIN);
-  const { dispatchPromise: dispatch } = useIntentDispatcher();
-  const credentials = useCredentials();
-  const recoveryCredentials = credentials.filter(
-    (credential) => credential.subject.assertion['@type'] === 'dxos.halo.credentials.IdentityRecovery',
-  );
-
-  return (
-    <StackItem.Content classNames='block overflow-y-auto'>
-      <ControlPage>
-        <ControlSection title={t('recovery setup dialog title')} description={t('recovery setup dialog description')}>
-          <ControlGroup>
-            <ControlItem title={t('create passkey label')} description={t('create passkey description')}>
-              <IconButton
-                label={t('create passkey label')}
-                icon='ph--key--duotone'
-                variant='primary'
-                size={5}
-                onClick={() => dispatch(createIntent(ClientAction.CreatePasskey))}
-              />
-            </ControlItem>
-            <ControlItem title={t('create recovery code label')} description={t('create recovery code description')}>
-              <IconButton
-                label={t('create recovery code label')}
-                icon='ph--receipt--duotone'
-                variant='default'
-                size={5}
-                onClick={() => dispatch(createIntent(ClientAction.CreateRecoveryCode))}
-              />
-            </ControlItem>
-          </ControlGroup>
-        </ControlSection>
-        <ControlSection title={t('credentials list label')}>
-          {recoveryCredentials.length < 1 ? (
-            <Message.Root valence='error' classNames='container-max-width'>
-              <Message.Title icon='ph--shield-warning--duotone'>{t('no credentials title')}</Message.Title>
-              <Message.Content>{t('no credentials message')}</Message.Content>
-            </Message.Root>
-          ) : (
-            <List classNames='container-max-width pli-2'>
-              {recoveryCredentials.map((credential) => (
-                <ListItem.Root key={credential.id?.toHex()}>
-                  <ListItem.Endcap>
-                    <Icon icon='ph--key--regular' size={5} />
-                  </ListItem.Endcap>
-                  <ListItem.Heading>{credential.issuanceDate.toLocaleString()}</ListItem.Heading>
-                </ListItem.Root>
-              ))}
-            </List>
-          )}
-        </ControlSection>
-      </ControlPage>
-    </StackItem.Content>
-  );
-};