@jmealo/fastify-uws 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Shyam Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,315 @@
+![fastify-uws](./.github/assets/logo.png)
+
+# fastify-uws
+
+A performant HTTP and WebSocket server for Fastify with [uWebSockets](https://github.com/uNetworking/uWebSockets.js).
+
+## Installation
+
+Install `@jmealo/fastify-uws` with your favorite package manager:
+
+```sh
+$ npm i @jmealo/fastify-uws
+# or
+$ yarn add @jmealo/fastify-uws
+# or
+$ pnpm i @jmealo/fastify-uws
+# or
+$ bun add @jmealo/fastify-uws
+```
+
+## Supported
+
+`fastify-uws` v1.x supports the following versions:
+
+- Node.js: v20, v22, and v24
+- `fastify`: v5.x
+- `@fastify/websocket`: v11.x
+
+## Release (CD)
+
+GitHub Actions publishes to npm on semver tags (`v*.*.*`) via [cd.yml](./.github/workflows/cd.yml) using npm Trusted Publishing (OIDC).
+
+One-time npm setup (no `NPM_TOKEN` secret needed):
+
+- npm package: `@jmealo/fastify-uws`
+- npm trusted publisher:
+  - Owner: `jmealo`
+  - Repository: `jmealo/fastify-uws`
+  - Workflow file: `.github/workflows/cd.yml`
+  - Environment: leave empty unless you deliberately scope to a GitHub Environment
+
+## Usage
+
+Just two lines are needed to speed up your Fastify application.
+
+```ts
+// app.ts
+import fastify from 'fastify';
+import { serverFactory } from '@jmealo/fastify-uws'; // Import here
+
+import router from '~/plugins/router';
+
+export default () => {
+  const app = fastify({
+    logger: {
+      transport: {
+        target: '@fastify/one-line-logger',
+      },
+    },
+    serverFactory, // And use here
+  });
+
+  app.register(router);
+
+  return app;
+};
+```
+
+```ts
+// server.ts
+import app from './app';
+
+const server = app();
+
+const start = async () => {
+  try {
+    await server.listen({
+      host: '127.0.0.1',
+      port: 3000,
+    });
+  } catch (err) {
+    server.log.error(err);
+    process.exit(1);
+  }
+};
+
+start();
+```
+
+### Use [Fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API)
+
+```ts
+// src/routes/hello-http/+handler.ts
+import type { FastifyPluginAsyncTypebox } from '@fastify/type-provider-typebox';
+import { Type } from 'typebox';
+
+export default (async (app) => {
+  app.get(
+    '',
+    {
+      schema: {
+        response: {
+          200: Type.Object({
+            message: Type.String(),
+          }),
+        },
+      },
+    },
+    async (req, reply) => {
+      return reply.send({
+        message: 'Hello, World!',
+      });
+    },
+  );
+}) as FastifyPluginAsyncTypebox;
+```
+
+#### With [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData)
+
+```ts
+// app.ts
+import multipart from '@fastify/multipart';
+
+app.register(multipart);
+```
+
+```ts
+// src/routes/hello-fd/+handler.ts
+import type { FastifyPluginAsyncTypebox } from '@fastify/type-provider-typebox';
+import fs from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+
+export default (async (app) => {
+  app.post('', async (req, reply) => {
+    const data = await req.file();
+
+    data.file; // stream
+    data.fields; // other parsed parts
+    data.fieldname;
+    data.filename;
+    data.encoding;
+    data.mimetype;
+
+    await pipeline(data.file, fs.createWriteStream(data.filename));
+    // or
+    // await data.toBuffer(); // Buffer
+
+    return reply.send({ message: 'ok' });
+  });
+}) as FastifyPluginAsyncTypebox;
+```
+
+### Use [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket)
+
+Just a single line of change can speed up your WebSocket application in Fastify.
+
+```diff
+- import websocket from '@fastify/websocket';
++ import { websocket } from '@jmealo/fastify-uws';
+```
+
+```ts
+// app.ts
+import { websocket } from '@jmealo/fastify-uws';
+
+app.register(websocket);
+```
+
+```ts
+// src/routes/hello-ws/+handler.ts
+import type { FastifyPluginAsyncTypebox } from '@fastify/type-provider-typebox';
+
+export default (async (app) => {
+  // $ node client-ws.mjs
+  app.get('', { websocket: true }, (socket) => {
+    app.log.info('Client connected');
+
+    socket.on('message', (message: MessageEvent) => {
+      console.log(`Client message: ${message}`);
+      socket.send('Hello from Fastify!');
+    });
+
+    socket.on('close', () => {
+      app.log.info('Client disconnected');
+    });
+  });
+}) as FastifyPluginAsyncTypebox;
+```
+
+### Use [EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource)
+
+```ts
+// app.ts
+import sse from '@fastify/sse';
+
+app.register(sse);
+```
+
+```ts
+// src/routes/hello-sse/+handler.ts
+import type { FastifyPluginAsyncTypebox } from '@fastify/type-provider-typebox';
+
+export default (async (app) => {
+  // $ node client-es.mjs
+  app.get('', { sse: true }, async (request, reply) => {
+    app.log.info('Client connected');
+
+    await reply.sse.send({ data: 'Hello from Fastify!' });
+
+    request.raw.on('close', () => {
+      app.log.info('Client disconnected');
+    });
+  });
+}) as FastifyPluginAsyncTypebox;
+```
+
+### TLS/SSL: `http2` and `https`
+
+```ts
+import fs from 'node:fs';
+import fastify from 'fastify';
+import { serverFactory, websocket } from '@jmealo/fastify-uws';
+// [...]
+export default () => {
+  const app = fastify({
+    http2: true,
+    https: {
+      key: fs.readFileSync(process.env.HTTPS_KEY),
+      cert: fs.readFileSync(process.env.HTTPS_CERT),
+    },
+    logger: {
+      transport: {
+        target: '@fastify/one-line-logger',
+      },
+    },
+    serverFactory,
+  });
+
+  app.register(websocket);
+  // [...]
+};
+// [...]
+```
+
+## Benchmarks
+
+### Quick Comparison
+
+> Measured with `pnpm bench` — autocannon, 100 connections, 10s duration, pipelining 10
+
+#### HTTP — `GET /ping` → `{ ok: true }`
+
+| | Req/sec | Latency (mean) | Latency (p99) |
+| :--- | ---: | ---: | ---: |
+| fastify | 93,000 | 10.3 ms | 26 ms |
+| **fastify-uws** | **200,000** | **4.6 ms** | **9 ms** |
+| | **+115%** | **-55%** | **-65%** |
+
+#### WebSocket — 100 clients, 64B echo flood, 10s
+
+| | Messages/sec |
+| :--- | ---: |
+| @fastify/websocket (ws) | 91,000 |
+| **fastify-uws** | **94,000** |
+| | **+3%** |
+
+#### SSE — 100 clients, 64B events, 10s
+
+| | Events/sec |
+| :--- | ---: |
+| @fastify/sse (default) | 420,000 |
+| **@fastify/sse + fastify-uws** | **197,000** |
+| | **-53%** |
+
+> Results vary by machine. Run `pnpm bench` to reproduce.
+
+### [oha v1.4.5](https://github.com/hatoo/oha)
+
+```sh
+$ oha -c 500 -z 10s --no-tui http://0.0.0.0:3000/api/hello-world
+```
+
+|               |       Version | Language        | Router | Requests/sec |
+| :------------ | ------------: | :-------------- | -----: | -----------: |
+| hyper         |         1.4.1 | Rust            |      ✗ |  56,175.6102 |
+| warp          |         0.3.7 | Rust            |      ✓ |  55,868.5861 |
+| axum          |         0.7.7 | Rust            |      ✓ |  54,588.2828 |
+| bun           |        1.1.30 | TypeScript/Bun  |      ✗ |  54,098.4841 |
+| graphul       |         1.0.1 | Rust            |      ✓ |  53,949.4400 |
+| poem          |         3.1.0 | Rust            |      ✓ |  53,849.0781 |
+| uws           |       20.48.0 | JavaScript/Node |      ✗ |  52,802.8029 |
+| elysia        |        1.1.17 | TypeScript/Bun  |      ✓ |  52,257.3305 |
+|               |               |                 |        |     ~ 5.5k ~ |
+| hyper-express |        6.17.2 | JavaScript/Node |      ✓ |  46,745.4887 |
+| hono          |         4.6.3 | TypeScript/Bun  |      ✓ |  46,685.6014 |
+| nhttp         |         2.0.2 | TypeScript/Deno |      ✓ |  44,874.2535 |
+| deno          |         2.0.0 | TypeScript/Deno |      ✗ |  44,753.8552 |
+| hono          |         4.6.3 | TypeScript/Deno |      ✓ |  43,280.7544 |
+|               |               |                 |        |     ~ 9.2k ~ |
+| h3            |        1.12.0 | TypeScript/Bun  |      ✓ |  34,043.4693 |
+| fastify-uws   |         1.0.0 | JavaScript/Node |      ✓ |  31,295.8715 |
+| polka         | 1.0.0-next.28 | JavaScript/Node |      ✓ |  31,086.5543 |
+| oak           |        17.0.0 | TypeScript/Deno |      ✓ |  30,730.7971 |
+| node          |       20.18.0 | JavaScript/Node |      ✗ |  29,230.1719 |
+| oak           |        17.0.0 | TypeScript/Bun  |      ✓ |  27,449.3417 |
+| fastify       |         5.0.0 | JavaScript/Node |      ✓ |  27,408.6679 |
+| hono          |         4.6.3 | JavaScript/Node |      ✓ |  25,138.5659 |
+|               |               |                 |        |     ~ 4.9k ~ |
+| h3            |        1.12.0 | JavaScript/Node |      ✓ |  20,193.2311 |
+|               |               |                 |        |     ~ 9.2k ~ |
+| express       |        4.21.0 | JavaScript/Node |      ✓ |  10,949.1532 |
+
+## Credits
+
+This project is based on [`@geut/fastify-uws`](https://github.com/geut/fastify-uws) and is licensed under the MIT License.

package/dist/errors.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=require("@fastify/error"),R=E("HPE_INVALID_METHOD","Invalid method encountered"),e=E("ERR_HEAD_SET","Cannot set headers after they are sent to the client"),_=E("EADDRINUSE","listen EADDRINUSE: address already in use %s:%s");E("ERR_UPGRADE","Cannot upgrade to WebSocket protocol %o");const D=E("ERR_STREAM_DESTROYED","Stream destroyed");E("ERR_UWS_APP_NOT_FOUND","uWebSockets app not found");const t=E("ERR_ENOTFOUND","getaddrinfo ENOTFOUND %s"),o=E("ERR_SOCKET_BAD_PORT","RangeError [ERR_SOCKET_BAD_PORT]: options.port should be >= 0 and < 65536. Received (%s)"),S=E("ERR_SERVER_DESTROYED","Server destroyed");exports.ERR_ADDRINUSE=_;exports.ERR_ENOTFOUND=t;exports.ERR_HEAD_SET=e;exports.ERR_INVALID_METHOD=R;exports.ERR_SERVER_DESTROYED=S;exports.ERR_SOCKET_BAD_PORT=o;exports.ERR_STREAM_DESTROYED=D;

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+export declare const ERR_INVALID_METHOD: import('@fastify/error').FastifyErrorConstructor<{
+    code: "HPE_INVALID_METHOD";
+}, [any?, any?, any?]>;
+export declare const ERR_HEAD_SET: import('@fastify/error').FastifyErrorConstructor<{
+    code: "ERR_HEAD_SET";
+}, [any?, any?, any?]>;
+export declare const ERR_ADDRINUSE: import('@fastify/error').FastifyErrorConstructor<{
+    code: "EADDRINUSE";
+}, [any?, any?, any?]>;
+export declare const ERR_UPGRADE: import('@fastify/error').FastifyErrorConstructor<{
+    code: "ERR_UPGRADE";
+}, [any?, any?, any?]>;
+export declare const ERR_STREAM_DESTROYED: import('@fastify/error').FastifyErrorConstructor<{
+    code: "ERR_STREAM_DESTROYED";
+}, [any?, any?, any?]>;
+export declare const ERR_UWS_APP_NOT_FOUND: import('@fastify/error').FastifyErrorConstructor<{
+    code: "ERR_UWS_APP_NOT_FOUND";
+}, [any?, any?, any?]>;
+export declare const ERR_ENOTFOUND: import('@fastify/error').FastifyErrorConstructor<{
+    code: "ERR_ENOTFOUND";
+}, [any?, any?, any?]>;
+export declare const ERR_SOCKET_BAD_PORT: import('@fastify/error').FastifyErrorConstructor<{
+    code: "ERR_SOCKET_BAD_PORT";
+}, [any?, any?, any?]>;
+export declare const ERR_SERVER_DESTROYED: import('@fastify/error').FastifyErrorConstructor<{
+    code: "ERR_SERVER_DESTROYED";
+}, [any?, any?, any?]>;

package/dist/errors.js

@@ -0,0 +1,27 @@
+import E from "@fastify/error";
+const e = E("HPE_INVALID_METHOD", "Invalid method encountered"), o = E(
+  "ERR_HEAD_SET",
+  "Cannot set headers after they are sent to the client"
+), t = E(
+  "EADDRINUSE",
+  "listen EADDRINUSE: address already in use %s:%s"
+);
+E("ERR_UPGRADE", "Cannot upgrade to WebSocket protocol %o");
+const _ = E("ERR_STREAM_DESTROYED", "Stream destroyed");
+E(
+  "ERR_UWS_APP_NOT_FOUND",
+  "uWebSockets app not found"
+);
+const D = E("ERR_ENOTFOUND", "getaddrinfo ENOTFOUND %s"), r = E(
+  "ERR_SOCKET_BAD_PORT",
+  "RangeError [ERR_SOCKET_BAD_PORT]: options.port should be >= 0 and < 65536. Received (%s)"
+), n = E("ERR_SERVER_DESTROYED", "Server destroyed");
+export {
+  t as ERR_ADDRINUSE,
+  D as ERR_ENOTFOUND,
+  o as ERR_HEAD_SET,
+  e as ERR_INVALID_METHOD,
+  n as ERR_SERVER_DESTROYED,
+  r as ERR_SOCKET_BAD_PORT,
+  _ as ERR_STREAM_DESTROYED
+};

package/dist/http-socket.cjs

@@ -0,0 +1,4 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("node:events"),f=require("./errors.cjs"),t=require("./symbols.cjs"),E=Buffer.from([0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1]),o=(s,e,i)=>s.subarray(e,i).toString("hex"),D=3e4,a=()=>{};function A(){this._clearTimeout(),this.aborted=!0,this._resolveDrain(),this.emit("aborted"),this.errored&&this.emit("error",this.errored),this.emit("close")}function C(s){return this._resolveDrain(),!0}function c(){this.destroyed||(this.emit("timeout"),this.abort())}function m(s,e){if(e.status&&s.writeStatus(e.status),e.headers)for(const i of e.headers.values())if(i.isMultiValue)for(const r of i.value)s.writeHeader(i.name,r);else s.writeHeader(i.name,i.value)}function b(s){return s.empty?0:s.byteLength!==void 0?s.byteLength:Buffer.byteLength(s)}function k(s){return s?.chunk?s.chunk:s}class S extends p.EventEmitter{aborted=!1;writableNeedDrain=!1;bytesRead=0;bytesWritten=0;writableEnded=!1;errored=null;drainTimeout=D;_drainCb=null;_drainTimer=null;_pendingData=null;_pendingCb=a;_boundCorkWrite;_boundCorkEnd;_boundDrainTimeout;[t.kServer];[t.kRes];[t.kWriteOnly];[t.kReadyState]={read:!1,write:!1};[t.kEncoding]=null;[t.kRemoteAddress]=null;[t.kUwsRemoteAddress]=null;[t.kHead]=null;[t.kClientError]=!1;[t.kTimeoutRef];[t.kWs];constructor(e,i,r){super(),this[t.kServer]=e,this[t.kRes]=i,this[t.kWriteOnly]=r,e.drainTimeout&&(this.drainTimeout=e.drainTimeout),this._boundCorkWrite=this._corkWrite.bind(this),this._boundCorkEnd=this._corkEnd.bind(this),this._boundDrainTimeout=this._onDrainTimeout.bind(this),this.once("error",a),i.onAborted(A.bind(this)),i.onWritable(C.bind(this)),e.timeout&&(this[t.kTimeoutRef]=setTimeout(c.bind(this),e.timeout))}get readyState(){const e=this[t.kReadyState];return e.read&&!e.write?"readOnly":!e.read&&e.write?"writeOnly":e.read?"open":"opening"}get writable(){return!0}get readable(){return!0}get encrypted(){return!!this[t.kServer][t.kHttps]}get remoteAddress(){if(this.aborted)return;let e=this[t.kRemoteAddress];if(e)return e;let i=this[t.kUwsRemoteAddress];return i||(i=this[t.kUwsRemoteAddress]=Buffer.copyBytesFrom(new Uint8Array(this[t.kRes].getRemoteAddress()))),i.length===4?e=`${i.readUInt8(0)}.${i.readUInt8(1)}.${i.readUInt8(2)}.${i.readUInt8(3)}`:i.equals(E)?e="::1":e=`${o(i,0,2)}:${o(i,2,4)}:${o(i,4,6)}:${o(i,6,8)}:${o(i,8,10)}:${o(i,10,12)}:${o(i,12,14)}:${o(i,14,i.length)}`,this[t.kRemoteAddress]=e,e}get remoteFamily(){if(!this.aborted)return this[t.kUwsRemoteAddress]||(this[t.kUwsRemoteAddress]=Buffer.copyBytesFrom(new Uint8Array(this[t.kRes].getRemoteAddress()))),this[t.kUwsRemoteAddress].length===4?"IPv4":"IPv6"}get destroyed(){return this.writableEnded||this.aborted}address(){return{...this[t.kServer][t.kAddress]}}abort(){this.aborted||(this.aborted=!0,!this[t.kWs]&&!this.writableEnded&&this[t.kRes].close())}setEncoding(e){this[t.kEncoding]=e}setTimeout(e){this._clearTimeout(),e&&(this[t.kTimeoutRef]=setTimeout(c.bind(this),e))}destroy(e){this.aborted||(this._clearTimeout(),this.errored=e||null,this.abort())}onRead(e){if(this[t.kWriteOnly]||this.aborted)return e(null,null);let i=!1;this[t.kReadyState].read=!0;const r=this[t.kEncoding];try{this[t.kRes].onData((n,h)=>{if(i)return;this.bytesRead+=n.byteLength;const d=r?Buffer.copyBytesFrom(new Uint8Array(n)).toString(r):Buffer.copyBytesFrom(new Uint8Array(n));this.emit("data",d),e(null,d),h&&(i=!0,e(null,null))})}catch(n){i=!0,this.destroy(n),e(n,null)}}end(e,i,r=a){if(this.aborted)throw new f.ERR_STREAM_DESTROYED;this.writableEnded=!0,this._clearTimeout(),this._pendingData=e,this._pendingCb=r,this[t.kRes].cork(this._boundCorkEnd)}write(e,i,r=a){if(this.destroyed)throw new f.ERR_STREAM_DESTROYED;if(this[t.kClientError]&&typeof e=="string"&&e.startsWith("HTTP/")){const[n,h]=e.split(`\r
+\r
+`),[d,..._]=n.split(`\r
+`),[,y,T]=d.split(" "),l=new Map;for(const R of _){const[u,...g]=R.split(": "),w=g.join(": ").trim();u.toLowerCase()!=="content-length"&&l.set(u.toLowerCase(),{name:u,value:w,isMultiValue:!1})}return this[t.kHead]={headers:l,status:`${y} ${T}`},e=h,this.end(e,i,r)}return this[t.kReadyState].write=!0,this._pendingData=e,this._pendingCb=r,this[t.kRes].cork(this._boundCorkWrite),!this.writableNeedDrain}_corkWrite(){const e=this._pendingCb;if(this.aborted)return e();const i=this[t.kRes];this[t.kHead]&&(m(i,this[t.kHead]),this[t.kHead]=null);const r=i.write(k(this._pendingData));if(this.bytesWritten+=b(this._pendingData),r)return e();this.writableNeedDrain=!0,this._drainCb=e,this._drainTimer=setTimeout(this._boundDrainTimeout,this.drainTimeout)}_corkEnd(){const e=this._pendingCb;if(this.aborted)return e();const i=this[t.kRes];this[t.kHead]&&(m(i,this[t.kHead]),this[t.kHead]=null);const r=this._pendingData;i.end(r?k(r):void 0),r&&(this.bytesWritten+=b(r)),this.emit("close"),this.emit("finish"),e()}_onDrainTimeout(){this._drainTimer=null;const e=this._drainCb;this._drainCb=null,this.destroy(new Error("drain timeout")),e&&e()}_resolveDrain(){this._drainTimer&&(clearTimeout(this._drainTimer),this._drainTimer=null);const e=this._drainCb;e&&(this._drainCb=null,this.writableNeedDrain=!1,e())}_clearTimeout(){this[t.kTimeoutRef]&&clearTimeout(this[t.kTimeoutRef])}}exports.HTTPSocket=S;

package/dist/http-socket.d.ts

@@ -0,0 +1,67 @@
+import { default as uws } from 'uWebSockets.js';
+import { EventEmitter } from 'node:events';
+import { Server } from './server';
+import { kClientError, kEncoding, kHead, kReadyState, kRemoteAddress, kRes, kServer, kTimeoutRef, kUwsRemoteAddress, kWriteOnly, kWs } from './symbols';
+export interface UwsHead {
+    status?: string;
+    headers?: Map<string, {
+        name: string;
+        value: any;
+        isMultiValue: boolean;
+    }>;
+}
+export declare class HTTPSocket extends EventEmitter {
+    aborted: boolean;
+    writableNeedDrain: boolean;
+    bytesRead: number;
+    bytesWritten: number;
+    writableEnded: boolean;
+    errored: Error | null;
+    drainTimeout: number;
+    _drainCb: (() => void) | null;
+    _drainTimer: NodeJS.Timeout | null;
+    _pendingData: any;
+    _pendingCb: () => void;
+    _boundCorkWrite: () => void;
+    _boundCorkEnd: () => void;
+    _boundDrainTimeout: () => void;
+    [kServer]: Server;
+    [kRes]: uws.HttpResponse;
+    [kWriteOnly]: boolean;
+    [kReadyState]: {
+        read: boolean;
+        write: boolean;
+    };
+    [kEncoding]: string | null;
+    [kRemoteAddress]: string | null;
+    [kUwsRemoteAddress]: Buffer | null;
+    [kHead]: UwsHead | null;
+    [kClientError]: boolean;
+    [kTimeoutRef]?: NodeJS.Timeout;
+    [kWs]?: boolean;
+    constructor(server: Server, res: uws.HttpResponse, writeOnly: boolean);
+    get readyState(): "open" | "readOnly" | "writeOnly" | "opening";
+    get writable(): boolean;
+    get readable(): boolean;
+    get encrypted(): boolean;
+    get remoteAddress(): string | undefined;
+    get remoteFamily(): "IPv6" | "IPv4" | undefined;
+    get destroyed(): boolean;
+    address(): {
+        address?: string | undefined;
+        family?: string | undefined;
+        port?: number | undefined;
+    };
+    abort(): void;
+    setEncoding(encoding: string): void;
+    setTimeout(timeout: number): void;
+    destroy(err?: Error): void;
+    onRead(cb: (err: Error | null, chunk: Buffer | string | null) => void): void;
+    end(data: any, _?: any, cb?: () => void): void;
+    write(data: any, _?: any, cb?: () => void): boolean | void;
+    _corkWrite(): void;
+    _corkEnd(): void;
+    _onDrainTimeout(): void;
+    _resolveDrain(): void;
+    _clearTimeout(): void;
+}

package/dist/http-socket.js

@@ -0,0 +1,174 @@
+import { EventEmitter as S } from "node:events";
+import { ERR_STREAM_DESTROYED as p } from "./errors.js";
+import { kServer as l, kRes as n, kWriteOnly as _, kReadyState as f, kEncoding as y, kRemoteAddress as T, kUwsRemoteAddress as d, kHead as o, kClientError as w, kTimeoutRef as a, kWs as k, kHttps as I, kAddress as L } from "./symbols.js";
+const H = Buffer.from([0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1]), h = (r, t, e) => r.subarray(t, e).toString("hex"), M = 3e4, b = () => {
+};
+function F() {
+  this._clearTimeout(), this.aborted = !0, this._resolveDrain(), this.emit("aborted"), this.errored && this.emit("error", this.errored), this.emit("close");
+}
+function x(r) {
+  return this._resolveDrain(), !0;
+}
+function D() {
+  this.destroyed || (this.emit("timeout"), this.abort());
+}
+function C(r, t) {
+  if (t.status && r.writeStatus(t.status), t.headers)
+    for (const e of t.headers.values())
+      if (e.isMultiValue)
+        for (const i of e.value)
+          r.writeHeader(e.name, i);
+      else
+        r.writeHeader(e.name, e.value);
+}
+function E(r) {
+  return r.empty ? 0 : r.byteLength !== void 0 ? r.byteLength : Buffer.byteLength(r);
+}
+function A(r) {
+  return r?.chunk ? r.chunk : r;
+}
+class V extends S {
+  aborted = !1;
+  writableNeedDrain = !1;
+  bytesRead = 0;
+  bytesWritten = 0;
+  writableEnded = !1;
+  errored = null;
+  drainTimeout = M;
+  _drainCb = null;
+  _drainTimer = null;
+  _pendingData = null;
+  _pendingCb = b;
+  _boundCorkWrite;
+  _boundCorkEnd;
+  _boundDrainTimeout;
+  [l];
+  [n];
+  [_];
+  [f] = { read: !1, write: !1 };
+  [y] = null;
+  [T] = null;
+  [d] = null;
+  [o] = null;
+  [w] = !1;
+  [a];
+  [k];
+  constructor(t, e, i) {
+    super(), this[l] = t, this[n] = e, this[_] = i, t.drainTimeout && (this.drainTimeout = t.drainTimeout), this._boundCorkWrite = this._corkWrite.bind(this), this._boundCorkEnd = this._corkEnd.bind(this), this._boundDrainTimeout = this._onDrainTimeout.bind(this), this.once("error", b), e.onAborted(F.bind(this)), e.onWritable(x.bind(this)), t.timeout && (this[a] = setTimeout(D.bind(this), t.timeout));
+  }
+  get readyState() {
+    const t = this[f];
+    return t.read && !t.write ? "readOnly" : !t.read && t.write ? "writeOnly" : t.read ? "open" : "opening";
+  }
+  get writable() {
+    return !0;
+  }
+  get readable() {
+    return !0;
+  }
+  get encrypted() {
+    return !!this[l][I];
+  }
+  get remoteAddress() {
+    if (this.aborted) return;
+    let t = this[T];
+    if (t) return t;
+    let e = this[d];
+    return e || (e = this[d] = Buffer.copyBytesFrom(
+      new Uint8Array(this[n].getRemoteAddress())
+    )), e.length === 4 ? t = `${e.readUInt8(0)}.${e.readUInt8(1)}.${e.readUInt8(2)}.${e.readUInt8(3)}` : e.equals(H) ? t = "::1" : t = `${h(e, 0, 2)}:${h(e, 2, 4)}:${h(e, 4, 6)}:${h(e, 6, 8)}:${h(e, 8, 10)}:${h(e, 10, 12)}:${h(e, 12, 14)}:${h(e, 14, e.length)}`, this[T] = t, t;
+  }
+  get remoteFamily() {
+    if (!this.aborted)
+      return this[d] || (this[d] = Buffer.copyBytesFrom(new Uint8Array(this[n].getRemoteAddress()))), this[d].length === 4 ? "IPv4" : "IPv6";
+  }
+  get destroyed() {
+    return this.writableEnded || this.aborted;
+  }
+  address() {
+    return { ...this[l][L] };
+  }
+  abort() {
+    this.aborted || (this.aborted = !0, !this[k] && !this.writableEnded && this[n].close());
+  }
+  setEncoding(t) {
+    this[y] = t;
+  }
+  setTimeout(t) {
+    this._clearTimeout(), t && (this[a] = setTimeout(D.bind(this), t));
+  }
+  destroy(t) {
+    this.aborted || (this._clearTimeout(), this.errored = t || null, this.abort());
+  }
+  onRead(t) {
+    if (this[_] || this.aborted) return t(null, null);
+    let e = !1;
+    this[f].read = !0;
+    const i = this[y];
+    try {
+      this[n].onData((s, c) => {
+        if (e) return;
+        this.bytesRead += s.byteLength;
+        const u = i ? Buffer.copyBytesFrom(new Uint8Array(s)).toString(i) : Buffer.copyBytesFrom(new Uint8Array(s));
+        this.emit("data", u), t(null, u), c && (e = !0, t(null, null));
+      });
+    } catch (s) {
+      e = !0, this.destroy(s), t(s, null);
+    }
+  }
+  end(t, e, i = b) {
+    if (this.aborted) throw new p();
+    this.writableEnded = !0, this._clearTimeout(), this._pendingData = t, this._pendingCb = i, this[n].cork(this._boundCorkEnd);
+  }
+  write(t, e, i = b) {
+    if (this.destroyed) throw new p();
+    if (this[w] && typeof t == "string" && t.startsWith("HTTP/")) {
+      const [s, c] = t.split(`\r
+\r
+`), [u, ...R] = s.split(`\r
+`), [, v, $] = u.split(" "), g = /* @__PURE__ */ new Map();
+      for (const W of R) {
+        const [m, ...U] = W.split(": "), B = U.join(": ").trim();
+        m.toLowerCase() !== "content-length" && g.set(m.toLowerCase(), { name: m, value: B, isMultiValue: !1 });
+      }
+      return this[o] = {
+        headers: g,
+        status: `${v} ${$}`
+      }, t = c, this.end(t, e, i);
+    }
+    return this[f].write = !0, this._pendingData = t, this._pendingCb = i, this[n].cork(this._boundCorkWrite), !this.writableNeedDrain;
+  }
+  _corkWrite() {
+    const t = this._pendingCb;
+    if (this.aborted) return t();
+    const e = this[n];
+    this[o] && (C(e, this[o]), this[o] = null);
+    const i = e.write(A(this._pendingData));
+    if (this.bytesWritten += E(this._pendingData), i) return t();
+    this.writableNeedDrain = !0, this._drainCb = t, this._drainTimer = setTimeout(this._boundDrainTimeout, this.drainTimeout);
+  }
+  _corkEnd() {
+    const t = this._pendingCb;
+    if (this.aborted) return t();
+    const e = this[n];
+    this[o] && (C(e, this[o]), this[o] = null);
+    const i = this._pendingData;
+    e.end(i ? A(i) : void 0), i && (this.bytesWritten += E(i)), this.emit("close"), this.emit("finish"), t();
+  }
+  _onDrainTimeout() {
+    this._drainTimer = null;
+    const t = this._drainCb;
+    this._drainCb = null, this.destroy(new Error("drain timeout")), t && t();
+  }
+  _resolveDrain() {
+    this._drainTimer && (clearTimeout(this._drainTimer), this._drainTimer = null);
+    const t = this._drainCb;
+    t && (this._drainCb = null, this.writableNeedDrain = !1, t());
+  }
+  _clearTimeout() {
+    this[a] && clearTimeout(this[a]);
+  }
+}
+export {
+  V as HTTPSocket
+};

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./server.cjs"),o=require("./request.cjs"),c=require("./response.cjs"),e=require("./websocket-server.cjs"),u=require("./plugin-sse.cjs"),S=require("./plugin-websocket.cjs"),n=(t,s)=>new r.Server(t,s);exports.Server=r.Server;exports.Request=o.Request;exports.Response=c.Response;exports.WebSocket=e.WebSocket;exports.WebSocketServer=e.WebSocketServer;exports.WebSocketStream=e.WebSocketStream;exports.sse=u.default;exports.websocket=S.default;exports.serverFactory=n;