@dxos/client-protocol 0.8.4-main.2e9d522 → 0.8.4-main.3c1ae3b

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/client-protocol",
-  "version": "0.8.4-main.2e9d522",
+  "version": "0.8.4-main.3c1ae3b",
   "description": "Core DXOS Client API.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -11,14 +11,25 @@
   "type": "module",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs"
+    },
+    "./types": {
+      "source": "./src/types/index.ts",
+      "types": "./dist/types/src/types/index.d.ts",
+      "browser": "./dist/lib/browser/types/index.mjs",
+      "node": "./dist/lib/node-esm/types/index.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
   "typesVersions": {
-    "*": {}
+    "*": {
+      "./types": [
+        "./dist/types/src/types/index.d.ts"
+      ]
+    }
   },
   "files": [
     "dist",
@@ -26,19 +37,17 @@
   ],
   "dependencies": {
     "base-x": "~3.0.9",
-    "effect": "3.17.0",
-    "@dxos/async": "0.8.4-main.2e9d522",
-    "@dxos/config": "0.8.4-main.2e9d522",
-    "@dxos/context": "0.8.4-main.2e9d522",
-    "@dxos/credentials": "0.8.4-main.2e9d522",
-    "@dxos/echo": "0.8.4-main.2e9d522",
-    "@dxos/echo-db": "0.8.4-main.2e9d522",
-    "@dxos/echo-schema": "0.8.4-main.2e9d522",
-    "@dxos/invariant": "0.8.4-main.2e9d522",
-    "@dxos/keys": "0.8.4-main.2e9d522",
-    "@dxos/node-std": "0.8.4-main.2e9d522",
-    "@dxos/protocols": "0.8.4-main.2e9d522",
-    "@dxos/rpc": "0.8.4-main.2e9d522"
+    "effect": "3.18.3",
+    "@dxos/async": "0.8.4-main.3c1ae3b",
+    "@dxos/context": "0.8.4-main.3c1ae3b",
+    "@dxos/credentials": "0.8.4-main.3c1ae3b",
+    "@dxos/echo": "0.8.4-main.3c1ae3b",
+    "@dxos/echo-db": "0.8.4-main.3c1ae3b",
+    "@dxos/invariant": "0.8.4-main.3c1ae3b",
+    "@dxos/node-std": "0.8.4-main.3c1ae3b",
+    "@dxos/protocols": "0.8.4-main.3c1ae3b",
+    "@dxos/rpc": "0.8.4-main.3c1ae3b",
+    "@dxos/keys": "0.8.4-main.3c1ae3b"
   },
   "peerDependencies": {
     "effect": "^3.13.3"

package/src/config.ts

@@ -2,7 +2,7 @@
 // Copyright 2022 DXOS.org
 //
 
-import { type ConfigProto } from '@dxos/config';
+// TODO(wittjosiah): Factor out to @dxos/config.
 
 export const DEFAULT_INTERNAL_CHANNEL = 'dxos:vault';
 export const DEFAULT_CLIENT_CHANNEL = 'dxos:app';
@@ -15,7 +15,7 @@ export const DEFAULT_WORKER_BROADCAST_CHANNEL = 'dxos:shared-worker';
 export const DEFAULT_VAULT_URL = 'https://halo.dxos.org/vault.html';
 
 export const EXPECTED_CONFIG_VERSION = 1;
-export const defaultConfig: ConfigProto = { version: 1 };
+export const defaultConfig = { version: 1 };
 
 // TODO(burdon): Allow override via env? Generalize since currently NodeJS only.
 const HOME = typeof process !== 'undefined' ? (process?.env?.HOME ?? '') : '';

package/src/echo.ts

@@ -3,26 +3,19 @@
 //
 
 import type { MulticastObservable } from '@dxos/async';
-import type { QueryFn } from '@dxos/echo-db';
+import type { Database } from '@dxos/echo';
 import type { PublicKey, SpaceId } from '@dxos/keys';
 import type { Invitation, SpaceArchive } from '@dxos/protocols/proto/dxos/client/services';
 
 import type { AuthenticatingInvitation } from './invitations';
-import type { PropertiesTypeProps } from './schema';
 import type { Space } from './space';
+import type { SpaceProperties } from './types';
 
 /**
- * TODO(burdon): Public API (move comments here).
+ * Public database API.
  */
-// TODO(wittjosiah): Rename?
-//   https://ts.dev/style/#naming-style
-//   ClientApi? ClientProtocol?
-export interface Echo extends MulticastObservable<Space[]> {
-  /**
-   * Resolves when the default space is available.
-   */
-  waitUntilReady(): Promise<void>;
-
+// TODO(wittjosiah): Rename Database (not product name).
+export interface Echo extends MulticastObservable<Space[]>, Database.Queryable {
   /**
    * Observable which indicates when the default space is available.
    */
@@ -50,10 +43,15 @@ export interface Echo extends MulticastObservable<Space[]> {
    */
   get default(): Space;
 
+  /**
+   * Resolves when the default space is available.
+   */
+  waitUntilReady(): Promise<void>;
+
   /**
    * Creates a new space.
    */
-  create(meta?: PropertiesTypeProps): Promise<Space>;
+  create(props?: Pick<SpaceProperties, 'name' | 'hue' | 'icon' | 'invocationTraceQueue'>): Promise<Space>;
 
   /**
    * Creates a space from the given archive.
@@ -66,11 +64,4 @@ export interface Echo extends MulticastObservable<Space[]> {
   join(invitation: Invitation | string): AuthenticatingInvitation;
 
   joinBySpaceKey(spaceKey: PublicKey): Promise<Space>;
-
-  /**
-   * Query all spaces.
-   * @param filter
-   * @param options
-   */
-  query: QueryFn;
 }

package/src/halo.ts

@@ -6,8 +6,8 @@ import { type MulticastObservable } from '@dxos/async';
 import { type PublicKey } from '@dxos/keys';
 import { type Contact, type Device, type Identity, type Invitation } from '@dxos/protocols/proto/dxos/client/services';
 import {
-  type DeviceProfileDocument,
   type Credential,
+  type DeviceProfileDocument,
   type Presentation,
   type ProfileDocument,
 } from '@dxos/protocols/proto/dxos/halo/credentials';

package/src/index.ts

@@ -7,8 +7,8 @@ export * from './config';
 export type * from './echo';
 export type * from './halo';
 export * from './invitations';
-export * from './service-definitions';
+export * from './service';
 export type * from './shell';
-export type * from './space';
+export * from './space';
 export * from './timeouts';
-export * from './schema';
+export * from './types';

package/src/{service-definitions.ts → service.ts}

@@ -4,17 +4,16 @@
 
 import { type Event } from '@dxos/async';
 import { schema } from '@dxos/protocols/proto';
-import type { FunctionRegistryService } from '@dxos/protocols/proto/dxos/agent/functions';
 import type {
+  ContactsService,
   DevicesService,
+  EdgeAgentService,
   IdentityService,
   InvitationsService,
   LoggingService,
   NetworkService,
   SpacesService,
   SystemService,
-  ContactsService,
-  EdgeAgentService,
 } from '@dxos/protocols/proto/dxos/client/services';
 import type { DevtoolsHost } from '@dxos/protocols/proto/dxos/devtools/host';
 import type { QueryService } from '@dxos/protocols/proto/dxos/echo/query';
@@ -42,8 +41,6 @@ export type ClientServices = {
   ContactsService: ContactsService;
   EdgeAgentService: EdgeAgentService;
 
-  FunctionRegistryService: FunctionRegistryService;
-
   // TODO(burdon): Deprecated.
   DevtoolsHost: DevtoolsHost;
 
@@ -84,12 +81,8 @@ export const clientServiceBundle = createServiceBundle<ClientServices>({
   ContactsService: schema.getService('dxos.client.services.ContactsService'),
   EdgeAgentService: schema.getService('dxos.client.services.EdgeAgentService'),
 
-  // Agent-only.
-  FunctionRegistryService: schema.getService('dxos.agent.functions.FunctionRegistryService'),
-
   // TODO(burdon): Deprecated.
   DevtoolsHost: schema.getService('dxos.devtools.host.DevtoolsHost'),
-
   TracingService: schema.getService('dxos.tracing.TracingService'),
 });
 

package/src/shell.ts

@@ -5,8 +5,8 @@
 import { type Event } from '@dxos/async';
 import { type PublicKey } from '@dxos/keys';
 import {
-  type InvitationUrlRequest,
   type AppContextRequest,
+  type InvitationUrlRequest,
   type LayoutRequest,
   type ShellLayout,
 } from '@dxos/protocols/proto/dxos/iframe';

package/src/space.ts

@@ -2,16 +2,20 @@
 // Copyright 2021 DXOS.org
 //
 
-import { type MulticastObservable, type CleanupFn } from '@dxos/async';
+import * as Schema from 'effect/Schema';
+
+import { type MulticastObservable } from '@dxos/async';
 import { type SpecificCredential } from '@dxos/credentials';
-import { type QueueFactory, type EchoDatabase, type AnyLiveObject } from '@dxos/echo-db';
+import { type Obj } from '@dxos/echo';
+import { type EchoDatabase, type QueueFactory, type SpaceSyncState } from '@dxos/echo-db';
 import { type PublicKey, type SpaceId } from '@dxos/keys';
+import { type Messenger } from '@dxos/protocols';
 import {
   type Contact,
   type CreateEpochRequest,
   type Invitation,
-  type Space as SpaceData,
   type SpaceArchive,
+  type Space as SpaceData,
   type SpaceMember,
   type SpaceState,
   type UpdateMemberRoleRequest,
@@ -19,9 +23,9 @@ import {
 import { type EdgeReplicationSetting } from '@dxos/protocols/proto/dxos/echo/metadata';
 import { type SpaceSnapshot } from '@dxos/protocols/proto/dxos/echo/snapshot';
 import { type Credential, type Epoch } from '@dxos/protocols/proto/dxos/halo/credentials';
-import { type GossipMessage } from '@dxos/protocols/proto/dxos/mesh/teleport/gossip';
 
 import { type CancellableInvitation } from './invitations';
+import { type SpaceProperties } from './types';
 
 export type CreateEpochOptions = {
   migration?: CreateEpochRequest.Migration;
@@ -31,15 +35,18 @@ export type CreateEpochOptions = {
 export interface SpaceInternal {
   get data(): SpaceData;
 
-  // TODO(dmaretskyi): Return epoch info.
-  createEpoch(options?: CreateEpochOptions): Promise<void>;
-
   getCredentials(): Promise<Credential[]>;
 
   getEpochs(): Promise<SpecificCredential<Epoch>[]>;
 
+  // TODO(dmaretskyi): Return epoch info.
+  createEpoch(options?: CreateEpochOptions): Promise<void>;
+
+  // TOOD(burdon): Start to factor out credentials.
   removeMember(memberKey: PublicKey): Promise<void>;
 
+  export(): Promise<SpaceArchive>;
+
   /**
    * Migrate space data to the latest version.
    */
@@ -47,21 +54,31 @@ export interface SpaceInternal {
 
   setEdgeReplicationPreference(setting: EdgeReplicationSetting): Promise<void>;
 
-  export(): Promise<SpaceArchive>;
-}
-
-// TODO(burdon): Separate public API form implementation (move comments here).
-export interface Space {
   /**
-   * Unique space identifier.
+   * Waits until the space is fully synced with EDGE.
+   * @throws If the EDGE sync is disabled.
    */
-  get id(): SpaceId;
+  syncToEdge(opts?: {
+    onProgress: (state: SpaceSyncState.PeerState | undefined) => void;
+    timeout?: number;
+  }): Promise<void>;
+}
+
+export const SPACE_TAG = Symbol('dxos.client.protocol.Space');
+
+export interface Space extends Messenger {
+  readonly [SPACE_TAG]: true;
 
   /**
    * @deprecated Use `id`.
    */
   get key(): PublicKey;
 
+  /**
+   * Unique space identifier.
+   */
+  get id(): SpaceId;
+
   /**
    * Echo database.
    */
@@ -72,13 +89,9 @@ export interface Space {
    */
   get queues(): QueueFactory;
 
+  // TODO(burdon): Replace with state?
   get isOpen(): boolean;
 
-  /**
-   * Properties object.
-   */
-  get properties(): AnyLiveObject<any>;
-
   /**
    * Current state of the space.
    * The database is ready to be used in `SpaceState.SPACE_READY` state.
@@ -86,6 +99,11 @@ export interface Space {
    */
   get state(): MulticastObservable<SpaceState>;
 
+  /**
+   * Properties object.
+   */
+  get properties(): Obj.Obj<SpaceProperties>;
+
   /**
    * Current state of space pipeline.
    */
@@ -101,11 +119,11 @@ export interface Space {
   // TODO(wittjosiah): Remove. This should not be exposed.
   get internal(): SpaceInternal;
 
-  // TODO(wittjosiah): Rename activate/deactivate?
   /**
    * Activates the space enabling the use of the database and starts replication with peers.
    * The setting is persisted on the local device.
    */
+  // TODO(wittjosiah): Rename activate/deactivate?
   open(): Promise<void>;
 
   /**
@@ -123,13 +141,17 @@ export interface Space {
   createSnapshot(): Promise<SpaceSnapshot>;
 
   // TODO(burdon): Create invitation?
+  // TODO(burdon): Factor out membership, etc.
   share(options?: Partial<Invitation>): CancellableInvitation;
-
   admitContact(contact: Contact): Promise<void>;
-
   updateMemberRole(request: Omit<UpdateMemberRoleRequest, 'spaceKey'>): Promise<void>;
-
-  // TODO(wittjosiah): Gather into messaging abstraction?
-  postMessage: (channel: string, message: any) => Promise<void>;
-  listen: (channel: string, callback: (message: GossipMessage) => void) => CleanupFn;
 }
+
+export const isSpace = (object: unknown): object is Space =>
+  typeof object === 'object' && object != null && (object as Space)[SPACE_TAG] === true;
+
+// TODO(burdon): Create lower-level definition (HasId, db, etc.) and move to @dxos/echo.
+export const SpaceSchema: Schema.Schema<Space> = Schema.Any.pipe(
+  Schema.filter((space) => isSpace(space)),
+  Schema.annotations({ title: 'Space' }),
+);

package/src/timeouts.ts

@@ -33,6 +33,11 @@ export const LOAD_PROPERTIES_TIMEOUT = 3_000;
  */
 export const CREATE_SPACE_TIMEOUT = 5_000;
 
+/**
+ * Timeout for creating new spaces.
+ */
+export const IMPORT_SPACE_TIMEOUT = 30_000;
+
 /**
  * Timeout for loading of control feeds.
  */

package/src/types/SpaceProperties.ts

@@ -0,0 +1,49 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+
+import { Annotation, Type } from '@dxos/echo';
+import { Queue } from '@dxos/echo-db';
+
+export const SpacePropertiesSchema = Schema.Struct(
+  {
+    //
+    // System properties.
+    //
+
+    archived: Schema.optional(Schema.Boolean.annotations({ title: 'Archive Space' })),
+    // TODO(burdon): Change to mode (no booleans?)
+    // TODO(wittjosiah): Make optional with default value.
+    edgeReplication: Schema.optional(Schema.Boolean),
+    invocationTraceQueue: Schema.optional(Type.Ref(Queue)),
+
+    //
+    // User properties.
+    //
+
+    name: Schema.optional(Schema.String),
+    icon: Schema.optional(Schema.String),
+    hue: Schema.optional(Schema.String),
+  },
+  {
+    key: Schema.String,
+    value: Schema.Any,
+  },
+);
+
+export type SpacePropertiesSchema = Schema.Schema.Type<typeof SpacePropertiesSchema>;
+
+// TODO(burdon): Pipe Schem.optional, or partial to entire struct to make everything optional?
+// TODO(burdon): Is separate schema def required for forms? Can it be extracted from SpaceProperties?
+export const SpaceProperties = SpacePropertiesSchema.pipe(
+  Type.Obj({
+    // TODO(burdon): Rename SpaceProperties.
+    typename: 'dxos.org/type/Properties',
+    version: '0.1.0',
+  }),
+  Annotation.SystemTypeAnnotation.set(true),
+);
+
+export interface SpaceProperties extends Schema.Schema.Type<typeof SpaceProperties> {}

package/src/types/index.ts

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

package/dist/types/src/schema.d.ts

@@ -1,27 +0,0 @@
-import { Schema } from 'effect';
-import { Type } from '@dxos/echo';
-export declare const TYPE_PROPERTIES = "dxos.org/type/Properties";
-declare const PropertiesType_base: import("@dxos/echo-schema").TypedObjectPrototype<import("@dxos/echo-schema").TypedObjectFields<{
-    name: Schema.optional<typeof Schema.String>;
-    hue: Schema.optional<typeof Schema.String>;
-    icon: Schema.optional<typeof Schema.String>;
-    invocationTraceQueue: Schema.optional<Type.ref<Schema.Schema<Type.Expando, {
-        [x: string]: any;
-        id: string;
-    }, never>>>;
-}, {
-    record: true;
-}>, Schema.Struct.Encoded<{
-    name: Schema.optional<typeof Schema.String>;
-    hue: Schema.optional<typeof Schema.String>;
-    icon: Schema.optional<typeof Schema.String>;
-    invocationTraceQueue: Schema.optional<Type.ref<Schema.Schema<Type.Expando, {
-        [x: string]: any;
-        id: string;
-    }, never>>>;
-}>>;
-export declare class PropertiesType extends PropertiesType_base {
-}
-export type PropertiesTypeProps = Pick<PropertiesType, 'name' | 'hue' | 'icon' | 'invocationTraceQueue'>;
-export {};
-//# sourceMappingURL=schema.d.ts.map

package/dist/types/src/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGlC,eAAO,MAAM,eAAe,6BAA6B,CAAC;;;;;;;;;;;;;;;;;;;;AAG1D,qBAAa,cAAe,SAAQ,mBAYnC;CAAG;AAGJ,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,sBAAsB,CAAC,CAAC"}

package/dist/types/src/service-definitions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"service-definitions.d.ts","sourceRoot":"","sources":["../../../src/service-definitions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EACjB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,WAAW,CAAC;AAMpE,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAE/B,eAAe,EAAE,eAAe,CAAC;IACjC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,uBAAuB,EAAE,uBAAuB,CAAC;IAGjD,YAAY,EAAE,YAAY,CAAC;IAE3B,cAAc,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACjC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAGlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,+BAqB9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,mBAAmB,CAElE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,mBAAmB,CAElE,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,CAE5D,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,kBAAkB,CAEhE,CAAC"}

package/src/schema.ts

@@ -1,28 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { Schema } from 'effect';
-
-import { Type } from '@dxos/echo';
-import { TypedObject } from '@dxos/echo-schema';
-
-export const TYPE_PROPERTIES = 'dxos.org/type/Properties';
-
-// TODO(burdon): Factor out (co-locate with TYPE_PROPERTIES).
-export class PropertiesType extends TypedObject({
-  typename: TYPE_PROPERTIES,
-  version: '0.1.0',
-})(
-  {
-    name: Schema.optional(Schema.String),
-    // TODO(wittjosiah): Make generic?
-    hue: Schema.optional(Schema.String),
-    icon: Schema.optional(Schema.String),
-    invocationTraceQueue: Schema.optional(Type.Ref(Type.Expando)),
-  },
-  { record: true },
-) {}
-
-// TODO(burdon): Remove? Use PropertiesType instead?
-export type PropertiesTypeProps = Pick<PropertiesType, 'name' | 'hue' | 'icon' | 'invocationTraceQueue'>;