better-sse 0.12.1 → 0.14.0

package/build/index.js

@@ -1,2 +1,610 @@
-!function(e,t){if("object"==typeof exports&&"object"==typeof module)module.exports=t();else if("function"==typeof define&&define.amd)define([],t);else{var s=t();for(var i in s)("object"==typeof exports?exports:e)[i]=s[i]}}(global,(()=>(()=>{"use strict";var e={n:t=>{var s=t&&t.__esModule?()=>t.default:()=>t;return e.d(s,{a:s}),s},d:(t,s)=>{for(var i in s)e.o(s,i)&&!e.o(t,i)&&Object.defineProperty(t,i,{enumerable:!0,get:s[i]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{Channel:()=>g,EventBuffer:()=>d,Session:()=>m,SseError:()=>v,createChannel:()=>y,createEventBuffer:()=>w,createSession:()=>b});const s=require("http"),i=e=>JSON.stringify(e),r=/(\r\n|\r|\n)/g,n=/\n+$/g,o=e=>{let t=e;return t=t.replace(r,"\n"),t=t.replace(n,""),t},h=require("crypto");let a;a=h.randomUUID?()=>(0,h.randomUUID)():()=>(0,h.randomBytes)(4).toString("hex");const c=e=>async(t,s={})=>{const{eventName:i="stream"}=s;return await new Promise(((s,r)=>{t.on("data",(t=>{let s;s=Buffer.isBuffer(t)?t.toString():t,e(s,i)})),t.once("end",(()=>s(!0))),t.once("close",(()=>s(!0))),t.once("error",(e=>r(e)))}))},l=e=>async(t,s={})=>{const{eventName:i="iteration"}=s;for await(const s of t)e(s,i)};class d{constructor(e={}){var t,s;this.buffer="",this.writeField=(e,t)=>{const s=this.sanitize(t);return this.buffer+=e+":"+s+"\n",this},this.data=e=>{const t=this.serialize(e);return this.writeField("data",t),this},this.id=(e="")=>(this.writeField("id",e),this),this.retry=e=>{const t=e.toString();return this.writeField("retry",t),this},this.comment=(e="")=>(this.writeField("",e),this),this.dispatch=()=>(this.buffer+="\n",this),this.push=(e,t="message",s=a())=>(this.event(t).id(s).data(e).dispatch(),this),this.stream=c(this.push),this.iterate=l(this.push),this.clear=()=>(this.buffer="",this),this.read=()=>this.buffer,this.serialize=null!==(t=e.serializer)&&void 0!==t?t:i,this.sanitize=null!==(s=e.sanitizer)&&void 0!==s?s:o}event(e){return this.writeField("event",e),this}}const u=require("events");var f=e.n(u);class p extends(f()){addListener(e,t){return super.addListener(e,t)}prependListener(e,t){return super.prependListener(e,t)}prependOnceListener(e,t){return super.prependOnceListener(e,t)}on(e,t){return super.on(e,t)}once(e,t){return super.once(e,t)}emit(e,...t){return super.emit(e,...t)}off(e,t){return super.off(e,t)}removeListener(e,t){return super.removeListener(e,t)}}class v extends Error{constructor(e){super(e),this.message=`better-sse: ${e}`}}class m extends p{constructor(e,t,r={}){var n,h,u,f,p,m,b;super(),this.lastId="",this.isConnected=!1,this.state={},this.initialize=()=>{var e,t,i;const r=`http://${this.req.headers.host}${this.req.url}`,n=new URL(r).searchParams;if(this.trustClientEventId){const s=null!==(i=null!==(t=null!==(e=this.req.headers["last-event-id"])&&void 0!==e?e:n.get("lastEventId"))&&void 0!==t?t:n.get("evs_last_event_id"))&&void 0!==i?i:"";this.lastId=s}const o={};this.res instanceof s.ServerResponse?(o["Content-Type"]="text/event-stream",o["Cache-Control"]="private, no-cache, no-store, no-transform, must-revalidate, max-age=0",o.Connection="keep-alive",o.Pragma="no-cache",o["X-Accel-Buffering"]="no"):(o["content-type"]="text/event-stream",o["cache-control"]="private, no-cache, no-store, no-transform, must-revalidate, max-age=0",o.pragma="no-cache",o["x-accel-buffering"]="no");for(const[e,t]of Object.entries(this.headers))o[e]=null!=t?t:"";this.res.writeHead(this.statusCode,o),n.has("padding")&&this.buffer.comment(" ".repeat(2049)).dispatch(),n.has("evs_preamble")&&this.buffer.comment(" ".repeat(2056)).dispatch(),null!==this.initialRetry&&this.buffer.retry(this.initialRetry).dispatch(),this.flush(),null!==this.keepAliveInterval&&(this.keepAliveTimer=setInterval(this.keepAlive,this.keepAliveInterval)),this.isConnected=!0,this.emit("connected")},this.onDisconnected=()=>{this.req.removeListener("close",this.onDisconnected),this.res.removeListener("close",this.onDisconnected),this.keepAliveTimer&&clearInterval(this.keepAliveTimer),this.isConnected=!1,this.emit("disconnected")},this.keepAlive=()=>{this.buffer.comment().dispatch(),this.flush()},this.data=e=>(this.buffer.data(e),this),this.id=(e="")=>(this.buffer.id(e),this.lastId=e,this),this.retry=e=>(this.buffer.retry(e),this),this.comment=e=>(this.buffer.comment(e),this),this.dispatch=()=>(this.buffer.dispatch(),this),this.flush=()=>(this.res.write(this.buffer.read()),this.buffer.clear(),this),this.push=(e,t="message",s=a())=>{if(!this.isConnected)throw new v("Cannot push data to a non-active session.");return this.buffer.push(e,t,s),this.flush(),this.lastId=s,this.emit("push",e,t,s),this},this.stream=c(this.push),this.iterate=l(this.push),this.batch=async e=>{if(e instanceof d)this.res.write(e.read());else{const t=new d({serializer:this.serialize,sanitizer:this.sanitize});await e(t),this.res.write(t.read())}},this.req=e,this.res=t;const g=null!==(n=r.serializer)&&void 0!==n?n:i,y=null!==(h=r.sanitizer)&&void 0!==h?h:o;this.serialize=g,this.sanitize=y,this.buffer=new d({serializer:g,sanitizer:y}),this.trustClientEventId=null===(u=r.trustClientEventId)||void 0===u||u,this.initialRetry=null===r.retry?null:null!==(f=r.retry)&&void 0!==f?f:2e3,this.keepAliveInterval=null===r.keepAlive?null:null!==(p=r.keepAlive)&&void 0!==p?p:1e4,this.statusCode=null!==(m=r.statusCode)&&void 0!==m?m:200,this.headers=null!==(b=r.headers)&&void 0!==b?b:{},this.req.once("close",this.onDisconnected),this.res.once("close",this.onDisconnected),setImmediate(this.initialize)}event(e){return this.buffer.event(e),this}}const b=(...e)=>new Promise((t=>{const s=new m(...e);s.once("connected",(()=>{t(s)}))}));class g extends p{constructor(){super(),this.state={},this.sessions=new Set,this.broadcast=(e,t="message",s={})=>{var i;const r=null!==(i=s.eventId)&&void 0!==i?i:a(),n=s.filter?this.activeSessions.filter(s.filter):this.sessions;for(const s of n)s.push(e,t,r);return this.emit("broadcast",e,t,r),this}}get activeSessions(){return Array.from(this.sessions)}get sessionCount(){return this.sessions.size}register(e){if(this.sessions.has(e))return this;if(!e.isConnected)throw new v("Cannot register a non-active session.");return e.once("disconnected",(()=>{this.emit("session-disconnected",e),this.deregister(e)})),this.sessions.add(e),this.emit("session-registered",e),this}deregister(e){return this.sessions.has(e)?(this.sessions.delete(e),this.emit("session-deregistered",e),this):this}}const y=(...e)=>new g(...e),w=(...e)=>new d(...e);return t})()));
-//# sourceMappingURL=index.js.map
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Channel: () => Channel,
+  EventBuffer: () => EventBuffer,
+  Session: () => Session,
+  SseError: () => SseError,
+  createChannel: () => createChannel,
+  createEventBuffer: () => createEventBuffer,
+  createSession: () => createSession
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/Session.ts
+var import_http = require("http");
+
+// src/lib/serialize.ts
+var serialize = (data) => JSON.stringify(data);
+
+// src/lib/sanitize.ts
+var newlineVariantsRegex = /(\r\n|\r|\n)/g;
+var newlineTrailingRegex = /\n+$/g;
+var sanitize = (text) => {
+  let sanitized = text;
+  sanitized = sanitized.replace(newlineVariantsRegex, "\n");
+  sanitized = sanitized.replace(newlineTrailingRegex, "");
+  return sanitized;
+};
+
+// src/lib/generateId.ts
+var import_crypto = require("crypto");
+var generateId;
+if (import_crypto.randomUUID) {
+  generateId = () => (0, import_crypto.randomUUID)();
+} else {
+  generateId = () => (0, import_crypto.randomBytes)(4).toString("hex");
+}
+
+// src/lib/createPushFromStream.ts
+var createPushFromStream = (push) => async (stream, options = {}) => {
+  const { eventName = "stream" } = options;
+  return await new Promise((resolve, reject) => {
+    stream.on("data", (chunk) => {
+      let data;
+      if (Buffer.isBuffer(chunk)) {
+        data = chunk.toString();
+      } else {
+        data = chunk;
+      }
+      push(data, eventName);
+    });
+    stream.once("end", () => resolve(true));
+    stream.once("close", () => resolve(true));
+    stream.once("error", (err) => reject(err));
+  });
+};
+
+// src/lib/createPushFromIterable.ts
+var createPushFromIterable = (push) => async (iterable, options = {}) => {
+  const { eventName = "iteration" } = options;
+  for await (const data of iterable) {
+    push(data, eventName);
+  }
+};
+
+// src/EventBuffer.ts
+var EventBuffer = class {
+  buffer = "";
+  serialize;
+  sanitize;
+  constructor(options = {}) {
+    this.serialize = options.serializer ?? serialize;
+    this.sanitize = options.sanitizer ?? sanitize;
+  }
+  /**
+   * Write a line with a field key and value appended with a newline character.
+   */
+  writeField = (name, value) => {
+    const sanitized = this.sanitize(value);
+    this.buffer += name + ":" + sanitized + "\n";
+    return this;
+  };
+  /**
+   * Write an event name field (also referred to as the event "type" in the specification).
+   *
+   * @param type - Event name/type.
+   */
+  event(type) {
+    this.writeField("event", type);
+    return this;
+  }
+  /**
+   * Write arbitrary data into a data field.
+   *
+   * Data is serialized to a string using the given `serializer` function option or JSON stringification by default.
+   *
+   * @param data - Data to serialize and write.
+   */
+  data = (data) => {
+    const serialized = this.serialize(data);
+    this.writeField("data", serialized);
+    return this;
+  };
+  /**
+   * Write an event ID field.
+   *
+   * Defaults to an empty string if no argument is given.
+   *
+   * @param id - Identification string to write.
+   */
+  id = (id = "") => {
+    this.writeField("id", id);
+    return this;
+  };
+  /**
+   * Write a retry field that suggests a reconnection time with the given milliseconds.
+   *
+   * @param time - Time in milliseconds to retry.
+   */
+  retry = (time) => {
+    const stringifed = time.toString();
+    this.writeField("retry", stringifed);
+    return this;
+  };
+  /**
+   * Write a comment (an ignored field).
+   *
+   * This will not fire an event but is often used to keep the connection alive.
+   *
+   * @param text - Text of the comment. Otherwise writes an empty field value.
+   */
+  comment = (text = "") => {
+    this.writeField("", text);
+    return this;
+  };
+  /**
+   * Indicate that the event has finished being created by writing an additional newline character.
+   */
+  dispatch = () => {
+    this.buffer += "\n";
+    return this;
+  };
+  /**
+   * Create, write and dispatch an event with the given data all at once.
+   *
+   * This is equivalent to calling the methods `event`, `id`, `data` and `dispatch` in that order.
+   *
+   * If no event name is given, the event name is set to `"message"`.
+   *
+   * If no event ID is given, the event ID is set to a unique string generated using a cryptographic pseudorandom number generator.
+   *
+   * @param data - Data to write.
+   * @param eventName - Event name to write.
+   * @param eventId - Event ID to write.
+   */
+  push = (data, eventName = "message", eventId = generateId()) => {
+    this.event(eventName).id(eventId).data(data).dispatch();
+    return this;
+  };
+  /**
+   * Pipe readable stream data as a series of events into the buffer.
+   *
+   * This uses the `push` method under the hood.
+   *
+   * If no event name is given in the `options` object, the event name is set to `"stream"`.
+   *
+   * @param stream - Readable stream to consume data from.
+   * @param options - Event name to use for each event created.
+   *
+   * @returns A promise that resolves or rejects based on the success of the stream write finishing.
+   */
+  stream = createPushFromStream(this.push);
+  /**
+   * Iterate over an iterable and write yielded values as events into the buffer.
+   *
+   * This uses the `push` method under the hood.
+   *
+   * If no event name is given in the `options` object, the event name is set to `"iteration"`.
+   *
+   * @param iterable - Iterable to consume data from.
+   *
+   * @returns A promise that resolves once all data has been successfully yielded from the iterable.
+   */
+  iterate = createPushFromIterable(this.push);
+  /**
+   * Clear the contents of the buffer.
+   */
+  clear = () => {
+    this.buffer = "";
+    return this;
+  };
+  /**
+   * Get a copy of the buffer contents.
+   */
+  read = () => this.buffer;
+};
+
+// src/lib/TypedEmitter.ts
+var import_events = require("events");
+var TypedEmitter = class extends import_events.EventEmitter {
+  addListener(event, listener) {
+    return super.addListener(event, listener);
+  }
+  prependListener(event, listener) {
+    return super.prependListener(event, listener);
+  }
+  prependOnceListener(event, listener) {
+    return super.prependOnceListener(event, listener);
+  }
+  on(event, listener) {
+    return super.on(event, listener);
+  }
+  once(event, listener) {
+    return super.once(event, listener);
+  }
+  emit(event, ...args) {
+    return super.emit(event, ...args);
+  }
+  off(event, listener) {
+    return super.off(event, listener);
+  }
+  removeListener(event, listener) {
+    return super.removeListener(event, listener);
+  }
+};
+
+// src/lib/SseError.ts
+var SseError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.message = `better-sse: ${message}`;
+  }
+};
+
+// src/Session.ts
+var Session = class extends TypedEmitter {
+  /**
+   * The last event ID sent to the client.
+   *
+   * This is initialized to the last event ID given by the user, and otherwise is equal to the last number given to the `.id` method.
+   *
+   * For security reasons, keep in mind that the client can provide *any* initial ID here. Use the `trustClientEventId` constructor option to ignore the client-given initial ID.
+   *
+   * @readonly
+   */
+  lastId = "";
+  /**
+   * Indicates whether the session and underlying connection is open or not.
+   *
+   * @readonly
+   */
+  isConnected = false;
+  /**
+   * Custom state for this session.
+   *
+   * Use this object to safely store information related to the session and user.
+   *
+   * Use [module augmentation and declaration merging](https://www.typescriptlang.org/docs/handbook/declaration-merging.html#module-augmentation)
+   * to safely add new properties to the `DefaultSessionState` interface.
+   */
+  state;
+  buffer;
+  /**
+   * Raw HTTP request.
+   */
+  req;
+  /**
+   * Raw HTTP response that is the minimal interface needed and forms the
+   * intersection between the HTTP/1.1 and HTTP/2 server response interfaces.
+   */
+  res;
+  serialize;
+  sanitize;
+  trustClientEventId;
+  initialRetry;
+  keepAliveInterval;
+  keepAliveTimer;
+  statusCode;
+  headers;
+  constructor(req, res, options = {}) {
+    super();
+    this.req = req;
+    this.res = res;
+    const serializer = options.serializer ?? serialize;
+    const sanitizer = options.sanitizer ?? sanitize;
+    this.serialize = serializer;
+    this.sanitize = sanitizer;
+    this.buffer = new EventBuffer({ serializer, sanitizer });
+    this.trustClientEventId = options.trustClientEventId ?? true;
+    this.initialRetry = options.retry === null ? null : options.retry ?? 2e3;
+    this.keepAliveInterval = options.keepAlive === null ? null : options.keepAlive ?? 1e4;
+    this.statusCode = options.statusCode ?? 200;
+    this.headers = options.headers ?? {};
+    this.state = options.state ?? {};
+    this.req.once("close", this.onDisconnected);
+    this.res.once("close", this.onDisconnected);
+    setImmediate(this.initialize);
+  }
+  initialize = () => {
+    const url = `http://${this.req.headers.host}${this.req.url}`;
+    const params = new URL(url).searchParams;
+    if (this.trustClientEventId) {
+      const givenLastEventId = this.req.headers["last-event-id"] ?? params.get("lastEventId") ?? params.get("evs_last_event_id") ?? "";
+      this.lastId = givenLastEventId;
+    }
+    const headers = {};
+    if (this.res instanceof import_http.ServerResponse) {
+      headers["Content-Type"] = "text/event-stream";
+      headers["Cache-Control"] = "private, no-cache, no-store, no-transform, must-revalidate, max-age=0";
+      headers["Connection"] = "keep-alive";
+      headers["Pragma"] = "no-cache";
+      headers["X-Accel-Buffering"] = "no";
+    } else {
+      headers["content-type"] = "text/event-stream";
+      headers["cache-control"] = "private, no-cache, no-store, no-transform, must-revalidate, max-age=0";
+      headers["pragma"] = "no-cache";
+      headers["x-accel-buffering"] = "no";
+    }
+    for (const [name, value] of Object.entries(this.headers)) {
+      headers[name] = value ?? "";
+    }
+    this.res.writeHead(this.statusCode, headers);
+    if (params.has("padding")) {
+      this.buffer.comment(" ".repeat(2049)).dispatch();
+    }
+    if (params.has("evs_preamble")) {
+      this.buffer.comment(" ".repeat(2056)).dispatch();
+    }
+    if (this.initialRetry !== null) {
+      this.buffer.retry(this.initialRetry).dispatch();
+    }
+    this.flush();
+    if (this.keepAliveInterval !== null) {
+      this.keepAliveTimer = setInterval(
+        this.keepAlive,
+        this.keepAliveInterval
+      );
+    }
+    this.isConnected = true;
+    this.emit("connected");
+  };
+  onDisconnected = () => {
+    this.req.removeListener("close", this.onDisconnected);
+    this.res.removeListener("close", this.onDisconnected);
+    if (this.keepAliveTimer) {
+      clearInterval(this.keepAliveTimer);
+    }
+    this.isConnected = false;
+    this.emit("disconnected");
+  };
+  keepAlive = () => {
+    this.buffer.comment().dispatch();
+    this.flush();
+  };
+  /**
+   * @deprecated see https://github.com/MatthewWid/better-sse/issues/52
+   */
+  event(type) {
+    this.buffer.event(type);
+    return this;
+  }
+  /**
+   * @deprecated see https://github.com/MatthewWid/better-sse/issues/52
+   */
+  data = (data) => {
+    this.buffer.data(data);
+    return this;
+  };
+  /**
+   * @deprecated see https://github.com/MatthewWid/better-sse/issues/52
+   */
+  id = (id = "") => {
+    this.buffer.id(id);
+    this.lastId = id;
+    return this;
+  };
+  /**
+   * @deprecated see https://github.com/MatthewWid/better-sse/issues/52
+   */
+  retry = (time) => {
+    this.buffer.retry(time);
+    return this;
+  };
+  /**
+   * @deprecated see https://github.com/MatthewWid/better-sse/issues/52
+   */
+  comment = (text) => {
+    this.buffer.comment(text);
+    return this;
+  };
+  /**
+   * @deprecated see https://github.com/MatthewWid/better-sse/issues/52
+   */
+  dispatch = () => {
+    this.buffer.dispatch();
+    return this;
+  };
+  /**
+   * Flush the contents of the internal buffer to the client and clear the buffer.
+   *
+   * @deprecated see https://github.com/MatthewWid/better-sse/issues/52
+   */
+  flush = () => {
+    this.res.write(this.buffer.read());
+    this.buffer.clear();
+    return this;
+  };
+  /**
+   * Push an event to the client.
+   *
+   * If no event name is given, the event name is set to `"message"`.
+   *
+   * If no event ID is given, the event ID (and thus the `lastId` property) is set to a unique string generated using a cryptographic pseudorandom number generator.
+   *
+   * Emits the `push` event with the given data, event name and event ID in that order.
+   *
+   * @param data - Data to write.
+   * @param eventName - Event name to write.
+   * @param eventId - Event ID to write.
+   */
+  push = (data, eventName = "message", eventId = generateId()) => {
+    if (!this.isConnected) {
+      throw new SseError("Cannot push data to a non-active session.");
+    }
+    this.buffer.push(data, eventName, eventId);
+    this.flush();
+    this.lastId = eventId;
+    this.emit("push", data, eventName, eventId);
+    return this;
+  };
+  /**
+   * Pipe readable stream data as a series of events to the client.
+   *
+   * This uses the `push` method under the hood.
+   *
+   * If no event name is given in the `options` object, the event name is set to `"stream"`.
+   *
+   * @param stream - Readable stream to consume data from.
+   * @param options - Options to alter how the stream is flushed to the client.
+   *
+   * @returns A promise that resolves or rejects based on the success of the stream write finishing.
+   */
+  stream = createPushFromStream(this.push);
+  /**
+   * Iterate over an iterable and send yielded values as events to the client.
+   *
+   * This uses the `push` method under the hood.
+   *
+   * If no event name is given in the `options` object, the event name is set to `"iteration"`.
+   *
+   * @param iterable - Iterable to consume data from.
+   *
+   * @returns A promise that resolves once all data has been successfully yielded from the iterable.
+   */
+  iterate = createPushFromIterable(this.push);
+  /**
+   * Batch and send multiple events at once.
+   *
+   * If given an `EventBuffer` instance, its contents will be sent to the client.
+   *
+   * If given a callback, it will be passed an instance of `EventBuffer` which uses the same serializer and sanitizer as the session.
+   * Once its execution completes - or once it resolves if it returns a promise - the contents of the passed `EventBuffer` will be sent to the client.
+   *
+   * @param batcher - Event buffer to get contents from, or callback that takes an event buffer to write to.
+   *
+   * @returns A promise that resolves once all data from the event buffer has been successfully sent to the client.
+   *
+   * @see EventBuffer
+   */
+  batch = async (batcher) => {
+    if (batcher instanceof EventBuffer) {
+      this.res.write(batcher.read());
+    } else {
+      const buffer = new EventBuffer({
+        serializer: this.serialize,
+        sanitizer: this.sanitize
+      });
+      await batcher(buffer);
+      this.res.write(buffer.read());
+    }
+  };
+};
+
+// src/createSession.ts
+var createSession = (...args) => new Promise((resolve) => {
+  const session = new Session(...args);
+  session.once("connected", () => {
+    resolve(session);
+  });
+});
+
+// src/Channel.ts
+var Channel = class extends TypedEmitter {
+  /**
+   * Custom state for this channel.
+   *
+   * Use this object to safely store information related to the channel.
+   */
+  state;
+  sessions = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    super();
+    this.state = options.state ?? {};
+  }
+  /**
+   * List of the currently active sessions subscribed to this channel.
+   */
+  get activeSessions() {
+    return Array.from(this.sessions);
+  }
+  /**
+   * Number of sessions subscribed to this channel.
+   */
+  get sessionCount() {
+    return this.sessions.size;
+  }
+  /**
+   * Register a session so that it can start receiving events from this channel.
+   *
+   * If the session was already registered to begin with this method does nothing.
+   *
+   * @param session - Session to register.
+   */
+  register(session) {
+    if (this.sessions.has(session)) {
+      return this;
+    }
+    if (!session.isConnected) {
+      throw new SseError("Cannot register a non-active session.");
+    }
+    session.once("disconnected", () => {
+      this.emit("session-disconnected", session);
+      this.deregister(session);
+    });
+    this.sessions.add(session);
+    this.emit("session-registered", session);
+    return this;
+  }
+  /**
+   * Deregister a session so that it no longer receives events from this channel.
+   *
+   * If the session was not registered to begin with this method does nothing.
+   *
+   * @param session - Session to deregister.
+   */
+  deregister(session) {
+    if (!this.sessions.has(session)) {
+      return this;
+    }
+    this.sessions.delete(session);
+    this.emit("session-deregistered", session);
+    return this;
+  }
+  /**
+   * Broadcast an event to every active session registered with this channel.
+   *
+   * Under the hood this calls the `push` method on every active session.
+   *
+   * If no event name is given, the event name is set to `"message"`.
+   *
+   * Note that the broadcasted event will have the same ID across all receiving sessions instead of generating a unique ID for each.
+   *
+   * @param data - Data to write.
+   * @param eventName - Event name to write.
+   */
+  broadcast = (data, eventName = "message", options = {}) => {
+    const eventId = options.eventId ?? generateId();
+    const sessions = options.filter ? this.activeSessions.filter(options.filter) : this.sessions;
+    for (const session of sessions) {
+      session.push(data, eventName, eventId);
+    }
+    this.emit("broadcast", data, eventName, eventId);
+    return this;
+  };
+};
+
+// src/createChannel.ts
+var createChannel = (...args) => new Channel(...args);
+
+// src/createEventBuffer.ts
+var createEventBuffer = (...args) => new EventBuffer(...args);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Channel,
+  EventBuffer,
+  Session,
+  SseError,
+  createChannel,
+  createEventBuffer,
+  createSession
+});