@cosmonic-labs/openapi2mcp 0.10.0 → 0.10.2

package/node_modules/@bytecodealliance/preview2-shim/types/interfaces/wasi-sockets-udp.d.ts

@@ -0,0 +1,301 @@
+/** @module Interface wasi:sockets/udp@0.2.3 **/
+export type Pollable = import('./wasi-io-poll.js').Pollable;
+export type Network = import('./wasi-sockets-network.js').Network;
+export type ErrorCode = import('./wasi-sockets-network.js').ErrorCode;
+export type IpSocketAddress = import('./wasi-sockets-network.js').IpSocketAddress;
+export type IpAddressFamily = import('./wasi-sockets-network.js').IpAddressFamily;
+/**
+ * A received datagram.
+ */
+export interface IncomingDatagram {
+  /**
+   * The payload.
+   * 
+   * Theoretical max size: ~64 KiB. In practice, typically less than 1500 bytes.
+   */
+  data: Uint8Array,
+  /**
+   * The source address.
+   * 
+   * This field is guaranteed to match the remote address the stream was initialized with, if any.
+   * 
+   * Equivalent to the `src_addr` out parameter of `recvfrom`.
+   */
+  remoteAddress: IpSocketAddress,
+}
+/**
+ * A datagram to be sent out.
+ */
+export interface OutgoingDatagram {
+  /**
+   * The payload.
+   */
+  data: Uint8Array,
+  /**
+   * The destination address.
+   * 
+   * The requirements on this field depend on how the stream was initialized:
+   * - with a remote address: this field must be None or match the stream's remote address exactly.
+   * - without a remote address: this field is required.
+   * 
+   * If this value is None, the send operation is equivalent to `send` in POSIX. Otherwise it is equivalent to `sendto`.
+   */
+  remoteAddress?: IpSocketAddress,
+}
+
+export class IncomingDatagramStream {
+  /**
+   * This type does not have a public constructor.
+   */
+  private constructor();
+  /**
+  * Receive messages on the socket.
+  * 
+  * This function attempts to receive up to `max-results` datagrams on the socket without blocking.
+  * The returned list may contain fewer elements than requested, but never more.
+  * 
+  * This function returns successfully with an empty list when either:
+  * - `max-results` is 0, or:
+  * - `max-results` is greater than 0, but no results are immediately available.
+  * This function never returns `error(would-block)`.
+  * 
+  * # Typical errors
+  * - `remote-unreachable`: The remote address is not reachable. (ECONNRESET, ENETRESET on Windows, EHOSTUNREACH, EHOSTDOWN, ENETUNREACH, ENETDOWN, ENONET)
+  * - `connection-refused`: The connection was refused. (ECONNREFUSED)
+  * 
+  * # References
+  * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/recvfrom.html>
+  * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/recvmsg.html>
+  * - <https://man7.org/linux/man-pages/man2/recv.2.html>
+  * - <https://man7.org/linux/man-pages/man2/recvmmsg.2.html>
+  * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-recv>
+  * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-recvfrom>
+  * - <https://learn.microsoft.com/en-us/previous-versions/windows/desktop/legacy/ms741687(v=vs.85)>
+  * - <https://man.freebsd.org/cgi/man.cgi?query=recv&sektion=2>
+  */
+  receive(maxResults: bigint): Array<IncomingDatagram>;
+  /**
+  * Create a `pollable` which will resolve once the stream is ready to receive again.
+  * 
+  * Note: this function is here for WASI 0.2 only.
+  * It's planned to be removed when `future` is natively supported in Preview3.
+  */
+  subscribe(): Pollable;
+}
+
+export class OutgoingDatagramStream {
+  /**
+   * This type does not have a public constructor.
+   */
+  private constructor();
+  /**
+  * Check readiness for sending. This function never blocks.
+  * 
+  * Returns the number of datagrams permitted for the next call to `send`,
+  * or an error. Calling `send` with more datagrams than this function has
+  * permitted will trap.
+  * 
+  * When this function returns ok(0), the `subscribe` pollable will
+  * become ready when this function will report at least ok(1), or an
+  * error.
+  * 
+  * Never returns `would-block`.
+  */
+  checkSend(): bigint;
+  /**
+  * Send messages on the socket.
+  * 
+  * This function attempts to send all provided `datagrams` on the socket without blocking and
+  * returns how many messages were actually sent (or queued for sending). This function never
+  * returns `error(would-block)`. If none of the datagrams were able to be sent, `ok(0)` is returned.
+  * 
+  * This function semantically behaves the same as iterating the `datagrams` list and sequentially
+  * sending each individual datagram until either the end of the list has been reached or the first error occurred.
+  * If at least one datagram has been sent successfully, this function never returns an error.
+  * 
+  * If the input list is empty, the function returns `ok(0)`.
+  * 
+  * Each call to `send` must be permitted by a preceding `check-send`. Implementations must trap if
+  * either `check-send` was not called or `datagrams` contains more items than `check-send` permitted.
+  * 
+  * # Typical errors
+  * - `invalid-argument`:        The `remote-address` has the wrong address family. (EAFNOSUPPORT)
+  * - `invalid-argument`:        The IP address in `remote-address` is set to INADDR_ANY (`0.0.0.0` / `::`). (EDESTADDRREQ, EADDRNOTAVAIL)
+  * - `invalid-argument`:        The port in `remote-address` is set to 0. (EDESTADDRREQ, EADDRNOTAVAIL)
+  * - `invalid-argument`:        The socket is in "connected" mode and `remote-address` is `some` value that does not match the address passed to `stream`. (EISCONN)
+  * - `invalid-argument`:        The socket is not "connected" and no value for `remote-address` was provided. (EDESTADDRREQ)
+  * - `remote-unreachable`:      The remote address is not reachable. (ECONNRESET, ENETRESET on Windows, EHOSTUNREACH, EHOSTDOWN, ENETUNREACH, ENETDOWN, ENONET)
+  * - `connection-refused`:      The connection was refused. (ECONNREFUSED)
+  * - `datagram-too-large`:      The datagram is too large. (EMSGSIZE)
+  * 
+  * # References
+  * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/sendto.html>
+  * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/sendmsg.html>
+  * - <https://man7.org/linux/man-pages/man2/send.2.html>
+  * - <https://man7.org/linux/man-pages/man2/sendmmsg.2.html>
+  * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-send>
+  * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-sendto>
+  * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsasendmsg>
+  * - <https://man.freebsd.org/cgi/man.cgi?query=send&sektion=2>
+  */
+  send(datagrams: Array<OutgoingDatagram>): bigint;
+  /**
+  * Create a `pollable` which will resolve once the stream is ready to send again.
+  * 
+  * Note: this function is here for WASI 0.2 only.
+  * It's planned to be removed when `future` is natively supported in Preview3.
+  */
+  subscribe(): Pollable;
+}
+
+export class UdpSocket {
+  /**
+   * This type does not have a public constructor.
+   */
+  private constructor();
+  /**
+  * Bind the socket to a specific network on the provided IP address and port.
+  * 
+  * If the IP address is zero (`0.0.0.0` in IPv4, `::` in IPv6), it is left to the implementation to decide which
+  * network interface(s) to bind to.
+  * If the port is zero, the socket will be bound to a random free port.
+  * 
+  * # Typical errors
+  * - `invalid-argument`:          The `local-address` has the wrong address family. (EAFNOSUPPORT, EFAULT on Windows)
+  * - `invalid-state`:             The socket is already bound. (EINVAL)
+  * - `address-in-use`:            No ephemeral ports available. (EADDRINUSE, ENOBUFS on Windows)
+  * - `address-in-use`:            Address is already in use. (EADDRINUSE)
+  * - `address-not-bindable`:      `local-address` is not an address that the `network` can bind to. (EADDRNOTAVAIL)
+  * - `not-in-progress`:           A `bind` operation is not in progress.
+  * - `would-block`:               Can't finish the operation, it is still in progress. (EWOULDBLOCK, EAGAIN)
+  * 
+  * # Implementors note
+  * Unlike in POSIX, in WASI the bind operation is async. This enables
+  * interactive WASI hosts to inject permission prompts. Runtimes that
+  * don't want to make use of this ability can simply call the native
+  * `bind` as part of either `start-bind` or `finish-bind`.
+  * 
+  * # References
+  * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/bind.html>
+  * - <https://man7.org/linux/man-pages/man2/bind.2.html>
+  * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-bind>
+  * - <https://man.freebsd.org/cgi/man.cgi?query=bind&sektion=2&format=html>
+  */
+  startBind(network: Network, localAddress: IpSocketAddress): void;
+  finishBind(): void;
+  /**
+  * Set up inbound & outbound communication channels, optionally to a specific peer.
+  * 
+  * This function only changes the local socket configuration and does not generate any network traffic.
+  * On success, the `remote-address` of the socket is updated. The `local-address` may be updated as well,
+  * based on the best network path to `remote-address`.
+  * 
+  * When a `remote-address` is provided, the returned streams are limited to communicating with that specific peer:
+  * - `send` can only be used to send to this destination.
+  * - `receive` will only return datagrams sent from the provided `remote-address`.
+  * 
+  * This method may be called multiple times on the same socket to change its association, but
+  * only the most recently returned pair of streams will be operational. Implementations may trap if
+  * the streams returned by a previous invocation haven't been dropped yet before calling `stream` again.
+  * 
+  * The POSIX equivalent in pseudo-code is:
+  * ```text
+  * if (was previously connected) {
+    * 	connect(s, AF_UNSPEC)
+    * }
+    * if (remote_address is Some) {
+      * 	connect(s, remote_address)
+      * }
+      * ```
+      * 
+      * Unlike in POSIX, the socket must already be explicitly bound.
+      * 
+      * # Typical errors
+      * - `invalid-argument`:          The `remote-address` has the wrong address family. (EAFNOSUPPORT)
+      * - `invalid-argument`:          The IP address in `remote-address` is set to INADDR_ANY (`0.0.0.0` / `::`). (EDESTADDRREQ, EADDRNOTAVAIL)
+      * - `invalid-argument`:          The port in `remote-address` is set to 0. (EDESTADDRREQ, EADDRNOTAVAIL)
+      * - `invalid-state`:             The socket is not bound.
+      * - `address-in-use`:            Tried to perform an implicit bind, but there were no ephemeral ports available. (EADDRINUSE, EADDRNOTAVAIL on Linux, EAGAIN on BSD)
+      * - `remote-unreachable`:        The remote address is not reachable. (ECONNRESET, ENETRESET, EHOSTUNREACH, EHOSTDOWN, ENETUNREACH, ENETDOWN, ENONET)
+      * - `connection-refused`:        The connection was refused. (ECONNREFUSED)
+      * 
+      * # References
+      * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/connect.html>
+      * - <https://man7.org/linux/man-pages/man2/connect.2.html>
+      * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-connect>
+      * - <https://man.freebsd.org/cgi/man.cgi?connect>
+      */
+      stream(remoteAddress: IpSocketAddress | undefined): [IncomingDatagramStream, OutgoingDatagramStream];
+      /**
+      * Get the current bound address.
+      * 
+      * POSIX mentions:
+      * > If the socket has not been bound to a local name, the value
+      * > stored in the object pointed to by `address` is unspecified.
+      * 
+      * WASI is stricter and requires `local-address` to return `invalid-state` when the socket hasn't been bound yet.
+      * 
+      * # Typical errors
+      * - `invalid-state`: The socket is not bound to any local address.
+      * 
+      * # References
+      * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getsockname.html>
+      * - <https://man7.org/linux/man-pages/man2/getsockname.2.html>
+      * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-getsockname>
+      * - <https://man.freebsd.org/cgi/man.cgi?getsockname>
+      */
+      localAddress(): IpSocketAddress;
+      /**
+      * Get the address the socket is currently streaming to.
+      * 
+      * # Typical errors
+      * - `invalid-state`: The socket is not streaming to a specific remote address. (ENOTCONN)
+      * 
+      * # References
+      * - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getpeername.html>
+      * - <https://man7.org/linux/man-pages/man2/getpeername.2.html>
+      * - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-getpeername>
+      * - <https://man.freebsd.org/cgi/man.cgi?query=getpeername&sektion=2&n=1>
+      */
+      remoteAddress(): IpSocketAddress;
+      /**
+      * Whether this is a IPv4 or IPv6 socket.
+      * 
+      * Equivalent to the SO_DOMAIN socket option.
+      */
+      addressFamily(): IpAddressFamily;
+      /**
+      * Equivalent to the IP_TTL & IPV6_UNICAST_HOPS socket options.
+      * 
+      * If the provided value is 0, an `invalid-argument` error is returned.
+      * 
+      * # Typical errors
+      * - `invalid-argument`:     (set) The TTL value must be 1 or higher.
+      */
+      unicastHopLimit(): number;
+      setUnicastHopLimit(value: number): void;
+      /**
+      * The kernel buffer space reserved for sends/receives on this socket.
+      * 
+      * If the provided value is 0, an `invalid-argument` error is returned.
+      * Any other value will never cause an error, but it might be silently clamped and/or rounded.
+      * I.e. after setting a value, reading the same setting back may return a different value.
+      * 
+      * Equivalent to the SO_RCVBUF and SO_SNDBUF socket options.
+      * 
+      * # Typical errors
+      * - `invalid-argument`:     (set) The provided value was 0.
+      */
+      receiveBufferSize(): bigint;
+      setReceiveBufferSize(value: bigint): void;
+      sendBufferSize(): bigint;
+      setSendBufferSize(value: bigint): void;
+      /**
+      * Create a `pollable` which will resolve once the socket is ready for I/O.
+      * 
+      * Note: this function is here for WASI 0.2 only.
+      * It's planned to be removed when `future` is natively supported in Preview3.
+      */
+      subscribe(): Pollable;
+    }
+    

package/node_modules/@bytecodealliance/preview2-shim/types/io.d.ts

@@ -0,0 +1,3 @@
+export type * as error from './interfaces/wasi-io-error.d.ts';
+export type * as poll from './interfaces/wasi-io-poll.d.ts';
+export type * as streams from './interfaces/wasi-io-streams.d.ts';

package/node_modules/@bytecodealliance/preview2-shim/types/random.d.ts

@@ -0,0 +1,3 @@
+export type * as insecureSeed from './interfaces/wasi-random-insecure-seed.d.ts';
+export type * as insecure from './interfaces/wasi-random-insecure.d.ts';
+export type * as random from './interfaces/wasi-random-random.d.ts';

package/node_modules/@bytecodealliance/preview2-shim/types/sockets.d.ts

@@ -0,0 +1,7 @@
+export type * as instanceNetwork from './interfaces/wasi-sockets-instance-network.d.ts';
+export type * as ipNameLookup from './interfaces/wasi-sockets-ip-name-lookup.d.ts';
+export type * as network from './interfaces/wasi-sockets-network.d.ts';
+export type * as tcpCreateSocket from './interfaces/wasi-sockets-tcp-create-socket.d.ts';
+export type * as tcp from './interfaces/wasi-sockets-tcp.d.ts';
+export type * as udpCreateSocket from './interfaces/wasi-sockets-udp-create-socket.d.ts';
+export type * as udp from './interfaces/wasi-sockets-udp.d.ts';

package/node_modules/@bytecodealliance/preview2-shim/types/wasi-cli-command.d.ts

@@ -0,0 +1,29 @@
+// world wasi:cli/command@0.2.3
+export type * as WasiCliEnvironment023 from './interfaces/wasi-cli-environment.js'; // import wasi:cli/environment@0.2.3
+export type * as WasiCliExit023 from './interfaces/wasi-cli-exit.js'; // import wasi:cli/exit@0.2.3
+export type * as WasiCliStderr023 from './interfaces/wasi-cli-stderr.js'; // import wasi:cli/stderr@0.2.3
+export type * as WasiCliStdin023 from './interfaces/wasi-cli-stdin.js'; // import wasi:cli/stdin@0.2.3
+export type * as WasiCliStdout023 from './interfaces/wasi-cli-stdout.js'; // import wasi:cli/stdout@0.2.3
+export type * as WasiCliTerminalInput023 from './interfaces/wasi-cli-terminal-input.js'; // import wasi:cli/terminal-input@0.2.3
+export type * as WasiCliTerminalOutput023 from './interfaces/wasi-cli-terminal-output.js'; // import wasi:cli/terminal-output@0.2.3
+export type * as WasiCliTerminalStderr023 from './interfaces/wasi-cli-terminal-stderr.js'; // import wasi:cli/terminal-stderr@0.2.3
+export type * as WasiCliTerminalStdin023 from './interfaces/wasi-cli-terminal-stdin.js'; // import wasi:cli/terminal-stdin@0.2.3
+export type * as WasiCliTerminalStdout023 from './interfaces/wasi-cli-terminal-stdout.js'; // import wasi:cli/terminal-stdout@0.2.3
+export type * as WasiClocksMonotonicClock023 from './interfaces/wasi-clocks-monotonic-clock.js'; // import wasi:clocks/monotonic-clock@0.2.3
+export type * as WasiClocksWallClock023 from './interfaces/wasi-clocks-wall-clock.js'; // import wasi:clocks/wall-clock@0.2.3
+export type * as WasiFilesystemPreopens023 from './interfaces/wasi-filesystem-preopens.js'; // import wasi:filesystem/preopens@0.2.3
+export type * as WasiFilesystemTypes023 from './interfaces/wasi-filesystem-types.js'; // import wasi:filesystem/types@0.2.3
+export type * as WasiIoError023 from './interfaces/wasi-io-error.js'; // import wasi:io/error@0.2.3
+export type * as WasiIoPoll023 from './interfaces/wasi-io-poll.js'; // import wasi:io/poll@0.2.3
+export type * as WasiIoStreams023 from './interfaces/wasi-io-streams.js'; // import wasi:io/streams@0.2.3
+export type * as WasiRandomInsecureSeed023 from './interfaces/wasi-random-insecure-seed.js'; // import wasi:random/insecure-seed@0.2.3
+export type * as WasiRandomInsecure023 from './interfaces/wasi-random-insecure.js'; // import wasi:random/insecure@0.2.3
+export type * as WasiRandomRandom023 from './interfaces/wasi-random-random.js'; // import wasi:random/random@0.2.3
+export type * as WasiSocketsInstanceNetwork023 from './interfaces/wasi-sockets-instance-network.js'; // import wasi:sockets/instance-network@0.2.3
+export type * as WasiSocketsIpNameLookup023 from './interfaces/wasi-sockets-ip-name-lookup.js'; // import wasi:sockets/ip-name-lookup@0.2.3
+export type * as WasiSocketsNetwork023 from './interfaces/wasi-sockets-network.js'; // import wasi:sockets/network@0.2.3
+export type * as WasiSocketsTcpCreateSocket023 from './interfaces/wasi-sockets-tcp-create-socket.js'; // import wasi:sockets/tcp-create-socket@0.2.3
+export type * as WasiSocketsTcp023 from './interfaces/wasi-sockets-tcp.js'; // import wasi:sockets/tcp@0.2.3
+export type * as WasiSocketsUdpCreateSocket023 from './interfaces/wasi-sockets-udp-create-socket.js'; // import wasi:sockets/udp-create-socket@0.2.3
+export type * as WasiSocketsUdp023 from './interfaces/wasi-sockets-udp.js'; // import wasi:sockets/udp@0.2.3
+export * as run from './interfaces/wasi-cli-run.js'; // export wasi:cli/run@0.2.3

package/node_modules/@bytecodealliance/preview2-shim/types/wasi-http-proxy.d.ts

@@ -0,0 +1,13 @@
+// world wasi:http/proxy@0.2.3
+export type * as WasiCliStderr023 from './interfaces/wasi-cli-stderr.js'; // import wasi:cli/stderr@0.2.3
+export type * as WasiCliStdin023 from './interfaces/wasi-cli-stdin.js'; // import wasi:cli/stdin@0.2.3
+export type * as WasiCliStdout023 from './interfaces/wasi-cli-stdout.js'; // import wasi:cli/stdout@0.2.3
+export type * as WasiClocksMonotonicClock023 from './interfaces/wasi-clocks-monotonic-clock.js'; // import wasi:clocks/monotonic-clock@0.2.3
+export type * as WasiClocksWallClock023 from './interfaces/wasi-clocks-wall-clock.js'; // import wasi:clocks/wall-clock@0.2.3
+export type * as WasiHttpOutgoingHandler023 from './interfaces/wasi-http-outgoing-handler.js'; // import wasi:http/outgoing-handler@0.2.3
+export type * as WasiHttpTypes023 from './interfaces/wasi-http-types.js'; // import wasi:http/types@0.2.3
+export type * as WasiIoError023 from './interfaces/wasi-io-error.js'; // import wasi:io/error@0.2.3
+export type * as WasiIoPoll023 from './interfaces/wasi-io-poll.js'; // import wasi:io/poll@0.2.3
+export type * as WasiIoStreams023 from './interfaces/wasi-io-streams.js'; // import wasi:io/streams@0.2.3
+export type * as WasiRandomRandom023 from './interfaces/wasi-random-random.js'; // import wasi:random/random@0.2.3
+export * as incomingHandler from './interfaces/wasi-http-incoming-handler.js'; // export wasi:http/incoming-handler@0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmonic-labs/openapi2mcp",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Generate MCP servers from OpenAPI specs. Works with https://github.com/cosmonic-labs/mcp-server-template-ts",
   "main": "index.js",
   "directories": {
@@ -10,14 +10,15 @@
     "build:wasm": "cargo build --target wasm32-wasip2 --release",
     "build:jco": "jco transpile ./target/wasm32-wasip2/release/openapi2mcp.wasm -o dist",
     "build": "npm run build:wasm && npm run build:jco",
-    "postinstall": "patch-package"
+    "prepare": "patch-package --error-on-fail"
   },
   "bin": {
     "openapi2mcp": "index.js"
   },
   "files": [
     "dist",
-    "index.js"
+    "index.js",
+    "patches"
   ],
   "type": "module",
   "repository": {
@@ -35,7 +36,9 @@
   },
   "devDependencies": {
     "@bytecodealliance/jco": "^1.19.0",
-    "patch-package": "^8.0.1",
-    "postinstall-postinstall": "^2.1.0"
-  }
+    "patch-package": "^8.0.1"
+  },
+  "bundleDependencies": [
+    "@bytecodealliance/preview2-shim"
+  ]
 }

package/patches/@bytecodealliance+preview2-shim+0.18.0.patch

@@ -0,0 +1,13 @@
+diff --git a/node_modules/@bytecodealliance/preview2-shim/lib/nodejs/filesystem.js b/node_modules/@bytecodealliance/preview2-shim/lib/nodejs/filesystem.js
+index 0000000..0000000 100644
+--- a/node_modules/@bytecodealliance/preview2-shim/lib/nodejs/filesystem.js
++++ b/node_modules/@bytecodealliance/preview2-shim/lib/nodejs/filesystem.js
+@@ -385,7 +385,7 @@
+     if (!pathFlags.symlinkFollow) {
+       fsOpenFlags |= constants.O_NOFOLLOW;
+     }
+-    if (descriptorFlags.requestedWriteSync || descriptorFlags.mutateDirectory) {
++    if (descriptorFlags.requestedWriteSync) {
+       throw "unsupported";
+     }
+     // Currently throw to match Wasmtime