@bytecodealliance/preview2-shim 0.16.6 → 0.17.0

package/lib/browser/cli.js

@@ -4,7 +4,7 @@ const { InputStream, OutputStream } = streams;
 
 const symbolDispose = Symbol.dispose ?? Symbol.for('dispose');
 
-let _env = [], _args = [], _cwd = null;
+let _env = [], _args = [], _cwd = "/";
 export function _setEnv (envObj) {
   _env = Object.entries(envObj);
 }
@@ -75,6 +75,10 @@ const stdinStream = new InputStream({
 let textDecoder = new TextDecoder();
 const stdoutStream = new OutputStream({
   write (contents) {
+    if (contents[contents.length - 1] == 10) {
+      // console.log already appends a new line
+      contents = contents.subarray(0, contents.length - 1);
+    }
     console.log(textDecoder.decode(contents));
   },
   blockingFlush () {
@@ -84,10 +88,13 @@ const stdoutStream = new OutputStream({
 });
 const stderrStream = new OutputStream({
   write (contents) {
+    if (contents[contents.length - 1] == 10) {
+      // console.error already appends a new line
+      contents = contents.subarray(0, contents.length - 1);
+    }
     console.error(textDecoder.decode(contents));
   },
   blockingFlush () {
-
   },
   [symbolDispose] () {
 

package/lib/browser/filesystem.js

@@ -3,7 +3,7 @@ import { environment } from './cli.js';
 
 const { InputStream, OutputStream } = streams;
 
-let _cwd = null;
+let _cwd = "/";
 
 export function _setCwd (cwd) {
   _cwd = cwd;

package/lib/io/worker-io.js

@@ -167,7 +167,6 @@ class InputStream {
   #streamType;
   #finalizer;
   read(len) {
-    process._rawDebug('read', len);
     return streamIoErrorCall(
       INPUT_STREAM_READ | this.#streamType,
       this.#id,

package/lib/io/worker-socket-tcp.js

@@ -265,16 +265,13 @@ export function socketTcpGetRemoteAddress(id) {
   return ipSocketAddress(out.family.toLowerCase(), out.address, out.port);
 }
 
-export function socketTcpShutdown(id, shutdownType) {
+export function socketTcpShutdown(id, _shutdownType) {
   const socket = tcpSockets.get(id);
   if (socket.state !== SOCKET_STATE_CONNECTION) throw "invalid-state";
-  // Node.js only supports a write shutdown, which is triggered on end
-  if (shutdownType === "send" || shutdownType === "both") {
-    if (winOrMac && socket.tcpSocket.destroySoon)
-      socket.tcpSocket.destroySoon();
-    else
-      socket.tcpSocket.destroy();
-  }
+  if (winOrMac && socket.tcpSocket.destroySoon)
+    socket.tcpSocket.destroySoon();
+  else
+    socket.tcpSocket.destroy();
 }
 
 export function socketTcpSetKeepAlive(id, { keepAlive, keepAliveIdleTime }) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytecodealliance/preview2-shim",
-  "version": "0.16.6",
+  "version": "0.17.0",
   "description": "WASI Preview2 shim for JS environments",
   "author": "Guy Bedford, Eduardo Rodrigues<16357187+eduardomourar@users.noreply.github.com>",
   "type": "module",

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

@@ -13,13 +13,12 @@ export namespace WasiClocksMonotonicClock {
   export function resolution(): Duration;
   /**
    * Create a `pollable` which will resolve once the specified instant
-   * occured.
+   * has occurred.
    */
   export function subscribeInstant(when: Instant): Pollable;
   /**
-   * Create a `pollable` which will resolve once the given duration has
-   * elapsed, starting at the time at which this function was called.
-   * occured.
+   * Create a `pollable` that will resolve after the specified duration has
+   * elapsed from the time this function is invoked.
    */
   export function subscribeDuration(when: Duration): Pollable;
 }

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

@@ -95,7 +95,7 @@ export interface DescriptorFlags {
    */
   dataIntegritySync?: boolean,
   /**
-   * Requests that reads be performed at the same level of integrety
+   * 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

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

@@ -317,19 +317,17 @@ export class Fields {
   * list with the same key.
   * 
   * The tuple is a pair of the field key, represented as a string, and
-  * Value, represented as a list of bytes. In a valid Fields, all keys
-  * and values are valid UTF-8 strings. However, values are not always
-  * well-formed, so they are represented as a raw list of bytes.
+  * Value, represented as a list of bytes.
   * 
-  * An error result will be returned if any header or value was
-  * syntactically invalid, or if a header was forbidden.
+  * An error result will be returned if any `field-key` or `field-value` is
+  * syntactically invalid, or if a field is forbidden.
   */
   static fromList(entries: Array<[FieldKey, FieldValue]>): Fields;
   /**
   * Get all of the values corresponding to a key. If the key is not present
-  * in this `fields`, an empty list is returned. However, if the key is
-  * present but empty, this is represented by a list with one or more
-  * empty field-values present.
+  * in this `fields` or is syntactically invalid, an empty list is returned.
+  * However, if the key is present but empty, this is represented by a list
+  * with one or more empty field-values present.
   */
   get(name: FieldKey): Array<FieldValue>;
   /**
@@ -342,6 +340,9 @@ export class Fields {
   * key, if they have been set.
   * 
   * Fails with `header-error.immutable` if the `fields` are immutable.
+  * 
+  * Fails with `header-error.invalid-syntax` if the `field-key` or any of
+  * the `field-value`s are syntactically invalid.
   */
   set(name: FieldKey, value: Array<FieldValue>): void;
   /**
@@ -349,6 +350,9 @@ export class Fields {
   * exist.
   * 
   * Fails with `header-error.immutable` if the `fields` are immutable.
+  * 
+  * Fails with `header-error.invalid-syntax` if the `field-key` is
+  * syntactically invalid.
   */
   'delete'(name: FieldKey): void;
   /**
@@ -356,6 +360,9 @@ export class Fields {
   * values for that key.
   * 
   * Fails with `header-error.immutable` if the `fields` are immutable.
+  * 
+  * Fails with `header-error.invalid-syntax` if the `field-key` or
+  * `field-value` are syntactically invalid.
   */
   append(name: FieldKey, value: FieldValue): void;
   /**
@@ -368,7 +375,7 @@ export class Fields {
   */
   entries(): Array<[FieldKey, FieldValue]>;
   /**
-  * Make a deep copy of the Fields. Equivelant in behavior to calling the
+  * Make a deep copy of the Fields. Equivalent in behavior to calling the
   * `fields` constructor on the return value of `entries`. The resulting
   * `fields` is mutable.
   */
@@ -378,7 +385,7 @@ export class Fields {
 export class FutureIncomingResponse {
   /**
   * Returns a pollable which becomes ready when either the Response has
-  * been received, or an error has occured. When this pollable is ready,
+  * been received, or an error has occurred. When this pollable is ready,
   * the `get` method will return `some`.
   */
   subscribe(): Pollable;
@@ -393,8 +400,8 @@ export class FutureIncomingResponse {
   * is `some`, and error on subsequent calls.
   * 
   * The inner `result` represents that either the incoming HTTP Response
-  * status and headers have recieved successfully, or that an error
-  * occured. Errors may also occur while consuming the response body,
+  * status and headers have received successfully, or that an error
+  * occurred. Errors may also occur while consuming the response body,
   * but those will be reported by the `incoming-body` and its
   * `output-stream` child.
   */
@@ -404,12 +411,12 @@ export class FutureIncomingResponse {
 export class FutureTrailers {
   /**
   * Returns a pollable which becomes ready when either the trailers have
-  * been received, or an error has occured. When this pollable is ready,
+  * been received, or an error has occurred. When this pollable is ready,
   * the `get` method will return `some`.
   */
   subscribe(): Pollable;
   /**
-  * Returns the contents of the trailers, or an error which occured,
+  * Returns the contents of the trailers, or an error which occurred,
   * once the future is ready.
   * 
   * The outer `option` represents future readiness. Users can wait on this
@@ -421,7 +428,7 @@ export class FutureTrailers {
   * 
   * The inner `result` represents that either the HTTP Request or Response
   * body, as well as any trailers, were received successfully, or that an
-  * error occured receiving them. The optional `trailers` indicates whether
+  * error occurred receiving them. The optional `trailers` indicates whether
   * or not trailers were present in the body.
   * 
   * When some `trailers` are returned by this method, the `trailers`
@@ -472,7 +479,7 @@ export class IncomingRequest {
   */
   scheme(): Scheme | undefined;
   /**
-  * Returns the authority from the request, if it was present.
+  * Returns the authority of the Request's target URI, if present.
   */
   authority(): string | undefined;
   /**
@@ -597,16 +604,16 @@ export class OutgoingRequest {
   */
   setScheme(scheme: Scheme | undefined): void;
   /**
-  * Get the HTTP Authority for the Request. A value of `none` may be used
-  * with Related Schemes which do not require an Authority. The HTTP and
+  * Get the authority of the Request's target URI. A value of `none` may be used
+  * with Related Schemes which do not require an authority. The HTTP and
   * HTTPS schemes always require an authority.
   */
   authority(): string | undefined;
   /**
-  * Set the HTTP Authority for the Request. A value of `none` may be used
-  * with Related Schemes which do not require an Authority. The HTTP and
+  * Set the authority of the Request's target URI. A value of `none` may be used
+  * with Related Schemes which do not require an authority. The HTTP and
   * HTTPS schemes always require an authority. Fails if the string given is
-  * not a syntactically valid uri authority.
+  * not a syntactically valid URI authority.
   */
   setAuthority(authority: string | undefined): void;
   /**
@@ -616,7 +623,7 @@ export class OutgoingRequest {
   * `delete` operations will fail with `header-error.immutable`.
   * 
   * This headers resource is a child: it must be dropped before the parent
-  * `outgoing-request` is dropped, or its ownership is transfered to
+  * `outgoing-request` is dropped, or its ownership is transferred to
   * another component by e.g. `outgoing-handler.handle`.
   */
   headers(): Headers;
@@ -647,7 +654,7 @@ export class OutgoingResponse {
   * `delete` operations will fail with `header-error.immutable`.
   * 
   * This headers resource is a child: it must be dropped before the parent
-  * `outgoing-request` is dropped, or its ownership is transfered to
+  * `outgoing-request` is dropped, or its ownership is transferred to
   * another component by e.g. `outgoing-handler.handle`.
   */
   headers(): Headers;

package/types/interfaces/wasi-io-poll.d.ts

@@ -9,8 +9,9 @@ export namespace WasiIoPoll {
    * The result `list<u32>` contains one or more indices of handles in the
    * argument list that is ready for I/O.
    * 
-   * If the list contains more elements than can be indexed with a `u32`
-   * value, this function traps.
+   * This function traps if either:
+   * - the list is empty, or:
+   * - the list contains more elements than can be indexed with a `u32` value.
    * 
    * A timeout can be implemented by adding a pollable from the
    * wasi-clocks API to the list.
@@ -18,7 +19,7 @@ export namespace WasiIoPoll {
    * This function does not return a `result`; polling in itself does not
    * do any I/O so it doesn't fail. If any of the I/O sources identified by
    * the pollables has an error, it is indicated by marking the source as
-   * being reaedy for I/O.
+   * being ready for I/O.
    */
   export function poll(in_: Array<Pollable>): Uint32Array;
 }

package/types/interfaces/wasi-io-streams.d.ts

@@ -162,7 +162,7 @@ export class OutputStream {
     blockingFlush(): void;
     /**
     * Create a `pollable` which will resolve once the output-stream
-    * is ready for more writing, or an error has occured. When this
+    * is ready for more writing, or an error has occurred. When this
     * pollable is ready, `check-write` will return `ok(n)` with n>0, or an
     * error.
     * 
@@ -212,7 +212,7 @@ export class OutputStream {
       /**
       * Read from one stream and write to another.
       * 
-      * The behavior of splice is equivelant to:
+      * The behavior of splice is equivalent to:
       * 1. calling `check-write` on the `output-stream`
       * 2. calling `read` on the `input-stream` with the smaller of the
       * `check-write` permitted length and the `len` provided to `splice`

package/types/interfaces/wasi-sockets-tcp.d.ts

@@ -79,7 +79,7 @@ export class TcpSocket {
   * Connect to a remote endpoint.
   * 
   * On success:
-  * - the socket is transitioned into the `connection` state.
+  * - the socket is transitioned into the `connected` state.
   * - a pair of streams is returned that can be used to read & write to the connection
   * 
   * After a failed connection attempt, the socket will be in the `closed`
@@ -329,8 +329,8 @@ export class TcpSocket {
   * `subscribe` only has to be called once per socket and can then be
   * (re)used for the remainder of the socket's lifetime.
   * 
-  * See <https://github.com/WebAssembly/wasi-sockets/TcpSocketOperationalSemantics.md#Pollable-readiness>
-  * for a more information.
+  * See <https://github.com/WebAssembly/wasi-sockets/blob/main/TcpSocketOperationalSemantics.md#pollable-readiness>
+  * for more information.
   * 
   * Note: this function is here for WASI Preview2 only.
   * It's planned to be removed when `future` is natively supported in Preview3.
@@ -347,7 +347,7 @@ export class TcpSocket {
   * associated with this socket will be closed and a FIN packet will be sent.
   * - `both`: Same effect as `receive` & `send` combined.
   * 
-  * This function is idempotent. Shutting a down a direction more than once
+  * This function is idempotent; shutting down a direction more than once
   * has no effect and returns `ok`.
   * 
   * The shutdown function does not close (drop) the socket.