stelar-time-real 3.3.0 → 3.3.1

package/src/protocol.js

@@ -1,17 +1,10 @@
-/**
- * @stelar-time-real Binary Protocol
- * Frame: [4B totalLen BE][1B type][2B eventLen BE][event][payload]
- */
+/** @stelar-time-real Binary Protocol — Frame: [4B totalLen BE][1B type][2B eventLen BE][event][payload] */
 export const FRAME_JSON = 0x01, FRAME_BINARY = 0x02, FRAME_PING = 0x03, FRAME_PONG = 0x04, FRAME_ACK_REQ = 0x05, FRAME_ACK_RES = 0x06, FRAME_CONNECT = 0x07, FRAME_DISCONNECT = 0x08, FRAME_JOIN = 0x09, FRAME_LEAVE = 0x0A, FRAME_ERROR = 0x0B;
 export const MAX_EVENT_LENGTH = 256;
 export const DEFAULT_MAX_FRAME_SIZE = 10 * 1024 * 1024;
 export const HEADER_SIZE = 7;
 export class ProtocolError extends Error {
-    constructor(message, code = 'PROTOCOL_ERROR') {
-        super(message);
-        this.name = 'ProtocolError';
-        this.code = code;
-    }
+    constructor(message, code = 'PROTOCOL_ERROR') { super(message); this.name = 'ProtocolError'; this.code = code; }
 }
 export function validateEventName(event) {
     if (typeof event !== 'string')
@@ -31,7 +24,7 @@ function encode(type, event, payload, max = DEFAULT_MAX_FRAME_SIZE) {
         throw new ProtocolError(`Event name exceeds ${MAX_EVENT_LENGTH} bytes`, 'EVENT_TOO_LONG');
     const total = HEADER_SIZE + eb.length + payload.length;
     if (total > max)
-        throw new ProtocolError(`Frame exceeds max size (${max} bytes)`, 'FRAME_TOO_LARGE');
+        throw new ProtocolError(`Frame exceeds max size (${max})`, 'FRAME_TOO_LARGE');
     const f = Buffer.alloc(total);
     f.writeUInt32BE(total, 0);
     f[4] = type;
@@ -60,42 +53,63 @@ export const encodeDisconnectFrame = () => emptyFrame(FRAME_DISCONNECT);
 export const encodeJoinFrame = (room, max) => encode(FRAME_JOIN, 'join-room', Buffer.from(room, 'utf8'), max);
 export const encodeLeaveFrame = (room) => encode(FRAME_LEAVE, 'leave-room', room ? Buffer.from(room, 'utf8') : Buffer.alloc(0));
 export const encodeErrorFrame = (msg) => encode(FRAME_ERROR, 'error', Buffer.from(msg, 'utf8'));
+/** O(1) append streaming parser — avoids Buffer.concat O(n²) on many small chunks */
 export class FrameParser {
     constructor(max = DEFAULT_MAX_FRAME_SIZE) {
-        this.buf = Buffer.alloc(0);
+        this.chunks = [];
+        this.len = 0;
         this.received = 0;
         this.max = max;
     }
+    _compact() {
+        if (this.chunks.length <= 1)
+            return this.chunks[0] || Buffer.alloc(0);
+        const buf = Buffer.concat(this.chunks);
+        this.chunks = [buf];
+        return buf;
+    }
     feed(data) {
         this.received += data.length;
-        this.buf = Buffer.concat([this.buf, data]);
-        if (this.buf.length > this.max * 2) {
-            this.buf = Buffer.alloc(0);
+        this.chunks.push(data);
+        this.len += data.length;
+        if (this.len > this.max * 2) {
+            this.chunks = [];
+            this.len = 0;
             throw new ProtocolError(`Buffer overflow (${this.max * 2})`, 'BUFFER_OVERFLOW');
         }
         const frames = [];
-        while (this.buf.length >= HEADER_SIZE) {
-            const total = this.buf.readUInt32BE(0);
+        while (this.len >= HEADER_SIZE) {
+            const buf = this._compact();
+            const total = buf.readUInt32BE(0);
             if (total < HEADER_SIZE || total > this.max) {
-                this.buf = Buffer.alloc(0);
+                this.chunks = [];
+                this.len = 0;
                 throw new ProtocolError(`Invalid frame size: ${total}`, total < HEADER_SIZE ? 'INVALID_FRAME_SIZE' : 'FRAME_TOO_LARGE');
             }
-            if (this.buf.length < total)
+            if (buf.length < total)
                 break;
-            const el = this.buf.readUInt16BE(5);
+            const el = buf.readUInt16BE(5);
             if (HEADER_SIZE + el > total || el > MAX_EVENT_LENGTH) {
-                this.buf = Buffer.alloc(0);
+                this.chunks = [];
+                this.len = 0;
                 throw new ProtocolError('Invalid event length', 'INVALID_EVENT_LENGTH');
             }
             frames.push({
-                type: this.buf[4],
-                event: el ? this.buf.subarray(HEADER_SIZE, HEADER_SIZE + el).toString('utf8') : '',
-                payload: total > HEADER_SIZE + el ? Buffer.from(this.buf.subarray(HEADER_SIZE + el, total)) : Buffer.alloc(0),
+                type: buf[4],
+                event: el ? buf.subarray(HEADER_SIZE, HEADER_SIZE + el).toString('utf8') : '',
+                payload: total > HEADER_SIZE + el ? Buffer.from(buf.subarray(HEADER_SIZE + el, total)) : Buffer.alloc(0),
             });
-            this.buf = total < this.buf.length ? Buffer.from(this.buf.subarray(total)) : Buffer.alloc(0);
+            if (total < buf.length) {
+                this.chunks = [Buffer.from(buf.subarray(total))];
+                this.len = this.chunks[0].length;
+            }
+            else {
+                this.chunks = [];
+                this.len = 0;
+            }
         }
         return frames;
     }
-    reset() { this.buf = Buffer.alloc(0); this.received = 0; }
+    reset() { this.chunks = []; this.len = 0; this.received = 0; }
     getBytesReceived() { return this.received; }
 }

package/src/protocol.ts

@@ -1,7 +1,4 @@
-/**
- * @stelar-time-real Binary Protocol
- * Frame: [4B totalLen BE][1B type][2B eventLen BE][event][payload]
- */
+/** @stelar-time-real Binary Protocol — Frame: [4B totalLen BE][1B type][2B eventLen BE][event][payload] */
 
 export const FRAME_JSON = 0x01, FRAME_BINARY = 0x02, FRAME_PING = 0x03,
   FRAME_PONG = 0x04, FRAME_ACK_REQ = 0x05, FRAME_ACK_RES = 0x06,
@@ -16,11 +13,7 @@ export interface ParsedFrame { type: number; event: string; payload: Buffer; }
 
 export class ProtocolError extends Error {
   code: string;
-  constructor(message: string, code = 'PROTOCOL_ERROR') {
-    super(message);
-    this.name = 'ProtocolError';
-    this.code = code;
-  }
+  constructor(message: string, code = 'PROTOCOL_ERROR') { super(message); this.name = 'ProtocolError'; this.code = code; }
 }
 
 export function validateEventName(event: string): void {
@@ -35,11 +28,9 @@ function encode(type: number, event: string, payload: Buffer, max = DEFAULT_MAX_
   const eb = Buffer.from(event, 'utf8');
   if (eb.length > MAX_EVENT_LENGTH) throw new ProtocolError(`Event name exceeds ${MAX_EVENT_LENGTH} bytes`, 'EVENT_TOO_LONG');
   const total = HEADER_SIZE + eb.length + payload.length;
-  if (total > max) throw new ProtocolError(`Frame exceeds max size (${max} bytes)`, 'FRAME_TOO_LARGE');
+  if (total > max) throw new ProtocolError(`Frame exceeds max size (${max})`, 'FRAME_TOO_LARGE');
   const f = Buffer.alloc(total);
-  f.writeUInt32BE(total, 0);
-  f[4] = type;
-  f.writeUInt16BE(eb.length, 5);
+  f.writeUInt32BE(total, 0); f[4] = type; f.writeUInt16BE(eb.length, 5);
   if (eb.length) eb.copy(f, HEADER_SIZE);
   if (payload.length) payload.copy(f, HEADER_SIZE + eb.length);
   return f;
@@ -47,9 +38,7 @@ function encode(type: number, event: string, payload: Buffer, max = DEFAULT_MAX_
 
 const emptyFrame = (type: number): Buffer => {
   const f = Buffer.alloc(HEADER_SIZE);
-  f.writeUInt32BE(HEADER_SIZE, 0);
-  f[4] = type;
-  f.writeUInt16BE(0, 5);
+  f.writeUInt32BE(HEADER_SIZE, 0); f[4] = type; f.writeUInt16BE(0, 5);
   return f;
 };
 
@@ -63,53 +52,54 @@ export const encodePingFrame = () => emptyFrame(FRAME_PING);
 export const encodePongFrame = () => emptyFrame(FRAME_PONG);
 export const encodeAckReqFrame = (name: string, data: unknown, max?: number) =>
   encode(FRAME_ACK_REQ, name, Buffer.from(JSON.stringify(data), 'utf8'), max);
-
 export const encodeAckResFrame = (name: string, data: unknown, max?: number) =>
   encode(FRAME_ACK_RES, name, Buffer.from(JSON.stringify(data), 'utf8'), max);
-
 export const encodeConnectFrame = (id: string) => encode(FRAME_CONNECT, 'connect', Buffer.from(id, 'utf8'));
 export const encodeDisconnectFrame = () => emptyFrame(FRAME_DISCONNECT);
 export const encodeJoinFrame = (room: string, max?: number) => encode(FRAME_JOIN, 'join-room', Buffer.from(room, 'utf8'), max);
 export const encodeLeaveFrame = (room: string) => encode(FRAME_LEAVE, 'leave-room', room ? Buffer.from(room, 'utf8') : Buffer.alloc(0));
 export const encodeErrorFrame = (msg: string) => encode(FRAME_ERROR, 'error', Buffer.from(msg, 'utf8'));
 
+/** O(1) append streaming parser — avoids Buffer.concat O(n²) on many small chunks */
 export class FrameParser {
-  private buf = Buffer.alloc(0);
+  private chunks: Buffer[] = [];
+  private len = 0;
   private max: number;
   private received = 0;
 
   constructor(max = DEFAULT_MAX_FRAME_SIZE) { this.max = max; }
 
+  private _compact(): Buffer {
+    if (this.chunks.length <= 1) return this.chunks[0] || Buffer.alloc(0);
+    const buf = Buffer.concat(this.chunks);
+    this.chunks = [buf];
+    return buf;
+  }
+
   feed(data: Buffer): ParsedFrame[] {
     this.received += data.length;
-    this.buf = Buffer.concat([this.buf, data]);
-    if (this.buf.length > this.max * 2) {
-      this.buf = Buffer.alloc(0);
-      throw new ProtocolError(`Buffer overflow (${this.max * 2})`, 'BUFFER_OVERFLOW');
-    }
+    this.chunks.push(data);
+    this.len += data.length;
+    if (this.len > this.max * 2) { this.chunks = []; this.len = 0; throw new ProtocolError(`Buffer overflow (${this.max * 2})`, 'BUFFER_OVERFLOW'); }
     const frames: ParsedFrame[] = [];
-    while (this.buf.length >= HEADER_SIZE) {
-      const total = this.buf.readUInt32BE(0);
-      if (total < HEADER_SIZE || total > this.max) {
-        this.buf = Buffer.alloc(0);
-        throw new ProtocolError(`Invalid frame size: ${total}`, total < HEADER_SIZE ? 'INVALID_FRAME_SIZE' : 'FRAME_TOO_LARGE');
-      }
-      if (this.buf.length < total) break;
-      const el = this.buf.readUInt16BE(5);
-      if (HEADER_SIZE + el > total || el > MAX_EVENT_LENGTH) {
-        this.buf = Buffer.alloc(0);
-        throw new ProtocolError('Invalid event length', 'INVALID_EVENT_LENGTH');
-      }
+    while (this.len >= HEADER_SIZE) {
+      const buf = this._compact();
+      const total = buf.readUInt32BE(0);
+      if (total < HEADER_SIZE || total > this.max) { this.chunks = []; this.len = 0; throw new ProtocolError(`Invalid frame size: ${total}`, total < HEADER_SIZE ? 'INVALID_FRAME_SIZE' : 'FRAME_TOO_LARGE'); }
+      if (buf.length < total) break;
+      const el = buf.readUInt16BE(5);
+      if (HEADER_SIZE + el > total || el > MAX_EVENT_LENGTH) { this.chunks = []; this.len = 0; throw new ProtocolError('Invalid event length', 'INVALID_EVENT_LENGTH'); }
       frames.push({
-        type: this.buf[4],
-        event: el ? this.buf.subarray(HEADER_SIZE, HEADER_SIZE + el).toString('utf8') : '',
-        payload: total > HEADER_SIZE + el ? Buffer.from(this.buf.subarray(HEADER_SIZE + el, total)) : Buffer.alloc(0),
+        type: buf[4],
+        event: el ? buf.subarray(HEADER_SIZE, HEADER_SIZE + el).toString('utf8') : '',
+        payload: total > HEADER_SIZE + el ? Buffer.from(buf.subarray(HEADER_SIZE + el, total)) : Buffer.alloc(0),
       });
-      this.buf = total < this.buf.length ? Buffer.from(this.buf.subarray(total)) : Buffer.alloc(0);
+      if (total < buf.length) { this.chunks = [Buffer.from(buf.subarray(total))]; this.len = this.chunks[0].length; }
+      else { this.chunks = []; this.len = 0; }
     }
     return frames;
   }
 
-  reset() { this.buf = Buffer.alloc(0); this.received = 0; }
+  reset() { this.chunks = []; this.len = 0; this.received = 0; }
   getBytesReceived() { return this.received; }
 }

package/src/websocket.d.ts

@@ -1,6 +1,4 @@
-/**
- * @stelar-time-real WebSocket (RFC 6455)
- */
+/** @stelar-time-real WebSocket (RFC 6455) + permessage-deflate (RFC 7692) */
 export declare const DEFAULT_MAX_WS_FRAME_SIZE: number;
 export declare const OP_CONTINUATION = 0, OP_TEXT = 1, OP_BINARY = 2, OP_CLOSE = 8, OP_PING = 9, OP_PONG = 10;
 export declare const CLOSE_NORMAL = 1000, CLOSE_GOING_AWAY = 1001, CLOSE_PROTOCOL_ERROR = 1002, CLOSE_UNSUPPORTED = 1003, CLOSE_INVALID_PAYLOAD = 1007, CLOSE_POLICY_VIOLATION = 1008, CLOSE_MESSAGE_TOO_BIG = 1009, CLOSE_INTERNAL_ERROR = 1011;
@@ -11,33 +9,41 @@ export declare class WebSocketError extends Error {
 export declare const computeAcceptKey: (key: string) => string;
 export declare const generateWSKey: () => string;
 export declare const validateWSKey: (key: string) => boolean;
-export declare function buildUpgradeResponse(key: string, headers?: Record<string, string>): string;
+export declare function buildUpgradeResponse(key: string, headers?: Record<string, string>, compress?: boolean): string;
+/** Parse client's Sec-WebSocket-Extensions header to check for permessage-deflate */
+export declare function clientWantsCompression(extensionsHeader: string | undefined): boolean;
 export interface WSFrame {
     fin: boolean;
     opcode: number;
     payload: Buffer;
     masked: boolean;
+    rsv1: boolean;
 }
+export declare function wsCompress(data: Buffer): Buffer;
+export declare function wsDecompress(data: Buffer): Buffer;
 export declare function parseWSFrame(buf: Buffer, max?: number): {
     frame: WSFrame;
     consumed: number;
 } | null;
-export declare function createWSFrame(opcode: number, payload: Buffer | string, masked?: boolean): Buffer;
-export declare const createWSTextFrame: (msg: string) => Buffer<ArrayBufferLike>;
+export declare function createWSFrame(opcode: number, payload: Buffer | string, masked?: boolean, compress?: boolean): Buffer;
+export declare const createWSTextFrame: (msg: string, compress?: boolean) => Buffer<ArrayBufferLike>;
 export declare const createWSBinaryFrame: (data: Buffer) => Buffer<ArrayBufferLike>;
 export declare const createWSCloseFrame: (code?: number, reason?: string) => Buffer<ArrayBufferLike>;
 export declare const createWSPingFrame: (data?: Buffer) => Buffer<ArrayBufferLike>;
 export declare const createWSPongFrame: (data?: Buffer) => Buffer<ArrayBufferLike>;
-export declare const createWSTextFrameMasked: (msg: string) => Buffer<ArrayBufferLike>;
+export declare const createWSTextFrameMasked: (msg: string, compress?: boolean) => Buffer<ArrayBufferLike>;
 export declare const createWSBinaryFrameMasked: (data: Buffer) => Buffer<ArrayBufferLike>;
 export declare const createWSCloseFrameMasked: (code?: number, reason?: string) => Buffer<ArrayBufferLike>;
 export declare const createWSPingFrameMasked: () => Buffer<ArrayBufferLike>;
 export declare const createWSPongFrameMasked: () => Buffer<ArrayBufferLike>;
+/** Streaming WS frame parser — O(1) append, avoids Buffer.concat O(n²) */
 export declare class WSFrameParser {
-    private buf;
+    private chunks;
+    private len;
     private max;
     private received;
     constructor(max?: number);
+    private _compact;
     feed(data: Buffer): WSFrame[];
     reset(): void;
     getBytesReceived(): number;

package/src/websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["websocket.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAE1D,eAAO,MAAM,eAAe,IAAM,EAAE,OAAO,IAAM,EAAE,SAAS,IAAM,EAChE,QAAQ,IAAM,EAAE,OAAO,IAAM,EAAE,OAAO,KAAM,CAAC;AAE/C,eAAO,MAAM,YAAY,OAAO,EAAE,gBAAgB,OAAO,EAAE,oBAAoB,OAAO,EACpF,iBAAiB,OAAO,EAAE,qBAAqB,OAAO,EAAE,sBAAsB,OAAO,EACrF,qBAAqB,OAAO,EAAE,oBAAoB,OAAO,CAAC;AAE5D,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,MAAM,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,IAAI,SAAuB;CACzD;AAED,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,WAA+D,CAAC;AAC5G,eAAO,MAAM,aAAa,cAA2C,CAAC;AACtE,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,OAA8E,CAAC;AAE3H,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAK1F;AAED,MAAM,WAAW,OAAO;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;CAAE;AAE5F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAA4B,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAetH;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,CAkB9F;AAGD,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,4BAAgC,CAAC;AAC9E,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,4BAAmC,CAAC;AACpF,eAAO,MAAM,kBAAkB,GAAI,aAAmB,EAAE,eAAW,4BAElE,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,4BAAoD,CAAC;AACpG,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,4BAAoD,CAAC;AAGpG,eAAO,MAAM,uBAAuB,GAAI,KAAK,MAAM,4BAAsC,CAAC;AAC1F,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,4BAAyC,CAAC;AAChG,eAAO,MAAM,wBAAwB,GAAI,aAAmB,EAAE,eAAW,4BAExE,CAAC;AACF,eAAO,MAAM,uBAAuB,+BAAsD,CAAC;AAC3F,eAAO,MAAM,uBAAuB,+BAAsD,CAAC;AAE3F,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAK;gBAET,GAAG,SAA4B;IAE3C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAgB7B,KAAK;IACL,gBAAgB;CACjB"}
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["websocket.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAM7E,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAE1D,eAAO,MAAM,eAAe,IAAM,EAAE,OAAO,IAAM,EAAE,SAAS,IAAM,EAChE,QAAQ,IAAM,EAAE,OAAO,IAAM,EAAE,OAAO,KAAM,CAAC;AAE/C,eAAO,MAAM,YAAY,OAAO,EAAE,gBAAgB,OAAO,EAAE,oBAAoB,OAAO,EACpF,iBAAiB,OAAO,EAAE,qBAAqB,OAAO,EAAE,sBAAsB,OAAO,EACrF,qBAAqB,OAAO,EAAE,oBAAoB,OAAO,CAAC;AAE5D,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,MAAM,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,IAAI,SAAuB;CACzD;AAED,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,WAA+D,CAAC;AAC5G,eAAO,MAAM,aAAa,cAA2C,CAAC;AACtE,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,OAA8E,CAAC;AAE3H,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAM5G;AAED,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGpF;AAED,MAAM,WAAW,OAAO;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;CAAE;AAI3G,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAA4B,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAetH;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,UAAQ,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAqBhH;AAGD,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,EAAE,kBAAgB,4BAAiD,CAAC;AACjH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,4BAAmC,CAAC;AACpF,eAAO,MAAM,kBAAkB,GAAI,aAAmB,EAAE,eAAW,4BAElE,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,4BAAoD,CAAC;AACpG,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,4BAAoD,CAAC;AAGpG,eAAO,MAAM,uBAAuB,GAAI,KAAK,MAAM,EAAE,kBAAgB,4BAAgD,CAAC;AACtH,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,4BAAyC,CAAC;AAChG,eAAO,MAAM,wBAAwB,GAAI,aAAmB,EAAE,eAAW,4BAExE,CAAC;AACF,eAAO,MAAM,uBAAuB,+BAAsD,CAAC;AAC3F,eAAO,MAAM,uBAAuB,+BAAsD,CAAC;AAE3F,0EAA0E;AAC1E,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAK;gBAET,GAAG,SAA4B;IAE3C,OAAO,CAAC,QAAQ;IAOhB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAyB7B,KAAK;IACL,gBAAgB;CACjB"}

package/src/websocket.js

@@ -1,7 +1,6 @@
-/**
- * @stelar-time-real WebSocket (RFC 6455)
- */
+/** @stelar-time-real WebSocket (RFC 6455) + permessage-deflate (RFC 7692) */
 import { createHash, randomBytes } from 'crypto';
+import { deflateRawSync, inflateRawSync } from 'zlib';
 const WS_MAGIC = '258EAFA5-E914-47DA-95CA-5AB5A7E3A741';
 export const DEFAULT_MAX_WS_FRAME_SIZE = 10 * 1024 * 1024;
 export const OP_CONTINUATION = 0x0, OP_TEXT = 0x1, OP_BINARY = 0x2, OP_CLOSE = 0x8, OP_PING = 0x9, OP_PONG = 0xA;
@@ -12,22 +11,38 @@ export class WebSocketError extends Error {
 export const computeAcceptKey = (key) => createHash('sha1').update(key + WS_MAGIC).digest('base64');
 export const generateWSKey = () => randomBytes(16).toString('base64');
 export const validateWSKey = (key) => typeof key === 'string' && Buffer.from(key, 'base64').length === 16;
-export function buildUpgradeResponse(key, headers) {
+export function buildUpgradeResponse(key, headers, compress = false) {
     const lines = ['HTTP/1.1 101 Switching Protocols', 'Upgrade: websocket', 'Connection: Upgrade', `Sec-WebSocket-Accept: ${computeAcceptKey(key)}`];
+    if (compress)
+        lines.push('Sec-WebSocket-Extensions: permessage-deflate; server_no_context_takeover; client_no_context_takeover');
     if (headers)
         for (const [k, v] of Object.entries(headers))
             lines.push(`${k}: ${v}`);
     lines.push('', '');
     return lines.join('\r\n');
 }
+/** Parse client's Sec-WebSocket-Extensions header to check for permessage-deflate */
+export function clientWantsCompression(extensionsHeader) {
+    if (!extensionsHeader)
+        return false;
+    return /permessage-deflate/.test(extensionsHeader);
+}
+const TAIL = Buffer.from([0x00, 0x00, 0xFF, 0xFF]);
+export function wsCompress(data) {
+    const deflated = deflateRawSync(data);
+    return deflated.subarray(0, deflated.length - 4);
+}
+export function wsDecompress(data) {
+    return inflateRawSync(Buffer.concat([data, TAIL]));
+}
 export function parseWSFrame(buf, max = DEFAULT_MAX_WS_FRAME_SIZE) {
     if (buf.length < 2)
         return null;
     const b0 = buf[0], b1 = buf[1];
-    const fin = !!(b0 & 0x80), rsv = b0 & 0x70, opcode = b0 & 0x0F, masked = !!(b1 & 0x80);
+    const fin = !!(b0 & 0x80), rsv1 = !!(b0 & 0x40), rsv = b0 & 0x30, opcode = b0 & 0x0F, masked = !!(b1 & 0x80);
     let len = b1 & 0x7F, off = 2;
     if (rsv)
-        throw new WebSocketError('RSV bits set', CLOSE_PROTOCOL_ERROR);
+        throw new WebSocketError('RSV2/RSV3 bits set', CLOSE_PROTOCOL_ERROR);
     if (len === 126) {
         if (buf.length < 4)
             return null;
@@ -55,44 +70,47 @@ export function parseWSFrame(buf, max = DEFAULT_MAX_WS_FRAME_SIZE) {
     if (masked && mk)
         for (let i = 0; i < len; i++)
             payload[i] ^= mk[i & 3];
-    return { frame: { fin, opcode, payload, masked }, consumed: off + len };
+    return { frame: { fin, opcode, payload, masked, rsv1 }, consumed: off + len };
 }
-export function createWSFrame(opcode, payload, masked = false) {
+export function createWSFrame(opcode, payload, masked = false, compress = false) {
     const d = typeof payload === 'string' ? Buffer.from(payload, 'utf8') : payload;
+    const compressed = compress && (opcode === OP_TEXT || opcode === OP_BINARY) ? wsCompress(d) : d;
+    const actualOpcode = compressed !== d ? opcode : opcode;
     const mk = masked ? randomBytes(4) : undefined;
     const base = masked ? 0x80 : 0;
+    const rsv1Bit = (compress && (opcode === OP_TEXT || opcode === OP_BINARY) && compressed !== d) ? 0x40 : 0;
     let h;
-    if (d.length < 126) {
+    if (compressed.length < 126) {
         h = Buffer.alloc(masked ? 6 : 2);
-        h[0] = 0x80 | opcode;
-        h[1] = base | d.length;
+        h[0] = 0x80 | rsv1Bit | actualOpcode;
+        h[1] = base | compressed.length;
         if (mk)
             mk.copy(h, 2);
     }
-    else if (d.length < 65536) {
+    else if (compressed.length < 65536) {
         h = Buffer.alloc(masked ? 8 : 4);
-        h[0] = 0x80 | opcode;
+        h[0] = 0x80 | rsv1Bit | actualOpcode;
         h[1] = base | 126;
-        h.writeUInt16BE(d.length, 2);
+        h.writeUInt16BE(compressed.length, 2);
         if (mk)
             mk.copy(h, 4);
     }
     else {
         h = Buffer.alloc(masked ? 14 : 10);
-        h[0] = 0x80 | opcode;
+        h[0] = 0x80 | rsv1Bit | actualOpcode;
         h[1] = base | 127;
-        h.writeUInt32BE(Math.floor(d.length / 0x100000000), 2);
-        h.writeUInt32BE(d.length & 0xFFFFFFFF, 6);
+        h.writeUInt32BE(Math.floor(compressed.length / 0x100000000), 2);
+        h.writeUInt32BE(compressed.length & 0xFFFFFFFF, 6);
         if (mk)
             mk.copy(h, 10);
     }
     if (mk)
-        for (let i = 0; i < d.length; i++)
-            d[i] ^= mk[i & 3];
-    return Buffer.concat([h, d]);
+        for (let i = 0; i < compressed.length; i++)
+            compressed[i] ^= mk[i & 3];
+    return Buffer.concat([h, compressed]);
 }
 /* Server (unmasked) */
-export const createWSTextFrame = (msg) => createWSFrame(OP_TEXT, msg);
+export const createWSTextFrame = (msg, compress = false) => createWSFrame(OP_TEXT, msg, false, compress);
 export const createWSBinaryFrame = (data) => createWSFrame(OP_BINARY, data);
 export const createWSCloseFrame = (code = CLOSE_NORMAL, reason = '') => {
     const b = Buffer.alloc(2 + Buffer.byteLength(reason));
@@ -104,7 +122,7 @@ export const createWSCloseFrame = (code = CLOSE_NORMAL, reason = '') => {
 export const createWSPingFrame = (data) => createWSFrame(OP_PING, data || Buffer.alloc(0));
 export const createWSPongFrame = (data) => createWSFrame(OP_PONG, data || Buffer.alloc(0));
 /* Client (masked) */
-export const createWSTextFrameMasked = (msg) => createWSFrame(OP_TEXT, msg, true);
+export const createWSTextFrameMasked = (msg, compress = false) => createWSFrame(OP_TEXT, msg, true, compress);
 export const createWSBinaryFrameMasked = (data) => createWSFrame(OP_BINARY, data, true);
 export const createWSCloseFrameMasked = (code = CLOSE_NORMAL, reason = '') => {
     const b = Buffer.alloc(2 + Buffer.byteLength(reason));
@@ -115,36 +133,67 @@ export const createWSCloseFrameMasked = (code = CLOSE_NORMAL, reason = '') => {
 };
 export const createWSPingFrameMasked = () => createWSFrame(OP_PING, Buffer.alloc(0), true);
 export const createWSPongFrameMasked = () => createWSFrame(OP_PONG, Buffer.alloc(0), true);
+/** Streaming WS frame parser — O(1) append, avoids Buffer.concat O(n²) */
 export class WSFrameParser {
     constructor(max = DEFAULT_MAX_WS_FRAME_SIZE) {
-        this.buf = Buffer.alloc(0);
+        this.chunks = [];
+        this.len = 0;
         this.received = 0;
         this.max = max;
     }
+    _compact() {
+        if (this.chunks.length <= 1)
+            return this.chunks[0] || Buffer.alloc(0);
+        const buf = Buffer.concat(this.chunks);
+        this.chunks = [buf];
+        return buf;
+    }
     feed(data) {
         this.received += data.length;
-        this.buf = Buffer.concat([this.buf, data]);
-        if (this.buf.length > this.max * 2) {
-            this.buf = Buffer.alloc(0);
+        this.chunks.push(data);
+        this.len += data.length;
+        if (this.len > this.max * 2) {
+            this.chunks = [];
+            this.len = 0;
             throw new WebSocketError('Buffer overflow', CLOSE_POLICY_VIOLATION);
         }
         const frames = [];
-        while (this.buf.length > 0) {
+        while (this.len > 0) {
+            const buf = this._compact();
             try {
-                const r = parseWSFrame(this.buf, this.max);
+                const r = parseWSFrame(buf, this.max);
                 if (!r)
                     break;
-                this.buf = r.consumed < this.buf.length ? Buffer.from(this.buf.subarray(r.consumed)) : Buffer.alloc(0);
-                if (r.frame.opcode !== OP_CONTINUATION)
+                const consumed = r.consumed;
+                if (consumed < buf.length) {
+                    this.chunks = [Buffer.from(buf.subarray(consumed))];
+                    this.len = this.chunks[0].length;
+                }
+                else {
+                    this.chunks = [];
+                    this.len = 0;
+                }
+                if (r.frame.opcode !== OP_CONTINUATION) {
+                    if (r.frame.rsv1 && (r.frame.opcode === OP_TEXT || r.frame.opcode === OP_BINARY)) {
+                        try {
+                            r.frame.payload = wsDecompress(r.frame.payload);
+                            r.frame.rsv1 = false;
+                        }
+                        catch {
+                            throw new WebSocketError('Decompression failed', CLOSE_INVALID_PAYLOAD);
+                        }
+                    }
                     frames.push(r.frame);
+                }
             }
             catch (e) {
-                this.buf = Buffer.alloc(0);
+                this.chunks = [];
+                this.len = 0;
                 throw e;
             }
         }
         return frames;
     }
-    reset() { this.buf = Buffer.alloc(0); this.received = 0; }
+    reset() { this.chunks = []; this.len = 0; this.received = 0; }
     getBytesReceived() { return this.received; }
 }