UNPKG

the-moby-effect

Version:
704 lines 30.4 kB
/** * Demux utilities for different types of docker streams. * * @since 1.0.0 */ import type * as Array from "effect/Array"; import type * as Channel from "effect/Channel"; import type * as Effect from "effect/Effect"; import type * as Pipeable from "effect/Pipeable"; import type * as PlatformError from "effect/PlatformError"; import type * as Schema from "effect/Schema"; import type * as Scope from "effect/Scope"; import type * as Sink from "effect/Sink"; import type * as Stdio from "effect/Stdio"; import type * as Stream from "effect/Stream"; import type * as HttpClientResponse from "effect/unstable/http/HttpClientResponse"; import type * as Socket from "effect/unstable/socket/Socket"; /** * @since 1.0.0 * @category Types */ export declare const RawContentType: "application/vnd.docker.raw-stream"; /** * @since 1.0.0 * @category Types */ export declare const MultiplexedContentType: "application/vnd.docker.multiplexed-stream"; /** * The header type of a multiplexed message, indicating which stdio stream the * payload belongs to. * * @since 1.0.0 * @category Types */ export declare const MultiplexedHeaderType: { readonly Stdin: 0; readonly Stdout: 1; readonly Stderr: 2; }; /** * The header type of a multiplexed message, indicating which stdio stream the * payload belongs to. * * @since 1.0.0 * @category Types */ export type MultiplexedHeaderType = (typeof MultiplexedHeaderType)[keyof typeof MultiplexedHeaderType]; /** * @since 1.0.0 * @category Type ids */ export declare const RawSocketTypeId: unique symbol; /** * @since 1.0.0 * @category Type ids */ export type RawSocketTypeId = typeof RawSocketTypeId; /** * @since 1.0.0 * @category Type ids */ export declare const RawChannelTypeId: unique symbol; /** * @since 1.0.0 * @category Type ids */ export type RawChannelTypeId = typeof RawChannelTypeId; /** * @since 1.0.0 * @category Type ids */ export declare const MultiplexedSocketTypeId: unique symbol; /** * @since 1.0.0 * @category Type ids */ export type MultiplexedSocketTypeId = typeof MultiplexedSocketTypeId; /** * @since 1.0.0 * @category Type ids */ export declare const MultiplexedChannelTypeId: unique symbol; /** * @since 1.0.0 * @category Type ids */ export type MultiplexedChannelTypeId = typeof MultiplexedChannelTypeId; /** * When the TTY setting is enabled in POST /containers/create, the stream is not * multiplexed. The data exchanged over the hijacked connection is simply the * raw data from the process PTY and client's stdin. * * Note for Leo: This exists because the input error type "IE" might not be * known at the time of converting the Socket to a Channel. * * @since 1.0.0 * @category Branded Types */ export interface RawSocket extends Pipeable.Pipeable { readonly "content-type": typeof RawContentType; readonly [RawSocketTypeId]: typeof RawSocketTypeId; readonly underlying: Socket.Socket; } /** * When the TTY setting is enabled in POST /containers/create, the stream is not * multiplexed. The data exchanged over the hijacked connection is simply the * raw data from the process PTY and client's stdin. * * Note for Leo: This exists because there is no way to convert from a Channel * to a Socket. In fact, with my current effect knowledge, I believe it is * impossible to implement. This is still needed though for the pack and fan * implementations which seek to return these types. * * @since 1.0.0 * @category Branded Types */ export interface RawChannel<in IE = unknown, out OE = Socket.SocketError, out R = never> extends Pipeable.Pipeable { readonly "content-type": typeof RawContentType; readonly [RawChannelTypeId]: typeof RawChannelTypeId; readonly underlying: Channel.Channel<Array.NonEmptyReadonlyArray<Uint8Array>, OE, void, Array.NonEmptyReadonlyArray<string | Uint8Array | Socket.CloseEvent>, IE, unknown, R>; } /** * When the TTY setting is disabled in POST /containers/create, the HTTP * Content-Type header is set to application/vnd.docker.multiplexed-stream and * the stream over the hijacked connected is multiplexed to separate out stdout * and stderr. The stream consists of a series of frames, each containing a * header and a payload. * * Note for Leo: This exists because the input error type "IE" might not be * known at the time of converting the Socket to a Channel. * * @since 1.0.0 * @category Branded Types */ export interface MultiplexedSocket extends Pipeable.Pipeable { readonly "content-type": typeof MultiplexedContentType; readonly [MultiplexedSocketTypeId]: MultiplexedSocketTypeId; readonly underlying: Socket.Socket; } /** * When the TTY setting is disabled in POST /containers/create, the HTTP * Content-Type header is set to application/vnd.docker.multiplexed-stream and * the stream over the hijacked connected is multiplexed to separate out stdout * and stderr. The stream consists of a series of frames, each containing a * header and a payload. * * Note for Leo: This exists because there is no way to convert from a Channel * to a Socket. In fact, with my current effect knowledge, I believe it is * impossible to implement. This is still needed though for the pack and fan * implementations which seek to return these types. * * @since 1.0.0 * @category Branded Types */ export interface MultiplexedChannel<in IE = unknown, out OE = Socket.SocketError, out R = never> extends Pipeable.Pipeable { readonly "content-type": typeof MultiplexedContentType; readonly [MultiplexedChannelTypeId]: MultiplexedChannelTypeId; readonly underlying: Channel.Channel<Array.NonEmptyReadonlyArray<Uint8Array>, OE, void, Array.NonEmptyReadonlyArray<string | Uint8Array | Socket.CloseEvent>, IE, unknown, R>; } /** * @since 1.0.0 * @category Types */ export type EitherRawInput<IE, OE, R> = RawSocket | RawChannel<IE, OE, R>; /** * @since 1.0.0 * @category Types */ export type AnyRawInput = EitherRawInput<any, any, any>; /** * @since 1.0.0 * @category Types */ export type EitherMultiplexedInput<IE, OE, R> = MultiplexedSocket | MultiplexedChannel<IE, OE, R>; /** * @since 1.0.0 * @category Types */ export type AnyMultiplexedInput = EitherMultiplexedInput<any, any, any>; /** * @since 1.0.0 * @category Types */ export type HomogeneousStdioRawSocketInput = { stdin: RawSocket; stdout?: never; stderr?: never; } | { stdin?: never; stdout: RawSocket; stderr?: never; } | { stdin?: never; stdout?: never; stderr: RawSocket; } | { stdin: RawSocket; stdout: RawSocket; stderr?: never; } | { stdin: RawSocket; stdout?: never; stderr: RawSocket; } | { stdin?: never; stdout: RawSocket; stderr: RawSocket; } | { stdin: RawSocket; stdout: RawSocket; stderr: RawSocket; }; /** * @since 1.0.0 * @category Types */ export type HomogeneousStdioRawChannelInput<IE1, IE2, IE3, OE1, OE2, OE3, R1, R2, R3> = { stdin: RawChannel<IE1, OE1, R1>; stdout?: never; stderr?: never; } | { stdin?: never; stdout: RawChannel<IE2, OE2, R2>; stderr?: never; } | { stdin?: never; stdout?: never; stderr: RawChannel<IE3, OE3, R3>; } | { stdin: RawChannel<IE1, OE1, R1>; stdout: RawChannel<IE2, OE2, R2>; stderr?: never; } | { stdin: RawChannel<IE1, OE1, R1>; stdout?: never; stderr: RawChannel<IE3, OE3, R3>; } | { stdin?: never; stdout: RawChannel<IE2, OE2, R2>; stderr: RawChannel<IE3, OE3, R3>; } | { stdin: RawChannel<IE1, OE1, R1>; stdout: RawChannel<IE2, OE2, R2>; stderr: RawChannel<IE3, OE3, R3>; }; /** * @since 1.0.0 * @category Types */ export type HeterogeneousStdioRawInput<IE1, IE2, IE3, OE1, OE2, OE3, R1, R2, R3> = { stdin: EitherRawInput<IE1, OE1, R1>; stdout?: never; stderr?: never; } | { stdin?: never; stdout: EitherRawInput<IE2, OE2, R2>; stderr?: never; } | { stdin?: never; stdout?: never; stderr: EitherRawInput<IE3, OE3, R3>; } | { stdin: EitherRawInput<IE1, OE1, R1>; stdout: EitherRawInput<IE2, OE2, R2>; stderr?: never; } | { stdin: EitherRawInput<IE1, OE1, R1>; stdout?: never; stderr: EitherRawInput<IE3, OE3, R3>; } | { stdin?: never; stdout: EitherRawInput<IE2, OE2, R2>; stderr: EitherRawInput<IE3, OE3, R3>; } | { stdin: EitherRawInput<IE1, OE1, R1>; stdout: EitherRawInput<IE2, OE2, R2>; stderr: EitherRawInput<IE3, OE3, R3>; }; /** * @since 1.0.0 * @category Types */ export type HeterogeneousStdioTupledRawInput<A1, A2, L1, L2, E1, E2, E3, R1, R2, R3, IE1, IE2, IE3, OE1, OE2, OE3, R4, R5, R6> = { stdin: readonly [ Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, EitherRawInput<E1 | IE1, OE1, R4> ]; stdout?: never; stderr?: never; } | { stdin?: never; stdout: readonly [EitherRawInput<IE2, OE2, R5>, Sink.Sink<A1, string, L1, E2, R2>]; stderr?: never; } | { stdin?: never; stdout?: never; stderr: readonly [EitherRawInput<IE3, OE3, R6>, Sink.Sink<A2, string, L2, E3, R3>]; } | { stdin: readonly [ Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, EitherRawInput<E1 | IE1, OE1, R4> ]; stdout: readonly [EitherRawInput<IE2, OE2, R5>, Sink.Sink<A1, string, L1, E2, R2>]; stderr?: never; } | { stdin: readonly [ Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, EitherRawInput<E1 | IE1, OE1, R4> ]; stdout?: never; stderr: readonly [EitherRawInput<IE3, OE3, R6>, Sink.Sink<A2, string, L2, E3, R3>]; } | { stdin?: never; stdout: readonly [EitherRawInput<IE2, OE2, R5>, Sink.Sink<A1, string, L1, E2, R2>]; stderr: readonly [EitherRawInput<IE3, OE3, R6>, Sink.Sink<A2, string, L2, E3, R3>]; } | { stdin: readonly [ Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, EitherRawInput<E1 | IE1, OE1, R4> ]; stdout: readonly [EitherRawInput<IE2, OE2, R5>, Sink.Sink<A1, string, L1, E2, R2>]; stderr: readonly [EitherRawInput<IE3, OE3, R6>, Sink.Sink<A2, string, L2, E3, R3>]; }; /** * @since 1.0.0 * @category Types */ export type CompressedDemuxOutput<A1, A2> = A1 extends undefined | void ? A2 extends undefined | void ? void : readonly [stdout: undefined, stderr: A2] : A2 extends undefined | void ? readonly [stdout: A1, stderr: undefined] : readonly [stdout: A1, stderr: A2]; /** * @since 1.0.0 * @category Constructors */ export declare const makeRawSocket: (underlying: Socket.Socket) => RawSocket; /** * @since 1.0.0 * @category Constructors */ export declare const makeRawChannel: <IE = unknown, OE = Socket.SocketError, R = never>(underlying: Channel.Channel<Array.NonEmptyReadonlyArray<Uint8Array>, OE, void, Array.NonEmptyReadonlyArray<string | Uint8Array | Socket.CloseEvent>, IE, unknown, R>) => RawChannel<IE, IE | OE, R>; /** * @since 1.0.0 * @category Constructors */ export declare const makeMultiplexedSocket: (underlying: Socket.Socket) => MultiplexedSocket; /** * @since 1.0.0 * @category Constructors */ export declare const makeMultiplexedChannel: <IE = unknown, OE = Socket.SocketError, R = never>(underlying: Channel.Channel<Array.NonEmptyReadonlyArray<Uint8Array>, OE, void, Array.NonEmptyReadonlyArray<string | Uint8Array | Socket.CloseEvent>, IE, unknown, R>) => MultiplexedChannel<IE, IE | OE, R>; /** * @since 1.0.0 * @category Predicates */ export declare const isRawSocket: (u: unknown) => u is RawSocket; /** * @since 1.0.0 * @category Predicates */ export declare const isRawChannel: <IE = unknown, OE = Socket.SocketError, R = never>(u: unknown) => u is RawChannel<IE, IE | OE, R>; /** * @since 1.0.0 * @category Predicates */ export declare const isMultiplexedSocket: (u: unknown) => u is MultiplexedSocket; /** * @since 1.0.0 * @category Predicates */ export declare const isMultiplexedChannel: <IE = unknown, OE = Socket.SocketError, R = never>(u: unknown) => u is MultiplexedChannel<IE, IE | OE, R>; /** * @since 1.0.0 * @category Constructors */ export declare const rawNever: RawChannel<never, never, never>; /** * @since 1.0.0 * @category Constructors */ export declare const rawNeverWith: <IE>() => RawChannel<IE, IE, never>; /** * @since 1.0.0 * @category Constructors */ export declare const multiplexedNever: MultiplexedChannel<never, never, never>; /** * @since 1.0.0 * @category Constructors */ export declare const multiplexedNeverWith: <IE>() => MultiplexedChannel<IE, IE, never>; /** * @since 1.0.0 * @category Predicates */ export declare const responseIsRawResponse: (response: HttpClientResponse.HttpClientResponse) => boolean; /** * @since 1.0.0 * @category Predicates */ export declare const responseIsMultiplexedResponse: (response: HttpClientResponse.HttpClientResponse) => boolean; /** * Hijacks an http response into a socket. * * FIXME: this function relies on a hack to expose the underlying tcp socket * from the http client response. This will only work in NodeJs, not tested in * Bun/Deno yet, and will never work in the browser. * * @since 1.0.0 * @category Transformations */ export declare const hijackResponseUnsafe: (response: HttpClientResponse.HttpClientResponse) => Effect.Effect<Socket.Socket, Socket.SocketError, never>; /** * Transforms an http response into a multiplexed stream socket or a raw stream * socket. If the response is neither a multiplexed stream socket nor a raw or * can not be transformed, then an error will be returned. * * FIXME: this function relies on a hack to expose the underlying tcp socket * from the http client response. This will only work in NodeJs, not tested in * Bun/Deno yet, and will never work in the browser. * * @since 1.0.0 * @category Predicates */ export declare const responseToStreamingSocketOrFailUnsafe: (response: HttpClientResponse.HttpClientResponse) => Effect.Effect<RawSocket | MultiplexedSocket, Socket.SocketError, never>; /** * @since 1.0.0 * @category Conversions */ export declare const asRawChannel: <IE = never, OE = Socket.SocketError, R = never>(input: EitherRawInput<IE, OE, R>) => RawChannel<IE, OE, R>; /** * @since 1.0.0 * @category Conversions */ export declare const asMultiplexedChannel: <IE = never, OE = Socket.SocketError, R = never>(input: EitherMultiplexedInput<IE, OE, R>) => MultiplexedChannel<IE, OE, R>; /** * @since 1.0.0 * @category Conversions */ export declare const rawToStream: <IE = never, OE = Socket.SocketError, R = never>(input: EitherRawInput<IE, OE, R>) => Stream.Stream<Uint8Array, IE | OE, R>; /** * @since 1.0.0 * @category Conversions */ export declare const multiplexedToStream: <IE = never, OE = Socket.SocketError, R = never>(input: EitherMultiplexedInput<IE, OE, R>) => Stream.Stream<Uint8Array, IE | OE, R>; /** * @since 1.0.0 * @category Conversions */ export declare const rawToSink: <IE = never, OE = Socket.SocketError, R = never>(input: EitherRawInput<IE, OE, R>) => Sink.Sink<void, string | Uint8Array | Socket.CloseEvent, Uint8Array, IE | OE, R>; /** * @since 1.0.0 * @category Conversions */ export declare const multiplexedToSink: <IE = never, OE = Socket.SocketError, R = never>(input: EitherMultiplexedInput<IE, OE, R>) => Sink.Sink<void, string | Uint8Array | Socket.CloseEvent, Uint8Array, IE | OE, R>; /** * @since 1.0.0 * @category Conversions */ export declare const rawFromStreamWith: <IE>() => <E, R>(input: Stream.Stream<Uint8Array, IE | E, R>) => RawChannel<IE, IE | E, R>; /** * @since 1.0.0 * @category Conversions */ export declare const multiplexedFromStreamWith: <IE>() => <E, R>(input: Stream.Stream<Uint8Array, IE | E, R>) => MultiplexedChannel<IE, IE | E, R>; /** * @since 1.0.0 * @category Conversions */ export declare const rawFromStream: <E, R>(input: Stream.Stream<Uint8Array, E, R>) => RawChannel<never, E, R>; /** * @since 1.0.0 * @category Conversions */ export declare const multiplexedFromStream: <E, R>(input: Stream.Stream<Uint8Array, E, R>) => MultiplexedChannel<never, E, R>; /** * @since 1.0.0 * @category Conversions */ export declare const interleaveRaw: <IE1 = never, IE2 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, R1 = never, R2 = never>(stdout: EitherRawInput<IE1, OE1, R1>, stderr: EitherRawInput<IE2, OE2, R2>) => Stream.Stream<Uint8Array, IE1 | IE2 | OE1 | OE2, R1 | R2>; /** * @since 1.0.0 * @category Conversions */ export declare const mergeRawToTaggedStream: <IE1 = never, IE2 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, R1 = never, R2 = never>(stdout: EitherRawInput<IE1, OE1, R1>, stderr: EitherRawInput<IE2, OE2, R2>, options?: { bufferSize?: number | undefined; } | undefined) => Stream.Stream<{ _tag: "stdout"; value: Uint8Array; } | { _tag: "stderr"; value: Uint8Array; }, IE1 | IE2 | OE1 | OE2, R1 | R2>; /** * Demux a raw socket. When given a raw socket of the remote process's pty, * there is no way to differentiate between stdout and stderr so they are * combined on the same sink. * * @since 1.0.0 * @category Demux */ export declare const demuxRawToSingleSink: { <A1, L1, E1, E2, R1, R2>(source: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, sink: Sink.Sink<A1, string, L1, E2, R2>, options?: { encoding?: string | undefined; } | undefined): <IE = never, OE = Socket.SocketError, R3 = never>(socket: EitherRawInput<E1 | IE, OE, R3>) => Effect.Effect<A1, E1 | E2 | IE | OE, R1 | R2 | R3>; <A1, L1, E1, E2, R1, R2, IE = never, OE = Socket.SocketError, R3 = never>(socket: EitherRawInput<E1 | IE, OE, R3>, source: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, sink: Sink.Sink<A1, string, L1, E2, R2>, options?: { encoding?: string | undefined; } | undefined): Effect.Effect<A1, E1 | E2 | IE | OE, R1 | R2 | R3>; }; /** * Demux multiple raw sockets, created from multiple container attach requests. * If no options are provided for a given stream, it will be ignored. This is * really just an Effect.all wrapper around {@link demuxRawSingleSink}. * * To demux a single raw socket, you should use {@link demuxRawSingleSink} * * @since 1.0.0 * @category Demux */ export declare const demuxStdioRawTupled: <A1 = void, A2 = void, L1 = never, L2 = never, E1 = never, E2 = never, E3 = never, R1 = never, R2 = never, R3 = never, IE1 = never, IE2 = never, IE3 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, OE3 = Socket.SocketError, R4 = never, R5 = never, R6 = never>(sockets: HeterogeneousStdioTupledRawInput<A1, A2, L1, L2, E1, E2, E3, R1, R2, R3, IE1, IE2, IE3, OE1, OE2, OE3, R4, R5, R6>, options?: { encoding?: string | undefined; } | undefined) => Effect.Effect<CompressedDemuxOutput<A1, A2>, E1 | E2 | E3 | IE1 | IE2 | IE3 | OE1 | OE2 | OE3, R1 | R2 | R3 | R4 | R5 | R6>; /** * Demux multiple raw sockets, created from multiple container attach requests. * If no options are provided for a given stream, it will be ignored. This is * really just an Effect.all wrapper around {@link demuxRawSingleSink}. * * To demux a single raw socket, you should use {@link demuxRawSingleSink} * * @since 1.0.0 * @category Demux */ export declare const demuxStdioRawToSingleSink: { <A1, L1, E1, E2, R1, R2>(source: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, sink: Sink.Sink<A1, string, L1, E2, R2>, options?: { encoding?: string | undefined; } | undefined): <IE1 = never, IE2 = never, IE3 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, OE3 = Socket.SocketError, R3 = never, R4 = never, R5 = never>(sockets: HeterogeneousStdioRawInput<IE1 | E1, IE2, IE3, OE1, OE2, OE3, R3, R4, R5>) => Effect.Effect<A1, E1 | E2 | IE1 | IE2 | IE3 | OE1 | OE2 | OE3, R1 | R2 | R3 | R4 | R5>; <A1, L1, E1, E2, R1, R2, IE1 = never, IE2 = never, IE3 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, OE3 = Socket.SocketError, R3 = never, R4 = never, R5 = never>(sockets: HeterogeneousStdioRawInput<IE1 | E1, IE2, IE3, OE1, OE2, OE3, R3, R4, R5>, source: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, sink: Sink.Sink<A1, string, L1, E2, R2>, options?: { encoding?: string | undefined; } | undefined): Effect.Effect<A1, E1 | E2 | IE1 | IE2 | IE3 | OE1 | OE2 | OE3, R1 | R2 | R3 | R4 | R5>; }; /** * Demux multiple raw sockets, created from multiple container attach requests. * If no options are provided for a given stream, it will be ignored. This is * really just an Effect.all wrapper around {@link demuxRawSingleSink}. * * To demux a single raw socket, you should use {@link demuxRawSingleSink} * * @since 1.0.0 * @category Demux */ export declare const demuxStdioRawToSeparateSinks: { <A1, A2, L1, L2, E1, E2, E3, R1, R2, R3>(io: { stdin: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>; stdout: Sink.Sink<A1, string, L1, E2, R2>; stderr: Sink.Sink<A2, string, L2, E3, R3>; }, options?: { encoding?: string | undefined; } | undefined): <IE1 = never, IE2 = never, IE3 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, OE3 = Socket.SocketError, R4 = never, R5 = never, R6 = never>(sockets: HeterogeneousStdioRawInput<IE1 | E1, IE2, IE3, OE1, OE2, OE3, R4, R5, R6>) => Effect.Effect<CompressedDemuxOutput<A1, A2>, E1 | E2 | E3 | IE1 | IE2 | IE3 | OE1 | OE2 | OE3, R1 | R2 | R3 | R4 | R5 | R6>; <A1, A2, L1, L2, E1, E2, E3, R1, R2, R3, IE1 = never, IE2 = never, IE3 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, OE3 = Socket.SocketError, R4 = never, R5 = never, R6 = never>(sockets: HeterogeneousStdioRawInput<IE1 | E1, IE2, IE3, OE1, OE2, OE3, R4, R5, R6>, io: { stdin: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>; stdout: Sink.Sink<A1, string, L1, E2, R2>; stderr: Sink.Sink<A2, string, L2, E3, R3>; }, options?: { encoding?: string | undefined; } | undefined): Effect.Effect<CompressedDemuxOutput<A1, A2>, E1 | E2 | E3 | IE1 | IE2 | IE3 | OE1 | OE2 | OE3, R1 | R2 | R3 | R4 | R5 | R6>; }; /** * Demux a multiplexed socket, all output goes to a single sink. * * @since 1.0.0 * @category Demux */ export declare const demuxMultiplexedToSingleSink: { <A1, L1, E1, E2, R1, R2>(source: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, sink: Sink.Sink<A1, readonly [MultiplexedHeaderType, string], L1, E2, R2>, options?: { encoding?: string | undefined; } | undefined): <IE = never, OE = Socket.SocketError, R3 = never>(socket: EitherMultiplexedInput<E1 | IE, OE, R3>) => Effect.Effect<A1, E1 | E2 | IE | OE | Schema.SchemaError, R1 | R2 | R3>; <A1, L1, E1, E2, R1, R2, IE = never, OE = Socket.SocketError, R3 = never>(socket: EitherMultiplexedInput<E1 | IE, OE, R3>, source: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, sink: Sink.Sink<A1, readonly [MultiplexedHeaderType, string], L1, E2, R2>, options?: { encoding?: string | undefined; } | undefined): Effect.Effect<A1, E1 | E2 | IE | OE | Schema.SchemaError, R1 | R2 | R3>; }; /** * Demux a multiplexed socket. When given a multiplexed socket, we must parse * the chunks by headers and then forward each chunk based on its datatype to * the correct sink. * * When partitioning the stream into stdout and stderr, the first sink may * advance by up to bufferSize elements further than the slower one. The default * bufferSize is 16. * * @since 1.0.0 * @category Demux */ export declare const demuxMultiplexedToSeparateSinks: { <A1, A2, L1, L2, E1, E2, E3, R1, R2, R3>(source: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, sink1: Sink.Sink<A1, string, L1, E2, R2>, sink2: Sink.Sink<A2, string, L2, E3, R3>, options?: { bufferSize?: number | undefined; encoding?: string | undefined; } | undefined): <IE = never, OE = Socket.SocketError, R4 = never>(socket: EitherMultiplexedInput<E1 | IE, OE, R4>) => Effect.Effect<CompressedDemuxOutput<A1, A2>, E1 | E2 | E3 | IE | OE | Schema.SchemaError, Exclude<R1 | R2 | R3 | R4, Scope.Scope>>; <A1, A2, L1, L2, E1, E2, E3, R1, R2, R3, IE = never, OE = Socket.SocketError, R4 = never>(socket: EitherMultiplexedInput<E1 | IE, OE, R4>, source: Stream.Stream<string | Uint8Array | Socket.CloseEvent, E1, R1>, sink1: Sink.Sink<A1, string, L1, E2, R2>, sink2: Sink.Sink<A2, string, L2, E3, R3>, options?: { bufferSize?: number | undefined; encoding?: string | undefined; } | undefined): Effect.Effect<CompressedDemuxOutput<A1, A2>, E1 | E2 | E3 | IE | OE | Schema.SchemaError, Exclude<R1 | R2 | R3 | R4, Scope.Scope>>; }; /** * Demux either a raw socket or a multiplexed socket to a single sink. * * @since 1.0.0 * @category Demux */ export declare const demuxToSingleSink: { <A1, L1, E1, E2, R1, R2>(source: Stream.Stream<string | Uint8Array, E1, R1>, sink: Sink.Sink<A1, string, L1, E2, R2>, options?: { encoding?: string | undefined; } | undefined): <IE = never, OE = Socket.SocketError, R3 = never>(sockets: EitherRawInput<E1 | IE, OE, R3> | EitherMultiplexedInput<E1 | IE, OE, R3>) => Effect.Effect<A1, E1 | E2 | IE | OE | Schema.SchemaError, R1 | R2 | R3>; <A1, L1, E1, E2, R1, R2, IE = never, OE = Socket.SocketError, R3 = never>(sockets: EitherRawInput<E1 | IE, OE, R3> | EitherMultiplexedInput<E1 | IE, OE, R3>, source: Stream.Stream<string | Uint8Array, E1, R1>, sink: Sink.Sink<A1, string, L1, E2, R2>, options?: { encoding?: string | undefined; } | undefined): Effect.Effect<A1, E1 | E2 | IE | OE | Schema.SchemaError, R1 | R2 | R3>; }; /** * @since 1.0.0 * @category Packing */ export declare const pack: { <IE1 = never, IE2 = never, IE3 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, OE3 = Socket.SocketError, R1 = never, R2 = never, R3 = never>(options: { readonly requestedCapacity: number | { readonly stdinCapacity: number; readonly stdoutCapacity: number; readonly stderrCapacity: number; }; readonly encoding?: string | undefined; }): (stdio: HeterogeneousStdioRawInput<IE1, IE2, IE3, OE1, OE2, OE3, R1, R2, R3>) => Effect.Effect<MultiplexedChannel<IE1, IE1 | IE2 | IE3 | OE1 | OE2 | OE3, never>, never, R1 | R2 | R3 | Scope.Scope>; <IE1 = never, IE2 = never, IE3 = never, OE1 = Socket.SocketError, OE2 = Socket.SocketError, OE3 = Socket.SocketError, R1 = never, R2 = never, R3 = never>(stdio: HeterogeneousStdioRawInput<IE1, IE2, IE3, OE1, OE2, OE3, R1, R2, R3>, options: { readonly requestedCapacity: number | { readonly stdinCapacity: number; readonly stdoutCapacity: number; readonly stderrCapacity: number; }; readonly encoding?: string | undefined; }): Effect.Effect<MultiplexedChannel<IE1, IE1 | IE2 | IE3 | OE1 | OE2 | OE3, never>, never, R1 | R2 | R3 | Scope.Scope>; }; /** * @since 1.0.0 * @category Fanning */ export declare const fan: { <IE = never, OE = Socket.SocketError, R = never>(options: { readonly requestedCapacity: number | { readonly stdinCapacity: number; readonly stdoutCapacity: number; readonly stderrCapacity: number; }; readonly encoding?: string | undefined; }): (multiplexedInput: EitherMultiplexedInput<IE, OE, R>) => Effect.Effect<{ stdin: RawChannel<IE, IE | OE | Schema.SchemaError, never>; stdout: RawChannel<IE, IE | OE | Schema.SchemaError, never>; stderr: RawChannel<IE, IE | OE | Schema.SchemaError, never>; }, never, R | Scope.Scope>; <IE = never, OE = Socket.SocketError, R = never>(multiplexedInput: EitherMultiplexedInput<IE, OE, R>, options: { readonly requestedCapacity: number | { readonly stdinCapacity: number; readonly stdoutCapacity: number; readonly stderrCapacity: number; }; readonly encoding?: string | undefined; }): Effect.Effect<{ stdin: RawChannel<IE, IE | OE | Schema.SchemaError, never>; stdout: RawChannel<IE, IE | OE | Schema.SchemaError, never>; stderr: RawChannel<IE, IE | OE | Schema.SchemaError, never>; }, never, R | Scope.Scope>; }; /** * Demux either a raw stream socket or a multiplexed stream socket to the * console. If given a raw stream socket, then stdout and stderr will be * combined on the same sink. If given a multiplexed stream socket, then stdout * and stderr will be forwarded to different sinks. If given multiple raw stream * sockets, then you can provide different individual sockets for stdin, stdout, * and stderr. * * If you are looking for a way to demux to stdin, stdout, and stderr instead of * the console then see {@link demuxSocketFromStdinToStdoutAndStderr}. * * @since 1.0.0 * @category DemuxStdio */ export declare const demuxWithInputToConsole: <E, R1, IE = never, OE = Socket.SocketError, R2 = never>(sockets: EitherMultiplexedInput<E | IE, OE, R2>, input: Stream.Stream<string | Uint8Array, E, R1>, options?: { bufferSize?: number | undefined; encoding?: string | undefined; } | undefined) => Effect.Effect<void, E | IE | OE | Schema.SchemaError, Exclude<R1 | R2, Scope.Scope>>; /** * Demux either a raw stream socket or a multiplexed stream socket from stdin to * stdout and stderr. If given a raw stream socket, then stdout and stderr will * be combined on the same sink. If given a multiplexed stream socket, then * stdout and stderr will be forwarded to different sinks. If given multiple raw * stream sockets, then you can provide different individual sockets for stdin, * stdout, and stderr. * * If you are looking for a way to demux to the console instead of stdin, * stdout, and stderr then see {@link demuxSocketWithInputToConsole}. Since we * are interacting with stdin, stdout, and stderr this function dynamically * imports the `@effect/platform-node` package. * * @since 1.0.0 * @category DemuxStdio */ export declare const demuxFromStdinToStdoutAndStderr: <IE = never, OE = Socket.SocketError, R = never>(sockets: EitherMultiplexedInput<IE, OE, R>, options?: { bufferSize?: number | undefined; encoding?: string | undefined; } | undefined) => Effect.Effect<void, IE | OE | PlatformError.PlatformError | Schema.SchemaError, Exclude<R, Scope.Scope> | Stdio.Stdio>; //# sourceMappingURL=MobyDemux.d.ts.map