ziex 0.1.0-dev.1309 → 0.1.0-dev.1367

package/README.md

@@ -8,37 +8,29 @@ Ziex combines the power and performance of Zig with the expressiveness and simpl
 
 **[Documentation →](https://ziex.dev/learn)**
 
-
 > **Note:** Most of the API and syntax are finalized and stable, and server-side rendering (SSR) features are production-ready, Ziex continues to evolve with ongoing improvements to client-side rendering and state management, see the [roadmap](#roadmap). You can start using the documented features today, as they are stable and unlikely to change. Areas still under development are not yet documented and will be added as they mature. See [versions](#versions) for Zig and Ziex versions compatibility.
 
-
 ## Getting Started
 
 ### 1. Installing CLI (optional)
 
-macOS/Linux
 ```bash
+# macOS/Linux
 curl -fsSL https://ziex.dev/install | bash
-```
-Windows
-```
+
+# Windows
 powershell -c "irm ziex.dev/install.ps1 | iex"
 ```
 
+
 ### 2. Initializing Project
+
 ```powershell
 zx init
 # or
 npm init ziex
 ```
 
-### 3. Running Project
-```powershell
-zx dev
-# or
-npm run dev
-```
-
 You will need [compatible](#versions) Zig version when using zx CLI or you can use the `Node` template from `npm init ziex`
 
 Read [Getting Started →](https://ziex.dev/learn) for more details.
@@ -159,6 +151,7 @@ const zx = @import("zx");
 </details>
 
 ## Features
+
 - **Declarative UI**: Declarative UI components using with full access to Zig's control flow.
 - **Full-Stack Capabilities**: Build both frontend and backend of web application.
 - **Fast**: Significantly faster at SSR than many other frameworks.
@@ -170,26 +163,27 @@ const zx = @import("zx");
 - **Developer Tooling**: CLI, hot reload, and editor extensions for the best DX.
 
 ## Versions
-| Zig         | Ziex                | Branch            | Status         |
-|-------------|---------------------|-------------------|----------------|
-| `0.17.x`    |                     | `main`            | Development    |
-| `0.16.x`    | `0.1.0-dev.1259`    | `zig-0.16`        | **Latest**     |
-| `0.15.x`    | `0.1.0-dev-1050`    | `zig-0.15`        | Latest (`Zig 0.15.x`)        |
 
+| Zig      | Ziex                                                                              | Branch     | Status      |
+| -------- | --------------------------------------------------------------------------------- | ---------- | ----------- |
+| `0.17.x` |                                                                                   | `main`     | Development |
+| `0.16.x` | [`0.1.0-dev.1259`](https://github.com/ziex-dev/ziex/releases/tag/v0.1.0-dev.1259) | `zig-0.16` | **Latest**  |
+| `0.15.x` | [`0.1.0-dev-1050`](https://github.com/ziex-dev/ziex/releases/tag/v0.1.0-dev.1050) | `zig-0.15` | Outdated    |
 
 ## Roadmap
-[Ziex 0.1.0](https://github.com/ziex-dev/ziex/milestone/2) is planned for release after `Zig 0.17.0` is available. You can view the [roadmap](https://github.com/ziex-dev/ziex/milestone) to learn more.
 
-The `0.1.0` release will indicate that Ziex is production-ready, with all major features fully implemented, and will receive patch releases for bug fixes.
+[Ziex 0.1.0](https://github.com/ziex-dev/ziex/milestone/2) is planned for release after `Zig 0.17.0` is available. You can view the [roadmap](https://github.com/ziex-dev/ziex/milestones) to learn more.
+
+The [`0.1.0`](https://github.com/ziex-dev/ziex/milestone/2) release will indicate that Ziex is production-ready, with all major features fully implemented, and will receive patch releases for bug fixes.
 
-The `1.0.0` release will signify long-term support for that major version, receiving bug fixes and minor updates.
+The [`1.0.0`](https://github.com/ziex-dev/ziex/milestone/6) release will signify long-term support for that major version, receiving bug fixes and minor updates.
 
 ## Editor Support
 
-* [VSCode](https://marketplace.visualstudio.com/items?itemName=ziex.ziex)/[VSCode Forks](https://open-vsx.org/extension/ziex/ziex)
-* [Neovim](/ide/neovim/)
-* [Helix](/ide/helix/)
-* [Zed](/ide/zed/)
+- [VSCode](https://marketplace.visualstudio.com/items?itemName=ziex.ziex)/[VSCode Forks](https://open-vsx.org/extension/ziex/ziex)
+- [Neovim](/ide/neovim/)
+- [Helix](/ide/helix/)
+- [Zed](/ide/zed/)
 
 ## Community
 

package/cloudflare/index.js

@@ -193,6 +193,76 @@ class ZigJS {
     return decoder.decode(data);
   }
 }
+// src/fetch.ts
+function createFetchImports(getMemory) {
+  const encoder2 = new TextEncoder;
+  const decoder2 = new TextDecoder;
+  function readStr(ptr, len) {
+    return decoder2.decode(new Uint8Array(getMemory().buffer, ptr, len));
+  }
+  function writeBytes(buf_ptr, buf_max, data) {
+    if (data.length > buf_max)
+      return -2;
+    new Uint8Array(getMemory().buffer, buf_ptr, data.length).set(data);
+    return data.length;
+  }
+  function readBytes(ptr, len) {
+    return new Uint8Array(getMemory().buffer, ptr, len);
+  }
+  function parseHeaders(headersJson) {
+    let headers = {};
+    try {
+      headers = JSON.parse(headersJson);
+    } catch {
+      for (const line of headersJson.split(`
+`)) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx > 0) {
+          headers[line.slice(0, colonIdx)] = line.slice(colonIdx + 1);
+        }
+      }
+    }
+    return headers;
+  }
+  async function doFetch(url_ptr, url_len, method_ptr, method_len, headers_ptr, headers_len, body_ptr, body_len, timeout_ms, status_out, buf_ptr, buf_max) {
+    const url = readStr(url_ptr, url_len);
+    const method = method_len > 0 ? readStr(method_ptr, method_len) : "GET";
+    const headersJson = headers_len > 0 ? readStr(headers_ptr, headers_len) : "{}";
+    const body = body_len > 0 ? readBytes(body_ptr, body_len) : undefined;
+    const headers = parseHeaders(headersJson);
+    const controller = new AbortController;
+    const timeout = timeout_ms > 0 ? setTimeout(() => controller.abort(), timeout_ms) : null;
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: Object.keys(headers).length > 0 ? headers : undefined,
+        body: method !== "GET" && method !== "HEAD" ? body : undefined,
+        signal: controller.signal
+      });
+      if (timeout)
+        clearTimeout(timeout);
+      new DataView(getMemory().buffer).setUint16(status_out, response.status, true);
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      return writeBytes(buf_ptr, buf_max, bytes);
+    } catch (err) {
+      if (timeout)
+        clearTimeout(timeout);
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`wasm fetch failed: ${url} (${msg})`);
+      return -1;
+    }
+  }
+  const Suspending = WebAssembly.Suspending;
+  if (typeof Suspending !== "function") {
+    return {
+      fetch: (_url_ptr, _url_len, _method_ptr, _method_len, _headers_ptr, _headers_len, _body_ptr, _body_len, _timeout_ms, _status_out, _buf_ptr, _buf_max) => -1
+    };
+  }
+  return {
+    fetch: new Suspending(doFetch)
+  };
+}
+
 // src/wasm/core.ts
 var CallbackType = {
   Event: 0,
@@ -291,7 +361,7 @@ class ZxBridgeCore {
     const url = readString(urlPtr, urlLen);
     const method = methodLen > 0 ? readString(methodPtr, methodLen) : "GET";
     const headersJson = headersLen > 0 ? readString(headersPtr, headersLen) : "{}";
-    const body = bodyLen > 0 ? readString(bodyPtr, bodyLen) : undefined;
+    const body = bodyLen > 0 ? getMemoryView().subarray(bodyPtr, bodyPtr + bodyLen) : undefined;
     let headers = {};
     try {
       headers = JSON.parse(headersJson);
@@ -315,8 +385,8 @@ class ZxBridgeCore {
     fetch(url, fetchOptions).then(async (response) => {
       if (timeout)
         clearTimeout(timeout);
-      const text = await response.text();
-      this._notifyFetchComplete(fetchId, response.status, text, false);
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      this._notifyFetchComplete(fetchId, response.status, bytes, false);
     }).catch((error) => {
       if (timeout)
         clearTimeout(timeout);
@@ -327,7 +397,7 @@ class ZxBridgeCore {
   }
   _notifyFetchComplete(fetchId, statusCode, body, isError) {
     const handler = this.#fetchCompleteHandler;
-    const encoded = textEncoder.encode(body);
+    const encoded = typeof body === "string" ? textEncoder.encode(body) : body;
     const ptr = this._alloc(encoded.length);
     writeBytes(ptr, encoded);
     invokeWasmExport(handler, fetchId, statusCode, ptr, encoded.length, isError ? 1 : 0);
@@ -384,6 +454,11 @@ class ZxBridgeCore {
   static createImportObject(bridgeRef) {
     return {
       ...jsz.importObject(),
+      __zx_net: createFetchImports(() => {
+        if (!jsz.memory)
+          throw new Error("WASM memory is not ready");
+        return jsz.memory;
+      }),
       __zx: {
         _log: (level, ptr, len) => ZxBridgeCore.log(level, ptr, len),
         _fetchAsync: (urlPtr, urlLen, methodPtr, methodLen, headersPtr, headersLen, bodyPtr, bodyLen, timeoutMs, fetchId) => {
@@ -408,20 +483,48 @@ __export(exports_kv, {
   createMemoryKV: () => createMemoryKV,
   createKVImports: () => createKVImports
 });
+function putOptions(ttlSeconds) {
+  if (ttlSeconds < 60)
+    return;
+  return { expirationTtl: ttlSeconds };
+}
 function createMemoryKV() {
   const store = new Map;
+  function read(key) {
+    const entry = store.get(key);
+    if (!entry)
+      return null;
+    if (entry.expiresAt !== undefined && Date.now() >= entry.expiresAt) {
+      store.delete(key);
+      return null;
+    }
+    return entry.value;
+  }
+  function write(key, value, options) {
+    let expiresAt;
+    if (options?.expiration !== undefined) {
+      expiresAt = options.expiration * 1000;
+    } else if (options?.expirationTtl !== undefined) {
+      expiresAt = Date.now() + options.expirationTtl * 1000;
+    }
+    store.set(key, { value, expiresAt });
+  }
   return {
     async get(key) {
-      return store.get(key) ?? null;
+      return read(key);
     },
-    async put(key, value) {
-      store.set(key, value);
+    async put(key, value, options) {
+      write(key, value, options);
     },
     async delete(key) {
       store.delete(key);
     },
     async list(options) {
-      const keys = [...store.keys()].filter((k) => !options?.prefix || k.startsWith(options.prefix)).map((name) => ({ name }));
+      const keys = [...store.keys()].filter((k) => {
+        if (options?.prefix && !k.startsWith(options.prefix))
+          return false;
+        return read(k) !== null;
+      }).map((name) => ({ name }));
       return { keys };
     }
   };
@@ -461,11 +564,11 @@ function createKVImports(bindings, getMemory) {
           return -1;
         return writeBytes2(buf_ptr, buf_max, encoder2.encode(value));
       },
-      kv_put: (ns_ptr, ns_len, key_ptr, key_len, val_ptr, val_len) => {
+      kv_put: (ns_ptr, ns_len, key_ptr, key_len, val_ptr, val_len, ttl_seconds) => {
         const b = syncBinding(readStr(ns_ptr, ns_len));
         if (!b)
           return 0;
-        b.putSync(readStr(key_ptr, key_len), readStr(val_ptr, val_len));
+        b.putSync(readStr(key_ptr, key_len), readStr(val_ptr, val_len), putOptions(ttl_seconds));
         return 0;
       },
       kv_delete: (ns_ptr, ns_len, key_ptr, key_len) => {
@@ -495,11 +598,11 @@ function createKVImports(bindings, getMemory) {
         return -1;
       return writeBytes2(buf_ptr, buf_max, encoder2.encode(value));
     }),
-    kv_put: new Suspending(async (ns_ptr, ns_len, key_ptr, key_len, val_ptr, val_len) => {
+    kv_put: new Suspending(async (ns_ptr, ns_len, key_ptr, key_len, val_ptr, val_len, ttl_seconds) => {
       const b = binding(readStr(ns_ptr, ns_len));
       if (!b)
         return -1;
-      await b.put(readStr(key_ptr, key_len), readStr(val_ptr, val_len));
+      await b.put(readStr(key_ptr, key_len), readStr(val_ptr, val_len), putOptions(ttl_seconds));
       return 0;
     }),
     kv_delete: new Suspending(async (ns_ptr, ns_len, key_ptr, key_len) => {
@@ -793,6 +896,11 @@ class ZxBridge extends ZxBridgeCore {
   static createImportObject(bridgeRef) {
     return {
       ...jsz.importObject(),
+      __zx_net: createFetchImports(() => {
+        if (!jsz.memory)
+          throw new Error("WASM memory is not ready");
+        return jsz.memory;
+      }),
       __zx: {
         _log: (level, ptr, len) => ZxBridgeCore.log(level, ptr, len),
         _setEventHandlerMode: (vnodeId, eventTypeId, maySuspend) => {
@@ -1325,7 +1433,7 @@ class ZxWasiBridge {
     const url = this.#readString(urlPtr, urlLen);
     const method = methodLen > 0 ? this.#readString(methodPtr, methodLen) : "GET";
     const headersJson = headersLen > 0 ? this.#readString(headersPtr, headersLen) : "{}";
-    const body = bodyLen > 0 ? this.#readString(bodyPtr, bodyLen) : undefined;
+    const body = bodyLen > 0 ? this.#view().subarray(bodyPtr, bodyPtr + bodyLen) : undefined;
     let headers = {};
     try {
       headers = JSON.parse(headersJson);
@@ -1347,7 +1455,8 @@ class ZxWasiBridge {
     }).then(async (res) => {
       if (timeout)
         clearTimeout(timeout);
-      this.#notifyFetchComplete(fetchId, res.status, await res.text(), false);
+      const bytes = new Uint8Array(await res.arrayBuffer());
+      this.#notifyFetchComplete(fetchId, res.status, bytes, false);
     }).catch((err) => {
       if (timeout)
         clearTimeout(timeout);
@@ -1356,7 +1465,7 @@ class ZxWasiBridge {
     });
   }
   #notifyFetchComplete(fetchId, status, body, isError) {
-    const encoded = encoder2.encode(body);
+    const encoded = typeof body === "string" ? encoder2.encode(body) : body;
     const ptr = this.#alloc(encoded.length);
     this.#writeBytes(ptr, encoded);
     this.#fetchCompleteHandler(fetchId, status, ptr, encoded.length, isError ? 1 : 0);
@@ -1563,7 +1672,9 @@ function createWasiImports({
     "--method",
     request.method,
     "--search",
-    url.search
+    url.search,
+    "--url",
+    url.href
   ];
   request.headers.forEach((value, name) => {
     if (value)
@@ -1585,7 +1696,7 @@ function createWasiImports({
 `);
     stderrPartial = lines.pop() ?? "";
     for (const line of lines) {
-      if (line.startsWith("__EDGE_META__:")) {
+      if (line.startsWith("__ZIEX_META__:")) {
         stderrMeta += line + `
 `;
       } else if (line.length > 0) {
@@ -1817,7 +1928,7 @@ function createWasiImports({
     const remaining = stderrDecoder.decode(undefined, { stream: false });
     const tail = stderrPartial + remaining;
     if (tail.length > 0) {
-      if (tail.startsWith("__EDGE_META__:"))
+      if (tail.startsWith("__ZIEX_META__:"))
         stderrMeta += tail;
       else
         console.error("[ziex]", tail);
@@ -1949,9 +2060,9 @@ function executeWasm(instance, jspi, Suspending, wsState) {
     }
   });
 }
-function parseEdgeMeta(stderrText) {
+function parseZiexMeta(stderrText) {
   const meta = { status: 200, headers: new Headers, streaming: false };
-  const metaPrefix = "__EDGE_META__:";
+  const metaPrefix = "__ZIEX_META__:";
   const metaLine = stderrText.split(`
 `).find((line) => line.startsWith(metaPrefix));
   if (metaLine) {
@@ -2016,6 +2127,7 @@ async function run({
     __zx_ws: buildWsImports(jspi ? Suspending : null, mem, new TextDecoder, wsState),
     __zx_kv: createKVImports(kvBindings ?? { default: createMemoryKV() }, mem),
     __zx_db: createD1Imports(dbBindings ?? {}, mem),
+    __zx_net: createFetchImports(mem),
     ...imports ? imports(mem) : {},
     ...ZxWasiBridge.createImportObject(bridgeRef)
   });
@@ -2029,7 +2141,7 @@ async function run({
     return new Response(null, { status: 101, webSocket: server.client });
   }
   const { stderrText: earlyStderrText } = collectOutput();
-  const earlyMeta = parseEdgeMeta(earlyStderrText);
+  const earlyMeta = parseZiexMeta(earlyStderrText);
   if (earlyMeta.streaming) {
     const { readable, writable } = new TransformStream;
     streamWriter = writable.getWriter();
@@ -2041,9 +2153,14 @@ async function run({
   }
   await wasmPromise;
   const { stderrText } = collectOutput();
-  const meta = parseEdgeMeta(stderrText);
+  const meta = parseZiexMeta(stderrText);
   const body = mergeUint8Arrays(stdoutChunks);
   meta.headers.delete("transfer-encoding");
+  const nullBody = meta.status === 101 || meta.status === 204 || meta.status === 205 || meta.status === 304;
+  if (nullBody) {
+    meta.headers.delete("content-length");
+    return new Response(null, { status: meta.status, headers: meta.headers });
+  }
   if (!meta.headers.has("content-length"))
     meta.headers.set("content-length", String(body.byteLength));
   return new Response(body.buffer, { status: meta.status, headers: meta.headers });
@@ -2190,6 +2307,7 @@ function createWebSocketDO(module, options) {
         __zx_ws: wsImports,
         __zx_kv: createKVImports(kvBindings ?? { default: createMemoryKV() }, mem),
         __zx_db: createD1Imports(dbBindings ?? {}, mem),
+        __zx_net: createFetchImports(mem),
         ...options?.imports ? options.imports(mem) : {},
         ...bridgeImports
       });

package/index.js

@@ -74,7 +74,7 @@ class ZxWasiBridge {
     const url = this.#readString(urlPtr, urlLen);
     const method = methodLen > 0 ? this.#readString(methodPtr, methodLen) : "GET";
     const headersJson = headersLen > 0 ? this.#readString(headersPtr, headersLen) : "{}";
-    const body = bodyLen > 0 ? this.#readString(bodyPtr, bodyLen) : undefined;
+    const body = bodyLen > 0 ? this.#view().subarray(bodyPtr, bodyPtr + bodyLen) : undefined;
     let headers = {};
     try {
       headers = JSON.parse(headersJson);
@@ -96,7 +96,8 @@ class ZxWasiBridge {
     }).then(async (res) => {
       if (timeout)
         clearTimeout(timeout);
-      this.#notifyFetchComplete(fetchId, res.status, await res.text(), false);
+      const bytes = new Uint8Array(await res.arrayBuffer());
+      this.#notifyFetchComplete(fetchId, res.status, bytes, false);
     }).catch((err) => {
       if (timeout)
         clearTimeout(timeout);
@@ -105,7 +106,7 @@ class ZxWasiBridge {
     });
   }
   #notifyFetchComplete(fetchId, status, body, isError) {
-    const encoded = encoder.encode(body);
+    const encoded = typeof body === "string" ? encoder.encode(body) : body;
     const ptr = this.#alloc(encoded.length);
     this.#writeBytes(ptr, encoded);
     this.#fetchCompleteHandler(fetchId, status, ptr, encoded.length, isError ? 1 : 0);
@@ -153,20 +154,48 @@ __export(exports_kv, {
   createMemoryKV: () => createMemoryKV,
   createKVImports: () => createKVImports
 });
+function putOptions(ttlSeconds) {
+  if (ttlSeconds < 60)
+    return;
+  return { expirationTtl: ttlSeconds };
+}
 function createMemoryKV() {
   const store = new Map;
+  function read(key) {
+    const entry = store.get(key);
+    if (!entry)
+      return null;
+    if (entry.expiresAt !== undefined && Date.now() >= entry.expiresAt) {
+      store.delete(key);
+      return null;
+    }
+    return entry.value;
+  }
+  function write(key, value, options) {
+    let expiresAt;
+    if (options?.expiration !== undefined) {
+      expiresAt = options.expiration * 1000;
+    } else if (options?.expirationTtl !== undefined) {
+      expiresAt = Date.now() + options.expirationTtl * 1000;
+    }
+    store.set(key, { value, expiresAt });
+  }
   return {
     async get(key) {
-      return store.get(key) ?? null;
+      return read(key);
     },
-    async put(key, value) {
-      store.set(key, value);
+    async put(key, value, options) {
+      write(key, value, options);
     },
     async delete(key) {
       store.delete(key);
     },
     async list(options) {
-      const keys = [...store.keys()].filter((k) => !options?.prefix || k.startsWith(options.prefix)).map((name) => ({ name }));
+      const keys = [...store.keys()].filter((k) => {
+        if (options?.prefix && !k.startsWith(options.prefix))
+          return false;
+        return read(k) !== null;
+      }).map((name) => ({ name }));
       return { keys };
     }
   };
@@ -206,11 +235,11 @@ function createKVImports(bindings, getMemory) {
           return -1;
         return writeBytes(buf_ptr, buf_max, encoder2.encode(value));
       },
-      kv_put: (ns_ptr, ns_len, key_ptr, key_len, val_ptr, val_len) => {
+      kv_put: (ns_ptr, ns_len, key_ptr, key_len, val_ptr, val_len, ttl_seconds) => {
         const b = syncBinding(readStr(ns_ptr, ns_len));
         if (!b)
           return 0;
-        b.putSync(readStr(key_ptr, key_len), readStr(val_ptr, val_len));
+        b.putSync(readStr(key_ptr, key_len), readStr(val_ptr, val_len), putOptions(ttl_seconds));
         return 0;
       },
       kv_delete: (ns_ptr, ns_len, key_ptr, key_len) => {
@@ -240,11 +269,11 @@ function createKVImports(bindings, getMemory) {
         return -1;
       return writeBytes(buf_ptr, buf_max, encoder2.encode(value));
     }),
-    kv_put: new Suspending(async (ns_ptr, ns_len, key_ptr, key_len, val_ptr, val_len) => {
+    kv_put: new Suspending(async (ns_ptr, ns_len, key_ptr, key_len, val_ptr, val_len, ttl_seconds) => {
       const b = binding(readStr(ns_ptr, ns_len));
       if (!b)
         return -1;
-      await b.put(readStr(key_ptr, key_len), readStr(val_ptr, val_len));
+      await b.put(readStr(key_ptr, key_len), readStr(val_ptr, val_len), putOptions(ttl_seconds));
       return 0;
     }),
     kv_delete: new Suspending(async (ns_ptr, ns_len, key_ptr, key_len) => {
@@ -265,6 +294,76 @@ function createKVImports(bindings, getMemory) {
   };
 }
 
+// src/fetch.ts
+function createFetchImports(getMemory) {
+  const encoder2 = new TextEncoder;
+  const decoder2 = new TextDecoder;
+  function readStr(ptr, len) {
+    return decoder2.decode(new Uint8Array(getMemory().buffer, ptr, len));
+  }
+  function writeBytes(buf_ptr, buf_max, data) {
+    if (data.length > buf_max)
+      return -2;
+    new Uint8Array(getMemory().buffer, buf_ptr, data.length).set(data);
+    return data.length;
+  }
+  function readBytes(ptr, len) {
+    return new Uint8Array(getMemory().buffer, ptr, len);
+  }
+  function parseHeaders(headersJson) {
+    let headers = {};
+    try {
+      headers = JSON.parse(headersJson);
+    } catch {
+      for (const line of headersJson.split(`
+`)) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx > 0) {
+          headers[line.slice(0, colonIdx)] = line.slice(colonIdx + 1);
+        }
+      }
+    }
+    return headers;
+  }
+  async function doFetch(url_ptr, url_len, method_ptr, method_len, headers_ptr, headers_len, body_ptr, body_len, timeout_ms, status_out, buf_ptr, buf_max) {
+    const url = readStr(url_ptr, url_len);
+    const method = method_len > 0 ? readStr(method_ptr, method_len) : "GET";
+    const headersJson = headers_len > 0 ? readStr(headers_ptr, headers_len) : "{}";
+    const body = body_len > 0 ? readBytes(body_ptr, body_len) : undefined;
+    const headers = parseHeaders(headersJson);
+    const controller = new AbortController;
+    const timeout = timeout_ms > 0 ? setTimeout(() => controller.abort(), timeout_ms) : null;
+    try {
+      const response = await fetch(url, {
+        method,
+        headers: Object.keys(headers).length > 0 ? headers : undefined,
+        body: method !== "GET" && method !== "HEAD" ? body : undefined,
+        signal: controller.signal
+      });
+      if (timeout)
+        clearTimeout(timeout);
+      new DataView(getMemory().buffer).setUint16(status_out, response.status, true);
+      const bytes = new Uint8Array(await response.arrayBuffer());
+      return writeBytes(buf_ptr, buf_max, bytes);
+    } catch (err) {
+      if (timeout)
+        clearTimeout(timeout);
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`wasm fetch failed: ${url} (${msg})`);
+      return -1;
+    }
+  }
+  const Suspending = WebAssembly.Suspending;
+  if (typeof Suspending !== "function") {
+    return {
+      fetch: (_url_ptr, _url_len, _method_ptr, _method_len, _headers_ptr, _headers_len, _body_ptr, _body_len, _timeout_ms, _status_out, _buf_ptr, _buf_max) => -1
+    };
+  }
+  return {
+    fetch: new Suspending(doFetch)
+  };
+}
+
 // src/db.ts
 function decodeBlob(base64) {
   const binary = atob(base64);
@@ -430,7 +529,9 @@ function createWasiImports({
     "--method",
     request.method,
     "--search",
-    url.search
+    url.search,
+    "--url",
+    url.href
   ];
   request.headers.forEach((value, name) => {
     if (value)
@@ -452,7 +553,7 @@ function createWasiImports({
 `);
     stderrPartial = lines.pop() ?? "";
     for (const line of lines) {
-      if (line.startsWith("__EDGE_META__:")) {
+      if (line.startsWith("__ZIEX_META__:")) {
         stderrMeta += line + `
 `;
       } else if (line.length > 0) {
@@ -684,7 +785,7 @@ function createWasiImports({
     const remaining = stderrDecoder.decode(undefined, { stream: false });
     const tail = stderrPartial + remaining;
     if (tail.length > 0) {
-      if (tail.startsWith("__EDGE_META__:"))
+      if (tail.startsWith("__ZIEX_META__:"))
         stderrMeta += tail;
       else
         console.error("[ziex]", tail);
@@ -816,9 +917,9 @@ function executeWasm(instance, jspi, Suspending, wsState) {
     }
   });
 }
-function parseEdgeMeta(stderrText) {
+function parseZiexMeta(stderrText) {
   const meta = { status: 200, headers: new Headers, streaming: false };
-  const metaPrefix = "__EDGE_META__:";
+  const metaPrefix = "__ZIEX_META__:";
   const metaLine = stderrText.split(`
 `).find((line) => line.startsWith(metaPrefix));
   if (metaLine) {
@@ -883,6 +984,7 @@ async function run({
     __zx_ws: buildWsImports(jspi ? Suspending : null, mem, new TextDecoder, wsState),
     __zx_kv: createKVImports(kvBindings ?? { default: createMemoryKV() }, mem),
     __zx_db: createD1Imports(dbBindings ?? {}, mem),
+    __zx_net: createFetchImports(mem),
     ...imports ? imports(mem) : {},
     ...ZxWasiBridge.createImportObject(bridgeRef)
   });
@@ -896,7 +998,7 @@ async function run({
     return new Response(null, { status: 101, webSocket: server.client });
   }
   const { stderrText: earlyStderrText } = collectOutput();
-  const earlyMeta = parseEdgeMeta(earlyStderrText);
+  const earlyMeta = parseZiexMeta(earlyStderrText);
   if (earlyMeta.streaming) {
     const { readable, writable } = new TransformStream;
     streamWriter = writable.getWriter();
@@ -908,9 +1010,14 @@ async function run({
   }
   await wasmPromise;
   const { stderrText } = collectOutput();
-  const meta = parseEdgeMeta(stderrText);
+  const meta = parseZiexMeta(stderrText);
   const body = mergeUint8Arrays(stdoutChunks);
   meta.headers.delete("transfer-encoding");
+  const nullBody = meta.status === 101 || meta.status === 204 || meta.status === 205 || meta.status === 304;
+  if (nullBody) {
+    meta.headers.delete("content-length");
+    return new Response(null, { status: meta.status, headers: meta.headers });
+  }
   if (!meta.headers.has("content-length"))
     meta.headers.set("content-length", String(body.byteLength));
   return new Response(body.buffer, { status: meta.status, headers: meta.headers });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ziex",
-  "version": "0.1.0-dev.1309",
+  "version": "0.1.0-dev.1367",
   "description": "Ziex is a framework for building web applications with Zig.",
   "main": "index.js",
   "type": "module",
@@ -37,7 +37,7 @@
   "license": "MIT",
   "scripts": {},
   "dependencies": {
-    "@ziex/cli": "0.1.0-dev.1309"
+    "@ziex/cli": "0.1.0-dev.1367"
   },
   "peerDependenciesMeta": {
     "react": {

package/pkg/ziex/src/fetch.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Create a `fetch` import object for blocking WASM fetch via JSPI.
+ * When JSPI is unavailable the import always returns -1 (network error).
+ */
+export declare function createFetchImports(getMemory: () => WebAssembly.Memory): Record<string, unknown>;