effect 4.0.2 → 4.0.4

package/dist/socket/DatagramSocket.js

@@ -0,0 +1,535 @@
+import * as Context from "../Context.js";
+import * as Effect from "../Effect.js";
+import * as Fiber from "../Fiber.js";
+import { constVoid } from "../Function.js";
+import { args, contA, contAll, exitSucceed, makePrimitive, withFiber } from "../internal/core.js";
+import * as Latch from "../Latch.js";
+import * as NetAddress from "../net/NetAddress.js";
+import * as Predicate from "../Predicate.js";
+import * as Schema from "../Schema.js";
+import * as Scope from "../Scope.js";
+/**
+ * Runtime type identifier attached to `DatagramSocket` services.
+ *
+ * @stability experimental
+ * @category type IDs
+ * @since 4.0.0
+ */
+export const TypeId = "~effect/socket/DatagramSocket";
+/**
+ * Service tag for UDP socket transports.
+ *
+ * @stability experimental
+ * @category services
+ * @since 4.0.0
+ */
+export const DatagramSocket = /*#__PURE__*/Context.Service("effect/socket/DatagramSocket");
+/**
+ * Creates a `DatagramSocket` from its `reader` and `writer` effects.
+ *
+ * @stability experimental
+ * @category constructors
+ * @since 4.0.0
+ */
+export const make = options => DatagramSocket.of({
+  [TypeId]: TypeId,
+  reader: options.reader,
+  writer: options.writer
+});
+/**
+ * Opening or binding the native socket, applying its options, or resolving
+ * a name failed.
+ *
+ * @stability experimental
+ * @category errors
+ * @since 4.0.0
+ */
+export class DatagramSocketOpenError extends /*#__PURE__*/Schema.Error("effect/socket/DatagramSocket/OpenError")({
+  _tag: /*#__PURE__*/Schema.tag("DatagramSocketOpenError"),
+  kind: /*#__PURE__*/Schema.Literals(["AddressInUse", "AddressNotAvailable", "PermissionDenied", "Unknown"]),
+  cause: /*#__PURE__*/Schema.Defect()
+}) {}
+/**
+ * A receive failed, or an ICMP report arrived with no write left to fail.
+ *
+ * @stability experimental
+ * @category errors
+ * @since 4.0.0
+ */
+export class DatagramSocketReadError extends /*#__PURE__*/Schema.Error("effect/socket/DatagramSocket/ReadError")({
+  _tag: /*#__PURE__*/Schema.tag("DatagramSocketReadError"),
+  kind: /*#__PURE__*/Schema.Literals(["MessageTooLarge", "Unreachable", "ConnectionRefused", "PermissionDenied", "Unknown"]),
+  cause: /*#__PURE__*/Schema.Defect()
+}) {}
+/**
+ * A send failed. `address` is the destination when it is known.
+ *
+ * @stability experimental
+ * @category errors
+ * @since 4.0.0
+ */
+export class DatagramSocketWriteError extends /*#__PURE__*/Schema.Error("effect/socket/DatagramSocket/WriteError")({
+  _tag: /*#__PURE__*/Schema.tag("DatagramSocketWriteError"),
+  kind: /*#__PURE__*/Schema.Literals(["MessageTooLarge", "Unreachable", "ConnectionRefused", "PermissionDenied", "Unknown"]),
+  address: /*#__PURE__*/Schema.optional(Schema.InetAddress),
+  cause: /*#__PURE__*/Schema.Defect()
+}) {}
+/**
+ * The native socket closed underneath the reader, or the reader's scope
+ * closed.
+ *
+ * @stability experimental
+ * @category errors
+ * @since 4.0.0
+ */
+export class DatagramSocketClosedError extends /*#__PURE__*/Schema.Error("effect/socket/DatagramSocket/ClosedError")({
+  _tag: /*#__PURE__*/Schema.tag("DatagramSocketClosedError")
+}) {}
+/**
+ * The runtime lacks a capability, such as source-specific multicast on Deno.
+ *
+ * @stability experimental
+ * @category errors
+ * @since 4.0.0
+ */
+export class DatagramSocketUnsupportedError extends /*#__PURE__*/Schema.Error("effect/socket/DatagramSocket/UnsupportedError")({
+  _tag: /*#__PURE__*/Schema.tag("DatagramSocketUnsupportedError"),
+  capability: Schema.String,
+  runtime: Schema.String
+}) {
+  /**
+   * Names the runtime and the capability it lacks.
+   *
+   * @stability experimental
+   * @since 4.0.0
+   */
+  get message() {
+    return `${this.runtime} does not support ${this.capability}`;
+  }
+}
+/**
+ * Schema for the union of `DatagramSocketError` reasons.
+ *
+ * @stability experimental
+ * @category errors
+ * @since 4.0.0
+ */
+export const DatagramSocketErrorReason = /*#__PURE__*/Schema.Union([DatagramSocketOpenError, DatagramSocketReadError, DatagramSocketWriteError, DatagramSocketClosedError, DatagramSocketUnsupportedError]);
+/**
+ * Runtime type identifier attached to `DatagramSocketError` values.
+ *
+ * @stability experimental
+ * @category errors
+ * @since 4.0.0
+ */
+export const DatagramSocketErrorTypeId = "~effect/socket/DatagramSocket/DatagramSocketError";
+/**
+ * Returns `true` when a value is a `DatagramSocketError`.
+ *
+ * @stability experimental
+ * @category guards
+ * @since 4.0.0
+ */
+export const isDatagramSocketError = u => Predicate.hasProperty(u, DatagramSocketErrorTypeId);
+/**
+ * The error raised by `DatagramSocket` operations, wrapping a specific
+ * reason. Its `cause` and `message` come from the reason.
+ *
+ * @stability experimental
+ * @category errors
+ * @since 4.0.0
+ */
+export class DatagramSocketError extends /*#__PURE__*/Schema.TaggedError(DatagramSocketErrorTypeId)("DatagramSocketError", {
+  _tag: /*#__PURE__*/Schema.tag("DatagramSocketError"),
+  reason: DatagramSocketErrorReason
+}) {
+  // @effect-diagnostics-next-line overriddenSchemaConstructor:off
+  constructor(props) {
+    if ("cause" in props.reason) {
+      super({
+        ...props,
+        cause: props.reason.cause
+      });
+    } else {
+      super(props);
+    }
+  }
+  [DatagramSocketErrorTypeId] = DatagramSocketErrorTypeId;
+  get message() {
+    return this.reason.message;
+  }
+}
+/**
+ * Builds a `DatagramSocket` over a backing socket, opening a new socket for
+ * each reader acquisition.
+ *
+ * **Details**
+ *
+ * `open` receives the event callbacks before the handle exists, so packets can
+ * be queued while it opens. Core owns the receive queue and its overflow
+ * strategy, reader exclusivity, sticky errors, lazy address parsing, the
+ * writer latch and destination formatting. The handle is closed when the
+ * reader's scope closes. If acquisition is interrupted while `open` is still
+ * running, the interruption returns at once, `open` is left to finish, and
+ * the handle it produces is closed. The next reader waits until that open has
+ * settled, so two native sockets never exist at once. An adopted `acquire`
+ * must therefore finish in bounded time.
+ *
+ * `open` runs in the reader's scope, with the services of the fiber that
+ * built the socket, so an adopted `acquire` can use them and register
+ * finalizers that run when the reader closes. Where the fiber acquiring the
+ * reader has a service with the same tag, its own takes precedence.
+ *
+ * Concurrent pulls are served in the order they started waiting.
+ *
+ * `onError` receives errors with no write left to fail. It runs
+ * synchronously, and anything it throws is ignored.
+ *
+ * Invalid `receiveBuffer.capacity` values cause a defect; use a positive
+ * safe integer.
+ *
+ * @stability experimental
+ * @category constructors
+ * @since 4.0.0
+ */
+export const makeFromBackingSocket = (open, options) => withFiber(fiber => {
+  const capacity = options?.receiveBuffer?.capacity ?? 1024;
+  if (!Number.isSafeInteger(capacity) || capacity < 1) {
+    throw new RangeError(`DatagramSocket receive buffer capacity must be a positive integer, received ${capacity}`);
+  }
+  return Effect.succeed(makeFromBackingSocketWithContext(open, fiber.context, capacity, options?.receiveBuffer?.strategy === "sliding", options?.onError));
+});
+const makeFromBackingSocketWithContext = (open, services, capacity, sliding, onError) => {
+  const free = Latch.makeUnsafe(true);
+  const latch = Latch.makeUnsafe(false);
+  let current;
+  const abandon = (state, opening) => {
+    state.close();
+    // Release reader ownership only after the interrupted open settles.
+    opening.addObserver(exit => {
+      if (exit._tag === "Success") exit.value.close();
+      free.openUnsafe();
+    });
+  };
+  const release = state => {
+    state.close();
+    current = undefined;
+    latch.closeUnsafe();
+    free.openUnsafe();
+  };
+  const reader = Effect.uninterruptibleMask(Effect.fnUntraced(function* (restore) {
+    while (!free.closeUnsafe()) yield* restore(free.await);
+    const scope = yield* Effect.scope;
+    const state = new ReaderState(capacity, sliding, onError);
+    // Native opens may be uncancellable. Interrupt only the wait; `abandon`
+    // closes any socket returned later.
+    const opened = open(state.events).pipe(Effect.updateContext(input => Context.add(Context.merge(services, input), Scope.Scope, scope)));
+    const opening = yield* Effect.forkDetach(opened, {
+      startImmediately: true
+    });
+    state.handle = yield* restore(Fiber.join(opening)).pipe(Effect.onError(() => Effect.sync(() => abandon(state, opening))));
+    current = state;
+    latch.openUnsafe();
+    yield* Effect.addFinalizer(() => Effect.sync(() => release(state)));
+    return makeReader(state);
+  }));
+  const write = datagram => withFiber(fiber => {
+    const state = current;
+    return state === undefined ? latch.whenOpen(write(datagram)) : state.write(datagram, fiber);
+  });
+  const writeAll = datagrams => withFiber(fiber => {
+    const state = current;
+    return state === undefined ? latch.whenOpen(writeAll(datagrams)) : state.writeAll(datagrams, fiber);
+  });
+  const writer = Effect.succeed({
+    write,
+    writeAll
+  });
+  return make({
+    reader,
+    writer
+  });
+};
+const encoder = /*#__PURE__*/new TextEncoder();
+const encode = payload => typeof payload === "string" ? encoder.encode(payload) : payload;
+const emptyScopeIds = /*#__PURE__*/new Map();
+const closedError = () => new DatagramSocketError({
+  reason: new DatagramSocketClosedError()
+});
+// Rejected writes return this sentinel, avoiding per-packet error type checks.
+const rejected = {
+  host: "",
+  port: 0
+};
+class DatagramImpl {
+  payload;
+  host;
+  port;
+  owner;
+  #address;
+  constructor(payload, host, port, owner) {
+    this.payload = payload;
+    this.host = host;
+    this.port = port;
+    this.owner = owner;
+  }
+  get address() {
+    return this.#address ??= NetAddress.inetAddressFromNativeUnsafe(this.host, this.port, this.owner.scopeIds);
+  }
+  // only for a queued record, which no pull has returned yet
+  reuse(payload, host, port) {
+    this.payload = payload;
+    this.host = host;
+    this.port = port;
+    this.#address = undefined;
+  }
+}
+const targetOf = datagram => "host" in datagram ? datagram : datagram.address;
+class ReaderState {
+  capacity;
+  sliding;
+  listener;
+  events = {
+    onPacket: (payload, host, port) => this.push(payload, host, port),
+    onReadError: error => this.fail(error),
+    onError: error => this.report(error),
+    onClose: () => this.fail(closedError())
+  };
+  // set when `open` completes; packets can arrive before that
+  handle = undefined;
+  failure = undefined;
+  // separate from `failure`: after a sticky read error the socket is still
+  // open, so ICMP reports still reach `onError`
+  closed = false;
+  // Sliding overflow turns the full buffer into a ring, oldest at `head`.
+  buffer = [];
+  head = 0;
+  dropped = 0;
+  // A single consumer uses the first waiter slot without touching the array.
+  waiter = undefined;
+  waiters = [];
+  unpark = /*#__PURE__*/unpark(this);
+  bound = undefined;
+  // one-entry cache for `write` to the same explicit address
+  lastTarget = undefined;
+  lastDestination = undefined;
+  rejection = undefined;
+  constructor(capacity, sliding, listener) {
+    this.capacity = capacity;
+    this.sliding = sliding;
+    this.listener = listener;
+  }
+  push(payload, host, port) {
+    if (this.failure !== undefined) return;
+    if (this.buffer.length >= this.capacity) return this.overflow(payload, host, port);
+    const datagram = new DatagramImpl(payload, host, port, this);
+    if (this.waiter !== undefined) return this.wake(datagram);
+    const buffer = this.buffer;
+    buffer[buffer.length] = datagram;
+  }
+  wake(datagram) {
+    const fiber = this.waiter;
+    this.promoteWaiter();
+    fiber.evaluate(exitSucceed([datagram]));
+  }
+  overflow(payload, host, port) {
+    this.dropped++;
+    if (!this.sliding) return;
+    const buffer = this.buffer;
+    const head = this.head;
+    buffer[head].reuse(payload, host, port);
+    this.head = head + 1 === buffer.length ? 0 : head + 1;
+  }
+  take() {
+    const buffer = this.buffer;
+    const head = this.head;
+    this.buffer = [];
+    if (head === 0) return buffer;
+    this.head = 0;
+    const length = buffer.length;
+    const batch = new Array(length);
+    let j = 0;
+    for (let i = head; i < length; i++) batch[j++] = buffer[i];
+    for (let i = 0; i < head; i++) batch[j++] = buffer[i];
+    return batch;
+  }
+  park(fiber) {
+    if (this.waiter === undefined) this.waiter = fiber;else this.waiters.push(fiber);
+  }
+  promoteWaiter() {
+    this.waiter = this.waiters.length === 0 ? undefined : this.waiters.shift();
+  }
+  removeWaiter(fiber) {
+    if (this.waiter === fiber) return this.promoteWaiter();
+    if (this.waiters.length === 0) return;
+    const index = this.waiters.indexOf(fiber);
+    if (index !== -1) this.waiters.splice(index, 1);
+  }
+  failWaiters() {
+    const waiter = this.waiter;
+    if (waiter === undefined) return;
+    const failure = this.failure;
+    const waiters = this.waiters;
+    this.waiter = undefined;
+    this.waiters = [];
+    waiter.evaluate(failure);
+    for (let i = 0; i < waiters.length; i++) waiters[i].evaluate(failure);
+  }
+  fail(error) {
+    if (this.failure !== undefined) return;
+    this.failure = Effect.fail(error);
+    this.failWaiters();
+  }
+  close() {
+    this.closed = true;
+    this.buffer = [];
+    this.head = 0;
+    this.failure = Effect.fail(closedError());
+    this.failWaiters();
+    this.handle?.close();
+  }
+  report(error) {
+    const listener = this.listener;
+    if (listener === undefined || this.closed) return;
+    try {
+      listener(error);
+    } catch {
+      // Listener errors cannot fail native callbacks.
+    }
+  }
+  // packets can arrive before the handle does, so they read this lazily
+  get scopeIds() {
+    return this.handle?.scopeIds ?? emptyScopeIds;
+  }
+  get address() {
+    return this.bound ??= NetAddress.inetAddressFromNativeUnsafe(this.handle.address.host, this.handle.address.port, this.scopeIds);
+  }
+  // Synchronous sends avoid parking; async completions resume inline.
+  // Ignore completions after interruption.
+  write(datagram, fiber) {
+    if (this.failure !== undefined) return this.failure;
+    const target = targetOf(datagram);
+    const destination = this.destination(target);
+    if (destination === rejected) return Effect.fail(this.rejection);
+    const handle = this.handle;
+    const payload = encode(datagram.payload);
+    let result;
+    let parked = false;
+    handle.send(payload, destination, error => {
+      if (result !== undefined) return;
+      result = error === undefined ? Effect.void : Effect.fail(this.withAddress(error, target));
+      if (parked) fiber.evaluate(result);
+    });
+    if (result !== undefined) return result;
+    parked = true;
+    return fiber.yieldWith(() => {
+      parked = false;
+    });
+  }
+  writeAll(datagrams, fiber) {
+    if (this.failure !== undefined) return this.failure;
+    const payloads = new Array(datagrams.length);
+    const destinations = new Array(datagrams.length);
+    for (let i = 0; i < datagrams.length; i++) {
+      const datagram = datagrams[i];
+      const destination = this.destination(targetOf(datagram));
+      if (destination === rejected) return Effect.fail(this.rejection);
+      payloads[i] = encode(datagram.payload);
+      destinations[i] = destination;
+    }
+    let result;
+    let parked = false;
+    this.handle.sendMany(payloads, destinations, (error, index) => {
+      if (result !== undefined) return;
+      result = error === undefined ? Effect.void : Effect.fail(index === undefined ? error : this.withAddress(error, targetOf(datagrams[index])));
+      if (parked) fiber.evaluate(result);
+    });
+    if (result !== undefined) return result;
+    parked = true;
+    return fiber.yieldWith(() => {
+      parked = false;
+    });
+  }
+  // Returns `rejected` on failure, with the error stored in `rejection`.
+  destination(target) {
+    const handle = this.handle;
+    if (target === undefined) {
+      if (handle.connected) return undefined;
+      return handle.peer ?? this.reject("DatagramSocket write has no destination and the socket has no peer");
+    }
+    if (!("_tag" in target)) return handle.connected ? undefined : target;
+    if (handle.connected) return this.reject("an explicit address cannot be used on a connected DatagramSocket", target);
+    if (target === this.lastTarget) return this.lastDestination;
+    const destination = {
+      host: NetAddress.formatNativeHost(target, this.scopeIds),
+      port: target.port
+    };
+    this.lastTarget = target;
+    this.lastDestination = destination;
+    return destination;
+  }
+  reject(message, address) {
+    this.rejection = new DatagramSocketError({
+      reason: new DatagramSocketWriteError({
+        kind: "Unknown",
+        address,
+        cause: new Error(message)
+      })
+    });
+    return rejected;
+  }
+  withAddress(error, target) {
+    const reason = error.reason;
+    if (reason._tag !== "DatagramSocketWriteError" || reason.address !== undefined) return error;
+    const address = this.addressOf(target);
+    if (address === undefined) return error;
+    return new DatagramSocketError({
+      reason: new DatagramSocketWriteError({
+        kind: reason.kind,
+        address,
+        cause: reason.cause
+      })
+    });
+  }
+  addressOf(target) {
+    try {
+      if (target !== undefined) return "_tag" in target ? target : target.address;
+      const peer = this.handle.peer;
+      return peer === undefined ? undefined : NetAddress.inetAddressFromNativeUnsafe(peer.host, peer.port, this.scopeIds);
+    } catch {
+      // an unknown IPv6 zone leaves the address out
+      return undefined;
+    }
+  }
+}
+// Park the fiber itself and resume it inline, avoiding `Effect.callback` allocations.
+const makePull = state => withFiber(fiber => {
+  if (state.buffer.length !== 0) {
+    const batch = state.take();
+    const cont = fiber.getCont(contA);
+    return cont ? cont[contA](batch, fiber) : fiber.yieldWith(exitSucceed(batch));
+  }
+  if (state.failure !== undefined) return state.failure;
+  state.park(fiber);
+  fiber._stack.push(state.unpark);
+  return fiber.yieldWith(constVoid);
+});
+// `contAll` removes interrupted waiters too; after a wake, removal is a no-op.
+const unpark = /*#__PURE__*/makePrimitive({
+  op: "DatagramSocketUnpark",
+  [contAll](fiber) {
+    this[args].removeWaiter(fiber);
+  }
+});
+const makeReader = state => ({
+  pull: makePull(state),
+  get address() {
+    return state.address;
+  },
+  dropped: () => state.dropped,
+  joinMulticast: options => Effect.suspend(() => {
+    if (state.failure !== undefined) return state.failure;
+    return Effect.acquireRelease(state.handle.joinMulticast(options), leave => state.closed ? Effect.void : Effect.ignoreCause(leave()));
+  })
+});
+//# sourceMappingURL=DatagramSocket.js.map

package/dist/socket/DatagramSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatagramSocket.js","names":[],"sources":["../../src/socket/DatagramSocket.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/socket/Socket.d.ts

@@ -149,6 +149,12 @@ export interface Writer {
  * @since 4.0.0
  */
 export interface TlsUpgradeOptions {
+    /**
+     * DNS hostname used for Server Name Indication (SNI) and certificate identity
+     * verification during client upgrades. Server upgrades ignore this option.
+     * When omitted, the adapter retains its existing hostname behavior.
+     */
+    readonly servername?: string | undefined;
     readonly key?: Redacted.Redacted<string | Uint8Array> | ReadonlyArray<Redacted.Redacted<string | Uint8Array>> | undefined;
     readonly cert?: string | Uint8Array | ReadonlyArray<string | Uint8Array> | undefined;
     readonly ca?: string | Uint8Array | ReadonlyArray<string | Uint8Array> | undefined;
@@ -527,13 +533,18 @@ export interface WebSocketLike {
     send(data: string | Uint8Array<ArrayBuffer>): void;
 }
 /**
- * Common options understood by a WebSocket client implementation.
+ * Client options for Node and Bun WebSocket implementations, allowing
+ * handshake headers and subprotocols to be supplied together.
  *
  * @stability unstable
  * @category models
  * @since 4.0.0
  */
 export interface WebSocketClientOptions {
+    /**
+     * Subprotocols to offer in the opening handshake.
+     */
+    readonly protocols?: string | Array<string> | undefined;
     /**
      * Headers to include in the opening handshake.
      *
@@ -580,6 +591,7 @@ export declare class WebSocketConstructor extends WebSocketConstructor_base {
 }
 /**
  * Layer that provides `WebSocketConstructor` using `globalThis.WebSocket`.
+ * Rejects client options objects, including those with handshake headers.
  *
  * @stability unstable
  * @category layers
@@ -589,6 +601,8 @@ export declare const layerWebSocketConstructorGlobal: Layer.Layer<WebSocketConst
 /**
  * Creates a `Socket` backed by a `WebSocketConstructor`, dialing the
  * WebSocket for each reader acquisition.
+ * Optional handshake headers require a Node or Bun constructor; without
+ * headers, protocols are passed directly for browser compatibility.
  *
  * @stability unstable
  * @category constructors
@@ -597,6 +611,7 @@ export declare const layerWebSocketConstructorGlobal: Layer.Layer<WebSocketConst
 export declare const makeWebSocket: (url: string | Effect.Effect<string>, options?: {
     readonly openTimeout?: Duration.Input | undefined;
     readonly protocols?: string | Array<string> | undefined;
+    readonly headers?: Readonly<Record<string, string>> | undefined;
     readonly highWaterMark?: number | undefined;
 }) => Effect.Effect<Socket, never, WebSocketConstructor>;
 /**
@@ -625,6 +640,7 @@ export declare const fromWebSocket: <RO, WS extends WebSocketLike>(acquire: Effe
 /**
  * Creates a binary `Channel` backed by a WebSocket URL, requiring a
  * `WebSocketConstructor` service.
+ * Supports subprotocols and, with a Node or Bun constructor, handshake headers.
  *
  * @stability unstable
  * @category constructors
@@ -633,11 +649,13 @@ export declare const fromWebSocket: <RO, WS extends WebSocketLike>(acquire: Effe
 export declare const makeWebSocketChannel: <IE = never>(url: string, options?: {
     readonly openTimeout?: Duration.Input | undefined;
     readonly protocols?: string | Array<string> | undefined;
+    readonly headers?: Readonly<Record<string, string>> | undefined;
     readonly highWaterMark?: number | undefined;
 }) => Channel.Channel<NonEmptyReadonlyArray<Uint8Array>, SocketError | IE, void, NonEmptyReadonlyArray<Uint8Array | string | CloseEvent>, IE, unknown, WebSocketConstructor>;
 /**
  * Layer that provides a `Socket` service backed by a WebSocket URL or URL
  * effect.
+ * Supports subprotocols and, with a Node or Bun constructor, handshake headers.
  *
  * @stability unstable
  * @category layers
@@ -646,6 +664,7 @@ export declare const makeWebSocketChannel: <IE = never>(url: string, options?: {
 export declare const layerWebSocket: (url: string | Effect.Effect<string>, options?: {
     readonly openTimeout?: Duration.Input | undefined;
     readonly protocols?: string | Array<string> | undefined;
+    readonly headers?: Readonly<Record<string, string>> | undefined;
     readonly highWaterMark?: number | undefined;
 } | undefined) => Layer.Layer<Socket, never, WebSocketConstructor>;
 /**