goscript 0.2.2 → 0.2.4

package/gs/net/http/index.test.ts

@@ -20,6 +20,7 @@ import {
   ErrServerClosed,
   File,
   FileServer,
+  FileServerFS,
   FileSystem,
   FS,
   Get,
@@ -124,12 +125,16 @@ describe('net/http override', () => {
     expect(StatusText(StatusUnauthorized)).toBe('Unauthorized')
     expect(StatusText(StatusForbidden)).toBe('Forbidden')
     expect(StatusText(StatusMethodNotAllowed)).toBe('Method Not Allowed')
-    expect(StatusText(StatusUnsupportedMediaType)).toBe('Unsupported Media Type')
+    expect(StatusText(StatusUnsupportedMediaType)).toBe(
+      'Unsupported Media Type',
+    )
     expect(StatusText(StatusTeapot)).toBe("I'm a teapot")
     expect(StatusText(StatusTooManyRequests)).toBe('Too Many Requests')
     expect(StatusText(StatusBadGateway)).toBe('Bad Gateway')
     expect(StatusText(StatusServiceUnavailable)).toBe('Service Unavailable')
-    expect(StatusText(StatusNetworkAuthenticationRequired)).toBe('Network Authentication Required')
+    expect(StatusText(StatusNetworkAuthenticationRequired)).toBe(
+      'Network Authentication Required',
+    )
     expect(StatusText(599)).toBe('')
     Header_Set(resp.Header, 'X-Test', 'ok')
     resp.Body = io.NopCloser(bytes.NewReader($.stringToBytes('body')))
@@ -164,12 +169,18 @@ describe('net/http override', () => {
       'text/plain',
       'charset=utf-8',
     ])
-    expect(Array.from(Header_Values(cloned, 'Content-Type') ?? [])).toContain('copy')
-    expect(Array.from(Header_Values(header, 'Content-Type') ?? [])).not.toContain('copy')
+    expect(Array.from(Header_Values(cloned, 'Content-Type') ?? [])).toContain(
+      'copy',
+    )
+    expect(
+      Array.from(Header_Values(header, 'Content-Type') ?? []),
+    ).not.toContain('copy')
 
     const written = new bytes.Buffer()
     expect(Header_Write(header, written)).toBeNull()
-    expect(Buffer.from(written.Bytes()).toString('utf8')).toContain('Content-Type: text/plain\r\n')
+    expect(Buffer.from(written.Bytes()).toString('utf8')).toContain(
+      'Content-Type: text/plain\r\n',
+    )
 
     expect(ParseHTTPVersion('HTTP/2.0')).toEqual([2, 0, true])
     expect(ParseHTTPVersion('h2')).toEqual([0, 0, false])
@@ -182,6 +193,36 @@ describe('net/http override', () => {
     expect(protocols.String()).toBe('{HTTP1,UnencryptedHTTP2}')
   })
 
+  it('accepts pointer-wrapped headers from generated ResponseWriter methods', () => {
+    const header = varRef(new Header())
+
+    Header_Set(header, 'content-length', '12')
+    Header_Add(header, 'content-type', 'text/plain')
+
+    expect(Header_Get(header, 'Content-Length')).toBe('12')
+    expect(Array.from(Header_Values(header, 'Content-Type') ?? [])).toEqual([
+      'text/plain',
+    ])
+
+    const cloned = Header_Clone(header)
+    Header_Del(header, 'Content-Type')
+
+    expect(Header_Get(header, 'Content-Type')).toBe('')
+    expect(Header_Get(cloned, 'Content-Type')).toBe('text/plain')
+  })
+
+  it('accepts interface-boxed named headers from generated interface calls', () => {
+    const header = $.namedValueInterfaceValue(new Header(), 'http.Header', {})
+
+    Header_Set(header, 'content-length', '12')
+    Header_Add(header, 'content-type', 'text/plain')
+
+    expect(Header_Get(header, 'Content-Length')).toBe('12')
+    expect(Array.from(Header_Values(header, 'Content-Type') ?? [])).toEqual([
+      'text/plain',
+    ])
+  })
+
   it('validates outgoing request construction', () => {
     const [req, reqErr] = NewRequestWithContext(
       context.Background(),
@@ -195,22 +236,58 @@ describe('net/http override', () => {
     expect(req?.URL?.Path).toBe('/path')
     expect(req?.URL?.RawQuery).toBe('q=1')
 
-    expect(NewRequestWithContext(context.Background(), 'bad method', 'https://example.invalid/', null)[1]?.Error()).toBe(
-      'net/http: invalid method "bad method"',
-    )
-    expect(NewRequestWithContext(null, MethodGet, 'https://example.invalid/', null)[1]?.Error()).toBe(
-      'net/http: nil Context',
+    expect(
+      NewRequestWithContext(
+        context.Background(),
+        'bad method',
+        'https://example.invalid/',
+        null,
+      )[1]?.Error(),
+    ).toBe('net/http: invalid method "bad method"')
+    expect(
+      NewRequestWithContext(
+        null,
+        MethodGet,
+        'https://example.invalid/',
+        null,
+      )[1]?.Error(),
+    ).toBe('net/http: nil Context')
+    expect(
+      NewRequestWithContext(
+        context.Background(),
+        MethodGet,
+        'http://[::1',
+        null,
+      )[1],
+    ).not.toBeNull()
+    expect(
+      NewRequestWithContext(
+        context.Background(),
+        MethodGet,
+        'http://x/%zz',
+        null,
+      )[1],
+    ).not.toBeNull()
+
+    const [bodyReq, bodyReqErr] = NewRequest(
+      MethodPost,
+      'https://example.invalid/upload',
+      bytes.NewReader($.stringToBytes('abc')),
     )
-    expect(NewRequestWithContext(context.Background(), MethodGet, 'http://[::1', null)[1]).not.toBeNull()
-    expect(NewRequestWithContext(context.Background(), MethodGet, 'http://x/%zz', null)[1]).not.toBeNull()
-
-    const [bodyReq, bodyReqErr] = NewRequest(MethodPost, 'https://example.invalid/upload', bytes.NewReader($.stringToBytes('abc')))
     expect(bodyReqErr).toBeNull()
     expect(bodyReq?.ContentLength).toBe(3)
-    const [stringReq, stringReqErr] = NewRequest(MethodPost, 'https://example.invalid/upload', strings.NewReader('abcd'))
+    const [stringReq, stringReqErr] = NewRequest(
+      MethodPost,
+      'https://example.invalid/upload',
+      strings.NewReader('abcd'),
+    )
     expect(stringReqErr).toBeNull()
     expect(stringReq?.ContentLength).toBe(4)
-    const [noBodyReq, noBodyErr] = NewRequest(MethodPost, 'https://example.invalid/upload', NoBody)
+    const [noBodyReq, noBodyErr] = NewRequest(
+      MethodPost,
+      'https://example.invalid/upload',
+      NoBody,
+    )
     expect(noBodyErr).toBeNull()
     expect(noBodyReq?.ContentLength).toBe(0)
     expect(noBodyReq?.Body).toBe(NoBody)
@@ -218,44 +295,84 @@ describe('net/http override', () => {
 
   it('applies cross-origin protection checks', () => {
     const protection = NewCrossOriginProtection()
-    const [sameOrigin] = NewRequest(MethodPost, 'https://example.invalid/update', null)
+    const [sameOrigin] = NewRequest(
+      MethodPost,
+      'https://example.invalid/update',
+      null,
+    )
     Header_Set(sameOrigin!.Header, 'Sec-Fetch-Site', 'same-origin')
     expect(protection.Check(sameOrigin)).toBeNull()
 
-    const [noHeaders] = NewRequest(MethodPost, 'https://example.invalid/update', null)
+    const [noHeaders] = NewRequest(
+      MethodPost,
+      'https://example.invalid/update',
+      null,
+    )
     expect(protection.Check(noHeaders)).toBeNull()
 
-    const [safe] = NewRequest(MethodOptions, 'https://example.invalid/update', null)
+    const [safe] = NewRequest(
+      MethodOptions,
+      'https://example.invalid/update',
+      null,
+    )
     Header_Set(safe!.Header, 'Sec-Fetch-Site', 'cross-site')
     expect(protection.Check(safe)).toBeNull()
 
-    const [matchingOrigin] = NewRequest(MethodPost, 'https://example.invalid/update', null)
+    const [matchingOrigin] = NewRequest(
+      MethodPost,
+      'https://example.invalid/update',
+      null,
+    )
     Header_Set(matchingOrigin!.Header, 'Origin', 'https://example.invalid')
     expect(protection.Check(matchingOrigin)).toBeNull()
 
-    const [crossSite] = NewRequest(MethodPost, 'https://example.invalid/update', null)
+    const [crossSite] = NewRequest(
+      MethodPost,
+      'https://example.invalid/update',
+      null,
+    )
     Header_Set(crossSite!.Header, 'Sec-Fetch-Site', 'cross-site')
     expect(protection.Check(crossSite)?.Error()).toContain('Sec-Fetch-Site')
 
-    const [oldBrowser] = NewRequest(MethodPost, 'https://example.invalid/update', null)
+    const [oldBrowser] = NewRequest(
+      MethodPost,
+      'https://example.invalid/update',
+      null,
+    )
     Header_Set(oldBrowser!.Header, 'Origin', 'https://attacker.invalid')
-    expect(protection.Check(oldBrowser)?.Error()).toContain('Origin does not match Host')
+    expect(protection.Check(oldBrowser)?.Error()).toContain(
+      'Origin does not match Host',
+    )
 
     expect(protection.AddTrustedOrigin('https://trusted.invalid')).toBeNull()
-    expect(protection.AddTrustedOrigin('https://trusted.invalid/')).not.toBeNull()
-    const [trusted] = NewRequest(MethodPost, 'https://example.invalid/update', null)
+    expect(
+      protection.AddTrustedOrigin('https://trusted.invalid/'),
+    ).not.toBeNull()
+    const [trusted] = NewRequest(
+      MethodPost,
+      'https://example.invalid/update',
+      null,
+    )
     Header_Set(trusted!.Header, 'Origin', 'https://trusted.invalid')
     Header_Set(trusted!.Header, 'Sec-Fetch-Site', 'cross-site')
     expect(protection.Check(trusted)).toBeNull()
 
     protection.AddInsecureBypassPattern('/bypass/')
     protection.AddInsecureBypassPattern('POST /post-only/')
-    const [bypass] = NewRequest(MethodPost, 'https://example.invalid/bypass/ok', null)
+    const [bypass] = NewRequest(
+      MethodPost,
+      'https://example.invalid/bypass/ok',
+      null,
+    )
     Header_Set(bypass!.Header, 'Origin', 'https://attacker.invalid')
     Header_Set(bypass!.Header, 'Sec-Fetch-Site', 'cross-site')
     expect(protection.Check(bypass)).toBeNull()
 
-    const [methodBypass] = NewRequest(MethodPost, 'https://example.invalid/post-only/', null)
+    const [methodBypass] = NewRequest(
+      MethodPost,
+      'https://example.invalid/post-only/',
+      null,
+    )
     Header_Set(methodBypass!.Header, 'Origin', 'https://attacker.invalid')
     expect(protection.Check(methodBypass)).toBeNull()
   })
@@ -269,7 +386,11 @@ describe('net/http override', () => {
         w?.WriteHeader(StatusOK)
       },
     })
-    const [blocked] = NewRequest(MethodPost, 'https://example.invalid/update', null)
+    const [blocked] = NewRequest(
+      MethodPost,
+      'https://example.invalid/update',
+      null,
+    )
     Header_Set(blocked!.Header, 'Sec-Fetch-Site', 'cross-site')
     const blockedWriter = new testResponseWriter()
 
@@ -304,7 +425,9 @@ describe('net/http override', () => {
     expect(cookies?.[1]?.Value).toBe('v2')
 
     expect(ParseCookie('')[1]?.Error()).toBe('http: blank cookie')
-    expect(ParseCookie('missing-equals')[1]?.Error()).toBe("http: '=' not found in cookie")
+    expect(ParseCookie('missing-equals')[1]?.Error()).toBe(
+      "http: '=' not found in cookie",
+    )
     expect(ParseCookie('=v1')[1]?.Error()).toBe('http: invalid cookie name')
     expect(ParseCookie('k1=\\')[1]?.Error()).toBe('http: invalid cookie value')
 
@@ -330,9 +453,13 @@ describe('net/http override', () => {
     expect(spaced?.Quoted).toBe(true)
 
     expect(ParseSetCookie('')[1]?.Error()).toBe('http: blank cookie')
-    expect(ParseSetCookie('missing-equals')[1]?.Error()).toBe("http: '=' not found in cookie")
+    expect(ParseSetCookie('missing-equals')[1]?.Error()).toBe(
+      "http: '=' not found in cookie",
+    )
     expect(ParseSetCookie('=v1')[1]?.Error()).toBe('http: invalid cookie name')
-    expect(ParseSetCookie('k1=\\')[1]?.Error()).toBe('http: invalid cookie value')
+    expect(ParseSetCookie('k1=\\')[1]?.Error()).toBe(
+      'http: invalid cookie value',
+    )
   })
 
   it('exports no-body, limit-reader, and unsupported controller surfaces', async () => {
@@ -342,34 +469,48 @@ describe('net/http override', () => {
     expect(err).toBe(io.EOF)
     expect(NoBody.Close()).toBeNull()
 
-    const limited = MaxBytesReader(null, {
-      Read: (p: Uint8Array) => {
-        p[0] = 1
-        if (p.length > 1) {
-          p[1] = 2
-        }
-        return [1, null]
+    const limited = MaxBytesReader(
+      null,
+      {
+        Read: (p: Uint8Array) => {
+          p[0] = 1
+          if (p.length > 1) {
+            p[1] = 2
+          }
+          return [1, null]
+        },
+        Close: () => null,
       },
-      Close: () => null,
-    }, 1)
+      1,
+    )
     const limitedBuf = new Uint8Array(2)
     expect(limited.Read(limitedBuf)).toEqual([1, null])
     expect(limitedBuf[0]).toBe(1)
     const [, limitErr] = limited.Read(new Uint8Array(1))
     expect(limitErr).toBeInstanceOf(MaxBytesError)
 
-    const exactReader = MaxBytesReader(null, io.NopCloser(bytes.NewReader($.stringToBytes('ok'))), 2)
+    const exactReader = MaxBytesReader(
+      null,
+      io.NopCloser(bytes.NewReader($.stringToBytes('ok'))),
+      2,
+    )
     const [exactData, exactErr] = await io.ReadAll(exactReader)
     expect(exactErr).toBeNull()
     expect(Buffer.from(exactData ?? []).toString('utf8')).toBe('ok')
 
-    const tooLarge = MaxBytesReader(null, io.NopCloser(bytes.NewReader($.stringToBytes('toolarge'))), 2)
+    const tooLarge = MaxBytesReader(
+      null,
+      io.NopCloser(bytes.NewReader($.stringToBytes('toolarge'))),
+      2,
+    )
     const tooLargeBuf = new Uint8Array(8)
     const [tooLargeN, tooLargeErr] = tooLarge.Read(tooLargeBuf)
     expect(tooLargeN).toBe(2)
     expect(tooLargeErr).toBeInstanceOf(MaxBytesError)
     expect((tooLargeErr as MaxBytesError).Limit).toBe(2)
-    expect(Buffer.from(tooLargeBuf.slice(0, tooLargeN)).toString('utf8')).toBe('to')
+    expect(Buffer.from(tooLargeBuf.slice(0, tooLargeN)).toString('utf8')).toBe(
+      'to',
+    )
 
     const controller = NewResponseController(null)
     expect(controller.Hijack()[2]).toBe(ErrNotSupported)
@@ -382,12 +523,15 @@ describe('net/http override', () => {
     const body = io.NopCloser(bytes.NewReader($.stringToBytes('ok')))
     const [req] = NewRequest(MethodPost, 'http://example.invalid/upload', body)
     let servedReq: any = null
-    const handler = MaxBytesHandler({
-      ServeHTTP(_w, r) {
-        servedReq = $.pointerValue(r)
-        Header_Set(servedReq.Header, 'X-Shared', 'true')
+    const handler = MaxBytesHandler(
+      {
+        ServeHTTP(_w, r) {
+          servedReq = $.pointerValue(r)
+          Header_Set(servedReq.Header, 'X-Shared', 'true')
+        },
       },
-    }, 1)
+      1,
+    )
 
     handler.ServeHTTP(null, req)
 
@@ -424,7 +568,11 @@ describe('net/http override', () => {
         throw new Error('network down')
       },
     })
-    const [req, reqErr] = NewRequest(MethodPost, 'https://example.invalid', null)
+    const [req, reqErr] = NewRequest(
+      MethodPost,
+      'https://example.invalid',
+      null,
+    )
     expect(reqErr).toBeNull()
     expect((req!.URL as any).Path).toBe('/')
     expect(req!.Host).toBe('example.invalid')
@@ -440,13 +588,21 @@ describe('net/http override', () => {
       Read: (p: Uint8Array) => [p.length, null] as [number, null],
     }
 
-    const [req, reqErr] = NewRequest(MethodPost, 'https://example.invalid/upload', reader)
+    const [req, reqErr] = NewRequest(
+      MethodPost,
+      'https://example.invalid/upload',
+      reader,
+    )
 
     expect(reqErr).toBeNull()
     expect(req!.Body).not.toBeNull()
     expect(req!.Body!.Close()).toBeNull()
 
-    const resp = new Response({ StatusCode: StatusCreated, ContentLength: -1, Request: varRef(req!) })
+    const resp = new Response({
+      StatusCode: StatusCreated,
+      ContentLength: -1,
+      Request: varRef(req!),
+    })
     expect(resp.ContentLength).toBe(-1)
     expect((resp.Request as any).value).toBe(req)
   })
@@ -462,7 +618,9 @@ describe('net/http override', () => {
         const headers = init?.headers as Headers
         expect(headers.get('Range')).toBe('bytes=0-9')
         expect(headers.get('Authorization')).toBe('Bearer test')
-        expect(Buffer.from((init?.body as Uint8Array) ?? []).toString('utf8')).toBe('payload')
+        expect(
+          Buffer.from((init?.body as Uint8Array) ?? []).toString('utf8'),
+        ).toBe('payload')
         return new globalThis.Response('accepted', {
           status: StatusCreated,
           statusText: 'Created',
@@ -478,7 +636,11 @@ describe('net/http override', () => {
         return null
       },
     }
-    const [req] = NewRequest(MethodPost, 'https://example.invalid/upload', requestBody)
+    const [req] = NewRequest(
+      MethodPost,
+      'https://example.invalid/upload',
+      requestBody,
+    )
     Header_Set(req!.Header, 'Range', 'bytes=0-9')
     Header_Set(req!.Header, 'Authorization', 'Bearer test')
 
@@ -491,6 +653,135 @@ describe('net/http override', () => {
     expect(requestBodyClosed).toBe(true)
   })
 
+  it('returns from fetch-backed RoundTrip after response headers', async () => {
+    let arrayBufferCalled = false
+    Object.defineProperty(globalThis, 'fetch', {
+      configurable: true,
+      writable: true,
+      value: async () => {
+        const response = new globalThis.Response(null, {
+          status: StatusOK,
+          statusText: 'OK',
+          headers: { 'Content-Length': '5' },
+        })
+        Object.defineProperty(response, 'arrayBuffer', {
+          configurable: true,
+          value: () => {
+            arrayBufferCalled = true
+            return new Promise<ArrayBuffer>(() => {})
+          },
+        })
+        return response
+      },
+    })
+    const [req] = NewRequest(MethodPost, 'https://example.invalid/upload', null)
+
+    const [resp, err] = await Promise.race([
+      DefaultTransport.RoundTrip(req),
+      new Promise<never>((_, reject) =>
+        setTimeout(() => reject(new Error('RoundTrip did not return')), 25),
+      ),
+    ])
+
+    expect(err).toBeNull()
+    expect(resp?.StatusCode).toBe(StatusOK)
+    expect(resp?.ContentLength).toBe(5)
+    expect(arrayBufferCalled).toBe(false)
+    expect(resp?.Body?.Close()).toBeNull()
+  })
+
+  it('reads fetch-backed response bodies after RoundTrip returns', async () => {
+    Object.defineProperty(globalThis, 'fetch', {
+      configurable: true,
+      writable: true,
+      value: async () =>
+        new globalThis.Response('accepted', {
+          status: StatusCreated,
+          statusText: 'Created',
+          headers: { 'Content-Length': '8' },
+        }),
+    })
+    const [req] = NewRequest(MethodPost, 'https://example.invalid/upload', null)
+
+    const [resp, err] = await DefaultTransport.RoundTrip(req)
+    const buf = new Uint8Array(16)
+    const [n, readErr] = await (resp!.Body!.Read(buf) as any)
+
+    expect(err).toBeNull()
+    expect(readErr).toBeNull()
+    expect(n).toBe(8)
+    expect(Buffer.from(buf.subarray(0, n)).toString('utf8')).toBe('accepted')
+    expect(resp?.Body?.Close()).toBeNull()
+  })
+
+  it('aborts pending fetches when the request context is canceled', async () => {
+    let fetchSignal: AbortSignal | undefined
+    let fetchStarted: (() => void) | null = null
+    const fetchStartedPromise = new Promise<void>((resolve) => {
+      fetchStarted = resolve
+    })
+    Object.defineProperty(globalThis, 'fetch', {
+      configurable: true,
+      writable: true,
+      value: async (_input: RequestInfo | URL, init?: RequestInit) => {
+        fetchSignal = init?.signal ?? undefined
+        fetchStarted?.()
+        return new Promise<globalThis.Response>((_resolve, reject) => {
+          fetchSignal?.addEventListener('abort', () => {
+            reject(new Error('aborted'))
+          })
+        })
+      },
+    })
+    const [ctx, cancel] = context.WithCancel(context.Background())
+    const [req] = NewRequest(MethodPost, 'https://example.invalid/upload', null)
+
+    const roundTrip = DefaultTransport.RoundTrip(req!.WithContext(ctx))
+    await fetchStartedPromise
+    cancel?.()
+    const [resp, err] = await roundTrip
+
+    expect(resp).toBeNull()
+    expect(err).toBe(context.Canceled)
+    expect(fetchSignal?.aborted).toBe(true)
+  })
+
+  it('aborts pending fetch body reads when the request context is canceled', async () => {
+    let fetchSignal: AbortSignal | undefined
+    Object.defineProperty(globalThis, 'fetch', {
+      configurable: true,
+      writable: true,
+      value: async (_input: RequestInfo | URL, init?: RequestInit) => {
+        fetchSignal = init?.signal ?? undefined
+        const response = new globalThis.Response(null, { status: StatusOK })
+        Object.defineProperty(response, 'arrayBuffer', {
+          configurable: true,
+          value: () =>
+            new Promise<ArrayBuffer>((_resolve, reject) => {
+              fetchSignal?.addEventListener('abort', () => {
+                reject(new Error('body aborted'))
+              })
+            }),
+        })
+        return response
+      },
+    })
+    const [ctx, cancel] = context.WithCancel(context.Background())
+    const [req] = NewRequest(MethodPost, 'https://example.invalid/upload', null)
+
+    const [resp, roundTripErr] = await DefaultTransport.RoundTrip(
+      req!.WithContext(ctx),
+    )
+    const read = resp!.Body!.Read(new Uint8Array(8)) as any
+    cancel?.()
+    const [n, readErr] = await read
+
+    expect(roundTripErr).toBeNull()
+    expect(n).toBe(0)
+    expect(readErr).toBe(context.Canceled)
+    expect(fetchSignal?.aborted).toBe(true)
+  })
+
   it('closes request bodies when fetch body reads fail', async () => {
     let requestBodyClosed = false
     Object.defineProperty(globalThis, 'fetch', {
@@ -523,15 +814,20 @@ describe('net/http override', () => {
       writable: true,
       value: undefined,
     })
-    const [unsupportedReq] = NewRequest(MethodPost, 'https://example.invalid/upload', {
-      Read: () => [0, null],
-      Close: () => {
-        unsupportedClosed = true
-        return null
+    const [unsupportedReq] = NewRequest(
+      MethodPost,
+      'https://example.invalid/upload',
+      {
+        Read: () => [0, null],
+        Close: () => {
+          unsupportedClosed = true
+          return null
+        },
       },
-    })
+    )
 
-    const [unsupportedResp, unsupportedErr] = await DefaultTransport.RoundTrip(unsupportedReq)
+    const [unsupportedResp, unsupportedErr] =
+      await DefaultTransport.RoundTrip(unsupportedReq)
 
     expect(unsupportedResp).toBeNull()
     expect(unsupportedErr?.Error()).toContain('Client.Do is not implemented')
@@ -547,15 +843,21 @@ describe('net/http override', () => {
     })
     const [ctx, cancel] = context.WithCancel(context.Background())
     cancel?.()
-    const [canceledReq] = NewRequest(MethodPost, 'https://example.invalid/upload', {
-      Read: () => [0, null],
-      Close: () => {
-        canceledClosed = true
-        return null
+    const [canceledReq] = NewRequest(
+      MethodPost,
+      'https://example.invalid/upload',
+      {
+        Read: () => [0, null],
+        Close: () => {
+          canceledClosed = true
+          return null
+        },
       },
-    })
+    )
 
-    const [canceledResp, canceledErr] = await DefaultTransport.RoundTrip(canceledReq!.WithContext(ctx))
+    const [canceledResp, canceledErr] = await DefaultTransport.RoundTrip(
+      canceledReq!.WithContext(ctx),
+    )
 
     expect(canceledResp).toBeNull()
     expect(canceledErr).toBe(context.Canceled)
@@ -670,10 +972,14 @@ describe('net/http override', () => {
 
   it('posts URL-encoded forms through clients and package helper', async () => {
     const transport = {
-      async RoundTrip(got: Request | $.VarRef<Request> | null): Promise<[Response | null, $.GoError]> {
+      async RoundTrip(
+        got: Request | $.VarRef<Request> | null,
+      ): Promise<[Response | null, $.GoError]> {
         const request = $.pointerValue<Request>(got)
         expect(request.Method).toBe(MethodPost)
-        expect(Header_Get(request.Header, 'Content-Type')).toBe('application/x-www-form-urlencoded')
+        expect(Header_Get(request.Header, 'Content-Type')).toBe(
+          'application/x-www-form-urlencoded',
+        )
         const [data, err] = await io.ReadAll(request.Body!)
         expect(err).toBeNull()
         expect($.bytesToString(data)).toBe('a=one&a=two&space=x+y')
@@ -686,7 +992,10 @@ describe('net/http override', () => {
     ])
     const client = new Client({ Transport: transport })
 
-    const [clientResp, clientErr] = await client.PostForm('https://example.invalid/form', form)
+    const [clientResp, clientErr] = await client.PostForm(
+      'https://example.invalid/form',
+      form,
+    )
     expect(clientErr).toBeNull()
     expect(clientResp?.StatusCode).toBe(StatusOK)
 
@@ -712,7 +1021,10 @@ describe('net/http override', () => {
 
     Header_Add(header, 'x-pack-id', 'pack-1')
     Header_Add(header, 'X-Pack-Id', 'pack-2')
-    expect(Array.from(header.get('X-Pack-Id') ?? [])).toEqual(['pack-1', 'pack-2'])
+    expect(Array.from(header.get('X-Pack-Id') ?? [])).toEqual([
+      'pack-1',
+      'pack-2',
+    ])
 
     Header_Del(header, 'x-pack-id')
     expect(Header_Get(header, 'X-Pack-ID')).toBe('')
@@ -721,7 +1033,7 @@ describe('net/http override', () => {
   it('accepts server context and shutdown surfaces', () => {
     const srv = new Server({
       Addr: ':0',
-      BaseContext: () => ({} as any),
+      BaseContext: () => ({}) as any,
       ReadHeaderTimeout: 10,
     })
 
@@ -729,7 +1041,9 @@ describe('net/http override', () => {
     expect(srv.BaseContext?.(null)).toEqual({})
     expect(srv.ReadHeaderTimeout).toBe(10)
     expect(srv.Shutdown({} as any)).toBeNull()
-    expect(srv.ListenAndServeTLS('cert.pem', 'key.pem')?.Error()).toBe('net/http: Server.ListenAndServeTLS is not implemented in GoScript')
+    expect(srv.ListenAndServeTLS('cert.pem', 'key.pem')?.Error()).toBe(
+      'net/http: Server.ListenAndServeTLS is not implemented in GoScript',
+    )
   })
 
   it('supports handler functions and not-found responses for typechecked server tests', () => {
@@ -749,6 +1063,116 @@ describe('net/http override', () => {
     expect(writes).toEqual(['status:404', '404 page not found\n'])
   })
 
+  it('accepts nullable handler function receivers for generated method calls', () => {
+    const writer: ResponseWriter = {
+      Header: () => new Header(),
+      Write: (p) => [p?.length ?? 0, null],
+      WriteHeader: () => undefined,
+    }
+
+    expect(typeof HandlerFunc_ServeHTTP).toBe('function')
+    expect(writer.Header()).toBeInstanceOf(Header)
+  })
+
+  it('registers Handler for generic runtime assertions', () => {
+    const handlerFunc = (_w: ResponseWriter | null, _r: Request | null) =>
+      undefined
+    const handler = $.namedValueInterfaceValue(
+      $.namedFunction(
+        $.functionValue(handlerFunc, {
+          kind: $.TypeKind.Function,
+          params: [
+            'http.ResponseWriter',
+            {
+              kind: $.TypeKind.Pointer,
+              elemType: 'http.Request',
+            },
+          ],
+          results: [],
+        }),
+        'http.HandlerFunc',
+        {
+          kind: $.TypeKind.Function,
+          name: 'http.HandlerFunc',
+          params: [
+            'http.ResponseWriter',
+            {
+              kind: $.TypeKind.Pointer,
+              elemType: 'http.Request',
+            },
+          ],
+          results: [],
+        },
+      ),
+      'http.HandlerFunc',
+      {
+        ServeHTTP: (receiver, ...args) =>
+          HandlerFunc_ServeHTTP(
+            $.isVarRef(receiver) ? receiver.value : receiver,
+            ...(args as [ResponseWriter | null, Request | null]),
+          ),
+      },
+      {
+        kind: $.TypeKind.Function,
+        name: 'http.HandlerFunc',
+        params: [
+          'http.ResponseWriter',
+          {
+            kind: $.TypeKind.Pointer,
+            elemType: 'http.Request',
+          },
+        ],
+        results: [],
+      },
+    )
+
+    const [asserted, ok] = $.typeAssertTuple<{
+      ServeHTTP(w: ResponseWriter | null, r: Request | null): void
+    }>(handler, 'http.Handler')
+
+    expect(ok).toBe(true)
+    expect(asserted).toBe(handler)
+  })
+
+  it('rejects named method wrappers with incompatible interface arity', () => {
+    const handler = $.namedValueInterfaceValue(
+      $.namedFunction(
+        $.functionValue(() => undefined, {
+          kind: $.TypeKind.Function,
+          params: [],
+          results: [],
+        }),
+        'http.HandlerFunc',
+        {
+          kind: $.TypeKind.Function,
+          name: 'http.HandlerFunc',
+          params: [],
+          results: [],
+        },
+      ),
+      'http.HandlerFunc',
+      {
+        ServeHTTP: (receiver, ...args) =>
+          HandlerFunc_ServeHTTP(
+            $.isVarRef(receiver) ? receiver.value : receiver,
+            ...(args as [ResponseWriter | null, Request | null]),
+          ),
+      },
+      {
+        kind: $.TypeKind.Function,
+        name: 'http.HandlerFunc',
+        params: [],
+        results: [],
+      },
+    )
+
+    const [, ok] = $.typeAssertTuple<{
+      ServeHTTP(w: ResponseWriter | null, r: Request | null): void
+    }>(handler, 'http.Handler')
+
+    expect(ok).toBe(false)
+  })
+
   it('routes through default mux and handler helper exports', () => {
     const writes: string[] = []
     const writer: ResponseWriter = {
@@ -778,7 +1202,7 @@ describe('net/http override', () => {
     ])
   })
 
-  it('formats Set-Cookie headers for browser bootstrap routes', () => {
+  it('formats Set-Cookie headers for browser bootstrap routes', async () => {
     const header = new Header()
     const writer: ResponseWriter = {
       Header: () => header,
@@ -786,15 +1210,18 @@ describe('net/http override', () => {
       WriteHeader: () => undefined,
     }
 
-    SetCookie(writer, new Cookie({
-      Name: 'spacewave_local_capability',
-      Value: 'token',
-      Path: '/',
-      MaxAge: 300,
-      HttpOnly: true,
-      Secure: true,
-      SameSite: SameSiteStrictMode,
-    }))
+    await SetCookie(
+      writer,
+      new Cookie({
+        Name: 'spacewave_local_capability',
+        Value: 'token',
+        Path: '/',
+        MaxAge: 300,
+        HttpOnly: true,
+        Secure: true,
+        SameSite: SameSiteStrictMode,
+      }),
+    )
 
     expect(Array.from(header.get('Set-Cookie') ?? [])).toEqual([
       'spacewave_local_capability=token; Path=/; Max-Age=300; HttpOnly; Secure; SameSite=Strict',
@@ -806,29 +1233,46 @@ describe('net/http override', () => {
 
     expect(err).toBeNull()
     expect(parsed.Unix()).toBe(784111777)
-    expect(DetectContentType($.stringToBytes('<HTML>ok'))).toBe('text/html; charset=utf-8')
+    expect(DetectContentType($.stringToBytes('<HTML>ok'))).toBe(
+      'text/html; charset=utf-8',
+    )
     expect(
-      DetectContentType(new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])),
+      DetectContentType(
+        new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
+      ),
     ).toBe('image/png')
-    expect(DetectContentType(new Uint8Array([0xff, 0xd8, 0xff, 0x00]))).toBe('image/jpeg')
-    expect(DetectContentType($.stringToBytes('%PDF-1.7'))).toBe('application/pdf')
-    expect(DetectContentType($.stringToBytes('RIFFxxxxWEBPVP'))).toBe('image/webp')
-    expect(DetectContentType($.stringToBytes('FORMxxxxAIFF'))).toBe('audio/aiff')
+    expect(DetectContentType(new Uint8Array([0xff, 0xd8, 0xff, 0x00]))).toBe(
+      'image/jpeg',
+    )
+    expect(DetectContentType($.stringToBytes('%PDF-1.7'))).toBe(
+      'application/pdf',
+    )
+    expect(DetectContentType($.stringToBytes('RIFFxxxxWEBPVP'))).toBe(
+      'image/webp',
+    )
+    expect(DetectContentType($.stringToBytes('FORMxxxxAIFF'))).toBe(
+      'audio/aiff',
+    )
     expect(DetectContentType($.stringToBytes('ID3payload'))).toBe('audio/mpeg')
     expect(DetectContentType($.stringToBytes('wOFFpayload'))).toBe('font/woff')
-    expect(DetectContentType(new Uint8Array([
-      0x00, 0x00, 0x00, 0x18,
-      0x66, 0x74, 0x79, 0x70,
-      0x69, 0x73, 0x6f, 0x6d,
-      0x00, 0x00, 0x00, 0x00,
-      0x6d, 0x70, 0x34, 0x31,
-      0x00, 0x00, 0x00, 0x00,
-    ]))).toBe('video/mp4')
-    expect(DetectContentType(new Uint8Array([0x00, 0x01, 0x02]))).toBe('application/octet-stream')
-    expect(DetectContentType(new Uint8Array())).toBe('text/plain; charset=utf-8')
-  })
-
-  it('exports file server interface shapes', () => {
+    expect(
+      DetectContentType(
+        new Uint8Array([
+          0x00, 0x00, 0x00, 0x18, 0x66, 0x74, 0x79, 0x70, 0x69, 0x73, 0x6f,
+          0x6d, 0x00, 0x00, 0x00, 0x00, 0x6d, 0x70, 0x34, 0x31, 0x00, 0x00,
+          0x00, 0x00,
+        ]),
+      ),
+    ).toBe('video/mp4')
+    expect(DetectContentType(new Uint8Array([0x00, 0x01, 0x02]))).toBe(
+      'application/octet-stream',
+    )
+    expect(DetectContentType(new Uint8Array())).toBe(
+      'text/plain; charset=utf-8',
+    )
+  })
+
+  it('exports file server interface shapes', async () => {
     const file: File = {
       Close: () => null,
       Read: (p) => [p?.length ?? 0, null],
@@ -837,11 +1281,15 @@ describe('net/http override', () => {
       Stat: () => [null, null],
     }
     const fsys: FileSystem = {
-      Open: (name) => (name === 'ok' ? [file, null] : [null, new Error('missing')]),
+      Open: (name) =>
+        name === 'ok' ? [file, null] : [null, new Error('missing')],
     }
 
-    expect(fsys.Open('ok')[0]).toBe(file)
-    expect(fsys.Open('missing')[1]?.message).toBe('missing')
+    const [okFile] = await fsys.Open('ok')
+    const [, missingErr] = await fsys.Open('missing')
+
+    expect(okFile).toBe(file)
+    expect(missingErr?.message).toBe('missing')
   })
 
   it('serves files and omits HEAD response bodies', async () => {
@@ -853,23 +1301,26 @@ describe('net/http override', () => {
         Read: (p: Uint8Array) => reader.Read(p),
         Seek: (offset: number, whence: number) => reader.Seek(offset, whence),
         Readdir: () => [null, null] as [null, null],
-        Stat: () => [
-          {
-            IsDir: () => false,
-            ModTime: () => null as never,
-            Mode: () => 0,
-            Name: () => 'file.txt',
-            Size: () => 5,
-            Sys: () => null,
-          },
-          null,
-        ] as const,
+        Stat: () =>
+          [
+            {
+              IsDir: () => false,
+              ModTime: () => null as never,
+              Mode: () => 0,
+              Name: () => 'file.txt',
+              Size: () => 5,
+              Sys: () => null,
+            },
+            null,
+          ] as const,
       }
     }
     const root = FS({
       Open: (name) => {
         opened.push(name)
-        return name === 'file.txt' ? [makeFile(), null] : [null, new Error('missing')]
+        return name === 'file.txt' ?
+            [makeFile(), null]
+          : [null, new Error('missing')]
       },
     })
     const writes: string[] = []
@@ -883,17 +1334,26 @@ describe('net/http override', () => {
       WriteHeader: (code) => writes.push(`status:${code}`),
     }
     const handler = FileServer(root)
-    const [getReq] = NewRequest(MethodGet, 'http://example.invalid/../file.txt', null)
+    const [getReq] = NewRequest(
+      MethodGet,
+      'http://example.invalid/../file.txt',
+      null,
+    )
 
     await handler.ServeHTTP(writer, getReq)
 
     expect(opened).toEqual(['file.txt'])
     expect(writes).toEqual(['status:200', 'hello'])
     expect(Header_Get(header, 'Content-Length')).toBe('5')
+    expect(Header_Get(header, 'Content-Type')).toBe('text/plain; charset=utf-8')
 
     writes.length = 0
     opened.length = 0
-    const [headReq] = NewRequest(MethodHead, 'http://example.invalid/file.txt', null)
+    const [headReq] = NewRequest(
+      MethodHead,
+      'http://example.invalid/file.txt',
+      null,
+    )
 
     await handler.ServeHTTP(writer, headReq)
 
@@ -901,6 +1361,249 @@ describe('net/http override', () => {
     expect(writes).toEqual(['status:200'])
   })
 
+  it('serves files from async file systems and file methods', async () => {
+    const closeCalls: string[] = []
+    const root = {
+      async Open(name: string) {
+        if (name !== 'async.txt') {
+          return [null, new Error('missing')]
+        }
+        let offset = 0
+        const file = {
+          async Close() {
+            closeCalls.push(name)
+            return null
+          },
+          async Read(p) {
+            const data = $.stringToBytes('async-body')
+            if (offset >= data.length) {
+              return [0, io.EOF]
+            }
+            const n = Math.min(p.length, data.length - offset)
+            p.set(data.subarray(offset, offset + n), 0)
+            offset += n
+            return [n, null]
+          },
+          async Seek(seekOffset) {
+            offset = Number(seekOffset)
+            return [offset, null]
+          },
+          async Readdir() {
+            return [null, null]
+          },
+          async Stat() {
+            return [
+              {
+                IsDir: () => false,
+                ModTime: () => null as never,
+                Mode: () => 0,
+                Name: () => name,
+                Size: () => 10,
+                Sys: () => null,
+              },
+              null,
+            ]
+          },
+        }
+        return [file, null]
+      },
+    }
+    const writes: string[] = []
+    const header = new Header()
+    const writer: ResponseWriter = {
+      Header: () => header,
+      Write: (p) => {
+        writes.push(Buffer.from(p ?? []).toString('utf8'))
+        return [p?.length ?? 0, null]
+      },
+      WriteHeader: (code) => writes.push(`status:${code}`),
+    }
+    const [req] = NewRequest(
+      MethodGet,
+      'http://example.invalid/async.txt',
+      null,
+    )
+
+    await FileServer(root).ServeHTTP(writer, req)
+
+    expect(writes).toEqual(['status:200', 'async-body'])
+    expect(Header_Get(header, 'Content-Length')).toBe('10')
+    expect(closeCalls).toEqual(['async.txt'])
+  })
+
+  it('serves files through FS adapters backed by async io/fs Open', async () => {
+    const opened: string[] = []
+    const root = {
+      async Open(name: string) {
+        opened.push(name)
+        const data = $.stringToBytes('fs-adapter')
+        let offset = 0
+        return [
+          {
+            Close: async () => null,
+            Read: async (p: $.Slice<number>) => {
+              if (offset >= data.length) {
+                return [0, io.EOF] as [number, $.GoError]
+              }
+              const n = Math.min(p?.length ?? 0, data.length - offset)
+              p?.set(data.subarray(offset, offset + n), 0)
+              offset += n
+              return [n, null] as [number, $.GoError]
+            },
+            Stat: async () => [
+              {
+                Name: () => name,
+                Size: () => data.length,
+                Mode: () => 0,
+                ModTime: () => new time.Time(),
+                IsDir: () => false,
+                Sys: () => null,
+              },
+              null,
+            ],
+          },
+          null,
+        ]
+      },
+    }
+    const writes: string[] = []
+    const header = new Header()
+    const writer: ResponseWriter = {
+      Header: () => header,
+      Write: (p) => {
+        writes.push(Buffer.from(p ?? []).toString('utf8'))
+        return [p?.length ?? 0, null]
+      },
+      WriteHeader: (code) => writes.push(`status:${code}`),
+    }
+    const [req] = NewRequest(
+      MethodGet,
+      'http://example.invalid/dir/fs-adapter.txt',
+      null,
+    )
+
+    await FileServerFS(root).ServeHTTP(writer, req)
+
+    expect(opened).toEqual(['dir/fs-adapter.txt'])
+    expect(writes).toEqual(['status:200', 'fs-adapter'])
+    expect(Header_Get(header, 'Content-Length')).toBe('10')
+  })
+
+  it('serves files through async response writer adapters', async () => {
+    const root = {
+      async Open(name: string) {
+        const data = $.stringToBytes('async-adapter')
+        return [
+          {
+            Read: (p: $.Slice<number>) => {
+              p?.set(data.subarray(0, p.length))
+              return [data.length, io.EOF] as [number, $.GoError]
+            },
+            Close: async () => null,
+            Stat: async () => [
+              {
+                Name: () => name,
+                Size: () => data.length,
+                Mode: () => 0,
+                ModTime: () => new time.Time(),
+                IsDir: () => false,
+                Sys: () => null,
+              },
+              null,
+            ],
+          },
+          null,
+        ] as [File, $.GoError]
+      },
+    }
+    const writes: string[] = []
+    const header = new Header()
+    const writer: ResponseWriter = {
+      Header: async () => header,
+      Write: async (p) => {
+        writes.push(Buffer.from(p ?? []).toString('utf8'))
+        return [p?.length ?? 0, null]
+      },
+      WriteHeader: async (code) => {
+        writes.push(`status:${code}`)
+      },
+    }
+    const [req] = NewRequest(
+      MethodGet,
+      'http://example.invalid/async-adapter.txt',
+      null,
+    )
+
+    await FileServer(root).ServeHTTP(writer, req)
+
+    expect(writes).toEqual(['status:200', 'async-adapter'])
+    expect(Header_Get(header, 'Content-Length')).toBe('13')
+  })
+
+  it('writes file server headers before reading response bodies', async () => {
+    let headerWritten = false
+    let readSawHeader = false
+    let offset = 0
+    const data = $.stringToBytes('streamed-body')
+    const root = {
+      async Open(name: string) {
+        return [
+          {
+            Close: async () => null,
+            Read: async (p: $.Slice<number>) => {
+              readSawHeader = headerWritten
+              if (offset >= data.length) {
+                return [0, io.EOF] as [number, $.GoError]
+              }
+              const n = Math.min(p?.length ?? 0, data.length - offset)
+              p?.set(data.subarray(offset, offset + n), 0)
+              offset += n
+              return [n, null] as [number, $.GoError]
+            },
+            Seek: async () => [0, null] as [number, $.GoError],
+            Readdir: async () => [null, null] as [null, $.GoError],
+            Stat: async () => [
+              {
+                Name: () => name,
+                Size: () => data.length,
+                Mode: () => 0,
+                ModTime: () => null as never,
+                IsDir: () => false,
+                Sys: () => null,
+              },
+              null,
+            ],
+          },
+          null,
+        ] as [File, $.GoError]
+      },
+    }
+    const writes: string[] = []
+    const header = new Header()
+    const writer: ResponseWriter = {
+      Header: () => header,
+      Write: (p) => {
+        writes.push(Buffer.from(p ?? []).toString('utf8'))
+        return [p?.length ?? 0, null]
+      },
+      WriteHeader: (code) => {
+        headerWritten = true
+        writes.push(`status:${code}`)
+      },
+    }
+    const [req] = NewRequest(
+      MethodGet,
+      'http://example.invalid/streamed.mjs',
+      null,
+    )
+
+    await FileServer(root).ServeHTTP(writer, req)
+
+    expect(readSawHeader).toBe(true)
+    expect(writes).toEqual(['status:200', 'streamed-body'])
+    expect(Header_Get(header, 'Content-Type')).toBe('text/javascript; charset=utf-8')
+  })
+
   it('awaits ServeContent writes before returning', async () => {
     const writes: string[] = []
     const writer: ResponseWriter = {
@@ -911,15 +1614,35 @@ describe('net/http override', () => {
       },
       WriteHeader: (code) => writes.push(`status:${code}`),
     }
-    const [req] = NewRequest(MethodGet, 'http://example.invalid/content.txt', null)
+    const [req] = NewRequest(
+      MethodGet,
+      'http://example.invalid/content.txt',
+      null,
+    )
 
-    await ServeContent(writer, req, 'content.txt', null as never, bytes.NewReader($.stringToBytes('served')))
+    await ServeContent(
+      writer,
+      req,
+      'content.txt',
+      null as never,
+      bytes.NewReader($.stringToBytes('served')),
+    )
 
     expect(writes).toEqual(['status:200', 'served'])
 
     writes.length = 0
-    const [headReq] = NewRequest(MethodHead, 'http://example.invalid/content.txt', null)
-    await ServeContent(writer, headReq, 'content.txt', null as never, bytes.NewReader($.stringToBytes('hidden')))
+    const [headReq] = NewRequest(
+      MethodHead,
+      'http://example.invalid/content.txt',
+      null,
+    )
+    await ServeContent(
+      writer,
+      headReq,
+      'content.txt',
+      null as never,
+      bytes.NewReader($.stringToBytes('hidden')),
+    )
 
     expect(writes).toEqual(['status:200'])
   })
@@ -954,7 +1677,11 @@ describe('net/http override', () => {
       },
       WriteHeader: (code) => writes.push(`status:${code}`),
     }
-    const [req] = NewRequest(MethodGet, 'http://example.invalid/eval/missing.js', null)
+    const [req] = NewRequest(
+      MethodGet,
+      'http://example.invalid/eval/missing.js',
+      null,
+    )
 
     ServeFile(writer, req, '/host-only/missing.js')