From 6d9e329217debc180d738858d89c9d5e35367158 Mon Sep 17 00:00:00 2001
From: Dhruv Maniya <dhruvmaniya1998@gmail.com>
Date: Thu, 9 Jul 2026 12:19:01 +0530
Subject: [PATCH] Document dropping socket middleware packets

---
 packages/socket.io/lib/socket.ts | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/socket.io/lib/socket.ts b/packages/socket.io/lib/socket.ts
index 96d11a557..3689fd9d8 100644
--- a/packages/socket.io/lib/socket.ts
+++ b/packages/socket.io/lib/socket.ts
@@ -842,6 +842,10 @@ export class Socket<
    *     if (isUnauthorized(event)) {
    *       return next(new Error("unauthorized event"));
    *     }
+   *     if (shouldDrop(event)) {
+   *       // return without next() to silently drop the packet
+   *       return;
+   *     }
    *     // do not forget to call next
    *     next();
    *   });