feat: add error event

README.md

@@ -35,6 +35,12 @@ bingosync.on("board-changed", boardState => {
 	});
 });
 
+// Set up an error handler to be informed of runtime issues.
+// If you don't attach this handler, errors will be silently discarded.
+bingosync.on("error", error => {
+	console.error("something went wrong:", error);
+});
+
 // Connect to the room.
 bingosync
 	.joinRoom({

src/lib/bingosync.ts

@@ -13,6 +13,7 @@ const debug = dbg("bingosync-api");
 interface Events {
 	"status-changed": [string];
 	"board-changed": [BoardState];
+	error: [Error];
 }
 
 export type CellColor =
@@ -323,12 +324,10 @@ export class Bingosync extends EventEmitter<Events> {
 						"Socket protocol error:",
 						json.error ? json.error : json,
 					);
+					const errorMsg = json.error ? json.error : "unknown error";
+					this.emit("error", new Error(errorMsg));
 					if (!settled) {
-						reject(
-							new Error(
-								json.error ? json.error : "unknown error",
-							),
-						);
+						reject(new Error(errorMsg));
 						settled = true;
 					}