@dxos/client 2.28.2-dev.5bd59700 → 2.28.2-dev.cc97ac04

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/client",
-  "version": "2.28.2-dev.5bd59700",
+  "version": "2.28.2-dev.cc97ac04",
   "license": "MIT",
   "author": "DXOS.org",
   "main": "dist/src/index.js",
@@ -10,21 +10,21 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/async": "2.28.2-dev.5bd59700",
-    "@dxos/codec-protobuf": "2.28.2-dev.5bd59700",
-    "@dxos/config": "2.28.2-dev.5bd59700",
-    "@dxos/credentials": "2.28.2-dev.5bd59700",
-    "@dxos/crypto": "2.28.2-dev.5bd59700",
-    "@dxos/debug": "2.28.2-dev.5bd59700",
-    "@dxos/echo-db": "2.28.2-dev.5bd59700",
-    "@dxos/echo-protocol": "2.28.2-dev.5bd59700",
-    "@dxos/feed-store": "2.28.2-dev.5bd59700",
-    "@dxos/model-factory": "2.28.2-dev.5bd59700",
-    "@dxos/network-manager": "2.28.2-dev.5bd59700",
-    "@dxos/object-model": "2.28.2-dev.5bd59700",
-    "@dxos/protocols": "2.28.2-dev.5bd59700",
-    "@dxos/rpc": "2.28.2-dev.5bd59700",
-    "@dxos/util": "2.28.2-dev.5bd59700",
+    "@dxos/async": "2.28.2-dev.cc97ac04",
+    "@dxos/codec-protobuf": "2.28.2-dev.cc97ac04",
+    "@dxos/config": "2.28.2-dev.cc97ac04",
+    "@dxos/credentials": "2.28.2-dev.cc97ac04",
+    "@dxos/crypto": "2.28.2-dev.cc97ac04",
+    "@dxos/debug": "2.28.2-dev.cc97ac04",
+    "@dxos/echo-db": "2.28.2-dev.cc97ac04",
+    "@dxos/echo-protocol": "2.28.2-dev.cc97ac04",
+    "@dxos/feed-store": "2.28.2-dev.cc97ac04",
+    "@dxos/model-factory": "2.28.2-dev.cc97ac04",
+    "@dxos/network-manager": "2.28.2-dev.cc97ac04",
+    "@dxos/object-model": "2.28.2-dev.cc97ac04",
+    "@dxos/protocols": "2.28.2-dev.cc97ac04",
+    "@dxos/rpc": "2.28.2-dev.cc97ac04",
+    "@dxos/util": "2.28.2-dev.cc97ac04",
     "@polkadot/keyring": "6.11.1",
     "@polkadot/util": "6.11.1",
     "@polkadot/util-crypto": "6.11.1",
@@ -41,7 +41,7 @@
     "uuid": "^8.3.2"
   },
   "devDependencies": {
-    "@dxos/random-access-multi-storage": "2.28.2-dev.5bd59700",
+    "@dxos/random-access-multi-storage": "2.28.2-dev.cc97ac04",
     "@dxos/testutils": "2.28.1",
     "@dxos/toolchain-node-library": "2.28.1",
     "@types/debug": "^4.1.7",

package/src/api/echo-proxy.ts

@@ -28,17 +28,21 @@ export class PartyInvitation extends Invitation<Party> {
   }
 }
 
+/**
+ * Client proxy to local/remote ECHO service.
+ */
 export class EchoProxy {
-  private readonly _modelFactory: ModelFactory;
-  private _parties = new ComplexMap<PublicKey, Party>(key => key.toHex());
+  private readonly _parties = new ComplexMap<PublicKey, Party>(key => key.toHex());
   private readonly _partiesChanged = new Event();
   private readonly _subscriptions = new SubscriptionGroup();
+  private readonly _modelFactory: ModelFactory;
 
   constructor (
     private readonly _serviceProvider: ClientServiceProvider,
     private readonly _haloProxy: HaloProxy
   ) {
-    this._modelFactory = _serviceProvider instanceof ClientServiceHost ? _serviceProvider.echo.modelFactory : new ModelFactory();
+    this._modelFactory = _serviceProvider instanceof ClientServiceHost
+      ? _serviceProvider.echo.modelFactory : new ModelFactory();
 
     this._modelFactory.registerModel(ObjectModel); // Register object-model by default.
   }
@@ -55,11 +59,13 @@ export class EchoProxy {
   }
 
   toString () {
-    return 'EchoProxy';
+    return `EchoProxy(${JSON.stringify(this.info())})`;
   }
 
   info () {
-    return this.toString();
+    return {
+      parties: this._parties.size
+    };
   }
 
   /**
@@ -99,6 +105,7 @@ export class EchoProxy {
       }
       this._partiesChanged.emit();
     }, () => {});
+
     this._subscriptions.push(() => partiesStream.close());
 
     await gotParties;
@@ -112,7 +119,7 @@ export class EchoProxy {
       await party.destroy();
     }
 
-    this._subscriptions.unsubscribe();
+    await this._subscriptions.unsubscribe();
   }
 
   //
@@ -178,7 +185,8 @@ export class EchoProxy {
    * To be used with `party.createInvitation` on the inviter side.
    */
   acceptInvitation (invitationDescriptor: InvitationDescriptor): PartyInvitation {
-    const invitationProcessStream = this._serviceProvider.services.PartyService.acceptInvitation(invitationDescriptor.toProto());
+    const invitationProcessStream = this._serviceProvider.services.PartyService.acceptInvitation(
+      invitationDescriptor.toProto());
     const { authenticate, waitForFinish } = InvitationProxy.handleInvitationRedemption({
       stream: invitationProcessStream,
       invitationDescriptor,

package/src/api/halo-proxy.ts

@@ -4,17 +4,16 @@
 
 import { Event } from '@dxos/async';
 import { KeyRecord } from '@dxos/credentials';
-import { Contact, CreateProfileOptions, InvitationDescriptor, InvitationOptions, PartyMember, ResultSet } from '@dxos/echo-db';
+import { Contact, CreateProfileOptions, InvitationDescriptor, PartyMember, ResultSet } from '@dxos/echo-db';
 import { SubscriptionGroup } from '@dxos/util';
 
 import { ClientServiceProvider } from '../interfaces';
 import { Profile, SignRequest } from '../proto/gen/dxos/client';
 import { Invitation, InvitationProxy, InvitationRequest } from './invitations';
 
-export interface CreateInvitationOptions extends InvitationOptions {
-  onPinGenerated?: (pin: string) => void
-}
-
+/**
+ * Client proxy to local/remote HALO service.
+ */
 export class HaloProxy {
   private readonly _invitationProxy = new InvitationProxy();
   private readonly _subscriptions = new SubscriptionGroup();
@@ -30,7 +29,13 @@ export class HaloProxy {
   ) {}
 
   toString () {
-    return `HaloProxy(${this._profile?.publicKey})`;
+    return `HaloProxy(${JSON.stringify(this.info())})`;
+  }
+
+  info () {
+    return {
+      key: this._profile?.publicKey
+    };
   }
 
   get invitationProxy () {

package/src/api/party-proxy.ts

@@ -5,7 +5,7 @@
 import { PublicKey } from '@dxos/crypto';
 import { failUndefined } from '@dxos/debug';
 import {
-  PARTY_ITEM_TYPE, PARTY_TITLE_PROPERTY, ActivationOptions, Database, RemoteDatabaseBackend, RootSelector
+  PARTY_ITEM_TYPE, PARTY_TITLE_PROPERTY, ActivationOptions, Database, RemoteDatabaseBackend
 } from '@dxos/echo-db';
 import { PartyKey } from '@dxos/echo-protocol';
 import { ModelFactory } from '@dxos/model-factory';
@@ -21,6 +21,10 @@ export interface CreationInvitationOptions {
   inviteeKey?: PublicKey
 }
 
+/**
+ * Main public Party API.
+ * Proxies requests to local/remove services.
+ */
 export class Party {
   private readonly _database?: Database;
   private readonly _invitationProxy = new InvitationProxy();
@@ -41,7 +45,6 @@ export class Party {
     this._key = party.publicKey;
     this._isOpen = party.isOpen;
     this._isActive = party.isActive;
-
     if (!party.isOpen) {
       return;
     }
@@ -134,10 +137,17 @@ export class Party {
   /**
    * Returns a selection context, which can be used to traverse the object graph.
    */
-  get select (): RootSelector {
+  get select (): Database['select'] {
     return this.database.select.bind(this.database);
   }
 
+  /**
+   * Returns a selection context, which can be used to traverse the object graph.
+   */
+  get reduce (): Database['reduce'] {
+    return this.database.reduce.bind(this.database);
+  }
+
   /**
    * Creates an invitation to a given party.
    * The Invitation flow requires the inviter and invitee to be online at the same time.
@@ -146,7 +156,8 @@ export class Party {
    *
    * To be used with `client.echo.acceptInvitation` on the invitee side.
    *
-   * @param inviteeKey Public key of the invitee. In this case no secret exchange is required, but only the specified recipient can accept the invitation.
+   * @param inviteeKey Public key of the invitee. In this case no secret exchange is required,
+   *   but only the specified recipient can accept the invitation.
    */
   async createInvitation ({ inviteeKey }: CreationInvitationOptions = {}): Promise<InvitationRequest> {
     const stream = this._serviceProvider.services.PartyService.createInvitation({ partyKey: this.key, inviteeKey });
@@ -160,8 +171,9 @@ export class Party {
     );
   }
 
-  setTitle (title: string) {
-    return this.setProperty(PARTY_TITLE_PROPERTY, title);
+  async setTitle (title: string) {
+    await this.setProperty(PARTY_TITLE_PROPERTY, title);
+    return this;
   }
 
   async setProperty (key: string, value?: any) {

package/src/client/client.ts

@@ -55,9 +55,9 @@ export class Client {
 
   private readonly _config: Config;
   private readonly _options: ClientOptions;
+
   private readonly _mode: Runtime.Client.Mode;
   private _serviceProvider!: ClientServiceProvider;
-
   private _halo!: HaloProxy;
   private _echo!: EchoProxy;
 
@@ -71,14 +71,14 @@ export class Client {
     if (typeof config !== 'object' || config == null) {
       throw new InvalidParameterError('Invalid config.');
     }
+
     this._config = (config instanceof Config) ? config : new Config(config);
+    this._options = options;
 
     if (Object.keys(this._config.values).length > 0 && this._config.values.version !== EXPECTED_CONFIG_VERSION) {
       throw new InvalidConfigurationError(`Expected config version 1, got ${this._config.values.version}.`);
     }
 
-    this._options = options;
-
     // TODO(burdon): Default error level: 'dxos:*:error'
     // TODO(burdon): config.getProperty('system.debug', process.env.DEBUG, '');
     debug.enable(this._config.values.runtime?.client?.debug ?? process.env.DEBUG ?? 'dxos:*:error');

package/src/client/service-host/service-host.ts

@@ -13,8 +13,8 @@ import { createServices } from './services';
 import { createStorageObjects } from './storage';
 
 export class ClientServiceHost implements ClientServiceProvider {
-  private readonly _echo: ECHO;
   private readonly _devtoolsEvents = new DevtoolsHostEvents();
+  private readonly _echo: ECHO;
 
   constructor (
     private readonly _config: Config