@bytecodealliance/preview3-shim 0.1.2 → 0.2.0

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

@@ -1,4 +1,4 @@
-/** @module Interface wasi:http/types@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:http/types@0.3.0 **/
 export type Duration = import('./wasi-clocks-types.js').Duration;
 /**
  * This type corresponds to HTTP standard Methods.
@@ -294,7 +294,7 @@ export interface RequestOptionsErrorOther {
 }
 /**
  * Field names are always strings.
- *
+ * 
  * Field names should always be treated as case insensitive by the `fields`
  * resource for the purposes of equality checking.
  */
@@ -322,24 +322,24 @@ export type Result<T, E> = { tag: 'ok', val: T } | { tag: 'err', val: E };
 export class Fields {
   /**
   * Construct an empty HTTP Fields.
-  *
+  * 
   * The resulting `fields` is mutable.
   */
   constructor()
   /**
   * Construct an HTTP Fields.
-  *
+  * 
   * The resulting `fields` is mutable.
-  *
+  * 
   * The list represents each name-value pair in the Fields. Names
   * which have multiple values are represented by multiple entries in this
   * list with the same name.
-  *
+  * 
   * The tuple is a pair of the field name, represented as a string, and
   * Value, represented as a list of bytes. In a valid Fields, all names
   * and values are valid UTF-8 strings. However, values are not always
   * well-formed, so they are represented as a raw list of bytes.
-  *
+  * 
   * An error result will be returned if any header or value was
   * syntactically invalid, if a header was forbidden, or if the
   * entries would exceed an implementation size limit.
@@ -360,9 +360,9 @@ export class Fields {
   /**
   * Set all of the values for a name. Clears any existing values for that
   * name, if they have been set.
-  *
+  * 
   * Fails with `header-error.immutable` if the `fields` are immutable.
-  *
+  * 
   * Fails with `header-error.size-exceeded` if the name or values would
   * exceed an implementation-defined size limit.
   */
@@ -370,25 +370,25 @@ export class Fields {
   /**
   * Delete all values for a name. Does nothing if no values for the name
   * exist.
-  *
+  * 
   * Fails with `header-error.immutable` if the `fields` are immutable.
   */
   'delete'(name: FieldName): void;
   /**
   * Delete all values for a name. Does nothing if no values for the name
   * exist.
-  *
+  * 
   * Returns all values previously corresponding to the name, if any.
-  *
+  * 
   * Fails with `header-error.immutable` if the `fields` are immutable.
   */
   getAndDelete(name: FieldName): Array<FieldValue>;
   /**
   * Append a value for a name. Does not change or delete any existing
   * values for that name.
-  *
+  * 
   * Fails with `header-error.immutable` if the `fields` are immutable.
-  *
+  * 
   * Fails with `header-error.size-exceeded` if the value would exceed
   * an implementation-defined size limit.
   */
@@ -396,11 +396,11 @@ export class Fields {
   /**
   * Retrieve the full set of names and values in the Fields. Like the
   * constructor, the list represents each name-value pair.
-  *
+  * 
   * The outer list represents each name-value pair in the Fields. Names
   * which have multiple values are represented by multiple entries in this
   * list with the same name.
-  *
+  * 
   * The names and values are always returned in the original casing and in
   * the order in which they will be serialized for transport.
   */
@@ -421,24 +421,24 @@ export class Request {
   /**
   * Construct a new `request` with a default `method` of `GET`, and
   * `none` values for `path-with-query`, `scheme`, and `authority`.
-  *
+  * 
   * `headers` is the HTTP Headers for the Request.
-  *
+  * 
   * `contents` is the optional body content stream with `none`
   * representing a zero-length content stream.
   * Once it is closed, `trailers` future must resolve to a result.
   * If `trailers` resolves to an error, underlying connection
   * will be closed immediately.
-  *
+  * 
   * `options` is optional `request-options` resource to be used
   * if the request is sent over a network connection.
-  *
+  * 
   * It is possible to construct, or manipulate with the accessor functions
   * below, a `request` with an invalid combination of `scheme`
   * and `authority`, or `headers` which are not permitted to be sent.
   * It is the obligation of the `handler.handle` implementation
   * to reject invalid constructions of `request`.
-  *
+  * 
   * The returned future resolves to result of transmission of this request.
   */
   static 'new'(headers: Headers, contents: ReadableStream<number> | undefined, trailers: Promise<Result<Trailers | undefined, ErrorCode>>, options: RequestOptions | undefined): [Request, Promise<Result<void, ErrorCode>>];
@@ -488,10 +488,10 @@ export class Request {
   setAuthority(authority: string | undefined): void;
   /**
   * Get the `request-options` to be associated with this request
-  *
+  * 
   * The returned `request-options` resource is immutable: `set-*` operations
   * will fail if invoked.
-  *
+  * 
   * This `request-options` resource is a child: it must be dropped before
   * the parent `request` is dropped, or its ownership is transferred to
   * another component by e.g. `handler.handle`.
@@ -499,22 +499,22 @@ export class Request {
   getOptions(): RequestOptions | undefined;
   /**
   * Get the headers associated with the Request.
-  *
+  * 
   * The returned `headers` resource is immutable: `set`, `append`, and
   * `delete` operations will fail with `header-error.immutable`.
   */
   getHeaders(): Headers;
   /**
   * Get body of the Request.
-  *
+  * 
   * Stream returned by this method represents the contents of the body.
   * Once the stream is reported as closed, callers should await the returned
   * future to determine whether the body was received successfully.
   * The future will only resolve after the stream is reported as closed.
-  *
+  * 
   * This function takes a `res` future as a parameter, which can be used to
   * communicate an error in handling of the request.
-  *
+  * 
   * Note that function will move the `request`, but references to headers or
   * request options acquired from it previously will remain valid.
   */
@@ -573,15 +573,15 @@ export class Response {
   * Construct a new `response`, with a default `status-code` of `200`.
   * If a different `status-code` is needed, it must be set via the
   * `set-status-code` method.
-  *
+  * 
   * `headers` is the HTTP Headers for the Response.
-  *
+  * 
   * `contents` is the optional body content stream with `none`
   * representing a zero-length content stream.
   * Once it is closed, `trailers` future must resolve to a result.
   * If `trailers` resolves to an error, underlying connection
   * will be closed immediately.
-  *
+  * 
   * The returned future resolves to result of transmission of this response.
   */
   static 'new'(headers: Headers, contents: ReadableStream<number> | undefined, trailers: Promise<Result<Trailers | undefined, ErrorCode>>): [Response, Promise<Result<void, ErrorCode>>];
@@ -596,22 +596,22 @@ export class Response {
   setStatusCode(statusCode: StatusCode): void;
   /**
   * Get the headers associated with the Response.
-  *
+  * 
   * The returned `headers` resource is immutable: `set`, `append`, and
   * `delete` operations will fail with `header-error.immutable`.
   */
   getHeaders(): Headers;
   /**
   * Get body of the Response.
-  *
+  * 
   * Stream returned by this method represents the contents of the body.
   * Once the stream is reported as closed, callers should await the returned
   * future to determine whether the body was received successfully.
   * The future will only resolve after the stream is reported as closed.
-  *
+  * 
   * This function takes a `res` future as a parameter, which can be used to
   * communicate an error in handling of the response.
-  *
+  * 
   * Note that function will move the `response`, but references to headers
   * acquired from it previously will remain valid.
   */

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

@@ -1,19 +1,19 @@
-/** @module Interface wasi:random/insecure-seed@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:random/insecure-seed@0.3.0 **/
 /**
  * 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.

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

@@ -1,14 +1,14 @@
-/** @module Interface wasi:random/insecure@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:random/insecure@0.3.0 **/
 /**
  * Return up to `max-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.
- *
+ * 
  * 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.
@@ -19,7 +19,7 @@
 export function getInsecureRandomBytes(maxLen: bigint): Uint8Array;
 /**
  * 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`.
  */

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

@@ -1,22 +1,22 @@
-/** @module Interface wasi:random/random@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:random/random@0.3.0 **/
 /**
  * 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.
@@ -24,7 +24,7 @@
 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`.
  */

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

@@ -1,19 +1,19 @@
-/** @module Interface wasi:sockets/ip-name-lookup@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:sockets/ip-name-lookup@0.3.0 **/
 /**
  * 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>
@@ -28,7 +28,7 @@ export type IpAddress = import('./wasi-sockets-types.js').IpAddress;
 export type ErrorCode = ErrorCodeAccessDenied | ErrorCodeInvalidArgument | ErrorCodeNameUnresolvable | ErrorCodeTemporaryResolverFailure | ErrorCodePermanentResolverFailure | ErrorCodeOther;
 /**
  * Access denied.
- *
+ * 
  * POSIX equivalent: EACCES, EPERM
  */
 export interface ErrorCodeAccessDenied {
@@ -36,7 +36,7 @@ export interface ErrorCodeAccessDenied {
 }
 /**
  * `name` is a syntactically invalid domain name or IP address.
- *
+ * 
  * POSIX equivalent: EINVAL
  */
 export interface ErrorCodeInvalidArgument {
@@ -44,7 +44,7 @@ export interface ErrorCodeInvalidArgument {
 }
 /**
  * Name does not exist or has no suitable associated IP addresses.
- *
+ * 
  * POSIX equivalent: EAI_NONAME, EAI_NODATA, EAI_ADDRFAMILY
  */
 export interface ErrorCodeNameUnresolvable {
@@ -52,7 +52,7 @@ export interface ErrorCodeNameUnresolvable {
 }
 /**
  * A temporary failure in name resolution occurred.
- *
+ * 
  * POSIX equivalent: EAI_AGAIN
  */
 export interface ErrorCodeTemporaryResolverFailure {
@@ -60,7 +60,7 @@ export interface ErrorCodeTemporaryResolverFailure {
 }
 /**
  * A permanent failure in name resolution occurred.
- *
+ * 
  * POSIX equivalent: EAI_FAIL
  */
 export interface ErrorCodePermanentResolverFailure {