@smthrs/platform-node 1.0.0-rc.5 → 1.0.0-rc.6

package/dist/vendor/cjs/node-shared/NodeDns.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Node.js implementation of Effect's `Dns` service.
+ *
+ * Address lookups use the operating system resolver through `dns.lookup`,
+ * including the hosts file. Record queries and reverse lookups share one
+ * `dns.Resolver`. Interruption discards a query's result but cannot cancel
+ * that query; closing the scope cancels all pending queries.
+ *
+ * Unrepresentable records, such as invalid `Host.DomainName` values, are
+ * skipped. If every record is skipped, the query fails with `InvalidResponse`.
+ * `make` decodes Node.js's Latin-1 TXT and CAA strings as UTF-8. TLSA queries
+ * need Node.js 22.15 or 23.9 and later, and fail with `Unsupported` on runtimes
+ * without `resolveTlsa`. Other runtimes reuse `lookup`, `resolver`, and the
+ * conversion helpers to build their services.
+ *
+ * @stability experimental
+ * @since 4.0.0
+ */
+import * as Arr from "effect/Array";
+import * as Config from "effect/Config";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Dns from "effect/net/Dns";
+import * as Host from "effect/net/Host";
+import * as NetAddress from "effect/net/NetAddress";
+import * as Result from "effect/Result";
+/**
+ * Options for the Node.js `Dns` service and `resolver`.
+ *
+ * **Details**
+ *
+ * `nameServers` replaces the system name servers, which are converted like
+ * `Dns.nameServerFromInput`, and an empty list keeps the system name servers.
+ * `timeout` is the time allowed for each attempt and `tries` the number of
+ * attempts per name server. Address lookups always use the operating system
+ * resolver and are not affected.
+ *
+ * `timeout` is rounded up to whole milliseconds and `tries` down to a whole
+ * number, and both are clamped to 1 through 2^31 - 1, so `Duration.infinity`
+ * uses the longest timeout the resolver supports.
+ *
+ * **Gotchas**
+ *
+ * Invalid name servers fail with a `NetAddress.NetAddressError` when the
+ * service is created, and so do IPv6 name servers with a scope ID, such as
+ * link-local addresses, because the resolver drops the scope.
+ *
+ * @stability experimental
+ * @category models
+ * @since 4.0.0
+ */
+export interface Options {
+    readonly nameServers?: ReadonlyArray<NetAddress.IpAddressInput | NetAddress.InetAddressInput> | undefined;
+    readonly timeout?: Duration.Input | undefined;
+    readonly tries?: number | undefined;
+}
+/**
+ * Converts a failure of `node:dns` or of Bun's DNS functions to a
+ * `Dns.DnsError`, choosing the reason from the error's `code`.
+ *
+ * **Details**
+ *
+ * Bun prefixes c-ares codes with `DNS_`, such as `DNS_ENOTFOUND`; the prefix is
+ * ignored. Errors without a known code get the reason `Unknown`.
+ *
+ * @stability experimental
+ * @category converting
+ * @since 4.0.0
+ */
+export declare const dnsErrorFromCause: (cause: unknown, method: Dns.DnsError["method"], hostname: string, recordType?: Dns.RecordType) => Dns.DnsError;
+/**
+ * Converts a name returned by a resolver to a fully qualified
+ * `Host.DomainName`, throwing when it is not a valid domain name.
+ *
+ * @stability experimental
+ * @category converting
+ * @since 4.0.0
+ */
+export declare const domainNameFromResolverUnsafe: (name: string) => Host.DomainName;
+/**
+ * Converts a name returned by a resolver to fully qualified text, for names
+ * that need not be host names, such as PTR targets and SOA mailboxes.
+ *
+ * **Details**
+ *
+ * Resolvers write bytes as `\DDD` escapes, c-ares in decimal (`radix` 10) and
+ * `Deno.resolveDns` in octal (`radix` 8), and escape special characters with
+ * a backslash, such as `\.` for a dot inside a label or `\(` for a
+ * parenthesis. Decoding the bytes as UTF-8 and removing the escapes gives the
+ * text of the name, keeping only the `\.` and `\\` escapes.
+ *
+ * @stability experimental
+ * @category converting
+ * @since 4.0.0
+ */
+export declare const nameTextFromResolver: (name: string, radix?: 8 | 10) => string;
+/**
+ * Converts a number of seconds that a resolver reports as a signed 32-bit
+ * integer, such as the SOA refresh, retry, and expire intervals, to a
+ * `Duration`.
+ *
+ * @stability experimental
+ * @category converting
+ * @since 4.0.0
+ */
+export declare const secondsFromInt32: (value: number) => Duration.Duration;
+/**
+ * Decodes a string that holds one byte per character as UTF-8.
+ *
+ * **Details**
+ *
+ * Node.js and `Deno.resolveDns` decode each byte of TXT and CAA character
+ * strings as one Latin-1 character; decoding the bytes as UTF-8 matches other
+ * runtimes. Strings with only ASCII characters are returned unchanged.
+ *
+ * @stability experimental
+ * @category converting
+ * @since 4.0.0
+ */
+export declare const utf8FromLatin1: (value: string) => string;
+/**
+ * Converts the entries of a resolver's answer to a query for `name` to records
+ * of a record type, skipping entries whose data cannot be represented, such as
+ * names that are not valid `Host.DomainName` values.
+ *
+ * **Details**
+ *
+ * When the answer has entries but every one is skipped, the conversion fails
+ * with an `InvalidResponse` error whose cause is the first entry's failure,
+ * rather than returning no records, which would be reported as `NotFound`.
+ *
+ * @stability experimental
+ * @category converting
+ * @since 4.0.0
+ */
+export declare const recordsFromResolver: <T extends Dns.RecordType, A>(name: string, type: T, entries: ReadonlyArray<A>, fields: (entry: A) => Dns.RecordFields<T>) => Result.Result<Array<Dns.RecordFor<T>>, Dns.DnsError>;
+/**
+ * Converts an IP family to the numeric family used by `dns.lookup`, with `0`
+ * for addresses of either family.
+ *
+ * @stability experimental
+ * @category converting
+ * @since 4.0.0
+ */
+export declare const toFamily: (family: NetAddress.IpFamily | undefined) => 0 | 4 | 6;
+/**
+ * Converts the entries returned by an address lookup, such as `dns.lookup`
+ * with `all: true`, to IP addresses, keeping their order.
+ *
+ * **Details**
+ *
+ * IPv6 zones are dropped, and addresses that cannot be parsed are skipped.
+ *
+ * @stability experimental
+ * @category converting
+ * @since 4.0.0
+ */
+export declare const addressesFromLookup: (entries: ReadonlyArray<{
+    readonly address: string;
+}>) => Array<NetAddress.IpAddress>;
+/**
+ * Looks up the addresses of a host name with `dns.lookup`, keeping the order
+ * returned by the operating system resolver.
+ *
+ * @stability experimental
+ * @category resolving
+ * @since 4.0.0
+ */
+export declare const lookup: (host: string, family?: NetAddress.IpFamily | undefined) => Effect.Effect<Array<NetAddress.IpAddress>, Dns.DnsError>;
+/**
+ * Creates a function that queries DNS records with the runtime's `node:dns`
+ * module.
+ *
+ * **Details**
+ *
+ * All queries share one `dns.Resolver`, which is cancelled when the scope
+ * closes. Names in records are fully qualified, and TXT and CAA character
+ * strings are returned as the runtime decodes them, without the UTF-8
+ * correction that `make` applies for Node.js. Records are converted with
+ * `recordsFromResolver`.
+ *
+ * @stability experimental
+ * @category constructors
+ * @since 4.0.0
+ */
+export declare const resolver: (options?: Options | undefined) => Effect.Effect<(name: string, type: Dns.RecordType) => Effect.Effect<Array<Dns.DnsRecord>, Dns.DnsError>, NetAddress.NetAddressError, import("effect/Scope").Scope>;
+/**
+ * Creates a Node.js `Dns` service whose resolver lives as long as the scope.
+ *
+ * @stability experimental
+ * @category constructors
+ * @since 4.0.0
+ */
+export declare const make: (options?: Options | undefined) => Effect.Effect<{
+    lookup<F extends NetAddress.IpFamily>(host: Host.DomainNameInput, options: {
+        readonly family: F;
+    }): Effect.Effect<Arr.NonEmptyReadonlyArray<NetAddress.FamilyAddress<F>>, Dns.DnsError>;
+    lookup(host: Host.DomainNameInput, options?: Dns.LookupOptions): Effect.Effect<Arr.NonEmptyReadonlyArray<NetAddress.IpAddress>, Dns.DnsError>;
+    resolve<T extends Dns.RecordType>(name: Host.DomainNameInput, type: T): Effect.Effect<Arr.NonEmptyReadonlyArray<Dns.RecordFor<T>>, Dns.DnsError>;
+    reverse(address: NetAddress.IpAddressInput): Effect.Effect<Arr.NonEmptyReadonlyArray<Host.DomainName>, Dns.DnsError>;
+}, NetAddress.NetAddressError, import("effect/Scope").Scope>;
+/**
+ * Layer that provides the Node.js `Dns` service using the system resolver
+ * configuration.
+ *
+ * @stability experimental
+ * @category layers
+ * @since 4.0.0
+ */
+export declare const layer: Layer.Layer<Dns.Dns>;
+/**
+ * Creates a layer that provides the Node.js `Dns` service with options read
+ * from configuration.
+ *
+ * @stability experimental
+ * @category layers
+ * @since 4.0.0
+ */
+export declare const layerConfig: (options: Config.Wrap<Options>) => Layer.Layer<Dns.Dns, Config.ConfigError | NetAddress.NetAddressError>;
+//# sourceMappingURL=NodeDns.d.ts.map

package/dist/vendor/cjs/node-shared/NodeDns.js

@@ -0,0 +1 @@
+module.exports = require("../../node-shared/NodeDns.js")

package/dist/vendor/cjs/node-shared/NodeFileSystem.d.ts

@@ -4,6 +4,7 @@ import * as Layer from "effect/Layer";
  * Provides the `FileSystem` service backed by Node filesystem APIs, including
  * file operations, directory operations, links, metadata, and file watching.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */

package/dist/vendor/cjs/node-shared/NodeHttpCompression.d.ts

@@ -1,9 +1,10 @@
-import type * as Platform from "effect/unstable/http/HttpPlatform";
+import type * as Platform from "effect/http/HttpPlatform";
 import type { Duplex } from "node:stream";
 /**
  * The compression algorithms supported by the runtime's `node:zlib`. `zstd`
  * requires Node.js 22.15 or newer.
  *
+ * @stability unstable
  * @category constants
  * @since 4.0.0
  */
@@ -13,6 +14,7 @@ export declare const algorithms: ReadonlySet<Platform.CompressionAlgorithm>;
  * the asynchronous `node:zlib` APIs, setting the exact `Content-Length` of the
  * compressed body. All other bodies are delegated to `fallback`.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -21,6 +23,7 @@ export declare const make: (fallback: Platform.Compression) => Platform.Compress
  * Creates a `node:zlib` compression transform stream that flushes each input
  * chunk, for streaming response bodies.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -29,6 +32,7 @@ export declare const compressTransform: (algorithm: Platform.CompressionAlgorith
  * A Web `ReadableStream` version of `compressTransform`, for platforms that
  * stream response bodies as Web streams.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */

package/dist/vendor/cjs/node-shared/NodePath.d.ts

@@ -4,6 +4,7 @@ import { Path } from "effect/Path";
  * Provides the `Path` service using Node's POSIX path implementation plus
  * file URL conversion helpers.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */
@@ -12,6 +13,7 @@ export declare const layerPosix: Layer.Layer<Path>;
  * Provides the `Path` service using Node's Windows path implementation plus
  * file URL conversion helpers.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */
@@ -20,6 +22,7 @@ export declare const layerWin32: Layer.Layer<Path>;
  * Provides the default `Path` service using the host platform's Node path
  * implementation plus file URL conversion helpers.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */

package/dist/vendor/cjs/node-shared/NodeRuntime.d.ts

@@ -6,6 +6,7 @@
  * fiber, interrupts that fiber on `SIGINT` or `SIGTERM`, and delegates final
  * exit-code handling to the configured teardown.
  *
+ * @stability unstable
  * @since 4.0.0
  */
 import type { Effect } from "effect/Effect";
@@ -15,6 +16,7 @@ import * as Runtime from "effect/Runtime";
  * `SIGINT` or `SIGTERM` and invoking the configured teardown to determine the
  * process exit code.
  *
+ * @stability unstable
  * @category running
  * @since 4.0.0
  */
@@ -24,6 +26,7 @@ export declare const runMain: {
      * `SIGINT` or `SIGTERM` and invoking the configured teardown to determine the
      * process exit code.
      *
+     * @stability unstable
      * @category running
      * @since 4.0.0
      */
@@ -36,6 +39,7 @@ export declare const runMain: {
      * `SIGINT` or `SIGTERM` and invoking the configured teardown to determine the
      * process exit code.
      *
+     * @stability unstable
      * @category running
      * @since 4.0.0
      */

package/dist/vendor/cjs/node-shared/NodeSink.d.ts

@@ -7,6 +7,7 @@
  * the supplied `onError` function, and can end the writable when the upstream
  * data is done.
  *
+ * @stability unstable
  * @since 4.0.0
  */
 import type { NonEmptyReadonlyArray } from "effect/Array";
@@ -20,6 +21,7 @@ import type { Writable } from "node:stream";
  * backpressure, mapping writable errors with `onError`, and ending the stream
  * on completion unless `endOnDone` is `false`.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -34,6 +36,7 @@ export declare const fromWritable: <E, A = Uint8Array | string>(options: {
  * Node writable stream, respecting backpressure and optionally ending the
  * writable when upstream is done.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -56,6 +59,7 @@ export declare const fromWritableChannel: <IE, E, A = Uint8Array | string>(optio
  * The loop waits for `drain` when needed, fails on writable errors, and ends
  * the writable on upstream completion unless `endOnDone` is `false`.
  *
+ * @stability unstable
  * @category converting
  * @since 4.0.0
  */

package/dist/vendor/cjs/node-shared/NodeSocket.d.ts

@@ -6,6 +6,7 @@
  * channels, or layers. It also exposes the `NetSocket` service tag for the
  * underlying Node socket and re-exports the `ws` package namespace.
  *
+ * @stability unstable
  * @since 4.0.0
  */
 import * as Arr from "effect/Array";
@@ -15,11 +16,12 @@ import type * as Duration from "effect/Duration";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Scope from "effect/Scope";
-import * as Socket from "effect/unstable/socket/Socket";
+import * as Socket from "effect/socket/Socket";
 import * as Net from "node:net";
 import type { Duplex } from "node:stream";
 import * as Tls from "node:tls";
 /**
+ * @stability unstable
  * @category re-exports
  * @since 4.0.0
  */
@@ -29,6 +31,7 @@ declare const NetSocket_base: Context.ServiceClass<NetSocket, "@effect/platform-
  * Service tag for the underlying Node `net.Socket` associated with the current
  * socket connection.
  *
+ * @stability unstable
  * @category services
  * @since 4.0.0
  */
@@ -47,6 +50,7 @@ export declare class NetSocket extends NetSocket_base {
  * Supports `openTimeout` and closes or destroys the underlying socket when the
  * reader scope is finalized.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -70,6 +74,7 @@ export declare const makeNet: (options: Net.NetConnectOpts & {
  * the internal buffer is full. `writeAll` corks the stream around the batch.
  * Releasing the writer scope half-closes the stream (`end()`).
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -81,6 +86,7 @@ export declare const fromDuplex: <RO>(open: Effect.Effect<Duplex, Socket.SocketE
  * Creates a `Channel` over a TCP socket, reading arrays of `Uint8Array`
  * chunks and writing arrays of bytes, strings, or socket close events.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -89,6 +95,7 @@ export declare const makeNetChannel: <IE = never>(options: Net.NetConnectOpts) =
  * Provides a `Socket.Socket` by opening a TCP connection with the supplied
  * Node `net` connection options.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */
@@ -109,6 +116,7 @@ export declare const layerNet: (options: Net.NetConnectOpts) => Layer.Layer<Sock
  * certificate, fails with a `SocketOpenError`. Supports `openTimeout` and
  * destroys the underlying socket when the reader scope is finalized.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -119,6 +127,7 @@ export declare const makeTls: (options: Tls.ConnectionOptions & {
  * Creates a `Channel` over a TLS socket, reading arrays of `Uint8Array`
  * chunks and writing arrays of bytes, strings, or socket close events.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -127,6 +136,7 @@ export declare const makeTlsChannel: <IE = never>(options: Tls.ConnectionOptions
  * Provides a `Socket.Socket` by opening a TLS connection with the supplied
  * Node `tls` connection options.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */

package/dist/vendor/cjs/node-shared/NodeSocketServer.d.ts

@@ -2,7 +2,7 @@ import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Scope from "effect/Scope";
-import * as SocketServer from "effect/unstable/socket/SocketServer";
+import * as SocketServer from "effect/socket/SocketServer";
 import type * as Http from "node:http";
 import * as Net from "node:net";
 import * as Tls from "node:tls";
@@ -13,6 +13,7 @@ declare const IncomingMessage_base: Context.ServiceClass<IncomingMessage, "@effe
  * Service tag for the Node `IncomingMessage` associated with the current
  * WebSocket server connection.
  *
+ * @stability unstable
  * @category services
  * @since 4.0.0
  */
@@ -23,6 +24,7 @@ export declare class IncomingMessage extends IncomingMessage_base {
  * listening with the supplied options, queues pending connections until `run`
  * is called, and closes the server when the scope ends.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -31,6 +33,7 @@ export declare const make: (options: Net.ServerOpts & Net.ListenOptions) => Effe
  * Provides a TCP `SocketServer` by creating and managing a scoped Node
  * `net.Server` with the supplied server and listen options.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */
@@ -47,6 +50,7 @@ export declare const layer: (options: Net.ServerOpts & Net.ListenOptions) => Lay
  * also provided as `NodeSocket.NetSocket`. Connections that fail the handshake
  * are destroyed and the server keeps listening.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -55,6 +59,7 @@ export declare const makeTls: (options: Tls.TlsOptions & Net.ListenOptions) => E
  * Provides a TLS `SocketServer` by creating and managing a scoped Node
  * `tls.Server` with the supplied TLS and listen options.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */
@@ -64,6 +69,7 @@ export declare const layerTls: (options: Tls.TlsOptions & Net.ListenOptions) =>
  * providing the WebSocket and its Node `IncomingMessage` to connection
  * handlers and closing the server when the scope ends.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -72,6 +78,7 @@ export declare const makeWebSocket: (options: NodeWS.ServerOptions<typeof NodeWS
  * Provides a WebSocket `SocketServer` backed by the `ws` package and managed
  * with the supplied server options.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */

package/dist/vendor/cjs/node-shared/NodeStdio.d.ts

@@ -5,6 +5,7 @@ import * as Stdio from "effect/Stdio";
  * and `process.stderr`; stdin remains open and stdout/stderr are not ended by
  * default.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */

package/dist/vendor/cjs/node-shared/NodeStream.d.ts

@@ -7,6 +7,7 @@
  * `Readable`, and collects readable payloads into strings, array buffers, or
  * `Uint8Array`s with optional byte limits.
  *
+ * @stability unstable
  * @since 4.0.0
  */
 import * as Arr from "effect/Array";
@@ -23,6 +24,7 @@ import { Readable } from "node:stream";
  * an optional chunk size, mapping stream errors with `onError`, and destroying
  * the readable on completion unless `closeOnDone` is `false`.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -37,6 +39,7 @@ export declare const fromReadable: <A = Uint8Array, E = Cause.UnknownError>(opti
  * errors with `onError` and destroying the readable on completion unless
  * `closeOnDone` is `false`.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -51,6 +54,7 @@ export declare const fromReadableChannel: <A = Uint8Array, E = Cause.UnknownErro
  * backpressure while emitting chunks read from the duplex and optionally ending
  * the writable side when upstream completes.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
@@ -65,6 +69,7 @@ export declare const fromDuplex: <IE, I = Uint8Array, O = Uint8Array, E = Cause.
  * Pipes an Effect `Stream` through a Node `Duplex`, writing the stream's
  * chunks to the duplex and emitting chunks read back from it.
  *
+ * @stability unstable
  * @category combinators
  * @since 4.0.0
  */
@@ -73,6 +78,7 @@ 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.
      *
+     * @stability unstable
      * @category combinators
      * @since 4.0.0
      */
@@ -87,6 +93,7 @@ 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.
      *
+     * @stability unstable
      * @category combinators
      * @since 4.0.0
      */
@@ -102,6 +109,7 @@ export declare const pipeThroughDuplex: {
  * Pipes a stream of strings or bytes through a Node `Duplex` using default
  * options and `Cause.UnknownError` for stream failures.
  *
+ * @stability unstable
  * @category combinators
  * @since 4.0.0
  */
@@ -110,6 +118,7 @@ export declare const pipeThroughSimple: {
      * Pipes a stream of strings or bytes through a Node `Duplex` using default
      * options and `Cause.UnknownError` for stream failures.
      *
+     * @stability unstable
      * @category combinators
      * @since 4.0.0
      */
@@ -118,6 +127,7 @@ export declare const pipeThroughSimple: {
      * Pipes a stream of strings or bytes through a Node `Duplex` using default
      * options and `Cause.UnknownError` for stream failures.
      *
+     * @stability unstable
      * @category combinators
      * @since 4.0.0
      */
@@ -128,6 +138,7 @@ export declare const pipeThroughSimple: {
  * Effect context to run the stream and destroying the readable if the stream
  * fails.
  *
+ * @stability unstable
  * @category converting
  * @since 4.0.0
  */
@@ -136,6 +147,7 @@ export declare const toReadable: <E, R>(stream: Stream.Stream<string | Uint8Arra
  * Converts a service-free Effect `Stream` into a Node `Readable` using an
  * empty Effect context.
  *
+ * @stability unstable
  * @category converting
  * @since 4.0.0
  */
@@ -145,6 +157,7 @@ export declare const toReadableNever: <E>(stream: Stream.Stream<string | Uint8Ar
  * failing through `onError` on stream errors or when `maxBytes` is exceeded
  * and destroying the stream on interruption or failure.
  *
+ * @stability unstable
  * @category converting
  * @since 4.0.0
  */
@@ -158,6 +171,7 @@ export declare const toString: <E = Cause.UnknownError>(readable: LazyArg<Readab
  * `onError` on stream errors or when `maxBytes` is exceeded and destroying the
  * stream on interruption or failure.
  *
+ * @stability unstable
  * @category converting
  * @since 4.0.0
  */
@@ -169,6 +183,7 @@ export declare const toArrayBuffer: <E = Cause.UnknownError>(readable: LazyArg<R
  * Consumes a Node readable stream into a `Uint8Array`, using the same error
  * mapping and `maxBytes` handling as `toArrayBuffer`.
  *
+ * @stability unstable
  * @category converting
  * @since 4.0.0
  */

package/dist/vendor/cjs/node-shared/NodeTerminal.d.ts

@@ -3,18 +3,20 @@ import * as Layer from "effect/Layer";
 import type * as Scope from "effect/Scope";
 import * as Terminal from "effect/Terminal";
 /**
- * Creates a scoped process-backed `Terminal` using Node `readline`, enabling
- * TTY raw mode while in scope and using the supplied predicate to decide when
- * key input should end.
+ * Creates a scoped process-backed `Terminal` using Node `readline` and TTY raw mode.
+ * By default, Esc, Ctrl+C, and Ctrl+D end key input. Supply `shouldQuit` to
+ * override these quit keys.
  *
+ * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
 export declare const make: (shouldQuit?: (input: Terminal.UserInput) => boolean) => Effect.Effect<Terminal.Terminal, never, Scope.Scope>;
 /**
  * Provides the default process-backed `Terminal` service, ending key input on
- * Ctrl+C or Ctrl+D.
+ * bare Esc, Ctrl+C, or Ctrl+D.
  *
+ * @stability unstable
  * @category layers
  * @since 4.0.0
  */