@effect/platform-node-shared 4.0.0-beta.66 → 4.0.0-beta.67

package/dist/NodeSocket.d.ts

@@ -1,5 +1,19 @@
 /**
- * @since 1.0.0
+ * Shared Node socket constructors for adapting `node:net` connections and
+ * other Node `Duplex` streams to Effect's `Socket.Socket` interface.
+ *
+ * Use this module when building TCP clients, Unix domain socket clients, or
+ * higher-level protocols that already expose a Node `Duplex`. Connections are
+ * scoped, so finalizers close or destroy the underlying stream, open timeouts
+ * are reported as socket open errors, and Node read, write, and close events
+ * are translated into `SocketError` values.
+ *
+ * Node sockets have a few operational details worth keeping in mind: Unix
+ * socket paths are supplied through `NetConnectOpts.path`, writes complete only
+ * after Node accepts or flushes the chunk, and abnormal close events are
+ * surfaced as close errors while normal remote ends complete the socket run.
+ *
+ * @since 4.0.0
  */
 import type { Array } from "effect";
 import * as Channel from "effect/Channel";
@@ -12,39 +26,56 @@ import * as Socket from "effect/unstable/socket/Socket";
 import * as Net from "node:net";
 import type { Duplex } from "node:stream";
 /**
- * @since 1.0.0
  * @category re-exports
+ * @since 4.0.0
  */
 export * as NodeWS from "ws";
 declare const NetSocket_base: Context.ServiceClass<NetSocket, "@effect/platform-node/NodeSocket/NetSocket", Net.Socket>;
 /**
- * @since 1.0.0
+ * Service tag for the underlying Node `net.Socket` associated with the current
+ * socket connection.
+ *
  * @category tags
+ * @since 4.0.0
  */
 export declare class NetSocket extends NetSocket_base {
 }
 /**
- * @since 1.0.0
+ * Opens a TCP connection with Node `net.createConnection` and exposes it as a
+ * `Socket.Socket`, supporting `openTimeout` and closing or destroying the
+ * socket when the enclosing scope is finalized.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const makeNet: (options: Net.NetConnectOpts & {
     readonly openTimeout?: Duration.Input | undefined;
 }) => Effect.Effect<Socket.Socket>;
 /**
- * @since 1.0.0
+ * Adapts a Node `Duplex` into a `Socket.Socket`, wiring data events to socket
+ * handlers, providing a scoped writer, and mapping open, read, write, and close
+ * failures to `SocketError`.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const fromDuplex: <RO>(open: Effect.Effect<Duplex, Socket.SocketError, RO>, options?: {
     readonly openTimeout?: Duration.Input | undefined;
 }) => Effect.Effect<Socket.Socket, never, Exclude<RO, Scope.Scope>>;
 /**
- * @since 1.0.0
+ * Creates a `Channel` over a TCP socket, reading arrays of `Uint8Array`
+ * chunks and writing arrays of bytes, strings, or socket close events.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const makeNetChannel: <IE = never>(options: Net.NetConnectOpts) => Channel.Channel<Array.NonEmptyReadonlyArray<Uint8Array>, Socket.SocketError | IE, void, Array.NonEmptyReadonlyArray<Uint8Array | string | Socket.CloseEvent>, IE>;
 /**
- * @since 1.0.0
+ * Provides a `Socket.Socket` by opening a TCP connection with the supplied
+ * Node `net` connection options.
+ *
  * @category layers
+ * @since 4.0.0
  */
 export declare const layerNet: (options: Net.NetConnectOpts) => Layer.Layer<Socket.Socket, Socket.SocketError>;
 //# sourceMappingURL=NodeSocket.d.ts.map

package/dist/NodeSocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeSocket.d.ts","sourceRoot":"","sources":["../src/NodeSocket.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAA;AACvD,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,IAAI,CAAA;;AAE5B;;;GAGG;AACH,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ;;;GAGG;AACH,eAAO,MAAM,OAAO,GAClB,SAAS,GAAG,CAAC,cAAc,GAAG;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;CAClD,KACA,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAmC3B,CAAA;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,EAAE,EAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,EACnD,UAAU;IACR,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;CAClD,KACA,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CA4H3D,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,EAAE,GAAG,KAAK,EACvC,SAAS,GAAG,CAAC,cAAc,KAC1B,OAAO,CAAC,OAAO,CAChB,KAAK,CAAC,qBAAqB,CAAC,UAAU,CAAC,EACvC,MAAM,CAAC,WAAW,GAAG,EAAE,EACvB,IAAI,EACJ,KAAK,CAAC,qBAAqB,CAAC,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,EACpE,EAAE,CAID,CAAA;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,KAAK,KAAK,CAAC,KAAK,CACjE,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,WAAW,CACmC,CAAA"}
+{"version":3,"file":"NodeSocket.d.ts","sourceRoot":"","sources":["../src/NodeSocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAA;AACvD,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,IAAI,CAAA;;AAE5B;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAClB,SAAS,GAAG,CAAC,cAAc,GAAG;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;CAClD,KACA,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAmC3B,CAAA;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,EAAE,EAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,EACnD,UAAU;IACR,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;CAClD,KACA,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CA4H3D,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,EAAE,GAAG,KAAK,EACvC,SAAS,GAAG,CAAC,cAAc,KAC1B,OAAO,CAAC,OAAO,CAChB,KAAK,CAAC,qBAAqB,CAAC,UAAU,CAAC,EACvC,MAAM,CAAC,WAAW,GAAG,EAAE,EACvB,IAAI,EACJ,KAAK,CAAC,qBAAqB,CAAC,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,EACpE,EAAE,CAID,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,KAAK,KAAK,CAAC,KAAK,CACjE,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,WAAW,CACmC,CAAA"}

package/dist/NodeSocket.js

@@ -11,18 +11,25 @@ import * as Scope from "effect/Scope";
 import * as Socket from "effect/unstable/socket/Socket";
 import * as Net from "node:net";
 /**
- * @since 1.0.0
  * @category re-exports
+ * @since 4.0.0
  */
 export * as NodeWS from "ws";
 /**
- * @since 1.0.0
+ * Service tag for the underlying Node `net.Socket` associated with the current
+ * socket connection.
+ *
  * @category tags
+ * @since 4.0.0
  */
 export class NetSocket extends /*#__PURE__*/Context.Service()("@effect/platform-node/NodeSocket/NetSocket") {}
 /**
- * @since 1.0.0
+ * Opens a TCP connection with Node `net.createConnection` and exposes it as a
+ * `Socket.Socket`, supporting `openTimeout` and closing or destroying the
+ * socket when the enclosing scope is finalized.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const makeNet = options => fromDuplex(Effect.contextWith(context => {
   let conn;
@@ -52,8 +59,12 @@ export const makeNet = options => fromDuplex(Effect.contextWith(context => {
   }));
 }), options);
 /**
- * @since 1.0.0
+ * Adapts a Node `Duplex` into a `Socket.Socket`, wiring data events to socket
+ * handlers, providing a scoped writer, and mapping open, read, write, and close
+ * failures to `SocketError`.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const fromDuplex = (open, options) => Effect.withFiber(fiber => {
   let currentSocket;
@@ -141,13 +152,19 @@ export const fromDuplex = (open, options) => Effect.withFiber(fiber => {
   }));
 });
 /**
- * @since 1.0.0
+ * Creates a `Channel` over a TCP socket, reading arrays of `Uint8Array`
+ * chunks and writing arrays of bytes, strings, or socket close events.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const makeNetChannel = options => Channel.unwrap(Effect.map(makeNet(options), Socket.toChannelWith()));
 /**
- * @since 1.0.0
+ * Provides a `Socket.Socket` by opening a TCP connection with the supplied
+ * Node `net` connection options.
+ *
  * @category layers
+ * @since 4.0.0
  */
 export const layerNet = /*#__PURE__*/Function.flow(makeNet, /*#__PURE__*/Layer.effect(Socket.Socket));
 //# sourceMappingURL=NodeSocket.js.map

package/dist/NodeSocket.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeSocket.js","names":["Channel","Context","Deferred","Effect","FiberSet","Function","identity","Latch","Layer","Scope","Socket","Net","NodeWS","NetSocket","Service","makeNet","options","fromDuplex","contextWith","context","conn","flatMap","addFinalizer","get","sync","closed","destroySoon","destroy","callback","resume","createConnection","once","succeed","on","cause","fail","SocketError","reason","SocketOpenError","kind","open","withFiber","fiber","currentSocket","latch","makeUnsafe","openServices","run","handler","opts","scopedWith","fnUntraced","scope","fiberSet","make","pipe","provide","undefined","off","onData","onEnd","onError","onClose","openTimeout","timeoutOrElse","duration","orElse","Error","provideService","runtime","openUnsafe","onOpen","join","chunk","result","isEffect","doneUnsafe","deferred","void","SocketReadError","hadError","SocketCloseError","code","updateContext","input","merge","onExit","closeUnsafe","write","whenOpen","isCloseEvent","SocketWriteError","writer","acquireRelease","writableEnded","end","runRaw","makeNetChannel","unwrap","map","toChannelWith","layerNet","flow","effect"],"sources":["../src/NodeSocket.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"NodeSocket.js","names":["Channel","Context","Deferred","Effect","FiberSet","Function","identity","Latch","Layer","Scope","Socket","Net","NodeWS","NetSocket","Service","makeNet","options","fromDuplex","contextWith","context","conn","flatMap","addFinalizer","get","sync","closed","destroySoon","destroy","callback","resume","createConnection","once","succeed","on","cause","fail","SocketError","reason","SocketOpenError","kind","open","withFiber","fiber","currentSocket","latch","makeUnsafe","openServices","run","handler","opts","scopedWith","fnUntraced","scope","fiberSet","make","pipe","provide","undefined","off","onData","onEnd","onError","onClose","openTimeout","timeoutOrElse","duration","orElse","Error","provideService","runtime","openUnsafe","onOpen","join","chunk","result","isEffect","doneUnsafe","deferred","void","SocketReadError","hadError","SocketCloseError","code","updateContext","input","merge","onExit","closeUnsafe","write","whenOpen","isCloseEvent","SocketWriteError","writer","acquireRelease","writableEnded","end","runRaw","makeNetChannel","unwrap","map","toChannelWith","layerNet","flow","effect"],"sources":["../src/NodeSocket.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/NodeSocketServer.d.ts

@@ -10,32 +10,49 @@ import * as NodeSocket from "./NodeSocket.ts";
 import { NodeWS } from "./NodeSocket.ts";
 declare const IncomingMessage_base: Context.ServiceClass<IncomingMessage, "@effect/platform-node-shared/NodeSocketServer/IncomingMessage", Http.IncomingMessage>;
 /**
- * @since 1.0.0
+ * Service tag for the Node `IncomingMessage` associated with the current
+ * WebSocket server connection.
+ *
  * @category tags
+ * @since 4.0.0
  */
 export declare class IncomingMessage extends IncomingMessage_base {
 }
 /**
- * @since 1.0.0
+ * Creates a scoped TCP `SocketServer` from a Node `net.Server`, starts
+ * listening with the supplied options, queues pending connections until `run`
+ * is called, and closes the server when the scope ends.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const make: (options: Net.ServerOpts & Net.ListenOptions) => Effect.Effect<{
     readonly address: SocketServer.Address;
     readonly run: <R, E, _>(handler: (socket: Socket.Socket) => Effect.Effect<_, E, R>) => Effect.Effect<never, SocketServer.SocketServerError, R>;
 }, SocketServer.SocketServerError, Scope.Scope>;
 /**
- * @since 1.0.0
+ * Provides a TCP `SocketServer` by creating and managing a scoped Node
+ * `net.Server` with the supplied server and listen options.
+ *
  * @category layers
+ * @since 4.0.0
  */
 export declare const layer: (options: Net.ServerOpts & Net.ListenOptions) => Layer.Layer<SocketServer.SocketServer, SocketServer.SocketServerError>;
 /**
- * @since 1.0.0
+ * Creates a scoped WebSocket `SocketServer` backed by the `ws` package,
+ * providing the WebSocket and its Node `IncomingMessage` to connection
+ * handlers and closing the server when the scope ends.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const makeWebSocket: (options: NodeWS.ServerOptions<typeof NodeWS.WebSocket, typeof Http.IncomingMessage>) => Effect.Effect<SocketServer.SocketServer["Service"], SocketServer.SocketServerError, Scope.Scope>;
 /**
- * @since 1.0.0
+ * Provides a WebSocket `SocketServer` backed by the `ws` package and managed
+ * with the supplied server options.
+ *
  * @category layers
+ * @since 4.0.0
  */
 export declare const layerWebSocket: (options: NodeSocket.NodeWS.ServerOptions<typeof NodeSocket.NodeWS.WebSocket, typeof Http.IncomingMessage>) => Layer.Layer<SocketServer.SocketServer, SocketServer.SocketServerError>;
 export {};

package/dist/NodeSocketServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeSocketServer.d.ts","sourceRoot":"","sources":["../src/NodeSocketServer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAA;AACvD,OAAO,KAAK,YAAY,MAAM,qCAAqC,CAAA;AACnE,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;;AAExC;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,oBAG+B;CAAG;AAEvE;;;GAGG;AACH,eAAO,MAAM,IAAI;;;+CA6Gf,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,CAClB,OAAO,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,aAAa,KACxC,KAAK,CAAC,KAAK,CACd,YAAY,CAAC,YAAY,EACzB,YAAY,CAAC,iBAAiB,CACgC,CAAA;AAEhE;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,CAC1B,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC,eAAe,CAAC,KAChF,MAAM,CAAC,MAAM,CAChB,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,EACpC,YAAY,CAAC,iBAAiB,EAC9B,KAAK,CAAC,KAAK,CAyFX,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,CAC3B,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC,eAAe,CAAC,KACtG,KAAK,CAAC,KAAK,CACd,YAAY,CAAC,YAAY,EACzB,YAAY,CAAC,iBAAiB,CACyC,CAAA"}
+{"version":3,"file":"NodeSocketServer.d.ts","sourceRoot":"","sources":["../src/NodeSocketServer.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAA;AACvD,OAAO,KAAK,YAAY,MAAM,qCAAqC,CAAA;AACnE,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;;AAExC;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,oBAG+B;CAAG;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI;;;+CA6Gf,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAE,CAClB,OAAO,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,aAAa,KACxC,KAAK,CAAC,KAAK,CACd,YAAY,CAAC,YAAY,EACzB,YAAY,CAAC,iBAAiB,CACgC,CAAA;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,CAC1B,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC,eAAe,CAAC,KAChF,MAAM,CAAC,MAAM,CAChB,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,EACpC,YAAY,CAAC,iBAAiB,EAC9B,KAAK,CAAC,KAAK,CAyFX,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,CAC3B,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC,eAAe,CAAC,KACtG,KAAK,CAAC,KAAK,CACd,YAAY,CAAC,YAAY,EACzB,YAAY,CAAC,iBAAiB,CACyC,CAAA"}

package/dist/NodeSocketServer.js

@@ -14,13 +14,20 @@ import * as Net from "node:net";
 import * as NodeSocket from "./NodeSocket.js";
 import { NodeWS } from "./NodeSocket.js";
 /**
- * @since 1.0.0
+ * Service tag for the Node `IncomingMessage` associated with the current
+ * WebSocket server connection.
+ *
  * @category tags
+ * @since 4.0.0
  */
 export class IncomingMessage extends /*#__PURE__*/Context.Service()("@effect/platform-node-shared/NodeSocketServer/IncomingMessage") {}
 /**
- * @since 1.0.0
+ * Creates a scoped TCP `SocketServer` from a Node `net.Server`, starts
+ * listening with the supplied options, queues pending connections until `run`
+ * is called, and closes the server when the scope ends.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const make = /*#__PURE__*/Effect.fnUntraced(function* (options) {
   const errorDeferred = Deferred.makeUnsafe();
@@ -107,13 +114,20 @@ export const make = /*#__PURE__*/Effect.fnUntraced(function* (options) {
   });
 });
 /**
- * @since 1.0.0
+ * Provides a TCP `SocketServer` by creating and managing a scoped Node
+ * `net.Server` with the supplied server and listen options.
+ *
  * @category layers
+ * @since 4.0.0
  */
 export const layer = /*#__PURE__*/Function.flow(make, /*#__PURE__*/Layer.effect(SocketServer.SocketServer));
 /**
- * @since 1.0.0
+ * Creates a scoped WebSocket `SocketServer` backed by the `ws` package,
+ * providing the WebSocket and its Node `IncomingMessage` to connection
+ * handlers and closing the server when the scope ends.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const makeWebSocket = /*#__PURE__*/Effect.fnUntraced(function* (options) {
   const server = yield* Effect.acquireRelease(Effect.sync(() => new NodeWS.WebSocketServer(options)), server => Effect.callback(resume => {
@@ -178,8 +192,11 @@ export const makeWebSocket = /*#__PURE__*/Effect.fnUntraced(function* (options)
   });
 });
 /**
- * @since 1.0.0
+ * Provides a WebSocket `SocketServer` backed by the `ws` package and managed
+ * with the supplied server options.
+ *
  * @category layers
+ * @since 4.0.0
  */
 export const layerWebSocket = /*#__PURE__*/Function.flow(makeWebSocket, /*#__PURE__*/Layer.effect(SocketServer.SocketServer));
 const reportUnhandledError = cause => Effect.withFiber(fiber => {

package/dist/NodeSocketServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeSocketServer.js","names":["Context","Deferred","Effect","Exit","Fiber","pipe","Function","Layer","References","Scope","Socket","SocketServer","Net","NodeSocket","NodeWS","IncomingMessage","Service","make","fnUntraced","options","errorDeferred","makeUnsafe","pending","Set","defaultOnConnection","conn","add","remove","delete","on","onConnection","server","addFinalizer","callback","resume","close","void","createServer","err","doneUnsafe","fail","listen","raceFirst","mapError","await","SocketServerError","reason","SocketServerOpenError","cause","run","handler","scope","services","omit","context","trackFiber","runIn","prevOnConnection","error","fromDuplex","acquireRelease","suspend","SocketError","SocketOpenError","kind","closed","SocketCloseError","code","succeed","sync","destroySoon","flatMap","catchCause","reportUnhandledError","runForkWith","NetSocket","forEach","removeAllListeners","clear","_resume","address","of","_tag","path","hostname","port","layer","flow","effect","makeWebSocket","WebSocketServer","pendingConnections","defaultHandler","req","entry","addEventListener","once","map","Map","mapUnsafe","set","key","WebSocket","fromWebSocket","ensuring","layerWebSocket","withFiber","fiber","unhandledLogLevel","getRef","UnhandledLogLevel","logWithLevel"],"sources":["../src/NodeSocketServer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"NodeSocketServer.js","names":["Context","Deferred","Effect","Exit","Fiber","pipe","Function","Layer","References","Scope","Socket","SocketServer","Net","NodeSocket","NodeWS","IncomingMessage","Service","make","fnUntraced","options","errorDeferred","makeUnsafe","pending","Set","defaultOnConnection","conn","add","remove","delete","on","onConnection","server","addFinalizer","callback","resume","close","void","createServer","err","doneUnsafe","fail","listen","raceFirst","mapError","await","SocketServerError","reason","SocketServerOpenError","cause","run","handler","scope","services","omit","context","trackFiber","runIn","prevOnConnection","error","fromDuplex","acquireRelease","suspend","SocketError","SocketOpenError","kind","closed","SocketCloseError","code","succeed","sync","destroySoon","flatMap","catchCause","reportUnhandledError","runForkWith","NetSocket","forEach","removeAllListeners","clear","_resume","address","of","_tag","path","hostname","port","layer","flow","effect","makeWebSocket","WebSocketServer","pendingConnections","defaultHandler","req","entry","addEventListener","once","map","Map","mapUnsafe","set","key","WebSocket","fromWebSocket","ensuring","layerWebSocket","withFiber","fiber","unhandledLogLevel","getRef","UnhandledLogLevel","logWithLevel"],"sources":["../src/NodeSocketServer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/NodeStdio.d.ts

@@ -1,8 +1,12 @@
 import * as Layer from "effect/Layer";
 import * as Stdio from "effect/Stdio";
 /**
+ * Provides `Stdio` from `process.argv`, `process.stdin`, `process.stdout`,
+ * and `process.stderr`; stdin remains open and stdout/stderr are not ended by
+ * default.
+ *
  * @category Layers
- * @since 1.0.0
+ * @since 4.0.0
  */
 export declare const layer: Layer.Layer<Stdio.Stdio>;
 //# sourceMappingURL=NodeStdio.d.ts.map

package/dist/NodeStdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeStdio.d.ts","sourceRoot":"","sources":["../src/NodeStdio.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAIrC;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAwC1C,CAAA"}
+{"version":3,"file":"NodeStdio.d.ts","sourceRoot":"","sources":["../src/NodeStdio.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAIrC;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAwC1C,CAAA"}

package/dist/NodeStdio.js

@@ -1,5 +1,21 @@
 /**
- * @since 1.0.0
+ * Shared Node.js implementation of the Effect `Stdio` service.
+ *
+ * This module builds the `Stdio` layer used by Node platform packages by
+ * wiring the service to the current process: command-line arguments come from
+ * `process.argv`, input is read from `process.stdin`, and output and error
+ * output are written to `process.stdout` and `process.stderr`. It is intended
+ * for CLIs, scripts, command runners, test harnesses, and other
+ * process-oriented programs that need standard I/O through Effect services.
+ *
+ * The process stdio streams are global resources owned by Node. This layer
+ * leaves stdin open and does not end stdout or stderr by default, avoiding
+ * accidental closure of handles other code in the process may still use. Those
+ * streams may be pipes, files, or TTYs; interactive terminal behavior such as
+ * raw mode, echo, colors, and cursor movement should be coordinated with the
+ * terminal APIs instead of assuming this layer has exclusive control.
+ *
+ * @since 4.0.0
  */
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
@@ -8,8 +24,12 @@ import * as Stdio from "effect/Stdio";
 import { fromWritable } from "./NodeSink.js";
 import { fromReadable } from "./NodeStream.js";
 /**
+ * Provides `Stdio` from `process.argv`, `process.stdin`, `process.stdout`,
+ * and `process.stderr`; stdin remains open and stdout/stderr are not ended by
+ * default.
+ *
  * @category Layers
- * @since 1.0.0
+ * @since 4.0.0
  */
 export const layer = /*#__PURE__*/Layer.succeed(Stdio.Stdio, /*#__PURE__*/Stdio.make({
   args: /*#__PURE__*/Effect.sync(() => process.argv.slice(2)),

package/dist/NodeStdio.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeStdio.js","names":["Effect","Layer","systemError","Stdio","fromWritable","fromReadable","layer","succeed","make","args","sync","process","argv","slice","stdout","options","evaluate","onError","cause","module","method","_tag","endOnDone","stderr","stdin","closeOnDone"],"sources":["../src/NodeStdio.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,MAAM,MAAM,eAAe;AACvC,OAAO,KAAKC,KAAK,MAAM,cAAc;AACrC,SAASC,WAAW,QAAQ,sBAAsB;AAClD,OAAO,KAAKC,KAAK,MAAM,cAAc;AACrC,SAASC,YAAY,QAAQ,eAAe;AAC5C,SAASC,YAAY,QAAQ,iBAAiB;AAE9C;;;;AAIA,OAAO,MAAMC,KAAK,gBAA6BL,KAAK,CAACM,OAAO,CAC1DJ,KAAK,CAACA,KAAK,eACXA,KAAK,CAACK,IAAI,CAAC;EACTC,IAAI,eAAET,MAAM,CAACU,IAAI,CAAC,MAAMC,OAAO,CAACC,IAAI,CAACC,KAAK,CAAC,CAAC,CAAC,CAAC;EAC9CC,MAAM,EAAGC,OAAO,IACdX,YAAY,CAAC;IACXY,QAAQ,EAAEA,CAAA,KAAML,OAAO,CAACG,MAAM;IAC9BG,OAAO,EAAGC,KAAK,IACbhB,WAAW,CAAC;MACViB,MAAM,EAAE,OAAO;MACfC,MAAM,EAAE,QAAQ;MAChBC,IAAI,EAAE,SAAS;MACfH;KACD,CAAC;IACJI,SAAS,EAAEP,OAAO,EAAEO,SAAS,IAAI;GAClC,CAAC;EACJC,MAAM,EAAGR,OAAO,IACdX,YAAY,CAAC;IACXY,QAAQ,EAAEA,CAAA,KAAML,OAAO,CAACY,MAAM;IAC9BN,OAAO,EAAGC,KAAK,IACbhB,WAAW,CAAC;MACViB,MAAM,EAAE,OAAO;MACfC,MAAM,EAAE,QAAQ;MAChBC,IAAI,EAAE,SAAS;MACfH;KACD,CAAC;IACJI,SAAS,EAAEP,OAAO,EAAEO,SAAS,IAAI;GAClC,CAAC;EACJE,KAAK,eAAEnB,YAAY,CAAC;IAClBW,QAAQ,EAAEA,CAAA,KAAML,OAAO,CAACa,KAAK;IAC7BP,OAAO,EAAGC,KAAK,IACbhB,WAAW,CAAC;MACViB,MAAM,EAAE,OAAO;MACfC,MAAM,EAAE,OAAO;MACfC,IAAI,EAAE,SAAS;MACfH;KACD,CAAC;IACJO,WAAW,EAAE;GACd;CACF,CAAC,CACH","ignoreList":[]}
+{"version":3,"file":"NodeStdio.js","names":["Effect","Layer","systemError","Stdio","fromWritable","fromReadable","layer","succeed","make","args","sync","process","argv","slice","stdout","options","evaluate","onError","cause","module","method","_tag","endOnDone","stderr","stdin","closeOnDone"],"sources":["../src/NodeStdio.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;AAmBA,OAAO,KAAKA,MAAM,MAAM,eAAe;AACvC,OAAO,KAAKC,KAAK,MAAM,cAAc;AACrC,SAASC,WAAW,QAAQ,sBAAsB;AAClD,OAAO,KAAKC,KAAK,MAAM,cAAc;AACrC,SAASC,YAAY,QAAQ,eAAe;AAC5C,SAASC,YAAY,QAAQ,iBAAiB;AAE9C;;;;;;;;AAQA,OAAO,MAAMC,KAAK,gBAA6BL,KAAK,CAACM,OAAO,CAC1DJ,KAAK,CAACA,KAAK,eACXA,KAAK,CAACK,IAAI,CAAC;EACTC,IAAI,eAAET,MAAM,CAACU,IAAI,CAAC,MAAMC,OAAO,CAACC,IAAI,CAACC,KAAK,CAAC,CAAC,CAAC,CAAC;EAC9CC,MAAM,EAAGC,OAAO,IACdX,YAAY,CAAC;IACXY,QAAQ,EAAEA,CAAA,KAAML,OAAO,CAACG,MAAM;IAC9BG,OAAO,EAAGC,KAAK,IACbhB,WAAW,CAAC;MACViB,MAAM,EAAE,OAAO;MACfC,MAAM,EAAE,QAAQ;MAChBC,IAAI,EAAE,SAAS;MACfH;KACD,CAAC;IACJI,SAAS,EAAEP,OAAO,EAAEO,SAAS,IAAI;GAClC,CAAC;EACJC,MAAM,EAAGR,OAAO,IACdX,YAAY,CAAC;IACXY,QAAQ,EAAEA,CAAA,KAAML,OAAO,CAACY,MAAM;IAC9BN,OAAO,EAAGC,KAAK,IACbhB,WAAW,CAAC;MACViB,MAAM,EAAE,OAAO;MACfC,MAAM,EAAE,QAAQ;MAChBC,IAAI,EAAE,SAAS;MACfH;KACD,CAAC;IACJI,SAAS,EAAEP,OAAO,EAAEO,SAAS,IAAI;GAClC,CAAC;EACJE,KAAK,eAAEnB,YAAY,CAAC;IAClBW,QAAQ,EAAEA,CAAA,KAAML,OAAO,CAACa,KAAK;IAC7BP,OAAO,EAAGC,KAAK,IACbhB,WAAW,CAAC;MACViB,MAAM,EAAE,OAAO;MACfC,MAAM,EAAE,OAAO;MACfC,IAAI,EAAE,SAAS;MACfH;KACD,CAAC;IACJO,WAAW,EAAE;GACd;CACF,CAAC,CACH","ignoreList":[]}

package/dist/NodeStream.d.ts

@@ -1,5 +1,21 @@
 /**
- * @since 1.0.0
+ * Interoperability between Node streams and Effect streams and channels.
+ *
+ * This module adapts `Readable` and `Duplex` instances at the boundary with
+ * Node APIs: wrapping sources such as files, HTTP responses, child process
+ * output, and compression transforms as Effect `Stream`s or `Channel`s, piping
+ * Effect streams through Node duplex transforms, exposing an Effect `Stream`
+ * back to Node as a `Readable`, and collecting small readable payloads into
+ * strings or binary buffers.
+ *
+ * The adapters preserve the Node stream semantics that matter for production
+ * code. Writes wait for `drain` when a writable side applies backpressure,
+ * readable streams are destroyed on scope finalization by default, and stream
+ * failures are routed through `onError` or `Cause.UnknownError`. For long-lived
+ * or externally owned streams, pass `closeOnDone` or `endOnDone` carefully, and
+ * use `maxBytes` on collection helpers to avoid buffering unbounded input.
+ *
+ * @since 4.0.0
  */
 import * as Arr from "effect/Array";
 import * as Cause from "effect/Cause";
@@ -11,8 +27,12 @@ import * as Stream from "effect/Stream";
 import type { Duplex } from "node:stream";
 import { Readable } from "node:stream";
 /**
+ * Converts a Node readable stream into an Effect `Stream`, reading chunks with
+ * an optional chunk size, mapping stream errors with `onError`, and destroying
+ * the readable on completion unless `closeOnDone` is `false`.
+ *
  * @category constructors
- * @since 1.0.0
+ * @since 4.0.0
  */
 export declare const fromReadable: <A = Uint8Array, E = Cause.UnknownError>(options: {
     readonly evaluate: LazyArg<Readable | NodeJS.ReadableStream>;
@@ -22,8 +42,12 @@ export declare const fromReadable: <A = Uint8Array, E = Cause.UnknownError>(opti
     readonly closeOnDone?: boolean | undefined;
 }) => Stream.Stream<A, E>;
 /**
+ * Creates a `Channel` that pulls chunks from a Node readable stream, mapping
+ * errors with `onError` and destroying the readable on completion unless
+ * `closeOnDone` is `false`.
+ *
  * @category constructors
- * @since 1.0.0
+ * @since 4.0.0
  */
 export declare const fromReadableChannel: <A = Uint8Array, E = Cause.UnknownError>(options: {
     readonly evaluate: LazyArg<Readable | NodeJS.ReadableStream>;
@@ -32,8 +56,12 @@ export declare const fromReadableChannel: <A = Uint8Array, E = Cause.UnknownErro
     readonly closeOnDone?: boolean | undefined;
 }) => Channel.Channel<Arr.NonEmptyReadonlyArray<A>, E>;
 /**
+ * Creates a `Channel` over a Node `Duplex`, writing upstream chunks with
+ * backpressure while emitting chunks read from the duplex and optionally ending
+ * the writable side when upstream completes.
+ *
  * @category constructors
- * @since 1.0.0
+ * @since 4.0.0
  */
 export declare const fromDuplex: <IE, I = Uint8Array, O = Uint8Array, E = Cause.UnknownError>(options: {
     readonly evaluate: LazyArg<Duplex>;
@@ -44,13 +72,19 @@ export declare const fromDuplex: <IE, I = Uint8Array, O = Uint8Array, E = Cause.
     readonly encoding?: BufferEncoding | undefined;
 }) => Channel.Channel<Arr.NonEmptyReadonlyArray<O>, IE | E, void, Arr.NonEmptyReadonlyArray<I>, IE>;
 /**
+ * Pipes an Effect `Stream` through a Node `Duplex`, writing the stream's
+ * chunks to the duplex and emitting chunks read back from it.
+ *
  * @category combinators
- * @since 1.0.0
+ * @since 4.0.0
  */
 export declare const pipeThroughDuplex: {
     /**
+     * Pipes an Effect `Stream` through a Node `Duplex`, writing the stream's
+     * chunks to the duplex and emitting chunks read back from it.
+     *
      * @category combinators
-     * @since 1.0.0
+     * @since 4.0.0
      */
     <B = Uint8Array, E2 = Cause.UnknownError>(options: {
         readonly evaluate: LazyArg<Duplex>;
@@ -61,8 +95,11 @@ export declare const pipeThroughDuplex: {
         readonly encoding?: BufferEncoding | undefined;
     }): <R, E, A>(self: Stream.Stream<A, E, R>) => Stream.Stream<B, E2 | E, R>;
     /**
+     * Pipes an Effect `Stream` through a Node `Duplex`, writing the stream's
+     * chunks to the duplex and emitting chunks read back from it.
+     *
      * @category combinators
-     * @since 1.0.0
+     * @since 4.0.0
      */
     <R, E, A, B = Uint8Array, E2 = Cause.UnknownError>(self: Stream.Stream<A, E, R>, options: {
         readonly evaluate: LazyArg<Duplex>;
@@ -74,34 +111,54 @@ export declare const pipeThroughDuplex: {
     }): Stream.Stream<B, E | E2, R>;
 };
 /**
+ * Pipes a stream of strings or bytes through a Node `Duplex` using default
+ * options and `Cause.UnknownError` for stream failures.
+ *
  * @category combinators
- * @since 1.0.0
+ * @since 4.0.0
  */
 export declare const pipeThroughSimple: {
     /**
+     * Pipes a stream of strings or bytes through a Node `Duplex` using default
+     * options and `Cause.UnknownError` for stream failures.
+     *
      * @category combinators
-     * @since 1.0.0
+     * @since 4.0.0
      */
     (duplex: LazyArg<Duplex>): <R, E>(self: Stream.Stream<string | Uint8Array, E, R>) => Stream.Stream<Uint8Array, E | Cause.UnknownError, R>;
     /**
+     * Pipes a stream of strings or bytes through a Node `Duplex` using default
+     * options and `Cause.UnknownError` for stream failures.
+     *
      * @category combinators
-     * @since 1.0.0
+     * @since 4.0.0
      */
     <R, E>(self: Stream.Stream<string | Uint8Array, E, R>, duplex: LazyArg<Duplex>): Stream.Stream<Uint8Array, Cause.UnknownError | E, R>;
 };
 /**
- * @since 1.0.0
+ * Converts an Effect `Stream` into a Node `Readable`, using the caller's
+ * Effect context to run the stream and destroying the readable if the stream
+ * fails.
+ *
  * @category conversions
+ * @since 4.0.0
  */
 export declare const toReadable: <E, R>(stream: Stream.Stream<string | Uint8Array, E, R>) => Effect.Effect<Readable, never, R>;
 /**
- * @since 1.0.0
+ * Converts a service-free Effect `Stream` into a Node `Readable` using an
+ * empty Effect context.
+ *
  * @category conversions
+ * @since 4.0.0
  */
 export declare const toReadableNever: <E>(stream: Stream.Stream<string | Uint8Array, E, never>) => Readable;
 /**
- * @since 1.0.0
+ * Consumes a Node readable stream into a string using the selected encoding,
+ * failing through `onError` on stream errors or when `maxBytes` is exceeded
+ * and destroying the stream on interruption or failure.
+ *
  * @category conversions
+ * @since 4.0.0
  */
 export declare const toString: <E = Cause.UnknownError>(readable: LazyArg<Readable | NodeJS.ReadableStream>, options?: {
     readonly onError?: (error: unknown) => E;
@@ -109,16 +166,23 @@ export declare const toString: <E = Cause.UnknownError>(readable: LazyArg<Readab
     readonly maxBytes?: SizeInput | undefined;
 }) => Effect.Effect<string, E>;
 /**
- * @since 1.0.0
+ * Consumes a Node readable stream into an `ArrayBuffer`, failing through
+ * `onError` on stream errors or when `maxBytes` is exceeded and destroying the
+ * stream on interruption or failure.
+ *
  * @category conversions
+ * @since 4.0.0
  */
 export declare const toArrayBuffer: <E = Cause.UnknownError>(readable: LazyArg<Readable | NodeJS.ReadableStream>, options?: {
     readonly onError?: (error: unknown) => E;
     readonly maxBytes?: SizeInput | undefined;
 }) => Effect.Effect<ArrayBuffer, E>;
 /**
- * @since 1.0.0
+ * Consumes a Node readable stream into a `Uint8Array`, using the same error
+ * mapping and `maxBytes` handling as `toArrayBuffer`.
+ *
  * @category conversions
+ * @since 4.0.0
  */
 export declare const toUint8Array: <E = Cause.UnknownError>(readable: LazyArg<Readable | NodeJS.ReadableStream>, options?: {
     readonly onError?: (error: unknown) => E;