@bytecodealliance/preview2-shim 0.0.11 → 0.0.13

package/types/imports/handler.d.ts

@@ -1,40 +0,0 @@
-export namespace ImportsHandler {
-  /**
-   * Emit a log message.
-   * 
-   * A log message has a `level` describing what kind of message is being
-   * sent, a context, which is an uninterpreted string meant to help
-   * consumers group similar messages, and a string containing the message
-   * text.
-   */
-  export function log(level: Level, context: string, message: string): void;
-}
-/**
- * A log level, describing a kind of message.
- * 
- * # Variants
- * 
- * ## `"trace"`
- * 
- * Describes messages about the values of variables and the flow of
- * control within a program.
- * 
- * ## `"debug"`
- * 
- * Describes messages likely to be of interest to someone debugging a
- * program.
- * 
- * ## `"info"`
- * 
- * Describes messages likely to be of interest to someone monitoring a
- * program.
- * 
- * ## `"warn"`
- * 
- * Describes messages indicating hazardous situations.
- * 
- * ## `"error"`
- * 
- * Describes messages indicating serious errors.
- */
-export type Level = 'trace' | 'debug' | 'info' | 'warn' | 'error';

package/types/imports/insecure-seed.d.ts

@@ -1,22 +0,0 @@
-export namespace ImportsInsecureSeed {
-  /**
-   * Return a 128-bit value that may contain a pseudo-random value.
-   * 
-   * The returned value is not required to be computed from a CSPRNG, and may
-   * even be entirely deterministic. Host implementations are encouraged to
-   * provide pseudo-random values to any program exposed to
-   * attacker-controlled content, to enable DoS protection built into many
-   * languages' hash-map implementations.
-   * 
-   * This function is intended to only be called once, by a source language
-   * to initialize Denial Of Service (DoS) protection in its hash-map
-   * implementation.
-   * 
-   * # Expected future evolution
-   * 
-   * This will likely be changed to a value import, to prevent it from being
-   * called multiple times and potentially used for purposes other than DoS
-   * protection.
-   */
-  export function insecureSeed(): [bigint, bigint];
-}

package/types/imports/insecure.d.ts

@@ -1,20 +0,0 @@
-export namespace ImportsInsecure {
-  /**
-   * Return `len` insecure pseudo-random bytes.
-   * 
-   * This function is not cryptographically secure. Do not use it for
-   * anything related to security.
-   * 
-   * There are no requirements on the values of the returned bytes, however
-   * implementations are encouraged to return evenly distributed values with
-   * a long period.
-   */
-  export function getInsecureRandomBytes(len: bigint): Uint8Array | ArrayBuffer;
-  /**
-   * Return an insecure pseudo-random `u64` value.
-   * 
-   * This function returns the same type of pseudo-random data as
-   * `get-insecure-random-bytes`, represented as a `u64`.
-   */
-  export function getInsecureRandomU64(): bigint;
-}

package/types/imports/instance-network.d.ts

@@ -1,8 +0,0 @@
-export namespace ImportsInstanceNetwork {
-  /**
-   * Get a handle to the default network.
-   */
-  export function instanceNetwork(): Network;
-}
-import type { Network } from '../imports/network';
-export { Network };

package/types/imports/ip-name-lookup.d.ts

@@ -1,76 +0,0 @@
-export namespace ImportsIpNameLookup {
-  /**
-   * Resolve an internet host name to a list of IP addresses.
-   * 
-   * See the wasi-socket proposal README.md for a comparison with getaddrinfo.
-   * 
-   * # Parameters
-   * - `name`: The name to look up. IP addresses are not allowed. Unicode domain names are automatically converted
-   * to ASCII using IDNA encoding.
-   * - `address-family`: If provided, limit the results to addresses of this specific address family.
-   * - `include-unavailable`: When set to true, this function will also return addresses of which the runtime
-   * thinks (or knows) can't be connected to at the moment. For example, this will return IPv6 addresses on
-   * systems without an active IPv6 interface. Notes:
-   * - Even when no public IPv6 interfaces are present or active, names like "localhost" can still resolve to an IPv6 address.
-   * - Whatever is "available" or "unavailable" is volatile and can change everytime a network cable is unplugged.
-   * 
-   * This function never blocks. It either immediately fails or immediately returns successfully with a `resolve-address-stream`
-   * that can be used to (asynchronously) fetch the results.
-   * 
-   * At the moment, the stream never completes successfully with 0 items. Ie. the first call
-   * to `resolve-next-address` never returns `ok(none)`. This may change in the future.
-   * 
-   * # Typical errors
-   * - `invalid-name`:                 `name` is a syntactically invalid domain name.
-   * - `invalid-name`:                 `name` is an IP address.
-   * - `address-family-not-supported`: The specified `address-family` is not supported. (EAI_FAMILY)
-   * 
-   * # References:
-   * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getaddrinfo.html>
-   * - <https://man7.org/linux/man-pages/man3/getaddrinfo.3.html>
-   * - <https://learn.microsoft.com/en-us/windows/win32/api/ws2tcpip/nf-ws2tcpip-getaddrinfo>
-   * - <https://man.freebsd.org/cgi/man.cgi?query=getaddrinfo&sektion=3>
-   */
-  export function resolveAddresses(network: Network, name: string, addressFamily: IpAddressFamily | null, includeUnavailable: boolean): ResolveAddressStream;
-  /**
-   * Returns the next address from the resolver.
-   * 
-   * This function should be called multiple times. On each call, it will
-   * return the next address in connection order preference. If all
-   * addresses have been exhausted, this function returns `none`.
-   * After which, you should release the stream with `drop-resolve-address-stream`.
-   * 
-   * This function never returns IPv4-mapped IPv6 addresses.
-   * 
-   * # Typical errors
-   * - `name-unresolvable`:          Name does not exist or has no suitable associated IP addresses. (EAI_NONAME, EAI_NODATA, EAI_ADDRFAMILY)
-   * - `temporary-resolver-failure`: A temporary failure in name resolution occurred. (EAI_AGAIN)
-   * - `permanent-resolver-failure`: A permanent failure in name resolution occurred. (EAI_FAIL)
-   * - `would-block`:                A result is not available yet. (EWOULDBLOCK, EAGAIN)
-   */
-  export function resolveNextAddress(this: ResolveAddressStream): IpAddress | null;
-  /**
-   * Dispose of the specified `resolve-address-stream`, 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 dropResolveAddressStream(this: ResolveAddressStream): void;
-  /**
-   * Create a `pollable` which will resolve once the stream 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: ResolveAddressStream): Pollable;
-}
-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 { IpAddress } from '../imports/network';
-export { IpAddress };
-import type { IpAddressFamily } from '../imports/network';
-export { IpAddressFamily };
-export type ResolveAddressStream = number;

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

@@ -1,24 +0,0 @@
-export namespace ImportsMonotonicClock {
-  /**
-   * Read the current value of the clock.
-   * 
-   * The clock is monotonic, therefore calling this function repeatedly will
-   * produce a sequence of non-decreasing values.
-   */
-  export function now(): Instant;
-  /**
-   * Query the resolution of the clock.
-   */
-  export function resolution(): Instant;
-  /**
-   * Create a `pollable` which will resolve once the specified time has been
-   * reached.
-   */
-  export function subscribe(when: Instant, absolute: boolean): Pollable;
-}
-import type { Pollable } from '../imports/poll';
-export { Pollable };
-/**
- * A timestamp in nanoseconds.
- */
-export type Instant = bigint;

package/types/imports/network.d.ts

@@ -1,212 +0,0 @@
-export namespace ImportsNetwork {
-  /**
-   * Dispose of the specified `network`, 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 dropNetwork(this: Network): void;
-}
-/**
- * An opaque resource that represents access to (a subset of) the network.
- * This enables context-based security for networking.
- * There is no need for this to map 1:1 to a physical network interface.
- * 
- * FYI, In the future this will be replaced by handle types.
- */
-export type Network = number;
-export type Ipv6Address = [number, number, number, number, number, number, number, number];
-export interface Ipv6SocketAddress {
-  port: number,
-  flowInfo: number,
-  address: Ipv6Address,
-  scopeId: number,
-}
-export type Ipv4Address = [number, number, number, number];
-export interface Ipv4SocketAddress {
-  port: number,
-  address: Ipv4Address,
-}
-export type IpSocketAddress = IpSocketAddressIpv4 | IpSocketAddressIpv6;
-export interface IpSocketAddressIpv4 {
-  tag: 'ipv4',
-  val: Ipv4SocketAddress,
-}
-export interface IpSocketAddressIpv6 {
-  tag: 'ipv6',
-  val: Ipv6SocketAddress,
-}
-/**
- * # Variants
- * 
- * ## `"ipv4"`
- * 
- * Similar to `AF_INET` in POSIX.
- * 
- * ## `"ipv6"`
- * 
- * Similar to `AF_INET6` in POSIX.
- */
-export type IpAddressFamily = 'ipv4' | 'ipv6';
-export type IpAddress = IpAddressIpv4 | IpAddressIpv6;
-export interface IpAddressIpv4 {
-  tag: 'ipv4',
-  val: Ipv4Address,
-}
-export interface IpAddressIpv6 {
-  tag: 'ipv6',
-  val: Ipv6Address,
-}
-/**
- * Error codes.
- * 
- * In theory, every API can return any error code.
- * In practice, API's typically only return the errors documented per API
- * combined with a couple of errors that are always possible:
- * - `unknown`
- * - `access-denied`
- * - `not-supported`
- * - `out-of-memory`
- * 
- * See each individual API for what the POSIX equivalents are. They sometimes differ per API.
- * 
- * # Variants
- * 
- * ## `"unknown"`
- * 
- * Unknown error
- * 
- * ## `"access-denied"`
- * 
- * Access denied.
- * 
- * POSIX equivalent: EACCES, EPERM
- * 
- * ## `"not-supported"`
- * 
- * The operation is not supported.
- * 
- * POSIX equivalent: EOPNOTSUPP
- * 
- * ## `"out-of-memory"`
- * 
- * Not enough memory to complete the operation.
- * 
- * POSIX equivalent: ENOMEM, ENOBUFS, EAI_MEMORY
- * 
- * ## `"timeout"`
- * 
- * The operation timed out before it could finish completely.
- * 
- * ## `"concurrency-conflict"`
- * 
- * This operation is incompatible with another asynchronous operation that is already in progress.
- * 
- * ## `"not-in-progress"`
- * 
- * Trying to finish an asynchronous operation that:
- * - has not been started yet, or:
- * - was already finished by a previous `finish-*` call.
- * 
- * Note: this is scheduled to be removed when `future`s are natively supported.
- * 
- * ## `"would-block"`
- * 
- * The operation has been aborted because it could not be completed immediately.
- * 
- * Note: this is scheduled to be removed when `future`s are natively supported.
- * 
- * ## `"address-family-not-supported"`
- * 
- * The specified address-family is not supported.
- * 
- * ## `"address-family-mismatch"`
- * 
- * An IPv4 address was passed to an IPv6 resource, or vice versa.
- * 
- * ## `"invalid-remote-address"`
- * 
- * The socket address is not a valid remote address. E.g. the IP address is set to INADDR_ANY, or the port is set to 0.
- * 
- * ## `"ipv4-only-operation"`
- * 
- * The operation is only supported on IPv4 resources.
- * 
- * ## `"ipv6-only-operation"`
- * 
- * The operation is only supported on IPv6 resources.
- * 
- * ## `"new-socket-limit"`
- * 
- * A new socket resource could not be created because of a system limit.
- * 
- * ## `"already-attached"`
- * 
- * The socket is already attached to another network.
- * 
- * ## `"already-bound"`
- * 
- * The socket is already bound.
- * 
- * ## `"already-connected"`
- * 
- * The socket is already in the Connection state.
- * 
- * ## `"not-bound"`
- * 
- * The socket is not bound to any local address.
- * 
- * ## `"not-connected"`
- * 
- * The socket is not in the Connection state.
- * 
- * ## `"address-not-bindable"`
- * 
- * A bind operation failed because the provided address is not an address that the `network` can bind to.
- * 
- * ## `"address-in-use"`
- * 
- * A bind operation failed because the provided address is already in use.
- * 
- * ## `"ephemeral-ports-exhausted"`
- * 
- * A bind operation failed because there are no ephemeral ports available.
- * 
- * ## `"remote-unreachable"`
- * 
- * The remote address is not reachable
- * 
- * ## `"already-listening"`
- * 
- * The socket is already in the Listener state.
- * 
- * ## `"not-listening"`
- * 
- * The socket is already in the Listener state.
- * 
- * ## `"connection-refused"`
- * 
- * The connection was forcefully rejected
- * 
- * ## `"connection-reset"`
- * 
- * The connection was reset.
- * 
- * ## `"datagram-too-large"`
- * 
- * ## `"invalid-name"`
- * 
- * The provided name is a syntactically invalid domain name.
- * 
- * ## `"name-unresolvable"`
- * 
- * Name does not exist or has no suitable associated IP addresses.
- * 
- * ## `"temporary-resolver-failure"`
- * 
- * A temporary failure in name resolution occurred.
- * 
- * ## `"permanent-resolver-failure"`
- * 
- * A permanent failure in name resolution occurred.
- */
-export type ErrorCode = 'unknown' | 'access-denied' | 'not-supported' | 'out-of-memory' | 'timeout' | 'concurrency-conflict' | 'not-in-progress' | 'would-block' | 'address-family-not-supported' | 'address-family-mismatch' | 'invalid-remote-address' | 'ipv4-only-operation' | 'ipv6-only-operation' | 'new-socket-limit' | 'already-attached' | 'already-bound' | 'already-connected' | 'not-bound' | 'not-connected' | 'address-not-bindable' | 'address-in-use' | 'ephemeral-ports-exhausted' | 'remote-unreachable' | 'already-listening' | 'not-listening' | 'connection-refused' | 'connection-reset' | 'datagram-too-large' | 'invalid-name' | 'name-unresolvable' | 'temporary-resolver-failure' | 'permanent-resolver-failure';

package/types/imports/outgoing-handler.d.ts

@@ -1,9 +0,0 @@
-export namespace ImportsOutgoingHandler {
-  export function handle(request: OutgoingRequest, options: RequestOptions | null): FutureIncomingResponse;
-}
-import type { OutgoingRequest } from '../imports/types';
-export { OutgoingRequest };
-import type { RequestOptions } from '../imports/types';
-export { RequestOptions };
-import type { FutureIncomingResponse } from '../imports/types';
-export { FutureIncomingResponse };

package/types/imports/poll.d.ts

@@ -1,41 +0,0 @@
-export namespace ImportsPoll {
-  /**
-   * Dispose of the specified `pollable`, after which it may no longer
-   * be used.
-   */
-  export function dropPollable(this: Pollable): void;
-  /**
-   * Poll for completion on a set of pollables.
-   * 
-   * The "oneoff" in the name refers to the fact that this function must do a
-   * linear scan through the entire list of subscriptions, which may be
-   * inefficient if the number is large and the same subscriptions are used
-   * many times. In the future, this is expected to be obsoleted by the
-   * component model async proposal, which will include a scalable waiting
-   * facility.
-   * 
-   * Note that the return type would ideally be `list<bool>`, but that would
-   * be more difficult to polyfill given the current state of `wit-bindgen`.
-   * See <https://github.com/bytecodealliance/preview2-prototyping/pull/11#issuecomment-1329873061>
-   * for details.  For now, we use zero to mean "not ready" and non-zero to
-   * mean "ready".
-   */
-  export function pollOneoff(in: Uint32Array): Uint8Array | ArrayBuffer;
-}
-/**
- * A "pollable" handle.
- * 
- * This is conceptually represents a `stream<_, _>`, or in other words,
- * a stream that one can wait on, repeatedly, but which does not itself
- * produce any data. It's temporary scaffolding until component-model's
- * async features are ready.
- * 
- * And at present, it is a `u32` instead of being an actual handle, until
- * the wit-bindgen implementation of handles and resources is ready.
- * 
- * `pollable` lifetimes are not automatically managed. Users must ensure
- * that they do not outlive the resource they reference.
- * 
- * This [represents a resource](https://github.com/WebAssembly/WASI/blob/main/docs/WitInWasi.md#Resources).
- */
-export type Pollable = number;

package/types/imports/preopens.d.ts

@@ -1,12 +0,0 @@
-export namespace ImportsPreopens {
-  /**
-   * Return the set of of preopened directories, and their path.
-   */
-  export function getDirectories(): [Descriptor, string][];
-}
-import type { Descriptor } from '../imports/filesystem';
-export { Descriptor };
-import type { InputStream } from '../imports/streams';
-export { InputStream };
-import type { OutputStream } from '../imports/streams';
-export { OutputStream };

package/types/imports/random.d.ts

@@ -1,22 +0,0 @@
-export namespace ImportsRandom {
-  /**
-   * Return `len` cryptographically-secure pseudo-random bytes.
-   * 
-   * This function must produce data from an adequately seeded
-   * cryptographically-secure pseudo-random number generator (CSPRNG), so it
-   * must not block, from the perspective of the calling program, and the
-   * returned data is always unpredictable.
-   * 
-   * This function must always return fresh pseudo-random data. Deterministic
-   * environments must omit this function, rather than implementing it with
-   * deterministic data.
-   */
-  export function getRandomBytes(len: bigint): Uint8Array | ArrayBuffer;
-  /**
-   * Return a cryptographically-secure pseudo-random `u64` value.
-   * 
-   * This function returns the same type of pseudo-random data as
-   * `get-random-bytes`, represented as a `u64`.
-   */
-  export function getRandomU64(): bigint;
-}

package/types/imports/stderr.d.ts

@@ -1,5 +0,0 @@
-export namespace ImportsStderr {
-  export function getStderr(): OutputStream;
-}
-import type { OutputStream } from '../imports/streams';
-export { OutputStream };

package/types/imports/stdin.d.ts

@@ -1,5 +0,0 @@
-export namespace ImportsStdin {
-  export function getStdin(): InputStream;
-}
-import type { InputStream } from '../imports/streams';
-export { InputStream };

package/types/imports/stdout.d.ts

@@ -1,5 +0,0 @@
-export namespace ImportsStdout {
-  export function getStdout(): OutputStream;
-}
-import type { OutputStream } from '../imports/streams';
-export { OutputStream };