@enbox/dwn-server 0.0.1

package/dist/esm/tests/ws-api.spec.js

@@ -0,0 +1,327 @@
+import { DataStream, Message, TestDataGenerator } from '@enbox/dwn-sdk-js';
+import { expect } from 'chai';
+import { base64url } from 'multiformats/bases/base64';
+import { useFakeTimers } from 'sinon';
+import { v4 as uuidv4 } from 'uuid';
+import { createJsonRpcRequest, createJsonRpcSubscriptionRequest, JsonRpcErrorCodes, } from '../src/lib/json-rpc.js';
+import { config } from '../src/config.js';
+import { WsApi } from '../src/ws-api.js';
+import { getTestDwn } from './test-dwn.js';
+import { createRecordsWriteMessage, sendWsMessage, sendHttpMessage } from './utils.js';
+import { HttpApi } from '../src/http-api.js';
+import { JsonRpcSocket } from '../src/json-rpc-socket.js';
+describe('websocket api', function () {
+    let httpApi;
+    let wsApi;
+    let dwn;
+    let clock;
+    before(() => {
+        clock = useFakeTimers({ shouldAdvanceTime: true });
+    });
+    after(() => {
+        clock.restore();
+    });
+    beforeEach(async function () {
+        dwn = await getTestDwn({ withEvents: true });
+        httpApi = await HttpApi.create(config, dwn);
+        await httpApi.start(9002);
+        wsApi = new WsApi(httpApi.server, dwn);
+        wsApi.start();
+    });
+    afterEach(async function () {
+        await wsApi.close();
+        await httpApi.close();
+        await dwn.close();
+    });
+    it('returns an error response if no request payload is provided', async function () {
+        const data = await sendWsMessage('ws://127.0.0.1:9002', Buffer.from(''));
+        const resp = JSON.parse(data.toString());
+        expect(resp.error.code).to.equal(JsonRpcErrorCodes.BadRequest);
+        expect(resp.error.message).to.equal('request payload required.');
+    });
+    it('returns an error response if parsing dwn request fails', async function () {
+        const data = await sendWsMessage('ws://127.0.0.1:9002', Buffer.from('@#$%^&*&%$#'));
+        const resp = JSON.parse(data.toString());
+        expect(resp.error.code).to.equal(JsonRpcErrorCodes.BadRequest);
+        expect(resp.error.message).to.include('JSON');
+    });
+    it('RecordsWrite messages are not supported', async function () {
+        const alice = await TestDataGenerator.generateDidKeyPersona();
+        const { recordsWrite, dataStream } = await createRecordsWriteMessage(alice);
+        const dataBytes = await DataStream.toBytes(dataStream);
+        const encodedData = base64url.baseEncode(dataBytes);
+        const requestId = uuidv4();
+        const dwnRequest = createJsonRpcRequest(requestId, 'dwn.processMessage', {
+            message: recordsWrite.toJSON(),
+            target: alice.did,
+            encodedData,
+        });
+        const connection = await JsonRpcSocket.connect('ws://127.0.0.1:9002');
+        const response = await connection.request(dwnRequest);
+        expect(response.id).to.equal(requestId);
+        expect(response.error).to.not.be.undefined;
+        expect(response.error.code).to.equal(JsonRpcErrorCodes.InvalidParams);
+        expect(response.error.message).to.include('RecordsWrite is not supported via ws');
+    });
+    it('subscribes to records and receives updates', async () => {
+        const alice = await TestDataGenerator.generateDidKeyPersona();
+        const { message } = await TestDataGenerator.generateRecordsSubscribe({
+            author: alice,
+            filter: {
+                schema: 'foo/bar'
+            }
+        });
+        const records = [];
+        const subscriptionHandler = async (event) => {
+            const { message } = event;
+            records.push(await Message.getCid(message));
+        };
+        const requestId = uuidv4();
+        const dwnRequest = createJsonRpcSubscriptionRequest(requestId, 'rpc.subscribe.dwn.processMessage', {
+            message: message,
+            target: alice.did,
+        });
+        const connection = await JsonRpcSocket.connect('ws://127.0.0.1:9002');
+        const { response, close } = await connection.subscribe(dwnRequest, (response) => {
+            const { event } = response.result;
+            subscriptionHandler(event);
+        });
+        expect(response.error).to.be.undefined;
+        expect(response.result.reply.status.code).to.equal(200);
+        expect(close).to.not.be.undefined;
+        const write1Message = await TestDataGenerator.generateRecordsWrite({
+            author: alice,
+            schema: 'foo/bar',
+            dataFormat: 'text/plain'
+        });
+        const writeResult1 = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: write1Message.message,
+            data: write1Message.dataBytes,
+        });
+        expect(writeResult1.status.code).to.equal(202);
+        const write2Message = await TestDataGenerator.generateRecordsWrite({
+            author: alice,
+            schema: 'foo/bar',
+            dataFormat: 'text/plain'
+        });
+        const writeResult2 = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: write2Message.message,
+            data: write2Message.dataBytes,
+        });
+        expect(writeResult2.status.code).to.equal(202);
+        // close the subscription
+        await close();
+        await new Promise(resolve => setTimeout(resolve, 5)); // wait for records to be processed
+        expect(records).to.have.members([
+            await Message.getCid(write1Message.message),
+            await Message.getCid(write2Message.message)
+        ]);
+    });
+    it('stops receiving updates when subscription is closed', async () => {
+        const alice = await TestDataGenerator.generateDidKeyPersona();
+        const { message } = await TestDataGenerator.generateRecordsSubscribe({
+            author: alice,
+            filter: {
+                schema: 'foo/bar'
+            }
+        });
+        const records = [];
+        const subscriptionHandler = async (event) => {
+            const { message } = event;
+            records.push(await Message.getCid(message));
+        };
+        const requestId = uuidv4();
+        const subscribeId = uuidv4();
+        const dwnRequest = createJsonRpcSubscriptionRequest(requestId, 'rpc.subscribe.dwn.processMessage', {
+            message: message,
+            target: alice.did,
+        }, subscribeId);
+        const connection = await JsonRpcSocket.connect('ws://127.0.0.1:9002');
+        const { response, close } = await connection.subscribe(dwnRequest, (response) => {
+            const { event } = response.result;
+            subscriptionHandler(event);
+        });
+        expect(response.error).to.be.undefined;
+        expect(response.result.reply.status.code).to.equal(200);
+        expect(close).to.not.be.undefined;
+        const write1Message = await TestDataGenerator.generateRecordsWrite({
+            author: alice,
+            schema: 'foo/bar',
+            dataFormat: 'text/plain'
+        });
+        const writeResult1 = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: write1Message.message,
+            data: write1Message.dataBytes,
+        });
+        expect(writeResult1.status.code).to.equal(202);
+        // close the subscription after only 1 message
+        await close();
+        // write more messages that won't show up in the subscription
+        const write2Message = await TestDataGenerator.generateRecordsWrite({
+            author: alice,
+            schema: 'foo/bar',
+            dataFormat: 'text/plain'
+        });
+        const writeResult2 = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: write2Message.message,
+            data: write2Message.dataBytes,
+        });
+        expect(writeResult2.status.code).to.equal(202);
+        const write3Message = await TestDataGenerator.generateRecordsWrite({
+            author: alice,
+            schema: 'foo/bar',
+            dataFormat: 'text/plain'
+        });
+        const writeResult3 = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: write3Message.message,
+            data: write3Message.dataBytes,
+        });
+        expect(writeResult3.status.code).to.equal(202);
+        await new Promise(resolve => setTimeout(resolve, 5)); // wait for records to be processed
+        expect(records).to.have.members([await Message.getCid(write1Message.message)]);
+    });
+    it('should fail to add subscription using a `JsonRpcId` that already exists for a subscription in that socket', async () => {
+        const alice = await TestDataGenerator.generateDidKeyPersona();
+        const { message } = await TestDataGenerator.generateRecordsSubscribe({
+            author: alice,
+            filter: {
+                schema: 'foo/bar'
+            }
+        });
+        const records = [];
+        const subscriptionHandler = async (event) => {
+            const { message } = event;
+            records.push(await Message.getCid(message));
+        };
+        const requestId = uuidv4();
+        const subscribeId = uuidv4();
+        const dwnRequest = createJsonRpcSubscriptionRequest(requestId, 'rpc.subscribe.dwn.processMessage', {
+            message: message,
+            target: alice.did
+        }, subscribeId);
+        const connection = await JsonRpcSocket.connect('ws://127.0.0.1:9002');
+        const { close } = await connection.subscribe(dwnRequest, (response) => {
+            const { event } = response.result;
+            subscriptionHandler(event);
+        });
+        const { message: message2 } = await TestDataGenerator.generateRecordsSubscribe({ filter: { schema: 'bar/baz' }, author: alice });
+        // We are checking for the subscription Id not the request Id
+        const request2Id = uuidv4();
+        const dwnRequest2 = createJsonRpcSubscriptionRequest(request2Id, 'rpc.subscribe.dwn.processMessage', {
+            message: message2,
+            target: alice.did
+        }, subscribeId);
+        const { response: response2 } = await connection.subscribe(dwnRequest2, (response) => {
+            const { event } = response.result;
+            subscriptionHandler(event);
+        });
+        expect(response2.error.code).to.equal(JsonRpcErrorCodes.InvalidParams);
+        expect(response2.error.message).to.contain(`${subscribeId} is in use by an active subscription`);
+        const write1Message = await TestDataGenerator.generateRecordsWrite({
+            author: alice,
+            schema: 'foo/bar',
+            dataFormat: 'text/plain'
+        });
+        const writeResult1 = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: write1Message.message,
+            data: write1Message.dataBytes,
+        });
+        expect(writeResult1.status.code).to.equal(202);
+        const write2Message = await TestDataGenerator.generateRecordsWrite({
+            author: alice,
+            schema: 'foo/bar',
+            dataFormat: 'text/plain'
+        });
+        const writeResult2 = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: write2Message.message,
+            data: write2Message.dataBytes,
+        });
+        expect(writeResult2.status.code).to.equal(202);
+        // close the subscription
+        await close();
+        await new Promise(resolve => setTimeout(resolve, 5)); // wait for records to be processed
+        expect(records).to.have.members([
+            await Message.getCid(write1Message.message),
+            await Message.getCid(write2Message.message)
+        ]);
+    });
+    it('should receive an updated message as well as the initial write when subscribing to a record', async () => {
+        const alice = await TestDataGenerator.generateDidKeyPersona();
+        // write an initial message
+        const initialWrite = await TestDataGenerator.generateRecordsWrite({
+            author: alice,
+            schema: 'foo/bar',
+            dataFormat: 'text/plain'
+        });
+        const writeResult1 = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: initialWrite.message,
+            data: initialWrite.dataBytes,
+        });
+        expect(writeResult1.status.code).to.equal(202);
+        // subscribe to 'foo/bar' messages
+        const { message } = await TestDataGenerator.generateRecordsSubscribe({
+            author: alice,
+            filter: {
+                schema: 'foo/bar'
+            }
+        });
+        const records = [];
+        const subscriptionHandler = async (event) => {
+            const { message, initialWrite } = event;
+            if (initialWrite) {
+                records.push(await Message.getCid(initialWrite));
+            }
+            records.push(await Message.getCid(message));
+        };
+        const requestId = uuidv4();
+        const subscribeId = uuidv4();
+        const dwnRequest = createJsonRpcSubscriptionRequest(requestId, 'rpc.subscribe.dwn.processMessage', {
+            message: message,
+            target: alice.did
+        }, subscribeId);
+        const connection = await JsonRpcSocket.connect('ws://127.0.0.1:9002');
+        const { close } = await connection.subscribe(dwnRequest, (response) => {
+            const { event } = response.result;
+            subscriptionHandler(event);
+        });
+        // wait for potential records to process and confirm that initial write has not been processed
+        await new Promise(resolve => setTimeout(resolve, 5));
+        expect(records.length).length.to.equal(0);
+        // update the initial message
+        const updatedMessage = await TestDataGenerator.generateFromRecordsWrite({
+            author: alice,
+            existingWrite: initialWrite.recordsWrite,
+        });
+        const updateResult = await sendHttpMessage({
+            url: 'http://localhost:9002',
+            target: alice.did,
+            message: updatedMessage.message,
+            data: updatedMessage.dataBytes,
+        });
+        expect(updateResult.status.code).to.equal(202);
+        await close();
+        await new Promise(resolve => setTimeout(resolve, 5)); // wait for records to be processed
+        // both initial and update should exist now
+        expect(records).to.have.members([
+            await Message.getCid(initialWrite.message),
+            await Message.getCid(updatedMessage.message)
+        ]);
+    });
+});
+//# sourceMappingURL=ws-api.spec.js.map

package/dist/esm/tests/ws-api.spec.js.map

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

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@enbox/dwn-server",
+  "type": "module",
+  "version": "0.0.1",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/src/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/src/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "bin": {
+    "dwn-server": "./dist/esm/src/main.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/enboxorg/enbox.git",
+    "directory": "packages/dwn-server"
+  },
+  "homepage": "https://github.com/enboxorg/enbox/tree/main/packages/dwn-server#readme",
+  "bugs": {
+    "url": "https://github.com/enboxorg/enbox/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@enbox/common": "workspace:*",
+    "@enbox/crypto": "workspace:*",
+    "@enbox/dids": "workspace:*",
+    "@enbox/dwn-sdk-js": "workspace:*",
+    "@enbox/dwn-sql-store": "workspace:*",
+    "better-sqlite3": "^8.5.0",
+    "body-parser": "^1.20.2",
+    "bytes": "3.1.2",
+    "cors": "2.8.5",
+    "express": "^4.20.0",
+    "kysely": "^0.26.3",
+    "loglevel": "^1.8.1",
+    "loglevel-plugin-prefix": "^0.8.4",
+    "multiformats": "11.0.2",
+    "mysql2": "^3.9.7",
+    "node-fetch": "3.3.1",
+    "pg": "^8.11.2",
+    "pg-cursor": "^2.10.2",
+    "prom-client": "14.2.0",
+    "readable-stream": "4.4.2",
+    "response-time": "2.3.2",
+    "uuid": "9.0.0",
+    "ws": "8.18.0"
+  },
+  "devDependencies": {
+    "@types/bytes": "3.1.1",
+    "@types/chai": "4.3.4",
+    "@types/chai-as-promised": "7.1.5",
+    "@types/express": "4.17.21",
+    "@types/mocha": "10.0.1",
+    "@types/node": "18.11.18",
+    "@types/readable-stream": "4.0.6",
+    "@types/sinon": "17.0.3",
+    "@types/supertest": "2.0.12",
+    "@types/ws": "8.5.10",
+    "@typescript-eslint/eslint-plugin": "^7.8.0",
+    "@typescript-eslint/parser": "^7.8.0",
+    "c8": "8.0.1",
+    "chai": "4.3.6",
+    "chai-as-promised": "7.1.1",
+    "crypto-browserify": "^3.12.0",
+    "esbuild": "0.16.17",
+    "eslint": "8.56.0",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-mocha": "^10.4.3",
+    "eslint-plugin-todo-plz": "^1.3.0",
+    "http-proxy": "^1.18.1",
+    "husky": "^8.0.0",
+    "karma": "^6.4.2",
+    "karma-chrome-launcher": "^3.2.0",
+    "karma-esbuild": "2.2.5",
+    "karma-mocha": "^2.0.1",
+    "lint-staged": "^15.2.9",
+    "mocha": "^10.2.0",
+    "puppeteer": "^22.11.2",
+    "rimraf": "^5.0.0",
+    "sinon": "17.0.1",
+    "stream-browserify": "^3.0.0",
+    "supertest": "6.3.3",
+    "typescript": "^5.1.6"
+  },
+  "scripts": {
+    "build:esm": "pnpm clean & tsc",
+    "build:cjs": "pnpm build:esm && node build/create-cjs-bundle.cjs && echo '{\"type\": \"commonjs\"}' > ./dist/cjs/package.json",
+    "build": "pnpm clean && pnpm build:esm && pnpm build:cjs",
+    "clean": "rimraf dist && rimraf generated/*",
+    "lint": "eslint . --ext .ts --max-warnings 0",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "test": "pnpm build:esm && cp -R tests/fixtures dist/esm/tests && c8 mocha",
+    "server": "pnpm build:esm && node dist/esm/src/main.js"
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged"
+    }
+  },
+  "lint-staged": {
+    "*.{js,ts}": [
+      "eslint --fix"
+    ]
+  },
+  "overrides": {
+    "express": {
+      "serve-static": "^1.16.2"
+    }
+  }
+}

package/src/config.ts

@@ -0,0 +1,71 @@
+import bytes from 'bytes';
+
+export type DwnServerConfig = typeof config;
+
+export const config = {
+  /**
+   * Used to populate the `server` property returned by the `/info` endpoint.
+   *
+   * If running using `npm` the `process.env.npm_package_name` variable exists and we use that,
+   * otherwise we fall back on the use defined `DWN_SERVER_PACKAGE_NAME` or `@enbox/dwn-server`.
+   */
+  serverName: process.env.npm_package_name || process.env.DWN_SERVER_PACKAGE_NAME || '@enbox/dwn-server',
+
+  /**
+   * The base external URL of this DWN.
+   * This is used to construct URL paths such as the `Request URI` in the Web5 Connect flow.
+   * Should NOT be pointing to `localhost` for production use.
+   */
+  baseUrl: process.env.DWN_BASE_URL || 'http://localhost:3000',
+
+  /**
+   * Port that server listens on.
+   */
+  port: parseInt(process.env.DS_PORT || '3000'),
+
+  /**
+   * The URL of the TTL cache used by the DWN.
+   * NOTE: Used for session/state keeping, thus requires the cache to be commonly addressable by nodes in a cloud cluster environment.
+   * 
+   * Currently only supports SQL databases, e.g.
+   * Postgres: 'postgres://root:dwn@localhost:5432/dwn'
+   * MySQL: 'mysql://root:dwn@localhost:3306/dwn'
+   */
+  ttlCacheUrl: process.env.DWN_TTL_CACHE_URL || 'sqlite://',
+
+  /**
+   * Used to populate the `version` and `sdkVersion` properties returned by the `/info` endpoint.
+   *
+   * The `version` and `sdkVersion` are pulled from `package.json` at runtime.
+   * If running using `npm` the `process.env.npm_package_json` variable exists as the filepath, so we use that.
+   * Otherwise we check to see if a specific `DWN_SERVER_PACKAGE_JSON` exists, if it does we use that.
+   * Finally if both of those options don't exist we resort to the path within the docker server image, located at `/dwn-server/package.json`
+   */
+  packageJsonPath:  process.env.npm_package_json ||  process.env.DWN_SERVER_PACKAGE_JSON || '/dwn-server/package.json',
+  // max size of data that can be provided with a RecordsWrite
+  maxRecordDataSize: bytes(process.env.MAX_RECORD_DATA_SIZE || '1gb'),
+
+  // whether to enable 'ws:'
+  webSocketSupport: { on: true, off: false }[process.env.DS_WEBSOCKET_SERVER] ?? true,
+
+  /**
+   * Path to DWN Event Stream plugin to use. Default single-node implementation will be used if left empty.
+   */
+  eventStreamPluginPath: process.env.DWN_EVENT_STREAM_PLUGIN_PATH,
+
+  // where to store persistent data
+  messageStore: process.env.DWN_STORAGE_MESSAGES || process.env.DWN_STORAGE || 'level://data',
+  dataStore: process.env.DWN_STORAGE_DATA || process.env.DWN_STORAGE || 'level://data',
+  eventLog: process.env.DWN_STORAGE_EVENTS || process.env.DWN_STORAGE || 'level://data',
+  resumableTaskStore: process.env.DWN_STORAGE_RESUMABLE_TASKS || process.env.DWN_STORAGE || 'level://data',
+
+  // tenant registration feature configuration
+  registrationStoreUrl: process.env.DWN_REGISTRATION_STORE_URL || process.env.DWN_STORAGE,
+  registrationProofOfWorkSeed: process.env.DWN_REGISTRATION_PROOF_OF_WORK_SEED,
+  registrationProofOfWorkEnabled: process.env.DWN_REGISTRATION_PROOF_OF_WORK_ENABLED === 'true',
+  registrationProofOfWorkInitialMaxHash: process.env.DWN_REGISTRATION_PROOF_OF_WORK_INITIAL_MAX_HASH,
+  termsOfServiceFilePath: process.env.DWN_TERMS_OF_SERVICE_FILE_PATH,
+
+  // log level - trace/debug/info/warn/error
+  logLevel: process.env.DWN_SERVER_LOG_LEVEL || 'INFO',
+};

package/src/connection/connection-manager.ts

@@ -0,0 +1,39 @@
+import type { Dwn } from "@enbox/dwn-sdk-js";
+
+import type { IncomingMessage } from "http";
+import type { WebSocket } from 'ws';
+
+import { SocketConnection } from "./socket-connection.js";
+
+/**
+ * Interface for managing `WebSocket` connections as they arrive.
+ */
+export interface ConnectionManager {
+  /** connect handler used for the `WebSockets` `'connection'` event. */
+  connect(socket: WebSocket, request?: IncomingMessage): Promise<void>;
+  /** closes all of the connections */
+  closeAll(): Promise<void>
+}
+
+/**
+ * A Simple In Memory ConnectionManager implementation.
+ * It uses a `Map<WebSocket, SocketConnection>` to manage connections.
+ */
+export class InMemoryConnectionManager implements ConnectionManager {
+  constructor(private dwn: Dwn, private connections: Map<WebSocket, SocketConnection> = new Map()) {}
+
+  async connect(socket: WebSocket): Promise<void> {
+    const connection = new SocketConnection(socket, this.dwn, () => {
+      // this is the onClose handler to clean up any closed connections.
+      this.connections.delete(socket);
+    });
+
+    this.connections.set(socket, connection);
+  }
+
+  async closeAll(): Promise<void> {
+    const closePromises = [];
+    this.connections.forEach(connection => closePromises.push(connection.close()));
+    await Promise.all(closePromises);
+  }
+}