import type * as MobyConnection from "../../MobyConnection.js"; import * as Path from "@effect/platform/Path"; import * as ConfigError from "effect/ConfigError"; import * as Data from "effect/Data"; import * as Effect from "effect/Effect"; /** * Connection options for how to connect to your moby/docker instance. Can be a * unix socket on the current machine. Can be an ssh connection to a remote * machine with a remote user, remote machine, remote port, and remote socket * path. Can be an http connection to a remote machine with a host, port, and * path. Or it can be an https connection to a remote machine with a host, port, * path, cert, ca, key, and passphrase. * * @since 1.0.0 * @category Connection Types */ export declare const MobyConnectionOptions: { readonly socket: Data.Case.Constructor<{ readonly _tag: "socket"; readonly socketPath: string; readonly version?: string | undefined | undefined; }, "_tag">; readonly ssh: Data.Case.Constructor<{ readonly _tag: "ssh"; readonly remoteSocketPath: string; readonly host: string; readonly version?: string | undefined | undefined; readonly port?: number; readonly forceIPv4?: boolean; readonly forceIPv6?: boolean; readonly hostHash?: string; readonly hostVerifier?: import("ssh2").HostVerifier | import("ssh2").SyncHostVerifier | import("ssh2").HostFingerprintVerifier | import("ssh2").SyncHostFingerprintVerifier; readonly username?: string; readonly password?: string; readonly agent?: import("ssh2").BaseAgent | string; readonly privateKey?: Buffer | string; readonly passphrase?: Buffer | string; readonly localHostname?: string; readonly localUsername?: string; readonly tryKeyboard?: boolean; readonly keepaliveInterval?: number; readonly keepaliveCountMax?: number; readonly readyTimeout?: number; readonly strictVendor?: boolean; readonly sock?: import("stream").Readable; readonly agentForward?: boolean; readonly algorithms?: import("ssh2").Algorithms; readonly debug?: import("ssh2").DebugFunction; readonly authHandler?: import("ssh2").AuthenticationType[] | import("ssh2").AuthHandlerMiddleware | import("ssh2").AuthMethod[]; readonly localAddress?: string; readonly localPort?: number; readonly timeout?: number; readonly ident?: Buffer | string; }, "_tag">; readonly http: Data.Case.Constructor<{ readonly _tag: "http"; readonly host: string; readonly port: number; readonly path?: string | undefined | undefined; readonly version?: string | undefined | undefined; }, "_tag">; readonly https: Data.Case.Constructor<{ readonly _tag: "https"; readonly host: string; readonly port: number; readonly version?: string | undefined | undefined; readonly path?: string | undefined | undefined; readonly cert?: string | undefined | undefined; readonly ca?: string | undefined | undefined; readonly key?: string | undefined | undefined; readonly passphrase?: string | undefined | undefined; }, "_tag">; readonly $is: (tag: Tag) => (u: unknown) => u is Extract<{ readonly _tag: "socket"; readonly socketPath: string; readonly version?: string | undefined | undefined; }, { readonly _tag: Tag; }> | Extract<{ readonly _tag: "ssh"; readonly remoteSocketPath: string; readonly host: string; readonly version?: string | undefined | undefined; readonly port?: number; readonly forceIPv4?: boolean; readonly forceIPv6?: boolean; readonly hostHash?: string; readonly hostVerifier?: import("ssh2").HostVerifier | import("ssh2").SyncHostVerifier | import("ssh2").HostFingerprintVerifier | import("ssh2").SyncHostFingerprintVerifier; readonly username?: string; readonly password?: string; readonly agent?: import("ssh2").BaseAgent | string; readonly privateKey?: Buffer | string; readonly passphrase?: Buffer | string; readonly localHostname?: string; readonly localUsername?: string; readonly tryKeyboard?: boolean; readonly keepaliveInterval?: number; readonly keepaliveCountMax?: number; readonly readyTimeout?: number; readonly strictVendor?: boolean; readonly sock?: import("stream").Readable; readonly agentForward?: boolean; readonly algorithms?: import("ssh2").Algorithms; readonly debug?: import("ssh2").DebugFunction; readonly authHandler?: import("ssh2").AuthenticationType[] | import("ssh2").AuthHandlerMiddleware | import("ssh2").AuthMethod[]; readonly localAddress?: string; readonly localPort?: number; readonly timeout?: number; readonly ident?: Buffer | string; }, { readonly _tag: Tag; }> | Extract<{ readonly _tag: "http"; readonly host: string; readonly port: number; readonly path?: string | undefined | undefined; readonly version?: string | undefined | undefined; }, { readonly _tag: Tag; }> | Extract<{ readonly _tag: "https"; readonly host: string; readonly port: number; readonly version?: string | undefined | undefined; readonly path?: string | undefined | undefined; readonly cert?: string | undefined | undefined; readonly ca?: string | undefined | undefined; readonly key?: string | undefined | undefined; readonly passphrase?: string | undefined | undefined; }, { readonly _tag: Tag; }>; readonly $match: { any; readonly ssh: (args: { readonly _tag: "ssh"; readonly remoteSocketPath: string; readonly host: string; readonly version?: string | undefined | undefined; readonly port?: number; readonly forceIPv4?: boolean; readonly forceIPv6?: boolean; readonly hostHash?: string; readonly hostVerifier?: import("ssh2").HostVerifier | import("ssh2").SyncHostVerifier | import("ssh2").HostFingerprintVerifier | import("ssh2").SyncHostFingerprintVerifier; readonly username?: string; readonly password?: string; readonly agent?: import("ssh2").BaseAgent | string; readonly privateKey?: Buffer | string; readonly passphrase?: Buffer | string; readonly localHostname?: string; readonly localUsername?: string; readonly tryKeyboard?: boolean; readonly keepaliveInterval?: number; readonly keepaliveCountMax?: number; readonly readyTimeout?: number; readonly strictVendor?: boolean; readonly sock?: import("stream").Readable; readonly agentForward?: boolean; readonly algorithms?: import("ssh2").Algorithms; readonly debug?: import("ssh2").DebugFunction; readonly authHandler?: import("ssh2").AuthenticationType[] | import("ssh2").AuthHandlerMiddleware | import("ssh2").AuthMethod[]; readonly localAddress?: string; readonly localPort?: number; readonly timeout?: number; readonly ident?: Buffer | string; }) => any; readonly http: (args: { readonly _tag: "http"; readonly host: string; readonly port: number; readonly path?: string | undefined | undefined; readonly version?: string | undefined | undefined; }) => any; readonly https: (args: { readonly _tag: "https"; readonly host: string; readonly port: number; readonly version?: string | undefined | undefined; readonly path?: string | undefined | undefined; readonly cert?: string | undefined | undefined; readonly ca?: string | undefined | undefined; readonly key?: string | undefined | undefined; readonly passphrase?: string | undefined | undefined; }) => any; }>(cases: Cases & { [K in Exclude]: never; }): (value: { readonly _tag: "socket"; readonly socketPath: string; readonly version?: string | undefined | undefined; } | { readonly _tag: "ssh"; readonly remoteSocketPath: string; readonly host: string; readonly version?: string | undefined | undefined; readonly port?: number; readonly forceIPv4?: boolean; readonly forceIPv6?: boolean; readonly hostHash?: string; readonly hostVerifier?: import("ssh2").HostVerifier | import("ssh2").SyncHostVerifier | import("ssh2").HostFingerprintVerifier | import("ssh2").SyncHostFingerprintVerifier; readonly username?: string; readonly password?: string; readonly agent?: import("ssh2").BaseAgent | string; readonly privateKey?: Buffer | string; readonly passphrase?: Buffer | string; readonly localHostname?: string; readonly localUsername?: string; readonly tryKeyboard?: boolean; readonly keepaliveInterval?: number; readonly keepaliveCountMax?: number; readonly readyTimeout?: number; readonly strictVendor?: boolean; readonly sock?: import("stream").Readable; readonly agentForward?: boolean; readonly algorithms?: import("ssh2").Algorithms; readonly debug?: import("ssh2").DebugFunction; readonly authHandler?: import("ssh2").AuthenticationType[] | import("ssh2").AuthHandlerMiddleware | import("ssh2").AuthMethod[]; readonly localAddress?: string; readonly localPort?: number; readonly timeout?: number; readonly ident?: Buffer | string; } | { readonly _tag: "http"; readonly host: string; readonly port: number; readonly path?: string | undefined | undefined; readonly version?: string | undefined | undefined; } | { readonly _tag: "https"; readonly host: string; readonly port: number; readonly version?: string | undefined | undefined; readonly path?: string | undefined | undefined; readonly cert?: string | undefined | undefined; readonly ca?: string | undefined | undefined; readonly key?: string | undefined | undefined; readonly passphrase?: string | undefined | undefined; }) => import("effect/Unify").Unify>; any; readonly ssh: (args: { readonly _tag: "ssh"; readonly remoteSocketPath: string; readonly host: string; readonly version?: string | undefined | undefined; readonly port?: number; readonly forceIPv4?: boolean; readonly forceIPv6?: boolean; readonly hostHash?: string; readonly hostVerifier?: import("ssh2").HostVerifier | import("ssh2").SyncHostVerifier | import("ssh2").HostFingerprintVerifier | import("ssh2").SyncHostFingerprintVerifier; readonly username?: string; readonly password?: string; readonly agent?: import("ssh2").BaseAgent | string; readonly privateKey?: Buffer | string; readonly passphrase?: Buffer | string; readonly localHostname?: string; readonly localUsername?: string; readonly tryKeyboard?: boolean; readonly keepaliveInterval?: number; readonly keepaliveCountMax?: number; readonly readyTimeout?: number; readonly strictVendor?: boolean; readonly sock?: import("stream").Readable; readonly agentForward?: boolean; readonly algorithms?: import("ssh2").Algorithms; readonly debug?: import("ssh2").DebugFunction; readonly authHandler?: import("ssh2").AuthenticationType[] | import("ssh2").AuthHandlerMiddleware | import("ssh2").AuthMethod[]; readonly localAddress?: string; readonly localPort?: number; readonly timeout?: number; readonly ident?: Buffer | string; }) => any; readonly http: (args: { readonly _tag: "http"; readonly host: string; readonly port: number; readonly path?: string | undefined | undefined; readonly version?: string | undefined | undefined; }) => any; readonly https: (args: { readonly _tag: "https"; readonly host: string; readonly port: number; readonly version?: string | undefined | undefined; readonly path?: string | undefined | undefined; readonly cert?: string | undefined | undefined; readonly ca?: string | undefined | undefined; readonly key?: string | undefined | undefined; readonly passphrase?: string | undefined | undefined; }) => any; }>(value: { readonly _tag: "socket"; readonly socketPath: string; readonly version?: string | undefined | undefined; } | { readonly _tag: "ssh"; readonly remoteSocketPath: string; readonly host: string; readonly version?: string | undefined | undefined; readonly port?: number; readonly forceIPv4?: boolean; readonly forceIPv6?: boolean; readonly hostHash?: string; readonly hostVerifier?: import("ssh2").HostVerifier | import("ssh2").SyncHostVerifier | import("ssh2").HostFingerprintVerifier | import("ssh2").SyncHostFingerprintVerifier; readonly username?: string; readonly password?: string; readonly agent?: import("ssh2").BaseAgent | string; readonly privateKey?: Buffer | string; readonly passphrase?: Buffer | string; readonly localHostname?: string; readonly localUsername?: string; readonly tryKeyboard?: boolean; readonly keepaliveInterval?: number; readonly keepaliveCountMax?: number; readonly readyTimeout?: number; readonly strictVendor?: boolean; readonly sock?: import("stream").Readable; readonly agentForward?: boolean; readonly algorithms?: import("ssh2").Algorithms; readonly debug?: import("ssh2").DebugFunction; readonly authHandler?: import("ssh2").AuthenticationType[] | import("ssh2").AuthHandlerMiddleware | import("ssh2").AuthMethod[]; readonly localAddress?: string; readonly localPort?: number; readonly timeout?: number; readonly ident?: Buffer | string; } | { readonly _tag: "http"; readonly host: string; readonly port: number; readonly path?: string | undefined | undefined; readonly version?: string | undefined | undefined; } | { readonly _tag: "https"; readonly host: string; readonly port: number; readonly version?: string | undefined | undefined; readonly path?: string | undefined | undefined; readonly cert?: string | undefined | undefined; readonly ca?: string | undefined | undefined; readonly key?: string | undefined | undefined; readonly passphrase?: string | undefined | undefined; }, cases: Cases & { [K in Exclude]: never; }): import("effect/Unify").Unify>; }; }; /** * @since 1.0.0 * @category Connection Constructors */ export declare const SocketConnectionOptions: Data.Case.Constructor<{ readonly _tag: "socket"; readonly socketPath: string; readonly version?: string | undefined | undefined; }, "_tag">; /** * Connects to a remote machine over ssh. This specific ssh implementation uses * the OpenSSH extension "ForwardOutLocalStream" (so you must being running an * OpenSSH server or something that implements the "ForwardOutLocalStream" * extension) that opens a connection to a UNIX domain socket at socketPath on * the server. * * @since 1.0.0 * @category Connection Constructors */ export declare const SshConnectionOptions: Data.Case.Constructor<{ readonly _tag: "ssh"; readonly remoteSocketPath: string; readonly host: string; readonly version?: string | undefined | undefined; readonly port?: number; readonly forceIPv4?: boolean; readonly forceIPv6?: boolean; readonly hostHash?: string; readonly hostVerifier?: import("ssh2").HostVerifier | import("ssh2").SyncHostVerifier | import("ssh2").HostFingerprintVerifier | import("ssh2").SyncHostFingerprintVerifier; readonly username?: string; readonly password?: string; readonly agent?: import("ssh2").BaseAgent | string; readonly privateKey?: Buffer | string; readonly passphrase?: Buffer | string; readonly localHostname?: string; readonly localUsername?: string; readonly tryKeyboard?: boolean; readonly keepaliveInterval?: number; readonly keepaliveCountMax?: number; readonly readyTimeout?: number; readonly strictVendor?: boolean; readonly sock?: import("stream").Readable; readonly agentForward?: boolean; readonly algorithms?: import("ssh2").Algorithms; readonly debug?: import("ssh2").DebugFunction; readonly authHandler?: import("ssh2").AuthenticationType[] | import("ssh2").AuthHandlerMiddleware | import("ssh2").AuthMethod[]; readonly localAddress?: string; readonly localPort?: number; readonly timeout?: number; readonly ident?: Buffer | string; }, "_tag">; /** * @since 1.0.0 * @category Connection Constructors */ export declare const HttpConnectionOptions: Data.Case.Constructor<{ readonly _tag: "http"; readonly host: string; readonly port: number; readonly path?: string | undefined | undefined; readonly version?: string | undefined | undefined; }, "_tag">; /** * @since 1.0.0 * @category Connection Constructors */ export declare const HttpsConnectionOptions: Data.Case.Constructor<{ readonly _tag: "https"; readonly host: string; readonly port: number; readonly version?: string | undefined | undefined; readonly path?: string | undefined | undefined; readonly cert?: string | undefined | undefined; readonly ca?: string | undefined | undefined; readonly key?: string | undefined | undefined; readonly passphrase?: string | undefined | undefined; }, "_tag">; /** * From * https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-socket-option * * "The Docker client will honor the DOCKER_HOST environment variable to set the * -H flag for the client" * * And then from * https://docs.docker.com/engine/reference/commandline/dockerd/#bind-docker-to-another-hostport-or-a-unix-socket * * "-H accepts host and port assignment in the following format: * `tcp://[host]:[port][path]` or `unix://path` * * For example: * * - `unix://path/to/socket` -> Unix socket located at path/to/socket * - When -H is empty, it will default to the same value as when no -H was passed * in * - `http://host:port/path` -> HTTP connection on host:port and prepend path to * all requests * - `https://host:port/path` -> HTTPS connection on host:port and prepend path to * all requests * - `ssh://me@example.com:22/var/run/docker.sock` -> SSH connection to * example.com on port 22 * * @since 1.0.0 * @category Constructors */ export declare const connectionOptionsFromUrl: (dockerHost: string) => Effect.Effect; /** * Creates a MobyApi layer from the DOCKER_HOST environment variable as a url. * * @since 1.0.0 * @category Constructors */ export declare const connectionOptionsFromDockerHostEnvironmentVariable: Effect.Effect; /** * Creates a MobyApi layer from the platform default system socket location. * * @since 1.0.0 * @category Constructors */ export declare const connectionOptionsFromPlatformSystemSocketDefault: Effect.Effect; /** * Creates a MobyApi layer from the platform default system socket location. * * @since 1.0.0 * @category Constructors */ export declare const connectionOptionsFromUserSocketDefault: Effect.Effect;