Compare commits

...

6 Commits

Author SHA1 Message Date
Damien Arrachequesne
84c2fb7821 chore(release): engine.io@6.6.6
Diff: https://github.com/socketio/socket.io/compare/engine.io@6.6.5...engine.io@6.6.6
2026-03-10 10:52:10 +01:00
Not-Sarthak
07cbe1510d fix(eio): add @types/ws as dependency (#5458)
Since engine.io@6.6.5, the generated .d.ts files import types from "ws"
(WebSocket, PerMessageDeflateOptions), but @types/ws was not declared as
a dependency. This causes TypeScript compilation errors for consumers
who do not have @types/ws installed.

This follows the existing pattern where @types/cors and @types/node are
already listed as dependencies.

Related: https://github.com/socketio/socket.io/issues/5437
2026-03-04 09:54:58 +01:00
Erdinç Cürebal
44ed73f539 fix(eio): emit initial_headers and headers events in uServer (#5460)
The uServer (uWebSockets.js) implementation did not emit
"initial_headers" and "headers" events during WebSocket upgrades,
unlike the regular Server which does this via the ws "headers" event.

Related: https://github.com/socketio/socket.io/issues/5300
2026-03-04 09:07:02 +01:00
seungeonchoi
da04267ffc fix: cleanup pending acks on timeout to prevent memory leak (#5442)
When using `emitWithAck` with a timeout, if clients didn't respond
and the timeout triggers, the ack callbacks remained in `socket.acks`
Map indefinitely, causing a memory leak.

Related: https://github.com/socketio/socket.io/issues/4984
2026-03-02 16:32:13 +01:00
Damien Arrachequesne
74599a6b9e fix(types): properly import http module
This commit fixes `Module '"http"' has no default export.` errors (ts-node + esm).
2026-01-23 14:55:39 +01:00
Pádraic Slattery
d48718cb67 ci: use actions/checkout@v6 and actions/setup-node@v6 (#5449)
Release notes:

- https://github.com/actions/checkout/blob/main/CHANGELOG.md
- https://github.com/actions/setup-node/releases/tag/v6.0.0
2026-01-23 09:46:45 +01:00
13 changed files with 128 additions and 80 deletions

View File

@@ -31,10 +31,10 @@ jobs:
steps:
- name: Checkout repository
uses: actions/checkout@v4
uses: actions/checkout@v6
- name: Use Node.js 20
uses: actions/setup-node@v4
uses: actions/setup-node@v6
with:
node-version: 20

View File

@@ -20,10 +20,10 @@ jobs:
steps:
- name: Checkout repository
uses: actions/checkout@v4
uses: actions/checkout@v6
- name: Use Node.js 20
uses: actions/setup-node@v4
uses: actions/setup-node@v6
with:
node-version: 20

View File

@@ -17,10 +17,10 @@ jobs:
steps:
- name: Checkout repository
uses: actions/checkout@v4
uses: actions/checkout@v6
- name: Use Node.js 24
uses: actions/setup-node@v4
uses: actions/setup-node@v6
with:
node-version: 24
registry-url: 'https://registry.npmjs.org'

14
package-lock.json generated
View File

@@ -3499,7 +3499,6 @@
"version": "8.18.1",
"resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.1.tgz",
"integrity": "sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==",
"dev": true,
"license": "MIT",
"dependencies": {
"@types/node": "*"
@@ -16038,11 +16037,12 @@
}
},
"packages/engine.io": {
"version": "6.6.4",
"version": "6.6.5",
"license": "MIT",
"dependencies": {
"@types/cors": "^2.8.12",
"@types/node": ">=10.0.0",
"@types/ws": "^8.5.12",
"accepts": "~1.3.4",
"base64id": "2.0.0",
"cookie": "~0.7.2",
@@ -16056,7 +16056,7 @@
}
},
"packages/engine.io-client": {
"version": "6.6.3",
"version": "6.6.4",
"license": "MIT",
"dependencies": {
"@socket.io/component-emitter": "~3.1.0",
@@ -16082,7 +16082,7 @@
}
},
"packages/socket.io": {
"version": "4.8.1",
"version": "4.8.3",
"license": "MIT",
"dependencies": {
"accepts": "~1.3.4",
@@ -16098,7 +16098,7 @@
}
},
"packages/socket.io-adapter": {
"version": "2.5.5",
"version": "2.5.6",
"license": "MIT",
"dependencies": {
"debug": "~4.4.1",
@@ -16106,7 +16106,7 @@
}
},
"packages/socket.io-client": {
"version": "4.8.1",
"version": "4.8.3",
"license": "MIT",
"dependencies": {
"@socket.io/component-emitter": "~3.1.0",
@@ -16164,7 +16164,7 @@
"license": "MIT"
},
"packages/socket.io-parser": {
"version": "4.2.4",
"version": "4.2.5",
"license": "MIT",
"dependencies": {
"@socket.io/component-emitter": "~3.1.0",

View File

@@ -1,51 +1,66 @@
# Changelog
| Version | Release date |
|------------------------------------------------------------------------------------------------------|----------------|
| [6.6.5](#665-2025-12-22) | December 2025 |
| [6.6.4](#664-2025-01-28) | January 2025 |
| [6.6.3](#663-2025-01-23) | January 2025 |
| [6.6.2](#662-2024-10-09) | October 2024 |
| [6.6.1](#661-2024-09-21) | September 2024 |
| [6.6.0](#660-2024-06-21) | June 2024 |
| [6.5.5](#655-2024-06-18) (from the [6.5.x](https://github.com/socketio/engine.io/tree/6.5.x) branch) | June 2024 |
| [3.6.2](#362-2024-06-18) (from the [3.x](https://github.com/socketio/engine.io/tree/3.x) branch) | June 2024 |
| [6.5.4](#654-2023-11-09) | November 2023 |
| [6.5.3](#653-2023-10-06) | October 2023 |
| [6.5.2](#652-2023-08-01) | August 2023 |
| [6.5.1](#651-2023-06-27) | June 2023 |
| [6.5.0](#650-2023-06-16) | June 2023 |
| [6.4.2](#642-2023-05-02) | May 2023 |
| [6.4.1](#641-2023-02-20) | February 2023 |
| [6.4.0](#640-2023-02-06) | February 2023 |
| [6.3.1](#631-2023-01-12) | January 2023 |
| [6.3.0](#630-2023-01-10) | January 2023 |
| [3.6.1](#361-2022-11-20) (from the [3.x](https://github.com/socketio/engine.io/tree/3.x) branch) | November 2022 |
| [6.2.1](#621-2022-11-20) | November 2022 |
| [3.6.0](#360-2022-06-06) (from the [3.x](https://github.com/socketio/engine.io/tree/3.x) branch) | June 2022 |
| [6.2.0](#620-2022-04-17) | April 2022 |
| [6.1.3](#613-2022-02-23) | February 2022 |
| [6.1.2](#612-2022-01-18) | January 2022 |
| [6.1.1](#611-2022-01-11) | January 2021 |
| [6.1.0](#610-2021-11-08) | November 2022 |
| [6.0.1](#601-2021-11-06) | November 2021 |
| [**6.0.0**](#600-2021-10-08) | October 2021 |
| [5.2.0](#520-2021-08-29) | August 2021 |
| [5.1.1](#511-2021-05-16) | May 2021 |
| [5.1.0](#510-2021-05-04) | May 2021 |
| [**5.0.0**](#500-2021-03-10) | March 2021 |
| [4.1.1](#411-2021-02-02) | February 2021 |
| [4.1.0](#410-2021-01-14) | January 2021 |
| [4.0.6](#406-2021-01-04) | January 2021 |
| [3.5.0](#350-2020-12-30) (from the [3.x](https://github.com/socketio/engine.io/tree/3.x) branch) | December 2020 |
| [4.0.5](#405-2020-12-07) | December 2020 |
| [4.0.4](#404-2020-11-17) | November 2020 |
| [4.0.3](#403-2020-11-17) | November 2020 |
| [4.0.2](#402-2020-11-09) | November 2020 |
| [4.0.1](#401-2020-10-21) | October 2020 |
| [**4.0.0**](#400-2020-09-10) | September 2020 |
| [3.4.2](#342-2020-06-04) | June 2020 |
| [3.4.1](#341-2020-04-17) | April 2020 |
| Version | Release date | `ws` version |
|------------------------------------------------------------------------------------------------------|----------------|--------------|
| [6.6.6](#666-2026-03-10) | March 2026 | `"` |
| [6.6.5](#665-2025-12-22) | December 2025 | `~8.18.3` |
| [6.6.4](#664-2025-01-28) | January 2025 | `"` |
| [6.6.3](#663-2025-01-23) | January 2025 | `"` |
| [6.6.2](#662-2024-10-09) | October 2024 | `"` |
| [6.6.1](#661-2024-09-21) | September 2024 | `"` |
| [6.6.0](#660-2024-06-21) | June 2024 | `"` |
| [6.5.5](#655-2024-06-18) (from the [6.5.x](https://github.com/socketio/engine.io/tree/6.5.x) branch) | June 2024 | `~8.17.1` |
| [3.6.2](#362-2024-06-18) (from the [3.x](https://github.com/socketio/engine.io/tree/3.x) branch) | June 2024 | `~7.5.10` |
| [6.5.4](#654-2023-11-09) | November 2023 | `"` |
| [6.5.3](#653-2023-10-06) | October 2023 | `"` |
| [6.5.2](#652-2023-08-01) | August 2023 | `"` |
| [6.5.1](#651-2023-06-27) | June 2023 | `"` |
| [6.5.0](#650-2023-06-16) | June 2023 | `"` |
| [6.4.2](#642-2023-05-02) | May 2023 | `"` |
| [6.4.1](#641-2023-02-20) | February 2023 | `"` |
| [6.4.0](#640-2023-02-06) | February 2023 | `"` |
| [6.3.1](#631-2023-01-12) | January 2023 | `"` |
| [6.3.0](#630-2023-01-10) | January 2023 | `~8.11.0` |
| [3.6.1](#361-2022-11-20) (from the [3.x](https://github.com/socketio/engine.io/tree/3.x) branch) | November 2022 | `"` |
| [6.2.1](#621-2022-11-20) | November 2022 | `"` |
| [3.6.0](#360-2022-06-06) (from the [3.x](https://github.com/socketio/engine.io/tree/3.x) branch) | June 2022 | `"` |
| [6.2.0](#620-2022-04-17) | April 2022 | `"` |
| [6.1.3](#613-2022-02-23) | February 2022 | `"` |
| [6.1.2](#612-2022-01-18) | January 2022 | `"` |
| [6.1.1](#611-2022-01-11) | January 2021 | `"` |
| [6.1.0](#610-2021-11-08) | November 2022 | `"` |
| [6.0.1](#601-2021-11-06) | November 2021 | `"` |
| [**6.0.0**](#600-2021-10-08) | October 2021 | `~8.2.3` |
| [5.2.0](#520-2021-08-29) | August 2021 | `"` |
| [5.1.1](#511-2021-05-16) | May 2021 | `"` |
| [5.1.0](#510-2021-05-04) | May 2021 | `"` |
| [**5.0.0**](#500-2021-03-10) | March 2021 | `"` |
| [4.1.1](#411-2021-02-02) | February 2021 | `"` |
| [4.1.0](#410-2021-01-14) | January 2021 | `"` |
| [4.0.6](#406-2021-01-04) | January 2021 | `"` |
| [3.5.0](#350-2020-12-30) (from the [3.x](https://github.com/socketio/engine.io/tree/3.x) branch) | December 2020 | `~7.4.2` |
| [4.0.5](#405-2020-12-07) | December 2020 | `"` |
| [4.0.4](#404-2020-11-17) | November 2020 | `"` |
| [4.0.3](#403-2020-11-17) | November 2020 | `"` |
| [4.0.2](#402-2020-11-09) | November 2020 | `"` |
| [4.0.1](#401-2020-10-21) | October 2020 | `"` |
| [**4.0.0**](#400-2020-09-10) | September 2020 | `"` |
| [3.4.2](#342-2020-06-04) | June 2020 | `"` |
| [3.4.1](#341-2020-04-17) | April 2020 | `^7.1.2` |
## [6.6.6](https://github.com/socketio/socket.io/compare/engine.io@6.6.5...engine.io@6.6.6) (2026-03-10)
### Bug Fixes
* add `@types/ws` as dependency ([#5458](https://github.com/socketio/socket/issues/5458)) ([07cbe15](https://github.com/socketio/socket/commit/07cbe1510ded7e5460cb82e026e2533e50e30eaf))
* **uws** emit initial_headers and headers events in uServer ([#5460](https://github.com/socketio/socket/issues/5460)) ([44ed73f](https://github.com/socketio/socket/commit/44ed73f53995d35ef0c8d10df6806d5687238282))
### Dependencies
- [`ws@~8.18.3`](https://github.com/websockets/ws/releases/tag/8.18.3) (no change)
## [6.6.5](https://github.com/socketio/socket.io/compare/engine.io@6.6.4...engine.io@6.6.5) (2025-12-22)

View File

@@ -226,9 +226,23 @@ export class uServer extends BaseServer {
}
}
// emit headers events for WebSocket upgrades
const additionalHeaders = {};
const isInitialRequest = !id;
if (isInitialRequest) {
this.emit("initial_headers", additionalHeaders, req);
}
this.emit("headers", additionalHeaders, req);
// calling writeStatus() triggers the flushing of any header added in a middleware
req.res.writeStatus("101 Switching Protocols");
Object.keys(additionalHeaders).forEach((key) => {
req.res.writeHeader(key, additionalHeaders[key]);
});
res.upgrade(
{
transport,

View File

@@ -1,6 +1,6 @@
{
"name": "engine.io",
"version": "6.6.5",
"version": "6.6.6",
"description": "The realtime engine behind Socket.IO. Provides the foundation of a bidirectional connection between client and server",
"type": "commonjs",
"main": "./build/engine.io.js",
@@ -33,6 +33,7 @@
"dependencies": {
"@types/cors": "^2.8.12",
"@types/node": ">=10.0.0",
"@types/ws": "^8.5.12",
"accepts": "~1.3.4",
"base64id": "2.0.0",
"cookie": "~0.7.2",

View File

@@ -3598,10 +3598,7 @@ describe("server", () => {
});
it("should emit a 'initial_headers' event (websocket)", function (done) {
if (
process.env.EIO_WS_ENGINE === "eiows" ||
process.env.EIO_WS_ENGINE === "uws"
) {
if (process.env.EIO_WS_ENGINE === "eiows") {
return this.skip();
}
const partialDone = createPartialDone(done, 2);
@@ -3644,10 +3641,7 @@ describe("server", () => {
});
it("should emit several 'headers' events per connection", function (done) {
if (
process.env.EIO_WS_ENGINE === "eiows" ||
process.env.EIO_WS_ENGINE === "uws"
) {
if (process.env.EIO_WS_ENGINE === "eiows") {
return this.skip();
}
const partialDone = createPartialDone(done, 4);

View File

@@ -508,7 +508,7 @@ export abstract class ClusterAdapter extends Adapter {
}, opts.flags!.timeout);
}
super.broadcastWithAck(packet, opts, clientCountCallback, ack);
return super.broadcastWithAck(packet, opts, clientCountCallback, ack);
}
override async addSockets(opts: BroadcastOptions, rooms: Room[]) {

View File

@@ -229,6 +229,14 @@ export class Adapter extends EventEmitter {
});
clientCountCallback(clientCount);
return {
cleanup: () => {
this.apply(opts, (socket) => {
socket.acks.delete(packet.id);
});
},
};
}
private _encode(packet: unknown, packetOpts: Record<string, unknown>) {

View File

@@ -232,9 +232,11 @@ export class BroadcastOperator<EmitEvents extends EventsMap, SocketData>
const ack = data.pop() as (...args: any[]) => void;
let timedOut = false;
let responses: any[] = [];
let cleanupPendingAcks: (() => void) | undefined;
const timer = setTimeout(() => {
timedOut = true;
cleanupPendingAcks?.();
ack.apply(this, [
new Error("operation has timed out"),
this.flags.expectSingleResponse ? null : responses,
@@ -259,7 +261,7 @@ export class BroadcastOperator<EmitEvents extends EventsMap, SocketData>
}
};
this.adapter.broadcastWithAck(
const result = this.adapter.broadcastWithAck(
packet,
{
rooms: this.rooms,
@@ -279,6 +281,10 @@ export class BroadcastOperator<EmitEvents extends EventsMap, SocketData>
},
);
if (result && typeof result.cleanup === "function") {
cleanupPendingAcks = result.cleanup;
}
this.adapter.serverCount().then((serverCount) => {
expectedServerCount = serverCount;
checkCompleteness();

View File

@@ -1,4 +1,9 @@
import http from "http";
import { createServer } from "http"; // 'node:' prefix was added in Node.js 16
import type {
Server as HTTPServer,
IncomingMessage,
ServerResponse,
} from "http";
import type { Server as HTTPSServer } from "https";
import type { Http2SecureServer, Http2Server } from "http2";
import { createReadStream } from "fs";
@@ -58,7 +63,7 @@ type ParentNspNameMatchFn = (
type AdapterConstructor = typeof Adapter | ((nsp: Namespace) => Adapter);
type TServerInstance =
| http.Server
| HTTPServer
| HTTPSServer
| Http2SecureServer
| Http2Server;
@@ -276,8 +281,8 @@ export class Server<
*/
_connectTimeout: number;
private _corsMiddleware: (
req: http.IncomingMessage,
res: http.ServerResponse,
req: IncomingMessage,
res: ServerResponse,
next: () => void,
) => void;
@@ -301,7 +306,7 @@ export class Server<
if (
"object" === typeof srv &&
srv instanceof Object &&
!(srv as Partial<http.Server>).listen
!(srv as Partial<HTTPServer>).listen
) {
opts = srv as Partial<ServerOptions>;
srv = undefined;
@@ -493,7 +498,7 @@ export class Server<
if ("number" == typeof srv) {
debug("creating http server and binding to %d", srv);
const port = srv;
srv = http.createServer((req, res) => {
srv = createServer((_req, res) => {
res.writeHead(404);
res.end();
});
@@ -591,7 +596,7 @@ export class Server<
): void {
// initialize engine
debug("creating engine.io instance with opts %j", opts);
this.eio = attach(srv as http.Server, opts);
this.eio = attach(srv as HTTPServer, opts);
// attach static file serving
if (this._serveClient) this.attachServe(srv);
@@ -638,7 +643,7 @@ export class Server<
* @param res
* @private
*/
private serve(req: http.IncomingMessage, res: http.ServerResponse): void {
private serve(req: IncomingMessage, res: ServerResponse): void {
const filename = req.url!.replace(this._path, "").replace(/\?.*$/, "");
const isMap = dotMapRegex.test(filename);
const type = isMap ? "map" : "source";
@@ -678,8 +683,8 @@ export class Server<
*/
private static sendFile(
filename: string,
req: http.IncomingMessage,
res: http.ServerResponse,
req: IncomingMessage,
res: ServerResponse,
): void {
const readStream = createReadStream(
path.join(__dirname, "../client-dist/", filename),

View File

@@ -534,6 +534,11 @@ describe("messaging many", () => {
// @ts-ignore
expect(err.responses).to.contain(1, 2);
for (const [, serverSocket] of io.of("/").sockets) {
// @ts-ignore accessing private acks map to verify cleanup
expect(serverSocket.acks.size).to.be(0);
}
success(done, io, socket1, socket2, socket3);
}
});