Initial implementation of home-assistant-js-websocket

[robvanoostenrijk]

Future extensibility of this plugin depends on a solid integration with the Home Assistant WebSocket API.

Home Assistant publishes their own WebSocket client communication module here:
https://github.com/home-assistant/home-assistant-js-websocket/tree/master

It comes as a typescript package without any dependencies. The only issue with regards to NodeJS is that it require a browser Websocket implementation.

However, home-assistant-js-websocket allows overriding the socket creation function, giving this opportunity to supply an alternative class using NodeJS native ws package.

Simple example usage:

// NodeJS implementation of WebSocket for home-assistant-js-websocket
import { createSocket } from './socket.js'

import {
    createConnection,
    subscribeEntities,
    createLongLivedTokenAuth,
  } from "home-assistant-js-websocket";
  import * as messages from 'home-assistant-js-websocket/dist/messages.js';

  (async () => {
    try
    {
        const auth = createLongLivedTokenAuth(
           "http://ha.internal",
           "ey........sjjo",
        );

        const connOptions = Object.assign({ setupRetry: 0, auth: auth, createSocket });
        const conn = await createConnection(connOptions);
      
        const config = await conn.sendMessagePromise(messages.config());
        console.log(config);

        // Custom message
        const voice_entities = await conn.sendMessagePromise({ "type": "homeassistant/expose_entity/list"});
        console.log(voice_entities);

        conn.subscribeEvents((event) => console.log(event), "state_changed");
        subscribeEntities(conn, (entities) => console.log(entities));
    }
    catch (e) {
        console.log(e);
        console.trace();
    }

  })();

This pull request refactors homeAssistant.ts to use the home-assistant-js-websocket implementation.
As-is its starting up and operational with matterbridge, however I'd need your help to ensure everything is covered.

[robvanoostenrijk]

Based on your feedback, significantly reduced library integration and aligned with the original design direction

[robvanoostenrijk]

Ended up removing the entire library and rather inherit the Connection and Socket classes instead.