@dxos/plugin-space 0.8.4-main.937b3ca → 0.8.4-main.9be5663bfe

package/src/components/SpaceSettings/SpaceSettingsContainer.tsx

@@ -1,220 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import * as Schema from 'effect/Schema';
-import React, { type ChangeEvent, forwardRef, useCallback, useMemo, useState } from 'react';
-
-import { Common } from '@dxos/app-framework';
-import { useCapabilities, useOperationInvoker } from '@dxos/app-framework/react';
-import { Obj } from '@dxos/echo';
-import { log } from '@dxos/log';
-import { EdgeReplicationSetting } from '@dxos/protocols/proto/dxos/echo/metadata';
-import { useClient } from '@dxos/react-client';
-import { type Space, SpaceState } from '@dxos/react-client/echo';
-import { Button, Input, useFileDownload, useMulticastObservable, useTranslation } from '@dxos/react-ui';
-import {
-  ControlItem,
-  ControlItemInput,
-  ControlPage,
-  ControlSection,
-  Form,
-  type FormFieldMap,
-} from '@dxos/react-ui-form';
-import { Layout } from '@dxos/react-ui-mosaic';
-import { HuePicker, IconPicker } from '@dxos/react-ui-pickers';
-
-import { meta } from '../../meta';
-import { SpaceCapabilities, SpaceForm, SpaceOperation } from '../../types';
-
-const SpaceFormSchema = SpaceForm.pipe(
-  Schema.extend(
-    Schema.Struct({
-      archived: Schema.Boolean.annotations({ title: 'Archive Space' }),
-    }),
-  ),
-);
-
-export type SpaceSettingsContainerProps = {
-  space: Space;
-};
-
-// TODO(wittjosiah): Handle space migrations here?
-export const SpaceSettingsContainer = forwardRef<HTMLDivElement, SpaceSettingsContainerProps>(
-  ({ space }, forwardedRef) => {
-    const { t } = useTranslation(meta.id);
-    const { invokePromise } = useOperationInvoker();
-    const client = useClient();
-    const archived = useMulticastObservable(space.state) === SpaceState.SPACE_INACTIVE;
-    const [edgeReplication, setEdgeReplication] = useState(
-      space.internal.data.edgeReplication === EdgeReplicationSetting.ENABLED,
-    );
-    const toggleEdgeReplication = useCallback(
-      async (next: boolean) => {
-        setEdgeReplication(next);
-        await space?.internal
-          .setEdgeReplicationPreference(next ? EdgeReplicationSetting.ENABLED : EdgeReplicationSetting.DISABLED)
-          .catch((err: unknown) => {
-            log.catch(err);
-            setEdgeReplication(!next);
-          });
-      },
-      [space],
-    );
-
-    const handleSave = useCallback(
-      (properties: Schema.Schema.Type<typeof SpaceFormSchema>) => {
-        void toggleEdgeReplication(properties.edgeReplication ?? false);
-        const nameChanged = properties.name !== space.properties.name;
-        const iconChanged = properties.icon !== space.properties.icon;
-        const hueChanged = properties.hue !== space.properties.hue;
-        if (nameChanged || iconChanged || hueChanged) {
-          Obj.change(space.properties, (p) => {
-            if (nameChanged) {
-              p.name = properties.name;
-            }
-            if (iconChanged) {
-              p.icon = properties.icon;
-            }
-            if (hueChanged) {
-              p.hue = properties.hue;
-            }
-          });
-        }
-        if (properties.archived && !archived) {
-          void (async () => {
-            await invokePromise(SpaceOperation.Close, { space });
-            await invokePromise(Common.LayoutOperation.SwitchWorkspace, { subject: client.spaces.default.id });
-          })();
-        } else if (!properties.archived && archived) {
-          void invokePromise(SpaceOperation.Open, { space });
-        }
-      },
-      [space, toggleEdgeReplication, archived],
-    );
-
-    const values = useMemo(
-      () => ({
-        name: space.properties.name,
-        icon: space.properties.icon,
-        hue: space.properties.hue,
-        edgeReplication,
-        archived,
-      }),
-      [space.properties.name, space.properties.icon, space.properties.hue, edgeReplication, archived],
-    );
-
-    const fieldMap = useMemo<FormFieldMap>(
-      () => ({
-        name: ({ type, label, getValue, onValueChange }) => {
-          const handleChange = useCallback(
-            ({ target: { value } }: ChangeEvent<HTMLInputElement>) => onValueChange(type, value),
-            [onValueChange, type],
-          );
-          return (
-            <ControlItemInput title={label} description={t('display name description')}>
-              <Input.TextInput
-                value={getValue()}
-                onChange={handleChange}
-                placeholder={t('display name input placeholder')}
-                classNames='min-is-64'
-              />
-            </ControlItemInput>
-          );
-        },
-        icon: ({ type, label, getValue, onValueChange }) => {
-          const handleChange = useCallback((icon: string) => onValueChange(type, icon), [onValueChange, type]);
-          const handleReset = useCallback(() => onValueChange(type, undefined), [onValueChange, type]);
-          return (
-            <ControlItem title={label} description={t('icon description')}>
-              <IconPicker
-                value={getValue()}
-                onChange={handleChange}
-                onReset={handleReset}
-                classNames='justify-self-end'
-              />
-            </ControlItem>
-          );
-        },
-        hue: ({ type, label, getValue, onValueChange }) => {
-          const handleChange = useCallback((nextHue: string) => onValueChange(type, nextHue), [onValueChange, type]);
-          const handleReset = useCallback(() => onValueChange(type, undefined), [onValueChange, type]);
-          return (
-            <ControlItem title={label} description={t('hue description')}>
-              <HuePicker
-                value={getValue()}
-                onChange={handleChange}
-                onReset={handleReset}
-                classNames='justify-self-end'
-              />
-            </ControlItem>
-          );
-        },
-        edgeReplication: ({ type, label, getValue, onValueChange }) => {
-          const handleChange = useCallback((checked: boolean) => onValueChange(type, checked), [onValueChange, type]);
-          return (
-            <ControlItemInput title={label} description={t('edge replication description')}>
-              <Input.Switch checked={getValue()} onCheckedChange={handleChange} classNames='justify-self-end' />
-            </ControlItemInput>
-          );
-        },
-        archived: ({ type, label, getValue, onValueChange }) => {
-          const handleChange = useCallback(() => onValueChange(type, !getValue()), [onValueChange, type, getValue]);
-          return (
-            <ControlItemInput title={label} description={t('archive space description')}>
-              <Button
-                disabled={space === client.spaces.default}
-                variant={getValue() ? 'default' : 'destructive'}
-                onClick={handleChange}
-              >
-                {getValue() ? t('unarchive space label') : t('archive space label')}
-              </Button>
-            </ControlItemInput>
-          );
-        },
-      }),
-      [t, space],
-    );
-
-    const download = useFileDownload();
-    const handleBackup = useCallback(async () => {
-      const archive = await space.internal.export();
-      download(new Blob([archive.contents as Uint8Array<ArrayBuffer>]), archive.filename);
-    }, [space, download]);
-
-    const repairs = useCapabilities(SpaceCapabilities.Repair);
-    const handleRepair = useCallback(async () => {
-      await Promise.all(repairs.map((repair) => repair({ space, isDefault: client.spaces.default === space })));
-    }, [client, space, repairs]);
-
-    return (
-      <Layout.Container scrollable ref={forwardedRef}>
-        <ControlPage>
-          <ControlSection
-            title={t('space properties settings verbose label')}
-            description={t('space properties settings description', {
-              ns: meta.id,
-            })}
-          >
-            <Form.Root fieldMap={fieldMap} schema={SpaceFormSchema} values={values} autoSave onSave={handleSave}>
-              <Form.FieldSet />
-            </Form.Root>
-          </ControlSection>
-
-          <ControlSection title={t('space controls title')} description={t('space controls description')}>
-            <div role='none' className='container-max-width grid grid-cols-1 md:grid-cols-[1fr_min-content]'>
-              <ControlItemInput title={t('backup space title')} description={t('backup space description')}>
-                <Button onClick={handleBackup}>{t('download backup label')}</Button>
-              </ControlItemInput>
-              <ControlItemInput title={t('repair space title')} description={t('repair space description')}>
-                <Button onClick={handleRepair}>{t('repair space label')}</Button>
-              </ControlItemInput>
-            </div>
-          </ControlSection>
-        </ControlPage>
-      </Layout.Container>
-    );
-  },
-);
-
-SpaceSettingsContainer.displayName = 'SpaceSettingsContainer';

package/src/components/SpaceSettings/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-export * from './SpaceSettingsContainer';

package/src/helpers/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export * from './query';

package/src/helpers/query.test.ts

@@ -1,24 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { describe, expect, it } from 'vitest';
-
-import { evalQuery } from './query';
-
-describe('evalQuery', () => {
-  it('should evaluate a query string', () => {
-    const query = evalQuery('Query.select(Filter.type(Person.Person))');
-    expect(query.ast).toMatchInlineSnapshot(`
-      {
-        "filter": {
-          "id": undefined,
-          "props": {},
-          "type": "object",
-          "typename": "dxn:type:dxos.org/type/Person:0.1.0",
-        },
-        "type": "select",
-      }
-    `);
-  });
-});

package/src/helpers/query.ts

@@ -1,153 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import * as Array from 'effect/Array';
-import * as Effect from 'effect/Effect';
-import * as EffectFunction from 'effect/Function';
-import * as Match from 'effect/Match';
-import * as Option from 'effect/Option';
-import type * as Schema from 'effect/Schema';
-import * as SchemaAST from 'effect/SchemaAST';
-
-import { DXN, Filter, Query, type QueryAST, type SchemaRegistry } from '@dxos/echo';
-import {
-  ReferenceAnnotationId,
-  type ReferenceAnnotationValue,
-  getTypeAnnotation,
-  unwrapOptional,
-} from '@dxos/echo/internal';
-import { runAndForwardErrors } from '@dxos/effect';
-import { log } from '@dxos/log';
-import { type Space } from '@dxos/react-client/echo';
-import { Person } from '@dxos/types';
-
-// TODO(wittjosiah): Factor out and add tests.
-// TODO(wittjosiah): Support arbitrary type imports.
-export const evalQuery = (queryString: string): Query.Any => {
-  const globals = { Query, Filter, Person };
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-implied-eval
-    return new Function(...Object.keys(globals), `return ${queryString}`)(...Object.values(globals));
-  } catch (err) {
-    log.catch(err);
-    return Query.select(Filter.nothing());
-  }
-};
-
-export const resolveSchemaWithRegistry = (registry: SchemaRegistry.SchemaRegistry, query: QueryAST.Query) => {
-  const resolve = Effect.fn(function* (dxn: string) {
-    const typename = DXN.parse(dxn).asTypeDXN()?.type;
-    if (!typename) {
-      return Option.none();
-    }
-
-    const query = registry.query({ typename, location: ['database', 'runtime'] });
-    const schemas = yield* Effect.promise(() => query.run());
-    return Array.head(schemas);
-  });
-
-  return resolveSchema(query, resolve).pipe(
-    Effect.map((schema) => Option.getOrUndefined(schema)),
-    runAndForwardErrors,
-  );
-};
-
-const resolveSchema = (
-  query: QueryAST.Query,
-  resolve: (dxn: string) => Effect.Effect<Option.Option<Schema.Schema.AnyNoContext>>,
-): Effect.Effect<Option.Option<Schema.Schema.AnyNoContext>> => {
-  return Match.value(query).pipe(
-    Match.withReturnType<Effect.Effect<Option.Option<Schema.Schema.AnyNoContext>>>(),
-    // TODO(wittjosiah): Reconcile with filter match?
-    Match.when({ type: 'select' }, ({ filter }) =>
-      typenameFromFilter(filter).pipe(
-        Option.map((typename) => resolve(typename)),
-        Option.getOrElse(() => Effect.succeed(Option.none<Schema.Schema.AnyNoContext>())),
-      ),
-    ),
-    Match.when({ type: 'filter' }, ({ filter }) =>
-      typenameFromFilter(filter).pipe(
-        Option.map((typename) => resolve(typename)),
-        Option.getOrElse(() => Effect.succeed(Option.none<Schema.Schema.AnyNoContext>())),
-      ),
-    ),
-    Match.when({ type: 'reference-traversal' }, ({ anchor, property }) =>
-      resolveSchema(anchor, resolve).pipe(
-        Effect.map((base) =>
-          base.pipe(
-            Option.map((schema) => SchemaAST.getPropertySignatures(schema.ast)),
-            Option.flatMap((properties) => Array.findFirst(properties, (p) => p.name === property)),
-            Option.flatMap((property) =>
-              SchemaAST.getAnnotation<ReferenceAnnotationValue>(ReferenceAnnotationId)(unwrapOptional(property)),
-            ),
-            Option.map((annotation) => annotation.typename),
-          ),
-        ),
-        Effect.flatMap(
-          Option.match({
-            onNone: () => Effect.succeed(Option.none()),
-            onSome: (typename) => resolve(DXN.fromTypename(typename).toString()),
-          }),
-        ),
-      ),
-    ),
-    Match.when({ type: 'relation', filter: Match.defined }, ({ filter }) =>
-      typenameFromFilter(filter).pipe(
-        Option.map((typename) => resolve(typename)),
-        Option.getOrElse(() => Effect.succeed(Option.none<Schema.Schema.AnyNoContext>())),
-      ),
-    ),
-    Match.when({ type: 'relation-traversal' }, ({ anchor, direction }) =>
-      resolveSchema(anchor, resolve).pipe(
-        Effect.map((base) =>
-          base.pipe(
-            Option.map((schema) => getTypeAnnotation(schema)),
-            Option.flatMap((annotation) =>
-              Option.fromNullable(direction === 'source' ? annotation?.sourceSchema : annotation?.targetSchema),
-            ),
-          ),
-        ),
-        Effect.flatMap(
-          Option.match({
-            onNone: () => Effect.succeed(Option.none()),
-            onSome: (typename) => resolve(typename),
-          }),
-        ),
-      ),
-    ),
-    Match.when({ type: 'options' }, ({ query }) => resolveSchema(query, resolve)),
-    Match.orElse((_q) => {
-      // TODO(wittjosiah): Implement other cases.
-      return Effect.succeed(Option.none());
-    }),
-  );
-};
-
-const typenameFromFilter = (filter: QueryAST.Filter): Option.Option<string> =>
-  Match.value(filter).pipe(
-    Match.withReturnType<Option.Option<string>>(),
-    Match.when({ type: 'object' }, ({ typename }) => Option.fromNullable(typename)),
-    Match.when({ type: 'and' }, ({ filters }) =>
-      EffectFunction.pipe(filters, Array.map(typenameFromFilter), Array.findFirst(Option.isSome), Option.flatten),
-    ),
-    Match.when({ type: 'or' }, ({ filters }) =>
-      EffectFunction.pipe(filters, Array.map(typenameFromFilter), Array.findFirst(Option.isSome), Option.flatten),
-    ),
-    Match.orElse(() => Option.none()),
-  );
-
-// TODO(wittjosiah): Currently assumes options is at the top-level of the ast.
-export const getQueryTarget = (query: QueryAST.Query, space?: Space) => {
-  return Match.value(query).pipe(
-    Match.when({ type: 'options' }, ({ options }) => {
-      return Option.fromNullable(options.queues).pipe(
-        Option.flatMap((queues) => Array.head(queues)),
-        Option.flatMap((queueDxn) => Option.fromNullable(DXN.tryParse(queueDxn))),
-        Option.flatMap((queueDxn) => Option.fromNullable(space?.queues.get(queueDxn))),
-        Option.getOrElse(() => space?.db),
-      );
-    }),
-    Match.orElse(() => space?.db),
-  );
-};

package/src/hooks/useActiveSpace.ts

@@ -1,23 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type CapabilityManager, Common } from '@dxos/app-framework';
-import { useLayout } from '@dxos/app-framework/react';
-import { ClientCapabilities } from '@dxos/plugin-client';
-import { parseId, useSpace } from '@dxos/react-client/echo';
-
-export const getActiveSpace = (capabilities: CapabilityManager.CapabilityManager) => {
-  const client = capabilities.get(ClientCapabilities.Client);
-  const registry = capabilities.get(Common.Capability.AtomRegistry);
-  const layoutAtom = capabilities.get(Common.Capability.Layout);
-  const layout = registry.get(layoutAtom);
-  const { spaceId } = parseId(layout.workspace);
-  return spaceId ? client.spaces.get(spaceId) : undefined;
-};
-
-export const useActiveSpace = () => {
-  const layout = useLayout();
-  const { spaceId } = parseId(layout.workspace);
-  return useSpace(spaceId);
-};

package/src/hooks/useTypeOptions.ts

@@ -1,25 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useMemo } from 'react';
-
-import { type Space } from '@dxos/react-client/echo';
-import { useTranslation } from '@dxos/react-ui';
-
-import { type TypeInputOptions, getTypenames } from '../types';
-
-export const useTypeOptions = ({ space, annotation }: { space?: Space; annotation: TypeInputOptions }) => {
-  const { t } = useTranslation();
-  const typenames = getTypenames({ annotation, space });
-  return useMemo(
-    () =>
-      typenames
-        .map((typename) => ({
-          value: typename,
-          label: t('typename label', { ns: typename, defaultValue: typename }),
-        }))
-        .toSorted((a, b) => a.label.localeCompare(b.label)),
-    [t, typenames],
-  );
-};