mongo-realtime 1.0.3 → 1.0.4

package/README.md

@@ -1,270 +1,270 @@
-# Mongo Realtime
-
-A Node.js package that combines Socket.IO and MongoDB Change Streams to deliver real-time database updates to your WebSocket clients.
-
-![Banner](logo.png)
-
-## 🚀 Features
-
-- **Real-time updates**: Automatically detects changes in MongoDB and broadcasts them via Socket.IO
-- **Granular events**: Emits specific events by operation type, collection, and document
-- **Connection management**: Customizable callbacks for socket connections/disconnections
-- **TypeScript compatible**: JSDoc annotations for better development experience
-
-## 📦 Installation
-
-```bash
-npm install mongo-realtime
-```
-
-## Setup
-
-### Prerequisites
-
-- MongoDB running as a replica set (required for Change Streams)
-- Node.js HTTP server (See below how to configure an HTTP server with Express)
-
-### Example setup
-
-```javascript
-const express = require('express');
-const http = require('http');
-const mongoose = require('mongoose');
-const MongoRealtime = require('mongo-realtime');
-
-const app = express();
-const server = http.createServer(app);
-
-mongoose.connect('mongodb://localhost:27017/mydb').then((c) => {
-    console.log("Connected to db",c.connection.name);
-});
-
-MongoRealtime.init({
-  connection: mongoose.connection,
-  server: server,
-  ignore: ["posts"], // ignore 'posts' collection
-  onSocket: (socket) => {
-    console.log(`Client connected: ${socket.id}`);
-    socket.emit('welcome', { message: 'Connection successful!' });
-  },
-  offSocket: (socket, reason) => {
-    console.log(`Client disconnected: ${socket.id}, reason: ${reason}`);
-  }
-});
-
-server.listen(3000, () => {
-  console.log('Server started on port 3000');
-});
-```
-
-## 📋 API
-
-### `MongoRealtime.init(options)`
-
-Initializes the socket system and MongoDB Change Streams.
-
-#### Parameters
-
-\* means required
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `options.connection` | `mongoose.Connection`* | Active Mongoose connection |
-| `options.server` | `http.Server`* | HTTP server to attach Socket.IO |
-| `options.authentify` | `Function` | Function to authenticate socket connections. Should return true if authenticated |
-| `options.middlewares` | `Array[Function]` | Array of Socket.IO middlewares |
-| `options.onSocket` | `Function` | Callback on socket connection |
-| `options.offSocket` | `Function` | Callback on socket disconnection |
-| `options.watch` | `Array[String]` | Collections to only watch. Listen to all when is empty |
-| `options.ignore` | `Array[String]` | Collections to only ignore. Overrides watch array |
-
-#### Static Properties
-
-- `MongoRealtime.io`: Socket.IO server instance
-- `MongoRealtime.connection`: MongoDB connection
-- `MongoRealtime.sockets`: Array of connected sockets
-
-## 🎯 Emitted Events
-
-The package automatically emits six types of events for each database change:
-
-### Event Types
-
-| Event | Description | Example |
-|-------|-------------|---------|
-| `db:change` | All changes | Any collection change |
-| `db:{type}` | By operation type | `db:insert`, `db:update`, `db:delete` |
-| `db:change:{collection}` | By collection | `db:change:users`, `db:change:posts` |
-| `db:{type}:{collection}` | Type + collection | `db:insert:users`, `db:update:posts` |
-| `db:change:{collection}:{id}` | Specific document | `db:change:users:507f1f77bcf86cd799439011` |
-| `db:{type}:{collection}:{id}` | Type + document | `db:insert:users:507f1f77bcf86cd799439011` |
-
-### Event listeners
-
-You can add serverside listeners to those db events to trigger specific actions on the server:
-
-```js
-function sendNotification(change){
-  const userId = change.docId; // or change.documentKey._id
-  NotificationService.send(userId,"Welcome to DB"); 
-}
-
-MongoRealtime.listen("db:insert:users",sendNotification);
-```
-
-#### Adding many callback to one event
-
-```js
-MongoRealtime.listen("db:insert:users",anotherAction);
-MongoRealtime.listen("db:insert:users",anotherAction2);
-```
-
-#### Removing event listeners
-
-```js
-MongoRealtime.removeListener("db:insert:users",sendNotification); // remove this specific action from this event
-MongoRealtime.removeListener("db:insert:users"); // remove all actions from this event
-MongoRealtime.removeAllListeners(); // remove all listeners
-
-```
-
-### Event Payload Structure
-
-Each event contains the full MongoDB change object:
-
-```javascript
-{
-  "_id": {...},
-  "col":"users", // same as ns.coll
-  "docId":"...", // same as documentKey._id 
-  "operationType": "insert|update|delete|replace",
-  "documentKey": { "_id": "..." },
-  "ns": { "db": "mydb", "coll": "users" },
-  "fullDocument": {...},
-  "fullDocumentBeforeChange": {...}
-}
-```
-
-## 🔨 Usage Examples
-
-### Server-side - Listening to specific events
-
-```javascript
-MongoRealtime.init({
-  connection: connection,
-  server: server,
-  onSocket: (socket) => {
-     socket.on('subscribe:users', () => {
-        socket.join('users-room');
-    });
-  },
-
-});
-
-MongoRealtime.io.to('users-room').emit('custom-event', data);
-```
-
-### Client-side - Receiving updates
-
-```html
-<!DOCTYPE html>
-<html>
-<head>
-  <script src="/socket.io/socket.io.js"></script>
-</head>
-<body>
-  <script>
-    const socket = io();
-
-    socket.on('db:change', (change) => {
-      console.log('Detected change:', change);
-    });
-
-    socket.on('db:insert:users', (change) => {
-      console.log('New user:', change.fullDocument);
-    });
-
-    const userId = '507f1f77bcf86cd799439011';
-    socket.on(`db:update:users:${userId}`, (change) => {
-      console.log('Updated user:', change.fullDocument);
-    });
-
-    socket.on('db:delete', (change) => {
-      console.log('Deleted document:', change.documentKey);
-    });
-  </script>
-</body>
-</html>
-```
-
-## Error Handling
-
-```javascript
-MongoRealtime.init({
-  connection: mongoose.connection,
-  server: server,
-  onSocket: (socket) => {
-    socket.on('error', (error) => {
-      console.error('Socket error:', error);
-    });
-  },
-  offSocket: (socket, reason) => {
-    if (reason === 'transport error') {
-      console.log('Transport error detected');
-    }
-  }
-});
-```
-
-## 🔒 Security
-
-### Socket Authentication
-
-```javascript
-function authenticateSocket(token, socket){
-   const verify = AuthService.verifyToken(token);
-   if(verify){
-     socket.user = verify.user; // attach user info to socket
-     return true; // should return true to accept the connection
-   }
-   return false;
-}
-
-MongoRealtime.init({
-  connection: mongoose.connection,
-  server: server,
-  authentify: authenticateSocket,
-  middlewares: [
-    (socket, next) => {
-     console.log(`User is authenticated: ${socket.user.email}`);
-     next();
-    }
-  ],
-  offSocket: (socket, reason) => {
-    console.log(`Socket ${socket.id} disconnected: ${reason}`);
-  }
-});
-```
-
-## 📚 Dependencies
-
-- `socket.io`: WebSocket management
-- `mongoose`: MongoDB ODM with Change Streams support
-
-## 🐛 Troubleshooting
-
-### MongoDB must be in Replica Set mode
-
-```bash
-mongod --replSet rs0
-
-rs.initiate()
-```
-
-## 📄 License
-
-MIT
-
-## 🤝 Contributing
-
-Contributions are welcome! Feel free to open an issue or submit a pull request.****
+# Mongo Realtime
+
+A Node.js package that combines Socket.IO and MongoDB Change Streams to deliver real-time database updates to your WebSocket clients.
+
+![Banner](logo.png)
+
+## 🚀 Features
+
+- **Real-time updates**: Automatically detects changes in MongoDB and broadcasts them via Socket.IO
+- **Granular events**: Emits specific events by operation type, collection, and document
+- **Connection management**: Customizable callbacks for socket connections/disconnections
+- **TypeScript compatible**: JSDoc annotations for better development experience
+
+## 📦 Installation
+
+```bash
+npm install mongo-realtime
+```
+
+## Setup
+
+### Prerequisites
+
+- MongoDB running as a replica set (required for Change Streams)
+- Node.js HTTP server (See below how to configure an HTTP server with Express)
+
+### Example setup
+
+```javascript
+const express = require('express');
+const http = require('http');
+const mongoose = require('mongoose');
+const MongoRealtime = require('mongo-realtime');
+
+const app = express();
+const server = http.createServer(app);
+
+mongoose.connect('mongodb://localhost:27017/mydb').then((c) => {
+    console.log("Connected to db",c.connection.name);
+});
+
+MongoRealtime.init({
+  connection: mongoose.connection,
+  server: server,
+  ignore: ["posts"], // ignore 'posts' collection
+  onSocket: (socket) => {
+    console.log(`Client connected: ${socket.id}`);
+    socket.emit('welcome', { message: 'Connection successful!' });
+  },
+  offSocket: (socket, reason) => {
+    console.log(`Client disconnected: ${socket.id}, reason: ${reason}`);
+  }
+});
+
+server.listen(3000, () => {
+  console.log('Server started on port 3000');
+});
+```
+
+## 📋 API
+
+### `MongoRealtime.init(options)`
+
+Initializes the socket system and MongoDB Change Streams.
+
+#### Parameters
+
+\* means required
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `options.connection` | `mongoose.Connection`* | Active Mongoose connection |
+| `options.server` | `http.Server`* | HTTP server to attach Socket.IO |
+| `options.authentify` | `Function` | Function to authenticate socket connections. Should return true if authenticated |
+| `options.middlewares` | `Array[Function]` | Array of Socket.IO middlewares |
+| `options.onSocket` | `Function` | Callback on socket connection |
+| `options.offSocket` | `Function` | Callback on socket disconnection |
+| `options.watch` | `Array[String]` | Collections to only watch. Listen to all when is empty |
+| `options.ignore` | `Array[String]` | Collections to only ignore. Overrides watch array |
+
+#### Static Properties
+
+- `MongoRealtime.io`: Socket.IO server instance
+- `MongoRealtime.connection`: MongoDB connection
+- `MongoRealtime.sockets`: Array of connected sockets
+
+## 🎯 Emitted Events
+
+The package automatically emits six types of events for each database change:
+
+### Event Types
+
+| Event | Description | Example |
+|-------|-------------|---------|
+| `db:change` | All changes | Any collection change |
+| `db:{type}` | By operation type | `db:insert`, `db:update`, `db:delete` |
+| `db:change:{collection}` | By collection | `db:change:users`, `db:change:posts` |
+| `db:{type}:{collection}` | Type + collection | `db:insert:users`, `db:update:posts` |
+| `db:change:{collection}:{id}` | Specific document | `db:change:users:507f1f77bcf86cd799439011` |
+| `db:{type}:{collection}:{id}` | Type + document | `db:insert:users:507f1f77bcf86cd799439011` |
+
+### Event listeners
+
+You can add serverside listeners to those db events to trigger specific actions on the server:
+
+```js
+function sendNotification(change){
+  const userId = change.docId; // or change.documentKey._id
+  NotificationService.send(userId,"Welcome to DB"); 
+}
+
+MongoRealtime.listen("db:insert:users",sendNotification);
+```
+
+#### Adding many callback to one event
+
+```js
+MongoRealtime.listen("db:insert:users",anotherAction);
+MongoRealtime.listen("db:insert:users",anotherAction2);
+```
+
+#### Removing event listeners
+
+```js
+MongoRealtime.removeListener("db:insert:users",sendNotification); // remove this specific action from this event
+MongoRealtime.removeListener("db:insert:users"); // remove all actions from this event
+MongoRealtime.removeAllListeners(); // remove all listeners
+
+```
+
+### Event Payload Structure
+
+Each event contains the full MongoDB change object:
+
+```javascript
+{
+  "_id": {...},
+  "col":"users", // same as ns.coll
+  "docId":"...", // same as documentKey._id 
+  "operationType": "insert|update|delete|replace",
+  "documentKey": { "_id": "..." },
+  "ns": { "db": "mydb", "coll": "users" },
+  "fullDocument": {...},
+  "fullDocumentBeforeChange": {...}
+}
+```
+
+## 🔨 Usage Examples
+
+### Server-side - Listening to specific events
+
+```javascript
+MongoRealtime.init({
+  connection: connection,
+  server: server,
+  onSocket: (socket) => {
+     socket.on('subscribe:users', () => {
+        socket.join('users-room');
+    });
+  },
+
+});
+
+MongoRealtime.io.to('users-room').emit('custom-event', data);
+```
+
+### Client-side - Receiving updates
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <script src="/socket.io/socket.io.js"></script>
+</head>
+<body>
+  <script>
+    const socket = io();
+
+    socket.on('db:change', (change) => {
+      console.log('Detected change:', change);
+    });
+
+    socket.on('db:insert:users', (change) => {
+      console.log('New user:', change.fullDocument);
+    });
+
+    const userId = '507f1f77bcf86cd799439011';
+    socket.on(`db:update:users:${userId}`, (change) => {
+      console.log('Updated user:', change.fullDocument);
+    });
+
+    socket.on('db:delete', (change) => {
+      console.log('Deleted document:', change.documentKey);
+    });
+  </script>
+</body>
+</html>
+```
+
+## Error Handling
+
+```javascript
+MongoRealtime.init({
+  connection: mongoose.connection,
+  server: server,
+  onSocket: (socket) => {
+    socket.on('error', (error) => {
+      console.error('Socket error:', error);
+    });
+  },
+  offSocket: (socket, reason) => {
+    if (reason === 'transport error') {
+      console.log('Transport error detected');
+    }
+  }
+});
+```
+
+## 🔒 Security
+
+### Socket Authentication
+
+```javascript
+function authenticateSocket(token, socket){
+   const verify = AuthService.verifyToken(token);
+   if(verify){
+     socket.user = verify.user; // attach user info to socket
+     return true; // should return true to accept the connection
+   }
+   return false;
+}
+
+MongoRealtime.init({
+  connection: mongoose.connection,
+  server: server,
+  authentify: authenticateSocket,
+  middlewares: [
+    (socket, next) => {
+     console.log(`User is authenticated: ${socket.user.email}`);
+     next();
+    }
+  ],
+  offSocket: (socket, reason) => {
+    console.log(`Socket ${socket.id} disconnected: ${reason}`);
+  }
+});
+```
+
+## 📚 Dependencies
+
+- `socket.io`: WebSocket management
+- `mongoose`: MongoDB ODM with Change Streams support
+
+## 🐛 Troubleshooting
+
+### MongoDB must be in Replica Set mode
+
+```bash
+mongod --replSet rs0
+
+rs.initiate()
+```
+
+## 📄 License
+
+MIT
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to open an issue or submit a pull request.****

package/index.js

@@ -1,178 +1,177 @@
-const { Server } = require("socket.io");
-
-class MongoRealtime {
-  /** @type {import("socket.io").Server} */ static io;
-  /** @type {import("mongoose").Connection} */ static connection;
-  /** @type {[import("socket.io").Socket]} */ static sockets = [];
-  /** @type {Record<String, [(change:ChangeStreamDocument)=>void]>} */ static #listeners =
-    {};
-
-  /**
-   * Initializes the socket system.
-   *
-   * @param {Object} options
-   * @param {import("mongoose").Connection} options.connection - Active Mongoose connection
-   * @param {(token:String, socket: import("socket.io").Socket) => boolean | Promise<boolean>} options.authentify - Auth function that should return true if `token` is valid
-   * @param {[( socket: import("socket.io").Socket, next: (err?: ExtendedError) => void) => void]} options.middlewares - Register mmiddlewares on incoming socket
-   * @param {(socket: import("socket.io").Socket) => void} options.onSocket - Callback triggered when a socket connects
-   * @param {(socket: import("socket.io").Socket, reason: import("socket.io").DisconnectReason) => void} options.offSocket - Callback triggered when a socket disconnects
-   * @param {import("http").Server} options.server - HTTP server to attach Socket.IO to
-   * @param {[String]} options.watch - Collections to watch. If empty, will watch all collections
-   * @param {[String]} options.ignore - Collections to ignore. Can override `watch`
-   *
-   */
-  static init({
-    connection,
-    server,
-    authentify,
-    middlewares=[],
-    onSocket,
-    offSocket,
-    watch = [],
-    ignore = [],
-  }) {
-    if (this.io)
-      this.io.close(() => {
-        this.sockets = [];
-      });
-    this.io = new Server(server);
-    this.connection = connection;
-
-    watch = watch.map((s) => s.toLowerCase());
-    ignore = ignore.map((s) => s.toLowerCase());
-
-    this.io.use(async (socket, next) => {
-      if (!!authentify) {
-        try {
-          const token = socket.handshake.auth.token;
-          if (!token) return next(new Error("No token provided"));
-
-          const authorized =await authentify(token, socket);
-          if (authorized===true) return next(); // exactly returns true
-
-          return next(new Error("Unauthorized"));
-        } catch (error) {
-          return next(new Error("Authentication error"));
-        }
-      } else {
-        return next();
-      }
-      
-    });
-
-    for (let middleware of middlewares) {
-      this.io.use(middleware);
-    }
-
-    this.io.on("connection", (socket) => {
-      this.sockets = [...this.io.sockets.sockets.values()];
-      if (onSocket) onSocket(socket);
-
-      socket.on("disconnect", (r) => {
-        this.sockets = [...this.io.sockets.sockets.values()];
-        if (offSocket) offSocket(socket, r);
-      });
-    });
-
-    connection.once("open", () => {
-      let pipeline = [];
-      if (watch.length !== 0 && ignore.length === 0) {
-        pipeline = [{ $match: { "ns.coll": { $in: watch } } }];
-      } else if (watch.length === 0 && ignore.length !== 0) {
-        pipeline = [{ $match: { "ns.coll": { $nin: ignore } } }];
-      } else if (watch.length !== 0 && ignore.length !== 0) {
-        pipeline = [
-          {
-            $match: {
-              $and: [
-                { "ns.coll": { $in: watch } },
-                { "ns.coll": { $nin: ignore } },
-              ],
-            },
-          },
-        ];
-      }
-
-      const changeStream = connection.watch(pipeline, {
-        fullDocument: "updateLookup",
-        fullDocumentBeforeChange: "whenAvailable",
-      });
-
-      changeStream.on("change", (change) => {
-        const colName = change.ns.coll.toLowerCase();
-        change.col = colName;
-
-        const type = change.operationType;
-        const id = change.documentKey?._id;
-
-        const e_change = "db:change";
-        const e_change_type = `db:${type}`;
-        const e_change_col = `${e_change}:${colName}`;
-        const e_change_type_col = `${e_change_type}:${colName}`;
-
-        const events = [
-          e_change,
-          e_change_type,
-          e_change_col,
-          e_change_type_col,
-        ];
-
-        if (id) {
-          change.docId = id;
-          const e_change_doc = `${e_change_col}:${id}`;
-          const e_change_type_doc = `${e_change_type_col}:${id}`;
-          events.push(e_change_doc, e_change_type_doc);
-        }
-        for (let e of events) {
-          this.io.emit(e, change);
-          this.notifyListeners(e, change);
-        }
-      });
-    });
-  }
-
-  /**
-   * Notify all event listeners
-   *
-   * @param {String} e - Name of the event
-   * @param {ChangeStreamDocument} change - Change Stream
-   */
-  static notifyListeners(e, change) {
-    if (this.#listeners[e]) {
-      for (let c of this.#listeners[e]) {
-        c(change);
-      }
-    }
-  }
-
-  /**
-   * Subscribe to an event
-   *
-   * @param {String} key - Name of the event
-   * @param {(change:ChangeStreamDocument)=>void} cb - Callback
-   */
-  static listen(key, cb) {
-    if (!this.#listeners[key]) this.#listeners[key] = [];
-    this.#listeners[key].push(cb);
-  }
-
-  /**
-   * Remove one or all listeners of an event
-   *
-   * @param {String} key - Name of the event
-   * @param {(change:ChangeStreamDocument)=>void} cb - Callback
-   */
-  static removeListener(key, cb) {
-    if (cb) this.#listeners[key] = this.#listeners[key].filter((c) => c != cb);
-    else this.#listeners[key] = [];
-  }
-
-  /**
-   * Unsubscribe to all events
-   */
-  static removeAllListeners() {
-    this.#listeners = {};
-  }
-}
-
-module.exports = MongoRealtime;
+const { Server } = require("socket.io");
+
+class MongoRealtime {
+  /** @type {import("socket.io").Server} */ static io;
+  /** @type {import("mongoose").Connection} */ static connection;
+  /** @type {[import("socket.io").Socket]} */ static sockets = [];
+  /** @type {Record<String, [(change:ChangeStreamDocument)=>void]>} */ static #listeners =
+    {};
+
+  /**
+   * Initializes the socket system.
+   *
+   * @param {Object} options
+   * @param {import("mongoose").Connection} options.connection - Active Mongoose connection
+   * @param {(token:String, socket: import("socket.io").Socket) => boolean | Promise<boolean>} options.authentify - Auth function that should return true if `token` is valid
+   * @param {[( socket: import("socket.io").Socket, next: (err?: ExtendedError) => void) => void]} options.middlewares - Register mmiddlewares on incoming socket
+   * @param {(socket: import("socket.io").Socket) => void} options.onSocket - Callback triggered when a socket connects
+   * @param {(socket: import("socket.io").Socket, reason: import("socket.io").DisconnectReason) => void} options.offSocket - Callback triggered when a socket disconnects
+   * @param {import("http").Server} options.server - HTTP server to attach Socket.IO to
+   * @param {[String]} options.watch - Collections to watch. If empty, will watch all collections
+   * @param {[String]} options.ignore - Collections to ignore. Can override `watch`
+   *
+   */
+  static init({
+    connection,
+    server,
+    authentify,
+    middlewares = [],
+    onSocket,
+    offSocket,
+    watch = [],
+    ignore = [],
+  }) {
+    if (this.io)
+      this.io.close(() => {
+        this.sockets = [];
+      });
+    this.io = new Server(server);
+    this.connection = connection;
+
+    watch = watch.map((s) => s.toLowerCase());
+    ignore = ignore.map((s) => s.toLowerCase());
+
+    this.io.use(async (socket, next) => {
+      if (!!authentify) {
+        try {
+          const token = socket.handshake.auth.token || socket.handshake.headers.authorization;
+          if (!token) return next(new Error("No token provided"));
+
+          const authorized =await authentify(token, socket);
+          if (authorized===true) return next(); // exactly returns true
+
+          return next(new Error("Unauthorized"));
+        } catch (error) {
+          return next(new Error("Authentication error"));
+        }
+      } else {
+        return next();
+      }
+    });
+
+    for (let middleware of middlewares) {
+      this.io.use(middleware);
+    }
+
+    this.io.on("connection", (socket) => {
+      this.sockets = [...this.io.sockets.sockets.values()];
+      if (onSocket) onSocket(socket);
+
+      socket.on("disconnect", (r) => {
+        this.sockets = [...this.io.sockets.sockets.values()];
+        if (offSocket) offSocket(socket, r);
+      });
+    });
+
+    connection.once("open", () => {
+      let pipeline = [];
+      if (watch.length !== 0 && ignore.length === 0) {
+        pipeline = [{ $match: { "ns.coll": { $in: watch } } }];
+      } else if (watch.length === 0 && ignore.length !== 0) {
+        pipeline = [{ $match: { "ns.coll": { $nin: ignore } } }];
+      } else if (watch.length !== 0 && ignore.length !== 0) {
+        pipeline = [
+          {
+            $match: {
+              $and: [
+                { "ns.coll": { $in: watch } },
+                { "ns.coll": { $nin: ignore } },
+              ],
+            },
+          },
+        ];
+      }
+
+      const changeStream = connection.watch(pipeline, {
+        fullDocument: "updateLookup",
+        fullDocumentBeforeChange: "whenAvailable",
+      });
+
+      changeStream.on("change", (change) => {
+        const colName = change.ns.coll.toLowerCase();
+        change.col = colName;
+
+        const type = change.operationType;
+        const id = change.documentKey?._id;
+
+        const e_change = "db:change";
+        const e_change_type = `db:${type}`;
+        const e_change_col = `${e_change}:${colName}`;
+        const e_change_type_col = `${e_change_type}:${colName}`;
+
+        const events = [
+          e_change,
+          e_change_type,
+          e_change_col,
+          e_change_type_col,
+        ];
+
+        if (id) {
+          change.docId = id;
+          const e_change_doc = `${e_change_col}:${id}`;
+          const e_change_type_doc = `${e_change_type_col}:${id}`;
+          events.push(e_change_doc, e_change_type_doc);
+        }
+        for (let e of events) {
+          this.io.emit(e, change);
+          this.notifyListeners(e, change);
+        }
+      });
+    });
+  }
+
+  /**
+   * Notify all event listeners
+   *
+   * @param {String} e - Name of the event
+   * @param {ChangeStreamDocument} change - Change Stream
+   */
+  static notifyListeners(e, change) {
+    if (this.#listeners[e]) {
+      for (let c of this.#listeners[e]) {
+        c(change);
+      }
+    }
+  }
+
+  /**
+   * Subscribe to an event
+   *
+   * @param {String} key - Name of the event
+   * @param {(change:ChangeStreamDocument)=>void} cb - Callback
+   */
+  static listen(key, cb) {
+    if (!this.#listeners[key]) this.#listeners[key] = [];
+    this.#listeners[key].push(cb);
+  }
+
+  /**
+   * Remove one or all listeners of an event
+   *
+   * @param {String} key - Name of the event
+   * @param {(change:ChangeStreamDocument)=>void} cb - Callback
+   */
+  static removeListener(key, cb) {
+    if (cb) this.#listeners[key] = this.#listeners[key].filter((c) => c != cb);
+    else this.#listeners[key] = [];
+  }
+
+  /**
+   * Unsubscribe to all events
+   */
+  static removeAllListeners() {
+    this.#listeners = {};
+  }
+}
+
+module.exports = MongoRealtime;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mongo-realtime",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "main": "index.js",
   "scripts": {},
   "keywords": [
@@ -16,7 +16,7 @@
   "author": "D3R50N",
   "license": "MIT",
   "repository": {
-    "url": "https://github.com/D3R50N/mongo-realtime.git"
+    "url": "git+https://github.com/D3R50N/mongo-realtime.git"
   },
   "description": "A Node.js package that combines Socket.IO and MongoDB Change Streams to deliver real-time database updates to your WebSocket clients.",
   "dependencies": {