@bytecodealliance/preview3-shim 0.1.0-rc.0

package/types/interfaces/wasi-random-random.d.ts

@@ -0,0 +1,31 @@
+/** @module Interface wasi:random/random@0.3.0-rc-2026-03-15 **/
+/**
+ * Return up to `max-len` cryptographically-secure random or pseudo-random
+ * bytes.
+ *
+ * This function must produce data at least as cryptographically secure and
+ * fast as an adequately seeded cryptographically-secure pseudo-random
+ * number generator (CSPRNG). It must not block, from the perspective of
+ * the calling program, under any circumstances, including on the first
+ * request and on requests for numbers of bytes. The returned data must
+ * always be unpredictable.
+ *
+ * Implementations MAY return fewer bytes than requested (a short read).
+ * Callers that require exactly `max-len` bytes MUST call this function in
+ * a loop until the desired number of bytes has been accumulated.
+ * Implementations MUST return at least 1 byte when `max-len` is greater
+ * than zero. When `max-len` is zero, implementations MUST return an empty
+ * list without trapping.
+ *
+ * This function must always return fresh data. Deterministic environments
+ * must omit this function, rather than implementing it with deterministic
+ * data.
+ */
+export function getRandomBytes(maxLen: bigint): Uint8Array;
+/**
+ * Return a cryptographically-secure random or pseudo-random `u64` value.
+ *
+ * This function returns the same type of data as `get-random-bytes`,
+ * represented as a `u64`.
+ */
+export function getRandomU64(): bigint;

package/types/interfaces/wasi-sockets-ip-name-lookup.d.ts

@@ -0,0 +1,77 @@
+/** @module Interface wasi:sockets/ip-name-lookup@0.3.0-rc-2026-03-15 **/
+/**
+ * Resolve an internet host name to a list of IP addresses.
+ *
+ * Unicode domain names are automatically converted to ASCII using IDNA
+ * encoding. If the input is an IP address string, the address is parsed
+ * and returned as-is without making any external requests.
+ *
+ * See the wasi-socket proposal README.md for a comparison with getaddrinfo.
+ *
+ * The results are returned in connection order preference.
+ *
+ * This function never succeeds with 0 results. It either fails or succeeds
+ * with at least one address. Additionally, this function never returns
+ * IPv4-mapped IPv6 addresses.
+ *
+ * # 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(name: string): Promise<Array<IpAddress>>;
+export type IpAddress = import('./wasi-sockets-types.js').IpAddress;
+/**
+ * Lookup error codes.
+ */
+export type ErrorCode = ErrorCodeAccessDenied | ErrorCodeInvalidArgument | ErrorCodeNameUnresolvable | ErrorCodeTemporaryResolverFailure | ErrorCodePermanentResolverFailure | ErrorCodeOther;
+/**
+ * Access denied.
+ *
+ * POSIX equivalent: EACCES, EPERM
+ */
+export interface ErrorCodeAccessDenied {
+  tag: 'access-denied',
+}
+/**
+ * `name` is a syntactically invalid domain name or IP address.
+ *
+ * POSIX equivalent: EINVAL
+ */
+export interface ErrorCodeInvalidArgument {
+  tag: 'invalid-argument',
+}
+/**
+ * Name does not exist or has no suitable associated IP addresses.
+ *
+ * POSIX equivalent: EAI_NONAME, EAI_NODATA, EAI_ADDRFAMILY
+ */
+export interface ErrorCodeNameUnresolvable {
+  tag: 'name-unresolvable',
+}
+/**
+ * A temporary failure in name resolution occurred.
+ *
+ * POSIX equivalent: EAI_AGAIN
+ */
+export interface ErrorCodeTemporaryResolverFailure {
+  tag: 'temporary-resolver-failure',
+}
+/**
+ * A permanent failure in name resolution occurred.
+ *
+ * POSIX equivalent: EAI_FAIL
+ */
+export interface ErrorCodePermanentResolverFailure {
+  tag: 'permanent-resolver-failure',
+}
+/**
+ * A catch-all for errors not captured by the existing variants.
+ * Implementations can use this to extend the error type without
+ * breaking existing code.
+ */
+export interface ErrorCodeOther {
+  tag: 'other',
+  val: string | undefined,
+}