Skip to content

Commit

Permalink
Update to v0.2.4
Browse files Browse the repository at this point in the history
  • Loading branch information
github-actions[bot] authored and ricochet committed Feb 6, 2025
1 parent 54a396c commit 71a0f0d
Show file tree
Hide file tree
Showing 54 changed files with 199 additions and 157 deletions.
63 changes: 41 additions & 22 deletions imports.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,21 @@ It is intended to be <code>include</code>d in other worlds.</p>
<ul>
<li>Imports:
<ul>
<li>interface <a href="#wasi_io_poll_0_2_3"><code>wasi:io/[email protected].3</code></a></li>
<li>interface <a href="#wasi_clocks_monotonic_clock_0_2_3"><code>wasi:clocks/[email protected].3</code></a></li>
<li>interface <a href="#wasi_clocks_wall_clock_0_2_3"><code>wasi:clocks/[email protected].3</code></a></li>
<li>interface <a href="#wasi_random_random_0_2_3"><code>wasi:random/[email protected].3</code></a></li>
<li>interface <a href="#wasi_io_error_0_2_3"><code>wasi:io/[email protected].3</code></a></li>
<li>interface <a href="#wasi_io_streams_0_2_3"><code>wasi:io/[email protected].3</code></a></li>
<li>interface <a href="#wasi_cli_stdout_0_2_3"><code>wasi:cli/[email protected].3</code></a></li>
<li>interface <a href="#wasi_cli_stderr_0_2_3"><code>wasi:cli/[email protected].3</code></a></li>
<li>interface <a href="#wasi_cli_stdin_0_2_3"><code>wasi:cli/[email protected].3</code></a></li>
<li>interface <a href="#wasi_http_types_0_2_3"><code>wasi:http/[email protected].3</code></a></li>
<li>interface <a href="#wasi_http_outgoing_handler_0_2_3"><code>wasi:http/[email protected].3</code></a></li>
<li>interface <a href="#wasi_io_poll_0_2_4"><code>wasi:io/[email protected].4</code></a></li>
<li>interface <a href="#wasi_clocks_monotonic_clock_0_2_4"><code>wasi:clocks/[email protected].4</code></a></li>
<li>interface <a href="#wasi_clocks_wall_clock_0_2_4"><code>wasi:clocks/[email protected].4</code></a></li>
<li>interface <a href="#wasi_random_random_0_2_4"><code>wasi:random/[email protected].4</code></a></li>
<li>interface <a href="#wasi_io_error_0_2_4"><code>wasi:io/[email protected].4</code></a></li>
<li>interface <a href="#wasi_io_streams_0_2_4"><code>wasi:io/[email protected].4</code></a></li>
<li>interface <a href="#wasi_cli_stdout_0_2_4"><code>wasi:cli/[email protected].4</code></a></li>
<li>interface <a href="#wasi_cli_stderr_0_2_4"><code>wasi:cli/[email protected].4</code></a></li>
<li>interface <a href="#wasi_cli_stdin_0_2_4"><code>wasi:cli/[email protected].4</code></a></li>
<li>interface <a href="#wasi_http_types_0_2_4"><code>wasi:http/[email protected].4</code></a></li>
<li>interface <a href="#wasi_http_outgoing_handler_0_2_4"><code>wasi:http/[email protected].4</code></a></li>
</ul>
</li>
</ul>
<h2><a id="wasi_io_poll_0_2_3"></a>Import interface wasi:io/[email protected].3</h2>
<h2><a id="wasi_io_poll_0_2_4"></a>Import interface wasi:io/[email protected].4</h2>
<p>A poll API intended to let users wait for I/O events on multiple handles
at once.</p>
<hr />
Expand Down Expand Up @@ -71,7 +71,7 @@ being ready for I/O.</p>
<ul>
<li><a id="poll.0"></a> list&lt;<code>u32</code>&gt;</li>
</ul>
<h2><a id="wasi_clocks_monotonic_clock_0_2_3"></a>Import interface wasi:clocks/[email protected].3</h2>
<h2><a id="wasi_clocks_monotonic_clock_0_2_4"></a>Import interface wasi:clocks/[email protected].4</h2>
<p>WASI Monotonic Clock is a clock API intended to let users measure elapsed
time.</p>
<p>It is intended to be portable at least between Unix-family platforms and
Expand Down Expand Up @@ -130,7 +130,7 @@ elapsed from the time this function is invoked.</p>
<ul>
<li><a id="subscribe_duration.0"></a> own&lt;<a href="#pollable"><a href="#pollable"><code>pollable</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_clocks_wall_clock_0_2_3"></a>Import interface wasi:clocks/[email protected].3</h2>
<h2><a id="wasi_clocks_wall_clock_0_2_4"></a>Import interface wasi:clocks/[email protected].4</h2>
<p>WASI Wall Clock is a clock API intended to let users query the current
time. The name &quot;wall&quot; makes an analogy to a &quot;clock on the wall&quot;, which
is not necessarily monotonic as it may be reset.</p>
Expand Down Expand Up @@ -171,7 +171,7 @@ also known as <a href="https://en.wikipedia.org/wiki/Unix_time">Unix Time</a>.</
<ul>
<li><a id="resolution.0"></a> <a href="#datetime"><a href="#datetime"><code>datetime</code></a></a></li>
</ul>
<h2><a id="wasi_random_random_0_2_3"></a>Import interface wasi:random/[email protected].3</h2>
<h2><a id="wasi_random_random_0_2_4"></a>Import interface wasi:random/[email protected].4</h2>
<p>WASI Random is a random data API.</p>
<p>It is intended to be portable at least between Unix-family platforms and
Windows.</p>
Expand Down Expand Up @@ -204,7 +204,7 @@ represented as a <code>u64</code>.</p>
<ul>
<li><a id="get_random_u64.0"></a> <code>u64</code></li>
</ul>
<h2><a id="wasi_io_error_0_2_3"></a>Import interface wasi:io/[email protected].3</h2>
<h2><a id="wasi_io_error_0_2_4"></a>Import interface wasi:io/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="error"></a><code>resource error</code></h4>
Expand Down Expand Up @@ -237,7 +237,7 @@ hazard.</p>
<ul>
<li><a id="method_error_to_debug_string.0"></a> <code>string</code></li>
</ul>
<h2><a id="wasi_io_streams_0_2_3"></a>Import interface wasi:io/[email protected].3</h2>
<h2><a id="wasi_io_streams_0_2_4"></a>Import interface wasi:io/[email protected].4</h2>
<p>WASI I/O is an I/O abstraction API which is currently focused on providing
stream types.</p>
<p>In the future, the component model is expected to add built-in stream types;
Expand Down Expand Up @@ -567,7 +567,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
<ul>
<li><a id="method_output_stream_blocking_splice.0"></a> result&lt;<code>u64</code>, <a href="#stream_error"><a href="#stream_error"><code>stream-error</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_cli_stdout_0_2_3"></a>Import interface wasi:cli/[email protected].3</h2>
<h2><a id="wasi_cli_stdout_0_2_4"></a>Import interface wasi:cli/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="output_stream"></a><code>type output-stream</code></h4>
Expand All @@ -580,7 +580,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
<ul>
<li><a id="get_stdout.0"></a> own&lt;<a href="#output_stream"><a href="#output_stream"><code>output-stream</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_cli_stderr_0_2_3"></a>Import interface wasi:cli/[email protected].3</h2>
<h2><a id="wasi_cli_stderr_0_2_4"></a>Import interface wasi:cli/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="output_stream"></a><code>type output-stream</code></h4>
Expand All @@ -593,7 +593,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
<ul>
<li><a id="get_stderr.0"></a> own&lt;<a href="#output_stream"><a href="#output_stream"><code>output-stream</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_cli_stdin_0_2_3"></a>Import interface wasi:cli/[email protected].3</h2>
<h2><a id="wasi_cli_stdin_0_2_4"></a>Import interface wasi:cli/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="input_stream"></a><code>type input-stream</code></h4>
Expand All @@ -606,7 +606,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
<ul>
<li><a id="get_stdin.0"></a> own&lt;<a href="#input_stream"><a href="#input_stream"><code>input-stream</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_http_types_0_2_3"></a>Import interface wasi:http/[email protected].3</h2>
<h2><a id="wasi_http_types_0_2_4"></a>Import interface wasi:http/[email protected].4</h2>
<p>This interface defines all of the types and methods for implementing
HTTP Requests and Responses, both incoming and outgoing, as well as
their headers, trailers, and bodies.</p>
Expand Down Expand Up @@ -1260,6 +1260,25 @@ supported.</p>
<ul>
<li><a id="method_request_options_set_between_bytes_timeout.0"></a> result</li>
</ul>
<h4><a id="method_response_outparam_send_informational"></a><code>[method]response-outparam.send-informational: func</code></h4>
<p>Send an HTTP 1xx response.</p>
<p>Unlike <code>response-outparam.set</code>, this does not consume the
<a href="#response_outparam"><code>response-outparam</code></a>, allowing the guest to send an arbitrary number of
informational responses before sending the final response using
<code>response-outparam.set</code>.</p>
<p>This will return an <code>HTTP-protocol-error</code> if <code>status</code> is not in the
range [100-199], or an <code>internal-error</code> if the implementation does not
support informational responses.</p>
<h5>Params</h5>
<ul>
<li><a id="method_response_outparam_send_informational.self"></a><code>self</code>: borrow&lt;<a href="#response_outparam"><a href="#response_outparam"><code>response-outparam</code></a></a>&gt;</li>
<li><a id="method_response_outparam_send_informational.status"></a><code>status</code>: <code>u16</code></li>
<li><a id="method_response_outparam_send_informational.headers"></a><a href="#headers"><code>headers</code></a>: own&lt;<a href="#headers"><a href="#headers"><code>headers</code></a></a>&gt;</li>
</ul>
<h5>Return values</h5>
<ul>
<li><a id="method_response_outparam_send_informational.0"></a> result&lt;_, <a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;</li>
</ul>
<h4><a id="static_response_outparam_set"></a><code>[static]response-outparam.set: func</code></h4>
<p>Set the value of the <a href="#response_outparam"><code>response-outparam</code></a> to either send a response,
or indicate an error.</p>
Expand Down Expand Up @@ -1507,7 +1526,7 @@ but those will be reported by the <a href="#incoming_body"><code>incoming-body</
<ul>
<li><a id="method_future_incoming_response_get.0"></a> option&lt;result&lt;result&lt;own&lt;<a href="#incoming_response"><a href="#incoming_response"><code>incoming-response</code></a></a>&gt;, <a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;&gt;&gt;</li>
</ul>
<h2><a id="wasi_http_outgoing_handler_0_2_3"></a>Import interface wasi:http/[email protected].3</h2>
<h2><a id="wasi_http_outgoing_handler_0_2_4"></a>Import interface wasi:http/[email protected].4</h2>
<p>This interface defines a handler of outgoing HTTP Requests. It should be
imported by components which wish to make HTTP Requests.</p>
<hr />
Expand Down
67 changes: 43 additions & 24 deletions proxy.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,26 +6,26 @@ outgoing HTTP requests.</p>
<ul>
<li>Imports:
<ul>
<li>interface <a href="#wasi_io_poll_0_2_3"><code>wasi:io/[email protected].3</code></a></li>
<li>interface <a href="#wasi_clocks_monotonic_clock_0_2_3"><code>wasi:clocks/[email protected].3</code></a></li>
<li>interface <a href="#wasi_clocks_wall_clock_0_2_3"><code>wasi:clocks/[email protected].3</code></a></li>
<li>interface <a href="#wasi_random_random_0_2_3"><code>wasi:random/[email protected].3</code></a></li>
<li>interface <a href="#wasi_io_error_0_2_3"><code>wasi:io/[email protected].3</code></a></li>
<li>interface <a href="#wasi_io_streams_0_2_3"><code>wasi:io/[email protected].3</code></a></li>
<li>interface <a href="#wasi_cli_stdout_0_2_3"><code>wasi:cli/[email protected].3</code></a></li>
<li>interface <a href="#wasi_cli_stderr_0_2_3"><code>wasi:cli/[email protected].3</code></a></li>
<li>interface <a href="#wasi_cli_stdin_0_2_3"><code>wasi:cli/[email protected].3</code></a></li>
<li>interface <a href="#wasi_http_types_0_2_3"><code>wasi:http/[email protected].3</code></a></li>
<li>interface <a href="#wasi_http_outgoing_handler_0_2_3"><code>wasi:http/[email protected].3</code></a></li>
<li>interface <a href="#wasi_io_poll_0_2_4"><code>wasi:io/[email protected].4</code></a></li>
<li>interface <a href="#wasi_clocks_monotonic_clock_0_2_4"><code>wasi:clocks/[email protected].4</code></a></li>
<li>interface <a href="#wasi_clocks_wall_clock_0_2_4"><code>wasi:clocks/[email protected].4</code></a></li>
<li>interface <a href="#wasi_random_random_0_2_4"><code>wasi:random/[email protected].4</code></a></li>
<li>interface <a href="#wasi_io_error_0_2_4"><code>wasi:io/[email protected].4</code></a></li>
<li>interface <a href="#wasi_io_streams_0_2_4"><code>wasi:io/[email protected].4</code></a></li>
<li>interface <a href="#wasi_cli_stdout_0_2_4"><code>wasi:cli/[email protected].4</code></a></li>
<li>interface <a href="#wasi_cli_stderr_0_2_4"><code>wasi:cli/[email protected].4</code></a></li>
<li>interface <a href="#wasi_cli_stdin_0_2_4"><code>wasi:cli/[email protected].4</code></a></li>
<li>interface <a href="#wasi_http_types_0_2_4"><code>wasi:http/[email protected].4</code></a></li>
<li>interface <a href="#wasi_http_outgoing_handler_0_2_4"><code>wasi:http/[email protected].4</code></a></li>
</ul>
</li>
<li>Exports:
<ul>
<li>interface <a href="#wasi_http_incoming_handler_0_2_3"><code>wasi:http/[email protected].3</code></a></li>
<li>interface <a href="#wasi_http_incoming_handler_0_2_4"><code>wasi:http/[email protected].4</code></a></li>
</ul>
</li>
</ul>
<h2><a id="wasi_io_poll_0_2_3"></a>Import interface wasi:io/[email protected].3</h2>
<h2><a id="wasi_io_poll_0_2_4"></a>Import interface wasi:io/[email protected].4</h2>
<p>A poll API intended to let users wait for I/O events on multiple handles
at once.</p>
<hr />
Expand Down Expand Up @@ -78,7 +78,7 @@ being ready for I/O.</p>
<ul>
<li><a id="poll.0"></a> list&lt;<code>u32</code>&gt;</li>
</ul>
<h2><a id="wasi_clocks_monotonic_clock_0_2_3"></a>Import interface wasi:clocks/[email protected].3</h2>
<h2><a id="wasi_clocks_monotonic_clock_0_2_4"></a>Import interface wasi:clocks/[email protected].4</h2>
<p>WASI Monotonic Clock is a clock API intended to let users measure elapsed
time.</p>
<p>It is intended to be portable at least between Unix-family platforms and
Expand Down Expand Up @@ -137,7 +137,7 @@ elapsed from the time this function is invoked.</p>
<ul>
<li><a id="subscribe_duration.0"></a> own&lt;<a href="#pollable"><a href="#pollable"><code>pollable</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_clocks_wall_clock_0_2_3"></a>Import interface wasi:clocks/[email protected].3</h2>
<h2><a id="wasi_clocks_wall_clock_0_2_4"></a>Import interface wasi:clocks/[email protected].4</h2>
<p>WASI Wall Clock is a clock API intended to let users query the current
time. The name &quot;wall&quot; makes an analogy to a &quot;clock on the wall&quot;, which
is not necessarily monotonic as it may be reset.</p>
Expand Down Expand Up @@ -178,7 +178,7 @@ also known as <a href="https://en.wikipedia.org/wiki/Unix_time">Unix Time</a>.</
<ul>
<li><a id="resolution.0"></a> <a href="#datetime"><a href="#datetime"><code>datetime</code></a></a></li>
</ul>
<h2><a id="wasi_random_random_0_2_3"></a>Import interface wasi:random/[email protected].3</h2>
<h2><a id="wasi_random_random_0_2_4"></a>Import interface wasi:random/[email protected].4</h2>
<p>WASI Random is a random data API.</p>
<p>It is intended to be portable at least between Unix-family platforms and
Windows.</p>
Expand Down Expand Up @@ -211,7 +211,7 @@ represented as a <code>u64</code>.</p>
<ul>
<li><a id="get_random_u64.0"></a> <code>u64</code></li>
</ul>
<h2><a id="wasi_io_error_0_2_3"></a>Import interface wasi:io/[email protected].3</h2>
<h2><a id="wasi_io_error_0_2_4"></a>Import interface wasi:io/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="error"></a><code>resource error</code></h4>
Expand Down Expand Up @@ -244,7 +244,7 @@ hazard.</p>
<ul>
<li><a id="method_error_to_debug_string.0"></a> <code>string</code></li>
</ul>
<h2><a id="wasi_io_streams_0_2_3"></a>Import interface wasi:io/[email protected].3</h2>
<h2><a id="wasi_io_streams_0_2_4"></a>Import interface wasi:io/[email protected].4</h2>
<p>WASI I/O is an I/O abstraction API which is currently focused on providing
stream types.</p>
<p>In the future, the component model is expected to add built-in stream types;
Expand Down Expand Up @@ -574,7 +574,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
<ul>
<li><a id="method_output_stream_blocking_splice.0"></a> result&lt;<code>u64</code>, <a href="#stream_error"><a href="#stream_error"><code>stream-error</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_cli_stdout_0_2_3"></a>Import interface wasi:cli/[email protected].3</h2>
<h2><a id="wasi_cli_stdout_0_2_4"></a>Import interface wasi:cli/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="output_stream"></a><code>type output-stream</code></h4>
Expand All @@ -587,7 +587,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
<ul>
<li><a id="get_stdout.0"></a> own&lt;<a href="#output_stream"><a href="#output_stream"><code>output-stream</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_cli_stderr_0_2_3"></a>Import interface wasi:cli/[email protected].3</h2>
<h2><a id="wasi_cli_stderr_0_2_4"></a>Import interface wasi:cli/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="output_stream"></a><code>type output-stream</code></h4>
Expand All @@ -600,7 +600,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
<ul>
<li><a id="get_stderr.0"></a> own&lt;<a href="#output_stream"><a href="#output_stream"><code>output-stream</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_cli_stdin_0_2_3"></a>Import interface wasi:cli/[email protected].3</h2>
<h2><a id="wasi_cli_stdin_0_2_4"></a>Import interface wasi:cli/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="input_stream"></a><code>type input-stream</code></h4>
Expand All @@ -613,7 +613,7 @@ is ready for reading, before performing the <code>splice</code>.</p>
<ul>
<li><a id="get_stdin.0"></a> own&lt;<a href="#input_stream"><a href="#input_stream"><code>input-stream</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_http_types_0_2_3"></a>Import interface wasi:http/[email protected].3</h2>
<h2><a id="wasi_http_types_0_2_4"></a>Import interface wasi:http/[email protected].4</h2>
<p>This interface defines all of the types and methods for implementing
HTTP Requests and Responses, both incoming and outgoing, as well as
their headers, trailers, and bodies.</p>
Expand Down Expand Up @@ -1267,6 +1267,25 @@ supported.</p>
<ul>
<li><a id="method_request_options_set_between_bytes_timeout.0"></a> result</li>
</ul>
<h4><a id="method_response_outparam_send_informational"></a><code>[method]response-outparam.send-informational: func</code></h4>
<p>Send an HTTP 1xx response.</p>
<p>Unlike <code>response-outparam.set</code>, this does not consume the
<a href="#response_outparam"><code>response-outparam</code></a>, allowing the guest to send an arbitrary number of
informational responses before sending the final response using
<code>response-outparam.set</code>.</p>
<p>This will return an <code>HTTP-protocol-error</code> if <code>status</code> is not in the
range [100-199], or an <code>internal-error</code> if the implementation does not
support informational responses.</p>
<h5>Params</h5>
<ul>
<li><a id="method_response_outparam_send_informational.self"></a><code>self</code>: borrow&lt;<a href="#response_outparam"><a href="#response_outparam"><code>response-outparam</code></a></a>&gt;</li>
<li><a id="method_response_outparam_send_informational.status"></a><code>status</code>: <code>u16</code></li>
<li><a id="method_response_outparam_send_informational.headers"></a><a href="#headers"><code>headers</code></a>: own&lt;<a href="#headers"><a href="#headers"><code>headers</code></a></a>&gt;</li>
</ul>
<h5>Return values</h5>
<ul>
<li><a id="method_response_outparam_send_informational.0"></a> result&lt;_, <a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;</li>
</ul>
<h4><a id="static_response_outparam_set"></a><code>[static]response-outparam.set: func</code></h4>
<p>Set the value of the <a href="#response_outparam"><code>response-outparam</code></a> to either send a response,
or indicate an error.</p>
Expand Down Expand Up @@ -1514,7 +1533,7 @@ but those will be reported by the <a href="#incoming_body"><code>incoming-body</
<ul>
<li><a id="method_future_incoming_response_get.0"></a> option&lt;result&lt;result&lt;own&lt;<a href="#incoming_response"><a href="#incoming_response"><code>incoming-response</code></a></a>&gt;, <a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;&gt;&gt;</li>
</ul>
<h2><a id="wasi_http_outgoing_handler_0_2_3"></a>Import interface wasi:http/[email protected].3</h2>
<h2><a id="wasi_http_outgoing_handler_0_2_4"></a>Import interface wasi:http/[email protected].4</h2>
<p>This interface defines a handler of outgoing HTTP Requests. It should be
imported by components which wish to make HTTP Requests.</p>
<hr />
Expand Down Expand Up @@ -1551,7 +1570,7 @@ through the <a href="#future_incoming_response"><code>future-incoming-response</
<ul>
<li><a id="handle.0"></a> result&lt;own&lt;<a href="#future_incoming_response"><a href="#future_incoming_response"><code>future-incoming-response</code></a></a>&gt;, <a href="#error_code"><a href="#error_code"><code>error-code</code></a></a>&gt;</li>
</ul>
<h2><a id="wasi_http_incoming_handler_0_2_3"></a>Export interface wasi:http/[email protected].3</h2>
<h2><a id="wasi_http_incoming_handler_0_2_4"></a>Export interface wasi:http/[email protected].4</h2>
<hr />
<h3>Types</h3>
<h4><a id="incoming_request"></a><code>type incoming-request</code></h4>
Expand Down
Loading

0 comments on commit 71a0f0d

Please sign in to comment.