@bytecodealliance/preview3-shim 0.1.2 → 0.2.0

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

@@ -1,15 +1,15 @@
-/** @module Interface wasi:cli/types@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:cli/types@0.3.0 **/
 /**
  * # Variants
- *
+ * 
  * ## `"io"`
- *
+ * 
  * Input/output error
  * ## `"illegal-byte-sequence"`
- *
+ * 
  * Invalid or incomplete multibyte or wide character
  * ## `"pipe"`
- *
+ * 
  * Broken pipe
  */
 export type ErrorCode = 'io' | 'illegal-byte-sequence' | 'pipe';

package/types/interfaces/wasi-clocks-monotonic-clock.d.ts

@@ -1,10 +1,10 @@
-/** @module Interface wasi:clocks/monotonic-clock@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:clocks/monotonic-clock@0.3.0 **/
 /**
  * Read the current value of the clock.
- *
+ * 
  * The clock is monotonic, therefore calling this function repeatedly will
  * produce a sequence of non-decreasing values.
- *
+ * 
  * For completeness, this function traps if it's not possible to represent
  * the value of the clock in a `mark`. Consequently, implementations
  * should ensure that the starting time is low enough to avoid the

package/types/interfaces/wasi-clocks-system-clock.d.ts

@@ -1,10 +1,10 @@
-/** @module Interface wasi:clocks/system-clock@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:clocks/system-clock@0.3.0 **/
 /**
  * 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 nanoseconds field of the output is always less than 1000000000.
  */
 export function now(): Instant;
@@ -18,17 +18,17 @@ export type Duration = import('./wasi-clocks-types.js').Duration;
  * An "instant", or "exact time", is a point in time without regard to any
  * time zone: just the time since a particular external reference point,
  * often called an "epoch".
- *
+ * 
  * Here, the epoch is 1970-01-01T00:00:00Z, also known as
  * [POSIX's Seconds Since the Epoch], also known as [Unix Time].
- *
+ * 
  * Note that even if the seconds field is negative, incrementing
  * nanoseconds always represents moving forwards in time.
  * For example, `{ -1 seconds, 999999999 nanoseconds }` represents the
  * instant one nanosecond before the epoch.
  * For more on various different ways to represent time, see
  * https://tc39.es/proposal-temporal/docs/timezone.html
- *
+ * 
  * [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
  */

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

@@ -1,4 +1,4 @@
-/** @module Interface wasi:clocks/types@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:clocks/types@0.3.0 **/
 /**
  * A duration of time, in nanoseconds.
  */

package/types/interfaces/wasi-filesystem-preopens.d.ts

@@ -1,4 +1,4 @@
-/** @module Interface wasi:filesystem/preopens@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:filesystem/preopens@0.3.0 **/
 /**
  * Return the set of preopened directories, and their paths.
  */

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

@@ -1,4 +1,4 @@
-/** @module Interface wasi:filesystem/types@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:filesystem/types@0.3.0 **/
 export type Instant = import('./wasi-clocks-system-clock.js').Instant;
 /**
  * File size or length of a region within a file.
@@ -6,7 +6,7 @@ export type Instant = import('./wasi-clocks-system-clock.js').Instant;
 export type Filesize = bigint;
 /**
  * The type of a filesystem object referenced by a descriptor.
- *
+ * 
  * Note: This was called `filetype` in earlier versions of WASI.
  */
 export type DescriptorType = DescriptorTypeBlockDevice | DescriptorTypeCharacterDevice | DescriptorTypeDirectory | DescriptorTypeFifo | DescriptorTypeSymbolicLink | DescriptorTypeRegularFile | DescriptorTypeSocket | DescriptorTypeOther;
@@ -62,7 +62,7 @@ export interface DescriptorTypeOther {
 }
 /**
  * Descriptor flags.
- *
+ * 
  * Note: This was called `fdflags` in earlier versions of WASI.
  */
 export interface DescriptorFlags {
@@ -78,7 +78,7 @@ export interface DescriptorFlags {
    * Request that writes be performed according to synchronized I/O file
    * integrity completion. The data stored in the file and the file's
    * metadata are synchronized. This is similar to `O_SYNC` in POSIX.
-   *
+   * 
    * The precise semantics of this operation have not yet been defined for
    * WASI. At this time, it should be interpreted as a request, and not a
    * requirement.
@@ -88,7 +88,7 @@ export interface DescriptorFlags {
    * Request that writes be performed according to synchronized I/O data
    * integrity completion. Only the data stored in the file is
    * synchronized. This is similar to `O_DSYNC` in POSIX.
-   *
+   * 
    * The precise semantics of this operation have not yet been defined for
    * WASI. At this time, it should be interpreted as a request, and not a
    * requirement.
@@ -97,7 +97,7 @@ export interface DescriptorFlags {
   /**
    * Requests that reads be performed at the same level of integrity
    * requested for writes. This is similar to `O_RSYNC` in POSIX.
-   *
+   * 
    * The precise semantics of this operation have not yet been defined for
    * WASI. At this time, it should be interpreted as a request, and not a
    * requirement.
@@ -105,13 +105,13 @@ export interface DescriptorFlags {
   requestedWriteSync?: boolean,
   /**
    * Mutating directories mode: Directory contents may be mutated.
-   *
+   * 
    * When this flag is unset on a descriptor, operations using the
    * descriptor which would create, rename, delete, modify the data or
    * metadata of filesystem objects, or obtain another handle which
    * would permit any of those, shall fail with `error-code::read-only` if
    * they would otherwise succeed.
-   *
+   * 
    * This may only be set on directories.
    */
   mutateDirectory?: boolean,
@@ -153,7 +153,7 @@ export interface OpenFlags {
 export type LinkCount = bigint;
 /**
  * File attributes.
- *
+ * 
  * Note: This was called `filestat` in earlier versions of WASI.
  */
 export interface DescriptorStat {
@@ -172,21 +172,21 @@ export interface DescriptorStat {
   size: Filesize,
   /**
    * Last data access timestamp.
-   *
+   * 
    * If the `option` is none, the platform doesn't maintain an access
    * timestamp for this file.
    */
   dataAccessTimestamp?: Instant,
   /**
    * Last data modification timestamp.
-   *
+   * 
    * If the `option` is none, the platform doesn't maintain a
    * modification timestamp for this file.
    */
   dataModificationTimestamp?: Instant,
   /**
    * Last file status-change timestamp.
-   *
+   * 
    * If the `option` is none, the platform doesn't maintain a
    * status-change timestamp for this file.
    */
@@ -464,29 +464,29 @@ export interface ErrorCodeOther {
 /**
  * File or memory access pattern advisory information.
  * # Variants
- *
+ * 
  * ## `"normal"`
- *
+ * 
  * The application has no advice to give on its behavior with respect
  * to the specified data.
  * ## `"sequential"`
- *
+ * 
  * The application expects to access the specified data sequentially
  * from lower offsets to higher offsets.
  * ## `"random"`
- *
+ * 
  * The application expects to access the specified data in a random
  * order.
  * ## `"will-need"`
- *
+ * 
  * The application expects to access the specified data in the near
  * future.
  * ## `"dont-need"`
- *
+ * 
  * The application expects that it will not access the specified data
  * in the near future.
  * ## `"no-reuse"`
- *
+ * 
  * The application expects to access the specified data once and then
  * not reuse it thereafter.
  */
@@ -514,82 +514,82 @@ export class Descriptor {
   private constructor();
   /**
   * Return a stream for reading from a file.
-  *
+  * 
   * Multiple read, write, and append streams may be active on the same open
   * file and they do not interfere with each other.
-  *
+  * 
   * This function returns a `stream` which provides the data received from the
   * file, and a `future` providing additional error information in case an
   * error is encountered.
-  *
+  * 
   * If no error is encountered, `stream.read` on the `stream` will return
   * `read-status::closed` with no `error-context` and the future resolves to
   * the value `ok`. If an error is encountered, `stream.read` on the
   * `stream` returns `read-status::closed` with an `error-context` and the future
   * resolves to `err` with an `error-code`.
-  *
+  * 
   * Note: This is similar to `pread` in POSIX.
   */
   readViaStream(offset: Filesize): [ReadableStream<number>, Promise<Result<void, ErrorCode>>];
   /**
   * Return a stream for writing to a file, if available.
-  *
+  * 
   * May fail with an error-code describing why the file cannot be written.
-  *
+  * 
   * It is valid to write past the end of a file; the file is extended to the
   * extent of the write, with bytes between the previous end and the start of
   * the write set to zero.
-  *
+  * 
   * This function returns once either full contents of the stream are
   * written or an error is encountered.
-  *
+  * 
   * Note: This is similar to `pwrite` in POSIX.
   */
   writeViaStream(data: ReadableStream<number>, offset: Filesize): Promise<Result<void, ErrorCode>>;
   /**
   * Return a stream for appending to a file, if available.
-  *
+  * 
   * May fail with an error-code describing why the file cannot be appended.
-  *
+  * 
   * This function returns once either full contents of the stream are
   * written or an error is encountered.
-  *
+  * 
   * Note: This is similar to `write` with `O_APPEND` in POSIX.
   */
   appendViaStream(data: ReadableStream<number>): Promise<Result<void, ErrorCode>>;
   /**
   * Provide file advisory information on a descriptor.
-  *
+  * 
   * This is similar to `posix_fadvise` in POSIX.
   */
   advise(offset: Filesize, length: Filesize, advice: Advice): Promise<void>;
   /**
   * Synchronize the data of a file to disk.
-  *
+  * 
   * This function succeeds with no effect if the file descriptor is not
   * opened for writing.
-  *
+  * 
   * Note: This is similar to `fdatasync` in POSIX.
   */
   syncData(): Promise<void>;
   /**
   * Get flags associated with a descriptor.
-  *
+  * 
   * Note: This returns similar flags to `fcntl(fd, F_GETFL)` in POSIX.
-  *
+  * 
   * Note: This returns the value that was the `fs_flags` value returned
   * from `fdstat_get` in earlier versions of WASI.
   */
   getFlags(): Promise<DescriptorFlags>;
   /**
   * Get the dynamic type of a descriptor.
-  *
+  * 
   * Note: This returns the same value as the `type` field of the `fd-stat`
   * returned by `stat`, `stat-at` and similar.
-  *
+  * 
   * Note: This returns similar flags to the `st_mode & S_IFMT` value provided
   * by `fstat` in POSIX.
-  *
+  * 
   * Note: This returns the value that was the `fs_filetype` value returned
   * from `fdstat_get` in earlier versions of WASI.
   */
@@ -597,143 +597,143 @@ export class Descriptor {
   /**
   * Adjust the size of an open file. If this increases the file's size, the
   * extra bytes are filled with zeros.
-  *
+  * 
   * Note: This was called `fd_filestat_set_size` in earlier versions of WASI.
   */
   setSize(size: Filesize): Promise<void>;
   /**
   * Adjust the timestamps of an open file or directory.
-  *
+  * 
   * Note: This is similar to `futimens` in POSIX.
-  *
+  * 
   * Note: This was called `fd_filestat_set_times` in earlier versions of WASI.
   */
   setTimes(dataAccessTimestamp: NewTimestamp, dataModificationTimestamp: NewTimestamp): Promise<void>;
   /**
   * Read directory entries from a directory.
-  *
+  * 
   * On filesystems where directories contain entries referring to themselves
   * and their parents, often named `.` and `..` respectively, these entries
   * are omitted.
-  *
+  * 
   * This always returns a new stream which starts at the beginning of the
   * directory. Multiple streams may be active on the same directory, and they
   * do not interfere with each other.
-  *
+  * 
   * This function returns a future, which will resolve to an error code if
   * reading full contents of the directory fails.
   */
   readDirectory(): [ReadableStream<DirectoryEntry>, Promise<Result<void, ErrorCode>>];
   /**
   * Synchronize the data and metadata of a file to disk.
-  *
+  * 
   * This function succeeds with no effect if the file descriptor is not
   * opened for writing.
-  *
+  * 
   * Note: This is similar to `fsync` in POSIX.
   */
   sync(): Promise<void>;
   /**
   * Create a directory.
-  *
+  * 
   * Note: This is similar to `mkdirat` in POSIX.
   */
   createDirectoryAt(path: string): Promise<void>;
   /**
   * Return the attributes of an open file or directory.
-  *
+  * 
   * Note: This is similar to `fstat` in POSIX, except that it does not return
   * device and inode information. For testing whether two descriptors refer to
   * the same underlying filesystem object, use `is-same-object`. To obtain
   * additional data that can be used do determine whether a file has been
   * modified, use `metadata-hash`.
-  *
+  * 
   * Note: This was called `fd_filestat_get` in earlier versions of WASI.
   */
   stat(): Promise<DescriptorStat>;
   /**
   * Return the attributes of a file or directory.
-  *
+  * 
   * Note: This is similar to `fstatat` in POSIX, except that it does not
   * return device and inode information. See the `stat` description for a
   * discussion of alternatives.
-  *
+  * 
   * Note: This was called `path_filestat_get` in earlier versions of WASI.
   */
   statAt(pathFlags: PathFlags, path: string): Promise<DescriptorStat>;
   /**
   * Adjust the timestamps of a file or directory.
-  *
+  * 
   * Note: This is similar to `utimensat` in POSIX.
-  *
+  * 
   * Note: This was called `path_filestat_set_times` in earlier versions of
   * WASI.
   */
   setTimesAt(pathFlags: PathFlags, path: string, dataAccessTimestamp: NewTimestamp, dataModificationTimestamp: NewTimestamp): Promise<void>;
   /**
   * Create a hard link.
-  *
+  * 
   * Fails with `error-code::no-entry` if the old path does not exist,
   * with `error-code::exist` if the new path already exists, and
   * `error-code::not-permitted` if the old path is not a file.
-  *
+  * 
   * Note: This is similar to `linkat` in POSIX.
   */
   linkAt(oldPathFlags: PathFlags, oldPath: string, newDescriptor: Descriptor, newPath: string): Promise<void>;
   /**
   * Open a file or directory.
-  *
+  * 
   * If `flags` contains `descriptor-flags::mutate-directory`, and the base
   * descriptor doesn't have `descriptor-flags::mutate-directory` set,
   * `open-at` fails with `error-code::read-only`.
-  *
+  * 
   * If `flags` contains `write` or `mutate-directory`, or `open-flags`
   * contains `truncate` or `create`, and the base descriptor doesn't have
   * `descriptor-flags::mutate-directory` set, `open-at` fails with
   * `error-code::read-only`.
-  *
+  * 
   * Note: This is similar to `openat` in POSIX.
   */
   openAt(pathFlags: PathFlags, path: string, openFlags: OpenFlags, flags: DescriptorFlags): Promise<Descriptor>;
   /**
   * Read the contents of a symbolic link.
-  *
+  * 
   * If the contents contain an absolute or rooted path in the underlying
   * filesystem, this function fails with `error-code::not-permitted`.
-  *
+  * 
   * Note: This is similar to `readlinkat` in POSIX.
   */
   readlinkAt(path: string): Promise<string>;
   /**
   * Remove a directory.
-  *
+  * 
   * Return `error-code::not-empty` if the directory is not empty.
-  *
+  * 
   * Note: This is similar to `unlinkat(fd, path, AT_REMOVEDIR)` in POSIX.
   */
   removeDirectoryAt(path: string): Promise<void>;
   /**
   * Rename a filesystem object.
-  *
+  * 
   * Note: This is similar to `renameat` in POSIX.
   */
   renameAt(oldPath: string, newDescriptor: Descriptor, newPath: string): Promise<void>;
   /**
   * Create a symbolic link (also known as a "symlink").
-  *
+  * 
   * If `old-path` starts with `/`, the function fails with
   * `error-code::not-permitted`.
-  *
+  * 
   * Note: This is similar to `symlinkat` in POSIX.
   */
   symlinkAt(oldPath: string, newPath: string): Promise<void>;
   /**
   * Unlink a filesystem object that is not a directory.
-  *
+  * 
   * This is similar to `unlinkat(fd, path, 0)` in POSIX.
-  *
+  * 
   * Error returns are as specified by POSIX.
-  *
+  * 
   * If the filesystem object is a directory, `error-code::access` or
   * `error-code::is-directory` may be returned instead of the
   * POSIX-specified `error-code::not-permitted`.
@@ -741,7 +741,7 @@ export class Descriptor {
   unlinkFileAt(path: string): Promise<void>;
   /**
   * Test whether two descriptors refer to the same filesystem object.
-  *
+  * 
   * In POSIX, this corresponds to testing whether the two descriptors have the
   * same device (`st_dev`) and inode (`st_ino` or `d_ino`) numbers.
   * wasi-filesystem does not expose device and inode numbers, so this function
@@ -751,29 +751,29 @@ export class Descriptor {
   /**
   * Return a hash of the metadata associated with a filesystem object referred
   * to by a descriptor.
-  *
+  * 
   * This returns a hash of the last-modification timestamp and file size, and
   * may also include the inode number, device number, birth timestamp, and
   * other metadata fields that may change when the file is modified or
   * replaced. It may also include a secret value chosen by the
   * implementation and not otherwise exposed.
-  *
+  * 
   * Implementations are encouraged to provide the following properties:
-  *
+  * 
   *  - If the file is not modified or replaced, the computed hash value should
   *    usually not change.
   *  - If the object is modified or replaced, the computed hash value should
   *    usually change.
   *  - The inputs to the hash should not be easily computable from the
   *    computed hash.
-  *
+  * 
   * However, none of these is required.
   */
   metadataHash(): Promise<MetadataHashValue>;
   /**
   * Return a hash of the metadata associated with a filesystem object referred
   * to by a directory descriptor and a relative path.
-  *
+  * 
   * This performs the same hash computation as `metadata-hash`.
   */
   metadataHashAt(pathFlags: PathFlags, path: string): Promise<MetadataHashValue>;

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

@@ -1,4 +1,4 @@
-/** @module Interface wasi:http/client@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:http/client@0.3.0 **/
 /**
  * This function may be used to either send an outgoing request over the
  * network or to forward it to another component.

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

@@ -1,4 +1,4 @@
-/** @module Interface wasi:http/handler@0.3.0-rc-2026-03-15 **/
+/** @module Interface wasi:http/handler@0.3.0 **/
 /**
  * This function may be called with either an incoming request read from the
  * network or a request synthesized or forwarded by another component.