@dxos/plugin-space 0.8.4-main.422d1c7879 → 0.8.4-main.43cb759274

package/src/index.ts

@@ -2,10 +2,8 @@
 // Copyright 2023 DXOS.org
 //
 
-export { SpaceCapabilities, SpaceEvents } from './types';
-
-export * from './components';
 export * from './meta';
+export * from './types';
 export * from './util';
 
-export * from './SpacePlugin';
+export { CollectionOperation, SpaceOperation } from './operations/definitions';

package/src/meta.ts

@@ -2,15 +2,33 @@
 // Copyright 2023 DXOS.org
 //
 
-import { type Plugin } from '@dxos/app-framework';
+import { Plugin } from '@dxos/app-framework';
+import { DXN } from '@dxos/keys';
 import { trim } from '@dxos/util';
 
-export const meta: Plugin.Meta = {
-  id: 'org.dxos.plugin.space',
+export const meta = Plugin.makeMeta({
+  key: DXN.make('org.dxos.plugin.space'),
   name: 'Spaces',
+  author: 'DXOS',
+  spec: 'PLUGIN.mdl',
   description: trim`
-    Core workspace container system for organizing and sharing collaborative environments.
-    Create, manage, and share spaces with granular access control and invitation management.
+    SpacePlugin is the core workspace container for DXOS Composer. It owns the full lifecycle of
+    collaborative spaces — creating, joining, opening, closing, and resetting them — and manages
+    the membership and invitation system that controls who can access each space.
+
+    The plugin maintains an ordered app-graph of every space and its collections, wires navigation
+    so that opening a space or object updates the layout, and tracks real-time peer presence so
+    that the UI can show which collaborators are viewing each object.
+
+    Object and schema management sit at the heart of SpacePlugin: it registers the canonical DXOS
+    schema types (Person, Task, Project, Event, …), provides the create-object dialog that all
+    other plugins populate with their own types, and exposes operations for adding, removing,
+    restoring, duplicating, and serialising objects. Import/export of space archives and schema
+    migrations are also handled here.
+
+    A full set of undo-aware operations (RemoveObjects/RestoreObjects, DeleteField/RestoreField)
+    integrates with the process manager so that destructive edits can be reversed in one step.
   `,
   icon: 'ph--planet--regular',
-};
+  tags: ['system'],
+});

package/src/operations/add-object.ts

@@ -3,13 +3,12 @@
 import * as Effect from 'effect/Effect';
 import * as Option from 'effect/Option';
 
-import { getCollectionsPath, getObjectPath, getTypePath } from '@dxos/app-toolkit';
-import { Database, Obj, View } from '@dxos/echo';
-import { Collection } from '@dxos/echo';
+import { CollectionModel, getCollectionsPath, getObjectPath, getTypePath } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
+import { Collection, Database, Filter, Obj, Query, Scope, Type } from '@dxos/echo';
 import { invariant } from '@dxos/invariant';
-import { Operation } from '@dxos/operation';
-import { ObservabilityOperation } from '@dxos/plugin-observability/operations';
-import { CollectionModel, ViewAnnotation, getTypenameFromQuery } from '@dxos/schema';
+import { ObservabilityOperation } from '@dxos/plugin-observability';
+import { ViewAnnotation, getTypenameFromQuery } from '@dxos/schema';
 
 import { SpaceOperation } from './definitions';
 
@@ -37,11 +36,15 @@ const handler: Operation.WithHandler<typeof SpaceOperation.AddObject> = SpaceOpe
         },
       });
 
-      const [schema] = db.schemaRegistry.query({ typename, location: ['runtime'] }).runSync();
-      const isViewSchema = schema !== undefined && ViewAnnotation.get(schema).pipe(Option.getOrElse(() => false));
-      const view = isViewSchema
-        ? yield* Effect.promise(() => (object as Obj.Any).view.load() as Promise<View.View>)
-        : undefined;
+      const types = yield* Effect.promise(() =>
+        db.query(Query.select(Filter.type(Type.Type)).from(Scope.registry())).run(),
+      );
+      const [runtimeSchema] = types.filter((t) => !Type.isTypeKind(t) && Type.getTypename(t) === typename);
+      const echoViewPath =
+        runtimeSchema !== undefined
+          ? ViewAnnotation.get(Type.getSchema(runtimeSchema)).pipe(Option.getOrElse(() => []))
+          : [];
+      const view = echoViewPath.length > 0 ? yield* ViewAnnotation.tryLoadAtPath(object, echoViewPath) : undefined;
       const viewTargetTypename = view ? getTypenameFromQuery(view.query.ast) : undefined;
       const subject = getSubjectPathForNewObject({
         spaceId: db.spaceId,
@@ -52,7 +55,7 @@ const handler: Operation.WithHandler<typeof SpaceOperation.AddObject> = SpaceOpe
       });
 
       return {
-        id: Obj.getDXN(object).toString(),
+        id: Obj.getURI(object),
         subject: [subject],
         object,
       };
@@ -72,7 +75,7 @@ const getSubjectPathForNewObject = (props: {
   if (typeof nodeId === 'string') {
     return `${nodeId}/${objectId}`;
   }
-  if (typename === Collection.Collection.typename) {
+  if (typename === Type.getTypename(Collection.Collection)) {
     return getCollectionsPath(spaceId, objectId);
   }
   if (viewTargetTypename) {

package/src/operations/add-relation.ts

@@ -2,8 +2,8 @@
 
 import * as Effect from 'effect/Effect';
 
+import { Operation } from '@dxos/compute';
 import { Database, Relation } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
 
 import { SpaceOperation } from './definitions';
 

package/src/operations/add-type.ts

@@ -0,0 +1,51 @@
+// Copyright 2025 DXOS.org
+
+import * as Effect from 'effect/Effect';
+
+import { Capability, Plugin } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+import { Type } from '@dxos/echo';
+import { ObservabilityOperation } from '@dxos/plugin-observability';
+
+import { SpaceEvents, SpaceCapabilities } from '../types';
+import { SpaceOperation } from './definitions';
+
+const handler: Operation.WithHandler<typeof SpaceOperation.AddType> = SpaceOperation.AddType.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* (input) {
+      const db = input.db;
+      const type = yield* Effect.promise(() => db.addType(input.type));
+      Type.update(type, (draft) => {
+        if (input.name) {
+          draft.name = input.name;
+        }
+        const meta = Type.getMeta(draft);
+        if (input.typename) {
+          meta.key = input.typename;
+        }
+        if (input.version) {
+          meta.version = input.version;
+        }
+      });
+
+      yield* Plugin.activate(SpaceEvents.TypeAdded);
+      const onTypeAdded = yield* Capability.getAll(SpaceCapabilities.OnTypeAdded);
+      yield* Effect.all(
+        onTypeAdded.map((callback) => callback({ db, type, show: input.show })),
+        { concurrency: 'unbounded' },
+      );
+
+      yield* Operation.schedule(ObservabilityOperation.SendEvent, {
+        name: 'space.type.add',
+        properties: {
+          spaceId: db.spaceId,
+          objectId: type.id,
+          typename: Type.getTypename(type),
+        },
+      });
+
+      return { id: type.id, object: type };
+    }),
+  ),
+);
+export default handler;

package/src/operations/close.ts

@@ -2,7 +2,7 @@
 
 import * as Effect from 'effect/Effect';
 
-import { Operation } from '@dxos/operation';
+import { Operation } from '@dxos/compute';
 
 import { SpaceOperation } from './definitions';
 

package/src/operations/create.ts

@@ -3,11 +3,12 @@
 import * as Effect from 'effect/Effect';
 
 import { Capability, Plugin } from '@dxos/app-framework';
-import { Collection, Obj, Ref } from '@dxos/echo';
-import { Migrations } from '@dxos/migrations';
-import { Operation } from '@dxos/operation';
-import { ClientCapabilities } from '@dxos/plugin-client/types';
-import { ObservabilityOperation } from '@dxos/plugin-observability/operations';
+import { RootCollectionAnnotation } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
+import { Annotation, Collection, Obj, Ref } from '@dxos/echo';
+import { MigrationVersionAnnotation, Migrations } from '@dxos/migrations';
+import { ClientCapabilities } from '@dxos/plugin-client';
+import { ObservabilityOperation } from '@dxos/plugin-observability';
 import { EdgeReplicationSetting } from '@dxos/protocols/proto/dxos/echo/metadata';
 import { iconValues } from '@dxos/react-ui-pickers/icons';
 import { hues } from '@dxos/ui-theme';
@@ -22,17 +23,23 @@ const handler: Operation.WithHandler<typeof SpaceOperation.Create> = SpaceOperat
       const client = yield* Capability.get(ClientCapabilities.Client);
       const hue = hue_ ?? hues[Math.floor(Math.random() * hues.length)];
       const icon = icon_ ?? iconValues[Math.floor(Math.random() * iconValues.length)];
-      const space = yield* Effect.promise(() => client.spaces.create({ name, hue, icon }));
+      const space = yield* Effect.promise(() =>
+        client.spaces.create({
+          name,
+          hue,
+          icon,
+        }),
+      );
       if (edgeReplication) {
         yield* Effect.promise(() => space.internal.setEdgeReplicationPreference(EdgeReplicationSetting.ENABLED));
       }
       yield* Effect.promise(() => space.waitUntilReady());
 
       const collection = Obj.make(Collection.Collection, { objects: [] });
-      Obj.change(space.properties, (obj) => {
-        obj[Collection.Collection.typename] = Ref.make(collection);
-        if (Migrations.versionProperty) {
-          obj[Migrations.versionProperty] = Migrations.targetVersion;
+      Obj.update(space.properties, (properties) => {
+        Annotation.set(properties, RootCollectionAnnotation, Ref.make(collection));
+        if (Migrations.targetVersion) {
+          Annotation.set(properties, MigrationVersionAnnotation, Migrations.targetVersion);
         }
       });