@dxos/client-services 0.1.0

package/dist/src/packlets/services/testing/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../../../src/packlets/services/testing/testing.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;AAEF,+CAAkF;AAClF,uDAAmD;AACnD,2DAA+E;AAC/E,qDAAiD;AACjD,uEAAkF;AAElF,wDAAoD;AAEpD,qCAAqC;AAC9B,MAAM,oBAAoB,GAAG,KAAK,EAAE,EACzC,aAAa,GAAG,IAAI,sCAA0B,EAAE,EAChD,OAAO,GAAG,IAAA,qCAAa,EAAC,EAAE,IAAI,EAAE,mCAAW,CAAC,GAAG,EAAE,CAAC,KAIhD,EAAE,EAAE,EAAE;IACR,MAAM,cAAc,GAAG,IAAI,gCAAc,CAAC;QACxC,aAAa,EAAE,IAAI,+BAAmB,CAAC,aAAa,CAAC;QACrD,gBAAgB,EAAE,wCAAsB;KACzC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC,aAAa,CAAC,0BAAW,CAAC,CAAC;IACnE,OAAO,IAAI,gCAAc,CAAC,OAAO,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;AACnE,CAAC,CAAC;AAdW,QAAA,oBAAoB,wBAc/B"}

package/dist/src/packlets/storage/index.d.ts

@@ -0,0 +1,2 @@
+export * from './storage';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/packlets/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/storage/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC"}

package/dist/src/packlets/storage/index.js

@@ -0,0 +1,21 @@
+"use strict";
+//
+// Copyright 2022 DXOS.org
+//
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./storage"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/packlets/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/storage/index.ts"],"names":[],"mappings":";AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;;;;;;;;;;;;;;;;AAEF,4CAA0B"}

package/dist/src/packlets/storage/storage.d.ts

@@ -0,0 +1,7 @@
+import { Runtime } from '@dxos/protocols/proto/dxos/config';
+export declare type KeyStorageType = 'ram' | 'leveljs' | 'jsondown';
+export declare const createStorageObjects: (config: Runtime.Client.Storage) => {
+    storage: import("@dxos/random-access-storage").Storage;
+    keyStorage: any;
+};
+//# sourceMappingURL=storage.d.ts.map

package/dist/src/packlets/storage/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/packlets/storage/storage.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAO5D,oBAAY,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,CAAC;AAG5D,eAAO,MAAM,oBAAoB,WAAY,QAAQ,MAAM,QAAQ;;;CA4BlE,CAAC"}

package/dist/src/packlets/storage/storage.js

@@ -0,0 +1,89 @@
+"use strict";
+//
+// Copyright 2021 DXOS.org
+//
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStorageObjects = void 0;
+const jsondown_1 = __importDefault(require("jsondown"));
+const level_js_1 = __importDefault(require("level-js"));
+const memdown_1 = __importDefault(require("memdown"));
+const config_1 = require("@dxos/protocols/proto/dxos/config");
+const random_access_storage_1 = require("@dxos/random-access-storage");
+const util_1 = require("@dxos/util");
+var StorageDriver = config_1.Runtime.Client.Storage.StorageDriver;
+const errors_1 = require("../../errors");
+// TODO(burdon): Factor out.
+const createStorageObjects = (config) => {
+    const { path = 'dxos/storage', // TODO(burdon): Factor out const.
+    storageType, keyStorage, persistent = false } = config !== null && config !== void 0 ? config : {};
+    if (persistent && storageType === StorageDriver.RAM) {
+        throw new errors_1.InvalidConfigurationError('RAM storage cannot be used in persistent mode.');
+    }
+    if (!persistent && storageType !== undefined && storageType !== StorageDriver.RAM) {
+        throw new errors_1.InvalidConfigurationError('Cannot use a persistent storage in not persistent mode.');
+    }
+    if (persistent && keyStorage === StorageDriver.RAM) {
+        throw new errors_1.InvalidConfigurationError('RAM key storage cannot be used in persistent mode.');
+    }
+    if (!persistent && keyStorage !== StorageDriver.RAM && keyStorage !== undefined) {
+        throw new errors_1.InvalidConfigurationError('Cannot use a persistent key storage in not persistent mode.');
+    }
+    return {
+        storage: (0, random_access_storage_1.createStorage)({
+            type: persistent ? toStorageType(storageType) : random_access_storage_1.StorageType.RAM,
+            root: `${path}/`
+        }),
+        keyStorage: createKeyStorage(`${path}/keystore`, persistent ? toKeyStorageType(keyStorage) : 'ram')
+    };
+};
+exports.createStorageObjects = createStorageObjects;
+// TODO(burdon): Factor out.
+const createKeyStorage = (path, type) => {
+    const defaultedType = type !== null && type !== void 0 ? type : ((0, util_1.isNode)() ? 'jsondown' : 'leveljs');
+    switch (defaultedType) {
+        case 'leveljs':
+            return (0, level_js_1.default)(path);
+        case 'jsondown':
+            return (0, jsondown_1.default)(path);
+        case 'ram':
+            return (0, memdown_1.default)();
+        default:
+            throw new errors_1.InvalidConfigurationError(`Invalid key storage type: ${defaultedType}`);
+    }
+};
+const toStorageType = (type) => {
+    switch (type) {
+        case undefined:
+            return undefined;
+        case StorageDriver.RAM:
+            return random_access_storage_1.StorageType.RAM;
+        case StorageDriver.CHROME:
+            return random_access_storage_1.StorageType.CHROME;
+        case StorageDriver.FIREFOX:
+            return random_access_storage_1.StorageType.FIREFOX;
+        case StorageDriver.IDB:
+            return random_access_storage_1.StorageType.IDB;
+        case StorageDriver.NODE:
+            return random_access_storage_1.StorageType.NODE;
+        default:
+            throw new Error(`Invalid storage type: ${StorageDriver[type]}`);
+    }
+};
+const toKeyStorageType = (type) => {
+    switch (type) {
+        case undefined:
+            return undefined;
+        case StorageDriver.RAM:
+            return 'ram';
+        case StorageDriver.LEVELJS:
+            return 'leveljs';
+        case StorageDriver.JSONDOWN:
+            return 'jsondown';
+        default:
+            throw new Error(`Invalid key storage type: ${StorageDriver[type]}`);
+    }
+};
+//# sourceMappingURL=storage.js.map

package/dist/src/packlets/storage/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../../src/packlets/storage/storage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@dxos/client-services",
+  "version": "0.1.0",
+  "homepage": "https://dxos.org",
+  "bugs": "https://github.com/dxos/dxos/issues",
+  "license": "MIT",
+  "author": "DXOS.org",
+  "main": "dist/src/index.js",
+  "browser": {
+    "node:assert": "assert"
+  },
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@dxos/async": "0.1.0",
+    "@dxos/codec-protobuf": "0.1.0",
+    "@dxos/config": "0.1.0",
+    "@dxos/credentials": "0.1.0",
+    "@dxos/crypto": "0.1.0",
+    "@dxos/debug": "0.1.0",
+    "@dxos/echo-db": "0.1.0",
+    "@dxos/feed-store": "0.1.0",
+    "@dxos/keyring": "0.1.0",
+    "@dxos/keys": "0.1.0",
+    "@dxos/log": "0.1.0",
+    "@dxos/messaging": "0.1.0",
+    "@dxos/model-factory": "0.1.0",
+    "@dxos/network-manager": "0.1.0",
+    "@dxos/object-model": "0.1.0",
+    "@dxos/protocol-plugin-rpc": "0.1.0",
+    "@dxos/protocols": "0.1.0",
+    "@dxos/random-access-storage": "0.1.0",
+    "@dxos/rpc": "0.1.0",
+    "@dxos/testutils": "0.1.0",
+    "@dxos/timeframe": "0.1.0",
+    "@dxos/util": "0.1.0",
+    "abstract-leveldown": "~7.0.0",
+    "assert": "^2.0.0",
+    "base-x": "~3.0.9",
+    "json-stable-stringify": "^1.0.1",
+    "jsondown": "dxos/jsondown#main",
+    "level-js": "^5.0.2",
+    "memdown": "^5.1.0"
+  },
+  "devDependencies": {
+    "@dxos/signal": "0.1.0",
+    "@types/json-stable-stringify": "^1.0.32",
+    "@types/level-js": "~4.0.1",
+    "@types/memdown": "^3.0.0",
+    "@types/readable-stream": "^2.3.9"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "check": "true"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,19 @@
+//
+// Copyright 2021 DXOS.org
+//
+
+import { DXOSError } from '@dxos/debug';
+
+// TODO(burdon): Consolidate with @dxos/echo-db.
+
+export class InvalidConfigurationError extends DXOSError {
+  constructor(message: string) {
+    super('INVALID_CONFIGURATION', message);
+  }
+}
+
+export class RemoteServiceConnectionTimeout extends DXOSError {
+  constructor(message?: string) {
+    super('REMOTE_SERVICE_CONNECTION_TIMEOUT', message);
+  }
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2020 DXOS.org
+//
+
+export * from './packlets/devtools';
+export * from './packlets/identity';
+export * from './packlets/invitations';
+export * from './packlets/services';
+export * from './packlets/storage';
+
+export * from './errors';

package/src/packlets/devtools/devtools-host-events.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2021 DXOS.org
+//
+import { Event } from '@dxos/async';
+
+export class DevtoolsHostEvents {
+  readonly ready = new Event();
+}

package/src/packlets/devtools/feeds.ts

@@ -0,0 +1,91 @@
+//
+// Copyright 2021 DXOS.org
+//
+
+import { EventSubscriptions } from '@dxos/async';
+import { Stream } from '@dxos/codec-protobuf';
+import { FeedIterator, FeedStore, FeedWrapper } from '@dxos/feed-store';
+import { PublicKey } from '@dxos/keys';
+import {
+  SubscribeToFeedsRequest,
+  SubscribeToFeedsResponse,
+  SubscribeToFeedBlocksRequest,
+  SubscribeToFeedBlocksResponse
+} from '@dxos/protocols/proto/dxos/devtools/host';
+import { FeedMessage } from '@dxos/protocols/proto/dxos/echo/feed';
+import { ComplexMap } from '@dxos/util';
+
+export const subscribeToFeeds = (
+  { feedStore }: { feedStore: FeedStore<FeedMessage> },
+  { feedKeys }: SubscribeToFeedsRequest
+) =>
+  new Stream<SubscribeToFeedsResponse>(({ next }) => {
+    if (feedKeys?.length === 0) {
+      return;
+    }
+
+    const feedMap = new ComplexMap<PublicKey, FeedWrapper<FeedMessage>>(PublicKey.hash);
+    const subscriptions = new EventSubscriptions();
+
+    const update = async () => {
+      const feeds = await feedStore.feeds;
+      feeds
+        .filter((feed) => !feedKeys?.length || feedKeys.some((feedKey) => feedKey.equals(feed.key)))
+        .forEach((feed) => {
+          if (!feedMap.has(feed.key)) {
+            feedMap.set(feed.key, feed);
+            feed.on('close', update); // TODO(mykola): Unsubscribe.
+          }
+        });
+      next({
+        feeds: Array.from(feedMap.values()).map((feed) => ({ feedKey: feed.key, length: feed.properties.length }))
+      });
+    };
+
+    setImmediate(async () => {
+      subscriptions.add(feedStore.feedOpened.on(update));
+      await update();
+    });
+
+    return () => {
+      subscriptions.clear();
+    };
+  });
+
+export const subscribeToFeedBlocks = (
+  { feedStore }: { feedStore: FeedStore<FeedMessage> },
+  { feedKey, maxBlocks = 10 }: SubscribeToFeedBlocksRequest
+) =>
+  new Stream<SubscribeToFeedBlocksResponse>(({ next }) => {
+    if (!feedKey) {
+      return;
+    }
+
+    const update = async (feed: FeedWrapper<FeedMessage>) => {
+      const iterator = new FeedIterator(feed);
+      await iterator.open();
+      const blocks = [];
+      for await (const block of iterator) {
+        blocks.push(block);
+        if (blocks.length >= feed.properties.length) {
+          break;
+        }
+      }
+      next({
+        blocks: blocks.slice(-maxBlocks)
+      });
+      await iterator.close();
+    };
+
+    setImmediate(async () => {
+      const feed = await feedStore.getFeed(feedKey);
+      if (!feed) {
+        return;
+      }
+      feed.on('append', () => update(feed)); // TODO(mykola): Unsubscribe.
+      feed.on('truncate', () => update(feed)); // TODO(mykola): Unsubscribe.
+      await update(feed);
+    });
+
+    return () => {};
+  });

package/src/packlets/devtools/index.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+export * from './devtools-host-events';
+export * from './feeds';
+export * from './network';
+export * from './spaces';

package/src/packlets/devtools/network.ts

@@ -0,0 +1,89 @@
+//
+// Copyright 2020 DXOS.org
+//
+
+import { Stream } from '@dxos/codec-protobuf';
+import { PublicKey } from '@dxos/keys';
+import { CommandTrace } from '@dxos/messaging';
+import { NetworkManager } from '@dxos/network-manager';
+import {
+  GetNetworkPeersRequest,
+  GetNetworkPeersResponse,
+  SubscribeToNetworkTopicsResponse,
+  SubscribeToSignalStatusResponse,
+  SubscribeToSignalTraceResponse,
+  SubscribeToSwarmInfoResponse
+} from '@dxos/protocols/proto/dxos/devtools/host';
+
+export const subscribeToNetworkStatus = ({ networkManager }: { networkManager: NetworkManager }) =>
+  new Stream<SubscribeToSignalStatusResponse>(({ next, close }) => {
+    const update = () => {
+      try {
+        const status = networkManager.signal.getStatus();
+        next({ servers: status });
+      } catch (err: any) {
+        close(err);
+      }
+    };
+
+    networkManager.signal.statusChanged.on(update);
+    update();
+  });
+
+export const subscribeToSignalTrace = ({ networkManager }: { networkManager: NetworkManager }) =>
+  new Stream<SubscribeToSignalTraceResponse>(({ next }) => {
+    next({ events: [] });
+    const trace: CommandTrace[] = [];
+    networkManager.signal.commandTrace.on((msg) => {
+      trace.push(msg);
+      next({ events: trace.map((msg) => JSON.stringify(msg)) });
+    });
+  });
+
+export const subscribeToNetworkTopics = ({ networkManager }: { networkManager: NetworkManager }) =>
+  new Stream<SubscribeToNetworkTopicsResponse>(({ next, close }) => {
+    const update = () => {
+      try {
+        const topics = networkManager.topics;
+        const labeledTopics = topics.map((topic) => ({
+          topic,
+          label: networkManager.getSwarm(topic)?.label ?? topic.toHex()
+        }));
+        next({ topics: labeledTopics });
+      } catch (err: any) {
+        close(err);
+      }
+    };
+    networkManager.topicsUpdated.on(update);
+
+    update();
+  });
+
+export const subscribeToSwarmInfo = ({ networkManager }: { networkManager: NetworkManager }) =>
+  new Stream<SubscribeToSwarmInfoResponse>(({ next }) => {
+    const update = () => {
+      const info = networkManager.connectionLog?.swarms;
+      if (info) {
+        next({ data: info });
+      }
+    };
+    networkManager.connectionLog?.update.on(update);
+    update();
+  });
+
+export const getNetworkPeers = (
+  { networkManager }: { networkManager: NetworkManager },
+  request: GetNetworkPeersRequest
+): GetNetworkPeersResponse => {
+  if (!request.topic) {
+    throw new Error('Expected a network topic');
+  }
+
+  const map = networkManager.getSwarmMap(PublicKey.from(request.topic));
+  return {
+    peers: map?.peers.map((peer) => ({
+      ...peer,
+      connections: peer.connections.map((connection) => connection.asUint8Array())
+    }))
+  };
+};

package/src/packlets/devtools/spaces.ts

@@ -0,0 +1,50 @@
+//
+// Copyright 2020 DXOS.org
+//
+
+import { Stream } from '@dxos/codec-protobuf';
+import { Space } from '@dxos/echo-db';
+import { SubscribeToPartiesRequest, SubscribeToPartiesResponse } from '@dxos/protocols/proto/dxos/devtools/host';
+import { PartyMetadata } from '@dxos/protocols/proto/dxos/echo/metadata';
+
+import { ServiceContext } from '../services';
+
+export const subscribeToSpaces = (context: ServiceContext, { partyKeys = [] }: SubscribeToPartiesRequest) =>
+  new Stream<SubscribeToPartiesResponse>(({ next }) => {
+    let unsubscribe: () => void;
+
+    const update = async () => {
+      const parties: Space[] = [...context.spaceManager!.spaces.values()];
+      const filteredParties = parties.filter(
+        (party) => !partyKeys?.length || partyKeys.some((partyKey) => partyKey.equals(party.key))
+      );
+
+      next({
+        parties: filteredParties.map((party) => {
+          const partyMetadata = context.metadataStore.parties.find((partyMetadata: PartyMetadata) =>
+            partyMetadata.key.equals(party.key)
+          );
+          return {
+            key: party.key,
+            isOpen: party.isOpen,
+            timeframe: partyMetadata!.latestTimeframe!,
+            genesisFeed: party.genesisFeedKey,
+            controlFeed: party.controlFeedKey,
+            dataFeed: party.dataFeedKey
+          };
+        })
+      });
+    };
+
+    setImmediate(async () => {
+      await context.initialized.wait();
+      unsubscribe = context.spaceManager!.update.on(() => update());
+
+      // Send initial parties.
+      await update();
+    });
+
+    return () => {
+      unsubscribe?.();
+    };
+  });

package/src/packlets/identity/authenticator.test.ts

@@ -0,0 +1,32 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import assert from 'assert';
+import expect from 'expect';
+
+import { createCredentialSignerWithKey } from '@dxos/credentials';
+import { Keyring } from '@dxos/keyring';
+import { PublicKey } from '@dxos/keys';
+import { ComplexSet } from '@dxos/util';
+
+import { createHaloAuthProvider, createHaloAuthVerifier } from './authenticator';
+
+describe('identity/authenticator', function () {
+  it('verifies credentials', async function () {
+    if (mochaExecutor.environment !== 'nodejs') {
+      this.skip();
+    }
+
+    const keyring = new Keyring();
+    const deviceKey = await keyring.createKey();
+    const signer = createCredentialSignerWithKey(keyring, deviceKey);
+    const authProvider = createHaloAuthProvider(signer);
+    const authVerifier = createHaloAuthVerifier(() => new ComplexSet(PublicKey.hash, [deviceKey]));
+
+    const nonce = new Uint8Array([2, 1, 3, 7]);
+    const credential = await authProvider(nonce);
+    assert(credential);
+    expect(await authVerifier(nonce, credential)).toBeTruthy();
+  });
+});

package/src/packlets/identity/authenticator.ts

@@ -0,0 +1,49 @@
+//
+// Copyright 2022 DXOS.org
+//
+
+import { verifyCredential, CredentialSigner } from '@dxos/credentials';
+import { AuthProvider, AuthVerifier } from '@dxos/echo-db';
+import { PublicKey } from '@dxos/keys';
+import { log } from '@dxos/log';
+import { schema } from '@dxos/protocols';
+import { ComplexSet } from '@dxos/util';
+
+export const createHaloAuthProvider =
+  (signer: CredentialSigner): AuthProvider =>
+  async (nonce) => {
+    const credential = await signer.createCredential({
+      assertion: {
+        '@type': 'dxos.halo.credentials.Auth'
+      },
+      subject: signer.getIssuer(),
+      nonce
+    });
+
+    return schema.getCodecForType('dxos.halo.credentials.Credential').encode(credential);
+  };
+
+export const createHaloAuthVerifier =
+  (getDeviceSet: () => ComplexSet<PublicKey>): AuthVerifier =>
+  async (nonce, auth) => {
+    const credential = schema.getCodecForType('dxos.halo.credentials.Credential').decode(auth);
+    const deviceSet = getDeviceSet();
+
+    const result = await verifyCredential(credential);
+    if (result.kind === 'fail') {
+      log('Invalid credential', { result });
+      return false;
+    }
+
+    if (!credential.proof.nonce || !Buffer.from(nonce).equals(credential.proof.nonce)) {
+      log('Invalid nonce', { nonce, credential });
+      return false;
+    }
+
+    if (!deviceSet.has(credential.issuer)) {
+      log('Device not in allowed set');
+      return false;
+    }
+
+    return true;
+  };