Issue #64 - Document methods in the repo

src/dwn-server.ts

@@ -41,6 +41,11 @@ export class DwnServer {
     callback?.();
   }
 
+  /**
+   * Handler for creating a DWN if none exists.
+   * Handler also starts an HTTP server.
+   * If `webSocketServerEnabled` is true, this handler also starts a WebSocketServer.
+   */
   async #setupServer(): Promise<void> {
     if (!this.dwn) {
       this.dwn = await Dwn.create(getDWNConfig(this.config));

src/http-api.ts

@@ -63,6 +63,9 @@ export class HttpApi {
     );
   }
 
+  /* Handler for setting up Express API routes
+   * API routes for `/`, `/health`, `/metrics`, `/:did/records/:id`
+   */
   #setupRoutes(): void {
     this.#api.get('/health', (_req, res) => {
       // return 200 ok

src/ws-api.ts

@@ -27,7 +27,6 @@ export class WsApi {
     this.#wsServer = new WebSocketServer({ server });
   }
 
-  // TODO: github.com/TBD54566975/dwn-server/issues/49 Add code coverage tracker, similar to either dwn-sdk-js or to web5-js
   get address(): AddressInfo | string {
     return this.#wsServer.address();
   }
@@ -122,6 +121,10 @@ export class WsApi {
     });
   }
 
+  /**
+   * This handler returns an interval to ping clients' socket every 30s
+   * if a pong hasn't received from a socket by the next ping, the server will terminate the socket connection.
+   */
   #setupHeartbeat(): NodeJS.Timer {
     // Sometimes connections between client <-> server can get borked in such a way that
     // leaves both unaware of the borkage. ping messages can be used as a means to verify
@@ -140,6 +143,11 @@ export class WsApi {
     }, HEARTBEAT_INTERVAL);
   }
 
+  /**
+   * Handler for starting a WebSocket.
+   * Sets listeners for `connection`, `close` events.
+   * It clears `heartbeatInterval` when a `close` event is made.
+   */
   #setupWebSocket(): void {
     this.#wsServer.on('connection', this.#handleConnection.bind(this));