added browser live transcription option

Author: briancbarrow

package.json

@@ -3,6 +3,7 @@
   "version": "1.3.0",
   "description": "An SDK for the Deepgram automated speech recognition platform",
   "main": "dist/index.js",
+  "browser": "dist/browser/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc -p ./",

src/browser/index.ts

@@ -0,0 +1,32 @@
+import { DefaultOptions } from "../constants";
+
+import { Transcriber } from "./transcription";
+
+export class Deepgram {
+  private _apiUrl: string;
+  private _apiKey: string;
+
+  transcription: Transcriber;
+
+  constructor(apiKey: string, apiUrl?: string) {
+    this._apiKey = apiKey;
+    this._apiUrl = apiUrl || DefaultOptions.apiUrl;
+
+    this._validateOptions();
+
+    this.transcription = new Transcriber(this._apiKey, this._apiUrl);
+  }
+
+  /**
+   * Ensures that the provided options were provided
+   */
+  private _validateOptions() {
+    if (!this._apiKey || this._apiKey.trim().length === 0) {
+      throw new Error("DG: API key is required");
+    }
+
+    if (!this._apiUrl || this._apiUrl.trim().length === 0) {
+      throw new Error("DG: API url should be a valid url or not provided");
+    }
+  }
+}

src/browser/transcription/index.ts

@@ -0,0 +1,18 @@
+import {
+  LiveTranscriptionOptions,
+} from "../../types";
+import querystring from "querystring";
+export class Transcriber {
+  constructor(private _credentials: string, private _apiUrl: string) {}
+
+  /**
+   * Opens a websocket to Deepgram's API for live transcriptions
+   * @param options Options to modify transcriptions
+   */
+  live(options?: LiveTranscriptionOptions): WebSocket {
+    return new WebSocket(
+      `wss://${this._apiUrl}/v1/listen?${querystring.stringify(options)}`,
+      ["token", this._credentials]
+    );
+  }
+}