@bytecodealliance/preview2-shim 0.0.11 → 0.0.13

package/types/imports/types.d.ts

@@ -1,119 +0,0 @@
-export namespace ImportsTypes {
-  export function dropFields(fields: Fields): void;
-  export function newFields(entries: [string, string][]): Fields;
-  export function fieldsGet(fields: Fields, name: string): string[];
-  export function fieldsSet(fields: Fields, name: string, value: string[]): void;
-  export function fieldsDelete(fields: Fields, name: string): void;
-  export function fieldsAppend(fields: Fields, name: string, value: string): void;
-  export function fieldsEntries(fields: Fields): [string, string][];
-  export function fieldsClone(fields: Fields): Fields;
-  export function finishIncomingStream(s: IncomingStream): Trailers | null;
-  export function finishOutgoingStream(s: OutgoingStream, trailers: Trailers | null): void;
-  export function dropIncomingRequest(request: IncomingRequest): void;
-  export function dropOutgoingRequest(request: OutgoingRequest): void;
-  export function incomingRequestMethod(request: IncomingRequest): Method;
-  export function incomingRequestPath(request: IncomingRequest): string;
-  export function incomingRequestQuery(request: IncomingRequest): string;
-  export function incomingRequestScheme(request: IncomingRequest): Scheme | null;
-  export function incomingRequestAuthority(request: IncomingRequest): string;
-  export function incomingRequestHeaders(request: IncomingRequest): Headers;
-  export function incomingRequestConsume(request: IncomingRequest): IncomingStream;
-  export function newOutgoingRequest(method: Method, path: string, query: string, scheme: Scheme | null, authority: string, headers: Headers): OutgoingRequest;
-  export function outgoingRequestWrite(request: OutgoingRequest): OutgoingStream;
-  export function dropResponseOutparam(response: ResponseOutparam): void;
-  export function setResponseOutparam(response: Result<OutgoingResponse, Error>): void;
-  export function dropIncomingResponse(response: IncomingResponse): void;
-  export function dropOutgoingResponse(response: OutgoingResponse): void;
-  export function incomingResponseStatus(response: IncomingResponse): StatusCode;
-  export function incomingResponseHeaders(response: IncomingResponse): Headers;
-  export function incomingResponseConsume(response: IncomingResponse): IncomingStream;
-  export function newOutgoingResponse(statusCode: StatusCode, headers: Headers): OutgoingResponse;
-  export function outgoingResponseWrite(response: OutgoingResponse): OutgoingStream;
-  export function dropFutureIncomingResponse(f: FutureIncomingResponse): void;
-  export function futureIncomingResponseGet(f: FutureIncomingResponse): Result<IncomingResponse, Error> | null;
-  export function listenToFutureIncomingResponse(f: FutureIncomingResponse): Pollable;
-}
-import type { InputStream } from '../imports/streams';
-export { InputStream };
-import type { OutputStream } from '../imports/streams';
-export { OutputStream };
-import type { Pollable } from '../imports/poll';
-export { Pollable };
-export type StatusCode = number;
-export type Scheme = SchemeHttp | SchemeHttps | SchemeOther;
-export interface SchemeHttp {
-  tag: 'HTTP',
-}
-export interface SchemeHttps {
-  tag: 'HTTPS',
-}
-export interface SchemeOther {
-  tag: 'other',
-  val: string,
-}
-export type ResponseOutparam = number;
-export interface RequestOptions {
-  connectTimeoutMs?: number,
-  firstByteTimeoutMs?: number,
-  betweenBytesTimeoutMs?: number,
-}
-export type OutgoingStream = OutputStream;
-export type OutgoingResponse = number;
-export type OutgoingRequest = number;
-export type Method = MethodGet | MethodHead | MethodPost | MethodPut | MethodDelete | MethodConnect | MethodOptions | MethodTrace | MethodPatch | MethodOther;
-export interface MethodGet {
-  tag: 'get',
-}
-export interface MethodHead {
-  tag: 'head',
-}
-export interface MethodPost {
-  tag: 'post',
-}
-export interface MethodPut {
-  tag: 'put',
-}
-export interface MethodDelete {
-  tag: 'delete',
-}
-export interface MethodConnect {
-  tag: 'connect',
-}
-export interface MethodOptions {
-  tag: 'options',
-}
-export interface MethodTrace {
-  tag: 'trace',
-}
-export interface MethodPatch {
-  tag: 'patch',
-}
-export interface MethodOther {
-  tag: 'other',
-  val: string,
-}
-export type IncomingStream = InputStream;
-export type IncomingResponse = number;
-export type IncomingRequest = number;
-export type FutureIncomingResponse = number;
-export type Fields = number;
-export type Trailers = Fields;
-export type Headers = Fields;
-export type Error = ErrorInvalidUrl | ErrorTimeoutError | ErrorProtocolError | ErrorUnexpectedError;
-export interface ErrorInvalidUrl {
-  tag: 'invalid-url',
-  val: string,
-}
-export interface ErrorTimeoutError {
-  tag: 'timeout-error',
-  val: string,
-}
-export interface ErrorProtocolError {
-  tag: 'protocol-error',
-  val: string,
-}
-export interface ErrorUnexpectedError {
-  tag: 'unexpected-error',
-  val: string,
-}
-export type Result<T, E> = { tag: 'ok', val: T } | { tag: 'err', val: E };

package/types/imports/udp-create-socket.d.ts

@@ -1,33 +0,0 @@
-export namespace ImportsUdpCreateSocket {
-  /**
-   * Create a new UDP socket.
-   * 
-   * Similar to `socket(AF_INET or AF_INET6, SOCK_DGRAM, IPPROTO_UDP)` in POSIX.
-   * 
-   * This function does not require a network capability handle. This is considered to be safe because
-   * at time of creation, the socket is not bound to any `network` yet. Up to the moment `bind`/`connect` is called,
-   * the socket is effectively an in-memory configuration object, unable to communicate with the outside world.
-   * 
-   * All sockets are non-blocking. Use the wasi-poll interface to block on asynchronous operations.
-   * 
-   * # Typical errors
-   * - `not-supported`:                The host does not support UDP sockets. (EOPNOTSUPP)
-   * - `address-family-not-supported`: The specified `address-family` is not supported. (EAFNOSUPPORT)
-   * - `new-socket-limit`:             The new socket resource could not be created because of a system limit. (EMFILE, ENFILE)
-   * 
-   * # References:
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/socket.html>
-   * - <https://man7.org/linux/man-pages/man2/socket.2.html>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsasocketw>
-   * - <https://man.freebsd.org/cgi/man.cgi?query=socket&sektion=2>
-   */
-  export function createUdpSocket(addressFamily: IpAddressFamily): UdpSocket;
-}
-import type { Network } from '../imports/network';
-export { Network };
-import type { ErrorCode } from '../imports/network';
-export { ErrorCode };
-import type { IpAddressFamily } from '../imports/network';
-export { IpAddressFamily };
-import type { UdpSocket } from '../imports/udp';
-export { UdpSocket };

package/types/imports/udp.d.ts

@@ -1,219 +0,0 @@
-export namespace ImportsUdp {
-  /**
-   * Bind the socket to a specific network on the provided IP address and port.
-   * 
-   * If the IP address is zero (`0.0.0.0` in IPv4, `::` in IPv6), it is left to the implementation to decide which
-   * network interface(s) to bind to.
-   * If the TCP/UDP port is zero, the socket will be bound to a random free port.
-   * 
-   * When a socket is not explicitly bound, the first invocation to connect will implicitly bind the socket.
-   * 
-   * Unlike in POSIX, this function is async. This enables interactive WASI hosts to inject permission prompts.
-   * 
-   * # Typical `start` errors
-   * - `address-family-mismatch`:   The `local-address` has the wrong address family. (EINVAL)
-   * - `already-bound`:             The socket is already bound. (EINVAL)
-   * - `concurrency-conflict`:      Another `bind` or `connect` operation is already in progress. (EALREADY)
-   * 
-   * # Typical `finish` errors
-   * - `ephemeral-ports-exhausted`: No ephemeral ports available. (EADDRINUSE, ENOBUFS on Windows)
-   * - `address-in-use`:            Address is already in use. (EADDRINUSE)
-   * - `address-not-bindable`:      `local-address` is not an address that the `network` can bind to. (EADDRNOTAVAIL)
-   * - `not-in-progress`:           A `bind` operation is not in progress.
-   * - `would-block`:               Can't finish the operation, it is still in progress. (EWOULDBLOCK, EAGAIN)
-   * 
-   * # References
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/bind.html>
-   * - <https://man7.org/linux/man-pages/man2/bind.2.html>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-bind>
-   * - <https://man.freebsd.org/cgi/man.cgi?query=bind&sektion=2&format=html>
-   */
-  export function startBind(this: UdpSocket, network: Network, localAddress: IpSocketAddress): void;
-  export function finishBind(this: UdpSocket): void;
-  /**
-   * Set the destination address.
-   * 
-   * The local-address is updated based on the best network path to `remote-address`.
-   * 
-   * When a destination address is set:
-   * - all receive operations will only return datagrams sent from the provided `remote-address`.
-   * - the `send` function can only be used to send to this destination.
-   * 
-   * Note that this function does not generate any network traffic and the peer is not aware of this "connection".
-   * 
-   * Unlike in POSIX, this function is async. This enables interactive WASI hosts to inject permission prompts.
-   * 
-   * # Typical `start` errors
-   * - `address-family-mismatch`:   The `remote-address` has the wrong address family. (EAFNOSUPPORT)
-   * - `invalid-remote-address`:    The IP address in `remote-address` is set to INADDR_ANY (`0.0.0.0` / `::`). (EDESTADDRREQ, EADDRNOTAVAIL)
-   * - `invalid-remote-address`:    The port in `remote-address` is set to 0. (EDESTADDRREQ, EADDRNOTAVAIL)
-   * - `already-attached`:          The socket is already bound to a different network. The `network` passed to `connect` must be identical to the one passed to `bind`.
-   * - `concurrency-conflict`:      Another `bind` or `connect` operation is already in progress. (EALREADY)
-   * 
-   * # Typical `finish` errors
-   * - `ephemeral-ports-exhausted`: Tried to perform an implicit bind, but there were no ephemeral ports available. (EADDRINUSE, EADDRNOTAVAIL on Linux, EAGAIN on BSD)
-   * - `not-in-progress`:           A `connect` operation is not in progress.
-   * - `would-block`:               Can't finish the operation, it is still in progress. (EWOULDBLOCK, EAGAIN)
-   * 
-   * # References
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/connect.html>
-   * - <https://man7.org/linux/man-pages/man2/connect.2.html>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-connect>
-   * - <https://man.freebsd.org/cgi/man.cgi?connect>
-   */
-  export function startConnect(this: UdpSocket, network: Network, remoteAddress: IpSocketAddress): void;
-  export function finishConnect(this: UdpSocket): void;
-  /**
-   * Receive a message.
-   * 
-   * Returns:
-   * - The sender address of the datagram
-   * - The number of bytes read.
-   * 
-   * # Typical errors
-   * - `not-bound`:          The socket is not bound to any local address. (EINVAL)
-   * - `remote-unreachable`: The remote address is not reachable. (ECONNREFUSED, ECONNRESET, ENETRESET on Windows, EHOSTUNREACH, EHOSTDOWN, ENETUNREACH, ENETDOWN)
-   * - `would-block`:        There is no pending data available to be read at the moment. (EWOULDBLOCK, EAGAIN)
-   * 
-   * # References
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/recvfrom.html>
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/recvmsg.html>
-   * - <https://man7.org/linux/man-pages/man2/recv.2.html>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-recv>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-recvfrom>
-   * - <https://learn.microsoft.com/en-us/previous-versions/windows/desktop/legacy/ms741687(v=vs.85)>
-   * - <https://man.freebsd.org/cgi/man.cgi?query=recv&sektion=2>
-   */
-  export function receive(this: UdpSocket): Datagram;
-  /**
-   * Send a message to a specific destination address.
-   * 
-   * The remote address option is required. To send a message to the "connected" peer,
-   * call `remote-address` to get their address.
-   * 
-   * # Typical errors
-   * - `address-family-mismatch`: The `remote-address` has the wrong address family. (EAFNOSUPPORT)
-   * - `invalid-remote-address`:  The IP address in `remote-address` is set to INADDR_ANY (`0.0.0.0` / `::`). (EDESTADDRREQ, EADDRNOTAVAIL)
-   * - `invalid-remote-address`:  The port in `remote-address` is set to 0. (EDESTADDRREQ, EADDRNOTAVAIL)
-   * - `already-connected`:       The socket is in "connected" mode and the `datagram.remote-address` does not match the address passed to `connect`. (EISCONN)
-   * - `not-bound`:               The socket is not bound to any local address. Unlike POSIX, this function does not perform an implicit bind.
-   * - `remote-unreachable`:      The remote address is not reachable. (ECONNREFUSED, ECONNRESET, ENETRESET on Windows, EHOSTUNREACH, EHOSTDOWN, ENETUNREACH, ENETDOWN)
-   * - `datagram-too-large`:      The datagram is too large. (EMSGSIZE)
-   * - `would-block`:             The send buffer is currently full. (EWOULDBLOCK, EAGAIN)
-   * 
-   * # References
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/sendto.html>
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/sendmsg.html>
-   * - <https://man7.org/linux/man-pages/man2/send.2.html>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-send>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-sendto>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsasendmsg>
-   * - <https://man.freebsd.org/cgi/man.cgi?query=send&sektion=2>
-   */
-  export function send(this: UdpSocket, datagram: Datagram): void;
-  /**
-   * Get the current bound address.
-   * 
-   * # Typical errors
-   * - `not-bound`: The socket is not bound to any local address.
-   * 
-   * # References
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getsockname.html>
-   * - <https://man7.org/linux/man-pages/man2/getsockname.2.html>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-getsockname>
-   * - <https://man.freebsd.org/cgi/man.cgi?getsockname>
-   */
-  export function localAddress(this: UdpSocket): IpSocketAddress;
-  /**
-   * Get the address set with `connect`.
-   * 
-   * # Typical errors
-   * - `not-connected`: The socket is not connected to a remote address. (ENOTCONN)
-   * 
-   * # References
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getpeername.html>
-   * - <https://man7.org/linux/man-pages/man2/getpeername.2.html>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-getpeername>
-   * - <https://man.freebsd.org/cgi/man.cgi?query=getpeername&sektion=2&n=1>
-   */
-  export function remoteAddress(this: UdpSocket): IpSocketAddress;
-  /**
-   * Whether this is a IPv4 or IPv6 socket.
-   * 
-   * Equivalent to the SO_DOMAIN socket option.
-   */
-  export function addressFamily(this: UdpSocket): IpAddressFamily;
-  /**
-   * Whether IPv4 compatibility (dual-stack) mode is disabled or not.
-   * 
-   * Equivalent to the IPV6_V6ONLY socket option.
-   * 
-   * # Typical errors
-   * - `ipv6-only-operation`:  (get/set) `this` socket is an IPv4 socket.
-   * - `already-bound`:        (set) The socket is already bound.
-   * - `not-supported`:        (set) Host does not support dual-stack sockets. (Implementations are not required to.)
-   * - `concurrency-conflict`: (set) Another `bind` or `connect` operation is already in progress. (EALREADY)
-   */
-  export function ipv6Only(this: UdpSocket): boolean;
-  export function setIpv6Only(this: UdpSocket, value: boolean): void;
-  /**
-   * Equivalent to the IP_TTL & IPV6_UNICAST_HOPS socket options.
-   * 
-   * # Typical errors
-   * - `concurrency-conflict`: (set) Another `bind` or `connect` operation is already in progress. (EALREADY)
-   */
-  export function unicastHopLimit(this: UdpSocket): number;
-  export function setUnicastHopLimit(this: UdpSocket, value: number): void;
-  /**
-   * The kernel buffer space reserved for sends/receives on this socket.
-   * 
-   * Note #1: an implementation may choose to cap or round the buffer size when setting the value.
-   * In other words, after setting a value, reading the same setting back may return a different value.
-   * 
-   * Note #2: there is not necessarily a direct relationship between the kernel buffer size and the bytes of
-   * actual data to be sent/received by the application, because the kernel might also use the buffer space
-   * for internal metadata structures.
-   * 
-   * Fails when this socket is in the Listening state.
-   * 
-   * Equivalent to the SO_RCVBUF and SO_SNDBUF socket options.
-   * 
-   * # Typical errors
-   * - `concurrency-conflict`: (set) Another `bind` or `connect` operation is already in progress. (EALREADY)
-   */
-  export function receiveBufferSize(this: UdpSocket): bigint;
-  export function setReceiveBufferSize(this: UdpSocket, value: bigint): void;
-  export function sendBufferSize(this: UdpSocket): bigint;
-  export function setSendBufferSize(this: UdpSocket, value: bigint): void;
-  /**
-   * Create a `pollable` which will resolve once the socket is ready for I/O.
-   * 
-   * Note: this function is here for WASI Preview2 only.
-   * It's planned to be removed when `future` is natively supported in Preview3.
-   */
-  export function subscribe(this: UdpSocket): Pollable;
-  /**
-   * Dispose of the specified `udp-socket`, after which it may no longer be used.
-   * 
-   * Note: this function is scheduled to be removed when Resources are natively supported in Wit.
-   */
-  export function dropUdpSocket(this: UdpSocket): void;
-}
-import type { Pollable } from '../imports/poll';
-export { Pollable };
-import type { Network } from '../imports/network';
-export { Network };
-import type { ErrorCode } from '../imports/network';
-export { ErrorCode };
-import type { IpSocketAddress } from '../imports/network';
-export { IpSocketAddress };
-import type { IpAddressFamily } from '../imports/network';
-export { IpAddressFamily };
-/**
- * A UDP socket handle.
- */
-export type UdpSocket = number;
-export interface Datagram {
-  data: Uint8Array,
-  remoteAddress: IpSocketAddress,
-}

package/types/imports/wall-clock.d.ts

@@ -1,31 +0,0 @@
-export namespace ImportsWallClock {
-  /**
-   * Read the current value of the clock.
-   * 
-   * This clock is not monotonic, therefore calling this function repeatedly
-   * will not necessarily produce a sequence of non-decreasing values.
-   * 
-   * The returned timestamps represent the number of seconds since
-   * 1970-01-01T00:00:00Z, also known as [POSIX's Seconds Since the Epoch],
-   * also known as [Unix Time].
-   * 
-   * The nanoseconds field of the output is always less than 1000000000.
-   * 
-   * [POSIX's Seconds Since the Epoch]: https://pubs.opengroup.org/onlinepubs/9699919799/xrat/V4_xbd_chap04.html#tag_21_04_16
-   * [Unix Time]: https://en.wikipedia.org/wiki/Unix_time
-   */
-  export function now(): Datetime;
-  /**
-   * Query the resolution of the clock.
-   * 
-   * The nanoseconds field of the output is always less than 1000000000.
-   */
-  export function resolution(): Datetime;
-}
-/**
- * A time and date in seconds plus nanoseconds.
- */
-export interface Datetime {
-  seconds: bigint,
-  nanoseconds: number,
-}

package/types/wasi-command.d.ts

@@ -1,23 +0,0 @@
-import { ImportsEnvironment } from './imports/environment';
-import { ImportsExit } from './imports/exit';
-import { ImportsPreopens } from './imports/preopens';
-import { ImportsStderr } from './imports/stderr';
-import { ImportsStdin } from './imports/stdin';
-import { ImportsStdout } from './imports/stdout';
-import { ImportsMonotonicClock } from './imports/monotonic-clock';
-import { ImportsTimezone } from './imports/timezone';
-import { ImportsWallClock } from './imports/wall-clock';
-import { ImportsFilesystem } from './imports/filesystem';
-import { ImportsStreams } from './imports/streams';
-import { ImportsPoll } from './imports/poll';
-import { ImportsInsecure } from './imports/insecure';
-import { ImportsInsecureSeed } from './imports/insecure-seed';
-import { ImportsRandom } from './imports/random';
-import { ImportsInstanceNetwork } from './imports/instance-network';
-import { ImportsIpNameLookup } from './imports/ip-name-lookup';
-import { ImportsNetwork } from './imports/network';
-import { ImportsTcp } from './imports/tcp';
-import { ImportsTcpCreateSocket } from './imports/tcp-create-socket';
-import { ImportsUdp } from './imports/udp';
-import { ImportsUdpCreateSocket } from './imports/udp-create-socket';
-export function run(): void;

package/types/wasi-proxy.d.ts

@@ -1,10 +0,0 @@
-import { ImportsOutgoingHandler } from './imports/outgoing-handler';
-import { ImportsTypes } from './imports/types';
-import { ImportsStreams } from './imports/streams';
-import { ImportsHandler } from './imports/handler';
-import { ImportsPoll } from './imports/poll';
-import { ImportsInsecure } from './imports/insecure';
-import { ImportsInsecureSeed } from './imports/insecure-seed';
-import { ImportsRandom } from './imports/random';
-import { ExportsWasiHttpIncomingHandler } from './exports/wasi-http-incoming-handler';
-export const incomingHandler: typeof ExportsWasiHttpIncomingHandler;

package/types/wasi-reactor.d.ts

@@ -1,23 +0,0 @@
-import { ImportsEnvironment } from './imports/environment';
-import { ImportsExit } from './imports/exit';
-import { ImportsPreopens } from './imports/preopens';
-import { ImportsStderr } from './imports/stderr';
-import { ImportsStdin } from './imports/stdin';
-import { ImportsStdout } from './imports/stdout';
-import { ImportsMonotonicClock } from './imports/monotonic-clock';
-import { ImportsTimezone } from './imports/timezone';
-import { ImportsWallClock } from './imports/wall-clock';
-import { ImportsFilesystem } from './imports/filesystem';
-import { ImportsOutgoingHandler } from './imports/outgoing-handler';
-import { ImportsTypes } from './imports/types';
-import { ImportsStreams } from './imports/streams';
-import { ImportsHandler } from './imports/handler';
-import { ImportsPoll } from './imports/poll';
-import { ImportsRandom } from './imports/random';
-import { ImportsInstanceNetwork } from './imports/instance-network';
-import { ImportsIpNameLookup } from './imports/ip-name-lookup';
-import { ImportsNetwork } from './imports/network';
-import { ImportsTcp } from './imports/tcp';
-import { ImportsTcpCreateSocket } from './imports/tcp-create-socket';
-import { ImportsUdp } from './imports/udp';
-import { ImportsUdpCreateSocket } from './imports/udp-create-socket';